@friggframework/core 2.0.0--canary.690.d043f23.0 → 2.0.0--canary.691.2fd013b.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 (193) hide show
  1. package/CLAUDE.md +0 -28
  2. package/README.md +0 -105
  3. package/application/commands/integration-commands.js +10 -20
  4. package/application/commands/scheduler-commands.js +7 -11
  5. package/application/commands/user-commands.js +5 -17
  6. package/application/index.js +2 -6
  7. package/core/Worker.js +7 -31
  8. package/core/create-handler.js +0 -9
  9. package/credential/repositories/credential-repository-documentdb.js +0 -34
  10. package/credential/repositories/credential-repository-interface.js +0 -15
  11. package/credential/repositories/credential-repository-mongo.js +0 -23
  12. package/credential/repositories/credential-repository-postgres.js +0 -28
  13. package/database/config.js +24 -48
  14. package/database/documentdb-utils.js +0 -2
  15. package/database/encryption/encryption-schema-registry.js +12 -93
  16. package/database/prisma.js +2 -4
  17. package/errors/index.js +4 -0
  18. package/errors/mapping-already-exists-error.js +14 -0
  19. package/generated/prisma-mongodb/edge.js +4 -43
  20. package/generated/prisma-mongodb/index-browser.js +1 -40
  21. package/generated/prisma-mongodb/index.d.ts +111 -4739
  22. package/generated/prisma-mongodb/index.js +4 -43
  23. package/generated/prisma-mongodb/package.json +1 -1
  24. package/generated/prisma-mongodb/schema.prisma +0 -92
  25. package/generated/prisma-mongodb/wasm.js +4 -43
  26. package/generated/prisma-postgresql/edge.js +4 -43
  27. package/generated/prisma-postgresql/index-browser.js +1 -40
  28. package/generated/prisma-postgresql/index.d.ts +33 -4966
  29. package/generated/prisma-postgresql/index.js +4 -43
  30. package/generated/prisma-postgresql/package.json +1 -1
  31. package/generated/prisma-postgresql/schema.prisma +0 -87
  32. package/generated/prisma-postgresql/wasm.js +4 -43
  33. package/handlers/WEBHOOKS.md +29 -0
  34. package/handlers/app-definition-loader.js +19 -118
  35. package/handlers/app-handler-helpers.js +3 -25
  36. package/handlers/backend-utils.js +25 -31
  37. package/handlers/middleware/admin-auth.js +1 -14
  38. package/handlers/routers/auth.js +10 -46
  39. package/handlers/routers/health.js +4 -11
  40. package/handlers/routers/integration-defined-routers.js +92 -144
  41. package/handlers/routers/integration-webhook-routers.js +64 -102
  42. package/handlers/workers/integration-defined-workers.js +2 -5
  43. package/index.js +3 -63
  44. package/infrastructure/scheduler/index.js +6 -19
  45. package/infrastructure/scheduler/scheduler-service-factory.js +7 -55
  46. package/integrations/index.js +0 -1
  47. package/integrations/integration-base.js +29 -0
  48. package/integrations/integration-router.js +96 -131
  49. package/integrations/repositories/integration-mapping-repository-documentdb.js +50 -0
  50. package/integrations/repositories/integration-mapping-repository-interface.js +15 -0
  51. package/integrations/repositories/integration-mapping-repository-mongo.js +29 -0
  52. package/integrations/repositories/integration-mapping-repository-postgres.js +30 -0
  53. package/integrations/repositories/integration-mapping-repository.js +29 -0
  54. package/integrations/repositories/integration-repository-documentdb.js +3 -35
  55. package/integrations/repositories/integration-repository-interface.js +1 -17
  56. package/integrations/repositories/integration-repository-mongo.js +77 -60
  57. package/integrations/repositories/integration-repository-postgres.js +76 -62
  58. package/integrations/repositories/process-repository-mongo.js +1 -1
  59. package/integrations/tests/doubles/test-integration-repository.js +1 -12
  60. package/integrations/use-cases/create-integration.js +20 -55
  61. package/integrations/use-cases/get-integrations-for-user.js +40 -80
  62. package/integrations/use-cases/index.js +1 -5
  63. package/integrations/utils/map-integration-dto.js +14 -43
  64. package/modules/index.js +0 -14
  65. package/modules/module-factory.js +0 -12
  66. package/modules/module.js +2 -53
  67. package/modules/repositories/module-repository-documentdb.js +6 -51
  68. package/modules/repositories/module-repository-interface.js +2 -19
  69. package/modules/repositories/module-repository-mongo.js +74 -67
  70. package/modules/repositories/module-repository-postgres.js +74 -66
  71. package/modules/repositories/module-repository.js +1 -2
  72. package/modules/requester/requester.js +2 -27
  73. package/modules/use-cases/get-entities-for-user.js +13 -26
  74. package/modules/use-cases/get-entity-options-by-id.js +4 -10
  75. package/modules/use-cases/get-entity-options-by-type.js +1 -1
  76. package/modules/use-cases/get-module-instance-from-type.js +1 -1
  77. package/modules/use-cases/get-module.js +4 -10
  78. package/modules/use-cases/process-authorization-callback.js +19 -53
  79. package/modules/use-cases/refresh-entity-options.js +4 -10
  80. package/modules/use-cases/test-module-auth.js +4 -10
  81. package/package.json +5 -6
  82. package/prisma-mongodb/schema.prisma +0 -92
  83. package/prisma-postgresql/schema.prisma +0 -87
  84. package/queues/index.js +0 -25
  85. package/types/index.d.ts +0 -2
  86. package/user/repositories/user-repository-documentdb.js +2 -27
  87. package/user/repositories/user-repository-interface.js +0 -18
  88. package/user/repositories/user-repository-mongo.js +0 -24
  89. package/user/repositories/user-repository-postgres.js +0 -18
  90. package/user/tests/doubles/test-user-repository.js +1 -1
  91. package/user/use-cases/authenticate-user.js +1 -7
  92. package/user/use-cases/get-user-from-adopter-jwt.js +124 -95
  93. package/user/use-cases/get-user-from-bearer-token.js +7 -2
  94. package/user/use-cases/get-user-from-x-frigg-headers.js +80 -83
  95. package/user/user.js +1 -64
  96. package/credential/use-cases/credential-operations-for-user.js +0 -202
  97. package/credential/use-cases/reauthorize-credential-for-user.js +0 -73
  98. package/database/organization-where.js +0 -18
  99. package/database/unique-violation.js +0 -25
  100. package/extensions/bootstrap-runner.js +0 -43
  101. package/extensions/extension-loader.js +0 -167
  102. package/extensions/index.js +0 -41
  103. package/extensions/initialize-app.js +0 -123
  104. package/extensions/route-mounter.js +0 -103
  105. package/extensions/schema-composer.js +0 -188
  106. package/infrastructure/scheduler/netlify-scheduler-adapter.js +0 -216
  107. package/infrastructure/scheduler/scheduled-job-repository.js +0 -118
  108. package/integrations/repositories/integration-not-found.js +0 -14
  109. package/integrations/use-cases/integration-operations-for-user.js +0 -256
  110. package/integrations/use-cases/resolve-integration-ownership.js +0 -177
  111. package/management-api/create-management-api-router.js +0 -49
  112. package/management-api/error-response.js +0 -116
  113. package/management-api/management-api-config.js +0 -151
  114. package/management-api/meta-router.js +0 -57
  115. package/management-api/openapi/build-openapi.js +0 -144
  116. package/management-api/openapi/components.js +0 -414
  117. package/management-api/openapi/v1-operations.js +0 -83
  118. package/management-api/openapi/v2-operations.js +0 -264
  119. package/management-api/route-registry.js +0 -294
  120. package/management-api/test-support/http-client.js +0 -39
  121. package/management-api/use-cases/get-management-api-meta.js +0 -57
  122. package/management-api/v1-deprecation.js +0 -120
  123. package/management-api/v2/create-v2-router.js +0 -85
  124. package/management-api/v2/dependencies.js +0 -281
  125. package/management-api/v2/dto.js +0 -143
  126. package/management-api/v2/handlers/authorization.js +0 -94
  127. package/management-api/v2/handlers/credentials.js +0 -33
  128. package/management-api/v2/handlers/entities.js +0 -77
  129. package/management-api/v2/handlers/integrations.js +0 -128
  130. package/management-api/v2/handlers/proxy.js +0 -34
  131. package/management-api/v2/request.js +0 -85
  132. package/management-api/v2/test-support/fake-dependencies.js +0 -103
  133. package/modules/domain/authorization-session.js +0 -144
  134. package/modules/entity-scope.js +0 -15
  135. package/modules/entity-type-registry.js +0 -311
  136. package/modules/proxy/proxy-bases.js +0 -169
  137. package/modules/proxy/proxy-errors.js +0 -31
  138. package/modules/proxy/proxy-path.js +0 -183
  139. package/modules/proxy/proxy-policy.js +0 -265
  140. package/modules/repositories/authorization-session-repository-documentdb.js +0 -112
  141. package/modules/repositories/authorization-session-repository-factory.js +0 -31
  142. package/modules/repositories/authorization-session-repository-interface.js +0 -47
  143. package/modules/repositories/authorization-session-repository-prisma.js +0 -87
  144. package/modules/repositories/entity-not-found.js +0 -18
  145. package/modules/requester/proxy-request.js +0 -245
  146. package/modules/scope-config.js +0 -192
  147. package/modules/scope-policy.js +0 -112
  148. package/modules/scope-resolution.js +0 -288
  149. package/modules/scope-visibility.js +0 -247
  150. package/modules/tests/doubles/in-memory-authorization-session-repository.js +0 -45
  151. package/modules/tests/doubles/ownership-matching.js +0 -18
  152. package/modules/use-cases/authorize-entity-for-user.js +0 -61
  153. package/modules/use-cases/create-entity-from-credential.js +0 -113
  154. package/modules/use-cases/entity-operations-for-user.js +0 -162
  155. package/modules/use-cases/entity-types.js +0 -139
  156. package/modules/use-cases/execute-entity-proxy-request.js +0 -331
  157. package/modules/use-cases/get-authorization-requirements.js +0 -100
  158. package/modules/use-cases/get-entity-module-for-user.js +0 -113
  159. package/modules/use-cases/manage-access.js +0 -21
  160. package/modules/use-cases/multi-step-authorization.js +0 -329
  161. package/prisma-postgresql/migrations/20261003000000_add_authorization_session/migration.sql +0 -28
  162. package/prisma-postgresql/migrations/20261015000000_add_organization_membership/migration.sql +0 -26
  163. package/prisma-postgresql/migrations/20261016000000_add_entity_integration_organization/migration.sql +0 -25
  164. package/prisma-postgresql/migrations/20261017000000_add_scheduled_job/migration.sql +0 -28
  165. package/providers/index.js +0 -13
  166. package/providers/resolve-provider.js +0 -93
  167. package/queues/providers/index.js +0 -11
  168. package/queues/providers/netlify-background-provider.js +0 -150
  169. package/queues/providers/qstash-queue-provider.js +0 -199
  170. package/queues/providers/sqs-queue-provider.js +0 -70
  171. package/queues/queue-client-interface.js +0 -55
  172. package/queues/queue-message-auth.js +0 -187
  173. package/queues/queue-provider-factory.js +0 -101
  174. package/queues/queue-provider.js +0 -65
  175. package/queues/sqs-queue-client.js +0 -81
  176. package/types/modules/index.d.ts +0 -214
  177. package/types/user/index.d.ts +0 -134
  178. package/user/adopter-jwt-config.js +0 -177
  179. package/user/adopter-jwt-errors.js +0 -59
  180. package/user/adopter-token-verifier.js +0 -122
  181. package/user/app-user-helpers.js +0 -97
  182. package/user/create-user-authentication.js +0 -64
  183. package/user/membership.js +0 -51
  184. package/user/repositories/organization-membership-record.js +0 -19
  185. package/user/repositories/organization-membership-repository-documentdb.js +0 -106
  186. package/user/repositories/organization-membership-repository-factory.js +0 -42
  187. package/user/repositories/organization-membership-repository-interface.js +0 -57
  188. package/user/repositories/organization-membership-repository-mongo.js +0 -13
  189. package/user/repositories/organization-membership-repository-postgres.js +0 -29
  190. package/user/repositories/organization-membership-repository-prisma.js +0 -81
  191. package/user/tests/doubles/adopter-jwt-fixtures.js +0 -220
  192. package/user/use-cases/ensure-organization-membership.js +0 -92
  193. package/user/use-cases/find-individual-users-by-organization.js +0 -54
package/user/user.js CHANGED
@@ -1,20 +1,5 @@
1
1
  const bcrypt = require('bcryptjs');
2
2
 
3
- /**
4
- * How the request that produced a `User` proved who it is. Set by
5
- * AuthenticateUser, never inferred from a missing value. Organization roles
6
- * (ADR-056 §3, §3.6) depend on it: a shared-secret caller is the app's own
7
- * backend and is trusted to manage; a Frigg bearer token keeps its pre-roles
8
- * behaviour unless the app opts in (`user.orgAdminGateBearerTokens`); an
9
- * adopter token has the role it carries, else the stored membership role,
10
- * else `MEMBER`.
11
- */
12
- const AUTH_SOURCES = Object.freeze({
13
- SHARED_SECRET: 'shared-secret',
14
- ADOPTER_JWT: 'adopter-jwt',
15
- BEARER_TOKEN: 'bearer-token',
16
- });
17
-
18
3
  /**
19
4
  * Represents a user in the system. The User class is a domain entity,
20
5
  * @class User
@@ -33,14 +18,6 @@ class User {
33
18
  this.individualUser = individualUser;
34
19
  this.organizationUser = organizationUser;
35
20
  this.usePassword = usePassword;
36
- // Organization role from an adopter token claim (ADR-056 §2), per
37
- // request. When present it wins over the stored membership role.
38
- this.orgRole = null;
39
- // The role stored on the person's membership of the active organization
40
- // (OrganizationMembership.orgRole); used when the token carries none.
41
- this.membershipRole = null;
42
- // How this request authenticated (one of AUTH_SOURCES); null until AuthenticateUser says.
43
- this.authSource = null;
44
21
 
45
22
  this.config = {
46
23
  primary,
@@ -49,17 +26,6 @@ class User {
49
26
  };
50
27
  }
51
28
 
52
- /**
53
- * The organization this request acts in (ADR-056 §3.6): the one the token or
54
- * `x-frigg-appOrgId` named, not the person's legacy `organizationId`
55
- * pointer. Null when the request has no organization.
56
- * @returns {string|null}
57
- */
58
- getActiveOrganizationId() {
59
- const id = this.organizationUser?.id;
60
- return id === undefined || id === null || id === '' ? null : String(id);
61
- }
62
-
63
29
  getPrimaryUser() {
64
30
  if (this.config.primary === 'organization') {
65
31
  return this.organizationUser;
@@ -67,11 +33,6 @@ class User {
67
33
  return this.individualUser;
68
34
  }
69
35
 
70
- /**
71
- * The id of the primary user. With `primary: 'organization'` this is the
72
- * active organization (the one the request named), never the organization
73
- * the person was first linked to.
74
- */
75
36
  getId() {
76
37
  return this.getPrimaryUser()?.id;
77
38
  }
@@ -104,30 +65,6 @@ class User {
104
65
  return this.config.individualUserRequired;
105
66
  }
106
67
 
107
- getAuthSource() {
108
- return this.authSource;
109
- }
110
-
111
- setAuthSource(authSource) {
112
- this.authSource = authSource ?? null;
113
- }
114
-
115
- getOrgRole() {
116
- return this.orgRole;
117
- }
118
-
119
- setOrgRole(orgRole) {
120
- this.orgRole = orgRole ?? null;
121
- }
122
-
123
- getMembershipRole() {
124
- return this.membershipRole;
125
- }
126
-
127
- setMembershipRole(membershipRole) {
128
- this.membershipRole = membershipRole ?? null;
129
- }
130
-
131
68
  getIndividualUser() {
132
69
  return this.individualUser;
133
70
  }
@@ -185,4 +122,4 @@ class User {
185
122
  }
186
123
  }
187
124
 
188
- module.exports = { User, AUTH_SOURCES };
125
+ module.exports = { User };
@@ -1,202 +0,0 @@
1
- const Boom = require('@hapi/boom');
2
- const {
3
- createScopePolicy,
4
- describeRecord,
5
- visibilityClauses,
6
- matchesListFilters,
7
- SCOPES,
8
- } = require('../../modules/entity-scope');
9
- const { assertCanManage } = require('../../modules/use-cases/manage-access');
10
-
11
- /**
12
- * Management API v2 credential operations (ADR-056 §3.4, §3.6). A credential
13
- * has no module name and no organization of its own:
14
- *
15
- * - its `type` and `entityIds` come from the entities that use it that the
16
- * caller may see, so the same person's account connected in two
17
- * organizations (one credential, two entities) lists in each organization
18
- * with that organization's entity only;
19
- * - who it belongs to is its OWNER (`credential.userId`), never the entities:
20
- * a credential an individual entity and an organization entity both point at
21
- * (possible only through legacy data) is described by whoever owns the
22
- * credential, so the answer cannot change with the order the entities load;
23
- * - a credential whose entities are all out of sight (another organization's)
24
- * is a 404, and one with no entities at all (its entity was deleted) is
25
- * visible to its owner only, as it was before scoping.
26
- */
27
-
28
- const credentialIdOf = (entity) => {
29
- const ref = entity.credential ?? entity.credentialId;
30
- if (ref === undefined || ref === null) return null;
31
- if (typeof ref === 'object') {
32
- const id = ref.id ?? ref._id;
33
- return id === undefined || id === null ? null : String(id);
34
- }
35
- return String(ref);
36
- };
37
-
38
- /** Adds `type` and `entityIds` from the user's entities to each credential. */
39
- function withEntityUsage(credentials, entities) {
40
- const usage = new Map();
41
- for (const entity of entities || []) {
42
- const credentialId = credentialIdOf(entity);
43
- if (!credentialId) continue;
44
- const entry = usage.get(credentialId) || { type: null, entityIds: [] };
45
- entry.type = entry.type || entity.moduleName || null;
46
- entry.entityIds.push(String(entity.id));
47
- usage.set(credentialId, entry);
48
- }
49
- return credentials.map((credential) => {
50
- const entry = usage.get(String(credential.id)) || {
51
- type: null,
52
- entityIds: [],
53
- };
54
- return { ...credential, type: entry.type, entityIds: entry.entityIds };
55
- });
56
- }
57
-
58
- /**
59
- * `{scope, owner, organizationId, access}` of a credential for this caller, or
60
- * null when its owner is neither the caller nor the active organization. Built
61
- * by `describeRecord` over the row a connection by this owner has: the
62
- * organization of a visible entity, else the one a new entity would get.
63
- */
64
- function credentialTenancy(credential, visibleEntities, ctx) {
65
- const entityOrg = visibleEntities.find(
66
- (entity) => entity.organizationId !== undefined && entity.organizationId !== null
67
- )?.organizationId;
68
- const organizationId =
69
- entityOrg ?? (ctx.individualAcross === 'all' ? null : ctx.activeOrgId);
70
- return describeRecord({ userId: credential.userId, organizationId }, ctx, 'entity');
71
- }
72
-
73
- /** The entities of `entities` the caller may see, each with its `tenancy`. */
74
- function visibleOf(entities, ctx) {
75
- const visible = [];
76
- for (const entity of entities || []) {
77
- const tenancy = describeRecord(entity, ctx, 'entity');
78
- if (tenancy) visible.push({ ...entity, tenancy });
79
- }
80
- return visible;
81
- }
82
-
83
- /**
84
- * The caller's credentials with their type, the entities of them they may see
85
- * and `tenancy`. Credentials with no entity at all are listed too, for the
86
- * person and the active organization that own them.
87
- */
88
- class ListCredentialsForUser {
89
- constructor({ credentialRepository, moduleRepository, scopePolicy }) {
90
- this.credentialRepository = credentialRepository;
91
- this.moduleRepository = moduleRepository;
92
- this.scopePolicy = scopePolicy || createScopePolicy();
93
- }
94
-
95
- /** @param {{scope?: string, owner?: string}} [filters] */
96
- async execute(user, filters = {}) {
97
- const ctx = this.scopePolicy.accessContext(user);
98
- const owners = [...new Set([ctx.callerId, ctx.activeOrgId].filter(Boolean))];
99
- const [found, perOwner, owned] = await Promise.all([
100
- this.moduleRepository.findEntitiesByOwnership(visibilityClauses(ctx, 'entity')),
101
- Promise.all(owners.map((id) => this.credentialRepository.findCredentialsByUserId(id))),
102
- // Every entity of those owners, in any organization: only to tell a credential
103
- // with no entity at all from one used elsewhere.
104
- Promise.all(owners.map((id) => this.moduleRepository.findEntitiesByUserId(id))),
105
- ]);
106
- const visible = visibleOf(found, ctx);
107
- const usedAnywhere = new Set(owned.flat().map(credentialIdOf).filter(Boolean));
108
- const listed = [];
109
- for (const credential of perOwner.flat().filter(Boolean)) {
110
- const id = String(credential.id);
111
- const referencing = visible.filter((entity) => credentialIdOf(entity) === id);
112
- if (referencing.length === 0 && usedAnywhere.has(id)) continue;
113
- const tenancy = credentialTenancy(credential, referencing, ctx);
114
- if (!tenancy || !matchesListFilters(tenancy, filters)) continue;
115
- listed.push({ ...withEntityUsage([credential], referencing)[0], tenancy });
116
- }
117
- return listed;
118
- }
119
- }
120
-
121
- /** One credential the caller may see: see the header. 404 otherwise. */
122
- class GetCredentialForUserV2 {
123
- constructor({ credentialRepository, moduleRepository, scopePolicy }) {
124
- this.credentialRepository = credentialRepository;
125
- this.moduleRepository = moduleRepository;
126
- this.scopePolicy = scopePolicy || createScopePolicy();
127
- }
128
-
129
- async execute(credentialId, user) {
130
- const notFound = () =>
131
- Boom.notFound(`Credential ${credentialId} not found`, {
132
- code: 'CREDENTIAL_NOT_FOUND',
133
- });
134
- let credential = null;
135
- try {
136
- credential = await this.credentialRepository.findCredentialById(
137
- credentialId
138
- );
139
- } catch (error) {
140
- if (!/Invalid ID|ObjectId|Malformed/i.test(error?.message || '')) {
141
- throw error;
142
- }
143
- }
144
- if (!credential) throw notFound();
145
- const ctx = this.scopePolicy.accessContext(user);
146
-
147
- const referencing =
148
- (await this.moduleRepository.findEntities({ credentialId: credential.id })) || [];
149
- const visible = visibleOf(referencing, ctx);
150
- if (referencing.length > 0 && visible.length === 0) throw notFound();
151
- const tenancy = credentialTenancy(credential, visible, ctx);
152
- if (!tenancy) throw notFound();
153
- return { ...withEntityUsage([credential], visible)[0], tenancy };
154
- }
155
- }
156
-
157
- /**
158
- * Deletes a credential the caller may manage. The entities that used it stay,
159
- * with their credential unset, so they show as needing re-authorization rather
160
- * than disappearing from integrations.
161
- *
162
- * Refuses with 409 `CREDENTIAL_SHARED` while an entity the caller cannot see
163
- * still uses it: one credential row serves the same provider account in every
164
- * organization, and deleting it from one would break the other. The message
165
- * says nothing about the other connections (not even how many): remove the
166
- * entities that use it, and it goes with the last one.
167
- */
168
- class DeleteCredentialForUser {
169
- constructor({ credentialRepository, moduleRepository, getCredentialForUser }) {
170
- this.credentialRepository = credentialRepository;
171
- this.moduleRepository = moduleRepository;
172
- this.getCredentialForUser = getCredentialForUser;
173
- }
174
-
175
- async execute(credentialId, user) {
176
- const credential = await this.getCredentialForUser.execute(
177
- credentialId,
178
- user
179
- );
180
- assertCanManage(credential.tenancy.access, `credential ${credential.id}`);
181
- const usedBy =
182
- (await this.moduleRepository.findEntities({ credentialId: credential.id })) || [];
183
- if (usedBy.length > credential.entityIds.length) {
184
- throw Boom.conflict(
185
- `Credential ${credential.id} is still in use by other connections and cannot be deleted from here`,
186
- { code: 'CREDENTIAL_SHARED' }
187
- );
188
- }
189
- for (const entityId of credential.entityIds) {
190
- await this.moduleRepository.unsetCredential(entityId);
191
- }
192
- await this.credentialRepository.deleteCredentialById(credential.id);
193
- return { id: String(credential.id), entityIds: credential.entityIds };
194
- }
195
- }
196
-
197
- module.exports = {
198
- ListCredentialsForUser,
199
- GetCredentialForUserV2,
200
- DeleteCredentialForUser,
201
- withEntityUsage,
202
- };
@@ -1,73 +0,0 @@
1
- const Boom = require('@hapi/boom');
2
- const { assertCanManage } = require('../../modules/use-cases/manage-access');
3
-
4
- /**
5
- * Re-authorization of a credential the caller owns (Management API v2). It
6
- * runs the same flow as /api/v2/authorize for the credential's entity type,
7
- * with the session bound to the credential so it cannot be reused for
8
- * anything else.
9
- */
10
- async function credentialEntityType(getCredentialForUser, credentialId, user) {
11
- const credential = await getCredentialForUser.execute(credentialId, user);
12
- if (!credential.type) {
13
- throw Boom.conflict(
14
- `Credential ${credentialId} is not used by any entity, so its type is unknown; authorize a new connection instead`,
15
- { code: 'CREDENTIAL_TYPE_UNKNOWN' }
16
- );
17
- }
18
- return {
19
- entityType: credential.type,
20
- credentialId: String(credential.id),
21
- // A re-authorization keeps the scope the connection already has.
22
- fixedScope: credential.tenancy?.scope,
23
- access: credential.tenancy?.access,
24
- };
25
- }
26
-
27
- /** GET /api/v2/credentials/:credentialId/reauthorize */
28
- class GetCredentialReauthorization {
29
- constructor({ getCredentialForUser, getAuthorizationStep }) {
30
- this.getCredentialForUser = getCredentialForUser;
31
- this.getAuthorizationStep = getAuthorizationStep;
32
- }
33
-
34
- async execute(credentialId, user, { step = 1, sessionId, state } = {}) {
35
- const { entityType, credentialId: boundCredentialId } =
36
- await credentialEntityType(this.getCredentialForUser, credentialId, user);
37
- return this.getAuthorizationStep.execute({
38
- user,
39
- entityType,
40
- credentialId: boundCredentialId,
41
- step,
42
- sessionId,
43
- state,
44
- });
45
- }
46
- }
47
-
48
- /** POST /api/v2/credentials/:credentialId/reauthorize */
49
- class ReauthorizeCredentialForUser {
50
- constructor({ getCredentialForUser, submitAuthorizationStep }) {
51
- this.getCredentialForUser = getCredentialForUser;
52
- this.submitAuthorizationStep = submitAuthorizationStep;
53
- }
54
-
55
- async execute(credentialId, user, { data, step = 1, sessionId } = {}) {
56
- const { access, ...binding } = await credentialEntityType(
57
- this.getCredentialForUser,
58
- credentialId,
59
- user
60
- );
61
- // A credential an organization owns: the organization's admins only.
62
- assertCanManage(access, `credential ${credentialId}`);
63
- return this.submitAuthorizationStep.execute({
64
- user,
65
- ...binding,
66
- data,
67
- step,
68
- sessionId,
69
- });
70
- }
71
- }
72
-
73
- module.exports = { GetCredentialReauthorization, ReauthorizeCredentialForUser };
@@ -1,18 +0,0 @@
1
- /**
2
- * The Prisma `where` fragment for an `organizationId` on MongoDB (ADR-056
3
- * §3.6), shared by the entity and integration adapters.
4
- *
5
- * Prisma on MongoDB: `null` matches only an explicit null and `isSet: false`
6
- * only a missing field. A row written before the column existed is the common
7
- * "no organization" case, so `null` here means both.
8
- */
9
- function organizationWhere(organizationId) {
10
- if (organizationId === null) {
11
- return {
12
- OR: [{ organizationId: null }, { organizationId: { isSet: false } }],
13
- };
14
- }
15
- return { organizationId };
16
- }
17
-
18
- module.exports = { organizationWhere };
@@ -1,25 +0,0 @@
1
- /** Mongo/DocumentDB duplicate-key error code. */
2
- const DUPLICATE_KEY_CODE = 11000;
3
- /** Prisma's unique-constraint error code (PostgreSQL and MongoDB). */
4
- const PRISMA_UNIQUE_CODE = 'P2002';
5
-
6
- /**
7
- * Whether `error` is a unique-constraint violation, however the database
8
- * layer raised it: a Prisma `P2002`, or a duplicate-key `11000`
9
- * (`documentdb-utils` `insertOne` sets `code` on the error it throws).
10
- * Matches on the code only, never on message text.
11
- *
12
- * @param {unknown} error
13
- * @returns {boolean}
14
- */
15
- function isUniqueViolation(error) {
16
- return (
17
- error?.code === PRISMA_UNIQUE_CODE || error?.code === DUPLICATE_KEY_CODE
18
- );
19
- }
20
-
21
- module.exports = {
22
- isUniqueViolation,
23
- DUPLICATE_KEY_CODE,
24
- PRISMA_UNIQUE_CODE,
25
- };
@@ -1,43 +0,0 @@
1
- /**
2
- * Bootstrap Runner
3
- *
4
- * Runs extension bootstrap functions in sequence.
5
- * Bootstrap hooks execute AFTER database connection but BEFORE integration
6
- * router creation. This is the right place for extensions to:
7
- *
8
- * - Load credentials from database into integration definitions
9
- * - Register additional middleware or services
10
- * - Perform one-time initialization
11
- *
12
- * @example
13
- * await runExtensionBootstraps(extensions, { prisma, appDefinition });
14
- */
15
-
16
- /**
17
- * Runs all extension bootstrap functions in sequence.
18
- *
19
- * @param {Array<Object>} extensions - Normalized extensions (from extension-loader)
20
- * @param {Object} context
21
- * @param {Object} context.prisma - Prisma client instance
22
- * @param {Object} context.appDefinition - Full app definition
23
- * @throws {Error} If any bootstrap function fails (fails fast)
24
- */
25
- async function runExtensionBootstraps(extensions, context = {}) {
26
- if (!extensions || extensions.length === 0) return;
27
-
28
- const { prisma, appDefinition } = context;
29
-
30
- for (const ext of extensions) {
31
- if (!ext.bootstrap) continue;
32
-
33
- try {
34
- await ext.bootstrap(prisma, appDefinition);
35
- } catch (error) {
36
- throw new Error(
37
- `Extension "${ext.name}" bootstrap failed: ${error.message}`
38
- );
39
- }
40
- }
41
- }
42
-
43
- module.exports = { runExtensionBootstraps };
@@ -1,167 +0,0 @@
1
- /**
2
- * Extension Loader
3
- *
4
- * Validates and normalizes extensions from the app definition.
5
- * Extensions allow integration developers to add custom Prisma models,
6
- * encryption schemas, routes, and bootstrap logic to a Frigg app.
7
- *
8
- * @example
9
- * const extensions = loadExtensions(appDefinition);
10
- * // extensions is a normalized array, safe to iterate
11
- */
12
-
13
- const path = require('path');
14
-
15
- /**
16
- * Validates a single extension definition.
17
- * @param {Object} ext - Raw extension config from app definition
18
- * @param {number} index - Position in the extensions array (for error messages)
19
- * @returns {{valid: boolean, errors: string[]}}
20
- */
21
- function validateExtension(ext, index) {
22
- const prefix = `extensions[${index}]`;
23
- const errors = [];
24
-
25
- if (!ext || typeof ext !== 'object') {
26
- errors.push(`${prefix}: must be an object`);
27
- return { valid: false, errors };
28
- }
29
-
30
- if (!ext.name || typeof ext.name !== 'string') {
31
- errors.push(`${prefix}.name: required string`);
32
- }
33
-
34
- // schema is optional — path to a .prisma file
35
- if (ext.schema !== undefined) {
36
- if (typeof ext.schema !== 'string') {
37
- errors.push(`${prefix}.schema: must be a string (path to .prisma file)`);
38
- } else if (!ext.schema.endsWith('.prisma')) {
39
- errors.push(`${prefix}.schema: must end with .prisma`);
40
- }
41
- }
42
-
43
- // encryption is optional — object with model names → { fields: [...] }
44
- if (ext.encryption !== undefined) {
45
- if (!ext.encryption || typeof ext.encryption !== 'object') {
46
- errors.push(`${prefix}.encryption: must be an object`);
47
- } else {
48
- for (const [model, config] of Object.entries(ext.encryption)) {
49
- if (!config || !Array.isArray(config.fields)) {
50
- errors.push(
51
- `${prefix}.encryption.${model}: must have a "fields" array`
52
- );
53
- }
54
- }
55
- }
56
- }
57
-
58
- // routes is optional — { path, handler }
59
- if (ext.routes !== undefined) {
60
- if (!ext.routes || typeof ext.routes !== 'object') {
61
- errors.push(`${prefix}.routes: must be an object with { path, handler }`);
62
- } else {
63
- if (!ext.routes.path || typeof ext.routes.path !== 'string') {
64
- errors.push(`${prefix}.routes.path: required string`);
65
- }
66
- if (!ext.routes.handler) {
67
- errors.push(`${prefix}.routes.handler: required (function or module path)`);
68
- }
69
- }
70
- }
71
-
72
- // bootstrap is optional — function or module path
73
- if (ext.bootstrap !== undefined) {
74
- if (typeof ext.bootstrap !== 'function' && typeof ext.bootstrap !== 'string') {
75
- errors.push(
76
- `${prefix}.bootstrap: must be a function or a string (module path)`
77
- );
78
- }
79
- }
80
-
81
- return { valid: errors.length === 0, errors };
82
- }
83
-
84
- /**
85
- * Loads and validates extensions from the app definition.
86
- *
87
- * @param {Object} appDefinition - The full app definition
88
- * @returns {Array<Object>} Normalized extensions array (empty if none)
89
- * @throws {Error} If any extension fails validation
90
- */
91
- function loadExtensions(appDefinition) {
92
- if (!appDefinition) return [];
93
-
94
- const raw = appDefinition.extensions;
95
- if (!raw) return [];
96
-
97
- if (!Array.isArray(raw)) {
98
- throw new Error('appDefinition.extensions must be an array');
99
- }
100
-
101
- if (raw.length === 0) return [];
102
-
103
- const allErrors = [];
104
-
105
- const normalized = raw.map((ext, index) => {
106
- const { valid, errors } = validateExtension(ext, index);
107
- if (!valid) {
108
- allErrors.push(...errors);
109
- return null;
110
- }
111
-
112
- // Normalize bootstrap — resolve string paths to functions
113
- let bootstrapFn = null;
114
- if (typeof ext.bootstrap === 'function') {
115
- bootstrapFn = ext.bootstrap;
116
- } else if (typeof ext.bootstrap === 'string') {
117
- bootstrapFn = require(ext.bootstrap);
118
- }
119
-
120
- // Normalize route handler — resolve string paths to functions
121
- let routeHandler = null;
122
- if (ext.routes) {
123
- if (typeof ext.routes.handler === 'function') {
124
- routeHandler = ext.routes.handler;
125
- } else if (typeof ext.routes.handler === 'string') {
126
- routeHandler = require(ext.routes.handler);
127
- } else {
128
- routeHandler = ext.routes.handler;
129
- }
130
- }
131
-
132
- return {
133
- name: ext.name,
134
- schema: ext.schema || null,
135
- encryption: ext.encryption || null,
136
- routes: ext.routes
137
- ? { path: ext.routes.path, handler: routeHandler }
138
- : null,
139
- bootstrap: bootstrapFn,
140
- };
141
- });
142
-
143
- if (allErrors.length > 0) {
144
- throw new Error(
145
- `Invalid extension configuration:\n- ${allErrors.join('\n- ')}`
146
- );
147
- }
148
-
149
- return normalized.filter(Boolean);
150
- }
151
-
152
- /**
153
- * Get extension schema file paths from loaded extensions.
154
- * @param {Array<Object>} extensions - Normalized extensions
155
- * @returns {string[]} Array of absolute paths to .prisma schema files
156
- */
157
- function getExtensionSchemaPaths(extensions) {
158
- return extensions
159
- .filter((ext) => ext.schema)
160
- .map((ext) => ext.schema);
161
- }
162
-
163
- module.exports = {
164
- loadExtensions,
165
- validateExtension,
166
- getExtensionSchemaPaths,
167
- };
@@ -1,41 +0,0 @@
1
- /**
2
- * Frigg Extension System
3
- *
4
- * Extensions allow integration developers to extend Frigg Core with:
5
- * - Custom Prisma models (schema composition)
6
- * - Encrypted fields (encryption registry merge)
7
- * - Admin API routes (route mounting)
8
- * - Bootstrap lifecycle hooks (credential loading, etc.)
9
- *
10
- * @module @friggframework/core/extensions
11
- */
12
-
13
- const { loadExtensions, validateExtension, getExtensionSchemaPaths } = require('./extension-loader');
14
- const { composeSchemas, extractModelBlocks, getSchemaFilePaths } = require('./schema-composer');
15
- const {
16
- mountExtensionRoutes,
17
- createExtensionRoutesRouter,
18
- } = require('./route-mounter');
19
- const { runExtensionBootstraps } = require('./bootstrap-runner');
20
- const { initializeApp, resetInitialization } = require('./initialize-app');
21
-
22
- module.exports = {
23
- // Extension loading & validation
24
- loadExtensions,
25
- validateExtension,
26
- getExtensionSchemaPaths,
27
-
28
- // Schema composition
29
- composeSchemas,
30
- extractModelBlocks,
31
- getSchemaFilePaths,
32
-
33
- // Route mounting
34
- mountExtensionRoutes,
35
- createExtensionRoutesRouter,
36
-
37
- // Bootstrap lifecycle
38
- runExtensionBootstraps,
39
- initializeApp,
40
- resetInitialization,
41
- };