@friggframework/core 2.0.0-next.41 → 2.0.0-next.42

package/application/commands/entity-commands.js

@@ -0,0 +1,315 @@
+const {
+    createModuleRepository,
+} = require('../../modules/repositories/module-repository-factory');
+
+const ERROR_CODE_MAP = {
+    ENTITY_NOT_FOUND: 404,
+    INVALID_ENTITY_DATA: 400,
+};
+
+function mapErrorToResponse(error) {
+    const status = ERROR_CODE_MAP[error?.code] || 500;
+    return {
+        error: status,
+        reason: error?.message,
+        code: error?.code,
+    };
+}
+
+/**
+ * Create entity command factory
+ *
+ * NOTE: This is an internal API. Integration developers should use createFriggCommands() instead.
+ *
+ * @returns {Object} Entity command object with CRUD operations
+ */
+function createEntityCommands() {
+    const moduleRepo = createModuleRepository();
+
+    return {
+        /**
+         * Create a new entity
+         * @param {Object} params
+         * @param {string} params.userId - User ID who owns this entity
+         * @param {string} params.externalId - External identifier from the API module
+         * @param {string} params.name - Entity name
+         * @param {string} params.moduleName - Module name (e.g., 'husbpot', 'frontify')
+         * @param {string} [params.credentialId] - Associated credential ID
+         * @returns {Promise<Object>} Created entity object
+         */
+        async createEntity({
+            userId,
+            externalId,
+            name,
+            moduleName,
+            credentialId,
+        } = {}) {
+            try {
+                if (!userId || !externalId || !moduleName) {
+                    const error = new Error(
+                        'userId, externalId, and moduleName are required'
+                    );
+                    error.code = 'INVALID_ENTITY_DATA';
+                    throw error;
+                }
+
+                const entityData = {
+                    user: userId,
+                    externalId,
+                    name,
+                    moduleName,
+                };
+
+                if (credentialId) {
+                    entityData.credential = credentialId;
+                }
+
+                const entity = await moduleRepo.createEntity(entityData);
+
+                return {
+                    id: entity.id,
+                    userId: entity.userId,
+                    externalId: entity.externalId,
+                    name: entity.name,
+                    moduleName: entity.moduleName,
+                    credentialId: entity.credential?._id
+                        ? entity.credential._id.toString()
+                        : entity.credential,
+                };
+            } catch (error) {
+                return mapErrorToResponse(error);
+            }
+        },
+
+        /**
+         * Find an entity by filter criteria
+         * @param {Object} filter
+         * @param {string} [filter.externalId] - External ID to search for
+         * @param {string} [filter.userId] - User ID to search for
+         * @param {string} [filter.moduleName] - Module name to search for
+         * @returns {Promise<Object|null>} Entity object or null if not found
+         */
+        async findEntity(filter = {}) {
+            try {
+                if (
+                    !filter.externalId &&
+                    !filter.userId &&
+                    !filter.moduleName
+                ) {
+                    const error = new Error(
+                        'At least one filter criterion is required'
+                    );
+                    error.code = 'INVALID_ENTITY_DATA';
+                    throw error;
+                }
+
+                const entity = await moduleRepo.findEntity(filter);
+
+                if (!entity) {
+                    return null;
+                }
+
+                return {
+                    id: entity.id,
+                    userId: entity.userId,
+                    externalId: entity.externalId,
+                    name: entity.name,
+                    moduleName: entity.moduleName,
+                    credentialId: entity.credential?._id
+                        ? entity.credential._id.toString()
+                        : entity.credential,
+                };
+            } catch (error) {
+                return mapErrorToResponse(error);
+            }
+        },
+
+        /**
+         * Find all entities for a user
+         * @param {string} userId - User ID to search for
+         * @returns {Promise<Array>} Array of entity objects
+         */
+        async findEntitiesByUserId(userId) {
+            try {
+                if (!userId) {
+                    const error = new Error('userId is required');
+                    error.code = 'INVALID_ENTITY_DATA';
+                    throw error;
+                }
+
+                const entities = await moduleRepo.findEntitiesByUserId(userId);
+
+                return entities.map((entity) => ({
+                    id: entity.id,
+                    userId: entity.userId,
+                    externalId: entity.externalId,
+                    name: entity.name,
+                    moduleName: entity.moduleName,
+                    credentialId: entity.credential?._id
+                        ? entity.credential._id.toString()
+                        : entity.credential,
+                }));
+            } catch (error) {
+                if (error.code) {
+                    return mapErrorToResponse(error);
+                }
+                // For find operations, return empty array on error instead of error object
+                return [];
+            }
+        },
+
+        /**
+         * Find entities by user ID and module name
+         * @param {string} userId - User ID to search for
+         * @param {string} moduleName - Module name to filter by
+         * @returns {Promise<Array>} Array of entity objects
+         */
+        async findEntitiesByUserIdAndModuleName(userId, moduleName) {
+            try {
+                if (!userId || !moduleName) {
+                    const error = new Error(
+                        'userId and moduleName are required'
+                    );
+                    error.code = 'INVALID_ENTITY_DATA';
+                    throw error;
+                }
+
+                const entities =
+                    await moduleRepo.findEntitiesByUserIdAndModuleName(
+                        userId,
+                        moduleName
+                    );
+
+                return entities.map((entity) => ({
+                    id: entity.id,
+                    userId: entity.userId,
+                    externalId: entity.externalId,
+                    name: entity.name,
+                    moduleName: entity.moduleName,
+                    credentialId: entity.credential?._id
+                        ? entity.credential._id.toString()
+                        : entity.credential,
+                }));
+            } catch (error) {
+                if (error.code) {
+                    return mapErrorToResponse(error);
+                }
+                return [];
+            }
+        },
+
+        /**
+         * Find an entity by ID
+         * @param {string} entityId - Entity ID to search for
+         * @returns {Promise<Object>} Entity object
+         */
+        async findEntityById(entityId) {
+            try {
+                if (!entityId) {
+                    const error = new Error('entityId is required');
+                    error.code = 'INVALID_ENTITY_DATA';
+                    throw error;
+                }
+
+                const entity = await moduleRepo.findEntityById(entityId);
+
+                return {
+                    id: entity.id,
+                    userId: entity.userId,
+                    externalId: entity.externalId,
+                    name: entity.name,
+                    moduleName: entity.moduleName,
+                    credentialId: entity.credential?._id
+                        ? entity.credential._id.toString()
+                        : entity.credential,
+                };
+            } catch (error) {
+                return mapErrorToResponse(error);
+            }
+        },
+
+        /**
+         * Update an entity
+         * @param {string} entityId - Entity ID to update
+         * @param {Object} updates - Fields to update
+         * @returns {Promise<Object>} Updated entity object
+         */
+        async updateEntity(entityId, updates) {
+            try {
+                if (!entityId) {
+                    const error = new Error('entityId is required');
+                    error.code = 'INVALID_ENTITY_DATA';
+                    throw error;
+                }
+
+                const entity = await moduleRepo.updateEntity(entityId, updates);
+
+                if (!entity) {
+                    const error = new Error(`Entity ${entityId} not found`);
+                    error.code = 'ENTITY_NOT_FOUND';
+                    throw error;
+                }
+
+                return {
+                    id: entity.id,
+                    userId: entity.userId,
+                    externalId: entity.externalId,
+                    name: entity.name,
+                    moduleName: entity.moduleName,
+                    credentialId: entity.credential?._id
+                        ? entity.credential._id.toString()
+                        : entity.credential,
+                };
+            } catch (error) {
+                return mapErrorToResponse(error);
+            }
+        },
+
+        /**
+         * Delete an entity
+         * @param {string} entityId - Entity ID to delete
+         * @returns {Promise<Object>} Result object with success flag
+         */
+        async deleteEntity(entityId) {
+            try {
+                if (!entityId) {
+                    const error = new Error('entityId is required');
+                    error.code = 'INVALID_ENTITY_DATA';
+                    throw error;
+                }
+
+                await moduleRepo.deleteEntity(entityId);
+
+                return { success: true };
+            } catch (error) {
+                return mapErrorToResponse(error);
+            }
+        },
+
+        /**
+         * Remove credential reference from an entity
+         * @param {string} entityId - Entity ID to update
+         * @returns {Promise<Object>} Result object with success flag
+         */
+        async unsetCredential(entityId) {
+            try {
+                if (!entityId) {
+                    const error = new Error('entityId is required');
+                    error.code = 'INVALID_ENTITY_DATA';
+                    throw error;
+                }
+
+                const acknowledged = await moduleRepo.unsetCredential(entityId);
+
+                return { success: acknowledged };
+            } catch (error) {
+                return mapErrorToResponse(error);
+            }
+        },
+    };
+}
+
+module.exports = {
+    createEntityCommands,
+    ERROR_CODE_MAP,
+};

package/application/commands/integration-commands.js

@@ -0,0 +1,160 @@
+const {
+    createIntegrationRepository,
+} = require('../../integrations/repositories/integration-repository-factory');
+const {
+    createModuleRepository,
+} = require('../../modules/repositories/module-repository-factory');
+const { ModuleFactory } = require('../../modules/module-factory');
+const {
+    LoadIntegrationContextUseCase,
+} = require('../../integrations/use-cases/load-integration-context');
+const {
+    FindIntegrationContextByExternalEntityIdUseCase,
+} = require('../../integrations/use-cases/find-integration-context-by-external-entity-id');
+const {
+    GetIntegrationsForUser,
+} = require('../../integrations/use-cases/get-integrations-for-user');
+const {
+    CreateIntegration,
+} = require('../../integrations/use-cases/create-integration');
+const {
+    getModulesDefinitionFromIntegrationClasses,
+} = require('../../integrations/utils/map-integration-dto');
+
+const ERROR_CODE_MAP = {
+    ENTITY_NOT_FOUND: 401,
+    ENTITY_USER_NOT_FOUND: 401,
+    INTEGRATION_NOT_FOUND: 404,
+    EXTERNAL_ENTITY_ID_REQUIRED: 400,
+    INTEGRATION_RECORD_NOT_FOUND: 404,
+};
+
+function mapErrorToResponse(error) {
+    const status = ERROR_CODE_MAP[error?.code] || 500;
+    return {
+        error: status,
+        reason: error?.message,
+        code: error?.code,
+    };
+}
+
+function createIntegrationCommands({ integrationClass } = {}) {
+    if (!integrationClass) {
+        throw new Error('integrationClass is required');
+    }
+
+    // Always use Frigg's default repositories and use cases
+    const integrationRepository = createIntegrationRepository();
+    const moduleRepository = createModuleRepository();
+
+    const moduleDefinitions = getModulesDefinitionFromIntegrationClasses([
+        integrationClass,
+    ]);
+
+    const moduleFactory = new ModuleFactory({
+        moduleRepository,
+        moduleDefinitions,
+    });
+
+    const loadIntegrationContextUseCase = new LoadIntegrationContextUseCase({
+        integrationRepository,
+        moduleRepository,
+        moduleFactory,
+    });
+
+    const findByExternalEntityIdUseCase =
+        new FindIntegrationContextByExternalEntityIdUseCase({
+            integrationRepository,
+            moduleRepository,
+            loadIntegrationContextUseCase: loadIntegrationContextUseCase,
+        });
+
+    const getIntegrationsForUserUseCase = new GetIntegrationsForUser({
+        integrationRepository,
+        integrationClasses: [integrationClass],
+        moduleFactory,
+        moduleRepository,
+    });
+
+    const createIntegrationUseCase = new CreateIntegration({
+        integrationRepository,
+        integrationClasses: [integrationClass],
+        moduleFactory,
+    });
+
+    return {
+        async findIntegrationContextByExternalEntityId(externalEntityId) {
+            try {
+                const { context } = await findByExternalEntityIdUseCase.execute(
+                    {
+                        externalEntityId,
+                    }
+                );
+                return { context };
+            } catch (error) {
+                return mapErrorToResponse(error);
+            }
+        },
+
+        async loadIntegrationContextById(integrationId) {
+            try {
+                const context = await loadIntegrationContextUseCase.execute({
+                    integrationId,
+                });
+                return { context };
+            } catch (error) {
+                return mapErrorToResponse(error);
+            }
+        },
+
+        /**
+         * Find all integrations for a user
+         * @param {string} userId - User ID to search for
+         * @returns {Promise<Array>} Array of integration records
+         */
+        async findIntegrationsByUserId(userId) {
+            try {
+                const integrations =
+                    await getIntegrationsForUserUseCase.execute(userId);
+                return integrations;
+            } catch (error) {
+                return mapErrorToResponse(error);
+            }
+        },
+
+        /**
+         * Create a new integration
+         * @param {Object} params
+         * @param {Array<string>} params.entityIds - Array of entity IDs
+         * @param {string} params.userId - User ID
+         * @param {Object} params.config - Integration configuration (must include type)
+         * @returns {Promise<Object>} Created integration object
+         */
+        async createIntegration({ entityIds, userId, config }) {
+            try {
+                const integration = await createIntegrationUseCase.execute(
+                    entityIds,
+                    userId,
+                    config
+                );
+                return integration;
+            } catch (error) {
+                return mapErrorToResponse(error);
+            }
+        },
+    };
+}
+
+async function findIntegrationContextByExternalEntityId({
+    integrationClass,
+    externalEntityId,
+} = {}) {
+    const commands = createIntegrationCommands({ integrationClass });
+
+    return commands.findIntegrationContextByExternalEntityId(externalEntityId);
+}
+
+module.exports = {
+    createIntegrationCommands,
+    findIntegrationContextByExternalEntityId,
+};

package/application/commands/integration-commands.test.js

@@ -0,0 +1,123 @@
+jest.mock('../../database/config', () => ({
+    DB_TYPE: 'mongodb',
+    getDatabaseType: jest.fn(() => 'mongodb'),
+    PRISMA_LOG_LEVEL: 'error,warn',
+    PRISMA_QUERY_LOGGING: false,
+}));
+
+const mockFindExecute = jest.fn();
+
+jest.mock('../../integrations/use-cases/find-integration-context-by-external-entity-id', () => {
+    return {
+        FindIntegrationContextByExternalEntityIdUseCase: jest
+            .fn()
+            .mockImplementation(() => ({
+                execute: mockFindExecute,
+            })),
+    };
+});
+
+const {
+    createIntegrationCommands,
+    findIntegrationContextByExternalEntityId,
+} = require('./integration-commands');
+const {
+    FindIntegrationContextByExternalEntityIdUseCase,
+} = require('../../integrations/use-cases/find-integration-context-by-external-entity-id');
+const { DummyIntegration } = require('../../integrations/tests/doubles/dummy-integration-class');
+
+describe('integration commands', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+        mockFindExecute.mockReset();
+    });
+
+    it('requires an integrationClass when creating commands', () => {
+        expect(() => createIntegrationCommands()).toThrow(
+            'integrationClass is required',
+        );
+    });
+
+    it('creates use cases with default repositories', () => {
+        createIntegrationCommands({
+            integrationClass: DummyIntegration,
+        });
+
+        // Verify that the use case is created with default repositories instantiated internally
+        expect(
+            FindIntegrationContextByExternalEntityIdUseCase,
+        ).toHaveBeenCalledWith({
+            integrationRepository: expect.any(Object),
+            moduleRepository: expect.any(Object),
+            loadIntegrationContextUseCase: expect.any(Object),
+        });
+    });
+
+    it('returns context when findIntegrationContextByExternalEntityId succeeds', async () => {
+        const expectedContext = { record: { id: 'integration-1' } };
+        mockFindExecute.mockResolvedValue({ context: expectedContext });
+        const commands = createIntegrationCommands({
+            integrationClass: DummyIntegration,
+        });
+
+        const result = await commands.findIntegrationContextByExternalEntityId(
+            'ext-1',
+        );
+
+        expect(mockFindExecute).toHaveBeenCalledWith({
+            externalEntityId: 'ext-1',
+        });
+        expect(result).toEqual({ context: expectedContext });
+    });
+
+    it('maps known errors to status codes', async () => {
+        const error = Object.assign(new Error('Entity missing'), {
+            code: 'ENTITY_NOT_FOUND',
+        });
+        mockFindExecute.mockRejectedValue(error);
+        const commands = createIntegrationCommands({
+            integrationClass: DummyIntegration,
+        });
+
+        const result = await commands.findIntegrationContextByExternalEntityId(
+            'ext-1',
+        );
+
+        expect(result).toEqual({
+            error: 401,
+            reason: 'Entity missing',
+            code: 'ENTITY_NOT_FOUND',
+        });
+    });
+
+    it('delegates loadIntegrationContextById to the loader use case', async () => {
+        // This test verifies that the command properly delegates to the use case
+        // We can't easily mock the internal use case, so we'll test the integration
+        const commands = createIntegrationCommands({
+            integrationClass: DummyIntegration,
+        });
+
+        // The actual use case will be called - this is more of an integration test
+        // For unit testing, we'd need to refactor to allow DI of the use case
+        // But since we've decided to always use default use cases, this is acceptable
+        const result = await commands.loadIntegrationContextById('integration-1');
+
+        // Result will have error since we don't have a real database
+        expect(result).toHaveProperty('error');
+    });
+
+    it('exposes a one-off helper for finding integration context by external entity id', async () => {
+        const expectedContext = { record: { id: 'integration-1' } };
+        mockFindExecute.mockResolvedValue({ context: expectedContext });
+
+        const result = await findIntegrationContextByExternalEntityId({
+            integrationClass: DummyIntegration,
+            externalEntityId: 'ext-2',
+        });
+
+        expect(mockFindExecute).toHaveBeenCalledWith({
+            externalEntityId: 'ext-2',
+        });
+        expect(result).toEqual({ context: expectedContext });
+    });
+});