@beignet/cli 0.0.37 → 0.0.39

package/src/schedule.ts

@@ -1,5 +1,6 @@
 import { readFile, stat } from "node:fs/promises";
 import path from "node:path";
+import type { ErrorReporterPort } from "@beignet/core/error-reporting";
 import type { ProviderInstrumentationPort } from "@beignet/core/providers";
 import type {
   ScheduleDef,
@@ -8,6 +9,10 @@ import type {
 } from "@beignet/core/schedules";
 import { createJiti } from "jiti";
 import { loadBeignetConfig, normalizePath } from "./config.js";
+import {
+  flushOperationalErrorReporter,
+  reportOperationalFailure,
+} from "./operational-error-reporting.js";
 
 /**
  * Options for running one app-owned schedule.
@@ -56,6 +61,7 @@ type ScheduleContext = {
     logger?: ScheduleLogger;
     devtools?: ProviderInstrumentationPort;
     instrumentation?: ProviderInstrumentationPort;
+    errorReporter?: ErrorReporterPort;
   };
 };
 
@@ -131,7 +137,31 @@ export async function runAppSchedule(
       },
     });
 
-    await runner.run(schedule, runOptions);
+    try {
+      await runner.run(schedule, runOptions);
+    } catch (error) {
+      await reportOperationalFailure({
+        ctx: scheduleContext,
+        error,
+        reportOptions: {
+          level: "error",
+          mechanism: "beignet.schedule.cli",
+          handled: false,
+          tags: {
+            "beignet.kind": "schedule",
+            "beignet.schedule": schedule.name,
+          },
+          contexts: {
+            schedule: {
+              name: schedule.name,
+              source: runOptions.source ?? "beignet-cli",
+              attempt: runOptions.attempt ?? null,
+            },
+          },
+        },
+      });
+      throw error;
+    }
 
     return {
       schemaVersion: 1,
@@ -148,6 +178,7 @@ export async function runAppSchedule(
       durationMs: Math.round(performance.now() - startedAt),
     };
   } finally {
+    await flushOperationalErrorReporter(scheduleContext);
     await scheduleModule.stopScheduleContext?.(ctx, contextArgs);
   }
 }

package/src/task.ts

@@ -3,6 +3,11 @@ import path from "node:path";
 import type { TaskDef, TaskRunContextArgs } from "@beignet/core/tasks";
 import { createJiti } from "jiti";
 import { loadBeignetConfig, normalizePath } from "./config.js";
+import {
+  flushOperationalErrorReporter,
+  type OperationalErrorReportingContext,
+  reportOperationalFailure,
+} from "./operational-error-reporting.js";
 
 /**
  * Options for running an app-owned operational task.
@@ -63,10 +68,35 @@ export async function runAppTask(
     : {};
 
   try {
-    const output = await runTask(task, {
-      input: parsedInput,
-      ctx,
-    });
+    let output: unknown;
+    try {
+      output = await runTask(task, {
+        input: parsedInput,
+        ctx,
+      });
+    } catch (error) {
+      await reportOperationalFailure({
+        ctx: toOperationalContext(ctx),
+        error,
+        reportOptions: {
+          level: "error",
+          mechanism: "beignet.task.cli",
+          handled: false,
+          tags: {
+            "beignet.kind": "task",
+            "beignet.task": task.name,
+          },
+          contexts: {
+            task: {
+              name: task.name,
+              tenant: options.tenant ?? null,
+              source: "beignet-cli",
+            },
+          },
+        },
+      });
+      throw error;
+    }
 
     return {
       schemaVersion: 1,
@@ -79,10 +109,17 @@ export async function runAppTask(
       durationMs: Math.round(performance.now() - startedAt),
     };
   } finally {
+    await flushOperationalErrorReporter(toOperationalContext(ctx));
     await taskModule.stopTaskContext?.(ctx, contextArgs);
   }
 }
 
+function toOperationalContext(ctx: unknown): OperationalErrorReportingContext {
+  return typeof ctx === "object" && ctx !== null
+    ? (ctx as OperationalErrorReportingContext)
+    : {};
+}
+
 function parseTaskInputFlag(input: RunAppTaskOptions["input"]): unknown {
   if (input === undefined) return {};
   if (typeof input !== "string") return input;
@@ -105,7 +142,7 @@ async function loadTaskModule(
     await stat(absolutePath);
   } catch {
     throw new Error(
-      `Could not find app task registry at ${modulePath}. Create it with beignet make task <feature>/<name> or configure paths.tasks in beignet.config.ts.`,
+      `Could not find app task registry at ${modulePath}. Create it with beignet make task <feature.name> or configure paths.tasks in beignet.config.ts.`,
     );
   }
 

package/src/templates/base.ts

@@ -2,10 +2,10 @@ import { databaseLocalUrl, databaseStartCommand } from "../choices.js";
 import { shadcnDependencies, shadcnDevDependencies } from "./shadcn.js";
 import {
   externalVersions,
-  hasIntegration,
-  integrationDeps,
+  hasStarterProvider,
   json,
   packageRunner,
+  starterProviderDeps,
   type TemplateContext,
 } from "./shared.js";
 import { shellDependencies, shellDevDependencies } from "./shell.js";
@@ -55,9 +55,9 @@ export function packageJson(ctx: TemplateContext): string {
     }
   }
 
-  for (const integration of ctx.integrations) {
+  for (const provider of ctx.providers) {
     for (const [name, version] of Object.entries(
-      integrationDeps[integration],
+      starterProviderDeps[provider],
     )) {
       dependencies[name] = version || ctx.beignetVersion;
     }
@@ -356,10 +356,10 @@ ${optionalAuthRedirects}
       : "; it refuses non-local hosts unless `BEIGNET_ALLOW_DATABASE_RESET=true`"
   }.
 - Remove \`DEVTOOLS_ENABLED=true\` in production unless you add authentication and stricter redaction.
-- Set \`APP_URL\`, \`BETTER_AUTH_SECRET\`, \`LOG_LEVEL\`, and service-specific integration variables in your hosting environment.
+- Set \`APP_URL\`, \`BETTER_AUTH_SECRET\`, \`LOG_LEVEL\`, and provider-specific variables in your hosting environment.
 - Set \`BETTER_AUTH_TRUSTED_ORIGINS\` before serving auth across multiple origins.
 - Review the starter authorization policy before exposing user-owned data.
-${ctx.integrations.length > 0 ? "\nSee `docs/integrations.md` for setup notes.\n" : ""}`;
+${ctx.providers.length > 0 ? "\nSee `docs/providers.md` for setup notes.\n" : ""}`;
 }
 
 function intentRunner(ctx: TemplateContext): string {
@@ -375,16 +375,16 @@ function intentRunner(ctx: TemplateContext): string {
   }
 }
 
-export function integrationsDoc(ctx: TemplateContext): string {
+export function providersDoc(ctx: TemplateContext): string {
   const lines = [
-    "# Integrations",
+    "# Providers",
     "",
-    "The starter app added dependencies for the integrations you selected. Runtime providers are wired in `server/providers.ts` when Beignet can do so safely; integrations that need app-owned setup list their follow-up steps below.",
+    "The starter app added dependencies for the providers you selected. Runtime providers are wired in `server/providers.ts` when Beignet can do so safely; providers that need app-owned setup list their follow-up steps below.",
     "",
   ];
 
-  for (const integration of ctx.integrations) {
-    if (integration === "inngest") {
+  for (const provider of ctx.providers) {
+    if (provider === "jobs-inngest") {
       lines.push(
         "## Inngest jobs",
         "",
@@ -398,7 +398,7 @@ export function integrationsDoc(ctx: TemplateContext): string {
       );
     }
 
-    if (integration === "resend") {
+    if (provider === "mail-resend") {
       lines.push(
         "## Resend mail",
         "",
@@ -410,7 +410,7 @@ export function integrationsDoc(ctx: TemplateContext): string {
       );
     }
 
-    if (integration === "upstash-rate-limit") {
+    if (provider === "rate-limit-upstash") {
       lines.push(
         "## Upstash rate limit",
         "",
@@ -470,11 +470,11 @@ export function envExample(ctx: TemplateContext): string {
     "",
   ];
 
-  if (hasIntegration(ctx, "inngest")) {
+  if (hasStarterProvider(ctx, "jobs-inngest")) {
     lines.push("INNGEST_APP_NAME=beignet-app", "# INNGEST_EVENT_KEY=", "");
   }
 
-  if (hasIntegration(ctx, "resend")) {
+  if (hasStarterProvider(ctx, "mail-resend")) {
     lines.push(
       "# Dev placeholders keep the app bootable; set real Resend values before sending mail.",
       "RESEND_API_KEY=dev-placeholder-change-me",
@@ -483,7 +483,7 @@ export function envExample(ctx: TemplateContext): string {
     );
   }
 
-  if (hasIntegration(ctx, "upstash-rate-limit")) {
+  if (hasStarterProvider(ctx, "rate-limit-upstash")) {
     lines.push(
       "# Dev placeholders keep the app bootable; set real Upstash values before rate limiting.",
       "UPSTASH_REDIS_REST_URL=https://dev-placeholder.upstash.io",

package/src/templates/index.ts

@@ -1,26 +1,26 @@
 export type {
   DatabaseName,
-  IntegrationName,
   PackageManager,
+  StarterProviderName,
   TemplateName,
 } from "../choices.js";
-export { databaseChoices, integrationChoices } from "../choices.js";
+export { databaseChoices, starterProviderChoices } from "../choices.js";
 export type { TemplateContext, TemplateFile } from "./shared.js";
 
 import { agentsMd, mcpJson } from "./agents.js";
 import {
   baseFiles,
   envExample,
-  integrationsDoc,
   packageJson,
+  providersDoc,
   readme,
 } from "./base.js";
 import { dbFiles } from "./db/index.js";
 import {
   betterAuth,
   env,
-  infrastructurePorts,
   ports,
+  portWiring,
   server,
   serverFiles,
   serverProviders,
@@ -109,7 +109,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/port-wiring.ts", content: portWiring(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 },
@@ -154,10 +154,10 @@ export function getTemplateFiles(ctx: TemplateContext): TemplateFile[] {
     templateFiles.push(...shadcnTemplateFiles(), ...shellTemplateFiles(ctx));
   }
 
-  if (ctx.integrations.length > 0) {
+  if (ctx.providers.length > 0) {
     templateFiles.push({
-      path: "docs/integrations.md",
-      content: integrationsDoc(ctx),
+      path: "docs/providers.md",
+      content: providersDoc(ctx),
     });
   }
 

package/src/templates/server.ts

@@ -1,7 +1,7 @@
 import { databaseLocalUrl } from "../choices.js";
 import {
   databaseDescriptor,
-  hasIntegration,
+  hasStarterProvider,
   type TemplateContext,
 } from "./shared.js";
 
@@ -12,14 +12,14 @@ export function serverProviders(ctx: TemplateContext): string {
     'import { createDevtoolsProvider } from "@beignet/devtools";',
     'import { createBetterAuthProvider } from "@beignet/provider-auth-better-auth";',
     `import { ${db.providerFactory} } from "@beignet/provider-db-drizzle/${db.subpath}";`,
-    hasIntegration(ctx, "inngest")
+    hasStarterProvider(ctx, "jobs-inngest")
       ? 'import { createInngestJobsProvider } from "@beignet/provider-jobs-inngest";'
       : undefined,
     'import { createPinoLoggerProvider } from "@beignet/provider-logger-pino";',
-    hasIntegration(ctx, "resend")
+    hasStarterProvider(ctx, "mail-resend")
       ? 'import { createResendMailProvider } from "@beignet/provider-mail-resend";'
       : undefined,
-    hasIntegration(ctx, "upstash-rate-limit")
+    hasStarterProvider(ctx, "rate-limit-upstash")
       ? 'import { createUpstashRateLimitProvider } from "@beignet/provider-rate-limit-upstash";'
       : undefined,
     'import * as schema from "@/infra/db/schema";',
@@ -35,11 +35,13 @@ export function serverProviders(ctx: TemplateContext): string {
     "\tcreatePinoLoggerProvider(),",
     `\t${db.providerInstance},`,
     "\tstarterDatabaseProvider,",
-    hasIntegration(ctx, "inngest")
+    hasStarterProvider(ctx, "jobs-inngest")
       ? "\tcreateInngestJobsProvider(),"
       : undefined,
-    hasIntegration(ctx, "resend") ? "\tcreateResendMailProvider()," : undefined,
-    hasIntegration(ctx, "upstash-rate-limit")
+    hasStarterProvider(ctx, "mail-resend")
+      ? "\tcreateResendMailProvider(),"
+      : undefined,
+    hasStarterProvider(ctx, "rate-limit-upstash")
       ? "\tcreateUpstashRateLimitProvider(),"
       : undefined,
   ].filter((entry): entry is string => Boolean(entry));
@@ -58,9 +60,9 @@ ${entries.join("\n")}
 }
 
 export function ports(ctx: TemplateContext): string {
-  const usesInngest = hasIntegration(ctx, "inngest");
-  const usesResend = hasIntegration(ctx, "resend");
-  const usesUpstash = hasIntegration(ctx, "upstash-rate-limit");
+  const usesInngest = hasStarterProvider(ctx, "jobs-inngest");
+  const usesResend = hasStarterProvider(ctx, "mail-resend");
+  const usesUpstash = hasStarterProvider(ctx, "rate-limit-upstash");
   const coreImports = [
     "\tBoundGate,",
     "\tGatePort,",
@@ -101,14 +103,16 @@ ${usesResend ? "\tmailer: MailerPort;\n" : ""}${usesUpstash ? "\trateLimit: Rate
 `;
 }
 
-export function infrastructurePorts(ctx: TemplateContext): string {
+export function portWiring(ctx: TemplateContext): string {
   const deferred = [
     '\t\t"auth",',
     '\t\t"idempotency",',
-    hasIntegration(ctx, "inngest") ? '\t\t"jobs",' : undefined,
+    hasStarterProvider(ctx, "jobs-inngest") ? '\t\t"jobs",' : undefined,
     '\t\t"logger",',
-    hasIntegration(ctx, "resend") ? '\t\t"mailer",' : undefined,
-    hasIntegration(ctx, "upstash-rate-limit") ? '\t\t"rateLimit",' : undefined,
+    hasStarterProvider(ctx, "mail-resend") ? '\t\t"mailer",' : undefined,
+    hasStarterProvider(ctx, "rate-limit-upstash")
+      ? '\t\t"rateLimit",'
+      : undefined,
     '\t\t"todos",',
     '\t\t"uow",',
   ].filter((entry): entry is string => Boolean(entry));
@@ -130,13 +134,13 @@ const gate = createGate({
 });
 
 /**
- * App ports the server boots with.
+ * Initial port values the server boots with.
  *
  * Bound ports are app-owned. Every deferred key is contributed by a provider
  * in server/providers.ts during startup; createNextServer(...) fails boot if
  * any of them is still unbound after providers have started.
  */
-export const appPorts = definePorts<AppPorts>()({
+export const initialPorts = definePorts<AppPorts>()({
 	bound: {
 		errorReporter: createNoopErrorReporter(),
 		gate,
@@ -290,7 +294,7 @@ import {
 	createSecurityHeadersHooks,
 } from "@beignet/core/server";
 import type { AppContext } from "@/app-context";
-import { appPorts } from "@/infra/app-ports";
+import { initialPorts } from "@/infra/port-wiring";
 import { closeDatabaseClient } from "@/infra/db/client";
 import { env } from "@/lib/env";
 import { appContext } from "./context";
@@ -300,7 +304,7 @@ export const getServer = createNextServerLoader(async () => {
 	const { providers } = await import("./providers");
 
 	const server = await createNextServer({
-	ports: appPorts,
+	ports: initialPorts,
 	providers,
 	hooks: [
 		createSecurityHeadersHooks<AppContext>(),

package/src/templates/shared.ts

@@ -1,7 +1,7 @@
 import type {
   DatabaseName,
-  IntegrationName,
   PackageManager,
+  StarterProviderName,
 } from "../choices.js";
 
 /**
@@ -23,7 +23,7 @@ export type TemplateContext = {
    * When true, scaffold an API-only app without the UI shell.
    */
   api: boolean;
-  integrations: IntegrationName[];
+  providers: StarterProviderName[];
   /**
    * Database backing the starter's Drizzle persistence layer.
    */
@@ -169,30 +169,30 @@ export function packageRunner(ctx: TemplateContext): string {
   }
 }
 
-export const integrationDeps: Record<
-  IntegrationName,
+export const starterProviderDeps: Record<
+  StarterProviderName,
   Record<string, string>
 > = {
-  inngest: {
+  "jobs-inngest": {
     "@beignet/provider-jobs-inngest": "",
     inngest: externalVersions.inngest,
   },
-  resend: {
+  "mail-resend": {
     "@beignet/provider-mail-resend": "",
     resend: externalVersions.resend,
   },
-  "upstash-rate-limit": {
+  "rate-limit-upstash": {
     "@beignet/provider-rate-limit-upstash": "",
     "@upstash/ratelimit": externalVersions.upstashRateLimit,
     "@upstash/redis": externalVersions.upstashRedis,
   },
 };
 
-export function hasIntegration(
+export function hasStarterProvider(
   ctx: TemplateContext,
-  integration: IntegrationName,
+  provider: StarterProviderName,
 ): boolean {
-  return ctx.integrations.includes(integration);
+  return ctx.providers.includes(provider);
 }
 
 export function json(value: unknown): string {

package/src/templates/testing.ts

@@ -536,7 +536,7 @@ async function configuredRoots(cwd: string): Promise<string[]> {
     paths.features,
     parentPath(paths.routes),
     parentPath(paths.server),
-    parentPath(paths.infrastructurePorts),
+    parentPath(paths.portWiring),
     parentPath(paths.ports),
     parentPath(paths.useCaseBuilder),
     parentPath(paths.routesBuilder),

package/src/templates/todos.ts

@@ -368,7 +368,7 @@ import {
 import { createInMemoryDevtools } from "@beignet/devtools";
 import type { AppContext } from "@/app-context";
 import type { TodoRepository } from "@/features/todos/ports";
-import { appPorts } from "@/infra/app-ports";
+import { initialPorts } from "@/infra/port-wiring";
 import type { AppTransactionPorts } from "@/ports";
 import {
 	createTodoUseCase,
@@ -388,9 +388,9 @@ function createTester(userId: string, todos: TodoRepository) {
 		session: { id: \`session_\${userId}\` },
 	};
 	const testFixture = createTestPorts<AppContext["ports"], AppTransactionPorts>({
-		base: appPorts,
+		base: initialPorts,
 		overrides: {
-			gate: appPorts.gate,
+			gate: initialPorts.gate,
 			todos,
 			devtools: createInMemoryDevtools(),
 		},
@@ -483,7 +483,7 @@ import { createInMemoryDevtools } from "@beignet/devtools";
 import { createTestApp, createTestRequester } from "@beignet/web/testing";
 import type { AppContext } from "@/app-context";
 import type { TodoRepository } from "@/features/todos/ports";
-import { appPorts } from "@/infra/app-ports";
+import { initialPorts } from "@/infra/port-wiring";
 import type { AppPorts, AppTransactionPorts } from "@/ports";
 import type { AuthRequest, AuthSessionMetadata, AuthUser } from "@/ports/auth";
 import { type AppServiceContextInput, appContext } from "@/server/context";
@@ -507,9 +507,9 @@ async function createTodosTestApp(
 ) {
 	const todos = options.todos ?? createTestTodoRepository();
 	const fixture = createTestPorts<AppContext["ports"], AppTransactionPorts>({
-		base: appPorts,
+		base: initialPorts,
 		overrides: {
-			gate: appPorts.gate,
+			gate: initialPorts.gate,
 			todos,
 			devtools: createInMemoryDevtools(),
 			auth: options.auth ?? createSignedOutAuth(),

package/src/test-helpers/generated-app.ts

@@ -37,6 +37,7 @@ export async function linkSmokeDependencies(
     "provider-storage-local",
     "react-hook-form",
     "react-query",
+    "react-uploads",
     "web",
   ];