@beignet/cli 0.0.24 → 0.0.25

package/src/index.ts

@@ -107,6 +107,27 @@ type DbFlags = {
   dryRun?: boolean;
 };
 
+type DatabaseSchemaDialect = "sqlite" | "postgres" | "mysql";
+type DatabaseSchemaTable = "audit" | "idempotency" | "outbox";
+
+const databaseSchemaDialectChoices = [
+  "sqlite",
+  "postgres",
+  "mysql",
+] as const satisfies readonly DatabaseSchemaDialect[];
+
+const databaseSchemaTableChoices = [
+  "audit",
+  "idempotency",
+  "outbox",
+] as const satisfies readonly DatabaseSchemaTable[];
+
+type DbSchemaGenerateFlags = DbFlags & {
+  dialect?: DatabaseSchemaDialect;
+  tables?: readonly DatabaseSchemaTable[];
+  output?: string;
+};
+
 type TaskRunFlags = {
   json?: boolean;
   input?: string;
@@ -142,6 +163,11 @@ type DoctorFlags = {
   format?: OutputFormat;
 };
 
+type ProviderAuditFlags = {
+  json?: boolean;
+  cwd?: string;
+};
+
 const parseString = (input: string): string => input;
 const parsePositiveInteger = (input: string): number => {
   const value = Number(input);
@@ -209,11 +235,38 @@ const lintFlagParameters = {
   format: formatFlag,
 } satisfies FlagParametersForType<LintFlags, CliContext>;
 
+const providerAuditFlagParameters = {
+  json: jsonFlag,
+  cwd: cwdFlag,
+} satisfies FlagParametersForType<ProviderAuditFlags, CliContext>;
+
 const dbFlagParameters = {
   json: jsonFlag,
   dryRun: dryRunFlag,
 } satisfies FlagParametersForType<DbFlags, CliContext>;
 
+const dbSchemaGenerateFlagParameters = {
+  ...dbFlagParameters,
+  dialect: {
+    kind: "enum",
+    values: databaseSchemaDialectChoices,
+    optional: true,
+    brief:
+      "Drizzle dialect to generate for. Inferred from server/providers.ts when omitted.",
+  },
+  tables: {
+    kind: "enum",
+    values: databaseSchemaTableChoices,
+    optional: true,
+    variadic: ",",
+    brief:
+      "Provider tables to generate as a comma-separated list. Defaults to audit,idempotency,outbox.",
+  },
+  output: parsedStringFlag(
+    "Generated schema file. Defaults to infra/db/schema/beignet.ts.",
+  ),
+} satisfies FlagParametersForType<DbSchemaGenerateFlags, CliContext>;
+
 const taskRunFlagParameters = {
   json: jsonFlag,
   input: parsedStringFlag("JSON input passed to the task schema."),
@@ -557,6 +610,44 @@ const mcpCommand = buildCommand<McpFlags, [], CliContext>({
   },
 });
 
+const providerAuditCommand = buildCommand<ProviderAuditFlags, [], CliContext>({
+  docs: {
+    brief: "Audit installed Beignet provider setup.",
+    fullDescription:
+      "Reports installed provider packages, metadata validity, registration, provider env, required tables, app ports, and variants. This command is report-only; doctor remains the enforcement surface.",
+  },
+  parameters: {
+    flags: providerAuditFlagParameters,
+  },
+  loader: async () => {
+    const { auditProviders, formatProviderAudit } = await import(
+      "./provider-audit.js"
+    );
+
+    return async function runProviderAudit(
+      this: CliContext,
+      flags: ProviderAuditFlags,
+    ) {
+      const result = await auditProviders({ cwd: flags.cwd });
+      writeOutput(
+        this,
+        flags.json
+          ? JSON.stringify(result, null, 2)
+          : formatProviderAudit(result),
+      );
+    };
+  },
+});
+
+const providerRoutes = buildRouteMap({
+  docs: {
+    brief: "Inspect Beignet provider setup.",
+  },
+  routes: {
+    audit: providerAuditCommand,
+  },
+});
+
 type DatabaseCommandName = "generate" | "migrate" | "reset" | "seed";
 
 function databaseCommand(command: DatabaseCommandName) {
@@ -591,6 +682,52 @@ function databaseCommand(command: DatabaseCommandName) {
   });
 }
 
+const dbSchemaGenerateCommand = buildCommand<
+  DbSchemaGenerateFlags,
+  [],
+  CliContext
+>({
+  docs: {
+    brief: "Generate provider-owned Drizzle schema exports.",
+    fullDescription:
+      "Writes an app-owned schema file that re-exports Beignet provider tables, then updates the schema index. Run beignet db generate afterward to let the app's Drizzle Kit script create migrations.",
+  },
+  parameters: {
+    flags: dbSchemaGenerateFlagParameters,
+  },
+  loader: async () => {
+    const { generateDatabaseSchema } = await import("./db.js");
+
+    return async function runDbSchemaGenerate(
+      this: CliContext,
+      flags: DbSchemaGenerateFlags,
+    ) {
+      const result = await generateDatabaseSchema({
+        dialect: flags.dialect,
+        tables: flags.tables,
+        output: flags.output,
+        dryRun: Boolean(flags.dryRun),
+      });
+
+      writeOutput(
+        this,
+        flags.json
+          ? JSON.stringify(result, null, 2)
+          : databaseSchemaGenerateNextSteps(result),
+      );
+    };
+  },
+});
+
+const dbSchemaRoutes = buildRouteMap({
+  docs: {
+    brief: "Generate Beignet database schema helpers.",
+  },
+  routes: {
+    generate: dbSchemaGenerateCommand,
+  },
+});
+
 const dbRoutes = buildRouteMap({
   docs: {
     brief: "Run Beignet database lifecycle commands.",
@@ -599,6 +736,7 @@ const dbRoutes = buildRouteMap({
     generate: databaseCommand("generate"),
     migrate: databaseCommand("migrate"),
     reset: databaseCommand("reset"),
+    schema: dbSchemaRoutes,
     seed: databaseCommand("seed"),
   },
 });
@@ -1214,6 +1352,7 @@ Run npm create beignet@latest (or bun create beignet) to scaffold a new app.`,
     make: makeRoutes,
     mcp: mcpCommand,
     outbox: outboxRoutes,
+    providers: providerRoutes,
     routes: routesCommand,
     schedule: scheduleRoutes,
     task: taskRoutes,
@@ -1278,6 +1417,18 @@ type DatabaseCommandNextStepsResult = {
   dryRun: boolean;
 };
 
+type DatabaseSchemaGenerateNextStepsResult = {
+  cwd: string;
+  dialect: DatabaseSchemaDialect;
+  tables: DatabaseSchemaTable[];
+  output: string;
+  indexFile: string;
+  createdFiles: string[];
+  updatedFiles: string[];
+  skippedFiles: string[];
+  dryRun: boolean;
+};
+
 type AppTaskRunNextStepsResult = {
   name: string;
   durationMs: number;
@@ -1432,7 +1583,12 @@ function isEnvRequiredProviderIntegration(
   );
 }
 
-function changedFileLines(result: MakeNextStepsResult): {
+function changedFileLines(
+  result: Pick<
+    MakeNextStepsResult,
+    "createdFiles" | "updatedFiles" | "skippedFiles"
+  >,
+): {
   changedFiles: string;
   skippedFiles: string;
 } {
@@ -1482,6 +1638,29 @@ Command:
   ${command}`;
 }
 
+function databaseSchemaGenerateNextSteps(
+  result: DatabaseSchemaGenerateNextStepsResult,
+): string {
+  const { changedFiles, skippedFiles } = changedFileLines({
+    createdFiles: result.createdFiles,
+    updatedFiles: result.updatedFiles,
+    skippedFiles: result.skippedFiles,
+  });
+  const prefix = result.dryRun ? "Would generate" : "Generated";
+  const tables = result.tables.join(", ");
+
+  return `${prefix} Beignet ${result.dialect} database schema (${tables}) in ${result.cwd}
+
+Changed files:
+${changedFiles || "  none"}
+${skippedFiles ? `\nSkipped identical files:\n${skippedFiles}` : ""}
+
+Next steps:
+  Run beignet db generate to produce app-owned Drizzle migrations.
+  Run beignet db migrate to apply the migration.
+  Run beignet doctor --strict to check provider setup.`;
+}
+
 function makeFeatureNextSteps(result: MakeNextStepsResult): string {
   return makeNextSteps(result, "feature slice", [
     "Use make feature for product capabilities and workflows. Use make resource when the concept is mostly CRUD-shaped.",