ruleforge 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+- Initial Draft (ESM-only)

package/LICENSE

@@ -0,0 +1 @@
+MIT

package/README.md

@@ -0,0 +1,126 @@
+# ruleforge
+
+A declarative rule-based engine to map heterogeneous JSON/XML payloads into a canonical nested JSON structure.
+
+---
+
+## ✨ Features
+
+- JSON and XML support (XML normalized to JS object)
+- Envelope / metadata support via `initializer`
+- Payload inside string fields supported (JSON/XML strings)
+- Preprocessors, PostProcessors
+- Rule priority (top → bottom)
+- Array selector (`X`) – first match
+- Nested canonical output keys (dot-path targets)
+- Transform functions (built-ins + custom)
+- Debug metadata (`result.meta.matched`, `$pre`, etc.)
+
+---
+
+## 📦 Installation
+
+```bash
+npm install ruleforge
+```
+
+---
+
+## 🚀 Basic Usage
+
+```ts
+import { createMapper } from "ruleforge";
+import rules from "./rules.json" assert { type: "json" };
+
+const mapper = createMapper({
+  spec: rules,
+  functions: {
+    initializer: { initRequest },
+    preprocessors: { getClientName, getSource },
+    postProcessors: { normalizeCurrency },
+    transforms: {
+      /* custom transforms */
+    },
+  },
+});
+
+const result = await mapper.map(input, { requestId: "req-1" });
+
+if (!result.ok) console.error(result.error);
+else console.log(result.value);
+```
+
+---
+
+## 🧠 Initializer (Envelope + payload string parsing)
+
+```ts
+async function initRequest(input: any) {
+  // Example: { metadata: {...}, message: "<xml/>" } OR { metadata: {...}, jsonData: "{...}" }
+  return {
+    metadata: input.metadata,
+    payload: input.message ?? input.jsonData ?? input.payload,
+    payloadType: "auto",
+  };
+}
+```
+
+After initializer, the engine exposes namespaces:
+
+- `$payload.*` (normalized payload object)
+- `$meta.*` (metadata)
+- `$pre.*` (preprocessor outputs)
+
+Bare paths like `account.id` default to `$payload.account.id`.
+
+---
+
+## 🔍 Selectors (Array Matching)
+
+Rule example:
+
+```json
+{
+  "conditions": {
+    "customers.X.name": "c2",
+    "customers.X.value": "v2"
+  },
+  "mappings": ["customers.X.id"]
+}
+```
+
+Engine:
+
+- Iterates the `customers` array
+- First matching element binds `X`
+- Uses bound `X` during mapping
+
+---
+
+## 🔄 Built-in transforms
+
+- trim
+- upper
+- lower
+- toNumber
+- toString
+- toBoolean
+
+---
+
+## 🛠 Status
+
+This repository currently includes:
+
+- Full npm/TS scaffold (ESM-only)
+- Typed spec interfaces
+- Mapper pipeline skeleton
+- Examples + test placeholders
+
+Implementation of the rule engine will be completed next.
+
+---
+
+## License
+
+MIT

package/dist/core/Errors.d.ts

@@ -0,0 +1,3 @@
+import type { MapError } from "../types/result.js";
+export declare function err(code: MapError["code"], message: string, details?: any, field?: string): MapError;
+//# sourceMappingURL=Errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../src/core/Errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,wBAAgB,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAEpG"}

package/dist/core/Errors.js

@@ -0,0 +1,4 @@
+export function err(code, message, details, field) {
+    return { code, message, details, field };
+}
+//# sourceMappingURL=Errors.js.map

package/dist/core/Errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.js","sourceRoot":"","sources":["../../src/core/Errors.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,CAAC,IAAsB,EAAE,OAAe,EAAE,OAAa,EAAE,KAAc;IACxF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC"}

package/dist/core/Initializer.d.ts

@@ -0,0 +1,16 @@
+import type { RuleDocumentV1 } from "../types/spec.js";
+import type { FunctionRegistry, MapperContext } from "../types/functions.js";
+import type { MapResult } from "../types/result.js";
+export declare function runInitializer(spec: RuleDocumentV1, fn: FunctionRegistry, input: unknown, ctx: MapperContext): Promise<{
+    ok: true;
+    ns: {
+        payload: any;
+        meta: any;
+        pre: any;
+    };
+    inputType: "json" | "xml";
+} | {
+    ok: false;
+    result: MapResult;
+}>;
+//# sourceMappingURL=Initializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Initializer.d.ts","sourceRoot":"","sources":["../../src/core/Initializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAIpD,wBAAsB,cAAc,CAClC,IAAI,EAAE,cAAc,EACpB,EAAE,EAAE,gBAAgB,EACpB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,aAAa,GACjB,OAAO,CACN;IACE,EAAE,EAAE,IAAI,CAAC;IACT,EAAE,EAAE;QAAE,OAAO,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAC;QAAC,GAAG,EAAE,GAAG,CAAA;KAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC;CAC3B,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CACnC,CA8CA"}

package/dist/core/Initializer.js

@@ -0,0 +1,48 @@
+import { err } from "./Errors.js";
+import { normalizePayload } from "../parsing/normalize.js";
+export async function runInitializer(spec, fn, input, ctx) {
+    try {
+        let meta = {};
+        let payload = input;
+        let hint = "auto";
+        let pre = {};
+        if (spec.initializer) {
+            const name = spec.initializer.function;
+            const initFn = fn.initializer?.[name];
+            if (!initFn) {
+                return {
+                    ok: false,
+                    result: {
+                        ok: false,
+                        error: err("INITIALIZER_ERROR", `Initializer not found: ${name}`),
+                        meta: { inputType: "json", pre: {}, matched: {} },
+                    },
+                };
+            }
+            const r = await initFn(input, ctx);
+            meta = r.metadata ?? {};
+            payload = r.payload ?? payload;
+            pre = r.pre ?? {};
+            hint = (r.payloadType ?? "auto");
+        }
+        const norm = await normalizePayload(payload, hint);
+        return {
+            ok: true,
+            ns: { payload: norm.obj, meta, pre },
+            inputType: norm.kind,
+        };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            result: {
+                ok: false,
+                error: err("PAYLOAD_PARSE_ERROR", e?.message ?? String(e), {
+                    cause: e,
+                }),
+                meta: { inputType: "json", pre: {}, matched: {} },
+            },
+        };
+    }
+}
+//# sourceMappingURL=Initializer.js.map

package/dist/core/Initializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Initializer.js","sourceRoot":"","sources":["../../src/core/Initializer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAoB,EACpB,EAAoB,EACpB,KAAc,EACd,GAAkB;IASlB,IAAI,CAAC;QACH,IAAI,IAAI,GAAQ,EAAE,CAAC;QACnB,IAAI,OAAO,GAAQ,KAAK,CAAC;QACzB,IAAI,IAAI,GAA4B,MAAM,CAAC;QAC3C,IAAI,GAAG,GAAQ,EAAE,CAAC;QAElB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;YACvC,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE;wBACN,EAAE,EAAE,KAAK;wBACT,KAAK,EAAE,GAAG,CAAC,mBAAmB,EAAE,0BAA0B,IAAI,EAAE,CAAC;wBACjE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;qBAClD;iBACF,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACnC,IAAI,GAAG,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC;YACxB,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC;YAC/B,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,MAAM,CAAQ,CAAC;QAC1C,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAEnD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;YACpC,SAAS,EAAE,IAAI,CAAC,IAAI;SACrB,CAAC;IACJ,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE;gBACN,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,GAAG,CAAC,qBAAqB,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE;oBACzD,KAAK,EAAE,CAAC;iBACT,CAAC;gBACF,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;aAClD;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/Mapper.d.ts

@@ -0,0 +1,19 @@
+import type { RuleDocumentV1 } from "../types/spec.js";
+import type { FunctionRegistry, MapperContext } from "../types/functions.js";
+import type { MapResult } from "../types/result.js";
+export interface MapperOptions {
+    spec: RuleDocumentV1;
+    functions?: FunctionRegistry;
+    /** default: true (bare path => $payload) */
+    allowBarePaths?: boolean;
+    debug?: boolean;
+}
+export declare class Mapper {
+    private spec;
+    private fn;
+    private allowBarePaths;
+    private debug;
+    constructor(opts: MapperOptions);
+    map(input: unknown, ctx?: MapperContext): Promise<MapResult>;
+}
+//# sourceMappingURL=Mapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Mapper.d.ts","sourceRoot":"","sources":["../../src/core/Mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAMpD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,KAAK,CAAU;gBAEX,IAAI,EAAE,aAAa;IAOzB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;CA6BvE"}

package/dist/core/Mapper.js

@@ -0,0 +1,39 @@
+import { runInitializer } from "./Initializer.js";
+import { runPreprocessors } from "./Preprocessor.js";
+import { runRules } from "./RuleEngine.js";
+import { runPostProcessors } from "./Postprocessor.js";
+export class Mapper {
+    spec;
+    fn;
+    allowBarePaths;
+    debug;
+    constructor(opts) {
+        this.spec = opts.spec;
+        this.fn = opts.functions ?? {};
+        this.allowBarePaths = opts.allowBarePaths ?? true;
+        this.debug = opts.debug ?? false;
+    }
+    async map(input, ctx = {}) {
+        const init = await runInitializer(this.spec, this.fn, input, ctx);
+        if (!init.ok)
+            return init.result;
+        const pre = await runPreprocessors(this.spec, this.fn, init.ns, ctx);
+        if (!pre.ok)
+            return pre.result;
+        const ns = { payload: init.ns.payload, meta: init.ns.meta, pre: pre.pre };
+        const mapped = await runRules(this.spec, this.fn, ns, ctx, this.allowBarePaths, init.inputType);
+        if (!mapped.ok)
+            return mapped.result;
+        const final = await runPostProcessors(this.spec, this.fn, mapped.value, ns, ctx, mapped.meta);
+        return finalizeResult(final, this.debug);
+    }
+}
+function finalizeResult(result, debug) {
+    if (debug)
+        return result;
+    if (result.ok) {
+        return { ok: true, value: result.value };
+    }
+    return { ok: false, error: result.error };
+}
+//# sourceMappingURL=Mapper.js.map

package/dist/core/Mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mapper.js","sourceRoot":"","sources":["../../src/core/Mapper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAUvD,MAAM,OAAO,MAAM;IACT,IAAI,CAAiB;IACrB,EAAE,CAAmB;IACrB,cAAc,CAAU;IACxB,KAAK,CAAU;IAEvB,YAAY,IAAmB;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAc,EAAE,MAAqB,EAAE;QAC/C,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QAEjC,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACrE,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC;QAE/B,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QAE1E,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,EAAE,EACP,EAAE,EACF,GAAG,EACH,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,SAAS,CACf,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC;QAErC,MAAM,KAAK,GAAG,MAAM,iBAAiB,CACnC,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,EAAE,EACP,MAAM,CAAC,KAAK,EACZ,EAAE,EACF,GAAG,EACH,MAAM,CAAC,IAAI,CACZ,CAAC;QACF,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,SAAS,cAAc,CAAC,MAAiB,EAAE,KAAc;IACvD,IAAI,KAAK;QAAE,OAAO,MAAM,CAAC;IAEzB,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC3C,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AAC5C,CAAC"}

package/dist/core/OutputBuilder.d.ts

@@ -0,0 +1,2 @@
+export declare function setByDotPath(obj: any, dotPath: string, value: any): void;
+//# sourceMappingURL=OutputBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OutputBuilder.d.ts","sourceRoot":"","sources":["../../src/core/OutputBuilder.ts"],"names":[],"mappings":"AAOA,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CA6DxE"}

package/dist/core/OutputBuilder.js

@@ -0,0 +1,62 @@
+function isIndex(seg) {
+    if (seg.length === 0)
+        return false;
+    // "0" is valid; disallow "-1"
+    const n = Number(seg);
+    return Number.isInteger(n) && n >= 0 && String(n) === seg;
+}
+export function setByDotPath(obj, dotPath, value) {
+    const parts = dotPath.split(".").filter(Boolean);
+    if (parts.length === 0)
+        return;
+    let cur = obj;
+    for (let i = 0; i < parts.length; i++) {
+        const seg = parts[i];
+        const last = i === parts.length - 1;
+        const nextSeg = parts[i + 1];
+        if (isIndex(seg)) {
+            const idx = Number(seg);
+            // ensure cur is an array
+            if (!Array.isArray(cur)) {
+                // If cur is empty object at root, we can't "convert" it safely.
+                // But in normal flow we create arrays only when parent decides.
+                // So here, assume caller created correct container.
+                // We'll handle conversion when creating the child container below.
+            }
+            if (!Array.isArray(cur)) {
+                // convert in-place if possible (only works if cur is a property value; root case handled by parent)
+                // This function is used with a root object; numeric segment should only occur after a key segment.
+                throw new Error(`Invalid array index segment '${seg}' at root or non-array container`);
+            }
+            if (last) {
+                cur[idx] = value;
+                return;
+            }
+            // create next container if missing
+            if (cur[idx] == null || typeof cur[idx] !== "object") {
+                cur[idx] = nextSeg && isIndex(nextSeg) ? [] : {};
+            }
+            cur = cur[idx];
+            continue;
+        }
+        // seg is object key
+        if (last) {
+            cur[seg] = value;
+            return;
+        }
+        // ensure next container
+        const wantArray = nextSeg ? isIndex(nextSeg) : false;
+        if (cur[seg] == null || typeof cur[seg] !== "object") {
+            cur[seg] = wantArray ? [] : {};
+        }
+        else {
+            // if existing but wrong container type, replace (v1 deterministic)
+            if (wantArray && !Array.isArray(cur[seg]))
+                cur[seg] = [];
+            if (!wantArray && Array.isArray(cur[seg]))
+                cur[seg] = {};
+        }
+        cur = cur[seg];
+    }
+}
+//# sourceMappingURL=OutputBuilder.js.map

package/dist/core/OutputBuilder.js.map

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

package/dist/core/Postprocessor.d.ts

@@ -0,0 +1,9 @@
+import type { RuleDocumentV1 } from "../types/spec.js";
+import type { FunctionRegistry, MapperContext } from "../types/functions.js";
+import type { MapMeta, MapResult } from "../types/result.js";
+export declare function runPostProcessors(spec: RuleDocumentV1, fn: FunctionRegistry, out: any, ns: {
+    payload: any;
+    meta: any;
+    pre: Record<string, any>;
+}, ctx: MapperContext, meta: MapMeta): Promise<MapResult>;
+//# sourceMappingURL=Postprocessor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Postprocessor.d.ts","sourceRoot":"","sources":["../../src/core/Postprocessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG7D,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,EACpB,EAAE,EAAE,gBAAgB,EACpB,GAAG,EAAE,GAAG,EACR,EAAE,EAAE;IAAE,OAAO,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,EACzD,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,SAAS,CAAC,CA4BpB"}

package/dist/core/Postprocessor.js

@@ -0,0 +1,25 @@
+import { err } from "./Errors.js";
+export async function runPostProcessors(spec, fn, out, ns, ctx, meta) {
+    try {
+        let cur = out;
+        for (const name of spec.postProcessors ?? []) {
+            const f = fn.postProcessors?.[name];
+            if (!f)
+                return {
+                    ok: false,
+                    error: err("PREPROCESSOR_ERROR", `PostProcessor not found: ${name}`),
+                    meta,
+                };
+            cur = await f(cur, { payload: ns.payload, meta: ns.meta, pre: ns.pre }, ctx);
+        }
+        return { ok: true, value: cur, meta };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            error: err("PREPROCESSOR_ERROR", e?.message ?? String(e), { cause: e }),
+            meta,
+        };
+    }
+}
+//# sourceMappingURL=Postprocessor.js.map

package/dist/core/Postprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Postprocessor.js","sourceRoot":"","sources":["../../src/core/Postprocessor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAoB,EACpB,EAAoB,EACpB,GAAQ,EACR,EAAyD,EACzD,GAAkB,EAClB,IAAa;IAEb,IAAI,CAAC;QACH,IAAI,GAAG,GAAG,GAAG,CAAC;QAEd,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,CAAC;gBACJ,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,GAAG,CAAC,oBAAoB,EAAE,4BAA4B,IAAI,EAAE,CAAC;oBACpE,IAAI;iBACL,CAAC;YAEJ,GAAG,GAAG,MAAM,CAAC,CACX,GAAG,EACH,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EACnD,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACxC,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,GAAG,CAAC,oBAAoB,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACvE,IAAI;SACL,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/Preprocessor.d.ts

@@ -0,0 +1,16 @@
+import type { RuleDocumentV1 } from "../types/spec.js";
+import type { FunctionRegistry, MapperContext } from "../types/functions.js";
+import type { MapResult } from "../types/result.js";
+export declare function runPreprocessors(spec: RuleDocumentV1, fn: FunctionRegistry, ns: {
+    payload: any;
+    meta: any;
+    pre: Record<string, any>;
+}, // ✅ include pre seed
+ctx: MapperContext): Promise<{
+    ok: true;
+    pre: Record<string, any>;
+} | {
+    ok: false;
+    result: MapResult;
+}>;
+//# sourceMappingURL=Preprocessor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Preprocessor.d.ts","sourceRoot":"","sources":["../../src/core/Preprocessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,EACpB,EAAE,EAAE,gBAAgB,EACpB,EAAE,EAAE;IAAE,OAAO,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,EAAE,qBAAqB;AAChF,GAAG,EAAE,aAAa,GACjB,OAAO,CACR;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAC1E,CAoCA"}

package/dist/core/Preprocessor.js

@@ -0,0 +1,35 @@
+import { err } from "./Errors.js";
+export async function runPreprocessors(spec, fn, ns, // ✅ include pre seed
+ctx) {
+    // ✅ Seed with initializer pre so CDATA parsing etc stays available
+    const out = { ...(ns.pre ?? {}) };
+    try {
+        for (const [key, ref] of Object.entries(spec.preprocessors ?? {})) {
+            const f = fn.preprocessors?.[ref.function];
+            if (!f) {
+                return {
+                    ok: false,
+                    result: {
+                        ok: false,
+                        error: err("PREPROCESSOR_ERROR", `Preprocessor not found: ${ref.function}`),
+                        meta: { inputType: "json", pre: {}, matched: {} },
+                    },
+                };
+            }
+            // Preprocessors see pre as "current computed pre" (seed + previously computed)
+            out[key] = await f({ payload: ns.payload, meta: ns.meta, pre: out }, ctx);
+        }
+        return { ok: true, pre: out };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            result: {
+                ok: false,
+                error: err("PREPROCESSOR_ERROR", e?.message ?? String(e), { cause: e }),
+                meta: { inputType: "json", pre: {}, matched: {} },
+            },
+        };
+    }
+}
+//# sourceMappingURL=Preprocessor.js.map

package/dist/core/Preprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Preprocessor.js","sourceRoot":"","sources":["../../src/core/Preprocessor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAoB,EACpB,EAAoB,EACpB,EAAyD,EAAE,qBAAqB;AAChF,GAAkB;IAIlB,mEAAmE;IACnE,MAAM,GAAG,GAAwB,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;IAEvD,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;YAClE,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC3C,IAAI,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE;wBACN,EAAE,EAAE,KAAK;wBACT,KAAK,EAAE,GAAG,CACR,oBAAoB,EACpB,2BAA2B,GAAG,CAAC,QAAQ,EAAE,CAC1C;wBACD,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;qBAClD;iBACF,CAAC;YACJ,CAAC;YAED,+EAA+E;YAC/E,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAChC,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE;gBACN,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,GAAG,CAAC,oBAAoB,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;gBACvE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;aAClD;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/RuleEngine.d.ts

@@ -0,0 +1,16 @@
+import type { RuleDocumentV1 } from "../types/spec.js";
+import type { FunctionRegistry, MapperContext } from "../types/functions.js";
+import type { MapResult, MapMeta } from "../types/result.js";
+export declare function runRules(spec: RuleDocumentV1, fn: FunctionRegistry, ns: {
+    payload: any;
+    meta: any;
+    pre: Record<string, any>;
+}, ctx: MapperContext, allowBarePaths: boolean, inputType: "json" | "xml"): Promise<{
+    ok: true;
+    value: any;
+    meta: MapMeta;
+} | {
+    ok: false;
+    result: MapResult;
+}>;
+//# sourceMappingURL=RuleEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RuleEngine.d.ts","sourceRoot":"","sources":["../../src/core/RuleEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAY,SAAS,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAcvE,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,cAAc,EACpB,EAAE,EAAE,gBAAgB,EACpB,EAAE,EAAE;IAAE,OAAO,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,EACzD,GAAG,EAAE,aAAa,EAClB,cAAc,EAAE,OAAO,EACvB,SAAS,EAAE,MAAM,GAAG,KAAK,GACxB,OAAO,CACR;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAC3E,CA+JA"}