@webpieces/core-util 0.4.761 → 0.4.763

package/src/errors/ApiErrorCodec.js

@@ -2,42 +2,43 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiErrorCodec = exports.ApiErrorPayload = void 0;
 const ApiError_1 = require("./ApiError");
-/** Allowlisted error envelope shared by non-HTTP transports. Contains only bounded semantic causes, never stacks or arbitrary properties. */
+/** Allowlisted transport-neutral envelope. It never contains stacks or arbitrary properties. */
 class ApiErrorPayload {
     kind;
     message;
     cause;
     subType;
     field;
-    guiAlertMessage;
+    callerMessage;
     errorCode;
-    waitSeconds;
-    constructor(kind, message) {
+    retryAfterSeconds;
+    constructor(kind = 'implementation', message = 'Internal Error') {
         this.kind = kind;
         this.message = message;
     }
 }
 exports.ApiErrorPayload = ApiErrorPayload;
-/** Bounded, safe, transport-neutral encoding. Unrecognized types become generic internal failures. */
+/** Bounded safe codec shared by HTTP, IPC, and other remote adapters. */
 class ApiErrorCodec {
-    // webpieces-disable no-function-outside-class -- stateless public codec shared by transport adapters; webpieces-disable no-any-unknown -- thrown values are untrusted until narrowed by the codec
+    // webpieces-disable no-function-outside-class -- stateless public transport codec; webpieces-disable no-any-unknown -- thrown values are untrusted until narrowed
     static encode(error) {
         return this.encodeDepth(error, 0);
     }
-    // webpieces-disable no-function-outside-class -- recursive bounded wire codec; webpieces-disable no-any-unknown -- thrown causes require runtime narrowing
+    // webpieces-disable no-function-outside-class -- recursive bounded transport codec; webpieces-disable no-any-unknown -- thrown causes require narrowing
     static encodeDepth(error, depth) {
-        const kind = this.kind(error);
-        const payload = new ApiErrorPayload(kind, error instanceof ApiError_1.UserError ? error.message.slice(0, 4096) : this.message(kind));
+        const kind = error instanceof ApiError_1.ApiError ? error.kind : 'implementation';
+        const payload = new ApiErrorPayload(kind, this.publicMessage(error, kind));
         if (error instanceof ApiError_1.ApiError)
             payload.subType = this.text(error.subType);
-        if (error instanceof ApiError_1.UserError)
+        if (error instanceof ApiError_1.ApiEndUserError)
             payload.errorCode = this.text(error.errorCode);
-        if (error instanceof ApiError_1.BadRequestError) {
+        if (error instanceof ApiError_1.ApiBadRequestError) {
             payload.field = this.text(error.field);
-            payload.guiAlertMessage = this.text(error.guiMessage);
+            payload.callerMessage = this.text(error.callerMessage);
+        }
+        if (error instanceof ApiError_1.ApiDependencyBackoffError) {
+            payload.retryAfterSeconds = this.wait(error.retryAfterSeconds);
         }
-        if (error instanceof ApiError_1.VendorError)
-            payload.waitSeconds = this.wait(error.waitSeconds);
         if (error instanceof Error && depth < 3) {
             const cause = Object.getOwnPropertyDescriptor(error, 'cause')?.value;
             if (cause instanceof Error)
@@ -45,17 +46,26 @@ class ApiErrorCodec {
         }
         return payload;
     }
-    // webpieces-disable no-function-outside-class -- stateless public codec shared by transport adapters; webpieces-disable no-any-unknown -- JSON transport input must be validated before use
+    /** Decode a value received from another process. Implementation failures are marked remote. */
+    // webpieces-disable no-function-outside-class -- stateless public transport codec; webpieces-disable no-any-unknown -- wire values require validation
     static decode(value) {
         return this.decodeDepth(value, 0);
     }
-    // webpieces-disable no-function-outside-class -- recursive bounded wire codec; webpieces-disable no-any-unknown -- remote causes remain untrusted until validated
+    /** Whether a body carries a recognized Webpieces semantic discriminator. */
+    // webpieces-disable no-function-outside-class -- stateless wire discriminator check; webpieces-disable no-any-unknown -- wire values require validation
+    static isPayload(value) {
+        if (typeof value !== 'object' || value === null)
+            return false;
+        const kind = Object.getOwnPropertyDescriptor(value, 'kind')?.value;
+        return typeof kind === 'string' && this.kinds.has(kind);
+    }
+    // webpieces-disable no-function-outside-class -- recursive bounded transport codec; webpieces-disable no-any-unknown -- remote causes require validation
     static decodeDepth(value, depth) {
         const error = this.decodeOne(value);
         if (typeof value === 'object' && value !== null && depth < 3) {
             const cause = Object.getOwnPropertyDescriptor(value, 'cause')?.value;
             if (typeof cause === 'object' && cause !== null) {
-                // webpieces-disable no-anonymous-object-literals -- standard property descriptor keeps Error.cause non-enumerable
+                // webpieces-disable no-anonymous-object-literals -- standard descriptor preserves Error.cause semantics
                 Object.defineProperty(error, 'cause', {
                     value: this.decodeDepth(cause, depth + 1),
                     configurable: true,
@@ -65,92 +75,72 @@ class ApiErrorCodec {
         }
         return error;
     }
-    // webpieces-disable no-function-outside-class -- allowlisted wire codec; webpieces-disable no-any-unknown -- JSON transport input must be validated before use
+    // webpieces-disable no-function-outside-class -- allowlisted wire codec; webpieces-disable no-any-unknown -- wire fields require validation
     static decodeOne(value) {
         if (typeof value !== 'object' || value === null)
-            return new ApiError_1.InternalError('Internal Error');
+            return this.remoteImplementationError();
         // webpieces-disable no-any-unknown -- own wire fields remain untrusted until narrowed
         const field = (key) => Object.getOwnPropertyDescriptor(value, key)?.value;
         const kind = field('kind');
         const message = this.text(field('message')) ?? this.message(kind);
         switch (kind) {
-            case 'user':
-                return new ApiError_1.UserError(message, this.text(field('errorCode')));
+            case 'end-user':
+                return new ApiError_1.ApiEndUserError(message, this.text(field('errorCode')));
             case 'bad-request':
-                return new ApiError_1.BadRequestError(message, this.text(field('field')), this.text(field('guiAlertMessage')));
+                return new ApiError_1.ApiBadRequestError(message, this.text(field('field')), this.text(field('callerMessage')));
             case 'unauthorized':
-                return new ApiError_1.UnauthorizedError(message, this.text(field('subType')));
+                return new ApiError_1.ApiUnauthorizedError(message, this.text(field('subType')));
             case 'forbidden':
-                return new ApiError_1.ForbiddenError(message);
+                return new ApiError_1.ApiForbiddenError(message);
             case 'not-found':
-                return new ApiError_1.NotFoundError(message);
+                return new ApiError_1.ApiNotFoundError(message);
             case 'endpoint-not-found':
-                return new ApiError_1.EndpointNotFoundError(message);
+                return new ApiError_1.ApiEndpointNotFoundError(message);
             case 'request-timeout':
-                return new ApiError_1.RequestTimeoutError(message);
-            case 'too-many-requests':
-                return new ApiError_1.TooManyRequestsError(message);
-            case 'bad-gateway':
-                return new ApiError_1.BadGatewayError(message);
-            case 'service-unavailable':
-                return new ApiError_1.ServiceUnavailableError(message);
-            case 'gateway-timeout':
-                return new ApiError_1.GatewayTimeoutError(message);
-            case 'vendor':
-                return new ApiError_1.VendorError(message, this.wait(field('waitSeconds')));
-            case 'offline':
-                return new ApiError_1.OfflineError(message);
-            case 'internal':
-                return new ApiError_1.InternalError(message);
+                return new ApiError_1.ApiRequestTimeoutError(message);
+            case 'rate-limited':
+                return new ApiError_1.ApiRateLimitedError(message);
+            case 'dependency':
+                return new ApiError_1.ApiDependencyError(message);
+            case 'unavailable':
+                return new ApiError_1.ApiUnavailableError(message);
+            case 'dependency-timeout':
+                return new ApiError_1.ApiDependencyTimeoutError(message);
+            case 'dependency-backoff':
+                return new ApiError_1.ApiDependencyBackoffError(message, this.wait(field('retryAfterSeconds')));
+            case 'connection':
+                return new ApiError_1.ApiConnectionError(message);
+            case 'implementation':
+                return new ApiError_1.ApiImplementationError(message, undefined, true);
             default:
-                return new ApiError_1.InternalError('Internal Error');
+                return this.remoteImplementationError();
         }
     }
-    // webpieces-disable no-function-outside-class -- helper of stateless codec; webpieces-disable no-any-unknown -- thrown values need instanceof narrowing before encoding
-    static kind(error) {
-        if (error instanceof ApiError_1.UserError)
-            return 'user';
-        if (error instanceof ApiError_1.BadRequestError)
-            return 'bad-request';
-        if (error instanceof ApiError_1.UnauthorizedError)
-            return 'unauthorized';
-        if (error instanceof ApiError_1.ForbiddenError)
-            return 'forbidden';
-        if (error instanceof ApiError_1.EndpointNotFoundError)
-            return 'endpoint-not-found';
-        if (error instanceof ApiError_1.NotFoundError)
-            return 'not-found';
-        if (error instanceof ApiError_1.RequestTimeoutError)
-            return 'request-timeout';
-        if (error instanceof ApiError_1.TooManyRequestsError)
-            return 'too-many-requests';
-        if (error instanceof ApiError_1.BadGatewayError)
-            return 'bad-gateway';
-        if (error instanceof ApiError_1.ServiceUnavailableError)
-            return 'service-unavailable';
-        if (error instanceof ApiError_1.GatewayTimeoutError)
-            return 'gateway-timeout';
-        if (error instanceof ApiError_1.VendorError)
-            return 'vendor';
-        if (error instanceof ApiError_1.OfflineError)
-            return 'offline';
-        return 'internal';
+    // webpieces-disable no-function-outside-class -- concrete normalization for malformed remote errors
+    static remoteImplementationError() {
+        return new ApiError_1.ApiImplementationError('Internal Error', undefined, true);
+    }
+    // webpieces-disable no-function-outside-class -- caller-safe message selection; webpieces-disable no-any-unknown -- thrown values require narrowing
+    static publicMessage(error, kind) {
+        if (error instanceof ApiError_1.ApiEndUserError)
+            return error.message.slice(0, 4096);
+        return this.message(kind);
     }
-    // webpieces-disable no-function-outside-class -- helper of stateless codec; webpieces-disable no-any-unknown -- wire fields need runtime string checks
+    // webpieces-disable no-function-outside-class -- wire string bound; webpieces-disable no-any-unknown -- wire values require validation
     static text(value) {
         return typeof value === 'string' ? value.slice(0, 4096) : undefined;
     }
-    // webpieces-disable no-function-outside-class -- helper of stateless codec; webpieces-disable no-any-unknown -- wire fields need runtime finite number checks
+    // webpieces-disable no-function-outside-class -- wire number bound; webpieces-disable no-any-unknown -- wire values require validation
     static wait(value) {
         return typeof value === 'number' && Number.isFinite(value) && value >= 0
             ? Math.min(value, 86400)
             : undefined;
     }
-    // webpieces-disable no-function-outside-class -- helper of stateless codec; webpieces-disable no-any-unknown -- wire discriminator must be allowlisted before selection
+    // webpieces-disable no-function-outside-class -- allowlisted generic messages; webpieces-disable no-any-unknown -- discriminator is validated by switch
     static message(kind) {
         switch (kind) {
-            case 'user':
-                return 'User Error';
+            case 'end-user':
+                return 'End User Error';
             case 'bad-request':
                 return 'Bad Request';
             case 'unauthorized':
@@ -163,22 +153,38 @@ class ApiErrorCodec {
                 return 'Endpoint Not Found';
             case 'request-timeout':
                 return 'Request Timeout';
-            case 'too-many-requests':
-                return 'Too Many Requests';
-            case 'bad-gateway':
-                return 'Bad Gateway';
-            case 'service-unavailable':
+            case 'rate-limited':
+                return 'Rate Limited';
+            case 'dependency':
+                return 'Dependency Error';
+            case 'unavailable':
                 return 'Service Unavailable';
-            case 'gateway-timeout':
-                return 'Gateway Timeout';
-            case 'vendor':
-                return 'Vendor Error';
-            case 'offline':
-                return 'Offline';
+            case 'dependency-timeout':
+                return 'Dependency Timeout';
+            case 'dependency-backoff':
+                return 'Dependency Unavailable';
+            case 'connection':
+                return 'Connection Error';
             default:
                 return 'Internal Error';
         }
     }
+    static kinds = new Set([
+        'end-user',
+        'bad-request',
+        'unauthorized',
+        'forbidden',
+        'not-found',
+        'endpoint-not-found',
+        'request-timeout',
+        'rate-limited',
+        'implementation',
+        'dependency',
+        'unavailable',
+        'dependency-timeout',
+        'dependency-backoff',
+        'connection',
+    ]);
 }
 exports.ApiErrorCodec = ApiErrorCodec;
 //# sourceMappingURL=ApiErrorCodec.js.map

package/src/errors/ApiErrorCodec.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiErrorCodec.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/errors/ApiErrorCodec.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    ApiError,\n    BadRequestError,\n    UserError,\n    UnauthorizedError,\n    ForbiddenError,\n    NotFoundError,\n    EndpointNotFoundError,\n    RequestTimeoutError,\n    TooManyRequestsError,\n    InternalError,\n    BadGatewayError,\n    ServiceUnavailableError,\n    GatewayTimeoutError,\n    VendorError,\n    OfflineError,\n} from './ApiError';\n\n/** Allowlisted error envelope shared by non-HTTP transports. Contains only bounded semantic causes, never stacks or arbitrary properties. */\nexport class ApiErrorPayload {\n    public cause?: ApiErrorPayload;\n    public subType?: string;\n    public field?: string;\n    public guiAlertMessage?: string;\n    public errorCode?: string;\n    public waitSeconds?: number;\n    constructor(\n        public kind: string,\n        public message: string,\n    ) {}\n}\n\n/** Bounded, safe, transport-neutral encoding. Unrecognized types become generic internal failures. */\nexport class ApiErrorCodec {\n    // webpieces-disable no-function-outside-class -- stateless public codec shared by transport adapters; webpieces-disable no-any-unknown -- thrown values are untrusted until narrowed by the codec\n    static encode(error: unknown): ApiErrorPayload {\n        return this.encodeDepth(error, 0);\n    }\n\n    // webpieces-disable no-function-outside-class -- recursive bounded wire codec; webpieces-disable no-any-unknown -- thrown causes require runtime narrowing\n    private static encodeDepth(error: unknown, depth: number): ApiErrorPayload {\n        const kind = this.kind(error);\n        const payload = new ApiErrorPayload(\n            kind,\n            error instanceof UserError ? error.message.slice(0, 4096) : this.message(kind),\n        );\n        if (error instanceof ApiError) payload.subType = this.text(error.subType);\n        if (error instanceof UserError) payload.errorCode = this.text(error.errorCode);\n        if (error instanceof BadRequestError) {\n            payload.field = this.text(error.field);\n            payload.guiAlertMessage = this.text(error.guiMessage);\n        }\n        if (error instanceof VendorError) payload.waitSeconds = this.wait(error.waitSeconds);\n        if (error instanceof Error && depth < 3) {\n            const cause = Object.getOwnPropertyDescriptor(error, 'cause')?.value;\n            if (cause instanceof Error) payload.cause = this.encodeDepth(cause, depth + 1);\n        }\n        return payload;\n    }\n\n    // webpieces-disable no-function-outside-class -- stateless public codec shared by transport adapters; webpieces-disable no-any-unknown -- JSON transport input must be validated before use\n    static decode(value: unknown): ApiError {\n        return this.decodeDepth(value, 0);\n    }\n\n    // webpieces-disable no-function-outside-class -- recursive bounded wire codec; webpieces-disable no-any-unknown -- remote causes remain untrusted until validated\n    private static decodeDepth(value: unknown, depth: number): ApiError {\n        const error = this.decodeOne(value);\n        if (typeof value === 'object' && value !== null && depth < 3) {\n            const cause = Object.getOwnPropertyDescriptor(value, 'cause')?.value;\n            if (typeof cause === 'object' && cause !== null) {\n                // webpieces-disable no-anonymous-object-literals -- standard property descriptor keeps Error.cause non-enumerable\n                Object.defineProperty(error, 'cause', {\n                    value: this.decodeDepth(cause, depth + 1),\n                    configurable: true,\n                    writable: true,\n                });\n            }\n        }\n        return error;\n    }\n\n    // webpieces-disable no-function-outside-class -- allowlisted wire codec; webpieces-disable no-any-unknown -- JSON transport input must be validated before use\n    private static decodeOne(value: unknown): ApiError {\n        if (typeof value !== 'object' || value === null) return new InternalError('Internal Error');\n        // webpieces-disable no-any-unknown -- own wire fields remain untrusted until narrowed\n        const field = (key: string): unknown => Object.getOwnPropertyDescriptor(value, key)?.value;\n        const kind = field('kind');\n        const message = this.text(field('message')) ?? this.message(kind);\n        switch (kind) {\n            case 'user':\n                return new UserError(message, this.text(field('errorCode')));\n            case 'bad-request':\n                return new BadRequestError(\n                    message,\n                    this.text(field('field')),\n                    this.text(field('guiAlertMessage')),\n                );\n            case 'unauthorized':\n                return new UnauthorizedError(message, this.text(field('subType')));\n            case 'forbidden':\n                return new ForbiddenError(message);\n            case 'not-found':\n                return new NotFoundError(message);\n            case 'endpoint-not-found':\n                return new EndpointNotFoundError(message);\n            case 'request-timeout':\n                return new RequestTimeoutError(message);\n            case 'too-many-requests':\n                return new TooManyRequestsError(message);\n            case 'bad-gateway':\n                return new BadGatewayError(message);\n            case 'service-unavailable':\n                return new ServiceUnavailableError(message);\n            case 'gateway-timeout':\n                return new GatewayTimeoutError(message);\n            case 'vendor':\n                return new VendorError(message, this.wait(field('waitSeconds')));\n            case 'offline':\n                return new OfflineError(message);\n            case 'internal':\n                return new InternalError(message);\n            default:\n                return new InternalError('Internal Error');\n        }\n    }\n\n    // webpieces-disable no-function-outside-class -- helper of stateless codec; webpieces-disable no-any-unknown -- thrown values need instanceof narrowing before encoding\n    private static kind(error: unknown): string {\n        if (error instanceof UserError) return 'user';\n        if (error instanceof BadRequestError) return 'bad-request';\n        if (error instanceof UnauthorizedError) return 'unauthorized';\n        if (error instanceof ForbiddenError) return 'forbidden';\n        if (error instanceof EndpointNotFoundError) return 'endpoint-not-found';\n        if (error instanceof NotFoundError) return 'not-found';\n        if (error instanceof RequestTimeoutError) return 'request-timeout';\n        if (error instanceof TooManyRequestsError) return 'too-many-requests';\n        if (error instanceof BadGatewayError) return 'bad-gateway';\n        if (error instanceof ServiceUnavailableError) return 'service-unavailable';\n        if (error instanceof GatewayTimeoutError) return 'gateway-timeout';\n        if (error instanceof VendorError) return 'vendor';\n        if (error instanceof OfflineError) return 'offline';\n        return 'internal';\n    }\n    // webpieces-disable no-function-outside-class -- helper of stateless codec; webpieces-disable no-any-unknown -- wire fields need runtime string checks\n    private static text(value: unknown): string | undefined {\n        return typeof value === 'string' ? value.slice(0, 4096) : undefined;\n    }\n    // webpieces-disable no-function-outside-class -- helper of stateless codec; webpieces-disable no-any-unknown -- wire fields need runtime finite number checks\n    private static wait(value: unknown): number | undefined {\n        return typeof value === 'number' && Number.isFinite(value) && value >= 0\n            ? Math.min(value, 86400)\n            : undefined;\n    }\n    // webpieces-disable no-function-outside-class -- helper of stateless codec; webpieces-disable no-any-unknown -- wire discriminator must be allowlisted before selection\n    private static message(kind: unknown): string {\n        switch (kind) {\n            case 'user':\n                return 'User Error';\n            case 'bad-request':\n                return 'Bad Request';\n            case 'unauthorized':\n                return 'Unauthorized';\n            case 'forbidden':\n                return 'Forbidden';\n            case 'not-found':\n                return 'Not Found';\n            case 'endpoint-not-found':\n                return 'Endpoint Not Found';\n            case 'request-timeout':\n                return 'Request Timeout';\n            case 'too-many-requests':\n                return 'Too Many Requests';\n            case 'bad-gateway':\n                return 'Bad Gateway';\n            case 'service-unavailable':\n                return 'Service Unavailable';\n            case 'gateway-timeout':\n                return 'Gateway Timeout';\n            case 'vendor':\n                return 'Vendor Error';\n            case 'offline':\n                return 'Offline';\n            default:\n                return 'Internal Error';\n        }\n    }\n}\n"]}
+{"version":3,"file":"ApiErrorCodec.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/errors/ApiErrorCodec.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    ApiBadRequestError,\n    ApiConnectionError,\n    ApiDependencyBackoffError,\n    ApiDependencyError,\n    ApiDependencyTimeoutError,\n    ApiEndpointNotFoundError,\n    ApiEndUserError,\n    ApiError,\n    ApiErrorKind,\n    ApiForbiddenError,\n    ApiImplementationError,\n    ApiNotFoundError,\n    ApiRateLimitedError,\n    ApiRequestTimeoutError,\n    ApiUnauthorizedError,\n    ApiUnavailableError,\n} from './ApiError';\n\n/** Allowlisted transport-neutral envelope. It never contains stacks or arbitrary properties. */\nexport class ApiErrorPayload {\n    public cause?: ApiErrorPayload;\n    public subType?: string;\n    public field?: string;\n    public callerMessage?: string;\n    public errorCode?: string;\n    public retryAfterSeconds?: number;\n\n    constructor(\n        public kind: string = 'implementation',\n        public message: string = 'Internal Error',\n    ) {}\n}\n\n/** Bounded safe codec shared by HTTP, IPC, and other remote adapters. */\nexport class ApiErrorCodec {\n    // webpieces-disable no-function-outside-class -- stateless public transport codec; webpieces-disable no-any-unknown -- thrown values are untrusted until narrowed\n    static encode(error: unknown): ApiErrorPayload {\n        return this.encodeDepth(error, 0);\n    }\n\n    // webpieces-disable no-function-outside-class -- recursive bounded transport codec; webpieces-disable no-any-unknown -- thrown causes require narrowing\n    private static encodeDepth(error: unknown, depth: number): ApiErrorPayload {\n        const kind = error instanceof ApiError ? error.kind : 'implementation';\n        const payload = new ApiErrorPayload(kind, this.publicMessage(error, kind));\n        if (error instanceof ApiError) payload.subType = this.text(error.subType);\n        if (error instanceof ApiEndUserError) payload.errorCode = this.text(error.errorCode);\n        if (error instanceof ApiBadRequestError) {\n            payload.field = this.text(error.field);\n            payload.callerMessage = this.text(error.callerMessage);\n        }\n        if (error instanceof ApiDependencyBackoffError) {\n            payload.retryAfterSeconds = this.wait(error.retryAfterSeconds);\n        }\n        if (error instanceof Error && depth < 3) {\n            const cause = Object.getOwnPropertyDescriptor(error, 'cause')?.value;\n            if (cause instanceof Error) payload.cause = this.encodeDepth(cause, depth + 1);\n        }\n        return payload;\n    }\n\n    /** Decode a value received from another process. Implementation failures are marked remote. */\n    // webpieces-disable no-function-outside-class -- stateless public transport codec; webpieces-disable no-any-unknown -- wire values require validation\n    static decode(value: unknown): ApiError {\n        return this.decodeDepth(value, 0);\n    }\n\n    /** Whether a body carries a recognized Webpieces semantic discriminator. */\n    // webpieces-disable no-function-outside-class -- stateless wire discriminator check; webpieces-disable no-any-unknown -- wire values require validation\n    static isPayload(value: unknown): boolean {\n        if (typeof value !== 'object' || value === null) return false;\n        const kind = Object.getOwnPropertyDescriptor(value, 'kind')?.value;\n        return typeof kind === 'string' && this.kinds.has(kind as ApiErrorKind);\n    }\n\n    // webpieces-disable no-function-outside-class -- recursive bounded transport codec; webpieces-disable no-any-unknown -- remote causes require validation\n    private static decodeDepth(value: unknown, depth: number): ApiError {\n        const error = this.decodeOne(value);\n        if (typeof value === 'object' && value !== null && depth < 3) {\n            const cause = Object.getOwnPropertyDescriptor(value, 'cause')?.value;\n            if (typeof cause === 'object' && cause !== null) {\n                // webpieces-disable no-anonymous-object-literals -- standard descriptor preserves Error.cause semantics\n                Object.defineProperty(error, 'cause', {\n                    value: this.decodeDepth(cause, depth + 1),\n                    configurable: true,\n                    writable: true,\n                });\n            }\n        }\n        return error;\n    }\n\n    // webpieces-disable no-function-outside-class -- allowlisted wire codec; webpieces-disable no-any-unknown -- wire fields require validation\n    private static decodeOne(value: unknown): ApiError {\n        if (typeof value !== 'object' || value === null) return this.remoteImplementationError();\n        // webpieces-disable no-any-unknown -- own wire fields remain untrusted until narrowed\n        const field = (key: string): unknown => Object.getOwnPropertyDescriptor(value, key)?.value;\n        const kind = field('kind');\n        const message = this.text(field('message')) ?? this.message(kind);\n        switch (kind) {\n            case 'end-user':\n                return new ApiEndUserError(message, this.text(field('errorCode')));\n            case 'bad-request':\n                return new ApiBadRequestError(\n                    message,\n                    this.text(field('field')),\n                    this.text(field('callerMessage')),\n                );\n            case 'unauthorized':\n                return new ApiUnauthorizedError(message, this.text(field('subType')));\n            case 'forbidden':\n                return new ApiForbiddenError(message);\n            case 'not-found':\n                return new ApiNotFoundError(message);\n            case 'endpoint-not-found':\n                return new ApiEndpointNotFoundError(message);\n            case 'request-timeout':\n                return new ApiRequestTimeoutError(message);\n            case 'rate-limited':\n                return new ApiRateLimitedError(message);\n            case 'dependency':\n                return new ApiDependencyError(message);\n            case 'unavailable':\n                return new ApiUnavailableError(message);\n            case 'dependency-timeout':\n                return new ApiDependencyTimeoutError(message);\n            case 'dependency-backoff':\n                return new ApiDependencyBackoffError(\n                    message,\n                    this.wait(field('retryAfterSeconds')),\n                );\n            case 'connection':\n                return new ApiConnectionError(message);\n            case 'implementation':\n                return new ApiImplementationError(message, undefined, true);\n            default:\n                return this.remoteImplementationError();\n        }\n    }\n\n    // webpieces-disable no-function-outside-class -- concrete normalization for malformed remote errors\n    private static remoteImplementationError(): ApiImplementationError {\n        return new ApiImplementationError('Internal Error', undefined, true);\n    }\n\n    // webpieces-disable no-function-outside-class -- caller-safe message selection; webpieces-disable no-any-unknown -- thrown values require narrowing\n    private static publicMessage(error: unknown, kind: ApiErrorKind): string {\n        if (error instanceof ApiEndUserError) return error.message.slice(0, 4096);\n        return this.message(kind);\n    }\n\n    // webpieces-disable no-function-outside-class -- wire string bound; webpieces-disable no-any-unknown -- wire values require validation\n    private static text(value: unknown): string | undefined {\n        return typeof value === 'string' ? value.slice(0, 4096) : undefined;\n    }\n\n    // webpieces-disable no-function-outside-class -- wire number bound; webpieces-disable no-any-unknown -- wire values require validation\n    private static wait(value: unknown): number | undefined {\n        return typeof value === 'number' && Number.isFinite(value) && value >= 0\n            ? Math.min(value, 86400)\n            : undefined;\n    }\n\n    // webpieces-disable no-function-outside-class -- allowlisted generic messages; webpieces-disable no-any-unknown -- discriminator is validated by switch\n    private static message(kind: unknown): string {\n        switch (kind) {\n            case 'end-user':\n                return 'End User Error';\n            case 'bad-request':\n                return 'Bad Request';\n            case 'unauthorized':\n                return 'Unauthorized';\n            case 'forbidden':\n                return 'Forbidden';\n            case 'not-found':\n                return 'Not Found';\n            case 'endpoint-not-found':\n                return 'Endpoint Not Found';\n            case 'request-timeout':\n                return 'Request Timeout';\n            case 'rate-limited':\n                return 'Rate Limited';\n            case 'dependency':\n                return 'Dependency Error';\n            case 'unavailable':\n                return 'Service Unavailable';\n            case 'dependency-timeout':\n                return 'Dependency Timeout';\n            case 'dependency-backoff':\n                return 'Dependency Unavailable';\n            case 'connection':\n                return 'Connection Error';\n            default:\n                return 'Internal Error';\n        }\n    }\n\n    private static readonly kinds: ReadonlySet<ApiErrorKind> = new Set<ApiErrorKind>([\n        'end-user',\n        'bad-request',\n        'unauthorized',\n        'forbidden',\n        'not-found',\n        'endpoint-not-found',\n        'request-timeout',\n        'rate-limited',\n        'implementation',\n        'dependency',\n        'unavailable',\n        'dependency-timeout',\n        'dependency-backoff',\n        'connection',\n    ]);\n}\n"]}

package/src/errors/AuthErrorSubtypes.d.ts

@@ -0,0 +1,9 @@
+/** Stable application contract values carried by ApiUnauthorizedError.subType. */
+export declare const ENTITY_NOT_FOUND = "EntityNotFoundError";
+export declare const WRONG_LOGIN_TYPE = "wrongLoginType";
+export declare const WRONG_LOGIN = "wronglogin";
+export declare const NOT_APPROVED = "notapproved";
+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";

package/src/errors/AuthErrorSubtypes.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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 = void 0;
+/** Stable application contract values carried by ApiUnauthorizedError.subType. */
+exports.ENTITY_NOT_FOUND = 'EntityNotFoundError';
+exports.WRONG_LOGIN_TYPE = 'wrongLoginType';
+exports.WRONG_LOGIN = 'wronglogin';
+exports.NOT_APPROVED = 'notapproved';
+exports.EMAIL_NOT_CONFIRMED = 'email_not_confirmed';
+exports.WRONG_DOMAIN = 'wrongdomain';
+exports.WRONG_COMPANY = 'wrongcompany';
+exports.NO_REG_CODE = 'noregcode';
+//# sourceMappingURL=AuthErrorSubtypes.js.map

package/src/errors/AuthErrorSubtypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthErrorSubtypes.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/errors/AuthErrorSubtypes.ts"],"names":[],"mappings":";;;AAAA,kFAAkF;AACrE,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","sourcesContent":["/** Stable application contract values carried by ApiUnauthorizedError.subType. */\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"]}

package/src/errors/index.d.ts

@@ -1,2 +1,4 @@
-export { ApiError, NotFoundError, BadGatewayError, ServiceUnavailableError, GatewayTimeoutError, InternalError, TooManyRequestsError, ForbiddenError, RequestTimeoutError, OfflineError, EndpointNotFoundError, UserError, BadRequestError, UnauthorizedError, VendorError, } from './ApiError';
+export { ApiError, ApiNotFoundError, ApiDependencyError, ApiUnavailableError, ApiDependencyTimeoutError, ApiImplementationError, ApiRateLimitedError, ApiForbiddenError, ApiRequestTimeoutError, ApiConnectionError, ApiEndpointNotFoundError, ApiEndUserError, ApiBadRequestError, ApiUnauthorizedError, ApiDependencyBackoffError, } from './ApiError';
+export type { ApiErrorKind } from './ApiError';
 export { ApiErrorCodec, ApiErrorPayload } from './ApiErrorCodec';
+export { ENTITY_NOT_FOUND, WRONG_LOGIN_TYPE, WRONG_LOGIN, NOT_APPROVED, EMAIL_NOT_CONFIRMED, WRONG_DOMAIN, WRONG_COMPANY, NO_REG_CODE, } from './AuthErrorSubtypes';

package/src/errors/index.js

@@ -1,23 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApiErrorPayload = exports.ApiErrorCodec = exports.VendorError = exports.UnauthorizedError = exports.BadRequestError = exports.UserError = exports.EndpointNotFoundError = exports.OfflineError = exports.RequestTimeoutError = exports.ForbiddenError = exports.TooManyRequestsError = exports.InternalError = exports.GatewayTimeoutError = exports.ServiceUnavailableError = exports.BadGatewayError = exports.NotFoundError = exports.ApiError = void 0;
+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.ApiErrorPayload = exports.ApiErrorCodec = exports.ApiDependencyBackoffError = exports.ApiUnauthorizedError = exports.ApiBadRequestError = exports.ApiEndUserError = exports.ApiEndpointNotFoundError = exports.ApiConnectionError = exports.ApiRequestTimeoutError = exports.ApiForbiddenError = exports.ApiRateLimitedError = exports.ApiImplementationError = exports.ApiDependencyTimeoutError = exports.ApiUnavailableError = exports.ApiDependencyError = exports.ApiNotFoundError = exports.ApiError = void 0;
 var ApiError_1 = require("./ApiError");
 Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return ApiError_1.ApiError; } });
-Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return ApiError_1.NotFoundError; } });
-Object.defineProperty(exports, "BadGatewayError", { enumerable: true, get: function () { return ApiError_1.BadGatewayError; } });
-Object.defineProperty(exports, "ServiceUnavailableError", { enumerable: true, get: function () { return ApiError_1.ServiceUnavailableError; } });
-Object.defineProperty(exports, "GatewayTimeoutError", { enumerable: true, get: function () { return ApiError_1.GatewayTimeoutError; } });
-Object.defineProperty(exports, "InternalError", { enumerable: true, get: function () { return ApiError_1.InternalError; } });
-Object.defineProperty(exports, "TooManyRequestsError", { enumerable: true, get: function () { return ApiError_1.TooManyRequestsError; } });
-Object.defineProperty(exports, "ForbiddenError", { enumerable: true, get: function () { return ApiError_1.ForbiddenError; } });
-Object.defineProperty(exports, "RequestTimeoutError", { enumerable: true, get: function () { return ApiError_1.RequestTimeoutError; } });
-Object.defineProperty(exports, "OfflineError", { enumerable: true, get: function () { return ApiError_1.OfflineError; } });
-Object.defineProperty(exports, "EndpointNotFoundError", { enumerable: true, get: function () { return ApiError_1.EndpointNotFoundError; } });
-Object.defineProperty(exports, "UserError", { enumerable: true, get: function () { return ApiError_1.UserError; } });
-Object.defineProperty(exports, "BadRequestError", { enumerable: true, get: function () { return ApiError_1.BadRequestError; } });
-Object.defineProperty(exports, "UnauthorizedError", { enumerable: true, get: function () { return ApiError_1.UnauthorizedError; } });
-Object.defineProperty(exports, "VendorError", { enumerable: true, get: function () { return ApiError_1.VendorError; } });
+Object.defineProperty(exports, "ApiNotFoundError", { enumerable: true, get: function () { return ApiError_1.ApiNotFoundError; } });
+Object.defineProperty(exports, "ApiDependencyError", { enumerable: true, get: function () { return ApiError_1.ApiDependencyError; } });
+Object.defineProperty(exports, "ApiUnavailableError", { enumerable: true, get: function () { return ApiError_1.ApiUnavailableError; } });
+Object.defineProperty(exports, "ApiDependencyTimeoutError", { enumerable: true, get: function () { return ApiError_1.ApiDependencyTimeoutError; } });
+Object.defineProperty(exports, "ApiImplementationError", { enumerable: true, get: function () { return ApiError_1.ApiImplementationError; } });
+Object.defineProperty(exports, "ApiRateLimitedError", { enumerable: true, get: function () { return ApiError_1.ApiRateLimitedError; } });
+Object.defineProperty(exports, "ApiForbiddenError", { enumerable: true, get: function () { return ApiError_1.ApiForbiddenError; } });
+Object.defineProperty(exports, "ApiRequestTimeoutError", { enumerable: true, get: function () { return ApiError_1.ApiRequestTimeoutError; } });
+Object.defineProperty(exports, "ApiConnectionError", { enumerable: true, get: function () { return ApiError_1.ApiConnectionError; } });
+Object.defineProperty(exports, "ApiEndpointNotFoundError", { enumerable: true, get: function () { return ApiError_1.ApiEndpointNotFoundError; } });
+Object.defineProperty(exports, "ApiEndUserError", { enumerable: true, get: function () { return ApiError_1.ApiEndUserError; } });
+Object.defineProperty(exports, "ApiBadRequestError", { enumerable: true, get: function () { return ApiError_1.ApiBadRequestError; } });
+Object.defineProperty(exports, "ApiUnauthorizedError", { enumerable: true, get: function () { return ApiError_1.ApiUnauthorizedError; } });
+Object.defineProperty(exports, "ApiDependencyBackoffError", { enumerable: true, get: function () { return ApiError_1.ApiDependencyBackoffError; } });
 var ApiErrorCodec_1 = require("./ApiErrorCodec");
 Object.defineProperty(exports, "ApiErrorCodec", { enumerable: true, get: function () { return ApiErrorCodec_1.ApiErrorCodec; } });
 Object.defineProperty(exports, "ApiErrorPayload", { enumerable: true, get: function () { return ApiErrorCodec_1.ApiErrorPayload; } });
+var AuthErrorSubtypes_1 = require("./AuthErrorSubtypes");
+Object.defineProperty(exports, "ENTITY_NOT_FOUND", { enumerable: true, get: function () { return AuthErrorSubtypes_1.ENTITY_NOT_FOUND; } });
+Object.defineProperty(exports, "WRONG_LOGIN_TYPE", { enumerable: true, get: function () { return AuthErrorSubtypes_1.WRONG_LOGIN_TYPE; } });
+Object.defineProperty(exports, "WRONG_LOGIN", { enumerable: true, get: function () { return AuthErrorSubtypes_1.WRONG_LOGIN; } });
+Object.defineProperty(exports, "NOT_APPROVED", { enumerable: true, get: function () { return AuthErrorSubtypes_1.NOT_APPROVED; } });
+Object.defineProperty(exports, "EMAIL_NOT_CONFIRMED", { enumerable: true, get: function () { return AuthErrorSubtypes_1.EMAIL_NOT_CONFIRMED; } });
+Object.defineProperty(exports, "WRONG_DOMAIN", { enumerable: true, get: function () { return AuthErrorSubtypes_1.WRONG_DOMAIN; } });
+Object.defineProperty(exports, "WRONG_COMPANY", { enumerable: true, get: function () { return AuthErrorSubtypes_1.WRONG_COMPANY; } });
+Object.defineProperty(exports, "NO_REG_CODE", { enumerable: true, get: function () { return AuthErrorSubtypes_1.NO_REG_CODE; } });
 //# sourceMappingURL=index.js.map

package/src/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/errors/index.ts"],"names":[],"mappings":";;;AAAA,uCAgBoB;AAfhB,oGAAA,QAAQ,OAAA;AACR,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,mHAAA,uBAAuB,OAAA;AACvB,+GAAA,mBAAmB,OAAA;AACnB,yGAAA,aAAa,OAAA;AACb,gHAAA,oBAAoB,OAAA;AACpB,0GAAA,cAAc,OAAA;AACd,+GAAA,mBAAmB,OAAA;AACnB,wGAAA,YAAY,OAAA;AACZ,iHAAA,qBAAqB,OAAA;AACrB,qGAAA,SAAS,OAAA;AACT,2GAAA,eAAe,OAAA;AACf,6GAAA,iBAAiB,OAAA;AACjB,uGAAA,WAAW,OAAA;AAEf,iDAAiE;AAAxD,8GAAA,aAAa,OAAA;AAAE,gHAAA,eAAe,OAAA","sourcesContent":["export {\n    ApiError,\n    NotFoundError,\n    BadGatewayError,\n    ServiceUnavailableError,\n    GatewayTimeoutError,\n    InternalError,\n    TooManyRequestsError,\n    ForbiddenError,\n    RequestTimeoutError,\n    OfflineError,\n    EndpointNotFoundError,\n    UserError,\n    BadRequestError,\n    UnauthorizedError,\n    VendorError,\n} from './ApiError';\nexport { ApiErrorCodec, ApiErrorPayload } from './ApiErrorCodec';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/errors/index.ts"],"names":[],"mappings":";;;AAAA,uCAgBoB;AAfhB,oGAAA,QAAQ,OAAA;AACR,4GAAA,gBAAgB,OAAA;AAChB,8GAAA,kBAAkB,OAAA;AAClB,+GAAA,mBAAmB,OAAA;AACnB,qHAAA,yBAAyB,OAAA;AACzB,kHAAA,sBAAsB,OAAA;AACtB,+GAAA,mBAAmB,OAAA;AACnB,6GAAA,iBAAiB,OAAA;AACjB,kHAAA,sBAAsB,OAAA;AACtB,8GAAA,kBAAkB,OAAA;AAClB,oHAAA,wBAAwB,OAAA;AACxB,2GAAA,eAAe,OAAA;AACf,8GAAA,kBAAkB,OAAA;AAClB,gHAAA,oBAAoB,OAAA;AACpB,qHAAA,yBAAyB,OAAA;AAG7B,iDAAiE;AAAxD,8GAAA,aAAa,OAAA;AAAE,gHAAA,eAAe,OAAA;AACvC,yDAS6B;AARzB,qHAAA,gBAAgB,OAAA;AAChB,qHAAA,gBAAgB,OAAA;AAChB,gHAAA,WAAW,OAAA;AACX,iHAAA,YAAY,OAAA;AACZ,wHAAA,mBAAmB,OAAA;AACnB,iHAAA,YAAY,OAAA;AACZ,kHAAA,aAAa,OAAA;AACb,gHAAA,WAAW,OAAA","sourcesContent":["export {\n    ApiError,\n    ApiNotFoundError,\n    ApiDependencyError,\n    ApiUnavailableError,\n    ApiDependencyTimeoutError,\n    ApiImplementationError,\n    ApiRateLimitedError,\n    ApiForbiddenError,\n    ApiRequestTimeoutError,\n    ApiConnectionError,\n    ApiEndpointNotFoundError,\n    ApiEndUserError,\n    ApiBadRequestError,\n    ApiUnauthorizedError,\n    ApiDependencyBackoffError,\n} from './ApiError';\nexport type { ApiErrorKind } from './ApiError';\nexport { ApiErrorCodec, ApiErrorPayload } from './ApiErrorCodec';\nexport {\n    ENTITY_NOT_FOUND,\n    WRONG_LOGIN_TYPE,\n    WRONG_LOGIN,\n    NOT_APPROVED,\n    EMAIL_NOT_CONFIRMED,\n    WRONG_DOMAIN,\n    WRONG_COMPANY,\n    NO_REG_CODE,\n} from './AuthErrorSubtypes';\n"]}

package/src/http/{TimeoutError.d.ts → ApiCallTimeoutError.d.ts}

@@ -1,6 +1,6 @@
 import { CallContext } from './CallStrategy';
 /** Stopped waiting; this does not prove the remote operation did not run. */
-export declare class TimeoutError extends Error {
+export declare class ApiCallTimeoutError extends Error {
     readonly timeoutMs: number;
     readonly context: CallContext;
     constructor(timeoutMs: number, context: CallContext);

package/src/http/{TimeoutError.js → ApiCallTimeoutError.js}

@@ -1,16 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeoutError = void 0;
+exports.ApiCallTimeoutError = void 0;
 /** Stopped waiting; this does not prove the remote operation did not run. */
-class TimeoutError extends Error {
+class ApiCallTimeoutError extends Error {
     timeoutMs;
     context;
     constructor(timeoutMs, context) {
         super(`${context.apiName}.${context.methodName} timed out after ${timeoutMs}ms`);
         this.timeoutMs = timeoutMs;
         this.context = context;
-        this.name = 'TimeoutError';
+        this.name = 'ApiCallTimeoutError';
     }
 }
-exports.TimeoutError = TimeoutError;
-//# sourceMappingURL=TimeoutError.js.map
+exports.ApiCallTimeoutError = ApiCallTimeoutError;
+//# sourceMappingURL=ApiCallTimeoutError.js.map

package/src/http/ApiCallTimeoutError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiCallTimeoutError.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/http/ApiCallTimeoutError.ts"],"names":[],"mappings":";;;AAEA,6EAA6E;AAC7E,MAAa,mBAAoB,SAAQ,KAAK;IAEtB;IACA;IAFpB,YACoB,SAAiB,EACjB,OAAoB;QAEpC,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,oBAAoB,SAAS,IAAI,CAAC,CAAC;QAHjE,cAAS,GAAT,SAAS,CAAQ;QACjB,YAAO,GAAP,OAAO,CAAa;QAGpC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AARD,kDAQC","sourcesContent":["import { CallContext } from './CallStrategy';\n\n/** Stopped waiting; this does not prove the remote operation did not run. */\nexport class ApiCallTimeoutError extends Error {\n    constructor(\n        public readonly timeoutMs: number,\n        public readonly context: CallContext,\n    ) {\n        super(`${context.apiName}.${context.methodName} timed out after ${timeoutMs}ms`);\n        this.name = 'ApiCallTimeoutError';\n    }\n}\n"]}

package/src/http/{HttpErrorStatus.d.ts → ApiErrorHttpStatus.d.ts}

@@ -1,5 +1,6 @@
 import { ApiError } from '../errors/ApiError';
 /** HTTP-only adapter: semantic errors themselves have no protocol status property. */
-export declare class HttpErrorStatus {
+export declare class ApiErrorHttpStatus {
+    static hasCode(error: ApiError): boolean;
     static code(error: ApiError): number;
 }

package/src/http/ApiErrorHttpStatus.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiErrorHttpStatus = void 0;
+/** HTTP-only adapter: semantic errors themselves have no protocol status property. */
+class ApiErrorHttpStatus {
+    // webpieces-disable no-function-outside-class -- stateless mapping predicate
+    static hasCode(error) {
+        return error.kind !== 'connection';
+    }
+    // webpieces-disable no-function-outside-class -- stateless mapping shared by HTTP adapters
+    static code(error) {
+        switch (error.kind) {
+            case 'end-user':
+                return 266;
+            case 'bad-request':
+                return 400;
+            case 'unauthorized':
+                return 401;
+            case 'forbidden':
+                return 403;
+            case 'not-found':
+            case 'endpoint-not-found':
+                return 404;
+            case 'request-timeout':
+                return 408;
+            case 'rate-limited':
+                return 429;
+            case 'implementation':
+                return 500;
+            case 'dependency':
+                return 502;
+            case 'unavailable':
+            case 'dependency-backoff':
+                return 503;
+            case 'dependency-timeout':
+                return 504;
+            case 'connection':
+                throw new Error('ApiConnectionError has no HTTP status; normalize it at the server boundary');
+        }
+    }
+}
+exports.ApiErrorHttpStatus = ApiErrorHttpStatus;
+//# sourceMappingURL=ApiErrorHttpStatus.js.map

package/src/http/ApiErrorHttpStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiErrorHttpStatus.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/http/ApiErrorHttpStatus.ts"],"names":[],"mappings":";;;AAEA,sFAAsF;AACtF,MAAa,kBAAkB;IAC3B,6EAA6E;IAC7E,MAAM,CAAC,OAAO,CAAC,KAAe;QAC1B,OAAO,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;IACvC,CAAC;IAED,2FAA2F;IAC3F,MAAM,CAAC,IAAI,CAAC,KAAe;QACvB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,UAAU;gBACX,OAAO,GAAG,CAAC;YACf,KAAK,aAAa;gBACd,OAAO,GAAG,CAAC;YACf,KAAK,cAAc;gBACf,OAAO,GAAG,CAAC;YACf,KAAK,WAAW;gBACZ,OAAO,GAAG,CAAC;YACf,KAAK,WAAW,CAAC;YACjB,KAAK,oBAAoB;gBACrB,OAAO,GAAG,CAAC;YACf,KAAK,iBAAiB;gBAClB,OAAO,GAAG,CAAC;YACf,KAAK,cAAc;gBACf,OAAO,GAAG,CAAC;YACf,KAAK,gBAAgB;gBACjB,OAAO,GAAG,CAAC;YACf,KAAK,YAAY;gBACb,OAAO,GAAG,CAAC;YACf,KAAK,aAAa,CAAC;YACnB,KAAK,oBAAoB;gBACrB,OAAO,GAAG,CAAC;YACf,KAAK,oBAAoB;gBACrB,OAAO,GAAG,CAAC;YACf,KAAK,YAAY;gBACb,MAAM,IAAI,KAAK,CACX,4EAA4E,CAC/E,CAAC;QACV,CAAC;IACL,CAAC;CACJ;AAvCD,gDAuCC","sourcesContent":["import { ApiError } from '../errors/ApiError';\n\n/** HTTP-only adapter: semantic errors themselves have no protocol status property. */\nexport class ApiErrorHttpStatus {\n    // webpieces-disable no-function-outside-class -- stateless mapping predicate\n    static hasCode(error: ApiError): boolean {\n        return error.kind !== 'connection';\n    }\n\n    // webpieces-disable no-function-outside-class -- stateless mapping shared by HTTP adapters\n    static code(error: ApiError): number {\n        switch (error.kind) {\n            case 'end-user':\n                return 266;\n            case 'bad-request':\n                return 400;\n            case 'unauthorized':\n                return 401;\n            case 'forbidden':\n                return 403;\n            case 'not-found':\n            case 'endpoint-not-found':\n                return 404;\n            case 'request-timeout':\n                return 408;\n            case 'rate-limited':\n                return 429;\n            case 'implementation':\n                return 500;\n            case 'dependency':\n                return 502;\n            case 'unavailable':\n            case 'dependency-backoff':\n                return 503;\n            case 'dependency-timeout':\n                return 504;\n            case 'connection':\n                throw new Error(\n                    'ApiConnectionError has no HTTP status; normalize it at the server boundary',\n                );\n        }\n    }\n}\n"]}

package/src/http/CallDeadline.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CallDeadline = void 0;
-const TimeoutError_1 = require("./TimeoutError");
+const ApiCallTimeoutError_1 = require("./ApiCallTimeoutError");
 /** Transport deadline. The race bounds even transports that ignore cancellation. */
 class CallDeadline {
     /**
@@ -22,7 +22,7 @@ class CallDeadline {
         let timer;
         const expired = new Promise((_resolve, reject) => {
             timer = setTimeout(() => {
-                const error = new TimeoutError_1.TimeoutError(timeoutMs, context);
+                const error = new ApiCallTimeoutError_1.ApiCallTimeoutError(timeoutMs, context);
                 CallDeadline.failures.set(controller.signal, error);
                 reject(error);
                 controller.abort(error);

package/src/http/CallDeadline.js.map

@@ -1 +1 @@
-{"version":3,"file":"CallDeadline.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/http/CallDeadline.ts"],"names":[],"mappings":";;;AACA,iDAA8C;AAE9C,oFAAoF;AACpF,MAAa,YAAY;IACrB;;;OAGG;IACK,MAAM,CAAU,QAAQ,GAAG,IAAI,OAAO,EAAsB,CAAC;IAErE,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,SAAiB;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,GAAG,aAAa,EAAE,CAAC;YAC7E,MAAM,IAAI,UAAU,CAAC,4DAA4D,CAAC,CAAC;QACvF,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,KAAK,CAAC,GAAG,CACZ,SAAiB,EACjB,OAAoB,EACpB,IAAyC;QAEzC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,KAAgD,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CACvB,CAAC,QAAgC,EAAE,MAA8B,EAAE,EAAE;YACjE,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACpB,MAAM,KAAK,GAAG,IAAI,2BAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACnD,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACpD,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC,EAAE,SAAS,CAAC,CAAC;QAClB,CAAC,CACJ,CAAC;QACF,qFAAqF;QACrF,8DAA8D;QAC9D,IAAI,CAAC;YACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;gBACtB,OAAO;gBACP,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;aACxD,CAAC,CAAC;QACP,CAAC;gBAAS,CAAC;YACP,YAAY,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IAED,2FAA2F;IAC3F,2EAA2E;IAC3E,MAAM,CAAC,cAAc,CAAC,MAAmB;QACrC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAC5B,MAAM,CACF,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;YACjC,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAClE,CAAC;IACN,CAAC;;AArDL,oCAsDC","sourcesContent":["import { CallContext } from './CallStrategy';\nimport { TimeoutError } from './TimeoutError';\n\n/** Transport deadline. The race bounds even transports that ignore cancellation. */\nexport class CallDeadline {\n    /**\n     * AbortController.abort(reason) is not portable: React Native's abort-controller 3 signal has\n     * neither `reason` nor `throwIfAborted`. Keep the typed failure beside the signal instead.\n     */\n    private static readonly failures = new WeakMap<AbortSignal, Error>();\n\n    // webpieces-disable no-function-outside-class -- stateless transport helper\n    static validate(timeoutMs: number): void {\n        if (!Number.isFinite(timeoutMs) || timeoutMs <= 0 || timeoutMs > 2_147_483_647) {\n            throw new RangeError('timeoutMs must be positive, finite, and at most 2147483647');\n        }\n    }\n\n    // webpieces-disable no-function-outside-class -- stateless transport helper\n    static async run<T>(\n        timeoutMs: number,\n        context: CallContext,\n        work: (signal: AbortSignal) => Promise<T>,\n    ): Promise<T> {\n        CallDeadline.validate(timeoutMs);\n        const controller = new AbortController();\n        let timer: ReturnType<typeof setTimeout> | undefined;\n        const expired = new Promise<never>(\n            (_resolve: (value: never) => void, reject: (error: Error) => void) => {\n                timer = setTimeout(() => {\n                    const error = new TimeoutError(timeoutMs, context);\n                    CallDeadline.failures.set(controller.signal, error);\n                    reject(error);\n                    controller.abort(error);\n                }, timeoutMs);\n            },\n        );\n        // webpieces-disable no-unmanaged-exceptions -- release the timer on every settlement\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            return await Promise.race([\n                expired,\n                Promise.resolve().then(() => work(controller.signal)),\n            ]);\n        } finally {\n            clearTimeout(timer);\n        }\n    }\n\n    /** Throw the exact deadline failure without relying on optional AbortSignal extensions. */\n    // webpieces-disable no-function-outside-class -- portable transport helper\n    static throwIfAborted(signal: AbortSignal): void {\n        if (!signal.aborted) return;\n        throw (\n            CallDeadline.failures.get(signal) ??\n            new Error('The operation was aborted before it could complete')\n        );\n    }\n}\n"]}
+{"version":3,"file":"CallDeadline.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/http/CallDeadline.ts"],"names":[],"mappings":";;;AACA,+DAA4D;AAE5D,oFAAoF;AACpF,MAAa,YAAY;IACrB;;;OAGG;IACK,MAAM,CAAU,QAAQ,GAAG,IAAI,OAAO,EAAsB,CAAC;IAErE,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,SAAiB;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,GAAG,aAAa,EAAE,CAAC;YAC7E,MAAM,IAAI,UAAU,CAAC,4DAA4D,CAAC,CAAC;QACvF,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,KAAK,CAAC,GAAG,CACZ,SAAiB,EACjB,OAAoB,EACpB,IAAyC;QAEzC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,KAAgD,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CACvB,CAAC,QAAgC,EAAE,MAA8B,EAAE,EAAE;YACjE,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACpB,MAAM,KAAK,GAAG,IAAI,yCAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBAC1D,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACpD,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC,EAAE,SAAS,CAAC,CAAC;QAClB,CAAC,CACJ,CAAC;QACF,qFAAqF;QACrF,8DAA8D;QAC9D,IAAI,CAAC;YACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;gBACtB,OAAO;gBACP,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;aACxD,CAAC,CAAC;QACP,CAAC;gBAAS,CAAC;YACP,YAAY,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IAED,2FAA2F;IAC3F,2EAA2E;IAC3E,MAAM,CAAC,cAAc,CAAC,MAAmB;QACrC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAC5B,MAAM,CACF,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;YACjC,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAClE,CAAC;IACN,CAAC;;AArDL,oCAsDC","sourcesContent":["import { CallContext } from './CallStrategy';\nimport { ApiCallTimeoutError } from './ApiCallTimeoutError';\n\n/** Transport deadline. The race bounds even transports that ignore cancellation. */\nexport class CallDeadline {\n    /**\n     * AbortController.abort(reason) is not portable: React Native's abort-controller 3 signal has\n     * neither `reason` nor `throwIfAborted`. Keep the typed failure beside the signal instead.\n     */\n    private static readonly failures = new WeakMap<AbortSignal, Error>();\n\n    // webpieces-disable no-function-outside-class -- stateless transport helper\n    static validate(timeoutMs: number): void {\n        if (!Number.isFinite(timeoutMs) || timeoutMs <= 0 || timeoutMs > 2_147_483_647) {\n            throw new RangeError('timeoutMs must be positive, finite, and at most 2147483647');\n        }\n    }\n\n    // webpieces-disable no-function-outside-class -- stateless transport helper\n    static async run<T>(\n        timeoutMs: number,\n        context: CallContext,\n        work: (signal: AbortSignal) => Promise<T>,\n    ): Promise<T> {\n        CallDeadline.validate(timeoutMs);\n        const controller = new AbortController();\n        let timer: ReturnType<typeof setTimeout> | undefined;\n        const expired = new Promise<never>(\n            (_resolve: (value: never) => void, reject: (error: Error) => void) => {\n                timer = setTimeout(() => {\n                    const error = new ApiCallTimeoutError(timeoutMs, context);\n                    CallDeadline.failures.set(controller.signal, error);\n                    reject(error);\n                    controller.abort(error);\n                }, timeoutMs);\n            },\n        );\n        // webpieces-disable no-unmanaged-exceptions -- release the timer on every settlement\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            return await Promise.race([\n                expired,\n                Promise.resolve().then(() => work(controller.signal)),\n            ]);\n        } finally {\n            clearTimeout(timer);\n        }\n    }\n\n    /** Throw the exact deadline failure without relying on optional AbortSignal extensions. */\n    // webpieces-disable no-function-outside-class -- portable transport helper\n    static throwIfAborted(signal: AbortSignal): void {\n        if (!signal.aborted) return;\n        throw (\n            CallDeadline.failures.get(signal) ??\n            new Error('The operation was aborted before it could complete')\n        );\n    }\n}\n"]}