@x12i/memorix-client-api 0.18.0 → 0.19.0

package/dist/v1/relationships.d.ts

@@ -0,0 +1,72 @@
+import type { FastifyInstance } from "fastify";
+import type { ObjectTypeView } from "../catalog.js";
+import { type ClientScope } from "../scope.js";
+import { type Upstream } from "../upstream.js";
+import { type CountView } from "./census.js";
+import type { V1Deps } from "./context.js";
+import type { Gap } from "./gaps.js";
+export type Endpoint = {
+    abstractType: string;
+    path: string;
+    cardinality?: "one" | "many";
+};
+export type DefinitionPair = {
+    fromObjectType: string;
+    toObjectType: string;
+    fromPath?: string;
+    toPath?: string;
+    inView: boolean;
+    links?: CountView;
+};
+export type DefinitionEntry = {
+    id: string;
+    name: string;
+    meaning?: string;
+    directionality?: "directed" | "undirected";
+    from?: Endpoint;
+    to?: Endpoint;
+    cardinalityStatus: "declared" | "partial" | "unspecified";
+    definedByAgentIds: string[];
+    fingerprint: string | null;
+    resolution?: "conflict";
+    alternates?: Array<{
+        definedByAgentId: string;
+        fingerprint: string | null;
+    }>;
+    compilation: {
+        ok: boolean;
+        issues: Array<{
+            code: string;
+            message?: string;
+        }>;
+    };
+    objectTypes: DefinitionPair[];
+    links?: CountView;
+};
+export type DefinitionsResult = {
+    status: "complete" | "partial" | "unavailable";
+    definitions: DefinitionEntry[];
+    gaps: Gap[];
+    fingerprints: Record<string, string>;
+};
+/**
+ * Definitions for the agent set. Compiled definitions come from `GET /api/relationships/definitions`;
+ * `GET /api/metadata/kinds/relationship-definitions` adds back conflicts and definitions whose compile failed.
+ */
+export declare function loadDefinitions(upstream: Upstream, scope: ClientScope, catalog: ObjectTypeView[]): Promise<DefinitionsResult>;
+export type LinkCounts = {
+    observedAt: string;
+    totals: Map<string, CountView>;
+    pairs: Map<string, Array<{
+        fromObjectType: string;
+        toObjectType: string;
+        links: CountView;
+    }>>;
+    error?: string;
+};
+/** One `countOnly` read for every definition id, grouped by object type pair. */
+export declare function loadLinkCounts(upstream: Upstream, scope: ClientScope, definitionIds: string[]): Promise<LinkCounts>;
+/** Attach totals and pair counts to definitions. A compiled pair with no stored link is an exact 0. */
+export declare function withLinkCounts(definitions: DefinitionEntry[], counts: LinkCounts): DefinitionEntry[];
+export declare function registerRelationshipRoutes(app: FastifyInstance, deps: V1Deps): void;
+//# sourceMappingURL=relationships.d.ts.map

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

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

package/dist/v1/relationships.js

@@ -0,0 +1,436 @@
+import { ApiError, UpstreamError } from "../errors.js";
+import { scopeBody } from "../scope.js";
+import { asRecord, upstreamCode } from "../upstream.js";
+import { unavailable } from "./census.js";
+import { boolQuery, csv, fingerprintId, limitOf, queryOf, text } from "./http.js";
+function endpointOf(raw) {
+    const body = asRecord(raw);
+    if (!body || typeof body.abstractType !== "string")
+        return undefined;
+    return {
+        abstractType: body.abstractType,
+        path: typeof body.path === "string" ? body.path : "",
+        ...(body.cardinality === "one" || body.cardinality === "many" ? { cardinality: body.cardinality } : {}),
+    };
+}
+function cardinalityStatus(from, to) {
+    const declared = [from?.cardinality, to?.cardinality].filter(Boolean).length;
+    return declared === 2 ? "declared" : declared === 1 ? "partial" : "unspecified";
+}
+function agentIdsOf(provenance) {
+    const ids = Array.isArray(provenance?.definedByAgentIds)
+        ? provenance.definedByAgentIds.filter((id) => typeof id === "string" && id.length > 0)
+        : [];
+    if (ids.length === 0 && typeof provenance?.definedByAgentId === "string")
+        ids.push(provenance.definedByAgentId);
+    return ids;
+}
+function bodyFields(body, id) {
+    const from = endpointOf(body.from);
+    const to = endpointOf(body.to);
+    const directionality = body.directionality === "directed" || body.directionality === "undirected" ? body.directionality : undefined;
+    return {
+        id,
+        name: typeof body.name === "string" && body.name ? body.name : id,
+        ...(typeof body.meaning === "string" ? { meaning: body.meaning } : {}),
+        ...(directionality ? { directionality } : {}),
+        ...(from ? { from } : {}),
+        ...(to ? { to } : {}),
+        cardinalityStatus: cardinalityStatus(from, to),
+    };
+}
+function inCatalog(catalog, id) {
+    return catalog.some((item) => item.id === id);
+}
+async function optional(upstream, path, scope) {
+    try {
+        return { body: await upstream.get(path, scope) };
+    }
+    catch (err) {
+        if (err instanceof UpstreamError)
+            return { body: null, error: upstreamCode(err) ?? `HTTP_${err.statusCode}` };
+        if (err instanceof ApiError)
+            return { body: null, error: err.code };
+        throw err;
+    }
+}
+/**
+ * Definitions for the agent set. Compiled definitions come from `GET /api/relationships/definitions`;
+ * `GET /api/metadata/kinds/relationship-definitions` adds back conflicts and definitions whose compile failed.
+ */
+export async function loadDefinitions(upstream, scope, catalog) {
+    const [compiled, kinds] = await Promise.all([
+        optional(upstream, "/api/relationships/definitions", scope),
+        optional(upstream, "/api/metadata/kinds/relationship-definitions", scope),
+    ]);
+    const gaps = [];
+    if (compiled.error && kinds.error) {
+        return {
+            status: "unavailable",
+            definitions: [],
+            fingerprints: {},
+            gaps: [
+                {
+                    code: "SECTION_UNAVAILABLE",
+                    category: "unavailable",
+                    section: "relationships",
+                    orgId: scope.orgId,
+                    agentIds: scope.agentIds,
+                    message: `relationship definitions could not be read (${compiled.error})`,
+                    retryable: true,
+                },
+            ],
+        };
+    }
+    const compiledById = new Map();
+    for (const raw of Array.isArray(asRecord(compiled.body)?.definitions) ? asRecord(compiled.body).definitions : []) {
+        const body = asRecord(raw);
+        if (body && typeof body.id === "string")
+            compiledById.set(body.id, body);
+    }
+    const kindItems = (Array.isArray(asRecord(kinds.body)?.items) ? asRecord(kinds.body).items : [])
+        .map((raw) => asRecord(raw))
+        .filter((item) => item !== null && typeof item.id === "string");
+    const ids = new Set([...compiledById.keys(), ...kindItems.map((item) => item.id)]);
+    const definitions = [];
+    const fingerprints = {};
+    for (const id of [...ids].sort((a, b) => a.localeCompare(b))) {
+        const item = kindItems.find((entry) => entry.id === id) ?? null;
+        const provenance = asRecord(item?.provenance);
+        const definedByAgentIds = agentIdsOf(provenance);
+        if (item?.resolution === "conflict") {
+            const alternates = (Array.isArray(item.alternates) ? item.alternates : [])
+                .map((alt) => asRecord(alt))
+                .filter((alt) => alt !== null && typeof alt.definedByAgentId === "string")
+                .map((alt) => ({ definedByAgentId: alt.definedByAgentId, fingerprint: fingerprintId(alt.fingerprint) }));
+            const first = asRecord(asRecord(item.alternates?.[0])?.definition) ?? {};
+            definitions.push({
+                ...bodyFields(first, id),
+                definedByAgentIds: definedByAgentIds.length > 0 ? definedByAgentIds : alternates.map((alt) => alt.definedByAgentId),
+                fingerprint: null,
+                resolution: "conflict",
+                alternates,
+                compilation: { ok: false, issues: [{ code: "RESOLUTION_CONFLICT", message: "selected agents define this relationship differently" }] },
+                objectTypes: [],
+            });
+            gaps.push({
+                code: "RESOLUTION_CONFLICT",
+                category: "resolution-failure",
+                orgId: scope.orgId,
+                agentIds: alternates.map((alt) => alt.definedByAgentId),
+                definitionId: id,
+                message: `agents define relationship ${id} differently`,
+                retryable: false,
+            });
+            continue;
+        }
+        const fingerprint = fingerprintId(provenance?.fingerprint);
+        if (fingerprint)
+            fingerprints[`relationship-definitions:${id}`] = fingerprint;
+        const compiledBody = compiledById.get(id);
+        const body = compiledBody ?? asRecord(item?.definition) ?? {};
+        const pairs = (Array.isArray(compiledBody?.objectTypes) ? compiledBody.objectTypes : [])
+            .map((raw) => asRecord(raw))
+            .filter((pair) => pair !== null && typeof pair.fromObjectType === "string" && typeof pair.toObjectType === "string")
+            .map((pair) => ({
+            fromObjectType: pair.fromObjectType,
+            toObjectType: pair.toObjectType,
+            ...(typeof pair.fromPath === "string" ? { fromPath: pair.fromPath } : {}),
+            ...(typeof pair.toPath === "string" ? { toPath: pair.toPath } : {}),
+            inView: inCatalog(catalog, pair.fromObjectType) && inCatalog(catalog, pair.toObjectType),
+        }));
+        const compiledOk = Boolean(compiledBody);
+        const issues = compiledOk
+            ? pairs.length === 0
+                ? [{ code: "NO_CONCRETE_ENDPOINTS", message: "no object type implements both endpoints" }]
+                : []
+            : [{ code: "COMPILE_FAILED", message: "Memorix did not compile this definition" }];
+        definitions.push({
+            ...bodyFields(body, id),
+            definedByAgentIds,
+            fingerprint,
+            compilation: { ok: compiledOk && pairs.length > 0, issues },
+            objectTypes: pairs,
+        });
+        if (issues.length > 0) {
+            gaps.push({
+                code: issues[0].code,
+                category: "unavailable",
+                orgId: scope.orgId,
+                agentIds: definedByAgentIds,
+                definitionId: id,
+                message: issues[0].message,
+                retryable: false,
+            });
+        }
+    }
+    if (compiled.error || kinds.error) {
+        gaps.push({
+            code: "SECTION_UNAVAILABLE",
+            category: "unavailable",
+            section: "relationships",
+            orgId: scope.orgId,
+            agentIds: scope.agentIds,
+            message: `relationship definitions were read only in part (${compiled.error ?? kinds.error})`,
+            retryable: true,
+        });
+    }
+    const partial = (scope.unresolvedAgentIds?.length ?? 0) > 0 || Boolean(compiled.error || kinds.error);
+    return { status: partial ? "partial" : "complete", definitions, gaps, fingerprints };
+}
+/** One `countOnly` read for every definition id, grouped by object type pair. */
+export async function loadLinkCounts(upstream, scope, definitionIds) {
+    const observedAt = new Date().toISOString();
+    const totals = new Map();
+    const pairs = new Map();
+    if (definitionIds.length === 0)
+        return { observedAt, totals, pairs };
+    const params = new URLSearchParams({
+        direction: "by-definition",
+        definitionIds: definitionIds.join(","),
+        countOnly: "true",
+        groupBy: "objectType",
+    });
+    let body;
+    try {
+        body = asRecord(await upstream.get(`/api/relationships/query?${params.toString()}`, scope));
+    }
+    catch (err) {
+        const reason = err instanceof UpstreamError ? (upstreamCode(err) ?? `HTTP_${err.statusCode}`) : err instanceof ApiError ? err.code : "COUNT_FAILED";
+        for (const id of definitionIds) {
+            totals.set(id, unavailable(reason, true, { method: "count-by-definition", aggregated: true, observedAt }));
+        }
+        return { observedAt, totals, pairs, error: reason };
+    }
+    const counts = asRecord(body?.counts) ?? {};
+    const groups = asRecord(body?.groups) ?? {};
+    for (const id of definitionIds) {
+        const value = counts[id];
+        totals.set(id, typeof value === "number"
+            ? {
+                status: "exact",
+                value,
+                aggregated: true,
+                deletedExcluded: true,
+                versionSemantics: "stored-links",
+                method: "count-by-definition",
+                observedAt,
+            }
+            : unavailable("NOT_REPORTED", false, { method: "count-by-definition", aggregated: true, observedAt }));
+        const grouped = Array.isArray(groups[id]) ? groups[id] : [];
+        pairs.set(id, grouped
+            .map((raw) => asRecord(raw))
+            .filter((g) => g !== null && typeof g.fromObjectType === "string" && typeof g.toObjectType === "string")
+            .map((g) => ({
+            fromObjectType: g.fromObjectType,
+            toObjectType: g.toObjectType,
+            links: typeof g.count === "number"
+                ? {
+                    status: "exact",
+                    value: g.count,
+                    aggregated: false,
+                    deletedExcluded: true,
+                    versionSemantics: "stored-links",
+                    method: "count-by-object-type",
+                    observedAt,
+                }
+                : unavailable("NOT_REPORTED", false, { method: "count-by-object-type", aggregated: false, observedAt }),
+        })));
+    }
+    return { observedAt, totals, pairs };
+}
+/** Attach totals and pair counts to definitions. A compiled pair with no stored link is an exact 0. */
+export function withLinkCounts(definitions, counts) {
+    return definitions.map((definition) => {
+        const total = counts.totals.get(definition.id);
+        const grouped = counts.pairs.get(definition.id) ?? [];
+        return {
+            ...definition,
+            ...(total ? { links: total } : {}),
+            objectTypes: definition.objectTypes.map((pair) => {
+                const hit = grouped.find((g) => g.fromObjectType === pair.fromObjectType && g.toObjectType === pair.toObjectType);
+                const links = hit
+                    ? hit.links
+                    : total?.status === "exact"
+                        ? {
+                            status: "exact",
+                            value: 0,
+                            aggregated: false,
+                            deletedExcluded: true,
+                            versionSemantics: "stored-links",
+                            method: "count-by-object-type",
+                            observedAt: counts.observedAt,
+                        }
+                        : unavailable(total?.status === "unavailable" ? total.reason : "NOT_COUNTED", true, {
+                            method: "count-by-object-type",
+                            aggregated: false,
+                        });
+                return { ...pair, links };
+            }),
+        };
+    });
+}
+function encodeCursor(cursor) {
+    return Buffer.from(JSON.stringify(cursor), "utf8").toString("base64url");
+}
+function decodeCursor(raw, direction) {
+    const first = { d: direction === "inverse" ? "inverse" : "forward", c: null };
+    if (!raw)
+        return first;
+    try {
+        const parsed = JSON.parse(Buffer.from(raw, "base64url").toString("utf8"));
+        if ((parsed.d === "forward" || parsed.d === "inverse") && (parsed.c === null || typeof parsed.c === "string")) {
+            if (direction !== "both" && parsed.d !== direction)
+                throw new Error("direction");
+            return parsed;
+        }
+    }
+    catch {
+        // fall through
+    }
+    throw new ApiError(400, "VALIDATION", "cursor does not belong to this query");
+}
+function linkOf(raw, traversal, catalog) {
+    const from = asRecord(raw.from);
+    const to = asRecord(raw.to);
+    const fromObjectType = typeof from?.objectType === "string" ? from.objectType : undefined;
+    const toObjectType = typeof to?.objectType === "string" ? to.objectType : undefined;
+    const targetEnd = traversal === "forward" ? to : from;
+    const targetRecordId = typeof raw.relatedRecordId === "string"
+        ? raw.relatedRecordId
+        : traversal === "forward"
+            ? String(raw.toRecordId ?? "")
+            : String(raw.fromRecordId ?? "");
+    const targetObjectType = typeof targetEnd?.objectType === "string" ? targetEnd.objectType : undefined;
+    const targetStatus = raw.targetStatus === "resolved" || targetEnd?.status === "resolved" ? "resolved" : "missing";
+    return {
+        relationshipId: typeof raw.relationshipId === "string" ? raw.relationshipId : "",
+        definitionId: typeof raw.relationshipDefinitionId === "string" ? raw.relationshipDefinitionId : "",
+        fromRecordId: typeof raw.fromRecordId === "string" ? raw.fromRecordId : "",
+        toRecordId: typeof raw.toRecordId === "string" ? raw.toRecordId : "",
+        ...(fromObjectType ? { fromObjectType } : {}),
+        ...(toObjectType ? { toObjectType } : {}),
+        direction: traversal,
+        target: {
+            status: targetStatus,
+            recordId: targetRecordId,
+            ...(targetObjectType ? { objectType: targetObjectType } : {}),
+            ...(typeof targetEnd?.label === "string" ? { label: targetEnd.label } : {}),
+            inView: targetObjectType ? catalog.some((item) => item.id === targetObjectType) : false,
+        },
+        evidence: null,
+        evidenceStatus: "unspecified",
+    };
+}
+export function registerRelationshipRoutes(app, deps) {
+    app.get("/api/v1/relationships/definitions", async (req) => {
+        const scope = await deps.scopeFor(req);
+        const catalog = await deps.loadCatalog(deps.upstream, scope);
+        const result = await loadDefinitions(deps.upstream, scope, catalog);
+        const counts = await loadLinkCounts(deps.upstream, scope, result.definitions.map((definition) => definition.id));
+        const gaps = [...result.gaps];
+        if (counts.error) {
+            gaps.push({
+                code: "COUNT_UNAVAILABLE",
+                category: "unavailable",
+                section: "counts",
+                orgId: scope.orgId,
+                agentIds: scope.agentIds,
+                message: `link counts could not be read (${counts.error})`,
+                retryable: true,
+            });
+        }
+        const allFailed = (scope.unresolvedAgentIds?.length ?? 0) > 0 && scope.unresolvedAgentIds.length === scope.agentIds.length;
+        if (allFailed) {
+            gaps.push({
+                code: "RESOLUTION_FAILED",
+                category: "resolution-failure",
+                orgId: scope.orgId,
+                agentIds: scope.unresolvedAgentIds,
+                message: "no selected agent resolved",
+                retryable: false,
+            });
+        }
+        return {
+            scope: scopeBody(scope),
+            status: allFailed ? "unavailable" : result.status,
+            definitions: allFailed ? [] : withLinkCounts(result.definitions, counts),
+            gaps,
+        };
+    });
+    app.get("/api/v1/relationships", async (req) => {
+        const scope = await deps.scopeFor(req);
+        const query = queryOf(req);
+        const definitionIds = csv(query.definitionId);
+        if (boolQuery(query.countOnly, "countOnly")) {
+            if (!definitionIds)
+                throw new ApiError(400, "VALIDATION", "countOnly requires definitionId");
+            const counts = await loadLinkCounts(deps.upstream, scope, definitionIds);
+            const grouped = text(query.groupBy);
+            if (grouped && grouped !== "objectType")
+                throw new ApiError(400, "VALIDATION", "groupBy must be objectType");
+            return {
+                scope: scopeBody(scope),
+                observedAt: counts.observedAt,
+                relationships: definitionIds.map((id) => ({
+                    definitionId: id,
+                    links: counts.totals.get(id),
+                    ...(grouped ? { pairs: counts.pairs.get(id) ?? [] } : {}),
+                })),
+            };
+        }
+        const recordId = text(query.recordId);
+        if (!recordId)
+            throw new ApiError(400, "VALIDATION", "recordId is required unless countOnly=true");
+        const direction = text(query.direction) ?? "both";
+        if (direction !== "forward" && direction !== "inverse" && direction !== "both") {
+            throw new ApiError(400, "VALIDATION", "direction must be forward, inverse, or both");
+        }
+        const limit = limitOf(query.limit);
+        const otherObjectType = text(query.objectType);
+        let cursor = decodeCursor(text(query.cursor), direction);
+        const catalog = await deps.loadCatalog(deps.upstream, scope);
+        const links = [];
+        let next = null;
+        while (cursor && links.length < limit) {
+            const params = new URLSearchParams({
+                recordId,
+                direction: cursor.d,
+                limit: String(limit - links.length),
+                expandEndpointLabels: "true",
+            });
+            if (definitionIds)
+                params.set("definitionId", definitionIds.join(","));
+            if (cursor.c)
+                params.set("cursor", cursor.c);
+            const body = asRecord(await deps.upstream.get(`/api/relationships/query?${params.toString()}`, scope));
+            const phase = cursor.d;
+            for (const raw of Array.isArray(body?.links) ? body.links : []) {
+                const row = asRecord(raw);
+                if (!row)
+                    continue;
+                const link = linkOf(row, phase, catalog);
+                if (!otherObjectType || link.target.objectType === otherObjectType)
+                    links.push(link);
+            }
+            const upstreamNext = asRecord(body?.pageInfo)?.nextCursor;
+            if (typeof upstreamNext === "string" && upstreamNext) {
+                next = { d: phase, c: upstreamNext };
+                break;
+            }
+            next = null;
+            cursor = direction === "both" && phase === "forward" ? { d: "inverse", c: null } : null;
+            if (cursor && links.length >= limit)
+                next = cursor;
+        }
+        return {
+            scope: scopeBody(scope),
+            recordId,
+            direction,
+            pageInfo: { complete: next === null, ...(next ? { nextCursor: encodeCursor(next) } : {}), limit },
+            truncated: false,
+            links,
+        };
+    });
+}
+//# sourceMappingURL=relationships.js.map

package/dist/v1/relationships.js.map

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

package/dist/v1/routes.d.ts

@@ -0,0 +1,5 @@
+import type { FastifyInstance } from "fastify";
+import type { V1Deps } from "./context.js";
+/** Routes of the `visualizer` contract (`docs/visualizer-api.md`). */
+export declare function registerV1Routes(app: FastifyInstance, deps: V1Deps): void;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/v1/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAO3C,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAOzE"}

package/dist/v1/routes.js

@@ -0,0 +1,16 @@
+import { registerContentRoutes } from "./content.js";
+import { registerDiscoveryRoutes } from "./discovery.js";
+import { registerMappingRoutes } from "./mapping.js";
+import { registerPlanningRoutes } from "./planning.js";
+import { registerRelationshipRoutes } from "./relationships.js";
+import { registerSourceRoutes } from "./sources.js";
+/** Routes of the `visualizer` contract (`docs/visualizer-api.md`). */
+export function registerV1Routes(app, deps) {
+    registerDiscoveryRoutes(app, deps);
+    registerMappingRoutes(app, deps);
+    registerContentRoutes(app, deps);
+    registerRelationshipRoutes(app, deps);
+    registerSourceRoutes(app, deps);
+    registerPlanningRoutes(app, deps);
+}
+//# sourceMappingURL=routes.js.map

package/dist/v1/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/v1/routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,GAAoB,EAAE,IAAY;IACjE,uBAAuB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjC,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjC,0BAA0B,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChC,sBAAsB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/v1/sources.d.ts

@@ -0,0 +1,62 @@
+import type { FastifyInstance } from "fastify";
+import type { ObjectTypeView } from "../catalog.js";
+import { type ClientScope } from "../scope.js";
+import { type Upstream } from "../upstream.js";
+import type { V1Deps } from "./context.js";
+import type { Gap } from "./gaps.js";
+type CensusStatus = "live" | "backfilling" | "disabled" | "error" | "unavailable";
+export type Contribution = {
+    objectType: string;
+    contentType: string | null;
+    contentTypeStatus?: "unspecified";
+    measure: "heads" | "subjects";
+    count: {
+        status: "exact";
+        value: number;
+        observedAt: string;
+        method: "source-census";
+    };
+};
+export type SourceEntry = {
+    id: string;
+    name: string;
+    kind?: string;
+    kindStatus?: "unspecified";
+    registry: "pack" | "org" | "census";
+    definedByAgentIds: string[];
+    operationalState: string;
+    lastSuccessAt?: string;
+    lastSuccessStatus: "declared" | "unspecified";
+    contributions: Contribution[];
+    contributionStatus?: "none" | "unavailable";
+};
+export type SourcesDocument = {
+    status: "complete" | "partial" | "unavailable";
+    census: {
+        status: CensusStatus;
+        observedAt: string | null;
+        censusId: string | null;
+    };
+    sources: SourceEntry[];
+    attribution: {
+        multipleSourcesPerRow: true;
+        sumsAreDisjoint: false;
+        noSource: string;
+    };
+    gaps: Gap[];
+};
+export type RunSummary = {
+    id: string;
+    status: string;
+    startedAt?: string;
+    finishedAt?: string;
+};
+export declare function runsOf(body: Record<string, unknown> | null): RunSummary[];
+export declare function loadSources(upstream: Upstream, scope: ClientScope, catalog: ObjectTypeView[], options?: {
+    runs?: boolean;
+}): Promise<SourcesDocument & {
+    runsById: Map<string, RunSummary[]>;
+}>;
+export declare function registerSourceRoutes(app: FastifyInstance, deps: V1Deps): void;
+export {};
+//# sourceMappingURL=sources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/v1/sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,KAAK,YAAY,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,aAAa,CAAC;AAElF,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC;IAC9B,KAAK,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC;CACxF,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IACpC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,UAAU,GAAG,aAAa,CAAC;IAC9C,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;IAC/C,MAAM,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACrF,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,WAAW,EAAE;QAAE,qBAAqB,EAAE,IAAI,CAAC;QAAC,eAAe,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACvF,IAAI,EAAE,GAAG,EAAE,CAAC;CACb,CAAC;AAqBF,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,UAAU,EAAE,CAezE;AA0DD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/B,OAAO,CAAC,eAAe,GAAG;IAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;CAAE,CAAC,CAkGpE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA4B7E"}