@x12i/memorix-resolvers 1.0.0

package/README.md

@@ -0,0 +1,59 @@
+# @x12i/memorix-resolvers
+
+Pluggable resolver APIs for Memorix. Resolvers normalize join keys, bridge lookups, and domain-specific relationship signals without baking domain knowledge into the engine.
+
+## Design
+
+- **Resolver registry** — register built-in and custom resolver types.
+- **Resolver steps** — run one or more resolvers against a source record.
+- **Domain plug-ins** — networking, pharma, marketing, identity, or any future domain implements the same `ResolverDefinition` API.
+
+The engine does not branch on resolver type. A CIDR containment resolver, pharma SKU resolver, and marketing campaign resolver are all ordinary plug-ins.
+
+## Usage
+
+```typescript
+import {
+  createResolverRegistry,
+  builtinResolvers,
+  runResolverSteps,
+  type ResolverDefinition,
+} from "@x12i/memorix-resolvers";
+
+const registry = createResolverRegistry(builtinResolvers);
+
+const myResolver: ResolverDefinition<{ outputPath: string }> = {
+  type: "my-domain",
+  create(config) {
+    return {
+      async resolve(input) {
+        return {
+          outputs: [{ path: config.outputPath, values: ["resolved"] }],
+          stats: { inputsScanned: 1, valuesParsed: 1, valuesRejected: 0, matchesFound: 1, ambiguousMatches: 0 },
+          diagnostics: [],
+        };
+      },
+    };
+  },
+};
+
+registry.register(myResolver);
+
+const result = await runResolverSteps(registry, {
+  steps: [{ type: "my-domain", resolverKey: "step-1", config: { outputPath: "data.key" } }],
+  record: { data: {} },
+});
+```
+
+## Built-in resolvers
+
+| Type | Purpose |
+|------|---------|
+| `exact-match` | Copy normalized values from source paths to an output path |
+| `multi-value` | Split comma-separated scalars into array fields |
+| `bridge-index` | Map readable keys through a bridge collection to target join keys |
+
+## Related packages
+
+- [`@x12i/memorix-associator`](../memorix-associator/) — plans and applies association materialization using resolver output.
+- [Operational design note](../memorix-schema-api/src/operational/memorix-enrichment-processes.md) — original enrichment process specification.

package/dist/builtins/index.d.ts

@@ -0,0 +1,26 @@
+import type { ResolverDefinition } from "../types.js";
+export type ExactMatchConfig = {
+    sourcePaths: string[];
+    outputPath: string;
+};
+export declare const exactMatchResolver: ResolverDefinition<ExactMatchConfig>;
+export type MultiValueConfig = {
+    from: string[];
+    to: string;
+    separators?: string[];
+    deduplicate?: boolean;
+};
+export declare const multiValueResolver: ResolverDefinition<MultiValueConfig>;
+export type BridgeIndexConfig = {
+    bridge: {
+        db: string;
+        collection: string;
+        sourceJoinPaths: string[];
+        targetJoinPath: string;
+    };
+    sourcePaths: string[];
+    outputPath: string;
+};
+export declare const bridgeIndexResolver: ResolverDefinition<BridgeIndexConfig>;
+export declare const builtinResolvers: ResolverDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/builtins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builtins/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,kBAAkB,CAAC,gBAAgB,CAgCnE,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,kBAAkB,CAAC,gBAAgB,CAqDnE,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,kBAAkB,CAAC,iBAAiB,CAsErE,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EAIhD,CAAC"}

package/dist/builtins/index.js

@@ -0,0 +1,157 @@
+import { getByPath, isPlainObject, normalizeJoinValues } from "../utils.js";
+export const exactMatchResolver = {
+    type: "exact-match",
+    create(config) {
+        const sourcePaths = config.sourcePaths ?? [];
+        const outputPath = config.outputPath;
+        return {
+            async resolve(input) {
+                const values = [];
+                for (const path of sourcePaths) {
+                    values.push(...normalizeJoinValues(getByPath(input.record, path)));
+                }
+                const normalized = normalizeJoinValues(values);
+                const outputs = outputPath && normalized.length > 0
+                    ? [{ path: outputPath, values: normalized }]
+                    : [];
+                return {
+                    outputs,
+                    stats: {
+                        inputsScanned: 1,
+                        valuesParsed: normalized.length,
+                        valuesRejected: sourcePaths.length > 0 && normalized.length === 0 ? 1 : 0,
+                        matchesFound: normalized.length,
+                        ambiguousMatches: 0,
+                    },
+                    diagnostics: [],
+                };
+            },
+        };
+    },
+};
+export const multiValueResolver = {
+    type: "multi-value",
+    create(config) {
+        const from = config.from ?? [];
+        const to = config.to;
+        const separators = config.separators ?? [","];
+        const deduplicate = config.deduplicate !== false;
+        return {
+            async resolve(input) {
+                const raw = [];
+                for (const path of from) {
+                    raw.push(...normalizeJoinValues(getByPath(input.record, path)));
+                }
+                const expanded = [];
+                for (const value of raw) {
+                    if (typeof value === "string" && separators.some((sep) => value.includes(sep))) {
+                        for (const part of value.split(new RegExp(separators.map((s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|")))) {
+                            const trimmed = part.trim();
+                            if (trimmed)
+                                expanded.push(trimmed);
+                        }
+                    }
+                    else if (value !== undefined && value !== null && value !== "") {
+                        expanded.push(value);
+                    }
+                }
+                let values = expanded;
+                if (deduplicate) {
+                    const seen = new Set();
+                    values = [];
+                    for (const item of expanded) {
+                        const key = JSON.stringify(item);
+                        if (seen.has(key))
+                            continue;
+                        seen.add(key);
+                        values.push(item);
+                    }
+                }
+                return {
+                    outputs: to ? [{ path: to, values }] : [],
+                    stats: {
+                        inputsScanned: 1,
+                        valuesParsed: values.length,
+                        valuesRejected: values.length === 0 ? 1 : 0,
+                        matchesFound: values.length,
+                        ambiguousMatches: 0,
+                    },
+                    diagnostics: [],
+                };
+            },
+        };
+    },
+};
+export const bridgeIndexResolver = {
+    type: "bridge-index",
+    create(config, context) {
+        let bridgeCache = null;
+        async function loadBridge() {
+            if (bridgeCache)
+                return bridgeCache;
+            bridgeCache = new Map();
+            if (!context.scanRecords) {
+                return bridgeCache;
+            }
+            const bridge = config.bridge;
+            for await (const doc of context.scanRecords({
+                db: bridge.db,
+                collection: bridge.collection,
+            })) {
+                const targetValue = getByPath(doc, bridge.targetJoinPath);
+                if (targetValue === undefined || targetValue === null || targetValue === "")
+                    continue;
+                for (const sourcePath of bridge.sourceJoinPaths) {
+                    for (const sourceValue of normalizeJoinValues(getByPath(doc, sourcePath))) {
+                        const key = JSON.stringify(sourceValue);
+                        const bucket = bridgeCache.get(key) ?? [];
+                        bucket.push(targetValue);
+                        bridgeCache.set(key, bucket);
+                    }
+                }
+            }
+            return bridgeCache;
+        }
+        return {
+            async resolve(input) {
+                const bridge = await loadBridge();
+                const sourceValues = [];
+                for (const path of config.sourcePaths) {
+                    sourceValues.push(...normalizeJoinValues(getByPath(input.record, path)));
+                }
+                const resolved = [];
+                for (const sourceValue of sourceValues) {
+                    const bridged = bridge.get(JSON.stringify(sourceValue)) ?? [];
+                    resolved.push(...bridged);
+                }
+                const values = normalizeJoinValues(resolved);
+                return {
+                    outputs: values.length > 0 ? [{ path: config.outputPath, values }] : [],
+                    stats: {
+                        inputsScanned: 1,
+                        valuesParsed: sourceValues.length,
+                        valuesRejected: sourceValues.length > 0 && values.length === 0 ? 1 : 0,
+                        matchesFound: values.length,
+                        ambiguousMatches: values.length > sourceValues.length ? values.length - sourceValues.length : 0,
+                    },
+                    diagnostics: bridge.size === 0
+                        ? [
+                            {
+                                level: "warning",
+                                code: "BRIDGE_EMPTY",
+                                message: "Bridge index produced no entries",
+                                details: { bridge: config.bridge },
+                            },
+                        ]
+                        : [],
+                };
+            },
+        };
+    },
+};
+export const builtinResolvers = [
+    exactMatchResolver,
+    multiValueResolver,
+    bridgeIndexResolver,
+];
+//# sourceMappingURL=index.js.map

package/dist/builtins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builtins/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAO5E,MAAM,CAAC,MAAM,kBAAkB,GAAyC;IACtE,IAAI,EAAE,aAAa;IACnB,MAAM,CAAC,MAAM;QACb,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAErC,OAAO;YACL,KAAK,CAAC,OAAO,CAAC,KAAK;gBACjB,MAAM,MAAM,GAAgB,EAAE,CAAC;gBAC/B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;oBAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;gBACrE,CAAC;gBACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;gBAC/C,MAAM,OAAO,GACX,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;oBACjC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;oBAC5C,CAAC,CAAC,EAAE,CAAC;gBAET,OAAO;oBACL,OAAO;oBACP,KAAK,EAAE;wBACL,aAAa,EAAE,CAAC;wBAChB,YAAY,EAAE,UAAU,CAAC,MAAM;wBAC/B,cAAc,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBACzE,YAAY,EAAE,UAAU,CAAC,MAAM;wBAC/B,gBAAgB,EAAE,CAAC;qBACpB;oBACD,WAAW,EAAE,EAAE;iBAChB,CAAC;YACJ,CAAC;SACF,CAAC;IACF,CAAC;CACF,CAAC;AASF,MAAM,CAAC,MAAM,kBAAkB,GAAyC;IACtE,IAAI,EAAE,aAAa;IACnB,MAAM,CAAC,MAAM;QACX,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,KAAK,KAAK,CAAC;QAEjD,OAAO;YACL,KAAK,CAAC,OAAO,CAAC,KAAK;gBACjB,MAAM,GAAG,GAAgB,EAAE,CAAC;gBAC5B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;oBACxB,GAAG,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClE,CAAC;gBAED,MAAM,QAAQ,GAAgB,EAAE,CAAC;gBACjC,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;oBACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;wBAC/E,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;4BACtH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;4BAC5B,IAAI,OAAO;gCAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;wBACtC,CAAC;oBACH,CAAC;yBAAM,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;wBACjE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACvB,CAAC;gBACH,CAAC;gBAED,IAAI,MAAM,GAAG,QAAQ,CAAC;gBACtB,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;oBAC/B,MAAM,GAAG,EAAE,CAAC;oBACZ,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;wBAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;wBACjC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;4BAAE,SAAS;wBAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;wBACd,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,CAAC;gBACH,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;oBACzC,KAAK,EAAE;wBACL,aAAa,EAAE,CAAC;wBAChB,YAAY,EAAE,MAAM,CAAC,MAAM;wBAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBAC3C,YAAY,EAAE,MAAM,CAAC,MAAM;wBAC3B,gBAAgB,EAAE,CAAC;qBACpB;oBACD,WAAW,EAAE,EAAE;iBAChB,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAaF,MAAM,CAAC,MAAM,mBAAmB,GAA0C;IACxE,IAAI,EAAE,cAAc;IACpB,MAAM,CAAC,MAAM,EAAE,OAAO;QACpB,IAAI,WAAW,GAAoC,IAAI,CAAC;QAExD,KAAK,UAAU,UAAU;YACvB,IAAI,WAAW;gBAAE,OAAO,WAAW,CAAC;YACpC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBACzB,OAAO,WAAW,CAAC;YACrB,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC7B,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;gBAC1C,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,EAAE,CAAC;gBACH,MAAM,WAAW,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;gBAC1D,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,EAAE;oBAAE,SAAS;gBACtF,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;oBAChD,KAAK,MAAM,WAAW,IAAI,mBAAmB,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;wBAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;wBACxC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;wBAC1C,MAAM,CAAC,IAAI,CAAC,WAAwB,CAAC,CAAC;wBACtC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,OAAO;YACL,KAAK,CAAC,OAAO,CAAC,KAAK;gBACjB,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;gBAClC,MAAM,YAAY,GAAgB,EAAE,CAAC;gBACrC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;oBACtC,YAAY,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC3E,CAAC;gBAED,MAAM,QAAQ,GAAgB,EAAE,CAAC;gBACjC,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;oBACvC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC9D,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;gBAC5B,CAAC;gBACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;gBAE7C,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;oBACvE,KAAK,EAAE;wBACL,aAAa,EAAE,CAAC;wBAChB,YAAY,EAAE,YAAY,CAAC,MAAM;wBACjC,cAAc,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBACtE,YAAY,EAAE,MAAM,CAAC,MAAM;wBAC3B,gBAAgB,EAAE,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;qBAChG;oBACD,WAAW,EACT,MAAM,CAAC,IAAI,KAAK,CAAC;wBACf,CAAC,CAAC;4BACE;gCACE,KAAK,EAAE,SAAS;gCAChB,IAAI,EAAE,cAAc;gCACpB,OAAO,EAAE,kCAAkC;gCAC3C,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;6BACnC;yBACF;wBACH,CAAC,CAAC,EAAE;iBACT,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAyB;IACpD,kBAAkB;IAClB,kBAAkB;IAClB,mBAAmB;CACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { JsonObject, JsonPrimitive, JsonValue, RecordRef, Resolver, ResolverContext, ResolverDefinition, ResolverDiagnostic, ResolverDiagnosticLevel, ResolverInput, ResolverOutputValue, ResolverResult, ResolverStats, ResolverStep, ResolverStepResult, RunResolverStepsOptions, RunResolverStepsResult, } from "./types.js";
+export { ResolverRegistry, createResolverRegistry } from "./registry.js";
+export { runResolverSteps } from "./run.js";
+export { builtinResolvers, exactMatchResolver, multiValueResolver, bridgeIndexResolver, type ExactMatchConfig, type MultiValueConfig, type BridgeIndexConfig, } from "./builtins/index.js";
+export { getByPath, setByPath, isPlainObject, isMissingJoinValue, normalizeJoinValues, isAssociatedPropertyName, } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACT,SAAS,EACT,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,SAAS,EACT,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { ResolverRegistry, createResolverRegistry } from "./registry.js";
+export { runResolverSteps } from "./run.js";
+export { builtinResolvers, exactMatchResolver, multiValueResolver, bridgeIndexResolver, } from "./builtins/index.js";
+export { getByPath, setByPath, isPlainObject, isMissingJoinValue, normalizeJoinValues, isAssociatedPropertyName, } from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,SAAS,EACT,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,12 @@
+import type { ResolverDefinition } from "./types.js";
+export declare class ResolverRegistry {
+    private readonly definitions;
+    register<TConfig = unknown>(definition: ResolverDefinition<TConfig>): this;
+    registerMany(definitions: ResolverDefinition[]): this;
+    has(type: string): boolean;
+    get(type: string): ResolverDefinition | undefined;
+    listTypes(): string[];
+    create(type: string, config: unknown, context: Parameters<ResolverDefinition["create"]>[1]): import("./types.js").Resolver;
+}
+export declare function createResolverRegistry(definitions?: ResolverDefinition[]): ResolverRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IAErE,QAAQ,CAAC,OAAO,GAAG,OAAO,EAAE,UAAU,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,IAAI;IAQ1E,YAAY,CAAC,WAAW,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAOrD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD,SAAS,IAAI,MAAM,EAAE;IAIrB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAO3F;AAED,wBAAgB,sBAAsB,CAAC,WAAW,GAAE,kBAAkB,EAAO,GAAG,gBAAgB,CAG/F"}

package/dist/registry.js

@@ -0,0 +1,37 @@
+export class ResolverRegistry {
+    definitions = new Map();
+    register(definition) {
+        if (this.definitions.has(definition.type)) {
+            throw new Error(`Resolver type already registered: ${definition.type}`);
+        }
+        this.definitions.set(definition.type, definition);
+        return this;
+    }
+    registerMany(definitions) {
+        for (const definition of definitions) {
+            this.register(definition);
+        }
+        return this;
+    }
+    has(type) {
+        return this.definitions.has(type);
+    }
+    get(type) {
+        return this.definitions.get(type);
+    }
+    listTypes() {
+        return [...this.definitions.keys()].sort();
+    }
+    create(type, config, context) {
+        const definition = this.definitions.get(type);
+        if (!definition) {
+            throw new Error(`Unknown resolver type: ${type}`);
+        }
+        return definition.create(config, context);
+    }
+}
+export function createResolverRegistry(definitions = []) {
+    const registry = new ResolverRegistry();
+    return registry.registerMany(definitions);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IACV,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;IAErE,QAAQ,CAAoB,UAAuC;QACjE,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,qCAAqC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAgC,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,WAAiC;QAC5C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,MAAe,EAAE,OAAoD;QACxF,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,cAAoC,EAAE;IAC3E,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACxC,OAAO,QAAQ,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;AAC5C,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,4 @@
+import type { RunResolverStepsOptions, RunResolverStepsResult } from "./types.js";
+import type { ResolverRegistry } from "./registry.js";
+export declare function runResolverSteps(registry: ResolverRegistry, options: RunResolverStepsOptions): Promise<RunResolverStepsResult>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAkBtD,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAsCjC"}

package/dist/run.js

@@ -0,0 +1,49 @@
+function emptyStats() {
+    return {
+        inputsScanned: 0,
+        valuesParsed: 0,
+        valuesRejected: 0,
+        matchesFound: 0,
+        ambiguousMatches: 0,
+    };
+}
+function mergeStats(target, source) {
+    for (const [key, value] of Object.entries(source)) {
+        target[key] = (target[key] ?? 0) + value;
+    }
+}
+export async function runResolverSteps(registry, options) {
+    const mergedOutputs = new Map();
+    const stats = emptyStats();
+    const diagnostics = [];
+    const steps = [];
+    for (let stepIndex = 0; stepIndex < options.steps.length; stepIndex += 1) {
+        const step = options.steps[stepIndex];
+        const context = {
+            resolverKey: step.resolverKey,
+            stepIndex,
+            readRecord: options.context?.readRecord,
+            scanRecords: options.context?.scanRecords,
+        };
+        const resolver = registry.create(step.type, step.config ?? {}, context);
+        const result = await resolver.resolve({
+            record: options.record,
+            recordId: options.recordId,
+            config: step.config ?? {},
+        });
+        steps.push({ resolverKey: step.resolverKey, type: step.type, result });
+        mergeStats(stats, result.stats);
+        diagnostics.push(...result.diagnostics);
+        for (const output of result.outputs) {
+            const existing = mergedOutputs.get(output.path) ?? [];
+            mergedOutputs.set(output.path, [...existing, ...output.values]);
+        }
+    }
+    return {
+        steps,
+        mergedOutputs: mergedOutputs,
+        stats,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AASA,SAAS,UAAU;IACjB,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,CAAC;QACf,cAAc,EAAE,CAAC;QACjB,YAAY,EAAE,CAAC;QACf,gBAAgB,EAAE,CAAC;KACpB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,MAAqB,EAAE,MAAqB;IAC9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAA0B,EAC1B,OAAgC;IAEhC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAqB,CAAC;IACnD,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,WAAW,GAAyB,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAoC,EAAE,CAAC;IAElD,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAE,CAAC;QACvC,MAAM,OAAO,GAAoB;YAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS;YACT,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,UAAU;YACvC,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW;SAC1C,CAAC;QAEF,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;YACpC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;SAC1B,CAAC,CAAC;QAEH,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACvE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAExC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACtD,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;QACL,aAAa,EAAE,aAAwD;QACvE,KAAK;QACL,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type ResolverDiagnosticLevel = "info" | "warning" | "error";
+export type ResolverDiagnostic = {
+    level: ResolverDiagnosticLevel;
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+};
+export type ResolverStats = {
+    inputsScanned: number;
+    valuesParsed: number;
+    valuesRejected: number;
+    matchesFound: number;
+    ambiguousMatches: number;
+    [key: string]: number;
+};
+export type ResolverContext = {
+    resolverKey: string;
+    stepIndex: number;
+    /** Optional store for resolvers that need to read related records */
+    readRecord?: (ref: RecordRef) => Promise<JsonObject | null>;
+    scanRecords?: (ref: RecordRef, filter?: Record<string, unknown>) => AsyncIterable<JsonObject>;
+};
+export type RecordRef = {
+    db: string;
+    collection: string;
+};
+export type ResolverInput = {
+    record: JsonObject;
+    recordId?: string;
+    config: unknown;
+};
+export type ResolverOutputValue = {
+    path: string;
+    values: JsonValue[];
+};
+export type ResolverResult = {
+    outputs: ResolverOutputValue[];
+    stats: ResolverStats;
+    diagnostics: ResolverDiagnostic[];
+};
+export type Resolver = {
+    resolve(input: ResolverInput): Promise<ResolverResult>;
+};
+export type ResolverDefinition<TConfig = unknown> = {
+    type: string;
+    create(config: TConfig, context: ResolverContext): Resolver;
+};
+export type ResolverStep = {
+    type: string;
+    resolverKey: string;
+    config?: unknown;
+};
+export type ResolverStepResult = {
+    resolverKey: string;
+    type: string;
+    result: ResolverResult;
+};
+export type RunResolverStepsOptions = {
+    steps: ResolverStep[];
+    record: JsonObject;
+    recordId?: string;
+    context?: Partial<ResolverContext>;
+};
+export type RunResolverStepsResult = {
+    steps: ResolverStepResult[];
+    mergedOutputs: Map<string, JsonValue[]>;
+    stats: ResolverStats;
+    diagnostics: ResolverDiagnostic[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,uBAAuB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC5D,WAAW,CAAC,EAAE,CACZ,GAAG,EAAE,SAAS,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,aAAa,CAAC,UAAU,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,OAAO,GAAG,OAAO,IAAI;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACxC,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC,CAAC"}

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,8 @@
+import type { JsonValue } from "./types.js";
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function getByPath(obj: unknown, path: string): unknown;
+export declare function setByPath(obj: Record<string, unknown>, path: string, value: unknown): void;
+export declare function isMissingJoinValue(value: unknown): boolean;
+export declare function normalizeJoinValues(value: unknown): JsonValue[];
+export declare function isAssociatedPropertyName(name: string): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAU7D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAY1F;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAAE,CAM/D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D"}

package/dist/utils.js

@@ -0,0 +1,45 @@
+export function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function getByPath(obj, path) {
+    if (!path)
+        return obj;
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current === undefined || current === null)
+            return undefined;
+        if (!isPlainObject(current) && !Array.isArray(current))
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+export function setByPath(obj, path, value) {
+    const parts = path.split(".");
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i += 1) {
+        const part = parts[i];
+        const next = current[part];
+        if (!isPlainObject(next)) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+export function isMissingJoinValue(value) {
+    return value === undefined || value === null || value === "";
+}
+export function normalizeJoinValues(value) {
+    if (isMissingJoinValue(value))
+        return [];
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => normalizeJoinValues(item));
+    }
+    return [value];
+}
+export function isAssociatedPropertyName(name) {
+    return name.startsWith("associated");
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,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,SAAS,CAAC,GAAY,EAAE,IAAY;IAClD,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAY,GAAG,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QAChE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO,SAAS,CAAC;QACzE,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAA4B,EAAE,IAAY,EAAE,KAAc;IAClF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,OAAO,GAA4B,GAAG,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,IAAI,CAA4B,CAAC;IACrD,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,KAAkB,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,kBAAkB,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,CAAC,KAAkB,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACvC,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@x12i/memorix-resolvers",
+  "version": "1.0.0",
+  "description": "Pluggable resolver APIs for Memorix — normalize join keys, bridge lookups, and domain-specific relationship resolution",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/x12i/memorix-mono-repo.git",
+    "directory": "memorix-resolvers"
+  },
+  "keywords": [
+    "memorix",
+    "resolvers",
+    "join",
+    "enrichment"
+  ],
+  "license": "exellix-license"
+}