@webpieces/core-util 0.4.750 → 0.4.751

package/README.md

@@ -2,6 +2,12 @@
 
 Utility functions for WebPieces applications. Works in both browser and Node.js environments.
 
+## Portable API errors and IPC
+
+React Native consumers use `@webpieces/core-util/errors` for canonical semantic errors (`UserError`, `NotFoundError`, and the other API categories) and `@webpieces/core-util/ipc` for shared contracts and connection types. These two subpaths are checked with public declaration fixtures, Metro Android/iOS bundles, and Hermes compilation; the broad root barrel is not certified for React Native.
+
+Use `@webpieces/ipc-client` and `@webpieces/ipc-server` for generated clients and typed receivers. HTTP preserves status 266 for `UserError`: monitoring succeeds, while generated clients throw it for GUI display. Old Http-prefixed names are deprecated aliases; neutral errors use standard `cause` and have no HTTP `.code`. See [the migration and verification guide](https://github.com/deanhiller/webpieces-ts/blob/main/docs/portable-ipc-and-errors.md).
+
 ## Installation
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/core-util",
-  "version": "0.4.750",
+  "version": "0.4.751",
   "description": "Utility functions for WebPieces - works in browser and Node.js",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -9,6 +9,14 @@
     ".": {
       "types": "./src/index.d.ts",
       "default": "./src/index.js"
+    },
+    "./errors": {
+      "types": "./src/errors/index.d.ts",
+      "default": "./src/errors/index.js"
+    },
+    "./ipc": {
+      "types": "./src/ipc/index.d.ts",
+      "default": "./src/ipc/index.js"
     }
   },
   "keywords": [

package/src/errors/ApiError.d.ts

@@ -0,0 +1,70 @@
+/** Portable semantic failures. HTTP status mapping belongs to the HTTP adapter. */
+export declare class ApiError extends Error {
+    readonly kind: string;
+    subType?: string;
+    constructor(message: string, cause?: Error);
+}
+/** NotFound failure, independent of transport. */
+export declare class NotFoundError extends ApiError {
+    readonly kind: string;
+}
+/** BadGateway failure, independent of transport. */
+export declare class BadGatewayError extends ApiError {
+    readonly kind: string;
+}
+/** ServiceUnavailable failure, independent of transport. */
+export declare class ServiceUnavailableError extends ApiError {
+    readonly kind: string;
+}
+/** GatewayTimeout failure, independent of transport. */
+export declare class GatewayTimeoutError extends ApiError {
+    readonly kind: string;
+}
+/** Internal failure, independent of transport. */
+export declare class InternalError extends ApiError {
+    readonly kind: string;
+}
+/** TooManyRequests failure, independent of transport. */
+export declare class TooManyRequestsError extends ApiError {
+    readonly kind: string;
+}
+/** Forbidden failure, independent of transport. */
+export declare class ForbiddenError extends ApiError {
+    readonly kind: string;
+}
+/** RequestTimeout failure, independent of transport. */
+export declare class RequestTimeoutError extends ApiError {
+    readonly kind: string;
+}
+/** Offline failure, independent of transport. */
+export declare class OfflineError extends ApiError {
+    readonly kind: string;
+}
+/** The API endpoint is missing, distinct from an absent domain entity. */
+export declare class EndpointNotFoundError extends NotFoundError {
+    readonly kind: string;
+}
+/** Expected user mistake: successful protocol/monitoring outcome; GUI catches this error. */
+export declare class UserError extends ApiError {
+    errorCode?: string | undefined;
+    readonly kind: string;
+    constructor(message: string, errorCode?: string | undefined, cause?: Error);
+}
+/** Invalid caller input with optional human-safe field feedback. */
+export declare class BadRequestError extends ApiError {
+    field?: string | undefined;
+    guiMessage?: string | undefined;
+    readonly kind: string;
+    constructor(message: string, field?: string | undefined, guiMessage?: string | undefined, cause?: Error);
+}
+/** Authentication failure with a contract-defined reason. */
+export declare class UnauthorizedError extends ApiError {
+    readonly kind: string;
+    constructor(message: string, subType?: string, cause?: Error);
+}
+/** Dependency failure with bounded retry advice. */
+export declare class VendorError extends ApiError {
+    waitSeconds: number;
+    readonly kind: string;
+    constructor(message: string, waitSeconds?: number, cause?: Error);
+}

package/src/errors/ApiError.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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;
+/** Portable semantic failures. HTTP status mapping belongs to the HTTP adapter. */
+class ApiError extends Error {
+    kind = 'internal';
+    subType;
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = new.target.name;
+    }
+}
+exports.ApiError = ApiError;
+/** NotFound failure, independent of transport. */
+class NotFoundError extends ApiError {
+    kind = 'not-found';
+}
+exports.NotFoundError = NotFoundError;
+/** BadGateway failure, independent of transport. */
+class BadGatewayError extends ApiError {
+    kind = 'bad-gateway';
+}
+exports.BadGatewayError = BadGatewayError;
+/** ServiceUnavailable failure, independent of transport. */
+class ServiceUnavailableError extends ApiError {
+    kind = 'service-unavailable';
+}
+exports.ServiceUnavailableError = ServiceUnavailableError;
+/** GatewayTimeout failure, independent of transport. */
+class GatewayTimeoutError extends ApiError {
+    kind = 'gateway-timeout';
+}
+exports.GatewayTimeoutError = GatewayTimeoutError;
+/** Internal failure, independent of transport. */
+class InternalError extends ApiError {
+    kind = 'internal';
+}
+exports.InternalError = InternalError;
+/** TooManyRequests failure, independent of transport. */
+class TooManyRequestsError extends ApiError {
+    kind = 'too-many-requests';
+}
+exports.TooManyRequestsError = TooManyRequestsError;
+/** Forbidden failure, independent of transport. */
+class ForbiddenError extends ApiError {
+    kind = 'forbidden';
+}
+exports.ForbiddenError = ForbiddenError;
+/** RequestTimeout failure, independent of transport. */
+class RequestTimeoutError extends ApiError {
+    kind = 'request-timeout';
+}
+exports.RequestTimeoutError = RequestTimeoutError;
+/** Offline failure, independent of transport. */
+class OfflineError extends ApiError {
+    kind = 'offline';
+}
+exports.OfflineError = OfflineError;
+/** The API endpoint is missing, distinct from an absent domain entity. */
+class EndpointNotFoundError extends NotFoundError {
+    kind = 'endpoint-not-found';
+}
+exports.EndpointNotFoundError = EndpointNotFoundError;
+/** Expected user mistake: successful protocol/monitoring outcome; GUI catches this error. */
+class UserError extends ApiError {
+    errorCode;
+    kind = 'user';
+    constructor(message, errorCode, cause) {
+        super(message, cause);
+        this.errorCode = errorCode;
+        this.subType = 'USER_ERROR';
+    }
+}
+exports.UserError = UserError;
+/** Invalid caller input with optional human-safe field feedback. */
+class BadRequestError extends ApiError {
+    field;
+    guiMessage;
+    kind = 'bad-request';
+    constructor(message, field, guiMessage, cause) {
+        super(message, cause);
+        this.field = field;
+        this.guiMessage = guiMessage;
+    }
+}
+exports.BadRequestError = BadRequestError;
+/** Authentication failure with a contract-defined reason. */
+class UnauthorizedError extends ApiError {
+    kind = 'unauthorized';
+    constructor(message, subType, cause) {
+        super(message, cause);
+        this.subType = subType;
+    }
+}
+exports.UnauthorizedError = UnauthorizedError;
+/** Dependency failure with bounded retry advice. */
+class VendorError extends ApiError {
+    waitSeconds;
+    kind = 'vendor';
+    constructor(message, waitSeconds = 30, cause) {
+        super(message, cause);
+        this.waitSeconds = waitSeconds;
+    }
+}
+exports.VendorError = VendorError;
+//# sourceMappingURL=ApiError.js.map

package/src/errors/ApiError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiError.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/errors/ApiError.ts"],"names":[],"mappings":";;;AAAA,mFAAmF;AACnF,MAAa,QAAS,SAAQ,KAAK;IACtB,IAAI,GAAW,UAAU,CAAC;IAC5B,OAAO,CAAU;IACxB,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAChC,CAAC;CACJ;AAPD,4BAOC;AAED,kDAAkD;AAClD,MAAa,aAAc,SAAQ,QAAQ;IAAqB,IAAI,GAAW,WAAW,CAAC;CAAE;AAA7F,sCAA6F;AAE7F,oDAAoD;AACpD,MAAa,eAAgB,SAAQ,QAAQ;IAAqB,IAAI,GAAW,aAAa,CAAC;CAAE;AAAjG,0CAAiG;AAEjG,4DAA4D;AAC5D,MAAa,uBAAwB,SAAQ,QAAQ;IAAqB,IAAI,GAAW,qBAAqB,CAAC;CAAE;AAAjH,0DAAiH;AAEjH,wDAAwD;AACxD,MAAa,mBAAoB,SAAQ,QAAQ;IAAqB,IAAI,GAAW,iBAAiB,CAAC;CAAE;AAAzG,kDAAyG;AAEzG,kDAAkD;AAClD,MAAa,aAAc,SAAQ,QAAQ;IAAqB,IAAI,GAAW,UAAU,CAAC;CAAE;AAA5F,sCAA4F;AAE5F,yDAAyD;AACzD,MAAa,oBAAqB,SAAQ,QAAQ;IAAqB,IAAI,GAAW,mBAAmB,CAAC;CAAE;AAA5G,oDAA4G;AAE5G,mDAAmD;AACnD,MAAa,cAAe,SAAQ,QAAQ;IAAqB,IAAI,GAAW,WAAW,CAAC;CAAE;AAA9F,wCAA8F;AAE9F,wDAAwD;AACxD,MAAa,mBAAoB,SAAQ,QAAQ;IAAqB,IAAI,GAAW,iBAAiB,CAAC;CAAE;AAAzG,kDAAyG;AAEzG,iDAAiD;AACjD,MAAa,YAAa,SAAQ,QAAQ;IAAqB,IAAI,GAAW,SAAS,CAAC;CAAE;AAA1F,oCAA0F;AAE1F,0EAA0E;AAC1E,MAAa,qBAAsB,SAAQ,aAAa;IAAqB,IAAI,GAAW,oBAAoB,CAAC;CAAE;AAAnH,sDAAmH;AACnH,6FAA6F;AAC7F,MAAa,SAAU,SAAQ,QAAQ;IAEC;IADlB,IAAI,GAAW,MAAM,CAAC;IACxC,YAAY,OAAe,EAAS,SAAkB,EAAE,KAAa;QACjE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QADU,cAAS,GAAT,SAAS,CAAS;QAElD,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC;IAChC,CAAC;CACJ;AAND,8BAMC;AACD,oEAAoE;AACpE,MAAa,eAAgB,SAAQ,QAAQ;IAEL;IAAuB;IADzC,IAAI,GAAW,aAAa,CAAC;IAC/C,YAAY,OAAe,EAAS,KAAc,EAAS,UAAmB,EAAE,KAAa;QACzF,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QADU,UAAK,GAAL,KAAK,CAAS;QAAS,eAAU,GAAV,UAAU,CAAS;IAE9E,CAAC;CACJ;AALD,0CAKC;AACD,6DAA6D;AAC7D,MAAa,iBAAkB,SAAQ,QAAQ;IACzB,IAAI,GAAW,cAAc,CAAC;IAChD,YAAY,OAAe,EAAE,OAAgB,EAAE,KAAa;QACxD,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;CACJ;AAND,8CAMC;AACD,oDAAoD;AACpD,MAAa,WAAY,SAAQ,QAAQ;IAED;IADlB,IAAI,GAAW,QAAQ,CAAC;IAC1C,YAAY,OAAe,EAAS,cAAc,EAAE,EAAE,KAAa;QAC/D,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QADU,gBAAW,GAAX,WAAW,CAAK;IAEpD,CAAC;CACJ;AALD,kCAKC","sourcesContent":["/** Portable semantic failures. HTTP status mapping belongs to the HTTP adapter. */\nexport class ApiError extends Error {\n    readonly kind: string = 'internal';\n    public subType?: string;\n    constructor(message: string, cause?: Error) {\n        super(message, { cause });\n        this.name = new.target.name;\n    }\n}\n\n/** NotFound failure, independent of transport. */\nexport class NotFoundError extends ApiError { override readonly kind: string = 'not-found'; }\n\n/** BadGateway failure, independent of transport. */\nexport class BadGatewayError extends ApiError { override readonly kind: string = 'bad-gateway'; }\n\n/** ServiceUnavailable failure, independent of transport. */\nexport class ServiceUnavailableError extends ApiError { override readonly kind: string = 'service-unavailable'; }\n\n/** GatewayTimeout failure, independent of transport. */\nexport class GatewayTimeoutError extends ApiError { override readonly kind: string = 'gateway-timeout'; }\n\n/** Internal failure, independent of transport. */\nexport class InternalError extends ApiError { override readonly kind: string = 'internal'; }\n\n/** TooManyRequests failure, independent of transport. */\nexport class TooManyRequestsError extends ApiError { override readonly kind: string = 'too-many-requests'; }\n\n/** Forbidden failure, independent of transport. */\nexport class ForbiddenError extends ApiError { override readonly kind: string = 'forbidden'; }\n\n/** RequestTimeout failure, independent of transport. */\nexport class RequestTimeoutError extends ApiError { override readonly kind: string = 'request-timeout'; }\n\n/** Offline failure, independent of transport. */\nexport class OfflineError extends ApiError { override readonly kind: string = 'offline'; }\n\n/** The API endpoint is missing, distinct from an absent domain entity. */\nexport class EndpointNotFoundError extends NotFoundError { override readonly kind: string = 'endpoint-not-found'; }\n/** Expected user mistake: successful protocol/monitoring outcome; GUI catches this error. */\nexport class UserError extends ApiError {\n    override readonly kind: string = 'user';\n    constructor(message: string, public errorCode?: string, cause?: Error) {\n        super(message, cause);\n        this.subType = 'USER_ERROR';\n    }\n}\n/** Invalid caller input with optional human-safe field feedback. */\nexport class BadRequestError extends ApiError {\n    override readonly kind: string = 'bad-request';\n    constructor(message: string, public field?: string, public guiMessage?: string, cause?: Error) {\n        super(message, cause);\n    }\n}\n/** Authentication failure with a contract-defined reason. */\nexport class UnauthorizedError extends ApiError {\n    override readonly kind: string = 'unauthorized';\n    constructor(message: string, subType?: string, cause?: Error) {\n        super(message, cause);\n        this.subType = subType;\n    }\n}\n/** Dependency failure with bounded retry advice. */\nexport class VendorError extends ApiError {\n    override readonly kind: string = 'vendor';\n    constructor(message: string, public waitSeconds = 30, cause?: Error) {\n        super(message, cause);\n    }\n}\n"]}

package/src/errors/ApiErrorCodec.d.ts

@@ -0,0 +1,25 @@
+import { ApiError } from './ApiError';
+/** Allowlisted error envelope shared by non-HTTP transports. Contains only bounded semantic causes, never stacks or arbitrary properties. */
+export declare class ApiErrorPayload {
+    kind: string;
+    message: string;
+    cause?: ApiErrorPayload;
+    subType?: string;
+    field?: string;
+    guiAlertMessage?: string;
+    errorCode?: string;
+    waitSeconds?: number;
+    constructor(kind: string, message: string);
+}
+/** Bounded, safe, transport-neutral encoding. Unrecognized types become generic internal failures. */
+export declare class ApiErrorCodec {
+    static encode(error: unknown): ApiErrorPayload;
+    private static encodeDepth;
+    static decode(value: unknown): ApiError;
+    private static decodeDepth;
+    private static decodeOne;
+    private static kind;
+    private static text;
+    private static wait;
+    private static message;
+}

package/src/errors/ApiErrorCodec.js

@@ -0,0 +1,184 @@
+"use strict";
+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. */
+class ApiErrorPayload {
+    kind;
+    message;
+    cause;
+    subType;
+    field;
+    guiAlertMessage;
+    errorCode;
+    waitSeconds;
+    constructor(kind, message) {
+        this.kind = kind;
+        this.message = message;
+    }
+}
+exports.ApiErrorPayload = ApiErrorPayload;
+/** Bounded, safe, transport-neutral encoding. Unrecognized types become generic internal failures. */
+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
+    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
+    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));
+        if (error instanceof ApiError_1.ApiError)
+            payload.subType = this.text(error.subType);
+        if (error instanceof ApiError_1.UserError)
+            payload.errorCode = this.text(error.errorCode);
+        if (error instanceof ApiError_1.BadRequestError) {
+            payload.field = this.text(error.field);
+            payload.guiAlertMessage = this.text(error.guiMessage);
+        }
+        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)
+                payload.cause = this.encodeDepth(cause, depth + 1);
+        }
+        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
+    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
+    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
+                Object.defineProperty(error, 'cause', {
+                    value: this.decodeDepth(cause, depth + 1),
+                    configurable: true,
+                    writable: true,
+                });
+            }
+        }
+        return error;
+    }
+    // webpieces-disable no-function-outside-class -- allowlisted wire codec; webpieces-disable no-any-unknown -- JSON transport input must be validated before use
+    static decodeOne(value) {
+        if (typeof value !== 'object' || value === null)
+            return new ApiError_1.InternalError('Internal Error');
+        // 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 'bad-request':
+                return new ApiError_1.BadRequestError(message, this.text(field('field')), this.text(field('guiAlertMessage')));
+            case 'unauthorized':
+                return new ApiError_1.UnauthorizedError(message, this.text(field('subType')));
+            case 'forbidden':
+                return new ApiError_1.ForbiddenError(message);
+            case 'not-found':
+                return new ApiError_1.NotFoundError(message);
+            case 'endpoint-not-found':
+                return new ApiError_1.EndpointNotFoundError(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);
+            default:
+                return new ApiError_1.InternalError('Internal Error');
+        }
+    }
+    // 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 -- helper of stateless codec; webpieces-disable no-any-unknown -- wire fields need runtime string checks
+    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
+    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
+    static message(kind) {
+        switch (kind) {
+            case 'user':
+                return 'User Error';
+            case 'bad-request':
+                return 'Bad Request';
+            case 'unauthorized':
+                return 'Unauthorized';
+            case 'forbidden':
+                return 'Forbidden';
+            case 'not-found':
+                return 'Not Found';
+            case 'endpoint-not-found':
+                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':
+                return 'Service Unavailable';
+            case 'gateway-timeout':
+                return 'Gateway Timeout';
+            case 'vendor':
+                return 'Vendor Error';
+            case 'offline':
+                return 'Offline';
+            default:
+                return 'Internal Error';
+        }
+    }
+}
+exports.ApiErrorCodec = ApiErrorCodec;
+//# sourceMappingURL=ApiErrorCodec.js.map

package/src/errors/ApiErrorCodec.js.map

@@ -0,0 +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"]}

package/src/errors/index.d.ts

@@ -0,0 +1,2 @@
+export { ApiError, NotFoundError, BadGatewayError, ServiceUnavailableError, GatewayTimeoutError, InternalError, TooManyRequestsError, ForbiddenError, RequestTimeoutError, OfflineError, EndpointNotFoundError, UserError, BadRequestError, UnauthorizedError, VendorError, } from './ApiError';
+export { ApiErrorCodec, ApiErrorPayload } from './ApiErrorCodec';

package/src/errors/index.js

@@ -0,0 +1,23 @@
+"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;
+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; } });
+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; } });
+//# sourceMappingURL=index.js.map

package/src/errors/index.js.map

@@ -0,0 +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"]}

package/src/http/HttpErrorStatus.d.ts

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

package/src/http/HttpErrorStatus.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpErrorStatus = void 0;
+const ApiError_1 = require("../errors/ApiError");
+const errors_1 = require("./errors");
+/** HTTP-only adapter: semantic errors themselves have no protocol status property. */
+class HttpErrorStatus {
+    // webpieces-disable no-function-outside-class -- stateless mapping shared by HTTP adapters
+    static code(error) {
+        if (error instanceof errors_1.HttpError)
+            return error.code;
+        if (error instanceof ApiError_1.UserError)
+            return 266;
+        if (error instanceof ApiError_1.BadRequestError)
+            return 400;
+        if (error instanceof ApiError_1.UnauthorizedError)
+            return 401;
+        if (error instanceof ApiError_1.ForbiddenError)
+            return 403;
+        if (error instanceof ApiError_1.NotFoundError)
+            return 404;
+        if (error instanceof ApiError_1.RequestTimeoutError)
+            return 408;
+        if (error instanceof ApiError_1.TooManyRequestsError)
+            return 429;
+        if (error instanceof ApiError_1.BadGatewayError)
+            return 502;
+        if (error instanceof ApiError_1.ServiceUnavailableError)
+            return 503;
+        if (error instanceof ApiError_1.GatewayTimeoutError)
+            return 504;
+        if (error instanceof ApiError_1.VendorError)
+            return 598;
+        return 500;
+    }
+}
+exports.HttpErrorStatus = HttpErrorStatus;
+//# sourceMappingURL=HttpErrorStatus.js.map

package/src/http/HttpErrorStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpErrorStatus.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/http/HttpErrorStatus.ts"],"names":[],"mappings":";;;AAAA,iDAI4B;AAC5B,qCAAqC;AAErC,sFAAsF;AACtF,MAAa,eAAe;IACxB,2FAA2F;IAC3F,MAAM,CAAC,IAAI,CAAC,KAAe;QACvB,IAAI,KAAK,YAAY,kBAAS;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC;QAClD,IAAI,KAAK,YAAY,oBAAS;YAAE,OAAO,GAAG,CAAC;QAC3C,IAAI,KAAK,YAAY,0BAAe;YAAE,OAAO,GAAG,CAAC;QACjD,IAAI,KAAK,YAAY,4BAAiB;YAAE,OAAO,GAAG,CAAC;QACnD,IAAI,KAAK,YAAY,yBAAc;YAAE,OAAO,GAAG,CAAC;QAChD,IAAI,KAAK,YAAY,wBAAa;YAAE,OAAO,GAAG,CAAC;QAC/C,IAAI,KAAK,YAAY,8BAAmB;YAAE,OAAO,GAAG,CAAC;QACrD,IAAI,KAAK,YAAY,+BAAoB;YAAE,OAAO,GAAG,CAAC;QACtD,IAAI,KAAK,YAAY,0BAAe;YAAE,OAAO,GAAG,CAAC;QACjD,IAAI,KAAK,YAAY,kCAAuB;YAAE,OAAO,GAAG,CAAC;QACzD,IAAI,KAAK,YAAY,8BAAmB;YAAE,OAAO,GAAG,CAAC;QACrD,IAAI,KAAK,YAAY,sBAAW;YAAE,OAAO,GAAG,CAAC;QAC7C,OAAO,GAAG,CAAC;IACf,CAAC;CACJ;AAjBD,0CAiBC","sourcesContent":["import {\n    ApiError, UserError, BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError,\n    RequestTimeoutError, TooManyRequestsError, BadGatewayError, ServiceUnavailableError,\n    GatewayTimeoutError, VendorError,\n} from '../errors/ApiError';\nimport { HttpError } from './errors';\n\n/** HTTP-only adapter: semantic errors themselves have no protocol status property. */\nexport class HttpErrorStatus {\n    // webpieces-disable no-function-outside-class -- stateless mapping shared by HTTP adapters\n    static code(error: ApiError): number {\n        if (error instanceof HttpError) return error.code;\n        if (error instanceof UserError) return 266;\n        if (error instanceof BadRequestError) return 400;\n        if (error instanceof UnauthorizedError) return 401;\n        if (error instanceof ForbiddenError) return 403;\n        if (error instanceof NotFoundError) return 404;\n        if (error instanceof RequestTimeoutError) return 408;\n        if (error instanceof TooManyRequestsError) return 429;\n        if (error instanceof BadGatewayError) return 502;\n        if (error instanceof ServiceUnavailableError) return 503;\n        if (error instanceof GatewayTimeoutError) return 504;\n        if (error instanceof VendorError) return 598;\n        return 500;\n    }\n}\n"]}

package/src/http/LogApiCall.d.ts

@@ -73,7 +73,7 @@ export declare class LogApiCallImpl {
      */
     private logFailure;
     /**
-     * UTF-8 byte size of an already-serialized body. TextEncoder, not Buffer: LogApiCall runs in the
+     * UTF-8 byte size without platform-specific encoding globals: LogApiCall runs in the
      * browser bundle. Undefined in, undefined out — a `Promise<void>` method has no body to measure,
      * and a 0 there would be a lie (JSON.stringify(undefined) returns undefined, not '').
      */

package/src/http/LogApiCall.js

@@ -156,7 +156,7 @@ class LogApiCallImpl {
             : log.error(`[API-${side}-resp-FAIL] ${id} errorType=${errorType} error=${error.message}`));
     }
     /**
-     * UTF-8 byte size of an already-serialized body. TextEncoder, not Buffer: LogApiCall runs in the
+     * UTF-8 byte size without platform-specific encoding globals: LogApiCall runs in the
      * browser bundle. Undefined in, undefined out — a `Promise<void>` method has no body to measure,
      * and a 0 there would be a lie (JSON.stringify(undefined) returns undefined, not '').
      */
@@ -164,7 +164,12 @@ class LogApiCallImpl {
         if (serialized === undefined) {
             return undefined;
         }
-        return new TextEncoder().encode(serialized).length;
+        let bytes = 0;
+        for (const character of serialized) {
+            const code = character.codePointAt(0);
+            bytes += code <= 0x7f ? 1 : code <= 0x7ff ? 2 : code <= 0xffff ? 3 : 4;
+        }
+        return bytes;
     }
     /**
      * Is this error a NON-failure for HEALTH/METRICS — the process working CORRECTLY (log OTHER, api