@morda-dev/create-sdk 1.1.3 → 1.2.0

package/README.md

@@ -1,123 +1,128 @@
-# 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**.
-
-`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
-npm install
-npm run build
-```
-
-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
-
-**create-sdk** sits in the middle:
-
-> Strict where it matters. Flexible where it should be.
-
-You get:
-
-- a clearly defined public API
-- predictable build & release flow
-- freedom to grow the SDK your way
-
-## 🧩 What’s included
-
-- TypeScript project with strict config
-- API Extractor setup
-- Ready-to-use CI workflow
-- Clean module-based structure
-- Example public API and types
-
-## 🛠 CLI options
-
-```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
-
-This template is used to scaffold and maintain real-world TypeScript SDKs.
-
-
-## 🧭 Roadmap
-
-- Custom templates
-- Optional monorepo mode
-- Plugin system
-- SDK release automation helpers
-
-## 🤝 Contributing
-
-Issues and PRs are welcome.
-This project is intentionally kept small, clean, and well-documented.
-
-## 📄 License
-
-ISC
-
-
----
+# 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**.
+
+> ⚠️ Early-stage project (v0.x).  
+> Public API is intentionally strict, but may evolve before v1.0.0.
+
+`create-sdk` is a CLI tool that bootstraps a modern TypeScript SDK with an
+**ESM-first setup**, **API Extractor**, and a **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** enforced by 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
+npm install
+npm run build
+```
+
+That’s it. You now have a solid, production-oriented SDK foundation.
+
+
+## 📘 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
+
+**create-sdk** sits in the middle:
+
+Strict where it matters. Flexible where it should be.
+
+You get:
+- a clearly defined public API
+- predictable build & release flow
+- freedom to grow the SDK your way
+
+### 🧩 What’s included
+
+- TypeScript project with strict configuration
+- API Extractor setup
+- Ready-to-use CI workflow
+- Clean module-based structure
+- Example public API and types
+
+## 🛠 CLI options
+```bash
+npx @morda-dev/create-sdk my-sdk --yes
+```
+
+### Options
+
+- `--yes` — skip all prompts
+- `--dry-run` — preview what would be generated without creating files
+- `--force` — overwrite existing directory if it exists
+- `--no-install` — skip dependency installation
+- `--no-git` — skip git initialization
+
+### Examples
+
+```bash
+npx @morda-dev/create-sdk my-sdk --yes
+npx @morda-dev/create-sdk my-sdk --dry-run
+npx @morda-dev/create-sdk my-sdk --force --no-install
+```
+
+### 📦 Requirements
+- Node.js >= 18
+- npm / pnpm / yarn
+
+
+### 🧭 Roadmap
+
+- Custom templates
+- Optional monorepo mode
+- Plugin system
+- SDK release automation helpers
+
+
+
+## 🤝 Contributing
+
+Issues and PRs are welcome.
+
+This project is intentionally kept small, clean, and well-documented.
+
+## 📄 License
+
+ISC
+
+
+---

package/bin/create-sdk.js

@@ -1,261 +1,95 @@
-#!/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";
-
-/* ============================================================================
- * Environment checks
- * ============================================================================
- */
-
-const REQUIRED_NODE_MAJOR = 18;
-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}`
-  );
-  process.exit(1);
-}
-
-/* ============================================================================
- * CLI args & flags
- * ============================================================================
- */
-
-const rawArgs = process.argv.slice(2);
-
-const flags = {
-  yes: rawArgs.includes("--yes"),
-  noGit: rawArgs.includes("--no-git"),
-  noInstall: rawArgs.includes("--no-install"),
-};
-
-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");
-
-/* ============================================================================
- * Project name & interactive flow
- * ============================================================================
- */
-
-const argProjectName = rawArgs.find((a) => !a.startsWith("-"));
-
-let projectName;
-let initGit = !flags.noGit;
-let installDeps = !flags.noInstall;
-
-if (flags.yes && argProjectName) {
-  projectName = argProjectName;
-} else if (!argProjectName) {
-  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);
-      },
-    }
-  );
-
-  projectName = answers.name;
-  initGit = answers.initGit;
-  installDeps = answers.installDeps;
-} else {
-  projectName = argProjectName;
-}
-
-if (!projectName) {
-  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
- * ============================================================================
- */
-
-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"
-  );
-}
+#!/usr/bin/env node
+import process from "process";
+import prompts from "prompts";
+import { scaffold } from "../src/cli/scaffold.js";
+
+/* ============================================================================
+ * Node version check
+ * ============================================================================
+ */
+const REQUIRED_NODE_MAJOR = 18;
+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}`
+  );
+  process.exit(1);
+}
+
+/* ============================================================================
+ * 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"),
+};
+
+const projectName = rawArgs.find((a) => !a.startsWith("-"));
+
+/* ============================================================================
+ * Interactive mode
+ * ============================================================================
+ */
+let name = projectName;
+let initGit = !flags.noGit;
+let installDeps = !flags.noInstall;
+
+if (!flags.yes && !name) {
+  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) {
+  console.error("❌ Project name is required");
+  process.exit(1);
+}
+
+/* ============================================================================
+ * Execute scaffold
+ * ============================================================================
+ */
+await scaffold({
+  projectName: name,
+  initGit,
+  installDeps,
+  dryRun: flags.dryRun,
+  force: flags.force,
+});

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "@morda-dev/create-sdk",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "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"
@@ -29,21 +32,24 @@
     "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 }))\"",
-    "changeset": "changeset",
-    "version": "changeset version",
-    "release": "changeset publish"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "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"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.29.8",
     "@types/node": "^18.19.0",
+    "vitest": "^1.6.0",
+    "execa": "^9.6.1",
+    "fs-extra": "^11.3.3",
+    "tmp": "^0.2.5",
     "undici-types": "^7.16.0"
-  },
-  "license": "ISC"
+  }
 }

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,
+  };
+}