@x12i/memorix-service 3.12.3 → 3.12.4

package/openapi/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Memorix Service API",
-    "version": "3.12.3",
+    "version": "3.12.4",
     "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": [
@@ -2442,7 +2442,7 @@
       "post": {
         "operationId": "dataMoveContentFields",
         "summary": "Move top-level keys between data and _metadata",
-        "description": "data is content. _metadata is producer context and is not rendered into JSON markdown. toMetadata moves keys out of data. toData moves keys back into data. One record, exact revision.",
+        "description": "data is content. properties / _metadata is everything that is not content, and it is not rendered into JSON markdown. toMetadata moves keys out of data onto _metadata. toData moves keys back into data. One record, exact revision.",
         "tags": ["Data"],
         "parameters": [
           { "$ref": "#/components/parameters/XMemorixCaller" },
@@ -3556,6 +3556,40 @@
         }
       }
     },
+    "/api/data/subjects/*": {
+      "get": {
+        "operationId": "dataSubjectDirectory",
+        "summary": "Content types registered on one subject",
+        "description": "Directory entry only: object type, data category, and content type ids stored for this recordId. No document bodies. The wildcard path keeps record ids that contain slashes.",
+        "tags": ["Data"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixCaller" },
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" }
+        ],
+        "responses": {
+          "200": {
+            "description": "Subject directory entry",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": ["scope", "recordId", "objectType", "dataCategory", "contentTypes"],
+                  "properties": {
+                    "scope": { "$ref": "#/components/schemas/MemorixScope" },
+                    "recordId": { "type": "string" },
+                    "objectType": { "type": "string" },
+                    "dataCategory": { "type": "string" },
+                    "contentTypes": { "type": "array", "items": { "type": "string" } }
+                  }
+                }
+              }
+            }
+          },
+          "404": { "description": "Subject is not reserved" }
+        }
+      }
+    },
     "/api/data/compose": {
       "post": {
         "operationId": "dataCompose",
@@ -15386,6 +15420,17 @@
           },
           "data": {
             "type": "object",
+            "description": "Content only. JSON markdown is rendered from these keys. Do not put schema ids, duplicate ids, product kind, content hashes, or producer stamps here. Send those on properties.",
+            "additionalProperties": true
+          },
+          "properties": {
+            "type": "object",
+            "description": "Non-content fields for this write. Stored as _metadata and returned under that name. Not rendered into JSON markdown. The same key must not also appear in data. Use this for schemaVersion, objectId, a product kind objectType, contentHash, and producer stamps (step, skill, run). metadata is an older alias of this object. On a write, properties, metadata, and _metadata may all be sent only when they are equal.",
+            "additionalProperties": true
+          },
+          "_metadata": {
+            "type": "object",
+            "description": "Stored non-content fields. Write bodies may send this, or properties, or metadata. Omitted when empty. Returned on get, list, and query. Not rendered into JSON markdown.",
             "additionalProperties": true
           },
           "analytics": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/memorix-service",
-  "version": "3.12.3",
+  "version": "3.12.4",
   "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.1.1",
+    "@x12i/memorix-data": "^3.1.2",
     "@x12i/memorix-data-journey": "^3.1.0",
     "@x12i/memorix-format": "^3.0.8",
     "@x12i/memorix-intelligence": "^3.0.2",