@rexezuge/errors 0.0.0-stage → 1.0.1

package/dist/OutcomeError.d.ts

@@ -0,0 +1,41 @@
+import { ServiceError } from './ServiceError';
+import type { ServiceErrorOptions } from './ServiceError';
+/**
+ * An error whose retryability is decided by the thrower, not deduced.
+ *
+ * Durable-DAV's `D1ErrorClassifier` can classify a raw D1 message, but a
+ * provider-level failure (OAuth2 grant revoked, upstream API rejecting a
+ * payload) carries no such signal — only the code that made the call knows.
+ * This taxonomy lets that code say so explicitly, and the status defaults
+ * follow the retry flag rather than a name-lookup table that could disagree.
+ */
+declare class OutcomeError extends ServiceError {
+    constructor(message: string, options: ServiceErrorOptions & {
+        retryable: boolean;
+    });
+}
+/**
+ * Transient upstream failure: a later attempt may succeed (throttling, 5xx
+ * from the provider, token refresh race). Status 502 by default.
+ */
+declare class RetryableError extends OutcomeError {
+    constructor(message: string, status?: number);
+}
+/**
+ * Permanent failure: retrying repeats the failure forever. A revoked grant
+ * retried every ten minutes told the caller the request was a server fault;
+ * this class exists so that never reads as retryable again. Status 400.
+ */
+declare class NonRetryableError extends OutcomeError {
+    constructor(message: string, status?: number);
+}
+declare class ProviderApiRetryableError extends RetryableError {
+}
+declare class ProviderApiNonRetryableError extends NonRetryableError {
+}
+declare class OAuth2TokenRetryableError extends RetryableError {
+}
+declare class OAuth2TokenNonRetryableError extends NonRetryableError {
+}
+export { NonRetryableError, OAuth2TokenNonRetryableError, OAuth2TokenRetryableError, OutcomeError, ProviderApiNonRetryableError, ProviderApiRetryableError, RetryableError, };
+//# sourceMappingURL=OutcomeError.d.ts.map

package/dist/OutcomeError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutcomeError.d.ts","sourceRoot":"","sources":["../src/OutcomeError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;;;;;GAQG;AACH,cAAM,YAAa,SAAQ,YAAY;gBACzB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE;CAGnF;AAED;;;GAGG;AACH,cAAM,cAAe,SAAQ,YAAY;gBAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAM7C;AAED;;;;GAIG;AACH,cAAM,iBAAkB,SAAQ,YAAY;gBAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAM7C;AAED,cAAM,yBAA0B,SAAQ,cAAc;CAAG;AACzD,cAAM,4BAA6B,SAAQ,iBAAiB;CAAG;AAC/D,cAAM,yBAA0B,SAAQ,cAAc;CAAG;AACzD,cAAM,4BAA6B,SAAQ,iBAAiB;CAAG;AAE/D,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,yBAAyB,EACzB,YAAY,EACZ,4BAA4B,EAC5B,yBAAyB,EACzB,cAAc,GACf,CAAC"}

package/dist/OutcomeError.js

@@ -0,0 +1,50 @@
+import { ServiceError } from './ServiceError';
+/**
+ * An error whose retryability is decided by the thrower, not deduced.
+ *
+ * Durable-DAV's `D1ErrorClassifier` can classify a raw D1 message, but a
+ * provider-level failure (OAuth2 grant revoked, upstream API rejecting a
+ * payload) carries no such signal — only the code that made the call knows.
+ * This taxonomy lets that code say so explicitly, and the status defaults
+ * follow the retry flag rather than a name-lookup table that could disagree.
+ */
+class OutcomeError extends ServiceError {
+    constructor(message, options) {
+        super(options.retryable ? 502 : 400, new.target.name, message, options);
+    }
+}
+/**
+ * Transient upstream failure: a later attempt may succeed (throttling, 5xx
+ * from the provider, token refresh race). Status 502 by default.
+ */
+class RetryableError extends OutcomeError {
+    constructor(message, status) {
+        super(message, { retryable: true, ...(status === undefined ? {} : { expose: status < 500 }) });
+        if (status !== undefined) {
+            this.status = status;
+        }
+    }
+}
+/**
+ * Permanent failure: retrying repeats the failure forever. A revoked grant
+ * retried every ten minutes told the caller the request was a server fault;
+ * this class exists so that never reads as retryable again. Status 400.
+ */
+class NonRetryableError extends OutcomeError {
+    constructor(message, status) {
+        super(message, { retryable: false, ...(status === undefined ? {} : { expose: status < 500 }) });
+        if (status !== undefined) {
+            this.status = status;
+        }
+    }
+}
+class ProviderApiRetryableError extends RetryableError {
+}
+class ProviderApiNonRetryableError extends NonRetryableError {
+}
+class OAuth2TokenRetryableError extends RetryableError {
+}
+class OAuth2TokenNonRetryableError extends NonRetryableError {
+}
+export { NonRetryableError, OAuth2TokenNonRetryableError, OAuth2TokenRetryableError, OutcomeError, ProviderApiNonRetryableError, ProviderApiRetryableError, RetryableError, };
+//# sourceMappingURL=OutcomeError.js.map

package/dist/OutcomeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutcomeError.js","sourceRoot":"","sources":["../src/OutcomeError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;;;;;;;GAQG;AACH,MAAM,YAAa,SAAQ,YAAY;IACrC,YAAY,OAAe,EAAE,OAAqD;QAChF,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,cAAe,SAAQ,YAAY;IACvC,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/F,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,iBAAkB,SAAQ,YAAY;IAC1C,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAChG,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AAED,MAAM,yBAA0B,SAAQ,cAAc;CAAG;AACzD,MAAM,4BAA6B,SAAQ,iBAAiB;CAAG;AAC/D,MAAM,yBAA0B,SAAQ,cAAc;CAAG;AACzD,MAAM,4BAA6B,SAAQ,iBAAiB;CAAG;AAE/D,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,yBAAyB,EACzB,YAAY,EACZ,4BAA4B,EAC5B,yBAAyB,EACzB,cAAc,GACf,CAAC"}

package/dist/PayloadTooLargeError.d.ts

@@ -0,0 +1,9 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 413 — the payload exceeds the server's limits (request body, file, batch).
+ */
+declare class PayloadTooLargeError extends HttpServiceError<'payloadTooLarge'> {
+    constructor(message?: string);
+}
+export { PayloadTooLargeError };
+//# sourceMappingURL=PayloadTooLargeError.d.ts.map

package/dist/PayloadTooLargeError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayloadTooLargeError.d.ts","sourceRoot":"","sources":["../src/PayloadTooLargeError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,cAAM,oBAAqB,SAAQ,gBAAgB,CAAC,iBAAiB,CAAC;gBACxD,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/PayloadTooLargeError.js

@@ -0,0 +1,11 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 413 — the payload exceeds the server's limits (request body, file, batch).
+ */
+class PayloadTooLargeError extends HttpServiceError {
+    constructor(message) {
+        super('payloadTooLarge', message);
+    }
+}
+export { PayloadTooLargeError };
+//# sourceMappingURL=PayloadTooLargeError.js.map

package/dist/PayloadTooLargeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayloadTooLargeError.js","sourceRoot":"","sources":["../src/PayloadTooLargeError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,oBAAqB,SAAQ,gBAAmC;IACpE,YAAY,OAAgB;QAC1B,KAAK,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;CACF;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/PreconditionFailedError.d.ts

@@ -0,0 +1,10 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 412 — a precondition the caller supplied (e.g. `If-Match`, expected state)
+ * did not hold. Retrying unmodified fails by definition.
+ */
+declare class PreconditionFailedError extends HttpServiceError<'preconditionFailed'> {
+    constructor(message?: string);
+}
+export { PreconditionFailedError };
+//# sourceMappingURL=PreconditionFailedError.d.ts.map

package/dist/PreconditionFailedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreconditionFailedError.d.ts","sourceRoot":"","sources":["../src/PreconditionFailedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,cAAM,uBAAwB,SAAQ,gBAAgB,CAAC,oBAAoB,CAAC;gBAC9D,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/PreconditionFailedError.js

@@ -0,0 +1,12 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 412 — a precondition the caller supplied (e.g. `If-Match`, expected state)
+ * did not hold. Retrying unmodified fails by definition.
+ */
+class PreconditionFailedError extends HttpServiceError {
+    constructor(message) {
+        super('preconditionFailed', message);
+    }
+}
+export { PreconditionFailedError };
+//# sourceMappingURL=PreconditionFailedError.js.map

package/dist/PreconditionFailedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreconditionFailedError.js","sourceRoot":"","sources":["../src/PreconditionFailedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,MAAM,uBAAwB,SAAQ,gBAAsC;IAC1E,YAAY,OAAgB;QAC1B,KAAK,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;CACF;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/RateLimitedError.d.ts

@@ -0,0 +1,10 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 429 — the caller exceeded its rate budget. Retrying is not just futile but
+ * punished; honor `retryAfter`-style backoff at the caller.
+ */
+declare class RateLimitedError extends HttpServiceError<'rateLimited'> {
+    constructor(message?: string);
+}
+export { RateLimitedError };
+//# sourceMappingURL=RateLimitedError.d.ts.map

package/dist/RateLimitedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimitedError.d.ts","sourceRoot":"","sources":["../src/RateLimitedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,cAAM,gBAAiB,SAAQ,gBAAgB,CAAC,aAAa,CAAC;gBAChD,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/RateLimitedError.js

@@ -0,0 +1,12 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 429 — the caller exceeded its rate budget. Retrying is not just futile but
+ * punished; honor `retryAfter`-style backoff at the caller.
+ */
+class RateLimitedError extends HttpServiceError {
+    constructor(message) {
+        super('rateLimited', message);
+    }
+}
+export { RateLimitedError };
+//# sourceMappingURL=RateLimitedError.js.map

package/dist/RateLimitedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimitedError.js","sourceRoot":"","sources":["../src/RateLimitedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,MAAM,gBAAiB,SAAQ,gBAA+B;IAC5D,YAAY,OAAgB;QAC1B,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;CACF;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/ServiceError.d.ts

@@ -0,0 +1,63 @@
+import type { ErrorResponse } from './ErrorResponse';
+interface ServiceErrorOptions {
+    /** Marks a transient failure: a caller retrying is meaningful. */
+    retryable?: boolean;
+    /** Whether the raw message may reach a client. Defaults to `status < 500`. */
+    expose?: boolean;
+    /** Underlying cause, preserved for operator-facing logs. */
+    cause?: unknown;
+}
+interface ErrorHttpPayload {
+    status: number;
+    body: ErrorResponse;
+}
+/**
+ * Root of the error taxonomy.
+ *
+ * Every boundary in the family (route handlers, middleware, background tasks)
+ * branches on `instanceof ServiceError`, so every concrete error must genuinely
+ * extend it — an `implements` leaves the prototype chain broken and silently
+ * masks typed errors as generic 500s.
+ *
+ * Status/type/retryable/expose are public fields, not methods: the values are
+ * fixed at construction, and callers in all nine repos read them far more often
+ * than they were ever written.
+ */
+declare abstract class ServiceError extends Error {
+    /** The HTTP status. Defaults from the catalog; a subclass may refine it. */
+    status: number;
+    /** Overridable by subclasses whose identity differs from the HTTP class name. */
+    type: string;
+    /** False by default: retrying is the exception, not the rule. */
+    retryable: boolean;
+    /** Whether the raw message may reach a client. Defaults to `status < 500`. */
+    expose: boolean;
+    constructor(status: number, type: string, message: string, options?: ServiceErrorOptions);
+    /**
+     * The wire form: status plus the family's `ErrorResponse` envelope.
+     *
+     * A non-exposing error (5xx) has its message substituted — `message` is for
+     * operators, and pushing it to clients leaks internals. The substitution
+     * lives here, once, rather than in nine boundary mappers.
+     */
+    toErrorResponse(): ErrorHttpPayload;
+    /**
+     * Normalize an unknown catch-block value into the taxonomy.
+     *
+     * A `ServiceError` passes through untouched (re-wrapping would bury its
+     * context); anything else becomes a non-retryable 500 carrying the original
+     * message and cause. Boundary code should call this before mapping an error
+     * to a response, so `error instanceof ServiceError` is guaranteed downstream.
+     */
+    static from(error: unknown): ServiceError;
+}
+/**
+ * Private throwable used by `ServiceError.from` for pass-through wrapping.
+ * Not exported: reach `InternalServerError` for the public 500.
+ */
+declare class InternalServiceError extends ServiceError {
+    constructor(message: string, options?: ServiceErrorOptions);
+}
+export { ServiceError, InternalServiceError };
+export type { ServiceErrorOptions, ErrorHttpPayload };
+//# sourceMappingURL=ServiceError.d.ts.map

package/dist/ServiceError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceError.d.ts","sourceRoot":"","sources":["../src/ServiceError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,UAAU,mBAAmB;IAC3B,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;CACrB;AAID;;;;;;;;;;;GAWG;AACH,uBAAe,YAAa,SAAQ,KAAK;IACvC,4EAA4E;IACrE,MAAM,EAAE,MAAM,CAAC;IAEtB,iFAAiF;IAC1E,IAAI,EAAE,MAAM,CAAC;IAEpB,iEAAiE;IAC1D,SAAS,EAAE,OAAO,CAAC;IAE1B,8EAA8E;IACvE,MAAM,EAAE,OAAO,CAAC;gBAEX,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAexF;;;;;;OAMG;IACI,eAAe,IAAI,gBAAgB;IAa1C;;;;;;;OAOG;WACW,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY;CASjD;AAED;;;GAGG;AACH,cAAM,oBAAqB,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAG3D;AAED,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/ServiceError.js

@@ -0,0 +1,84 @@
+const INTERNAL_SERVER_MESSAGE = 'The server encountered an internal error and was unable to complete your request.';
+/**
+ * Root of the error taxonomy.
+ *
+ * Every boundary in the family (route handlers, middleware, background tasks)
+ * branches on `instanceof ServiceError`, so every concrete error must genuinely
+ * extend it — an `implements` leaves the prototype chain broken and silently
+ * masks typed errors as generic 500s.
+ *
+ * Status/type/retryable/expose are public fields, not methods: the values are
+ * fixed at construction, and callers in all nine repos read them far more often
+ * than they were ever written.
+ */
+class ServiceError extends Error {
+    /** The HTTP status. Defaults from the catalog; a subclass may refine it. */
+    status;
+    /** Overridable by subclasses whose identity differs from the HTTP class name. */
+    type;
+    /** False by default: retrying is the exception, not the rule. */
+    retryable;
+    /** Whether the raw message may reach a client. Defaults to `status < 500`. */
+    expose;
+    constructor(status, type, message, options) {
+        super(message);
+        // `new.target.name` rather than the passed type: a subclass reports itself
+        // even if its author forgot to name it, so log lines and client payloads
+        // never disagree about what failed.
+        this.name = new.target.name;
+        this.status = status;
+        this.type = type;
+        this.retryable = options?.retryable ?? false;
+        this.expose = options?.expose ?? status < 500;
+        if (options?.cause !== undefined) {
+            this.cause = options.cause;
+        }
+    }
+    /**
+     * The wire form: status plus the family's `ErrorResponse` envelope.
+     *
+     * A non-exposing error (5xx) has its message substituted — `message` is for
+     * operators, and pushing it to clients leaks internals. The substitution
+     * lives here, once, rather than in nine boundary mappers.
+     */
+    toErrorResponse() {
+        const message = this.expose ? this.message : INTERNAL_SERVER_MESSAGE;
+        return {
+            status: this.status,
+            body: {
+                Exception: {
+                    Type: this.type,
+                    Message: message,
+                },
+            },
+        };
+    }
+    /**
+     * Normalize an unknown catch-block value into the taxonomy.
+     *
+     * A `ServiceError` passes through untouched (re-wrapping would bury its
+     * context); anything else becomes a non-retryable 500 carrying the original
+     * message and cause. Boundary code should call this before mapping an error
+     * to a response, so `error instanceof ServiceError` is guaranteed downstream.
+     */
+    static from(error) {
+        if (error instanceof ServiceError) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new InternalServiceError(error.message, { cause: error });
+        }
+        return new InternalServiceError(String(error), { cause: error });
+    }
+}
+/**
+ * Private throwable used by `ServiceError.from` for pass-through wrapping.
+ * Not exported: reach `InternalServerError` for the public 500.
+ */
+class InternalServiceError extends ServiceError {
+    constructor(message, options) {
+        super(500, 'InternalError', message, options);
+    }
+}
+export { ServiceError, InternalServiceError };
+//# sourceMappingURL=ServiceError.js.map

package/dist/ServiceError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceError.js","sourceRoot":"","sources":["../src/ServiceError.ts"],"names":[],"mappings":"AAgBA,MAAM,uBAAuB,GAAG,mFAAmF,CAAC;AAEpH;;;;;;;;;;;GAWG;AACH,MAAe,YAAa,SAAQ,KAAK;IACvC,4EAA4E;IACrE,MAAM,CAAS;IAEtB,iFAAiF;IAC1E,IAAI,CAAS;IAEpB,iEAAiE;IAC1D,SAAS,CAAU;IAE1B,8EAA8E;IACvE,MAAM,CAAU;IAEvB,YAAY,MAAc,EAAE,IAAY,EAAE,OAAe,EAAE,OAA6B;QACtF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,2EAA2E;QAC3E,yEAAyE;QACzE,oCAAoC;QACpC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,KAAK,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,MAAM,GAAG,GAAG,CAAC;QAC9C,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,eAAe;QACpB,MAAM,OAAO,GAAW,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC;QAC7E,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE;gBACJ,SAAS,EAAE;oBACT,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,OAAO,EAAE,OAAO;iBACjB;aACF;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,IAAI,CAAC,KAAc;QAC/B,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,IAAI,oBAAoB,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,oBAAqB,SAAQ,YAAY;IAC7C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;CACF;AAED,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/ServiceUnavailableError.d.ts

@@ -0,0 +1,10 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 503 — unavailable now, healthy later. The natural status for retryable
+ * infrastructure failures (a locked D1, an overloaded upstream).
+ */
+declare class ServiceUnavailableError extends HttpServiceError<'serviceUnavailable'> {
+    constructor(message?: string);
+}
+export { ServiceUnavailableError };
+//# sourceMappingURL=ServiceUnavailableError.d.ts.map

package/dist/ServiceUnavailableError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceUnavailableError.d.ts","sourceRoot":"","sources":["../src/ServiceUnavailableError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,cAAM,uBAAwB,SAAQ,gBAAgB,CAAC,oBAAoB,CAAC;gBAC9D,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/ServiceUnavailableError.js

@@ -0,0 +1,12 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 503 — unavailable now, healthy later. The natural status for retryable
+ * infrastructure failures (a locked D1, an overloaded upstream).
+ */
+class ServiceUnavailableError extends HttpServiceError {
+    constructor(message) {
+        super('serviceUnavailable', message);
+    }
+}
+export { ServiceUnavailableError };
+//# sourceMappingURL=ServiceUnavailableError.js.map

package/dist/ServiceUnavailableError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceUnavailableError.js","sourceRoot":"","sources":["../src/ServiceUnavailableError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,MAAM,uBAAwB,SAAQ,gBAAsC;IAC1E,YAAY,OAAgB;QAC1B,KAAK,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;CACF;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/UnauthorizedError.d.ts

@@ -0,0 +1,10 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 401 — credentials missing, expired, or rejected. Distinct from `Forbidden`:
+ * re-authenticating may help; `Forbidden` it will not.
+ */
+declare class UnauthorizedError extends HttpServiceError<'unauthorized'> {
+    constructor(message?: string);
+}
+export { UnauthorizedError };
+//# sourceMappingURL=UnauthorizedError.d.ts.map

package/dist/UnauthorizedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnauthorizedError.d.ts","sourceRoot":"","sources":["../src/UnauthorizedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,cAAM,iBAAkB,SAAQ,gBAAgB,CAAC,cAAc,CAAC;gBAClD,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/UnauthorizedError.js

@@ -0,0 +1,12 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 401 — credentials missing, expired, or rejected. Distinct from `Forbidden`:
+ * re-authenticating may help; `Forbidden` it will not.
+ */
+class UnauthorizedError extends HttpServiceError {
+    constructor(message) {
+        super('unauthorized', message);
+    }
+}
+export { UnauthorizedError };
+//# sourceMappingURL=UnauthorizedError.js.map

package/dist/UnauthorizedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnauthorizedError.js","sourceRoot":"","sources":["../src/UnauthorizedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,MAAM,iBAAkB,SAAQ,gBAAgC;IAC9D,YAAY,OAAgB;QAC1B,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;CACF;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/UnsupportedMediaTypeError.d.ts

@@ -0,0 +1,9 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 415 — the body's content type is not one the endpoint can parse.
+ */
+declare class UnsupportedMediaTypeError extends HttpServiceError<'unsupportedMediaType'> {
+    constructor(message?: string);
+}
+export { UnsupportedMediaTypeError };
+//# sourceMappingURL=UnsupportedMediaTypeError.d.ts.map

package/dist/UnsupportedMediaTypeError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnsupportedMediaTypeError.d.ts","sourceRoot":"","sources":["../src/UnsupportedMediaTypeError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,cAAM,yBAA0B,SAAQ,gBAAgB,CAAC,sBAAsB,CAAC;gBAClE,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/UnsupportedMediaTypeError.js

@@ -0,0 +1,11 @@
+import { HttpServiceError } from './HttpServiceError';
+/**
+ * 415 — the body's content type is not one the endpoint can parse.
+ */
+class UnsupportedMediaTypeError extends HttpServiceError {
+    constructor(message) {
+        super('unsupportedMediaType', message);
+    }
+}
+export { UnsupportedMediaTypeError };
+//# sourceMappingURL=UnsupportedMediaTypeError.js.map

package/dist/UnsupportedMediaTypeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnsupportedMediaTypeError.js","sourceRoot":"","sources":["../src/UnsupportedMediaTypeError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,yBAA0B,SAAQ,gBAAwC;IAC9E,YAAY,OAAgB;QAC1B,KAAK,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAED,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export { CATALOG } from './CATALOG';
+export type { HttpErrorDefinition, HttpErrorType } from './CATALOG';
+export { ServiceError } from './ServiceError';
+export type { ServiceErrorOptions, ErrorHttpPayload } from './ServiceError';
+export { HttpServiceError } from './HttpServiceError';
+export { BadRequestError } from './BadRequestError';
+export { UnauthorizedError } from './UnauthorizedError';
+export { ForbiddenError } from './ForbiddenError';
+export { NotFoundError } from './NotFoundError';
+export { MethodNotAllowedError } from './MethodNotAllowedError';
+export { ConflictError } from './ConflictError';
+export { PreconditionFailedError } from './PreconditionFailedError';
+export { PayloadTooLargeError } from './PayloadTooLargeError';
+export { UnsupportedMediaTypeError } from './UnsupportedMediaTypeError';
+export { RateLimitedError } from './RateLimitedError';
+export { InternalServerError, DefaultInternalServerError } from './InternalServerError';
+export { NotImplementedError } from './NotImplementedError';
+export { BadGatewayError } from './BadGatewayError';
+export { ServiceUnavailableError } from './ServiceUnavailableError';
+export { DatabaseError } from './DatabaseError';
+export { NonRetryableError, OAuth2TokenNonRetryableError, OAuth2TokenRetryableError, OutcomeError, ProviderApiNonRetryableError, ProviderApiRetryableError, RetryableError, } from './OutcomeError';
+export type { ErrorResponse } from './ErrorResponse';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,yBAAyB,EACzB,YAAY,EACZ,4BAA4B,EAC5B,yBAAyB,EACzB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+export { CATALOG } from './CATALOG';
+export { ServiceError } from './ServiceError';
+export { HttpServiceError } from './HttpServiceError';
+export { BadRequestError } from './BadRequestError';
+export { UnauthorizedError } from './UnauthorizedError';
+export { ForbiddenError } from './ForbiddenError';
+export { NotFoundError } from './NotFoundError';
+export { MethodNotAllowedError } from './MethodNotAllowedError';
+export { ConflictError } from './ConflictError';
+export { PreconditionFailedError } from './PreconditionFailedError';
+export { PayloadTooLargeError } from './PayloadTooLargeError';
+export { UnsupportedMediaTypeError } from './UnsupportedMediaTypeError';
+export { RateLimitedError } from './RateLimitedError';
+export { InternalServerError, DefaultInternalServerError } from './InternalServerError';
+export { NotImplementedError } from './NotImplementedError';
+export { BadGatewayError } from './BadGatewayError';
+export { ServiceUnavailableError } from './ServiceUnavailableError';
+export { DatabaseError } from './DatabaseError';
+export { NonRetryableError, OAuth2TokenNonRetryableError, OAuth2TokenRetryableError, OutcomeError, ProviderApiNonRetryableError, ProviderApiRetryableError, RetryableError, } from './OutcomeError';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,yBAAyB,EACzB,YAAY,EACZ,4BAA4B,EAC5B,yBAAyB,EACzB,cAAc,GACf,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@rexezuge/errors",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.1",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rexezuge-CloudflareWorkers/SDK.git",
+    "directory": "packages/errors"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "26.6.4",
+    "typescript": "6.0.3",
+    "vitest": "4.1.11"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.test.json --noEmit",
+    "test": "vitest run"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.