@emagjby/strata-js 0.3.0

package/dist/__tests__/decode.test.js

@@ -0,0 +1,28 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { decodeValue } from "../decode.js";
+import { encodeValue } from "../encode.js";
+import { V } from "../value_factory.js";
+import { DecodeError } from "../decode_error.js";
+test("decode simple int", () => {
+    const bytes = new Uint8Array([0x10, 0x01]);
+    const v = decodeValue(bytes);
+    assert.equal(v.kind, "int");
+    assert.equal(v.value, 1n);
+});
+test("encode -> decode roundtrip", () => {
+    const value = V.map([
+        ["a", V.int(1n)],
+        ["b", V.bool(true)],
+        ["c", V.list([V.null(), V.string("hi")])],
+    ]);
+    const encoded = encodeValue(value);
+    const decoded = decodeValue(encoded);
+    assert.deepEqual(decoded, value);
+});
+test("invalid tag throws DecodeError", () => {
+    const bytes = new Uint8Array([0xff]);
+    assert.throws(() => decodeValue(bytes), (err) => err instanceof DecodeError &&
+        err.kind.type === "InvalidTag" &&
+        err.offset === 0);
+});

package/dist/__tests__/encode.vectors.test.js

@@ -0,0 +1,46 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { encodeValue } from "../encode.js";
+import { V } from "../value_factory.js";
+const VECTORS_DIR = join(process.cwd(), "..", "vectors");
+function readHex(path) {
+    const text = readFileSync(path, "utf-8").trim();
+    assert.equal(text.length % 2, 0, "Hex string must have even length");
+    const out = new Uint8Array(text.length / 2);
+    for (let i = 0; i < text.length; i += 2) {
+        out[i / 2] = Number.parseInt(text.slice(i, i + 2), 16);
+    }
+    return out;
+}
+test("encode matches v1/01-basic.scb.hex", () => {
+    const config = V.map([
+        ["enabled", V.bool(true)],
+        ["retries", V.int(3n)],
+        ["name", V.string("strata")],
+        ["empty", V.null()],
+    ]);
+    const root = V.map([["config", config]]);
+    const expected = readHex(join(VECTORS_DIR, "v1", "01-basic.scb.hex"));
+    const actual = encodeValue(root);
+    assert.deepEqual([...actual], [...expected]);
+});
+test("encode matches v1/03-bigint-bytes.scb.hex", () => {
+    const avatar = new Uint8Array([
+        0x9f, 0x86, 0xd0, 0x81, 0x88, 0x4c, 0x7d, 0x65, 0x9a, 0x2f, 0xea, 0xa0,
+        0xc5, 0x5a, 0xd0, 0x15,
+    ]);
+    const profile = V.map([
+        ["id", V.int(9007199254740993n)],
+        ["avatar_hash", V.bytes(avatar)],
+        [
+            "tags",
+            V.list([V.string("logistics"), V.string("state"), V.string("integrity")]),
+        ],
+    ]);
+    const root = V.map([["profile", profile]]);
+    const expected = readHex(join(VECTORS_DIR, "v1", "03-bigint-bytes.scb.hex"));
+    const actual = encodeValue(root);
+    assert.deepEqual([...actual], [...expected]);
+});

package/dist/__tests__/hash.vectors.test.js

@@ -0,0 +1,51 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { V } from "../value_factory.js";
+import { hashValueHex } from "../hash.js";
+const VECTORS_DIR = join(process.cwd(), "..", "vectors");
+function readText(path) {
+    return readFileSync(path, "utf8").trim();
+}
+test("hash matches v1/01-basic.hash.hex", () => {
+    const config = V.map([
+        ["enabled", V.bool(true)],
+        ["retries", V.int(3n)],
+        ["name", V.string("strata")],
+        ["empty", V.null()],
+    ]);
+    const root = V.map([["config", config]]);
+    const expected = readText(join(VECTORS_DIR, "v1", "01-basic.hash.hex"));
+    const actual = hashValueHex(root);
+    assert.equal(actual, expected);
+});
+test("hash matches v1/02-map-order.hash.hex", () => {
+    const data = V.map([
+        ["z", V.int(1n)],
+        ["a", V.int(2n)],
+        ["m", V.int(3n)],
+    ]);
+    const root = V.map([["data", data]]);
+    const expected = readText(join(VECTORS_DIR, "v1", "02-map-order.hash.hex"));
+    const actual = hashValueHex(root);
+    assert.equal(actual, expected);
+});
+test("hash matches v1/03-bigint-bytes.hash.hex", () => {
+    const avatar = new Uint8Array([
+        0x9f, 0x86, 0xd0, 0x81, 0x88, 0x4c, 0x7d, 0x65, 0x9a, 0x2f, 0xea, 0xa0,
+        0xc5, 0x5a, 0xd0, 0x15,
+    ]);
+    const profile = V.map([
+        ["id", V.int(9007199254740993n)],
+        ["avatar_hash", V.bytes(avatar)],
+        [
+            "tags",
+            V.list([V.string("logistics"), V.string("state"), V.string("integrity")]),
+        ],
+    ]);
+    const root = V.map([["profile", profile]]);
+    const expected = readText(join(VECTORS_DIR, "v1", "03-bigint-bytes.hash.hex"));
+    const actual = hashValueHex(root);
+    assert.equal(actual, expected);
+});

package/dist/__tests__/value.test.js

@@ -0,0 +1,23 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { V } from "../value_factory.js";
+test("can represent all core value types", () => {
+    const v = V.map([
+        ["null", V.null()],
+        ["bool", V.bool(true)],
+        ["int", V.int(42n)],
+        ["string", V.string("strata")],
+        ["bytes", V.bytes(new Uint8Array([0xde, 0xad]))],
+        ["list", V.list([V.int(1n), V.int(2n), V.int(3n)])],
+    ]);
+    assert.equal(v.kind, "map");
+});
+test("rejects number for int", () => {
+    // @ts-expect-error
+    assert.throws(() => V.int(42));
+});
+test("supports BigInt beyond JS safe integer range", () => {
+    const big = 9007199254740993n;
+    const v = V.int(big);
+    assert.equal(v.value, big);
+});

package/dist/__tests__/varint.test.js

@@ -0,0 +1,37 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { encodeULEB128, decodeULEB128, encodeSLEB128, decodeSLEB128, } from "../varint.js";
+test("ULEB128 basic values", () => {
+    assert.deepEqual(encodeULEB128(0n), Uint8Array.from([0x00]));
+    assert.deepEqual(encodeULEB128(1n), Uint8Array.from([0x01]));
+    assert.deepEqual(encodeULEB128(127n), Uint8Array.from([0x7f]));
+    assert.deepEqual(encodeULEB128(128n), Uint8Array.from([0x80, 0x01]));
+});
+test("ULEB128 round trip", () => {
+    const values = [0n, 1n, 127n, 128n, 1024n, 9007199254740993n];
+    for (const value of values) {
+        const encoded = encodeULEB128(value);
+        const decoded = decodeULEB128(encoded);
+        assert.equal(decoded.value, value);
+        assert.equal(decoded.nextOffset, encoded.length);
+    }
+});
+test("SLEB128 basic values", () => {
+    const values = [
+        0n,
+        1n,
+        -1n,
+        63n,
+        -64n,
+        127n,
+        -128n,
+        9007199254740993n,
+        -9007199254740993n,
+    ];
+    for (const value of values) {
+        const encoded = encodeSLEB128(value);
+        const decoded = decodeSLEB128(encoded);
+        assert.equal(decoded.value, value);
+        assert.equal(decoded.nextOffset, encoded.length);
+    }
+});

package/dist/__tests__/vectors.enforcement.test.js

@@ -0,0 +1,75 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { encodeValue } from "../encode.js";
+import { decodeValue } from "../decode.js";
+import { hashValueHex } from "../hash.js";
+import { parse } from "../parser.js";
+import { DecodeError } from "../decode_error.js";
+const VECTORS_DIR = join(process.cwd(), "..", "vectors");
+function readHex(path) {
+    const text = readFileSync(path, "utf8").trim();
+    assert.ok(text.length % 2 === 0, "Hex string must have even length");
+    const out = new Uint8Array(text.length / 2);
+    for (let i = 0; i < text.length; i += 2) {
+        out[i / 2] = Number.parseInt(text.slice(i, i + 2), 16);
+    }
+    return out;
+}
+function readText(path) {
+    return readFileSync(path, "utf8");
+}
+function readJson(path) {
+    return JSON.parse(readFileSync(path, "utf8"));
+}
+function runPositiveVector(relPath) {
+    const base = join(VECTORS_DIR, relPath);
+    const stPath = base + ".st";
+    const scbHexPath = base + ".scb.hex";
+    const hashHexPath = base + ".hash.hex";
+    const source = readText(stPath);
+    const parsedValue = parse(source);
+    const encoded = encodeValue(parsedValue);
+    const expectedScb = readHex(scbHexPath);
+    assert.deepEqual([...encoded], [...expectedScb], `SCB mismatch for vector ${relPath}`);
+    //hash
+    const actualHash = hashValueHex(parsedValue);
+    const expectedHash = readText(hashHexPath).trim();
+    assert.equal(actualHash, expectedHash, `Hash mismatch for vector ${relPath}`);
+}
+function runNegativeDecodeVector(relPath) {
+    const base = join(VECTORS_DIR, relPath);
+    const hexPath = base + ".hex";
+    const errorPath = base + ".error.json";
+    const bytes = readHex(hexPath);
+    const expectedError = readJson(errorPath);
+    let thrown;
+    try {
+        decodeValue(bytes);
+    }
+    catch (err) {
+        thrown = err;
+    }
+    assert.ok(thrown instanceof DecodeError, `Expected DecodeError for ${relPath}`);
+    const err = thrown;
+    if (expectedError.kind === "InvalidTag") {
+        assert.equal(err.kind.type, "InvalidTag");
+    }
+    else {
+        assert.equal(err.kind.type, expectedError.kind);
+    }
+    assert.equal(err.offset, expectedError.offset, `offset mismatch for ${relPath}`);
+}
+// v1
+test("vector v1/01-basic", () => runPositiveVector("v1/01-basic"));
+test("vector v1/02-map-order", () => runPositiveVector("v1/02-map-order"));
+test("vector v1/03-bigint-bytes", () => runPositiveVector("v1/03-bigint-bytes"));
+// v2
+test("vector v2/01-decode-roundtrip", () => runPositiveVector("v2/01-decode-roundtrip"));
+test("vector v2/02-noncanonical-map-order", () => runPositiveVector("v2/02-noncanonical-map-order"));
+test("vector v2/03-nested-structure", () => runPositiveVector("v2/03-nested-structure"));
+test("neg v2.1/01-invalid-tag", () => runNegativeDecodeVector("v2.1/neg-01-invalid-tag"));
+test("neg v2.1/02-truncated-string", () => runNegativeDecodeVector("v2.1/neg-02-truncated-string"));
+test("neg v2.1/03-varint-overflow", () => runNegativeDecodeVector("v2.1/neg-03-varint-overflow"));
+test("neg v2.1/04-invalid-utf8", () => runNegativeDecodeVector("v2.1/neg-04-invalid-utf8"));

package/dist/__tests__/vectors.smoke.test.js

@@ -0,0 +1,17 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+const VECTORS_DIR = join(process.cwd(), "..", "vectors");
+test("JS can see vectors directory", () => {
+    const entries = readdirSync(VECTORS_DIR);
+    assert.ok(entries.includes("v1"));
+    assert.ok(entries.includes("v2"));
+    assert.ok(entries.includes("v2.1"));
+});
+test("JS can read a known vector file", () => {
+    const path = join(VECTORS_DIR, "v1", "01-basic.st");
+    const content = readFileSync(path, "utf-8");
+    assert.ok(content.includes("config"));
+    assert.ok(content.includes("enabled"));
+});

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import process from "node:process";
+import { parse } from "./parser.js";
+import { encodeValue } from "./encode.js";
+import { decodeValue } from "./decode.js";
+import { hashBytes } from "./hash.js";
+import { DecodeError } from "./decode_error.js";
+import { ParseError } from "./parse_error.js";
+function exitOk() {
+    process.exit(0);
+}
+function exitInvalid(msg) {
+    if (msg) {
+        console.error(msg);
+    }
+    process.exit(1);
+}
+function exitIo(err) {
+    if (err instanceof Error) {
+        console.error(err.message);
+    }
+    process.exit(2);
+}
+function exitInternal(err) {
+    console.error("internal error");
+    if (err instanceof Error) {
+        console.error(err.stack);
+    }
+    process.exit(100);
+}
+function hex(bytes) {
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+function cmdCompile(input, output) {
+    const source = fs.readFileSync(input, "utf8");
+    const value = parse(source);
+    const encoded = encodeValue(value);
+    fs.writeFileSync(output, encoded);
+}
+function cmdDecode(input) {
+    const encoded = fs.readFileSync(input);
+    const value = decodeValue(encoded);
+    console.log(JSON.stringify(value, null, 2));
+}
+function cmdHash(input) {
+    let encoded;
+    if (input.endsWith(".st")) {
+        const source = fs.readFileSync(input, "utf8");
+        const value = parse(source);
+        encoded = encodeValue(value);
+    }
+    else {
+        encoded = fs.readFileSync(input);
+    }
+    const hashed = hashBytes(encoded);
+    console.log(hex(hashed));
+}
+function cmdFmt(input) {
+    const source = fs.readFileSync(input, "utf8");
+    const parsedValue = parse(source);
+    console.log(JSON.stringify(parsedValue, null, 2));
+}
+function main() {
+    const [, , cmd, ...args] = process.argv;
+    if (!cmd) {
+        exitInvalid("no command provided");
+    }
+    switch (cmd) {
+        case "compile": {
+            if (args.length !== 2) {
+                exitInvalid("usage: strata-js compile <input.st> <output.scb>");
+            }
+            cmdCompile(args[0], args[1]);
+            return exitOk();
+        }
+        case "decode": {
+            if (args.length !== 1) {
+                exitInvalid("usage: strata-js decode <input.scb>");
+            }
+            cmdDecode(args[0]);
+            return exitOk();
+        }
+        case "hash": {
+            if (args.length !== 1) {
+                exitInvalid("usage: strata-js hash <input.st|input.scb>");
+            }
+            cmdHash(args[0]);
+            return exitOk();
+        }
+        case "fmt": {
+            if (args.length !== 1) {
+                exitInvalid("usage: strata-js fmt <input.st>");
+            }
+            cmdFmt(args[0]);
+            return exitOk();
+        }
+        case "--help": {
+            console.log(`
+                Strata CLI (JavaScript)
+
+                Commands:
+                  compile <input.st> <output.scb>
+                  decode <input.scb>
+                  hash <input.st|input.scb>
+                  fmt <input.st>
+            `);
+            process.exit(0);
+        }
+        default:
+            exitInvalid(`unknown command: ${cmd}`);
+    }
+}
+try {
+    main();
+}
+catch (err) {
+    if (err instanceof DecodeError || err instanceof ParseError) {
+        console.error("error: ", err.message);
+        process.exit(1);
+    }
+    if (err instanceof Error && "code" in err && err.code === "ENOENT") {
+        exitIo(err);
+    }
+    exitInternal(err);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/decode.d.ts

@@ -0,0 +1,3 @@
+import { Value } from "./value.js";
+export declare function decodeValue(input: Uint8Array): Value;
+//# sourceMappingURL=decode.d.ts.map

package/dist/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../src/decode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AA2JnC,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAYpD"}

package/dist/decode.js

@@ -0,0 +1,140 @@
+import { V } from "./value_factory.js";
+import { decodeULEB128, decodeSLEB128 } from "./varint.js";
+import { DecodeError } from "./decode_error.js";
+const td = new TextDecoder("utf-8", { fatal: true });
+const TAG_NULL = 0x00;
+const TAG_FALSE = 0x01;
+const TAG_TRUE = 0x02;
+const TAG_INT = 0x10;
+const TAG_STRING = 0x20;
+const TAG_BYTES = 0x21;
+const TAG_LIST = 0x30;
+const TAG_MAP = 0x40;
+class Decoder {
+    input;
+    offset = 0;
+    constructor(input) {
+        this.input = input;
+    }
+    remaining() {
+        return this.input.length - this.offset;
+    }
+    readByte() {
+        if (this.offset >= this.input.length) {
+            throw new DecodeError({ type: "UnexpectedEOF" }, this.offset);
+        }
+        return this.input[this.offset++];
+    }
+    readSlice(len) {
+        if (this.remaining() < len) {
+            throw new DecodeError({ type: "UnexpectedEOF" }, this.offset);
+        }
+        const slice = this.input.subarray(this.offset, this.offset + len);
+        this.offset += len;
+        return slice;
+    }
+    decodeValue() {
+        const tagOffset = this.offset;
+        const tag = this.readByte();
+        const payloadOffset = this.offset;
+        switch (tag) {
+            case TAG_NULL:
+                return V.null();
+            case TAG_FALSE:
+                return V.bool(false);
+            case TAG_TRUE:
+                return V.bool(true);
+            case TAG_INT: {
+                try {
+                    const { value, nextOffset } = decodeSLEB128(this.input, this.offset);
+                    this.offset = nextOffset;
+                    return V.int(value);
+                }
+                catch {
+                    throw new DecodeError({ type: "InvalidVarint" }, payloadOffset);
+                }
+            }
+            case TAG_STRING: {
+                let len;
+                try {
+                    const result = decodeULEB128(this.input, this.offset);
+                    len = result.value;
+                    this.offset = result.nextOffset;
+                }
+                catch {
+                    throw new DecodeError({ type: "InvalidVarint" }, payloadOffset);
+                }
+                const start = this.offset;
+                const bytes = this.readSlice(Number(len));
+                try {
+                    const str = td.decode(bytes);
+                    return V.string(str);
+                }
+                catch {
+                    throw new DecodeError({ type: "InvalidUtf8" }, start);
+                }
+            }
+            case TAG_BYTES: {
+                let len;
+                try {
+                    const result = decodeULEB128(this.input, this.offset);
+                    len = result.value;
+                    this.offset = result.nextOffset;
+                }
+                catch {
+                    throw new DecodeError({ type: "InvalidVarint" }, payloadOffset);
+                }
+                const bytes = this.readSlice(Number(len));
+                return V.bytes(bytes);
+            }
+            case TAG_LIST: {
+                let count;
+                try {
+                    const result = decodeULEB128(this.input, this.offset);
+                    count = result.value;
+                    this.offset = result.nextOffset;
+                }
+                catch {
+                    throw new DecodeError({ type: "InvalidVarint" }, payloadOffset);
+                }
+                const items = [];
+                for (let i = 0n; i < count; i++) {
+                    items.push(this.decodeValue());
+                }
+                return V.list(items);
+            }
+            case TAG_MAP: {
+                let count;
+                try {
+                    const result = decodeULEB128(this.input, this.offset);
+                    count = result.value;
+                    this.offset = result.nextOffset;
+                }
+                catch {
+                    throw new DecodeError({ type: "InvalidVarint" }, payloadOffset);
+                }
+                const map = new Map();
+                for (let i = 0n; i < count; i++) {
+                    const keyValue = this.decodeValue();
+                    if (keyValue.kind !== "string") {
+                        throw new DecodeError({ type: "InvalidTag", tag }, this.offset);
+                    }
+                    const value = this.decodeValue();
+                    map.set(keyValue.value, value);
+                }
+                return V.map(map);
+            }
+            default:
+                throw new DecodeError({ type: "InvalidTag", tag }, tagOffset);
+        }
+    }
+}
+export function decodeValue(input) {
+    const decoder = new Decoder(input);
+    const value = decoder.decodeValue();
+    if (decoder["remaining"]() !== 0) {
+        throw new DecodeError({ type: "TrailingBytes" }, input.length - decoder["remaining"]());
+    }
+    return value;
+}
+//# sourceMappingURL=decode.js.map

package/dist/decode.js.map

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

package/dist/decode_error.d.ts

@@ -0,0 +1,18 @@
+export type DecodeErrorKind = {
+    type: "InvalidTag";
+    tag: number;
+} | {
+    type: "UnexpectedEOF";
+} | {
+    type: "InvalidVarint";
+} | {
+    type: "InvalidUtf8";
+} | {
+    type: "TrailingBytes";
+};
+export declare class DecodeError extends Error {
+    readonly kind: DecodeErrorKind;
+    readonly offset: number;
+    constructor(kind: DecodeErrorKind, offset: number);
+}
+//# sourceMappingURL=decode_error.d.ts.map

package/dist/decode_error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode_error.d.ts","sourceRoot":"","sources":["../src/decode_error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACrB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAEhC,qBAAa,WAAY,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM;CAKpD"}

package/dist/decode_error.js

@@ -0,0 +1,10 @@
+export class DecodeError extends Error {
+    kind;
+    offset;
+    constructor(kind, offset) {
+        super(`DecodeError at ${offset}`);
+        this.kind = kind;
+        this.offset = offset;
+    }
+}
+//# sourceMappingURL=decode_error.js.map

package/dist/decode_error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode_error.js","sourceRoot":"","sources":["../src/decode_error.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,WAAY,SAAQ,KAAK;IACzB,IAAI,CAAkB;IACtB,MAAM,CAAS;IAExB,YAAY,IAAqB,EAAE,MAAc;QAC7C,KAAK,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;CACJ"}

package/dist/encode.d.ts

@@ -0,0 +1,3 @@
+import { Value } from "./value.js";
+export declare function encodeValue(value: Value): Uint8Array;
+//# sourceMappingURL=encode.d.ts.map

package/dist/encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../src/encode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAgBnC,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAIpD"}