@morda-dev/create-sdk 1.1.3 → 1.2.0

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/.github/workflows/ci.yml

@@ -1,30 +1,30 @@
-name: CI
-
-on:
-  pull_request:
-    branches: [ main ]
-  push:
-    branches: [ main ]
-
-jobs:
-  build-and-api-check:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repo
-        uses: actions/checkout@v4
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: npm
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build
-        run: npm run build
-
-      - name: API Extractor check
-        run: npm run api:check
+name: CI
+
+on:
+  pull_request:
+    branches: [ main ]
+  push:
+    branches: [ main ]
+
+jobs:
+  build-and-api-check:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: API Extractor check
+        run: npm run api:check

package/template/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Morda Dev
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights  
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell  
-copies of the Software, and to permit persons to whom the Software is  
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in  
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR  
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE  
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER  
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING  
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS  
-IN THE SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Morda Dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights  
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell  
+copies of the Software, and to permit persons to whom the Software is  
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in  
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR  
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE  
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER  
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING  
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS  
+IN THE SOFTWARE.

package/template/README.md

@@ -1,49 +1,49 @@
-# @morda-dev/project-template
-
-Production-ready TypeScript SDK template with a strict public API, ESM-first setup,
-and best practices baked in.
-
-This package can be used as:
-- a base for building your own SDK
-- a reference for ESM + TypeScript library architecture
-- a starting point for production-ready npm packages
-
----
-
-## Installation
-
-```bash
-npm install @morda-dev/project-template
-```
-
-## Usage
-
-```ts
-import { getUser, sumAges } from '@morda-dev/project-template';
-
-const user = getUser(1);
-console.log(user);
-
-const totalAge = sumAges([
-  { id: 1, name: 'Alice', age: 20 },
-  { id: 2, name: 'Bob', age: 30 },
-]);
-
-console.log(totalAge);
-```
-
-## API
-### getUser(id: number)
-
-Returns a user wrapped in `ApiResult`.
-
-### sumAges(users: User[])
-
-Returns the sum of all user ages.
-
-## License
-
-ISC
-
-
----
+# @morda-dev/project-template
+
+Production-ready TypeScript SDK template with a strict public API, ESM-first setup,
+and best practices baked in.
+
+This package can be used as:
+- a base for building your own SDK
+- a reference for ESM + TypeScript library architecture
+- a starting point for production-ready npm packages
+
+---
+
+## Installation
+
+```bash
+npm install @morda-dev/project-template
+```
+
+## Usage
+
+```ts
+import { getUser, sumAges } from '@morda-dev/project-template';
+
+const user = getUser(1);
+console.log(user);
+
+const totalAge = sumAges([
+  { id: 1, name: 'Alice', age: 20 },
+  { id: 2, name: 'Bob', age: 30 },
+]);
+
+console.log(totalAge);
+```
+
+## API
+### getUser(id: number)
+
+Returns a user wrapped in `ApiResult`.
+
+### sumAges(users: User[])
+
+Returns the sum of all user ages.
+
+## License
+
+ISC
+
+
+---

package/template/api-extractor.json

@@ -1,19 +1,25 @@
 {
   "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
 
-  "mainEntryPointFilePath": "./dist/index.d.ts",
+  "projectFolder": ".",
+
+  "mainEntryPointFilePath": "<projectFolder>/dist/index.d.ts",
+
+  "dtsRollup": {
+    "enabled": false
+  },
 
   "apiReport": {
     "enabled": true,
-    "reportFileName": "project-template.api.md",
-    "reportFolder": "./etc"
+    "reportFolder": "<projectFolder>/api",
+    "reportFileName": "api-report.md"
   },
 
   "docModel": {
     "enabled": false
   },
 
-  "dtsRollup": {
+  "tsdocMetadata": {
     "enabled": false
   },
 
@@ -23,7 +29,6 @@
         "logLevel": "warning"
       }
     },
-
     "extractorMessageReporting": {
       "default": {
         "logLevel": "warning"

package/template/etc/project-template.api.md

@@ -1,32 +1,32 @@
-## API Report File for "@morda-dev/project-template"
-
-> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
-
-```ts
-
-// @public
-export type ApiResult<T> = {
-    success: true;
-    data: T;
-} | {
-    success: false;
-    error: string;
-};
-
-// @public
-export function getUser(id: number): ApiResult<User>;
-
-// @public
-export function sumAges(users: User[]): number;
-
-// @public
-export interface User {
-    // (undocumented)
-    age: number;
-    // (undocumented)
-    id: number;
-    // (undocumented)
-    name: string;
-}
-
-```
+## API Report File for "@morda-dev/project-template"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+// @public
+export type ApiResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+
+// @public
+export function getUser(id: number): ApiResult<User>;
+
+// @public
+export function sumAges(users: User[]): number;
+
+// @public
+export interface User {
+    // (undocumented)
+    age: number;
+    // (undocumented)
+    id: number;
+    // (undocumented)
+    name: string;
+}
+
+```

package/template/package.json

@@ -5,27 +5,26 @@
   "license": "ISC",
   "type": "module",
 
+  "sideEffects": false,
+
+  "engines": {
+    "node": ">=18"
+  },
+
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
 
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
 
   "files": [
-    "dist",
-    "etc"
+    "dist"
   ],
 
-  "sideEffects": false,
-
-  "engines": {
-    "node": ">=18"
-  },
-
   "repository": {
     "type": "git",
     "url": "https://github.com/mordaHQ/project-template.git"

package/template/src/index.ts

@@ -1,25 +1,25 @@
-/**
- * @packageDocumentation
- *
- * Production-ready TypeScript SDK template.
- *
- * This file defines the public API surface of the package.
- * Only symbols exported from this file are considered stable
- * and part of the public contract.
- */
-
-/* ============================================================================
- * Types (Public)
- * ============================================================================
- */
-
-/** @public */
-export type { User, ApiResult } from "./types/user.js";
-
-/* ============================================================================
- * Functions (Public)
- * ============================================================================
- */
-
-/** @public */
-export { getUser, sumAges } from "./modules/user.js";
+/**
+ * @packageDocumentation
+ *
+ * Production-ready TypeScript SDK template.
+ *
+ * This file defines the public API surface of the package.
+ * Only symbols exported from this file are considered stable
+ * and part of the public contract.
+ */
+
+/* ============================================================================
+ * Types (Public)
+ * ============================================================================
+ */
+
+/** @public */
+export type { User, ApiResult } from "./types/user.js";
+
+/* ============================================================================
+ * Functions (Public)
+ * ============================================================================
+ */
+
+/** @public */
+export { getUser, sumAges } from "./modules/user.js";

package/template/src/modules/user.ts

@@ -1,31 +1,31 @@
-import { ApiResult, User } from "../types/user.js";
-
-/**
- * @public
- * Get a user by id
- */
-export function getUser(id: number): ApiResult<User> {
-  if (id <= 0) {
-    return {
-      success: false,
-      error: "Invalid user id",
-    };
-  }
-
-  return {
-    success: true,
-    data: {
-      id,
-      name: "John Doe",
-      age: 30,
-    },
-  };
-}
-
-/**
- * @public
- * Sum ages of users
- */
-export function sumAges(users: User[]): number {
-  return users.reduce((sum, user) => sum + user.age, 0);
-}
+import { ApiResult, User } from "../types/user.js";
+
+/**
+ * @public
+ * Get a user by id
+ */
+export function getUser(id: number): ApiResult<User> {
+  if (id <= 0) {
+    return {
+      success: false,
+      error: "Invalid user id",
+    };
+  }
+
+  return {
+    success: true,
+    data: {
+      id,
+      name: "John Doe",
+      age: 30,
+    },
+  };
+}
+
+/**
+ * @public
+ * Sum ages of users
+ */
+export function sumAges(users: User[]): number {
+  return users.reduce((sum, user) => sum + user.age, 0);
+}