@dads-framework/tenants 0.0.0-stage → 0.1.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 (49) hide show
  1. package/LICENSE.md +21 -0
  2. package/README.md +59 -2
  3. package/dist/index.d.ts +9 -0
  4. package/dist/index.d.ts.map +1 -0
  5. package/dist/index.js +8 -0
  6. package/dist/index.js.map +1 -0
  7. package/dist/membership-facts.d.ts +5 -0
  8. package/dist/membership-facts.d.ts.map +1 -0
  9. package/dist/membership-facts.js +19 -0
  10. package/dist/membership-facts.js.map +1 -0
  11. package/dist/migrations/20261120040000_tenants.migration.d.ts +5 -0
  12. package/dist/migrations/20261120040000_tenants.migration.d.ts.map +1 -0
  13. package/dist/migrations/20261120040000_tenants.migration.js +31 -0
  14. package/dist/migrations/20261120040000_tenants.migration.js.map +1 -0
  15. package/dist/tenant-access.d.ts +26 -0
  16. package/dist/tenant-access.d.ts.map +1 -0
  17. package/dist/tenant-access.js +27 -0
  18. package/dist/tenant-access.js.map +1 -0
  19. package/dist/tenant-composition.d.ts +27 -0
  20. package/dist/tenant-composition.d.ts.map +1 -0
  21. package/dist/tenant-composition.js +35 -0
  22. package/dist/tenant-composition.js.map +1 -0
  23. package/dist/tenant-invitations.d.ts +26 -0
  24. package/dist/tenant-invitations.d.ts.map +1 -0
  25. package/dist/tenant-invitations.js +106 -0
  26. package/dist/tenant-invitations.js.map +1 -0
  27. package/dist/tenant-memberships.d.ts +13 -0
  28. package/dist/tenant-memberships.d.ts.map +1 -0
  29. package/dist/tenant-memberships.js +82 -0
  30. package/dist/tenant-memberships.js.map +1 -0
  31. package/dist/tenant-migrations.d.ts +5 -0
  32. package/dist/tenant-migrations.d.ts.map +1 -0
  33. package/dist/tenant-migrations.js +6 -0
  34. package/dist/tenant-migrations.js.map +1 -0
  35. package/dist/tenant-tables.d.ts +217 -0
  36. package/dist/tenant-tables.d.ts.map +1 -0
  37. package/dist/tenant-tables.js +28 -0
  38. package/dist/tenant-tables.js.map +1 -0
  39. package/dist/tenant-transaction.d.ts +20 -0
  40. package/dist/tenant-transaction.d.ts.map +1 -0
  41. package/dist/tenant-transaction.js +23 -0
  42. package/dist/tenant-transaction.js.map +1 -0
  43. package/dist/tenants.d.ts +30 -0
  44. package/dist/tenants.d.ts.map +1 -0
  45. package/dist/tenants.js +89 -0
  46. package/dist/tenants.js.map +1 -0
  47. package/dist/tenants.tsbuildinfo +1 -0
  48. package/package.json +44 -4
  49. package/src/migrations/20261120040000_tenants.migration.ts +36 -0
package/LICENSE.md ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Bryton Cooper
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,60 @@
1
- # Temporary Holding Version
1
+ # `@dads-framework/tenants`
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Manage tenants, memberships, and one-time invitations with relationship authorization.
4
+
5
+ ## Try it
6
+
7
+ ```ts
8
+ import { accessModel } from "@dads-framework/access";
9
+ import {
10
+ PostgresAuthorization,
11
+ TransactionalAccessChanges,
12
+ relationshipSchemaMigration,
13
+ } from "@dads-framework/postgres-access";
14
+ import {
15
+ createTenantAccess,
16
+ tenantMigrations,
17
+ Tenants,
18
+ } from "@dads-framework/tenants";
19
+
20
+ // Install relationshipSchemaMigration.sql and tenantMigrations before serving traffic.
21
+ // Each account and tenant definition belongs to the same composed access model.
22
+ const access = createTenantAccess(accountDefinition.entity);
23
+ const model = accessModel([accountDefinition, access.tenant]);
24
+ const backend = new PostgresAuthorization({
25
+ model,
26
+ namespace: "app",
27
+ executor: connection.pool,
28
+ });
29
+ const tenants = new Tenants({
30
+ database: connection.drizzle,
31
+ access,
32
+ authorizationAt: (transaction) => backend.inDrizzleTransaction(transaction),
33
+ changes: new TransactionalAccessChanges(backend, connection.drizzle),
34
+ });
35
+
36
+ const tenant = await tenants.create(session.account.id, "Example workspace");
37
+ const context = await tenants.context(session.account.id, tenant.id);
38
+ ```
39
+
40
+ The creator gets the owner relationship. Tenant data and membership facts commit in one transaction on the primary database.
41
+
42
+ ## Use it
43
+
44
+ Use the account ID from the application's authenticated session. Pass request tenant IDs through `tenantIdSchema`. `list(accountId)` asks authorization for visible tenant IDs and loads only those rows. `context(accountId, tenantId)` checks the tenant before returning its metadata, feature flag audience, and audit scope. `rename` requires the owner relationship.
45
+
46
+ `memberships.roster` is available to owners and admins. Owners can promote members and remove admins. Admins can invite and remove ordinary members. The bootstrap owner relationship stays in place.
47
+
48
+ `invitations.issue(accountId, tenantId, recipientEmail)` produces a one-time token and its expiration. Deliver that token to the recipient through the application's invitation link or email. `invitations.accept(token, session.account)` accepts only the intended account with a verified email. The account session supplies `id`, `email`, and `emailVerified`. The token digest, expiry, and redemption state stay in storage. Tenant invitations grant membership and work with identity systems that support verified account emails.
49
+
50
+ Use `context.audience` for feature flag evaluation and `context.auditScope` for tenant audit reads. `tenantAuditConfiguration` defines the `tenant_id` dimension for tenant and membership records. It excludes invitation rows. Bind `createTenantDirectory(database)` as the flag manager's platform-authorized tenant directory.
51
+
52
+ ## What it refuses to do
53
+
54
+ Membership administration rejects access across tenant boundaries. The service denies missing tenants and tenants the caller cannot access through the same error. Invitation redemption rejects missing, expired, consumed, or mismatched invitations through the same error. The issuer's membership management permission must still be active.
55
+
56
+ ## Contract
57
+
58
+ The data and authorization ports use the same serializable Postgres transaction. Install the package's migration folder through the application's migration runner, or call `installTenantSchemaV1` inside an application-owned migration. The Postgres access adapter has [Trusted experimental status](../postgres-access/README.md#trusted-experimental). Applications can own additional kinds and sub-scopes in their composed access model.
59
+
60
+ Translate `TenantUnavailableError` and `TenantInvitationUnavailableError` at the transport boundary. A database error rejects the transaction and leaves membership state unchanged. When a transaction retries after a PostgreSQL serialization failure, run the whole operation again.
@@ -0,0 +1,9 @@
1
+ export { assignableTenantRoleSchema, createTenantAccess, tenantEntity, tenantIdSchema, tenantRoles, type TenantAccess, type TenantId, type TenantRole, } from "./tenant-access.js";
2
+ export { createTenantDirectory, tenantAuditConfiguration, } from "./tenant-composition.js";
3
+ export { type AuthenticatedTenantAccount, TenantInvitationUnavailableError, } from "./tenant-invitations.js";
4
+ export type { TenantMembership } from "./tenant-memberships.js";
5
+ export { TenantUnavailableError, type TenantsOptions, type TenantTransaction, } from "./tenant-transaction.js";
6
+ export { Tenants, type TenantContext, type TenantRecord } from "./tenants.js";
7
+ export { tenantMigrations } from "./tenant-migrations.js";
8
+ export { installTenantSchemaV1 } from "./migrations/20261120040000_tenants.migration.js";
9
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,0BAA0B,EAC/B,gCAAgC,GACjC,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EACL,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAE9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kDAAkD,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,8 @@
1
+ export { assignableTenantRoleSchema, createTenantAccess, tenantEntity, tenantIdSchema, tenantRoles, } from "./tenant-access.js";
2
+ export { createTenantDirectory, tenantAuditConfiguration, } from "./tenant-composition.js";
3
+ export { TenantInvitationUnavailableError, } from "./tenant-invitations.js";
4
+ export { TenantUnavailableError, } from "./tenant-transaction.js";
5
+ export { Tenants } from "./tenants.js";
6
+ export { tenantMigrations } from "./tenant-migrations.js";
7
+ export { installTenantSchemaV1 } from "./migrations/20261120040000_tenants.migration.js";
8
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,WAAW,GAIZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,gCAAgC,GACjC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,sBAAsB,GAGvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,EAAyC,MAAM,cAAc,CAAC;AAE9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kDAAkD,CAAC"}
@@ -0,0 +1,5 @@
1
+ import { type AccessChange } from "@dads-framework/access/runtime";
2
+ import { type TenantId, type TenantRole } from "./tenant-access.js";
3
+ import { type TenantsOptions } from "./tenant-transaction.js";
4
+ export declare function membershipFact(options: TenantsOptions, tenantId: TenantId, accountId: string, role: TenantRole, operation: AccessChange["operation"]): AccessChange;
5
+ //# sourceMappingURL=membership-facts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"membership-facts.d.ts","sourceRoot":"","sources":["../src/membership-facts.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,GACnC,YAAY,CAiBd"}
@@ -0,0 +1,19 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { outboxKeyForRelationship, } from "@dads-framework/access/runtime";
3
+ import { tenantRoleToken, } from "./tenant-access.js";
4
+ import { accountSubject } from "./tenant-transaction.js";
5
+ export function membershipFact(options, tenantId, accountId, role, operation) {
6
+ const token = tenantRoleToken(options.access, role);
7
+ const relationship = {
8
+ resource: { type: token.entityWireName, id: tenantId },
9
+ relation: token.roleName,
10
+ subject: accountSubject(options, accountId),
11
+ };
12
+ return {
13
+ idempotencyKey: outboxKeyForRelationship(operation, relationship, randomUUID()),
14
+ relationship,
15
+ operation,
16
+ ownerPartitionId: tenantId,
17
+ };
18
+ }
19
+ //# sourceMappingURL=membership-facts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"membership-facts.js","sourceRoot":"","sources":["../src/membership-facts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,wBAAwB,GAGzB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAuB,MAAM,yBAAyB,CAAC;AAE9E,MAAM,UAAU,cAAc,CAC5B,OAAuB,EACvB,QAAkB,EAClB,SAAiB,EACjB,IAAgB,EAChB,SAAoC;IAEpC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,YAAY,GAAsB;QACtC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,cAAc,EAAE,EAAE,EAAE,QAAQ,EAAE;QACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC;KAC5C,CAAC;IACF,OAAO;QACL,cAAc,EAAE,wBAAwB,CACtC,SAAS,EACT,YAAY,EACZ,UAAU,EAAE,CACb;QACD,YAAY;QACZ,SAAS;QACT,gBAAgB,EAAE,QAAQ;KAC3B,CAAC;AACJ,CAAC"}
@@ -0,0 +1,5 @@
1
+ import type { MigrationBuilder } from "node-pg-migrate";
2
+ export declare function installTenantSchemaV1(pgm: Pick<MigrationBuilder, "sql">): void;
3
+ export declare function up(pgm: MigrationBuilder): void;
4
+ export declare function down(pgm: MigrationBuilder): void;
5
+ //# sourceMappingURL=20261120040000_tenants.migration.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"20261120040000_tenants.migration.d.ts","sourceRoot":"","sources":["../../src/migrations/20261120040000_tenants.migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,GACjC,IAAI,CAqBN;AAED,wBAAgB,EAAE,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAE9C;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAIhD"}
@@ -0,0 +1,31 @@
1
+ export function installTenantSchemaV1(pgm) {
2
+ pgm.sql(`
3
+ CREATE TABLE tenant (
4
+ id uuid PRIMARY KEY,
5
+ name text NOT NULL
6
+ );
7
+ CREATE TABLE tenant_membership (
8
+ tenant_id uuid NOT NULL REFERENCES tenant(id),
9
+ account_id text NOT NULL,
10
+ role text NOT NULL CHECK (role IN ('owner', 'admin', 'member')),
11
+ PRIMARY KEY (tenant_id, account_id)
12
+ );
13
+ CREATE TABLE tenant_invitation (
14
+ token_hash text PRIMARY KEY,
15
+ tenant_id uuid NOT NULL REFERENCES tenant(id),
16
+ recipient_email text NOT NULL,
17
+ issued_by text NOT NULL,
18
+ expires_at timestamptz NOT NULL,
19
+ accepted_at timestamptz
20
+ );
21
+ `);
22
+ }
23
+ export function up(pgm) {
24
+ installTenantSchemaV1(pgm);
25
+ }
26
+ export function down(pgm) {
27
+ pgm.dropTable("tenant_invitation");
28
+ pgm.dropTable("tenant_membership");
29
+ pgm.dropTable("tenant");
30
+ }
31
+ //# sourceMappingURL=20261120040000_tenants.migration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"20261120040000_tenants.migration.js","sourceRoot":"","sources":["../../src/migrations/20261120040000_tenants.migration.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CACnC,GAAkC;IAElC,GAAG,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;GAmBP,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,EAAE,CAAC,GAAqB;IACtC,qBAAqB,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAqB;IACxC,GAAG,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IACnC,GAAG,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IACnC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC"}
@@ -0,0 +1,26 @@
1
+ import { type EntityHandle, type RoleToken } from "@dads-framework/access";
2
+ import { z } from "zod";
3
+ export declare const tenantIdSchema: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
4
+ export type TenantId = z.output<typeof tenantIdSchema>;
5
+ export declare const tenantEntity: EntityHandle<"tenants/tenant">;
6
+ export declare const tenantRoles: readonly ["owner", "admin", "member"];
7
+ export type TenantRole = (typeof tenantRoles)[number];
8
+ export declare const assignableTenantRoleSchema: z.ZodEnum<{
9
+ admin: "admin";
10
+ member: "member";
11
+ }>;
12
+ export declare function createTenantAccess(account: EntityHandle): {
13
+ account: EntityHandle;
14
+ tenant: import("@dads-framework/access").AccessDefinition<{
15
+ owner: EntityHandle;
16
+ admin: EntityHandle;
17
+ member: EntityHandle;
18
+ }, {
19
+ view: RoleToken[];
20
+ manage_members: RoleToken[];
21
+ manage_tenant: RoleToken[];
22
+ }>;
23
+ };
24
+ export type TenantAccess = ReturnType<typeof createTenantAccess>;
25
+ export declare function tenantRoleToken(tenant: TenantAccess, role: TenantRole): RoleToken;
26
+ //# sourceMappingURL=tenant-access.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-access.d.ts","sourceRoot":"","sources":["../src/tenant-access.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc,kDAA+B,CAAC;AAC3D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAEvD,eAAO,MAAM,YAAY,gCAIvB,CAAC;AAEH,eAAO,MAAM,WAAW,YAAI,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACtD,eAAO,MAAM,0BAA0B;;;EAElB,CAAC;AAEtB,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY;;;;;;;;;;;EAavD;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,GACf,SAAS,CAEX"}
@@ -0,0 +1,27 @@
1
+ import { access, entityHandle, } from "@dads-framework/access";
2
+ import { z } from "zod";
3
+ export const tenantIdSchema = z.uuid().brand();
4
+ export const tenantEntity = entityHandle({
5
+ wireName: "tenants/tenant",
6
+ idSchema: tenantIdSchema,
7
+ kind: "scope",
8
+ });
9
+ export const tenantRoles = ["owner", "admin", "member"];
10
+ export const assignableTenantRoleSchema = z
11
+ .enum(tenantRoles)
12
+ .exclude(["owner"]);
13
+ export function createTenantAccess(account) {
14
+ const tenant = access(tenantEntity, {
15
+ roles: { owner: account, admin: account, member: account },
16
+ permissions: (roles) => ({
17
+ view: [roles.owner, roles.admin, roles.member],
18
+ manage_members: [roles.owner, roles.admin],
19
+ manage_tenant: [roles.owner],
20
+ }),
21
+ });
22
+ return { account, tenant };
23
+ }
24
+ export function tenantRoleToken(tenant, role) {
25
+ return tenant.tenant.roles[role];
26
+ }
27
+ //# sourceMappingURL=tenant-access.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-access.js","sourceRoot":"","sources":["../src/tenant-access.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,YAAY,GAGb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,EAAc,CAAC;AAG3D,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC;IACvC,QAAQ,EAAE,gBAAgB;IAC1B,QAAQ,EAAE,cAAc;IACxB,IAAI,EAAE,OAAO;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAEjE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,IAAI,CAAC,WAAW,CAAC;KACjB,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAEtB,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE;QAClC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAGvD;QACD,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAC9C,cAAc,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;YAC1C,aAAa,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;SAC7B,CAAC;KACH,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAID,MAAM,UAAU,eAAe,CAC7B,MAAoB,EACpB,IAAgB;IAEhB,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}
@@ -0,0 +1,27 @@
1
+ import type { TenantDatabase } from "./tenant-transaction.js";
2
+ /** Use only behind platform authorization, such as flag management. */
3
+ export declare function createTenantDirectory(database: Pick<TenantDatabase, "select">): {
4
+ findActiveTenants(ids: readonly string[]): Promise<{
5
+ id: string & import("zod").$brand<"TenantId">;
6
+ name: string;
7
+ }[]>;
8
+ };
9
+ /** Configure these tables after installing the generic audit trigger function. */
10
+ export declare const tenantAuditConfiguration: {
11
+ tables: {
12
+ tenant: {
13
+ keyColumns: string[];
14
+ scopeColumns: {
15
+ tenant_id: string;
16
+ };
17
+ };
18
+ tenant_membership: {
19
+ keyColumns: string[];
20
+ scopeColumns: {
21
+ tenant_id: string;
22
+ };
23
+ };
24
+ };
25
+ excludeTables: string[];
26
+ };
27
+ //# sourceMappingURL=tenant-composition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-composition.d.ts","sourceRoot":"","sources":["../src/tenant-composition.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,uEAAuE;AACvE,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC;IAGhC,iBAAiB,MAAM,SAAS,MAAM,EAAE;;;;EAcjD;AAED,kFAAkF;AAClF,eAAO,MAAM,wBAAwB;IACnC,MAAM;QACJ,MAAM;YAAI,UAAU;YAAU,YAAY;gBAAI,SAAS;;;QACvD,iBAAiB;YACf,UAAU;YACV,YAAY;gBAAI,SAAS;;;;IAG7B,aAAa;CACd,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { inArray } from "drizzle-orm";
2
+ import { tenantIdSchema } from "./tenant-access.js";
3
+ import { tenantTable } from "./tenant-tables.js";
4
+ /** Use only behind platform authorization, such as flag management. */
5
+ export function createTenantDirectory(database) {
6
+ return {
7
+ async findActiveTenants(ids) {
8
+ const accepted = [];
9
+ for (const id of ids) {
10
+ const parsed = tenantIdSchema.safeParse(id);
11
+ if (parsed.success)
12
+ accepted.push(parsed.data);
13
+ }
14
+ if (accepted.length === 0)
15
+ return [];
16
+ return database
17
+ .select()
18
+ .from(tenantTable)
19
+ .where(inArray(tenantTable.id, accepted))
20
+ .orderBy(tenantTable.id);
21
+ },
22
+ };
23
+ }
24
+ /** Configure these tables after installing the generic audit trigger function. */
25
+ export const tenantAuditConfiguration = {
26
+ tables: {
27
+ tenant: { keyColumns: ["id"], scopeColumns: { tenant_id: "id" } },
28
+ tenant_membership: {
29
+ keyColumns: ["tenant_id", "account_id"],
30
+ scopeColumns: { tenant_id: "tenant_id" },
31
+ },
32
+ },
33
+ excludeTables: ["tenant_invitation"],
34
+ };
35
+ //# sourceMappingURL=tenant-composition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-composition.js","sourceRoot":"","sources":["../src/tenant-composition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAiB,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,uEAAuE;AACvE,MAAM,UAAU,qBAAqB,CACnC,QAAwC;IAExC,OAAO;QACL,KAAK,CAAC,iBAAiB,CAAC,GAAsB;YAC5C,MAAM,QAAQ,GAAe,EAAE,CAAC;YAChC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;gBACrB,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBAC5C,IAAI,MAAM,CAAC,OAAO;oBAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjD,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACrC,OAAO,QAAQ;iBACZ,MAAM,EAAE;iBACR,IAAI,CAAC,WAAW,CAAC;iBACjB,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;iBACxC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,MAAM,EAAE;QACN,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;QACjE,iBAAiB,EAAE;YACjB,UAAU,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;YACvC,YAAY,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE;SACzC;KACF;IACD,aAAa,EAAE,CAAC,mBAAmB,CAAC;CACrC,CAAC"}
@@ -0,0 +1,26 @@
1
+ import type { TenantId } from "./tenant-access.js";
2
+ import { type TenantsOptions } from "./tenant-transaction.js";
3
+ /** Authenticated session identity supplied by application composition. */
4
+ export type AuthenticatedTenantAccount = {
5
+ readonly id: string;
6
+ readonly email: string;
7
+ readonly emailVerified: boolean;
8
+ };
9
+ export declare class TenantInvitationUnavailableError extends Error {
10
+ constructor();
11
+ }
12
+ export declare class TenantInvitations {
13
+ private readonly options;
14
+ constructor(options: TenantsOptions);
15
+ issue(actorId: string, tenantId: TenantId, email: string): Promise<{
16
+ readonly token: string;
17
+ readonly expiresAt: Date;
18
+ }>;
19
+ accept(token: string, account: AuthenticatedTenantAccount): Promise<TenantId>;
20
+ private lockInvitation;
21
+ /** Keep the issuer eligible until the grant commits. Role changes lock the same row. */
22
+ private lockIssuerMembership;
23
+ private acceptMembership;
24
+ private now;
25
+ }
26
+ //# sourceMappingURL=tenant-invitations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-invitations.d.ts","sourceRoot":"","sources":["../src/tenant-invitations.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAKL,KAAK,cAAc,EAEpB,MAAM,yBAAyB,CAAC;AAMjC,0EAA0E;AAC1E,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,qBAAa,gCAAiC,SAAQ,KAAK;IACzD,cAGC;CACF;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,cAAc,EAAI;IAExD,KAAK,CACH,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC,CAyB/D;IAED,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,QAAQ,CAAC,CAuCnB;YAEa,cAAc;IAqB5B,wFAAwF;YAC1E,oBAAoB;YAkBpB,gBAAgB;IAiB9B,OAAO,CAAC,GAAG;CAGZ"}
@@ -0,0 +1,106 @@
1
+ import { createHash, randomBytes } from "node:crypto";
2
+ import { and, eq } from "drizzle-orm";
3
+ import { z } from "zod";
4
+ import { membershipFact } from "./membership-facts.js";
5
+ import { tenantInvitation, tenantMembership } from "./tenant-tables.js";
6
+ import { accountSubject, checkTenantPermission, TenantUnavailableError, tenantTransaction, } from "./tenant-transaction.js";
7
+ const invitationTtlMs = 7 * 24 * 60 * 60 * 1000;
8
+ const providerEmail = z.string().trim().toLowerCase().pipe(z.email());
9
+ const tokenPattern = /^[A-Za-z0-9_-]{43}$/;
10
+ export class TenantInvitationUnavailableError extends Error {
11
+ constructor() {
12
+ super("Tenant invitation is unavailable");
13
+ this.name = "TenantInvitationUnavailableError";
14
+ }
15
+ }
16
+ export class TenantInvitations {
17
+ options;
18
+ constructor(options) {
19
+ this.options = options;
20
+ }
21
+ issue(actorId, tenantId, email) {
22
+ const actor = accountSubject(this.options, actorId);
23
+ const recipientEmail = providerEmail.parse(email);
24
+ const token = randomBytes(32).toString("base64url");
25
+ const expiresAt = new Date(this.now().getTime() + invitationTtlMs);
26
+ return tenantTransaction(this.options, async (tx) => {
27
+ if (!(await checkTenantPermission(this.options, tx, actor, tenantId, "manage_members")))
28
+ throw new TenantUnavailableError();
29
+ await tx.insert(tenantInvitation).values({
30
+ tokenHash: digest(token),
31
+ tenantId,
32
+ recipientEmail,
33
+ issuedBy: actor.id,
34
+ expiresAt,
35
+ });
36
+ return { token, expiresAt };
37
+ });
38
+ }
39
+ accept(token, account) {
40
+ const email = providerEmail.safeParse(account.email);
41
+ if (!z.literal(true).safeParse(account.emailVerified).success ||
42
+ !email.success ||
43
+ !tokenPattern.test(token)) {
44
+ return Promise.reject(new TenantInvitationUnavailableError());
45
+ }
46
+ const actor = accountSubject(this.options, account.id);
47
+ return tenantTransaction(this.options, async (tx) => {
48
+ const invitation = await this.lockInvitation(tx, digest(token), email.data);
49
+ const issuer = accountSubject(this.options, invitation.issuedBy);
50
+ await this.lockIssuerMembership(tx, invitation.tenantId, issuer.id);
51
+ if (!(await checkTenantPermission(this.options, tx, issuer, invitation.tenantId, "manage_members"))) {
52
+ throw new TenantInvitationUnavailableError();
53
+ }
54
+ const acceptedAt = this.now();
55
+ if (invitation.expiresAt <= acceptedAt)
56
+ throw new TenantInvitationUnavailableError();
57
+ await this.acceptMembership(tx, invitation.tenantId, actor.id);
58
+ await tx
59
+ .update(tenantInvitation)
60
+ .set({ acceptedAt })
61
+ .where(eq(tenantInvitation.tokenHash, invitation.tokenHash));
62
+ return invitation.tenantId;
63
+ });
64
+ }
65
+ async lockInvitation(tx, tokenHash, email) {
66
+ const [invitation] = await tx
67
+ .select()
68
+ .from(tenantInvitation)
69
+ .where(eq(tenantInvitation.tokenHash, tokenHash))
70
+ .for("update");
71
+ if (invitation === undefined ||
72
+ invitation.acceptedAt !== null ||
73
+ invitation.expiresAt <= this.now() ||
74
+ invitation.recipientEmail !== email) {
75
+ throw new TenantInvitationUnavailableError();
76
+ }
77
+ return invitation;
78
+ }
79
+ /** Keep the issuer eligible until the grant commits. Role changes lock the same row. */
80
+ async lockIssuerMembership(tx, tenantId, accountId) {
81
+ const [member] = await tx
82
+ .select({ accountId: tenantMembership.accountId })
83
+ .from(tenantMembership)
84
+ .where(and(eq(tenantMembership.tenantId, tenantId), eq(tenantMembership.accountId, accountId)))
85
+ .for("share");
86
+ if (member === undefined)
87
+ throw new TenantInvitationUnavailableError();
88
+ }
89
+ async acceptMembership(tx, tenantId, accountId) {
90
+ const [added] = await tx
91
+ .insert(tenantMembership)
92
+ .values({ tenantId, accountId, role: "member" })
93
+ .onConflictDoNothing()
94
+ .returning({ accountId: tenantMembership.accountId });
95
+ if (added === undefined)
96
+ return;
97
+ await this.options.changes.enqueue([membershipFact(this.options, tenantId, accountId, "member", "WRITE")], tx);
98
+ }
99
+ now() {
100
+ return this.options.now?.() ?? new Date();
101
+ }
102
+ }
103
+ function digest(token) {
104
+ return createHash("sha256").update(token).digest("hex");
105
+ }
106
+ //# sourceMappingURL=tenant-invitations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-invitations.js","sourceRoot":"","sources":["../src/tenant-invitations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAGlB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAChD,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AACtE,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAS3C,MAAM,OAAO,gCAAiC,SAAQ,KAAK;IACzD;QACE,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,OAAO,iBAAiB;IACC,OAAO;IAApC,YAA6B,OAAuB;uBAAvB,OAAO;IAAmB,CAAC;IAExD,KAAK,CACH,OAAe,EACf,QAAkB,EAClB,KAAa;QAEb,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,eAAe,CAAC,CAAC;QACnE,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YAClD,IACE,CAAC,CAAC,MAAM,qBAAqB,CAC3B,IAAI,CAAC,OAAO,EACZ,EAAE,EACF,KAAK,EACL,QAAQ,EACR,gBAAgB,CACjB,CAAC;gBAEF,MAAM,IAAI,sBAAsB,EAAE,CAAC;YACrC,MAAM,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC;gBACvC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;gBACxB,QAAQ;gBACR,cAAc;gBACd,QAAQ,EAAE,KAAK,CAAC,EAAE;gBAClB,SAAS;aACV,CAAC,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CACJ,KAAa,EACb,OAAmC;QAEnC,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrD,IACE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,OAAO;YACzD,CAAC,KAAK,CAAC,OAAO;YACd,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EACzB,CAAC;YACD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,gCAAgC,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACvD,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YAClD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,CAC1C,EAAE,EACF,MAAM,CAAC,KAAK,CAAC,EACb,KAAK,CAAC,IAAI,CACX,CAAC;YACF,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;YACjE,MAAM,IAAI,CAAC,oBAAoB,CAAC,EAAE,EAAE,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YACpE,IACE,CAAC,CAAC,MAAM,qBAAqB,CAC3B,IAAI,CAAC,OAAO,EACZ,EAAE,EACF,MAAM,EACN,UAAU,CAAC,QAAQ,EACnB,gBAAgB,CACjB,CAAC,EACF,CAAC;gBACD,MAAM,IAAI,gCAAgC,EAAE,CAAC;YAC/C,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU;gBACpC,MAAM,IAAI,gCAAgC,EAAE,CAAC;YAC/C,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;YAC/D,MAAM,EAAE;iBACL,MAAM,CAAC,gBAAgB,CAAC;iBACxB,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC;iBACnB,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;YAC/D,OAAO,UAAU,CAAC,QAAQ,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,EAAqB,EACrB,SAAiB,EACjB,KAAa;QAEb,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,EAAE;aAC1B,MAAM,EAAE;aACR,IAAI,CAAC,gBAAgB,CAAC;aACtB,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;aAChD,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjB,IACE,UAAU,KAAK,SAAS;YACxB,UAAU,CAAC,UAAU,KAAK,IAAI;YAC9B,UAAU,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;YAClC,UAAU,CAAC,cAAc,KAAK,KAAK,EACnC,CAAC;YACD,MAAM,IAAI,gCAAgC,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,wFAAwF;IAChF,KAAK,CAAC,oBAAoB,CAChC,EAAqB,EACrB,QAAkB,EAClB,SAAiB;QAEjB,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;aACtB,MAAM,CAAC,EAAE,SAAS,EAAE,gBAAgB,CAAC,SAAS,EAAE,CAAC;aACjD,IAAI,CAAC,gBAAgB,CAAC;aACtB,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,EACvC,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAC1C,CACF;aACA,GAAG,CAAC,OAAO,CAAC,CAAC;QAChB,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,gCAAgC,EAAE,CAAC;IACzE,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,EAAqB,EACrB,QAAkB,EAClB,SAAiB;QAEjB,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE;aACrB,MAAM,CAAC,gBAAgB,CAAC;aACxB,MAAM,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;aAC/C,mBAAmB,EAAE;aACrB,SAAS,CAAC,EAAE,SAAS,EAAE,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC;QACxD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO;QAChC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAChC,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,EACtE,EAAE,CACH,CAAC;IACJ,CAAC;IAEO,GAAG;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;IAC5C,CAAC;CACF;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}
@@ -0,0 +1,13 @@
1
+ import { type TenantId, type TenantRole } from "./tenant-access.js";
2
+ import { tenantMembership } from "./tenant-tables.js";
3
+ import { type TenantsOptions } from "./tenant-transaction.js";
4
+ export type TenantMembership = typeof tenantMembership.$inferSelect;
5
+ export declare class TenantMemberships {
6
+ private readonly options;
7
+ constructor(options: TenantsOptions);
8
+ roster(actorId: string, tenantId: TenantId): Promise<readonly TenantMembership[]>;
9
+ /** Owners may assign admin or member roles. The creating owner remains an owner. */
10
+ changeRole(actorId: string, tenantId: TenantId, accountId: string, role: Exclude<TenantRole, "owner">): Promise<void>;
11
+ removeMember(actorId: string, tenantId: TenantId, accountId: string): Promise<void>;
12
+ }
13
+ //# sourceMappingURL=tenant-memberships.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-memberships.d.ts","sourceRoot":"","sources":["../src/tenant-memberships.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,YAAY,CAAC;AAEpE,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,cAAc,EAAI;IAExD,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAmBtC;IAED,oFAAoF;IACpF,UAAU,CACR,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAiDf;IAED,YAAY,CACV,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA8Cf;CACF"}
@@ -0,0 +1,82 @@
1
+ import { and, eq } from "drizzle-orm";
2
+ import { membershipFact } from "./membership-facts.js";
3
+ import { assignableTenantRoleSchema, } from "./tenant-access.js";
4
+ import { tenantMembership } from "./tenant-tables.js";
5
+ import { accountSubject, checkTenantPermission, TenantUnavailableError, tenantTransaction, } from "./tenant-transaction.js";
6
+ export class TenantMemberships {
7
+ options;
8
+ constructor(options) {
9
+ this.options = options;
10
+ }
11
+ roster(actorId, tenantId) {
12
+ const actor = accountSubject(this.options, actorId);
13
+ return tenantTransaction(this.options, async (tx) => {
14
+ if (!(await checkTenantPermission(this.options, tx, actor, tenantId, "manage_members")))
15
+ throw new TenantUnavailableError();
16
+ return tx
17
+ .select()
18
+ .from(tenantMembership)
19
+ .where(eq(tenantMembership.tenantId, tenantId))
20
+ .orderBy(tenantMembership.accountId);
21
+ });
22
+ }
23
+ /** Owners may assign admin or member roles. The creating owner remains an owner. */
24
+ changeRole(actorId, tenantId, accountId, role) {
25
+ const actor = accountSubject(this.options, actorId);
26
+ const target = accountSubject(this.options, accountId);
27
+ const assignable = assignableTenantRoleSchema.safeParse(role);
28
+ if (!assignable.success)
29
+ throw new TenantUnavailableError();
30
+ return tenantTransaction(this.options, async (tx) => {
31
+ if (!(await checkTenantPermission(this.options, tx, actor, tenantId, "manage_tenant")))
32
+ throw new TenantUnavailableError();
33
+ const match = memberKey(tenantId, target.id);
34
+ const [member] = await tx
35
+ .select()
36
+ .from(tenantMembership)
37
+ .where(match)
38
+ .for("update");
39
+ if (member === undefined || member.role === "owner")
40
+ throw new TenantUnavailableError();
41
+ if (member.role === assignable.data)
42
+ return;
43
+ await tx
44
+ .update(tenantMembership)
45
+ .set({ role: assignable.data })
46
+ .where(match);
47
+ await this.options.changes.enqueue([
48
+ membershipFact(this.options, tenantId, target.id, member.role, "DELETE"),
49
+ membershipFact(this.options, tenantId, target.id, assignable.data, "WRITE"),
50
+ ], tx);
51
+ });
52
+ }
53
+ removeMember(actorId, tenantId, accountId) {
54
+ const actor = accountSubject(this.options, actorId);
55
+ const target = accountSubject(this.options, accountId);
56
+ return tenantTransaction(this.options, async (tx) => {
57
+ const canManage = await checkTenantPermission(this.options, tx, actor, tenantId, "manage_members");
58
+ if (!canManage)
59
+ throw new TenantUnavailableError();
60
+ const match = memberKey(tenantId, target.id);
61
+ const [member] = await tx
62
+ .select()
63
+ .from(tenantMembership)
64
+ .where(match)
65
+ .for("update");
66
+ if (member === undefined || member.role === "owner")
67
+ throw new TenantUnavailableError();
68
+ if (member.role === "admin" &&
69
+ !(await checkTenantPermission(this.options, tx, actor, tenantId, "manage_tenant"))) {
70
+ throw new TenantUnavailableError();
71
+ }
72
+ await tx.delete(tenantMembership).where(match);
73
+ await this.options.changes.enqueue([
74
+ membershipFact(this.options, tenantId, target.id, member.role, "DELETE"),
75
+ ], tx);
76
+ });
77
+ }
78
+ }
79
+ function memberKey(tenantId, accountId) {
80
+ return and(eq(tenantMembership.tenantId, tenantId), eq(tenantMembership.accountId, accountId));
81
+ }
82
+ //# sourceMappingURL=tenant-memberships.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-memberships.js","sourceRoot":"","sources":["../src/tenant-memberships.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ /** A migration contribution for the tenant tables. */
2
+ export declare const tenantMigrations: {
3
+ directory: string;
4
+ };
5
+ //# sourceMappingURL=tenant-migrations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-migrations.d.ts","sourceRoot":"","sources":["../src/tenant-migrations.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,eAAO,MAAM,gBAAgB;IAC3B,SAAS;CACV,CAAC"}
@@ -0,0 +1,6 @@
1
+ import { fileURLToPath } from "node:url";
2
+ /** A migration contribution for the tenant tables. */
3
+ export const tenantMigrations = {
4
+ directory: fileURLToPath(new URL("../src/migrations/", import.meta.url)),
5
+ };
6
+ //# sourceMappingURL=tenant-migrations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-migrations.js","sourceRoot":"","sources":["../src/tenant-migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;CACzE,CAAC"}