@xenterprises/fastify-xconfig 2.1.4 → 2.2.0

package/LICENSE

@@ -0,0 +1,60 @@
+PROPRIETARY SOFTWARE LICENSE
+
+Copyright (c) 2024-2026 X Enterprises LLC. All Rights Reserved.
+
+This software and associated documentation files (the "Software") are the
+exclusive property of X Enterprises LLC, a Washington limited liability
+company.
+
+TERMS AND CONDITIONS
+
+1. OWNERSHIP
+   All rights, title, and interest in and to the Software, including all
+   intellectual property rights, are and shall remain the exclusive property
+   of X Enterprises LLC.
+
+2. RESTRICTIONS
+   Without the prior written consent of X Enterprises LLC, you may not:
+   - Copy, modify, or distribute the Software
+   - Reverse engineer, decompile, or disassemble the Software
+   - Sublicense, sell, lease, or otherwise transfer the Software
+   - Remove or alter any proprietary notices or labels
+
+3. AUTHORIZED USE
+   Use of this Software is limited to authorized employees, contractors, and
+   agents of X Enterprises LLC, solely for purposes approved by X Enterprises
+   LLC.
+
+4. NO WARRANTY
+   THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL
+   X ENTERPRISES LLC BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY,
+   WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF,
+   OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+   SOFTWARE.
+
+5. LIMITATION OF LIABILITY
+   IN NO EVENT SHALL X ENTERPRISES LLC BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
+   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+   OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+   WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+   OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+   ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+6. GOVERNING LAW
+   This license shall be governed by and construed in accordance with the laws
+   of the State of Washington, United States, without regard to its conflict
+   of law provisions.
+
+7. TERMINATION
+   This license is effective until terminated. X Enterprises LLC may terminate
+   this license at any time without notice. Upon termination, you must destroy
+   all copies of the Software in your possession.
+
+For licensing inquiries, contact: legal@x.enterprises
+
+---
+X Enterprises LLC
+Bothell, Washington, United States

package/README.md

@@ -1,18 +1,8 @@
-# xConfig Plugin
+# @xenterprises/fastify-xconfig
 
-A Fastify plugin that provides core configuration, middleware setup, and foundational services for Fastify applications.
+Fastify plugin for centralized middleware orchestration, health checks, and utility decorators.
 
-## Overview
-
-xConfig is a lightweight configuration and middleware orchestration plugin for Fastify. It handles:
-
-- **Middleware Setup**: CORS, rate limiting, multipart handling, error handling
-- **Health Checks**: Disk space monitoring and application uptime tracking
-- **Error Tracking**: Bugsnag integration for production error monitoring
-- **Prisma Integration**: Database connectivity through @prisma/client
-- **Back Pressure Handling**: Automatic shutdown management for overloaded servers
-
-## Installation
+## Install
 
 ```bash
 npm install @xenterprises/fastify-xconfig
@@ -20,155 +10,164 @@ npm install @xenterprises/fastify-xconfig
 
 ## Usage
 
-### Basic Configuration
-
 ```javascript
 import Fastify from 'fastify';
 import xConfig from '@xenterprises/fastify-xconfig';
 
-const fastify = Fastify();
+const fastify = Fastify({ logger: true });
 
 await fastify.register(xConfig, {
-  prisma: {},  // Prisma client configuration
-  cors: {
-    active: true,
-    origin: ['http://localhost:3000'],
-    credentials: true
-  },
-  rateLimit: {
-    max: 100,
-    timeWindow: '1 minute'
-  },
-  bugsnag: {
-    apiKey: process.env.BUGSNAG_API_KEY  // Optional
-  }
+  prisma: { active: false },
+  bugsnag: { active: false },
+  cors: { origin: ['http://localhost:3000'], credentials: true },
+  rateLimit: { max: 100, timeWindow: '1 minute' },
+  multipart: { limits: { fileSize: 52428800 } },
+  underPressure: { maxEventLoopDelay: 1000 },
 });
 
-await fastify.listen({ port: 3000 });
-```
-
-## Configuration Options
-
-### Core Options
-
-| Option | Type | Required | Description |
-|--------|------|----------|-------------|
-| `prisma` | Object | No | Prisma client configuration. If empty, plugin uses default connection pool. |
-| `professional` | Boolean | No | Enable professional mode features (default: false) |
-| `fancyErrors` | Boolean | No | Enable formatted error responses (default: true) |
+// Utility decorators are now available:
+fastify.xSlugify('Hello World');  // "hello-world"
+fastify.xRandomUUID();            // "a1b2c3d4-..."
+fastify.xFormatBytes(1048576);    // "1 MB"
+fastify.xEcho();                  // "Hello from X Enterprises!"
 
-### Middleware Options
-
-| Option | Type | Required | Description |
-|--------|------|----------|-------------|
-| `cors` | Object | No | CORS configuration with `active`, `origin`, and `credentials` |
-| `rateLimit` | Object | No | Rate limiting with `max` requests and `timeWindow` |
-| `multipart` | Object | No | Multipart form handling configuration |
-| `underPressure` | Object | No | Back pressure monitoring configuration |
-
-### Observability Options
-
-| Option | Type | Required | Description |
-|--------|------|----------|-------------|
-| `bugsnag` | Object | No | Bugsnag error tracking with `apiKey` |
-
-## Available Decorators
-
-After registration, the following are available on the fastify instance:
-
-```javascript
-// Health check function
-fastify.health.check()  // Returns { status, diskSpace, uptime }
-
-// Prisma client (if configured)
-fastify.prisma
+await fastify.listen({ port: 3000 });
 ```
 
-## Environment Variables
-
-The plugin reads these environment variables:
-
-```bash
-# Database
-DATABASE_URL=postgresql://user:password@localhost:5432/dbname?sslmode=require
-
-# Server
-NODE_ENV=development
-PORT=3002
-FASTIFY_ADDRESS=0.0.0.0
-
-# Observability
-BUGSNAG_API_KEY=your-bugsnag-api-key
-
-# CORS
-CORS_ORIGIN=http://localhost:3000,https://example.com
-RATE_LIMIT_MAX=100
-RATE_LIMIT_TIME_WINDOW=1 minute
+## Options
+
+| Name | Type | Default | Required | Description |
+|------|------|---------|----------|-------------|
+| `professional` | `boolean` | `false` | No | Disable route listing on startup |
+| `fancyErrors` | `boolean` | `true` | No | Enable formatted error responses with status codes |
+| `prisma` | `object` | `{}` | No | Prisma client configuration (see below) |
+| `bugsnag` | `object` | `{}` | No | Bugsnag error tracking configuration (see below) |
+| `cors` | `object` | `{}` | No | CORS configuration passed to @fastify/cors |
+| `rateLimit` | `object` | `{}` | No | Rate limiting configuration passed to @fastify/rate-limit |
+| `multipart` | `object` | `{}` | No | Multipart configuration passed to @fastify/multipart |
+| `underPressure` | `object` | `{}` | No | Back-pressure configuration passed to @fastify/under-pressure |
+
+### `prisma` Options
+
+| Name | Type | Default | Required | Description |
+|------|------|---------|----------|-------------|
+| `active` | `boolean` | `true` | No | Enable/disable Prisma integration |
+| `client` | `PrismaClient` | — | Yes (if active) | Your generated PrismaClient class |
+| `...rest` | `object` | — | No | Passed directly to `new PrismaClient(...)` |
+
+### `bugsnag` Options
+
+| Name | Type | Default | Required | Description |
+|------|------|---------|----------|-------------|
+| `active` | `boolean` | `true` | No | Enable/disable Bugsnag integration |
+| `apiKey` | `string` | — | Yes (if active) | Bugsnag project API key |
+
+### `cors` Options
+
+| Name | Type | Default | Required | Description |
+|------|------|---------|----------|-------------|
+| `active` | `boolean` | `true` | No | Enable/disable CORS |
+| `origin` | `string\|array` | env-based | No | Allowed origins (production reads `CORS_ORIGIN` env var) |
+| `credentials` | `boolean` | `true` | No | Allow credentials |
+| `methods` | `array` | `["GET","POST","PUT","DELETE","OPTIONS"]` | No | Allowed HTTP methods |
+| `...rest` | `object` | — | No | Passed directly to @fastify/cors |
+
+### Middleware `active` Flag
+
+All middleware options (`cors`, `rateLimit`, `multipart`, `underPressure`, `bugsnag`, `prisma`) accept `active: false` to disable the middleware entirely. When omitted, the middleware is enabled by default.
+
+## Decorated Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `fastify.prisma` | `PrismaClient` | Prisma client instance (only if prisma is active) |
+| `fastify.xEcho()` | `function` | Returns `"Hello from X Enterprises!"` |
+| `fastify.xSlugify(str)` | `function` | Converts string to URL-safe slug |
+| `fastify.xRandomUUID()` | `function` | Generates a UUID v4 string |
+| `fastify.xGenerateUUID()` | `function` | Alias for `xRandomUUID` |
+| `fastify.xFormatBytes(bytes, decimals?)` | `function` | Formats bytes to human-readable string |
+
+## Routes
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `GET` | `/health` | Health check endpoint with system metrics |
+
+### Health Check Response
+
+```json
+{
+  "status": "healthy",
+  "timestamp": "2025-01-15T12:00:00.000Z",
+  "uptime": 3600,
+  "environment": "production",
+  "dependencies": {
+    "database": "up",
+    "redis": "not configured"
+  },
+  "resources": {
+    "memory": { "rss": "50 MB", "heapTotal": "30 MB", "heapUsed": "25 MB" },
+    "cpu": { "loadAverage": [1.2, 0.8, 0.5], "cpus": 4 },
+    "disk": { "free": "100 GB", "size": "500 GB" }
+  },
+  "details": {}
+}
 ```
 
-## Service Separation
-
-The following services have been extracted to separate, dedicated plugins:
-
-| Service | Plugin | Package |
-|---------|--------|---------|
-| Authentication/JWKS | xAuthJWSK | @xenterprises/fastify-xauth-jwks |
-| Geocoding | xGeocode | @xenterprises/fastify-xgeocode |
-| SMS/Email | xTwilio | @xenterprises/fastify-xtwilio (separate module) |
-| File Storage | xStorage | @xenterprises/fastify-xstorage (separate module) |
-| Payment Processing | xStripe | @xenterprises/fastify-xstripe (separate module) |
-
-## Development
-
-### Running Tests
+Returns `200` when healthy, `503` when degraded.
 
-```bash
-npm test
-```
-
-### Starting Development Server
+## Environment Variables
 
-```bash
-npm run dev
+| Name | Required | Description |
+|------|----------|-------------|
+| `NODE_ENV` | No | `development` or `production` (affects error stack traces, CORS defaults) |
+| `PORT` | No | Server port (default: `3000`) |
+| `FASTIFY_ADDRESS` | No | Server bind address (default: `0.0.0.0`) |
+| `CORS_ORIGIN` | No | Comma-separated CORS origins for production |
+| `RATE_LIMIT_MAX` | No | Max requests per window (default: `100`) |
+| `RATE_LIMIT_TIME_WINDOW` | No | Rate limit window (default: `1 minute`) |
+| `BUGSNAG_API_KEY` | If bugsnag active | Bugsnag project API key |
+| `DATABASE_URL` | If prisma active | Database connection string |
+
+## Error Reference
+
+| Error | When |
+|-------|------|
+| `[xConfig] professional must be a boolean` | `professional` option is not a boolean |
+| `[xConfig] fancyErrors must be a boolean` | `fancyErrors` option is not a boolean |
+| `[xConfig] prisma.client is required - pass your PrismaClient class from your generated client` | Prisma is active but `client` not provided |
+| `[xConfig] prisma.client must be a PrismaClient constructor` | `prisma.client` is not a function/class |
+| `[xConfig] bugsnag.apiKey is required and must be a string` | Bugsnag is active but `apiKey` missing or not a string |
+
+## Fancy Error Response Format
+
+When `fancyErrors: true` (default), unhandled errors return:
+
+```json
+{
+  "status": 500,
+  "message": "Error description",
+  "stack": "..."
+}
 ```
 
-The development server watches for file changes and auto-restarts.
+The `stack` field is only included when `NODE_ENV !== "production"`.
 
-### Starting Production Server
+## How It Works
 
-```bash
-npm start
-```
-
-## Architecture
-
-```
-fastify app
-    ↓
-    └─→ xConfig (core middleware & config)
-            ├─→ @fastify/cors
-            ├─→ @fastify/rate-limit
-            ├─→ @fastify/multipart
-            ├─→ @fastify/under-pressure
-            ├─→ @fastify/sensible
-            ├─→ fastify-bugsnag (optional)
-            └─→ Prisma client
-```
+xConfig is a single Fastify plugin that orchestrates registration of multiple sub-plugins in a specific order:
 
-## Dependencies
+1. **Prisma** — decorates `fastify.prisma` with a connected PrismaClient and registers an `onClose` hook to disconnect on shutdown.
+2. **Middleware** — registers CORS, under-pressure monitoring, rate limiting, and multipart handling (each skippable via `active: false`).
+3. **Bugsnag** — optional error tracking that integrates with the fancy error handler.
+4. **Fancy Errors** — sets a custom `errorHandler` that normalizes error responses and optionally reports to Bugsnag.
+5. **@fastify/sensible** — adds `.httpErrors`, `.to()`, and other HTTP utilities.
+6. **Utilities** — registers `xEcho`, `xSlugify`, `xRandomUUID`, and `xFormatBytes` decorators.
+7. **Health Check** — registers `GET /health` with dependency checks (database, redis), resource monitoring (memory, CPU, disk), and environment validation.
+8. **Lifecycle** — sets up route listing on startup (unless `professional: true`) and a goodbye log on shutdown.
 
-- `fastify` (^5.0.0) - Web framework
-- `@fastify/cors` - CORS middleware
-- `@fastify/rate-limit` - Rate limiting
-- `@fastify/multipart` - Multipart form handling
-- `@fastify/sensible` - HTTP utilities
-- `@fastify/under-pressure` - Back pressure handling
-- `@prisma/client` - ORM for database access
-- `fastify-bugsnag` - Error tracking (optional)
-- `fastify-plugin` - Plugin wrapper
-- `uncrypto` - Crypto utilities
-- `check-disk-space` - Disk space monitoring
+The plugin is wrapped with `fastify-plugin` so all decorators and routes are available in the parent scope.
 
 ## License
 
-ISC
+UNLICENSED

package/examples/.env.example

@@ -0,0 +1,17 @@
+# Server
+PORT=3000
+FASTIFY_ADDRESS=0.0.0.0
+NODE_ENV=development
+
+# CORS
+CORS_ORIGIN=http://localhost:3000,http://localhost:3001
+
+# Rate Limiting
+RATE_LIMIT_MAX=100
+RATE_LIMIT_TIME_WINDOW=1 minute
+
+# Bugsnag (optional)
+# BUGSNAG_API_KEY=your-bugsnag-api-key
+
+# Database (required only if prisma.active is true)
+# DATABASE_URL=postgresql://user:password@localhost:5432/mydb

package/examples/basic.js

@@ -0,0 +1,127 @@
+/**
+ * fastify-x-config — Basic Example
+ *
+ * Demonstrates all features of the xConfig plugin:
+ * - CORS, rate limiting, multipart, under-pressure middleware
+ * - Fancy error handling
+ * - Health check endpoint
+ * - Utility decorators: xEcho, xSlugify, xRandomUUID, xFormatBytes
+ *
+ * Run: node examples/basic.js
+ * Requires: .env or environment variables (see .env.example)
+ */
+
+import Fastify from "fastify";
+import xConfig from "../src/xConfig.js";
+
+const fastify = Fastify({
+  logger: true,
+});
+
+// ─── Register xConfig with all options ───────────────────────────────────────
+
+await fastify.register(xConfig, {
+  // Disable route listing in production
+  professional: process.env.NODE_ENV === "production",
+
+  // Enable fancy error formatting (default: true)
+  fancyErrors: true,
+
+  // Prisma — disabled for this demo; pass { client: PrismaClient } to enable
+  prisma: { active: false },
+
+  // Bugsnag — disabled for this demo; pass { apiKey: "..." } to enable
+  bugsnag: { active: false },
+
+  // CORS configuration
+  cors: {
+    origin: process.env.CORS_ORIGIN
+      ? process.env.CORS_ORIGIN.split(",")
+      : ["http://localhost:3000"],
+    credentials: true,
+  },
+
+  // Rate limiting
+  rateLimit: {
+    max: parseInt(process.env.RATE_LIMIT_MAX || "100", 10),
+    timeWindow: process.env.RATE_LIMIT_TIME_WINDOW || "1 minute",
+  },
+
+  // Multipart file uploads
+  multipart: {
+    limits: {
+      fileSize: 52428800, // 50 MB
+    },
+  },
+
+  // Back-pressure monitoring
+  underPressure: {
+    maxEventLoopDelay: 1000,
+    maxHeapUsedBytes: 1_000_000_000,
+    maxRssBytes: 1_000_000_000,
+  },
+});
+
+// ─── 1. Health check (auto-registered by xConfig at /health) ─────────────────
+
+// Try: curl http://localhost:3000/health
+
+// ─── 2. xEcho — simple ping utility ─────────────────────────────────────────
+
+fastify.get("/echo", async () => {
+  return { message: fastify.xEcho() };
+});
+
+// ─── 3. xSlugify — URL-safe slugification ───────────────────────────────────
+
+fastify.get("/slug/:text", async (request) => {
+  const { text } = request.params;
+  return {
+    original: text,
+    slug: fastify.xSlugify(text),
+  };
+});
+
+// ─── 4. xRandomUUID — UUID generation ───────────────────────────────────────
+
+fastify.get("/uuid", async () => {
+  return {
+    uuid: fastify.xRandomUUID(),
+    // xGenerateUUID is also available as an alias
+    uuid2: fastify.xGenerateUUID(),
+  };
+});
+
+// ─── 5. xFormatBytes — human-readable byte formatting ───────────────────────
+
+fastify.get("/format-bytes/:bytes", async (request) => {
+  const bytes = parseInt(request.params.bytes, 10);
+  return {
+    bytes,
+    formatted: fastify.xFormatBytes(bytes),
+  };
+});
+
+// ─── 6. Fancy error handling demo ────────────────────────────────────────────
+
+fastify.get("/error", async () => {
+  throw new Error("This demonstrates fancy error formatting");
+});
+
+fastify.get("/error/:code", async (request) => {
+  const err = new Error(`Custom ${request.params.code} error`);
+  err.statusCode = parseInt(request.params.code, 10);
+  throw err;
+});
+
+// ─── Start server ────────────────────────────────────────────────────────────
+
+const port = parseInt(process.env.PORT || "3000", 10);
+const address = process.env.FASTIFY_ADDRESS || "0.0.0.0";
+
+try {
+  await fastify.listen({ port, host: address });
+} catch (err) {
+  fastify.log.error(err);
+  process.exit(1);
+}

package/index.d.ts

@@ -0,0 +1,75 @@
+import { FastifyPluginAsync } from 'fastify';
+
+declare module 'fastify' {
+  interface FastifyInstance {
+    /** Prisma client instance (only available if prisma option is active) */
+    prisma?: any;
+    /** Returns "Hello from X Enterprises!" */
+    xEcho(): string;
+    /** Converts a string to a URL-safe slug */
+    xSlugify(input: string | number): string;
+    /** Generates a UUID v4 string */
+    xRandomUUID(): string;
+    /** Generates a UUID v4 string (alias for xRandomUUID) */
+    xGenerateUUID(): string;
+    /** Formats bytes into a human-readable string (e.g. "1.5 MB") */
+    xFormatBytes(bytes: number, decimals?: number): string;
+  }
+}
+
+interface XConfigCorsOptions {
+  active?: boolean;
+  origin?: string | string[] | boolean;
+  credentials?: boolean;
+  methods?: string[];
+  [key: string]: any;
+}
+
+interface XConfigRateLimitOptions {
+  active?: boolean;
+  max?: number;
+  timeWindow?: string | number;
+  [key: string]: any;
+}
+
+interface XConfigMultipartOptions {
+  active?: boolean;
+  limits?: {
+    fileSize?: number;
+    [key: string]: any;
+  };
+  [key: string]: any;
+}
+
+interface XConfigUnderPressureOptions {
+  active?: boolean;
+  maxEventLoopDelay?: number;
+  maxHeapUsedBytes?: number;
+  maxRssBytes?: number;
+  [key: string]: any;
+}
+
+interface XConfigPrismaOptions {
+  active?: boolean;
+  client?: any;
+  [key: string]: any;
+}
+
+interface XConfigBugsnagOptions {
+  active?: boolean;
+  apiKey?: string;
+}
+
+interface XConfigOptions {
+  professional?: boolean;
+  fancyErrors?: boolean;
+  prisma?: XConfigPrismaOptions;
+  bugsnag?: XConfigBugsnagOptions;
+  cors?: XConfigCorsOptions;
+  rateLimit?: XConfigRateLimitOptions;
+  multipart?: XConfigMultipartOptions;
+  underPressure?: XConfigUnderPressureOptions;
+}
+
+declare const xConfig: FastifyPluginAsync<XConfigOptions>;
+export default xConfig;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xenterprises/fastify-xconfig",
   "type": "module",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "description": "Fastify configuration plugin for setting up middleware, services, and route handling.",
   "main": "src/xConfig.js",
   "scripts": {
@@ -10,7 +10,7 @@
     "test": "node --test test/xConfig.test.js"
   },
   "author": "Tim Mushen",
-  "license": "ISC",
+  "license": "UNLICENSED",
   "repository": {
     "type": "git",
     "url": "https://gitlab.com/x-enterprises/fastify-plugins/fastify-x-config"
@@ -33,14 +33,18 @@
     "@fastify/rate-limit": "^10.0.0",
     "@fastify/sensible": "^6.0.0",
     "@fastify/under-pressure": "^9.0.0",
-    "@prisma/client": "^7.3.0",
     "check-disk-space": "^3.4.0",
-    "fastify": "^5.1.0",
     "fastify-bugsnag": "^5.0.0",
     "fastify-plugin": "^5.0.0",
     "uncrypto": "^0.1.3"
   },
   "peerDependencies": {
-    "fastify": "^5.0.0"
+    "fastify": ">=5.0.0",
+    "@prisma/client": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@prisma/client": {
+      "optional": true
+    }
   }
 }

package/src/integrations/prisma.js

@@ -1,24 +1,20 @@
 export async function setupPrisma(fastify, options) {
-  if (options.active !== false) {
-    const { client: PrismaClient, active, ...prismaOptions } = options;
-    if (!PrismaClient) {
-      throw new Error("prisma.client is required - pass your PrismaClient class from your generated client");
-    }
+  if (options.active === false) return;
 
-    const prisma = new PrismaClient(prismaOptions);
-
-    fastify.decorate("prisma", prisma);
-
-    fastify.addHook("onClose", async () => {
-      await fastify.prisma.$disconnect();
-    });
-
-    console.info("   ✅ Prisma Enabled");
+  const { client: PrismaClient, active, ...prismaOptions } = options;
+  if (!PrismaClient) {
+    throw new Error("[xConfig] prisma.client is required - pass your PrismaClient class from your generated client");
   }
+  if (typeof PrismaClient !== 'function') {
+    throw new Error("[xConfig] prisma.client must be a PrismaClient constructor");
+  }
+
+  const prisma = new PrismaClient(prismaOptions);
+  fastify.decorate("prisma", prisma);
 
   fastify.addHook("onClose", async () => {
-    if (fastify.prisma) {
-      await fastify.prisma.$disconnect();
-    }
+    await fastify.prisma.$disconnect();
   });
+
+  fastify.log.info("[xConfig] Prisma enabled");
 }