tapimo 0.10.2 → 0.12.0

package/dist/internal/MetricSink.js

@@ -123,132 +123,11 @@ export function webhooks(backend) {
         },
         record(event) {
             switch (event.type) {
-                case 'webhook:head-recovery': {
-                    const tags = { chain_id: String(event.chainId), trigger: event.trigger };
-                    backend.count('webhook_head_recovery_queue_count', 1, tags);
-                    backend.histogram('webhook_head_recovery_queue_wait_ms', Math.max(0, event.dequeuedAt - event.enqueuedAt), tags);
-                    return;
-                }
-                case 'webhook:head-progress':
-                    backend.gauge('webhook_head_progress_lag_blocks', event.lagBlocks, {
-                        chain_id: String(event.chainId),
-                    });
-                    return;
                 case 'webhook:head-skipped':
                     backend.gauge('webhook_head_skipped_count', event.skippedHeads, {
                         chain_id: String(event.chainId),
                     });
                     return;
-                case 'webhook:listener-head-lag':
-                    backend.gauge('webhook_listener_head_lag_blocks', event.lagBlocks, {
-                        chain_id: String(event.chainId),
-                    });
-                    return;
-                case 'webhook:poll-failure':
-                    backend.count('webhook_poll_failure_count', 1, {
-                        chain_id: String(event.chainId),
-                        failure: event.failure,
-                        stage: event.stage,
-                        trigger: event.trigger,
-                    });
-                    return;
-                case 'webhook:poll': {
-                    const tags = {
-                        chain_id: String(event.chainId),
-                        ...(event.eventType === undefined ? {} : { event_type: event.eventType }),
-                        outcome: event.outcome,
-                        stage: event.stage,
-                    };
-                    backend.histogram('webhook_poller_stage_duration_ms', event.durationMs, tags);
-                    return;
-                }
-                case 'webhook:poll-scan': {
-                    const tags = {
-                        chain_id: String(event.chainId),
-                        event_type: event.eventType,
-                        phase: event.phase,
-                    };
-                    backend.count('webhook_poller_scan_checkpoint_count', 1, tags);
-                    backend.histogram('webhook_poller_scan_concurrency', event.concurrency, tags);
-                    backend.histogram('webhook_poller_scan_subscription_count', event.subscriptionCount, tags);
-                    backend.histogram('webhook_poller_scan_subscription_limit', event.subscriptionLimit, tags);
-                    backend.histogram('webhook_poller_scan_max_window_blocks', event.maxWindowBlocks, tags);
-                    backend.histogram('webhook_poller_scan_total_window_blocks', event.totalWindowBlocks, tags);
-                    if (event.durationMs !== undefined)
-                        backend.histogram('webhook_poller_scan_duration_ms', event.durationMs, tags);
-                    if (event.failedSubscriptions !== undefined)
-                        backend.count('webhook_poller_scan_failed_subscription_count', event.failedSubscriptions, tags);
-                    if (event.matchedItems !== undefined)
-                        backend.count('webhook_poller_scan_matched_item_count', event.matchedItems, tags);
-                    if (event.outcome !== undefined)
-                        backend.count('webhook_poller_rpc_scan_count', 1, {
-                            chain_id: String(event.chainId),
-                            event_type: event.eventType,
-                            outcome: event.outcome,
-                            rpc_method: event.rpcMethod,
-                        });
-                    return;
-                }
-                case 'webhook:poll-subscriptions':
-                    backend.gauge('webhook_poller_active_subscription_count', event.count, {
-                        chain_id: String(event.chainId),
-                    });
-                    return;
-                case 'webhook:poll-cycle': {
-                    const tags = {
-                        chain_id: String(event.chainId),
-                        outcome: event.outcome,
-                        trigger: event.trigger,
-                    };
-                    backend.count('webhook_poll_cycle_count', 1, tags);
-                    if (event.requestedBoundaryAdvanceBlocks !== undefined)
-                        backend.histogram('webhook_poll_requested_boundary_advance_blocks', event.requestedBoundaryAdvanceBlocks, tags);
-                    return;
-                }
-                case 'webhook:poll-start': {
-                    const tags = { chain_id: String(event.chainId), trigger: event.trigger };
-                    backend.count('webhook_poll_start_count', 1, tags);
-                    if (event.delayMs !== undefined)
-                        backend.histogram('webhook_poll_start_delay_ms', event.delayMs, tags);
-                    return;
-                }
-                case 'webhook:tick': {
-                    const { meta, result } = event;
-                    const chain_id = String(result?.chainId ?? meta.chainId ?? 'unknown');
-                    backend.count('webhook_poller_tick_count', 1, { chain_id, outcome: meta.outcome });
-                    backend.histogram('webhook_poller_tick_duration_ms', meta.durationMs, {
-                        chain_id,
-                        outcome: meta.outcome,
-                    });
-                    if (event.cursorLagBlocks !== undefined)
-                        backend.gauge('webhook_subscription_cursor_lag_blocks', event.cursorLagBlocks, {
-                            chain_id,
-                        });
-                    if (!result)
-                        return;
-                    backend.histogram('webhook_poller_subscription_count', result.subscriptions, { chain_id });
-                    backend.count('webhook_poller_scanned_count', result.scanned, { chain_id });
-                    backend.gauge('webhook_poller_safe_block', result.safeBlock, { chain_id });
-                    backend.count('webhook_poller_dispatch_count', result.dispatched, {
-                        chain_id,
-                        outcome: 'dispatched',
-                    });
-                    backend.count('webhook_poller_dispatch_count', result.failed, {
-                        chain_id,
-                        outcome: 'failed',
-                    });
-                    return;
-                }
-                case 'webhook:enqueue': {
-                    const tags = { chain_id: String(event.chainId), event_type: event.eventType };
-                    const outcome = event.ok ? 'ok' : 'error';
-                    backend.count('webhook_dispatch_enqueue_count', 1, { ...tags, outcome });
-                    backend.histogram('webhook_dispatch_enqueue_duration_ms', event.durationMs, {
-                        ...tags,
-                        outcome,
-                    });
-                    return;
-                }
                 case 'webhook:scan-block': {
                     const tags = {
                         chain_id: String(event.chainId),
@@ -258,12 +137,43 @@ export function webhooks(backend) {
                     backend.count('webhook_scan_block_count', 1, tags);
                     if (event.matches > 0)
                         backend.count('webhook_scan_match_count', event.matches, tags);
+                    backend.histogram('webhook_scan_work_ms', event.workMs, tags);
+                    // Deferred rounds are chain finality, not queue depth, so the wait
+                    // carries the distinction rather than silently averaging the two.
+                    if (event.queueWaitMs !== undefined)
+                        backend.histogram('webhook_scan_queue_wait_ms', event.queueWaitMs, {
+                            ...tags,
+                            deferred: String(event.deferred),
+                        });
+                    if (event.observationLagMs !== undefined)
+                        backend.histogram('webhook_scan_observation_lag_ms', event.observationLagMs, {
+                            chain_id: String(event.chainId),
+                            origin: event.origin,
+                        });
+                    // Block timestamp to scan completion: how far behind the chain the
+                    // scanner is, reported by every scanned block rather than only by
+                    // blocks that produce a delivery.
+                    if (event.scanLagMs !== undefined)
+                        backend.histogram('webhook_scan_lag_ms', event.scanLagMs, {
+                            chain_id: String(event.chainId),
+                        });
+                    return;
+                }
+                case 'webhook:scan-step': {
+                    const tags = { chain_id: String(event.chainId), step: event.step };
+                    // Batch totals, so the count is required to read a per-invocation
+                    // mean: a ten-block batch otherwise reports ten times a one-block
+                    // batch at identical per-call latency.
+                    backend.histogram('webhook_scan_step_duration_ms', event.durationMs, tags);
+                    backend.count('webhook_scan_step_count', event.count, tags);
                     return;
                 }
                 case 'webhook:scan-backlog': {
                     const tags = { chain_id: String(event.chainId) };
                     backend.gauge('webhook_scan_pending_count', event.pendingCount, tags);
                     backend.gauge('webhook_scan_oldest_pending_age_ms', event.oldestPendingAgeMs ?? 0, tags);
+                    if (event.watermarkLagBlocks !== undefined)
+                        backend.gauge('webhook_scan_watermark_lag_blocks', event.watermarkLagBlocks, tags);
                     return;
                 }
                 case 'webhook:scan-finality': {
@@ -315,6 +225,25 @@ export function webhooks(backend) {
                         });
                     if (timings?.deliveryLogMs !== undefined)
                         backend.histogram('webhook_delivery_log_write_ms', timings.deliveryLogMs, tags);
+                    if (timings?.preflightMs !== undefined)
+                        backend.histogram('webhook_delivery_preflight_ms', timings.preflightMs, tags);
+                    if (timings?.settleMs !== undefined)
+                        backend.histogram('webhook_delivery_settle_ms', timings.settleMs, tags);
+                    // The two headline latency SLIs, both ending when the attempt leaves
+                    // rather than when bookkeeping finishes. Attempt-bucketed for the
+                    // same reason as end-to-end: retries carry designed backoff.
+                    if (timings?.eventToAttemptMs !== undefined)
+                        backend.histogram('webhook_event_to_attempt_ms', timings.eventToAttemptMs, {
+                            ...tags,
+                            attempt_bucket: attemptBucket(event.attempt),
+                            outcome,
+                        });
+                    if (timings?.observedToAttemptMs !== undefined)
+                        backend.histogram('webhook_observed_to_attempt_ms', timings.observedToAttemptMs, {
+                            ...tags,
+                            attempt_bucket: attemptBucket(event.attempt),
+                            outcome,
+                        });
                     if (timings?.envelopeToQueueMs !== undefined)
                         backend.histogram('webhook_delivery_envelope_to_queue_ms', timings.envelopeToQueueMs, tags);
                     if (timings?.endToEndMs !== undefined)

package/dist/internal/MetricSink.js.map

@@ -1 +1 @@
-{"version":3,"file":"MetricSink.js","sourceRoot":"","sources":["../../src/internal/MetricSink.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MetricSink.js","sourceRoot":"","sources":["../../src/internal/MetricSink.ts"],"names":[],"mappings":"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"}

package/dist/internal/OpenApi.d.ts

@@ -1,20 +1,23 @@
 import type { Context, Env, MiddlewareHandler, ValidationTargets } from 'hono';
 import type { HasRequiredKeys } from 'hono/utils/types';
-import { type ResponsesWithResolver } from 'hono-openapi';
+import { type DescribeRouteOptions, type ResponsesWithResolver } from 'hono-openapi';
 import * as z from 'zod/mini';
 import * as Response from './Response.js';
-export { describeRoute, type HandlerUniqueProperty, resolver, type ResponsesWithResolver, uniqueSymbol, validator, } from 'hono-openapi';
+export { type HandlerUniqueProperty, resolver, type ResponsesWithResolver, uniqueSymbol, validator, } from 'hono-openapi';
+/** Describes a route without allowing spec generation to mutate reusable response definitions. */
+export declare function describeRoute(spec: DescribeRouteOptions): MiddlewareHandler;
+/** Emits a named OpenAPI component and uses its `$ref` wherever the schema appears. */
+export declare function component<const schema extends z.ZodMiniType>(schema: schema, name: string): schema;
 /**
  * Standard machine-readable `error.code` values per status, shared API-wide.
  * The reference enumerates `error.code` to these so generated clients narrow it
- * to a literal union instead of an open `string`. 400 and 404 vary per
- * operation; the values here are the API-wide supersets, narrowable per route
- * via the `codes` override in {@link responses.Options}.
+ * to a literal union instead of an open `string`. The values here are shared
+ * defaults; operation-specific codes are supplied through {@link responses.Options}.
  */
 export declare const errorCodes: {
     readonly 400: readonly ["query_invalid", "param_invalid", "body_invalid", "address_invalid", "token_invalid", "symbol_invalid", "swap_continuation_invalid", "swap_provider_invalid", "quote_amount_out_of_range", "pair_invalid", "pair_id_invalid", "transaction_invalid", "order_invalid", "block_invalid", "chain_id_invalid", "chain_id_unsupported", "destination_transition_invalid", "sender_tag_invalid", "url_invalid", "api_key_malformed"];
     readonly 401: readonly ["api_key_missing", "api_key_invalid", "unauthorized"];
-    readonly 403: readonly ["api_key_forbidden", "api_key_ip_forbidden", "limit_exceeded"];
+    readonly 403: readonly ["api_key_forbidden", "api_key_ip_forbidden", "forbidden"];
     readonly 404: readonly ["not_found", "token_not_found", "token_logo_not_found", "block_not_found", "transaction_not_found", "receipt_not_found", "order_not_found", "pair_not_found", "quote_not_available", "verified_token_not_found", "webhook_not_found", "delivery_not_found", "webhooks_not_enabled", "billing_not_found"];
     readonly 429: readonly ["rate_limit_exceeded", "payment_required"];
     readonly 500: readonly ["internal_error"];
@@ -130,7 +133,7 @@ export declare const paymentChallenge: {
  * and `$ref`-erenced from operations, so the uniform `402`/`429`/`500` responses
  * are defined once instead of inlined on every operation.
  */
-export declare const responseComponents: ResponsesWithResolver;
+export declare function responseComponents(): ResponsesWithResolver;
 /** `$ref` to the shared `402` payment-challenge response. */
 export declare const paymentChallengeRef: {
     $ref: string;
@@ -147,41 +150,40 @@ export declare function standardError(status: keyof typeof errorCodes, descripti
  * Builds an OpenAPI `responses` map with the API's standard error responses
  * pre-filled, plus the success response (with rate-limit headers):
  *
- * - `400` invalid request, `401` missing/invalid key, `429` rate limited,
- *   `500` internal error, and `502` upstream failure on every operation;
- * - `403`/`404`/`409`/`412`/`413`/`415` only when an `errors` entry is set.
+ * - `400` invalid request, `401` missing/invalid key, `403` forbidden, `429`
+ *   rate limited, `500` internal error, and `502` upstream failure on every operation;
+ * - `404`/`409`/`412`/`413`/`415` only when an `errors` entry is set.
  *
- * `error.code` is enumerated per status from {@link errorCodes}; narrow 400/404
- * to a route's exact codes by passing `{ description, codes }` for that status.
- * `429`/`500` `$ref` the shared {@link responseComponents}. `402` is not emitted
- * here — it is injected per operation from the route's MPP policy during spec
- * generation (see `App.ts`).
+ * `error.code` is enumerated per status from {@link errorCodes}. Operation-level
+ * 400/403 codes merge with shared auth codes; other overrides replace defaults.
+ * The default `429` and `500` `$ref` shared {@link responseComponents}; an exact
+ * operation-level `429` override is emitted inline with the standard headers.
+ * `402` is injected per operation from the route's MPP policy in `App.ts`.
  */
 export declare function responses<schema extends z.ZodMiniType>(options: responses.Options<schema>): ResponsesWithResolver;
 export declare namespace responses {
     /**
      * Override for a standard error response: a description string, or an object
-     * adding the exact `codes` that status can return (narrowing the enum).
+     * adding operation codes. Codes replace defaults except shared 400/403 auth codes.
      */
     type ErrorOverride = string | {
         /** Human-readable description of the error response. */
         description?: string | undefined;
-        /** Exact `error.code` values this status returns for the operation. */
-        codes?: readonly [string, ...string[]] | undefined;
+        /** Operation-specific `error.code` values for this status. */
+        codes?: readonly string[] | undefined;
     };
     /** Options for building a standard OpenAPI responses map. */
     type Options<schema> = {
         /**
-         * Optional overrides for standard error responses (description and/or exact
-         * `error.code` enum). Setting `403`/`404`/`409`/`412`/`413`/`415` also
-         * includes that status in the map.
+         * Optional overrides for standard error responses. Setting
+         * `404`/`409`/`412`/`413`/`415` includes that status in the map.
          */
         errors?: {
             /** Override for the 400 response. */
             400?: ErrorOverride | undefined;
             /** Override for the 401 response. */
             401?: ErrorOverride | undefined;
-            /** Override for the 403 response. Setting this includes 403 in the map. */
+            /** Add operation-specific 403 codes or override its description. */
             403?: ErrorOverride | undefined;
             /** Override for the 404 response. Setting this includes 404 in the map. */
             404?: ErrorOverride | undefined;
@@ -193,6 +195,8 @@ export declare namespace responses {
             413?: ErrorOverride | undefined;
             /** Override for the 415 response. Setting this includes 415 in the map. */
             415?: ErrorOverride | undefined;
+            /** Override the shared 429 response with operation-specific rate-limit codes. */
+            429?: ErrorOverride | undefined;
             /** Override for the 501 response. Setting this includes 501 in the map. */
             501?: ErrorOverride | undefined;
             /** Override for the 502 response. */

package/dist/internal/OpenApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenApi.d.ts","sourceRoot":"","sources":["../../src/internal/OpenApi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"OpenApi.d.ts","sourceRoot":"","sources":["../../src/internal/OpenApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,qBAAqB,EAG3B,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAC7B,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAsCzC,OAAO,EACL,KAAK,qBAAqB,EAC1B,QAAQ,EACR,KAAK,qBAAqB,EAC1B,YAAY,EACZ,SAAS,GACV,MAAM,cAAc,CAAA;AAyBrB,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,iBAAiB,CAM3E;AAED,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EAC1D,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,MAAM,CAIR;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;CA6C4C,CAAA;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;aAC3B,cAAc;iBACZ,WAAW,EAAE,sHAAsH;iBACnI,MAAM;qBAAI,IAAI,EAAE,SAAS;;;aAE3B,kBAAkB;iBAChB,WAAW,EAAE,8IAA8I;iBAC3J,MAAM;qBAAI,IAAI,EAAE,SAAS;;;aAE3B,cAAc;iBACZ,WAAW,EAAE,2HAA2H;iBACxI,MAAM;qBAAI,IAAI,EAAE,SAAS;;;aAE3B,cAAc;iBACZ,WAAW,EAAE,wHAAwH;iBACrI,MAAM;qBAAI,IAAI,EAAE,QAAQ;;;aAE1B,UAAU;iBACR,WAAW,EACT,yFAAyF;iBAC3F,MAAM;qBAAI,IAAI,EAAE,SAAS;;;aAE3B,cAAc;iBACZ,WAAW,EAAE,gKAAgK;iBAC7K,MAAM;qBAAI,IAAI,EAAE,QAAQ;;;aAE1B,eAAe;iBACb,WAAW,EAAE,uIAAuI;iBACpJ,MAAM;qBAAI,IAAI,EAAE,QAAQ;;;CAElB,CAAA;AAMV,oEAAoE;AACpE,eAAO,MAAM,cAAc;IACzB,iBAAiB;;;IACjB,qBAAqB;;;IACrB,iBAAiB;;;IACjB,iBAAiB;;;IACjB,kBAAkB;;;CACnB,CAAA;AAED,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;CAG5B,CAAA;AAkFD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;aAC3B,WAAW,EACT,qWAAqW;aACvW,OAAO;iBAAI,kBAAkB;;;;CACrB,CAAA;AAIV;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,qBAAqB,CAc1D;AAMD,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB;;CAAiC,CAAA;AAEjE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,OAAO,UAAU,EAC/B,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GACrC,qBAAqB,CAAC,MAAM,CAAC,CAI/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EACpD,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,GACjC,qBAAqB,CA0CvB;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC;;;OAGG;IACH,KAAK,aAAa,GACd,MAAM,GACN;QACE,wDAAwD;QACxD,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAChC,8DAA8D;QAC9D,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;KACtC,CAAA;IAEL,6DAA6D;IAC7D,KAAK,OAAO,CAAC,MAAM,IAAI;QACrB;;;WAGG;QACH,MAAM,CAAC,EACH;YACE,qCAAqC;YACrC,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;YAC/B,qCAAqC;YACrC,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;YAC/B,oEAAoE;YACpE,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;YAC/B,2EAA2E;YAC3E,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;YAC/B,2EAA2E;YAC3E,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;YAC/B,2EAA2E;YAC3E,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;YAC/B,2EAA2E;YAC3E,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;YAC/B,2EAA2E;YAC3E,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;YAC/B,iFAAiF;YACjF,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;YAC/B,2EAA2E;YAC3E,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;YAC/B,qCAAqC;YACrC,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;SAChC,GACD,SAAS,CAAA;QACb,2CAA2C;QAC3C,OAAO,EAAE;YACP,sDAAsD;YACtD,WAAW,EAAE,MAAM,CAAA;YACnB,gEAAgE;YAChE,OAAO,CAAC,EAAE,OAAO,CAAA;YACjB,mEAAmE;YACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;gBAAE,WAAW,CAAC,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,OAAO,CAAA;aAAE,CAAC,CAAA;YACrF,mDAAmD;YACnD,MAAM,EAAE,MAAM,CAAA;SACf,CAAA;KACF,CAAA;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAY,OAAO,CAAA;AAEhD,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EACvD,CAAC,EAAE,OAAO,EACV,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAGvC;AAED,MAAM,CAAC,OAAO,WAAW,eAAe,CAAC;IACvC,8DAA8D;IAC9D,KAAK,OAAO,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,IAAI;QAC3C,qDAAqD;QACrD,IAAI,EAAE,IAAI,CAAA;QACV,+CAA+C;QAC/C,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,KAAK,CAAC,MAAM,SAAS,MAAM,iBAAiB,EAC5C,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EAElC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,QAAQ,CAAC,OAAO,GACxB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiBhE;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,qEAAqE;IACrE,KAAK,KAAK,CAAC,MAAM,SAAS,MAAM,iBAAiB,EAAE,MAAM,SAAS,CAAC,CAAC,WAAW,IAAI;QACjF,EAAE,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;QACzC,GAAG,EAAE;aAAG,GAAG,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;SAAE,CAAA;KAC3C,CAAA;IAED,iDAAiD;IACjD,KAAK,OAAO,GAAG;QACb,iEAAiE;QACjE,IAAI,EAAE,MAAM,CAAA;QACZ,oCAAoC;QACpC,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IAED,uEAAuE;IACvE,KAAK,YAAY,CAAC,MAAM,SAAS,MAAM,iBAAiB,EAAE,KAAK,IAAI,MAAM,SAAS,OAAO,GACrF,KAAK,SAAS,MAAM,GAClB,eAAe,CAAC,KAAK,CAAC,SAAS,IAAI,GACjC;QAAE,KAAK,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;KAAE,GACtC;QAAE,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,SAAS,CAAA;KAAE,GACrD;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,GAClB;SAAG,GAAG,IAAI,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC;KAAE,CAAA;IAEnD,4EAA4E;IAC5E,KAAK,WAAW,CACd,MAAM,SAAS,MAAM,iBAAiB,EACtC,KAAK,IACH,KAAK,SAAS,iBAAiB,CAAC,MAAM,CAAC,GACvC,KAAK,GACL;SACG,GAAG,IAAI,MAAM,KAAK,GAAG,GAAG,SAAS,MAAM,iBAAiB,CAAC,MAAM,CAAC,GAC7D,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAC9B,KAAK;KACV,CAAA;CACN"}

package/dist/internal/OpenApi.js

@@ -1,4 +1,4 @@
-import { resolver, validator } from 'hono-openapi';
+import { describeRoute as core_describeRoute, resolver, uniqueSymbol, validator, } from 'hono-openapi';
 import * as z from 'zod/mini';
 import * as Response from './Response.js';
 import * as Schema from './Schema.js';
@@ -37,13 +37,45 @@ const schemaOptions = { options: { override: recoverExamples, unrepresentable: '
 // callers go through this local `OpenApi` module. Forwarded as direct named
 // re-exports because `uniqueSymbol` is a `unique symbol` whose identity is
 // lost when copied through a `const` declaration.
-export { describeRoute, resolver, uniqueSymbol, validator, } from 'hono-openapi';
+export { resolver, uniqueSymbol, validator, } from 'hono-openapi';
+function cloneResponseContainers(spec) {
+    if (!spec.responses)
+        return spec;
+    return {
+        ...spec,
+        responses: Object.fromEntries(Object.entries(spec.responses).map(([status, response]) => [
+            status,
+            !response || !('content' in response)
+                ? response
+                : {
+                    ...response,
+                    content: Object.fromEntries(Object.entries(response.content ?? {}).map(([mediaType, media]) => [
+                        mediaType,
+                        { ...media },
+                    ])),
+                },
+        ])),
+    };
+}
+/** Describes a route without allowing spec generation to mutate reusable response definitions. */
+export function describeRoute(spec) {
+    const handler = core_describeRoute(spec);
+    Object.defineProperty(handler, uniqueSymbol, {
+        get: () => ({ spec: cloneResponseContainers(spec) }),
+    });
+    return handler;
+}
+/** Emits a named OpenAPI component and uses its `$ref` wherever the schema appears. */
+export function component(schema, name) {
+    const cloned = schema.clone();
+    z.globalRegistry.add(cloned, { ...z.globalRegistry.get(schema), ref: name });
+    return cloned;
+}
 /**
  * Standard machine-readable `error.code` values per status, shared API-wide.
  * The reference enumerates `error.code` to these so generated clients narrow it
- * to a literal union instead of an open `string`. 400 and 404 vary per
- * operation; the values here are the API-wide supersets, narrowable per route
- * via the `codes` override in {@link responses.Options}.
+ * to a literal union instead of an open `string`. The values here are shared
+ * defaults; operation-specific codes are supplied through {@link responses.Options}.
  */
 export const errorCodes = {
     400: [
@@ -69,7 +101,7 @@ export const errorCodes = {
         'api_key_malformed',
     ],
     401: ['api_key_missing', 'api_key_invalid', 'unauthorized'],
-    403: ['api_key_forbidden', 'api_key_ip_forbidden', 'limit_exceeded'],
+    403: ['api_key_forbidden', 'api_key_ip_forbidden', 'forbidden'],
     404: [
         'not_found',
         'token_not_found',
@@ -146,11 +178,66 @@ export const rateLimitHeaders = {
 };
 /** Representative `requestId` used in error-body examples. */
 const exampleRequestId = '0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9';
-/** Builds the `application/json` content for a standard error response: the enumerated-code envelope plus an example body. */
-function errorContent(codes, message) {
+const standardErrorNames = {
+    400: 'InvalidRequestError',
+    401: 'AuthenticationError',
+    403: 'ForbiddenError',
+    404: 'ResourceNotFoundError',
+    429: 'RateLimitError',
+    500: 'InternalError',
+    501: 'NotImplementedError',
+    502: 'UpstreamError',
+};
+const reservedErrorNames = new Set(Object.values(standardErrorNames));
+const errorSchemas = new Map();
+function errorName(status, codes) {
+    const standard = errorCodes[status];
+    if (standard &&
+        standard.length === codes.length &&
+        [...standard].sort().every((code, index) => code === codes[index]))
+        return standardErrorNames[status];
+    const name = `${codes
+        .map((code) => code
+        .split('_')
+        .map((part) => `${part[0]?.toUpperCase()}${part.slice(1)}`)
+        .join(''))
+        .join('Or')}Error`;
+    if (reservedErrorNames.has(name))
+        return `${name.slice(0, -'Error'.length)}${status}Error`;
+    return name;
+}
+function errorSchema(status, codes) {
+    const defaults = errorCodes[status];
+    if (!codes && !defaults) {
+        const cached = errorSchemas.get('*');
+        if (cached)
+            return cached;
+        const schema = component(Schema.errorResponse(), 'ErrorResponse');
+        errorSchemas.set('*', schema);
+        return schema;
+    }
+    const normalized = [...(codes ?? defaults ?? [])].sort();
+    const key = normalized.join('\0');
+    const cached = errorSchemas.get(key);
+    if (cached)
+        return cached;
+    const schema = component(Schema.errorResponse(normalized), errorName(status, normalized));
+    errorSchemas.set(key, schema);
+    return schema;
+}
+function mergeErrorCodes(status, codes) {
+    if (!codes)
+        return errorCodes[status];
+    if (status !== 400 && status !== 403)
+        return codes.length ? codes : undefined;
+    const baseline = status === 400 ? ['api_key_malformed'] : errorCodes[403];
+    return [...new Set([...baseline, ...codes])];
+}
+/** Builds the `application/json` content for a standard error response: the named enumerated-code envelope plus an example body. */
+function errorContent(status, codes, message) {
     return {
         'application/json': {
-            schema: resolver(Schema.errorResponse(codes), schemaOptions),
+            schema: resolver(errorSchema(status, codes), schemaOptions),
             example: { error: { code: codes?.[0] ?? 'error', message }, requestId: exampleRequestId },
         },
     };
@@ -165,27 +252,25 @@ export const paymentChallenge = {
     description: 'Payment required. This endpoint accepts MPP payment, and the request either exceeded free quota or needs a paid request credential. The challenge is protocol-native (handled by mppx), not the JSON error envelope: read the `WWW-Authenticate` header and retry with `Authorization: Payment <credential>`. A successful paid response carries `Payment-Receipt`.',
     headers: { 'WWW-Authenticate': headerRef('WwwAuthenticate') },
 };
-/** Shared `429` rate-limit response, registered as `components.responses.RateLimited`. */
-const rateLimitedResponse = {
-    content: errorContent(errorCodes[429], 'Rate limit exceeded.'),
-    description: 'Rate limit exceeded. On endpoints that accept MPP, over-quota unpaid requests return `402 Payment Required` instead.',
-    headers: { ...rateLimitHeaders },
-};
-/** Shared `500` internal-error response, registered as `components.responses.InternalError`. */
-const serverErrorResponse = {
-    content: errorContent(errorCodes[500], 'Internal server error.'),
-    description: 'Internal server error.',
-};
 /**
  * Reusable responses registered under `components.responses` (see `App.create`)
  * and `$ref`-erenced from operations, so the uniform `402`/`429`/`500` responses
  * are defined once instead of inlined on every operation.
  */
-export const responseComponents = {
-    InternalError: serverErrorResponse,
-    PaymentRequired: paymentChallenge,
-    RateLimited: rateLimitedResponse,
-};
+export function responseComponents() {
+    return {
+        InternalError: {
+            content: errorContent(500, errorCodes[500], 'Internal server error.'),
+            description: 'Internal server error.',
+        },
+        PaymentRequired: paymentChallenge,
+        RateLimited: {
+            content: errorContent(429, errorCodes[429], 'Rate limit exceeded.'),
+            description: 'Rate limit exceeded. On endpoints that accept MPP, over-quota unpaid requests return `402 Payment Required` instead.',
+            headers: { ...rateLimitHeaders },
+        },
+    };
+}
 const responseRef = (name) => ({
     $ref: `#/components/responses/${name}`,
 });
@@ -203,30 +288,32 @@ export function standardError(status, description, codes) {
         return responseRef('RateLimited');
     if (status === 500)
         return responseRef('InternalError');
-    return { content: errorContent(codes ?? errorCodes[status], description), description };
+    return { content: errorContent(status, mergeErrorCodes(status, codes), description), description };
 }
 /**
  * Builds an OpenAPI `responses` map with the API's standard error responses
  * pre-filled, plus the success response (with rate-limit headers):
  *
- * - `400` invalid request, `401` missing/invalid key, `429` rate limited,
- *   `500` internal error, and `502` upstream failure on every operation;
- * - `403`/`404`/`409`/`412`/`413`/`415` only when an `errors` entry is set.
+ * - `400` invalid request, `401` missing/invalid key, `403` forbidden, `429`
+ *   rate limited, `500` internal error, and `502` upstream failure on every operation;
+ * - `404`/`409`/`412`/`413`/`415` only when an `errors` entry is set.
  *
- * `error.code` is enumerated per status from {@link errorCodes}; narrow 400/404
- * to a route's exact codes by passing `{ description, codes }` for that status.
- * `429`/`500` `$ref` the shared {@link responseComponents}. `402` is not emitted
- * here — it is injected per operation from the route's MPP policy during spec
- * generation (see `App.ts`).
+ * `error.code` is enumerated per status from {@link errorCodes}. Operation-level
+ * 400/403 codes merge with shared auth codes; other overrides replace defaults.
+ * The default `429` and `500` `$ref` shared {@link responseComponents}; an exact
+ * operation-level `429` override is emitted inline with the standard headers.
+ * `402` is injected per operation from the route's MPP policy in `App.ts`.
  */
 export function responses(options) {
     const { errors, success } = options;
     const error = (status, fallback) => {
         const override = errors?.[status];
         const description = typeof override === 'string' ? override : (override?.description ?? fallback);
-        const codes = (typeof override === 'object' ? override.codes : undefined) ??
-            errorCodes[status];
-        return { content: errorContent(codes, description), description };
+        const codes = mergeErrorCodes(status, typeof override === 'object' ? override.codes : undefined);
+        return {
+            content: errorContent(status, codes, description),
+            description,
+        };
     };
     return {
         200: {
@@ -245,13 +332,15 @@ export function responses(options) {
         },
         400: error(400, 'Invalid request.'),
         401: error(401, 'Missing or invalid API key.'),
-        ...(errors?.[403] && { 403: error(403, 'Forbidden.') }),
+        403: error(403, 'Forbidden.'),
         ...(errors?.[404] && { 404: error(404, 'Not found.') }),
         ...(errors?.[409] && { 409: error(409, 'Conflict.') }),
         ...(errors?.[412] && { 412: error(412, 'Precondition failed.') }),
         ...(errors?.[413] && { 413: error(413, 'Payload too large.') }),
         ...(errors?.[415] && { 415: error(415, 'Unsupported media type.') }),
-        429: responseRef('RateLimited'),
+        429: errors?.[429]
+            ? { ...error(429, 'Rate limit exceeded.'), headers: { ...rateLimitHeaders } }
+            : responseRef('RateLimited'),
         500: responseRef('InternalError'),
         ...(errors?.[501] && { 501: error(501, 'Not implemented.') }),
         502: error(502, 'Upstream data failure.'),