@tempoxyz/id 0.0.0-stage → 0.0.1

package/dist/internal/ErrorResponse.js

@@ -0,0 +1,701 @@
+import { HTTPException } from 'hono/http-exception';
+import * as z from 'zod';
+import * as Log from './Log.js';
+/** The page that explains each `reason`, for `error_uri`. */
+const docs = 'https://github.com/tempoxyz/id/blob/main/docs/errors.md';
+/** Every refusal by `reason`, with its OAuth `error`, status, and meaning. */
+export const reasons = {
+    already_decided: {
+        description: 'The user code was already approved or denied.',
+        error: 'invalid_request',
+        status: 409,
+    },
+    authorization_expired: {
+        description: "The app's authorization request that sign-in or the approval page continues is forged or expired.",
+        error: 'invalid_request',
+        status: 400,
+    },
+    body_too_large: {
+        description: 'The request body exceeds 64 KiB.',
+        error: 'invalid_request',
+        status: 413,
+    },
+    challenge_not_permitted: {
+        description: 'A request carries a challenge, and its app lacks the `tempo-id:sign` scope.',
+        error: 'unauthorized_client',
+        status: 403,
+    },
+    config_conflict: {
+        description: "The chain's configuration of the account differs from the one that Tempo ID stores.",
+        error: 'invalid_request',
+        status: 409,
+    },
+    configurable_accounts_disabled: {
+        description: 'The deployment has no configurable accounts, or the request names another chain.',
+        error: 'invalid_request',
+        status: 400,
+    },
+    cross_site_request: {
+        description: 'A form or body-less write came from another site.',
+        error: 'access_denied',
+        status: 403,
+    },
+    duplicate_limit: {
+        description: 'Two limits name the same token.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    duplicate_scope: {
+        description: 'Two scopes name the same call on one target, or one allows any function on a target that another names a function on.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    empty_limits: {
+        description: '`limits` is an empty list.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    empty_scopes: {
+        description: '`scopes` is an empty list.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    expiry_exceeds_maximum: {
+        description: 'A headless key lasts longer than a year.',
+        error: 'invalid_authorization_details',
+        status: 403,
+    },
+    expiry_passed: {
+        description: 'The key expiry has passed.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    foreign_account: {
+        description: "The request names a Tempo Account that is not the user's in the app's realms.",
+        error: 'access_denied',
+        status: 403,
+    },
+    invalid_chain: {
+        description: 'The key chain ID is 0.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    invalid_code: {
+        description: 'The emailed code is wrong or expired.',
+        error: 'invalid_grant',
+        status: 401,
+    },
+    invalid_expiry: {
+        description: 'The key expiry is 0, which never expires.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    invalid_field: {
+        description: 'A field is missing or malformed.',
+        error: 'invalid_request',
+        status: 400,
+    },
+    invalid_id_token_hint: {
+        description: 'The ID token hint is not an ID token that Tempo ID signed for the app.',
+        error: 'invalid_request',
+        status: 400,
+    },
+    invalid_origin: {
+        description: 'A headless request came from an origin its redirect URI does not allow.',
+        error: 'unauthorized_client',
+        status: 403,
+    },
+    invalid_period: {
+        description: "A limit's `period` is not a whole number of seconds.",
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    invalid_public_key: {
+        description: 'The key public key is not a valid point.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    invalid_recipients: {
+        description: "A scope's `recipients` names the zero address or a duplicate, or is on a call other than `transfer`, `transferWithMemo`, or `approve` on a TIP-20 token.",
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    limit_exceeds_maximum: {
+        description: 'A headless key limit exceeds the token’s ceiling.',
+        error: 'invalid_authorization_details',
+        status: 403,
+    },
+    logout_not_permitted: {
+        description: 'The app that the ID token hint names may not end the session at the end-session endpoint.',
+        error: 'unauthorized_client',
+        status: 403,
+    },
+    malformed_body: {
+        description: 'The request body is not valid JSON.',
+        error: 'invalid_request',
+        status: 400,
+    },
+    missing_key: {
+        description: 'The key authorization names no key.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    missing_permissions: {
+        description: "A third-party app's key request leaves out `expiry`, `limits`, or `scopes`.",
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    missing_recipients: {
+        description: 'An `approve` scope names no spenders.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    passkey_link_expired: {
+        description: "The email step's link to a wallet.tempo passkey expired, or the browser holds no link for it.",
+        error: 'invalid_request',
+        status: 400,
+    },
+    passkey_not_permitted: {
+        description: 'A passkey sign-in names an app, or reaches a realm, that holds no passkeys for Tempo ID.',
+        error: 'unauthorized_client',
+        status: 403,
+    },
+    not_configurable: {
+        description: 'The account is not configurable on the chain, so no owner can join it, or no passkey owns it, so it cannot upgrade.',
+        error: 'invalid_request',
+        status: 400,
+    },
+    owner_exists: {
+        description: 'The account already holds the owner that the request adds, or is already configurable.',
+        error: 'invalid_request',
+        status: 409,
+    },
+    passkey_limit: {
+        description: 'The user holds the most passkeys that Tempo ID registers for one user.',
+        error: 'access_denied',
+        status: 403,
+    },
+    post_logout_redirect_not_permitted: {
+        description: 'The post-logout redirect URI is not one of the post-logout redirect URIs the app registered.',
+        error: 'invalid_request',
+        status: 400,
+    },
+    rate_limited: {
+        description: 'Tempo ID, or a service it depends on, is rate limiting the request.',
+        error: 'temporarily_unavailable',
+        status: 429,
+    },
+    reauthentication_required: {
+        description: 'The request needs a session that signed in within the last 10 minutes.',
+        error: 'login_required',
+        status: 401,
+    },
+    rejected: {
+        description: 'The issuer refused the authorization request.',
+        error: 'invalid_request',
+        status: 400,
+    },
+    scope_without_limit: {
+        description: 'A scope calls a listed token that no limit names.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    session_changed: {
+        description: 'The signed-in session differs from the one that the approval page showed.',
+        error: 'invalid_request',
+        status: 409,
+    },
+    session_required: {
+        description: 'The request needs a signed-in session.',
+        error: 'login_required',
+        status: 401,
+    },
+    sign_up_not_permitted: {
+        description: 'The verified address has no account, and its domain is not one where the deployment creates accounts.',
+        error: 'access_denied',
+        status: 403,
+    },
+    unexpected: {
+        description: 'An unexpected failure.',
+        error: 'server_error',
+        status: 500,
+    },
+    unknown_code: {
+        description: 'The user code is wrong or expired.',
+        error: 'invalid_request',
+        status: 404,
+    },
+    unknown_endpoint: {
+        description: 'No API endpoint matches this method and path.',
+        error: 'invalid_request',
+        status: 404,
+    },
+    unsupported_call: {
+        description: 'A selector does not parse, a scope allows any function on a TIP-20 token, or a headless scope names an unrecognized call.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    unsupported_token: {
+        description: 'A limit names a token that is not supported on the chain.',
+        error: 'invalid_authorization_details',
+        status: 400,
+    },
+    upgrade_required: {
+        description: "A key authorization names a wallet.tempo passkey's account on a chain whose accounts are configurable, before its upgrade.",
+        error: 'interaction_required',
+        status: 403,
+    },
+    upstream_unavailable: {
+        description: 'A service Tempo ID depends on failed or did not respond.',
+        error: 'temporarily_unavailable',
+        status: 503,
+    },
+    webauthn_rejected: {
+        description: 'A passkey ceremony failed: its challenge is unknown, spent, or expired, or its response does not verify.',
+        error: 'access_denied',
+        status: 401,
+    },
+    webauthn_required: {
+        description: 'A request without a page names a Tempo Account whose passkey signs only on a Tempo ID page.',
+        error: 'interaction_required',
+        status: 403,
+    },
+};
+/** A refusal, which `json` responds with when returned, and `handle` when thrown. */
+export class ResponseError extends HTTPException {
+    name = 'ErrorResponse.ResponseError';
+    /** The error response the refusal sends. */
+    response;
+    constructor(response) {
+        const status = reasons[response.reason].status;
+        super(status, { res: Response.json(response, { status }) });
+        this.response = response;
+    }
+}
+/**
+ * Returns the base class of `reason`'s refusals, such as for
+ * `class InvalidCodeError extends ErrorResponse.define('invalid_code') {}`.
+ */
+export function define(reason) {
+    return class extends ResponseError {
+        static reason = reason;
+        constructor(options) {
+            super(from({ ...options, reason }));
+        }
+    };
+}
+/** A cross-site form or body-less write, which `csrf()` refuses, or a cross-site account read. */
+export class CrossSiteRequestError extends define('cross_site_request') {
+    name = 'ErrorResponse.CrossSiteRequestError';
+    constructor() {
+        super({
+            error_description: 'Cross-site request refused. Send JSON from an allowed origin.',
+        });
+    }
+}
+/** The body is not valid JSON, which Hono's body validator refuses. */
+export class MalformedBodyError extends define('malformed_body') {
+    name = 'ErrorResponse.MalformedBodyError';
+    constructor() {
+        super({
+            error_description: 'Malformed request body. Send a JSON object with `Content-Type: application/json`.',
+        });
+    }
+}
+/** A service Tempo ID depends on, such as Privy, is rate limiting it. */
+export class RateLimitedError extends define('rate_limited') {
+    name = 'ErrorResponse.RateLimitedError';
+    /** Seconds that the service requested, which `handle` sends as `Retry-After`. */
+    retryAfter;
+    constructor(options = {}) {
+        const { retryAfter } = options;
+        super({
+            error_description: `Rate limited by an upstream service. Try again ${retryAfter ? `in ${wait({ seconds: retryAfter })}` : 'later'}.`,
+            ...(retryAfter ? { meta: { retryAfter } } : {}),
+        });
+        this.retryAfter = retryAfter;
+    }
+}
+/** An unexpected failure, which `handle` logs. */
+export class UnexpectedError extends define('unexpected') {
+    name = 'ErrorResponse.UnexpectedError';
+    constructor() {
+        super({ error_description: 'Unexpected error. Try again.' });
+    }
+}
+/** No API route matches the method and path. */
+export class UnknownEndpointError extends define('unknown_endpoint') {
+    name = 'ErrorResponse.UnknownEndpointError';
+    constructor() {
+        // The path is the caller's, and may carry a misplaced credential, so it is not echoed.
+        super({
+            error_description: 'Unknown endpoint. Check the method and path against the API reference at /openapi.json.',
+        });
+    }
+}
+/** A service Tempo ID depends on, such as Privy, failed or did not respond. */
+export class UpstreamUnavailableError extends define('upstream_unavailable') {
+    name = 'ErrorResponse.UpstreamUnavailableError';
+    constructor() {
+        super({
+            error_description: 'An upstream service is unavailable. Retry later.',
+        });
+    }
+}
+/** Zod schemas for every error response, which the OpenAPI document reads. */
+export var schema;
+(function (schema) {
+    /** The members every error response has. */
+    schema.base = z.object({
+        error: z.string().meta({
+            description: 'The OAuth error code (RFC 6749, OIDC Core, RFC 8628, RFC 9396), which `reason` determines.',
+        }),
+        error_description: z.string().meta({
+            description: 'What went wrong and how to fix it, for people. Its wording may change.',
+        }),
+        error_uri: z.url().meta({
+            description: 'The errors page, at the refusal’s `reason`.',
+        }),
+        field: z.string().optional().meta({
+            description: 'Extension: the request field at fault, as a dotted path.',
+        }),
+        meta: z
+            .record(z.string(), z.union([z.number(), z.string()]))
+            .readonly()
+            .optional()
+            .meta({
+            description: 'Extension: the values the refusal compared. Base units are decimal strings.',
+        }),
+        reason: z.string().meta({
+            description: 'Extension: a stable name for the refusal, to branch on.',
+        }),
+        request_id: z.string().optional().meta({
+            description: 'Extension: the request ID, which `X-Request-Id` also carries. The Worker adds it to every error response.',
+        }),
+    });
+    /** Each reason's example `error_description` and `field`, with no real account, app, or origin. */
+    const examples = {
+        already_decided: {
+            error_description: 'Code already approved or denied.',
+            field: 'code',
+        },
+        authorization_expired: {
+            error_description: 'Expired authorization request: the request from the app is no longer valid. Return to the app, and start again.',
+            field: 'oauth_query',
+        },
+        body_too_large: {
+            error_description: 'Invalid request body: exceeds the 65536-byte maximum. Send a body of 65536 bytes or fewer.',
+        },
+        challenge_not_permitted: {
+            error_description: 'Challenge not permitted: the app lacks the `tempo-id:sign` scope. Remove `challenge`, or grant the app the scope.',
+            field: 'challenge',
+        },
+        config_conflict: {
+            error_description: "Configuration conflict: the chain's configuration of 0x8C3b5d0e2A4f6B1c9D7e3F5a0B2c4D6e8F1a3B5c differs from the stored one. Reload the account, and try again.",
+            field: 'account',
+        },
+        configurable_accounts_disabled: {
+            error_description: 'Configurable accounts are not available on the chain `testnet`. Select the chain `t14`.',
+            field: 'chain',
+        },
+        cross_site_request: {
+            error_description: 'Cross-site request refused. Send JSON from an allowed origin.',
+        },
+        duplicate_limit: {
+            error_description: 'Duplicate limit for 0x20c0000000000000000000000000000000000001. Limit each token once.',
+            field: 'key_authorization.limits.1.token',
+        },
+        duplicate_scope: {
+            error_description: 'Duplicate scope for 0xa9059cbb on OUSD. Name each call on a target once.',
+            field: 'key_authorization.scopes.1.selector',
+        },
+        empty_limits: {
+            error_description: 'Empty `limits`. Name at least one token, or omit `limits`.',
+            field: 'key_authorization.limits',
+        },
+        empty_scopes: {
+            error_description: 'Empty `scopes`. Name at least one call, or omit `scopes`.',
+            field: 'key_authorization.scopes',
+        },
+        expiry_exceeds_maximum: {
+            error_description: 'Invalid `expiry`: Sat, 01 Jan 2028 00:00:00 GMT exceeds the one-year maximum. Use an earlier expiry, or authorize through a redirect or device grant.',
+            field: 'key_authorization.expiry',
+        },
+        expiry_passed: {
+            error_description: 'Invalid `expiry`: Wed, 01 Jan 2025 00:00:00 GMT has passed. Use a future Unix time.',
+            field: 'key_authorization.expiry',
+        },
+        foreign_account: {
+            error_description: "Access denied to Tempo Account 0x8C3b5d0e2A4f6B1c9D7e3F5a0B2c4D6e8F1a3B5c. Name one of the user's accounts in the app's realms.",
+            field: 'account',
+        },
+        invalid_chain: {
+            error_description: 'Invalid `chainId`: 0. Use a Tempo chain ID, such as 4217.',
+            field: 'key_authorization.chainId',
+        },
+        invalid_code: {
+            error_description: 'Invalid or expired code. Request a new one.',
+            field: 'code',
+        },
+        invalid_expiry: {
+            error_description: 'Invalid `expiry`: 0 never expires. Use a future Unix time.',
+            field: 'key_authorization.expiry',
+        },
+        invalid_field: {
+            error_description: 'Invalid request. `email`: Invalid email address.',
+            field: 'email',
+        },
+        invalid_id_token_hint: {
+            error_description: 'Invalid id_token_hint: it is not an ID token that this issuer signed for the app. Send the ID token that the app received at sign-in.',
+            field: 'id_token_hint',
+        },
+        invalid_origin: {
+            error_description: 'Invalid `Origin`: https://other.example.com. Requests for this redirect URI must come from https://app.example.com.',
+            field: 'Origin',
+        },
+        invalid_period: {
+            error_description: 'Invalid `period` on the OUSD limit: 1.5. Use a whole number of seconds, or 0 for a one-time limit.',
+            field: 'key_authorization.limits.0.period',
+        },
+        invalid_public_key: {
+            error_description: 'Invalid `publicKey`. Provide an uncompressed public key, or `address`.',
+            field: 'key_authorization.publicKey',
+        },
+        invalid_recipients: {
+            error_description: 'Invalid recipient 0x0000000000000000000000000000000000000000 for 0x095ea7b3 on OUSD. Name each recipient once, and never the zero address.',
+            field: 'key_authorization.scopes.0.recipients.0',
+        },
+        limit_exceeds_maximum: {
+            error_description: 'Invalid OUSD limit: 5000 exceeds the 1000 maximum. Lower the limit, or authorize through a redirect or device grant.',
+            field: 'key_authorization.limits.0.limit',
+        },
+        logout_not_permitted: {
+            error_description: 'Logout not permitted: the app client_01JZ8Q6W3N1R5B4V7C2X9K0M3T may not end the session. Register the app for logout, then retry.',
+        },
+        malformed_body: {
+            error_description: 'Malformed request body. Send a JSON object with `Content-Type: application/json`.',
+        },
+        missing_key: {
+            error_description: 'Missing `address` or `publicKey`. Provide the access key.',
+            field: 'key_authorization.address',
+        },
+        missing_permissions: {
+            error_description: 'Missing `limits` and `scopes`. Name the expiry, limits, and scopes of the key, since a third-party app receives no defaults.',
+            field: 'key_authorization.limits',
+        },
+        missing_recipients: {
+            error_description: 'Missing `recipients` for `approve` on OUSD. Name the allowed spenders.',
+            field: 'key_authorization.scopes.0.recipients',
+        },
+        passkey_link_expired: {
+            error_description: 'Expired passkey sign-in: the link from the passkey step is no longer valid. Enter the code again to sign in with email only, or sign in with the passkey again.',
+            field: 'link',
+        },
+        passkey_not_permitted: {
+            error_description: 'Passkey not permitted: the app client_01JZ8Q6W3N1R5B4V7C2X9K0M3T holds no passkeys. Sign in with an emailed code.',
+        },
+        not_configurable: {
+            error_description: 'Not configurable: 0x8C3b5d0e2A4f6B1c9D7e3F5a0B2c4D6e8F1a3B5c is not a configurable account yet. Upgrade it with its passkey, then add the owner.',
+            field: 'account',
+        },
+        owner_exists: {
+            error_description: 'Owner exists: a cloud wallet already owns 0x8C3b5d0e2A4f6B1c9D7e3F5a0B2c4D6e8F1a3B5c. Use the account as it is.',
+            field: 'wallet',
+        },
+        passkey_limit: {
+            error_description: 'Passkey limit reached: the user holds 10 registered passkeys, the most that Tempo ID registers. Sign in with one of them.',
+        },
+        post_logout_redirect_not_permitted: {
+            error_description: 'Invalid post_logout_redirect_uri: https://app.example/elsewhere is not registered for the app. Use one of its post-logout redirect URIs, or leave it out.',
+            field: 'post_logout_redirect_uri',
+        },
+        rate_limited: {
+            error_description: 'Too many requests. Try again in 30 seconds.',
+        },
+        reauthentication_required: {
+            error_description: 'Sign in again: adding a passkey needs a sign-in within the last 10 minutes.',
+        },
+        rejected: {
+            error_description: "Authorization request rejected. Check `client_id`, `redirect_uri`, and `scope` against the app's registration.",
+        },
+        scope_without_limit: {
+            error_description: 'Scope on 0x20c0000000000000000000000000000000000002 has no limit. Add a limit for it, or remove the scope.',
+            field: 'key_authorization.scopes.0.address',
+        },
+        session_changed: {
+            error_description: 'Changed session: the signed-in account differs from the one that this page showed. Reload the page, and check the account before the decision.',
+            field: 'session_id',
+        },
+        session_required: { error_description: 'Sign in first.' },
+        sign_up_not_permitted: {
+            error_description: 'Sign-up not permitted: new accounts need an address at example.com. Sign in with an existing account, or with an address at example.com.',
+            field: 'email',
+        },
+        unexpected: { error_description: 'Unexpected error. Try again.' },
+        unknown_code: {
+            error_description: 'Invalid or expired code. Check the code in the terminal.',
+            field: 'code',
+        },
+        unknown_endpoint: {
+            error_description: 'Unknown endpoint. Check the method and path against the API reference at /openapi.json.',
+        },
+        unsupported_call: {
+            error_description: 'Unsupported call on OUSD: any function, which includes `approve` without spenders. Name each function in `selector`, such as `transfer`.',
+            field: 'key_authorization.scopes.0.selector',
+        },
+        unsupported_token: {
+            error_description: 'Unsupported token on chain 4217: 0x20c00000000000000000000000000000000000ff. Use a supported token, such as OUSD.',
+            field: 'key_authorization.limits.0.token',
+        },
+        upgrade_required: {
+            error_description: 'Upgrade required: Tempo Account 0x8C3b5d0e2A4f6B1c9D7e3F5a0B2c4D6e8F1a3B5c is not a configurable account on this chain yet. Upgrade it on the account page, then authorize again.',
+            field: 'key_authorization.account',
+        },
+        upstream_unavailable: {
+            error_description: 'An upstream service is unavailable. Retry later.',
+        },
+        webauthn_rejected: {
+            error_description: 'Passkey rejected. Request new options, then try again with the same passkey or another one.',
+        },
+        webauthn_required: {
+            error_description: 'Passkey required: Tempo Account 0x8C3b5d0e2A4f6B1c9D7e3F5a0B2c4D6e8F1a3B5c signs key authorizations only with its passkey, on a Tempo ID page. Authorize through a redirect, popup, or device grant, or name another account.',
+            field: 'key_authorization.account',
+        },
+    };
+    /** Each reason's schema, which the OpenAPI document lists as a component. */
+    const byReason = new Map(Object.entries(reasons).map(([reason, definition]) => {
+        const example = examples[reason];
+        const extended = schema.base.extend({
+            error: z.literal(definition.error).meta(schema.base.shape.error.meta()),
+            error_description: schema.base.shape.error_description.meta({
+                ...schema.base.shape.error_description.meta(),
+                examples: [example.error_description],
+            }),
+            error_uri: schema.base.shape.error_uri.meta({
+                ...schema.base.shape.error_uri.meta(),
+                examples: [`${docs}#${reason}`],
+            }),
+            reason: z.literal(reason).meta(schema.base.shape.reason.meta()),
+            request_id: schema.base.shape.request_id.meta({
+                ...schema.base.shape.request_id.meta(),
+                examples: ['8f1c2a3b4d5e6f70-SJC'],
+            }),
+        });
+        // A refusal that names no field never sends one, so its component leaves `field` out.
+        const documented = example.field
+            ? extended.extend({
+                field: schema.base.shape.field.meta({
+                    ...schema.base.shape.field.meta(),
+                    examples: [example.field],
+                }),
+            })
+            : extended.omit({ field: true });
+        return [
+            reason,
+            documented.meta({
+                description: `\`${definition.error}\` (${definition.status}): ${definition.description}`,
+                id: `ErrorResponse.${reason}`,
+            }),
+        ];
+    }));
+    /** The schema of `reason`'s error response. */
+    function of(reason) {
+        return byReason.get(reason);
+    }
+    schema.of = of;
+})(schema || (schema = {}));
+/** Returns an {@link ErrorResponse} for `reason`, with its `error` and `error_uri`. */
+export function from(value) {
+    const { error_description, field, meta, reason } = value;
+    return {
+        error: reasons[reason].error,
+        error_description,
+        error_uri: `${docs}#${reason}`,
+        ...(field ? { field } : {}),
+        ...(meta ? { meta } : {}),
+        reason,
+    };
+}
+/**
+ * Returns the refusal for an upstream service's failure: `rate_limited` for a 429, and
+ * `upstream_unavailable` for a 408, a 5xx, a timeout, or no response. Returns `undefined` otherwise.
+ */
+export function fromUpstream(failure) {
+    if (failure instanceof HTTPException)
+        return undefined;
+    // SDKs such as Privy's carry the service's HTTP status on the errors they throw.
+    const status = 'status' in failure ? failure.status : undefined;
+    if (status === 429) {
+        const retryAfter = (() => {
+            if (failure instanceof Response) {
+                // Only the delay-seconds form of `Retry-After` is read. An HTTP date is left out.
+                const seconds = Number(failure.headers.get('retry-after'));
+                return Number.isInteger(seconds) && seconds > 0 ? seconds : undefined;
+            }
+            return 'retryAfter' in failure && typeof failure.retryAfter === 'number'
+                ? failure.retryAfter
+                : undefined;
+        })();
+        return new RateLimitedError({ retryAfter });
+    }
+    // An SDK error whose `status` is present but `undefined` received no response, such as Privy's
+    // `APIConnectionTimeoutError` for a timeout or `APIConnectionError` for a dropped connection.
+    const unanswered = 'status' in failure && status === undefined;
+    if ((typeof status === 'number' && (status === 408 || status >= 500)) ||
+        unanswered ||
+        (failure instanceof Error && failure.name === 'TimeoutError'))
+        return new UpstreamUnavailableError();
+    return undefined;
+}
+(function (fromUpstream) {
+    /** The refusals `fromUpstream` returns. */
+    fromUpstream.errors = [RateLimitedError, UpstreamUnavailableError];
+})(fromUpstream || (fromUpstream = {}));
+/**
+ * Maps any error that a handler or middleware throws to its documented response:
+ *
+ * - A {@link ResponseError} maps to its own response.
+ * - Hono's body and CSRF refusals map to `malformed_body` and `cross_site_request`.
+ * - An upstream failure maps to `rate_limited` or `upstream_unavailable`, and logs a warning.
+ * - Anything else maps to `unexpected`, and logs the error.
+ */
+export function handle(error, c) {
+    if (error instanceof ResponseError)
+        return json(c, error);
+    // Hono's body validator refuses unreadable JSON with a bare 400, and `csrf()` with a bare 403.
+    if (error instanceof HTTPException && error.status === 400)
+        return json(c, new MalformedBodyError());
+    if (error instanceof HTTPException && error.status === 403)
+        return json(c, new CrossSiteRequestError());
+    const upstream = fromUpstream(error);
+    if (upstream) {
+        Log.warn(c, { error, message: 'An upstream service refused a request.' });
+        return json(c, upstream);
+    }
+    Log.error(c, { error, message: 'The API failed a request.' });
+    return json(c, new UnexpectedError());
+}
+/** Returns the response for `error`, with `Retry-After` for a `rate_limited` wait. */
+export function json(c, error) {
+    const { response } = error;
+    if (error instanceof RateLimitedError && error.retryAfter)
+        c.header('retry-after', String(error.retryAfter));
+    return c.json(response, reasons[response.reason].status);
+}
+/** Returns a wait of `seconds` in the largest whole unit, rounded up, such as "5 minutes". */
+export function wait(options) {
+    const { seconds } = options;
+    const [value, unit] = (() => {
+        if (seconds < 60)
+            return [seconds, 'second'];
+        if (seconds < 60 * 60)
+            return [Math.ceil(seconds / 60), 'minute'];
+        return [Math.ceil(seconds / (60 * 60)), 'hour'];
+    })();
+    return new Intl.NumberFormat('en', {
+        style: 'unit',
+        unit,
+        unitDisplay: 'long',
+    }).format(value);
+}
+//# sourceMappingURL=ErrorResponse.js.map