@beignet/cli 0.0.8 → 0.0.9

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @beignet/cli
 
+## 0.0.9
+
+### Patch Changes
+
+- 6ebec8c: Provider packages can now declare `variants` in their `beignet.provider` manifest — one entry per selectable backend with its own env requirements and registration tokens. `beignet doctor` checks required env vars only for the variants an app actually registers, and reports a single registration hint listing all variants when none is wired. The Drizzle database provider uses this to describe its sqlite, postgres, and mysql backends.
+- 1bb42a3: Rename `@beignet/provider-drizzle-turso` to `@beignet/provider-db-drizzle`, with databases as subpath exports. Import from `@beignet/provider-db-drizzle/sqlite`; `DrizzleTurso*` symbols are now `DrizzleSqlite*`, the provider registers as `drizzle-sqlite`, and the connection env vars are `SQLITE_DB_URL` and `SQLITE_DB_AUTH_TOKEN` (the auth token applies to hosted libSQL such as Turso). Provider packages now follow `provider-<capability>-<implementation>` naming, and multi-backend implementations add backends as subpaths — `/postgres` and `/mysql` are planned next.
+- Updated dependencies [6ebec8c]
+- Updated dependencies [6ebec8c]
+- Updated dependencies [1bb42a3]
+  - @beignet/core@0.0.9
+
 ## 0.0.8
 
 ### Patch Changes

package/README.md

@@ -39,18 +39,18 @@ Both delegate to `beignet create`, so `bunx @beignet/cli create my-app` is
 equivalent.
 
 Running create in an interactive terminal without selection flags opens a
-prompt-based setup that asks for the project directory, preset, features,
-integrations, and package manager. Passing any selection flag
-(`--preset`, `--features`, `--integrations`, or `--package-manager`) skips the
-prompts, and `--yes` forces the non-interactive defaults (the `standard`
-preset with `bun`) even on a terminal. Non-interactive runs in scripts and CI
-behave exactly as before.
+prompt-based setup that asks for the project directory, whether to scaffold
+an API-only app, and which provider integrations to add. Passing any
+selection flag (`--api`, `--integrations`, or `--package-manager`) skips the
+prompts, and `--yes` forces the non-interactive defaults (the full-stack
+starter with `bun`) even on a terminal. Non-interactive runs in scripts and
+CI behave exactly as before.
 
 By default the CLI creates a Next.js app with:
 
 - Contract-first todos API routes
 - Better Auth routes and Beignet auth provider wiring
-- Drizzle/libSQL persistence with a local SQLite default and Turso-ready config
+- Drizzle SQLite (libSQL) persistence with a local SQLite default and support for hosted libSQL (Turso)
 - UOW, audit logging, durable idempotency, and a durable outbox drain route
 - Jobs, events, listeners, schedules, mail-backed notifications, and uploads
 - App-owned ports with provider-backed infra adapters
@@ -62,6 +62,45 @@ By default the CLI creates a Next.js app with:
 - React Hook Form
 - OpenAPI output
 
+Pass `--api` to scaffold an API-only app. It keeps the same contracts, auth,
+persistence, and devtools, and swaps the UI shell for a minimal API landing
+page and a reduced typed client.
+
+The starter ships local production-shaped defaults: Better Auth, Drizzle
+SQLite (libSQL) persistence, pino logging, UOW, durable idempotency, a
+durable outbox, audit logging, and devtools. Add external service
+integrations only when you want those providers:
+
+```bash
+bunx @beignet/cli create my-app --integrations inngest,resend
+```
+
+Available integrations:
+
+- `inngest` - Inngest-backed background jobs via `@beignet/provider-inngest`
+- `resend` - Resend-backed mail via `@beignet/provider-mail-resend`
+- `upstash-rate-limit` - Upstash-backed rate limiting via
+  `@beignet/provider-rate-limit-upstash`
+
+Each selected integration adds its provider package dependencies, wires the
+provider in `server/providers.ts`, extends `.env.example`, and writes setup
+notes to `docs/integrations.md`.
+
+Drizzle SQLite (libSQL) ships in every starter. The scaffold includes
+`infra/db/schema/`, `infra/db/repositories.ts`, `infra/db/test-database.ts`,
+SQL-backed idempotency and outbox tables, a Drizzle todo repository adapter,
+`drizzle.config.ts`, checked-in starter migrations, database scripts, and
+`SQLITE_*` env examples, so the generated todo resource uses durable
+persistence instead of an in-memory repository. Later `make feature` or
+`make resource` calls in that app generate both a Drizzle table/repository
+and an in-memory test fake.
+
+Better Auth also ships in every starter. The scaffold adds the Better Auth
+Next.js route, Beignet auth provider wiring, typed `UNAUTHORIZED` and
+`FORBIDDEN` errors, a request-bound authorization gate, and
+`requireUser(ctx)`. Use hooks for HTTP boundary authentication and use cases
+or policies for business authorization.
+
 Preview the planned files without writing anything:
 
 ```bash
@@ -75,7 +114,6 @@ The CLI writes files only. After creation:
 cd my-app
 bun install
 cp .env.example .env.local
-bun beignet db generate
 bun beignet db migrate
 bun run dev
 ```
@@ -116,6 +154,7 @@ beignet make job <feature>/<name> [options]
 beignet make notification <feature>/<name> [options]
 beignet make listener <feature>/<name> --event <feature>/<event> [options]
 beignet make schedule <feature>/<name> [options]
+beignet make upload <feature>/<name> [options]
 beignet make port <name> [options]
 beignet make policy <name> [options]
 beignet make adapter <name> [options]
@@ -136,10 +175,9 @@ beignet --version
 
 Options:
   --template next              Template to use. Currently only `next`.
-  --preset standard           `minimal` or `standard`. Defaults to `standard`.
+  --api                       Scaffold an API-only app without the UI shell.
   --package-manager bun       Package manager shown in next steps.
-  --features client,openapi    Add starter features. Accepts one value or a comma-separated list.
-  --integrations inngest,pino  Add integrations. Accepts one value or a comma-separated list.
+  --integrations inngest,resend  Add integrations: inngest, resend, upstash-rate-limit. Accepts one value or a comma-separated list.
   --yes                       Skip interactive create prompts and use the defaults.
   --force                     Write into a non-empty directory.
   --dry-run                   Preview create/make writes without changing files.
@@ -220,7 +258,7 @@ shell or source the rc file to activate completions. Zsh completions require
 `compinit` to be loaded, which most zsh setups already do.
 
 Completions cover commands, subcommands, flags, and enum flag values such as
-`--preset` and `--features`. The shell scripts call the
+`--template` and `--integrations`. The shell scripts call the
 `beignet completion propose` helper, which prints one proposal per line for a
 partial command line; it exists for the shell integration and is safe to
 ignore otherwise. Completions complete whatever `beignet` resolves to on your
@@ -795,59 +833,6 @@ artifacts are already registered individually, the fix bails out and the
 diagnostic stays. Listener registration is report-only because apps own their
 event-bus wiring.
 
-Available presets:
-
-- `minimal` - choose this when you want the small contract/core/server/use-case loop without the full app conventions.
-- `standard` - choose this when you want the full app layout with Better Auth, Drizzle/libSQL, UOW, durable idempotency, outbox, audit logging, devtools, provider wiring, health checks, typed clients, feature-owned jobs/events/schedules/uploads/notifications, and separated `ports/` + `infra/`.
-
-The standard preset includes the local production-shaped defaults: Better Auth,
-Drizzle/libSQL, Pino logging, local storage, devtools, UOW, durable idempotency, outbox, audit
-logging, and feature-owned background workflow examples. Add external service
-integrations only when you want those providers:
-
-```bash
-bun create beignet my-app --preset standard --integrations drizzle-turso,inngest,resend
-```
-
-Available features:
-
-- `client`
-- `react-query`
-- `forms`
-- `openapi`
-
-Available integrations:
-
-- `better-auth`
-- `drizzle-turso`
-- `inngest`
-- `pino`
-- `resend`
-- `upstash-rate-limit`
-
-With `--preset standard`, Drizzle/libSQL is included by default. The starter scaffolds `infra/db/schema/`, `infra/db/repositories.ts`, `infra/db/test-database.ts`, SQL-backed idempotency and outbox tables, a Drizzle todo repository adapter, `drizzle.config.ts`, database scripts, and `TURSO_*` env examples so the generated todo resource uses durable persistence instead of the in-memory repository. Later `make feature` or `make resource` calls in that app generate both a Drizzle table/repository and an in-memory test fake.
-
-With `--preset minimal --integrations drizzle-turso`, the starter keeps the
-small app shape and scaffolds the smallest durable wiring: `drizzle.config.ts`,
-a todos-only schema in `infra/db/schema/`, a Drizzle todo repository in
-`infra/todos/`, and an app-owned database provider in `infra/db/provider.ts`
-that contributes the deferred `todos` port and creates and seeds the starter
-table at startup. The generated `db:generate` and `db:migrate` scripts work
-with `beignet db ...`; the `db:seed` and `db:reset` scripts are
-standard-preset-only because their entrypoints are not scaffolded.
-
-With `--preset standard`, Better Auth is included by default. The starter adds
-the Better Auth Next.js route, Beignet auth provider wiring, typed
-`UNAUTHORIZED` and `FORBIDDEN` errors, a request-bound authorization gate, and
-`requireUser(ctx)`. Use hooks for HTTP boundary authentication and use cases or
-policies for business authorization.
-
-With `--preset minimal --integrations better-auth`, the starter wires an
-app-owned `lib/better-auth.ts` backed by Better Auth's in-memory adapter, the
-`app/api/auth/[...all]` route, `createAuthBetterAuthProvider(...)` behind a
-deferred `auth` port, and an `auth` session on the request context. Users and
-sessions reset on restart; switch to a database adapter before production.
-
 ## License
 
 MIT

package/dist/create.js

@@ -46,7 +46,7 @@ export async function createProject(options) {
  * Providers that ship in every starter. They used to be `--integrations`
  * choices, so passing them gets a pointed error instead of a generic one.
  */
-const baseProviderNames = new Set(["better-auth", "drizzle-turso", "pino"]);
+const baseProviderNames = new Set(["better-auth", "drizzle-sqlite", "pino"]);
 function resolveIntegrations(explicitIntegrations) {
     for (const integration of explicitIntegrations) {
         if (baseProviderNames.has(integration)) {

package/dist/create.js.map

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

package/dist/inspect.js

@@ -1214,9 +1214,28 @@ async function inspectProductionReadiness(targetDir, files, config, convention)
             });
         }
     }
+    const providerEntries = await readProviderListEntries(targetDir, files, config, sourceCache);
     for (const provider of providerDoctorRules) {
         if (!installedPackages.has(provider.packageName))
             continue;
+        if (provider.variants !== undefined) {
+            // Multi-variant packages only require the env vars of the variants the
+            // app actually registers; an unused variant must not warn.
+            for (const variant of detectedProviderVariants(provider.variants, providerEntries)) {
+                for (const envVar of variant.requiredEnv) {
+                    if (await anyFileContains(targetDir, configFiles, envVar, sourceCache)) {
+                        continue;
+                    }
+                    diagnostics.push({
+                        severity: "warning",
+                        code: "BEIGNET_PROVIDER_ENV_MISSING",
+                        file: "package.json",
+                        message: `${provider.packageName} is installed and ${variant.displayName} is registered, but ${envVar} is not mentioned in app env/config files. ${variant.displayName} requires ${envVar}; add the environment variable or remove the provider registration.`,
+                    });
+                }
+            }
+            continue;
+        }
         for (const envVar of provider.requiredEnv ?? []) {
             if (await anyFileContains(targetDir, configFiles, envVar, sourceCache)) {
                 continue;
@@ -1360,17 +1379,31 @@ async function inspectProviderRegistrationDrift(targetDir, files, config, conven
     const providerDoctorRules = await providerDoctorRulesForInstalledPackages(targetDir, packageJson);
     const providerFiles = serverProviderFiles(files, config);
     const sourceCache = new Map();
-    const providerSource = (await Promise.all(providerFiles.map((file) => readCachedSource(targetDir, file, sourceCache)))).join("\n");
-    const providerListSource = extractProviderListSource(providerSource);
-    const providerEntries = providerListSource === undefined
-        ? []
-        : providerListEntries(providerListSource);
+    const providerEntries = await readProviderListEntries(targetDir, files, config, sourceCache);
     for (const provider of providerDoctorRules) {
+        if (!installedPackages.has(provider.packageName))
+            continue;
+        if (provider.variants !== undefined) {
+            if (detectedProviderVariants(provider.variants, providerEntries).length > 0) {
+                continue;
+            }
+            const severity = providerVariantRegistrationSeverity(provider.variants);
+            if (severity === undefined)
+                continue;
+            const hints = provider.variants
+                .filter((variant) => variant.tokens.length > 0)
+                .map((variant) => registrationTokenHint(variant.tokens));
+            diagnostics.push({
+                severity,
+                code: "BEIGNET_PROVIDER_REGISTRATION_MISSING",
+                file: providerFiles[0] ?? config.paths.server,
+                message: `${provider.packageName} is installed, but no ${provider.displayName} variant is registered in server/providers.ts. Register one of the available providers (${hints.join(", ")}) in the exported providers array or remove the unused package.`,
+            });
+            continue;
+        }
         const severity = provider.registrationSeverity;
         if (severity === undefined)
             continue;
-        if (!installedPackages.has(provider.packageName))
-            continue;
         if (provider.tokens.some((token) => providerEntries.some((entry) => entry.includes(token)))) {
             continue;
         }
@@ -1384,8 +1417,12 @@ async function inspectProviderRegistrationDrift(targetDir, files, config, conven
         });
     }
     const drizzleIndex = findProviderEntryIndex(providerEntries, [
-        "drizzleTursoProvider",
-        "createDrizzleTursoProvider",
+        "drizzleSqliteProvider",
+        "createDrizzleSqliteProvider",
+        "drizzlePostgresProvider",
+        "createDrizzlePostgresProvider",
+        "drizzleMysqlProvider",
+        "createDrizzleMysqlProvider",
     ]);
     const appDatabaseProviderIndex = findProviderEntryIndex(providerEntries, [
         "starterDatabaseProvider",
@@ -1400,7 +1437,7 @@ async function inspectProviderRegistrationDrift(targetDir, files, config, conven
             severity: "warning",
             code: "BEIGNET_PROVIDER_ORDER",
             file: providerFiles[0] ?? config.paths.server,
-            message: "An app database provider is registered before createDrizzleTursoProvider(...). Register the Drizzle/Turso provider first so app-owned database wiring can read ctx.ports.db during setup.",
+            message: "An app database provider is registered before the Drizzle database provider. Register the Drizzle database provider first so app-owned database wiring can read ctx.ports.db during setup.",
         });
     }
     return diagnostics;
@@ -1483,10 +1520,39 @@ function providerDoctorRuleFromMetadata(packageName, metadata) {
         tokens: registration?.tokens ?? [],
         appPorts: metadata.appPorts ?? [],
         requiredEnv: metadata.requiredEnv ?? [],
-        registrationSeverity: registration?.severity ??
-            (registration?.required === true ? "warning" : undefined),
+        registrationSeverity: registrationSeverityFromMetadata(registration),
+        variants: metadata.variants?.map((variant) => ({
+            name: variant.name,
+            displayName: variant.displayName ?? variant.name,
+            tokens: variant.registration?.tokens ?? [],
+            requiredEnv: variant.requiredEnv ?? [],
+            registrationSeverity: registrationSeverityFromMetadata(variant.registration),
+        })),
     };
 }
+function registrationSeverityFromMetadata(registration) {
+    return (registration?.severity ??
+        (registration?.required === true ? "warning" : undefined));
+}
+function detectedProviderVariants(variants, providerEntries) {
+    return variants.filter((variant) => variant.tokens.some((token) => providerEntries.some((entry) => entry.includes(token))));
+}
+function providerVariantRegistrationSeverity(variants) {
+    const severities = variants.map((variant) => variant.registrationSeverity);
+    if (severities.includes("warning"))
+        return "warning";
+    if (severities.includes("hint"))
+        return "hint";
+    return undefined;
+}
+async function readProviderListEntries(targetDir, files, config, sourceCache) {
+    const providerFiles = serverProviderFiles(files, config);
+    const providerSource = (await Promise.all(providerFiles.map((file) => readCachedSource(targetDir, file, sourceCache)))).join("\n");
+    const providerListSource = extractProviderListSource(providerSource);
+    return providerListSource === undefined
+        ? []
+        : providerListEntries(providerListSource);
+}
 function registrationTokenHint(tokens) {
     const token = tokens[0];
     if (!token)