@aglyn/tenant-data-admin 1.0.0-beta.270 → 1.0.0-beta.271

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/package.json +7 -7
  2. package/src/lib/server/append-only-history-write.d.ts +38 -0
  3. package/src/lib/server/append-only-history-write.js +60 -0
  4. package/src/lib/server/append-only-history-write.js.map +1 -0
  5. package/src/lib/server/billing-addons.d.ts +58 -32
  6. package/src/lib/server/billing-addons.js +100 -86
  7. package/src/lib/server/billing-addons.js.map +1 -1
  8. package/src/lib/server/bundle-links.d.ts +166 -0
  9. package/src/lib/server/bundle-links.js +286 -0
  10. package/src/lib/server/bundle-links.js.map +1 -0
  11. package/src/lib/server/client-build.d.ts +74 -0
  12. package/src/lib/server/client-build.js +264 -0
  13. package/src/lib/server/client-build.js.map +1 -0
  14. package/src/lib/server/host-memberships.d.ts +35 -2
  15. package/src/lib/server/host-memberships.js +63 -2
  16. package/src/lib/server/host-memberships.js.map +1 -1
  17. package/src/lib/server/org-billing.d.ts +4 -2
  18. package/src/lib/server/org-billing.js +5 -0
  19. package/src/lib/server/org-billing.js.map +1 -1
  20. package/src/lib/server/site-care-emails.d.ts +52 -0
  21. package/src/lib/server/site-care-emails.js +97 -0
  22. package/src/lib/server/site-care-emails.js.map +1 -0
  23. package/src/lib/server/site-care-inbound.d.ts +80 -0
  24. package/src/lib/server/site-care-inbound.js +171 -0
  25. package/src/lib/server/site-care-inbound.js.map +1 -0
  26. package/src/lib/server/site-care-project-reconcile.d.ts +64 -0
  27. package/src/lib/server/site-care-project-reconcile.js +211 -0
  28. package/src/lib/server/site-care-project-reconcile.js.map +1 -0
  29. package/src/lib/server/site-care-project-stripe.d.ts +114 -0
  30. package/src/lib/server/site-care-project-stripe.js +305 -0
  31. package/src/lib/server/site-care-project-stripe.js.map +1 -0
  32. package/src/lib/server/site-care-projects.d.ts +169 -0
  33. package/src/lib/server/site-care-projects.js +882 -0
  34. package/src/lib/server/site-care-projects.js.map +1 -0
  35. package/src/lib/server/site-care-reconcile.d.ts +81 -0
  36. package/src/lib/server/site-care-reconcile.js +349 -0
  37. package/src/lib/server/site-care-reconcile.js.map +1 -0
  38. package/src/lib/server/site-care-requests.d.ts +243 -0
  39. package/src/lib/server/site-care-requests.js +1414 -0
  40. package/src/lib/server/site-care-requests.js.map +1 -0
  41. package/src/lib/server/site-care-stripe.d.ts +175 -0
  42. package/src/lib/server/site-care-stripe.js +375 -0
  43. package/src/lib/server/site-care-stripe.js.map +1 -0
  44. package/src/lib/server/upgrade-proposal.d.ts +40 -1
  45. package/src/lib/server/upgrade-proposal.js +92 -50
  46. package/src/lib/server/upgrade-proposal.js.map +1 -1
  47. package/src/tenancy.d.ts +1 -0
  48. package/src/tenancy.js +2 -0
  49. package/src/tenancy.js.map +1 -1
@@ -0,0 +1,264 @@
1
+ import { _ as _extends } from "@swc/helpers/_/_extends";
2
+ /**
3
+ * @license
4
+ * Copyright 2026 Aglyn LLC
5
+ *
6
+ * Licensed under the Apache License, Version 2.0 (the "License");
7
+ * you may not use this file except in compliance with the License.
8
+ * You may obtain a copy of the License at
9
+ *
10
+ * http://www.apache.org/licenses/LICENSE-2.0
11
+ *
12
+ * Unless required by applicable law or agreed to in writing, software
13
+ * distributed under the License is distributed on an "AS IS" BASIS,
14
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
+ * See the License for the specific language governing permissions and
16
+ * limitations under the License.
17
+ */ import { CLIENT_BUILD_COLLECTION, CLIENT_BUILD_DOC_ID, clientBuildIntent, clientBuildPhone, clientBuildPreviewText, clientBuildSiteAddress, EMPTY_CLIENT_BUILD_INTAKE, parseClientBuildDomain, parseClientBuildIntake, readClientBuildIntent } from "@aglyn/aglyn/app-utils/client-build";
18
+ import { hostPublicOrigin } from "@aglyn/aglyn/app-utils/host-naming";
19
+ import { readOrgPlanComp } from "@aglyn/aglyn/app-utils/plan-entitlements";
20
+ import { PLATFORM_BRAND_NAME } from "@aglyn/aglyn/app-utils/platform-brand";
21
+ import { pluginSmsMessaging } from "@aglyn/aglyn/plugin-manager/plugin-sms-messaging";
22
+ import { isEmailConfigured, sendEmail } from "@aglyn/shared-util-email";
23
+ import { addAdminAudit } from "./admin-audit-write.js";
24
+ import { meterOrgEmail } from "./email-metering.js";
25
+ import firebaseAdmin from "./firebase-admin.js";
26
+ import { renderSystemEmailContent, systemEmailBrand } from "./render-system-email.js";
27
+ /**
28
+ * THE ONE-SCREEN BUILD FOR A CLIENT, ON THE SERVER (AGL-3958).
29
+ *
30
+ * One record per workspace, at `orgs/{orgId}/clientBuild/current`, which the
31
+ * rules open to no client: the owner's phone and email are staff's to hold
32
+ * until the owner joins, and the org document is read by every member. Only
33
+ * `/api/admin/client-build` (staff) calls this module.
34
+ */ const firestore = ()=>firebaseAdmin.app().firestore();
35
+ /** A refusal the route answers with its status. */ export class ClientBuildError extends Error {
36
+ constructor(message, status){
37
+ super(message), this.status = status;
38
+ this.name = 'ClientBuildError';
39
+ }
40
+ }
41
+ function recordRef(orgId) {
42
+ return firestore().collection('orgs').doc(orgId).collection(CLIENT_BUILD_COLLECTION).doc(CLIENT_BUILD_DOC_ID);
43
+ }
44
+ /** A stored record, read back defensively; `null` when the workspace has none. */ export function readClientBuildRecord(raw) {
45
+ var _time, _text;
46
+ if (!raw || typeof raw !== 'object') return null;
47
+ const source = raw;
48
+ const intake = parseClientBuildIntake(source['intake']);
49
+ const domain = source['domain'] ? parseClientBuildDomain(source['domain']) : null;
50
+ const intent = readClientBuildIntent(source['intent']);
51
+ const text = (value)=>typeof value === 'string' && value ? value : null;
52
+ const time = (value)=>typeof value === 'number' && Number.isFinite(value) ? value : null;
53
+ return {
54
+ // A stored intake that no longer validates is still the one staff typed.
55
+ intake: typeof intake === 'string' ? _extends({}, EMPTY_CLIENT_BUILD_INTAKE, source['intake']) : intake,
56
+ domain: typeof domain === 'string' ? null : domain,
57
+ intent: intent != null ? intent : clientBuildIntent({
58
+ plan: null,
59
+ domain: typeof domain === 'string' ? null : domain
60
+ }),
61
+ hostId: text(source['hostId']),
62
+ host: text(source['host']),
63
+ jobId: text(source['jobId']),
64
+ starter: source['starter'] === true,
65
+ previewSentAt: time(source['previewSentAt']),
66
+ updatedAt: (_time = time(source['updatedAt'])) != null ? _time : 0,
67
+ updatedBy: (_text = text(source['updatedBy'])) != null ? _text : ''
68
+ };
69
+ }
70
+ /** The workspace's build, or `null` before one was started. */ export async function loadClientBuild(orgId) {
71
+ const snapshot = await recordRef(orgId).get();
72
+ return snapshot.exists ? readClientBuildRecord(snapshot.data()) : null;
73
+ }
74
+ /**
75
+ * The intent the hand-off proposes (AGL-3955, AGL-3956): what the build left
76
+ * for the owner's checkout, or `null` when the workspace was not built here.
77
+ */ export async function loadClientBuildIntent(orgId) {
78
+ var _ref;
79
+ var _this;
80
+ return (_ref = (_this = await loadClientBuild(orgId)) == null ? void 0 : _this.intent) != null ? _ref : null;
81
+ }
82
+ const ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
83
+ /**
84
+ * Writes the build, merged over what is stored. The intake and the domain
85
+ * are validated as the screen validated them; the intent is derived, never
86
+ * taken from the body: the plan the workspace was comped on, Site Care, and
87
+ * the domain the Domain step recorded. A site is accepted only when it
88
+ * belongs to this workspace.
89
+ */ export async function saveClientBuild(options) {
90
+ var _ref, _ref1, _ref2, _ref3, _ref4, _ref5, _ref6, _ref7, _options_now;
91
+ var _readOrgPlanComp;
92
+ const { orgId, actorUid, patch } = options;
93
+ const org = await firestore().collection('orgs').doc(orgId).get();
94
+ if (!org.exists) throw new ClientBuildError('Unknown workspace', 404);
95
+ const stored = await loadClientBuild(orgId);
96
+ let intake = (_ref = stored == null ? void 0 : stored.intake) != null ? _ref : null;
97
+ if (patch.intake !== undefined) {
98
+ const parsed = parseClientBuildIntake(patch.intake);
99
+ if (typeof parsed === 'string') throw new ClientBuildError(parsed, 400);
100
+ intake = parsed;
101
+ }
102
+ if (!intake) throw new ClientBuildError('Missing the business details', 400);
103
+ let domain = (_ref1 = stored == null ? void 0 : stored.domain) != null ? _ref1 : null;
104
+ if (patch.domain !== undefined) {
105
+ if (patch.domain === null) domain = null;
106
+ else {
107
+ const parsed = parseClientBuildDomain(patch.domain);
108
+ if (typeof parsed === 'string') throw new ClientBuildError(parsed, 400);
109
+ domain = parsed;
110
+ }
111
+ }
112
+ let hostId = (_ref2 = stored == null ? void 0 : stored.hostId) != null ? _ref2 : null;
113
+ let host = (_ref3 = stored == null ? void 0 : stored.host) != null ? _ref3 : null;
114
+ if (patch.hostId !== undefined) {
115
+ var _patch_hostId;
116
+ const id = String((_patch_hostId = patch.hostId) != null ? _patch_hostId : '');
117
+ if (!ID_PATTERN.test(id)) throw new ClientBuildError('Unknown site', 400);
118
+ const site = await firestore().collection('hosts').doc(id).get();
119
+ if (!site.exists || site.get('orgId') !== orgId) {
120
+ throw new ClientBuildError('That site is not in this workspace', 400);
121
+ }
122
+ hostId = id;
123
+ host = typeof site.get('subdomain') === 'string' ? site.get('subdomain') : patch.host ? String(patch.host) : null;
124
+ }
125
+ let jobId = (_ref4 = stored == null ? void 0 : stored.jobId) != null ? _ref4 : null;
126
+ if (patch.jobId !== undefined) {
127
+ var _patch_jobId;
128
+ const id = String((_patch_jobId = patch.jobId) != null ? _patch_jobId : '');
129
+ if (!ID_PATTERN.test(id)) throw new ClientBuildError('Unknown job', 400);
130
+ jobId = id;
131
+ }
132
+ let starter = (_ref5 = stored == null ? void 0 : stored.starter) != null ? _ref5 : false;
133
+ if (patch.starter !== undefined) {
134
+ if (typeof patch.starter !== 'boolean') throw new ClientBuildError('Unknown starter choice', 400);
135
+ starter = patch.starter;
136
+ }
137
+ const record = {
138
+ intake,
139
+ domain,
140
+ // Derived on every write, never taken from the body: the plan the
141
+ // workspace was comped on, Site Care, monthly, and the domain above.
142
+ intent: clientBuildIntent({
143
+ plan: (_ref6 = (_readOrgPlanComp = readOrgPlanComp(org.data())) == null ? void 0 : _readOrgPlanComp.plan) != null ? _ref6 : null,
144
+ domain
145
+ }),
146
+ hostId,
147
+ host,
148
+ jobId,
149
+ starter,
150
+ previewSentAt: (_ref7 = stored == null ? void 0 : stored.previewSentAt) != null ? _ref7 : null,
151
+ updatedAt: (_options_now = options.now) != null ? _options_now : Date.now(),
152
+ updatedBy: actorUid
153
+ };
154
+ await recordRef(orgId).set(record);
155
+ return record;
156
+ }
157
+ /**
158
+ * Sends the owner the preview: a text and an email with the link to the site
159
+ * as it is now and the address it will live at. Only once the site has a
160
+ * published page, since the link would otherwise open an empty site. Each
161
+ * channel is attempted on its own and reported; the send is an Audit Log row.
162
+ */ export async function sendClientBuildPreview(options) {
163
+ var _site_screens, _site_subdomain, _options_now;
164
+ const { orgId, actorUid } = options;
165
+ const record = await loadClientBuild(orgId);
166
+ if (!(record == null ? void 0 : record.hostId)) throw new ClientBuildError('Build the site first', 409);
167
+ const [orgSnapshot, siteSnapshot] = await Promise.all([
168
+ firestore().collection('orgs').doc(orgId).get(),
169
+ firestore().collection('hosts').doc(record.hostId).get()
170
+ ]);
171
+ if (!siteSnapshot.exists || siteSnapshot.get('orgId') !== orgId) {
172
+ throw new ClientBuildError('That site is not in this workspace', 409);
173
+ }
174
+ const site = siteSnapshot.data();
175
+ if (!Object.keys((_site_screens = site.screens) != null ? _site_screens : {}).length) {
176
+ throw new ClientBuildError('The site has no published page yet', 409);
177
+ }
178
+ const previewUrl = hostPublicOrigin({
179
+ subdomain: (_site_subdomain = site.subdomain) != null ? _site_subdomain : null
180
+ });
181
+ if (!previewUrl) throw new ClientBuildError('The site has no address yet', 409);
182
+ const siteAddress = clientBuildSiteAddress(record.domain, previewUrl);
183
+ const { intake } = record;
184
+ const businessName = intake.businessName || 'your business';
185
+ const brand = systemEmailBrand(orgSnapshot.data());
186
+ const productName = brand.merge['brand.productName'] || PLATFORM_BRAND_NAME;
187
+ let emailed = false;
188
+ if (intake.email && isEmailConfigured()) {
189
+ try {
190
+ const content = await renderSystemEmailContent('client-build-preview', {
191
+ 'business.name': businessName,
192
+ 'preview.url': previewUrl,
193
+ 'site.address': siteAddress != null ? siteAddress : previewUrl
194
+ }, brand, {
195
+ subject: `Your new website for ${businessName} is ready to look at`,
196
+ text: `We built the website for ${businessName} with you today. Open it on your phone and look ` + `around: every page, picture and word can still be changed.\n\n${previewUrl}` + (siteAddress ? `\n\nIt will live at ${siteAddress}.` : '')
197
+ });
198
+ const result = await sendEmail(_extends({
199
+ to: intake.email,
200
+ subject: content.subject,
201
+ text: content.text
202
+ }, content.html ? {
203
+ html: content.html
204
+ } : {}, brand.fromName ? {
205
+ fromName: brand.fromName
206
+ } : {}, {
207
+ context: 'client-build-preview'
208
+ }));
209
+ emailed = result.sent;
210
+ if (result.sent) await meterOrgEmail(orgId);
211
+ } catch (error) {
212
+ console.error('[client-build] the preview email failed', error);
213
+ }
214
+ }
215
+ let text = 'none';
216
+ const phone = clientBuildPhone(intake);
217
+ if (phone) {
218
+ const sms = pluginSmsMessaging();
219
+ if (!(sms == null ? void 0 : sms.isConfigured())) text = 'unavailable';
220
+ else {
221
+ const outcome = await sms.send({
222
+ to: phone,
223
+ body: clientBuildPreviewText({
224
+ businessName,
225
+ previewUrl,
226
+ siteAddress,
227
+ productName
228
+ }),
229
+ hostId: record.hostId,
230
+ // Owed to the owner's own request, at the booth or the door, and
231
+ // waited on right now: never held for quiet hours.
232
+ purpose: 'transactional',
233
+ context: 'client-build-preview'
234
+ });
235
+ text = outcome.status;
236
+ }
237
+ }
238
+ const sentAt = (_options_now = options.now) != null ? _options_now : Date.now();
239
+ if (emailed || text === 'sent') await recordRef(orgId).set({
240
+ previewSentAt: sentAt
241
+ }, {
242
+ merge: true
243
+ });
244
+ await addAdminAudit(firestore(), {
245
+ actorUid,
246
+ action: 'client-build.preview-sent',
247
+ target: `orgs/${orgId}`,
248
+ // Which channels went, never the owner's address or number.
249
+ after: {
250
+ hostId: record.hostId,
251
+ emailed,
252
+ text
253
+ },
254
+ at: firebaseAdmin.firestore.FieldValue.serverTimestamp()
255
+ });
256
+ return {
257
+ emailed,
258
+ text,
259
+ previewUrl,
260
+ siteAddress
261
+ };
262
+ }
263
+
264
+ //# sourceMappingURL=client-build.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/client-build.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n CLIENT_BUILD_COLLECTION,\n CLIENT_BUILD_DOC_ID,\n clientBuildIntent,\n clientBuildPhone,\n clientBuildPreviewText,\n clientBuildSiteAddress,\n EMPTY_CLIENT_BUILD_INTAKE,\n parseClientBuildDomain,\n parseClientBuildIntake,\n readClientBuildIntent,\n type ClientBuildDomain,\n type ClientBuildIntent,\n type ClientBuildRecord,\n} from '@aglyn/aglyn/app-utils/client-build'\nimport { hostPublicOrigin } from '@aglyn/aglyn/app-utils/host-naming'\nimport { readOrgPlanComp } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport { PLATFORM_BRAND_NAME } from '@aglyn/aglyn/app-utils/platform-brand'\nimport {\n pluginSmsMessaging,\n type PluginSmsSendOutcome,\n} from '@aglyn/aglyn/plugin-manager/plugin-sms-messaging'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/server'\nimport { isEmailConfigured, sendEmail } from '@aglyn/shared-util-email'\nimport { addAdminAudit } from './admin-audit-write'\nimport { meterOrgEmail } from './email-metering'\nimport firebaseAdmin from './firebase-admin'\nimport { renderSystemEmailContent, systemEmailBrand } from './render-system-email'\n\n/**\n * THE ONE-SCREEN BUILD FOR A CLIENT, ON THE SERVER (AGL-3958).\n *\n * One record per workspace, at `orgs/{orgId}/clientBuild/current`, which the\n * rules open to no client: the owner's phone and email are staff's to hold\n * until the owner joins, and the org document is read by every member. Only\n * `/api/admin/client-build` (staff) calls this module.\n */\n\nconst firestore = () => firebaseAdmin.app().firestore()\n\n/** A refusal the route answers with its status. */\nexport class ClientBuildError extends Error {\n constructor(\n message: string,\n readonly status: number,\n ) {\n super(message)\n this.name = 'ClientBuildError'\n }\n}\n\nfunction recordRef(orgId: string) {\n return firestore().collection('orgs').doc(orgId).collection(CLIENT_BUILD_COLLECTION).doc(CLIENT_BUILD_DOC_ID)\n}\n\n/** A stored record, read back defensively; `null` when the workspace has none. */\nexport function readClientBuildRecord(raw: unknown): ClientBuildRecord | null {\n if (!raw || typeof raw !== 'object') return null\n const source = raw as Record<string, unknown>\n const intake = parseClientBuildIntake(source['intake'])\n const domain = source['domain'] ? parseClientBuildDomain(source['domain']) : null\n const intent = readClientBuildIntent(source['intent'])\n const text = (value: unknown) => (typeof value === 'string' && value ? value : null)\n const time = (value: unknown) => (typeof value === 'number' && Number.isFinite(value) ? value : null)\n return {\n // A stored intake that no longer validates is still the one staff typed.\n intake: typeof intake === 'string' ? { ...EMPTY_CLIENT_BUILD_INTAKE, ...(source['intake'] as object) } : intake,\n domain: typeof domain === 'string' ? null : domain,\n intent: intent ?? clientBuildIntent({ plan: null, domain: typeof domain === 'string' ? null : domain }),\n hostId: text(source['hostId']),\n host: text(source['host']),\n jobId: text(source['jobId']),\n starter: source['starter'] === true,\n previewSentAt: time(source['previewSentAt']),\n updatedAt: time(source['updatedAt']) ?? 0,\n updatedBy: text(source['updatedBy']) ?? '',\n }\n}\n\n/** The workspace's build, or `null` before one was started. */\nexport async function loadClientBuild(orgId: string): Promise<ClientBuildRecord | null> {\n const snapshot = await recordRef(orgId).get()\n return snapshot.exists ? readClientBuildRecord(snapshot.data()) : null\n}\n\n/**\n * The intent the hand-off proposes (AGL-3955, AGL-3956): what the build left\n * for the owner's checkout, or `null` when the workspace was not built here.\n */\nexport async function loadClientBuildIntent(orgId: string): Promise<ClientBuildIntent | null> {\n return (await loadClientBuild(orgId))?.intent ?? null\n}\n\n/** What a save may change; each part left out keeps what is stored. */\nexport interface ClientBuildPatch {\n intake?: unknown\n domain?: unknown\n hostId?: unknown\n host?: unknown\n jobId?: unknown\n /** `true` once the starter site was given instead of a guided start. */\n starter?: unknown\n}\n\nconst ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/\n\n/**\n * Writes the build, merged over what is stored. The intake and the domain\n * are validated as the screen validated them; the intent is derived, never\n * taken from the body: the plan the workspace was comped on, Site Care, and\n * the domain the Domain step recorded. A site is accepted only when it\n * belongs to this workspace.\n */\nexport async function saveClientBuild(options: {\n orgId: string\n actorUid: string\n patch: ClientBuildPatch\n now?: number\n}): Promise<ClientBuildRecord> {\n const { orgId, actorUid, patch } = options\n const org = await firestore().collection('orgs').doc(orgId).get()\n if (!org.exists) throw new ClientBuildError('Unknown workspace', 404)\n const stored = await loadClientBuild(orgId)\n\n let intake = stored?.intake ?? null\n if (patch.intake !== undefined) {\n const parsed = parseClientBuildIntake(patch.intake)\n if (typeof parsed === 'string') throw new ClientBuildError(parsed, 400)\n intake = parsed\n }\n if (!intake) throw new ClientBuildError('Missing the business details', 400)\n\n let domain: ClientBuildDomain | null = stored?.domain ?? null\n if (patch.domain !== undefined) {\n if (patch.domain === null) domain = null\n else {\n const parsed = parseClientBuildDomain(patch.domain)\n if (typeof parsed === 'string') throw new ClientBuildError(parsed, 400)\n domain = parsed\n }\n }\n\n let hostId = stored?.hostId ?? null\n let host = stored?.host ?? null\n if (patch.hostId !== undefined) {\n const id = String(patch.hostId ?? '')\n if (!ID_PATTERN.test(id)) throw new ClientBuildError('Unknown site', 400)\n const site = await firestore().collection('hosts').doc(id).get()\n if (!site.exists || site.get('orgId') !== orgId) {\n throw new ClientBuildError('That site is not in this workspace', 400)\n }\n hostId = id\n host = typeof site.get('subdomain') === 'string' ? site.get('subdomain') : (patch.host ? String(patch.host) : null)\n }\n\n let jobId = stored?.jobId ?? null\n if (patch.jobId !== undefined) {\n const id = String(patch.jobId ?? '')\n if (!ID_PATTERN.test(id)) throw new ClientBuildError('Unknown job', 400)\n jobId = id\n }\n\n let starter = stored?.starter ?? false\n if (patch.starter !== undefined) {\n if (typeof patch.starter !== 'boolean') throw new ClientBuildError('Unknown starter choice', 400)\n starter = patch.starter\n }\n\n const record: ClientBuildRecord = {\n intake,\n domain,\n // Derived on every write, never taken from the body: the plan the\n // workspace was comped on, Site Care, monthly, and the domain above.\n intent: clientBuildIntent({\n plan: readOrgPlanComp(org.data() as Partial<AglynOrgBilling>)?.plan ?? null,\n domain,\n }),\n hostId,\n host,\n jobId,\n starter,\n previewSentAt: stored?.previewSentAt ?? null,\n updatedAt: options.now ?? Date.now(),\n updatedBy: actorUid,\n }\n await recordRef(orgId).set(record)\n return record\n}\n\n/** What sending the preview came to, per channel. */\nexport interface ClientBuildPreviewOutcome {\n emailed: boolean\n /** The text's outcome; `none` when the intake has no phone to text. */\n text: PluginSmsSendOutcome['status'] | 'none' | 'unavailable'\n previewUrl: string\n siteAddress: string | null\n}\n\n/**\n * Sends the owner the preview: a text and an email with the link to the site\n * as it is now and the address it will live at. Only once the site has a\n * published page, since the link would otherwise open an empty site. Each\n * channel is attempted on its own and reported; the send is an Audit Log row.\n */\nexport async function sendClientBuildPreview(options: {\n orgId: string\n actorUid: string\n now?: number\n}): Promise<ClientBuildPreviewOutcome> {\n const { orgId, actorUid } = options\n const record = await loadClientBuild(orgId)\n if (!record?.hostId) throw new ClientBuildError('Build the site first', 409)\n const [orgSnapshot, siteSnapshot] = await Promise.all([\n firestore().collection('orgs').doc(orgId).get(),\n firestore().collection('hosts').doc(record.hostId).get(),\n ])\n if (!siteSnapshot.exists || siteSnapshot.get('orgId') !== orgId) {\n throw new ClientBuildError('That site is not in this workspace', 409)\n }\n const site = siteSnapshot.data() as { screens?: Record<string, unknown>; subdomain?: string; cname?: string }\n if (!Object.keys(site.screens ?? {}).length) {\n throw new ClientBuildError('The site has no published page yet', 409)\n }\n const previewUrl = hostPublicOrigin({ subdomain: site.subdomain ?? null })\n if (!previewUrl) throw new ClientBuildError('The site has no address yet', 409)\n const siteAddress = clientBuildSiteAddress(record.domain, previewUrl)\n const { intake } = record\n const businessName = intake.businessName || 'your business'\n\n const brand = systemEmailBrand(orgSnapshot.data() as Record<string, unknown>)\n const productName = brand.merge['brand.productName'] || PLATFORM_BRAND_NAME\n\n let emailed = false\n if (intake.email && isEmailConfigured()) {\n try {\n const content = await renderSystemEmailContent(\n 'client-build-preview',\n {\n 'business.name': businessName,\n 'preview.url': previewUrl,\n 'site.address': siteAddress ?? previewUrl,\n },\n brand,\n {\n subject: `Your new website for ${businessName} is ready to look at`,\n text:\n `We built the website for ${businessName} with you today. Open it on your phone and look ` +\n `around: every page, picture and word can still be changed.\\n\\n${previewUrl}` +\n (siteAddress ? `\\n\\nIt will live at ${siteAddress}.` : ''),\n },\n )\n const result = await sendEmail({\n to: intake.email,\n subject: content.subject,\n text: content.text,\n ...(content.html ? { html: content.html } : {}),\n ...(brand.fromName ? { fromName: brand.fromName } : {}),\n context: 'client-build-preview',\n })\n emailed = result.sent\n if (result.sent) await meterOrgEmail(orgId)\n } catch (error) {\n console.error('[client-build] the preview email failed', error)\n }\n }\n\n let text: ClientBuildPreviewOutcome['text'] = 'none'\n const phone = clientBuildPhone(intake)\n if (phone) {\n const sms = pluginSmsMessaging()\n if (!sms?.isConfigured()) text = 'unavailable'\n else {\n const outcome = await sms.send({\n to: phone,\n body: clientBuildPreviewText({ businessName, previewUrl, siteAddress, productName }),\n hostId: record.hostId,\n // Owed to the owner's own request, at the booth or the door, and\n // waited on right now: never held for quiet hours.\n purpose: 'transactional',\n context: 'client-build-preview',\n })\n text = outcome.status\n }\n }\n\n const sentAt = options.now ?? Date.now()\n if (emailed || text === 'sent') await recordRef(orgId).set({ previewSentAt: sentAt }, { merge: true })\n await addAdminAudit(firestore(), {\n actorUid,\n action: 'client-build.preview-sent',\n target: `orgs/${orgId}`,\n // Which channels went, never the owner's address or number.\n after: { hostId: record.hostId, emailed, text },\n at: firebaseAdmin.firestore.FieldValue.serverTimestamp(),\n })\n return { emailed, text, previewUrl, siteAddress }\n}\n"],"names":["CLIENT_BUILD_COLLECTION","CLIENT_BUILD_DOC_ID","clientBuildIntent","clientBuildPhone","clientBuildPreviewText","clientBuildSiteAddress","EMPTY_CLIENT_BUILD_INTAKE","parseClientBuildDomain","parseClientBuildIntake","readClientBuildIntent","hostPublicOrigin","readOrgPlanComp","PLATFORM_BRAND_NAME","pluginSmsMessaging","isEmailConfigured","sendEmail","addAdminAudit","meterOrgEmail","firebaseAdmin","renderSystemEmailContent","systemEmailBrand","firestore","app","ClientBuildError","Error","message","status","name","recordRef","orgId","collection","doc","readClientBuildRecord","raw","time","text","source","intake","domain","intent","value","Number","isFinite","plan","hostId","host","jobId","starter","previewSentAt","updatedAt","updatedBy","loadClientBuild","snapshot","get","exists","data","loadClientBuildIntent","ID_PATTERN","saveClientBuild","options","actorUid","patch","org","stored","undefined","parsed","id","String","test","site","record","now","Date","set","sendClientBuildPreview","orgSnapshot","siteSnapshot","Promise","all","Object","keys","screens","length","previewUrl","subdomain","siteAddress","businessName","brand","productName","merge","emailed","email","content","subject","result","to","html","fromName","context","sent","error","console","phone","sms","isConfigured","outcome","send","body","purpose","sentAt","action","target","after","at","FieldValue","serverTimestamp"],"mappings":"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"}
@@ -81,6 +81,7 @@ export declare const membershipRow: (orgId: string, meta: HostMeta | undefined,
81
81
  nameLower: string;
82
82
  searchTokens: string[];
83
83
  hasCustomDomain: boolean;
84
+ cname: string | FieldValue;
84
85
  createdAt: unknown;
85
86
  favicon: string | FieldValue;
86
87
  role: string;
@@ -88,6 +89,38 @@ export declare const membershipRow: (orgId: string, meta: HostMeta | undefined,
88
89
  subdomain?: string;
89
90
  orgId: string;
90
91
  };
92
+ /**
93
+ * The host-document paths a membership row is derived from. A writer that
94
+ * changes any of them owes `syncHostProjectionForMembers` (AGL-3972): the
95
+ * rows are written by the Admin SDK at these writers and nowhere else, so a
96
+ * change that skips the re-fan leaves every member's list on the old value
97
+ * until something unrelated rewrites the row.
98
+ */
99
+ export declare const PROJECTED_HOST_PATHS: readonly string[];
100
+ /** Whether a write that changed these paths owes the membership re-fan. */
101
+ export declare const changesProjectedHostFields: (paths: readonly string[]) => boolean;
102
+ /** The longest site name the console's Display name field accepts. */
103
+ export declare const HOST_DISPLAY_NAME_MAX = 200;
104
+ /**
105
+ * The host-document update for a mirrored field a person changed in the
106
+ * console (AGL-3972), read from a `/api/hosts/sync-memberships` body.
107
+ *
108
+ * The console used to write `displayName` and `seo.favicon` from the browser
109
+ * and then ping the server to re-fan the rows, chained on the write's
110
+ * server acknowledgement. Under the multi-tab cache that acknowledgement can
111
+ * take a minute (AGL-3806), and a page left in that minute, or a ping that
112
+ * failed, left the rows on the old name for good. The server now writes the
113
+ * field and re-fans in the same request, so the two cannot come apart.
114
+ *
115
+ * Answers `null` when the body names neither field (a plain re-fan), and an
116
+ * error for a value the console would never send. A favicon of `''` is the
117
+ * Remove button's clear, kept as `''` because that is what the card writes.
118
+ */
119
+ export declare function projectedHostFieldsUpdate(body: Record<string, unknown> | null | undefined): {
120
+ update: Record<string, unknown> | null;
121
+ } | {
122
+ error: string;
123
+ };
91
124
  /**
92
125
  * Re-sync ONE member's projection rows across all the org's hosts: set a row
93
126
  * for every host the member can reach, delete the row for every host they
@@ -97,8 +130,8 @@ export declare const membershipRow: (orgId: string, meta: HostMeta | undefined,
97
130
  export declare function syncMemberHostProjections(orgId: string, uid: string): Promise<void>;
98
131
  /**
99
132
  * Re-sync ONE host's projection rows across all org members: set a row for
100
- * every member who can reach it, delete for those who cannot. Call after a
101
- * host is created, renamed, or its displayName changes.
133
+ * every member who can reach it, delete for those who cannot. Call after
134
+ * any write that changes one of `PROJECTED_HOST_PATHS`.
102
135
  */
103
136
  export declare function syncHostProjectionForMembers(orgId: string, hostId: string): Promise<void>;
104
137
  /** Delete every projection row for a member across the org's hosts (member removed). */
@@ -186,6 +186,11 @@ const membershipRef = (db, uid, hostId)=>db.collection('users').doc(uid).collect
186
186
  // list takes can carry. Stored as `false`, never left out, because a query
187
187
  // cannot find a document by a field it lacks.
188
188
  hasCustomDomain: hasCustomDomain(meta),
189
+ // The custom domain itself (AGL-3972), so a list shows the address the
190
+ // site answers on rather than only its platform subdomain. Deleted, not
191
+ // omitted, when the domain is released, for the merge reason the favicon
192
+ // below gives.
193
+ cname: hasCustomDomain(meta) ? String(meta == null ? void 0 : meta.cname).trim() : FieldValue.delete(),
189
194
  // What the Sites list's Created filter and order read. NULL rather than
190
195
  // absent for a site that never recorded one: `orderBy('createdAt')` drops
191
196
  // a document MISSING the field, and a site must not vanish from the list
@@ -201,6 +206,62 @@ const membershipRef = (db, uid, hostId)=>db.collection('users').doc(uid).collect
201
206
  updatedAt: FieldValue.serverTimestamp()
202
207
  });
203
208
  };
209
+ /**
210
+ * The host-document paths a membership row is derived from. A writer that
211
+ * changes any of them owes `syncHostProjectionForMembers` (AGL-3972): the
212
+ * rows are written by the Admin SDK at these writers and nowhere else, so a
213
+ * change that skips the re-fan leaves every member's list on the old value
214
+ * until something unrelated rewrites the row.
215
+ */ export const PROJECTED_HOST_PATHS = [
216
+ 'displayName',
217
+ 'subdomain',
218
+ 'cname',
219
+ 'seo.favicon',
220
+ 'createdAt'
221
+ ];
222
+ /** Whether a write that changed these paths owes the membership re-fan. */ export const changesProjectedHostFields = (paths)=>paths.some((path)=>PROJECTED_HOST_PATHS.includes(path));
223
+ /** The longest site name the console's Display name field accepts. */ export const HOST_DISPLAY_NAME_MAX = 200;
224
+ /**
225
+ * The host-document update for a mirrored field a person changed in the
226
+ * console (AGL-3972), read from a `/api/hosts/sync-memberships` body.
227
+ *
228
+ * The console used to write `displayName` and `seo.favicon` from the browser
229
+ * and then ping the server to re-fan the rows, chained on the write's
230
+ * server acknowledgement. Under the multi-tab cache that acknowledgement can
231
+ * take a minute (AGL-3806), and a page left in that minute, or a ping that
232
+ * failed, left the rows on the old name for good. The server now writes the
233
+ * field and re-fans in the same request, so the two cannot come apart.
234
+ *
235
+ * Answers `null` when the body names neither field (a plain re-fan), and an
236
+ * error for a value the console would never send. A favicon of `''` is the
237
+ * Remove button's clear, kept as `''` because that is what the card writes.
238
+ */ export function projectedHostFieldsUpdate(body) {
239
+ const update = {};
240
+ if (body && 'displayName' in body) {
241
+ const name = typeof body['displayName'] === 'string' ? body['displayName'].trim() : '';
242
+ if (!name) return {
243
+ error: 'A site needs a name.'
244
+ };
245
+ if (name.length > HOST_DISPLAY_NAME_MAX) {
246
+ return {
247
+ error: `A site name is ${HOST_DISPLAY_NAME_MAX} characters at most.`
248
+ };
249
+ }
250
+ update['displayName'] = name;
251
+ }
252
+ if (body && 'favicon' in body) {
253
+ const favicon = body['favicon'];
254
+ if (typeof favicon !== 'string' || favicon.length > 2048) {
255
+ return {
256
+ error: 'The favicon must be a link or a media reference.'
257
+ };
258
+ }
259
+ update['seo.favicon'] = favicon.trim();
260
+ }
261
+ return {
262
+ update: Object.keys(update).length ? update : null
263
+ };
264
+ }
204
265
  /** Runs a set of write operations in ≤CHUNK-sized batches. */ const commitChunked = async (db, ops)=>{
205
266
  for(let i = 0; i < ops.length; i += CHUNK){
206
267
  const batch = db.batch();
@@ -264,8 +325,8 @@ const membershipRef = (db, uid, hostId)=>db.collection('users').doc(uid).collect
264
325
  }
265
326
  /**
266
327
  * Re-sync ONE host's projection rows across all org members: set a row for
267
- * every member who can reach it, delete for those who cannot. Call after a
268
- * host is created, renamed, or its displayName changes.
328
+ * every member who can reach it, delete for those who cannot. Call after
329
+ * any write that changes one of `PROJECTED_HOST_PATHS`.
269
330
  */ export async function syncHostProjectionForMembers(orgId, hostId) {
270
331
  const db = firestore();
271
332
  const [members, meta] = await Promise.all([
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/host-memberships.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Per-user host membership projection (AGL-844): a reverse index at\n * `users/{uid}/hostMemberships/{hostId}` mirroring `hosts/{hostId}.memberRoles`\n * — the hosts a user can reach in an org, denormalized with the name so the\n * site switcher and subdomain→id routing can query + order + name-prefix-search\n * a user's own sites without loading the whole `hosts` collection (which the\n * rules can only serve unordered under a per-user `memberRoles.{uid}` filter).\n *\n * Because it lives under the user's own doc it is owner-readable and already\n * membership-filtered, so `where(orgId==…) orderBy(nameLower|updatedAt)` is a\n * plain composite index (no dynamic map path). Admin-SDK-written only.\n *\n * It is a best-effort convenience index, NOT an authorization source: real\n * access stays gated by `hosts/{hostId}.memberRoles` in the rules, so a stale\n * row at worst shows a site that then 404s on read — never grants access.\n *\n * Writers are scoped, mirroring the `users/{uid}/orgs` reverse index: a member\n * change re-syncs THAT member across the org's hosts; a host change re-syncs\n * THAT host across members. Kept in sync at the same points as `memberRoles`\n * (see `syncHostMemberRoles` callers) plus the erase/displayName gaps (AGL-855).\n *\n * ## The Sites list is a query over these rows (AGL-3321)\n *\n * The organization's Sites list pages, filters and searches THIS collection —\n * `where(orgId ==)`, plus the reader's clauses, ordered by `nameLower` or\n * `createdAt` — and joins each row to the host document by id for display.\n * It cannot query `hosts` itself: the rules serve a non-staff LIST of `hosts`\n * only under a `memberRoles.{uid}` clause, a composite on that per-user map\n * path can exist for no order but the document id, and a predicated listen\n * over the mutable `memberRoles`/`orgId` is what tombstoned host documents\n * for every other reader (AGL-1190, `useOrgHosts`).\n *\n * So a row carries what that list asks of a site: `searchTokens` (the quick\n * search, over the name, the platform subdomain and the custom domain),\n * `hasCustomDomain` (the Custom domain filter) and the host's `createdAt`\n * (immutable, set once at create). Every field is derived from the host\n * document in `membershipRow`, so a re-sync from any writer re-derives all of\n * them; the writers of their source fields — create, the owner and staff\n * renames, the Setup name save, and the domain attach and detach routes (the\n * only writers of `cname`) — each re-sync. Rows written before AGL-3321 are\n * stamped by `tools/scripts/backfill-host-memberships-list-fields.mjs`.\n */\n\nimport {\n hostRoleFor,\n isOrgWideMember,\n nameSearchKey,\n type AglynOrganization,\n type AglynOrgMember,\n} from '@aglyn/aglyn/server'\nimport { nameSearchTokens } from '@aglyn/aglyn/app-utils/name-search'\nimport { FieldValue } from 'firebase-admin/firestore'\nimport firebaseAdmin from './firebase-admin'\n\nconst firestore = () => firebaseAdmin.app().firestore()\n\n/** Firestore caps a batch at 500 writes; commit in chunks below that. */\nconst CHUNK = 400\n\ninterface HostMeta {\n displayName?: string\n subdomain?: string\n favicon?: string\n /** The custom domain, which the Sites list's search finds a site by. */\n cname?: string\n /** When the site was created: set once, by `claimHostForOrg`, and never moved. */\n createdAt?: unknown\n /** Whether the site document was there to read. */\n exists?: boolean\n}\n\nconst orgHostIds = async (\n db: FirebaseFirestore.Firestore,\n orgId: string,\n): Promise<string[]> => {\n const org = (await db.collection('orgs').doc(orgId).get()).data() as\n | AglynOrganization\n | undefined\n return Object.keys(org?.hosts ?? {})\n}\n\nconst readHostMeta = async (\n db: FirebaseFirestore.Firestore,\n hostIds: string[],\n): Promise<Map<string, HostMeta>> => {\n if (hostIds.length === 0) return new Map()\n const snaps = await db.getAll(\n ...hostIds.map((id) => db.collection('hosts').doc(id)),\n )\n return new Map(\n snaps.map((snap) => [\n snap.id,\n {\n displayName: snap.get('displayName'),\n subdomain: snap.get('subdomain'),\n // The switcher renders from the projection, not the host doc, so the\n // favicon has to travel with it (AGL-1071).\n favicon: snap.get('seo')?.favicon,\n cname: snap.get('cname'),\n createdAt: snap.get('createdAt'),\n exists: snap.exists,\n },\n ]),\n )\n}\n\nconst readOrgMembers = async (\n db: FirebaseFirestore.Firestore,\n orgId: string,\n): Promise<AglynOrgMember[]> => {\n const snap = await db\n .collection('orgs')\n .doc(orgId)\n .collection('members')\n .get()\n return snap.docs.map((d) => ({ $id: d.id, ...d.data() }) as AglynOrgMember)\n}\n\nconst membershipRef = (\n db: FirebaseFirestore.Firestore,\n uid: string,\n hostId: string,\n) => db.collection('users').doc(uid).collection('hostMemberships').doc(hostId)\n\n/** A tail of a word begins after any character that is not a letter or a digit. */\nconst WORD_SEPARATOR = /[^\\p{L}\\p{N}]/u\n\n/**\n * A word, and every tail of it that begins after a separator:\n * `shop.harbor-bakery.com` is itself, `harbor-bakery.com`, `bakery.com` and\n * `com`. Walked by codepoint, so a tail never starts inside a surrogate pair.\n */\nconst wordTails = (word: string): string[] => {\n const chars = [...word]\n const tails = [word]\n for (let at = 1; at < chars.length; at += 1) {\n if (WORD_SEPARATOR.test(chars[at - 1]) && !WORD_SEPARATOR.test(chars[at])) {\n tails.push(chars.slice(at).join(''))\n }\n }\n return tails\n}\n\n/**\n * The words a site is FOUND by in the Sites list's quick search (AGL-3321):\n * its name, its platform subdomain and its custom domain, as the word-prefix\n * tokens `nameSearchTokens` writes, which the list's query asks for with one\n * `array-contains` on the first typed word (`nameSearchNormalizers.token`).\n *\n * A subdomain or a domain is one \"word\" to `nameSearchTokens`, so the prefixes\n * of `harbor-bakery` alone would find it by `harbor` and never by `bakery`.\n * Every tail that begins after a separator is tokenized too, which is what\n * lets `bakery`, `bakery.com` and `shop.harbor` all find\n * `shop.harbor-bakery.com` — the words a reader remembers of an address.\n *\n * The platform apex is not a word here: it is the same on every site, so it\n * narrows nothing, and the subdomain in front of it is.\n *\n * Its script-side twin, for the backfill and the seeds that write these rows,\n * is `tools/scripts/lib/host-membership-search-tokens.mjs`; both answer\n * `tools/scripts/lib/host-membership-search-tokens.fixtures.json`, which this\n * library's spec asserts too.\n */\nexport function hostMembershipSearchTokens(\n meta: Pick<HostMeta, 'displayName' | 'subdomain' | 'cname'> | undefined,\n): string[] {\n const words = [meta?.displayName, meta?.subdomain, meta?.cname]\n .map((value) => nameSearchKey(typeof value === 'string' ? value : ''))\n .flatMap((key) => (key ? key.split(' ') : []))\n .flatMap(wordTails)\n return nameSearchTokens(words.join(' '))\n}\n\n/**\n * Whether a site has a custom domain connected, as the Sites card lists it:\n * a non-blank `cname`, which only the domain attach route writes and only the\n * detach route removes.\n */\nexport const hasCustomDomain = (meta: Pick<HostMeta, 'cname'> | undefined): boolean =>\n typeof meta?.cname === 'string' && meta.cname.trim() !== ''\n\n/**\n * The keys the staff Sites list (`/admin/sites`) queries on the SITE document\n * itself: the same name key, search tokens and custom-domain flag the\n * membership rows carry, so staff find a site by its name, subdomain or\n * domain across every organization without walking anyone's projection.\n *\n * Stamped by `syncHostProjectionForMembers` — the funnel every create,\n * rename, domain attach and domain release already calls — and by\n * `tools/scripts/backfill-host-search-fields.mjs` on the sites written before\n * it. `hasCustomDomain` is stored as `false`, never left out, for the reason\n * the membership row gives: a query cannot find a document by a field it\n * lacks.\n */\nexport const hostSearchFields = (\n meta: Pick<HostMeta, 'displayName' | 'subdomain' | 'cname'> | undefined,\n) => ({\n nameLower: nameSearchKey(meta?.displayName ?? ''),\n searchTokens: hostMembershipSearchTokens(meta),\n hasCustomDomain: hasCustomDomain(meta),\n})\n\n/** A Firestore timestamp, as opposed to a legacy number or string. */\nconst isTimestamp = (value: unknown): boolean =>\n typeof (value as { toMillis?: unknown } | null | undefined)?.toMillis === 'function'\n\n/**\n * Shape one projection row. Exported for tests: the favicon rule below is a\n * delete-vs-omit decision that is invisible in review and silent in\n * production when wrong (AGL-1071).\n */\nexport const membershipRow = (\n orgId: string,\n meta: HostMeta | undefined,\n role: string,\n) => {\n const displayName = meta?.displayName ?? ''\n return {\n orgId,\n ...(meta?.subdomain ? { subdomain: meta.subdomain } : {}),\n displayName,\n nameLower: nameSearchKey(displayName),\n // What the Sites list searches (AGL-3321). Re-derived on every sync, so a\n // rename, a domain attach or a domain release moves it with the host.\n searchTokens: hostMembershipSearchTokens(meta),\n // The Custom domain filter (AGL-3321): an equality, which every order the\n // list takes can carry. Stored as `false`, never left out, because a query\n // cannot find a document by a field it lacks.\n hasCustomDomain: hasCustomDomain(meta),\n // What the Sites list's Created filter and order read. NULL rather than\n // absent for a site that never recorded one: `orderBy('createdAt')` drops\n // a document MISSING the field, and a site must not vanish from the list\n // because it is sorted by a date it does not have.\n createdAt: isTimestamp(meta?.createdAt) ? meta?.createdAt : null,\n // DELETE rather than omit when the site has no favicon (AGL-1071). These\n // rows are written with `{ merge: true }`, so omitting the key leaves\n // whatever was there — clearing a favicon would keep showing the old one\n // in the switcher until something unrelated rewrote the row. The clear\n // path writes `seo.favicon: ''`, so test truthiness, not nullishness.\n favicon: meta?.favicon ? meta.favicon : FieldValue.delete(),\n role,\n updatedAt: FieldValue.serverTimestamp(),\n }\n}\n\n/** Runs a set of write operations in ≤CHUNK-sized batches. */\nconst commitChunked = async (\n db: FirebaseFirestore.Firestore,\n ops: Array<(batch: FirebaseFirestore.WriteBatch) => void>,\n): Promise<void> => {\n for (let i = 0; i < ops.length; i += CHUNK) {\n const batch = db.batch()\n for (const op of ops.slice(i, i + CHUNK)) op(batch)\n await batch.commit()\n }\n}\n\n/**\n * Mirror the member's org-wide reach onto their `users/{uid}/orgs/{orgId}`\n * row (AGL-1032), so the console can tell a site collaborator from an\n * org-wide viewer without a second read on every org route.\n *\n * Rides the projection pass rather than being a call the membership APIs\n * each have to remember: every path that changes a member's reach — add,\n * role change, grant, revoke, ownership transfer — already re-syncs their\n * host rows, so one funnel keeps the mirror true and self-heals a row an\n * earlier failure left stale.\n *\n * Only ever UPDATES an existing row. The reverse index is created with the\n * membership and deleted with it; a `set`/merge here on a removed member\n * would resurrect a half-row with no `orgName` or `slug`, and the console\n * renders that as a nameless workspace nobody can open.\n */\nasync function syncMemberOrgReach(\n db: FirebaseFirestore.Firestore,\n orgId: string,\n uid: string,\n member: AglynOrgMember | null,\n): Promise<void> {\n if (!member) return\n const ref = db.collection('users').doc(uid).collection('orgs').doc(orgId)\n const snap = await ref.get()\n if (!snap.exists) return\n const orgWide = isOrgWideMember(member)\n if (snap.get('orgWide') === orgWide) return\n await ref.set({ orgWide }, { merge: true })\n}\n\n/**\n * Re-sync ONE member's projection rows across all the org's hosts: set a row\n * for every host the member can reach, delete the row for every host they\n * cannot (a role downgrade silently drops hosts). Call after any change to a\n * single member (add / role change / grant / revoke / ownership step).\n */\nexport async function syncMemberHostProjections(\n orgId: string,\n uid: string,\n): Promise<void> {\n const db = firestore()\n const [memberSnap, hostIds] = await Promise.all([\n db.collection('orgs').doc(orgId).collection('members').doc(uid).get(),\n orgHostIds(db, orgId),\n ])\n const member = memberSnap.exists\n ? ({ $id: uid, ...memberSnap.data() } as AglynOrgMember)\n : null\n await syncMemberOrgReach(db, orgId, uid, member)\n const meta = await readHostMeta(db, hostIds)\n const ops = hostIds.map((hostId) => (batch: FirebaseFirestore.WriteBatch) => {\n const role = hostRoleFor(member, hostId)\n const ref = membershipRef(db, uid, hostId)\n if (role) batch.set(ref, membershipRow(orgId, meta.get(hostId), role), { merge: true })\n else batch.delete(ref)\n })\n await commitChunked(db, ops)\n}\n\n/**\n * Re-sync ONE host's projection rows across all org members: set a row for\n * every member who can reach it, delete for those who cannot. Call after a\n * host is created, renamed, or its displayName changes.\n */\nexport async function syncHostProjectionForMembers(\n orgId: string,\n hostId: string,\n): Promise<void> {\n const db = firestore()\n const [members, meta] = await Promise.all([\n readOrgMembers(db, orgId),\n readHostMeta(db, [hostId]),\n ])\n const hostMeta = meta.get(hostId)\n const ops = members.map((member) => (batch: FirebaseFirestore.WriteBatch) => {\n const role = hostRoleFor(member, hostId)\n const ref = membershipRef(db, member.$id, hostId)\n if (role) batch.set(ref, membershipRow(orgId, hostMeta, role), { merge: true })\n else batch.delete(ref)\n })\n await commitChunked(db, ops)\n // The staff Sites list's keys, on the site itself. `update`, never a\n // merge-set: a site erased since the read must not be minted back as a\n // phantom carrying only these three keys (the AGL-1765 shape). Outside the\n // batch so a site gone missing cannot fail its members' rows.\n if (hostMeta?.exists) {\n await db\n .collection('hosts')\n .doc(hostId)\n .update(hostSearchFields(hostMeta))\n .catch(() => undefined)\n }\n}\n\n/** Delete every projection row for a member across the org's hosts (member removed). */\nexport async function deleteMemberHostProjections(\n orgId: string,\n uid: string,\n): Promise<void> {\n const db = firestore()\n const hostIds = await orgHostIds(db, orgId)\n await commitChunked(\n db,\n hostIds.map((hostId) => (batch: FirebaseFirestore.WriteBatch) => {\n batch.delete(membershipRef(db, uid, hostId))\n }),\n )\n}\n\n/** Delete every member's projection row for one host (host erased). */\nexport async function deleteHostProjectionForAllMembers(\n orgId: string,\n hostId: string,\n /**\n * Holders to clear besides the org's members: the host's own `memberRoles`\n * keys. A site collaborator who is not an org member has a row too, and\n * the site switcher kept listing a deleted site for them.\n */\n extraUids: readonly string[] = [],\n): Promise<void> {\n const db = firestore()\n const members = await readOrgMembers(db, orgId)\n const uids = new Set<string>([\n ...members.map((member) => member.$id),\n ...extraUids.filter(Boolean),\n ])\n await deleteHostProjectionForUids(hostId, [...uids])\n}\n\n/** Delete the projection row of one host for exactly these users. */\nexport async function deleteHostProjectionForUids(\n hostId: string,\n uids: readonly string[],\n): Promise<void> {\n const db = firestore()\n await commitChunked(\n db,\n [...new Set(uids.filter(Boolean))].map(\n (uid) => (batch: FirebaseFirestore.WriteBatch) => {\n batch.delete(membershipRef(db, uid, hostId))\n },\n ),\n )\n}\n"],"names":["hostRoleFor","isOrgWideMember","nameSearchKey","nameSearchTokens","FieldValue","firebaseAdmin","firestore","app","CHUNK","orgHostIds","db","orgId","org","collection","doc","get","data","Object","keys","hosts","readHostMeta","hostIds","length","Map","snaps","getAll","map","id","snap","displayName","subdomain","favicon","cname","createdAt","exists","readOrgMembers","docs","d","$id","membershipRef","uid","hostId","WORD_SEPARATOR","wordTails","word","chars","tails","at","test","push","slice","join","hostMembershipSearchTokens","meta","words","value","flatMap","key","split","hasCustomDomain","trim","hostSearchFields","nameLower","searchTokens","isTimestamp","toMillis","membershipRow","role","delete","updatedAt","serverTimestamp","commitChunked","ops","i","batch","op","commit","syncMemberOrgReach","member","ref","orgWide","set","merge","syncMemberHostProjections","memberSnap","Promise","all","syncHostProjectionForMembers","members","hostMeta","update","catch","undefined","deleteMemberHostProjections","deleteHostProjectionForAllMembers","extraUids","uids","Set","filter","Boolean","deleteHostProjectionForUids"],"mappings":"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"}
1
+ {"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/host-memberships.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Per-user host membership projection (AGL-844): a reverse index at\n * `users/{uid}/hostMemberships/{hostId}` mirroring `hosts/{hostId}.memberRoles`\n * — the hosts a user can reach in an org, denormalized with the name so the\n * site switcher and subdomain→id routing can query + order + name-prefix-search\n * a user's own sites without loading the whole `hosts` collection (which the\n * rules can only serve unordered under a per-user `memberRoles.{uid}` filter).\n *\n * Because it lives under the user's own doc it is owner-readable and already\n * membership-filtered, so `where(orgId==…) orderBy(nameLower|updatedAt)` is a\n * plain composite index (no dynamic map path). Admin-SDK-written only.\n *\n * It is a best-effort convenience index, NOT an authorization source: real\n * access stays gated by `hosts/{hostId}.memberRoles` in the rules, so a stale\n * row at worst shows a site that then 404s on read — never grants access.\n *\n * Writers are scoped, mirroring the `users/{uid}/orgs` reverse index: a member\n * change re-syncs THAT member across the org's hosts; a host change re-syncs\n * THAT host across members. Kept in sync at the same points as `memberRoles`\n * (see `syncHostMemberRoles` callers) plus the erase/displayName gaps (AGL-855).\n *\n * ## The Sites list is a query over these rows (AGL-3321)\n *\n * The organization's Sites list pages, filters and searches THIS collection —\n * `where(orgId ==)`, plus the reader's clauses, ordered by `nameLower` or\n * `createdAt` — and joins each row to the host document by id for display.\n * It cannot query `hosts` itself: the rules serve a non-staff LIST of `hosts`\n * only under a `memberRoles.{uid}` clause, a composite on that per-user map\n * path can exist for no order but the document id, and a predicated listen\n * over the mutable `memberRoles`/`orgId` is what tombstoned host documents\n * for every other reader (AGL-1190, `useOrgHosts`).\n *\n * So a row carries what that list asks of a site: `searchTokens` (the quick\n * search, over the name, the platform subdomain and the custom domain),\n * `hasCustomDomain` (the Custom domain filter) and the host's `createdAt`\n * (immutable, set once at create). Every field is derived from the host\n * document in `membershipRow`, so a re-sync from any writer re-derives all of\n * them; the writers of their source fields — create, the owner and staff\n * renames, the Setup name save, and the domain attach and detach routes (the\n * only writers of `cname`) — each re-sync. Rows written before AGL-3321 are\n * stamped by `tools/scripts/backfill-host-memberships-list-fields.mjs`.\n */\n\nimport {\n hostRoleFor,\n isOrgWideMember,\n nameSearchKey,\n type AglynOrganization,\n type AglynOrgMember,\n} from '@aglyn/aglyn/server'\nimport { nameSearchTokens } from '@aglyn/aglyn/app-utils/name-search'\nimport { FieldValue } from 'firebase-admin/firestore'\nimport firebaseAdmin from './firebase-admin'\n\nconst firestore = () => firebaseAdmin.app().firestore()\n\n/** Firestore caps a batch at 500 writes; commit in chunks below that. */\nconst CHUNK = 400\n\ninterface HostMeta {\n displayName?: string\n subdomain?: string\n favicon?: string\n /** The custom domain, which the Sites list's search finds a site by. */\n cname?: string\n /** When the site was created: set once, by `claimHostForOrg`, and never moved. */\n createdAt?: unknown\n /** Whether the site document was there to read. */\n exists?: boolean\n}\n\nconst orgHostIds = async (\n db: FirebaseFirestore.Firestore,\n orgId: string,\n): Promise<string[]> => {\n const org = (await db.collection('orgs').doc(orgId).get()).data() as\n | AglynOrganization\n | undefined\n return Object.keys(org?.hosts ?? {})\n}\n\nconst readHostMeta = async (\n db: FirebaseFirestore.Firestore,\n hostIds: string[],\n): Promise<Map<string, HostMeta>> => {\n if (hostIds.length === 0) return new Map()\n const snaps = await db.getAll(\n ...hostIds.map((id) => db.collection('hosts').doc(id)),\n )\n return new Map(\n snaps.map((snap) => [\n snap.id,\n {\n displayName: snap.get('displayName'),\n subdomain: snap.get('subdomain'),\n // The switcher renders from the projection, not the host doc, so the\n // favicon has to travel with it (AGL-1071).\n favicon: snap.get('seo')?.favicon,\n cname: snap.get('cname'),\n createdAt: snap.get('createdAt'),\n exists: snap.exists,\n },\n ]),\n )\n}\n\nconst readOrgMembers = async (\n db: FirebaseFirestore.Firestore,\n orgId: string,\n): Promise<AglynOrgMember[]> => {\n const snap = await db\n .collection('orgs')\n .doc(orgId)\n .collection('members')\n .get()\n return snap.docs.map((d) => ({ $id: d.id, ...d.data() }) as AglynOrgMember)\n}\n\nconst membershipRef = (\n db: FirebaseFirestore.Firestore,\n uid: string,\n hostId: string,\n) => db.collection('users').doc(uid).collection('hostMemberships').doc(hostId)\n\n/** A tail of a word begins after any character that is not a letter or a digit. */\nconst WORD_SEPARATOR = /[^\\p{L}\\p{N}]/u\n\n/**\n * A word, and every tail of it that begins after a separator:\n * `shop.harbor-bakery.com` is itself, `harbor-bakery.com`, `bakery.com` and\n * `com`. Walked by codepoint, so a tail never starts inside a surrogate pair.\n */\nconst wordTails = (word: string): string[] => {\n const chars = [...word]\n const tails = [word]\n for (let at = 1; at < chars.length; at += 1) {\n if (WORD_SEPARATOR.test(chars[at - 1]) && !WORD_SEPARATOR.test(chars[at])) {\n tails.push(chars.slice(at).join(''))\n }\n }\n return tails\n}\n\n/**\n * The words a site is FOUND by in the Sites list's quick search (AGL-3321):\n * its name, its platform subdomain and its custom domain, as the word-prefix\n * tokens `nameSearchTokens` writes, which the list's query asks for with one\n * `array-contains` on the first typed word (`nameSearchNormalizers.token`).\n *\n * A subdomain or a domain is one \"word\" to `nameSearchTokens`, so the prefixes\n * of `harbor-bakery` alone would find it by `harbor` and never by `bakery`.\n * Every tail that begins after a separator is tokenized too, which is what\n * lets `bakery`, `bakery.com` and `shop.harbor` all find\n * `shop.harbor-bakery.com` — the words a reader remembers of an address.\n *\n * The platform apex is not a word here: it is the same on every site, so it\n * narrows nothing, and the subdomain in front of it is.\n *\n * Its script-side twin, for the backfill and the seeds that write these rows,\n * is `tools/scripts/lib/host-membership-search-tokens.mjs`; both answer\n * `tools/scripts/lib/host-membership-search-tokens.fixtures.json`, which this\n * library's spec asserts too.\n */\nexport function hostMembershipSearchTokens(\n meta: Pick<HostMeta, 'displayName' | 'subdomain' | 'cname'> | undefined,\n): string[] {\n const words = [meta?.displayName, meta?.subdomain, meta?.cname]\n .map((value) => nameSearchKey(typeof value === 'string' ? value : ''))\n .flatMap((key) => (key ? key.split(' ') : []))\n .flatMap(wordTails)\n return nameSearchTokens(words.join(' '))\n}\n\n/**\n * Whether a site has a custom domain connected, as the Sites card lists it:\n * a non-blank `cname`, which only the domain attach route writes and only the\n * detach route removes.\n */\nexport const hasCustomDomain = (meta: Pick<HostMeta, 'cname'> | undefined): boolean =>\n typeof meta?.cname === 'string' && meta.cname.trim() !== ''\n\n/**\n * The keys the staff Sites list (`/admin/sites`) queries on the SITE document\n * itself: the same name key, search tokens and custom-domain flag the\n * membership rows carry, so staff find a site by its name, subdomain or\n * domain across every organization without walking anyone's projection.\n *\n * Stamped by `syncHostProjectionForMembers` — the funnel every create,\n * rename, domain attach and domain release already calls — and by\n * `tools/scripts/backfill-host-search-fields.mjs` on the sites written before\n * it. `hasCustomDomain` is stored as `false`, never left out, for the reason\n * the membership row gives: a query cannot find a document by a field it\n * lacks.\n */\nexport const hostSearchFields = (\n meta: Pick<HostMeta, 'displayName' | 'subdomain' | 'cname'> | undefined,\n) => ({\n nameLower: nameSearchKey(meta?.displayName ?? ''),\n searchTokens: hostMembershipSearchTokens(meta),\n hasCustomDomain: hasCustomDomain(meta),\n})\n\n/** A Firestore timestamp, as opposed to a legacy number or string. */\nconst isTimestamp = (value: unknown): boolean =>\n typeof (value as { toMillis?: unknown } | null | undefined)?.toMillis === 'function'\n\n/**\n * Shape one projection row. Exported for tests: the favicon rule below is a\n * delete-vs-omit decision that is invisible in review and silent in\n * production when wrong (AGL-1071).\n */\nexport const membershipRow = (\n orgId: string,\n meta: HostMeta | undefined,\n role: string,\n) => {\n const displayName = meta?.displayName ?? ''\n return {\n orgId,\n ...(meta?.subdomain ? { subdomain: meta.subdomain } : {}),\n displayName,\n nameLower: nameSearchKey(displayName),\n // What the Sites list searches (AGL-3321). Re-derived on every sync, so a\n // rename, a domain attach or a domain release moves it with the host.\n searchTokens: hostMembershipSearchTokens(meta),\n // The Custom domain filter (AGL-3321): an equality, which every order the\n // list takes can carry. Stored as `false`, never left out, because a query\n // cannot find a document by a field it lacks.\n hasCustomDomain: hasCustomDomain(meta),\n // The custom domain itself (AGL-3972), so a list shows the address the\n // site answers on rather than only its platform subdomain. Deleted, not\n // omitted, when the domain is released, for the merge reason the favicon\n // below gives.\n cname: hasCustomDomain(meta) ? String(meta?.cname).trim() : FieldValue.delete(),\n // What the Sites list's Created filter and order read. NULL rather than\n // absent for a site that never recorded one: `orderBy('createdAt')` drops\n // a document MISSING the field, and a site must not vanish from the list\n // because it is sorted by a date it does not have.\n createdAt: isTimestamp(meta?.createdAt) ? meta?.createdAt : null,\n // DELETE rather than omit when the site has no favicon (AGL-1071). These\n // rows are written with `{ merge: true }`, so omitting the key leaves\n // whatever was there — clearing a favicon would keep showing the old one\n // in the switcher until something unrelated rewrote the row. The clear\n // path writes `seo.favicon: ''`, so test truthiness, not nullishness.\n favicon: meta?.favicon ? meta.favicon : FieldValue.delete(),\n role,\n updatedAt: FieldValue.serverTimestamp(),\n }\n}\n\n/**\n * The host-document paths a membership row is derived from. A writer that\n * changes any of them owes `syncHostProjectionForMembers` (AGL-3972): the\n * rows are written by the Admin SDK at these writers and nowhere else, so a\n * change that skips the re-fan leaves every member's list on the old value\n * until something unrelated rewrites the row.\n */\nexport const PROJECTED_HOST_PATHS: readonly string[] = [\n 'displayName',\n 'subdomain',\n 'cname',\n 'seo.favicon',\n 'createdAt',\n]\n\n/** Whether a write that changed these paths owes the membership re-fan. */\nexport const changesProjectedHostFields = (paths: readonly string[]): boolean =>\n paths.some((path) => PROJECTED_HOST_PATHS.includes(path))\n\n/** The longest site name the console's Display name field accepts. */\nexport const HOST_DISPLAY_NAME_MAX = 200\n\n/**\n * The host-document update for a mirrored field a person changed in the\n * console (AGL-3972), read from a `/api/hosts/sync-memberships` body.\n *\n * The console used to write `displayName` and `seo.favicon` from the browser\n * and then ping the server to re-fan the rows, chained on the write's\n * server acknowledgement. Under the multi-tab cache that acknowledgement can\n * take a minute (AGL-3806), and a page left in that minute, or a ping that\n * failed, left the rows on the old name for good. The server now writes the\n * field and re-fans in the same request, so the two cannot come apart.\n *\n * Answers `null` when the body names neither field (a plain re-fan), and an\n * error for a value the console would never send. A favicon of `''` is the\n * Remove button's clear, kept as `''` because that is what the card writes.\n */\nexport function projectedHostFieldsUpdate(\n body: Record<string, unknown> | null | undefined,\n): { update: Record<string, unknown> | null } | { error: string } {\n const update: Record<string, unknown> = {}\n if (body && 'displayName' in body) {\n const name = typeof body['displayName'] === 'string' ? body['displayName'].trim() : ''\n if (!name) return { error: 'A site needs a name.' }\n if (name.length > HOST_DISPLAY_NAME_MAX) {\n return { error: `A site name is ${HOST_DISPLAY_NAME_MAX} characters at most.` }\n }\n update['displayName'] = name\n }\n if (body && 'favicon' in body) {\n const favicon = body['favicon']\n if (typeof favicon !== 'string' || favicon.length > 2_048) {\n return { error: 'The favicon must be a link or a media reference.' }\n }\n update['seo.favicon'] = favicon.trim()\n }\n return { update: Object.keys(update).length ? update : null }\n}\n\n/** Runs a set of write operations in ≤CHUNK-sized batches. */\nconst commitChunked = async (\n db: FirebaseFirestore.Firestore,\n ops: Array<(batch: FirebaseFirestore.WriteBatch) => void>,\n): Promise<void> => {\n for (let i = 0; i < ops.length; i += CHUNK) {\n const batch = db.batch()\n for (const op of ops.slice(i, i + CHUNK)) op(batch)\n await batch.commit()\n }\n}\n\n/**\n * Mirror the member's org-wide reach onto their `users/{uid}/orgs/{orgId}`\n * row (AGL-1032), so the console can tell a site collaborator from an\n * org-wide viewer without a second read on every org route.\n *\n * Rides the projection pass rather than being a call the membership APIs\n * each have to remember: every path that changes a member's reach — add,\n * role change, grant, revoke, ownership transfer — already re-syncs their\n * host rows, so one funnel keeps the mirror true and self-heals a row an\n * earlier failure left stale.\n *\n * Only ever UPDATES an existing row. The reverse index is created with the\n * membership and deleted with it; a `set`/merge here on a removed member\n * would resurrect a half-row with no `orgName` or `slug`, and the console\n * renders that as a nameless workspace nobody can open.\n */\nasync function syncMemberOrgReach(\n db: FirebaseFirestore.Firestore,\n orgId: string,\n uid: string,\n member: AglynOrgMember | null,\n): Promise<void> {\n if (!member) return\n const ref = db.collection('users').doc(uid).collection('orgs').doc(orgId)\n const snap = await ref.get()\n if (!snap.exists) return\n const orgWide = isOrgWideMember(member)\n if (snap.get('orgWide') === orgWide) return\n await ref.set({ orgWide }, { merge: true })\n}\n\n/**\n * Re-sync ONE member's projection rows across all the org's hosts: set a row\n * for every host the member can reach, delete the row for every host they\n * cannot (a role downgrade silently drops hosts). Call after any change to a\n * single member (add / role change / grant / revoke / ownership step).\n */\nexport async function syncMemberHostProjections(\n orgId: string,\n uid: string,\n): Promise<void> {\n const db = firestore()\n const [memberSnap, hostIds] = await Promise.all([\n db.collection('orgs').doc(orgId).collection('members').doc(uid).get(),\n orgHostIds(db, orgId),\n ])\n const member = memberSnap.exists\n ? ({ $id: uid, ...memberSnap.data() } as AglynOrgMember)\n : null\n await syncMemberOrgReach(db, orgId, uid, member)\n const meta = await readHostMeta(db, hostIds)\n const ops = hostIds.map((hostId) => (batch: FirebaseFirestore.WriteBatch) => {\n const role = hostRoleFor(member, hostId)\n const ref = membershipRef(db, uid, hostId)\n if (role) batch.set(ref, membershipRow(orgId, meta.get(hostId), role), { merge: true })\n else batch.delete(ref)\n })\n await commitChunked(db, ops)\n}\n\n/**\n * Re-sync ONE host's projection rows across all org members: set a row for\n * every member who can reach it, delete for those who cannot. Call after\n * any write that changes one of `PROJECTED_HOST_PATHS`.\n */\nexport async function syncHostProjectionForMembers(\n orgId: string,\n hostId: string,\n): Promise<void> {\n const db = firestore()\n const [members, meta] = await Promise.all([\n readOrgMembers(db, orgId),\n readHostMeta(db, [hostId]),\n ])\n const hostMeta = meta.get(hostId)\n const ops = members.map((member) => (batch: FirebaseFirestore.WriteBatch) => {\n const role = hostRoleFor(member, hostId)\n const ref = membershipRef(db, member.$id, hostId)\n if (role) batch.set(ref, membershipRow(orgId, hostMeta, role), { merge: true })\n else batch.delete(ref)\n })\n await commitChunked(db, ops)\n // The staff Sites list's keys, on the site itself. `update`, never a\n // merge-set: a site erased since the read must not be minted back as a\n // phantom carrying only these three keys (the AGL-1765 shape). Outside the\n // batch so a site gone missing cannot fail its members' rows.\n if (hostMeta?.exists) {\n await db\n .collection('hosts')\n .doc(hostId)\n .update(hostSearchFields(hostMeta))\n .catch(() => undefined)\n }\n}\n\n/** Delete every projection row for a member across the org's hosts (member removed). */\nexport async function deleteMemberHostProjections(\n orgId: string,\n uid: string,\n): Promise<void> {\n const db = firestore()\n const hostIds = await orgHostIds(db, orgId)\n await commitChunked(\n db,\n hostIds.map((hostId) => (batch: FirebaseFirestore.WriteBatch) => {\n batch.delete(membershipRef(db, uid, hostId))\n }),\n )\n}\n\n/** Delete every member's projection row for one host (host erased). */\nexport async function deleteHostProjectionForAllMembers(\n orgId: string,\n hostId: string,\n /**\n * Holders to clear besides the org's members: the host's own `memberRoles`\n * keys. A site collaborator who is not an org member has a row too, and\n * the site switcher kept listing a deleted site for them.\n */\n extraUids: readonly string[] = [],\n): Promise<void> {\n const db = firestore()\n const members = await readOrgMembers(db, orgId)\n const uids = new Set<string>([\n ...members.map((member) => member.$id),\n ...extraUids.filter(Boolean),\n ])\n await deleteHostProjectionForUids(hostId, [...uids])\n}\n\n/** Delete the projection row of one host for exactly these users. */\nexport async function deleteHostProjectionForUids(\n hostId: string,\n uids: readonly string[],\n): Promise<void> {\n const db = firestore()\n await commitChunked(\n db,\n [...new Set(uids.filter(Boolean))].map(\n (uid) => (batch: FirebaseFirestore.WriteBatch) => {\n batch.delete(membershipRef(db, uid, hostId))\n },\n ),\n )\n}\n"],"names":["hostRoleFor","isOrgWideMember","nameSearchKey","nameSearchTokens","FieldValue","firebaseAdmin","firestore","app","CHUNK","orgHostIds","db","orgId","org","collection","doc","get","data","Object","keys","hosts","readHostMeta","hostIds","length","Map","snaps","getAll","map","id","snap","displayName","subdomain","favicon","cname","createdAt","exists","readOrgMembers","docs","d","$id","membershipRef","uid","hostId","WORD_SEPARATOR","wordTails","word","chars","tails","at","test","push","slice","join","hostMembershipSearchTokens","meta","words","value","flatMap","key","split","hasCustomDomain","trim","hostSearchFields","nameLower","searchTokens","isTimestamp","toMillis","membershipRow","role","String","delete","updatedAt","serverTimestamp","PROJECTED_HOST_PATHS","changesProjectedHostFields","paths","some","path","includes","HOST_DISPLAY_NAME_MAX","projectedHostFieldsUpdate","body","update","name","error","commitChunked","ops","i","batch","op","commit","syncMemberOrgReach","member","ref","orgWide","set","merge","syncMemberHostProjections","memberSnap","Promise","all","syncHostProjectionForMembers","members","hostMeta","catch","undefined","deleteMemberHostProjections","deleteHostProjectionForAllMembers","extraUids","uids","Set","filter","Boolean","deleteHostProjectionForUids"],"mappings":"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"}
@@ -14,7 +14,7 @@
14
14
  * See the License for the specific language governing permissions and
15
15
  * limitations under the License.
16
16
  */
17
- import { hasInlineOrgBilling, type OrgBillingDoc, type OrgInlineBilling } from '@aglyn/aglyn/server';
17
+ import { hasInlineOrgBilling, type OrgBillingDoc, type OrgInlineBilling, type AiTierId } from '@aglyn/aglyn/server';
18
18
  /** `orgs/{orgId}/billing/stripe`. */
19
19
  export declare function orgBillingRef(orgId: string): FirebaseFirestore.DocumentReference<FirebaseFirestore.DocumentData, FirebaseFirestore.DocumentData>;
20
20
  /**
@@ -82,7 +82,9 @@ export declare function readOrgBillingCustomerModes(orgId: string): Promise<{
82
82
  * a doc that no longer exists, and it is the only thing standing between an org
83
83
  * the backfill somehow missed and a paying workspace rendering as Free.
84
84
  */
85
- export declare function writeOrgBilling(orgId: string, patch: Partial<OrgBillingDoc> & Pick<OrgInlineBilling, 'seatAddons'>, options?: {
85
+ export declare function writeOrgBilling(orgId: string, patch: Partial<OrgBillingDoc> & Pick<OrgInlineBilling, 'seatAddons'> & {
86
+ aiTier?: AiTierId | null;
87
+ }, options?: {
86
88
  writeInline?: boolean;
87
89
  }): Promise<void>;
88
90
  /**
@@ -197,6 +197,11 @@ import { firebaseAdmin } from "./firebase-admin.js";
197
197
  if (patch.seatAddons !== undefined) {
198
198
  orgPatch['seatAddons'] = patch.seatAddons;
199
199
  }
200
+ // Which Aglyn AI tier those quantities hold (AGL-3965), derived from the
201
+ // same items and read from the same document, so it travels with them.
202
+ if (patch.aiTier !== undefined) {
203
+ orgPatch['aiTier'] = patch.aiTier;
204
+ }
200
205
  if (Object.keys(orgPatch).length) batch.set(orgRef, orgPatch, {
201
206
  merge: true
202
207
  });