@morda-dev/create-sdk 1.1.1 → 1.1.4

package/README.md

@@ -1,9 +1,31 @@
 # create-sdk
+![npm](https://img.shields.io/npm/v/@morda-dev/create-sdk)
+![npm downloads](https://img.shields.io/npm/dm/@morda-dev/create-sdk)
+![CI](https://github.com/mordaHQ/create-sdk/actions/workflows/ci.yml/badge.svg)
 
-Scaffold a production-ready TypeScript SDK with a strict public API.
+> Scaffold a **production-ready TypeScript SDK** with a **strict public API**.
+
+`create-sdk` is a CLI tool that bootstraps a modern TypeScript SDK with
+**ESM-first setup**, **API Extractor**, and **CI-ready structure** — so you
+can focus on features, not boilerplate.
+
+---
+
+## ✨ Features
+
+- ⚡ **Interactive CLI** (or fully automated with flags)
+- 📦 **ESM-first TypeScript setup**
+- 🔒 **Strict public API** via API Extractor
+- 🧪 **CI-verified & smoke-tested**
+- 🧱 Clean, scalable project structure
+- 🚫 No hidden magic, no vendor lock-in
+
+---
 
 ## 🚀 Quick start
 
+This creates a clean SDK with a strict public API enforced by API Extractor.
+
 ```bash
 npx @morda-dev/create-sdk my-sdk
 cd my-sdk
@@ -11,41 +33,91 @@ npm install
 npm run build
 ```
 
-## ✨ What you get
+That’s it. You now have a production-ready SDK.
+
+## 📘 Example SDK
+
+See a minimal, production-style SDK generated with **create-sdk**:
+
+👉 https://github.com/mordaHQ/example-sdk
+
+This example demonstrates:
+- a single, explicit public API entrypoint (`src/index.ts`)
+- API Extractor–controlled surface
+- ESM-first configuration
+- CI-ready setup
+- safe evolution without accidental breaking changes
+
+Use it as a reference for structuring real-world SDKs.
+
+## ❓ Why create-sdk?
+
+Most SDK starters fall into one of two traps:
+
+- ❌ too minimal — no real production setup
+- ❌ too complex — opinionated, hard to extend
 
-⚡ TypeScript + ESM out of the box
+**create-sdk** sits in the middle:
 
-🔒 Strict public API enforcement (API Extractor)
+> Strict where it matters. Flexible where it should be.
 
-🧪 CI-ready project structure
+You get:
 
-📦 Clean SDK architecture
+- a clearly defined public API
+- predictable build & release flow
+- freedom to grow the SDK your way
 
-🚫 No accidental exports
+## 🧩 What’s included
 
-## 📁 Project structure
-src/
-  index.ts        # public API surface
-  modules/        # internal implementation
-  types/          # public types
+- TypeScript project with strict config
+- API Extractor setup
+- Ready-to-use CI workflow
+- Clean module-based structure
+- Example public API and types
 
-  Only symbols exported from src/index.ts are considered public.
+## 🛠 CLI options
 
-## 📜 Available scripts
-npm run build      # build the SDK
-npm run api:check  # validate public API
+```bash
+npx @morda-dev/create-sdk <name> [options]
+```
+
+### Options
+
+- `--yes` — skip all prompts  
+- `--no-install` — skip dependency installation  
+- `--no-git` — skip git initialization
+
+### Example
+
+```bash
+npx @morda-dev/create-sdk my-sdk --yes --no-install
+```
+
+## 📦 Requirements
+
+- Node.js >= 18
+- npm / pnpm / yarn
+
+## ✅ Used in production
 
-## 🧠 Philosophy
+This template is used to scaffold and maintain real-world TypeScript SDKs.
 
-This CLI helps you build SDKs with a stable and explicit public API.
 
-Anything not exported from src/index.ts is treated as private by default.
-This prevents accidental breaking changes and enforces long-term stability.
+## 🧭 Roadmap
 
-## ⚙️ Requirements
+- Custom templates
+- Optional monorepo mode
+- Plugin system
+- SDK release automation helpers
 
-Node.js >= 18
+## 🤝 Contributing
+
+Issues and PRs are welcome.
+This project is intentionally kept small, clean, and well-documented.
 
 ## 📄 License
 
-ISC
+ISC
+
+
+---

package/bin/create-sdk.js

@@ -1,17 +1,12 @@
 #!/usr/bin/env node
-
-import fs from "fs";
-import path from "path";
 import process from "process";
-import { fileURLToPath } from "url";
-import { execSync } from "child_process";
 import prompts from "prompts";
+import { scaffold } from "../src/cli/scaffold.js";
 
 /* ============================================================================
- * Environment checks
+ * Node version check
  * ============================================================================
  */
-
 const REQUIRED_NODE_MAJOR = 18;
 const CURRENT_NODE_MAJOR = Number(process.versions.node.split(".")[0]);
 
@@ -24,67 +19,30 @@ if (CURRENT_NODE_MAJOR < REQUIRED_NODE_MAJOR) {
 }
 
 /* ============================================================================
- * CLI args & flags
+ * Args parsing
  * ============================================================================
  */
-
 const rawArgs = process.argv.slice(2);
 
 const flags = {
   yes: rawArgs.includes("--yes"),
   noGit: rawArgs.includes("--no-git"),
   noInstall: rawArgs.includes("--no-install"),
+  dryRun: rawArgs.includes("--dry-run"),
+  force: rawArgs.includes("--force"),
 };
 
-if (rawArgs.includes("--version") || rawArgs.includes("-v")) {
-  console.log("create-sdk v1.1.0");
-  process.exit(0);
-}
-
-if (rawArgs.includes("--help") || rawArgs.includes("-h")) {
-  console.log(`
-create-sdk — scaffold a production-ready TypeScript SDK
-
-Usage:
-  npx @morda-dev/create-sdk <project-name>
-
-Options:
-  --yes           Skip prompts and use defaults
-  --no-git        Do not initialize git repository
-  --no-install    Do not install dependencies
-  --help, -h      Show this help
-  --version, -v   Show version
-
-Example:
-  npx @morda-dev/create-sdk my-sdk
-  npx @morda-dev/create-sdk my-sdk --yes --no-install
-`);
-  process.exit(0);
-}
-
-/* ============================================================================
- * Paths
- * ============================================================================
- */
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const templateDir = path.resolve(__dirname, "../template");
+const projectName = rawArgs.find((a) => !a.startsWith("-"));
 
 /* ============================================================================
- * Project name & interactive flow
+ * Interactive mode
  * ============================================================================
  */
-
-const argProjectName = rawArgs.find((a) => !a.startsWith("-"));
-
-let projectName;
+let name = projectName;
 let initGit = !flags.noGit;
 let installDeps = !flags.noInstall;
 
-if (flags.yes && argProjectName) {
-  projectName = argProjectName;
-} else if (!argProjectName) {
+if (!flags.yes && !name) {
   const answers = await prompts(
     [
       {
@@ -114,148 +72,24 @@ if (flags.yes && argProjectName) {
     }
   );
 
-  projectName = answers.name;
+  name = answers.name;
   initGit = answers.initGit;
   installDeps = answers.installDeps;
-} else {
-  projectName = argProjectName;
 }
 
-if (!projectName) {
+if (!name) {
   console.error("❌ Project name is required");
   process.exit(1);
 }
 
 /* ============================================================================
- * Target directory
- * ============================================================================
- */
-
-const dirName = projectName.startsWith("@")
-  ? projectName.split("/")[1]
-  : projectName;
-
-const targetDir = path.resolve(process.cwd(), dirName);
-
-/* ============================================================================
- * Safety checks
- * ============================================================================
- */
-
-if (!fs.existsSync(templateDir)) {
-  console.error("❌ Template directory not found:", templateDir);
-  process.exit(1);
-}
-
-if (fs.existsSync(targetDir)) {
-  console.error(`❌ Directory "${dirName}" already exists`);
-  process.exit(1);
-}
-
-/* ============================================================================
- * Scaffold project
- * ============================================================================
- */
-
-console.log("🚀 Creating SDK:", projectName);
-
-copyDir(templateDir, targetDir);
-
-/* ============================================================================
- * Update package.json
+ * Execute scaffold
  * ============================================================================
  */
-
-const pkgPath = path.join(targetDir, "package.json");
-const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
-
-pkg.name = projectName;
-pkg.version = "0.1.0";
-delete pkg.private;
-
-fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
-
-/* ============================================================================
- * Update README title
- * ============================================================================
- */
-
-const readmePath = path.join(targetDir, "README.md");
-
-if (fs.existsSync(readmePath)) {
-  const updated = fs
-    .readFileSync(readmePath, "utf8")
-    .replace(/^# .*/m, `# ${projectName}`);
-
-  fs.writeFileSync(readmePath, updated);
-}
-
-/* ============================================================================
- * Git init
- * ============================================================================
- */
-
-if (initGit) {
-  try {
-    execSync("git init", { cwd: targetDir, stdio: "ignore" });
-  } catch {}
-}
-
-/* ============================================================================
- * Install dependencies
- * ============================================================================
- */
-
-if (installDeps) {
-  try {
-    execSync("npm install", { cwd: targetDir, stdio: "inherit" });
-  } catch {
-    console.warn("⚠️ Failed to install dependencies");
-  }
-}
-
-/* ============================================================================
- * Done
- * ============================================================================
- */
-
-console.log("");
-console.log("🎉 SDK scaffolded successfully!");
-console.log("");
-console.log("Next steps:");
-console.log(`  cd ${dirName}`);
-if (!installDeps) console.log("  npm install");
-console.log("  npm run build");
-console.log("");
-console.log("Happy hacking 🚀");
-
-/* ============================================================================
- * Helpers
- * ============================================================================
- */
-
-function copyDir(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    if (shouldIgnore(entry.name)) continue;
-
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-function shouldIgnore(name) {
-  return (
-    name === "node_modules" ||
-    name === ".git" ||
-    name === "dist" ||
-    name === ".DS_Store"
-  );
-}
+await scaffold({
+  projectName: name,
+  initGit,
+  installDeps,
+  dryRun: flags.dryRun,
+  force: flags.force,
+});

package/package.json

@@ -1,27 +1,36 @@
 {
   "name": "@morda-dev/create-sdk",
-  "version": "1.1.1",
+  "version": "1.1.4",
   "description": "CLI to scaffold a production-ready TypeScript SDK with a strict public API",
+  "license": "ISC",
   "type": "module",
+
   "bin": {
     "create-sdk": "./bin/create-sdk.js"
   },
+
   "files": [
     "bin",
+    "src",
     "template",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
+
   "engines": {
     "node": ">=18"
   },
+
   "repository": {
     "type": "git",
     "url": "https://github.com/mordaHQ/create-sdk.git"
   },
+
   "homepage": "https://github.com/mordaHQ/create-sdk",
   "bugs": {
     "url": "https://github.com/mordaHQ/create-sdk/issues"
   },
+
   "keywords": [
     "create-sdk",
     "typescript",
@@ -29,13 +38,21 @@
     "cli",
     "scaffold",
     "api-extractor",
-    "library"
+    "library",
+    "esm",
+    "developer-tools"
   ],
+
   "scripts": {
     "test:smoke": "node ./bin/create-sdk.js __tmp-smoke-sdk --yes --no-install --no-git && node -e \"import('fs').then(fs => fs.rmSync('__tmp-smoke-sdk', { recursive: true, force: true }))\""
   },
+
   "dependencies": {
     "prompts": "^2.4.2"
   },
-  "license": "ISC"
+
+  "devDependencies": {
+    "@types/node": "^18.19.0",
+    "undici-types": "^7.16.0"
+  }
 }

package/src/cli/args.js

@@ -0,0 +1,14 @@
+export function parseArgs(rawArgs) {
+  const flags = {
+    yes: rawArgs.includes("--yes"),
+    noGit: rawArgs.includes("--no-git"),
+    noInstall: rawArgs.includes("--no-install"),
+  };
+
+  const projectName = rawArgs.find((a) => !a.startsWith("-"));
+
+  return {
+    projectName,
+    flags,
+  };
+}

package/src/cli/prompts.js

@@ -0,0 +1,2 @@
+// reserved for future prompt extensions
+export {};

package/src/cli/run.js

@@ -0,0 +1,80 @@
+import prompts from "prompts";
+import { parseArgs } from "./args.js";
+import { scaffold } from "./scaffold.js";
+
+export async function run(rawArgs) {
+  const { projectName, flags } = parseArgs(rawArgs);
+
+  const dryRun = flags.dryRun === true;
+
+  // ─────────────────────────────────────────────
+  // DRY-RUN MODE — NO INTERACTION, NO SIDE EFFECTS
+  // ─────────────────────────────────────────────
+  if (dryRun && !projectName) {
+    throw new Error("Project name is required when using --dry-run");
+  }
+
+  let name = projectName;
+  let initGit = !flags.noGit;
+  let installDeps = !flags.noInstall;
+  const force = flags.force === true;
+
+  // ❗❗❗ DRY-RUN MUST OVERRIDE EVERYTHING
+  if (dryRun) {
+    initGit = false;
+    installDeps = false;
+  }
+
+  // ─────────────────────────────────────────────
+  // Interactive mode (ONLY if not dry-run)
+  // ─────────────────────────────────────────────
+  if (!dryRun && !flags.yes && !projectName) {
+    const answers = await prompts(
+      [
+        {
+          type: "text",
+          name: "name",
+          message: "Project name:",
+          validate: (v) => (v ? true : "Project name is required"),
+        },
+        {
+          type: "confirm",
+          name: "initGit",
+          message: "Initialize git repository?",
+          initial: true,
+        },
+        {
+          type: "confirm",
+          name: "installDeps",
+          message: "Install dependencies now?",
+          initial: false,
+        },
+      ],
+      {
+        onCancel: () => {
+          console.log("\n❌ Cancelled");
+          process.exit(1);
+        },
+      }
+    );
+
+    name = answers.name;
+    initGit = answers.initGit;
+    installDeps = answers.installDeps;
+  }
+
+  if (!name) {
+    throw new Error("Project name is required");
+  }
+
+  // ─────────────────────────────────────────────
+  // Scaffold (SINGLE ENTRY POINT)
+  // ─────────────────────────────────────────────
+  await scaffold({
+    projectName: name,
+    initGit,
+    installDeps,
+    dryRun,
+    force,
+  });
+}

package/src/cli/scaffold.js

@@ -0,0 +1,107 @@
+import fs from "fs";
+import path from "path";
+import { execSync } from "child_process";
+import { fileURLToPath } from "url";
+import { copyDir } from "./utils.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const templateDir = path.resolve(__dirname, "../../template");
+
+export async function scaffold({
+  projectName,
+  initGit = true,
+  installDeps = false,
+  dryRun = false,
+  force = false,
+}) {
+  if (!projectName) {
+    throw new Error("Project name is required");
+  }
+
+  const dirName = projectName.startsWith("@")
+    ? projectName.split("/")[1]
+    : projectName;
+
+  const targetDir = path.resolve(process.cwd(), dirName);
+
+  // ─────────────────────────────────────────────
+  // 🧪 DRY-RUN — ABSOLUTE NO-SIDE-EFFECT MODE
+  // ─────────────────────────────────────────────
+  if (dryRun) {
+    console.log("🧪 [dry-run] Creating SDK:", projectName);
+    console.log("🧪 [dry-run] Target directory:", path.join("<cwd>", dirName));
+    console.log("🧪 [dry-run] Would copy template from:", templateDir);
+    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;
+  }
+
+  // ─────────────────────────────────────────────
+  // REAL MODE — FILESYSTEM IS TOUCHED ONLY HERE
+  // ─────────────────────────────────────────────
+  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`);
+    }
+    fs.rmSync(targetDir, { recursive: true, force: true });
+  }
+
+  console.log("🚀 Creating SDK:", projectName);
+
+  // copy template
+  copyDir(templateDir, targetDir);
+
+  // package.json
+  const pkgPath = path.join(targetDir, "package.json");
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+
+  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 = {
+    ".": {
+      import: "./dist/index.js",
+      types: "./dist/index.d.ts",
+    },
+  };
+
+  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+
+  // README
+  const readmePath = path.join(targetDir, "README.md");
+  if (fs.existsSync(readmePath)) {
+    const updated = fs
+      .readFileSync(readmePath, "utf8")
+      .replace(/^# .*/m, `# ${projectName}`);
+    fs.writeFileSync(readmePath, updated);
+  }
+
+  // git
+  if (initGit) {
+    try {
+      execSync("git init", { cwd: targetDir, stdio: "ignore" });
+    } catch {}
+  }
+
+  // deps
+  if (installDeps) {
+    execSync("npm install", {
+      cwd: targetDir,
+      stdio: "inherit",
+    });
+  }
+
+  console.log("🎉 SDK scaffolded successfully!");
+}

package/src/cli/utils.js

@@ -0,0 +1,28 @@
+import fs from "fs";
+import path from "path";
+
+export function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (shouldIgnore(entry.name)) continue;
+
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function shouldIgnore(name) {
+  return (
+    name === "node_modules" ||
+    name === ".git" ||
+    name === "dist" ||
+    name === ".DS_Store"
+  );
+}

package/template/package.json

@@ -5,21 +5,6 @@
   "license": "ISC",
   "type": "module",
 
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-
-  "files": [
-    "dist",
-    "etc"
-  ],
-
   "sideEffects": false,
 
   "engines": {