ruleforge 0.1.0

package/dist/core/RuleEngine.js

@@ -0,0 +1,168 @@
+import { err } from "./Errors.js";
+import { setByDotPath } from "./OutputBuilder.js";
+import { TransformRegistry } from "../transforms/TransformRegistry.js";
+import { resolvePath } from "../resolvers/PathResolver.js";
+import { bindSelectorsV1, applyBindingsToMappings, applyBindingsToPath, } from "./SelectorEngine.js";
+export async function runRules(spec, fn, ns, ctx, allowBarePaths, inputType) {
+    const out = {};
+    const matched = {};
+    const metaBase = {
+        inputType,
+        pre: ns.pre,
+        matched,
+    };
+    const resolverOpts = {
+        allowBarePaths,
+        aliases: spec.aliases ?? {},
+    };
+    const namespaces = {
+        payload: ns.payload,
+        meta: ns.meta,
+        pre: ns.pre,
+    };
+    const transforms = new TransformRegistry(fn.transforms);
+    for (const [targetKey, ruleDef] of Object.entries(spec.rules ?? {})) {
+        const entries = Array.isArray(ruleDef)
+            ? ruleDef
+            : [ruleDef];
+        const anyRequired = entries.some((e) => e.required === true);
+        let matchedAnyRule = false;
+        for (let i = 0; i < entries.length; i++) {
+            const entry = entries[i];
+            // -------------------------
+            // 1️⃣ Bind selectors
+            // -------------------------
+            let bindings;
+            const sel = bindSelectorsV1(entry, {
+                ns: namespaces,
+                resolveOpts: resolverOpts,
+            });
+            if (!sel.ok) {
+                const e = err("INVALID_SELECTOR_ROOT", sel.error.message, { targetKey, ruleIndex: i }, targetKey);
+                return { ok: false, result: { ok: false, error: e, meta: metaBase } };
+            }
+            if (sel.result.kind === "bound") {
+                bindings = sel.result.bindings;
+            }
+            // -------------------------
+            // 2️⃣ Evaluate conditions
+            // -------------------------
+            if (!conditionsMatch(entry, namespaces, resolverOpts, bindings)) {
+                continue;
+            }
+            matchedAnyRule = true;
+            // -------------------------
+            // 3️⃣ Constant value support
+            // -------------------------
+            if ("value" in entry && entry.value !== undefined) {
+                setByDotPath(out, targetKey, entry.value);
+                matched[targetKey] = {
+                    ruleIndex: i,
+                    mappingPath: "(value)",
+                    selector: bindings ? sanitizeSelector(bindings) : undefined,
+                };
+                break; // stop at first matched rule
+            }
+            // -------------------------
+            // 4️⃣ Resolve mappings (fallback list)
+            // -------------------------
+            const mappings = entry.mappings ?? [];
+            const mres = resolveMappings(mappings, namespaces, resolverOpts, transforms, ctx, bindings);
+            if (!mres.ok) {
+                const e = err("TRANSFORM_ERROR", mres.error.message, mres.error.details, targetKey);
+                return { ok: false, result: { ok: false, error: e, meta: metaBase } };
+            }
+            if (mres.valueFound) {
+                setByDotPath(out, targetKey, mres.value);
+                matched[targetKey] = {
+                    ruleIndex: i,
+                    mappingPath: mres.usedPath,
+                    selector: bindings ? sanitizeSelector(bindings) : undefined,
+                };
+                break;
+            }
+            // -------------------------
+            // 5️⃣ Required but no value
+            // -------------------------
+            if (entry.required) {
+                const e = err("MISSING_REQUIRED_FIELD", `Required field '${targetKey}' matched rule ${i} but no mapping/value produced a result`, { attempted: mappings }, targetKey);
+                return { ok: false, result: { ok: false, error: e, meta: metaBase } };
+            }
+            // Rule matched but produced no value and not required → stop evaluation
+            matched[targetKey] = {
+                ruleIndex: i,
+                mappingPath: "",
+                selector: bindings ? sanitizeSelector(bindings) : undefined,
+            };
+            break;
+        }
+        // -------------------------
+        // 6️⃣ Required but no rule matched at all
+        // -------------------------
+        if (anyRequired && !matchedAnyRule) {
+            const e = err("NO_RULE_MATCHED_REQUIRED", `Required field '${targetKey}' did not match any rule entry`, { targetKey }, targetKey);
+            return { ok: false, result: { ok: false, error: e, meta: metaBase } };
+        }
+    }
+    return { ok: true, value: out, meta: metaBase };
+}
+function conditionsMatch(entry, ns, resolverOpts, bindings) {
+    const cond = entry.conditions ?? {};
+    const keys = Object.keys(cond);
+    if (keys.length === 0)
+        return true;
+    for (const k of keys) {
+        const expected = cond[k];
+        const kk = bindings ? applyBindingsToPath(k, bindings) : k;
+        // If still unresolved selector tokens remain, treat as no match.
+        if (kk.includes(".$X1") || kk.includes(".$X2"))
+            return false;
+        const r = resolvePath(ns, kk, resolverOpts);
+        if (!matchesExpected(r.value, expected))
+            return false;
+    }
+    return true;
+}
+function matchesExpected(actual, expected) {
+    if (Array.isArray(expected)) {
+        return expected.includes(actual);
+    }
+    return actual === expected;
+}
+function resolveMappings(mappings, ns, resolverOpts, transforms, ctx, bindings) {
+    const m2 = bindings ? applyBindingsToMappings(mappings, bindings) : mappings;
+    let lastUsed = "";
+    for (const m of m2) {
+        const path = typeof m === "string" ? m : m.path;
+        const transformNames = typeof m === "string" ? undefined : m.transform;
+        if (path.includes(".$X1") || path.includes(".$X2"))
+            continue;
+        const r = resolvePath(ns, path, resolverOpts);
+        lastUsed = r.usedPath;
+        if (r.value === undefined)
+            continue;
+        try {
+            const v = transforms.apply(r.value, transformNames, ctx);
+            return { ok: true, valueFound: true, value: v, usedPath: r.usedPath };
+        }
+        catch (e) {
+            return {
+                ok: false,
+                error: {
+                    message: e?.message ?? String(e),
+                    details: { path, transformNames },
+                },
+            };
+        }
+    }
+    return { ok: true, valueFound: false, usedPath: lastUsed };
+}
+function sanitizeSelector(bindings) {
+    const out = {};
+    for (const [k, v] of Object.entries(bindings)) {
+        if (typeof v === "number")
+            out[k] = v;
+    }
+    return out;
+}
+//# sourceMappingURL=RuleEngine.js.map

package/dist/core/RuleEngine.js.map

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

package/dist/core/SelectorEngine.d.ts

@@ -0,0 +1,36 @@
+import type { RuleEntryV1, MappingV1 } from "../types/spec.js";
+import type { Namespaces, ResolveOptions } from "../resolvers/PathResolver.js";
+export type SelectorVar = "$X1" | "$X2";
+export type SelectorBindings = Partial<Record<SelectorVar, number>>;
+export type SelectorOutcome = {
+    kind: "none";
+} | {
+    kind: "bound";
+    bindings: SelectorBindings;
+    roots: Partial<Record<SelectorVar, string>>;
+};
+export interface SelectorContext {
+    ns: Namespaces;
+    resolveOpts: ResolveOptions;
+}
+/**
+ * Binds $X1 (outer) then $X2 (nested) using conditions (AND equals-to-constant).
+ *
+ * Example conditions:
+ *  - customers.$X1.fleet.id = "fleetId_5"
+ *  - customers.$X1.devices.$X2.id = "deviceId_1"
+ *
+ * Binding:
+ *  - bind $X1 using pure-$X1 conditions
+ *  - bind $X2 using conditions containing $X2 (after $X1 is bound)
+ */
+export declare function bindSelectorsV1(entry: RuleEntryV1, ctx: SelectorContext): {
+    ok: true;
+    result: SelectorOutcome;
+} | {
+    ok: false;
+    error: Error;
+};
+export declare function applyBindingsToPath(path: string, bindings: SelectorBindings): string;
+export declare function applyBindingsToMappings(mappings: ReadonlyArray<MappingV1>, bindings: SelectorBindings): MappingV1[];
+//# sourceMappingURL=SelectorEngine.d.ts.map

package/dist/core/SelectorEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectorEngine.d.ts","sourceRoot":"","sources":["../../src/core/SelectorEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG/E,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,CAAC;AACxC,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AAEpE,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;CAC7C,CAAC;AAEN,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,UAAU,CAAC;IACf,WAAW,EAAE,cAAc,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,eAAe,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAkFrE;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,GACzB,MAAM,CAaR;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,EAClC,QAAQ,EAAE,gBAAgB,GACzB,SAAS,EAAE,CAMb"}

package/dist/core/SelectorEngine.js

@@ -0,0 +1,186 @@
+import { resolvePath } from "../resolvers/PathResolver.js";
+/**
+ * Binds $X1 (outer) then $X2 (nested) using conditions (AND equals-to-constant).
+ *
+ * Example conditions:
+ *  - customers.$X1.fleet.id = "fleetId_5"
+ *  - customers.$X1.devices.$X2.id = "deviceId_1"
+ *
+ * Binding:
+ *  - bind $X1 using pure-$X1 conditions
+ *  - bind $X2 using conditions containing $X2 (after $X1 is bound)
+ */
+export function bindSelectorsV1(entry, ctx) {
+    try {
+        const conditions = entry.conditions ?? {};
+        const keys = Object.keys(conditions);
+        const usedVars = detectUsedVars(keys);
+        if (usedVars.size === 0)
+            return { ok: true, result: { kind: "none" } };
+        for (const v of usedVars) {
+            if (v !== "$X1" && v !== "$X2")
+                throw new Error(`Unsupported selector var in v1: ${v}`);
+        }
+        const roots = detectRoots(keys);
+        const bindings = {};
+        // 0) evaluate fixed (no vars) conditions first
+        const fixedKeys = keys.filter((k) => !containsVar(k, "$X1") && !containsVar(k, "$X2"));
+        for (const k of fixedKeys) {
+            const expected = conditions[k];
+            const r = resolvePath(ctx.ns, k, ctx.resolveOpts);
+            if (!matchesExpected(r.value, expected))
+                return { ok: true, result: { kind: "none" } };
+        }
+        // 1) bind $X1 if used
+        if (usedVars.has("$X1")) {
+            const x1Root = roots["$X1"];
+            if (!x1Root)
+                throw new Error("Internal: $X1 used but root not found");
+            const x1Keys = keys.filter((k) => containsVar(k, "$X1") && !containsVar(k, "$X2"));
+            if (x1Keys.length === 0)
+                return { ok: true, result: { kind: "none" } };
+            const x1 = bindVarByScanningRoot("$X1", x1Root, x1Keys, conditions, bindings, ctx);
+            if (x1 == null)
+                return { ok: true, result: { kind: "none" } };
+            bindings["$X1"] = x1;
+        }
+        // 2) bind $X2 if used
+        if (usedVars.has("$X2")) {
+            const x2RootRaw = roots["$X2"];
+            if (!x2RootRaw)
+                throw new Error("Internal: $X2 used but root not found");
+            const x2Root = applyBindingsToPath(x2RootRaw, bindings);
+            const x2Keys = keys.filter((k) => containsVar(k, "$X2"));
+            const x2 = bindVarByScanningRoot("$X2", x2Root, x2Keys, conditions, bindings, ctx);
+            if (x2 == null)
+                return { ok: true, result: { kind: "none" } };
+            bindings["$X2"] = x2;
+        }
+        // 3) final verify: all conditions with bindings applied
+        for (const k of keys.filter((k) => containsAnyVar(k))) {
+            const expected = conditions[k];
+            const kk = applyBindingsToPath(k, bindings);
+            const r = resolvePath(ctx.ns, kk, ctx.resolveOpts);
+            if (!matchesExpected(r.value, expected))
+                return { ok: true, result: { kind: "none" } };
+        }
+        return { ok: true, result: { kind: "bound", bindings, roots } };
+    }
+    catch (e) {
+        return { ok: false, error: e instanceof Error ? e : new Error(String(e)) };
+    }
+}
+export function applyBindingsToPath(path, bindings) {
+    let out = path;
+    if (bindings["$X1"] !== undefined) {
+        out = out
+            .replaceAll(".$X1.", `.${bindings["$X1"]}.`)
+            .replaceAll(".$X1", `.${bindings["$X1"]}`);
+    }
+    if (bindings["$X2"] !== undefined) {
+        out = out
+            .replaceAll(".$X2.", `.${bindings["$X2"]}.`)
+            .replaceAll(".$X2", `.${bindings["$X2"]}`);
+    }
+    return out;
+}
+export function applyBindingsToMappings(mappings, bindings) {
+    return mappings.map((m) => {
+        if (typeof m === "string")
+            return applyBindingsToPath(m, bindings);
+        const mm = m;
+        return { ...mm, path: applyBindingsToPath(mm.path, bindings) };
+    });
+}
+/** ---------- internals ---------- */
+function detectUsedVars(keys) {
+    const s = new Set();
+    for (const k of keys) {
+        if (containsVar(k, "$X1"))
+            s.add("$X1");
+        if (containsVar(k, "$X2"))
+            s.add("$X2");
+    }
+    return s;
+}
+/**
+ * Root per variable:
+ *  - customers.$X1.fleet.id  => $X1 root = "customers"
+ *  - customers.$X1.devices.$X2.id => $X2 root = "customers.$X1.devices"
+ */
+function detectRoots(keys) {
+    const roots = {};
+    for (const k of keys) {
+        const r1 = extractRoot(k, "$X1");
+        if (r1)
+            roots["$X1"] = mergeRoot("$X1", roots["$X1"], r1);
+        const r2 = extractRoot(k, "$X2");
+        if (r2)
+            roots["$X2"] = mergeRoot("$X2", roots["$X2"], r2);
+    }
+    const x2r = roots["$X2"];
+    if (x2r && containsVar(x2r, "$X1") && !roots["$X1"]) {
+        throw new Error(`$X2 root depends on $X1 but no $X1 root found. Root: ${x2r}`);
+    }
+    return roots;
+}
+function mergeRoot(v, existing, next) {
+    if (!existing)
+        return next;
+    if (existing === next)
+        return existing;
+    throw new Error(`v1 supports a single root per selector variable. ${v} roots: '${existing}' vs '${next}'`);
+}
+function extractRoot(path, v) {
+    const needle = `.${v}.`;
+    const i = path.indexOf(needle);
+    if (i >= 0)
+        return path.slice(0, i);
+    const tail = `.${v}`;
+    if (path.endsWith(tail))
+        return path.slice(0, -tail.length);
+    return null;
+}
+function containsVar(path, v) {
+    return path.includes(`.${v}.`) || path.endsWith(`.${v}`);
+}
+function containsAnyVar(path) {
+    return containsVar(path, "$X1") || containsVar(path, "$X2");
+}
+/**
+ * Scan root array to bind varName.
+ * Skips conditions that still contain unresolved vars.
+ */
+function bindVarByScanningRoot(varName, rootPath, condKeys, conditions, bindingsAlready, ctx) {
+    const rootResolved = resolvePath(ctx.ns, rootPath, ctx.resolveOpts);
+    const arr = rootResolved.value;
+    if (!Array.isArray(arr))
+        return null;
+    for (let i = 0; i < arr.length; i++) {
+        const trialBindings = {
+            ...bindingsAlready,
+            [varName]: i,
+        };
+        let ok = true;
+        for (const k of condKeys) {
+            const expected = conditions[k];
+            const kk = applyBindingsToPath(k, trialBindings);
+            if (containsAnyVar(kk))
+                continue; // unresolved var remains
+            const r = resolvePath(ctx.ns, kk, ctx.resolveOpts);
+            if (!matchesExpected(r.value, expected)) {
+                ok = false;
+                break;
+            }
+        }
+        if (ok)
+            return i;
+    }
+    return null;
+}
+function matchesExpected(actual, expected) {
+    if (Array.isArray(expected))
+        return expected.includes(actual);
+    return actual === expected;
+}
+//# sourceMappingURL=SelectorEngine.js.map

package/dist/core/SelectorEngine.js.map

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

package/dist/core/validateSpec.d.ts

@@ -0,0 +1,3 @@
+import type { RuleDocumentV1 } from "../types/spec.js";
+export declare function asRuleDocumentV1(spec: unknown): RuleDocumentV1;
+//# sourceMappingURL=validateSpec.d.ts.map

package/dist/core/validateSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateSpec.d.ts","sourceRoot":"","sources":["../../src/core/validateSpec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAY9D"}

package/dist/core/validateSpec.js

@@ -0,0 +1,11 @@
+export function asRuleDocumentV1(spec) {
+    if (!spec || typeof spec !== "object")
+        throw new Error("Spec must be an object");
+    const s = spec;
+    if (s.version !== "1.0")
+        throw new Error(`Unsupported spec version: ${String(s.version)}`);
+    if (!s.rules || typeof s.rules !== "object")
+        throw new Error("Spec.rules must be an object");
+    return s;
+}
+//# sourceMappingURL=validateSpec.js.map

package/dist/core/validateSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateSpec.js","sourceRoot":"","sources":["../../src/core/validateSpec.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QACnC,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAE5C,MAAM,CAAC,GAAG,IAAW,CAAC;IACtB,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK;QACrB,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEpE,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QACzC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAElD,OAAO,CAAmB,CAAC;AAC7B,CAAC"}

package/dist/example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

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

package/dist/example.js

@@ -0,0 +1,32 @@
+import { createMapper } from "./index.js";
+const spec = {
+    version: "1.0",
+    rules: {
+        "match.customerDevice": [
+            {
+                conditions: {
+                    "customers.$X1.fleet.id": "fleetId_5",
+                    "customers.$X1.devices.$X2.id": "deviceId_10",
+                },
+                mappings: ["customers.$X1.devices.$X2.serialNum"],
+                required: true,
+            },
+        ],
+    },
+};
+const input = {
+    customers: [
+        { fleet: { id: "fleetId_0" }, devices: [{ id: "deviceId_1" }] },
+        {
+            fleet: { id: "fleetId_5" },
+            devices: [
+                { id: "x" },
+                { id: "y" },
+                { id: "deviceId_10", serialNum: 200 },
+            ],
+        },
+    ],
+};
+const res = await createMapper({ spec }).map(input);
+// console.log(JSON.stringify(res));
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,KAAK;IACd,KAAK,EAAE;QACL,sBAAsB,EAAE;YACtB;gBACE,UAAU,EAAE;oBACV,wBAAwB,EAAE,WAAW;oBACrC,8BAA8B,EAAE,aAAa;iBAC9C;gBACD,QAAQ,EAAE,CAAC,qCAAqC,CAAC;gBACjD,QAAQ,EAAE,IAAI;aACf;SACF;KACF;CACO,CAAC;AAEX,MAAM,KAAK,GAAG;IACZ,SAAS,EAAE;QACT,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE;QAC/D;YACE,KAAK,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE;YAC1B,OAAO,EAAE;gBACP,EAAE,EAAE,EAAE,GAAG,EAAE;gBACX,EAAE,EAAE,EAAE,GAAG,EAAE;gBACX,EAAE,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,EAAE;aACtC;SACF;KACF;CACF,CAAC;AAEF,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACpD,oCAAoC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type { RuleDocumentV1, RuleEntryV1, MappingV1, MappingObjV1, PayloadType, } from "./types/spec.js";
+export type { MapResult, MapMeta, MapError, MapWarning, } from "./types/result.js";
+export type { FunctionRegistry, MapperContext } from "./types/functions.js";
+export { Mapper } from "./core/Mapper.js";
+import type { MapperOptions } from "./core/Mapper.js";
+import { Mapper as MapperClass } from "./core/Mapper.js";
+export declare function createMapper(opts: MapperOptions): MapperClass;
+//# 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,cAAc,EACd,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,SAAS,EACT,OAAO,EACP,QAAQ,EACR,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEzD,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,eAE/C"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { Mapper } from "./core/Mapper.js";
+import { Mapper as MapperClass } from "./core/Mapper.js";
+export function createMapper(opts) {
+    return new MapperClass(opts);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/parsing/detect.d.ts

@@ -0,0 +1,2 @@
+export declare function detectInputType(input: unknown): "json" | "xml";
+//# sourceMappingURL=detect.d.ts.map

package/dist/parsing/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/parsing/detect.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAM9D"}

package/dist/parsing/detect.js

@@ -0,0 +1,9 @@
+export function detectInputType(input) {
+    if (typeof input === "string") {
+        const s = input.trim();
+        if (s.startsWith("<") && s.endsWith(">"))
+            return "xml";
+    }
+    return "json";
+}
+//# sourceMappingURL=detect.js.map

package/dist/parsing/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/parsing/detect.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/parsing/normalize.d.ts

@@ -0,0 +1,8 @@
+export declare function normalizePayload(payload: unknown, typeHint?: "json" | "xml" | "auto"): Promise<{
+    kind: "json";
+    obj: any;
+} | {
+    kind: "xml";
+    obj: any;
+}>;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/parsing/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/parsing/normalize.ts"],"names":[],"mappings":"AAGA,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAM,GAAG,KAAK,GAAG,MAAe;;;;;;GAiBlG"}

package/dist/parsing/normalize.js

@@ -0,0 +1,19 @@
+import { detectInputType } from "./detect.js";
+import { parseXmlToObject } from "./xml.js";
+export async function normalizePayload(payload, typeHint = "auto") {
+    const kind = typeHint === "auto" ? detectInputType(payload) : typeHint;
+    if (kind === "json") {
+        if (typeof payload === "string") {
+            // JSON string
+            return { kind, obj: JSON.parse(payload) };
+        }
+        return { kind, obj: payload };
+    }
+    // xml
+    if (typeof payload !== "string") {
+        throw new Error("XML payload must be a string in v1");
+    }
+    const obj = parseXmlToObject(payload);
+    return { kind, obj };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/parsing/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/parsing/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAgB,EAAE,WAAoC,MAAM;IACjG,MAAM,IAAI,GAAG,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEvE,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,cAAc;YACd,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,MAAM;IACN,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACvB,CAAC"}

package/dist/parsing/xml.d.ts

@@ -0,0 +1,9 @@
+/**
+ * v1 XML normalization:
+ * - repeated tags -> arrays
+ * - text nodes flattened
+ * - attributes under @
+ * - ignore namespaces (strip prefix)
+ */
+export declare function parseXmlToObject(xml: string): any;
+//# sourceMappingURL=xml.d.ts.map

package/dist/parsing/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/parsing/xml.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAiBjD"}

package/dist/parsing/xml.js

@@ -0,0 +1,25 @@
+import { XMLParser } from "fast-xml-parser";
+/**
+ * v1 XML normalization:
+ * - repeated tags -> arrays
+ * - text nodes flattened
+ * - attributes under @
+ * - ignore namespaces (strip prefix)
+ */
+export function parseXmlToObject(xml) {
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: "@",
+        textNodeName: "#text",
+        removeNSPrefix: true,
+        // flatten text-only nodes:
+        alwaysCreateTextNode: false,
+        // Make repeated nodes arrays when needed:
+        isArray: (name, jpath, isLeafNode, isAttribute) => false,
+    });
+    const parsed = parser.parse(xml);
+    // NOTE: fast-xml-parser already flattens many leaf nodes to string.
+    // For strict determinism we may add a post-walk normalization later.
+    return parsed;
+}
+//# sourceMappingURL=xml.js.map

package/dist/parsing/xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.js","sourceRoot":"","sources":["../../src/parsing/xml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,gBAAgB,EAAE,KAAK;QACvB,mBAAmB,EAAE,GAAG;QACxB,YAAY,EAAE,OAAO;QACrB,cAAc,EAAE,IAAI;QACpB,2BAA2B;QAC3B,oBAAoB,EAAE,KAAK;QAC3B,0CAA0C;QAC1C,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,CAAC,KAAK;KACzD,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEjC,oEAAoE;IACpE,qEAAqE;IACrE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/resolvers/AliasResolver.d.ts

@@ -0,0 +1,7 @@
+import type { Namespaces, ResolveOptions, ResolveResult } from "./PathResolver.js";
+/**
+ * Convenience wrapper that resolves a list of candidate paths (fallback).
+ * Returns first non-undefined value, along with the ResolveResult for that path.
+ */
+export declare function resolveFirst(ns: Namespaces, paths: string[], opts: ResolveOptions): ResolveResult;
+//# sourceMappingURL=AliasResolver.d.ts.map

package/dist/resolvers/AliasResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AliasResolver.d.ts","sourceRoot":"","sources":["../../src/resolvers/AliasResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGnF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,aAAa,CAQjG"}