@beignet/cli 0.0.40 → 0.0.41

package/src/templates/base.ts

@@ -268,11 +268,13 @@ ${firstOpen}
 \`\`\`bash
 # in another terminal
 ${cli} routes
+${cli} map
 ${cli} check
 \`\`\`
 
-\`routes\` shows the contracts Beignet can inspect. \`check\` runs the whole
-validation loop in one pass: \`${cli} lint\` (dependency direction),
+\`routes\` shows the contracts Beignet can inspect. \`map\` shows how features,
+use cases, workflows, ports, providers, and tests connect. \`check\` runs the
+whole validation loop in one pass: \`${cli} lint\` (dependency direction),
 \`${cli} doctor --strict\` (route, OpenAPI, and resource drift), and the
 \`lint\`, \`typecheck\`, and \`test\` package scripts. Use \`${format}\` to
 apply Biome formatting.
@@ -306,6 +308,10 @@ Use \`${cli} make feature projects --recipe full-slice\` when you want a richer
 
 ## App map
 
+Run \`${cli} map\` for the current architecture or \`${cli} map --json\` for
+the versioned graph used by coding agents. Add \`--feature todos\` to focus on
+one slice and its direct relationships.
+
 - \`features/todos/contracts.ts\` owns the HTTP contract and reuses shared feature schemas.
 - \`features/todos/schemas.ts\` owns shared DTO and validation schemas used by contracts, use cases, ports, tests, and clients.
 - \`features/todos/client/\` may own todos-specific data-fetching helpers and React Query hooks.
@@ -391,8 +397,10 @@ export function providersDoc(ctx: TemplateContext): string {
         "- Package: `@beignet/core` (`@beignet/core/events`, `@beignet/core/jobs`)",
         "- Package: `@beignet/provider-jobs-inngest`",
         "- Peer dependency: `inngest`",
-        "- The starter wires `createInngestJobsProvider()` in `server/providers.ts`.",
+        "- The starter shares one Inngest client between `createInngestJobsProvider(...)` and `app/api/inngest/route.ts`.",
         "- Define jobs with `defineJob(...)` and dispatch them through `ctx.ports.jobs.dispatch(...)`.",
+        "- `beignet make job` registers feature job collections in `server/inngest.ts`.",
+        "- Use `INNGEST_DEV=1` only locally; production needs `INNGEST_EVENT_KEY` and `INNGEST_SIGNING_KEY`.",
         "- Use `ctx.ports.inngest` only as an escape hatch for Inngest-specific workflow APIs; prefer `ctx.ports.jobs.dispatch(...)` for Beignet jobs.",
         "",
       );
@@ -471,7 +479,17 @@ export function envExample(ctx: TemplateContext): string {
   ];
 
   if (hasStarterProvider(ctx, "jobs-inngest")) {
-    lines.push("INNGEST_APP_NAME=beignet-app", "# INNGEST_EVENT_KEY=", "");
+    lines.push(
+      "# Local development connects the app to the Inngest dev server.",
+      "INNGEST_APP_NAME=beignet-app",
+      "INNGEST_DEV=1",
+      "# Production cloud dispatch and endpoint verification.",
+      "# INNGEST_EVENT_KEY=",
+      "# INNGEST_SIGNING_KEY=",
+      "# Optional signing-key rotation fallback.",
+      "# INNGEST_SIGNING_KEY_FALLBACK=",
+      "",
+    );
   }
 
   if (hasStarterProvider(ctx, "mail-resend")) {

package/src/templates/index.ts

@@ -19,6 +19,8 @@ import { dbFiles } from "./db/index.js";
 import {
   betterAuth,
   env,
+  inngestClient,
+  inngestRegistry,
   ports,
   portWiring,
   server,
@@ -26,7 +28,11 @@ import {
   serverProviders,
 } from "./server.js";
 import { shadcnTemplateFiles } from "./shadcn.js";
-import type { TemplateContext, TemplateFile } from "./shared.js";
+import {
+  hasStarterProvider,
+  type TemplateContext,
+  type TemplateFile,
+} from "./shared.js";
 import { shellTemplateFiles } from "./shell.js";
 import { testSupportTemplateFiles } from "./testing.js";
 import { todosFiles } from "./todos.js";
@@ -144,6 +150,17 @@ export function getTemplateFiles(ctx: TemplateContext): TemplateFile[] {
     { path: "server/providers.ts", content: serverProviders(ctx) },
   ];
 
+  if (hasStarterProvider(ctx, "jobs-inngest")) {
+    templateFiles.push(
+      { path: "infra/inngest.ts", content: inngestClient() },
+      { path: "server/inngest.ts", content: inngestRegistry() },
+      {
+        path: "app/api/inngest/route.ts",
+        content: serverFiles.inngestRoute,
+      },
+    );
+  }
+
   if (ctx.api) {
     templateFiles.push(
       { path: "app/layout.tsx", content: serverFiles.apiLayout },

package/src/templates/server.ts

@@ -24,6 +24,9 @@ export function serverProviders(ctx: TemplateContext): string {
       : undefined,
     'import * as schema from "@/infra/db/schema";',
     'import { databaseClient } from "@/infra/db/client";',
+    hasStarterProvider(ctx, "jobs-inngest")
+      ? 'import { inngest } from "@/infra/inngest";'
+      : undefined,
     'import { starterDatabaseProvider } from "@/infra/db/provider";',
     'import { auth } from "@/lib/better-auth";',
     'import type { AuthSessionMetadata, AuthUser } from "@/ports/auth";',
@@ -36,7 +39,7 @@ export function serverProviders(ctx: TemplateContext): string {
     `\t${db.providerInstance},`,
     "\tstarterDatabaseProvider,",
     hasStarterProvider(ctx, "jobs-inngest")
-      ? "\tcreateInngestJobsProvider(),"
+      ? "\tcreateInngestJobsProvider({ client: inngest }),"
       : undefined,
     hasStarterProvider(ctx, "mail-resend")
       ? "\tcreateResendMailProvider(),"
@@ -162,6 +165,14 @@ export function env(ctx: TemplateContext): string {
 \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),`;
 
+  const inngestEnvLines = hasStarterProvider(ctx, "jobs-inngest")
+    ? `\t\tINNGEST_APP_NAME: z.string().min(1).default("beignet-app"),
+\t\tINNGEST_DEV: z.enum(["0", "1"]).optional(),
+\t\tINNGEST_EVENT_KEY: z.string().min(1).optional(),
+\t\tINNGEST_SIGNING_KEY: z.string().min(1).optional(),
+\t\tINNGEST_SIGNING_KEY_FALLBACK: z.string().min(1).optional(),`
+    : "";
+
   return `import { createEnv } from "@beignet/core/config";
 import { z } from "zod";
 
@@ -198,6 +209,7 @@ ${databaseEnvLines}
 			.default("info"),
 		LOG_FORMAT: z.enum(["pretty", "json"]).default("json"),
 		LOG_SERVICE: z.string().default("beignet-app"),
+${inngestEnvLines}
 	},
 	runtimeEnv: process.env,
 });
@@ -209,6 +221,42 @@ export const isDevtoolsEnabled =
 `;
 }
 
+export function inngestClient(): string {
+  return `import { Inngest } from "inngest";
+import { env } from "@/lib/env";
+
+/** Shared by the Beignet jobs provider and the Inngest serve endpoint. */
+export const inngest = new Inngest({
+	id: env.INNGEST_APP_NAME,
+});
+`;
+}
+
+export function inngestRegistry(): string {
+  return `import { createServiceActor } from "@beignet/core/ports";
+import { createInngestJobFunctions } from "@beignet/provider-jobs-inngest";
+import type { AppContext } from "@/app-context";
+import { inngest } from "@/infra/inngest";
+import { getServer } from "@/server";
+
+/** Central registry updated by \`beignet make job\`. */
+export const inngestJobs = [] as const;
+
+export const inngestFunctions = createInngestJobFunctions<AppContext>({
+	client: inngest,
+	jobs: inngestJobs,
+	ctx: async () => {
+		const server = await getServer();
+		return server.createServiceContext({
+			actor: createServiceActor("beignet-inngest"),
+		});
+	},
+	instrumentation: async () => (await getServer()).ports,
+	errorReporter: async () => (await getServer()).ports.errorReporter,
+});
+`;
+}
+
 export function betterAuth(ctx: TemplateContext): string {
   const connectionByDatabase = {
     sqlite: `import { betterAuth } from "better-auth";
@@ -672,6 +720,15 @@ export function GET(request: Request): Promise<Response> {
 export function POST(request: Request): Promise<Response> {
 	return handleAuthRoute("POST", request);
 }
+`,
+  inngestRoute: `import { serve } from "inngest/next";
+import { inngest } from "@/infra/inngest";
+import { inngestFunctions } from "@/server/inngest";
+
+export const { GET, POST, PUT } = serve({
+	client: inngest,
+	functions: inngestFunctions,
+});
 `,
   // API-only scaffold frontend: a minimal layout and landing page that point
   // at the contract-backed API surface, plus a typed client without React

package/src/templates/shared.ts

@@ -48,7 +48,7 @@ export const externalVersions = {
   bullmq: "^5.0.0",
   drizzleKit: "^0.31.10",
   drizzleOrm: "^0.45.2",
-  inngest: "^3.54.0",
+  inngest: "^4.12.1",
   libsqlClient: "^0.14.0",
   vercelBlob: "^2.5.0",
   mysql2: "^3.12.0",