@scrawn/core 0.0.3 → 0.0.7

package/dist/core/pricing/builders.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Pricing DSL Builder Functions
+ *
+ * This module provides the fluent builder functions for constructing
+ * type-safe pricing expressions. These functions perform light validation
+ * and build the AST that gets serialized to a string for the backend.
+ *
+ * @example
+ * ```typescript
+ * import { add, mul, tag } from '@scrawn/core';
+ *
+ * // (PREMIUM_CALL * 3) + EXTRA_FEE + 250 cents
+ * const expr = add(mul(tag('PREMIUM_CALL'), 3), tag('EXTRA_FEE'), 250);
+ * ```
+ */
+import type { AmountExpr, TagExpr, OpExpr, InputTokensExpr, OutputTokensExpr, ExprInput, ExprRef } from "./types.js";
+/**
+ * Create a tag reference expression.
+ * Tags are resolved to their cent values by the backend.
+ *
+ * @param name - The name of the price tag (must be ALL CAPS with underscores only, e.g., PREMIUM_CALL, FEE)
+ * @returns A TagExpr referencing the named tag
+ * @throws Error if name is empty, whitespace-only, or not ALL_CAPS format
+ *
+ * @example
+ * ```typescript
+ * const premiumTag = tag('PREMIUM_CALL');
+ * ```
+ */
+export declare function tag<T extends string>(name: T): TagExpr<T>;
+/**
+ * Create an addition expression.
+ * Adds all arguments together: arg1 + arg2 + arg3 + ...
+ *
+ * @param args - Two or more expressions or numbers (cents) to add
+ * @returns An OpExpr representing the sum
+ * @throws Error if fewer than 2 arguments provided
+ *
+ * @example
+ * ```typescript
+ * // 100 + 200 + tag('BONUS')
+ * const sum = add(100, 200, tag('BONUS'));
+ * ```
+ */
+export declare function add<T extends string = string>(...args: ExprInput<T>[]): OpExpr<T>;
+/**
+ * Create a subtraction expression.
+ * Subtracts subsequent arguments from the first: arg1 - arg2 - arg3 - ...
+ *
+ * @param args - Two or more expressions or numbers (cents) to subtract
+ * @returns An OpExpr representing the difference
+ * @throws Error if fewer than 2 arguments provided
+ *
+ * @example
+ * ```typescript
+ * // tag('TOTAL') - 50
+ * const diff = sub(tag('TOTAL'), 50);
+ * ```
+ */
+export declare function sub<T extends string = string>(...args: ExprInput<T>[]): OpExpr<T>;
+/**
+ * Create a multiplication expression.
+ * Multiplies all arguments together: arg1 * arg2 * arg3 * ...
+ *
+ * @param args - Two or more expressions or numbers (cents) to multiply
+ * @returns An OpExpr representing the product
+ * @throws Error if fewer than 2 arguments provided
+ *
+ * @example
+ * ```typescript
+ * // tag('PER_TOKEN') * 100
+ * const product = mul(tag('PER_TOKEN'), 100);
+ * ```
+ */
+export declare function mul<T extends string = string>(...args: ExprInput<T>[]): OpExpr<T>;
+/**
+ * Create a division expression.
+ * Divides the first argument by subsequent arguments: arg1 / arg2 / arg3 / ...
+ *
+ * Note: The backend performs integer division. Results are truncated, not rounded.
+ *
+ * @param args - Two or more expressions or numbers (cents) to divide
+ * @returns An OpExpr representing the quotient
+ * @throws Error if fewer than 2 arguments provided
+ * @throws Error if any literal divisor is 0 (detected at build time)
+ *
+ * @example
+ * ```typescript
+ * // tag('TOTAL') / 2
+ * const half = div(tag('TOTAL'), 2);
+ * ```
+ */
+export declare function div<T extends string = string>(...args: ExprInput<T>[]): OpExpr<T>;
+/**
+ * Create an amount expression from a number of cents.
+ * This is useful when you need to explicitly create an AmountExpr
+ * rather than relying on auto-conversion.
+ *
+ * @param cents - The amount in cents (must be an integer)
+ * @returns An AmountExpr representing the amount
+ * @throws Error if cents is not a finite integer
+ *
+ * @example
+ * ```typescript
+ * const fee = amount(250); // 250 cents = $2.50
+ * ```
+ */
+export declare function amount(cents: number): AmountExpr;
+/**
+ * Create an inputTokens placeholder expression.
+ * Represents the actual inputTokens value from an AI token usage payload.
+ *
+ * Only valid in expressions used with aiTokenStreamConsumer.
+ * The placeholder is resolved SDK-side to an AmountExpr before serialization.
+ *
+ * @returns An InputTokensExpr placeholder
+ *
+ * @example
+ * ```typescript
+ * // Per-token pricing: INPUT_RATE * actual input tokens
+ * const inputExpr = mul(tag('INPUT_RATE'), inputTokens());
+ * ```
+ */
+export declare function inputTokens(): InputTokensExpr;
+/**
+ * Create an outputTokens placeholder expression.
+ * Represents the actual outputTokens value from an AI token usage payload.
+ *
+ * Only valid in expressions used with aiTokenStreamConsumer.
+ * The placeholder is resolved SDK-side to an AmountExpr before serialization.
+ *
+ * @returns An OutputTokensExpr placeholder
+ *
+ * @example
+ * ```typescript
+ * // Per-token pricing: OUTPUT_RATE * actual output tokens
+ * const outputExpr = mul(tag('OUTPUT_RATE'), outputTokens());
+ * ```
+ */
+export declare function outputTokens(): OutputTokensExpr;
+/**
+ * Create a reference to a persisted expression stored in the backend.
+ * Expression names must be ALL CAPS with underscores (e.g., MY_EXPR).
+ *
+ * @param name - The name of the persisted expression
+ * @returns An ExprRef referencing the named expression
+ * @throws Error if name is empty or invalid format
+ *
+ * @example
+ * ```typescript
+ * const expr = biller.expr("MY_EXPR");
+ * // or standalone:
+ * const expr = expr("MY_EXPR");
+ * ```
+ */
+export declare function expr(name: string): ExprRef;
+//# sourceMappingURL=builders.d.ts.map

package/dist/core/pricing/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/core/pricing/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,MAAM,EACN,eAAe,EACf,gBAAgB,EAEhB,SAAS,EACT,OAAO,EAER,MAAM,YAAY,CAAC;AAiBpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAIzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAQjF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAQjF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAQjF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAQjF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAIhD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,IAAI,eAAe,CAE7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,CAE/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI1C"}

package/dist/core/pricing/builders.js

@@ -0,0 +1,218 @@
+/**
+ * Pricing DSL Builder Functions
+ *
+ * This module provides the fluent builder functions for constructing
+ * type-safe pricing expressions. These functions perform light validation
+ * and build the AST that gets serialized to a string for the backend.
+ *
+ * @example
+ * ```typescript
+ * import { add, mul, tag } from '@scrawn/core';
+ *
+ * // (PREMIUM_CALL * 3) + EXTRA_FEE + 250 cents
+ * const expr = add(mul(tag('PREMIUM_CALL'), 3), tag('EXTRA_FEE'), 250);
+ * ```
+ */
+import { validateExpr } from "./validate.js";
+/**
+ * Convert an ExprInput (PriceExpr or number) to a PriceExpr.
+ * Numbers are wrapped as AmountExpr (cents).
+ */
+function toExpr(input) {
+    if (typeof input === "number") {
+        return { kind: "amount", value: input };
+    }
+    if ("_expr" in input) {
+        return input._expr;
+    }
+    return input;
+}
+/**
+ * Create a tag reference expression.
+ * Tags are resolved to their cent values by the backend.
+ *
+ * @param name - The name of the price tag (must be ALL CAPS with underscores only, e.g., PREMIUM_CALL, FEE)
+ * @returns A TagExpr referencing the named tag
+ * @throws Error if name is empty, whitespace-only, or not ALL_CAPS format
+ *
+ * @example
+ * ```typescript
+ * const premiumTag = tag('PREMIUM_CALL');
+ * ```
+ */
+export function tag(name) {
+    const expr = { kind: "tag", name };
+    validateExpr(expr); // Will throw if invalid
+    return expr;
+}
+/**
+ * Create an addition expression.
+ * Adds all arguments together: arg1 + arg2 + arg3 + ...
+ *
+ * @param args - Two or more expressions or numbers (cents) to add
+ * @returns An OpExpr representing the sum
+ * @throws Error if fewer than 2 arguments provided
+ *
+ * @example
+ * ```typescript
+ * // 100 + 200 + tag('BONUS')
+ * const sum = add(100, 200, tag('BONUS'));
+ * ```
+ */
+export function add(...args) {
+    const expr = {
+        kind: "op",
+        op: "ADD",
+        args: args.map(toExpr),
+    };
+    validateExpr(expr);
+    return expr;
+}
+/**
+ * Create a subtraction expression.
+ * Subtracts subsequent arguments from the first: arg1 - arg2 - arg3 - ...
+ *
+ * @param args - Two or more expressions or numbers (cents) to subtract
+ * @returns An OpExpr representing the difference
+ * @throws Error if fewer than 2 arguments provided
+ *
+ * @example
+ * ```typescript
+ * // tag('TOTAL') - 50
+ * const diff = sub(tag('TOTAL'), 50);
+ * ```
+ */
+export function sub(...args) {
+    const expr = {
+        kind: "op",
+        op: "SUB",
+        args: args.map(toExpr),
+    };
+    validateExpr(expr);
+    return expr;
+}
+/**
+ * Create a multiplication expression.
+ * Multiplies all arguments together: arg1 * arg2 * arg3 * ...
+ *
+ * @param args - Two or more expressions or numbers (cents) to multiply
+ * @returns An OpExpr representing the product
+ * @throws Error if fewer than 2 arguments provided
+ *
+ * @example
+ * ```typescript
+ * // tag('PER_TOKEN') * 100
+ * const product = mul(tag('PER_TOKEN'), 100);
+ * ```
+ */
+export function mul(...args) {
+    const expr = {
+        kind: "op",
+        op: "MUL",
+        args: args.map(toExpr),
+    };
+    validateExpr(expr);
+    return expr;
+}
+/**
+ * Create a division expression.
+ * Divides the first argument by subsequent arguments: arg1 / arg2 / arg3 / ...
+ *
+ * Note: The backend performs integer division. Results are truncated, not rounded.
+ *
+ * @param args - Two or more expressions or numbers (cents) to divide
+ * @returns An OpExpr representing the quotient
+ * @throws Error if fewer than 2 arguments provided
+ * @throws Error if any literal divisor is 0 (detected at build time)
+ *
+ * @example
+ * ```typescript
+ * // tag('TOTAL') / 2
+ * const half = div(tag('TOTAL'), 2);
+ * ```
+ */
+export function div(...args) {
+    const expr = {
+        kind: "op",
+        op: "DIV",
+        args: args.map(toExpr),
+    };
+    validateExpr(expr);
+    return expr;
+}
+/**
+ * Create an amount expression from a number of cents.
+ * This is useful when you need to explicitly create an AmountExpr
+ * rather than relying on auto-conversion.
+ *
+ * @param cents - The amount in cents (must be an integer)
+ * @returns An AmountExpr representing the amount
+ * @throws Error if cents is not a finite integer
+ *
+ * @example
+ * ```typescript
+ * const fee = amount(250); // 250 cents = $2.50
+ * ```
+ */
+export function amount(cents) {
+    const expr = { kind: "amount", value: cents };
+    validateExpr(expr);
+    return expr;
+}
+/**
+ * Create an inputTokens placeholder expression.
+ * Represents the actual inputTokens value from an AI token usage payload.
+ *
+ * Only valid in expressions used with aiTokenStreamConsumer.
+ * The placeholder is resolved SDK-side to an AmountExpr before serialization.
+ *
+ * @returns An InputTokensExpr placeholder
+ *
+ * @example
+ * ```typescript
+ * // Per-token pricing: INPUT_RATE * actual input tokens
+ * const inputExpr = mul(tag('INPUT_RATE'), inputTokens());
+ * ```
+ */
+export function inputTokens() {
+    return { kind: "inputTokens" };
+}
+/**
+ * Create an outputTokens placeholder expression.
+ * Represents the actual outputTokens value from an AI token usage payload.
+ *
+ * Only valid in expressions used with aiTokenStreamConsumer.
+ * The placeholder is resolved SDK-side to an AmountExpr before serialization.
+ *
+ * @returns An OutputTokensExpr placeholder
+ *
+ * @example
+ * ```typescript
+ * // Per-token pricing: OUTPUT_RATE * actual output tokens
+ * const outputExpr = mul(tag('OUTPUT_RATE'), outputTokens());
+ * ```
+ */
+export function outputTokens() {
+    return { kind: "outputTokens" };
+}
+/**
+ * Create a reference to a persisted expression stored in the backend.
+ * Expression names must be ALL CAPS with underscores (e.g., MY_EXPR).
+ *
+ * @param name - The name of the persisted expression
+ * @returns An ExprRef referencing the named expression
+ * @throws Error if name is empty or invalid format
+ *
+ * @example
+ * ```typescript
+ * const expr = biller.expr("MY_EXPR");
+ * // or standalone:
+ * const expr = expr("MY_EXPR");
+ * ```
+ */
+export function expr(name) {
+    const exprRef = { kind: "exprRef", name };
+    validateExpr(exprRef);
+    return exprRef;
+}
+//# sourceMappingURL=builders.js.map

package/dist/core/pricing/builders.js.map

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

package/dist/core/pricing/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Pricing DSL Module
+ *
+ * Provides a type-safe DSL for building pricing expressions that combine
+ * literal amounts, named price tags, and arithmetic operations.
+ *
+ * @example
+ * ```typescript
+ * import { add, mul, tag, serializeExpr } from '@scrawn/core';
+ *
+ * // Build expression: (PREMIUM_CALL * 3) + EXTRA_FEE + 250 cents
+ * const expr = add(mul(tag('PREMIUM_CALL'), 3), tag('EXTRA_FEE'), 250);
+ *
+ * // Serialize for backend: "add(mul(tag('PREMIUM_CALL'),3),tag('EXTRA_FEE'),250)"
+ * const exprString = serializeExpr(expr);
+ *
+ * // Use in event payload
+ * await scrawn.basicUsageEventConsumer({
+ *   userId: 'u123',
+ *   debitExpr: expr
+ * });
+ * ```
+ */
+export type { OpType, AmountExpr, TagExpr, OpExpr, InputTokensExpr, OutputTokensExpr, ExprRef, ScrawnExpr, PriceExpr, ExprInput, } from "./types.js";
+export { tag, add, sub, mul, div, amount, inputTokens, outputTokens, expr } from "./builders.js";
+export { serializeExpr, prettyPrintExpr } from "./serialize.js";
+export { validateExpr, isValidExpr, containsTokenExpr, PricingExpressionError, } from "./validate.js";
+export { resolveTokens } from "./resolve.js";
+export type { TokenContext } from "./resolve.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/pricing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/pricing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,YAAY,EACV,MAAM,EACN,UAAU,EACV,OAAO,EACP,MAAM,EACN,eAAe,EACf,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,SAAS,EACT,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGjG,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGhE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/pricing/index.js

@@ -0,0 +1,32 @@
+/**
+ * Pricing DSL Module
+ *
+ * Provides a type-safe DSL for building pricing expressions that combine
+ * literal amounts, named price tags, and arithmetic operations.
+ *
+ * @example
+ * ```typescript
+ * import { add, mul, tag, serializeExpr } from '@scrawn/core';
+ *
+ * // Build expression: (PREMIUM_CALL * 3) + EXTRA_FEE + 250 cents
+ * const expr = add(mul(tag('PREMIUM_CALL'), 3), tag('EXTRA_FEE'), 250);
+ *
+ * // Serialize for backend: "add(mul(tag('PREMIUM_CALL'),3),tag('EXTRA_FEE'),250)"
+ * const exprString = serializeExpr(expr);
+ *
+ * // Use in event payload
+ * await scrawn.basicUsageEventConsumer({
+ *   userId: 'u123',
+ *   debitExpr: expr
+ * });
+ * ```
+ */
+// Export builder functions
+export { tag, add, sub, mul, div, amount, inputTokens, outputTokens, expr } from "./builders.js";
+// Export serialization
+export { serializeExpr, prettyPrintExpr } from "./serialize.js";
+// Export validation
+export { validateExpr, isValidExpr, containsTokenExpr, PricingExpressionError, } from "./validate.js";
+// Export token resolution
+export { resolveTokens } from "./resolve.js";
+//# sourceMappingURL=index.js.map

package/dist/core/pricing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/pricing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAgBH,2BAA2B;AAC3B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAEjG,uBAAuB;AACvB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEhE,oBAAoB;AACpB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,0BAA0B;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/pricing/resolve.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Token Placeholder Resolution
+ *
+ * This module provides the resolveTokens() function that replaces
+ * inputTokens() / outputTokens() placeholder nodes in a pricing expression
+ * with concrete AmountExpr values from an AI token usage payload.
+ *
+ * Resolution happens SDK-side before serialization, so the backend
+ * only sees normal expressions with concrete numbers.
+ */
+import type { PriceExpr } from "./types.js";
+/**
+ * Context for resolving token placeholders.
+ * Contains the actual token counts from an AI token usage payload.
+ */
+export interface TokenContext {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+}
+/**
+ * Deeply traverse a PriceExpr tree and replace InputTokensExpr / OutputTokensExpr
+ * placeholder nodes with AmountExpr nodes using actual values from the context.
+ *
+ * Returns a new expression tree with all token placeholders resolved.
+ * The original tree is not mutated.
+ *
+ * @param expr - The expression tree (may contain token placeholders)
+ * @param context - The actual inputTokens/outputTokens values
+ * @returns A new PriceExpr tree with all token placeholders replaced by AmountExpr nodes
+ *
+ * @example
+ * ```typescript
+ * const expr = mul(tag('INPUT_RATE'), inputTokens());
+ * const resolved = resolveTokens(expr, { inputTokens: 150, outputTokens: 50 });
+ * // resolved is: mul(tag('INPUT_RATE'), 150)
+ * ```
+ */
+export declare function resolveTokens(expr: PriceExpr<string>, context: TokenContext): PriceExpr<string>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/core/pricing/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/core/pricing/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAoB/F"}

package/dist/core/pricing/resolve.js

@@ -0,0 +1,50 @@
+/**
+ * Token Placeholder Resolution
+ *
+ * This module provides the resolveTokens() function that replaces
+ * inputTokens() / outputTokens() placeholder nodes in a pricing expression
+ * with concrete AmountExpr values from an AI token usage payload.
+ *
+ * Resolution happens SDK-side before serialization, so the backend
+ * only sees normal expressions with concrete numbers.
+ */
+/**
+ * Deeply traverse a PriceExpr tree and replace InputTokensExpr / OutputTokensExpr
+ * placeholder nodes with AmountExpr nodes using actual values from the context.
+ *
+ * Returns a new expression tree with all token placeholders resolved.
+ * The original tree is not mutated.
+ *
+ * @param expr - The expression tree (may contain token placeholders)
+ * @param context - The actual inputTokens/outputTokens values
+ * @returns A new PriceExpr tree with all token placeholders replaced by AmountExpr nodes
+ *
+ * @example
+ * ```typescript
+ * const expr = mul(tag('INPUT_RATE'), inputTokens());
+ * const resolved = resolveTokens(expr, { inputTokens: 150, outputTokens: 50 });
+ * // resolved is: mul(tag('INPUT_RATE'), 150)
+ * ```
+ */
+export function resolveTokens(expr, context) {
+    switch (expr.kind) {
+        case "inputTokens": {
+            const resolved = { kind: "amount", value: context.inputTokens };
+            return resolved;
+        }
+        case "outputTokens": {
+            const resolved = { kind: "amount", value: context.outputTokens };
+            return resolved;
+        }
+        case "op": {
+            const resolvedArgs = expr.args.map((arg) => resolveTokens(arg, context));
+            return { kind: "op", op: expr.op, args: resolvedArgs };
+        }
+        case "amount":
+        case "tag":
+        case "exprRef":
+            // These nodes don't contain token placeholders — return as-is
+            return expr;
+    }
+}
+//# sourceMappingURL=resolve.js.map

package/dist/core/pricing/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/core/pricing/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAAC,IAAuB,EAAE,OAAqB;IAC1E,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,QAAQ,GAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;YAC5E,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,QAAQ,GAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;YAC7E,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,KAAK,IAAI,CAAC,CAAC,CAAC;YACV,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;YACzE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QACzD,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,KAAK,CAAC;QACX,KAAK,SAAS;YACZ,8DAA8D;YAC9D,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/core/pricing/serialize.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Pricing DSL Serialization
+ *
+ * This module converts typed pricing expression ASTs into string format
+ * that the backend can parse and evaluate.
+ *
+ * Output format examples:
+ * - Amount: 250
+ * - Tag: tag(PREMIUM_CALL)
+ * - Addition: add(100,tag(FEE),250)
+ * - Complex: add(mul(tag(PREMIUM_CALL),3),tag(EXTRA_FEE),250)
+ *
+ * The format is designed to be:
+ * - Unambiguous (parseable by the backend)
+ * - Human-readable (for debugging)
+ * - Compact (minimal whitespace, no quotes around tag names)
+ */
+import type { PriceExpr } from "./types.js";
+/**
+ * Serialize a pricing expression to a string.
+ *
+ * @param expr - The expression to serialize
+ * @returns A string representation that the backend can parse
+ *
+ * @example
+ * ```typescript
+ * const expr = add(mul(tag('PREMIUM'), 3), 100);
+ * const str = serializeExpr(expr);
+ * // "add(mul(tag(PREMIUM),3),100)"
+ * ```
+ */
+export declare function serializeExpr(expr: PriceExpr<string>): string;
+/**
+ * Pretty-print a pricing expression with indentation.
+ * Useful for debugging and logging.
+ *
+ * @param expr - The expression to format
+ * @param indent - Number of spaces for indentation (default 2)
+ * @returns A formatted, multi-line string representation
+ *
+ * @example
+ * ```typescript
+ * const expr = add(mul(tag('PREMIUM'), 3), 100);
+ * console.log(prettyPrintExpr(expr));
+ * // add(
+ * //   mul(
+ * //     tag(PREMIUM),
+ * //     3
+ * //   ),
+ * //   100
+ * // )
+ * ```
+ */
+export declare function prettyPrintExpr(expr: PriceExpr<string>, indent?: number): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/core/pricing/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/core/pricing/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAA+B,MAAM,YAAY,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAuB7D;AA6BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAEnF"}