@friggframework/core 2.0.0--canary.686.df38e8e.0 → 2.0.0--canary.711.f8b6445.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 (211) hide show
  1. package/CHANGELOG.md +0 -16
  2. package/CLAUDE.md +40 -28
  3. package/README.md +0 -105
  4. package/application/commands/entity-commands.js +18 -60
  5. package/application/commands/integration-commands.js +73 -20
  6. package/application/commands/scheduler-commands.js +7 -11
  7. package/application/commands/user-commands.js +5 -17
  8. package/application/index.js +2 -6
  9. package/core/Worker.js +7 -31
  10. package/core/create-handler.js +0 -9
  11. package/credential/repositories/credential-repository-documentdb.js +0 -34
  12. package/credential/repositories/credential-repository-interface.js +0 -15
  13. package/credential/repositories/credential-repository-mongo.js +0 -23
  14. package/credential/repositories/credential-repository-postgres.js +0 -28
  15. package/database/config.js +24 -48
  16. package/database/documentdb-encryption-service.js +22 -9
  17. package/database/documentdb-utils.js +0 -2
  18. package/database/encryption/README.md +14 -78
  19. package/database/encryption/documentdb-encryption-service.md +1 -78
  20. package/database/encryption/encryption-schema-registry.js +24 -121
  21. package/database/encryption/field-encryption-service.js +5 -69
  22. package/database/encryption/integration-mapping-encryption.js +1 -1
  23. package/database/prisma.js +38 -15
  24. package/database/use-cases/check-encryption-health-use-case.js +52 -43
  25. package/errors/index.js +4 -0
  26. package/errors/mapping-already-exists-error.js +14 -0
  27. package/generated/prisma-mongodb/edge.js +4 -43
  28. package/generated/prisma-mongodb/index-browser.js +1 -40
  29. package/generated/prisma-mongodb/index.d.ts +111 -4739
  30. package/generated/prisma-mongodb/index.js +4 -43
  31. package/generated/prisma-mongodb/package.json +1 -1
  32. package/generated/prisma-mongodb/schema.prisma +0 -92
  33. package/generated/prisma-mongodb/wasm.js +4 -43
  34. package/generated/prisma-postgresql/edge.js +4 -43
  35. package/generated/prisma-postgresql/index-browser.js +1 -40
  36. package/generated/prisma-postgresql/index.d.ts +33 -4966
  37. package/generated/prisma-postgresql/index.js +4 -43
  38. package/generated/prisma-postgresql/package.json +1 -1
  39. package/generated/prisma-postgresql/schema.prisma +0 -87
  40. package/generated/prisma-postgresql/wasm.js +4 -43
  41. package/handlers/WEBHOOKS.md +29 -0
  42. package/handlers/app-definition-loader.js +19 -121
  43. package/handlers/app-handler-helpers.js +3 -25
  44. package/handlers/backend-utils.js +25 -31
  45. package/handlers/middleware/admin-auth.js +1 -14
  46. package/handlers/routers/auth.js +10 -46
  47. package/handlers/routers/health.js +4 -13
  48. package/handlers/routers/integration-defined-routers.js +92 -144
  49. package/handlers/routers/integration-webhook-routers.js +64 -102
  50. package/handlers/workers/integration-defined-workers.js +2 -5
  51. package/index.js +3 -65
  52. package/infrastructure/scheduler/eventbridge-scheduler-adapter.js +67 -13
  53. package/infrastructure/scheduler/index.js +6 -19
  54. package/infrastructure/scheduler/scheduler-service-factory.js +7 -55
  55. package/integrations/index.js +0 -1
  56. package/integrations/integration-base.js +29 -0
  57. package/integrations/integration-router.js +96 -131
  58. package/integrations/repositories/integration-mapping-repository-documentdb.js +50 -0
  59. package/integrations/repositories/integration-mapping-repository-interface.js +15 -0
  60. package/integrations/repositories/integration-mapping-repository-mongo.js +29 -0
  61. package/integrations/repositories/integration-mapping-repository-postgres.js +30 -0
  62. package/integrations/repositories/integration-mapping-repository.js +29 -0
  63. package/integrations/repositories/integration-repository-documentdb.js +35 -35
  64. package/integrations/repositories/integration-repository-interface.js +31 -17
  65. package/integrations/repositories/integration-repository-mongo.js +129 -60
  66. package/integrations/repositories/integration-repository-postgres.js +134 -62
  67. package/integrations/repositories/process-repository-mongo.js +1 -1
  68. package/integrations/tests/doubles/test-integration-repository.js +1 -12
  69. package/integrations/use-cases/add-entities-to-integration.js +92 -0
  70. package/integrations/use-cases/create-integration.js +75 -72
  71. package/integrations/use-cases/get-integrations-for-user.js +40 -80
  72. package/integrations/use-cases/index.js +1 -7
  73. package/integrations/use-cases/remove-entities-from-integration.js +70 -0
  74. package/integrations/utils/assert-entity-ids-input.js +42 -0
  75. package/integrations/utils/map-integration-dto.js +14 -43
  76. package/modules/index.js +0 -14
  77. package/modules/module-factory.js +0 -12
  78. package/modules/module.js +2 -53
  79. package/modules/repositories/module-repository-documentdb.js +6 -51
  80. package/modules/repositories/module-repository-interface.js +2 -19
  81. package/modules/repositories/module-repository-mongo.js +74 -67
  82. package/modules/repositories/module-repository-postgres.js +74 -66
  83. package/modules/repositories/module-repository.js +1 -2
  84. package/modules/requester/requester.js +2 -27
  85. package/modules/use-cases/get-entities-for-user.js +13 -26
  86. package/modules/use-cases/get-entity-options-by-id.js +4 -10
  87. package/modules/use-cases/get-entity-options-by-type.js +1 -1
  88. package/modules/use-cases/get-module-instance-from-type.js +1 -1
  89. package/modules/use-cases/get-module.js +4 -10
  90. package/modules/use-cases/process-authorization-callback.js +19 -53
  91. package/modules/use-cases/refresh-entity-options.js +4 -10
  92. package/modules/use-cases/test-module-auth.js +4 -10
  93. package/modules/utils/map-module-dto.js +5 -3
  94. package/modules/utils/to-credential-id.js +14 -0
  95. package/package.json +6 -6
  96. package/prisma-mongodb/schema.prisma +0 -92
  97. package/prisma-postgresql/schema.prisma +0 -87
  98. package/queues/index.js +0 -25
  99. package/types/index.d.ts +0 -2
  100. package/user/repositories/user-repository-documentdb.js +2 -27
  101. package/user/repositories/user-repository-interface.js +0 -18
  102. package/user/repositories/user-repository-mongo.js +0 -24
  103. package/user/repositories/user-repository-postgres.js +0 -18
  104. package/user/tests/doubles/test-user-repository.js +1 -1
  105. package/user/use-cases/authenticate-user.js +1 -7
  106. package/user/use-cases/get-user-from-adopter-jwt.js +124 -95
  107. package/user/use-cases/get-user-from-bearer-token.js +7 -2
  108. package/user/use-cases/get-user-from-x-frigg-headers.js +80 -83
  109. package/user/user.js +1 -64
  110. package/credential/use-cases/credential-operations-for-user.js +0 -202
  111. package/credential/use-cases/reauthorize-credential-for-user.js +0 -73
  112. package/database/encryption/encryption-config.js +0 -219
  113. package/database/encryption/test-support/fake-ciphertext.js +0 -15
  114. package/database/organization-where.js +0 -18
  115. package/database/unique-violation.js +0 -25
  116. package/extensions/bootstrap-runner.js +0 -43
  117. package/extensions/extension-loader.js +0 -187
  118. package/extensions/index.js +0 -41
  119. package/extensions/initialize-app.js +0 -123
  120. package/extensions/route-mounter.js +0 -103
  121. package/extensions/schema-composer.js +0 -188
  122. package/infrastructure/scheduler/netlify-scheduler-adapter.js +0 -220
  123. package/infrastructure/scheduler/scheduled-job-repository.js +0 -118
  124. package/integrations/repositories/integration-not-found.js +0 -14
  125. package/integrations/schedule-config.js +0 -80
  126. package/integrations/use-cases/dispatch-ongoing-syncs.js +0 -100
  127. package/integrations/use-cases/integration-operations-for-user.js +0 -256
  128. package/integrations/use-cases/resolve-integration-ownership.js +0 -177
  129. package/management-api/create-management-api-router.js +0 -49
  130. package/management-api/error-response.js +0 -116
  131. package/management-api/management-api-config.js +0 -151
  132. package/management-api/meta-router.js +0 -76
  133. package/management-api/openapi/build-openapi.js +0 -144
  134. package/management-api/openapi/components.js +0 -408
  135. package/management-api/openapi/v1-operations.js +0 -83
  136. package/management-api/openapi/v2-operations.js +0 -264
  137. package/management-api/route-registry.js +0 -411
  138. package/management-api/test-support/http-client.js +0 -39
  139. package/management-api/use-cases/get-management-api-meta.js +0 -57
  140. package/management-api/v1-deprecation.js +0 -120
  141. package/management-api/v2/create-v2-router.js +0 -85
  142. package/management-api/v2/dependencies.js +0 -281
  143. package/management-api/v2/dto.js +0 -143
  144. package/management-api/v2/handlers/authorization.js +0 -94
  145. package/management-api/v2/handlers/credentials.js +0 -33
  146. package/management-api/v2/handlers/entities.js +0 -77
  147. package/management-api/v2/handlers/integrations.js +0 -128
  148. package/management-api/v2/handlers/proxy.js +0 -34
  149. package/management-api/v2/request.js +0 -85
  150. package/management-api/v2/test-support/fake-dependencies.js +0 -103
  151. package/modules/domain/authorization-session.js +0 -144
  152. package/modules/entity-scope.js +0 -15
  153. package/modules/entity-type-registry.js +0 -311
  154. package/modules/proxy/proxy-errors.js +0 -20
  155. package/modules/proxy/proxy-path.js +0 -179
  156. package/modules/proxy/proxy-policy.js +0 -248
  157. package/modules/repositories/authorization-session-repository-documentdb.js +0 -112
  158. package/modules/repositories/authorization-session-repository-factory.js +0 -31
  159. package/modules/repositories/authorization-session-repository-interface.js +0 -47
  160. package/modules/repositories/authorization-session-repository-prisma.js +0 -87
  161. package/modules/repositories/entity-not-found.js +0 -18
  162. package/modules/requester/proxy-request.js +0 -244
  163. package/modules/scope-config.js +0 -192
  164. package/modules/scope-policy.js +0 -112
  165. package/modules/scope-resolution.js +0 -288
  166. package/modules/scope-visibility.js +0 -247
  167. package/modules/tests/doubles/in-memory-authorization-session-repository.js +0 -45
  168. package/modules/tests/doubles/ownership-matching.js +0 -18
  169. package/modules/use-cases/authorize-entity-for-user.js +0 -61
  170. package/modules/use-cases/create-entity-from-credential.js +0 -113
  171. package/modules/use-cases/entity-operations-for-user.js +0 -162
  172. package/modules/use-cases/entity-types.js +0 -139
  173. package/modules/use-cases/execute-entity-proxy-request.js +0 -286
  174. package/modules/use-cases/get-authorization-requirements.js +0 -100
  175. package/modules/use-cases/get-entity-module-for-user.js +0 -113
  176. package/modules/use-cases/manage-access.js +0 -21
  177. package/modules/use-cases/multi-step-authorization.js +0 -329
  178. package/prisma-postgresql/migrations/20261003000000_add_authorization_session/migration.sql +0 -28
  179. package/prisma-postgresql/migrations/20261015000000_add_organization_membership/migration.sql +0 -26
  180. package/prisma-postgresql/migrations/20261016000000_add_entity_integration_organization/migration.sql +0 -25
  181. package/prisma-postgresql/migrations/20261017000000_add_scheduled_job/migration.sql +0 -28
  182. package/providers/index.js +0 -23
  183. package/providers/resolve-provider.js +0 -93
  184. package/providers/runtime-detection.js +0 -124
  185. package/queues/providers/index.js +0 -11
  186. package/queues/providers/netlify-background-provider.js +0 -187
  187. package/queues/providers/qstash-queue-provider.js +0 -219
  188. package/queues/providers/sqs-queue-provider.js +0 -70
  189. package/queues/queue-client-interface.js +0 -55
  190. package/queues/queue-message-auth.js +0 -193
  191. package/queues/queue-provider-factory.js +0 -101
  192. package/queues/queue-provider.js +0 -65
  193. package/queues/sqs-queue-client.js +0 -81
  194. package/types/modules/index.d.ts +0 -197
  195. package/types/user/index.d.ts +0 -134
  196. package/user/adopter-jwt-config.js +0 -177
  197. package/user/adopter-jwt-errors.js +0 -59
  198. package/user/adopter-token-verifier.js +0 -122
  199. package/user/app-user-helpers.js +0 -97
  200. package/user/create-user-authentication.js +0 -64
  201. package/user/membership.js +0 -51
  202. package/user/repositories/organization-membership-record.js +0 -19
  203. package/user/repositories/organization-membership-repository-documentdb.js +0 -106
  204. package/user/repositories/organization-membership-repository-factory.js +0 -42
  205. package/user/repositories/organization-membership-repository-interface.js +0 -57
  206. package/user/repositories/organization-membership-repository-mongo.js +0 -13
  207. package/user/repositories/organization-membership-repository-postgres.js +0 -29
  208. package/user/repositories/organization-membership-repository-prisma.js +0 -81
  209. package/user/tests/doubles/adopter-jwt-fixtures.js +0 -220
  210. package/user/use-cases/ensure-organization-membership.js +0 -92
  211. package/user/use-cases/find-individual-users-by-organization.js +0 -54
@@ -1,220 +0,0 @@
1
- /**
2
- * Netlify Scheduler Adapter
3
- *
4
- * Implements SchedulerServiceInterface for Netlify deployments.
5
- *
6
- * Netlify Scheduled Functions use cron syntax but are defined statically in
7
- * netlify.toml or via the @netlify/functions schedule() helper. They cannot
8
- * be created dynamically at runtime like EventBridge Scheduler.
9
- *
10
- * Strategy for one-time scheduled jobs on Netlify:
11
- * 1. Store the schedule in the database (same as mock adapter pattern)
12
- * 2. A Netlify Scheduled Function runs on a cron interval (e.g., every 5 min)
13
- * 3. The cron function queries for due schedules and dispatches them
14
- * to a background function for execution
15
- *
16
- * This is a "poll-and-dispatch" pattern vs EventBridge's "push" pattern.
17
- * Trade-off: slightly less precise timing (up to cron interval delay),
18
- * but works on any platform without cloud-specific scheduling APIs.
19
- *
20
- * For integrations that need the queue provider to dispatch jobs:
21
- * - queueResourceId maps to the background function URL path
22
- * - Payload is stored and forwarded when the cron fires
23
- */
24
-
25
- const { SchedulerServiceInterface } = require('./scheduler-service-interface');
26
- const {
27
- isBackgroundFunctionPath,
28
- } = require('../../queues/providers/netlify-background-provider');
29
-
30
- // The one queue worker every Netlify deployment has (provider-netlify's
31
- // worker-background function); it dispatches by integrationName.
32
- const DEFAULT_WORKER_PATH = '/.netlify/functions/worker-background';
33
- const DEFAULT_LEASE_MS = 5 * 60 * 1000;
34
-
35
- class NetlifySchedulerAdapter extends SchedulerServiceInterface {
36
- /**
37
- * @param {Object} options
38
- * @param {Object} options.repository - Repository for persisting schedules
39
- * Must implement: save(schedule), delete(scheduleName),
40
- * findByName(scheduleName), findDue(now)
41
- * @param {Object} [options.queueProvider] - Queue provider for dispatching due jobs
42
- * @param {number} [options.leaseMs] - how long a claimed (PROCESSING) job
43
- * is held before another tick may take it again (default 5 minutes,
44
- * well past a Netlify scheduled function's 60-second limit)
45
- */
46
- constructor(options = {}) {
47
- super();
48
- this.repository = options.repository;
49
- this.queueProvider = options.queueProvider;
50
- this.leaseMs = options.leaseMs ?? DEFAULT_LEASE_MS;
51
-
52
- if (!this.repository) {
53
- console.warn(
54
- '[NetlifyScheduler] No repository provided. ' +
55
- 'Schedules will be stored in memory (lost on function restart). ' +
56
- 'Provide a database-backed repository for production use.'
57
- );
58
- this._inMemorySchedules = new Map();
59
- }
60
- }
61
-
62
- /**
63
- * Where a due job is sent. Netlify has no per-integration queues, so an
64
- * SQS-style queue URL (often unset here) maps to the worker function.
65
- * A background function path ('/.netlify/functions/<name>-background')
66
- * is kept; any other value, including '//host/x' or a path with '..',
67
- * maps to the worker too, so a stored job can only ever reach a
68
- * background function on this site.
69
- *
70
- * @param {string} [queueUrl]
71
- * @returns {string} a path NetlifyBackgroundProvider.send() accepts
72
- */
73
- toQueueResourceId(queueUrl) {
74
- return isBackgroundFunctionPath(queueUrl) ? queueUrl : DEFAULT_WORKER_PATH;
75
- }
76
-
77
- async scheduleOneTime({
78
- scheduleName,
79
- scheduleAt,
80
- queueResourceId,
81
- payload,
82
- }) {
83
- if (!scheduleName) throw new Error('scheduleName is required');
84
- if (!scheduleAt || !(scheduleAt instanceof Date))
85
- throw new Error('scheduleAt must be a valid Date object');
86
- if (!queueResourceId) throw new Error('queueResourceId is required');
87
-
88
- const scheduleData = {
89
- scheduleName,
90
- scheduledAt: scheduleAt.toISOString(),
91
- queueResourceId,
92
- payload,
93
- createdAt: new Date().toISOString(),
94
- state: 'PENDING',
95
- };
96
-
97
- if (this.repository) {
98
- await this.repository.save(scheduleData);
99
- } else {
100
- this._inMemorySchedules.set(scheduleName, scheduleData);
101
- }
102
-
103
- console.log(
104
- `[NetlifyScheduler] Scheduled: ${scheduleName} for ${scheduleAt.toISOString()}`
105
- );
106
-
107
- return {
108
- scheduledJobId: `netlify-schedule-${scheduleName}`,
109
- scheduledAt: scheduleAt.toISOString(),
110
- };
111
- }
112
-
113
- async deleteSchedule(scheduleName) {
114
- if (!scheduleName) throw new Error('scheduleName is required');
115
-
116
- if (this.repository) {
117
- await this.repository.delete(scheduleName);
118
- } else {
119
- this._inMemorySchedules.delete(scheduleName);
120
- }
121
-
122
- console.log(`[NetlifyScheduler] Deleted schedule: ${scheduleName}`);
123
- }
124
-
125
- async getScheduleStatus(scheduleName) {
126
- if (!scheduleName) throw new Error('scheduleName is required');
127
-
128
- let schedule;
129
- if (this.repository) {
130
- schedule = await this.repository.findByName(scheduleName);
131
- } else {
132
- schedule = this._inMemorySchedules.get(scheduleName);
133
- }
134
-
135
- if (!schedule) {
136
- return { exists: false };
137
- }
138
-
139
- return {
140
- exists: true,
141
- scheduledAt: schedule.scheduledAt,
142
- state: schedule.state,
143
- };
144
- }
145
-
146
- /**
147
- * Process due schedules. Called by the Netlify cron function.
148
- *
149
- * Finds all schedules where scheduledAt <= now, dispatches them
150
- * to the queue provider, and marks them as completed.
151
- *
152
- * @returns {Promise<{ processed: number, errors: number }>}
153
- */
154
- async processDueSchedules() {
155
- if (!this.repository) {
156
- console.warn(
157
- '[NetlifyScheduler] Cannot process due schedules without a repository'
158
- );
159
- return { processed: 0, errors: 0, skipped: 0 };
160
- }
161
-
162
- const now = new Date();
163
- const lease = { leaseMs: this.leaseMs };
164
- const dueSchedules = await this.repository.findDue(now, lease);
165
-
166
- let processed = 0;
167
- let errors = 0;
168
- let skipped = 0;
169
-
170
- for (const schedule of dueSchedules) {
171
- try {
172
- // Claim before dispatch. Two overlapping ticks can both see
173
- // the row in findDue; only the one whose conditional update
174
- // wins sends it. A repository without claim() (a custom one)
175
- // keeps the old unconditional PROCESSING write.
176
- const claimed =
177
- typeof this.repository.claim === 'function'
178
- ? await this.repository.claim(schedule.scheduleName, now, lease)
179
- : (await this.repository.save({ ...schedule, state: 'PROCESSING' }), true);
180
- if (!claimed) {
181
- skipped++;
182
- continue;
183
- }
184
-
185
- if (this.queueProvider) {
186
- await this.queueProvider.send(
187
- schedule.payload,
188
- schedule.queueResourceId
189
- );
190
- } else {
191
- console.log(
192
- `[NetlifyScheduler] No queue provider — logging payload for: ${schedule.scheduleName}`,
193
- JSON.stringify(schedule.payload)
194
- );
195
- }
196
-
197
- await this.repository.delete(schedule.scheduleName);
198
- processed++;
199
- } catch (error) {
200
- console.error(
201
- `[NetlifyScheduler] Error processing schedule ${schedule.scheduleName}:`,
202
- error
203
- );
204
- // Mark as FAILED so it won't be re-dispatched automatically.
205
- // Operators can inspect FAILED schedules and retry manually.
206
- await this.repository
207
- .save({ ...schedule, state: 'FAILED' })
208
- .catch(() => {});
209
- errors++;
210
- }
211
- }
212
-
213
- console.log(
214
- `[NetlifyScheduler] Processed ${processed} due schedules, ${errors} errors, ${skipped} claimed elsewhere`
215
- );
216
- return { processed, errors, skipped };
217
- }
218
- }
219
-
220
- module.exports = { NetlifySchedulerAdapter, DEFAULT_WORKER_PATH, DEFAULT_LEASE_MS };
@@ -1,118 +0,0 @@
1
- /**
2
- * Scheduled Job Repository
3
- *
4
- * Prisma-based implementation of the repository interface required by
5
- * NetlifySchedulerAdapter. Persists one-time scheduled jobs to the
6
- * ScheduledJob model so they survive function restarts.
7
- *
8
- * Repository interface:
9
- * save(scheduleData) — Upsert a scheduled job
10
- * delete(scheduleName) — Remove a scheduled job
11
- * findByName(scheduleName) — Find a single scheduled job
12
- * findDue(now, { leaseMs }) — Find due jobs: PENDING, or PROCESSING with an
13
- * expired lease (a dispatcher that died after
14
- * claiming), where scheduledAt <= now
15
- * claim(scheduleName, now, { leaseMs })
16
- * — Atomically move one due job to PROCESSING;
17
- * true only for the one caller that won it
18
- *
19
- * The lease clock is the row's updatedAt: a claim writes it, so a PROCESSING
20
- * row whose updatedAt is older than now - leaseMs is claimable again.
21
- */
22
-
23
- const DEFAULT_LEASE_MS = 5 * 60 * 1000;
24
-
25
- // Rows a dispatcher may take: never claimed, or claimed by one that has not
26
- // finished within the lease.
27
- function claimableWhere(now, leaseMs = DEFAULT_LEASE_MS) {
28
- return {
29
- OR: [
30
- { state: 'PENDING' },
31
- {
32
- state: 'PROCESSING',
33
- updatedAt: { lt: new Date(now.getTime() - leaseMs) },
34
- },
35
- ],
36
- };
37
- }
38
-
39
- class ScheduledJobRepository {
40
- /**
41
- * @param {Object} options
42
- * @param {import('@prisma/client').PrismaClient} options.prismaClient
43
- */
44
- constructor({ prismaClient }) {
45
- if (!prismaClient) {
46
- throw new Error(
47
- 'ScheduledJobRepository requires a prismaClient instance'
48
- );
49
- }
50
- this.prisma = prismaClient;
51
- }
52
-
53
- async save(scheduleData) {
54
- return this.prisma.scheduledJob.upsert({
55
- where: { scheduleName: scheduleData.scheduleName },
56
- update: {
57
- scheduledAt: new Date(scheduleData.scheduledAt),
58
- queueResourceId: scheduleData.queueResourceId,
59
- payload: scheduleData.payload ?? undefined,
60
- state: scheduleData.state || 'PENDING',
61
- },
62
- create: {
63
- scheduleName: scheduleData.scheduleName,
64
- scheduledAt: new Date(scheduleData.scheduledAt),
65
- queueResourceId: scheduleData.queueResourceId,
66
- payload: scheduleData.payload ?? undefined,
67
- state: scheduleData.state || 'PENDING',
68
- },
69
- });
70
- }
71
-
72
- async delete(scheduleName) {
73
- try {
74
- await this.prisma.scheduledJob.delete({
75
- where: { scheduleName },
76
- });
77
- } catch (error) {
78
- // P2025 = record not found — safe to ignore on delete
79
- if (error.code !== 'P2025') {
80
- throw error;
81
- }
82
- }
83
- }
84
-
85
- async findByName(scheduleName) {
86
- return this.prisma.scheduledJob.findUnique({
87
- where: { scheduleName },
88
- });
89
- }
90
-
91
- async findDue(now, { leaseMs = DEFAULT_LEASE_MS } = {}) {
92
- return this.prisma.scheduledJob.findMany({
93
- where: {
94
- scheduledAt: { lte: now },
95
- ...claimableWhere(now, leaseMs),
96
- },
97
- orderBy: { scheduledAt: 'asc' },
98
- });
99
- }
100
-
101
- /**
102
- * Conditional update: only a row that is still claimable moves to
103
- * PROCESSING, so of two overlapping ticks exactly one gets count === 1.
104
- * (PostgreSQL re-checks the WHERE on the row it locked; MongoDB updates
105
- * each document atomically.)
106
- *
107
- * @returns {Promise<boolean>} true when this caller claimed the job
108
- */
109
- async claim(scheduleName, now, { leaseMs = DEFAULT_LEASE_MS } = {}) {
110
- const { count } = await this.prisma.scheduledJob.updateMany({
111
- where: { scheduleName, ...claimableWhere(now, leaseMs) },
112
- data: { state: 'PROCESSING', updatedAt: now },
113
- });
114
- return count === 1;
115
- }
116
- }
117
-
118
- module.exports = { ScheduledJobRepository, DEFAULT_LEASE_MS };
@@ -1,14 +0,0 @@
1
- /**
2
- * The error `findIntegrationById` throws for an id with no row, and the one
3
- * predicate that recognises it. The adapters build the error here and the
4
- * use cases match it here, so the message is written once and a missing
5
- * integration can be told from any other failure without widening a regex.
6
- */
7
- const MESSAGE = /^Integration with id .+ not found$/;
8
-
9
- const integrationNotFoundError = (id) =>
10
- new Error(`Integration with id ${id} not found`);
11
-
12
- const isIntegrationNotFound = (error) => MESSAGE.test(error?.message || '');
13
-
14
- module.exports = { integrationNotFoundError, isIntegrationNotFound };
@@ -1,80 +0,0 @@
1
- /**
2
- * An integration's schedule configuration (`static Definition.schedule`),
3
- * read by hosts that tick ONGOING_SYNC from a cron (provider-netlify's
4
- * scheduled-sync function).
5
- *
6
- * schedule: {
7
- * // 'class' (default): one ONGOING_SYNC per integration class per tick,
8
- * // with no integration id: the worker runs it on an unhydrated
9
- * // instance, so the handler finds its own installations.
10
- * // 'installation': one ONGOING_SYNC per ENABLED integration record of
11
- * // the class, carrying `data.integrationId`, so the worker hydrates
12
- * // that installation before the handler runs.
13
- * scope: 'installation',
14
- * // Optional, 'installation' only: (integration, { now }) => boolean |
15
- * // Promise<boolean>. Return false to skip that installation this tick.
16
- * // Without it every installation is dispatched on every tick.
17
- * isDue: (integration, { now }) => true,
18
- * }
19
- *
20
- * Validated at load (loadAppDefinition) so a mistyped scope stops the app
21
- * rather than silently falling back to 'class'.
22
- */
23
-
24
- const SCHEDULE_SCOPES = Object.freeze({
25
- CLASS: 'class',
26
- INSTALLATION: 'installation',
27
- });
28
-
29
- const DEFAULT_SCHEDULE_SCOPE = SCHEDULE_SCOPES.CLASS;
30
-
31
- class ScheduleConfigError extends Error {
32
- constructor(message) {
33
- super(message);
34
- this.name = 'ScheduleConfigError';
35
- this.code = 'SCHEDULE_CONFIG_INVALID';
36
- }
37
- }
38
-
39
- /**
40
- * @param {Object} [definition] - an integration's static Definition
41
- * @returns {{ scope: 'class'|'installation', isDue: Function|null }}
42
- * @throws {ScheduleConfigError} when `schedule` is malformed
43
- */
44
- function resolveScheduleConfig(definition) {
45
- const name = definition?.name || 'integration';
46
- const schedule = definition?.schedule;
47
- if (schedule === undefined || schedule === null) {
48
- return { scope: DEFAULT_SCHEDULE_SCOPE, isDue: null };
49
- }
50
- if (typeof schedule !== 'object' || Array.isArray(schedule)) {
51
- throw new ScheduleConfigError(`${name}: Definition.schedule must be an object`);
52
- }
53
-
54
- const scopes = Object.values(SCHEDULE_SCOPES);
55
- const scope = schedule.scope === undefined ? DEFAULT_SCHEDULE_SCOPE : schedule.scope;
56
- if (!scopes.includes(scope)) {
57
- throw new ScheduleConfigError(
58
- `${name}: Definition.schedule.scope must be one of ${scopes.map((s) => `'${s}'`).join(', ')} (got ${JSON.stringify(schedule.scope)})`
59
- );
60
- }
61
-
62
- const isDue = schedule.isDue === undefined ? null : schedule.isDue;
63
- if (isDue !== null && typeof isDue !== 'function') {
64
- throw new ScheduleConfigError(`${name}: Definition.schedule.isDue must be a function`);
65
- }
66
- if (isDue && scope !== SCHEDULE_SCOPES.INSTALLATION) {
67
- throw new ScheduleConfigError(
68
- `${name}: Definition.schedule.isDue applies to scope 'installation' only`
69
- );
70
- }
71
-
72
- return { scope, isDue };
73
- }
74
-
75
- module.exports = {
76
- SCHEDULE_SCOPES,
77
- DEFAULT_SCHEDULE_SCOPE,
78
- ScheduleConfigError,
79
- resolveScheduleConfig,
80
- };
@@ -1,100 +0,0 @@
1
- const {
2
- SCHEDULE_SCOPES,
3
- resolveScheduleConfig,
4
- } = require('../schedule-config');
5
-
6
- const ONGOING_SYNC_EVENT = 'ONGOING_SYNC';
7
- const ACTIVE_STATUS = 'ENABLED';
8
-
9
- /**
10
- * Dispatches one cron tick of ONGOING_SYNC to the queue worker, per each
11
- * integration class's `Definition.schedule.scope` (schedule-config.js):
12
- *
13
- * - 'class' (default): one message per class, `data: {}`.
14
- * - 'installation': one message per ENABLED integration record of the class,
15
- * `data: { integrationId }`, so the worker hydrates that installation;
16
- * skipped when the definition's `isDue(integration, { now })` says no.
17
- *
18
- * Only classes that implement `startOngoingSync` take part. A failure for one
19
- * class or installation is counted and logged; the rest still go out.
20
- */
21
- class DispatchOngoingSyncs {
22
- /**
23
- * @param {Object} params
24
- * @param {Object} params.integrationRepository - findIntegrations({ type, status })
25
- * @param {Object} params.queueProvider - send(message, queueId)
26
- * @param {string} params.queueId - the worker the messages go to
27
- * @param {() => Date} [params.now]
28
- * @param {Object} [params.logger=console]
29
- */
30
- constructor({ integrationRepository, queueProvider, queueId, now = () => new Date(), logger = console }) {
31
- this.integrationRepository = integrationRepository;
32
- this.queueProvider = queueProvider;
33
- this.queueId = queueId;
34
- this.now = now;
35
- this.logger = logger;
36
- }
37
-
38
- /**
39
- * @param {Array<Function>} integrationClasses
40
- * @returns {Promise<{ dispatched: number, notDue: number, errors: number }>}
41
- */
42
- async execute(integrationClasses = []) {
43
- const result = { dispatched: 0, notDue: 0, errors: 0 };
44
- const now = this.now();
45
-
46
- for (const IntegrationClass of integrationClasses) {
47
- const name = IntegrationClass?.Definition?.name;
48
- if (!name) continue;
49
- if (typeof IntegrationClass.prototype?.startOngoingSync !== 'function') continue;
50
-
51
- try {
52
- const { scope, isDue } = resolveScheduleConfig(IntegrationClass.Definition);
53
- if (scope === SCHEDULE_SCOPES.INSTALLATION) {
54
- await this._dispatchPerInstallation(name, isDue, now, result);
55
- } else {
56
- await this._send(name, {});
57
- result.dispatched++;
58
- }
59
- } catch (error) {
60
- result.errors++;
61
- this.logger.error(`[ScheduledSync] Failed to dispatch sync for ${name}:`, error.message);
62
- }
63
- }
64
-
65
- return result;
66
- }
67
-
68
- async _dispatchPerInstallation(name, isDue, now, result) {
69
- const integrations = await this.integrationRepository.findIntegrations({
70
- type: name,
71
- status: ACTIVE_STATUS,
72
- });
73
-
74
- for (const integration of integrations || []) {
75
- try {
76
- if (isDue && (await isDue(integration, { now })) !== true) {
77
- result.notDue++;
78
- continue;
79
- }
80
- await this._send(name, { integrationId: integration.id });
81
- result.dispatched++;
82
- } catch (error) {
83
- result.errors++;
84
- this.logger.error(
85
- `[ScheduledSync] Failed to dispatch sync for ${name} integration ${integration?.id}:`,
86
- error.message
87
- );
88
- }
89
- }
90
- }
91
-
92
- _send(integrationName, data) {
93
- return this.queueProvider.send(
94
- { integrationName, event: ONGOING_SYNC_EVENT, data },
95
- this.queueId
96
- );
97
- }
98
- }
99
-
100
- module.exports = { DispatchOngoingSyncs, ONGOING_SYNC_EVENT };