actor-ts 0.9.0

package/dist/serialization/CborCodec.js

@@ -0,0 +1,321 @@
+/**
+ * Minimal CBOR codec (RFC 8949 subset) used by `CborSerializer`.
+ *
+ * Supported major types:
+ *   0 (unsigned int),
+ *   1 (negative int),
+ *   2 (byte string),
+ *   3 (text string),
+ *   4 (array),
+ *   5 (map, with string keys),
+ *   7 (simple values: false/true/null + double float).
+ *
+ * Additional-info values 0–27 are handled for every major type.  Indefinite-
+ * length items and tagged items (major type 6) are NOT supported — the
+ * target use case is actor message serialisation, not arbitrary CBOR
+ * interop.  Dates and bigints are supported via semantic tagging (tag 1
+ * and tag 2/3) on the encoder side; the decoder recognises them.
+ */
+export class CborEncodeError extends Error {
+    constructor(m) { super(m); this.name = 'CborEncodeError'; }
+}
+export class CborDecodeError extends Error {
+    constructor(m) { super(m); this.name = 'CborDecodeError'; }
+}
+const TAG_DATETIME = 0; // RFC 8949: standard date/time string
+const TAG_EPOCH_DATETIME = 1; // RFC 8949: epoch-based date/time
+const TAG_UNSIGNED_BIGNUM = 2;
+const TAG_NEGATIVE_BIGNUM = 3;
+/* ================================ Encoder ================================= */
+export class CborEncoder {
+    chunks = [];
+    encode(value) {
+        this.chunks = [];
+        this.writeValue(value);
+        return new Uint8Array(this.chunks);
+    }
+    writeValue(v) {
+        if (v === null || v === undefined)
+            return this.writeSimple(22); // null
+        if (typeof v === 'boolean')
+            return this.writeSimple(v ? 21 : 20);
+        if (typeof v === 'number') {
+            if (Number.isFinite(v) && Number.isInteger(v) && Math.abs(v) <= Number.MAX_SAFE_INTEGER) {
+                return this.writeInt(v);
+            }
+            return this.writeDouble(v);
+        }
+        if (typeof v === 'bigint')
+            return this.writeBigInt(v);
+        if (typeof v === 'string')
+            return this.writeString(v);
+        if (v instanceof Uint8Array)
+            return this.writeBytes(v);
+        if (v instanceof Date) {
+            this.writeTag(TAG_EPOCH_DATETIME);
+            this.writeDouble(v.getTime() / 1000);
+            return;
+        }
+        if (Array.isArray(v)) {
+            this.writeHeader(4, v.length);
+            for (const item of v)
+                this.writeValue(item);
+            return;
+        }
+        if (typeof v === 'object') {
+            const entries = Object.entries(v);
+            this.writeHeader(5, entries.length);
+            for (const [k, val] of entries) {
+                this.writeString(k);
+                this.writeValue(val);
+            }
+            return;
+        }
+        throw new CborEncodeError(`Cannot encode value of type ${typeof v}`);
+    }
+    writeInt(n) {
+        if (n >= 0)
+            this.writeHeader(0, n);
+        else
+            this.writeHeader(1, -n - 1);
+    }
+    writeBigInt(n) {
+        // Use RFC 8949 bignum tags so the decoder can reconstruct a bigint.
+        const positive = n >= 0n;
+        const absVal = positive ? n : -n - 1n;
+        this.writeTag(positive ? TAG_UNSIGNED_BIGNUM : TAG_NEGATIVE_BIGNUM);
+        const bytes = bigIntToBytes(absVal);
+        this.writeHeader(2, bytes.length);
+        for (const b of bytes)
+            this.chunks.push(b);
+    }
+    writeString(s) {
+        const bytes = new TextEncoder().encode(s);
+        this.writeHeader(3, bytes.length);
+        for (const b of bytes)
+            this.chunks.push(b);
+    }
+    writeBytes(b) {
+        this.writeHeader(2, b.length);
+        for (const x of b)
+            this.chunks.push(x);
+    }
+    writeTag(tag) {
+        this.writeHeader(6, tag);
+    }
+    writeSimple(v) {
+        this.chunks.push((7 << 5) | v);
+    }
+    writeDouble(n) {
+        this.chunks.push((7 << 5) | 27);
+        const buf = new ArrayBuffer(8);
+        new DataView(buf).setFloat64(0, n, false);
+        for (const b of new Uint8Array(buf))
+            this.chunks.push(b);
+    }
+    writeHeader(major, value) {
+        const mj = (major & 0x7) << 5;
+        if (value < 24) {
+            this.chunks.push(mj | value);
+        }
+        else if (value < 0x100) {
+            this.chunks.push(mj | 24, value);
+        }
+        else if (value < 0x10000) {
+            this.chunks.push(mj | 25, (value >>> 8) & 0xff, value & 0xff);
+        }
+        else if (value < 0x100000000) {
+            this.chunks.push(mj | 26, (value >>> 24) & 0xff, (value >>> 16) & 0xff, (value >>> 8) & 0xff, value & 0xff);
+        }
+        else {
+            // Fall back to 8-byte form via BigInt math.
+            this.chunks.push(mj | 27);
+            const view = new DataView(new ArrayBuffer(8));
+            view.setBigUint64(0, BigInt(value), false);
+            for (let i = 0; i < 8; i++)
+                this.chunks.push(view.getUint8(i));
+        }
+    }
+}
+/* ================================ Decoder ================================= */
+export class CborDecoder {
+    pos = 0;
+    bytes;
+    view;
+    decode(bytes) {
+        this.bytes = bytes;
+        this.view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+        this.pos = 0;
+        const v = this.readValue();
+        if (this.pos !== bytes.byteLength) {
+            throw new CborDecodeError(`Trailing CBOR bytes at offset ${this.pos}`);
+        }
+        return v;
+    }
+    readValue() {
+        if (this.pos >= this.bytes.byteLength) {
+            throw new CborDecodeError(`Unexpected end of input at offset ${this.pos}`);
+        }
+        const ib = this.bytes[this.pos];
+        const major = (ib >>> 5) & 0x7;
+        const add = ib & 0x1f;
+        this.pos++;
+        // Major type 7 has its own additional-info interpretation (simple values
+        // and floats).  Don't run it through `readLength`, which would consume
+        // the float's own bytes as if they were a length prefix.
+        if (major === 7)
+            return this.readSimple(add);
+        const len = this.readLength(add);
+        switch (major) {
+            case 0: return typeof len === 'bigint' ? len : Number(len);
+            case 1: {
+                const v = typeof len === 'bigint' ? -len - 1n : -Number(len) - 1;
+                return v;
+            }
+            case 2: return this.readBytes(Number(len));
+            case 3: return new TextDecoder().decode(this.readBytes(Number(len)));
+            case 4: {
+                const out = [];
+                const n = Number(len);
+                for (let i = 0; i < n; i++)
+                    out.push(this.readValue());
+                return out;
+            }
+            case 5: {
+                const out = {};
+                const n = Number(len);
+                for (let i = 0; i < n; i++) {
+                    const k = this.readValue();
+                    const v = this.readValue();
+                    if (typeof k !== 'string') {
+                        throw new CborDecodeError('Only string keys are supported in maps');
+                    }
+                    out[k] = v;
+                }
+                return out;
+            }
+            case 6: {
+                const tag = Number(len);
+                const inner = this.readValue();
+                return this.applyTag(tag, inner);
+            }
+            default:
+                throw new CborDecodeError(`Unknown major type ${major}`);
+        }
+    }
+    readLength(add) {
+        if (add < 24)
+            return add;
+        if (add === 24)
+            return this.readUint(1);
+        if (add === 25)
+            return this.readUint(2);
+        if (add === 26)
+            return this.readUint(4);
+        if (add === 27)
+            return this.readUint(8);
+        throw new CborDecodeError(`Unsupported additional info ${add}`);
+    }
+    readUint(byteLen) {
+        if (this.pos + byteLen > this.bytes.byteLength) {
+            throw new CborDecodeError(`Truncated input: need ${byteLen} bytes at offset ${this.pos}`);
+        }
+        let out = 0n;
+        for (let i = 0; i < byteLen; i++) {
+            out = (out << 8n) | BigInt(this.bytes[this.pos + i]);
+        }
+        this.pos += byteLen;
+        return out <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(out) : out;
+    }
+    readBytes(n) {
+        if (this.pos + n > this.bytes.byteLength) {
+            throw new CborDecodeError(`Truncated input: need ${n} bytes at offset ${this.pos}`);
+        }
+        const out = this.bytes.slice(this.pos, this.pos + n);
+        this.pos += n;
+        return out;
+    }
+    readSimple(add) {
+        if (add === 20)
+            return false;
+        if (add === 21)
+            return true;
+        if (add === 22)
+            return null;
+        if (add === 23)
+            return undefined;
+        if (add === 25)
+            return this.readHalfFloat();
+        if (add === 26) {
+            if (this.pos + 4 > this.bytes.byteLength)
+                throw new CborDecodeError('Truncated float32');
+            const v = this.view.getFloat32(this.pos, false);
+            this.pos += 4;
+            return v;
+        }
+        if (add === 27) {
+            if (this.pos + 8 > this.bytes.byteLength)
+                throw new CborDecodeError('Truncated float64');
+            const v = this.view.getFloat64(this.pos, false);
+            this.pos += 8;
+            return v;
+        }
+        throw new CborDecodeError(`Unsupported simple value ${add}`);
+    }
+    readHalfFloat() {
+        if (this.pos + 2 > this.bytes.byteLength)
+            throw new CborDecodeError('Truncated float16');
+        const hi = this.bytes[this.pos], lo = this.bytes[this.pos + 1];
+        this.pos += 2;
+        const sign = (hi & 0x80) ? -1 : 1;
+        const exp = (hi & 0x7c) >>> 2;
+        const mant = ((hi & 0x03) << 8) | lo;
+        if (exp === 0)
+            return sign * Math.pow(2, -14) * (mant / 1024);
+        if (exp === 0x1f)
+            return mant ? NaN : sign * Infinity;
+        return sign * Math.pow(2, exp - 15) * (1 + mant / 1024);
+    }
+    applyTag(tag, inner) {
+        switch (tag) {
+            case TAG_DATETIME:
+                if (typeof inner === 'string')
+                    return new Date(inner);
+                throw new CborDecodeError('Tag 0 expects a string');
+            case TAG_EPOCH_DATETIME:
+                if (typeof inner === 'number')
+                    return new Date(inner * 1000);
+                throw new CborDecodeError('Tag 1 expects a number');
+            case TAG_UNSIGNED_BIGNUM:
+            case TAG_NEGATIVE_BIGNUM: {
+                if (!(inner instanceof Uint8Array)) {
+                    throw new CborDecodeError(`Tag ${tag} expects a byte string`);
+                }
+                const n = bytesToBigInt(inner);
+                return tag === TAG_UNSIGNED_BIGNUM ? n : -1n - n;
+            }
+            default:
+                // Unknown tag — pass the inner value through.
+                return inner;
+        }
+    }
+}
+/* --------------------------- BigInt ↔ bytes utilities ---------------------- */
+function bigIntToBytes(n) {
+    if (n === 0n)
+        return new Uint8Array([0]);
+    const bytes = [];
+    let v = n;
+    while (v > 0n) {
+        bytes.push(Number(v & 0xffn));
+        v >>= 8n;
+    }
+    return new Uint8Array(bytes.reverse());
+}
+function bytesToBigInt(bytes) {
+    let v = 0n;
+    for (const b of bytes)
+        v = (v << 8n) | BigInt(b);
+    return v;
+}
+//# sourceMappingURL=CborCodec.js.map

package/dist/serialization/CborCodec.js.map

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

package/dist/serialization/CborSerializer.d.ts

@@ -0,0 +1,23 @@
+import { type Serializer } from './Serializer.js';
+/**
+ * CBOR serializer — compact binary format, used by default for system
+ * messages (heartbeats, gossip, handoff) and available for any user type
+ * that benefits from smaller payloads than JSON.  Handles the same JS
+ * primitives as JsonSerializer plus:
+ *   - `Uint8Array` round-trips as a byte string (no base64 overhead).
+ *   - `Date` uses CBOR tag 1.
+ *   - `bigint` uses CBOR tag 2 / 3.
+ *
+ * Manifests are not used by the CBOR serializer itself — the caller is
+ * expected to round-trip compatible shapes.  For class-preserving
+ * round-trips register a dedicated serializer via SerializationExtension.
+ */
+export declare class CborSerializer implements Serializer<unknown> {
+    readonly id = 2;
+    readonly name = "cbor";
+    readonly includesManifest = false;
+    manifest(_obj: unknown): string;
+    toBinary(obj: unknown): Uint8Array;
+    fromBinary(bytes: Uint8Array, _manifest: string): unknown;
+}
+//# sourceMappingURL=CborSerializer.d.ts.map

package/dist/serialization/CborSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CborSerializer.d.ts","sourceRoot":"","sources":["../../src/serialization/CborSerializer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,YAAW,UAAU,CAAC,OAAO,CAAC;IACxD,QAAQ,CAAC,EAAE,KAAK;IAChB,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,gBAAgB,SAAS;IAElC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAE/B,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU;IAIlC,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;CAG1D"}

package/dist/serialization/CborSerializer.js

@@ -0,0 +1,27 @@
+import { CborDecoder, CborEncoder } from './CborCodec.js';
+/**
+ * CBOR serializer — compact binary format, used by default for system
+ * messages (heartbeats, gossip, handoff) and available for any user type
+ * that benefits from smaller payloads than JSON.  Handles the same JS
+ * primitives as JsonSerializer plus:
+ *   - `Uint8Array` round-trips as a byte string (no base64 overhead).
+ *   - `Date` uses CBOR tag 1.
+ *   - `bigint` uses CBOR tag 2 / 3.
+ *
+ * Manifests are not used by the CBOR serializer itself — the caller is
+ * expected to round-trip compatible shapes.  For class-preserving
+ * round-trips register a dedicated serializer via SerializationExtension.
+ */
+export class CborSerializer {
+    id = 2;
+    name = 'cbor';
+    includesManifest = false;
+    manifest(_obj) { return ''; }
+    toBinary(obj) {
+        return new CborEncoder().encode(obj);
+    }
+    fromBinary(bytes, _manifest) {
+        return new CborDecoder().decode(bytes);
+    }
+}
+//# sourceMappingURL=CborSerializer.js.map

package/dist/serialization/CborSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CborSerializer.js","sourceRoot":"","sources":["../../src/serialization/CborSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG1D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,cAAc;IAChB,EAAE,GAAG,CAAC,CAAC;IACP,IAAI,GAAG,MAAM,CAAC;IACd,gBAAgB,GAAG,KAAK,CAAC;IAElC,QAAQ,CAAC,IAAa,IAAY,OAAO,EAAE,CAAC,CAAC,CAAC;IAE9C,QAAQ,CAAC,GAAY;QACnB,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,UAAU,CAAC,KAAiB,EAAE,SAAiB;QAC7C,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/serialization/JsonSerializer.d.ts

@@ -0,0 +1,18 @@
+import { type Serializer } from './Serializer.js';
+/**
+ * JSON serializer — the default fallback.  Handles plain objects, arrays,
+ * strings, numbers, booleans, `null`, and — via pre/post-walking the tree
+ * before `JSON.stringify` — `Date`, `Uint8Array`, `Map`, `Set`, and
+ * `bigint`.  Class identity for custom user types is NOT preserved; the
+ * decoded value is a plain object.  Callers that need stronger typing
+ * should register a custom serializer via `SerializationExtension`.
+ */
+export declare class JsonSerializer implements Serializer<unknown> {
+    readonly id = 1;
+    readonly name = "json";
+    readonly includesManifest = false;
+    manifest(_obj: unknown): string;
+    toBinary(obj: unknown): Uint8Array;
+    fromBinary(bytes: Uint8Array, _manifest: string): unknown;
+}
+//# sourceMappingURL=JsonSerializer.d.ts.map

package/dist/serialization/JsonSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSerializer.d.ts","sourceRoot":"","sources":["../../src/serialization/JsonSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;;;;;;GAOG;AACH,qBAAa,cAAe,YAAW,UAAU,CAAC,OAAO,CAAC;IACxD,QAAQ,CAAC,EAAE,KAAK;IAChB,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,gBAAgB,SAAS;IAElC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAE/B,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU;IAYlC,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;CAI1D"}

package/dist/serialization/JsonSerializer.js

@@ -0,0 +1,114 @@
+import { SerializationError } from './Serializer.js';
+/**
+ * JSON serializer — the default fallback.  Handles plain objects, arrays,
+ * strings, numbers, booleans, `null`, and — via pre/post-walking the tree
+ * before `JSON.stringify` — `Date`, `Uint8Array`, `Map`, `Set`, and
+ * `bigint`.  Class identity for custom user types is NOT preserved; the
+ * decoded value is a plain object.  Callers that need stronger typing
+ * should register a custom serializer via `SerializationExtension`.
+ */
+export class JsonSerializer {
+    id = 1;
+    name = 'json';
+    includesManifest = false;
+    manifest(_obj) { return ''; }
+    toBinary(obj) {
+        let encoded;
+        try {
+            encoded = encodeTree(obj);
+        }
+        catch (e) {
+            throw new SerializationError(`JsonSerializer encode failed: ${e.message}`);
+        }
+        const json = JSON.stringify(encoded);
+        if (json === undefined) {
+            throw new SerializationError('JsonSerializer: value is not JSON-serializable');
+        }
+        return new TextEncoder().encode(json);
+    }
+    fromBinary(bytes, _manifest) {
+        const text = new TextDecoder().decode(bytes);
+        return decodeTree(JSON.parse(text));
+    }
+}
+/* ------------------------- Tagged representations ------------------------- */
+const DATE_TAG = '__date__';
+const BYTES_TAG = '__bytes__';
+const MAP_TAG = '__map__';
+const SET_TAG = '__set__';
+const BIGINT_TAG = '__bigint__';
+function encodeTree(value) {
+    if (value === undefined)
+        throw new Error('undefined is not JSON-serialisable');
+    if (value === null)
+        return null;
+    if (typeof value === 'bigint')
+        return { [BIGINT_TAG]: value.toString() };
+    if (value instanceof Date)
+        return { [DATE_TAG]: value.toISOString() };
+    if (value instanceof Uint8Array)
+        return { [BYTES_TAG]: toBase64(value) };
+    if (value instanceof Map) {
+        return {
+            [MAP_TAG]: Array.from(value.entries()).map(([k, v]) => [encodeTree(k), encodeTree(v)]),
+        };
+    }
+    if (value instanceof Set) {
+        return { [SET_TAG]: Array.from(value.values()).map(encodeTree) };
+    }
+    if (Array.isArray(value))
+        return value.map(encodeTree);
+    if (typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = encodeTree(v);
+        }
+        return out;
+    }
+    if (typeof value === 'function' || typeof value === 'symbol') {
+        throw new Error(`Unsupported value of type ${typeof value}`);
+    }
+    return value;
+}
+function decodeTree(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value))
+        return value.map(decodeTree);
+    const obj = value;
+    if (DATE_TAG in obj)
+        return new Date(obj[DATE_TAG]);
+    if (BYTES_TAG in obj)
+        return fromBase64(obj[BYTES_TAG]);
+    if (MAP_TAG in obj) {
+        return new Map(obj[MAP_TAG].map(([k, v]) => [decodeTree(k), decodeTree(v)]));
+    }
+    if (SET_TAG in obj)
+        return new Set(obj[SET_TAG].map(decodeTree));
+    if (BIGINT_TAG in obj)
+        return BigInt(obj[BIGINT_TAG]);
+    const out = {};
+    for (const [k, v] of Object.entries(obj))
+        out[k] = decodeTree(v);
+    return out;
+}
+function toBase64(bytes) {
+    if (typeof Buffer !== 'undefined')
+        return Buffer.from(bytes).toString('base64');
+    let s = '';
+    for (let i = 0; i < bytes.byteLength; i++)
+        s += String.fromCharCode(bytes[i]);
+    return btoa(s);
+}
+function fromBase64(s) {
+    if (typeof Buffer !== 'undefined') {
+        const buf = Buffer.from(s, 'base64');
+        return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+    }
+    const bin = atob(s);
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++)
+        out[i] = bin.charCodeAt(i);
+    return out;
+}
+//# sourceMappingURL=JsonSerializer.js.map

package/dist/serialization/JsonSerializer.js.map

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

package/dist/serialization/SerializationExtension.d.ts

@@ -0,0 +1,46 @@
+import { type Extension, type ExtensionId } from '../Extension.js';
+import { type SerializedValue, type Serializer } from './Serializer.js';
+type ClassCtor = abstract new (...args: any[]) => unknown;
+/**
+ * Registry that resolves serializers by ID (at decode time) and by message
+ * class (at encode time).  JSON (id=1) is the built-in fallback; CBOR
+ * (id=2) is registered and available but used only when explicitly bound
+ * to a class or asked for by ID.
+ *
+ * Will graduate to an `ExtensionId<SerializationExtension>` once the
+ * Extensions mechanism (P1.2) lands — until then it is constructed
+ * directly inside `ActorSystem`.
+ */
+export declare class SerializationExtension implements Extension {
+    private readonly byId;
+    private readonly byClass;
+    private _default;
+    constructor();
+    /** The serializer used for values with no explicit class binding.  Defaults to JSON. */
+    get defaultSerializer(): Serializer;
+    setDefault(serializer: Serializer): void;
+    register(serializer: Serializer): void;
+    /** Bind a message class to a specific serializer (by ID). */
+    bind(cls: ClassCtor, serializerId: number): void;
+    /** Find a serializer by ID (used by decoders). */
+    findById(id: number): Serializer | undefined;
+    /** Look up by ID or throw. */
+    requireById(id: number): Serializer;
+    /**
+     * Find the appropriate serializer for a value.  Lookup order:
+     *   1. Exact constructor binding (`bind(Foo, 2)`).
+     *   2. Walk the prototype chain for a bound ancestor.
+     *   3. Default (JSON).
+     */
+    findFor(value: unknown): Serializer;
+    /** Encode a value using the resolved serializer; returns a tagged SerializedValue. */
+    encode(value: unknown): SerializedValue;
+    /** Decode a SerializedValue using the serializer it names. */
+    decode(sv: SerializedValue): unknown;
+    /** Snapshot registered serializer IDs — useful for diagnostics. */
+    registeredIds(): number[];
+}
+/** ExtensionId for the stock serialisation registry — install via `system.extension(...)`. */
+export declare const SerializationExtensionId: ExtensionId<SerializationExtension>;
+export {};
+//# sourceMappingURL=SerializationExtension.d.ts.map

package/dist/serialization/SerializationExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializationExtension.d.ts","sourceRoot":"","sources":["../../src/serialization/SerializationExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAe,MAAM,iBAAiB,CAAC;AAGhF,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE5F,KAAK,SAAS,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;AAE1D;;;;;;;;;GASG;AACH,qBAAa,sBAAuB,YAAW,SAAS;IACtD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAa;;IAQ7B,wFAAwF;IACxF,IAAI,iBAAiB,IAAI,UAAU,CAA0B;IAE7D,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKxC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAUtC,6DAA6D;IAC7D,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAMhD,kDAAkD;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI5C,8BAA8B;IAC9B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU;IAMnC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU;IAqBnC,sFAAsF;IACtF,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe;IASvC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO;IAKpC,mEAAmE;IACnE,aAAa,IAAI,MAAM,EAAE;CAG1B;AAED,8FAA8F;AAC9F,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,sBAAsB,CAGxE,CAAC"}