@x12i/memorix-hippox 1.0.1 → 1.2.0

package/dist/infer-links.js

@@ -0,0 +1,171 @@
+import { resolveDefaultListDescriptorForEntity } from '@x12i/memorix-retrieval';
+import { loadHippoxConfig } from './config.js';
+import { readObjectTypeDocuments, resolveObjectTypeCollection, } from './collection-resolver.js';
+import { loadRecordKeyAnalysis } from './helpers-loader.js';
+import { flattenSampleForKeyAnalysis, memorixPathForLeaf } from './record-flatten.js';
+const DEFAULT_DATA_ROOT = 'data';
+export async function inferLinksForObjectTypes(options) {
+    const config = loadHippoxConfig(options.processEnv);
+    const objectTypes = [...new Set((options.input.objectTypes ?? []).map((t) => t.trim()).filter(Boolean))];
+    if (objectTypes.length < 2) {
+        throw new Error('objectTypes must include at least two distinct object types');
+    }
+    const sampleLimit = Math.min(options.input.sampleLimit ?? config.inferSampleLimit, config.inferSampleLimit);
+    const candidateThreshold = options.input.candidateConfidenceThreshold ?? config.inferCandidateConfidence;
+    const minInclusionRatio = options.input.minInclusionRatio ?? config.inferMinInclusionRatio;
+    const helpers = loadRecordKeyAnalysis();
+    const warnings = [];
+    const collectionProfiles = [];
+    const samplesByType = new Map();
+    const targetCollectionsMap = {};
+    for (const objectType of objectTypes) {
+        try {
+            await resolveDefaultListDescriptorForEntity(options.retrieval, objectType);
+        }
+        catch {
+            throw new Error(`Object type not found: ${objectType}`);
+        }
+        const binding = await resolveObjectTypeCollection(options.retrieval, objectType, options.input.contentType);
+        const dataRoot = await resolveDataRoot(options.retrieval, objectType, binding.contentType);
+        const docs = await readObjectTypeDocuments(options.retrieval, binding, {
+            limit: sampleLimit,
+        });
+        if (docs.length === 0) {
+            warnings.push({
+                code: 'empty_collection',
+                message: `No sample records for object type "${objectType}".`,
+            });
+            continue;
+        }
+        const flatSample = flattenSampleForKeyAnalysis(docs, dataRoot);
+        const { records: helperRecords, pathByLeaf } = flatSample;
+        samplesByType.set(objectType, helperRecords);
+        const first = helperRecords[0];
+        if (!first || Object.keys(first).length === 0) {
+            warnings.push({
+                code: 'no_scalar_fields',
+                message: `No scalar join fields discovered in sample for "${objectType}".`,
+            });
+            continue;
+        }
+        const candidates = helpers
+            .analyzeSingleRecordKeys(first)
+            .filter((c) => c.confidence >= candidateThreshold)
+            .map((c) => c.property);
+        if (candidates.length === 0) {
+            warnings.push({
+                code: 'no_key_candidates',
+                message: `No property candidates above confidence ${candidateThreshold} for "${objectType}".`,
+            });
+            continue;
+        }
+        const classified = helpers.analyzeCollectionKeys(helperRecords, candidates);
+        const primaryKeys = classified
+            .filter((row) => row.classification === 'PRIMARY')
+            .map((row) => memorixPathForLeaf(pathByLeaf, row.property));
+        const foreignKeys = classified
+            .filter((row) => row.classification === 'FOREIGN' || row.classification === 'FOREIGN_OR_DIRTY_PRIMARY')
+            .map((row) => ({
+            leaf: row.property,
+            path: memorixPathForLeaf(pathByLeaf, row.property),
+        }));
+        if (primaryKeys.length === 0) {
+            const idLike = classified
+                .filter((row) => row.property.endsWith('Id') || row.property === 'id')
+                .sort((a, b) => b.uniquenessRatio - a.uniquenessRatio)
+                .slice(0, 3)
+                .map((row) => memorixPathForLeaf(pathByLeaf, row.property));
+            primaryKeys.push(...idLike);
+        }
+        collectionProfiles.push({
+            objectType,
+            contentType: binding.contentType,
+            sampleCount: helperRecords.length,
+            primaryKeys,
+            foreignKeys: foreignKeys.map((row) => row.path),
+            properties: classified.map((row) => ({
+                property: memorixPathForLeaf(pathByLeaf, row.property),
+                classification: row.classification,
+                uniqueCount: row.uniqueCount,
+                uniquenessRatio: row.uniquenessRatio,
+                confidence: row.confidence,
+            })),
+        });
+        targetCollectionsMap[objectType] = {
+            primaryKeys: primaryKeys.map((path) => {
+                for (const [leaf, full] of pathByLeaf.entries()) {
+                    if (full === path)
+                        return leaf;
+                }
+                return path.split('.').pop() ?? path;
+            }),
+            records: helperRecords,
+        };
+    }
+    const inferredLinks = [];
+    let rank = 0;
+    for (const profile of collectionProfiles) {
+        const sourceSample = samplesByType.get(profile.objectType);
+        if (!sourceSample?.length)
+            continue;
+        for (const foreignKey of profile.foreignKeys) {
+            const foreignLeaf = foreignKey.split('.').pop() ?? foreignKey;
+            const others = { ...targetCollectionsMap };
+            delete others[profile.objectType];
+            const edges = helpers.mapCrossCollectionRelationships(sourceSample, foreignLeaf, others, { minInclusionRatio });
+            for (const edge of edges) {
+                rank += 1;
+                const targetProfile = collectionProfiles.find((p) => p.objectType === edge.targetCollection);
+                const resolvedTargetPath = targetProfile?.primaryKeys.find((p) => p.endsWith(`.${edge.targetProperty}`) || p === edge.targetProperty)
+                    ?? targetProfile?.primaryKeys[0]
+                    ?? `data.${edge.targetProperty}`;
+                inferredLinks.push({
+                    rank,
+                    sourceObjectType: profile.objectType,
+                    targetObjectType: edge.targetCollection,
+                    sourcePath: foreignKey,
+                    targetPath: resolvedTargetPath,
+                    operator: 'eq',
+                    inclusionRatio: edge.inclusionRatio,
+                    confidence: edge.confidence / 100,
+                    summary: `${Math.round(edge.inclusionRatio * 100)}% of source values match target `
+                        + `${edge.targetProperty} on ${edge.targetCollection}.`,
+                });
+            }
+        }
+    }
+    inferredLinks.sort((a, b) => b.confidence - a.confidence || a.sourceObjectType.localeCompare(b.sourceObjectType));
+    inferredLinks.forEach((link, index) => {
+        link.rank = index + 1;
+    });
+    if (inferredLinks.length === 0) {
+        warnings.push({
+            code: 'no_inferred_links',
+            message: `No cross-collection links met inclusion ratio ${minInclusionRatio}.`,
+        });
+    }
+    return {
+        mode: 'fuzzy-mapping',
+        sampleLimit,
+        candidateConfidenceThreshold: candidateThreshold,
+        minInclusionRatio,
+        collectionProfiles,
+        inferredLinks,
+        warnings,
+    };
+}
+async function resolveDataRoot(retrieval, objectType, contentTypeKey) {
+    try {
+        const { entity } = await resolveDefaultListDescriptorForEntity(retrieval, objectType);
+        const ct = entity.contentTypes?.[contentTypeKey];
+        if (ct && typeof ct.dataRoot === 'string')
+            return ct.dataRoot;
+        if (entity.defaults?.dataRoot)
+            return entity.defaults.dataRoot;
+    }
+    catch {
+        // fall through
+    }
+    return DEFAULT_DATA_ROOT;
+}
+//# sourceMappingURL=infer-links.js.map

package/dist/infer-links.js.map

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

package/dist/join-discovery.d.ts

@@ -0,0 +1,34 @@
+import type { MemorixRetrievalClient } from '@x12i/memorix-retrieval';
+import type { HippoxStore } from './store.js';
+import type { InferredFieldType, JoinDiscoveryInput, JoinDiscoveryResult } from './types.js';
+export type DiscoverJoinCandidatesOptions = {
+    retrieval: MemorixRetrievalClient;
+    store?: HippoxStore;
+    input: JoinDiscoveryInput;
+    processEnv?: NodeJS.ProcessEnv;
+};
+type PairProbe = {
+    sourcePath: string;
+    targetPath: string;
+    valueHitRate: number;
+    sourceCoverage: number;
+    targetCoverage: number;
+    targetUniqueness: number;
+    nameSimilarity: number;
+    schemaRelationBoost: number;
+    approvedLinkBoost: number;
+    sourceType: InferredFieldType;
+    targetType: InferredFieldType;
+};
+export declare function clearJoinDiscoveryCache(): void;
+export declare function discoverJoinCandidates(options: DiscoverJoinCandidatesOptions): Promise<JoinDiscoveryResult>;
+export declare function isScalarJoinable(value: unknown): boolean;
+export declare function normalizeScalarValue(value: unknown): string | null;
+export declare function classifyValue(value: unknown): InferredFieldType;
+export declare function computeValueHitRate(sourceValues: string[], targetValues: Set<string>): number;
+export declare function computeNameSimilarity(sourcePath: string, targetPath: string, targetObjectType: string): number;
+export declare function sourceNameHintScore(path: string, targetObjectType: string): number;
+export declare function targetNameHintScore(path: string, sourceObjectType: string): number;
+export declare function computePairScore(probe: PairProbe): number;
+export {};
+//# sourceMappingURL=join-discovery.d.ts.map

package/dist/join-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-discovery.d.ts","sourceRoot":"","sources":["../src/join-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAUtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EACV,iBAAiB,EAGjB,kBAAkB,EAClB,mBAAmB,EAIpB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,EAAE,sBAAsB,CAAC;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAChC,CAAC;AAyBF,KAAK,SAAS,GAAG;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,UAAU,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAaF,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,mBAAmB,CAAC,CA0K9B;AAkLD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKxD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASlE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAS/D;AAqKD,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAO7F;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAeR;AAYD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAUlF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAQlF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAiBzD"}