@atribu/node 0.1.0

package/dist/errors-D3ApBz8J.d.cts

@@ -0,0 +1,86 @@
+/**
+ * Retry hints derived from HTTP status + headers.
+ *
+ * The SDK never retries automatically. It derives a hint and surfaces it on
+ * AtribuApiError.retry so consumers' queue systems can decide. Hiding retry
+ * logic in the SDK hides backpressure signals.
+ */
+type RetryHint = {
+    action: "retry";
+} | {
+    action: "retry_after";
+    retryAfterMs: number;
+} | {
+    action: "refresh_token";
+} | {
+    action: "fix_and_retry";
+} | {
+    action: "do_not_retry";
+};
+
+/**
+ * Atribu error class hierarchy.
+ *
+ * Why typed errors: consumers need to branch on auth-failure vs rate-limit vs
+ * server-error vs validation-error to decide whether to retry, refresh
+ * credentials, or surface to the user. A single `Error` with a status code
+ * forces every consumer to write the same `if (err.status === 401)` ladder.
+ *
+ * Why no automatic retries: the SDK derives a `retry` hint from status +
+ * Retry-After + error code, but consumers' queue/job systems decide whether
+ * to act on it. Auto-retry inside the SDK hides backpressure signals and
+ * makes error budgets opaque.
+ */
+
+type ApiErrorCode = "unauthorized" | "forbidden" | "insufficient_scope" | "not_found" | "invalid_parameter" | "invalid_request" | "validation_error" | "invalid_content" | "invalid_date_range" | "rate_limit_exceeded" | "connection_not_ready" | "provider_error" | "service_unavailable" | "internal_error" | string;
+declare class AtribuError extends Error {
+    constructor(message: string);
+}
+declare class AtribuConfigError extends AtribuError {
+}
+declare class AtribuTransportError extends AtribuError {
+    readonly cause: unknown;
+    constructor(message: string, cause: unknown);
+}
+interface ApiErrorBody {
+    code: ApiErrorCode;
+    message: string;
+    status: number;
+    request_id?: string;
+}
+declare class AtribuApiError extends AtribuError {
+    readonly code: ApiErrorCode;
+    readonly status: number;
+    readonly requestId: string | null;
+    readonly retry: RetryHint;
+    readonly responseBody: unknown;
+    constructor(args: {
+        code: ApiErrorCode;
+        message: string;
+        status: number;
+        requestId: string | null;
+        retry: RetryHint;
+        responseBody: unknown;
+    });
+    isRetryable(): boolean;
+    isAuthFailure(): boolean;
+    isRateLimit(): boolean;
+}
+type OauthErrorCode = "invalid_request" | "invalid_client" | "invalid_grant" | "unauthorized_client" | "unsupported_grant_type" | "invalid_scope" | "server_error" | "unsupported_token_type" | string;
+declare class AtribuOauthError extends AtribuError {
+    readonly code: OauthErrorCode;
+    readonly status: number;
+    readonly description: string | null;
+    constructor(args: {
+        code: OauthErrorCode;
+        description: string | null;
+        status: number;
+    });
+}
+type WebhookErrorCode = "missing_signature" | "malformed_header" | "expired_timestamp" | "invalid_signature";
+declare class AtribuWebhookError extends AtribuError {
+    readonly code: WebhookErrorCode;
+    constructor(code: WebhookErrorCode, message: string);
+}
+
+export { AtribuError as A, type OauthErrorCode as O, type RetryHint as R, type WebhookErrorCode as W, type ApiErrorBody as a, type ApiErrorCode as b, AtribuApiError as c, AtribuConfigError as d, AtribuOauthError as e, AtribuTransportError as f, AtribuWebhookError as g };

package/dist/errors-D3ApBz8J.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Retry hints derived from HTTP status + headers.
+ *
+ * The SDK never retries automatically. It derives a hint and surfaces it on
+ * AtribuApiError.retry so consumers' queue systems can decide. Hiding retry
+ * logic in the SDK hides backpressure signals.
+ */
+type RetryHint = {
+    action: "retry";
+} | {
+    action: "retry_after";
+    retryAfterMs: number;
+} | {
+    action: "refresh_token";
+} | {
+    action: "fix_and_retry";
+} | {
+    action: "do_not_retry";
+};
+
+/**
+ * Atribu error class hierarchy.
+ *
+ * Why typed errors: consumers need to branch on auth-failure vs rate-limit vs
+ * server-error vs validation-error to decide whether to retry, refresh
+ * credentials, or surface to the user. A single `Error` with a status code
+ * forces every consumer to write the same `if (err.status === 401)` ladder.
+ *
+ * Why no automatic retries: the SDK derives a `retry` hint from status +
+ * Retry-After + error code, but consumers' queue/job systems decide whether
+ * to act on it. Auto-retry inside the SDK hides backpressure signals and
+ * makes error budgets opaque.
+ */
+
+type ApiErrorCode = "unauthorized" | "forbidden" | "insufficient_scope" | "not_found" | "invalid_parameter" | "invalid_request" | "validation_error" | "invalid_content" | "invalid_date_range" | "rate_limit_exceeded" | "connection_not_ready" | "provider_error" | "service_unavailable" | "internal_error" | string;
+declare class AtribuError extends Error {
+    constructor(message: string);
+}
+declare class AtribuConfigError extends AtribuError {
+}
+declare class AtribuTransportError extends AtribuError {
+    readonly cause: unknown;
+    constructor(message: string, cause: unknown);
+}
+interface ApiErrorBody {
+    code: ApiErrorCode;
+    message: string;
+    status: number;
+    request_id?: string;
+}
+declare class AtribuApiError extends AtribuError {
+    readonly code: ApiErrorCode;
+    readonly status: number;
+    readonly requestId: string | null;
+    readonly retry: RetryHint;
+    readonly responseBody: unknown;
+    constructor(args: {
+        code: ApiErrorCode;
+        message: string;
+        status: number;
+        requestId: string | null;
+        retry: RetryHint;
+        responseBody: unknown;
+    });
+    isRetryable(): boolean;
+    isAuthFailure(): boolean;
+    isRateLimit(): boolean;
+}
+type OauthErrorCode = "invalid_request" | "invalid_client" | "invalid_grant" | "unauthorized_client" | "unsupported_grant_type" | "invalid_scope" | "server_error" | "unsupported_token_type" | string;
+declare class AtribuOauthError extends AtribuError {
+    readonly code: OauthErrorCode;
+    readonly status: number;
+    readonly description: string | null;
+    constructor(args: {
+        code: OauthErrorCode;
+        description: string | null;
+        status: number;
+    });
+}
+type WebhookErrorCode = "missing_signature" | "malformed_header" | "expired_timestamp" | "invalid_signature";
+declare class AtribuWebhookError extends AtribuError {
+    readonly code: WebhookErrorCode;
+    constructor(code: WebhookErrorCode, message: string);
+}
+
+export { AtribuError as A, type OauthErrorCode as O, type RetryHint as R, type WebhookErrorCode as W, type ApiErrorBody as a, type ApiErrorCode as b, AtribuApiError as c, AtribuConfigError as d, AtribuOauthError as e, AtribuTransportError as f, AtribuWebhookError as g };