create-m5kdev 0.25.2 → 0.26.1

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

@@ -1,21 +1,14 @@
-import { spawnSync } from "node:child_process";
-import { generateSchema } from "./generate-schema";
-
-export async function syncDatabase(): Promise<void> {
-  await generateSchema();
-
-  const command = process.platform === "win32" ? "drizzle-kit.cmd" : "drizzle-kit";
-  const result = spawnSync(command, ["push", "--config", "drizzle.config.ts", "--force"], {
-    cwd: process.cwd(),
-    env: process.env,
-    stdio: "inherit",
-  });
-
-  if (result.status !== 0) {
-    throw new Error(`drizzle-kit push failed with exit code ${result.status ?? "unknown"}`);
-  }
-}
-
-syncDatabase().then(() => {
-  console.info("Sync completed");
-});
+import { isRemote, orm } from "./db";
+
+async function sync() {
+  if (isRemote) {
+    await orm.$client.sync();
+  } else {
+    console.info("Local database no sync required");
+  }
+}
+
+sync().then(() => {
+  console.info("Sync completed");
+  process.exit(0);
+});

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

@@ -1,35 +1,33 @@
-import * as dotenv from "dotenv";
-import { defineConfig } from "drizzle-kit";
-
-dotenv.config({ path: "../shared/.env" });
-
-const url = process.env.TURSO_DATABASE_URL || process.env.DATABASE_URL;
-const authToken = process.env.TURSO_AUTH_TOKEN;
-const schema = "./src/generated/schema.ts";
-
-if (!url) {
-  throw new Error("DATABASE_URL or TURSO_DATABASE_URL must be set");
-}
-
-const isRemote = Boolean(process.env.TURSO_DATABASE_URL && authToken);
-
-export default defineConfig(
-  isRemote
-    ? {
-        dialect: "turso",
-        schema,
-        out: "./drizzle",
-        dbCredentials: {
-          url,
-          authToken,
-        },
-      }
-    : {
-        dialect: "sqlite",
-        schema,
-        out: "./drizzle",
-        dbCredentials: {
-          url,
-        },
-      }
-);
+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,
+        },
+      }
+);

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

@@ -1,52 +1,56 @@
-{
-  "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",
-    "generate:schema": "tsx --env-file=../shared/.env drizzle/generate-schema.ts",
-    "sync": "tsx --env-file=../shared/.env drizzle/sync.ts",
-    "seed": "tsx --env-file=../shared/.env drizzle/seed.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:",
-    "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 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"
+  }
+}

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

@@ -1,126 +1,142 @@
-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 { NotificationModule } from "@m5kdev/backend/modules/notification/notification.module";
-import { WorkflowModule } from "@m5kdev/backend/modules/workflow/workflow.module";
-import { templates } from "{{PACKAGE_SCOPE}}/email";
-import { emailResources } from "{{PACKAGE_SCOPE}}/email/resources";
-import { APP_NAME } from "{{PACKAGE_SCOPE}}/shared/modules/app/app.constants";
-import { AUTH_LOCALE_CONFIG } from "{{PACKAGE_SCOPE}}/shared/modules/app/locale.constants";
-import { APP_ROLES_CONFIG } from "{{PACKAGE_SCOPE}}/shared/modules/app/roles.constants";
-import { USER_LOCALE_HEADER } from "@m5kdev/commons/modules/auth/auth.constants";
-import cors from "cors";
-import express from "express";
-import { schema } from "./generated/schema";
-import { PostsModule } from "./modules/posts/posts.module";
-
-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: schema as never,
-    app: {
-      name: APP_NAME,
-      urls: {
-        web: appUrl,
-        api: serverUrl,
-      },
-      locales: AUTH_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: "no-reply@local.m5kdev.test",
-      systemNotificationEmail: "ops@local.m5kdev.test",
-      outputDirectory: ".emails",
-    },
-    auth: {
-      factory({ db, services, appConfig, i18n }) {
-        return createBetterAuth({
-          orm: db.orm as never,
-          schema: db.schema as never,
-          services: {
-            email: services.email.email,
-          },
-          app: appConfig,
-          i18n,
-          config: {
-            waitlist: enableWaitlist,
-            provisionedAccountEmailDomain: "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 } },
-      },
-    }),
-    new NotificationModule(),
-    new PostsModule(),
-  ] as const
-);
-
-export const appRouter = builtBackendApp.trpc.router;
-export type AppRouter = typeof appRouter;
+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";
+import * as schema from "./schema";
+
+// m5k:test-harness:end
+
+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;

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

@@ -1,58 +1,58 @@
-import type { Server } from "node:http";
-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);
-  }
-  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 type { Server } from "node:http";
+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);
+  }
+  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);
+  }
+})();

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

@@ -1,12 +1,12 @@
-import { builtBackendApp } from "../app";
-
-const authInstance = builtBackendApp.auth?.instance;
-
-if (!authInstance) {
-  throw new Error("Auth is not configured on the backend app.");
-}
-
-export const auth = authInstance;
-
-export type Session = typeof auth.$Infer.Session;
-export type User = Session["user"];
+import { builtBackendApp } from "../app";
+
+const authInstance = builtBackendApp.auth?.instance;
+
+if (!authInstance) {
+  throw new Error("Auth is not configured on the backend app.");
+}
+
+export const auth = authInstance;
+
+export type Session = typeof auth.$Infer.Session;
+export type User = Session["user"];