@chill-sharp/ts-client 1.1.12 → 1.1.15

package/README.md

@@ -1,707 +1,707 @@
-# @chill-sharp/ts-client
-
-TypeScript client for a generic ChillSharp service.
-
-This package targets the standard ChillSharp HTTP surface:
-
-- core Chill API at `/api/chill`
-- schema API at `/api/chill-schema`
-- auth API at `/api/chill-auth`
-- i18n API at `/api/chill-i18n`
-- entity-change notifications at `/api/chill/notify`
-
-It is intentionally lightweight. Payloads are plain JavaScript objects so the client can work against arbitrary ChillSharp models without code generation.
-
-## Install
-
-From the repository root:
-
-```bash
-cd extra/chill-sharp-ts-client
-npm install
-npm run build
-```
-
-Or from another project:
-
-```bash
-npm install ../extra/chill-sharp-ts-client
-```
-
-The client uses the runtime `fetch` API available in modern browsers and Node.js 18+.
-
-## Local Linking
-
-This package now builds automatically on `npm install`, `npm pack`, and `npm link` through the `prepare` and `prepack` scripts.
-
-Example local workflow:
-
-```bash
-cd extra/chill-sharp-ts-client
-npm install
-npm link
-
-cd path/to/your-app
-npm link @chill-sharp/ts-client
-```
-
-## Quick Start
-
-```ts
-import { ChillSharpClient } from "@chill-sharp/ts-client";
-
-const client = new ChillSharpClient("http://localhost:5000/api/chill", {
-  cultureName: "it-IT"
-});
-
-const created = await client.create({
-  ChillType: "Model.Post",
-  Guid: "00000000-0000-0000-0000-000000000001",
-  Properties: {
-    Title: "Hello",
-    Author: "Ada Lovelace"
-  }
-});
-
-const found = await client.find({
-  ChillType: "Model.Post",
-  Guid: created.Guid as string
-});
-```
-
-## Construction Modes
-
-### Anonymous or externally authenticated
-
-```ts
-const client = new ChillSharpClient("http://localhost:5000/api/chill", {
-  cultureName: "it-IT"
-});
-```
-
-SignalR entity-change subscriptions use the same bearer token flow as the other authenticated endpoints. Browser SignalR connections send credentials by default; if your app needs a non-credentialed cross-origin negotiate request, set `signalRWithCredentials: false` when creating the client.
-
-### With an existing access token
-
-```ts
-const client = new ChillSharpClient("http://localhost:5000/api/chill", {
-  accessToken: "your-jwt-token",
-  cultureName: "it-IT"
-});
-```
-
-### With username and password
-
-```ts
-const client = new ChillSharpClient("http://localhost:5000/api/chill", {
-  username: "root",
-  password: "Pass123$",
-  cultureName: "it-IT"
-});
-```
-
-If the service supports ChillSharp auth endpoints, the client can log in and refresh tokens automatically.
-
-## Core ChillSharp Operations
-
-Query payloads can now include:
-
-- `ordering.propertyName`
-- `ordering.direction`
-
-If you omit `ordering`, the backend defaults to `Position`. Entity payloads also include `position`, which defaults to `0`.
-
-### Query
-
-Use `query()` when `ChillType` points to a concrete query type such as `Query.PostQuery`.
-
-```ts
-const result = await client.query({
-  chillType: "Query.PostQuery",
-  properties: {
-    title: "Hello"
-  },
-  ordering: {
-    propertyName: "Position",
-    direction: "ASC"
-  },
-  resultProperties: [
-    { name: "Guid" },
-    { name: "Title" },
-    { name: "Author" }
-  ]
-});
-```
-
-When `ordering.propertyName` points to a Chill entity reference such as `Blog`, the backend orders by `Blog.Label`.
-
-### Lookup
-
-Use `lookup()` when `ChillType` points to an entity type and you only need generic full-text search.
-
-```ts
-const result = await client.lookup({
-  chillType: "Model.Post",
-  properties: {
-    fullTextSearch: "Ada Lovelace"
-  },
-  ordering: {
-    propertyName: "Blog",
-    direction: "ASC"
-  },
-  resultProperties: [
-    { name: "Guid" },
-    { name: "Title" },
-    { name: "Author" }
-  ]
-});
-```
-
-### Find
-
-```ts
-const entity = await client.find({
-  ChillType: "Model.Post",
-  Guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11"
-});
-```
-
-### Create
-
-```ts
-const entity = await client.create({
-  chillType: "Model.Post",
-  guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11",
-  position: 10,
-  properties: {
-    title: "New title",
-    author: "Grace Hopper"
-  }
-});
-```
-
-### Update
-
-```ts
-const updated = await client.update({
-  chillType: "Model.Post",
-  guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11",
-  position: 20,
-  properties: {
-    title: "Updated title"
-  }
-});
-```
-
-### Delete
-
-```ts
-await client.delete({
-  ChillType: "Model.Post",
-  Guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11"
-});
-```
-
-### Attachments
-
-Use the attachment helpers when the host enables `ChillSharp.Attachment`.
-
-```ts
-const post = {
-  ChillType: "Model.Post",
-  Guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11"
-};
-
-const uploaded = await client.uploadAttachment(post, {
-  fileName: "contract.txt",
-  content: new Blob(["hello attachment"], { type: "text/plain" }),
-  contentType: "text/plain"
-}, {
-  title: "Contract",
-  description: "Signed draft",
-  isPublic: false
-});
-
-const attachments = await client.getAttachments(post);
-const fileBlob = await client.downloadAttachment(uploaded[0]);
-```
-
-### Chunk
-
-Use `chunk()` when several operations should be sent in one HTTP request.
-The operations are executed in `Index` order when you provide it. For write-heavy batches, set `Index` explicitly.
-
-```ts
-const operations = await client.chunk([
-  {
-    Index: 0,
-    Verb: "create",
-    Entity: {
-      ChillType: "Model.Post",
-      Guid: "11111111-1111-1111-1111-111111111111",
-      Properties: { Title: "First", Author: "A" }
-    }
-  },
-  {
-    Index: 1,
-    Verb: "create",
-    Entity: {
-      ChillType: "Model.Post",
-      Guid: "22222222-2222-2222-2222-222222222222",
-      Properties: { Title: "Second", Author: "B" }
-    }
-  },
-  {
-    Index: 2,
-    Verb: "update",
-    Entity: {
-      ChillType: "Model.Post",
-      Guid: "11111111-1111-1111-1111-111111111111",
-      Properties: { Title: "First updated" }
-    }
-  }
-]);
-```
-
-### Chunk inside one transaction
-
-Wrap the batch with `transaction` and `commit` when all write operations must succeed or fail together.
-
-```ts
-const operations = await client.chunk([
-  {
-    Index: 0,
-    Verb: "transaction"
-  },
-  {
-    Index: 1,
-    Verb: "create",
-    Entity: {
-      ChillType: "Model.Blog",
-      Guid: crypto.randomUUID(),
-      Properties: {
-        Name: "Batch blog",
-        Url: "https://example.local/batch-blog"
-      }
-    }
-  },
-  {
-    Index: 2,
-    Verb: "create",
-    Entity: {
-      ChillType: "Model.Post",
-      Guid: crypto.randomUUID(),
-      Properties: {
-        Title: "Batch post",
-        Author: "Grace Hopper"
-      }
-    }
-  },
-  {
-    Index: 3,
-    Verb: "commit"
-  }
-]);
-```
-
-Use this pattern only for the operations that must share the same database transaction. If one write fails before `commit`, the transaction is not committed.
-
-### Test
-
-```ts
-const status = await client.test();
-// "ChillSharp is up and running!"
-```
-
-Use this to verify the Chill endpoint is reachable before sending API payloads.
-
-## Notification Operations
-
-### Subscribe to all changes for a chill type
-
-```ts
-const subscription = await client.subscribeToEntityChanges("Model.Post", (changes) => {
-  for (const change of changes) {
-    console.log(change.chillType, change.guid, change.action);
-  }
-});
-```
-
-### Subscribe to one entity only
-
-```ts
-const subscription = await client.subscribeToEntityChanges(
-  "Model.Post",
-  (changes) => {
-    console.log("single entity changed", changes);
-  },
-  "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11"
-);
-```
-
-### Unsubscribe
-
-```ts
-await subscription.unsubscribe();
-```
-
-### Close the shared notification connection
-
-```ts
-await client.disconnectEntityChanges();
-```
-
-The notification callback receives arrays shaped like:
-
-```ts
-[
-  {
-    chillType: "Model.Post",
-    guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11",
-    action: "UPDATED"
-  }
-]
-```
-
-## Schema Operations
-
-### Get schema
-
-```ts
-const schema = await client.getSchema("Model.Post", "default");
-console.log(schema.handleAttachments);
-console.log(schema.relations);
-
-// Override the constructor default for one call
-const englishSchema = await client.getSchema("Model.Post", "default", "en-GB");
-
-// Refresh a persisted schema from the current runtime model for one call.
-// Existing properties keep their saved metadata, new model properties are added,
-// and properties no longer present on the model are removed.
-const refreshedSchema = await client.getSchema("Model.Post", "default", undefined, true);
-```
-
-Entity schemas now also expose `relations`, derived from annotated collection properties. Each relation entry includes:
-
-- `chillType` for the child or relation entity
-- `chillQuery` for the resolved query type when available
-- `fixedValues` and `fixedQueryValues` containing the `@{mock}` parent placeholder keyed by the child FK/reference property name
-- `relationLabel` with `labelGuid`, `primaryDefaultText`, and `secondaryDefaultText`
-
-### Get schema list
-
-```ts
-const schemaList = await client.getSchemaList();
-const englishSchemaList = await client.getSchemaList("en-GB");
-```
-
-### Set schema
-
-```ts
-await client.setSchema({
-  ChillType: "Model.Post",
-  ChillViewCode: "default",
-  DisplayName: "Post",
-  Properties: [
-    {
-      Name: "Title",
-      DisplayName: "Post title"
-    }
-  ]
-});
-```
-
-### Get entity options
-
-```ts
-const options = await client.getEntityOptions("Model.Post");
-console.log(options.handleAttachments);
-```
-
-### Set entity options
-
-```ts
-const options = await client.setEntityOptions({
-  chillType: "Model.Post",
-  checksumEnabled: true,
-  handleAttachments: true,
-  labelFormatString: "{Title}",
-  shortLabelFormatString: "{Title}",
-  fullTextContentFormatString: "{Title} {Author}",
-  enableMCP: true,
-  mcpDescription: "Post resource exposed to MCP clients.",
-  changeLogEnabled: true
-});
-```
-
-### Get menu
-
-Use `getMenu()` to load root menu nodes or the direct children of one menu item.
-
-```ts
-const rootMenu = await client.getMenu();
-const childMenu = await client.getMenu("8d0946dc-fc2b-4d95-b5ca-6f12d9618a5b");
-```
-
-`getMenu()` returns one tree level at a time.
-
+# @chill-sharp/ts-client
+
+TypeScript client for a generic ChillSharp service.
+
+This package targets the standard ChillSharp HTTP surface:
+
+- core Chill API at `/api/chill`
+- schema API at `/api/chill-schema`
+- auth API at `/api/chill-auth`
+- i18n API at `/api/chill-i18n`
+- entity-change notifications at `/api/chill/notify`
+
+It is intentionally lightweight. Payloads are plain JavaScript objects so the client can work against arbitrary ChillSharp models without code generation.
+
+## Install
+
+From the repository root:
+
+```bash
+cd extra/chill-sharp-ts-client
+npm install
+npm run build
+```
+
+Or from another project:
+
+```bash
+npm install ../extra/chill-sharp-ts-client
+```
+
+The client uses the runtime `fetch` API available in modern browsers and Node.js 18+.
+
+## Local Linking
+
+This package now builds automatically on `npm install`, `npm pack`, and `npm link` through the `prepare` and `prepack` scripts.
+
+Example local workflow:
+
+```bash
+cd extra/chill-sharp-ts-client
+npm install
+npm link
+
+cd path/to/your-app
+npm link @chill-sharp/ts-client
+```
+
+## Quick Start
+
+```ts
+import { ChillSharpClient } from "@chill-sharp/ts-client";
+
+const client = new ChillSharpClient("http://localhost:5000/api/chill", {
+  cultureName: "it-IT"
+});
+
+const created = await client.create({
+  ChillType: "Model.Post",
+  Guid: "00000000-0000-0000-0000-000000000001",
+  Properties: {
+    Title: "Hello",
+    Author: "Ada Lovelace"
+  }
+});
+
+const found = await client.find({
+  ChillType: "Model.Post",
+  Guid: created.Guid as string
+});
+```
+
+## Construction Modes
+
+### Anonymous or externally authenticated
+
+```ts
+const client = new ChillSharpClient("http://localhost:5000/api/chill", {
+  cultureName: "it-IT"
+});
+```
+
+SignalR entity-change subscriptions use the same bearer token flow as the other authenticated endpoints. Browser SignalR connections send credentials by default; if your app needs a non-credentialed cross-origin negotiate request, set `signalRWithCredentials: false` when creating the client.
+
+### With an existing access token
+
+```ts
+const client = new ChillSharpClient("http://localhost:5000/api/chill", {
+  accessToken: "your-jwt-token",
+  cultureName: "it-IT"
+});
+```
+
+### With username and password
+
+```ts
+const client = new ChillSharpClient("http://localhost:5000/api/chill", {
+  username: "root",
+  password: "Pass123$",
+  cultureName: "it-IT"
+});
+```
+
+If the service supports ChillSharp auth endpoints, the client can log in and refresh tokens automatically.
+
+## Core ChillSharp Operations
+
+Query payloads can now include:
+
+- `ordering.propertyName`
+- `ordering.direction`
+
+If you omit `ordering`, the backend defaults to `Position`. Entity payloads also include `position`, which defaults to `0`.
+
+### Query
+
+Use `query()` when `ChillType` points to a concrete query type such as `Query.PostQuery`.
+
+```ts
+const result = await client.query({
+  chillType: "Query.PostQuery",
+  properties: {
+    title: "Hello"
+  },
+  ordering: {
+    propertyName: "Position",
+    direction: "ASC"
+  },
+  resultProperties: [
+    { name: "Guid" },
+    { name: "Title" },
+    { name: "Author" }
+  ]
+});
+```
+
+When `ordering.propertyName` points to a Chill entity reference such as `Blog`, the backend orders by `Blog.Label`.
+
+### Lookup
+
+Use `lookup()` when `ChillType` points to an entity type and you only need generic full-text search.
+
+```ts
+const result = await client.lookup({
+  chillType: "Model.Post",
+  properties: {
+    fullTextSearch: "Ada Lovelace"
+  },
+  ordering: {
+    propertyName: "Blog",
+    direction: "ASC"
+  },
+  resultProperties: [
+    { name: "Guid" },
+    { name: "Title" },
+    { name: "Author" }
+  ]
+});
+```
+
+### Find
+
+```ts
+const entity = await client.find({
+  ChillType: "Model.Post",
+  Guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11"
+});
+```
+
+### Create
+
+```ts
+const entity = await client.create({
+  chillType: "Model.Post",
+  guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11",
+  position: 10,
+  properties: {
+    title: "New title",
+    author: "Grace Hopper"
+  }
+});
+```
+
+### Update
+
+```ts
+const updated = await client.update({
+  chillType: "Model.Post",
+  guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11",
+  position: 20,
+  properties: {
+    title: "Updated title"
+  }
+});
+```
+
+### Delete
+
+```ts
+await client.delete({
+  ChillType: "Model.Post",
+  Guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11"
+});
+```
+
+### Attachments
+
+Use the attachment helpers when the host enables `ChillSharp.Attachment`.
+
+```ts
+const post = {
+  ChillType: "Model.Post",
+  Guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11"
+};
+
+const uploaded = await client.uploadAttachment(post, {
+  fileName: "contract.txt",
+  content: new Blob(["hello attachment"], { type: "text/plain" }),
+  contentType: "text/plain"
+}, {
+  title: "Contract",
+  description: "Signed draft",
+  isPublic: false
+});
+
+const attachments = await client.getAttachments(post);
+const fileBlob = await client.downloadAttachment(uploaded[0]);
+```
+
+### Chunk
+
+Use `chunk()` when several operations should be sent in one HTTP request.
+The operations are executed in `Index` order when you provide it. For write-heavy batches, set `Index` explicitly.
+
+```ts
+const operations = await client.chunk([
+  {
+    Index: 0,
+    Verb: "create",
+    Entity: {
+      ChillType: "Model.Post",
+      Guid: "11111111-1111-1111-1111-111111111111",
+      Properties: { Title: "First", Author: "A" }
+    }
+  },
+  {
+    Index: 1,
+    Verb: "create",
+    Entity: {
+      ChillType: "Model.Post",
+      Guid: "22222222-2222-2222-2222-222222222222",
+      Properties: { Title: "Second", Author: "B" }
+    }
+  },
+  {
+    Index: 2,
+    Verb: "update",
+    Entity: {
+      ChillType: "Model.Post",
+      Guid: "11111111-1111-1111-1111-111111111111",
+      Properties: { Title: "First updated" }
+    }
+  }
+]);
+```
+
+### Chunk inside one transaction
+
+Wrap the batch with `transaction` and `commit` when all write operations must succeed or fail together.
+
+```ts
+const operations = await client.chunk([
+  {
+    Index: 0,
+    Verb: "transaction"
+  },
+  {
+    Index: 1,
+    Verb: "create",
+    Entity: {
+      ChillType: "Model.Blog",
+      Guid: crypto.randomUUID(),
+      Properties: {
+        Name: "Batch blog",
+        Url: "https://example.local/batch-blog"
+      }
+    }
+  },
+  {
+    Index: 2,
+    Verb: "create",
+    Entity: {
+      ChillType: "Model.Post",
+      Guid: crypto.randomUUID(),
+      Properties: {
+        Title: "Batch post",
+        Author: "Grace Hopper"
+      }
+    }
+  },
+  {
+    Index: 3,
+    Verb: "commit"
+  }
+]);
+```
+
+Use this pattern only for the operations that must share the same database transaction. If one write fails before `commit`, the transaction is not committed.
+
+### Test
+
+```ts
+const status = await client.test();
+// "ChillSharp is up and running!"
+```
+
+Use this to verify the Chill endpoint is reachable before sending API payloads.
+
+## Notification Operations
+
+### Subscribe to all changes for a chill type
+
+```ts
+const subscription = await client.subscribeToEntityChanges("Model.Post", (changes) => {
+  for (const change of changes) {
+    console.log(change.chillType, change.guid, change.action);
+  }
+});
+```
+
+### Subscribe to one entity only
+
+```ts
+const subscription = await client.subscribeToEntityChanges(
+  "Model.Post",
+  (changes) => {
+    console.log("single entity changed", changes);
+  },
+  "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11"
+);
+```
+
+### Unsubscribe
+
+```ts
+await subscription.unsubscribe();
+```
+
+### Close the shared notification connection
+
+```ts
+await client.disconnectEntityChanges();
+```
+
+The notification callback receives arrays shaped like:
+
+```ts
+[
+  {
+    chillType: "Model.Post",
+    guid: "f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11",
+    action: "UPDATED"
+  }
+]
+```
+
+## Schema Operations
+
+### Get schema
+
+```ts
+const schema = await client.getSchema("Model.Post", "default");
+console.log(schema.handleAttachments);
+console.log(schema.relations);
+
+// Override the constructor default for one call
+const englishSchema = await client.getSchema("Model.Post", "default", "en-GB");
+
+// Refresh a persisted schema from the current runtime model for one call.
+// Existing properties keep their saved metadata, new model properties are added,
+// and properties no longer present on the model are removed.
+const refreshedSchema = await client.getSchema("Model.Post", "default", undefined, true);
+```
+
+Entity schemas now also expose `relations`, derived from annotated collection properties. Each relation entry includes:
+
+- `chillType` for the child or relation entity
+- `chillQuery` for the resolved query type when available
+- `fixedValues` and `fixedQueryValues` containing the `@{mock}` parent placeholder keyed by the child FK/reference property name
+- `relationLabel` with `labelGuid`, `primaryDefaultText`, and `secondaryDefaultText`
+
+### Get schema list
+
+```ts
+const schemaList = await client.getSchemaList();
+const englishSchemaList = await client.getSchemaList("en-GB");
+```
+
+### Set schema
+
+```ts
+await client.setSchema({
+  ChillType: "Model.Post",
+  ChillViewCode: "default",
+  DisplayName: "Post",
+  Properties: [
+    {
+      Name: "Title",
+      DisplayName: "Post title"
+    }
+  ]
+});
+```
+
+### Get entity options
+
+```ts
+const options = await client.getEntityOptions("Model.Post");
+console.log(options.handleAttachments);
+```
+
+### Set entity options
+
+```ts
+const options = await client.setEntityOptions({
+  chillType: "Model.Post",
+  checksumEnabled: true,
+  handleAttachments: true,
+  labelFormatString: "{Title}",
+  shortLabelFormatString: "{Title}",
+  fullTextContentFormatString: "{Title} {Author}",
+  enableMCP: true,
+  mcpDescription: "Post resource exposed to MCP clients.",
+  changeLogEnabled: true
+});
+```
+
+### Get menu
+
+Use `getMenu()` to load root menu nodes or the direct children of one menu item.
+
+```ts
+const rootMenu = await client.getMenu();
+const childMenu = await client.getMenu("8d0946dc-fc2b-4d95-b5ca-6f12d9618a5b");
+```
+
+`getMenu()` returns one tree level at a time.
+
 For the full menu-tree contract and `MenuHierarchy` filtering behavior, see [../../doc/MenuGuide/README.md](../../doc/MenuGuide/README.md).
-
-### Set menu
-
-Use `setMenu()` to create or update one menu item.
-
-```ts
-const savedMenu = await client.setMenu({
-  guid: "00000000-0000-0000-0000-000000000000",
-  positionNo: 10,
-  title: "Posts",
-  description: "Open the post management screen",
-  parent: null,
-  componentName: "CRUD",
-  componentConfigurationJson: "{\"chillType\":\"Model.Post\"}",
-  menuHierarchy: "SECTION-A.POSTS"
-});
-```
-
-`positionNo` is persisted by the backend and controls sibling ordering. Lower values are returned first.
-
-### Delete menu
-
-Use `deleteMenu()` to remove one menu item and all nested child nodes below it.
-
-```ts
-await client.deleteMenu("8d0946dc-fc2b-4d95-b5ca-6f12d9618a5b");
-```
-
+
+### Set menu
+
+Use `setMenu()` to create or update one menu item.
+
+```ts
+const savedMenu = await client.setMenu({
+  guid: "00000000-0000-0000-0000-000000000000",
+  positionNo: 10,
+  title: "Posts",
+  description: "Open the post management screen",
+  parent: null,
+  componentName: "CRUD",
+  componentConfigurationJson: "{\"chillType\":\"Model.Post\"}",
+  menuHierarchy: "SECTION-A.POSTS"
+});
+```
+
+`positionNo` is persisted by the backend and controls sibling ordering. Lower values are returned first.
+
+### Delete menu
+
+Use `deleteMenu()` to remove one menu item and all nested child nodes below it.
+
+```ts
+await client.deleteMenu("8d0946dc-fc2b-4d95-b5ca-6f12d9618a5b");
+```
+
 For parent handling, delete behavior, validation rules, and filtering behavior, see [../../doc/MenuGuide/README.md](../../doc/MenuGuide/README.md).
-
-## I18n Operations
-
-### Get text
-
-```ts
-const text = await client.getText({
-  LabelGuid: "4e16f6c0-6b95-4d67-98bc-9f4d0d63eaf1",
-  CultureName: "it-IT",
-  PrimaryCultureName: "en-GB",
-  PrimaryDefaultText: "Blog title",
-  SecondaryCultureName: "it-IT",
-  SecondaryDefaultText: "Titolo del blog"
-});
-```
-
-### Get texts
-
-```ts
-const texts = await client.getTexts([
-  {
-    LabelGuid: "4e16f6c0-6b95-4d67-98bc-9f4d0d63eaf1",
-    CultureName: "it-IT",
-    PrimaryCultureName: "en-GB",
-    PrimaryDefaultText: "Blog title",
-    SecondaryCultureName: "it-IT",
-    SecondaryDefaultText: "Titolo del blog"
-  },
-  {
-    LabelGuid: "2f6ef6f7-b0a9-44f8-bfd2-a3b3ed5b9a81",
-    CultureName: "it-IT",
-    PrimaryCultureName: "en-GB",
-    PrimaryDefaultText: "Blog url",
-    SecondaryCultureName: "it-IT",
-    SecondaryDefaultText: "Url del blog"
-  }
-]);
-```
-
-### Set text
-
-```ts
-const saved = await client.setText({
-  LabelGuid: "4e16f6c0-6b95-4d67-98bc-9f4d0d63eaf1",
-  CultureName: "it-IT",
-  Value: "Titolo del blog"
-});
-```
-
-## Auth Operations
-
-The client assumes the auth base path is derived from `/api/chill` to `/api/chill-auth`, matching the .NET client.
-
-### Register account
-
-```ts
-const token = await client.registerAuthAccount({
-  UserName: "root",
-  Email: "root@example.com",
-  Password: "Pass123$",
-  DisplayName: "Root",
-  DisplayCultureName: "it-IT",
-  CreateChillAuthUser: true
-});
-```
-
-If `DisplayCultureName` is provided and `CreateChillAuthUser` is `true`, the server presets the linked `AuthUser` with culture-based defaults for `displayTimeZone`, `displayDateFormat`, and `displayNumberFormat`.
-
-### Login
-
-```ts
-const token = await client.loginAuthAccount({
-  UserNameOrEmail: "root",
-  Password: "Pass123$"
-});
-```
-
-### Refresh current token
-
-```ts
-const token = await client.refreshAuthAccount();
-```
-
-### Change password
-
-```ts
-const result = await client.changeAuthPassword({
-  CurrentPassword: "Pass123$",
-  NewPassword: "Pass456$"
-});
-```
-
-### Request password reset
-
-```ts
-const resetToken = await client.requestAuthPasswordReset({
-  UserNameOrEmail: "root"
-});
-```
-
-### Reset password
-
-```ts
-const result = await client.resetAuthPassword({
-  UserId: resetToken.UserId as string,
-  ResetToken: resetToken.ResetToken as string,
-  NewPassword: "Pass789$"
-});
-```
-
-## Auth Management Operations
-
-Use these endpoints when the host exposes ChillSharp auth management APIs.
-
-### Get current permissions
-
-```ts
-const permissions = await client.getAuthPermissions();
-```
-
-### Get user list
-
-```ts
-const users = await client.getAuthUserList();
-```
-
-Each auth user item includes `displayCultureName`, `displayTimeZone`, `displayDateFormat`, and `displayNumberFormat`.
-
-### Get managed user
-
-```ts
-const user = await client.getAuthUser("f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11");
-```
-
-### Set managed user
-
-```ts
-const user = await client.setAuthUser({
-  guid: null,
-  externalId: "identity-user-001",
-  userName: "identity.user",
-  displayName: "Identity User",
-  displayCultureName: "it-IT",
-  displayTimeZone: "W. Europe Standard Time",
-  displayDateFormat: "DD/MM/YYYY",
-  displayNumberFormat: "1.000,00",
-  isActive: true,
-  canManagePermissions: false,
-  canManageSchema: true,
-  roleGuids: [],
-  permissions: []
-});
-```
-
-### Get role list
-
-```ts
-const roles = await client.getAuthRoleList();
-```
-
-### Get managed role
-
-```ts
-const role = await client.getAuthRole("e2f0d8d5-0a1f-4d15-9396-2ab5f6c4ff22");
-```
-
-### Set managed role
-
-```ts
-const role = await client.setAuthRole({
-  guid: null,
-  name: "Editors",
-  description: "Can edit posts",
-  isActive: true,
-  userGuids: [],
-  permissions: []
-});
-```
-
-## Error Handling
-
-All request failures raise `ChillSharpClientError`.
-
-```ts
-import { ChillSharpClient, ChillSharpClientError } from "@chill-sharp/ts-client";
-
-const client = new ChillSharpClient("http://localhost:5000/api/chill", {
-  cultureName: "it-IT"
-});
-
-try {
-  await client.getSchema("Model.Post", "default");
-} catch (error) {
-  if (error instanceof ChillSharpClientError) {
-    console.log(error.statusCode);
-    console.log(error.responseText);
-  }
-}
-```
-
-## Custom Fetch
-
-If you need custom transport behavior, pass your own `fetch` implementation:
-
-```ts
-const client = new ChillSharpClient("http://localhost:5000/api/chill", {
-  fetchImpl: fetch
-});
-```
-
-## Generic Payload Strategy
-
-This package does not generate TypeScript model classes for your Chill entities.
-
-That is intentional:
-
-- ChillSharp models are application-specific
-- the standard Chill API already works well with generic objects
-- a generic client is easier to reuse across many different ChillSharp services
-
-If you need strongly typed TypeScript clients, generate them from your host OpenAPI document as described in [doc/ClientGeneration/README.md](../../doc/ClientGeneration/README.md).
-
-
-
-
-
-
-
-
-
+
+## I18n Operations
+
+### Get text
+
+```ts
+const text = await client.getText({
+  LabelGuid: "4e16f6c0-6b95-4d67-98bc-9f4d0d63eaf1",
+  CultureName: "it-IT",
+  PrimaryCultureName: "en-GB",
+  PrimaryDefaultText: "Blog title",
+  SecondaryCultureName: "it-IT",
+  SecondaryDefaultText: "Titolo del blog"
+});
+```
+
+### Get texts
+
+```ts
+const texts = await client.getTexts([
+  {
+    LabelGuid: "4e16f6c0-6b95-4d67-98bc-9f4d0d63eaf1",
+    CultureName: "it-IT",
+    PrimaryCultureName: "en-GB",
+    PrimaryDefaultText: "Blog title",
+    SecondaryCultureName: "it-IT",
+    SecondaryDefaultText: "Titolo del blog"
+  },
+  {
+    LabelGuid: "2f6ef6f7-b0a9-44f8-bfd2-a3b3ed5b9a81",
+    CultureName: "it-IT",
+    PrimaryCultureName: "en-GB",
+    PrimaryDefaultText: "Blog url",
+    SecondaryCultureName: "it-IT",
+    SecondaryDefaultText: "Url del blog"
+  }
+]);
+```
+
+### Set text
+
+```ts
+const saved = await client.setText({
+  LabelGuid: "4e16f6c0-6b95-4d67-98bc-9f4d0d63eaf1",
+  CultureName: "it-IT",
+  Value: "Titolo del blog"
+});
+```
+
+## Auth Operations
+
+The client assumes the auth base path is derived from `/api/chill` to `/api/chill-auth`, matching the .NET client.
+
+### Register account
+
+```ts
+const token = await client.registerAuthAccount({
+  UserName: "root",
+  Email: "root@example.com",
+  Password: "Pass123$",
+  DisplayName: "Root",
+  DisplayCultureName: "it-IT",
+  CreateChillAuthUser: true
+});
+```
+
+If `DisplayCultureName` is provided and `CreateChillAuthUser` is `true`, the server presets the linked `AuthUser` with culture-based defaults for `displayTimeZone`, `displayDateFormat`, and `displayNumberFormat`.
+
+### Login
+
+```ts
+const token = await client.loginAuthAccount({
+  UserNameOrEmail: "root",
+  Password: "Pass123$"
+});
+```
+
+### Refresh current token
+
+```ts
+const token = await client.refreshAuthAccount();
+```
+
+### Change password
+
+```ts
+const result = await client.changeAuthPassword({
+  CurrentPassword: "Pass123$",
+  NewPassword: "Pass456$"
+});
+```
+
+### Request password reset
+
+```ts
+const resetToken = await client.requestAuthPasswordReset({
+  UserNameOrEmail: "root"
+});
+```
+
+### Reset password
+
+```ts
+const result = await client.resetAuthPassword({
+  UserId: resetToken.UserId as string,
+  ResetToken: resetToken.ResetToken as string,
+  NewPassword: "Pass789$"
+});
+```
+
+## Auth Management Operations
+
+Use these endpoints when the host exposes ChillSharp auth management APIs.
+
+### Get current permissions
+
+```ts
+const permissions = await client.getAuthPermissions();
+```
+
+### Get user list
+
+```ts
+const users = await client.getAuthUserList();
+```
+
+Each auth user item includes `displayCultureName`, `displayTimeZone`, `displayDateFormat`, and `displayNumberFormat`.
+
+### Get managed user
+
+```ts
+const user = await client.getAuthUser("f2d5d5e3-0a1f-4d15-9396-2ab5f6c4ff11");
+```
+
+### Set managed user
+
+```ts
+const user = await client.setAuthUser({
+  guid: null,
+  externalId: "identity-user-001",
+  userName: "identity.user",
+  displayName: "Identity User",
+  displayCultureName: "it-IT",
+  displayTimeZone: "W. Europe Standard Time",
+  displayDateFormat: "DD/MM/YYYY",
+  displayNumberFormat: "1.000,00",
+  isActive: true,
+  canManagePermissions: false,
+  canManageSchema: true,
+  roleGuids: [],
+  permissions: []
+});
+```
+
+### Get role list
+
+```ts
+const roles = await client.getAuthRoleList();
+```
+
+### Get managed role
+
+```ts
+const role = await client.getAuthRole("e2f0d8d5-0a1f-4d15-9396-2ab5f6c4ff22");
+```
+
+### Set managed role
+
+```ts
+const role = await client.setAuthRole({
+  guid: null,
+  name: "Editors",
+  description: "Can edit posts",
+  isActive: true,
+  userGuids: [],
+  permissions: []
+});
+```
+
+## Error Handling
+
+All request failures raise `ChillSharpClientError`.
+
+```ts
+import { ChillSharpClient, ChillSharpClientError } from "@chill-sharp/ts-client";
+
+const client = new ChillSharpClient("http://localhost:5000/api/chill", {
+  cultureName: "it-IT"
+});
+
+try {
+  await client.getSchema("Model.Post", "default");
+} catch (error) {
+  if (error instanceof ChillSharpClientError) {
+    console.log(error.statusCode);
+    console.log(error.responseText);
+  }
+}
+```
+
+## Custom Fetch
+
+If you need custom transport behavior, pass your own `fetch` implementation:
+
+```ts
+const client = new ChillSharpClient("http://localhost:5000/api/chill", {
+  fetchImpl: fetch
+});
+```
+
+## Generic Payload Strategy
+
+This package does not generate TypeScript model classes for your Chill entities.
+
+That is intentional:
+
+- ChillSharp models are application-specific
+- the standard Chill API already works well with generic objects
+- a generic client is easier to reuse across many different ChillSharp services
+
+If you need strongly typed TypeScript clients, generate them from your host OpenAPI document as described in [doc/ClientGeneration/README.md](../../doc/ClientGeneration/README.md).
+
+
+
+
+
+
+
+
+