@torrow/sdk-client 0.3.0 → 0.5.0

package/README.md

@@ -28,6 +28,10 @@ const href = communicationHref(comm);
 const brand = resolveCommunicationBrand(comm);
 ```
 
+## Notes and response dates
+
+Notes accept `publicityType: "Link"` on creation (default: `Personal`) and `meta: { version }` on update for optimistic concurrency. The MCP note CRUD, note mutations, parent note views, note search, context creation and context personal-list responses convert only OpenAPI date-time fields to `Date`, preserving user text and arbitrary JSON. Other operations retain legacy ISO-string parsing. See the repository's `docs/response-date-parsing.md` for exact coverage and package verification.
+
 ## Field docs package
 
 MCP and LLM field catalogs live in `@torrow/sdk-docs`.

package/dist/index.d.ts

@@ -36070,7 +36070,7 @@ interface components {
             meta?: components["schemas"]["ObjectInfo"];
         };
         /** @enum {string} */
-        NoteType: "Unknown" | "Text" | "Html" | "Hlink" | "File" | "Photo" | "Voice" | "Geolocation" | "Qr" | "ServiceSpecification";
+        NoteType: "Unknown" | "Text" | "Html" | "Hlink" | "File" | "Photo" | "Voice" | "Geolocation" | "Qr" | "ServiceSpecification" | "Markdown";
         NoteView: {
             data?: unknown;
             noteType?: components["schemas"]["NoteType"];
@@ -37839,12 +37839,14 @@ type LoyaltyGroupListQuery = {
 };
 
 type NoteItem = TorrowItemFromDto<NoteItemDto>;
+/** Supported authoring scenarios: Html and Markdown. Other server values remain for compatibility. */
 type NoteType = NoteTypeDto;
 type ImagePreviewSize = NonNullable<NoteItem["imagePreviewSize"]>;
 declare const NoteTypeValues: {
     readonly Unknown: "Unknown";
     readonly Text: "Text";
     readonly Html: "Html";
+    readonly Markdown: "Markdown";
     readonly Hlink: "Hlink";
     readonly File: "File";
     readonly Photo: "Photo";
@@ -37863,7 +37865,8 @@ declare const ImagePreviewSizeValues: {
     readonly MediumSlider: "MediumSlider";
     readonly LargeSlider: "LargeSlider";
 };
-type NoteItemForCreateOrUpdate = TorrowItemForCreateOrUpdate<NoteItem>;
+/** Explicit publicity on create; meta.version on update preserves optimistic concurrency. */
+type NoteItemForCreateOrUpdate = TorrowItemForCreateOrUpdate<NoteItem> & Pick<NoteItem, "publicityType" | "meta">;
 
 type IncludeToParentReq = IncludeToParentReqDto;
 type IncludeForUserReq = IncludeForUserReqDto;

package/dist/index.js

@@ -115,10 +115,13 @@ function parseJsonWithIsoDates(json) {
   if (json === "") {
     return void 0;
   }
-  return JSON.parse(json, (_key, value) => {
+  return JSON.parse(json, function(key, value) {
     if (typeof value !== "string") {
       return value;
     }
+    if (key === "data" && (this.noteType === "Html" || this.noteType === "Markdown")) {
+      return value;
+    }
     return ISO_DATE_REGEX.exec(value) ? new Date(value) : value;
   });
 }
@@ -131,6 +134,513 @@ function stringifyJsonBody(body) {
   });
 }
 
+// ../../src/schema/response-dates.generated.ts
+var responseDateNodes = [
+  {},
+  {
+    "ref": 2
+  },
+  {
+    "properties": {
+      "files": 3,
+      "image": 7,
+      "rating": 8,
+      "personalInfo": 11,
+      "blockInfo": 33,
+      "meta": 36
+    }
+  },
+  {
+    "items": 4
+  },
+  {
+    "ref": 5
+  },
+  {
+    "properties": {
+      "urlExpiration": 6
+    }
+  },
+  {
+    "date": true
+  },
+  {
+    "ref": 5
+  },
+  {
+    "ref": 9
+  },
+  {
+    "properties": {
+      "date": 10
+    }
+  },
+  {
+    "date": true
+  },
+  {
+    "ref": 12
+  },
+  {
+    "properties": {
+      "meta": 13,
+      "lastUsageTime": 17,
+      "personalReminders": 18,
+      "subscriptionList": 27
+    }
+  },
+  {
+    "ref": 14
+  },
+  {
+    "properties": {
+      "lastModified": 15,
+      "createDate": 16
+    }
+  },
+  {
+    "date": true
+  },
+  {
+    "date": true
+  },
+  {
+    "date": true
+  },
+  {
+    "items": 19
+  },
+  {
+    "ref": 20
+  },
+  {
+    "properties": {
+      "date": 21,
+      "recurringConditions": 22
+    }
+  },
+  {
+    "date": true
+  },
+  {
+    "ref": 23
+  },
+  {
+    "properties": {
+      "endDate": 24,
+      "beginDate": 25,
+      "firstWeekDate": 26
+    }
+  },
+  {
+    "date": true
+  },
+  {
+    "date": true
+  },
+  {
+    "date": true
+  },
+  {
+    "items": 28
+  },
+  {
+    "ref": 29
+  },
+  {
+    "properties": {
+      "openDate": 30,
+      "closeDate": 31,
+      "recurringConditions": 32
+    }
+  },
+  {
+    "date": true
+  },
+  {
+    "date": true
+  },
+  {
+    "ref": 23
+  },
+  {
+    "ref": 34
+  },
+  {
+    "properties": {
+      "blockDate": 35
+    }
+  },
+  {
+    "date": true
+  },
+  {
+    "ref": 14
+  },
+  {
+    "ref": 2
+  },
+  {
+    "ref": 2
+  },
+  {
+    "ref": 40
+  },
+  {
+    "properties": {
+      "meta": 41
+    }
+  },
+  {
+    "ref": 14
+  },
+  {
+    "ref": 40
+  },
+  {
+    "ref": 44
+  },
+  {
+    "properties": {
+      "image": 45,
+      "rating": 46,
+      "personalInfo": 47,
+      "blockInfo": 48,
+      "meta": 49
+    }
+  },
+  {
+    "ref": 5
+  },
+  {
+    "ref": 9
+  },
+  {
+    "ref": 12
+  },
+  {
+    "ref": 34
+  },
+  {
+    "ref": 14
+  },
+  {
+    "ref": 51
+  },
+  {
+    "properties": {
+      "includeResp": 52
+    }
+  },
+  {
+    "ref": 53
+  },
+  {
+    "properties": {
+      "linkMetaList": 54
+    }
+  },
+  {
+    "items": 55
+  },
+  {
+    "ref": 56
+  },
+  {
+    "properties": {
+      "info": 57
+    }
+  },
+  {
+    "ref": 14
+  },
+  {
+    "ref": 59
+  },
+  {
+    "properties": {
+      "meta": 60,
+      "subscriptionList": 61
+    }
+  },
+  {
+    "ref": 14
+  },
+  {
+    "items": 62
+  },
+  {
+    "ref": 29
+  },
+  {
+    "items": 64
+  },
+  {
+    "ref": 65
+  },
+  {
+    "properties": {
+      "file": 66,
+      "files": 67,
+      "itemObject": 69,
+      "itemLink": 70,
+      "personalViewInfo": 73,
+      "image": 79
+    }
+  },
+  {
+    "ref": 5
+  },
+  {
+    "items": 68
+  },
+  {
+    "ref": 5
+  },
+  {
+    "ref": 40
+  },
+  {
+    "ref": 71
+  },
+  {
+    "properties": {
+      "meta": 72
+    }
+  },
+  {
+    "ref": 14
+  },
+  {
+    "ref": 74
+  },
+  {
+    "properties": {
+      "meta": 75,
+      "lastUsageTime": 76,
+      "personalReminders": 77
+    }
+  },
+  {
+    "ref": 14
+  },
+  {
+    "date": true
+  },
+  {
+    "items": 78
+  },
+  {
+    "ref": 20
+  },
+  {
+    "ref": 5
+  },
+  {
+    "items": 81
+  },
+  {
+    "ref": 65
+  },
+  {
+    "items": 83
+  },
+  {
+    "ref": 65
+  },
+  {
+    "ref": 85
+  },
+  {
+    "properties": {
+      "image": 86,
+      "rating": 87,
+      "personalInfo": 88,
+      "blockInfo": 89,
+      "meta": 90
+    }
+  },
+  {
+    "ref": 5
+  },
+  {
+    "ref": 9
+  },
+  {
+    "ref": 12
+  },
+  {
+    "ref": 34
+  },
+  {
+    "ref": 14
+  },
+  {
+    "items": 92
+  },
+  {
+    "ref": 85
+  }
+];
+var responseDateRoutes = [
+  {
+    "method": "POST",
+    "path": "/api/v1/notes",
+    "responses": {
+      "200": 1
+    }
+  },
+  {
+    "method": "GET",
+    "path": "/api/v1/search/notes",
+    "responses": {
+      "200": 82
+    }
+  },
+  {
+    "method": "POST",
+    "path": "/api/v1/contexts",
+    "responses": {
+      "200": 84
+    }
+  },
+  {
+    "method": "GET",
+    "path": "/api/v1/contexts/personallist",
+    "responses": {
+      "200": 91
+    }
+  },
+  {
+    "method": "GET",
+    "path": "/api/v1/notes/personallist",
+    "responses": {},
+    "legacy": true
+  },
+  {
+    "method": "GET",
+    "path": "/api/v1/notes/{torrowId}",
+    "responses": {
+      "200": 37
+    }
+  },
+  {
+    "method": "PUT",
+    "path": "/api/v1/notes/{torrowId}",
+    "responses": {
+      "200": 38
+    }
+  },
+  {
+    "method": "DELETE",
+    "path": "/api/v1/notes/{torrowId}",
+    "responses": {
+      "200": 0
+    }
+  },
+  {
+    "method": "PUT",
+    "path": "/api/v1/notes/{torrowId}/tags",
+    "responses": {
+      "200": 39
+    }
+  },
+  {
+    "method": "PUT",
+    "path": "/api/v1/notes/{torrowId}/solutiondata",
+    "responses": {
+      "200": 42
+    }
+  },
+  {
+    "method": "PUT",
+    "path": "/api/v1/notes/{torrowId}/group/set",
+    "responses": {
+      "200": 43
+    }
+  },
+  {
+    "method": "PUT",
+    "path": "/api/v1/notes/{torrowId}/updategroups",
+    "responses": {
+      "200": 50
+    }
+  },
+  {
+    "method": "PUT",
+    "path": "/api/v1/notes/{torrowId}/savetomindmap",
+    "responses": {
+      "200": 58
+    }
+  },
+  {
+    "method": "GET",
+    "path": "/api/v1/notes/{parentId}/views/user",
+    "responses": {
+      "200": 63
+    }
+  },
+  {
+    "method": "GET",
+    "path": "/api/v1/notes/{parentId}/views/pinned",
+    "responses": {
+      "200": 80
+    }
+  }
+];
+
+// ../../src/util/response-dates.ts
+var routes = responseDateRoutes.map((route) => ({
+  ...route,
+  segments: route.path.split("/")
+}));
+function parseOperationResponse(json, method, path, status) {
+  const segments = path.split("?")[0].split("/");
+  const route = routes.find((candidate) => candidate.method === method && candidate.segments.length === segments.length && candidate.segments.every((segment, i) => segment.startsWith("{") ? segments[i] !== "" : segment === segments[i]));
+  if (!route || route.legacy) return parseJsonWithIsoDates(json);
+  if (json === "") return void 0;
+  return reviveDeclaredDates(JSON.parse(json), responseDateNodes, route.responses[String(status)] ?? route.responses["2XX"] ?? 0);
+}
+function reviveDeclaredDates(value, nodes, root) {
+  const holder = { value };
+  function collect(parent, key, id, path, active) {
+    const result = /* @__PURE__ */ new Map();
+    const current = parent[key];
+    const node = nodes[id];
+    if (!node || active.has(id) || current == null) return result;
+    const next = new Set(active).add(id);
+    const merge = (entries) => entries.forEach((entry, name) => result.set(name, entry));
+    if (node.date && typeof current === "string") {
+      const date = new Date(current);
+      if (!Number.isNaN(date.getTime())) result.set(path, { parent, key, date });
+    }
+    if (node.ref !== void 0) merge(collect(parent, key, node.ref, path, next));
+    for (const child of node.all ?? []) merge(collect(parent, key, child, path, next));
+    for (const union of node.unions ?? []) {
+      const branches = union.map((child) => collect(parent, key, child, path, next));
+      for (const [name, candidate] of branches[0] ?? []) {
+        if (branches.every((branch) => branch.has(name))) result.set(name, candidate);
+      }
+    }
+    if (Array.isArray(current) && node.items !== void 0) {
+      current.forEach((_entry, i) => merge(collect(current, String(i), node.items, `${path}/${i}`, /* @__PURE__ */ new Set())));
+    } else if (typeof current === "object" && !Array.isArray(current)) {
+      for (const [property, child] of Object.entries(node.properties ?? {})) {
+        if (Object.hasOwn(current, property)) merge(collect(
+          current,
+          property,
+          child,
+          `${path}/${property.replace(/~/g, "~0").replace(/\//g, "~1")}`,
+          /* @__PURE__ */ new Set()
+        ));
+      }
+    }
+    return result;
+  }
+  for (const { parent, key, date } of collect(holder, "value", root, "", /* @__PURE__ */ new Set()).values()) parent[key] = date;
+  return holder.value;
+}
+
 // ../../src/util/query-string.ts
 function buildQueryString(queryStringParams) {
   const queryString = [];
@@ -208,7 +718,7 @@ var HttpClient = class {
     if (text === "") {
       return void 0;
     }
-    return parseJsonWithIsoDates(text);
+    return parseOperationResponse(text, init.method, init.path, res.status);
   }
   buildUrl(path, query) {
     const origin = this.config.baseUrl ?? DEFAULT_TORROW_API_BASE_URL;
@@ -2229,6 +2739,7 @@ var NoteTypeValues = {
   Unknown: "Unknown",
   Text: "Text",
   Html: "Html",
+  Markdown: "Markdown",
   Hlink: "Hlink",
   File: "File",
   Photo: "Photo",