@strimz/sdk 0.1.0

package/dist/errors.js

@@ -0,0 +1,90 @@
+// src/errors.ts
+var StrimzError = class extends Error {
+  code;
+  httpStatus;
+  requestId;
+  param;
+  details;
+  constructor(body, httpStatus) {
+    super(body.message);
+    this.name = "StrimzError";
+    this.code = body.code;
+    this.httpStatus = httpStatus;
+    this.requestId = body.requestId;
+    this.param = body.param;
+    this.details = body.details;
+  }
+};
+var StrimzAuthenticationError = class extends StrimzError {
+  constructor(body, httpStatus) {
+    super(body, httpStatus);
+    this.name = "StrimzAuthenticationError";
+  }
+};
+var StrimzPermissionError = class extends StrimzError {
+  constructor(body, httpStatus) {
+    super(body, httpStatus);
+    this.name = "StrimzPermissionError";
+  }
+};
+var StrimzValidationError = class extends StrimzError {
+  constructor(body, httpStatus) {
+    super(body, httpStatus);
+    this.name = "StrimzValidationError";
+  }
+};
+var StrimzNotFoundError = class extends StrimzError {
+  constructor(body, httpStatus) {
+    super(body, httpStatus);
+    this.name = "StrimzNotFoundError";
+  }
+};
+var StrimzIdempotencyError = class extends StrimzError {
+  constructor(body, httpStatus) {
+    super(body, httpStatus);
+    this.name = "StrimzIdempotencyError";
+  }
+};
+var StrimzRateLimitError = class extends StrimzError {
+  retryAfterMs;
+  constructor(body, httpStatus, retryAfterMs) {
+    super(body, httpStatus);
+    this.name = "StrimzRateLimitError";
+    this.retryAfterMs = retryAfterMs;
+  }
+};
+var StrimzNetworkError = class extends StrimzError {
+  cause;
+  constructor(message, cause) {
+    super({ code: "network_error", message });
+    this.name = "StrimzNetworkError";
+    this.cause = cause;
+  }
+};
+var StrimzTimeoutError = class extends StrimzError {
+  constructor(message) {
+    super({ code: "timeout", message });
+    this.name = "StrimzTimeoutError";
+  }
+};
+var StrimzModeMismatchError = class extends StrimzError {
+  constructor(message) {
+    super({ code: "mode_mismatch", message });
+    this.name = "StrimzModeMismatchError";
+  }
+};
+function classifyError(httpStatus, body, retryAfterMs) {
+  if (httpStatus === 401) return new StrimzAuthenticationError(body, httpStatus);
+  if (httpStatus === 403) return new StrimzPermissionError(body, httpStatus);
+  if (httpStatus === 404) return new StrimzNotFoundError(body, httpStatus);
+  if (httpStatus === 409 && body.code === "idempotency_error") {
+    return new StrimzIdempotencyError(body, httpStatus);
+  }
+  if (httpStatus === 422) return new StrimzValidationError(body, httpStatus);
+  if (httpStatus === 429) return new StrimzRateLimitError(body, httpStatus, retryAfterMs);
+  return new StrimzError(body, httpStatus);
+}
+
+export { StrimzAuthenticationError, StrimzError, StrimzIdempotencyError, StrimzModeMismatchError, StrimzNetworkError, StrimzNotFoundError, StrimzPermissionError, StrimzRateLimitError, StrimzTimeoutError, StrimzValidationError, classifyError };
+//# sourceMappingURL=errors.js.map
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":"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","file":"errors.js","sourcesContent":["/**\n * Error hierarchy for the Strimz SDK.\n *\n * Every error thrown by the SDK extends `StrimzError`. The SDK never\n * resolves to `{ ok: false }` — it throws. This matches the Stripe / GitHub\n * SDK convention and keeps call sites linear.\n */\n\nexport type StrimzErrorCode =\n  | 'authentication_error'\n  | 'permission_denied'\n  | 'invalid_request'\n  | 'not_found'\n  | 'idempotency_error'\n  | 'rate_limited'\n  | 'mode_mismatch'\n  | 'merchant_not_found'\n  | 'merchant_inactive'\n  | 'token_not_whitelisted'\n  | 'compliance_blocked'\n  | 'session_expired'\n  | 'session_invalid_state'\n  | 'webhook_signature_invalid'\n  | 'api_error'\n  | 'network_error'\n  | 'timeout'\n  | 'parse_error'\n  | 'unknown'\n\nexport interface StrimzErrorBody {\n  code: StrimzErrorCode\n  message: string\n  param?: string\n  requestId?: string\n  details?: Record<string, unknown>\n}\n\nexport class StrimzError extends Error {\n  public readonly code: StrimzErrorCode\n  public readonly httpStatus: number | undefined\n  public readonly requestId: string | undefined\n  public readonly param: string | undefined\n  public readonly details: Record<string, unknown> | undefined\n\n  constructor(body: StrimzErrorBody, httpStatus?: number) {\n    super(body.message)\n    this.name = 'StrimzError'\n    this.code = body.code\n    this.httpStatus = httpStatus\n    this.requestId = body.requestId\n    this.param = body.param\n    this.details = body.details\n  }\n}\n\nexport class StrimzAuthenticationError extends StrimzError {\n  constructor(body: StrimzErrorBody, httpStatus?: number) {\n    super(body, httpStatus)\n    this.name = 'StrimzAuthenticationError'\n  }\n}\n\nexport class StrimzPermissionError extends StrimzError {\n  constructor(body: StrimzErrorBody, httpStatus?: number) {\n    super(body, httpStatus)\n    this.name = 'StrimzPermissionError'\n  }\n}\n\nexport class StrimzValidationError extends StrimzError {\n  constructor(body: StrimzErrorBody, httpStatus?: number) {\n    super(body, httpStatus)\n    this.name = 'StrimzValidationError'\n  }\n}\n\nexport class StrimzNotFoundError extends StrimzError {\n  constructor(body: StrimzErrorBody, httpStatus?: number) {\n    super(body, httpStatus)\n    this.name = 'StrimzNotFoundError'\n  }\n}\n\nexport class StrimzIdempotencyError extends StrimzError {\n  constructor(body: StrimzErrorBody, httpStatus?: number) {\n    super(body, httpStatus)\n    this.name = 'StrimzIdempotencyError'\n  }\n}\n\nexport class StrimzRateLimitError extends StrimzError {\n  public readonly retryAfterMs: number | undefined\n  constructor(body: StrimzErrorBody, httpStatus?: number, retryAfterMs?: number) {\n    super(body, httpStatus)\n    this.name = 'StrimzRateLimitError'\n    this.retryAfterMs = retryAfterMs\n  }\n}\n\nexport class StrimzNetworkError extends StrimzError {\n  public override readonly cause: unknown\n  constructor(message: string, cause: unknown) {\n    super({ code: 'network_error', message })\n    this.name = 'StrimzNetworkError'\n    this.cause = cause\n  }\n}\n\nexport class StrimzTimeoutError extends StrimzError {\n  constructor(message: string) {\n    super({ code: 'timeout', message })\n    this.name = 'StrimzTimeoutError'\n  }\n}\n\nexport class StrimzModeMismatchError extends StrimzError {\n  constructor(message: string) {\n    super({ code: 'mode_mismatch', message })\n    this.name = 'StrimzModeMismatchError'\n  }\n}\n\n/** Map an HTTP status + body to the right StrimzError subclass. */\nexport function classifyError(\n  httpStatus: number,\n  body: StrimzErrorBody,\n  retryAfterMs?: number,\n): StrimzError {\n  if (httpStatus === 401) return new StrimzAuthenticationError(body, httpStatus)\n  if (httpStatus === 403) return new StrimzPermissionError(body, httpStatus)\n  if (httpStatus === 404) return new StrimzNotFoundError(body, httpStatus)\n  if (httpStatus === 409 && body.code === 'idempotency_error') {\n    return new StrimzIdempotencyError(body, httpStatus)\n  }\n  if (httpStatus === 422) return new StrimzValidationError(body, httpStatus)\n  if (httpStatus === 429) return new StrimzRateLimitError(body, httpStatus, retryAfterMs)\n  return new StrimzError(body, httpStatus)\n}\n"]}