@x12i/memorix-retrieval 1.1.0 → 1.4.0

package/dist/descriptors/discover-entities.js

@@ -0,0 +1,94 @@
+import { throwRetrievalError } from "../errors/errors.js";
+import { MEMORIX_ENTITY_DESCRIPTORS_CATALOG, } from "./catalog-ids.js";
+import { parseDescriptorData, validateMemorixEntityDescriptor, } from "./validate-descriptor.js";
+function entityLabel(entityName, title) {
+    if (title?.trim())
+        return title.trim();
+    if (!entityName)
+        return entityName;
+    return entityName[0].toUpperCase() + entityName.slice(1).replace(/-/g, " ");
+}
+async function listAllCatalogItems(client, catalogId) {
+    const listFn = client.catalox.listCatalogItems;
+    if (!listFn) {
+        throwRetrievalError("CATALOX_LIST_UNSUPPORTED", "Catalox client must support listCatalogItems (use createCataloxAdapterFromBound)");
+    }
+    const out = [];
+    let offset = 0;
+    const pageSize = 200;
+    for (;;) {
+        const page = await listFn({ appId: client.appId }, catalogId, {
+            limit: pageSize,
+            offset,
+        });
+        out.push(...page.items);
+        if (!page.hasMore || page.items.length === 0)
+            break;
+        offset += page.items.length;
+        if (offset > 10_000)
+            break;
+    }
+    return out;
+}
+export async function discoverMemorixEntities(client) {
+    const catalogId = MEMORIX_ENTITY_DESCRIPTORS_CATALOG;
+    try {
+        const items = await listAllCatalogItems(client, catalogId);
+        const summaries = [];
+        for (const item of items) {
+            const data = parseDescriptorData(item.data);
+            const entity = validateMemorixEntityDescriptor(data);
+            summaries.push({
+                id: item.id,
+                entityName: entity.entityName,
+                label: entityLabel(entity.entityName, item.title),
+                defaultListDescriptorId: entity.defaultListDescriptorId,
+                defaultItemDescriptorId: entity.defaultItemDescriptorId,
+                target: entity.target,
+            });
+        }
+        if (summaries.length === 0) {
+            return {
+                source: "none",
+                catalogId,
+                summaries: [],
+                hint: `No entity descriptors in Catalox catalog "${catalogId}" for app ${client.appId}. Run memorix-retrieval catalox seed apply.`,
+            };
+        }
+        return { source: "catalox", catalogId, summaries };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            source: "none",
+            catalogId,
+            summaries: [],
+            hint: `Catalox entity discovery failed: ${msg}`,
+        };
+    }
+}
+export async function loadMemorixEntityDescriptorByName(client, entityName) {
+    const discovery = await discoverMemorixEntities(client);
+    const match = discovery.summaries.find((s) => s.entityName === entityName) ??
+        discovery.summaries.find((s) => s.id === entityName);
+    if (!match) {
+        throwRetrievalError("UNKNOWN_ENTITY_DESCRIPTOR", `No entity descriptor for "${entityName}"`);
+    }
+    const { loadMemorixEntityDescriptor } = await import("./load-entity-descriptor.js");
+    return loadMemorixEntityDescriptor(client, match.id);
+}
+export function entityDescriptorConnections(entity) {
+    const connections = [];
+    for (const [relationKey, rel] of Object.entries(entity.relations ?? {})) {
+        connections.push({
+            id: `${entity.entityName}-${relationKey}`,
+            targetEntityName: rel.targetEntity,
+            relationType: rel.type,
+            sourceProperty: rel.source.path,
+            targetProperty: rel.target.path,
+        });
+    }
+    return connections;
+}
+export { validateMemorixEntityDescriptor };
+//# sourceMappingURL=discover-entities.js.map

package/dist/descriptors/discover-entities.js.map

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

package/dist/descriptors/resolve-app-id.d.ts

@@ -0,0 +1,4 @@
+export declare function resolveMemorixAppId(options?: {
+    appId?: string;
+}, processEnv?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=resolve-app-id.d.ts.map

package/dist/descriptors/resolve-app-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-app-id.d.ts","sourceRoot":"","sources":["../../src/descriptors/resolve-app-id.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5B,UAAU,GAAE,MAAM,CAAC,UAAwB,GAC1C,MAAM,CAOR"}

package/dist/descriptors/resolve-app-id.js

@@ -0,0 +1,8 @@
+import { MEMORIX_APP_ID } from "./catalog-ids.js";
+export function resolveMemorixAppId(options, processEnv = process.env) {
+    return (options?.appId?.trim() ||
+        processEnv.CATALOX_APP_ID?.trim() ||
+        processEnv.MEMORIX_APP_ID?.trim() ||
+        MEMORIX_APP_ID);
+}
+//# sourceMappingURL=resolve-app-id.js.map

package/dist/descriptors/resolve-app-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-app-id.js","sourceRoot":"","sources":["../../src/descriptors/resolve-app-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,UAAU,mBAAmB,CACjC,OAA4B,EAC5B,aAAgC,OAAO,CAAC,GAAG;IAE3C,OAAO,CACL,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE;QACtB,UAAU,CAAC,cAAc,EAAE,IAAI,EAAE;QACjC,UAAU,CAAC,cAAc,EAAE,IAAI,EAAE;QACjC,cAAc,CACf,CAAC;AACJ,CAAC"}

package/dist/descriptors/resolve-default-descriptors.d.ts

@@ -0,0 +1,11 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { MemorixEntityDescriptor, MemorixItemDescriptor, MemorixListDescriptor } from "./descriptor-types.js";
+export declare function resolveDefaultListDescriptorForEntity(client: MemorixRetrievalClient, entityName: string): Promise<{
+    entity: MemorixEntityDescriptor;
+    list: MemorixListDescriptor;
+}>;
+export declare function resolveDefaultItemDescriptorForEntity(client: MemorixRetrievalClient, entityName: string): Promise<{
+    entity: MemorixEntityDescriptor;
+    item: MemorixItemDescriptor;
+}>;
+//# sourceMappingURL=resolve-default-descriptors.d.ts.map

package/dist/descriptors/resolve-default-descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-default-descriptors.d.ts","sourceRoot":"","sources":["../../src/descriptors/resolve-default-descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAmB/B,wBAAsB,qCAAqC,CACzD,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IACT,MAAM,EAAE,uBAAuB,CAAC;IAChC,IAAI,EAAE,qBAAqB,CAAC;CAC7B,CAAC,CAaD;AAED,wBAAsB,qCAAqC,CACzD,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IACT,MAAM,EAAE,uBAAuB,CAAC;IAChC,IAAI,EAAE,qBAAqB,CAAC;CAC7B,CAAC,CAaD"}

package/dist/descriptors/resolve-default-descriptors.js

@@ -0,0 +1,22 @@
+import { throwRetrievalError } from "../errors/errors.js";
+import { loadMemorixEntityDescriptorByName } from "./discover-entities.js";
+import { loadMemorixItemDescriptor } from "./load-item-descriptor.js";
+import { loadMemorixListDescriptor } from "./load-list-descriptor.js";
+function assertDescriptorEntityMatch(entity, descriptorEntity, descriptorKind, descriptorId) {
+    if (descriptorEntity !== entity.id) {
+        throwRetrievalError("INVALID_DESCRIPTOR", `${descriptorKind} descriptor "${descriptorId}" entity "${descriptorEntity}" does not match entity descriptor id "${entity.id}"`);
+    }
+}
+export async function resolveDefaultListDescriptorForEntity(client, entityName) {
+    const entity = await loadMemorixEntityDescriptorByName(client, entityName);
+    const list = await loadMemorixListDescriptor(client, entity.defaultListDescriptorId);
+    assertDescriptorEntityMatch(entity, list.entity, "list", entity.defaultListDescriptorId);
+    return { entity, list };
+}
+export async function resolveDefaultItemDescriptorForEntity(client, entityName) {
+    const entity = await loadMemorixEntityDescriptorByName(client, entityName);
+    const item = await loadMemorixItemDescriptor(client, entity.defaultItemDescriptorId);
+    assertDescriptorEntityMatch(entity, item.entity, "item", entity.defaultItemDescriptorId);
+    return { entity, item };
+}
+//# sourceMappingURL=resolve-default-descriptors.js.map

package/dist/descriptors/resolve-default-descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-default-descriptors.js","sourceRoot":"","sources":["../../src/descriptors/resolve-default-descriptors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAM1D,OAAO,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,SAAS,2BAA2B,CAClC,MAA+B,EAC/B,gBAAwB,EACxB,cAA+B,EAC/B,YAAoB;IAEpB,IAAI,gBAAgB,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;QACnC,mBAAmB,CACjB,oBAAoB,EACpB,GAAG,cAAc,gBAAgB,YAAY,aAAa,gBAAgB,0CAA0C,MAAM,CAAC,EAAE,GAAG,CACjI,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,MAA8B,EAC9B,UAAkB;IAKlB,MAAM,MAAM,GAAG,MAAM,iCAAiC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,MAAM,yBAAyB,CAC1C,MAAM,EACN,MAAM,CAAC,uBAAuB,CAC/B,CAAC;IACF,2BAA2B,CACzB,MAAM,EACN,IAAI,CAAC,MAAM,EACX,MAAM,EACN,MAAM,CAAC,uBAAuB,CAC/B,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,MAA8B,EAC9B,UAAkB;IAKlB,MAAM,MAAM,GAAG,MAAM,iCAAiC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,MAAM,yBAAyB,CAC1C,MAAM,EACN,MAAM,CAAC,uBAAuB,CAC/B,CAAC;IACF,2BAA2B,CACzB,MAAM,EACN,IAAI,CAAC,MAAM,EACX,MAAM,EACN,MAAM,CAAC,uBAAuB,CAC/B,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/descriptors/validate-descriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-descriptor.d.ts","sourceRoot":"","sources":["../../src/descriptors/validate-descriptor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EAEtB,MAAM,uBAAuB,CAAC;AAS/B,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,uBAAuB,CAoCzB;AAmBD,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,qBAAqB,CAkBvB;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,qBAAqB,CAkBvB;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,uBAAuB,GAC9B,IAAI,CAgBN;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE1E"}
+{"version":3,"file":"validate-descriptor.d.ts","sourceRoot":"","sources":["../../src/descriptors/validate-descriptor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EAEtB,MAAM,uBAAuB,CAAC;AAS/B,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,uBAAuB,CA0DzB;AAmBD,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,qBAAqB,CAkBvB;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,qBAAqB,CAkBvB;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,uBAAuB,GAC9B,IAAI,CAgBN;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE1E"}

package/dist/descriptors/validate-descriptor.js

@@ -10,6 +10,9 @@ export function validateMemorixEntityDescriptor(raw) {
     if (!d.id || !d.entityName || !d.collectionPrefix) {
         throwRetrievalError("INVALID_DESCRIPTOR", "Entity descriptor requires id, entityName, collectionPrefix");
     }
+    if (!d.defaultListDescriptorId?.trim() || !d.defaultItemDescriptorId?.trim()) {
+        throwRetrievalError("INVALID_DESCRIPTOR", "Entity descriptor requires defaultListDescriptorId and defaultItemDescriptorId");
+    }
     if (d.target && d.target !== "entity" && d.target !== "event") {
         throwRetrievalError("INVALID_DESCRIPTOR", 'Entity descriptor target must be "entity" or "event"');
     }
@@ -25,6 +28,14 @@ export function validateMemorixEntityDescriptor(raw) {
     for (const prop of Object.values(d.properties)) {
         validatePropertyDescriptor(prop);
     }
+    const canonicalTypes = Object.entries(d.contentTypes).filter(([, ct]) => ct.isCanonical);
+    if (canonicalTypes.length !== 1) {
+        throwRetrievalError("INVALID_DESCRIPTOR", "Entity descriptor requires exactly one content type with isCanonical: true");
+    }
+    const [canonicalName] = canonicalTypes[0];
+    if (canonicalName !== d.defaults.canonicalContentType) {
+        throwRetrievalError("INVALID_DESCRIPTOR", "defaults.canonicalContentType must match the isCanonical content type key");
+    }
     return d;
 }
 function validatePropertyDescriptor(prop) {

package/dist/descriptors/validate-descriptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-descriptor.js","sourceRoot":"","sources":["../../src/descriptors/validate-descriptor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate-descriptor.js","sourceRoot":"","sources":["../../src/descriptors/validate-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAQ1D,SAAS,YAAY,CAAC,KAAc,EAAE,KAAa;IACjD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,mBAAmB,CAAC,oBAAoB,EAAE,GAAG,KAAK,oBAAoB,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,GAA4B;IAE5B,MAAM,CAAC,GAAG,GAAyC,CAAC;IACpD,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAClD,mBAAmB,CACjB,oBAAoB,EACpB,6DAA6D,CAC9D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,uBAAuB,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,uBAAuB,EAAE,IAAI,EAAE,EAAE,CAAC;QAC7E,mBAAmB,CACjB,oBAAoB,EACpB,gFAAgF,CACjF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9D,mBAAmB,CACjB,oBAAoB,EACpB,sDAAsD,CACvD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,oBAAoB,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAC/D,mBAAmB,CACjB,oBAAoB,EACpB,uEAAuE,CACxE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC1D,mBAAmB,CACjB,oBAAoB,EACpB,yCAAyC,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QACtD,mBAAmB,CACjB,oBAAoB,EACpB,uCAAuC,CACxC,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/C,0BAA0B,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAC1D,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,CAC3B,CAAC;IACF,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,mBAAmB,CACjB,oBAAoB,EACpB,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,aAAa,CAAC,GAAG,cAAc,CAAC,CAAC,CAAE,CAAC;IAC3C,IAAI,aAAa,KAAK,CAAC,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;QACtD,mBAAmB,CACjB,oBAAoB,EACpB,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,0BAA0B,CAAC,IAA+B;IACjE,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QACnE,mBAAmB,CACjB,oBAAoB,EACpB,+CAA+C,CAChD,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,KAAK,KAAK,EAAE,CAAC;YACtD,mBAAmB,CACjB,oBAAoB,EACpB,iDAAiD,CAClD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,GAA4B;IAE5B,MAAM,CAAC,GAAG,GAAuC,CAAC;IAClD,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;QAChD,mBAAmB,CACjB,oBAAoB,EACpB,yDAAyD,CAC1D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,YAAY,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;QAC3D,mBAAmB,CACjB,oBAAoB,EACpB,4CAA4C,CAC7C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,mBAAmB,CAAC,oBAAoB,EAAE,iCAAiC,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,GAA4B;IAE5B,MAAM,CAAC,GAAG,GAAuC,CAAC;IAClD,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC/C,mBAAmB,CACjB,oBAAoB,EACpB,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,mBAAmB,CACjB,oBAAoB,EACpB,uCAAuC,CACxC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,mBAAmB,CAAC,oBAAoB,EAAE,mCAAmC,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,IAA2B,EAC3B,MAA+B;IAE/B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,mBAAmB,CACjB,eAAe,EACf,eAAe,KAAK,+BAA+B,MAAM,CAAC,EAAE,GAAG,CAChE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,mBAAmB,CACjB,+BAA+B,EAC/B,eAAe,KAAK,gCAAgC,CACrD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,OAAO,YAAY,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;AAC/C,CAAC"}

package/dist/explorer/entity-graph.d.ts

@@ -0,0 +1,61 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+export type MemorixEntityGraphConnection = {
+    id: string;
+    targetEntityName: string;
+    relationType: string;
+    sourceProperty: string;
+    targetProperty: string;
+};
+export type MemorixEntityGraphEntity = {
+    entityName: string;
+    label: string;
+    defaultListDescriptorId: string;
+    defaultItemDescriptorId: string;
+    count: number;
+    narratives: Array<{
+        id: string;
+        title: string;
+    }>;
+    connections: MemorixEntityGraphConnection[];
+    connectedEntityTypes: number;
+    contentTypesWithData: number;
+    drillable: boolean;
+    countErrors?: {
+        scoped?: string;
+        narratives?: string;
+        contentTypes?: string;
+    };
+};
+export type MemorixEntityGraphDiscovery = {
+    source: "catalox" | "none";
+    memorixDb: string;
+    scopedNamespace: string | null;
+    entitiesCatalogId: string;
+    cataloxAppId: string;
+    cataloxClient: boolean;
+    hint?: string;
+};
+export type MemorixEntityGraphResult = {
+    memorixDb: string;
+    entities: MemorixEntityGraphEntity[];
+    discovery: MemorixEntityGraphDiscovery;
+};
+export type BuildMemorixEntityGraphOptions = {
+    scopedNamespace?: string | null;
+};
+export declare function buildMemorixEntityGraph(client: MemorixRetrievalClient, options?: BuildMemorixEntityGraphOptions): Promise<MemorixEntityGraphResult>;
+export type MemorixEntitySlicesResult = {
+    entityName: string;
+    slices: Array<{
+        contentType: string;
+        label: string;
+        count: number;
+        step: number;
+    }>;
+    sliceCountFailures?: Array<{
+        contentType: string;
+        error: string;
+    }>;
+};
+export declare function buildMemorixEntitySlices(client: MemorixRetrievalClient, entityName: string): Promise<MemorixEntitySlicesResult>;
+//# sourceMappingURL=entity-graph.d.ts.map

package/dist/explorer/entity-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-graph.d.ts","sourceRoot":"","sources":["../../src/explorer/entity-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAcjE,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,WAAW,EAAE,4BAA4B,EAAE,CAAC;IAC5C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,SAAS,EAAE,2BAA2B,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAoBF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,wBAAwB,CAAC,CAmHnC;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE,CAAC;AAEF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,CAAC,CA+BpC"}

package/dist/explorer/entity-graph.js

@@ -0,0 +1,155 @@
+import { discoverMemorixEntities, entityDescriptorConnections, loadMemorixEntityDescriptorByName, } from "../descriptors/discover-entities.js";
+import { listEntityContentTypeKeys, memorixContentTypeLabel, primaryEntityContentType, } from "../descriptors/content-type-labels.js";
+import { resolveMemorixDbNameForEntity } from "../mongo/resolve-db.js";
+import { countMemorixEntityContentTypeDocuments } from "./raw-reads.js";
+function resolveScopedNamespace(client, override) {
+    if (override !== undefined)
+        return override;
+    const env = client.processEnv;
+    return (env.MEMORIX_SCOPED_NAMESPACE?.trim() ||
+        env.TARGET_NAMESPACE?.trim() ||
+        env.XMEMORY_NAMESPACE?.trim() ||
+        null);
+}
+function errMsg(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export async function buildMemorixEntityGraph(client, options = {}) {
+    const discoveryResult = await discoverMemorixEntities(client);
+    const scopedNamespace = resolveScopedNamespace(client, options.scopedNamespace);
+    const cataloxClient = Boolean(client.catalox.listCatalogItems);
+    const discovery = {
+        source: discoveryResult.source,
+        memorixDb: "",
+        scopedNamespace,
+        entitiesCatalogId: discoveryResult.catalogId,
+        cataloxAppId: client.appId,
+        cataloxClient,
+        hint: discoveryResult.hint,
+    };
+    const entities = [];
+    let memorixDb = "";
+    for (const summary of discoveryResult.summaries) {
+        let entity;
+        try {
+            entity = await loadMemorixEntityDescriptorByName(client, summary.entityName);
+        }
+        catch (e) {
+            entities.push({
+                entityName: summary.entityName,
+                label: summary.label,
+                defaultListDescriptorId: summary.defaultListDescriptorId,
+                defaultItemDescriptorId: summary.defaultItemDescriptorId,
+                count: 0,
+                narratives: [],
+                connections: [],
+                connectedEntityTypes: 0,
+                contentTypesWithData: 0,
+                drillable: false,
+                countErrors: { contentTypes: errMsg(e) },
+            });
+            continue;
+        }
+        if (!memorixDb) {
+            memorixDb = resolveMemorixDbNameForEntity(entity, client);
+        }
+        const primaryType = primaryEntityContentType(entity);
+        const contentTypes = listEntityContentTypeKeys(entity);
+        const countErrors = {};
+        let primaryCount = 0;
+        let narrativesCount = 0;
+        let contentTypesWithData = 0;
+        const contentTypeCountErrors = [];
+        try {
+            primaryCount = await countMemorixEntityContentTypeDocuments(client, {
+                entityName: summary.entityName,
+                contentType: primaryType,
+            });
+        }
+        catch (e) {
+            countErrors.scoped = errMsg(e);
+        }
+        if (entity.contentTypes.narratives) {
+            try {
+                narrativesCount = await countMemorixEntityContentTypeDocuments(client, {
+                    entityName: summary.entityName,
+                    contentType: "narratives",
+                });
+            }
+            catch (e) {
+                countErrors.narratives = errMsg(e);
+            }
+        }
+        for (const contentType of contentTypes) {
+            try {
+                const ctCount = await countMemorixEntityContentTypeDocuments(client, {
+                    entityName: summary.entityName,
+                    contentType,
+                });
+                if (ctCount > 0)
+                    contentTypesWithData += 1;
+            }
+            catch (e) {
+                contentTypeCountErrors.push(`${contentType}: ${errMsg(e)}`);
+            }
+        }
+        if (contentTypeCountErrors.length) {
+            countErrors.contentTypes = contentTypeCountErrors.join("; ");
+        }
+        const connections = entityDescriptorConnections(entity);
+        const narrativeRefs = narrativesCount > 0
+            ? [{ id: "memorix:narratives", title: "Memorix narratives collection" }]
+            : [];
+        entities.push({
+            entityName: summary.entityName,
+            label: summary.label,
+            defaultListDescriptorId: summary.defaultListDescriptorId,
+            defaultItemDescriptorId: summary.defaultItemDescriptorId,
+            count: primaryCount,
+            narratives: narrativeRefs,
+            connections,
+            connectedEntityTypes: new Set(connections.map((c) => c.targetEntityName)).size,
+            contentTypesWithData,
+            drillable: primaryCount > 0 || narrativeRefs.length > 0,
+            ...(Object.keys(countErrors).length ? { countErrors } : {}),
+        });
+    }
+    discovery.memorixDb = memorixDb;
+    return {
+        memorixDb,
+        entities,
+        discovery,
+    };
+}
+export async function buildMemorixEntitySlices(client, entityName) {
+    const entity = await loadMemorixEntityDescriptorByName(client, entityName);
+    const contentTypes = listEntityContentTypeKeys(entity);
+    const slices = [];
+    const sliceCountFailures = [];
+    let step = 0;
+    for (const contentType of contentTypes) {
+        try {
+            const count = await countMemorixEntityContentTypeDocuments(client, {
+                entityName,
+                contentType,
+            });
+            if (count > 0) {
+                slices.push({
+                    contentType,
+                    label: memorixContentTypeLabel(contentType),
+                    count,
+                    step: step++,
+                });
+            }
+        }
+        catch (e) {
+            sliceCountFailures.push({ contentType, error: errMsg(e) });
+        }
+    }
+    return {
+        entityName,
+        slices,
+        ...(sliceCountFailures.length ? { sliceCountFailures } : {}),
+    };
+}
+//# sourceMappingURL=entity-graph.js.map

package/dist/explorer/entity-graph.js.map

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

package/dist/explorer/health.d.ts

@@ -0,0 +1,14 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+export type MemorixRetrievalHealth = {
+    ok: boolean;
+    memorixDb: string | null;
+    mongoUriConfigured: boolean;
+    pingMs?: number;
+    discoverySample: string[];
+    cataloxAppId: string;
+    entitiesCatalogId: string;
+    discoverySource: string;
+    error?: string;
+};
+export declare function getMemorixRetrievalHealth(client: MemorixRetrievalClient): Promise<MemorixRetrievalHealth>;
+//# sourceMappingURL=health.d.ts.map

package/dist/explorer/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/explorer/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAIjE,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CA2EjC"}

package/dist/explorer/health.js

@@ -0,0 +1,70 @@
+import { discoverMemorixEntities } from "../descriptors/discover-entities.js";
+import { resolveMongoUri } from "../mongo/env.js";
+export async function getMemorixRetrievalHealth(client) {
+    const discovery = await discoverMemorixEntities(client);
+    const discoverySample = discovery.summaries
+        .slice(0, 16)
+        .map((s) => s.entityName);
+    let mongoUriConfigured = false;
+    try {
+        resolveMongoUri(client.processEnv);
+        mongoUriConfigured = true;
+    }
+    catch {
+        mongoUriConfigured = false;
+    }
+    if (!client.getMongo) {
+        return {
+            ok: discovery.summaries.length > 0,
+            memorixDb: null,
+            mongoUriConfigured,
+            discoverySample,
+            cataloxAppId: client.appId,
+            entitiesCatalogId: discovery.catalogId,
+            discoverySource: discovery.source,
+            error: discovery.hint,
+        };
+    }
+    const started = Date.now();
+    try {
+        const mongo = await client.getMongo();
+        await mongo.db().admin().ping();
+        const pingMs = Date.now() - started;
+        let memorixDb = null;
+        if (discovery.summaries[0]) {
+            const { loadMemorixEntityDescriptorByName } = await import("../descriptors/discover-entities.js");
+            const { resolveMemorixDbNameForEntity } = await import("../mongo/resolve-db.js");
+            try {
+                const entity = await loadMemorixEntityDescriptorByName(client, discovery.summaries[0].entityName);
+                memorixDb = resolveMemorixDbNameForEntity(entity, client);
+            }
+            catch {
+                memorixDb = null;
+            }
+        }
+        return {
+            ok: true,
+            memorixDb,
+            mongoUriConfigured,
+            pingMs,
+            discoverySample,
+            cataloxAppId: client.appId,
+            entitiesCatalogId: discovery.catalogId,
+            discoverySource: discovery.source,
+            ...(discovery.hint ? { error: discovery.hint } : {}),
+        };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            memorixDb: null,
+            mongoUriConfigured,
+            discoverySample,
+            cataloxAppId: client.appId,
+            entitiesCatalogId: discovery.catalogId,
+            discoverySource: discovery.source,
+            error: e instanceof Error ? e.message : String(e),
+        };
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/explorer/health.js.map

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

package/dist/explorer/raw-reads.d.ts

@@ -0,0 +1,25 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import { mergeMemorixMongoFilters, resolveMemorixRecordIdFilter, serializeMemorixDocumentForJson } from "../data/record-id.js";
+export type RawMemorixEntityReadParams = {
+    entityName: string;
+    contentType: string;
+    filter?: Record<string, unknown>;
+    searchText?: string;
+    sort?: Record<string, 1 | -1>;
+    skip?: number;
+    limit?: number;
+    includeTotal?: boolean;
+};
+export type RawMemorixEntityListResult = {
+    documents: Record<string, unknown>[];
+    total?: number;
+};
+export declare function countMemorixEntityContentTypeDocuments(client: MemorixRetrievalClient, params: Pick<RawMemorixEntityReadParams, "entityName" | "contentType" | "filter" | "searchText">): Promise<number>;
+export declare function listMemorixEntityContentTypeDocuments(client: MemorixRetrievalClient, params: RawMemorixEntityReadParams): Promise<RawMemorixEntityListResult>;
+export declare function getMemorixEntityContentTypeDocument(client: MemorixRetrievalClient, params: {
+    entityName: string;
+    contentType: string;
+    recordId: string;
+}): Promise<Record<string, unknown> | null>;
+export { resolveMemorixRecordIdFilter, serializeMemorixDocumentForJson, mergeMemorixMongoFilters, };
+//# sourceMappingURL=raw-reads.d.ts.map

package/dist/explorer/raw-reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-reads.d.ts","sourceRoot":"","sources":["../../src/explorer/raw-reads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAEL,wBAAwB,EACxB,4BAA4B,EAC5B,+BAA+B,EAChC,MAAM,sBAAsB,CAAC;AAO9B,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AA+BF,wBAAsB,sCAAsC,CAC1D,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,IAAI,CACV,0BAA0B,EAC1B,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,YAAY,CACvD,GACA,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAsB,qCAAqC,CACzD,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,0BAA0B,CAAC,CA4CrC;AAED,wBAAsB,mCAAmC,CACvD,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAezC;AAED,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,wBAAwB,GACzB,CAAC"}