@friggframework/devtools 2.0.0-next.61 → 2.0.0-next.63

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 (142) hide show
  1. package/infrastructure/domains/shared/utilities/base-definition-factory.js +15 -1
  2. package/package.json +15 -7
  3. package/.eslintrc.json +0 -3
  4. package/CHANGELOG.md +0 -132
  5. package/layers/prisma/.build-complete +0 -3
  6. package/layers/prisma/nodejs/package.json +0 -8
  7. package/management-ui/.eslintrc.js +0 -22
  8. package/management-ui/components.json +0 -21
  9. package/management-ui/docs/phase2-integration-guide.md +0 -320
  10. package/management-ui/index.html +0 -13
  11. package/management-ui/package.json +0 -76
  12. package/management-ui/packages/devtools/frigg-cli/ui-command/index.js +0 -302
  13. package/management-ui/postcss.config.js +0 -6
  14. package/management-ui/server/api/backend.js +0 -256
  15. package/management-ui/server/api/cli.js +0 -315
  16. package/management-ui/server/api/codegen.js +0 -663
  17. package/management-ui/server/api/connections.js +0 -857
  18. package/management-ui/server/api/discovery.js +0 -185
  19. package/management-ui/server/api/environment/index.js +0 -1
  20. package/management-ui/server/api/environment/router.js +0 -378
  21. package/management-ui/server/api/environment.js +0 -328
  22. package/management-ui/server/api/integrations.js +0 -876
  23. package/management-ui/server/api/logs.js +0 -248
  24. package/management-ui/server/api/monitoring.js +0 -282
  25. package/management-ui/server/api/open-ide.js +0 -31
  26. package/management-ui/server/api/project.js +0 -1029
  27. package/management-ui/server/api/users/sessions.js +0 -371
  28. package/management-ui/server/api/users/simulation.js +0 -254
  29. package/management-ui/server/api/users.js +0 -362
  30. package/management-ui/server/api-contract.md +0 -275
  31. package/management-ui/server/index.js +0 -873
  32. package/management-ui/server/middleware/errorHandler.js +0 -93
  33. package/management-ui/server/middleware/security.js +0 -32
  34. package/management-ui/server/processManager.js +0 -296
  35. package/management-ui/server/server.js +0 -346
  36. package/management-ui/server/services/aws-monitor.js +0 -413
  37. package/management-ui/server/services/npm-registry.js +0 -347
  38. package/management-ui/server/services/template-engine.js +0 -538
  39. package/management-ui/server/utils/cliIntegration.js +0 -220
  40. package/management-ui/server/utils/environment/auditLogger.js +0 -471
  41. package/management-ui/server/utils/environment/awsParameterStore.js +0 -275
  42. package/management-ui/server/utils/environment/encryption.js +0 -278
  43. package/management-ui/server/utils/environment/envFileManager.js +0 -286
  44. package/management-ui/server/utils/import-commonjs.js +0 -28
  45. package/management-ui/server/utils/response.js +0 -83
  46. package/management-ui/server/websocket/handler.js +0 -325
  47. package/management-ui/src/App.jsx +0 -25
  48. package/management-ui/src/assets/FriggLogo.svg +0 -1
  49. package/management-ui/src/components/AppRouter.jsx +0 -65
  50. package/management-ui/src/components/Button.jsx +0 -70
  51. package/management-ui/src/components/Card.jsx +0 -97
  52. package/management-ui/src/components/EnvironmentCompare.jsx +0 -400
  53. package/management-ui/src/components/EnvironmentEditor.jsx +0 -372
  54. package/management-ui/src/components/EnvironmentImportExport.jsx +0 -469
  55. package/management-ui/src/components/EnvironmentSchema.jsx +0 -491
  56. package/management-ui/src/components/EnvironmentSecurity.jsx +0 -463
  57. package/management-ui/src/components/ErrorBoundary.jsx +0 -73
  58. package/management-ui/src/components/IntegrationCard.jsx +0 -481
  59. package/management-ui/src/components/IntegrationCardEnhanced.jsx +0 -770
  60. package/management-ui/src/components/IntegrationExplorer.jsx +0 -379
  61. package/management-ui/src/components/IntegrationStatus.jsx +0 -336
  62. package/management-ui/src/components/Layout.jsx +0 -716
  63. package/management-ui/src/components/LoadingSpinner.jsx +0 -113
  64. package/management-ui/src/components/RepositoryPicker.jsx +0 -248
  65. package/management-ui/src/components/SessionMonitor.jsx +0 -350
  66. package/management-ui/src/components/StatusBadge.jsx +0 -208
  67. package/management-ui/src/components/UserContextSwitcher.jsx +0 -212
  68. package/management-ui/src/components/UserSimulation.jsx +0 -327
  69. package/management-ui/src/components/Welcome.jsx +0 -434
  70. package/management-ui/src/components/codegen/APIEndpointGenerator.jsx +0 -637
  71. package/management-ui/src/components/codegen/APIModuleSelector.jsx +0 -227
  72. package/management-ui/src/components/codegen/CodeGenerationWizard.jsx +0 -247
  73. package/management-ui/src/components/codegen/CodePreviewEditor.jsx +0 -316
  74. package/management-ui/src/components/codegen/DynamicModuleForm.jsx +0 -271
  75. package/management-ui/src/components/codegen/FormBuilder.jsx +0 -737
  76. package/management-ui/src/components/codegen/IntegrationGenerator.jsx +0 -855
  77. package/management-ui/src/components/codegen/ProjectScaffoldWizard.jsx +0 -797
  78. package/management-ui/src/components/codegen/SchemaBuilder.jsx +0 -303
  79. package/management-ui/src/components/codegen/TemplateSelector.jsx +0 -586
  80. package/management-ui/src/components/codegen/index.js +0 -10
  81. package/management-ui/src/components/connections/ConnectionConfigForm.jsx +0 -362
  82. package/management-ui/src/components/connections/ConnectionHealthMonitor.jsx +0 -182
  83. package/management-ui/src/components/connections/ConnectionTester.jsx +0 -200
  84. package/management-ui/src/components/connections/EntityRelationshipMapper.jsx +0 -292
  85. package/management-ui/src/components/connections/OAuthFlow.jsx +0 -204
  86. package/management-ui/src/components/connections/index.js +0 -5
  87. package/management-ui/src/components/index.js +0 -21
  88. package/management-ui/src/components/monitoring/APIGatewayMetrics.jsx +0 -222
  89. package/management-ui/src/components/monitoring/LambdaMetrics.jsx +0 -169
  90. package/management-ui/src/components/monitoring/MetricsChart.jsx +0 -197
  91. package/management-ui/src/components/monitoring/MonitoringDashboard.jsx +0 -393
  92. package/management-ui/src/components/monitoring/SQSMetrics.jsx +0 -246
  93. package/management-ui/src/components/monitoring/index.js +0 -6
  94. package/management-ui/src/components/monitoring/monitoring.css +0 -218
  95. package/management-ui/src/components/theme-provider.jsx +0 -52
  96. package/management-ui/src/components/theme-toggle.jsx +0 -39
  97. package/management-ui/src/components/ui/badge.tsx +0 -36
  98. package/management-ui/src/components/ui/button.test.jsx +0 -56
  99. package/management-ui/src/components/ui/button.tsx +0 -57
  100. package/management-ui/src/components/ui/card.tsx +0 -76
  101. package/management-ui/src/components/ui/dropdown-menu.tsx +0 -199
  102. package/management-ui/src/components/ui/select.tsx +0 -157
  103. package/management-ui/src/components/ui/skeleton.jsx +0 -15
  104. package/management-ui/src/hooks/useFrigg.jsx +0 -387
  105. package/management-ui/src/hooks/useSocket.jsx +0 -58
  106. package/management-ui/src/index.css +0 -193
  107. package/management-ui/src/lib/utils.ts +0 -6
  108. package/management-ui/src/main.jsx +0 -10
  109. package/management-ui/src/pages/CodeGeneration.jsx +0 -14
  110. package/management-ui/src/pages/Connections.jsx +0 -252
  111. package/management-ui/src/pages/ConnectionsEnhanced.jsx +0 -633
  112. package/management-ui/src/pages/Dashboard.jsx +0 -311
  113. package/management-ui/src/pages/Environment.jsx +0 -314
  114. package/management-ui/src/pages/IntegrationConfigure.jsx +0 -669
  115. package/management-ui/src/pages/IntegrationDiscovery.jsx +0 -567
  116. package/management-ui/src/pages/IntegrationTest.jsx +0 -742
  117. package/management-ui/src/pages/Integrations.jsx +0 -253
  118. package/management-ui/src/pages/Monitoring.jsx +0 -17
  119. package/management-ui/src/pages/Simulation.jsx +0 -155
  120. package/management-ui/src/pages/Users.jsx +0 -492
  121. package/management-ui/src/services/api.js +0 -41
  122. package/management-ui/src/services/apiModuleService.js +0 -193
  123. package/management-ui/src/services/websocket-handlers.js +0 -120
  124. package/management-ui/src/test/api/project.test.js +0 -273
  125. package/management-ui/src/test/components/Welcome.test.jsx +0 -378
  126. package/management-ui/src/test/mocks/server.js +0 -178
  127. package/management-ui/src/test/setup.js +0 -61
  128. package/management-ui/src/test/utils/test-utils.jsx +0 -134
  129. package/management-ui/src/utils/repository.js +0 -98
  130. package/management-ui/src/utils/repository.test.js +0 -118
  131. package/management-ui/src/workflows/phase2-integration-workflows.js +0 -884
  132. package/management-ui/tailwind.config.js +0 -63
  133. package/management-ui/tsconfig.json +0 -37
  134. package/management-ui/tsconfig.node.json +0 -10
  135. package/management-ui/vite.config.js +0 -26
  136. package/management-ui/vitest.config.js +0 -38
  137. package/test/auther-definition-method-tester.js +0 -45
  138. package/test/index.js +0 -9
  139. package/test/integration-validator.js +0 -2
  140. package/test/mock-api-readme.md +0 -102
  141. package/test/mock-api.js +0 -284
  142. package/test/mock-integration.js +0 -78
@@ -81,7 +81,13 @@ function createBaseDefinition(
81
81
  'node_modules/serverless-kms-grants/**',
82
82
  // Note: DO NOT exclude serverless-http - it's a runtime dependency!
83
83
 
84
- // Exclude local dev files
84
+ // Exclude local dev files and environment files (NEVER deploy .env files!)
85
+ '.env',
86
+ '.env.*',
87
+ '.env.local',
88
+ '.env.*.local',
89
+ '**/.env',
90
+ '**/.env.*',
85
91
  'deploy.log',
86
92
  '.env.backup',
87
93
  'docker-compose.yml',
@@ -124,6 +130,14 @@ function createBaseDefinition(
124
130
  'node_modules/@friggframework/core/node_modules/**',
125
131
  'node_modules/@friggframework/devtools/node_modules/**',
126
132
 
133
+ // Exclude environment files (NEVER deploy .env files!)
134
+ '.env',
135
+ '.env.*',
136
+ '.env.local',
137
+ '.env.*.local',
138
+ '**/.env',
139
+ '**/.env.*',
140
+
127
141
  // Exclude development/test files from backend project
128
142
  'coverage/**',
129
143
  'test/**',
package/package.json CHANGED
@@ -1,10 +1,18 @@
1
1
  {
2
2
  "name": "@friggframework/devtools",
3
3
  "prettier": "@friggframework/prettier-config",
4
- "version": "2.0.0-next.61",
4
+ "version": "2.0.0-next.63",
5
5
  "bin": {
6
6
  "frigg": "./frigg-cli/index.js"
7
7
  },
8
+ "files": [
9
+ "frigg-cli/",
10
+ "infrastructure/",
11
+ "migrations/",
12
+ "management-ui/dist/",
13
+ "index.js",
14
+ "README.md"
15
+ ],
8
16
  "dependencies": {
9
17
  "@aws-sdk/client-cloudformation": "^3.705.0",
10
18
  "@aws-sdk/client-ec2": "^3.835.0",
@@ -16,9 +24,9 @@
16
24
  "@babel/eslint-parser": "^7.18.9",
17
25
  "@babel/parser": "^7.25.3",
18
26
  "@babel/traverse": "^7.25.3",
19
- "@friggframework/core": "2.0.0-next.61",
20
- "@friggframework/schemas": "2.0.0-next.61",
21
- "@friggframework/test": "2.0.0-next.61",
27
+ "@friggframework/core": "2.0.0-next.63",
28
+ "@friggframework/schemas": "2.0.0-next.63",
29
+ "@friggframework/test": "2.0.0-next.63",
22
30
  "@hapi/boom": "^10.0.1",
23
31
  "@inquirer/prompts": "^5.3.8",
24
32
  "axios": "^1.7.2",
@@ -46,8 +54,8 @@
46
54
  "validate-npm-package-name": "^5.0.0"
47
55
  },
48
56
  "devDependencies": {
49
- "@friggframework/eslint-config": "2.0.0-next.61",
50
- "@friggframework/prettier-config": "2.0.0-next.61",
57
+ "@friggframework/eslint-config": "2.0.0-next.63",
58
+ "@friggframework/prettier-config": "2.0.0-next.63",
51
59
  "aws-sdk-client-mock": "^4.1.0",
52
60
  "aws-sdk-client-mock-jest": "^4.1.0",
53
61
  "jest": "^30.1.3",
@@ -79,5 +87,5 @@
79
87
  "publishConfig": {
80
88
  "access": "public"
81
89
  },
82
- "gitHead": "41be237eff14a10a9379c687e5ce0a75cdf9b029"
90
+ "gitHead": "a24ce0747f119b26e911ae821cd20997b9473c61"
83
91
  }
package/.eslintrc.json DELETED
@@ -1,3 +0,0 @@
1
- {
2
- "extends": "@friggframework/eslint-config"
3
- }
package/CHANGELOG.md DELETED
@@ -1,132 +0,0 @@
1
- # v1.2.0 (Tue Aug 06 2024)
2
-
3
- #### 🚀 Enhancement
4
-
5
- - CLI for Frigg - Install command for now [#322](https://github.com/friggframework/frigg/pull/322) ([@seanspeaks](https://github.com/seanspeaks))
6
-
7
- #### 🐛 Bug Fix
8
-
9
- - Add READMEs that will need updating, but for version releasing [#324](https://github.com/friggframework/frigg/pull/324) ([@seanspeaks](https://github.com/seanspeaks))
10
- - Add READMEs that will need updating, but for version releasing ([@seanspeaks](https://github.com/seanspeaks))
11
- - small update to integration testing / tooling [#304](https://github.com/friggframework/frigg/pull/304) ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
12
- - Added missing dependencies ([@seanspeaks](https://github.com/seanspeaks))
13
- - Added a missing dependency ([@seanspeaks](https://github.com/seanspeaks))
14
- - Updated to handle envs properly, also further refactoring, and better templating. ([@seanspeaks](https://github.com/seanspeaks))
15
- - WIP with help from Tabnine AI chat. ([@seanspeaks](https://github.com/seanspeaks))
16
- - Bump version to: v1.1.8 \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
17
- - use the factory methods for creating the mock integration so that everything is set up (mostly events and userActions) ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
18
- - Bump version to: v1.1.5 \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
19
-
20
- #### Authors: 2
21
-
22
- - [@MichaelRyanWebber](https://github.com/MichaelRyanWebber)
23
- - Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))
24
-
25
- ---
26
-
27
- # v1.1.8 (Thu Jul 18 2024)
28
-
29
- #### 🐛 Bug Fix
30
-
31
- - Revert open to support commonjs [#319](https://github.com/friggframework/frigg/pull/319) ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
32
- - Bump version to: v1.1.6 \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
33
-
34
- #### Authors: 2
35
-
36
- - [@MichaelRyanWebber](https://github.com/MichaelRyanWebber)
37
- - Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))
38
-
39
- ---
40
-
41
- # v1.1.7 (Mon Jul 15 2024)
42
-
43
- #### 🐛 Bug Fix
44
-
45
- - getAuthorizationRequirements() async [#318](https://github.com/friggframework/frigg/pull/318) ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
46
- - await getAuthorizeRequirements() ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
47
- - Bump version to: v1.1.6 \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
48
-
49
- #### Authors: 2
50
-
51
- - [@MichaelRyanWebber](https://github.com/MichaelRyanWebber)
52
- - Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))
53
-
54
- ---
55
-
56
- # v1.1.6 (Fri Apr 26 2024)
57
-
58
- #### 🐛 Bug Fix
59
-
60
- - Small fix to validation errors and cleanup [#307](https://github.com/friggframework/frigg/pull/307) ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
61
- - also cleanup devtools since all versions will bump ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
62
- - Bump version to: v1.1.5 \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
63
-
64
- #### Authors: 2
65
-
66
- - [@MichaelRyanWebber](https://github.com/MichaelRyanWebber)
67
- - Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))
68
-
69
- ---
70
-
71
- # v1.1.5 (Tue Apr 09 2024)
72
-
73
- #### 🐛 Bug Fix
74
-
75
- - update router to include options and refresh [#301](https://github.com/friggframework/frigg/pull/301) ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
76
- - Bump version to: v1.1.4 \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
77
- - Bump version to: v1.1.3 \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
78
-
79
- #### Authors: 2
80
-
81
- - [@MichaelRyanWebber](https://github.com/MichaelRyanWebber)
82
- - Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))
83
-
84
- ---
85
-
86
- # v2.0.0 (Sat Mar 30 2024)
87
-
88
- #### 💥 Breaking Change
89
-
90
- - revert HEAD to a corrected v1-connectwise release [#283](https://github.com/friggframework/frigg/pull/283) ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
91
-
92
- #### 🚀 Enhancement
93
-
94
- - Package redo [#294](https://github.com/friggframework/frigg/pull/294) ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
95
-
96
- #### 🐛 Bug Fix
97
-
98
- - delete all node_modules and regenerate lock file to potentially address known bug ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
99
- - add back the direct dependency on eslint as this might be leading to a deploy issue ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
100
- - create test, eslint-config and prettier-config packages as base shared dependencies ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
101
- - slight fix to mock integration module instantiation [#290](https://github.com/friggframework/frigg/pull/290) ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
102
- - slight fix to mock integration module instantiation ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
103
- - Publish ([@seanspeaks](https://github.com/seanspeaks))
104
- - Bump node and npm version for the whole repo (Fix CI) [#274](https://github.com/friggframework/frigg/pull/274) ([@seanspeaks](https://github.com/seanspeaks))
105
- - Revert main to last release [#284](https://github.com/friggframework/frigg/pull/284) ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
106
- - Revert "set test environment STAGE to dev" ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
107
- - Add stage to test env [#282](https://github.com/friggframework/frigg/pull/282) ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
108
- - set test environment STAGE to dev ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
109
- - Bump independent versions \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
110
-
111
- #### Authors: 2
112
-
113
- - [@MichaelRyanWebber](https://github.com/MichaelRyanWebber)
114
- - Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))
115
-
116
- ---
117
-
118
- # v1.1.0 (Wed Mar 20 2024)
119
-
120
- #### 🚀 Enhancement
121
-
122
-
123
- #### 🐛 Bug Fix
124
-
125
- - correct some bad automated edits, though they are not in relevant files ([@MichaelRyanWebber](https://github.com/MichaelRyanWebber))
126
-
127
- #### Authors: 4
128
-
129
- - [@MichaelRyanWebber](https://github.com/MichaelRyanWebber)
130
- - Nicolas Leal ([@nicolasmelo1](https://github.com/nicolasmelo1))
131
- - nmilcoff ([@nmilcoff](https://github.com/nmilcoff))
132
- - Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))
@@ -1,3 +0,0 @@
1
- Build completed: 2025-11-17T22:06:29.204Z
2
- Node: v20.12.1
3
- Platform: darwin
@@ -1,8 +0,0 @@
1
- {
2
- "name": "prisma-lambda-layer",
3
- "version": "1.0.0",
4
- "private": true,
5
- "dependencies": {
6
- "@prisma/client": "^6.16.3"
7
- }
8
- }
@@ -1,22 +0,0 @@
1
- module.exports = {
2
- root: true,
3
- env: { browser: true, es2020: true },
4
- extends: [
5
- 'eslint:recommended',
6
- '@eslint/js/recommended',
7
- 'plugin:react/recommended',
8
- 'plugin:react/jsx-runtime',
9
- 'plugin:react-hooks/recommended',
10
- ],
11
- ignorePatterns: ['dist', '.eslintrc.js'],
12
- parserOptions: { ecmaVersion: 'latest', sourceType: 'module' },
13
- settings: { react: { version: '18.3' } },
14
- plugins: ['react-refresh'],
15
- rules: {
16
- 'react/jsx-no-target-blank': 'off',
17
- 'react-refresh/only-export-components': [
18
- 'warn',
19
- { allowConstantExport: true },
20
- ],
21
- },
22
- }
@@ -1,21 +0,0 @@
1
- {
2
- "$schema": "https://ui.shadcn.com/schema.json",
3
- "style": "new-york",
4
- "rsc": false,
5
- "tsx": true,
6
- "tailwind": {
7
- "config": "tailwind.config.js",
8
- "css": "src/index.css",
9
- "baseColor": "neutral",
10
- "cssVariables": true,
11
- "prefix": ""
12
- },
13
- "aliases": {
14
- "components": "@/components",
15
- "utils": "@/lib/utils",
16
- "ui": "@/components/ui",
17
- "lib": "@/lib",
18
- "hooks": "@/hooks"
19
- },
20
- "iconLibrary": "lucide"
21
- }
@@ -1,320 +0,0 @@
1
- # Phase 2 Integration Guide
2
-
3
- ## Overview
4
-
5
- This guide covers the complete integration of all Phase 2 features for the Frigg Management UI as specified in RFC 0001. Phase 2 introduces core features that transform the developer experience with visual tools for integration management, testing, and deployment.
6
-
7
- ## Phase 2 Core Features
8
-
9
- ### 1. Integration Discovery and Installation
10
-
11
- The integration discovery system connects to the npm registry to find and install @friggframework modules.
12
-
13
- #### Key Components:
14
- - **IntegrationDiscoveryService**: Searches npm registry for Frigg integrations
15
- - **IntegrationInstallerService**: Handles package installation and dependency management
16
- - **UI Components**: Visual interface for browsing and installing integrations
17
-
18
- #### Usage:
19
- ```javascript
20
- // Discover integrations
21
- const discoveries = await discoveryService.searchIntegrations({
22
- query: 'hubspot',
23
- limit: 20
24
- });
25
-
26
- // Install integration
27
- const result = await installerService.installIntegration({
28
- packageName: '@friggframework/api-module-hubspot'
29
- });
30
- ```
31
-
32
- ### 2. Dummy User Management System
33
-
34
- Create and manage test users for development and testing purposes.
35
-
36
- #### Features:
37
- - Generate unique test IDs for each user
38
- - Create OAuth credentials for testing
39
- - Bulk user creation support
40
- - Complete isolation from production data
41
-
42
- #### API Endpoints:
43
- - `POST /api/users/dummy` - Create a dummy user
44
- - `GET /api/users/dummy` - List all dummy users
45
- - `POST /api/users/dummy/:id/credentials` - Generate test credentials
46
- - `POST /api/users/dummy/bulk` - Create multiple users
47
-
48
- ### 3. Connection/Entity Management
49
-
50
- Manage connections between users and integrations with full entity synchronization.
51
-
52
- #### Capabilities:
53
- - Create and manage user-integration connections
54
- - Health monitoring for active connections
55
- - Entity CRUD operations
56
- - Bulk synchronization support
57
-
58
- #### Connection Lifecycle:
59
- 1. Create connection with user credentials
60
- 2. Test connection health
61
- 3. Manage entities (contacts, deals, messages, etc.)
62
- 4. Monitor connection status
63
- 5. Handle refresh/reconnection
64
-
65
- ### 4. Environment Variable Editor
66
-
67
- Visual interface for managing environment variables across development and production.
68
-
69
- #### Features:
70
- - Read and display current variables
71
- - Mask sensitive values (passwords, keys, secrets)
72
- - Validate variable names
73
- - Differentiate local vs production environments
74
- - Bulk update support
75
-
76
- #### Security:
77
- - Automatic masking of sensitive values
78
- - Validation to prevent invalid variable names
79
- - Production update confirmation required
80
- - AWS Parameter Store integration for production
81
-
82
- ## Integration Workflows
83
-
84
- ### Complete Integration Setup Flow
85
-
86
- ```javascript
87
- const workflow = await phase2Workflows.setupIntegration('hubspot', {
88
- config: {
89
- clientId: 'your-client-id',
90
- clientSecret: 'your-client-secret'
91
- },
92
- testUserName: 'HubSpot Test User',
93
- environment: 'development'
94
- });
95
- ```
96
-
97
- This workflow automatically:
98
- 1. Discovers integration details
99
- 2. Installs the package
100
- 3. Configures the integration
101
- 4. Creates a test user
102
- 5. Generates credentials
103
- 6. Creates a connection
104
- 7. Tests the connection
105
- 8. Sets up environment variables
106
-
107
- ### Bulk Integration Management
108
-
109
- ```javascript
110
- const bulkResult = await phase2Workflows.bulkIntegrationSetup([
111
- { name: 'slack', options: { /* config */ } },
112
- { name: 'salesforce', options: { /* config */ } },
113
- { name: 'stripe', options: { /* config */ } }
114
- ], {
115
- batchSize: 3 // Process in parallel
116
- });
117
- ```
118
-
119
- ### Development Environment Setup
120
-
121
- ```javascript
122
- const devEnv = await phase2Workflows.setupDevelopmentEnvironment({
123
- projectType: 'saas',
124
- integrations: ['stripe', 'hubspot', 'slack'],
125
- testUserCount: 10,
126
- mockDataTypes: ['contacts', 'messages', 'payments']
127
- });
128
- ```
129
-
130
- ## Testing Phase 2 Features
131
-
132
- ### Integration Tests
133
-
134
- Run the comprehensive integration test suite:
135
-
136
- ```bash
137
- npm run test:integration
138
- ```
139
-
140
- Key test areas:
141
- - End-to-end user flows
142
- - WebSocket real-time updates
143
- - Concurrent operation handling
144
- - Error recovery
145
- - Data consistency
146
-
147
- ### Performance Benchmarks
148
-
149
- Run performance benchmarks:
150
-
151
- ```bash
152
- npm run benchmark:phase2
153
- ```
154
-
155
- Benchmark metrics:
156
- - Integration discovery speed
157
- - Installation throughput
158
- - API response times
159
- - WebSocket latency
160
- - Memory usage under load
161
- - Concurrent user capacity
162
-
163
- ### Validation Tests
164
-
165
- Ensure RFC compliance:
166
-
167
- ```bash
168
- npm run test:validation
169
- ```
170
-
171
- Validates:
172
- - All RFC requirements are met
173
- - Security requirements
174
- - Performance targets
175
- - API contracts
176
- - Migration compatibility
177
-
178
- ## Performance Optimization
179
-
180
- ### Caching Strategy
181
-
182
- The discovery service implements a 1-hour cache for npm queries:
183
- - Cold start: First request fetches from npm
184
- - Cached: Subsequent requests use in-memory cache
185
- - Cache invalidation: Manual or time-based
186
-
187
- ### Batch Processing
188
-
189
- For optimal performance with multiple operations:
190
- - Use bulk endpoints when available
191
- - Process in configurable batch sizes
192
- - Implement proper error handling per batch
193
-
194
- ### WebSocket Updates
195
-
196
- Real-time updates for long-running operations:
197
- - Installation progress
198
- - Connection status changes
199
- - Environment updates
200
- - Error notifications
201
-
202
- ## Security Considerations
203
-
204
- ### Environment Variables
205
- - Automatic masking of sensitive values
206
- - Patterns detected: PASSWORD, SECRET, KEY, TOKEN, etc.
207
- - Read-only access for discovery operations
208
- - Production updates require explicit confirmation
209
-
210
- ### Test Data Isolation
211
- - All dummy users marked with `isDummy: true`
212
- - Test IDs include 'test' prefix
213
- - Separate storage from production data
214
- - No cross-contamination possible
215
-
216
- ### Input Validation
217
- - Variable name validation (alphanumeric + underscore)
218
- - Package name verification
219
- - Credential format checking
220
- - SQL injection prevention
221
-
222
- ## Migration from create-frigg-app
223
-
224
- ### Automated Migration
225
-
226
- ```javascript
227
- const migration = await phase2Workflows.migrateProject('/path/to/project', {
228
- preserveCustom: true,
229
- integrationMapping: {
230
- 'old-integration': 'new-integration'
231
- }
232
- });
233
- ```
234
-
235
- ### Manual Migration Steps
236
-
237
- 1. **Backup existing project**
238
- 2. **Update dependencies**:
239
- ```json
240
- {
241
- "devDependencies": {
242
- "@friggframework/cli": "latest"
243
- }
244
- }
245
- ```
246
- 3. **Run migration command**:
247
- ```bash
248
- frigg migrate --from-create-frigg-app
249
- ```
250
- 4. **Verify integration configurations**
251
- 5. **Update environment variables**
252
- 6. **Test all connections**
253
-
254
- ## Troubleshooting
255
-
256
- ### Common Issues
257
-
258
- #### Integration Discovery Fails
259
- - Check network connectivity
260
- - Verify npm registry access
261
- - Clear discovery cache
262
- - Check for proxy settings
263
-
264
- #### Connection Test Failures
265
- - Verify credentials are correct
266
- - Check integration configuration
267
- - Review API rate limits
268
- - Inspect WebSocket connection
269
-
270
- #### Environment Variable Issues
271
- - Ensure valid variable names
272
- - Check file permissions for .env
273
- - Verify AWS credentials for production
274
- - Look for conflicting variables
275
-
276
- ### Debug Mode
277
-
278
- Enable debug logging:
279
- ```bash
280
- DEBUG=frigg:* npm run dev:server
281
- ```
282
-
283
- ### Health Checks
284
-
285
- Monitor system health:
286
- ```javascript
287
- // API endpoint
288
- GET /api/health
289
-
290
- // Returns
291
- {
292
- "status": "healthy",
293
- "services": {
294
- "discovery": "operational",
295
- "installer": "operational",
296
- "websocket": "connected",
297
- "environment": "configured"
298
- }
299
- }
300
- ```
301
-
302
- ## Best Practices
303
-
304
- 1. **Use Workflows**: Leverage the provided workflows for complex operations
305
- 2. **Monitor Performance**: Regularly run benchmarks to ensure optimal performance
306
- 3. **Test Thoroughly**: Use the comprehensive test suites before deployment
307
- 4. **Handle Errors**: Implement proper error handling for all async operations
308
- 5. **Cache Wisely**: Use caching for frequently accessed data
309
- 6. **Secure Sensitive Data**: Always mask sensitive environment variables
310
- 7. **Document Custom Integrations**: Maintain clear documentation for custom work
311
-
312
- ## Next Steps
313
-
314
- After Phase 2 implementation:
315
-
316
- 1. **Phase 3**: Advanced features including production monitoring
317
- 2. **Phase 4**: Multi-framework UI support
318
- 3. **Phase 5**: Complete migration and deprecation of create-frigg-app
319
-
320
- For questions or issues, refer to the [Frigg documentation](https://docs.frigg.dev) or open an issue on GitHub.
@@ -1,13 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8" />
5
- <link rel="icon" type="image/svg+xml" href="/vite.svg" />
6
- <meta name="viewport" content="width=device-width, initial-scale=1.0" />
7
- <title>Frigg Management UI</title>
8
- </head>
9
- <body>
10
- <div id="root"></div>
11
- <script type="module" src="/src/main.jsx"></script>
12
- </body>
13
- </html>
@@ -1,76 +0,0 @@
1
- {
2
- "name": "@friggframework/management-ui",
3
- "version": "0.1.0",
4
- "private": true,
5
- "type": "module",
6
- "scripts": {
7
- "dev": "vite",
8
- "dev:server": "concurrently \"npm run server\" \"npm run dev\"",
9
- "build": "vite build",
10
- "preview": "vite preview",
11
- "server": "node server/server.js",
12
- "server:old": "node server/index.js",
13
- "server:dev": "nodemon server/server.js",
14
- "test": "vitest",
15
- "test:ui": "vitest --ui",
16
- "test:watch": "vitest --watch",
17
- "test:coverage": "vitest --coverage",
18
- "lint": "eslint src --ext js,jsx --report-unused-disable-directives --max-warnings 0",
19
- "lint:fix": "eslint src --ext js,jsx --fix",
20
- "typecheck": "tsc --noEmit"
21
- },
22
- "dependencies": {
23
- "@aws-sdk/client-api-gateway": "^3.478.0",
24
- "@aws-sdk/client-cloudwatch": "^3.478.0",
25
- "@aws-sdk/client-lambda": "^3.478.0",
26
- "@aws-sdk/client-sqs": "^3.478.0",
27
- "@friggframework/ui": "^2.0.0-next.0",
28
- "@friggframework/ui-react": "file:../../ui/react",
29
- "@radix-ui/react-dropdown-menu": "^2.1.15",
30
- "@radix-ui/react-select": "^2.2.5",
31
- "@radix-ui/react-slot": "^1.2.3",
32
- "axios": "^1.6.7",
33
- "class-variance-authority": "^0.7.1",
34
- "clsx": "^2.1.1",
35
- "cors": "^2.8.5",
36
- "express": "^4.18.2",
37
- "framer-motion": "^12.20.1",
38
- "fs-extra": "^11.2.0",
39
- "handlebars": "^4.7.8",
40
- "lucide-react": "^0.473.0",
41
- "node-cache": "^5.1.2",
42
- "node-fetch": "^3.3.2",
43
- "react": "^18.3.1",
44
- "react-dom": "^18.3.1",
45
- "react-router-dom": "^6.22.0",
46
- "semver": "^7.5.4",
47
- "socket.io": "^4.7.4",
48
- "socket.io-client": "^4.7.4",
49
- "tailwind-merge": "^2.6.0",
50
- "tailwindcss-animate": "^1.0.7"
51
- },
52
- "devDependencies": {
53
- "@types/react": "^18.3.3",
54
- "@types/react-dom": "^18.3.0",
55
- "@vitejs/plugin-react": "^4.3.1",
56
- "autoprefixer": "^10.4.20",
57
- "concurrently": "^8.2.2",
58
- "eslint": "^8.57.0",
59
- "eslint-plugin-react": "^7.34.3",
60
- "eslint-plugin-react-hooks": "^4.6.2",
61
- "eslint-plugin-react-refresh": "^0.4.7",
62
- "nodemon": "^3.0.3",
63
- "postcss": "^8.4.41",
64
- "tailwindcss": "^3.4.10",
65
- "typescript": "^5.2.2",
66
- "vite": "^5.3.4",
67
- "vitest": "^1.6.0",
68
- "@vitest/ui": "^1.6.0",
69
- "@vitest/coverage-v8": "^1.6.0",
70
- "@testing-library/react": "^14.3.1",
71
- "@testing-library/jest-dom": "^6.4.6",
72
- "@testing-library/user-event": "^14.5.2",
73
- "jsdom": "^24.1.0",
74
- "msw": "^2.3.1"
75
- }
76
- }