@x12i/memorix-scoper-sdk 1.0.0

package/dist/decoders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoders.d.ts","sourceRoot":"","sources":["../src/decoders.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,QAAQ,CAAC;AAErD,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,OAAO,sBAAsB,CAAC;QAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,wBAAgB,kCAAkC,IAAI,IAAI,CAczD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,yBAAyB,CAG1E;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,OAAO,GAAG,yBAAyB,CAoC3F"}

package/dist/decoders.js

@@ -0,0 +1,65 @@
+import { ScoperError } from "@x12i/memorix-scoper-contracts";
+export 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 const NEXUM_PERSIST_DECODER_AVAILABLE = false;
+export function assertNexumPersistDecoderAvailable() {
+    if (!NEXUM_PERSIST_DECODER_AVAILABLE) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "memorix-nexum-persist/1 decoder unavailable: normative schema/fixtures are not locked under contracts/upstream", {
+            requiredArtifacts: [
+                "docs/nexum-persistence-schema.md",
+                "docs/fixtures/nexum-persist-roundtrip.json",
+            ],
+            contractId: NEXUM_PERSIST_CONTRACT,
+        });
+    }
+}
+/**
+ * Structural envelope gate used only after normative schema is unlocked.
+ * Does NOT invent domain fields. Currently blocked via assertNexumPersistDecoderAvailable().
+ */
+export function decodeNexumPersist(raw) {
+    assertNexumPersistDecoderAvailable();
+    return decodeNexumPersistEnvelopeUnchecked(raw);
+}
+/**
+ * @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 function decodeNexumPersistEnvelopeUnchecked(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "Nexum persist record must be an object");
+    }
+    const rec = raw;
+    const data = rec.data;
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "Missing data object on Nexum persist record");
+    }
+    const d = data;
+    const version = d.contractVersion;
+    if (version !== NEXUM_PERSIST_CONTRACT) {
+        throw new ScoperError("UNSUPPORTED_CONTRACT_VERSION", `Unsupported contractVersion: ${String(version)}`, { expected: NEXUM_PERSIST_CONTRACT, actual: version });
+    }
+    if (typeof d.serviceId !== "string" || !d.serviceId.trim()) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "data.serviceId must be a non-empty string");
+    }
+    const recordId = String(rec.recordId ?? rec.id ?? "").trim();
+    if (!recordId) {
+        throw new ScoperError("UPSTREAM_CONTRACT_MISMATCH", "recordId is required");
+    }
+    return {
+        format: typeof rec.format === "string" ? rec.format : undefined,
+        recordId,
+        objectType: typeof rec.objectType === "string" ? rec.objectType : undefined,
+        contentType: typeof rec.contentType === "string" ? rec.contentType : undefined,
+        data: d,
+        _system: rec._system && typeof rec._system === "object" && !Array.isArray(rec._system)
+            ? rec._system
+            : undefined,
+    };
+}
+//# sourceMappingURL=decoders.js.map

package/dist/decoders.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,2 @@
+export { ScoperError, isScoperError, type ScoperErrorCode } from "@x12i/memorix-scoper-contracts";
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/errors.js

@@ -0,0 +1,2 @@
+export { ScoperError, isScoperError } from "@x12i/memorix-scoper-contracts";
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAwB,MAAM,gCAAgC,CAAC"}

package/dist/estate.d.ts

@@ -0,0 +1,15 @@
+import { type TrustedExecutionContext } from "@x12i/memorix-scoper-contracts";
+import type { EstateTransport } from "./config.js";
+/**
+ * Estate / map-store path remains unavailable this pass.
+ * Production consumers must inject `estateTransport` only when locked map-store docs exist.
+ */
+export declare function requireEstateTransport(transport: EstateTransport | undefined, featureEnabled: boolean | undefined): EstateTransport;
+export type { EstateTransport };
+export declare function startEstateSession(transport: EstateTransport, input: {
+    context: TrustedExecutionContext;
+    bootstrap?: unknown;
+}): Promise<{
+    sessionId: string;
+}>;
+//# sourceMappingURL=estate.d.ts.map

package/dist/estate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estate.d.ts","sourceRoot":"","sources":["../src/estate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,eAAe,GAAG,SAAS,EACtC,cAAc,EAAE,OAAO,GAAG,SAAS,GAClC,eAAe,CAQjB;AAED,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE;IAAE,OAAO,EAAE,uBAAuB,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/D,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAEhC"}

package/dist/estate.js

@@ -0,0 +1,15 @@
+import { ScoperError } from "@x12i/memorix-scoper-contracts";
+/**
+ * Estate / map-store path remains unavailable this pass.
+ * Production consumers must inject `estateTransport` only when locked map-store docs exist.
+ */
+export function requireEstateTransport(transport, featureEnabled) {
+    if (!featureEnabled || !transport) {
+        throw new ScoperError("ESTATE_PATH_UNAVAILABLE", "Estate/map-store path is unavailable; excluded until durable upstream artifacts arrive");
+    }
+    return transport;
+}
+export async function startEstateSession(transport, input) {
+    return transport.startSession(input);
+}
+//# sourceMappingURL=estate.js.map

package/dist/estate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estate.js","sourceRoot":"","sources":["../src/estate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgC,MAAM,gCAAgC,CAAC;AAG3F;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAsC,EACtC,cAAmC;IAEnC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,WAAW,CACnB,yBAAyB,EACzB,wFAAwF,CACzF,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAID,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAA0B,EAC1B,KAAgE;IAEhE,OAAO,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/evidence-refs.d.ts

@@ -0,0 +1,6 @@
+import type { EvidenceRef, SubjectEvidenceRef, EstateBagEvidenceRef, KnowledgeExploreEvidenceRef } from "@x12i/memorix-scoper-contracts";
+export declare function subjectRef(input: Omit<SubjectEvidenceRef, "kind">): SubjectEvidenceRef;
+export declare function estateBagRef(input: Omit<EstateBagEvidenceRef, "kind">): EstateBagEvidenceRef;
+export declare function knowledgeExploreRef(input: Omit<KnowledgeExploreEvidenceRef, "kind">): KnowledgeExploreEvidenceRef;
+export declare function isEvidenceRef(value: unknown): value is EvidenceRef;
+//# sourceMappingURL=evidence-refs.d.ts.map

package/dist/evidence-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-refs.d.ts","sourceRoot":"","sources":["../src/evidence-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,gCAAgC,CAAC;AAExC,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG,kBAAkB,CAEtF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,GAAG,oBAAoB,CAE5F;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,CAAC,2BAA2B,EAAE,MAAM,CAAC,GAC/C,2BAA2B,CAE7B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAIlE"}

package/dist/evidence-refs.js

@@ -0,0 +1,16 @@
+export function subjectRef(input) {
+    return { kind: "subject", ...input };
+}
+export function estateBagRef(input) {
+    return { kind: "estate-bag", ...input };
+}
+export function knowledgeExploreRef(input) {
+    return { kind: "knowledge-explore", ...input };
+}
+export function isEvidenceRef(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const kind = value.kind;
+    return kind === "subject" || kind === "estate-bag" || kind === "knowledge-explore";
+}
+//# sourceMappingURL=evidence-refs.js.map

package/dist/evidence-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-refs.js","sourceRoot":"","sources":["../src/evidence-refs.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU,CAAC,KAAuC;IAChE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAyC;IACpE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAgD;IAEhD,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,IAAI,GAAI,KAA2B,CAAC,IAAI,CAAC;IAC/C,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,mBAAmB,CAAC;AACrF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { createMemorixScoperClient, type ContextualSdk, type MemorixScoperClient } from "./client.js";
+export { requireContentAddress, requireContentTypePair, } from "./addressing.js";
+export { type TrustedSdkConfig, type CredentialsProvider, type EstateTransport, type MemorixTransport, resolveBaseUrl, resolveHostBudgets, } from "./config.js";
+export { BudgetAccountant } from "./budgets.js";
+export { decodeNexumPersistEnvelope, decodeNexumPersistOrThrow, decodeNexumPersistRecord, decodeNexumPersistExpectedStored, } from "./decoder.js";
+export { readSubjectData } from "./subject-data.js";
+export { clampPageLimit } from "./pagination.js";
+export { describeCatalog, getCatalog, requireCatalogEntry } from "./catalog.js";
+export { subjectRef, estateBagRef, knowledgeExploreRef, isEvidenceRef } from "./evidence-refs.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACtG,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { createMemorixScoperClient } from "./client.js";
+export { requireContentAddress, requireContentTypePair, } from "./addressing.js";
+export { resolveBaseUrl, resolveHostBudgets, } from "./config.js";
+export { BudgetAccountant } from "./budgets.js";
+export { decodeNexumPersistEnvelope, decodeNexumPersistOrThrow, decodeNexumPersistRecord, decodeNexumPersistExpectedStored, } from "./decoder.js";
+export { readSubjectData } from "./subject-data.js";
+export { clampPageLimit } from "./pagination.js";
+export { describeCatalog, getCatalog, requireCatalogEntry } from "./catalog.js";
+export { subjectRef, estateBagRef, knowledgeExploreRef, isEvidenceRef } from "./evidence-refs.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAgD,MAAM,aAAa,CAAC;AACtG,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAKL,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/pagination.d.ts

@@ -0,0 +1,3 @@
+/** Clamp list/query page size: default 50, max 200 (schema §7). Never silently truncate results. */
+export declare function clampPageLimit(requested?: number): number;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAMA,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAazD"}

package/dist/pagination.js

@@ -0,0 +1,16 @@
+import { MEMORIX_PAGE_DEFAULT, MEMORIX_PAGE_MAX, } from "@x12i/memorix-scoper-contracts";
+import { ScoperError } from "@x12i/memorix-scoper-contracts";
+/** Clamp list/query page size: default 50, max 200 (schema §7). Never silently truncate results. */
+export function clampPageLimit(requested) {
+    if (requested == null || !Number.isFinite(requested))
+        return MEMORIX_PAGE_DEFAULT;
+    const n = Math.floor(requested);
+    if (n < 1) {
+        throw new ScoperError("INVALID_REQUEST", "limit must be >= 1");
+    }
+    if (n > MEMORIX_PAGE_MAX) {
+        throw new ScoperError("INVALID_REQUEST", `limit ${n} exceeds Memorix page maximum ${MEMORIX_PAGE_MAX}`);
+    }
+    return n;
+}
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,oGAAoG;AACpG,MAAM,UAAU,cAAc,CAAC,SAAkB;IAC/C,IAAI,SAAS,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAClF,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACV,MAAM,IAAI,WAAW,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,GAAG,gBAAgB,EAAE,CAAC;QACzB,MAAM,IAAI,WAAW,CACnB,iBAAiB,EACjB,SAAS,CAAC,iCAAiC,gBAAgB,EAAE,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/subject-data.d.ts

@@ -0,0 +1,9 @@
+import { type SubjectDataRequest, type SubjectDataResponse } from "@x12i/memorix-scoper-contracts";
+import type { ContextualSdk } from "./client.js";
+/**
+ * Return stored Memorix subject pieces for one recordId.
+ * Requires objectType + contentType (land v2 product read). Does not resolve names
+ * and does not fetch graph neighbors.
+ */
+export declare function readSubjectData(ctx: ContextualSdk, input: SubjectDataRequest): Promise<SubjectDataResponse>;
+//# sourceMappingURL=subject-data.d.ts.map

package/dist/subject-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-data.d.ts","sourceRoot":"","sources":["../src/subject-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAqC9B"}

package/dist/subject-data.js

@@ -0,0 +1,76 @@
+import { ScoperError, SubjectDataRequestSchema, SubjectDataResponseSchema, NEXUM_PERSIST_CONTENT_TYPE, NEXUM_PERSIST_OBJECT_TYPE, } from "@x12i/memorix-scoper-contracts";
+import { decodeNexumPersistRecord } from "./decoder.js";
+/**
+ * Return stored Memorix subject pieces for one recordId.
+ * Requires objectType + contentType (land v2 product read). Does not resolve names
+ * and does not fetch graph neighbors.
+ */
+export async function readSubjectData(ctx, input) {
+    const request = SubjectDataRequestSchema.parse(input);
+    const contentTypes = uniqueContentTypes(request.contentType, request.alsoContentTypes);
+    const pieces = [];
+    for (const contentType of contentTypes) {
+        const res = await ctx.subjects.get({
+            objectType: request.objectType,
+            contentType,
+            id: request.recordId,
+        });
+        const isAnchor = contentType === request.contentType;
+        if (isAnchor && !res.record) {
+            throw new ScoperError("READ_NOT_FOUND", `subject not found: ${request.objectType}/${contentType}/${request.recordId}`);
+        }
+        pieces.push({
+            recordId: request.recordId,
+            objectType: request.objectType,
+            contentType,
+            found: Boolean(res.record),
+            record: res.record,
+        });
+    }
+    const observedLinks = linksFromPieces(pieces);
+    return SubjectDataResponseSchema.parse({
+        anchor: {
+            recordId: request.recordId,
+            objectType: request.objectType,
+            contentType: request.contentType,
+        },
+        pieces,
+        ...(observedLinks ? { observedLinks } : {}),
+    });
+}
+function uniqueContentTypes(primary, extra) {
+    const out = [];
+    for (const raw of [primary, ...(extra ?? [])]) {
+        const contentType = raw.trim();
+        if (!contentType || out.includes(contentType))
+            continue;
+        out.push(contentType);
+    }
+    return out;
+}
+function linksFromPieces(pieces) {
+    for (const piece of pieces) {
+        if (piece.objectType !== NEXUM_PERSIST_OBJECT_TYPE ||
+            piece.contentType !== NEXUM_PERSIST_CONTENT_TYPE ||
+            !piece.record) {
+            continue;
+        }
+        try {
+            const decoded = decodeNexumPersistRecord(piece.record);
+            const nodeIds = decoded.data.proposedGraph.nodes
+                .map((node) => {
+                if (!node || typeof node !== "object" || Array.isArray(node))
+                    return "";
+                const id = node.id;
+                return typeof id === "string" ? id.trim() : "";
+            })
+                .filter(Boolean);
+            return { sourceRefs: decoded.data.sourceRefs, nodeIds };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=subject-data.js.map

package/dist/subject-data.js.map

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

package/dist/subjects.d.ts

@@ -0,0 +1,2 @@
+export { createMemorixScoperClient } from "./client.js";
+//# sourceMappingURL=subjects.d.ts.map

package/dist/subjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subjects.d.ts","sourceRoot":"","sources":["../src/subjects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC"}

package/dist/subjects.js

@@ -0,0 +1,2 @@
+export { createMemorixScoperClient } from "./client.js";
+//# sourceMappingURL=subjects.js.map

package/dist/subjects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subjects.js","sourceRoot":"","sources":["../src/subjects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@x12i/memorix-scoper-sdk",
+  "version": "1.0.0",
+  "description": "Trusted Memorix Scoper data SDK",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "catalog",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "dev"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node ../../scripts/copy-sdk-catalog.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@x12i/memorix-client": "^3.8.0",
+    "@x12i/memorix-scoper-contracts": "^1.0.0",
+    "zod": "^3.25.67"
+  },
+  "devDependencies": {
+    "@x12i/memorix-scoper-testing": "workspace:*",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT"
+}