create-m5kdev 0.25.2 → 0.26.1

package/templates/minimal-app/apps/server/AGENTS.md.tpl

@@ -1,39 +1,39 @@
-# Server Module Structure Guide
-
-Use this for modules in `apps/server/src/modules/**`.
-
-## Preferred Module Layout
-
-Shared contracts:
-
-```
-apps/shared/src/modules/<module>/
-├── <module>.constants.ts
-└── <module>.schema.ts
-```
-
-Server module:
-
-```
-apps/server/src/modules/<module>/
-├── <module>.db.ts
-├── <module>.repository.ts
-├── <module>.service.ts
-├── <module>.trpc.ts
-└── <module>.module.ts
-```
-
-## Layer Boundaries
-
-- Repositories own persistence and query construction.
-- Services own business rules, orchestration, and context-aware defaults.
-- tRPC files own transport only and must delegate to services.
-- Register modules in `apps/server/src/app.ts`; use `db.ts` and `lib/auth.ts` only for scripts that need direct DB or auth access.
-
-## Workflow, Redis, and push notifications
-
-- `WorkflowModule` and `NotificationModule` are registered in `app.ts`. Start **Redis** locally (`REDIS_URL`) before `pnpm dev` on the server, or background jobs will not run.
-- `index.ts` calls `builtBackendApp.start()` before listening and `builtBackendApp.shutdown()` on exit.
-- After changing Drizzle tables, run `pnpm --filter ./apps/server sync` — do not hand-edit SQL migrations in this repo.
-
-Push-related server env vars are documented in `apps/shared/.env.example`.
+# Server Module Structure Guide
+
+Use this for modules in `apps/server/src/modules/**`.
+
+## Preferred Module Layout
+
+Shared contracts:
+
+```
+apps/shared/src/modules/<module>/
+├── <module>.constants.ts
+└── <module>.schema.ts
+```
+
+Server module:
+
+```
+apps/server/src/modules/<module>/
+├── <module>.db.ts
+├── <module>.repository.ts
+├── <module>.service.ts
+├── <module>.trpc.ts
+└── <module>.module.ts
+```
+
+## Layer Boundaries
+
+- Repositories own persistence and query construction.
+- Services own business rules, orchestration, and context-aware defaults.
+- tRPC files own transport only and must delegate to services.
+- Register modules in `apps/server/src/app.ts`; use `db.ts` and `lib/auth.ts` only for scripts that need direct DB or auth access.
+
+## Workflow, Redis, and push notifications
+
+- `WorkflowModule` and `NotificationModule` are registered in `app.ts`. Start **Redis** locally (`REDIS_URL`) before `pnpm dev` on the server, or background jobs will not run.
+- `index.ts` calls `builtBackendApp.start()` before listening and `builtBackendApp.shutdown()` on exit.
+- After changing Drizzle tables, run `pnpm --filter ./apps/server sync` — do not hand-edit SQL migrations in this repo.
+
+Push-related server env vars are documented in `apps/shared/.env.example`.

package/templates/minimal-app/apps/server/drizzle/0000_wealthy_absorbing_man.sql

@@ -0,0 +1,268 @@
+CREATE TABLE `account_claim_magic_links` (
+	`id` text PRIMARY KEY NOT NULL,
+	`claim_id` text NOT NULL,
+	`user_id` text NOT NULL,
+	`email` text NOT NULL,
+	`token` text NOT NULL,
+	`url` text NOT NULL,
+	`expires_at` integer,
+	`created_at` integer NOT NULL,
+	FOREIGN KEY (`claim_id`) REFERENCES `waitlist`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE TABLE `accounts` (
+	`id` text PRIMARY KEY NOT NULL,
+	`account_id` text NOT NULL,
+	`provider_id` text NOT NULL,
+	`user_id` text NOT NULL,
+	`access_token` text,
+	`refresh_token` text,
+	`id_token` text,
+	`access_token_expires_at` integer,
+	`refresh_token_expires_at` integer,
+	`scope` text,
+	`password` text,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE TABLE `apikeys` (
+	`id` text PRIMARY KEY NOT NULL,
+	`name` text,
+	`start` text,
+	`prefix` text,
+	`key` text NOT NULL,
+	`user_id` text NOT NULL,
+	`refill_interval` integer,
+	`refill_amount` integer,
+	`last_refill_at` integer,
+	`enabled` integer NOT NULL,
+	`rate_limit_enabled` integer NOT NULL,
+	`rate_limit_time_window` integer,
+	`rate_limit_max` integer,
+	`request_count` integer NOT NULL,
+	`remaining` integer,
+	`last_request` integer,
+	`expires_at` integer,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	`permissions` text,
+	`metadata` text,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE TABLE `invitations` (
+	`id` text PRIMARY KEY NOT NULL,
+	`organization_id` text NOT NULL,
+	`team_id` text,
+	`email` text NOT NULL,
+	`role` text,
+	`status` text NOT NULL,
+	`created_at` integer NOT NULL,
+	`expires_at` integer NOT NULL,
+	`inviter_id` text NOT NULL,
+	FOREIGN KEY (`organization_id`) REFERENCES `organizations`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`team_id`) REFERENCES `teams`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`inviter_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE TABLE `members` (
+	`id` text PRIMARY KEY NOT NULL,
+	`organization_id` text NOT NULL,
+	`user_id` text NOT NULL,
+	`role` text NOT NULL,
+	`created_at` integer NOT NULL,
+	`preferences` text DEFAULT '{}',
+	`metadata` text DEFAULT '{}',
+	`onboarding` integer,
+	`flags` text DEFAULT '[]',
+	FOREIGN KEY (`organization_id`) REFERENCES `organizations`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE TABLE `notification_devices` (
+	`id` text PRIMARY KEY NOT NULL,
+	`user_id` text NOT NULL,
+	`platform` text NOT NULL,
+	`endpoint` text,
+	`subscription` text,
+	`token` text,
+	`label` text,
+	`enabled` integer DEFAULT true NOT NULL,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `notification_devices_endpoint_unique` ON `notification_devices` (`endpoint`);--> statement-breakpoint
+CREATE UNIQUE INDEX `notification_devices_token_unique` ON `notification_devices` (`token`);--> statement-breakpoint
+CREATE TABLE `notification_send_logs` (
+	`id` text PRIMARY KEY NOT NULL,
+	`batch_id` text NOT NULL,
+	`user_id` text NOT NULL,
+	`device_id` text NOT NULL,
+	`provider` text NOT NULL,
+	`title` text NOT NULL,
+	`body` text NOT NULL,
+	`data` text,
+	`status` text NOT NULL,
+	`error` text,
+	`job_id` text,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`device_id`) REFERENCES `notification_devices`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE TABLE `organizations` (
+	`id` text PRIMARY KEY NOT NULL,
+	`name` text NOT NULL,
+	`slug` text,
+	`logo` text,
+	`type` text,
+	`parent_id` text,
+	`created_at` integer NOT NULL,
+	`onboarding` integer,
+	`preferences` text DEFAULT '{}',
+	`metadata` text DEFAULT '{}',
+	`flags` text DEFAULT '[]',
+	`locale` text,
+	FOREIGN KEY (`parent_id`) REFERENCES `organizations`(`id`) ON UPDATE no action ON DELETE set null
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `organizations_slug_unique` ON `organizations` (`slug`);--> statement-breakpoint
+CREATE TABLE `posts` (
+	`id` text PRIMARY KEY NOT NULL,
+	`author_user_id` text,
+	`organization_id` text,
+	`team_id` text,
+	`title` text NOT NULL,
+	`slug` text NOT NULL,
+	`excerpt` text,
+	`content` text NOT NULL,
+	`status` text DEFAULT 'draft' NOT NULL,
+	`published_at` integer,
+	`created_at` integer NOT NULL,
+	`updated_at` integer,
+	`deleted_at` integer,
+	FOREIGN KEY (`author_user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE set null,
+	FOREIGN KEY (`organization_id`) REFERENCES `organizations`(`id`) ON UPDATE no action ON DELETE set null,
+	FOREIGN KEY (`team_id`) REFERENCES `teams`(`id`) ON UPDATE no action ON DELETE set null
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `posts_slug_unique` ON `posts` (`slug`);--> statement-breakpoint
+CREATE TABLE `sessions` (
+	`id` text PRIMARY KEY NOT NULL,
+	`expires_at` integer NOT NULL,
+	`token` text NOT NULL,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	`ip_address` text,
+	`user_agent` text,
+	`user_id` text NOT NULL,
+	`impersonated_by` text,
+	`active_organization_id` text,
+	`active_organization_member_id` text,
+	`active_organization_role` text,
+	`active_organization_type` text,
+	`active_team_id` text,
+	`active_team_role` text,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `sessions_token_unique` ON `sessions` (`token`);--> statement-breakpoint
+CREATE TABLE `teammembers` (
+	`id` text PRIMARY KEY NOT NULL,
+	`team_id` text NOT NULL,
+	`user_id` text NOT NULL,
+	`role` text NOT NULL,
+	`created_at` integer NOT NULL,
+	FOREIGN KEY (`team_id`) REFERENCES `teams`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE TABLE `teams` (
+	`id` text PRIMARY KEY NOT NULL,
+	`name` text NOT NULL,
+	`organization_id` text NOT NULL,
+	`created_at` integer NOT NULL,
+	`updated_at` integer,
+	FOREIGN KEY (`organization_id`) REFERENCES `organizations`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE TABLE `users` (
+	`id` text PRIMARY KEY NOT NULL,
+	`name` text NOT NULL,
+	`email` text NOT NULL,
+	`email_verified` integer NOT NULL,
+	`image` text,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	`role` text,
+	`banned` integer,
+	`ban_reason` text,
+	`ban_expires` integer,
+	`stripe_customer_id` text,
+	`payment_customer_id` text,
+	`payment_plan_tier` text,
+	`payment_plan_expires_at` integer,
+	`preferences` text DEFAULT '{}',
+	`metadata` text DEFAULT '{}',
+	`onboarding` integer,
+	`flags` text DEFAULT '[]',
+	`locale` text
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `users_email_unique` ON `users` (`email`);--> statement-breakpoint
+CREATE UNIQUE INDEX `users_stripe_customer_id_unique` ON `users` (`stripe_customer_id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `users_payment_customer_id_unique` ON `users` (`payment_customer_id`);--> statement-breakpoint
+CREATE TABLE `verifications` (
+	`id` text PRIMARY KEY NOT NULL,
+	`identifier` text NOT NULL,
+	`value` text NOT NULL,
+	`expires_at` integer NOT NULL,
+	`created_at` integer,
+	`updated_at` integer
+);
+--> statement-breakpoint
+CREATE TABLE `waitlist` (
+	`id` text PRIMARY KEY NOT NULL,
+	`name` text,
+	`email` text,
+	`created_at` integer NOT NULL,
+	`updated_at` integer,
+	`status` text DEFAULT 'WAITLIST' NOT NULL,
+	`type` text DEFAULT 'WAITLIST' NOT NULL,
+	`code` text,
+	`expires_at` integer,
+	`user_id` text,
+	`claim_user_id` text,
+	`claimed_at` integer,
+	`claimed_email` text,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action,
+	FOREIGN KEY (`claim_user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE no action
+);
+--> statement-breakpoint
+CREATE TABLE `workflows` (
+	`id` text PRIMARY KEY NOT NULL,
+	`user_id` text,
+	`job_id` text NOT NULL,
+	`job_name` text NOT NULL,
+	`queue_name` text NOT NULL,
+	`timeout` integer,
+	`tags` text,
+	`input` text,
+	`output` text,
+	`status` text NOT NULL,
+	`error` text,
+	`retries` integer DEFAULT 0 NOT NULL,
+	`finished_at` integer,
+	`processed_at` integer,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `workflows_job_id_unique` ON `workflows` (`job_id`);

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

@@ -0,0 +1,26 @@
+import { createClient } from "@libsql/client";
+import { drizzle } from "drizzle-orm/libsql";
+import * as schema from "../src/schema";
+
+/**
+ * Standalone DB handle for scripts (seed, maintenance). Deliberately does NOT
+ * import ./app — constructing the backend app opens Redis/queue connections
+ * that keep short-lived scripts alive forever. The running server gets its own
+ * connection through createBackendApp.
+ */
+const databaseUrl = process.env.DATABASE_URL ?? "file:./local.db";
+const syncUrl = process.env.TURSO_DATABASE_URL;
+const authToken = process.env.TURSO_AUTH_TOKEN;
+
+export const isRemote = syncUrl && authToken;
+
+const client = createClient(
+  isRemote ? { url: databaseUrl, syncUrl, authToken } : { url: databaseUrl }
+);
+
+export const orm = drizzle(client, { schema });
+
+export type Orm = typeof orm;
+export type Schema = typeof schema;
+
+export { schema };