@contextplusplus/core 1.1.0

package/dist/domain/error-mapping.d.ts

@@ -0,0 +1,138 @@
+import type { ApplicationError } from "./errors.js";
+export type AllApplicationErrorTags = ApplicationError["_tag"];
+export interface ErrorSurfaceMapping {
+    readonly httpStatus: number;
+    readonly cliExitCode: number;
+}
+export declare const DEFAULT_CLI_EXIT_CODE = 1;
+export declare const CLI_VALIDATION_EXIT_CODE = 2;
+export declare const CLI_AUTH_EXIT_CODE = 3;
+export declare const CLI_SUBSCRIPTION_EXIT_CODE = 4;
+export declare const CLI_QUOTA_EXIT_CODE = 5;
+export declare const CLI_TIMEOUT_EXIT_CODE = 124;
+export declare const APPLICATION_ERROR_SURFACE_MAPPING: {
+    readonly InputValidationError: {
+        readonly httpStatus: 400;
+        readonly cliExitCode: 2;
+    };
+    readonly UnsupportedUrlError: {
+        readonly httpStatus: 400;
+        readonly cliExitCode: 1;
+    };
+    readonly UnsafeUrlError: {
+        readonly httpStatus: 400;
+        readonly cliExitCode: 1;
+    };
+    readonly EndpointDetectionError: {
+        readonly httpStatus: 400;
+        readonly cliExitCode: 1;
+    };
+    readonly NotFoundError: {
+        readonly httpStatus: 404;
+        readonly cliExitCode: 1;
+    };
+    readonly ProviderAuthError: {
+        readonly httpStatus: 401;
+        readonly cliExitCode: 1;
+    };
+    readonly AuthenticationRequiredError: {
+        readonly httpStatus: 401;
+        readonly cliExitCode: 3;
+    };
+    readonly InvalidCredentialError: {
+        readonly httpStatus: 401;
+        readonly cliExitCode: 3;
+    };
+    readonly ForbiddenError: {
+        readonly httpStatus: 403;
+        readonly cliExitCode: 1;
+    };
+    readonly InsufficientScopeError: {
+        readonly httpStatus: 403;
+        readonly cliExitCode: 1;
+    };
+    readonly AccountSuspendedError: {
+        readonly httpStatus: 403;
+        readonly cliExitCode: 3;
+    };
+    readonly SubscriptionRequiredError: {
+        readonly httpStatus: 402;
+        readonly cliExitCode: 4;
+    };
+    readonly ProviderQuotaError: {
+        readonly httpStatus: 429;
+        readonly cliExitCode: 1;
+    };
+    readonly ProviderRateLimitedError: {
+        readonly httpStatus: 429;
+        readonly cliExitCode: 1;
+    };
+    readonly QuotaExceededError: {
+        readonly httpStatus: 429;
+        readonly cliExitCode: 5;
+    };
+    readonly ClientCancelledError: {
+        readonly httpStatus: 499;
+        readonly cliExitCode: 1;
+    };
+    readonly ConfigurationError: {
+        readonly httpStatus: 500;
+        readonly cliExitCode: 1;
+    };
+    readonly BillingStateError: {
+        readonly httpStatus: 500;
+        readonly cliExitCode: 1;
+    };
+    readonly RenderError: {
+        readonly httpStatus: 500;
+        readonly cliExitCode: 1;
+    };
+    readonly ArtifactWriteError: {
+        readonly httpStatus: 500;
+        readonly cliExitCode: 1;
+    };
+    readonly CacheReadError: {
+        readonly httpStatus: 500;
+        readonly cliExitCode: 1;
+    };
+    readonly CacheWriteError: {
+        readonly httpStatus: 500;
+        readonly cliExitCode: 1;
+    };
+    readonly ProviderBadResponseError: {
+        readonly httpStatus: 502;
+        readonly cliExitCode: 1;
+    };
+    readonly AllStrategiesFailedError: {
+        readonly httpStatus: 502;
+        readonly cliExitCode: 1;
+    };
+    readonly FallbackExhaustedError: {
+        readonly httpStatus: 502;
+        readonly cliExitCode: 1;
+    };
+    readonly CacheUnavailableError: {
+        readonly httpStatus: 503;
+        readonly cliExitCode: 1;
+    };
+    readonly ProviderUnavailableError: {
+        readonly httpStatus: 503;
+        readonly cliExitCode: 1;
+    };
+    readonly ProviderSpendCeilingExceededError: {
+        readonly httpStatus: 503;
+        readonly cliExitCode: 1;
+    };
+    readonly ProviderTimeoutError: {
+        readonly httpStatus: 504;
+        readonly cliExitCode: 124;
+    };
+};
+export declare const APPLICATION_ERROR_HTTP_STATUS: Readonly<Record<AllApplicationErrorTags, number>>;
+export declare const APPLICATION_ERROR_CLI_EXIT_CODE: Readonly<Record<AllApplicationErrorTags, number>>;
+export declare const HTTP_EXTRA_ERROR_STATUS: {
+    readonly RequestTimeout: 504;
+};
+export type HttpExtraErrorTag = keyof typeof HTTP_EXTRA_ERROR_STATUS;
+export declare const HTTP_ERROR_STATUS: Readonly<Record<AllApplicationErrorTags | HttpExtraErrorTag, number>>;
+//# sourceMappingURL=error-mapping.d.ts.map

package/dist/domain/error-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapping.d.ts","sourceRoot":"","sources":["../../src/domain/error-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqH2B,CAAC;AAE1E,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAM9C,CAAC;AAE/C,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAMhD,CAAC;AAE/C,eAAO,MAAM,uBAAuB;;CAE1B,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,uBAAuB,CAAC;AAErE,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CACtC,MAAM,CAAC,uBAAuB,GAAG,iBAAiB,EAAE,MAAM,CAAC,CAI5D,CAAC"}

package/dist/domain/error-mapping.js

@@ -0,0 +1,143 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7f23f5c4-90a5-58ad-8baf-5ad854b00254")}catch(e){}}();
+export const DEFAULT_CLI_EXIT_CODE = 1;
+export const CLI_VALIDATION_EXIT_CODE = 2;
+export const CLI_AUTH_EXIT_CODE = 3;
+export const CLI_SUBSCRIPTION_EXIT_CODE = 4;
+export const CLI_QUOTA_EXIT_CODE = 5;
+export const CLI_TIMEOUT_EXIT_CODE = 124;
+export const APPLICATION_ERROR_SURFACE_MAPPING = {
+    InputValidationError: {
+        httpStatus: 400,
+        cliExitCode: CLI_VALIDATION_EXIT_CODE
+    },
+    UnsupportedUrlError: {
+        httpStatus: 400,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    UnsafeUrlError: {
+        httpStatus: 400,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    EndpointDetectionError: {
+        httpStatus: 400,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    NotFoundError: {
+        httpStatus: 404,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    ProviderAuthError: {
+        httpStatus: 401,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    AuthenticationRequiredError: {
+        httpStatus: 401,
+        cliExitCode: CLI_AUTH_EXIT_CODE
+    },
+    InvalidCredentialError: {
+        httpStatus: 401,
+        cliExitCode: CLI_AUTH_EXIT_CODE
+    },
+    ForbiddenError: {
+        httpStatus: 403,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    InsufficientScopeError: {
+        httpStatus: 403,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    AccountSuspendedError: {
+        httpStatus: 403,
+        cliExitCode: CLI_AUTH_EXIT_CODE
+    },
+    SubscriptionRequiredError: {
+        httpStatus: 402,
+        cliExitCode: CLI_SUBSCRIPTION_EXIT_CODE
+    },
+    ProviderQuotaError: {
+        httpStatus: 429,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    ProviderRateLimitedError: {
+        httpStatus: 429,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    QuotaExceededError: {
+        httpStatus: 429,
+        cliExitCode: CLI_QUOTA_EXIT_CODE
+    },
+    ClientCancelledError: {
+        httpStatus: 499,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    ConfigurationError: {
+        httpStatus: 500,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    BillingStateError: {
+        httpStatus: 500,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    RenderError: {
+        httpStatus: 500,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    ArtifactWriteError: {
+        httpStatus: 500,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    CacheReadError: {
+        httpStatus: 500,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    CacheWriteError: {
+        httpStatus: 500,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    ProviderBadResponseError: {
+        httpStatus: 502,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    AllStrategiesFailedError: {
+        httpStatus: 502,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    FallbackExhaustedError: {
+        httpStatus: 502,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    CacheUnavailableError: {
+        httpStatus: 503,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    ProviderUnavailableError: {
+        httpStatus: 503,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    ProviderSpendCeilingExceededError: {
+        httpStatus: 503,
+        cliExitCode: DEFAULT_CLI_EXIT_CODE
+    },
+    ProviderTimeoutError: {
+        httpStatus: 504,
+        cliExitCode: CLI_TIMEOUT_EXIT_CODE
+    }
+};
+export const APPLICATION_ERROR_HTTP_STATUS = Object.fromEntries(Object.entries(APPLICATION_ERROR_SURFACE_MAPPING).map(([tag, mapping]) => [
+    tag,
+    mapping.httpStatus
+]));
+export const APPLICATION_ERROR_CLI_EXIT_CODE = Object.fromEntries(Object.entries(APPLICATION_ERROR_SURFACE_MAPPING).map(([tag, mapping]) => [
+    tag,
+    mapping.cliExitCode
+]));
+export const HTTP_EXTRA_ERROR_STATUS = {
+    RequestTimeout: 504
+};
+export const HTTP_ERROR_STATUS = {
+    ...APPLICATION_ERROR_HTTP_STATUS,
+    ...HTTP_EXTRA_ERROR_STATUS
+};
+//# sourceMappingURL=error-mapping.js.map
+//# debugId=7f23f5c4-90a5-58ad-8baf-5ad854b00254

package/dist/domain/error-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapping.js","sources":["../../src/domain/error-mapping.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"7f23f5c4-90a5-58ad-8baf-5ad854b00254"}

package/dist/domain/errors.d.ts

@@ -0,0 +1,365 @@
+import { Schema } from "effect";
+import { JsonValue as JsonValueSchema, type JsonValue } from "./json.js";
+export interface ErrorContext {
+    readonly provider?: string;
+    readonly service?: string;
+    readonly endpoint?: string;
+    readonly url?: string;
+    readonly elapsedMs?: number;
+    readonly retryAfterSeconds?: number;
+    readonly cause?: JsonValue;
+}
+export declare function sanitizeErrorCause(cause: unknown): JsonValue;
+export declare function sanitizeErrorMessage(message: string): string;
+export declare function redactSensitiveString(value: string): string;
+declare const InputValidationError_base: Schema.TaggedErrorClass<InputValidationError, "InputValidationError", {
+    readonly _tag: Schema.tag<"InputValidationError">;
+} & {
+    message: typeof Schema.String;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class InputValidationError extends InputValidationError_base {
+}
+declare const UnsupportedUrlError_base: Schema.TaggedErrorClass<UnsupportedUrlError, "UnsupportedUrlError", {
+    readonly _tag: Schema.tag<"UnsupportedUrlError">;
+} & {
+    url: typeof Schema.String;
+    message: Schema.optional<typeof Schema.String>;
+}>;
+export declare class UnsupportedUrlError extends UnsupportedUrlError_base {
+}
+declare const UnsafeUrlError_base: Schema.TaggedErrorClass<UnsafeUrlError, "UnsafeUrlError", {
+    readonly _tag: Schema.tag<"UnsafeUrlError">;
+} & {
+    url: typeof Schema.String;
+    reason: typeof Schema.String;
+}>;
+export declare class UnsafeUrlError extends UnsafeUrlError_base {
+}
+declare const EndpointDetectionError_base: Schema.TaggedErrorClass<EndpointDetectionError, "EndpointDetectionError", {
+    readonly _tag: Schema.tag<"EndpointDetectionError">;
+} & {
+    url: typeof Schema.String;
+    endpoint: Schema.optional<typeof Schema.String>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class EndpointDetectionError extends EndpointDetectionError_base {
+}
+declare const NotFoundError_base: Schema.TaggedErrorClass<NotFoundError, "NotFoundError", {
+    readonly _tag: Schema.tag<"NotFoundError">;
+} & {
+    resource: typeof Schema.String;
+    id: Schema.optional<typeof Schema.String>;
+    message: Schema.optional<typeof Schema.String>;
+}>;
+export declare class NotFoundError extends NotFoundError_base {
+}
+declare const ConfigurationError_base: Schema.TaggedErrorClass<ConfigurationError, "ConfigurationError", {
+    readonly _tag: Schema.tag<"ConfigurationError">;
+} & {
+    key: typeof Schema.String;
+    message: typeof Schema.String;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class ConfigurationError extends ConfigurationError_base {
+}
+declare const CacheUnavailableError_base: Schema.TaggedErrorClass<CacheUnavailableError, "CacheUnavailableError", {
+    readonly _tag: Schema.tag<"CacheUnavailableError">;
+} & {
+    cacheMode: Schema.optional<typeof Schema.String>;
+    key: Schema.optional<typeof Schema.String>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class CacheUnavailableError extends CacheUnavailableError_base {
+}
+declare const CacheReadError_base: Schema.TaggedErrorClass<CacheReadError, "CacheReadError", {
+    readonly _tag: Schema.tag<"CacheReadError">;
+} & {
+    key: typeof Schema.String;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class CacheReadError extends CacheReadError_base {
+}
+declare const CacheWriteError_base: Schema.TaggedErrorClass<CacheWriteError, "CacheWriteError", {
+    readonly _tag: Schema.tag<"CacheWriteError">;
+} & {
+    key: typeof Schema.String;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class CacheWriteError extends CacheWriteError_base {
+}
+declare const ProviderAuthError_base: Schema.TaggedErrorClass<ProviderAuthError, "ProviderAuthError", {
+    readonly _tag: Schema.tag<"ProviderAuthError">;
+} & {
+    provider: Schema.optional<typeof Schema.String>;
+    service: Schema.optional<typeof Schema.String>;
+    endpoint: Schema.optional<typeof Schema.String>;
+    url: Schema.optional<typeof Schema.String>;
+    elapsedMs: Schema.optional<typeof Schema.Number>;
+    /**
+     * Seconds the upstream asked us to wait, parsed from its `Retry-After`
+     * header. Set only on a rate-limit error that carries one; surfaced to the
+     * client as the HTTP `Retry-After` header on a single-item 429.
+     */
+    retryAfterSeconds: Schema.optional<typeof Schema.Number>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class ProviderAuthError extends ProviderAuthError_base {
+}
+declare const ProviderQuotaError_base: Schema.TaggedErrorClass<ProviderQuotaError, "ProviderQuotaError", {
+    readonly _tag: Schema.tag<"ProviderQuotaError">;
+} & {
+    provider: Schema.optional<typeof Schema.String>;
+    service: Schema.optional<typeof Schema.String>;
+    endpoint: Schema.optional<typeof Schema.String>;
+    url: Schema.optional<typeof Schema.String>;
+    elapsedMs: Schema.optional<typeof Schema.Number>;
+    /**
+     * Seconds the upstream asked us to wait, parsed from its `Retry-After`
+     * header. Set only on a rate-limit error that carries one; surfaced to the
+     * client as the HTTP `Retry-After` header on a single-item 429.
+     */
+    retryAfterSeconds: Schema.optional<typeof Schema.Number>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class ProviderQuotaError extends ProviderQuotaError_base {
+}
+declare const ProviderRateLimitedError_base: Schema.TaggedErrorClass<ProviderRateLimitedError, "ProviderRateLimitedError", {
+    readonly _tag: Schema.tag<"ProviderRateLimitedError">;
+} & {
+    provider: Schema.optional<typeof Schema.String>;
+    service: Schema.optional<typeof Schema.String>;
+    endpoint: Schema.optional<typeof Schema.String>;
+    url: Schema.optional<typeof Schema.String>;
+    elapsedMs: Schema.optional<typeof Schema.Number>;
+    /**
+     * Seconds the upstream asked us to wait, parsed from its `Retry-After`
+     * header. Set only on a rate-limit error that carries one; surfaced to the
+     * client as the HTTP `Retry-After` header on a single-item 429.
+     */
+    retryAfterSeconds: Schema.optional<typeof Schema.Number>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class ProviderRateLimitedError extends ProviderRateLimitedError_base {
+}
+declare const ProviderTimeoutError_base: Schema.TaggedErrorClass<ProviderTimeoutError, "ProviderTimeoutError", {
+    readonly _tag: Schema.tag<"ProviderTimeoutError">;
+} & {
+    provider: Schema.optional<typeof Schema.String>;
+    service: Schema.optional<typeof Schema.String>;
+    endpoint: Schema.optional<typeof Schema.String>;
+    url: Schema.optional<typeof Schema.String>;
+    elapsedMs: Schema.optional<typeof Schema.Number>;
+    /**
+     * Seconds the upstream asked us to wait, parsed from its `Retry-After`
+     * header. Set only on a rate-limit error that carries one; surfaced to the
+     * client as the HTTP `Retry-After` header on a single-item 429.
+     */
+    retryAfterSeconds: Schema.optional<typeof Schema.Number>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class ProviderTimeoutError extends ProviderTimeoutError_base {
+}
+declare const ProviderUnavailableError_base: Schema.TaggedErrorClass<ProviderUnavailableError, "ProviderUnavailableError", {
+    readonly _tag: Schema.tag<"ProviderUnavailableError">;
+} & {
+    provider: Schema.optional<typeof Schema.String>;
+    service: Schema.optional<typeof Schema.String>;
+    endpoint: Schema.optional<typeof Schema.String>;
+    url: Schema.optional<typeof Schema.String>;
+    elapsedMs: Schema.optional<typeof Schema.Number>;
+    /**
+     * Seconds the upstream asked us to wait, parsed from its `Retry-After`
+     * header. Set only on a rate-limit error that carries one; surfaced to the
+     * client as the HTTP `Retry-After` header on a single-item 429.
+     */
+    retryAfterSeconds: Schema.optional<typeof Schema.Number>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class ProviderUnavailableError extends ProviderUnavailableError_base {
+}
+declare const ProviderSpendCeilingExceededError_base: Schema.TaggedErrorClass<ProviderSpendCeilingExceededError, "ProviderSpendCeilingExceededError", {
+    readonly _tag: Schema.tag<"ProviderSpendCeilingExceededError">;
+} & {
+    provider: Schema.optional<typeof Schema.String>;
+    service: Schema.optional<typeof Schema.String>;
+    endpoint: Schema.optional<typeof Schema.String>;
+    url: Schema.optional<typeof Schema.String>;
+    elapsedMs: Schema.optional<typeof Schema.Number>;
+    /**
+     * Seconds the upstream asked us to wait, parsed from its `Retry-After`
+     * header. Set only on a rate-limit error that carries one; surfaced to the
+     * client as the HTTP `Retry-After` header on a single-item 429.
+     */
+    retryAfterSeconds: Schema.optional<typeof Schema.Number>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+/**
+ * The hard daily provider-spend ceiling (`DAILY_PROVIDER_SPEND_CEILING_CREDITS`)
+ * has been reached for the current UTC day, so the backend halts outbound
+ * provider calls to stop spending. Surfaces as HTTP 503 (service temporarily
+ * unavailable) until the day rolls over or the ceiling is raised. Disabled by
+ * default (ceiling `0`), so this is never raised unless an operator opts in.
+ */
+export declare class ProviderSpendCeilingExceededError extends ProviderSpendCeilingExceededError_base {
+}
+declare const ProviderBadResponseError_base: Schema.TaggedErrorClass<ProviderBadResponseError, "ProviderBadResponseError", {
+    readonly _tag: Schema.tag<"ProviderBadResponseError">;
+} & {
+    provider: Schema.optional<typeof Schema.String>;
+    service: Schema.optional<typeof Schema.String>;
+    endpoint: Schema.optional<typeof Schema.String>;
+    url: Schema.optional<typeof Schema.String>;
+    elapsedMs: Schema.optional<typeof Schema.Number>;
+    /**
+     * Seconds the upstream asked us to wait, parsed from its `Retry-After`
+     * header. Set only on a rate-limit error that carries one; surfaced to the
+     * client as the HTTP `Retry-After` header on a single-item 429.
+     */
+    retryAfterSeconds: Schema.optional<typeof Schema.Number>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class ProviderBadResponseError extends ProviderBadResponseError_base {
+}
+declare const AuthenticationRequiredError_base: Schema.TaggedErrorClass<AuthenticationRequiredError, "AuthenticationRequiredError", {
+    readonly _tag: Schema.tag<"AuthenticationRequiredError">;
+} & {
+    reason: Schema.optional<typeof Schema.String>;
+}>;
+export declare class AuthenticationRequiredError extends AuthenticationRequiredError_base {
+}
+declare const InvalidCredentialError_base: Schema.TaggedErrorClass<InvalidCredentialError, "InvalidCredentialError", {
+    readonly _tag: Schema.tag<"InvalidCredentialError">;
+} & {
+    credential: Schema.optional<typeof Schema.String>;
+    reason: Schema.optional<typeof Schema.String>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class InvalidCredentialError extends InvalidCredentialError_base {
+}
+declare const ForbiddenError_base: Schema.TaggedErrorClass<ForbiddenError, "ForbiddenError", {
+    readonly _tag: Schema.tag<"ForbiddenError">;
+} & {
+    reason: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * The caller authenticated successfully but is not authorized for this
+ * operation — distinct from {@link AuthenticationRequiredError} (no/invalid
+ * credential, 401). Raised by admin-only routes when the authenticated user id
+ * is not in the configured admin allowlist; maps to HTTP 403.
+ */
+export declare class ForbiddenError extends ForbiddenError_base {
+}
+declare const InsufficientScopeError_base: Schema.TaggedErrorClass<InsufficientScopeError, "InsufficientScopeError", {
+    readonly _tag: Schema.tag<"InsufficientScopeError">;
+} & {
+    required: Schema.optional<typeof Schema.String>;
+    reason: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * The caller authenticated successfully but presented an API key whose granted
+ * scopes do not include the capability this route requires — distinct from
+ * {@link ForbiddenError} (admin-allowlist gate). Bearer sessions are full-scope
+ * and never raise this; maps to HTTP 403.
+ */
+export declare class InsufficientScopeError extends InsufficientScopeError_base {
+}
+declare const AccountSuspendedError_base: Schema.TaggedErrorClass<AccountSuspendedError, "AccountSuspendedError", {
+    readonly _tag: Schema.tag<"AccountSuspendedError">;
+} & {
+    userId: typeof Schema.String;
+    reason: Schema.optional<typeof Schema.String>;
+}>;
+export declare class AccountSuspendedError extends AccountSuspendedError_base {
+}
+declare const SubscriptionRequiredError_base: Schema.TaggedErrorClass<SubscriptionRequiredError, "SubscriptionRequiredError", {
+    readonly _tag: Schema.tag<"SubscriptionRequiredError">;
+} & {
+    userId: Schema.optional<typeof Schema.String>;
+    status: Schema.optional<typeof Schema.String>;
+    reason: Schema.optional<typeof Schema.String>;
+}>;
+export declare class SubscriptionRequiredError extends SubscriptionRequiredError_base {
+}
+declare const QuotaExceededError_base: Schema.TaggedErrorClass<QuotaExceededError, "QuotaExceededError", {
+    readonly _tag: Schema.tag<"QuotaExceededError">;
+} & {
+    userId: Schema.optional<typeof Schema.String>;
+    plan: Schema.optional<typeof Schema.String>;
+    usageCount: Schema.optional<typeof Schema.Number>;
+    limit: Schema.optional<typeof Schema.Number>;
+    /**
+     * Seconds until the user's quota window (their subscription period) resets,
+     * surfaced to the client as the HTTP `Retry-After` header on the quota 429.
+     * Reuses the {@link ErrorContextSchema} field name/semantics.
+     */
+    retryAfterSeconds: Schema.optional<typeof Schema.Number>;
+}>;
+export declare class QuotaExceededError extends QuotaExceededError_base {
+}
+declare const BillingStateError_base: Schema.TaggedErrorClass<BillingStateError, "BillingStateError", {
+    readonly _tag: Schema.tag<"BillingStateError">;
+} & {
+    operation: Schema.optional<typeof Schema.String>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class BillingStateError extends BillingStateError_base {
+}
+declare const AllStrategiesFailedError_base: Schema.TaggedErrorClass<AllStrategiesFailedError, "AllStrategiesFailedError", {
+    readonly _tag: Schema.tag<"AllStrategiesFailedError">;
+} & {
+    url: typeof Schema.String;
+    attempts: Schema.Array$<Schema.Struct<{
+        provider: Schema.optional<typeof Schema.String>;
+        service: Schema.optional<typeof Schema.String>;
+        endpoint: Schema.optional<typeof Schema.String>;
+        url: Schema.optional<typeof Schema.String>;
+        elapsedMs: Schema.optional<typeof Schema.Number>;
+        /**
+         * Seconds the upstream asked us to wait, parsed from its `Retry-After`
+         * header. Set only on a rate-limit error that carries one; surfaced to the
+         * client as the HTTP `Retry-After` header on a single-item 429.
+         */
+        retryAfterSeconds: Schema.optional<typeof Schema.Number>;
+        cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+    }>>;
+}>;
+export declare class AllStrategiesFailedError extends AllStrategiesFailedError_base {
+}
+declare const FallbackExhaustedError_base: Schema.TaggedErrorClass<FallbackExhaustedError, "FallbackExhaustedError", {
+    readonly _tag: Schema.tag<"FallbackExhaustedError">;
+} & {
+    attemptedProviders: Schema.Array$<typeof Schema.String>;
+    lastError: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class FallbackExhaustedError extends FallbackExhaustedError_base {
+}
+declare const RenderError_base: Schema.TaggedErrorClass<RenderError, "RenderError", {
+    readonly _tag: Schema.tag<"RenderError">;
+} & {
+    strategy: Schema.optional<typeof Schema.String>;
+    artifactPath: Schema.optional<typeof Schema.String>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class RenderError extends RenderError_base {
+}
+declare const ArtifactWriteError_base: Schema.TaggedErrorClass<ArtifactWriteError, "ArtifactWriteError", {
+    readonly _tag: Schema.tag<"ArtifactWriteError">;
+} & {
+    runId: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class ArtifactWriteError extends ArtifactWriteError_base {
+}
+declare const ClientCancelledError_base: Schema.TaggedErrorClass<ClientCancelledError, "ClientCancelledError", {
+    readonly _tag: Schema.tag<"ClientCancelledError">;
+} & {
+    runId: Schema.optional<typeof Schema.String>;
+    cause: Schema.optional<Schema.Schema<JsonValueSchema, JsonValueSchema, never>>;
+}>;
+export declare class ClientCancelledError extends ClientCancelledError_base {
+}
+export type ApplicationError = InputValidationError | UnsupportedUrlError | UnsafeUrlError | EndpointDetectionError | NotFoundError | ConfigurationError | CacheUnavailableError | CacheReadError | CacheWriteError | ProviderAuthError | ProviderQuotaError | ProviderRateLimitedError | ProviderTimeoutError | ProviderUnavailableError | ProviderSpendCeilingExceededError | ProviderBadResponseError | AuthenticationRequiredError | InvalidCredentialError | ForbiddenError | InsufficientScopeError | AccountSuspendedError | SubscriptionRequiredError | QuotaExceededError | BillingStateError | AllStrategiesFailedError | FallbackExhaustedError | RenderError | ArtifactWriteError | ClientCancelledError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/domain/errors.d.ts.map

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