@xenterprises/fastify-xconfig 2.1.1 → 2.1.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xenterprises/fastify-xconfig",
   "type": "module",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "description": "Fastify configuration plugin for setting up middleware, services, and route handling.",
   "main": "src/xConfig.js",
   "scripts": {

package/CHANGELOG.md

@@ -1,189 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-## [2.0.0] - 2025-12-28
-
-### BREAKING CHANGES
-
-This is a major version release with significant architectural changes.
-
-#### Removed Services
-
-The following services have been extracted to dedicated plugins and are **no longer** available in xConfig:
-
-- **SendGrid Integration** - Use `@xenterprises/fastify-xsendgrid` (planned) or implement separately
-- **Twilio Integration** - Use `@xenterprises/fastify-xtwilio` (planned) or implement separately
-- **Cloudinary Integration** - Use `@xenterprises/fastify-xstorage` (planned) or implement separately
-- **Stripe Integration** - Use `@xenterprises/fastify-xstripe` (planned) or implement separately
-- **Stack Auth Integration** - Use `@xenterprises/fastify-xauth-jwks` instead
-
-#### Configuration Changes
-
-The following options are **no longer supported** in xConfig registration:
-
-```javascript
-// ❌ These options are now REMOVED
-fastify.register(xConfig, {
-  sendGrid: { ... },      // REMOVED - use separate plugin
-  twilio: { ... },        // REMOVED - use separate plugin
-  cloudinary: { ... },    // REMOVED - use separate plugin
-  stripe: { ... },        // REMOVED - use separate plugin
-  auth: { ... },          // REMOVED - use xAuthJWSK plugin
-  geocode: { ... },       // REMOVED - use xGeocode plugin
-});
-```
-
-#### New Plugin-Based Architecture
-
-xConfig now focuses on core middleware only. Use these dedicated plugins for removed services:
-
-```javascript
-import Fastify from 'fastify';
-import xConfig from '@xenterprises/fastify-xconfig';
-import xAuthJWSK from '@xenterprises/fastify-xauth-jwks';
-import xGeocode from '@xenterprises/fastify-xgeocode';
-
-const fastify = Fastify();
-
-// Core config (middleware & database)
-await fastify.register(xConfig, {
-  prisma: {},
-  cors: { origin: ['https://example.com'] },
-  rateLimit: { max: 100, timeWindow: '1 minute' },
-});
-
-// Dedicated plugins for other services
-await fastify.register(xAuthJWSK, { /* config */ });
-await fastify.register(xGeocode, { /* config */ });
-```
-
-### Added
-
-- ✅ Enhanced CORS security - Environment-aware origin defaults
-  - Production: Only allows configured domain
-  - Development: Allows localhost:3000 and localhost:3001
-- ✅ Improved health check endpoint - Better environment validation
-- ✅ Test suite - 8 comprehensive tests covering core functionality
-- ✅ Production hardening - Security audit and best practices applied
-
-### Changed
-
-- **Core Focus**: xConfig now provides only essential middleware and configuration
-- **Plugin Architecture**: Services moved to dedicated, focused plugins
-- **Dependencies**: Reduced from 22 to 11 (50% reduction)
-- **Bundle Size**: ~42% smaller with removed integrations
-- **Code Quality**: Improved maintainability and single responsibility
-
-### Fixed
-
-- ⚠️ Prisma disconnect hook - Now properly called only once on shutdown
-- ✅ Health endpoint - No longer fails when Prisma is disabled
-- ✅ Lifecycle hooks - Fixed "already listening" errors in test scenarios
-
-### Security
-
-- **npm audit**: 0 vulnerabilities
-- **CORS**: Secure defaults based on environment
-- **Error Handling**: Stack traces hidden in production
-- **Error Reporting**: Optional Bugsnag integration
-
-### Migration Guide
-
-#### Before (v1.x)
-
-```javascript
-fastify.register(xConfig, {
-  sendGrid: { apiKey: '...' },
-  twilio: { accountSid: '...', authToken: '...', phoneNumber: '...' },
-  cloudinary: { cloudName: '...' },
-  auth: { admin: { ... }, user: { ... } },
-  geocode: { apiKey: '...' },
-});
-```
-
-#### After (v2.0)
-
-```javascript
-// Step 1: Core config only
-fastify.register(xConfig, {
-  prisma: {},
-  cors: { active: true, origin: ['https://yourdomain.com'] },
-  rateLimit: { max: 100, timeWindow: '1 minute' },
-});
-
-// Step 2: Add service plugins
-fastify.register(xAuthJWSK, {
-  paths: { 
-    admin: { pathPattern: '/admin', jwksUrl: '...' },
-    api: { pathPattern: '/api', jwksUrl: '...' }
-  }
-});
-
-fastify.register(xGeocode, {
-  apiKey: process.env.GEOCODIO_API_KEY
-});
-
-// Step 3: Implement other services separately or wait for dedicated plugins
-// - Email: Use SendGrid SDK directly or wait for @xenterprises/fastify-xsendgrid
-// - SMS: Use Twilio SDK directly or wait for @xenterprises/fastify-xtwilio
-// - Storage: Use AWS S3 SDK directly or wait for @xenterprises/fastify-xstorage
-// - Payments: Use Stripe SDK directly or wait for @xenterprises/fastify-xstripe
-```
-
-### Deprecation Notes
-
-- The `auth` option is deprecated. Use `@xenterprises/fastify-xauth-jwks` instead
-- The `geocode` option is deprecated. Use `@xenterprises/fastify-xgeocode` instead
-- Stack Auth integration is deprecated. Use `@xenterprises/fastify-xauth-jwks` instead
-
-### Environment Variables
-
-**Removed** (no longer supported):
-- `ADMIN_STACK_PROJECT_ID`
-- `ADMIN_STACK_PUBLISHABLE_CLIENT_KEY`
-- `ADMIN_STACK_SECRET_SERVER_KEY`
-- `USER_STACK_PROJECT_ID`
-- `USER_STACK_PUBLISHABLE_CLIENT_KEY`
-- `USER_STACK_SECRET_SERVER_KEY`
-- `SENDGRID_API_KEY`
-- `SENDGRID_API_EMAIL_VALIDATION_KEY`
-- `SENDGRID_FROM_EMAIL`
-- `TWILIO_ACCOUNT_SID`
-- `TWILIO_AUTH_TOKEN`
-- `TWILIO_PHONE_NUMBER`
-- `CLOUDINARY_CLOUD_NAME`
-- `CLOUDINARY_API_KEY`
-- `CLOUDINARY_API_SECRET`
-- `CLOUDINARY_BASE_PATH`
-- `STRIPE_API_KEY`
-
-**Still Supported**:
-- `DATABASE_URL` - PostgreSQL connection string (if Prisma enabled)
-- `NODE_ENV` - Application environment
-- `PORT` - Server port
-- `FASTIFY_ADDRESS` - Server address
-- `BUGSNAG_API_KEY` - Error tracking (optional)
-- `CORS_ORIGIN` - Allowed CORS origins
-- `RATE_LIMIT_MAX` - Rate limit threshold
-- `RATE_LIMIT_TIME_WINDOW` - Rate limit window
-
-### Testing
-
-- ✅ All tests passing (8/8)
-- ✅ npm audit clean (0 vulnerabilities)
-- ✅ Production hardening complete
-- ✅ Graceful shutdown verified
-- ✅ Health endpoint validated
-
-### Dependencies Updated
-
-- Updated `@prisma/client` to ^7.2.0
-- All @fastify packages verified and up-to-date
-- Removed: @sendgrid/mail, @sendgrid/client, twilio, cloudinary, jose, stripe
-
----
-
-## [1.x] - Previous Versions
-
-See git history for previous releases.

package/server/app.js

@@ -1,43 +0,0 @@
-// server/app.js
-import Fastify from 'fastify';
-import xConfig from '../src/xConfig.js';  // Import your plugin correctly
-
-const fastify = Fastify();
-
-
-export default async function (fastify, opts) {
-  fastify.register(xConfig, {
-    professional: false,
-    fancyErrors: true,
-    prisma: {
-      active: false,
-    },
-    bugsnag: {
-      apiKey: process.env.BUGSNAG_API_KEY
-    },
-    rateLimit: {
-      max: process.env.RATE_LIMIT_MAX || 100,
-      timeWindow: process.env.RATE_LIMIT_TIME_WINDOW || '1 minute'
-    },
-    cors: {
-      active: true,
-      origin: process.env.CORS_ORIGIN || ['http://localhost:3000'],
-      credentials: true
-    },
-    multipart: {
-      limits: {
-        fileSize: 52428800 // 50MB
-      }
-    },
-    underPressure: {
-      maxEventLoopDelay: 1000,
-      maxHeapUsedBytes: 1000000000,
-      maxRssBytes: 1000000000
-    }
-  });  // Register the default export, which should be a function
-  fastify.get('/', async (request, reply) => {
-    console.log(fastify.xEcho())
-    return { status: fastify.xEcho() }
-  })
-
-};