@friggframework/core 2.0.0--canary.522.cbd3d5a.0 → 2.0.0--canary.517.35ee143.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.
- package/CHANGELOG.md +67 -66
- package/CLAUDE.md +124 -148
- package/README.md +130 -165
- package/admin-scripts/index.js +16 -30
- package/admin-scripts/repositories/{admin-api-key-repository-documentdb.js → admin-process-repository-documentdb.js} +5 -5
- package/admin-scripts/repositories/{admin-api-key-repository-factory.js → admin-process-repository-factory.js} +15 -19
- package/admin-scripts/repositories/admin-process-repository-interface.js +150 -0
- package/admin-scripts/repositories/admin-process-repository-mongo.js +213 -0
- package/admin-scripts/repositories/admin-process-repository-postgres.js +251 -0
- package/admin-scripts/repositories/script-schedule-repository-factory.js +2 -6
- package/admin-scripts/repositories/script-schedule-repository-interface.js +14 -36
- package/admin-scripts/repositories/script-schedule-repository-mongo.js +13 -25
- package/admin-scripts/repositories/script-schedule-repository-postgres.js +13 -25
- package/application/commands/admin-script-commands.js +102 -266
- package/application/commands/integration-commands.js +6 -12
- package/application/index.js +3 -1
- package/assertions/get.js +4 -1
- package/associations/association.js +57 -59
- package/associations/model.js +41 -41
- package/core/CLAUDE.md +156 -222
- package/core/Worker.js +1 -5
- package/credential/repositories/credential-repository-documentdb.js +1 -71
- package/credential/repositories/credential-repository-interface.js +2 -8
- package/credential/repositories/credential-repository-mongo.js +4 -45
- package/credential/repositories/credential-repository-postgres.js +3 -44
- package/credential/repositories/credential-repository.js +4 -6
- package/credential/use-cases/get-credential-for-user.js +3 -21
- package/credential/use-cases/update-authentication-status.js +2 -5
- package/database/MONGODB_TRANSACTION_FIX.md +52 -72
- package/database/adapters/lambda-invoker.js +7 -8
- package/database/config.js +13 -15
- package/database/documentdb-encryption-service.js +13 -29
- package/database/documentdb-utils.js +12 -21
- package/database/encryption/README.md +36 -53
- package/database/encryption/encryption-schema-registry.js +9 -21
- package/database/encryption/field-encryption-service.js +4 -15
- package/database/encryption/logger.js +2 -3
- package/database/encryption/prisma-encryption-extension.js +8 -5
- package/database/index.js +2 -4
- package/database/models/IndividualUser.js +15 -15
- package/database/models/OrganizationUser.js +4 -6
- package/database/models/UserModel.js +2 -2
- package/database/models/WebsocketConnection.js +1 -4
- package/database/mongoose.js +2 -2
- package/database/prisma.js +14 -22
- package/database/repositories/health-check-repository-documentdb.js +7 -22
- package/database/repositories/health-check-repository-factory.js +3 -9
- package/database/repositories/health-check-repository-interface.js +5 -15
- package/database/repositories/health-check-repository-mongodb.js +6 -9
- package/database/repositories/health-check-repository-postgres.js +1 -1
- package/database/repositories/migration-status-repository-s3.js +5 -10
- package/database/use-cases/check-database-health-use-case.js +2 -3
- package/database/use-cases/check-database-state-use-case.js +7 -9
- package/database/use-cases/get-database-state-via-worker-use-case.js +12 -15
- package/database/use-cases/get-migration-status-use-case.js +2 -4
- package/database/use-cases/run-database-migration-use-case.js +9 -41
- package/database/use-cases/test-encryption-use-case.js +5 -4
- package/database/use-cases/trigger-database-migration-use-case.js +8 -9
- package/database/utils/mongodb-collection-utils.js +3 -11
- package/database/utils/mongodb-schema-init.js +4 -10
- package/database/utils/prisma-runner.js +74 -144
- package/database/utils/prisma-schema-parser.js +2 -2
- package/docs/PROCESS_MANAGEMENT_QUEUE_SPEC.md +80 -135
- package/encrypt/Cryptor.js +2 -8
- package/errors/fetch-error.js +1 -1
- package/generated/prisma-mongodb/edge.js +16 -59
- package/generated/prisma-mongodb/index-browser.js +12 -62
- package/generated/prisma-mongodb/index.d.ts +4850 -8136
- package/generated/prisma-mongodb/index.js +16 -59
- package/generated/prisma-mongodb/package.json +1 -1
- package/generated/prisma-mongodb/schema.prisma +33 -75
- package/generated/prisma-mongodb/wasm.js +16 -59
- package/generated/prisma-postgresql/edge.js +15 -59
- package/generated/prisma-postgresql/index-browser.js +11 -62
- package/generated/prisma-postgresql/index.d.ts +5963 -8930
- package/generated/prisma-postgresql/index.js +15 -59
- package/generated/prisma-postgresql/package.json +1 -1
- package/generated/prisma-postgresql/schema.prisma +33 -73
- package/generated/prisma-postgresql/wasm.js +15 -59
- package/handlers/WEBHOOKS.md +81 -104
- package/handlers/app-definition-loader.js +1 -1
- package/handlers/app-handler-helpers.js +2 -14
- package/handlers/backend-utils.js +1 -0
- package/handlers/database-migration-handler.js +45 -64
- package/handlers/middleware/admin-auth.js +53 -0
- package/handlers/routers/HEALTHCHECK.md +135 -170
- package/handlers/routers/auth.js +2 -23
- package/handlers/routers/db-migration.handler.js +3 -2
- package/handlers/routers/db-migration.js +33 -69
- package/handlers/routers/health.js +8 -23
- package/handlers/routers/integration-defined-routers.js +4 -4
- package/handlers/routers/integration-webhook-routers.js +7 -17
- package/handlers/routers/websocket.js +3 -9
- package/handlers/use-cases/check-integrations-health-use-case.js +6 -13
- package/handlers/workers/db-migration.js +26 -54
- package/index.js +9 -5
- package/integrations/WEBHOOK-QUICKSTART.md +14 -21
- package/integrations/index.js +0 -4
- package/integrations/integration-base.js +6 -9
- package/integrations/integration-router.js +146 -1817
- package/integrations/options.js +20 -47
- package/integrations/repositories/integration-repository-documentdb.js +24 -53
- package/integrations/repositories/integration-repository-factory.js +2 -6
- package/integrations/repositories/integration-repository-interface.js +9 -27
- package/integrations/repositories/integration-repository-postgres.js +3 -3
- package/integrations/repositories/process-repository-factory.js +1 -0
- package/integrations/repositories/process-repository-interface.js +5 -9
- package/integrations/repositories/process-repository-mongo.js +3 -7
- package/integrations/repositories/process-repository-postgres.js +2 -2
- package/integrations/tests/doubles/config-capturing-integration.js +8 -9
- package/integrations/tests/doubles/dummy-integration-class.js +8 -81
- package/integrations/tests/doubles/test-integration-repository.js +11 -51
- package/integrations/use-cases/create-integration.js +32 -36
- package/integrations/use-cases/create-process.js +9 -20
- package/integrations/use-cases/delete-integration-for-user.js +4 -5
- package/integrations/use-cases/get-integration-for-user.js +10 -25
- package/integrations/use-cases/get-integration-instance-by-definition.js +7 -13
- package/integrations/use-cases/get-integrations-for-user.js +1 -4
- package/integrations/use-cases/get-possible-integrations.js +1 -1
- package/integrations/use-cases/get-process.js +6 -5
- package/integrations/use-cases/index.js +1 -3
- package/integrations/use-cases/load-integration-context.js +5 -1
- package/integrations/use-cases/update-process-state.js +8 -10
- package/integrations/utils/map-integration-dto.js +3 -9
- package/jest-setup.js +1 -1
- package/jest-teardown.js +1 -1
- package/lambda/TimeoutCatcher.js +30 -32
- package/lambda/index.js +1 -1
- package/logs/index.js +3 -3
- package/modules/module.js +1 -3
- package/modules/repositories/module-repository-documentdb.js +48 -114
- package/modules/repositories/module-repository-interface.js +0 -13
- package/modules/repositories/module-repository-mongo.js +6 -46
- package/modules/repositories/module-repository-postgres.js +6 -48
- package/modules/repositories/module-repository.js +1 -34
- package/modules/requester/api-key.js +2 -0
- package/modules/requester/basic.js +1 -0
- package/modules/requester/oauth-2.js +2 -3
- package/modules/test/mock-api/definition.js +10 -15
- package/modules/test/mock-api/mocks/hubspot.js +36 -36
- package/modules/tests/doubles/test-module-factory.js +4 -10
- package/modules/tests/doubles/test-module-repository.js +1 -1
- package/modules/use-cases/get-entities-for-user.js +1 -1
- package/modules/use-cases/get-entity-options-by-id.js +6 -8
- package/modules/use-cases/get-module.js +9 -12
- package/modules/use-cases/process-authorization-callback.js +6 -12
- package/modules/use-cases/refresh-entity-options.js +6 -8
- package/modules/use-cases/test-module-auth.js +6 -8
- package/modules/utils/map-module-dto.js +2 -2
- package/package.json +5 -7
- package/prisma-mongodb/schema.prisma +33 -75
- package/prisma-postgresql/schema.prisma +33 -73
- package/queues/queuer-util.js +1 -5
- package/syncs/model.js +51 -51
- package/syncs/repositories/sync-repository-documentdb.js +19 -39
- package/syncs/repositories/sync-repository-interface.js +2 -6
- package/syncs/repositories/sync-repository-postgres.js +13 -19
- package/syncs/sync.js +100 -104
- package/token/repositories/token-repository-factory.js +3 -1
- package/types/assertions/index.d.ts +72 -72
- package/types/associations/index.d.ts +57 -57
- package/types/core/index.d.ts +53 -59
- package/types/database/index.d.ts +2 -2
- package/types/encrypt/index.d.ts +3 -3
- package/types/errors/index.d.ts +54 -61
- package/types/eslint-config/index.d.ts +40 -40
- package/types/integrations/index.d.ts +183 -185
- package/types/lambda/index.d.ts +26 -26
- package/types/logs/index.d.ts +4 -4
- package/types/module-plugin/index.d.ts +237 -239
- package/types/prettier-config/index.d.ts +5 -5
- package/types/syncs/index.d.ts +108 -102
- package/types/test-environment/index.d.ts +14 -14
- package/types/tsconfig.json +93 -95
- package/user/tests/doubles/test-user-repository.js +2 -5
- package/user/use-cases/authenticate-user.js +4 -2
- package/user/use-cases/authenticate-with-shared-secret.js +1 -1
- package/user/use-cases/create-individual-user.js +7 -8
- package/user/use-cases/create-organization-user.js +1 -1
- package/user/use-cases/create-token-for-user-id.js +1 -1
- package/user/use-cases/get-user-from-adopter-jwt.js +2 -0
- package/user/use-cases/get-user-from-bearer-token.js +3 -7
- package/user/use-cases/get-user-from-x-frigg-headers.js +11 -14
- package/user/use-cases/login-user.js +8 -8
- package/user/user.js +4 -18
- package/utils/backend-path.js +2 -2
- package/utils/index.js +1 -4
- package/websocket/repositories/websocket-connection-repository-documentdb.js +8 -21
- package/websocket/repositories/websocket-connection-repository-mongo.js +4 -8
- package/websocket/repositories/websocket-connection-repository-postgres.js +4 -8
- package/websocket/repositories/websocket-connection-repository.js +4 -8
- package/admin-scripts/repositories/admin-api-key-repository-interface.js +0 -121
- package/admin-scripts/repositories/admin-api-key-repository-mongo.js +0 -155
- package/admin-scripts/repositories/admin-api-key-repository-postgres.js +0 -189
- package/admin-scripts/repositories/script-execution-repository-documentdb.js +0 -21
- package/admin-scripts/repositories/script-execution-repository-factory.js +0 -55
- package/admin-scripts/repositories/script-execution-repository-interface.js +0 -193
- package/admin-scripts/repositories/script-execution-repository-mongo.js +0 -278
- package/admin-scripts/repositories/script-execution-repository-postgres.js +0 -320
- package/credential/credential-router.js +0 -262
- package/credential/use-cases/delete-credential-for-user.js +0 -50
- package/credential/use-cases/list-credentials-for-user.js +0 -31
- package/credential/use-cases/reauthorize-credential.js +0 -103
- package/handlers/routers/admin.js +0 -450
- package/handlers/routers/docs.js +0 -180
- package/handlers/routers/middleware/loadUser.js +0 -39
- package/handlers/routers/middleware/requireAdmin.js +0 -41
- package/handlers/routers/middleware/requireLoggedInUser.js +0 -19
- package/integrations/use-cases/execute-proxy-request.js +0 -564
- package/modules/domain/entities/AuthorizationSession.js +0 -131
- package/modules/domain/entities/index.js +0 -10
- package/modules/repositories/authorization-session-repository-factory.js +0 -55
- package/modules/repositories/authorization-session-repository-interface.js +0 -75
- package/modules/repositories/authorization-session-repository-mongo.js +0 -169
- package/modules/repositories/authorization-session-repository-postgres.js +0 -170
- package/modules/use-cases/delete-module-entity.js +0 -23
- package/modules/use-cases/get-authorization-requirements.js +0 -110
- package/modules/use-cases/get-module-entity-by-id.js +0 -16
- package/modules/use-cases/process-authorization-step.js +0 -160
- package/modules/use-cases/start-authorization-session.js +0 -86
- package/modules/use-cases/update-module-entity.js +0 -27
- package/openapi/openapi-spec-generator.js +0 -370
- package/openapi/openapi-v1.yaml +0 -1360
- package/openapi/openapi-v2.yaml +0 -1535
- package/user/use-cases/delete-user.js +0 -47
|
@@ -14,7 +14,7 @@ class MyIntegration extends IntegrationBase {
|
|
|
14
14
|
modules: {
|
|
15
15
|
myapi: { definition: MyApiDefinition },
|
|
16
16
|
},
|
|
17
|
-
webhooks: true,
|
|
17
|
+
webhooks: true, // ← Add this line
|
|
18
18
|
};
|
|
19
19
|
}
|
|
20
20
|
```
|
|
@@ -55,11 +55,10 @@ POST /api/my-integration-integration/webhooks/:integrationId
|
|
|
55
55
|
## That's It!
|
|
56
56
|
|
|
57
57
|
The default behavior handles:
|
|
58
|
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
- ✅ Calling your `onWebhook` handler
|
|
58
|
+
- ✅ Receiving webhooks (instant 200 OK response)
|
|
59
|
+
- ✅ Queuing to SQS
|
|
60
|
+
- ✅ Loading your integration with DB and API modules
|
|
61
|
+
- ✅ Calling your `onWebhook` handler
|
|
63
62
|
|
|
64
63
|
## Optional: Custom Signature Verification
|
|
65
64
|
|
|
@@ -86,24 +85,20 @@ async onWebhookReceived({ req, res }) {
|
|
|
86
85
|
## Two Webhook Routes
|
|
87
86
|
|
|
88
87
|
### With Integration ID (Recommended)
|
|
89
|
-
|
|
90
88
|
```
|
|
91
89
|
POST /api/{name}-integration/webhooks/:integrationId
|
|
92
90
|
```
|
|
93
|
-
|
|
94
|
-
-
|
|
95
|
-
-
|
|
96
|
-
- Use `this.myapi`, `this.config`, etc.
|
|
91
|
+
- Full integration loaded in worker
|
|
92
|
+
- Access to DB, config, and API modules
|
|
93
|
+
- Use `this.myapi`, `this.config`, etc.
|
|
97
94
|
|
|
98
95
|
### Without Integration ID
|
|
99
|
-
|
|
100
96
|
```
|
|
101
97
|
POST /api/{name}-integration/webhooks
|
|
102
98
|
```
|
|
103
|
-
|
|
104
|
-
-
|
|
105
|
-
-
|
|
106
|
-
- Limited context
|
|
99
|
+
- Unhydrated integration
|
|
100
|
+
- Useful for system-wide events
|
|
101
|
+
- Limited context
|
|
107
102
|
|
|
108
103
|
## Need Help?
|
|
109
104
|
|
|
@@ -112,7 +107,6 @@ See full documentation: `packages/core/handlers/WEBHOOKS.md`
|
|
|
112
107
|
## Common Patterns
|
|
113
108
|
|
|
114
109
|
### Slack
|
|
115
|
-
|
|
116
110
|
```javascript
|
|
117
111
|
async onWebhookReceived({ req, res }) {
|
|
118
112
|
if (req.body.type === 'url_verification') {
|
|
@@ -123,7 +117,6 @@ async onWebhookReceived({ req, res }) {
|
|
|
123
117
|
```
|
|
124
118
|
|
|
125
119
|
### Stripe
|
|
126
|
-
|
|
127
120
|
```javascript
|
|
128
121
|
async onWebhookReceived({ req, res }) {
|
|
129
122
|
const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);
|
|
@@ -138,7 +131,6 @@ async onWebhookReceived({ req, res }) {
|
|
|
138
131
|
```
|
|
139
132
|
|
|
140
133
|
### GitHub
|
|
141
|
-
|
|
142
134
|
```javascript
|
|
143
135
|
async onWebhookReceived({ req, res }) {
|
|
144
136
|
const crypto = require('crypto');
|
|
@@ -147,12 +139,13 @@ async onWebhookReceived({ req, res }) {
|
|
|
147
139
|
.createHmac('sha256', process.env.GITHUB_WEBHOOK_SECRET)
|
|
148
140
|
.update(JSON.stringify(req.body))
|
|
149
141
|
.digest('hex');
|
|
150
|
-
|
|
142
|
+
|
|
151
143
|
if (`sha256=${hash}` !== signature) {
|
|
152
144
|
return res.status(401).json({ error: 'Invalid signature' });
|
|
153
145
|
}
|
|
154
|
-
|
|
146
|
+
|
|
155
147
|
await this.queueWebhook({ integrationId: req.params.integrationId, body: req.body });
|
|
156
148
|
res.status(200).json({ received: true });
|
|
157
149
|
}
|
|
158
150
|
```
|
|
151
|
+
|
package/integrations/index.js
CHANGED
|
@@ -10,9 +10,6 @@ const {
|
|
|
10
10
|
const {
|
|
11
11
|
LoadIntegrationContextUseCase,
|
|
12
12
|
} = require('./use-cases/load-integration-context');
|
|
13
|
-
const {
|
|
14
|
-
createProcessRepository,
|
|
15
|
-
} = require('./repositories/process-repository-factory');
|
|
16
13
|
|
|
17
14
|
module.exports = {
|
|
18
15
|
IntegrationBase,
|
|
@@ -21,5 +18,4 @@ module.exports = {
|
|
|
21
18
|
checkRequiredParams,
|
|
22
19
|
getModulesDefinitionFromIntegrationClasses,
|
|
23
20
|
LoadIntegrationContextUseCase,
|
|
24
|
-
createProcessRepository,
|
|
25
21
|
};
|
|
@@ -204,11 +204,11 @@ class IntegrationBase {
|
|
|
204
204
|
/**
|
|
205
205
|
* Returns the modules as object with keys as module names.
|
|
206
206
|
* Uses the keys from Definition.modules to attach modules correctly.
|
|
207
|
-
*
|
|
207
|
+
*
|
|
208
208
|
* Example:
|
|
209
209
|
* Definition.modules = { attio: {...}, quo: { definition: { getName: () => 'quo-attio' } } }
|
|
210
210
|
* Module with getName()='quo-attio' gets attached as this.quo (not this['quo-attio'])
|
|
211
|
-
*
|
|
211
|
+
*
|
|
212
212
|
* @private
|
|
213
213
|
* @param {Array} integrationModules - Array of module instances
|
|
214
214
|
* @returns {Object} The modules object
|
|
@@ -220,16 +220,13 @@ class IntegrationBase {
|
|
|
220
220
|
// e.g., 'quo-attio' → 'quo', 'attio' → 'attio'
|
|
221
221
|
const moduleNameToKey = {};
|
|
222
222
|
if (this.constructor.Definition?.modules) {
|
|
223
|
-
for (const [key, moduleConfig] of Object.entries(
|
|
224
|
-
this.constructor.Definition.modules
|
|
225
|
-
)) {
|
|
223
|
+
for (const [key, moduleConfig] of Object.entries(this.constructor.Definition.modules)) {
|
|
226
224
|
const definition = moduleConfig.definition;
|
|
227
225
|
if (definition) {
|
|
228
226
|
// Use getName() if available, fallback to moduleName
|
|
229
|
-
const definitionName =
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
: definition.moduleName;
|
|
227
|
+
const definitionName = typeof definition.getName === 'function'
|
|
228
|
+
? definition.getName()
|
|
229
|
+
: definition.moduleName;
|
|
233
230
|
if (definitionName) {
|
|
234
231
|
moduleNameToKey[definitionName] = key;
|
|
235
232
|
}
|