@friggframework/devtools 2.0.0--canary.522.923dfae.0 → 2.0.0--canary.540.c5ef83f.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (119) hide show
  1. package/frigg-cli/README.md +1 -1
  2. package/frigg-cli/__tests__/unit/commands/doctor.test.js +2 -0
  3. package/frigg-cli/__tests__/unit/commands/install.test.js +19 -23
  4. package/frigg-cli/__tests__/unit/dependencies.test.js +2 -2
  5. package/frigg-cli/doctor-command/index.js +16 -17
  6. package/frigg-cli/index.js +6 -21
  7. package/frigg-cli/index.test.js +2 -7
  8. package/frigg-cli/init-command/backend-first-handler.js +42 -124
  9. package/frigg-cli/init-command/index.js +1 -2
  10. package/frigg-cli/init-command/template-handler.js +3 -13
  11. package/frigg-cli/install-command/backend-js.js +3 -3
  12. package/frigg-cli/install-command/environment-variables.js +19 -16
  13. package/frigg-cli/install-command/environment-variables.test.js +13 -12
  14. package/frigg-cli/install-command/index.js +9 -14
  15. package/frigg-cli/install-command/integration-file.js +3 -3
  16. package/frigg-cli/install-command/logger.js +12 -0
  17. package/frigg-cli/install-command/validate-package.js +9 -5
  18. package/frigg-cli/jest.config.js +1 -4
  19. package/frigg-cli/repair-command/index.js +128 -101
  20. package/frigg-cli/start-command/index.js +2 -246
  21. package/frigg-cli/ui-command/index.js +36 -58
  22. package/frigg-cli/utils/repo-detection.js +37 -85
  23. package/infrastructure/docs/iam-policy-templates.md +1 -1
  24. package/infrastructure/domains/networking/vpc-builder.test.js +4 -2
  25. package/infrastructure/domains/networking/vpc-resolver.test.js +1 -1
  26. package/infrastructure/domains/shared/cloudformation-discovery.test.js +7 -4
  27. package/infrastructure/domains/shared/resource-discovery.js +5 -5
  28. package/infrastructure/domains/shared/types/app-definition.js +0 -21
  29. package/infrastructure/domains/shared/types/discovery-result.test.js +1 -1
  30. package/infrastructure/domains/shared/utilities/base-definition-factory.js +1 -10
  31. package/infrastructure/domains/shared/utilities/base-definition-factory.test.js +2 -2
  32. package/infrastructure/infrastructure-composer.test.js +2 -2
  33. package/management-ui/README.md +109 -245
  34. package/package.json +7 -8
  35. package/frigg-cli/__tests__/application/use-cases/AddApiModuleToIntegrationUseCase.test.js +0 -326
  36. package/frigg-cli/__tests__/application/use-cases/CreateApiModuleUseCase.test.js +0 -337
  37. package/frigg-cli/__tests__/domain/entities/ApiModule.test.js +0 -373
  38. package/frigg-cli/__tests__/domain/entities/AppDefinition.test.js +0 -313
  39. package/frigg-cli/__tests__/domain/services/IntegrationValidator.test.js +0 -269
  40. package/frigg-cli/__tests__/domain/value-objects/IntegrationName.test.js +0 -82
  41. package/frigg-cli/__tests__/infrastructure/adapters/IntegrationJsUpdater.test.js +0 -408
  42. package/frigg-cli/__tests__/infrastructure/repositories/FileSystemApiModuleRepository.test.js +0 -583
  43. package/frigg-cli/__tests__/infrastructure/repositories/FileSystemAppDefinitionRepository.test.js +0 -314
  44. package/frigg-cli/__tests__/infrastructure/repositories/FileSystemIntegrationRepository.test.js +0 -383
  45. package/frigg-cli/__tests__/unit/commands/init.test.js +0 -406
  46. package/frigg-cli/__tests__/unit/commands/repair.test.js +0 -275
  47. package/frigg-cli/__tests__/unit/start-command/application/RunPreflightChecksUseCase.test.js +0 -411
  48. package/frigg-cli/__tests__/unit/start-command/infrastructure/DatabaseAdapter.test.js +0 -405
  49. package/frigg-cli/__tests__/unit/start-command/infrastructure/DockerAdapter.test.js +0 -496
  50. package/frigg-cli/__tests__/unit/start-command/presentation/InteractivePromptAdapter.test.js +0 -474
  51. package/frigg-cli/__tests__/unit/utils/output.test.js +0 -196
  52. package/frigg-cli/application/use-cases/AddApiModuleToIntegrationUseCase.js +0 -93
  53. package/frigg-cli/application/use-cases/CreateApiModuleUseCase.js +0 -93
  54. package/frigg-cli/application/use-cases/CreateIntegrationUseCase.js +0 -103
  55. package/frigg-cli/container.js +0 -172
  56. package/frigg-cli/docs/OUTPUT_MIGRATION_GUIDE.md +0 -286
  57. package/frigg-cli/domain/entities/ApiModule.js +0 -272
  58. package/frigg-cli/domain/entities/AppDefinition.js +0 -227
  59. package/frigg-cli/domain/entities/Integration.js +0 -198
  60. package/frigg-cli/domain/exceptions/DomainException.js +0 -24
  61. package/frigg-cli/domain/ports/IApiModuleRepository.js +0 -53
  62. package/frigg-cli/domain/ports/IAppDefinitionRepository.js +0 -43
  63. package/frigg-cli/domain/ports/IIntegrationRepository.js +0 -61
  64. package/frigg-cli/domain/services/IntegrationValidator.js +0 -185
  65. package/frigg-cli/domain/value-objects/IntegrationId.js +0 -42
  66. package/frigg-cli/domain/value-objects/IntegrationName.js +0 -60
  67. package/frigg-cli/domain/value-objects/SemanticVersion.js +0 -70
  68. package/frigg-cli/infrastructure/UnitOfWork.js +0 -46
  69. package/frigg-cli/infrastructure/adapters/BackendJsUpdater.js +0 -197
  70. package/frigg-cli/infrastructure/adapters/FileSystemAdapter.js +0 -224
  71. package/frigg-cli/infrastructure/adapters/IntegrationJsUpdater.js +0 -249
  72. package/frigg-cli/infrastructure/adapters/SchemaValidator.js +0 -92
  73. package/frigg-cli/infrastructure/repositories/FileSystemApiModuleRepository.js +0 -373
  74. package/frigg-cli/infrastructure/repositories/FileSystemAppDefinitionRepository.js +0 -116
  75. package/frigg-cli/infrastructure/repositories/FileSystemIntegrationRepository.js +0 -277
  76. package/frigg-cli/package-lock.json +0 -16226
  77. package/frigg-cli/start-command/application/RunPreflightChecksUseCase.js +0 -376
  78. package/frigg-cli/start-command/infrastructure/DatabaseAdapter.js +0 -591
  79. package/frigg-cli/start-command/infrastructure/DockerAdapter.js +0 -306
  80. package/frigg-cli/start-command/presentation/InteractivePromptAdapter.js +0 -329
  81. package/frigg-cli/templates/backend/.env.example +0 -62
  82. package/frigg-cli/templates/backend/.eslintrc.json +0 -12
  83. package/frigg-cli/templates/backend/.prettierrc +0 -6
  84. package/frigg-cli/templates/backend/docker-compose.yml +0 -22
  85. package/frigg-cli/templates/backend/index.js +0 -96
  86. package/frigg-cli/templates/backend/infrastructure.js +0 -12
  87. package/frigg-cli/templates/backend/jest.config.js +0 -17
  88. package/frigg-cli/templates/backend/package.json +0 -50
  89. package/frigg-cli/templates/backend/src/api-modules/.gitkeep +0 -10
  90. package/frigg-cli/templates/backend/src/base/.gitkeep +0 -7
  91. package/frigg-cli/templates/backend/src/integrations/.gitkeep +0 -10
  92. package/frigg-cli/templates/backend/src/integrations/ExampleIntegration.js +0 -65
  93. package/frigg-cli/templates/backend/src/utils/.gitkeep +0 -7
  94. package/frigg-cli/templates/backend/test/setup.js +0 -30
  95. package/frigg-cli/templates/backend/ui-extensions/.gitkeep +0 -0
  96. package/frigg-cli/templates/backend/ui-extensions/README.md +0 -77
  97. package/frigg-cli/utils/__tests__/repo-detection.test.js +0 -436
  98. package/frigg-cli/utils/output.js +0 -382
  99. package/frigg-cli/validate-command/__tests__/adapters/validate-command.test.js +0 -205
  100. package/frigg-cli/validate-command/__tests__/application/validate-app-use-case.test.js +0 -104
  101. package/frigg-cli/validate-command/__tests__/domain/fix-suggestion.test.js +0 -153
  102. package/frigg-cli/validate-command/__tests__/domain/validation-error.test.js +0 -162
  103. package/frigg-cli/validate-command/__tests__/domain/validation-result.test.js +0 -152
  104. package/frigg-cli/validate-command/__tests__/infrastructure/api-module-validator.test.js +0 -332
  105. package/frigg-cli/validate-command/__tests__/infrastructure/app-definition-validator.test.js +0 -191
  106. package/frigg-cli/validate-command/__tests__/infrastructure/integration-class-validator.test.js +0 -146
  107. package/frigg-cli/validate-command/__tests__/infrastructure/template-validation.test.js +0 -155
  108. package/frigg-cli/validate-command/adapters/cli/validate-command.js +0 -199
  109. package/frigg-cli/validate-command/application/use-cases/validate-app-use-case.js +0 -35
  110. package/frigg-cli/validate-command/domain/entities/validation-result.js +0 -74
  111. package/frigg-cli/validate-command/domain/value-objects/fix-suggestion.js +0 -74
  112. package/frigg-cli/validate-command/domain/value-objects/validation-error.js +0 -68
  113. package/frigg-cli/validate-command/infrastructure/validators/api-module-validator.js +0 -181
  114. package/frigg-cli/validate-command/infrastructure/validators/app-definition-validator.js +0 -128
  115. package/frigg-cli/validate-command/infrastructure/validators/integration-class-validator.js +0 -113
  116. package/infrastructure/domains/admin-scripts/admin-script-builder.js +0 -200
  117. package/infrastructure/domains/admin-scripts/admin-script-builder.test.js +0 -499
  118. package/infrastructure/domains/admin-scripts/index.js +0 -5
  119. package/infrastructure/jest.config.js +0 -16
@@ -1,6 +0,0 @@
1
- {
2
- "singleQuote": true,
3
- "tabWidth": 4,
4
- "printWidth": 100,
5
- "trailingComma": "es5"
6
- }
@@ -1,22 +0,0 @@
1
- version: '3.8'
2
-
3
- services:
4
- postgres:
5
- image: postgres:15-alpine
6
- container_name: frigg-postgres
7
- environment:
8
- POSTGRES_USER: frigg
9
- POSTGRES_PASSWORD: frigg
10
- POSTGRES_DB: frigg
11
- ports:
12
- - "5432:5432"
13
- volumes:
14
- - postgres_data:/var/lib/postgresql/data
15
- healthcheck:
16
- test: ["CMD-SHELL", "pg_isready -U frigg"]
17
- interval: 5s
18
- timeout: 5s
19
- retries: 5
20
-
21
- volumes:
22
- postgres_data:
@@ -1,96 +0,0 @@
1
- /**
2
- * Frigg Application Definition
3
- *
4
- * This file defines your Frigg integration application.
5
- * Configure integrations, authentication, and infrastructure settings here.
6
- */
7
-
8
- // Import your integrations here
9
- // const ExampleIntegration = require('./src/integrations/ExampleIntegration');
10
-
11
- const appDefinition = {
12
- // Application metadata
13
- label: 'My Frigg Application',
14
- name: 'my-frigg-app',
15
-
16
- // Deployment mode: 'managed' (recommended) or 'custom'
17
- managementMode: 'managed',
18
-
19
- // VPC isolation strategy: 'isolated' (each stage separate) or 'shared'
20
- vpcIsolation: 'isolated',
21
-
22
- // Your integrations - add Integration classes here
23
- integrations: [
24
- // Add your integrations here as you install them
25
- // Example:
26
- // ExampleIntegration,
27
- ],
28
-
29
- // User authentication configuration
30
- user: {
31
- usePassword: true,
32
- primary: 'organization',
33
- individualUserRequired: true,
34
- organizationUserRequired: true,
35
- authModes: {
36
- friggToken: true, // Support web UI login
37
- sharedSecret: true, // Enable backend-to-backend API communication
38
- adopterJwt: false, // Set true to use your own JWT tokens
39
- },
40
- },
41
-
42
- // Encryption settings
43
- encryption: {
44
- fieldLevelEncryptionMethod: 'kms', // KMS encryption for production
45
- },
46
-
47
- // VPC configuration
48
- vpc: {
49
- enable: true,
50
- enableVPCEndpoints: true,
51
- selfHeal: true,
52
- },
53
-
54
- // Database configuration (PostgreSQL via Aurora Serverless)
55
- database: {
56
- postgres: {
57
- enable: true,
58
- publiclyAccessible: false,
59
- database: 'postgres',
60
- minCapacity: 0.5,
61
- maxCapacity: 1,
62
- },
63
- },
64
-
65
- // SSM Parameter Store (optional)
66
- ssm: {
67
- enable: false,
68
- },
69
-
70
- // Environment variables required by your application
71
- // Set these in your .env file or deployment environment
72
- environment: {
73
- // Core Configuration
74
- BASE_URL: true,
75
- DATABASE_URL: true,
76
- DATABASE_USER: true,
77
- DATABASE_PASSWORD: true,
78
- REDIRECT_URI: true,
79
- HEALTH_API_KEY: true,
80
- ADMIN_API_KEY: true,
81
- FRIGG_API_KEY: true,
82
- FRIGG_APP_USER_ID: true,
83
-
84
- // AWS Configuration
85
- AWS_REGION: true,
86
- S3_BUCKET_NAME: true,
87
-
88
- // Add your integration-specific environment variables here
89
- // EXAMPLE_CLIENT_ID: true,
90
- // EXAMPLE_CLIENT_SECRET: true,
91
- },
92
- };
93
-
94
- module.exports = {
95
- Definition: appDefinition,
96
- };
@@ -1,12 +0,0 @@
1
- /**
2
- * Frigg Infrastructure Configuration
3
- *
4
- * This file exports the serverless configuration for your Frigg application.
5
- * The createFriggInfrastructure function reads your app definition and
6
- * generates the appropriate serverless.yml configuration.
7
- */
8
-
9
- const { createFriggInfrastructure } = require('@friggframework/devtools');
10
-
11
- // Serverless supports async configuration by exporting a promise
12
- module.exports = createFriggInfrastructure();
@@ -1,17 +0,0 @@
1
- module.exports = {
2
- testEnvironment: 'node',
3
- testMatch: ['**/test/**/*.test.js', '**/test/**/*.spec.js'],
4
- testPathIgnorePatterns: ['/node_modules/'],
5
- collectCoverageFrom: [
6
- 'src/**/*.js',
7
- '!src/**/*.test.js',
8
- '!src/**/*.spec.js',
9
- ],
10
- coverageDirectory: 'coverage',
11
- coverageReporters: ['text', 'lcov', 'html'],
12
- verbose: true,
13
- testTimeout: 30000,
14
- setupFilesAfterEnv: ['./test/setup.js'],
15
- // Jest groups for selective testing
16
- runner: 'groups',
17
- };
@@ -1,50 +0,0 @@
1
- {
2
- "name": "frigg-backend",
3
- "version": "0.1.0",
4
- "private": true,
5
- "prettier": "@friggframework/prettier-config",
6
- "scripts": {
7
- "test": "jest --group=-interactive --group=-live-api",
8
- "test:full": "jest",
9
- "test:unit": "jest --config jest.unit.config.js",
10
- "test:watch": "jest --watch",
11
- "test:coverage": "jest --coverage",
12
- "lint": "eslint .",
13
- "lint:fix": "prettier --write --loglevel error . && eslint . --fix",
14
- "format": "prettier --write --loglevel error .",
15
- "backend-start": "sls offline --stage dev --config serverless.js",
16
- "docker:start": "docker compose up -d",
17
- "docker:stop": "docker compose down",
18
- "frigg:start": "frigg start",
19
- "frigg:deploy": "frigg deploy",
20
- "frigg:db:setup": "frigg db:setup"
21
- },
22
- "dependencies": {
23
- "@friggframework/core": "2.0.0-next.58",
24
- "axios": "^1.6.0",
25
- "body-parser": "^1.20.3",
26
- "cors": "^2.8.5",
27
- "express": "^4.21.2",
28
- "express-async-handler": "^1.2.0",
29
- "node-cache": "^5.1.2",
30
- "serverless-http": "^2.7.0"
31
- },
32
- "devDependencies": {
33
- "@friggframework/devtools": "2.0.0-next.58",
34
- "@friggframework/eslint-config": "2.0.0-next.58",
35
- "@friggframework/prettier-config": "2.0.0-next.58",
36
- "@friggframework/serverless-plugin": "2.0.0-next.58",
37
- "@friggframework/test": "2.0.0-next.58",
38
- "@prisma/client": "^6.0.0",
39
- "dotenv": "^16.4.5",
40
- "esbuild": "^0.25.0",
41
- "jest": "^29.7.0",
42
- "nock": "^13.5.4",
43
- "osls": "^3.40.1",
44
- "prettier": "3.5.3",
45
- "prisma": "^6.0.0",
46
- "serverless-dotenv-plugin": "^6.0.0",
47
- "serverless-esbuild": "^1.55.1",
48
- "serverless-offline": "^13.8.0"
49
- }
50
- }
@@ -1,10 +0,0 @@
1
- # This directory is for custom API modules
2
- #
3
- # API modules define how to connect with external APIs.
4
- # Most integrations use published @friggframework/api-module-* packages.
5
- #
6
- # Only create custom API modules here if:
7
- # - You're integrating with a proprietary API
8
- # - No published module exists for your service
9
- #
10
- # Use 'frigg generate:api-module' to create new API modules
@@ -1,7 +0,0 @@
1
- # This directory contains base classes and shared infrastructure
2
- #
3
- # Common patterns:
4
- # - Custom entity extensions
5
- # - Shared middleware
6
- # - Base integration classes
7
- # - Custom authentication handlers
@@ -1,10 +0,0 @@
1
- # This directory contains your Integration classes
2
- # Each integration connects your application with a third-party API module
3
- #
4
- # Example structure:
5
- # src/integrations/
6
- # SalesforceIntegration.js
7
- # HubSpotIntegration.js
8
- # SlackIntegration.js
9
- #
10
- # Use 'frigg generate:integration' to create new integrations
@@ -1,65 +0,0 @@
1
- /**
2
- * Example Integration
3
- *
4
- * This is a template showing how to create an Integration class.
5
- * An Integration connects your application with a third-party API module.
6
- *
7
- * To create your own integration:
8
- * 1. Install the API module: npm install @friggframework/api-module-<name>
9
- * 2. Copy this file and rename it (e.g., SalesforceIntegration.js)
10
- * 3. Update the imports and class to use your API module
11
- * 4. Register it in index.js
12
- */
13
-
14
- const { Integration } = require('@friggframework/core');
15
- // const { Api, Entity } = require('@friggframework/api-module-example');
16
-
17
- class ExampleIntegration extends Integration {
18
- static Definition = {
19
- name: 'example',
20
- version: '1.0.0',
21
- supportedVersions: ['1.0.0'],
22
-
23
- // Events this integration can emit
24
- events: ['SYNC_COMPLETED', 'DATA_UPDATED', 'ERROR_OCCURRED'],
25
- };
26
-
27
- /**
28
- * Create API instance for this integration
29
- * @param {Object} params - Parameters from the credential
30
- */
31
- static async getInstance(params) {
32
- // Return your API module instance
33
- // return new Api(params);
34
- throw new Error('ExampleIntegration.getInstance() not implemented');
35
- }
36
-
37
- /**
38
- * Process incoming webhook events
39
- * @param {Object} event - The webhook event data
40
- */
41
- async processWebhook(event) {
42
- // Handle webhook events from the third-party service
43
- console.log('Processing webhook:', event);
44
- }
45
-
46
- /**
47
- * Perform initial sync after user connects
48
- * @param {Object} options - Sync options
49
- */
50
- async initialSync(options = {}) {
51
- // Sync initial data from the third-party service
52
- console.log('Performing initial sync');
53
- }
54
-
55
- /**
56
- * Handle OAuth callback
57
- * @param {Object} callbackParams - OAuth callback parameters
58
- */
59
- async handleCallback(callbackParams) {
60
- // Process OAuth callback and store credentials
61
- console.log('Handling OAuth callback');
62
- }
63
- }
64
-
65
- module.exports = ExampleIntegration;
@@ -1,7 +0,0 @@
1
- # This directory contains utility functions and helpers
2
- #
3
- # Common utilities:
4
- # - Data transformation helpers
5
- # - Validation utilities
6
- # - Custom error classes
7
- # - Logging helpers
@@ -1,30 +0,0 @@
1
- /**
2
- * Jest Test Setup
3
- *
4
- * This file runs before each test file and sets up the testing environment.
5
- */
6
-
7
- const dotenv = require('dotenv');
8
- const path = require('path');
9
-
10
- // Load test environment variables
11
- dotenv.config({ path: path.join(__dirname, '..', '.env.test') });
12
-
13
- // Set test environment
14
- process.env.NODE_ENV = 'test';
15
-
16
- // Global test timeout
17
- jest.setTimeout(30000);
18
-
19
- // Silence console logs during tests (optional - comment out for debugging)
20
- // global.console = {
21
- // ...console,
22
- // log: jest.fn(),
23
- // info: jest.fn(),
24
- // warn: jest.fn(),
25
- // };
26
-
27
- // Clean up after all tests
28
- afterAll(async () => {
29
- // Add any global cleanup here
30
- });
@@ -1,77 +0,0 @@
1
- # UI Extensions
2
-
3
- This directory contains custom UI extensions for external platform integrations. Each subdirectory represents a separate integration-specific package.
4
-
5
- ## Purpose
6
-
7
- When integrating with platforms that provide their own UI extension frameworks (like Attio, HubSpot, Salesforce, etc.), you can build and manage those extension packages here.
8
-
9
- ## Directory Structure
10
-
11
- ```
12
- ui-extensions/
13
- ├── README.md # This file
14
- ├── attio/ # Attio UI extension (if using Attio)
15
- ├── hubspot/ # HubSpot UI extension (if using HubSpot)
16
- ├── salesforce/ # Salesforce Lightning component (if using Salesforce)
17
- └── <platform>/ # Other platform-specific extensions
18
- ```
19
-
20
- ## Getting Started
21
-
22
- Each platform extension is a separate npm package. To create one:
23
-
24
- 1. **Create the extension directory:**
25
- ```bash
26
- mkdir ui-extensions/<platform-name>
27
- cd ui-extensions/<platform-name>
28
- ```
29
-
30
- 2. **Initialize the package:**
31
- Follow the platform's SDK documentation to set up the extension package.
32
-
33
- 3. **Develop and test:**
34
- Each extension has its own build and development scripts.
35
-
36
- ## Example: Attio Extension
37
-
38
- ```bash
39
- cd ui-extensions/attio
40
- npm install
41
- npm run dev # Start development server
42
- npm run build # Build for production
43
- ```
44
-
45
- ## Example: HubSpot Extension
46
-
47
- ```bash
48
- cd ui-extensions/hubspot
49
- npm install
50
- npx hs project create --template=react-app
51
- npm run dev
52
- ```
53
-
54
- ## Workspace Integration
55
-
56
- Add extensions as workspaces in the root `package.json`:
57
-
58
- ```json
59
- {
60
- "workspaces": [
61
- "ui-extensions/*"
62
- ]
63
- }
64
- ```
65
-
66
- ## Platform Documentation
67
-
68
- - [Attio Apps](https://developers.attio.com)
69
- - [HubSpot UI Extensions](https://developers.hubspot.com/docs/platform/ui-extensions-overview)
70
- - [Salesforce Lightning Components](https://developer.salesforce.com/docs/atlas.en-us.lightning.meta)
71
- - [Monday.com Apps](https://developer.monday.com/apps)
72
-
73
- ## Notes
74
-
75
- - Each extension is independent and can be deployed separately
76
- - Extensions typically have their own build tools and test suites
77
- - Keep platform-specific code isolated to its respective directory