@polyester/sdk 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @polyester/sdk
 
+## 0.4.0
+
+### Minor Changes
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Standardize market-data limits as positive integers, reject string and invalid candle or trade limits, and require a valid orderbook heatmap limit before sending requests.
+
+### Patch Changes
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Return exact nanosecond timestamp strings and epoch-millisecond timestamps from single-order cancel and modify operations.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Preserve server-side bearer authentication when the display-session cookie is missing or invalid, and discard it when an explicit display session belongs to another environment.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Clarify that single-order cancellation acknowledges the request and requires lifecycle reconciliation, while missing targets remain not-found errors.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Document that realtime callers must wait for `onOpen` before issuing writes whose events they need to observe.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Allow transfer history to be listed without an input object and return an SDK validation error for null account-scoped inputs.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Accept Next.js-style cookie getters when creating server clients.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Reject malformed client, environment, account signer, and catalog configuration with SDK error types before constructing clients or marking catalog snapshots fresh.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Isolate synchronously thrown auth event listener errors so one failing listener cannot reject a completed auth operation or prevent later listeners from running.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Return login nonce expiration timestamps as JSON-safe epoch-millisecond numbers instead of raw protobuf timestamp objects.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Route private realtime subscription authentication failures through `onError` when provided, and throw from `subscribe()` when no error observer exists.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Return `null` from `orders.getDetails` when the backend reports that the requested order was not found.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - fix(auth): prevent malformed hex credentials from appearing in configuration error messages.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Return `false` from `isJwtValid` for non-string values instead of throwing.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Validate subaccount activity limits and balance-history ledger IDs as non-negative integers before serializing requests.
+
+- [#54](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/54) [`b1d07ad`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/b1d07ad58e7f691cbf0df32e5905bd679c1adfd6) Thanks [@huntabyte](https://github.com/huntabyte)! - Translate schema validation, authentication, RPC, and network failures into the documented `PolyesterError` hierarchy.
+
+## 0.3.1
+
+### Patch Changes
+
+- [#52](https://github.com/Fabric-Labs/polyester-sdk-typescript/pull/52) [`4d78227`](https://github.com/Fabric-Labs/polyester-sdk-typescript/commit/4d78227aa61b426e3ab8c0ac9bff6225a7865d42) Thanks [@aiiven](https://github.com/aiiven)! - feat(market-overview): expose the current multi-venue index price on market overview rows.
+
 ## 0.3.0
 
 ### Minor Changes

package/README.md

@@ -59,8 +59,30 @@ if (client.hasUsableBearerToken) {
 }
 ```
 
-The parsed cookie session is display data for hydrating UI. It is not proof of
-authentication, so the backend still authorizes every call.
+Framework cookie stores are accepted too. Await asynchronous helpers before
+passing the store. For example, with current Next.js versions:
+
+```ts
+import { cookies } from "next/headers";
+import {
+    createPolyesterServerClientFromCookies,
+    POLYESTER_TESTNET_ENVIRONMENT,
+} from "@polyester/sdk";
+
+const client = createPolyesterServerClientFromCookies({
+    cookies: await cookies(),
+    environment: POLYESTER_TESTNET_ENVIRONMENT,
+});
+```
+
+This factory accepts a `Request`, a `{ [name]: value }` record, or a synchronous
+`.get(name)` store that returns either the cookie value or an object containing
+the value.
+
+The `polyester_auth_token` bearer cookie is read independently from the
+`polyester_session_3` cookie. The latter contains unsigned display data for UI
+hydration; it is not proof of authentication. The backend still verifies the
+bearer token and authorizes every call.
 
 For machine clients, pass an Ed25519 API key provider instead of a cookie
 session:
@@ -80,28 +102,52 @@ const client = new PolyesterClient({
 
 ## Realtime
 
-Subscriptions return their own unsubscribe function. No event emitter, no
-cleanup bookkeeping.
+Subscriptions start connecting immediately and return their own unsubscribe
+function. The return value does not mean the channel is open. Wait for the first
+`onOpen` callback to avoid the initial startup gap. This does not guarantee
+delivery across a later disconnect; applications that require continuity must
+reconcile after connection gaps. `onOpen` can run again after a successful
+reconnect, so keep one-time writes outside the callback itself.
 
 ```ts
-const unsubscribe = client.orders.subscribe({
-    accountId,
-    onEvent: (order) => console.log(order.orderId, order.status),
-    onError: (ctx) => console.warn(ctx.channel, ctx.error),
+const unsubscribe = await new Promise<() => void>((resolve, reject) => {
+    let stop = () => {};
+    let pending = true;
+
+    stop = client.orders.subscribe({
+        accountId,
+        onOpen: () => {
+            if (!pending) return;
+            pending = false;
+            resolve(stop);
+        },
+        onEvent: (order) => console.log(order.orderId, order.status),
+        onError: (ctx) => {
+            console.warn(ctx.channel, ctx.error);
+            if (!pending) return;
+            pending = false;
+            stop();
+            reject(ctx.error);
+        },
+    });
 });
+
+await client.orders.create(order);
 ```
 
+Call `unsubscribe()` when the subscription is no longer needed.
+
 ## Entry points
 
-| Import | Contains |
-| --- | --- |
-| `@polyester/sdk` | clients, environments, errors, types |
-| `@polyester/sdk/errors` | error classes and codes on their own |
-| `@polyester/sdk/account-signer` | `createPolyesterAccountSigner` |
-| `@polyester/sdk/smart-account` | UserOperations and on-chain smart account calls |
-| `@polyester/sdk/catalogs` | symbol catalog and decimal scales |
-| `@polyester/sdk/server-session` | cookie parsing without the client graph |
-| `@polyester/sdk/unstable/gen` | raw protobuf types and service descriptors |
+| Import                          | Contains                                        |
+| ------------------------------- | ----------------------------------------------- |
+| `@polyester/sdk`                | clients, environments, errors, types            |
+| `@polyester/sdk/errors`         | error classes and codes on their own            |
+| `@polyester/sdk/account-signer` | `createPolyesterAccountSigner`                  |
+| `@polyester/sdk/smart-account`  | UserOperations and on-chain smart account calls |
+| `@polyester/sdk/catalogs`       | symbol catalog and decimal scales               |
+| `@polyester/sdk/server-session` | cookie parsing without the client graph         |
+| `@polyester/sdk/unstable/gen`   | raw protobuf types and service descriptors      |
 
 `account-signer` and `smart-account` are separate subpaths on purpose. Both pull
 in a large viem graph, and keeping them out of the root barrel means the app

package/dist/_virtual/_rolldown/runtime.js

@@ -1,5 +1,8 @@
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
 	for (var name in all) __defProp(target, name, {
@@ -9,5 +12,16 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 //#endregion
-export { __exportAll };
+export { __exportAll, __reExport };

package/dist/account-signer/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/account-signer/types.ts"],"mappings":";;KAGY;;;;;;;UAQK;;WAEJ;;WAGA,gBAAgB;;WAGhB,eAAe;;EAGxB,YAAY,kBAAkB,QAAQ;;;;;;KAO9B,6BAA6B,uBAAuB,QAAQ;;;;;KAM5D,sBAAsB,gBAAgB;;;;iBAKlC,uBACZ,QAAQ,sBACT,UAAU;;;;iBAsBS,qBAClB,QAAQ,kCACT,QAAQ"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/account-signer/types.ts"],"mappings":";;KAIY;;;;;;;UAQK;;WAEJ;;WAGA,gBAAgB;;WAGhB,eAAe;;EAGxB,YAAY,kBAAkB,QAAQ;;;;;;KAO9B,6BAA6B,uBAAuB,QAAQ;;;;;KAM5D,sBAAsB,gBAAgB;;;;iBAKlC,uBACZ,QAAQ,sBACT,UAAU;;;;iBA4BS,qBAClB,QAAQ,kCACT,QAAQ"}

package/dist/account-signer/types.js

@@ -1,3 +1,4 @@
+import { ConfigurationError } from "../shared/errors.js";
 import { isEvmAddress } from "../utils/evm.js";
 //#region src/account-signer/types.ts
 /**
@@ -10,9 +11,11 @@ function isAccountSignerFactory(config) {
 * Asserts that a value implements the account signer contract.
 */
 function assertAccountSigner(value) {
-	if (!value.environmentFingerprint) throw new Error("Account signer must include an environmentFingerprint.");
-	if (!isEvmAddress(value.accountAddress)) throw new Error("Account signer must include a valid accountAddress.");
-	if (value.ownerAddress && !isEvmAddress(value.ownerAddress)) throw new Error("Account signer ownerAddress must be a valid address.");
+	if (typeof value !== "object" || value === null) throw new ConfigurationError("Account signer must be an object or factory function.");
+	if (!value.environmentFingerprint) throw new ConfigurationError("Account signer must include an environmentFingerprint.");
+	if (!isEvmAddress(value.accountAddress)) throw new ConfigurationError("Account signer must include a valid accountAddress.");
+	if (value.ownerAddress && !isEvmAddress(value.ownerAddress)) throw new ConfigurationError("Account signer ownerAddress must be a valid address.");
+	if (typeof value.signMessage !== "function") throw new ConfigurationError("Account signer must include a signMessage function.");
 }
 /**
 * Helper to resolve an account signer from config.

package/dist/account-signer/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/account-signer/types.ts"],"sourcesContent":["import type { Hex } from \"viem\";\nimport { isEvmAddress } from \"../utils/evm.js\";\n\nexport type HexAddress = `0x${string}`;\n\n/**\n * Minimal account signer interface for SDK operations.\n *\n * The SDK authenticates the Polyester smart account address. The owner address\n * is optional metadata about the EOA or custody provider that controls it.\n */\nexport interface AccountSigner {\n    /** Fingerprint of the PolyesterEnvironment this signer was created for */\n    readonly environmentFingerprint: string;\n\n    /** The smart account address (used for authentication and trading) */\n    readonly accountAddress: HexAddress;\n\n    /** The owner/EOA address (optional metadata about the controlling signer) */\n    readonly ownerAddress?: HexAddress;\n\n    /** Sign a message and return the signature */\n    signMessage(message: string): Promise<Hex>;\n}\n\n/**\n * Factory function type for lazy account signer initialization.\n * Useful when the signer might not be available at client creation time.\n */\nexport type AccountSignerFactory = () => AccountSigner | null | Promise<AccountSigner | null>;\n\n/**\n * Account signer configuration for the client.\n * Can be a signer instance or a factory for lazy initialization.\n */\nexport type AccountSignerConfig = AccountSigner | AccountSignerFactory;\n\n/**\n * Helper to check if an account signer config is a factory function.\n */\nexport function isAccountSignerFactory(\n    config: AccountSignerConfig,\n): config is AccountSignerFactory {\n    return typeof config === \"function\";\n}\n\n/**\n * Asserts that a value implements the account signer contract.\n */\nexport function assertAccountSigner(value: AccountSigner): void {\n    if (!value.environmentFingerprint) {\n        throw new Error(\"Account signer must include an environmentFingerprint.\");\n    }\n    if (!isEvmAddress(value.accountAddress)) {\n        throw new Error(\"Account signer must include a valid accountAddress.\");\n    }\n    if (value.ownerAddress && !isEvmAddress(value.ownerAddress)) {\n        throw new Error(\"Account signer ownerAddress must be a valid address.\");\n    }\n}\n\n/**\n * Helper to resolve an account signer from config.\n */\nexport async function resolveAccountSigner(\n    config: AccountSignerConfig | undefined,\n): Promise<AccountSigner | null> {\n    if (!config) return null;\n    const accountSigner = isAccountSignerFactory(config) ? await config() : config;\n    if (accountSigner) assertAccountSigner(accountSigner);\n    return accountSigner;\n}\n"],"mappings":";;;;;AAwCA,SAAgB,uBACZ,QAC8B;CAC9B,OAAO,OAAO,WAAW;AAC7B;;;;AAKA,SAAgB,oBAAoB,OAA4B;CAC5D,IAAI,CAAC,MAAM,wBACP,MAAM,IAAI,MAAM,wDAAwD;CAE5E,IAAI,CAAC,aAAa,MAAM,cAAc,GAClC,MAAM,IAAI,MAAM,qDAAqD;CAEzE,IAAI,MAAM,gBAAgB,CAAC,aAAa,MAAM,YAAY,GACtD,MAAM,IAAI,MAAM,sDAAsD;AAE9E;;;;AAKA,eAAsB,qBAClB,QAC6B;CAC7B,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,gBAAgB,uBAAuB,MAAM,IAAI,MAAM,OAAO,IAAI;CACxE,IAAI,eAAe,oBAAoB,aAAa;CACpD,OAAO;AACX"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/account-signer/types.ts"],"sourcesContent":["import type { Hex } from \"viem\";\nimport { isEvmAddress } from \"../utils/evm.js\";\nimport { ConfigurationError } from \"../shared/errors.js\";\n\nexport type HexAddress = `0x${string}`;\n\n/**\n * Minimal account signer interface for SDK operations.\n *\n * The SDK authenticates the Polyester smart account address. The owner address\n * is optional metadata about the EOA or custody provider that controls it.\n */\nexport interface AccountSigner {\n    /** Fingerprint of the PolyesterEnvironment this signer was created for */\n    readonly environmentFingerprint: string;\n\n    /** The smart account address (used for authentication and trading) */\n    readonly accountAddress: HexAddress;\n\n    /** The owner/EOA address (optional metadata about the controlling signer) */\n    readonly ownerAddress?: HexAddress;\n\n    /** Sign a message and return the signature */\n    signMessage(message: string): Promise<Hex>;\n}\n\n/**\n * Factory function type for lazy account signer initialization.\n * Useful when the signer might not be available at client creation time.\n */\nexport type AccountSignerFactory = () => AccountSigner | null | Promise<AccountSigner | null>;\n\n/**\n * Account signer configuration for the client.\n * Can be a signer instance or a factory for lazy initialization.\n */\nexport type AccountSignerConfig = AccountSigner | AccountSignerFactory;\n\n/**\n * Helper to check if an account signer config is a factory function.\n */\nexport function isAccountSignerFactory(\n    config: AccountSignerConfig,\n): config is AccountSignerFactory {\n    return typeof config === \"function\";\n}\n\n/**\n * Asserts that a value implements the account signer contract.\n */\nexport function assertAccountSigner(value: AccountSigner): void {\n    if (typeof value !== \"object\" || value === null) {\n        throw new ConfigurationError(\"Account signer must be an object or factory function.\");\n    }\n    if (!value.environmentFingerprint) {\n        throw new ConfigurationError(\"Account signer must include an environmentFingerprint.\");\n    }\n    if (!isEvmAddress(value.accountAddress)) {\n        throw new ConfigurationError(\"Account signer must include a valid accountAddress.\");\n    }\n    if (value.ownerAddress && !isEvmAddress(value.ownerAddress)) {\n        throw new ConfigurationError(\"Account signer ownerAddress must be a valid address.\");\n    }\n    if (typeof value.signMessage !== \"function\") {\n        throw new ConfigurationError(\"Account signer must include a signMessage function.\");\n    }\n}\n\n/**\n * Helper to resolve an account signer from config.\n */\nexport async function resolveAccountSigner(\n    config: AccountSignerConfig | undefined,\n): Promise<AccountSigner | null> {\n    if (!config) return null;\n    const accountSigner = isAccountSignerFactory(config) ? await config() : config;\n    if (accountSigner) assertAccountSigner(accountSigner);\n    return accountSigner;\n}\n"],"mappings":";;;;;;AAyCA,SAAgB,uBACZ,QAC8B;CAC9B,OAAO,OAAO,WAAW;AAC7B;;;;AAKA,SAAgB,oBAAoB,OAA4B;CAC5D,IAAI,OAAO,UAAU,YAAY,UAAU,MACvC,MAAM,IAAI,mBAAmB,uDAAuD;CAExF,IAAI,CAAC,MAAM,wBACP,MAAM,IAAI,mBAAmB,wDAAwD;CAEzF,IAAI,CAAC,aAAa,MAAM,cAAc,GAClC,MAAM,IAAI,mBAAmB,qDAAqD;CAEtF,IAAI,MAAM,gBAAgB,CAAC,aAAa,MAAM,YAAY,GACtD,MAAM,IAAI,mBAAmB,sDAAsD;CAEvF,IAAI,OAAO,MAAM,gBAAgB,YAC7B,MAAM,IAAI,mBAAmB,qDAAqD;AAE1F;;;;AAKA,eAAsB,qBAClB,QAC6B;CAC7B,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,gBAAgB,uBAAuB,MAAM,IAAI,MAAM,OAAO,IAAI;CACxE,IAAI,eAAe,oBAAoB,aAAa;CACpD,OAAO;AACX"}

package/dist/browser-client.d.ts

@@ -4,7 +4,9 @@ import { PolyesterClient, PolyesterClientBaseConfig } from "./core-client.js";
 import { AuthTokenStorage } from "./services/auth/token-storage.js";
 import { AccountSignerAuthService } from "./services/auth/account-signer-auth.js";
 //#region src/browser-client.d.ts
-interface PolyesterBrowserClientConfig extends Omit<PolyesterClientBaseConfig, "auth"> {
+type BrowserClientBaseConfig<TConfig> = TConfig extends PolyesterClientBaseConfig ? Omit<TConfig, "auth"> : never;
+/** Configuration for the browser Polyester client. */
+type PolyesterBrowserClientConfig = BrowserClientBaseConfig<PolyesterClientBaseConfig> & {
   /**
    * Account signer interface for authentication.
    * Pass a signer object or a factory function for lazy initialization.
@@ -15,7 +17,7 @@ interface PolyesterBrowserClientConfig extends Omit<PolyesterClientBaseConfig, "
    * Use createCookieAuthTokenStorage() to opt into reload/SSR persistence.
    */
   tokenStorage?: AuthTokenStorage;
-}
+};
 /**
  * A client for interacting with the Polyester DEX in the browser.
  */

package/dist/browser-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-client.d.ts","names":[],"sources":["../src/browser-client.ts"],"mappings":";;;;;;UAUiB,qCAAqC,KAAK;;;;;EAKvD,gBAAgB;;;;;EAKhB,eAAe;;;;;cAMN,+BAA+B;MAI3B,QAAQ;EAIT,YAAA,QAAQ;;;;;YA0CD,4BAA4B;;;;EAiB/C,iBAAiB,eAAe"}
+{"version":3,"file":"browser-client.d.ts","names":[],"sources":["../src/browser-client.ts"],"mappings":";;;;;;KAeK,wBAAwB,WAAW,gBAAgB,4BAClD,KAAK;;KAIC,+BAA+B,wBAAwB;;;;;EAK/D,gBAAgB;;;;;EAKhB,eAAe;;;;;cAMN,+BAA+B;MAI3B,QAAQ;EAIT,YAAA,QAAQ;;;;;YAyCD,4BAA4B;;;;EAiB/C,iBAAiB,eAAe"}

package/dist/browser-client.js

@@ -1,4 +1,4 @@
-import { PolyesterClient } from "./core-client.js";
+import { PolyesterClient, parsePolyesterClientConfig, pickPolyesterCatalogConfig } from "./core-client.js";
 import { AuthSessionStore } from "./services/auth/session.js";
 import { createMemoryAuthTokenStorage } from "./services/auth/token-storage.js";
 import { AccountSignerAuthService } from "./services/auth/account-signer-auth.js";
@@ -11,6 +11,7 @@ var PolyesterBrowserClient = class extends PolyesterClient {
 		return super.auth;
 	}
 	constructor(config) {
+		config = parsePolyesterClientConfig(config);
 		const tokenStorage = config.tokenStorage ?? createMemoryAuthTokenStorage();
 		const sessionStore = new AuthSessionStore({ environmentFingerprint: config.environment.fingerprint });
 		const getToken = () => sessionStore.getEnvironmentBoundToken(tokenStorage);
@@ -22,9 +23,7 @@ var PolyesterBrowserClient = class extends PolyesterClient {
 				getToken
 			},
 			wireFormat: config.wireFormat,
-			catalog: config.catalog,
-			catalogSnapshot: config.catalogSnapshot,
-			catalogCell: config.catalogCell,
+			...pickPolyesterCatalogConfig(config),
 			transports: config.transports,
 			realtimeClient: config.realtimeClient,
 			realtime: {

package/dist/browser-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-client.js","names":[],"sources":["../src/browser-client.ts"],"sourcesContent":["import { PolyesterClient, type PolyesterClientBaseConfig } from \"./core-client.js\";\nimport { AccountSignerAuthService } from \"./services/auth/account-signer-auth.js\";\nimport type { AccountSignerConfig, AccountSigner } from \"./account-signer/types.js\";\nimport type { SubaccountResolver } from \"./services/subaccount-resolver.js\";\nimport {\n    createMemoryAuthTokenStorage,\n    type AuthTokenStorage,\n} from \"./services/auth/token-storage.js\";\nimport { AuthSessionStore } from \"./services/auth/session.js\";\n\nexport interface PolyesterBrowserClientConfig extends Omit<PolyesterClientBaseConfig, \"auth\"> {\n    /**\n     * Account signer interface for authentication.\n     * Pass a signer object or a factory function for lazy initialization.\n     */\n    accountSigner?: AccountSignerConfig;\n    /**\n     * Storage for browser bearer tokens. Defaults to per-client memory storage.\n     * Use createCookieAuthTokenStorage() to opt into reload/SSR persistence.\n     */\n    tokenStorage?: AuthTokenStorage;\n}\n\n/**\n * A client for interacting with the Polyester DEX in the browser.\n */\nexport class PolyesterBrowserClient extends PolyesterClient {\n    // The base class builds `auth` through the `createAuth` runtime factory we\n    // pass below, so the lazily-constructed instance is always an\n    // AccountSignerAuthService — this override only narrows the type.\n    override get auth(): AccountSignerAuthService {\n        return super.auth as AccountSignerAuthService;\n    }\n\n    constructor(config: PolyesterBrowserClientConfig) {\n        const tokenStorage = config.tokenStorage ?? createMemoryAuthTokenStorage();\n        const sessionStore = new AuthSessionStore({\n            environmentFingerprint: config.environment.fingerprint,\n        });\n        const getToken = () => sessionStore.getEnvironmentBoundToken(tokenStorage);\n\n        super(\n            {\n                environment: config.environment,\n                interceptors: config.interceptors,\n                auth: { kind: \"jwt\", getToken },\n                wireFormat: config.wireFormat,\n                catalog: config.catalog,\n                catalogSnapshot: config.catalogSnapshot,\n                catalogCell: config.catalogCell,\n                transports: config.transports,\n                realtimeClient: config.realtimeClient,\n                realtime: {\n                    hasAuth: () => !!getToken(),\n                    ...config.realtime,\n                },\n            },\n            {\n                createAuth: ({ transports, realtime, subaccounts, environment }) =>\n                    new AccountSignerAuthService({\n                        transports,\n                        accountSignerConfig: config.accountSigner,\n                        environment,\n                        subaccounts,\n                        realtime,\n                        tokenStorage,\n                        sessionStore,\n                    }),\n            },\n        );\n    }\n\n    /**\n     * Creates a resolver that defaults subaccountId to the active subaccount.\n     * The getter is called lazily when service methods are invoked.\n     */\n    protected override createSubaccountResolver(): SubaccountResolver {\n        return {\n            getDefaultSubaccountId: () => {\n                const state = this.auth.getState();\n                if (state.activeAccount && !state.activeAccount.isMain) {\n                    return state.activeAccount.accountId;\n                }\n                return null;\n            },\n            getActiveAccountId: () => this.auth.getState().activeAccount?.accountId ?? null,\n            getMainAccountId: () => this.auth.getState().mainAccountId ?? null,\n        };\n    }\n\n    /**\n     * Sets the account signer used for authenticated browser requests.\n     */\n    setAccountSigner(accountSigner: AccountSigner | null): void {\n        this.auth.setAccountSigner(accountSigner);\n    }\n}\n"],"mappings":";;;;;;;;AA0BA,IAAa,yBAAb,cAA4C,gBAAgB;CAIxD,IAAa,OAAiC;EAC1C,OAAO,MAAM;CACjB;CAEA,YAAY,QAAsC;EAC9C,MAAM,eAAe,OAAO,gBAAgB,6BAA6B;EACzE,MAAM,eAAe,IAAI,iBAAiB,EACtC,wBAAwB,OAAO,YAAY,YAC/C,CAAC;EACD,MAAM,iBAAiB,aAAa,yBAAyB,YAAY;EAEzE,MACI;GACI,aAAa,OAAO;GACpB,cAAc,OAAO;GACrB,MAAM;IAAE,MAAM;IAAO;GAAS;GAC9B,YAAY,OAAO;GACnB,SAAS,OAAO;GAChB,iBAAiB,OAAO;GACxB,aAAa,OAAO;GACpB,YAAY,OAAO;GACnB,gBAAgB,OAAO;GACvB,UAAU;IACN,eAAe,CAAC,CAAC,SAAS;IAC1B,GAAG,OAAO;GACd;EACJ,GACA,EACI,aAAa,EAAE,YAAY,UAAU,aAAa,kBAC9C,IAAI,yBAAyB;GACzB;GACA,qBAAqB,OAAO;GAC5B;GACA;GACA;GACA;GACA;EACJ,CAAC,EACT,CACJ;CACJ;;;;;CAMA,2BAAkE;EAC9D,OAAO;GACH,8BAA8B;IAC1B,MAAM,QAAQ,KAAK,KAAK,SAAS;IACjC,IAAI,MAAM,iBAAiB,CAAC,MAAM,cAAc,QAC5C,OAAO,MAAM,cAAc;IAE/B,OAAO;GACX;GACA,0BAA0B,KAAK,KAAK,SAAS,CAAC,CAAC,eAAe,aAAa;GAC3E,wBAAwB,KAAK,KAAK,SAAS,CAAC,CAAC,iBAAiB;EAClE;CACJ;;;;CAKA,iBAAiB,eAA2C;EACxD,KAAK,KAAK,iBAAiB,aAAa;CAC5C;AACJ"}
+{"version":3,"file":"browser-client.js","names":[],"sources":["../src/browser-client.ts"],"sourcesContent":["import {\n    parsePolyesterClientConfig,\n    pickPolyesterCatalogConfig,\n    PolyesterClient,\n    type PolyesterClientBaseConfig,\n} from \"./core-client.js\";\nimport { AccountSignerAuthService } from \"./services/auth/account-signer-auth.js\";\nimport type { AccountSignerConfig, AccountSigner } from \"./account-signer/types.js\";\nimport type { SubaccountResolver } from \"./services/subaccount-resolver.js\";\nimport {\n    createMemoryAuthTokenStorage,\n    type AuthTokenStorage,\n} from \"./services/auth/token-storage.js\";\nimport { AuthSessionStore } from \"./services/auth/session.js\";\n\ntype BrowserClientBaseConfig<TConfig> = TConfig extends PolyesterClientBaseConfig\n    ? Omit<TConfig, \"auth\">\n    : never;\n\n/** Configuration for the browser Polyester client. */\nexport type PolyesterBrowserClientConfig = BrowserClientBaseConfig<PolyesterClientBaseConfig> & {\n    /**\n     * Account signer interface for authentication.\n     * Pass a signer object or a factory function for lazy initialization.\n     */\n    accountSigner?: AccountSignerConfig;\n    /**\n     * Storage for browser bearer tokens. Defaults to per-client memory storage.\n     * Use createCookieAuthTokenStorage() to opt into reload/SSR persistence.\n     */\n    tokenStorage?: AuthTokenStorage;\n};\n\n/**\n * A client for interacting with the Polyester DEX in the browser.\n */\nexport class PolyesterBrowserClient extends PolyesterClient {\n    // The base class builds `auth` through the `createAuth` runtime factory we\n    // pass below, so the lazily-constructed instance is always an\n    // AccountSignerAuthService — this override only narrows the type.\n    override get auth(): AccountSignerAuthService {\n        return super.auth as AccountSignerAuthService;\n    }\n\n    constructor(config: PolyesterBrowserClientConfig) {\n        config = parsePolyesterClientConfig(config);\n        const tokenStorage = config.tokenStorage ?? createMemoryAuthTokenStorage();\n        const sessionStore = new AuthSessionStore({\n            environmentFingerprint: config.environment.fingerprint,\n        });\n        const getToken = () => sessionStore.getEnvironmentBoundToken(tokenStorage);\n\n        super(\n            {\n                environment: config.environment,\n                interceptors: config.interceptors,\n                auth: { kind: \"jwt\", getToken },\n                wireFormat: config.wireFormat,\n                ...pickPolyesterCatalogConfig(config),\n                transports: config.transports,\n                realtimeClient: config.realtimeClient,\n                realtime: {\n                    hasAuth: () => !!getToken(),\n                    ...config.realtime,\n                },\n            },\n            {\n                createAuth: ({ transports, realtime, subaccounts, environment }) =>\n                    new AccountSignerAuthService({\n                        transports,\n                        accountSignerConfig: config.accountSigner,\n                        environment,\n                        subaccounts,\n                        realtime,\n                        tokenStorage,\n                        sessionStore,\n                    }),\n            },\n        );\n    }\n\n    /**\n     * Creates a resolver that defaults subaccountId to the active subaccount.\n     * The getter is called lazily when service methods are invoked.\n     */\n    protected override createSubaccountResolver(): SubaccountResolver {\n        return {\n            getDefaultSubaccountId: () => {\n                const state = this.auth.getState();\n                if (state.activeAccount && !state.activeAccount.isMain) {\n                    return state.activeAccount.accountId;\n                }\n                return null;\n            },\n            getActiveAccountId: () => this.auth.getState().activeAccount?.accountId ?? null,\n            getMainAccountId: () => this.auth.getState().mainAccountId ?? null,\n        };\n    }\n\n    /**\n     * Sets the account signer used for authenticated browser requests.\n     */\n    setAccountSigner(accountSigner: AccountSigner | null): void {\n        this.auth.setAccountSigner(accountSigner);\n    }\n}\n"],"mappings":";;;;;;;;AAoCA,IAAa,yBAAb,cAA4C,gBAAgB;CAIxD,IAAa,OAAiC;EAC1C,OAAO,MAAM;CACjB;CAEA,YAAY,QAAsC;EAC9C,SAAS,2BAA2B,MAAM;EAC1C,MAAM,eAAe,OAAO,gBAAgB,6BAA6B;EACzE,MAAM,eAAe,IAAI,iBAAiB,EACtC,wBAAwB,OAAO,YAAY,YAC/C,CAAC;EACD,MAAM,iBAAiB,aAAa,yBAAyB,YAAY;EAEzE,MACI;GACI,aAAa,OAAO;GACpB,cAAc,OAAO;GACrB,MAAM;IAAE,MAAM;IAAO;GAAS;GAC9B,YAAY,OAAO;GACnB,GAAG,2BAA2B,MAAM;GACpC,YAAY,OAAO;GACnB,gBAAgB,OAAO;GACvB,UAAU;IACN,eAAe,CAAC,CAAC,SAAS;IAC1B,GAAG,OAAO;GACd;EACJ,GACA,EACI,aAAa,EAAE,YAAY,UAAU,aAAa,kBAC9C,IAAI,yBAAyB;GACzB;GACA,qBAAqB,OAAO;GAC5B;GACA;GACA;GACA;GACA;EACJ,CAAC,EACT,CACJ;CACJ;;;;;CAMA,2BAAkE;EAC9D,OAAO;GACH,8BAA8B;IAC1B,MAAM,QAAQ,KAAK,KAAK,SAAS;IACjC,IAAI,MAAM,iBAAiB,CAAC,MAAM,cAAc,QAC5C,OAAO,MAAM,cAAc;IAE/B,OAAO;GACX;GACA,0BAA0B,KAAK,KAAK,SAAS,CAAC,CAAC,eAAe,aAAa;GAC3E,wBAAwB,KAAK,KAAK,SAAS,CAAC,CAAC,iBAAiB;EAClE;CACJ;;;;CAKA,iBAAiB,eAA2C;EACxD,KAAK,KAAK,iBAAiB,aAAa;CAC5C;AACJ"}

package/dist/catalogs/client-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-catalog.d.ts","names":[],"sources":["../../src/catalogs/client-catalog.ts"],"mappings":";;iBAWgB,uBAAuB,UAAS,gCAAqC"}
+{"version":3,"file":"client-catalog.d.ts","names":[],"sources":["../../src/catalogs/client-catalog.ts"],"mappings":";;iBAagB,uBAAuB,UAAS,gCAAqC"}

package/dist/catalogs/client-catalog.js

@@ -1,16 +1,22 @@
+import { ConfigurationError } from "../shared/errors.js";
 import { CatalogNotReadyError } from "./types.js";
+import { parseCatalogSnapshot } from "./snapshot-validation.js";
 import { createReader } from "./readers.js";
 import { buildCatalogSnapshot } from "./snapshot.js";
 //#region src/catalogs/client-catalog.ts
 function createPolyesterCatalog(options = {}) {
+	if (typeof options !== "object" || options === null || Array.isArray(options)) throw new ConfigurationError("Catalog options must be an object.");
 	const cell = options.cell;
 	let local = void 0;
-	const getCurrent = () => cell ? cell.get() : local;
+	const getCurrent = () => {
+		const current = cell ? cell.get() : local;
+		return current === void 0 ? void 0 : parseCatalogSnapshot(current);
+	};
 	const setCurrent = (snapshot) => {
 		if (cell) cell.set(snapshot);
 		else local = snapshot;
 	};
-	if (options.snapshot && !getCurrent()) setCurrent(options.snapshot);
+	if (options.snapshot !== void 0 && !getCurrent()) setCurrent(parseCatalogSnapshot(options.snapshot));
 	const initial = getCurrent();
 	let stateValue = initial ? {
 		status: "fresh",
@@ -24,10 +30,11 @@ function createPolyesterCatalog(options = {}) {
 	});
 	const currentSource = () => getCurrent()?.source ?? "empty";
 	function setSnapshot(snapshot) {
-		setCurrent(snapshot);
+		const parsed = parseCatalogSnapshot(snapshot);
+		setCurrent(parsed);
 		stateValue = {
 			status: "fresh",
-			source: snapshot.source
+			source: parsed.source
 		};
 	}
 	function refresh() {

package/dist/catalogs/client-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-catalog.js","names":[],"sources":["../../src/catalogs/client-catalog.ts"],"sourcesContent":["import { createReader } from \"./readers.js\";\nimport { buildCatalogSnapshot } from \"./snapshot.js\";\nimport type {\n    CatalogSnapshot,\n    CatalogState,\n    CatalogStateSource,\n    ClientCatalog,\n    CreatePolyesterCatalogOptions,\n} from \"./types.js\";\nimport { CatalogNotReadyError } from \"./types.js\";\n\nexport function createPolyesterCatalog(options: CreatePolyesterCatalogOptions = {}): ClientCatalog {\n    const cell = options.cell;\n    let local: CatalogSnapshot | undefined = undefined;\n    const getCurrent = (): CatalogSnapshot | undefined => (cell ? cell.get() : local);\n    const setCurrent = (snapshot: CatalogSnapshot): void => {\n        if (cell) cell.set(snapshot);\n        else local = snapshot;\n    };\n    if (options.snapshot && !getCurrent()) setCurrent(options.snapshot);\n\n    const initial = getCurrent();\n    let stateValue: CatalogState = initial\n        ? { status: \"fresh\", source: initial.source }\n        : { status: \"empty\" };\n    let refreshInFlight: Promise<CatalogSnapshot> | undefined;\n\n    const reader = createReader(() => {\n        const current = getCurrent();\n        if (!current) throw new CatalogNotReadyError();\n        return current;\n    });\n\n    const currentSource = (): CatalogStateSource => getCurrent()?.source ?? \"empty\";\n\n    function setSnapshot(snapshot: CatalogSnapshot): void {\n        setCurrent(snapshot);\n        stateValue = { status: \"fresh\", source: snapshot.source };\n    }\n\n    function refresh(): Promise<CatalogSnapshot> {\n        if (options.refresh === false || options.refresh === undefined) {\n            const current = getCurrent();\n            if (!current) return Promise.reject(new CatalogNotReadyError());\n            return Promise.resolve(current);\n        }\n        if (refreshInFlight) return refreshInFlight;\n\n        stateValue = { status: \"refreshing\", previousSource: currentSource() };\n        refreshInFlight = Promise.all([options.refresh.market(), options.refresh.zipper()])\n            .then(([marketSeed, zipperSeed]) => {\n                const snapshot = buildCatalogSnapshot({\n                    market: marketSeed,\n                    zipper: zipperSeed,\n                    source: \"api\",\n                    version: (getCurrent()?.version ?? 0) + 1,\n                });\n                setSnapshot(snapshot);\n                return snapshot;\n            })\n            .catch((error) => {\n                stateValue = { status: \"stale\", source: currentSource(), error };\n                throw error;\n            })\n            .finally(() => {\n                refreshInFlight = undefined;\n            });\n\n        return refreshInFlight;\n    }\n\n    function ready(): Promise<CatalogSnapshot | null> {\n        const current = getCurrent();\n        if (current) return Promise.resolve(current);\n        if (refreshInFlight) return refreshInFlight.catch(() => getCurrent() ?? null);\n        return Promise.resolve(null);\n    }\n\n    function ensureReady(): Promise<CatalogSnapshot> {\n        const current = getCurrent();\n        if (current) return Promise.resolve(current);\n        return refreshInFlight ?? refresh();\n    }\n\n    return {\n        ...reader,\n        state: () => stateValue,\n        ready,\n        ensureReady,\n        refresh,\n        setSnapshot,\n    };\n}\n"],"mappings":";;;;AAWA,SAAgB,uBAAuB,UAAyC,CAAC,GAAkB;CAC/F,MAAM,OAAO,QAAQ;CACrB,IAAI,QAAqC,KAAA;CACzC,MAAM,mBAAiD,OAAO,KAAK,IAAI,IAAI;CAC3E,MAAM,cAAc,aAAoC;EACpD,IAAI,MAAM,KAAK,IAAI,QAAQ;OACtB,QAAQ;CACjB;CACA,IAAI,QAAQ,YAAY,CAAC,WAAW,GAAG,WAAW,QAAQ,QAAQ;CAElE,MAAM,UAAU,WAAW;CAC3B,IAAI,aAA2B,UACzB;EAAE,QAAQ;EAAS,QAAQ,QAAQ;CAAO,IAC1C,EAAE,QAAQ,QAAQ;CACxB,IAAI;CAEJ,MAAM,SAAS,mBAAmB;EAC9B,MAAM,UAAU,WAAW;EAC3B,IAAI,CAAC,SAAS,MAAM,IAAI,qBAAqB;EAC7C,OAAO;CACX,CAAC;CAED,MAAM,sBAA0C,WAAW,CAAC,EAAE,UAAU;CAExE,SAAS,YAAY,UAAiC;EAClD,WAAW,QAAQ;EACnB,aAAa;GAAE,QAAQ;GAAS,QAAQ,SAAS;EAAO;CAC5D;CAEA,SAAS,UAAoC;EACzC,IAAI,QAAQ,YAAY,SAAS,QAAQ,YAAY,KAAA,GAAW;GAC5D,MAAM,UAAU,WAAW;GAC3B,IAAI,CAAC,SAAS,OAAO,QAAQ,OAAO,IAAI,qBAAqB,CAAC;GAC9D,OAAO,QAAQ,QAAQ,OAAO;EAClC;EACA,IAAI,iBAAiB,OAAO;EAE5B,aAAa;GAAE,QAAQ;GAAc,gBAAgB,cAAc;EAAE;EACrE,kBAAkB,QAAQ,IAAI,CAAC,QAAQ,QAAQ,OAAO,GAAG,QAAQ,QAAQ,OAAO,CAAC,CAAC,CAAC,CAC9E,MAAM,CAAC,YAAY,gBAAgB;GAChC,MAAM,WAAW,qBAAqB;IAClC,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU,WAAW,CAAC,EAAE,WAAW,KAAK;GAC5C,CAAC;GACD,YAAY,QAAQ;GACpB,OAAO;EACX,CAAC,CAAC,CACD,OAAO,UAAU;GACd,aAAa;IAAE,QAAQ;IAAS,QAAQ,cAAc;IAAG;GAAM;GAC/D,MAAM;EACV,CAAC,CAAC,CACD,cAAc;GACX,kBAAkB,KAAA;EACtB,CAAC;EAEL,OAAO;CACX;CAEA,SAAS,QAAyC;EAC9C,MAAM,UAAU,WAAW;EAC3B,IAAI,SAAS,OAAO,QAAQ,QAAQ,OAAO;EAC3C,IAAI,iBAAiB,OAAO,gBAAgB,YAAY,WAAW,KAAK,IAAI;EAC5E,OAAO,QAAQ,QAAQ,IAAI;CAC/B;CAEA,SAAS,cAAwC;EAC7C,MAAM,UAAU,WAAW;EAC3B,IAAI,SAAS,OAAO,QAAQ,QAAQ,OAAO;EAC3C,OAAO,mBAAmB,QAAQ;CACtC;CAEA,OAAO;EACH,GAAG;EACH,aAAa;EACb;EACA;EACA;EACA;CACJ;AACJ"}
+{"version":3,"file":"client-catalog.js","names":[],"sources":["../../src/catalogs/client-catalog.ts"],"sourcesContent":["import { createReader } from \"./readers.js\";\nimport { buildCatalogSnapshot } from \"./snapshot.js\";\nimport type {\n    CatalogSnapshot,\n    CatalogState,\n    CatalogStateSource,\n    ClientCatalog,\n    CreatePolyesterCatalogOptions,\n} from \"./types.js\";\nimport { CatalogNotReadyError } from \"./types.js\";\nimport { ConfigurationError } from \"../shared/errors.js\";\nimport { parseCatalogSnapshot } from \"./snapshot-validation.js\";\n\nexport function createPolyesterCatalog(options: CreatePolyesterCatalogOptions = {}): ClientCatalog {\n    if (typeof options !== \"object\" || options === null || Array.isArray(options)) {\n        throw new ConfigurationError(\"Catalog options must be an object.\");\n    }\n    const cell = options.cell;\n    let local: CatalogSnapshot | undefined = undefined;\n    const getCurrent = (): CatalogSnapshot | undefined => {\n        const current = cell ? cell.get() : local;\n        return current === undefined ? undefined : parseCatalogSnapshot(current);\n    };\n    const setCurrent = (snapshot: CatalogSnapshot): void => {\n        if (cell) cell.set(snapshot);\n        else local = snapshot;\n    };\n    if (options.snapshot !== undefined && !getCurrent()) {\n        setCurrent(parseCatalogSnapshot(options.snapshot));\n    }\n\n    const initial = getCurrent();\n    let stateValue: CatalogState = initial\n        ? { status: \"fresh\", source: initial.source }\n        : { status: \"empty\" };\n    let refreshInFlight: Promise<CatalogSnapshot> | undefined;\n\n    const reader = createReader(() => {\n        const current = getCurrent();\n        if (!current) throw new CatalogNotReadyError();\n        return current;\n    });\n\n    const currentSource = (): CatalogStateSource => getCurrent()?.source ?? \"empty\";\n\n    function setSnapshot(snapshot: CatalogSnapshot): void {\n        const parsed = parseCatalogSnapshot(snapshot);\n        setCurrent(parsed);\n        stateValue = { status: \"fresh\", source: parsed.source };\n    }\n\n    function refresh(): Promise<CatalogSnapshot> {\n        if (options.refresh === false || options.refresh === undefined) {\n            const current = getCurrent();\n            if (!current) return Promise.reject(new CatalogNotReadyError());\n            return Promise.resolve(current);\n        }\n        if (refreshInFlight) return refreshInFlight;\n\n        stateValue = { status: \"refreshing\", previousSource: currentSource() };\n        refreshInFlight = Promise.all([options.refresh.market(), options.refresh.zipper()])\n            .then(([marketSeed, zipperSeed]) => {\n                const snapshot = buildCatalogSnapshot({\n                    market: marketSeed,\n                    zipper: zipperSeed,\n                    source: \"api\",\n                    version: (getCurrent()?.version ?? 0) + 1,\n                });\n                setSnapshot(snapshot);\n                return snapshot;\n            })\n            .catch((error) => {\n                stateValue = { status: \"stale\", source: currentSource(), error };\n                throw error;\n            })\n            .finally(() => {\n                refreshInFlight = undefined;\n            });\n\n        return refreshInFlight;\n    }\n\n    function ready(): Promise<CatalogSnapshot | null> {\n        const current = getCurrent();\n        if (current) return Promise.resolve(current);\n        if (refreshInFlight) return refreshInFlight.catch(() => getCurrent() ?? null);\n        return Promise.resolve(null);\n    }\n\n    function ensureReady(): Promise<CatalogSnapshot> {\n        const current = getCurrent();\n        if (current) return Promise.resolve(current);\n        return refreshInFlight ?? refresh();\n    }\n\n    return {\n        ...reader,\n        state: () => stateValue,\n        ready,\n        ensureReady,\n        refresh,\n        setSnapshot,\n    };\n}\n"],"mappings":";;;;;;AAaA,SAAgB,uBAAuB,UAAyC,CAAC,GAAkB;CAC/F,IAAI,OAAO,YAAY,YAAY,YAAY,QAAQ,MAAM,QAAQ,OAAO,GACxE,MAAM,IAAI,mBAAmB,oCAAoC;CAErE,MAAM,OAAO,QAAQ;CACrB,IAAI,QAAqC,KAAA;CACzC,MAAM,mBAAgD;EAClD,MAAM,UAAU,OAAO,KAAK,IAAI,IAAI;EACpC,OAAO,YAAY,KAAA,IAAY,KAAA,IAAY,qBAAqB,OAAO;CAC3E;CACA,MAAM,cAAc,aAAoC;EACpD,IAAI,MAAM,KAAK,IAAI,QAAQ;OACtB,QAAQ;CACjB;CACA,IAAI,QAAQ,aAAa,KAAA,KAAa,CAAC,WAAW,GAC9C,WAAW,qBAAqB,QAAQ,QAAQ,CAAC;CAGrD,MAAM,UAAU,WAAW;CAC3B,IAAI,aAA2B,UACzB;EAAE,QAAQ;EAAS,QAAQ,QAAQ;CAAO,IAC1C,EAAE,QAAQ,QAAQ;CACxB,IAAI;CAEJ,MAAM,SAAS,mBAAmB;EAC9B,MAAM,UAAU,WAAW;EAC3B,IAAI,CAAC,SAAS,MAAM,IAAI,qBAAqB;EAC7C,OAAO;CACX,CAAC;CAED,MAAM,sBAA0C,WAAW,CAAC,EAAE,UAAU;CAExE,SAAS,YAAY,UAAiC;EAClD,MAAM,SAAS,qBAAqB,QAAQ;EAC5C,WAAW,MAAM;EACjB,aAAa;GAAE,QAAQ;GAAS,QAAQ,OAAO;EAAO;CAC1D;CAEA,SAAS,UAAoC;EACzC,IAAI,QAAQ,YAAY,SAAS,QAAQ,YAAY,KAAA,GAAW;GAC5D,MAAM,UAAU,WAAW;GAC3B,IAAI,CAAC,SAAS,OAAO,QAAQ,OAAO,IAAI,qBAAqB,CAAC;GAC9D,OAAO,QAAQ,QAAQ,OAAO;EAClC;EACA,IAAI,iBAAiB,OAAO;EAE5B,aAAa;GAAE,QAAQ;GAAc,gBAAgB,cAAc;EAAE;EACrE,kBAAkB,QAAQ,IAAI,CAAC,QAAQ,QAAQ,OAAO,GAAG,QAAQ,QAAQ,OAAO,CAAC,CAAC,CAAC,CAC9E,MAAM,CAAC,YAAY,gBAAgB;GAChC,MAAM,WAAW,qBAAqB;IAClC,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU,WAAW,CAAC,EAAE,WAAW,KAAK;GAC5C,CAAC;GACD,YAAY,QAAQ;GACpB,OAAO;EACX,CAAC,CAAC,CACD,OAAO,UAAU;GACd,aAAa;IAAE,QAAQ;IAAS,QAAQ,cAAc;IAAG;GAAM;GAC/D,MAAM;EACV,CAAC,CAAC,CACD,cAAc;GACX,kBAAkB,KAAA;EACtB,CAAC;EAEL,OAAO;CACX;CAEA,SAAS,QAAyC;EAC9C,MAAM,UAAU,WAAW;EAC3B,IAAI,SAAS,OAAO,QAAQ,QAAQ,OAAO;EAC3C,IAAI,iBAAiB,OAAO,gBAAgB,YAAY,WAAW,KAAK,IAAI;EAC5E,OAAO,QAAQ,QAAQ,IAAI;CAC/B;CAEA,SAAS,cAAwC;EAC7C,MAAM,UAAU,WAAW;EAC3B,IAAI,SAAS,OAAO,QAAQ,QAAQ,OAAO;EAC3C,OAAO,mBAAmB,QAAQ;CACtC;CAEA,OAAO;EACH,GAAG;EACH,aAAa;EACb;EACA;EACA;EACA;CACJ;AACJ"}

package/dist/catalogs/index.js

@@ -1,7 +1,7 @@
 import { CatalogConversionError, CatalogLookupError, CatalogNotReadyError, CatalogValidationFailedError } from "./types.js";
 import { UNKNOWN_ASSET_LABEL, UNKNOWN_LEDGER_ASSET_ID, isUnknownLedgerAsset, isUnknownZipperAsset, unknownLedgerAsset, unknownZipperAsset } from "./unknown-asset.js";
-import { createCatalogSnapshotReader } from "./readers.js";
 import { PAIR_STATUSES } from "../shared/catalog-config.js";
+import { createCatalogSnapshotReader } from "./readers.js";
 import { buildCatalogSnapshot } from "./snapshot.js";
 import { createPolyesterCatalog } from "./client-catalog.js";
 import { patchZipperCatalogSupply } from "./zipper-supply.js";

package/dist/catalogs/readers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readers.d.ts","names":[],"sources":["../../src/catalogs/readers.ts"],"mappings":";;iBAiwBgB,4BAA4B,UAAU,kBAAkB"}
+{"version":3,"file":"readers.d.ts","names":[],"sources":["../../src/catalogs/readers.ts"],"mappings":";;iBAkwBgB,4BAA4B,UAAU,kBAAkB"}

package/dist/catalogs/readers.js

@@ -2,6 +2,7 @@ import { scaledToDecimal, scaledToDisplay, significantDecimalPlaces, tryDecimalT
 import { CatalogConversionError, CatalogLookupError, CatalogValidationFailedError } from "./types.js";
 import { indexesFor } from "./indexes.js";
 import { resolveLedgerAssetByLedgerId, resolveZipperAssetByLedgerId } from "./unknown-asset.js";
+import { parseCatalogSnapshot } from "./snapshot-validation.js";
 function isListed(pair, nowMs) {
 	if (pair.listingAt === null || pair.listingAt > nowMs) return false;
 	if (pair.status === "disabled") return false;
@@ -537,7 +538,8 @@ function createReader(getSnapshot) {
 	return new SnapshotCatalogReader(getSnapshot);
 }
 function createCatalogSnapshotReader(snapshot) {
-	return createReader(() => snapshot);
+	const parsed = parseCatalogSnapshot(snapshot);
+	return createReader(() => parsed);
 }
 //#endregion
 export { createCatalogSnapshotReader, createReader };