@x12i/memorix-service 3.3.0 → 3.6.0

package/dist/routes/incremental-state.js

@@ -0,0 +1,173 @@
+import { ServiceError } from "../errors.js";
+import { resolveConnectorOpsOrg } from "./connector-ops.js";
+import { hasSecretPayload } from "../connector-ops/sanitize.js";
+function requireScopeIds(params) {
+    const instanceId = typeof params.instanceId === "string" ? params.instanceId.trim() : "";
+    const scopeKey = typeof params.scopeKey === "string" ? params.scopeKey.trim() : "";
+    if (!instanceId || !scopeKey) {
+        throw new ServiceError("VALIDATION_ERROR", "instanceId and scopeKey required", 400);
+    }
+    return { instanceId, scopeKey };
+}
+function mapErr(err) {
+    if (err instanceof ServiceError)
+        throw err;
+    throw new ServiceError("VALIDATION_ERROR", err instanceof Error ? err.message : String(err), 400);
+}
+/** MX-INC-01 versioned state refs + CAS + apply-commit. */
+export async function registerIncrementalStateRoutes(app, platform) {
+    const prefix = "/api/incremental-state/v1";
+    const scopeBase = `${prefix}/orgs/:orgId/instances/:instanceId/scopes/:scopeKey`;
+    app.get(`${scopeBase}`, async (req) => {
+        const orgId = resolveConnectorOpsOrg(req);
+        const { instanceId, scopeKey } = requireScopeIds(req.params);
+        const doc = await platform.incrementalStateFor(orgId).get(instanceId, scopeKey);
+        if (!doc) {
+            throw new ServiceError("NOT_FOUND", "no incremental state for scope", 404);
+        }
+        return doc;
+    });
+    app.get(`${scopeBase}/content`, async (req) => {
+        const orgId = resolveConnectorOpsOrg(req);
+        const { instanceId, scopeKey } = requireScopeIds(req.params);
+        const got = await platform
+            .incrementalStateFor(orgId)
+            .getContent(instanceId, scopeKey);
+        if (!got) {
+            throw new ServiceError("NOT_FOUND", "no incremental state content", 404);
+        }
+        return {
+            ...got.meta,
+            bodyBase64: got.body.toString("base64"),
+        };
+    });
+    app.post(`${scopeBase}/cas-publish`, async (req) => {
+        const orgId = resolveConnectorOpsOrg(req);
+        const { instanceId, scopeKey } = requireScopeIds(req.params);
+        const body = (req.body ?? {});
+        if (typeof body.expectedBaseVersion !== "number") {
+            throw new ServiceError("VALIDATION_ERROR", "expectedBaseVersion required", 400);
+        }
+        try {
+            return await platform
+                .incrementalStateFor(orgId)
+                .casPublish(instanceId, scopeKey, body);
+        }
+        catch (err) {
+            mapErr(err);
+        }
+    });
+    app.get(`${scopeBase}/apply-ledger`, async (req) => {
+        const orgId = resolveConnectorOpsOrg(req);
+        const { instanceId, scopeKey } = requireScopeIds(req.params);
+        const q = (req.query ?? {});
+        const limit = Math.min(200, Math.max(1, Number(q.limit ?? 50) || 50));
+        const items = await platform
+            .incrementalStateFor(orgId)
+            .listApplyLedger(instanceId, scopeKey, { limit });
+        return { orgId, instanceId, scopeKey, items, limit };
+    });
+    /**
+     * Atomic apply handoff: CAS-publish snapshot then commit stream checkpoint.
+     * Failure at either step → no checkpoint advance (and no silent state bump
+     * beyond what CAS already rejected).
+     */
+    app.post(`${scopeBase}/apply-commit`, async (req) => {
+        const orgId = resolveConnectorOpsOrg(req);
+        const { instanceId, scopeKey } = requireScopeIds(req.params);
+        const body = (req.body ?? {});
+        if (!body.runId?.trim()) {
+            throw new ServiceError("VALIDATION_ERROR", "runId required", 400);
+        }
+        if (typeof body.expectedBaseVersion !== "number") {
+            throw new ServiceError("VALIDATION_ERROR", "expectedBaseVersion required", 400);
+        }
+        if (!body.checkpoint?.connectorId || !body.checkpoint?.streamId) {
+            throw new ServiceError("VALIDATION_ERROR", "checkpoint.connectorId and checkpoint.streamId required", 400);
+        }
+        if (hasSecretPayload({ ...body, bodyBase64: undefined })) {
+            throw new ServiceError("PAYLOAD_REJECTED", "apply-commit must not contain secret field keys", 400);
+        }
+        const store = platform.incrementalStateFor(orgId);
+        const existing = await store.getApplyByRunId(instanceId, scopeKey, body.runId);
+        if (existing?.outcome === "ok") {
+            const state = await store.get(instanceId, scopeKey);
+            const checkpoint = await platform
+                .streamCheckpointsFor(orgId)
+                .get(body.checkpoint.connectorId, body.checkpoint.instanceId || instanceId, body.checkpoint.streamId);
+            if (state && checkpoint) {
+                return { state, checkpoint, applyLedger: existing, replayed: true };
+            }
+        }
+        const before = await store.get(instanceId, scopeKey);
+        const baseBefore = before?.baseVersion ?? 0;
+        let state;
+        try {
+            state = await store.casPublish(instanceId, scopeKey, {
+                expectedBaseVersion: body.expectedBaseVersion,
+                bodyBase64: body.bodyBase64,
+                contentType: body.contentType,
+                contentHash: body.contentHash,
+                producerRunId: body.runId,
+                incomplete: body.incomplete,
+                shrinkGuardFailed: body.shrinkGuardFailed,
+                tombstones: body.tombstones,
+            });
+        }
+        catch (err) {
+            await store.recordApply({
+                orgId,
+                instanceId,
+                scopeKey,
+                runId: body.runId,
+                at: new Date().toISOString(),
+                outcome: "conflict",
+                baseVersionBefore: baseBefore,
+                errorClass: err instanceof ServiceError ? err.code : "cas_failed",
+                errorMessage: err instanceof Error ? err.message : String(err),
+            });
+            mapErr(err);
+        }
+        try {
+            const checkpoint = await platform.streamCheckpointsFor(orgId).put(body.checkpoint.connectorId, body.checkpoint.instanceId || instanceId, body.checkpoint.streamId, {
+                method: body.checkpoint.method,
+                watermark: body.checkpoint.watermark,
+                revision: body.checkpoint.revision,
+                fullScanHash: body.checkpoint.fullScanHash,
+                cursor: body.checkpoint.cursor,
+                contentHash: body.checkpoint.contentHash,
+                producerRunId: body.runId,
+                expectedCheckpointRevision: body.checkpoint.expectedCheckpointRevision,
+            });
+            const applyLedger = await store.recordApply({
+                orgId,
+                instanceId,
+                scopeKey,
+                runId: body.runId,
+                at: new Date().toISOString(),
+                outcome: "ok",
+                baseVersionBefore: baseBefore,
+                baseVersionAfter: state.baseVersion,
+            });
+            return { state, checkpoint, applyLedger, replayed: false };
+        }
+        catch (err) {
+            await store.recordApply({
+                orgId,
+                instanceId,
+                scopeKey,
+                runId: body.runId,
+                at: new Date().toISOString(),
+                outcome: "failed",
+                baseVersionBefore: baseBefore,
+                baseVersionAfter: state.baseVersion,
+                errorClass: "checkpoint_commit_failed",
+                errorMessage: err instanceof Error ? err.message : String(err),
+            });
+            // State already published; checkpoint not advanced — resume uses new
+            // baseVersion; host must not invent a further checkpoint skip-ahead.
+            mapErr(err);
+        }
+    });
+}
+//# sourceMappingURL=incremental-state.js.map

package/dist/routes/incremental-state.js.map

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

package/dist/routes/integrations.d.ts

@@ -0,0 +1,5 @@
+import type { FastifyInstance } from "fastify";
+import type { MemorixPlatform } from "../platform.js";
+/** Stage −1 integration instance registry. */
+export declare function registerIntegrationRoutes(app: FastifyInstance, platform: MemorixPlatform): Promise<void>;
+//# sourceMappingURL=integrations.d.ts.map

package/dist/routes/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../src/routes/integrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAoCtD,8CAA8C;AAC9C,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAyHf"}

package/dist/routes/integrations.js

@@ -0,0 +1,126 @@
+import { ServiceError } from "../errors.js";
+import { hasRegistrySecretPayload, } from "../integrations/index.js";
+import { resolveConnectorOpsOrg } from "./connector-ops.js";
+function header(headers, name) {
+    const v = headers[name] ?? headers[name.toLowerCase()];
+    if (Array.isArray(v))
+        return v[0];
+    return typeof v === "string" ? v : undefined;
+}
+function mapStoreError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    const code = err.code;
+    if (code === "ETAG_MISMATCH" || /etag mismatch/i.test(msg)) {
+        throw new ServiceError("ETAG_MISMATCH", msg, 412);
+    }
+    if (/already exists/i.test(msg)) {
+        throw new ServiceError("CONFLICT", msg, 409);
+    }
+    if (/secret|credentialRef is required|connectorId is required/i.test(msg)) {
+        throw new ServiceError(msg.includes("secret") ? "PAYLOAD_REJECTED" : "VALIDATION_ERROR", msg, 400);
+    }
+    throw new ServiceError("VALIDATION_ERROR", msg, 400);
+}
+/** Stage −1 integration instance registry. */
+export async function registerIntegrationRoutes(app, platform) {
+    const prefix = "/api/integrations/v1";
+    app.get(`${prefix}/orgs/:orgId/instances`, async (req) => {
+        const orgId = resolveConnectorOpsOrg(req);
+        const q = (req.query ?? {});
+        const connectorId = typeof q.connectorId === "string" ? q.connectorId.trim() : undefined;
+        const enabled = q.enabled === "true" ? true : q.enabled === "false" ? false : undefined;
+        return platform.integrationInstancesFor(orgId).list({
+            ...(connectorId ? { connectorId } : {}),
+            ...(enabled != null ? { enabled } : {}),
+        });
+    });
+    app.post(`${prefix}/orgs/:orgId/instances`, async (req, reply) => {
+        const orgId = resolveConnectorOpsOrg(req);
+        const body = (req.body ?? {});
+        if (hasRegistrySecretPayload(body)) {
+            throw new ServiceError("PAYLOAD_REJECTED", "instance payload must not contain secrets; credentialRef only", 400);
+        }
+        try {
+            const created = await platform
+                .integrationInstancesFor(orgId)
+                .create(body);
+            return reply.code(201).send(created);
+        }
+        catch (err) {
+            mapStoreError(err);
+        }
+    });
+    app.get(`${prefix}/orgs/:orgId/instances/:instanceId`, async (req) => {
+        const orgId = resolveConnectorOpsOrg(req);
+        const params = req.params;
+        const instanceId = params.instanceId?.trim() ?? "";
+        if (!instanceId) {
+            throw new ServiceError("VALIDATION_ERROR", "instanceId required", 400);
+        }
+        const doc = await platform
+            .integrationInstancesFor(orgId)
+            .get(instanceId);
+        if (!doc) {
+            throw new ServiceError("NOT_FOUND", "integration instance not found", 404);
+        }
+        return doc;
+    });
+    app.put(`${prefix}/orgs/:orgId/instances/:instanceId`, async (req) => {
+        const orgId = resolveConnectorOpsOrg(req);
+        const params = req.params;
+        const instanceId = params.instanceId?.trim() ?? "";
+        if (!instanceId) {
+            throw new ServiceError("VALIDATION_ERROR", "instanceId required", 400);
+        }
+        const body = (req.body ?? {});
+        if (hasRegistrySecretPayload(body)) {
+            throw new ServiceError("PAYLOAD_REJECTED", "instance payload must not contain secrets; credentialRef only", 400);
+        }
+        const ifMatch = header(req.headers, "if-match") ??
+            header(req.headers, "If-Match") ??
+            null;
+        try {
+            return await platform
+                .integrationInstancesFor(orgId)
+                .put(instanceId, body, { ifMatch });
+        }
+        catch (err) {
+            mapStoreError(err);
+        }
+    });
+    app.delete(`${prefix}/orgs/:orgId/instances/:instanceId`, async (req, reply) => {
+        const orgId = resolveConnectorOpsOrg(req);
+        const params = req.params;
+        const instanceId = params.instanceId?.trim() ?? "";
+        if (!instanceId) {
+            throw new ServiceError("VALIDATION_ERROR", "instanceId required", 400);
+        }
+        const ifMatch = header(req.headers, "if-match") ??
+            header(req.headers, "If-Match") ??
+            null;
+        try {
+            const ok = await platform
+                .integrationInstancesFor(orgId)
+                .delete(instanceId, { ifMatch });
+            if (!ok) {
+                throw new ServiceError("NOT_FOUND", "integration instance not found", 404);
+            }
+            return reply.code(204).send();
+        }
+        catch (err) {
+            if (err instanceof ServiceError)
+                throw err;
+            mapStoreError(err);
+        }
+    });
+    app.get(`${prefix}/orgs/:orgId/mutations`, async (req) => {
+        const orgId = resolveConnectorOpsOrg(req);
+        const q = (req.query ?? {});
+        const limit = q.limit != null ? Number(q.limit) : undefined;
+        const items = await platform
+            .integrationInstancesFor(orgId)
+            .listMutations({ limit });
+        return { orgId, mutations: items };
+    });
+}
+//# sourceMappingURL=integrations.js.map

package/dist/routes/integrations.js.map

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

package/dist/routes/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/routes/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAQ/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAsMtD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAmiCf"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/routes/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAQ/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAsMtD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAq8Cf"}