@macpaw/ai-sdk 0.1.0

package/dist/chunk-KGOVQRMH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gateway-errors.ts"],"names":[],"mappings":"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","file":"chunk-KGOVQRMH.js","sourcesContent":["/**\n * Error types for the AI Gateway SDK.\n *\n * Combines error classes, API codes, and response shapes in one place.\n * parseErrorResponse throws the SPECIFIC subclass (AuthError, CreditsError, etc.)\n * so that `instanceof` checks work correctly in consumer code.\n */\n\n// ─── API Codes ────────────────────────────────────────────────────────────────\n\ntype ObjectValues<T> = T[keyof T];\n\n/** Raw error codes returned by the AI Gateway HTTP API. */\nexport const GatewayApiCode = {\n  BadRequest: 'BAD_REQUEST',\n  Unauthorized: 'UNAUTHORIZED',\n  InsufficientCredits: 'INSUFFICIENT_CREDITS',\n  Forbidden: 'FORBIDDEN',\n  Validation: 'VALIDATION',\n  RateLimitExceeded: 'RATE_LIMIT_EXCEEDED',\n  InternalServerError: 'INTERNAL_SERVER_ERROR',\n  ServiceUnavailable: 'SERVICE_UNAVAILABLE',\n  Timeout: 'TIMEOUT',\n  NotFound: 'NOT_FOUND',\n  Conflict: 'CONFLICT',\n} as const;\nexport type GatewayApiCode = ObjectValues<typeof GatewayApiCode>;\n\n/** Normalized error codes for app handling. */\nexport const ErrorCode = {\n  AuthRequired: 'AUTH_REQUIRED',\n  InsufficientCredits: 'INSUFFICIENT_CREDITS',\n  SubscriptionExpired: 'SUBSCRIPTION_EXPIRED',\n  ModelNotAllowed: 'MODEL_NOT_ALLOWED',\n  RateLimited: 'RATE_LIMITED',\n  BadRequest: 'BAD_REQUEST',\n  Validation: 'VALIDATION',\n  Forbidden: 'FORBIDDEN',\n  InternalServerError: 'INTERNAL_SERVER_ERROR',\n  ServiceUnavailable: 'SERVICE_UNAVAILABLE',\n  Timeout: 'TIMEOUT',\n  NotFound: 'NOT_FOUND',\n  Conflict: 'CONFLICT',\n} as const;\nexport type ErrorCode = ObjectValues<typeof ErrorCode>;\n\n// ─── Error Shapes ─────────────────────────────────────────────────────────────\n\nexport interface GatewayApiErrorItem {\n  target?: string;\n  property?: string;\n  constraints?: string[];\n  message?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface GatewayApiErrorResponse {\n  statusCode: number;\n  message: string;\n  timestamp: string;\n  code: GatewayApiCode;\n  path?: string;\n  errors?: GatewayApiErrorItem[];\n  request_id?: string;\n}\n\nexport interface OpenAIErrorResponse {\n  error: {\n    message: string;\n    type?: string | null;\n    code?: string | null;\n    param?: string | null;\n  };\n  request_id?: string;\n}\n\n// ─── Error Classes ────────────────────────────────────────────────────────────\n\nexport interface NormalizedErrorMetadata {\n  paymentUrl?: string;\n  /** Suggested delay before retrying, in seconds (from server's `Retry-After`). */\n  retryAfter?: number;\n  requestId?: string;\n  path?: string;\n  timestamp?: string;\n  errors?: GatewayApiErrorItem[];\n}\n\nexport class AIGatewayError extends Error {\n  readonly code: ErrorCode;\n  readonly statusCode: number;\n  readonly metadata: NormalizedErrorMetadata;\n\n  constructor(\n    message: string,\n    code: ErrorCode,\n    statusCode: number,\n    metadata: NormalizedErrorMetadata = {},\n    options?: { cause?: unknown },\n  ) {\n    super(message);\n    this.name = 'AIGatewayError';\n    this.code = code;\n    this.statusCode = statusCode;\n    this.metadata = metadata;\n    if (options?.cause !== undefined) {\n      (this as Error & { cause?: unknown }).cause = options.cause;\n    }\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get paymentUrl(): string | undefined {\n    return this.metadata.paymentUrl;\n  }\n\n  /** Suggested delay before retrying, in seconds. `undefined` if not provided by the server. */\n  get retryAfter(): number | undefined {\n    return this.metadata.retryAfter;\n  }\n\n  get requestId(): string | undefined {\n    return this.metadata.requestId;\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      statusCode: this.statusCode,\n      metadata: this.metadata,\n    };\n  }\n}\n\nexport class AuthError extends AIGatewayError {\n  constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: { cause?: unknown }) {\n    super(message, ErrorCode.AuthRequired, statusCode, metadata, options);\n    this.name = 'AuthError';\n  }\n}\n\nexport class CreditsError extends AIGatewayError {\n  constructor(\n    message: string,\n    statusCode: number,\n    code: typeof ErrorCode.InsufficientCredits | typeof ErrorCode.SubscriptionExpired,\n    metadata?: NormalizedErrorMetadata,\n    options?: { cause?: unknown },\n  ) {\n    super(message, code, statusCode, metadata, options);\n    this.name = 'CreditsError';\n  }\n}\n\nexport class RateLimitError extends AIGatewayError {\n  constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: { cause?: unknown }) {\n    super(message, ErrorCode.RateLimited, statusCode, metadata, options);\n    this.name = 'RateLimitError';\n  }\n}\n\nexport class ModelNotAllowedError extends AIGatewayError {\n  constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: { cause?: unknown }) {\n    super(message, ErrorCode.ModelNotAllowed, statusCode, metadata, options);\n    this.name = 'ModelNotAllowedError';\n  }\n}\n\nexport class GatewayValidationError extends AIGatewayError {\n  constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: { cause?: unknown }) {\n    super(message, ErrorCode.Validation, statusCode, metadata, options);\n    this.name = 'GatewayValidationError';\n  }\n}\n\n/** Type guard: returns true if the value is an AIGatewayError (or any subclass). */\nexport function isAIGatewayError(value: unknown): value is AIGatewayError {\n  return value instanceof AIGatewayError;\n}\n\n// ─── Internal error factories ─────────────────────────────────────────────────\n\nfunction mapGatewayApiCodeToNormalized(code: string, statusCode: number): ErrorCode {\n  switch (code) {\n    case GatewayApiCode.Unauthorized:\n      return ErrorCode.AuthRequired;\n    case GatewayApiCode.InsufficientCredits:\n      return statusCode === 402 ? ErrorCode.InsufficientCredits : ErrorCode.SubscriptionExpired;\n    case GatewayApiCode.Forbidden:\n      return ErrorCode.ModelNotAllowed;\n    case GatewayApiCode.RateLimitExceeded:\n      return ErrorCode.RateLimited;\n    case GatewayApiCode.BadRequest:\n      return ErrorCode.BadRequest;\n    case GatewayApiCode.Validation:\n      return ErrorCode.Validation;\n    case GatewayApiCode.InternalServerError:\n      return ErrorCode.InternalServerError;\n    case GatewayApiCode.ServiceUnavailable:\n      return ErrorCode.ServiceUnavailable;\n    case GatewayApiCode.Timeout:\n      return ErrorCode.Timeout;\n    case GatewayApiCode.NotFound:\n      return ErrorCode.NotFound;\n    case GatewayApiCode.Conflict:\n      return ErrorCode.Conflict;\n    default:\n      return statusCode >= 500 ? ErrorCode.InternalServerError : ErrorCode.BadRequest;\n  }\n}\n\nfunction mapOpenAIErrorToNormalized(type?: string | null, statusCode?: number): ErrorCode {\n  if (type === 'authentication_error') return ErrorCode.AuthRequired;\n  if (type === 'rate_limit_error') return ErrorCode.RateLimited;\n  if (type === 'team_model_access_denied') return ErrorCode.ModelNotAllowed;\n  if (type === 'api_error') return ErrorCode.InternalServerError;\n  if (type === 'invalid_request_error') return ErrorCode.BadRequest;\n  if (statusCode === 401) return ErrorCode.AuthRequired;\n  if (statusCode === 429) return ErrorCode.RateLimited;\n  if (statusCode === 403) return ErrorCode.ModelNotAllowed;\n  // Unknown OpenAI error.type: map by status category rather than defaulting to 5xx.\n  return statusCode !== undefined && statusCode >= 400 && statusCode < 500\n    ? ErrorCode.BadRequest\n    : ErrorCode.InternalServerError;\n}\n\nfunction parseRetryAfterHeader(value: string): number | undefined {\n  const seconds = Number(value);\n  if (!Number.isNaN(seconds) && seconds >= 0) return seconds;\n  const date = Date.parse(value);\n  if (!Number.isNaN(date)) {\n    const delta = Math.ceil((date - Date.now()) / 1000);\n    return delta > 0 ? delta : 0;\n  }\n  return undefined;\n}\n\nfunction createTypedError(\n  message: string,\n  code: ErrorCode,\n  statusCode: number,\n  meta: NormalizedErrorMetadata,\n  options?: { cause?: unknown },\n): AIGatewayError {\n  switch (code) {\n    case ErrorCode.AuthRequired:\n      return new AuthError(message, statusCode, meta, options);\n    case ErrorCode.InsufficientCredits:\n    case ErrorCode.SubscriptionExpired:\n      return new CreditsError(message, statusCode, code, meta, options);\n    case ErrorCode.RateLimited:\n      return new RateLimitError(message, statusCode, meta, options);\n    case ErrorCode.ModelNotAllowed:\n      return new ModelNotAllowedError(message, statusCode, meta, options);\n    case ErrorCode.Validation:\n      return new GatewayValidationError(message, statusCode, meta, options);\n    default:\n      return new AIGatewayError(message, code, statusCode, meta, options);\n  }\n}\n\n// ─── Parse functions ──────────────────────────────────────────────────────────\n\nexport async function parseErrorResponseFromResponse(response: Response): Promise<never> {\n  const contentType = response.headers.get('Content-Type') ?? '';\n  let body: unknown;\n\n  if (contentType.includes('application/json')) {\n    try {\n      body = await response.json();\n    } catch {\n      body = { message: response.statusText };\n    }\n  } else {\n    body = { message: await response.text().catch(() => response.statusText) };\n  }\n\n  const retryAfterHeader = response.headers.get('Retry-After');\n  let headerRetryAfter: number | undefined;\n  if (retryAfterHeader) {\n    headerRetryAfter = parseRetryAfterHeader(retryAfterHeader);\n  }\n\n  try {\n    parseErrorResponse(response.status, body);\n  } catch (error) {\n    if (error instanceof AIGatewayError && error.retryAfter == null && headerRetryAfter != null) {\n      throw createTypedError(\n        error.message,\n        error.code,\n        error.statusCode,\n        { ...error.metadata, retryAfter: headerRetryAfter },\n        error.cause != null ? { cause: error.cause } : undefined,\n      );\n    }\n    throw error;\n  }\n}\n\n/**\n * Normalize an SSE `event: error` payload into a typed AIGatewayError subclass.\n */\nexport function parseStreamErrorPayload(payload: {\n  message?: string;\n  code?: string;\n  statusCode?: number;\n  metadata?: Record<string, unknown>;\n}): AIGatewayError {\n  const statusCode = payload.statusCode ?? 500;\n  const rawCode = payload.code ?? 'INTERNAL_SERVER_ERROR';\n  const message = payload.message ?? 'Stream error';\n  const meta: NormalizedErrorMetadata = {};\n  if (payload.metadata) {\n    if (typeof payload.metadata.paymentUrl === 'string') meta.paymentUrl = payload.metadata.paymentUrl;\n    if (typeof payload.metadata.retryAfter === 'number') meta.retryAfter = payload.metadata.retryAfter;\n    if (typeof payload.metadata.requestId === 'string') meta.requestId = payload.metadata.requestId;\n  }\n  const normalizedCode = mapGatewayApiCodeToNormalized(rawCode, statusCode);\n  return createTypedError(message, normalizedCode, statusCode, meta);\n}\n\n/**\n * Parse error response body and throw appropriate AIGatewayError subclass.\n * Handles both Gateway API format and OpenAI proxy format.\n */\nexport function parseErrorResponse(statusCode: number, body: unknown): never {\n  const meta: NormalizedErrorMetadata = {};\n\n  if (body && typeof body === 'object') {\n    if ('request_id' in body && typeof (body as { request_id?: string }).request_id === 'string') {\n      meta.requestId = (body as { request_id: string }).request_id;\n    }\n    if ('path' in body && typeof (body as { path?: string }).path === 'string') {\n      meta.path = (body as { path: string }).path;\n    }\n    if ('timestamp' in body && typeof (body as { timestamp?: string }).timestamp === 'string') {\n      meta.timestamp = (body as { timestamp: string }).timestamp;\n    }\n  }\n\n  const gatewayBody = body as GatewayApiErrorResponse | undefined;\n  if (gatewayBody?.statusCode != null && typeof gatewayBody.message === 'string' && gatewayBody.code) {\n    const code = mapGatewayApiCodeToNormalized(gatewayBody.code, gatewayBody.statusCode);\n    if (gatewayBody.errors?.length) meta.errors = gatewayBody.errors;\n    const firstError = gatewayBody.errors?.[0];\n    if (firstError?.metadata) {\n      if (typeof firstError.metadata.paymentUrl === 'string') meta.paymentUrl = firstError.metadata.paymentUrl;\n      if (typeof firstError.metadata.retryAfter === 'number') meta.retryAfter = firstError.metadata.retryAfter;\n    }\n    throw createTypedError(gatewayBody.message, code, gatewayBody.statusCode, meta);\n  }\n\n  const oai = body as OpenAIErrorResponse | undefined;\n  if (oai?.error?.message) {\n    const code = mapOpenAIErrorToNormalized(oai.error.type, statusCode);\n    if (oai.request_id) meta.requestId = oai.request_id;\n    throw createTypedError(oai.error.message, code, statusCode, meta);\n  }\n\n  const message =\n    typeof (body as { message?: string })?.message === 'string'\n      ? (body as { message: string }).message\n      : `Request failed with status ${statusCode}`;\n\n  let fallbackCode: ErrorCode;\n  if (statusCode === 401) fallbackCode = ErrorCode.AuthRequired;\n  else if (statusCode === 403) fallbackCode = ErrorCode.Forbidden;\n  else if (statusCode === 429) fallbackCode = ErrorCode.RateLimited;\n  else if (statusCode >= 500) fallbackCode = ErrorCode.InternalServerError;\n  else fallbackCode = ErrorCode.BadRequest;\n\n  throw createTypedError(message, fallbackCode, statusCode, meta);\n}\n"]}

package/dist/chunk-N26BDEG5.cjs

@@ -0,0 +1,302 @@
+'use strict';
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __decoratorStart = (base) => [, , , __create(base?.[__knownSymbol("metadata")] ?? null)];
+var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
+var __expectFn = (fn) => fn !== void 0 && typeof fn !== "function" ? __typeError("Function expected") : fn;
+var __decoratorContext = (kind, name, done, metadata, fns) => ({ kind: __decoratorStrings[kind], name, metadata, addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null)) });
+var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
+var __runInitializers = (array, flags, self, value) => {
+  for (var i = 0, fns = array[flags >> 1], n = fns && fns.length; i < n; i++) flags & 1 ? fns[i].call(self) : value = fns[i].call(self, value);
+  return value;
+};
+var __decorateElement = (array, flags, name, decorators, target, extra) => {
+  var fn, it, done, ctx, access, k = flags & 7, s = !!(flags & 8), p = !!(flags & 16);
+  var j = k > 3 ? array.length + 1 : k ? s ? 1 : 2 : 0, key = __decoratorStrings[k + 5];
+  var initializers = k > 3 && (array[j - 1] = []), extraInitializers = array[j] || (array[j] = []);
+  var desc = k && (!p && !s && (target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(k < 4 ? target : { get [name]() {
+    return __privateGet(this, extra);
+  }, set [name](x) {
+    return __privateSet(this, extra, x);
+  } }, name));
+  k ? p && k < 4 && __name(extra, (k > 2 ? "set " : k > 1 ? "get " : "") + name) : __name(target, name);
+  for (var i = decorators.length - 1; i >= 0; i--) {
+    ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
+    if (k) {
+      ctx.static = s, ctx.private = p, access = ctx.access = { has: p ? (x) => __privateIn(target, x) : (x) => name in x };
+      if (k ^ 3) access.get = p ? (x) => (k ^ 1 ? __privateGet : __privateMethod)(x, target, k ^ 4 ? extra : desc.get) : (x) => x[name];
+      if (k > 2) access.set = p ? (x, y) => __privateSet(x, target, y, k ^ 4 ? extra : desc.set) : (x, y) => x[name] = y;
+    }
+    it = (0, decorators[i])(k ? k < 4 ? p ? extra : desc[key] : k > 4 ? void 0 : { get: desc.get, set: desc.set } : target, ctx), done._ = 1;
+    if (k ^ 4 || it === void 0) __expectFn(it) && (k > 4 ? initializers.unshift(it) : k ? p ? extra = it : desc[key] = it : target = it);
+    else if (typeof it !== "object" || it === null) __typeError("Object expected");
+    else __expectFn(fn = it.get) && (desc.get = fn), __expectFn(fn = it.set) && (desc.set = fn), __expectFn(fn = it.init) && initializers.unshift(fn);
+  }
+  return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+// src/gateway-errors.ts
+var GatewayApiCode = {
+  BadRequest: "BAD_REQUEST",
+  Unauthorized: "UNAUTHORIZED",
+  InsufficientCredits: "INSUFFICIENT_CREDITS",
+  Forbidden: "FORBIDDEN",
+  Validation: "VALIDATION",
+  RateLimitExceeded: "RATE_LIMIT_EXCEEDED",
+  InternalServerError: "INTERNAL_SERVER_ERROR",
+  ServiceUnavailable: "SERVICE_UNAVAILABLE",
+  Timeout: "TIMEOUT",
+  NotFound: "NOT_FOUND",
+  Conflict: "CONFLICT"
+};
+var ErrorCode = {
+  AuthRequired: "AUTH_REQUIRED",
+  InsufficientCredits: "INSUFFICIENT_CREDITS",
+  SubscriptionExpired: "SUBSCRIPTION_EXPIRED",
+  ModelNotAllowed: "MODEL_NOT_ALLOWED",
+  RateLimited: "RATE_LIMITED",
+  BadRequest: "BAD_REQUEST",
+  Validation: "VALIDATION",
+  Forbidden: "FORBIDDEN",
+  InternalServerError: "INTERNAL_SERVER_ERROR",
+  ServiceUnavailable: "SERVICE_UNAVAILABLE",
+  Timeout: "TIMEOUT",
+  NotFound: "NOT_FOUND",
+  Conflict: "CONFLICT"
+};
+var AIGatewayError = class extends Error {
+  constructor(message, code, statusCode, metadata = {}, options) {
+    super(message);
+    __publicField(this, "code");
+    __publicField(this, "statusCode");
+    __publicField(this, "metadata");
+    this.name = "AIGatewayError";
+    this.code = code;
+    this.statusCode = statusCode;
+    this.metadata = metadata;
+    if (options?.cause !== void 0) {
+      this.cause = options.cause;
+    }
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  get paymentUrl() {
+    return this.metadata.paymentUrl;
+  }
+  /** Suggested delay before retrying, in seconds. `undefined` if not provided by the server. */
+  get retryAfter() {
+    return this.metadata.retryAfter;
+  }
+  get requestId() {
+    return this.metadata.requestId;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      statusCode: this.statusCode,
+      metadata: this.metadata
+    };
+  }
+};
+var AuthError = class extends AIGatewayError {
+  constructor(message, statusCode, metadata, options) {
+    super(message, ErrorCode.AuthRequired, statusCode, metadata, options);
+    this.name = "AuthError";
+  }
+};
+var CreditsError = class extends AIGatewayError {
+  constructor(message, statusCode, code, metadata, options) {
+    super(message, code, statusCode, metadata, options);
+    this.name = "CreditsError";
+  }
+};
+var RateLimitError = class extends AIGatewayError {
+  constructor(message, statusCode, metadata, options) {
+    super(message, ErrorCode.RateLimited, statusCode, metadata, options);
+    this.name = "RateLimitError";
+  }
+};
+var ModelNotAllowedError = class extends AIGatewayError {
+  constructor(message, statusCode, metadata, options) {
+    super(message, ErrorCode.ModelNotAllowed, statusCode, metadata, options);
+    this.name = "ModelNotAllowedError";
+  }
+};
+var GatewayValidationError = class extends AIGatewayError {
+  constructor(message, statusCode, metadata, options) {
+    super(message, ErrorCode.Validation, statusCode, metadata, options);
+    this.name = "GatewayValidationError";
+  }
+};
+function isAIGatewayError(value) {
+  return value instanceof AIGatewayError;
+}
+function mapGatewayApiCodeToNormalized(code, statusCode) {
+  switch (code) {
+    case GatewayApiCode.Unauthorized:
+      return ErrorCode.AuthRequired;
+    case GatewayApiCode.InsufficientCredits:
+      return statusCode === 402 ? ErrorCode.InsufficientCredits : ErrorCode.SubscriptionExpired;
+    case GatewayApiCode.Forbidden:
+      return ErrorCode.ModelNotAllowed;
+    case GatewayApiCode.RateLimitExceeded:
+      return ErrorCode.RateLimited;
+    case GatewayApiCode.BadRequest:
+      return ErrorCode.BadRequest;
+    case GatewayApiCode.Validation:
+      return ErrorCode.Validation;
+    case GatewayApiCode.InternalServerError:
+      return ErrorCode.InternalServerError;
+    case GatewayApiCode.ServiceUnavailable:
+      return ErrorCode.ServiceUnavailable;
+    case GatewayApiCode.Timeout:
+      return ErrorCode.Timeout;
+    case GatewayApiCode.NotFound:
+      return ErrorCode.NotFound;
+    case GatewayApiCode.Conflict:
+      return ErrorCode.Conflict;
+    default:
+      return statusCode >= 500 ? ErrorCode.InternalServerError : ErrorCode.BadRequest;
+  }
+}
+function mapOpenAIErrorToNormalized(type, statusCode) {
+  if (type === "authentication_error") return ErrorCode.AuthRequired;
+  if (type === "rate_limit_error") return ErrorCode.RateLimited;
+  if (type === "team_model_access_denied") return ErrorCode.ModelNotAllowed;
+  if (type === "api_error") return ErrorCode.InternalServerError;
+  if (type === "invalid_request_error") return ErrorCode.BadRequest;
+  if (statusCode === 401) return ErrorCode.AuthRequired;
+  if (statusCode === 429) return ErrorCode.RateLimited;
+  if (statusCode === 403) return ErrorCode.ModelNotAllowed;
+  return statusCode !== void 0 && statusCode >= 400 && statusCode < 500 ? ErrorCode.BadRequest : ErrorCode.InternalServerError;
+}
+function parseRetryAfterHeader(value) {
+  const seconds = Number(value);
+  if (!Number.isNaN(seconds) && seconds >= 0) return seconds;
+  const date = Date.parse(value);
+  if (!Number.isNaN(date)) {
+    const delta = Math.ceil((date - Date.now()) / 1e3);
+    return delta > 0 ? delta : 0;
+  }
+  return void 0;
+}
+function createTypedError(message, code, statusCode, meta, options) {
+  switch (code) {
+    case ErrorCode.AuthRequired:
+      return new AuthError(message, statusCode, meta, options);
+    case ErrorCode.InsufficientCredits:
+    case ErrorCode.SubscriptionExpired:
+      return new CreditsError(message, statusCode, code, meta, options);
+    case ErrorCode.RateLimited:
+      return new RateLimitError(message, statusCode, meta, options);
+    case ErrorCode.ModelNotAllowed:
+      return new ModelNotAllowedError(message, statusCode, meta, options);
+    case ErrorCode.Validation:
+      return new GatewayValidationError(message, statusCode, meta, options);
+    default:
+      return new AIGatewayError(message, code, statusCode, meta, options);
+  }
+}
+async function parseErrorResponseFromResponse(response) {
+  const contentType = response.headers.get("Content-Type") ?? "";
+  let body;
+  if (contentType.includes("application/json")) {
+    try {
+      body = await response.json();
+    } catch {
+      body = { message: response.statusText };
+    }
+  } else {
+    body = { message: await response.text().catch(() => response.statusText) };
+  }
+  const retryAfterHeader = response.headers.get("Retry-After");
+  let headerRetryAfter;
+  if (retryAfterHeader) {
+    headerRetryAfter = parseRetryAfterHeader(retryAfterHeader);
+  }
+  try {
+    parseErrorResponse(response.status, body);
+  } catch (error) {
+    if (error instanceof AIGatewayError && error.retryAfter == null && headerRetryAfter != null) {
+      throw createTypedError(
+        error.message,
+        error.code,
+        error.statusCode,
+        { ...error.metadata, retryAfter: headerRetryAfter },
+        error.cause != null ? { cause: error.cause } : void 0
+      );
+    }
+    throw error;
+  }
+}
+function parseErrorResponse(statusCode, body) {
+  const meta = {};
+  if (body && typeof body === "object") {
+    if ("request_id" in body && typeof body.request_id === "string") {
+      meta.requestId = body.request_id;
+    }
+    if ("path" in body && typeof body.path === "string") {
+      meta.path = body.path;
+    }
+    if ("timestamp" in body && typeof body.timestamp === "string") {
+      meta.timestamp = body.timestamp;
+    }
+  }
+  const gatewayBody = body;
+  if (gatewayBody?.statusCode != null && typeof gatewayBody.message === "string" && gatewayBody.code) {
+    const code = mapGatewayApiCodeToNormalized(gatewayBody.code, gatewayBody.statusCode);
+    if (gatewayBody.errors?.length) meta.errors = gatewayBody.errors;
+    const firstError = gatewayBody.errors?.[0];
+    if (firstError?.metadata) {
+      if (typeof firstError.metadata.paymentUrl === "string") meta.paymentUrl = firstError.metadata.paymentUrl;
+      if (typeof firstError.metadata.retryAfter === "number") meta.retryAfter = firstError.metadata.retryAfter;
+    }
+    throw createTypedError(gatewayBody.message, code, gatewayBody.statusCode, meta);
+  }
+  const oai = body;
+  if (oai?.error?.message) {
+    const code = mapOpenAIErrorToNormalized(oai.error.type, statusCode);
+    if (oai.request_id) meta.requestId = oai.request_id;
+    throw createTypedError(oai.error.message, code, statusCode, meta);
+  }
+  const message = typeof body?.message === "string" ? body.message : `Request failed with status ${statusCode}`;
+  let fallbackCode;
+  if (statusCode === 401) fallbackCode = ErrorCode.AuthRequired;
+  else if (statusCode === 403) fallbackCode = ErrorCode.Forbidden;
+  else if (statusCode === 429) fallbackCode = ErrorCode.RateLimited;
+  else if (statusCode >= 500) fallbackCode = ErrorCode.InternalServerError;
+  else fallbackCode = ErrorCode.BadRequest;
+  throw createTypedError(message, fallbackCode, statusCode, meta);
+}
+
+exports.AIGatewayError = AIGatewayError;
+exports.AuthError = AuthError;
+exports.CreditsError = CreditsError;
+exports.ErrorCode = ErrorCode;
+exports.GatewayApiCode = GatewayApiCode;
+exports.GatewayValidationError = GatewayValidationError;
+exports.ModelNotAllowedError = ModelNotAllowedError;
+exports.RateLimitError = RateLimitError;
+exports.__decorateElement = __decorateElement;
+exports.__decoratorStart = __decoratorStart;
+exports.__runInitializers = __runInitializers;
+exports.isAIGatewayError = isAIGatewayError;
+exports.parseErrorResponse = parseErrorResponse;
+exports.parseErrorResponseFromResponse = parseErrorResponseFromResponse;
+//# sourceMappingURL=chunk-N26BDEG5.cjs.map
+//# sourceMappingURL=chunk-N26BDEG5.cjs.map

package/dist/chunk-N26BDEG5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gateway-errors.ts"],"names":[],"mappings":"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","file":"chunk-N26BDEG5.cjs","sourcesContent":["/**\n * Error types for the AI Gateway SDK.\n *\n * Combines error classes, API codes, and response shapes in one place.\n * parseErrorResponse throws the SPECIFIC subclass (AuthError, CreditsError, etc.)\n * so that `instanceof` checks work correctly in consumer code.\n */\n\n// ─── API Codes ────────────────────────────────────────────────────────────────\n\ntype ObjectValues<T> = T[keyof T];\n\n/** Raw error codes returned by the AI Gateway HTTP API. */\nexport const GatewayApiCode = {\n  BadRequest: 'BAD_REQUEST',\n  Unauthorized: 'UNAUTHORIZED',\n  InsufficientCredits: 'INSUFFICIENT_CREDITS',\n  Forbidden: 'FORBIDDEN',\n  Validation: 'VALIDATION',\n  RateLimitExceeded: 'RATE_LIMIT_EXCEEDED',\n  InternalServerError: 'INTERNAL_SERVER_ERROR',\n  ServiceUnavailable: 'SERVICE_UNAVAILABLE',\n  Timeout: 'TIMEOUT',\n  NotFound: 'NOT_FOUND',\n  Conflict: 'CONFLICT',\n} as const;\nexport type GatewayApiCode = ObjectValues<typeof GatewayApiCode>;\n\n/** Normalized error codes for app handling. */\nexport const ErrorCode = {\n  AuthRequired: 'AUTH_REQUIRED',\n  InsufficientCredits: 'INSUFFICIENT_CREDITS',\n  SubscriptionExpired: 'SUBSCRIPTION_EXPIRED',\n  ModelNotAllowed: 'MODEL_NOT_ALLOWED',\n  RateLimited: 'RATE_LIMITED',\n  BadRequest: 'BAD_REQUEST',\n  Validation: 'VALIDATION',\n  Forbidden: 'FORBIDDEN',\n  InternalServerError: 'INTERNAL_SERVER_ERROR',\n  ServiceUnavailable: 'SERVICE_UNAVAILABLE',\n  Timeout: 'TIMEOUT',\n  NotFound: 'NOT_FOUND',\n  Conflict: 'CONFLICT',\n} as const;\nexport type ErrorCode = ObjectValues<typeof ErrorCode>;\n\n// ─── Error Shapes ─────────────────────────────────────────────────────────────\n\nexport interface GatewayApiErrorItem {\n  target?: string;\n  property?: string;\n  constraints?: string[];\n  message?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface GatewayApiErrorResponse {\n  statusCode: number;\n  message: string;\n  timestamp: string;\n  code: GatewayApiCode;\n  path?: string;\n  errors?: GatewayApiErrorItem[];\n  request_id?: string;\n}\n\nexport interface OpenAIErrorResponse {\n  error: {\n    message: string;\n    type?: string | null;\n    code?: string | null;\n    param?: string | null;\n  };\n  request_id?: string;\n}\n\n// ─── Error Classes ────────────────────────────────────────────────────────────\n\nexport interface NormalizedErrorMetadata {\n  paymentUrl?: string;\n  /** Suggested delay before retrying, in seconds (from server's `Retry-After`). */\n  retryAfter?: number;\n  requestId?: string;\n  path?: string;\n  timestamp?: string;\n  errors?: GatewayApiErrorItem[];\n}\n\nexport class AIGatewayError extends Error {\n  readonly code: ErrorCode;\n  readonly statusCode: number;\n  readonly metadata: NormalizedErrorMetadata;\n\n  constructor(\n    message: string,\n    code: ErrorCode,\n    statusCode: number,\n    metadata: NormalizedErrorMetadata = {},\n    options?: { cause?: unknown },\n  ) {\n    super(message);\n    this.name = 'AIGatewayError';\n    this.code = code;\n    this.statusCode = statusCode;\n    this.metadata = metadata;\n    if (options?.cause !== undefined) {\n      (this as Error & { cause?: unknown }).cause = options.cause;\n    }\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get paymentUrl(): string | undefined {\n    return this.metadata.paymentUrl;\n  }\n\n  /** Suggested delay before retrying, in seconds. `undefined` if not provided by the server. */\n  get retryAfter(): number | undefined {\n    return this.metadata.retryAfter;\n  }\n\n  get requestId(): string | undefined {\n    return this.metadata.requestId;\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      statusCode: this.statusCode,\n      metadata: this.metadata,\n    };\n  }\n}\n\nexport class AuthError extends AIGatewayError {\n  constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: { cause?: unknown }) {\n    super(message, ErrorCode.AuthRequired, statusCode, metadata, options);\n    this.name = 'AuthError';\n  }\n}\n\nexport class CreditsError extends AIGatewayError {\n  constructor(\n    message: string,\n    statusCode: number,\n    code: typeof ErrorCode.InsufficientCredits | typeof ErrorCode.SubscriptionExpired,\n    metadata?: NormalizedErrorMetadata,\n    options?: { cause?: unknown },\n  ) {\n    super(message, code, statusCode, metadata, options);\n    this.name = 'CreditsError';\n  }\n}\n\nexport class RateLimitError extends AIGatewayError {\n  constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: { cause?: unknown }) {\n    super(message, ErrorCode.RateLimited, statusCode, metadata, options);\n    this.name = 'RateLimitError';\n  }\n}\n\nexport class ModelNotAllowedError extends AIGatewayError {\n  constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: { cause?: unknown }) {\n    super(message, ErrorCode.ModelNotAllowed, statusCode, metadata, options);\n    this.name = 'ModelNotAllowedError';\n  }\n}\n\nexport class GatewayValidationError extends AIGatewayError {\n  constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: { cause?: unknown }) {\n    super(message, ErrorCode.Validation, statusCode, metadata, options);\n    this.name = 'GatewayValidationError';\n  }\n}\n\n/** Type guard: returns true if the value is an AIGatewayError (or any subclass). */\nexport function isAIGatewayError(value: unknown): value is AIGatewayError {\n  return value instanceof AIGatewayError;\n}\n\n// ─── Internal error factories ─────────────────────────────────────────────────\n\nfunction mapGatewayApiCodeToNormalized(code: string, statusCode: number): ErrorCode {\n  switch (code) {\n    case GatewayApiCode.Unauthorized:\n      return ErrorCode.AuthRequired;\n    case GatewayApiCode.InsufficientCredits:\n      return statusCode === 402 ? ErrorCode.InsufficientCredits : ErrorCode.SubscriptionExpired;\n    case GatewayApiCode.Forbidden:\n      return ErrorCode.ModelNotAllowed;\n    case GatewayApiCode.RateLimitExceeded:\n      return ErrorCode.RateLimited;\n    case GatewayApiCode.BadRequest:\n      return ErrorCode.BadRequest;\n    case GatewayApiCode.Validation:\n      return ErrorCode.Validation;\n    case GatewayApiCode.InternalServerError:\n      return ErrorCode.InternalServerError;\n    case GatewayApiCode.ServiceUnavailable:\n      return ErrorCode.ServiceUnavailable;\n    case GatewayApiCode.Timeout:\n      return ErrorCode.Timeout;\n    case GatewayApiCode.NotFound:\n      return ErrorCode.NotFound;\n    case GatewayApiCode.Conflict:\n      return ErrorCode.Conflict;\n    default:\n      return statusCode >= 500 ? ErrorCode.InternalServerError : ErrorCode.BadRequest;\n  }\n}\n\nfunction mapOpenAIErrorToNormalized(type?: string | null, statusCode?: number): ErrorCode {\n  if (type === 'authentication_error') return ErrorCode.AuthRequired;\n  if (type === 'rate_limit_error') return ErrorCode.RateLimited;\n  if (type === 'team_model_access_denied') return ErrorCode.ModelNotAllowed;\n  if (type === 'api_error') return ErrorCode.InternalServerError;\n  if (type === 'invalid_request_error') return ErrorCode.BadRequest;\n  if (statusCode === 401) return ErrorCode.AuthRequired;\n  if (statusCode === 429) return ErrorCode.RateLimited;\n  if (statusCode === 403) return ErrorCode.ModelNotAllowed;\n  // Unknown OpenAI error.type: map by status category rather than defaulting to 5xx.\n  return statusCode !== undefined && statusCode >= 400 && statusCode < 500\n    ? ErrorCode.BadRequest\n    : ErrorCode.InternalServerError;\n}\n\nfunction parseRetryAfterHeader(value: string): number | undefined {\n  const seconds = Number(value);\n  if (!Number.isNaN(seconds) && seconds >= 0) return seconds;\n  const date = Date.parse(value);\n  if (!Number.isNaN(date)) {\n    const delta = Math.ceil((date - Date.now()) / 1000);\n    return delta > 0 ? delta : 0;\n  }\n  return undefined;\n}\n\nfunction createTypedError(\n  message: string,\n  code: ErrorCode,\n  statusCode: number,\n  meta: NormalizedErrorMetadata,\n  options?: { cause?: unknown },\n): AIGatewayError {\n  switch (code) {\n    case ErrorCode.AuthRequired:\n      return new AuthError(message, statusCode, meta, options);\n    case ErrorCode.InsufficientCredits:\n    case ErrorCode.SubscriptionExpired:\n      return new CreditsError(message, statusCode, code, meta, options);\n    case ErrorCode.RateLimited:\n      return new RateLimitError(message, statusCode, meta, options);\n    case ErrorCode.ModelNotAllowed:\n      return new ModelNotAllowedError(message, statusCode, meta, options);\n    case ErrorCode.Validation:\n      return new GatewayValidationError(message, statusCode, meta, options);\n    default:\n      return new AIGatewayError(message, code, statusCode, meta, options);\n  }\n}\n\n// ─── Parse functions ──────────────────────────────────────────────────────────\n\nexport async function parseErrorResponseFromResponse(response: Response): Promise<never> {\n  const contentType = response.headers.get('Content-Type') ?? '';\n  let body: unknown;\n\n  if (contentType.includes('application/json')) {\n    try {\n      body = await response.json();\n    } catch {\n      body = { message: response.statusText };\n    }\n  } else {\n    body = { message: await response.text().catch(() => response.statusText) };\n  }\n\n  const retryAfterHeader = response.headers.get('Retry-After');\n  let headerRetryAfter: number | undefined;\n  if (retryAfterHeader) {\n    headerRetryAfter = parseRetryAfterHeader(retryAfterHeader);\n  }\n\n  try {\n    parseErrorResponse(response.status, body);\n  } catch (error) {\n    if (error instanceof AIGatewayError && error.retryAfter == null && headerRetryAfter != null) {\n      throw createTypedError(\n        error.message,\n        error.code,\n        error.statusCode,\n        { ...error.metadata, retryAfter: headerRetryAfter },\n        error.cause != null ? { cause: error.cause } : undefined,\n      );\n    }\n    throw error;\n  }\n}\n\n/**\n * Normalize an SSE `event: error` payload into a typed AIGatewayError subclass.\n */\nexport function parseStreamErrorPayload(payload: {\n  message?: string;\n  code?: string;\n  statusCode?: number;\n  metadata?: Record<string, unknown>;\n}): AIGatewayError {\n  const statusCode = payload.statusCode ?? 500;\n  const rawCode = payload.code ?? 'INTERNAL_SERVER_ERROR';\n  const message = payload.message ?? 'Stream error';\n  const meta: NormalizedErrorMetadata = {};\n  if (payload.metadata) {\n    if (typeof payload.metadata.paymentUrl === 'string') meta.paymentUrl = payload.metadata.paymentUrl;\n    if (typeof payload.metadata.retryAfter === 'number') meta.retryAfter = payload.metadata.retryAfter;\n    if (typeof payload.metadata.requestId === 'string') meta.requestId = payload.metadata.requestId;\n  }\n  const normalizedCode = mapGatewayApiCodeToNormalized(rawCode, statusCode);\n  return createTypedError(message, normalizedCode, statusCode, meta);\n}\n\n/**\n * Parse error response body and throw appropriate AIGatewayError subclass.\n * Handles both Gateway API format and OpenAI proxy format.\n */\nexport function parseErrorResponse(statusCode: number, body: unknown): never {\n  const meta: NormalizedErrorMetadata = {};\n\n  if (body && typeof body === 'object') {\n    if ('request_id' in body && typeof (body as { request_id?: string }).request_id === 'string') {\n      meta.requestId = (body as { request_id: string }).request_id;\n    }\n    if ('path' in body && typeof (body as { path?: string }).path === 'string') {\n      meta.path = (body as { path: string }).path;\n    }\n    if ('timestamp' in body && typeof (body as { timestamp?: string }).timestamp === 'string') {\n      meta.timestamp = (body as { timestamp: string }).timestamp;\n    }\n  }\n\n  const gatewayBody = body as GatewayApiErrorResponse | undefined;\n  if (gatewayBody?.statusCode != null && typeof gatewayBody.message === 'string' && gatewayBody.code) {\n    const code = mapGatewayApiCodeToNormalized(gatewayBody.code, gatewayBody.statusCode);\n    if (gatewayBody.errors?.length) meta.errors = gatewayBody.errors;\n    const firstError = gatewayBody.errors?.[0];\n    if (firstError?.metadata) {\n      if (typeof firstError.metadata.paymentUrl === 'string') meta.paymentUrl = firstError.metadata.paymentUrl;\n      if (typeof firstError.metadata.retryAfter === 'number') meta.retryAfter = firstError.metadata.retryAfter;\n    }\n    throw createTypedError(gatewayBody.message, code, gatewayBody.statusCode, meta);\n  }\n\n  const oai = body as OpenAIErrorResponse | undefined;\n  if (oai?.error?.message) {\n    const code = mapOpenAIErrorToNormalized(oai.error.type, statusCode);\n    if (oai.request_id) meta.requestId = oai.request_id;\n    throw createTypedError(oai.error.message, code, statusCode, meta);\n  }\n\n  const message =\n    typeof (body as { message?: string })?.message === 'string'\n      ? (body as { message: string }).message\n      : `Request failed with status ${statusCode}`;\n\n  let fallbackCode: ErrorCode;\n  if (statusCode === 401) fallbackCode = ErrorCode.AuthRequired;\n  else if (statusCode === 403) fallbackCode = ErrorCode.Forbidden;\n  else if (statusCode === 429) fallbackCode = ErrorCode.RateLimited;\n  else if (statusCode >= 500) fallbackCode = ErrorCode.InternalServerError;\n  else fallbackCode = ErrorCode.BadRequest;\n\n  throw createTypedError(message, fallbackCode, statusCode, meta);\n}\n"]}

package/dist/gateway-errors-DdgDIyQw.d.cts

@@ -0,0 +1,181 @@
+/**
+ * Configuration types and resolver for the AI Gateway SDK.
+ *
+ * GatewayProviderSettings is the public API — 8 fields.
+ * ResolvedConfig is the internal resolved form used by the request pipeline.
+ */
+/**
+ * Supported gateway environments.
+ * Only 'production' is exposed — non-production setups use a direct `baseURL`
+ * instead, keeping env-specific URL management out of this library.
+ */
+type Environment = 'production';
+interface RetryConfig {
+    /** Max number of attempts (including first). Default 3. */
+    maxAttempts?: number;
+    /** Initial delay in ms. Default 1000. */
+    initialDelayMs?: number;
+    /** Max delay in ms. Default 30000. */
+    maxDelayMs?: number;
+    /** Retry only on these status codes (and network errors). Default: 429, 5xx. */
+    retryableStatuses?: number[];
+}
+interface RequestConfig {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body?: RequestInit['body'];
+    signal?: AbortSignal | undefined;
+}
+type Middleware = (config: RequestConfig, next: (config: RequestConfig) => Promise<Response>) => Promise<Response>;
+/**
+ * Configuration for AI Gateway providers and NestJS module.
+ *
+ * Exactly 8 fields — covers auth, routing, request behaviour and middleware.
+ */
+interface GatewayProviderSettings {
+    /** Gateway base URL. Required if env is not set. */
+    baseURL?: string;
+    /** 'production' uses the default MacPaw Gateway URL. */
+    env?: Environment;
+    /**
+     * Returns Bearer token for auth.
+     * Called with `forceRefresh=true` after 401 — provide a fresh token.
+     */
+    getAuthToken: (forceRefresh?: boolean) => Promise<string | null>;
+    /** Extra headers sent with every request. Do not set Authorization here. */
+    headers?: Record<string, string>;
+    /** Retry policy. Set to false to disable. */
+    retry?: RetryConfig | false;
+    /** Request timeout in ms. Default: 60000. */
+    timeout?: number;
+    /** Request interceptors. Run in order before each request. */
+    middleware?: Middleware[];
+    /**
+     * Custom fetch implementation.
+     * Use for testing or low-level request customization.
+     */
+    fetch?: typeof fetch;
+}
+
+/**
+ * Error types for the AI Gateway SDK.
+ *
+ * Combines error classes, API codes, and response shapes in one place.
+ * parseErrorResponse throws the SPECIFIC subclass (AuthError, CreditsError, etc.)
+ * so that `instanceof` checks work correctly in consumer code.
+ */
+type ObjectValues<T> = T[keyof T];
+/** Raw error codes returned by the AI Gateway HTTP API. */
+declare const GatewayApiCode: {
+    readonly BadRequest: "BAD_REQUEST";
+    readonly Unauthorized: "UNAUTHORIZED";
+    readonly InsufficientCredits: "INSUFFICIENT_CREDITS";
+    readonly Forbidden: "FORBIDDEN";
+    readonly Validation: "VALIDATION";
+    readonly RateLimitExceeded: "RATE_LIMIT_EXCEEDED";
+    readonly InternalServerError: "INTERNAL_SERVER_ERROR";
+    readonly ServiceUnavailable: "SERVICE_UNAVAILABLE";
+    readonly Timeout: "TIMEOUT";
+    readonly NotFound: "NOT_FOUND";
+    readonly Conflict: "CONFLICT";
+};
+type GatewayApiCode = ObjectValues<typeof GatewayApiCode>;
+/** Normalized error codes for app handling. */
+declare const ErrorCode: {
+    readonly AuthRequired: "AUTH_REQUIRED";
+    readonly InsufficientCredits: "INSUFFICIENT_CREDITS";
+    readonly SubscriptionExpired: "SUBSCRIPTION_EXPIRED";
+    readonly ModelNotAllowed: "MODEL_NOT_ALLOWED";
+    readonly RateLimited: "RATE_LIMITED";
+    readonly BadRequest: "BAD_REQUEST";
+    readonly Validation: "VALIDATION";
+    readonly Forbidden: "FORBIDDEN";
+    readonly InternalServerError: "INTERNAL_SERVER_ERROR";
+    readonly ServiceUnavailable: "SERVICE_UNAVAILABLE";
+    readonly Timeout: "TIMEOUT";
+    readonly NotFound: "NOT_FOUND";
+    readonly Conflict: "CONFLICT";
+};
+type ErrorCode = ObjectValues<typeof ErrorCode>;
+interface GatewayApiErrorItem {
+    target?: string;
+    property?: string;
+    constraints?: string[];
+    message?: string;
+    metadata?: Record<string, unknown>;
+}
+interface GatewayApiErrorResponse {
+    statusCode: number;
+    message: string;
+    timestamp: string;
+    code: GatewayApiCode;
+    path?: string;
+    errors?: GatewayApiErrorItem[];
+    request_id?: string;
+}
+interface OpenAIErrorResponse {
+    error: {
+        message: string;
+        type?: string | null;
+        code?: string | null;
+        param?: string | null;
+    };
+    request_id?: string;
+}
+interface NormalizedErrorMetadata {
+    paymentUrl?: string;
+    /** Suggested delay before retrying, in seconds (from server's `Retry-After`). */
+    retryAfter?: number;
+    requestId?: string;
+    path?: string;
+    timestamp?: string;
+    errors?: GatewayApiErrorItem[];
+}
+declare class AIGatewayError extends Error {
+    readonly code: ErrorCode;
+    readonly statusCode: number;
+    readonly metadata: NormalizedErrorMetadata;
+    constructor(message: string, code: ErrorCode, statusCode: number, metadata?: NormalizedErrorMetadata, options?: {
+        cause?: unknown;
+    });
+    get paymentUrl(): string | undefined;
+    /** Suggested delay before retrying, in seconds. `undefined` if not provided by the server. */
+    get retryAfter(): number | undefined;
+    get requestId(): string | undefined;
+    toJSON(): Record<string, unknown>;
+}
+declare class AuthError extends AIGatewayError {
+    constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: {
+        cause?: unknown;
+    });
+}
+declare class CreditsError extends AIGatewayError {
+    constructor(message: string, statusCode: number, code: typeof ErrorCode.InsufficientCredits | typeof ErrorCode.SubscriptionExpired, metadata?: NormalizedErrorMetadata, options?: {
+        cause?: unknown;
+    });
+}
+declare class RateLimitError extends AIGatewayError {
+    constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: {
+        cause?: unknown;
+    });
+}
+declare class ModelNotAllowedError extends AIGatewayError {
+    constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: {
+        cause?: unknown;
+    });
+}
+declare class GatewayValidationError extends AIGatewayError {
+    constructor(message: string, statusCode: number, metadata?: NormalizedErrorMetadata, options?: {
+        cause?: unknown;
+    });
+}
+/** Type guard: returns true if the value is an AIGatewayError (or any subclass). */
+declare function isAIGatewayError(value: unknown): value is AIGatewayError;
+/**
+ * Parse error response body and throw appropriate AIGatewayError subclass.
+ * Handles both Gateway API format and OpenAI proxy format.
+ */
+declare function parseErrorResponse(statusCode: number, body: unknown): never;
+
+export { AIGatewayError as A, CreditsError as C, ErrorCode as E, type GatewayProviderSettings as G, type Middleware as M, type NormalizedErrorMetadata as N, type OpenAIErrorResponse as O, RateLimitError as R, AuthError as a, GatewayApiCode as b, type GatewayApiErrorItem as c, type GatewayApiErrorResponse as d, GatewayValidationError as e, ModelNotAllowedError as f, type RetryConfig as g, isAIGatewayError as i, parseErrorResponse as p };