create-lacis 0.1.0

package/dist/index.js

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import * as p from "@clack/prompts";
+import { existsSync as existsSync3 } from "fs";
+import { rm } from "fs/promises";
+import { join as join3 } from "path";
+
+// src/scaffold.ts
+import { appendFile, cp, mkdir, readFile, rename, writeFile } from "fs/promises";
+import { existsSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var TEMPLATES = join(__dirname, "..", "templates");
+var VALIDATOR_DEPS = {
+  zod: { zod: "latest", "zod-to-json-schema": "latest" },
+  valibot: { valibot: "latest", "@valibot/to-json-schema": "latest" },
+  arktype: { arktype: "latest" },
+  none: {}
+};
+var PLATFORM_GITIGNORE_EXTRAS = {
+  vercel: ".vercel\n",
+  netlify: ".netlify\n"
+};
+var PLATFORM_TEMPLATE = {
+  node: "base",
+  bun: "bun",
+  vercel: "vercel",
+  netlify: "netlify"
+};
+var ROUTE_CONTENT = {
+  none: `import type { Request, Response } from 'lacis'
+
+export const GET = async (_req: Request, res: Response) => {
+  res.status(200).json({ message: 'Hello from lacis!' })
+}
+`,
+  zod: `import { defineHandler } from 'lacis'
+import { z } from 'zod'
+
+export const GET = defineHandler({
+  query: z.object({ name: z.string().optional() }),
+  meta: { summary: 'Hello endpoint', tags: ['hello'] },
+  handler: async (req, res) => {
+    const { name } = req.query
+    res.status(200).json({ message: \`Hello, \${name ?? 'world'}!\` })
+  },
+})
+`,
+  valibot: `import { defineHandler } from 'lacis'
+import * as v from 'valibot'
+
+export const GET = defineHandler({
+  query: v.object({ name: v.optional(v.string()) }),
+  meta: { summary: 'Hello endpoint', tags: ['hello'] },
+  handler: async (req, res) => {
+    const { name } = req.query
+    res.status(200).json({ message: \`Hello, \${name ?? 'world'}!\` })
+  },
+})
+`,
+  arktype: `import { defineHandler } from 'lacis'
+import { type } from 'arktype'
+
+export const GET = defineHandler({
+  query: type({ 'name?': 'string' }),
+  meta: { summary: 'Hello endpoint', tags: ['hello'] },
+  handler: async (req, res) => {
+    const { name } = req.query
+    res.status(200).json({ message: \`Hello, \${name ?? 'world'}!\` })
+  },
+})
+`
+};
+async function scaffold({ name, platform, validator, targetDir }) {
+  await mkdir(targetDir, { recursive: true });
+  await cp(join(TEMPLATES, "_common"), targetDir, { recursive: true });
+  await cp(join(TEMPLATES, PLATFORM_TEMPLATE[platform] ?? "base"), targetDir, { recursive: true });
+  const gitignoreSrc = join(targetDir, "_gitignore");
+  if (existsSync(gitignoreSrc)) {
+    await rename(gitignoreSrc, join(targetDir, ".gitignore"));
+  }
+  const extras = PLATFORM_GITIGNORE_EXTRAS[platform];
+  if (extras) await appendFile(join(targetDir, ".gitignore"), extras);
+  const pkgPath = join(targetDir, "package.json");
+  const pkg = JSON.parse((await readFile(pkgPath, "utf-8")).replace(/\{\{name\}\}/g, name));
+  pkg.dependencies = { ...pkg.dependencies, ...VALIDATOR_DEPS[validator] ?? {} };
+  await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+  await writeFile(
+    join(targetDir, "routes", "index.ts"),
+    ROUTE_CONTENT[validator] ?? ROUTE_CONTENT.none,
+    "utf-8"
+  );
+}
+
+// src/install.ts
+import { existsSync as existsSync2 } from "fs";
+import { join as join2 } from "path";
+import { execSync } from "child_process";
+var INSTALL_CMD = {
+  bun: "bun install",
+  pnpm: "pnpm install",
+  yarn: "yarn install",
+  npm: "npm install"
+};
+function detectPackageManager() {
+  const cwd = process.cwd();
+  if (existsSync2(join2(cwd, "bun.lock")) || existsSync2(join2(cwd, "bun.lockb"))) return "bun";
+  if (existsSync2(join2(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync2(join2(cwd, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+function install({ targetDir, pm }) {
+  const cmd = INSTALL_CMD[pm] ?? "npm install";
+  try {
+    execSync(cmd, { cwd: targetDir, stdio: "pipe" });
+  } catch (err) {
+    throw new Error(err.stderr?.toString().trim() ?? String(err));
+  }
+}
+
+// src/index.ts
+async function main() {
+  console.log();
+  p.intro("lacis \u2014 create a new project");
+  const name = await p.text({
+    message: "Project name?",
+    placeholder: "my-app",
+    defaultValue: "my-app",
+    validate(value) {
+      const v = value || "my-app";
+      if (!/^[a-z0-9][a-z0-9\-_.]*$/.test(v)) return "Lowercase letters, numbers, - _ or . only";
+      if (existsSync3(join3(process.cwd(), v))) return `"${v}" already exists`;
+    }
+  });
+  if (p.isCancel(name)) {
+    p.cancel("Cancelled");
+    process.exit(0);
+  }
+  const projectName = name || "my-app";
+  const platform = await p.select({
+    message: "Platform?",
+    options: [
+      { value: "node", label: "Node", hint: "default" },
+      { value: "bun", label: "Bun" },
+      { value: "vercel", label: "Vercel" },
+      { value: "netlify", label: "Netlify" }
+    ]
+  });
+  if (p.isCancel(platform)) {
+    p.cancel("Cancelled");
+    process.exit(0);
+  }
+  const validator = await p.select({
+    message: "Add a validation library?",
+    options: [
+      { value: "none", label: "None" },
+      { value: "zod", label: "Zod", hint: "most popular" },
+      { value: "valibot", label: "Valibot", hint: "smallest bundle" },
+      { value: "arktype", label: "ArkType", hint: "native JSON Schema" }
+    ]
+  });
+  if (p.isCancel(validator)) {
+    p.cancel("Cancelled");
+    process.exit(0);
+  }
+  const targetDir = join3(process.cwd(), projectName);
+  const s = p.spinner();
+  s.start("Scaffolding...");
+  try {
+    await scaffold({
+      name: projectName,
+      platform,
+      validator,
+      targetDir
+    });
+    s.stop("Scaffolded.");
+  } catch (err) {
+    s.stop("Scaffolding failed.");
+    await rm(targetDir, { recursive: true, force: true }).catch(() => {
+    });
+    p.cancel(String(err));
+    process.exit(1);
+  }
+  const pm = detectPackageManager();
+  s.start("Installing packages...");
+  try {
+    install({ targetDir, pm });
+    s.stop("Packages installed.");
+  } catch {
+    s.stop(`Install failed \u2014 run manually: cd ${projectName} && ${pm} install`);
+  }
+  p.note(`cd ${projectName}
+lacis dev`, "Next steps");
+  p.outro("Done!");
+}
+main().catch((err) => {
+  console.error("[create-lacis]", err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "create-lacis",
+  "version": "0.1.0",
+  "description": "Create a new lacis project",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/getlacis/create-lacis"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "create-lacis": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "validate": "tsx scripts/validate.ts",
+    "test": "tsx scripts/test.ts",
+    "prepack": "npm run build && tsx scripts/validate.ts"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.5",
+    "tsup": "^8.5.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.0"
+  }
+}

package/templates/_common/_gitignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+.env

package/templates/_common/routes/index.ts

@@ -0,0 +1,5 @@
+import type { Request, Response } from 'lacis'
+
+export const GET = async (_req: Request, res: Response) => {
+  res.status(200).json({ message: 'Hello from lacis!' })
+}

package/templates/_common/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "exclude": ["node_modules"]
+}

package/templates/base/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "lacis build",
+    "dev": "tsx watch server.ts"
+  },
+  "dependencies": {
+    "lacis": "latest"
+  },
+  "devDependencies": {
+    "tsx": "latest"
+  }
+}

package/templates/base/server.ts

@@ -0,0 +1,4 @@
+import { createServer, getRoutesDir } from 'lacis'
+
+const routesDir = getRoutesDir()
+createServer(routesDir, { platform: 'node', port: 3000 })

package/templates/bun/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "lacis build",
+    "dev": "bun --watch server.ts"
+  },
+  "dependencies": {
+    "lacis": "latest"
+  }
+}

package/templates/bun/server.ts

@@ -0,0 +1,4 @@
+import { createServer, getRoutesDir } from 'lacis'
+
+const routesDir = getRoutesDir()
+createServer(routesDir, { platform: 'bun', port: 3000 })

package/templates/netlify/netlify/functions/index.ts

@@ -0,0 +1,5 @@
+import { netlifyAdapter } from 'lacis/adapters'
+import { routes } from '../../routes/_manifest.js'
+
+const handler = netlifyAdapter.createHandler({ routes }) as Function
+export { handler }

package/templates/netlify/netlify.toml

@@ -0,0 +1,12 @@
+[build]
+  command = "npm run build"
+
+[functions]
+  directory = "netlify/functions"
+  node_bundler = "esbuild"
+
+[[redirects]]
+  from = "/*"
+  to = "/.netlify/functions/index"
+  status = 200
+  force = true

package/templates/netlify/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "lacis build",
+    "dev": "lacis dev"
+  },
+  "dependencies": {
+    "lacis": "latest"
+  }
+}

package/templates/vercel/api/index.ts

@@ -0,0 +1,4 @@
+import { vercelAdapter } from 'lacis/adapters'
+import { routes } from '../routes/_manifest.js'
+
+export default vercelAdapter.createHandler({ routes })

package/templates/vercel/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "lacis build",
+    "dev": "lacis dev"
+  },
+  "dependencies": {
+    "lacis": "latest"
+  }
+}

package/templates/vercel/vercel.json

@@ -0,0 +1,3 @@
+{
+  "rewrites": [{ "source": "/(.*)", "destination": "/api/index" }]
+}