@nestarc/feature-flag 0.4.0 → 0.5.0

package/README.md

@@ -34,9 +34,13 @@ npm install @nestarc/feature-flag
 ### Peer dependencies
 
 ```bash
-npm install @nestjs/common @nestjs/core @prisma/client class-transformer class-validator rxjs reflect-metadata
+npm install @nestjs/common @nestjs/core @prisma/client @prisma/adapter-pg pg class-transformer class-validator rxjs reflect-metadata
+npm install --save-dev prisma
 ```
 
+Prisma 7 requires Node.js 20.19+, 22.12+, or 24+. This package follows the
+same runtime requirement.
+
 ### Optional
 
 ```bash
@@ -76,6 +80,45 @@ When a flag is updated on any instance, all other instances are notified via Pub
 
 ## Prisma Schema
 
+Prisma 7 keeps connection URLs in `prisma.config.ts` and requires a database
+driver adapter at runtime. A minimal PostgreSQL setup is:
+
+```ts
+// prisma.config.ts
+import 'dotenv/config';
+import { defineConfig, env } from 'prisma/config';
+
+export default defineConfig({
+  schema: 'prisma/schema.prisma',
+  migrations: { path: 'prisma/migrations' },
+  datasource: { url: env('DATABASE_URL') },
+});
+```
+
+```prisma
+generator client {
+  provider = "prisma-client"
+  output   = "../src/generated/prisma"
+}
+
+datasource db {
+  provider = "postgresql"
+}
+```
+
+Create the client with `@prisma/adapter-pg`, then pass that instance to
+`FeatureFlagModule`:
+
+```ts
+import { PrismaPg } from '@prisma/adapter-pg';
+import { PrismaClient } from './generated/prisma/client';
+
+const adapter = new PrismaPg({
+  connectionString: process.env.DATABASE_URL,
+});
+const prisma = new PrismaClient({ adapter });
+```
+
 Add the following models to your `schema.prisma`:
 
 ```prisma
@@ -764,16 +807,16 @@ export class AppModule {}
 
 ## Performance
 
-Measured with PostgreSQL 16, Prisma 6, 500 iterations on Apple Silicon:
+Measured with PostgreSQL 16, Prisma 7.9.1, 500 iterations on Apple Silicon:
 
 | Scenario | Avg | P50 | P95 | P99 |
 |----------|-----|-----|-----|-----|
-| **isEnabled() — cache hit** | **0.04ms** | **0.03ms** | **0.05ms** | **0.07ms** |
-| isEnabled() — cache miss (DB lookup) | 1.30ms | 1.14ms | 2.54ms | 3.69ms |
-| isEnabled() — override cascade (cold) | 1.07ms | 1.02ms | 1.43ms | 2.11ms |
-| **evaluateAll() — 50 flags (mixed)** | **0.19ms** | **0.04ms** | **1.55ms** | **1.71ms** |
+| **isEnabled() — cache hit** | **0.04ms** | **0.04ms** | **0.05ms** | **0.12ms** |
+| isEnabled() — cache miss (DB lookup) | 1.17ms | 1.10ms | 1.62ms | 2.04ms |
+| isEnabled() — override cascade (cold) | 0.95ms | 0.89ms | 1.36ms | 1.87ms |
+| **evaluateAll() — 50 flags (mixed)** | **0.19ms** | **0.04ms** | **1.47ms** | **1.78ms** |
 
-Cache speedup: **32.5x** (hit vs miss). Keep the default 30s cache TTL for optimal performance.
+Cache speedup: **29.2x** (hit vs miss). Keep the default 30s cache TTL for optimal performance.
 
 > Reproduce: `docker compose up -d && dotenv -e .env.test -- npx ts-node benchmarks/evaluation-overhead.ts`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestarc/feature-flag",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "DB-backed feature flags for NestJS + Prisma + PostgreSQL with tenant-aware overrides",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,6 +26,7 @@
     "build": "tsc -p tsconfig.build.json",
     "test": "jest",
     "test:cov": "jest --coverage",
+    "prebench": "npm run prisma:generate",
     "bench": "dotenv -e .env.test -- npx ts-node benchmarks/evaluation-overhead.ts",
     "lint": "eslint 'src/**/*.ts' 'test/**/*.ts'",
     "format": "prettier --write 'src/**/*.ts' 'test/**/*.ts'",
@@ -34,7 +35,7 @@
     "docker:down": "docker compose down",
     "db:migrate": "dotenv -e .env.test -- npx prisma migrate deploy",
     "db:reset": "dotenv -e .env.test -- npx prisma migrate reset --force",
-    "pretest:e2e": "npm run docker:up && npm run db:migrate",
+    "pretest:e2e": "npm run prisma:generate && npm run docker:up && npm run db:migrate",
     "test:e2e": "dotenv -e .env.test -- jest --config jest.e2e.config.ts --runInBand"
   },
   "repository": {
@@ -56,11 +57,14 @@
   ],
   "author": "nestarc",
   "license": "MIT",
+  "engines": {
+    "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+  },
   "peerDependencies": {
     "@nestjs/common": "^10.0.0 || ^11.0.0",
     "@nestjs/core": "^10.0.0 || ^11.0.0",
     "@openfeature/server-sdk": "^1.0.0",
-    "@prisma/client": "^5.0.0 || ^6.0.0",
+    "@prisma/client": "^7.0.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.0 || ^0.15.0",
     "ioredis": "^5.0.0",
@@ -92,20 +96,23 @@
     "@nestjs/event-emitter": "^3.0.0",
     "@nestjs/platform-express": "^11.0.0",
     "@nestjs/testing": "^11.0.0",
-    "@prisma/client": "^6.0.0",
+    "@prisma/adapter-pg": "^7.9.1",
+    "@prisma/client": "^7.9.1",
     "@types/express": "^5.0.0",
     "@types/ioredis-mock": "^8.2.7",
     "@types/jest": "^29.5.0",
     "@types/supertest": "^7.2.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.15.1",
+    "dotenv": "^17.2.3",
     "dotenv-cli": "^11.0.0",
     "eslint": "^9.0.0",
-    "ioredis": "^5.10.1",
+    "ioredis": "^5.11.1",
     "ioredis-mock": "^8.13.1",
     "jest": "^29.7.0",
+    "pg": "^8.22.0",
     "prettier": "^3.0.0",
-    "prisma": "^6.0.0",
+    "prisma": "^7.9.1",
     "reflect-metadata": "^0.2.0",
     "rxjs": "^7.8.0",
     "supertest": "^7.2.2",

package/prisma/schema.prisma

@@ -1,10 +1,11 @@
 generator client {
-  provider = "prisma-client-js"
+  provider     = "prisma-client"
+  output       = "../generated/prisma"
+  moduleFormat = "cjs"
 }
 
 datasource db {
   provider = "postgresql"
-  url      = env("DATABASE_URL")
 }
 
 model FeatureFlag {