@spfn/core 0.2.0-beta.9 → 0.3.0-beta.10

package/dist/env/loader.d.ts

@@ -1,17 +1,27 @@
 /**
  * Environment Variable Loader
  *
- * Next.js 스타일의 환경변수 파일 로딩
+ * Next.js 스타일의 환경변수 파일 로딩 (환경별 분리 지원)
+ *
+ * 로딩 우선순위 (낮음 -> 높음, 나중 파일이 덮어씀):
+ * 1. .env                   - 기본값 (committed)
+ * 2. .env.{NODE_ENV}        - 환경별 오버라이드 (committed)
+ * 3. .env.local             - 로컬 오버라이드 (gitignored, test에서 스킵)
+ * 4. .env.{NODE_ENV}.local  - 환경별 시크릿 (gitignored)
+ * 5. .env.server            - 서버 전용 (gitignored, Next.js 미로드)
  *
  * @example
  * ```typescript
  * import { loadEnv } from '@spfn/core/env/loader';
  *
- * // SPFN 서버 진입점에서 호출
+ * // 기본 사용 (NODE_ENV 자동 감지)
  * loadEnv();
  *
- * // 이후 스키마 검증
- * const env = createEnvRegistry(envSchema).validate();
+ * // 특정 환경 지정
+ * loadEnv({ nodeEnv: 'production' });
+ *
+ * // 서버 레이어 제외 (Next.js 클라이언트용)
+ * loadEnv({ server: false });
  * ```
  *
  * @module env/loader
@@ -25,6 +35,16 @@ interface LoadEnvOptions {
      * @default process.cwd()
      */
     cwd?: string;
+    /**
+     * NODE_ENV 값 (환경별 .env 파일 결정)
+     * @default process.env.NODE_ENV || 'local'
+     */
+    nodeEnv?: string;
+    /**
+     * 서버 전용 파일 포함 여부 (.env.server)
+     * @default true
+     */
+    server?: boolean;
     /**
      * 디버그 모드 (로드된 파일 로깅)
      * @default false
@@ -52,24 +72,11 @@ interface LoadEnvResult {
 /**
  * 프로젝트 루트의 환경변수 파일들을 규칙에 따라 로드
  *
- * Next.js 스타일의 우선순위를 따름:
- * - .env → .env.local → .env.server → .env.server.local
- * - 나중에 로드된 값이 이전 값을 덮어씀
+ * 모든 파일을 파싱 후 머지한 뒤 process.env에 한번에 적용.
+ * 이미 process.env에 존재하는 키는 덮어쓰지 않음 (플랫폼 주입 보호).
  *
  * @param options - 로드 옵션
  * @returns 로드 결과 (로드된 파일, 키 목록)
- *
- * @example
- * ```typescript
- * // 기본 사용
- * loadEnv();
- *
- * // 커스텀 경로
- * loadEnv({ cwd: '/path/to/project' });
- *
- * // 디버그 모드
- * loadEnv({ debug: true });
- * ```
  */
 declare function loadEnv(options?: LoadEnvOptions): LoadEnvResult;
 /**

package/dist/env/loader.js

@@ -5,58 +5,88 @@ import { logger } from '@spfn/core/logger';
 
 // src/env/loader.ts
 var envLogger = logger.child("@spfn/core:env-loader");
-var ENV_FILES = [
-  ".env",
-  ".env.local",
-  ".env.server",
-  ".env.server.local"
-];
+function getEnvFiles(nodeEnv, server) {
+  const files = [
+    ".env",
+    `.env.${nodeEnv}`
+  ];
+  if (nodeEnv !== "test") {
+    files.push(".env.local");
+  }
+  files.push(`.env.${nodeEnv}.local`);
+  if (server) {
+    files.push(".env.server");
+  }
+  return files;
+}
 function parseEnvFile(filePath) {
   if (!existsSync(filePath)) {
     return null;
   }
-  const content = readFileSync(filePath, "utf-8");
-  return parse(content);
+  return parse(readFileSync(filePath, "utf-8"));
 }
 function loadEnv(options = {}) {
+  const nodeEnvAtEntry = process.env.NODE_ENV;
   const {
     cwd = process.cwd(),
+    nodeEnv = nodeEnvAtEntry || "local",
+    server = true,
     debug = false,
     override = false
   } = options;
+  const envFiles = getEnvFiles(nodeEnv, server);
   const loadedFiles = [];
-  const loadedKeys = /* @__PURE__ */ new Set();
-  for (const fileName of ENV_FILES) {
+  const existingKeys = new Set(Object.keys(process.env));
+  const merged = {};
+  for (const fileName of envFiles) {
     const filePath = resolve(cwd, fileName);
     const parsed = parseEnvFile(filePath);
     if (parsed === null) {
       continue;
     }
     loadedFiles.push(fileName);
-    for (const [key, value] of Object.entries(parsed)) {
-      if (!override && process.env[key] !== void 0) {
-        continue;
-      }
-      process.env[key] = value;
-      loadedKeys.add(key);
+    Object.assign(merged, parsed);
+  }
+  const loadedKeys = [];
+  for (const [key, value] of Object.entries(merged)) {
+    if (!override && existingKeys.has(key)) {
+      continue;
     }
+    process.env[key] = value;
+    loadedKeys.push(key);
   }
   if (debug && loadedFiles.length > 0) {
     envLogger.debug(`Loaded env files: ${loadedFiles.join(", ")}`);
-    envLogger.debug(`Loaded ${loadedKeys.size} environment variables`);
+    envLogger.debug(`Loaded ${loadedKeys.length} environment variables`);
+  }
+  warnIfEnvGuessCostSomething(cwd, nodeEnvAtEntry, options.nodeEnv, nodeEnv);
+  return { loadedFiles, loadedKeys };
+}
+function warnIfEnvGuessCostSomething(cwd, nodeEnvAtEntry, explicitNodeEnv, resolvedNodeEnv) {
+  if (nodeEnvAtEntry || explicitNodeEnv) {
+    return;
+  }
+  const declared = process.env.NODE_ENV;
+  if (!declared) {
+    envLogger.warn(
+      `NODE_ENV is not set anywhere; env files were resolved for "${resolvedNodeEnv}". Set NODE_ENV in the process environment to choose the file set.`
+    );
+    return;
+  }
+  if (declared === resolvedNodeEnv) {
+    return;
+  }
+  if (!existsSync(resolve(cwd, `.env.${declared}`))) {
+    return;
   }
-  return {
-    loadedFiles,
-    loadedKeys: Array.from(loadedKeys)
-  };
+  envLogger.warn(
+    `.env.${declared} was NOT loaded: NODE_ENV was not set when the process started, so env files were resolved for "${resolvedNodeEnv}" before a file declared NODE_ENV=${declared}. Set NODE_ENV in the process environment, not in a .env file.`
+  );
 }
 var isEnvLoaded = false;
 function loadEnvOnce(options = {}) {
   if (isEnvLoaded) {
-    return {
-      loadedFiles: [],
-      loadedKeys: []
-    };
+    return { loadedFiles: [], loadedKeys: [] };
   }
   isEnvLoaded = true;
   return loadEnv(options);

package/dist/env/loader.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/env/loader.ts"],"names":[],"mappings":";;;;;;AAwBA,IAAM,SAAA,GAAY,MAAA,CAAO,KAAA,CAAM,uBAAuB,CAAA;AAkCtD,IAAM,SAAA,GAAY;AAAA,EACd,MAAA;AAAA,EACA,YAAA;AAAA,EACA,aAAA;AAAA,EACA;AACJ,CAAA;AAKA,SAAS,aAAa,QAAA,EACtB;AACI,EAAA,IAAI,CAAC,UAAA,CAAW,QAAQ,CAAA,EACxB;AACI,IAAA,OAAO,IAAA;AAAA,EACX;AAEA,EAAA,MAAM,OAAA,GAAU,YAAA,CAAa,QAAA,EAAU,OAAO,CAAA;AAC9C,EAAA,OAAO,MAAM,OAAO,CAAA;AACxB;AAwCO,SAAS,OAAA,CAAQ,OAAA,GAA0B,EAAC,EACnD;AACI,EAAA,MAAM;AAAA,IACF,GAAA,GAAM,QAAQ,GAAA,EAAI;AAAA,IAClB,KAAA,GAAQ,KAAA;AAAA,IACR,QAAA,GAAW;AAAA,GACf,GAAI,OAAA;AAEJ,EAAA,MAAM,cAAwB,EAAC;AAC/B,EAAA,MAAM,UAAA,uBAAiB,GAAA,EAAY;AAEnC,EAAA,KAAA,MAAW,YAAY,SAAA,EACvB;AACI,IAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,GAAA,EAAK,QAAQ,CAAA;AACtC,IAAA,MAAM,MAAA,GAAS,aAAa,QAAQ,CAAA;AAEpC,IAAA,IAAI,WAAW,IAAA,EACf;AACI,MAAA;AAAA,IACJ;AAEA,IAAA,WAAA,CAAY,KAAK,QAAQ,CAAA;AAEzB,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAChD;AAEI,MAAA,IAAI,CAAC,QAAA,IAAY,OAAA,CAAQ,GAAA,CAAI,GAAG,MAAM,MAAA,EACtC;AACI,QAAA;AAAA,MACJ;AAEA,MAAA,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAA,GAAI,KAAA;AACnB,MAAA,UAAA,CAAW,IAAI,GAAG,CAAA;AAAA,IACtB;AAAA,EACJ;AAEA,EAAA,IAAI,KAAA,IAAS,WAAA,CAAY,MAAA,GAAS,CAAA,EAClC;AACI,IAAA,SAAA,CAAU,MAAM,CAAA,kBAAA,EAAqB,WAAA,CAAY,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AAC7D,IAAA,SAAA,CAAU,KAAA,CAAM,CAAA,OAAA,EAAU,UAAA,CAAW,IAAI,CAAA,sBAAA,CAAwB,CAAA;AAAA,EACrE;AAEA,EAAA,OAAO;AAAA,IACH,WAAA;AAAA,IACA,UAAA,EAAY,KAAA,CAAM,IAAA,CAAK,UAAU;AAAA,GACrC;AACJ;AAKA,IAAI,WAAA,GAAc,KAAA;AAQX,SAAS,WAAA,CAAY,OAAA,GAA0B,EAAC,EACvD;AACI,EAAA,IAAI,WAAA,EACJ;AACI,IAAA,OAAO;AAAA,MACH,aAAa,EAAC;AAAA,MACd,YAAY;AAAC,KACjB;AAAA,EACJ;AAEA,EAAA,WAAA,GAAc,IAAA;AACd,EAAA,OAAO,QAAQ,OAAO,CAAA;AAC1B;AAKO,SAAS,iBAAA,GAChB;AACI,EAAA,WAAA,GAAc,KAAA;AAClB","file":"loader.js","sourcesContent":["/**\n * Environment Variable Loader\n *\n * Next.js 스타일의 환경변수 파일 로딩\n *\n * @example\n * ```typescript\n * import { loadEnv } from '@spfn/core/env/loader';\n *\n * // SPFN 서버 진입점에서 호출\n * loadEnv();\n *\n * // 이후 스키마 검증\n * const env = createEnvRegistry(envSchema).validate();\n * ```\n *\n * @module env/loader\n */\n\nimport { existsSync, readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { parse } from 'dotenv';\nimport { logger } from '@spfn/core/logger';\n\nconst envLogger = logger.child('@spfn/core:env-loader');\n\n/**\n * loadEnv 옵션\n */\nexport interface LoadEnvOptions\n{\n    /**\n     * 프로젝트 루트 경로\n     * @default process.cwd()\n     */\n    cwd?: string;\n\n    /**\n     * 디버그 모드 (로드된 파일 로깅)\n     * @default false\n     */\n    debug?: boolean;\n\n    /**\n     * 기존 process.env 값 덮어쓰기 허용\n     * @default false\n     */\n    override?: boolean;\n}\n\n/**\n * 환경변수 파일 로딩 순서 (우선순위 낮음 → 높음)\n *\n * 1. .env              - 기본값 (커밋 O)\n * 2. .env.local        - 로컬 오버라이드 (커밋 X)\n * 3. .env.server       - 서버 전용 기본값 (커밋 O)\n * 4. .env.server.local - 서버 전용 민감정보 (커밋 X)\n */\nconst ENV_FILES = [\n    '.env',\n    '.env.local',\n    '.env.server',\n    '.env.server.local',\n] as const;\n\n/**\n * 단일 .env 파일 파싱\n */\nfunction parseEnvFile(filePath: string): Record<string, string> | null\n{\n    if (!existsSync(filePath))\n    {\n        return null;\n    }\n\n    const content = readFileSync(filePath, 'utf-8');\n    return parse(content);\n}\n\n/**\n * 환경변수 로드 결과\n */\nexport interface LoadEnvResult\n{\n    /**\n     * 로드된 파일 목록\n     */\n    loadedFiles: string[];\n\n    /**\n     * 로드된 환경변수 키 목록\n     */\n    loadedKeys: string[];\n}\n\n/**\n * 프로젝트 루트의 환경변수 파일들을 규칙에 따라 로드\n *\n * Next.js 스타일의 우선순위를 따름:\n * - .env → .env.local → .env.server → .env.server.local\n * - 나중에 로드된 값이 이전 값을 덮어씀\n *\n * @param options - 로드 옵션\n * @returns 로드 결과 (로드된 파일, 키 목록)\n *\n * @example\n * ```typescript\n * // 기본 사용\n * loadEnv();\n *\n * // 커스텀 경로\n * loadEnv({ cwd: '/path/to/project' });\n *\n * // 디버그 모드\n * loadEnv({ debug: true });\n * ```\n */\nexport function loadEnv(options: LoadEnvOptions = {}): LoadEnvResult\n{\n    const {\n        cwd = process.cwd(),\n        debug = false,\n        override = false,\n    } = options;\n\n    const loadedFiles: string[] = [];\n    const loadedKeys = new Set<string>();\n\n    for (const fileName of ENV_FILES)\n    {\n        const filePath = resolve(cwd, fileName);\n        const parsed = parseEnvFile(filePath);\n\n        if (parsed === null)\n        {\n            continue;\n        }\n\n        loadedFiles.push(fileName);\n\n        for (const [key, value] of Object.entries(parsed))\n        {\n            // 기존 값이 있고 override가 false면 스킵\n            if (!override && process.env[key] !== undefined)\n            {\n                continue;\n            }\n\n            process.env[key] = value;\n            loadedKeys.add(key);\n        }\n    }\n\n    if (debug && loadedFiles.length > 0)\n    {\n        envLogger.debug(`Loaded env files: ${loadedFiles.join(', ')}`);\n        envLogger.debug(`Loaded ${loadedKeys.size} environment variables`);\n    }\n\n    return {\n        loadedFiles,\n        loadedKeys: Array.from(loadedKeys),\n    };\n}\n\n/**\n * 환경변수가 이미 로드되었는지 확인하는 플래그\n */\nlet isEnvLoaded = false;\n\n/**\n * 환경변수를 한 번만 로드 (중복 호출 방지)\n *\n * @param options - 로드 옵션\n * @returns 로드 결과 (이미 로드된 경우 빈 결과)\n */\nexport function loadEnvOnce(options: LoadEnvOptions = {}): LoadEnvResult\n{\n    if (isEnvLoaded)\n    {\n        return {\n            loadedFiles: [],\n            loadedKeys: [],\n        };\n    }\n\n    isEnvLoaded = true;\n    return loadEnv(options);\n}\n\n/**\n * 환경변수 로드 상태 리셋 (테스트용)\n */\nexport function resetEnvLoadState(): void\n{\n    isEnvLoaded = false;\n}\n"]}
+{"version":3,"sources":["../../src/env/loader.ts"],"names":[],"mappings":"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","file":"loader.js","sourcesContent":["/**\n * Environment Variable Loader\n *\n * Next.js 스타일의 환경변수 파일 로딩 (환경별 분리 지원)\n *\n * 로딩 우선순위 (낮음 -> 높음, 나중 파일이 덮어씀):\n * 1. .env                   - 기본값 (committed)\n * 2. .env.{NODE_ENV}        - 환경별 오버라이드 (committed)\n * 3. .env.local             - 로컬 오버라이드 (gitignored, test에서 스킵)\n * 4. .env.{NODE_ENV}.local  - 환경별 시크릿 (gitignored)\n * 5. .env.server            - 서버 전용 (gitignored, Next.js 미로드)\n *\n * @example\n * ```typescript\n * import { loadEnv } from '@spfn/core/env/loader';\n *\n * // 기본 사용 (NODE_ENV 자동 감지)\n * loadEnv();\n *\n * // 특정 환경 지정\n * loadEnv({ nodeEnv: 'production' });\n *\n * // 서버 레이어 제외 (Next.js 클라이언트용)\n * loadEnv({ server: false });\n * ```\n *\n * @module env/loader\n */\n\nimport { existsSync, readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { parse } from 'dotenv';\nimport { logger } from '@spfn/core/logger';\n\nconst envLogger = logger.child('@spfn/core:env-loader');\n\n/**\n * loadEnv 옵션\n */\nexport interface LoadEnvOptions\n{\n    /**\n     * 프로젝트 루트 경로\n     * @default process.cwd()\n     */\n    cwd?: string;\n\n    /**\n     * NODE_ENV 값 (환경별 .env 파일 결정)\n     * @default process.env.NODE_ENV || 'local'\n     */\n    nodeEnv?: string;\n\n    /**\n     * 서버 전용 파일 포함 여부 (.env.server)\n     * @default true\n     */\n    server?: boolean;\n\n    /**\n     * 디버그 모드 (로드된 파일 로깅)\n     * @default false\n     */\n    debug?: boolean;\n\n    /**\n     * 기존 process.env 값 덮어쓰기 허용\n     * @default false\n     */\n    override?: boolean;\n}\n\n/**\n * 환경변수 로드 결과\n */\nexport interface LoadEnvResult\n{\n    /**\n     * 로드된 파일 목록\n     */\n    loadedFiles: string[];\n\n    /**\n     * 로드된 환경변수 키 목록\n     */\n    loadedKeys: string[];\n}\n\n/**\n * NODE_ENV에 따른 .env 파일 목록 생성 (우선순위 낮음 -> 높음)\n *\n * 더 구체적인 파일이 승리:\n * - environment > base\n * - server > shared\n * - local > committed\n */\nfunction getEnvFiles(nodeEnv: string, server: boolean): string[]\n{\n    const files: string[] = [\n        '.env',\n        `.env.${nodeEnv}`,\n    ];\n\n    // test 환경에서는 .env.local 스킵 (테스트 결정론성 보장)\n    if (nodeEnv !== 'test')\n    {\n        files.push('.env.local');\n    }\n\n    files.push(`.env.${nodeEnv}.local`);\n\n    if (server)\n    {\n        files.push('.env.server');\n    }\n\n    return files;\n}\n\n/**\n * 단일 .env 파일 파싱\n */\nfunction parseEnvFile(filePath: string): Record<string, string> | null\n{\n    if (!existsSync(filePath))\n    {\n        return null;\n    }\n\n    return parse(readFileSync(filePath, 'utf-8'));\n}\n\n/**\n * 프로젝트 루트의 환경변수 파일들을 규칙에 따라 로드\n *\n * 모든 파일을 파싱 후 머지한 뒤 process.env에 한번에 적용.\n * 이미 process.env에 존재하는 키는 덮어쓰지 않음 (플랫폼 주입 보호).\n *\n * @param options - 로드 옵션\n * @returns 로드 결과 (로드된 파일, 키 목록)\n */\nexport function loadEnv(options: LoadEnvOptions = {}): LoadEnvResult\n{\n    // Captured before any file is read: NODE_ENV decides WHICH files load, so a\n    // value that only arrives from inside a file arrives too late to matter.\n    const nodeEnvAtEntry = process.env.NODE_ENV;\n\n    const {\n        cwd = process.cwd(),\n        nodeEnv = nodeEnvAtEntry || 'local',\n        server = true,\n        debug = false,\n        override = false,\n    } = options;\n\n    const envFiles = getEnvFiles(nodeEnv, server);\n    const loadedFiles: string[] = [];\n\n    // 1) 기존 process.env 키 스냅샷 저장\n    const existingKeys = new Set(Object.keys(process.env));\n\n    // 2) 모든 .env 파일 파싱 후 머지 (나중 파일이 승리)\n    const merged: Record<string, string> = {};\n\n    for (const fileName of envFiles)\n    {\n        const filePath = resolve(cwd, fileName);\n        const parsed = parseEnvFile(filePath);\n\n        if (parsed === null)\n        {\n            continue;\n        }\n\n        loadedFiles.push(fileName);\n        Object.assign(merged, parsed);\n    }\n\n    // 3) 머지된 결과를 process.env에 적용\n    const loadedKeys: string[] = [];\n\n    for (const [key, value] of Object.entries(merged))\n    {\n        // 기존 process.env에 이미 있는 키는 스킵 (override가 false일 때)\n        if (!override && existingKeys.has(key))\n        {\n            continue;\n        }\n\n        process.env[key] = value;\n        loadedKeys.push(key);\n    }\n\n    if (debug && loadedFiles.length > 0)\n    {\n        envLogger.debug(`Loaded env files: ${loadedFiles.join(', ')}`);\n        envLogger.debug(`Loaded ${loadedKeys.length} environment variables`);\n    }\n\n    warnIfEnvGuessCostSomething(cwd, nodeEnvAtEntry, options.nodeEnv, nodeEnv);\n\n    return { loadedFiles, loadedKeys };\n}\n\n/**\n * Warn when guessing NODE_ENV actually cost the caller something.\n *\n * `getEnvFiles` runs before any file is parsed, so NODE_ENV decides WHICH files\n * load and a value set inside .env.server arrives too late to affect that. The\n * warning therefore reports a missed file, not a missing variable — the previous\n * version announced the variable itself and fired on every boot of a correctly\n * configured app (issue #136).\n *\n * Silent when the guess cost nothing: the guess matched what the files declare,\n * or it did not match but no `.env.<declared>` file exists to have been skipped.\n *\n * @param cwd - project root the files were resolved against\n * @param nodeEnvAtEntry - NODE_ENV as the process was started with\n * @param explicitNodeEnv - nodeEnv passed by the caller, if any\n * @param resolvedNodeEnv - the value the file list was actually built from\n */\nfunction warnIfEnvGuessCostSomething(\n    cwd: string,\n    nodeEnvAtEntry: string | undefined,\n    explicitNodeEnv: string | undefined,\n    resolvedNodeEnv: string,\n): void\n{\n    // Nothing was guessed — the process or the caller named the environment.\n    if (nodeEnvAtEntry || explicitNodeEnv)\n    {\n        return;\n    }\n\n    const declared = process.env.NODE_ENV;\n\n    if (!declared)\n    {\n        envLogger.warn(\n            `NODE_ENV is not set anywhere; env files were resolved for \"${resolvedNodeEnv}\".`\n            + ' Set NODE_ENV in the process environment to choose the file set.',\n        );\n\n        return;\n    }\n\n    if (declared === resolvedNodeEnv)\n    {\n        return;\n    }\n\n    // The guess was wrong, but a file set only goes missing if the file exists.\n    if (!existsSync(resolve(cwd, `.env.${declared}`)))\n    {\n        return;\n    }\n\n    envLogger.warn(\n        `.env.${declared} was NOT loaded: NODE_ENV was not set when the process started,`\n        + ` so env files were resolved for \"${resolvedNodeEnv}\" before a file declared`\n        + ` NODE_ENV=${declared}. Set NODE_ENV in the process environment, not in a .env file.`,\n    );\n}\n\n/**\n * 환경변수가 이미 로드되었는지 확인하는 플래그\n */\nlet isEnvLoaded = false;\n\n/**\n * 환경변수를 한 번만 로드 (중복 호출 방지)\n *\n * @param options - 로드 옵션\n * @returns 로드 결과 (이미 로드된 경우 빈 결과)\n */\nexport function loadEnvOnce(options: LoadEnvOptions = {}): LoadEnvResult\n{\n    if (isEnvLoaded)\n    {\n        return { loadedFiles: [], loadedKeys: [] };\n    }\n\n    isEnvLoaded = true;\n\n    return loadEnv(options);\n}\n\n/**\n * 환경변수 로드 상태 리셋 (테스트용)\n */\nexport function resetEnvLoadState(): void\n{\n    isEnvLoaded = false;\n}\n"]}

package/dist/errors/index.d.ts

@@ -179,6 +179,14 @@ declare class DatabaseError<TDetails extends Record<string, unknown> = Record<st
         statusCode?: number;
         details?: TDetails;
     });
+    /**
+     * Whether this error's message/details are derived from the raw database
+     * driver (SQL text, table/column/constraint names, parameter values) and
+     * therefore must NOT be exposed to clients in production. Defined as a
+     * prototype getter so it is never serialized into the response by toJSON().
+     * Subclasses with a safe, constructed message override this to `false`.
+     */
+    get internal(): boolean;
 }
 /**
  * Connection Error (503 Service Unavailable)
@@ -215,6 +223,7 @@ declare class EntityNotFoundError extends QueryError {
         resource: string;
         id: string | number;
     });
+    get internal(): boolean;
 }
 /**
  * Constraint Violation Error (400 Bad Request)
@@ -263,6 +272,7 @@ declare class DuplicateEntryError extends QueryError {
         field: string;
         value: string | number;
     });
+    get internal(): boolean;
 }
 
 type databaseErrors_ConnectionError = ConnectionError;

package/dist/errors/index.js

@@ -1,3 +1,5 @@
+import { logger } from '@spfn/core/logger';
+
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -68,7 +70,8 @@ var ErrorRegistry = class _ErrorRegistry {
     if (!ErrorClass) {
       throw new Error(`Unknown error type: ${data.__type}`);
     }
-    return new ErrorClass(data);
+    const { __type: _type, error: _envelope, ...fields } = data;
+    return new ErrorClass(fields);
   }
   /**
    * Try to deserialize error, return null if type unknown
@@ -111,8 +114,15 @@ __export(http_errors_exports, {
   UnsupportedMediaTypeError: () => UnsupportedMediaTypeError,
   ValidationError: () => ValidationError
 });
-
-// src/errors/serializable-error.ts
+var RESERVED_RESPONSE_KEYS = /* @__PURE__ */ new Set(["__type", "message", "error"]);
+var AUTHORING_ENVIRONMENTS = /* @__PURE__ */ new Set(["local", "development", "test"]);
+function refuseReservedKey(className, key) {
+  const detail = `${className} declares the reserved field "${key}". Reserved response keys: ${[...RESERVED_RESPONSE_KEYS].join(", ")}. Rename the field.`;
+  if (AUTHORING_ENVIRONMENTS.has(process.env.NODE_ENV ?? "local")) {
+    throw new Error(detail);
+  }
+  logger.error(`[SerializableError] ${detail} The field is omitted from the response.`);
+}
 var SerializableError = class extends Error {
   /**
    * Serialize error to JSON-compatible object
@@ -128,9 +138,14 @@ var SerializableError = class extends Error {
       message: this.message
     };
     for (const key of Object.keys(this)) {
-      if (key !== "name" && key !== "message" && key !== "stack" && key !== "statusCode") {
-        json[key] = this[key];
+      if (key === "name" || key === "stack" || key === "statusCode") {
+        continue;
+      }
+      if (RESERVED_RESPONSE_KEYS.has(key)) {
+        refuseReservedKey(this.constructor.name, key);
+        continue;
       }
+      json[key] = this[key];
     }
     return json;
   }
@@ -321,6 +336,16 @@ var DatabaseError = class extends SerializableError {
     this.details = data.details;
     Error.captureStackTrace(this, this.constructor);
   }
+  /**
+   * Whether this error's message/details are derived from the raw database
+   * driver (SQL text, table/column/constraint names, parameter values) and
+   * therefore must NOT be exposed to clients in production. Defined as a
+   * prototype getter so it is never serialized into the response by toJSON().
+   * Subclasses with a safe, constructed message override this to `false`.
+   */
+  get internal() {
+    return true;
+  }
 };
 var ConnectionError = class extends DatabaseError {
   constructor(data) {
@@ -351,6 +376,10 @@ var EntityNotFoundError = class extends QueryError {
     this.resource = data.resource;
     this.id = data.id;
   }
+  // Message/details are constructed from the resource + id, not driver text
+  get internal() {
+    return false;
+  }
 };
 var ConstraintViolationError = class extends QueryError {
   constructor(data) {
@@ -379,14 +408,18 @@ var DuplicateEntryError = class extends QueryError {
   value;
   constructor(data) {
     super({
-      message: `${data.field} '${data.value}' already exists`,
+      message: `${data.field} already exists`,
       statusCode: 409,
-      details: { field: data.field, value: data.value }
+      details: { field: data.field }
     });
     this.name = "DuplicateEntryError";
     this.field = data.field;
     this.value = data.value;
   }
+  // Field-only message/details — safe to surface to the client (not internal)
+  get internal() {
+    return false;
+  }
 };
 
 // src/errors/error-utils.ts

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/errors/error-registry.ts","../../src/errors/http-errors.ts","../../src/errors/serializable-error.ts","../../src/errors/database-errors.ts","../../src/errors/error-utils.ts","../../src/errors/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Error Registry\n *\n * Central registry for serializable error types.\n * Enables automatic error deserialization on the client side.\n */\n\nimport type { SerializableError } from './serializable-error';\n\n/**\n * Error constructor type\n */\nexport type SerializableErrorConstructor = new (data: any) => SerializableError;\n\n/**\n * Input type for ErrorRegistry constructor\n */\nexport type ErrorRegistryInput =\n    | SerializableErrorConstructor\n    | SerializableErrorConstructor[]\n    | ErrorRegistry;\n\n/**\n * Error registry for serialization/deserialization\n *\n * @example\n * ```typescript\n * // Create registry with initial errors\n * const registry = new ErrorRegistry([\n *     errorRegistry,           // Another ErrorRegistry\n *     PaymentFailedError,      // Single error class\n *     [RefundError, OrderError], // Array of error classes\n * ]);\n *\n * // Or create empty and append\n * const registry = new ErrorRegistry();\n * registry\n *     .append(ValidationError)\n *     .append([PaymentFailedError, RefundError]);\n *\n * // Deserialize from JSON\n * const error = registry.deserialize({\n *     __type: 'PaymentFailedError',\n *     message: 'Payment failed',\n *     transactionId: 'tx_123',\n *     reason: 'insufficient_funds'\n * });\n *\n * // error instanceof PaymentFailedError === true\n * ```\n */\nexport class ErrorRegistry\n{\n    private errors = new Map<string, SerializableErrorConstructor>();\n\n    constructor(initialErrors?: ErrorRegistryInput[])\n    {\n        if (initialErrors)\n        {\n            for (const input of initialErrors)\n            {\n                if (input instanceof ErrorRegistry)\n                {\n                    this.concat(input);\n                }\n                else if (Array.isArray(input))\n                {\n                    this.append(input);\n                }\n                else\n                {\n                    this.append(input);\n                }\n            }\n        }\n    }\n\n    /**\n     * Append error class(es) to the registry\n     *\n     * @param ErrorClass - Single error constructor\n     * @returns This registry for chaining\n     */\n    append(ErrorClass: SerializableErrorConstructor): this;\n\n    /**\n     * Append error class(es) to the registry\n     *\n     * @param ErrorClasses - Array of error constructors\n     * @returns This registry for chaining\n     */\n    append(ErrorClasses: SerializableErrorConstructor[]): this;\n\n    /**\n     * Append error class(es) to the registry\n     *\n     * @param input - Error constructor or array of constructors\n     * @returns This registry for chaining\n     */\n    append(input: SerializableErrorConstructor | SerializableErrorConstructor[]): this\n    {\n        if (Array.isArray(input))\n        {\n            for (const ErrorClass of input)\n            {\n                this.errors.set(ErrorClass.name, ErrorClass);\n            }\n        }\n        else\n        {\n            this.errors.set(input.name, input);\n        }\n\n        return this;\n    }\n\n    /**\n     * Concatenate another ErrorRegistry into this one\n     *\n     * @param registry - Another ErrorRegistry to merge\n     * @returns This registry for chaining\n     */\n    concat(registry: ErrorRegistry): this\n    {\n        for (const [name, ErrorClass] of registry.errors)\n        {\n            this.errors.set(name, ErrorClass);\n        }\n\n        return this;\n    }\n\n    /**\n     * Check if error type is registered\n     *\n     * @param name - Error class name\n     */\n    has(name: string): boolean\n    {\n        return this.errors.has(name);\n    }\n\n    /**\n     * Deserialize error from JSON data\n     *\n     * @param data - Serialized error data with __type field\n     * @returns Deserialized error instance\n     * @throws Error if error type is not registered\n     */\n    deserialize(data: { __type: string; [key: string]: any }): SerializableError\n    {\n        const ErrorClass = this.errors.get(data.__type);\n\n        if (!ErrorClass)\n        {\n            throw new Error(`Unknown error type: ${data.__type}`);\n        }\n\n        // Pass entire data object to constructor\n        return new ErrorClass(data);\n    }\n\n    /**\n     * Try to deserialize error, return null if type unknown\n     *\n     * @param data - Serialized error data\n     * @returns Deserialized error or null\n     */\n    tryDeserialize(data: { __type?: string; [key: string]: any }): SerializableError | null\n    {\n        if (!data.__type || !this.has(data.__type))\n        {\n            return null;\n        }\n\n        try\n        {\n            return this.deserialize(data as any);\n        }\n        catch\n        {\n            return null;\n        }\n    }\n\n    /**\n     * Get all registered error types\n     */\n    getRegisteredTypes(): string[]\n    {\n        return Array.from(this.errors.keys());\n    }\n}","/**\n * HTTP Error Classes\n *\n * Standard HTTP error classes for API responses\n * All errors are serializable for type-safe client-side error handling\n */\n\nimport { SerializableError } from './serializable-error';\n\n/**\n * Base HTTP Error\n *\n * Base class for all HTTP-related errors\n */\nexport class HttpError extends SerializableError\n{\n    public readonly statusCode: number;\n    public details?: Record<string, unknown>;\n\n    constructor(data: {\n        message: string;\n        statusCode: number;\n        details?: Record<string, unknown>;\n    })\n    {\n        super(data.message);\n\n        this.name = 'HttpError';\n        this.statusCode = data.statusCode;\n\n        if (data.details)\n        {\n            this.details = data.details;\n        }\n\n        Error.captureStackTrace(this, this.constructor);\n    }\n}\n\n/**\n * Bad Request Error (400)\n *\n * Generic bad request - malformed syntax, invalid parameters, etc.\n */\nexport class BadRequestError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Bad request',\n            statusCode: 400,\n            details: data.details,\n        });\n\n        this.name = 'BadRequestError';\n    }\n}\n\n/**\n * Validation Error (400)\n *\n * Input validation failure (request params, query, body)\n * Used by define-route system for automatic validation\n */\nexport class ValidationError extends HttpError\n{\n    fields?: Array<{ path: string; message: string; value?: any }>;\n\n    constructor(data: {\n        message: string;\n        fields?: Array<{ path: string; message: string; value?: any }>;\n        details?: Record<string, any>;\n    })\n    {\n        super({\n            message: data.message,\n            statusCode: 400,\n            details: data.details,\n        });\n\n        this.name = 'ValidationError';\n\n        if (data.fields)\n        {\n            this.fields = data.fields;\n        }\n    }\n}\n\n/**\n * Unauthorized Error (401)\n *\n * Authentication required or authentication failed\n */\nexport class UnauthorizedError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Authentication required',\n            statusCode: 401,\n            details: data.details,\n        });\n\n        this.name = 'UnauthorizedError';\n    }\n}\n\n/**\n * Forbidden Error (403)\n *\n * Authenticated but lacks permission to access resource\n */\nexport class ForbiddenError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Access forbidden',\n            statusCode: 403,\n            details: data.details,\n        });\n\n        this.name = 'ForbiddenError';\n    }\n}\n\n/**\n * Not Found Error (404)\n *\n * Requested resource does not exist\n */\nexport class NotFoundError extends HttpError\n{\n    resource?: string;\n\n    constructor(data: { message?: string; resource?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Resource not found',\n            statusCode: 404,\n            details: data.details,\n        });\n\n        this.name = 'NotFoundError';\n\n        if (data.resource)\n        {\n            this.resource = data.resource;\n        }\n    }\n}\n\n/**\n * Conflict Error (409)\n *\n * Generic conflict - resource state conflict, concurrent modification, etc.\n */\nexport class ConflictError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Resource conflict',\n            statusCode: 409,\n            details: data.details,\n        });\n\n        this.name = 'ConflictError';\n    }\n}\n\n/**\n * Gone Error (410)\n *\n * Resource permanently deleted and no longer available\n */\nexport class GoneError extends HttpError\n{\n    resource?: string;\n\n    constructor(data: { message?: string; resource?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Resource permanently deleted',\n            statusCode: 410,\n            details: data.details,\n        });\n\n        this.name = 'GoneError';\n\n        if (data.resource)\n        {\n            this.resource = data.resource;\n        }\n    }\n}\n\n/**\n * Too Many Requests Error (429)\n *\n * Rate limit exceeded\n */\nexport class TooManyRequestsError extends HttpError\n{\n    retryAfter?: number;\n\n    constructor(data: {\n        message?: string;\n        retryAfter?: number;\n        details?: Record<string, any>;\n    } = {})\n    {\n        super({\n            message: data.message || 'Too many requests',\n            statusCode: 429,\n            details: data.details,\n        });\n\n        this.name = 'TooManyRequestsError';\n\n        if (data.retryAfter)\n        {\n            this.retryAfter = data.retryAfter;\n        }\n    }\n}\n\n/**\n * Internal Server Error (500)\n *\n * Generic server error when no specific error type applies\n */\nexport class InternalServerError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Internal server error',\n            statusCode: 500,\n            details: data.details,\n        });\n\n        this.name = 'InternalServerError';\n    }\n}\n\n/**\n * Unsupported Media Type Error (415)\n *\n * Media type not supported - invalid file type, content type, etc.\n */\nexport class UnsupportedMediaTypeError extends HttpError\n{\n    mediaType?: string;\n    supportedTypes?: string[];\n\n    constructor(data: {\n        message?: string;\n        mediaType?: string;\n        supportedTypes?: string[];\n        details?: Record<string, any>;\n    } = {})\n    {\n        super({\n            message: data.message || 'Unsupported media type',\n            statusCode: 415,\n            details: data.details,\n        });\n\n        this.name = 'UnsupportedMediaTypeError';\n\n        if (data.mediaType)\n        {\n            this.mediaType = data.mediaType;\n        }\n\n        if (data.supportedTypes)\n        {\n            this.supportedTypes = data.supportedTypes;\n        }\n    }\n}\n\n/**\n * Unprocessable Entity Error (422)\n *\n * Request is well-formed but contains semantic errors\n */\nexport class UnprocessableEntityError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Unprocessable entity',\n            statusCode: 422,\n            details: data.details,\n        });\n\n        this.name = 'UnprocessableEntityError';\n    }\n}\n\n/**\n * Service Unavailable Error (503)\n *\n * Service temporarily unavailable (maintenance, overload, etc.)\n */\nexport class ServiceUnavailableError extends HttpError\n{\n    retryAfter?: number;\n\n    constructor(data: {\n        message?: string;\n        retryAfter?: number;\n        details?: Record<string, any>;\n    } = {})\n    {\n        super({\n            message: data.message || 'Service unavailable',\n            statusCode: 503,\n            details: data.details,\n        });\n\n        this.name = 'ServiceUnavailableError';\n\n        if (data.retryAfter)\n        {\n            this.retryAfter = data.retryAfter;\n        }\n    }\n}","/**\n * Serializable Error Base Class\n *\n * Base class for errors that can be serialized/deserialized across HTTP boundary.\n * Automatically serializes public fields for transmission to client.\n */\n\n/**\n * Serialized error format for JSON transmission\n */\nexport interface SerializedError\n{\n    __type: string;\n    message: string;\n    [key: string]: unknown;\n}\n\n/**\n * Base class for all serializable errors\n *\n * Features:\n * - Auto-serialization of public fields via toJSON()\n * - Constructor accepts object with all fields\n * - Type-safe error handling with instanceof\n *\n * @example\n * ```typescript\n * class PaymentFailedError extends SerializableError\n * {\n *     readonly statusCode = 402;\n *     transactionId!: string;\n *     reason!: 'insufficient_funds' | 'card_declined';\n *\n *     constructor(data: {\n *         message: string;\n *         transactionId: string;\n *         reason: 'insufficient_funds' | 'card_declined';\n *     })\n *     {\n *         super(data.message);\n *         this.name = 'PaymentFailedError';\n *         Object.assign(this, data);\n *     }\n * }\n * ```\n */\nexport abstract class SerializableError extends Error\n{\n    /**\n     * HTTP status code for this error type\n     */\n    abstract readonly statusCode: number;\n\n    /**\n     * Serialize error to JSON-compatible object\n     *\n     * Automatically includes:\n     * - __type: Constructor name for deserialization\n     * - message: Error message\n     * - All public instance properties (except name, stack)\n     */\n    toJSON(): SerializedError\n    {\n        const json: SerializedError = {\n            __type: this.constructor.name,\n            message: this.message,\n        };\n\n        // Extract all public instance properties\n        for (const key of Object.keys(this))\n        {\n            // Skip Error built-ins and statusCode (inferred from type)\n            if (key !== 'name' && key !== 'message' && key !== 'stack' && key !== 'statusCode')\n            {\n                json[key] = (this as unknown as Record<string, unknown>)[key];\n            }\n        }\n\n        return json;\n    }\n}\n","/**\n * Database Error Classes\n *\n * Type-safe error handling with custom error class hierarchy\n * Mapped to HTTP status codes for API responses\n * All errors extend SerializableError for consistent JSON serialization\n */\n\nimport { SerializableError } from './serializable-error';\n\n/**\n * Base Database Error\n *\n * Base class for all database-related errors\n */\nexport class DatabaseError<TDetails extends Record<string, unknown> = Record<string, unknown>>\n    extends SerializableError\n{\n    public readonly statusCode: number;\n    public readonly details?: TDetails;\n\n    constructor(data: {\n        message: string;\n        statusCode?: number;\n        details?: TDetails;\n    })\n    {\n        super(data.message);\n        this.name = 'DatabaseError';\n        this.statusCode = data.statusCode ?? 500;\n        this.details = data.details;\n        Error.captureStackTrace(this, this.constructor);\n    }\n}\n\n/**\n * Connection Error (503 Service Unavailable)\n *\n * Database connection failure, connection pool exhaustion, etc.\n */\nexport class ConnectionError extends DatabaseError\n{\n    constructor(data: { message: string; details?: Record<string, unknown> })\n    {\n        super({ message: data.message, statusCode: 503, details: data.details });\n        this.name = 'ConnectionError';\n    }\n}\n\n/**\n * Query Error (500 Internal Server Error)\n *\n * SQL query execution failure, syntax errors, etc.\n */\nexport class QueryError extends DatabaseError\n{\n    constructor(data: {\n        message: string;\n        statusCode?: number;\n        details?: Record<string, unknown>;\n    })\n    {\n        super({\n            message: data.message,\n            statusCode: data.statusCode ?? 500,\n            details: data.details,\n        });\n        this.name = 'QueryError';\n    }\n}\n\n/**\n * Entity Not Found Error (404 Not Found)\n *\n * Database entity does not exist\n */\nexport class EntityNotFoundError extends QueryError\n{\n    public readonly resource: string;\n    public readonly id: string | number;\n\n    constructor(data: { resource: string; id: string | number })\n    {\n        super({\n            message: `${data.resource} with id ${data.id} not found`,\n            statusCode: 404,\n            details: { resource: data.resource, id: data.id },\n        });\n        this.name = 'EntityNotFoundError';\n        this.resource = data.resource;\n        this.id = data.id;\n    }\n}\n\n/**\n * Constraint Violation Error (400 Bad Request)\n *\n * Database constraint violation (NOT NULL, CHECK, FOREIGN KEY, etc.)\n * This is different from HTTP ValidationError which validates request input\n */\nexport class ConstraintViolationError extends QueryError\n{\n    constructor(data: { message: string; details?: Record<string, unknown> })\n    {\n        super({ message: data.message, statusCode: 400, details: data.details });\n        this.name = 'ConstraintViolationError';\n    }\n}\n\n/**\n * Transaction Error (500 Internal Server Error)\n *\n * Transaction start/commit/rollback failure\n */\nexport class TransactionError extends DatabaseError\n{\n    constructor(data: {\n        message: string;\n        statusCode?: number;\n        details?: Record<string, unknown>;\n    })\n    {\n        super({\n            message: data.message,\n            statusCode: data.statusCode ?? 500,\n            details: data.details,\n        });\n        this.name = 'TransactionError';\n    }\n}\n\n/**\n * Deadlock Error (409 Conflict)\n *\n * Database deadlock detected\n */\nexport class DeadlockError extends TransactionError\n{\n    constructor(data: { message: string; details?: Record<string, unknown> })\n    {\n        super({ message: data.message, statusCode: 409, details: data.details });\n        this.name = 'DeadlockError';\n    }\n}\n\n/**\n * Duplicate Entry Error (409 Conflict)\n *\n * Unique constraint violation (e.g., duplicate email)\n */\nexport class DuplicateEntryError extends QueryError\n{\n    public readonly field: string;\n    public readonly value: string | number;\n\n    constructor(data: { field: string; value: string | number })\n    {\n        super({\n            message: `${data.field} '${data.value}' already exists`,\n            statusCode: 409,\n            details: { field: data.field, value: data.value },\n        });\n        this.name = 'DuplicateEntryError';\n        this.field = data.field;\n        this.value = data.value;\n    }\n}\n","/**\n * Error Utility Functions\n *\n * Generic error type checking utilities\n */\n\nimport { DatabaseError } from './database-errors';\nimport { HttpError } from './http-errors';\n\n/**\n * Check if error is a DatabaseError\n */\nexport function isDatabaseError(error: unknown): error is DatabaseError\n{\n    return error instanceof DatabaseError;\n}\n\n/**\n * Check if error is an HttpError\n */\nexport function isHttpError(error: unknown): error is HttpError\n{\n    return error instanceof HttpError;\n}\n\n/**\n * Check if error has a statusCode property\n */\nexport function hasStatusCode(error: unknown): error is { statusCode: number }\n{\n    return (\n        typeof error === 'object' &&\n        error !== null &&\n        'statusCode' in error &&\n        typeof (error as any).statusCode === 'number'\n    );\n}\n","/**\n * Error Module Exports\n *\n * Entry point for error handling module with serialization support\n */\n\n// Core Error Registry\n// Pre-configured registry with all built-in HTTP and Database errors\nimport { ErrorRegistry } from './error-registry';\nimport {\n    HttpError,\n    BadRequestError,\n    ValidationError,\n    UnauthorizedError,\n    ForbiddenError,\n    NotFoundError,\n    ConflictError,\n    GoneError,\n    TooManyRequestsError,\n    UnsupportedMediaTypeError,\n    UnprocessableEntityError,\n    InternalServerError,\n    ServiceUnavailableError,\n} from './http-errors';\nimport {\n    DatabaseError,\n    ConnectionError,\n    QueryError,\n    EntityNotFoundError,\n    ConstraintViolationError,\n    TransactionError,\n    DeadlockError,\n    DuplicateEntryError,\n} from './database-errors';\n\n// Base Classes\nexport { SerializableError } from './serializable-error';\nexport type { SerializedError } from './serializable-error';\nexport { ErrorRegistry } from './error-registry';\nexport type { SerializableErrorConstructor, ErrorRegistryInput } from './error-registry';\n\n// Database Error Classes\nexport {\n    DatabaseError,\n    ConnectionError,\n    QueryError,\n    EntityNotFoundError,\n    ConstraintViolationError,\n    TransactionError,\n    DeadlockError,\n    DuplicateEntryError,\n} from './database-errors';\n\n// HTTP Error Classes\nexport {\n    HttpError,\n    BadRequestError,\n    ValidationError,\n    UnauthorizedError,\n    ForbiddenError,\n    NotFoundError,\n    ConflictError,\n    GoneError,\n    TooManyRequestsError,\n    UnsupportedMediaTypeError,\n    UnprocessableEntityError,\n    InternalServerError,\n    ServiceUnavailableError,\n} from './http-errors';\n\n// Error Utilities\nexport {\n    isDatabaseError,\n    isHttpError,\n    hasStatusCode,\n} from './error-utils';\n\nexport const errorRegistry = new ErrorRegistry();\n\n// HTTP Errors\nerrorRegistry.append([\n    HttpError,\n    BadRequestError,\n    ValidationError,\n    UnauthorizedError,\n    ForbiddenError,\n    NotFoundError,\n    ConflictError,\n    GoneError,\n    TooManyRequestsError,\n    UnsupportedMediaTypeError,\n    UnprocessableEntityError,\n    InternalServerError,\n    ServiceUnavailableError,\n]);\n\n// Database Errors\nerrorRegistry.append([\n    DatabaseError,\n    ConnectionError,\n    QueryError,\n    EntityNotFoundError,\n    ConstraintViolationError,\n    TransactionError,\n    DeadlockError,\n    DuplicateEntryError,\n]);\n\nexport * as HttpErrors from './http-errors';\nexport * as DatabaseErrors from './database-errors';"]}
+{"version":3,"sources":["../../src/errors/error-registry.ts","../../src/errors/http-errors.ts","../../src/errors/serializable-error.ts","../../src/errors/database-errors.ts","../../src/errors/error-utils.ts","../../src/errors/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Error Registry\n *\n * Central registry for serializable error types.\n * Enables automatic error deserialization on the client side.\n */\n\nimport type { SerializableError } from './serializable-error';\n\n/**\n * Error constructor type\n */\nexport type SerializableErrorConstructor = new (data: any) => SerializableError;\n\n/**\n * Input type for ErrorRegistry constructor\n */\nexport type ErrorRegistryInput =\n    | SerializableErrorConstructor\n    | SerializableErrorConstructor[]\n    | ErrorRegistry;\n\n/**\n * Error registry for serialization/deserialization\n *\n * @example\n * ```typescript\n * // Create registry with initial errors\n * const registry = new ErrorRegistry([\n *     errorRegistry,           // Another ErrorRegistry\n *     PaymentFailedError,      // Single error class\n *     [RefundError, OrderError], // Array of error classes\n * ]);\n *\n * // Or create empty and append\n * const registry = new ErrorRegistry();\n * registry\n *     .append(ValidationError)\n *     .append([PaymentFailedError, RefundError]);\n *\n * // Deserialize from JSON\n * const error = registry.deserialize({\n *     __type: 'PaymentFailedError',\n *     message: 'Payment failed',\n *     transactionId: 'tx_123',\n *     reason: 'insufficient_funds'\n * });\n *\n * // error instanceof PaymentFailedError === true\n * ```\n */\nexport class ErrorRegistry\n{\n    private errors = new Map<string, SerializableErrorConstructor>();\n\n    constructor(initialErrors?: ErrorRegistryInput[])\n    {\n        if (initialErrors)\n        {\n            for (const input of initialErrors)\n            {\n                if (input instanceof ErrorRegistry)\n                {\n                    this.concat(input);\n                }\n                else if (Array.isArray(input))\n                {\n                    this.append(input);\n                }\n                else\n                {\n                    this.append(input);\n                }\n            }\n        }\n    }\n\n    /**\n     * Append error class(es) to the registry\n     *\n     * @param ErrorClass - Single error constructor\n     * @returns This registry for chaining\n     */\n    append(ErrorClass: SerializableErrorConstructor): this;\n\n    /**\n     * Append error class(es) to the registry\n     *\n     * @param ErrorClasses - Array of error constructors\n     * @returns This registry for chaining\n     */\n    append(ErrorClasses: SerializableErrorConstructor[]): this;\n\n    /**\n     * Append error class(es) to the registry\n     *\n     * @param input - Error constructor or array of constructors\n     * @returns This registry for chaining\n     */\n    append(input: SerializableErrorConstructor | SerializableErrorConstructor[]): this\n    {\n        if (Array.isArray(input))\n        {\n            for (const ErrorClass of input)\n            {\n                this.errors.set(ErrorClass.name, ErrorClass);\n            }\n        }\n        else\n        {\n            this.errors.set(input.name, input);\n        }\n\n        return this;\n    }\n\n    /**\n     * Concatenate another ErrorRegistry into this one\n     *\n     * @param registry - Another ErrorRegistry to merge\n     * @returns This registry for chaining\n     */\n    concat(registry: ErrorRegistry): this\n    {\n        for (const [name, ErrorClass] of registry.errors)\n        {\n            this.errors.set(name, ErrorClass);\n        }\n\n        return this;\n    }\n\n    /**\n     * Check if error type is registered\n     *\n     * @param name - Error class name\n     */\n    has(name: string): boolean\n    {\n        return this.errors.has(name);\n    }\n\n    /**\n     * Deserialize error from JSON data\n     *\n     * @param data - Serialized error data with __type field\n     * @returns Deserialized error instance\n     * @throws Error if error type is not registered\n     */\n    deserialize(data: { __type: string; [key: string]: any }): SerializableError\n    {\n        const ErrorClass = this.errors.get(data.__type);\n\n        if (!ErrorClass)\n        {\n            throw new Error(`Unknown error type: ${data.__type}`);\n        }\n\n        // `__type` routed this lookup and `error` is the response envelope: both\n        // describe the response, not the error. The documented constructor shape\n        // is Object.assign(this, data), which would otherwise copy them onto the\n        // instance as reserved fields — and a reserved field refuses to serialize\n        // the moment a server re-throws this error.\n        const { __type: _type, error: _envelope, ...fields } = data;\n\n        return new ErrorClass(fields);\n    }\n\n    /**\n     * Try to deserialize error, return null if type unknown\n     *\n     * @param data - Serialized error data\n     * @returns Deserialized error or null\n     */\n    tryDeserialize(data: { __type?: string; [key: string]: any }): SerializableError | null\n    {\n        if (!data.__type || !this.has(data.__type))\n        {\n            return null;\n        }\n\n        try\n        {\n            return this.deserialize(data as any);\n        }\n        catch\n        {\n            return null;\n        }\n    }\n\n    /**\n     * Get all registered error types\n     */\n    getRegisteredTypes(): string[]\n    {\n        return Array.from(this.errors.keys());\n    }\n}\n","/**\n * HTTP Error Classes\n *\n * Standard HTTP error classes for API responses\n * All errors are serializable for type-safe client-side error handling\n */\n\nimport { SerializableError } from './serializable-error';\n\n/**\n * Base HTTP Error\n *\n * Base class for all HTTP-related errors\n */\nexport class HttpError extends SerializableError\n{\n    public readonly statusCode: number;\n    public details?: Record<string, unknown>;\n\n    constructor(data: {\n        message: string;\n        statusCode: number;\n        details?: Record<string, unknown>;\n    })\n    {\n        super(data.message);\n\n        this.name = 'HttpError';\n        this.statusCode = data.statusCode;\n\n        if (data.details)\n        {\n            this.details = data.details;\n        }\n\n        Error.captureStackTrace(this, this.constructor);\n    }\n}\n\n/**\n * Bad Request Error (400)\n *\n * Generic bad request - malformed syntax, invalid parameters, etc.\n */\nexport class BadRequestError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Bad request',\n            statusCode: 400,\n            details: data.details,\n        });\n\n        this.name = 'BadRequestError';\n    }\n}\n\n/**\n * Validation Error (400)\n *\n * Input validation failure (request params, query, body)\n * Used by define-route system for automatic validation\n */\nexport class ValidationError extends HttpError\n{\n    fields?: Array<{ path: string; message: string; value?: any }>;\n\n    constructor(data: {\n        message: string;\n        fields?: Array<{ path: string; message: string; value?: any }>;\n        details?: Record<string, any>;\n    })\n    {\n        super({\n            message: data.message,\n            statusCode: 400,\n            details: data.details,\n        });\n\n        this.name = 'ValidationError';\n\n        if (data.fields)\n        {\n            this.fields = data.fields;\n        }\n    }\n}\n\n/**\n * Unauthorized Error (401)\n *\n * Authentication required or authentication failed\n */\nexport class UnauthorizedError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Authentication required',\n            statusCode: 401,\n            details: data.details,\n        });\n\n        this.name = 'UnauthorizedError';\n    }\n}\n\n/**\n * Forbidden Error (403)\n *\n * Authenticated but lacks permission to access resource\n */\nexport class ForbiddenError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Access forbidden',\n            statusCode: 403,\n            details: data.details,\n        });\n\n        this.name = 'ForbiddenError';\n    }\n}\n\n/**\n * Not Found Error (404)\n *\n * Requested resource does not exist\n */\nexport class NotFoundError extends HttpError\n{\n    resource?: string;\n\n    constructor(data: { message?: string; resource?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Resource not found',\n            statusCode: 404,\n            details: data.details,\n        });\n\n        this.name = 'NotFoundError';\n\n        if (data.resource)\n        {\n            this.resource = data.resource;\n        }\n    }\n}\n\n/**\n * Conflict Error (409)\n *\n * Generic conflict - resource state conflict, concurrent modification, etc.\n */\nexport class ConflictError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Resource conflict',\n            statusCode: 409,\n            details: data.details,\n        });\n\n        this.name = 'ConflictError';\n    }\n}\n\n/**\n * Gone Error (410)\n *\n * Resource permanently deleted and no longer available\n */\nexport class GoneError extends HttpError\n{\n    resource?: string;\n\n    constructor(data: { message?: string; resource?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Resource permanently deleted',\n            statusCode: 410,\n            details: data.details,\n        });\n\n        this.name = 'GoneError';\n\n        if (data.resource)\n        {\n            this.resource = data.resource;\n        }\n    }\n}\n\n/**\n * Too Many Requests Error (429)\n *\n * Rate limit exceeded\n */\nexport class TooManyRequestsError extends HttpError\n{\n    retryAfter?: number;\n\n    constructor(data: {\n        message?: string;\n        retryAfter?: number;\n        details?: Record<string, any>;\n    } = {})\n    {\n        super({\n            message: data.message || 'Too many requests',\n            statusCode: 429,\n            details: data.details,\n        });\n\n        this.name = 'TooManyRequestsError';\n\n        if (data.retryAfter)\n        {\n            this.retryAfter = data.retryAfter;\n        }\n    }\n}\n\n/**\n * Internal Server Error (500)\n *\n * Generic server error when no specific error type applies\n */\nexport class InternalServerError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Internal server error',\n            statusCode: 500,\n            details: data.details,\n        });\n\n        this.name = 'InternalServerError';\n    }\n}\n\n/**\n * Unsupported Media Type Error (415)\n *\n * Media type not supported - invalid file type, content type, etc.\n */\nexport class UnsupportedMediaTypeError extends HttpError\n{\n    mediaType?: string;\n    supportedTypes?: string[];\n\n    constructor(data: {\n        message?: string;\n        mediaType?: string;\n        supportedTypes?: string[];\n        details?: Record<string, any>;\n    } = {})\n    {\n        super({\n            message: data.message || 'Unsupported media type',\n            statusCode: 415,\n            details: data.details,\n        });\n\n        this.name = 'UnsupportedMediaTypeError';\n\n        if (data.mediaType)\n        {\n            this.mediaType = data.mediaType;\n        }\n\n        if (data.supportedTypes)\n        {\n            this.supportedTypes = data.supportedTypes;\n        }\n    }\n}\n\n/**\n * Unprocessable Entity Error (422)\n *\n * Request is well-formed but contains semantic errors\n */\nexport class UnprocessableEntityError extends HttpError\n{\n    constructor(data: { message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Unprocessable entity',\n            statusCode: 422,\n            details: data.details,\n        });\n\n        this.name = 'UnprocessableEntityError';\n    }\n}\n\n/**\n * Service Unavailable Error (503)\n *\n * Service temporarily unavailable (maintenance, overload, etc.)\n */\nexport class ServiceUnavailableError extends HttpError\n{\n    retryAfter?: number;\n\n    constructor(data: {\n        message?: string;\n        retryAfter?: number;\n        details?: Record<string, any>;\n    } = {})\n    {\n        super({\n            message: data.message || 'Service unavailable',\n            statusCode: 503,\n            details: data.details,\n        });\n\n        this.name = 'ServiceUnavailableError';\n\n        if (data.retryAfter)\n        {\n            this.retryAfter = data.retryAfter;\n        }\n    }\n}\n","/**\n * Serializable Error Base Class\n *\n * Base class for errors that can be serialized/deserialized across HTTP boundary.\n * Automatically serializes public fields for transmission to client.\n */\n\n// Package specifier, not '../logger': tsup marks `@spfn/*` external, so a\n// relative import would inline a SECOND logger singleton into this entrypoint's\n// bundle — and into every bundle that imports errors (issue #136).\nimport { logger } from '@spfn/core/logger';\n\n/**\n * Serialized error format for JSON transmission\n */\nexport interface SerializedError\n{\n    __type: string;\n    message: string;\n    [key: string]: unknown;\n}\n\n/**\n * Field names an error class may not use.\n *\n * Public fields are spread into the response body next to `__type`, `message`\n * and the `error` envelope the error handler attaches, so a field sharing one\n * of those names collides with the response shape every consumer reads: the\n * web client restores an error class from `__type` and a generated mobile\n * client reads `error.code`. Reserving the three names removes the collision\n * instead of picking a winner for it — either winner loses something the other\n * side needs.\n */\nconst RESERVED_RESPONSE_KEYS = new Set(['__type', 'message', 'error']);\n\n/**\n * Environments where a developer is watching and can still rename the class.\n * Anything else is a running deployment, `staging` included — there the throw\n * would replace a real failure with a failure about serializing it, and the\n * original error would never reach the log or the client.\n */\nconst AUTHORING_ENVIRONMENTS = new Set(['local', 'development', 'test']);\n\n/**\n * Answer a reserved field name: loudly while it can still be renamed, quietly\n * once a rename is no longer possible.\n *\n * While authoring, the throw is the point — the class is renamed the first time\n * a test serializes it.\n */\nfunction refuseReservedKey(className: string, key: string): never | void\n{\n    const detail = `${className} declares the reserved field \"${key}\". `\n        + `Reserved response keys: ${[...RESERVED_RESPONSE_KEYS].join(', ')}. Rename the field.`;\n\n    if (AUTHORING_ENVIRONMENTS.has(process.env.NODE_ENV ?? 'local'))\n    {\n        throw new Error(detail);\n    }\n\n    logger.error(`[SerializableError] ${detail} The field is omitted from the response.`);\n}\n\n/**\n * Base class for all serializable errors\n *\n * Features:\n * - Auto-serialization of public fields via toJSON()\n * - Constructor accepts object with all fields\n * - Type-safe error handling with instanceof\n *\n * @example\n * ```typescript\n * class PaymentFailedError extends SerializableError\n * {\n *     readonly statusCode = 402;\n *     transactionId!: string;\n *     reason!: 'insufficient_funds' | 'card_declined';\n *\n *     constructor(data: {\n *         message: string;\n *         transactionId: string;\n *         reason: 'insufficient_funds' | 'card_declined';\n *     })\n *     {\n *         super(data.message);\n *         this.name = 'PaymentFailedError';\n *         Object.assign(this, data);\n *     }\n * }\n * ```\n */\nexport abstract class SerializableError extends Error\n{\n    /**\n     * HTTP status code for this error type\n     */\n    abstract readonly statusCode: number;\n\n    /**\n     * Serialize error to JSON-compatible object\n     *\n     * Automatically includes:\n     * - __type: Constructor name for deserialization\n     * - message: Error message\n     * - All public instance properties (except name, stack)\n     */\n    toJSON(): SerializedError\n    {\n        const json: SerializedError = {\n            __type: this.constructor.name,\n            message: this.message,\n        };\n\n        // Extract all public instance properties\n        for (const key of Object.keys(this))\n        {\n            // Skip Error built-ins and statusCode (inferred from type)\n            if (key === 'name' || key === 'stack' || key === 'statusCode')\n            {\n                continue;\n            }\n\n            if (RESERVED_RESPONSE_KEYS.has(key))\n            {\n                refuseReservedKey(this.constructor.name, key);\n                continue;\n            }\n\n            json[key] = (this as unknown as Record<string, unknown>)[key];\n        }\n\n        return json;\n    }\n}\n","/**\n * Database Error Classes\n *\n * Type-safe error handling with custom error class hierarchy\n * Mapped to HTTP status codes for API responses\n * All errors extend SerializableError for consistent JSON serialization\n */\n\nimport { SerializableError } from './serializable-error';\n\n/**\n * Base Database Error\n *\n * Base class for all database-related errors\n */\nexport class DatabaseError<TDetails extends Record<string, unknown> = Record<string, unknown>>\n    extends SerializableError\n{\n    public readonly statusCode: number;\n    public readonly details?: TDetails;\n\n    constructor(data: {\n        message: string;\n        statusCode?: number;\n        details?: TDetails;\n    })\n    {\n        super(data.message);\n        this.name = 'DatabaseError';\n        this.statusCode = data.statusCode ?? 500;\n        this.details = data.details;\n        Error.captureStackTrace(this, this.constructor);\n    }\n\n    /**\n     * Whether this error's message/details are derived from the raw database\n     * driver (SQL text, table/column/constraint names, parameter values) and\n     * therefore must NOT be exposed to clients in production. Defined as a\n     * prototype getter so it is never serialized into the response by toJSON().\n     * Subclasses with a safe, constructed message override this to `false`.\n     */\n    get internal(): boolean\n    {\n        return true;\n    }\n}\n\n/**\n * Connection Error (503 Service Unavailable)\n *\n * Database connection failure, connection pool exhaustion, etc.\n */\nexport class ConnectionError extends DatabaseError\n{\n    constructor(data: { message: string; details?: Record<string, unknown> })\n    {\n        super({ message: data.message, statusCode: 503, details: data.details });\n        this.name = 'ConnectionError';\n    }\n}\n\n/**\n * Query Error (500 Internal Server Error)\n *\n * SQL query execution failure, syntax errors, etc.\n */\nexport class QueryError extends DatabaseError\n{\n    constructor(data: {\n        message: string;\n        statusCode?: number;\n        details?: Record<string, unknown>;\n    })\n    {\n        super({\n            message: data.message,\n            statusCode: data.statusCode ?? 500,\n            details: data.details,\n        });\n        this.name = 'QueryError';\n    }\n}\n\n/**\n * Entity Not Found Error (404 Not Found)\n *\n * Database entity does not exist\n */\nexport class EntityNotFoundError extends QueryError\n{\n    public readonly resource: string;\n    public readonly id: string | number;\n\n    constructor(data: { resource: string; id: string | number })\n    {\n        super({\n            message: `${data.resource} with id ${data.id} not found`,\n            statusCode: 404,\n            details: { resource: data.resource, id: data.id },\n        });\n        this.name = 'EntityNotFoundError';\n        this.resource = data.resource;\n        this.id = data.id;\n    }\n\n    // Message/details are constructed from the resource + id, not driver text\n    override get internal(): boolean\n    {\n        return false;\n    }\n}\n\n/**\n * Constraint Violation Error (400 Bad Request)\n *\n * Database constraint violation (NOT NULL, CHECK, FOREIGN KEY, etc.)\n * This is different from HTTP ValidationError which validates request input\n */\nexport class ConstraintViolationError extends QueryError\n{\n    constructor(data: { message: string; details?: Record<string, unknown> })\n    {\n        super({ message: data.message, statusCode: 400, details: data.details });\n        this.name = 'ConstraintViolationError';\n    }\n}\n\n/**\n * Transaction Error (500 Internal Server Error)\n *\n * Transaction start/commit/rollback failure\n */\nexport class TransactionError extends DatabaseError\n{\n    constructor(data: {\n        message: string;\n        statusCode?: number;\n        details?: Record<string, unknown>;\n    })\n    {\n        super({\n            message: data.message,\n            statusCode: data.statusCode ?? 500,\n            details: data.details,\n        });\n        this.name = 'TransactionError';\n    }\n}\n\n/**\n * Deadlock Error (409 Conflict)\n *\n * Database deadlock detected\n */\nexport class DeadlockError extends TransactionError\n{\n    constructor(data: { message: string; details?: Record<string, unknown> })\n    {\n        super({ message: data.message, statusCode: 409, details: data.details });\n        this.name = 'DeadlockError';\n    }\n}\n\n/**\n * Duplicate Entry Error (409 Conflict)\n *\n * Unique constraint violation (e.g., duplicate email)\n */\nexport class DuplicateEntryError extends QueryError\n{\n    public readonly field: string;\n    public readonly value: string | number;\n\n    constructor(data: { field: string; value: string | number })\n    {\n        // The client-facing message/details name the field but NOT the value: echoing\n        // the value back (e.g. an email) confirms it exists, an enumeration aid. The\n        // raw value stays on the instance for server-side handling/logging.\n        super({\n            message: `${data.field} already exists`,\n            statusCode: 409,\n            details: { field: data.field },\n        });\n        this.name = 'DuplicateEntryError';\n        this.field = data.field;\n        this.value = data.value;\n    }\n\n    // Field-only message/details — safe to surface to the client (not internal)\n    override get internal(): boolean\n    {\n        return false;\n    }\n}\n","/**\n * Error Utility Functions\n *\n * Generic error type checking utilities\n */\n\nimport { DatabaseError } from './database-errors';\nimport { HttpError } from './http-errors';\n\n/**\n * Check if error is a DatabaseError\n */\nexport function isDatabaseError(error: unknown): error is DatabaseError\n{\n    return error instanceof DatabaseError;\n}\n\n/**\n * Check if error is an HttpError\n */\nexport function isHttpError(error: unknown): error is HttpError\n{\n    return error instanceof HttpError;\n}\n\n/**\n * Check if error has a statusCode property\n */\nexport function hasStatusCode(error: unknown): error is { statusCode: number }\n{\n    return (\n        typeof error === 'object' &&\n        error !== null &&\n        'statusCode' in error &&\n        typeof (error as any).statusCode === 'number'\n    );\n}\n","/**\n * Error Module Exports\n *\n * Entry point for error handling module with serialization support\n */\n\n// Core Error Registry\n// Pre-configured registry with all built-in HTTP and Database errors\nimport { ErrorRegistry } from './error-registry';\nimport {\n    HttpError,\n    BadRequestError,\n    ValidationError,\n    UnauthorizedError,\n    ForbiddenError,\n    NotFoundError,\n    ConflictError,\n    GoneError,\n    TooManyRequestsError,\n    UnsupportedMediaTypeError,\n    UnprocessableEntityError,\n    InternalServerError,\n    ServiceUnavailableError,\n} from './http-errors';\nimport {\n    DatabaseError,\n    ConnectionError,\n    QueryError,\n    EntityNotFoundError,\n    ConstraintViolationError,\n    TransactionError,\n    DeadlockError,\n    DuplicateEntryError,\n} from './database-errors';\n\n// Base Classes\nexport { SerializableError } from './serializable-error';\nexport type { SerializedError } from './serializable-error';\nexport { ErrorRegistry } from './error-registry';\nexport type { SerializableErrorConstructor, ErrorRegistryInput } from './error-registry';\n\n// Database Error Classes\nexport {\n    DatabaseError,\n    ConnectionError,\n    QueryError,\n    EntityNotFoundError,\n    ConstraintViolationError,\n    TransactionError,\n    DeadlockError,\n    DuplicateEntryError,\n} from './database-errors';\n\n// HTTP Error Classes\nexport {\n    HttpError,\n    BadRequestError,\n    ValidationError,\n    UnauthorizedError,\n    ForbiddenError,\n    NotFoundError,\n    ConflictError,\n    GoneError,\n    TooManyRequestsError,\n    UnsupportedMediaTypeError,\n    UnprocessableEntityError,\n    InternalServerError,\n    ServiceUnavailableError,\n} from './http-errors';\n\n// Error Utilities\nexport {\n    isDatabaseError,\n    isHttpError,\n    hasStatusCode,\n} from './error-utils';\n\nexport const errorRegistry = new ErrorRegistry();\n\n// HTTP Errors\nerrorRegistry.append([\n    HttpError,\n    BadRequestError,\n    ValidationError,\n    UnauthorizedError,\n    ForbiddenError,\n    NotFoundError,\n    ConflictError,\n    GoneError,\n    TooManyRequestsError,\n    UnsupportedMediaTypeError,\n    UnprocessableEntityError,\n    InternalServerError,\n    ServiceUnavailableError,\n]);\n\n// Database Errors\nerrorRegistry.append([\n    DatabaseError,\n    ConnectionError,\n    QueryError,\n    EntityNotFoundError,\n    ConstraintViolationError,\n    TransactionError,\n    DeadlockError,\n    DuplicateEntryError,\n]);\n\nexport * as HttpErrors from './http-errors';\nexport * as DatabaseErrors from './database-errors';\n"]}

package/dist/event/index.d.ts

@@ -1,6 +1,10 @@
 import { TSchema, Static } from '@sinclair/typebox';
-import { a as EventDef } from '../router-Di7ENoah.js';
-export { e as EventHandler, E as EventRouterDef, I as InferEventNames, f as InferEventPayload, c as InferEventPayloads, b as InferRouterEventPayload, J as JobQueueSender, P as PubSubCache, d as defineEventRouter } from '../router-Di7ENoah.js';
+import { E as EventDef } from '../token-manager-BT5EnUAR.js';
+export { a as EventHandler, b as EventRouterDef, I as InferEventNames, c as InferEventPayload, d as InferEventPayloads, e as InferRouterEventPayload, J as JobQueueSender, P as PubSubCache, f as defineEventRouter } from '../token-manager-BT5EnUAR.js';
+export { defineWSRouter } from './ws/index.js';
+import '../types-2AbaW4Ie.js';
+import 'hono';
+import 'node:http';
 
 /**
  * Event System
@@ -38,4 +42,30 @@ declare function defineEvent(name: string): EventDef<void>;
  */
 declare function defineEvent<T extends TSchema>(name: string, schema: T): EventDef<Static<T>>;
 
-export { EventDef, defineEvent };
+/**
+ * SSE Event Route Map
+ *
+ * Static route map for SSE token endpoint.
+ * Merge into RPC proxy routeMap so `eventsToken` resolves to `POST /events/token`.
+ *
+ * @example
+ * ```typescript
+ * // app/api/rpc/[routeName]/route.ts
+ * import { createRpcProxy } from '@spfn/core/nextjs/server';
+ * import { eventRouteMap } from '@spfn/core/event';
+ * import { authRouteMap } from '@spfn/auth';
+ * import { routeMap } from '@/generated/route-map';
+ *
+ * export const { GET, POST } = createRpcProxy({
+ *     routeMap: { ...routeMap, ...authRouteMap, ...eventRouteMap },
+ * });
+ * ```
+ */
+declare const eventRouteMap: {
+    eventsToken: {
+        method: "POST";
+        path: string;
+    };
+};
+
+export { EventDef, defineEvent, eventRouteMap };

package/dist/event/index.js

@@ -89,15 +89,19 @@ function createEventImpl(name, schema) {
       eventLogger.warn(`Cache already configured for event: ${name}`);
       return self;
     }
-    cache = newCache;
-    cacheSubscribed = true;
     await newCache.subscribe(name, async (message) => {
       eventLogger.debug(`Received event from cache: ${name}`);
       await handlerManager.trigger(message);
     });
+    cache = newCache;
+    cacheSubscribed = true;
     eventLogger.debug(`Cache subscription ready for event: ${name}`);
     return self;
   };
+  const resetCache = () => {
+    cache = void 0;
+    cacheSubscribed = false;
+  };
   const self = {
     name,
     schema,
@@ -106,6 +110,7 @@ function createEventImpl(name, schema) {
     emit,
     useCache,
     _registerJobQueue: jobQueueManager.register,
+    _resetCache: resetCache,
     _payload: void 0
   };
   return self;
@@ -117,6 +122,11 @@ function defineEvent(name, schema) {
   return createEventImpl(name);
 }
 
+// src/event/sse/route-map.ts
+var eventRouteMap = {
+  eventsToken: { method: "POST", path: "/events/token" }
+};
+
 // src/event/router.ts
 function defineEventRouter(events) {
   return {
@@ -125,7 +135,18 @@ function defineEventRouter(events) {
     _types: {}
   };
 }
+logger.child("@spfn/core:ws");
+
+// src/event/ws/index.ts
+function defineWSRouter(def) {
+  return {
+    events: def.events,
+    eventNames: Object.keys(def.events),
+    messages: def.messages ?? {},
+    _types: {}
+  };
+}
 
-export { defineEvent, defineEventRouter };
+export { defineEvent, defineEventRouter, defineWSRouter, eventRouteMap };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map