@seeksaas/cli 0.0.2

package/README.md

@@ -0,0 +1 @@
+# SeekSaaS CLI

package/README.use.md

@@ -0,0 +1,70 @@
+## Versioning
+
+The package version is controlled by the `version` field in `package.json`.
+
+Use `pnpm version` from this workspace when bumping releases:
+
+```bash
+pnpm --filter @seeksaas/cli version patch
+pnpm --filter @seeksaas/cli version minor
+pnpm --filter @seeksaas/cli version major
+```
+
+Version bump examples:
+
+```text
+0.0.1 -> patch -> 0.0.2
+0.0.1 -> minor -> 0.1.0
+0.0.1 -> major -> 1.0.0
+```
+
+To set an exact version:
+
+```bash
+pnpm --filter @seeksaas/cli version 0.1.0
+```
+
+To update `package.json` without creating a git tag:
+
+```bash
+pnpm --filter @seeksaas/cli version patch --no-git-tag-version
+```
+
+## Publishing
+
+Use pnpm for publishing this workspace package. Do not use npm or yarn to
+manage dependencies in this repository.
+
+Log in to the official npm registry before publishing:
+
+```bash
+pnpm login --registry https://registry.npmjs.org/
+```
+
+Preview the package before publishing:
+
+```bash
+pnpm --filter @seeksaas/cli release:dry-run
+```
+
+Publish the public npm package:
+
+```bash
+pnpm --filter @seeksaas/cli release
+```
+
+The release scripts build the package before running `pnpm publish`.
+They pass `--no-git-checks` because the build step may update package output
+before publish runs. Check `git diff` yourself before publishing.
+They also pass `--registry https://registry.npmjs.org/` so publishing does not
+accidentally target a local mirror registry.
+
+The package already declares:
+
+```json
+{
+  "publishConfig": {
+    "access": "public"
+  }
+}
+```

package/dist/index.mjs

@@ -0,0 +1,337 @@
+#!/usr/bin/env node
+import { cac } from "cac";
+import path from "node:path";
+import { cancel, confirm, intro, isCancel, outro, select, spinner, text } from "@clack/prompts";
+import chalk from "chalk";
+import { access, mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
+import { spawn } from "node:child_process";
+
+//#region src/core/errors.ts
+function fail(message) {
+	console.error(chalk.red(message));
+	process.exit(1);
+}
+function formatError(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+
+//#endregion
+//#region src/core/fs.ts
+async function exists(filePath) {
+	try {
+		await access(filePath);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function isDirectoryEmpty(dir) {
+	try {
+		return (await readdir(dir)).length === 0;
+	} catch {
+		return false;
+	}
+}
+async function assertCreatableTarget(targetDir) {
+	if (!await exists(targetDir)) return;
+	if (!(await stat(targetDir)).isDirectory()) throw new Error(`Target exists and is not a directory: ${targetDir}`);
+	if (!await isDirectoryEmpty(targetDir)) throw new Error(`Target directory is not empty: ${targetDir}`);
+}
+async function removeIfExists(filePath) {
+	if (await exists(filePath)) await rm(filePath, {
+		recursive: true,
+		force: true
+	});
+}
+async function renameIfNeeded(source, target) {
+	if (source === target) return;
+	if (await exists(target)) throw new Error(`Cannot rename because target already exists: ${target}`);
+	await rename(source, target);
+}
+function toPackageName(projectName) {
+	return projectName.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function resolveTargetDir(projectName, cwd = process.cwd()) {
+	return projectName === "." ? cwd : path.resolve(cwd, projectName);
+}
+
+//#endregion
+//#region src/core/runtime.ts
+async function runCommand(command, args, options = {}) {
+	return await new Promise((resolve, reject) => {
+		const child = spawn(command, [...args], {
+			cwd: options.cwd,
+			stdio: options.stdio === "inherit" ? "inherit" : [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		let stdout = "";
+		let stderr = "";
+		if (child.stdout) child.stdout.on("data", (chunk) => {
+			stdout += chunk.toString();
+		});
+		if (child.stderr) child.stderr.on("data", (chunk) => {
+			stderr += chunk.toString();
+		});
+		child.on("error", reject);
+		child.on("close", (code) => {
+			if (code === 0) {
+				resolve(stdout.trim());
+				return;
+			}
+			const detail = stderr.trim() || stdout.trim();
+			reject(new Error(detail || `${command} exited with code ${code ?? "unknown"}`));
+		});
+	});
+}
+async function hasCommand(command) {
+	try {
+		await runCommand(command, ["--version"]);
+		return true;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+//#region src/templates.ts
+const templates = [{
+	name: "seeksaas-react-router",
+	label: "SeekSaaS React Router",
+	repo: "git@github.com:seeksaas/seeksaas-react-router.git",
+	upstream: "https://github.com/seeksaas/seeksaas-react-router.git",
+	branch: "main"
+}];
+function getTemplate(name) {
+	return templates.find((template) => template.name === name);
+}
+
+//#endregion
+//#region src/modules/render-template.ts
+const SKIPPED_DIRS = new Set([
+	".git",
+	"node_modules",
+	"dist",
+	"build",
+	".turbo",
+	".cache"
+]);
+const TEXT_EXTENSIONS = new Set([
+	"",
+	".cjs",
+	".css",
+	".csv",
+	".html",
+	".js",
+	".json",
+	".jsx",
+	".md",
+	".mdx",
+	".mjs",
+	".toml",
+	".ts",
+	".tsx",
+	".txt",
+	".yaml",
+	".yml"
+]);
+function renderText(source, options) {
+	return source.replaceAll("__PROJECT_NAME__", options.projectName).replaceAll("__PACKAGE_NAME__", options.packageName).replaceAll("__TEMPLATE_NAME__", options.templateName).replaceAll("{{ projectName }}", options.projectName).replaceAll("{{projectName}}", options.projectName).replaceAll("{{ packageName }}", options.packageName).replaceAll("{{packageName}}", options.packageName).replaceAll("{{ templateName }}", options.templateName).replaceAll("{{templateName}}", options.templateName);
+}
+function renderPathSegment(source, options) {
+	return renderText(source, options);
+}
+function isLikelyTextFile(filePath) {
+	return TEXT_EXTENSIONS.has(path.extname(filePath).toLowerCase());
+}
+async function renderFile(filePath, options) {
+	if (!isLikelyTextFile(filePath)) return;
+	const source = await readFile(filePath, "utf8");
+	const rendered = renderText(source, options);
+	if (rendered !== source) await writeFile(filePath, rendered);
+}
+async function renderEntry(entryPath, options) {
+	const entryStat = await stat(entryPath);
+	if (entryStat.isDirectory()) {
+		if (SKIPPED_DIRS.has(path.basename(entryPath))) return;
+		const children = await readdir(entryPath);
+		for (const child of children) await renderEntry(path.join(entryPath, child), options);
+		await renameIfNeeded(entryPath, path.join(path.dirname(entryPath), renderPathSegment(path.basename(entryPath), options)));
+		return;
+	}
+	if (entryStat.isFile()) {
+		await renderFile(entryPath, options);
+		const renamed = path.join(path.dirname(entryPath), renderPathSegment(path.basename(entryPath), options));
+		if (renamed !== entryPath) await rename(entryPath, renamed);
+	}
+}
+async function renderRootPackageJson(options) {
+	const packageJsonPath = path.join(options.rootDir, "package.json");
+	if (!await exists(packageJsonPath)) return;
+	const source = await readFile(packageJsonPath, "utf8");
+	const packageJson = JSON.parse(source);
+	packageJson.name = options.packageName;
+	await writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`);
+}
+async function renderTemplate(options) {
+	const children = await readdir(options.rootDir);
+	for (const child of children) await renderEntry(path.join(options.rootDir, child), options);
+	await renderRootPackageJson(options);
+}
+
+//#endregion
+//#region src/modules/create-project.ts
+async function createProject(options) {
+	const template = getTemplate(options.templateName);
+	if (!template) throw new Error(`Unknown template: ${options.templateName}`);
+	if (!await hasCommand("git")) throw new Error("Git is required to download the template.");
+	if (options.install && !await hasCommand("pnpm")) throw new Error("pnpm is required when --install is enabled.");
+	const targetDir = resolveTargetDir(options.projectName);
+	const packageName = toPackageName(path.basename(targetDir));
+	if (!packageName) throw new Error("Project name must contain at least one letter or number.");
+	await assertCreatableTarget(targetDir);
+	await mkdir(path.dirname(targetDir), { recursive: true });
+	const repo = options.repo ?? template.repo;
+	await runCommand("git", [
+		"clone",
+		"--depth",
+		"1",
+		"--branch",
+		options.branch ?? template.branch,
+		repo,
+		targetDir
+	], { stdio: "inherit" });
+	await removeIfExists(path.join(targetDir, ".git"));
+	await renderTemplate({
+		rootDir: targetDir,
+		projectName: path.basename(targetDir),
+		packageName,
+		templateName: template.name
+	});
+	if (options.initGit) {
+		await runCommand("git", ["init"], { cwd: targetDir });
+		await runCommand("git", [
+			"remote",
+			"add",
+			"upstream",
+			template.upstream
+		], { cwd: targetDir });
+		await runCommand("git", ["add", "."], { cwd: targetDir });
+		await runCommand("git", [
+			"commit",
+			"-m",
+			"Initial commit"
+		], { cwd: targetDir });
+	}
+	if (options.install) await runCommand("pnpm", ["install"], {
+		cwd: targetDir,
+		stdio: "inherit"
+	});
+	return {
+		targetDir,
+		packageName,
+		templateName: template.name
+	};
+}
+
+//#endregion
+//#region src/commands/create.ts
+function handleCancel(value) {
+	if (isCancel(value)) {
+		cancel("Cancelled.");
+		process.exit(0);
+	}
+}
+async function resolveProjectName(input) {
+	if (input) return input;
+	const value = await text({
+		message: "Project name",
+		placeholder: "my-saas",
+		validate: (name) => {
+			if (!name.trim()) return "Project name is required.";
+		}
+	});
+	handleCancel(value);
+	return String(value).trim();
+}
+async function resolveTemplateName(input) {
+	if (input) return input;
+	const value = await select({
+		message: "Select template",
+		initialValue: templates[0]?.name,
+		options: templates.map((template) => ({
+			value: template.name,
+			label: template.label
+		}))
+	});
+	handleCancel(value);
+	return String(value);
+}
+async function resolveInstall(input) {
+	if (typeof input === "boolean") return input;
+	const value = await confirm({
+		message: "Install dependencies with pnpm?",
+		initialValue: true
+	});
+	handleCancel(value);
+	return Boolean(value);
+}
+function resolveInstallFlag(argv) {
+	if (argv.includes("--install")) return true;
+	if (argv.includes("--skip-install") || argv.includes("--no-install")) return false;
+}
+function resolveGitFlag(argv) {
+	if (argv.includes("--skip-git") || argv.includes("--no-git")) return false;
+	return true;
+}
+function registerCreateCommand(program$1) {
+	program$1.command("create [project-name]", "Create a SeekSaaS project").option("--template <name>", "Template name").option("--branch <branch>", "Template git branch").option("--repo <url>", "Override template repository URL").option("--install", "Install dependencies after creation").option("--skip-install", "Skip dependency installation").option("--git", "Initialize a fresh git repository").option("--skip-git", "Skip fresh git initialization").action(async (projectName, flags) => {
+		intro(chalk.cyan("SeekSaaS project creator"));
+		const resolvedProjectName = await resolveProjectName(projectName);
+		const templateName = await resolveTemplateName(flags.template);
+		const install = await resolveInstall(resolveInstallFlag(process.argv));
+		const initGit = resolveGitFlag(process.argv);
+		const s = spinner();
+		s.start("Creating project...");
+		try {
+			const created = await createProject({
+				projectName: resolvedProjectName,
+				templateName,
+				branch: flags.branch,
+				repo: flags.repo,
+				install,
+				initGit
+			});
+			s.stop("Project created.");
+			const relativeTarget = path.relative(process.cwd(), created.targetDir) || ".";
+			outro([
+				chalk.green(`Created ${created.packageName} from ${created.templateName}.`),
+				"",
+				"Next steps:",
+				`  cd ${relativeTarget}`,
+				install ? "  pnpm dev" : "  pnpm install",
+				install ? void 0 : "  pnpm dev"
+			].filter(Boolean).join("\n"));
+		} catch (error) {
+			s.stop("Project creation failed.");
+			fail(formatError(error));
+		}
+	});
+}
+
+//#endregion
+//#region src/index.ts
+const CLI_NAME = "seeksaas-cli";
+const CLI_VERSION = "0.0.1";
+const program = cac(CLI_NAME);
+program.usage("[command] [options]").version(CLI_VERSION, "-v, --version").help();
+program.example(`${CLI_NAME} create my-saas`);
+program.example(`${CLI_NAME} create my-saas --skip-install`);
+registerCreateCommand(program);
+program.parse();
+if (!program.matchedCommand && process.argv.length <= 2) program.outputHelp();
+
+//#endregion
+export {  };

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@seeksaas/cli",
+  "version": "0.0.2",
+  "description": "SeekSaaS Cli",
+  "bin": {
+    "seeksaas-cli": "./dist/index.mjs"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.4.0",
+    "cac": "^7.0.0",
+    "chalk": "^5.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.7.0",
+    "oxlint": "^1.65.0",
+    "rimraf": "^6.1.3",
+    "tsdown": "^0.17.0",
+    "tsx": "^4.22.1",
+    "typescript": "^6.0.3",
+    "@workspace/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsdown && chmod +x dist/index.mjs",
+    "cli:dev": "tsx src/index.ts",
+    "release": "pnpm run build && pnpm publish --access public --no-git-checks --registry https://registry.npmjs.org/",
+    "release:dry-run": "pnpm run build && pnpm publish --access public --dry-run --no-git-checks --registry https://registry.npmjs.org/",
+    "lint": "oxlint",
+    "format": "oxfmt --write",
+    "clean": "rimraf .cache .turbo dist node_modules"
+  }
+}