@beignet/cli 0.0.33 → 0.0.35

package/src/provider-add.ts

@@ -76,9 +76,9 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
   "flags-openfeature": {
     name: "flags-openfeature",
     displayName: "OpenFeature flags",
-    importName: "openFeatureFlagsProvider",
+    importName: "createOpenFeatureFlagsProvider",
     importFrom: "@beignet/provider-flags-openfeature",
-    providerEntry: "openFeatureFlagsProvider",
+    providerEntry: "createOpenFeatureFlagsProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-flags-openfeature":
         beignetDependencyVersion(packageJson),
@@ -97,7 +97,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-flags-openfeature`",
       "- Peer dependency: `@openfeature/server-sdk`",
-      "- The preset wires `openFeatureFlagsProvider` in `server/providers.ts` and defers `flags` in `infra/app-ports.ts`.",
+      "- The preset wires `createOpenFeatureFlagsProvider()` in `server/providers.ts` and defers `flags` in `infra/app-ports.ts`.",
       "- Configure the OpenFeature provider globally or replace this preset with `createOpenFeatureFlagsProvider(...)` when the app needs provider-specific setup.",
       "- Use `ctx.ports.flags` in app code; `ctx.ports.openFeature` is available as an escape hatch.",
       "",
@@ -111,9 +111,9 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
   "jobs-bullmq": {
     name: "jobs-bullmq",
     displayName: "BullMQ jobs",
-    importName: "bullMQJobsProvider",
+    importName: "createBullMQJobsProvider",
     importFrom: "@beignet/provider-jobs-bullmq",
-    providerEntry: "bullMQJobsProvider",
+    providerEntry: "createBullMQJobsProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-jobs-bullmq": beignetDependencyVersion(packageJson),
       bullmq: externalVersions.bullmq,
@@ -138,7 +138,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-jobs-bullmq`",
       "- Peer dependency: `bullmq`",
-      "- The preset wires `bullMQJobsProvider` in `server/providers.ts` and defers `jobs` in `infra/app-ports.ts`.",
+      "- The preset wires `createBullMQJobsProvider()` in `server/providers.ts` and defers `jobs` in `infra/app-ports.ts`.",
       "- Set `BULLMQ_REDIS_URL` before booting the app; the default points at local Redis.",
       "- Dispatching enqueues jobs, but nothing executes them until a worker entrypoint runs `createBullMQJobWorker(...)` in a worker process. See the jobs docs page.",
       "- Use `ctx.ports.jobs.dispatch(...)` in app code; `ctx.ports.bullMQJobs` is available as an escape hatch.",
@@ -150,18 +150,14 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "Add a worker entrypoint that runs createBullMQJobWorker(...) in a worker process; dispatched jobs do not execute without one. See the jobs docs page.",
       "Run beignet providers audit and beignet doctor --strict.",
     ],
-    conflictingProviderEntries: [
-      "inngestJobsProvider",
-      "createInngestJobsProvider",
-      "createBullMQJobsProvider",
-    ],
+    conflictingProviderEntries: ["createInngestJobsProvider"],
   },
   "jobs-inngest": {
     name: "jobs-inngest",
     displayName: "Inngest jobs",
-    importName: "inngestJobsProvider",
+    importName: "createInngestJobsProvider",
     importFrom: "@beignet/provider-jobs-inngest",
-    providerEntry: "inngestJobsProvider",
+    providerEntry: "createInngestJobsProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-jobs-inngest": beignetDependencyVersion(packageJson),
       inngest: externalVersions.inngest,
@@ -184,7 +180,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-jobs-inngest`",
       "- Peer dependency: `inngest`",
-      "- The preset wires `inngestJobsProvider` in `server/providers.ts` and defers `jobs` in `infra/app-ports.ts`.",
+      "- The preset wires `createInngestJobsProvider()` in `server/providers.ts` and defers `jobs` in `infra/app-ports.ts`.",
       "- Define jobs with `defineJob(...)` and dispatch them through `ctx.ports.jobs.dispatch(...)`.",
       "- Execution needs an Inngest serve route built from `createInngestJobFunction(...)` and `serve(...)`. See the jobs docs page.",
       "- Use `ctx.ports.inngest` only as an escape hatch for Inngest-specific workflow APIs; prefer `ctx.ports.jobs.dispatch(...)` for Beignet jobs.",
@@ -196,17 +192,14 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "Expose an Inngest serve route with createInngestJobFunction(...) so dispatched jobs execute. See the jobs docs page.",
       "Run beignet providers audit and beignet doctor --strict.",
     ],
-    conflictingProviderEntries: [
-      "bullMQJobsProvider",
-      "createBullMQJobsProvider",
-    ],
+    conflictingProviderEntries: ["createBullMQJobsProvider"],
   },
   "mail-resend": {
     name: "mail-resend",
     displayName: "Resend mail",
-    importName: "resendMailProvider",
+    importName: "createResendMailProvider",
     importFrom: "@beignet/provider-mail-resend",
-    providerEntry: "resendMailProvider",
+    providerEntry: "createResendMailProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-mail-resend": beignetDependencyVersion(packageJson),
       resend: externalVersions.resend,
@@ -229,7 +222,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-mail-resend`",
       "- Peer dependency: `resend`",
-      "- The preset wires `resendMailProvider` in `server/providers.ts` and defers `mailer` in `infra/app-ports.ts`.",
+      "- The preset wires `createResendMailProvider()` in `server/providers.ts` and defers `mailer` in `infra/app-ports.ts`.",
       "- `.env.example` ships dev placeholders so the app boots; set real `RESEND_API_KEY` and `RESEND_FROM` values before sending mail.",
       "- Use `ctx.ports.mailer` in app code; `ctx.ports.resend` is available as an escape hatch.",
       "",
@@ -240,16 +233,16 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "Run beignet providers audit and beignet doctor --strict.",
     ],
     conflictingProviderEntries: [
-      "smtpMailProvider",
+      "createSmtpMailProvider",
       "createMemoryMailerProvider",
     ],
   },
   "mail-smtp": {
     name: "mail-smtp",
     displayName: "SMTP mail",
-    importName: "smtpMailProvider",
+    importName: "createSmtpMailProvider",
     importFrom: "@beignet/provider-mail-smtp",
-    providerEntry: "smtpMailProvider",
+    providerEntry: "createSmtpMailProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-mail-smtp": beignetDependencyVersion(packageJson),
       nodemailer: externalVersions.nodemailer,
@@ -275,7 +268,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-mail-smtp`",
       "- Peer dependency: `nodemailer`",
-      "- The preset wires `smtpMailProvider` in `server/providers.ts` and defers `mailer` in `infra/app-ports.ts`.",
+      "- The preset wires `createSmtpMailProvider()` in `server/providers.ts` and defers `mailer` in `infra/app-ports.ts`.",
       "- `.env.example` ships dev placeholders so the app boots; set real `MAIL_*` values before sending mail.",
       "- Use `ctx.ports.mailer` in app code; `ctx.ports.smtp` is available as an escape hatch.",
       "",
@@ -286,16 +279,16 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "Run beignet providers audit and beignet doctor --strict.",
     ],
     conflictingProviderEntries: [
-      "resendMailProvider",
+      "createResendMailProvider",
       "createMemoryMailerProvider",
     ],
   },
   "payments-stripe": {
     name: "payments-stripe",
     displayName: "Stripe payments",
-    importName: "stripePaymentsProvider",
+    importName: "createStripePaymentsProvider",
     importFrom: "@beignet/provider-payments-stripe",
-    providerEntry: "stripePaymentsProvider",
+    providerEntry: "createStripePaymentsProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-payments-stripe":
         beignetDependencyVersion(packageJson),
@@ -324,7 +317,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-payments-stripe`",
       "- Peer dependency: `stripe`",
-      "- The preset wires `stripePaymentsProvider` in `server/providers.ts` and defers `payments` in `infra/app-ports.ts`.",
+      "- The preset wires `createStripePaymentsProvider()` in `server/providers.ts` and defers `payments` in `infra/app-ports.ts`.",
       "- `.env.example` ships dev placeholders so the app boots; set real `STRIPE_SECRET_KEY` and `STRIPE_WEBHOOK_SECRET` values before taking payments.",
       "- Stripe requires a webhook route: run `beignet make payments` for the full billing slice, including a `createPaymentWebhookRoute(...)` route.",
       "- Use `ctx.ports.payments` in app code; `ctx.ports.stripe` is available as an escape hatch.",
@@ -336,17 +329,14 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "Run beignet make payments for the full billing slice; Stripe needs its webhook route before subscription state can sync.",
       "Run beignet providers audit and beignet doctor --strict.",
     ],
-    conflictingProviderEntries: [
-      "createMemoryPaymentsProvider",
-      "createStripePaymentsProvider",
-    ],
+    conflictingProviderEntries: ["createMemoryPaymentsProvider"],
   },
   "search-meilisearch": {
     name: "search-meilisearch",
     displayName: "Meilisearch search",
-    importName: "meilisearchSearchProvider",
+    importName: "createMeilisearchSearchProvider",
     importFrom: "@beignet/provider-search-meilisearch",
-    providerEntry: "meilisearchSearchProvider",
+    providerEntry: "createMeilisearchSearchProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-search-meilisearch":
         beignetDependencyVersion(packageJson),
@@ -370,7 +360,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "## Meilisearch search",
       "",
       "- Package: `@beignet/provider-search-meilisearch`",
-      "- The preset wires `meilisearchSearchProvider` in `server/providers.ts` and defers `search` in `infra/app-ports.ts`.",
+      "- The preset wires `createMeilisearchSearchProvider()` in `server/providers.ts` and defers `search` in `infra/app-ports.ts`.",
       "- Set `MEILISEARCH_HOST` before booting the app; set `MEILISEARCH_API_KEY` when your Meilisearch server requires one.",
       "- Use `ctx.ports.search` in app code; `ctx.ports.meilisearch` is available as an escape hatch.",
       "",
@@ -384,9 +374,9 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
   sentry: {
     name: "sentry",
     displayName: "Sentry error reporting",
-    importName: "sentryErrorReportingProvider",
+    importName: "createSentryErrorReportingProvider",
     importFrom: "@beignet/provider-error-reporting-sentry",
-    providerEntry: "sentryErrorReportingProvider",
+    providerEntry: "createSentryErrorReportingProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-error-reporting-sentry":
         beignetDependencyVersion(packageJson),
@@ -405,7 +395,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-error-reporting-sentry`",
       "- Peer dependency: `@sentry/node`",
-      "- The preset wires `sentryErrorReportingProvider` in `server/providers.ts`.",
+      "- The preset wires `createSentryErrorReportingProvider()` in `server/providers.ts`.",
       "- Set `SENTRY_DSN` before deploying when captures should be sent to Sentry.",
       "- Use `ctx.ports.errorReporter` in app code; `ctx.ports.sentry` is available as an escape hatch.",
       "",
@@ -419,9 +409,9 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
   "redis-cache": {
     name: "redis-cache",
     displayName: "Redis cache",
-    importName: "redisCacheProvider",
+    importName: "createRedisCacheProvider",
     importFrom: "@beignet/provider-cache-redis",
-    providerEntry: "redisCacheProvider",
+    providerEntry: "createRedisCacheProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-cache-redis": beignetDependencyVersion(packageJson),
       ioredis: externalVersions.ioredis,
@@ -444,7 +434,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-cache-redis`",
       "- Peer dependency: `ioredis`",
-      "- The preset wires `redisCacheProvider` in `server/providers.ts` and defers `cache` in `infra/app-ports.ts`.",
+      "- The preset wires `createRedisCacheProvider()` in `server/providers.ts` and defers `cache` in `infra/app-ports.ts`.",
       "- Set `REDIS_URL` before booting the app.",
       "- Use `ctx.ports.cache` in app code; `ctx.ports.redis` is available as an escape hatch.",
       "",
@@ -458,9 +448,9 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
   "event-bus-redis": {
     name: "event-bus-redis",
     displayName: "Redis event bus",
-    importName: "redisEventBusProvider",
+    importName: "createRedisEventBusProvider",
     importFrom: "@beignet/provider-event-bus-redis",
-    providerEntry: "redisEventBusProvider",
+    providerEntry: "createRedisEventBusProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-event-bus-redis":
         beignetDependencyVersion(packageJson),
@@ -485,7 +475,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-event-bus-redis`",
       "- Peer dependency: `ioredis`",
-      "- The preset wires `redisEventBusProvider` in `server/providers.ts` and defers `eventBus` in `infra/app-ports.ts`.",
+      "- The preset wires `createRedisEventBusProvider()` in `server/providers.ts` and defers `eventBus` in `infra/app-ports.ts`.",
       "- Set `REDIS_EVENT_BUS_URL` before booting the app.",
       "- Redis Pub/Sub delivery is best-effort and cross-process, but not durable: use outbox/jobs for side effects that need retry, replay, or dead-letter handling.",
       "- Use `ctx.ports.eventBus` in app code; `ctx.ports.redisEventBus` is available as an escape hatch.",
@@ -497,17 +487,14 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "Keep durable side effects on the outbox/jobs path; Redis Pub/Sub does not replay missed events.",
       "Run beignet providers audit and beignet doctor --strict.",
     ],
-    conflictingProviderEntries: [
-      "createInMemoryEventBusProvider",
-      "createRedisEventBusProvider",
-    ],
+    conflictingProviderEntries: ["createMemoryEventBusProvider"],
   },
   "redis-locks": {
     name: "redis-locks",
     displayName: "Redis locks",
-    importName: "redisLocksProvider",
+    importName: "createRedisLocksProvider",
     importFrom: "@beignet/provider-locks-redis",
-    providerEntry: "redisLocksProvider",
+    providerEntry: "createRedisLocksProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-locks-redis": beignetDependencyVersion(packageJson),
       ioredis: externalVersions.ioredis,
@@ -531,7 +518,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-locks-redis`",
       "- Peer dependency: `ioredis`",
-      "- The preset wires `redisLocksProvider` in `server/providers.ts` and defers `locks` in `infra/app-ports.ts`.",
+      "- The preset wires `createRedisLocksProvider()` in `server/providers.ts` and defers `locks` in `infra/app-ports.ts`.",
       "- Set `REDIS_LOCKS_URL` before booting the app.",
       "- Use `ctx.ports.locks` in app code; `ctx.ports.redisLocks` is available as an escape hatch.",
       "",
@@ -545,9 +532,9 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
   "s3-storage": {
     name: "s3-storage",
     displayName: "S3-compatible storage",
-    importName: "s3StorageProvider",
+    importName: "createS3StorageProvider",
     importFrom: "@beignet/provider-storage-s3",
-    providerEntry: "s3StorageProvider",
+    providerEntry: "createS3StorageProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-storage-s3": beignetDependencyVersion(packageJson),
       "@aws-sdk/client-s3": externalVersions.awsSdkS3,
@@ -592,7 +579,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-storage-s3`",
       "- Peer dependencies: `@aws-sdk/client-s3` and `@aws-sdk/s3-request-presigner`",
-      "- The preset wires `s3StorageProvider` in `server/providers.ts` and defers `storage` in `infra/app-ports.ts`.",
+      "- The preset wires `createS3StorageProvider()` in `server/providers.ts` and defers `storage` in `infra/app-ports.ts`.",
       "- Set `STORAGE_S3_BUCKET` before booting the app; set endpoint and credentials when using an S3-compatible host outside AWS defaults.",
       "- Use `ctx.ports.storage` in app code; `ctx.ports.s3Storage` is available as an escape hatch.",
       "",
@@ -603,18 +590,16 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "Run beignet providers audit and beignet doctor --strict.",
     ],
     conflictingProviderEntries: [
-      "localStorageProvider",
       "createLocalStorageProvider",
-      "vercelBlobStorageProvider",
       "createVercelBlobStorageProvider",
     ],
   },
   "vercel-blob-storage": {
     name: "vercel-blob-storage",
     displayName: "Vercel Blob storage",
-    importName: "vercelBlobStorageProvider",
+    importName: "createVercelBlobStorageProvider",
     importFrom: "@beignet/provider-storage-vercel-blob",
-    providerEntry: "vercelBlobStorageProvider",
+    providerEntry: "createVercelBlobStorageProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-storage-vercel-blob":
         beignetDependencyVersion(packageJson),
@@ -640,7 +625,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-storage-vercel-blob`",
       "- Peer dependency: `@vercel/blob`",
-      "- The preset wires `vercelBlobStorageProvider` in `server/providers.ts` and defers `storage` in `infra/app-ports.ts`.",
+      "- The preset wires `createVercelBlobStorageProvider()` in `server/providers.ts` and defers `storage` in `infra/app-ports.ts`.",
       "- On Vercel, connect a Blob store to the project and `BLOB_READ_WRITE_TOKEN` is set automatically; set it manually elsewhere.",
       "- The store is uniform-visibility (`BLOB_ACCESS`, default `private`): Vercel Blob does not report per-object access back, so mixed visibility needs a second store.",
       "- Use `ctx.ports.storage` in app code; `ctx.ports.vercelBlob` is available as an escape hatch.",
@@ -652,18 +637,16 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "Run beignet providers audit and beignet doctor --strict.",
     ],
     conflictingProviderEntries: [
-      "localStorageProvider",
       "createLocalStorageProvider",
-      "s3StorageProvider",
       "createS3StorageProvider",
     ],
   },
   "upstash-rate-limit": {
     name: "upstash-rate-limit",
     displayName: "Upstash rate limit",
-    importName: "upstashRateLimitProvider",
+    importName: "createUpstashRateLimitProvider",
     importFrom: "@beignet/provider-rate-limit-upstash",
-    providerEntry: "upstashRateLimitProvider",
+    providerEntry: "createUpstashRateLimitProvider()",
     dependencies: (packageJson) => ({
       "@beignet/provider-rate-limit-upstash":
         beignetDependencyVersion(packageJson),
@@ -690,7 +673,7 @@ const presets: Record<ProviderPresetName, ProviderPreset> = {
       "",
       "- Package: `@beignet/provider-rate-limit-upstash`",
       "- Peer dependencies: `@upstash/ratelimit` and `@upstash/redis`",
-      "- The preset wires `upstashRateLimitProvider` in `server/providers.ts` and defers `rateLimit` in `infra/app-ports.ts`.",
+      "- The preset wires `createUpstashRateLimitProvider()` in `server/providers.ts` and defers `rateLimit` in `infra/app-ports.ts`.",
       "- `.env.example` ships dev placeholders so the app boots; set real `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN` values before rate limiting requests.",
       "- Use `ctx.ports.rateLimit` in app code; `ctx.ports.upstash` is available as an escape hatch.",
       "",
@@ -710,9 +693,9 @@ const providerPresetSet = new Set<string>(providerPresetChoices);
  * integration, used to pre-validate preset selections at create time.
  */
 const integrationProviderEntries: Record<IntegrationName, string> = {
-  inngest: "inngestJobsProvider",
-  resend: "resendMailProvider",
-  "upstash-rate-limit": "upstashRateLimitProvider",
+  inngest: "createInngestJobsProvider",
+  resend: "createResendMailProvider",
+  "upstash-rate-limit": "createUpstashRateLimitProvider",
 };
 
 /**
@@ -735,7 +718,7 @@ export function assertCompatibleCreatePresets(
     selectedEntries.set(integrationProviderEntries[integration], integration);
   }
   for (const name of presetNames) {
-    selectedEntries.set(presets[name].providerEntry, name);
+    selectedEntries.set(presets[name].importName, name);
   }
 
   for (const name of presetNames) {

package/src/registry-edits.ts

@@ -300,7 +300,8 @@ export function appendToOutboxRegistryArray(
 }
 
 function entryIdentifier(entry: string): string {
-  return entry.replace(/^\.{3}/, "").trim();
+  const normalized = entry.replace(/^\.{3}/, "").trim();
+  return /^[A-Za-z_$][\w$]*/.exec(normalized)?.[0] ?? normalized;
 }
 
 function appendEntry(

package/src/schedule.ts

@@ -1,8 +1,8 @@
 import { readFile, stat } from "node:fs/promises";
 import path from "node:path";
+import type { ProviderInstrumentationPort } from "@beignet/core/providers";
 import type {
   ScheduleDef,
-  ScheduleInstrumentation,
   ScheduleRunOptions,
   StandardSchema,
 } from "@beignet/core/schedules";
@@ -54,7 +54,8 @@ type ScheduleContext = {
   traceId?: string;
   ports?: {
     logger?: ScheduleLogger;
-    devtools?: ScheduleInstrumentation;
+    devtools?: ProviderInstrumentationPort;
+    instrumentation?: ProviderInstrumentationPort;
   };
 };
 
@@ -107,7 +108,7 @@ export async function runAppSchedule(
     );
     const runner = createInlineScheduleRunner<unknown>({
       ctx,
-      instrumentation: scheduleContext.ports?.devtools,
+      instrumentation: scheduleContext.ports,
       instrumentationContext: {
         requestId: scheduleContext.requestId,
         traceId: scheduleContext.traceId,

package/src/templates/agents.ts

@@ -48,6 +48,8 @@ is a silent failure — the file exists but never runs:
 
 - Feature route groups in \`features/<feature>/routes.ts\` must be composed in
   \`server/routes.ts\` via \`defineRoutes([...])\`.
+- Feature route files import the app-bound \`defineRouteGroup\` from
+  \`lib/routes.ts\`; that builder owns the shared \`AppContext\` binding.
 - Schedules must be added to the \`schedules\` array in \`server/schedules.ts\`.
 - Tasks must be added to \`defineTasks([...])\` in \`server/tasks.ts\`.
 - Outbox events and jobs must be registered in \`defineOutboxRegistry({...})\`

package/src/templates/base.ts

@@ -390,7 +390,7 @@ export function integrationsDoc(ctx: TemplateContext): string {
         "- Package: `@beignet/core` (`@beignet/core/events`, `@beignet/core/jobs`)",
         "- Package: `@beignet/provider-jobs-inngest`",
         "- Peer dependency: `inngest`",
-        "- The starter wires `inngestJobsProvider` in `server/providers.ts`.",
+        "- The starter wires `createInngestJobsProvider()` in `server/providers.ts`.",
         "- Define jobs with `defineJob(...)` and dispatch them through `ctx.ports.jobs.dispatch(...)`.",
         "- Use `ctx.ports.inngest` only as an escape hatch for Inngest-specific workflow APIs; prefer `ctx.ports.jobs.dispatch(...)` for Beignet jobs.",
         "",
@@ -403,7 +403,7 @@ export function integrationsDoc(ctx: TemplateContext): string {
         "",
         "- Package: `@beignet/provider-mail-resend`",
         "- Peer dependency: `resend`",
-        "- The starter wires `resendMailProvider` in `server/providers.ts`.",
+        "- The starter wires `createResendMailProvider()` in `server/providers.ts`.",
         "- `.env.example` ships dev placeholders so the app boots; set real `RESEND_API_KEY` and `RESEND_FROM` values before sending mail.",
         "",
       );
@@ -415,7 +415,7 @@ export function integrationsDoc(ctx: TemplateContext): string {
         "",
         "- Package: `@beignet/provider-rate-limit-upstash`",
         "- Peer dependencies: `@upstash/ratelimit` and `@upstash/redis`",
-        "- The starter wires `upstashRateLimitProvider` in `server/providers.ts` and adds `rateLimit: RateLimitPort` to `AppPorts`.",
+        "- The starter wires `createUpstashRateLimitProvider()` in `server/providers.ts` and adds `rateLimit: RateLimitPort` to `AppPorts`.",
         "- `.env.example` ships dev placeholders so the app boots; set real `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN` values before rate limiting requests.",
         "",
       );

package/src/templates/index.ts

@@ -136,6 +136,7 @@ export function getTemplateFiles(ctx: TemplateContext): TemplateFile[] {
     { path: "lib/tenant.ts", content: serverFiles.tenantHelper },
     ...testSupportTemplateFiles,
     { path: "lib/use-case.ts", content: serverFiles.useCaseBuilder },
+    { path: "lib/routes.ts", content: serverFiles.routesBuilder },
     { path: "server/index.ts", content: server(ctx) },
     { path: "server/context.ts", content: serverFiles.serverContext },
     { path: "server/routes.ts", content: serverFiles.serverRoutes },

package/src/templates/server.ts

@@ -10,17 +10,17 @@ export function serverProviders(ctx: TemplateContext): string {
   const imports = [
     'import "@beignet/core/server-only";',
     'import { createDevtoolsProvider } from "@beignet/devtools";',
-    'import { createAuthBetterAuthProvider } from "@beignet/provider-auth-better-auth";',
+    'import { createBetterAuthProvider } from "@beignet/provider-auth-better-auth";',
     `import { ${db.providerFactory} } from "@beignet/provider-db-drizzle/${db.subpath}";`,
     hasIntegration(ctx, "inngest")
-      ? 'import { inngestJobsProvider } from "@beignet/provider-jobs-inngest";'
+      ? 'import { createInngestJobsProvider } from "@beignet/provider-jobs-inngest";'
       : undefined,
-    'import { pinoLoggerProvider } from "@beignet/provider-logger-pino";',
+    'import { createPinoLoggerProvider } from "@beignet/provider-logger-pino";',
     hasIntegration(ctx, "resend")
-      ? 'import { resendMailProvider } from "@beignet/provider-mail-resend";'
+      ? 'import { createResendMailProvider } from "@beignet/provider-mail-resend";'
       : undefined,
     hasIntegration(ctx, "upstash-rate-limit")
-      ? 'import { upstashRateLimitProvider } from "@beignet/provider-rate-limit-upstash";'
+      ? 'import { createUpstashRateLimitProvider } from "@beignet/provider-rate-limit-upstash";'
       : undefined,
     'import * as schema from "@/infra/db/schema";',
     'import { starterDatabaseProvider } from "@/infra/db/provider";',
@@ -30,14 +30,16 @@ export function serverProviders(ctx: TemplateContext): string {
 
   const entries = [
     "\tcreateDevtoolsProvider(),",
-    "\tcreateAuthBetterAuthProvider<AuthUser, AuthSessionMetadata>(auth),",
-    "\tpinoLoggerProvider,",
+    "\tcreateBetterAuthProvider<AuthUser, AuthSessionMetadata>(auth),",
+    "\tcreatePinoLoggerProvider(),",
     `\t${db.providerInstance},`,
     "\tstarterDatabaseProvider,",
-    hasIntegration(ctx, "inngest") ? "\tinngestJobsProvider," : undefined,
-    hasIntegration(ctx, "resend") ? "\tresendMailProvider," : undefined,
+    hasIntegration(ctx, "inngest")
+      ? "\tcreateInngestJobsProvider(),"
+      : undefined,
+    hasIntegration(ctx, "resend") ? "\tcreateResendMailProvider()," : undefined,
     hasIntegration(ctx, "upstash-rate-limit")
-      ? "\tupstashRateLimitProvider,"
+      ? "\tcreateUpstashRateLimitProvider(),"
       : undefined,
   ].filter((entry): entry is string => Boolean(entry));
 
@@ -394,6 +396,12 @@ import { createUseCase } from "@beignet/core/application";
 import type { AppContext } from "@/app-context";
 
 export const useCase = createUseCase<AppContext>();
+`,
+  routesBuilder: `import "@beignet/core/server-only";
+import { createRoutes } from "@beignet/core/server";
+import type { AppContext } from "@/app-context";
+
+export const { defineRoute, defineRouteGroup } = createRoutes<AppContext>();
 `,
   authHelpers: `import type { AppContext } from "@/app-context";
 import type { AuthSession, AuthUser } from "@/ports/auth";
@@ -445,7 +453,7 @@ export type AuthPort = BeignetAuthPort<
 >;
 `,
   serverRoutes: `import "@beignet/core/server-only";
-import { contractsFromRoutes, defineRoutes } from "@beignet/next";
+import { contractsFromRoutes, defineRoutes } from "@beignet/core/server";
 import type { AppContext } from "@/app-context";
 import { todoRoutes } from "@/features/todos/routes";
 

package/src/templates/testing.ts

@@ -406,6 +406,7 @@ export const testRunnerTemplateFile: TemplateFile = {
   content: `import { spawnSync } from "node:child_process";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import path from "node:path";
+import { pathToFileURL } from "node:url";
 
 const defaultTestRoots = [
   "app",
@@ -428,11 +429,18 @@ const ignoredDirectories = new Set([
 ]);
 const testFilePattern = /\\.(test|spec)\\.[cm]?[tj]sx?$/;
 
+const configFileNames = [
+  "beignet.config.ts",
+  "beignet.config.json",
+  "beignet.config.mjs",
+  "beignet.config.js",
+];
+
 const explicitArgs = process.argv.slice(2);
 const testArgs =
   explicitArgs.length > 0
     ? resolveTestArgs(process.cwd(), explicitArgs)
-    : discoverTestFiles(process.cwd());
+    : await discoverTestFiles(process.cwd());
 
 if (testArgs.length === 0) {
   console.log("No test files found.");
@@ -456,9 +464,9 @@ if (result.error) {
 
 process.exit(result.status ?? 1);
 
-function discoverTestFiles(cwd: string): string[] {
+async function discoverTestFiles(cwd: string): Promise<string[]> {
   const files: string[] = [];
-  for (const root of testRoots(cwd)) {
+  for (const root of await testRoots(cwd)) {
     const rootPath = path.join(cwd, root);
     if (existsSync(rootPath)) {
       walk(rootPath, cwd, files);
@@ -494,32 +502,53 @@ function resolveTestArgs(cwd: string, args: string[]): string[] {
   return Array.from(new Set(resolved));
 }
 
-function testRoots(cwd: string): string[] {
-  return Array.from(new Set([...defaultTestRoots, ...configuredRoots(cwd)]));
+async function testRoots(cwd: string): Promise<string[]> {
+  return Array.from(
+    new Set([...defaultTestRoots, ...(await configuredRoots(cwd))]),
+  );
 }
 
-function configuredRoots(cwd: string): string[] {
-  const configPath = path.join(cwd, "beignet.config.json");
-  if (!existsSync(configPath)) return [];
-  try {
-    const config = JSON.parse(readFileSync(configPath, "utf8")) as {
-      paths?: Record<string, string>;
-    };
-    const paths = config.paths ?? {};
-    return [
-      paths.tests,
-      paths.features,
-      paths.routes ? path.dirname(paths.routes) : undefined,
-      paths.server ? path.dirname(paths.server) : undefined,
-      paths.infrastructurePorts
-        ? path.dirname(paths.infrastructurePorts)
-        : undefined,
-      paths.ports ? path.dirname(paths.ports) : undefined,
-      paths.useCaseBuilder ? path.dirname(paths.useCaseBuilder) : undefined,
-    ].filter((root): root is string => Boolean(root) && root !== ".");
-  } catch {
-    return [];
+async function configuredRoots(cwd: string): Promise<string[]> {
+  const configFiles = configFileNames.filter((file) =>
+    existsSync(path.join(cwd, file)),
+  );
+  if (configFiles.length === 0) return [];
+  if (configFiles.length > 1) {
+    throw new Error(
+      "Multiple Beignet config files found: " +
+        configFiles.join(", ") +
+        ". Keep only one config file.",
+    );
   }
+
+  const configFile = configFiles[0];
+  const configPath = path.join(cwd, configFile);
+  const config = configFile.endsWith(".json")
+    ? JSON.parse(readFileSync(configPath, "utf8"))
+    : ((await import(pathToFileURL(configPath).href)) as { default?: unknown })
+        .default;
+  if (!isObjectRecord(config)) {
+    throw new Error(configFile + " must export a Beignet config object.");
+  }
+  const paths = isObjectRecord(config.paths) ? config.paths : {};
+  return [
+    paths.tests,
+    paths.features,
+    parentPath(paths.routes),
+    parentPath(paths.server),
+    parentPath(paths.infrastructurePorts),
+    parentPath(paths.ports),
+    parentPath(paths.useCaseBuilder),
+    parentPath(paths.routesBuilder),
+  ].filter((root): root is string => Boolean(root) && root !== ".");
+}
+
+function parentPath(value: unknown): string | undefined {
+  return typeof value === "string" ? path.dirname(value) : undefined;
+}
+
+function isObjectRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 
 function walk(directory: string, cwd: string, files: string[]): void {