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

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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"}

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

@@ -0,0 +1,91 @@
+import { Enum } from "./enum.js";
+export const KontorOption = Enum.Option;
+/**
+ * Instance that represents a decoded option<Inner> value.
+ *
+ * Generic parameterization is on the *inner codec constructor* so that
+ * the JS type of this option instance is always OptionJs<CodecJs<InnerC>>.
+ */
+export class OptionCodecFactory {
+    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() {
+        if (this.data.kind === "none") {
+            return "none";
+        }
+        // assume data.value is a WaveExpr string for the inner
+        return `some(${this.data.value ?? ""})`;
+    }
+    toJs() {
+        if (this.data.kind === "none") {
+            return { kind: "none" };
+        }
+        if (this.data.value == null) {
+            throw new Error("Option some() has no inner value");
+        }
+        // 1) parse inner WaveExpr → inner WaveData
+        const innerWaveData = this.innerCodec.parseWave(this.data.value);
+        // 2) WaveData → inner instance
+        const innerInst = this.innerCodec.fromKontor(innerWaveData);
+        // 3) instance → JS
+        return { kind: "some", value: innerInst.toJs() };
+    }
+    // ----- Static factory to build a typed option<T> codec constructor -----
+    static create(innerCodec) {
+        // Class expression implements the static methods required by CodecConstructor
+        class OptionCodecClass {
+            constructor(data) {
+                // Internally forward all instance behavior to OptionCodecInstance
+                Object.defineProperty(this, "_impl", {
+                    enumerable: true,
+                    configurable: true,
+                    writable: true,
+                    value: void 0
+                });
+                this._impl = new OptionCodecFactory(innerCodec, data);
+            }
+            // ----- CodecConstructor statics -----
+            static fromJs(value) {
+                if (value.kind === "none") {
+                    return new OptionCodecFactory(innerCodec, { kind: "none" });
+                }
+                // encode inner via innerCodec
+                const innerInst = innerCodec.fromJs(value.value);
+                const innerWave = innerInst.toWave();
+                return new OptionCodecFactory(innerCodec, {
+                    kind: "some",
+                    value: innerWave,
+                });
+            }
+            static parseWave(expr) {
+                // Expect raw "none" or "some(<inner...>)"
+                return Enum.Option.schema.parse(expr);
+            }
+            static fromKontor(data) {
+                return new OptionCodecFactory(innerCodec, data);
+            }
+            // ----- Instance side -----
+            toWave() {
+                return this._impl.toWave();
+            }
+            toJs() {
+                return this._impl.toJs();
+            }
+        }
+        // Satisfy the CodecConstructor contract with precise generics
+        return OptionCodecClass;
+    }
+}
+//# sourceMappingURL=option.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"option.js","sourceRoot":"","sources":["../../../../../../src/sdk/utils/kwit/codecs/option.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;AAKxC;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAI7B,YACmB,UAAkB,EACnB,IAAmB;QADnC;;;;mBAAiB,UAAU;WAAQ;QACnC;;;;mBAAgB,IAAI;WAAe;IAClC,CAAC;IAEJ,MAAM;QACJ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,MAAkB,CAAC;QAC5B,CAAC;QACD,uDAAuD;QACvD,OAAO,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,GAAe,CAAC;IACtD,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,2CAA2C;QAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAC7C,IAAI,CAAC,IAAI,CAAC,KAAK,CACK,CAAC;QAEvB,+BAA+B;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAC1C,aAAa,CACO,CAAC;QAEvB,mBAAmB;QACnB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAqB,EAAE,CAAC;IACtE,CAAC;IAED,0EAA0E;IAE1E,MAAM,CAAC,MAAM,CAGX,UAAkB;QASlB,8EAA8E;QAC9E,MAAM,gBAAgB;YAIpB,YAAY,IAAmB;gBAH/B,kEAAkE;gBACjD;;;;;mBAAkC;gBAGjD,IAAI,CAAC,KAAK,GAAG,IAAI,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACxD,CAAC;YAED,uCAAuC;YAEvC,MAAM,CAAC,MAAM,CACX,KAAgC;gBAEhC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,OAAO,IAAI,kBAAkB,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBACD,8BAA8B;gBAC9B,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,KAAwB,CAAC,CAAC;gBACpE,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;gBACrC,OAAO,IAAI,kBAAkB,CAAC,UAAU,EAAE;oBACxC,IAAI,EAAE,MAAM;oBACZ,KAAK,EAAE,SAAS;iBACjB,CAAC,CAAC;YACL,CAAC;YAED,MAAM,CAAC,SAAS,CAAC,IAAY;gBAC3B,0CAA0C;gBAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;YAED,MAAM,CAAC,UAAU,CAAC,IAAmB;gBACnC,OAAO,IAAI,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAClD,CAAC;YAED,4BAA4B;YAE5B,MAAM;gBACJ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,CAAC;YACD,IAAI;gBACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3B,CAAC;SACF;QAED,8DAA8D;QAC9D,OAAO,gBAIN,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,27 @@
+export const StringCodec = {
+    fromJs(value) {
+        return {
+            toWave() {
+                // Wave syntax for string args: we assume quoted
+                return `"${value}"`;
+            },
+            toJs() {
+                return value;
+            },
+        };
+    },
+    fromKontor(data) {
+        return {
+            toWave() {
+                return `"${data}"`;
+            },
+            toJs() {
+                return data;
+            },
+        };
+    },
+    parseWave(expr) {
+        return JSON.parse(expr);
+    },
+};
+//# sourceMappingURL=string.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../../../../src/sdk/utils/kwit/codecs/string.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,CAAC,KAAa;QAClB,OAAO;YACL,MAAM;gBACJ,gDAAgD;gBAChD,OAAO,IAAI,KAAK,GAAe,CAAC;YAClC,CAAC;YACD,IAAI;gBACF,OAAO,KAAK,CAAC;YACf,CAAC;SACF,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO;YACL,MAAM;gBACJ,OAAO,IAAI,IAAI,GAAe,CAAC;YACjC,CAAC;YACD,IAAI;gBACF,OAAO,IAAc,CAAC;YACxB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACoE,CAAC"}

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

@@ -0,0 +1,45 @@
+export const unit = { _tag: "Unit" };
+// ---------- Encoder: JS → WaveExpr (fully type-safe) ----------
+export class Encoder {
+    constructor(schema) {
+        Object.defineProperty(this, "schema", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: schema
+        });
+    }
+    encode(values) {
+        const out = {};
+        for (const key of Object.keys(this.schema)) {
+            const ctor = this.schema[key];
+            const inst = ctor.fromJs(values[key]);
+            out[key] = inst.toWave();
+        }
+        return out;
+    }
+}
+// ---------- Decoder: WaveExpr → JS (inferred from codec) ----------
+export class Decoder {
+    constructor(codec) {
+        Object.defineProperty(this, "codec", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: codec
+        });
+    }
+    decode(expr) {
+        console.log("in tuple decode");
+        const wave = this.codec.parseWave(expr);
+        console.log({ wave });
+        const inst = this.codec.fromKontor(wave);
+        console.log({ inst });
+        return inst.toJs();
+    }
+}
+// Optional ergonomic helper so callers don't write generics at `new` sites
+export function makeDecoder(codec) {
+    return new Decoder(codec);
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/sdk/utils/kwit/codecs/types.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,IAAI,GAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAuE3C,iEAAiE;AAEjE,MAAM,OAAO,OAAO;IAClB,YAA6B,MAAS;QAA1B;;;;mBAAiB,MAAM;WAAG;IAAG,CAAC;IAE1C,MAAM,CAAC,MAAkB;QACvB,MAAM,GAAG,GAAG,EAAkC,CAAC;QAC/C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAmB,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,qEAAqE;AAErE,MAAM,OAAO,OAAO;IAGlB,YAA6B,KAAQ;QAAzB;;;;mBAAiB,KAAK;WAAG;IAAG,CAAC;IAEzC,MAAM,CAAC,IAAY;QACjB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAiB,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAiB,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC,IAAI,EAAgB,CAAC;IACnC,CAAC;CACF;AAED,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAEzB,KAAQ;IACR,OAAO,IAAI,OAAO,CAAI,KAAK,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,22 @@
+import { unit, } from "./types.js";
+class _UnitCodec {
+    constructor() { }
+    static fromJs(_value) {
+        return new _UnitCodec();
+    }
+    static fromKontor(_data) {
+        return new _UnitCodec();
+    }
+    static parseWave(_expr) {
+        // ok branch payload is conceptually "unit"
+        return unit;
+    }
+    toWave() {
+        return "";
+    }
+    toJs() {
+        return unit;
+    }
+}
+export const UnitCodec = _UnitCodec;
+//# sourceMappingURL=unit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unit.js","sourceRoot":"","sources":["../../../../../../src/sdk/utils/kwit/codecs/unit.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,IAAI,GAEL,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU;IACd,gBAAe,CAAC;IAEhB,MAAM,CAAC,MAAM,CAAC,MAAY;QACxB,OAAO,IAAI,UAAU,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,KAAc;QAC9B,OAAO,IAAI,UAAU,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,KAAa;QAC5B,2CAA2C;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,OAAO,EAAc,CAAC;IACxB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,UAIxB,CAAC"}

package/dist/src/sdk/utils/kwit/decode-function-result.js

@@ -0,0 +1,36 @@
+import { decodeKwitParameter } from "./decode-kwit-parameter.js";
+import { getKwitItem } from "./get-kwit-item.js";
+export function decodeFunctionResult(parameters) {
+    const { kwit, functionName, data } = parameters;
+    let kwitItem = kwit[0];
+    if (functionName) {
+        const item = getKwitItem({ kwit, name: functionName });
+        // todo: refine error
+        // if (!item) throw new KwitFunctionNotFoundError(functionName, { docsPath })
+        if (!item)
+            throw new Error("KwitFunctionNotFoundError");
+        kwitItem = item;
+    }
+    if (kwitItem.type !== "function")
+        // todo: refine error
+        // throw new KwitFunctionNotFoundError(undefined, { docsPath })
+        throw new Error("KwitFunctionNotFoundError");
+    if (!kwitItem.outputs)
+        // todo: refine error
+        // throw new KwitFunctionOutputsNotFoundError(kwitItem.name, { docsPath })
+        throw new Error("KwitFunctionNotFoundError");
+    const value = decodeKwitParameter(data, kwitItem.outputs[0]);
+    // TODO: sholdn't have to index on `decoded` here
+    return value.decoded;
+    //
+    // if (values && values.length > 1)
+    //   return values as DecodeFunctionResultReturnType<kwit, functionName, args>;
+    // if (values && values.length === 1)
+    //   return values[0] as DecodeFunctionResultReturnType<
+    //     kwit,
+    //     functionName,
+    //     args
+    //   >;
+    // return undefined as DecodeFunctionResultReturnType<kwit, functionName, args>;
+}
+//# sourceMappingURL=decode-function-result.js.map

package/dist/src/sdk/utils/kwit/decode-function-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-function-result.js","sourceRoot":"","sources":["../../../../../src/sdk/utils/kwit/decode-function-result.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,WAAW,EAA6B,MAAM,oBAAoB,CAAC;AAgD5E,MAAM,UAAU,oBAAoB,CAIlC,UAA8D;IAE9D,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,GAChC,UAA4C,CAAC;IAE/C,IAAI,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACvD,qBAAqB;QACrB,6EAA6E;QAC7E,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACxD,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,QAAS,CAAC,IAAI,KAAK,UAAU;QAC/B,qBAAqB;QACrB,+DAA+D;QAC/D,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAS,CAAC,OAAO;QACpB,qBAAqB;QACrB,0EAA0E;QAC1E,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAE/C,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,EAAE,QAAS,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;IAC/D,iDAAiD;IACjD,OAAO,KAAK,CAAC,OAA6D,CAAC;IAE3E,EAAE;IACF,mCAAmC;IACnC,+EAA+E;IAC/E,qCAAqC;IACrC,wDAAwD;IACxD,YAAY;IACZ,oBAAoB;IACpB,WAAW;IACX,OAAO;IACP,gFAAgF;AAClF,CAAC"}