@x12i/memorix-client-api 0.18.0 → 0.19.0

package/dist/v1/planning-store.js

@@ -0,0 +1,192 @@
+import { randomBytes } from "node:crypto";
+import { ApiError } from "../errors.js";
+export function newPlanningId() {
+    return `pln_${Date.now().toString(36).padStart(9, "0")}${randomBytes(5).toString("hex")}`;
+}
+export function planningDatabaseName(orgId) {
+    const id = orgId.trim().toLowerCase();
+    if (!/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/.test(id)) {
+        throw new ApiError(400, "SCOPE_INVALID", "org id cannot name a planning database");
+    }
+    return `${id}-memorix-assistants`;
+}
+function matches(item, filter) {
+    if (item.archived !== filter.archived)
+        return false;
+    if (filter.stage && item.stage !== filter.stage)
+        return false;
+    if (filter.priority && item.priority !== filter.priority)
+        return false;
+    if (filter.assigneeId !== undefined && item.assigneeId !== filter.assigneeId)
+        return false;
+    const target = item.target;
+    if (filter.objectType && target.objectType !== filter.objectType && target.fromObjectType !== filter.objectType && target.toObjectType !== filter.objectType) {
+        return false;
+    }
+    if (filter.contentType && target.contentType !== filter.contentType)
+        return false;
+    if (filter.definitionId && target.definitionId !== filter.definitionId)
+        return false;
+    return true;
+}
+/** Items in process memory. Tests and single-process demos. */
+export function createMemoryPlanningStore() {
+    const orgs = new Map();
+    const itemsOf = (orgId) => {
+        let items = orgs.get(orgId);
+        if (!items) {
+            items = new Map();
+            orgs.set(orgId, items);
+        }
+        return items;
+    };
+    return {
+        async list(orgId, filter, page) {
+            const sorted = [...itemsOf(orgId).values()]
+                .filter((item) => matches(item, filter))
+                .sort((a, b) => b.id.localeCompare(a.id))
+                .filter((item) => !page.after || item.id < page.after);
+            const items = sorted.slice(0, page.limit);
+            return { items: structuredClone(items), ...(sorted.length > page.limit ? { next: items.at(-1).id } : {}) };
+        },
+        async get(orgId, id) {
+            const item = itemsOf(orgId).get(id);
+            return item ? structuredClone(item) : null;
+        },
+        async insert(orgId, item) {
+            const items = itemsOf(orgId);
+            if (item.clientKey) {
+                const existing = [...items.values()].find((stored) => stored.clientKey === item.clientKey);
+                if (existing)
+                    return { item: structuredClone(existing), created: false };
+            }
+            items.set(item.id, structuredClone(item));
+            return { item: structuredClone(item), created: true };
+        },
+        async update(orgId, id, expectedRevision, changes, actor) {
+            const items = itemsOf(orgId);
+            const current = items.get(id);
+            if (!current || (expectedRevision !== null && current.revision !== expectedRevision)) {
+                return { ok: false, current: current ? structuredClone(current) : null };
+            }
+            const next = {
+                ...current,
+                ...changes,
+                revision: current.revision + 1,
+                updatedBy: actor,
+                updatedAt: new Date().toISOString(),
+            };
+            items.set(id, next);
+            return { ok: true, item: structuredClone(next) };
+        },
+    };
+}
+function fromDocument(doc) {
+    if (!doc)
+        return null;
+    const { _id: _ignored, ...rest } = doc;
+    return rest;
+}
+function mongoFilter(filter) {
+    const query = { archived: filter.archived };
+    if (filter.stage)
+        query.stage = filter.stage;
+    if (filter.priority)
+        query.priority = filter.priority;
+    if (filter.assigneeId !== undefined)
+        query.assigneeId = filter.assigneeId;
+    if (filter.objectType) {
+        query.$or = [
+            { "target.objectType": filter.objectType },
+            { "target.fromObjectType": filter.objectType },
+            { "target.toObjectType": filter.objectType },
+        ];
+    }
+    if (filter.contentType)
+        query["target.contentType"] = filter.contentType;
+    if (filter.definitionId)
+        query["target.definitionId"] = filter.definitionId;
+    return query;
+}
+/** Items in collection `planning_items` of `{orgId}-memorix-assistants`. */
+export function createMongoPlanningStore(uri) {
+    let client = null;
+    const ready = new Map();
+    function collection(orgId) {
+        const name = planningDatabaseName(orgId);
+        let hit = ready.get(name);
+        if (!hit) {
+            hit = (async () => {
+                if (!client) {
+                    const specifier = "mongodb";
+                    client = import(specifier).then((mod) => new mod.MongoClient(uri).connect());
+                    client.catch(() => {
+                        client = null;
+                    });
+                }
+                const coll = (await client).db(name).collection("planning_items");
+                await coll.createIndex({ id: 1 }, { unique: true, name: "planning_id" });
+                await coll.createIndex({ clientKey: 1 }, { unique: true, name: "planning_client_key", partialFilterExpression: { clientKey: { $type: "string" } } });
+                return coll;
+            })();
+            hit.catch(() => ready.delete(name));
+            ready.set(name, hit);
+        }
+        return hit;
+    }
+    async function guarded(work) {
+        try {
+            return await work();
+        }
+        catch (err) {
+            if (err instanceof ApiError)
+                throw err;
+            const message = err instanceof Error ? err.message : String(err);
+            throw new ApiError(503, "PERSISTENCE", `planning store is unavailable: ${message}`, { retryable: true });
+        }
+    }
+    return {
+        list: (orgId, filter, page) => guarded(async () => {
+            const coll = await collection(orgId);
+            const query = mongoFilter(filter);
+            if (page.after)
+                query.id = { $lt: page.after };
+            const docs = await coll.find(query, { projection: { _id: 0 } }).sort({ id: -1 }).limit(page.limit + 1).toArray();
+            const items = docs.slice(0, page.limit).map((doc) => fromDocument(doc));
+            return { items, ...(docs.length > page.limit ? { next: items.at(-1).id } : {}) };
+        }),
+        get: (orgId, id) => guarded(async () => fromDocument(await (await collection(orgId)).findOne({ id }, { projection: { _id: 0 } }))),
+        insert: (orgId, item) => guarded(async () => {
+            const coll = await collection(orgId);
+            if (item.clientKey) {
+                const existing = fromDocument(await coll.findOne({ clientKey: item.clientKey }, { projection: { _id: 0 } }));
+                if (existing)
+                    return { item: existing, created: false };
+            }
+            try {
+                await coll.insertOne({ ...item });
+            }
+            catch (err) {
+                if (err.code === 11000 && item.clientKey) {
+                    const existing = fromDocument(await coll.findOne({ clientKey: item.clientKey }, { projection: { _id: 0 } }));
+                    if (existing)
+                        return { item: existing, created: false };
+                }
+                throw err;
+            }
+            return { item, created: true };
+        }),
+        update: (orgId, id, expectedRevision, changes, actor) => guarded(async () => {
+            const coll = await collection(orgId);
+            const filter = { id };
+            if (expectedRevision !== null)
+                filter.revision = expectedRevision;
+            const result = await coll.findOneAndUpdate(filter, { $set: { ...changes, updatedBy: actor, updatedAt: new Date().toISOString() }, $inc: { revision: 1 } }, { returnDocument: "after", projection: { _id: 0 }, includeResultMetadata: false });
+            const updated = fromDocument(result);
+            if (updated)
+                return { ok: true, item: updated };
+            return { ok: false, current: fromDocument(await coll.findOne({ id }, { projection: { _id: 0 } })) };
+        }),
+    };
+}
+//# sourceMappingURL=planning-store.js.map

package/dist/v1/planning-store.js.map

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

package/dist/v1/planning.d.ts

@@ -0,0 +1,5 @@
+import type { FastifyInstance } from "fastify";
+import type { V1Deps } from "./context.js";
+export declare const PLANNING_WRITE_FEATURE = "memorix-planning-write";
+export declare function registerPlanningRoutes(app: FastifyInstance, deps: V1Deps): void;
+//# sourceMappingURL=planning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../src/v1/planning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAK7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAa3C,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAqE/D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA6O/E"}

package/dist/v1/planning.js

@@ -0,0 +1,297 @@
+import { tokenHasFeature } from "../authix.js";
+import { ApiError, capabilityUnavailable } from "../errors.js";
+import { scopeBody } from "../scope.js";
+import { limitOf, queryOf, text } from "./http.js";
+import { newPlanningId, } from "./planning-store.js";
+import { loadDefinitions } from "./relationships.js";
+export const PLANNING_WRITE_FEATURE = "memorix-planning-write";
+const CATEGORIES = ["data-gap", "visibility-gap", "unused-structure", "proposed-change"];
+const PRIORITIES = ["low", "medium", "high"];
+const STAGES = ["investigate", "plan-next", "later", "done"];
+const EDITABLE = ["title", "outcome", "category", "priority", "assigneeId", "stage"];
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function requiredText(body, key, max = 500) {
+    const value = body[key];
+    if (typeof value !== "string" || !value.trim())
+        throw new ApiError(400, "VALIDATION", `${key} is required`);
+    if (value.length > max)
+        throw new ApiError(400, "VALIDATION", `${key} is longer than ${max} characters`);
+    return value.trim();
+}
+function oneOf(value, allowed, key) {
+    if (typeof value !== "string" || !allowed.includes(value)) {
+        throw new ApiError(400, "VALIDATION", `${key} must be one of ${allowed.join(", ")}`);
+    }
+    return value;
+}
+function targetOf(raw) {
+    if (!isRecord(raw))
+        throw new ApiError(400, "VALIDATION", "target is required");
+    const str = (key) => requiredText(raw, key, 200);
+    switch (raw.kind) {
+        case "object-type":
+            return { kind: "object-type", objectType: str("objectType") };
+        case "content-type":
+            return { kind: "content-type", objectType: str("objectType"), contentType: str("contentType") };
+        case "relationship-pair":
+            return {
+                kind: "relationship-pair",
+                definitionId: str("definitionId"),
+                fromObjectType: str("fromObjectType"),
+                toObjectType: str("toObjectType"),
+            };
+        default:
+            throw new ApiError(400, "VALIDATION", "target.kind must be object-type, content-type, or relationship-pair");
+    }
+}
+/** `If-Match: "3"` → 3. Absent → null. */
+function ifMatchOf(req) {
+    const raw = req.headers["if-match"];
+    const value = (Array.isArray(raw) ? raw[0] : raw)?.trim();
+    if (!value)
+        return null;
+    const match = /^(?:W\/)?"?(\d+)"?$/.exec(value);
+    if (!match)
+        throw new ApiError(400, "VALIDATION", 'If-Match must be the quoted item revision, for example "3"');
+    return Number(match[1]);
+}
+function encodeCursor(id) {
+    return Buffer.from(id, "utf8").toString("base64url");
+}
+function decodeCursor(raw) {
+    if (!raw)
+        return undefined;
+    const id = Buffer.from(raw, "base64url").toString("utf8");
+    if (!id.startsWith("pln_"))
+        throw new ApiError(400, "VALIDATION", "cursor does not belong to this query");
+    return id;
+}
+export function registerPlanningRoutes(app, deps) {
+    function storeOrThrow() {
+        if (!deps.planning) {
+            throw capabilityUnavailable("planning", "planning storage is not configured (ASSISTANT_MONGO_URI or MONGO_URI)");
+        }
+        return deps.planning;
+    }
+    function assigneesFor(orgId) {
+        return deps.assignees(orgId);
+    }
+    function assigneeView(orgId, id) {
+        if (id === null)
+            return { id: null, name: "Unassigned", kind: "unassigned" };
+        const known = assigneesFor(orgId)?.find((item) => item.id === id);
+        return known ? { id, name: known.name, kind: known.kind ?? "person" } : { id, name: id, kind: "unknown" };
+    }
+    function checkAssignee(orgId, value) {
+        if (value === null || value === undefined)
+            return null;
+        if (typeof value !== "string" || !assigneesFor(orgId)?.some((item) => item.id === value)) {
+            throw new ApiError(400, "ASSIGNEE_UNKNOWN", `assignee ${String(value)} is not in the option list for this org`);
+        }
+        return value;
+    }
+    async function writeScope(req) {
+        const scope = await deps.scopeFor(req, { agents: "optional" });
+        storeOrThrow();
+        const { claims } = await deps.authenticate(req);
+        if (claims && !tokenHasFeature(claims, PLANNING_WRITE_FEATURE, scope.orgId)) {
+            throw new ApiError(403, "PLANNING_FORBIDDEN", `planning writes need the ${PLANNING_WRITE_FEATURE} token feature for org ${scope.orgId}`);
+        }
+        return scope;
+    }
+    async function catalogFor(scope, needPairs, gaps) {
+        if (scope.agentIds.length === 0) {
+            gaps.push({ code: "TARGET_STATE_UNKNOWN", category: "unavailable", orgId: scope.orgId, agentIds: [], message: "no agents are recorded for this org, so targets cannot be checked", retryable: false });
+            return null;
+        }
+        try {
+            const objectTypes = await deps.loadCatalog(deps.upstream, scope);
+            let pairs = null;
+            if (needPairs) {
+                const definitions = await loadDefinitions(deps.upstream, scope, objectTypes);
+                pairs = new Set(definitions.definitions.flatMap((definition) => definition.objectTypes.map((pair) => `${definition.id}\u0000${pair.fromObjectType}\u0000${pair.toObjectType}`)));
+            }
+            return { objectTypes, pairs };
+        }
+        catch (err) {
+            gaps.push({ code: "TARGET_STATE_UNKNOWN", category: "unavailable", orgId: scope.orgId, agentIds: scope.agentIds, message: `catalog could not be read (${err instanceof Error ? err.message : String(err)})`, retryable: true });
+            return null;
+        }
+    }
+    function targetState(target, catalog) {
+        if (!catalog)
+            return "unknown";
+        if (target.kind === "relationship-pair") {
+            if (!catalog.pairs)
+                return "unknown";
+            return catalog.pairs.has(`${target.definitionId}\u0000${target.fromObjectType}\u0000${target.toObjectType}`)
+                ? "in-catalog"
+                : "not-in-catalog";
+        }
+        const view = catalog.objectTypes.find((item) => item.id === target.objectType);
+        if (!view)
+            return "not-in-catalog";
+        if (target.kind === "object-type")
+            return "in-catalog";
+        if (view.resolution === "conflict")
+            return "unknown";
+        return view.contentTypes.some((ct) => ct.id === target.contentType) ? "in-catalog" : "not-in-catalog";
+    }
+    function present(orgId, item, catalog) {
+        const { assigneeId, ...rest } = item;
+        return { ...rest, assigneeId, assignee: assigneeView(orgId, assigneeId), targetState: targetState(item.target, catalog) };
+    }
+    async function presentOne(scope, item) {
+        const gaps = [];
+        const catalog = await catalogFor(scope, item.target.kind === "relationship-pair", gaps);
+        return { item: present(scope.orgId, item, catalog), gaps };
+    }
+    function sendItem(reply, scope, body, status = 200) {
+        reply.header("etag", `"${body.item.revision}"`);
+        return reply.status(status).send({ scope: scopeBody(scope), item: body.item, gaps: body.gaps });
+    }
+    async function conflict(scope, current, message) {
+        if (!current)
+            throw new ApiError(404, "READ_NOT_FOUND", "planning item not found");
+        const { item } = await presentOne(scope, current);
+        throw new ApiError(409, "PLANNING_CONFLICT", message, { current: item, headers: { etag: `"${current.revision}"` } });
+    }
+    async function applyChange(req, reply, changes, ifMatch) {
+        const scope = await writeScope(req);
+        const store = storeOrThrow();
+        const { itemId } = req.params;
+        const expected = ifMatchOf(req);
+        if (expected === null && ifMatch === "required") {
+            await conflict(scope, await store.get(scope.orgId, itemId), "If-Match with the current revision is required");
+        }
+        const result = await store.update(scope.orgId, itemId, expected, changes, scope.caller);
+        if (!result.ok)
+            await conflict(scope, result.current, `revision ${expected} is not the current revision`);
+        if (!result.ok)
+            throw new ApiError(500, "INTERNAL", "unreachable");
+        return sendItem(reply, scope, await presentOne(scope, result.item));
+    }
+    app.get("/api/v1/planning/items", async (req) => {
+        const scope = await deps.scopeFor(req, { agents: "optional" });
+        const store = storeOrThrow();
+        const query = queryOf(req);
+        const archivedRaw = text(query.archived);
+        if (archivedRaw && archivedRaw !== "true" && archivedRaw !== "false") {
+            throw new ApiError(400, "VALIDATION", "archived must be true or false");
+        }
+        const assignee = text(query.assignee);
+        const filter = {
+            archived: archivedRaw === "true",
+            ...(text(query.stage) ? { stage: oneOf(text(query.stage), STAGES, "stage") } : {}),
+            ...(text(query.priority) ? { priority: oneOf(text(query.priority), PRIORITIES, "priority") } : {}),
+            ...(assignee ? { assigneeId: assignee === "unassigned" || assignee === "null" ? null : assignee } : {}),
+            ...(text(query.objectType) ? { objectType: text(query.objectType) } : {}),
+            ...(text(query.contentType) ? { contentType: text(query.contentType) } : {}),
+            ...(text(query.definitionId) ? { definitionId: text(query.definitionId) } : {}),
+        };
+        const limit = limitOf(query.limit);
+        const page = await store.list(scope.orgId, filter, { limit, after: decodeCursor(text(query.cursor)) });
+        const gaps = [];
+        const catalog = await catalogFor(scope, page.items.some((item) => item.target.kind === "relationship-pair"), gaps);
+        return {
+            scope: scopeBody(scope),
+            items: page.items.map((item) => present(scope.orgId, item, catalog)),
+            pageInfo: { complete: !page.next, ...(page.next ? { nextCursor: encodeCursor(page.next) } : {}), limit },
+            gaps,
+        };
+    });
+    app.post("/api/v1/planning/items", async (req, reply) => {
+        const scope = await writeScope(req);
+        const store = storeOrThrow();
+        const body = isRecord(req.body) ? req.body : null;
+        if (!body)
+            throw new ApiError(400, "VALIDATION", "body must be a JSON object");
+        const now = new Date().toISOString();
+        const clientKey = body.clientKey === undefined || body.clientKey === null ? undefined : requiredText(body, "clientKey", 200);
+        const item = {
+            id: newPlanningId(),
+            orgId: scope.orgId,
+            title: requiredText(body, "title", 200),
+            outcome: requiredText(body, "outcome", 2000),
+            target: targetOf(body.target),
+            category: oneOf(body.category, CATEGORIES, "category"),
+            priority: oneOf(body.priority, PRIORITIES, "priority"),
+            assigneeId: checkAssignee(scope.orgId, body.assigneeId),
+            stage: body.stage === undefined ? "investigate" : oneOf(body.stage, STAGES, "stage"),
+            archived: false,
+            revision: 1,
+            createdBy: scope.caller,
+            createdAt: now,
+            updatedBy: scope.caller,
+            updatedAt: now,
+            evidence: body.evidence ?? null,
+            ...(clientKey ? { clientKey } : {}),
+        };
+        const result = await store.insert(scope.orgId, item);
+        return sendItem(reply, scope, await presentOne(scope, result.item), result.created ? 201 : 200);
+    });
+    app.get("/api/v1/planning/items/:itemId", async (req, reply) => {
+        const scope = await deps.scopeFor(req, { agents: "optional" });
+        const store = storeOrThrow();
+        const { itemId } = req.params;
+        const item = await store.get(scope.orgId, itemId);
+        if (!item)
+            throw new ApiError(404, "READ_NOT_FOUND", `planning item ${itemId} not found`);
+        const etag = `"${item.revision}"`;
+        const inm = req.headers["if-none-match"];
+        if (typeof inm === "string" && inm.split(",").map((v) => v.trim().replace(/^W\//, "")).includes(etag)) {
+            reply.header("etag", etag);
+            return reply.code(304).send();
+        }
+        return sendItem(reply, scope, await presentOne(scope, item));
+    });
+    app.patch("/api/v1/planning/items/:itemId", async (req, reply) => {
+        const body = isRecord(req.body) ? req.body : null;
+        if (!body)
+            throw new ApiError(400, "VALIDATION", "body must be a JSON object");
+        if ("evidence" in body || "target" in body) {
+            throw new ApiError(400, "VALIDATION", "evidence and target cannot be edited. Changing the target is a new item.");
+        }
+        const unknown = Object.keys(body).filter((key) => !EDITABLE.includes(key));
+        if (unknown.length > 0)
+            throw new ApiError(400, "VALIDATION", `cannot edit ${unknown.join(", ")}`);
+        const scope = await deps.scopeFor(req, { agents: "optional" });
+        const changes = {};
+        if ("title" in body)
+            changes.title = requiredText(body, "title", 200);
+        if ("outcome" in body)
+            changes.outcome = requiredText(body, "outcome", 2000);
+        if ("category" in body)
+            changes.category = oneOf(body.category, CATEGORIES, "category");
+        if ("priority" in body)
+            changes.priority = oneOf(body.priority, PRIORITIES, "priority");
+        if ("stage" in body)
+            changes.stage = oneOf(body.stage, STAGES, "stage");
+        if ("assigneeId" in body)
+            changes.assigneeId = checkAssignee(scope.orgId, body.assigneeId);
+        if (Object.keys(changes).length === 0)
+            throw new ApiError(400, "VALIDATION", "nothing to change");
+        return applyChange(req, reply, changes, "required");
+    });
+    app.post("/api/v1/planning/items/:itemId/stage", async (req, reply) => {
+        const body = isRecord(req.body) ? req.body : {};
+        return applyChange(req, reply, { stage: oneOf(body.stage, STAGES, "stage") }, "required");
+    });
+    app.post("/api/v1/planning/items/:itemId/archive", async (req, reply) => applyChange(req, reply, { archived: true }, "optional"));
+    app.post("/api/v1/planning/items/:itemId/reopen", async (req, reply) => applyChange(req, reply, { archived: false, stage: "investigate" }, "optional"));
+    app.get("/api/v1/planning/assignees", async (req) => {
+        const scope = await deps.scopeFor(req, { agents: "none" });
+        storeOrThrow();
+        const options = assigneesFor(scope.orgId);
+        return {
+            configured: options !== null,
+            assignees: [
+                { id: null, name: "Unassigned", kind: "unassigned" },
+                ...(options ?? []).map((item) => ({ id: item.id, name: item.name, kind: item.kind ?? "person" })),
+            ],
+        };
+    });
+}
+//# sourceMappingURL=planning.js.map

package/dist/v1/planning.js.map

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

package/dist/v1/records.d.ts

@@ -0,0 +1,18 @@
+import type { FieldView } from "../catalog.js";
+import { type ResolvedRecord } from "../refs.js";
+import type { CensusSnapshot } from "./census.js";
+export type RefsMode = "expand" | "status";
+export declare function refsModeOf(raw: unknown, fallback: RefsMode): RefsMode;
+/**
+ * Wrap every reference value with a `status`.
+ * `resolved` carries the target; `missing` was looked up and has no current head;
+ * `unresolved` was not looked up (target object type outside the catalog, or past the batch limit).
+ */
+export declare function wrapReferenceStatus(data: unknown, fields: FieldView[], resolved: ReadonlyMap<string, ResolvedRecord>, attempted: ReadonlySet<string>): unknown;
+/** `total`, `totalStatus`, and `pageInfo.complete` for a directory page. */
+export declare function recordsListExtras(objectType: string, nextCursor: string | null, census: CensusSnapshot | null): {
+    total: number | null;
+    totalStatus: "exact" | "unavailable";
+    complete: boolean;
+};
+//# sourceMappingURL=records.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/v1/records.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAsC,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3C,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAIrE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,SAAS,EAAE,EACnB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EAC7C,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,OAAO,CAeT;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,MAAM,EAAE,cAAc,GAAG,IAAI,GAC5B;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,OAAO,GAAG,aAAa,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CASnF"}

package/dist/v1/records.js

@@ -0,0 +1,42 @@
+import { ApiError } from "../errors.js";
+import { referenceKey, rewriteReferenceData } from "../refs.js";
+export function refsModeOf(raw, fallback) {
+    if (raw === undefined || raw === "")
+        return fallback;
+    if (raw === "expand" || raw === "status")
+        return raw;
+    throw new ApiError(400, "VALIDATION", "refs must be expand or status");
+}
+/**
+ * Wrap every reference value with a `status`.
+ * `resolved` carries the target; `missing` was looked up and has no current head;
+ * `unresolved` was not looked up (target object type outside the catalog, or past the batch limit).
+ */
+export function wrapReferenceStatus(data, fields, resolved, attempted) {
+    return rewriteReferenceData(data, fields, (id, objectType) => {
+        const key = referenceKey(objectType, id);
+        const hit = resolved.get(key);
+        if (hit) {
+            return {
+                status: "resolved",
+                recordId: hit.recordId,
+                objectType: hit.objectType,
+                contentType: hit.contentType,
+                data: structuredClone(hit.data),
+            };
+        }
+        return { status: attempted.has(key) ? "missing" : "unresolved", value: id, objectType };
+    });
+}
+/** `total`, `totalStatus`, and `pageInfo.complete` for a directory page. */
+export function recordsListExtras(objectType, nextCursor, census) {
+    const entry = census?.objectTypes.find((item) => item.objectType === objectType);
+    const records = entry?.records;
+    const exact = records && records.status === "exact" ? records.value : null;
+    return {
+        total: exact,
+        totalStatus: exact === null ? "unavailable" : "exact",
+        complete: nextCursor === null,
+    };
+}
+//# sourceMappingURL=records.js.map

package/dist/v1/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/v1/records.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAuB,MAAM,YAAY,CAAC;AAKrF,MAAM,UAAU,UAAU,CAAC,GAAY,EAAE,QAAkB;IACzD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACrD,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,+BAA+B,CAAC,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAa,EACb,MAAmB,EACnB,QAA6C,EAC7C,SAA8B;IAE9B,OAAO,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE;QAC3D,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,EAAE,CAAC;YACR,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;aAChC,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;IAC1F,CAAC,CAAC,CAAC;AACL,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,UAAyB,EACzB,MAA6B;IAE7B,MAAM,KAAK,GAAG,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO;QACrD,QAAQ,EAAE,UAAU,KAAK,IAAI;KAC9B,CAAC;AACJ,CAAC"}