@solid-stack/mason 1.0.11 → 1.0.12

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var fs3 = require('fs');
-var path7 = require('path');
+var path3 = require('path');
 var p4 = require('@clack/prompts');
 var pc13 = require('picocolors');
 var url = require('url');
@@ -31,7 +31,7 @@ function _interopNamespace(e) {
 }
 
 var fs3__default = /*#__PURE__*/_interopDefault(fs3);
-var path7__default = /*#__PURE__*/_interopDefault(path7);
+var path3__default = /*#__PURE__*/_interopDefault(path3);
 var p4__namespace = /*#__PURE__*/_interopNamespace(p4);
 var pc13__default = /*#__PURE__*/_interopDefault(pc13);
 var Handlebars__default = /*#__PURE__*/_interopDefault(Handlebars);
@@ -104,7 +104,7 @@ function isValidIdentifier(str) {
 }
 function writeFileSafely(absolutePath, content, options = {}) {
   const projectRoot = options.projectRoot || process.cwd();
-  const relPath = path7__default.default.relative(projectRoot, absolutePath).replace(/\\/g, "/");
+  const relPath = path3__default.default.relative(projectRoot, absolutePath).replace(/\\/g, "/");
   const existedBefore = fs3__default.default.existsSync(absolutePath);
   if (options.dryRun) {
     return {
@@ -124,7 +124,7 @@ function writeFileSafely(absolutePath, content, options = {}) {
       existedBefore: true
     };
   }
-  const dir = path7__default.default.dirname(absolutePath);
+  const dir = path3__default.default.dirname(absolutePath);
   if (!fs3__default.default.existsSync(dir)) {
     fs3__default.default.mkdirSync(dir, { recursive: true });
   }
@@ -155,20 +155,20 @@ function printGeneratedFiles(files, isDryRun = false) {
   }
 }
 function findProjectRoot(startDir = process.cwd()) {
-  let current = path7__default.default.resolve(startDir);
+  let current = path3__default.default.resolve(startDir);
   while (true) {
-    if (fs3__default.default.existsSync(path7__default.default.join(current, "package.json"))) {
+    if (fs3__default.default.existsSync(path3__default.default.join(current, "package.json"))) {
       return current;
     }
-    const parent = path7__default.default.dirname(current);
+    const parent = path3__default.default.dirname(current);
     if (parent === current) {
-      return path7__default.default.resolve(startDir);
+      return path3__default.default.resolve(startDir);
     }
     current = parent;
   }
 }
 function resolveFeaturesDir(projectRoot) {
-  return path7__default.default.join(projectRoot, "features");
+  return path3__default.default.join(projectRoot, "features");
 }
 function listExistingFeatures(projectRoot) {
   const featuresDir = resolveFeaturesDir(projectRoot);
@@ -184,14 +184,14 @@ function listDomainInterfaces(projectRoot, featureName) {
   const results = [];
   const features = featureName ? [featureName] : listExistingFeatures(projectRoot);
   for (const feat of features) {
-    const domainDir = path7__default.default.join(resolveFeaturesDir(projectRoot), feat, "domain");
+    const domainDir = path3__default.default.join(resolveFeaturesDir(projectRoot), feat, "domain");
     if (!fs3__default.default.existsSync(domainDir)) continue;
     try {
       const files = fs3__default.default.readdirSync(domainDir);
       for (const file of files) {
         if (file.endsWith(".ts") && !file.endsWith(".test.ts") && !file.endsWith(".d.ts")) {
           const name = file.replace(/\.ts$/, "");
-          const fullPath = path7__default.default.join(domainDir, file);
+          const fullPath = path3__default.default.join(domainDir, file);
           if (/^I[A-Z]/.test(name)) {
             results.push({
               name,
@@ -222,7 +222,7 @@ function listDomainEntities(projectRoot, featureName) {
   const results = [];
   const features = featureName ? [featureName] : listExistingFeatures(projectRoot);
   for (const feat of features) {
-    const domainDir = path7__default.default.join(resolveFeaturesDir(projectRoot), feat, "domain");
+    const domainDir = path3__default.default.join(resolveFeaturesDir(projectRoot), feat, "domain");
     if (!fs3__default.default.existsSync(domainDir)) continue;
     try {
       const files = fs3__default.default.readdirSync(domainDir);
@@ -232,7 +232,7 @@ function listDomainEntities(projectRoot, featureName) {
           if (!/^I[A-Z]/.test(name)) {
             results.push({
               name,
-              fullPath: path7__default.default.join(domainDir, file),
+              fullPath: path3__default.default.join(domainDir, file),
               feature: feat
             });
           }
@@ -247,7 +247,7 @@ function listUseCases(projectRoot, featureName) {
   const results = [];
   const features = featureName ? [featureName] : listExistingFeatures(projectRoot);
   for (const feat of features) {
-    const useCasesDir = path7__default.default.join(resolveFeaturesDir(projectRoot), feat, "useCases");
+    const useCasesDir = path3__default.default.join(resolveFeaturesDir(projectRoot), feat, "useCases");
     if (!fs3__default.default.existsSync(useCasesDir)) continue;
     try {
       const files = fs3__default.default.readdirSync(useCasesDir);
@@ -256,7 +256,7 @@ function listUseCases(projectRoot, featureName) {
           const name = file.replace(/\.ts$/, "");
           results.push({
             name,
-            fullPath: path7__default.default.join(useCasesDir, file),
+            fullPath: path3__default.default.join(useCasesDir, file),
             feature: feat
           });
         }
@@ -352,40 +352,105 @@ async function promptProperties(options = {}) {
   return properties;
 }
 var DEFAULT_REGISTRY_BASE = "https://raw.githubusercontent.com/solid-stack-digital/mason-registry/main";
+function normalizeRegistryUrl(urlOrPath, baseDir) {
+  let trimmed = urlOrPath.trim();
+  const gitSshRegex = /^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/;
+  const sshMatch = trimmed.match(gitSshRegex);
+  if (sshMatch && sshMatch[1] && sshMatch[2]) {
+    return `https://raw.githubusercontent.com/${sshMatch[1]}/${sshMatch[2]}/main`;
+  }
+  const githubWebRegex = /^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:\/tree\/([^/]+))?\/?$/;
+  const webMatch = trimmed.match(githubWebRegex);
+  if (webMatch && webMatch[1] && webMatch[2]) {
+    const owner = webMatch[1];
+    const repo = webMatch[2];
+    const branch = webMatch[3] || "main";
+    return `https://raw.githubusercontent.com/${owner}/${repo}/${branch}`;
+  }
+  if (baseDir && (trimmed.startsWith("./") || trimmed.startsWith("../") || trimmed === "." || trimmed === "..")) {
+    return path3__default.default.resolve(baseDir, trimmed);
+  }
+  return trimmed;
+}
+function findLocalRegistry(startDir = process.cwd()) {
+  let current = path3__default.default.resolve(startDir);
+  while (true) {
+    const candidate = path3__default.default.join(current, "mason-registry");
+    if (fs3__default.default.existsSync(candidate) && fs3__default.default.existsSync(path3__default.default.join(candidate, "index.json"))) {
+      return candidate;
+    }
+    const parent = path3__default.default.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return null;
+}
 function getRegistryBase(projectRoot, override) {
+  const rootDir = projectRoot ? path3__default.default.resolve(projectRoot) : process.cwd();
   if (override && override.trim()) {
-    return override.trim();
+    return normalizeRegistryUrl(override.trim(), rootDir);
   }
   if (process.env.MASON_REGISTRY_URL && process.env.MASON_REGISTRY_URL.trim()) {
-    return process.env.MASON_REGISTRY_URL.trim();
+    return normalizeRegistryUrl(process.env.MASON_REGISTRY_URL.trim(), rootDir);
   }
-  if (projectRoot) {
-    const configPath = path7__default.default.join(projectRoot, "mason.config.json");
+  const configLocations = [
+    path3__default.default.join(rootDir, "mason.config.json"),
+    path3__default.default.join(process.cwd(), "mason.config.json")
+  ];
+  for (const configPath of configLocations) {
     if (fs3__default.default.existsSync(configPath)) {
       try {
         const config = JSON.parse(fs3__default.default.readFileSync(configPath, "utf-8"));
         if (config.registry && typeof config.registry === "string") {
-          return config.registry.trim();
+          return normalizeRegistryUrl(config.registry.trim(), path3__default.default.dirname(configPath));
         }
       } catch {
       }
     }
   }
-  if (projectRoot) {
-    const siblingRegistry = path7__default.default.resolve(projectRoot, "../mason-registry");
-    if (fs3__default.default.existsSync(siblingRegistry) && fs3__default.default.existsSync(path7__default.default.join(siblingRegistry, "index.json"))) {
-      return siblingRegistry;
+  const pkgLocations = [
+    path3__default.default.join(rootDir, "package.json"),
+    path3__default.default.join(process.cwd(), "package.json")
+  ];
+  for (const pkgPath of pkgLocations) {
+    if (fs3__default.default.existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(fs3__default.default.readFileSync(pkgPath, "utf-8"));
+        if (pkg.mason?.registry && typeof pkg.mason.registry === "string") {
+          return normalizeRegistryUrl(pkg.mason.registry.trim(), path3__default.default.dirname(pkgPath));
+        }
+      } catch {
+      }
     }
   }
+  const localRegistry = findLocalRegistry(rootDir);
+  if (localRegistry) {
+    return localRegistry;
+  }
   return DEFAULT_REGISTRY_BASE;
 }
 async function fetchRegistryFile(registryBase, relPath) {
   const cleanRelPath = relPath.replace(/^\/+/, "");
   if (registryBase.startsWith("http://") || registryBase.startsWith("https://")) {
     const url = `${registryBase.replace(/\/+$/, "")}/${cleanRelPath}`;
-    const res = await fetch(url);
+    const headers = {};
+    const token = process.env.GITHUB_TOKEN || process.env.GH_TOKEN;
+    if (token) {
+      headers["Authorization"] = `Bearer ${token}`;
+    }
+    const res = await fetch(url, { headers });
     if (!res.ok) {
-      throw new Error(`Failed to fetch ${cleanRelPath} from ${url} (HTTP ${res.status}: ${res.statusText})`);
+      let extraHint = "";
+      if (res.status === 404) {
+        extraHint = `
+  Possible reasons:
+  \u2022 If using a private GitHub repository, ensure GITHUB_TOKEN is set in your environment.
+  \u2022 If your registry has not yet been pushed to GitHub, point to your local directory:
+    - CLI flag:      mason import ... --registry /path/to/mason-registry
+    - Environment:   export MASON_REGISTRY_URL=/path/to/mason-registry
+    - Config file:   Create mason.config.json with { "registry": "/path/to/mason-registry" }`;
+      }
+      throw new Error(`Failed to fetch ${cleanRelPath} from ${url} (HTTP ${res.status}: ${res.statusText})${extraHint}`);
     }
     return await res.text();
   }
@@ -393,7 +458,7 @@ async function fetchRegistryFile(registryBase, relPath) {
   if (baseDir.startsWith("file://")) {
     baseDir = url.fileURLToPath(baseDir);
   }
-  const filePath = path7__default.default.resolve(baseDir, cleanRelPath);
+  const filePath = path3__default.default.resolve(baseDir, cleanRelPath);
   if (!fs3__default.default.existsSync(filePath)) {
     throw new Error(`Registry file not found at ${filePath}`);
   }
@@ -459,14 +524,14 @@ function findClosestMatch(target, candidates) {
   return null;
 }
 function detectPackageManager(projectRoot) {
-  if (fs3__default.default.existsSync(path7__default.default.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs3__default.default.existsSync(path7__default.default.join(projectRoot, "yarn.lock"))) return "yarn";
-  if (fs3__default.default.existsSync(path7__default.default.join(projectRoot, "bun.lockb")) || fs3__default.default.existsSync(path7__default.default.join(projectRoot, "bun.lock"))) return "bun";
+  if (fs3__default.default.existsSync(path3__default.default.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs3__default.default.existsSync(path3__default.default.join(projectRoot, "yarn.lock"))) return "yarn";
+  if (fs3__default.default.existsSync(path3__default.default.join(projectRoot, "bun.lockb")) || fs3__default.default.existsSync(path3__default.default.join(projectRoot, "bun.lock"))) return "bun";
   return "npm";
 }
 function getMissingNpmPackages(projectRoot, requiredPackages) {
   if (!requiredPackages || requiredPackages.length === 0) return [];
-  const pkgJsonPath = path7__default.default.join(projectRoot, "package.json");
+  const pkgJsonPath = path3__default.default.join(projectRoot, "package.json");
   if (!fs3__default.default.existsSync(pkgJsonPath)) {
     return requiredPackages;
   }
@@ -528,30 +593,30 @@ function getTemplatesDir() {
   if (cachedTemplatesDir && fs3__default.default.existsSync(cachedTemplatesDir)) {
     return cachedTemplatesDir;
   }
-  const currentDir = typeof __dirname !== "undefined" ? __dirname : path7__default.default.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))));
-  const cand1 = path7__default.default.resolve(currentDir, "../../templates");
+  const currentDir = typeof __dirname !== "undefined" ? __dirname : path3__default.default.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))));
+  const cand1 = path3__default.default.resolve(currentDir, "../../templates");
   if (fs3__default.default.existsSync(cand1)) {
     cachedTemplatesDir = cand1;
     return cand1;
   }
-  const cand2 = path7__default.default.resolve(currentDir, "../templates");
+  const cand2 = path3__default.default.resolve(currentDir, "../templates");
   if (fs3__default.default.existsSync(cand2)) {
     cachedTemplatesDir = cand2;
     return cand2;
   }
-  const cand3 = path7__default.default.resolve(currentDir, "templates");
+  const cand3 = path3__default.default.resolve(currentDir, "templates");
   if (fs3__default.default.existsSync(cand3)) {
     cachedTemplatesDir = cand3;
     return cand3;
   }
   let curr = currentDir;
   while (true) {
-    const candTemplates = path7__default.default.join(curr, "templates");
+    const candTemplates = path3__default.default.join(curr, "templates");
     if (fs3__default.default.existsSync(candTemplates)) {
       cachedTemplatesDir = candTemplates;
       return candTemplates;
     }
-    const parent = path7__default.default.dirname(curr);
+    const parent = path3__default.default.dirname(curr);
     if (parent === curr) break;
     curr = parent;
   }
@@ -559,7 +624,7 @@ function getTemplatesDir() {
 }
 var templateCache = /* @__PURE__ */ new Map();
 function loadTemplate(relativePath) {
-  const fullPath = path7__default.default.isAbsolute(relativePath) ? relativePath : path7__default.default.join(getTemplatesDir(), relativePath);
+  const fullPath = path3__default.default.isAbsolute(relativePath) ? relativePath : path3__default.default.join(getTemplatesDir(), relativePath);
   return fs3__default.default.readFileSync(fullPath, "utf-8");
 }
 function renderTemplateFile(relativePath, context) {
@@ -645,8 +710,8 @@ function generateDomainEntityCode(name, kind = "interface", properties = []) {
 function generateDomain(options) {
   const projectRoot = options.projectRoot || findProjectRoot();
   const entityName = toPascalCase(options.name);
-  const targetDir = options.targetDir || path7__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "domain");
-  const filePath = path7__default.default.join(targetDir, `${entityName}.ts`);
+  const targetDir = options.targetDir || path3__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "domain");
+  const filePath = path3__default.default.join(targetDir, `${entityName}.ts`);
   const code = generateDomainEntityCode(
     entityName,
     options.kind || "interface",
@@ -695,8 +760,8 @@ function generateInterfaceCode(ifaceName, kind = "abstractClass", entityName, me
 function generateInterface(options) {
   const projectRoot = options.projectRoot || findProjectRoot();
   const ifaceName = ensureInterfacePrefix(options.name);
-  const targetDir = options.targetDir || path7__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "domain");
-  const filePath = path7__default.default.join(targetDir, `${ifaceName}.ts`);
+  const targetDir = options.targetDir || path3__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "domain");
+  const filePath = path3__default.default.join(targetDir, `${ifaceName}.ts`);
   const code = generateInterfaceCode(
     ifaceName,
     options.kind || "abstractClass",
@@ -941,21 +1006,21 @@ function findInterfaceFile(projectRoot, ifaceName, featureName, customPath) {
   ];
   const features = featureName ? [featureName, ...listExistingFeatures(projectRoot).filter((f) => f !== featureName)] : listExistingFeatures(projectRoot);
   for (const feat of features) {
-    const domainDir = path7__default.default.join(resolveFeaturesDir(projectRoot), feat, "domain");
+    const domainDir = path3__default.default.join(resolveFeaturesDir(projectRoot), feat, "domain");
     if (!fs3__default.default.existsSync(domainDir)) continue;
     for (const cand of candidateNames) {
-      const p1 = path7__default.default.join(domainDir, `${cand}.ts`);
+      const p1 = path3__default.default.join(domainDir, `${cand}.ts`);
       if (fs3__default.default.existsSync(p1)) {
         return { filePath: p1, ifaceName: cand, feature: feat };
       }
     }
   }
   for (const cand of candidateNames) {
-    const p1 = path7__default.default.join(projectRoot, "domain", `${cand}.ts`);
+    const p1 = path3__default.default.join(projectRoot, "domain", `${cand}.ts`);
     if (fs3__default.default.existsSync(p1)) return { filePath: p1, ifaceName: cand };
-    const p22 = path7__default.default.join(projectRoot, "src", "domain", `${cand}.ts`);
+    const p22 = path3__default.default.join(projectRoot, "src", "domain", `${cand}.ts`);
     if (fs3__default.default.existsSync(p22)) return { filePath: p22, ifaceName: cand };
-    const p32 = path7__default.default.join(projectRoot, "interfaces", `${cand}.ts`);
+    const p32 = path3__default.default.join(projectRoot, "interfaces", `${cand}.ts`);
     if (fs3__default.default.existsSync(p32)) return { filePath: p32, ifaceName: cand };
   }
   return null;
@@ -1055,7 +1120,7 @@ function generateStubCode(stubClassName, ifaceName, entityName, featureName, met
   const entitiesVar = `${entityVar}s`;
   const idKey = `${entityVar}Id`;
   const impPath = ifaceImportPath || `../domain/${ifaceName}.js`;
-  const entityImportPath = ifaceImportPath ? `${path7__default.default.dirname(ifaceImportPath)}/${baseEntity}.js` : `../domain/${baseEntity}.js`;
+  const entityImportPath = ifaceImportPath ? `${path3__default.default.dirname(ifaceImportPath)}/${baseEntity}.js` : `../domain/${baseEntity}.js`;
   const importsByFrom = /* @__PURE__ */ new Map();
   for (const imp of domainImports) {
     if (imp.name === ifaceName || imp.name === baseEntity) continue;
@@ -1104,7 +1169,7 @@ function generateConcreteInfraCode(className, ifaceName, dependencies = [], meth
     if (baseEntity) {
       finalMethods = synthesizeCrudMethods(baseEntity);
       if (!finalDomainImports.some((imp) => imp.name === baseEntity)) {
-        const importPath = ifaceImportPath ? `${path7__default.default.dirname(ifaceImportPath)}/${baseEntity}.js` : `../domain/${baseEntity}.js`;
+        const importPath = ifaceImportPath ? `${path3__default.default.dirname(ifaceImportPath)}/${baseEntity}.js` : `../domain/${baseEntity}.js`;
         finalDomainImports.push({
           name: baseEntity,
           from: importPath,
@@ -1149,8 +1214,8 @@ function generateInfrastructure(options) {
   const projectRoot = options.projectRoot || findProjectRoot();
   const className = toPascalCase(options.name);
   const isFeatureScope = options.scope !== "global" && Boolean(options.feature);
-  const targetDir = options.targetDir || (isFeatureScope ? path7__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "infrastructure") : path7__default.default.join(projectRoot, "infrastructure"));
-  const filePath = path7__default.default.join(targetDir, `${className}.ts`);
+  const targetDir = options.targetDir || (isFeatureScope ? path3__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "infrastructure") : path3__default.default.join(projectRoot, "infrastructure"));
+  const filePath = path3__default.default.join(targetDir, `${className}.ts`);
   let code;
   if (options.implementsInterface) {
     const rawIfaceName = options.implementsInterface;
@@ -1164,7 +1229,7 @@ function generateInfrastructure(options) {
     const ifaceFilePath = hierarchy.ifaceFilePath;
     let ifaceImportPath;
     if (ifaceFilePath) {
-      let rel = path7__default.default.relative(targetDir, ifaceFilePath).replace(/\\/g, "/").replace(/\.ts$/, ".js");
+      let rel = path3__default.default.relative(targetDir, ifaceFilePath).replace(/\\/g, "/").replace(/\.ts$/, ".js");
       if (!rel.startsWith(".")) rel = "./" + rel;
       ifaceImportPath = rel;
     } else if (isFeatureScope) {
@@ -1177,8 +1242,8 @@ function generateInfrastructure(options) {
         if (new RegExp(`\\b${item.name}\\b`).test(allSignatures)) {
           let fromPath;
           if (imp.specifier.startsWith(".") && ifaceFilePath) {
-            const absTarget = path7__default.default.resolve(path7__default.default.dirname(ifaceFilePath), imp.specifier);
-            let rel = path7__default.default.relative(targetDir, absTarget).replace(/\\/g, "/");
+            const absTarget = path3__default.default.resolve(path3__default.default.dirname(ifaceFilePath), imp.specifier);
+            let rel = path3__default.default.relative(targetDir, absTarget).replace(/\\/g, "/");
             if (!rel.startsWith(".")) rel = "./" + rel;
             fromPath = rel;
           } else {
@@ -1365,8 +1430,8 @@ function generateUseCase(options) {
   const files = [];
   const projectRoot = options.projectRoot || findProjectRoot();
   const ucName = toPascalCase(options.name);
-  const targetDir = options.targetDir || path7__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "useCases");
-  const filePath = path7__default.default.join(targetDir, `${ucName}.ts`);
+  const targetDir = options.targetDir || path3__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "useCases");
+  const filePath = path3__default.default.join(targetDir, `${ucName}.ts`);
   const code = generateUseCaseCode(
     ucName,
     options.dependencies || [],
@@ -1382,7 +1447,7 @@ function generateUseCase(options) {
     })
   );
   if (options.includeTest) {
-    const testPath = path7__default.default.join(targetDir, `${ucName}.test.ts`);
+    const testPath = path3__default.default.join(targetDir, `${ucName}.test.ts`);
     const testCode = generateUseCaseTestCode(ucName, options.dependencies || []);
     files.push(
       writeFileSafely(testPath, testCode, {
@@ -1450,9 +1515,9 @@ function generateHttpHandler(options) {
   const files = [];
   const projectRoot = options.projectRoot || findProjectRoot();
   const className = toPascalCase(options.name);
-  const pxDir = path7__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "pxExpress");
-  const handlersDir = path7__default.default.join(pxDir, "handlers");
-  const pxIndexPath = path7__default.default.join(pxDir, "index.ts");
+  const pxDir = path3__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "pxExpress");
+  const handlersDir = path3__default.default.join(pxDir, "handlers");
+  const pxIndexPath = path3__default.default.join(pxDir, "index.ts");
   if (!fs3__default.default.existsSync(pxIndexPath)) {
     const featurePath = options.routePrefix || `/${options.feature.toLowerCase()}`;
     const pxIndexContent = renderTemplate(expressIndexTemplate, {
@@ -1466,7 +1531,7 @@ function generateHttpHandler(options) {
       })
     );
   }
-  const handlerFilePath = path7__default.default.join(handlersDir, `${className}.ts`);
+  const handlerFilePath = path3__default.default.join(handlersDir, `${className}.ts`);
   const code = generateHttpHandlerCode(
     className,
     options.method || "get",
@@ -1487,7 +1552,7 @@ function generateHttpHandler(options) {
   return files;
 }
 function updateOrGenerateDiProvider(featureDir, featureName, bindings = [], options = {}) {
-  const providerPath = path7__default.default.join(featureDir, "diProvider.ts");
+  const providerPath = path3__default.default.join(featureDir, "diProvider.ts");
   const pascalFeature = toPascalCase(featureName);
   const providerModuleName = `${pascalFeature}Provider`;
   if (fs3__default.default.existsSync(providerPath) && !options.overwrite) {
@@ -1550,7 +1615,7 @@ function generateFeature(options) {
   const projectRoot = options.projectRoot || findProjectRoot();
   const rawName = options.name.trim();
   const featureName = toCamelCase(rawName);
-  const targetDir = options.targetDir || path7__default.default.join(resolveFeaturesDir(projectRoot), featureName);
+  const targetDir = options.targetDir || path3__default.default.join(resolveFeaturesDir(projectRoot), featureName);
   const routePath = options.routePath || `/${featureName}`;
   const rawEntities = [];
   if (options.entityNames && options.entityNames.length > 0) {
@@ -1571,7 +1636,7 @@ function generateFeature(options) {
       const domainFile = generateDomain({
         name: ent,
         feature: featureName,
-        targetDir: path7__default.default.join(targetDir, "domain"),
+        targetDir: path3__default.default.join(targetDir, "domain"),
         projectRoot,
         dryRun: options.dryRun,
         overwrite: options.overwrite,
@@ -1591,7 +1656,7 @@ function generateFeature(options) {
       const ifaceFile = generateInterface({
         name: ifaceName,
         feature: featureName,
-        targetDir: path7__default.default.join(targetDir, "domain"),
+        targetDir: path3__default.default.join(targetDir, "domain"),
         entityName: ent,
         projectRoot,
         dryRun: options.dryRun,
@@ -1608,7 +1673,7 @@ function generateFeature(options) {
       const stubFile = generateInfrastructure({
         name: stubName,
         feature: featureName,
-        targetDir: path7__default.default.join(targetDir, "infrastructure"),
+        targetDir: path3__default.default.join(targetDir, "infrastructure"),
         kind: "stub",
         implementsInterface: ifaceName,
         entityName: ent,
@@ -1650,7 +1715,7 @@ function generateFeature(options) {
       const ucFiles = generateUseCase({
         name: ucName,
         feature: featureName,
-        targetDir: path7__default.default.join(targetDir, "useCases"),
+        targetDir: path3__default.default.join(targetDir, "useCases"),
         dependencies: options.includeInterface !== false ? [ifaceName] : [],
         inputProperties: [{ name: idParam, type: "string" }],
         outputProperties: [{ name: entVar, type: primaryEntity }],
@@ -1695,7 +1760,7 @@ function generateFeature(options) {
           const ucFiles = generateUseCase({
             name: ucName,
             feature: featureName,
-            targetDir: path7__default.default.join(targetDir, "useCases"),
+            targetDir: path3__default.default.join(targetDir, "useCases"),
             dependencies: deps,
             inputProperties: [{ name: entVar, type: ent }],
             outputProperties: [{ name: entVar, type: ent }],
@@ -1728,7 +1793,7 @@ function generateFeature(options) {
           const ucFiles = generateUseCase({
             name: ucName,
             feature: featureName,
-            targetDir: path7__default.default.join(targetDir, "useCases"),
+            targetDir: path3__default.default.join(targetDir, "useCases"),
             dependencies: deps,
             inputProperties: [{ name: idParam, type: "string" }],
             outputProperties: [{ name: entVar, type: ent }],
@@ -1761,7 +1826,7 @@ function generateFeature(options) {
           const ucFiles = generateUseCase({
             name: ucName,
             feature: featureName,
-            targetDir: path7__default.default.join(targetDir, "useCases"),
+            targetDir: path3__default.default.join(targetDir, "useCases"),
             dependencies: deps,
             inputProperties: [
               { name: "page", type: "number", optional: true },
@@ -1805,7 +1870,7 @@ function generateFeature(options) {
           const ucFiles = generateUseCase({
             name: ucName,
             feature: featureName,
-            targetDir: path7__default.default.join(targetDir, "useCases"),
+            targetDir: path3__default.default.join(targetDir, "useCases"),
             dependencies: deps,
             inputProperties: [{ name: entVar, type: ent }],
             outputProperties: [{ name: entVar, type: ent }],
@@ -1838,7 +1903,7 @@ function generateFeature(options) {
           const ucFiles = generateUseCase({
             name: ucName,
             feature: featureName,
-            targetDir: path7__default.default.join(targetDir, "useCases"),
+            targetDir: path3__default.default.join(targetDir, "useCases"),
             dependencies: deps,
             inputProperties: [{ name: idParam, type: "string" }],
             outputProperties: [{ name: "success", type: "boolean" }],
@@ -1875,7 +1940,7 @@ function generateFeature(options) {
       const ucFiles = generateUseCase({
         name: ucName,
         feature: featureName,
-        targetDir: path7__default.default.join(targetDir, "useCases"),
+        targetDir: path3__default.default.join(targetDir, "useCases"),
         dependencies: customUc.dependencies || [],
         inputProperties: customUc.inputProperties || [],
         outputProperties: customUc.outputProperties || [],
@@ -1907,8 +1972,8 @@ function generateFeature(options) {
     }
   }
   if (options.includeExpress !== false) {
-    const pxDir = path7__default.default.join(targetDir, "pxExpress");
-    const pxIndexPath = path7__default.default.join(pxDir, "index.ts");
+    const pxDir = path3__default.default.join(targetDir, "pxExpress");
+    const pxIndexPath = path3__default.default.join(pxDir, "index.ts");
     if (!files.some((f) => f.absolutePath === pxIndexPath)) {
       const pxIndexContent = renderTemplate(expressIndexTemplate, { routePath });
       files.push(
@@ -1951,7 +2016,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
     ).trim();
   }
   const normalizedName = toCamelCase(name);
-  const defaultDir = path7__default.default.relative(projectRoot, path7__default.default.join(resolveFeaturesDir(projectRoot), normalizedName));
+  const defaultDir = path3__default.default.relative(projectRoot, path3__default.default.join(resolveFeaturesDir(projectRoot), normalizedName));
   let targetDirRel = defaultDir;
   if (!flags.yes && !flags.target) {
     targetDirRel = handleCancel(
@@ -1962,7 +2027,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
       })
     ).trim();
   }
-  const targetDir = flags.target ? path7__default.default.resolve(projectRoot, flags.target) : path7__default.default.resolve(projectRoot, targetDirRel);
+  const targetDir = flags.target ? path3__default.default.resolve(projectRoot, flags.target) : path3__default.default.resolve(projectRoot, targetDirRel);
   let includeExpress = flags.express !== void 0 ? Boolean(flags.express) : true;
   let routePath = `/${normalizedName}`;
   let includeDomain = true;
@@ -2630,7 +2695,7 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
   const infraFile = generateInfrastructure(options);
   files.push(infraFile);
   if (registerInProvider && scope === "feature" && feature && implementsInterface) {
-    const featureDir = path7__default.default.join(resolveFeaturesDir(projectRoot), feature);
+    const featureDir = path3__default.default.join(resolveFeaturesDir(projectRoot), feature);
     const providerFile = updateOrGenerateDiProvider(
       featureDir,
       feature,
@@ -2792,7 +2857,7 @@ async function runInterfaceCommand(interfaceNameArg, flags = {}) {
     files.push(stubFile);
   }
   if (registerInProvider && generateStub) {
-    const featureDir = path7__default.default.join(resolveFeaturesDir(projectRoot), feature);
+    const featureDir = path3__default.default.join(resolveFeaturesDir(projectRoot), feature);
     const providerFile = updateOrGenerateDiProvider(
       featureDir,
       feature,
@@ -2980,21 +3045,21 @@ function generateInjectable(options) {
   const className = toPascalCase(options.name);
   let targetDir = "";
   if (options.customPath) {
-    targetDir = path7__default.default.isAbsolute(options.customPath) ? options.customPath : path7__default.default.join(projectRoot, options.customPath);
+    targetDir = path3__default.default.isAbsolute(options.customPath) ? options.customPath : path3__default.default.join(projectRoot, options.customPath);
   } else if (options.location === "feature-service" && options.feature) {
-    targetDir = path7__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "services");
+    targetDir = path3__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "services");
   } else if (options.location === "feature-transformer" && options.feature) {
-    targetDir = path7__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "pxExpress", "transformers");
+    targetDir = path3__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "pxExpress", "transformers");
   } else if (options.location === "module") {
-    targetDir = path7__default.default.join(projectRoot, "modules", className);
+    targetDir = path3__default.default.join(projectRoot, "modules", className);
   } else {
-    targetDir = options.feature ? path7__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "services") : path7__default.default.join(projectRoot, "shared", className.toLowerCase());
+    targetDir = options.feature ? path3__default.default.join(resolveFeaturesDir(projectRoot), options.feature, "services") : path3__default.default.join(projectRoot, "shared", className.toLowerCase());
   }
-  const filePath = path7__default.default.join(targetDir, `${className}.ts`);
+  const filePath = path3__default.default.join(targetDir, `${className}.ts`);
   let ifaceName;
   if (options.generateInterface) {
     ifaceName = `I${className}`;
-    const ifacePath = path7__default.default.join(targetDir, `${ifaceName}.ts`);
+    const ifacePath = path3__default.default.join(targetDir, `${ifaceName}.ts`);
     const ifaceContent = renderTemplate(injectableInterfaceTemplate, { ifaceName });
     files.push(
       writeFileSafely(ifacePath, ifaceContent, {
@@ -3309,7 +3374,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
     }
     const sharedDeps = manifest.dependencies?.shared || [];
     for (const dep of sharedDeps) {
-      const depPath = path7__default.default.join(projectRoot, "src", "shared", dep);
+      const depPath = path3__default.default.join(projectRoot, "src", "shared", dep);
       if (!fs3__default.default.existsSync(depPath) && !importedModules.has(`shared:${dep}`)) {
         p4__namespace.log.info(`  \u21B3 Resolving required shared dependency: ${pc13__default.default.cyan(dep)}`);
         await importModuleRecursive("shared", dep);
@@ -3317,7 +3382,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
     }
     const featureDeps = manifest.dependencies?.features || [];
     for (const dep of featureDeps) {
-      const depPath = path7__default.default.join(projectRoot, "src", "features", dep);
+      const depPath = path3__default.default.join(projectRoot, "src", "features", dep);
       if (!fs3__default.default.existsSync(depPath) && !importedModules.has(`feature:${dep}`)) {
         p4__namespace.log.info(`  \u21B3 Resolving required feature dependency: ${pc13__default.default.cyan(dep)}`);
         await importModuleRecursive("feature", dep);
@@ -3327,21 +3392,21 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       requiredNpmPackages.add(pkg);
     }
     const folder = modType === "shared" ? "shared" : "features";
-    const targetDir = path7__default.default.join(projectRoot, "src", folder, modName);
+    const targetDir = path3__default.default.join(projectRoot, "src", folder, modName);
     for (const file of manifest.files || []) {
       if (file === "registry.json") continue;
       const remoteFilePath = `${folder}/${modName}/${file}`;
-      const localFilePath = path7__default.default.join(targetDir, file);
+      const localFilePath = path3__default.default.join(targetDir, file);
       if (fs3__default.default.existsSync(localFilePath) && !flags.overwrite) {
-        p4__namespace.log.warn(`  \u21B3 Skipping existing file: ${pc13__default.default.dim(path7__default.default.relative(projectRoot, localFilePath))} (use --overwrite to replace)`);
+        p4__namespace.log.warn(`  \u21B3 Skipping existing file: ${pc13__default.default.dim(path3__default.default.relative(projectRoot, localFilePath))} (use --overwrite to replace)`);
         continue;
       }
       const content = await fetchRegistryFile(registryBase, remoteFilePath);
       if (!flags.dryRun) {
-        fs3__default.default.mkdirSync(path7__default.default.dirname(localFilePath), { recursive: true });
+        fs3__default.default.mkdirSync(path3__default.default.dirname(localFilePath), { recursive: true });
         fs3__default.default.writeFileSync(localFilePath, content, "utf-8");
       }
-      const displayPath = path7__default.default.relative(projectRoot, localFilePath);
+      const displayPath = path3__default.default.relative(projectRoot, localFilePath);
       totalWrittenFiles.push(displayPath);
       p4__namespace.log.message(`  ${pc13__default.default.green("+")} ${displayPath}`);
     }
@@ -3484,6 +3549,7 @@ exports.fetchRegistryFile = fetchRegistryFile;
 exports.fetchRegistryIndex = fetchRegistryIndex;
 exports.findClosestMatch = findClosestMatch;
 exports.findInterfaceFile = findInterfaceFile;
+exports.findLocalRegistry = findLocalRegistry;
 exports.findProjectRoot = findProjectRoot;
 exports.generateConcreteInfraCode = generateConcreteInfraCode;
 exports.generateDomain = generateDomain;
@@ -3520,6 +3586,7 @@ exports.listExistingFeatures = listExistingFeatures;
 exports.listUseCases = listUseCases;
 exports.loadInterfaceHierarchy = loadInterfaceHierarchy;
 exports.loadTemplate = loadTemplate;
+exports.normalizeRegistryUrl = normalizeRegistryUrl;
 exports.parseInterfaceMethodsAndImports = parseInterfaceMethodsAndImports;
 exports.printBanner = printBanner;
 exports.printGeneratedFiles = printGeneratedFiles;