@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.
- package/CLAUDE.md +0 -28
- package/README.md +0 -105
- package/application/commands/integration-commands.js +10 -20
- package/application/commands/scheduler-commands.js +7 -11
- package/application/commands/user-commands.js +5 -17
- package/application/index.js +2 -6
- package/core/Worker.js +7 -31
- package/core/create-handler.js +0 -9
- package/credential/repositories/credential-repository-documentdb.js +0 -34
- package/credential/repositories/credential-repository-interface.js +0 -15
- package/credential/repositories/credential-repository-mongo.js +0 -23
- package/credential/repositories/credential-repository-postgres.js +0 -28
- package/database/config.js +24 -48
- package/database/documentdb-utils.js +0 -2
- package/database/encryption/encryption-schema-registry.js +12 -93
- package/database/prisma.js +2 -4
- package/errors/index.js +4 -0
- package/errors/mapping-already-exists-error.js +14 -0
- package/generated/prisma-mongodb/edge.js +4 -43
- package/generated/prisma-mongodb/index-browser.js +1 -40
- package/generated/prisma-mongodb/index.d.ts +111 -4739
- package/generated/prisma-mongodb/index.js +4 -43
- package/generated/prisma-mongodb/package.json +1 -1
- package/generated/prisma-mongodb/schema.prisma +0 -92
- package/generated/prisma-mongodb/wasm.js +4 -43
- package/generated/prisma-postgresql/edge.js +4 -43
- package/generated/prisma-postgresql/index-browser.js +1 -40
- package/generated/prisma-postgresql/index.d.ts +33 -4966
- package/generated/prisma-postgresql/index.js +4 -43
- package/generated/prisma-postgresql/package.json +1 -1
- package/generated/prisma-postgresql/schema.prisma +0 -87
- package/generated/prisma-postgresql/wasm.js +4 -43
- package/handlers/WEBHOOKS.md +29 -0
- package/handlers/app-definition-loader.js +19 -118
- package/handlers/app-handler-helpers.js +3 -25
- package/handlers/backend-utils.js +25 -31
- package/handlers/middleware/admin-auth.js +1 -14
- package/handlers/routers/auth.js +10 -46
- package/handlers/routers/health.js +4 -11
- package/handlers/routers/integration-defined-routers.js +92 -144
- package/handlers/routers/integration-webhook-routers.js +64 -102
- package/handlers/workers/integration-defined-workers.js +2 -5
- package/index.js +3 -63
- package/infrastructure/scheduler/index.js +6 -19
- package/infrastructure/scheduler/scheduler-service-factory.js +7 -55
- package/integrations/index.js +0 -1
- package/integrations/integration-base.js +29 -0
- package/integrations/integration-router.js +96 -131
- package/integrations/repositories/integration-mapping-repository-documentdb.js +50 -0
- package/integrations/repositories/integration-mapping-repository-interface.js +15 -0
- package/integrations/repositories/integration-mapping-repository-mongo.js +29 -0
- package/integrations/repositories/integration-mapping-repository-postgres.js +30 -0
- package/integrations/repositories/integration-mapping-repository.js +29 -0
- package/integrations/repositories/integration-repository-documentdb.js +3 -35
- package/integrations/repositories/integration-repository-interface.js +1 -17
- package/integrations/repositories/integration-repository-mongo.js +77 -60
- package/integrations/repositories/integration-repository-postgres.js +76 -62
- package/integrations/repositories/process-repository-mongo.js +1 -1
- package/integrations/tests/doubles/test-integration-repository.js +1 -12
- package/integrations/use-cases/create-integration.js +20 -55
- package/integrations/use-cases/get-integrations-for-user.js +40 -80
- package/integrations/use-cases/index.js +1 -5
- package/integrations/utils/map-integration-dto.js +14 -43
- package/modules/index.js +0 -14
- package/modules/module-factory.js +0 -12
- package/modules/module.js +2 -53
- package/modules/repositories/module-repository-documentdb.js +6 -51
- package/modules/repositories/module-repository-interface.js +2 -19
- package/modules/repositories/module-repository-mongo.js +74 -67
- package/modules/repositories/module-repository-postgres.js +74 -66
- package/modules/repositories/module-repository.js +1 -2
- package/modules/requester/requester.js +2 -27
- package/modules/use-cases/get-entities-for-user.js +13 -26
- package/modules/use-cases/get-entity-options-by-id.js +4 -10
- package/modules/use-cases/get-entity-options-by-type.js +1 -1
- package/modules/use-cases/get-module-instance-from-type.js +1 -1
- package/modules/use-cases/get-module.js +4 -10
- package/modules/use-cases/process-authorization-callback.js +19 -53
- package/modules/use-cases/refresh-entity-options.js +4 -10
- package/modules/use-cases/test-module-auth.js +4 -10
- package/package.json +5 -6
- package/prisma-mongodb/schema.prisma +0 -92
- package/prisma-postgresql/schema.prisma +0 -87
- package/queues/index.js +0 -25
- package/types/index.d.ts +0 -2
- package/user/repositories/user-repository-documentdb.js +2 -27
- package/user/repositories/user-repository-interface.js +0 -18
- package/user/repositories/user-repository-mongo.js +0 -24
- package/user/repositories/user-repository-postgres.js +0 -18
- package/user/tests/doubles/test-user-repository.js +1 -1
- package/user/use-cases/authenticate-user.js +1 -7
- package/user/use-cases/get-user-from-adopter-jwt.js +124 -95
- package/user/use-cases/get-user-from-bearer-token.js +7 -2
- package/user/use-cases/get-user-from-x-frigg-headers.js +80 -83
- package/user/user.js +1 -64
- package/credential/use-cases/credential-operations-for-user.js +0 -202
- package/credential/use-cases/reauthorize-credential-for-user.js +0 -73
- package/database/organization-where.js +0 -18
- package/database/unique-violation.js +0 -25
- package/extensions/bootstrap-runner.js +0 -43
- package/extensions/extension-loader.js +0 -167
- package/extensions/index.js +0 -41
- package/extensions/initialize-app.js +0 -123
- package/extensions/route-mounter.js +0 -103
- package/extensions/schema-composer.js +0 -188
- package/infrastructure/scheduler/netlify-scheduler-adapter.js +0 -216
- package/infrastructure/scheduler/scheduled-job-repository.js +0 -118
- package/integrations/repositories/integration-not-found.js +0 -14
- package/integrations/use-cases/integration-operations-for-user.js +0 -256
- package/integrations/use-cases/resolve-integration-ownership.js +0 -177
- package/management-api/create-management-api-router.js +0 -49
- package/management-api/error-response.js +0 -116
- package/management-api/management-api-config.js +0 -151
- package/management-api/meta-router.js +0 -57
- package/management-api/openapi/build-openapi.js +0 -144
- package/management-api/openapi/components.js +0 -414
- package/management-api/openapi/v1-operations.js +0 -83
- package/management-api/openapi/v2-operations.js +0 -264
- package/management-api/route-registry.js +0 -294
- package/management-api/test-support/http-client.js +0 -39
- package/management-api/use-cases/get-management-api-meta.js +0 -57
- package/management-api/v1-deprecation.js +0 -120
- package/management-api/v2/create-v2-router.js +0 -85
- package/management-api/v2/dependencies.js +0 -281
- package/management-api/v2/dto.js +0 -143
- package/management-api/v2/handlers/authorization.js +0 -94
- package/management-api/v2/handlers/credentials.js +0 -33
- package/management-api/v2/handlers/entities.js +0 -77
- package/management-api/v2/handlers/integrations.js +0 -128
- package/management-api/v2/handlers/proxy.js +0 -34
- package/management-api/v2/request.js +0 -85
- package/management-api/v2/test-support/fake-dependencies.js +0 -103
- package/modules/domain/authorization-session.js +0 -144
- package/modules/entity-scope.js +0 -15
- package/modules/entity-type-registry.js +0 -311
- package/modules/proxy/proxy-bases.js +0 -169
- package/modules/proxy/proxy-errors.js +0 -31
- package/modules/proxy/proxy-path.js +0 -183
- package/modules/proxy/proxy-policy.js +0 -265
- package/modules/repositories/authorization-session-repository-documentdb.js +0 -112
- package/modules/repositories/authorization-session-repository-factory.js +0 -31
- package/modules/repositories/authorization-session-repository-interface.js +0 -47
- package/modules/repositories/authorization-session-repository-prisma.js +0 -87
- package/modules/repositories/entity-not-found.js +0 -18
- package/modules/requester/proxy-request.js +0 -245
- package/modules/scope-config.js +0 -192
- package/modules/scope-policy.js +0 -112
- package/modules/scope-resolution.js +0 -288
- package/modules/scope-visibility.js +0 -247
- package/modules/tests/doubles/in-memory-authorization-session-repository.js +0 -45
- package/modules/tests/doubles/ownership-matching.js +0 -18
- package/modules/use-cases/authorize-entity-for-user.js +0 -61
- package/modules/use-cases/create-entity-from-credential.js +0 -113
- package/modules/use-cases/entity-operations-for-user.js +0 -162
- package/modules/use-cases/entity-types.js +0 -139
- package/modules/use-cases/execute-entity-proxy-request.js +0 -331
- package/modules/use-cases/get-authorization-requirements.js +0 -100
- package/modules/use-cases/get-entity-module-for-user.js +0 -113
- package/modules/use-cases/manage-access.js +0 -21
- package/modules/use-cases/multi-step-authorization.js +0 -329
- package/prisma-postgresql/migrations/20261003000000_add_authorization_session/migration.sql +0 -28
- package/prisma-postgresql/migrations/20261015000000_add_organization_membership/migration.sql +0 -26
- package/prisma-postgresql/migrations/20261016000000_add_entity_integration_organization/migration.sql +0 -25
- package/prisma-postgresql/migrations/20261017000000_add_scheduled_job/migration.sql +0 -28
- package/providers/index.js +0 -13
- package/providers/resolve-provider.js +0 -93
- package/queues/providers/index.js +0 -11
- package/queues/providers/netlify-background-provider.js +0 -150
- package/queues/providers/qstash-queue-provider.js +0 -199
- package/queues/providers/sqs-queue-provider.js +0 -70
- package/queues/queue-client-interface.js +0 -55
- package/queues/queue-message-auth.js +0 -187
- package/queues/queue-provider-factory.js +0 -101
- package/queues/queue-provider.js +0 -65
- package/queues/sqs-queue-client.js +0 -81
- package/types/modules/index.d.ts +0 -214
- package/types/user/index.d.ts +0 -134
- package/user/adopter-jwt-config.js +0 -177
- package/user/adopter-jwt-errors.js +0 -59
- package/user/adopter-token-verifier.js +0 -122
- package/user/app-user-helpers.js +0 -97
- package/user/create-user-authentication.js +0 -64
- package/user/membership.js +0 -51
- package/user/repositories/organization-membership-record.js +0 -19
- package/user/repositories/organization-membership-repository-documentdb.js +0 -106
- package/user/repositories/organization-membership-repository-factory.js +0 -42
- package/user/repositories/organization-membership-repository-interface.js +0 -57
- package/user/repositories/organization-membership-repository-mongo.js +0 -13
- package/user/repositories/organization-membership-repository-postgres.js +0 -29
- package/user/repositories/organization-membership-repository-prisma.js +0 -81
- package/user/tests/doubles/adopter-jwt-fixtures.js +0 -220
- package/user/use-cases/ensure-organization-membership.js +0 -92
- 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
|
|
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
|
-
};
|
package/extensions/index.js
DELETED
|
@@ -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
|
-
};
|