@x12i/memorix-associator 1.0.0

package/dist/planning/build-plan.js

@@ -0,0 +1,319 @@
+import { builtinResolvers, createResolverRegistry, getByPath, isAssociatedPropertyName, isMissingJoinValue, normalizeJoinValues, runResolverSteps, } from "@x12i/memorix-resolvers";
+import { buildPlanFingerprint, canonicalKey, collectionKey } from "../planning/fingerprint.js";
+import { buildFailureRecord, defaultFailureCollection } from "../writing/failures.js";
+import { buildUpdateOperation, mergeAssociatedAppendUnique, normalizeAssociatedValue, } from "../writing/smart-merge.js";
+function resolveJoinValuesByPaths(obj, paths) {
+    const out = [];
+    for (const path of paths) {
+        out.push(...normalizeJoinValues(getByPath(obj, path)));
+    }
+    return normalizeJoinValues(out);
+}
+function selectLinkedPayload(doc) {
+    const data = doc.data;
+    if (typeof data !== "object" || data === null || Array.isArray(data))
+        return null;
+    return data;
+}
+async function buildBridgeIndex(store, bridge) {
+    const exists = await store.collectionExists(bridge.db, bridge.collection);
+    if (!exists)
+        return null;
+    const index = new Map();
+    for await (const doc of store.scanRecords(bridge.db, bridge.collection)) {
+        const targetValue = getByPath(doc, bridge.targetJoinPath);
+        if (isMissingJoinValue(targetValue))
+            continue;
+        for (const sourceValue of resolveJoinValuesByPaths(doc, bridge.sourceJoinPaths)) {
+            const key = canonicalKey(sourceValue);
+            const bucket = index.get(key) ?? [];
+            bucket.push(targetValue);
+            index.set(key, bucket);
+        }
+    }
+    return index;
+}
+async function buildTargetIndex(store, rule) {
+    const exists = await store.collectionExists(rule.target.db, rule.target.collection);
+    const report = {
+        ruleKey: rule.ruleKey,
+        linkedCollection: collectionKey(rule.target.db, rule.target.collection),
+        associatedProperty: rule.associatedProperty,
+        targetRecordsScanned: 0,
+        targetRecordsIndexed: 0,
+        targetMissingJoin: 0,
+        targetMissingBridgeJoin: 0,
+        targetJoinValuesIndexed: 0,
+        targetInvalidDataShape: 0,
+        skipped: false,
+    };
+    if (!exists) {
+        report.skipped = true;
+        report.skipReason = "TARGET_COLLECTION_MISSING";
+        return { rule, index: new Map(), report, skipped: true };
+    }
+    const bridgeIndex = rule.target.bridge
+        ? await buildBridgeIndex(store, rule.target.bridge)
+        : null;
+    if (rule.target.bridge && !bridgeIndex) {
+        report.skipped = true;
+        report.skipReason = "BRIDGE_COLLECTION_MISSING";
+        return { rule, index: new Map(), report, skipped: true };
+    }
+    const index = new Map();
+    for await (const doc of store.scanRecords(rule.target.db, rule.target.collection)) {
+        report.targetRecordsScanned += 1;
+        const rawJoinValues = resolveJoinValuesByPaths(doc, rule.target.joinPaths);
+        if (rawJoinValues.length === 0) {
+            report.targetMissingJoin += 1;
+            continue;
+        }
+        const payload = selectLinkedPayload(doc);
+        if (!payload) {
+            report.targetInvalidDataShape += 1;
+            continue;
+        }
+        const joinValues = bridgeIndex
+            ? normalizeJoinValues(rawJoinValues.flatMap((joinValue) => bridgeIndex.get(canonicalKey(joinValue)) ?? []))
+            : rawJoinValues;
+        if (joinValues.length === 0) {
+            report.targetMissingBridgeJoin += 1;
+            continue;
+        }
+        for (const joinValue of joinValues) {
+            const key = canonicalKey(joinValue);
+            const bucket = index.get(key) ?? [];
+            bucket.push(payload);
+            index.set(key, bucket);
+            report.targetJoinValuesIndexed += 1;
+        }
+        report.targetRecordsIndexed += 1;
+    }
+    return { rule, index, report, skipped: false };
+}
+function collectAssociatedFromDoc(doc) {
+    const map = new Map();
+    for (const key of Object.keys(doc)) {
+        if (isAssociatedPropertyName(key)) {
+            map.set(key, doc[key]);
+        }
+    }
+    return map;
+}
+function initSourceSummary(collection) {
+    return {
+        collection,
+        sourceRecordsScanned: 0,
+        sourceRecordsWouldUpdate: 0,
+        sourceRecordsUpdated: 0,
+        associatedItemsWouldAppend: 0,
+        normalizedProperties: 0,
+        emptyAssociatedPropertiesRemoved: 0,
+        duplicateAssociatedItemsRemoved: 0,
+        failureRecordsWouldWrite: 0,
+        failureRecordsWritten: 0,
+        skippedRules: 0,
+        writeErrors: 0,
+    };
+}
+export async function buildAssociationPlan(request, options) {
+    const failedAt = new Date().toISOString();
+    const registry = options.registry ?? createResolverRegistry(builtinResolvers);
+    const indexedRules = [];
+    const ruleReports = [];
+    for (const rule of request.rules) {
+        const indexed = await buildTargetIndex(options.store, rule);
+        indexedRules.push(indexed);
+        ruleReports.push(indexed.report);
+        if (indexed.skipped) {
+            // counted per source collection later
+        }
+    }
+    const updates = [];
+    const failures = [];
+    const failureSamples = [];
+    const failureCountsByReason = {};
+    const sourceKey = collectionKey(request.source.db, request.source.collection);
+    const sourceSummary = initSourceSummary(sourceKey);
+    const failureCollection = defaultFailureCollection(request.source.objectType, request.failurePolicy.collection);
+    for (const indexedRule of indexedRules) {
+        if (indexedRule.skipped)
+            sourceSummary.skippedRules += 1;
+    }
+    for await (const sourceDoc of options.store.scanRecords(request.source.db, request.source.collection, request.source.filter, request.safety.limit)) {
+        sourceSummary.sourceRecordsScanned += 1;
+        const working = new Map();
+        const original = collectAssociatedFromDoc(sourceDoc);
+        for (const [key, value] of original.entries()) {
+            const normalized = normalizeAssociatedValue(value);
+            if (normalized.changed)
+                sourceSummary.normalizedProperties += 1;
+            if (normalized.removedEmpty)
+                sourceSummary.emptyAssociatedPropertiesRemoved += 1;
+            sourceSummary.duplicateAssociatedItemsRemoved += normalized.deduped;
+            working.set(key, normalized.value);
+        }
+        const recordForResolvers = { ...sourceDoc };
+        if (request.normalization?.length) {
+            for (const step of request.normalization) {
+                if (step.type === "split-values") {
+                    const result = await runResolverSteps(registry, {
+                        steps: [
+                            {
+                                type: "multi-value",
+                                resolverKey: `norm-${step.to}`,
+                                config: {
+                                    from: step.from,
+                                    to: step.to,
+                                    separators: step.separators,
+                                    deduplicate: step.deduplicate,
+                                },
+                            },
+                        ],
+                        record: recordForResolvers,
+                    });
+                    for (const [path, values] of result.mergedOutputs.entries()) {
+                        const parts = path.split(".");
+                        let current = recordForResolvers;
+                        for (let i = 0; i < parts.length - 1; i += 1) {
+                            const part = parts[i];
+                            const next = current[part];
+                            if (typeof next !== "object" || next === null || Array.isArray(next)) {
+                                current[part] = {};
+                            }
+                            current = current[part];
+                        }
+                        current[parts[parts.length - 1]] = values;
+                    }
+                }
+            }
+        }
+        if (request.resolvers?.length) {
+            const resolverResult = await runResolverSteps(registry, {
+                steps: request.resolvers,
+                record: recordForResolvers,
+                recordId: String(sourceDoc.recordId ?? sourceDoc._id ?? ""),
+                context: {
+                    scanRecords: (ref) => options.store.scanRecords(ref.db, ref.collection),
+                },
+            });
+            for (const [path, values] of resolverResult.mergedOutputs.entries()) {
+                const parts = path.split(".");
+                let current = recordForResolvers;
+                for (let i = 0; i < parts.length - 1; i += 1) {
+                    const part = parts[i];
+                    const next = current[part];
+                    if (typeof next !== "object" || next === null || Array.isArray(next)) {
+                        current[part] = {};
+                    }
+                    current = current[part];
+                }
+                current[parts[parts.length - 1]] = values;
+            }
+        }
+        const joinSource = { ...sourceDoc, ...recordForResolvers };
+        for (const indexedRule of indexedRules) {
+            if (indexedRule.skipped)
+                continue;
+            const rule = indexedRule.rule;
+            const sourceJoinValues = resolveJoinValuesByPaths(joinSource, rule.sourceJoinPaths);
+            if (sourceJoinValues.length === 0) {
+                if (rule.mandatory && request.failurePolicy.writeFailures) {
+                    const record = buildFailureRecord({
+                        sourceDoc,
+                        sourceObjectType: request.source.objectType,
+                        sourceContentType: request.source.contentType,
+                        ruleKey: rule.ruleKey,
+                        reason: "JOIN_FIELD_MISSING_ON_SOURCE",
+                        message: "Source join field missing",
+                        details: { sourceJoinPaths: rule.sourceJoinPaths },
+                        failedAt,
+                    });
+                    failures.push({
+                        db: request.source.db,
+                        collection: failureCollection,
+                        filter: { recordId: record.recordId ?? "" },
+                        record,
+                    });
+                    failureCountsByReason.JOIN_FIELD_MISSING_ON_SOURCE =
+                        (failureCountsByReason.JOIN_FIELD_MISSING_ON_SOURCE ?? 0) + 1;
+                    if (failureSamples.length < (request.failurePolicy.includeSamplesInReport ?? 20)) {
+                        failureSamples.push(record);
+                    }
+                    sourceSummary.failureRecordsWouldWrite += 1;
+                }
+                continue;
+            }
+            const payloads = [];
+            for (const joinValue of sourceJoinValues) {
+                payloads.push(...(indexedRule.index.get(canonicalKey(joinValue)) ?? []));
+            }
+            if (payloads.length === 0) {
+                if (rule.mandatory && request.failurePolicy.writeFailures) {
+                    const record = buildFailureRecord({
+                        sourceDoc,
+                        sourceObjectType: request.source.objectType,
+                        sourceContentType: request.source.contentType,
+                        ruleKey: rule.ruleKey,
+                        reason: "MANDATORY_LINKED_CONTEXT_MISSING",
+                        message: "Mandatory linked context missing",
+                        details: { sourceJoinValues },
+                        failedAt,
+                    });
+                    failures.push({
+                        db: request.source.db,
+                        collection: failureCollection,
+                        filter: { recordId: record.recordId ?? "" },
+                        record,
+                    });
+                    failureCountsByReason.MANDATORY_LINKED_CONTEXT_MISSING =
+                        (failureCountsByReason.MANDATORY_LINKED_CONTEXT_MISSING ?? 0) + 1;
+                    if (failureSamples.length < (request.failurePolicy.includeSamplesInReport ?? 20)) {
+                        failureSamples.push(record);
+                    }
+                    sourceSummary.failureRecordsWouldWrite += 1;
+                }
+                continue;
+            }
+            const merged = mergeAssociatedAppendUnique(working.get(rule.associatedProperty), payloads);
+            sourceSummary.associatedItemsWouldAppend += merged.appended;
+            if (merged.normalized.deduped > 0) {
+                sourceSummary.duplicateAssociatedItemsRemoved += merged.normalized.deduped;
+            }
+            if (merged.value === undefined) {
+                working.delete(rule.associatedProperty);
+            }
+            else {
+                working.set(rule.associatedProperty, merged.value);
+            }
+        }
+        const updateDoc = buildUpdateOperation(original, working);
+        if (updateDoc) {
+            sourceSummary.sourceRecordsWouldUpdate += 1;
+            updates.push({
+                db: request.source.db,
+                collection: request.source.collection,
+                id: String(sourceDoc._id),
+                operation: {
+                    updateOne: {
+                        filter: { _id: sourceDoc._id },
+                        update: updateDoc,
+                    },
+                },
+            });
+        }
+    }
+    const planFingerprint = buildPlanFingerprint({ updates, failures });
+    const report = {
+        mode: options.apply ? "apply" : "dry-run",
+        generatedAt: failedAt,
+        processId: request.processId,
+        planFingerprint,
+        rules: ruleReports,
+        sourceCollections: [sourceSummary],
+        failureCountsByReason,
+        failureSamples,
+    };
+    return { report, planFingerprint, updates, failures };
+}
+//# sourceMappingURL=build-plan.js.map

package/dist/planning/build-plan.js.map

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

package/dist/planning/fingerprint.d.ts

@@ -0,0 +1,19 @@
+export declare function canonicalize(value: unknown): unknown;
+export declare function canonicalKey(value: unknown): string;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function collectionKey(db: string, collection: string): string;
+export declare function buildPlanFingerprint(input: {
+    updates: Array<{
+        db: string;
+        collection: string;
+        id: string;
+        operation: unknown;
+    }>;
+    failures: Array<{
+        db: string;
+        collection: string;
+        filter: unknown;
+        record: Record<string, unknown>;
+    }>;
+}): string;
+//# sourceMappingURL=fingerprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/planning/fingerprint.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYpD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACnF,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CACvG,GAAG,MAAM,CAwBT"}

package/dist/planning/fingerprint.js

@@ -0,0 +1,47 @@
+import { createHash } from "node:crypto";
+export function canonicalize(value) {
+    if (value instanceof Date)
+        return { $date: value.toISOString() };
+    if (isPlainObject(value)) {
+        return Object.keys(value)
+            .sort()
+            .reduce((out, key) => {
+            out[key] = canonicalize(value[key]);
+            return out;
+        }, {});
+    }
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    return value;
+}
+export function canonicalKey(value) {
+    return JSON.stringify(canonicalize(value));
+}
+export function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function collectionKey(db, collection) {
+    return `${db}/${collection}`;
+}
+export function buildPlanFingerprint(input) {
+    const stableUpdates = input.updates
+        .map((entry) => ({
+        db: entry.db,
+        collection: entry.collection,
+        id: entry.id,
+        update: canonicalize(entry.operation.updateOne.update),
+    }))
+        .sort((a, b) => canonicalKey(a).localeCompare(canonicalKey(b)));
+    const stableFailures = input.failures
+        .map((entry) => ({
+        db: entry.db,
+        collection: entry.collection,
+        filter: entry.filter,
+        record: { ...entry.record, failedAt: undefined },
+    }))
+        .sort((a, b) => canonicalKey(a).localeCompare(canonicalKey(b)));
+    return createHash("sha256")
+        .update(JSON.stringify({ updates: stableUpdates, failures: stableFailures }))
+        .digest("hex");
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/planning/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../src/planning/fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;IACjE,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;aACtB,IAAI,EAAE;aACN,MAAM,CAA0B,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YAC5C,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC;YACjE,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACX,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,UAAkB;IAC1D,OAAO,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAGpC;IACC,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO;SAChC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,MAAM,EAAE,YAAY,CACjB,KAAK,CAAC,SAAgD,CAAC,SAAS,CAAC,MAAM,CACzE;KACF,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAElE,MAAM,cAAc,GAAG,KAAK,CAAC,QAAQ;SAClC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE;KACjD,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAElE,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;SAC5E,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/request/schema.d.ts

@@ -0,0 +1,213 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type AssociationMode = "dry-run" | "apply";
+export type BridgeIndex = {
+    db: string;
+    collection: string;
+    sourceJoinPaths: string[];
+    targetJoinPath: string;
+};
+export type AssociationTarget = {
+    db: string;
+    collection: string;
+    objectType: string;
+    contentType: string;
+    joinPaths: string[];
+    bridge?: BridgeIndex;
+};
+export type AssociationRule = {
+    type: "association";
+    ruleKey: string;
+    mandatory: boolean;
+    sourceJoinPaths: string[];
+    target: AssociationTarget;
+    associatedProperty: string;
+    payload: {
+        source: "target.data";
+    };
+};
+export type NormalizationStep = {
+    type: "split-values";
+    from: string[];
+    to: string;
+    separators?: string[];
+    deduplicate?: boolean;
+};
+export type ResolverStepRef = {
+    type: string;
+    resolverKey: string;
+    config?: unknown;
+};
+export type MemorixAssociationRequest = {
+    processId: string;
+    description?: string;
+    mode: AssociationMode;
+    connection: {
+        mongoUriEnv?: string;
+        databases?: {
+            entities?: string;
+            events?: string;
+            knowledge?: string;
+        };
+    };
+    safety: {
+        requireReviewedReportForApply: boolean;
+        reviewedReportPath?: string;
+        expectedPlanFingerprint?: string;
+        backupBeforeApply?: boolean;
+        verifyAfterPlan?: boolean;
+        verifyAfterApply?: boolean;
+        limit?: number;
+    };
+    source: {
+        db: string;
+        collection: string;
+        objectType: string;
+        contentType: string;
+        filter?: Record<string, unknown>;
+    };
+    normalization?: NormalizationStep[];
+    resolvers?: ResolverStepRef[];
+    rules: AssociationRule[];
+    failurePolicy: {
+        collection?: string;
+        writeFailures: boolean;
+        includeSamplesInReport?: number;
+    };
+    writePolicy: {
+        associatedArrayMode: "append-unique";
+        omitEmptyAssociatedArrays: boolean;
+        canonicalDeduplication: boolean;
+    };
+};
+export type FailureReason = "JOIN_FIELD_MISSING_ON_SOURCE" | "JOIN_FIELD_MISSING_ON_TARGET" | "MANDATORY_LINKED_CONTEXT_MISSING" | "FILTER_REMOVED_ALL_RECORDS" | "INVALID_DATA_SHAPE" | "BRIDGE_COLLECTION_MISSING" | "WRITE_FAILED" | "MERGE_FAILED" | "UNEXPECTED_EXCEPTION";
+export type AssociationFailureRecord = {
+    recordId?: string;
+    sourceObjectType: string;
+    sourceContentType: string;
+    ruleKey: string;
+    failedAt: string;
+    reason: FailureReason;
+    message: string;
+    details: Record<string, unknown>;
+};
+export type RulePlanReport = {
+    ruleKey: string;
+    linkedCollection: string;
+    associatedProperty: string;
+    targetRecordsScanned: number;
+    targetRecordsIndexed: number;
+    targetMissingJoin: number;
+    targetMissingBridgeJoin: number;
+    targetJoinValuesIndexed: number;
+    targetInvalidDataShape: number;
+    skipped: boolean;
+    skipReason?: string;
+};
+export type AssociationReport = {
+    mode: AssociationMode;
+    generatedAt: string;
+    processId: string;
+    planFingerprint: string;
+    rules: RulePlanReport[];
+    sourceCollections: Array<{
+        collection: string;
+        sourceRecordsScanned: number;
+        sourceRecordsWouldUpdate: number;
+        sourceRecordsUpdated: number;
+        associatedItemsWouldAppend: number;
+        normalizedProperties: number;
+        emptyAssociatedPropertiesRemoved: number;
+        duplicateAssociatedItemsRemoved: number;
+        failureRecordsWouldWrite: number;
+        failureRecordsWritten: number;
+        skippedRules: number;
+        writeErrors: number;
+    }>;
+    failureCountsByReason: Record<string, number>;
+    failureSamples: AssociationFailureRecord[];
+    verification?: VerificationReport;
+    backupManifest?: string[];
+};
+export type VerificationReport = {
+    passed: boolean;
+    checkedRecords: number;
+    invalidAssociatedShapes: number;
+    issues: Array<{
+        recordId: string;
+        property: string;
+        message: string;
+    }>;
+};
+export type AssociationPlanResult = {
+    report: AssociationReport;
+    planFingerprint: string;
+    updates: PlannedUpdate[];
+    failures: PlannedFailure[];
+};
+export type AssociationApplyResult = {
+    report: AssociationReport;
+    applied: boolean;
+};
+export type PlannedUpdate = {
+    db: string;
+    collection: string;
+    id: string;
+    operation: {
+        updateOne: {
+            filter: {
+                _id: unknown;
+            };
+            update: {
+                $set?: Record<string, unknown>;
+                $unset?: Record<string, "">;
+            };
+        };
+    };
+};
+export type PlannedFailure = {
+    db: string;
+    collection: string;
+    filter: {
+        recordId: string;
+    };
+    record: AssociationFailureRecord;
+};
+export type AssociatedPropertySource = "managed" | "discovered" | "both";
+export type AssociatedPropertyValueShape = "array<object>" | "array<unknown>" | "unknown";
+export type ManagedAssociatedProperty = {
+    name: string;
+    contentType: "snapshots";
+    kind: "associated";
+    valueShape?: AssociatedPropertyValueShape;
+    linkedObjectType?: string;
+    linkedContentType?: string;
+    description?: string;
+    managed: true;
+};
+export type DiscoveredAssociatedProperty = {
+    name: string;
+    contentType: "snapshots";
+    kind: "associated";
+    valueShape?: AssociatedPropertyValueShape;
+    managed: false;
+    observedPath: string;
+    observedCount: number;
+};
+export type AssociatedPropertyDescriptor = {
+    name: string;
+    contentType: "snapshots";
+    kind: "associated";
+    valueShape?: AssociatedPropertyValueShape;
+    linkedObjectType?: string;
+    linkedContentType?: string;
+    description?: string;
+    managed: boolean;
+    source: AssociatedPropertySource;
+    observedPath?: string;
+    observedCount?: number;
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/request/schema.d.ts.map

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

package/dist/request/schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/request/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/request/schema.ts"],"names":[],"mappings":""}

package/dist/request/validate.d.ts

@@ -0,0 +1,6 @@
+import type { MemorixAssociationRequest } from "./schema.js";
+export declare class AssociationRequestValidationError extends Error {
+    constructor(message: string);
+}
+export declare function validateAssociationRequest(request: MemorixAssociationRequest): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/request/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/request/validate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,yBAAyB,EAAqB,MAAM,aAAa,CAAC;AAEjG,qBAAa,iCAAkC,SAAQ,KAAK;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAwCD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAgCnF"}