@stratify/cli 0.2.3 → 0.2.4

package/README.md

@@ -12,8 +12,16 @@ npm install -g @stratify/cli
 
 ## Usage
 
+With `npx` (no global install required):
+
+```bash
+npx @stratify/cli new <app-name>
+```
+
+Or, after a global install:
+
 ```bash
-npx stratify-cli new <app-name>
+stratify-cli new <app-name>
 ```
 
 Creates a new project with:

package/dist/bin.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { runNew } from "./new.js";
+function sanitizeAppName(value) {
+    if (!value) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.includes("..") || /[\\/]/.test(trimmed)) {
+        return undefined;
+    }
+    return /^[a-z0-9][a-z0-9-_]*$/i.test(trimmed) ? trimmed : undefined;
+}
+async function main() {
+    const [cmd, rawName] = process.argv.slice(2).map((arg) => arg?.trim());
+    if (!cmd || cmd !== "new") {
+        console.error(`Usage:
+  npx @stratify/cli new <app-name>
+
+Commands:
+  new        Scaffold a new Stratify app
+`);
+        process.exit(1);
+    }
+    const name = sanitizeAppName(rawName);
+    if (!name) {
+        console.error("Please provide a valid app name (letters, numbers, dashes or underscores), e.g. npx @stratify/cli new my-app");
+        process.exit(1);
+    }
+    const templateDir = resolve(new URL("../template", import.meta.url).pathname);
+    await runNew({ appName: name, templateDir });
+}
+main().catch((err) => {
+    console.error(err?.stack || String(err));
+    process.exit(1);
+});

package/dist/new.js

@@ -0,0 +1,59 @@
+import { promises as fs } from "node:fs";
+import { join, resolve } from "node:path";
+async function pathExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function copyDir(src, dest) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const e of entries) {
+        const s = join(src, e.name);
+        const d = join(dest, e.name);
+        if (e.isDirectory()) {
+            await copyDir(s, d);
+        }
+        else if (e.isFile()) {
+            await fs.copyFile(s, d);
+        }
+    }
+}
+async function replaceFileContent(p, replacer) {
+    const s = await fs.readFile(p, "utf8");
+    await fs.writeFile(p, replacer(s), "utf8");
+}
+async function finalizeGitignore(target) {
+    const src = join(target, "_gitignore");
+    const dest = join(target, ".gitignore");
+    try {
+        await fs.rename(src, dest);
+    }
+    catch {
+        // no _gitignore — ignore silently
+    }
+}
+export async function runNew({ appName, templateDir }) {
+    const target = resolve(process.cwd(), appName);
+    if (await pathExists(target)) {
+        throw new Error(`Directory "${appName}" already exists.`);
+    }
+    await copyDir(templateDir, target);
+    const pkgPath = join(target, "package.json");
+    await replaceFileContent(pkgPath, (s) => s.replace(/"name":\s*".+?"/, `"name": "${appName}"`));
+    await finalizeGitignore(target);
+    console.log(`\nScaffolded "${appName}" successfully.
+
+Next steps:
+
+  cd ${appName}
+  npm install
+  npm run dev
+
+Happy hacking with Stratify!
+`);
+}

package/dist/test/new.test.js

@@ -0,0 +1,54 @@
+import { test, describe } from "node:test";
+import assert from "node:assert/strict";
+import { promises as fs } from "node:fs";
+import { join, resolve } from "node:path";
+import { tmpdir } from "node:os";
+import { mkdtemp, rm } from "node:fs/promises";
+import { runNew } from "../new";
+const TEMPLATE_FIXTURE = resolve("template");
+async function pathExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+describe("runNew()", () => {
+    test("copies template and replaces package name", async () => {
+        const tmpRoot = await mkdtemp(join(tmpdir(), "stratify-cli-"));
+        const appName = "my-app";
+        const target = join(tmpRoot, appName);
+        const prevCwd = process.cwd();
+        process.chdir(tmpRoot);
+        try {
+            await runNew({ appName, templateDir: TEMPLATE_FIXTURE });
+            const pkgPath = join(target, "package.json");
+            assert.ok(await pathExists(pkgPath), "package.json should exist");
+            const pkg = JSON.parse(await fs.readFile(pkgPath, "utf8"));
+            assert.equal(pkg.name, appName);
+            const srcDir = join(target, "src");
+            assert.ok(await pathExists(srcDir), "src/ should exist");
+        }
+        finally {
+            process.chdir(prevCwd);
+            await rm(tmpRoot, { recursive: true, force: true });
+        }
+    });
+    test("throws if target directory already exists", async () => {
+        const tmpRoot = await mkdtemp(join(tmpdir(), "stratify-cli-"));
+        const appName = "existing-app";
+        const target = join(tmpRoot, appName);
+        await fs.mkdir(target, { recursive: true });
+        const prevCwd = process.cwd();
+        process.chdir(tmpRoot);
+        try {
+            await assert.rejects(() => runNew({ appName, templateDir: TEMPLATE_FIXTURE }), /already exists/);
+        }
+        finally {
+            process.chdir(prevCwd);
+            await rm(tmpRoot, { recursive: true, force: true });
+        }
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stratify/cli",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "type": "module",
   "bin": {
     "stratify-cli": "./dist/bin.js"