@beignet/cli 0.0.4 → 0.0.5

package/src/choices.ts

@@ -8,28 +8,17 @@
  * Package managers supported by the app template generator.
  */
 export type PackageManager = "bun" | "npm" | "pnpm" | "yarn";
-/**
- * Starter presets supported by the app template generator.
- */
-export type PresetName = "minimal" | "standard";
 /**
  * Application templates supported by the app template generator.
  */
 export type TemplateName = "next";
-/**
- * Optional first-party features that can be scaffolded into a new app.
- */
-export type FeatureName = "client" | "react-query" | "forms" | "openapi";
 /**
  * Optional provider integrations that can be scaffolded into a new app.
+ *
+ * Better Auth, Drizzle/libSQL, and pino ship in every starter, so only
+ * integrations that add an external service remain selectable.
  */
-export type IntegrationName =
-  | "better-auth"
-  | "drizzle-turso"
-  | "inngest"
-  | "pino"
-  | "resend"
-  | "upstash-rate-limit";
+export type IntegrationName = "inngest" | "resend" | "upstash-rate-limit";
 
 /**
  * Supported scaffold template choices.
@@ -48,58 +37,15 @@ export const packageManagerChoices = [
   "yarn",
 ] as const satisfies readonly PackageManager[];
 
-/**
- * Supported scaffold feature choices.
- */
-export const featureChoices = [
-  "client",
-  "react-query",
-  "forms",
-  "openapi",
-] as const satisfies readonly FeatureName[];
-
-/**
- * Supported scaffold preset choices.
- */
-export const presetChoices = [
-  "minimal",
-  "standard",
-] as const satisfies readonly PresetName[];
-
 /**
  * Supported scaffold integration choices.
  */
 export const integrationChoices = [
-  "better-auth",
-  "drizzle-turso",
   "inngest",
-  "pino",
   "resend",
   "upstash-rate-limit",
 ] as const satisfies readonly IntegrationName[];
 
-/**
- * Features included by each starter preset before explicit `--features`
- * selections are added.
- */
-export const presetFeatureDefaults: Record<PresetName, readonly FeatureName[]> =
-  {
-    minimal: [],
-    standard: featureChoices,
-  };
-
-/**
- * Integrations included by each starter preset before explicit
- * `--integrations` selections are added.
- */
-export const presetIntegrationDefaults: Record<
-  PresetName,
-  readonly IntegrationName[]
-> = {
-  minimal: [],
-  standard: ["better-auth", "drizzle-turso", "pino"],
-};
-
 /**
  * Shells supported by `beignet completion install` and `uninstall`.
  */

package/src/create-prompts.ts

@@ -7,14 +7,9 @@
  */
 
 import {
-  type FeatureName,
-  featureChoices,
   type IntegrationName,
   integrationChoices,
   type PackageManager,
-  type PresetName,
-  packageManagerChoices,
-  presetIntegrationDefaults,
 } from "./choices.js";
 
 /**
@@ -22,8 +17,7 @@ import {
  */
 export type CreateSelections = {
   directory?: string;
-  preset?: PresetName;
-  features?: readonly FeatureName[];
+  api?: boolean;
   integrations?: readonly IntegrationName[];
   packageManager?: PackageManager;
 };
@@ -41,9 +35,9 @@ type CreatePromptTty = {
  * Decide whether `beignet create` should run the interactive prompt flow.
  *
  * Prompts run only on a full TTY, only when `--yes` is absent, and only when
- * no selection flag was passed. Any explicit preset, feature, integration, or
- * package manager selection means the invocation is scripted, so the
- * non-interactive path stays byte-identical for agents and CI.
+ * no selection flag was passed. Any explicit api, integration, or package
+ * manager selection means the invocation is scripted, so the non-interactive
+ * path stays byte-identical for agents and CI.
  */
 export function shouldPromptInteractively(
   flags: CreatePromptFlags,
@@ -53,26 +47,15 @@ export function shouldPromptInteractively(
   if (flags.yes) return false;
 
   const selectionFlagPassed =
-    flags.preset !== undefined ||
-    (flags.features?.length ?? 0) > 0 ||
+    flags.api !== undefined ||
     (flags.integrations?.length ?? 0) > 0 ||
     flags.packageManager !== undefined;
 
   return !selectionFlagPassed;
 }
 
-const featureHints: Record<FeatureName, string> = {
-  client: "Typed Beignet HTTP client",
-  "react-query": "TanStack Query helpers for contracts",
-  forms: "React Hook Form wired to contract bodies",
-  openapi: "OpenAPI document route generated from contracts",
-};
-
 const integrationHints: Record<IntegrationName, string> = {
-  "better-auth": "Better Auth routes and auth provider wiring",
-  "drizzle-turso": "Drizzle/libSQL persistence with Turso-ready config",
   inngest: "Inngest-backed background jobs",
-  pino: "Pino logger provider",
   resend: "Resend-backed mail provider",
   "upstash-rate-limit": "Upstash-backed rate limiting",
 };
@@ -103,80 +86,29 @@ export async function promptCreateSelections(
     directory = answer;
   }
 
-  const preset = await prompts.select<PresetName>({
-    message: "Which starter preset?",
-    options: [
-      {
-        value: "standard",
-        label: "standard",
-        hint: "Full app layout with auth, database, jobs, and devtools",
-      },
-      {
-        value: "minimal",
-        label: "minimal",
-        hint: "Smallest contract/server/use-case loop",
-      },
-    ],
-    initialValue: "standard",
+  const api = await prompts.confirm({
+    message: "API-only app (no UI shell)?",
+    initialValue: false,
   });
-  if (prompts.isCancel(preset)) return undefined;
-
-  // The standard preset already includes every starter feature, so the
-  // feature multiselect only appears when the preset leaves features open.
-  let features: readonly FeatureName[] | undefined;
-  if (preset === "minimal") {
-    const answer = await prompts.multiselect<FeatureName>({
-      message: "Add starter features? (press enter to skip)",
-      options: featureChoices.map((feature) => ({
-        value: feature,
-        label: feature,
-        hint: featureHints[feature],
-      })),
-      required: false,
-    });
-    if (prompts.isCancel(answer)) return undefined;
-    features = answer;
-  }
-
-  const presetIntegrations = new Set(presetIntegrationDefaults[preset]);
-  const integrationOptions = integrationChoices.filter(
-    (integration) => !presetIntegrations.has(integration),
-  );
-  let integrations: readonly IntegrationName[] | undefined;
-  if (integrationOptions.length > 0) {
-    const answer = await prompts.multiselect<IntegrationName>({
-      message:
-        presetIntegrations.size > 0
-          ? "Add provider integrations beyond the preset defaults? (press enter to skip)"
-          : "Add provider integrations? (press enter to skip)",
-      options: integrationOptions.map((integration) => ({
-        value: integration,
-        label: integration,
-        hint: integrationHints[integration],
-      })),
-      required: false,
-    });
-    if (prompts.isCancel(answer)) return undefined;
-    integrations = answer;
-  }
-
-  const packageManager = await prompts.select<PackageManager>({
-    message: "Which package manager?",
-    options: packageManagerChoices.map((manager) => ({
-      value: manager,
-      label: manager,
+  if (prompts.isCancel(api)) return undefined;
+
+  const integrations = await prompts.multiselect<IntegrationName>({
+    message: "Add provider integrations? (press enter to skip)",
+    options: integrationChoices.map((integration) => ({
+      value: integration,
+      label: integration,
+      hint: integrationHints[integration],
     })),
-    initialValue: "bun",
+    required: false,
   });
-  if (prompts.isCancel(packageManager)) return undefined;
+  if (prompts.isCancel(integrations)) return undefined;
 
   prompts.outro(`Creating ${directory}`);
 
   return {
     directory,
-    preset,
-    features,
+    api,
     integrations,
-    packageManager,
+    packageManager: initial.packageManager,
   };
 }

package/src/create.ts

@@ -1,16 +1,12 @@
 import { mkdir, readdir, writeFile } from "node:fs/promises";
 import path from "node:path";
-import { presetFeatureDefaults, presetIntegrationDefaults } from "./choices.js";
 import {
-  type FeatureName,
-  featureChoices,
   getTemplateFiles,
   type IntegrationName,
   integrationChoices,
   type PackageManager,
-  type PresetName,
   type TemplateName,
-} from "./templates.js";
+} from "./templates/index.js";
 import { getCliVersion } from "./version.js";
 
 /**
@@ -20,8 +16,10 @@ export type CreateOptions = {
   name: string;
   cwd?: string;
   template?: TemplateName;
-  preset?: PresetName;
-  features?: FeatureName[];
+  /**
+   * Scaffold an API-only app without the UI shell.
+   */
+  api?: boolean;
   packageManager?: PackageManager;
   integrations?: IntegrationName[];
   force?: boolean;
@@ -42,7 +40,7 @@ export type CreateResult = {
 };
 
 /**
- * Create a Beignet app from a starter template.
+ * Create a Beignet app from the starter template.
  */
 export async function createProject(
   options: CreateOptions,
@@ -52,9 +50,8 @@ export async function createProject(
   const targetDir = path.resolve(cwd, options.name);
   const packageManager = options.packageManager ?? "bun";
   const template = options.template ?? "next";
-  const preset = options.preset ?? "standard";
-  const features = resolveFeatures(preset, options.features ?? []);
-  const integrations = resolveIntegrations(preset, options.integrations ?? []);
+  const api = Boolean(options.api);
+  const integrations = resolveIntegrations(options.integrations ?? []);
 
   if (template !== "next") {
     throw new Error(
@@ -70,8 +67,7 @@ export async function createProject(
     name,
     packageManager,
     beignetVersion: options.beignetVersion ?? getDefaultBeignetVersion(),
-    preset,
-    features,
+    api,
     integrations,
   });
 
@@ -95,38 +91,25 @@ export async function createProject(
   };
 }
 
-function resolveFeatures(
-  preset: PresetName,
-  explicitFeatures: FeatureName[],
-): FeatureName[] {
-  const features = new Set<FeatureName>(presetFeatureDefaults[preset]);
-
-  for (const feature of explicitFeatures) {
-    features.add(feature);
-  }
-
-  if (features.has("forms")) {
-    features.add("react-query");
-  }
-  if (features.has("react-query")) {
-    features.add("client");
-  }
-
-  return featureChoices.filter((feature) => features.has(feature));
-}
+/**
+ * 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"]);
 
 function resolveIntegrations(
-  preset: PresetName,
   explicitIntegrations: IntegrationName[],
 ): IntegrationName[] {
-  const integrations = new Set<IntegrationName>(
-    presetIntegrationDefaults[preset],
-  );
-
   for (const integration of explicitIntegrations) {
-    integrations.add(integration);
+    if (baseProviderNames.has(integration)) {
+      throw new Error(
+        `${integration} is part of every Beignet starter and no longer an --integrations choice.`,
+      );
+    }
   }
 
+  const integrations = new Set<IntegrationName>(explicitIntegrations);
+
   return integrationChoices.filter((integration) =>
     integrations.has(integration),
   );

package/src/index.ts

@@ -16,16 +16,12 @@ import {
 import {
   type CompletionShell,
   completionShellChoices,
-  type FeatureName,
-  featureChoices,
   type IntegrationName,
   integrationChoices,
   type MakeFeatureAddon,
   makeFeatureAddonChoices,
   type PackageManager,
-  type PresetName,
   packageManagerChoices,
-  presetChoices,
   type TemplateName,
   templateChoices,
 } from "./choices.js";
@@ -47,9 +43,8 @@ const outputFormatChoices = [
 
 type CreateFlags = {
   template: TemplateName;
-  preset?: PresetName;
+  api?: boolean;
   packageManager?: PackageManager;
-  features?: readonly FeatureName[];
   integrations?: readonly IntegrationName[];
   yes?: boolean;
   force?: boolean;
@@ -286,7 +281,10 @@ const createCommand = buildCommand<
 >({
   docs: {
     brief: "Create a new Beignet app.",
-    fullDescription: `Available features: ${featureChoices.join(", ")}
+    fullDescription: `Scaffolds a full-stack Beignet starter: typed contracts, Better Auth,
+Drizzle/libSQL persistence with checked-in migrations, pino logging,
+devtools, and a shadcn UI shell. Pass --api for an API-only scaffold
+without the UI shell.
 
 Available integrations: ${integrationChoices.join(", ")}
 
@@ -301,11 +299,11 @@ prompt-based setup. Pass --yes or any selection flag to skip the prompts.`,
         default: "next",
         brief: "Template to use.",
       },
-      preset: {
-        kind: "enum",
-        values: presetChoices,
+      api: {
+        kind: "boolean",
         optional: true,
-        brief: "Starter preset to generate. Defaults to standard.",
+        withNegated: false,
+        brief: "Scaffold an API-only app without the UI shell.",
       },
       packageManager: {
         kind: "enum",
@@ -313,13 +311,6 @@ prompt-based setup. Pass --yes or any selection flag to skip the prompts.`,
         optional: true,
         brief: "Package manager to use in next-step commands.",
       },
-      features: {
-        kind: "enum",
-        values: featureChoices,
-        optional: true,
-        variadic: ",",
-        brief: "Add starter features as a comma-separated list.",
-      },
       integrations: {
         kind: "enum",
         values: integrationChoices,
@@ -362,8 +353,7 @@ prompt-based setup. Pass --yes or any selection flag to skip the prompts.`,
     ) {
       let selections: CreateSelections = {
         directory,
-        preset: flags.preset,
-        features: flags.features,
+        api: flags.api,
         integrations: flags.integrations,
         packageManager: flags.packageManager,
       };
@@ -391,12 +381,12 @@ prompt-based setup. Pass --yes or any selection flag to skip the prompts.`,
         );
       }
 
+      const api = selections.api ?? false;
       const integrations = uniqueValues([...(selections.integrations ?? [])]);
       const result = await createProject({
         name: selections.directory,
         template: flags.template,
-        preset: selections.preset ?? "standard",
-        features: uniqueValues([...(selections.features ?? [])]),
+        api,
         packageManager: selections.packageManager,
         integrations,
         force: Boolean(flags.force),
@@ -407,7 +397,7 @@ prompt-based setup. Pass --yes or any selection flag to skip the prompts.`,
         this,
         flags.json
           ? JSON.stringify(result, null, 2)
-          : nextSteps(result, { integrations }),
+          : nextSteps(result, { api, integrations }),
       );
     };
   },
@@ -1020,7 +1010,7 @@ const makeScheduleCommand = buildCommand<
         this,
         flags.json
           ? JSON.stringify(result, null, 2)
-          : makeScheduleNextSteps(result),
+          : makeScheduleNextSteps(result, { route: Boolean(flags.route) }),
       );
     };
   },
@@ -1245,7 +1235,10 @@ Run:
 
 function nextSteps(
   result: CreateNextStepsResult,
-  options: { integrations?: readonly IntegrationName[] } = {},
+  options: {
+    api?: boolean;
+    integrations?: readonly IntegrationName[];
+  } = {},
 ): string {
   if (result.dryRun) {
     const plannedFiles = result.files.map((file) => `  ${file}`).join("\n");
@@ -1259,37 +1252,29 @@ ${plannedFiles}`;
   const pm = result.packageManager;
   const run = pm === "npm" ? "npm run" : `${pm} run`;
   const cli = packageRunnerFromPackageManager(pm);
-  const envFileStep = result.files.includes(".env.example")
-    ? "  cp .env.example .env.local\n"
-    : "";
   const envRequiredIntegrations =
     options.integrations?.filter(isEnvRequiredProviderIntegration) ?? [];
   const envStep =
     envRequiredIntegrations.length > 0
       ? "  Fill .env.local for selected provider integrations before starting the app.\n"
       : "";
-  const hasDatabase = result.files.some((file) => file.startsWith("infra/db/"));
-  const databaseStep = hasDatabase
-    ? `
-Prepare the database:
-  ${cli} db generate
-  ${cli} db migrate
-`
-    : "";
-  const featureDatabaseSteps = hasDatabase
-    ? `
-  ${cli} db generate
-  ${cli} db migrate`
-    : "";
+  const openStep = options.api
+    ? "  open http://localhost:3000 for the API landing page"
+    : "  open http://localhost:3000/sign-up";
 
   return `Created ${result.name} at ${result.targetDir}
 
 Next steps:
   cd ${result.targetDir}
   ${pm} install
-${envFileStep}${envStep}${databaseStep}
+  cp .env.example .env.local
+${envStep}
+Prepare the database:
+  ${cli} db migrate
+
 Start the app:
   ${run} dev
+${openStep}
 
 Inspect the app:
   ${cli} routes
@@ -1297,7 +1282,9 @@ Inspect the app:
   ${cli} doctor
 
 Generate a feature:
-  ${cli} make feature projects${featureDatabaseSteps}
+  ${cli} make feature projects
+  ${cli} db generate
+  ${cli} db migrate
   ${run} test
   ${run} typecheck
   ${cli} lint
@@ -1477,10 +1464,17 @@ function makeListenerNextSteps(result: MakeNextStepsResult): string {
   ]);
 }
 
-function makeScheduleNextSteps(result: MakeNextStepsResult): string {
+function makeScheduleNextSteps(
+  result: MakeNextStepsResult,
+  options: { route?: boolean } = {},
+): string {
   return makeNextSteps(result, "schedule", [
     "Replace the starter payload and handler with the scheduled workflow.",
-    "Trigger it from a cron route, worker, or provider adapter.",
+    ...(options.route
+      ? [
+          "Set CRON_SECRET in your deployment and configure a scheduled request with Authorization: Bearer $CRON_SECRET.",
+        ]
+      : ["Trigger it from a cron route, worker, or provider adapter."]),
   ]);
 }
 

package/src/lib.ts

@@ -42,4 +42,4 @@ export {
 export { runOutboxDrain } from "./outbox.js";
 export { runAppSchedule } from "./schedule.js";
 export { runAppTask } from "./task.js";
-export type { IntegrationName } from "./templates.js";
+export type { IntegrationName } from "./templates/index.js";