@polyester/sdk 0.14.2 → 0.15.1

package/dist/services/triggers/triggers-output.schemas.d.ts

@@ -31,62 +31,62 @@ declare const CreateTriggerResultSchema: v.SchemaWithPipe<readonly [v.ObjectSche
 type CreateTriggerResult = v.InferOutput<typeof CreateTriggerResultSchema>;
 declare const CancelTriggerResultSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly triggerId: v.SchemaWithPipe<readonly [v.BigintSchema<undefined>, v.TransformAction<bigint, string>]>;
-  readonly status: v.SchemaWithPipe<readonly [v.EnumSchema<typeof TriggerStatus, undefined>, v.TransformAction<TriggerStatus, "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused">]>;
+  readonly status: v.SchemaWithPipe<readonly [v.EnumSchema<typeof TriggerStatus, undefined>, v.TransformAction<TriggerStatus, "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused">]>;
   readonly tsNs: v.BigintSchema<undefined>;
 }, undefined>, v.TransformAction<{
   triggerId: string;
-  status: "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused";
+  status: "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused";
   tsNs: bigint;
 }, {
   ts: number;
   tsNs: string;
   triggerId: string;
-  status: "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused";
+  status: "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused";
 }>]>;
 type CancelTriggerResult = v.InferOutput<typeof CancelTriggerResultSchema>;
 declare const ModifyTriggerResultSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly triggerId: v.SchemaWithPipe<readonly [v.BigintSchema<undefined>, v.TransformAction<bigint, string>]>;
-  readonly status: v.SchemaWithPipe<readonly [v.EnumSchema<typeof TriggerStatus, undefined>, v.TransformAction<TriggerStatus, "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused">]>;
+  readonly status: v.SchemaWithPipe<readonly [v.EnumSchema<typeof TriggerStatus, undefined>, v.TransformAction<TriggerStatus, "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused">]>;
   readonly tsNs: v.BigintSchema<undefined>;
 }, undefined>, v.TransformAction<{
   triggerId: string;
-  status: "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused";
+  status: "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused";
   tsNs: bigint;
 }, {
   ts: number;
   tsNs: string;
   triggerId: string;
-  status: "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused";
+  status: "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused";
 }>]>;
 type ModifyTriggerResult = v.InferOutput<typeof ModifyTriggerResultSchema>;
 declare const PauseTriggerResultSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly triggerId: v.SchemaWithPipe<readonly [v.BigintSchema<undefined>, v.TransformAction<bigint, string>]>;
-  readonly status: v.SchemaWithPipe<readonly [v.EnumSchema<typeof TriggerStatus, undefined>, v.TransformAction<TriggerStatus, "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused">]>;
+  readonly status: v.SchemaWithPipe<readonly [v.EnumSchema<typeof TriggerStatus, undefined>, v.TransformAction<TriggerStatus, "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused">]>;
   readonly tsNs: v.BigintSchema<undefined>;
 }, undefined>, v.TransformAction<{
   triggerId: string;
-  status: "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused";
+  status: "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused";
   tsNs: bigint;
 }, {
   ts: number;
   tsNs: string;
   triggerId: string;
-  status: "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused";
+  status: "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused";
 }>]>;
 type PauseTriggerResult = v.InferOutput<typeof PauseTriggerResultSchema>;
 declare const ResumeTriggerResultSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly triggerId: v.SchemaWithPipe<readonly [v.BigintSchema<undefined>, v.TransformAction<bigint, string>]>;
-  readonly status: v.SchemaWithPipe<readonly [v.EnumSchema<typeof TriggerStatus, undefined>, v.TransformAction<TriggerStatus, "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused">]>;
+  readonly status: v.SchemaWithPipe<readonly [v.EnumSchema<typeof TriggerStatus, undefined>, v.TransformAction<TriggerStatus, "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused">]>;
   readonly tsNs: v.BigintSchema<undefined>;
 }, undefined>, v.TransformAction<{
   triggerId: string;
-  status: "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused";
+  status: "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused";
   tsNs: bigint;
 }, {
   ts: number;
   tsNs: string;
   triggerId: string;
-  status: "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused";
+  status: "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused";
 }>]>;
 type ResumeTriggerResult = v.InferOutput<typeof ResumeTriggerResultSchema>;
 type StopDetailsOutput = {
@@ -528,7 +528,7 @@ declare function createTriggerSchema(scales: SdkScales): v.SchemaWithPipe<readon
   triggerId: string;
   subaccountId: string;
   symbolId: number;
-  status: "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused";
+  status: "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused";
   parentOrderId: string | undefined;
   qty: string;
   feeAsset: "unspecified" | "quote" | "base";
@@ -669,7 +669,7 @@ declare function createTriggerSchema(scales: SdkScales): v.SchemaWithPipe<readon
   triggerId: string;
   subaccountId: string;
   symbolId: number;
-  status: "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused";
+  status: "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused";
   parentOrderId: string | undefined;
   qty: string;
   feeAsset: "unspecified" | "quote" | "base";
@@ -810,7 +810,7 @@ declare function createTriggerSchema(scales: SdkScales): v.SchemaWithPipe<readon
   triggerId: string;
   subaccountId: string;
   symbolId: number;
-  status: "unspecified" | "cancelled" | "created" | "failed" | "completed" | "armed" | "running" | "paused";
+  status: "unspecified" | "completed" | "failed" | "cancelled" | "created" | "armed" | "running" | "paused";
   parentOrderId: string | undefined;
   qty: string;
   feeAsset: "unspecified" | "quote" | "base";
@@ -994,7 +994,7 @@ declare function createTriggerEventSchema(scales: SdkScales): v.SchemaWithPipe<r
   subaccountId: string;
   symbolId: number;
   triggerType: "unspecified" | "twap" | "ladder" | "stop_loss" | "take_profit" | "trailing_stop";
-  eventType: "unspecified" | "updated" | "failed" | "fired" | "canceled";
+  eventType: "unspecified" | "failed" | "updated" | "fired" | "canceled";
   ts: number;
   childSeq: number;
   childOrderId: string | undefined;
@@ -1006,7 +1006,7 @@ declare function createTriggerEventSchema(scales: SdkScales): v.SchemaWithPipe<r
   subaccountId: string;
   symbolId: number;
   triggerType: "unspecified" | "twap" | "ladder" | "stop_loss" | "take_profit" | "trailing_stop";
-  eventType: "unspecified" | "updated" | "failed" | "fired" | "canceled";
+  eventType: "unspecified" | "failed" | "updated" | "fired" | "canceled";
   ts: number;
   childSeq: number;
   childOrderId: string | undefined;
@@ -1018,7 +1018,7 @@ declare function createTriggerEventSchema(scales: SdkScales): v.SchemaWithPipe<r
   subaccountId: string;
   symbolId: number;
   triggerType: "unspecified" | "twap" | "ladder" | "stop_loss" | "take_profit" | "trailing_stop";
-  eventType: "unspecified" | "updated" | "failed" | "fired" | "canceled";
+  eventType: "unspecified" | "failed" | "updated" | "fired" | "canceled";
   ts: number;
   childSeq: number;
   childOrderId: string | undefined;

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":";;;;;;;UAiCiB;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":";;;;;;;UAwCiB;EACb,SAAS;EACT;EACA,QAAQ,MAAM;EACd,YAAY,MAAM;EAClB,aAAa;EACb,kBAAkB"}

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    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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"}
+{"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 * Policy notional caps (`max_order_notional`) are canonical quote microunits:\n * one unit is 0.000001 USDT, per the `auth.v1` policy contract. Fixed by the\n * protocol rather than per-pair, so it needs no catalog lookup.\n */\nexport const QUOTE_NOTIONAL_SCALE = 6;\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/schemas.js

@@ -1,6 +1,7 @@
 import { formatId, idToBigInt } from "../utils/base58-id.js";
-import { parseOptionalUint64DecimalStrict, toBigIntOrZero, toBpsOrZero, toIntOrZero } from "../utils/numbers.js";
+import { parseOptionalUint64DecimalStrict, toBpsOrZero, toIntOrZero } from "../utils/numbers.js";
 import { tsNsToMs, tsObjToMs } from "../utils/time.js";
+import { PROTOBUF_UINT32_MAX } from "./wire-bounds.js";
 import * as v from "valibot";
 //#region src/shared/schemas.ts
 const UINT64_MAX = (1n << 64n) - 1n;
@@ -15,8 +16,7 @@ const TimestampSchema = v.object({
 const TimestampMsSchema = v.pipe(TimestampSchema, v.transform((value) => tsObjToMs(value)));
 const OptionalTimestampMsSchema = v.pipe(v.optional(TimestampSchema), v.transform((value) => tsObjToMs(value)));
 const OptionalNumberDefaultNullSchema = v.optional(v.nullable(v.number()), null);
-const OptionalNumberToBigIntOrZeroSchema = v.pipe(OptionalNumberDefaultNullSchema, v.transform((value) => toBigIntOrZero(value)));
-const OptionalNumberToIntOrZeroSchema = v.pipe(OptionalNumberDefaultNullSchema, v.transform((value) => toIntOrZero(value)));
+const OptionalNumberToIntOrZeroSchema = v.pipe(v.optional(v.nullable(v.pipe(v.number(), v.maxValue(PROTOBUF_UINT32_MAX))), null), v.transform((value) => toIntOrZero(value)));
 v.pipe(OptionalNumberDefaultNullSchema, v.transform((value) => toBpsOrZero(value)));
 v.pipe(v.bigint(), v.transform((value) => tsNsToMs(value)));
 const BigIntStringSchema = v.pipe(v.bigint(), v.transform((value) => value.toString()));
@@ -60,6 +60,6 @@ function positiveBigintStringInputSchema(fieldName) {
 }
 const JsonObjectSchema = v.custom((input) => typeof input === "object" && input !== null && !Array.isArray(input));
 //#endregion
-export { BigIntStringSchema, JsonObjectSchema, OptionalBigIntStringSchema, OptionalNumberDefaultNullSchema, OptionalNumberToBigIntOrZeroSchema, OptionalNumberToIntOrZeroSchema, OptionalPublicIdSchema, OptionalTimestampMsSchema, OptionalTimestampMsToUsInputSchema, OptionalTimestampSecondsInputSchema, PublicIdSchema, TimestampMsSchema, TimestampSchema, bigintStringInputSchema, idInputSchema, optionalIdInputSchema, optionalSubaccountIdInputSchema, optionalUint64DecimalFilterSchema, positiveBigintStringInputSchema };
+export { BigIntStringSchema, JsonObjectSchema, OptionalBigIntStringSchema, OptionalNumberDefaultNullSchema, OptionalNumberToIntOrZeroSchema, OptionalPublicIdSchema, OptionalTimestampMsSchema, OptionalTimestampMsToUsInputSchema, OptionalTimestampSecondsInputSchema, PublicIdSchema, TimestampMsSchema, TimestampSchema, bigintStringInputSchema, idInputSchema, optionalIdInputSchema, optionalSubaccountIdInputSchema, optionalUint64DecimalFilterSchema, positiveBigintStringInputSchema };
 
 //# sourceMappingURL=schemas.js.map

package/dist/shared/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","names":[],"sources":["../../src/shared/schemas.ts"],"sourcesContent":["import * as v from \"valibot\";\nimport { formatId, idToBigInt } from \"../utils/base58-id.js\";\nimport {\n    parseOptionalUint64DecimalStrict,\n    toBigIntOrZero,\n    toBpsOrZero,\n    toIntOrZero,\n} from \"../utils/numbers.js\";\nimport { tsNsToMs, tsObjToMs } from \"../utils/time.js\";\nimport type { JsonObject } from \"@bufbuild/protobuf\";\n\nconst UINT64_MAX = (1n << 64n) - 1n;\nconst MS_TO_US = 1_000n;\nconst MS_TO_NS = 1_000_000n;\nconst MAX_UINT64_TIMESTAMP_MS_US = Number(UINT64_MAX / MS_TO_US);\nconst MAX_UINT64_TIMESTAMP_MS = Number(UINT64_MAX / MS_TO_NS);\n\nexport const TimestampSchema = v.object({\n    seconds: v.bigint(),\n    nanos: v.optional(v.number(), 0),\n});\n\nexport const TimestampMsSchema = v.pipe(\n    TimestampSchema,\n    v.transform((value) => tsObjToMs(value)),\n);\n\nexport const OptionalTimestampMsSchema = v.pipe(\n    v.optional(TimestampSchema),\n    v.transform((value) => tsObjToMs(value)),\n);\n\nexport const OptionalNumberDefaultNullSchema = v.optional(v.nullable(v.number()), null);\n\nexport const OptionalNumberToBigIntOrZeroSchema = v.pipe(\n    OptionalNumberDefaultNullSchema,\n    v.transform((value) => toBigIntOrZero(value)),\n);\n\nexport const OptionalNumberToIntOrZeroSchema = v.pipe(\n    OptionalNumberDefaultNullSchema,\n    v.transform((value) => toIntOrZero(value)),\n);\n\nexport const OptionalNumberToBpsOrZeroSchema = v.pipe(\n    OptionalNumberDefaultNullSchema,\n    v.transform((value) => toBpsOrZero(value)),\n);\n\nexport const TimestampNsMsSchema = v.pipe(\n    v.bigint(),\n    v.transform((value) => tsNsToMs(value)),\n);\n\nexport const BigIntStringSchema = v.pipe(\n    v.bigint(),\n    v.transform((value) => value.toString()),\n);\n\nexport const OptionalBigIntStringSchema = v.pipe(\n    v.optional(v.bigint()),\n    v.transform((value) => (value === undefined ? undefined : value.toString())),\n);\n\nexport const OptionalTimestampMsToNsInputSchema = v.optional(\n    v.pipe(\n        v.number(),\n        v.integer(),\n        v.minValue(0),\n        v.maxValue(MAX_UINT64_TIMESTAMP_MS),\n        v.transform((value) => BigInt(value) * MS_TO_NS),\n    ),\n);\n\nexport const OptionalTimestampMsToUsInputSchema = v.optional(\n    v.pipe(\n        v.number(),\n        v.integer(),\n        v.minValue(0),\n        v.maxValue(MAX_UINT64_TIMESTAMP_MS_US),\n        v.transform((value) => BigInt(value) * MS_TO_US),\n    ),\n);\n\nexport const OptionalTimestampSecondsInputSchema = v.optional(\n    v.pipe(\n        v.number(),\n        v.integer(),\n        v.minValue(0),\n        v.maxValue(Number.MAX_SAFE_INTEGER),\n        v.transform((value) => BigInt(value)),\n    ),\n);\n\nexport const PublicIdSchema = v.pipe(\n    v.bigint(),\n    v.transform((value) => formatId(value)),\n);\n\nexport const OptionalPublicIdSchema = v.pipe(\n    v.optional(v.bigint()),\n    v.transform((value) => (value ? formatId(value) : undefined)),\n);\n\nconst TrimmedStringSchema = v.pipe(v.string(), v.trim());\n\nconst OptionalTrimmedStringSchema = v.optional(TrimmedStringSchema);\n\n/**\n * Creates a schema for required public id input.\n */\nexport function idInputSchema(fieldName: string) {\n    return v.pipe(\n        v.string(),\n        v.trim(),\n        v.minLength(1),\n        v.transform((value) => idToBigInt(value, fieldName)),\n    );\n}\n\n/**\n * Creates a schema for optional public id input.\n */\nexport function optionalIdInputSchema(fieldName: string) {\n    return v.pipe(\n        OptionalTrimmedStringSchema,\n        v.transform((value) => (value ? idToBigInt(value, fieldName) : undefined)),\n    );\n}\n\n/**\n * Creates a schema for optional subaccount id input.\n */\nexport function optionalSubaccountIdInputSchema() {\n    return optionalIdInputSchema(\"subaccountId\");\n}\n\n/**\n * Creates a schema for optional uint64 decimal filter input.\n */\nexport function optionalUint64DecimalFilterSchema(fieldName: string) {\n    return v.pipe(\n        OptionalTrimmedStringSchema,\n        v.transform((value) => parseOptionalUint64DecimalStrict(value, fieldName)),\n    );\n}\n\n/**\n * Creates a schema for positive bigint-like input.\n */\nexport function positiveBigintLikeSchema(message: string) {\n    return v.pipe(\n        v.union([\n            v.bigint(),\n            v.pipe(\n                TrimmedStringSchema,\n                v.regex(/^\\d+$/),\n                v.transform((value) => BigInt(value)),\n            ),\n        ]),\n        v.check((value) => value > 0n, message),\n    );\n}\n\nexport function bigintStringInputSchema(fieldName: string) {\n    return v.pipe(\n        TrimmedStringSchema,\n        v.regex(/^\\d+$/, `${fieldName} must be a decimal integer`),\n        v.transform((value) => BigInt(value)),\n    );\n}\n\nexport function positiveBigintStringInputSchema(fieldName: string) {\n    return v.pipe(\n        bigintStringInputSchema(fieldName),\n        v.check((value) => value > 0n, `${fieldName} must be greater than 0`),\n    );\n}\n\nexport const JsonObjectSchema = v.custom<JsonObject>(\n    (input): input is JsonObject =>\n        typeof input === \"object\" && input !== null && !Array.isArray(input),\n);\n"],"mappings":"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"}
+{"version":3,"file":"schemas.js","names":[],"sources":["../../src/shared/schemas.ts"],"sourcesContent":["import * as v from \"valibot\";\nimport { formatId, idToBigInt } from \"../utils/base58-id.js\";\nimport { parseOptionalUint64DecimalStrict, toBpsOrZero, toIntOrZero } from \"../utils/numbers.js\";\nimport { tsNsToMs, tsObjToMs } from \"../utils/time.js\";\nimport type { JsonObject } from \"@bufbuild/protobuf\";\nimport { PROTOBUF_UINT32_MAX } from \"./wire-bounds.js\";\n\nconst UINT64_MAX = (1n << 64n) - 1n;\nconst MS_TO_US = 1_000n;\nconst MS_TO_NS = 1_000_000n;\nconst MAX_UINT64_TIMESTAMP_MS_US = Number(UINT64_MAX / MS_TO_US);\nconst MAX_UINT64_TIMESTAMP_MS = Number(UINT64_MAX / MS_TO_NS);\n\nexport const TimestampSchema = v.object({\n    seconds: v.bigint(),\n    nanos: v.optional(v.number(), 0),\n});\n\nexport const TimestampMsSchema = v.pipe(\n    TimestampSchema,\n    v.transform((value) => tsObjToMs(value)),\n);\n\nexport const OptionalTimestampMsSchema = v.pipe(\n    v.optional(TimestampSchema),\n    v.transform((value) => tsObjToMs(value)),\n);\n\nexport const OptionalNumberDefaultNullSchema = v.optional(v.nullable(v.number()), null);\n\nexport const OptionalNumberToIntOrZeroSchema = v.pipe(\n    v.optional(v.nullable(v.pipe(v.number(), v.maxValue(PROTOBUF_UINT32_MAX))), null),\n    v.transform((value) => toIntOrZero(value)),\n);\n\nexport const OptionalNumberToBpsOrZeroSchema = v.pipe(\n    OptionalNumberDefaultNullSchema,\n    v.transform((value) => toBpsOrZero(value)),\n);\n\nexport const TimestampNsMsSchema = v.pipe(\n    v.bigint(),\n    v.transform((value) => tsNsToMs(value)),\n);\n\nexport const BigIntStringSchema = v.pipe(\n    v.bigint(),\n    v.transform((value) => value.toString()),\n);\n\nexport const OptionalBigIntStringSchema = v.pipe(\n    v.optional(v.bigint()),\n    v.transform((value) => (value === undefined ? undefined : value.toString())),\n);\n\nexport const OptionalTimestampMsToNsInputSchema = v.optional(\n    v.pipe(\n        v.number(),\n        v.integer(),\n        v.minValue(0),\n        v.maxValue(MAX_UINT64_TIMESTAMP_MS),\n        v.transform((value) => BigInt(value) * MS_TO_NS),\n    ),\n);\n\nexport const OptionalTimestampMsToUsInputSchema = v.optional(\n    v.pipe(\n        v.number(),\n        v.integer(),\n        v.minValue(0),\n        v.maxValue(MAX_UINT64_TIMESTAMP_MS_US),\n        v.transform((value) => BigInt(value) * MS_TO_US),\n    ),\n);\n\nexport const OptionalTimestampSecondsInputSchema = v.optional(\n    v.pipe(\n        v.number(),\n        v.integer(),\n        v.minValue(0),\n        v.maxValue(Number.MAX_SAFE_INTEGER),\n        v.transform((value) => BigInt(value)),\n    ),\n);\n\nexport const PublicIdSchema = v.pipe(\n    v.bigint(),\n    v.transform((value) => formatId(value)),\n);\n\nexport const OptionalPublicIdSchema = v.pipe(\n    v.optional(v.bigint()),\n    v.transform((value) => (value ? formatId(value) : undefined)),\n);\n\nconst TrimmedStringSchema = v.pipe(v.string(), v.trim());\n\nconst OptionalTrimmedStringSchema = v.optional(TrimmedStringSchema);\n\n/**\n * Creates a schema for required public id input.\n */\nexport function idInputSchema(fieldName: string) {\n    return v.pipe(\n        v.string(),\n        v.trim(),\n        v.minLength(1),\n        v.transform((value) => idToBigInt(value, fieldName)),\n    );\n}\n\n/**\n * Creates a schema for optional public id input.\n */\nexport function optionalIdInputSchema(fieldName: string) {\n    return v.pipe(\n        OptionalTrimmedStringSchema,\n        v.transform((value) => (value ? idToBigInt(value, fieldName) : undefined)),\n    );\n}\n\n/**\n * Creates a schema for optional subaccount id input.\n */\nexport function optionalSubaccountIdInputSchema() {\n    return optionalIdInputSchema(\"subaccountId\");\n}\n\n/**\n * Creates a schema for optional uint64 decimal filter input.\n */\nexport function optionalUint64DecimalFilterSchema(fieldName: string) {\n    return v.pipe(\n        OptionalTrimmedStringSchema,\n        v.transform((value) => parseOptionalUint64DecimalStrict(value, fieldName)),\n    );\n}\n\n/**\n * Creates a schema for positive bigint-like input.\n */\nexport function positiveBigintLikeSchema(message: string) {\n    return v.pipe(\n        v.union([\n            v.bigint(),\n            v.pipe(\n                TrimmedStringSchema,\n                v.regex(/^\\d+$/),\n                v.transform((value) => BigInt(value)),\n            ),\n        ]),\n        v.check((value) => value > 0n, message),\n    );\n}\n\nexport function bigintStringInputSchema(fieldName: string) {\n    return v.pipe(\n        TrimmedStringSchema,\n        v.regex(/^\\d+$/, `${fieldName} must be a decimal integer`),\n        v.transform((value) => BigInt(value)),\n    );\n}\n\nexport function positiveBigintStringInputSchema(fieldName: string) {\n    return v.pipe(\n        bigintStringInputSchema(fieldName),\n        v.check((value) => value > 0n, `${fieldName} must be greater than 0`),\n    );\n}\n\nexport const JsonObjectSchema = v.custom<JsonObject>(\n    (input): input is JsonObject =>\n        typeof input === \"object\" && input !== null && !Array.isArray(input),\n);\n"],"mappings":"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"}

package/dist/utils/numbers.js

@@ -36,15 +36,6 @@ function parseOptionalPositiveBigIntLike(value) {
 	return parsed > 0n ? parsed : void 0;
 }
 /**
-* Coerce optional UI number into non-negative bigint (e.g. caps, limits).
-* @param value - The value to coerce.
-* @returns The coerced bigint.
-*/
-function toBigIntOrZero(value) {
-	if (value == null || Number.isNaN(value)) return 0n;
-	return BigInt(Math.max(0, Math.trunc(value)));
-}
-/**
 * Coerce optional UI number into non-negative integer.
 * @param value - The value to coerce.
 * @returns The coerced integer.
@@ -63,6 +54,6 @@ function toBpsOrZero(value) {
 	return Math.max(0, Math.trunc(value * 100));
 }
 //#endregion
-export { parseOptionalPositiveBigIntLike, parseOptionalPositiveIntLike, parseOptionalUint64DecimalStrict, toBigIntOrZero, toBpsOrZero, toIntOrZero };
+export { parseOptionalPositiveBigIntLike, parseOptionalPositiveIntLike, parseOptionalUint64DecimalStrict, toBpsOrZero, toIntOrZero };
 
 //# sourceMappingURL=numbers.js.map

package/dist/utils/numbers.js.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.js","names":[],"sources":["../../src/utils/numbers.ts"],"sourcesContent":["// Shared numeric helpers for gRPC/Connect clients.\n\n/**\n * Parse a required uint64 encoded as a base-10 string into bigint.\n * @param raw - The raw string to parse.\n * @param fieldName - The name of the field to parse.\n * @returns The parsed bigint.\n * @throws An error if the field is required and not provided.\n * @throws An error if the field is not a positive integer.\n */\nexport function parseRequiredUint64Decimal(raw: string, fieldName: string): bigint {\n    const s = (raw ?? \"\").trim();\n    if (!s) throw new Error(`${fieldName} is required`);\n    if (!/^[0-9]+$/.test(s)) throw new Error(`${fieldName} must be a positive integer`);\n    return BigInt(s);\n}\n\n/**\n * Parse an optional uint64 encoded as a base-10 string into bigint, or undefined on invalid/empty.\n * @param raw - The raw string to parse.\n * @returns The parsed bigint, or undefined if the field is invalid or empty.\n */\nexport function parseOptionalUint64Decimal(raw: string | undefined): bigint | undefined {\n    const s = (raw ?? \"\").trim();\n    if (!s) return;\n    // For optional filters, treat invalid input as \"unset\" rather than surfacing an error.\n    if (!/^[0-9]+$/.test(s)) return;\n    return BigInt(s);\n}\n\n/**\n * Parse an optional uint64 encoded as a base-10 string into bigint.\n * Empty values are omitted, but supplied invalid values are rejected.\n */\nexport function parseOptionalUint64DecimalStrict(\n    raw: string | undefined,\n    fieldName: string,\n): bigint | undefined {\n    const s = (raw ?? \"\").trim();\n    if (!s) return;\n    if (!/^[0-9]+$/.test(s)) throw new Error(`${fieldName} must be a positive integer`);\n    return BigInt(s);\n}\n\n/**\n * Parse an optional uint64-ish value (string/number/bigint) into bigint, or undefined on invalid/empty.\n * Accepts base-10 strings, numeric inputs (truncated), and bigint inputs.\n */\nexport function parseOptionalUint64Like(\n    value: string | number | bigint | undefined | null,\n): bigint | undefined {\n    if (value === undefined || value === null) return undefined;\n    if (typeof value === \"bigint\") return value >= 0n ? value : undefined;\n    if (typeof value === \"number\") {\n        if (!Number.isFinite(value)) return undefined;\n        const n = Math.trunc(value);\n        return n >= 0 ? BigInt(n) : undefined;\n    }\n    return parseOptionalUint64Decimal(value);\n}\n\n/**\n * Parse an optional positive integer-ish value (string/number) into a number, or undefined on invalid/empty.\n * Useful for common \"limit\" fields coming from UI inputs.\n */\nexport function parseOptionalPositiveIntLike(\n    value: string | number | undefined | null,\n): number | undefined {\n    if (value === undefined || value === null) return undefined;\n    if (typeof value === \"string\") {\n        const decimal = value.trim();\n        if (!/^\\d+$/.test(decimal)) return undefined;\n        const parsed = Number(decimal);\n        return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : undefined;\n    }\n    return Number.isSafeInteger(value) && value > 0 ? value : undefined;\n}\n\n/**\n * Parse a positive integer-like value without losing precision.\n * Decimal strings may exceed JavaScript's safe-integer range; number inputs may not.\n */\nexport function parseOptionalPositiveBigIntLike(\n    value: string | number | undefined | null,\n): bigint | undefined {\n    if (value === undefined || value === null) return undefined;\n    if (typeof value === \"number\") {\n        return Number.isSafeInteger(value) && value > 0 ? BigInt(value) : undefined;\n    }\n    const decimal = value.trim();\n    if (!/^\\d+$/.test(decimal)) return undefined;\n    const parsed = BigInt(decimal);\n    return parsed > 0n ? parsed : undefined;\n}\n\n/**\n * Convert a decimal string into a scaled bigint (e.g. 18dp quantity, 6dp price).\n * @param raw - The raw string to parse.\n * @param scale - The scale of the number.\n * @param fieldName - The name of the field to parse.\n * @returns The parsed bigint.\n * @throws An error if the field is required and not provided.\n * @throws An error if the field is not a positive number.\n */\nexport function decimalToScaledInt(raw: string, scale: number, fieldName: string): bigint {\n    const s = (raw ?? \"\").trim();\n    if (!s) throw new Error(`${fieldName} is required`);\n    if (!/^[0-9]+(\\.[0-9]+)?$/.test(s)) throw new Error(`${fieldName} must be a positive number`);\n    const [intPartRaw, fracRaw = \"\"] = s.split(\".\");\n    if (fracRaw.length > scale) {\n        throw new Error(`${fieldName} supports at most ${scale} decimal places`);\n    }\n    const intPart = intPartRaw?.replace(/^0+/, \"\") ?? \"0\";\n    const fracPart = fracRaw.padEnd(scale, \"0\");\n    const combined = `${intPart}${fracPart}`;\n    return BigInt(combined ?? \"0\");\n}\n\n/**\n * Parse a quantity scaled to the given number of decimal places.\n * @param raw - The raw string to parse.\n * @param scale - The number of decimal places to scale to.\n * @param fieldName - The name of the field to parse.\n * @returns The parsed bigint.\n * @throws An error if the field is required and not provided.\n * @throws An error if the field is not a positive number.\n */\nexport function parseQtyScaled(raw: string, scale: number, fieldName: string): bigint {\n    return decimalToScaledInt(raw, scale, fieldName);\n}\n\n/**\n * Parse a price scaled to 6 decimal places.\n * @param raw - The raw string to parse.\n * @param fieldName - The name of the field to parse.\n * @returns The parsed bigint.\n * @throws An error if the field is required and not provided.\n * @throws An error if the field is not a positive number.\n */\nexport function parsePriceTicks(raw: string, fieldName: string): bigint {\n    return decimalToScaledInt(raw, 6, fieldName);\n}\n\n/**\n * Coerce optional UI number into non-negative bigint (e.g. caps, limits).\n * @param value - The value to coerce.\n * @returns The coerced bigint.\n */\nexport function toBigIntOrZero(value?: number | null): bigint {\n    if (value == null || Number.isNaN(value)) return 0n;\n    return BigInt(Math.max(0, Math.trunc(value)));\n}\n\n/**\n * Coerce optional UI number into non-negative integer.\n * @param value - The value to coerce.\n * @returns The coerced integer.\n */\nexport function toIntOrZero(value?: number | null): number {\n    if (value == null || Number.isNaN(value)) return 0;\n    return Math.max(0, Math.trunc(value));\n}\n\n/**\n * Coerce optional UI percentage into non-negative basis points integer.\n * @param value - The value to coerce.\n * @returns The coerced integer.\n */\nexport function toBpsOrZero(value?: number | null): number {\n    if (value == null || Number.isNaN(value)) return 0;\n    return Math.max(0, Math.trunc(value * 100));\n}\n\n/**\n * Convert basis points to percentage.\n * @param value - The value to convert.\n * @returns The converted percentage.\n */\nexport function bpsToPct(value?: number | null): number {\n    if (value == null || Number.isNaN(value)) return 0;\n    return value / 100;\n}\n"],"mappings":";;;;;AAkCA,SAAgB,iCACZ,KACA,WACkB;CAClB,MAAM,KAAK,OAAO,GAAA,CAAI,KAAK;CAC3B,IAAI,CAAC,GAAG;CACR,IAAI,CAAC,WAAW,KAAK,CAAC,GAAG,MAAM,IAAI,MAAM,GAAG,UAAU,4BAA4B;CAClF,OAAO,OAAO,CAAC;AACnB;;;;;AAuBA,SAAgB,6BACZ,OACkB;CAClB,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO,KAAA;CAClD,IAAI,OAAO,UAAU,UAAU;EAC3B,MAAM,UAAU,MAAM,KAAK;EAC3B,IAAI,CAAC,QAAQ,KAAK,OAAO,GAAG,OAAO,KAAA;EACnC,MAAM,SAAS,OAAO,OAAO;EAC7B,OAAO,OAAO,cAAc,MAAM,KAAK,SAAS,IAAI,SAAS,KAAA;CACjE;CACA,OAAO,OAAO,cAAc,KAAK,KAAK,QAAQ,IAAI,QAAQ,KAAA;AAC9D;;;;;AAMA,SAAgB,gCACZ,OACkB;CAClB,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO,KAAA;CAClD,IAAI,OAAO,UAAU,UACjB,OAAO,OAAO,cAAc,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,KAAA;CAEtE,MAAM,UAAU,MAAM,KAAK;CAC3B,IAAI,CAAC,QAAQ,KAAK,OAAO,GAAG,OAAO,KAAA;CACnC,MAAM,SAAS,OAAO,OAAO;CAC7B,OAAO,SAAS,KAAK,SAAS,KAAA;AAClC;;;;;;AAuDA,SAAgB,eAAe,OAA+B;CAC1D,IAAI,SAAS,QAAQ,OAAO,MAAM,KAAK,GAAG,OAAO;CACjD,OAAO,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC,CAAC;AAChD;;;;;;AAOA,SAAgB,YAAY,OAA+B;CACvD,IAAI,SAAS,QAAQ,OAAO,MAAM,KAAK,GAAG,OAAO;CACjD,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC;AACxC;;;;;;AAOA,SAAgB,YAAY,OAA+B;CACvD,IAAI,SAAS,QAAQ,OAAO,MAAM,KAAK,GAAG,OAAO;CACjD,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,QAAQ,GAAG,CAAC;AAC9C"}
+{"version":3,"file":"numbers.js","names":[],"sources":["../../src/utils/numbers.ts"],"sourcesContent":["// Shared numeric helpers for gRPC/Connect clients.\n\n/**\n * Parse a required uint64 encoded as a base-10 string into bigint.\n * @param raw - The raw string to parse.\n * @param fieldName - The name of the field to parse.\n * @returns The parsed bigint.\n * @throws An error if the field is required and not provided.\n * @throws An error if the field is not a positive integer.\n */\nexport function parseRequiredUint64Decimal(raw: string, fieldName: string): bigint {\n    const s = (raw ?? \"\").trim();\n    if (!s) throw new Error(`${fieldName} is required`);\n    if (!/^[0-9]+$/.test(s)) throw new Error(`${fieldName} must be a positive integer`);\n    return BigInt(s);\n}\n\n/**\n * Parse an optional uint64 encoded as a base-10 string into bigint, or undefined on invalid/empty.\n * @param raw - The raw string to parse.\n * @returns The parsed bigint, or undefined if the field is invalid or empty.\n */\nexport function parseOptionalUint64Decimal(raw: string | undefined): bigint | undefined {\n    const s = (raw ?? \"\").trim();\n    if (!s) return;\n    // For optional filters, treat invalid input as \"unset\" rather than surfacing an error.\n    if (!/^[0-9]+$/.test(s)) return;\n    return BigInt(s);\n}\n\n/**\n * Parse an optional uint64 encoded as a base-10 string into bigint.\n * Empty values are omitted, but supplied invalid values are rejected.\n */\nexport function parseOptionalUint64DecimalStrict(\n    raw: string | undefined,\n    fieldName: string,\n): bigint | undefined {\n    const s = (raw ?? \"\").trim();\n    if (!s) return;\n    if (!/^[0-9]+$/.test(s)) throw new Error(`${fieldName} must be a positive integer`);\n    return BigInt(s);\n}\n\n/**\n * Parse an optional uint64-ish value (string/number/bigint) into bigint, or undefined on invalid/empty.\n * Accepts base-10 strings, numeric inputs (truncated), and bigint inputs.\n */\nexport function parseOptionalUint64Like(\n    value: string | number | bigint | undefined | null,\n): bigint | undefined {\n    if (value === undefined || value === null) return undefined;\n    if (typeof value === \"bigint\") return value >= 0n ? value : undefined;\n    if (typeof value === \"number\") {\n        if (!Number.isFinite(value)) return undefined;\n        const n = Math.trunc(value);\n        return n >= 0 ? BigInt(n) : undefined;\n    }\n    return parseOptionalUint64Decimal(value);\n}\n\n/**\n * Parse an optional positive integer-ish value (string/number) into a number, or undefined on invalid/empty.\n * Useful for common \"limit\" fields coming from UI inputs.\n */\nexport function parseOptionalPositiveIntLike(\n    value: string | number | undefined | null,\n): number | undefined {\n    if (value === undefined || value === null) return undefined;\n    if (typeof value === \"string\") {\n        const decimal = value.trim();\n        if (!/^\\d+$/.test(decimal)) return undefined;\n        const parsed = Number(decimal);\n        return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : undefined;\n    }\n    return Number.isSafeInteger(value) && value > 0 ? value : undefined;\n}\n\n/**\n * Parse a positive integer-like value without losing precision.\n * Decimal strings may exceed JavaScript's safe-integer range; number inputs may not.\n */\nexport function parseOptionalPositiveBigIntLike(\n    value: string | number | undefined | null,\n): bigint | undefined {\n    if (value === undefined || value === null) return undefined;\n    if (typeof value === \"number\") {\n        return Number.isSafeInteger(value) && value > 0 ? BigInt(value) : undefined;\n    }\n    const decimal = value.trim();\n    if (!/^\\d+$/.test(decimal)) return undefined;\n    const parsed = BigInt(decimal);\n    return parsed > 0n ? parsed : undefined;\n}\n\n/**\n * Convert a decimal string into a scaled bigint (e.g. 18dp quantity, 6dp price).\n * @param raw - The raw string to parse.\n * @param scale - The scale of the number.\n * @param fieldName - The name of the field to parse.\n * @returns The parsed bigint.\n * @throws An error if the field is required and not provided.\n * @throws An error if the field is not a positive number.\n */\nexport function decimalToScaledInt(raw: string, scale: number, fieldName: string): bigint {\n    const s = (raw ?? \"\").trim();\n    if (!s) throw new Error(`${fieldName} is required`);\n    if (!/^[0-9]+(\\.[0-9]+)?$/.test(s)) throw new Error(`${fieldName} must be a positive number`);\n    const [intPartRaw, fracRaw = \"\"] = s.split(\".\");\n    if (fracRaw.length > scale) {\n        throw new Error(`${fieldName} supports at most ${scale} decimal places`);\n    }\n    const intPart = intPartRaw?.replace(/^0+/, \"\") ?? \"0\";\n    const fracPart = fracRaw.padEnd(scale, \"0\");\n    const combined = `${intPart}${fracPart}`;\n    return BigInt(combined ?? \"0\");\n}\n\n/**\n * Parse a quantity scaled to the given number of decimal places.\n * @param raw - The raw string to parse.\n * @param scale - The number of decimal places to scale to.\n * @param fieldName - The name of the field to parse.\n * @returns The parsed bigint.\n * @throws An error if the field is required and not provided.\n * @throws An error if the field is not a positive number.\n */\nexport function parseQtyScaled(raw: string, scale: number, fieldName: string): bigint {\n    return decimalToScaledInt(raw, scale, fieldName);\n}\n\n/**\n * Parse a price scaled to 6 decimal places.\n * @param raw - The raw string to parse.\n * @param fieldName - The name of the field to parse.\n * @returns The parsed bigint.\n * @throws An error if the field is required and not provided.\n * @throws An error if the field is not a positive number.\n */\nexport function parsePriceTicks(raw: string, fieldName: string): bigint {\n    return decimalToScaledInt(raw, 6, fieldName);\n}\n\n/**\n * Coerce optional UI number into non-negative integer.\n * @param value - The value to coerce.\n * @returns The coerced integer.\n */\nexport function toIntOrZero(value?: number | null): number {\n    if (value == null || Number.isNaN(value)) return 0;\n    return Math.max(0, Math.trunc(value));\n}\n\n/**\n * Coerce optional UI percentage into non-negative basis points integer.\n * @param value - The value to coerce.\n * @returns The coerced integer.\n */\nexport function toBpsOrZero(value?: number | null): number {\n    if (value == null || Number.isNaN(value)) return 0;\n    return Math.max(0, Math.trunc(value * 100));\n}\n\n/**\n * Convert basis points to percentage.\n * @param value - The value to convert.\n * @returns The converted percentage.\n */\nexport function bpsToPct(value?: number | null): number {\n    if (value == null || Number.isNaN(value)) return 0;\n    return value / 100;\n}\n"],"mappings":";;;;;AAkCA,SAAgB,iCACZ,KACA,WACkB;CAClB,MAAM,KAAK,OAAO,GAAA,CAAI,KAAK;CAC3B,IAAI,CAAC,GAAG;CACR,IAAI,CAAC,WAAW,KAAK,CAAC,GAAG,MAAM,IAAI,MAAM,GAAG,UAAU,4BAA4B;CAClF,OAAO,OAAO,CAAC;AACnB;;;;;AAuBA,SAAgB,6BACZ,OACkB;CAClB,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO,KAAA;CAClD,IAAI,OAAO,UAAU,UAAU;EAC3B,MAAM,UAAU,MAAM,KAAK;EAC3B,IAAI,CAAC,QAAQ,KAAK,OAAO,GAAG,OAAO,KAAA;EACnC,MAAM,SAAS,OAAO,OAAO;EAC7B,OAAO,OAAO,cAAc,MAAM,KAAK,SAAS,IAAI,SAAS,KAAA;CACjE;CACA,OAAO,OAAO,cAAc,KAAK,KAAK,QAAQ,IAAI,QAAQ,KAAA;AAC9D;;;;;AAMA,SAAgB,gCACZ,OACkB;CAClB,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO,KAAA;CAClD,IAAI,OAAO,UAAU,UACjB,OAAO,OAAO,cAAc,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,KAAA;CAEtE,MAAM,UAAU,MAAM,KAAK;CAC3B,IAAI,CAAC,QAAQ,KAAK,OAAO,GAAG,OAAO,KAAA;CACnC,MAAM,SAAS,OAAO,OAAO;CAC7B,OAAO,SAAS,KAAK,SAAS,KAAA;AAClC;;;;;;AAuDA,SAAgB,YAAY,OAA+B;CACvD,IAAI,SAAS,QAAQ,OAAO,MAAM,KAAK,GAAG,OAAO;CACjD,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC;AACxC;;;;;;AAOA,SAAgB,YAAY,OAA+B;CACvD,IAAI,SAAS,QAAQ,OAAO,MAAM,KAAK,GAAG,OAAO;CACjD,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,QAAQ,GAAG,CAAC;AAC9C"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@polyester/sdk",
-    "version": "0.14.2",
+    "version": "0.15.1",
     "private": false,
     "description": "TypeScript SDK providing access to APIs on Polyester Exchange.",
     "homepage": "https://github.com/Fabric-Labs/polyester-sdk-typescript#readme",