@aglyn/tenant-data-admin 1.0.0-beta.287 → 1.0.0-beta.289

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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aglyn/tenant-data-admin",
3
- "version": "1.0.0-beta.287",
3
+ "version": "1.0.0-beta.289",
4
4
  "license": "Apache-2.0",
5
5
  "homepage": "https://aglyn.com",
6
6
  "repository": {
@@ -25,12 +25,12 @@
25
25
  "./package.json": "./package.json"
26
26
  },
27
27
  "dependencies": {
28
- "@aglyn/aglyn": "1.0.0-beta.287",
29
- "@aglyn/shared-util-email": "1.0.0-beta.287",
30
- "@aglyn/shared-util-fbserver": "1.0.0-beta.287",
31
- "@aglyn/shared-util-first-touch": "1.0.0-beta.287",
32
- "@aglyn/shared-util-http": "1.0.0-beta.287",
33
- "@aglyn/shared-util-tools": "1.0.0-beta.287",
28
+ "@aglyn/aglyn": "1.0.0-beta.289",
29
+ "@aglyn/shared-util-email": "1.0.0-beta.289",
30
+ "@aglyn/shared-util-fbserver": "1.0.0-beta.289",
31
+ "@aglyn/shared-util-first-touch": "1.0.0-beta.289",
32
+ "@aglyn/shared-util-http": "1.0.0-beta.289",
33
+ "@aglyn/shared-util-tools": "1.0.0-beta.289",
34
34
  "@msgpack/msgpack": "^3.1.3",
35
35
  "@swc/helpers": "0.5.23",
36
36
  "sharp": "^0.35.5",
@@ -0,0 +1,42 @@
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
+ export type SitePreviewTokenKind = 'enter' | 'cookie';
18
+ export interface SitePreviewClaims {
19
+ hostId: string;
20
+ /** Expiry, epoch ms. */
21
+ exp: number;
22
+ }
23
+ export interface MintedSitePreviewToken {
24
+ token: string;
25
+ expiresAtMs: number;
26
+ }
27
+ /**
28
+ * Mints a token of the given kind for a site the caller has ALREADY decided
29
+ * the person may see. The mint checks nothing.
30
+ */
31
+ export declare function mintSitePreviewToken(kind: SitePreviewTokenKind, hostId: string, nowMs?: number): MintedSitePreviewToken;
32
+ /**
33
+ * Verifies a token AS the stated kind, FOR the stated site. `null` for
34
+ * anything else: expired, tampered, malformed, another version, another kind,
35
+ * another site, or a deploy with no signing secret (fail closed).
36
+ *
37
+ * An expiry further out than the kind allows is refused too, so a token
38
+ * minted under a longer TTL by an older build cannot outlive this one's.
39
+ */
40
+ export declare function verifySitePreviewToken(kind: SitePreviewTokenKind, token: unknown, hostId: string, nowMs?: number): SitePreviewClaims | null;
41
+ /** The value of one cookie in a `Cookie` header, or `undefined`. */
42
+ export declare function readCookieValue(cookieHeader: string | null | undefined, name: string): string | undefined;
@@ -0,0 +1,123 @@
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
+ */ import { createHmac } from "crypto";
17
+ import { SITE_PREVIEW_COOKIE_TTL_MS, SITE_PREVIEW_ENTER_TTL_MS } from "@aglyn/aglyn/app-utils/site-preview";
18
+ import { tokenSigningSecret } from "./media-signing.js";
19
+ import { safeEqual } from "./safe-equal.js";
20
+ /**
21
+ * A capability to see ONE site that is in preview (AGL-4086).
22
+ *
23
+ * On `*.aglyn.app` the site knows a console user by the `aglyn_edit_hint`
24
+ * cookie the sign-in bounce plants on the tenant apex. A CUSTOM domain is
25
+ * cross-site with every console cookie, so there the console mints an enter
26
+ * link instead: `https://{domain}/api/site-preview/enter?blob=…`. The tenant
27
+ * verifies the blob, plants an HttpOnly cookie on that host alone, and every
28
+ * request after that is verified again before the site renders.
29
+ *
30
+ * ## Two kinds, deliberately non-interchangeable
31
+ *
32
+ * - `enter` rides the URL once. URLs are logged and shared, so it lives
33
+ * {@link SITE_PREVIEW_ENTER_TTL_MS} — long enough for one click.
34
+ * - `cookie` is the planted value, living {@link SITE_PREVIEW_COOKIE_TTL_MS}.
35
+ *
36
+ * The kind is inside the signed context, so a leaked enter URL can never be
37
+ * replayed as a 12-hour cookie, and a stolen cookie value cannot be pasted
38
+ * into an enter link to plant itself on a second browser.
39
+ *
40
+ * ## What the signature is over
41
+ *
42
+ * `site-preview:{kind}:{payload}`, where the payload carries the `hostId` and
43
+ * `exp`. The tenant compares the `hostId` with the site the REQUEST resolved
44
+ * to, never with anything the URL says, so a token for one site opens no
45
+ * other. The `site-preview:` prefix separates it from the media, edit-hint
46
+ * and collection-preview signatures that share `TOKEN_SIGNING_SECRET`.
47
+ *
48
+ * ## What it is not
49
+ *
50
+ * It names a site and a time, not a person, and buys nothing but "render this
51
+ * site as its team sees it". The person was checked when the console minted
52
+ * the enter link (`siteViewRefusal`), and the 12 hours bound how long that
53
+ * check is trusted.
54
+ */ /** Version tag, mirroring the edit-hint token's. */ const TOKEN_PREFIX = 'aglyn-site-preview-v1';
55
+ function signPayload(kind, payloadB64) {
56
+ return createHmac('sha256', tokenSigningSecret()).update(`site-preview:${kind}:${payloadB64}`).digest('base64url');
57
+ }
58
+ function ttlOf(kind) {
59
+ return kind === 'enter' ? SITE_PREVIEW_ENTER_TTL_MS : SITE_PREVIEW_COOKIE_TTL_MS;
60
+ }
61
+ /**
62
+ * Mints a token of the given kind for a site the caller has ALREADY decided
63
+ * the person may see. The mint checks nothing.
64
+ */ export function mintSitePreviewToken(kind, hostId, nowMs = Date.now()) {
65
+ if (!hostId) throw new Error('hostId is required');
66
+ const exp = nowMs + ttlOf(kind);
67
+ const claims = {
68
+ hostId,
69
+ exp
70
+ };
71
+ const payload = Buffer.from(JSON.stringify(claims), 'utf8').toString('base64url');
72
+ return {
73
+ token: `${TOKEN_PREFIX}.${payload}.${signPayload(kind, payload)}`,
74
+ expiresAtMs: exp
75
+ };
76
+ }
77
+ /**
78
+ * Verifies a token AS the stated kind, FOR the stated site. `null` for
79
+ * anything else: expired, tampered, malformed, another version, another kind,
80
+ * another site, or a deploy with no signing secret (fail closed).
81
+ *
82
+ * An expiry further out than the kind allows is refused too, so a token
83
+ * minted under a longer TTL by an older build cannot outlive this one's.
84
+ */ export function verifySitePreviewToken(kind, token, hostId, nowMs = Date.now()) {
85
+ if (!hostId) return null;
86
+ if (typeof token !== 'string' || token.length === 0 || token.length > 2048) {
87
+ return null;
88
+ }
89
+ const parts = token.split('.');
90
+ if (parts.length !== 3 || parts[0] !== TOKEN_PREFIX) return null;
91
+ const [, payload, sig] = parts;
92
+ let expected;
93
+ try {
94
+ expected = signPayload(kind, payload);
95
+ } catch (unused) {
96
+ return null;
97
+ }
98
+ if (!safeEqual(sig, expected)) return null;
99
+ let claims;
100
+ try {
101
+ claims = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'));
102
+ } catch (unused) {
103
+ return null;
104
+ }
105
+ const exp = Number(claims == null ? void 0 : claims.exp);
106
+ if (!Number.isFinite(exp) || exp <= nowMs) return null;
107
+ if (exp - nowMs > ttlOf(kind)) return null;
108
+ if (typeof claims.hostId !== 'string' || claims.hostId !== hostId) return null;
109
+ return {
110
+ hostId: claims.hostId,
111
+ exp
112
+ };
113
+ }
114
+ /** The value of one cookie in a `Cookie` header, or `undefined`. */ export function readCookieValue(cookieHeader, name) {
115
+ if (!cookieHeader) return undefined;
116
+ for (const part of cookieHeader.split(';')){
117
+ const trimmed = part.trim();
118
+ if (trimmed.startsWith(`${name}=`)) return trimmed.slice(name.length + 1);
119
+ }
120
+ return undefined;
121
+ }
122
+
123
+ //# sourceMappingURL=site-preview-token.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/site-preview-token.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 { createHmac } from 'crypto'\nimport {\n SITE_PREVIEW_COOKIE_TTL_MS,\n SITE_PREVIEW_ENTER_TTL_MS,\n} from '@aglyn/aglyn/app-utils/site-preview'\nimport { tokenSigningSecret } from './media-signing'\nimport { safeEqual } from './safe-equal'\n\n/**\n * A capability to see ONE site that is in preview (AGL-4086).\n *\n * On `*.aglyn.app` the site knows a console user by the `aglyn_edit_hint`\n * cookie the sign-in bounce plants on the tenant apex. A CUSTOM domain is\n * cross-site with every console cookie, so there the console mints an enter\n * link instead: `https://{domain}/api/site-preview/enter?blob=…`. The tenant\n * verifies the blob, plants an HttpOnly cookie on that host alone, and every\n * request after that is verified again before the site renders.\n *\n * ## Two kinds, deliberately non-interchangeable\n *\n * - `enter` rides the URL once. URLs are logged and shared, so it lives\n * {@link SITE_PREVIEW_ENTER_TTL_MS} — long enough for one click.\n * - `cookie` is the planted value, living {@link SITE_PREVIEW_COOKIE_TTL_MS}.\n *\n * The kind is inside the signed context, so a leaked enter URL can never be\n * replayed as a 12-hour cookie, and a stolen cookie value cannot be pasted\n * into an enter link to plant itself on a second browser.\n *\n * ## What the signature is over\n *\n * `site-preview:{kind}:{payload}`, where the payload carries the `hostId` and\n * `exp`. The tenant compares the `hostId` with the site the REQUEST resolved\n * to, never with anything the URL says, so a token for one site opens no\n * other. The `site-preview:` prefix separates it from the media, edit-hint\n * and collection-preview signatures that share `TOKEN_SIGNING_SECRET`.\n *\n * ## What it is not\n *\n * It names a site and a time, not a person, and buys nothing but \"render this\n * site as its team sees it\". The person was checked when the console minted\n * the enter link (`siteViewRefusal`), and the 12 hours bound how long that\n * check is trusted.\n */\n\n/** Version tag, mirroring the edit-hint token's. */\nconst TOKEN_PREFIX = 'aglyn-site-preview-v1'\n\nexport type SitePreviewTokenKind = 'enter' | 'cookie'\n\nexport interface SitePreviewClaims {\n hostId: string\n /** Expiry, epoch ms. */\n exp: number\n}\n\nexport interface MintedSitePreviewToken {\n token: string\n expiresAtMs: number\n}\n\nfunction signPayload(kind: SitePreviewTokenKind, payloadB64: string): string {\n return createHmac('sha256', tokenSigningSecret())\n .update(`site-preview:${kind}:${payloadB64}`)\n .digest('base64url')\n}\n\nfunction ttlOf(kind: SitePreviewTokenKind): number {\n return kind === 'enter' ? SITE_PREVIEW_ENTER_TTL_MS : SITE_PREVIEW_COOKIE_TTL_MS\n}\n\n/**\n * Mints a token of the given kind for a site the caller has ALREADY decided\n * the person may see. The mint checks nothing.\n */\nexport function mintSitePreviewToken(\n kind: SitePreviewTokenKind,\n hostId: string,\n nowMs: number = Date.now(),\n): MintedSitePreviewToken {\n if (!hostId) throw new Error('hostId is required')\n const exp = nowMs + ttlOf(kind)\n const claims: SitePreviewClaims = { hostId, exp }\n const payload = Buffer.from(JSON.stringify(claims), 'utf8').toString(\n 'base64url',\n )\n return {\n token: `${TOKEN_PREFIX}.${payload}.${signPayload(kind, payload)}`,\n expiresAtMs: exp,\n }\n}\n\n/**\n * Verifies a token AS the stated kind, FOR the stated site. `null` for\n * anything else: expired, tampered, malformed, another version, another kind,\n * another site, or a deploy with no signing secret (fail closed).\n *\n * An expiry further out than the kind allows is refused too, so a token\n * minted under a longer TTL by an older build cannot outlive this one's.\n */\nexport function verifySitePreviewToken(\n kind: SitePreviewTokenKind,\n token: unknown,\n hostId: string,\n nowMs: number = Date.now(),\n): SitePreviewClaims | null {\n if (!hostId) return null\n if (typeof token !== 'string' || token.length === 0 || token.length > 2048) {\n return null\n }\n const parts = token.split('.')\n if (parts.length !== 3 || parts[0] !== TOKEN_PREFIX) return null\n const [, payload, sig] = parts\n let expected: string\n try {\n expected = signPayload(kind, payload)\n } catch {\n return null\n }\n if (!safeEqual(sig, expected)) return null\n let claims: SitePreviewClaims\n try {\n claims = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'))\n } catch {\n return null\n }\n const exp = Number(claims?.exp)\n if (!Number.isFinite(exp) || exp <= nowMs) return null\n if (exp - nowMs > ttlOf(kind)) return null\n if (typeof claims.hostId !== 'string' || claims.hostId !== hostId) return null\n return { hostId: claims.hostId, exp }\n}\n\n/** The value of one cookie in a `Cookie` header, or `undefined`. */\nexport function readCookieValue(\n cookieHeader: string | null | undefined,\n name: string,\n): string | undefined {\n if (!cookieHeader) return undefined\n for (const part of cookieHeader.split(';')) {\n const trimmed = part.trim()\n if (trimmed.startsWith(`${name}=`)) return trimmed.slice(name.length + 1)\n }\n return undefined\n}\n"],"names":["createHmac","SITE_PREVIEW_COOKIE_TTL_MS","SITE_PREVIEW_ENTER_TTL_MS","tokenSigningSecret","safeEqual","TOKEN_PREFIX","signPayload","kind","payloadB64","update","digest","ttlOf","mintSitePreviewToken","hostId","nowMs","Date","now","Error","exp","claims","payload","Buffer","from","JSON","stringify","toString","token","expiresAtMs","verifySitePreviewToken","length","parts","split","sig","expected","parse","Number","isFinite","readCookieValue","cookieHeader","name","undefined","part","trimmed","trim","startsWith","slice"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,UAAU,QAAQ,SAAQ;AACnC,SACEC,0BAA0B,EAC1BC,yBAAyB,QACpB,sCAAqC;AAC5C,SAASC,kBAAkB,QAAQ,qBAAiB;AACpD,SAASC,SAAS,QAAQ,kBAAc;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCC,GAED,kDAAkD,GAClD,MAAMC,eAAe;AAerB,SAASC,YAAYC,IAA0B,EAAEC,UAAkB;IACjE,OAAOR,WAAW,UAAUG,sBACzBM,MAAM,CAAC,CAAC,aAAa,EAAEF,KAAK,CAAC,EAAEC,YAAY,EAC3CE,MAAM,CAAC;AACZ;AAEA,SAASC,MAAMJ,IAA0B;IACvC,OAAOA,SAAS,UAAUL,4BAA4BD;AACxD;AAEA;;;CAGC,GACD,OAAO,SAASW,qBACdL,IAA0B,EAC1BM,MAAc,EACdC,QAAgBC,KAAKC,GAAG,EAAE;IAE1B,IAAI,CAACH,QAAQ,MAAM,IAAII,MAAM;IAC7B,MAAMC,MAAMJ,QAAQH,MAAMJ;IAC1B,MAAMY,SAA4B;QAAEN;QAAQK;IAAI;IAChD,MAAME,UAAUC,OAAOC,IAAI,CAACC,KAAKC,SAAS,CAACL,SAAS,QAAQM,QAAQ,CAClE;IAEF,OAAO;QACLC,OAAO,GAAGrB,aAAa,CAAC,EAAEe,QAAQ,CAAC,EAAEd,YAAYC,MAAMa,UAAU;QACjEO,aAAaT;IACf;AACF;AAEA;;;;;;;CAOC,GACD,OAAO,SAASU,uBACdrB,IAA0B,EAC1BmB,KAAc,EACdb,MAAc,EACdC,QAAgBC,KAAKC,GAAG,EAAE;IAE1B,IAAI,CAACH,QAAQ,OAAO;IACpB,IAAI,OAAOa,UAAU,YAAYA,MAAMG,MAAM,KAAK,KAAKH,MAAMG,MAAM,GAAG,MAAM;QAC1E,OAAO;IACT;IACA,MAAMC,QAAQJ,MAAMK,KAAK,CAAC;IAC1B,IAAID,MAAMD,MAAM,KAAK,KAAKC,KAAK,CAAC,EAAE,KAAKzB,cAAc,OAAO;IAC5D,MAAM,GAAGe,SAASY,IAAI,GAAGF;IACzB,IAAIG;IACJ,IAAI;QACFA,WAAW3B,YAAYC,MAAMa;IAC/B,EAAE,eAAM;QACN,OAAO;IACT;IACA,IAAI,CAAChB,UAAU4B,KAAKC,WAAW,OAAO;IACtC,IAAId;IACJ,IAAI;QACFA,SAASI,KAAKW,KAAK,CAACb,OAAOC,IAAI,CAACF,SAAS,aAAaK,QAAQ,CAAC;IACjE,EAAE,eAAM;QACN,OAAO;IACT;IACA,MAAMP,MAAMiB,OAAOhB,0BAAAA,OAAQD,GAAG;IAC9B,IAAI,CAACiB,OAAOC,QAAQ,CAAClB,QAAQA,OAAOJ,OAAO,OAAO;IAClD,IAAII,MAAMJ,QAAQH,MAAMJ,OAAO,OAAO;IACtC,IAAI,OAAOY,OAAON,MAAM,KAAK,YAAYM,OAAON,MAAM,KAAKA,QAAQ,OAAO;IAC1E,OAAO;QAAEA,QAAQM,OAAON,MAAM;QAAEK;IAAI;AACtC;AAEA,kEAAkE,GAClE,OAAO,SAASmB,gBACdC,YAAuC,EACvCC,IAAY;IAEZ,IAAI,CAACD,cAAc,OAAOE;IAC1B,KAAK,MAAMC,QAAQH,aAAaP,KAAK,CAAC,KAAM;QAC1C,MAAMW,UAAUD,KAAKE,IAAI;QACzB,IAAID,QAAQE,UAAU,CAAC,GAAGL,KAAK,CAAC,CAAC,GAAG,OAAOG,QAAQG,KAAK,CAACN,KAAKV,MAAM,GAAG;IACzE;IACA,OAAOW;AACT"}
@@ -0,0 +1,88 @@
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 { DocumentSnapshot, Firestore } from 'firebase-admin/firestore';
18
+ import { findUserByUidAcrossPools } from './auth-pools';
19
+ /**
20
+ * Who may see a site, or a page, that is in preview (AGL-4086).
21
+ *
22
+ * The site's TEAM: anyone the console lets open the site. That is the same
23
+ * question the host document's read rule answers — a role on this site in its
24
+ * `memberRoles` — widened by the roster for the two members that projection
25
+ * can miss: a workspace owner or admin, and a member who holds every site of
26
+ * the workspace. A collaborator scoped to OTHER sites of the workspace is not
27
+ * this site's team, and does not see it.
28
+ *
29
+ * And Aglyn STAFF, by the `staff` custom claim on the account. That claim is
30
+ * set only through the Admin SDK, so nothing a client can write reaches it.
31
+ *
32
+ * NOT the site's own member accounts — the visitors who signed up on the
33
+ * site. They are an audience, not the team, and they are in another account
34
+ * pool besides.
35
+ *
36
+ * Read intent, not write: seeing a site is not editing it, so a role that can
37
+ * only view the site in the console sees its preview too. Lockdown is not
38
+ * asked here because it outranks preview where it is enforced — the
39
+ * middleware's verdict and the loader's lockdown branch both run first, for
40
+ * the team as for everyone.
41
+ */
42
+ export type SiteViewRefusal = 'not-team';
43
+ /**
44
+ * `null` when `uid` may see this site in preview, or why not. The caller has
45
+ * already proved WHO the uid is (a verified ID token at the console, a signed
46
+ * hint at the tenant) and whether the account is staff.
47
+ */
48
+ export declare function siteViewRefusal(options: {
49
+ firestore: Firestore;
50
+ /** The `hosts/{hostId}` snapshot, already confirmed to exist. */
51
+ host: DocumentSnapshot;
52
+ uid: string;
53
+ /** From verified claims or the auth record; never from a request body. */
54
+ staff?: boolean;
55
+ }): Promise<SiteViewRefusal | null>;
56
+ /** How a team member was recognized on the site, or that they were not. */
57
+ export interface SitePreviewViewer {
58
+ admitted: boolean;
59
+ via: 'cookie' | 'hint' | null;
60
+ }
61
+ export interface SitePreviewViewerDeps {
62
+ findUser?: typeof findUserByUidAcrossPools;
63
+ nowMs?: number;
64
+ }
65
+ /**
66
+ * Is the person behind this request the site's team? (AGL-4086)
67
+ *
68
+ * The middleware routed the request here because one of two cookies was
69
+ * PRESENT; this is where either is believed or not.
70
+ *
71
+ * 1. `aglyn_site_preview` — planted by a console-minted enter link on this
72
+ * host alone. A signed token bound to the site; verified against the site
73
+ * the request resolved to.
74
+ * 2. `aglyn_edit_hint` — the console sign-in's hint on the tenant apex. It
75
+ * names a uid and nothing more, so the account is looked up (it must exist
76
+ * and be enabled, which is how a sign-out the cookie cannot hear about
77
+ * still ends it) and then asked {@link siteViewRefusal}, with the staff
78
+ * claim read off the account record.
79
+ *
80
+ * Anything else — no cookie, a forged or expired one, one for another site, a
81
+ * uid with no role here — is refused, and the caller renders what the public
82
+ * gets. Never throws: a lookup that fails is a refusal.
83
+ */
84
+ export declare function verifySitePreviewViewer(options: {
85
+ firestore: Firestore;
86
+ hostId: string;
87
+ cookieHeader: string | null | undefined;
88
+ }, deps?: SitePreviewViewerDeps): Promise<SitePreviewViewer>;
@@ -0,0 +1,103 @@
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
+ */ import { hostRoleFor, isOrgWideMember } from "@aglyn/aglyn/server";
17
+ import { SITE_PREVIEW_COOKIE, SITE_PREVIEW_EDIT_HINT_COOKIE } from "@aglyn/aglyn/app-utils/site-preview";
18
+ import { findUserByUidAcrossPools } from "./auth-pools.js";
19
+ import { verifyEditHintToken } from "./edit-hint-token.js";
20
+ import { readCookieValue, verifySitePreviewToken } from "./site-preview-token.js";
21
+ import { claimsHoldStaff } from "./staff-seat.js";
22
+ /**
23
+ * `null` when `uid` may see this site in preview, or why not. The caller has
24
+ * already proved WHO the uid is (a verified ID token at the console, a signed
25
+ * hint at the tenant) and whether the account is staff.
26
+ */ export async function siteViewRefusal(options) {
27
+ var _host_get, _membership_data;
28
+ const { firestore, host, uid, staff = false } = options;
29
+ if (staff) return null;
30
+ if (!uid) return 'not-team';
31
+ const memberRoles = (_host_get = host.get('memberRoles')) != null ? _host_get : {};
32
+ if (memberRoles && memberRoles[uid] != null) return null;
33
+ const orgId = host.get('orgId');
34
+ if (!orgId) return 'not-team';
35
+ const membership = await firestore.collection('orgs').doc(orgId).collection('members').doc(uid).get();
36
+ if (!membership.exists) return 'not-team';
37
+ const member = (_membership_data = membership.data()) != null ? _membership_data : {};
38
+ if (isOrgWideMember(member) || hostRoleFor(member, host.id) !== null) {
39
+ return null;
40
+ }
41
+ return 'not-team';
42
+ }
43
+ const REFUSED = {
44
+ admitted: false,
45
+ via: null
46
+ };
47
+ /**
48
+ * Is the person behind this request the site's team? (AGL-4086)
49
+ *
50
+ * The middleware routed the request here because one of two cookies was
51
+ * PRESENT; this is where either is believed or not.
52
+ *
53
+ * 1. `aglyn_site_preview` — planted by a console-minted enter link on this
54
+ * host alone. A signed token bound to the site; verified against the site
55
+ * the request resolved to.
56
+ * 2. `aglyn_edit_hint` — the console sign-in's hint on the tenant apex. It
57
+ * names a uid and nothing more, so the account is looked up (it must exist
58
+ * and be enabled, which is how a sign-out the cookie cannot hear about
59
+ * still ends it) and then asked {@link siteViewRefusal}, with the staff
60
+ * claim read off the account record.
61
+ *
62
+ * Anything else — no cookie, a forged or expired one, one for another site, a
63
+ * uid with no role here — is refused, and the caller renders what the public
64
+ * gets. Never throws: a lookup that fails is a refusal.
65
+ */ export async function verifySitePreviewViewer(options, deps = {}) {
66
+ var _deps_nowMs;
67
+ const { firestore, hostId, cookieHeader } = options;
68
+ if (!hostId) return REFUSED;
69
+ const nowMs = (_deps_nowMs = deps.nowMs) != null ? _deps_nowMs : Date.now();
70
+ const previewCookie = readCookieValue(cookieHeader, SITE_PREVIEW_COOKIE);
71
+ if (previewCookie && verifySitePreviewToken('cookie', previewCookie, hostId, nowMs)) {
72
+ return {
73
+ admitted: true,
74
+ via: 'cookie'
75
+ };
76
+ }
77
+ const hint = readCookieValue(cookieHeader, SITE_PREVIEW_EDIT_HINT_COOKIE);
78
+ const claims = hint ? verifyEditHintToken('cookie', hint, nowMs) : null;
79
+ if (!claims) return REFUSED;
80
+ try {
81
+ var _deps_findUser;
82
+ const findUser = (_deps_findUser = deps.findUser) != null ? _deps_findUser : findUserByUidAcrossPools;
83
+ const found = await findUser(claims.uid);
84
+ if (!found || found.record.disabled) return REFUSED;
85
+ const host = await firestore.collection('hosts').doc(hostId).get();
86
+ if (!host.exists) return REFUSED;
87
+ const refusal = await siteViewRefusal({
88
+ firestore,
89
+ host,
90
+ uid: claims.uid,
91
+ staff: claimsHoldStaff(found.record)
92
+ });
93
+ return refusal ? REFUSED : {
94
+ admitted: true,
95
+ via: 'hint'
96
+ };
97
+ } catch (error) {
98
+ console.error('[site-preview] viewer check failed', error);
99
+ return REFUSED;
100
+ }
101
+ }
102
+
103
+ //# sourceMappingURL=site-view-authz.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/site-view-authz.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 type AglynOrgMember,\n hostRoleFor,\n isOrgWideMember,\n} from '@aglyn/aglyn/server'\nimport {\n SITE_PREVIEW_COOKIE,\n SITE_PREVIEW_EDIT_HINT_COOKIE,\n} from '@aglyn/aglyn/app-utils/site-preview'\nimport type { DocumentSnapshot, Firestore } from 'firebase-admin/firestore'\nimport { findUserByUidAcrossPools } from './auth-pools'\nimport { verifyEditHintToken } from './edit-hint-token'\nimport { readCookieValue, verifySitePreviewToken } from './site-preview-token'\nimport { claimsHoldStaff } from './staff-seat'\n\n/**\n * Who may see a site, or a page, that is in preview (AGL-4086).\n *\n * The site's TEAM: anyone the console lets open the site. That is the same\n * question the host document's read rule answers — a role on this site in its\n * `memberRoles` — widened by the roster for the two members that projection\n * can miss: a workspace owner or admin, and a member who holds every site of\n * the workspace. A collaborator scoped to OTHER sites of the workspace is not\n * this site's team, and does not see it.\n *\n * And Aglyn STAFF, by the `staff` custom claim on the account. That claim is\n * set only through the Admin SDK, so nothing a client can write reaches it.\n *\n * NOT the site's own member accounts — the visitors who signed up on the\n * site. They are an audience, not the team, and they are in another account\n * pool besides.\n *\n * Read intent, not write: seeing a site is not editing it, so a role that can\n * only view the site in the console sees its preview too. Lockdown is not\n * asked here because it outranks preview where it is enforced — the\n * middleware's verdict and the loader's lockdown branch both run first, for\n * the team as for everyone.\n */\n\nexport type SiteViewRefusal = 'not-team'\n\n/**\n * `null` when `uid` may see this site in preview, or why not. The caller has\n * already proved WHO the uid is (a verified ID token at the console, a signed\n * hint at the tenant) and whether the account is staff.\n */\nexport async function siteViewRefusal(options: {\n firestore: Firestore\n /** The `hosts/{hostId}` snapshot, already confirmed to exist. */\n host: DocumentSnapshot\n uid: string\n /** From verified claims or the auth record; never from a request body. */\n staff?: boolean\n}): Promise<SiteViewRefusal | null> {\n const { firestore, host, uid, staff = false } = options\n if (staff) return null\n if (!uid) return 'not-team'\n const memberRoles = (host.get('memberRoles') ?? {}) as Record<string, unknown>\n if (memberRoles && memberRoles[uid] != null) return null\n const orgId = host.get('orgId') as string | undefined\n if (!orgId) return 'not-team'\n const membership = await firestore\n .collection('orgs')\n .doc(orgId)\n .collection('members')\n .doc(uid)\n .get()\n if (!membership.exists) return 'not-team'\n const member = (membership.data() ?? {}) as Partial<AglynOrgMember>\n if (isOrgWideMember(member) || hostRoleFor(member, host.id) !== null) {\n return null\n }\n return 'not-team'\n}\n\n/** How a team member was recognized on the site, or that they were not. */\nexport interface SitePreviewViewer {\n admitted: boolean\n via: 'cookie' | 'hint' | null\n}\n\nexport interface SitePreviewViewerDeps {\n findUser?: typeof findUserByUidAcrossPools\n nowMs?: number\n}\n\nconst REFUSED: SitePreviewViewer = { admitted: false, via: null }\n\n/**\n * Is the person behind this request the site's team? (AGL-4086)\n *\n * The middleware routed the request here because one of two cookies was\n * PRESENT; this is where either is believed or not.\n *\n * 1. `aglyn_site_preview` — planted by a console-minted enter link on this\n * host alone. A signed token bound to the site; verified against the site\n * the request resolved to.\n * 2. `aglyn_edit_hint` — the console sign-in's hint on the tenant apex. It\n * names a uid and nothing more, so the account is looked up (it must exist\n * and be enabled, which is how a sign-out the cookie cannot hear about\n * still ends it) and then asked {@link siteViewRefusal}, with the staff\n * claim read off the account record.\n *\n * Anything else — no cookie, a forged or expired one, one for another site, a\n * uid with no role here — is refused, and the caller renders what the public\n * gets. Never throws: a lookup that fails is a refusal.\n */\nexport async function verifySitePreviewViewer(\n options: {\n firestore: Firestore\n hostId: string\n cookieHeader: string | null | undefined\n },\n deps: SitePreviewViewerDeps = {},\n): Promise<SitePreviewViewer> {\n const { firestore, hostId, cookieHeader } = options\n if (!hostId) return REFUSED\n const nowMs = deps.nowMs ?? Date.now()\n\n const previewCookie = readCookieValue(cookieHeader, SITE_PREVIEW_COOKIE)\n if (\n previewCookie &&\n verifySitePreviewToken('cookie', previewCookie, hostId, nowMs)\n ) {\n return { admitted: true, via: 'cookie' }\n }\n\n const hint = readCookieValue(cookieHeader, SITE_PREVIEW_EDIT_HINT_COOKIE)\n const claims = hint ? verifyEditHintToken('cookie', hint, nowMs) : null\n if (!claims) return REFUSED\n try {\n const findUser = deps.findUser ?? findUserByUidAcrossPools\n const found = await findUser(claims.uid)\n if (!found || found.record.disabled) return REFUSED\n const host = await firestore.collection('hosts').doc(hostId).get()\n if (!host.exists) return REFUSED\n const refusal = await siteViewRefusal({\n firestore,\n host,\n uid: claims.uid,\n staff: claimsHoldStaff(found.record),\n })\n return refusal ? REFUSED : { admitted: true, via: 'hint' }\n } catch (error) {\n console.error('[site-preview] viewer check failed', error)\n return REFUSED\n }\n}\n"],"names":["hostRoleFor","isOrgWideMember","SITE_PREVIEW_COOKIE","SITE_PREVIEW_EDIT_HINT_COOKIE","findUserByUidAcrossPools","verifyEditHintToken","readCookieValue","verifySitePreviewToken","claimsHoldStaff","siteViewRefusal","options","host","membership","firestore","uid","staff","memberRoles","get","orgId","collection","doc","exists","member","data","id","REFUSED","admitted","via","verifySitePreviewViewer","deps","hostId","cookieHeader","nowMs","Date","now","previewCookie","hint","claims","findUser","found","record","disabled","refusal","error","console"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAEEA,WAAW,EACXC,eAAe,QACV,sBAAqB;AAC5B,SACEC,mBAAmB,EACnBC,6BAA6B,QACxB,sCAAqC;AAE5C,SAASC,wBAAwB,QAAQ,kBAAc;AACvD,SAASC,mBAAmB,QAAQ,uBAAmB;AACvD,SAASC,eAAe,EAAEC,sBAAsB,QAAQ,0BAAsB;AAC9E,SAASC,eAAe,QAAQ,kBAAc;AA4B9C;;;;CAIC,GACD,OAAO,eAAeC,gBAAgBC,OAOrC;QAIsBC,WAWLC;IAdhB,MAAM,EAAEC,SAAS,EAAEF,IAAI,EAAEG,GAAG,EAAEC,QAAQ,KAAK,EAAE,GAAGL;IAChD,IAAIK,OAAO,OAAO;IAClB,IAAI,CAACD,KAAK,OAAO;IACjB,MAAME,eAAeL,YAAAA,KAAKM,GAAG,CAAC,0BAATN,YAA2B,CAAC;IACjD,IAAIK,eAAeA,WAAW,CAACF,IAAI,IAAI,MAAM,OAAO;IACpD,MAAMI,QAAQP,KAAKM,GAAG,CAAC;IACvB,IAAI,CAACC,OAAO,OAAO;IACnB,MAAMN,aAAa,MAAMC,UACtBM,UAAU,CAAC,QACXC,GAAG,CAACF,OACJC,UAAU,CAAC,WACXC,GAAG,CAACN,KACJG,GAAG;IACN,IAAI,CAACL,WAAWS,MAAM,EAAE,OAAO;IAC/B,MAAMC,UAAUV,mBAAAA,WAAWW,IAAI,cAAfX,mBAAqB,CAAC;IACtC,IAAIX,gBAAgBqB,WAAWtB,YAAYsB,QAAQX,KAAKa,EAAE,MAAM,MAAM;QACpE,OAAO;IACT;IACA,OAAO;AACT;AAaA,MAAMC,UAA6B;IAAEC,UAAU;IAAOC,KAAK;AAAK;AAEhE;;;;;;;;;;;;;;;;;;CAkBC,GACD,OAAO,eAAeC,wBACpBlB,OAIC,EACDmB,OAA8B,CAAC,CAAC;QAIlBA;IAFd,MAAM,EAAEhB,SAAS,EAAEiB,MAAM,EAAEC,YAAY,EAAE,GAAGrB;IAC5C,IAAI,CAACoB,QAAQ,OAAOL;IACpB,MAAMO,SAAQH,cAAAA,KAAKG,KAAK,YAAVH,cAAcI,KAAKC,GAAG;IAEpC,MAAMC,gBAAgB7B,gBAAgByB,cAAc7B;IACpD,IACEiC,iBACA5B,uBAAuB,UAAU4B,eAAeL,QAAQE,QACxD;QACA,OAAO;YAAEN,UAAU;YAAMC,KAAK;QAAS;IACzC;IAEA,MAAMS,OAAO9B,gBAAgByB,cAAc5B;IAC3C,MAAMkC,SAASD,OAAO/B,oBAAoB,UAAU+B,MAAMJ,SAAS;IACnE,IAAI,CAACK,QAAQ,OAAOZ;IACpB,IAAI;YACeI;QAAjB,MAAMS,YAAWT,iBAAAA,KAAKS,QAAQ,YAAbT,iBAAiBzB;QAClC,MAAMmC,QAAQ,MAAMD,SAASD,OAAOvB,GAAG;QACvC,IAAI,CAACyB,SAASA,MAAMC,MAAM,CAACC,QAAQ,EAAE,OAAOhB;QAC5C,MAAMd,OAAO,MAAME,UAAUM,UAAU,CAAC,SAASC,GAAG,CAACU,QAAQb,GAAG;QAChE,IAAI,CAACN,KAAKU,MAAM,EAAE,OAAOI;QACzB,MAAMiB,UAAU,MAAMjC,gBAAgB;YACpCI;YACAF;YACAG,KAAKuB,OAAOvB,GAAG;YACfC,OAAOP,gBAAgB+B,MAAMC,MAAM;QACrC;QACA,OAAOE,UAAUjB,UAAU;YAAEC,UAAU;YAAMC,KAAK;QAAO;IAC3D,EAAE,OAAOgB,OAAO;QACdC,QAAQD,KAAK,CAAC,sCAAsCA;QACpD,OAAOlB;IACT;AACF"}