@polyester/sdk 0.0.0

package/dist/shared/errors.js

@@ -0,0 +1,271 @@
+//#region src/shared/errors.ts
+const CONNECT_ERROR_PREFIX_RE = /^(?:\[[a-z][a-z0-9_-]*]\s*)+/i;
+function normalizeErrorMessage(message) {
+	return message.replace(CONNECT_ERROR_PREFIX_RE, "").trim();
+}
+/**
+* Base class for every error raised by the Polyester SDK.
+*
+* Check `retryable` (or `instanceof TransientError`) to decide whether the
+* same call can be safely retried, and switch on `code` for exhaustive,
+* minification-safe handling.
+*/
+var PolyesterError = class extends Error {
+	constructor(message, options) {
+		super(normalizeErrorMessage(message), options);
+		this.name = "PolyesterError";
+	}
+};
+/**
+* A transient failure — the request may never have reached the backend or the
+* backend was temporarily unable to serve it. Safe to retry (use the same
+* `requestId`/`clientOrderId` for mutations; the backend dedupes).
+*/
+var TransientError = class extends PolyesterError {
+	code = "TRANSIENT_FAILURE";
+	retryable = true;
+	constructor(message, options) {
+		super(message, options);
+		this.name = "TransientError";
+	}
+};
+/** The request could not be sent or the connection failed mid-flight. */
+var NetworkError = class extends TransientError {
+	code = "NETWORK_ERROR";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "NetworkError";
+	}
+};
+/** The request timed out before the backend produced a response. */
+var TimeoutError = class extends TransientError {
+	code = "TIMEOUT";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "TimeoutError";
+	}
+};
+/** The backend rejected the request due to rate limiting. */
+var RateLimitError = class extends TransientError {
+	code = "RATE_LIMITED";
+	/** Suggested wait before retrying, in milliseconds, when known. */
+	retryAfterMs;
+	constructor(message, options) {
+		super(message, options);
+		this.name = "RateLimitError";
+		this.retryAfterMs = options?.retryAfterMs;
+	}
+};
+/** The backend is temporarily unavailable (e.g. overloaded or restarting). */
+var ServiceUnavailableError = class extends TransientError {
+	code = "SERVICE_UNAVAILABLE";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "ServiceUnavailableError";
+	}
+};
+/**
+* The request itself was rejected — retrying the identical call will fail the
+* same way. Fix the input, authentication, or permissions first.
+*/
+var RequestError = class extends PolyesterError {
+	code = "REQUEST_FAILED";
+	retryable = false;
+	constructor(message, options) {
+		super(message, options);
+		this.name = "RequestError";
+	}
+};
+/** The request input failed validation (client- or server-side). */
+var ValidationError = class extends RequestError {
+	code = "VALIDATION_FAILED";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "ValidationError";
+	}
+};
+/** The submitted client reference quote exceeded the market's configured drift limit. */
+var StaleQuoteError = class extends ValidationError {
+	code = "STALE_QUOTE";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "StaleQuoteError";
+	}
+};
+/** The requested resource does not exist (or is not visible to the caller). */
+var ResourceNotFoundError = class extends RequestError {
+	code = "RESOURCE_NOT_FOUND";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "ResourceNotFoundError";
+	}
+};
+/** The resource already exists (e.g. a duplicate `clientOrderId`). */
+var AlreadyExistsError = class extends RequestError {
+	code = "ALREADY_EXISTS";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "AlreadyExistsError";
+	}
+};
+/** The caller is authenticated but not allowed to perform this operation. */
+var PermissionError = class extends RequestError {
+	code = "PERMISSION_DENIED";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "PermissionError";
+	}
+};
+/** The caller is not authenticated (missing, expired, or invalid credentials). */
+var AuthenticationError = class extends RequestError {
+	code = "UNAUTHENTICATED";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "AuthenticationError";
+	}
+};
+/** The system is not in a state that allows this operation (e.g. insufficient balance). */
+var PreconditionFailedError = class extends RequestError {
+	code = "PRECONDITION_FAILED";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "PreconditionFailedError";
+	}
+};
+/**
+* The resource changed after it was read, so the submitted expected revision
+* is stale. Refetch and let the caller reconcile; do not blindly retry.
+*/
+var RevisionConflictError = class extends PreconditionFailedError {
+	code = "REVISION_CONFLICT";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "RevisionConflictError";
+	}
+};
+/** The policy cannot be removed while accounts or API keys still use it. */
+var PolicyInUseError = class extends PreconditionFailedError {
+	code = "POLICY_IN_USE";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "PolicyInUseError";
+	}
+};
+/** The policy is locked against the requested mutation. */
+var PolicyLockedError = class extends PreconditionFailedError {
+	code = "POLICY_LOCKED";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "PolicyLockedError";
+	}
+};
+/** The policy does not belong to the account scope targeted by the request. */
+var PolicyScopeMismatchError = class extends ValidationError {
+	code = "POLICY_SCOPE_MISMATCH";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "PolicyScopeMismatchError";
+	}
+};
+/** The SDK was configured incorrectly (bad environment, missing credentials, …). */
+var ConfigurationError = class extends RequestError {
+	code = "INVALID_CONFIGURATION";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "ConfigurationError";
+	}
+};
+/**
+* The operation requires additional multi-factor authentication. Catch this
+* class to handle all MFA flows, or the subclasses to branch per flow.
+*/
+var MfaRequiredError = class extends RequestError {
+	code = "MFA_REQUIRED";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "MfaRequiredError";
+	}
+};
+/** The user must enroll in MFA before this operation can proceed. */
+var MfaEnrollmentRequiredError = class extends MfaRequiredError {
+	code = "MFA_ENROLLMENT_REQUIRED";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "MfaEnrollmentRequiredError";
+	}
+};
+/** The operation requires a fresh MFA step-up proof (retry with `X-Auth-Step-Up`). */
+var StepUpRequiredError = class extends MfaRequiredError {
+	code = "STEP_UP_REQUIRED";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "StepUpRequiredError";
+	}
+};
+/** The operation requires a recent MFA-elevated session, not a one-use step-up proof. */
+var SessionElevationRequiredError = class extends MfaRequiredError {
+	code = "SESSION_ELEVATION_REQUIRED";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "SessionElevationRequiredError";
+	}
+};
+/** The requested deletion would leave the account without an active MFA factor. */
+var MfaLastFactorRequiredError = class extends PreconditionFailedError {
+	code = "MFA_LAST_FACTOR_REQUIRED";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "MfaLastFactorRequiredError";
+	}
+};
+/**
+* An expected MFA verification rejection. Callers should select their own
+* user-facing copy from `reason` instead of displaying the backend message.
+*/
+var MfaVerificationError = class extends RequestError {
+	reason;
+	code = "MFA_VERIFICATION_FAILED";
+	constructor(message, reason, options) {
+		super(message, options);
+		this.reason = reason;
+		this.name = "MfaVerificationError";
+	}
+};
+/**
+* The backend failed unexpectedly or returned a malformed response. Not
+* automatically retryable — the failure may recur and mutations may have
+* partially applied.
+*/
+var InternalServerError = class extends PolyesterError {
+	code = "INTERNAL_SERVER_ERROR";
+	retryable = false;
+	constructor(message, options) {
+		super(message, options);
+		this.name = "InternalServerError";
+	}
+};
+/**
+* Checks whether an error represents an aborted request (caller-initiated via
+* `AbortSignal`). Aborts are intentionally NOT part of the {@link PolyesterError}
+* tree and are never retryable.
+*/
+function isAbortError(err) {
+	return err instanceof DOMException && err.name === "AbortError";
+}
+/** Maps a plain HTTP status code onto the SDK error tree. */
+function errorFromHttpStatus(status, message, options) {
+	if (status === 401) return new AuthenticationError(message, options);
+	if (status === 403) return new PermissionError(message, options);
+	if (status === 404) return new ResourceNotFoundError(message, options);
+	if (status === 408) return new TimeoutError(message, options);
+	if (status === 409) return new AlreadyExistsError(message, options);
+	if (status === 429) return new RateLimitError(message, options);
+	if (status === 502 || status === 503 || status === 504) return new ServiceUnavailableError(message, options);
+	if (status >= 500) return new InternalServerError(message, options);
+	if (status >= 400) return new RequestError(message, options);
+	return new NetworkError(message, options);
+}
+//#endregion
+export { AlreadyExistsError, AuthenticationError, ConfigurationError, InternalServerError, MfaEnrollmentRequiredError, MfaLastFactorRequiredError, MfaRequiredError, MfaVerificationError, NetworkError, PermissionError, PolicyInUseError, PolicyLockedError, PolicyScopeMismatchError, PolyesterError, PreconditionFailedError, RateLimitError, RequestError, ResourceNotFoundError, RevisionConflictError, ServiceUnavailableError, SessionElevationRequiredError, StaleQuoteError, StepUpRequiredError, TimeoutError, TransientError, ValidationError, errorFromHttpStatus, isAbortError, normalizeErrorMessage };
+
+//# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/shared/errors.ts"],"sourcesContent":["/**\n * Typed error hierarchy for the Polyester SDK.\n *\n * Every error raised by the SDK extends {@link PolyesterError}, which carries a\n * stable machine-readable `code` and a `retryable` flag. The tree splits on\n * retryability so callers can triage with a single `instanceof` check:\n *\n * ```\n * PolyesterError                     code                        retryable\n * ├── TransientError                 TRANSIENT_FAILURE           true\n * │   ├── NetworkError               NETWORK_ERROR               true\n * │   ├── TimeoutError               TIMEOUT                     true\n * │   ├── RateLimitError             RATE_LIMITED                true\n * │   └── ServiceUnavailableError    SERVICE_UNAVAILABLE         true\n * ├── RequestError                   REQUEST_FAILED              false\n * │   ├── ValidationError            VALIDATION_FAILED           false\n * │   ├── ResourceNotFoundError      RESOURCE_NOT_FOUND          false\n * │   ├── AlreadyExistsError         ALREADY_EXISTS              false\n * │   ├── PermissionError            PERMISSION_DENIED           false\n * │   ├── AuthenticationError        UNAUTHENTICATED             false\n * │   ├── PreconditionFailedError    PRECONDITION_FAILED         false\n * │   │   ├── RevisionConflictError      REVISION_CONFLICT\n * │   │   ├── PolicyInUseError           POLICY_IN_USE\n * │   │   └── PolicyLockedError          POLICY_LOCKED\n * │   ├── PolicyScopeMismatchError   POLICY_SCOPE_MISMATCH       false\n * │   ├── ConfigurationError         INVALID_CONFIGURATION       false\n * │   ├── MfaRequiredError           MFA_REQUIRED                false\n * │   │   ├── MfaEnrollmentRequiredError     MFA_ENROLLMENT_REQUIRED\n * │   │   ├── StepUpRequiredError            STEP_UP_REQUIRED\n * │   │   └── SessionElevationRequiredError  SESSION_ELEVATION_REQUIRED\n * │   ├── MfaLastFactorRequiredError  MFA_LAST_FACTOR_REQUIRED       false\n * │   └── MfaVerificationError       MFA_VERIFICATION_FAILED     false\n * └── InternalServerError            INTERNAL_SERVER_ERROR       false\n * ```\n *\n * Catalog errors (`CatalogLookupError`, `CatalogConversionError`, …) plug into\n * the same tree under `RequestError`/`ValidationError`.\n *\n * Errors mapped from RPC failures keep the original `ConnectError` as `cause`.\n *\n * @example\n * ```ts\n * try {\n *   await client.orders.createSpotOrder(input);\n * } catch (err) {\n *   if (err instanceof RateLimitError) await sleep(err.retryAfterMs ?? 1000);\n *   else if (err instanceof TransientError) retry();\n *   else if (err instanceof StepUpRequiredError) promptForMfa();\n *   else throw err;\n * }\n * ```\n */\n\n/** Stable machine-readable codes carried by built-in SDK errors. */\nexport type PolyesterErrorCode =\n    | \"TRANSIENT_FAILURE\"\n    | \"NETWORK_ERROR\"\n    | \"TIMEOUT\"\n    | \"RATE_LIMITED\"\n    | \"SERVICE_UNAVAILABLE\"\n    | \"REQUEST_FAILED\"\n    | \"VALIDATION_FAILED\"\n    | \"STALE_QUOTE\"\n    | \"RESOURCE_NOT_FOUND\"\n    | \"ALREADY_EXISTS\"\n    | \"PERMISSION_DENIED\"\n    | \"UNAUTHENTICATED\"\n    | \"PRECONDITION_FAILED\"\n    | \"REVISION_CONFLICT\"\n    | \"POLICY_IN_USE\"\n    | \"POLICY_LOCKED\"\n    | \"POLICY_SCOPE_MISMATCH\"\n    | \"INVALID_CONFIGURATION\"\n    | \"MFA_REQUIRED\"\n    | \"MFA_ENROLLMENT_REQUIRED\"\n    | \"STEP_UP_REQUIRED\"\n    | \"SESSION_ELEVATION_REQUIRED\"\n    | \"MFA_LAST_FACTOR_REQUIRED\"\n    | \"MFA_VERIFICATION_FAILED\"\n    | \"INTERNAL_SERVER_ERROR\"\n    | \"CATALOG_LOOKUP_MISS\"\n    | \"CATALOG_NOT_READY\"\n    | \"CATALOG_CONVERSION_INVALID\"\n    | \"CATALOG_VALIDATION_FAILED\";\n\nexport interface PolyesterErrorOptions {\n    /** Underlying error, typically the original `ConnectError` for RPC failures. */\n    cause?: unknown;\n}\n\nconst CONNECT_ERROR_PREFIX_RE = /^(?:\\[[a-z][a-z0-9_-]*]\\s*)+/i;\n\nexport function normalizeErrorMessage(message: string): string {\n    return message.replace(CONNECT_ERROR_PREFIX_RE, \"\").trim();\n}\n\n/**\n * Base class for every error raised by the Polyester SDK.\n *\n * Check `retryable` (or `instanceof TransientError`) to decide whether the\n * same call can be safely retried, and switch on `code` for exhaustive,\n * minification-safe handling.\n */\nexport abstract class PolyesterError extends Error {\n    /** Stable machine-readable error code, e.g. `\"RATE_LIMITED\"`. */\n    abstract readonly code: string;\n    /** Whether retrying the same operation may succeed. */\n    abstract readonly retryable: boolean;\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(normalizeErrorMessage(message), options);\n        this.name = \"PolyesterError\";\n    }\n}\n\n/**\n * A transient failure — the request may never have reached the backend or the\n * backend was temporarily unable to serve it. Safe to retry (use the same\n * `requestId`/`clientOrderId` for mutations; the backend dedupes).\n */\nexport class TransientError extends PolyesterError {\n    readonly code: string = \"TRANSIENT_FAILURE\";\n    readonly retryable = true;\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"TransientError\";\n    }\n}\n\n/** The request could not be sent or the connection failed mid-flight. */\nexport class NetworkError extends TransientError {\n    override readonly code: string = \"NETWORK_ERROR\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"NetworkError\";\n    }\n}\n\n/** The request timed out before the backend produced a response. */\nexport class TimeoutError extends TransientError {\n    override readonly code: string = \"TIMEOUT\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"TimeoutError\";\n    }\n}\n\nexport interface RateLimitErrorOptions extends PolyesterErrorOptions {\n    /** Suggested wait before retrying, when the backend provided one. */\n    retryAfterMs?: number;\n}\n\n/** The backend rejected the request due to rate limiting. */\nexport class RateLimitError extends TransientError {\n    override readonly code: string = \"RATE_LIMITED\";\n    /** Suggested wait before retrying, in milliseconds, when known. */\n    readonly retryAfterMs?: number;\n\n    constructor(message: string, options?: RateLimitErrorOptions) {\n        super(message, options);\n        this.name = \"RateLimitError\";\n        this.retryAfterMs = options?.retryAfterMs;\n    }\n}\n\n/** The backend is temporarily unavailable (e.g. overloaded or restarting). */\nexport class ServiceUnavailableError extends TransientError {\n    override readonly code: string = \"SERVICE_UNAVAILABLE\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"ServiceUnavailableError\";\n    }\n}\n\n/**\n * The request itself was rejected — retrying the identical call will fail the\n * same way. Fix the input, authentication, or permissions first.\n */\nexport class RequestError extends PolyesterError {\n    readonly code: string = \"REQUEST_FAILED\";\n    readonly retryable = false;\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"RequestError\";\n    }\n}\n\n/** The request input failed validation (client- or server-side). */\nexport class ValidationError extends RequestError {\n    override readonly code: string = \"VALIDATION_FAILED\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"ValidationError\";\n    }\n}\n\n/** The submitted client reference quote exceeded the market's configured drift limit. */\nexport class StaleQuoteError extends ValidationError {\n    override readonly code = \"STALE_QUOTE\" as const;\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"StaleQuoteError\";\n    }\n}\n\n/** The requested resource does not exist (or is not visible to the caller). */\nexport class ResourceNotFoundError extends RequestError {\n    override readonly code: string = \"RESOURCE_NOT_FOUND\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"ResourceNotFoundError\";\n    }\n}\n\n/** The resource already exists (e.g. a duplicate `clientOrderId`). */\nexport class AlreadyExistsError extends RequestError {\n    override readonly code: string = \"ALREADY_EXISTS\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"AlreadyExistsError\";\n    }\n}\n\n/** The caller is authenticated but not allowed to perform this operation. */\nexport class PermissionError extends RequestError {\n    override readonly code: string = \"PERMISSION_DENIED\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"PermissionError\";\n    }\n}\n\n/** The caller is not authenticated (missing, expired, or invalid credentials). */\nexport class AuthenticationError extends RequestError {\n    override readonly code: string = \"UNAUTHENTICATED\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"AuthenticationError\";\n    }\n}\n\n/** The system is not in a state that allows this operation (e.g. insufficient balance). */\nexport class PreconditionFailedError extends RequestError {\n    override readonly code: string = \"PRECONDITION_FAILED\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"PreconditionFailedError\";\n    }\n}\n\n/**\n * The resource changed after it was read, so the submitted expected revision\n * is stale. Refetch and let the caller reconcile; do not blindly retry.\n */\nexport class RevisionConflictError extends PreconditionFailedError {\n    override readonly code: string = \"REVISION_CONFLICT\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"RevisionConflictError\";\n    }\n}\n\n/** The policy cannot be removed while accounts or API keys still use it. */\nexport class PolicyInUseError extends PreconditionFailedError {\n    override readonly code: string = \"POLICY_IN_USE\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"PolicyInUseError\";\n    }\n}\n\n/** The policy is locked against the requested mutation. */\nexport class PolicyLockedError extends PreconditionFailedError {\n    override readonly code: string = \"POLICY_LOCKED\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"PolicyLockedError\";\n    }\n}\n\n/** The policy does not belong to the account scope targeted by the request. */\nexport class PolicyScopeMismatchError extends ValidationError {\n    override readonly code: string = \"POLICY_SCOPE_MISMATCH\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"PolicyScopeMismatchError\";\n    }\n}\n\n/** The SDK was configured incorrectly (bad environment, missing credentials, …). */\nexport class ConfigurationError extends RequestError {\n    override readonly code: string = \"INVALID_CONFIGURATION\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"ConfigurationError\";\n    }\n}\n\n/**\n * The operation requires additional multi-factor authentication. Catch this\n * class to handle all MFA flows, or the subclasses to branch per flow.\n */\nexport class MfaRequiredError extends RequestError {\n    override readonly code: string = \"MFA_REQUIRED\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"MfaRequiredError\";\n    }\n}\n\n/** The user must enroll in MFA before this operation can proceed. */\nexport class MfaEnrollmentRequiredError extends MfaRequiredError {\n    override readonly code: string = \"MFA_ENROLLMENT_REQUIRED\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"MfaEnrollmentRequiredError\";\n    }\n}\n\n/** The operation requires a fresh MFA step-up proof (retry with `X-Auth-Step-Up`). */\nexport class StepUpRequiredError extends MfaRequiredError {\n    override readonly code: string = \"STEP_UP_REQUIRED\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"StepUpRequiredError\";\n    }\n}\n\n/** The operation requires a recent MFA-elevated session, not a one-use step-up proof. */\nexport class SessionElevationRequiredError extends MfaRequiredError {\n    override readonly code: string = \"SESSION_ELEVATION_REQUIRED\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"SessionElevationRequiredError\";\n    }\n}\n\n/** The requested deletion would leave the account without an active MFA factor. */\nexport class MfaLastFactorRequiredError extends PreconditionFailedError {\n    override readonly code: string = \"MFA_LAST_FACTOR_REQUIRED\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"MfaLastFactorRequiredError\";\n    }\n}\n\n/** The reason an MFA challenge could not be completed. */\nexport type MfaVerificationFailureReason =\n    | \"challenge-invalid\"\n    | \"challenge-locked\"\n    | \"otp-invalid\"\n    | \"recovery-code-invalid\"\n    | \"passkey-invalid\";\n\n/**\n * An expected MFA verification rejection. Callers should select their own\n * user-facing copy from `reason` instead of displaying the backend message.\n */\nexport class MfaVerificationError extends RequestError {\n    override readonly code: string = \"MFA_VERIFICATION_FAILED\";\n\n    constructor(\n        message: string,\n        readonly reason: MfaVerificationFailureReason,\n        options?: PolyesterErrorOptions,\n    ) {\n        super(message, options);\n        this.name = \"MfaVerificationError\";\n    }\n}\n\n/**\n * The backend failed unexpectedly or returned a malformed response. Not\n * automatically retryable — the failure may recur and mutations may have\n * partially applied.\n */\nexport class InternalServerError extends PolyesterError {\n    readonly code: string = \"INTERNAL_SERVER_ERROR\";\n    readonly retryable = false;\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"InternalServerError\";\n    }\n}\n\n/**\n * Checks whether an error represents an aborted request (caller-initiated via\n * `AbortSignal`). Aborts are intentionally NOT part of the {@link PolyesterError}\n * tree and are never retryable.\n */\nexport function isAbortError(err: unknown): boolean {\n    return err instanceof DOMException && err.name === \"AbortError\";\n}\n\n/** Maps a plain HTTP status code onto the SDK error tree. */\nexport function errorFromHttpStatus(\n    status: number,\n    message: string,\n    options?: PolyesterErrorOptions,\n): PolyesterError {\n    if (status === 401) return new AuthenticationError(message, options);\n    if (status === 403) return new PermissionError(message, options);\n    if (status === 404) return new ResourceNotFoundError(message, options);\n    if (status === 408) return new TimeoutError(message, options);\n    if (status === 409) return new AlreadyExistsError(message, options);\n    if (status === 429) return new RateLimitError(message, options);\n    if (status === 502 || status === 503 || status === 504) {\n        return new ServiceUnavailableError(message, options);\n    }\n    if (status >= 500) return new InternalServerError(message, options);\n    if (status >= 400) return new RequestError(message, options);\n    return new NetworkError(message, options);\n}\n"],"mappings":"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"}

package/dist/shared/ledger-codes.d.ts

@@ -0,0 +1,9 @@
+import "../gen/ledger/v1/catalog_pb.js";
+//#region src/shared/ledger-codes.d.ts
+declare const ACCOUNT_CODE_VALUES: readonly ["funding", "trading"];
+type AccountCodeValue = (typeof ACCOUNT_CODE_VALUES)[number];
+declare const TRANSFER_CODE_VALUES: readonly ["deposit", "withdraw", "maker_fee", "taker_fee", "internal_transfer", "trade_base", "trade_quote", "rebate", "funding_to_trading", "trading_to_funding", "trading_withdraw_reserve", "funding_user_transfer"];
+type TransferCodeValue = (typeof TRANSFER_CODE_VALUES)[number];
+//#endregion
+export { ACCOUNT_CODE_VALUES, AccountCodeValue, TRANSFER_CODE_VALUES, TransferCodeValue };
+//# sourceMappingURL=ledger-codes.d.ts.map

package/dist/shared/ledger-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-codes.d.ts","names":[],"sources":["../../src/shared/ledger-codes.ts"],"mappings":";;cAGa;KACD,2BAA2B;cAE1B;KAcD,4BAA4B"}

package/dist/shared/ledger-codes.js

@@ -0,0 +1,63 @@
+import "../gen/ledger/v1/catalog_pb.js";
+//#region src/shared/ledger-codes.ts
+const ACCOUNT_CODE_VALUES = ["funding", "trading"];
+const TRANSFER_CODE_VALUES = [
+	"deposit",
+	"withdraw",
+	"maker_fee",
+	"taker_fee",
+	"internal_transfer",
+	"trade_base",
+	"trade_quote",
+	"rebate",
+	"funding_to_trading",
+	"trading_to_funding",
+	"trading_withdraw_reserve",
+	"funding_user_transfer"
+];
+const AccountCodeCodec = {
+	inputToProto: {
+		funding: 300,
+		trading: 301
+	},
+	protoToOutput: {
+		[0]: "unspecified",
+		[300]: "funding",
+		[301]: "trading"
+	}
+};
+const TransferCodeCodec = {
+	inputToProto: {
+		deposit: 1e3,
+		withdraw: 1001,
+		maker_fee: 1010,
+		taker_fee: 1011,
+		internal_transfer: 1030,
+		trade_base: 1031,
+		trade_quote: 1032,
+		rebate: 1041,
+		funding_to_trading: 1060,
+		trading_to_funding: 1061,
+		trading_withdraw_reserve: 1062,
+		funding_user_transfer: 1063
+	},
+	protoToOutput: {
+		[0]: "unspecified",
+		[1e3]: "deposit",
+		[1001]: "withdraw",
+		[1010]: "maker_fee",
+		[1011]: "taker_fee",
+		[1030]: "internal_transfer",
+		[1031]: "trade_base",
+		[1032]: "trade_quote",
+		[1041]: "rebate",
+		[1060]: "funding_to_trading",
+		[1061]: "trading_to_funding",
+		[1062]: "trading_withdraw_reserve",
+		[1063]: "funding_user_transfer"
+	}
+};
+//#endregion
+export { ACCOUNT_CODE_VALUES, AccountCodeCodec, TRANSFER_CODE_VALUES, TransferCodeCodec };
+
+//# sourceMappingURL=ledger-codes.js.map

package/dist/shared/ledger-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-codes.js","names":[],"sources":["../../src/shared/ledger-codes.ts"],"sourcesContent":["import { AccountCode, TransferCode } from \"../gen/ledger/v1/catalog_pb.js\";\nimport type { InputToProto, ProtoToOutput } from \"../utils/types.js\";\n\nexport const ACCOUNT_CODE_VALUES = [\"funding\", \"trading\"] as const;\nexport type AccountCodeValue = (typeof ACCOUNT_CODE_VALUES)[number];\n\nexport const TRANSFER_CODE_VALUES = [\n    \"deposit\",\n    \"withdraw\",\n    \"maker_fee\",\n    \"taker_fee\",\n    \"internal_transfer\",\n    \"trade_base\",\n    \"trade_quote\",\n    \"rebate\",\n    \"funding_to_trading\",\n    \"trading_to_funding\",\n    \"trading_withdraw_reserve\",\n    \"funding_user_transfer\",\n] as const;\nexport type TransferCodeValue = (typeof TRANSFER_CODE_VALUES)[number];\n\nexport const AccountCodeCodec = {\n    inputToProto: {\n        funding: AccountCode.FUNDING,\n        trading: AccountCode.TRADING,\n    } satisfies InputToProto<AccountCodeValue, AccountCode>,\n    protoToOutput: {\n        [AccountCode.ACCOUNT_CODE_UNSPECIFIED]: \"unspecified\",\n        [AccountCode.FUNDING]: \"funding\",\n        [AccountCode.TRADING]: \"trading\",\n    } satisfies ProtoToOutput<AccountCode, AccountCodeValue>,\n} as const;\n\nexport const TransferCodeCodec = {\n    inputToProto: {\n        deposit: TransferCode.DEPOSIT,\n        withdraw: TransferCode.WITHDRAW,\n        maker_fee: TransferCode.MAKER_FEE,\n        taker_fee: TransferCode.TAKER_FEE,\n        internal_transfer: TransferCode.INTERNAL_TRANSFER,\n        trade_base: TransferCode.TRADE_BASE,\n        trade_quote: TransferCode.TRADE_QUOTE,\n        rebate: TransferCode.REBATE,\n        funding_to_trading: TransferCode.FUNDING_TO_TRADING,\n        trading_to_funding: TransferCode.TRADING_TO_FUNDING,\n        trading_withdraw_reserve: TransferCode.TRADING_WITHDRAW_RESERVE,\n        funding_user_transfer: TransferCode.FUNDING_USER_TRANSFER,\n    } satisfies InputToProto<TransferCodeValue, TransferCode>,\n    protoToOutput: {\n        [TransferCode.TRANSFER_CODE_UNSPECIFIED]: \"unspecified\",\n        [TransferCode.DEPOSIT]: \"deposit\",\n        [TransferCode.WITHDRAW]: \"withdraw\",\n        [TransferCode.MAKER_FEE]: \"maker_fee\",\n        [TransferCode.TAKER_FEE]: \"taker_fee\",\n        [TransferCode.INTERNAL_TRANSFER]: \"internal_transfer\",\n        [TransferCode.TRADE_BASE]: \"trade_base\",\n        [TransferCode.TRADE_QUOTE]: \"trade_quote\",\n        [TransferCode.REBATE]: \"rebate\",\n        [TransferCode.FUNDING_TO_TRADING]: \"funding_to_trading\",\n        [TransferCode.TRADING_TO_FUNDING]: \"trading_to_funding\",\n        [TransferCode.TRADING_WITHDRAW_RESERVE]: \"trading_withdraw_reserve\",\n        [TransferCode.FUNDING_USER_TRANSFER]: \"funding_user_transfer\",\n    } satisfies ProtoToOutput<TransferCode, TransferCodeValue>,\n} as const;\n"],"mappings":";;AAGA,MAAa,sBAAsB,CAAC,WAAW,SAAS;AAGxD,MAAa,uBAAuB;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ;AAGA,MAAa,mBAAmB;CAC5B,cAAc;EACV,SAAA;EACA,SAAA;CACJ;CACA,eAAe;GAC6B,IAAA;GACjB,MAAA;GACA,MAAA;CAC3B;AACJ;AAEA,MAAa,oBAAoB;CAC7B,cAAc;EACV,SAAA;EACA,UAAA;EACA,WAAA;EACA,WAAA;EACA,mBAAA;EACA,YAAA;EACA,aAAA;EACA,QAAA;EACA,oBAAA;EACA,oBAAA;EACA,0BAAA;EACA,uBAAA;CACJ;CACA,eAAe;GAC+B,IAAA;GAClB,MAAA;GACC,OAAA;GACC,OAAA;GACA,OAAA;GACQ,OAAA;GACP,OAAA;GACC,OAAA;GACL,OAAA;GACY,OAAA;GACA,OAAA;GACM,OAAA;GACH,OAAA;CAC1C;AACJ"}

package/dist/shared/proto-enum-codec.js

@@ -0,0 +1,13 @@
+//#region src/shared/proto-enum-codec.ts
+/**
+* Creates a schema transform that rejects unspecified proto enum labels.
+*/
+function requiredEnumLabel(mapping, value, schemaName, enumName) {
+	const output = mapping[value];
+	if (output === void 0) throw new Error(`[${schemaName}]: invalid ${enumName} ${value}`);
+	return output;
+}
+//#endregion
+export { requiredEnumLabel };
+
+//# sourceMappingURL=proto-enum-codec.js.map

package/dist/shared/proto-enum-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto-enum-codec.js","names":[],"sources":["../../src/shared/proto-enum-codec.ts"],"sourcesContent":["/**\n * Creates a schema transform that rejects unspecified proto enum labels.\n */\nexport function requiredEnumLabel<TOutput>(\n    mapping: Readonly<Partial<Record<number, TOutput>>>,\n    value: number,\n    schemaName: string,\n    enumName: string,\n): TOutput {\n    const output = mapping[value];\n    if (output === undefined) throw new Error(`[${schemaName}]: invalid ${enumName} ${value}`);\n    return output;\n}\n"],"mappings":";;;;AAGA,SAAgB,kBACZ,SACA,OACA,YACA,UACO;CACP,MAAM,SAAS,QAAQ;CACvB,IAAI,WAAW,KAAA,GAAW,MAAM,IAAI,MAAM,IAAI,WAAW,aAAa,SAAS,GAAG,OAAO;CACzF,OAAO;AACX"}

package/dist/shared/reconciliation.d.ts

@@ -0,0 +1,14 @@
+//#region src/shared/reconciliation.d.ts
+/** Compare exact unsigned integer strings without narrowing them to a JS number. */
+declare function compareUnsignedIntegerStrings(left: string, right: string): -1 | 0 | 1;
+/**
+ * Decide whether a realtime/snapshot entity update should replace the current
+ * value. Once the current value is versioned, an unversioned update cannot
+ * replace it. When both timestamps are known, only a strictly newer update
+ * applies; equal values are replays. Two unversioned values preserve legacy
+ * last-write behavior.
+ */
+declare function shouldApplyReconciliationUpdate(existingTimestampNs: string | undefined, incomingTimestampNs: string | undefined): boolean;
+//#endregion
+export { compareUnsignedIntegerStrings, shouldApplyReconciliationUpdate };
+//# sourceMappingURL=reconciliation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation.d.ts","names":[],"sources":["../../src/shared/reconciliation.ts"],"mappings":";;iBAWgB,8BAA8B,cAAc;;;;;;;;iBAiB5C,gCACZ,yCACA"}

package/dist/shared/reconciliation.js

@@ -0,0 +1,30 @@
+//#region src/shared/reconciliation.ts
+function normalizeUnsignedInteger(value) {
+	const normalized = value.replace(/^0+(?=\d)/, "");
+	if (!/^\d+$/.test(normalized)) throw new TypeError(`Expected an unsigned integer string, received ${JSON.stringify(value)}`);
+	return normalized;
+}
+/** Compare exact unsigned integer strings without narrowing them to a JS number. */
+function compareUnsignedIntegerStrings(left, right) {
+	const normalizedLeft = normalizeUnsignedInteger(left);
+	const normalizedRight = normalizeUnsignedInteger(right);
+	if (normalizedLeft.length !== normalizedRight.length) return normalizedLeft.length < normalizedRight.length ? -1 : 1;
+	if (normalizedLeft === normalizedRight) return 0;
+	return normalizedLeft < normalizedRight ? -1 : 1;
+}
+/**
+* Decide whether a realtime/snapshot entity update should replace the current
+* value. Once the current value is versioned, an unversioned update cannot
+* replace it. When both timestamps are known, only a strictly newer update
+* applies; equal values are replays. Two unversioned values preserve legacy
+* last-write behavior.
+*/
+function shouldApplyReconciliationUpdate(existingTimestampNs, incomingTimestampNs) {
+	if (existingTimestampNs === void 0) return true;
+	if (incomingTimestampNs === void 0) return false;
+	return compareUnsignedIntegerStrings(incomingTimestampNs, existingTimestampNs) > 0;
+}
+//#endregion
+export { compareUnsignedIntegerStrings, shouldApplyReconciliationUpdate };
+
+//# sourceMappingURL=reconciliation.js.map

package/dist/shared/reconciliation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation.js","names":[],"sources":["../../src/shared/reconciliation.ts"],"sourcesContent":["function normalizeUnsignedInteger(value: string): string {\n    const normalized = value.replace(/^0+(?=\\d)/, \"\");\n    if (!/^\\d+$/.test(normalized)) {\n        throw new TypeError(\n            `Expected an unsigned integer string, received ${JSON.stringify(value)}`,\n        );\n    }\n    return normalized;\n}\n\n/** Compare exact unsigned integer strings without narrowing them to a JS number. */\nexport function compareUnsignedIntegerStrings(left: string, right: string): -1 | 0 | 1 {\n    const normalizedLeft = normalizeUnsignedInteger(left);\n    const normalizedRight = normalizeUnsignedInteger(right);\n    if (normalizedLeft.length !== normalizedRight.length) {\n        return normalizedLeft.length < normalizedRight.length ? -1 : 1;\n    }\n    if (normalizedLeft === normalizedRight) return 0;\n    return normalizedLeft < normalizedRight ? -1 : 1;\n}\n\n/**\n * Decide whether a realtime/snapshot entity update should replace the current\n * value. Once the current value is versioned, an unversioned update cannot\n * replace it. When both timestamps are known, only a strictly newer update\n * applies; equal values are replays. Two unversioned values preserve legacy\n * last-write behavior.\n */\nexport function shouldApplyReconciliationUpdate(\n    existingTimestampNs: string | undefined,\n    incomingTimestampNs: string | undefined,\n): boolean {\n    if (existingTimestampNs === undefined) return true;\n    if (incomingTimestampNs === undefined) return false;\n    return compareUnsignedIntegerStrings(incomingTimestampNs, existingTimestampNs) > 0;\n}\n"],"mappings":";AAAA,SAAS,yBAAyB,OAAuB;CACrD,MAAM,aAAa,MAAM,QAAQ,aAAa,EAAE;CAChD,IAAI,CAAC,QAAQ,KAAK,UAAU,GACxB,MAAM,IAAI,UACN,iDAAiD,KAAK,UAAU,KAAK,GACzE;CAEJ,OAAO;AACX;;AAGA,SAAgB,8BAA8B,MAAc,OAA2B;CACnF,MAAM,iBAAiB,yBAAyB,IAAI;CACpD,MAAM,kBAAkB,yBAAyB,KAAK;CACtD,IAAI,eAAe,WAAW,gBAAgB,QAC1C,OAAO,eAAe,SAAS,gBAAgB,SAAS,KAAK;CAEjE,IAAI,mBAAmB,iBAAiB,OAAO;CAC/C,OAAO,iBAAiB,kBAAkB,KAAK;AACnD;;;;;;;;AASA,SAAgB,gCACZ,qBACA,qBACO;CACP,IAAI,wBAAwB,KAAA,GAAW,OAAO;CAC9C,IAAI,wBAAwB,KAAA,GAAW,OAAO;CAC9C,OAAO,8BAA8B,qBAAqB,mBAAmB,IAAI;AACrF"}

package/dist/shared/request-options.d.ts

@@ -0,0 +1,10 @@
+//#region src/shared/request-options.d.ts
+interface PolyesterRequestOptions {
+  signal?: AbortSignal;
+}
+interface PolyesterMutationOptions extends PolyesterRequestOptions {
+  stepUpToken?: string | null;
+}
+//#endregion
+export { PolyesterMutationOptions, PolyesterRequestOptions };
+//# sourceMappingURL=request-options.d.ts.map

package/dist/shared/request-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-options.d.ts","names":[],"sources":["../../src/shared/request-options.ts"],"mappings":";UAAiB;EACb,SAAS;;UAGI,iCAAiC;EAC9C"}

package/dist/shared/request-options.js

@@ -0,0 +1,22 @@
+//#region src/shared/request-options.ts
+const AUTH_STEP_UP_HEADER_NAME = "X-Auth-Step-Up";
+/**
+* Converts SDK request options into Connect RPC call options.
+*/
+function toConnectCallOptions(options) {
+	const signal = options?.signal;
+	const stepUpToken = (options?.stepUpToken ?? "").trim();
+	if (!signal && !stepUpToken) return void 0;
+	const callOptions = {};
+	if (signal) callOptions.signal = signal;
+	if (stepUpToken) {
+		const headers = new Headers();
+		headers.set(AUTH_STEP_UP_HEADER_NAME, stepUpToken);
+		callOptions.headers = headers;
+	}
+	return callOptions;
+}
+//#endregion
+export { AUTH_STEP_UP_HEADER_NAME, toConnectCallOptions };
+
+//# sourceMappingURL=request-options.js.map

package/dist/shared/request-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-options.js","names":[],"sources":["../../src/shared/request-options.ts"],"sourcesContent":["export interface PolyesterRequestOptions {\n    signal?: AbortSignal;\n}\n\nexport interface PolyesterMutationOptions extends PolyesterRequestOptions {\n    stepUpToken?: string | null;\n}\n\nexport const AUTH_STEP_UP_HEADER_NAME = \"X-Auth-Step-Up\";\n\nexport type PolyesterConnectCallOptions = {\n    signal?: AbortSignal;\n    headers?: Headers;\n};\n\n/**\n * Converts SDK request options into Connect RPC call options.\n */\nexport function toConnectCallOptions(\n    options?: PolyesterMutationOptions,\n): PolyesterConnectCallOptions | undefined {\n    const signal = options?.signal;\n    const stepUpToken = (options?.stepUpToken ?? \"\").trim();\n\n    if (!signal && !stepUpToken) return undefined;\n\n    const callOptions: PolyesterConnectCallOptions = {};\n    if (signal) callOptions.signal = signal;\n    if (stepUpToken) {\n        const headers = new Headers();\n        headers.set(AUTH_STEP_UP_HEADER_NAME, stepUpToken);\n        callOptions.headers = headers;\n    }\n\n    return callOptions;\n}\n"],"mappings":";AAQA,MAAa,2BAA2B;;;;AAUxC,SAAgB,qBACZ,SACuC;CACvC,MAAM,SAAS,SAAS;CACxB,MAAM,eAAe,SAAS,eAAe,GAAA,CAAI,KAAK;CAEtD,IAAI,CAAC,UAAU,CAAC,aAAa,OAAO,KAAA;CAEpC,MAAM,cAA2C,CAAC;CAClD,IAAI,QAAQ,YAAY,SAAS;CACjC,IAAI,aAAa;EACb,MAAM,UAAU,IAAI,QAAQ;EAC5B,QAAQ,IAAI,0BAA0B,WAAW;EACjD,YAAY,UAAU;CAC1B;CAEA,OAAO;AACX"}

package/dist/shared/schemas.js

@@ -0,0 +1,65 @@
+import { formatId, idToBigInt } from "../utils/base58-id.js";
+import { parseOptionalUint64DecimalStrict, toBigIntOrZero, toBpsOrZero, toIntOrZero } from "../utils/numbers.js";
+import { tsNsToMs, tsObjToMs } from "../utils/time.js";
+import * as v from "valibot";
+//#region src/shared/schemas.ts
+const UINT64_MAX = (1n << 64n) - 1n;
+const MS_TO_US = 1000n;
+const MS_TO_NS = 1000000n;
+const MAX_UINT64_TIMESTAMP_MS_US = Number(UINT64_MAX / MS_TO_US);
+const MAX_UINT64_TIMESTAMP_MS = Number(UINT64_MAX / MS_TO_NS);
+const TimestampSchema = v.object({
+	seconds: v.bigint(),
+	nanos: v.optional(v.number(), 0)
+});
+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 OptionalNumberToBpsOrZeroSchema = 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()));
+v.pipe(v.optional(v.bigint()), v.transform((value) => value === void 0 ? void 0 : value.toString()));
+v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(MAX_UINT64_TIMESTAMP_MS), v.transform((value) => BigInt(value) * MS_TO_NS)));
+const OptionalTimestampMsToUsInputSchema = v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(MAX_UINT64_TIMESTAMP_MS_US), v.transform((value) => BigInt(value) * MS_TO_US)));
+const OptionalTimestampSecondsInputSchema = v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(Number.MAX_SAFE_INTEGER), v.transform((value) => BigInt(value))));
+const PublicIdSchema = v.pipe(v.bigint(), v.transform((value) => formatId(value)));
+const OptionalPublicIdSchema = v.pipe(v.optional(v.bigint()), v.transform((value) => value ? formatId(value) : void 0));
+const TrimmedStringSchema = v.pipe(v.string(), v.trim());
+const OptionalTrimmedStringSchema = v.optional(TrimmedStringSchema);
+/**
+* Creates a schema for required public id input.
+*/
+function idInputSchema(fieldName) {
+	return v.pipe(v.string(), v.trim(), v.minLength(1), v.transform((value) => idToBigInt(value, fieldName)));
+}
+/**
+* Creates a schema for optional public id input.
+*/
+function optionalIdInputSchema(fieldName) {
+	return v.pipe(OptionalTrimmedStringSchema, v.transform((value) => value ? idToBigInt(value, fieldName) : void 0));
+}
+/**
+* Creates a schema for optional subaccount id input.
+*/
+function optionalSubaccountIdInputSchema() {
+	return optionalIdInputSchema("subaccountId");
+}
+/**
+* Creates a schema for optional uint64 decimal filter input.
+*/
+function optionalUint64DecimalFilterSchema(fieldName) {
+	return v.pipe(OptionalTrimmedStringSchema, v.transform((value) => parseOptionalUint64DecimalStrict(value, fieldName)));
+}
+function bigintStringInputSchema(fieldName) {
+	return v.pipe(TrimmedStringSchema, v.regex(/^\d+$/, `${fieldName} must be a decimal integer`), v.transform((value) => BigInt(value)));
+}
+function positiveBigintStringInputSchema(fieldName) {
+	return v.pipe(bigintStringInputSchema(fieldName), v.check((value) => value > 0n, `${fieldName} must be greater than 0`));
+}
+const JsonObjectSchema = v.custom((input) => typeof input === "object" && input !== null && !Array.isArray(input));
+//#endregion
+export { BigIntStringSchema, JsonObjectSchema, OptionalNumberDefaultNullSchema, OptionalNumberToBigIntOrZeroSchema, OptionalNumberToBpsOrZeroSchema, OptionalNumberToIntOrZeroSchema, OptionalPublicIdSchema, OptionalTimestampMsSchema, OptionalTimestampMsToUsInputSchema, OptionalTimestampSecondsInputSchema, PublicIdSchema, TimestampMsSchema, TimestampSchema, bigintStringInputSchema, idInputSchema, optionalIdInputSchema, optionalSubaccountIdInputSchema, optionalUint64DecimalFilterSchema, positiveBigintStringInputSchema };
+
+//# sourceMappingURL=schemas.js.map

package/dist/shared/schemas.js.map

@@ -0,0 +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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"}

package/dist/shared/subscription-errors.d.ts

@@ -0,0 +1,14 @@
+import "centrifuge/build/protobuf";
+//#region src/shared/subscription-errors.d.ts
+type SdkSubscriptionErrorDetails = {
+  code: number;
+  message: string;
+};
+type SdkSubscriptionErrorContext = {
+  channel: string;
+  type: string;
+  error: Error | SdkSubscriptionErrorDetails;
+};
+//#endregion
+export { SdkSubscriptionErrorContext, SdkSubscriptionErrorDetails };
+//# sourceMappingURL=subscription-errors.d.ts.map

package/dist/shared/subscription-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-errors.d.ts","names":[],"sources":["../../src/shared/subscription-errors.ts"],"mappings":";;KAEY;EACR;EACA;;KAGQ;EACR;EACA;EACA,OAAO,QAAQ"}