@polyester/sdk 0.27.3 → 0.28.1

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

@@ -1,4 +1,4 @@
-import { AlreadyExistsError, AuthenticationError, InternalServerError, MfaEnrollmentRequiredError, MfaLastFactorRequiredError, MfaVerificationError, PermissionError, PolicyInUseError, PolicyLockedError, PolicyScopeMismatchError, PolyesterError, PreconditionFailedError, RateLimitError, ResourceNotFoundError, RevisionConflictError, ServiceUnavailableError, SessionElevationRequiredError, StaleQuoteError, StepUpRequiredError, SubaccountChallengeInvalidError, TimeoutError, TransientError, ValidationError, isAbortError, normalizeErrorMessage } from "./errors.js";
+import { AlreadyExistsError, AuthenticationError, InternalServerError, MfaEnrollmentRequiredError, MfaLastFactorRequiredError, MfaVerificationError, NotImplementedError, PermissionError, PolicyInUseError, PolicyLockedError, PolicyScopeMismatchError, PolyesterError, PreconditionFailedError, RateLimitError, ResourceNotFoundError, RevisionConflictError, ServiceUnavailableError, SessionElevationRequiredError, StaleQuoteError, StepUpRequiredError, SubaccountChallengeInvalidError, TimeoutError, TransientError, ValidationError, errorFromHttpStatus, isAbortError, normalizeErrorMessage } from "./errors.js";
 import { parseConnectErrorDetail } from "./error-detail.js";
 import { Code, ConnectError } from "@connectrpc/connect";
 //#region src/shared/connect-error-mapping.ts
@@ -76,6 +76,11 @@ function connectErrorToPolyesterError(ce) {
 		detail
 	};
 	const withFallback = (fallback) => message || fallback;
+	const httpStatus = /^HTTP (\d{3})$/u.exec(ce.rawMessage)?.[1];
+	if (!detail && httpStatus && httpStatus !== "404") return errorFromHttpStatus(Number(httpStatus), message, {
+		...options,
+		retryAfterMs: parseRetryAfterMs(ce)
+	});
 	if (detail?.service === "auth" && detail.code === "AUTH_RESOURCE_NOT_FOUND") return new ResourceNotFoundError(withFallback("Resource not found."), options);
 	if (detail?.service === "auth" && detail.code === "AUTH_REVISION_CONFLICT") return new RevisionConflictError(withFallback("Resource changed since it was last read."), options);
 	if (detail?.service === "auth" && detail.code === "AUTH_SUBACCOUNT_CHALLENGE_INVALID") return new SubaccountChallengeInvalidError(withFallback("Subaccount challenge is expired, replaced, or invalid."), options);
@@ -110,6 +115,7 @@ function connectErrorToPolyesterError(ce) {
 		});
 		case Code.DeadlineExceeded: return new TimeoutError(withFallback("Request timed out."), options);
 		case Code.Unavailable: return new ServiceUnavailableError(withFallback("Service unavailable."), options);
+		case Code.Unimplemented: return new NotImplementedError(withFallback("Operation not implemented."), options);
 		case Code.Aborted: return new TransientError(withFallback("Operation aborted by the backend."), options);
 		default:
 			if (/service temporarily unavailable/i.test(message)) return new ServiceUnavailableError(withFallback("Service unavailable."), options);

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

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

package/dist/shared/errors.d.ts

@@ -20,6 +20,7 @@ import { RateLimitDetail } from "./rate-limit.schemas.js";
  * │   │   ├── StaleQuoteError            STALE_QUOTE
  * │   │   └── PolicyScopeMismatchError   POLICY_SCOPE_MISMATCH
  * │   ├── ResourceNotFoundError      RESOURCE_NOT_FOUND          false
+ * │   ├── NotImplementedError        NOT_IMPLEMENTED             false
  * │   ├── AlreadyExistsError         ALREADY_EXISTS              false
  * │   ├── PermissionError            PERMISSION_DENIED           false
  * │   ├── AuthenticationError        UNAUTHENTICATED             false
@@ -56,7 +57,7 @@ import { RateLimitDetail } from "./rate-limit.schemas.js";
  * ```
  */
 /** Stable machine-readable codes carried by built-in SDK errors. */
-type PolyesterErrorCode = "TRANSIENT_FAILURE" | "NETWORK_ERROR" | "TIMEOUT" | "RATE_LIMITED" | "SERVICE_UNAVAILABLE" | "REQUEST_FAILED" | "VALIDATION_FAILED" | "STALE_QUOTE" | "RESOURCE_NOT_FOUND" | "ALREADY_EXISTS" | "PERMISSION_DENIED" | "UNAUTHENTICATED" | "PRECONDITION_FAILED" | "REVISION_CONFLICT" | "POLICY_IN_USE" | "POLICY_LOCKED" | "POLICY_SCOPE_MISMATCH" | "INVALID_CONFIGURATION" | "MFA_REQUIRED" | "MFA_ENROLLMENT_REQUIRED" | "STEP_UP_REQUIRED" | "SESSION_ELEVATION_REQUIRED" | "MFA_LAST_FACTOR_REQUIRED" | "MFA_VERIFICATION_FAILED" | "INTERNAL_SERVER_ERROR" | "CATALOG_LOOKUP_MISS" | "CATALOG_NOT_READY" | "CATALOG_CONVERSION_INVALID" | "CATALOG_VALIDATION_FAILED";
+type PolyesterErrorCode = "TRANSIENT_FAILURE" | "NETWORK_ERROR" | "TIMEOUT" | "RATE_LIMITED" | "SERVICE_UNAVAILABLE" | "REQUEST_FAILED" | "VALIDATION_FAILED" | "STALE_QUOTE" | "RESOURCE_NOT_FOUND" | "NOT_IMPLEMENTED" | "ALREADY_EXISTS" | "PERMISSION_DENIED" | "UNAUTHENTICATED" | "PRECONDITION_FAILED" | "REVISION_CONFLICT" | "POLICY_IN_USE" | "POLICY_LOCKED" | "POLICY_SCOPE_MISMATCH" | "INVALID_CONFIGURATION" | "MFA_REQUIRED" | "MFA_ENROLLMENT_REQUIRED" | "STEP_UP_REQUIRED" | "SESSION_ELEVATION_REQUIRED" | "MFA_LAST_FACTOR_REQUIRED" | "MFA_VERIFICATION_FAILED" | "INTERNAL_SERVER_ERROR" | "CATALOG_LOOKUP_MISS" | "CATALOG_NOT_READY" | "CATALOG_CONVERSION_INVALID" | "CATALOG_VALIDATION_FAILED";
 interface PolyesterErrorOptions {
   /** Underlying error, typically the original `ConnectError` for RPC failures. */
   cause?: unknown;
@@ -144,6 +145,11 @@ declare class ResourceNotFoundError extends RequestError {
   readonly code: string;
   constructor(message: string, options?: PolyesterErrorOptions);
 }
+/** The backend does not implement the requested operation (HTTP 501 / Connect `unimplemented`). */
+declare class NotImplementedError extends RequestError {
+  readonly code: string;
+  constructor(message: string, options?: PolyesterErrorOptions);
+}
 /** The resource already exists (e.g. a duplicate `clientOrderId`). */
 declare class AlreadyExistsError extends RequestError {
   readonly code: string;
@@ -256,7 +262,7 @@ declare class InternalServerError extends PolyesterError {
  */
 declare function isAbortError(err: unknown): boolean;
 /** Maps a plain HTTP status code onto the SDK error tree. */
-declare function errorFromHttpStatus(status: number, message: string, options?: PolyesterErrorOptions): PolyesterError;
+declare function errorFromHttpStatus(status: number, message: string, options?: RateLimitErrorOptions): PolyesterError;
 //#endregion
-export { AlreadyExistsError, AuthenticationError, ConfigurationError, InternalServerError, MfaEnrollmentRequiredError, MfaLastFactorRequiredError, MfaRequiredError, MfaVerificationError, MfaVerificationFailureReason, NetworkError, PermissionError, PolicyInUseError, PolicyLockedError, PolicyScopeMismatchError, PolyesterError, PolyesterErrorCode, type PolyesterErrorDetail, PolyesterErrorOptions, PreconditionFailedError, RateLimitError, RateLimitErrorOptions, RequestError, ResourceNotFoundError, RevisionConflictError, ServiceUnavailableError, SessionElevationRequiredError, StaleQuoteError, StepUpRequiredError, SubaccountChallengeInvalidError, TimeoutError, TransientError, ValidationError, errorFromHttpStatus, isAbortError, normalizeErrorMessage };
+export { AlreadyExistsError, AuthenticationError, ConfigurationError, InternalServerError, MfaEnrollmentRequiredError, MfaLastFactorRequiredError, MfaRequiredError, MfaVerificationError, MfaVerificationFailureReason, NetworkError, NotImplementedError, PermissionError, PolicyInUseError, PolicyLockedError, PolicyScopeMismatchError, PolyesterError, PolyesterErrorCode, type PolyesterErrorDetail, PolyesterErrorOptions, PreconditionFailedError, RateLimitError, RateLimitErrorOptions, RequestError, ResourceNotFoundError, RevisionConflictError, ServiceUnavailableError, SessionElevationRequiredError, StaleQuoteError, StepUpRequiredError, SubaccountChallengeInvalidError, TimeoutError, TransientError, ValidationError, errorFromHttpStatus, isAbortError, normalizeErrorMessage };
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/shared/errors.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4DY;UA+BK;;EAEb;;EAEA,SAAS;;iBAKG,sBAAsB;;;;;;;;uBAWhB,uBAAuB;;oBAEvB;;oBAEA;WACT,QAAQ;EAEL,YAAA,iBAAiB,UAAU;;;;;;;;cAe9B,uBAAuB;WACvB;WACA;EAEG,YAAA,iBAAiB,UAAU;;;cAO9B,qBAAqB;WACZ;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,qBAAqB;WACZ;EAEN,YAAA,iBAAiB,UAAU;;UAM1B,8BAA8B;;EAE3C;;EAEA,YAAY;;;cAIH,uBAAuB;WACd;;WAET;;WAEA,YAAY;EAET,YAAA,iBAAiB,UAAU;;;cAS9B,gCAAgC;WACvB;EAEN,YAAA,iBAAiB,UAAU;;;;;;cAU9B,qBAAqB;WACrB;WACA;EAEG,YAAA,iBAAiB,UAAU;;;cAO9B,wBAAwB;WACf;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,wBAAwB;WACf;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,8BAA8B;WACrB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,2BAA2B;WAClB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,wBAAwB;WACf;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,4BAA4B;WACnB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,gCAAgC;WACvB;EAEN,YAAA,iBAAiB,UAAU;;;;;;cAU9B,8BAA8B;WACrB;EAEN,YAAA,iBAAiB,UAAU;;;;;;cAU9B,wCAAwC;WAC/B;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,yBAAyB;WAChB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,0BAA0B;WACjB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,iCAAiC;WACxB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,2BAA2B;WAClB;EAEN,YAAA,iBAAiB,UAAU;;;;;;cAU9B,yBAAyB;WAChB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,mCAAmC;WAC1B;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,4BAA4B;WACnB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,sCAAsC;WAC7B;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,mCAAmC;WAC1B;EAEN,YAAA,iBAAiB,UAAU;;;KAO/B;;;;;cAWC,6BAA6B;WAKzB,QAAQ;WAJH;EAGd,YAAA,iBACS,QAAQ,8BACjB,UAAU;;;;;;;cAYL,4BAA4B;WAC5B;WACA;EAEG,YAAA,iBAAiB,UAAU;;;;;;;iBAW3B,aAAa;;iBAKb,oBACZ,gBACA,iBACA,UAAU,wBACX"}
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/shared/errors.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA6DY;UAgCK;;EAEb;;EAEA,SAAS;;iBAKG,sBAAsB;;;;;;;;uBAWhB,uBAAuB;;oBAEvB;;oBAEA;WACT,QAAQ;EAEL,YAAA,iBAAiB,UAAU;;;;;;;;cAe9B,uBAAuB;WACvB;WACA;EAEG,YAAA,iBAAiB,UAAU;;;cAO9B,qBAAqB;WACZ;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,qBAAqB;WACZ;EAEN,YAAA,iBAAiB,UAAU;;UAM1B,8BAA8B;;EAE3C;;EAEA,YAAY;;;cAIH,uBAAuB;WACd;;WAET;;WAEA,YAAY;EAET,YAAA,iBAAiB,UAAU;;;cAS9B,gCAAgC;WACvB;EAEN,YAAA,iBAAiB,UAAU;;;;;;cAU9B,qBAAqB;WACrB;WACA;EAEG,YAAA,iBAAiB,UAAU;;;cAO9B,wBAAwB;WACf;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,wBAAwB;WACf;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,8BAA8B;WACrB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,4BAA4B;WACnB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,2BAA2B;WAClB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,wBAAwB;WACf;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,4BAA4B;WACnB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,gCAAgC;WACvB;EAEN,YAAA,iBAAiB,UAAU;;;;;;cAU9B,8BAA8B;WACrB;EAEN,YAAA,iBAAiB,UAAU;;;;;;cAU9B,wCAAwC;WAC/B;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,yBAAyB;WAChB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,0BAA0B;WACjB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,iCAAiC;WACxB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,2BAA2B;WAClB;EAEN,YAAA,iBAAiB,UAAU;;;;;;cAU9B,yBAAyB;WAChB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,mCAAmC;WAC1B;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,4BAA4B;WACnB;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,sCAAsC;WAC7B;EAEN,YAAA,iBAAiB,UAAU;;;cAO9B,mCAAmC;WAC1B;EAEN,YAAA,iBAAiB,UAAU;;;KAO/B;;;;;cAWC,6BAA6B;WAKzB,QAAQ;WAJH;EAGd,YAAA,iBACS,QAAQ,8BACjB,UAAU;;;;;;;cAYL,4BAA4B;WAC5B;WACA;EAEG,YAAA,iBAAiB,UAAU;;;;;;;iBAW3B,aAAa;;iBAKb,oBACZ,gBACA,iBACA,UAAU,wBACX"}

package/dist/shared/errors.js

@@ -106,6 +106,14 @@ var ResourceNotFoundError = class extends RequestError {
 		this.name = "ResourceNotFoundError";
 	}
 };
+/** The backend does not implement the requested operation (HTTP 501 / Connect `unimplemented`). */
+var NotImplementedError = class extends RequestError {
+	code = "NOT_IMPLEMENTED";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "NotImplementedError";
+	}
+};
 /** The resource already exists (e.g. a duplicate `clientOrderId`). */
 var AlreadyExistsError = class extends RequestError {
 	code = "ALREADY_EXISTS";
@@ -271,18 +279,21 @@ function isAbortError(err) {
 }
 /** Maps a plain HTTP status code onto the SDK error tree. */
 function errorFromHttpStatus(status, message, options) {
+	if (status === 400 || status === 422) return new ValidationError(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 === 412) return new PreconditionFailedError(message, options);
 	if (status === 429) return new RateLimitError(message, options);
+	if (status === 501) return new NotImplementedError(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, SubaccountChallengeInvalidError, TimeoutError, TransientError, ValidationError, errorFromHttpStatus, isAbortError, normalizeErrorMessage };
+export { AlreadyExistsError, AuthenticationError, ConfigurationError, InternalServerError, MfaEnrollmentRequiredError, MfaLastFactorRequiredError, MfaRequiredError, MfaVerificationError, NetworkError, NotImplementedError, PermissionError, PolicyInUseError, PolicyLockedError, PolicyScopeMismatchError, PolyesterError, PreconditionFailedError, RateLimitError, RequestError, ResourceNotFoundError, RevisionConflictError, ServiceUnavailableError, SessionElevationRequiredError, StaleQuoteError, StepUpRequiredError, SubaccountChallengeInvalidError, TimeoutError, TransientError, ValidationError, errorFromHttpStatus, isAbortError, normalizeErrorMessage };
 
 //# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../src/shared/errors.ts"],"sourcesContent":["import type { PolyesterErrorDetail } from \"./error-detail.js\";\nexport type { PolyesterErrorDetail } from \"./error-detail.js\";\nimport type { RateLimitDetail } from \"./rate-limit.schemas.js\";\n\n/**\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 * │   │   ├── StaleQuoteError            STALE_QUOTE\n * │   │   └── PolicyScopeMismatchError   POLICY_SCOPE_MISMATCH\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 * │   │   ├── SubaccountChallengeInvalidError SUBACCOUNT_CHALLENGE_INVALID\n * │   │   └── MfaLastFactorRequiredError     MFA_LAST_FACTOR_REQUIRED\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 * │   └── 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    /** Recognized structured backend rejection, decoded at the RPC boundary. */\n    detail?: PolyesterErrorDetail;\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    readonly detail: PolyesterErrorDetail | undefined;\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(normalizeErrorMessage(message), options);\n        this.name = \"PolyesterError\";\n        this.detail =\n            options?.detail ??\n            (options?.cause instanceof PolyesterError ? options.cause.detail : undefined);\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. Follow the operation's retry\n * contract: reuse requestId for idempotent mutations. For single-order creation,\n * reconcile by clientOrderId; reusing it returns a conflict rather than replay.\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    /** Structured quota state attached to the rejection, when provided. */\n    rateLimit?: RateLimitDetail;\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    /** Structured quota state attached to the rejection, when provided. */\n    readonly rateLimit?: RateLimitDetail;\n\n    constructor(message: string, options?: RateLimitErrorOptions) {\n        super(message, options);\n        this.name = \"RateLimitError\";\n        this.retryAfterMs = options?.retryAfterMs;\n        this.rateLimit = options?.rateLimit;\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/**\n * The subaccount authorization is expired, replaced by a newer challenge, replayed,\n * or otherwise invalid. Request a fresh challenge via `subaccounts.createChallenge`.\n */\nexport class SubaccountChallengeInvalidError extends PreconditionFailedError {\n    override readonly code: string = \"SUBACCOUNT_CHALLENGE_INVALID\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"SubaccountChallengeInvalidError\";\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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"}
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/shared/errors.ts"],"sourcesContent":["import type { PolyesterErrorDetail } from \"./error-detail.js\";\nexport type { PolyesterErrorDetail } from \"./error-detail.js\";\nimport type { RateLimitDetail } from \"./rate-limit.schemas.js\";\n\n/**\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 * │   │   ├── StaleQuoteError            STALE_QUOTE\n * │   │   └── PolicyScopeMismatchError   POLICY_SCOPE_MISMATCH\n * │   ├── ResourceNotFoundError      RESOURCE_NOT_FOUND          false\n * │   ├── NotImplementedError        NOT_IMPLEMENTED             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 * │   │   ├── SubaccountChallengeInvalidError SUBACCOUNT_CHALLENGE_INVALID\n * │   │   └── MfaLastFactorRequiredError     MFA_LAST_FACTOR_REQUIRED\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 * │   └── 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    | \"NOT_IMPLEMENTED\"\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    /** Recognized structured backend rejection, decoded at the RPC boundary. */\n    detail?: PolyesterErrorDetail;\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    readonly detail: PolyesterErrorDetail | undefined;\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(normalizeErrorMessage(message), options);\n        this.name = \"PolyesterError\";\n        this.detail =\n            options?.detail ??\n            (options?.cause instanceof PolyesterError ? options.cause.detail : undefined);\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. Follow the operation's retry\n * contract: reuse requestId for idempotent mutations. For single-order creation,\n * reconcile by clientOrderId; reusing it returns a conflict rather than replay.\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    /** Structured quota state attached to the rejection, when provided. */\n    rateLimit?: RateLimitDetail;\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    /** Structured quota state attached to the rejection, when provided. */\n    readonly rateLimit?: RateLimitDetail;\n\n    constructor(message: string, options?: RateLimitErrorOptions) {\n        super(message, options);\n        this.name = \"RateLimitError\";\n        this.retryAfterMs = options?.retryAfterMs;\n        this.rateLimit = options?.rateLimit;\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 backend does not implement the requested operation (HTTP 501 / Connect `unimplemented`). */\nexport class NotImplementedError extends RequestError {\n    override readonly code: string = \"NOT_IMPLEMENTED\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"NotImplementedError\";\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/**\n * The subaccount authorization is expired, replaced by a newer challenge, replayed,\n * or otherwise invalid. Request a fresh challenge via `subaccounts.createChallenge`.\n */\nexport class SubaccountChallengeInvalidError extends PreconditionFailedError {\n    override readonly code: string = \"SUBACCOUNT_CHALLENGE_INVALID\";\n\n    constructor(message: string, options?: PolyesterErrorOptions) {\n        super(message, options);\n        this.name = \"SubaccountChallengeInvalidError\";\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?: RateLimitErrorOptions,\n): PolyesterError {\n    if (status === 400 || status === 422) return new ValidationError(message, options);\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 === 412) return new PreconditionFailedError(message, options);\n    if (status === 429) return new RateLimitError(message, options);\n    if (status === 501) return new NotImplementedError(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/wire-bounds.js

@@ -1,11 +1,9 @@
 //#region src/shared/wire-bounds.ts
 /** Largest value encodable by a protobuf `int64` field. */
 const PROTOBUF_INT64_MAX = 9223372036854775807n;
-/** Largest value encodable by a protobuf `int32` field. */
-const PROTOBUF_INT32_MAX = 2147483647n;
 /** Largest value encodable by a protobuf `uint32` field. */
 const PROTOBUF_UINT32_MAX = 4294967295;
 //#endregion
-export { PROTOBUF_INT32_MAX, PROTOBUF_INT64_MAX, PROTOBUF_UINT32_MAX };
+export { PROTOBUF_INT64_MAX, PROTOBUF_UINT32_MAX };
 
 //# sourceMappingURL=wire-bounds.js.map

package/dist/shared/wire-bounds.js.map

@@ -1 +1 @@
-{"version":3,"file":"wire-bounds.js","names":[],"sources":["../../src/shared/wire-bounds.ts"],"sourcesContent":["/** Largest value encodable by a protobuf `int64` field. */\nexport const PROTOBUF_INT64_MAX = 9_223_372_036_854_775_807n;\n\n/** Largest value encodable by a protobuf `int32` field. */\nexport const PROTOBUF_INT32_MAX = 2_147_483_647n;\n\n/** Largest value encodable by a protobuf `uint32` field. */\nexport const PROTOBUF_UINT32_MAX = 4_294_967_295;\n"],"mappings":";;AACA,MAAa,qBAAqB;;AAGlC,MAAa,qBAAqB;;AAGlC,MAAa,sBAAsB"}
+{"version":3,"file":"wire-bounds.js","names":[],"sources":["../../src/shared/wire-bounds.ts"],"sourcesContent":["/** Largest value encodable by a protobuf `int64` field. */\nexport const PROTOBUF_INT64_MAX = 9_223_372_036_854_775_807n;\n\n/** Largest value encodable by a protobuf `int32` field. */\nexport const PROTOBUF_INT32_MAX = 2_147_483_647n;\n\n/** Largest value encodable by a protobuf `uint32` field. */\nexport const PROTOBUF_UINT32_MAX = 4_294_967_295;\n"],"mappings":";;AACA,MAAa,qBAAqB;;AAMlC,MAAa,sBAAsB"}

package/package.json

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