@morda-dev/create-sdk 1.2.1 → 1.3.0

package/bin/create-sdk.js

@@ -13,7 +13,7 @@ const CURRENT_NODE_MAJOR = Number(process.versions.node.split(".")[0]);
 if (CURRENT_NODE_MAJOR < REQUIRED_NODE_MAJOR) {
   console.error(
     `❌ Node.js ${REQUIRED_NODE_MAJOR}+ is required.\n` +
-      `   You are using Node.js ${process.versions.node}`
+    `   You are using Node.js ${process.versions.node}`
   );
   process.exit(1);
 }
@@ -35,7 +35,27 @@ const flags = {
 const projectName = rawArgs.find((a) => !a.startsWith("-"));
 
 /* ============================================================================
- * Interactive mode
+ * Help (EARLY EXIT, SNAPSHOT SAFE)
+ * ============================================================================
+ */
+if (rawArgs.includes("--help") || rawArgs.includes("-h")) {
+  console.log(
+`Usage:
+  create-sdk <project-name> [options]
+
+Options:
+  --yes           Skip all prompts
+  --no-git        Do not initialize git repository
+  --no-install    Do not install dependencies
+  --dry-run       Show what would be done without writing files
+  --force         Overwrite existing directory
+  --help, -h      Show this help message`
+  );
+  process.exit(0);
+}
+
+/* ============================================================================
+ * Interactive / Non-interactive resolution
  * ============================================================================
  */
 let name = projectName;
@@ -66,7 +86,7 @@ if (!flags.yes && !name) {
     ],
     {
       onCancel: () => {
-        console.log("\n❌ Cancelled");
+        console.error("❌ Cancelled");
         process.exit(1);
       },
     }
@@ -77,19 +97,39 @@ if (!flags.yes && !name) {
   installDeps = answers.installDeps;
 }
 
+/* ============================================================================
+ * Validation
+ * ============================================================================
+ */
 if (!name) {
   console.error("❌ Project name is required");
   process.exit(1);
 }
 
 /* ============================================================================
- * Execute scaffold
+ * Execute scaffold (CLI CONTRACT OWNER)
  * ============================================================================
  */
-await scaffold({
-  projectName: name,
-  initGit,
-  installDeps,
-  dryRun: flags.dryRun,
-  force: flags.force,
-});
+try {
+  await scaffold({
+    projectName: name,
+    initGit,
+    installDeps,
+    dryRun: flags.dryRun,
+    force: flags.force,
+  });
+
+  if (flags.dryRun) {
+    console.log("ℹ️  Dry run completed. No files were written.");
+  } else {
+    console.log("🎉 SDK scaffolded successfully!");
+  }
+
+  process.exit(0);
+} catch (err) {
+  const message =
+    err instanceof Error ? err.message : "Unexpected error occurred";
+
+  console.error(`❌ ${message}`);
+  process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morda-dev/create-sdk",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "CLI to scaffold a production-ready TypeScript SDK with a strict public API",
   "license": "ISC",
   "type": "module",

package/src/cli/scaffold.js

@@ -8,6 +8,10 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const templateDir = path.resolve(__dirname, "../../template");
 
+const isTest =
+  process.env.NODE_ENV === "test" ||
+  process.env.VITEST === "true";
+
 export async function scaffold({
   projectName,
   initGit = true,
@@ -26,7 +30,14 @@ export async function scaffold({
   const targetDir = path.resolve(process.cwd(), dirName);
 
   // ─────────────────────────────────────────────
-  // 🧪 DRY-RUN — ABSOLUTE NO-SIDE-EFFECT MODE
+  // 🔒 CLI CONTRACT — EARLY FAILURE
+  // ─────────────────────────────────────────────
+  if (fs.existsSync(targetDir) && !force) {
+    throw new Error(`Directory "${dirName}" already exists`);
+  }
+
+  // ─────────────────────────────────────────────
+  // 🧪 DRY-RUN — NO SIDE EFFECTS
   // ─────────────────────────────────────────────
   if (dryRun) {
     console.log("🧪 [dry-run] Creating SDK:", projectName);
@@ -35,26 +46,22 @@ export async function scaffold({
     if (initGit) console.log("🧪 [dry-run] Would init git");
     if (installDeps) console.log("🧪 [dry-run] Would install dependencies");
     console.log("🧪 [dry-run] Done (NO filesystem changes)");
-    return;
+    return { targetDir };
   }
 
   // ─────────────────────────────────────────────
-  // REAL MODE — FILESYSTEM IS TOUCHED ONLY HERE
+  // REAL MODE — FS MUTATIONS
   // ─────────────────────────────────────────────
   if (!fs.existsSync(templateDir)) {
     throw new Error(`Template directory not found: ${templateDir}`);
   }
 
-  if (fs.existsSync(targetDir)) {
-    if (!force) {
-      throw new Error(`Directory "${dirName}" already exists`);
-    }
+  if (fs.existsSync(targetDir) && force) {
     fs.rmSync(targetDir, { recursive: true, force: true });
   }
 
   console.log("🚀 Creating SDK:", projectName);
 
-  // copy template
   copyDir(templateDir, targetDir);
 
   // package.json
@@ -63,11 +70,8 @@ export async function scaffold({
 
   pkg.name = projectName;
   pkg.version = "0.1.0";
-
-  // шаблон НЕ должен быть private
   delete pkg.private;
 
-  // exports добавляются ТОЛЬКО тут
   pkg.main = "./dist/index.js";
   pkg.types = "./dist/index.d.ts";
   pkg.exports = {
@@ -88,20 +92,20 @@ export async function scaffold({
     fs.writeFileSync(readmePath, updated);
   }
 
-  // git
-  if (initGit) {
+  // git (disabled in tests)
+  if (initGit && !isTest) {
     try {
       execSync("git init", { cwd: targetDir, stdio: "ignore" });
     } catch {}
   }
 
-  // deps
-  if (installDeps) {
+  // deps (disabled in tests)
+  if (installDeps && !isTest) {
     execSync("npm install", {
       cwd: targetDir,
       stdio: "inherit",
     });
   }
 
-  console.log("🎉 SDK scaffolded successfully!");
+  return { targetDir };
 }