@aglyn/tenant-data-admin 1.0.0-beta.269 → 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.
- package/package.json +7 -7
- package/src/lib/render-cache.d.ts +10 -3
- package/src/lib/render-cache.js +10 -3
- package/src/lib/render-cache.js.map +1 -1
- package/src/lib/server/append-only-history-write.d.ts +38 -0
- package/src/lib/server/append-only-history-write.js +60 -0
- package/src/lib/server/append-only-history-write.js.map +1 -0
- package/src/lib/server/billing-addons.d.ts +58 -30
- package/src/lib/server/billing-addons.js +102 -77
- package/src/lib/server/billing-addons.js.map +1 -1
- package/src/lib/server/bundle-links.d.ts +166 -0
- package/src/lib/server/bundle-links.js +286 -0
- package/src/lib/server/bundle-links.js.map +1 -0
- package/src/lib/server/client-build.d.ts +74 -0
- package/src/lib/server/client-build.js +264 -0
- package/src/lib/server/client-build.js.map +1 -0
- package/src/lib/server/configured-url-fetch.d.ts +26 -0
- package/src/lib/server/configured-url-fetch.js +68 -0
- package/src/lib/server/configured-url-fetch.js.map +1 -1
- package/src/lib/server/custom-domain-redirects.d.ts +50 -0
- package/src/lib/server/custom-domain-redirects.js +61 -0
- package/src/lib/server/custom-domain-redirects.js.map +1 -0
- package/src/lib/server/host-custom-domain.d.ts +125 -0
- package/src/lib/server/host-custom-domain.js +395 -0
- package/src/lib/server/host-custom-domain.js.map +1 -0
- package/src/lib/server/host-memberships.d.ts +35 -2
- package/src/lib/server/host-memberships.js +63 -2
- package/src/lib/server/host-memberships.js.map +1 -1
- package/src/lib/server/host-released-names.d.ts +1 -2
- package/src/lib/server/host-released-names.js +4 -2
- package/src/lib/server/host-released-names.js.map +1 -1
- package/src/lib/server/media-photo-links.d.ts +196 -0
- package/src/lib/server/media-photo-links.js +290 -0
- package/src/lib/server/media-photo-links.js.map +1 -0
- package/src/lib/server/org-billing.d.ts +4 -2
- package/src/lib/server/org-billing.js +5 -0
- package/src/lib/server/org-billing.js.map +1 -1
- package/src/lib/server/organizations.d.ts +25 -1
- package/src/lib/server/organizations.js +62 -2
- package/src/lib/server/organizations.js.map +1 -1
- package/src/lib/server/personal-data-export.js +21 -1
- package/src/lib/server/personal-data-export.js.map +1 -1
- package/src/lib/server/push-delivery.js +32 -14
- package/src/lib/server/push-delivery.js.map +1 -1
- package/src/lib/server/site-care-emails.d.ts +52 -0
- package/src/lib/server/site-care-emails.js +97 -0
- package/src/lib/server/site-care-emails.js.map +1 -0
- package/src/lib/server/site-care-inbound.d.ts +80 -0
- package/src/lib/server/site-care-inbound.js +171 -0
- package/src/lib/server/site-care-inbound.js.map +1 -0
- package/src/lib/server/site-care-project-reconcile.d.ts +64 -0
- package/src/lib/server/site-care-project-reconcile.js +211 -0
- package/src/lib/server/site-care-project-reconcile.js.map +1 -0
- package/src/lib/server/site-care-project-stripe.d.ts +114 -0
- package/src/lib/server/site-care-project-stripe.js +305 -0
- package/src/lib/server/site-care-project-stripe.js.map +1 -0
- package/src/lib/server/site-care-projects.d.ts +169 -0
- package/src/lib/server/site-care-projects.js +882 -0
- package/src/lib/server/site-care-projects.js.map +1 -0
- package/src/lib/server/site-care-reconcile.d.ts +81 -0
- package/src/lib/server/site-care-reconcile.js +349 -0
- package/src/lib/server/site-care-reconcile.js.map +1 -0
- package/src/lib/server/site-care-requests.d.ts +243 -0
- package/src/lib/server/site-care-requests.js +1414 -0
- package/src/lib/server/site-care-requests.js.map +1 -0
- package/src/lib/server/site-care-stripe.d.ts +175 -0
- package/src/lib/server/site-care-stripe.js +375 -0
- package/src/lib/server/site-care-stripe.js.map +1 -0
- package/src/lib/server/tenant-dns-check.d.ts +58 -0
- package/src/lib/server/tenant-dns-check.js +197 -0
- package/src/lib/server/tenant-dns-check.js.map +1 -0
- package/src/lib/server/upgrade-proposal.d.ts +40 -1
- package/src/lib/server/upgrade-proposal.js +92 -50
- package/src/lib/server/upgrade-proposal.js.map +1 -1
- package/src/tenancy.d.ts +5 -0
- package/src/tenancy.js +10 -0
- package/src/tenancy.js.map +1 -1
|
@@ -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
|
|
268
|
-
*
|
|
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":";AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCC,GAED,SACEA,WAAW,EACXC,eAAe,EACfC,aAAa,QAGR,sBAAqB;AAC5B,SAASC,gBAAgB,QAAQ,qCAAoC;AACrE,SAASC,UAAU,QAAQ,2BAA0B;AACrD,OAAOC,mBAAmB,sBAAkB;AAE5C,MAAMC,YAAY,IAAMD,cAAcE,GAAG,GAAGD,SAAS;AAErD,uEAAuE,GACvE,MAAME,QAAQ;AAcd,MAAMC,aAAa,OACjBC,IACAC;;IAEA,MAAMC,MAAM,AAAC,CAAA,MAAMF,GAAGG,UAAU,CAAC,QAAQC,GAAG,CAACH,OAAOI,GAAG,EAAC,EAAGC,IAAI;IAG/D,OAAOC,OAAOC,IAAI,SAACN,uBAAAA,IAAKO,KAAK,mBAAI,CAAC;AACpC;AAEA,MAAMC,eAAe,OACnBV,IACAW;IAEA,IAAIA,QAAQC,MAAM,KAAK,GAAG,OAAO,IAAIC;IACrC,MAAMC,QAAQ,MAAMd,GAAGe,MAAM,IACxBJ,QAAQK,GAAG,CAAC,CAACC,KAAOjB,GAAGG,UAAU,CAAC,SAASC,GAAG,CAACa;IAEpD,OAAO,IAAIJ,IACTC,MAAME,GAAG,CAAC,CAACE;YAOEA;eAPO;YAClBA,KAAKD,EAAE;YACP;gBACEE,aAAaD,KAAKb,GAAG,CAAC;gBACtBe,WAAWF,KAAKb,GAAG,CAAC;gBACpB,qEAAqE;gBACrE,4CAA4C;gBAC5CgB,OAAO,GAAEH,YAAAA,KAAKb,GAAG,CAAC,2BAATa,UAAiBG,OAAO;gBACjCC,OAAOJ,KAAKb,GAAG,CAAC;gBAChBkB,WAAWL,KAAKb,GAAG,CAAC;gBACpBmB,QAAQN,KAAKM,MAAM;YACrB;SACD;;AAEL;AAEA,MAAMC,iBAAiB,OACrBzB,IACAC;IAEA,MAAMiB,OAAO,MAAMlB,GAChBG,UAAU,CAAC,QACXC,GAAG,CAACH,OACJE,UAAU,CAAC,WACXE,GAAG;IACN,OAAOa,KAAKQ,IAAI,CAACV,GAAG,CAAC,CAACW,IAAO;YAAEC,KAAKD,EAAEV,EAAE;WAAKU,EAAErB,IAAI;AACrD;AAEA,MAAMuB,gBAAgB,CACpB7B,IACA8B,KACAC,SACG/B,GAAGG,UAAU,CAAC,SAASC,GAAG,CAAC0B,KAAK3B,UAAU,CAAC,mBAAmBC,GAAG,CAAC2B;AAEvE,iFAAiF,GACjF,MAAMC,iBAAiB;AAEvB;;;;CAIC,GACD,MAAMC,YAAY,CAACC;IACjB,MAAMC,QAAQ;WAAID;KAAK;IACvB,MAAME,QAAQ;QAACF;KAAK;IACpB,IAAK,IAAIG,KAAK,GAAGA,KAAKF,MAAMvB,MAAM,EAAEyB,MAAM,EAAG;QAC3C,IAAIL,eAAeM,IAAI,CAACH,KAAK,CAACE,KAAK,EAAE,KAAK,CAACL,eAAeM,IAAI,CAACH,KAAK,CAACE,GAAG,GAAG;YACzED,MAAMG,IAAI,CAACJ,MAAMK,KAAK,CAACH,IAAII,IAAI,CAAC;QAClC;IACF;IACA,OAAOL;AACT;AAEA;;;;;;;;;;;;;;;;;;;CAmBC,GACD,OAAO,SAASM,2BACdC,IAAuE;IAEvE,MAAMC,QAAQ;QAACD,wBAAAA,KAAMxB,WAAW;QAAEwB,wBAAAA,KAAMvB,SAAS;QAAEuB,wBAAAA,KAAMrB,KAAK;KAAC,CAC5DN,GAAG,CAAC,CAAC6B,QAAUrD,cAAc,OAAOqD,UAAU,WAAWA,QAAQ,KACjEC,OAAO,CAAC,CAACC,MAASA,MAAMA,IAAIC,KAAK,CAAC,OAAO,EAAE,EAC3CF,OAAO,CAACb;IACX,OAAOxC,iBAAiBmD,MAAMH,IAAI,CAAC;AACrC;AAEA;;;;CAIC,GACD,OAAO,MAAMQ,kBAAkB,CAACN,OAC9B,QAAOA,wBAAAA,KAAMrB,KAAK,MAAK,YAAYqB,KAAKrB,KAAK,CAAC4B,IAAI,OAAO,GAAE;AAE7D;;;;;;;;;;;;CAYC,GACD,OAAO,MAAMC,mBAAmB,CAC9BR;;WACI;QACJS,WAAW5D,sBAAcmD,wBAAAA,KAAMxB,WAAW,mBAAI;QAC9CkC,cAAcX,2BAA2BC;QACzCM,iBAAiBA,gBAAgBN;IACnC;EAAE;AAEF,oEAAoE,GACpE,MAAMW,cAAc,CAACT,QACnB,QAAQA,yBAAD,AAACA,MAAqDU,QAAQ,MAAK;AAE5E;;;;CAIC,GACD,OAAO,MAAMC,gBAAgB,CAC3BvD,OACA0C,MACAc;;IAEA,MAAMtC,sBAAcwB,wBAAAA,KAAMxB,WAAW,mBAAI;IACzC,OAAO;QACLlB;OACI0C,CAAAA,wBAAAA,KAAMvB,SAAS,IAAG;QAAEA,WAAWuB,KAAKvB,SAAS;IAAC,IAAI,CAAC;QACvDD;QACAiC,WAAW5D,cAAc2B;QACzB,0EAA0E;QAC1E,sEAAsE;QACtEkC,cAAcX,2BAA2BC;QACzC,0EAA0E;QAC1E,2EAA2E;QAC3E,8CAA8C;QAC9CM,iBAAiBA,gBAAgBN;QACjC,uEAAuE;QACvE,wEAAwE;QACxE,yEAAyE;QACzE,eAAe;QACfrB,OAAO2B,gBAAgBN,QAAQe,OAAOf,wBAAAA,KAAMrB,KAAK,EAAE4B,IAAI,KAAKxD,WAAWiE,MAAM;QAC7E,wEAAwE;QACxE,0EAA0E;QAC1E,yEAAyE;QACzE,mDAAmD;QACnDpC,WAAW+B,YAAYX,wBAAAA,KAAMpB,SAAS,IAAIoB,wBAAAA,KAAMpB,SAAS,GAAG;QAC5D,yEAAyE;QACzE,sEAAsE;QACtE,yEAAyE;QACzE,uEAAuE;QACvE,sEAAsE;QACtEF,SAASsB,CAAAA,wBAAAA,KAAMtB,OAAO,IAAGsB,KAAKtB,OAAO,GAAG3B,WAAWiE,MAAM;QACzDF;QACAG,WAAWlE,WAAWmE,eAAe;;AAEzC,EAAC;AAED;;;;;;CAMC,GACD,OAAO,MAAMC,uBAA0C;IACrD;IACA;IACA;IACA;IACA;CACD,CAAA;AAED,yEAAyE,GACzE,OAAO,MAAMC,6BAA6B,CAACC,QACzCA,MAAMC,IAAI,CAAC,CAACC,OAASJ,qBAAqBK,QAAQ,CAACD,OAAM;AAE3D,oEAAoE,GACpE,OAAO,MAAME,wBAAwB,IAAG;AAExC;;;;;;;;;;;;;;CAcC,GACD,OAAO,SAASC,0BACdC,IAAgD;IAEhD,MAAMC,SAAkC,CAAC;IACzC,IAAID,QAAQ,iBAAiBA,MAAM;QACjC,MAAME,OAAO,OAAOF,IAAI,CAAC,cAAc,KAAK,WAAWA,IAAI,CAAC,cAAc,CAACpB,IAAI,KAAK;QACpF,IAAI,CAACsB,MAAM,OAAO;YAAEC,OAAO;QAAuB;QAClD,IAAID,KAAK5D,MAAM,GAAGwD,uBAAuB;YACvC,OAAO;gBAAEK,OAAO,CAAC,eAAe,EAAEL,sBAAsB,oBAAoB,CAAC;YAAC;QAChF;QACAG,MAAM,CAAC,cAAc,GAAGC;IAC1B;IACA,IAAIF,QAAQ,aAAaA,MAAM;QAC7B,MAAMjD,UAAUiD,IAAI,CAAC,UAAU;QAC/B,IAAI,OAAOjD,YAAY,YAAYA,QAAQT,MAAM,GAAG,MAAO;YACzD,OAAO;gBAAE6D,OAAO;YAAmD;QACrE;QACAF,MAAM,CAAC,cAAc,GAAGlD,QAAQ6B,IAAI;IACtC;IACA,OAAO;QAAEqB,QAAQhE,OAAOC,IAAI,CAAC+D,QAAQ3D,MAAM,GAAG2D,SAAS;IAAK;AAC9D;AAEA,4DAA4D,GAC5D,MAAMG,gBAAgB,OACpB1E,IACA2E;IAEA,IAAK,IAAIC,IAAI,GAAGA,IAAID,IAAI/D,MAAM,EAAEgE,KAAK9E,MAAO;QAC1C,MAAM+E,QAAQ7E,GAAG6E,KAAK;QACtB,KAAK,MAAMC,MAAMH,IAAInC,KAAK,CAACoC,GAAGA,IAAI9E,OAAQgF,GAAGD;QAC7C,MAAMA,MAAME,MAAM;IACpB;AACF;AAEA;;;;;;;;;;;;;;;CAeC,GACD,eAAeC,mBACbhF,EAA+B,EAC/BC,KAAa,EACb6B,GAAW,EACXmD,MAA6B;IAE7B,IAAI,CAACA,QAAQ;IACb,MAAMC,MAAMlF,GAAGG,UAAU,CAAC,SAASC,GAAG,CAAC0B,KAAK3B,UAAU,CAAC,QAAQC,GAAG,CAACH;IACnE,MAAMiB,OAAO,MAAMgE,IAAI7E,GAAG;IAC1B,IAAI,CAACa,KAAKM,MAAM,EAAE;IAClB,MAAM2D,UAAU5F,gBAAgB0F;IAChC,IAAI/D,KAAKb,GAAG,CAAC,eAAe8E,SAAS;IACrC,MAAMD,IAAIE,GAAG,CAAC;QAAED;IAAQ,GAAG;QAAEE,OAAO;IAAK;AAC3C;AAEA;;;;;CAKC,GACD,OAAO,eAAeC,0BACpBrF,KAAa,EACb6B,GAAW;IAEX,MAAM9B,KAAKJ;IACX,MAAM,CAAC2F,YAAY5E,QAAQ,GAAG,MAAM6E,QAAQC,GAAG,CAAC;QAC9CzF,GAAGG,UAAU,CAAC,QAAQC,GAAG,CAACH,OAAOE,UAAU,CAAC,WAAWC,GAAG,CAAC0B,KAAKzB,GAAG;QACnEN,WAAWC,IAAIC;KAChB;IACD,MAAMgF,SAASM,WAAW/D,MAAM,GAC3B;QAAEI,KAAKE;OAAQyD,WAAWjF,IAAI,MAC/B;IACJ,MAAM0E,mBAAmBhF,IAAIC,OAAO6B,KAAKmD;IACzC,MAAMtC,OAAO,MAAMjC,aAAaV,IAAIW;IACpC,MAAMgE,MAAMhE,QAAQK,GAAG,CAAC,CAACe,SAAW,CAAC8C;YACnC,MAAMpB,OAAOnE,YAAY2F,QAAQlD;YACjC,MAAMmD,MAAMrD,cAAc7B,IAAI8B,KAAKC;YACnC,IAAI0B,MAAMoB,MAAMO,GAAG,CAACF,KAAK1B,cAAcvD,OAAO0C,KAAKtC,GAAG,CAAC0B,SAAS0B,OAAO;gBAAE4B,OAAO;YAAK;iBAChFR,MAAMlB,MAAM,CAACuB;QACpB;IACA,MAAMR,cAAc1E,IAAI2E;AAC1B;AAEA;;;;CAIC,GACD,OAAO,eAAee,6BACpBzF,KAAa,EACb8B,MAAc;IAEd,MAAM/B,KAAKJ;IACX,MAAM,CAAC+F,SAAShD,KAAK,GAAG,MAAM6C,QAAQC,GAAG,CAAC;QACxChE,eAAezB,IAAIC;QACnBS,aAAaV,IAAI;YAAC+B;SAAO;KAC1B;IACD,MAAM6D,WAAWjD,KAAKtC,GAAG,CAAC0B;IAC1B,MAAM4C,MAAMgB,QAAQ3E,GAAG,CAAC,CAACiE,SAAW,CAACJ;YACnC,MAAMpB,OAAOnE,YAAY2F,QAAQlD;YACjC,MAAMmD,MAAMrD,cAAc7B,IAAIiF,OAAOrD,GAAG,EAAEG;YAC1C,IAAI0B,MAAMoB,MAAMO,GAAG,CAACF,KAAK1B,cAAcvD,OAAO2F,UAAUnC,OAAO;gBAAE4B,OAAO;YAAK;iBACxER,MAAMlB,MAAM,CAACuB;QACpB;IACA,MAAMR,cAAc1E,IAAI2E;IACxB,qEAAqE;IACrE,uEAAuE;IACvE,2EAA2E;IAC3E,8DAA8D;IAC9D,IAAIiB,4BAAAA,SAAUpE,MAAM,EAAE;QACpB,MAAMxB,GACHG,UAAU,CAAC,SACXC,GAAG,CAAC2B,QACJwC,MAAM,CAACpB,iBAAiByC,WACxBC,KAAK,CAAC,IAAMC;IACjB;AACF;AAEA,sFAAsF,GACtF,OAAO,eAAeC,4BACpB9F,KAAa,EACb6B,GAAW;IAEX,MAAM9B,KAAKJ;IACX,MAAMe,UAAU,MAAMZ,WAAWC,IAAIC;IACrC,MAAMyE,cACJ1E,IACAW,QAAQK,GAAG,CAAC,CAACe,SAAW,CAAC8C;YACvBA,MAAMlB,MAAM,CAAC9B,cAAc7B,IAAI8B,KAAKC;QACtC;AAEJ;AAEA,qEAAqE,GACrE,OAAO,eAAeiE,kCACpB/F,KAAa,EACb8B,MAAc,EACd;;;;GAIC,GACDkE,YAA+B,EAAE;IAEjC,MAAMjG,KAAKJ;IACX,MAAM+F,UAAU,MAAMlE,eAAezB,IAAIC;IACzC,MAAMiG,OAAO,IAAIC,IAAY;WACxBR,QAAQ3E,GAAG,CAAC,CAACiE,SAAWA,OAAOrD,GAAG;WAClCqE,UAAUG,MAAM,CAACC;KACrB;IACD,MAAMC,4BAA4BvE,QAAQ;WAAImE;KAAK;AACrD;AAEA,mEAAmE,GACnE,OAAO,eAAeI,4BACpBvE,MAAc,EACdmE,IAAuB;IAEvB,MAAMlG,KAAKJ;IACX,MAAM8E,cACJ1E,IACA;WAAI,IAAImG,IAAID,KAAKE,MAAM,CAACC;KAAU,CAACrF,GAAG,CACpC,CAACc,MAAQ,CAAC+C;YACRA,MAAMlB,MAAM,CAAC9B,cAAc7B,IAAI8B,KAAKC;QACtC;AAGN"}
|
|
@@ -16,7 +16,6 @@
|
|
|
16
16
|
*/
|
|
17
17
|
/**
|
|
18
18
|
* The names a deleted site stops answering on: its custom domain and its
|
|
19
|
-
* platform subdomain (AGL-3629)
|
|
20
|
-
* a plugin derives it from the domain the way the router does.
|
|
19
|
+
* platform subdomain (AGL-3629), and the `www.` twin when the site claimed one.
|
|
21
20
|
*/
|
|
22
21
|
export declare function releasedHostNames(host: Record<string, unknown> | null | undefined): string[];
|
|
@@ -16,13 +16,15 @@
|
|
|
16
16
|
*/ import { TENANT_APEX } from "@aglyn/aglyn/app-utils/tenant-apex";
|
|
17
17
|
/**
|
|
18
18
|
* The names a deleted site stops answering on: its custom domain and its
|
|
19
|
-
* platform subdomain (AGL-3629)
|
|
20
|
-
* a plugin derives it from the domain the way the router does.
|
|
19
|
+
* platform subdomain (AGL-3629), and the `www.` twin when the site claimed one.
|
|
21
20
|
*/ export function releasedHostNames(host) {
|
|
22
21
|
const clean = (value)=>typeof value === 'string' ? value.trim().toLowerCase().replace(/\.+$/, '') : '';
|
|
23
22
|
const names = [];
|
|
24
23
|
const cname = clean(host == null ? void 0 : host['cname']);
|
|
25
24
|
if (cname) names.push(cname);
|
|
25
|
+
// The twin this site claimed for its domain (AGL-3961), when it has one.
|
|
26
|
+
const twin = clean(host == null ? void 0 : host['cnameTwin']);
|
|
27
|
+
if (twin && cname) names.push(twin);
|
|
26
28
|
const subdomain = clean(host == null ? void 0 : host['subdomain']);
|
|
27
29
|
if (subdomain) names.push(`${subdomain}.${TENANT_APEX}`);
|
|
28
30
|
return names;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/host-released-names.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 { TENANT_APEX } from '@aglyn/aglyn/app-utils/tenant-apex'\n\n/**\n * The names a deleted site stops answering on: its custom domain and its\n * platform subdomain (AGL-3629)
|
|
1
|
+
{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/host-released-names.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 { TENANT_APEX } from '@aglyn/aglyn/app-utils/tenant-apex'\n\n/**\n * The names a deleted site stops answering on: its custom domain and its\n * platform subdomain (AGL-3629), and the `www.` twin when the site claimed one.\n */\nexport function releasedHostNames(\n host: Record<string, unknown> | null | undefined,\n): string[] {\n const clean = (value: unknown) =>\n typeof value === 'string' ? value.trim().toLowerCase().replace(/\\.+$/, '') : ''\n const names: string[] = []\n const cname = clean(host?.['cname'])\n if (cname) names.push(cname)\n // The twin this site claimed for its domain (AGL-3961), when it has one.\n const twin = clean(host?.['cnameTwin'])\n if (twin && cname) names.push(twin)\n const subdomain = clean(host?.['subdomain'])\n if (subdomain) names.push(`${subdomain}.${TENANT_APEX}`)\n return names\n}\n"],"names":["TENANT_APEX","releasedHostNames","host","clean","value","trim","toLowerCase","replace","names","cname","push","twin","subdomain"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,WAAW,QAAQ,qCAAoC;AAEhE;;;CAGC,GACD,OAAO,SAASC,kBACdC,IAAgD;IAEhD,MAAMC,QAAQ,CAACC,QACb,OAAOA,UAAU,WAAWA,MAAMC,IAAI,GAAGC,WAAW,GAAGC,OAAO,CAAC,QAAQ,MAAM;IAC/E,MAAMC,QAAkB,EAAE;IAC1B,MAAMC,QAAQN,MAAMD,wBAAAA,IAAM,CAAC,QAAQ;IACnC,IAAIO,OAAOD,MAAME,IAAI,CAACD;IACtB,yEAAyE;IACzE,MAAME,OAAOR,MAAMD,wBAAAA,IAAM,CAAC,YAAY;IACtC,IAAIS,QAAQF,OAAOD,MAAME,IAAI,CAACC;IAC9B,MAAMC,YAAYT,MAAMD,wBAAAA,IAAM,CAAC,YAAY;IAC3C,IAAIU,WAAWJ,MAAME,IAAI,CAAC,GAAGE,UAAU,CAAC,EAAEZ,aAAa;IACvD,OAAOQ;AACT"}
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2026 Aglyn LLC
|
|
4
|
+
*
|
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
6
|
+
* you may not use this file except in compliance with the License.
|
|
7
|
+
* You may obtain a copy of the License at
|
|
8
|
+
*
|
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
|
10
|
+
*
|
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
14
|
+
* See the License for the specific language governing permissions and
|
|
15
|
+
* limitations under the License.
|
|
16
|
+
*/
|
|
17
|
+
import { type loadSharp } from './media-variants';
|
|
18
|
+
/** The sharp factory `loadSharp` answers. */
|
|
19
|
+
type SharpFactory = Awaited<ReturnType<typeof loadSharp>>;
|
|
20
|
+
/**
|
|
21
|
+
* A SITE'S PHOTO LINK (AGL-3957): an address a site member hands to someone
|
|
22
|
+
* with photos on their phone — the owner of the business the site is being
|
|
23
|
+
* built for, at a booth or on a doorstep — so the photos land in the site's
|
|
24
|
+
* media library without a sign-in.
|
|
25
|
+
*
|
|
26
|
+
* The link is `{origin}/p/{linkId}#{secret}`, and the page composes the
|
|
27
|
+
* token `{linkId}.{secret}` from its path and its fragment. The secret rides
|
|
28
|
+
* in the FRAGMENT because a fragment never leaves the browser: no request
|
|
29
|
+
* line carries it, so no server or edge log, no analytics page view and no
|
|
30
|
+
* `Referer` header ever holds a working link. The page sends the token to
|
|
31
|
+
* the public route in a POST body. The database holds the SHA-256
|
|
32
|
+
* of the secret and never the secret, the same shape as an emailed
|
|
33
|
+
* confirmation link (`account-emails.ts`): a reader of the database cannot
|
|
34
|
+
* upload to anybody's site. A link lives seven days, takes a bounded number
|
|
35
|
+
* of photos and bytes, and can be revoked by any member who could have
|
|
36
|
+
* minted it. Every upload it takes is stored AS THE MEMBER WHO MINTED IT,
|
|
37
|
+
* through the media ingest's own door (`core.media-ingest`), so a member who
|
|
38
|
+
* lost the site, a locked site, a takedown and the storage band refuse the
|
|
39
|
+
* link's uploads exactly as they refuse that member's.
|
|
40
|
+
*
|
|
41
|
+
* Documents live in the top-level `photoLinks` collection, keyed by link id
|
|
42
|
+
* and carrying the site: a token alone names no site, and a top-level
|
|
43
|
+
* collection answers it in one read with no collection-group index. Only the
|
|
44
|
+
* Admin SDK reads or writes them.
|
|
45
|
+
*/
|
|
46
|
+
export declare const PHOTO_LINKS_COLLECTION = "photoLinks";
|
|
47
|
+
/** Where the console serves the page a link opens. */
|
|
48
|
+
export declare const PHOTO_LINK_PATH = "/p";
|
|
49
|
+
/** How long a link takes photos, from its minting. */
|
|
50
|
+
export declare const PHOTO_LINK_TTL_MS: number;
|
|
51
|
+
/** The most photos one link takes. */
|
|
52
|
+
export declare const PHOTO_LINK_MAX_UPLOADS = 40;
|
|
53
|
+
/** The most bytes one link takes, over all its photos, after they are stored. */
|
|
54
|
+
export declare const PHOTO_LINK_MAX_BYTES: number;
|
|
55
|
+
/** The folder the link's photos are filed in, created in the site's library when the first link is minted. */
|
|
56
|
+
export declare const PHOTO_LINK_FOLDER_NAME = "From the owner";
|
|
57
|
+
/**
|
|
58
|
+
* What the page accepts from the phone. The page re-encodes what it picks
|
|
59
|
+
* (a HEIC, a 12 MB camera original) into one of these before it sends it, so
|
|
60
|
+
* a format a browser cannot draw never reaches the server.
|
|
61
|
+
*/
|
|
62
|
+
export declare const PHOTO_LINK_TYPES: ReadonlySet<string>;
|
|
63
|
+
/** The most bytes one photo may arrive as, before it is stored. */
|
|
64
|
+
export declare const PHOTO_LINK_PHOTO_MAX_BYTES: number;
|
|
65
|
+
/** What one phone may ask of the link's page in a window, and how long the window is. */
|
|
66
|
+
export declare const PHOTO_LINK_RATE_LIMIT: Readonly<{
|
|
67
|
+
limit: 80;
|
|
68
|
+
windowMs: number;
|
|
69
|
+
}>;
|
|
70
|
+
export interface PhotoLinkDoc {
|
|
71
|
+
hostId: string;
|
|
72
|
+
/** The member the link's uploads are stored as. */
|
|
73
|
+
createdBy: string;
|
|
74
|
+
createdAt: number;
|
|
75
|
+
expiresAt: number;
|
|
76
|
+
revokedAt?: number;
|
|
77
|
+
revokedBy?: string;
|
|
78
|
+
/** SHA-256 of the secret half of the token, hex. */
|
|
79
|
+
digest: string;
|
|
80
|
+
/** The library folder the photos are filed in; null files them at the root. */
|
|
81
|
+
folderId: string | null;
|
|
82
|
+
/** Photos stored through the link, and their stored bytes. */
|
|
83
|
+
uploads: number;
|
|
84
|
+
bytes: number;
|
|
85
|
+
lastUploadAt?: number;
|
|
86
|
+
}
|
|
87
|
+
export type PhotoLinkState = 'live' | 'expired' | 'revoked' | 'full';
|
|
88
|
+
/** What a link's page and its minter see of it. */
|
|
89
|
+
export interface PhotoLinkSummary {
|
|
90
|
+
linkId: string;
|
|
91
|
+
state: PhotoLinkState;
|
|
92
|
+
createdAt: number;
|
|
93
|
+
expiresAt: number;
|
|
94
|
+
uploads: number;
|
|
95
|
+
bytes: number;
|
|
96
|
+
remainingUploads: number;
|
|
97
|
+
remainingBytes: number;
|
|
98
|
+
}
|
|
99
|
+
/** A fresh token: the id the document is keyed by, the secret the link carries, and the digest the document keeps. */
|
|
100
|
+
export declare function mintPhotoLinkToken(): {
|
|
101
|
+
linkId: string;
|
|
102
|
+
secret: string;
|
|
103
|
+
digest: string;
|
|
104
|
+
token: string;
|
|
105
|
+
};
|
|
106
|
+
export declare function photoLinkDigest(secret: string): string;
|
|
107
|
+
/** The two halves of a token as the page received it, or null for anything that is not shaped like one. */
|
|
108
|
+
export declare function parsePhotoLinkToken(raw: unknown): {
|
|
109
|
+
linkId: string;
|
|
110
|
+
secret: string;
|
|
111
|
+
} | null;
|
|
112
|
+
/** Constant-time: the stored digest against the secret the page presented. */
|
|
113
|
+
export declare function photoLinkSecretMatches(digest: unknown, secret: string): boolean;
|
|
114
|
+
/**
|
|
115
|
+
* The address the link opens, on the console origin given: the link id in
|
|
116
|
+
* the path, the secret in the fragment, which the browser never sends.
|
|
117
|
+
*/
|
|
118
|
+
export declare function photoLinkUrl(origin: string, linkId: string, secret: string): string;
|
|
119
|
+
export declare function photoLinkState(doc: Pick<PhotoLinkDoc, 'expiresAt' | 'revokedAt' | 'uploads' | 'bytes'>, now?: number): PhotoLinkState;
|
|
120
|
+
export declare function photoLinkSummary(linkId: string, doc: PhotoLinkDoc, now?: number): PhotoLinkSummary;
|
|
121
|
+
/** The stored document, read defensively: a field the writer never set reads as its zero. */
|
|
122
|
+
export declare function readPhotoLinkDoc(data: Record<string, unknown> | undefined): PhotoLinkDoc | null;
|
|
123
|
+
type Firestore = FirebaseFirestore.Firestore;
|
|
124
|
+
export declare function photoLinkRef(firestore: Firestore, linkId: string): FirebaseFirestore.DocumentReference;
|
|
125
|
+
/** Mints a link for the site as the member, and stores its document. The secret is returned once and never stored. */
|
|
126
|
+
export declare function createPhotoLink(firestore: Firestore, input: {
|
|
127
|
+
hostId: string;
|
|
128
|
+
uid: string;
|
|
129
|
+
folderId: string | null;
|
|
130
|
+
now?: number;
|
|
131
|
+
}): Promise<{
|
|
132
|
+
linkId: string;
|
|
133
|
+
secret: string;
|
|
134
|
+
token: string;
|
|
135
|
+
expiresAt: number;
|
|
136
|
+
}>;
|
|
137
|
+
export type PhotoLinkRefusal = 'invalid' | 'expired' | 'revoked' | 'full';
|
|
138
|
+
export type PhotoLinkLookup = {
|
|
139
|
+
ok: true;
|
|
140
|
+
linkId: string;
|
|
141
|
+
ref: FirebaseFirestore.DocumentReference;
|
|
142
|
+
doc: PhotoLinkDoc;
|
|
143
|
+
summary: PhotoLinkSummary;
|
|
144
|
+
} | {
|
|
145
|
+
ok: false;
|
|
146
|
+
reason: PhotoLinkRefusal;
|
|
147
|
+
};
|
|
148
|
+
/**
|
|
149
|
+
* The link a token names, when the token is well-formed, its document exists,
|
|
150
|
+
* its secret matches and the link still takes photos. Every other case is a
|
|
151
|
+
* refusal that says only what the page needs to tell the person holding the
|
|
152
|
+
* phone; an unknown id and a wrong secret read the same.
|
|
153
|
+
*/
|
|
154
|
+
export declare function readPhotoLinkByToken(firestore: Firestore, token: unknown, now?: number): Promise<PhotoLinkLookup>;
|
|
155
|
+
/**
|
|
156
|
+
* Claims one photo's place on the link before its bytes are stored, inside a
|
|
157
|
+
* transaction, so forty phones racing one link cannot store eighty photos.
|
|
158
|
+
* `releasePhotoLinkUpload` gives the place back when the store refused.
|
|
159
|
+
*/
|
|
160
|
+
export declare function claimPhotoLinkUpload(firestore: Firestore, ref: FirebaseFirestore.DocumentReference, bytes: number, now?: number): Promise<{
|
|
161
|
+
ok: true;
|
|
162
|
+
} | {
|
|
163
|
+
ok: false;
|
|
164
|
+
reason: PhotoLinkRefusal;
|
|
165
|
+
}>;
|
|
166
|
+
export declare function releasePhotoLinkUpload(firestore: Firestore, ref: FirebaseFirestore.DocumentReference, bytes: number): Promise<void>;
|
|
167
|
+
/** Marks the link revoked. Idempotent; a link of another site is left alone and reported as not found. */
|
|
168
|
+
export declare function revokePhotoLink(firestore: Firestore, input: {
|
|
169
|
+
hostId: string;
|
|
170
|
+
linkId: string;
|
|
171
|
+
uid: string;
|
|
172
|
+
now?: number;
|
|
173
|
+
}): Promise<boolean>;
|
|
174
|
+
/** The site's links that still take photos, newest first. */
|
|
175
|
+
export declare function listLivePhotoLinks(firestore: Firestore, hostId: string, now?: number): Promise<PhotoLinkSummary[]>;
|
|
176
|
+
/**
|
|
177
|
+
* The bytes a link's photo is stored as: oriented the way the phone held it,
|
|
178
|
+
* no wider than the delivery edge, and carrying no EXIF, XMP or IPTC — so a
|
|
179
|
+
* photo's GPS position, taken in somebody's driveway, never reaches the
|
|
180
|
+
* library. The display encoder already does exactly this for a delivery
|
|
181
|
+
* copy; here its answer IS the original. A photo that carries nothing and
|
|
182
|
+
* needs no turning is stored as it came.
|
|
183
|
+
*/
|
|
184
|
+
export declare function storedPhotoLinkBytes(sharp: SharpFactory, bytes: Buffer, contentType: string): Promise<{
|
|
185
|
+
bytes: Buffer;
|
|
186
|
+
contentType: string;
|
|
187
|
+
}>;
|
|
188
|
+
/**
|
|
189
|
+
* The address a request to the link's page is counted under: the first
|
|
190
|
+
* forwarded address, which is the client's at Vercel's edge, else the
|
|
191
|
+
* literal `unknown`, which shares one budget rather than none.
|
|
192
|
+
*/
|
|
193
|
+
export declare function photoLinkCallerAddress(headers: {
|
|
194
|
+
get(name: string): string | null;
|
|
195
|
+
}): string;
|
|
196
|
+
export {};
|