bunforge 1.0.0

package/README.md

@@ -0,0 +1,71 @@
+# bunforge
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.3.11. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+
+# bunforge
+
+A zero-config CLI scaffolder for Bun projects with optional Prisma + JWT auth.
+
+## Install & run
+````bash
+# From within the bunforge repo
+bun start
+````
+
+## What it does
+````
+bunforge
+  ├── asks for a project name
+  ├── runs bun init -y
+  ├── [optional] installs & configures Prisma (PostgreSQL + pg adapter)
+  │     ├── bun add prisma @types/pg @prisma/client @prisma/adapter-pg pg dotenv
+  │     ├── bunx prisma init
+  │     ├── writes src/db.ts  (PrismaClient with PrismaPg adapter)
+  │     └── appends users model + ROLE enum to prisma/schema.prisma
+  └── [optional, requires Prisma] scaffolds JWT auth
+        ├── bun add express @types/express jsonwebtoken @types/jsonwebtoken zod
+        ├── writes src/Types/types.ts  (SignupSchema, SigninSchema via Zod)
+        └── writes src/index.ts  (Express server, /api/auth/signup & /api/auth/login)
+````
+
+## Post-scaffold workflow
+````bash
+cd <your-project>
+
+# 1. Fill in your real DB connection
+nano .env           # set DATABASE_URL, JWT_SECRET
+
+# 2. Run first migration
+bunx prisma migrate dev --name init
+
+# 3. Start dev server
+bun run src/index.ts
+````
+
+## API
+
+| Method | Path              | Body                          | Response                     |
+|--------|-------------------|-------------------------------|------------------------------|
+| POST   | /api/auth/signup  | `{ email, password }`        | `{ success: true }`          |
+| POST   | /api/auth/login   | `{ email, password }`        | `{ success, data: { token, user } }` |
+
+## Protecting routes
+````typescript
+import { authMiddleware } from "./index";
+
+app.get("/api/me", authMiddleware(), (req, res) => {
+  res.json({ id: req.id, role: req.role });
+});
+````

package/bun.lock

@@ -0,0 +1,91 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "dependencies": {
+        "@clack/prompts": "^1.2.0",
+        "execa": "^9.6.1",
+        "picocolors": "^1.1.1",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+        "@types/node": "^25.5.0",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@clack/core": ["@clack/core@1.2.0", "", { "dependencies": { "fast-wrap-ansi": "^0.1.3", "sisteransi": "^1.0.5" } }, "sha512-qfxof/3T3t9DPU/Rj3OmcFyZInceqj/NVtO9rwIuJqCUgh32gwPjpFQQp/ben07qKlhpwq7GzfWpST4qdJ5Drg=="],
+
+    "@clack/prompts": ["@clack/prompts@1.2.0", "", { "dependencies": { "@clack/core": "1.2.0", "fast-string-width": "^1.1.0", "fast-wrap-ansi": "^0.1.3", "sisteransi": "^1.0.5" } }, "sha512-4jmztR9fMqPMjz6H/UZXj0zEmE43ha1euENwkckKKel4XpSfokExPo5AiVStdHSAlHekz4d0CA/r45Ok1E4D3w=="],
+
+    "@sec-ant/readable-stream": ["@sec-ant/readable-stream@0.4.1", "", {}, "sha512-831qok9r2t8AlxLko40y2ebgSDhenenCatLVeW/uBtnHPyhHOvG0C7TvfgecV+wHzIm5KUICgzmVpWS+IMEAeg=="],
+
+    "@sindresorhus/merge-streams": ["@sindresorhus/merge-streams@4.0.0", "", {}, "sha512-tlqY9xq5ukxTUZBmoOp+m61cqwQD5pHJtFY3Mn8CA8ps6yghLH/Hw8UPdqg4OLmFW3IFlcXnQNmo/dh8HzXYIQ=="],
+
+    "@types/bun": ["@types/bun@1.3.11", "", { "dependencies": { "bun-types": "1.3.11" } }, "sha512-5vPne5QvtpjGpsGYXiFyycfpDF2ECyPcTSsFBMa0fraoxiQyMJ3SmuQIGhzPg2WJuWxVBoxWJ2kClYTcw/4fAg=="],
+
+    "@types/node": ["@types/node@25.5.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw=="],
+
+    "bun-types": ["bun-types@1.3.11", "", { "dependencies": { "@types/node": "*" } }, "sha512-1KGPpoxQWl9f6wcZh57LvrPIInQMn2TQ7jsgxqpRzg+l0QPOFvJVH7HmvHo/AiPgwXy+/Thf6Ov3EdVn1vOabg=="],
+
+    "cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
+
+    "execa": ["execa@9.6.1", "", { "dependencies": { "@sindresorhus/merge-streams": "^4.0.0", "cross-spawn": "^7.0.6", "figures": "^6.1.0", "get-stream": "^9.0.0", "human-signals": "^8.0.1", "is-plain-obj": "^4.1.0", "is-stream": "^4.0.1", "npm-run-path": "^6.0.0", "pretty-ms": "^9.2.0", "signal-exit": "^4.1.0", "strip-final-newline": "^4.0.0", "yoctocolors": "^2.1.1" } }, "sha512-9Be3ZoN4LmYR90tUoVu2te2BsbzHfhJyfEiAVfz7N5/zv+jduIfLrV2xdQXOHbaD6KgpGdO9PRPM1Y4Q9QkPkA=="],
+
+    "fast-string-truncated-width": ["fast-string-truncated-width@1.2.1", "", {}, "sha512-Q9acT/+Uu3GwGj+5w/zsGuQjh9O1TyywhIwAxHudtWrgF09nHOPrvTLhQevPbttcxjr/SNN7mJmfOw/B1bXgow=="],
+
+    "fast-string-width": ["fast-string-width@1.1.0", "", { "dependencies": { "fast-string-truncated-width": "^1.2.0" } }, "sha512-O3fwIVIH5gKB38QNbdg+3760ZmGz0SZMgvwJbA1b2TGXceKE6A2cOlfogh1iw8lr049zPyd7YADHy+B7U4W9bQ=="],
+
+    "fast-wrap-ansi": ["fast-wrap-ansi@0.1.6", "", { "dependencies": { "fast-string-width": "^1.1.0" } }, "sha512-HlUwET7a5gqjURj70D5jl7aC3Zmy4weA1SHUfM0JFI0Ptq987NH2TwbBFLoERhfwk+E+eaq4EK3jXoT+R3yp3w=="],
+
+    "figures": ["figures@6.1.0", "", { "dependencies": { "is-unicode-supported": "^2.0.0" } }, "sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg=="],
+
+    "get-stream": ["get-stream@9.0.1", "", { "dependencies": { "@sec-ant/readable-stream": "^0.4.1", "is-stream": "^4.0.1" } }, "sha512-kVCxPF3vQM/N0B1PmoqVUqgHP+EeVjmZSQn+1oCRPxd2P21P2F19lIgbR3HBosbB1PUhOAoctJnfEn2GbN2eZA=="],
+
+    "human-signals": ["human-signals@8.0.1", "", {}, "sha512-eKCa6bwnJhvxj14kZk5NCPc6Hb6BdsU9DZcOnmQKSnO1VKrfV0zCvtttPZUsBvjmNDn8rpcJfpwSYnHBjc95MQ=="],
+
+    "is-plain-obj": ["is-plain-obj@4.1.0", "", {}, "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg=="],
+
+    "is-stream": ["is-stream@4.0.1", "", {}, "sha512-Dnz92NInDqYckGEUJv689RbRiTSEHCQ7wOVeALbkOz999YpqT46yMRIGtSNl2iCL1waAZSx40+h59NV/EwzV/A=="],
+
+    "is-unicode-supported": ["is-unicode-supported@2.1.0", "", {}, "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ=="],
+
+    "isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
+
+    "npm-run-path": ["npm-run-path@6.0.0", "", { "dependencies": { "path-key": "^4.0.0", "unicorn-magic": "^0.3.0" } }, "sha512-9qny7Z9DsQU8Ou39ERsPU4OZQlSTP47ShQzuKZ6PRXpYLtIFgl/DEBYEXKlvcEa+9tHVcK8CF81Y2V72qaZhWA=="],
+
+    "parse-ms": ["parse-ms@4.0.0", "", {}, "sha512-TXfryirbmq34y8QBwgqCVLi+8oA3oWx2eAnSn62ITyEhEYaWRlVZ2DvMM9eZbMs/RfxPu/PK/aBLyGj4IrqMHw=="],
+
+    "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
+
+    "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
+
+    "pretty-ms": ["pretty-ms@9.3.0", "", { "dependencies": { "parse-ms": "^4.0.0" } }, "sha512-gjVS5hOP+M3wMm5nmNOucbIrqudzs9v/57bWRHQWLYklXqoXKrVfYW2W9+glfGsqtPgpiz5WwyEEB+ksXIx3gQ=="],
+
+    "shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
+
+    "shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
+
+    "signal-exit": ["signal-exit@4.1.0", "", {}, "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw=="],
+
+    "sisteransi": ["sisteransi@1.0.5", "", {}, "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg=="],
+
+    "strip-final-newline": ["strip-final-newline@4.0.0", "", {}, "sha512-aulFJcD6YK8V1G7iRB5tigAP4TsHBZZrOV8pjV++zdUwmeV8uzbY7yn6h9MswN62adStNZFuCIx4haBnRuMDaw=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
+
+    "unicorn-magic": ["unicorn-magic@0.3.0", "", {}, "sha512-+QBBXBCvifc56fsbuxZQ6Sic3wqqc3WWaqxs58gvJrcOuN83HGTCwz3oS5phzU9LthRNE9VrJCFCLUgHeeFnfA=="],
+
+    "which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
+
+    "yoctocolors": ["yoctocolors@2.1.2", "", {}, "sha512-CzhO+pFNo8ajLM2d2IW/R93ipy99LWjtwblvC1RsoSUMZgyLbYFr221TnSNT7GjGdYui6P459mw9JH/g/zW2ug=="],
+
+    "npm-run-path/path-key": ["path-key@4.0.0", "", {}, "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ=="],
+  }
+}

package/index.ts

@@ -0,0 +1 @@
+console.log("Hello via Bun!");

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "bunforge",
+  "version": "1.0.0",
+  "module": "src/index.ts",
+  "bin": {
+    "bunforge": "./src/index.ts"
+  },
+  "scripts": {
+    "start": "bun src/index.ts",
+    "dev": "bun --watch src/index.ts"
+  },
+  "dependencies": { 
+    "@clack/prompts": "^0.9.0",
+    "execa": "^9.5.2",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,60 @@
+#!/usr/bin/env bun
+import { join } from "path";
+import { mkdir } from "fs/promises";
+import { execa } from "execa";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+
+import { getProjectName, askPrisma, askAuth } from "./prompts.js";
+import { setupPrisma } from "./tasks/prisma.js";
+import { setupAuth } from "./tasks/auth.js";
+
+p.intro(pc.bgCyan(pc.black(" bunforge ")) + " — Bun project scaffolder");
+
+const name = await getProjectName();
+const projectRoot = join(process.cwd(), name);
+
+// ── 1. bun init ──────────────────────────────────────────────────────────────
+const s = p.spinner();
+s.start("Initialising bun project…");
+await mkdir(projectRoot, { recursive: true });
+await execa("bun", ["init", "-y"], { cwd: projectRoot });
+s.stop("Bun project ready");
+
+// ── 2. Prisma ────────────────────────────────────────────────────────────────
+const wantsPrisma = await askPrisma();
+if (wantsPrisma) {
+  s.start("Setting up Prisma…");
+  await setupPrisma(projectRoot);
+  s.stop("Prisma ready");
+}
+
+// ── 3. Auth ──────────────────────────────────────────────────────────────────
+let wantsAuth = false;
+if (wantsPrisma) {
+  wantsAuth = await askAuth();
+  if (wantsAuth) {
+    s.start("Scaffolding auth…");
+    await setupAuth(projectRoot);
+    s.stop("Auth ready");
+  }
+}
+
+// ── 4. .env ──────────────────────────────────────────────────────────────────
+await Bun.write(
+  join(projectRoot, ".env"),
+  `DATABASE_URL="postgresql://user:password@localhost:5432/mydb"\nJWT_SECRET="supersecret"\nPORT=3000\n`
+);
+
+// ── 5. .gitignore ────────────────────────────────────────────────────────────
+await Bun.write(
+  join(projectRoot, ".gitignore"),
+  `node_modules\n.env\ngenerated\ndist\n`
+);
+
+// ── Done ─────────────────────────────────────────────────────────────────────
+p.outro(
+  pc.green("✔ Done! ") +
+    `cd ${name}` +
+    (wantsPrisma ? " → update .env → bunx prisma migrate dev --name init -> bunx prisma generate " : "")
+);

package/src/prompts.ts

@@ -0,0 +1,31 @@
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+
+export async function getProjectName(): Promise<string> {
+  const name = await p.text({
+    message: "Project name?",
+    placeholder: "my-bun-app",
+    validate: (v) => (!v ? "Name is required" : undefined),
+  });
+  if (p.isCancel(name)) cancel();
+  return name as string;
+}
+
+export async function askPrisma(): Promise<boolean> {
+  const use = await p.confirm({ message: "Add Prisma (PostgreSQL)?" });
+  if (p.isCancel(use)) cancel();
+  return use as boolean;
+}
+
+export async function askAuth(): Promise<boolean> {
+  const use = await p.confirm({
+    message: "Add JWT auth routes (requires Prisma)?",
+  });
+  if (p.isCancel(use)) cancel();
+  return use as boolean;
+}
+
+function cancel(): never {
+  p.cancel("Cancelled.");
+  process.exit(0);
+}

package/src/tasks/auth.ts

@@ -0,0 +1,119 @@
+import { execa } from "execa";
+import { writeFileDeep } from "../utils/files.js";
+
+const TYPES_TS = `import z from "zod";
+
+export const SignupSchema = z.object({
+  email: z.string().email(),
+  password: z.string(),
+});
+
+export const SigninSchema = z.object({
+  email: z.string().email(),
+  password: z.string(),
+});
+`;
+
+const INDEX_TS = `import express, {
+  type NextFunction,
+  type Request,
+  type Response,
+} from "express";
+import { prisma } from "./prisma/db";
+import jwt, { type JwtPayload } from "jsonwebtoken";
+import { SignupSchema, SigninSchema } from "./Types/types";
+
+const app = express();
+const SECRET = process.env.JWT_SECRET ?? "changeme_in_prod";
+
+app.use(express.json());
+
+// ── helpers ──────────────────────────────────────────────────────────────────
+function ferr(msg: string, code: number, res: Response) {
+  return res.status(code).json({ success: false, data: null, error: msg });
+}
+
+interface AuthRequest extends Request {
+  id?: string;
+  role?: string;
+}
+
+export function authMiddleware() {
+  return (req: AuthRequest, res: Response, next: NextFunction) => {
+    try {
+      const token = req.headers.authorization?.split(" ")[1];
+      if (!token) return ferr("UNAUTHORIZED", 401, res);
+      const payload = jwt.verify(token, SECRET) as JwtPayload;
+      req.id = payload.id;
+      req.role = payload.role;
+      next();
+    } catch {
+      return ferr("UNAUTHORIZED", 401, res);
+    }
+  };
+}
+
+// ── routes ───────────────────────────────────────────────────────────────────
+app.post("/api/auth/signup", async (req: Request, res: Response) => {
+  const parsed = SignupSchema.safeParse(req.body);
+  if (!parsed.success) return ferr("INVALID_REQUEST", 400, res);
+
+  const exists = await prisma.users.findUnique({
+    where: { email: parsed.data.email },
+  });
+  if (exists) return ferr("EMAIL_ALREADY_EXISTS", 400, res);
+
+  await prisma.users.create({
+    data: { email: parsed.data.email, password: parsed.data.password },
+  });
+
+  return res.status(201).json({ success: true, error: null });
+});
+
+app.post("/api/auth/login", async (req: Request, res: Response) => {
+  const parsed = SigninSchema.safeParse(req.body);
+  if (!parsed.success) return ferr("INVALID_REQUEST", 400, res);
+
+  const user = await prisma.users.findUnique({
+    where: { email: parsed.data.email },
+  });
+  if (!user) return ferr("INVALID_CREDENTIALS", 401, res);
+
+  const token = jwt.sign({ id: user.id, role: user.role }, SECRET);
+
+  return res.status(200).json({
+    success: true,
+    data: { token, user: { id: user.id, email: user.email } },
+    error: null,
+  });
+});
+
+// ── start ────────────────────────────────────────────────────────────────────
+const PORT = process.env.PORT ?? 3000;
+app.listen(PORT, () => console.log(\`🚀 Server running on port \${PORT}\`));
+
+`;
+
+export async function setupAuth(projectRoot: string): Promise<void> {
+  // Install deps
+  await execa(
+    "bun",
+    [
+      "add",
+      "express",
+      "@types/express",
+      "jsonwebtoken",
+      "@types/jsonwebtoken",
+      "zod",
+    ],
+    { cwd: projectRoot, stdio: "inherit" }
+  );
+
+  // Write Types/types.ts
+  await writeFileDeep(projectRoot, "Types/types.ts", TYPES_TS);
+
+  // Write src/index.ts
+  await writeFileDeep(projectRoot, "index.ts", INDEX_TS);
+
+  console.log("\n✅ Auth routes scaffolded in src/index.ts");
+}

package/src/tasks/prisma.ts

@@ -0,0 +1,70 @@
+import { execa } from "execa";
+import { writeFileDeep } from "../utils/files.js";
+
+const DB_TS = `import "dotenv/config";
+import { PrismaPg } from "@prisma/adapter-pg";
+import { PrismaClient } from "../generated/prisma/client";
+
+const connectionString = \`\${process.env.DATABASE_URL}\`;
+const adapter = new PrismaPg({ connectionString });
+const prisma = new PrismaClient({ adapter });
+
+export { prisma };
+`;
+
+const SCHEMA_ADDITION = `
+enum ROLE {
+  customer
+  admin
+}
+
+model users {
+  id       String @id @db.VarChar(255) @default(uuid())
+  email    String @unique @db.VarChar(255)
+  password String @db.VarChar(255)
+  role     ROLE   @default(customer)
+}
+`;
+
+export async function setupPrisma(projectRoot: string): Promise<void> {
+  // 1. Install deps
+  await execa(
+    "bun",
+    [
+      "add",
+      "prisma",
+      "@types/pg",
+      "--save-dev",
+      "@prisma/client",
+      "@prisma/adapter-pg",
+      "pg",
+      "dotenv",
+    ],
+    { cwd: projectRoot, stdio: "inherit" }
+  );
+
+  // 2. Init prisma
+  await execa("bunx", ["prisma", "init"], {
+    cwd: projectRoot,
+    stdio: "inherit",
+  });
+
+  // 3. Write src/db.ts
+  await writeFileDeep(projectRoot, "prisma/db.ts", DB_TS);
+
+  // 4. Append models to prisma/schema.prisma
+  const schemaPath = `${projectRoot}/prisma/schema.prisma`;
+  const existing = await Bun.file(schemaPath).text();
+
+  // Add postgresql adapter preview feature
+  const updatedSchema = existing
+    .replace(
+      /generator client \{([^}]*)\}/,
+      `generator client {$1  previewFeatures = ["driverAdapters"]\n}`
+    )
+    .concat(SCHEMA_ADDITION);
+
+  await Bun.write(schemaPath, updatedSchema);
+
+  console.log("\n✅ Prisma set up. Don't forget to set DATABASE_URL in .env");
+}

package/src/utils/files.ts

@@ -0,0 +1,12 @@
+import { mkdir, writeFile } from "fs/promises";
+import { join, dirname } from "path";
+
+export async function writeFileDeep(
+  projectRoot: string,
+  relPath: string,
+  content: string
+): Promise<void> {
+  const fullPath = join(projectRoot, relPath);
+  await mkdir(dirname(fullPath), { recursive: true });
+  await writeFile(fullPath, content, "utf-8");
+}

package/tsconfig.json

@@ -0,0 +1,31 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}