@spfn/core 0.1.0-alpha.64 → 0.1.0-alpha.68

package/dist/codegen/index.js

@@ -1,1503 +1,1558 @@
-import { existsSync, mkdirSync, accessSync, constants, writeFileSync, unlinkSync, readFileSync, createWriteStream, statSync, readdirSync, renameSync } from 'fs';
-import { readdir, stat, mkdir, writeFile } from 'fs/promises';
-import { join, relative } from 'path';
-import * as ts from 'typescript';
 import { watch } from 'chokidar';
-import pino from 'pino';
+import { join, relative } from 'path';
 import mm from 'micromatch';
+import pino from 'pino';
+import { existsSync, mkdirSync, accessSync, constants, writeFileSync, unlinkSync, createWriteStream, statSync, readdirSync, renameSync, readFileSync } from 'fs';
+import { readdir, stat, mkdir, writeFile } from 'fs/promises';
+import * as ts from 'typescript';
 import { createJiti } from 'jiti';
 
-// src/codegen/contract-scanner.ts
-async function scanContracts(contractsDir) {
-  const contractFiles = await scanContractFiles(contractsDir);
-  const mappings = [];
-  for (let i = 0; i < contractFiles.length; i++) {
-    const filePath = contractFiles[i];
-    const exports = extractContractExports(filePath);
-    for (let j = 0; j < exports.length; j++) {
-      const contractExport = exports[j];
-      if (!contractExport.path.startsWith("/")) {
-        throw new Error(
-          `Contract '${contractExport.name}' in ${filePath} must use absolute path. Found: '${contractExport.path}'. Use '/your-path' instead.`
-        );
-      }
-      mappings.push({
-        method: contractExport.method,
-        path: contractExport.path,
-        contractName: contractExport.name,
-        contractImportPath: getImportPath(filePath),
-        routeFile: "",
-        contractFile: filePath,
-        hasQuery: contractExport.hasQuery,
-        hasBody: contractExport.hasBody,
-        hasParams: contractExport.hasParams
-      });
-    }
+// src/codegen/core/orchestrator.ts
+var PinoAdapter = class _PinoAdapter {
+  logger;
+  constructor(config) {
+    this.logger = pino({
+      level: config.level,
+      // 기본 필드
+      base: config.module ? { module: config.module } : void 0
+    });
   }
-  return mappings;
-}
-async function scanContractFiles(dir, files = []) {
-  try {
-    const entries = await readdir(dir);
-    for (let i = 0; i < entries.length; i++) {
-      const entry = entries[i];
-      const fullPath = join(dir, entry);
-      const fileStat = await stat(fullPath);
-      if (fileStat.isDirectory()) {
-        await scanContractFiles(fullPath, files);
-      } else {
-        if ((entry.endsWith(".ts") || entry.endsWith(".js") || entry.endsWith(".mjs")) && !entry.endsWith(".d.ts") && !entry.endsWith(".test.ts") && !entry.endsWith(".test.js") && !entry.endsWith(".test.mjs")) {
-          files.push(fullPath);
-        }
-      }
+  child(module) {
+    const childLogger = new _PinoAdapter({ level: this.logger.level, module });
+    childLogger.logger = this.logger.child({ module });
+    return childLogger;
+  }
+  debug(message, context) {
+    this.logger.debug(context || {}, message);
+  }
+  info(message, context) {
+    this.logger.info(context || {}, message);
+  }
+  warn(message, errorOrContext, context) {
+    if (errorOrContext instanceof Error) {
+      this.logger.warn({ err: errorOrContext, ...context }, message);
+    } else {
+      this.logger.warn(errorOrContext || {}, message);
     }
-  } catch (error) {
   }
-  return files;
-}
-function extractContractExports(filePath) {
-  const sourceCode = readFileSync(filePath, "utf-8");
-  const sourceFile = ts.createSourceFile(
-    filePath,
-    sourceCode,
-    ts.ScriptTarget.Latest,
-    true
-  );
-  const exports = [];
-  function visit(node) {
-    if (ts.isVariableStatement(node)) {
-      const hasExport = node.modifiers?.some(
-        (m) => m.kind === ts.SyntaxKind.ExportKeyword
-      );
-      if (hasExport && node.declarationList.declarations.length > 0) {
-        const declaration = node.declarationList.declarations[0];
-        if (ts.isVariableDeclaration(declaration) && ts.isIdentifier(declaration.name) && declaration.initializer) {
-          const name = declaration.name.text;
-          const hasSatisfiesRouteContract = checkSatisfiesRouteContract(declaration.initializer);
-          if (hasSatisfiesRouteContract) {
-            const objectLiteral = extractObjectLiteral(declaration.initializer);
-            if (objectLiteral) {
-              const contractData = extractContractData(objectLiteral);
-              if (contractData.method && contractData.path) {
-                exports.push({
-                  name,
-                  method: contractData.method,
-                  path: contractData.path,
-                  hasQuery: contractData.hasQuery,
-                  hasBody: contractData.hasBody,
-                  hasParams: contractData.hasParams
-                });
-              }
-            }
-            return;
-          }
-          if (isContractName(name)) {
-            const objectLiteral = extractObjectLiteral(declaration.initializer);
-            if (objectLiteral) {
-              const contractData = extractContractData(objectLiteral);
-              if (contractData.method && contractData.path) {
-                exports.push({
-                  name,
-                  method: contractData.method,
-                  path: contractData.path,
-                  hasQuery: contractData.hasQuery,
-                  hasBody: contractData.hasBody,
-                  hasParams: contractData.hasParams
-                });
-              }
-            }
-          }
-        }
-      }
+  error(message, errorOrContext, context) {
+    if (errorOrContext instanceof Error) {
+      this.logger.error({ err: errorOrContext, ...context }, message);
+    } else {
+      this.logger.error(errorOrContext || {}, message);
     }
-    ts.forEachChild(node, visit);
   }
-  visit(sourceFile);
-  return exports;
-}
-function checkSatisfiesRouteContract(initializer) {
-  if (!ts.isSatisfiesExpression(initializer)) {
-    return false;
+  fatal(message, errorOrContext, context) {
+    if (errorOrContext instanceof Error) {
+      this.logger.fatal({ err: errorOrContext, ...context }, message);
+    } else {
+      this.logger.fatal(errorOrContext || {}, message);
+    }
   }
-  const typeNode = initializer.type;
-  if (ts.isTypeReferenceNode(typeNode) && ts.isIdentifier(typeNode.typeName)) {
-    return typeNode.typeName.text === "RouteContract";
+  async close() {
   }
-  return false;
+};
+
+// src/logger/types.ts
+var LOG_LEVEL_PRIORITY = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+  fatal: 4
+};
+
+// src/logger/formatters.ts
+var SENSITIVE_KEYS = [
+  "password",
+  "passwd",
+  "pwd",
+  "secret",
+  "token",
+  "apikey",
+  "api_key",
+  "accesstoken",
+  "access_token",
+  "refreshtoken",
+  "refresh_token",
+  "authorization",
+  "auth",
+  "cookie",
+  "session",
+  "sessionid",
+  "session_id",
+  "privatekey",
+  "private_key",
+  "creditcard",
+  "credit_card",
+  "cardnumber",
+  "card_number",
+  "cvv",
+  "ssn",
+  "pin"
+];
+var MASKED_VALUE = "***MASKED***";
+function isSensitiveKey(key) {
+  const lowerKey = key.toLowerCase();
+  return SENSITIVE_KEYS.some((sensitive) => lowerKey.includes(sensitive));
 }
-function extractObjectLiteral(initializer) {
-  if (ts.isObjectLiteralExpression(initializer)) {
-    return initializer;
-  }
-  if (ts.isSatisfiesExpression(initializer)) {
-    return extractObjectLiteral(initializer.expression);
+function maskSensitiveData(data) {
+  if (data === null || data === void 0) {
+    return data;
   }
-  if (ts.isAsExpression(initializer)) {
-    return extractObjectLiteral(initializer.expression);
+  if (Array.isArray(data)) {
+    return data.map((item) => maskSensitiveData(item));
   }
-  return void 0;
-}
-function extractContractData(objectLiteral) {
-  const result = {};
-  for (let i = 0; i < objectLiteral.properties.length; i++) {
-    const prop = objectLiteral.properties[i];
-    if (ts.isPropertyAssignment(prop) && ts.isIdentifier(prop.name)) {
-      const propName = prop.name.text;
-      if (propName === "method") {
-        let value;
-        if (ts.isStringLiteral(prop.initializer)) {
-          value = prop.initializer.text;
-        } else if (ts.isAsExpression(prop.initializer) && ts.isStringLiteral(prop.initializer.expression)) {
-          value = prop.initializer.expression.text;
-        }
-        if (value) result.method = value;
-      } else if (propName === "path") {
-        let value;
-        if (ts.isStringLiteral(prop.initializer)) {
-          value = prop.initializer.text;
-        } else if (ts.isAsExpression(prop.initializer) && ts.isStringLiteral(prop.initializer.expression)) {
-          value = prop.initializer.expression.text;
-        }
-        if (value) result.path = value;
-      } else if (propName === "query") {
-        result.hasQuery = true;
-      } else if (propName === "body") {
-        result.hasBody = true;
-      } else if (propName === "params") {
-        result.hasParams = true;
+  if (typeof data === "object") {
+    const masked = {};
+    for (const [key, value] of Object.entries(data)) {
+      if (isSensitiveKey(key)) {
+        masked[key] = MASKED_VALUE;
+      } else if (typeof value === "object" && value !== null) {
+        masked[key] = maskSensitiveData(value);
+      } else {
+        masked[key] = value;
       }
     }
+    return masked;
   }
-  return result;
-}
-function isContractName(name) {
-  return name.indexOf("Contract") !== -1 || name.indexOf("contract") !== -1 || name.endsWith("Schema") || name.endsWith("schema");
+  return data;
 }
-function getImportPath(filePath) {
-  const srcIndex = filePath.indexOf("/src/");
-  if (srcIndex === -1) {
-    throw new Error(`Cannot determine import path for ${filePath}: /src/ directory not found`);
-  }
-  let cleanPath = filePath.substring(srcIndex + 5);
-  if (cleanPath.endsWith(".ts")) {
-    cleanPath = cleanPath.slice(0, -3);
-  } else if (cleanPath.endsWith(".js")) {
-    cleanPath = cleanPath.slice(0, -3);
-  } else if (cleanPath.endsWith(".mjs")) {
-    cleanPath = cleanPath.slice(0, -4);
-  }
-  return "@/" + cleanPath;
+var COLORS = {
+  reset: "\x1B[0m",
+  bright: "\x1B[1m",
+  dim: "\x1B[2m",
+  // 로그 레벨 컬러
+  debug: "\x1B[36m",
+  // cyan
+  info: "\x1B[32m",
+  // green
+  warn: "\x1B[33m",
+  // yellow
+  error: "\x1B[31m",
+  // red
+  fatal: "\x1B[35m",
+  // magenta
+  // 추가 컬러
+  gray: "\x1B[90m"
+};
+function formatTimestamp(date) {
+  return date.toISOString();
 }
-
-// src/codegen/route-scanner.ts
-function groupByResource(mappings) {
-  const grouped = {};
-  for (let i = 0; i < mappings.length; i++) {
-    const mapping = mappings[i];
-    const resource = extractResourceName(mapping.path);
-    if (!grouped[resource]) {
-      grouped[resource] = [];
-    }
-    grouped[resource].push(mapping);
+function formatTimestampHuman(date) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  const hours = String(date.getHours()).padStart(2, "0");
+  const minutes = String(date.getMinutes()).padStart(2, "0");
+  const seconds = String(date.getSeconds()).padStart(2, "0");
+  const ms = String(date.getMilliseconds()).padStart(3, "0");
+  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}.${ms}`;
+}
+function formatError(error) {
+  const lines = [];
+  lines.push(`${error.name}: ${error.message}`);
+  if (error.stack) {
+    const stackLines = error.stack.split("\n").slice(1);
+    lines.push(...stackLines);
   }
-  return grouped;
+  return lines.join("\n");
 }
-function extractResourceName(path) {
-  const segments = path.slice(1).split("/").filter((s) => s && s !== "*");
-  const staticSegments = [];
-  for (let i = 0; i < segments.length; i++) {
-    const seg = segments[i];
-    if (!seg.startsWith(":")) {
-      staticSegments.push(seg);
-    }
+function formatConsole(metadata, colorize = true) {
+  const parts = [];
+  const timestamp = formatTimestampHuman(metadata.timestamp);
+  if (colorize) {
+    parts.push(`${COLORS.gray}[${timestamp}]${COLORS.reset}`);
+  } else {
+    parts.push(`[${timestamp}]`);
   }
-  if (staticSegments.length === 0) {
-    return "root";
+  if (metadata.module) {
+    if (colorize) {
+      parts.push(`${COLORS.dim}[module=${metadata.module}]${COLORS.reset}`);
+    } else {
+      parts.push(`[module=${metadata.module}]`);
+    }
   }
-  const first = toCamelCase(staticSegments[0], false);
-  if (staticSegments.length === 1) {
-    return first;
+  if (metadata.context && Object.keys(metadata.context).length > 0) {
+    Object.entries(metadata.context).forEach(([key, value]) => {
+      const valueStr = typeof value === "string" ? value : String(value);
+      if (colorize) {
+        parts.push(`${COLORS.dim}[${key}=${valueStr}]${COLORS.reset}`);
+      } else {
+        parts.push(`[${key}=${valueStr}]`);
+      }
+    });
   }
-  const result = [first];
-  for (let i = 1; i < staticSegments.length; i++) {
-    const seg = staticSegments[i];
-    result.push(toCamelCase(seg, true));
+  const levelStr = metadata.level.toUpperCase();
+  if (colorize) {
+    const color = COLORS[metadata.level];
+    parts.push(`${color}(${levelStr})${COLORS.reset}:`);
+  } else {
+    parts.push(`(${levelStr}):`);
   }
-  return result.join("");
-}
-function toCamelCase(str, capitalize2) {
-  const parts = str.split(/[-_]/);
-  if (parts.length === 1) {
-    return capitalize2 ? str.charAt(0).toUpperCase() + str.slice(1) : str;
+  if (colorize) {
+    parts.push(`${COLORS.bright}${metadata.message}${COLORS.reset}`);
+  } else {
+    parts.push(metadata.message);
   }
-  const result = [];
-  for (let i = 0; i < parts.length; i++) {
-    const part = parts[i];
-    if (i === 0 && !capitalize2) {
-      result.push(part);
-    } else {
-      result.push(part.charAt(0).toUpperCase() + part.slice(1));
-    }
+  let output = parts.join(" ");
+  if (metadata.error) {
+    output += "\n" + formatError(metadata.error);
   }
-  return result.join("");
+  return output;
 }
-async function generateClient(mappings, options) {
-  const startTime = Date.now();
-  const grouped = groupByResource(mappings);
-  const resourceNames = Object.keys(grouped);
-  await generateSplitClient(mappings, grouped, options);
-  return {
-    routesScanned: mappings.length,
-    contractsFound: mappings.length,
-    contractFiles: countUniqueContractFiles(mappings),
-    resourcesGenerated: resourceNames.length,
-    methodsGenerated: mappings.length,
-    duration: Date.now() - startTime
+function formatJSON(metadata) {
+  const obj = {
+    timestamp: formatTimestamp(metadata.timestamp),
+    level: metadata.level,
+    message: metadata.message
   };
-}
-function generateHeader() {
-  return `/**
- * Auto-generated API Client
- *
- * Generated by @spfn/core codegen
- * DO NOT EDIT MANUALLY
- *
- * @generated ${(/* @__PURE__ */ new Date()).toISOString()}
- */
-
-`;
-}
-function groupContractsByImportPath(mappings) {
-  const groups = {};
-  for (let i = 0; i < mappings.length; i++) {
-    const mapping = mappings[i];
-    const path = mapping.contractImportPath;
-    if (!groups[path]) {
-      groups[path] = /* @__PURE__ */ new Set();
-    }
-    groups[path].add(mapping.contractName);
-  }
-  const result = {};
-  const keys = Object.keys(groups);
-  for (let i = 0; i < keys.length; i++) {
-    const key = keys[i];
-    result[key] = Array.from(groups[key]);
+  if (metadata.module) {
+    obj.module = metadata.module;
   }
-  return result;
-}
-function generateTypeName(mapping) {
-  let name = mapping.contractName;
-  if (name.endsWith("Contract")) {
-    name = name.slice(0, -8);
+  if (metadata.context) {
+    obj.context = metadata.context;
   }
-  if (name.length > 0) {
-    name = name.charAt(0).toUpperCase() + name.slice(1);
+  if (metadata.error) {
+    obj.error = {
+      name: metadata.error.name,
+      message: metadata.error.message,
+      stack: metadata.error.stack
+    };
   }
-  return name;
+  return JSON.stringify(obj);
 }
-function generateMethodCode(mapping, options) {
-  const methodName = generateMethodName(mapping);
-  const hasParams = mapping.hasParams || mapping.path.includes(":");
-  const hasQuery = mapping.hasQuery || false;
-  const hasBody = mapping.hasBody || false;
-  let code = "";
-  if (options.includeJsDoc !== false) {
-    code += `        /**
-`;
-    code += `         * ${mapping.method} ${mapping.path}
-`;
-    code += `         */
-`;
-  }
-  code += `        ${methodName}: (`;
-  const params = [];
-  const typeName = generateTypeName(mapping);
-  if (hasParams) {
-    params.push(`params: ${typeName}Params`);
+
+// src/logger/logger.ts
+var Logger = class _Logger {
+  config;
+  module;
+  constructor(config) {
+    this.config = config;
+    this.module = config.module;
   }
-  if (hasQuery) {
-    params.push(`query?: ${typeName}Query`);
+  /**
+   * Get current log level
+   */
+  get level() {
+    return this.config.level;
   }
-  if (hasBody) {
-    params.push(`body: ${typeName}Body`);
+  /**
+   * Create child logger (per module)
+   */
+  child(module) {
+    return new _Logger({
+      ...this.config,
+      module
+    });
   }
-  if (params.length > 0) {
-    code += `options: { ${params.join(", ")} }`;
+  /**
+   * Debug log
+   */
+  debug(message, context) {
+    this.log("debug", message, void 0, context);
   }
-  code += `) => `;
-  code += `client.call(${mapping.contractName}`;
-  if (params.length > 0) {
-    code += `, options`;
+  /**
+   * Info log
+   */
+  info(message, context) {
+    this.log("info", message, void 0, context);
   }
-  code += `),
-`;
-  return code;
-}
-function generateMethodName(mapping) {
-  const method = mapping.method.toLowerCase();
-  if (mapping.path === "/" || mapping.path.match(/^\/[\w-]+$/)) {
-    if (method === "get") {
-      return "list";
-    }
-    if (method === "post") {
-      return "create";
+  warn(message, errorOrContext, context) {
+    if (errorOrContext instanceof Error) {
+      this.log("warn", message, errorOrContext, context);
+    } else {
+      this.log("warn", message, void 0, errorOrContext);
     }
   }
-  if (mapping.path.includes(":")) {
-    if (method === "get") {
-      return "getById";
-    }
-    if (method === "put" || method === "patch") {
-      return "update";
-    }
-    if (method === "delete") {
-      return "delete";
+  error(message, errorOrContext, context) {
+    if (errorOrContext instanceof Error) {
+      this.log("error", message, errorOrContext, context);
+    } else {
+      this.log("error", message, void 0, errorOrContext);
     }
   }
-  return method;
-}
-function countUniqueContractFiles(mappings) {
-  const files = /* @__PURE__ */ new Set();
-  for (let i = 0; i < mappings.length; i++) {
-    if (mappings[i].contractFile) {
-      files.add(mappings[i].contractFile);
+  fatal(message, errorOrContext, context) {
+    if (errorOrContext instanceof Error) {
+      this.log("fatal", message, errorOrContext, context);
+    } else {
+      this.log("fatal", message, void 0, errorOrContext);
     }
   }
-  return files.size;
-}
-async function generateSplitClient(_mappings, grouped, options) {
-  const outputPath = options.outputPath;
-  const outputDir = outputPath.endsWith(".ts") || outputPath.endsWith(".js") ? outputPath.replace(/\.[jt]s$/, "") : outputPath;
-  await mkdir(outputDir, { recursive: true });
-  const resourceNames = Object.keys(grouped);
-  for (let i = 0; i < resourceNames.length; i++) {
-    const resourceName = resourceNames[i];
-    const routes = grouped[resourceName];
-    const code = generateResourceFile(resourceName, routes, options);
-    const filePath = `${outputDir}/${resourceName}.ts`;
-    await writeFile(filePath, code, "utf-8");
-  }
-  const indexCode = generateIndexFile(resourceNames);
-  const indexPath = `${outputDir}/index.ts`;
-  await writeFile(indexPath, indexCode, "utf-8");
-}
-function generateResourceFile(resourceName, routes, options) {
-  let code = "";
-  code += generateHeader();
-  code += `import { client } from '@spfn/core/client';
-`;
-  if (options.includeTypes !== false) {
-    code += `import type { InferContract } from '@spfn/core';
-`;
+  /**
+   * Log processing (internal)
+   */
+  log(level, message, error, context) {
+    if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.config.level]) {
+      return;
+    }
+    const metadata = {
+      timestamp: /* @__PURE__ */ new Date(),
+      level,
+      message,
+      module: this.module,
+      error,
+      // Mask sensitive information in context to prevent credential leaks
+      context: context ? maskSensitiveData(context) : void 0
+    };
+    this.processTransports(metadata);
   }
-  code += `
-`;
-  const importGroups = groupContractsByImportPath(routes);
-  const importPaths = Object.keys(importGroups);
-  for (let i = 0; i < importPaths.length; i++) {
-    const importPath = importPaths[i];
-    const contracts = importGroups[importPath];
-    code += `import { ${contracts.join(", ")} } from '${importPath}';
-`;
+  /**
+   * Process Transports
+   */
+  processTransports(metadata) {
+    const promises = this.config.transports.filter((transport) => transport.enabled).map((transport) => this.safeTransportLog(transport, metadata));
+    Promise.all(promises).catch((error) => {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      process.stderr.write(`[Logger] Transport error: ${errorMessage}
+`);
+    });
   }
-  code += `
-`;
-  if (options.includeTypes !== false) {
-    code += `// ============================================
-`;
-    code += `// Types
-`;
-    code += `// ============================================
-
-`;
-    for (let i = 0; i < routes.length; i++) {
-      const route = routes[i];
-      const typeName = generateTypeName(route);
-      const contractType = `typeof ${route.contractName}`;
-      code += `export type ${typeName}Response = InferContract<${contractType}>['response'];
-`;
-      if (route.hasQuery) {
-        code += `export type ${typeName}Query = InferContract<${contractType}>['query'];
-`;
-      }
-      if (route.hasParams || route.path.includes(":")) {
-        code += `export type ${typeName}Params = InferContract<${contractType}>['params'];
-`;
-      }
-      if (route.hasBody) {
-        code += `export type ${typeName}Body = InferContract<${contractType}>['body'];
-`;
-      }
-      code += `
-`;
+  /**
+   * Transport log (error-safe)
+   */
+  async safeTransportLog(transport, metadata) {
+    try {
+      await transport.log(metadata);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      process.stderr.write(`[Logger] Transport "${transport.name}" failed: ${errorMessage}
+`);
     }
   }
-  code += `/**
-`;
-  code += ` * ${resourceName} API
-`;
-  code += ` */
-`;
-  code += `export const ${resourceName} = {
-`;
-  for (let i = 0; i < routes.length; i++) {
-    const route = routes[i];
-    code += generateMethodCode(route, options);
+  /**
+   * Close all Transports
+   */
+  async close() {
+    const closePromises = this.config.transports.filter((transport) => transport.close).map((transport) => transport.close());
+    await Promise.all(closePromises);
   }
-  code += `} as const;
-`;
-  return code;
-}
-function generateIndexFile(resourceNames, _options) {
-  let code = "";
-  code += generateHeader();
-  code += `export { client } from '@spfn/core/client';
+};
 
-`;
-  for (let i = 0; i < resourceNames.length; i++) {
-    const resourceName = resourceNames[i];
-    code += `export * from './${resourceName}.js';
-`;
-  }
-  code += `
-`;
-  for (let i = 0; i < resourceNames.length; i++) {
-    const resourceName = resourceNames[i];
-    code += `import { ${resourceName} } from './${resourceName}.js';
-`;
-  }
-  code += `
-`;
-  code += `/**
-`;
-  code += ` * Type-safe API client
-`;
-  code += ` */
-`;
-  code += `export const api = {
-`;
-  for (let i = 0; i < resourceNames.length; i++) {
-    const resourceName = resourceNames[i];
-    code += `    ${resourceName}`;
-    if (i < resourceNames.length - 1) {
-      code += `,`;
-    }
-    code += `
-`;
-  }
-  code += `} as const;
-`;
-  return code;
-}
-var PinoAdapter = class _PinoAdapter {
-  logger;
+// src/logger/transports/console.ts
+var ConsoleTransport = class {
+  name = "console";
+  level;
+  enabled;
+  colorize;
   constructor(config) {
-    this.logger = pino({
-      level: config.level,
-      // 기본 필드
-      base: config.module ? { module: config.module } : void 0
-    });
-  }
-  child(module) {
-    const childLogger = new _PinoAdapter({ level: this.logger.level, module });
-    childLogger.logger = this.logger.child({ module });
-    return childLogger;
-  }
-  debug(message, context) {
-    this.logger.debug(context || {}, message);
-  }
-  info(message, context) {
-    this.logger.info(context || {}, message);
+    this.level = config.level;
+    this.enabled = config.enabled;
+    this.colorize = config.colorize ?? true;
   }
-  warn(message, errorOrContext, context) {
-    if (errorOrContext instanceof Error) {
-      this.logger.warn({ err: errorOrContext, ...context }, message);
-    } else {
-      this.logger.warn(errorOrContext || {}, message);
+  async log(metadata) {
+    if (!this.enabled) {
+      return;
     }
-  }
-  error(message, errorOrContext, context) {
-    if (errorOrContext instanceof Error) {
-      this.logger.error({ err: errorOrContext, ...context }, message);
-    } else {
-      this.logger.error(errorOrContext || {}, message);
+    if (LOG_LEVEL_PRIORITY[metadata.level] < LOG_LEVEL_PRIORITY[this.level]) {
+      return;
     }
-  }
-  fatal(message, errorOrContext, context) {
-    if (errorOrContext instanceof Error) {
-      this.logger.fatal({ err: errorOrContext, ...context }, message);
+    const message = formatConsole(metadata, this.colorize);
+    if (metadata.level === "warn" || metadata.level === "error" || metadata.level === "fatal") {
+      console.error(message);
     } else {
-      this.logger.fatal(errorOrContext || {}, message);
+      console.log(message);
     }
   }
-  async close() {
-  }
 };
-
-// src/logger/types.ts
-var LOG_LEVEL_PRIORITY = {
-  debug: 0,
-  info: 1,
-  warn: 2,
-  error: 3,
-  fatal: 4
-};
-
-// src/logger/formatters.ts
-var SENSITIVE_KEYS = [
-  "password",
-  "passwd",
-  "pwd",
-  "secret",
-  "token",
-  "apikey",
-  "api_key",
-  "accesstoken",
-  "access_token",
-  "refreshtoken",
-  "refresh_token",
-  "authorization",
-  "auth",
-  "cookie",
-  "session",
-  "sessionid",
-  "session_id",
-  "privatekey",
-  "private_key",
-  "creditcard",
-  "credit_card",
-  "cardnumber",
-  "card_number",
-  "cvv",
-  "ssn",
-  "pin"
-];
-var MASKED_VALUE = "***MASKED***";
-function isSensitiveKey(key) {
-  const lowerKey = key.toLowerCase();
-  return SENSITIVE_KEYS.some((sensitive) => lowerKey.includes(sensitive));
-}
-function maskSensitiveData(data) {
-  if (data === null || data === void 0) {
-    return data;
+var FileTransport = class {
+  name = "file";
+  level;
+  enabled;
+  logDir;
+  maxFileSize;
+  maxFiles;
+  currentStream = null;
+  currentFilename = null;
+  constructor(config) {
+    this.level = config.level;
+    this.enabled = config.enabled;
+    this.logDir = config.logDir;
+    this.maxFileSize = config.maxFileSize ?? 10 * 1024 * 1024;
+    this.maxFiles = config.maxFiles ?? 10;
+    if (!existsSync(this.logDir)) {
+      mkdirSync(this.logDir, { recursive: true });
+    }
   }
-  if (Array.isArray(data)) {
-    return data.map((item) => maskSensitiveData(item));
+  async log(metadata) {
+    if (!this.enabled) {
+      return;
+    }
+    if (LOG_LEVEL_PRIORITY[metadata.level] < LOG_LEVEL_PRIORITY[this.level]) {
+      return;
+    }
+    const message = formatJSON(metadata);
+    const filename = this.getLogFilename(metadata.timestamp);
+    if (this.currentFilename !== filename) {
+      await this.rotateStream(filename);
+      await this.cleanOldFiles();
+    } else if (this.currentFilename) {
+      await this.checkAndRotateBySize();
+    }
+    if (this.currentStream) {
+      return new Promise((resolve, reject) => {
+        this.currentStream.write(message + "\n", "utf-8", (error) => {
+          if (error) {
+            process.stderr.write(`[FileTransport] Failed to write log: ${error.message}
+`);
+            reject(error);
+          } else {
+            resolve();
+          }
+        });
+      });
+    }
   }
-  if (typeof data === "object") {
-    const masked = {};
-    for (const [key, value] of Object.entries(data)) {
-      if (isSensitiveKey(key)) {
-        masked[key] = MASKED_VALUE;
-      } else if (typeof value === "object" && value !== null) {
-        masked[key] = maskSensitiveData(value);
-      } else {
-        masked[key] = value;
+  /**
+   * 스트림 교체 (날짜 변경 시)
+   */
+  async rotateStream(filename) {
+    if (this.currentStream) {
+      await this.closeStream();
+    }
+    const filepath = join(this.logDir, filename);
+    this.currentStream = createWriteStream(filepath, {
+      flags: "a",
+      // append mode
+      encoding: "utf-8"
+    });
+    this.currentFilename = filename;
+    this.currentStream.on("error", (error) => {
+      process.stderr.write(`[FileTransport] Stream error: ${error.message}
+`);
+      this.currentStream = null;
+      this.currentFilename = null;
+    });
+  }
+  /**
+   * 현재 스트림 닫기
+   */
+  async closeStream() {
+    if (!this.currentStream) {
+      return;
+    }
+    return new Promise((resolve, reject) => {
+      this.currentStream.end((error) => {
+        if (error) {
+          reject(error);
+        } else {
+          this.currentStream = null;
+          this.currentFilename = null;
+          resolve();
+        }
+      });
+    });
+  }
+  /**
+   * 파일 크기 체크 및 크기 기반 로테이션
+   */
+  async checkAndRotateBySize() {
+    if (!this.currentFilename) {
+      return;
+    }
+    const filepath = join(this.logDir, this.currentFilename);
+    if (!existsSync(filepath)) {
+      return;
+    }
+    try {
+      const stats = statSync(filepath);
+      if (stats.size >= this.maxFileSize) {
+        await this.rotateBySize();
       }
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      process.stderr.write(`[FileTransport] Failed to check file size: ${errorMessage}
+`);
     }
-    return masked;
   }
-  return data;
-}
-var COLORS = {
-  reset: "\x1B[0m",
-  bright: "\x1B[1m",
-  dim: "\x1B[2m",
-  // 로그 레벨 컬러
-  debug: "\x1B[36m",
-  // cyan
-  info: "\x1B[32m",
-  // green
-  warn: "\x1B[33m",
-  // yellow
-  error: "\x1B[31m",
-  // red
-  fatal: "\x1B[35m",
-  // magenta
-  // 추가 컬러
-  gray: "\x1B[90m"
+  /**
+   * 크기 기반 로테이션 수행
+   * 예: 2025-01-01.log -> 2025-01-01.1.log, 2025-01-01.1.log -> 2025-01-01.2.log
+   */
+  async rotateBySize() {
+    if (!this.currentFilename) {
+      return;
+    }
+    await this.closeStream();
+    const baseName = this.currentFilename.replace(/\.log$/, "");
+    const files = readdirSync(this.logDir);
+    const relatedFiles = files.filter((file) => file.startsWith(baseName) && file.endsWith(".log")).sort().reverse();
+    for (const file of relatedFiles) {
+      const match = file.match(/\.(\d+)\.log$/);
+      if (match) {
+        const oldNum = parseInt(match[1], 10);
+        const newNum = oldNum + 1;
+        const oldPath = join(this.logDir, file);
+        const newPath2 = join(this.logDir, `${baseName}.${newNum}.log`);
+        try {
+          renameSync(oldPath, newPath2);
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error);
+          process.stderr.write(`[FileTransport] Failed to rotate file: ${errorMessage}
+`);
+        }
+      }
+    }
+    const currentPath = join(this.logDir, this.currentFilename);
+    const newPath = join(this.logDir, `${baseName}.1.log`);
+    try {
+      if (existsSync(currentPath)) {
+        renameSync(currentPath, newPath);
+      }
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      process.stderr.write(`[FileTransport] Failed to rotate current file: ${errorMessage}
+`);
+    }
+    await this.rotateStream(this.currentFilename);
+  }
+  /**
+   * 오래된 로그 파일 정리
+   * maxFiles 개수를 초과하는 로그 파일 삭제
+   */
+  async cleanOldFiles() {
+    try {
+      if (!existsSync(this.logDir)) {
+        return;
+      }
+      const files = readdirSync(this.logDir);
+      const logFiles = files.filter((file) => file.endsWith(".log")).map((file) => {
+        const filepath = join(this.logDir, file);
+        const stats = statSync(filepath);
+        return { file, mtime: stats.mtime };
+      }).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+      if (logFiles.length > this.maxFiles) {
+        const filesToDelete = logFiles.slice(this.maxFiles);
+        for (const { file } of filesToDelete) {
+          const filepath = join(this.logDir, file);
+          try {
+            unlinkSync(filepath);
+          } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`[FileTransport] Failed to delete old file "${file}": ${errorMessage}
+`);
+          }
+        }
+      }
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      process.stderr.write(`[FileTransport] Failed to clean old files: ${errorMessage}
+`);
+    }
+  }
+  /**
+   * 날짜별 로그 파일명 생성
+   */
+  getLogFilename(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}.log`;
+  }
+  async close() {
+    await this.closeStream();
+  }
 };
-function formatTimestamp(date) {
-  return date.toISOString();
+function isFileLoggingEnabled() {
+  return process.env.LOGGER_FILE_ENABLED === "true";
 }
-function formatTimestampHuman(date) {
-  const year = date.getFullYear();
-  const month = String(date.getMonth() + 1).padStart(2, "0");
-  const day = String(date.getDate()).padStart(2, "0");
-  const hours = String(date.getHours()).padStart(2, "0");
-  const minutes = String(date.getMinutes()).padStart(2, "0");
-  const seconds = String(date.getSeconds()).padStart(2, "0");
-  const ms = String(date.getMilliseconds()).padStart(3, "0");
-  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}.${ms}`;
+function getDefaultLogLevel() {
+  const isProduction = process.env.NODE_ENV === "production";
+  const isDevelopment = process.env.NODE_ENV === "development";
+  if (isDevelopment) {
+    return "debug";
+  }
+  if (isProduction) {
+    return "info";
+  }
+  return "warn";
 }
-function formatError(error) {
-  const lines = [];
-  lines.push(`${error.name}: ${error.message}`);
-  if (error.stack) {
-    const stackLines = error.stack.split("\n").slice(1);
-    lines.push(...stackLines);
+function getConsoleConfig() {
+  const isProduction = process.env.NODE_ENV === "production";
+  return {
+    level: "debug",
+    enabled: true,
+    colorize: !isProduction
+    // Dev: colored output, Production: plain text
+  };
+}
+function getFileConfig() {
+  const isProduction = process.env.NODE_ENV === "production";
+  return {
+    level: "info",
+    enabled: isProduction,
+    // File logging in production only
+    logDir: process.env.LOG_DIR || "./logs",
+    maxFileSize: 10 * 1024 * 1024,
+    // 10MB
+    maxFiles: 10
+  };
+}
+function validateDirectoryWritable(dirPath) {
+  if (!existsSync(dirPath)) {
+    try {
+      mkdirSync(dirPath, { recursive: true });
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to create log directory "${dirPath}": ${errorMessage}`);
+    }
+  }
+  try {
+    accessSync(dirPath, constants.W_OK);
+  } catch {
+    throw new Error(`Log directory "${dirPath}" is not writable. Please check permissions.`);
+  }
+  const testFile = join(dirPath, ".logger-write-test");
+  try {
+    writeFileSync(testFile, "test", "utf-8");
+    unlinkSync(testFile);
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    throw new Error(`Cannot write to log directory "${dirPath}": ${errorMessage}`);
   }
-  return lines.join("\n");
 }
-function formatConsole(metadata, colorize = true) {
-  const parts = [];
-  const timestamp = formatTimestampHuman(metadata.timestamp);
-  if (colorize) {
-    parts.push(`${COLORS.gray}[${timestamp}]${COLORS.reset}`);
-  } else {
-    parts.push(`[${timestamp}]`);
+function validateFileConfig() {
+  if (!isFileLoggingEnabled()) {
+    return;
   }
-  if (metadata.module) {
-    if (colorize) {
-      parts.push(`${COLORS.dim}[module=${metadata.module}]${COLORS.reset}`);
-    } else {
-      parts.push(`[module=${metadata.module}]`);
-    }
+  const logDir = process.env.LOG_DIR;
+  if (!logDir) {
+    throw new Error(
+      "LOG_DIR environment variable is required when LOGGER_FILE_ENABLED=true. Example: LOG_DIR=/var/log/myapp"
+    );
   }
-  if (metadata.context && Object.keys(metadata.context).length > 0) {
-    Object.entries(metadata.context).forEach(([key, value]) => {
-      const valueStr = typeof value === "string" ? value : String(value);
-      if (colorize) {
-        parts.push(`${COLORS.dim}[${key}=${valueStr}]${COLORS.reset}`);
-      } else {
-        parts.push(`[${key}=${valueStr}]`);
-      }
-    });
+  validateDirectoryWritable(logDir);
+}
+function validateSlackConfig() {
+  const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+  if (!webhookUrl) {
+    return;
   }
-  const levelStr = metadata.level.toUpperCase();
-  if (colorize) {
-    const color = COLORS[metadata.level];
-    parts.push(`${color}(${levelStr})${COLORS.reset}:`);
-  } else {
-    parts.push(`(${levelStr}):`);
+  if (!webhookUrl.startsWith("https://hooks.slack.com/")) {
+    throw new Error(
+      `Invalid SLACK_WEBHOOK_URL: "${webhookUrl}". Slack webhook URLs must start with "https://hooks.slack.com/"`
+    );
+  }
+}
+function validateEmailConfig() {
+  const smtpHost = process.env.SMTP_HOST;
+  const smtpPort = process.env.SMTP_PORT;
+  const emailFrom = process.env.EMAIL_FROM;
+  const emailTo = process.env.EMAIL_TO;
+  const hasAnyEmailConfig = smtpHost || smtpPort || emailFrom || emailTo;
+  if (!hasAnyEmailConfig) {
+    return;
+  }
+  const missingFields = [];
+  if (!smtpHost) missingFields.push("SMTP_HOST");
+  if (!smtpPort) missingFields.push("SMTP_PORT");
+  if (!emailFrom) missingFields.push("EMAIL_FROM");
+  if (!emailTo) missingFields.push("EMAIL_TO");
+  if (missingFields.length > 0) {
+    throw new Error(
+      `Email transport configuration incomplete. Missing: ${missingFields.join(", ")}. Either set all required fields or remove all email configuration.`
+    );
+  }
+  const port = parseInt(smtpPort, 10);
+  if (isNaN(port) || port < 1 || port > 65535) {
+    throw new Error(
+      `Invalid SMTP_PORT: "${smtpPort}". Must be a number between 1 and 65535.`
+    );
   }
-  if (colorize) {
-    parts.push(`${COLORS.bright}${metadata.message}${COLORS.reset}`);
-  } else {
-    parts.push(metadata.message);
+  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  if (!emailRegex.test(emailFrom)) {
+    throw new Error(`Invalid EMAIL_FROM format: "${emailFrom}"`);
   }
-  let output = parts.join(" ");
-  if (metadata.error) {
-    output += "\n" + formatError(metadata.error);
+  const recipients = emailTo.split(",").map((e) => e.trim());
+  for (const email of recipients) {
+    if (!emailRegex.test(email)) {
+      throw new Error(`Invalid email address in EMAIL_TO: "${email}"`);
+    }
   }
-  return output;
 }
-function formatJSON(metadata) {
-  const obj = {
-    timestamp: formatTimestamp(metadata.timestamp),
-    level: metadata.level,
-    message: metadata.message
-  };
-  if (metadata.module) {
-    obj.module = metadata.module;
-  }
-  if (metadata.context) {
-    obj.context = metadata.context;
+function validateEnvironment() {
+  const nodeEnv = process.env.NODE_ENV;
+  if (!nodeEnv) {
+    process.stderr.write(
+      "[Logger] Warning: NODE_ENV is not set. Defaulting to test environment.\n"
+    );
   }
-  if (metadata.error) {
-    obj.error = {
-      name: metadata.error.name,
-      message: metadata.error.message,
-      stack: metadata.error.stack
-    };
+}
+function validateConfig() {
+  try {
+    validateEnvironment();
+    validateFileConfig();
+    validateSlackConfig();
+    validateEmailConfig();
+  } catch (error) {
+    if (error instanceof Error) {
+      throw new Error(`[Logger] Configuration validation failed: ${error.message}`);
+    }
+    throw error;
   }
-  return JSON.stringify(obj);
 }
 
-// src/logger/logger.ts
-var Logger = class _Logger {
-  config;
-  module;
-  constructor(config) {
-    this.config = config;
-    this.module = config.module;
+// src/logger/adapters/custom.ts
+function initializeTransports() {
+  const transports = [];
+  const consoleConfig = getConsoleConfig();
+  transports.push(new ConsoleTransport(consoleConfig));
+  const fileConfig = getFileConfig();
+  if (fileConfig.enabled) {
+    transports.push(new FileTransport(fileConfig));
   }
-  /**
-   * Get current log level
-   */
-  get level() {
-    return this.config.level;
+  return transports;
+}
+var CustomAdapter = class _CustomAdapter {
+  logger;
+  constructor(config) {
+    this.logger = new Logger({
+      level: config.level,
+      module: config.module,
+      transports: initializeTransports()
+    });
   }
-  /**
-   * Create child logger (per module)
-   */
   child(module) {
-    return new _Logger({
-      ...this.config,
-      module
-    });
+    const adapter = new _CustomAdapter({ level: this.logger.level, module });
+    adapter.logger = this.logger.child(module);
+    return adapter;
   }
-  /**
-   * Debug log
-   */
   debug(message, context) {
-    this.log("debug", message, void 0, context);
+    this.logger.debug(message, context);
   }
-  /**
-   * Info log
-   */
   info(message, context) {
-    this.log("info", message, void 0, context);
+    this.logger.info(message, context);
   }
   warn(message, errorOrContext, context) {
     if (errorOrContext instanceof Error) {
-      this.log("warn", message, errorOrContext, context);
+      this.logger.warn(message, errorOrContext, context);
     } else {
-      this.log("warn", message, void 0, errorOrContext);
+      this.logger.warn(message, errorOrContext);
     }
   }
   error(message, errorOrContext, context) {
     if (errorOrContext instanceof Error) {
-      this.log("error", message, errorOrContext, context);
+      this.logger.error(message, errorOrContext, context);
     } else {
-      this.log("error", message, void 0, errorOrContext);
+      this.logger.error(message, errorOrContext);
     }
   }
   fatal(message, errorOrContext, context) {
     if (errorOrContext instanceof Error) {
-      this.log("fatal", message, errorOrContext, context);
+      this.logger.fatal(message, errorOrContext, context);
     } else {
-      this.log("fatal", message, void 0, errorOrContext);
-    }
-  }
-  /**
-   * Log processing (internal)
-   */
-  log(level, message, error, context) {
-    if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.config.level]) {
-      return;
-    }
-    const metadata = {
-      timestamp: /* @__PURE__ */ new Date(),
-      level,
-      message,
-      module: this.module,
-      error,
-      // Mask sensitive information in context to prevent credential leaks
-      context: context ? maskSensitiveData(context) : void 0
-    };
-    this.processTransports(metadata);
-  }
-  /**
-   * Process Transports
-   */
-  processTransports(metadata) {
-    const promises = this.config.transports.filter((transport) => transport.enabled).map((transport) => this.safeTransportLog(transport, metadata));
-    Promise.all(promises).catch((error) => {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      process.stderr.write(`[Logger] Transport error: ${errorMessage}
-`);
-    });
-  }
-  /**
-   * Transport log (error-safe)
-   */
-  async safeTransportLog(transport, metadata) {
-    try {
-      await transport.log(metadata);
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      process.stderr.write(`[Logger] Transport "${transport.name}" failed: ${errorMessage}
-`);
+      this.logger.fatal(message, errorOrContext);
     }
   }
-  /**
-   * Close all Transports
-   */
   async close() {
-    const closePromises = this.config.transports.filter((transport) => transport.close).map((transport) => transport.close());
-    await Promise.all(closePromises);
+    await this.logger.close();
   }
 };
 
-// src/logger/transports/console.ts
-var ConsoleTransport = class {
-  name = "console";
-  level;
-  enabled;
-  colorize;
-  constructor(config) {
-    this.level = config.level;
-    this.enabled = config.enabled;
-    this.colorize = config.colorize ?? true;
-  }
-  async log(metadata) {
-    if (!this.enabled) {
-      return;
-    }
-    if (LOG_LEVEL_PRIORITY[metadata.level] < LOG_LEVEL_PRIORITY[this.level]) {
-      return;
-    }
-    const message = formatConsole(metadata, this.colorize);
-    if (metadata.level === "warn" || metadata.level === "error" || metadata.level === "fatal") {
-      console.error(message);
-    } else {
-      console.log(message);
-    }
+// src/logger/adapter-factory.ts
+function createAdapter(type) {
+  const level = getDefaultLogLevel();
+  switch (type) {
+    case "pino":
+      return new PinoAdapter({ level });
+    case "custom":
+      return new CustomAdapter({ level });
+    default:
+      return new PinoAdapter({ level });
   }
-};
-var FileTransport = class {
-  name = "file";
-  level;
-  enabled;
-  logDir;
-  maxFileSize;
-  maxFiles;
-  currentStream = null;
-  currentFilename = null;
-  constructor(config) {
-    this.level = config.level;
-    this.enabled = config.enabled;
-    this.logDir = config.logDir;
-    this.maxFileSize = config.maxFileSize ?? 10 * 1024 * 1024;
-    this.maxFiles = config.maxFiles ?? 10;
-    if (!existsSync(this.logDir)) {
-      mkdirSync(this.logDir, { recursive: true });
-    }
+}
+function getAdapterType() {
+  const adapterEnv = process.env.LOGGER_ADAPTER;
+  if (adapterEnv === "custom" || adapterEnv === "pino") {
+    return adapterEnv;
   }
-  async log(metadata) {
-    if (!this.enabled) {
-      return;
-    }
-    if (LOG_LEVEL_PRIORITY[metadata.level] < LOG_LEVEL_PRIORITY[this.level]) {
-      return;
-    }
-    const message = formatJSON(metadata);
-    const filename = this.getLogFilename(metadata.timestamp);
-    if (this.currentFilename !== filename) {
-      await this.rotateStream(filename);
-      await this.cleanOldFiles();
-    } else if (this.currentFilename) {
-      await this.checkAndRotateBySize();
-    }
-    if (this.currentStream) {
-      return new Promise((resolve, reject) => {
-        this.currentStream.write(message + "\n", "utf-8", (error) => {
-          if (error) {
-            process.stderr.write(`[FileTransport] Failed to write log: ${error.message}
-`);
-            reject(error);
-          } else {
-            resolve();
-          }
-        });
-      });
-    }
+  return "pino";
+}
+function initializeLogger() {
+  validateConfig();
+  return createAdapter(getAdapterType());
+}
+var logger = initializeLogger();
+
+// src/codegen/core/orchestrator.ts
+var orchestratorLogger = logger.child("orchestrator");
+var CodegenOrchestrator = class {
+  generators;
+  cwd;
+  debug;
+  isGenerating = false;
+  pendingRegenerations = /* @__PURE__ */ new Set();
+  constructor(options) {
+    this.generators = options.generators;
+    this.cwd = options.cwd ?? process.cwd();
+    this.debug = options.debug ?? false;
   }
   /**
-   * 스트림 교체 (날짜 변경 시)
+   * Check if generator should run for given trigger
    */
-  async rotateStream(filename) {
-    if (this.currentStream) {
-      await this.closeStream();
-    }
-    const filepath = join(this.logDir, filename);
-    this.currentStream = createWriteStream(filepath, {
-      flags: "a",
-      // append mode
-      encoding: "utf-8"
-    });
-    this.currentFilename = filename;
-    this.currentStream.on("error", (error) => {
-      process.stderr.write(`[FileTransport] Stream error: ${error.message}
-`);
-      this.currentStream = null;
-      this.currentFilename = null;
-    });
+  shouldRun(generator, trigger) {
+    const runOn = generator.runOn ?? ["watch", "manual", "build"];
+    return runOn.includes(trigger);
   }
   /**
-   * 현재 스트림 닫기
+   * Run all generators once
+   *
+   * @param trigger - How the generators are being triggered
    */
-  async closeStream() {
-    if (!this.currentStream) {
-      return;
+  async generateAll(trigger = "manual") {
+    if (this.debug) {
+      orchestratorLogger.info("Running all generators", {
+        count: this.generators.length,
+        names: this.generators.map((g) => g.name),
+        trigger
+      });
     }
-    return new Promise((resolve, reject) => {
-      this.currentStream.end((error) => {
-        if (error) {
-          reject(error);
-        } else {
-          this.currentStream = null;
-          this.currentFilename = null;
-          resolve();
+    for (const generator of this.generators) {
+      if (!this.shouldRun(generator, trigger)) {
+        if (this.debug) {
+          orchestratorLogger.info(`[${generator.name}] Skipped (runOn: ${generator.runOn?.join(", ") ?? "default"})`);
         }
-      });
-    });
+        continue;
+      }
+      try {
+        const genOptions = {
+          cwd: this.cwd,
+          debug: this.debug,
+          trigger: {
+            type: trigger
+          }
+        };
+        await generator.generate(genOptions);
+        if (this.debug) {
+          orchestratorLogger.info(`[${generator.name}] Generated successfully`);
+        }
+      } catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        orchestratorLogger.error(`[${generator.name}] Generation failed`, err);
+      }
+    }
   }
   /**
-   * 파일 크기 체크 및 크기 기반 로테이션
+   * Start watch mode
    */
-  async checkAndRotateBySize() {
-    if (!this.currentFilename) {
+  async watch() {
+    await this.generateAll("watch");
+    const allPatterns = this.generators.flatMap((g) => g.watchPatterns);
+    if (allPatterns.length === 0) {
+      orchestratorLogger.warn("No watch patterns defined, exiting watch mode");
       return;
     }
-    const filepath = join(this.logDir, this.currentFilename);
-    if (!existsSync(filepath)) {
-      return;
+    const dirsToWatch = /* @__PURE__ */ new Set();
+    for (const pattern of allPatterns) {
+      const baseDir = pattern.split("**")[0].replace(/\/$/, "") || ".";
+      dirsToWatch.add(join(this.cwd, baseDir));
     }
-    try {
-      const stats = statSync(filepath);
-      if (stats.size >= this.maxFileSize) {
-        await this.rotateBySize();
+    const watchDirs = Array.from(dirsToWatch);
+    if (this.debug) {
+      orchestratorLogger.info("Starting watch mode", {
+        patterns: allPatterns,
+        watchDirs,
+        cwd: this.cwd
+      });
+    }
+    const watcher = watch(watchDirs, {
+      ignored: /(^|[\/\\])\../,
+      // ignore dotfiles
+      persistent: true,
+      ignoreInitial: true,
+      awaitWriteFinish: {
+        stabilityThreshold: 100,
+        pollInterval: 50
+      }
+    });
+    const handleChange = async (absolutePath, event) => {
+      const filePath = relative(this.cwd, absolutePath);
+      if (this.isGenerating) {
+        this.pendingRegenerations.add(absolutePath);
+        return;
+      }
+      this.isGenerating = true;
+      this.pendingRegenerations.clear();
+      if (this.debug) {
+        orchestratorLogger.info(`File ${event}`, { file: filePath });
+      }
+      for (const generator of this.generators) {
+        if (!this.shouldRun(generator, "watch")) {
+          continue;
+        }
+        const matches = generator.watchPatterns.some(
+          (pattern) => mm.isMatch(filePath, pattern)
+        );
+        if (matches) {
+          try {
+            const genOptions = {
+              cwd: this.cwd,
+              debug: this.debug,
+              trigger: {
+                type: "watch",
+                changedFile: {
+                  path: filePath,
+                  event
+                }
+              }
+            };
+            await generator.generate(genOptions);
+            if (this.debug) {
+              orchestratorLogger.info(`[${generator.name}] Regenerated`);
+            }
+          } catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            orchestratorLogger.error(`[${generator.name}] Regeneration failed`, err);
+          }
+        }
+      }
+      this.isGenerating = false;
+      if (this.pendingRegenerations.size > 0) {
+        const next = Array.from(this.pendingRegenerations)[0];
+        await handleChange(next, "change");
+      }
+    };
+    watcher.on("add", (path) => handleChange(path, "add")).on("change", (path) => handleChange(path, "change")).on("unlink", (path) => handleChange(path, "unlink"));
+    process.on("SIGINT", () => {
+      if (this.debug) {
+        orchestratorLogger.info("Shutting down watch mode");
+      }
+      watcher.close();
+      process.exit(0);
+    });
+    await new Promise(() => {
+    });
+  }
+};
+async function scanContracts(contractsDir, packagePrefix) {
+  const contractFiles = await scanContractFiles(contractsDir);
+  const mappings = [];
+  for (let i = 0; i < contractFiles.length; i++) {
+    const filePath = contractFiles[i];
+    const exports = extractContractExports(filePath);
+    for (let j = 0; j < exports.length; j++) {
+      const contractExport = exports[j];
+      if (!contractExport.path.startsWith("/")) {
+        throw new Error(
+          `Contract '${contractExport.name}' in ${filePath} must use absolute path. Found: '${contractExport.path}'. Use '/your-path' instead.`
+        );
+      }
+      if (packagePrefix && !contractExport.path.startsWith(packagePrefix)) {
+        throw new Error(
+          `Contract '${contractExport.name}' in ${filePath} must include package prefix. Expected path to start with '${packagePrefix}', but found: '${contractExport.path}'. Example: path: '${packagePrefix}/${contractExport.path}'`
+        );
+      }
+      mappings.push({
+        method: contractExport.method,
+        path: contractExport.path,
+        contractName: contractExport.name,
+        contractImportPath: getImportPath(filePath),
+        routeFile: "",
+        contractFile: filePath,
+        hasQuery: contractExport.hasQuery,
+        hasBody: contractExport.hasBody,
+        hasParams: contractExport.hasParams
+      });
+    }
+  }
+  return mappings;
+}
+async function scanContractFiles(dir, files = []) {
+  try {
+    const entries = await readdir(dir);
+    for (let i = 0; i < entries.length; i++) {
+      const entry = entries[i];
+      const fullPath = join(dir, entry);
+      const fileStat = await stat(fullPath);
+      if (fileStat.isDirectory()) {
+        await scanContractFiles(fullPath, files);
+      } else {
+        if ((entry.endsWith(".ts") || entry.endsWith(".js") || entry.endsWith(".mjs")) && !entry.endsWith(".d.ts") && !entry.endsWith(".test.ts") && !entry.endsWith(".test.js") && !entry.endsWith(".test.mjs")) {
+          files.push(fullPath);
+        }
+      }
+    }
+  } catch (error) {
+  }
+  return files;
+}
+function extractContractExports(filePath) {
+  const sourceCode = readFileSync(filePath, "utf-8");
+  const sourceFile = ts.createSourceFile(
+    filePath,
+    sourceCode,
+    ts.ScriptTarget.Latest,
+    true
+  );
+  const exports = [];
+  function visit(node) {
+    if (ts.isVariableStatement(node)) {
+      const hasExport = node.modifiers?.some(
+        (m) => m.kind === ts.SyntaxKind.ExportKeyword
+      );
+      if (hasExport && node.declarationList.declarations.length > 0) {
+        const declaration = node.declarationList.declarations[0];
+        if (ts.isVariableDeclaration(declaration) && ts.isIdentifier(declaration.name) && declaration.initializer) {
+          const name = declaration.name.text;
+          const hasSatisfiesRouteContract = checkSatisfiesRouteContract(declaration.initializer);
+          if (hasSatisfiesRouteContract) {
+            const objectLiteral = extractObjectLiteral(declaration.initializer);
+            if (objectLiteral) {
+              const contractData = extractContractData(objectLiteral);
+              if (contractData.method && contractData.path) {
+                exports.push({
+                  name,
+                  method: contractData.method,
+                  path: contractData.path,
+                  hasQuery: contractData.hasQuery,
+                  hasBody: contractData.hasBody,
+                  hasParams: contractData.hasParams
+                });
+              }
+            }
+            return;
+          }
+          if (isContractName(name)) {
+            const objectLiteral = extractObjectLiteral(declaration.initializer);
+            if (objectLiteral) {
+              const contractData = extractContractData(objectLiteral);
+              if (contractData.method && contractData.path) {
+                exports.push({
+                  name,
+                  method: contractData.method,
+                  path: contractData.path,
+                  hasQuery: contractData.hasQuery,
+                  hasBody: contractData.hasBody,
+                  hasParams: contractData.hasParams
+                });
+              }
+            }
+          }
+        }
       }
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      process.stderr.write(`[FileTransport] Failed to check file size: ${errorMessage}
-`);
     }
+    ts.forEachChild(node, visit);
   }
-  /**
-   * 크기 기반 로테이션 수행
-   * 예: 2025-01-01.log -> 2025-01-01.1.log, 2025-01-01.1.log -> 2025-01-01.2.log
-   */
-  async rotateBySize() {
-    if (!this.currentFilename) {
-      return;
-    }
-    await this.closeStream();
-    const baseName = this.currentFilename.replace(/\.log$/, "");
-    const files = readdirSync(this.logDir);
-    const relatedFiles = files.filter((file) => file.startsWith(baseName) && file.endsWith(".log")).sort().reverse();
-    for (const file of relatedFiles) {
-      const match = file.match(/\.(\d+)\.log$/);
-      if (match) {
-        const oldNum = parseInt(match[1], 10);
-        const newNum = oldNum + 1;
-        const oldPath = join(this.logDir, file);
-        const newPath2 = join(this.logDir, `${baseName}.${newNum}.log`);
-        try {
-          renameSync(oldPath, newPath2);
-        } catch (error) {
-          const errorMessage = error instanceof Error ? error.message : String(error);
-          process.stderr.write(`[FileTransport] Failed to rotate file: ${errorMessage}
-`);
+  visit(sourceFile);
+  return exports;
+}
+function checkSatisfiesRouteContract(initializer) {
+  if (!ts.isSatisfiesExpression(initializer)) {
+    return false;
+  }
+  const typeNode = initializer.type;
+  if (ts.isTypeReferenceNode(typeNode) && ts.isIdentifier(typeNode.typeName)) {
+    return typeNode.typeName.text === "RouteContract";
+  }
+  return false;
+}
+function extractObjectLiteral(initializer) {
+  if (ts.isObjectLiteralExpression(initializer)) {
+    return initializer;
+  }
+  if (ts.isSatisfiesExpression(initializer)) {
+    return extractObjectLiteral(initializer.expression);
+  }
+  if (ts.isAsExpression(initializer)) {
+    return extractObjectLiteral(initializer.expression);
+  }
+  return void 0;
+}
+function extractContractData(objectLiteral) {
+  const result = {};
+  for (let i = 0; i < objectLiteral.properties.length; i++) {
+    const prop = objectLiteral.properties[i];
+    if (ts.isPropertyAssignment(prop) && ts.isIdentifier(prop.name)) {
+      const propName = prop.name.text;
+      if (propName === "method") {
+        let value;
+        if (ts.isStringLiteral(prop.initializer)) {
+          value = prop.initializer.text;
+        } else if (ts.isAsExpression(prop.initializer) && ts.isStringLiteral(prop.initializer.expression)) {
+          value = prop.initializer.expression.text;
         }
+        if (value) result.method = value;
+      } else if (propName === "path") {
+        let value;
+        if (ts.isStringLiteral(prop.initializer)) {
+          value = prop.initializer.text;
+        } else if (ts.isAsExpression(prop.initializer) && ts.isStringLiteral(prop.initializer.expression)) {
+          value = prop.initializer.expression.text;
+        }
+        if (value) result.path = value;
+      } else if (propName === "query") {
+        result.hasQuery = true;
+      } else if (propName === "body") {
+        result.hasBody = true;
+      } else if (propName === "params") {
+        result.hasParams = true;
       }
     }
-    const currentPath = join(this.logDir, this.currentFilename);
-    const newPath = join(this.logDir, `${baseName}.1.log`);
-    try {
-      if (existsSync(currentPath)) {
-        renameSync(currentPath, newPath);
-      }
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      process.stderr.write(`[FileTransport] Failed to rotate current file: ${errorMessage}
-`);
+  }
+  return result;
+}
+function isContractName(name) {
+  return name.indexOf("Contract") !== -1 || name.indexOf("contract") !== -1 || name.endsWith("Schema") || name.endsWith("schema");
+}
+function getImportPath(filePath) {
+  const srcIndex = filePath.indexOf("/src/");
+  if (srcIndex === -1) {
+    throw new Error(`Cannot determine import path for ${filePath}: /src/ directory not found`);
+  }
+  let cleanPath = filePath.substring(srcIndex + 5);
+  if (cleanPath.endsWith(".ts")) {
+    cleanPath = cleanPath.slice(0, -3);
+  } else if (cleanPath.endsWith(".js")) {
+    cleanPath = cleanPath.slice(0, -3);
+  } else if (cleanPath.endsWith(".mjs")) {
+    cleanPath = cleanPath.slice(0, -4);
+  }
+  return "@/" + cleanPath;
+}
+
+// src/codegen/built-in/contract/helpers.ts
+function groupByResource(mappings) {
+  const grouped = {};
+  for (let i = 0; i < mappings.length; i++) {
+    const mapping = mappings[i];
+    const resource = extractResourceName(mapping.path);
+    if (!grouped[resource]) {
+      grouped[resource] = [];
     }
-    await this.rotateStream(this.currentFilename);
+    grouped[resource].push(mapping);
   }
-  /**
-   * 오래된 로그 파일 정리
-   * maxFiles 개수를 초과하는 로그 파일 삭제
-   */
-  async cleanOldFiles() {
-    try {
-      if (!existsSync(this.logDir)) {
-        return;
-      }
-      const files = readdirSync(this.logDir);
-      const logFiles = files.filter((file) => file.endsWith(".log")).map((file) => {
-        const filepath = join(this.logDir, file);
-        const stats = statSync(filepath);
-        return { file, mtime: stats.mtime };
-      }).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
-      if (logFiles.length > this.maxFiles) {
-        const filesToDelete = logFiles.slice(this.maxFiles);
-        for (const { file } of filesToDelete) {
-          const filepath = join(this.logDir, file);
-          try {
-            unlinkSync(filepath);
-          } catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            process.stderr.write(`[FileTransport] Failed to delete old file "${file}": ${errorMessage}
-`);
-          }
-        }
-      }
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      process.stderr.write(`[FileTransport] Failed to clean old files: ${errorMessage}
-`);
+  return grouped;
+}
+function extractResourceName(path) {
+  let processedPath = path;
+  if (!processedPath.startsWith("/")) {
+    processedPath = "/" + processedPath;
+  }
+  const segments = processedPath.slice(1).split("/").filter((s) => s && s !== "*");
+  const staticSegments = [];
+  for (let i = 0; i < segments.length; i++) {
+    const seg = segments[i];
+    if (!seg.startsWith(":")) {
+      staticSegments.push(seg);
     }
   }
-  /**
-   * 날짜별 로그 파일명 생성
-   */
-  getLogFilename(date) {
-    const year = date.getFullYear();
-    const month = String(date.getMonth() + 1).padStart(2, "0");
-    const day = String(date.getDate()).padStart(2, "0");
-    return `${year}-${month}-${day}.log`;
+  if (staticSegments.length === 0) {
+    return "root";
   }
-  async close() {
-    await this.closeStream();
+  const first = toCamelCase(staticSegments[0], false);
+  if (staticSegments.length === 1) {
+    return first;
   }
-};
-function isFileLoggingEnabled() {
-  return process.env.LOGGER_FILE_ENABLED === "true";
+  const result = [first];
+  for (let i = 1; i < staticSegments.length; i++) {
+    const seg = staticSegments[i];
+    result.push(toCamelCase(seg, true));
+  }
+  return result.join("");
 }
-function getDefaultLogLevel() {
-  const isProduction = process.env.NODE_ENV === "production";
-  const isDevelopment = process.env.NODE_ENV === "development";
-  if (isDevelopment) {
-    return "debug";
+function toCamelCase(str, capitalize2) {
+  const parts = str.split(/[-_]/);
+  if (parts.length === 1) {
+    return capitalize2 ? str.charAt(0).toUpperCase() + str.slice(1) : str;
   }
-  if (isProduction) {
-    return "info";
+  const result = [];
+  for (let i = 0; i < parts.length; i++) {
+    const part = parts[i];
+    if (i === 0 && !capitalize2) {
+      result.push(part);
+    } else {
+      result.push(part.charAt(0).toUpperCase() + part.slice(1));
+    }
   }
-  return "warn";
+  return result.join("");
 }
-function getConsoleConfig() {
-  const isProduction = process.env.NODE_ENV === "production";
+
+// src/codegen/built-in/contract/emitter.ts
+async function generateClient(mappings, options) {
+  const startTime = Date.now();
+  const grouped = groupByResource(mappings);
+  const resourceNames = Object.keys(grouped);
+  await generateSplitClient(mappings, grouped, options);
   return {
-    level: "debug",
-    enabled: true,
-    colorize: !isProduction
-    // Dev: colored output, Production: plain text
+    routesScanned: mappings.length,
+    contractsFound: mappings.length,
+    contractFiles: countUniqueContractFiles(mappings),
+    resourcesGenerated: resourceNames.length,
+    methodsGenerated: mappings.length,
+    duration: Date.now() - startTime
   };
 }
-function getFileConfig() {
-  const isProduction = process.env.NODE_ENV === "production";
-  return {
-    level: "info",
-    enabled: isProduction,
-    // File logging in production only
-    logDir: process.env.LOG_DIR || "./logs",
-    maxFileSize: 10 * 1024 * 1024,
-    // 10MB
-    maxFiles: 10
-  };
+function generateHeader() {
+  return `/**
+ * Auto-generated API Client
+ *
+ * Generated by @spfn/core codegen
+ * DO NOT EDIT MANUALLY
+ *
+ * @generated ${(/* @__PURE__ */ new Date()).toISOString()}
+ */
+
+`;
 }
-function validateDirectoryWritable(dirPath) {
-  if (!existsSync(dirPath)) {
-    try {
-      mkdirSync(dirPath, { recursive: true });
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      throw new Error(`Failed to create log directory "${dirPath}": ${errorMessage}`);
+function groupContractsByImportPath(mappings) {
+  const groups = {};
+  for (let i = 0; i < mappings.length; i++) {
+    const mapping = mappings[i];
+    const path = mapping.contractImportPath;
+    if (!groups[path]) {
+      groups[path] = /* @__PURE__ */ new Set();
     }
+    groups[path].add(mapping.contractName);
   }
-  try {
-    accessSync(dirPath, constants.W_OK);
-  } catch {
-    throw new Error(`Log directory "${dirPath}" is not writable. Please check permissions.`);
-  }
-  const testFile = join(dirPath, ".logger-write-test");
-  try {
-    writeFileSync(testFile, "test", "utf-8");
-    unlinkSync(testFile);
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    throw new Error(`Cannot write to log directory "${dirPath}": ${errorMessage}`);
+  const result = {};
+  const keys = Object.keys(groups);
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+    result[key] = Array.from(groups[key]);
   }
+  return result;
 }
-function validateFileConfig() {
-  if (!isFileLoggingEnabled()) {
-    return;
+function generateTypeName(mapping) {
+  let name = mapping.contractName;
+  if (name.endsWith("Contract")) {
+    name = name.slice(0, -8);
   }
-  const logDir = process.env.LOG_DIR;
-  if (!logDir) {
-    throw new Error(
-      "LOG_DIR environment variable is required when LOGGER_FILE_ENABLED=true. Example: LOG_DIR=/var/log/myapp"
-    );
+  if (name.length > 0) {
+    name = name.charAt(0).toUpperCase() + name.slice(1);
   }
-  validateDirectoryWritable(logDir);
+  return name;
 }
-function validateSlackConfig() {
-  const webhookUrl = process.env.SLACK_WEBHOOK_URL;
-  if (!webhookUrl) {
-    return;
+function generateMethodCode(mapping, options) {
+  const methodName = generateMethodName(mapping);
+  const hasParams = mapping.hasParams || mapping.path.includes(":");
+  const hasQuery = mapping.hasQuery || false;
+  const hasBody = mapping.hasBody || false;
+  let code = "";
+  if (options.includeJsDoc !== false) {
+    code += `        /**
+`;
+    code += `         * ${mapping.method} ${mapping.path}
+`;
+    code += `         */
+`;
   }
-  if (!webhookUrl.startsWith("https://hooks.slack.com/")) {
-    throw new Error(
-      `Invalid SLACK_WEBHOOK_URL: "${webhookUrl}". Slack webhook URLs must start with "https://hooks.slack.com/"`
-    );
+  code += `        ${methodName}: (`;
+  const params = [];
+  const typeName = generateTypeName(mapping);
+  if (hasParams) {
+    params.push(`params: ${typeName}Params`);
   }
-}
-function validateEmailConfig() {
-  const smtpHost = process.env.SMTP_HOST;
-  const smtpPort = process.env.SMTP_PORT;
-  const emailFrom = process.env.EMAIL_FROM;
-  const emailTo = process.env.EMAIL_TO;
-  const hasAnyEmailConfig = smtpHost || smtpPort || emailFrom || emailTo;
-  if (!hasAnyEmailConfig) {
-    return;
+  if (hasQuery) {
+    params.push(`query?: ${typeName}Query`);
   }
-  const missingFields = [];
-  if (!smtpHost) missingFields.push("SMTP_HOST");
-  if (!smtpPort) missingFields.push("SMTP_PORT");
-  if (!emailFrom) missingFields.push("EMAIL_FROM");
-  if (!emailTo) missingFields.push("EMAIL_TO");
-  if (missingFields.length > 0) {
-    throw new Error(
-      `Email transport configuration incomplete. Missing: ${missingFields.join(", ")}. Either set all required fields or remove all email configuration.`
-    );
+  if (hasBody) {
+    params.push(`body: ${typeName}Body`);
   }
-  const port = parseInt(smtpPort, 10);
-  if (isNaN(port) || port < 1 || port > 65535) {
-    throw new Error(
-      `Invalid SMTP_PORT: "${smtpPort}". Must be a number between 1 and 65535.`
-    );
+  if (params.length > 0) {
+    code += `options: { ${params.join(", ")} }`;
   }
-  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-  if (!emailRegex.test(emailFrom)) {
-    throw new Error(`Invalid EMAIL_FROM format: "${emailFrom}"`);
+  code += `) => `;
+  code += `client.call(${mapping.contractName}`;
+  if (params.length > 0) {
+    code += `, options`;
   }
-  const recipients = emailTo.split(",").map((e) => e.trim());
-  for (const email of recipients) {
-    if (!emailRegex.test(email)) {
-      throw new Error(`Invalid email address in EMAIL_TO: "${email}"`);
+  code += `),
+`;
+  return code;
+}
+function generateMethodName(mapping) {
+  const method = mapping.method.toLowerCase();
+  if (mapping.path === "/" || mapping.path.match(/^\/[\w-]+$/)) {
+    if (method === "get") {
+      return "list";
+    }
+    if (method === "post") {
+      return "create";
     }
   }
-}
-function validateEnvironment() {
-  const nodeEnv = process.env.NODE_ENV;
-  if (!nodeEnv) {
-    process.stderr.write(
-      "[Logger] Warning: NODE_ENV is not set. Defaulting to test environment.\n"
-    );
+  if (mapping.path.includes(":")) {
+    if (method === "get") {
+      return "getById";
+    }
+    if (method === "put" || method === "patch") {
+      return "update";
+    }
+    if (method === "delete") {
+      return "delete";
+    }
   }
+  return method;
 }
-function validateConfig() {
-  try {
-    validateEnvironment();
-    validateFileConfig();
-    validateSlackConfig();
-    validateEmailConfig();
-  } catch (error) {
-    if (error instanceof Error) {
-      throw new Error(`[Logger] Configuration validation failed: ${error.message}`);
+function countUniqueContractFiles(mappings) {
+  const files = /* @__PURE__ */ new Set();
+  for (let i = 0; i < mappings.length; i++) {
+    if (mappings[i].contractFile) {
+      files.add(mappings[i].contractFile);
     }
-    throw error;
   }
+  return files.size;
 }
-
-// src/logger/adapters/custom.ts
-function initializeTransports() {
-  const transports = [];
-  const consoleConfig = getConsoleConfig();
-  transports.push(new ConsoleTransport(consoleConfig));
-  const fileConfig = getFileConfig();
-  if (fileConfig.enabled) {
-    transports.push(new FileTransport(fileConfig));
+function toKebabCase(str) {
+  if (str.length === 0) {
+    return str;
   }
-  return transports;
+  return str.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
 }
-var CustomAdapter = class _CustomAdapter {
-  logger;
-  constructor(config) {
-    this.logger = new Logger({
-      level: config.level,
-      module: config.module,
-      transports: initializeTransports()
-    });
-  }
-  child(module) {
-    const adapter = new _CustomAdapter({ level: this.logger.level, module });
-    adapter.logger = this.logger.child(module);
-    return adapter;
-  }
-  debug(message, context) {
-    this.logger.debug(message, context);
-  }
-  info(message, context) {
-    this.logger.info(message, context);
+async function generateSplitClient(_mappings, grouped, options) {
+  const outputPath = options.outputPath;
+  const outputDir = outputPath.endsWith(".ts") || outputPath.endsWith(".js") ? outputPath.replace(/\.[jt]s$/, "") : outputPath;
+  await mkdir(outputDir, { recursive: true });
+  const resourceNames = Object.keys(grouped);
+  for (let i = 0; i < resourceNames.length; i++) {
+    const resourceName = resourceNames[i];
+    const routes = grouped[resourceName];
+    const code = generateResourceFile(resourceName, routes, options);
+    const kebabName = toKebabCase(resourceName);
+    const filePath = `${outputDir}/${kebabName}.ts`;
+    await writeFile(filePath, code, "utf-8");
   }
-  warn(message, errorOrContext, context) {
-    if (errorOrContext instanceof Error) {
-      this.logger.warn(message, errorOrContext, context);
-    } else {
-      this.logger.warn(message, errorOrContext);
-    }
+  const indexCode = generateIndexFile(resourceNames, options);
+  const indexPath = `${outputDir}/index.ts`;
+  await writeFile(indexPath, indexCode, "utf-8");
+}
+function generateResourceFile(resourceName, routes, options) {
+  let code = "";
+  code += generateHeader();
+  code += `import { client } from '@spfn/core/client';
+`;
+  if (options.includeTypes !== false) {
+    code += `import type { InferContract } from '@spfn/core';
+`;
   }
-  error(message, errorOrContext, context) {
-    if (errorOrContext instanceof Error) {
-      this.logger.error(message, errorOrContext, context);
-    } else {
-      this.logger.error(message, errorOrContext);
-    }
+  code += `
+`;
+  const importGroups = groupContractsByImportPath(routes);
+  const importPaths = Object.keys(importGroups);
+  for (let i = 0; i < importPaths.length; i++) {
+    const importPath = importPaths[i];
+    const contracts = importGroups[importPath];
+    code += `import { ${contracts.join(", ")} } from '${importPath}';
+`;
   }
-  fatal(message, errorOrContext, context) {
-    if (errorOrContext instanceof Error) {
-      this.logger.fatal(message, errorOrContext, context);
-    } else {
-      this.logger.fatal(message, errorOrContext);
+  code += `
+`;
+  if (options.includeTypes !== false) {
+    code += `// ============================================
+`;
+    code += `// Types
+`;
+    code += `// ============================================
+
+`;
+    for (let i = 0; i < routes.length; i++) {
+      const route = routes[i];
+      const typeName = generateTypeName(route);
+      const contractType = `typeof ${route.contractName}`;
+      code += `export type ${typeName}Response = InferContract<${contractType}>['response'];
+`;
+      if (route.hasQuery) {
+        code += `export type ${typeName}Query = InferContract<${contractType}>['query'];
+`;
+      }
+      if (route.hasParams || route.path.includes(":")) {
+        code += `export type ${typeName}Params = InferContract<${contractType}>['params'];
+`;
+      }
+      if (route.hasBody) {
+        code += `export type ${typeName}Body = InferContract<${contractType}>['body'];
+`;
+      }
+      code += `
+`;
     }
   }
-  async close() {
-    await this.logger.close();
-  }
-};
-
-// src/logger/adapter-factory.ts
-function createAdapter(type) {
-  const level = getDefaultLogLevel();
-  switch (type) {
-    case "pino":
-      return new PinoAdapter({ level });
-    case "custom":
-      return new CustomAdapter({ level });
-    default:
-      return new PinoAdapter({ level });
+  code += `/**
+`;
+  code += ` * ${resourceName} API
+`;
+  code += ` */
+`;
+  code += `export const ${resourceName} = {
+`;
+  for (let i = 0; i < routes.length; i++) {
+    const route = routes[i];
+    code += generateMethodCode(route, options);
   }
+  code += `} as const;
+`;
+  return code;
 }
-function getAdapterType() {
-  const adapterEnv = process.env.LOGGER_ADAPTER;
-  if (adapterEnv === "custom" || adapterEnv === "pino") {
-    return adapterEnv;
+function toCamelCase2(str) {
+  if (str.length === 0) {
+    return str;
   }
-  return "pino";
-}
-function initializeLogger() {
-  validateConfig();
-  return createAdapter(getAdapterType());
+  return str.charAt(0).toLowerCase() + str.slice(1);
 }
-var logger = initializeLogger();
+function generateIndexFile(resourceNames, options) {
+  let code = "";
+  const apiName = options.apiName || "api";
+  code += generateHeader();
+  code += `export { client } from '@spfn/core/client';
 
-// src/codegen/watch-generate.ts
-var codegenLogger = logger.child("codegen");
-async function generateOnce(options) {
-  const cwd = process.cwd();
-  const routesDir = options.routesDir ?? join(cwd, "src", "server", "routes");
-  const outputPath = options.outputPath ?? join(cwd, "src", "lib", "api.ts");
-  try {
-    const contracts = await scanContracts(routesDir);
-    if (contracts.length === 0) {
-      if (options.debug) {
-        codegenLogger.warn("No contracts found");
-      }
-      return null;
-    }
-    const stats = await generateClient(contracts, {
-      outputPath,
-      includeTypes: true,
-      includeJsDoc: true
-    });
-    if (options.debug) {
-      codegenLogger.info("Client generated", {
-        endpoints: stats.methodsGenerated,
-        resources: stats.resourcesGenerated,
-        duration: stats.duration
-      });
+`;
+  for (let i = 0; i < resourceNames.length; i++) {
+    const resourceName = resourceNames[i];
+    const kebabName = toKebabCase(resourceName);
+    code += `export * from './${kebabName}.js';
+`;
+  }
+  code += `
+`;
+  for (let i = 0; i < resourceNames.length; i++) {
+    const resourceName = resourceNames[i];
+    const kebabName = toKebabCase(resourceName);
+    code += `import { ${resourceName} } from './${kebabName}.js';
+`;
+  }
+  code += `
+`;
+  const resourceKeys = resourceNames.map((name) => toCamelCase2(name));
+  code += `/**
+`;
+  code += ` * Type-safe API client
+`;
+  code += ` */
+`;
+  code += `export const ${apiName} = {
+`;
+  for (let i = 0; i < resourceNames.length; i++) {
+    const resourceName = resourceNames[i];
+    const resourceKey = resourceKeys[i];
+    code += `    ${resourceKey}: ${resourceName}`;
+    if (i < resourceNames.length - 1) {
+      code += `,`;
     }
-    return stats;
-  } catch (error) {
-    codegenLogger.error(
-      "Generation failed",
-      error instanceof Error ? error : new Error(String(error))
-    );
-    return null;
+    code += `
+`;
   }
+  code += `} as const;
+`;
+  return code;
 }
-async function watchAndGenerate(options = {}) {
-  const cwd = process.cwd();
-  const routesDir = options.routesDir ?? join(cwd, "src", "server", "routes");
-  const outputPath = options.outputPath ?? join(cwd, "src", "lib", "api.ts");
-  const watchMode = options.watch !== false;
-  if (options.debug) {
-    codegenLogger.info("Contract Watcher Started", { routesDir, outputPath, watch: watchMode });
-  }
-  await generateOnce(options);
-  if (watchMode) {
-    let isGenerating = false;
-    let pendingRegeneration = false;
-    const watcher = watch(routesDir, {
-      ignored: /(^|[\/\\])\../,
-      // ignore dotfiles
-      persistent: true,
-      ignoreInitial: true,
-      awaitWriteFinish: {
-        stabilityThreshold: 100,
-        pollInterval: 50
-      }
-    });
-    const regenerate = async () => {
-      if (isGenerating) {
-        pendingRegeneration = true;
-        return;
-      }
-      isGenerating = true;
-      pendingRegeneration = false;
-      if (options.debug) {
-        codegenLogger.info("Contracts changed, regenerating...");
-      }
-      await generateOnce(options);
-      isGenerating = false;
-      if (pendingRegeneration) {
-        await regenerate();
-      }
-    };
-    watcher.on("add", regenerate).on("change", regenerate).on("unlink", regenerate);
-    process.on("SIGINT", () => {
-      watcher.close();
-      process.exit(0);
-    });
-    await new Promise(() => {
-    });
+
+// src/codegen/built-in/contract/index.ts
+var contractLogger = logger.child("contract-gen");
+var DEFAULT_CONTRACTS_DIR = "src/lib/contracts";
+var DEFAULT_OUTPUT_PATH = "src/lib/api";
+var contractCache = null;
+function needsFullRegeneration(event) {
+  if (event === "add" || event === "unlink") {
+    return true;
+  }
+  if (!contractCache) {
+    return true;
   }
+  return false;
 }
-if (import.meta.url === `file://${process.argv[1]}`) {
-  watchAndGenerate({ debug: true });
+function createClientOptions(contractsDir, outputPath, baseUrl, apiName) {
+  return {
+    routesDir: contractsDir,
+    outputPath,
+    baseUrl,
+    apiName,
+    includeTypes: true,
+    includeJsDoc: true,
+    splitByResource: true
+  };
 }
-var orchestratorLogger = logger.child("orchestrator");
-var CodegenOrchestrator = class {
-  generators;
-  cwd;
-  debug;
-  isGenerating = false;
-  pendingRegenerations = /* @__PURE__ */ new Set();
-  constructor(options) {
-    this.generators = options.generators;
-    this.cwd = options.cwd ?? process.cwd();
-    this.debug = options.debug ?? false;
+function generateApiName(prefix) {
+  if (!prefix || prefix === "/api") {
+    return "api";
   }
-  /**
-   * Run all generators once
-   */
-  async generateAll() {
-    if (this.debug) {
-      orchestratorLogger.info("Running all generators", {
-        count: this.generators.length,
-        names: this.generators.map((g) => g.name)
-      });
-    }
-    for (const generator of this.generators) {
-      try {
-        const genOptions = {
-          cwd: this.cwd,
-          debug: this.debug
-        };
-        await generator.generate(genOptions);
-        if (this.debug) {
-          orchestratorLogger.info(`[${generator.name}] Generated successfully`);
-        }
-      } catch (error) {
-        const err = error instanceof Error ? error : new Error(String(error));
-        orchestratorLogger.error(`[${generator.name}] Generation failed`, err);
-      }
-    }
+  const name = prefix.replace(/^\/[_-]?/, "").replace(/[_-]/g, "");
+  if (!name) {
+    return "api";
   }
-  /**
-   * Start watch mode
-   */
-  async watch() {
-    await this.generateAll();
-    const allPatterns = this.generators.flatMap((g) => g.watchPatterns);
-    if (allPatterns.length === 0) {
-      orchestratorLogger.warn("No watch patterns defined, exiting watch mode");
-      return;
-    }
-    const dirsToWatch = /* @__PURE__ */ new Set();
-    for (const pattern of allPatterns) {
-      const baseDir = pattern.split("**")[0].replace(/\/$/, "") || ".";
-      dirsToWatch.add(join(this.cwd, baseDir));
-    }
-    const watchDirs = Array.from(dirsToWatch);
-    if (this.debug) {
-      orchestratorLogger.info("Starting watch mode", {
-        patterns: allPatterns,
-        watchDirs,
-        cwd: this.cwd
-      });
+  return `${name}Api`;
+}
+function readPrefixFromPackageJson(cwd) {
+  try {
+    const packageJsonPath = join(cwd, "package.json");
+    if (!existsSync(packageJsonPath)) {
+      return void 0;
     }
-    const watcher = watch(watchDirs, {
-      ignored: /(^|[\/\\])\../,
-      // ignore dotfiles
-      persistent: true,
-      ignoreInitial: true,
-      awaitWriteFinish: {
-        stabilityThreshold: 100,
-        pollInterval: 50
-      }
-    });
-    const handleChange = async (absolutePath, event) => {
-      const filePath = relative(this.cwd, absolutePath);
-      if (this.isGenerating) {
-        this.pendingRegenerations.add(absolutePath);
-        return;
-      }
-      this.isGenerating = true;
-      this.pendingRegenerations.clear();
-      if (this.debug) {
-        orchestratorLogger.info(`File ${event}`, { file: filePath });
-      }
-      for (const generator of this.generators) {
-        const matches = generator.watchPatterns.some(
-          (pattern) => mm.isMatch(filePath, pattern)
-        );
-        if (matches) {
-          try {
-            if (generator.onFileChange) {
-              await generator.onFileChange(filePath, event);
-            } else {
-              const genOptions = {
-                cwd: this.cwd,
-                debug: this.debug
-              };
-              await generator.generate(genOptions);
-            }
-            if (this.debug) {
-              orchestratorLogger.info(`[${generator.name}] Regenerated`);
-            }
-          } catch (error) {
-            const err = error instanceof Error ? error : new Error(String(error));
-            orchestratorLogger.error(`[${generator.name}] Regeneration failed`, err);
-          }
-        }
-      }
-      this.isGenerating = false;
-      if (this.pendingRegenerations.size > 0) {
-        const next = Array.from(this.pendingRegenerations)[0];
-        await handleChange(next, "change");
-      }
-    };
-    watcher.on("add", (path) => handleChange(path, "add")).on("change", (path) => handleChange(path, "change")).on("unlink", (path) => handleChange(path, "unlink"));
-    process.on("SIGINT", () => {
-      if (this.debug) {
-        orchestratorLogger.info("Shutting down watch mode");
-      }
-      watcher.close();
-      process.exit(0);
-    });
-    await new Promise(() => {
-    });
+    const content = readFileSync(packageJsonPath, "utf-8");
+    const packageJson = JSON.parse(content);
+    return packageJson.spfn?.prefix;
+  } catch (error) {
+    return void 0;
   }
-};
-var contractLogger = logger.child("contract-gen");
+}
 function createContractGenerator(config = {}) {
+  const contractsDir = config.contractsDir ?? DEFAULT_CONTRACTS_DIR;
+  const outputPath = config.outputPath ?? DEFAULT_OUTPUT_PATH;
+  const runOn = config.runOn ?? ["watch", "manual", "build"];
   return {
     name: "contract",
     watchPatterns: [
-      "src/lib/contracts/**/*.ts"
+      `${contractsDir}/**/*.ts`
     ],
+    runOn,
     async generate(options) {
       const cwd = options.cwd;
-      const libContractsDir = join(cwd, "src", "lib", "contracts");
-      const outputPath = config.outputPath ?? join(cwd, "src", "lib", "api.ts");
+      const fullContractsDir = join(cwd, contractsDir);
+      const fullOutputPath = join(cwd, outputPath);
+      const prefix = readPrefixFromPackageJson(cwd);
+      const apiName = generateApiName(prefix);
       try {
-        if (!existsSync(libContractsDir)) {
+        if (!existsSync(fullContractsDir)) {
           if (options.debug) {
-            contractLogger.warn("No contracts directory found at src/lib/contracts");
+            contractLogger.warn(`No contracts directory found at ${contractsDir}`);
           }
           return;
         }
-        const allContracts = await scanContracts(libContractsDir);
+        const changedFile = options.trigger?.changedFile;
+        if (changedFile && !needsFullRegeneration(changedFile.event)) {
+          if (options.debug) {
+            contractLogger.info("Attempting incremental update", {
+              file: changedFile.path,
+              event: changedFile.event
+            });
+          }
+          const success = await attemptIncrementalUpdate({
+            cwd,
+            contractsDir: fullContractsDir,
+            outputPath: fullOutputPath,
+            changedFilePath: changedFile.path,
+            baseUrl: config.baseUrl,
+            apiName,
+            debug: options.debug
+          });
+          if (success) {
+            if (options.debug) {
+              contractLogger.info("Incremental update successful");
+            }
+            return;
+          }
+          if (options.debug) {
+            contractLogger.info("Incremental update failed, doing full regen");
+          }
+        }
+        const allContracts = await scanContracts(fullContractsDir, prefix);
         if (allContracts.length === 0) {
           if (options.debug) {
             contractLogger.warn("No contracts found");
           }
+          contractCache = null;
           return;
         }
-        const stats = await generateClient(allContracts, {
-          outputPath,
-          includeTypes: true,
-          includeJsDoc: true});
+        const clientOptions = createClientOptions(fullContractsDir, fullOutputPath, config.baseUrl, apiName);
+        const stats = await generateClient(allContracts, clientOptions);
+        contractCache = {
+          contracts: allContracts,
+          lastScan: Date.now()
+        };
         if (options.debug) {
           contractLogger.info("Client generated", {
             endpoints: stats.methodsGenerated,
             resources: stats.resourcesGenerated,
-            duration: stats.duration
+            duration: stats.duration,
+            mode: changedFile ? "incremental-fallback" : "full"
           });
         }
       } catch (error) {
@@ -1508,6 +1563,75 @@ function createContractGenerator(config = {}) {
     }
   };
 }
+async function attemptIncrementalUpdate(options) {
+  const { cwd, contractsDir, outputPath, changedFilePath, baseUrl, apiName, debug } = options;
+  if (!contractCache) {
+    return false;
+  }
+  try {
+    const fullPath = join(cwd, changedFilePath);
+    if (!existsSync(fullPath)) {
+      return false;
+    }
+    const updatedContracts = await scanContracts(contractsDir);
+    if (updatedContracts.length === 0) {
+      contractCache = null;
+      return false;
+    }
+    const changedContracts = findChangedContracts(
+      contractCache.contracts,
+      updatedContracts,
+      changedFilePath
+    );
+    if (changedContracts.size === 0) {
+      if (debug) {
+        contractLogger.info("No contract changes detected, skipping regeneration");
+      }
+      return true;
+    }
+    const clientOptions = createClientOptions(contractsDir, outputPath, baseUrl, apiName);
+    const stats = await generateClient(updatedContracts, clientOptions);
+    contractCache = {
+      contracts: updatedContracts,
+      lastScan: Date.now()
+    };
+    if (debug) {
+      contractLogger.info("Incremental update successful", {
+        changedContracts: changedContracts.size,
+        endpoints: stats.methodsGenerated,
+        resources: stats.resourcesGenerated,
+        duration: stats.duration
+      });
+    }
+    return true;
+  } catch (error) {
+    if (debug) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      contractLogger.warn("Incremental update failed", err);
+    }
+    return false;
+  }
+}
+function findChangedContracts(oldContracts, newContracts, changedFilePath) {
+  const changed = /* @__PURE__ */ new Set();
+  const oldInFile = oldContracts.filter((c) => c.contractFile?.includes(changedFilePath));
+  const newInFile = newContracts.filter((c) => c.contractFile?.includes(changedFilePath));
+  if (oldInFile.length !== newInFile.length) {
+    newInFile.forEach((c) => changed.add(c.contractName));
+    return changed;
+  }
+  for (const newContract of newInFile) {
+    const oldContract = oldInFile.find((c) => c.contractName === newContract.contractName);
+    if (!oldContract) {
+      changed.add(newContract.contractName);
+      continue;
+    }
+    if (oldContract.method !== newContract.method || oldContract.path !== newContract.path || oldContract.hasQuery !== newContract.hasQuery || oldContract.hasBody !== newContract.hasBody || oldContract.hasParams !== newContract.hasParams) {
+      changed.add(newContract.contractName);
+    }
+  }
+  return changed;
+}
 var configLogger = logger.child("config");
 function loadCodegenConfig(cwd) {
   const rcPath = join(cwd, ".spfnrc.json");
@@ -1627,6 +1751,6 @@ async function createGeneratorsFromConfig(config, cwd) {
   return generators;
 }
 
-export { CodegenOrchestrator, createContractGenerator, createGeneratorsFromConfig, generateClient, groupByResource, loadCodegenConfig, scanContracts, watchAndGenerate };
+export { CodegenOrchestrator, createContractGenerator, createGeneratorsFromConfig, loadCodegenConfig };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map