@polyester/sdk 0.9.1 → 0.10.0

package/dist/services/triggers/triggers.js

@@ -2,22 +2,13 @@ import { parse } from "../../shared/validation.js";
 import { toConnectCallOptions } from "../../shared/request-options.js";
 import { removeUndefined } from "../../utils/remove-undefined.js";
 import { resolveAccountScopedInput } from "../subaccount-resolver.js";
-import { publicationHandlerErrorContext } from "../../shared/subscription-errors.js";
-import { createReadyGate } from "../../shared/decimal-surface.js";
+import { connectReadyGatedProtoChannel } from "../../realtime/ready-gated-subscription.js";
 import { TriggerEventSchema, TriggerSchema, TriggersService as TriggersService$1 } from "../../gen/triggers/v1/triggers_pb.js";
 import { CancelTriggerInputSchema, GetTriggerInputSchema, ListTriggerEventsInputSchema, ListTriggersInputSchema, PauseTriggerInputSchema, ResumeTriggerInputSchema, createCreateTriggerInputSchema, createModifyTriggerInputSchema } from "./trigger-input.schemas.js";
 import { CancelTriggerResultSchema, CreateTriggerResultSchema, ModifyTriggerResultSchema, PauseTriggerResultSchema, ResumeTriggerResultSchema, createTriggerEventSchema, createTriggerSchema } from "./triggers-output.schemas.js";
 import { createClient } from "@connectrpc/connect";
 import * as v from "valibot";
 //#region src/services/triggers/triggers.ts
-function hasKnownTriggerSymbol(scales, trigger) {
-	try {
-		scales.baseQty(trigger.symbolId);
-		return true;
-	} catch {
-		return false;
-	}
-}
 /**
 * Manages standalone order triggers and their realtime lifecycle/event streams.
 */
@@ -70,7 +61,7 @@ var TriggersService = class {
 		const validated = parse(ListTriggersInputSchema, resolved);
 		const res = await this.#client.listTriggers(removeUndefined(validated), toConnectCallOptions(options));
 		return {
-			triggers: parse(v.array(this.#triggerSchema), res.triggers.filter((trigger) => hasKnownTriggerSymbol(this.#scales, trigger))),
+			triggers: parse(v.array(this.#triggerSchema), res.triggers),
 			nextPageToken: res.nextPageToken
 		};
 	}
@@ -135,15 +126,13 @@ var TriggersService = class {
 	*/
 	subscribe(input) {
 		const channel = `private:spot:triggers:${input.accountId}:proto`;
-		const gate = createReadyGate(() => this.#scales.ready(), (error) => input.onError?.(publicationHandlerErrorContext(channel, error)));
-		return this.#realtime.connectProtoChannel({
+		return connectReadyGatedProtoChannel(this.#realtime, {
 			channel,
 			schema: TriggerSchema,
+			ready: () => this.#scales.ready(),
 			onPublication: (data) => {
-				gate.run(() => {
-					const trigger = parse(this.#triggerSchema, data);
-					input.onEvent(trigger);
-				});
+				const trigger = parse(this.#triggerSchema, data);
+				input.onEvent(trigger);
 			},
 			onConnected: () => input.onOpen?.(),
 			onDisconnected: () => input.onClose?.(),
@@ -155,15 +144,13 @@ var TriggersService = class {
 	*/
 	subscribeEvents(input) {
 		const channel = `private:spot:triggers:events:${input.accountId}:proto`;
-		const gate = createReadyGate(() => this.#scales.ready(), (error) => input.onError?.(publicationHandlerErrorContext(channel, error)));
-		return this.#realtime.connectProtoChannel({
+		return connectReadyGatedProtoChannel(this.#realtime, {
 			channel,
 			schema: TriggerEventSchema,
+			ready: () => this.#scales.ready(),
 			onPublication: (data) => {
-				gate.run(() => {
-					const event = parse(this.#triggerEventSchema, data);
-					input.onEvent(event);
-				});
+				const event = parse(this.#triggerEventSchema, data);
+				input.onEvent(event);
 			},
 			onConnected: () => input.onOpen?.(),
 			onDisconnected: () => input.onClose?.(),

package/dist/services/triggers/triggers.js.map

@@ -1 +1 @@
-{"version":3,"file":"triggers.js","names":["#client","Proto.TriggersService","#realtime","#resolver","#scales","#createTriggerInputSchema","#modifyTriggerInputSchema","#triggerSchema","#triggerEventSchema","Proto.TriggerSchema","Proto.TriggerEventSchema"],"sources":["../../../src/services/triggers/triggers.ts"],"sourcesContent":["import * as Proto from \"../../gen/triggers/v1/triggers_pb.js\";\nimport { createClient, type Client, type Transport } from \"@connectrpc/connect\";\nimport { publicationHandlerErrorContext } from \"../../shared/subscription-errors.js\";\nimport * as v from \"valibot\";\nimport { parse } from \"../../shared/validation.js\";\nimport { type SubaccountResolver, resolveAccountScopedInput } from \"../subaccount-resolver.js\";\nimport { removeUndefined } from \"../../utils/remove-undefined.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterMutationOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport { createReadyGate, type SdkScales } from \"../../shared/decimal-surface.js\";\nimport {\n    createCreateTriggerInputSchema,\n    createModifyTriggerInputSchema,\n    ListTriggersInputSchema,\n    CancelTriggerInputSchema,\n    PauseTriggerInputSchema,\n    ResumeTriggerInputSchema,\n    GetTriggerInputSchema,\n    ListTriggerEventsInputSchema,\n    CreateTriggerResultSchema,\n    CancelTriggerResultSchema,\n    ModifyTriggerResultSchema,\n    PauseTriggerResultSchema,\n    ResumeTriggerResultSchema,\n    createTriggerSchema,\n    createTriggerEventSchema,\n    type Trigger,\n    type CreateTriggerInput,\n    type ListTriggersInput,\n    type CancelTriggerInput,\n    type GetTriggerInput,\n    type ModifyTriggerInput,\n    type PauseTriggerInput,\n    type ResumeTriggerInput,\n    type ListTriggerEventsInput,\n    type CreateTriggerResult,\n    type CancelTriggerResult,\n    type ModifyTriggerResult,\n    type PauseTriggerResult,\n    type ResumeTriggerResult,\n    type ListTriggerEventsResult,\n    type TriggerEvent,\n} from \"./triggers.schemas.js\";\nimport type { BaseSubscribeInput } from \"../../shared/types.js\";\nimport type { PolyesterRealtime } from \"../../realtime/index.js\";\n\nexport type {\n    CreateTriggerResult,\n    CancelTriggerResult,\n    ModifyTriggerResult,\n    PauseTriggerResult,\n    ResumeTriggerResult,\n    ListTriggerEventsResult,\n};\n\nexport interface ListTriggersResult {\n    triggers: Trigger[];\n    nextPageToken: string;\n}\n\nfunction hasKnownTriggerSymbol(scales: SdkScales, trigger: { symbolId: number }): boolean {\n    try {\n        scales.baseQty(trigger.symbolId);\n        return true;\n    } catch {\n        return false;\n    }\n}\n\ninterface SubscribeTriggersInput extends BaseSubscribeInput<Trigger> {\n    accountId: string;\n}\n\ninterface SubscribeTriggerEventsInput extends BaseSubscribeInput<TriggerEvent> {\n    accountId: string;\n}\n\n/**\n * Manages standalone order triggers and their realtime lifecycle/event streams.\n */\nexport class TriggersService {\n    #client: Client<typeof Proto.TriggersService>;\n    #realtime: PolyesterRealtime;\n    #resolver?: SubaccountResolver;\n    #scales: SdkScales;\n    #createTriggerInputSchema: ReturnType<typeof createCreateTriggerInputSchema>;\n    #modifyTriggerInputSchema: ReturnType<typeof createModifyTriggerInputSchema>;\n    #triggerSchema: ReturnType<typeof createTriggerSchema>;\n    #triggerEventSchema: ReturnType<typeof createTriggerEventSchema>;\n\n    constructor(\n        transport: Transport,\n        realtime: PolyesterRealtime,\n        resolver: SubaccountResolver | undefined,\n        scales: SdkScales,\n    ) {\n        this.#client = createClient(Proto.TriggersService, transport);\n        this.#realtime = realtime;\n        this.#resolver = resolver;\n        this.#scales = scales;\n        this.#createTriggerInputSchema = createCreateTriggerInputSchema(scales);\n        this.#modifyTriggerInputSchema = createModifyTriggerInputSchema(scales);\n        this.#triggerSchema = createTriggerSchema(scales);\n        this.#triggerEventSchema = createTriggerEventSchema(scales);\n    }\n\n    /**\n     * Creates a standalone trigger for a symbol ID, using that market's catalog quantity scale.\n     */\n    async create(\n        input: CreateTriggerInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<CreateTriggerResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(this.#createTriggerInputSchema, resolved);\n        const res = await this.#client.createTrigger(validatedInput, toConnectCallOptions(options));\n        return parse(CreateTriggerResultSchema, res);\n    }\n\n    /**\n     * Fetches one trigger by id in the resolved account scope and returns null when the backend response contains no trigger.\n     */\n    async get(input: GetTriggerInput, options?: PolyesterRequestOptions): Promise<Trigger | null> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(GetTriggerInputSchema, resolved);\n        const res = await this.#client.getTrigger(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n\n        if (!res.trigger) return null;\n        return parse(this.#triggerSchema, res.trigger);\n    }\n\n    /**\n     * Lists triggers for the resolved account scope with optional symbol ID, status, trigger type, parent order, limit, and page-token filters. Results are returned newest-first.\n     */\n    async list(\n        input: ListTriggersInput = {},\n        options?: PolyesterRequestOptions,\n    ): Promise<ListTriggersResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(ListTriggersInputSchema, resolved);\n        const res = await this.#client.listTriggers(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return {\n            triggers: parse(\n                v.array(this.#triggerSchema),\n                res.triggers.filter((trigger) => hasKnownTriggerSymbol(this.#scales, trigger)),\n            ),\n            nextPageToken: res.nextPageToken,\n        };\n    }\n\n    /**\n     * Cancels an active trigger by id in the resolved account scope and returns the trigger id, resulting status, and server timestamp.\n     */\n    async cancel(\n        input: CancelTriggerInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<CancelTriggerResult> {\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(CancelTriggerInputSchema, resolved);\n        const res = await this.#client.cancelTrigger(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return parse(CancelTriggerResultSchema, res);\n    }\n\n    /**\n     * Applies a limited patch to an existing trigger. The symbol ID routes policy checks for exposure-increasing changes.\n     */\n    async modify(\n        input: ModifyTriggerInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<ModifyTriggerResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(this.#modifyTriggerInputSchema, resolved);\n        const res = await this.#client.modifyTrigger(validated, toConnectCallOptions(options));\n        return parse(ModifyTriggerResultSchema, res);\n    }\n\n    /**\n     * Pauses an active trigger without discarding its immutable strategy configuration.\n     */\n    async pause(\n        input: PauseTriggerInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<PauseTriggerResult> {\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(PauseTriggerInputSchema, resolved);\n        const res = await this.#client.pauseTrigger(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return parse(PauseTriggerResultSchema, res);\n    }\n\n    /**\n     * Resumes a paused trigger using its symbol ID for policy checks.\n     */\n    async resume(\n        input: ResumeTriggerInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<ResumeTriggerResult> {\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(ResumeTriggerInputSchema, resolved);\n        const res = await this.#client.resumeTrigger(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return parse(ResumeTriggerResultSchema, res);\n    }\n\n    /**\n     * Returns newest-first historical lifecycle events for one trigger, optionally filtered by event type. Fired events enumerate child-order actions. The SDK defaults limit to 50.\n     */\n    async listEvents(\n        input: ListTriggerEventsInput,\n        options?: PolyesterRequestOptions,\n    ): Promise<ListTriggerEventsResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(ListTriggerEventsInputSchema, resolved);\n\n        const res = await this.#client.listTriggerEvents(\n            removeUndefined({\n                triggerId: validated.triggerId,\n                subaccountId: validated.subaccountId,\n                limit: validated.limit ?? 50,\n                eventType: validated.eventType,\n                pageToken: validated.pageToken ?? \"\",\n            }),\n            toConnectCallOptions(options),\n        );\n\n        return {\n            events: parse(v.array(this.#triggerEventSchema), res.events),\n            nextPageToken: res.nextPageToken,\n        };\n    }\n\n    /**\n     * Subscribes to private trigger state updates on private:spot:triggers:{accountId}:proto and emits parsed trigger records.\n     */\n    subscribe(input: SubscribeTriggersInput): () => void {\n        const channel = `private:spot:triggers:${input.accountId}:proto`;\n        const gate = createReadyGate(\n            () => this.#scales.ready(),\n            (error) => input.onError?.(publicationHandlerErrorContext(channel, error)),\n        );\n        return this.#realtime.connectProtoChannel({\n            channel,\n            schema: Proto.TriggerSchema,\n            onPublication: (data) => {\n                gate.run(() => {\n                    const trigger = parse(this.#triggerSchema, data);\n                    input.onEvent(trigger);\n                });\n            },\n            onConnected: () => input.onOpen?.(),\n            onDisconnected: () => input.onClose?.(),\n            onError: input.onError,\n        });\n    }\n\n    /**\n     * Subscribes to private trigger lifecycle events on private:spot:triggers:events:{accountId}:proto and emits parsed trigger event records.\n     */\n    subscribeEvents(input: SubscribeTriggerEventsInput): () => void {\n        const channel = `private:spot:triggers:events:${input.accountId}:proto`;\n        const gate = createReadyGate(\n            () => this.#scales.ready(),\n            (error) => input.onError?.(publicationHandlerErrorContext(channel, error)),\n        );\n        return this.#realtime.connectProtoChannel({\n            channel,\n            schema: Proto.TriggerEventSchema,\n            onPublication: (data) => {\n                gate.run(() => {\n                    const event = parse(this.#triggerEventSchema, data);\n                    input.onEvent(event);\n                });\n            },\n            onConnected: () => input.onOpen?.(),\n            onDisconnected: () => input.onClose?.(),\n            onError: input.onError,\n        });\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"triggers.js","names":["#client","Proto.TriggersService","#realtime","#resolver","#scales","#createTriggerInputSchema","#modifyTriggerInputSchema","#triggerSchema","#triggerEventSchema","Proto.TriggerSchema","Proto.TriggerEventSchema"],"sources":["../../../src/services/triggers/triggers.ts"],"sourcesContent":["import * as Proto from \"../../gen/triggers/v1/triggers_pb.js\";\nimport { createClient, type Client, type Transport } from \"@connectrpc/connect\";\nimport * as v from \"valibot\";\nimport { parse } from \"../../shared/validation.js\";\nimport { type SubaccountResolver, resolveAccountScopedInput } from \"../subaccount-resolver.js\";\nimport { removeUndefined } from \"../../utils/remove-undefined.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterMutationOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport type { SdkScales } from \"../../shared/decimal-surface.js\";\nimport { connectReadyGatedProtoChannel } from \"../../realtime/ready-gated-subscription.js\";\nimport {\n    createCreateTriggerInputSchema,\n    createModifyTriggerInputSchema,\n    ListTriggersInputSchema,\n    CancelTriggerInputSchema,\n    PauseTriggerInputSchema,\n    ResumeTriggerInputSchema,\n    GetTriggerInputSchema,\n    ListTriggerEventsInputSchema,\n    CreateTriggerResultSchema,\n    CancelTriggerResultSchema,\n    ModifyTriggerResultSchema,\n    PauseTriggerResultSchema,\n    ResumeTriggerResultSchema,\n    createTriggerSchema,\n    createTriggerEventSchema,\n    type Trigger,\n    type CreateTriggerInput,\n    type ListTriggersInput,\n    type CancelTriggerInput,\n    type GetTriggerInput,\n    type ModifyTriggerInput,\n    type PauseTriggerInput,\n    type ResumeTriggerInput,\n    type ListTriggerEventsInput,\n    type CreateTriggerResult,\n    type CancelTriggerResult,\n    type ModifyTriggerResult,\n    type PauseTriggerResult,\n    type ResumeTriggerResult,\n    type ListTriggerEventsResult,\n    type TriggerEvent,\n} from \"./triggers.schemas.js\";\nimport type { BaseSubscribeInput } from \"../../shared/types.js\";\nimport type { PolyesterRealtime } from \"../../realtime/index.js\";\n\nexport type {\n    CreateTriggerResult,\n    CancelTriggerResult,\n    ModifyTriggerResult,\n    PauseTriggerResult,\n    ResumeTriggerResult,\n    ListTriggerEventsResult,\n};\n\nexport interface ListTriggersResult {\n    triggers: Trigger[];\n    nextPageToken: string;\n}\n\ninterface SubscribeTriggersInput extends BaseSubscribeInput<Trigger> {\n    accountId: string;\n}\n\ninterface SubscribeTriggerEventsInput extends BaseSubscribeInput<TriggerEvent> {\n    accountId: string;\n}\n\n/**\n * Manages standalone order triggers and their realtime lifecycle/event streams.\n */\nexport class TriggersService {\n    #client: Client<typeof Proto.TriggersService>;\n    #realtime: PolyesterRealtime;\n    #resolver?: SubaccountResolver;\n    #scales: SdkScales;\n    #createTriggerInputSchema: ReturnType<typeof createCreateTriggerInputSchema>;\n    #modifyTriggerInputSchema: ReturnType<typeof createModifyTriggerInputSchema>;\n    #triggerSchema: ReturnType<typeof createTriggerSchema>;\n    #triggerEventSchema: ReturnType<typeof createTriggerEventSchema>;\n\n    constructor(\n        transport: Transport,\n        realtime: PolyesterRealtime,\n        resolver: SubaccountResolver | undefined,\n        scales: SdkScales,\n    ) {\n        this.#client = createClient(Proto.TriggersService, transport);\n        this.#realtime = realtime;\n        this.#resolver = resolver;\n        this.#scales = scales;\n        this.#createTriggerInputSchema = createCreateTriggerInputSchema(scales);\n        this.#modifyTriggerInputSchema = createModifyTriggerInputSchema(scales);\n        this.#triggerSchema = createTriggerSchema(scales);\n        this.#triggerEventSchema = createTriggerEventSchema(scales);\n    }\n\n    /**\n     * Creates a standalone trigger for a symbol ID, using that market's catalog quantity scale.\n     */\n    async create(\n        input: CreateTriggerInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<CreateTriggerResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(this.#createTriggerInputSchema, resolved);\n        const res = await this.#client.createTrigger(validatedInput, toConnectCallOptions(options));\n        return parse(CreateTriggerResultSchema, res);\n    }\n\n    /**\n     * Fetches one trigger by id in the resolved account scope and returns null when the backend response contains no trigger.\n     */\n    async get(input: GetTriggerInput, options?: PolyesterRequestOptions): Promise<Trigger | null> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(GetTriggerInputSchema, resolved);\n        const res = await this.#client.getTrigger(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n\n        if (!res.trigger) return null;\n        return parse(this.#triggerSchema, res.trigger);\n    }\n\n    /**\n     * Lists triggers for the resolved account scope with optional symbol ID, status, trigger type, parent order, limit, and page-token filters. Results are returned newest-first.\n     */\n    async list(\n        input: ListTriggersInput = {},\n        options?: PolyesterRequestOptions,\n    ): Promise<ListTriggersResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(ListTriggersInputSchema, resolved);\n        const res = await this.#client.listTriggers(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return {\n            triggers: parse(v.array(this.#triggerSchema), res.triggers),\n            nextPageToken: res.nextPageToken,\n        };\n    }\n\n    /**\n     * Cancels an active trigger by id in the resolved account scope and returns the trigger id, resulting status, and server timestamp.\n     */\n    async cancel(\n        input: CancelTriggerInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<CancelTriggerResult> {\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(CancelTriggerInputSchema, resolved);\n        const res = await this.#client.cancelTrigger(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return parse(CancelTriggerResultSchema, res);\n    }\n\n    /**\n     * Applies a limited patch to an existing trigger. The symbol ID routes policy checks for exposure-increasing changes.\n     */\n    async modify(\n        input: ModifyTriggerInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<ModifyTriggerResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(this.#modifyTriggerInputSchema, resolved);\n        const res = await this.#client.modifyTrigger(validated, toConnectCallOptions(options));\n        return parse(ModifyTriggerResultSchema, res);\n    }\n\n    /**\n     * Pauses an active trigger without discarding its immutable strategy configuration.\n     */\n    async pause(\n        input: PauseTriggerInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<PauseTriggerResult> {\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(PauseTriggerInputSchema, resolved);\n        const res = await this.#client.pauseTrigger(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return parse(PauseTriggerResultSchema, res);\n    }\n\n    /**\n     * Resumes a paused trigger using its symbol ID for policy checks.\n     */\n    async resume(\n        input: ResumeTriggerInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<ResumeTriggerResult> {\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(ResumeTriggerInputSchema, resolved);\n        const res = await this.#client.resumeTrigger(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return parse(ResumeTriggerResultSchema, res);\n    }\n\n    /**\n     * Returns newest-first historical lifecycle events for one trigger, optionally filtered by event type. Fired events enumerate child-order actions. The SDK defaults limit to 50.\n     */\n    async listEvents(\n        input: ListTriggerEventsInput,\n        options?: PolyesterRequestOptions,\n    ): Promise<ListTriggerEventsResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validated = parse(ListTriggerEventsInputSchema, resolved);\n\n        const res = await this.#client.listTriggerEvents(\n            removeUndefined({\n                triggerId: validated.triggerId,\n                subaccountId: validated.subaccountId,\n                limit: validated.limit ?? 50,\n                eventType: validated.eventType,\n                pageToken: validated.pageToken ?? \"\",\n            }),\n            toConnectCallOptions(options),\n        );\n\n        return {\n            events: parse(v.array(this.#triggerEventSchema), res.events),\n            nextPageToken: res.nextPageToken,\n        };\n    }\n\n    /**\n     * Subscribes to private trigger state updates on private:spot:triggers:{accountId}:proto and emits parsed trigger records.\n     */\n    subscribe(input: SubscribeTriggersInput): () => void {\n        const channel = `private:spot:triggers:${input.accountId}:proto`;\n        return connectReadyGatedProtoChannel(this.#realtime, {\n            channel,\n            schema: Proto.TriggerSchema,\n            ready: () => this.#scales.ready(),\n            onPublication: (data) => {\n                const trigger = parse(this.#triggerSchema, data);\n                input.onEvent(trigger);\n            },\n            onConnected: () => input.onOpen?.(),\n            onDisconnected: () => input.onClose?.(),\n            onError: input.onError,\n        });\n    }\n\n    /**\n     * Subscribes to private trigger lifecycle events on private:spot:triggers:events:{accountId}:proto and emits parsed trigger event records.\n     */\n    subscribeEvents(input: SubscribeTriggerEventsInput): () => void {\n        const channel = `private:spot:triggers:events:${input.accountId}:proto`;\n        return connectReadyGatedProtoChannel(this.#realtime, {\n            channel,\n            schema: Proto.TriggerEventSchema,\n            ready: () => this.#scales.ready(),\n            onPublication: (data) => {\n                const event = parse(this.#triggerEventSchema, data);\n                input.onEvent(event);\n            },\n            onConnected: () => input.onOpen?.(),\n            onDisconnected: () => input.onClose?.(),\n            onError: input.onError,\n        });\n    }\n}\n"],"mappings":"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"}

package/dist/services/zipper/zipper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zipper.d.ts","names":[],"sources":["../../../src/services/zipper/zipper.ts"],"mappings":";;;;;;;;UAwBiB,wCAAwC,mBAAmB;;;;cAK/D;;EAKG,YAAA,WAAW,WAAW,WAAW,mBAAmB,SAAS;;;;EASnE,yBACF,UAAU,0BACX,QAAQ;;;;;EASX,2BAA2B,OAAO"}
+{"version":3,"file":"zipper.d.ts","names":[],"sources":["../../../src/services/zipper/zipper.ts"],"mappings":";;;;;;;;UAoBiB,wCAAwC,mBAAmB;;;;cAK/D;;EAKG,YAAA,WAAW,WAAW,WAAW,mBAAmB,SAAS;;;;EASnE,yBACF,UAAU,0BACX,QAAQ;;;;;EASX,2BAA2B,OAAO"}

package/dist/services/zipper/zipper.js

@@ -1,8 +1,6 @@
 import { ConfigurationError } from "../../shared/errors.js";
 import { parse } from "../../shared/validation.js";
 import { toConnectCallOptions } from "../../shared/request-options.js";
-import { publicationHandlerErrorContext } from "../../shared/subscription-errors.js";
-import { createReadyGate } from "../../shared/decimal-surface.js";
 import { snapshotThenStream } from "../../realtime/snapshot-then-stream.js";
 import { ZippedAssetSupplyBatchSchema, ZipperService as ZipperService$1 } from "../../gen/chain/zipper/v1/zipper_pb.js";
 import { DepositWithdrawConfigSchema, createZippedAssetSupplyBatchSchema } from "./zipper.schemas.js";
@@ -38,8 +36,7 @@ var ZipperService = class {
 		if (!realtime || !scales) throw new ConfigurationError("Zipper supply subscriptions require a client-owned realtime connection and catalog scales.");
 		const channel = "public:chain:zipped-asset:supply:proto";
 		const schema = createZippedAssetSupplyBatchSchema(scales);
-		const onError = (error) => input.onError?.(error);
-		const gate = createReadyGate(() => scales.ready(), (error) => onError(publicationHandlerErrorContext(channel, error)));
+		let catalogReady = false;
 		const parseBatch = (batch) => parse(schema, batch);
 		const parseUpdates = (updates) => parseBatch(create(ZippedAssetSupplyBatchSchema, { updates: [...updates] })).updates;
 		const stream = snapshotThenStream({
@@ -51,25 +48,25 @@ var ZipperService = class {
 				maxAttempts: 3,
 				delayMs: 1e3
 			},
-			snapshotFailureMode: "live",
-			fetchSnapshot: () => this.getDepositWithdrawConfig(),
+			snapshotFailureMode: () => catalogReady ? "live" : "wait",
+			fetchSnapshot: async () => {
+				await scales.ready();
+				catalogReady = true;
+				return this.getDepositWithdrawConfig();
+			},
 			readPublication: (batch) => batch.updates,
 			bufferPublicationKey: (update) => update.zippedAssetId,
 			applySnapshot: (snapshot, bufferedUpdates) => {
-				gate.run(() => {
-					const latestByZippedAssetId = /* @__PURE__ */ new Map();
-					for (const asset of snapshot.assets) for (const variant of asset.variants) latestByZippedAssetId.set(variant.zippedAssetId, variant.supply);
-					for (const update of parseUpdates(bufferedUpdates)) latestByZippedAssetId.set(update.zippedAssetId, update.supply);
-					input.onEvent({ updates: Array.from(latestByZippedAssetId, ([zippedAssetId, supply]) => ({
-						zippedAssetId,
-						supply
-					})) });
-				});
+				const latestByZippedAssetId = /* @__PURE__ */ new Map();
+				for (const asset of snapshot.assets) for (const variant of asset.variants) latestByZippedAssetId.set(variant.zippedAssetId, variant.supply);
+				for (const update of parseUpdates(bufferedUpdates)) latestByZippedAssetId.set(update.zippedAssetId, update.supply);
+				input.onEvent({ updates: Array.from(latestByZippedAssetId, ([zippedAssetId, supply]) => ({
+					zippedAssetId,
+					supply
+				})) });
 			},
 			applyLivePublications: (updates) => {
-				gate.run(() => {
-					input.onEvent({ updates: parseUpdates(updates) });
-				});
+				input.onEvent({ updates: parseUpdates(updates) });
 			},
 			onOpen: input.onOpen,
 			onClose: input.onClose,

package/dist/services/zipper/zipper.js.map

@@ -1 +1 @@
-{"version":3,"file":"zipper.js","names":["#client","Proto.ZipperService","#realtime","#scales","Proto.ZippedAssetSupplyBatchSchema"],"sources":["../../../src/services/zipper/zipper.ts"],"sourcesContent":["import { create } from \"@bufbuild/protobuf\";\nimport * as Proto from \"../../gen/chain/zipper/v1/zipper_pb.js\";\nimport type { PolyesterRealtime } from \"../../realtime/types.js\";\nimport { createClient, type Client, type Transport } from \"@connectrpc/connect\";\nimport {\n    DepositWithdrawConfigSchema,\n    createZippedAssetSupplyBatchSchema,\n    type DepositWithdrawConfig,\n    type ZippedAssetSupplyBatch,\n} from \"./zipper.schemas.js\";\nimport {\n    publicationHandlerErrorContext,\n    type SdkSubscriptionErrorContext,\n} from \"../../shared/subscription-errors.js\";\nimport { parse } from \"../../shared/validation.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport type { BaseSubscribeInput } from \"../../shared/types.js\";\nimport { createReadyGate, type SdkScales } from \"../../shared/decimal-surface.js\";\nimport { ConfigurationError } from \"../../shared/errors.js\";\nimport { snapshotThenStream } from \"../../realtime/snapshot-then-stream.js\";\n\nexport interface SubscribeZippedAssetSupplyInput extends BaseSubscribeInput<ZippedAssetSupplyBatch> {}\n\n/**\n * Reads public Zipper deposit/withdraw chain and asset configuration.\n */\nexport class ZipperService {\n    #client: Client<typeof Proto.ZipperService>;\n    #realtime: PolyesterRealtime | undefined;\n    #scales: SdkScales | undefined;\n\n    constructor(transport: Transport, realtime?: PolyesterRealtime, scales?: SdkScales) {\n        this.#client = createClient(Proto.ZipperService, transport);\n        this.#realtime = realtime;\n        this.#scales = scales;\n    }\n\n    /**\n     * Returns supported external chains, unified assets, chain-specific asset variants, network fees, min deposit/withdraw amounts, and contract metadata for Zipper-powered deposit and withdraw flows.\n     */\n    async getDepositWithdrawConfig(\n        options?: PolyesterRequestOptions,\n    ): Promise<DepositWithdrawConfig> {\n        const res = await this.#client.getDepositWithdrawConfig({}, toConnectCallOptions(options));\n        return parse(DepositWithdrawConfigSchema, res);\n    }\n\n    /**\n     * Attaches to the public supply stream before capturing a route-supply snapshot,\n     * then resnapshots whenever the channel establishes a new subscription epoch.\n     */\n    subscribeZippedAssetSupply(input: SubscribeZippedAssetSupplyInput): () => void {\n        const realtime = this.#realtime;\n        const scales = this.#scales;\n        if (!realtime || !scales) {\n            throw new ConfigurationError(\n                \"Zipper supply subscriptions require a client-owned realtime connection and catalog scales.\",\n            );\n        }\n\n        const channel = \"public:chain:zipped-asset:supply:proto\";\n        const schema = createZippedAssetSupplyBatchSchema(scales);\n        const onError = (error: SdkSubscriptionErrorContext) => input.onError?.(error);\n        const gate = createReadyGate(\n            () => scales.ready(),\n            (error) => onError(publicationHandlerErrorContext(channel, error)),\n        );\n\n        const parseBatch = (batch: Proto.ZippedAssetSupplyBatch): ZippedAssetSupplyBatch =>\n            parse(schema, batch);\n        const parseUpdates = (\n            updates: readonly Proto.ZippedAssetSupplyUpdate[],\n        ): ZippedAssetSupplyBatch[\"updates\"] =>\n            parseBatch(create(Proto.ZippedAssetSupplyBatchSchema, { updates: [...updates] }))\n                .updates;\n        const stream = snapshotThenStream({\n            realtime,\n            channel,\n            schema: Proto.ZippedAssetSupplyBatchSchema,\n            snapshotErrorLog: \"Failed to fetch zipped asset supply\",\n            snapshotRetry: { maxAttempts: 3, delayMs: 1_000 },\n            snapshotFailureMode: \"live\",\n            fetchSnapshot: () => this.getDepositWithdrawConfig(),\n            readPublication: (batch) => batch.updates,\n            bufferPublicationKey: (update) => update.zippedAssetId,\n            applySnapshot: (snapshot, bufferedUpdates) => {\n                gate.run(() => {\n                    const latestByZippedAssetId = new Map<number, string>();\n                    for (const asset of snapshot.assets) {\n                        for (const variant of asset.variants) {\n                            latestByZippedAssetId.set(variant.zippedAssetId, variant.supply);\n                        }\n                    }\n                    for (const update of parseUpdates(bufferedUpdates)) {\n                        latestByZippedAssetId.set(update.zippedAssetId, update.supply);\n                    }\n                    input.onEvent({\n                        updates: Array.from(latestByZippedAssetId, ([zippedAssetId, supply]) => ({\n                            zippedAssetId,\n                            supply,\n                        })),\n                    });\n                });\n            },\n            applyLivePublications: (updates) => {\n                gate.run(() => {\n                    input.onEvent({\n                        updates: parseUpdates(updates),\n                    });\n                });\n            },\n            onOpen: input.onOpen,\n            onClose: input.onClose,\n            onError: input.onError,\n        });\n\n        return () => stream.unsubscribe();\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;AA6BA,IAAa,gBAAb,MAA2B;CACvB;CACA;CACA;CAEA,YAAY,WAAsB,UAA8B,QAAoB;EAChF,KAAKA,UAAU,aAAaC,iBAAqB,SAAS;EAC1D,KAAKC,YAAY;EACjB,KAAKC,UAAU;CACnB;;;;CAKA,MAAM,yBACF,SAC8B;EAC9B,MAAM,MAAM,MAAM,KAAKH,QAAQ,yBAAyB,CAAC,GAAG,qBAAqB,OAAO,CAAC;EACzF,OAAO,MAAM,6BAA6B,GAAG;CACjD;;;;;CAMA,2BAA2B,OAAoD;EAC3E,MAAM,WAAW,KAAKE;EACtB,MAAM,SAAS,KAAKC;EACpB,IAAI,CAAC,YAAY,CAAC,QACd,MAAM,IAAI,mBACN,4FACJ;EAGJ,MAAM,UAAU;EAChB,MAAM,SAAS,mCAAmC,MAAM;EACxD,MAAM,WAAW,UAAuC,MAAM,UAAU,KAAK;EAC7E,MAAM,OAAO,sBACH,OAAO,MAAM,IAClB,UAAU,QAAQ,+BAA+B,SAAS,KAAK,CAAC,CACrE;EAEA,MAAM,cAAc,UAChB,MAAM,QAAQ,KAAK;EACvB,MAAM,gBACF,YAEA,WAAW,OAAOC,8BAAoC,EAAE,SAAS,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAC5E;EACT,MAAM,SAAS,mBAAmB;GAC9B;GACA;GACA,QAAQA;GACR,kBAAkB;GAClB,eAAe;IAAE,aAAa;IAAG,SAAS;GAAM;GAChD,qBAAqB;GACrB,qBAAqB,KAAK,yBAAyB;GACnD,kBAAkB,UAAU,MAAM;GAClC,uBAAuB,WAAW,OAAO;GACzC,gBAAgB,UAAU,oBAAoB;IAC1C,KAAK,UAAU;KACX,MAAM,wCAAwB,IAAI,IAAoB;KACtD,KAAK,MAAM,SAAS,SAAS,QACzB,KAAK,MAAM,WAAW,MAAM,UACxB,sBAAsB,IAAI,QAAQ,eAAe,QAAQ,MAAM;KAGvE,KAAK,MAAM,UAAU,aAAa,eAAe,GAC7C,sBAAsB,IAAI,OAAO,eAAe,OAAO,MAAM;KAEjE,MAAM,QAAQ,EACV,SAAS,MAAM,KAAK,wBAAwB,CAAC,eAAe,aAAa;MACrE;MACA;KACJ,EAAE,EACN,CAAC;IACL,CAAC;GACL;GACA,wBAAwB,YAAY;IAChC,KAAK,UAAU;KACX,MAAM,QAAQ,EACV,SAAS,aAAa,OAAO,EACjC,CAAC;IACL,CAAC;GACL;GACA,QAAQ,MAAM;GACd,SAAS,MAAM;GACf,SAAS,MAAM;EACnB,CAAC;EAED,aAAa,OAAO,YAAY;CACpC;AACJ"}
+{"version":3,"file":"zipper.js","names":["#client","Proto.ZipperService","#realtime","#scales","Proto.ZippedAssetSupplyBatchSchema"],"sources":["../../../src/services/zipper/zipper.ts"],"sourcesContent":["import { create } from \"@bufbuild/protobuf\";\nimport * as Proto from \"../../gen/chain/zipper/v1/zipper_pb.js\";\nimport type { PolyesterRealtime } from \"../../realtime/types.js\";\nimport { createClient, type Client, type Transport } from \"@connectrpc/connect\";\nimport {\n    DepositWithdrawConfigSchema,\n    createZippedAssetSupplyBatchSchema,\n    type DepositWithdrawConfig,\n    type ZippedAssetSupplyBatch,\n} from \"./zipper.schemas.js\";\nimport { parse } from \"../../shared/validation.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport type { BaseSubscribeInput } from \"../../shared/types.js\";\nimport type { SdkScales } from \"../../shared/decimal-surface.js\";\nimport { ConfigurationError } from \"../../shared/errors.js\";\nimport { snapshotThenStream } from \"../../realtime/snapshot-then-stream.js\";\n\nexport interface SubscribeZippedAssetSupplyInput extends BaseSubscribeInput<ZippedAssetSupplyBatch> {}\n\n/**\n * Reads public Zipper deposit/withdraw chain and asset configuration.\n */\nexport class ZipperService {\n    #client: Client<typeof Proto.ZipperService>;\n    #realtime: PolyesterRealtime | undefined;\n    #scales: SdkScales | undefined;\n\n    constructor(transport: Transport, realtime?: PolyesterRealtime, scales?: SdkScales) {\n        this.#client = createClient(Proto.ZipperService, transport);\n        this.#realtime = realtime;\n        this.#scales = scales;\n    }\n\n    /**\n     * Returns supported external chains, unified assets, chain-specific asset variants, network fees, min deposit/withdraw amounts, and contract metadata for Zipper-powered deposit and withdraw flows.\n     */\n    async getDepositWithdrawConfig(\n        options?: PolyesterRequestOptions,\n    ): Promise<DepositWithdrawConfig> {\n        const res = await this.#client.getDepositWithdrawConfig({}, toConnectCallOptions(options));\n        return parse(DepositWithdrawConfigSchema, res);\n    }\n\n    /**\n     * Attaches to the public supply stream before capturing a route-supply snapshot,\n     * then resnapshots whenever the channel establishes a new subscription epoch.\n     */\n    subscribeZippedAssetSupply(input: SubscribeZippedAssetSupplyInput): () => void {\n        const realtime = this.#realtime;\n        const scales = this.#scales;\n        if (!realtime || !scales) {\n            throw new ConfigurationError(\n                \"Zipper supply subscriptions require a client-owned realtime connection and catalog scales.\",\n            );\n        }\n\n        const channel = \"public:chain:zipped-asset:supply:proto\";\n        const schema = createZippedAssetSupplyBatchSchema(scales);\n        let catalogReady = false;\n        const parseBatch = (batch: Proto.ZippedAssetSupplyBatch): ZippedAssetSupplyBatch =>\n            parse(schema, batch);\n        const parseUpdates = (\n            updates: readonly Proto.ZippedAssetSupplyUpdate[],\n        ): ZippedAssetSupplyBatch[\"updates\"] =>\n            parseBatch(create(Proto.ZippedAssetSupplyBatchSchema, { updates: [...updates] }))\n                .updates;\n        const stream = snapshotThenStream({\n            realtime,\n            channel,\n            schema: Proto.ZippedAssetSupplyBatchSchema,\n            snapshotErrorLog: \"Failed to fetch zipped asset supply\",\n            snapshotRetry: { maxAttempts: 3, delayMs: 1_000 },\n            snapshotFailureMode: () => (catalogReady ? \"live\" : \"wait\"),\n            fetchSnapshot: async () => {\n                await scales.ready();\n                catalogReady = true;\n                return this.getDepositWithdrawConfig();\n            },\n            readPublication: (batch) => batch.updates,\n            bufferPublicationKey: (update) => update.zippedAssetId,\n            applySnapshot: (snapshot, bufferedUpdates) => {\n                const latestByZippedAssetId = new Map<number, string>();\n                for (const asset of snapshot.assets) {\n                    for (const variant of asset.variants) {\n                        latestByZippedAssetId.set(variant.zippedAssetId, variant.supply);\n                    }\n                }\n                for (const update of parseUpdates(bufferedUpdates)) {\n                    latestByZippedAssetId.set(update.zippedAssetId, update.supply);\n                }\n                input.onEvent({\n                    updates: Array.from(latestByZippedAssetId, ([zippedAssetId, supply]) => ({\n                        zippedAssetId,\n                        supply,\n                    })),\n                });\n            },\n            applyLivePublications: (updates) => {\n                input.onEvent({\n                    updates: parseUpdates(updates),\n                });\n            },\n            onOpen: input.onOpen,\n            onClose: input.onClose,\n            onError: input.onError,\n        });\n\n        return () => stream.unsubscribe();\n    }\n}\n"],"mappings":";;;;;;;;;;;;AAyBA,IAAa,gBAAb,MAA2B;CACvB;CACA;CACA;CAEA,YAAY,WAAsB,UAA8B,QAAoB;EAChF,KAAKA,UAAU,aAAaC,iBAAqB,SAAS;EAC1D,KAAKC,YAAY;EACjB,KAAKC,UAAU;CACnB;;;;CAKA,MAAM,yBACF,SAC8B;EAC9B,MAAM,MAAM,MAAM,KAAKH,QAAQ,yBAAyB,CAAC,GAAG,qBAAqB,OAAO,CAAC;EACzF,OAAO,MAAM,6BAA6B,GAAG;CACjD;;;;;CAMA,2BAA2B,OAAoD;EAC3E,MAAM,WAAW,KAAKE;EACtB,MAAM,SAAS,KAAKC;EACpB,IAAI,CAAC,YAAY,CAAC,QACd,MAAM,IAAI,mBACN,4FACJ;EAGJ,MAAM,UAAU;EAChB,MAAM,SAAS,mCAAmC,MAAM;EACxD,IAAI,eAAe;EACnB,MAAM,cAAc,UAChB,MAAM,QAAQ,KAAK;EACvB,MAAM,gBACF,YAEA,WAAW,OAAOC,8BAAoC,EAAE,SAAS,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAC5E;EACT,MAAM,SAAS,mBAAmB;GAC9B;GACA;GACA,QAAQA;GACR,kBAAkB;GAClB,eAAe;IAAE,aAAa;IAAG,SAAS;GAAM;GAChD,2BAA4B,eAAe,SAAS;GACpD,eAAe,YAAY;IACvB,MAAM,OAAO,MAAM;IACnB,eAAe;IACf,OAAO,KAAK,yBAAyB;GACzC;GACA,kBAAkB,UAAU,MAAM;GAClC,uBAAuB,WAAW,OAAO;GACzC,gBAAgB,UAAU,oBAAoB;IAC1C,MAAM,wCAAwB,IAAI,IAAoB;IACtD,KAAK,MAAM,SAAS,SAAS,QACzB,KAAK,MAAM,WAAW,MAAM,UACxB,sBAAsB,IAAI,QAAQ,eAAe,QAAQ,MAAM;IAGvE,KAAK,MAAM,UAAU,aAAa,eAAe,GAC7C,sBAAsB,IAAI,OAAO,eAAe,OAAO,MAAM;IAEjE,MAAM,QAAQ,EACV,SAAS,MAAM,KAAK,wBAAwB,CAAC,eAAe,aAAa;KACrE;KACA;IACJ,EAAE,EACN,CAAC;GACL;GACA,wBAAwB,YAAY;IAChC,MAAM,QAAQ,EACV,SAAS,aAAa,OAAO,EACjC,CAAC;GACL;GACA,QAAQ,MAAM;GACd,SAAS,MAAM;GACf,SAAS,MAAM;EACnB,CAAC;EAED,aAAa,OAAO,YAAY;CACpC;AACJ"}

package/dist/shared/connect-error-mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connect-error-mapping.d.ts","names":[],"sources":["../../src/shared/connect-error-mapping.ts"],"mappings":";;;;;;;iBAkHgB,6BAA6B,IAAI,eAAe;;;;;;iBAyIhD,iBAAiB;;;;;;iBAyBjB,iCAAiC"}
+{"version":3,"file":"connect-error-mapping.d.ts","names":[],"sources":["../../src/shared/connect-error-mapping.ts"],"mappings":";;;;;;;iBA8HgB,6BAA6B,IAAI,eAAe;;;;;;iBAyIhD,iBAAiB;;;;;;iBAyBjB,iCAAiC"}

package/dist/shared/connect-error-mapping.js

@@ -29,6 +29,10 @@ function safeRetryAfterMs(rateLimit) {
 	const value = BigInt(rateLimit.retryAfterMs);
 	return value <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(value) : void 0;
 }
+const HTTP_WEEKDAY = "(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)";
+const HTTP_WEEKDAY_LONG = "(?:Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday)";
+const HTTP_MONTH = "(?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)";
+const HTTP_DATE_RE = new RegExp(`^(?:${HTTP_WEEKDAY}, \\d{2} ${HTTP_MONTH} \\d{4} \\d{2}:\\d{2}:\\d{2} GMT|${HTTP_WEEKDAY_LONG}, \\d{2}-${HTTP_MONTH}-\\d{2} \\d{2}:\\d{2}:\\d{2} GMT|${HTTP_WEEKDAY} ${HTTP_MONTH} {1,2}\\d{1,2} \\d{2}:\\d{2}:\\d{2} \\d{4})$`, "u");
 /**
 * Returns the error message without the leading "[code] " prefix that
 * `ConnectError` prepends, e.g. "[invalid_argument] Insufficient funds."
@@ -51,8 +55,11 @@ function detectMfaErrorKind(err) {
 function parseRetryAfterMs(ce) {
 	const value = ce.metadata.get("retry-after");
 	if (!value) return void 0;
-	const seconds = Number(value);
-	if (Number.isFinite(seconds)) return Math.max(0, Math.round(seconds * 1e3));
+	if (/^\d+$/u.test(value)) {
+		const seconds = BigInt(value);
+		return seconds <= BigInt(Math.floor(Number.MAX_SAFE_INTEGER / 1e3)) ? Number(seconds) * 1e3 : void 0;
+	}
+	if (!HTTP_DATE_RE.test(value)) return void 0;
 	const date = Date.parse(value);
 	if (!Number.isNaN(date)) return Math.max(0, date - Date.now());
 }

package/dist/shared/connect-error-mapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect-error-mapping.js","names":["OrderErrorDetailSchema"],"sources":["../../src/shared/connect-error-mapping.ts"],"sourcesContent":["import { Code, ConnectError, type Interceptor, type Transport } from \"@connectrpc/connect\";\nimport * as v from \"valibot\";\nimport { AuthErrorCode, AuthErrorDetailSchema } from \"../gen/auth/v1/auth_pb.js\";\nimport {\n    ErrorCode as OrderErrorCode,\n    ErrorDetailSchema as OrderErrorDetailSchema,\n} from \"../gen/orders/v1/orders_pb.js\";\nimport {\n    AlreadyExistsError,\n    AuthenticationError,\n    InternalServerError,\n    isAbortError,\n    MfaEnrollmentRequiredError,\n    MfaLastFactorRequiredError,\n    MfaVerificationError,\n    type MfaVerificationFailureReason,\n    normalizeErrorMessage,\n    PermissionError,\n    PolicyInUseError,\n    PolicyLockedError,\n    PolicyScopeMismatchError,\n    PolyesterError,\n    type PolyesterErrorOptions,\n    PreconditionFailedError,\n    RateLimitError,\n    ResourceNotFoundError,\n    RevisionConflictError,\n    ServiceUnavailableError,\n    SessionElevationRequiredError,\n    StaleQuoteError,\n    StepUpRequiredError,\n    TimeoutError,\n    TransientError,\n    ValidationError,\n} from \"./errors.js\";\nimport { RateLimitDetailSchema, type RateLimitDetail } from \"./rate-limit.schemas.js\";\n\nfunction getAuthErrorDetails(err: unknown) {\n    return ConnectError.from(err).findDetails(AuthErrorDetailSchema);\n}\n\nfunction hasAuthErrorCode(err: unknown, code: AuthErrorCode): boolean {\n    return getAuthErrorDetails(err).some((detail) => detail.code === code);\n}\n\nfunction hasOrderErrorCode(err: unknown, code: OrderErrorCode): boolean {\n    return getOrderErrorDetails(err).some((detail) => detail.code === code);\n}\n\nfunction getOrderErrorDetails(err: unknown) {\n    return ConnectError.from(err).findDetails(OrderErrorDetailSchema);\n}\n\nfunction getRateLimitDetail(err: unknown): RateLimitDetail | undefined {\n    for (const orderDetail of getOrderErrorDetails(err)) {\n        if (!orderDetail.rateLimit) continue;\n        const result = v.safeParse(RateLimitDetailSchema, orderDetail.rateLimit);\n        if (result.success) return result.output;\n    }\n    return undefined;\n}\n\nfunction safeRetryAfterMs(rateLimit: RateLimitDetail | undefined): number | undefined {\n    if (rateLimit?.retryAfterMs === undefined) return undefined;\n    const value = BigInt(rateLimit.retryAfterMs);\n    return value <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(value) : undefined;\n}\n\n/**\n * Returns the error message without the leading \"[code] \" prefix that\n * `ConnectError` prepends, e.g. \"[invalid_argument] Insufficient funds.\"\n * becomes \"Insufficient funds.\".\n */\nexport function getNormalizedConnectMessage(err: unknown): string {\n    const ce = ConnectError.from(err);\n    const raw = ce.message ?? \"\";\n    return normalizeErrorMessage(raw);\n}\n\nexport type MfaErrorKind = \"session-elevation\" | \"enrollment\" | \"step-up\";\n\n/**\n * Classifies an error as one of the MFA flows the backend can demand.\n * Classification is based only on stable structured auth error details.\n */\nexport function detectMfaErrorKind(err: unknown): MfaErrorKind | null {\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_ELEVATION_REQUIRED)) {\n        return \"session-elevation\";\n    }\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_STEP_UP_REQUIRED)) return \"step-up\";\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_NOT_ENROLLED)) return \"enrollment\";\n    return null;\n}\n\nfunction parseRetryAfterMs(ce: ConnectError): number | undefined {\n    const value = ce.metadata.get(\"retry-after\");\n    if (!value) return undefined;\n    const seconds = Number(value);\n    if (Number.isFinite(seconds)) return Math.max(0, Math.round(seconds * 1000));\n    const date = Date.parse(value);\n    if (!Number.isNaN(date)) return Math.max(0, date - Date.now());\n    return undefined;\n}\n\nconst MFA_ERROR_CLASSES = {\n    \"session-elevation\": SessionElevationRequiredError,\n    enrollment: MfaEnrollmentRequiredError,\n    \"step-up\": StepUpRequiredError,\n} as const;\n\n/**\n * Maps a `ConnectError` from the Polyester backend onto the typed\n * {@link PolyesterError} tree. The original error is preserved as `cause`.\n */\nexport function connectErrorToPolyesterError(ce: ConnectError): PolyesterError {\n    const message = getNormalizedConnectMessage(ce);\n    const options: PolyesterErrorOptions = { cause: ce };\n    const withFallback = (fallback: string) => message || fallback;\n\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_RESOURCE_NOT_FOUND)) {\n        return new ResourceNotFoundError(withFallback(\"Resource not found.\"), options);\n    }\n\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_REVISION_CONFLICT)) {\n        return new RevisionConflictError(\n            withFallback(\"Resource changed since it was last read.\"),\n            options,\n        );\n    }\n\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_POLICY_IN_USE)) {\n        return new PolicyInUseError(withFallback(\"Policy is still in use.\"), options);\n    }\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_POLICY_LOCKED)) {\n        return new PolicyLockedError(withFallback(\"Policy is locked.\"), options);\n    }\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_POLICY_SCOPE_MISMATCH)) {\n        return new PolicyScopeMismatchError(\n            withFallback(\"Policy does not belong to the target account scope.\"),\n            options,\n        );\n    }\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_MFA_LAST_FACTOR_REQUIRED)) {\n        return new MfaLastFactorRequiredError(\n            withFallback(\"At least one active MFA factor must remain enrolled.\"),\n            options,\n        );\n    }\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_INTERNAL_ERROR)) {\n        return new InternalServerError(withFallback(\"Internal server error.\"), options);\n    }\n\n    const mfaVerificationReason = getMfaVerificationFailureReason(ce);\n    if (mfaVerificationReason) {\n        return new MfaVerificationError(\n            withFallback(\"MFA verification failed.\"),\n            mfaVerificationReason,\n            options,\n        );\n    }\n\n    const mfaKind = detectMfaErrorKind(ce);\n    if (mfaKind) {\n        return new MFA_ERROR_CLASSES[mfaKind](\n            withFallback(\"Multi-factor authentication required.\"),\n            options,\n        );\n    }\n\n    if (hasOrderErrorCode(ce, OrderErrorCode.STALE_QUOTE)) {\n        return new StaleQuoteError(withFallback(\"The submitted market quote is stale.\"), options);\n    }\n\n    const rateLimit = getRateLimitDetail(ce);\n    if (rateLimit || hasOrderErrorCode(ce, OrderErrorCode.RATE_LIMIT_EXCEEDED)) {\n        return new RateLimitError(withFallback(\"Rate limit exceeded.\"), {\n            ...options,\n            rateLimit,\n            retryAfterMs: safeRetryAfterMs(rateLimit) ?? parseRetryAfterMs(ce),\n        });\n    }\n\n    switch (ce.code) {\n        case Code.InvalidArgument:\n        case Code.OutOfRange:\n            return new ValidationError(withFallback(\"Invalid request.\"), options);\n        case Code.NotFound:\n            return new ResourceNotFoundError(withFallback(\"Resource not found.\"), options);\n        case Code.AlreadyExists:\n            return new AlreadyExistsError(withFallback(\"Resource already exists.\"), options);\n        case Code.PermissionDenied:\n            return new PermissionError(withFallback(\"Permission denied.\"), options);\n        case Code.Unauthenticated:\n            return new AuthenticationError(withFallback(\"Authentication required.\"), options);\n        case Code.FailedPrecondition:\n            return new PreconditionFailedError(withFallback(\"Precondition failed.\"), options);\n        case Code.ResourceExhausted:\n            return new RateLimitError(withFallback(\"Rate limit exceeded.\"), {\n                ...options,\n                retryAfterMs: parseRetryAfterMs(ce),\n            });\n        case Code.DeadlineExceeded:\n            return new TimeoutError(withFallback(\"Request timed out.\"), options);\n        case Code.Unavailable:\n            return new ServiceUnavailableError(withFallback(\"Service unavailable.\"), options);\n        case Code.Aborted:\n            return new TransientError(withFallback(\"Operation aborted by the backend.\"), options);\n        default:\n            // Gateways sometimes surface outages as Unknown with this stock phrase.\n            if (/service temporarily unavailable/i.test(message)) {\n                return new ServiceUnavailableError(withFallback(\"Service unavailable.\"), options);\n            }\n            return new InternalServerError(withFallback(\"Internal server error.\"), options);\n    }\n}\n\nfunction getMfaVerificationFailureReason(err: unknown): MfaVerificationFailureReason | null {\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_CHALLENGE_INVALID)) {\n        return \"challenge-invalid\";\n    }\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_CHALLENGE_LOCKED)) {\n        return \"challenge-locked\";\n    }\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_OTP_INVALID)) return \"otp-invalid\";\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_RECOVERY_INVALID)) {\n        return \"recovery-code-invalid\";\n    }\n    if (\n        hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_PASSKEY_CREDENTIAL_INVALID) ||\n        hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_PASSKEY_VERIFY_FAILED)\n    ) {\n        return \"passkey-invalid\";\n    }\n\n    return null;\n}\n\nfunction findPolyesterErrorInCauseChain(err: unknown): PolyesterError | null {\n    let current: unknown = err;\n    for (let depth = 0; depth < 5 && current instanceof Error; depth++) {\n        current = current.cause;\n        if (current instanceof PolyesterError) return current;\n    }\n    return null;\n}\n\n/**\n * Converts any RPC-layer failure into its typed SDK error. Abort errors and\n * caller-cancelled requests pass through unchanged, as do errors that are\n * already typed (e.g. a `NetworkError` from the SDK fetch wrapper).\n */\nexport function toPolyesterError(err: unknown): unknown {\n    if (err instanceof PolyesterError) return err;\n    if (isAbortError(err)) return err;\n    if (err instanceof ConnectError) {\n        if (err.code === Code.Canceled) return err;\n        const wrapped = findPolyesterErrorInCauseChain(err);\n        if (wrapped) return wrapped;\n        return connectErrorToPolyesterError(err);\n    }\n    return err;\n}\n\nasync function* mapStreamErrors<T>(source: AsyncIterable<T>): AsyncIterable<T> {\n    try {\n        yield* source;\n    } catch (err) {\n        throw toPolyesterError(err);\n    }\n}\n\n/**\n * Interceptor that converts every RPC failure (unary and streaming) into the\n * typed {@link PolyesterError} hierarchy. Installed outermost by\n * `createTransports`, so callers of SDK services always see typed errors.\n */\nexport function createErrorMappingInterceptor(): Interceptor {\n    return (next) => async (req) => {\n        try {\n            const res = await next(req);\n            if (res.stream) {\n                return { ...res, message: mapStreamErrors(res.message) };\n            }\n            return res;\n        } catch (err) {\n            throw toPolyesterError(err);\n        }\n    };\n}\n\n/**\n * Wraps a Connect transport so errors are translated after Connect's call\n * runner has applied its own error normalization.\n */\nexport function createErrorMappingTransport(transport: Transport): Transport {\n    return {\n        async unary(method, signal, timeoutMs, header, input, contextValues) {\n            try {\n                return await transport.unary(\n                    method,\n                    signal,\n                    timeoutMs,\n                    header,\n                    input,\n                    contextValues,\n                );\n            } catch (error) {\n                throw toPolyesterError(error);\n            }\n        },\n        async stream(method, signal, timeoutMs, header, input, contextValues) {\n            try {\n                const response = await transport.stream(\n                    method,\n                    signal,\n                    timeoutMs,\n                    header,\n                    input,\n                    contextValues,\n                );\n                return { ...response, message: mapStreamErrors(response.message) };\n            } catch (error) {\n                throw toPolyesterError(error);\n            }\n        },\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"connect-error-mapping.js","names":["OrderErrorDetailSchema"],"sources":["../../src/shared/connect-error-mapping.ts"],"sourcesContent":["import { Code, ConnectError, type Interceptor, type Transport } from \"@connectrpc/connect\";\nimport * as v from \"valibot\";\nimport { AuthErrorCode, AuthErrorDetailSchema } from \"../gen/auth/v1/auth_pb.js\";\nimport {\n    ErrorCode as OrderErrorCode,\n    ErrorDetailSchema as OrderErrorDetailSchema,\n} from \"../gen/orders/v1/orders_pb.js\";\nimport {\n    AlreadyExistsError,\n    AuthenticationError,\n    InternalServerError,\n    isAbortError,\n    MfaEnrollmentRequiredError,\n    MfaLastFactorRequiredError,\n    MfaVerificationError,\n    type MfaVerificationFailureReason,\n    normalizeErrorMessage,\n    PermissionError,\n    PolicyInUseError,\n    PolicyLockedError,\n    PolicyScopeMismatchError,\n    PolyesterError,\n    type PolyesterErrorOptions,\n    PreconditionFailedError,\n    RateLimitError,\n    ResourceNotFoundError,\n    RevisionConflictError,\n    ServiceUnavailableError,\n    SessionElevationRequiredError,\n    StaleQuoteError,\n    StepUpRequiredError,\n    TimeoutError,\n    TransientError,\n    ValidationError,\n} from \"./errors.js\";\nimport { RateLimitDetailSchema, type RateLimitDetail } from \"./rate-limit.schemas.js\";\n\nfunction getAuthErrorDetails(err: unknown) {\n    return ConnectError.from(err).findDetails(AuthErrorDetailSchema);\n}\n\nfunction hasAuthErrorCode(err: unknown, code: AuthErrorCode): boolean {\n    return getAuthErrorDetails(err).some((detail) => detail.code === code);\n}\n\nfunction hasOrderErrorCode(err: unknown, code: OrderErrorCode): boolean {\n    return getOrderErrorDetails(err).some((detail) => detail.code === code);\n}\n\nfunction getOrderErrorDetails(err: unknown) {\n    return ConnectError.from(err).findDetails(OrderErrorDetailSchema);\n}\n\nfunction getRateLimitDetail(err: unknown): RateLimitDetail | undefined {\n    for (const orderDetail of getOrderErrorDetails(err)) {\n        if (!orderDetail.rateLimit) continue;\n        const result = v.safeParse(RateLimitDetailSchema, orderDetail.rateLimit);\n        if (result.success) return result.output;\n    }\n    return undefined;\n}\n\nfunction safeRetryAfterMs(rateLimit: RateLimitDetail | undefined): number | undefined {\n    if (rateLimit?.retryAfterMs === undefined) return undefined;\n    const value = BigInt(rateLimit.retryAfterMs);\n    return value <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(value) : undefined;\n}\n\nconst HTTP_WEEKDAY = \"(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)\";\nconst HTTP_WEEKDAY_LONG = \"(?:Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday)\";\nconst HTTP_MONTH = \"(?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\";\nconst HTTP_DATE_RE = new RegExp(\n    `^(?:${HTTP_WEEKDAY}, \\\\d{2} ${HTTP_MONTH} \\\\d{4} \\\\d{2}:\\\\d{2}:\\\\d{2} GMT|${HTTP_WEEKDAY_LONG}, \\\\d{2}-${HTTP_MONTH}-\\\\d{2} \\\\d{2}:\\\\d{2}:\\\\d{2} GMT|${HTTP_WEEKDAY} ${HTTP_MONTH} {1,2}\\\\d{1,2} \\\\d{2}:\\\\d{2}:\\\\d{2} \\\\d{4})$`,\n    \"u\",\n);\n\n/**\n * Returns the error message without the leading \"[code] \" prefix that\n * `ConnectError` prepends, e.g. \"[invalid_argument] Insufficient funds.\"\n * becomes \"Insufficient funds.\".\n */\nexport function getNormalizedConnectMessage(err: unknown): string {\n    const ce = ConnectError.from(err);\n    const raw = ce.message ?? \"\";\n    return normalizeErrorMessage(raw);\n}\n\nexport type MfaErrorKind = \"session-elevation\" | \"enrollment\" | \"step-up\";\n\n/**\n * Classifies an error as one of the MFA flows the backend can demand.\n * Classification is based only on stable structured auth error details.\n */\nexport function detectMfaErrorKind(err: unknown): MfaErrorKind | null {\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_ELEVATION_REQUIRED)) {\n        return \"session-elevation\";\n    }\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_STEP_UP_REQUIRED)) return \"step-up\";\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_NOT_ENROLLED)) return \"enrollment\";\n    return null;\n}\n\nfunction parseRetryAfterMs(ce: ConnectError): number | undefined {\n    const value = ce.metadata.get(\"retry-after\");\n    if (!value) return undefined;\n    if (/^\\d+$/u.test(value)) {\n        const seconds = BigInt(value);\n        const maxSafeSeconds = BigInt(Math.floor(Number.MAX_SAFE_INTEGER / 1000));\n        return seconds <= maxSafeSeconds ? Number(seconds) * 1000 : undefined;\n    }\n    if (!HTTP_DATE_RE.test(value)) return undefined;\n    const date = Date.parse(value);\n    if (!Number.isNaN(date)) return Math.max(0, date - Date.now());\n    return undefined;\n}\n\nconst MFA_ERROR_CLASSES = {\n    \"session-elevation\": SessionElevationRequiredError,\n    enrollment: MfaEnrollmentRequiredError,\n    \"step-up\": StepUpRequiredError,\n} as const;\n\n/**\n * Maps a `ConnectError` from the Polyester backend onto the typed\n * {@link PolyesterError} tree. The original error is preserved as `cause`.\n */\nexport function connectErrorToPolyesterError(ce: ConnectError): PolyesterError {\n    const message = getNormalizedConnectMessage(ce);\n    const options: PolyesterErrorOptions = { cause: ce };\n    const withFallback = (fallback: string) => message || fallback;\n\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_RESOURCE_NOT_FOUND)) {\n        return new ResourceNotFoundError(withFallback(\"Resource not found.\"), options);\n    }\n\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_REVISION_CONFLICT)) {\n        return new RevisionConflictError(\n            withFallback(\"Resource changed since it was last read.\"),\n            options,\n        );\n    }\n\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_POLICY_IN_USE)) {\n        return new PolicyInUseError(withFallback(\"Policy is still in use.\"), options);\n    }\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_POLICY_LOCKED)) {\n        return new PolicyLockedError(withFallback(\"Policy is locked.\"), options);\n    }\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_POLICY_SCOPE_MISMATCH)) {\n        return new PolicyScopeMismatchError(\n            withFallback(\"Policy does not belong to the target account scope.\"),\n            options,\n        );\n    }\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_MFA_LAST_FACTOR_REQUIRED)) {\n        return new MfaLastFactorRequiredError(\n            withFallback(\"At least one active MFA factor must remain enrolled.\"),\n            options,\n        );\n    }\n    if (hasAuthErrorCode(ce, AuthErrorCode.AUTH_INTERNAL_ERROR)) {\n        return new InternalServerError(withFallback(\"Internal server error.\"), options);\n    }\n\n    const mfaVerificationReason = getMfaVerificationFailureReason(ce);\n    if (mfaVerificationReason) {\n        return new MfaVerificationError(\n            withFallback(\"MFA verification failed.\"),\n            mfaVerificationReason,\n            options,\n        );\n    }\n\n    const mfaKind = detectMfaErrorKind(ce);\n    if (mfaKind) {\n        return new MFA_ERROR_CLASSES[mfaKind](\n            withFallback(\"Multi-factor authentication required.\"),\n            options,\n        );\n    }\n\n    if (hasOrderErrorCode(ce, OrderErrorCode.STALE_QUOTE)) {\n        return new StaleQuoteError(withFallback(\"The submitted market quote is stale.\"), options);\n    }\n\n    const rateLimit = getRateLimitDetail(ce);\n    if (rateLimit || hasOrderErrorCode(ce, OrderErrorCode.RATE_LIMIT_EXCEEDED)) {\n        return new RateLimitError(withFallback(\"Rate limit exceeded.\"), {\n            ...options,\n            rateLimit,\n            retryAfterMs: safeRetryAfterMs(rateLimit) ?? parseRetryAfterMs(ce),\n        });\n    }\n\n    switch (ce.code) {\n        case Code.InvalidArgument:\n        case Code.OutOfRange:\n            return new ValidationError(withFallback(\"Invalid request.\"), options);\n        case Code.NotFound:\n            return new ResourceNotFoundError(withFallback(\"Resource not found.\"), options);\n        case Code.AlreadyExists:\n            return new AlreadyExistsError(withFallback(\"Resource already exists.\"), options);\n        case Code.PermissionDenied:\n            return new PermissionError(withFallback(\"Permission denied.\"), options);\n        case Code.Unauthenticated:\n            return new AuthenticationError(withFallback(\"Authentication required.\"), options);\n        case Code.FailedPrecondition:\n            return new PreconditionFailedError(withFallback(\"Precondition failed.\"), options);\n        case Code.ResourceExhausted:\n            return new RateLimitError(withFallback(\"Rate limit exceeded.\"), {\n                ...options,\n                retryAfterMs: parseRetryAfterMs(ce),\n            });\n        case Code.DeadlineExceeded:\n            return new TimeoutError(withFallback(\"Request timed out.\"), options);\n        case Code.Unavailable:\n            return new ServiceUnavailableError(withFallback(\"Service unavailable.\"), options);\n        case Code.Aborted:\n            return new TransientError(withFallback(\"Operation aborted by the backend.\"), options);\n        default:\n            // Gateways sometimes surface outages as Unknown with this stock phrase.\n            if (/service temporarily unavailable/i.test(message)) {\n                return new ServiceUnavailableError(withFallback(\"Service unavailable.\"), options);\n            }\n            return new InternalServerError(withFallback(\"Internal server error.\"), options);\n    }\n}\n\nfunction getMfaVerificationFailureReason(err: unknown): MfaVerificationFailureReason | null {\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_CHALLENGE_INVALID)) {\n        return \"challenge-invalid\";\n    }\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_CHALLENGE_LOCKED)) {\n        return \"challenge-locked\";\n    }\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_OTP_INVALID)) return \"otp-invalid\";\n    if (hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_RECOVERY_INVALID)) {\n        return \"recovery-code-invalid\";\n    }\n    if (\n        hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_PASSKEY_CREDENTIAL_INVALID) ||\n        hasAuthErrorCode(err, AuthErrorCode.AUTH_MFA_PASSKEY_VERIFY_FAILED)\n    ) {\n        return \"passkey-invalid\";\n    }\n\n    return null;\n}\n\nfunction findPolyesterErrorInCauseChain(err: unknown): PolyesterError | null {\n    let current: unknown = err;\n    for (let depth = 0; depth < 5 && current instanceof Error; depth++) {\n        current = current.cause;\n        if (current instanceof PolyesterError) return current;\n    }\n    return null;\n}\n\n/**\n * Converts any RPC-layer failure into its typed SDK error. Abort errors and\n * caller-cancelled requests pass through unchanged, as do errors that are\n * already typed (e.g. a `NetworkError` from the SDK fetch wrapper).\n */\nexport function toPolyesterError(err: unknown): unknown {\n    if (err instanceof PolyesterError) return err;\n    if (isAbortError(err)) return err;\n    if (err instanceof ConnectError) {\n        if (err.code === Code.Canceled) return err;\n        const wrapped = findPolyesterErrorInCauseChain(err);\n        if (wrapped) return wrapped;\n        return connectErrorToPolyesterError(err);\n    }\n    return err;\n}\n\nasync function* mapStreamErrors<T>(source: AsyncIterable<T>): AsyncIterable<T> {\n    try {\n        yield* source;\n    } catch (err) {\n        throw toPolyesterError(err);\n    }\n}\n\n/**\n * Interceptor that converts every RPC failure (unary and streaming) into the\n * typed {@link PolyesterError} hierarchy. Installed outermost by\n * `createTransports`, so callers of SDK services always see typed errors.\n */\nexport function createErrorMappingInterceptor(): Interceptor {\n    return (next) => async (req) => {\n        try {\n            const res = await next(req);\n            if (res.stream) {\n                return { ...res, message: mapStreamErrors(res.message) };\n            }\n            return res;\n        } catch (err) {\n            throw toPolyesterError(err);\n        }\n    };\n}\n\n/**\n * Wraps a Connect transport so errors are translated after Connect's call\n * runner has applied its own error normalization.\n */\nexport function createErrorMappingTransport(transport: Transport): Transport {\n    return {\n        async unary(method, signal, timeoutMs, header, input, contextValues) {\n            try {\n                return await transport.unary(\n                    method,\n                    signal,\n                    timeoutMs,\n                    header,\n                    input,\n                    contextValues,\n                );\n            } catch (error) {\n                throw toPolyesterError(error);\n            }\n        },\n        async stream(method, signal, timeoutMs, header, input, contextValues) {\n            try {\n                const response = await transport.stream(\n                    method,\n                    signal,\n                    timeoutMs,\n                    header,\n                    input,\n                    contextValues,\n                );\n                return { ...response, message: mapStreamErrors(response.message) };\n            } catch (error) {\n                throw toPolyesterError(error);\n            }\n        },\n    };\n}\n"],"mappings":"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"}

package/dist/shared/decimal-surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decimal-surface.d.ts","names":[],"sources":["../../src/shared/decimal-surface.ts"],"mappings":";;;;;;;UA+BiB;EACb,SAAS;EACT;EACA,QAAQ,MAAM;EACd,YAAY,MAAM;EAClB,aAAa;EACb,kBAAkB"}
+{"version":3,"file":"decimal-surface.d.ts","names":[],"sources":["../../src/shared/decimal-surface.ts"],"mappings":";;;;;;;UAiCiB;EACb,SAAS;EACT;EACA,QAAQ,MAAM;EACd,YAAY,MAAM;EAClB,aAAa;EACb,kBAAkB"}

package/dist/shared/decimal-surface.js

@@ -1,6 +1,6 @@
 import "./wire-bounds.js";
 import { scaledToDecimal, tryDecimalToScaled } from "../catalogs/decimal.js";
-import { CatalogConversionError } from "../catalogs/types.js";
+import { CatalogConversionError, CatalogLookupError, CatalogNotReadyError } from "../catalogs/types.js";
 /**
 * Catalog-backed scale resolver. Takes a getter so it can be constructed
 * before the owning client has assigned its catalog.
@@ -13,7 +13,11 @@ function createCatalogSdkScales(getCatalog) {
 		price: () => 6,
 		baseQty: (pair) => requirePair(getCatalog(), pair).baseAsset.quantityScale,
 		quoteAmount: (pair) => requirePair(getCatalog(), pair).quoteAsset.quantityScale,
-		ledgerAmount: (ledgerAssetId) => getCatalog().ledger.requireAssetByLedgerId(ledgerAssetId).quantityScale,
+		ledgerAmount: (ledgerAssetId) => {
+			const ledger = getCatalog().ledger;
+			if (!ledger.isKnownAssetId(ledgerAssetId)) throw new CatalogLookupError("ledger", "ledgerId", ledgerAssetId);
+			return ledger.requireAssetByLedgerId(ledgerAssetId).quantityScale;
+		},
 		zippedAssetAmount: (zippedAssetId) => getCatalog().zipper.requireAssetChainByZippedAssetId(zippedAssetId).asset.quantityScale
 	};
 }
@@ -61,36 +65,55 @@ function quantityInputToE18(params) {
 	if (assetScale > 18) throw new CatalogConversionError(field, `${field} asset quantityScale ${assetScale} exceeds E18 ledger scale`);
 	return unboundedPositiveDecimalInputToScaled(field, params.quantity, assetScale) * 10n ** BigInt(18 - assetScale);
 }
+const READY_GATE_MAX_PENDING_DELIVERIES = 1024;
 /**
-* Orders event delivery behind catalog readiness. Events arriving before the
+* Transition event delivery behind catalog readiness. Events arriving before the
 * catalog can resolve scales are queued and flushed in arrival order once it
-* is ready; delivery errors (including post-flush ones) route to `onError`
-* instead of escaping into the transport, mirroring the realtime client's
-* consumer-handler isolation. If readiness itself fails, queued events are
-* dropped after `onError` fires — the stream cannot be decoded without scales.
+* is ready. Delivery errors are isolated from the transport. Readiness failure
+* or queue overflow is terminal because dropping an event would break stream
+* continuity; the owning subscription must visibly terminate when notified.
 */
-function createReadyGate(ready, onError) {
+function createReadyGate(ready, handlers) {
 	let state = "pending";
 	const queue = [];
 	const deliverIsolated = (deliver) => {
 		try {
 			deliver();
 		} catch (error) {
-			onError?.(error);
+			handlers.onDeliveryError?.(error);
 		}
 	};
-	ready().then(() => {
+	const closeWithError = (error) => {
+		if (state === "closed") return;
+		state = "closed";
+		queue.length = 0;
+		handlers.onTerminalError(error);
+	};
+	Promise.resolve().then(ready).then(() => {
+		if (state !== "pending") return;
 		state = "open";
 		for (const deliver of queue.splice(0)) deliverIsolated(deliver);
 	}, (error) => {
-		state = "failed";
-		queue.length = 0;
-		onError?.(error);
+		if (state !== "pending") return;
+		closeWithError(error);
 	});
-	return { run(deliver) {
-		if (state === "open") deliverIsolated(deliver);
-		else if (state === "pending") queue.push(deliver);
-	} };
+	return {
+		run(deliver) {
+			if (state === "open") deliverIsolated(deliver);
+			else if (state === "pending") {
+				if (queue.length === READY_GATE_MAX_PENDING_DELIVERIES) {
+					closeWithError(new CatalogNotReadyError());
+					return;
+				}
+				queue.push(deliver);
+			}
+		},
+		close() {
+			if (state === "closed") return;
+			state = "closed";
+			queue.length = 0;
+		}
+	};
 }
 //#endregion
 export { createCatalogSdkScales, createReadyGate, decimalInputToScaled, positiveDecimalInputToScaled, quantityInputToE18, scaledToDecimalOutput };

package/dist/shared/decimal-surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"decimal-surface.js","names":[],"sources":["../../src/shared/decimal-surface.ts"],"sourcesContent":["/**\n * Internal scaled⇄decimal bridge for the SDK's public decimal-string surface.\n *\n * The wire protocol carries scaled integers (price ticks, per-asset scaled\n * quantities); the public SDK surface carries plain decimal strings. Output\n * schemas convert exactly (no rounding, trailing zeros trimmed); input schemas\n * accept zero padding but reject fractional precision that remains above the\n * scale after trailing zeros are removed. Scaled integers must not escape\n * through any service input or output.\n */\nimport {\n    scaledToDecimal,\n    tryDecimalToScaled,\n    type DecimalToScaledFailure,\n} from \"../catalogs/decimal.js\";\nimport {\n    CatalogConversionError,\n    type ClientCatalog,\n    type PairCatalogKey,\n} from \"../catalogs/types.js\";\nimport { PRICE_SCALE } from \"../catalogs/readers.js\";\nimport { PROTOBUF_INT64_MAX } from \"./wire-bounds.js\";\n\n/** On-chain unified-asset amounts (`amountE18`) are always 18-decimal scaled. */\nexport const E18_SCALE = 18;\n\n/**\n * Resolves wire scales for the SDK's internal decimal conversion. Backed by\n * the client catalog; `ready()` must be awaited before the synchronous lookups\n * are used so the catalog can answer them.\n */\nexport interface SdkScales {\n    ready(): Promise<void>;\n    price(): number;\n    baseQty(pair: PairCatalogKey): number;\n    quoteAmount(pair: PairCatalogKey): number;\n    ledgerAmount(ledgerAssetId: number): number;\n    zippedAssetAmount(zippedAssetId: number): number;\n}\n\n/**\n * Catalog-backed scale resolver. Takes a getter so it can be constructed\n * before the owning client has assigned its catalog.\n */\nexport function createCatalogSdkScales(getCatalog: () => ClientCatalog): SdkScales {\n    return {\n        ready: async () => {\n            await getCatalog().ensureReady();\n        },\n        price: () => PRICE_SCALE,\n        baseQty: (pair) => requirePair(getCatalog(), pair).baseAsset.quantityScale,\n        quoteAmount: (pair) => requirePair(getCatalog(), pair).quoteAsset.quantityScale,\n        ledgerAmount: (ledgerAssetId) =>\n            getCatalog().ledger.requireAssetByLedgerId(ledgerAssetId).quantityScale,\n        zippedAssetAmount: (zippedAssetId) =>\n            getCatalog().zipper.requireAssetChainByZippedAssetId(zippedAssetId).asset.quantityScale,\n    };\n}\n\nfunction requirePair(catalog: ClientCatalog, pair: PairCatalogKey) {\n    return typeof pair === \"string\" || (typeof pair === \"object\" && \"symbol\" in pair)\n        ? catalog.market.requirePairBySymbol(typeof pair === \"string\" ? pair : pair.symbol)\n        : catalog.market.requirePairBySymbolId(typeof pair === \"number\" ? pair : pair.symbolId);\n}\n\n/** Output direction: exact scaled→decimal conversion (`1500000n`@6 → `\"1.5\"`). */\nexport function scaledToDecimalOutput(value: bigint, scale: number): string {\n    return scaledToDecimal(value, scale);\n}\n\nfunction conversionFailureMessage(\n    field: string,\n    value: string,\n    failure: DecimalToScaledFailure,\n): string {\n    return failure.reason === \"precision\"\n        ? `${field} supports at most ${failure.maxDecimals} decimal places: ${value}`\n        : `${field} must be a non-negative decimal number: ${value}`;\n}\n\n/**\n * Input direction: strict decimal→scaled conversion. Throws\n * CatalogConversionError for non-decimal input or inexact excess precision.\n */\nexport function decimalInputToScaled(field: string, value: string, scale: number): bigint {\n    const result = tryDecimalToScaled(value.trim(), scale);\n    if (!result.ok) {\n        throw new CatalogConversionError(\n            field,\n            conversionFailureMessage(field, value, result.failure),\n        );\n    }\n    return result.scaled;\n}\n\nfunction unboundedPositiveDecimalInputToScaled(\n    field: string,\n    value: string,\n    scale: number,\n): bigint {\n    const scaled = decimalInputToScaled(field, value, scale);\n    if (scaled <= 0n) {\n        throw new CatalogConversionError(field, `${field} must be greater than 0: ${value}`);\n    }\n    return scaled;\n}\n\n/**\n * Converts a positive decimal input to a scaled protobuf `int64` value.\n * Rejects values above the wire-format ceiling before serialization.\n */\nexport function positiveDecimalInputToScaled(field: string, value: string, scale: number): bigint {\n    const scaled = unboundedPositiveDecimalInputToScaled(field, value, scale);\n    if (scaled > PROTOBUF_INT64_MAX) {\n        throw new CatalogConversionError(\n            field,\n            `${field} exceeds the maximum supported value: ${value}`,\n        );\n    }\n    return scaled;\n}\n\n/**\n * Decimal quantity → PolyesterChain E18 ledger units.\n * Input precision is capped at the asset's quantityScale; the wire value is\n * always upscaled to E18 (trading balances / amount_e18 convention).\n */\nexport function quantityInputToE18(params: {\n    scales: SdkScales;\n    assetId: number;\n    quantity: string;\n    field?: string;\n}): bigint {\n    const field = params.field ?? \"quantity\";\n    const assetScale = params.scales.ledgerAmount(params.assetId);\n    if (assetScale > E18_SCALE) {\n        throw new CatalogConversionError(\n            field,\n            `${field} asset quantityScale ${assetScale} exceeds E18 ledger scale`,\n        );\n    }\n    return (\n        unboundedPositiveDecimalInputToScaled(field, params.quantity, assetScale) *\n        10n ** BigInt(E18_SCALE - assetScale)\n    );\n}\n\nexport interface ReadyGate {\n    run(deliver: () => void): void;\n}\n\n/**\n * Orders event delivery behind catalog readiness. Events arriving before the\n * catalog can resolve scales are queued and flushed in arrival order once it\n * is ready; delivery errors (including post-flush ones) route to `onError`\n * instead of escaping into the transport, mirroring the realtime client's\n * consumer-handler isolation. If readiness itself fails, queued events are\n * dropped after `onError` fires — the stream cannot be decoded without scales.\n */\nexport function createReadyGate(\n    ready: () => Promise<void>,\n    onError?: (error: unknown) => void,\n): ReadyGate {\n    let state: \"pending\" | \"open\" | \"failed\" = \"pending\";\n    const queue: Array<() => void> = [];\n\n    const deliverIsolated = (deliver: () => void) => {\n        try {\n            deliver();\n        } catch (error) {\n            onError?.(error);\n        }\n    };\n\n    ready().then(\n        () => {\n            state = \"open\";\n            for (const deliver of queue.splice(0)) deliverIsolated(deliver);\n        },\n        (error) => {\n            state = \"failed\";\n            queue.length = 0;\n            onError?.(error);\n        },\n    );\n\n    return {\n        run(deliver) {\n            if (state === \"open\") deliverIsolated(deliver);\n            else if (state === \"pending\") queue.push(deliver);\n        },\n    };\n}\n"],"mappings":";;;;;;;AA4CA,SAAgB,uBAAuB,YAA4C;CAC/E,OAAO;EACH,OAAO,YAAY;GACf,MAAM,WAAW,CAAC,CAAC,YAAY;EACnC;EACA,aAAA;EACA,UAAU,SAAS,YAAY,WAAW,GAAG,IAAI,CAAC,CAAC,UAAU;EAC7D,cAAc,SAAS,YAAY,WAAW,GAAG,IAAI,CAAC,CAAC,WAAW;EAClE,eAAe,kBACX,WAAW,CAAC,CAAC,OAAO,uBAAuB,aAAa,CAAC,CAAC;EAC9D,oBAAoB,kBAChB,WAAW,CAAC,CAAC,OAAO,iCAAiC,aAAa,CAAC,CAAC,MAAM;CAClF;AACJ;AAEA,SAAS,YAAY,SAAwB,MAAsB;CAC/D,OAAO,OAAO,SAAS,YAAa,OAAO,SAAS,YAAY,YAAY,OACtE,QAAQ,OAAO,oBAAoB,OAAO,SAAS,WAAW,OAAO,KAAK,MAAM,IAChF,QAAQ,OAAO,sBAAsB,OAAO,SAAS,WAAW,OAAO,KAAK,QAAQ;AAC9F;;AAGA,SAAgB,sBAAsB,OAAe,OAAuB;CACxE,OAAO,gBAAgB,OAAO,KAAK;AACvC;AAEA,SAAS,yBACL,OACA,OACA,SACM;CACN,OAAO,QAAQ,WAAW,cACpB,GAAG,MAAM,oBAAoB,QAAQ,YAAY,mBAAmB,UACpE,GAAG,MAAM,0CAA0C;AAC7D;;;;;AAMA,SAAgB,qBAAqB,OAAe,OAAe,OAAuB;CACtF,MAAM,SAAS,mBAAmB,MAAM,KAAK,GAAG,KAAK;CACrD,IAAI,CAAC,OAAO,IACR,MAAM,IAAI,uBACN,OACA,yBAAyB,OAAO,OAAO,OAAO,OAAO,CACzD;CAEJ,OAAO,OAAO;AAClB;AAEA,SAAS,sCACL,OACA,OACA,OACM;CACN,MAAM,SAAS,qBAAqB,OAAO,OAAO,KAAK;CACvD,IAAI,UAAU,IACV,MAAM,IAAI,uBAAuB,OAAO,GAAG,MAAM,2BAA2B,OAAO;CAEvF,OAAO;AACX;;;;;AAMA,SAAgB,6BAA6B,OAAe,OAAe,OAAuB;CAC9F,MAAM,SAAS,sCAAsC,OAAO,OAAO,KAAK;CACxE,IAAI,SAAA,sBACA,MAAM,IAAI,uBACN,OACA,GAAG,MAAM,wCAAwC,OACrD;CAEJ,OAAO;AACX;;;;;;AAOA,SAAgB,mBAAmB,QAKxB;CACP,MAAM,QAAQ,OAAO,SAAS;CAC9B,MAAM,aAAa,OAAO,OAAO,aAAa,OAAO,OAAO;CAC5D,IAAI,aAAA,IACA,MAAM,IAAI,uBACN,OACA,GAAG,MAAM,uBAAuB,WAAW,0BAC/C;CAEJ,OACI,sCAAsC,OAAO,OAAO,UAAU,UAAU,IACxE,OAAO,OAAA,KAAmB,UAAU;AAE5C;;;;;;;;;AAcA,SAAgB,gBACZ,OACA,SACS;CACT,IAAI,QAAuC;CAC3C,MAAM,QAA2B,CAAC;CAElC,MAAM,mBAAmB,YAAwB;EAC7C,IAAI;GACA,QAAQ;EACZ,SAAS,OAAO;GACZ,UAAU,KAAK;EACnB;CACJ;CAEA,MAAM,CAAC,CAAC,WACE;EACF,QAAQ;EACR,KAAK,MAAM,WAAW,MAAM,OAAO,CAAC,GAAG,gBAAgB,OAAO;CAClE,IACC,UAAU;EACP,QAAQ;EACR,MAAM,SAAS;EACf,UAAU,KAAK;CACnB,CACJ;CAEA,OAAO,EACH,IAAI,SAAS;EACT,IAAI,UAAU,QAAQ,gBAAgB,OAAO;OACxC,IAAI,UAAU,WAAW,MAAM,KAAK,OAAO;CACpD,EACJ;AACJ"}
+{"version":3,"file":"decimal-surface.js","names":[],"sources":["../../src/shared/decimal-surface.ts"],"sourcesContent":["/**\n * Internal scaled⇄decimal bridge for the SDK's public decimal-string surface.\n *\n * The wire protocol carries scaled integers (price ticks, per-asset scaled\n * quantities); the public SDK surface carries plain decimal strings. Output\n * schemas convert exactly (no rounding, trailing zeros trimmed); input schemas\n * accept zero padding but reject fractional precision that remains above the\n * scale after trailing zeros are removed. Scaled integers must not escape\n * through any service input or output.\n */\nimport {\n    scaledToDecimal,\n    tryDecimalToScaled,\n    type DecimalToScaledFailure,\n} from \"../catalogs/decimal.js\";\nimport {\n    CatalogConversionError,\n    CatalogLookupError,\n    CatalogNotReadyError,\n    type ClientCatalog,\n    type PairCatalogKey,\n} from \"../catalogs/types.js\";\nimport { PRICE_SCALE } from \"../catalogs/readers.js\";\nimport { PROTOBUF_INT64_MAX } from \"./wire-bounds.js\";\n\n/** On-chain unified-asset amounts (`amountE18`) are always 18-decimal scaled. */\nexport const E18_SCALE = 18;\n\n/**\n * Resolves wire scales for the SDK's internal decimal conversion. Backed by\n * the client catalog; `ready()` must be awaited before the synchronous lookups\n * are used so the catalog can answer them.\n */\nexport interface SdkScales {\n    ready(): Promise<void>;\n    price(): number;\n    baseQty(pair: PairCatalogKey): number;\n    quoteAmount(pair: PairCatalogKey): number;\n    ledgerAmount(ledgerAssetId: number): number;\n    zippedAssetAmount(zippedAssetId: number): number;\n}\n\n/**\n * Catalog-backed scale resolver. Takes a getter so it can be constructed\n * before the owning client has assigned its catalog.\n */\nexport function createCatalogSdkScales(getCatalog: () => ClientCatalog): SdkScales {\n    return {\n        ready: async () => {\n            await getCatalog().ensureReady();\n        },\n        price: () => PRICE_SCALE,\n        baseQty: (pair) => requirePair(getCatalog(), pair).baseAsset.quantityScale,\n        quoteAmount: (pair) => requirePair(getCatalog(), pair).quoteAsset.quantityScale,\n        ledgerAmount: (ledgerAssetId) => {\n            const ledger = getCatalog().ledger;\n            if (!ledger.isKnownAssetId(ledgerAssetId)) {\n                throw new CatalogLookupError(\"ledger\", \"ledgerId\", ledgerAssetId);\n            }\n            return ledger.requireAssetByLedgerId(ledgerAssetId).quantityScale;\n        },\n        zippedAssetAmount: (zippedAssetId) =>\n            getCatalog().zipper.requireAssetChainByZippedAssetId(zippedAssetId).asset.quantityScale,\n    };\n}\n\nfunction requirePair(catalog: ClientCatalog, pair: PairCatalogKey) {\n    return typeof pair === \"string\" || (typeof pair === \"object\" && \"symbol\" in pair)\n        ? catalog.market.requirePairBySymbol(typeof pair === \"string\" ? pair : pair.symbol)\n        : catalog.market.requirePairBySymbolId(typeof pair === \"number\" ? pair : pair.symbolId);\n}\n\n/** Output direction: exact scaled→decimal conversion (`1500000n`@6 → `\"1.5\"`). */\nexport function scaledToDecimalOutput(value: bigint, scale: number): string {\n    return scaledToDecimal(value, scale);\n}\n\nfunction conversionFailureMessage(\n    field: string,\n    value: string,\n    failure: DecimalToScaledFailure,\n): string {\n    return failure.reason === \"precision\"\n        ? `${field} supports at most ${failure.maxDecimals} decimal places: ${value}`\n        : `${field} must be a non-negative decimal number: ${value}`;\n}\n\n/**\n * Input direction: strict decimal→scaled conversion. Throws\n * CatalogConversionError for non-decimal input or inexact excess precision.\n */\nexport function decimalInputToScaled(field: string, value: string, scale: number): bigint {\n    const result = tryDecimalToScaled(value.trim(), scale);\n    if (!result.ok) {\n        throw new CatalogConversionError(\n            field,\n            conversionFailureMessage(field, value, result.failure),\n        );\n    }\n    return result.scaled;\n}\n\nfunction unboundedPositiveDecimalInputToScaled(\n    field: string,\n    value: string,\n    scale: number,\n): bigint {\n    const scaled = decimalInputToScaled(field, value, scale);\n    if (scaled <= 0n) {\n        throw new CatalogConversionError(field, `${field} must be greater than 0: ${value}`);\n    }\n    return scaled;\n}\n\n/**\n * Converts a positive decimal input to a scaled protobuf `int64` value.\n * Rejects values above the wire-format ceiling before serialization.\n */\nexport function positiveDecimalInputToScaled(field: string, value: string, scale: number): bigint {\n    const scaled = unboundedPositiveDecimalInputToScaled(field, value, scale);\n    if (scaled > PROTOBUF_INT64_MAX) {\n        throw new CatalogConversionError(\n            field,\n            `${field} exceeds the maximum supported value: ${value}`,\n        );\n    }\n    return scaled;\n}\n\n/**\n * Decimal quantity → PolyesterChain E18 ledger units.\n * Input precision is capped at the asset's quantityScale; the wire value is\n * always upscaled to E18 (trading balances / amount_e18 convention).\n */\nexport function quantityInputToE18(params: {\n    scales: SdkScales;\n    assetId: number;\n    quantity: string;\n    field?: string;\n}): bigint {\n    const field = params.field ?? \"quantity\";\n    const assetScale = params.scales.ledgerAmount(params.assetId);\n    if (assetScale > E18_SCALE) {\n        throw new CatalogConversionError(\n            field,\n            `${field} asset quantityScale ${assetScale} exceeds E18 ledger scale`,\n        );\n    }\n    return (\n        unboundedPositiveDecimalInputToScaled(field, params.quantity, assetScale) *\n        10n ** BigInt(E18_SCALE - assetScale)\n    );\n}\n\nexport interface ReadyGate {\n    /** Queues or delivers one transition while the gate remains active. */\n    run(deliver: () => void): void;\n    /** Drops pending transitions and permanently prevents future delivery. */\n    close(): void;\n}\n\ninterface ReadyGateHandlers {\n    onDeliveryError?: (error: unknown) => void;\n    onTerminalError: (error: unknown) => void;\n}\n\nconst READY_GATE_MAX_PENDING_DELIVERIES = 1_024;\n\n/**\n * Transition event delivery behind catalog readiness. Events arriving before the\n * catalog can resolve scales are queued and flushed in arrival order once it\n * is ready. Delivery errors are isolated from the transport. Readiness failure\n * or queue overflow is terminal because dropping an event would break stream\n * continuity; the owning subscription must visibly terminate when notified.\n */\nexport function createReadyGate(\n    ready: () => Promise<void>,\n    handlers: ReadyGateHandlers,\n): ReadyGate {\n    let state: \"pending\" | \"open\" | \"closed\" = \"pending\";\n    const queue: Array<() => void> = [];\n\n    const deliverIsolated = (deliver: () => void) => {\n        try {\n            deliver();\n        } catch (error) {\n            handlers.onDeliveryError?.(error);\n        }\n    };\n\n    const closeWithError = (error: unknown) => {\n        if (state === \"closed\") return;\n        state = \"closed\";\n        queue.length = 0;\n        handlers.onTerminalError(error);\n    };\n\n    Promise.resolve()\n        .then(ready)\n        .then(\n            () => {\n                if (state !== \"pending\") return;\n                state = \"open\";\n                for (const deliver of queue.splice(0)) deliverIsolated(deliver);\n            },\n            (error) => {\n                if (state !== \"pending\") return;\n                closeWithError(error);\n            },\n        );\n\n    return {\n        run(deliver) {\n            if (state === \"open\") deliverIsolated(deliver);\n            else if (state === \"pending\") {\n                if (queue.length === READY_GATE_MAX_PENDING_DELIVERIES) {\n                    closeWithError(new CatalogNotReadyError());\n                    return;\n                }\n                queue.push(deliver);\n            }\n        },\n        close() {\n            if (state === \"closed\") return;\n            state = \"closed\";\n            queue.length = 0;\n        },\n    };\n}\n"],"mappings":"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"}

package/dist/shared/transports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transports.d.ts","names":[],"sources":["../../src/shared/transports.ts"],"mappings":";;;UAwBiB;EACb,SAAS;EACT,WAAW;;;;;UAME;EACb;;EAEA,gCAAgC;;;;;;UAOnB;EACb;EACA,gCAAgC;;EAEhC,oBAAoB,oBAAoB,QAAQ"}
+{"version":3,"file":"transports.d.ts","names":[],"sources":["../../src/shared/transports.ts"],"mappings":";;;UA8BiB;EACb,SAAS;EACT,WAAW;;;;;UAME;EACb;;EAEA,gCAAgC;;;;;;UAOnB;EACb;EACA,gCAAgC;;EAEhC,oBAAoB,oBAAoB,QAAQ"}

package/dist/shared/transports.js

@@ -1,4 +1,4 @@
-import { ConfigurationError, NetworkError, isAbortError } from "./errors.js";
+import { AuthenticationError, ConfigurationError, NetworkError, PolyesterError, isAbortError } from "./errors.js";
 import { createErrorMappingTransport } from "./connect-error-mapping.js";
 import { createConnectTransport } from "@connectrpc/connect-web";
 import { toBinary, toJsonString } from "@bufbuild/protobuf";
@@ -34,7 +34,7 @@ function createTransports(config) {
 		interceptors,
 		fetch: makeFetch()
 	}));
-	const authInterceptors = auth ? [createAuthInterceptor(auth, { wireFormat }), ...interceptors] : interceptors;
+	const authInterceptors = auth ? auth.kind === "jwt" ? [createAuthInterceptor(auth, { wireFormat }), ...interceptors] : [...interceptors, createAuthInterceptor(auth, { wireFormat })] : interceptors;
 	return {
 		authApi: createErrorMappingTransport(createConnectTransport({
 			baseUrl: apiUrl,
@@ -65,8 +65,16 @@ function canonicalQueryString(params) {
 * Creates API-key authentication headers for endpoints using the Polyester Ed25519 signing contract.
 */
 async function createApiKeyEd25519AuthHeaders(auth, request) {
-	const [keyId, secretKey] = await Promise.all([auth.getKeyId(), auth.getSecretKey()]);
+	let keyId;
+	let secretKey;
+	try {
+		[keyId, secretKey] = await Promise.all([auth.getKeyId(), auth.getSecretKey()]);
+	} catch (cause) {
+		if (cause instanceof PolyesterError) throw cause;
+		throw new ConfigurationError("API key credential provider failed", { cause });
+	}
 	if (!keyId || !secretKey) throw new ConfigurationError("Missing API key ID or secret key");
+	if (!(secretKey instanceof Uint8Array) || secretKey.byteLength !== 32) throw new ConfigurationError("API key secret key must contain exactly 32 bytes");
 	const urlObj = new URL(request.url);
 	const timestamp = request.timestamp ?? nextTimestamp();
 	const bodyHash = await sha256Hex(request.body ?? /* @__PURE__ */ new Uint8Array(0));
@@ -74,27 +82,41 @@ async function createApiKeyEd25519AuthHeaders(auth, request) {
 	const canonical = `${timestamp}\n${request.method}\n${urlObj.pathname}\n${canonicalQuery}\n${bodyHash}`;
 	const msgBytes = new TextEncoder().encode(canonical);
 	const sig = await signAsync(msgBytes, secretKey);
+	const signatureHex = Array.from(sig, (b) => b.toString(16).padStart(2, "0")).join("");
 	return {
 		"X-API-KEY-ID": keyId,
 		"X-API-TIMESTAMP": timestamp,
-		"X-API-SIGNATURE": Array.from(sig, (b) => b.toString(16).padStart(2, "0")).join("")
+		"X-API-SIGNATURE": signatureHex
 	};
 }
 /**
+* Resolves a JWT credential and translates provider failures or invalid values
+* into stable SDK errors.
+*/
+async function resolveJwtToken(auth) {
+	let token;
+	try {
+		token = await auth.getToken();
+	} catch (cause) {
+		if (cause instanceof PolyesterError) throw cause;
+		throw new AuthenticationError("JWT token provider failed", { cause });
+	}
+	if (token !== null && typeof token !== "string") throw new ConfigurationError("JWT token provider must return a string or null");
+	return token;
+}
+/**
 * Creates an interceptor that attaches SDK authentication headers.
 */
 function createAuthInterceptor(auth, options) {
 	return (next) => async (req) => {
 		const wireFormat = options?.wireFormat ?? "binary";
 		if (auth.kind === "jwt") {
-			const token = await auth.getToken();
+			const token = await resolveJwtToken(auth);
 			if (token) req.header.set("Authorization", `Bearer ${token}`);
 		} else if (auth.kind === "api-key-ed25519") {
-			let bodyBytes;
-			if (!req.stream) {
-				const inputSchema = req.method.input;
-				bodyBytes = wireFormat === "json" ? new TextEncoder().encode(toJsonString(inputSchema, req.message)) : toBinary(inputSchema, req.message);
-			} else bodyBytes = /* @__PURE__ */ new Uint8Array(0);
+			if (req.stream) throw new ConfigurationError("API key authentication does not support streaming Connect RPCs");
+			const inputSchema = req.method.input;
+			const bodyBytes = wireFormat === "json" ? new TextEncoder().encode(toJsonString(inputSchema, req.message)) : toBinary(inputSchema, req.message);
 			const headers = await createApiKeyEd25519AuthHeaders(auth, {
 				url: req.url,
 				method: req.requestMethod,
@@ -106,6 +128,6 @@ function createAuthInterceptor(auth, options) {
 	};
 }
 //#endregion
-export { createApiKeyEd25519AuthHeaders, createAuthInterceptor, createTransports, isAbortError, makeFetch };
+export { createApiKeyEd25519AuthHeaders, createAuthInterceptor, createTransports, isAbortError, makeFetch, resolveJwtToken };
 
 //# sourceMappingURL=transports.js.map