@danielcok17/prisma-db 1.0.2 → 1.0.3

package/README.md

@@ -1,4 +1,4 @@
-# @legal-ai/prisma-db
+# @danielcok17/prisma-db
 
 Shared Prisma setup with dual Prisma clients: one for your app tables (`app` schema), one for existing law tables (`public` schema).
 
@@ -22,17 +22,108 @@ import { AppPrismaClient, LawPrismaClient } from '@danielcok17/prisma-db';
 ```
 
 ## Environment
-Set the following env vars in your runtime/build:
+Set the following env vars in your runtime/build (names match the `.prisma` files):
 
 ```
-DATABASE_URL_APP=postgres://USER:PASS@HOST:PORT/DB?schema=app
-DATABASE_URL_APP_DIRECT=postgres://USER:PASS@HOST:PORT/DB?schema=app
-DATABASE_URL_LAW=postgres://READONLY_USER:PASS@HOST:PORT/DB
-DATABASE_URL_LAW_DIRECT=postgres://READONLY_USER:PASS@HOST:PORT/DB
+POSTGRES_PRISMA_URL=postgres://USER:PASS@HOST:PORT/DB?schema=app
+POSTGRES_URL_NON_POOLING=postgres://USER:PASS@HOST:PORT/DB?schema=app
+POSTGRES_PRISMA_URL_LAW=postgres://READONLY_USER:PASS@HOST:PORT/DB
+POSTGRES_URL_NON_POOLING_LAW=postgres://READONLY_USER:PASS@HOST:PORT/DB
 ```
 
 Notes:
-- Use a read-only role for `DATABASE_URL_LAW`.
-- Ensure DB has `CREATE SCHEMA IF NOT EXISTS app;` executed once.
+- Use a read-only role for `POSTGRES_PRISMA_URL_LAW`.
+- Ensure the DB has `CREATE SCHEMA IF NOT EXISTS app;` executed once.
 
+## Schema paths (for tooling / CI)
+This package publishes the `prisma` directory. You can get absolute paths to the schemas programmatically:
 
+```ts
+import { appPrismaSchemaPath, lawPrismaSchemaPath, prismaMigrationsPath } from '@danielcok17/prisma-db';
+```
+
+Examples:
+
+```bash
+# Use the packaged app schema with Prisma CLI
+npx prisma migrate deploy --schema "$(node -e "console.log(require('@danielcok17/prisma-db').appPrismaSchemaPath)")"
+
+# Or resolve directly to the file shipped in the package
+APP_SCHEMA=$(node -e "console.log(require.resolve('@danielcok17/prisma-db/prisma/app.prisma'))")
+npx prisma generate --schema "$APP_SCHEMA"
+```
+
+
+
+## Installation
+```bash
+npm install @danielcok17/prisma-db
+# or
+yarn add @danielcok17/prisma-db
+```
+
+The package runs Prisma generate on postinstall. If your environment blocks lifecycle scripts, run generate manually using `appPrismaSchemaPath` as shown below.
+
+## Quick start
+1) Set env vars (match the names used in `.prisma` files):
+```
+POSTGRES_PRISMA_URL=postgres://USER:PASS@HOST:PORT/DB?schema=app
+POSTGRES_URL_NON_POOLING=postgres://USER:PASS@HOST:PORT/DB?schema=app
+POSTGRES_PRISMA_URL_LAW=postgres://READONLY_USER:PASS@HOST:PORT/DB
+POSTGRES_URL_NON_POOLING_LAW=postgres://READONLY_USER:PASS@HOST:PORT/DB
+```
+
+2) Apply migrations for the `app` schema:
+```bash
+APP_SCHEMA=$(node -e "console.log(require('@danielcok17/prisma-db').appPrismaSchemaPath)")
+npx prisma migrate deploy --schema "$APP_SCHEMA"
+```
+
+3) Use the clients:
+```ts
+import { appPrisma, lawPrisma } from '@danielcok17/prisma-db';
+
+const users = await appPrisma.user.findMany();
+const laws = await lawPrisma.lawVersion.findMany({ take: 5 });
+```
+
+## Upgrading to a new version
+When you update the package, always apply migrations shipped with the new version.
+
+```bash
+npm install @danielcok17/prisma-db@latest
+
+# Regenerate client (if your CI blocks postinstall or you want to be explicit)
+APP_SCHEMA=$(node -e "console.log(require('@danielcok17/prisma-db').appPrismaSchemaPath)")
+npx prisma generate --schema "$APP_SCHEMA"
+
+# Apply new migrations
+npx prisma migrate deploy --schema "$APP_SCHEMA"
+```
+
+Notes:
+- Do not run `prisma migrate dev` in consumer apps. Schema changes are managed in this package and released via versions.
+- If there are breaking changes, check the release notes for manual steps.
+
+## CI/CD snippet
+Add a deploy step to apply migrations using the schema from this package:
+```bash
+APP_SCHEMA=$(node -e "console.log(require('@danielcok17/prisma-db').appPrismaSchemaPath)")
+npx prisma migrate deploy --schema "$APP_SCHEMA"
+```
+
+Optionally regenerate the client at build/deploy time:
+```bash
+npx prisma generate --schema "$APP_SCHEMA"
+```
+
+## Prisma Studio (optional)
+```bash
+APP_SCHEMA=$(node -e "console.log(require('@danielcok17/prisma-db').appPrismaSchemaPath)")
+npx prisma studio --schema "$APP_SCHEMA"
+```
+
+## Troubleshooting
+- Missing client types/runtime: run `npx prisma generate --schema "$(node -e "console.log(require('@danielcok17/prisma-db').appPrismaSchemaPath)")"`.
+- Migrate deploy fails: verify env vars and DB connectivity; ensure the `app` schema exists.
+- Read-only access to law tables: use a user/role with SELECT-only permissions for `POSTGRES_PRISMA_URL_LAW`.

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { PrismaClient as AppPrismaClient } from '../prisma/generated/app';
 export { PrismaClient as LawPrismaClient } from '../prisma/generated/law';
 export * from './utils';
+export * from './paths';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1E,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1E,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -20,4 +20,5 @@ Object.defineProperty(exports, "AppPrismaClient", { enumerable: true, get: funct
 var law_1 = require("../prisma/generated/law");
 Object.defineProperty(exports, "LawPrismaClient", { enumerable: true, get: function () { return law_1.PrismaClient; } });
 __exportStar(require("./utils"), exports);
+__exportStar(require("./paths"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+CAA0E;AAAjE,sGAAA,YAAY,OAAmB;AACxC,+CAA0E;AAAjE,sGAAA,YAAY,OAAmB;AACxC,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+CAA0E;AAAjE,sGAAA,YAAY,OAAmB;AACxC,+CAA0E;AAAjE,sGAAA,YAAY,OAAmB;AACxC,0CAAwB;AACxB,0CAAwB"}

package/dist/paths.d.ts

@@ -0,0 +1,4 @@
+export declare const appPrismaSchemaPath: string;
+export declare const lawPrismaSchemaPath: string;
+export declare const prismaMigrationsPath: string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB,EAAE,MAA0D,CAAC;AAC7F,eAAO,MAAM,mBAAmB,EAAE,MAA0D,CAAC;AAC7F,eAAO,MAAM,oBAAoB,EAAE,MAA0D,CAAC"}

package/dist/paths.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prismaMigrationsPath = exports.lawPrismaSchemaPath = exports.appPrismaSchemaPath = void 0;
+const path_1 = __importDefault(require("path"));
+const packageRootDir = path_1.default.resolve(__dirname, '..');
+exports.appPrismaSchemaPath = path_1.default.join(packageRootDir, 'prisma', 'app.prisma');
+exports.lawPrismaSchemaPath = path_1.default.join(packageRootDir, 'prisma', 'law.prisma');
+exports.prismaMigrationsPath = path_1.default.join(packageRootDir, 'prisma', 'migrations');
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AAExB,MAAM,cAAc,GAAG,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAExC,QAAA,mBAAmB,GAAW,cAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AAChF,QAAA,mBAAmB,GAAW,cAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AAChF,QAAA,oBAAoB,GAAW,cAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danielcok17/prisma-db",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Shared Prisma schema for Legal AI applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -35,11 +35,11 @@
     "node": ">=18.18"
   },
   "dependencies": {
-    "@prisma/client": "^6.14.0",
-    "prisma": "^6.14.0"
+    "@prisma/client": "^6.15.0"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
+    "prisma": "^6.15.0",
     "tsx": "^4.0.0",
     "typescript": "^5.0.0"
   }

package/prisma/app.prisma

@@ -28,28 +28,28 @@ model Account {
 }
 
 model User {
-  id                String         @id @default(cuid())
+  id                String               @id @default(cuid())
   name              String?
-  email             String?        @unique
+  email             String?              @unique
   emailVerified     DateTime?
   image             String?
-  createdAt         DateTime       @default(now())
-  messageCount      Int            @default(100)
-  agreedToTerms     Boolean        @default(false)
+  createdAt         DateTime             @default(now())
+  messageCount      Int                  @default(100)
+  agreedToTerms     Boolean              @default(false)
   practiceArea      String[]
   lawFirm           String?
   yearsOfExperience Int?
   // Nové polia pre schvalovanie používateľov
-  isApproved        Boolean        @default(false)  // Či je používateľ schválený
-  isRejected        Boolean        @default(false)  // Či je používateľ zamietnutý
-  approvedAt        DateTime?      // Kedy bol schválený
-  rejectedAt        DateTime?      // Kedy bol zamietnutý
-  approvedBy        String?        // ID admina, ktorý schválil
-  rejectedBy        String?        // ID admina, ktorý zamietol
-  rejectionReason   String?        // Dôvod zamietnutia
+  isApproved        Boolean              @default(false) // Či je používateľ schválený
+  isRejected        Boolean              @default(false) // Či je používateľ zamietnutý
+  approvedAt        DateTime? // Kedy bol schválený
+  rejectedAt        DateTime? // Kedy bol zamietnutý
+  approvedBy        String? // ID admina, ktorý schválil
+  rejectedBy        String? // ID admina, ktorý zamietol
+  rejectionReason   String? // Dôvod zamietnutia
   // Nové polia pre tracking a žiadosť
-  referralSource    String?        // Odkiaľ sa o nás dozvedel (Google, Facebook, LinkedIn, etc.)
-  applicationText   String?        // Text žiadosti o prihlásenie
+  referralSource    String? // Odkiaľ sa o nás dozvedel (Google, Facebook, LinkedIn, etc.)
+  applicationText   String? // Text žiadosti o prihlásenie
   approvalRequest   UserApprovalRequest?
   accounts          Account[]
   answers           Answer[]
@@ -57,18 +57,19 @@ model User {
   feedbacks         Feedback[]
   pageViews         PageView[]
   sessions          Session[]
+  workflowLogs      WorkflowLog[]
 }
 
 // Nový model pre žiadosti o schválenie
 model UserApprovalRequest {
-  id          String   @id @default(cuid())
-  userId      String   @unique
+  id          String         @id @default(cuid())
+  userId      String         @unique
   status      ApprovalStatus @default(PENDING)
-  submittedAt DateTime @default(now())
+  submittedAt DateTime       @default(now())
   reviewedAt  DateTime?
-  reviewedBy  String?  // ID admina, ktorý preskúmal žiadosť
-  notes       String?  // Poznámky admina
-  user        User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  reviewedBy  String? // ID admina, ktorý preskúmal žiadosť
+  notes       String? // Poznámky admina
+  user        User           @relation(fields: [userId], references: [id], onDelete: Cascade)
 
   @@index([status])
   @@index([submittedAt])
@@ -77,46 +78,48 @@ model UserApprovalRequest {
 
 // ZJEDNODUŠENÝ Conversation - len metadata, bez duplikátov
 model Conversation {
-  id          String      @id @default(cuid())
-  name        String
-  userId      String
-  isShareable Boolean     @default(false)
-  shareUrl    String?     @unique
-  sharedAt    DateTime?
-  createdAt   DateTime    @default(now())
-  updatedAt   DateTime    @updatedAt
-  summary     String?
-  messagesSinceLastSummary     Int? @default(0)
+  id                       String        @id @default(cuid())
+  name                     String
+  userId                   String
+  isShareable              Boolean       @default(false)
+  shareUrl                 String?       @unique
+  sharedAt                 DateTime?
+  createdAt                DateTime      @default(now())
+  updatedAt                DateTime      @updatedAt
+  summary                  String?
+  messagesSinceLastSummary Int?          @default(0)
   // Relácie
-  answers     Answer[]
-  user        User        @relation(fields: [userId], references: [id])
-  
+  answers                  Answer[]
+  user                     User          @relation(fields: [userId], references: [id])
+  workflowLogs             WorkflowLog[]
+
   @@index([userId])
   @@index([createdAt])
 }
 
 // Hlavný model - všetky správy, bez duplikátov
 model Answer {
-  id             String       @id @default(cuid())
+  id             String         @id @default(cuid())
   conversationId String
-  messageId      String       @unique
+  messageId      String         @unique
   role           Role
   content        String
   question       String?
   answer         String?
   evaluation     String?
-  isWelcome      Boolean      @default(false)
+  isWelcome      Boolean        @default(false)
   processingTime Int?
   model          String?
   userId         String?
-  createdAt      DateTime     @default(now())
-  updatedAt      DateTime     @updatedAt
+  createdAt      DateTime       @default(now())
+  updatedAt      DateTime       @updatedAt
   // Relácie
-  conversation   Conversation @relation(fields: [conversationId], references: [id], onDelete: Cascade)
-  user           User?        @relation(fields: [userId], references: [id])
+  conversation   Conversation   @relation(fields: [conversationId], references: [id], onDelete: Cascade)
+  user           User?          @relation(fields: [userId], references: [id])
   feedback       Feedback?
   references     Reference[]
   metrics        AnswerMetrics?
+  WorkflowLog    WorkflowLog[]
 
   @@index([conversationId])
   @@index([messageId])
@@ -127,28 +130,28 @@ model Answer {
 
 // Nová tabuľka pre metriky odpovedí
 model AnswerMetrics {
-  id                String   @id @default(cuid())
-  answerId          String   @unique
+  id              String   @id @default(cuid())
+  answerId        String   @unique
   // Náklady
-  apiCost           Float?   // Celkové náklady (ai_cost + rag_cost)
-  aiCost            Float?   // Náklady len na AI provider volania
-  ragCost           Float?   // Náklady na RAG operácie
+  apiCost         Float? // Celkové náklady (ai_cost + rag_cost)
+  aiCost          Float? // Náklady len na AI provider volania
+  ragCost         Float? // Náklady na RAG operácie
   // Volania
-  apiCalls          Int?     // Celkový počet volaní
-  aiCalls           Int?     // Počet AI provider volaní
-  ragCalls          Int?     // Počet RAG operácií
+  apiCalls        Int? // Celkový počet volaní
+  aiCalls         Int? // Počet AI provider volaní
+  ragCalls        Int? // Počet RAG operácií
   // Čas a výkon
-  apiDuration       Int?     // Doba spracovania v ms
+  apiDuration     Int? // Doba spracovania v ms
   // AI Provider a Model
-  aiProvider        String?  // Hlavný AI provider
-  aiModel           String?  // Hlavný AI model
-  aiProvidersUsed   String[] // Všetky použité AI providery
-  aiModelsUsed      String[] // Všetky použité AI modely
+  aiProvider      String? // Hlavný AI provider
+  aiModel         String? // Hlavný AI model
+  aiProvidersUsed String[] // Všetky použité AI providery
+  aiModelsUsed    String[] // Všetky použité AI modely
   // Timestamps
-  createdAt         DateTime @default(now())
-  updatedAt         DateTime @updatedAt
+  createdAt       DateTime @default(now())
+  updatedAt       DateTime @updatedAt
   // Relations
-  answer            Answer   @relation(fields: [answerId], references: [id], onDelete: Cascade)
+  answer          Answer   @relation(fields: [answerId], references: [id], onDelete: Cascade)
 
   @@index([answerId])
   @@index([apiCost])
@@ -177,7 +180,7 @@ model Feedback {
 // ZJEDNODUŠENÝ Reference - len na Answer, bez duplikátov
 model Reference {
   id             String        @id @default(cuid())
-  answerId       String        // Len answerId - konzistentné
+  answerId       String // Len answerId - konzistentné
   type           ReferenceType
   title          String
   reference      String
@@ -202,7 +205,7 @@ model Reference {
 model PageView {
   id         String   @id @default(cuid())
   userId     String?
-  sessionId  String
+  sessionId  String?
   page       String
   path       String
   referrer   String?
@@ -218,7 +221,7 @@ model PageView {
   timeOnPage Int?
   isBounce   Boolean  @default(true)
   createdAt  DateTime @default(now())
-  session    Session  @relation(fields: [sessionId], references: [sessionId], onDelete: SetNull)
+  session    Session? @relation(fields: [sessionId], references: [sessionId], onDelete: SetNull)
   user       User?    @relation(fields: [userId], references: [id])
 
   @@index([userId])
@@ -230,16 +233,16 @@ model PageView {
 }
 
 model Session {
-  id        String     @id @default(cuid())
-  sessionId String     @unique
-  userId    String?
-  startedAt DateTime   @default(now())
-  endedAt   DateTime?
-  duration  Int?
-  pageViews PageView[]
-  user      User?      @relation(fields: [userId], references: [id])
+  id           String        @id @default(cuid())
+  sessionId    String        @unique
+  userId       String?
+  startedAt    DateTime      @default(now())
+  endedAt      DateTime?
+  duration     Int?
+  pageViews    PageView[]
+  user         User?         @relation(fields: [userId], references: [id])
+  workflowLogs WorkflowLog[]
 
-  @@index([sessionId])
   @@index([userId])
   @@index([startedAt])
 }
@@ -272,12 +275,12 @@ enum ApprovalStatus {
 
 // Nový model pre logovanie admin akcií
 model AdminActionLog {
-  id          String   @id @default(cuid())
-  action      String   // APPROVE_USER, REJECT_USER, etc.
-  targetUserId String  // ID používateľa, na ktorého sa akcia vzťahuje
-  adminEmail  String   // E-mail admina, ktorý vykonal akciu
-  details     Json?    // Ďalšie detaily akcie (reason, notes, etc.)
-  createdAt   DateTime @default(now())
+  id           String   @id @default(cuid())
+  action       String // APPROVE_USER, REJECT_USER, etc.
+  targetUserId String // ID používateľa, na ktorého sa akcia vzťahuje
+  adminEmail   String // E-mail admina, ktorý vykonal akciu
+  details      Json? // Ďalšie detaily akcie (reason, notes, etc.)
+  createdAt    DateTime @default(now())
 
   @@index([action])
   @@index([targetUserId])
@@ -285,4 +288,75 @@ model AdminActionLog {
   @@index([createdAt])
 }
 
+model WorkflowLog {
+  id             String         @id @default(cuid()) // Added @default(cuid())
+  conversationId String
+  messageId      String?
+  userId         String? // Made optional to preserve logs when users are deleted
+  sessionId      String? // Removed @unique to allow multiple workflows per session
+  startedAt      DateTime       @default(now())
+  completedAt    DateTime?
+  status         WorkflowStatus @default(IN_PROGRESS)
+  totalDuration  Int? // milliseconds
+  error          String?
+  metadata       Json?
+  steps          WorkflowStep[] // Renamed from WorkflowStep to steps (lowerCamel, plural)
+  conversation   Conversation   @relation(fields: [conversationId], references: [id], onDelete: Cascade)
+  user           User?          @relation(fields: [userId], references: [id], onDelete: SetNull)
+  session        Session?       @relation(fields: [sessionId], references: [sessionId], onDelete: SetNull)
+  answer         Answer?        @relation(fields: [messageId], references: [messageId])
+
+  @@index([conversationId])
+  @@index([userId])
+  @@index([sessionId])
+  @@index([startedAt])
+  @@index([status])
+  @@index([conversationId, startedAt]) // Composite index for timeline queries
+  @@index([messageId])
+}
+
+model WorkflowStep {
+  id          String      @id @default(cuid()) // Added @default(cuid())
+  workflowId  String
+  stepName    String // 'classify_question', 'rag_search', 'ai_processing', 'generate_response'
+  stepType    StepType
+  startedAt   DateTime    @default(now())
+  completedAt DateTime?
+  duration    Int? // milliseconds
+  status      StepStatus  @default(IN_PROGRESS)
+  inputData   Json? // Sanitized input data
+  outputData  Json? // Sanitized output data
+  error       String?
+  metadata    Json? // Provider used, model used, tokens, costs, etc.
+  workflow    WorkflowLog @relation(fields: [workflowId], references: [id], onDelete: Cascade)
+
+  @@index([workflowId])
+  @@index([stepName])
+  @@index([stepType])
+  @@index([startedAt])
+  @@index([status])
+  @@index([workflowId, startedAt]) // Composite index for timeline queries
+}
+
+enum WorkflowStatus {
+  IN_PROGRESS
+  COMPLETED
+  FAILED
+  CANCELLED
+}
+
+enum StepStatus {
+  IN_PROGRESS
+  COMPLETED
+  FAILED
+  SKIPPED
+}
 
+enum StepType {
+  CLASSIFICATION
+  RAG_RETRIEVAL
+  AI_PROCESSING
+  RESPONSE_GENERATION
+  DATA_PERSISTENCE
+  ERROR_HANDLING
+}