@chaaskit/db 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import PrismaClientPkg from '@prisma/client';
+declare const PrismaClient: typeof PrismaClientPkg.PrismaClient;
+declare global {
+    var prisma: InstanceType<typeof PrismaClient> | undefined;
+}
+export declare const prisma: PrismaClientPkg.PrismaClient<PrismaClientPkg.Prisma.PrismaClientOptions, unknown, import("@prisma/client/runtime/library").InternalArgs>;
+export declare const Prisma: typeof PrismaClientPkg.Prisma;
+export type { PrismaClient } from '@prisma/client';
+export { prisma as db };
+export { getSchemaFolderPath, getBaseSchemaPath, getBaseSchemaContent, getCustomSchemaContent, copySchemaToProject, schemaExists, hasLegacySchema, initializePrisma, } from './schema-helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,MAAM,gBAAgB,CAAC;AAC7C,QAAA,MAAQ,YAAY,qCAAoB,CAAC;AAEzC,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,MAAM,EAAE,YAAY,CAAC,OAAO,YAAY,CAAC,GAAG,SAAS,CAAC;CAC3D;AAED,eAAO,MAAM,MAAM,0IAA0C,CAAC;AAO9D,eAAO,MAAM,MAAM,+BAAyB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;AAGxB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// Use default import for CJS/ESM interop with @prisma/client
+import PrismaClientPkg from '@prisma/client';
+const { PrismaClient } = PrismaClientPkg;
+export const prisma = globalThis.prisma ?? new PrismaClient();
+if (process.env.NODE_ENV !== 'production') {
+    globalThis.prisma = prisma;
+}
+// Re-export Prisma namespace and types
+export const Prisma = PrismaClientPkg.Prisma;
+export { prisma as db };
+// Schema helpers for project setup
+export { getSchemaFolderPath, getBaseSchemaPath, getBaseSchemaContent, getCustomSchemaContent, copySchemaToProject, schemaExists, hasLegacySchema, initializePrisma, } from './schema-helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,eAAe,MAAM,gBAAgB,CAAC;AAC7C,MAAM,EAAE,YAAY,EAAE,GAAG,eAAe,CAAC;AAOzC,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;AAE9D,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;IAC1C,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC;AAC7B,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC;AAE7C,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;AAExB,mCAAmC;AACnC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/schema-helpers.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Get the path to the schema folder included with the package.
+ * Uses Prisma's multi-file schema feature (prismaSchemaFolder).
+ */
+export declare function getSchemaFolderPath(): string;
+/**
+ * Get the path to the base Prisma schema included with the package.
+ * @deprecated Use getSchemaFolderPath() for multi-file schema support.
+ */
+export declare function getBaseSchemaPath(): string;
+/**
+ * Get the content of the base Prisma schema.
+ */
+export declare function getBaseSchemaContent(): Promise<string>;
+/**
+ * Get the content of the custom schema template.
+ */
+export declare function getCustomSchemaContent(): Promise<string>;
+/**
+ * Copy the schema folder to a target directory.
+ * Creates the prisma/schema directory if it doesn't exist.
+ * Only overwrites base.prisma, preserves custom.prisma if it exists.
+ *
+ * @param targetDir - Directory where prisma/schema/ will be created
+ * @returns Object with paths to the copied schemas
+ */
+export declare function copySchemaToProject(targetDir: string): Promise<{
+    basePath: string;
+    customPath: string;
+    customCreated: boolean;
+}>;
+/**
+ * Check if a Prisma schema exists in the target directory.
+ * Checks for both single-file (legacy) and multi-file schema formats.
+ */
+export declare function schemaExists(targetDir: string): Promise<boolean>;
+/**
+ * Check if the target directory has a legacy single-file schema.
+ */
+export declare function hasLegacySchema(targetDir: string): Promise<boolean>;
+/**
+ * Initialize Prisma in a project directory.
+ * Copies the schema files if they don't already exist.
+ *
+ * @param targetDir - Project directory
+ * @param options.force - If true, overwrites existing base.prisma
+ * @returns Object with result information
+ */
+export declare function initializePrisma(targetDir: string, options?: {
+    force?: boolean;
+}): Promise<{
+    basePath: string;
+    customPath: string;
+    baseCreated: boolean;
+    customCreated: boolean;
+    hadLegacySchema: boolean;
+}>;
+//# sourceMappingURL=schema-helpers.d.ts.map

package/dist/schema-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-helpers.d.ts","sourceRoot":"","sources":["../src/schema-helpers.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAG5D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAG9D;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAAC,CAyB3E;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBtE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQzE;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC,CAkDD"}

package/dist/schema-helpers.js

@@ -0,0 +1,156 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+import fs from 'fs/promises';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Get the path to the schema folder included with the package.
+ * Uses Prisma's multi-file schema feature (prismaSchemaFolder).
+ */
+export function getSchemaFolderPath() {
+    // When running from dist, schema is at ../prisma/schema/
+    return path.resolve(__dirname, '../prisma/schema');
+}
+/**
+ * Get the path to the base Prisma schema included with the package.
+ * @deprecated Use getSchemaFolderPath() for multi-file schema support.
+ */
+export function getBaseSchemaPath() {
+    return path.join(getSchemaFolderPath(), 'base.prisma');
+}
+/**
+ * Get the content of the base Prisma schema.
+ */
+export async function getBaseSchemaContent() {
+    const schemaPath = getBaseSchemaPath();
+    return fs.readFile(schemaPath, 'utf-8');
+}
+/**
+ * Get the content of the custom schema template.
+ */
+export async function getCustomSchemaContent() {
+    const schemaPath = path.join(getSchemaFolderPath(), 'custom.prisma');
+    return fs.readFile(schemaPath, 'utf-8');
+}
+/**
+ * Copy the schema folder to a target directory.
+ * Creates the prisma/schema directory if it doesn't exist.
+ * Only overwrites base.prisma, preserves custom.prisma if it exists.
+ *
+ * @param targetDir - Directory where prisma/schema/ will be created
+ * @returns Object with paths to the copied schemas
+ */
+export async function copySchemaToProject(targetDir) {
+    const sourceFolder = getSchemaFolderPath();
+    const targetFolder = path.join(targetDir, 'prisma', 'schema');
+    // Ensure target directory exists
+    await fs.mkdir(targetFolder, { recursive: true });
+    const sourceBasePath = path.join(sourceFolder, 'base.prisma');
+    const sourceCustomPath = path.join(sourceFolder, 'custom.prisma');
+    const targetBasePath = path.join(targetFolder, 'base.prisma');
+    const targetCustomPath = path.join(targetFolder, 'custom.prisma');
+    // Always copy base.prisma (overwrites)
+    await fs.copyFile(sourceBasePath, targetBasePath);
+    // Only copy custom.prisma if it doesn't exist
+    let customCreated = false;
+    try {
+        await fs.access(targetCustomPath);
+    }
+    catch {
+        await fs.copyFile(sourceCustomPath, targetCustomPath);
+        customCreated = true;
+    }
+    return { basePath: targetBasePath, customPath: targetCustomPath, customCreated };
+}
+/**
+ * Check if a Prisma schema exists in the target directory.
+ * Checks for both single-file (legacy) and multi-file schema formats.
+ */
+export async function schemaExists(targetDir) {
+    // Check for new multi-file schema
+    const schemaFolderPath = path.join(targetDir, 'prisma', 'schema', 'base.prisma');
+    try {
+        await fs.access(schemaFolderPath);
+        return true;
+    }
+    catch {
+        // Check for legacy single-file schema
+        const legacyPath = path.join(targetDir, 'prisma', 'schema.prisma');
+        try {
+            await fs.access(legacyPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Check if the target directory has a legacy single-file schema.
+ */
+export async function hasLegacySchema(targetDir) {
+    const legacyPath = path.join(targetDir, 'prisma', 'schema.prisma');
+    try {
+        await fs.access(legacyPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Initialize Prisma in a project directory.
+ * Copies the schema files if they don't already exist.
+ *
+ * @param targetDir - Project directory
+ * @param options.force - If true, overwrites existing base.prisma
+ * @returns Object with result information
+ */
+export async function initializePrisma(targetDir, options = {}) {
+    const targetFolder = path.join(targetDir, 'prisma', 'schema');
+    const targetBasePath = path.join(targetFolder, 'base.prisma');
+    const targetCustomPath = path.join(targetFolder, 'custom.prisma');
+    const hadLegacySchema = await hasLegacySchema(targetDir);
+    // Check if base already exists
+    let baseExists = false;
+    try {
+        await fs.access(targetBasePath);
+        baseExists = true;
+    }
+    catch {
+        // Base doesn't exist
+    }
+    if (baseExists && !options.force) {
+        // Check custom exists
+        let customExists = false;
+        try {
+            await fs.access(targetCustomPath);
+            customExists = true;
+        }
+        catch {
+            // Custom doesn't exist
+        }
+        // Create custom if missing
+        if (!customExists) {
+            const customContent = await getCustomSchemaContent();
+            await fs.mkdir(targetFolder, { recursive: true });
+            await fs.writeFile(targetCustomPath, customContent);
+        }
+        return {
+            basePath: targetBasePath,
+            customPath: targetCustomPath,
+            baseCreated: false,
+            customCreated: !customExists,
+            hadLegacySchema,
+        };
+    }
+    const result = await copySchemaToProject(targetDir);
+    return {
+        basePath: result.basePath,
+        customPath: result.customPath,
+        baseCreated: true,
+        customCreated: result.customCreated,
+        hadLegacySchema,
+    };
+}
+//# sourceMappingURL=schema-helpers.js.map

package/dist/schema-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-helpers.js","sourceRoot":"","sources":["../src/schema-helpers.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@chaaskit/db",
+  "version": "0.1.0",
+  "description": "Prisma database layer for ChaasKit applications",
+  "license": "MIT",
+  "author": "Matt Ferrante <@ferrants>",
+  "homepage": "https://chaaskit.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ferrants/chaaskit.git",
+    "directory": "packages/db"
+  },
+  "bugs": {
+    "url": "https://github.com/ferrants/chaaskit/issues"
+  },
+  "keywords": ["chaaskit", "ai", "chat", "saas", "database", "prisma"],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "prisma": {
+    "schema": "prisma/schema"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "prisma/schema"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "generate": "prisma generate",
+    "push": "prisma db push",
+    "migrate": "prisma migrate dev",
+    "studio": "prisma studio"
+  },
+  "dependencies": {
+    "@prisma/client": "^6.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "prisma": "^6.0.0",
+    "typescript": "^5.6.0"
+  }
+}

package/prisma/schema/base.prisma

@@ -0,0 +1,584 @@
+// =============================================================================
+// Base Schema - @chat-saas/db
+// =============================================================================
+// This file contains the core models provided by @chat-saas/db.
+// DO NOT MODIFY THIS FILE - it will be overwritten by `chat-saas-server db:sync`.
+//
+// For custom models, create or edit `custom.prisma` in this same directory.
+// =============================================================================
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id            String    @id @default(cuid())
+  email         String    @unique
+  passwordHash  String?
+  name          String?
+  avatarUrl     String?
+
+  // Auth
+  emailVerified Boolean   @default(false)
+  oauthProvider String?
+  oauthId       String?
+
+  // Admin flag
+  isAdmin       Boolean   @default(false)
+
+  // Subscription
+  plan              String  @default("free")
+  stripeCustomerId  String? @unique
+  credits           Int     @default(0)
+  messagesThisMonth Int     @default(0)
+
+  // User settings/context (JSON)
+  settings        Json    @default("{}")
+  themePreference String?
+
+  // Relations
+  threads         Thread[]
+  projects        Project[]
+  teamMemberships TeamMember[]
+  feedback        MessageFeedback[]
+  templates       PromptTemplate[]
+  magicLinks      MagicLink[]
+  mcpCredentials  MCPCredential[]
+  apiKeys         ApiKey[]
+  documents       Document[]
+
+  // OAuth relations
+  oauthClients    OAuthClient[]
+  oauthAuthCodes  OAuthAuthorizationCode[]
+  oauthTokens     OAuthToken[]
+
+  // Scheduled prompts
+  scheduledPrompts ScheduledPrompt[]
+
+  // Email verification
+  emailVerifications EmailVerification[]
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([email])
+  @@index([stripeCustomerId])
+}
+
+model Thread {
+  id        String    @id @default(cuid())
+  title     String    @default("New Chat")
+  userId    String?
+  user      User?     @relation(fields: [userId], references: [id], onDelete: SetNull)
+
+  // Agent used for this thread (null = default agent)
+  agentId   String?
+
+  // For team threads
+  teamId    String?
+  team      Team?     @relation(fields: [teamId], references: [id], onDelete: SetNull)
+
+  // For project threads
+  projectId String?
+  project   Project?  @relation(fields: [projectId], references: [id], onDelete: SetNull)
+
+  // Branching support
+  parentThreadId  String?
+  parentMessageId String?
+  parentThread    Thread?   @relation("ThreadBranches", fields: [parentThreadId], references: [id], onDelete: SetNull)
+  branches        Thread[]  @relation("ThreadBranches")
+
+  // Archived threads (hidden but preserved)
+  archivedAt DateTime?
+
+  // Relations
+  messages         Message[]
+  sharedLinks      SharedThread[]
+  slackEvents      SlackMessageEvent[]
+  scheduledPrompts ScheduledPrompt[]
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([userId])
+  @@index([teamId])
+  @@index([projectId])
+  @@index([parentThreadId])
+  @@index([agentId])
+}
+
+model Message {
+  id        String   @id @default(cuid())
+  threadId  String
+  thread    Thread   @relation(fields: [threadId], references: [id], onDelete: Cascade)
+  role      String   // 'user' | 'assistant' | 'system'
+  content   String
+
+  // File attachments (JSON array)
+  files     Json?
+
+  // Tool calls and results (JSON)
+  toolCalls   Json?
+  toolResults Json?
+
+  // Token usage
+  inputTokens  Int?
+  outputTokens Int?
+
+  // Relations
+  feedback MessageFeedback[]
+
+  createdAt DateTime @default(now())
+
+  @@index([threadId])
+  @@index([createdAt])
+}
+
+model MessageFeedback {
+  id        String   @id @default(cuid())
+  messageId String
+  message   Message  @relation(fields: [messageId], references: [id], onDelete: Cascade)
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  type      String   // 'up' | 'down'
+  comment   String?
+  createdAt DateTime @default(now())
+
+  @@unique([messageId, userId])
+  @@index([messageId])
+}
+
+model SharedThread {
+  id        String    @id @default(cuid())
+  shareId   String    @unique @default(cuid())
+  threadId  String
+  thread    Thread    @relation(fields: [threadId], references: [id], onDelete: Cascade)
+  expiresAt DateTime?
+  createdAt DateTime  @default(now())
+
+  @@index([shareId])
+  @@index([threadId])
+}
+
+model PromptTemplate {
+  id        String   @id @default(cuid())
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  name      String
+  prompt    String
+  variables Json     @default("[]")
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([userId])
+}
+
+model MagicLink {
+  id        String   @id @default(cuid())
+  token     String   @unique
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  expiresAt DateTime
+  usedAt    DateTime?
+  createdAt DateTime @default(now())
+
+  @@index([token])
+  @@index([userId])
+}
+
+model PasswordReset {
+  id        String    @id @default(cuid())
+  token     String    @unique
+  email     String
+  expiresAt DateTime
+  usedAt    DateTime?
+  createdAt DateTime  @default(now())
+
+  @@index([token])
+  @@index([email])
+}
+
+// Projects - organizational folders for threads with AI context
+model Project {
+  id         String    @id @default(cuid())
+  name       String
+  context    String?   // AI context for project threads
+  color      String    // hex color from preset list
+  sharing    String    @default("private") // 'private' | 'team'
+  userId     String    // creator
+  user       User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  teamId     String?   // optional team association
+  team       Team?     @relation(fields: [teamId], references: [id], onDelete: Cascade)
+  threads    Thread[]
+  documents  Document[]
+  archivedAt DateTime? // null = active, set = archived
+  createdAt  DateTime  @default(now())
+  updatedAt  DateTime  @updatedAt
+
+  @@index([userId])
+  @@index([teamId])
+}
+
+// Team workspaces
+model Team {
+  id         String       @id @default(cuid())
+  name       String
+  context    String?      // Additional context passed to AI agent for team threads
+  archivedAt DateTime?    // null = active, set = archived
+
+  // Billing fields
+  plan              String    @default("free")
+  stripeCustomerId  String?   @unique
+  credits           Int       @default(0)
+  messagesThisMonth Int       @default(0)
+
+  members          TeamMember[]
+  threads          Thread[]
+  projects         Project[]
+  invites          TeamInvite[]
+  apiKeys          ApiKey[]
+  documents        Document[]
+  slackIntegration SlackIntegration?
+  scheduledPrompts ScheduledPrompt[]
+  createdAt        DateTime     @default(now())
+  updatedAt        DateTime     @updatedAt
+
+  @@index([stripeCustomerId])
+}
+
+model TeamMember {
+  id     String @id @default(cuid())
+  teamId String
+  team   Team   @relation(fields: [teamId], references: [id], onDelete: Cascade)
+  userId String
+  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
+  role   String // 'owner' | 'admin' | 'member' | 'viewer'
+
+  createdAt DateTime @default(now())
+
+  @@unique([teamId, userId])
+  @@index([teamId])
+  @@index([userId])
+}
+
+model TeamInvite {
+  id         String    @id @default(cuid())
+  teamId     String
+  team       Team      @relation(fields: [teamId], references: [id], onDelete: Cascade)
+  email      String
+  role       String    // 'admin' | 'member' | 'viewer'
+  token      String    @unique
+  invitedBy  String
+  expiresAt  DateTime
+  acceptedAt DateTime?
+  createdAt  DateTime  @default(now())
+
+  @@unique([teamId, email])
+  @@index([token])
+}
+
+// MCP Server Credentials
+model MCPCredential {
+  id             String    @id @default(cuid())
+  userId         String
+  user           User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  serverId       String
+  credentialType String    // 'api_key' | 'oauth'
+  encryptedData  String    // Encrypted JSON: {apiKey} or {accessToken, refreshToken, expiresAt}
+  oauthState     String?   // Temporary state during OAuth flow
+  codeVerifier   String?   // PKCE verifier (encrypted)
+  createdAt      DateTime  @default(now())
+  updatedAt      DateTime  @updatedAt
+
+  @@unique([userId, serverId])
+  @@index([userId])
+}
+
+// API Keys for programmatic access
+model ApiKey {
+  id           String    @id @default(cuid())
+  userId       String
+  user         User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  teamId       String?   // Optional: if set, key operates in team context
+  team         Team?     @relation(fields: [teamId], references: [id], onDelete: Cascade)
+  name         String    // User-provided label, e.g. "My CLI Tool"
+  keyPrefix    String    // First 10 chars for display: "sk-abc123..."
+  keyHash      String    // bcrypt hash of full key
+  lastUsedAt   DateTime?
+  expiresAt    DateTime? // Optional expiration
+  createdAt    DateTime  @default(now())
+
+  @@index([userId])
+  @@index([teamId])
+  @@index([keyPrefix])  // For lookup during auth
+}
+
+// OAuth Client Registration for MCP Server (RFC 7591)
+model OAuthClient {
+  id                String    @id @default(cuid())
+  clientId          String    @unique  // Public client ID
+  clientSecretHash  String?   // bcrypt hash (for confidential clients)
+  clientName        String
+  clientUri         String?
+  redirectUris      String    // JSON array of allowed redirect URIs
+  grantTypes        String    @default("[\"authorization_code\",\"refresh_token\"]")
+  responseTypes     String    @default("[\"code\"]")
+  tokenEndpointAuth String    @default("none") // "none", "client_secret_basic", "client_secret_post"
+  isActive          Boolean   @default(true)
+
+  // For user-registered clients (null = dynamic registration)
+  userId            String?
+  user              User?     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  createdAt         DateTime  @default(now())
+  updatedAt         DateTime  @updatedAt
+
+  // Relations
+  tokens            OAuthToken[]
+  authCodes         OAuthAuthorizationCode[]
+
+  @@index([clientId])
+  @@index([userId])
+}
+
+// OAuth Authorization Codes (short-lived, for auth code flow)
+model OAuthAuthorizationCode {
+  id              String      @id @default(cuid())
+  code            String      @unique
+  clientId        String
+  client          OAuthClient @relation(fields: [clientId], references: [id], onDelete: Cascade)
+  userId          String
+  user            User        @relation(fields: [userId], references: [id], onDelete: Cascade)
+  redirectUri     String
+  scope           String?
+  codeChallenge   String      // PKCE code challenge
+  codeChallengeMethod String  @default("S256")
+  expiresAt       DateTime
+  usedAt          DateTime?
+  createdAt       DateTime    @default(now())
+
+  @@index([code])
+  @@index([clientId])
+  @@index([userId])
+}
+
+// OAuth Access/Refresh Tokens
+model OAuthToken {
+  id               String      @id @default(cuid())
+  tokenHash        String      @unique  // Hash of access token
+  refreshTokenHash String?     @unique  // Hash of refresh token
+  clientId         String
+  client           OAuthClient @relation(fields: [clientId], references: [id], onDelete: Cascade)
+  userId           String
+  user             User        @relation(fields: [userId], references: [id], onDelete: Cascade)
+  scope            String?
+  expiresAt        DateTime
+  refreshExpiresAt DateTime?
+  revokedAt        DateTime?
+  createdAt        DateTime    @default(now())
+
+  @@index([tokenHash])
+  @@index([refreshTokenHash])
+  @@index([clientId])
+  @@index([userId])
+}
+
+// Document storage for @-mentionable resources
+model Document {
+  id          String    @id @default(cuid())
+  name        String                          // Unique within scope
+  content     String?   @db.Text              // For small text docs (stored in DB)
+  storageKey  String?                         // For file storage provider (filesystem/S3)
+  mimeType    String    @default("text/plain")
+  fileSize    Int       @default(0)
+  charCount   Int       @default(0)           // For hybrid threshold
+
+  userId      String
+  user        User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  teamId      String?
+  team        Team?     @relation(fields: [teamId], references: [id], onDelete: Cascade)
+  projectId   String?
+  project     Project?  @relation(fields: [projectId], references: [id], onDelete: Cascade)
+
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+  archivedAt  DateTime?
+
+  @@unique([userId, name, teamId, projectId])  // Unique name per scope
+  @@index([userId])
+  @@index([teamId])
+  @@index([projectId])
+}
+
+// Slack Integration - connects a team to their Slack workspace
+model SlackIntegration {
+  id                  String    @id @default(cuid())
+
+  // Team relationship (one-to-one)
+  teamId              String    @unique
+  team                Team      @relation(fields: [teamId], references: [id], onDelete: Cascade)
+
+  // Slack workspace info
+  slackWorkspaceId    String    @unique  // Slack's team/workspace ID (T01234567)
+  slackWorkspaceName  String              // Human-readable workspace name
+  slackBotUserId      String              // Bot's user ID for @mention detection
+
+  // Encrypted credentials
+  encryptedTokens     String              // AES-encrypted JSON: {botToken, accessToken?}
+
+  // Per-team settings
+  notificationChannel String?             // Default channel for notifications (#general)
+  aiChatEnabled       Boolean   @default(true)
+
+  // Status tracking
+  status              String    @default("active")  // 'active' | 'disconnected' | 'error'
+  statusMessage       String?             // Error details if status='error'
+
+  // Audit
+  installedBy         String              // User ID who installed
+  installedAt         DateTime  @default(now())
+  updatedAt           DateTime  @updatedAt
+
+  // Relations
+  messageEvents       SlackMessageEvent[]
+
+  @@index([teamId])
+  @@index([slackWorkspaceId])
+}
+
+// Slack Message Events - tracks incoming events for deduplication and retry
+model SlackMessageEvent {
+  id                  String    @id @default(cuid())
+
+  // Integration relationship
+  integrationId       String
+  integration         SlackIntegration @relation(fields: [integrationId], references: [id], onDelete: Cascade)
+
+  // Slack message identifiers
+  slackEventId        String    @unique   // Slack's event_id for deduplication
+  slackChannelId      String              // Channel ID (C01234567)
+  slackThreadTs       String?             // Parent message timestamp (for threads)
+  slackMessageTs      String              // This message's timestamp
+  slackUserId         String              // User who sent the message
+  messageText         String?             // Original message text (for debugging)
+
+  // Processing state
+  status              String    @default("pending")  // pending|processing|completed|failed
+  retryCount          Int       @default(0)
+  lastError           String?             // Error message if failed
+
+  // Internal thread linkage (for context continuity)
+  internalThreadId    String?
+  internalThread      Thread?   @relation(fields: [internalThreadId], references: [id], onDelete: SetNull)
+
+  // Response tracking
+  responseTs          String?             // Timestamp of bot's response message
+
+  // Timing
+  createdAt           DateTime  @default(now())
+  updatedAt           DateTime  @updatedAt
+  processedAt         DateTime?
+
+  @@index([integrationId])
+  @@index([slackEventId])
+  @@index([status, updatedAt])           // For retry queries
+  @@index([slackChannelId, slackThreadTs]) // For thread context lookup
+}
+
+// One-time scheduled jobs (delayed execution)
+// Used by the queue scheduler for jobs that need to run at a specific time
+model ScheduledJob {
+  id           String    @id @default(cuid())
+  type         String                      // Job type (e.g., 'email:send')
+  payload      String    @db.Text          // JSON job payload
+  options      String    @db.Text          // JSON EnqueueOptions
+  scheduledFor DateTime                    // When to enqueue to the queue
+  status       String    @default("scheduled")  // scheduled | enqueued | cancelled
+  error        String?                     // Error message if failed to enqueue
+  createdAt    DateTime  @default(now())
+  updatedAt    DateTime  @updatedAt
+
+  @@index([status, scheduledFor])
+  @@index([type])
+}
+
+// Recurring jobs (cron-style)
+// Scheduler polls these and enqueues jobs according to schedule
+model RecurringJob {
+  id          String    @id @default(cuid())
+  name        String    @unique            // Unique job name: "daily-report", "hourly-cleanup"
+  type        String                       // Job type to enqueue (e.g., 'report:generate')
+  payload     String    @db.Text           // JSON payload for each job
+  options     String    @db.Text           // JSON EnqueueOptions (minus scheduling)
+  schedule    String                       // Cron: "0 9 * * *" or interval: "every 1 hour"
+  timezone    String    @default("UTC")
+  enabled     Boolean   @default(true)
+  nextRunAt   DateTime?                    // Calculated next run time
+  lastRunAt   DateTime?                    // Last successful run
+  lastError   String?                      // Last error (if any)
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+
+  @@index([enabled, nextRunAt])
+}
+
+// Scheduled Prompts (Automations)
+// User or team-configurable prompts that run on a schedule
+model ScheduledPrompt {
+  id              String    @id @default(cuid())
+  name            String                       // "Daily Summary", "Weekly Report"
+  prompt          String    @db.Text           // The prompt text to run
+  agentId         String?                      // Agent to use (null = default)
+
+  // Schedule
+  schedule        String                       // Cron: "0 9 * * 1-5" or interval: "every 1 day"
+  timezone        String    @default("UTC")
+  enabled         Boolean   @default(true)
+
+  // Notification settings
+  notifySlack     Boolean   @default(true)
+  notifyEmail     Boolean   @default(false)
+  emailRecipients String?   @db.Text           // JSON array of emails
+
+  // Results storage
+  threadId        String?                      // Dedicated thread for results (created on first run)
+  thread          Thread?   @relation(fields: [threadId], references: [id], onDelete: SetNull)
+
+  // Ownership (one of these must be set)
+  userId          String?
+  user            User?     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  teamId          String?
+  team            Team?     @relation(fields: [teamId], references: [id], onDelete: Cascade)
+
+  // Tracking
+  lastRunAt       DateTime?
+  lastRunStatus   String?                      // "success" | "failed"
+  lastError       String?
+  runCount        Int       @default(0)
+
+  createdAt       DateTime  @default(now())
+  updatedAt       DateTime  @updatedAt
+
+  @@index([userId])
+  @@index([teamId])
+  @@index([enabled])
+}
+
+// Email Verification Codes
+model EmailVerification {
+  id        String    @id @default(cuid())
+  code      String    // 6-digit code (hashed)
+  userId    String
+  user      User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  expiresAt DateTime
+  usedAt    DateTime?
+  attempts  Int       @default(0)  // Brute force protection
+  createdAt DateTime  @default(now())
+
+  @@index([userId])
+}

package/prisma/schema/custom.prisma

@@ -0,0 +1,24 @@
+// =============================================================================
+// Custom Schema - Your Application Models
+// =============================================================================
+// Add your custom models here. This file is preserved during `chat-saas-server db:sync`.
+//
+// You can:
+// - Add new models
+// - Add relations to core models (use the model name, Prisma will find it in base.prisma)
+//
+// Example:
+//
+// model BlogPost {
+//   id        String   @id @default(cuid())
+//   title     String
+//   content   String
+//   authorId  String
+//   author    User     @relation(fields: [authorId], references: [id])
+//   createdAt DateTime @default(now())
+// }
+//
+// Note: If you add a relation to a core model (like User above), you may need to
+// add the opposite relation field to that model in base.prisma. After running
+// db:sync, check for validation errors and add any missing relation fields.
+// =============================================================================