@webpieces/core-util 0.4.750 → 0.4.751

package/src/http/errors.d.ts

@@ -1,20 +1,4 @@
-/**
- * HTTP Error classes for webpieces-ts.
- * These errors are used throughout the framework for consistent error handling.
- */
-/**
- * ProtocolError - Data class for error response body.
- * This is what gets serialized and sent to the client.
- *
- * EVERY field here is caller-facing, so the framework fills it CONSERVATIVELY. `HttpErrorWireMapper`
- * (http-server) copies `message` from the thrown error for {@link HttpUserError} ONLY — the one type
- * whose message is written for a human to read — and sends the generic HTTP reason phrase for every
- * other type, because `Error.message` is an operator-facing field that routinely quotes downstream
- * urls, response bodies and internal ids. `name` is not filled by that ladder at all.
- *
- * An app that wants to publish more than that does it deliberately, by installing an
- * {@link ErrorTranslators} on {@link ClientRegistry}, whose `toWire()` response is sent verbatim.
- */
+import { ApiError } from '../errors/ApiError';
 export declare class ProtocolError {
     message?: string;
     subType?: string;
@@ -28,16 +12,6 @@ export declare class ProtocolError {
     guiAlertMessage?: string;
     errorCode?: string;
 }
-/**
- * HttpError - Base error class with HTTP status code.
- * All specific HTTP errors extend this class.
- */
-export declare class HttpError extends Error {
-    code: number;
-    subType?: string;
-    readonly httpCause?: Error;
-    constructor(message: string, code: number, subType?: string, cause?: Error);
-}
 export declare const ENTITY_NOT_FOUND = "EntityNotFoundError";
 export declare const WRONG_LOGIN_TYPE = "wrongLoginType";
 export declare const WRONG_LOGIN = "wronglogin";
@@ -46,134 +20,37 @@ export declare const EMAIL_NOT_CONFIRMED = "email_not_confirmed";
 export declare const WRONG_DOMAIN = "wrongdomain";
 export declare const WRONG_COMPANY = "wrongcompany";
 export declare const NO_REG_CODE = "noregcode";
-/**
- * HttpNotFoundError - 404 Not Found.
- */
-export declare class HttpNotFoundError extends HttpError {
-    constructor(message: string, cause?: Error);
-}
-/**
- * EndpointNotFoundError - 404 for missing endpoints.
- */
-export declare class EndpointNotFoundError extends HttpNotFoundError {
-    constructor(message: string, cause?: Error);
-}
-/**
- * HttpBadRequestError - 400 Bad Request.
- * Used for validation errors with optional field and GUI message.
- */
-export declare class HttpBadRequestError extends HttpError {
-    field?: string;
-    guiMessage?: string;
-    constructor(message: string, field?: string, guiMessage?: string, cause?: Error);
-}
-/**
- * HttpUnauthorizedError - 401 Unauthorized.
- */
-export declare class HttpUnauthorizedError extends HttpError {
-    constructor(message: string, subType?: string, cause?: Error);
-}
-/**
- * HttpTooManyRequestsError - 429 Too Many Requests.
- *
- * The one member of the HttpError ladder that never made it over from the production service this ladder was ported from. Without it, apps are
- * forced back to `err.code === 429` — the exact untyped pattern this ladder exists to replace.
- */
-export declare class HttpTooManyRequestsError extends HttpError {
-    constructor(message: string, cause?: Error);
-}
-/**
- * HttpForbiddenError - 403 Forbidden.
- */
-export declare class HttpForbiddenError extends HttpError {
-    constructor(message: string, cause?: Error);
-}
-/**
- * HttpTimeoutError - 408 Request Timeout.
- */
-export declare class HttpTimeoutError extends HttpError {
-    constructor(message: string, cause?: Error);
-}
-/**
- * HttpBadGatewayError - 502 Bad Gateway.
- */
-export declare class HttpBadGatewayError extends HttpError {
-    constructor(message: string, cause?: Error);
-}
-/**
- * HttpServiceUnavailableError - 503 Service Unavailable.
- *
- * The cold-start code: a scale-to-zero backend (Cloud Run `min_instance_count = 0`) whose instance
- * is still booting is answered by the load balancer with a 503 and ITS OWN HTML page — no
- * ProtocolError body at all. Without this member the client fell through to a generic `HttpError`,
- * so an app could not say "the server is waking, retry" without matching on `err.code === 503`,
- * which is the untyped pattern this ladder exists to replace.
- */
-export declare class HttpServiceUnavailableError extends HttpError {
-    constructor(message: string, cause?: Error);
-}
-/**
- * HttpGatewayTimeoutError - 504 Gateway Timeout.
- * SHOULD NOT BE USED SERVER SIDE SINCE ALBs will return 504 and it will not be translated
- * to json body 'ProtocolError'.
- */
-export declare class HttpGatewayTimeoutError extends HttpError {
-    constructor(message: string, cause?: Error);
-}
-/**
- * HttpInternalServerError - 500 Internal Server Error.
- */
-export declare class HttpInternalServerError extends HttpError {
-    constructor(message: string, cause?: Error);
-}
-/**
- * HttpVendorError - 598 Vendor Error.
- * Custom status code for vendor/external service errors with retry hint.
- */
-export declare class HttpVendorError extends HttpError {
-    waitSeconds: number;
-    constructor(message: string, waitSeconds?: number, cause?: Error);
-}
-/**
- * HttpUserError - User validation error with 2xx status code.
- *
- * Uses HTTP 266 (non-standard 2xx code) intentionally because:
- * 1. User validation errors are "successful" from server perspective - user just made a mistake
- * 2. Browser DevTools show 4xx/5xx codes in RED, which is confusing for user validation
- * 3. Allows error to propagate up the stack via throw without triggering error monitoring
- * 4. Avoids polluting logs with "errors" that are actually expected user behavior
- *
- * This is a deliberate design pattern - do NOT change to 4xx codes.
- * Examples: "Email already exists", "Invalid password format", "Required field missing"
- *
- * # It is also the ONLY type whose `message` reaches the caller
- *
- * `HttpErrorWireMapper` (http-server) copies `message` onto the response body for this type and no
- * other; every other subclass sends the generic HTTP reason phrase for its status. That is not an
- * arbitrary exception — it follows from the four points above. This type MEANS "this text was written
- * for a human to read", where `Error.message` everywhere else means "this text was written for whoever
- * reads the logs" and routinely quotes downstream urls, response bodies and internal ids.
- *
- * So: text the user must SEE goes in an `HttpUserError` (or in `HttpBadRequestError.guiMessage`,
- * which is the same idea one field down). Throwing `new HttpForbiddenError('you need the admin role
- * on tenant 4471')` shows the user 'Forbidden' and nothing else.
- */
-export declare class HttpUserError extends HttpError {
-    errorCode?: string;
-    constructor(message: string, errorCode?: string, cause?: Error);
-}
-/**
- * OfflineError - the request never reached a server.
- *
- * Offline, DNS failure, connection refused, CORS preflight rejected: `fetch` itself rejected, so no
- * Response — and therefore no HTTP status — ever existed. That is precisely why this extends `Error`
- * and NOT `HttpError`: an `HttpError` carries a `code` and means "the server replied with a failure",
- * a different situation a caller usually retries differently. Subclassing it would give this a bogus
- * status and make it match `instanceof HttpError` ladders that must not catch a transport reject.
- *
- * The original failure (a raw `TypeError: Failed to fetch`, or undici's coded reject) is always
- * preserved as `cause`, so a caller that wants the underlying detail can still reach it.
- */
-export declare class OfflineError extends Error {
-    constructor(message: string, cause?: Error);
-}
+/** @deprecated Prefer ApiError semantic subclasses; custom HTTP status belongs in ErrorTranslators. */
+export declare class HttpError extends ApiError {
+    code: number;
+    constructor(message: string, code: number, subType?: string, cause?: Error);
+    /** @deprecated Use the standard Error.cause. */
+    get httpCause(): Error | undefined;
+}
+export { EndpointNotFoundError, OfflineError } from '../errors/ApiError';
+/** @deprecated Use NotFoundError from @webpieces/core-util/errors. Same constructor identity. */
+export { NotFoundError as HttpNotFoundError } from '../errors/ApiError';
+/** @deprecated Use BadRequestError from @webpieces/core-util/errors. Same constructor identity. */
+export { BadRequestError as HttpBadRequestError } from '../errors/ApiError';
+/** @deprecated Use UnauthorizedError from @webpieces/core-util/errors. Same constructor identity. */
+export { UnauthorizedError as HttpUnauthorizedError } from '../errors/ApiError';
+/** @deprecated Use TooManyRequestsError from @webpieces/core-util/errors. Same constructor identity. */
+export { TooManyRequestsError as HttpTooManyRequestsError } from '../errors/ApiError';
+/** @deprecated Use ForbiddenError from @webpieces/core-util/errors. Same constructor identity. */
+export { ForbiddenError as HttpForbiddenError } from '../errors/ApiError';
+/** @deprecated Use RequestTimeoutError from @webpieces/core-util/errors. Same constructor identity. */
+export { RequestTimeoutError as HttpTimeoutError } from '../errors/ApiError';
+/** @deprecated Use BadGatewayError from @webpieces/core-util/errors. Same constructor identity. */
+export { BadGatewayError as HttpBadGatewayError } from '../errors/ApiError';
+/** @deprecated Use ServiceUnavailableError from @webpieces/core-util/errors. Same constructor identity. */
+export { ServiceUnavailableError as HttpServiceUnavailableError } from '../errors/ApiError';
+/** @deprecated Use GatewayTimeoutError from @webpieces/core-util/errors. Same constructor identity. */
+export { GatewayTimeoutError as HttpGatewayTimeoutError } from '../errors/ApiError';
+/** @deprecated Use InternalError from @webpieces/core-util/errors. Same constructor identity. */
+export { InternalError as HttpInternalServerError } from '../errors/ApiError';
+/** @deprecated Use VendorError from @webpieces/core-util/errors. Same constructor identity. */
+export { VendorError as HttpVendorError } from '../errors/ApiError';
+/** @deprecated Use UserError from @webpieces/core-util/errors. Same constructor identity. */
+export { UserError as HttpUserError } from '../errors/ApiError';
+export { NotFoundError, BadGatewayError, ServiceUnavailableError, GatewayTimeoutError, InternalError, TooManyRequestsError, ForbiddenError, RequestTimeoutError, UserError, BadRequestError, UnauthorizedError, VendorError, } from '../errors/ApiError';
+export { ApiError };

package/src/http/errors.js

@@ -1,23 +1,8 @@
 "use strict";
-/**
- * HTTP Error classes for webpieces-ts.
- * These errors are used throughout the framework for consistent error handling.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OfflineError = exports.HttpUserError = exports.HttpVendorError = exports.HttpInternalServerError = exports.HttpGatewayTimeoutError = exports.HttpServiceUnavailableError = exports.HttpBadGatewayError = exports.HttpTimeoutError = exports.HttpForbiddenError = exports.HttpTooManyRequestsError = exports.HttpUnauthorizedError = exports.HttpBadRequestError = exports.EndpointNotFoundError = exports.HttpNotFoundError = exports.NO_REG_CODE = exports.WRONG_COMPANY = exports.WRONG_DOMAIN = exports.EMAIL_NOT_CONFIRMED = exports.NOT_APPROVED = exports.WRONG_LOGIN = exports.WRONG_LOGIN_TYPE = exports.ENTITY_NOT_FOUND = exports.HttpError = exports.ProtocolError = void 0;
-/**
- * ProtocolError - Data class for error response body.
- * This is what gets serialized and sent to the client.
- *
- * EVERY field here is caller-facing, so the framework fills it CONSERVATIVELY. `HttpErrorWireMapper`
- * (http-server) copies `message` from the thrown error for {@link HttpUserError} ONLY — the one type
- * whose message is written for a human to read — and sends the generic HTTP reason phrase for every
- * other type, because `Error.message` is an operator-facing field that routinely quotes downstream
- * urls, response bodies and internal ids. `name` is not filled by that ladder at all.
- *
- * An app that wants to publish more than that does it deliberately, by installing an
- * {@link ErrorTranslators} on {@link ClientRegistry}, whose `toWire()` response is sent verbatim.
- */
+exports.ApiError = exports.VendorError = exports.UnauthorizedError = exports.BadRequestError = exports.UserError = exports.RequestTimeoutError = exports.ForbiddenError = exports.TooManyRequestsError = exports.InternalError = exports.GatewayTimeoutError = exports.ServiceUnavailableError = exports.BadGatewayError = exports.NotFoundError = exports.HttpUserError = exports.HttpVendorError = exports.HttpInternalServerError = exports.HttpGatewayTimeoutError = exports.HttpServiceUnavailableError = exports.HttpBadGatewayError = exports.HttpTimeoutError = exports.HttpForbiddenError = exports.HttpTooManyRequestsError = exports.HttpUnauthorizedError = exports.HttpBadRequestError = exports.HttpNotFoundError = exports.OfflineError = exports.EndpointNotFoundError = exports.HttpError = exports.NO_REG_CODE = exports.WRONG_COMPANY = exports.WRONG_DOMAIN = exports.EMAIL_NOT_CONFIRMED = exports.NOT_APPROVED = exports.WRONG_LOGIN = exports.WRONG_LOGIN_TYPE = exports.ENTITY_NOT_FOUND = exports.ProtocolError = void 0;
+const ApiError_1 = require("../errors/ApiError");
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return ApiError_1.ApiError; } });
 class ProtocolError {
     message;
     subType;
@@ -32,22 +17,6 @@ class ProtocolError {
     errorCode;
 }
 exports.ProtocolError = ProtocolError;
-/**
- * HttpError - Base error class with HTTP status code.
- * All specific HTTP errors extend this class.
- */
-class HttpError extends Error {
-    code;
-    subType;
-    httpCause;
-    constructor(message, code, subType, cause) {
-        super(message);
-        this.code = code;
-        this.subType = subType;
-        this.httpCause = cause;
-    }
-}
-exports.HttpError = HttpError;
 // Error subtype constants
 exports.ENTITY_NOT_FOUND = 'EntityNotFoundError';
 exports.WRONG_LOGIN_TYPE = 'wrongLoginType';
@@ -57,209 +26,70 @@ exports.EMAIL_NOT_CONFIRMED = 'email_not_confirmed';
 exports.WRONG_DOMAIN = 'wrongdomain';
 exports.WRONG_COMPANY = 'wrongcompany';
 exports.NO_REG_CODE = 'noregcode';
-/**
- * HttpNotFoundError - 404 Not Found.
- */
-class HttpNotFoundError extends HttpError {
-    constructor(message, cause) {
-        super(message, 404, undefined, cause);
-        this.name = exports.ENTITY_NOT_FOUND;
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpNotFoundError = HttpNotFoundError;
-/**
- * EndpointNotFoundError - 404 for missing endpoints.
- */
-class EndpointNotFoundError extends HttpNotFoundError {
-    constructor(message, cause) {
+/** @deprecated Prefer ApiError semantic subclasses; custom HTTP status belongs in ErrorTranslators. */
+class HttpError extends ApiError_1.ApiError {
+    code;
+    constructor(message, code, subType, cause) {
         super(message, cause);
-        this.name = 'EndpointNotFoundError';
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.EndpointNotFoundError = EndpointNotFoundError;
-/**
- * HttpBadRequestError - 400 Bad Request.
- * Used for validation errors with optional field and GUI message.
- */
-class HttpBadRequestError extends HttpError {
-    field;
-    guiMessage;
-    constructor(message, field, guiMessage, cause) {
-        super(message, 400, undefined, cause);
-        this.name = 'BadRequest';
-        this.field = field;
-        this.guiMessage = guiMessage;
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpBadRequestError = HttpBadRequestError;
-/**
- * HttpUnauthorizedError - 401 Unauthorized.
- */
-class HttpUnauthorizedError extends HttpError {
-    constructor(message, subType, cause) {
-        super(message, 401, subType, cause);
-        this.name = 'Unauthorized';
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpUnauthorizedError = HttpUnauthorizedError;
-/**
- * HttpTooManyRequestsError - 429 Too Many Requests.
- *
- * The one member of the HttpError ladder that never made it over from the production service this ladder was ported from. Without it, apps are
- * forced back to `err.code === 429` — the exact untyped pattern this ladder exists to replace.
- */
-class HttpTooManyRequestsError extends HttpError {
-    constructor(message, cause) {
-        super(message, 429, undefined, cause);
-        this.name = 'TooManyRequests';
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpTooManyRequestsError = HttpTooManyRequestsError;
-/**
- * HttpForbiddenError - 403 Forbidden.
- */
-class HttpForbiddenError extends HttpError {
-    constructor(message, cause) {
-        super(message, 403, undefined, cause);
-        this.name = 'Forbidden';
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpForbiddenError = HttpForbiddenError;
-/**
- * HttpTimeoutError - 408 Request Timeout.
- */
-class HttpTimeoutError extends HttpError {
-    constructor(message, cause) {
-        super(message, 408, undefined, cause);
-        this.name = 'Timeout';
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpTimeoutError = HttpTimeoutError;
-/**
- * HttpBadGatewayError - 502 Bad Gateway.
- */
-class HttpBadGatewayError extends HttpError {
-    constructor(message, cause) {
-        super(message, 502, undefined, cause);
-        this.name = 'HttpBadGatewayError';
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpBadGatewayError = HttpBadGatewayError;
-/**
- * HttpServiceUnavailableError - 503 Service Unavailable.
- *
- * The cold-start code: a scale-to-zero backend (Cloud Run `min_instance_count = 0`) whose instance
- * is still booting is answered by the load balancer with a 503 and ITS OWN HTML page — no
- * ProtocolError body at all. Without this member the client fell through to a generic `HttpError`,
- * so an app could not say "the server is waking, retry" without matching on `err.code === 503`,
- * which is the untyped pattern this ladder exists to replace.
- */
-class HttpServiceUnavailableError extends HttpError {
-    constructor(message, cause) {
-        super(message, 503, undefined, cause);
-        this.name = 'HttpServiceUnavailableError';
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpServiceUnavailableError = HttpServiceUnavailableError;
-/**
- * HttpGatewayTimeoutError - 504 Gateway Timeout.
- * SHOULD NOT BE USED SERVER SIDE SINCE ALBs will return 504 and it will not be translated
- * to json body 'ProtocolError'.
- */
-class HttpGatewayTimeoutError extends HttpError {
-    constructor(message, cause) {
-        super(message, 504, undefined, cause);
-        this.name = 'HttpGatewayTimeoutError';
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpGatewayTimeoutError = HttpGatewayTimeoutError;
-/**
- * HttpInternalServerError - 500 Internal Server Error.
- */
-class HttpInternalServerError extends HttpError {
-    constructor(message, cause) {
-        super(message, 500, undefined, cause);
-        this.name = 'InternalServerError';
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpInternalServerError = HttpInternalServerError;
-/**
- * HttpVendorError - 598 Vendor Error.
- * Custom status code for vendor/external service errors with retry hint.
- */
-class HttpVendorError extends HttpError {
-    waitSeconds;
-    constructor(message, waitSeconds = 30, cause) {
-        super(message, 598, undefined, cause);
-        this.waitSeconds = waitSeconds;
-        this.name = 'VendorError';
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpVendorError = HttpVendorError;
-/**
- * HttpUserError - User validation error with 2xx status code.
- *
- * Uses HTTP 266 (non-standard 2xx code) intentionally because:
- * 1. User validation errors are "successful" from server perspective - user just made a mistake
- * 2. Browser DevTools show 4xx/5xx codes in RED, which is confusing for user validation
- * 3. Allows error to propagate up the stack via throw without triggering error monitoring
- * 4. Avoids polluting logs with "errors" that are actually expected user behavior
- *
- * This is a deliberate design pattern - do NOT change to 4xx codes.
- * Examples: "Email already exists", "Invalid password format", "Required field missing"
- *
- * # It is also the ONLY type whose `message` reaches the caller
- *
- * `HttpErrorWireMapper` (http-server) copies `message` onto the response body for this type and no
- * other; every other subclass sends the generic HTTP reason phrase for its status. That is not an
- * arbitrary exception — it follows from the four points above. This type MEANS "this text was written
- * for a human to read", where `Error.message` everywhere else means "this text was written for whoever
- * reads the logs" and routinely quotes downstream urls, response bodies and internal ids.
- *
- * So: text the user must SEE goes in an `HttpUserError` (or in `HttpBadRequestError.guiMessage`,
- * which is the same idea one field down). Throwing `new HttpForbiddenError('you need the admin role
- * on tenant 4471')` shows the user 'Forbidden' and nothing else.
- */
-class HttpUserError extends HttpError {
-    errorCode;
-    constructor(message, errorCode, cause) {
-        super(message, 266, 'USER_ERROR', cause);
-        this.name = 'UserError';
-        this.errorCode = errorCode;
-        Object.setPrototypeOf(this, new.target.prototype);
+        this.code = code;
+        this.subType = subType;
     }
-}
-exports.HttpUserError = HttpUserError;
-/**
- * OfflineError - the request never reached a server.
- *
- * Offline, DNS failure, connection refused, CORS preflight rejected: `fetch` itself rejected, so no
- * Response — and therefore no HTTP status — ever existed. That is precisely why this extends `Error`
- * and NOT `HttpError`: an `HttpError` carries a `code` and means "the server replied with a failure",
- * a different situation a caller usually retries differently. Subclassing it would give this a bogus
- * status and make it match `instanceof HttpError` ladders that must not catch a transport reject.
- *
- * The original failure (a raw `TypeError: Failed to fetch`, or undici's coded reject) is always
- * preserved as `cause`, so a caller that wants the underlying detail can still reach it.
- */
-class OfflineError extends Error {
-    constructor(message, cause) {
-        super(message, { cause });
-        this.name = 'OfflineError';
-        Object.setPrototypeOf(this, new.target.prototype);
+    /** @deprecated Use the standard Error.cause. */
+    get httpCause() {
+        return this.cause instanceof Error ? this.cause : undefined;
     }
 }
-exports.OfflineError = OfflineError;
+exports.HttpError = HttpError;
+var ApiError_2 = require("../errors/ApiError");
+Object.defineProperty(exports, "EndpointNotFoundError", { enumerable: true, get: function () { return ApiError_2.EndpointNotFoundError; } });
+Object.defineProperty(exports, "OfflineError", { enumerable: true, get: function () { return ApiError_2.OfflineError; } });
+/** @deprecated Use NotFoundError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_3 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpNotFoundError", { enumerable: true, get: function () { return ApiError_3.NotFoundError; } });
+/** @deprecated Use BadRequestError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_4 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpBadRequestError", { enumerable: true, get: function () { return ApiError_4.BadRequestError; } });
+/** @deprecated Use UnauthorizedError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_5 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpUnauthorizedError", { enumerable: true, get: function () { return ApiError_5.UnauthorizedError; } });
+/** @deprecated Use TooManyRequestsError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_6 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpTooManyRequestsError", { enumerable: true, get: function () { return ApiError_6.TooManyRequestsError; } });
+/** @deprecated Use ForbiddenError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_7 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpForbiddenError", { enumerable: true, get: function () { return ApiError_7.ForbiddenError; } });
+/** @deprecated Use RequestTimeoutError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_8 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpTimeoutError", { enumerable: true, get: function () { return ApiError_8.RequestTimeoutError; } });
+/** @deprecated Use BadGatewayError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_9 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpBadGatewayError", { enumerable: true, get: function () { return ApiError_9.BadGatewayError; } });
+/** @deprecated Use ServiceUnavailableError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_10 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpServiceUnavailableError", { enumerable: true, get: function () { return ApiError_10.ServiceUnavailableError; } });
+/** @deprecated Use GatewayTimeoutError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_11 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpGatewayTimeoutError", { enumerable: true, get: function () { return ApiError_11.GatewayTimeoutError; } });
+/** @deprecated Use InternalError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_12 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpInternalServerError", { enumerable: true, get: function () { return ApiError_12.InternalError; } });
+/** @deprecated Use VendorError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_13 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpVendorError", { enumerable: true, get: function () { return ApiError_13.VendorError; } });
+/** @deprecated Use UserError from @webpieces/core-util/errors. Same constructor identity. */
+var ApiError_14 = require("../errors/ApiError");
+Object.defineProperty(exports, "HttpUserError", { enumerable: true, get: function () { return ApiError_14.UserError; } });
+var ApiError_15 = require("../errors/ApiError");
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return ApiError_15.NotFoundError; } });
+Object.defineProperty(exports, "BadGatewayError", { enumerable: true, get: function () { return ApiError_15.BadGatewayError; } });
+Object.defineProperty(exports, "ServiceUnavailableError", { enumerable: true, get: function () { return ApiError_15.ServiceUnavailableError; } });
+Object.defineProperty(exports, "GatewayTimeoutError", { enumerable: true, get: function () { return ApiError_15.GatewayTimeoutError; } });
+Object.defineProperty(exports, "InternalError", { enumerable: true, get: function () { return ApiError_15.InternalError; } });
+Object.defineProperty(exports, "TooManyRequestsError", { enumerable: true, get: function () { return ApiError_15.TooManyRequestsError; } });
+Object.defineProperty(exports, "ForbiddenError", { enumerable: true, get: function () { return ApiError_15.ForbiddenError; } });
+Object.defineProperty(exports, "RequestTimeoutError", { enumerable: true, get: function () { return ApiError_15.RequestTimeoutError; } });
+Object.defineProperty(exports, "UserError", { enumerable: true, get: function () { return ApiError_15.UserError; } });
+Object.defineProperty(exports, "BadRequestError", { enumerable: true, get: function () { return ApiError_15.BadRequestError; } });
+Object.defineProperty(exports, "UnauthorizedError", { enumerable: true, get: function () { return ApiError_15.UnauthorizedError; } });
+Object.defineProperty(exports, "VendorError", { enumerable: true, get: function () { return ApiError_15.VendorError; } });
 //# sourceMappingURL=errors.js.map

package/src/http/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/http/errors.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HTTP Error classes for webpieces-ts.\n * These errors are used throughout the framework for consistent error handling.\n */\n\n/**\n * ProtocolError - Data class for error response body.\n * This is what gets serialized and sent to the client.\n *\n * EVERY field here is caller-facing, so the framework fills it CONSERVATIVELY. `HttpErrorWireMapper`\n * (http-server) copies `message` from the thrown error for {@link HttpUserError} ONLY — the one type\n * whose message is written for a human to read — and sends the generic HTTP reason phrase for every\n * other type, because `Error.message` is an operator-facing field that routinely quotes downstream\n * urls, response bodies and internal ids. `name` is not filled by that ladder at all.\n *\n * An app that wants to publish more than that does it deliberately, by installing an\n * {@link ErrorTranslators} on {@link ClientRegistry}, whose `toWire()` response is sent verbatim.\n */\nexport class ProtocolError {\n    public message?: string;\n    public subType?: string;\n    public field?: string;\n    public waitSeconds?: number;\n    /**\n     * Filled only by an app's own `ErrorTranslators.toWire()`. The built-in HttpError ladder does NOT\n     * send it: nothing on the client reads it, and for a subclass it is an internal class name.\n     */\n    public name?: string;\n    public guiAlertMessage?: string;\n    public errorCode?: string;\n}\n\n/**\n * HttpError - Base error class with HTTP status code.\n * All specific HTTP errors extend this class.\n */\nexport class HttpError extends Error {\n    public code: number;\n    public subType?: string;\n    public readonly httpCause?: Error;\n\n    constructor(\n        message: string,\n        code: number,\n        subType?: string,\n        cause?: Error,\n    ) {\n        super(message);\n        this.code = code;\n        this.subType = subType;\n        this.httpCause = cause;\n    }\n}\n\n// Error subtype constants\nexport const ENTITY_NOT_FOUND = 'EntityNotFoundError';\nexport const WRONG_LOGIN_TYPE = 'wrongLoginType';\nexport const WRONG_LOGIN = 'wronglogin';\nexport const NOT_APPROVED = 'notapproved';\nexport const EMAIL_NOT_CONFIRMED = 'email_not_confirmed';\nexport const WRONG_DOMAIN = 'wrongdomain';\nexport const WRONG_COMPANY = 'wrongcompany';\nexport const NO_REG_CODE = 'noregcode';\n\n/**\n * HttpNotFoundError - 404 Not Found.\n */\nexport class HttpNotFoundError extends HttpError {\n    constructor(message: string, cause?: Error) {\n        super(message, 404, undefined, cause);\n        this.name = ENTITY_NOT_FOUND;\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * EndpointNotFoundError - 404 for missing endpoints.\n */\nexport class EndpointNotFoundError extends HttpNotFoundError {\n    constructor(message: string, cause?: Error) {\n        super(message, cause);\n        this.name = 'EndpointNotFoundError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * HttpBadRequestError - 400 Bad Request.\n * Used for validation errors with optional field and GUI message.\n */\nexport class HttpBadRequestError extends HttpError {\n    public field?: string;\n    public guiMessage?: string;\n\n    constructor(message: string, field?: string, guiMessage?: string, cause?: Error) {\n        super(message, 400, undefined, cause);\n        this.name = 'BadRequest';\n        this.field = field;\n        this.guiMessage = guiMessage;\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * HttpUnauthorizedError - 401 Unauthorized.\n */\nexport class HttpUnauthorizedError extends HttpError {\n    constructor(message: string, subType?: string, cause?: Error) {\n        super(message, 401, subType, cause);\n        this.name = 'Unauthorized';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * HttpTooManyRequestsError - 429 Too Many Requests.\n *\n * The one member of the HttpError ladder that never made it over from the production service this ladder was ported from. Without it, apps are\n * forced back to `err.code === 429` — the exact untyped pattern this ladder exists to replace.\n */\nexport class HttpTooManyRequestsError extends HttpError {\n    constructor(message: string, cause?: Error) {\n        super(message, 429, undefined, cause);\n        this.name = 'TooManyRequests';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * HttpForbiddenError - 403 Forbidden.\n */\nexport class HttpForbiddenError extends HttpError {\n    constructor(message: string, cause?: Error) {\n        super(message, 403, undefined, cause);\n        this.name = 'Forbidden';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * HttpTimeoutError - 408 Request Timeout.\n */\nexport class HttpTimeoutError extends HttpError {\n    constructor(message: string, cause?: Error) {\n        super(message, 408, undefined, cause);\n        this.name = 'Timeout';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * HttpBadGatewayError - 502 Bad Gateway.\n */\nexport class HttpBadGatewayError extends HttpError {\n    constructor(message: string, cause?: Error) {\n        super(message, 502, undefined, cause);\n        this.name = 'HttpBadGatewayError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * HttpServiceUnavailableError - 503 Service Unavailable.\n *\n * The cold-start code: a scale-to-zero backend (Cloud Run `min_instance_count = 0`) whose instance\n * is still booting is answered by the load balancer with a 503 and ITS OWN HTML page — no\n * ProtocolError body at all. Without this member the client fell through to a generic `HttpError`,\n * so an app could not say \"the server is waking, retry\" without matching on `err.code === 503`,\n * which is the untyped pattern this ladder exists to replace.\n */\nexport class HttpServiceUnavailableError extends HttpError {\n    constructor(message: string, cause?: Error) {\n        super(message, 503, undefined, cause);\n        this.name = 'HttpServiceUnavailableError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * HttpGatewayTimeoutError - 504 Gateway Timeout.\n * SHOULD NOT BE USED SERVER SIDE SINCE ALBs will return 504 and it will not be translated\n * to json body 'ProtocolError'.\n */\nexport class HttpGatewayTimeoutError extends HttpError {\n    constructor(message: string, cause?: Error) {\n        super(message, 504, undefined, cause);\n        this.name = 'HttpGatewayTimeoutError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * HttpInternalServerError - 500 Internal Server Error.\n */\nexport class HttpInternalServerError extends HttpError {\n    constructor(message: string, cause?: Error) {\n        super(message, 500, undefined, cause);\n        this.name = 'InternalServerError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * HttpVendorError - 598 Vendor Error.\n * Custom status code for vendor/external service errors with retry hint.\n */\nexport class HttpVendorError extends HttpError {\n    constructor(\n        message: string,\n        public waitSeconds = 30,\n        cause?: Error,\n    ) {\n        super(message, 598, undefined, cause);\n        this.name = 'VendorError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * HttpUserError - User validation error with 2xx status code.\n *\n * Uses HTTP 266 (non-standard 2xx code) intentionally because:\n * 1. User validation errors are \"successful\" from server perspective - user just made a mistake\n * 2. Browser DevTools show 4xx/5xx codes in RED, which is confusing for user validation\n * 3. Allows error to propagate up the stack via throw without triggering error monitoring\n * 4. Avoids polluting logs with \"errors\" that are actually expected user behavior\n *\n * This is a deliberate design pattern - do NOT change to 4xx codes.\n * Examples: \"Email already exists\", \"Invalid password format\", \"Required field missing\"\n *\n * # It is also the ONLY type whose `message` reaches the caller\n *\n * `HttpErrorWireMapper` (http-server) copies `message` onto the response body for this type and no\n * other; every other subclass sends the generic HTTP reason phrase for its status. That is not an\n * arbitrary exception — it follows from the four points above. This type MEANS \"this text was written\n * for a human to read\", where `Error.message` everywhere else means \"this text was written for whoever\n * reads the logs\" and routinely quotes downstream urls, response bodies and internal ids.\n *\n * So: text the user must SEE goes in an `HttpUserError` (or in `HttpBadRequestError.guiMessage`,\n * which is the same idea one field down). Throwing `new HttpForbiddenError('you need the admin role\n * on tenant 4471')` shows the user 'Forbidden' and nothing else.\n */\nexport class HttpUserError extends HttpError {\n    public errorCode?: string;\n\n    constructor(message: string, errorCode?: string, cause?: Error) {\n        super(message, 266, 'USER_ERROR', cause);\n        this.name = 'UserError';\n        this.errorCode = errorCode;\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/**\n * OfflineError - the request never reached a server.\n *\n * Offline, DNS failure, connection refused, CORS preflight rejected: `fetch` itself rejected, so no\n * Response — and therefore no HTTP status — ever existed. That is precisely why this extends `Error`\n * and NOT `HttpError`: an `HttpError` carries a `code` and means \"the server replied with a failure\",\n * a different situation a caller usually retries differently. Subclassing it would give this a bogus\n * status and make it match `instanceof HttpError` ladders that must not catch a transport reject.\n *\n * The original failure (a raw `TypeError: Failed to fetch`, or undici's coded reject) is always\n * preserved as `cause`, so a caller that wants the underlying detail can still reach it.\n */\nexport class OfflineError extends Error {\n    constructor(message: string, cause?: Error) {\n        super(message, { cause });\n        this.name = 'OfflineError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/http/errors.ts"],"names":[],"mappings":";;;AAAA,iDAA8C;AAiFrC,yFAjFA,mBAAQ,OAiFA;AAhFjB,MAAa,aAAa;IACf,OAAO,CAAU;IACjB,OAAO,CAAU;IACjB,KAAK,CAAU;IACf,WAAW,CAAU;IAC5B;;;OAGG;IACI,IAAI,CAAU;IACd,eAAe,CAAU;IACzB,SAAS,CAAU;CAC7B;AAZD,sCAYC;AAED,0BAA0B;AACb,QAAA,gBAAgB,GAAG,qBAAqB,CAAC;AACzC,QAAA,gBAAgB,GAAG,gBAAgB,CAAC;AACpC,QAAA,WAAW,GAAG,YAAY,CAAC;AAC3B,QAAA,YAAY,GAAG,aAAa,CAAC;AAC7B,QAAA,mBAAmB,GAAG,qBAAqB,CAAC;AAC5C,QAAA,YAAY,GAAG,aAAa,CAAC;AAC7B,QAAA,aAAa,GAAG,cAAc,CAAC;AAC/B,QAAA,WAAW,GAAG,WAAW,CAAC;AAEvC,uGAAuG;AACvG,MAAa,SAAU,SAAQ,mBAAQ;IAGxB;IAFX,YACI,OAAe,EACR,IAAY,EACnB,OAAgB,EAChB,KAAa;QAEb,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAJf,SAAI,GAAJ,IAAI,CAAQ;QAKnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IACD,gDAAgD;IAChD,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,CAAC;CACJ;AAdD,8BAcC;AACD,+CAAyE;AAAhE,iHAAA,qBAAqB,OAAA;AAAE,wGAAA,YAAY,OAAA;AAC5C,iGAAiG;AACjG,+CAAwE;AAA/D,6GAAA,aAAa,OAAqB;AAC3C,mGAAmG;AACnG,+CAA4E;AAAnE,+GAAA,eAAe,OAAuB;AAC/C,qGAAqG;AACrG,+CAAgF;AAAvE,iHAAA,iBAAiB,OAAyB;AACnD,wGAAwG;AACxG,+CAAsF;AAA7E,oHAAA,oBAAoB,OAA4B;AACzD,kGAAkG;AAClG,+CAA0E;AAAjE,8GAAA,cAAc,OAAsB;AAC7C,uGAAuG;AACvG,+CAA6E;AAApE,4GAAA,mBAAmB,OAAoB;AAChD,mGAAmG;AACnG,+CAA4E;AAAnE,+GAAA,eAAe,OAAuB;AAC/C,2GAA2G;AAC3G,gDAA4F;AAAnF,wHAAA,uBAAuB,OAA+B;AAC/D,uGAAuG;AACvG,gDAAoF;AAA3E,oHAAA,mBAAmB,OAA2B;AACvD,iGAAiG;AACjG,gDAA8E;AAArE,oHAAA,aAAa,OAA2B;AACjD,+FAA+F;AAC/F,gDAAoE;AAA3D,4GAAA,WAAW,OAAmB;AACvC,6FAA6F;AAC7F,gDAAgE;AAAvD,0GAAA,SAAS,OAAiB;AAEnC,gDAa4B;AAZxB,0GAAA,aAAa,OAAA;AACb,4GAAA,eAAe,OAAA;AACf,oHAAA,uBAAuB,OAAA;AACvB,gHAAA,mBAAmB,OAAA;AACnB,0GAAA,aAAa,OAAA;AACb,iHAAA,oBAAoB,OAAA;AACpB,2GAAA,cAAc,OAAA;AACd,gHAAA,mBAAmB,OAAA;AACnB,sGAAA,SAAS,OAAA;AACT,4GAAA,eAAe,OAAA;AACf,8GAAA,iBAAiB,OAAA;AACjB,wGAAA,WAAW,OAAA","sourcesContent":["import { ApiError } from '../errors/ApiError';\nexport class ProtocolError {\n    public message?: string;\n    public subType?: string;\n    public field?: string;\n    public waitSeconds?: number;\n    /**\n     * Filled only by an app's own `ErrorTranslators.toWire()`. The built-in HttpError ladder does NOT\n     * send it: nothing on the client reads it, and for a subclass it is an internal class name.\n     */\n    public name?: string;\n    public guiAlertMessage?: string;\n    public errorCode?: string;\n}\n\n// Error subtype constants\nexport const ENTITY_NOT_FOUND = 'EntityNotFoundError';\nexport const WRONG_LOGIN_TYPE = 'wrongLoginType';\nexport const WRONG_LOGIN = 'wronglogin';\nexport const NOT_APPROVED = 'notapproved';\nexport const EMAIL_NOT_CONFIRMED = 'email_not_confirmed';\nexport const WRONG_DOMAIN = 'wrongdomain';\nexport const WRONG_COMPANY = 'wrongcompany';\nexport const NO_REG_CODE = 'noregcode';\n\n/** @deprecated Prefer ApiError semantic subclasses; custom HTTP status belongs in ErrorTranslators. */\nexport class HttpError extends ApiError {\n    constructor(\n        message: string,\n        public code: number,\n        subType?: string,\n        cause?: Error,\n    ) {\n        super(message, cause);\n        this.subType = subType;\n    }\n    /** @deprecated Use the standard Error.cause. */\n    get httpCause(): Error | undefined {\n        return this.cause instanceof Error ? this.cause : undefined;\n    }\n}\nexport { EndpointNotFoundError, OfflineError } from '../errors/ApiError';\n/** @deprecated Use NotFoundError from @webpieces/core-util/errors. Same constructor identity. */\nexport { NotFoundError as HttpNotFoundError } from '../errors/ApiError';\n/** @deprecated Use BadRequestError from @webpieces/core-util/errors. Same constructor identity. */\nexport { BadRequestError as HttpBadRequestError } from '../errors/ApiError';\n/** @deprecated Use UnauthorizedError from @webpieces/core-util/errors. Same constructor identity. */\nexport { UnauthorizedError as HttpUnauthorizedError } from '../errors/ApiError';\n/** @deprecated Use TooManyRequestsError from @webpieces/core-util/errors. Same constructor identity. */\nexport { TooManyRequestsError as HttpTooManyRequestsError } from '../errors/ApiError';\n/** @deprecated Use ForbiddenError from @webpieces/core-util/errors. Same constructor identity. */\nexport { ForbiddenError as HttpForbiddenError } from '../errors/ApiError';\n/** @deprecated Use RequestTimeoutError from @webpieces/core-util/errors. Same constructor identity. */\nexport { RequestTimeoutError as HttpTimeoutError } from '../errors/ApiError';\n/** @deprecated Use BadGatewayError from @webpieces/core-util/errors. Same constructor identity. */\nexport { BadGatewayError as HttpBadGatewayError } from '../errors/ApiError';\n/** @deprecated Use ServiceUnavailableError from @webpieces/core-util/errors. Same constructor identity. */\nexport { ServiceUnavailableError as HttpServiceUnavailableError } from '../errors/ApiError';\n/** @deprecated Use GatewayTimeoutError from @webpieces/core-util/errors. Same constructor identity. */\nexport { GatewayTimeoutError as HttpGatewayTimeoutError } from '../errors/ApiError';\n/** @deprecated Use InternalError from @webpieces/core-util/errors. Same constructor identity. */\nexport { InternalError as HttpInternalServerError } from '../errors/ApiError';\n/** @deprecated Use VendorError from @webpieces/core-util/errors. Same constructor identity. */\nexport { VendorError as HttpVendorError } from '../errors/ApiError';\n/** @deprecated Use UserError from @webpieces/core-util/errors. Same constructor identity. */\nexport { UserError as HttpUserError } from '../errors/ApiError';\n\nexport {\n    NotFoundError,\n    BadGatewayError,\n    ServiceUnavailableError,\n    GatewayTimeoutError,\n    InternalError,\n    TooManyRequestsError,\n    ForbiddenError,\n    RequestTimeoutError,\n    UserError,\n    BadRequestError,\n    UnauthorizedError,\n    VendorError,\n} from '../errors/ApiError';\nexport { ApiError };\n"]}

package/src/index.d.ts

@@ -8,7 +8,7 @@
  */
 export { toError } from './lib/errorUtils';
 export { ContextKey } from './ContextKey';
-export type { AnyContextKey, AnyTrustedContextKey, AnyUntrustedContextKey, Trust } from './ContextKey';
+export type { AnyContextKey, AnyTrustedContextKey, AnyUntrustedContextKey, Trust, } from './ContextKey';
 export { ContextTuple } from './ContextTuple';
 export { DocumentDesign, isDocumentDesign, DESIGN_METADATA_KEYS } from './DocumentDesign';
 export type { Logger, LogLevel } from './logging/Logger';
@@ -16,15 +16,15 @@ export type { LoggerFactory } from './logging/LoggerFactory';
 export { ConsoleLogger } from './logging/ConsoleLogger';
 export { ConsoleLoggerFactory } from './logging/ConsoleLoggerFactory';
 export { LogManager } from './logging/LogManager';
-export { LogChunker, LogChunkerImpl, LogChunkInfo, MAX_GCP_LOG_BYTES, GCP_LOG_BUDGET_BYTES } from './logging/LogChunker';
+export { LogChunker, LogChunkerImpl, LogChunkInfo, MAX_GCP_LOG_BYTES, GCP_LOG_BUDGET_BYTES, } from './logging/LogChunker';
 export { ApiPath, Endpoint, Public, AuthJwt, rolesRequired, MISSING_AUTH_DECORATOR_FIX, AuthOidc, AuthSharedSecret, AuthWebhook, AuthApiKey, AuthLocalOnly, MaskLog, getApiPath, getEndpoints, getEndpointOptions, getEndpointKind, getEndpointKinds, getMaskSpec, isFormPost, isRawBody, isApiPath, getAuthMeta, getAuthMode, assertEveryEndpointHasAuthMode, assertEveryExternalEndpointDeclaresCaller, assertEveryWebhookEndpointRetainsRawBody, validateNoConflictingDecorators, METADATA_KEYS, } from './http/decorators';
 export { RouteMetadata } from './http/RouteMetadata';
 export type { EndpointKind, EndpointOptions, ExternalEndpointOptions } from './http/decorators';
 export { AuthMeta } from './http/auth-mode';
-export type { AuthMode, ApiKeyCredential, ApiKeyCredentials, JwtRoles, JwtRequirement } from './http/auth-mode';
+export type { AuthMode, ApiKeyCredential, ApiKeyCredentials, JwtRoles, JwtRequirement, } from './http/auth-mode';
 export { Rpc, PubSub, Queue, ENDPOINT_KINDS_BY_API_KIND, getApiKind, assertApiKind, assertPubSubConventions, getQueueName, } from './http/api-kind';
 export type { ApiKind } from './http/api-kind';
-export { EXTERNAL_SYSTEM_KINDS, DEFAULT_CALLER_KIND, ExternalCaller, isExternalSystemKind, getEndpointCaller } from './http/external-caller';
+export { EXTERNAL_SYSTEM_KINDS, DEFAULT_CALLER_KIND, ExternalCaller, isExternalSystemKind, getEndpointCaller, } from './http/external-caller';
 export type { ExternalSystemKind } from './http/external-caller';
 export { Secrets, SECRETS } from './http/Secrets';
 export { ValidateImplementation } from './http/validators';
@@ -57,14 +57,16 @@ export { MaskSpec } from './http/LogFieldMask';
 export type { MaskMode } from './http/LogFieldMask';
 export { ApiCallInfo } from './http/ApiCallInfo';
 export type { ApiType, ApiResult } from './http/ApiCallInfo';
-export { ApiCallLogName, ApiCallLogNameImpl, LOG_API_CALL_LOGGER_NAME } from './http/ApiCallLogName';
+export { ApiCallLogName, ApiCallLogNameImpl, LOG_API_CALL_LOGGER_NAME, } from './http/ApiCallLogName';
 export { ApiMethodInfo } from './http/ApiMethodInfo';
 export type { ApiSide } from './http/ApiMethodInfo';
 export type { ApiCallContext } from './http/ApiCallContext';
 export { TestCaseRecorder, RecorderKeys } from './http/recorder/TestCaseRecorder';
-export { RecordedEndpoint, RecordedError, RecordedTestCase } from './http/recorder/RecordedEndpoint';
+export { RecordedEndpoint, RecordedError, RecordedTestCase, } from './http/recorder/RecordedEndpoint';
 export { DoNotRecord, getDoNotRecordFields } from './http/recorder/DoNotRecord';
 export { RecordSerializer, SerializedMap, SerializedError } from './http/recorder/RecordSerializer';
 export { Filter } from './filters/Filter';
 export type { Service } from './filters/Filter';
 export { FilterChain } from './filters/FilterChain';
+export { ApiError, NotFoundError, BadGatewayError, ServiceUnavailableError, GatewayTimeoutError, InternalError, TooManyRequestsError, ForbiddenError, RequestTimeoutError, UserError, BadRequestError, UnauthorizedError, VendorError, ApiErrorCodec, ApiErrorPayload, } from './errors';
+export { HttpErrorStatus } from './http/HttpErrorStatus';