@friggframework/core 2.0.0-next.5 → 2.0.0-next.51

package/integrations/options.js

@@ -1,5 +1,5 @@
 const { RequiredPropertyError } = require('../errors');
-const { get, getAndVerifyType } = require('../assertions');
+const { get } = require('../assertions');
 
 class Options {
     constructor(params) {

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

@@ -0,0 +1,50 @@
+const {
+    IntegrationMappingRepositoryMongo,
+} = require('./integration-mapping-repository-mongo');
+const {
+    IntegrationMappingRepositoryPostgres,
+} = require('./integration-mapping-repository-postgres');
+const config = require('../../database/config');
+
+/**
+ * Integration Mapping Repository Factory
+ * Creates the appropriate repository adapter based on database type
+ *
+ * Database-specific implementations:
+ * - MongoDB: Uses String IDs (ObjectId), no conversion needed
+ * - PostgreSQL: Uses Int IDs, converts String ↔ Int
+ *
+ * All repository methods return String IDs regardless of database type,
+ * ensuring application layer consistency.
+ *
+ * Usage:
+ * ```javascript
+ * const repository = createIntegrationMappingRepository();
+ * const mapping = await repository.findMappingBy(integrationId, sourceId);
+ * ```
+ *
+ * @returns {IntegrationMappingRepositoryInterface} Configured repository adapter
+ */
+function createIntegrationMappingRepository() {
+    const dbType = config.DB_TYPE;
+
+    switch (dbType) {
+        case 'mongodb':
+            return new IntegrationMappingRepositoryMongo();
+
+        case 'postgresql':
+            return new IntegrationMappingRepositoryPostgres();
+
+        default:
+            throw new Error(
+                `Unsupported database type: ${dbType}. Supported values: 'mongodb', 'postgresql'`
+            );
+    }
+}
+
+module.exports = {
+    createIntegrationMappingRepository,
+    // Export adapters for direct testing
+    IntegrationMappingRepositoryMongo,
+    IntegrationMappingRepositoryPostgres,
+};

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

@@ -0,0 +1,106 @@
+/**
+ * Integration Mapping Repository Interface
+ * Abstract base class defining the contract for integration mapping persistence adapters
+ *
+ * This follows the Port in Hexagonal Architecture:
+ * - Domain layer depends on this abstraction
+ * - Concrete adapters implement this interface
+ * - Use cases receive repositories via dependency injection
+ *
+ * Note: Currently, IntegrationMapping model has identical structure across MongoDB and PostgreSQL,
+ * so IntegrationMappingRepository serves both. This interface exists for consistency and
+ * future-proofing if database-specific implementations become needed.
+ *
+ * @abstract
+ */
+class IntegrationMappingRepositoryInterface {
+    /**
+     * Find mapping by integration ID and source ID
+     *
+     * @param {string|number} integrationId - The integration ID
+     * @param {string} sourceId - The source ID for lookup
+     * @returns {Promise<Object|null>} The mapping object or null
+     * @abstract
+     */
+    async findMappingBy(integrationId, sourceId) {
+        throw new Error('Method findMappingBy must be implemented by subclass');
+    }
+
+    /**
+     * Create or update a mapping
+     *
+     * @param {string|number} integrationId - The integration ID
+     * @param {string} sourceId - The source ID for lookup
+     * @param {Object} mapping - The mapping data
+     * @returns {Promise<Object>} The created or updated mapping document
+     * @abstract
+     */
+    async upsertMapping(integrationId, sourceId, mapping) {
+        throw new Error('Method upsertMapping must be implemented by subclass');
+    }
+
+    /**
+     * Find all mappings for an integration
+     *
+     * @param {string|number} integrationId - The integration ID
+     * @returns {Promise<Array>} Array of mapping objects
+     * @abstract
+     */
+    async findMappingsByIntegration(integrationId) {
+        throw new Error(
+            'Method findMappingsByIntegration must be implemented by subclass'
+        );
+    }
+
+    /**
+     * Delete a specific mapping
+     *
+     * @param {string|number} integrationId - The integration ID
+     * @param {string} sourceId - The source ID
+     * @returns {Promise<Object>} Deletion result
+     * @abstract
+     */
+    async deleteMapping(integrationId, sourceId) {
+        throw new Error('Method deleteMapping must be implemented by subclass');
+    }
+
+    /**
+     * Delete all mappings for an integration
+     *
+     * @param {string|number} integrationId - The integration ID
+     * @returns {Promise<Object>} Deletion result
+     * @abstract
+     */
+    async deleteMappingsByIntegration(integrationId) {
+        throw new Error(
+            'Method deleteMappingsByIntegration must be implemented by subclass'
+        );
+    }
+
+    /**
+     * Find mapping by ID
+     *
+     * @param {string|number} id - The mapping ID
+     * @returns {Promise<Object|null>} The mapping object or null
+     * @abstract
+     */
+    async findMappingById(id) {
+        throw new Error(
+            'Method findMappingById must be implemented by subclass'
+        );
+    }
+
+    /**
+     * Update a mapping by ID
+     *
+     * @param {string|number} id - The mapping ID
+     * @param {Object} updates - Fields to update
+     * @returns {Promise<Object>} Updated mapping object
+     * @abstract
+     */
+    async updateMapping(id, updates) {
+        throw new Error('Method updateMapping must be implemented by subclass');
+    }
+}
+
+module.exports = { IntegrationMappingRepositoryInterface };

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

@@ -0,0 +1,161 @@
+const { prisma } = require('../../database/prisma');
+const {
+    IntegrationMappingRepositoryInterface,
+} = require('./integration-mapping-repository-interface');
+
+/**
+ * MongoDB Integration Mapping Repository Adapter
+ * Handles persistence of integration mappings used for data transformation
+ *
+ * MongoDB-specific characteristics:
+ * - Uses String IDs (ObjectId)
+ * - No ID conversion needed (IDs are already strings)
+ * - mapping data stored in JSON field
+ */
+class IntegrationMappingRepositoryMongo extends IntegrationMappingRepositoryInterface {
+    constructor() {
+        super();
+        this.prisma = prisma;
+    }
+
+    /**
+     * Convert any value to string (handles null/undefined)
+     * @private
+     * @param {*} value - Value to convert
+     * @returns {string|null|undefined} String value or null/undefined
+     */
+    _toString(value) {
+        if (value === null || value === undefined) return value;
+        return String(value);
+    }
+
+    /**
+     * Find mapping by integration ID and source ID
+     * Replaces: IntegrationMapping.findBy(integrationId, sourceId)
+     *
+     * @param {string} integrationId - The integration ID
+     * @param {string} sourceId - The source ID for lookup
+     * @returns {Promise<Object|null>} The mapping object with string IDs or null
+     */
+    async findMappingBy(integrationId, sourceId) {
+        return await this.prisma.integrationMapping.findFirst({
+            where: {
+                integrationId,
+                sourceId: this._toString(sourceId),
+            },
+        });
+    }
+
+    /**
+     * Create or update a mapping
+     * Replaces: IntegrationMapping.upsert(integrationId, sourceId, mapping)
+     *
+     * @param {string} integrationId - The integration ID
+     * @param {string} sourceId - The source ID for lookup
+     * @param {Object} mapping - The mapping data
+     * @returns {Promise<Object>} The created or updated mapping document with string IDs
+     */
+    async upsertMapping(integrationId, sourceId, mapping) {
+        return await this.prisma.integrationMapping.upsert({
+            where: {
+                integrationId_sourceId: {
+                    integrationId,
+                    sourceId: this._toString(sourceId),
+                },
+            },
+            update: {
+                mapping,
+            },
+            create: {
+                integrationId,
+                sourceId: this._toString(sourceId),
+                mapping,
+            },
+        });
+    }
+
+    /**
+     * Find all mappings for an integration
+     * Replaces: IntegrationMapping.find({ integration: integrationId })
+     *
+     * @param {string} integrationId - The integration ID
+     * @returns {Promise<Array>} Array of mapping documents with string IDs
+     */
+    async findMappingsByIntegration(integrationId) {
+        return await this.prisma.integrationMapping.findMany({
+            where: { integrationId },
+        });
+    }
+
+    /**
+     * Delete a mapping by integration and source ID
+     * Replaces: IntegrationMapping.deleteOne({ integration, sourceId })
+     *
+     * @param {string} integrationId - The integration ID
+     * @param {string} sourceId - The source ID
+     * @returns {Promise<Object>} The deletion result
+     */
+    async deleteMapping(integrationId, sourceId) {
+        try {
+            await this.prisma.integrationMapping.delete({
+                where: {
+                    integrationId_sourceId: {
+                        integrationId,
+                        sourceId: this._toString(sourceId),
+                    },
+                },
+            });
+            return { acknowledged: true, deletedCount: 1 };
+        } catch (error) {
+            if (error.code === 'P2025') {
+                // Record not found
+                return { acknowledged: true, deletedCount: 0 };
+            }
+            throw error;
+        }
+    }
+
+    /**
+     * Delete all mappings for an integration
+     * Replaces: IntegrationMapping.deleteMany({ integration: integrationId })
+     *
+     * @param {string} integrationId - The integration ID
+     * @returns {Promise<Object>} The deletion result
+     */
+    async deleteMappingsByIntegration(integrationId) {
+        const result = await this.prisma.integrationMapping.deleteMany({
+            where: { integrationId },
+        });
+
+        return {
+            acknowledged: true,
+            deletedCount: result.count,
+        };
+    }
+
+    /**
+     * Find mapping by ID
+     * @param {string} id - Mapping ID
+     * @returns {Promise<Object|null>} Mapping object with string IDs or null
+     */
+    async findMappingById(id) {
+        return await this.prisma.integrationMapping.findUnique({
+            where: { id },
+        });
+    }
+
+    /**
+     * Update mapping by ID
+     * @param {string} id - Mapping ID
+     * @param {Object} updates - Fields to update
+     * @returns {Promise<Object>} Updated mapping object with string IDs
+     */
+    async updateMapping(id, updates) {
+        return await this.prisma.integrationMapping.update({
+            where: { id },
+            data: updates,
+        });
+    }
+}
+
+module.exports = { IntegrationMappingRepositoryMongo };

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

@@ -0,0 +1,227 @@
+const { prisma } = require('../../database/prisma');
+const {
+    IntegrationMappingRepositoryInterface,
+} = require('./integration-mapping-repository-interface');
+
+/**
+ * PostgreSQL Integration Mapping Repository Adapter
+ * Handles persistence of integration mappings used for data transformation
+ *
+ * PostgreSQL-specific characteristics:
+ * - Uses Int IDs with autoincrement
+ * - Requires ID conversion: String (app layer) ↔ Int (database)
+ * - All returned IDs are converted to strings for application layer consistency
+ */
+class IntegrationMappingRepositoryPostgres extends IntegrationMappingRepositoryInterface {
+    constructor() {
+        super();
+        this.prisma = prisma;
+    }
+
+    /**
+     * Convert string ID to integer for PostgreSQL queries
+     * @private
+     * @param {string|number|null|undefined} id - ID to convert
+     * @returns {number|null|undefined} Integer ID or null/undefined
+     * @throws {Error} If ID cannot be converted to integer
+     */
+    _stringToInt(id) {
+        if (id === null || id === undefined) return id;
+        const parsed = parseInt(id, 10);
+        if (isNaN(parsed)) {
+            throw new Error(`Invalid ID: ${id} cannot be converted to integer`);
+        }
+        return parsed;
+    }
+
+    /**
+     * Convert any value to string (handles null/undefined)
+     * @private
+     * @param {*} value - Value to convert
+     * @returns {string|null|undefined} String value or null/undefined
+     */
+    _toString(value) {
+        if (value === null || value === undefined) return value;
+        return String(value);
+    }
+
+    /**
+     * Convert integer to string for application layer
+     * @private
+     * @param {number|null|undefined} id - Integer ID from database
+     * @returns {string|null|undefined} String ID or null/undefined
+     */
+    _intToString(id) {
+        if (id === null || id === undefined) return id;
+        return id.toString();
+    }
+
+    /**
+     * Legacy alias for _stringToInt (for backward compatibility)
+     * @private
+     */
+    _convertId(id) {
+        return this._stringToInt(id);
+    }
+
+    /**
+     * Convert mapping object IDs to strings
+     * @private
+     * @param {Object|null} mapping - Mapping object from database
+     * @returns {Object|null} Mapping with string IDs
+     */
+    _convertMappingIds(mapping) {
+        if (!mapping) return mapping;
+        return {
+            ...mapping,
+            id: this._intToString(mapping.id),
+            integrationId: this._intToString(mapping.integrationId),
+        };
+    }
+
+    /**
+     * Find mapping by integration ID and source ID
+     * Replaces: IntegrationMapping.findBy(integrationId, sourceId)
+     *
+     * @param {string} integrationId - The integration ID (string from application layer)
+     * @param {string} sourceId - The source ID for lookup
+     * @returns {Promise<Object|null>} The mapping object with string IDs or null
+     */
+    async findMappingBy(integrationId, sourceId) {
+        const mapping = await this.prisma.integrationMapping.findFirst({
+            where: {
+                integrationId: this._stringToInt(integrationId),
+                sourceId: this._toString(sourceId),
+            },
+        });
+        return this._convertMappingIds(mapping);
+    }
+
+    /**
+     * Create or update a mapping
+     * Replaces: IntegrationMapping.upsert(integrationId, sourceId, mapping)
+     *
+     * @param {string} integrationId - The integration ID (string from application layer)
+     * @param {string} sourceId - The source ID for lookup
+     * @param {Object} mapping - The mapping data
+     * @returns {Promise<Object>} The created or updated mapping document with string IDs
+     */
+    async upsertMapping(integrationId, sourceId, mapping) {
+        const result = await this.prisma.integrationMapping.upsert({
+            where: {
+                integrationId_sourceId: {
+                    integrationId: this._stringToInt(integrationId),
+                    sourceId: this._toString(sourceId),
+                },
+            },
+            update: {
+                mapping,
+            },
+            create: {
+                integrationId: this._stringToInt(integrationId),
+                sourceId: this._toString(sourceId),
+                mapping,
+            },
+        });
+        return this._convertMappingIds(result);
+    }
+
+    /**
+     * Find all mappings for an integration
+     * Replaces: IntegrationMapping.find({ integration: integrationId })
+     *
+     * @param {string} integrationId - The integration ID (string from application layer)
+     * @returns {Promise<Array>} Array of mapping documents with string IDs
+     */
+    async findMappingsByIntegration(integrationId) {
+        const intIntegrationId = this._convertId(integrationId);
+        const mappings = await this.prisma.integrationMapping.findMany({
+            where: { integrationId: intIntegrationId },
+        });
+        return mappings.map((m) => this._convertMappingIds(m));
+    }
+
+    /**
+     * Delete a mapping by integration and source ID
+     * Replaces: IntegrationMapping.deleteOne({ integration, sourceId })
+     *
+     * @param {string} integrationId - The integration ID (string from application layer)
+     * @param {string} sourceId - The source ID
+     * @returns {Promise<Object>} The deletion result
+     */
+    async deleteMapping(integrationId, sourceId) {
+        try {
+            await this.prisma.integrationMapping.delete({
+                where: {
+                    integrationId_sourceId: {
+                        integrationId: this._stringToInt(integrationId),
+                        sourceId: this._toString(sourceId),
+                    },
+                },
+            });
+            return { acknowledged: true, deletedCount: 1 };
+        } catch (error) {
+            if (error.code === 'P2025') {
+                // Record not found
+                return { acknowledged: true, deletedCount: 0 };
+            }
+            throw error;
+        }
+    }
+
+    /**
+     * Delete all mappings for an integration
+     * Replaces: IntegrationMapping.deleteMany({ integration: integrationId })
+     *
+     * @param {string} integrationId - The integration ID (string from application layer)
+     * @returns {Promise<Object>} The deletion result
+     */
+    async deleteMappingsByIntegration(integrationId) {
+        const intIntegrationId = this._convertId(integrationId);
+        const result = await this.prisma.integrationMapping.deleteMany({
+            where: { integrationId: intIntegrationId },
+        });
+
+        return {
+            acknowledged: true,
+            deletedCount: result.count,
+        };
+    }
+
+    /**
+     * Find mapping by ID
+     * @param {string} id - Mapping ID (string from application layer)
+     * @returns {Promise<Object|null>} Mapping object with string IDs or null
+     */
+    async findMappingById(id) {
+        const intId = this._convertId(id);
+        const mapping = await this.prisma.integrationMapping.findUnique({
+            where: { id: intId },
+        });
+        return this._convertMappingIds(mapping);
+    }
+
+    /**
+     * Update mapping by ID
+     * @param {string} id - Mapping ID (string from application layer)
+     * @param {Object} updates - Fields to update (with string IDs from application layer)
+     * @returns {Promise<Object>} Updated mapping object with string IDs
+     */
+    async updateMapping(id, updates) {
+        const intId = this._convertId(id);
+
+        // Convert integrationId if present in updates
+        const data = { ...updates };
+        if (data.integrationId !== undefined) {
+            data.integrationId = this._convertId(data.integrationId);
+        }
+
+        const mapping = await this.prisma.integrationMapping.update({
+            where: { id: intId },
+            data,
+        });
+        return this._convertMappingIds(mapping);
+    }
+}
+
+module.exports = { IntegrationMappingRepositoryPostgres };

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

@@ -0,0 +1,156 @@
+const { prisma } = require('../../database/prisma');
+const {
+    IntegrationMappingRepositoryInterface,
+} = require('./integration-mapping-repository-interface');
+
+/**
+ * Prisma-based Integration Mapping Repository
+ * Handles persistence of integration mappings used for data transformation
+ *
+ * Works identically for both MongoDB and PostgreSQL:
+ * - MongoDB: String IDs with @db.ObjectId
+ * - PostgreSQL: Integer IDs with auto-increment
+ * - Both use same query patterns (no many-to-many differences)
+ *
+ * Migration from Mongoose:
+ * - Constructor injection of Prisma client
+ * - IntegrationMapping.findBy() → findFirst with where clause
+ * - IntegrationMapping.upsert() → Prisma upsert with unique constraint
+ * - mapping data stored in JSON field
+ */
+class IntegrationMappingRepository extends IntegrationMappingRepositoryInterface {
+    constructor(prismaClient = prisma) {
+        super();
+        this.prisma = prismaClient; // Allow injection for testing
+    }
+
+    /**
+     * Find mapping by integration ID and source ID
+     * Replaces: IntegrationMapping.findBy(integrationId, sourceId)
+     *
+     * @param {string} integrationId - The integration ID
+     * @param {string} sourceId - The source ID for lookup
+     * @returns {Promise<Object|null>} The mapping object or null
+     */
+    async findMappingBy(integrationId, sourceId) {
+        return await this.prisma.integrationMapping.findFirst({
+            where: {
+                integrationId,
+                sourceId,
+            },
+        });
+    }
+
+    /**
+     * Create or update a mapping
+     * Replaces: IntegrationMapping.upsert(integrationId, sourceId, mapping)
+     *
+     * @param {string} integrationId - The integration ID
+     * @param {string} sourceId - The source ID for lookup
+     * @param {Object} mapping - The mapping data
+     * @returns {Promise<Object>} The created or updated mapping document
+     */
+    async upsertMapping(integrationId, sourceId, mapping) {
+        return await this.prisma.integrationMapping.upsert({
+            where: {
+                integrationId_sourceId: {
+                    integrationId,
+                    sourceId,
+                },
+            },
+            update: {
+                mapping,
+            },
+            create: {
+                integrationId,
+                sourceId,
+                mapping,
+            },
+        });
+    }
+
+    /**
+     * Find all mappings for an integration
+     * Replaces: IntegrationMapping.find({ integration: integrationId })
+     *
+     * @param {string} integrationId - The integration ID
+     * @returns {Promise<Array>} Array of mapping documents
+     */
+    async findMappingsByIntegration(integrationId) {
+        return await this.prisma.integrationMapping.findMany({
+            where: { integrationId },
+        });
+    }
+
+    /**
+     * Delete a mapping by integration and source ID
+     * Replaces: IntegrationMapping.deleteOne({ integration, sourceId })
+     *
+     * @param {string} integrationId - The integration ID
+     * @param {string} sourceId - The source ID
+     * @returns {Promise<Object>} The deletion result
+     */
+    async deleteMapping(integrationId, sourceId) {
+        try {
+            await this.prisma.integrationMapping.delete({
+                where: {
+                    integrationId_sourceId: {
+                        integrationId,
+                        sourceId,
+                    },
+                },
+            });
+            return { acknowledged: true, deletedCount: 1 };
+        } catch (error) {
+            if (error.code === 'P2025') {
+                // Record not found
+                return { acknowledged: true, deletedCount: 0 };
+            }
+            throw error;
+        }
+    }
+
+    /**
+     * Delete all mappings for an integration
+     * Replaces: IntegrationMapping.deleteMany({ integration: integrationId })
+     *
+     * @param {string} integrationId - The integration ID
+     * @returns {Promise<Object>} The deletion result
+     */
+    async deleteMappingsByIntegration(integrationId) {
+        const result = await this.prisma.integrationMapping.deleteMany({
+            where: { integrationId },
+        });
+
+        return {
+            acknowledged: true,
+            deletedCount: result.count,
+        };
+    }
+
+    /**
+     * Find mapping by ID
+     * @param {string} id - Mapping ID
+     * @returns {Promise<Object|null>} Mapping object or null
+     */
+    async findMappingById(id) {
+        return await this.prisma.integrationMapping.findUnique({
+            where: { id },
+        });
+    }
+
+    /**
+     * Update mapping by ID
+     * @param {string} id - Mapping ID
+     * @param {Object} updates - Fields to update
+     * @returns {Promise<Object>} Updated mapping object
+     */
+    async updateMapping(id, updates) {
+        return await this.prisma.integrationMapping.update({
+            where: { id },
+            data: updates,
+        });
+    }
+}
+
+module.exports = { IntegrationMappingRepository };