@warlock.js/core 4.8.2 → 4.9.1

package/esm/dev-server/type-generator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-generator.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/dev-server/type-generator.ts"],"sourcesContent":["import { env } from \"@mongez/dotenv\";\r\nimport { ensureDirectoryAsync } from \"@warlock.js/fs\";\r\nimport { spawn } from \"child_process\";\r\nimport { constants } from \"fs\";\r\nimport { access, readFile, writeFile } from \"fs/promises\";\r\nimport { join, resolve } from \"path\";\r\nimport ts from \"typescript\";\r\nimport { warlockPath } from \"../utils\";\r\nimport { devLogError, devLogInfo, devLogSuccess, devServeLog } from \"./dev-logger\";\r\nimport { filesOrchestrator } from \"./files-orchestrator\";\r\nimport { Path } from \"./path\";\r\n\r\n/**\r\n * Typings manifest structure for tracking file hashes\r\n */\r\ntype TypingsManifest = {\r\n  version: string;\r\n  lastBuildTime: number;\r\n  storage: {\r\n    sourceHash: string;\r\n    drivers: string[];\r\n  } | null;\r\n  config: Record<\r\n    string,\r\n    {\r\n      sourceHash: string;\r\n      typeName: string | null;\r\n      importSource: string | null;\r\n      keys: string[];\r\n    }\r\n  >;\r\n};\r\n\r\n/**\r\n * TypeGenerator - Generates TypeScript type definitions from config files\r\n *\r\n * Parses source config files using the TypeScript Compiler API to extract\r\n * keys and generate module augmentation types for IDE autocomplete.\r\n *\r\n * Uses manifest-based reconciliation to only regenerate when source files change.\r\n */\r\nexport class TypeGenerator {\r\n  /**\r\n   * Output directory for generated typings\r\n   */\r\n  private outputDir = warlockPath(\"typings\");\r\n\r\n  /**\r\n   * Path to typings manifest file\r\n   */\r\n  private manifestPath = join(this.outputDir, \"typings-manifest.json\");\r\n\r\n  /**\r\n   * Cached manifest data\r\n   */\r\n  private manifest: TypingsManifest | null = null;\r\n\r\n  /**\r\n   * Cache for config type info and keys\r\n   */\r\n  private configCache = new Map<\r\n    string,\r\n    {\r\n      sourceHash: string;\r\n      typeName: string | null;\r\n      importSource: string | null;\r\n      keys: string[];\r\n    }\r\n  >();\r\n\r\n  /**\r\n   * Generate all framework type definitions\r\n   *\r\n   * Uses manifest-based reconciliation:\r\n   * - If output files don't exist: full regeneration\r\n   * - If files exist: only regenerate changed configs\r\n   */\r\n  public async generateAll(): Promise<void> {\r\n    await this.ensureOutputDir();\r\n\r\n    const storageFile = join(this.outputDir, \"storage.d.ts\");\r\n    const configFile = join(this.outputDir, \"config.d.ts\");\r\n\r\n    const [manifestExists, storageExists, configExists] = await Promise.all([\r\n      this.exists(this.manifestPath),\r\n      this.exists(storageFile),\r\n      this.exists(configFile),\r\n    ]);\r\n\r\n    if (!manifestExists || !storageExists || !configExists) {\r\n      // Full regeneration (first run or files deleted)\r\n      await this.fullGeneration();\r\n    } else {\r\n      // Load manifest for hash comparison\r\n      await this.loadManifest();\r\n      // Reconciliation: only regenerate changed files\r\n      await this.reconcile();\r\n    }\r\n\r\n    await this.saveManifest();\r\n  }\r\n\r\n  /**\r\n   * Full regeneration of all type files\r\n   */\r\n  private async fullGeneration(): Promise<void> {\r\n    // Generate storage types\r\n    const storageConfigPath = await this.findConfigFile(\"storage\");\r\n    if (storageConfigPath) {\r\n      this.generateStorageTypes(storageConfigPath);\r\n    }\r\n\r\n    // Generate config types\r\n    await this.generateConfigTypes();\r\n  }\r\n\r\n  /**\r\n   * Reconcile: only regenerate changed files\r\n   */\r\n  private async reconcile(): Promise<void> {\r\n    const files = filesOrchestrator.getFiles();\r\n    let storageChanged = false;\r\n    let configChanged = false;\r\n    let unchangedCount = 0;\r\n\r\n    // Check storage config\r\n    for (const [path, fileManager] of files) {\r\n      if (path.startsWith(\"src/config/storage\")) {\r\n        const manifestEntry = this.manifest?.storage;\r\n        if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\r\n          storageChanged = true;\r\n          await this.generateStorageTypes(path);\r\n        }\r\n        break;\r\n      }\r\n    }\r\n\r\n    // Check config files\r\n    for (const [path, fileManager] of files) {\r\n      if (!path.startsWith(\"src/config/\")) continue;\r\n      if (path.includes(\"index\")) continue;\r\n\r\n      // Extract config name (remove dir prefix and extension)\r\n      const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\r\n\r\n      const manifestEntry = this.manifest?.config[configName];\r\n\r\n      if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\r\n        // File changed or new - regenerate\r\n        configChanged = true;\r\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\r\n\r\n        this.configCache.set(configName, {\r\n          sourceHash: fileManager.hash,\r\n          typeName: info.typeName,\r\n          importSource: info.importSource,\r\n          keys: info.keys,\r\n        });\r\n      } else {\r\n        // Unchanged - load from manifest\r\n        unchangedCount++;\r\n        this.configCache.set(configName, manifestEntry);\r\n      }\r\n    }\r\n\r\n    if (configChanged) {\r\n      await this.writeConfigTypesFromCache();\r\n    } else {\r\n      devLogInfo(`Config types unchanged (${unchangedCount} configs cached)`);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Generate storage driver name types\r\n   */\r\n  public async generateStorageTypes(configPath: string): Promise<void> {\r\n    try {\r\n      const driverKeys = await this.extractStorageDriverKeys(configPath);\r\n\r\n      if (driverKeys.length === 0) {\r\n        devServeLog(\"⚠️ No storage drivers found in config\");\r\n        return;\r\n      }\r\n\r\n      // Get file hash from filesOrchestrator\r\n      const fileManager = filesOrchestrator.getFiles().get(configPath);\r\n      const sourceHash = fileManager?.hash || \"\";\r\n\r\n      // Update manifest\r\n      if (!this.manifest) {\r\n        this.manifest = this.createEmptyManifest();\r\n      }\r\n      this.manifest.storage = {\r\n        sourceHash,\r\n        drivers: driverKeys,\r\n      };\r\n\r\n      const interfaceContent = driverKeys.map((k) => `    ${this.toInterfaceKey(k)}: true;`).join(\"\\n\");\r\n\r\n      const content = `// Auto-generated by Warlock.js - DO NOT EDIT\r\n// Generated from: ${configPath}\r\n// Regenerates on dev-server start and when storage config changes\r\n\r\nimport \"@warlock.js/core\";\r\n\r\ndeclare module \"@warlock.js/core\" {\r\n  interface StorageDriverRegistry {\r\n${interfaceContent}\r\n  }\r\n}\r\n`;\r\n\r\n      const outputPath = join(this.outputDir, \"storage.d.ts\");\r\n      await writeFile(outputPath, content, \"utf-8\");\r\n\r\n      devLogSuccess(`Generated storage types: ${driverKeys.join(\", \")}`);\r\n    } catch (error) {\r\n      devServeLog(`⚠️ Failed to generate storage types: ${error}`);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Check if a file change should trigger type regeneration\r\n   */\r\n  public shouldRegenerateTypes(changedPath: string): boolean {\r\n    return changedPath.includes(\"src/config/\") || changedPath.includes(\"config/\");\r\n  }\r\n\r\n  /**\r\n   * Handle file change - uses incremental update via cache\r\n   */\r\n  public async handleFileChange(changedPath: string): Promise<void> {\r\n    if (!this.shouldRegenerateTypes(changedPath)) {\r\n      return;\r\n    }\r\n\r\n    // Regenerate storage types if storage config changed\r\n    if (changedPath.includes(\"config/storage\")) {\r\n      await this.generateStorageTypes(changedPath);\r\n      await this.saveManifest();\r\n      return;\r\n    }\r\n\r\n    // Extract config name from path\r\n    const match = changedPath.match(/config\\/([^/]+)\\.[^.]+$/);\r\n    if (!match) {\r\n      return;\r\n    }\r\n\r\n    const configName = match[1];\r\n    if (configName === \"index\") return;\r\n\r\n    devLogInfo(`Config changed: ${configName}, updating...`);\r\n\r\n    // Get file manager for hash\r\n    const fileManager = filesOrchestrator.getFiles().get(changedPath);\r\n    const sourceHash = fileManager?.hash || Date.now().toString();\r\n\r\n    // Update only the changed config in cache (use optimized combined extraction)\r\n    const configDir = join(process.cwd(), \"src/config\");\r\n    const configPath = join(configDir, `${configName}.ts`);\r\n\r\n    const info = await this.extractConfigInfo(configPath, configName);\r\n\r\n    this.configCache.set(configName, {\r\n      sourceHash,\r\n      typeName: info.typeName,\r\n      importSource: info.importSource,\r\n      keys: info.keys,\r\n    });\r\n\r\n    // Regenerate config.d.ts from cache\r\n    await this.writeConfigTypesFromCache();\r\n    await this.saveManifest();\r\n  }\r\n\r\n  /**\r\n   * Generate config types - populates cache and writes file\r\n   */\r\n  public async generateConfigTypes(): Promise<void> {\r\n    try {\r\n      const files = filesOrchestrator.getFiles();\r\n\r\n      // Clear and repopulate cache\r\n      this.configCache.clear();\r\n\r\n      for (const [path, fileManager] of files) {\r\n        if (!path.startsWith(\"src/config/\")) continue;\r\n        if (path.includes(\"index\")) continue;\r\n\r\n        // Extract config name\r\n        const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\r\n\r\n        // Use optimized combined extraction (single ts.createProgram call)\r\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\r\n\r\n        this.configCache.set(configName, {\r\n          sourceHash: fileManager.hash,\r\n          typeName: info.typeName,\r\n          importSource: info.importSource,\r\n          keys: info.keys,\r\n        });\r\n      }\r\n\r\n      await this.writeConfigTypesFromCache();\r\n    } catch (error) {\r\n      devServeLog(`⚠️ Failed to generate config types: ${error}`);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Quote an interface key that isn't a valid JS identifier (e.g. a config\r\n   * named `use-cases` or a storage driver `do-spaces`) so the generated\r\n   * `.d.ts` stays syntactically valid. Identifier-safe names are left bare\r\n   * to keep the output clean.\r\n   */\r\n  private toInterfaceKey(name: string): string {\r\n    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);\r\n  }\r\n\r\n  /**\r\n   * Write config.d.ts from cached data\r\n   */\r\n  private async writeConfigTypesFromCache(): Promise<void> {\r\n    const configTypeInfos: Array<{\r\n      name: string;\r\n      typeName: string | null;\r\n      importSource: string | null;\r\n    }> = [];\r\n    const allKeys: string[] = [];\r\n\r\n    // Update manifest config section\r\n    if (!this.manifest) {\r\n      this.manifest = this.createEmptyManifest();\r\n    }\r\n    this.manifest.config = {};\r\n\r\n    for (const [name, data] of this.configCache) {\r\n      configTypeInfos.push({\r\n        name,\r\n        typeName: data.typeName,\r\n        importSource: data.importSource,\r\n      });\r\n      allKeys.push(...data.keys);\r\n\r\n      // Store in manifest\r\n      this.manifest.config[name] = data;\r\n    }\r\n\r\n    // Group imports by source\r\n    const imports = new Map<string, Set<string>>();\r\n    for (const info of configTypeInfos) {\r\n      if (info.typeName && info.importSource) {\r\n        if (!imports.has(info.importSource)) {\r\n          imports.set(info.importSource, new Set());\r\n        }\r\n        imports.get(info.importSource)!.add(info.typeName);\r\n      }\r\n    }\r\n\r\n    const importStatements = Array.from(imports.entries())\r\n      .map(([source, types]) => `import type { ${Array.from(types).join(\", \")} } from \"${source}\";`)\r\n      .join(\"\\n\");\r\n\r\n    const configEntries = configTypeInfos\r\n      .map((info) => `    ${this.toInterfaceKey(info.name)}: ${info.typeName || \"unknown\"};`)\r\n      .join(\"\\n\");\r\n\r\n    const keyEntries = allKeys.map((key) => `    \"${key}\": true;`).join(\"\\n\");\r\n\r\n    const content = `// Auto-generated by Warlock.js - DO NOT EDIT\r\n// Regenerates on dev-server start and when config files change\r\n\r\n${importStatements}\r\nimport \"@warlock.js/core\";\r\n\r\ndeclare module \"@warlock.js/core\" {\r\n  interface ConfigRegistry {\r\n${configEntries}\r\n  }\r\n\r\n  interface ConfigKeyRegistry {\r\n${keyEntries}\r\n  }\r\n}\r\n`;\r\n\r\n    const outputPath = join(this.outputDir, \"config.d.ts\");\r\n    await writeFile(outputPath, content, \"utf-8\");\r\n\r\n    devLogSuccess(\r\n      `Generated config types: ${this.configCache.size} configs, ${allKeys.length} keys`,\r\n    );\r\n  }\r\n\r\n  // ============================================================\r\n  // Manifest Management\r\n  // ============================================================\r\n\r\n  /**\r\n   * Load manifest from disk\r\n   */\r\n  private async loadManifest(): Promise<boolean> {\r\n    try {\r\n      if (await this.exists(this.manifestPath)) {\r\n        const content = await readFile(this.manifestPath, \"utf-8\");\r\n        this.manifest = JSON.parse(content);\r\n        return true;\r\n      }\r\n    } catch {\r\n      // Manifest corrupted or missing\r\n    }\r\n    this.manifest = null;\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Save manifest to disk\r\n   */\r\n  private async saveManifest(): Promise<void> {\r\n    if (!this.manifest) {\r\n      this.manifest = this.createEmptyManifest();\r\n    }\r\n    this.manifest.lastBuildTime = Date.now();\r\n\r\n    await writeFile(this.manifestPath, JSON.stringify(this.manifest, null, 2), \"utf-8\");\r\n  }\r\n\r\n  /**\r\n   * Create empty manifest structure\r\n   */\r\n  private createEmptyManifest(): TypingsManifest {\r\n    return {\r\n      version: \"1.0.0\",\r\n      lastBuildTime: Date.now(),\r\n      storage: null,\r\n      config: {},\r\n    };\r\n  }\r\n\r\n  // ============================================================\r\n  // Type Extraction Methods\r\n  // ============================================================\r\n\r\n  /**\r\n   * Extract BOTH type info AND keys in a single pass\r\n   *\r\n   * This is optimized to create ts.createProgram() only ONCE per file\r\n   * instead of twice (once for type extraction, once for keys).\r\n   * This reduces parsing time by ~50%.\r\n   *\r\n   * @param configPath Absolute path to the config file\r\n   * @param configName Config name (e.g., \"auth\", \"notifications\")\r\n   * @returns Combined result with type info and keys\r\n   */\r\n  private async extractConfigInfo(\r\n    configPath: string,\r\n    configName: string,\r\n  ): Promise<{\r\n    typeName: string | null;\r\n    importSource: string | null;\r\n    keys: string[];\r\n  }> {\r\n    if (!(await this.exists(configPath))) {\r\n      return { typeName: null, importSource: null, keys: [] };\r\n    }\r\n\r\n    // Create program ONCE (this is the expensive operation)\r\n    const program = ts.createProgram([configPath], {\r\n      target: ts.ScriptTarget.ESNext,\r\n      module: ts.ModuleKind.ESNext,\r\n      moduleResolution: ts.ModuleResolutionKind.NodeJs,\r\n    });\r\n\r\n    const sourceFile = program.getSourceFile(configPath);\r\n    if (!sourceFile) {\r\n      return { typeName: null, importSource: null, keys: [] };\r\n    }\r\n\r\n    // === Type Info Extraction ===\r\n    const importedTypes = new Map<string, string>();\r\n    const localExportedTypes = new Set<string>();\r\n    let foundTypeName: string | null = null;\r\n\r\n    // === Keys Extraction ===\r\n    const keys: string[] = [];\r\n\r\n    const visitForTypes = (node: ts.Node): void => {\r\n      // Collect imported types\r\n      if (ts.isImportDeclaration(node)) {\r\n        const moduleSpecifier = node.moduleSpecifier;\r\n        if (ts.isStringLiteral(moduleSpecifier)) {\r\n          const source = moduleSpecifier.text;\r\n          const importClause = node.importClause;\r\n          if (importClause?.namedBindings && ts.isNamedImports(importClause.namedBindings)) {\r\n            for (const element of importClause.namedBindings.elements) {\r\n              importedTypes.set(element.name.text, source);\r\n            }\r\n          }\r\n        }\r\n      }\r\n\r\n      // Collect locally exported types\r\n      if (ts.isTypeAliasDeclaration(node)) {\r\n        const modifiers = ts.getModifiers(node);\r\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\r\n          localExportedTypes.add(node.name.text);\r\n        }\r\n      }\r\n\r\n      // Collect locally exported interfaces\r\n      if (ts.isInterfaceDeclaration(node)) {\r\n        const modifiers = ts.getModifiers(node);\r\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\r\n          localExportedTypes.add(node.name.text);\r\n        }\r\n      }\r\n\r\n      // Find type used on config variable + extract keys\r\n      if (ts.isVariableDeclaration(node)) {\r\n        // Type info\r\n        if (node.type && ts.isTypeReferenceNode(node.type)) {\r\n          foundTypeName = node.type.typeName.getText(sourceFile);\r\n        }\r\n\r\n        // Keys extraction\r\n        if (node.initializer && ts.isObjectLiteralExpression(node.initializer)) {\r\n          const visitKeys = (objNode: ts.ObjectLiteralExpression, prefix: string): void => {\r\n            for (const prop of objNode.properties) {\r\n              if (ts.isPropertyAssignment(prop) && prop.name) {\r\n                const keyName = prop.name.getText(sourceFile);\r\n                const fullKey = prefix ? `${prefix}.${keyName}` : keyName;\r\n                keys.push(fullKey);\r\n                if (ts.isObjectLiteralExpression(prop.initializer)) {\r\n                  visitKeys(prop.initializer, fullKey);\r\n                }\r\n              }\r\n            }\r\n          };\r\n          visitKeys(node.initializer, configName);\r\n        }\r\n      }\r\n\r\n      ts.forEachChild(node, visitForTypes);\r\n    };\r\n\r\n    ts.forEachChild(sourceFile, visitForTypes);\r\n\r\n    // Resolve type info\r\n    let typeName: string | null = null;\r\n    let importSource: string | null = null;\r\n\r\n    if (foundTypeName) {\r\n      if (importedTypes.has(foundTypeName)) {\r\n        typeName = foundTypeName;\r\n        importSource = importedTypes.get(foundTypeName)!;\r\n      } else if (localExportedTypes.has(foundTypeName)) {\r\n        typeName = foundTypeName;\r\n        const relativePath = Path.toRelative(configPath).replace(/\\.(ts|tsx)$/, \"\");\r\n        importSource = `../../${relativePath}`;\r\n      }\r\n    }\r\n\r\n    return { typeName, importSource, keys };\r\n  }\r\n\r\n  /**\r\n   * Extract driver keys from storage config\r\n   */\r\n  private async extractStorageDriverKeys(configPath: string): Promise<string[]> {\r\n    const absolutePath = resolve(configPath);\r\n\r\n    if (!(await this.exists(absolutePath))) {\r\n      devServeLog(`⚠️ Storage config not found: ${absolutePath}`);\r\n      return [];\r\n    }\r\n\r\n    const program = ts.createProgram([absolutePath], {\r\n      target: ts.ScriptTarget.ESNext,\r\n      module: ts.ModuleKind.ESNext,\r\n      moduleResolution: ts.ModuleResolutionKind.NodeJs,\r\n    });\r\n\r\n    const sourceFile = program.getSourceFile(absolutePath);\r\n\r\n    if (!sourceFile) {\r\n      devServeLog(`⚠️ Could not parse storage config: ${absolutePath}`);\r\n      return [];\r\n    }\r\n\r\n    const keys: string[] = [];\r\n\r\n    const visit = (node: ts.Node): void => {\r\n      if (ts.isPropertyAssignment(node)) {\r\n        const propName = node.name.getText(sourceFile);\r\n\r\n        if (propName === \"drivers\" && ts.isObjectLiteralExpression(node.initializer)) {\r\n          for (const prop of node.initializer.properties) {\r\n            if (ts.isPropertyAssignment(prop) || ts.isShorthandPropertyAssignment(prop)) {\r\n              const keyName = prop.name?.getText(sourceFile);\r\n\r\n              if (keyName) {\r\n                keys.push(keyName);\r\n              }\r\n            }\r\n          }\r\n        }\r\n      }\r\n\r\n      ts.forEachChild(node, visit);\r\n    };\r\n\r\n    ts.forEachChild(sourceFile, visit);\r\n\r\n    return keys;\r\n  }\r\n\r\n  /**\r\n   * Find a config file by name\r\n   */\r\n  private async findConfigFile(configName: string): Promise<string | undefined> {\r\n    const possiblePaths = [`src/config/${configName}.ts`, `config/${configName}.ts`];\r\n\r\n    for (const path of possiblePaths) {\r\n      const fullPath = join(process.cwd(), path);\r\n\r\n      if (await this.exists(fullPath)) {\r\n        return path;\r\n      }\r\n    }\r\n\r\n    try {\r\n      const files = filesOrchestrator.getFiles();\r\n\r\n      for (const [filePath] of files) {\r\n        if (filePath.includes(`config/${configName}`)) {\r\n          return filePath;\r\n        }\r\n      }\r\n    } catch {\r\n      // Files orchestrator not initialized yet\r\n    }\r\n\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Ensure output directory exists\r\n   */\r\n  private async ensureOutputDir(): Promise<void> {\r\n    await ensureDirectoryAsync(this.outputDir);\r\n  }\r\n\r\n  /**\r\n   * Check if a path exists (async wrapper)\r\n   */\r\n  private async exists(path: string): Promise<boolean> {\r\n    try {\r\n      await access(path, constants.F_OK);\r\n      return true;\r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Execute generateAll command using spawn\r\n   */\r\n  public async executeGenerateAllCommand(): Promise<void> {\r\n    devLogInfo(\"Checking for types generation\");\r\n    const isDevServeCore = env(\"DEV_SERVER_CORE\");\r\n    const childProcess = spawn(\r\n      isDevServeCore ? \"yarn\" : \"npx\",\r\n      [isDevServeCore ? \"cli\" : \"warlock\", \"generate.typings\"],\r\n      {\r\n        // const childProcess = spawn(\"yarn\", [\"cli\", \"generate.typings\"], {\r\n        stdio: \"inherit\",\r\n        cwd: process.cwd(),\r\n        shell: true, // Required on Windows to find yarn in PATH\r\n      },\r\n    );\r\n\r\n    childProcess.on(\"exit\", (code) => {\r\n      if (code === 0) {\r\n        devLogSuccess(\"Types generated successfully\");\r\n      } else {\r\n        devLogError(\"Failed to generate types\");\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Execute a typings generator for the given files\r\n   */\r\n  public async executeTypingsGenerator(upcomingFiles: string[]): Promise<void> {\r\n    const uniqueFiles = Array.from(new Set(upcomingFiles));\r\n\r\n    const configFilesOnly = uniqueFiles.filter((file) =>\r\n      Path.normalize(file).includes(\"src/config/\"),\r\n    );\r\n\r\n    if (configFilesOnly.length === 0) return;\r\n\r\n    const files = configFilesOnly.map((file) => \"./\" + Path.toRelative(file));\r\n\r\n    const isDevServeCore = env(\"DEV_SERVER_CORE\");\r\n\r\n    const childProcess = spawn(\r\n      isDevServeCore ? \"yarn\" : \"npx\",\r\n      [isDevServeCore ? \"cli\" : \"warlock\", \"generate.typings\"],\r\n      {\r\n        stdio: \"inherit\",\r\n        cwd: process.cwd(),\r\n        shell: true, // Required on Windows to find yarn in PATH\r\n      },\r\n    );\r\n\r\n    childProcess.on(\"exit\", (code) => {\r\n      if (code === 0) {\r\n        devLogSuccess(\"Types generated successfully\");\r\n      } else {\r\n        devLogError(\"Failed to generate types\");\r\n      }\r\n    });\r\n  }\r\n}\r\n\r\n/**\r\n * Singleton instance for use throughout dev-server\r\n */\r\nexport const typeGenerator = new TypeGenerator();\r\n"],"mappings":"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"}
+{"version":3,"file":"type-generator.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/type-generator.ts"],"sourcesContent":["import { env } from \"@mongez/dotenv\";\r\nimport { ensureDirectoryAsync } from \"@warlock.js/fs\";\r\nimport { spawn } from \"child_process\";\r\nimport { constants } from \"fs\";\r\nimport { access, readFile, writeFile } from \"fs/promises\";\r\nimport { join, resolve } from \"path\";\r\nimport ts from \"typescript\";\r\nimport { warlockPath } from \"../utils\";\r\nimport { devLogError, devLogInfo, devLogSuccess, devServeLog } from \"./dev-logger\";\r\nimport { filesOrchestrator } from \"./files-orchestrator\";\r\nimport { Path } from \"./path\";\r\n\r\n/**\r\n * Typings manifest structure for tracking file hashes\r\n */\r\ntype TypingsManifest = {\r\n  version: string;\r\n  lastBuildTime: number;\r\n  storage: {\r\n    sourceHash: string;\r\n    drivers: string[];\r\n  } | null;\r\n  config: Record<\r\n    string,\r\n    {\r\n      sourceHash: string;\r\n      typeName: string | null;\r\n      importSource: string | null;\r\n      keys: string[];\r\n    }\r\n  >;\r\n};\r\n\r\n/**\r\n * TypeGenerator - Generates TypeScript type definitions from config files\r\n *\r\n * Parses source config files using the TypeScript Compiler API to extract\r\n * keys and generate module augmentation types for IDE autocomplete.\r\n *\r\n * Uses manifest-based reconciliation to only regenerate when source files change.\r\n */\r\nexport class TypeGenerator {\r\n  /**\r\n   * Output directory for generated typings\r\n   */\r\n  private outputDir = warlockPath(\"typings\");\r\n\r\n  /**\r\n   * Path to typings manifest file\r\n   */\r\n  private manifestPath = join(this.outputDir, \"typings-manifest.json\");\r\n\r\n  /**\r\n   * Cached manifest data\r\n   */\r\n  private manifest: TypingsManifest | null = null;\r\n\r\n  /**\r\n   * Cache for config type info and keys\r\n   */\r\n  private configCache = new Map<\r\n    string,\r\n    {\r\n      sourceHash: string;\r\n      typeName: string | null;\r\n      importSource: string | null;\r\n      keys: string[];\r\n    }\r\n  >();\r\n\r\n  /**\r\n   * Generate all framework type definitions\r\n   *\r\n   * Uses manifest-based reconciliation:\r\n   * - If output files don't exist: full regeneration\r\n   * - If files exist: only regenerate changed configs\r\n   */\r\n  public async generateAll(): Promise<void> {\r\n    await this.ensureOutputDir();\r\n\r\n    const storageFile = join(this.outputDir, \"storage.d.ts\");\r\n    const configFile = join(this.outputDir, \"config.d.ts\");\r\n\r\n    const [manifestExists, storageExists, configExists] = await Promise.all([\r\n      this.exists(this.manifestPath),\r\n      this.exists(storageFile),\r\n      this.exists(configFile),\r\n    ]);\r\n\r\n    if (!manifestExists || !storageExists || !configExists) {\r\n      // Full regeneration (first run or files deleted)\r\n      await this.fullGeneration();\r\n    } else {\r\n      // Load manifest for hash comparison\r\n      await this.loadManifest();\r\n      // Reconciliation: only regenerate changed files\r\n      await this.reconcile();\r\n    }\r\n\r\n    await this.saveManifest();\r\n  }\r\n\r\n  /**\r\n   * Full regeneration of all type files\r\n   */\r\n  private async fullGeneration(): Promise<void> {\r\n    // Generate storage types\r\n    const storageConfigPath = await this.findConfigFile(\"storage\");\r\n    if (storageConfigPath) {\r\n      this.generateStorageTypes(storageConfigPath);\r\n    }\r\n\r\n    // Generate config types\r\n    await this.generateConfigTypes();\r\n  }\r\n\r\n  /**\r\n   * Reconcile: only regenerate changed files\r\n   */\r\n  private async reconcile(): Promise<void> {\r\n    const files = filesOrchestrator.getFiles();\r\n    let storageChanged = false;\r\n    let configChanged = false;\r\n    let unchangedCount = 0;\r\n\r\n    // Check storage config\r\n    for (const [path, fileManager] of files) {\r\n      if (path.startsWith(\"src/config/storage\")) {\r\n        const manifestEntry = this.manifest?.storage;\r\n        if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\r\n          storageChanged = true;\r\n          await this.generateStorageTypes(path);\r\n        }\r\n        break;\r\n      }\r\n    }\r\n\r\n    // Check config files\r\n    for (const [path, fileManager] of files) {\r\n      if (!path.startsWith(\"src/config/\")) continue;\r\n      if (path.includes(\"index\")) continue;\r\n\r\n      // Extract config name (remove dir prefix and extension)\r\n      const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\r\n\r\n      const manifestEntry = this.manifest?.config[configName];\r\n\r\n      if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\r\n        // File changed or new - regenerate\r\n        configChanged = true;\r\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\r\n\r\n        this.configCache.set(configName, {\r\n          sourceHash: fileManager.hash,\r\n          typeName: info.typeName,\r\n          importSource: info.importSource,\r\n          keys: info.keys,\r\n        });\r\n      } else {\r\n        // Unchanged - load from manifest\r\n        unchangedCount++;\r\n        this.configCache.set(configName, manifestEntry);\r\n      }\r\n    }\r\n\r\n    if (configChanged) {\r\n      await this.writeConfigTypesFromCache();\r\n    } else {\r\n      devLogInfo(`Config types unchanged (${unchangedCount} configs cached)`);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Generate storage driver name types\r\n   */\r\n  public async generateStorageTypes(configPath: string): Promise<void> {\r\n    try {\r\n      const driverKeys = await this.extractStorageDriverKeys(configPath);\r\n\r\n      if (driverKeys.length === 0) {\r\n        devServeLog(\"⚠️ No storage drivers found in config\");\r\n        return;\r\n      }\r\n\r\n      // Get file hash from filesOrchestrator\r\n      const fileManager = filesOrchestrator.getFiles().get(configPath);\r\n      const sourceHash = fileManager?.hash || \"\";\r\n\r\n      // Update manifest\r\n      if (!this.manifest) {\r\n        this.manifest = this.createEmptyManifest();\r\n      }\r\n      this.manifest.storage = {\r\n        sourceHash,\r\n        drivers: driverKeys,\r\n      };\r\n\r\n      const interfaceContent = driverKeys.map((k) => `    ${this.toInterfaceKey(k)}: true;`).join(\"\\n\");\r\n\r\n      const content = `// Auto-generated by Warlock.js - DO NOT EDIT\r\n// Generated from: ${configPath}\r\n// Regenerates on dev-server start and when storage config changes\r\n\r\nimport \"@warlock.js/core\";\r\n\r\ndeclare module \"@warlock.js/core\" {\r\n  interface StorageDriverRegistry {\r\n${interfaceContent}\r\n  }\r\n}\r\n`;\r\n\r\n      const outputPath = join(this.outputDir, \"storage.d.ts\");\r\n      await writeFile(outputPath, content, \"utf-8\");\r\n\r\n      devLogSuccess(`Generated storage types: ${driverKeys.join(\", \")}`);\r\n    } catch (error) {\r\n      devServeLog(`⚠️ Failed to generate storage types: ${error}`);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Check if a file change should trigger type regeneration\r\n   */\r\n  public shouldRegenerateTypes(changedPath: string): boolean {\r\n    return changedPath.includes(\"src/config/\") || changedPath.includes(\"config/\");\r\n  }\r\n\r\n  /**\r\n   * Handle file change - uses incremental update via cache\r\n   */\r\n  public async handleFileChange(changedPath: string): Promise<void> {\r\n    if (!this.shouldRegenerateTypes(changedPath)) {\r\n      return;\r\n    }\r\n\r\n    // Regenerate storage types if storage config changed\r\n    if (changedPath.includes(\"config/storage\")) {\r\n      await this.generateStorageTypes(changedPath);\r\n      await this.saveManifest();\r\n      return;\r\n    }\r\n\r\n    // Extract config name from path\r\n    const match = changedPath.match(/config\\/([^/]+)\\.[^.]+$/);\r\n    if (!match) {\r\n      return;\r\n    }\r\n\r\n    const configName = match[1];\r\n    if (configName === \"index\") return;\r\n\r\n    devLogInfo(`Config changed: ${configName}, updating...`);\r\n\r\n    // Get file manager for hash\r\n    const fileManager = filesOrchestrator.getFiles().get(changedPath);\r\n    const sourceHash = fileManager?.hash || Date.now().toString();\r\n\r\n    // Update only the changed config in cache (use optimized combined extraction)\r\n    const configDir = join(process.cwd(), \"src/config\");\r\n    const configPath = join(configDir, `${configName}.ts`);\r\n\r\n    const info = await this.extractConfigInfo(configPath, configName);\r\n\r\n    this.configCache.set(configName, {\r\n      sourceHash,\r\n      typeName: info.typeName,\r\n      importSource: info.importSource,\r\n      keys: info.keys,\r\n    });\r\n\r\n    // Regenerate config.d.ts from cache\r\n    await this.writeConfigTypesFromCache();\r\n    await this.saveManifest();\r\n  }\r\n\r\n  /**\r\n   * Generate config types - populates cache and writes file\r\n   */\r\n  public async generateConfigTypes(): Promise<void> {\r\n    try {\r\n      const files = filesOrchestrator.getFiles();\r\n\r\n      // Clear and repopulate cache\r\n      this.configCache.clear();\r\n\r\n      for (const [path, fileManager] of files) {\r\n        if (!path.startsWith(\"src/config/\")) continue;\r\n        if (path.includes(\"index\")) continue;\r\n\r\n        // Extract config name\r\n        const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\r\n\r\n        // Use optimized combined extraction (single ts.createProgram call)\r\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\r\n\r\n        this.configCache.set(configName, {\r\n          sourceHash: fileManager.hash,\r\n          typeName: info.typeName,\r\n          importSource: info.importSource,\r\n          keys: info.keys,\r\n        });\r\n      }\r\n\r\n      await this.writeConfigTypesFromCache();\r\n    } catch (error) {\r\n      devServeLog(`⚠️ Failed to generate config types: ${error}`);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Quote an interface key that isn't a valid JS identifier (e.g. a config\r\n   * named `use-cases` or a storage driver `do-spaces`) so the generated\r\n   * `.d.ts` stays syntactically valid. Identifier-safe names are left bare\r\n   * to keep the output clean.\r\n   */\r\n  private toInterfaceKey(name: string): string {\r\n    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);\r\n  }\r\n\r\n  /**\r\n   * Write config.d.ts from cached data\r\n   */\r\n  private async writeConfigTypesFromCache(): Promise<void> {\r\n    const configTypeInfos: Array<{\r\n      name: string;\r\n      typeName: string | null;\r\n      importSource: string | null;\r\n    }> = [];\r\n    const allKeys: string[] = [];\r\n\r\n    // Update manifest config section\r\n    if (!this.manifest) {\r\n      this.manifest = this.createEmptyManifest();\r\n    }\r\n    this.manifest.config = {};\r\n\r\n    for (const [name, data] of this.configCache) {\r\n      configTypeInfos.push({\r\n        name,\r\n        typeName: data.typeName,\r\n        importSource: data.importSource,\r\n      });\r\n      allKeys.push(...data.keys);\r\n\r\n      // Store in manifest\r\n      this.manifest.config[name] = data;\r\n    }\r\n\r\n    // Group imports by source\r\n    const imports = new Map<string, Set<string>>();\r\n    for (const info of configTypeInfos) {\r\n      if (info.typeName && info.importSource) {\r\n        if (!imports.has(info.importSource)) {\r\n          imports.set(info.importSource, new Set());\r\n        }\r\n        imports.get(info.importSource)!.add(info.typeName);\r\n      }\r\n    }\r\n\r\n    const importStatements = Array.from(imports.entries())\r\n      .map(([source, types]) => `import type { ${Array.from(types).join(\", \")} } from \"${source}\";`)\r\n      .join(\"\\n\");\r\n\r\n    const configEntries = configTypeInfos\r\n      .map((info) => `    ${this.toInterfaceKey(info.name)}: ${info.typeName || \"unknown\"};`)\r\n      .join(\"\\n\");\r\n\r\n    const keyEntries = allKeys.map((key) => `    \"${key}\": true;`).join(\"\\n\");\r\n\r\n    const content = `// Auto-generated by Warlock.js - DO NOT EDIT\r\n// Regenerates on dev-server start and when config files change\r\n\r\n${importStatements}\r\nimport \"@warlock.js/core\";\r\n\r\ndeclare module \"@warlock.js/core\" {\r\n  interface ConfigRegistry {\r\n${configEntries}\r\n  }\r\n\r\n  interface ConfigKeyRegistry {\r\n${keyEntries}\r\n  }\r\n}\r\n`;\r\n\r\n    const outputPath = join(this.outputDir, \"config.d.ts\");\r\n    await writeFile(outputPath, content, \"utf-8\");\r\n\r\n    devLogSuccess(\r\n      `Generated config types: ${this.configCache.size} configs, ${allKeys.length} keys`,\r\n    );\r\n  }\r\n\r\n  // ============================================================\r\n  // Manifest Management\r\n  // ============================================================\r\n\r\n  /**\r\n   * Load manifest from disk\r\n   */\r\n  private async loadManifest(): Promise<boolean> {\r\n    try {\r\n      if (await this.exists(this.manifestPath)) {\r\n        const content = await readFile(this.manifestPath, \"utf-8\");\r\n        this.manifest = JSON.parse(content);\r\n        return true;\r\n      }\r\n    } catch {\r\n      // Manifest corrupted or missing\r\n    }\r\n    this.manifest = null;\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Save manifest to disk\r\n   */\r\n  private async saveManifest(): Promise<void> {\r\n    if (!this.manifest) {\r\n      this.manifest = this.createEmptyManifest();\r\n    }\r\n    this.manifest.lastBuildTime = Date.now();\r\n\r\n    await writeFile(this.manifestPath, JSON.stringify(this.manifest, null, 2), \"utf-8\");\r\n  }\r\n\r\n  /**\r\n   * Create empty manifest structure\r\n   */\r\n  private createEmptyManifest(): TypingsManifest {\r\n    return {\r\n      version: \"1.0.0\",\r\n      lastBuildTime: Date.now(),\r\n      storage: null,\r\n      config: {},\r\n    };\r\n  }\r\n\r\n  // ============================================================\r\n  // Type Extraction Methods\r\n  // ============================================================\r\n\r\n  /**\r\n   * Extract BOTH type info AND keys in a single pass\r\n   *\r\n   * This is optimized to create ts.createProgram() only ONCE per file\r\n   * instead of twice (once for type extraction, once for keys).\r\n   * This reduces parsing time by ~50%.\r\n   *\r\n   * @param configPath Absolute path to the config file\r\n   * @param configName Config name (e.g., \"auth\", \"notifications\")\r\n   * @returns Combined result with type info and keys\r\n   */\r\n  private async extractConfigInfo(\r\n    configPath: string,\r\n    configName: string,\r\n  ): Promise<{\r\n    typeName: string | null;\r\n    importSource: string | null;\r\n    keys: string[];\r\n  }> {\r\n    if (!(await this.exists(configPath))) {\r\n      return { typeName: null, importSource: null, keys: [] };\r\n    }\r\n\r\n    // Create program ONCE (this is the expensive operation)\r\n    const program = ts.createProgram([configPath], {\r\n      target: ts.ScriptTarget.ESNext,\r\n      module: ts.ModuleKind.ESNext,\r\n      moduleResolution: ts.ModuleResolutionKind.NodeJs,\r\n    });\r\n\r\n    const sourceFile = program.getSourceFile(configPath);\r\n    if (!sourceFile) {\r\n      return { typeName: null, importSource: null, keys: [] };\r\n    }\r\n\r\n    // === Type Info Extraction ===\r\n    const importedTypes = new Map<string, string>();\r\n    const localExportedTypes = new Set<string>();\r\n    let foundTypeName: string | null = null;\r\n\r\n    // === Keys Extraction ===\r\n    const keys: string[] = [];\r\n\r\n    const visitForTypes = (node: ts.Node): void => {\r\n      // Collect imported types\r\n      if (ts.isImportDeclaration(node)) {\r\n        const moduleSpecifier = node.moduleSpecifier;\r\n        if (ts.isStringLiteral(moduleSpecifier)) {\r\n          const source = moduleSpecifier.text;\r\n          const importClause = node.importClause;\r\n          if (importClause?.namedBindings && ts.isNamedImports(importClause.namedBindings)) {\r\n            for (const element of importClause.namedBindings.elements) {\r\n              importedTypes.set(element.name.text, source);\r\n            }\r\n          }\r\n        }\r\n      }\r\n\r\n      // Collect locally exported types\r\n      if (ts.isTypeAliasDeclaration(node)) {\r\n        const modifiers = ts.getModifiers(node);\r\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\r\n          localExportedTypes.add(node.name.text);\r\n        }\r\n      }\r\n\r\n      // Collect locally exported interfaces\r\n      if (ts.isInterfaceDeclaration(node)) {\r\n        const modifiers = ts.getModifiers(node);\r\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\r\n          localExportedTypes.add(node.name.text);\r\n        }\r\n      }\r\n\r\n      // Find type used on config variable + extract keys\r\n      if (ts.isVariableDeclaration(node)) {\r\n        // Type info\r\n        if (node.type && ts.isTypeReferenceNode(node.type)) {\r\n          foundTypeName = node.type.typeName.getText(sourceFile);\r\n        }\r\n\r\n        // Keys extraction\r\n        if (node.initializer && ts.isObjectLiteralExpression(node.initializer)) {\r\n          const visitKeys = (objNode: ts.ObjectLiteralExpression, prefix: string): void => {\r\n            for (const prop of objNode.properties) {\r\n              if (ts.isPropertyAssignment(prop) && prop.name) {\r\n                const keyName = prop.name.getText(sourceFile);\r\n                const fullKey = prefix ? `${prefix}.${keyName}` : keyName;\r\n                keys.push(fullKey);\r\n                if (ts.isObjectLiteralExpression(prop.initializer)) {\r\n                  visitKeys(prop.initializer, fullKey);\r\n                }\r\n              }\r\n            }\r\n          };\r\n          visitKeys(node.initializer, configName);\r\n        }\r\n      }\r\n\r\n      ts.forEachChild(node, visitForTypes);\r\n    };\r\n\r\n    ts.forEachChild(sourceFile, visitForTypes);\r\n\r\n    // Resolve type info\r\n    let typeName: string | null = null;\r\n    let importSource: string | null = null;\r\n\r\n    if (foundTypeName) {\r\n      if (importedTypes.has(foundTypeName)) {\r\n        typeName = foundTypeName;\r\n        importSource = importedTypes.get(foundTypeName)!;\r\n      } else if (localExportedTypes.has(foundTypeName)) {\r\n        typeName = foundTypeName;\r\n        const relativePath = Path.toRelative(configPath).replace(/\\.(ts|tsx)$/, \"\");\r\n        importSource = `../../${relativePath}`;\r\n      }\r\n    }\r\n\r\n    return { typeName, importSource, keys };\r\n  }\r\n\r\n  /**\r\n   * Extract driver keys from storage config\r\n   */\r\n  private async extractStorageDriverKeys(configPath: string): Promise<string[]> {\r\n    const absolutePath = resolve(configPath);\r\n\r\n    if (!(await this.exists(absolutePath))) {\r\n      devServeLog(`⚠️ Storage config not found: ${absolutePath}`);\r\n      return [];\r\n    }\r\n\r\n    const program = ts.createProgram([absolutePath], {\r\n      target: ts.ScriptTarget.ESNext,\r\n      module: ts.ModuleKind.ESNext,\r\n      moduleResolution: ts.ModuleResolutionKind.NodeJs,\r\n    });\r\n\r\n    const sourceFile = program.getSourceFile(absolutePath);\r\n\r\n    if (!sourceFile) {\r\n      devServeLog(`⚠️ Could not parse storage config: ${absolutePath}`);\r\n      return [];\r\n    }\r\n\r\n    const keys: string[] = [];\r\n\r\n    const visit = (node: ts.Node): void => {\r\n      if (ts.isPropertyAssignment(node)) {\r\n        const propName = node.name.getText(sourceFile);\r\n\r\n        if (propName === \"drivers\" && ts.isObjectLiteralExpression(node.initializer)) {\r\n          for (const prop of node.initializer.properties) {\r\n            if (ts.isPropertyAssignment(prop) || ts.isShorthandPropertyAssignment(prop)) {\r\n              const keyName = prop.name?.getText(sourceFile);\r\n\r\n              if (keyName) {\r\n                keys.push(keyName);\r\n              }\r\n            }\r\n          }\r\n        }\r\n      }\r\n\r\n      ts.forEachChild(node, visit);\r\n    };\r\n\r\n    ts.forEachChild(sourceFile, visit);\r\n\r\n    return keys;\r\n  }\r\n\r\n  /**\r\n   * Find a config file by name\r\n   */\r\n  private async findConfigFile(configName: string): Promise<string | undefined> {\r\n    const possiblePaths = [`src/config/${configName}.ts`, `config/${configName}.ts`];\r\n\r\n    for (const path of possiblePaths) {\r\n      const fullPath = join(process.cwd(), path);\r\n\r\n      if (await this.exists(fullPath)) {\r\n        return path;\r\n      }\r\n    }\r\n\r\n    try {\r\n      const files = filesOrchestrator.getFiles();\r\n\r\n      for (const [filePath] of files) {\r\n        if (filePath.includes(`config/${configName}`)) {\r\n          return filePath;\r\n        }\r\n      }\r\n    } catch {\r\n      // Files orchestrator not initialized yet\r\n    }\r\n\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Ensure output directory exists\r\n   */\r\n  private async ensureOutputDir(): Promise<void> {\r\n    await ensureDirectoryAsync(this.outputDir);\r\n  }\r\n\r\n  /**\r\n   * Check if a path exists (async wrapper)\r\n   */\r\n  private async exists(path: string): Promise<boolean> {\r\n    try {\r\n      await access(path, constants.F_OK);\r\n      return true;\r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Execute generateAll command using spawn\r\n   */\r\n  public async executeGenerateAllCommand(): Promise<void> {\r\n    devLogInfo(\"Checking for types generation\");\r\n    const isDevServeCore = env(\"DEV_SERVER_CORE\");\r\n    const childProcess = spawn(\r\n      isDevServeCore ? \"yarn\" : \"npx\",\r\n      [isDevServeCore ? \"cli\" : \"warlock\", \"generate.typings\"],\r\n      {\r\n        // const childProcess = spawn(\"yarn\", [\"cli\", \"generate.typings\"], {\r\n        stdio: \"inherit\",\r\n        cwd: process.cwd(),\r\n        shell: true, // Required on Windows to find yarn in PATH\r\n      },\r\n    );\r\n\r\n    childProcess.on(\"exit\", (code) => {\r\n      if (code === 0) {\r\n        devLogSuccess(\"Types generated successfully\");\r\n      } else {\r\n        devLogError(\"Failed to generate types\");\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Execute a typings generator for the given files\r\n   */\r\n  public async executeTypingsGenerator(upcomingFiles: string[]): Promise<void> {\r\n    const uniqueFiles = Array.from(new Set(upcomingFiles));\r\n\r\n    const configFilesOnly = uniqueFiles.filter((file) =>\r\n      Path.normalize(file).includes(\"src/config/\"),\r\n    );\r\n\r\n    if (configFilesOnly.length === 0) return;\r\n\r\n    const files = configFilesOnly.map((file) => \"./\" + Path.toRelative(file));\r\n\r\n    const isDevServeCore = env(\"DEV_SERVER_CORE\");\r\n\r\n    const childProcess = spawn(\r\n      isDevServeCore ? \"yarn\" : \"npx\",\r\n      [isDevServeCore ? \"cli\" : \"warlock\", \"generate.typings\"],\r\n      {\r\n        stdio: \"inherit\",\r\n        cwd: process.cwd(),\r\n        shell: true, // Required on Windows to find yarn in PATH\r\n      },\r\n    );\r\n\r\n    childProcess.on(\"exit\", (code) => {\r\n      if (code === 0) {\r\n        devLogSuccess(\"Types generated successfully\");\r\n      } else {\r\n        devLogError(\"Failed to generate types\");\r\n      }\r\n    });\r\n  }\r\n}\r\n\r\n/**\r\n * Singleton instance for use throughout dev-server\r\n */\r\nexport const typeGenerator = new TypeGenerator();\r\n"],"mappings":"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"}

package/esm/dev-server/types.d.mts

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/core/src/dev-server/types.d.ts
+//#region ../core/src/dev-server/types.d.ts
 type FileType = "main" | "config" | "event" | "route" | "controller" | "service" | "model" | "other";
 type FileManifest = {
   absolutePath: string;

package/esm/dev-server/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/dev-server/types.ts"],"mappings":";KAAY,QAAA;AAAA,KAUA,YAAA;EACV,YAAA;EACA,YAAA;EACA,YAAA;EACA,IAAA;EACA,YAAA;EALsB;;;;;;;EAatB,oBAAA;EACA,UAAA;EACA,IAAA,EAAM,QAAQ;AAAA;;;AAAA;AAWhB;;;;AAAqB;KAAT,SAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/dev-server/types.ts"],"mappings":";KAAY,QAAA;AAAA,KAUA,YAAA;EACV,YAAA;EACA,YAAA;EACA,YAAA;EACA,IAAA;EACA,YAAA;EALsB;;;;;;;EAatB,oBAAA;EACA,UAAA;EACA,IAAA,EAAM,QAAQ;AAAA;;;AAAA;AAWhB;;;;AAAqB;KAAT,SAAA"}

package/esm/dev-server/update-check-cache.mjs

@@ -0,0 +1,53 @@
+import { warlockPath } from "../utils/paths.mjs";
+import { ensureDirectoryAsync, fileExistsAsync, getJsonFileAsync, putJsonFileAsync, unlinkAsync } from "@warlock.js/fs";
+
+//#region ../core/src/dev-server/update-check-cache.ts
+/** Where the last registry answer is remembered, inside the project's `.warlock/`. */
+const CACHE_PATH = warlockPath("update-check.json");
+/**
+* How long a registry answer stays good. A day matches npm's own
+* update-notifier: long enough that a normal day of `warlock dev` restarts
+* costs one lookup, short enough that a release never goes unnoticed for long.
+*/
+const CACHE_TTL_MS = 1440 * 60 * 1e3;
+/**
+* The remembered latest version, or `undefined` when there is nothing usable —
+* no cache, a stale one, or a corrupt one. Callers treat `undefined` as
+* "ask npm".
+*/
+async function readCachedLatestVersion(now = Date.now()) {
+	try {
+		if (!await fileExistsAsync(CACHE_PATH)) return;
+		const cache = await getJsonFileAsync(CACHE_PATH);
+		if (typeof cache?.checkedAt !== "number" || typeof cache?.latest !== "string") return;
+		const age = now - cache.checkedAt;
+		if (age < 0 || age > 864e5) return;
+		return cache.latest;
+	} catch {
+		return;
+	}
+}
+/** Remember a successful registry answer. Failures are silent by design. */
+async function writeCachedLatestVersion(latest, now = Date.now()) {
+	try {
+		await ensureDirectoryAsync(warlockPath());
+		await putJsonFileAsync(CACHE_PATH, {
+			checkedAt: now,
+			latest
+		});
+	} catch {}
+}
+/**
+* Forget the cached answer — called once an update has actually been applied,
+* so the next boot re-checks against the version we just installed instead of
+* reasoning from an answer that predates it.
+*/
+async function clearCachedLatestVersion() {
+	try {
+		if (await fileExistsAsync(CACHE_PATH)) await unlinkAsync(CACHE_PATH);
+	} catch {}
+}
+
+//#endregion
+export { clearCachedLatestVersion, readCachedLatestVersion, writeCachedLatestVersion };
+//# sourceMappingURL=update-check-cache.mjs.map

package/esm/dev-server/update-check-cache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check-cache.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/update-check-cache.ts"],"sourcesContent":["import {\n  ensureDirectoryAsync,\n  fileExistsAsync,\n  getJsonFileAsync,\n  putJsonFileAsync,\n  unlinkAsync,\n} from \"@warlock.js/fs\";\nimport { warlockPath } from \"../utils/paths\";\n\n/** Where the last registry answer is remembered, inside the project's `.warlock/`. */\nconst CACHE_PATH = warlockPath(\"update-check.json\");\n\n/**\n * How long a registry answer stays good. A day matches npm's own\n * update-notifier: long enough that a normal day of `warlock dev` restarts\n * costs one lookup, short enough that a release never goes unnoticed for long.\n */\nexport const CACHE_TTL_MS = 24 * 60 * 60 * 1000;\n\n/** What we remember between runs. Only successful lookups are ever stored. */\ntype UpdateCheckCache = {\n  /** Epoch millis of the lookup. */\n  checkedAt: number;\n  /** The version the registry reported. */\n  latest: string;\n};\n\n/**\n * The remembered latest version, or `undefined` when there is nothing usable —\n * no cache, a stale one, or a corrupt one. Callers treat `undefined` as\n * \"ask npm\".\n */\nexport async function readCachedLatestVersion(\n  now: number = Date.now(),\n): Promise<string | undefined> {\n  try {\n    if (!(await fileExistsAsync(CACHE_PATH))) {\n      return undefined;\n    }\n\n    const cache = (await getJsonFileAsync(CACHE_PATH)) as Partial<UpdateCheckCache>;\n\n    if (typeof cache?.checkedAt !== \"number\" || typeof cache?.latest !== \"string\") {\n      return undefined;\n    }\n\n    // A clock that moved backwards (timezone change, VM resume, a hand-edited\n    // file) would otherwise pin the cache as \"fresh\" indefinitely.\n    const age = now - cache.checkedAt;\n\n    if (age < 0 || age > CACHE_TTL_MS) {\n      return undefined;\n    }\n\n    return cache.latest;\n  } catch {\n    // The cache is an optimisation — an unreadable one just means \"ask npm\".\n    return undefined;\n  }\n}\n\n/** Remember a successful registry answer. Failures are silent by design. */\nexport async function writeCachedLatestVersion(\n  latest: string,\n  now: number = Date.now(),\n): Promise<void> {\n  try {\n    await ensureDirectoryAsync(warlockPath());\n    await putJsonFileAsync(CACHE_PATH, { checkedAt: now, latest } satisfies UpdateCheckCache);\n  } catch {\n    // Not being able to remember is not a reason to fail the check.\n  }\n}\n\n/**\n * Forget the cached answer — called once an update has actually been applied,\n * so the next boot re-checks against the version we just installed instead of\n * reasoning from an answer that predates it.\n */\nexport async function clearCachedLatestVersion(): Promise<void> {\n  try {\n    if (await fileExistsAsync(CACHE_PATH)) {\n      await unlinkAsync(CACHE_PATH);\n    }\n  } catch {\n    // Worst case the next boot reads a stale-but-harmless entry.\n  }\n}\n"],"mappings":";;;;;AAUA,MAAM,aAAa,YAAY,mBAAmB;;;;;;AAOlD,MAAa,eAAe,OAAU,KAAK;;;;;;AAe3C,eAAsB,wBACpB,MAAc,KAAK,IAAI,GACM;CAC7B,IAAI;EACF,IAAI,CAAE,MAAM,gBAAgB,UAAU,GACpC;EAGF,MAAM,QAAS,MAAM,iBAAiB,UAAU;EAEhD,IAAI,OAAO,OAAO,cAAc,YAAY,OAAO,OAAO,WAAW,UACnE;EAKF,MAAM,MAAM,MAAM,MAAM;EAExB,IAAI,MAAM,KAAK,aACb;EAGF,OAAO,MAAM;CACf,QAAQ;EAEN;CACF;AACF;;AAGA,eAAsB,yBACpB,QACA,MAAc,KAAK,IAAI,GACR;CACf,IAAI;EACF,MAAM,qBAAqB,YAAY,CAAC;EACxC,MAAM,iBAAiB,YAAY;GAAE,WAAW;GAAK;EAAO,CAA4B;CAC1F,QAAQ,CAER;AACF;;;;;;AAOA,eAAsB,2BAA0C;CAC9D,IAAI;EACF,IAAI,MAAM,gBAAgB,UAAU,GAClC,MAAM,YAAY,UAAU;CAEhC,QAAQ,CAER;AACF"}

package/esm/dev-server/utils.mjs

@@ -4,7 +4,7 @@ import { Path } from "./path.mjs";
 import { ensureDirectoryAsync } from "@warlock.js/fs";
 import glob from "fast-glob";
 
-//#region ../@warlock.js/core/src/dev-server/utils.ts
+//#region ../core/src/dev-server/utils.ts
 /**
 * Ensure the .warlock/ directory exists. Used by the loader-hook
 * registration which writes its bundled hook file into this directory.

package/esm/dev-server/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/dev-server/utils.ts"],"sourcesContent":["import { ensureDirectoryAsync } from \"@warlock.js/fs\";\r\nimport glob from \"fast-glob\";\r\nimport { srcPath, warlockPath } from \"../utils\";\r\nimport { Path } from \"./path\";\r\n\r\n/**\r\n * Ensure the .warlock/ directory exists. Used by the loader-hook\r\n * registration which writes its bundled hook file into this directory.\r\n */\r\nexport async function ensureWarlockDirectory() {\r\n  await ensureDirectoryAsync(warlockPath());\r\n}\r\n\r\n/**\r\n * Glob the project's `src/` directory for `.ts`/`.tsx` files. Returns\r\n * normalised absolute paths.\r\n */\r\nexport async function getFilesFromDirectory(directoryPath = srcPath(), pattern = \"**/*.{ts,tsx}\") {\r\n  const files = await glob(`${Path.normalize(directoryPath)}/${pattern}`, { absolute: true });\r\n  return files.map(file => Path.normalize(file));\r\n}\r\n\r\nexport async function getCertainFilesFromDirectory(directoryPath: string, filesNames: string[]) {\r\n  const pattern = filesNames.length === 1 ? filesNames[0] : `(${filesNames.join(\"|\")})`;\r\n  return getFilesFromDirectory(directoryPath, pattern + \".{ts,tsx}\");\r\n}\r\n\r\nexport function areSetsEqual<T>(set1: Set<T>, set2: Set<T>): boolean {\r\n  if (set1.size !== set2.size) return false;\r\n  for (const item of set1) {\r\n    if (!set2.has(item)) return false;\r\n  }\r\n  return true;\r\n}\r\n"],"mappings":";;;;;;;;;;;AASA,eAAsB,yBAAyB;CAC7C,MAAM,qBAAqB,YAAY,CAAC;AAC1C;;;;;AAMA,eAAsB,sBAAsB,gBAAgB,QAAQ,GAAG,UAAU,iBAAiB;CAEhG,QAAO,MADa,KAAK,GAAG,KAAK,UAAU,aAAa,EAAE,GAAG,WAAW,EAAE,UAAU,KAAK,CAAC,EAC9E,CAAC,KAAI,SAAQ,KAAK,UAAU,IAAI,CAAC;AAC/C;AAEA,eAAsB,6BAA6B,eAAuB,YAAsB;CAE9F,OAAO,sBAAsB,gBADb,WAAW,WAAW,IAAI,WAAW,KAAK,IAAI,WAAW,KAAK,GAAG,EAAE,MAC7B,WAAW;AACnE;AAEA,SAAgB,aAAgB,MAAc,MAAuB;CACnE,IAAI,KAAK,SAAS,KAAK,MAAM,OAAO;CACpC,KAAK,MAAM,QAAQ,MACjB,IAAI,CAAC,KAAK,IAAI,IAAI,GAAG,OAAO;CAE9B,OAAO;AACT"}
+{"version":3,"file":"utils.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/utils.ts"],"sourcesContent":["import { ensureDirectoryAsync } from \"@warlock.js/fs\";\r\nimport glob from \"fast-glob\";\r\nimport { srcPath, warlockPath } from \"../utils\";\r\nimport { Path } from \"./path\";\r\n\r\n/**\r\n * Ensure the .warlock/ directory exists. Used by the loader-hook\r\n * registration which writes its bundled hook file into this directory.\r\n */\r\nexport async function ensureWarlockDirectory() {\r\n  await ensureDirectoryAsync(warlockPath());\r\n}\r\n\r\n/**\r\n * Glob the project's `src/` directory for `.ts`/`.tsx` files. Returns\r\n * normalised absolute paths.\r\n */\r\nexport async function getFilesFromDirectory(directoryPath = srcPath(), pattern = \"**/*.{ts,tsx}\") {\r\n  const files = await glob(`${Path.normalize(directoryPath)}/${pattern}`, { absolute: true });\r\n  return files.map(file => Path.normalize(file));\r\n}\r\n\r\nexport async function getCertainFilesFromDirectory(directoryPath: string, filesNames: string[]) {\r\n  const pattern = filesNames.length === 1 ? filesNames[0] : `(${filesNames.join(\"|\")})`;\r\n  return getFilesFromDirectory(directoryPath, pattern + \".{ts,tsx}\");\r\n}\r\n\r\nexport function areSetsEqual<T>(set1: Set<T>, set2: Set<T>): boolean {\r\n  if (set1.size !== set2.size) return false;\r\n  for (const item of set1) {\r\n    if (!set2.has(item)) return false;\r\n  }\r\n  return true;\r\n}\r\n"],"mappings":";;;;;;;;;;;AASA,eAAsB,yBAAyB;CAC7C,MAAM,qBAAqB,YAAY,CAAC;AAC1C;;;;;AAMA,eAAsB,sBAAsB,gBAAgB,QAAQ,GAAG,UAAU,iBAAiB;CAEhG,QAAO,MADa,KAAK,GAAG,KAAK,UAAU,aAAa,EAAE,GAAG,WAAW,EAAE,UAAU,KAAK,CAAC,EAC9E,CAAC,KAAI,SAAQ,KAAK,UAAU,IAAI,CAAC;AAC/C;AAEA,eAAsB,6BAA6B,eAAuB,YAAsB;CAE9F,OAAO,sBAAsB,gBADb,WAAW,WAAW,IAAI,WAAW,KAAK,IAAI,WAAW,KAAK,GAAG,EAAE,MAC7B,WAAW;AACnE;AAEA,SAAgB,aAAgB,MAAc,MAAuB;CACnE,IAAI,KAAK,SAAS,KAAK,MAAM,OAAO;CACpC,KAAK,MAAM,QAAQ,MACjB,IAAI,CAAC,KAAK,IAAI,IAAI,GAAG,OAAO;CAE9B,OAAO;AACT"}

package/esm/encryption/encrypt.d.mts

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/core/src/encryption/encrypt.d.ts
+//#region ../core/src/encryption/encrypt.d.ts
 /**
  * Encrypts a plaintext string using AES-256-GCM (or the configured algorithm).
  * Returns a combined string in the format `iv:ciphertext:authTag`.

package/esm/encryption/encrypt.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"encrypt.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/encryption/encrypt.ts"],"mappings":";;AAoDA;;;;AAAyC;AAiCzC;;;;iBAjCgB,OAAA,CAAQ,SAAiB;;;;;;;;;;;iBAiCzB,OAAA,CAAQ,UAAkB"}
+{"version":3,"file":"encrypt.d.mts","names":[],"sources":["../../../../../../../core/src/encryption/encrypt.ts"],"mappings":";;AAoDA;;;;AAAyC;AAiCzC;;;;iBAjCgB,OAAA,CAAQ,SAAiB;;;;;;;;;;;iBAiCzB,OAAA,CAAQ,UAAkB"}

package/esm/encryption/encrypt.mjs

@@ -2,7 +2,7 @@ import { config } from "../config/config-getter.mjs";
 import "../config/index.mjs";
 import crypto from "crypto";
 
-//#region ../@warlock.js/core/src/encryption/encrypt.ts
+//#region ../core/src/encryption/encrypt.ts
 /**
 * Default encryption algorithm.
 */

package/esm/encryption/encrypt.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"encrypt.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/encryption/encrypt.ts"],"sourcesContent":["import crypto from \"crypto\";\nimport { config } from \"../config\";\nimport { EncryptionConfigurations } from \"./types\";\n\n/**\n * Default encryption algorithm.\n */\nconst DEFAULT_ALGORITHM = \"aes-256-gcm\";\n\n/**\n * Get the encryption key from config, validated as a 32-byte hex string.\n */\nfunction getEncryptionKey(): Buffer {\n  const key = config.key<EncryptionConfigurations[\"key\"]>(\"encryption.key\");\n\n  if (!key) {\n    throw new Error(\n      \"Missing encryption key. Set 'encryption.key' in your config (64 hex characters = 32 bytes).\",\n    );\n  }\n\n  const buffer = Buffer.from(key, \"hex\");\n\n  if (buffer.length !== 32) {\n    throw new Error(\n      `Encryption key must be exactly 32 bytes (64 hex characters). Got ${buffer.length} bytes for key ${key}.`,\n    );\n  }\n\n  return buffer;\n}\n\n/**\n * Get the configured encryption algorithm, defaults to aes-256-gcm.\n */\nfunction getAlgorithm(): string {\n  return config.key<EncryptionConfigurations[\"algorithm\"]>(\n    \"encryption.algorithm\",\n    DEFAULT_ALGORITHM,\n  )!;\n}\n\n/**\n * Encrypts a plaintext string using AES-256-GCM (or the configured algorithm).\n * Returns a combined string in the format `iv:ciphertext:authTag`.\n *\n * @example\n * import { encrypt } from \"@warlock.js/core\";\n *\n * const encrypted = encrypt(\"sk-proj-12345\");\n * // => \"a1b2c3...:d4e5f6...:g7h8i9...\"\n */\nexport function encrypt(plainText: string): string {\n  if (!plainText) return plainText;\n\n  const keyBuffer = getEncryptionKey();\n  const algorithm = getAlgorithm();\n\n  try {\n    // IV must be unique per encryption. 16 bytes is standard for AES.\n    const iv = crypto.randomBytes(16);\n    const cipher = crypto.createCipheriv(algorithm, keyBuffer, iv);\n\n    let encrypted = cipher.update(plainText, \"utf8\", \"hex\");\n    encrypted += cipher.final(\"hex\");\n\n    // Auth tag validates ciphertext integrity (tamper detection)\n    const authTag = (cipher as crypto.CipherGCM).getAuthTag().toString(\"hex\");\n\n    return `${iv.toString(\"hex\")}:${encrypted}:${authTag}`;\n  } catch (error) {\n    throw new Error(`Encryption failed: ${(error as Error).message}`);\n  }\n}\n\n/**\n * Decrypts a string previously encrypted with {@link encrypt}.\n * Expects the format `iv:ciphertext:authTag`.\n *\n * @example\n * import { decrypt } from \"@warlock.js/core\";\n *\n * const original = decrypt(encryptedString);\n * // => \"sk-proj-12345\"\n */\nexport function decrypt(cipherText: string): string {\n  if (!cipherText) return cipherText;\n\n  const keyBuffer = getEncryptionKey();\n  const algorithm = getAlgorithm();\n\n  try {\n    const parts = cipherText.split(\":\");\n\n    if (parts.length !== 3) {\n      throw new Error(\"Invalid encrypted format. Expected iv:ciphertext:authTag\");\n    }\n\n    const [ivHex, encryptedHex, authTagHex] = parts;\n\n    const decipher = crypto.createDecipheriv(algorithm, keyBuffer, Buffer.from(ivHex, \"hex\"));\n\n    (decipher as crypto.DecipherGCM).setAuthTag(Buffer.from(authTagHex, \"hex\"));\n\n    let decrypted = decipher.update(encryptedHex, \"hex\", \"utf8\");\n    // .final() throws if auth tag is invalid (data tampered)\n    decrypted += decipher.final(\"utf8\");\n\n    return decrypted;\n  } catch (error) {\n    throw new Error(`Decryption failed: ${(error as Error).message}`);\n  }\n}\n"],"mappings":";;;;;;;;AAOA,MAAM,oBAAoB;;;;AAK1B,SAAS,mBAA2B;CAClC,MAAM,MAAM,OAAO,IAAqC,gBAAgB;CAExE,IAAI,CAAC,KACH,MAAM,IAAI,MACR,6FACF;CAGF,MAAM,SAAS,OAAO,KAAK,KAAK,KAAK;CAErC,IAAI,OAAO,WAAW,IACpB,MAAM,IAAI,MACR,oEAAoE,OAAO,OAAO,iBAAiB,IAAI,EACzG;CAGF,OAAO;AACT;;;;AAKA,SAAS,eAAuB;CAC9B,OAAO,OAAO,IACZ,wBACA,iBACF;AACF;;;;;;;;;;;AAYA,SAAgB,QAAQ,WAA2B;CACjD,IAAI,CAAC,WAAW,OAAO;CAEvB,MAAM,YAAY,iBAAiB;CACnC,MAAM,YAAY,aAAa;CAE/B,IAAI;EAEF,MAAM,KAAK,OAAO,YAAY,EAAE;EAChC,MAAM,SAAS,OAAO,eAAe,WAAW,WAAW,EAAE;EAE7D,IAAI,YAAY,OAAO,OAAO,WAAW,QAAQ,KAAK;EACtD,aAAa,OAAO,MAAM,KAAK;EAG/B,MAAM,UAAW,OAA4B,WAAW,CAAC,CAAC,SAAS,KAAK;EAExE,OAAO,GAAG,GAAG,SAAS,KAAK,EAAE,GAAG,UAAU,GAAG;CAC/C,SAAS,OAAO;EACd,MAAM,IAAI,MAAM,sBAAuB,MAAgB,SAAS;CAClE;AACF;;;;;;;;;;;AAYA,SAAgB,QAAQ,YAA4B;CAClD,IAAI,CAAC,YAAY,OAAO;CAExB,MAAM,YAAY,iBAAiB;CACnC,MAAM,YAAY,aAAa;CAE/B,IAAI;EACF,MAAM,QAAQ,WAAW,MAAM,GAAG;EAElC,IAAI,MAAM,WAAW,GACnB,MAAM,IAAI,MAAM,0DAA0D;EAG5E,MAAM,CAAC,OAAO,cAAc,cAAc;EAE1C,MAAM,WAAW,OAAO,iBAAiB,WAAW,WAAW,OAAO,KAAK,OAAO,KAAK,CAAC;EAExF,AAAC,SAAgC,WAAW,OAAO,KAAK,YAAY,KAAK,CAAC;EAE1E,IAAI,YAAY,SAAS,OAAO,cAAc,OAAO,MAAM;EAE3D,aAAa,SAAS,MAAM,MAAM;EAElC,OAAO;CACT,SAAS,OAAO;EACd,MAAM,IAAI,MAAM,sBAAuB,MAAgB,SAAS;CAClE;AACF"}
+{"version":3,"file":"encrypt.mjs","names":[],"sources":["../../../../../../../core/src/encryption/encrypt.ts"],"sourcesContent":["import crypto from \"crypto\";\nimport { config } from \"../config\";\nimport { EncryptionConfigurations } from \"./types\";\n\n/**\n * Default encryption algorithm.\n */\nconst DEFAULT_ALGORITHM = \"aes-256-gcm\";\n\n/**\n * Get the encryption key from config, validated as a 32-byte hex string.\n */\nfunction getEncryptionKey(): Buffer {\n  const key = config.key<EncryptionConfigurations[\"key\"]>(\"encryption.key\");\n\n  if (!key) {\n    throw new Error(\n      \"Missing encryption key. Set 'encryption.key' in your config (64 hex characters = 32 bytes).\",\n    );\n  }\n\n  const buffer = Buffer.from(key, \"hex\");\n\n  if (buffer.length !== 32) {\n    throw new Error(\n      `Encryption key must be exactly 32 bytes (64 hex characters). Got ${buffer.length} bytes for key ${key}.`,\n    );\n  }\n\n  return buffer;\n}\n\n/**\n * Get the configured encryption algorithm, defaults to aes-256-gcm.\n */\nfunction getAlgorithm(): string {\n  return config.key<EncryptionConfigurations[\"algorithm\"]>(\n    \"encryption.algorithm\",\n    DEFAULT_ALGORITHM,\n  )!;\n}\n\n/**\n * Encrypts a plaintext string using AES-256-GCM (or the configured algorithm).\n * Returns a combined string in the format `iv:ciphertext:authTag`.\n *\n * @example\n * import { encrypt } from \"@warlock.js/core\";\n *\n * const encrypted = encrypt(\"sk-proj-12345\");\n * // => \"a1b2c3...:d4e5f6...:g7h8i9...\"\n */\nexport function encrypt(plainText: string): string {\n  if (!plainText) return plainText;\n\n  const keyBuffer = getEncryptionKey();\n  const algorithm = getAlgorithm();\n\n  try {\n    // IV must be unique per encryption. 16 bytes is standard for AES.\n    const iv = crypto.randomBytes(16);\n    const cipher = crypto.createCipheriv(algorithm, keyBuffer, iv);\n\n    let encrypted = cipher.update(plainText, \"utf8\", \"hex\");\n    encrypted += cipher.final(\"hex\");\n\n    // Auth tag validates ciphertext integrity (tamper detection)\n    const authTag = (cipher as crypto.CipherGCM).getAuthTag().toString(\"hex\");\n\n    return `${iv.toString(\"hex\")}:${encrypted}:${authTag}`;\n  } catch (error) {\n    throw new Error(`Encryption failed: ${(error as Error).message}`);\n  }\n}\n\n/**\n * Decrypts a string previously encrypted with {@link encrypt}.\n * Expects the format `iv:ciphertext:authTag`.\n *\n * @example\n * import { decrypt } from \"@warlock.js/core\";\n *\n * const original = decrypt(encryptedString);\n * // => \"sk-proj-12345\"\n */\nexport function decrypt(cipherText: string): string {\n  if (!cipherText) return cipherText;\n\n  const keyBuffer = getEncryptionKey();\n  const algorithm = getAlgorithm();\n\n  try {\n    const parts = cipherText.split(\":\");\n\n    if (parts.length !== 3) {\n      throw new Error(\"Invalid encrypted format. Expected iv:ciphertext:authTag\");\n    }\n\n    const [ivHex, encryptedHex, authTagHex] = parts;\n\n    const decipher = crypto.createDecipheriv(algorithm, keyBuffer, Buffer.from(ivHex, \"hex\"));\n\n    (decipher as crypto.DecipherGCM).setAuthTag(Buffer.from(authTagHex, \"hex\"));\n\n    let decrypted = decipher.update(encryptedHex, \"hex\", \"utf8\");\n    // .final() throws if auth tag is invalid (data tampered)\n    decrypted += decipher.final(\"utf8\");\n\n    return decrypted;\n  } catch (error) {\n    throw new Error(`Decryption failed: ${(error as Error).message}`);\n  }\n}\n"],"mappings":";;;;;;;;AAOA,MAAM,oBAAoB;;;;AAK1B,SAAS,mBAA2B;CAClC,MAAM,MAAM,OAAO,IAAqC,gBAAgB;CAExE,IAAI,CAAC,KACH,MAAM,IAAI,MACR,6FACF;CAGF,MAAM,SAAS,OAAO,KAAK,KAAK,KAAK;CAErC,IAAI,OAAO,WAAW,IACpB,MAAM,IAAI,MACR,oEAAoE,OAAO,OAAO,iBAAiB,IAAI,EACzG;CAGF,OAAO;AACT;;;;AAKA,SAAS,eAAuB;CAC9B,OAAO,OAAO,IACZ,wBACA,iBACF;AACF;;;;;;;;;;;AAYA,SAAgB,QAAQ,WAA2B;CACjD,IAAI,CAAC,WAAW,OAAO;CAEvB,MAAM,YAAY,iBAAiB;CACnC,MAAM,YAAY,aAAa;CAE/B,IAAI;EAEF,MAAM,KAAK,OAAO,YAAY,EAAE;EAChC,MAAM,SAAS,OAAO,eAAe,WAAW,WAAW,EAAE;EAE7D,IAAI,YAAY,OAAO,OAAO,WAAW,QAAQ,KAAK;EACtD,aAAa,OAAO,MAAM,KAAK;EAG/B,MAAM,UAAW,OAA4B,WAAW,CAAC,CAAC,SAAS,KAAK;EAExE,OAAO,GAAG,GAAG,SAAS,KAAK,EAAE,GAAG,UAAU,GAAG;CAC/C,SAAS,OAAO;EACd,MAAM,IAAI,MAAM,sBAAuB,MAAgB,SAAS;CAClE;AACF;;;;;;;;;;;AAYA,SAAgB,QAAQ,YAA4B;CAClD,IAAI,CAAC,YAAY,OAAO;CAExB,MAAM,YAAY,iBAAiB;CACnC,MAAM,YAAY,aAAa;CAE/B,IAAI;EACF,MAAM,QAAQ,WAAW,MAAM,GAAG;EAElC,IAAI,MAAM,WAAW,GACnB,MAAM,IAAI,MAAM,0DAA0D;EAG5E,MAAM,CAAC,OAAO,cAAc,cAAc;EAE1C,MAAM,WAAW,OAAO,iBAAiB,WAAW,WAAW,OAAO,KAAK,OAAO,KAAK,CAAC;EAExF,AAAC,SAAgC,WAAW,OAAO,KAAK,YAAY,KAAK,CAAC;EAE1E,IAAI,YAAY,SAAS,OAAO,cAAc,OAAO,MAAM;EAE3D,aAAa,SAAS,MAAM,MAAM;EAElC,OAAO;CACT,SAAS,OAAO;EACd,MAAM,IAAI,MAAM,sBAAuB,MAAgB,SAAS;CAClE;AACF"}

package/esm/encryption/hash.d.mts

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/core/src/encryption/hash.d.ts
+//#region ../core/src/encryption/hash.d.ts
 /**
  * Creates a deterministic HMAC-SHA256 hash of the given string.
  *

package/esm/encryption/hash.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/encryption/hash.ts"],"mappings":";;AAmBA;;;;AAA0C;;;;;;;;;;iBAA1B,QAAA,CAAS,SAAiB"}
+{"version":3,"file":"hash.d.mts","names":[],"sources":["../../../../../../../core/src/encryption/hash.ts"],"mappings":";;AAmBA;;;;AAA0C;;;;;;;;;;iBAA1B,QAAA,CAAS,SAAiB"}

package/esm/encryption/hash.mjs

@@ -2,7 +2,7 @@ import { config } from "../config/config-getter.mjs";
 import "../config/index.mjs";
 import crypto from "crypto";
 
-//#region ../@warlock.js/core/src/encryption/hash.ts
+//#region ../core/src/encryption/hash.ts
 /**
 * Creates a deterministic HMAC-SHA256 hash of the given string.
 *

package/esm/encryption/hash.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"hash.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/encryption/hash.ts"],"sourcesContent":["import crypto from \"crypto\";\nimport { config } from \"../config\";\nimport { EncryptionConfigurations } from \"./types\";\n\n/**\n * Creates a deterministic HMAC-SHA256 hash of the given string.\n *\n * Useful for creating searchable, unique fingerprints of sensitive data\n * (e.g., an API key) without storing the plaintext.\n *\n * Uses a dedicated HMAC key from config. Falls back to the encryption key\n * if no separate HMAC key is configured.\n *\n * @example\n * import { hmacHash } from \"@warlock.js/core\";\n *\n * const fingerprint = hmacHash(\"sk-proj-12345\");\n * // Store `fingerprint` in DB for lookups, store encrypted value separately\n */\nexport function hmacHash(plainText: string): string {\n  if (!plainText) return plainText;\n\n  const hmacKey =\n    config.key<EncryptionConfigurations[\"hmacKey\"]>(\"encryption.hmacKey\") ||\n    config.key<EncryptionConfigurations[\"key\"]>(\"encryption.key\");\n\n  if (!hmacKey) {\n    throw new Error(\n      \"Missing HMAC key. Set 'encryption.hmacKey' (or 'encryption.key') in your config.\",\n    );\n  }\n\n  const keyBuffer = Buffer.from(hmacKey, \"hex\");\n\n  return crypto.createHmac(\"sha256\", keyBuffer).update(plainText).digest(\"hex\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,SAAS,WAA2B;CAClD,IAAI,CAAC,WAAW,OAAO;CAEvB,MAAM,UACJ,OAAO,IAAyC,oBAAoB,KACpE,OAAO,IAAqC,gBAAgB;CAE9D,IAAI,CAAC,SACH,MAAM,IAAI,MACR,kFACF;CAGF,MAAM,YAAY,OAAO,KAAK,SAAS,KAAK;CAE5C,OAAO,OAAO,WAAW,UAAU,SAAS,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,KAAK;AAC9E"}
+{"version":3,"file":"hash.mjs","names":[],"sources":["../../../../../../../core/src/encryption/hash.ts"],"sourcesContent":["import crypto from \"crypto\";\nimport { config } from \"../config\";\nimport { EncryptionConfigurations } from \"./types\";\n\n/**\n * Creates a deterministic HMAC-SHA256 hash of the given string.\n *\n * Useful for creating searchable, unique fingerprints of sensitive data\n * (e.g., an API key) without storing the plaintext.\n *\n * Uses a dedicated HMAC key from config. Falls back to the encryption key\n * if no separate HMAC key is configured.\n *\n * @example\n * import { hmacHash } from \"@warlock.js/core\";\n *\n * const fingerprint = hmacHash(\"sk-proj-12345\");\n * // Store `fingerprint` in DB for lookups, store encrypted value separately\n */\nexport function hmacHash(plainText: string): string {\n  if (!plainText) return plainText;\n\n  const hmacKey =\n    config.key<EncryptionConfigurations[\"hmacKey\"]>(\"encryption.hmacKey\") ||\n    config.key<EncryptionConfigurations[\"key\"]>(\"encryption.key\");\n\n  if (!hmacKey) {\n    throw new Error(\n      \"Missing HMAC key. Set 'encryption.hmacKey' (or 'encryption.key') in your config.\",\n    );\n  }\n\n  const keyBuffer = Buffer.from(hmacKey, \"hex\");\n\n  return crypto.createHmac(\"sha256\", keyBuffer).update(plainText).digest(\"hex\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,SAAS,WAA2B;CAClD,IAAI,CAAC,WAAW,OAAO;CAEvB,MAAM,UACJ,OAAO,IAAyC,oBAAoB,KACpE,OAAO,IAAqC,gBAAgB;CAE9D,IAAI,CAAC,SACH,MAAM,IAAI,MACR,kFACF;CAGF,MAAM,YAAY,OAAO,KAAK,SAAS,KAAK;CAE5C,OAAO,OAAO,WAAW,UAAU,SAAS,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,KAAK;AAC9E"}

package/esm/encryption/password.d.mts

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/core/src/encryption/password.d.ts
+//#region ../core/src/encryption/password.d.ts
 /**
  * Hashes a password using bcrypt (async — does not block the event loop).
  *

package/esm/encryption/password.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"password.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/encryption/password.ts"],"mappings":";;AA6DA;;;;AAA6D;AAqB7D;;;;;;iBArBsB,YAAA,CAAa,QAAA,WAAmB,OAAO;;AAwBnD;;;;;;;iBAHY,cAAA,CACpB,aAAA,UACA,cAAA,WACC,OAAO"}
+{"version":3,"file":"password.d.mts","names":[],"sources":["../../../../../../../core/src/encryption/password.ts"],"mappings":";;AA6DA;;;;AAA6D;AAqB7D;;;;;;iBArBsB,YAAA,CAAa,QAAA,WAAmB,OAAO;;AAwBnD;;;;;;;iBAHY,cAAA,CACpB,aAAA,UACA,cAAA,WACC,OAAO"}

package/esm/encryption/password.mjs

@@ -1,7 +1,7 @@
 import { config } from "../config/config-getter.mjs";
 import "../config/index.mjs";
 
-//#region ../@warlock.js/core/src/encryption/password.ts
+//#region ../core/src/encryption/password.ts
 /**
 * Default bcrypt salt rounds.
 */

package/esm/encryption/password.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"password.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/encryption/password.ts"],"sourcesContent":["import { config } from \"../config\";\r\nimport { EncryptionPasswordConfigurations } from \"./types\";\r\n\r\n/**\r\n * Default bcrypt salt rounds.\r\n */\r\nconst DEFAULT_SALT_ROUNDS = 12;\r\n\r\n// ============================================================\r\n// Lazy-loaded bcryptjs SDK Types\r\n// ============================================================\r\n\r\n/**\r\n * Cached bcryptjs module (loaded once, reused)\r\n */\r\nlet Bcryptjs: typeof import(\"bcryptjs\");\r\n\r\nlet isModuleExists: boolean | null = null;\r\n\r\n/**\r\n * Installation instructions for bcryptjs package\r\n */\r\nconst BCRYPTJS_INSTALL_INSTRUCTIONS = `\r\nPassword encryption requires the bcryptjs package.\r\nInstall it with:\r\n\r\n  yarn add bcryptjs\r\n\r\nOr with your preferred package manager:\r\n\r\n  npm install bcryptjs\r\n  pnpm add bcryptjs\r\n  yarn add bcryptjs\r\n`.trim();\r\n\r\n/**\r\n * Load bcryptjs module\r\n */\r\nasync function loadBcryptjs() {\r\n  try {\r\n    Bcryptjs = await import(\"bcryptjs\");\r\n    isModuleExists = true;\r\n  } catch {\r\n    isModuleExists = false;\r\n  }\r\n}\r\n\r\nloadBcryptjs();\r\n\r\n/**\r\n * Hashes a password using bcrypt (async — does not block the event loop).\r\n *\r\n * Salt rounds are read from \\`encryption.password.saltRounds\\` config,\r\n * defaulting to 12.\r\n *\r\n * @example\r\n * import { hashPassword } from \"@warlock.js/core\";\r\n *\r\n * const hashed = await hashPassword(\"user-password-123\");\r\n * // Store \\`hashed\\` in the database\r\n */\r\nexport async function hashPassword(password: string): Promise<string> {\r\n  if (!isModuleExists) {\r\n    throw new Error(BCRYPTJS_INSTALL_INSTRUCTIONS);\r\n  }\r\n\r\n  const saltRounds = config.key<EncryptionPasswordConfigurations[\"salt\"]>(\r\n    \"encryption.password.salt\",\r\n    DEFAULT_SALT_ROUNDS,\r\n  )!;\r\n\r\n  return Bcryptjs.hash(String(password), saltRounds);\r\n}\r\n\r\n/**\r\n * Verifies a plain password against a bcrypt hash (async — does not block the event loop).\r\n *\r\n * @example\r\n * import { verifyPassword } from \"@warlock.js/core\";\r\n *\r\n * const isValid = await verifyPassword(\"user-password-123\", storedHash);\r\n */\r\nexport async function verifyPassword(\r\n  plainPassword: string,\r\n  hashedPassword: string,\r\n): Promise<boolean> {\r\n  if (!isModuleExists) {\r\n    throw new Error(BCRYPTJS_INSTALL_INSTRUCTIONS);\r\n  }\r\n\r\n  return Bcryptjs.compare(String(plainPassword), String(hashedPassword));\r\n}\r\n"],"mappings":";;;;;;;AAMA,MAAM,sBAAsB;;;;AAS5B,IAAI;AAEJ,IAAI,iBAAiC;;;;AAKrC,MAAM,gCAAgC;;;;;;;;;;;EAWpC,KAAK;;;;AAKP,eAAe,eAAe;CAC5B,IAAI;EACF,WAAW,MAAM,OAAO;EACxB,iBAAiB;CACnB,QAAQ;EACN,iBAAiB;CACnB;AACF;AAEA,aAAa;;;;;;;;;;;;;AAcb,eAAsB,aAAa,UAAmC;CACpE,IAAI,CAAC,gBACH,MAAM,IAAI,MAAM,6BAA6B;CAG/C,MAAM,aAAa,OAAO,IACxB,4BACA,mBACF;CAEA,OAAO,SAAS,KAAK,OAAO,QAAQ,GAAG,UAAU;AACnD;;;;;;;;;AAUA,eAAsB,eACpB,eACA,gBACkB;CAClB,IAAI,CAAC,gBACH,MAAM,IAAI,MAAM,6BAA6B;CAG/C,OAAO,SAAS,QAAQ,OAAO,aAAa,GAAG,OAAO,cAAc,CAAC;AACvE"}
+{"version":3,"file":"password.mjs","names":[],"sources":["../../../../../../../core/src/encryption/password.ts"],"sourcesContent":["import { config } from \"../config\";\r\nimport { EncryptionPasswordConfigurations } from \"./types\";\r\n\r\n/**\r\n * Default bcrypt salt rounds.\r\n */\r\nconst DEFAULT_SALT_ROUNDS = 12;\r\n\r\n// ============================================================\r\n// Lazy-loaded bcryptjs SDK Types\r\n// ============================================================\r\n\r\n/**\r\n * Cached bcryptjs module (loaded once, reused)\r\n */\r\nlet Bcryptjs: typeof import(\"bcryptjs\");\r\n\r\nlet isModuleExists: boolean | null = null;\r\n\r\n/**\r\n * Installation instructions for bcryptjs package\r\n */\r\nconst BCRYPTJS_INSTALL_INSTRUCTIONS = `\r\nPassword encryption requires the bcryptjs package.\r\nInstall it with:\r\n\r\n  yarn add bcryptjs\r\n\r\nOr with your preferred package manager:\r\n\r\n  npm install bcryptjs\r\n  pnpm add bcryptjs\r\n  yarn add bcryptjs\r\n`.trim();\r\n\r\n/**\r\n * Load bcryptjs module\r\n */\r\nasync function loadBcryptjs() {\r\n  try {\r\n    Bcryptjs = await import(\"bcryptjs\");\r\n    isModuleExists = true;\r\n  } catch {\r\n    isModuleExists = false;\r\n  }\r\n}\r\n\r\nloadBcryptjs();\r\n\r\n/**\r\n * Hashes a password using bcrypt (async — does not block the event loop).\r\n *\r\n * Salt rounds are read from \\`encryption.password.saltRounds\\` config,\r\n * defaulting to 12.\r\n *\r\n * @example\r\n * import { hashPassword } from \"@warlock.js/core\";\r\n *\r\n * const hashed = await hashPassword(\"user-password-123\");\r\n * // Store \\`hashed\\` in the database\r\n */\r\nexport async function hashPassword(password: string): Promise<string> {\r\n  if (!isModuleExists) {\r\n    throw new Error(BCRYPTJS_INSTALL_INSTRUCTIONS);\r\n  }\r\n\r\n  const saltRounds = config.key<EncryptionPasswordConfigurations[\"salt\"]>(\r\n    \"encryption.password.salt\",\r\n    DEFAULT_SALT_ROUNDS,\r\n  )!;\r\n\r\n  return Bcryptjs.hash(String(password), saltRounds);\r\n}\r\n\r\n/**\r\n * Verifies a plain password against a bcrypt hash (async — does not block the event loop).\r\n *\r\n * @example\r\n * import { verifyPassword } from \"@warlock.js/core\";\r\n *\r\n * const isValid = await verifyPassword(\"user-password-123\", storedHash);\r\n */\r\nexport async function verifyPassword(\r\n  plainPassword: string,\r\n  hashedPassword: string,\r\n): Promise<boolean> {\r\n  if (!isModuleExists) {\r\n    throw new Error(BCRYPTJS_INSTALL_INSTRUCTIONS);\r\n  }\r\n\r\n  return Bcryptjs.compare(String(plainPassword), String(hashedPassword));\r\n}\r\n"],"mappings":";;;;;;;AAMA,MAAM,sBAAsB;;;;AAS5B,IAAI;AAEJ,IAAI,iBAAiC;;;;AAKrC,MAAM,gCAAgC;;;;;;;;;;;EAWpC,KAAK;;;;AAKP,eAAe,eAAe;CAC5B,IAAI;EACF,WAAW,MAAM,OAAO;EACxB,iBAAiB;CACnB,QAAQ;EACN,iBAAiB;CACnB;AACF;AAEA,aAAa;;;;;;;;;;;;;AAcb,eAAsB,aAAa,UAAmC;CACpE,IAAI,CAAC,gBACH,MAAM,IAAI,MAAM,6BAA6B;CAG/C,MAAM,aAAa,OAAO,IACxB,4BACA,mBACF;CAEA,OAAO,SAAS,KAAK,OAAO,QAAQ,GAAG,UAAU;AACnD;;;;;;;;;AAUA,eAAsB,eACpB,eACA,gBACkB;CAClB,IAAI,CAAC,gBACH,MAAM,IAAI,MAAM,6BAA6B;CAG/C,OAAO,SAAS,QAAQ,OAAO,aAAa,GAAG,OAAO,cAAc,CAAC;AACvE"}

package/esm/encryption/types.d.mts

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/core/src/encryption/types.d.ts
+//#region ../core/src/encryption/types.d.ts
 /**
  * Configuration for the encryption module.
  *

package/esm/encryption/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/encryption/types.ts"],"mappings":";;AAmBA;;;;;;;;;;AAyB6C;AAG7C;;;;AAKM;;;KAjCM,wBAAA;;;;;;EAMV,GAAA;;;;;EAMA,SAAA;;;;;;;EAQA,OAAA;;;;EAKA,QAAA,GAAW,gCAAgC;AAAA;AAAA,KAGjC,gCAAA;;;;;EAKV,IAAI;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/encryption/types.ts"],"mappings":";;AAmBA;;;;;;;;;;AAyB6C;AAG7C;;;;AAKM;;;KAjCM,wBAAA;;;;;;EAMV,GAAA;;;;;EAMA,SAAA;;;;;;;EAQA,OAAA;;;;EAKA,QAAA,GAAW,gCAAgC;AAAA;AAAA,KAGjC,gCAAA;;;;;EAKV,IAAI;AAAA"}

package/esm/generations/add-command.action.mjs

@@ -1,12 +1,13 @@
 import { rootPath, srcPath } from "../utils/paths.mjs";
 import "../utils/index.mjs";
 import { getWarlockVersion } from "../utils/framework-vesion.mjs";
+import { detectPackageManager, getAddCommand } from "../updater/package-manager.mjs";
 import { accessConfigStub, accessResolverStub, accessRoleMigrationStub, accessRoleModelIndexStub, accessRoleModelStub, accessUserRoleMigrationStub, accessUserRoleModelIndexStub, accessUserRoleModelStub, aiConfigStub, communicatorsConfigStub, notificationControllersStub, notificationMigrationStub, notificationModelStub, notificationRoutesStub, notificationsConfigStub, socketConfigStub } from "./stubs.mjs";
 import { colors } from "@mongez/copper";
 import { ensureDirectoryAsync, fileExistsAsync, getFileAsync, getJsonFileAsync, putFileAsync, putJsonFileAsync } from "@warlock.js/fs";
 import { execSync } from "node:child_process";
 
-//#region ../@warlock.js/core/src/generations/add-command.action.ts
+//#region ../core/src/generations/add-command.action.ts
 /**
 * Build a migration filename timestamp prefix in the framework's
 * MM-DD-YYYY_HH-MM-SS form. Cascade infers a migration's createdAt from this
@@ -478,7 +479,7 @@ async function addCommandAction(options) {
 * Runs two passes (prod then dev) so each lands in the correct section.
 */
 async function installDependencies(packageManager, dependencies, devDependencies) {
-	const packageManagerCommand = await getPackageManagerCommand(packageManager);
+	const packageManagerCommand = getAddCommand(packageManager ?? await detectPackageManager());
 	if (Object.keys(dependencies).length > 0) {
 		console.log(`Installing dependencies ${colors.magenta(Object.keys(dependencies).join(", "))}`);
 		execSync(`${packageManagerCommand} ${Object.keys(dependencies).join(" ")}`, {
@@ -519,17 +520,6 @@ function validateFeatures(features) {
 		process.exit(1);
 	}
 }
-async function getPackageManagerCommand(packageManager) {
-	if (!packageManager) packageManager = await detectPackageManager();
-	if (packageManager === "npm") return "npm install";
-	if (packageManager === "yarn") return "yarn add";
-	if (packageManager === "pnpm") return "pnpm add";
-}
-async function detectPackageManager() {
-	if (await fileExistsAsync(rootPath("package-lock.json"))) return "npm";
-	if (await fileExistsAsync(rootPath("yarn.lock"))) return "yarn";
-	if (await fileExistsAsync(rootPath("pnpm-lock.yaml"))) return "pnpm";
-}
 
 //#endregion
 export { addCommandAction };