@x12i/memorix-service 3.7.6 → 3.7.8

package/dist/safe-query.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Parse OpenAPI SafeFilter / SafeSort query strings for GET /api/data/content.
+ * Grammar matches @x12i/memorix-data QueryFilter / QuerySort (no Mongo operators).
+ */
+export type SafeFilter = {
+    field: string;
+    op: "eq" | "ne" | "gt" | "gte" | "lt" | "lte";
+    value: unknown;
+} | {
+    field: string;
+    op: "in" | "nin";
+    value: unknown[];
+} | {
+    field: string;
+    op: "exists";
+    value: boolean;
+};
+export type SafeSort = {
+    field: string;
+    direction: "asc" | "desc";
+};
+/**
+ * Accept SafeFilter[] JSON, a single SafeFilter, or an equality map
+ * `{ "data.status": "open" }` → `[{ field, op: "eq", value }]`.
+ */
+export declare function parseSafeFilters(raw: string | undefined): SafeFilter[] | undefined;
+/** Accept body/query filter already parsed as JSON (array, SafeFilter, or equality map). */
+export declare function parseSafeFiltersValue(raw: unknown): SafeFilter[] | undefined;
+export declare function parseSafeSort(raw: string | undefined): SafeSort[] | undefined;
+export declare function parseSafeSortValue(raw: unknown): SafeSort[] | undefined;
+//# sourceMappingURL=safe-query.d.ts.map

package/dist/safe-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-query.d.ts","sourceRoot":"","sources":["../src/safe-query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,UAAU,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAChF;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,GAAG,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GACrD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpD,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAAC;AAsDpE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,EAAE,GAAG,SAAS,CAIlF;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,EAAE,GAAG,SAAS,CAI5E;AAwBD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,EAAE,GAAG,SAAS,CAI7E;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,EAAE,GAAG,SAAS,CAIvE"}

package/dist/safe-query.js

@@ -0,0 +1,125 @@
+/**
+ * Parse OpenAPI SafeFilter / SafeSort query strings for GET /api/data/content.
+ * Grammar matches @x12i/memorix-data QueryFilter / QuerySort (no Mongo operators).
+ */
+import { ServiceError } from "./errors.js";
+const SCALAR_OPS = new Set(["eq", "ne", "gt", "gte", "lt", "lte"]);
+const ARRAY_OPS = new Set(["in", "nin"]);
+function isRecord(v) {
+    return Boolean(v) && typeof v === "object" && !Array.isArray(v);
+}
+function parseJsonParam(raw, label) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new ServiceError("VALIDATION", `${label} must be valid JSON`, 400);
+    }
+}
+function assertFilter(raw, index) {
+    if (!isRecord(raw)) {
+        throw new ServiceError("READ_QUERY_INVALID", `filter[${index}] must be an object`, 400);
+    }
+    const field = raw.field;
+    const op = raw.op;
+    if (typeof field !== "string" || !field.trim()) {
+        throw new ServiceError("READ_QUERY_INVALID", `filter[${index}].field must be a non-empty string`, 400);
+    }
+    if (typeof op !== "string") {
+        throw new ServiceError("READ_QUERY_INVALID", `filter[${index}].op is required`, 400);
+    }
+    if (SCALAR_OPS.has(op)) {
+        if (!("value" in raw)) {
+            throw new ServiceError("READ_QUERY_INVALID", `filter[${index}].value is required`, 400);
+        }
+        return {
+            field,
+            op: op,
+            value: raw.value,
+        };
+    }
+    if (ARRAY_OPS.has(op)) {
+        if (!Array.isArray(raw.value)) {
+            throw new ServiceError("READ_QUERY_INVALID", `filter[${index}].value must be an array for op ${op}`, 400);
+        }
+        return { field, op: op, value: raw.value };
+    }
+    if (op === "exists") {
+        if (typeof raw.value !== "boolean") {
+            throw new ServiceError("READ_QUERY_INVALID", `filter[${index}].value must be boolean for op exists`, 400);
+        }
+        return { field, op: "exists", value: raw.value };
+    }
+    throw new ServiceError("READ_QUERY_INVALID", `Unsupported filter op: ${JSON.stringify(op)}`, 400);
+}
+/**
+ * Accept SafeFilter[] JSON, a single SafeFilter, or an equality map
+ * `{ "data.status": "open" }` → `[{ field, op: "eq", value }]`.
+ */
+export function parseSafeFilters(raw) {
+    if (raw == null || raw.trim() === "")
+        return undefined;
+    const parsed = parseJsonParam(raw, "filter");
+    return normalizeSafeFiltersValue(parsed);
+}
+/** Accept body/query filter already parsed as JSON (array, SafeFilter, or equality map). */
+export function parseSafeFiltersValue(raw) {
+    if (raw == null)
+        return undefined;
+    if (typeof raw === "string")
+        return parseSafeFilters(raw);
+    return normalizeSafeFiltersValue(raw);
+}
+function normalizeSafeFiltersValue(parsed) {
+    if (Array.isArray(parsed)) {
+        if (parsed.length === 0)
+            return undefined;
+        return parsed.map((f, i) => assertFilter(f, i));
+    }
+    if (isRecord(parsed)) {
+        if ("field" in parsed && "op" in parsed) {
+            return [assertFilter(parsed, 0)];
+        }
+        // Equality map — keys are field paths, values are eq targets.
+        const out = [];
+        for (const [field, value] of Object.entries(parsed)) {
+            if (!field.trim()) {
+                throw new ServiceError("READ_QUERY_INVALID", "filter field must be a non-empty string", 400);
+            }
+            out.push({ field, op: "eq", value });
+        }
+        return out.length ? out : undefined;
+    }
+    throw new ServiceError("READ_QUERY_INVALID", "filter must be a JSON array or object", 400);
+}
+export function parseSafeSort(raw) {
+    if (raw == null || raw.trim() === "")
+        return undefined;
+    const parsed = parseJsonParam(raw, "sort");
+    return normalizeSafeSortValue(parsed);
+}
+export function parseSafeSortValue(raw) {
+    if (raw == null)
+        return undefined;
+    if (typeof raw === "string")
+        return parseSafeSort(raw);
+    return normalizeSafeSortValue(raw);
+}
+function normalizeSafeSortValue(parsed) {
+    const items = Array.isArray(parsed) ? parsed : [parsed];
+    if (items.length === 0)
+        return undefined;
+    const out = [];
+    for (let i = 0; i < items.length; i++) {
+        const s = items[i];
+        if (!isRecord(s) || typeof s.field !== "string" || !s.field.trim()) {
+            throw new ServiceError("READ_QUERY_INVALID", `sort[${i}].field must be a non-empty string`, 400);
+        }
+        if (s.direction !== "asc" && s.direction !== "desc") {
+            throw new ServiceError("READ_QUERY_INVALID", `sort[${i}].direction must be asc|desc`, 400);
+        }
+        out.push({ field: s.field, direction: s.direction });
+    }
+    return out;
+}
+//# sourceMappingURL=safe-query.js.map

package/dist/safe-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-query.js","sourceRoot":"","sources":["../src/safe-query.ts"],"names":[],"mappings":"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"}

package/openapi/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Memorix Service API",
-    "version": "3.7.5",
+    "version": "3.7.8",
     "description": "One versioned product API over accepted Memorix packages. Scope: orgId + agentIds[]. Headers x-memorix-org-id and x-memorix-agent-ids (comma-separated). MX-CALLER-01: every /api request requires x-memorix-caller (calling app id). Intelligence never auto-installs. Relationships /links is forbidden. IntegrationsRegistry (Stage −1) and RestrictedStore (FG-A3 dual-mode blob)."
   },
   "servers": [
@@ -3027,14 +3027,34 @@
             "in": "query",
             "schema": {
               "type": "string"
-            }
+            },
+            "description": "List mode only. Opaque cursor from a prior pageInfo.nextCursor. Repeat the same filter and sort."
           },
           {
             "name": "limit",
             "in": "query",
             "schema": {
-              "type": "integer"
-            }
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 200
+            },
+            "description": "List mode page size (default 50, max 200)."
+          },
+          {
+            "name": "filter",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "description": "List mode. JSON SafeFilter[] or equality map on abstract property names."
+          },
+          {
+            "name": "sort",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "description": "List mode. JSON SafeSort[] on abstract property names."
           }
         ],
         "responses": {
@@ -3384,6 +3404,431 @@
         }
       }
     },
+    "/api/data/compose/data": {
+      "post": {
+        "operationId": "dataComposeData",
+        "summary": "Compose subject content-type data only (AI / agent projection)",
+        "description": "Same-subject composition as dataCompose, but each content type returns an array of record `.data` payloads only — no envelope, revision, or concept. Prefer this for AI layers that need sibling CT payloads without Memorix record chrome.",
+        "tags": [
+          "Data"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixCaller"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Data-only composition",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "scope",
+                    "recordId",
+                    "contents"
+                  ],
+                  "properties": {
+                    "scope": {
+                      "$ref": "#/components/schemas/MemorixScope"
+                    },
+                    "recordId": {
+                      "type": "string"
+                    },
+                    "objectType": {
+                      "type": "string"
+                    },
+                    "dataCategory": {
+                      "type": "string"
+                    },
+                    "contents": {
+                      "type": "object",
+                      "description": "Map of contentType → array of `.data` payloads (one entry per instance)",
+                      "additionalProperties": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "additionalProperties": true
+                        }
+                      }
+                    },
+                    "warnings": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "additionalProperties": true
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request / validation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "recordId",
+                  "explicit"
+                ],
+                "properties": {
+                  "recordId": {
+                    "type": "string"
+                  },
+                  "explicit": {
+                    "type": "boolean",
+                    "enum": [
+                      true
+                    ]
+                  },
+                  "contentTypes": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Optional CT filter; omit to include all directory content types for the subject"
+                  }
+                }
+              },
+              "example": {
+                "recordId": "wi-100",
+                "explicit": true,
+                "contentTypes": [
+                  "snapshots",
+                  "analysis"
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/data/compose/data/list": {
+      "post": {
+        "operationId": "dataComposeDataList",
+        "summary": "Paginated multi-CT data projection (leading CT drives page)",
+        "description": "Lists subjects by a leading content type (filter/sort/cursor/limit apply only to that CT), then attaches sibling CT `.data` arrays per row. Prefer for AI layers that need a filtered page of subjects with multiple content payloads and no record envelopes.",
+        "tags": [
+          "Data"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixCaller"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paginated data-only compositions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "scope",
+                    "objectType",
+                    "leadingContentType",
+                    "items",
+                    "pageInfo"
+                  ],
+                  "properties": {
+                    "scope": {
+                      "$ref": "#/components/schemas/MemorixScope"
+                    },
+                    "objectType": {
+                      "type": "string"
+                    },
+                    "leadingContentType": {
+                      "type": "string"
+                    },
+                    "items": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "recordId",
+                          "contents"
+                        ],
+                        "properties": {
+                          "recordId": {
+                            "type": "string"
+                          },
+                          "contents": {
+                            "type": "object",
+                            "additionalProperties": {
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "additionalProperties": true
+                              }
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "pageInfo": {
+                      "type": "object",
+                      "properties": {
+                        "nextCursor": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "limit": {
+                          "type": "integer"
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request / validation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "objectType",
+                  "leadingContentType"
+                ],
+                "properties": {
+                  "objectType": {
+                    "type": "string"
+                  },
+                  "leadingContentType": {
+                    "type": "string",
+                    "description": "CT that drives pagination, filter, and sort"
+                  },
+                  "contentTypes": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Sibling CTs to attach (leading is always included)"
+                  },
+                  "filter": {
+                    "description": "SafeFilter[] / SafeFilter / equality map — applied to leading CT only",
+                    "oneOf": [
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "additionalProperties": true
+                        }
+                      },
+                      {
+                        "type": "object",
+                        "additionalProperties": true
+                      }
+                    ]
+                  },
+                  "sort": {
+                    "description": "SafeSort[] / SafeSort — applied to leading CT only",
+                    "oneOf": [
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "additionalProperties": true
+                        }
+                      },
+                      {
+                        "type": "object",
+                        "additionalProperties": true
+                      }
+                    ]
+                  },
+                  "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 200
+                  },
+                  "cursor": {
+                    "type": "string"
+                  }
+                }
+              },
+              "example": {
+                "objectType": "work-items",
+                "leadingContentType": "snapshots",
+                "contentTypes": [
+                  "snapshots",
+                  "workflow",
+                  "analysis"
+                ],
+                "filter": {
+                  "data.status": "open"
+                },
+                "sort": [
+                  {
+                    "field": "recordId",
+                    "direction": "asc"
+                  }
+                ],
+                "limit": 50
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/data/lists": {
+      "post": {
+        "operationId": "dataRunList",
+        "summary": "Run a declared list view or an ad-hoc abstract property page",
+        "description": "Paginated abstract property page. Pass limit (1–200, default 50) and the previous pageInfo.nextCursor. Repeat the same listId or abstractType, filter, and sort on every page. recordId is an exact get and is not paginated. Concrete multi-CT pages stay on /api/data/compose/data/list (same cursor contract).",
+        "tags": ["Data"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixCaller" },
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "listId": { "type": "string" },
+                  "abstractType": { "type": "string" },
+                  "recordId": { "type": "string" },
+                  "properties": { "type": "array", "items": { "type": "string" } },
+                  "filter": { "type": "object", "additionalProperties": true },
+                  "sort": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+                  "limit": { "type": "integer" },
+                  "cursor": { "type": "string" }
+                }
+              },
+              "example": { "listId": "opx-work-items-list", "limit": 50 }
+            }
+          }
+        },
+        "responses": {
+          "200": { "description": "Abstract property page" },
+          "400": { "description": "Validation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } },
+          "404": { "description": "Unknown list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }
+        }
+      }
+    },
+    "/api/data/items": {
+      "post": {
+        "operationId": "dataGetItem",
+        "summary": "Single subject by item view or ad-hoc abstract / content types",
+        "description": "recordId is required. itemId loads a metadata view of kind item (abstract properties plus section content-type .data). Or pass abstractType and/or contentTypes without a view. Not paginated.",
+        "tags": ["Data"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixCaller" },
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["recordId"],
+                "properties": {
+                  "recordId": { "type": "string" },
+                  "itemId": { "type": "string" },
+                  "abstractType": { "type": "string" },
+                  "contentTypes": { "type": "array", "items": { "type": "string" } },
+                  "properties": { "type": "array", "items": { "type": "string" } }
+                }
+              },
+              "example": { "itemId": "opx-work-items-item", "recordId": "wi-100" }
+            }
+          }
+        },
+        "responses": {
+          "200": { "description": "Single item properties and CT data" },
+          "400": { "description": "Validation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } },
+          "404": { "description": "Unknown item or subject", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }
+        }
+      }
+    },
     "/api/relationships/definitions": {
       "get": {
         "operationId": "relationshipsListDefinitions",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/memorix-service",
-  "version": "3.7.6",
+  "version": "3.7.8",
   "description": "Memorix production service composition root — one versioned API over accepted packages.",
   "type": "module",
   "main": "./dist/index.js",
@@ -47,7 +47,7 @@
     "@x12i/funcx": "^4.12.0",
     "@x12i/magit": "2.14.0",
     "@x12i/memorix-connector-sdk": "^1.3.0",
-    "@x12i/memorix-data": "^3.0.5",
+    "@x12i/memorix-data": "^3.0.7",
     "@x12i/memorix-data-journey": "^3.1.0",
     "@x12i/memorix-format": "^3.0.2",
     "@x12i/memorix-intelligence": "^3.0.2",