@x12i/memorix-service 3.12.0 → 3.12.3

package/openapi/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Memorix Service API",
-    "version": "3.12.0",
+    "version": "3.12.3",
     "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": [
@@ -15031,6 +15031,62 @@
           "200": { "description": "Delivery rows. Not stored on the subject record." }
         }
       }
+    },
+    "/api/hooks/v1/subscriptions/{subscriptionId}/inbox": {
+      "get": {
+        "operationId": "hooksInbox",
+        "tags": ["Hooks"],
+        "summary": "Waiting notices, oldest first",
+        "description": "Pending deliveries the subscriber has not accepted. A POST that returns HTTP 200 without { accepted: true }, or times out, or returns 5xx, stays here. Clear one with hooksCompleteDelivery.",
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixCaller" },
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" },
+          { "name": "subscriptionId", "in": "path", "required": true, "schema": { "type": "string" } },
+          { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 } }
+        ],
+        "responses": {
+          "200": { "description": "Open deliveries, including address, event, and change." },
+          "404": { "description": "HOOK_SUBSCRIPTION_NOT_FOUND" }
+        }
+      }
+    },
+    "/api/hooks/v1/subscriptions/{subscriptionId}/backfill": {
+      "post": {
+        "operationId": "hooksBackfill",
+        "tags": ["Hooks"],
+        "summary": "Enqueue inbox deliveries for stored rows this subscription has not taken",
+        "description": "Selects stored content of the subscription match object type and content type that has no trigger mark for this subscription. Each selected row becomes one pending inbox delivery, and that enqueue is the mark. A later call returns enqueued 0 for those rows. Completing a delivery leaves the mark. A later save of a marked row still emits a live delivery.",
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixCaller" },
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" },
+          { "name": "subscriptionId", "in": "path", "required": true, "schema": { "type": "string" } }
+        ],
+        "responses": {
+          "200": { "description": "{ subscriptionId, enqueued, alreadyTriggered }" },
+          "404": { "description": "HOOK_SUBSCRIPTION_NOT_FOUND" }
+        }
+      }
+    },
+    "/api/hooks/v1/subscriptions/{subscriptionId}/deliveries/{deliveryId}/complete": {
+      "post": {
+        "operationId": "hooksCompleteDelivery",
+        "tags": ["Hooks"],
+        "summary": "Clear one waiting notice",
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixCaller" },
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" },
+          { "name": "subscriptionId", "in": "path", "required": true, "schema": { "type": "string" } },
+          { "name": "deliveryId", "in": "path", "required": true, "schema": { "type": "string" } }
+        ],
+        "responses": {
+          "200": { "description": "{ deliveryId, cleared: true }. Completing an already delivered row is the same." },
+          "404": { "description": "HOOK_SUBSCRIPTION_NOT_FOUND or HOOK_DELIVERY_NOT_FOUND" },
+          "409": { "description": "HOOK_DELIVERY_CLOSED" }
+        }
+      }
     }
   },
   "components": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/memorix-service",
-  "version": "3.12.0",
+  "version": "3.12.3",
   "description": "Memorix production service composition root — one versioned API over accepted packages.",
   "type": "module",
   "main": "./dist/index.js",