@apiconvert/core 0.2.0 → 1.0.0

package/README.md

@@ -1,294 +1,86 @@
 # @apiconvert/core
 
-TypeScript package for applying Apiconvert conversion rules to JSON, XML, and query payloads.
+Shared TypeScript conversion runtime for Apiconvert.
 
-## Install
+## Rules Model
 
-```bash
-npm install @apiconvert/core
-```
+Canonical rules are defined by one ordered `rules` array of recursive nodes:
+- `kind: "field"` with `outputPaths` and `source`
+- `kind: "array"` with `inputPath`, `outputPaths`, and recursive `itemRules`
+- `kind: "branch"` with `expression`, `then`, optional `elseIf`, optional `else`
 
-## Basic JSON -> JSON
+Supported field source types:
+- `path`
+- `constant`
+- `transform`
+- `merge`
+- `condition`
 
-```ts
-import {
-  applyConversion,
-  DataFormat,
-  formatPayload,
-  normalizeConversionRules,
-  parsePayload
-} from "@apiconvert/core";
+Supported transforms:
+- `toLowerCase`
+- `toUpperCase`
+- `number`
+- `boolean`
+- `concat`
+- `split`
 
-const rules = normalizeConversionRules({
-  version: 2,
-  inputFormat: DataFormat.Json,
-  outputFormat: DataFormat.Json,
-  fieldMappings: [
-    {
-      outputPath: "profile.name",
-      source: { type: "path", path: "user.fullName" }
-    }
-  ]
-});
+Supported merge modes:
+- `concat`
+- `firstNonEmpty`
+- `array`
 
-const input = '{"user": {"fullName": "Ada Lovelace"}}';
-const { value, error } = parsePayload(input, rules.inputFormat!);
-if (error) throw new Error(error);
+Additional options:
+- field: optional `defaultValue`
+- array: optional `coerceSingle`
+- condition source: optional `trueSource` / `falseSource`, `trueValue` / `falseValue`, `elseIf`, and `conditionOutput` (`branch` or `match`)
 
-const result = applyConversion(value, rules);
-if (result.errors.length) throw new Error(result.errors.join("; "));
+Condition expressions support `path(...)`, `exists(...)`, comparison operators, and boolean operators (`&&`, `||`, `!`).
 
-const outputJson = formatPayload(result.output, rules.outputFormat!, true);
-```
-
-Input:
-
-```json
-{ "user": { "fullName": "Ada Lovelace" } }
-```
-
-Output:
-
-```json
-{ "profile": { "name": "Ada Lovelace" } }
-```
-
-## Load Rules From rules.json
-
-```ts
-import fs from "node:fs";
-import {
-  applyConversion,
-  formatPayload,
-  normalizeConversionRules,
-  parsePayload
-} from "@apiconvert/core";
-
-const rulesText = fs.readFileSync("rules.json", "utf-8");
-const rules = normalizeConversionRules(rulesText);
-
-const input = fs.readFileSync("input.json", "utf-8");
-const { value, error } = parsePayload(input, rules.inputFormat!);
-if (error) throw new Error(error);
-
-const result = applyConversion(value, rules);
-if (result.errors.length) throw new Error(result.errors.join("; "));
-
-const outputJson = formatPayload(result.output, rules.outputFormat!, true);
-```
-
-## XML Attributes And Text
-
-XML attributes are addressed with `@_` and element text with `#text`.
+## Example
 
 ```ts
-const rules = normalizeConversionRules({
-  version: 2,
-  inputFormat: DataFormat.Xml,
-  outputFormat: DataFormat.Json,
-  fieldMappings: [
-    { outputPath: "orderId", source: { type: "path", path: "order.@_id" } },
-    { outputPath: "status", source: { type: "path", path: "order.status.#text" } }
-  ]
-});
-
-const input = '<order id="A1"><status>new</status></order>';
-```
-
-Input:
-
-```xml
-<order id="A1">
-  <status>new</status>
-</order>
-```
-
-Output:
-
-```json
-{ "orderId": "A1", "status": "new" }
-```
-
-## Array Mapping
-
-Array mapping paths support root-prefixed JSONPath-style syntax:
-- `inputPath`: `orders` and `$.orders` are equivalent.
-- `outputPath`: `orders` and `$.orders` are equivalent.
-
-`$` resolves from the root input for reads, and `$.<path>` writes at the root output path.
-
-```ts
-const rules = normalizeConversionRules({
-  version: 2,
-  inputFormat: DataFormat.Json,
-  outputFormat: DataFormat.Json,
-  arrayMappings: [
-    {
-      inputPath: "$.orders",
-      outputPath: "$.ordersNormalized",
-      itemMappings: [
-        { outputPath: "id", source: { type: "path", path: "orderId" } },
-        { outputPath: "currency", source: { type: "path", path: "$.defaults.currency" } }
-      ]
-    }
-  ]
-});
-```
-
-Input:
-
-```json
-{
-  "defaults": { "currency": "USD" },
-  "orders": [
-    { "orderId": "A1" }, 
-    { "orderId": "A2" }
-  ]
-}
-```
-
-## Split And Merge Field Rules
+import { applyConversion, normalizeConversionRules } from "@apiconvert/core";
 
-Use `outputPaths` to split one source value into multiple output fields.  
-Use `source.type = "merge"` with `paths` to combine multiple inputs into one output.
-
-```ts
 const rules = normalizeConversionRules({
-  version: 2,
-  inputFormat: DataFormat.Json,
-  outputFormat: DataFormat.Json,
-  fieldMappings: [
+  inputFormat: "json",
+  outputFormat: "json",
+  rules: [
     {
-      outputPaths: ["profile.name", "profile.displayName"],
-      source: { type: "path", path: "user.name" }
+      kind: "field",
+      outputPaths: ["meta.name"],
+      source: { type: "path", path: "name" }
     },
     {
-      outputPath: "profile.fullName",
-      source: {
-        type: "merge",
-        paths: ["user.firstName", "user.lastName"],
-        mergeMode: "concat",
-        separator: " "
-      }
+      kind: "branch",
+      expression: "path(status) == 'active'",
+      then: [
+        {
+          kind: "field",
+          outputPaths: ["meta.enabled"],
+          source: { type: "constant", value: "true" }
+        }
+      ],
+      else: [
+        {
+          kind: "field",
+          outputPaths: ["meta.enabled"],
+          source: { type: "constant", value: "false" }
+        }
+      ]
     }
   ]
 });
-```
-
-Input:
-
-```json
-{
-  "user": {
-    "name": "Ada Lovelace",
-    "firstName": "Ada",
-    "lastName": "Lovelace"
-  }
-}
-```
-
-Output:
 
-```json
-{
-  "profile": {
-    "name": "Ada Lovelace",
-    "displayName": "Ada Lovelace",
-    "fullName": "Ada Lovelace"
-  }
+const result = applyConversion({ name: "Ada", status: "active" }, rules);
+if (result.errors.length > 0) {
+  throw new Error(result.errors.join("; "));
 }
-```
-
-## Transforms And Conditions
-
-```ts
-const rules = normalizeConversionRules({
-  version: 2,
-  inputFormat: DataFormat.Json,
-  outputFormat: DataFormat.Json,
-  fieldMappings: [
-    {
-      outputPath: "profile.country",
-      source: { type: "transform", transform: "toUpperCase", path: "user.country" }
-    },
-    {
-      outputPath: "profile.isAdult",
-      source: {
-        type: "condition",
-        condition: { path: "user.age", operator: "gt", value: "18" },
-        trueValue: "true",
-        falseValue: "false"
-      }
-    }
-  ]
-});
-```
-
-For splitting a full name into parts, use `transform: "split"`, `separator`, and `tokenIndex`.
-`tokenIndex` supports negative values (`-1` = last token):
-`trimAfterSplit` defaults to `true` and can be set to `false` to preserve token whitespace.
-`separator: ""` is invalid for split transforms.
-
-```ts
-const rules = normalizeConversionRules({
-  version: 2,
-  inputFormat: DataFormat.Json,
-  outputFormat: DataFormat.Json,
-  fieldMappings: [
-    {
-      outputPath: "firstName",
-      source: {
-        type: "transform",
-        transform: "split",
-        path: "name",
-        separator: " ",
-        tokenIndex: 0
-      }
-    },
-    {
-      outputPath: "lastName",
-      source: {
-        type: "transform",
-        transform: "split",
-        path: "name",
-        separator: " ",
-        tokenIndex: -1
-      }
-    }
-  ]
-});
-```
-
-Input:
-
-```json
-{ "name": "Jonas Strand Aasberg" }
-```
-
-Output:
-
-```json
-{ "firstName": "Jonas", "lastName": "Aasberg" }
-```
-
-Comma-separated names are supported as well. With default trim (`trimAfterSplit` omitted or `true`):
-
-```json
-{ "name": "Jonas, Aasberg" }
-```
-
-maps to:
-
-```json
-{ "firstName": "Jonas", "lastName": "Aasberg" }
-```
-
-With `trimAfterSplit: false`, whitespace is preserved:
 
-```json
-{ "firstName": "Jonas", "lastName": " Aasberg" }
+console.log(result.output);
 ```
 
-## Formatting
+## Parse and Format Helpers
 
-Use `formatPayload(value, DataFormat.Xml, true)` for indented XML and `false` for compact output. The same `pretty` flag controls JSON formatting.
+The package also exports:
+- `parsePayload(text, format)` for `json`, `xml`, and `query`
+- `formatPayload(value, format, pretty)`

package/dist/condition-expression-evaluator.d.ts

@@ -0,0 +1,4 @@
+import { type ConditionExpressionNode, type ResolvePath } from "./condition-expression-types";
+export declare function evaluateConditionExpression(node: ConditionExpressionNode, resolvePath: ResolvePath): unknown;
+export declare function toBoolean(value: unknown): boolean;
+//# sourceMappingURL=condition-expression-evaluator.d.ts.map

package/dist/condition-expression-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-expression-evaluator.d.ts","sourceRoot":"","sources":["../src/condition-expression-evaluator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,uBAAuB,EAAE,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE9F,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,uBAAuB,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAiB5G;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKjD"}

package/dist/condition-expression-evaluator.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateConditionExpression = evaluateConditionExpression;
+exports.toBoolean = toBoolean;
+const core_utils_1 = require("./core-utils");
+function evaluateConditionExpression(node, resolvePath) {
+    switch (node.kind) {
+        case "literal":
+            return node.value;
+        case "path":
+            return resolvePath(node.path);
+        case "array":
+            return node.items.map((entry) => evaluateConditionExpression(entry, resolvePath));
+        case "exists":
+            return evaluateConditionExpression(node.argument, resolvePath) != null;
+        case "unary":
+            return !toBoolean(evaluateConditionExpression(node.operand, resolvePath));
+        case "binary":
+            return evaluateConditionBinary(node, resolvePath);
+        default:
+            throw new Error("Unsupported condition expression node.");
+    }
+}
+function toBoolean(value) {
+    if (value == null)
+        return false;
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string")
+        return value.length > 0;
+    return true;
+}
+function evaluateConditionBinary(node, resolvePath) {
+    if (node.operator === "&&") {
+        return (toBoolean(evaluateConditionExpression(node.left, resolvePath)) &&
+            toBoolean(evaluateConditionExpression(node.right, resolvePath)));
+    }
+    if (node.operator === "||") {
+        return (toBoolean(evaluateConditionExpression(node.left, resolvePath)) ||
+            toBoolean(evaluateConditionExpression(node.right, resolvePath)));
+    }
+    const left = evaluateConditionExpression(node.left, resolvePath);
+    const right = evaluateConditionExpression(node.right, resolvePath);
+    switch (node.operator) {
+        case "==":
+            return Object.is(left, right);
+        case "!=":
+            return !Object.is(left, right);
+        case ">":
+            return (0, core_utils_1.toNumber)(left) > (0, core_utils_1.toNumber)(right);
+        case ">=":
+            return (0, core_utils_1.toNumber)(left) >= (0, core_utils_1.toNumber)(right);
+        case "<":
+            return (0, core_utils_1.toNumber)(left) < (0, core_utils_1.toNumber)(right);
+        case "<=":
+            return (0, core_utils_1.toNumber)(left) <= (0, core_utils_1.toNumber)(right);
+        case "in":
+            return Array.isArray(right) ? right.some((entry) => Object.is(left, entry)) : false;
+        default:
+            throw new Error(`Unsupported condition operator '${node.operator}'.`);
+    }
+}
+//# sourceMappingURL=condition-expression-evaluator.js.map

package/dist/condition-expression-evaluator.js.map

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

package/dist/condition-expression-parser.d.ts

@@ -0,0 +1,26 @@
+import { type ConditionExpressionNode } from "./condition-expression-types";
+export declare class ConditionExpressionParser {
+    private readonly expression;
+    private readonly tokens;
+    private index;
+    constructor(expression: string);
+    parse(): ConditionExpressionNode;
+    private parseOr;
+    private parseAnd;
+    private parseComparison;
+    private parseComparisonOperator;
+    private matchNotEqAlias;
+    private parseUnary;
+    private parsePrimary;
+    private parsePathCall;
+    private parseExistsCall;
+    private get current();
+    private peek;
+    private match;
+    private expect;
+    private matchOperator;
+    private matchIdentifier;
+    private peekIdentifier;
+    private error;
+}
+//# sourceMappingURL=condition-expression-parser.d.ts.map

package/dist/condition-expression-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-expression-parser.d.ts","sourceRoot":"","sources":["../src/condition-expression-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAG7B,MAAM,8BAA8B,CAAC;AAGtC,qBAAa,yBAAyB;IAIxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAHvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,KAAK,CAAK;gBAEW,UAAU,EAAE,MAAM;IAI/C,KAAK,IAAI,uBAAuB;IAMhC,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,uBAAuB;IAyB/B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,YAAY;IAmDpB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,eAAe;IAOvB,OAAO,KAAK,OAAO,GAElB;IAED,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,KAAK;CAGd"}

package/dist/condition-expression-parser.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConditionExpressionParser = void 0;
+const condition_expression_tokenizer_1 = require("./condition-expression-tokenizer");
+class ConditionExpressionParser {
+    constructor(expression) {
+        this.expression = expression;
+        this.index = 0;
+        this.tokens = (0, condition_expression_tokenizer_1.tokenizeConditionExpression)(expression);
+    }
+    parse() {
+        const node = this.parseOr();
+        this.expect("end");
+        return node;
+    }
+    parseOr() {
+        let left = this.parseAnd();
+        while (this.matchOperator("||") || this.matchIdentifier("or")) {
+            left = { kind: "binary", operator: "||", left, right: this.parseAnd() };
+        }
+        return left;
+    }
+    parseAnd() {
+        let left = this.parseComparison();
+        while (this.matchOperator("&&") || this.matchIdentifier("and")) {
+            left = { kind: "binary", operator: "&&", left, right: this.parseComparison() };
+        }
+        return left;
+    }
+    parseComparison() {
+        let left = this.parseUnary();
+        while (true) {
+            const operator = this.parseComparisonOperator();
+            if (!operator) {
+                return left;
+            }
+            const right = this.parseUnary();
+            if (operator === "in" && right.kind !== "array") {
+                throw this.error("Right-hand side of 'in' must be an array literal.");
+            }
+            left = { kind: "binary", operator, left, right };
+        }
+    }
+    parseComparisonOperator() {
+        if (this.matchOperator("=="))
+            return "==";
+        if (this.matchOperator("!="))
+            return "!=";
+        if (this.matchOperator(">="))
+            return ">=";
+        if (this.matchOperator("<="))
+            return "<=";
+        if (this.matchOperator(">"))
+            return ">";
+        if (this.matchOperator("<"))
+            return "<";
+        if (this.matchIdentifier("eq"))
+            return "==";
+        if (this.matchNotEqAlias())
+            return "!=";
+        if (this.matchIdentifier("gt"))
+            return ">";
+        if (this.matchIdentifier("gte"))
+            return ">=";
+        if (this.matchIdentifier("lt"))
+            return "<";
+        if (this.matchIdentifier("lte"))
+            return "<=";
+        if (this.matchIdentifier("in"))
+            return "in";
+        return null;
+    }
+    matchNotEqAlias() {
+        if (!this.peekIdentifier("not"))
+            return false;
+        const next = this.peek(1);
+        if (next.type !== "identifier" || next.text.toLowerCase() !== "eq") {
+            return false;
+        }
+        this.index += 2;
+        return true;
+    }
+    parseUnary() {
+        if (this.matchOperator("!") || this.matchIdentifier("not")) {
+            return { kind: "unary", operand: this.parseUnary() };
+        }
+        return this.parsePrimary();
+    }
+    parsePrimary() {
+        if (this.match("leftParen")) {
+            const node = this.parseOr();
+            this.expect("rightParen");
+            return node;
+        }
+        if (this.match("leftBracket")) {
+            const items = [];
+            if (!this.match("rightBracket")) {
+                do {
+                    items.push(this.parseOr());
+                } while (this.match("comma"));
+                this.expect("rightBracket");
+            }
+            return { kind: "array", items };
+        }
+        if (this.current.type === "number") {
+            const text = this.current.text;
+            this.index += 1;
+            const number = Number.parseFloat(text);
+            if (Number.isNaN(number) || !isFinite(number)) {
+                throw this.error(`Invalid number literal '${text}'.`);
+            }
+            return { kind: "literal", value: number };
+        }
+        if (this.current.type === "string") {
+            const text = this.current.text;
+            this.index += 1;
+            return { kind: "literal", value: text };
+        }
+        if (this.current.type === "identifier") {
+            const identifier = this.current.text;
+            this.index += 1;
+            const lowered = identifier.toLowerCase();
+            if (lowered === "true")
+                return { kind: "literal", value: true };
+            if (lowered === "false")
+                return { kind: "literal", value: false };
+            if (lowered === "null")
+                return { kind: "literal", value: null };
+            if (lowered === "path")
+                return this.parsePathCall();
+            if (lowered === "exists")
+                return this.parseExistsCall();
+            throw this.error(`Unexpected identifier '${identifier}'. Use path(...) for value references.`);
+        }
+        throw this.error(`Unexpected token '${this.current.text}'.`);
+    }
+    parsePathCall() {
+        this.expect("leftParen");
+        if (this.current.type !== "identifier" && this.current.type !== "string") {
+            throw this.error("path(...) requires a path reference.");
+        }
+        const path = this.current.text;
+        this.index += 1;
+        this.expect("rightParen");
+        return { kind: "path", path };
+    }
+    parseExistsCall() {
+        this.expect("leftParen");
+        const argument = this.parseOr();
+        this.expect("rightParen");
+        return { kind: "exists", argument };
+    }
+    get current() {
+        return this.peek(0);
+    }
+    peek(offset) {
+        const cursor = this.index + offset;
+        return cursor >= this.tokens.length ? this.tokens[this.tokens.length - 1] : this.tokens[cursor];
+    }
+    match(type) {
+        if (this.current.type !== type)
+            return false;
+        this.index += 1;
+        return true;
+    }
+    expect(type) {
+        if (!this.match(type)) {
+            throw this.error(`Expected ${type} but found '${this.current.text}'.`);
+        }
+    }
+    matchOperator(operator) {
+        if (this.current.type !== "operator" || this.current.text !== operator)
+            return false;
+        this.index += 1;
+        return true;
+    }
+    matchIdentifier(identifier) {
+        if (!this.peekIdentifier(identifier))
+            return false;
+        this.index += 1;
+        return true;
+    }
+    peekIdentifier(identifier) {
+        return (this.current.type === "identifier" && this.current.text.toLowerCase() === identifier.toLowerCase());
+    }
+    error(message) {
+        return new Error(`${message} (position ${this.current.position}).`);
+    }
+}
+exports.ConditionExpressionParser = ConditionExpressionParser;
+//# sourceMappingURL=condition-expression-parser.js.map

package/dist/condition-expression-parser.js.map

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

package/dist/condition-expression-tokenizer.d.ts

@@ -0,0 +1,3 @@
+import { type ConditionToken } from "./condition-expression-types";
+export declare function tokenizeConditionExpression(expression: string): ConditionToken[];
+//# sourceMappingURL=condition-expression-tokenizer.d.ts.map

package/dist/condition-expression-tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-expression-tokenizer.d.ts","sourceRoot":"","sources":["../src/condition-expression-tokenizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CAsFhF"}