@aster-rpc/aster 0.1.2

package/dist/decorators.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Service and method decorators for defining Aster RPC services.
+ *
+ * Spec reference: S7.1-7.4 (decorators), S7.6 (language ownership)
+ *
+ * Uses TC39 Stage 3 decorators (TS 5.0+). These compile away during
+ * TypeScript compilation -- no runtime decorator support needed.
+ *
+ * @example
+ * ```ts
+ * @Service({ name: "Echo", version: 1 })
+ * class EchoService {
+ *   @Rpc({ timeout: 30 })
+ *   async echo(req: EchoRequest): Promise<EchoResponse> {
+ *     return new EchoResponse({ reply: req.message });
+ *   }
+ *
+ *   @ServerStream()
+ *   async *watchItems(req: WatchRequest): AsyncGenerator<ItemUpdate> {
+ *     yield new ItemUpdate({ item: "one" });
+ *   }
+ * }
+ * ```
+ */
+import type { SerializationMode } from './types.js';
+import type { Metadata } from './metadata.js';
+import { type CapabilityRequirement } from './service.js';
+export interface ServiceOptions {
+    name: string;
+    version?: number;
+    /** Dispatch scope. Canonical values are 'shared' and 'session'.
+     *  The legacy alias 'stream' is still accepted on input. */
+    scoped?: 'shared' | 'session' | 'stream';
+    serialization?: SerializationMode[];
+    requires?: CapabilityRequirement;
+    metadata?: Metadata;
+}
+/**
+ * Decorate a class as an Aster RPC service.
+ *
+ * @example
+ * ```ts
+ * @Service({ name: "Echo", version: 1 })
+ * class EchoService { ... }
+ * ```
+ */
+export declare function Service(options: ServiceOptions): <T extends new (...args: any[]) => any>(target: T, _context: ClassDecoratorContext) => T;
+interface RpcOptions {
+    /** Override wire name (defaults to the method name). */
+    name?: string;
+    timeout?: number;
+    idempotent?: boolean;
+    serialization?: SerializationMode;
+    requires?: CapabilityRequirement | string;
+    metadata?: Metadata;
+    /**
+     * Request message constructor. TypeScript erases type parameters at runtime,
+     * so the contract publisher and codegen pipeline cannot discover the request
+     * shape unless it is passed explicitly here. Without it the published manifest
+     * will lack the wire tag and field list, which breaks `aster gen-client`
+     * for cross-language consumers.
+     */
+    request?: new (...args: any[]) => any;
+    /** Response message constructor. See `request` for why this is needed. */
+    response?: new (...args: any[]) => any;
+}
+/**
+ * Mark a method as a unary RPC (single request, single response).
+ *
+ * @example
+ * ```ts
+ * @Rpc({ timeout: 30, idempotent: true })
+ * async getUser(req: GetUserRequest): Promise<User> { ... }
+ * ```
+ */
+export declare function Rpc(options?: RpcOptions): <T extends (...args: any[]) => any>(target: T, _context: ClassMethodDecoratorContext) => T;
+/**
+ * Mark a method as a server-streaming RPC (single request, multiple responses).
+ * Method must be an async generator.
+ *
+ * @example
+ * ```ts
+ * @ServerStream()
+ * async *watchUpdates(req: WatchRequest): AsyncGenerator<Update> { ... }
+ * ```
+ */
+export declare function ServerStream(options?: RpcOptions): <T extends (...args: any[]) => any>(target: T, _context: ClassMethodDecoratorContext) => T;
+/**
+ * Mark a method as a client-streaming RPC (multiple requests, single response).
+ *
+ * @example
+ * ```ts
+ * @ClientStream()
+ * async uploadBatch(requests: AsyncIterable<Item>): Promise<BatchResult> { ... }
+ * ```
+ */
+export declare function ClientStream(options?: RpcOptions): <T extends (...args: any[]) => any>(target: T, _context: ClassMethodDecoratorContext) => T;
+/**
+ * Mark a method as a bidirectional-streaming RPC.
+ *
+ * @example
+ * ```ts
+ * @BidiStream()
+ * async *chat(requests: AsyncIterable<Message>): AsyncGenerator<Message> { ... }
+ * ```
+ */
+export declare function BidiStream(options?: RpcOptions): <T extends (...args: any[]) => any>(target: T, _context: ClassMethodDecoratorContext) => T;
+/** Metadata key for wire type tag. */
+export declare const WIRE_TYPE_KEY: unique symbol;
+/** Metadata key for wire type field metadata. */
+export declare const WIRE_TYPE_FIELDS_KEY: unique symbol;
+/** Options for @WireType decorator. */
+export interface WireTypeOptions {
+    /** Field-level metadata (field name -> Metadata). */
+    metadata?: Record<string, Metadata>;
+}
+/**
+ * Register a class as a Fory XLANG wire type.
+ *
+ * @example
+ * ```ts
+ * @WireType("billing/Invoice")
+ * class Invoice {
+ *   amount = 0;
+ *   currency = "USD";
+ * }
+ *
+ * @WireType("billing/Invoice", {
+ *   metadata: { amount: new Metadata({ description: "Total in cents" }) }
+ * })
+ * class InvoiceWithDocs {
+ *   amount = 0;
+ *   currency = "USD";
+ * }
+ * ```
+ */
+export declare function WireType(tag: string, options?: WireTypeOptions): <T extends new (...args: any[]) => any>(target: T, _context: ClassDecoratorContext) => T;
+export {};
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;gEAC4D;IAC5D,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACpC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,IAC5B,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACpD,QAAQ,CAAC,EACT,UAAU,qBAAqB,KAC9B,CAAC,CAyCL;AAID,UAAU,UAAU;IAClB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC;IAC1C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;CACxC;AAyBD;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,OAAO,CAAC,EAAE,UAAU,IA/BrB,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,YACC,2BAA2B,KACpC,CAAC,CA8BL;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,UAAU,IA7C9B,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,YACC,2BAA2B,KACpC,CAAC,CA4CL;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,UAAU,IA1D9B,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,YACC,2BAA2B,KACpC,CAAC,CAyDL;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,IAvE5B,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,YACC,2BAA2B,KACpC,CAAC,CAsEL;AAID,sCAAsC;AACtC,eAAO,MAAM,aAAa,eAAgC,CAAC;AAE3D,iDAAiD;AACjD,eAAO,MAAM,oBAAoB,eAAuC,CAAC;AAEzE,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,IAC5C,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACpD,QAAQ,CAAC,EACT,UAAU,qBAAqB,KAC9B,CAAC,CAOL"}

package/dist/decorators.js

@@ -0,0 +1,175 @@
+/**
+ * Service and method decorators for defining Aster RPC services.
+ *
+ * Spec reference: S7.1-7.4 (decorators), S7.6 (language ownership)
+ *
+ * Uses TC39 Stage 3 decorators (TS 5.0+). These compile away during
+ * TypeScript compilation -- no runtime decorator support needed.
+ *
+ * @example
+ * ```ts
+ * @Service({ name: "Echo", version: 1 })
+ * class EchoService {
+ *   @Rpc({ timeout: 30 })
+ *   async echo(req: EchoRequest): Promise<EchoResponse> {
+ *     return new EchoResponse({ reply: req.message });
+ *   }
+ *
+ *   @ServerStream()
+ *   async *watchItems(req: WatchRequest): AsyncGenerator<ItemUpdate> {
+ *     yield new ItemUpdate({ item: "one" });
+ *   }
+ * }
+ * ```
+ */
+import { RpcPattern } from './types.js';
+import { SERVICE_INFO_KEY, METHOD_INFO_KEY, } from './service.js';
+/**
+ * Decorate a class as an Aster RPC service.
+ *
+ * @example
+ * ```ts
+ * @Service({ name: "Echo", version: 1 })
+ * class EchoService { ... }
+ * ```
+ */
+export function Service(options) {
+    return function (target, _context) {
+        // Collect methods that were decorated with @Rpc etc.
+        const methods = new Map();
+        // Scan prototype for method decorators
+        const proto = target.prototype;
+        const methodNames = Object.getOwnPropertyNames(proto).filter((n) => n !== 'constructor');
+        for (const name of methodNames) {
+            const descriptor = Object.getOwnPropertyDescriptor(proto, name);
+            if (!descriptor || typeof descriptor.value !== 'function')
+                continue;
+            const info = descriptor.value[METHOD_INFO_KEY];
+            if (info) {
+                // Use explicit name from @Rpc({name: "..."}) if set, else method name
+                if (!info.name) {
+                    info.name = name;
+                }
+                info.handler = descriptor.value;
+                methods.set(info.name, info);
+            }
+        }
+        // Canonical scope value is 'session'; accept the legacy 'stream' alias
+        // on input.
+        const scoped = options.scoped === 'stream' ? 'session' : (options.scoped ?? 'shared');
+        const serviceInfo = {
+            name: options.name,
+            version: options.version ?? 1,
+            scoped,
+            methods,
+            serializationModes: options.serialization ?? [],
+            requires: options.requires,
+            metadata: options.metadata,
+            instance: undefined,
+        };
+        target[SERVICE_INFO_KEY] = serviceInfo;
+        return target;
+    };
+}
+function methodDecorator(pattern, options) {
+    return function (target, _context) {
+        const info = {
+            name: options?.name ?? '', // explicit name or filled in by @Service
+            pattern,
+            requestType: options?.request,
+            responseType: options?.response,
+            timeout: options?.timeout,
+            idempotent: options?.idempotent ?? false,
+            serialization: options?.serialization,
+            requires: options?.requires,
+            handler: undefined, // filled in by @Service
+            metadata: options?.metadata,
+        };
+        target[METHOD_INFO_KEY] = info;
+        return target;
+    };
+}
+/**
+ * Mark a method as a unary RPC (single request, single response).
+ *
+ * @example
+ * ```ts
+ * @Rpc({ timeout: 30, idempotent: true })
+ * async getUser(req: GetUserRequest): Promise<User> { ... }
+ * ```
+ */
+export function Rpc(options) {
+    return methodDecorator(RpcPattern.UNARY, options);
+}
+/**
+ * Mark a method as a server-streaming RPC (single request, multiple responses).
+ * Method must be an async generator.
+ *
+ * @example
+ * ```ts
+ * @ServerStream()
+ * async *watchUpdates(req: WatchRequest): AsyncGenerator<Update> { ... }
+ * ```
+ */
+export function ServerStream(options) {
+    return methodDecorator(RpcPattern.SERVER_STREAM, options);
+}
+/**
+ * Mark a method as a client-streaming RPC (multiple requests, single response).
+ *
+ * @example
+ * ```ts
+ * @ClientStream()
+ * async uploadBatch(requests: AsyncIterable<Item>): Promise<BatchResult> { ... }
+ * ```
+ */
+export function ClientStream(options) {
+    return methodDecorator(RpcPattern.CLIENT_STREAM, options);
+}
+/**
+ * Mark a method as a bidirectional-streaming RPC.
+ *
+ * @example
+ * ```ts
+ * @BidiStream()
+ * async *chat(requests: AsyncIterable<Message>): AsyncGenerator<Message> { ... }
+ * ```
+ */
+export function BidiStream(options) {
+    return methodDecorator(RpcPattern.BIDI_STREAM, options);
+}
+// -- Wire type decorator ------------------------------------------------------
+/** Metadata key for wire type tag. */
+export const WIRE_TYPE_KEY = Symbol.for('aster.wire_type');
+/** Metadata key for wire type field metadata. */
+export const WIRE_TYPE_FIELDS_KEY = Symbol.for('aster.wire_type_fields');
+/**
+ * Register a class as a Fory XLANG wire type.
+ *
+ * @example
+ * ```ts
+ * @WireType("billing/Invoice")
+ * class Invoice {
+ *   amount = 0;
+ *   currency = "USD";
+ * }
+ *
+ * @WireType("billing/Invoice", {
+ *   metadata: { amount: new Metadata({ description: "Total in cents" }) }
+ * })
+ * class InvoiceWithDocs {
+ *   amount = 0;
+ *   currency = "USD";
+ * }
+ * ```
+ */
+export function WireType(tag, options) {
+    return function (target, _context) {
+        target[WIRE_TYPE_KEY] = tag;
+        if (options?.metadata) {
+            target[WIRE_TYPE_FIELDS_KEY] = options.metadata;
+        }
+        return target;
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

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

package/dist/dynamic.d.ts

@@ -0,0 +1,61 @@
+/**
+ * DynamicTypeFactory — synthesize wire-compatible types from contract manifests.
+ *
+ * Enables calling remote services without local type definitions.
+ * Given a ContractManifest, this factory creates JavaScript classes
+ * with the correct field names and Fory wire tags.
+ *
+ * Used by the shell, MCP server, and dynamic clients.
+ */
+import type { ManifestMethod, ManifestField } from './contract/manifest.js';
+/** A dynamically synthesized type class. */
+export interface DynamicType {
+    new (init?: Record<string, unknown>): Record<string, unknown>;
+    wireTag: string;
+}
+/**
+ * Create a dynamic type class from a wire tag and field descriptors.
+ *
+ * The returned class:
+ * - Has the correct wire tag (set via WIRE_TYPE_KEY symbol)
+ * - Accepts a partial init object in the constructor
+ * - Has default values for all fields based on their type
+ */
+export declare function createDynamicType(wireTag: string, fields: ManifestField[]): DynamicType;
+/**
+ * Factory that synthesizes types for all methods in a manifest.
+ *
+ * Returns a map of wire tag -> DynamicType for both request and response types.
+ */
+export declare class DynamicTypeFactory {
+    private types;
+    /**
+     * Synthesize types for a method's request and response.
+     * Returns [RequestType, ResponseType] or undefined if wire tags are missing.
+     */
+    synthesizeForMethod(method: ManifestMethod): [DynamicType, DynamicType] | undefined;
+    /** Get a previously synthesized type by wire tag. */
+    get(wireTag: string): DynamicType | undefined;
+    /** Get a type by wire tag (alias for get()). */
+    getType(wireTag: string): DynamicType | undefined;
+    /** Return all synthesized types. */
+    getAllTypes(): DynamicType[];
+    /** Number of registered types. */
+    get typeCount(): number;
+    /**
+     * Register types from a manifest's method descriptors.
+     * Synthesizes request and response types for all methods.
+     */
+    registerFromManifest(manifest: {
+        methods: ManifestMethod[];
+    }): void;
+    /**
+     * Build a request object for a method using default values.
+     * Returns an instance of the synthesized request type.
+     */
+    buildRequest(method: ManifestMethod, overrides?: Record<string, unknown>): unknown;
+    /** All synthesized types. */
+    allTypes(): IterableIterator<[string, DynamicType]>;
+    private getOrCreate;
+}
+//# sourceMappingURL=dynamic.d.ts.map

package/dist/dynamic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic.d.ts","sourceRoot":"","sources":["../src/dynamic.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5E,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,WAAW,CAgCvF;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAkC;IAE/C;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,SAAS;IASnF,qDAAqD;IACrD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7C,gDAAgD;IAChD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjD,oCAAoC;IACpC,WAAW,IAAI,WAAW,EAAE;IAI5B,kCAAkC;IAClC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,oBAAoB,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE,GAAG,IAAI;IAMnE;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAYlF,6BAA6B;IAC7B,QAAQ,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAInD,OAAO,CAAC,WAAW;CAQpB"}

package/dist/dynamic.js

@@ -0,0 +1,147 @@
+/**
+ * DynamicTypeFactory — synthesize wire-compatible types from contract manifests.
+ *
+ * Enables calling remote services without local type definitions.
+ * Given a ContractManifest, this factory creates JavaScript classes
+ * with the correct field names and Fory wire tags.
+ *
+ * Used by the shell, MCP server, and dynamic clients.
+ */
+import { WIRE_TYPE_KEY } from './decorators.js';
+/**
+ * Create a dynamic type class from a wire tag and field descriptors.
+ *
+ * The returned class:
+ * - Has the correct wire tag (set via WIRE_TYPE_KEY symbol)
+ * - Accepts a partial init object in the constructor
+ * - Has default values for all fields based on their type
+ */
+export function createDynamicType(wireTag, fields) {
+    // Build default values
+    const defaults = {};
+    for (const field of fields) {
+        defaults[field.name] = field.default ?? defaultForType(field.type);
+    }
+    // Create the class dynamically
+    const DynClass = class {
+        static wireTag = wireTag;
+        constructor(init) {
+            // Apply defaults
+            for (const [key, value] of Object.entries(defaults)) {
+                this[key] = value;
+            }
+            // Apply init overrides
+            if (init) {
+                for (const [key, value] of Object.entries(init)) {
+                    this[key] = value;
+                }
+            }
+        }
+    };
+    // Set wire type tag
+    DynClass[WIRE_TYPE_KEY] = wireTag;
+    // Set the class name for debugging
+    Object.defineProperty(DynClass, 'name', { value: wireTag.split('/').pop() ?? wireTag });
+    return DynClass;
+}
+/**
+ * Factory that synthesizes types for all methods in a manifest.
+ *
+ * Returns a map of wire tag -> DynamicType for both request and response types.
+ */
+export class DynamicTypeFactory {
+    types = new Map();
+    /**
+     * Synthesize types for a method's request and response.
+     * Returns [RequestType, ResponseType] or undefined if wire tags are missing.
+     */
+    synthesizeForMethod(method) {
+        if (!method.requestWireTag || !method.responseWireTag)
+            return undefined;
+        const reqType = this.getOrCreate(method.requestWireTag, method.fields);
+        const respType = this.getOrCreate(method.responseWireTag, method.responseFields ?? []);
+        return [reqType, respType];
+    }
+    /** Get a previously synthesized type by wire tag. */
+    get(wireTag) {
+        return this.types.get(wireTag);
+    }
+    /** Get a type by wire tag (alias for get()). */
+    getType(wireTag) {
+        return this.types.get(wireTag);
+    }
+    /** Return all synthesized types. */
+    getAllTypes() {
+        return [...this.types.values()];
+    }
+    /** Number of registered types. */
+    get typeCount() {
+        return this.types.size;
+    }
+    /**
+     * Register types from a manifest's method descriptors.
+     * Synthesizes request and response types for all methods.
+     */
+    registerFromManifest(manifest) {
+        for (const method of manifest.methods) {
+            this.synthesizeForMethod(method);
+        }
+    }
+    /**
+     * Build a request object for a method using default values.
+     * Returns an instance of the synthesized request type.
+     */
+    buildRequest(method, overrides) {
+        if (!method.requestWireTag)
+            return overrides ?? {};
+        let type = this.types.get(method.requestWireTag);
+        if (!type && method.fields) {
+            type = createDynamicType(method.requestWireTag, method.fields);
+            this.types.set(method.requestWireTag, type);
+        }
+        if (!type)
+            return overrides ?? {};
+        const instance = new type(overrides);
+        return instance;
+    }
+    /** All synthesized types. */
+    allTypes() {
+        return this.types.entries();
+    }
+    getOrCreate(wireTag, fields) {
+        let type = this.types.get(wireTag);
+        if (!type) {
+            type = createDynamicType(wireTag, fields);
+            this.types.set(wireTag, type);
+        }
+        return type;
+    }
+}
+/** Get default value for a field type string. */
+function defaultForType(typeStr) {
+    switch (typeStr) {
+        case 'str':
+        case 'string':
+            return '';
+        case 'int':
+        case 'int32':
+        case 'int64':
+        case 'float':
+        case 'float32':
+        case 'float64':
+        case 'number':
+            return 0;
+        case 'bool':
+        case 'boolean':
+            return false;
+        case 'bytes':
+            return new Uint8Array(0);
+        default:
+            if (typeStr.startsWith('list[') || typeStr.startsWith('List['))
+                return [];
+            if (typeStr.startsWith('dict[') || typeStr.startsWith('Dict[') || typeStr.startsWith('Map['))
+                return {};
+            return null;
+    }
+}
+//# sourceMappingURL=dynamic.js.map

package/dist/dynamic.js.map

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

package/dist/framing.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Wire-level frame read/write.
+ *
+ * Spec reference: S6.1 (stream framing)
+ *
+ * Frame layout (on a QUIC stream):
+ *
+ *     +----------+-------+----------+
+ *     | Length   | Flags | Payload  |
+ *     | 4 bytes  |1 byte | variable |
+ *     | LE u32   |       |          |
+ *     +----------+-------+----------+
+ *
+ * - Length is the total size of Flags + Payload (i.e. payload.length + 1).
+ *   Maximum 16 MiB per frame. A Length of 0 is invalid.
+ * - Flags is a 1-byte bitfield (see constants below).
+ * - Payload is the serialized bytes.
+ */
+/** Minimal async send-stream interface (matches IrohSendStream from NAPI). */
+export interface SendStream {
+    writeAll(data: Uint8Array): Promise<void>;
+}
+/** Minimal async recv-stream interface (matches IrohRecvStream from NAPI). */
+export interface RecvStream {
+    readExact(n: number): Promise<Uint8Array>;
+}
+/** Bit 0 -- payload is zstd-compressed. */
+export declare const COMPRESSED = 1;
+/** Bit 1 -- trailing status frame. */
+export declare const TRAILER = 2;
+/** Bit 2 -- stream header (first frame). */
+export declare const HEADER = 4;
+/** Bit 3 -- Fory row schema frame. */
+export declare const ROW_SCHEMA = 8;
+/** Bit 4 -- per-call header in a session stream. */
+export declare const CALL = 16;
+/** Bit 5 -- cancel current call in a session stream. */
+export declare const CANCEL = 32;
+/** Raised when a framing violation is detected. */
+export declare class FramingError extends Error {
+    constructor(message: string);
+}
+/**
+ * Write a single frame to a send stream.
+ *
+ * @param stream - An async send stream with a writeAll method.
+ * @param payload - The serialized payload bytes.
+ * @param flags - The 1-byte flag bitfield (default 0).
+ * @throws FramingError if the frame exceeds MAX_FRAME_SIZE or has an invalid empty payload.
+ */
+export declare function writeFrame(stream: SendStream, payload: Uint8Array, flags?: number): Promise<void>;
+/** Result of reading a frame: [payload, flags]. */
+export type FrameResult = [payload: Uint8Array, flags: number];
+/**
+ * Read a single frame from a receive stream.
+ *
+ * @param stream - The QUIC receive stream.
+ * @param timeoutS - Optional read timeout in seconds. Defaults to DEFAULT_FRAME_READ_TIMEOUT_S.
+ *                    Pass 0 to disable.
+ * @returns A [payload, flags] tuple, or null if the stream has ended cleanly.
+ * @throws FramingError on wire-format violations (zero length, oversized frame).
+ */
+export declare function readFrame(stream: RecvStream, timeoutS?: number): Promise<FrameResult | null>;
+/**
+ * Encode a frame to raw bytes (for testing and conformance vectors).
+ * Does not write to a stream -- returns the complete wire bytes.
+ */
+export declare function encodeFrame(payload: Uint8Array, flags?: number): Uint8Array;
+/**
+ * Decode raw wire bytes into [payload, flags] (for testing and conformance vectors).
+ * Does not read from a stream -- parses the complete wire bytes.
+ */
+export declare function decodeFrame(wire: Uint8Array): FrameResult;
+//# sourceMappingURL=framing.d.ts.map

package/dist/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../src/framing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAUH,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3C;AAID,2CAA2C;AAC3C,eAAO,MAAM,UAAU,IAAO,CAAC;AAC/B,sCAAsC;AACtC,eAAO,MAAM,OAAO,IAAO,CAAC;AAC5B,4CAA4C;AAC5C,eAAO,MAAM,MAAM,IAAO,CAAC;AAC3B,sCAAsC;AACtC,eAAO,MAAM,UAAU,IAAO,CAAC;AAC/B,oDAAoD;AACpD,eAAO,MAAM,IAAI,KAAO,CAAC;AACzB,wDAAwD;AACxD,eAAO,MAAM,MAAM,KAAO,CAAC;AAI3B,mDAAmD;AACnD,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AASD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,UAAU,EACnB,KAAK,SAAI,GACR,OAAO,CAAC,IAAI,CAAC,CAqBf;AAID,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAE/D;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,UAAU,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA8D7B;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,SAAI,GAAG,UAAU,CAQtE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAoBzD"}