@x12i/memorix-client-api 0.18.0 → 0.19.0

package/dist/upstream.js

@@ -1,11 +1,19 @@
 import { ApiError, UpstreamError } from "./errors.js";
+export const DEFAULT_UPSTREAM_TIMEOUT_MS = 30_000;
 export function subjectDirectoryPath(recordId) {
     const encoded = recordId.split("/").map((part) => encodeURIComponent(part)).join("/");
     return `/api/data/subjects/${encoded}`;
 }
-export function createUpstream(memorixUrl, fetchImpl = fetch) {
+function isAbort(err) {
+    if (!err || typeof err !== "object")
+        return false;
+    const name = err.name;
+    return name === "TimeoutError" || name === "AbortError";
+}
+export function createUpstream(memorixUrl, fetchImpl = fetch, timeoutMs = DEFAULT_UPSTREAM_TIMEOUT_MS) {
     const base = memorixUrl.replace(/\/$/, "");
     async function call(method, path, scope, body, init) {
+        const signal = init?.signal ?? (timeoutMs > 0 ? AbortSignal.timeout(timeoutMs) : undefined);
         let res;
         try {
             res = await fetchImpl(`${base}${path}`, {
@@ -18,12 +26,17 @@ export function createUpstream(memorixUrl, fetchImpl = fetch) {
                     "x-memorix-caller": scope.caller,
                 },
                 body: body === undefined ? undefined : JSON.stringify(body),
-                signal: init?.signal,
+                signal,
             });
         }
         catch (err) {
+            if (!init?.signal && isAbort(err)) {
+                throw new ApiError(504, "UPSTREAM_TIMEOUT", `Memorix did not answer ${method} ${path.split("?")[0]} within ${timeoutMs}ms`, {
+                    retryable: true,
+                });
+            }
             const message = err instanceof Error ? err.message : String(err);
-            throw new UpstreamError(502, { error: { code: "UPSTREAM", message } });
+            throw new UpstreamError(503, { error: { code: "UPSTREAM_UNAVAILABLE", message, retryable: true } });
         }
         const text = await res.text();
         let parsed = null;
@@ -36,7 +49,7 @@ export function createUpstream(memorixUrl, fetchImpl = fetch) {
             }
         }
         if (!res.ok)
-            throw new UpstreamError(res.status, parsed);
+            throw new UpstreamError(res.status, parsed, res.headers.get("retry-after") ?? undefined);
         return parsed;
     }
     return {
@@ -55,4 +68,9 @@ export function requireRecord(value, message) {
         throw new ApiError(502, "UPSTREAM", message);
     return record;
 }
+/** Memorix error code on an upstream body, when it sent one. */
+export function upstreamCode(err) {
+    const error = asRecord(asRecord(err.body)?.error);
+    return typeof error?.code === "string" ? error.code : undefined;
+}
 //# sourceMappingURL=upstream.js.map

package/dist/upstream.js.map

@@ -1 +1 @@
-{"version":3,"file":"upstream.js","sourceRoot":"","sources":["../src/upstream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAYtD,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtF,OAAO,sBAAsB,OAAO,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,YAA0B,KAAK;IAChF,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE3C,KAAK,UAAU,IAAI,CACjB,MAAsB,EACtB,IAAY,EACZ,KAAkB,EAClB,IAAc,EACd,IAAmB;QAEnB,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE;gBACtC,MAAM;gBACN,OAAO,EAAE;oBACP,MAAM,EAAE,kBAAkB;oBAC1B,cAAc,EAAE,kBAAkB;oBAClC,kBAAkB,EAAE,KAAK,CAAC,KAAK;oBAC/B,qBAAqB,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;oBAC/C,kBAAkB,EAAE,KAAK,CAAC,MAAM;iBACjC;gBACD,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC3D,MAAM,EAAE,IAAI,EAAE,MAAM;aACrB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAM,GAAY,IAAI,CAAC;QAC3B,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YAC1D,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC;QACrE,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,OAAe;IAC3D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"upstream.js","sourceRoot":"","sources":["../src/upstream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAatD,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAElD,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtF,OAAO,sBAAsB,OAAO,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,OAAO,CAAC,GAAY;IAC3B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAC;IAC7C,OAAO,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,YAAY,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,UAAkB,EAClB,YAA0B,KAAK,EAC/B,YAAoB,2BAA2B;IAE/C,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE3C,KAAK,UAAU,IAAI,CACjB,MAAsB,EACtB,IAAY,EACZ,KAAkB,EAClB,IAAc,EACd,IAAmB;QAEnB,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC5F,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE;gBACtC,MAAM;gBACN,OAAO,EAAE;oBACP,MAAM,EAAE,kBAAkB;oBAC1B,cAAc,EAAE,kBAAkB;oBAClC,kBAAkB,EAAE,KAAK,CAAC,KAAK;oBAC/B,qBAAqB,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;oBAC/C,kBAAkB,EAAE,KAAK,CAAC,MAAM;iBACjC;gBACD,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC3D,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,kBAAkB,EAAE,0BAA0B,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,SAAS,IAAI,EAAE;oBAC1H,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAM,GAAY,IAAI,CAAC;QAC3B,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YAC1D,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,SAAS,CAAC,CAAC;QACtG,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC;QACrE,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,OAAe;IAC3D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,GAAkB;IAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IAClD,OAAO,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC"}

package/dist/v1/census.d.ts

@@ -0,0 +1,59 @@
+import type { ClientScope } from "../scope.js";
+import { type Upstream } from "../upstream.js";
+export type ExactCount = {
+    status: "exact";
+    value: number;
+    deletedExcluded?: boolean;
+    versionSemantics?: "current-head" | "directory" | "stored-links";
+    method: string;
+    observedAt?: string;
+    aggregated?: boolean;
+};
+export type UnavailableCount = {
+    status: "unavailable";
+    value: null;
+    reason: string;
+    retryable: boolean;
+    method?: string;
+    observedAt?: string;
+    aggregated?: boolean;
+};
+export type CountView = ExactCount | UnavailableCount;
+export type CensusContentType = {
+    contentType: string;
+    rows: CountView;
+};
+export type CensusObjectType = {
+    objectType: string;
+    dataCategory: string | null;
+    resolution?: "conflict";
+    records: CountView;
+    recordsWithoutContent: CountView;
+    observedAt?: string;
+    contentTypes: CensusContentType[];
+};
+export type CensusSnapshot = {
+    observedAt: string;
+    ok: boolean;
+    partial: boolean;
+    unresolvedAgentIds: string[];
+    issues: Array<{
+        code: string;
+        message?: string;
+        agentId?: string;
+    }>;
+    objectTypes: CensusObjectType[];
+};
+export type CensusService = {
+    /** Census for the scope's org and agents. Reused for `ttl` unless `refresh`. */
+    get(scope: ClientScope, options?: {
+        refresh?: boolean;
+    }): Promise<CensusSnapshot>;
+    /** Cached census for the scope, without reading Memorix. */
+    peek(scope: ClientScope): CensusSnapshot | null;
+};
+export declare function unavailable(reason: string, retryable: boolean, extra?: Partial<UnavailableCount>): UnavailableCount;
+/** Normalize `GET /api/data/census` (service 3.19.1). */
+export declare function censusFromMemorix(body: unknown): CensusSnapshot;
+export declare function createCensusService(upstream: Upstream, ttlMs?: number): CensusService;
+//# sourceMappingURL=census.d.ts.map

package/dist/v1/census.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"census.d.ts","sourceRoot":"","sources":["../../src/v1/census.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEvE,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,cAAc,GAAG,WAAW,GAAG,cAAc,CAAC;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,IAAI,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAEtD,MAAM,MAAM,iBAAiB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEzE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,SAAS,CAAC;IACnB,qBAAqB,EAAE,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,iBAAiB,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,gFAAgF;IAChF,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAClF,4DAA4D;IAC5D,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,GAAG,IAAI,CAAC;CACjD,CAAC;AAIF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,gBAAgB,CAEvH;AA0CD,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CA0C/D;AAMD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,SAAiB,GAAG,aAAa,CA6C7F"}

package/dist/v1/census.js

@@ -0,0 +1,146 @@
+import { ApiError, UpstreamError } from "../errors.js";
+import { asRecord, upstreamCode } from "../upstream.js";
+const DEFAULT_TTL_MS = 60_000;
+export function unavailable(reason, retryable, extra = {}) {
+    return { status: "unavailable", value: null, reason, retryable, ...extra };
+}
+function directoryCount(raw, observedAt) {
+    if (typeof raw === "number" && Number.isFinite(raw)) {
+        return {
+            status: "exact",
+            value: raw,
+            deletedExcluded: true,
+            versionSemantics: "directory",
+            method: "record-directory",
+            ...(observedAt ? { observedAt } : {}),
+        };
+    }
+    const body = asRecord(raw);
+    if (body?.status === "unavailable") {
+        return unavailable(typeof body.reason === "string" ? body.reason : "DIRECTORY_UNAVAILABLE", body.retryable === true, {
+            method: "record-directory",
+            ...(typeof body.observedAt === "string" ? { observedAt: body.observedAt } : observedAt ? { observedAt } : {}),
+        });
+    }
+    return unavailable("NOT_REPORTED", false, { method: "record-directory" });
+}
+function rowsCount(raw, observedAt) {
+    const at = typeof raw.observedAt === "string" ? raw.observedAt : observedAt;
+    if (raw.status === "unavailable") {
+        return unavailable(typeof raw.reason === "string" ? raw.reason : "COUNT_UNAVAILABLE", raw.retryable === true, {
+            method: "live-content",
+            ...(at ? { observedAt: at } : {}),
+        });
+    }
+    if (typeof raw.rows !== "number")
+        return unavailable("NOT_REPORTED", false, { method: "live-content" });
+    return {
+        status: "exact",
+        value: raw.rows,
+        deletedExcluded: raw.deletedExcluded !== false,
+        versionSemantics: "current-head",
+        method: raw.estimated === true ? "estimate" : "live-content",
+        ...(at ? { observedAt: at } : {}),
+    };
+}
+/** Normalize `GET /api/data/census` (service 3.19.1). */
+export function censusFromMemorix(body) {
+    const root = asRecord(body) ?? {};
+    const observedAt = typeof root.observedAt === "string" ? root.observedAt : new Date().toISOString();
+    const objectTypes = [];
+    for (const item of Array.isArray(root.objectTypes) ? root.objectTypes : []) {
+        const entry = asRecord(item);
+        if (!entry || typeof entry.objectType !== "string")
+            continue;
+        const at = typeof entry.observedAt === "string" ? entry.observedAt : observedAt;
+        const contentTypes = [];
+        for (const raw of Array.isArray(entry.contentTypes) ? entry.contentTypes : []) {
+            const ct = asRecord(raw);
+            if (!ct || typeof ct.contentType !== "string")
+                continue;
+            contentTypes.push({ contentType: ct.contentType, rows: rowsCount(ct, at) });
+        }
+        objectTypes.push({
+            objectType: entry.objectType,
+            dataCategory: typeof entry.dataCategory === "string" ? entry.dataCategory : null,
+            ...(entry.resolution === "conflict" ? { resolution: "conflict" } : {}),
+            records: directoryCount(entry.records, at),
+            recordsWithoutContent: directoryCount(entry.recordsWithoutContent, at),
+            observedAt: at,
+            contentTypes,
+        });
+    }
+    const issues = (Array.isArray(root.issues) ? root.issues : [])
+        .map((raw) => asRecord(raw))
+        .filter((raw) => raw !== null && typeof raw.code === "string")
+        .map((raw) => ({
+        code: raw.code,
+        ...(typeof raw.message === "string" ? { message: raw.message } : {}),
+        ...(typeof raw.agentId === "string" ? { agentId: raw.agentId } : {}),
+    }));
+    return {
+        observedAt,
+        ok: root.ok !== false,
+        partial: root.partial === true,
+        unresolvedAgentIds: Array.isArray(root.unresolvedAgentIds)
+            ? root.unresolvedAgentIds.filter((id) => typeof id === "string")
+            : [],
+        issues,
+        objectTypes,
+    };
+}
+function cacheKey(scope) {
+    return `${scope.orgId}\u0000${[...scope.agentIds].sort().join(",")}`;
+}
+export function createCensusService(upstream, ttlMs = DEFAULT_TTL_MS) {
+    const cache = new Map();
+    async function load(scope) {
+        try {
+            return censusFromMemorix(await upstream.get("/api/data/census", scope));
+        }
+        catch (err) {
+            if (err instanceof UpstreamError && (err.statusCode === 404 || err.statusCode === 501)) {
+                throw new ApiError(501, "CAPABILITY_UNAVAILABLE", "Memorix does not serve GET /api/data/census", {
+                    feature: "census",
+                });
+            }
+            if (err instanceof UpstreamError && upstreamCode(err) === "CANONICAL_PORT_MISSING") {
+                throw new ApiError(503, "UPSTREAM_UNAVAILABLE", "Memorix has no database for this org", { retryable: true });
+            }
+            throw err;
+        }
+    }
+    return {
+        async get(scope, options = {}) {
+            const key = cacheKey(scope);
+            const hit = cache.get(key);
+            if (!options.refresh && hit) {
+                if (hit.pending)
+                    return hit.pending;
+                if (hit.snapshot && Date.now() - hit.at < ttlMs)
+                    return hit.snapshot;
+            }
+            const pending = load(scope);
+            cache.set(key, { at: Date.now(), pending, ...(hit?.snapshot ? { snapshot: hit.snapshot } : {}) });
+            try {
+                const snapshot = await pending;
+                cache.set(key, { at: Date.now(), snapshot });
+                return snapshot;
+            }
+            catch (err) {
+                if (hit?.snapshot)
+                    cache.set(key, { at: hit.at, snapshot: hit.snapshot });
+                else
+                    cache.delete(key);
+                throw err;
+            }
+        },
+        peek(scope) {
+            const hit = cache.get(cacheKey(scope));
+            if (!hit?.snapshot || Date.now() - hit.at >= ttlMs)
+                return null;
+            return hit.snapshot;
+        },
+    };
+}
+//# sourceMappingURL=census.js.map

package/dist/v1/census.js.map

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

package/dist/v1/content.d.ts

@@ -0,0 +1,48 @@
+import type { FastifyInstance } from "fastify";
+import { type ContentTypeView } from "../catalog.js";
+import type { V1Deps } from "./context.js";
+type Row = Record<string, unknown>;
+export declare function projectContentRow(row: Row, ct: ContentTypeView, data: unknown, include: Set<string>): {
+    redactedMetadata: string[];
+    descriptorCoverage: import("../project.js").DescriptorCoverage;
+    undeclaredPaths: string[];
+    metadata?: Record<string, unknown> | undefined;
+    data: unknown;
+    source: {
+        sources: any[];
+        recordedAt?: string | undefined;
+        basis?: string | undefined;
+        ingress?: string | undefined;
+        service?: string | undefined;
+        status: "declared";
+    } | {
+        status: "unavailable";
+    };
+    timestamps: {
+        writtenAt?: string | undefined;
+        modifiedAt?: string | undefined;
+        createdAt?: string | undefined;
+    };
+    state: "deleted" | "active";
+    deletion: {
+        deletedAt?: string | undefined;
+    } | null;
+    history: {
+        items?: any[] | undefined;
+        status: "present";
+        entries: number;
+    } | {
+        status: "unspecified";
+    };
+    discriminatorValue?: string | null | undefined;
+    revision: number | null;
+    head: boolean;
+    dataCategory?: string | undefined;
+    format: string;
+    recordId: string;
+    objectType: string | undefined;
+    contentType: string;
+};
+export declare function registerContentRoutes(app: FastifyInstance, deps: V1Deps): void;
+export {};
+//# sourceMappingURL=content.d.ts.map

package/dist/v1/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/v1/content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAC;AAC/D,OAAO,EAIL,KAAK,eAAe,EAGrB,MAAM,eAAe,CAAC;AAMvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAsCnC,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,GAAG,EACR,EAAE,EAAE,eAAe,EACnB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDrB;AAiFD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAoI9E"}

package/dist/v1/content.js

@@ -0,0 +1,292 @@
+import { findContentType, findObjectType, isConflicted, } from "../catalog.js";
+import { ApiError, UpstreamError } from "../errors.js";
+import { descriptorCoverage, undeclaredPaths } from "../project.js";
+import { collectReferenceTargets, expandReferenceData, loadResolvedReferences } from "../refs.js";
+import { scopeBody } from "../scope.js";
+import { asRecord, upstreamCode } from "../upstream.js";
+import { boolQuery, csv, decodeSegments, jsonQuery, limitOf, queryOf, rawPathAfter, text } from "./http.js";
+import { refsModeOf, wrapReferenceStatus } from "./records.js";
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function readPath(root, path) {
+    let current = root;
+    for (const segment of path.split(".").filter(Boolean)) {
+        if (!isRecord(current))
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+function resolveTypes(catalog, objectType, contentType) {
+    const view = findObjectType(catalog, objectType);
+    if (!view)
+        throw new ApiError(404, "READ_NOT_FOUND", `Unknown object type ${objectType}`);
+    if (isConflicted(view)) {
+        const agents = (view.alternates ?? []).map((alt) => alt.definedByAgentId).join(", ");
+        throw new ApiError(409, "METADATA_CONFLICT", `Agents ${agents} define object type ${objectType} differently. Select one of them.`);
+    }
+    const ct = findContentType(view, contentType);
+    if (!ct)
+        throw new ApiError(404, "READ_NOT_FOUND", `Unknown content type ${contentType} on ${objectType}`);
+    return { view, ct };
+}
+/** Normalize a filter to the `{ field, op, value }[]` form. */
+function filterList(raw) {
+    if (raw === undefined)
+        return [];
+    if (Array.isArray(raw))
+        return raw.filter(isRecord);
+    if (isRecord(raw)) {
+        if (typeof raw.field === "string")
+            return [raw];
+        return Object.entries(raw).map(([field, value]) => ({ field, op: "eq", value }));
+    }
+    throw new ApiError(400, "VALIDATION", "filter must be an array of { field, op, value }");
+}
+export function projectContentRow(row, ct, data, include) {
+    const system = isRecord(row._system) ? row._system : {};
+    const datasource = isRecord(system._datasource) ? system._datasource : null;
+    const metadata = isRecord(row._metadata) ? row._metadata : null;
+    const history = Array.isArray(row._history) ? row._history : null;
+    const fields = ct.fields;
+    const undeclared = undeclaredPaths(row.data, fields);
+    const deleted = system.state === "deleted";
+    const discriminatorValue = ct.discriminator ? readPath(row, ct.discriminator.path) : undefined;
+    const redacted = (ct.privateMetadata ?? []).filter((key) => !metadata || !(key in metadata));
+    return {
+        format: typeof row.format === "string" ? row.format : "memorix-record/2",
+        recordId: typeof row.recordId === "string" ? row.recordId : "",
+        objectType: typeof row.objectType === "string" ? row.objectType : undefined,
+        contentType: typeof row.contentType === "string" ? row.contentType : ct.id,
+        ...(typeof row.dataCategory === "string" ? { dataCategory: row.dataCategory } : {}),
+        revision: typeof row.revision === "number" ? row.revision : null,
+        head: true,
+        ...(ct.discriminator
+            ? { discriminatorValue: typeof discriminatorValue === "string" ? discriminatorValue : null }
+            : {}),
+        data,
+        source: datasource
+            ? {
+                status: "declared",
+                ...(typeof datasource.service === "string" ? { service: datasource.service } : {}),
+                ...(typeof datasource.ingress === "string" ? { ingress: datasource.ingress } : {}),
+                ...(typeof datasource.basis === "string" ? { basis: datasource.basis } : {}),
+                ...(typeof datasource.recordedAt === "string" ? { recordedAt: datasource.recordedAt } : {}),
+                sources: Array.isArray(datasource.sources) ? datasource.sources : [],
+            }
+            : { status: "unavailable" },
+        timestamps: {
+            ...(typeof system.createdAt === "string" ? { createdAt: system.createdAt } : {}),
+            ...(typeof system.modifiedAt === "string" ? { modifiedAt: system.modifiedAt } : {}),
+            ...(typeof system.writtenAt === "string" ? { writtenAt: system.writtenAt } : {}),
+        },
+        state: deleted ? "deleted" : "active",
+        deletion: deleted
+            ? {
+                ...(typeof system.deletedAt === "string" ? { deletedAt: system.deletedAt } : {}),
+                ...(isRecord(system.deletion) ? system.deletion : {}),
+            }
+            : null,
+        history: history
+            ? { status: "present", entries: history.length, ...(include.has("history") ? { items: history } : {}) }
+            : { status: "unspecified" },
+        ...(metadata ? { metadata } : {}),
+        redactedMetadata: redacted,
+        descriptorCoverage: descriptorCoverage(fields, undeclared),
+        undeclaredPaths: undeclared,
+    };
+}
+async function projectRows(deps, scope, catalog, ct, rows, refs, include) {
+    const fieldMap = new Map([[ct.id, ct.fields]]);
+    const attempted = new Set();
+    const resolved = await loadResolvedReferences(deps.upstream, scope, catalog, collectReferenceTargets({ [ct.id]: rows }, fieldMap, "envelope"), attempted);
+    return rows.map((row) => projectContentRow(row, ct, refs === "status"
+        ? wrapReferenceStatus(row.data ?? null, ct.fields, resolved, attempted)
+        : expandReferenceData(row.data ?? null, ct.fields, resolved), include));
+}
+function includeSet(raw) {
+    return new Set(csv(raw) ?? []);
+}
+/**
+ * Every current head of one record and content type, ordered by discriminator value.
+ * Memorix refuses a `recordId` filter on a discriminated list, so the record is composed.
+ */
+async function recordHeads(upstream, scope, ct, recordId) {
+    let body;
+    try {
+        body = asRecord(await upstream.post("/api/data/compose", scope, { explicit: true, recordId, contentTypes: [ct.id] }));
+    }
+    catch (err) {
+        if (err instanceof UpstreamError && err.statusCode === 404)
+            return [];
+        throw err;
+    }
+    const rows = asRecord(asRecord(body?.composition)?.contents)?.[ct.id];
+    const heads = (Array.isArray(rows) ? rows : []).filter(isRecord);
+    if (!ct.discriminator)
+        return heads;
+    const path = ct.discriminator.path;
+    return heads.sort((a, b) => String(readPath(a, path) ?? "").localeCompare(String(readPath(b, path) ?? "")));
+}
+async function storedDiscriminatorValues(upstream, scope, ct, recordId) {
+    if (!ct.discriminator)
+        return [];
+    try {
+        return (await recordHeads(upstream, scope, ct, recordId))
+            .map((row) => readPath(row, ct.discriminator.path))
+            .filter((value) => typeof value === "string");
+    }
+    catch {
+        return [];
+    }
+}
+function singlePath(req) {
+    const raw = rawPathAfter(req, "/api/v1/content/") ?? "";
+    const [objectType, contentType, ...rest] = raw.split("/");
+    const recordId = decodeSegments(rest.join("/").replace(/\/$/, ""));
+    if (!objectType || !contentType || !recordId) {
+        throw new ApiError(400, "VALIDATION", "path is /api/v1/content/{objectType}/{contentType}/{recordId}");
+    }
+    return { objectType: decodeSegments(objectType), contentType: decodeSegments(contentType), recordId };
+}
+export function registerContentRoutes(app, deps) {
+    app.get("/api/v1/content", async (req) => {
+        const scope = await deps.scopeFor(req);
+        const query = queryOf(req);
+        const objectType = text(query.objectType);
+        const contentType = text(query.contentType);
+        if (!objectType || !contentType)
+            throw new ApiError(400, "VALIDATION", "objectType and contentType are required");
+        const catalog = await deps.loadCatalog(deps.upstream, scope);
+        const { ct } = resolveTypes(catalog, objectType, contentType);
+        const recordId = text(query.recordId);
+        const discriminatorValue = text(query.discriminatorValue);
+        const includeDeleted = boolQuery(query.includeDeleted, "includeDeleted");
+        const filters = filterList(jsonQuery(query.filter, "filter"));
+        const sort = jsonQuery(query.sort, "sort");
+        const counting = boolQuery(query.count, "count");
+        if (recordId && !counting) {
+            if (filters.length > 0 || sort !== undefined || text(query.cursor)) {
+                throw new ApiError(400, "VALIDATION", "filter, sort, and cursor are not allowed with recordId; use discriminatorValue");
+            }
+            let heads = await recordHeads(deps.upstream, scope, ct, recordId);
+            if (discriminatorValue && ct.discriminator) {
+                heads = heads.filter((row) => readPath(row, ct.discriminator.path) === discriminatorValue);
+            }
+            if (!includeDeleted)
+                heads = heads.filter((row) => !isRecord(row._system) || row._system.state !== "deleted");
+            return {
+                scope: scopeBody(scope),
+                objectType,
+                contentType,
+                addressing: {
+                    orgId: scope.orgId,
+                    objectType,
+                    contentType,
+                    recordId,
+                    ...(discriminatorValue ? { discriminatorValue } : {}),
+                    ...(ct.discriminator ? { discriminator: ct.discriminator.path } : {}),
+                },
+                pageInfo: { complete: true, limit: heads.length },
+                truncated: false,
+                rows: await projectRows(deps, scope, catalog, ct, heads, refsModeOf(query.refs, "status"), includeSet(query.include)),
+            };
+        }
+        if (recordId)
+            filters.push({ field: "recordId", op: "in", value: [recordId] });
+        const params = new URLSearchParams({ objectType, contentType });
+        if (filters.length > 0)
+            params.set("filter", JSON.stringify(filters));
+        if (includeDeleted)
+            params.set("includeDeleted", "true");
+        if (discriminatorValue)
+            params.set("discriminatorValue", discriminatorValue);
+        const addressing = {
+            orgId: scope.orgId,
+            objectType,
+            contentType,
+            recordId: recordId ?? null,
+            ...(discriminatorValue ? { discriminatorValue } : {}),
+            ...(ct.discriminator ? { discriminator: ct.discriminator.path } : {}),
+        };
+        if (counting) {
+            params.set("count", "true");
+            try {
+                const body = asRecord(await deps.upstream.get(`/api/data/content?${params.toString()}`, scope));
+                const count = typeof body?.count === "number" ? body.count : null;
+                return {
+                    scope: scopeBody(scope),
+                    count,
+                    countStatus: count === null ? "unavailable" : "exact",
+                    ...(count === null ? { reason: "NOT_REPORTED" } : {}),
+                    addressing,
+                };
+            }
+            catch (err) {
+                if (!(err instanceof UpstreamError) || err.statusCode >= 500)
+                    throw err;
+                const code = upstreamCode(err) ?? `HTTP_${err.statusCode}`;
+                if (err.statusCode === 400 && code !== "NOT_INDEXED" && !/INDEX/.test(code))
+                    throw err;
+                return { scope: scopeBody(scope), count: null, countStatus: "unavailable", reason: "NOT_INDEXED", addressing };
+            }
+        }
+        const limit = limitOf(query.limit);
+        params.set("limit", String(limit));
+        params.set("sort", JSON.stringify(sort ?? [{ field: "recordId", direction: "asc" }]));
+        const cursor = text(query.cursor);
+        if (cursor)
+            params.set("cursor", cursor);
+        const body = asRecord(await deps.upstream.get(`/api/data/content?${params.toString()}`, scope));
+        const rows = (Array.isArray(body?.records) ? body.records : []).filter(isRecord);
+        const nextCursor = asRecord(body?.pageInfo)?.nextCursor;
+        const next = typeof nextCursor === "string" && nextCursor ? nextCursor : null;
+        return {
+            scope: scopeBody(scope),
+            objectType,
+            contentType,
+            addressing,
+            pageInfo: { complete: next === null, ...(next ? { nextCursor: next } : {}), limit },
+            truncated: false,
+            rows: await projectRows(deps, scope, catalog, ct, rows, refsModeOf(query.refs, "status"), includeSet(query.include)),
+        };
+    });
+    app.get("/api/v1/content/:objectType/:contentType/*", async (req) => {
+        const scope = await deps.scopeFor(req);
+        const { objectType, contentType, recordId } = singlePath(req);
+        const query = queryOf(req);
+        const catalog = await deps.loadCatalog(deps.upstream, scope);
+        const { ct } = resolveTypes(catalog, objectType, contentType);
+        const discriminatorValue = text(query.discriminatorValue);
+        if (ct.discriminator && !discriminatorValue && !ct.discriminator.defaultValue) {
+            const stored = await storedDiscriminatorValues(deps.upstream, scope, ct, recordId);
+            throw new ApiError(400, "VALIDATION", `discriminatorValue is required for ${contentType} (${ct.discriminator.path})`, {
+                details: { parameter: "discriminatorValue", storedValues: stored },
+            });
+        }
+        const params = new URLSearchParams({ objectType, contentType, recordId });
+        if (discriminatorValue)
+            params.set("discriminatorValue", discriminatorValue);
+        if (boolQuery(query.includeDeleted, "includeDeleted"))
+            params.set("includeDeleted", "true");
+        let record = null;
+        try {
+            const body = asRecord(await deps.upstream.get(`/api/data/content?${params.toString()}`, scope));
+            record = asRecord(body?.record);
+        }
+        catch (err) {
+            if (!(err instanceof UpstreamError) || err.statusCode !== 404)
+                throw err;
+        }
+        if (!record) {
+            const stored = await storedDiscriminatorValues(deps.upstream, scope, ct, recordId);
+            throw new ApiError(404, "READ_NOT_FOUND", stored.length > 0
+                ? `No ${contentType} head for ${recordId} with ${ct.discriminator?.path} = ${discriminatorValue}. Stored values: ${stored.join(", ")}`
+                : `No ${contentType} head for ${recordId}`, stored.length > 0 ? { details: { storedValues: stored } } : {});
+        }
+        const [row] = await projectRows(deps, scope, catalog, ct, [record], refsModeOf(query.refs, "status"), includeSet(query.include));
+        return { scope: scopeBody(scope), row };
+    });
+}
+//# sourceMappingURL=content.js.map