@parsrun/core 0.1.0

package/dist/env.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @parsrun/core - Environment Variables
+ * Runtime-agnostic environment variable access
+ * Works in Node.js, Deno, Bun, and Cloudflare Workers
+ */
+/**
+ * Set environment variables for edge runtimes (Cloudflare Workers, etc.)
+ * Call this from your worker's fetch handler with the env parameter
+ *
+ * @example
+ * ```typescript
+ * export default {
+ *   async fetch(request, env) {
+ *     setEdgeEnv(env);
+ *     // ... rest of handler
+ *   }
+ * }
+ * ```
+ */
+declare function setEdgeEnv(env: Record<string, string | undefined>): void;
+/**
+ * Clear edge environment store
+ */
+declare function clearEdgeEnv(): void;
+/**
+ * Get an environment variable value
+ * Works across all runtimes
+ */
+declare function getEnv(key: string, defaultValue?: string): string | undefined;
+/**
+ * Get an environment variable, throwing if not found
+ */
+declare function requireEnv(key: string): string;
+/**
+ * Get an environment variable as a number
+ */
+declare function getEnvNumber(key: string, defaultValue?: number): number | undefined;
+/**
+ * Get an environment variable as a float
+ */
+declare function getEnvFloat(key: string, defaultValue?: number): number | undefined;
+/**
+ * Get an environment variable as a boolean
+ */
+declare function getEnvBoolean(key: string, defaultValue?: boolean): boolean;
+/**
+ * Get an environment variable as an array (comma-separated)
+ */
+declare function getEnvArray(key: string, defaultValue?: string[]): string[];
+/**
+ * Get an environment variable as JSON
+ */
+declare function getEnvJson<T>(key: string, defaultValue?: T): T | undefined;
+/**
+ * Check if running in development mode
+ */
+declare function isDevelopment(): boolean;
+/**
+ * Check if running in production mode
+ */
+declare function isProduction(): boolean;
+/**
+ * Check if running in test mode
+ */
+declare function isTest(): boolean;
+/**
+ * Environment mode
+ */
+type EnvMode = "development" | "production" | "test";
+/**
+ * Get current environment mode
+ */
+declare function getEnvMode(): EnvMode;
+/**
+ * Create a typed environment configuration object
+ *
+ * @example
+ * ```typescript
+ * const env = createEnvConfig({
+ *   DATABASE_URL: { required: true },
+ *   PORT: { type: 'number', default: 3000 },
+ *   DEBUG: { type: 'boolean', default: false },
+ * });
+ *
+ * env.DATABASE_URL // string
+ * env.PORT // number
+ * env.DEBUG // boolean
+ * ```
+ */
+declare function createEnvConfig<T extends EnvSchema>(schema: T): EnvResult<T>;
+type EnvConfigItem = {
+    type?: "string" | "number" | "boolean" | "array" | "json";
+    required?: boolean;
+    default?: unknown;
+};
+type EnvSchema = Record<string, EnvConfigItem>;
+type EnvResult<T extends EnvSchema> = {
+    [K in keyof T]: T[K]["type"] extends "number" ? number : T[K]["type"] extends "boolean" ? boolean : T[K]["type"] extends "array" ? string[] : T[K]["type"] extends "json" ? unknown : string;
+};
+
+export { type EnvMode, clearEdgeEnv, createEnvConfig, getEnv, getEnvArray, getEnvBoolean, getEnvFloat, getEnvJson, getEnvMode, getEnvNumber, isDevelopment, isProduction, isTest, requireEnv, setEdgeEnv };

package/dist/env.js

@@ -0,0 +1,172 @@
+// src/runtime.ts
+function detectRuntime() {
+  if (typeof globalThis !== "undefined" && "Bun" in globalThis) {
+    return "bun";
+  }
+  if (typeof globalThis !== "undefined" && "Deno" in globalThis) {
+    return "deno";
+  }
+  if (typeof globalThis !== "undefined" && typeof globalThis.caches !== "undefined" && typeof globalThis.process === "undefined") {
+    return "cloudflare";
+  }
+  if (typeof globalThis !== "undefined" && typeof globalThis.EdgeRuntime !== "undefined") {
+    return "edge";
+  }
+  if (typeof globalThis !== "undefined" && typeof globalThis.window !== "undefined" && typeof globalThis.document !== "undefined") {
+    return "browser";
+  }
+  if (typeof process !== "undefined" && process.versions && process.versions.node) {
+    return "node";
+  }
+  return "unknown";
+}
+var runtime = detectRuntime();
+var runtimeInfo = {
+  runtime,
+  isNode: runtime === "node",
+  isDeno: runtime === "deno",
+  isBun: runtime === "bun",
+  isCloudflare: runtime === "cloudflare",
+  isEdge: runtime === "cloudflare" || runtime === "edge" || runtime === "deno",
+  isBrowser: runtime === "browser",
+  isServer: runtime !== "browser",
+  supportsWebCrypto: typeof globalThis.crypto?.subtle !== "undefined",
+  supportsStreams: typeof globalThis.ReadableStream !== "undefined"
+};
+
+// src/env.ts
+var edgeEnvStore = {};
+function setEdgeEnv(env) {
+  edgeEnvStore = { ...edgeEnvStore, ...env };
+}
+function clearEdgeEnv() {
+  edgeEnvStore = {};
+}
+function getEnv(key, defaultValue) {
+  if (runtime === "cloudflare" || runtime === "edge") {
+    return edgeEnvStore[key] ?? defaultValue;
+  }
+  if (runtime === "deno") {
+    try {
+      return globalThis.Deno.env.get(key) ?? defaultValue;
+    } catch {
+      return defaultValue;
+    }
+  }
+  if (typeof process !== "undefined" && process.env) {
+    return process.env[key] ?? defaultValue;
+  }
+  if (runtime === "browser" && typeof globalThis.__ENV__ !== "undefined") {
+    return globalThis.__ENV__[key] ?? defaultValue;
+  }
+  return defaultValue;
+}
+function requireEnv(key) {
+  const value = getEnv(key);
+  if (value === void 0 || value === "") {
+    throw new Error(`Required environment variable "${key}" is not set`);
+  }
+  return value;
+}
+function getEnvNumber(key, defaultValue) {
+  const value = getEnv(key);
+  if (value === void 0 || value === "") {
+    return defaultValue;
+  }
+  const parsed = parseInt(value, 10);
+  return isNaN(parsed) ? defaultValue : parsed;
+}
+function getEnvFloat(key, defaultValue) {
+  const value = getEnv(key);
+  if (value === void 0 || value === "") {
+    return defaultValue;
+  }
+  const parsed = parseFloat(value);
+  return isNaN(parsed) ? defaultValue : parsed;
+}
+function getEnvBoolean(key, defaultValue = false) {
+  const value = getEnv(key);
+  if (value === void 0 || value === "") {
+    return defaultValue;
+  }
+  return value === "true" || value === "1" || value === "yes";
+}
+function getEnvArray(key, defaultValue = []) {
+  const value = getEnv(key);
+  if (value === void 0 || value === "") {
+    return defaultValue;
+  }
+  return value.split(",").map((s) => s.trim()).filter(Boolean);
+}
+function getEnvJson(key, defaultValue) {
+  const value = getEnv(key);
+  if (value === void 0 || value === "") {
+    return defaultValue;
+  }
+  try {
+    return JSON.parse(value);
+  } catch {
+    return defaultValue;
+  }
+}
+function isDevelopment() {
+  const env = getEnv("NODE_ENV");
+  return env === "development" || env === void 0;
+}
+function isProduction() {
+  return getEnv("NODE_ENV") === "production";
+}
+function isTest() {
+  return getEnv("NODE_ENV") === "test";
+}
+function getEnvMode() {
+  const env = getEnv("NODE_ENV");
+  if (env === "production") return "production";
+  if (env === "test") return "test";
+  return "development";
+}
+function createEnvConfig(schema) {
+  const result = {};
+  for (const [key, config] of Object.entries(schema)) {
+    const envConfig = config;
+    let value;
+    switch (envConfig.type) {
+      case "number":
+        value = getEnvNumber(key, envConfig.default);
+        break;
+      case "boolean":
+        value = getEnvBoolean(key, envConfig.default);
+        break;
+      case "array":
+        value = getEnvArray(key, envConfig.default);
+        break;
+      case "json":
+        value = getEnvJson(key, envConfig.default);
+        break;
+      default:
+        value = getEnv(key, envConfig.default);
+    }
+    if (envConfig.required && (value === void 0 || value === "")) {
+      throw new Error(`Required environment variable "${key}" is not set`);
+    }
+    result[key] = value;
+  }
+  return result;
+}
+export {
+  clearEdgeEnv,
+  createEnvConfig,
+  getEnv,
+  getEnvArray,
+  getEnvBoolean,
+  getEnvFloat,
+  getEnvJson,
+  getEnvMode,
+  getEnvNumber,
+  isDevelopment,
+  isProduction,
+  isTest,
+  requireEnv,
+  setEdgeEnv
+};
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime.ts","../src/env.ts"],"sourcesContent":["/**\n * @parsrun/core - Runtime Detection\n * Edge-compatible runtime detection for Node.js, Deno, Bun, and Cloudflare Workers\n */\n\nexport type Runtime = \"node\" | \"deno\" | \"bun\" | \"cloudflare\" | \"edge\" | \"browser\" | \"unknown\";\n\n/**\n * Detect the current JavaScript runtime\n */\nexport function detectRuntime(): Runtime {\n  // Bun check (must be before Node since Bun also has process)\n  if (typeof globalThis !== \"undefined\" && \"Bun\" in globalThis) {\n    return \"bun\";\n  }\n\n  // Deno check\n  if (typeof globalThis !== \"undefined\" && \"Deno\" in globalThis) {\n    return \"deno\";\n  }\n\n  // Cloudflare Workers check (has caches but no process)\n  if (\n    typeof globalThis !== \"undefined\" &&\n    typeof (globalThis as any).caches !== \"undefined\" &&\n    typeof (globalThis as any).process === \"undefined\"\n  ) {\n    return \"cloudflare\";\n  }\n\n  // Generic Edge runtime check (Vercel Edge, etc.)\n  if (\n    typeof globalThis !== \"undefined\" &&\n    typeof (globalThis as any).EdgeRuntime !== \"undefined\"\n  ) {\n    return \"edge\";\n  }\n\n  // Browser check\n  if (\n    typeof globalThis !== \"undefined\" &&\n    typeof (globalThis as any).window !== \"undefined\" &&\n    typeof (globalThis as any).document !== \"undefined\"\n  ) {\n    return \"browser\";\n  }\n\n  // Node.js check\n  if (\n    typeof process !== \"undefined\" &&\n    process.versions &&\n    process.versions.node\n  ) {\n    return \"node\";\n  }\n\n  return \"unknown\";\n}\n\n/**\n * Current runtime (cached)\n */\nexport const runtime = detectRuntime();\n\n/**\n * Runtime information helpers\n */\nexport const runtimeInfo = {\n  runtime,\n  isNode: runtime === \"node\",\n  isDeno: runtime === \"deno\",\n  isBun: runtime === \"bun\",\n  isCloudflare: runtime === \"cloudflare\",\n  isEdge: runtime === \"cloudflare\" || runtime === \"edge\" || runtime === \"deno\",\n  isBrowser: runtime === \"browser\",\n  isServer: runtime !== \"browser\",\n  supportsWebCrypto: typeof globalThis.crypto?.subtle !== \"undefined\",\n  supportsStreams: typeof globalThis.ReadableStream !== \"undefined\",\n} as const;\n\n/**\n * Check if running in Node.js\n */\nexport function isNode(): boolean {\n  return runtime === \"node\";\n}\n\n/**\n * Check if running in Deno\n */\nexport function isDeno(): boolean {\n  return runtime === \"deno\";\n}\n\n/**\n * Check if running in Bun\n */\nexport function isBun(): boolean {\n  return runtime === \"bun\";\n}\n\n/**\n * Check if running in Cloudflare Workers\n */\nexport function isCloudflare(): boolean {\n  return runtime === \"cloudflare\";\n}\n\n/**\n * Check if running in any edge environment\n */\nexport function isEdge(): boolean {\n  return runtimeInfo.isEdge;\n}\n\n/**\n * Check if running in browser\n */\nexport function isBrowser(): boolean {\n  return runtime === \"browser\";\n}\n\n/**\n * Check if running on server (not browser)\n */\nexport function isServer(): boolean {\n  return runtimeInfo.isServer;\n}\n\n/**\n * Get runtime version string\n */\nexport function getRuntimeVersion(): string {\n  switch (runtime) {\n    case \"node\":\n      return `Node.js ${process.versions.node}`;\n    case \"bun\":\n      return `Bun ${(globalThis as any).Bun.version}`;\n    case \"deno\":\n      return `Deno ${(globalThis as any).Deno.version.deno}`;\n    case \"cloudflare\":\n      return \"Cloudflare Workers\";\n    case \"edge\":\n      return \"Edge Runtime\";\n    case \"browser\":\n      return typeof navigator !== \"undefined\" ? navigator.userAgent : \"Browser\";\n    default:\n      return \"Unknown\";\n  }\n}\n","/**\n * @parsrun/core - Environment Variables\n * Runtime-agnostic environment variable access\n * Works in Node.js, Deno, Bun, and Cloudflare Workers\n */\n\nimport { runtime } from \"./runtime.js\";\n\n/**\n * Environment variable store for edge runtimes\n * Must be set from the request handler's env parameter\n */\nlet edgeEnvStore: Record<string, string | undefined> = {};\n\n/**\n * Set environment variables for edge runtimes (Cloudflare Workers, etc.)\n * Call this from your worker's fetch handler with the env parameter\n *\n * @example\n * ```typescript\n * export default {\n *   async fetch(request, env) {\n *     setEdgeEnv(env);\n *     // ... rest of handler\n *   }\n * }\n * ```\n */\nexport function setEdgeEnv(env: Record<string, string | undefined>): void {\n  edgeEnvStore = { ...edgeEnvStore, ...env };\n}\n\n/**\n * Clear edge environment store\n */\nexport function clearEdgeEnv(): void {\n  edgeEnvStore = {};\n}\n\n/**\n * Get an environment variable value\n * Works across all runtimes\n */\nexport function getEnv(key: string, defaultValue?: string): string | undefined {\n  // Edge runtimes (Cloudflare Workers, etc.)\n  if (runtime === \"cloudflare\" || runtime === \"edge\") {\n    return edgeEnvStore[key] ?? defaultValue;\n  }\n\n  // Deno\n  if (runtime === \"deno\") {\n    try {\n      return (globalThis as any).Deno.env.get(key) ?? defaultValue;\n    } catch {\n      return defaultValue;\n    }\n  }\n\n  // Node.js / Bun (both use process.env)\n  if (typeof process !== \"undefined\" && process.env) {\n    return process.env[key] ?? defaultValue;\n  }\n\n  // Browser - check for injected env\n  if (runtime === \"browser\" && typeof (globalThis as any).__ENV__ !== \"undefined\") {\n    return (globalThis as any).__ENV__[key] ?? defaultValue;\n  }\n\n  return defaultValue;\n}\n\n/**\n * Get an environment variable, throwing if not found\n */\nexport function requireEnv(key: string): string {\n  const value = getEnv(key);\n  if (value === undefined || value === \"\") {\n    throw new Error(`Required environment variable \"${key}\" is not set`);\n  }\n  return value;\n}\n\n/**\n * Get an environment variable as a number\n */\nexport function getEnvNumber(key: string, defaultValue?: number): number | undefined {\n  const value = getEnv(key);\n  if (value === undefined || value === \"\") {\n    return defaultValue;\n  }\n  const parsed = parseInt(value, 10);\n  return isNaN(parsed) ? defaultValue : parsed;\n}\n\n/**\n * Get an environment variable as a float\n */\nexport function getEnvFloat(key: string, defaultValue?: number): number | undefined {\n  const value = getEnv(key);\n  if (value === undefined || value === \"\") {\n    return defaultValue;\n  }\n  const parsed = parseFloat(value);\n  return isNaN(parsed) ? defaultValue : parsed;\n}\n\n/**\n * Get an environment variable as a boolean\n */\nexport function getEnvBoolean(key: string, defaultValue: boolean = false): boolean {\n  const value = getEnv(key);\n  if (value === undefined || value === \"\") {\n    return defaultValue;\n  }\n  return value === \"true\" || value === \"1\" || value === \"yes\";\n}\n\n/**\n * Get an environment variable as an array (comma-separated)\n */\nexport function getEnvArray(key: string, defaultValue: string[] = []): string[] {\n  const value = getEnv(key);\n  if (value === undefined || value === \"\") {\n    return defaultValue;\n  }\n  return value.split(\",\").map((s) => s.trim()).filter(Boolean);\n}\n\n/**\n * Get an environment variable as JSON\n */\nexport function getEnvJson<T>(key: string, defaultValue?: T): T | undefined {\n  const value = getEnv(key);\n  if (value === undefined || value === \"\") {\n    return defaultValue;\n  }\n  try {\n    return JSON.parse(value) as T;\n  } catch {\n    return defaultValue;\n  }\n}\n\n/**\n * Check if running in development mode\n */\nexport function isDevelopment(): boolean {\n  const env = getEnv(\"NODE_ENV\");\n  return env === \"development\" || env === undefined;\n}\n\n/**\n * Check if running in production mode\n */\nexport function isProduction(): boolean {\n  return getEnv(\"NODE_ENV\") === \"production\";\n}\n\n/**\n * Check if running in test mode\n */\nexport function isTest(): boolean {\n  return getEnv(\"NODE_ENV\") === \"test\";\n}\n\n/**\n * Environment mode\n */\nexport type EnvMode = \"development\" | \"production\" | \"test\";\n\n/**\n * Get current environment mode\n */\nexport function getEnvMode(): EnvMode {\n  const env = getEnv(\"NODE_ENV\");\n  if (env === \"production\") return \"production\";\n  if (env === \"test\") return \"test\";\n  return \"development\";\n}\n\n/**\n * Create a typed environment configuration object\n *\n * @example\n * ```typescript\n * const env = createEnvConfig({\n *   DATABASE_URL: { required: true },\n *   PORT: { type: 'number', default: 3000 },\n *   DEBUG: { type: 'boolean', default: false },\n * });\n *\n * env.DATABASE_URL // string\n * env.PORT // number\n * env.DEBUG // boolean\n * ```\n */\nexport function createEnvConfig<T extends EnvSchema>(schema: T): EnvResult<T> {\n  const result: Record<string, unknown> = {};\n\n  for (const [key, config] of Object.entries(schema)) {\n    const envConfig = config as EnvConfigItem;\n    let value: unknown;\n\n    switch (envConfig.type) {\n      case \"number\":\n        value = getEnvNumber(key, envConfig.default as number | undefined);\n        break;\n      case \"boolean\":\n        value = getEnvBoolean(key, envConfig.default as boolean | undefined);\n        break;\n      case \"array\":\n        value = getEnvArray(key, envConfig.default as string[] | undefined);\n        break;\n      case \"json\":\n        value = getEnvJson(key, envConfig.default);\n        break;\n      default:\n        value = getEnv(key, envConfig.default as string | undefined);\n    }\n\n    if (envConfig.required && (value === undefined || value === \"\")) {\n      throw new Error(`Required environment variable \"${key}\" is not set`);\n    }\n\n    result[key] = value;\n  }\n\n  return result as EnvResult<T>;\n}\n\n// Type helpers for createEnvConfig\ntype EnvConfigItem = {\n  type?: \"string\" | \"number\" | \"boolean\" | \"array\" | \"json\";\n  required?: boolean;\n  default?: unknown;\n};\n\ntype EnvSchema = Record<string, EnvConfigItem>;\n\ntype EnvResult<T extends EnvSchema> = {\n  [K in keyof T]: T[K][\"type\"] extends \"number\"\n    ? number\n    : T[K][\"type\"] extends \"boolean\"\n      ? boolean\n      : T[K][\"type\"] extends \"array\"\n        ? string[]\n        : T[K][\"type\"] extends \"json\"\n          ? unknown\n          : string;\n};\n"],"mappings":"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","names":[]}

package/dist/error-codes.d.ts

@@ -0,0 +1,257 @@
+/**
+ * @parsrun/core - Error Code Catalog
+ * Centralized error code definitions for the entire framework
+ */
+/**
+ * Error category for grouping and filtering
+ */
+type ErrorCategory = "auth" | "tenant" | "validation" | "resource" | "rate_limit" | "server" | "database" | "external";
+/**
+ * Error code definition
+ */
+interface ErrorCodeDefinition {
+    readonly code: string;
+    readonly status: number;
+    readonly category: ErrorCategory;
+    readonly retryable?: boolean;
+}
+/**
+ * Centralized error code catalog
+ * All error codes used throughout the framework are defined here
+ */
+declare const ErrorCodes: {
+    readonly AUTH_ERROR: {
+        readonly code: "AUTH_ERROR";
+        readonly status: 401;
+        readonly category: "auth";
+    };
+    readonly UNAUTHORIZED: {
+        readonly code: "UNAUTHORIZED";
+        readonly status: 401;
+        readonly category: "auth";
+    };
+    readonly FORBIDDEN: {
+        readonly code: "FORBIDDEN";
+        readonly status: 403;
+        readonly category: "auth";
+    };
+    readonly INVALID_CREDENTIALS: {
+        readonly code: "INVALID_CREDENTIALS";
+        readonly status: 401;
+        readonly category: "auth";
+    };
+    readonly SESSION_EXPIRED: {
+        readonly code: "SESSION_EXPIRED";
+        readonly status: 401;
+        readonly category: "auth";
+    };
+    readonly TOKEN_EXPIRED: {
+        readonly code: "TOKEN_EXPIRED";
+        readonly status: 401;
+        readonly category: "auth";
+    };
+    readonly TOKEN_INVALID: {
+        readonly code: "TOKEN_INVALID";
+        readonly status: 401;
+        readonly category: "auth";
+    };
+    readonly TWO_FACTOR_REQUIRED: {
+        readonly code: "TWO_FACTOR_REQUIRED";
+        readonly status: 403;
+        readonly category: "auth";
+    };
+    readonly TWO_FACTOR_INVALID: {
+        readonly code: "TWO_FACTOR_INVALID";
+        readonly status: 401;
+        readonly category: "auth";
+    };
+    readonly ACCOUNT_LOCKED: {
+        readonly code: "ACCOUNT_LOCKED";
+        readonly status: 423;
+        readonly category: "auth";
+    };
+    readonly ACCOUNT_DISABLED: {
+        readonly code: "ACCOUNT_DISABLED";
+        readonly status: 403;
+        readonly category: "auth";
+    };
+    readonly PASSWORD_RESET_REQUIRED: {
+        readonly code: "PASSWORD_RESET_REQUIRED";
+        readonly status: 403;
+        readonly category: "auth";
+    };
+    readonly TENANT_ERROR: {
+        readonly code: "TENANT_ERROR";
+        readonly status: 400;
+        readonly category: "tenant";
+    };
+    readonly TENANT_NOT_FOUND: {
+        readonly code: "TENANT_NOT_FOUND";
+        readonly status: 404;
+        readonly category: "tenant";
+    };
+    readonly TENANT_SUSPENDED: {
+        readonly code: "TENANT_SUSPENDED";
+        readonly status: 403;
+        readonly category: "tenant";
+    };
+    readonly TENANT_LIMIT_EXCEEDED: {
+        readonly code: "TENANT_LIMIT_EXCEEDED";
+        readonly status: 403;
+        readonly category: "tenant";
+    };
+    readonly MEMBERSHIP_ERROR: {
+        readonly code: "MEMBERSHIP_ERROR";
+        readonly status: 400;
+        readonly category: "tenant";
+    };
+    readonly MEMBERSHIP_NOT_FOUND: {
+        readonly code: "MEMBERSHIP_NOT_FOUND";
+        readonly status: 404;
+        readonly category: "tenant";
+    };
+    readonly MEMBERSHIP_EXPIRED: {
+        readonly code: "MEMBERSHIP_EXPIRED";
+        readonly status: 403;
+        readonly category: "tenant";
+    };
+    readonly VALIDATION_ERROR: {
+        readonly code: "VALIDATION_ERROR";
+        readonly status: 400;
+        readonly category: "validation";
+    };
+    readonly BAD_REQUEST: {
+        readonly code: "BAD_REQUEST";
+        readonly status: 400;
+        readonly category: "validation";
+    };
+    readonly INVALID_INPUT: {
+        readonly code: "INVALID_INPUT";
+        readonly status: 422;
+        readonly category: "validation";
+    };
+    readonly MISSING_REQUIRED_FIELD: {
+        readonly code: "MISSING_REQUIRED_FIELD";
+        readonly status: 400;
+        readonly category: "validation";
+    };
+    readonly INVALID_FORMAT: {
+        readonly code: "INVALID_FORMAT";
+        readonly status: 400;
+        readonly category: "validation";
+    };
+    readonly NOT_FOUND: {
+        readonly code: "NOT_FOUND";
+        readonly status: 404;
+        readonly category: "resource";
+    };
+    readonly CONFLICT: {
+        readonly code: "CONFLICT";
+        readonly status: 409;
+        readonly category: "resource";
+    };
+    readonly DUPLICATE: {
+        readonly code: "DUPLICATE";
+        readonly status: 409;
+        readonly category: "resource";
+    };
+    readonly GONE: {
+        readonly code: "GONE";
+        readonly status: 410;
+        readonly category: "resource";
+    };
+    readonly RESOURCE_LOCKED: {
+        readonly code: "RESOURCE_LOCKED";
+        readonly status: 423;
+        readonly category: "resource";
+    };
+    readonly RATE_LIMIT_EXCEEDED: {
+        readonly code: "RATE_LIMIT_EXCEEDED";
+        readonly status: 429;
+        readonly category: "rate_limit";
+        readonly retryable: true;
+    };
+    readonly QUOTA_EXCEEDED: {
+        readonly code: "QUOTA_EXCEEDED";
+        readonly status: 429;
+        readonly category: "rate_limit";
+    };
+    readonly INTERNAL_ERROR: {
+        readonly code: "INTERNAL_ERROR";
+        readonly status: 500;
+        readonly category: "server";
+    };
+    readonly BAD_GATEWAY: {
+        readonly code: "BAD_GATEWAY";
+        readonly status: 502;
+        readonly category: "server";
+        readonly retryable: true;
+    };
+    readonly SERVICE_UNAVAILABLE: {
+        readonly code: "SERVICE_UNAVAILABLE";
+        readonly status: 503;
+        readonly category: "server";
+        readonly retryable: true;
+    };
+    readonly GATEWAY_TIMEOUT: {
+        readonly code: "GATEWAY_TIMEOUT";
+        readonly status: 504;
+        readonly category: "server";
+        readonly retryable: true;
+    };
+    readonly DATABASE_ERROR: {
+        readonly code: "DATABASE_ERROR";
+        readonly status: 500;
+        readonly category: "database";
+    };
+    readonly CONNECTION_ERROR: {
+        readonly code: "CONNECTION_ERROR";
+        readonly status: 503;
+        readonly category: "database";
+        readonly retryable: true;
+    };
+    readonly TRANSACTION_ERROR: {
+        readonly code: "TRANSACTION_ERROR";
+        readonly status: 500;
+        readonly category: "database";
+    };
+    readonly RLS_ERROR: {
+        readonly code: "RLS_ERROR";
+        readonly status: 500;
+        readonly category: "database";
+    };
+    readonly EXTERNAL_SERVICE_ERROR: {
+        readonly code: "EXTERNAL_SERVICE_ERROR";
+        readonly status: 502;
+        readonly category: "external";
+        readonly retryable: true;
+    };
+    readonly EXTERNAL_TIMEOUT: {
+        readonly code: "EXTERNAL_TIMEOUT";
+        readonly status: 504;
+        readonly category: "external";
+        readonly retryable: true;
+    };
+};
+/**
+ * Error code type (union of all error code keys)
+ */
+type ErrorCode = keyof typeof ErrorCodes;
+/**
+ * Get error code definition by code string
+ */
+declare function getErrorCode(code: string): ErrorCodeDefinition | undefined;
+/**
+ * Get all error codes by category
+ */
+declare function getErrorCodesByCategory(category: ErrorCategory): ErrorCodeDefinition[];
+/**
+ * Check if an error code is retryable
+ */
+declare function isRetryableError(code: string): boolean;
+/**
+ * Get HTTP status for an error code
+ */
+declare function getStatusForCode(code: string): number;
+
+export { type ErrorCategory, type ErrorCode, type ErrorCodeDefinition, ErrorCodes, getErrorCode, getErrorCodesByCategory, getStatusForCode, isRetryableError };