@kontor/kontor-sdk 1.0.0-alpha.3 → 1.0.0-alpha.5

package/dist/src/sdk/utils/kwit/codecs/decimal.js

@@ -0,0 +1,165 @@
+import * as z from "zod";
+const TARGET_SCALE = 18;
+const U64_MAX = (1n << 64n) - 1n;
+export const U64 = z
+    .bigint()
+    .min(0n, { message: "must be ≥ 0" })
+    .max(U64_MAX, { message: "must be ≤ 2^64-1" });
+function pow10n(n) {
+    if (n < 0)
+        throw new Error("pow10n expects n ≥ 0");
+    let p = 1n;
+    for (let i = 0; i < n; i++)
+        p *= 10n;
+    return p;
+}
+// const fromLimbs = ({ r0, r1, r2, r3 }: _Decimal.T) =>
+//   (r3 << 192n) | (r2 << 128n) | (r1 << 64n) | r0;
+function splitToU64Limbs(x) {
+    const r0 = x & U64_MAX;
+    const r1 = (x >> 64n) & U64_MAX;
+    const r2 = (x >> 128n) & U64_MAX;
+    const r3 = (x >> 192n) & U64_MAX;
+    // overflow if any higher bits remain
+    if (x >> 256n !== 0n) {
+        throw new Error("decimal magnitude does not fit in 256 bits");
+    }
+    return { r0, r1, r2, r3 };
+}
+export var _Decimal;
+(function (_Decimal) {
+    let Sign;
+    (function (Sign) {
+        Sign.schema = z.enum(["plus", "minus"]);
+    })(Sign = _Decimal.Sign || (_Decimal.Sign = {}));
+    // Raw limbs + sign; limbs are real u64 (bigint), not JS numbers
+    _Decimal.schema = z.object({
+        r0: U64,
+        r1: U64,
+        r2: U64,
+        r3: U64,
+        sign: Sign.schema,
+    });
+})(_Decimal || (_Decimal = {}));
+/**
+ * Parses a wave-ish struct like:
+ *   "{ r0: 1337, r1: 0, r2: 0, r3: 0, sign: plus }"
+ * Returns a validated _Decimal.T with bigint limbs.
+ */
+export function parseDecimalWaveExpr(expr) {
+    const trimmed = expr.trim();
+    // Optional braces; tolerate with or without
+    const inner = trimmed.replace(/^\{\s*/, "").replace(/\s*\}$/, "");
+    if (inner.length === 0) {
+        throw new Error("empty decimal expression");
+    }
+    // Split by commas that separate top-level pairs (no nesting expected here)
+    const parts = inner
+        .split(",")
+        .map((p) => p.trim())
+        .filter(Boolean);
+    const seen = new Set();
+    // Default r1..r3 to 0 for ergonomics; require r0 + sign at minimum.
+    let out = {
+        r1: 0n,
+        r2: 0n,
+        r3: 0n,
+    };
+    for (const part of parts) {
+        const idx = part.indexOf(":");
+        if (idx === -1) {
+            throw new Error(`expected "key: value" pair, got "${part}"`);
+        }
+        const keyRaw = part.slice(0, idx).trim();
+        const valRaw = part.slice(idx + 1).trim();
+        if (seen.has(keyRaw)) {
+            throw new Error(`duplicate key "${keyRaw}"`);
+        }
+        seen.add(keyRaw);
+        switch (keyRaw) {
+            case "r0":
+            case "r1":
+            case "r2":
+            case "r3": {
+                // allow underscores for readability, like Rust literals
+                const normalized = valRaw.replace(/_/g, "");
+                // BigInt constructor handles decimal strings; reject non-integers explicitly
+                if (!/^[+-]?\d+$/.test(normalized)) {
+                    throw new Error(`invalid integer for ${keyRaw}: "${valRaw}"`);
+                }
+                const limb = BigInt(normalized);
+                // zod will re-validate bounds, but fail fast here for nicer messages
+                if (limb < 0n || limb > U64_MAX) {
+                    throw new Error(`value for ${keyRaw} out of u64 range: ${valRaw}`);
+                }
+                out[keyRaw] = limb;
+                break;
+            }
+            case "sign": {
+                if (valRaw !== "plus" && valRaw !== "minus") {
+                    throw new Error(`invalid sign "${valRaw}" (expected plus|minus)`);
+                }
+                out.sign = valRaw;
+                break;
+            }
+            default:
+                throw new Error(`unexpected key "${keyRaw}"`);
+        }
+    }
+    // Require at least r0 and sign (r1..r3 default to 0 if not given)
+    if (out.r0 === undefined) {
+        throw new Error(`missing required key "r0"`);
+    }
+    if (!out.sign) {
+        throw new Error(`missing required key "sign"`);
+    }
+    // Final validation & typing
+    return _Decimal.schema.parse(out);
+}
+class _DecimalCodec {
+    constructor(data) {
+        Object.defineProperty(this, "data", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.data = data;
+    }
+    static fromJs(value, targetScale = TARGET_SCALE) {
+        // dn.Dnum is effectively [coef, decimals]
+        const [coefRaw, decs] = value;
+        const sign = coefRaw < 0n ? "minus" : "plus";
+        const coefAbs = coefRaw < 0n ? -coefRaw : coefRaw;
+        if (decs > decs) {
+            // would require rounding; be strict
+            throw new Error(`cannot downscale from ${decs} to ${targetScale} decimals without rounding`);
+        }
+        // upscale to target scale exactly
+        const scaleDelta = targetScale - decs;
+        const scaled = coefAbs * pow10n(scaleDelta);
+        const { r0, r1, r2, r3 } = splitToU64Limbs(scaled);
+        const out = _Decimal.schema.parse({ r0, r1, r2, r3, sign });
+        return new _DecimalCodec(out);
+    }
+    static fromKontor(data) {
+        return new _DecimalCodec(data);
+    }
+    static parseWave(expr) {
+        return _Decimal.schema.parse(parseDecimalWaveExpr(expr));
+    }
+    toJs() {
+        const mag = (BigInt(this.data.r3) << 192n) |
+            (BigInt(this.data.r2) << 128n) |
+            (BigInt(this.data.r1) << 64n) |
+            BigInt(this.data.r0);
+        const signed = this.data.sign === "minus" ? -mag : mag;
+        return [signed, 18];
+    }
+    toWave() {
+        // NOTE: adjust quoting on sign if your Wave syntax needs `"plus"` etc.
+        return `{r0: ${this.data.r0}, r1: ${this.data.r1}, r2: ${this.data.r2}, r3: ${this.data.r3}, sign: ${this.data.sign}}`;
+    }
+}
+export const DecimalCodec = _DecimalCodec;
+//# sourceMappingURL=decimal.js.map

package/dist/src/sdk/utils/kwit/codecs/decimal.js.map

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

package/dist/src/sdk/utils/kwit/codecs/enum.js

@@ -0,0 +1,104 @@
+import * as z from "zod";
+export var Enum;
+(function (Enum) {
+    let Parens;
+    (function (Parens) {
+        Parens.schema = z.templateLiteral([
+            z.literal("("),
+            z.string(),
+            z.literal(")"),
+        ]);
+    })(Parens = Enum.Parens || (Enum.Parens = {}));
+    let Option;
+    (function (Option) {
+        // some(foo) or some( foo bar ) or even some()
+        // also allow just "some" ??? we'll decide below.
+        Option.waveRegex = /^(?<kind>some)(?:\((?<value>[\s\S]*?)\))$|^(?<none>none)$/;
+        // We'll keep these tiny sub-schemas because they're readable elsewhere.
+        let None;
+        (function (None) {
+            None.schema = z.literal("none");
+        })(None = Option.None || (Option.None = {}));
+        let Some;
+        (function (Some) {
+            // NOTE: we REQUIRE parens for "some(...)"
+            // If you want plain "some" to be valid, we could relax later.
+            Some.schema = z.templateLiteral([
+                z.literal("some"),
+                Parens.schema,
+            ]);
+        })(Some = Option.Some || (Option.Some = {}));
+        // Raw union of the spellings we accept as input
+        // e.g. "none" or "some(<stuff>)"
+        const rawSchema = z.union([None.schema, Some.schema]);
+        // Transform raw string -> { kind: "none" | "some"; value: string | null }
+        // Then pipe into a discriminated union so .infer<> is nice & strict.
+        Option.schema = rawSchema
+            .transform((expr) => {
+            const trimmed = expr.trim();
+            // Fast path for "none"
+            if (trimmed === "none") {
+                return {
+                    kind: "none",
+                };
+            }
+            // else parse "some(...)"
+            const match = /^some\((?<value>[\s\S]*?)\)$/.exec(trimmed);
+            if (!match?.groups) {
+                throw new Error(`invariant: invalid wave option expression: ${expr}`);
+            }
+            const value = match.groups.value?.trim() ?? "";
+            return {
+                kind: "some",
+                value: value === "" ? null : value,
+            };
+        })
+            .pipe(z.discriminatedUnion("kind", [
+            z.object({
+                kind: z.literal("none"),
+            }),
+            z.object({
+                kind: z.literal("some"),
+                value: z.string().nullable(), // raw value contents or null (for `some()`)
+            }),
+        ]));
+    })(Option = Enum.Option || (Enum.Option = {}));
+    let Result;
+    (function (Result) {
+        Result.waveRegex = /^(?<_tag>ok|err)(?:\((?<value>[\s\S]*?)\))?$/;
+        let Ok;
+        (function (Ok) {
+            Ok.schema = z.literal("ok");
+        })(Ok = Result.Ok || (Result.Ok = {}));
+        let Err;
+        (function (Err) {
+            Err.schema = z.literal("err");
+        })(Err = Result.Err || (Result.Err = {}));
+        Result.schema = z
+            .templateLiteral([
+            z.union([Ok.schema, Err.schema]),
+            Parens.schema.optional(),
+        ])
+            .transform((expr) => {
+            const match = Result.waveRegex.exec(expr.trim());
+            if (!match?.groups) {
+                throw new Error(`invariant: invalid wave expression: ${expr}`);
+            }
+            const { _tag, value } = match.groups;
+            return { _tag, value: value?.trim() || null };
+        })
+            .pipe(
+        // lock the output into a discriminated union so z.infer<> is nice
+        z.discriminatedUnion("_tag", [
+            z.object({
+                _tag: Ok.schema, // "ok"
+                value: z.string().nullable(), // raw value text (we haven't parsed r0..sign here)
+            }),
+            z.object({
+                _tag: Err.schema, // "err"
+                value: z.string().nullable(), // err(message("...")) -> 'message("...")' or null
+            }),
+        ]));
+    })(Result = Enum.Result || (Enum.Result = {}));
+})(Enum || (Enum = {}));
+//# sourceMappingURL=enum.js.map

package/dist/src/sdk/utils/kwit/codecs/enum.js.map

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

package/dist/src/sdk/utils/kwit/codecs/integer.js

@@ -0,0 +1,167 @@
+// integer.ts
+// TODO: i may want to simplify this later
+//
+import * as z from "zod";
+const U64_MAX = (1n << 64n) - 1n;
+export const U64 = z
+    .bigint()
+    .min(0n, { message: "must be ≥ 0" })
+    .max(U64_MAX, { message: "must be ≤ 2^64-1" });
+export function parseIntegerWaveExpr(expr) {
+    const inner = expr
+        .trim()
+        .replace(/^\{\s*/, "")
+        .replace(/\s*\}$/, "");
+    if (!inner)
+        throw new Error("empty integer expression");
+    const parts = inner
+        .split(",")
+        .map((p) => p.trim())
+        .filter(Boolean);
+    const seen = new Set();
+    // Default middle limbs to 0 for ergonomics; require r0 + sign.
+    let out = {
+        r1: 0n,
+        r2: 0n,
+        r3: 0n,
+    };
+    for (const part of parts) {
+        const idx = part.indexOf(":");
+        if (idx === -1) {
+            throw new Error(`expected "key: value", got "${part}"`);
+        }
+        const keyRaw = part.slice(0, idx).trim();
+        const valRaw = part.slice(idx + 1).trim();
+        if (seen.has(keyRaw))
+            throw new Error(`duplicate key "${keyRaw}"`);
+        seen.add(keyRaw);
+        switch (keyRaw) {
+            case "r0":
+            case "r1":
+            case "r2":
+            case "r3": {
+                const normalized = valRaw.replace(/_/g, "");
+                if (!/^[+-]?\d+$/.test(normalized)) {
+                    throw new Error(`invalid integer for ${keyRaw}: "${valRaw}"`);
+                }
+                const limb = BigInt(normalized);
+                if (limb < 0n || limb > U64_MAX) {
+                    throw new Error(`value for ${keyRaw} out of u64 range: ${valRaw}`);
+                }
+                out[keyRaw] = limb;
+                break;
+            }
+            case "sign": {
+                if (valRaw !== "plus" && valRaw !== "minus") {
+                    throw new Error(`invalid sign "${valRaw}" (expected plus|minus)`);
+                }
+                out.sign = valRaw;
+                break;
+            }
+            default:
+                throw new Error(`unexpected key "${keyRaw}"`);
+        }
+    }
+    if (out.r0 === undefined)
+        throw new Error(`missing required key "r0"`);
+    if (!out.sign)
+        throw new Error(`missing required key "sign"`);
+    return _Integer.schema.parse(out);
+}
+// function parseIntegerWaveExpr(expr: string): _IntegerRaw.T {
+//   // strip { ... }
+//   const inner = expr.trim().replace(/^\{|\}$/g, "");
+//
+//   // split at commas at top level
+//   // e.g. ["r0: 1337", "r1: 0", "r2: 0", "r3: 0", "sign: Plus"]
+//   const parts = inner.split(",").map((p) => p.trim());
+//
+//   const out: any = {};
+//   for (const part of parts) {
+//     const [keyRaw, valRaw] = part.split(":").map((s) => s.trim());
+//
+//     if (
+//       keyRaw === "r0" ||
+//       keyRaw === "r1" ||
+//       keyRaw === "r2" ||
+//       keyRaw === "r3"
+//     ) {
+//       out[keyRaw] = Number(valRaw);
+//       continue;
+//     }
+//
+//     if (keyRaw === "sign") {
+//       if (valRaw !== "Plus" && valRaw !== "Minus") {
+//         throw new Error(`invalid sign '${valRaw}' in ${expr}`);
+//       }
+//       out.sign = valRaw;
+//       continue;
+//     }
+//
+//     throw new Error(`unexpected key '${keyRaw}' in ${expr}`);
+//   }
+//
+//   // validate with zod, return typed
+//   return _IntegerRaw.schema.parse(out);
+// }
+export var _Integer;
+(function (_Integer) {
+    let Sign;
+    (function (Sign) {
+        Sign.schema = z.enum(["plus", "minus"]);
+    })(Sign = _Integer.Sign || (_Integer.Sign = {}));
+    _Integer.schema = z.object({
+        r0: U64,
+        r1: U64,
+        r2: U64,
+        r3: U64,
+        sign: Sign.schema,
+    });
+})(_Integer || (_Integer = {}));
+// --- IntegerCodec ------------------------------------------------
+// Instance class: represents one integer value in limb/sign form,
+// and can render toWave() / toJs().
+class _IntegerCodec {
+    constructor(data) {
+        Object.defineProperty(this, "data", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.data = data;
+    }
+    static fromJs(value) {
+        let v = BigInt(value);
+        const sign = v < 0n ? "minus" : "plus";
+        if (v < 0n)
+            v = -v;
+        // break absolute value into four 32-bit limbs (little-endian style)
+        const mask32 = (1n << 32n) - 1n;
+        const r0 = v & mask32;
+        const r1 = (v >> 32n) & mask32;
+        const r2 = (v >> 64n) & mask32;
+        const r3 = (v >> 96n) & mask32;
+        return new _IntegerCodec({ r0, r1, r2, r3, sign });
+    }
+    static fromKontor(data) {
+        return new _IntegerCodec(data);
+    }
+    static parseWave(expr) {
+        return _Integer.schema.parse(parseIntegerWaveExpr(expr));
+    }
+    // instance -> WaveExpr
+    toWave() {
+        return `{r0: ${this.data.r0}, r1: ${this.data.r1}, r2: ${this.data.r2}, r3: ${this.data.r3}, sign: ${this.data.sign}}`;
+    }
+    // instance -> JS bigint
+    toJs() {
+        const value = (BigInt(this.data.r3) << 96n) |
+            (BigInt(this.data.r2) << 64n) |
+            (BigInt(this.data.r1) << 32n) |
+            BigInt(this.data.r0);
+        return this.data.sign === "minus" ? -value : value;
+    }
+}
+export const IntegerCodec = _IntegerCodec;
+//# sourceMappingURL=integer.js.map

package/dist/src/sdk/utils/kwit/codecs/integer.js.map

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

package/dist/src/sdk/utils/kwit/codecs/list.js

@@ -0,0 +1,117 @@
+/**
+ * Instance that represents a decoded list<Inner> value.
+ *
+ * Generic parameterization is on the *inner codec constructor* so that
+ * the JS type of this list instance is always ListJs<CodecJs<InnerC>>.
+ */
+export class ListCodecFactory {
+    constructor(innerCodec, data) {
+        Object.defineProperty(this, "innerCodec", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: innerCodec
+        });
+        Object.defineProperty(this, "data", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: data
+        });
+    }
+    toWave() {
+        // Convert array of inner wave expressions back to array syntax
+        const innerWaves = this.data.join(", ");
+        return `[${innerWaves}]`;
+    }
+    toJs() {
+        // Decode each element using the inner codec
+        return this.data.map((innerWave) => {
+            // 1) parse inner WaveExpr → inner WaveData
+            const innerWaveData = this.innerCodec.parseWave(innerWave);
+            // 2) WaveData → inner instance
+            const innerInst = this.innerCodec.fromKontor(innerWaveData);
+            // 3) instance → JS
+            return innerInst.toJs();
+        });
+    }
+    // ----- Static factory to build a typed list<T> codec constructor -----
+    static create(innerCodec) {
+        // Class expression implements the static methods required by CodecConstructor
+        class ListCodecClass {
+            constructor(data) {
+                // Internally forward all instance behavior to ListCodecFactory
+                Object.defineProperty(this, "_impl", {
+                    enumerable: true,
+                    configurable: true,
+                    writable: true,
+                    value: void 0
+                });
+                this._impl = new ListCodecFactory(innerCodec, data);
+            }
+            toWave() {
+                return this._impl.toWave();
+            }
+            toJs() {
+                return this._impl.toJs();
+            }
+            // ----- Static methods required by CodecConstructor -----
+            static fromJs(value) {
+                // Convert JS array to array of wave expressions
+                const waveArray = value.map((item) => {
+                    const innerInst = innerCodec.fromJs(item);
+                    return innerInst.toWave();
+                });
+                return new ListCodecClass(waveArray);
+            }
+            static fromKontor(data) {
+                return new ListCodecClass(data);
+            }
+            static parseWave(expr) {
+                // Parse array syntax: "[item1, item2, ...]"
+                const trimmed = expr.trim();
+                // Empty array
+                if (trimmed === "[]") {
+                    return [];
+                }
+                // Remove brackets
+                if (!trimmed.startsWith("[") || !trimmed.endsWith("]")) {
+                    throw new Error(`Expected array syntax [...], got: ${expr}`);
+                }
+                const inner = trimmed.slice(1, -1).trim();
+                if (inner === "") {
+                    return [];
+                }
+                // Split by commas at the top level (respecting nested structures)
+                const items = [];
+                let depth = 0;
+                let current = "";
+                for (let i = 0; i < inner.length; i++) {
+                    const char = inner[i];
+                    if (char === "{" || char === "[" || char === "(") {
+                        depth++;
+                        current += char;
+                    }
+                    else if (char === "}" || char === "]" || char === ")") {
+                        depth--;
+                        current += char;
+                    }
+                    else if (char === "," && depth === 0) {
+                        items.push(current.trim());
+                        current = "";
+                    }
+                    else {
+                        current += char;
+                    }
+                }
+                // Add last item
+                if (current.trim()) {
+                    items.push(current.trim());
+                }
+                return items;
+            }
+        }
+        return ListCodecClass;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/src/sdk/utils/kwit/codecs/list.js.map

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