Skip to content

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, a docker-compose.yml, a .dockerignore and docker-build.bat, that builds the Linux64 daemon into bin from the command line (no PAServer, no Linux machine); then docker compose up -d --build where Docker runs. MARSCmd (and MARSgen) put the name of the project in those files too. Deployment ▸ Docker (#323)
  • Console servers: a new endpoints command lists the endpoints of the server (applications, resources and groups of routes, HTTP method and path of each endpoint), and on start the 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 new MARS.Core.Engine.Endpoints unit. Projects created before can copy the few lines from the template. Deployment ▸ The console server (#321)
  • JWT: asymmetric signature algorithms, JWT.Algorithm=RS256, PS256 or ES256: JWT.PrivateKey signs and JWT.PublicKey verifies (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 new MARS.JOSEJWT.TaurusTLS unit, 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) and MARS.dmustache are built on mORMot 2 instead of mORMot 1.18: same behavior and same tokens (HS256). ThirdParty\mORMot2 replaces ThirdParty\mORMot, and the MARS.mORMot package 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 with ReportMemoryLeaksOnShutdown, and growing linearly with traffic on long-running servers. (#320)
  • Client: TMARSClientResourceSSE with a client other than TMARSHttpClient (a TMARSNetClient, for example) raised a bare EInvalidCast when the stream was opened; now an EMARSClientException says that a TMARSHttpClient is needed. Server-Sent Events (#319)
  • Client: AutomaticDecompression set on a TMARSHttpClient or on the HttpClient of a TMARSNetClient was 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" (or ES*) 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 any libeay32.dll found 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 with ThirdParty\mORMot\Source in its search path needs ThirdParty\mORMot2\src\core, ThirdParty\mORMot2\src\crypt and ThirdParty\mORMot2\src\lib instead (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.mORMot changed.

2.0.3 ​

latest 4 November 2026 · GitHub release · changes since 2.0.2

New

  • JSON logger: JSONLogging.RetentionDays deletes 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

  • TDate values are written as calendar dates, "2026-10-19" (OpenAPI format: date), instead of a date and time with the offset ("2026-10-19T00:00:00.000+02:00"); they are read from both. A TDateTime reads "2026-10-19" as midnight of that day (no time zone conversion). The OpenAPI document of the server has format: date for TDate and format: date-time for TDateTime, as the MCP tools do. JSON.TDateAsDate=false (TDateAsDate of 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 with PermitAll and 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: /openapi answered 500 "Duplicates not allowed" when two methods claimed the same path, verb and request media type (e.g. a subclass of TMARSTokenResource redeclaring DoLogin); 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 TDate followed only the default serialization options: with DefaultApp.JSON.TDateAsDate=false the server wrote dates and times but its document said format: date; now the document of an application follows its JSON.TDateAsDate. OpenAPI (#299)
  • YAML: the writers ignored the serialization options of the application: dates were always local times with the offset (whatever JSON.DateIsUTC said), a zero date was 1899-12-30T..., TDate followed only the global TDateAsDate and the JSON.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 new YAML.* 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 gets 403 (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.
  • TDate in JSON: servers write TDate fields 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 set JSON.TDateAsDate=false on the server until then. Clients that compare the text of dates, and OpenAPI clients generated from the server, see format: date now.
  • Dates in YAML (#304): YAML follows DateIsUTC as JSON does. Where it is True (set in code or with JSON.DateIsUTC=true, or by default on machines at UTC+0) dates in YAML are UTC (...Z) instead of local times with the offset; set JSON.DateIsUTC=false to 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, the OpenAPI.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.yml and .dockerignore. Demos ▸ DockerDemo (#283)

Fixed

  • Setup: the installation failed with RAD Studio 13.0 (Unit 'System.Net.HttpSse' not found in the MARSClient.Core package): the server-sent events of MARS rely on what RAD Studio 13.1 added (THTTPEventSource in the client, TWebResponseStream.BeginEventsStream in WebBroker). With 13.0 MARS installs and works, without TMARSClientResourceSSE; 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) and MetaResult of 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 of TFDQuery and 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.2 is 0.30000000000000004, not 0.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 undefs in 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 Server datetimeoffset, timestamptz with 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"), and JSONArrayToDataSet reads them back with it. Writing datasets (#280)
  • UniDAC: InTransaction did not roll back on Firebird and InterBase: the commands, queries and stored procedures created with a transaction kept the AutoCommit of UniDAC and committed each statement on its own; now the commit is left to the transaction, as in TMARSIBDAC (without a transaction they still commit after the execution). UniDAC (#279)
  • JSON: floating point numbers lost precision, written with 15 significant digits (1.2345678901234567 as 1.23456789012346) and read by the RTL, not correctly rounded; on Win32 the values below 1E-307 were written as invalid JSON. Now Double, Single and float fields of datasets (records, objects, arrays, variants, datasets) are written with the shortest text that reads back to the same value, a Single with its own digits, and read as the nearest Double; a Currency is 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-undefined while the apr_* and ap_* functions come from Apache when it loads the module); their Linux64 configuration now has -z undefs in 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 of Server.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 from MARSTemplateRoutes, #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> and MapBody<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) and CreateStoredProc in TMARSFireDAC, TMARSUniDAC, TMARSMyDAC and TMARSIBDAC, 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.Requests and RateLimit.Window engine parameters limit the requests of each client (token bucket, by IP or by a header of a trusted proxy), before any routing; 429 with Retry-After over 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); also Authenticated for 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; a TArray<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 any TDataSet (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, a nil one gets a new list owning its objects. Serialization (#256)
  • Raw JSON fields in records and objects: a TJSONRawString field holds any JSON value as text, a TJSONValue field 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.Default application parameter: the media types of the endpoints without [Produces], as an implicit [Produces] for negotiation, /metadata and OpenAPI (i.e. application/json to 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, whatever JSON.DateIsUTC says. Serialization (#111)
  • JSON.ZeroDateAsEmpty (ZeroDateAsEmpty of the serialization options): False writes a zero date (1899-12-30) as a date instead of "", "no date" (the default, as before). Serialization (#161)
  • COM.Initialize engine 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) without CoInitialize in 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.md in mars-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: the application/json writer of datasets, the MCP data tools): a null field is null instead of "", 0, false or a 1899 date, and a field named with dots is a nested object (address.city: {"address": {"city": …}}) instead of being left out; ARootPath writes the fields under it. Writing datasets (#257)
  • /metadata declares [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 (abc for an Int64, maybe for a Boolean) is a 400 Bad Request naming the parameter, instead of becoming 0, False or the first value; enumerations are converted by name; an empty value of a [Required] parameter is a 400 too. Parameters from the text of the request (#249)
  • Methods without [Produces], requested with no Accept or */*: strings and numbers are text/plain; charset=utf-8 and arrays JSON on every platform, whether MARS.YAML.ReadersAndWriters is 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 (abc for an Integer, yes for a Boolean, an unknown name for an enumeration) is a 400 naming the parameter, instead of reaching the method as 0, False or 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 as string and convert it in the method.
  • Strings and numbers without [Produces] (#232): with no Accept or */* they are text/plain on 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, the Content-Type is text/plain instead of */*, and arrays of numbers or booleans, which came out empty ([]), are JSON. For JSON scalars, declare [Produces(TMediaType.APPLICATION_JSON)], or set Produces.Default=application/json for the application (#233).
  • Records and arrays as text (#231): their (Field: value) text is only text/plain; for another media type that no writer produces for them (a [Produces('text/csv')], a client asking text/html) the request gets 406 instead of that text with the requested Content-Type.
  • Raw JSON fields (#243): a TJSONRawString field is written as the JSON it contains, not as a JSON string; a TJSONValue field as its value, not as {"Owned": true, …}. Reading gives a TJSONValue field 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 is nil. 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, false or a 1899 date: clients must handle null. Fields named with dots become nested objects: alias them without dots (i.e. in the SQL), or rename them in the AFieldAccept of DataSetToJSONArray, to keep the flat names.
  • Dataset parameters (#258): a [BodyParam] of a dataset type now reads a plain JSON array from application/json; the native formats are read as before, by the media type in [Consumes]. The reader is chosen by [Consumes], not by the Content-Type of the request: a TArray<TFDMemTable> (or TArray<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 a 400; a method that relied on receiving an empty array for an empty body gets the 400 instead.
  • Unknown paths (#250): a URL outside the path of the engine, or matching no application, is a 404 (text/plain) instead of 500.
  • 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, TJSONValue and TStream. Clients generated from it may change accordingly.
  • Dates of datasets as JSON (#274): the date and time fields follow the DateIsUTC of the request (the JSON.DateIsUTC parameter, [JSONDateIsUTC]), as records and objects did; before, they always used the default options. Nothing changes unless you set JSON.DateIsUTC to a value other than the default of the machine.
  • TMARSClientResourceFormUrlEncoded (#98): the TMARSParameters given to POST, PUT, POSTAsync or to the FormUrlEncoded property 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: a TJSONBool that is not a TJSONTrue (i.e. TJSONBool.Create(True) with some versions of the RTL) was false. (#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 answered 404. Now it is the same request as its origin-form (TMARSURL.OriginForm); the DCS server passes every request to the engine, which answers 404 to a path outside its own. (#30)
  • Client, forms (TMARSClientResourceFormUrlEncoded, application/x-www-form-urlencoded): the Indy client sent no body, with POST or PUT, and the Net and Http clients none with PUT; 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). TMARSClientResourceFormUrlEncoded shared its parameters with the copy, which freed them (Access Violation at the next call); TMARSClientResourceJSON shared 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 the JSON.DateIsUTC parameter) 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 date field at midnight where it starts at midnight: Chile, Paraguay, Cuba...), raised ELocalTimeInvalid; now it takes the offset before the change (MARSDateToISO8601 of MARS.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 properties of 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, gave 500. All of them are 400 now, and FireDAC frees the datasets already read when one fails. Reading datasets (#259)
  • OpenAPI: TJSONValue, TJSONObject, TJSONArray and TStream fields 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 not required ([OAPIRequired] overwrote them), a [Required] body was not either, a [PermitAll] method had a security requirement with a PermitAll scope (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 .ini file (OpenAPI.info.version=1.0) made /openapi fail with 500 (Invalid class typecast); the parameters read from .ini files keep their text, ByNameAsText returns it. Values from .ini files are typed (#251)
  • A URL outside the path of the engine, or matching no application (/nothing), was answered 500 (text/html under Indy) instead of the 404 of the exception raised by the engine, which nothing turned into a response (#250).
  • With MARS.YAML.ReadersAndWriters registered, primitive results without [Produces] were written by the YAML writer with Content-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. labelled application/json (they now take that form only as text/plain, otherwise the JSON writers or 406); its Content-Type was the first [Produces] instead of the negotiated one (i.e. text/plain for Accept: text/html on a method producing both) (#231).
  • IMARSApplication.AddResource ignored 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_YAML define (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}, and MARS.YAML.ReadersAndWriters compiles 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 of 500 ("MessageBodyWriter not found"); 500 remains 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.InjectionService did not compile (E1054 in Neslib.LibYaml); the OpenAPI document is served as JSON there (#229).
  • Documentation: the OpenAPI page gave Accept: application/yaml for YAML; MARS matches application/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.MyDAC package, MARS_MYDAC define (#213);
    • Devart IBDAC (InterBase, Firebird): MARS.Data.IBDAC.*, MARS.IBDAC package, MARS_IBDAC define (#215);
    • client components for UniDAC, MyDAC and IBDAC: TMARSUniDACResource, TMARSMyDACResource, TMARSIBDACResource and the …DataSetResource ones, MARSClient.<Library> packages (#220);
    • [UniDACConnection], [MyDACConnection], [IBDACConnection]: aliases of ConnectionAttribute for units that use more than one integration; TMARSUniDAC.ExecuteSQL returns the affected rows and TMARSUniDAC.AfterCreateConnection, as the others.
  • MARSCmd from the command line: MARScmd.exe <ProjectName> [--template] [--dest], installed next to MARScmd_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 AfterCreateConnection example 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 with Allow;
    • modules registered with MARSRoutes and added with IMARSApplication.AddRoutes, or defined with MARSRoutesOf(App);
    • in the OpenAPI document and in /metadata, with Summary, Description, Hidden and declared QueryParam<T>/HeaderParam<T>/CookieParam<T>/FormParam<T>;
    • middlewares (Use) on routes, groups and applications, named (SkipMiddleware, C.MiddlewareName) or class-based (TMARSMiddleware); with Middlewares.Resources=true the application middlewares wrap the resource methods too;
    • the endpoint tree of the VCL server forms lists the routes.
  • 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, any TIdServerIOHandlerSSLBase descendant. Another SSL IOHandler for Indy
  • Cookies: SameSite (TMARSCookieSameSite, IMARSResponse.SetCookie overload with HttpOnly and SameSite) on every host; JWT.CookieSameSite for 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.txt and llms-full.txt for AI tools, sitemap.

Changed

  • The token cookie is SameSite=Lax by default (JWT.CookieSameSite; Unspecified restores the previous header, None serves front ends on other sites).
  • A parameter marked [Required] missing from the request gives 400 Bad Request instead 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, as RolesAllowed and 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.dmustache did not compile (MARS.Core.Exceptions used 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 the IsSecure request property (MARS.Tests mock).
  • 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 .ini files; .ini parameter 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.KeepAlive parameter, enabled in MARSTemplate. Engine parameters
  • Templates: one Server.ini shared by all the server flavors; MARSTemplateDCS aligned with MARSTemplate, Windows service and Linux daemon on DCS. MARSTemplate
  • MARSCmd: choice of the template (MARSTemplate, MARSTemplateDCS); new projects in Documents\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 Demos folder.
  • 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

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.DCS package search path (#209); design-time package build; JOSE folder of the MARSTemplateDCS projects.

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

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

1.6.3 ​

15 April 2026 · GitHub release · changes since 1.6.2

New

Fixed

  • Linux fixes.

1.6.2 ​

22 October 2025 · GitHub release · changes since 1.6.1

  • Setup packages cleanup (#172); README, installation and contributing documents revised (#173–#178).

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 in MARSTemplate. MARSTemplate

Fixed

  • Date serialization options were ignored (#169).

1.5.9b ​

1 August 2025 · GitHub release · changes since 1.5.9

New

Fixed

  • Custom headers of the Indy client.

1.5.9 ​

27 June 2025 · GitHub release · changes since 1.5

New

Fixed

  • Delphi version detection (#142), TryISO8601ToDate on Delphi XE7 and earlier (#145), #141 and others (#146), resource ConstructorFunc not called (#156).

Older releases ​

See the GitHub releases.

Released under the Mozilla Public License 2.0.