@vlynk-studios/nodulus-core 1.1.0

package/dist/cli/index.js

@@ -0,0 +1,331 @@
+#!/usr/bin/env node
+
+// src/cli/index.ts
+import { Command as Command3 } from "commander";
+
+// src/cli/commands/create-module.ts
+import { Command } from "commander";
+import fs from "fs";
+import path from "path";
+import pc from "picocolors";
+function createModuleCommand() {
+  return new Command("create-module").description("Scaffolds a new Nodulus module").argument("<name>", "Module name (lowercase, no spaces/special chars)").option("-p, --path <path>", "Destination folder path (default: src/modules/<name>)").option("--no-repository", "Skip generating a repository file").option("--no-schema", "Skip generating a schema file").option("--js", "Force generate JavaScript (.js) files").option("--ts", "Force generate TypeScript (.ts) files").action((name, options) => {
+    if (!/^[a-z0-9-]+$/.test(name)) {
+      console.error(pc.red(`
+Error: Invalid module name "${name}". Module names must be lowercase and contain only letters, numbers, or hyphens.
+`));
+      process.exit(1);
+    }
+    let ext;
+    if (options.js) {
+      ext = "js";
+    } else if (options.ts) {
+      ext = "ts";
+    } else {
+      const hasTsConfig = fs.existsSync(path.resolve(process.cwd(), "tsconfig.json"));
+      ext = hasTsConfig ? "ts" : "js";
+    }
+    const modulePath = options.path ? path.resolve(process.cwd(), options.path) : path.resolve(process.cwd(), `src/modules/${name}`);
+    if (fs.existsSync(modulePath)) {
+      console.error(pc.red(`
+Error: The directory "${modulePath}" already exists. Cannot scaffold module here.
+`));
+      process.exit(1);
+    }
+    fs.mkdirSync(modulePath, { recursive: true });
+    const files = {
+      [`index.${ext}`]: generateIndex(name),
+      [`${name}.routes.${ext}`]: generateRoutes(name),
+      [`${name}.service.${ext}`]: generateService(name)
+    };
+    if (options.repository) {
+      files[`${name}.repository.${ext}`] = generateRepository(name);
+    }
+    if (options.schema) {
+      files[`${name}.schema.${ext}`] = generateSchema(name);
+    }
+    for (const [filename, content] of Object.entries(files)) {
+      fs.writeFileSync(path.join(modulePath, filename), content.trim() + "\n", "utf-8");
+    }
+    console.log(pc.green(`
+\u2714 Module '${name}' created successfully at ${path.relative(process.cwd(), modulePath)}/`));
+    for (const filename of Object.keys(files)) {
+      console.log(`  ${pc.cyan(filename)}`);
+    }
+    console.log(`
+Next step: add '${name}' to the imports array of modules that require it.
+`);
+  });
+}
+function generateIndex(name) {
+  return `
+import { Module } from '@vlynk-studios/nodulus-core'
+
+Module('${name}', {
+  imports: [],
+  exports: [],
+})
+`;
+}
+function generateRoutes(name) {
+  return `
+import { Controller } from '@vlynk-studios/nodulus-core'
+import { Router } from 'express'
+
+Controller('/${name}')
+
+const router = Router()
+
+// Add your routes here
+// router.get('/', (req, res) => { ... })
+
+export default router
+`;
+}
+function generateService(name) {
+  const capName = name.charAt(0).toUpperCase() + name.slice(1);
+  return `
+import { Service } from '@vlynk-studios/nodulus-core'
+
+Service('${capName}Service', { module: '${name}' })
+
+export class ${capName}Service {
+  // Business logic here
+}
+`;
+}
+function generateRepository(name) {
+  const capName = name.charAt(0).toUpperCase() + name.slice(1);
+  return `
+import { Repository } from '@vlynk-studios/nodulus-core'
+
+Repository('${capName}Repository', { module: '${name}', source: 'database' })
+
+export class ${capName}Repository {
+  // Database queries here
+}
+`;
+}
+function generateSchema(name) {
+  const capName = name.charAt(0).toUpperCase() + name.slice(1);
+  return `
+import { Schema } from '@vlynk-studios/nodulus-core'
+
+// import { z } from 'zod' // Uncomment and install your preferred validation library
+Schema('${capName}Schema', { module: '${name}' })
+
+// export const create${capName}Schema = z.object({
+//   // Define your schema here
+// })
+`;
+}
+
+// src/cli/commands/sync-tsconfig.ts
+import { Command as Command2 } from "commander";
+import fs3 from "fs";
+import path3 from "path";
+import pc3 from "picocolors";
+import fg from "fast-glob";
+import { parse, stringify } from "comment-json";
+
+// src/core/config.ts
+import fs2 from "fs";
+import path2 from "path";
+import { pathToFileURL } from "url";
+
+// src/core/logger.ts
+import pc2 from "picocolors";
+var LEVEL_STYLE = {
+  debug: (msg) => pc2.gray(msg),
+  info: (msg) => pc2.cyan(msg),
+  warn: (msg) => pc2.yellow(msg),
+  error: (msg) => pc2.red(msg)
+};
+var LEVEL_LABELS = {
+  debug: "debug",
+  info: "info ",
+  // trailing space for alignment
+  warn: "warn ",
+  error: "error"
+};
+var defaultLogHandler = (level, message) => {
+  const prefix = pc2.gray("[Nodulus]");
+  const label = LEVEL_STYLE[level](LEVEL_LABELS[level]);
+  const line = `${prefix} ${label} ${message}`;
+  if (level === "warn" || level === "error") {
+    process.stderr.write(line + "\n");
+  } else {
+    process.stdout.write(line + "\n");
+  }
+};
+function resolveLogLevel(explicit) {
+  if (explicit) return explicit;
+  const nodeDebug = process.env.NODE_DEBUG ?? "";
+  if (nodeDebug.split(",").map((s) => s.trim()).includes("nodulus")) {
+    return "debug";
+  }
+  return "info";
+}
+
+// src/core/config.ts
+var defaultStrict = typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
+var DEFAULTS = {
+  modules: "src/modules/*",
+  prefix: "",
+  aliases: {},
+  strict: defaultStrict,
+  resolveAliases: true,
+  logger: defaultLogHandler,
+  logLevel: resolveLogLevel()
+};
+var loadConfig = async (options = {}) => {
+  const cwd = process.cwd();
+  let fileConfig = {};
+  const tsPath = path2.join(cwd, "nodulus.config.ts");
+  const jsPath = path2.join(cwd, "nodulus.config.js");
+  const isProduction = process.env.NODE_ENV === "production";
+  const hasTsLoader = process.execArgv.some((arg) => arg.includes("ts-node") || arg.includes("tsx")) || process._preload_modules?.some((m) => m.includes("ts-node") || m.includes("tsx"));
+  const candidates = [];
+  if (!isProduction || hasTsLoader) {
+    candidates.push(tsPath);
+  }
+  candidates.push(jsPath);
+  let configPathToLoad = null;
+  for (const candidate of candidates) {
+    if (fs2.existsSync(candidate)) {
+      configPathToLoad = candidate;
+      break;
+    }
+  }
+  if (configPathToLoad) {
+    try {
+      const importUrl = pathToFileURL(configPathToLoad).href;
+      const mod = await import(importUrl);
+      fileConfig = mod.default || mod.config || mod;
+    } catch (error) {
+      if (configPathToLoad.endsWith(".ts") && error.code === "ERR_UNKNOWN_FILE_EXTENSION") {
+        throw new Error(
+          `[Nodulus] Found "nodulus.config.ts" but your environment cannot load raw TypeScript files.
+  - In production: Run "npm run build" to generate a .js config OR use nodulus.config.js.
+  - In development: Ensure you are running with a loader like "tsx" or "ts-node".`,
+          { cause: error }
+        );
+      }
+      throw new Error(`[Nodulus] Failed to parse or evaluate config file at ${configPathToLoad}: ${error.message}`, { cause: error });
+    }
+  }
+  return {
+    modules: options.modules ?? fileConfig.modules ?? DEFAULTS.modules,
+    prefix: options.prefix ?? fileConfig.prefix ?? DEFAULTS.prefix,
+    aliases: {
+      ...DEFAULTS.aliases,
+      ...fileConfig.aliases || {},
+      ...options.aliases || {}
+      // Options override file aliases
+    },
+    strict: options.strict ?? fileConfig.strict ?? DEFAULTS.strict,
+    resolveAliases: options.resolveAliases ?? fileConfig.resolveAliases ?? DEFAULTS.resolveAliases,
+    logger: options.logger ?? fileConfig.logger ?? DEFAULTS.logger,
+    logLevel: resolveLogLevel(options.logLevel ?? fileConfig.logLevel)
+  };
+};
+
+// src/cli/commands/sync-tsconfig.ts
+function syncTsconfigCommand() {
+  return new Command2("sync-tsconfig").description("Syncs Nodulus aliases into tsconfig.json paths array for IDE support").option("--tsconfig <path>", "Path to tsconfig.json", "tsconfig.json").action(async (options) => {
+    try {
+      const cwd = process.cwd();
+      const configPath = path3.resolve(cwd, options.tsconfig);
+      if (!fs3.existsSync(configPath)) {
+        console.error(pc3.red(`
+Error: Could not find ${options.tsconfig} at ${configPath}
+`));
+        process.exit(1);
+      }
+      const config = await loadConfig();
+      const globPattern = config.modules.replace(/\\/g, "/");
+      const moduleDirs = await fg(globPattern, {
+        onlyDirectories: true,
+        absolute: true,
+        cwd
+      });
+      moduleDirs.sort();
+      const pathsObj = {};
+      for (const dirPath of moduleDirs) {
+        const modName = path3.basename(dirPath);
+        const aliasKey = `@modules/${modName}`;
+        let indexPath = path3.join(dirPath, "index.ts");
+        if (!fs3.existsSync(indexPath)) {
+          indexPath = path3.join(dirPath, "index.js");
+        }
+        let relativePosixPath = path3.relative(cwd, indexPath).replace(/\\/g, "/");
+        if (!relativePosixPath.startsWith("./") && !relativePosixPath.startsWith("../")) {
+          relativePosixPath = "./" + relativePosixPath;
+        }
+        pathsObj[aliasKey] = [relativePosixPath];
+      }
+      if (config.aliases) {
+        for (const [alias, target] of Object.entries(config.aliases)) {
+          let relativePosixPath = path3.isAbsolute(target) ? path3.relative(cwd, target) : target;
+          relativePosixPath = relativePosixPath.replace(/\\/g, "/");
+          if (!relativePosixPath.startsWith("./") && !relativePosixPath.startsWith("../")) {
+            relativePosixPath = "./" + relativePosixPath;
+          }
+          const key = alias.endsWith("/*") ? alias : `${alias}/*`;
+          const val = relativePosixPath.endsWith("/*") ? relativePosixPath : `${relativePosixPath}/*`;
+          pathsObj[key] = [val];
+        }
+      }
+      const rawContent = fs3.readFileSync(configPath, "utf8");
+      const tsconfig = parse(rawContent);
+      if (!tsconfig.compilerOptions) {
+        tsconfig.compilerOptions = {};
+      }
+      if (!tsconfig.compilerOptions.paths) {
+        tsconfig.compilerOptions.paths = {};
+      }
+      for (const key of Object.keys(tsconfig.compilerOptions.paths)) {
+        const val = tsconfig.compilerOptions.paths[key];
+        if (key.startsWith("@modules/") && !pathsObj[key]) {
+          delete tsconfig.compilerOptions.paths[key];
+        } else if (!pathsObj[key] && key.endsWith("/*") && Array.isArray(val) && val.length === 1 && typeof val[0] === "string" && (val[0].startsWith("./") || val[0].startsWith("../")) && val[0].endsWith("/*")) {
+          delete tsconfig.compilerOptions.paths[key];
+        }
+      }
+      Object.assign(tsconfig.compilerOptions.paths, pathsObj);
+      const sortedPaths = {};
+      Object.keys(tsconfig.compilerOptions.paths).sort().forEach((k) => {
+        sortedPaths[k] = tsconfig.compilerOptions.paths[k];
+      });
+      tsconfig.compilerOptions.paths = sortedPaths;
+      fs3.writeFileSync(configPath, stringify(tsconfig, null, 2) + "\n", "utf8");
+      const moduleCount = Object.keys(pathsObj).filter((k) => k.startsWith("@modules/")).length;
+      const aliasCount = Object.keys(pathsObj).length - moduleCount;
+      console.log(pc3.green(`
+\u2714 tsconfig.json updated \u2014 ${moduleCount} module(s), ${aliasCount} folder alias(es)`));
+      console.log(`Added paths:`);
+      const maxKeyLength = Math.max(...Object.keys(pathsObj).map((k) => k.length));
+      for (const [key, paths] of Object.entries(pathsObj)) {
+        const paddedKey = key.padEnd(maxKeyLength);
+        console.log(`  ${pc3.cyan(paddedKey)}  \u2192 ${paths[0]}`);
+      }
+      console.log("");
+    } catch (err) {
+      console.error(pc3.red(`
+Error synchronizing tsconfig: ${err.message}
+`));
+      process.exit(1);
+    }
+  });
+}
+
+// src/cli/index.ts
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+var pkg = require2("../../package.json");
+var program = new Command3();
+program.name("nodulus").description("Nodulus CLI").version(pkg.version);
+program.addCommand(createModuleCommand());
+program.addCommand(syncTsconfigCommand());
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/index.ts","../../src/cli/commands/create-module.ts","../../src/cli/commands/sync-tsconfig.ts","../../src/core/config.ts","../../src/core/logger.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from 'commander'\nimport { createModuleCommand } from './commands/create-module.js'\nimport { syncTsconfigCommand } from './commands/sync-tsconfig.js'\n\nimport { createRequire } from 'node:module';\n\nconst require = createRequire(import.meta.url);\nconst pkg = require('../../package.json');\n\nconst program = new Command()\nprogram.name('nodulus').description('Nodulus CLI').version(pkg.version)\nprogram.addCommand(createModuleCommand())\nprogram.addCommand(syncTsconfigCommand())\n\nprogram.parse()\n","import { Command } from 'commander';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport pc from 'picocolors';\n\nexport function createModuleCommand() {\n  return new Command('create-module')\n    .description('Scaffolds a new Nodulus module')\n    .argument('<name>', 'Module name (lowercase, no spaces/special chars)')\n    .option('-p, --path <path>', 'Destination folder path (default: src/modules/<name>)')\n    .option('--no-repository', 'Skip generating a repository file')\n    .option('--no-schema', 'Skip generating a schema file')\n    .option('--js', 'Force generate JavaScript (.js) files')\n    .option('--ts', 'Force generate TypeScript (.ts) files')\n    .action((name: string, options: { path?: string; repository: boolean; schema: boolean; js?: boolean; ts?: boolean }) => {\n      if (!/^[a-z0-9-]+$/.test(name)) {\n        console.error(pc.red(`\\nError: Invalid module name \"${name}\". Module names must be lowercase and contain only letters, numbers, or hyphens.\\n`));\n        process.exit(1);\n      }\n\n      // Detect language extension\n      let ext: string;\n      if (options.js) {\n        ext = 'js';\n      } else if (options.ts) {\n        ext = 'ts';\n      } else {\n        // Auto-detect typescript project\n        const hasTsConfig = fs.existsSync(path.resolve(process.cwd(), 'tsconfig.json'));\n        ext = hasTsConfig ? 'ts' : 'js';\n      }\n\n      const modulePath = options.path ? path.resolve(process.cwd(), options.path) : path.resolve(process.cwd(), `src/modules/${name}`);\n\n      if (fs.existsSync(modulePath)) {\n        console.error(pc.red(`\\nError: The directory \"${modulePath}\" already exists. Cannot scaffold module here.\\n`));\n        process.exit(1);\n      }\n\n      fs.mkdirSync(modulePath, { recursive: true });\n\n      const files: Record<string, string> = {\n        [`index.${ext}`]: generateIndex(name),\n        [`${name}.routes.${ext}`]: generateRoutes(name),\n        [`${name}.service.${ext}`]: generateService(name),\n      };\n\n      if (options.repository) {\n        files[`${name}.repository.${ext}`] = generateRepository(name);\n      }\n      \n      if (options.schema) {\n        files[`${name}.schema.${ext}`] = generateSchema(name);\n      }\n\n      for (const [filename, content] of Object.entries(files)) {\n        fs.writeFileSync(path.join(modulePath, filename), content.trim() + '\\n', 'utf-8');\n      }\n\n      console.log(pc.green(`\\n✔ Module '${name}' created successfully at ${path.relative(process.cwd(), modulePath)}/`));\n      for (const filename of Object.keys(files)) {\n        console.log(`  ${pc.cyan(filename)}`);\n      }\n      console.log(`\\nNext step: add '${name}' to the imports array of modules that require it.\\n`);\n    });\n}\n\nfunction generateIndex(name: string): string {\n  return `\nimport { Module } from '@vlynk-studios/nodulus-core'\n\nModule('${name}', {\n  imports: [],\n  exports: [],\n})\n`;\n}\n\nfunction generateRoutes(name: string): string {\n  return `\nimport { Controller } from '@vlynk-studios/nodulus-core'\nimport { Router } from 'express'\n\nController('/${name}')\n\nconst router = Router()\n\n// Add your routes here\n// router.get('/', (req, res) => { ... })\n\nexport default router\n`;\n}\n\nfunction generateService(name: string): string {\n  const capName = name.charAt(0).toUpperCase() + name.slice(1);\n  return `\nimport { Service } from '@vlynk-studios/nodulus-core'\n\nService('${capName}Service', { module: '${name}' })\n\nexport class ${capName}Service {\n  // Business logic here\n}\n`;\n}\n\nfunction generateRepository(name: string): string {\n  const capName = name.charAt(0).toUpperCase() + name.slice(1);\n  return `\nimport { Repository } from '@vlynk-studios/nodulus-core'\n\nRepository('${capName}Repository', { module: '${name}', source: 'database' })\n\nexport class ${capName}Repository {\n  // Database queries here\n}\n`;\n}\n\nfunction generateSchema(name: string): string {\n  const capName = name.charAt(0).toUpperCase() + name.slice(1);\n  return `\nimport { Schema } from '@vlynk-studios/nodulus-core'\n\n// import { z } from 'zod' // Uncomment and install your preferred validation library\nSchema('${capName}Schema', { module: '${name}' })\n\n// export const create${capName}Schema = z.object({\n//   // Define your schema here\n// })\n`;\n}\n","import { Command } from 'commander';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport pc from 'picocolors';\nimport fg from 'fast-glob';\nimport { parse, stringify } from 'comment-json';\nimport { loadConfig } from '../../core/config.js';\n\nexport function syncTsconfigCommand() {\n  return new Command('sync-tsconfig')\n    .description('Syncs Nodulus aliases into tsconfig.json paths array for IDE support')\n    .option('--tsconfig <path>', 'Path to tsconfig.json', 'tsconfig.json')\n    .action(async (options: { tsconfig: string }) => {\n      try {\n        const cwd = process.cwd();\n        const configPath = path.resolve(cwd, options.tsconfig);\n\n        if (!fs.existsSync(configPath)) {\n          console.error(pc.red(`\\nError: Could not find ${options.tsconfig} at ${configPath}\\n`));\n          process.exit(1);\n        }\n\n        // 1. Load Nodulus config\n        const config = await loadConfig();\n\n        // 2. Scan module glob to find discovered modules\n        const globPattern = config.modules.replace(/\\\\/g, '/');\n        const moduleDirs = await fg(globPattern, {\n          onlyDirectories: true,\n          absolute: true,\n          cwd\n        });\n\n        moduleDirs.sort();\n\n        // 3. Build paths mapping object\n        const pathsObj: Record<string, string[]> = {};\n\n        // 3a. Register built-in module aliases\n        for (const dirPath of moduleDirs) {\n          const modName = path.basename(dirPath);\n          const aliasKey = `@modules/${modName}`;\n          \n          let indexPath = path.join(dirPath, 'index.ts');\n          if (!fs.existsSync(indexPath)) {\n            indexPath = path.join(dirPath, 'index.js');\n          }\n\n          // Use posix separated paths\n          let relativePosixPath = path.relative(cwd, indexPath).replace(/\\\\/g, '/');\n          if (!relativePosixPath.startsWith('./') && !relativePosixPath.startsWith('../')) {\n            relativePosixPath = './' + relativePosixPath;\n          }\n          \n          pathsObj[aliasKey] = [relativePosixPath];\n        }\n\n        // 3b. Register folder/project aliases explicitly set in config\n        if (config.aliases) {\n          for (const [alias, target] of Object.entries(config.aliases)) {\n            let relativePosixPath = path.isAbsolute(target) ? path.relative(cwd, target) : target;\n            relativePosixPath = relativePosixPath.replace(/\\\\/g, '/');\n            if (!relativePosixPath.startsWith('./') && !relativePosixPath.startsWith('../')) {\n              relativePosixPath = './' + relativePosixPath;\n            }\n\n            // Append /* for standard TypeScript folder completion mapping\n            const key = alias.endsWith('/*') ? alias : `${alias}/*`;\n            const val = relativePosixPath.endsWith('/*') ? relativePosixPath : `${relativePosixPath}/*`;\n            \n            pathsObj[key] = [val];\n          }\n        }\n\n        // 4. Update TS Config\n        const rawContent = fs.readFileSync(configPath, 'utf8');\n        const tsconfig = parse(rawContent) as any;\n\n        if (!tsconfig.compilerOptions) {\n          tsconfig.compilerOptions = {};\n        }\n\n        if (!tsconfig.compilerOptions.paths) {\n          tsconfig.compilerOptions.paths = {};\n        }\n\n        // 4a. Clean up stale Nodulus managed modules that were deleted\n        for (const key of Object.keys(tsconfig.compilerOptions.paths)) {\n          const val = tsconfig.compilerOptions.paths[key];\n          \n          if (key.startsWith('@modules/') && !pathsObj[key]) {\n            delete tsconfig.compilerOptions.paths[key];\n          } \n          // Check for stale config aliases using the Nodulus signature format\n          else if (\n            !pathsObj[key] &&\n            key.endsWith('/*') &&\n            Array.isArray(val) &&\n            val.length === 1 &&\n            typeof val[0] === 'string' &&\n            (val[0].startsWith('./') || val[0].startsWith('../')) &&\n            val[0].endsWith('/*')\n          ) {\n            delete tsconfig.compilerOptions.paths[key];\n          }\n        }\n\n        // Merge paths overwriting existing Nodulus-managed keys safely\n        Object.assign(tsconfig.compilerOptions.paths, pathsObj);\n\n        // Sort keys purely for visual aesthetics\n        const sortedPaths: Record<string, any> = {};\n        Object.keys(tsconfig.compilerOptions.paths)\n          .sort()\n          .forEach((k) => {\n            sortedPaths[k] = tsconfig.compilerOptions.paths[k];\n          });\n        \n        tsconfig.compilerOptions.paths = sortedPaths;\n\n        // 5. Save preserving comments\n        fs.writeFileSync(configPath, stringify(tsconfig, null, 2) + '\\n', 'utf8');\n\n        // 6. Pretty Output Calculation\n        const moduleCount = Object.keys(pathsObj).filter(k => k.startsWith('@modules/')).length;\n        const aliasCount = Object.keys(pathsObj).length - moduleCount;\n\n        console.log(pc.green(`\\n✔ tsconfig.json updated — ${moduleCount} module(s), ${aliasCount} folder alias(es)`));\n        console.log(`Added paths:`);\n        \n        // Find longest key for padding alignment\n        const maxKeyLength = Math.max(...Object.keys(pathsObj).map(k => k.length));\n        \n        for (const [key, paths] of Object.entries(pathsObj)) {\n          const paddedKey = key.padEnd(maxKeyLength);\n          console.log(`  ${pc.cyan(paddedKey)}  → ${paths[0]}`);\n        }\n        console.log('');\n      } catch (err: any) {\n        console.error(pc.red(`\\nError synchronizing tsconfig: ${err.message}\\n`));\n        process.exit(1);\n      }\n    });\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { CreateAppOptions, ResolvedConfig, NodulusConfig } from '../types/index.js';\nimport { defaultLogHandler, resolveLogLevel } from './logger.js';\n\nconst defaultStrict = typeof process !== 'undefined' && process.env?.NODE_ENV !== 'production';\n\nexport const DEFAULTS: ResolvedConfig = {\n  modules: 'src/modules/*',\n  prefix: '',\n  aliases: {},\n  strict: defaultStrict,\n  resolveAliases: true,\n  logger: defaultLogHandler,\n  logLevel: resolveLogLevel(),\n};\n\nexport const loadConfig = async (options: CreateAppOptions = {}): Promise<ResolvedConfig> => {\n  const cwd = process.cwd();\n  \n  let fileConfig: NodulusConfig = {};\n  \n  const tsPath = path.join(cwd, 'nodulus.config.ts');\n  const jsPath = path.join(cwd, 'nodulus.config.js');\n  \n  const isProduction = process.env.NODE_ENV === 'production';\n  const hasTsLoader = \n    process.execArgv.some(arg => arg.includes('ts-node') || arg.includes('tsx')) ||\n    (process as any)._preload_modules?.some((m: string) => m.includes('ts-node') || m.includes('tsx'));\n\n  // In production, only .js is tried by default.\n  // In development (or when a TS loader is detected), .ts is tried first.\n  const candidates: string[] = [];\n  \n  if (!isProduction || hasTsLoader) {\n    candidates.push(tsPath);\n  }\n  candidates.push(jsPath);\n\n  let configPathToLoad: string | null = null;\n\n  for (const candidate of candidates) {\n    if (fs.existsSync(candidate)) {\n      configPathToLoad = candidate;\n      break;\n    }\n  }\n\n  if (configPathToLoad) {\n    try {\n      const importUrl = pathToFileURL(configPathToLoad).href;\n      const mod = await import(importUrl);\n      fileConfig = mod.default || mod.config || mod;\n    } catch (error: any) {\n      if (configPathToLoad.endsWith('.ts') && error.code === 'ERR_UNKNOWN_FILE_EXTENSION') {\n        throw new Error(\n          `[Nodulus] Found \"nodulus.config.ts\" but your environment cannot load raw TypeScript files.\\n` +\n          `  - In production: Run \"npm run build\" to generate a .js config OR use nodulus.config.js.\\n` +\n          `  - In development: Ensure you are running with a loader like \"tsx\" or \"ts-node\".`,\n          { cause: error }\n        );\n      }\n      throw new Error(`[Nodulus] Failed to parse or evaluate config file at ${configPathToLoad}: ${error.message}`, { cause: error });\n    }\n  }\n\n  // Merge strategy: options > fileConfig > defaults\n  return {\n    modules: options.modules ?? fileConfig.modules ?? DEFAULTS.modules,\n    prefix: options.prefix ?? fileConfig.prefix ?? DEFAULTS.prefix,\n    aliases: {\n      ...DEFAULTS.aliases,\n      ...(fileConfig.aliases || {}),\n      ...(options.aliases || {}) // Options override file aliases\n    },\n    strict: options.strict ?? fileConfig.strict ?? DEFAULTS.strict,\n    resolveAliases: options.resolveAliases ?? fileConfig.resolveAliases ?? DEFAULTS.resolveAliases,\n    logger: options.logger ?? fileConfig.logger ?? DEFAULTS.logger,\n    logLevel: resolveLogLevel(options.logLevel ?? fileConfig.logLevel),\n  };\n};\n","import pc from 'picocolors';\nimport type { LogLevel, LogHandler } from '../types/index.js';\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 0,\n  info:  1,\n  warn:  2,\n  error: 3,\n};\n\nconst LEVEL_STYLE: Record<LogLevel, (msg: string) => string> = {\n  debug: (msg) => pc.gray(msg),\n  info:  (msg) => pc.cyan(msg),\n  warn:  (msg) => pc.yellow(msg),\n  error: (msg) => pc.red(msg),\n};\n\nconst LEVEL_LABELS: Record<LogLevel, string> = {\n  debug: 'debug',\n  info:  'info ', // trailing space for alignment\n  warn:  'warn ',\n  error: 'error',\n};\n\n/**\n * Default log handler. Writes to process.stdout (info/debug) or process.stderr (warn/error).\n * All lines are prefixed with [Nodulus].\n */\nexport const defaultLogHandler: LogHandler = (level, message) => {\n  const prefix = pc.gray('[Nodulus]');\n  const label = LEVEL_STYLE[level](LEVEL_LABELS[level]);\n  const line = `${prefix} ${label} ${message}`;\n  \n  if (level === 'warn' || level === 'error') {\n    process.stderr.write(line + '\\n');\n  } else {\n    process.stdout.write(line + '\\n');\n  }\n};\n\n/**\n * Resolves the effective minimum log level.\n * Priority: explicit logLevel option > NODE_DEBUG env var > default ('info').\n */\nexport function resolveLogLevel(explicit?: LogLevel): LogLevel {\n  if (explicit) return explicit;\n\n  const nodeDebug = process.env.NODE_DEBUG ?? '';\n  if (nodeDebug.split(',').map(s => s.trim()).includes('nodulus')) {\n    return 'debug';\n  }\n\n  return 'info';\n}\n\nexport interface Logger {\n  debug(message: string, meta?: Record<string, unknown>): void;\n  info(message:  string, meta?: Record<string, unknown>): void;\n  warn(message:  string, meta?: Record<string, unknown>): void;\n  error(message: string, meta?: Record<string, unknown>): void;\n}\n\n/**\n * Creates a bound logger that filters by minLevel and delegates to handler.\n * \n * @param handler  - Where log events are sent.\n * @param minLevel - Events below this level are discarded.\n */\nexport function createLogger(handler: LogHandler, minLevel: LogLevel): Logger {\n  const minOrder = LEVEL_ORDER[minLevel];\n\n  const emit = (level: LogLevel, message: string, meta?: Record<string, unknown>) => {\n    if (LEVEL_ORDER[level] >= minOrder) {\n      handler(level, message, meta);\n    }\n  };\n\n  return {\n    debug: (msg, meta) => emit('debug', msg, meta),\n    info:  (msg, meta) => emit('info',  msg, meta),\n    warn:  (msg, meta) => emit('warn',  msg, meta),\n    error: (msg, meta) => emit('error', msg, meta),\n  };\n}\n"],"mappings":"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","names":["Command","Command","fs","path","pc","fs","path","pc","pc","path","fs","Command","path","fs","pc","require","Command"]}

package/dist/index.d.ts

@@ -0,0 +1,267 @@
+import { RequestHandler, Router, Application } from 'express';
+
+interface ControllerEntry {
+    name: string;
+    path: string;
+    prefix: string;
+    middlewares: RequestHandler[];
+    router?: Router;
+    enabled: boolean;
+}
+interface ModuleEntry {
+    name: string;
+    path: string;
+    indexPath: string;
+    imports: string[];
+    exports: string[];
+    controllers: ControllerEntry[];
+}
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Function that receives a log event from Nodulus.
+ *
+ * @param level   - Severity level.
+ * @param message - Human-readable message.
+ * @param meta    - Optional structured data for machine consumption.
+ */
+type LogHandler = (level: LogLevel, message: string, meta?: Record<string, unknown>) => void;
+interface ModuleOptions {
+    /** Modules this module depends on. */
+    imports?: string[];
+    /**
+     * Names of exports that form the public API of this module.
+     * Nodulus validates that each name exists as a real export of index.ts.
+     * Error EXPORT_MISMATCH if a name is missing.
+     */
+    exports?: string[];
+    /** Description — for documentation and future tooling. */
+    description?: string;
+}
+interface ControllerOptions {
+    /** Middlewares applied to all routes. Mounted before the router. Default: []. */
+    middlewares?: RequestHandler[];
+    /** If false, createApp() ignores this controller entirely. Default: true. */
+    enabled?: boolean;
+}
+interface ServiceOptions {
+    /** The module this service belongs to. If omitted, inferred from the file's parent folder name. */
+    module?: string;
+    /** Description — for documentation and future tooling. */
+    description?: string;
+}
+interface RepositoryOptions {
+    /** The module this repository belongs to. If omitted, inferred from the file's parent folder name. */
+    module?: string;
+    /** Description — for documentation and future tooling. */
+    description?: string;
+    /** Data source type this repository talks to. */
+    source?: 'database' | 'api' | 'cache' | 'file' | string;
+}
+/** Internal registry entry for a registered service. */
+interface ServiceEntry {
+    name: string;
+    path: string;
+    type: 'service';
+    module: string;
+    description?: string;
+}
+/** Internal registry entry for a registered repository. */
+interface RepositoryEntry {
+    name: string;
+    path: string;
+    type: 'repository';
+    module: string;
+    description?: string;
+    source?: string;
+}
+interface SchemaOptions {
+    /** The module this schema belongs to. If omitted, inferred from the file's parent folder name. */
+    module?: string;
+    /** Description — for documentation and future tooling. */
+    description?: string;
+    /** Validation library used to define this schema. */
+    library?: 'zod' | 'joi' | 'yup' | 'ajv' | string;
+}
+/** Internal registry entry for a registered schema. */
+interface SchemaEntry {
+    name: string;
+    path: string;
+    type: 'schema';
+    module: string;
+    description?: string;
+    library?: string;
+}
+/** Discriminated union for all file-level identifier entries. */
+type FileEntry = ServiceEntry | RepositoryEntry | SchemaEntry;
+interface CreateAppOptions {
+    /** Glob pointing to module folders. Default: 'src/modules/*'. */
+    modules?: string;
+    /** Global route prefix. Example: '/api/v1'. Default: ''. */
+    prefix?: string;
+    /** Folder aliases beyond the auto-generated @modules/* entries. Default: {}. */
+    aliases?: Record<string, string>;
+    /**
+     * Enables circular dependency detection and undeclared import errors.
+     * Default: true in development, false in production.
+     */
+    strict?: boolean;
+    /**
+     * If false, the runtime ESM alias hook is not activated.
+     * Useful when the project resolves aliases via a bundler. Default: true.
+     */
+    resolveAliases?: boolean;
+    /**
+     * Custom log handler. Receives all Nodulus log events.
+     *
+     * Default: prints [Nodulus] prefixed messages to stderr (warn/error)
+     * and stdout (info). debug is suppressed unless NODE_DEBUG includes 'nodulus'.
+     */
+    logger?: LogHandler;
+    /**
+     * Minimum log level. Events below this level are not passed to the handler.
+     * Default: 'info' (debug is off unless explicitly set).
+     */
+    logLevel?: LogLevel;
+}
+/** Resolved configuration used internally (defaults applied). */
+interface ResolvedConfig {
+    modules: string;
+    prefix: string;
+    aliases: Record<string, string>;
+    strict: boolean;
+    resolveAliases: boolean;
+    logger: LogHandler;
+    logLevel: LogLevel;
+}
+/** A module as it appears in the NodularApp result after bootstrap. */
+interface RegisteredModule {
+    name: string;
+    path: string;
+    imports: string[];
+    exports: string[];
+    controllers: string[];
+}
+interface MountedRoute {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'USE';
+    path: string;
+    module: string;
+    controller: string;
+}
+/** Stable registry interface — guaranteed across minor versions. */
+interface NodulusRegistry {
+    hasModule(name: string): boolean;
+    getModule(name: string): RegisteredModule | undefined;
+    getAllModules(): RegisteredModule[];
+    resolveAlias(alias: string): string | undefined;
+    getAllAliases(): Record<string, string>;
+}
+/**
+ * Advanced registry interface — exposes internal graph utilities.
+ * @unstable May change between minor versions.
+ */
+interface NodulusRegistryAdvanced extends NodulusRegistry {
+    /** @unstable */
+    getDependencyGraph(): Map<string, string[]>;
+    /** @unstable */
+    findCircularDependencies(): string[][];
+}
+/** Value returned by createApp() after a successful bootstrap. */
+interface NodulusApp {
+    modules: RegisteredModule[];
+    routes: MountedRoute[];
+    registry: NodulusRegistry;
+}
+/** Shape of nodulus.config.ts. Options passed directly to createApp() take priority. */
+type NodulusConfig = CreateAppOptions;
+interface GetAliasesOptions {
+    /**
+     * If false, only returns auto-generated @modules/* aliases.
+     * Config-defined folder aliases (from nodulus.config.ts `aliases`) are excluded.
+     * Default: true (returns all aliases).
+     */
+    includeFolders?: boolean;
+    /** If true, returns absolute paths. Default: false. */
+    absolute?: boolean;
+}
+
+/**
+ * Returns a read-only view of the registry active in the current async context.
+ *
+ * @unstable This function is intended for advanced framework integrations or
+ * internal debugging. The structure of the returned registry may change in future
+ * minor updates. For standard use cases, rely on the properties returned by `createApp()`.
+ */
+declare const getRegistry: () => NodulusRegistryAdvanced;
+
+type NodulusErrorCode = "MODULE_NOT_FOUND" | "DUPLICATE_MODULE" | "MISSING_IMPORT" | "UNDECLARED_IMPORT" | "CIRCULAR_DEPENDENCY" | "EXPORT_MISMATCH" | "INVALID_CONTROLLER" | "ALIAS_NOT_FOUND" | "DUPLICATE_ALIAS" | "DUPLICATE_BOOTSTRAP" | "REGISTRY_MISSING_CONTEXT" | "INVALID_MODULE_DECLARATION" | "DUPLICATE_SERVICE" | "DUPLICATE_REPOSITORY" | "DUPLICATE_SCHEMA" | "INVALID_ESM_ENV";
+declare class NodulusError extends Error {
+    readonly code: NodulusErrorCode;
+    readonly details?: string;
+    constructor(code: NodulusErrorCode, message: string, details?: string);
+}
+/** @deprecated — not used internally. Messages are defined at each throw site. */
+declare const ERROR_MESSAGES: Record<NodulusErrorCode, string>;
+
+declare function Module(name: string, options?: ModuleOptions): void;
+
+declare function Controller(prefix: string, options?: ControllerOptions): void;
+
+/**
+ * Declares a file as a named service and registers it in the Nodulus registry.
+ *
+ * The `module` field is inferred from the parent folder name when not provided explicitly.
+ *
+ * @param name    - Unique service name within the registry (e.g. 'UserService').
+ * @param options - Optional configuration: module override and description.
+ *
+ * @example
+ * // src/modules/users/users.service.ts
+ * import { Service } from 'nodulus'
+ *
+ * Service('UserService', { module: 'users' })
+ *
+ * export const UserService = { ... }
+ */
+declare function Service(name: string, options?: ServiceOptions): void;
+
+/**
+ * Declares a file as a named repository and registers it in the Nodulus registry.
+ *
+ * The `module` field is inferred from the parent folder name when not provided explicitly.
+ *
+ * @param name    - Unique repository name within the registry (e.g. 'UserRepository').
+ * @param options - Optional configuration: module override, description, and data source type.
+ *
+ * @example
+ * // src/modules/users/users.repository.ts
+ * import { Repository } from 'nodulus'
+ *
+ * Repository('UserRepository', { module: 'users', source: 'database' })
+ *
+ * export const UserRepository = { ... }
+ */
+declare function Repository(name: string, options?: RepositoryOptions): void;
+
+/**
+ * Declares a file as a named validation schema and registers it in the Nodulus registry.
+ *
+ * The `module` field is inferred from the parent folder name when not provided explicitly.
+ *
+ * @param name    - Unique schema name within the registry (e.g. 'CreateUserSchema').
+ * @param options - Optional configuration: module override, description, and validation library.
+ *
+ * @example
+ * // src/modules/users/users.schema.ts
+ * import { Schema } from 'nodulus'
+ *
+ * Schema('CreateUserSchema', { module: 'users', library: 'zod' })
+ *
+ * export const CreateUserSchema = z.object({ ... })
+ */
+declare function Schema(name: string, options?: SchemaOptions): void;
+
+declare function createApp(app: Application, options?: CreateAppOptions): Promise<NodulusApp>;
+
+declare function getAliases(options?: GetAliasesOptions): Promise<Record<string, string>>;
+
+export { Controller, type ControllerEntry, type ControllerOptions, type CreateAppOptions, ERROR_MESSAGES, type FileEntry, type GetAliasesOptions, type LogHandler, type LogLevel, Module, type ModuleEntry, type ModuleOptions, type MountedRoute, type NodulusApp, type NodulusConfig, NodulusError, type NodulusErrorCode, type NodulusRegistry, type NodulusRegistryAdvanced, type RegisteredModule, Repository, type RepositoryEntry, type RepositoryOptions, type ResolvedConfig, Schema, type SchemaEntry, type SchemaOptions, Service, type ServiceEntry, type ServiceOptions, createApp, getAliases, getRegistry };