@x12i/memorix-scoper-sdk 1.0.0

package/dist/client.js

@@ -0,0 +1,315 @@
+import { ScoperError, normalizeUpstreamError, NEXUM_PERSIST_OBJECT_TYPE, NEXUM_PERSIST_CONTENT_TYPE, MEMORIX_PAGE_MAX, } from "@x12i/memorix-scoper-contracts";
+import { resolveBaseUrl, resolveHostBudgets, } from "./config.js";
+import { BudgetAccountant } from "./budgets.js";
+import { decodeNexumPersistOrThrow, decodeNexumPersistRecord } from "./decoder.js";
+import { describeCatalog } from "./catalog.js";
+import { subjectRef } from "./evidence-refs.js";
+import { clampPageLimit } from "./pagination.js";
+import { requireContentAddress, requireContentTypePair } from "./addressing.js";
+async function withRetries(fn, retries) {
+    const maxAttempts = retries?.maxAttempts ?? 2;
+    const backoffMs = retries?.backoffMs ?? 50;
+    let last;
+    for (let i = 0; i < maxAttempts; i++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            last = err;
+            const normalized = normalizeUpstreamError(err);
+            if (!normalized.retryable || i >= maxAttempts - 1)
+                throw normalized;
+            await new Promise((r) => setTimeout(r, backoffMs * (i + 1)));
+        }
+    }
+    throw normalizeUpstreamError(last);
+}
+async function readErrorBody(res) {
+    try {
+        return await res.json();
+    }
+    catch {
+        return undefined;
+    }
+}
+function throwHttpError(res, body, op) {
+    const code = body && typeof body === "object"
+        ? body.error?.code
+        : undefined;
+    if (res.status === 404 || code === "READ_NOT_FOUND") {
+        throw new ScoperError("READ_NOT_FOUND", `${op}: subject not found`, { details: body });
+    }
+    throw new ScoperError("UPSTREAM_UNAVAILABLE", `${op} HTTP ${res.status}`, {
+        details: body,
+        retryable: res.status >= 500,
+    });
+}
+function defaultHttpTransport(baseUrl, context, headers) {
+    // Caller is an application label (not authentication). Credentials/grants are separate.
+    const scopeHeaders = {
+        "x-memorix-org-id": context.orgId,
+        "x-memorix-agent-ids": context.agentIds.join(","),
+        "x-memorix-caller": context.caller,
+        ...headers,
+    };
+    return {
+        async getContent({ objectType, contentType, id }) {
+            const address = requireContentAddress({ objectType, contentType, id });
+            // Land v2: recordId is primary; id remains a documented alias.
+            const params = new URLSearchParams({
+                objectType: address.objectType,
+                contentType: address.contentType,
+                recordId: address.id,
+                id: address.id,
+            });
+            const res = await fetch(`${baseUrl}/api/data/content?${params}`, {
+                headers: scopeHeaders,
+            });
+            if (!res.ok)
+                throwHttpError(res, await readErrorBody(res), "getContent");
+            const body = (await res.json());
+            return { record: body.record ?? null };
+        },
+        async listContent({ objectType, contentType, limit, cursor }) {
+            const pair = requireContentTypePair({ objectType, contentType });
+            const pageLimit = clampPageLimit(limit);
+            const params = new URLSearchParams({
+                objectType: pair.objectType,
+                contentType: pair.contentType,
+                limit: String(pageLimit),
+            });
+            if (cursor)
+                params.set("cursor", cursor);
+            const res = await fetch(`${baseUrl}/api/data/content?${params}`, {
+                headers: scopeHeaders,
+            });
+            if (!res.ok)
+                throwHttpError(res, await readErrorBody(res), "listContent");
+            const body = (await res.json());
+            const records = body.records ?? [];
+            // Never silently truncate; reject oversized pages.
+            if (records.length > MEMORIX_PAGE_MAX) {
+                throw new ScoperError("RESULT_TOO_LARGE", `listContent returned ${records.length} records exceeding page maximum ${MEMORIX_PAGE_MAX}`);
+            }
+            return {
+                records,
+                nextCursor: body.pageInfo?.nextCursor ?? null,
+            };
+        },
+    };
+}
+async function tryCreateMemorixClientTransport(config, baseUrl, context, headers) {
+    if (config.createMemorixClient) {
+        return config.createMemorixClient({ baseUrl, context, headers });
+    }
+    if (config.memorixTransport)
+        return config.memorixTransport;
+    try {
+        const mod = await import("@x12i/memorix-client");
+        const createClient = mod
+            .createClient ??
+            mod.createMemorixClient ??
+            mod.default;
+        if (typeof createClient === "function") {
+            const client = createClient({
+                baseUrl,
+                orgId: context.orgId,
+                agentIds: context.agentIds,
+                caller: context.caller,
+                headers,
+            });
+            const explore = client?.explore ?? client;
+            if (explore?.getContent && explore?.listContent) {
+                return {
+                    getContent: async ({ objectType, contentType, id }) => {
+                        try {
+                            const res = await explore.getContent({ objectType, contentType, id });
+                            return { record: res?.record ?? res ?? null };
+                        }
+                        catch (err) {
+                            throw normalizeUpstreamError(err);
+                        }
+                    },
+                    listContent: async ({ objectType, contentType, limit, cursor }) => {
+                        const pageLimit = clampPageLimit(limit);
+                        try {
+                            const res = await explore.listContent({
+                                objectType,
+                                contentType,
+                                limit: pageLimit,
+                                cursor,
+                            });
+                            const records = res?.records ?? [];
+                            if (records.length > MEMORIX_PAGE_MAX) {
+                                throw new ScoperError("RESULT_TOO_LARGE", `listContent returned ${records.length} records exceeding page maximum`);
+                            }
+                            return {
+                                records,
+                                nextCursor: res?.nextCursor ?? res?.pageInfo?.nextCursor ?? null,
+                            };
+                        }
+                        catch (err) {
+                            throw normalizeUpstreamError(err);
+                        }
+                    },
+                };
+            }
+        }
+    }
+    catch {
+        // Fall through to raw HTTP
+    }
+    return null;
+}
+export function createMemorixScoperClient(config) {
+    const baseUrl = resolveBaseUrl(config);
+    const hostBudgets = resolveHostBudgets(config);
+    return {
+        config,
+        baseUrl,
+        hostBudgets,
+        forContext(context) {
+            const budgets = new BudgetAccountant(hostBudgets);
+            let transportPromise;
+            const getTransport = async () => {
+                transportPromise ??= (async () => {
+                    const creds = config.credentials ? await config.credentials() : {};
+                    const headers = { ...(creds.headers ?? {}) };
+                    if (creds.token)
+                        headers.authorization = `Bearer ${creds.token}`;
+                    const fromClient = await tryCreateMemorixClientTransport(config, baseUrl, context, headers);
+                    return fromClient ?? defaultHttpTransport(baseUrl, context, headers);
+                })();
+                return transportPromise;
+            };
+            const estateOrThrow = () => {
+                if (!config.estateTransport) {
+                    throw new ScoperError("ESTATE_PATH_UNAVAILABLE", "Estate/map-store excluded from this pass; path unavailable");
+                }
+                return config.estateTransport;
+            };
+            return {
+                context,
+                budgets,
+                subjects: {
+                    async get({ objectType, contentType, id }) {
+                        const address = requireContentAddress({ objectType, contentType, id });
+                        budgets.checkWallClock();
+                        budgets.consumeSubjects(1);
+                        const transport = await getTransport();
+                        const res = await withRetries(() => transport.getContent({
+                            context,
+                            objectType: address.objectType,
+                            contentType: address.contentType,
+                            id: address.id,
+                        }), config.retries);
+                        return {
+                            record: res.record,
+                            ref: subjectRef({
+                                orgId: context.orgId,
+                                objectType: address.objectType,
+                                contentType: address.contentType,
+                                recordId: address.id,
+                            }),
+                        };
+                    },
+                    async list({ objectType, contentType, limit, cursor }) {
+                        const pair = requireContentTypePair({ objectType, contentType });
+                        budgets.checkWallClock();
+                        const pageLimit = clampPageLimit(limit);
+                        const transport = await getTransport();
+                        const res = await withRetries(() => transport.listContent({
+                            context,
+                            objectType: pair.objectType,
+                            contentType: pair.contentType,
+                            limit: pageLimit,
+                            cursor,
+                        }), config.retries);
+                        budgets.consumeSubjects(res.records.length);
+                        const refs = res.records.map((rec) => {
+                            const recordId = String(rec.recordId ?? rec.id ?? "").trim();
+                            return subjectRef({
+                                orgId: context.orgId,
+                                objectType: pair.objectType,
+                                contentType: pair.contentType,
+                                recordId,
+                            });
+                        });
+                        return {
+                            records: res.records,
+                            nextCursor: res.nextCursor,
+                            refs,
+                            snapshotConsistent: false,
+                        };
+                    },
+                    async query({ objectType, contentType, limit, filter }) {
+                        // Ordinary multi-page query is not snapshot-consistent (schema §7).
+                        const pair = requireContentTypePair({ objectType, contentType });
+                        const listed = await this.list({
+                            objectType: pair.objectType,
+                            contentType: pair.contentType,
+                            limit,
+                        });
+                        let records = listed.records;
+                        if (filter) {
+                            records = records.filter((rec) => Object.entries(filter).every(([k, v]) => rec[k] === v));
+                        }
+                        const refs = records.map((rec) => subjectRef({
+                            orgId: context.orgId,
+                            objectType: pair.objectType,
+                            contentType: pair.contentType,
+                            recordId: String(rec.recordId ?? rec.id ?? "").trim(),
+                        }));
+                        return { records, refs, snapshotConsistent: false };
+                    },
+                    async getNexumSnapshot({ id }) {
+                        // Nexum is Memorix-internal persist: address is fixed by memorix-nexum-persist/1.
+                        const address = requireContentAddress({
+                            objectType: NEXUM_PERSIST_OBJECT_TYPE,
+                            contentType: NEXUM_PERSIST_CONTENT_TYPE,
+                            id,
+                        });
+                        const { record } = await this.get(address);
+                        if (!record) {
+                            throw new ScoperError("READ_NOT_FOUND", `nexum snapshot not found: ${address.id} (including empty-node/no-write upstream)`);
+                        }
+                        const decoded = decodeNexumPersistRecord(record);
+                        const envelope = decodeNexumPersistOrThrow(record.data ?? record);
+                        return { envelope, record, decoded };
+                    },
+                },
+                estate: {
+                    async startSession(input) {
+                        budgets.checkWallClock();
+                        return estateOrThrow().startSession({ context, bootstrap: input?.bootstrap });
+                    },
+                    async getBag(input) {
+                        budgets.checkWallClock();
+                        return estateOrThrow().getBag({ context, ...input });
+                    },
+                    async query(input) {
+                        budgets.checkWallClock();
+                        return estateOrThrow().query({ context, ...input });
+                    },
+                },
+                explore: {
+                    async query(_input) {
+                        throw new ScoperError("NEXUM_EXPLORE_UNAVAILABLE", "Nexum Explore is excluded from this pass");
+                    },
+                },
+                catalog: {
+                    describe(filter) {
+                        return describeCatalog({
+                            ...filter,
+                            featureFlags: {
+                                estate: false,
+                                "nexum-explore": false,
+                            },
+                        });
+                    },
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,77 @@
+import type { TrustedExecutionContext, ScoperBudgets } from "@x12i/memorix-scoper-contracts";
+export type CredentialsProvider = () => Promise<{
+    token?: string;
+    headers?: Record<string, string>;
+}>;
+export interface EstateTransport {
+    startSession(input: {
+        context: TrustedExecutionContext;
+        bootstrap?: unknown;
+    }): Promise<{
+        sessionId: string;
+    }>;
+    getBag(input: {
+        context: TrustedExecutionContext;
+        sessionId: string;
+        bagId: string;
+    }): Promise<{
+        bagId: string;
+        data: unknown;
+    }>;
+    query(input: {
+        context: TrustedExecutionContext;
+        sessionId: string;
+        query: Record<string, unknown>;
+    }): Promise<{
+        results: unknown[];
+    }>;
+}
+export interface MemorixTransport {
+    getContent(input: {
+        context: TrustedExecutionContext;
+        objectType: string;
+        contentType: string;
+        id: string;
+    }): Promise<{
+        record: Record<string, unknown> | null;
+    }>;
+    listContent(input: {
+        context: TrustedExecutionContext;
+        objectType: string;
+        contentType: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        records: Array<Record<string, unknown>>;
+        nextCursor: string | null;
+    }>;
+}
+export interface TrustedSdkConfig {
+    /** Allowlisted Memorix base URL(s). Never taken from ScopeRequest. */
+    memorixBaseUrls: string[];
+    /** Selected base URL index or exact URL that must be in the allowlist. */
+    memorixBaseUrl?: string;
+    credentials?: CredentialsProvider;
+    retries?: {
+        maxAttempts?: number;
+        backoffMs?: number;
+    };
+    budgets?: Partial<ScoperBudgets>;
+    features?: {
+        estate?: boolean;
+        nexumExplore?: boolean;
+    };
+    /** Injected for tests / when map-store docs are available. */
+    estateTransport?: EstateTransport;
+    /** Override Memorix HTTP transport (tests / custom clients). */
+    memorixTransport?: MemorixTransport;
+    /** Optional factory wrapping @x12i/memorix-client. */
+    createMemorixClient?: (opts: {
+        baseUrl: string;
+        context: TrustedExecutionContext;
+        headers: Record<string, string>;
+    }) => MemorixTransport;
+}
+export declare function resolveBaseUrl(config: TrustedSdkConfig): string;
+export declare function resolveHostBudgets(config: TrustedSdkConfig): ScoperBudgets;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -0,0 +1,15 @@
+import { DEFAULT_SCOPER_BUDGETS } from "@x12i/memorix-scoper-contracts";
+export function resolveBaseUrl(config) {
+    if (!config.memorixBaseUrls.length) {
+        throw new Error("TrustedSdkConfig.memorixBaseUrls must be non-empty");
+    }
+    const preferred = config.memorixBaseUrl ?? config.memorixBaseUrls[0];
+    if (!config.memorixBaseUrls.includes(preferred)) {
+        throw new Error(`memorixBaseUrl "${preferred}" is not in allowlist`);
+    }
+    return preferred;
+}
+export function resolveHostBudgets(config) {
+    return { ...DEFAULT_SCOPER_BUDGETS, ...config.budgets };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAgExE,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,eAAe,CAAC,CAAC,CAAE,CAAC;IACtE,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,mBAAmB,SAAS,uBAAuB,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAwB;IACzD,OAAO,EAAE,GAAG,sBAAsB,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;AAC1D,CAAC"}

package/dist/decoder.d.ts

@@ -0,0 +1,21 @@
+import { type NexumPersistData, type NexumPersistRecord } from "@x12i/memorix-scoper-contracts";
+export type DecoderResult = {
+    ok: true;
+    record: NexumPersistRecord;
+    envelope: NexumPersistData;
+} | {
+    ok: false;
+    code: "UNSUPPORTED_CONTRACT_VERSION" | "UPSTREAM_CONTRACT_MISMATCH" | "DECODER_REJECTED";
+    reason: string;
+};
+/**
+ * Decode a stored Memorix subject for memorix-nexum-persist/1 per the normative schema.
+ * Preserves proposed/non-authoritative graph meaning (analyze draft, not explore truth).
+ */
+export declare function decodeNexumPersistRecord(raw: unknown): NexumPersistRecord;
+/** Decode fixture `expectedStored` (recordId may be omitted). */
+export declare function decodeNexumPersistExpectedStored(expectedStored: unknown): NexumPersistRecord;
+/** Result-style API used by existing call sites. Accepts full record or data-only object. */
+export declare function decodeNexumPersistEnvelope(data: unknown): DecoderResult;
+export declare function decodeNexumPersistOrThrow(data: unknown): NexumPersistData;
+//# sourceMappingURL=decoder.d.ts.map

package/dist/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../src/decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EAExB,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,GACpE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,8BAA8B,GAAG,4BAA4B,GAAG,kBAAkB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAwB5H;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAmHzE;AAED,iEAAiE;AACjE,wBAAgB,gCAAgC,CAAC,cAAc,EAAE,OAAO,GAAG,kBAAkB,CAS5F;AAED,6FAA6F;AAC7F,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAwBvE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAMzE"}

package/dist/decoder.js

@@ -0,0 +1,145 @@
+import { ScoperError, NEXUM_PERSIST_CONTRACT_VERSION, NEXUM_PERSIST_KIND, NEXUM_PERSIST_SERVICE_ID, NEXUM_PERSIST_OBJECT_TYPE, NEXUM_PERSIST_CONTENT_TYPE, } from "@x12i/memorix-scoper-contracts";
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function normalizeProposedGraph(raw) {
+    const g = asRecord(raw);
+    if (!g) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "data.proposedGraph must be an object");
+    }
+    if (!Array.isArray(g.nodes)) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "data.proposedGraph.nodes must be an array");
+    }
+    return {
+        nodes: g.nodes,
+        edges: Array.isArray(g.edges) ? g.edges : [],
+        unresolvedMentions: Array.isArray(g.unresolvedMentions) ? g.unresolvedMentions : [],
+        edgeCandidates: Array.isArray(g.edgeCandidates) ? g.edgeCandidates : [],
+    };
+}
+/**
+ * Decode a stored Memorix subject for memorix-nexum-persist/1 per the normative schema.
+ * Preserves proposed/non-authoritative graph meaning (analyze draft, not explore truth).
+ */
+export function decodeNexumPersistRecord(raw) {
+    const rec = asRecord(raw);
+    if (!rec) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "Nexum persist record must be an object");
+    }
+    const dataRaw = asRecord(rec.data);
+    if (!dataRaw) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "Missing data object on Nexum persist record");
+    }
+    if (dataRaw.contractVersion !== NEXUM_PERSIST_CONTRACT_VERSION) {
+        throw new ScoperError("UNSUPPORTED_CONTRACT_VERSION", `Unsupported contractVersion: ${String(dataRaw.contractVersion)}`, { details: { expected: NEXUM_PERSIST_CONTRACT_VERSION, actual: dataRaw.contractVersion } });
+    }
+    if (dataRaw.kind !== NEXUM_PERSIST_KIND) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", `data.kind must be "${NEXUM_PERSIST_KIND}"`, { details: { actual: dataRaw.kind } });
+    }
+    if (dataRaw.serviceId !== NEXUM_PERSIST_SERVICE_ID) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", `data.serviceId must be "${NEXUM_PERSIST_SERVICE_ID}"`, { details: { actual: dataRaw.serviceId } });
+    }
+    const proposedGraph = normalizeProposedGraph(dataRaw.proposedGraph);
+    if (!Array.isArray(dataRaw.sourceRefs)) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "data.sourceRefs must be an array");
+    }
+    if (typeof dataRaw.nodeCount !== "number" || !Number.isFinite(dataRaw.nodeCount)) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "data.nodeCount must be a number");
+    }
+    if (typeof dataRaw.edgeCount !== "number" || !Number.isFinite(dataRaw.edgeCount)) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "data.edgeCount must be a number");
+    }
+    if (dataRaw.nodeCount !== proposedGraph.nodes.length) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "data.nodeCount must equal proposedGraph.nodes.length", { details: { nodeCount: dataRaw.nodeCount, nodes: proposedGraph.nodes.length } });
+    }
+    if (dataRaw.edgeCount !== proposedGraph.edges.length) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "data.edgeCount must equal proposedGraph.edges.length", { details: { edgeCount: dataRaw.edgeCount, edges: proposedGraph.edges.length } });
+    }
+    let diagnostics;
+    if (dataRaw.diagnostics !== undefined) {
+        const d = asRecord(dataRaw.diagnostics);
+        if (!d) {
+            throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "data.diagnostics must be an object when present");
+        }
+        diagnostics = d;
+    }
+    const data = {
+        contractVersion: NEXUM_PERSIST_CONTRACT_VERSION,
+        kind: NEXUM_PERSIST_KIND,
+        serviceId: NEXUM_PERSIST_SERVICE_ID,
+        proposedGraph,
+        sourceRefs: dataRaw.sourceRefs.map((s) => String(s)),
+        nodeCount: dataRaw.nodeCount,
+        edgeCount: dataRaw.edgeCount,
+        ...(diagnostics ? { diagnostics } : {}),
+    };
+    const recordId = String(rec.recordId ?? rec.id ?? "").trim();
+    if (!recordId) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "Nexum persist record requires non-empty recordId (org-wide subject id; never a bare provider item id alone)");
+    }
+    const objectType = typeof rec.objectType === "string" && rec.objectType.trim()
+        ? rec.objectType.trim()
+        : NEXUM_PERSIST_OBJECT_TYPE;
+    const contentType = typeof rec.contentType === "string" && rec.contentType.trim()
+        ? rec.contentType.trim()
+        : NEXUM_PERSIST_CONTENT_TYPE;
+    if (objectType !== NEXUM_PERSIST_OBJECT_TYPE || contentType !== NEXUM_PERSIST_CONTENT_TYPE) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", `Nexum persist address must be ${NEXUM_PERSIST_OBJECT_TYPE}/${NEXUM_PERSIST_CONTENT_TYPE}`, { details: { objectType, contentType } });
+    }
+    return {
+        format: typeof rec.format === "string" ? rec.format : undefined,
+        recordId,
+        objectType,
+        contentType,
+        dataCategory: typeof rec.dataCategory === "string" ? rec.dataCategory : undefined,
+        data,
+        concept: asRecord(rec.concept) ?? undefined,
+        _system: asRecord(rec._system) ?? undefined,
+    };
+}
+/** Decode fixture `expectedStored` (recordId may be omitted). */
+export function decodeNexumPersistExpectedStored(expectedStored) {
+    const stored = asRecord(expectedStored);
+    if (!stored) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "expectedStored must be an object");
+    }
+    return decodeNexumPersistRecord({
+        recordId: typeof stored.recordId === "string" ? stored.recordId : "fixture:expectedStored",
+        ...stored,
+    });
+}
+/** Result-style API used by existing call sites. Accepts full record or data-only object. */
+export function decodeNexumPersistEnvelope(data) {
+    try {
+        const asData = asRecord(data);
+        const raw = asData && asData.contractVersion !== undefined && asData.proposedGraph !== undefined && !asData.data
+            ? {
+                recordId: "envelope:data-only",
+                objectType: NEXUM_PERSIST_OBJECT_TYPE,
+                contentType: NEXUM_PERSIST_CONTENT_TYPE,
+                data: asData,
+            }
+            : data;
+        const record = decodeNexumPersistRecord(raw);
+        return { ok: true, record, envelope: record.data };
+    }
+    catch (err) {
+        if (err instanceof ScoperError) {
+            const code = err.code === "UNSUPPORTED_CONTRACT_VERSION" || err.code === "UPSTREAM_CONTRACT_MISMATCH"
+                ? err.code
+                : "DECODER_REJECTED";
+            return { ok: false, code, reason: err.message };
+        }
+        return { ok: false, code: "DECODER_REJECTED", reason: String(err) };
+    }
+}
+export function decodeNexumPersistOrThrow(data) {
+    const result = decodeNexumPersistEnvelope(data);
+    if (!result.ok) {
+        throw new ScoperError(result.code, result.reason, { details: { data } });
+    }
+    return result.envelope;
+}
+//# sourceMappingURL=decoder.js.map

package/dist/decoder.js.map

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

package/dist/decoders.d.ts

@@ -0,0 +1,32 @@
+export declare const NEXUM_PERSIST_CONTRACT = "memorix-nexum-persist/1";
+/**
+ * Production decoder remains unavailable until these locked artifacts exist:
+ * - docs/nexum-persistence-schema.md
+ * - docs/fixtures/nexum-persist-roundtrip.json
+ * Searched x12i org; neither file nor the string `memorix-nexum-persist` was found.
+ */
+export declare const NEXUM_PERSIST_DECODER_AVAILABLE = false;
+export type MinimalNexumPersistRecord = {
+    format?: string;
+    recordId: string;
+    objectType?: string;
+    contentType?: string;
+    data: {
+        serviceId: string;
+        contractVersion: typeof NEXUM_PERSIST_CONTRACT;
+        [key: string]: unknown;
+    };
+    _system?: Record<string, unknown>;
+};
+export declare function assertNexumPersistDecoderAvailable(): void;
+/**
+ * Structural envelope gate used only after normative schema is unlocked.
+ * Does NOT invent domain fields. Currently blocked via assertNexumPersistDecoderAvailable().
+ */
+export declare function decodeNexumPersist(raw: unknown): MinimalNexumPersistRecord;
+/**
+ * @internal TEST/scaffold only — not a substitute for the missing normative schema.
+ * Rejects unknown contract versions; does not claim full memorix-nexum-persist/1 compliance.
+ */
+export declare function decodeNexumPersistEnvelopeUnchecked(raw: unknown): MinimalNexumPersistRecord;
+//# sourceMappingURL=decoders.d.ts.map