@polyester/sdk 0.19.3 → 0.20.0

package/dist/shared/error-detail.js

@@ -0,0 +1,106 @@
+import { AuthErrorCode, AuthErrorDetailSchema } from "../gen/auth/v1/auth_pb.js";
+import { ProfileErrorCode, ProfileErrorDetailSchema } from "../gen/auth/v1/profile_pb.js";
+import { ErrorCode, ErrorDetailSchema } from "../gen/chain/withdraw/v1/withdraw_pb.js";
+import { ErrorCode as ErrorCode$1, ErrorDetailSchema as ErrorDetailSchema$1 } from "../gen/ledger/read/v1/ledger_read_pb.js";
+import { ErrorCode as ErrorCode$2, ErrorDetailSchema as ErrorDetailSchema$2 } from "../gen/marketoverview/v1/marketoverview_pb.js";
+import { ErrorDetailSchema as ErrorDetailSchema$3 } from "../gen/orders/v1/orders_pb.js";
+import { ErrorCode as ErrorCode$3, ErrorDetailSchema as ErrorDetailSchema$4 } from "../gen/transfer/v1/internal_transfer_pb.js";
+import { OrderErrorDetailSchema } from "../services/orders/order-errors.schemas.js";
+import { create, fromBinary } from "@bufbuild/protobuf";
+import * as v from "valibot";
+//#region src/shared/error-detail.ts
+function codeName(codes, code) {
+	if (typeof code !== "number") return void 0;
+	const name = codes[code];
+	return typeof name === "string" ? name : void 0;
+}
+function decodeDetail(detail, schema) {
+	try {
+		if ("desc" in detail) return create(schema, detail.value);
+		return fromBinary(schema, detail.value);
+	} catch {
+		return;
+	}
+}
+/** Decodes the first valid backend rejection detail, preserving wire-detail order. */
+function parseConnectErrorDetail(error) {
+	for (const raw of error.details) switch ("desc" in raw ? raw.desc.typeName : raw.type) {
+		case AuthErrorDetailSchema.typeName: {
+			const auth = decodeDetail(raw, AuthErrorDetailSchema);
+			if (!auth) break;
+			const code = codeName(AuthErrorCode, auth.code);
+			if (code) return {
+				service: "auth",
+				code,
+				message: auth.message
+			};
+			break;
+		}
+		case ProfileErrorDetailSchema.typeName: {
+			const profile = decodeDetail(raw, ProfileErrorDetailSchema);
+			if (!profile) break;
+			const code = codeName(ProfileErrorCode, profile.code);
+			if (code) return {
+				service: "profile",
+				code,
+				field: profile.field,
+				message: profile.message
+			};
+			break;
+		}
+		case ErrorDetailSchema$3.typeName: {
+			const order = decodeDetail(raw, ErrorDetailSchema$3);
+			if (!order) break;
+			const parsed = v.safeParse(OrderErrorDetailSchema, order);
+			if (parsed.success) return {
+				service: "orders",
+				...parsed.output
+			};
+			break;
+		}
+		case ErrorDetailSchema.typeName: {
+			const withdraw = decodeDetail(raw, ErrorDetailSchema);
+			if (!withdraw) break;
+			const code = codeName(ErrorCode, withdraw.code);
+			if (code) return {
+				service: "withdraw",
+				code
+			};
+			break;
+		}
+		case ErrorDetailSchema$4.typeName: {
+			const transfer = decodeDetail(raw, ErrorDetailSchema$4);
+			if (!transfer) break;
+			const code = codeName(ErrorCode$3, transfer.code);
+			if (code) return {
+				service: "internal_transfer",
+				code
+			};
+			break;
+		}
+		case ErrorDetailSchema$1.typeName: {
+			const ledger = decodeDetail(raw, ErrorDetailSchema$1);
+			if (!ledger) break;
+			const code = codeName(ErrorCode$1, ledger.code);
+			if (code) return {
+				service: "ledger",
+				code
+			};
+			break;
+		}
+		case ErrorDetailSchema$2.typeName: {
+			const marketOverview = decodeDetail(raw, ErrorDetailSchema$2);
+			if (!marketOverview) break;
+			const code = codeName(ErrorCode$2, marketOverview.code);
+			if (code) return {
+				service: "market_overview",
+				code
+			};
+			break;
+		}
+	}
+}
+//#endregion
+export { parseConnectErrorDetail };
+
+//# sourceMappingURL=error-detail.js.map

package/dist/shared/error-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-detail.js","names":["OrderErrorDetailSchema","ParsedOrderErrorDetailSchema","WithdrawErrorDetailSchema","WithdrawErrorCode","InternalTransferErrorDetailSchema","InternalTransferErrorCode","LedgerErrorDetailSchema","LedgerErrorCode","MarketOverviewErrorDetailSchema","MarketOverviewErrorCode"],"sources":["../../src/shared/error-detail.ts"],"sourcesContent":["import {\n    create,\n    fromBinary,\n    type DescMessage,\n    type MessageInitShape,\n    type MessageShape,\n} from \"@bufbuild/protobuf\";\nimport type { ConnectError } from \"@connectrpc/connect\";\nimport * as v from \"valibot\";\nimport { AuthErrorCode, AuthErrorDetailSchema } from \"../gen/auth/v1/auth_pb.js\";\nimport { ProfileErrorCode, ProfileErrorDetailSchema } from \"../gen/auth/v1/profile_pb.js\";\nimport {\n    ErrorCode as WithdrawErrorCode,\n    ErrorDetailSchema as WithdrawErrorDetailSchema,\n} from \"../gen/chain/withdraw/v1/withdraw_pb.js\";\nimport {\n    ErrorCode as LedgerErrorCode,\n    ErrorDetailSchema as LedgerErrorDetailSchema,\n} from \"../gen/ledger/read/v1/ledger_read_pb.js\";\nimport {\n    ErrorCode as MarketOverviewErrorCode,\n    ErrorDetailSchema as MarketOverviewErrorDetailSchema,\n} from \"../gen/marketoverview/v1/marketoverview_pb.js\";\nimport { ErrorDetailSchema as OrderErrorDetailSchema } from \"../gen/orders/v1/orders_pb.js\";\nimport {\n    ErrorCode as InternalTransferErrorCode,\n    ErrorDetailSchema as InternalTransferErrorDetailSchema,\n} from \"../gen/transfer/v1/internal_transfer_pb.js\";\nimport {\n    OrderErrorDetailSchema as ParsedOrderErrorDetailSchema,\n    type OrderErrorDetail,\n} from \"../services/orders/order-errors.schemas.js\";\n\ntype NamedCode<Enum extends Record<number, string>> = keyof Enum;\n\nexport type PolyesterErrorDetail =\n    | { service: \"auth\"; code: NamedCode<typeof AuthErrorCode>; message: string }\n    | {\n          service: \"profile\";\n          code: NamedCode<typeof ProfileErrorCode>;\n          field: string;\n          message: string;\n      }\n    | ({ service: \"orders\" } & OrderErrorDetail)\n    | { service: \"withdraw\"; code: NamedCode<typeof WithdrawErrorCode> }\n    | {\n          service: \"internal_transfer\";\n          code: NamedCode<typeof InternalTransferErrorCode>;\n      }\n    | { service: \"ledger\"; code: NamedCode<typeof LedgerErrorCode> }\n    | {\n          service: \"market_overview\";\n          code: NamedCode<typeof MarketOverviewErrorCode>;\n      };\n\nfunction codeName<Enum extends Record<number, string>>(\n    codes: Enum,\n    code: number,\n): NamedCode<Enum> | undefined {\n    if (typeof code !== \"number\") return undefined;\n    const name = codes[code];\n    return typeof name === \"string\" ? (name as NamedCode<Enum>) : undefined;\n}\n\nfunction decodeDetail<Desc extends DescMessage>(\n    detail: ConnectError[\"details\"][number],\n    schema: Desc,\n): MessageShape<Desc> | undefined {\n    try {\n        if (\"desc\" in detail) {\n            return create(schema, detail.value as MessageInitShape<Desc>);\n        }\n        return fromBinary(schema, detail.value);\n    } catch {\n        return undefined;\n    }\n}\n\n/** Decodes the first valid backend rejection detail, preserving wire-detail order. */\nexport function parseConnectErrorDetail(error: ConnectError): PolyesterErrorDetail | undefined {\n    for (const raw of error.details) {\n        const typeName = \"desc\" in raw ? raw.desc.typeName : raw.type;\n        switch (typeName) {\n            case AuthErrorDetailSchema.typeName: {\n                const auth = decodeDetail(raw, AuthErrorDetailSchema);\n                if (!auth) break;\n                const code = codeName(AuthErrorCode, auth.code);\n                if (code) {\n                    return { service: \"auth\", code, message: auth.message };\n                }\n                break;\n            }\n            case ProfileErrorDetailSchema.typeName: {\n                const profile = decodeDetail(raw, ProfileErrorDetailSchema);\n                if (!profile) break;\n                const code = codeName(ProfileErrorCode, profile.code);\n                if (code) {\n                    return {\n                        service: \"profile\",\n                        code,\n                        field: profile.field,\n                        message: profile.message,\n                    };\n                }\n                break;\n            }\n            case OrderErrorDetailSchema.typeName: {\n                const order = decodeDetail(raw, OrderErrorDetailSchema);\n                if (!order) break;\n                const parsed = v.safeParse(ParsedOrderErrorDetailSchema, order);\n                if (parsed.success) return { service: \"orders\", ...parsed.output };\n                break;\n            }\n            case WithdrawErrorDetailSchema.typeName: {\n                const withdraw = decodeDetail(raw, WithdrawErrorDetailSchema);\n                if (!withdraw) break;\n                const code = codeName(WithdrawErrorCode, withdraw.code);\n                if (code) return { service: \"withdraw\", code };\n                break;\n            }\n            case InternalTransferErrorDetailSchema.typeName: {\n                const transfer = decodeDetail(raw, InternalTransferErrorDetailSchema);\n                if (!transfer) break;\n                const code = codeName(InternalTransferErrorCode, transfer.code);\n                if (code) return { service: \"internal_transfer\", code };\n                break;\n            }\n            case LedgerErrorDetailSchema.typeName: {\n                const ledger = decodeDetail(raw, LedgerErrorDetailSchema);\n                if (!ledger) break;\n                const code = codeName(LedgerErrorCode, ledger.code);\n                if (code) return { service: \"ledger\", code };\n                break;\n            }\n            case MarketOverviewErrorDetailSchema.typeName: {\n                const marketOverview = decodeDetail(raw, MarketOverviewErrorDetailSchema);\n                if (!marketOverview) break;\n                const code = codeName(MarketOverviewErrorCode, marketOverview.code);\n                if (code) return { service: \"market_overview\", code };\n                break;\n            }\n        }\n    }\n    return undefined;\n}\n"],"mappings":";;;;;;;;;;;AAuDA,SAAS,SACL,OACA,MAC2B;CAC3B,IAAI,OAAO,SAAS,UAAU,OAAO,KAAA;CACrC,MAAM,OAAO,MAAM;CACnB,OAAO,OAAO,SAAS,WAAY,OAA2B,KAAA;AAClE;AAEA,SAAS,aACL,QACA,QAC8B;CAC9B,IAAI;EACA,IAAI,UAAU,QACV,OAAO,OAAO,QAAQ,OAAO,KAA+B;EAEhE,OAAO,WAAW,QAAQ,OAAO,KAAK;CAC1C,QAAQ;EACJ;CACJ;AACJ;;AAGA,SAAgB,wBAAwB,OAAuD;CAC3F,KAAK,MAAM,OAAO,MAAM,SAEpB,QADiB,UAAU,MAAM,IAAI,KAAK,WAAW,IAAI,MACzD;EACI,KAAK,sBAAsB,UAAU;GACjC,MAAM,OAAO,aAAa,KAAK,qBAAqB;GACpD,IAAI,CAAC,MAAM;GACX,MAAM,OAAO,SAAS,eAAe,KAAK,IAAI;GAC9C,IAAI,MACA,OAAO;IAAE,SAAS;IAAQ;IAAM,SAAS,KAAK;GAAQ;GAE1D;EACJ;EACA,KAAK,yBAAyB,UAAU;GACpC,MAAM,UAAU,aAAa,KAAK,wBAAwB;GAC1D,IAAI,CAAC,SAAS;GACd,MAAM,OAAO,SAAS,kBAAkB,QAAQ,IAAI;GACpD,IAAI,MACA,OAAO;IACH,SAAS;IACT;IACA,OAAO,QAAQ;IACf,SAAS,QAAQ;GACrB;GAEJ;EACJ;EACA,KAAKA,oBAAuB,UAAU;GAClC,MAAM,QAAQ,aAAa,KAAKA,mBAAsB;GACtD,IAAI,CAAC,OAAO;GACZ,MAAM,SAAS,EAAE,UAAUC,wBAA8B,KAAK;GAC9D,IAAI,OAAO,SAAS,OAAO;IAAE,SAAS;IAAU,GAAG,OAAO;GAAO;GACjE;EACJ;EACA,KAAKC,kBAA0B,UAAU;GACrC,MAAM,WAAW,aAAa,KAAKA,iBAAyB;GAC5D,IAAI,CAAC,UAAU;GACf,MAAM,OAAO,SAASC,WAAmB,SAAS,IAAI;GACtD,IAAI,MAAM,OAAO;IAAE,SAAS;IAAY;GAAK;GAC7C;EACJ;EACA,KAAKC,oBAAkC,UAAU;GAC7C,MAAM,WAAW,aAAa,KAAKA,mBAAiC;GACpE,IAAI,CAAC,UAAU;GACf,MAAM,OAAO,SAASC,aAA2B,SAAS,IAAI;GAC9D,IAAI,MAAM,OAAO;IAAE,SAAS;IAAqB;GAAK;GACtD;EACJ;EACA,KAAKC,oBAAwB,UAAU;GACnC,MAAM,SAAS,aAAa,KAAKA,mBAAuB;GACxD,IAAI,CAAC,QAAQ;GACb,MAAM,OAAO,SAASC,aAAiB,OAAO,IAAI;GAClD,IAAI,MAAM,OAAO;IAAE,SAAS;IAAU;GAAK;GAC3C;EACJ;EACA,KAAKC,oBAAgC,UAAU;GAC3C,MAAM,iBAAiB,aAAa,KAAKA,mBAA+B;GACxE,IAAI,CAAC,gBAAgB;GACrB,MAAM,OAAO,SAASC,aAAyB,eAAe,IAAI;GAClE,IAAI,MAAM,OAAO;IAAE,SAAS;IAAmB;GAAK;GACpD;EACJ;CACJ;AAGR"}

package/dist/shared/errors.d.ts

@@ -1,3 +1,4 @@
+import { PolyesterErrorDetail } from "./error-detail.js";
 import { RateLimitDetail } from "./rate-limit.schemas.js";
 //#region src/shared/errors.d.ts
 /**
@@ -16,21 +17,22 @@ import { RateLimitDetail } from "./rate-limit.schemas.js";
  * │   └── ServiceUnavailableError    SERVICE_UNAVAILABLE         true
  * ├── RequestError                   REQUEST_FAILED              false
  * │   ├── ValidationError            VALIDATION_FAILED           false
+ * │   │   ├── StaleQuoteError            STALE_QUOTE
+ * │   │   └── PolicyScopeMismatchError   POLICY_SCOPE_MISMATCH
  * │   ├── ResourceNotFoundError      RESOURCE_NOT_FOUND          false
  * │   ├── AlreadyExistsError         ALREADY_EXISTS              false
  * │   ├── PermissionError            PERMISSION_DENIED           false
  * │   ├── AuthenticationError        UNAUTHENTICATED             false
  * │   ├── PreconditionFailedError    PRECONDITION_FAILED         false
- * │   │   ├── RevisionConflictError      REVISION_CONFLICT
- * │   │   ├── PolicyInUseError           POLICY_IN_USE
- * │   │   └── PolicyLockedError          POLICY_LOCKED
- * │   ├── PolicyScopeMismatchError   POLICY_SCOPE_MISMATCH       false
+ * │   │   ├── RevisionConflictError          REVISION_CONFLICT
+ * │   │   ├── PolicyInUseError               POLICY_IN_USE
+ * │   │   ├── PolicyLockedError              POLICY_LOCKED
+ * │   │   └── MfaLastFactorRequiredError     MFA_LAST_FACTOR_REQUIRED
  * │   ├── ConfigurationError         INVALID_CONFIGURATION       false
  * │   ├── MfaRequiredError           MFA_REQUIRED                false
  * │   │   ├── MfaEnrollmentRequiredError     MFA_ENROLLMENT_REQUIRED
  * │   │   ├── StepUpRequiredError            STEP_UP_REQUIRED
  * │   │   └── SessionElevationRequiredError  SESSION_ELEVATION_REQUIRED
- * │   ├── MfaLastFactorRequiredError  MFA_LAST_FACTOR_REQUIRED       false
  * │   └── MfaVerificationError       MFA_VERIFICATION_FAILED     false
  * └── InternalServerError            INTERNAL_SERVER_ERROR       false
  * ```
@@ -57,6 +59,8 @@ type PolyesterErrorCode = "TRANSIENT_FAILURE" | "NETWORK_ERROR" | "TIMEOUT" | "R
 interface PolyesterErrorOptions {
   /** Underlying error, typically the original `ConnectError` for RPC failures. */
   cause?: unknown;
+  /** Recognized structured backend rejection, decoded at the RPC boundary. */
+  detail?: PolyesterErrorDetail;
 }
 declare function normalizeErrorMessage(message: string): string;
 /**
@@ -71,6 +75,7 @@ declare abstract class PolyesterError extends Error {
   abstract readonly code: string;
   /** Whether retrying the same operation may succeed. */
   abstract readonly retryable: boolean;
+  readonly detail: PolyesterErrorDetail | undefined;
   constructor(message: string, options?: PolyesterErrorOptions);
 }
 /**
@@ -243,5 +248,5 @@ 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;
 //#endregion
-export { AlreadyExistsError, AuthenticationError, ConfigurationError, InternalServerError, MfaEnrollmentRequiredError, MfaLastFactorRequiredError, MfaRequiredError, MfaVerificationError, MfaVerificationFailureReason, NetworkError, PermissionError, PolicyInUseError, PolicyLockedError, PolicyScopeMismatchError, PolyesterError, PolyesterErrorCode, PolyesterErrorOptions, PreconditionFailedError, RateLimitError, RateLimitErrorOptions, RequestError, ResourceNotFoundError, RevisionConflictError, ServiceUnavailableError, SessionElevationRequiredError, StaleQuoteError, StepUpRequiredError, TimeoutError, TransientError, ValidationError, errorFromHttpStatus, isAbortError, normalizeErrorMessage };
+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, 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwDY;UA+BK;;EAEb;;iBAKY,sBAAsB;;;;;;;;uBAWhB,uBAAuB;;oBAEvB;;oBAEA;EAEN,YAAA,iBAAiB,UAAU;;;;;;;cAW9B,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;;;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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2DY;UA+BK;;EAEb;;EAEA,SAAS;;iBAKG,sBAAsB;;;;;;;;uBAWhB,uBAAuB;;oBAEvB;;oBAEA;WACT,QAAQ;EAEL,YAAA,iBAAiB,UAAU;;;;;;;cAc9B,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;;;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

@@ -10,10 +10,12 @@ function normalizeErrorMessage(message) {
 * same call can be safely retried, and switch on `code` for exhaustive,
 * minification-safe handling.
 */
-var PolyesterError = class extends Error {
+var PolyesterError = class PolyesterError extends Error {
+	detail;
 	constructor(message, options) {
 		super(normalizeErrorMessage(message), options);
 		this.name = "PolyesterError";
+		this.detail = options?.detail ?? (options?.cause instanceof PolyesterError ? options.cause.detail : void 0);
 	}
 };
 /**

package/dist/shared/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../src/shared/errors.ts"],"sourcesContent":["import 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 * │   ├── 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    /** 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/** 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 * │   ├── 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 * │   │   └── 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. 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    /** 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/** 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/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/utils/errors.ts"],"mappings":";;;;;;iBAoCgB,wBAAwB;;iBAcxB,wBAAwB;;iBAsBxB,mBAAmB;;iBAKnB,oBAAoB;;iBAKpB,2BAA2B;;;;;;iBAS3B,iBAAiB;;;;;;;;;;;iBAuBjB,mBACZ,cACA;iBA0CY,sBAAsB,gBAAgB"}
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/utils/errors.ts"],"mappings":";;;;;;iBAqBgB,wBAAwB;;iBAaxB,wBAAwB;;iBAsBxB,mBAAmB;;iBAKnB,oBAAoB;;iBAKpB,2BAA2B;;;;;;iBAS3B,iBAAiB;;;;;;;;;;;iBAuBjB,mBACZ,cACA;iBA0CY,sBAAsB,gBAAgB"}

package/dist/utils/errors.js

@@ -1,18 +1,7 @@
 import { NetworkError, PolicyInUseError, PolicyLockedError, PolicyScopeMismatchError, PolyesterError, RateLimitError, ResourceNotFoundError, RevisionConflictError, ServiceUnavailableError, TimeoutError, isAbortError } from "../shared/errors.js";
-import { AuthErrorDetailSchema } from "../gen/auth/v1/auth_pb.js";
 import { getNormalizedConnectMessage, toPolyesterError } from "../shared/connect-error-mapping.js";
 import { Code, ConnectError } from "@connectrpc/connect";
 //#region src/utils/errors.ts
-function hasAuthErrorCode(err, code) {
-	return ConnectError.from(err).findDetails(AuthErrorDetailSchema).some((detail) => detail.code === code);
-}
-/**
-* Unwraps a typed SDK error to the underlying `ConnectError` (kept as `cause`)
-* so legacy heuristics keep working on raw backend details.
-*/
-function unwrapCause(err) {
-	return err instanceof PolyesterError && err.cause !== void 0 ? err.cause : err;
-}
 /**
 * Whether the backend signalled that the requested resource does not exist.
 * Prefer `err instanceof ResourceNotFoundError`; this predicate also covers
@@ -20,10 +9,7 @@ function unwrapCause(err) {
 */
 function isResourceNotFoundError(err) {
 	const mapped = toPolyesterError(err);
-	if (mapped instanceof ResourceNotFoundError) return true;
-	if (mapped instanceof PolyesterError && mapped.cause === void 0) return false;
-	const target = unwrapCause(mapped);
-	return hasAuthErrorCode(target, 10) || ConnectError.from(target).code === Code.NotFound;
+	return mapped instanceof ResourceNotFoundError || mapped instanceof PolyesterError && mapped.detail?.service === "auth" && mapped.detail.code === "AUTH_RESOURCE_NOT_FOUND";
 }
 /** Whether an optimistic-concurrency update used a stale resource revision. */
 function isRevisionConflictError(err) {

package/dist/utils/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../src/utils/errors.ts"],"sourcesContent":["import { Code, ConnectError } from \"@connectrpc/connect\";\nimport { AuthErrorCode, AuthErrorDetailSchema } from \"../gen/auth/v1/auth_pb.js\";\nimport { getNormalizedConnectMessage, toPolyesterError } from \"../shared/connect-error-mapping.js\";\nimport {\n    isAbortError,\n    NetworkError,\n    PolicyInUseError,\n    PolicyLockedError,\n    PolicyScopeMismatchError,\n    PolyesterError,\n    RateLimitError,\n    ResourceNotFoundError,\n    RevisionConflictError,\n    ServiceUnavailableError,\n    TimeoutError,\n} from \"../shared/errors.js\";\n\nfunction hasAuthErrorCode(err: unknown, code: AuthErrorCode): boolean {\n    return ConnectError.from(err)\n        .findDetails(AuthErrorDetailSchema)\n        .some((detail) => detail.code === code);\n}\n\n/**\n * Unwraps a typed SDK error to the underlying `ConnectError` (kept as `cause`)\n * so legacy heuristics keep working on raw backend details.\n */\nfunction unwrapCause(err: unknown): unknown {\n    return err instanceof PolyesterError && err.cause !== undefined ? err.cause : err;\n}\n\n/**\n * Whether the backend signalled that the requested resource does not exist.\n * Prefer `err instanceof ResourceNotFoundError`; this predicate also covers\n * raw `ConnectError`s (NotFound or the auth resource-not-found detail).\n */\nexport function isResourceNotFoundError(err: unknown): boolean {\n    // Connect can re-wrap interceptor errors as an Unknown ConnectError whose\n    // cause is the typed SDK error. Normalize first to recover that cause.\n    const mapped = toPolyesterError(err);\n    if (mapped instanceof ResourceNotFoundError) return true;\n    if (mapped instanceof PolyesterError && mapped.cause === undefined) return false;\n    const target = unwrapCause(mapped);\n    return (\n        hasAuthErrorCode(target, AuthErrorCode.AUTH_RESOURCE_NOT_FOUND) ||\n        ConnectError.from(target).code === Code.NotFound\n    );\n}\n\n/** Whether an optimistic-concurrency update used a stale resource revision. */\nexport function isRevisionConflictError(err: unknown): boolean {\n    const seen = new Set<unknown>();\n    let current = err;\n    while (current !== undefined && current !== null && !seen.has(current)) {\n        seen.add(current);\n        if (toPolyesterError(current) instanceof RevisionConflictError) return true;\n        const connectError = ConnectError.from(current);\n        if (\n            (connectError.code === Code.Unknown || connectError.code === Code.Aborted) &&\n            /\\brevision conflict\\b/i.test(getNormalizedConnectMessage(connectError))\n        ) {\n            return true;\n        }\n        current =\n            typeof current === \"object\" && \"cause\" in current\n                ? (current as { cause?: unknown }).cause\n                : undefined;\n    }\n    return false;\n}\n\n/** Whether a policy mutation failed because the policy is still attached to a resource. */\nexport function isPolicyInUseError(err: unknown): boolean {\n    return toPolyesterError(err) instanceof PolicyInUseError;\n}\n\n/** Whether a policy mutation failed because the policy is locked. */\nexport function isPolicyLockedError(err: unknown): boolean {\n    return toPolyesterError(err) instanceof PolicyLockedError;\n}\n\n/** Whether the policy and target account belong to different scopes. */\nexport function isPolicyScopeMismatchError(err: unknown): boolean {\n    return toPolyesterError(err) instanceof PolicyScopeMismatchError;\n}\n\n/**\n * Whether an error is retryable (network/timeout) for idempotent operations.\n * Uses same requestId on retry; backend dedupes within 2min.\n * Prefer `err instanceof TransientError` or `err.retryable` on typed errors.\n */\nexport function isRetryableError(err: unknown): boolean {\n    if (isAbortError(err)) return false;\n    const mapped = toPolyesterError(err);\n    if (mapped instanceof PolyesterError) return mapped.retryable;\n    const ce = ConnectError.from(mapped);\n    return (\n        ce.code === Code.Unavailable ||\n        ce.code === Code.DeadlineExceeded ||\n        ce.code === Code.ResourceExhausted ||\n        ce.code === Code.Aborted\n    );\n}\n\n/**\n * Diagnostic formatter for SDK and ConnectRPC errors.\n * Typed SDK errors already carry normalized messages; for raw ConnectErrors\n * this strips leading \"[CODE]\" prefixes. Falls back to a friendly default.\n * The returned message may contain backend implementation details. Never render\n * it to a user; use {@link formatUserFacingError} at presentation boundaries.\n * @param err - The error to format.\n * @param fallback - The fallback message when no message is available.\n * @returns The formatted error message.\n */\nexport function formatConnectError(\n    err: unknown,\n    fallback = \"Request failed. Please try again.\",\n): string {\n    if (err == null) return fallback;\n    if (err instanceof PolyesterError) return err.message || fallback;\n    const withoutCode = getNormalizedConnectMessage(err);\n    return withoutCode || fallback;\n}\n\n/**\n * Formats an untrusted failure for direct display to a user.\n *\n * This function never returns an exception or backend message. A small allowlist\n * of typed transport conditions receives SDK-owned copy; every other failure\n * returns the caller-owned fallback.\n */\nfunction userFacingTransportMessage(error: unknown): string | undefined {\n    if (error instanceof RateLimitError) {\n        return \"You've made too many requests. Wait a moment and try again.\";\n    }\n    if (error instanceof TimeoutError) return \"This is taking longer than expected. Try again.\";\n    if (error instanceof ServiceUnavailableError) {\n        return \"This service is temporarily unavailable. Try again in a few minutes.\";\n    }\n    if (error instanceof NetworkError) {\n        return \"We couldn't connect. Check your internet connection and try again.\";\n    }\n\n    if (error instanceof ConnectError) {\n        if (error.code === Code.ResourceExhausted) {\n            return \"You've made too many requests. Wait a moment and try again.\";\n        }\n        if (error.code === Code.DeadlineExceeded) {\n            return \"This is taking longer than expected. Try again.\";\n        }\n        if (error.code === Code.Unavailable) {\n            return \"This service is temporarily unavailable. Try again in a few minutes.\";\n        }\n    }\n\n    return undefined;\n}\n\nexport function formatUserFacingError(error: unknown, fallback: string): string {\n    // Walk the cause chain and normalize ConnectErrors so wrapped submit failures\n    // (e.g. Error → ConnectError[unknown] \"Service temporarily unavailable.\")\n    // still hit the transport allowlist.\n    let current: unknown = error;\n    for (let depth = 0; depth < 5 && current != null; depth++) {\n        const mapped = toPolyesterError(current);\n        const fromMapped = userFacingTransportMessage(mapped);\n        if (fromMapped !== undefined) return fromMapped;\n        const fromCurrent = userFacingTransportMessage(current);\n        if (fromCurrent !== undefined) return fromCurrent;\n\n        current =\n            typeof current === \"object\" && current !== null && \"cause\" in current\n                ? (current as { cause?: unknown }).cause\n                : undefined;\n    }\n\n    return fallback;\n}\n"],"mappings":"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"}
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/utils/errors.ts"],"sourcesContent":["import { Code, ConnectError } from \"@connectrpc/connect\";\nimport { getNormalizedConnectMessage, toPolyesterError } from \"../shared/connect-error-mapping.js\";\nimport {\n    isAbortError,\n    NetworkError,\n    PolicyInUseError,\n    PolicyLockedError,\n    PolicyScopeMismatchError,\n    PolyesterError,\n    RateLimitError,\n    ResourceNotFoundError,\n    RevisionConflictError,\n    ServiceUnavailableError,\n    TimeoutError,\n} from \"../shared/errors.js\";\n\n/**\n * Whether the backend signalled that the requested resource does not exist.\n * Prefer `err instanceof ResourceNotFoundError`; this predicate also covers\n * raw `ConnectError`s (NotFound or the auth resource-not-found detail).\n */\nexport function isResourceNotFoundError(err: unknown): boolean {\n    // Connect can re-wrap interceptor errors as an Unknown ConnectError whose\n    // cause is the typed SDK error. Normalize first to recover that cause.\n    const mapped = toPolyesterError(err);\n    return (\n        mapped instanceof ResourceNotFoundError ||\n        (mapped instanceof PolyesterError &&\n            mapped.detail?.service === \"auth\" &&\n            mapped.detail.code === \"AUTH_RESOURCE_NOT_FOUND\")\n    );\n}\n\n/** Whether an optimistic-concurrency update used a stale resource revision. */\nexport function isRevisionConflictError(err: unknown): boolean {\n    const seen = new Set<unknown>();\n    let current = err;\n    while (current !== undefined && current !== null && !seen.has(current)) {\n        seen.add(current);\n        if (toPolyesterError(current) instanceof RevisionConflictError) return true;\n        const connectError = ConnectError.from(current);\n        if (\n            (connectError.code === Code.Unknown || connectError.code === Code.Aborted) &&\n            /\\brevision conflict\\b/i.test(getNormalizedConnectMessage(connectError))\n        ) {\n            return true;\n        }\n        current =\n            typeof current === \"object\" && \"cause\" in current\n                ? (current as { cause?: unknown }).cause\n                : undefined;\n    }\n    return false;\n}\n\n/** Whether a policy mutation failed because the policy is still attached to a resource. */\nexport function isPolicyInUseError(err: unknown): boolean {\n    return toPolyesterError(err) instanceof PolicyInUseError;\n}\n\n/** Whether a policy mutation failed because the policy is locked. */\nexport function isPolicyLockedError(err: unknown): boolean {\n    return toPolyesterError(err) instanceof PolicyLockedError;\n}\n\n/** Whether the policy and target account belong to different scopes. */\nexport function isPolicyScopeMismatchError(err: unknown): boolean {\n    return toPolyesterError(err) instanceof PolicyScopeMismatchError;\n}\n\n/**\n * Whether an error is retryable (network/timeout) for idempotent operations.\n * Uses same requestId on retry; backend dedupes within 2min.\n * Prefer `err instanceof TransientError` or `err.retryable` on typed errors.\n */\nexport function isRetryableError(err: unknown): boolean {\n    if (isAbortError(err)) return false;\n    const mapped = toPolyesterError(err);\n    if (mapped instanceof PolyesterError) return mapped.retryable;\n    const ce = ConnectError.from(mapped);\n    return (\n        ce.code === Code.Unavailable ||\n        ce.code === Code.DeadlineExceeded ||\n        ce.code === Code.ResourceExhausted ||\n        ce.code === Code.Aborted\n    );\n}\n\n/**\n * Diagnostic formatter for SDK and ConnectRPC errors.\n * Typed SDK errors already carry normalized messages; for raw ConnectErrors\n * this strips leading \"[CODE]\" prefixes. Falls back to a friendly default.\n * The returned message may contain backend implementation details. Never render\n * it to a user; use {@link formatUserFacingError} at presentation boundaries.\n * @param err - The error to format.\n * @param fallback - The fallback message when no message is available.\n * @returns The formatted error message.\n */\nexport function formatConnectError(\n    err: unknown,\n    fallback = \"Request failed. Please try again.\",\n): string {\n    if (err == null) return fallback;\n    if (err instanceof PolyesterError) return err.message || fallback;\n    const withoutCode = getNormalizedConnectMessage(err);\n    return withoutCode || fallback;\n}\n\n/**\n * Formats an untrusted failure for direct display to a user.\n *\n * This function never returns an exception or backend message. A small allowlist\n * of typed transport conditions receives SDK-owned copy; every other failure\n * returns the caller-owned fallback.\n */\nfunction userFacingTransportMessage(error: unknown): string | undefined {\n    if (error instanceof RateLimitError) {\n        return \"You've made too many requests. Wait a moment and try again.\";\n    }\n    if (error instanceof TimeoutError) return \"This is taking longer than expected. Try again.\";\n    if (error instanceof ServiceUnavailableError) {\n        return \"This service is temporarily unavailable. Try again in a few minutes.\";\n    }\n    if (error instanceof NetworkError) {\n        return \"We couldn't connect. Check your internet connection and try again.\";\n    }\n\n    if (error instanceof ConnectError) {\n        if (error.code === Code.ResourceExhausted) {\n            return \"You've made too many requests. Wait a moment and try again.\";\n        }\n        if (error.code === Code.DeadlineExceeded) {\n            return \"This is taking longer than expected. Try again.\";\n        }\n        if (error.code === Code.Unavailable) {\n            return \"This service is temporarily unavailable. Try again in a few minutes.\";\n        }\n    }\n\n    return undefined;\n}\n\nexport function formatUserFacingError(error: unknown, fallback: string): string {\n    // Walk the cause chain and normalize ConnectErrors so wrapped submit failures\n    // (e.g. Error → ConnectError[unknown] \"Service temporarily unavailable.\")\n    // still hit the transport allowlist.\n    let current: unknown = error;\n    for (let depth = 0; depth < 5 && current != null; depth++) {\n        const mapped = toPolyesterError(current);\n        const fromMapped = userFacingTransportMessage(mapped);\n        if (fromMapped !== undefined) return fromMapped;\n        const fromCurrent = userFacingTransportMessage(current);\n        if (fromCurrent !== undefined) return fromCurrent;\n\n        current =\n            typeof current === \"object\" && current !== null && \"cause\" in current\n                ? (current as { cause?: unknown }).cause\n                : undefined;\n    }\n\n    return fallback;\n}\n"],"mappings":";;;;;;;;;AAqBA,SAAgB,wBAAwB,KAAuB;CAG3D,MAAM,SAAS,iBAAiB,GAAG;CACnC,OACI,kBAAkB,yBACjB,kBAAkB,kBACf,OAAO,QAAQ,YAAY,UAC3B,OAAO,OAAO,SAAS;AAEnC;;AAGA,SAAgB,wBAAwB,KAAuB;CAC3D,MAAM,uBAAO,IAAI,IAAa;CAC9B,IAAI,UAAU;CACd,OAAO,YAAY,KAAA,KAAa,YAAY,QAAQ,CAAC,KAAK,IAAI,OAAO,GAAG;EACpE,KAAK,IAAI,OAAO;EAChB,IAAI,iBAAiB,OAAO,aAAa,uBAAuB,OAAO;EACvE,MAAM,eAAe,aAAa,KAAK,OAAO;EAC9C,KACK,aAAa,SAAS,KAAK,WAAW,aAAa,SAAS,KAAK,YAClE,yBAAyB,KAAK,4BAA4B,YAAY,CAAC,GAEvE,OAAO;EAEX,UACI,OAAO,YAAY,YAAY,WAAW,UACnC,QAAgC,QACjC,KAAA;CACd;CACA,OAAO;AACX;;AAGA,SAAgB,mBAAmB,KAAuB;CACtD,OAAO,iBAAiB,GAAG,aAAa;AAC5C;;AAGA,SAAgB,oBAAoB,KAAuB;CACvD,OAAO,iBAAiB,GAAG,aAAa;AAC5C;;AAGA,SAAgB,2BAA2B,KAAuB;CAC9D,OAAO,iBAAiB,GAAG,aAAa;AAC5C;;;;;;AAOA,SAAgB,iBAAiB,KAAuB;CACpD,IAAI,aAAa,GAAG,GAAG,OAAO;CAC9B,MAAM,SAAS,iBAAiB,GAAG;CACnC,IAAI,kBAAkB,gBAAgB,OAAO,OAAO;CACpD,MAAM,KAAK,aAAa,KAAK,MAAM;CACnC,OACI,GAAG,SAAS,KAAK,eACjB,GAAG,SAAS,KAAK,oBACjB,GAAG,SAAS,KAAK,qBACjB,GAAG,SAAS,KAAK;AAEzB;;;;;;;;;;;AAYA,SAAgB,mBACZ,KACA,WAAW,qCACL;CACN,IAAI,OAAO,MAAM,OAAO;CACxB,IAAI,eAAe,gBAAgB,OAAO,IAAI,WAAW;CAEzD,OADoB,4BAA4B,GAC/B,KAAK;AAC1B;;;;;;;;AASA,SAAS,2BAA2B,OAAoC;CACpE,IAAI,iBAAiB,gBACjB,OAAO;CAEX,IAAI,iBAAiB,cAAc,OAAO;CAC1C,IAAI,iBAAiB,yBACjB,OAAO;CAEX,IAAI,iBAAiB,cACjB,OAAO;CAGX,IAAI,iBAAiB,cAAc;EAC/B,IAAI,MAAM,SAAS,KAAK,mBACpB,OAAO;EAEX,IAAI,MAAM,SAAS,KAAK,kBACpB,OAAO;EAEX,IAAI,MAAM,SAAS,KAAK,aACpB,OAAO;CAEf;AAGJ;AAEA,SAAgB,sBAAsB,OAAgB,UAA0B;CAI5E,IAAI,UAAmB;CACvB,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,WAAW,MAAM,SAAS;EAEvD,MAAM,aAAa,2BADJ,iBAAiB,OACmB,CAAC;EACpD,IAAI,eAAe,KAAA,GAAW,OAAO;EACrC,MAAM,cAAc,2BAA2B,OAAO;EACtD,IAAI,gBAAgB,KAAA,GAAW,OAAO;EAEtC,UACI,OAAO,YAAY,YAAY,YAAY,QAAQ,WAAW,UACvD,QAAgC,QACjC,KAAA;CACd;CAEA,OAAO;AACX"}

package/dist/wired-services.js

@@ -1,22 +1,22 @@
 import { MFAService } from "./gen/auth/v1/mfa_pb.js";
 import { AuthService } from "./gen/auth/v1/auth_pb.js";
+import { ProfileService } from "./gen/auth/v1/profile_pb.js";
+import { WithdrawService } from "./gen/chain/withdraw/v1/withdraw_pb.js";
+import { LedgerReadService } from "./gen/ledger/read/v1/ledger_read_pb.js";
+import { MarketOverviewService } from "./gen/marketoverview/v1/marketoverview_pb.js";
 import { OrdersService } from "./gen/orders/v1/orders_pb.js";
+import { InternalTransferService } from "./gen/transfer/v1/internal_transfer_pb.js";
 import { ResolveService } from "./gen/auth/v1/resolve_pb.js";
 import { ApiKeyService } from "./gen/auth/v1/api_keys_pb.js";
 import { PolicyService } from "./gen/auth/v1/policies_pb.js";
-import { ProfileService } from "./gen/auth/v1/profile_pb.js";
-import { LedgerReadService } from "./gen/ledger/read/v1/ledger_read_pb.js";
 import { SubaccountRoleService, SubaccountService, SubaccountViewService } from "./gen/auth/v1/subaccounts_pb.js";
 import { MarketDataService } from "./gen/marketdata/v1/marketdata_pb.js";
 import { ChainAnalyticsService } from "./gen/chain/analytics/v1/analytics_read_pb.js";
-import { MarketOverviewService } from "./gen/marketoverview/v1/marketoverview_pb.js";
 import { OrderbookService } from "./gen/orderbook/v1/orderbook_pb.js";
 import { HeatmapService } from "./gen/marketdata/v1/heatmap_pb.js";
 import { LifecycleReadService } from "./gen/chain/lifecycle/v1/lifecycle_read_pb.js";
 import { OrdersReadService } from "./gen/orders/v1/orders_read_pb.js";
 import { TriggersService } from "./gen/triggers/v1/triggers_pb.js";
-import { InternalTransferService } from "./gen/transfer/v1/internal_transfer_pb.js";
-import { WithdrawService } from "./gen/chain/withdraw/v1/withdraw_pb.js";
 import { DepositAddressService } from "./gen/chain/deposit/v1/deposit_pb.js";
 import { AddressBookService } from "./gen/auth/v1/address_book_pb.js";
 import { GuardSignerService } from "./gen/chain/guard/v1/guard_signer_pb.js";

package/package.json

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

package/dist/utils/connect-order-errors.d.ts

@@ -1,15 +0,0 @@
-import { OrderErrorDetail } from "../services/orders/order-errors.schemas.js";
-//#region src/utils/connect-order-errors.d.ts
-/**
- * Returns the first structured Orders API rejection detail in an error cause chain.
- * Invalid or unrelated details are ignored rather than exposing transport prose.
- */
-declare function getOrderErrorDetail(error: unknown): OrderErrorDetail | undefined;
-/**
- * True when an order mutation was rejected because its client reference quote
- * exceeded the backend's configured drift limit.
- */
-declare function isStaleQuoteError(error: unknown): boolean;
-//#endregion
-export { getOrderErrorDetail, isStaleQuoteError };
-//# sourceMappingURL=connect-order-errors.d.ts.map

package/dist/utils/connect-order-errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connect-order-errors.d.ts","names":[],"sources":["../../src/utils/connect-order-errors.ts"],"mappings":";;;;;;iBAcgB,oBAAoB,iBAAiB;;;;;iBAsBrC,kBAAkB"}

package/dist/utils/connect-order-errors.js

@@ -1,41 +0,0 @@
-import { StaleQuoteError } from "../shared/errors.js";
-import { ErrorDetailSchema } from "../gen/orders/v1/orders_pb.js";
-import { toPolyesterError } from "../shared/connect-error-mapping.js";
-import { OrderErrorDetailSchema } from "../services/orders/order-errors.schemas.js";
-import { ConnectError } from "@connectrpc/connect";
-import * as v from "valibot";
-//#region src/utils/connect-order-errors.ts
-/**
-* Returns the first structured Orders API rejection detail in an error cause chain.
-* Invalid or unrelated details are ignored rather than exposing transport prose.
-*/
-function getOrderErrorDetail(error) {
-	const seen = /* @__PURE__ */ new Set();
-	let current = error;
-	for (let depth = 0; depth < 5 && current != null && !seen.has(current); depth += 1) {
-		seen.add(current);
-		const details = ConnectError.from(current).findDetails(ErrorDetailSchema);
-		for (const detail of details) {
-			const parsed = v.safeParse(OrderErrorDetailSchema, detail);
-			if (parsed.success) return parsed.output;
-		}
-		current = current instanceof Error ? current.cause : void 0;
-	}
-}
-/**
-* True when an order mutation was rejected because its client reference quote
-* exceeded the backend's configured drift limit.
-*/
-function isStaleQuoteError(error) {
-	let current = error;
-	for (let depth = 0; depth < 5; depth += 1) {
-		if (toPolyesterError(current) instanceof StaleQuoteError) return true;
-		if (!(current instanceof Error) || current.cause === void 0) return false;
-		current = current.cause;
-	}
-	return false;
-}
-//#endregion
-export { getOrderErrorDetail, isStaleQuoteError };
-
-//# sourceMappingURL=connect-order-errors.js.map

package/dist/utils/connect-order-errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"connect-order-errors.js","names":[],"sources":["../../src/utils/connect-order-errors.ts"],"sourcesContent":["import { ConnectError } from \"@connectrpc/connect\";\nimport * as v from \"valibot\";\nimport { ErrorDetailSchema } from \"../gen/orders/v1/orders_pb.js\";\nimport {\n    OrderErrorDetailSchema,\n    type OrderErrorDetail,\n} from \"../services/orders/order-errors.schemas.js\";\nimport { toPolyesterError } from \"../shared/connect-error-mapping.js\";\nimport { StaleQuoteError } from \"../shared/errors.js\";\n\n/**\n * Returns the first structured Orders API rejection detail in an error cause chain.\n * Invalid or unrelated details are ignored rather than exposing transport prose.\n */\nexport function getOrderErrorDetail(error: unknown): OrderErrorDetail | undefined {\n    const seen = new Set<unknown>();\n    let current: unknown = error;\n\n    for (let depth = 0; depth < 5 && current != null && !seen.has(current); depth += 1) {\n        seen.add(current);\n        const details = ConnectError.from(current).findDetails(ErrorDetailSchema);\n        for (const detail of details) {\n            const parsed = v.safeParse(OrderErrorDetailSchema, detail);\n            if (parsed.success) return parsed.output;\n        }\n\n        current = current instanceof Error ? current.cause : undefined;\n    }\n\n    return undefined;\n}\n\n/**\n * True when an order mutation was rejected because its client reference quote\n * exceeded the backend's configured drift limit.\n */\nexport function isStaleQuoteError(error: unknown): boolean {\n    let current = error;\n\n    for (let depth = 0; depth < 5; depth += 1) {\n        if (toPolyesterError(current) instanceof StaleQuoteError) return true;\n        if (!(current instanceof Error) || current.cause === undefined) return false;\n        current = current.cause;\n    }\n\n    return false;\n}\n"],"mappings":";;;;;;;;;;;AAcA,SAAgB,oBAAoB,OAA8C;CAC9E,MAAM,uBAAO,IAAI,IAAa;CAC9B,IAAI,UAAmB;CAEvB,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,WAAW,QAAQ,CAAC,KAAK,IAAI,OAAO,GAAG,SAAS,GAAG;EAChF,KAAK,IAAI,OAAO;EAChB,MAAM,UAAU,aAAa,KAAK,OAAO,CAAC,CAAC,YAAY,iBAAiB;EACxE,KAAK,MAAM,UAAU,SAAS;GAC1B,MAAM,SAAS,EAAE,UAAU,wBAAwB,MAAM;GACzD,IAAI,OAAO,SAAS,OAAO,OAAO;EACtC;EAEA,UAAU,mBAAmB,QAAQ,QAAQ,QAAQ,KAAA;CACzD;AAGJ;;;;;AAMA,SAAgB,kBAAkB,OAAyB;CACvD,IAAI,UAAU;CAEd,KAAK,IAAI,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG;EACvC,IAAI,iBAAiB,OAAO,aAAa,iBAAiB,OAAO;EACjE,IAAI,EAAE,mBAAmB,UAAU,QAAQ,UAAU,KAAA,GAAW,OAAO;EACvE,UAAU,QAAQ;CACtB;CAEA,OAAO;AACX"}