Release Notes
What changed in each MARS-Curiosity release, newest first. Each entry is a one-liner with a link to the documentation, the demo or the issue; the GitHub release has the full notes, upgrade notes included (the next release has them here too).
Unreleased
New
- Docker: the projects created with MARSCmd are ready for it. The three templates have a
Dockerfile, adocker-compose.yml, a.dockerignoreanddocker-build.bat, that builds the Linux64 daemon intobinfrom the command line (no PAServer, no Linux machine); thendocker compose up -d --buildwhere Docker runs. MARSCmd (and MARSgen) put the name of the project in those files too. Deployment ▸ Docker (#323) - Console servers: a new
endpointscommand lists the endpoints of the server (applications, resources and groups of routes, HTTP method and path of each endpoint), and onstartthe server writes the base URL of each application with the ones of its OpenAPI document, Swagger UI and documentation page, clickable in most terminals. In the console (Indy, Delphi Cross Socket) and FastCGI programs of the templates and of the demos; the texts come from the newMARS.Core.Engine.Endpointsunit. Projects created before can copy the few lines from the template. Deployment ▸ The console server (#321) - JWT: asymmetric signature algorithms,
JWT.Algorithm=RS256,PS256orES256:JWT.PrivateKeysigns andJWT.PublicKeyverifies (PEM files or texts), so the servers that only verify tokens cannot issue them;JWT.PreviousPublicKey[.<kid>]for key rotation. The algorithm comes from the configuration, never from the header of a token. The mORMot backend needs nothing else (RSA and ECDSA of mORMot 2, no DLL); the JOSE backend needs the newMARS.JOSEJWT.TaurusTLSunit, with the TaurusTLS library and OpenSSL 3 (not shipped with MARS). HS256 stays the default. The templates have commented examples. Authentication ▸ Asymmetric algorithms (#313)
Changed
- The mORMot JWT backend (
MARS.mORMotJWT.Token, the default on Windows) andMARS.dmustacheare built on mORMot 2 instead of mORMot 1.18: same behavior and same tokens (HS256).ThirdParty\mORMot2replacesThirdParty\mORMot, and theMARS.mORMotpackage contains the mORMot 2 units. Authentication ▸ JWT backends (#312)
Fixed
- MARSCmd: the files of a new project got a UTF-8 BOM even when the ones of the template had none (every file whose content it changes was rewritten with it): harmless in the sources, but a BOM breaks batch files and Docker files. Now a file without a BOM stays without, and only the files that change are rewritten. (#323)
- Memory: every request leaked a ~40-byte closure record (
ReadAuthorizationInfo$ActRec), a reference cycle between the two anonymous methods introduced with the authorization fix of 2.0.3 (#307) — visible as an "Unexpected Memory Leak" dialog on shutdown withReportMemoryLeaksOnShutdown, and growing linearly with traffic on long-running servers. (#320) - Client:
TMARSClientResourceSSEwith a client other thanTMARSHttpClient(aTMARSNetClient, for example) raised a bareEInvalidCastwhen the stream was opened; now anEMARSClientExceptionsays that aTMARSHttpClientis needed. Server-Sent Events (#319) - Client:
AutomaticDecompressionset on aTMARSHttpClientor on theHttpClientof aTMARSNetClientwas ignored by the asynchronous calls (GETAsync,POSTAsync, ...): they run on a clone of the client, and the clone did not get the setting, so it neither asked for compressed responses nor unpacked them. - JWT (JOSE backend): a token with
"alg":"RS256"(orES*) reached the RSA/ECDSA provider of delphi-jose-jwt before being refused, and that provider loads OpenSSL 1.0 (libeay32.dll) from the DLL search path: an unauthenticated request could make the server load anylibeay32.dllfound there. Now the algorithm is checked on the header before any verification; HS256 tokens are unchanged and the mORMot backend was not affected. (#310)
Upgrade notes
- mORMot 2 (#312): the mORMot 1 units (
SynCommons,SynCrypto,SynEcc,SynLZ,SynTable,SynMustache) are no longer shipped with MARS. A project withThirdParty\mORMot\Sourcein its search path needsThirdParty\mORMot2\src\core,ThirdParty\mORMot2\src\cryptandThirdParty\mORMot2\src\libinstead (the setup and Smart Setup update the IDE library path). Code that used the mORMot 1 units from the MARS copy needs its own copy of mORMot 1 (the units of mORMot 2 have other names,mormot.*, so the two can coexist) or the mORMot 2 equivalents. Rebuild the packages:MARS.mORMotchanged.
2.0.3
latest 4 November 2026 · GitHub release · changes since 2.0.2New
- JSON logger:
JSONLogging.RetentionDaysdeletes the rotated log files older than that many days (when a new file is opened;0, the default, keeps them all), so the folder read by Grafana Alloy no longer grows forever. Thanks to @bobprog72. Logging (#305)
Changed
TDatevalues are written as calendar dates,"2026-10-19"(OpenAPIformat: date), instead of a date and time with the offset ("2026-10-19T00:00:00.000+02:00"); they are read from both. ATDateTimereads"2026-10-19"as midnight of that day (no time zone conversion). The OpenAPI document of the server hasformat: dateforTDateandformat: date-timeforTDateTime, as the MCP tools do.JSON.TDateAsDate=false(TDateAsDateof the serialization options) writes them as before. Serialization ▸ Dates, OpenAPI (#298)
Fixed
- Security: a
[PermitAll]on a resource disabled the[RolesAllowed]of its methods: a method with[RolesAllowed('admin')]in a[PermitAll]resource was allowed to any valid token, whatever its roles (the same for a group of routes withPermitAlland its routes, and in the OpenAPI document). Now the[PermitAll]of the resource is the default of the methods without authorization attributes of their own. Thanks to @mferlini for the security audit that found it. Authorization ▸ PermitAll on the resource (#307) - OpenAPI:
/openapianswered 500 "Duplicates not allowed" when two methods claimed the same path, verb and request media type (e.g. a subclass ofTMARSTokenResourceredeclaringDoLogin); now the document is built. (#308) - Docs: the Authorization page says clearly that an endpoint without authorization attributes is public. Authorization ▸ Resolution rules (#309)
- Docs: the Grafana Alloy pipeline of the Logging page stored only the message in Loki (
stage.output), so the JSON fields could not be queried with| json; now it keeps the whole line, with a tip on the trade-off. Logging ▸ Ingesting into Loki (#292) - Docs: building for Linux64 needs a Linux SDK, not PAServer (needed to add or update the SDK and to deploy from the IDE). Deployment (#293)
- Docs: WebStencils needs RAD Studio 12.2 or later, now stated on the Templates page. Templates ▸ WebStencils (#294)
- TailwindcssDemo: the password partial (not used by the pages) posted to
/app/users/{id}/password, a path that does not exist; now/users/{id}/password. (#295) - OpenAPI: the format of
TDatefollowed only the default serialization options: withDefaultApp.JSON.TDateAsDate=falsethe server wrote dates and times but its document saidformat: date; now the document of an application follows itsJSON.TDateAsDate. OpenAPI (#299) - YAML: the writers ignored the serialization options of the application: dates were always local times with the offset (whatever
JSON.DateIsUTCsaid), a zero date was1899-12-30T...,TDatefollowed only the globalTDateAsDateand theJSON.SkipEmpty*options had no effect; an empty array member was written as(empty). Now YAML uses the options of the request, as JSON does (no newYAML.*parameters). Serialization ▸ YAML (#304)
Upgrade notes
[PermitAll]on a resource (#307): in a[PermitAll]resource (or group of routes) the methods with[RolesAllowed]now check the roles: a valid token without one of them gets403(it passed before).[Authenticated]and[DenyAll]already worked. This is the fix of a security issue; check the resources with[PermitAll]on the class if some clients relied on it. A[PermitAll]on a method is unchanged.TDatein JSON: servers writeTDatefields and results as"2026-10-19". Clients built with MARS 2.0.2 or earlier read them as midnight UTC converted to local time (west of Greenwich, the day before): update them, or setJSON.TDateAsDate=falseon the server until then. Clients that compare the text of dates, and OpenAPI clients generated from the server, seeformat: datenow.- Dates in YAML (#304): YAML follows
DateIsUTCas JSON does. Where it isTrue(set in code or withJSON.DateIsUTC=true, or by default on machines at UTC+0) dates in YAML are UTC (...Z) instead of local times with the offset; setJSON.DateIsUTC=falseto keep local times. A zero date is now omitted (ZeroDateAsEmpty) and empty array members are left out instead of(empty).
2.0.2
16 October 2026 · GitHub release · changes since 2.0.1
New
- OpenAPI: request headers for the documentation only, the ones the code reads by itself or a middleware checks (i.e. an API key):
[MetaHeader('X-Api-Key', 'description', True)]on a method or a resource,MetaHeader(...)on a route or a group of routes, theOpenAPI.Header.<name>parameter for every operation (of the engine or of an application). The templates have commented examples. OpenAPI ▸ Request headers (#286) - OpenAPI:
[HeaderParam],[QueryParam]and[CookieParam]on fields and properties of a resource (injected for every method) are parameters of all its operations; a parameter of the method with the same name wins. OpenAPI ▸ Request headers (#285) - DockerDemo: the template server in a Docker container, its Linux64 daemon in foreground in an Ubuntu 24.04 image, with
Dockerfile,docker-compose.ymland.dockerignore. Demos ▸ DockerDemo (#283)
Fixed
- Setup: the installation failed with RAD Studio 13.0 (
Unit 'System.Net.HttpSse' not foundin theMARSClient.Corepackage): the server-sent events of MARS rely on what RAD Studio 13.1 added (THTTPEventSourcein the client,TWebResponseStream.BeginEventsStreamin WebBroker). With 13.0 MARS installs and works, withoutTMARSClientResourceSSE; the server unit of the events stops the build with a message. Server-Sent Events (#288) - Documentation site: no icon in the browser tab, the favicon link lacked the
/MARS/base. (#287)
2.0.1
14 October 2026 · GitHub release · changes since 2.0.0
New
- Templates and demos: a Stoplight button next to OpenAPI in the VCL and FMX server forms, opening the Stoplight Elements page of the application (
<application>/docs, now registered by every demo too). OpenAPI ▸ Stoplight Elements [MetaResult](MARS.Metadata.Attributes) andMetaResultof routes: the shape of a result whose type does not tell it, i.e. the rows of a dataset, in the OpenAPI document; the data demos use it for their customers. OpenAPI ▸ Datasets and the shape of a result (#276)
Changed
- OpenAPI: the schemas describe the JSON on the wire, not the Delphi classes. Datasets are their rows (
application/json) or their native format, not the properties ofTFDQueryand the like; the members of a class that are not data (events, interfaces, pointers, class references) are left out, components are objects without properties; the token has the shape its writer gives it. The FireDAC demo went from 216 schemas (FireDAC, DB, RTL types) to 5. OpenAPI (#276)
Upgrade notes
- OpenAPI documents (#276): the documents of servers returning datasets, components or the token change: those schemas described the Delphi objects and were not usable by clients; regenerate the clients made from them. Add
[MetaResult]to document the rows of a dataset. - Packages (#278): the MARS.Utils package has a new unit,
MARS.Utils.FloatText: rebuild the packages (the setup does it). - Floats in JSON (#278): values that need more than 15 significant digits are written with all of them (
0.1 + 0.2is0.30000000000000004, not0.3); tests or clients that compare the JSON text of such values see the exact value now. - Linux64 Apache modules (#282): projects created from the templates before this version need
-z undefsin the linker options of their Linux64 configuration (Project Options > Building > Delphi Compiler > Linking > Options passed to the LD linker).
Fixed
- Datasets as JSON: the fields with a time zone offset (
ftTimeStampOffset: SQL Serverdatetimeoffset,timestamptzwith some providers) were left out of the JSON of records; now they are ISO 8601 strings with their own offset ("2026-07-15T09:30:15.123+03:00"), andJSONArrayToDataSetreads them back with it. Writing datasets (#280) - UniDAC:
InTransactiondid not roll back on Firebird and InterBase: the commands, queries and stored procedures created with a transaction kept theAutoCommitof UniDAC and committed each statement on its own; now the commit is left to the transaction, as inTMARSIBDAC(without a transaction they still commit after the execution). UniDAC (#279) - JSON: floating point numbers lost precision, written with 15 significant digits (
1.2345678901234567as1.23456789012346) and read by the RTL, not correctly rounded; on Win32 the values below 1E-307 were written as invalid JSON. NowDouble,Singleand float fields of datasets (records, objects, arrays, variants, datasets) are written with the shortest text that reads back to the same value, aSinglewith its own digits, and read as the nearestDouble; aCurrencyis read from its text. Most values keep their text (0.1,3.0); those that need more digits get them (0.30000000000000004).MARS.Utils.FloatText(in the MARS.Utils package). Serialization ▸ Floating point numbers (#278) - OpenAPI: with
[Consumes]on the resource class, every method got a request body, also the ones without a body (i.e.GET), with media types and no schema; now only the methods with a body parameter, form parameters,[MetaRequestBody]or their own[Consumes]. OpenAPI (#277) - Templates and demos: the Linux64 Apache modules did not link with Delphi 13 (
undefined symbol: apr_table_get, the linker gets--no-undefinedwhile theapr_*andap_*functions come from Apache when it loads the module); their Linux64 configuration now has-z undefsin the linker options. Add it to Apache module projects created before. Deployment ▸ ISAPI, Apache, FastCGI (#282) - WebStencilsDemo: the Linux64 projects did not compile, an unused
CodeSiteLogging(Windows only) in the uses ofServer.Resources.HelloWorld. (#281) - Demos (FMX server forms of ErrorObjects, HtmxDemo, OTPDemo, SSEDemo, TokenRenew, WebStencilsDemo): the OpenAPI button raised "available on Microsoft Windows only" on Windows, a swapped
{$IFNDEF MSWINDOWS}.
2.0.0
13 October 2026 · GitHub release · changes since 1.9.2
New
- MARSgen, a command line tool (
Utils\Source\MARSgen,MARSgen.exe): Delphi types (records, or classes with--classes) from OpenAPI 3.0/3.1 documents and JSON samples; MARS servers from OpenAPI documents (--server: generated base classes, your subclasses never written again), also as a new project from the MARSCmd templates (--project); imports again keeping your changes (MARSgen update); the conformance of a running server to its document (MARSgen compare); the same commands from a window (MARSgen_VCL.exe, #260); typed clients (--client:Client.<Api>, a class with a method per operation on top of the MARS client, #265); a part of a document (--tags,--operations,--schemas: the types they use only) and a preview of the code in the window (#267); the types as datasets (--datasets:Data.<Api>, their field definitions as MARS reads and writes the JSON of datasets, #268); servers as routes (--routes:Server.Routes.<Name>, projects fromMARSTemplateRoutes, #271); an MCP server for AI agents (MARSgen mcp, #273). From OpenAPI: MARSgen (#234) - MCP on stdio:
TMCPStdioServer(MARS.MCP.Stdio) serves the tools, resources and prompts of an object to a client that starts the process (Claude Code, Claude Desktop), without HTTP. MCP (#272) - Routes: a typed body without a result,
PostBody<TBody>,PutBody<TBody>,PatchBody<TBody>andMapBody<TBody>, as a resource procedure with a[BodyParam]. Routes (#269) - Routes:
BodyRequired(False), an optional typed body in the OpenAPI document (it is required by default, as before). Routes (#270) - Stored procedures:
OpenStoredProc(a result set, returned as a dataset),ExecStoredProc(output parameters, rows affected) andCreateStoredProcinTMARSFireDAC,TMARSUniDAC,TMARSMyDACandTMARSIBDAC, with the input parameters named after the request injected as for queries; output parameters are no longer filled by the injection. Stored procedures (#65) - Rate limiting: the
RateLimit.RequestsandRateLimit.Windowengine parameters limit the requests of each client (token bucket, by IP or by a header of a trusted proxy), before any routing;429withRetry-Afterover the limit,RateLimit-*headers on every response.TMARSRateLimiter(MARS.Utils.RateLimiter) for other limits in middlewares. Engine ▸ Rate limiting (#119) - API documentation with Stoplight Elements:
TOpenAPIElementsResource(MARS.OpenAPI.Elements) serves the page on the OpenAPI document of the application; the templates have it at<application>/docs, next to Swagger UI. OpenAPI ▸ Stoplight Elements (#147) [Authenticated]: a valid token, whatever its roles (with[RolesAllowed]the roles decide); alsoAuthenticatedfor routes and groups, and on MCP tools. The OpenAPI document states it as a security requirement without scopes. Authorization (#253)- A
[BodyParam]of a dataset type (TFDMemTable,TClientDataSet,TVirtualTable...) reads a plain JSON array of objects (application/json), its fields from the data; aTArray<T>of datasets an object with one array per dataset. Plain JSON into a dataset (#258) JSONArrayToDataSet(MARS.Data.Utils): a plain JSON array of objects into anyTDataSet(TFDMemTable,TVirtualTable,TClientDataSet): keys to fields by name, nested objects flattened (address.city), ISO dates, nulls; the fields created from the data when the dataset has none (JSONArrayToFieldDefs); options to replace the content, match the case, reject unknown keys, keep nested arrays as JSON. Plain JSON into a dataset (#241)TObjectList<T>members of classes are read from JSON arrays (they were written, not read): a list created by the constructor is filled in place, anilone gets a new list owning its objects. Serialization (#256)- Raw JSON fields in records and objects: a
TJSONRawStringfield holds any JSON value as text, aTJSONValuefield a copy of it; both are written as JSON. Before, the first was written as a string and the second as the properties of the Delphi object. Raw JSON fields (#243) Produces.Defaultapplication parameter: the media types of the endpoints without[Produces], as an implicit[Produces]for negotiation,/metadataand OpenAPI (i.e.application/jsonto make strings and numbers JSON too). A default for the application (#233)[JSONDateIsUTC]/[JSONDateIsUTC(False)]on a resource or a method: its dates (records, objects, datasets) as UTC or as local times, whateverJSON.DateIsUTCsays. Serialization (#111)JSON.ZeroDateAsEmpty(ZeroDateAsEmptyof the serialization options):Falsewrites a zero date (1899-12-30) as a date instead of"", "no date" (the default, as before). Serialization (#161)COM.Initializeengine parameter (Windows): COM initialized for each request in the thread that serves it, and uninitialized after it, for COM based components (ADO, OLE DB providers such as UniDAC or SDAC with SQL Server, MSXML) withoutCoInitializein every method. Engine parameters (#117)- Agent Skills (plugin 1.5.0): MARSgen (a new project from an OpenAPI document in
mars-new-project,references/marsgen.mdinmars-development),[Authenticated], the strict conversion of parameters, the JSON of datasets and plain JSON into dataset parameters; stored procedures, the rate limit, the client forms and asynchronous calls, Stoplight Elements,MARSgen mcp.
Changed
- Datasets as JSON (
DataSetToJSONArray,RecordToJSONObject: theapplication/jsonwriter of datasets, the MCP data tools): a null field isnullinstead of"",0,falseor a 1899 date, and a field named with dots is a nested object (address.city:{"address": {"city": …}}) instead of being left out;ARootPathwrites the fields under it. Writing datasets (#257) /metadatadeclares[Produces(application/json)], its only format (#233).- Path, query, header, cookie and form parameters: a value that is not of the type of the parameter (
abcfor anInt64,maybefor aBoolean) is a400 Bad Requestnaming the parameter, instead of becoming 0,Falseor the first value; enumerations are converted by name; an empty value of a[Required]parameter is a400too. Parameters from the text of the request (#249) - Methods without
[Produces], requested with noAcceptor*/*: strings and numbers aretext/plain; charset=utf-8and arrays JSON on every platform, whetherMARS.YAML.ReadersAndWritersis registered or not; the response Content-Type is never*/*. Without Produces (#232)
Upgrade notes
Coming from 1.9.2, these changes can reach your server or its clients:
- Parameters (#249): a path, query, header, cookie or form value that is not of the type of its parameter (
abcfor anInteger,yesfor aBoolean, an unknown name for an enumeration) is a400naming the parameter, instead of reaching the method as0,Falseor the first value; so is an empty value of a[Required]parameter that is not a string. Clients must send valid values; to keep accepting anything, declare the parameter asstringand convert it in the method. - Strings and numbers without
[Produces](#232): with noAcceptor*/*they aretext/plainon every platform. Without the YAML writer (Linux, 64-bit macOS, a server that does not register it) they were JSON, wrapped as{"result": 42}; with it (the templates on Windows) the body is the same, theContent-Typeistext/plaininstead of*/*, and arrays of numbers or booleans, which came out empty ([]), are JSON. For JSON scalars, declare[Produces(TMediaType.APPLICATION_JSON)], or setProduces.Default=application/jsonfor the application (#233). - Records and arrays as text (#231): their
(Field: value)text is onlytext/plain; for another media type that no writer produces for them (a[Produces('text/csv')], a client askingtext/html) the request gets406instead of that text with the requestedContent-Type. - Raw JSON fields (#243): a
TJSONRawStringfield is written as the JSON it contains, not as a JSON string; aTJSONValuefield as its value, not as{"Owned": true, …}. Reading gives aTJSONValuefield a copy owned by its object: free it in the destructor. TObjectList<T>members (#256): a JSON array for one was ignored; now it fills the list, or creates one when the member isnil. An object with such a member must free it in its destructor, as any member it owns. A list created by your constructor is emptied first (default items are lost when the JSON has the array) and receives new objects: create it owning them (TObjectList<T>.Create(True), the default), or they leak.- Datasets as JSON (#257): a null field is
null, not"",0,falseor a 1899 date: clients must handlenull. Fields named with dots become nested objects: alias them without dots (i.e. in the SQL), or rename them in theAFieldAcceptofDataSetToJSONArray, to keep the flat names. - Dataset parameters (#258): a
[BodyParam]of a dataset type now reads a plain JSON array fromapplication/json; the native formats are read as before, by the media type in[Consumes]. The reader is chosen by[Consumes], not by theContent-Typeof the request: aTArray<TFDMemTable>(orTArray<TMemDataSet>) parameter without[Consumes]in a server with an integration in its uses keeps the native reader, so declare[Consumes(TMediaType.APPLICATION_JSON)]to accept plain JSON there. - Native dataset bodies (#259): a missing or malformed body for a
TArray<TFDMemTable>/TArray<TMemDataSet>parameter is a400; a method that relied on receiving an empty array for an empty body gets the400instead. - Unknown paths (#250): a URL outside the path of the engine, or matching no application, is a
404(text/plain) instead of500. - OpenAPI (#252, #253, #255): the document of the server is now right where it was wrong: required parameters and bodies,
[PermitAll](public alone, any valid token with roles on the endpoint), procedures without content,TJSONValueandTStream. Clients generated from it may change accordingly. - Dates of datasets as JSON (#274): the date and time fields follow the
DateIsUTCof the request (theJSON.DateIsUTCparameter,[JSONDateIsUTC]), as records and objects did; before, they always used the default options. Nothing changes unless you setJSON.DateIsUTCto a value other than the default of the machine. TMARSClientResourceFormUrlEncoded(#98): theTMARSParametersgiven toPOST,PUT,POSTAsyncor to theFormUrlEncodedproperty are copied: the resource keeps its own object. Before, it kept yours and freed it (and leaked its own): free your parameters now, as any object you create.- Your ignition: nothing to change; the readers of plain JSON for datasets are in
MARS.Data.MessageBodyWriters, already in the uses of the templates.
Fixed
- JSON booleans (
ReadBoolValue, arrays of strings, MCP tool arguments) are read by their value: aTJSONBoolthat is not aTJSONTrue(i.e.TJSONBool.Create(True)with some versions of the RTL) wasfalse. (#127) - MARSCmd (and MARSgen
--project): a template with its name in a folder (bin\MARSTemplateClient\...) stopped the new project half way ("The specified path was not found"), and a destination with the name of the template in its path was renamed too; now the folders are renamed and created as needed, the empty ones of the template removed, and only the names inside the destination change. Getting started (#52) - Servers: a request-target in absolute-form (
GET http://host:port/rest/... HTTP/1.1, which servers must accept) reached no resource: the scheme and the authority ended up in the path (Indy and WebBroker), or the DCS router answered404. Now it is the same request as its origin-form (TMARSURL.OriginForm); the DCS server passes every request to the engine, which answers404to a path outside its own. (#30) - Client, forms (
TMARSClientResourceFormUrlEncoded,application/x-www-form-urlencoded): the Indy client sent no body, withPOSTorPUT, and the Net and Http clients none withPUT; now every client sends the form, its names and values URL encoded (UTF-8). Resources (#275) - Client, asynchronous calls (
GETAsync,POSTAsync...): with the Indy client the copy of the call shared the IOHandler (the socket) of the client, so the next calls failed ("Not Connected", socket errors); now an IOHandler set by you (i.e. SSL) is cloned with its options and events, the one Indy creates is not shared (#27).TMARSClientResourceFormUrlEncodedshared its parameters with the copy, which freed them (Access Violation at the next call);TMARSClientResourceJSONshared its response with the copy and leaked the previous one at every call. Resources (#98) - OpenAPI: a member left out of the JSON with
[JSONName('')](and no[YAMLName('')]) was a property named""of its schema, and the document leaked memory up to Delphi 12; now it is not in the schema. Dictionaries and lists of pairs write an empty key as""with every Delphi version, without leaks. OpenAPI (#149) - Datasets as JSON (
DataSetToJSONArray,RecordToJSONObject): the date and time fields ignored the options given (DateIsUTC, also from theJSON.DateIsUTCparameter) and used the default ones. Writing datasets (#274) - Dates as JSON and YAML (datasets, records, objects): a local time that does not exist, in the gap of the change to daylight saving time (a
datefield at midnight where it starts at midnight: Chile, Paraguay, Cuba...), raisedELocalTimeInvalid; now it takes the offset before the change (MARSDateToISO8601ofMARS.Core.Utils). (#171) - OpenAPI as YAML (
Accept: application/x-yaml): an Access Violation (500) when an endpoint has security requirements ([RolesAllowed],[Authenticated]); the requirements are written as in JSON, scopes included, and an empty list of scopes stays[]. OpenAPI (#261) - OpenAPI as YAML: the
propertiesof the schemas were the Delphi list that holds them (Capacity,Count,PList...); now the schemas of the fields, in their order, as in JSON. OpenAPI (#262) - YAML: strings that look like numbers, booleans or null (the status codes of the OpenAPI responses,
'8080'of the server variables,'true') were written plain and read back as numbers or booleans; now they are quoted (also the keys of dictionaries), the other strings stay plain.Neslib.Yaml(vendored) writes quoted scalars without the!tag. OpenAPI (#264) - The readers of the native dataset formats (
application/json-firedac,-unidac,-mydac,-ibdac): a missing body, or one that is not JSON, reached the method as an empty array; JSON that is not an object, or datasets in another format, gave500. All of them are400now, and FireDAC frees the datasets already read when one fails. Reading datasets (#259) - OpenAPI:
TJSONValue,TJSONObject,TJSONArrayandTStreamfields and results were described as objects with the properties of their Delphi classes (Null,Owned...); now as any JSON value, an object, an array, a string OpenAPI (#255). - OpenAPI:
[Required]parameters and path parameters were notrequired([OAPIRequired]overwrote them), a[Required]body was not either, a[PermitAll]method had a security requirement with aPermitAllscope (alone it is public; with roles on the endpoint, any valid token: a requirement without scopes), and procedures had a*/*content OpenAPI (#252). OpenAPI.info.*parameters that look like a number, a boolean or a date in an.inifile (OpenAPI.info.version=1.0) made/openapifail with500(Invalid class typecast); the parameters read from.inifiles keep their text,ByNameAsTextreturns it. Values from .ini files are typed (#251)- A URL outside the path of the engine, or matching no application (
/nothing), was answered500(text/htmlunder Indy) instead of the404of the exception raised by the engine, which nothing turned into a response (#250). - With
MARS.YAML.ReadersAndWritersregistered, primitive results without[Produces]were written by the YAML writer withContent-Type: */*, and arrays of numbers or booleans came out empty ([]); YAML arrays of numbers and booleans are now written (#232). TPrimitiveTypesWriter: records and arrays were written as(Field: value)text under any media type, i.e. labelledapplication/json(they now take that form only astext/plain, otherwise the JSON writers or406); its Content-Type was the first[Produces]instead of the negotiated one (i.e.text/plainforAccept: text/htmlon a method producing both) (#231).IMARSApplication.AddResourceignored a[Path]declared on an ancestor class (the resource registry already read it), so a resource inheriting its declarations from a base class could not be added. Attributes in a base class (#235)- Neslib.Yaml (bundled): parsing an invalid YAML document leaked the nodes already parsed; a local patch, recorded in
ThirdParty/README.md(#242).
1.9.2
10 October 2026 · GitHub release · changes since 1.9.1
Changed
- YAML depends on the new
MARS_YAMLdefine (MARS.inc), set where Neslib.Yaml has libyaml: Windows, Android, iOS, 32-bit macOS. The{$IFNDEF LINUX}guards of the OpenAPI units, templates and demos became{$IFDEF MARS_YAML}, andMARS.YAML.ReadersAndWriterscompiles empty elsewhere. YAML (#229) - A request that accepts only media types no writer produces for the result gets
406 Not Acceptable, listing the available ones, instead of500("MessageBodyWriter not found");500remains when no writer can produce the result at all.TMARSMessageBodyRegistry.GetWritableMediaTypes. When no writer matches (#230)
Fixed
- macOS 64-bit (OSX64, OSXARM64): a server with
MARS.OpenAPI.v3.InjectionServicedid not compile (E1054 inNeslib.LibYaml); the OpenAPI document is served as JSON there (#229). - Documentation: the OpenAPI page gave
Accept: application/yamlfor YAML; MARS matchesapplication/x-yaml.
1.9.1
9 October 2026 · GitHub release · changes since 1.9.0
New
- Data Access: the model shared by the data access integrations, now four. FireDACDemo, UniDACDemo, MyDACDemo, IBDACDemo: the same customers application (server, FMX client, tests) with each library.
- Devart MyDAC (MySQL, MariaDB):
MARS.Data.MyDAC.*,MARS.MyDACpackage,MARS_MYDACdefine (#213); - Devart IBDAC (InterBase, Firebird):
MARS.Data.IBDAC.*,MARS.IBDACpackage,MARS_IBDACdefine (#215); - client components for UniDAC, MyDAC and IBDAC:
TMARSUniDACResource,TMARSMyDACResource,TMARSIBDACResourceand the…DataSetResourceones,MARSClient.<Library>packages (#220); [UniDACConnection],[MyDACConnection],[IBDACConnection]: aliases ofConnectionAttributefor units that use more than one integration;TMARSUniDAC.ExecuteSQLreturns the affected rows andTMARSUniDAC.AfterCreateConnection, as the others.
- Devart MyDAC (MySQL, MariaDB):
- MARSCmd from the command line:
MARScmd.exe <ProjectName> [--template] [--dest], installed next toMARScmd_VCL.exe(#227). - Agent Skills (plugin 1.4.1): Devart integrations (
references/devart.md, MCP database tools), MARSCmd from the command line.
Changed
- MARSTemplateRoutes: a new project gets
<Name>ProjectGroup, like the other templates, instead of<Name>RoutesProjectGroup(#228). - The setup builds the UniDAC packages when UniDAC is installed: its check never found the package.
Fixed
TMARSFDDatasetResource: POST (applying the deltas of the client) always failed with "Duplicates not allowed" (#218).- IBDAC: statements executed without a transaction were rolled back when the connection closed (#217).
- UniDAC: connection definitions made of items produced a broken connect string (items with spaces, i.e.
Provider Name); a missing definition injected nil; a macro without a value raised an error; the reader returned closed datasets (#219). - UniDAC: the Delphi 13 package did not compile (F1054) (#214).
MARS.Tests:[QueryParam]arguments did not receive the query string of the test request (#216).- Templates and demos: the commented
AfterCreateConnectionexample did not compile (#226). - Documentation: the FireDAC media types were wrong (
application/json-firedac,application/xml-firedac); the FireDAC client page described members that do not exist; two broken links.
1.9.0
8 October 2026 · GitHub release · changes since 1.8.1
New
- Route-based endpoints (preview,
MARS.Core.Routes), in addition to resource classes:R.Get<TResult>('people/{id:int}', function (const C: TMARSRouteContext): TResult ...). RoutesDemo- groups, path constraints (
int,guid,alpha), typed body and result, roles,Produces/Consumes, injection (C.Inject<T>), 405 withAllow; - modules registered with
MARSRoutesand added withIMARSApplication.AddRoutes, or defined withMARSRoutesOf(App); - in the OpenAPI document and in
/metadata, withSummary,Description,Hiddenand declaredQueryParam<T>/HeaderParam<T>/CookieParam<T>/FormParam<T>; - middlewares (
Use) on routes, groups and applications, named (SkipMiddleware,C.MiddlewareName) or class-based (TMARSMiddleware); withMiddlewares.Resources=truethe application middlewares wrap the resource methods too; - the endpoint tree of the VCL server forms lists the routes.
- groups, path constraints (
- MARSCmd template
MARSTemplateRoutes: a new project with its endpoints defined as routes. MARSTemplateRoutes - Indy server: pluggable SSL IOHandler (
SSLIOHandlerFactory,DefaultSSLIOHandlerFactory), i.e. one with OpenSSL 3, anyTIdServerIOHandlerSSLBasedescendant. Another SSL IOHandler for Indy - Cookies:
SameSite(TMARSCookieSameSite,IMARSResponse.SetCookieoverload with HttpOnly and SameSite) on every host;JWT.CookieSameSitefor the token cookie. The token cookie - Linux daemon:
--foreground(or-f) runs the server in the current process with logs on standard output, for systemd (Type=simple) and Docker. Deployment - Documentation: Deployment guide (Windows service, systemd, Docker, reverse proxy, HTTPS, IIS/Apache/FastCGI), Why MARS?, FAQ;
llms.txtandllms-full.txtfor AI tools, sitemap.
Changed
- The token cookie is
SameSite=Laxby default (JWT.CookieSameSite;Unspecifiedrestores the previous header,Noneserves front ends on other sites). - A parameter marked
[Required]missing from the request gives400 Bad Requestinstead of 500. Attributes - Attributes on a resource class (
Encoding,JSONP,Produces,Connection,NoLog, report, template and Razor attributes) also apply when declared on an ancestor class, asRolesAllowedand the JSON options already did. Readers, writers, injection services and loggers read them from the activation attribute lists, ready for endpoints not backed by an RTTI method.
Fixed
- dmustache:
MARS.dmustachedid not compile (MARS.Core.Exceptionsused twice). - ISAPI, Apache and FastCGI hosts: the token cookie was not
HttpOnly, and its expiration was written in local time labelled GMT (shifted by the time zone offset). - DCS server: logging out kept the token cookie for a day (
Max-Age=86400) instead of deleting it. - Templates and demos: the test projects did not compile without TestInsight (missing
DUnitX.Loggers.Xml.NUnit), and their tests failed on theIsSecurerequest property (MARS.Testsmock). - Linux daemon: the log file only held its last line.
/metadata(TMetadataResource) answered 500 (invalid class typecast) since 1.6.4.- Documentation: the footer stated the wrong license (MARS is released under the Mozilla Public License 2.0).
1.8.1
7 October 2026 · GitHub release · changes since 1.8.0
New
- Client logging:
OnLog,RegisterLogger,LogOptions(content, masking), ready-made sinks, server-sent events streams. Client logging - Server JSON log: custom entries with structured data (
Log<T>),JSONLogging.BuiltInEntries(#211). Custom entries - Shared configuration files:
[Include]section in.inifiles;.iniparameter names are case insensitive. Shared configuration - OpenAPI:
[MetaRequestBody]documents a body read by the method itself (the token resource uses it). OpenAPI - DCS server: HTTPS without a reverse proxy (
PortSSL,DCS.SSL.CertFile,DCS.SSL.KeyFile);IMARSRequest.IsSecure. HTTPS - Indy server:
Indy.KeepAliveparameter, enabled inMARSTemplate. Engine parameters - Templates: one
Server.inishared by all the server flavors;MARSTemplateDCSaligned withMARSTemplate, Windows service and Linux daemon on DCS. MARSTemplate - MARSCmd: choice of the template (
MARSTemplate,MARSTemplateDCS); new projects inDocuments\MARS Projects. MARSCmd - Delphi-Mocks is a git submodule (
ThirdParty/Delphi-Mocks).
Fixed
- DCS server: 404 on every request, content stream leak, query string, cookies not
HttpOnly, static files downloaded as attachments, JSON request bodies not received. - OpenAPI: request body of methods without
[Consumes](#212). - Setup: the uninstaller deleted the user projects in the
Demosfolder. - MCP: OAuth metadata used
http://for a server reached in HTTPS without a proxy.
1.8.0
5 October 2026 · GitHub release · changes since 1.7.1
New
- JWT key rotation:
JWT.KeyId,JWT.PreviousSecret.<kid>, custom key providers (#82). Key rotation - MCP Apps: interactive HTML views for MCP tools (
[MCPToolUI],[MCPAppResource]). MCP Apps · MCPServer demo - MCP: optional tool parameters with
[MCPDefault]. MCP - JSON serialization options from the configuration file (
JSON.*parameters). From the configuration file JSON.EscapeNonASCIIparameter (#208). Non-ASCII characters- TMS Smart Setup:
tms install andreamagni.mars. Installation - delphi-jose-jwt v4 as a git submodule.
Security
- JOSE backend: HS256 only (tokens asking for other algorithms were accepted).
TFileSystemResource: 8.3 short names bypassed the[Exclude]/[Include]masks (#210).
Fixed
MARS.DCSpackage search path (#209); design-time package build; JOSE folder of theMARSTemplateDCSprojects.
Changed
- Delphi 10.4 Sydney is the minimum supported version.
1.7.1
25 September 2026 · GitHub release · changes since 1.7.0
New
- Delphi 13.2 support.
Fixed
- Large arrays of records sent by Win32 clients exhausted memory (#205).
- Large arrays of records read by the server built the whole JSON tree (#206).
- Applications not using JWT required
JWT.Secret(#207). Authentication
1.7.0
17 September 2026 · GitHub release · changes since 1.6.4
New
- MCP server support: tools, resources, prompts, FireDAC tools, per-tool roles, OAuth 2.1 authorization server. MCP servers · MCPServer demo
- Agent Skills for Claude Code and other AI coding agents. AI Agent Skills
- This documentation site.
QUERYHTTP verb, server and client side (#191). HTTP verbsTFileSystemResource:HEADrequests,[DotSegments](#204),[DirectoryListing]. Path safety- OpenAPI: more of the specification through attributes. Enriching the spec
TMARSReqRespLoggerJSON: JSON log files for Grafana/Loki. File logging for Grafana- Tailwind CSS demo. Tutorial
Security
- Path traversal in
TFileSystemResource(#195). - New projects get their own JWT secret (#201, #202).
- In-memory logger always on once its unit was included (#197).
Fixed
- Repeated query parameters (#196), directory listing (#198), JSON to record/object (#199, #200), MCP OAuth behind a proxy (#203).
- A malformed request body answers 400 instead of 500; wildcard routing; tokens and JWT decoding.
1.6.4
5 June 2026 · GitHub release · changes since 1.6.3
New
TMARSHttpClient: client component with server-sent events support. Client components · Server-Sent Events- WebStencils integration. WebStencils
- Demos: SSEDemo, WebStencilsDemo, HtmxDemo.
- JSON:
TList<TPair<string,T>>serialization;TMARSJSONSerializationOptionsreworked. JSON serialization - Tests for parameters, JWT and claims.
1.6.3
15 April 2026 · GitHub release · changes since 1.6.2
New
Access-Control-Allow-Private-NetworkCORS header (#179). CORSIMessageBodyStreamProvider: large responses streamed without loading them in memory. Content negotiation[Headers],[Cookies],[QueryParams],[PathParams]collection binders. Collection binders- Demos: OTPDemo, TokenRenew.
Fixed
- Linux fixes.
1.6.2
22 October 2025 · GitHub release · changes since 1.6.1
1.6.1
30 September 2025 · GitHub release · changes since 1.6.0
- Setup compatible with Delphi 10.2 (#172).
1.6.0
11 September 2025 · GitHub release · changes since 1.5.9
New
- Delphi 13 Florence support (#170).
MARSTemplateServerFCGI: FastCGI server for nginx inMARSTemplate. MARSTemplate
Fixed
- Date serialization options were ignored (#169).
1.5.9b
1 August 2025 · GitHub release · changes since 1.5.9
New
PATCHHTTP verb (#168). HTTP verbs- Error objects: structured error bodies, server and client side. Error handling · ErrorObjects demo
Fixed
- Custom headers of the Indy client.
1.5.9
27 June 2025 · GitHub release · changes since 1.5
New
IMARSEngineandIMARSApplicationinterfaces throughout MARS. Engine- More JSON serialization options, with more granularity. Serialization options
AfterContextCleanuphooks, by attribute and throughTMARSActivation. Request lifecycle- Setup (installer) (#166). Installation
Fixed
- Delphi version detection (#142),
TryISO8601ToDateon Delphi XE7 and earlier (#145), #141 and others (#146), resourceConstructorFuncnot called (#156).
Older releases
See the GitHub releases.
