@x12i/memorix-retrieval 1.6.4 → 1.8.0

package/dist/explorer/raw-collection-records.js

@@ -0,0 +1,218 @@
+import { parseMemorixCollectionName } from "../data/collection-parser.js";
+import { escapeMongoRegex, mergeMemorixMongoFilters, serializeMemorixDocumentForJson, } from "../data/record-id.js";
+import { resolveMemorixRecordIdentity } from "../data/record-identity.js";
+import { memorixCountByTarget, memorixReadByTarget } from "../data/target-read.js";
+import { resolveMemorixIdentityField, resolveMemorixDatabaseName } from "../mongo/target-config.js";
+const PREVIEW_SCALAR_FIELDS = [
+    "name",
+    "title",
+    "label",
+    "slug",
+    "entityId",
+    "eventId",
+    "knowledgeId",
+    "id",
+];
+const DEFAULT_MAX_RAW_BYTES = 256_000;
+function inferType(value) {
+    if (value == null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+function jsonSize(value) {
+    try {
+        return JSON.stringify(value).length;
+    }
+    catch {
+        return DEFAULT_MAX_RAW_BYTES + 1;
+    }
+}
+function trimLargeDocument(doc, maxBytes) {
+    const serialized = serializeMemorixDocumentForJson(doc);
+    if (jsonSize(serialized) <= maxBytes) {
+        return { doc: serialized, truncated: false };
+    }
+    const trimmed = {};
+    for (const [key, value] of Object.entries(serialized)) {
+        trimmed[key] = value;
+        if (jsonSize(trimmed) > maxBytes) {
+            trimmed[key] = "[truncated: payload too large]";
+            return { doc: trimmed, truncated: true };
+        }
+    }
+    return { doc: trimmed, truncated: true };
+}
+function buildPreview(record, identityField) {
+    const preview = {};
+    for (const field of PREVIEW_SCALAR_FIELDS) {
+        const value = record[field];
+        if (value != null && typeof value !== "object") {
+            preview[field] = value;
+        }
+    }
+    if (identityField && record[identityField] != null) {
+        preview[identityField] = record[identityField];
+    }
+    return preview;
+}
+function inferFields(records) {
+    const coverage = new Map();
+    for (const record of records) {
+        for (const [key, value] of Object.entries(record)) {
+            const entry = coverage.get(key) ?? { count: 0, type: undefined };
+            entry.count += 1;
+            if (!entry.type && value != null)
+                entry.type = inferType(value);
+            coverage.set(key, entry);
+        }
+    }
+    return [...coverage.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([key, meta]) => ({
+        key,
+        inferredType: meta.type,
+        sampleCoverage: records.length ? meta.count / records.length : 0,
+    }));
+}
+function buildSearchFilter(searchText) {
+    if (!searchText?.trim())
+        return undefined;
+    const rx = escapeMongoRegex(searchText.trim());
+    return {
+        $or: [
+            { name: { $regex: rx, $options: "i" } },
+            { title: { $regex: rx, $options: "i" } },
+            { label: { $regex: rx, $options: "i" } },
+            { entityId: { $regex: rx, $options: "i" } },
+            { eventId: { $regex: rx, $options: "i" } },
+            { knowledgeId: { $regex: rx, $options: "i" } },
+        ],
+    };
+}
+function buildSort(sort) {
+    if (!sort?.path)
+        return undefined;
+    return { [sort.path]: sort.direction === "desc" ? -1 : 1 };
+}
+function buildIdQuery(recordId, idField, target) {
+    if (idField)
+        return { [idField]: recordId };
+    if (target) {
+        const defaultField = resolveMemorixIdentityField(target);
+        return {
+            $or: [
+                { [defaultField]: recordId },
+                { _id: recordId },
+                { id: recordId },
+            ],
+        };
+    }
+    return { _id: recordId };
+}
+export async function fetchMemorixRawCollectionRecords(client, input) {
+    const databaseName = resolveMemorixDatabaseName(client, input.target);
+    const parsedCollectionName = parseMemorixCollectionName(input.collectionName);
+    const limit = Math.min(client.defaults.maxPageLimit, Math.max(1, input.page?.limit ?? 50));
+    const offset = Math.max(0, input.page?.offset ?? 0);
+    const maxBytes = client.defaults.contentMaxBytes ?? DEFAULT_MAX_RAW_BYTES;
+    const warnings = [];
+    const query = mergeMemorixMongoFilters(buildSearchFilter(input.searchText));
+    const sort = buildSort(input.sort);
+    const project = input.projection
+        ? Object.entries(input.projection)
+            .filter(([, v]) => v === 1)
+            .map(([k]) => k)
+        : undefined;
+    let total;
+    if (input.includeTotal) {
+        total = await memorixCountByTarget(client, {
+            target: input.target,
+            collection: input.collectionName,
+            query,
+        });
+    }
+    const docs = await memorixReadByTarget(client, {
+        target: input.target,
+        collection: input.collectionName,
+        query,
+        sort,
+        skip: offset,
+        limit,
+        project,
+    });
+    const records = docs.map((doc) => {
+        const serialized = serializeMemorixDocumentForJson(doc);
+        const identity = resolveMemorixRecordIdentity(input.target, serialized);
+        const { doc: raw, truncated } = trimLargeDocument(serialized, maxBytes);
+        if (truncated) {
+            warnings.push(`Record "${identity.id || "unknown"}" payload truncated to ${maxBytes} bytes`);
+        }
+        return {
+            id: identity.id,
+            identityField: identity.identityField,
+            raw,
+            preview: buildPreview(raw, identity.identityField),
+        };
+    });
+    return {
+        target: input.target,
+        databaseName,
+        collectionName: input.collectionName,
+        parsedCollectionName,
+        page: {
+            limit,
+            offset,
+            returned: records.length,
+            ...(total !== undefined ? { total } : {}),
+        },
+        fields: inferFields(records.map((r) => r.raw)),
+        records,
+        warnings: [...new Set(warnings)],
+    };
+}
+export async function fetchMemorixRawCollectionItem(client, input) {
+    const databaseName = resolveMemorixDatabaseName(client, input.target);
+    const parsedCollectionName = parseMemorixCollectionName(input.collectionName);
+    const maxBytes = client.defaults.contentMaxBytes ?? DEFAULT_MAX_RAW_BYTES;
+    const warnings = [];
+    const docs = await memorixReadByTarget(client, {
+        target: input.target,
+        collection: input.collectionName,
+        query: buildIdQuery(input.recordId, input.idField, input.target),
+        limit: 1,
+    });
+    if (!docs.length) {
+        return {
+            target: input.target,
+            databaseName,
+            collectionName: input.collectionName,
+            parsedCollectionName,
+            record: null,
+            warnings,
+        };
+    }
+    const serialized = serializeMemorixDocumentForJson(docs[0]);
+    const identity = resolveMemorixRecordIdentity(input.target, serialized, {
+        descriptorIdentityField: input.idField,
+    });
+    const { doc: raw, truncated } = trimLargeDocument(serialized, maxBytes);
+    if (truncated) {
+        warnings.push(`Record payload truncated to ${maxBytes} bytes`);
+    }
+    return {
+        target: input.target,
+        databaseName,
+        collectionName: input.collectionName,
+        parsedCollectionName,
+        record: {
+            id: identity.id,
+            identityField: identity.identityField,
+            raw,
+            preview: buildPreview(raw, identity.identityField),
+        },
+        warnings,
+    };
+}
+//# sourceMappingURL=raw-collection-records.js.map

package/dist/explorer/raw-collection-records.js.map

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

package/dist/explorer/unified-inventory.d.ts

@@ -0,0 +1,82 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { MemorixTarget } from "../mongo/types.js";
+export type MemorixInventorySourceLens = "catalox-first" | "db-first";
+export type MemorixInventoryMappingStatus = "mapped" | "missing-collection" | "orphan-collection" | "object-missing" | "content-type-missing" | "collection-mismatch" | "ignored" | "unparseable";
+export type MemorixInventoryRowSource = "catalox-declared" | "mongo-discovered" | "merged";
+export type MemorixInventoryAction = "open-records" | "open-raw-records" | "inspect-descriptor" | "create-descriptor" | "add-content-type" | "fix-binding" | "ignore";
+export type MemorixInventoryIssueKind = "missing-collection" | "empty-declared-collection" | "orphan-collection" | "object-missing" | "content-type-missing" | "collection-mismatch" | "unparseable-collection" | "broken-list-descriptor" | "broken-item-descriptor" | "broken-slice-descriptor";
+export type MemorixInventoryIssue = {
+    issueId: string;
+    severity: "info" | "warning" | "error";
+    kind: MemorixInventoryIssueKind;
+    target?: MemorixTarget;
+    databaseName?: string;
+    objectName?: string;
+    contentType?: string;
+    collectionName?: string;
+    descriptorId?: string;
+    message: string;
+    suggestedActions: Array<"inspect" | "create-descriptor" | "add-content-type" | "fix-binding" | "ignore" | "delete-or-archive">;
+};
+export type MemorixInventoryRow = {
+    rowId: string;
+    target: MemorixTarget;
+    databaseName: string;
+    objectName: string;
+    contentType: string;
+    collectionName: string;
+    expectedCollectionName?: string;
+    source: MemorixInventoryRowSource;
+    mappingStatus: MemorixInventoryMappingStatus;
+    descriptor?: {
+        entityDescriptorId?: string;
+        listDescriptorIds?: string[];
+        itemDescriptorIds?: string[];
+        defaultListDescriptorId?: string;
+        defaultItemDescriptorId?: string;
+    };
+    counts: {
+        estimated?: number;
+        exact?: number;
+        countMode?: "none" | "estimated" | "exact";
+    };
+    actions: MemorixInventoryAction[];
+    issueIds?: string[];
+};
+export type MemorixTargetInventory = {
+    databaseName: string;
+    declaredCollections: number;
+    mappedCollections: number;
+    missingCollections: number;
+    orphanCollections: number;
+    emptyDeclaredCollections: number;
+    mongoCollections: number;
+    totalRecords?: number;
+};
+export type MemorixUnifiedInventory = {
+    sourceLens: MemorixInventorySourceLens;
+    summary: {
+        cataloxObjects: number;
+        mongoCollections: number;
+        declaredCollections: number;
+        mappedCollections: number;
+        missingCollections: number;
+        orphanCollections: number;
+        emptyDeclaredCollections: number;
+        totalRecords?: number;
+        issueCount: number;
+    };
+    targets: Record<MemorixTarget, MemorixTargetInventory>;
+    rows: MemorixInventoryRow[];
+    issues: MemorixInventoryIssue[];
+    generatedAt: string;
+};
+export type BuildMemorixUnifiedInventoryOptions = {
+    sourceLens?: MemorixInventorySourceLens;
+    targets?: MemorixTarget[];
+    includeExactCounts?: boolean;
+    includeSamples?: boolean;
+    includeIgnored?: boolean;
+};
+export declare function buildMemorixUnifiedInventory(client: MemorixRetrievalClient, options?: BuildMemorixUnifiedInventoryOptions): Promise<MemorixUnifiedInventory>;
+//# sourceMappingURL=unified-inventory.d.ts.map

package/dist/explorer/unified-inventory.d.ts.map

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