create-m5kdev 0.32.8 → 0.34.0

package/templates/minimal-app/apps/server/drizzle/meta/_journal.json.tpl

@@ -15,6 +15,20 @@
       "when": 1785171166863,
       "tag": "0001_third_ink",
       "breakpoints": true
+    },
+    {
+      "idx": 2,
+      "version": "6",
+      "when": 1786951360347,
+      "tag": "0002_concerned_proudstar",
+      "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "6",
+      "when": 1787145865079,
+      "tag": "0003_silly_the_liberteens",
+      "breakpoints": true
     }
   ]
-}
+}

package/templates/minimal-app/apps/server/drizzle.config.ts.tpl

@@ -1,33 +1,3 @@
-import * as dotenv from "dotenv";
-import { defineConfig } from "drizzle-kit";
-
-dotenv.config({ path: process.env.DRIZZLE_ENV_PATH || "../shared/.env" });
-
-const url = process.env.TURSO_DATABASE_URL || process.env.DATABASE_URL;
-const authToken = process.env.TURSO_AUTH_TOKEN;
-const schema = process.env.DRIZZLE_SCHEMA_PATH || "./src/schema.ts";
-
-if (!url) {
-  throw new Error("DATABASE_URL or TURSO_DATABASE_URL must be set");
-}
-
-export default defineConfig(
-  url && authToken
-    ? {
-        dialect: "turso",
-        schema,
-        out: "./drizzle",
-        dbCredentials: {
-          url,
-          authToken,
-        },
-      }
-    : {
-        dialect: "sqlite",
-        schema,
-        out: "./drizzle",
-        dbCredentials: {
-          url,
-        },
-      }
-);
+import { defineDrizzleKitConfig } from "@m5kdev/backend/db";
+
+export default defineDrizzleKitConfig({ schema: "./src/schema.ts" });

package/templates/minimal-app/apps/server/package.json.tpl

@@ -1,56 +1,57 @@
-{
-  "name": "{{PACKAGE_SCOPE}}/server",
-  "version": "0.0.0",
-  "private": true,
-  "main": "dist/index.js",
-  "scripts": {
-    "dev": "tsx watch --env-file=../shared/.env src/index.ts",
-    "build": "tsup",
-    "start": "node dist/index.js",
-    "lint": "biome check .",
-    "lint:fix": "biome check . --write",
-    "check-types": "tsc --noEmit",
-    "drizzle:generate": "drizzle-kit generate",
-    "drizzle:migrate": "drizzle-kit migrate",
-    "drizzle:studio": "drizzle-kit studio",
-    "drizzle:sync": "tsx --env-file=../shared/.env drizzle/sync.ts",
-    "drizzle:seed": "tsx --env-file=../shared/.env drizzle/seed.ts",
-    "drizzle:reset": "tsx --env-file=../shared/.env drizzle/reset.ts"
-  },
-  "dependencies": {
-    "{{PACKAGE_SCOPE}}/email": "workspace:*",
-    "{{PACKAGE_SCOPE}}/shared": "workspace:*",
-    "@libsql/client": "catalog:",
-    "@m5kdev/backend": "catalog:",
-    "@m5kdev/commons": "catalog:",
-    "@trpc/server": "catalog:",
-    "better-auth": "catalog:",
-    "cors": "catalog:",
-    "dotenv": "catalog:",
-    "drizzle-orm": "catalog:",
-    "drizzle-zod": "catalog:",
-    "express": "catalog:",
-    "ioredis": "catalog:",
-    "neverthrow": "catalog:",
-    "react": "catalog:",
-    "react-dom": "catalog:",
-    "uuid": "catalog:",
-    "zod": "catalog:"
-  },
-  "devDependencies": {
-    "@m5kdev/config": "catalog:",
-    "@types/cors": "catalog:",
-    "@types/express": "catalog:",
-    "@types/node": "catalog:",
-    "@types/react": "catalog:",
-    "@types/react-dom": "catalog:",
-    "drizzle-kit": "catalog:",
-    "tslib": "catalog:",
-    "tsup": "catalog:",
-    "tsx": "catalog:",
-    "typescript": "catalog:"
-  },
-  "exports": {
-    "./types": "./src/types.ts"
-  }
-}
+{
+  "name": "{{PACKAGE_SCOPE}}/server",
+  "version": "0.0.0",
+  "private": true,
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "tsx watch --env-file=../shared/.env src/index.ts",
+    "build": "tsup",
+    "start": "node dist/index.js",
+    "lint": "biome check .",
+    "lint:fix": "biome check . --write",
+    "check-types": "tsc --noEmit",
+    "drizzle:generate": "drizzle-kit generate",
+    "drizzle:migrate": "drizzle-kit migrate",
+    "drizzle:studio": "drizzle-kit studio",
+    "drizzle:sync": "tsx --env-file=../shared/.env db.ts sync",
+    "drizzle:seed": "tsx --env-file=../shared/.env db.ts seed",
+    "drizzle:reset": "tsx --env-file=../shared/.env db.ts reset"
+  },
+  "dependencies": {
+    "{{PACKAGE_SCOPE}}/email": "workspace:*",
+    "{{PACKAGE_SCOPE}}/shared": "workspace:*",
+    "@libsql/client": "catalog:m5kdev",
+    "@m5kdev/backend": "catalog:m5kdev",
+    "@m5kdev/commons": "catalog:m5kdev",
+    "@mastra/core": "catalog:m5kdev",
+    "@openrouter/ai-sdk-provider": "catalog:m5kdev",
+    "@opentelemetry/api": "catalog:m5kdev",
+    "@trpc/server": "catalog:m5kdev",
+    "better-auth": "catalog:m5kdev",
+    "dotenv": "catalog:m5kdev",
+    "drizzle-orm": "catalog:m5kdev",
+    "drizzle-zod": "catalog:m5kdev",
+    "express": "catalog:m5kdev",
+    "ioredis": "catalog:m5kdev",
+    "neverthrow": "catalog:m5kdev",
+    "react": "catalog:m5kdev",
+    "react-dom": "catalog:m5kdev",
+    "uuid": "catalog:m5kdev",
+    "zod": "catalog:m5kdev"
+  },
+  "devDependencies": {
+    "@m5kdev/config": "catalog:m5kdev",
+    "@types/express": "catalog:m5kdev",
+    "@types/node": "catalog:m5kdev",
+    "@types/react": "catalog:m5kdev",
+    "@types/react-dom": "catalog:m5kdev",
+    "drizzle-kit": "catalog:m5kdev",
+    "tslib": "catalog:m5kdev",
+    "tsup": "catalog:m5kdev",
+    "tsx": "catalog:m5kdev",
+    "typescript": "catalog:m5kdev"
+  },
+  "exports": {
+    "./types": "./src/types.ts"
+  }
+}

package/templates/minimal-app/apps/server/src/app.ts.tpl

@@ -1,141 +1,149 @@
-import { createBackendApp } from "@m5kdev/backend/app";
-import { createBetterAuth } from "@m5kdev/backend/modules/auth/auth.lib";
-import { AuthModule } from "@m5kdev/backend/modules/auth/auth.module";
-import { EmailModule } from "@m5kdev/backend/modules/email/email.module";
-import { EmailPreviewModule } from "@m5kdev/backend/modules/email/email.preview.module";
-import { WorkflowModule } from "@m5kdev/backend/modules/workflow/workflow.module";
-import { USER_LOCALE_HEADER } from "@m5kdev/commons/modules/auth/auth.constants";
-import { templates } from "{{PACKAGE_SCOPE}}/email";
-import { emailResources } from "{{PACKAGE_SCOPE}}/email/resources";
-import {
-  APP_LOCALE_CONFIG,
-  APP_NAME,
-  APP_ROLES_CONFIG,
-} from "{{PACKAGE_SCOPE}}/shared/modules/app/app.constants";
-import type { inferRouterInputs, inferRouterOutputs } from "@trpc/server";
-import cors from "cors";
-import express from "express";
-import { PostsModule } from "./modules/posts/posts.module";
-// m5k:test-harness:start
-import { TestHarnessModule } from "./modules/test-harness/test-harness.module";
-// m5k:test-harness:end
-import * as schema from "./schema";
-
-const app = express();
-const appUrl = process.env.VITE_APP_URL ?? "http://localhost:5173";
-const serverUrl = process.env.VITE_SERVER_URL ?? "http://localhost:8080";
-const databaseUrl = process.env.DATABASE_URL ?? "file:./local.db";
-const syncUrl = process.env.TURSO_DATABASE_URL;
-const authToken = process.env.TURSO_AUTH_TOKEN;
-const redisUrl = process.env.REDIS_URL ?? "redis://127.0.0.1:6379";
-const resendApiKey = process.env.RESEND_API_KEY;
-const enableWaitlist = process.env.VITE_ENABLE_WAITLIST === "true";
-
-const connection =
-  syncUrl && authToken
-    ? {
-        url: databaseUrl,
-        syncUrl,
-        authToken,
-        syncInterval: 60,
-        readYourWrites: true,
-      }
-    : {
-        url: databaseUrl,
-      };
-
-app.use(express.json());
-app.use(
-  cors({
-    origin: [appUrl],
-    credentials: true,
-    methods: ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
-    allowedHeaders: [
-      "Content-Type",
-      "Authorization",
-      "Waitlist-Invitation-Code",
-      "Organization-Invitation-Code",
-      "Admin-Create-Verified-User",
-      USER_LOCALE_HEADER,
-    ],
-  })
-);
-
-export const builtBackendApp = createBackendApp(
-  {
-    db: connection,
-    express: app,
-    schema,
-    app: {
-      name: APP_NAME,
-      urls: {
-        web: appUrl,
-        api: serverUrl,
-      },
-      locales: APP_LOCALE_CONFIG,
-      roles: APP_ROLES_CONFIG,
-    },
-    i18n: {
-      resources: emailResources,
-    },
-    redis: {
-      url: redisUrl,
-      options: { maxRetriesPerRequest: null },
-    },
-    resend: resendApiKey ? { apiKey: resendApiKey } : undefined,
-    email: {
-      mode: resendApiKey ? "send" : "store",
-      from: process.env.EMAIL_FROM ?? "no-reply@local.m5kdev.test",
-      systemNotificationEmail: process.env.SYSTEM_NOTIFICATION_EMAIL ?? "ops@local.m5kdev.test",
-      outputDirectory: process.env.EMAIL_OUTPUT_DIRECTORY ?? ".emails",
-    },
-    auth: {
-      factory({ db, services, appConfig, i18n }) {
-        return createBetterAuth({
-          orm: db.orm,
-          schema: db.schema,
-          services: {
-            email: services.email.email,
-          },
-          app: appConfig,
-          i18n,
-          config: {
-            waitlist: enableWaitlist,
-            provisionedAccountEmailDomain:
-              process.env.PROVISIONED_EMAIL_DOMAIN ?? "provisioned.{{APP_SLUG}}.local",
-          },
-          options: {
-            secret: process.env.BETTER_AUTH_SECRET ?? "QJvCmK9UBuHAWbNr2vV3ROVt8XrBYV5d",
-          },
-        });
-      },
-    },
-  },
-  [
-    new EmailModule(templates as never),
-    new AuthModule(),
-    new WorkflowModule({
-      queues: {
-        fast: { concurrency: 5 },
-      },
-      defaultQueue: "fast",
-      defaults: {
-        timeout: 60_000,
-        jobOptions: { removeOnComplete: { age: 3600 } },
-      },
-      reconcile: { enabled: true },
-    }),
-    new PostsModule(),
-    new EmailPreviewModule({ allowDelete: process.env.NODE_ENV !== "production" }),
-    // m5k:test-harness:start
-    new TestHarnessModule(),
-    // m5k:test-harness:end
-  ] as const
-);
-
-export type AppRouter = typeof builtBackendApp.trpc.router;
-export type RouterInputs = inferRouterInputs<AppRouter>;
-export type RouterOutputs = inferRouterOutputs<AppRouter>;
-
-export type Orm = typeof builtBackendApp.db.orm;
-export type Schema = typeof builtBackendApp.db.schema;
+import { createBackendApp } from "@m5kdev/backend/app";
+import { shutdownTelemetry } from "@m5kdev/backend/lib/otel";
+// m5k:ai:start
+import { AIModule } from "@m5kdev/backend/modules/ai/ai.module";
+// m5k:ai:end
+import { createBetterAuth } from "@m5kdev/backend/modules/auth/auth.lib";
+import { AuthModule } from "@m5kdev/backend/modules/auth/auth.module";
+import { EmailModule } from "@m5kdev/backend/modules/email/email.module";
+import { EmailPreviewModule } from "@m5kdev/backend/modules/email/email.preview.module";
+// m5k:files:start
+import { FileModule } from "@m5kdev/backend/modules/file/file.module";
+// m5k:files:end
+// m5k:notifications:start
+import { NotificationModule } from "@m5kdev/backend/modules/notification/notification.module";
+// m5k:notifications:end
+// m5k:workflows:start
+import { WorkflowModule } from "@m5kdev/backend/modules/workflow/workflow.module";
+// m5k:workflows:end
+import { templates } from "{{PACKAGE_SCOPE}}/email";
+import { emailResources } from "{{PACKAGE_SCOPE}}/email/resources";
+import {
+  APP_LOCALE_CONFIG,
+  APP_NAME,
+  APP_ROLES_CONFIG,
+} from "{{PACKAGE_SCOPE}}/shared/modules/app/app.constants";
+// m5k:ai:start
+import { mastra, openrouter } from "./modules/conversation/conversation.mastra";
+// m5k:ai:end
+// m5k:workflows:start
+import { DemoWorkflowModule } from "./modules/demo-workflow/demo-workflow.module";
+// m5k:workflows:end
+import { PostsModule } from "./modules/posts/posts.module";
+// m5k:test-harness:start
+import { TestHarnessModule } from "./modules/test-harness/test-harness.module";
+// m5k:test-harness:end
+import * as schema from "./schema";
+
+const appUrl = process.env.VITE_APP_URL ?? "http://localhost:5173";
+const serverUrl = process.env.VITE_SERVER_URL ?? "http://localhost:8080";
+const databaseUrl = process.env.DATABASE_URL ?? "file:./local.db";
+const syncUrl = process.env.TURSO_DATABASE_URL;
+const authToken = process.env.TURSO_AUTH_TOKEN;
+// m5k:workflows:start
+const redisUrl = process.env.REDIS_URL ?? "redis://127.0.0.1:6379";
+// m5k:workflows:end
+const resendApiKey = process.env.RESEND_API_KEY;
+const enableWaitlist = process.env.VITE_ENABLE_WAITLIST === "true";
+
+const connection =
+  syncUrl && authToken
+    ? {
+        url: databaseUrl,
+        syncUrl,
+        authToken,
+        syncInterval: 60,
+        readYourWrites: true,
+      }
+    : {
+        url: databaseUrl,
+      };
+
+export const builtBackendApp = createBackendApp(
+  {
+    db: connection,
+    schema,
+    onShutdown: shutdownTelemetry,
+    app: {
+      name: APP_NAME,
+      urls: {
+        web: appUrl,
+        api: serverUrl,
+      },
+      locales: APP_LOCALE_CONFIG,
+      roles: APP_ROLES_CONFIG,
+    },
+    i18n: {
+      resources: emailResources,
+    },
+    spa: { root: "./client" },
+    // m5k:workflows:start
+    redis: {
+      url: redisUrl,
+      options: { maxRetriesPerRequest: null },
+    },
+    // m5k:workflows:end
+    resend: resendApiKey ? { apiKey: resendApiKey } : undefined,
+    email: {
+      mode: resendApiKey ? "send" : "store",
+      from: process.env.EMAIL_FROM ?? "no-reply@local.m5kdev.test",
+      systemNotificationEmail: process.env.SYSTEM_NOTIFICATION_EMAIL ?? "ops@local.m5kdev.test",
+      outputDirectory: process.env.EMAIL_OUTPUT_DIRECTORY ?? ".emails",
+    },
+    auth: {
+      factory({ db, services, appConfig, i18n }) {
+        return createBetterAuth({
+          orm: db.orm,
+          schema: db.schema,
+          services: {
+            email: services.email.email,
+          },
+          app: appConfig,
+          i18n,
+          config: {
+            waitlist: enableWaitlist,
+            provisionedAccountEmailDomain:
+              process.env.PROVISIONED_EMAIL_DOMAIN ?? "provisioned.{{APP_SLUG}}.local",
+          },
+          options: {
+            secret: process.env.BETTER_AUTH_SECRET ?? "QJvCmK9UBuHAWbNr2vV3ROVt8XrBYV5d",
+          },
+        });
+      },
+    },
+  },
+  [
+    new EmailModule(templates as never),
+    new AuthModule(),
+    // m5k:ai:start
+    new AIModule({
+      libs: { mastra, openrouter },
+    }),
+    // m5k:ai:end
+    // m5k:files:start
+    new FileModule(),
+    // m5k:files:end
+    // m5k:workflows:start
+    new WorkflowModule({
+      queues: {
+        fast: { concurrency: 5 },
+      },
+      defaultQueue: "fast",
+      defaults: {
+        timeout: 60_000,
+        jobOptions: { removeOnComplete: { age: 3600 } },
+      },
+      reconcile: { enabled: true },
+    }),
+    new DemoWorkflowModule(),
+    // m5k:workflows:end
+    // m5k:notifications:start
+    new NotificationModule(),
+    // m5k:notifications:end
+    new PostsModule(),
+    new EmailPreviewModule({ allowDelete: process.env.NODE_ENV !== "production" }),
+    // m5k:test-harness:start
+    new TestHarnessModule(),
+    // m5k:test-harness:end
+  ] as const
+);

package/templates/minimal-app/apps/server/src/index.ts.tpl

@@ -1,65 +1,12 @@
-import "./instrumentation";
-import type { Server } from "node:http";
-import { shutdownTelemetry } from "@m5kdev/backend/lib/otel";
-import { builtBackendApp } from "./app";
-
-const port = process.env.PORT ? Number.parseInt(process.env.PORT, 10) : 8080;
-
-let httpServer: Server | undefined;
-
-function logError(context: string, error: unknown): void {
-  console.error(`[server] ${context}`, error);
-}
-
-async function shutdown(): Promise<void> {
-  try {
-    await builtBackendApp.shutdown();
-  } catch (e) {
-    logError("builtBackendApp.shutdown() failed", e);
-  }
-  try {
-    await shutdownTelemetry();
-  } catch (e) {
-    logError("shutdownTelemetry() failed", e);
-  }
-  if (httpServer) {
-    await new Promise<void>((resolve) => {
-      httpServer?.close((err) => {
-        if (err) {
-          logError("HTTP server close failed", err);
-        }
-        resolve();
-      });
-    });
-  }
-  process.exit(0);
-}
-
-process.once("SIGINT", () => {
-  void shutdown();
-});
-process.once("SIGTERM", () => {
-  void shutdown();
-});
-
-async function start(): Promise<void> {
-  await builtBackendApp.start();
-  await new Promise<void>((resolve, reject) => {
-    httpServer = builtBackendApp.express.app.listen(port, () => {
-      console.info(
-        `Server running at ${process.env.VITE_SERVER_URL ?? `http://localhost:${port}`}`
-      );
-      resolve();
-    });
-    httpServer.on("error", reject);
-  });
-}
-
-void (async () => {
-  try {
-    await start();
-  } catch (e) {
-    logError("Fatal: builtBackendApp.start() or HTTP listen failed", e);
-    process.exit(1);
-  }
-})();
+import "./instrumentation";
+import { builtBackendApp } from "./app";
+
+void (async () => {
+  try {
+    await builtBackendApp.start();
+    console.info(`Server running at ${process.env.VITE_SERVER_URL}`);
+  } catch (e) {
+    console.error("[server] Fatal: builtBackendApp.start() failed", e);
+    process.exit(1);
+  }
+})();

package/templates/minimal-app/apps/server/src/modules/conversation/conversation.mastra.ts.tpl

@@ -0,0 +1,26 @@
+import { Mastra } from "@mastra/core";
+import { Agent } from "@mastra/core/agent";
+import { createOpenRouter } from "@openrouter/ai-sdk-provider";
+import { STARTER_ASSISTANT_AGENT_ID } from "{{PACKAGE_SCOPE}}/shared/modules/conversation/conversation.constants";
+
+/** Cheap OpenRouter chat model for the starter Conversation example. */
+const STARTER_CHAT_MODEL = "google/gemini-2.5-flash";
+
+export const openrouter = createOpenRouter({
+  apiKey: process.env.OPENROUTER_API_KEY ?? "",
+});
+
+const assistant = new Agent({
+  id: STARTER_ASSISTANT_AGENT_ID,
+  name: "Assistant",
+  instructions: "You are a helpful assistant for this starter app. Keep answers concise.",
+  model: openrouter.chat(STARTER_CHAT_MODEL, {
+    usage: { include: true },
+  }),
+});
+
+export const mastra = new Mastra({
+  agents: {
+    [STARTER_ASSISTANT_AGENT_ID]: assistant,
+  },
+});

package/templates/minimal-app/apps/server/src/modules/demo-workflow/demo-workflow.module.ts.tpl

@@ -0,0 +1,47 @@
+import { createBackendRouterMap } from "@m5kdev/backend/app";
+import {
+  BaseModule,
+  type ModuleServicesContext,
+  type ModuleTRPCContext,
+  type TableMap,
+} from "@m5kdev/backend/modules/base/base.module";
+import type { WorkflowModule } from "@m5kdev/backend/modules/workflow/workflow.module";
+import { DemoWorkflowService } from "./demo-workflow.service";
+import { createDemoWorkflowTRPC } from "./demo-workflow.trpc";
+
+type DemoWorkflowModuleDeps = { workflow: WorkflowModule };
+type DemoWorkflowModuleServices = {
+  demoWorkflow: DemoWorkflowService;
+};
+type DemoWorkflowModuleRouters = {
+  demoWorkflow: ReturnType<typeof createDemoWorkflowTRPC>;
+};
+
+export class DemoWorkflowModule extends BaseModule<
+  DemoWorkflowModuleDeps,
+  TableMap,
+  Record<string, never>,
+  DemoWorkflowModuleServices,
+  DemoWorkflowModuleRouters
+> {
+  readonly id = "demo-workflow";
+  override readonly dependsOn = ["workflow"] as const;
+
+  override services({
+    deps,
+  }: ModuleServicesContext<DemoWorkflowModuleDeps, Record<string, never>>) {
+    return {
+      demoWorkflow: new DemoWorkflowService({ workflow: deps.workflow.services.workflow }),
+    };
+  }
+
+  override trpc({
+    trpc,
+    services,
+  }: ModuleTRPCContext<DemoWorkflowModuleDeps, DemoWorkflowModuleServices>) {
+    return createBackendRouterMap(
+      "demoWorkflow",
+      createDemoWorkflowTRPC(trpc, services.demoWorkflow)
+    );
+  }
+}