@sculptor/cli 0.2.2 → 0.3.0

package/dist/scaffold.js

@@ -1,2 +1,245 @@
-export { controllerHelp, generateHelp, generateResourceFiles, middlewareHelp, moduleHelp, parseGenerateMode, readModeFromFlags, routeHelp, scaffoldProject, syncTestHarness, typeHelp, writeGeneratedFiles } from "../../template-registry/dist/index.js";
+import { detectPackageManager, globalInstallArgsFor } from "./package-manager.js";
+export const controllerHelp = `# Controller Generator
+
+## Usage
+
+\`\`\`bash
+sc generate controller user
+sc g c user
+sc generate controller user in src/app/controllers
+sc g c user --functional
+\`\`\`
+
+## Output
+
+- \`controllers/*.controller.ts\`
+- controller-first by default
+- pass \`--functional\` to opt into paired functional route and handler files
+`;
+export const moduleHelp = `# Module Generator
+
+## Usage
+
+\`\`\`bash
+sc generate module user
+sc g mo user
+\`\`\`
+`;
+export const middlewareHelp = `# Middleware Generator
+
+## Usage
+
+\`\`\`bash
+sc generate middleware auth
+sc g mw auth
+\`\`\`
+`;
+export const repositoryHelp = `# Repository Generator
+
+## Usage
+
+\`\`\`bash
+sc generate repository user
+sc g repo user
+\`\`\`
+
+## Output
+
+- \`*.repository.ts\`
+- generates a \`@Repository()\` class
+`;
+export const dtoHelp = `# DTO Generator
+
+## Usage
+
+\`\`\`bash
+sc generate dto user
+sc g dto user
+\`\`\`
+
+## Output
+
+- \`*.dto.ts\`
+- generates an explicit DTO class
+`;
+export const typeHelp = `# Type Generator
+
+## Usage
+
+\`\`\`bash
+sc generate type user
+sc g t user
+sc g t user -i
+sc g t user -c
+sc g t user -e
+\`\`\`
+
+## Flags
+
+- \`-i\`, \`-interface\` => \`*.interface.ts\`
+- \`-c\`, \`-class\` => \`*.class.ts\`
+- \`-e\`, \`-enum\` => \`*.enum.ts\`
+- default => \`*.type.ts\`
+`;
+export const routeHelp = `# Route Generator
+
+## Usage
+
+\`\`\`bash
+sc generate route user
+sc g r user
+\`\`\`
+
+## Output
+
+- \`*.route.ts\`
+- \`*.route.handler.ts\`
+- uses \`FunctionalRouter(prefix)\`
+- generates a paired handler with try/catch and error middleware boilerplate
+`;
+export const generateHelp = `# Generate
+
+## Usage
+
+\`\`\`bash
+sc generate controller user
+sc generate service user
+sc generate module user
+sc generate middleware auth
+sc generate repository user
+sc generate dto user
+sc generate type user
+sc generate route user
+sc generate pkg user
+sc generate package user
+\`\`\`
+
+## Aliases
+
+- \`sc g\`
+- \`controller\` -> \`c\`
+- \`service\` -> \`s\`
+- \`module\` -> \`m\` / \`mo\`
+- \`middleware\` -> \`mw\`
+- \`repository\` -> \`repo\`
+- \`dto\` -> \`dto\`
+- \`type\` -> \`t\`
+- \`route\` -> \`r\`
+- \`pkg\` -> \`pkg\`
+- \`package\` -> \`package\`
+
+## Path
+
+- append \`in <path>\` to write into a custom directory
+- default output for types is \`src/app/types\`
+- default output for repositories is \`src/app/repositories\`
+- default output for DTOs is \`src/app/dtos\`
+- package generation uses the configured \`project.srcRoot\` unless \`in\` is provided
+- controller generators are controller-first by default; pass \`--functional\` only when you want the paired functional route files
+- route generators always emit the paired functional route and handler files
+`;
+export const readModeFromFlags = (flags, fallback) => {
+    if (flags.includes("--functional")) {
+        return "functional";
+    }
+    if (flags.includes("--decorator")) {
+        return "decorator";
+    }
+    if (flags.includes("--hybrid")) {
+        return "hybrid";
+    }
+    return fallback;
+};
+export const parseGenerateMode = (mode, fallback) => mode === "functional" || mode === "decorator" || mode === "hybrid" ? mode : fallback;
+const TEMPLATE_REGISTRY_PACKAGE = "@sculptor/template-registry";
+const WORKSPACE_TEMPLATE_REGISTRY_PATH = "../../template-registry/dist/index.js";
+const missingDependencyMessage = `Sculptor template registry is not installed.`;
+const isMissingTemplateRegistryError = (error) => {
+    if (typeof error !== "object" || error === null) {
+        return false;
+    }
+    const code = "code" in error ? String(error.code ?? "") : "";
+    const message = "message" in error ? String(error.message ?? "") : "";
+    return (code === "ERR_MODULE_NOT_FOUND" ||
+        code === "MODULE_NOT_FOUND" ||
+        message.includes(TEMPLATE_REGISTRY_PACKAGE) ||
+        message.includes("Cannot find module") ||
+        message.includes("Cannot find package"));
+};
+export const loadScaffoldTemplateRegistry = async (context, importer = async () => {
+    try {
+        return (await import(TEMPLATE_REGISTRY_PACKAGE));
+    }
+    catch {
+        return (await import(WORKSPACE_TEMPLATE_REGISTRY_PATH));
+    }
+}) => {
+    try {
+        return await importer();
+    }
+    catch (error) {
+        if (!isMissingTemplateRegistryError(error)) {
+            throw error;
+        }
+        if (!context) {
+            throw new Error(`${missingDependencyMessage} Install it with npm install -g @sculptor/template-registry.`);
+        }
+        const answer = await context.prompt(`${missingDependencyMessage}\n\nWould you like to install it and rerun the command? (y/n)`, "n");
+        if (!answer.trim().toLowerCase().startsWith("y")) {
+            context.log("Skipped installing @sculptor/template-registry.");
+            process.exitCode = 1;
+            return null;
+        }
+        const packageManager = detectPackageManager();
+        context.log(`Installing ${TEMPLATE_REGISTRY_PACKAGE} with ${packageManager}...`);
+        const installResult = context.spawn(packageManager, globalInstallArgsFor(packageManager, [TEMPLATE_REGISTRY_PACKAGE]), {
+            cwd: context.cwd,
+            stdio: "inherit",
+            shell: process.platform === "win32",
+            env: {
+                ...process.env
+            }
+        });
+        if (installResult.status !== 0) {
+            throw new Error(`Failed to install ${TEMPLATE_REGISTRY_PACKAGE} with ${packageManager}.`);
+        }
+        try {
+            return await importer();
+        }
+        catch {
+            throw new Error(`${missingDependencyMessage} The package was installed, but it could not be loaded afterward.`);
+        }
+    }
+};
+export const scaffoldProject = async (metadata, targetDir, context) => {
+    const registry = await loadScaffoldTemplateRegistry(context);
+    if (!registry) {
+        return false;
+    }
+    registry.scaffoldProject(metadata, targetDir);
+    return true;
+};
+export const generateResourceFiles = async (kind, name, mode, devServer = "tsx", outputDir, typeVariant = "type", functionalRoutes = false, testingGenerate = false, context) => {
+    const registry = await loadScaffoldTemplateRegistry(context);
+    if (!registry) {
+        return null;
+    }
+    return registry.generateResourceFiles(kind, name, mode, devServer, outputDir, typeVariant, functionalRoutes, testingGenerate);
+};
+export const writeGeneratedFiles = async (targetDir, files, context) => {
+    const registry = await loadScaffoldTemplateRegistry(context);
+    if (!registry) {
+        return false;
+    }
+    registry.writeGeneratedFiles(targetDir, files);
+    return true;
+};
+export const syncTestHarness = async (targetDir, context) => {
+    const registry = await loadScaffoldTemplateRegistry(context);
+    if (!registry) {
+        return false;
+    }
+    registry.syncTestHarness(targetDir);
+    return true;
+};
 //# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,eAAe,EAIf,QAAQ,EAER,mBAAmB,EACpB,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sculptor/cli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "type": "module",
   "bin": {
     "sc": "./bin/sc.js",
@@ -36,9 +36,10 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@sculptor/config": "^0.2.1",
-    "@sculptor/core": "^0.2.3",
-    "@sculptor/template-registry": "^0.1.5",
+    "@sculptor/config": "^0.3.0",
+    "@sculptor/core": "^0.3.0",
+    "@sculptor/template-registry": "^0.3.0",
+    "typescript": "^5.8.3",
     "tsx": "^4.19.4"
   }
 }