create-kubojs 0.2.2 → 0.3.0

package/README.md

@@ -25,8 +25,8 @@ Follow the prompts to configure your project or use the `--yes` flag for default
 | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **TypeScript**           | End-to-end type safety across all parts of your application                                                                                                                                                                                                                                                                                                          |
 | **Frontend**             | • React with TanStack Router<br>• React with React Router<br>• React with TanStack Start (SSR)<br>• Next.js<br>• SvelteKit<br>• Nuxt (Vue)<br>• SolidJS<br>• Astro<br>• React Native bare Expo<br>• React Native with NativeWind (via Expo)<br>• React Native with Unistyles (via Expo)<br>• None                                                                    |
-| **Backend**              | • Hono<br>• Express<br>• Elysia<br>• Fastify<br>• Self (fullstack inside the web app)<br>• Convex<br>• None                                                                                                                                                                                                                                                          |
-| **API Layer**            | • tRPC (type-safe APIs)<br>• oRPC (OpenAPI-compatible type-safe APIs)<br>• Orval (OpenAPI REST APIs with generated Hono handlers)<br>• None                                                                                                                                                                                                                          |
+| **Backend**              | • Hono<br>• Express<br>• Elysia<br>• Fastify<br>• NestJS<br>• Self (fullstack inside the web app)<br>• Convex<br>• None                                                                                                                                                                                                                                              |
+| **API Layer**            | • tRPC (type-safe APIs)<br>• oRPC (OpenAPI-compatible type-safe APIs)<br>• Orval (OpenAPI REST APIs with generated handlers or Fetch clients)<br>• None                                                                                                                                                                                                              |
 | **Runtime**              | • Bun<br>• Node.js<br>• Cloudflare Workers<br>• None                                                                                                                                                                                                                                                                                                                 |
 | **Database**             | • SQLite<br>• PostgreSQL<br>• MySQL<br>• MongoDB<br>• None                                                                                                                                                                                                                                                                                                           |
 | **ORM**                  | • Drizzle (TypeScript-first)<br>• Prisma (feature-rich)<br>• Mongoose (for MongoDB)<br>• None                                                                                                                                                                                                                                                                        |
@@ -64,7 +64,7 @@ Options:
   --db-setup <setup>              Database setup (turso, d1, neon, supabase, prisma-postgres, planetscale, mongodb-atlas, docker, none)
   --web-deploy <setup>            Web deployment (cloudflare, docker, vercel, none)
   --server-deploy <setup>         Server deployment (cloudflare, docker, vercel, none)
-  --backend <framework>           Backend framework (hono, express, fastify, elysia, convex, self, none)
+  --backend <framework>           Backend framework (hono, express, fastify, elysia, nestjs, convex, self, none)
   --runtime <runtime>             Runtime (bun, node, workers, none)
   --api <type>                    API type (trpc, orpc, orval, none)
   --directory-conflict <strategy> Directory strategy (merge, overwrite, increment, error)
@@ -233,10 +233,10 @@ npx kubojs --frontend none --backend hono --api trpc --database none --addons no
 
 - **Convex backend**: Requires `database`, `orm`, `api`, `runtime`, and `server-deploy` to be `none`; auth can be `better-auth`, `clerk`, or `none` depending frontend compatibility
 - **Backend 'none'**: If selected, this option will force related options like API, ORM, database, authentication, and runtime to 'none'. Examples will also be disabled (set to none/empty).
+- **NestJS backend**: The initial KuboJS templates support PostgreSQL + Prisma, Better Auth or no authentication, and no API layer. These are current template capabilities, not limitations of NestJS itself; additional database, ORM, API, and example integrations can be added independently.
 - **Frontend 'none'**: Creates a backend-only project. When selected, PWA, Tauri, Electrobun, and certain examples may be disabled.
 - **API 'none'**: Disables tRPC/oRPC/Orval setup. Can be used with backend frameworks for REST APIs or custom API implementations.
-- **API 'orval'**: Generates a local OpenAPI contract, Hono REST handlers, and a Fetch client. Orval currently requires `--backend hono`; run `bun run api:generate` after changing `apps/api/openapi.yaml`.
-  The generated `todo` example is not supported by Orval yet.
+- **API 'orval'**: Generates a local OpenAPI contract, REST handlers, and typed Fetch client for Hono. Orval requires `--backend hono`; run `bun run api:generate` after changing `apps/api/openapi.yaml`.
 - **Database 'none'**: Disables database setup and requires ORM to be `none`.
 - **ORM 'none'**: Can be used when you want to handle database operations manually or use a different ORM.
 - **Runtime 'none'**: Only available with Convex backend, backend `none`, or backend `self`.
@@ -245,7 +245,7 @@ npx kubojs --frontend none --backend hono --api trpc --database none --addons no
 - **Addons 'none'**: Skips all addons.
 - **Testing 'none'**: Skips all testing tools. Playwright requires a web frontend.
 - **Examples 'none'**: Skips all example implementations (todo, AI chat).
-- **Nuxt, Svelte, SolidJS, and Astro** frontends are not compatible with tRPC; use oRPC, Orval with Hono, or no API layer.
+- **Nuxt, Svelte, SolidJS, and Astro** frontends are not compatible with tRPC; use oRPC, Orval, or no API layer.
 - **PWA support** requires TanStack Router, React Router, Next.js, or SolidJS
 - **Tauri desktop app** requires TanStack Router, React Router, TanStack Start, Next.js, Nuxt, SvelteKit, SolidJS, or Astro
 - **Electrobun desktop app** requires TanStack Router, React Router, TanStack Start, Next.js, Nuxt, SvelteKit, SolidJS, or Astro. Desktop packaging uses static web assets, so SSR-first frontends need a static/export build before desktop builds will work.

package/dist/cli.mjs

@@ -1,8 +1,141 @@
 #!/usr/bin/env node
-import { _ as getLatestCLIVersion, g as types_exports, i as SchemaNameSchema, l as create, m as getSchemaResult, s as add, u as createBtsCli } from "./src-CAMyqVYx.mjs";
+import { _ as getLatestCLIVersion, g as types_exports, i as SchemaNameSchema, l as create, m as getSchemaResult, s as add, u as createBtsCli } from "./src-9z53Xnti.mjs";
 import z from "zod";
+import { format } from "node:util";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+//#region src/commands/downloads.ts
+const PACKAGE_NAME = "create-kubojs";
+const REGISTRY_URL = "https://registry.npmjs.org";
+const DOWNLOADS_API_URL = "https://api.npmjs.org/downloads";
+const MAX_RANGE_MONTHS = 18;
+const REQUEST_TIMEOUT_MS = 15e3;
+const MAX_REQUEST_ATTEMPTS = 3;
+const defaultSleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
+function dateOnly(date) {
+	return date.toISOString().slice(0, 10);
+}
+function parseDateOnly(value) {
+	const date = /* @__PURE__ */ new Date(`${value}T00:00:00.000Z`);
+	if (Number.isNaN(date.getTime()) || dateOnly(date) !== value) throw new Error(`Invalid date: ${value}`);
+	return date;
+}
+function addDays(date, days) {
+	const result = new Date(date);
+	result.setUTCDate(result.getUTCDate() + days);
+	return result;
+}
+function addMonthsSafely(date, months) {
+	const targetMonth = date.getUTCMonth() + months;
+	const targetYear = date.getUTCFullYear() + Math.floor(targetMonth / 12);
+	const normalizedMonth = (targetMonth % 12 + 12) % 12;
+	const lastDay = new Date(Date.UTC(targetYear, normalizedMonth + 1, 0)).getUTCDate();
+	return new Date(Date.UTC(targetYear, normalizedMonth, Math.min(date.getUTCDate(), lastDay)));
+}
+function rangeUrl(packageName, start, end) {
+	return `${DOWNLOADS_API_URL}/range/${start}:${end}/${encodeURIComponent(packageName)}`;
+}
+async function fetchJson(url, fetchImpl, sleep = defaultSleep) {
+	let lastError;
+	for (let attempt = 1; attempt <= MAX_REQUEST_ATTEMPTS; attempt++) {
+		let response;
+		try {
+			response = await fetchImpl(url, {
+				signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+				headers: { Accept: "application/json" }
+			});
+		} catch (error) {
+			lastError = error;
+		}
+		if (response) if (!response.ok) {
+			const body = await response.text();
+			const error = /* @__PURE__ */ new Error(`Request failed (${response.status}): ${body || response.statusText}`);
+			if (response.status < 500 && response.status !== 429) throw error;
+			lastError = error;
+		} else return await response.json();
+		if (attempt < MAX_REQUEST_ATTEMPTS) await sleep(250 * 2 ** (attempt - 1));
+	}
+	throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+async function getPackageCreatedDate(packageName, fetchImpl = fetch, sleep = defaultSleep) {
+	const created = (await fetchJson(`${REGISTRY_URL}/${encodeURIComponent(packageName)}`, fetchImpl, sleep)).time?.created;
+	if (!created) throw new Error(`npm metadata did not include a creation date for ${packageName}`);
+	const createdDate = new Date(created);
+	if (Number.isNaN(createdDate.getTime())) throw new Error(`npm metadata included an invalid creation date for ${packageName}`);
+	return dateOnly(createdDate);
+}
+async function getAllTimeDownloads(options) {
+	const packageName = options?.packageName ?? PACKAGE_NAME;
+	const fetchImpl = options?.fetchImpl ?? fetch;
+	const sleep = options?.sleep ?? defaultSleep;
+	const today = options?.today ?? dateOnly(/* @__PURE__ */ new Date());
+	const start = await getPackageCreatedDate(packageName, fetchImpl, sleep);
+	const endDate = parseDateOnly(today);
+	let cursor = parseDateOnly(start);
+	let totalDownloads = 0;
+	let chunks = 0;
+	if (cursor > endDate) throw new Error(`Package creation date ${start} is after today ${today}`);
+	while (cursor <= endDate) {
+		const nextCursor = addMonthsSafely(cursor, MAX_RANGE_MONTHS);
+		const chunkEnd = nextCursor > endDate ? endDate : addDays(nextCursor, -1);
+		const response = await fetchJson(rangeUrl(packageName, dateOnly(cursor), dateOnly(chunkEnd)), fetchImpl, sleep);
+		for (const entry of response.downloads) {
+			if (!Number.isFinite(entry.downloads) || entry.downloads < 0) throw new Error(`Invalid download count for ${entry.day}: ${format(entry.downloads)}`);
+			totalDownloads += entry.downloads;
+		}
+		chunks++;
+		cursor = addDays(chunkEnd, 1);
+	}
+	return {
+		packageName,
+		start,
+		end: today,
+		totalDownloads,
+		chunks
+	};
+}
+function formatHumanReport(report) {
+	return [
+		`${report.packageName} downloads`,
+		`Period: ${report.start} → ${report.end}`,
+		`Total: ${report.totalDownloads.toLocaleString("en-US")} downloads`
+	].join("\n");
+}
+function parseArguments(arguments_) {
+	const unknownArgument = arguments_.find((argument) => argument !== "--json" && argument !== "--help");
+	if (unknownArgument) throw new Error(`Unknown argument: ${unknownArgument}`);
+	return {
+		json: arguments_.includes("--json"),
+		help: arguments_.includes("--help")
+	};
+}
+function formatHelp(usage = "bun run downloads [--json]") {
+	return [
+		`Usage: ${usage}`,
+		"",
+		`Reports all-time npm downloads for ${PACKAGE_NAME}.`
+	].join("\n");
+}
+async function runDownloadsCommand(arguments_, options, usage = "kubojs stats downloads [--json]") {
+	const parsedArguments = parseArguments(arguments_);
+	if (parsedArguments.help) {
+		console.log(formatHelp(usage));
+		return;
+	}
+	const report = await getAllTimeDownloads(options);
+	console.log(parsedArguments.json ? JSON.stringify(report, null, 2) : formatHumanReport(report));
+}
+//#endregion
+//#region src/commands/stats.ts
+const statsCommands = { downloads: runDownloadsCommand };
+async function runStatsCommand(arguments_) {
+	const [metric, ...metricArguments] = arguments_;
+	if (!metric) throw new Error("Usage: kubojs stats downloads [--json]");
+	const command = statsCommands[metric];
+	if (!command) throw new Error(`Unknown stats metric: ${metric}`);
+	await command(metricArguments);
+}
+//#endregion
 //#region src/mcp.ts
 const ToolResponseSchema = z.object({
 	ok: z.boolean(),
@@ -293,6 +426,12 @@ This command is intended to be launched by an MCP client, for example:
 		process.exit(0);
 	}
 	await startBtsMcpServer();
-} else await createBtsCli().run();
+} else if (command === "stats") try {
+	await runStatsCommand(args);
+} catch (error) {
+	console.error(error instanceof Error ? error.message : error);
+	process.exitCode = 1;
+}
+else await createBtsCli().run();
 //#endregion
 export {};

package/dist/index.d.mts

@@ -4,6 +4,7 @@ import * as _$better_result0 from "better-result";
 import { Result, Result as Result$1 } from "better-result";
 import { TrpcCliMeta, createCli } from "trpc-cli";
 import z from "zod";
+import { CompatibilityIssueCode } from "@kubojs/types";
 import { EMBEDDED_TEMPLATES, GeneratorError, GeneratorError as GeneratorError$1, GeneratorOptions, TEMPLATE_COUNT, VirtualDirectory, VirtualFile, VirtualFileSystem, VirtualFileTree, VirtualFileTree as VirtualFileTree$1, VirtualNode, generate } from "@kubojs/template-generator";
 
 //#region src/types.d.ts
@@ -58,6 +59,7 @@ declare class CLIError extends CLIError_base {}
 declare const ValidationError_base: _$better_result0.TaggedErrorClass<"ValidationError", {
   field?: string;
   value?: unknown;
+  compatibilityCode?: CompatibilityIssueCode;
   message: string;
 }>;
 /**
@@ -67,6 +69,7 @@ declare class ValidationError extends ValidationError_base {
   constructor(args: {
     field?: string;
     value?: unknown;
+    compatibilityCode?: CompatibilityIssueCode;
     message: string;
   });
 }
@@ -179,7 +182,7 @@ declare const router: _$_trpc_server0.TRPCBuiltRouter<{
       payments?: unknown;
       observability?: unknown;
       disableObservability?: boolean | undefined;
-      communication?: "none" | "resend" | "notifique" | "arara" | undefined;
+      communication?: unknown;
       frontend?: ("none" | "tanstack-router" | "react-router" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid" | "astro")[] | undefined;
       addons?: ("none" | "pwa" | "tauri" | "electrobun" | "biome" | "lefthook" | "husky" | "mcp" | "turborepo" | "vite-plus" | "oxlint" | "opentui" | "skills" | "s3-storage")[] | undefined;
       examples?: ("none" | "todo" | "ai")[] | undefined;
@@ -188,12 +191,12 @@ declare const router: _$_trpc_server0.TRPCBuiltRouter<{
       packageManager?: "bun" | "npm" | "pnpm" | undefined;
       install?: boolean | undefined;
       dbSetup?: "none" | "turso" | "neon" | "prisma-postgres" | "planetscale" | "mongodb-atlas" | "supabase" | "d1" | "docker" | undefined;
-      backend?: "none" | "hono" | "express" | "fastify" | "elysia" | "convex" | "self" | undefined;
+      backend?: "none" | "hono" | "express" | "fastify" | "elysia" | "nestjs" | "convex" | "self" | undefined;
       runtime?: "none" | "bun" | "node" | "workers" | undefined;
       api?: "none" | "trpc" | "orpc" | "orval" | undefined;
-      webDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "guaracloud" | undefined;
-      serverDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "guaracloud" | undefined;
-      directoryConflict?: "merge" | "overwrite" | "increment" | "error" | undefined;
+      webDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "railway" | "guaracloud" | undefined;
+      serverDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "railway" | "guaracloud" | undefined;
+      directoryConflict?: "error" | "merge" | "overwrite" | "increment" | undefined;
       renderTitle?: boolean | undefined;
       disableAnalytics?: boolean | undefined;
       manualDb?: boolean | undefined;
@@ -265,7 +268,7 @@ declare const router: _$_trpc_server0.TRPCBuiltRouter<{
       payments?: unknown;
       observability?: unknown;
       disableObservability?: boolean | undefined;
-      communication?: "none" | "resend" | "notifique" | "arara" | undefined;
+      communication?: unknown;
       frontend?: ("none" | "tanstack-router" | "react-router" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid" | "astro")[] | undefined;
       addons?: ("none" | "pwa" | "tauri" | "electrobun" | "biome" | "lefthook" | "husky" | "mcp" | "turborepo" | "vite-plus" | "oxlint" | "opentui" | "skills" | "s3-storage")[] | undefined;
       examples?: ("none" | "todo" | "ai")[] | undefined;
@@ -274,12 +277,12 @@ declare const router: _$_trpc_server0.TRPCBuiltRouter<{
       packageManager?: "bun" | "npm" | "pnpm" | undefined;
       install?: boolean | undefined;
       dbSetup?: "none" | "turso" | "neon" | "prisma-postgres" | "planetscale" | "mongodb-atlas" | "supabase" | "d1" | "docker" | undefined;
-      backend?: "none" | "hono" | "express" | "fastify" | "elysia" | "convex" | "self" | undefined;
+      backend?: "none" | "hono" | "express" | "fastify" | "elysia" | "nestjs" | "convex" | "self" | undefined;
       runtime?: "none" | "bun" | "node" | "workers" | undefined;
       api?: "none" | "trpc" | "orpc" | "orval" | undefined;
-      webDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "guaracloud" | undefined;
-      serverDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "guaracloud" | undefined;
-      directoryConflict?: "merge" | "overwrite" | "increment" | "error" | undefined;
+      webDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "railway" | "guaracloud" | undefined;
+      serverDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "railway" | "guaracloud" | undefined;
+      directoryConflict?: "error" | "merge" | "overwrite" | "increment" | undefined;
       renderTitle?: boolean | undefined;
       disableAnalytics?: boolean | undefined;
       manualDb?: boolean | undefined;
@@ -337,8 +340,8 @@ declare const router: _$_trpc_server0.TRPCBuiltRouter<{
           }[] | undefined;
         } | undefined;
       } | undefined;
-      webDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "guaracloud" | undefined;
-      serverDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "guaracloud" | undefined;
+      webDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "railway" | "guaracloud" | undefined;
+      serverDeploy?: "none" | "docker" | "cloudflare" | "vercel" | "railway" | "guaracloud" | undefined;
       projectDir?: string | undefined;
       install?: boolean | undefined;
       packageManager?: "bun" | "npm" | "pnpm" | undefined;

package/dist/index.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { C as UserCancelledError, S as ProjectCreationError, a as TEMPLATE_COUNT, b as DatabaseSetupError, c as builder, d as createVirtual, f as docs, h as router, i as SchemaNameSchema, l as create, m as getSchemaResult, n as GeneratorError, o as VirtualFileSystem, p as generate, r as Result, s as add, t as EMBEDDED_TEMPLATES, u as createBtsCli, v as CLIError, w as ValidationError, x as DirectoryConflictError, y as CompatibilityError } from "./src-CAMyqVYx.mjs";
+import { C as UserCancelledError, S as ProjectCreationError, a as TEMPLATE_COUNT, b as DatabaseSetupError, c as builder, d as createVirtual, f as docs, h as router, i as SchemaNameSchema, l as create, m as getSchemaResult, n as GeneratorError, o as VirtualFileSystem, p as generate, r as Result, s as add, t as EMBEDDED_TEMPLATES, u as createBtsCli, v as CLIError, w as ValidationError, x as DirectoryConflictError, y as CompatibilityError } from "./src-9z53Xnti.mjs";
 export { CLIError, CompatibilityError, DatabaseSetupError, DirectoryConflictError, EMBEDDED_TEMPLATES, GeneratorError, ProjectCreationError, Result, SchemaNameSchema, TEMPLATE_COUNT, UserCancelledError, ValidationError, VirtualFileSystem, add, builder, create, createBtsCli, createVirtual, docs, generate, getSchemaResult, router };