@friggframework/core 2.0.0--canary.490.29e70f4.0 → 2.0.0--canary.490.1898b5d.0

package/credential/repositories/credential-repository-mongo.js

@@ -2,7 +2,7 @@ const { prisma } = require('../../database/prisma');
 const {
     CredentialRepositoryInterface,
 } = require('./credential-repository-interface');
-const { removeUndefinedValues } = require('../../database/utils/documentdb-compatibility');
+const { BaseRepositoryMongoDB } = require('../../database/repositories/base-repository-mongodb');
 
 /**
  * MongoDB Credential Repository Adapter
@@ -16,7 +16,10 @@ const { removeUndefinedValues } = require('../../database/utils/documentdb-compa
 class CredentialRepositoryMongo extends CredentialRepositoryInterface {
     constructor() {
         super();
-        this.prisma = prisma;
+        
+        // Use MongoDB base repository for DocumentDB compatibility
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient: prisma });
+        this.prisma = mongoBase.prisma;
     }
 
     /**
@@ -157,16 +160,14 @@ class CredentialRepositoryMongo extends CredentialRepositoryInterface {
         }
 
         // Create new credential
-        // Remove undefined values to prevent Prisma from using $$REMOVE (DocumentDB unsupported)
-        const credentialData = removeUndefinedValues({
-            userId: userId || user,
-            externalId,
-            authIsValid: authIsValid,
-            data: oauthData,
-        });
-        
+        // DocumentDB compatibility handled by BaseRepositoryMongoDB wrapper
         const created = await this.prisma.credential.create({
-            data: credentialData,
+            data: {
+                userId: userId || user,
+                externalId,
+                authIsValid: authIsValid,
+                data: oauthData,
+            },
         });
 
         return {

package/database/ARCHITECTURE.md

@@ -0,0 +1,201 @@
+# Database Layer Architecture
+
+## Hexagonal Architecture (Ports & Adapters)
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                        DOMAIN LAYER                              │
+│                    (Database Agnostic)                           │
+│                                                                  │
+│  ┌──────────────────────────────────────────────────────────┐  │
+│  │                    Use Cases                              │  │
+│  │  - CreateCredentialUseCase                               │  │
+│  │  - TestEncryptionUseCase                                 │  │
+│  │  - GetUserIntegrationsUseCase                            │  │
+│  └──────────────────────────────────────────────────────────┘  │
+│                            │                                     │
+│                            │ depends on                          │
+│                            ▼                                     │
+│  ┌──────────────────────────────────────────────────────────┐  │
+│  │              PORTS (Interfaces)                           │  │
+│  │  - CredentialRepositoryInterface                         │  │
+│  │  - UserRepositoryInterface                               │  │
+│  │  - IntegrationRepositoryInterface                        │  │
+│  └──────────────────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────────┘
+                            │
+                            │ implemented by
+                            ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                   INFRASTRUCTURE LAYER                           │
+│                      (Adapters)                                  │
+│                                                                  │
+│  ┌──────────────────────────────────────────────────────────┐  │
+│  │           MongoDB Adapters                                │  │
+│  │                                                           │  │
+│  │  BaseRepositoryMongoDB (DocumentDB compatibility)        │  │
+│  │           ▲                                               │  │
+│  │           │ extends                                       │  │
+│  │           │                                               │  │
+│  │  ┌────────┴────────┬────────────────┬──────────────┐    │  │
+│  │  │                 │                │              │    │  │
+│  │  CredentialRepo   UserRepo    IntegrationRepo  ModuleRepo│  │
+│  │  Mongo            Mongo       Mongo            Mongo    │  │
+│  └──────────────────────────────────────────────────────────┘  │
+│                                                                  │
+│  ┌──────────────────────────────────────────────────────────┐  │
+│  │         PostgreSQL Adapters                               │  │
+│  │                                                           │  │
+│  │  CredentialRepositoryPostgres                            │  │
+│  │  UserRepositoryPostgres                                  │  │
+│  │  IntegrationRepositoryPostgres                           │  │
+│  └──────────────────────────────────────────────────────────┘  │
+│                                                                  │
+│  ┌──────────────────────────────────────────────────────────┐  │
+│  │         Database Clients                                  │  │
+│  │                                                           │  │
+│  │  Prisma Client (core)                                    │  │
+│  │  ├── prisma-mongodb/schema.prisma                        │  │
+│  │  └── prisma-postgresql/schema.prisma                     │  │
+│  └──────────────────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Directory Structure
+
+```
+packages/core/
+├── credential/
+│   ├── use-cases/              # Domain layer
+│   └── repositories/           # Adapter layer
+│       ├── credential-repository-interface.js      # PORT
+│       ├── credential-repository-mongo.js          # ADAPTER (MongoDB)
+│       ├── credential-repository-postgres.js       # ADAPTER (PostgreSQL)
+│       └── credential-repository-factory.js        # Factory
+│
+├── database/
+│   ├── repositories/
+│   │   ├── base-repository-mongodb.js              # MongoDB adapter base
+│   │   ├── health-check-repository-interface.js   # PORT
+│   │   ├── health-check-repository-mongodb.js     # ADAPTER (MongoDB)
+│   │   └── health-check-repository-postgres.js    # ADAPTER (PostgreSQL)
+│   │
+│   ├── utils/
+│   │   ├── documentdb-compatibility.js             # DocumentDB utilities
+│   │   └── prisma-documentdb-wrapper.js            # Wrapper for adapters
+│   │
+│   ├── prisma.js                                   # Core Prisma client
+│   ├── prisma-mongodb/schema.prisma                # MongoDB schema
+│   └── prisma-postgresql/schema.prisma             # PostgreSQL schema
+│
+├── user/
+│   ├── use-cases/              # Domain layer
+│   └── repositories/           # Adapter layer
+│       ├── user-repository-interface.js            # PORT
+│       ├── user-repository-mongo.js                # ADAPTER (MongoDB)
+│       └── user-repository-postgres.js             # ADAPTER (PostgreSQL)
+│
+└── integrations/
+    ├── use-cases/              # Domain layer
+    └── repositories/           # Adapter layer
+        ├── integration-repository-interface.js     # PORT
+        ├── integration-repository-mongo.js         # ADAPTER (MongoDB)
+        └── integration-repository-postgres.js      # ADAPTER (PostgreSQL)
+```
+
+## Key Principles
+
+### 1. **Separation of Concerns**
+
+**Domain Layer (Use Cases):**
+- Business logic only
+- No database-specific code
+- Depends on repository interfaces (ports)
+
+**Infrastructure Layer (Repositories):**
+- Database-specific implementations
+- MongoDB adapters handle DocumentDB compatibility
+- PostgreSQL adapters handle PostgreSQL specifics
+
+### 2. **DocumentDB Compatibility Location**
+
+❌ **WRONG: Global wrapper in `prisma.js`**
+```javascript
+// This would leak infrastructure concerns into core
+const client = wrapPrismaForDocumentDB(new PrismaClient());
+```
+
+✅ **CORRECT: Adapter layer in MongoDB repositories**
+```javascript
+// DocumentDB is a MongoDB adapter concern
+class CredentialRepositoryMongo extends CredentialRepositoryInterface {
+    constructor() {
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient: prisma });
+        this.prisma = mongoBase.prisma;  // ← DocumentDB compatibility applied HERE
+    }
+}
+```
+
+### 3. **Why This Follows Hexagonal Architecture**
+
+**Port (Interface):**
+```javascript
+class CredentialRepositoryInterface {
+    async createCredential(data) {
+        throw new Error('Must be implemented by adapter');
+    }
+}
+```
+
+**Adapter (MongoDB with DocumentDB compatibility):**
+```javascript
+class CredentialRepositoryMongo extends CredentialRepositoryInterface {
+    constructor() {
+        // MongoDB-specific adapter wraps Prisma for DocumentDB
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient: prisma });
+        this.prisma = mongoBase.prisma;
+    }
+    
+    async createCredential(data) {
+        // DocumentDB compatibility handled by wrapper
+        return this.prisma.credential.create({ data });
+    }
+}
+```
+
+**Adapter (PostgreSQL - no DocumentDB concerns):**
+```javascript
+class CredentialRepositoryPostgres extends CredentialRepositoryInterface {
+    constructor() {
+        // PostgreSQL adapter uses Prisma directly (no DocumentDB concerns)
+        this.prisma = prisma;
+    }
+    
+    async createCredential(data) {
+        return this.prisma.credential.create({ data });
+    }
+}
+```
+
+### 4. **BaseRepositoryMongoDB Role**
+
+`BaseRepositoryMongoDB` is the **MongoDB adapter base class** that:
+- Encapsulates MongoDB/DocumentDB-specific concerns
+- Applies DocumentDB compatibility wrapper
+- Provides common MongoDB functionality
+- All MongoDB repositories extend it
+
+**This is NOT a generic base repository** - it's specifically for MongoDB adapters.
+
+## Summary
+
+✅ **You were right to question it!** The architecture is:
+
+- **`prisma-mongodb/`** - Schema definition (infrastructure)
+- **`repositories/*-mongo.js`** - MongoDB adapters (infrastructure)
+- **`BaseRepositoryMongoDB`** - MongoDB adapter base class (infrastructure)
+- **`repositories/*-interface.js`** - Ports (domain boundary)
+- **`use-cases/`** - Domain logic (core)
+
+DocumentDB compatibility belongs in the **MongoDB adapter layer**, which is exactly where we put it! 🎯
+

package/database/prisma.js

@@ -207,11 +207,6 @@ const prismaClientSingleton = () => {
         logger.info('Field-level encryption disabled');
     }
 
-    // Wrap Prisma client for DocumentDB compatibility
-    // Automatically removes undefined values to prevent $$REMOVE operator errors
-    const { wrapPrismaForDocumentDB } = require('./utils/prisma-documentdb-wrapper');
-    client = wrapPrismaForDocumentDB(client);
-
     return client;
 };
 

package/database/repositories/base-repository-mongodb.js

@@ -0,0 +1,25 @@
+/**
+ * Base MongoDB Repository
+ * 
+ * Provides DocumentDB-compatible Prisma client for MongoDB repositories.
+ * Follows Hexagonal Architecture - infrastructure adapter for MongoDB/DocumentDB.
+ * 
+ * All MongoDB repositories should extend this class to ensure DocumentDB compatibility.
+ */
+
+const { wrapPrismaForDocumentDB } = require('../utils/prisma-documentdb-wrapper');
+
+class BaseRepositoryMongoDB {
+    /**
+     * @param {Object} params
+     * @param {Object} params.prismaClient - Prisma client instance
+     */
+    constructor({ prismaClient }) {
+        // Wrap Prisma client for DocumentDB compatibility
+        // Only activates for DocumentDB connections (zero overhead for MongoDB)
+        this.prisma = wrapPrismaForDocumentDB(prismaClient);
+    }
+}
+
+module.exports = { BaseRepositoryMongoDB };
+

package/database/repositories/health-check-repository-mongodb.js

@@ -2,7 +2,7 @@ const { mongoose } = require('../mongoose');
 const {
     HealthCheckRepositoryInterface,
 } = require('./health-check-repository-interface');
-const { removeUndefinedValues } = require('../utils/documentdb-compatibility');
+const { BaseRepositoryMongoDB } = require('./base-repository-mongodb');
 
 class HealthCheckRepositoryMongoDB extends HealthCheckRepositoryInterface {
     /**
@@ -11,7 +11,10 @@ class HealthCheckRepositoryMongoDB extends HealthCheckRepositoryInterface {
      */
     constructor({ prismaClient }) {
         super();
-        this.prisma = prismaClient;
+        
+        // Use MongoDB base repository for DocumentDB compatibility
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient });
+        this.prisma = mongoBase.prisma;
     }
 
     /**
@@ -49,11 +52,9 @@ class HealthCheckRepositoryMongoDB extends HealthCheckRepositoryInterface {
     }
 
     async createCredential(credentialData) {
-        // Remove undefined values to prevent Prisma from using $$REMOVE (DocumentDB unsupported)
-        const cleanedData = removeUndefinedValues(credentialData);
-        
+        // DocumentDB compatibility handled by BaseRepositoryMongoDB wrapper
         return await this.prisma.credential.create({
-            data: cleanedData,
+            data: credentialData,
         });
     }
 

package/integrations/repositories/integration-mapping-repository-mongo.js

@@ -2,6 +2,7 @@ const { prisma } = require('../../database/prisma');
 const {
     IntegrationMappingRepositoryInterface,
 } = require('./integration-mapping-repository-interface');
+const { BaseRepositoryMongoDB } = require('../../database/repositories/base-repository-mongodb');
 
 /**
  * MongoDB Integration Mapping Repository Adapter
@@ -15,7 +16,10 @@ const {
 class IntegrationMappingRepositoryMongo extends IntegrationMappingRepositoryInterface {
     constructor() {
         super();
-        this.prisma = prisma;
+        
+        // Use MongoDB base repository for DocumentDB compatibility
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient: prisma });
+        this.prisma = mongoBase.prisma;
     }
 
     /**

package/integrations/repositories/integration-repository-mongo.js

@@ -2,6 +2,7 @@ const { prisma } = require('../../database/prisma');
 const {
     IntegrationRepositoryInterface,
 } = require('./integration-repository-interface');
+const { BaseRepositoryMongoDB } = require('../../database/repositories/base-repository-mongodb');
 
 /**
  * MongoDB Integration Repository Adapter
@@ -21,7 +22,10 @@ const {
 class IntegrationRepositoryMongo extends IntegrationRepositoryInterface {
     constructor() {
         super();
-        this.prisma = prisma;
+        
+        // Use MongoDB base repository for DocumentDB compatibility
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient: prisma });
+        this.prisma = mongoBase.prisma;
     }
 
     /**

package/integrations/repositories/process-repository-mongo.js

@@ -1,5 +1,6 @@
 const { prisma } = require('../../database/prisma');
 const { ProcessRepositoryInterface } = require('./process-repository-interface');
+const { BaseRepositoryMongoDB } = require('../../database/repositories/base-repository-mongodb');
 
 /**
  * MongoDB Process Repository Adapter
@@ -19,7 +20,10 @@ const { ProcessRepositoryInterface } = require('./process-repository-interface')
 class ProcessRepositoryMongo extends ProcessRepositoryInterface {
     constructor() {
         super();
-        this.prisma = prisma;
+        
+        // Use MongoDB base repository for DocumentDB compatibility
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient: prisma });
+        this.prisma = mongoBase.prisma;
     }
 
     /**

package/modules/repositories/module-repository-mongo.js

@@ -1,5 +1,6 @@
 const { prisma } = require('../../database/prisma');
 const { ModuleRepositoryInterface } = require('./module-repository-interface');
+const { BaseRepositoryMongoDB } = require('../../database/repositories/base-repository-mongodb');
 
 /**
  * MongoDB Module Repository Adapter
@@ -15,7 +16,10 @@ const { ModuleRepositoryInterface } = require('./module-repository-interface');
 class ModuleRepositoryMongo extends ModuleRepositoryInterface {
     constructor() {
         super();
-        this.prisma = prisma;
+        
+        // Use MongoDB base repository for DocumentDB compatibility
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient: prisma });
+        this.prisma = mongoBase.prisma;
     }
 
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@friggframework/core",
     "prettier": "@friggframework/prettier-config",
-    "version": "2.0.0--canary.490.29e70f4.0",
+    "version": "2.0.0--canary.490.1898b5d.0",
     "dependencies": {
         "@aws-sdk/client-apigatewaymanagementapi": "^3.588.0",
         "@aws-sdk/client-kms": "^3.588.0",
@@ -38,9 +38,9 @@
         }
     },
     "devDependencies": {
-        "@friggframework/eslint-config": "2.0.0--canary.490.29e70f4.0",
-        "@friggframework/prettier-config": "2.0.0--canary.490.29e70f4.0",
-        "@friggframework/test": "2.0.0--canary.490.29e70f4.0",
+        "@friggframework/eslint-config": "2.0.0--canary.490.1898b5d.0",
+        "@friggframework/prettier-config": "2.0.0--canary.490.1898b5d.0",
+        "@friggframework/test": "2.0.0--canary.490.1898b5d.0",
         "@prisma/client": "^6.17.0",
         "@types/lodash": "4.17.15",
         "@typescript-eslint/eslint-plugin": "^8.0.0",
@@ -80,5 +80,5 @@
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "29e70f49b632320b72f05d49fde3c254477139d2"
+    "gitHead": "1898b5d812df39fa3cd85a877428c9bb2255d093"
 }

package/syncs/repositories/sync-repository-mongo.js

@@ -1,5 +1,6 @@
 const { prisma } = require('../../database/prisma');
 const { SyncRepositoryInterface } = require('./sync-repository-interface');
+const { BaseRepositoryMongoDB } = require('../../database/repositories/base-repository-mongodb');
 
 /**
  * MongoDB Sync Repository Adapter
@@ -18,7 +19,10 @@ const { SyncRepositoryInterface } = require('./sync-repository-interface');
 class SyncRepositoryMongo extends SyncRepositoryInterface {
     constructor() {
         super();
-        this.prisma = prisma;
+        
+        // Use MongoDB base repository for DocumentDB compatibility
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient: prisma });
+        this.prisma = mongoBase.prisma;
     }
 
     /**

package/token/repositories/token-repository-mongo.js

@@ -1,6 +1,7 @@
 const { prisma } = require('../../database/prisma');
 const bcrypt = require('bcryptjs');
 const { TokenRepositoryInterface } = require('./token-repository-interface');
+const { BaseRepositoryMongoDB } = require('../../database/repositories/base-repository-mongodb');
 
 const BCRYPT_ROUNDS = 10;
 
@@ -16,7 +17,10 @@ const BCRYPT_ROUNDS = 10;
 class TokenRepositoryMongo extends TokenRepositoryInterface {
     constructor() {
         super();
-        this.prisma = prisma;
+        
+        // Use MongoDB base repository for DocumentDB compatibility
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient: prisma });
+        this.prisma = mongoBase.prisma;
     }
 
     /**

package/user/repositories/user-repository-mongo.js

@@ -4,6 +4,7 @@ const {
     createTokenRepository,
 } = require('../../token/repositories/token-repository-factory');
 const { UserRepositoryInterface } = require('./user-repository-interface');
+const { BaseRepositoryMongoDB } = require('../../database/repositories/base-repository-mongodb');
 
 /**
  * MongoDB User Repository Adapter
@@ -17,7 +18,10 @@ const { UserRepositoryInterface } = require('./user-repository-interface');
 class UserRepositoryMongo extends UserRepositoryInterface {
     constructor() {
         super();
-        this.prisma = prisma;
+        
+        // Use MongoDB base repository for DocumentDB compatibility
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient: prisma });
+        this.prisma = mongoBase.prisma;
         this.tokenRepository = createTokenRepository();
     }
 

package/websocket/repositories/websocket-connection-repository-mongo.js

@@ -6,6 +6,7 @@ const {
 const {
     WebsocketConnectionRepositoryInterface,
 } = require('./websocket-connection-repository-interface');
+const { BaseRepositoryMongoDB } = require('../../database/repositories/base-repository-mongodb');
 
 /**
  * MongoDB WebSocket Connection Repository Adapter
@@ -19,7 +20,10 @@ const {
 class WebsocketConnectionRepositoryMongo extends WebsocketConnectionRepositoryInterface {
     constructor() {
         super();
-        this.prisma = prisma;
+        
+        // Use MongoDB base repository for DocumentDB compatibility
+        const mongoBase = new BaseRepositoryMongoDB({ prismaClient: prisma });
+        this.prisma = mongoBase.prisma;
     }
 
     /**