@project-ajax/create 0.0.0

package/CODEOWNERS

@@ -0,0 +1 @@
+* @makenotion/ajax-reviewers

package/README.md

@@ -0,0 +1,9 @@
+# @project-ajax/create
+
+A CLI for creating new Project Ajax workers projects.
+
+## Usage
+
+```bash
+npm init @project-ajax
+```

package/package.json

@@ -0,0 +1,17 @@
+{
+	"name": "@project-ajax/create",
+	"version": "0.0.0",
+	"description": "Initialize a new Notion Project Ajax extensions repo.",
+	"bin": {
+		"create-ajax": "src/index.js"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"dependencies": {
+		"chalk": "^5.3.0",
+		"execa": "^8.0.0",
+		"ora": "^8.0.1",
+		"prompts": "^2.4.2"
+	}
+}

package/src/index.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import chalk from "chalk";
+import { execa } from "execa";
+import ora from "ora";
+import prompts from "prompts";
+
+run();
+
+async function run() {
+	console.log(
+		chalk.bold.cyan("\n🚀 Create a new Project Ajax worker\n"),
+	);
+
+	const { directoryName, projectName } = await prompts([
+		{
+			type: "text",
+			name: "directoryName",
+			message: "Path to the new worker project:",
+			initial: ".",
+		},
+		{
+			type: "text",
+			name: "projectName",
+			message: "Project name:",
+			initial: "my-worker",
+		},
+	]);
+
+	if (!directoryName || !projectName) {
+		console.log(chalk.red("Cancelled."));
+		process.exit(1);
+	}
+
+	const spinner = ora("Setting up template...").start();
+
+	let tempDir;
+
+	try {
+		// Create a temporary directory for sparse checkout
+		tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "project-ajax-"));
+
+		spinner.text = "Fetching template from repository...";
+		await pullCode(tempDir);
+
+		spinner.text = "Preparing destination...";
+		const destPath = prepareDestination(directoryName);
+
+		spinner.text = "Copying template files...";
+		copyTemplate(tempDir, destPath);
+
+		spinner.text = "Customizing package.json...";
+		customizePackageJson(destPath, projectName);
+
+		spinner.succeed(chalk.green("Worker project created successfully!"));
+
+		printNextSteps(directoryName);
+	} catch (err) {
+		spinner.fail("Failed to create project.");
+		console.error(chalk.red(`\n${err.message}`));
+
+		if (
+			err.message.includes("Permission denied") ||
+			err.message.includes("publickey")
+		) {
+			console.log(
+				chalk.yellow("\n⚠️  SSH authentication failed. Make sure you have:"),
+			);
+			console.log("  1. SSH keys set up with GitHub");
+			console.log("  2. Added your SSH key to your GitHub account");
+			console.log(
+				"  3. See: https://docs.github.com/en/authentication/connecting-to-github-with-ssh",
+			);
+		}
+
+		process.exit(1);
+	} finally {
+		// Clean up the temporary directory.
+		if (tempDir) {
+			try {
+				fs.rmSync(tempDir, { recursive: true, force: true });
+			} catch {
+				// Ignore cleanup errors.
+			}
+		}
+	}
+};
+
+
+/**
+ * Pulls the template code from the repository using sparse checkout
+ * @param tempDir Temporary directory path
+ */
+async function pullCode(tempDir) {
+	// Initialize git repo with sparse checkout
+	await execa("git", ["init"], { cwd: tempDir });
+	await execa(
+		"git",
+		["remote", "add", "origin", "git@github.com:makenotion/project-ajax.git"],
+		{ cwd: tempDir },
+	);
+	await execa("git", ["config", "core.sparseCheckout", "true"], {
+		cwd: tempDir,
+	});
+
+	// Configure sparse checkout to only get packages/template
+	const sparseCheckoutPath = path.join(
+		tempDir,
+		".git",
+		"info",
+		"sparse-checkout",
+	);
+	fs.writeFileSync(sparseCheckoutPath, "packages/template/*\n");
+
+	// Pull only the template directory
+	await execa("git", ["pull", "--depth=1", "origin", "main"], {
+		cwd: tempDir,
+	});
+}
+
+/**
+ * Prepares and validates the destination directory
+ * @param repoName Project name or "." for current directory
+ * @returns The resolved destination path
+ */
+function prepareDestination(repoName) {
+	const destPath =
+		repoName === "." ? process.cwd() : path.resolve(process.cwd(), repoName);
+
+	// Check if destination has any files
+	if (fs.existsSync(destPath)) {
+		const files = fs.readdirSync(destPath);
+		if (files.length > 0) {
+			throw new Error(
+				`Destination directory "${repoName}" is not empty. Please use an empty directory.`,
+			);
+		}
+	} else if (repoName !== ".") {
+		// Create destination directory if it doesn't exist
+		fs.mkdirSync(destPath, { recursive: true });
+	}
+
+	return destPath;
+}
+
+/**
+ * Copies template files from temporary directory to destination
+ * @param tempDir Temporary directory path
+ * @param destPath Destination directory path
+ */
+function copyTemplate(tempDir, destPath) {
+	const templatePath = path.join(tempDir, "packages", "template");
+	const templateFiles = fs.readdirSync(templatePath);
+
+	for (const file of templateFiles) {
+		const srcPath = path.join(templatePath, file);
+		const destFilePath = path.join(destPath, file);
+		fs.cpSync(srcPath, destFilePath, { recursive: true });
+	}
+}
+
+/**
+ * Updates package.json with the project name
+ * @param destPath Destination directory path
+ * @param projectName Name for the project
+ */
+function customizePackageJson(destPath, projectName) {
+	const packageJsonPath = path.join(destPath, "package.json");
+	const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+	packageJson.name = projectName;
+	fs.writeFileSync(
+		packageJsonPath,
+		`${JSON.stringify(packageJson, null, 2)}\n`,
+	);
+}
+
+/**
+ * Prints next steps instructions
+ * @param directoryName Directory name or "." for current directory
+ */
+function printNextSteps(directoryName) {
+	console.log(chalk.cyan(`\n✨ Next steps:`));
+	if (directoryName === ".") {
+		console.log(`
+  ${chalk.bold("npm install")}
+  ${chalk.bold("npx workers auth login")}
+  ${chalk.bold("npx workers deploy")}
+    `);
+	} else {
+		console.log(`
+  ${chalk.bold(`cd ${directoryName}`)}
+  ${chalk.bold("npm install")}
+  ${chalk.bold("npx workers auth login")}
+  ${chalk.bold("npx workers deploy")}
+    `);
+	}
+}