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

package/dist/codegen/index.js

@@ -1,941 +1,431 @@
-import { existsSync, mkdirSync, accessSync, constants, writeFileSync, unlinkSync, readFileSync, createWriteStream, statSync, readdirSync, renameSync } from 'fs';
-import { readdir, stat, mkdir, writeFile } from 'fs/promises';
-import { join, dirname, 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/scanners/contract-scanner.ts
-async function scanContracts(contractsDir) {
-  const contractFiles = await scanContractFiles(contractsDir);
-  const mappings = [];
-  const packagePrefix = getPackagePrefix(contractsDir);
-  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.`
-        );
-      }
-      const finalPath = packagePrefix ? `${packagePrefix}${contractExport.path}` : contractExport.path;
-      mappings.push({
-        method: contractExport.method,
-        path: finalPath,
-        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 getPackagePrefix(contractsDir) {
-  try {
-    let currentDir = dirname(contractsDir);
-    for (let i = 0; i < 5; i++) {
-      const packageJsonPath = join(currentDir, "package.json");
-      try {
-        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-        if (packageJson.spfn?.prefix) {
-          return packageJson.spfn.prefix;
-        }
-      } catch {
-      }
-      currentDir = dirname(currentDir);
-    }
-  } catch {
-  }
-  return "";
+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();
 }
-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;
+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}`;
 }
-
-// src/codegen/scanners/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 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`;
-  }
-  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";
-    }
-  }
-  if (mapping.path.includes(":")) {
-    if (method === "get") {
-      return "getById";
-    }
-    if (method === "put" || method === "patch") {
-      return "update";
-    }
-    if (method === "delete") {
-      return "delete";
-    }
-  }
-  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);
-    }
-  }
-  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, 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';
-`;
-  }
-  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}';
-`;
-  }
-  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 += `
-`;
-    }
-  }
-  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 toCamelCase2(str) {
-  if (str.length === 0) {
-    return str;
-  }
-  return str.charAt(0).toLowerCase() + str.slice(1);
-}
-function generateIndexFile(resourceNames, options) {
-  let code = "";
-  const apiName = options.apiName || "api";
-  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 += `
-`;
-  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 += `,`;
-    }
-    code += `
-`;
-  }
-  code += `} as const;
-`;
-  return code;
-}
-var PinoAdapter = class _PinoAdapter {
-  logger;
-  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);
+  /**
+   * Info log
+   */
+  info(message, context) {
+    this.log("info", message, void 0, context);
   }
   warn(message, errorOrContext, context) {
     if (errorOrContext instanceof Error) {
-      this.logger.warn({ err: errorOrContext, ...context }, message);
+      this.log("warn", message, errorOrContext, context);
     } else {
-      this.logger.warn(errorOrContext || {}, message);
+      this.log("warn", message, void 0, errorOrContext);
     }
   }
   error(message, errorOrContext, context) {
     if (errorOrContext instanceof Error) {
-      this.logger.error({ err: errorOrContext, ...context }, message);
+      this.log("error", message, errorOrContext, context);
     } else {
-      this.logger.error(errorOrContext || {}, message);
+      this.log("error", message, void 0, errorOrContext);
     }
   }
   fatal(message, errorOrContext, context) {
     if (errorOrContext instanceof Error) {
-      this.logger.fatal({ err: errorOrContext, ...context }, message);
+      this.log("fatal", message, errorOrContext, context);
     } else {
-      this.logger.fatal(errorOrContext || {}, message);
+      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}
+`);
     }
   }
+  /**
+   * Close all Transports
+   */
   async close() {
+    const closePromises = this.config.transports.filter((transport) => transport.close).map((transport) => transport.close());
+    await Promise.all(closePromises);
   }
 };
 
-// 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;
-  }
-  if (Array.isArray(data)) {
-    return data.map((item) => maskSensitiveData(item));
+// 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;
   }
-  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 log(metadata) {
+    if (!this.enabled) {
+      return;
     }
-    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"
-};
-function formatTimestamp(date) {
-  return date.toISOString();
-}
-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 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}]`);
-  }
-  if (metadata.module) {
-    if (colorize) {
-      parts.push(`${COLORS.dim}[module=${metadata.module}]${COLORS.reset}`);
+    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 {
-      parts.push(`[module=${metadata.module}]`);
+      console.log(message);
     }
   }
-  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 levelStr = metadata.level.toUpperCase();
-  if (colorize) {
-    const color = COLORS[metadata.level];
-    parts.push(`${color}(${levelStr})${COLORS.reset}:`);
-  } else {
-    parts.push(`(${levelStr}):`);
-  }
-  if (colorize) {
-    parts.push(`${COLORS.bright}${metadata.message}${COLORS.reset}`);
-  } else {
-    parts.push(metadata.message);
-  }
-  let output = parts.join(" ");
-  if (metadata.error) {
-    output += "\n" + formatError(metadata.error);
-  }
-  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;
-  }
-  if (metadata.error) {
-    obj.error = {
-      name: metadata.error.name,
-      message: metadata.error.message,
-      stack: metadata.error.stack
-    };
-  }
-  return JSON.stringify(obj);
-}
-
-// src/logger/logger.ts
-var Logger = class _Logger {
-  config;
-  module;
+};
+var FileTransport = class {
+  name = "file";
+  level;
+  enabled;
+  logDir;
+  maxFileSize;
+  maxFiles;
+  currentStream = null;
+  currentFilename = null;
   constructor(config) {
-    this.config = config;
-    this.module = config.module;
+    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 });
+    }
   }
-  /**
-   * Get current log level
-   */
-  get level() {
-    return this.config.level;
+  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();
+          }
+        });
+      });
+    }
   }
   /**
-   * Create child logger (per module)
+   * 스트림 교체 (날짜 변경 시)
    */
-  child(module) {
-    return new _Logger({
-      ...this.config,
-      module
+  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;
     });
   }
   /**
-   * Debug log
-   */
-  debug(message, context) {
-    this.log("debug", message, void 0, context);
-  }
-  /**
-   * Info log
-   */
-  info(message, context) {
-    this.log("info", message, void 0, context);
-  }
-  warn(message, errorOrContext, context) {
-    if (errorOrContext instanceof Error) {
-      this.log("warn", message, errorOrContext, context);
-    } else {
-      this.log("warn", message, void 0, errorOrContext);
-    }
-  }
-  error(message, errorOrContext, context) {
-    if (errorOrContext instanceof Error) {
-      this.log("error", message, errorOrContext, context);
-    } else {
-      this.log("error", message, void 0, errorOrContext);
-    }
-  }
-  fatal(message, errorOrContext, context) {
-    if (errorOrContext instanceof Error) {
-      this.log("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}
-`);
-    }
-  }
-  /**
-   * Close all Transports
-   */
-  async close() {
-    const closePromises = this.config.transports.filter((transport) => transport.close).map((transport) => transport.close());
-    await Promise.all(closePromises);
-  }
-};
-
-// 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);
-    }
-  }
-};
-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 });
-    }
-  }
-  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();
-          }
-        });
-      });
-    }
-  }
-  /**
-   * 스트림 교체 (날짜 변경 시)
-   */
-  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) {
@@ -1284,91 +774,7 @@ function initializeLogger() {
 }
 var logger = initializeLogger();
 
-// 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
-      });
-    }
-    return stats;
-  } catch (error) {
-    codegenLogger.error(
-      "Generation failed",
-      error instanceof Error ? error : new Error(String(error))
-    );
-    return null;
-  }
-}
-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(() => {
-    });
-  }
-}
-if (import.meta.url === `file://${process.argv[1]}`) {
-  watchAndGenerate({ debug: true });
-}
+// src/codegen/core/orchestrator.ts
 var orchestratorLogger = logger.child("orchestrator");
 var CodegenOrchestrator = class {
   generators;
@@ -1518,6 +924,518 @@ var CodegenOrchestrator = class {
     });
   }
 };
+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
+                });
+              }
+            }
+          }
+        }
+      }
+    }
+    ts.forEachChild(node, visit);
+  }
+  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;
+      }
+    }
+  }
+  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] = [];
+    }
+    grouped[resource].push(mapping);
+  }
+  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);
+    }
+  }
+  if (staticSegments.length === 0) {
+    return "root";
+  }
+  const first = toCamelCase(staticSegments[0], false);
+  if (staticSegments.length === 1) {
+    return first;
+  }
+  const result = [first];
+  for (let i = 1; i < staticSegments.length; i++) {
+    const seg = staticSegments[i];
+    result.push(toCamelCase(seg, true));
+  }
+  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;
+  }
+  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 result.join("");
+}
+
+// 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 {
+    routesScanned: mappings.length,
+    contractsFound: mappings.length,
+    contractFiles: countUniqueContractFiles(mappings),
+    resourcesGenerated: resourceNames.length,
+    methodsGenerated: mappings.length,
+    duration: Date.now() - startTime
+  };
+}
+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]);
+  }
+  return result;
+}
+function generateTypeName(mapping) {
+  let name = mapping.contractName;
+  if (name.endsWith("Contract")) {
+    name = name.slice(0, -8);
+  }
+  if (name.length > 0) {
+    name = name.charAt(0).toUpperCase() + name.slice(1);
+  }
+  return name;
+}
+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`);
+  }
+  if (hasQuery) {
+    params.push(`query?: ${typeName}Query`);
+  }
+  if (hasBody) {
+    params.push(`body: ${typeName}Body`);
+  }
+  if (params.length > 0) {
+    code += `options: { ${params.join(", ")} }`;
+  }
+  code += `) => `;
+  code += `client.call(${mapping.contractName}`;
+  if (params.length > 0) {
+    code += `, options`;
+  }
+  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";
+    }
+  }
+  if (mapping.path.includes(":")) {
+    if (method === "get") {
+      return "getById";
+    }
+    if (method === "put" || method === "patch") {
+      return "update";
+    }
+    if (method === "delete") {
+      return "delete";
+    }
+  }
+  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);
+    }
+  }
+  return files.size;
+}
+function toKebabCase(str) {
+  if (str.length === 0) {
+    return str;
+  }
+  return str.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+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");
+  }
+  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';
+`;
+  }
+  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}';
+`;
+  }
+  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 += `
+`;
+    }
+  }
+  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 toCamelCase2(str) {
+  if (str.length === 0) {
+    return str;
+  }
+  return str.charAt(0).toLowerCase() + str.slice(1);
+}
+function generateIndexFile(resourceNames, options) {
+  let code = "";
+  const apiName = options.apiName || "api";
+  code += generateHeader();
+  code += `export { client } from '@spfn/core/client';
+
+`;
+  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 += `,`;
+    }
+    code += `
+`;
+  }
+  code += `} as const;
+`;
+  return code;
+}
+
+// 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";
@@ -1579,6 +1497,8 @@ function createContractGenerator(config = {}) {
       const cwd = options.cwd;
       const fullContractsDir = join(cwd, contractsDir);
       const fullOutputPath = join(cwd, outputPath);
+      const prefix = readPrefixFromPackageJson(cwd);
+      const apiName = generateApiName(prefix);
       try {
         if (!existsSync(fullContractsDir)) {
           if (options.debug) {
@@ -1600,6 +1520,7 @@ function createContractGenerator(config = {}) {
             outputPath: fullOutputPath,
             changedFilePath: changedFile.path,
             baseUrl: config.baseUrl,
+            apiName,
             debug: options.debug
           });
           if (success) {
@@ -1612,7 +1533,7 @@ function createContractGenerator(config = {}) {
             contractLogger.info("Incremental update failed, doing full regen");
           }
         }
-        const allContracts = await scanContracts(fullContractsDir);
+        const allContracts = await scanContracts(fullContractsDir, prefix);
         if (allContracts.length === 0) {
           if (options.debug) {
             contractLogger.warn("No contracts found");
@@ -1620,8 +1541,6 @@ function createContractGenerator(config = {}) {
           contractCache = null;
           return;
         }
-        const prefix = readPrefixFromPackageJson(cwd);
-        const apiName = generateApiName(prefix);
         const clientOptions = createClientOptions(fullContractsDir, fullOutputPath, config.baseUrl, apiName);
         const stats = await generateClient(allContracts, clientOptions);
         contractCache = {
@@ -1645,7 +1564,7 @@ function createContractGenerator(config = {}) {
   };
 }
 async function attemptIncrementalUpdate(options) {
-  const { cwd, contractsDir, outputPath, changedFilePath, baseUrl, debug } = options;
+  const { cwd, contractsDir, outputPath, changedFilePath, baseUrl, apiName, debug } = options;
   if (!contractCache) {
     return false;
   }
@@ -1670,7 +1589,7 @@ async function attemptIncrementalUpdate(options) {
       }
       return true;
     }
-    const clientOptions = createClientOptions(contractsDir, outputPath, baseUrl);
+    const clientOptions = createClientOptions(contractsDir, outputPath, baseUrl, apiName);
     const stats = await generateClient(updatedContracts, clientOptions);
     contractCache = {
       contracts: updatedContracts,
@@ -1832,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