@beignet/cli 0.0.35 → 0.0.37

package/dist/templates/server.js

@@ -18,6 +18,7 @@ export function serverProviders(ctx) {
             ? 'import { createUpstashRateLimitProvider } from "@beignet/provider-rate-limit-upstash";'
             : undefined,
         'import * as schema from "@/infra/db/schema";',
+        'import { databaseClient } from "@/infra/db/client";',
         'import { starterDatabaseProvider } from "@/infra/db/provider";',
         'import { auth } from "@/lib/better-auth";',
         'import type { AuthSessionMetadata, AuthUser } from "@/ports/auth";',
@@ -38,7 +39,10 @@ export function serverProviders(ctx) {
     ].filter((entry) => Boolean(entry));
     return `${imports.join("\n")}
 
-const ${db.providerInstance} = ${db.providerFactory}({ schema });
+const ${db.providerInstance} = ${db.providerFactory}({
+	schema,
+	client: databaseClient,
+});
 
 export const providers = [
 ${entries.join("\n")}
@@ -138,7 +142,8 @@ export function env(ctx) {
 \t\tSQLITE_DB_AUTH_TOKEN: z.string().optional(),`
         : `\t\t${databaseDescriptor(ctx).urlEnvVar}: z
 \t\t\t.string()
-\t\t\t.default("${databaseLocalUrl(ctx.database, ctx.name)}"),`;
+\t\t\t.default("${databaseLocalUrl(ctx.database, ctx.name)}"),
+\t\t${ctx.database === "postgres" ? "POSTGRES" : "MYSQL"}_DB_POOL_MAX: z.coerce.number().int().positive().default(5),`;
     return `import { createEnv } from "@beignet/core/config";
 import { z } from "zod";
 
@@ -187,54 +192,45 @@ export const isDevtoolsEnabled =
 }
 export function betterAuth(ctx) {
     const connectionByDatabase = {
-        sqlite: `import { createClient } from "@libsql/client";
-import { betterAuth } from "better-auth";
+        sqlite: `import { betterAuth } from "better-auth";
 import { drizzleAdapter } from "better-auth/adapters/drizzle";
 import { drizzle } from "drizzle-orm/libsql";
+import { databaseClient } from "@/infra/db/client";
 import { ensureDatabaseReady } from "@/infra/db/database-ready";
 import * as schema from "@/infra/db/schema";
 import { env } from "@/lib/env";
 
-const client = createClient({
-	url: env.SQLITE_DB_URL,
-	authToken: env.SQLITE_DB_AUTH_TOKEN,
-});
-
 // Auth routes can be the first thing to touch the database, before any
 // Beignet provider boots, so readiness is enforced here too.
-await ensureDatabaseReady(client);
+await ensureDatabaseReady(databaseClient);
 
-const db = drizzle(client, { schema });`,
+const db = drizzle(databaseClient, { schema });`,
         postgres: `import { betterAuth } from "better-auth";
 import { drizzleAdapter } from "better-auth/adapters/drizzle";
 import { drizzle } from "drizzle-orm/node-postgres";
-import pg from "pg";
+import { databaseClient } from "@/infra/db/client";
 import { ensureDatabaseReady } from "@/infra/db/database-ready";
 import * as schema from "@/infra/db/schema";
 import { env } from "@/lib/env";
 
-const pool = new pg.Pool({ connectionString: env.POSTGRES_DB_URL });
-
 // Auth routes can be the first thing to touch the database, before any
 // Beignet provider boots, so readiness is enforced here too.
-await ensureDatabaseReady(pool);
+await ensureDatabaseReady(databaseClient);
 
-const db = drizzle(pool, { schema });`,
+const db = drizzle(databaseClient, { schema });`,
         mysql: `import { betterAuth } from "better-auth";
 import { drizzleAdapter } from "better-auth/adapters/drizzle";
 import { drizzle } from "drizzle-orm/mysql2";
-import mysql from "mysql2/promise";
+import { databaseClient } from "@/infra/db/client";
 import { ensureDatabaseReady } from "@/infra/db/database-ready";
 import * as schema from "@/infra/db/schema";
 import { env } from "@/lib/env";
 
-const pool = mysql.createPool({ uri: env.MYSQL_DB_URL });
-
 // Auth routes can be the first thing to touch the database, before any
 // Beignet provider boots, so readiness is enforced here too.
-await ensureDatabaseReady(pool);
+await ensureDatabaseReady(databaseClient);
 
-const db = drizzle(pool, { schema, mode: "default" });`,
+const db = drizzle(databaseClient, { schema, mode: "default" });`,
     };
     return `${connectionByDatabase[ctx.database]}
 
@@ -268,16 +264,7 @@ export const auth = betterAuth({
 });
 `;
 }
-export function server(ctx) {
-    const db = databaseDescriptor(ctx);
-    const providerConfigEntries = ctx.database === "sqlite"
-        ? `\t\t"drizzle-sqlite": {
-\t\t\tDB_URL: env.SQLITE_DB_URL,
-\t\t\tDB_AUTH_TOKEN: env.SQLITE_DB_AUTH_TOKEN,
-\t\t},`
-        : `\t\t"${db.providerName}": {
-\t\t\tDB_URL: env.${db.urlEnvVar},
-\t\t},`;
+export function server() {
     return `import "@beignet/core/server-only";
 import { createNextServer, createNextServerLoader } from "@beignet/next";
 import {
@@ -287,6 +274,7 @@ import {
 } from "@beignet/core/server";
 import type { AppContext } from "@/app-context";
 import { appPorts } from "@/infra/app-ports";
+import { closeDatabaseClient } from "@/infra/db/client";
 import { env } from "@/lib/env";
 import { appContext } from "./context";
 import { routes } from "./routes";
@@ -294,12 +282,9 @@ import { routes } from "./routes";
 export const getServer = createNextServerLoader(async () => {
 	const { providers } = await import("./providers");
 
-	return createNextServer({
+	const server = await createNextServer({
 	ports: appPorts,
 	providers,
-	providerConfig: {
-${providerConfigEntries}
-	},
 	hooks: [
 		createSecurityHeadersHooks<AppContext>(),
 		createErrorReportingHooks<AppContext>(),
@@ -324,7 +309,38 @@ ${providerConfigEntries}
 		};
 	},
 	});
+	let stopPromise: Promise<void> | undefined;
+
+	return {
+		...server,
+		stop() {
+			stopPromise ??= stopServerAndDatabase(server);
+			return stopPromise;
+		},
+	};
 });
+
+async function stopServerAndDatabase(server: {
+	stop(): Promise<void>;
+}): Promise<void> {
+	const errors: unknown[] = [];
+	try {
+		await server.stop();
+	} catch (error) {
+		errors.push(error);
+	}
+
+	try {
+		await closeDatabaseClient();
+	} catch (error) {
+		errors.push(error);
+	}
+
+	if (errors.length === 1) throw errors[0];
+	if (errors.length > 1) {
+		throw new AggregateError(errors, "Server and database shutdown failed");
+	}
+}
 `;
 }
 const files = {

package/dist/templates/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/templates/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/templates/server.ts"],"names":[],"mappings":"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"}

package/dist/templates/shared.js

@@ -1,6 +1,6 @@
 export const externalVersions = {
     biome: "^2.4.14",
-    next: "^16.2.4",
+    next: "^16.2.10",
     react: "^19.2.5",
     reactDom: "^19.2.5",
     tsx: "^4.22.4",
@@ -16,7 +16,7 @@ export const externalVersions = {
     bullmq: "^5.0.0",
     drizzleKit: "^0.31.10",
     drizzleOrm: "^0.45.2",
-    inngest: "^3.0.0",
+    inngest: "^3.54.0",
     libsqlClient: "^0.14.0",
     vercelBlob: "^2.5.0",
     mysql2: "^3.12.0",
@@ -26,7 +26,7 @@ export const externalVersions = {
     resend: "^6.14.0",
     sentryNode: "^10.58.0",
     stripe: "^22.2.1",
-    nodemailer: "^8.0.5",
+    nodemailer: "^9.0.1",
     openFeatureServerSdk: "^1.22.0",
     typesPg: "^8.11.0",
     ioredis: "^5.0.0",

package/dist/templates/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/templates/shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/templates/shared.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/cli",
-  "version": "0.0.35",
+  "version": "0.0.37",
   "type": "module",
   "description": "CLI for creating and maintaining Beignet apps.",
   "main": "./dist/lib.js",
@@ -70,7 +70,7 @@
     "typescript": "^5.3.0"
   },
   "dependencies": {
-    "@beignet/core": "^0.0.35",
+    "@beignet/core": "^0.0.37",
     "@clack/prompts": "^1.5.1",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@stricli/core": "^1.2.7",

package/src/config.ts

@@ -56,6 +56,17 @@ export type BeignetDatabaseConfig = {
   schemaSources?: string[];
 };
 
+/**
+ * Explicit exceptions for static provider package requirements.
+ */
+export type BeignetProviderAuditConfig = {
+  /**
+   * Environment variables supplied through another mechanism, such as an
+   * injected platform client, and therefore not required in app env files.
+   */
+  ignoreRequiredEnv?: string[];
+};
+
 /**
  * User-authored Beignet CLI config.
  */
@@ -63,6 +74,7 @@ export type BeignetConfig = {
   framework?: BeignetFramework;
   paths?: Partial<BeignetPaths>;
   database?: BeignetDatabaseConfig;
+  providerAudit?: BeignetProviderAuditConfig;
 };
 
 /**
@@ -75,6 +87,9 @@ export type ResolvedBeignetConfig = {
     tables: BeignetDatabaseTables;
     schemaSources: string[];
   };
+  providerAudit: {
+    ignoreRequiredEnv: string[];
+  };
   configFile?: string;
 };
 
@@ -116,6 +131,9 @@ export const defaultBeignetConfig: ResolvedBeignetConfig = {
     },
     schemaSources: [],
   },
+  providerAudit: {
+    ignoreRequiredEnv: [],
+  },
 };
 
 /**
@@ -145,11 +163,17 @@ export function resolveConfig(
       config.database?.schemaSources ??
       defaultBeignetConfig.database.schemaSources,
   };
+  const providerAudit = {
+    ignoreRequiredEnv:
+      config.providerAudit?.ignoreRequiredEnv ??
+      defaultBeignetConfig.providerAudit.ignoreRequiredEnv,
+  };
 
   return {
     framework: config.framework ?? defaultBeignetConfig.framework,
     paths: normalizeConfigPaths(paths),
     database: normalizeDatabaseConfig(database),
+    providerAudit: normalizeProviderAuditConfig(providerAudit),
     configFile,
   };
 }
@@ -298,6 +322,20 @@ function assertConfigObject(
     throw new Error(`${configFile} database must be an object.`);
   }
 
+  if (config.providerAudit !== undefined && !isRecord(config.providerAudit)) {
+    throw new Error(`${configFile} providerAudit must be an object.`);
+  }
+
+  if (
+    config.providerAudit !== undefined &&
+    config.providerAudit.ignoreRequiredEnv !== undefined &&
+    !Array.isArray(config.providerAudit.ignoreRequiredEnv)
+  ) {
+    throw new Error(
+      `${configFile} providerAudit.ignoreRequiredEnv must be an array.`,
+    );
+  }
+
   if (
     config.database !== undefined &&
     config.database.tables !== undefined &&
@@ -385,6 +423,32 @@ function normalizeDatabaseSchemaSource(index: number, value: string): string {
   return value.trim();
 }
 
+function normalizeProviderAuditConfig(config: {
+  ignoreRequiredEnv: string[];
+}): {
+  ignoreRequiredEnv: string[];
+} {
+  return {
+    ignoreRequiredEnv: [
+      ...new Set(
+        config.ignoreRequiredEnv.map((value, index) =>
+          normalizeIgnoredRequiredEnv(index, value),
+        ),
+      ),
+    ],
+  };
+}
+
+function normalizeIgnoredRequiredEnv(index: number, value: string): string {
+  if (typeof value !== "string" || value.trim() === "") {
+    throw new Error(
+      `Beignet config providerAudit.ignoreRequiredEnv[${index}] must be a string.`,
+    );
+  }
+
+  return value.trim();
+}
+
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }

package/src/inspect.ts

@@ -2228,7 +2228,10 @@ async function inspectProductionReadiness(
         provider.variants,
         providerEntries,
       )) {
-        for (const envVar of variant.requiredEnv) {
+        for (const envVar of configuredProviderRequiredEnv(
+          variant.requiredEnv,
+          config,
+        )) {
           if (
             await providerRequiredEnvExists(
               targetDir,
@@ -2275,7 +2278,10 @@ async function inspectProductionReadiness(
       continue;
     }
 
-    for (const envVar of provider.requiredEnv ?? []) {
+    for (const envVar of configuredProviderRequiredEnv(
+      provider.requiredEnv ?? [],
+      config,
+    )) {
       if (
         await providerRequiredEnvExists(
           targetDir,
@@ -5539,6 +5545,14 @@ function configuredProviderRequiredTables(
   );
 }
 
+function configuredProviderRequiredEnv(
+  envVars: readonly string[],
+  config: ResolvedBeignetConfig,
+): string[] {
+  const ignored = new Set(config.providerAudit.ignoreRequiredEnv);
+  return envVars.filter((envVar) => !ignored.has(envVar));
+}
+
 function configuredProviderRequiredTable(
   tableName: string,
   config: ResolvedBeignetConfig,

package/src/provider-audit.ts

@@ -1015,6 +1015,14 @@ function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
+function configuredProviderRequiredEnv(
+  envVars: readonly string[],
+  config: ResolvedBeignetConfig,
+): string[] {
+  const ignored = new Set(config.providerAudit.ignoreRequiredEnv);
+  return envVars.filter((envVar) => !ignored.has(envVar));
+}
+
 function configuredProviderRequiredTables(
   tableNames: readonly string[],
   config: ResolvedBeignetConfig,
@@ -1140,13 +1148,18 @@ async function providerAuditEntryForRule(options: {
   const requiredEnv =
     options.rule.variants !== undefined
       ? aggregateVariantRequirement(variants, "requiredEnv")
-      : await requirementAudit(options.rule.requiredEnv ?? [], (envVar) =>
-          providerRequiredEnvExists(
-            options.targetDir,
-            options.configFiles,
-            envVar,
-            options.sourceCache,
+      : await requirementAudit(
+          configuredProviderRequiredEnv(
+            options.rule.requiredEnv ?? [],
+            options.config,
           ),
+          (envVar) =>
+            providerRequiredEnvExists(
+              options.targetDir,
+              options.configFiles,
+              envVar,
+              options.sourceCache,
+            ),
         );
 
   const requiredTables =
@@ -1222,12 +1235,16 @@ async function providerVariantAudit(options: {
   variant: ProviderDoctorVariantRule;
   registered: boolean;
 }): Promise<ProviderVariantAudit> {
+  const requiredEnv = configuredProviderRequiredEnv(
+    options.variant.requiredEnv,
+    options.config,
+  );
   if (!options.registered) {
     return {
       name: options.variant.name,
       displayName: options.variant.displayName,
       registration: "inactive",
-      requiredEnv: inactiveRequirement(options.variant.requiredEnv),
+      requiredEnv: inactiveRequirement(requiredEnv),
       requiredTables: inactiveRequirement(options.variant.requiredTables),
     };
   }
@@ -1240,7 +1257,7 @@ async function providerVariantAudit(options: {
       options.variant.registrationSeverity,
       options.providerEntries,
     ),
-    requiredEnv: await requirementAudit(options.variant.requiredEnv, (envVar) =>
+    requiredEnv: await requirementAudit(requiredEnv, (envVar) =>
       providerRequiredEnvExists(
         options.targetDir,
         options.configFiles,

package/src/templates/base.ts

@@ -314,7 +314,7 @@ Use \`${cli} make feature projects --recipe full-slice\` when you want a richer
 - \`features/shared/errors.ts\` keeps application errors and route-owned error schemas together.
 - \`ports/\` defines app-owned dependencies.
 - \`infra/\` implements ports for the selected runtime.
-- \`infra/db/schema/\` contains the Drizzle schema, \`drizzle/\` contains the checked-in migrations, and \`infra/todos/\` contains the durable todo repository adapter.
+- \`infra/db/client.ts\` owns the process-wide database client shared by Better Auth and the Beignet provider; the public server \`stop()\` closes it after provider shutdown. \`infra/db/schema/\` contains the Drizzle schema, \`drizzle/\` contains the checked-in migrations, and \`infra/todos/\` contains the durable todo repository adapter.
 - \`server/routes.ts\` keeps the central route registry and OpenAPI contract list.
 - \`server/context.ts\` declares the context blueprint shared by the server and route tests.
 - \`server/providers.ts\` wires devtools, Better Auth, pino, ${
@@ -342,6 +342,7 @@ ${optionalAuthRedirects}
           cli +
           " db migrate` against it before starting the app."
   }
+- Size the process-wide database client for the deployment. Postgres and MySQL use the generated pool-limit environment variable; count web, worker, preview, and task processes against the database connection limit, and keep writable SQLite files on one host.
 - Run \`${cli} db generate\` and \`${cli} db migrate\` after changing the Drizzle schema.
 - Run \`${cli} db reset\` to rebuild a local ${
     ctx.database === "sqlite"
@@ -438,11 +439,15 @@ export function envExample(ctx: TemplateContext): string {
             "# Local Postgres matching the docker one-liner below; point at your own server in production.",
             `# ${databaseStartCommand("postgres", ctx.name)}`,
             `POSTGRES_DB_URL=${databaseLocalUrl("postgres", ctx.name)}`,
+            "# Maximum connections opened by each running app process.",
+            "POSTGRES_DB_POOL_MAX=5",
           ]
         : [
             "# Local MySQL matching the docker one-liner below; point at your own server in production.",
             `# ${databaseStartCommand("mysql", ctx.name)}`,
             `MYSQL_DB_URL=${databaseLocalUrl("mysql", ctx.name)}`,
+            "# Maximum connections opened by each running app process.",
+            "MYSQL_DB_POOL_MAX=5",
           ];
 
   const lines = [

package/src/templates/db/index.ts

@@ -10,6 +10,7 @@ import { sqliteDbFiles } from "./sqlite.js";
  */
 export type DbTemplateFiles = {
   drizzleConfig: string;
+  dbClient: string;
   dbSchema: string;
   drizzleTodoRepository: string;
   dbRepositories: string;

package/src/templates/db/mysql.ts

@@ -36,6 +36,22 @@ export function mysqlDbFiles(ctx: TemplateContext): DbTemplateFiles {
 		url: process.env.MYSQL_DB_URL ?? "${databaseLocalUrl("mysql", ctx.name)}",
 	},
 };
+`,
+    dbClient: `import "@beignet/core/server-only";
+import mysql from "mysql2/promise";
+import { env } from "@/lib/env";
+
+export const databaseClient = mysql.createPool({
+	uri: env.MYSQL_DB_URL,
+	connectionLimit: env.MYSQL_DB_POOL_MAX,
+});
+
+let closePromise: Promise<void> | undefined;
+
+export function closeDatabaseClient(): Promise<void> {
+	closePromise ??= Promise.resolve().then(() => databaseClient.end());
+	return closePromise;
+}
 `,
     dbSchema: `import {
 	boolean,

package/src/templates/db/postgres.ts

@@ -33,6 +33,22 @@ export function postgresDbFiles(ctx: TemplateContext): DbTemplateFiles {
 		url: process.env.POSTGRES_DB_URL ?? "${databaseLocalUrl("postgres", ctx.name)}",
 	},
 };
+`,
+    dbClient: `import "@beignet/core/server-only";
+import pg from "pg";
+import { env } from "@/lib/env";
+
+export const databaseClient = new pg.Pool({
+	connectionString: env.POSTGRES_DB_URL,
+	max: env.POSTGRES_DB_POOL_MAX,
+});
+
+let closePromise: Promise<void> | undefined;
+
+export function closeDatabaseClient(): Promise<void> {
+	closePromise ??= Promise.resolve().then(() => databaseClient.end());
+	return closePromise;
+}
 `,
     dbSchema: `import { boolean, index, pgTable, text, timestamp } from "drizzle-orm/pg-core";
 

package/src/templates/db/sqlite.ts

@@ -24,6 +24,22 @@ const files = {
 		authToken: process.env.SQLITE_DB_AUTH_TOKEN,
 	},
 };
+`,
+  dbClient: `import "@beignet/core/server-only";
+import { createClient } from "@libsql/client";
+import { env } from "@/lib/env";
+
+export const databaseClient = createClient({
+	url: env.SQLITE_DB_URL,
+	authToken: env.SQLITE_DB_AUTH_TOKEN,
+});
+
+let closePromise: Promise<void> | undefined;
+
+export function closeDatabaseClient(): Promise<void> {
+	closePromise ??= Promise.resolve().then(() => databaseClient.close());
+	return closePromise;
+}
 `,
   dbSchema: `import { index, integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
 

package/src/templates/index.ts

@@ -110,6 +110,7 @@ export function getTemplateFiles(ctx: TemplateContext): TemplateFile[] {
     { path: "ports/index.ts", content: ports(ctx) },
     { path: "ports/auth.ts", content: serverFiles.authPort },
     { path: "infra/app-ports.ts", content: infrastructurePorts(ctx) },
+    { path: "infra/db/client.ts", content: db.dbClient },
     { path: "infra/db/database-ready.ts", content: db.databaseReady },
     { path: "infra/db/provider.ts", content: db.dbProvider },
     { path: "infra/db/repositories.ts", content: db.dbRepositories },
@@ -137,7 +138,7 @@ export function getTemplateFiles(ctx: TemplateContext): TemplateFile[] {
     ...testSupportTemplateFiles,
     { path: "lib/use-case.ts", content: serverFiles.useCaseBuilder },
     { path: "lib/routes.ts", content: serverFiles.routesBuilder },
-    { path: "server/index.ts", content: server(ctx) },
+    { path: "server/index.ts", content: server() },
     { path: "server/context.ts", content: serverFiles.serverContext },
     { path: "server/routes.ts", content: serverFiles.serverRoutes },
     { path: "server/providers.ts", content: serverProviders(ctx) },