@aglyn/aglyn 1.13.0 → 1.15.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +11 -11
- package/src/lib/app-utils/crm.js +8 -7
- package/src/lib/app-utils/crm.js.map +1 -1
- package/src/lib/app-utils/docs-help-sections.generated.js +4 -3
- package/src/lib/app-utils/docs-help-sections.generated.js.map +1 -1
- package/src/lib/app-utils/docs-help.generated.d.ts +3 -3
- package/src/lib/app-utils/docs-help.generated.js +5 -1
- package/src/lib/app-utils/docs-help.generated.js.map +1 -1
- package/src/lib/app-utils/docs-index.generated.js +22 -22
- package/src/lib/app-utils/docs-index.generated.js.map +1 -1
- package/src/lib/app-utils/dynamic-list-rule.js +9 -5
- package/src/lib/app-utils/dynamic-list-rule.js.map +1 -1
- package/src/lib/app-utils/entity-picker-context.d.ts +6 -0
- package/src/lib/app-utils/entity-picker-context.js.map +1 -1
- package/src/lib/app-utils/host-status.js +1 -1
- package/src/lib/app-utils/host-status.js.map +1 -1
- package/src/lib/app-utils/native-nav.d.ts +2 -2
- package/src/lib/app-utils/native-nav.js +2 -2
- package/src/lib/app-utils/native-nav.js.map +1 -1
- package/src/lib/app-utils/org-role-grants.js +1 -1
- package/src/lib/app-utils/org-role-grants.js.map +1 -1
- package/src/lib/app-utils/page-header-record-context.d.ts +15 -0
- package/src/lib/app-utils/page-header-record-context.js +13 -4
- package/src/lib/app-utils/page-header-record-context.js.map +1 -1
- package/src/lib/app-utils/plan-entitlements.d.ts +38 -11
- package/src/lib/app-utils/plan-entitlements.js +39 -13
- package/src/lib/app-utils/plan-entitlements.js.map +1 -1
- package/src/lib/app-utils/release-flags.d.ts +1 -1
- package/src/lib/app-utils/release-flags.js +24 -0
- package/src/lib/app-utils/release-flags.js.map +1 -1
- package/src/lib/app-utils/site-context.d.ts +9 -0
- package/src/lib/app-utils/site-context.js.map +1 -1
- package/src/lib/app-utils/site-placement.d.ts +25 -7
- package/src/lib/app-utils/site-placement.js +17 -25
- package/src/lib/app-utils/site-placement.js.map +1 -1
- package/src/lib/app-utils/site-starter.d.ts +6 -0
- package/src/lib/app-utils/site-starter.js +15 -0
- package/src/lib/app-utils/site-starter.js.map +1 -1
- package/src/lib/plugin-manager/first-party-plugins.generated.js +1 -0
- package/src/lib/plugin-manager/first-party-plugins.generated.js.map +1 -1
- package/src/lib/plugin-manager/plugin-contact-capture.d.ts +10 -0
- package/src/lib/plugin-manager/plugin-contact-capture.js +11 -0
- package/src/lib/plugin-manager/plugin-contact-capture.js.map +1 -1
- package/src/lib/plugin-manager/plugin-record-lists.d.ts +18 -0
- package/src/lib/plugin-manager/plugin-record-lists.js +13 -0
- package/src/lib/plugin-manager/plugin-record-lists.js.map +1 -1
- package/src/lib/plugin-manager/video-embed-provider.d.ts +28 -0
- package/src/lib/plugin-manager/video-embed-provider.js +21 -0
- package/src/lib/plugin-manager/video-embed-provider.js.map +1 -1
- package/src/lib/plugin-manager/video-embed-providers.generated.js +3 -1
- package/src/lib/plugin-manager/video-embed-providers.generated.js.map +1 -1
|
@@ -29,7 +29,7 @@ import { type PluginReleaseFlagKey } from './plugin-release-flags.generated';
|
|
|
29
29
|
* Every release flag: the ones plugins declare (compiled from
|
|
30
30
|
* plugins.config.json, AGL-3080) and the platform's own below.
|
|
31
31
|
*/
|
|
32
|
-
export type ReleaseFlagKey = PluginReleaseFlagKey | 'release_addon_store' | 'release_native_checkout' | 'release_edit_bar' | 'release_assist' | 'release_video_uploads' | 'release_video_delivery' | 'release_ai_generative' | 'release_ai_site_import' | 'release_crm_assist_whole_record' | 'release_ai_site_inspiration' | 'release_ad_audience_sync' | 'release_site_starters';
|
|
32
|
+
export type ReleaseFlagKey = PluginReleaseFlagKey | 'release_addon_store' | 'release_native_checkout' | 'release_edit_bar' | 'release_assist' | 'release_video_uploads' | 'release_video_delivery' | 'release_ai_generative' | 'release_ai_site_import' | 'release_ai_site_import_generative' | 'release_crm_assist_whole_record' | 'release_ai_site_inspiration' | 'release_ad_audience_sync' | 'release_site_starters' | 'release_video_embed_posters';
|
|
33
33
|
export interface ReleaseFlagDefinition {
|
|
34
34
|
key: ReleaseFlagKey;
|
|
35
35
|
label: string;
|
|
@@ -135,6 +135,19 @@ export function isReleaseFlagStage(value) {
|
|
|
135
135
|
description: 'Bring an existing website into a workspace on a paid plan (AGL-3973): ' + 'the workspace proves it owns the domain (a DNS record, a home page ' + 'meta tag, or a code emailed to an address at the domain), then ' + 'AglynBot reads the site within robots.txt, same-origin only, under ' + 'page, byte and time budgets. ON since 2026-10-25 (beta.282, after the ' + 'Legal v18 import clause and the blocked-page reason, AGL-4029); turned ' + 'off, the ownership and crawl doors answer 404.',
|
|
136
136
|
defaultEnabled: true
|
|
137
137
|
},
|
|
138
|
+
// Improve it, generative (AGL-4152): under Bring my site's Improve it, the
|
|
139
|
+
// site is planned before anything is built, its menu and design drawn to it,
|
|
140
|
+
// and with new copy on a page is redesigned from a ledger of what the source
|
|
141
|
+
// holds, with new sections. Off by default and off everywhere in production
|
|
142
|
+
// until its paid eval and the owner's read pass; a test organization gets it
|
|
143
|
+
// with the per-org override, `orgs/{orgId}.releaseFlags`. Off, Improve it is
|
|
144
|
+
// exactly what `release_ai_site_import` ships today.
|
|
145
|
+
{
|
|
146
|
+
key: 'release_ai_site_import_generative',
|
|
147
|
+
label: 'Bring my site: generative Improve it',
|
|
148
|
+
description: 'Under Improve it, the site is planned before anything is built: its ' + 'menu, footer, design and one proposed page. With new copy on, each main ' + 'page is redesigned from what the source holds: sections added, new copy ' + 'written and checked so that it invents no name, number, price or ' + 'credential (AGL-4152). OFF by default; on for one organization by its per-org ' + 'override while it is evaluated. Off, Improve it is unchanged.',
|
|
149
|
+
defaultEnabled: false
|
|
150
|
+
},
|
|
138
151
|
// What CRM assistance hands the model provider, not whether it runs:
|
|
139
152
|
// `release_ai_generative` opens the doors, this widens what a record sends
|
|
140
153
|
// through them. Per org, with no staff preview — the data is the customer's,
|
|
@@ -174,6 +187,17 @@ export function isReleaseFlagStage(value) {
|
|
|
174
187
|
label: 'Site starters from the marketplace',
|
|
175
188
|
description: 'Create site asks the person to choose a starter (AGL-4049): every ' + `option, ${PLATFORM_BRAND_NAME}\u2019s own included, is a marketplace listing any ` + 'publisher may list and price, for a base start or an AI start. OFF ' + 'by default: Create site makes the default site as it always has.',
|
|
176
189
|
defaultEnabled: false
|
|
190
|
+
},
|
|
191
|
+
// Per org (AGL-4140): the tenant loader reads it for the site's workspace
|
|
192
|
+
// into `SiteContextValue.videoEmbedPosters`, the lockdown verdict reads it
|
|
193
|
+
// for the middleware's `img-src`, and a site import stamps it on each wave
|
|
194
|
+
// as the wave starts. Off, a poster-less YouTube film asks for a poster,
|
|
195
|
+
// as it always has.
|
|
196
|
+
{
|
|
197
|
+
key: 'release_video_embed_posters',
|
|
198
|
+
label: 'YouTube thumbnails as video posters',
|
|
199
|
+
description: 'A YouTube film placed or imported with no poster shows YouTube\u2019s ' + 'own thumbnail (AGL-4140), which each visitor\u2019s browser loads from ' + 'i.ytimg.com with the page. OFF by default: nothing is requested from ' + 'Google until the Subprocessors page that discloses it is published.',
|
|
200
|
+
defaultEnabled: false
|
|
177
201
|
}
|
|
178
202
|
];
|
|
179
203
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/release-flags.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 * Release flags (AGL-227): platform-level \"is this feature launched\"\n * gating backed by Firebase Remote Config. A separate axis from plan\n * entitlements (`plan-entitlements.ts`) — entitlements ask whether the\n * tenant's PLAN includes a feature, release flags ask whether the feature\n * is released to the public at all (or partially, via percentage rollout).\n * Staff bypass release flags everywhere but see a flagged warning.\n */\n\n/** Remote Config parameter keys for release-gated features. */\nimport type { OrgPlan } from '../foundation'\nimport { PLAN_LABELS, PLAN_LADDER } from './plan-entitlements'\nimport { PLATFORM_BRAND_NAME } from './platform-brand'\nimport {\n PLUGIN_RELEASE_FLAGS,\n type PluginReleaseFlagKey,\n} from './plugin-release-flags.generated'\n\n/**\n * Every release flag: the ones plugins declare (compiled from\n * plugins.config.json, AGL-3080) and the platform's own below.\n */\nexport type ReleaseFlagKey =\n | PluginReleaseFlagKey\n | 'release_addon_store'\n | 'release_native_checkout'\n | 'release_edit_bar'\n | 'release_assist'\n | 'release_video_uploads'\n | 'release_video_delivery'\n | 'release_ai_generative'\n | 'release_ai_site_import'\n | 'release_crm_assist_whole_record'\n | 'release_ai_site_inspiration'\n | 'release_ad_audience_sync'\n | 'release_site_starters'\n\nexport interface ReleaseFlagDefinition {\n key: ReleaseFlagKey\n label: string\n description: string\n /**\n * Fallback verdict when Remote Config is unreachable (offline, blocked,\n * first paint before activate). MUST match the seeded value in\n * cloud/firebase-remoteconfig.template.json so environments without a\n * published template behave like the template intends.\n */\n defaultEnabled: boolean\n /** Host dashboard tab id (host-nav-tabs.ts) this flag hides, if any. */\n navTabId?: string\n /**\n * Where a RELEASED feature stands, when it is still changing. Absent means\n * generally available, which is what every feature without a stage is.\n *\n * Data only. A stage never gates anything, and it says nothing while the\n * flag is off: an off feature is rolling out, whatever its stage reads. The\n * console labels an on, `beta`-staged feature Beta beside its nav tab and\n * its hub header, and the docs open its pages with a `:::note Beta`\n * admonition, which `docs-release-flags.spec.ts` holds to this field.\n */\n stage?: ReleaseFlagStage\n}\n\n/**\n * The stages a released feature can be in short of general availability.\n * One today. A stage is per feature, never platform-wide: features keep\n * arriving in beta for as long as the product grows.\n */\nexport const RELEASE_FLAG_STAGES = ['beta'] as const\n\nexport type ReleaseFlagStage = (typeof RELEASE_FLAG_STAGES)[number]\n\nexport function isReleaseFlagStage(value: unknown): value is ReleaseFlagStage {\n return (RELEASE_FLAG_STAGES as readonly unknown[]).includes(value)\n}\n\n/** A release flag a plugin declares, as the generator compiles it. */\nexport type PluginReleaseFlagDefinition = ReleaseFlagDefinition & {\n key: PluginReleaseFlagKey\n}\n\n/**\n * The platform's own release flags: features no plugin owns.\n *\n * Every first-party plugin is release-flagged too (AGL-422) — the flag feeds\n * the plugin LOADER (console, published sites, API dispatch), not just nav\n * visibility, so staff can kill-switch a whole plugin platform-wide from the\n * Feature Flags page. Those flags are the plugins' own: each is defined by\n * its catalog row's `releaseFlagDefinition` in plugins.config.json and\n * compiled into `PLUGIN_RELEASE_FLAGS`, so adding a plugin edits nothing\n * here.\n */\nconst PLATFORM_RELEASE_FLAGS: readonly ReleaseFlagDefinition[] = [\n {\n key: 'release_addon_store',\n label: 'Add-on store',\n description:\n 'Self-serve add-on purchases on the Billing page: seats, datasets, ' +\n 'extra sites, POS registers, Event Calendar (AGL-524..531).',\n defaultEnabled: true,\n },\n // Released to every workspace 2026-10-06 (AGL-3606). Storefront-only since\n // the console's plan checkout stopped rendering Stripe Checkout at all. Still\n // the surface's kill switch, globally or per org: off, both storefront\n // checkout routes return the hosted redirect again.\n {\n key: 'release_native_checkout',\n label: 'In-page checkout',\n description:\n 'Storefront shoppers pay on the merchant\\u2019s own site: the Payment ' +\n 'Element, email, shipping address and method, and a live total with ' +\n 'tax open in place under the Buy or Checkout button, styled with the ' +\n 'site theme, instead of a redirect to checkout.stripe.com (AGL-1944). ' +\n 'Released to every workspace 2026-10-06 (AGL-3606). The webhook is ' +\n 'still the only thing that fulfils. Also gated on ' +\n 'NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY, so a deployment without one keeps ' +\n 'the redirect; turning this off returns every storefront to the redirect.',\n defaultEnabled: true,\n },\n // Released to every site 2026-09-16 (AGL-3041). Still the whole surface's\n // kill switch, globally or for one org by override: off, the tenant slot\n // renders nothing, both token mints refuse, and `/api/edit-context` turns\n // away every token already issued.\n {\n key: 'release_edit_bar',\n label: 'Site admin bar',\n description:\n 'Admin bar on published sites: a signed-in editor jumps from a live ' +\n 'page straight into the Besigner to edit it. Released ' +\n '2026-09-16 (AGL-3041) for every site; turning it off hides the bar ' +\n 'and revokes every outstanding edit token at the verify site.',\n defaultEnabled: true,\n },\n {\n key: 'release_assist',\n label: `${PLATFORM_BRAND_NAME} Assist`,\n // Released to every workspace and still changing: what it answers, what\n // it can build from a message and how it cites the docs.\n stage: 'beta',\n description:\n 'The in-console AI chat helper on every page (AGL-1860): docs-' +\n 'grounded answers with deep links, page-context guidance on Pro+. ' +\n 'ON in production, and gated on TWO published legal artifacts ' +\n '(AGL-1909), neither of which is a repo file — both are live besigner ' +\n 'pages, so publication is what satisfies them: (1) the privacy-policy ' +\n 'disclosure for stored Q&A, because the data loop records every ' +\n 'exchange org-scoped under orgs/{orgId}/assistExchanges; and (2) the ' +\n 'Anthropic row on /legal/subprocessors, which was deliberately ' +\n 'REMOVED on 2026-08-13 (subprocessorsV2a-20260813) on the premise ' +\n 'that no production key existed — so the page is not merely ' +\n 'incomplete without it, it is affirmatively wrong. NOTE the real ' +\n 'trigger is ANTHROPIC_API_KEY, not this flag: /api/ai/assist (the ' +\n 'besigner copy assistant, AGL-89/130/169) carries no release flag at ' +\n 'all and sends customer site content to Anthropic on the key plus a ' +\n 'Pro entitlement alone. Setting the key in production therefore makes ' +\n 'Anthropic a subprocessor whether or not this flag is ever flipped.',\n defaultEnabled: true,\n },\n // Ingress only, and with no staff preview on the server: a video a staff\n // session uploads into a customer's library serves on that customer's pages\n // like any other, so a grant goes to the org through its override.\n // `apps/console/utils/server/video-uploads.ts` holds the gate.\n {\n key: 'release_video_uploads',\n label: 'Video uploads',\n description:\n 'New video in the media library, on every upload path (AGL-2830). ' +\n 'Off: refused with 403 video_uploads_paused, as DAM video delivery is ' +\n 'not yet metered or bounded per org (AGL-2810, AGL-2812). Images, ' +\n 'documents and stored videos are unaffected.',\n defaultEnabled: false,\n },\n // Delivery, not ingress: this flag decides whether a video already in the\n // library is COPIED to the configured delivery provider and served from it\n // through a short-lived signed redirect (AGL-2824). Per org, with no staff\n // preview on the server — a copy is customer data at the provider, so a\n // grant goes to the org through its override. Off, or with no provider\n // configured, every video serves from this platform exactly as before.\n // `media-delivery.ts` in `tenant-data-admin` holds the gate.\n {\n key: 'release_video_delivery',\n label: 'Video delivery',\n description:\n 'Serves library video from a configured delivery provider through ' +\n 'short-lived signed redirects, and copies each video to it (AGL-2824). ' +\n 'OFF by default: video serves from this platform as before. Also ' +\n \"needs the provider's settings.\",\n defaultEnabled: false,\n },\n // The generative doors share one runtime with Assist (AGL-2903) but not\n // its flag: `release_assist` answers questions, this builds things, and\n // the two are sold, metered and disclosed separately. The server-side\n // gate lives in `aiGateLadder` (404 when off, staff preview).\n // Labeled for what it switches — the generative doors — and not with the\n // add-on's own name, which is sold and live whether or not the doors are\n // released: the docs name the add-on, and a flag wearing the same words\n // reads as documented when it is not.\n {\n key: 'release_ai_generative',\n label: `${PLATFORM_BRAND_NAME} AI generation`,\n // Released to every workspace and still changing: the guided start, page\n // and section generation and the other generative doors.\n stage: 'beta',\n description:\n 'Generative building and automation behind the AI add-on ' +\n '(AGL-2903): sections, pages and workflows written by a model from ' +\n 'a brief, on the shared Anthropic runtime. ON for every workspace ' +\n 'since 2026-09-29; every generative route answers 404 while it is ' +\n 'off. On, it sends customer briefs and site content to Anthropic ' +\n 'on the same ANTHROPIC_API_KEY and under the same subprocessor ' +\n 'disclosure as Assist (AGL-1909).',\n defaultEnabled: true,\n },\n // \"Bring my site\" (AGL-3973): proving a workspace owns a website, and the\n // crawl that reads it once it has. OFF by default so a code change can\n // never be what releases it; the doors answer 404 while it is off, with a\n // staff preview. Its own flag rather than `release_ai_generative`, because\n // reading someone's website is a different thing to disclose than\n // writing from a brief.\n {\n key: 'release_ai_site_import',\n label: 'Bring my site',\n // Released on every paid plan and still changing: how pages are read,\n // rewritten in the new design and brought in wave by wave.\n stage: 'beta',\n description:\n 'Bring an existing website into a workspace on a paid plan (AGL-3973): ' +\n 'the workspace proves it owns the domain (a DNS record, a home page ' +\n 'meta tag, or a code emailed to an address at the domain), then ' +\n 'AglynBot reads the site within robots.txt, same-origin only, under ' +\n 'page, byte and time budgets. ON since 2026-10-25 (beta.282, after the ' +\n 'Legal v18 import clause and the blocked-page reason, AGL-4029); turned ' +\n 'off, the ownership and crawl doors answer 404.',\n defaultEnabled: true,\n },\n // What CRM assistance hands the model provider, not whether it runs:\n // `release_ai_generative` opens the doors, this widens what a record sends\n // through them. Per org, with no staff preview — the data is the customer's,\n // and a staff session reading a customer's record must send what the\n // published pages promise. The CRM's record-facts readers hold the gate.\n {\n key: 'release_crm_assist_whole_record',\n label: 'CRM assistance: whole record',\n description:\n 'What AI assistance in the CRM (a record summary, next step or ' +\n 'email draft) sends the model provider (AGL-3520). OFF: the ' +\n 'disclosed fields, with addresses and numbers in typed text ' +\n 'replaced. ON: the whole record, contact details and custom fields ' +\n 'included. ON since 2026-10-05, after Privacy Policy section 2 and ' +\n 'the Subprocessors row were republished; see ' +\n 'docs/drafts/agl-3520-crm-assistance-whole-record-disclosure.md.',\n defaultEnabled: true,\n },\n // Per org, with no staff preview on the server: the site job reads the\n // sites a person names only where the org's verdict is on, and the guided\n // start asks for them by the same verdict. `model/ai-site-inspiration.ts`\n // in the AI plugin holds the key.\n {\n key: 'release_ai_site_inspiration',\n label: 'AI site start: sites you like',\n description:\n 'The guided AI site start asks for sites the person likes (AGL-3975): ' +\n 'one on Free, three on a paid plan. The site job reads each home page ' +\n 'and two of its stylesheets through the SSRF-guarded fetch and keeps ' +\n 'signals only (section order, spacing, header, colors, type mood, ' +\n 'button and card shape, motion, and on a paid plan the features it ' +\n 'offers), never its words, images or logos. ON since 2026-10-28, ' +\n 'after its live eval re-run passed; turned off, no field is shown ' +\n 'and no site is read.',\n defaultEnabled: true,\n },\n // Platform-wide, never per org: the nightly job reads only the platform\n // value, because it is the operator's own marketing and no workspace's\n // feature. `apps/console/app/api/admin/ad-audience-sync/route.ts` holds the\n // gate; a dry run reports the counts whichever way it is set.\n {\n key: 'release_ad_audience_sync',\n label: 'Account-holder ad audiences',\n description:\n 'Nightly sync of United States account holders, as SHA-256 hashed ' +\n 'email addresses, to the operator\\u2019s own Meta, Google and LinkedIn ' +\n 'customer-list audiences (AGL-3780). OFF by default: nothing is sent ' +\n 'until the Privacy Policy that discloses it is published.',\n defaultEnabled: false,\n },\n // Per org (AGL-4049): \"Create site\" is to offer the starter picker only\n // where the org's verdict is on. Nothing reads the flag yet, and off it\n // creates the default site as it always has.\n {\n key: 'release_site_starters',\n label: 'Site starters from the marketplace',\n description:\n 'Create site asks the person to choose a starter (AGL-4049): every ' +\n `option, ${PLATFORM_BRAND_NAME}\\u2019s own included, is a marketplace listing any ` +\n 'publisher may list and price, for a base start or an AI start. OFF ' +\n 'by default: Create site makes the default site as it always has.',\n defaultEnabled: false,\n },\n]\n\n/**\n * The registry: one entry per gated feature, the plugins' first. Adding a\n * platform flag = add it above, seed it in the Remote Config template, and\n * (optionally) wrap the page in `<FeatureGate>` — the staff admin editor and\n * nav filtering pick it up from this list.\n */\nexport const RELEASE_FLAGS: readonly ReleaseFlagDefinition[] = [\n ...PLUGIN_RELEASE_FLAGS,\n ...PLATFORM_RELEASE_FLAGS,\n]\n\nexport const RELEASE_FLAG_KEYS = RELEASE_FLAGS.map(\n (definition) => definition.key,\n) as readonly ReleaseFlagKey[]\n\nexport function isReleaseFlagKey(value: string): value is ReleaseFlagKey {\n return (RELEASE_FLAG_KEYS as readonly string[]).includes(value)\n}\n\nexport function getReleaseFlagDefinition(\n key: ReleaseFlagKey,\n): ReleaseFlagDefinition {\n const definition = RELEASE_FLAGS.find((entry) => entry.key === key)\n if (!definition) throw new Error(`Unknown release flag: ${key}`)\n return definition\n}\n\n/**\n * The stage a flag's definition declares, or `undefined` for a generally\n * available feature (and for a key the registry does not know, so a retired\n * key can never label anything).\n */\nexport function releaseFlagStage(\n key: ReleaseFlagKey | null | undefined,\n): ReleaseFlagStage | undefined {\n if (!key) return undefined\n return RELEASE_FLAGS.find((entry) => entry.key === key)?.stage\n}\n\n/** Whether a flag's definition declares the `beta` stage. */\nexport function isBetaStaged(key: ReleaseFlagKey | null | undefined): boolean {\n return releaseFlagStage(key) === 'beta'\n}\n\n/**\n * Whether a surface wears the Beta label: its feature is RELEASED for this\n * viewer's workspace and its flag is staged `beta`.\n *\n * `released` is the rollout verdict without the staff bypass. A staff member\n * looking at a workspace whose flag is off is previewing a feature that is\n * still rolling out, which the staff preview marker already says; calling it\n * Beta there would describe a feature the workspace does not have.\n */\nexport function showsBetaStage(\n key: ReleaseFlagKey | null | undefined,\n released: boolean | null | undefined,\n): boolean {\n return released === true && isBetaStaged(key)\n}\n\n/**\n * The stage a console surface wears, from the release flags that govern it:\n * a hub's own flag and its open section's, either of which may be absent.\n * `beta` when any of them is released for this workspace and staged beta.\n *\n * `flags` is the console's verdict map, read for `released` (the rollout\n * verdict without the staff bypass) for the reason {@link showsBetaStage}\n * gives.\n */\nexport function releaseStageOfSurface(\n keys: readonly (ReleaseFlagKey | null | undefined)[],\n flags: Partial<Record<ReleaseFlagKey, { released?: boolean } | undefined>>,\n): ReleaseFlagStage | undefined {\n return keys.some((key) => key && showsBetaStage(key, flags[key]?.released))\n ? 'beta'\n : undefined\n}\n\n/** Every flag staged `beta`, in registry order. */\nexport const BETA_STAGED_RELEASE_FLAG_KEYS: readonly ReleaseFlagKey[] =\n RELEASE_FLAGS.filter((definition) => definition.stage === 'beta').map(\n (definition) => definition.key,\n )\n\n/**\n * The JSON payload stored in each Remote Config parameter. `enabled: true`\n * turns the feature on for everyone; `enabled: false` with a positive\n * `rolloutPercent` enables it for that percentage of subjects (stable\n * per-tenant bucketing, GrowthBook-style); `plans` narrows either of those\n * to a set of tiers (AGL-2486).\n */\nexport interface ReleaseFlagValue {\n enabled: boolean\n /** 0–100; only consulted while `enabled` is false. */\n rolloutPercent?: number\n /**\n * Plan/tier targeting (AGL-2486). The tiers this flag is being rolled out\n * to, or ABSENT for \"every tier\".\n *\n * ABSENT AND EMPTY BOTH MEAN EVERY TIER, and that is load-bearing: every\n * flag stored before this field existed parses to `undefined` here, and an\n * operator who unticks every box has plainly not asked for a flag that\n * reaches nobody. Reading an empty list as \"no tiers\" would dark-launch\n * nothing while the console still said the flag was on — the inverted\n * reading of this field is the whole hazard, so it is closed in the parser\n * rather than left to each call site.\n */\n plans?: OrgPlan[]\n /** Free-form staff note (\"waiting on AGL-199\", owner, etc.). */\n note?: string\n}\n\nconst clampPercent = (value: unknown): number => {\n const percent = typeof value === 'number' && Number.isFinite(value) ? value : 0\n return Math.min(100, Math.max(0, Math.round(percent)))\n}\n\n/**\n * Every plan a flag may target, cheapest first — `PLAN_LADDER`: the\n * self-serve plans, the plans pricing v4 retired (AGL-4126) in their old\n * place, then `enterprise`. Derived, never re-typed: pricing v3 inserted\n * `scale` mid-ladder and added `agency`, and a second hand-written tier list\n * here would have missed both. The retired plans stay targetable because a\n * workspace can still be ON one, and a flag aimed at \"Pro and above\" must\n * reach it; a stored list naming one must not lose it on the next save.\n */\nexport const RELEASE_FLAG_PLAN_LADDER: readonly OrgPlan[] = PLAN_LADDER\n\nconst isOrgPlan = (value: unknown): value is OrgPlan =>\n typeof value === 'string' &&\n Object.prototype.hasOwnProperty.call(PLAN_LABELS, value)\n\n/**\n * The tiers on the ladder at or above `plan` — what the console's \"Pro and\n * above\" shortcut expands to before it is STORED as an explicit list.\n *\n * Deliberately a UI convenience and not a stored \"minimum plan\" mode: a\n * stored threshold would silently re-aim every live flag the day a tier is\n * inserted into the middle of the ladder (pricing v3 did exactly that with\n * `scale`). An explicit list means the audience of a published flag only\n * ever changes because a human changed it.\n */\nexport function releaseFlagPlansAtOrAbove(plan: OrgPlan): OrgPlan[] {\n const index = RELEASE_FLAG_PLAN_LADDER.indexOf(plan)\n return index < 0 ? [] : RELEASE_FLAG_PLAN_LADDER.slice(index)\n}\n\n/**\n * Sanitises whatever is stored at `plans`, in ladder order.\n *\n * Returns `undefined` — not `[]` — for \"no targeting declared\", so the\n * absence survives a round trip through the staff editor and cannot be\n * written back as a list that means something else. Unknown tier names are\n * dropped for the same reason `parseOrgReleaseFlagOverrides` drops unknown\n * keys: a renamed or retired tier must never gate anything. A list that\n * names ONLY unknown tiers collapses to `undefined` (every tier) rather than\n * to an empty list, because a typo must inherit, never silently target.\n */\nexport function parseReleaseFlagPlans(raw: unknown): OrgPlan[] | undefined {\n if (!Array.isArray(raw)) return undefined\n const named = new Set(raw.filter(isOrgPlan))\n if (named.size === 0) return undefined\n return RELEASE_FLAG_PLAN_LADDER.filter((plan) => named.has(plan))\n}\n\n/**\n * Parses a Remote Config parameter string into a `ReleaseFlagValue`.\n * Tolerant by design — the template is hand-editable in the Firebase\n * console, so plain \"true\"/\"false\" strings and malformed JSON must not\n * crash gating: anything unreadable falls back to the registry default.\n */\nexport function parseReleaseFlagValue(\n raw: string | null | undefined,\n fallbackEnabled: boolean,\n): ReleaseFlagValue {\n const text = raw?.trim()\n if (!text) return { enabled: fallbackEnabled }\n if (text === 'true') return { enabled: true }\n if (text === 'false') return { enabled: false }\n try {\n const parsed = JSON.parse(text)\n if (typeof parsed === 'boolean') return { enabled: parsed }\n if (parsed && typeof parsed === 'object') {\n const plans = parseReleaseFlagPlans(parsed.plans)\n return {\n enabled: parsed.enabled === true,\n rolloutPercent: clampPercent(parsed.rolloutPercent),\n // Spread, so a flag stored before AGL-2486 has NO `plans` key at all\n // rather than an explicit `undefined`. `JSON.stringify` drops both,\n // but the two are not the same to `'plans' in value`, which is what\n // the staff PUT uses to tell \"the operator cleared the targeting\"\n // apart from \"this client never sent the field\".\n ...(plans ? { plans } : {}),\n note: typeof parsed.note === 'string' ? parsed.note : undefined,\n }\n }\n } catch {\n // fall through to the registry default\n }\n return { enabled: fallbackEnabled }\n}\n\n/**\n * The longest parameter description Remote Config will publish (AGL-3048).\n *\n * One description past it refuses the WHOLE publish with\n * `DESCRIPTION_EXCEEDS_MAXIMUM_SIZE`, which the staff flags route answered as\n * a 500. Registry descriptions are written for the staff flags page, and\n * several run far past the limit, so what the page shows and what a\n * parameter carries cannot always be the same text.\n *\n * Counted in UTF-8 BYTES. Remote Config states the limit in characters\n * without saying how it counts them, and a UTF-8 byte count is never smaller\n * than the code-point or UTF-16 count, so text within 256 bytes is within the\n * limit on every reading. The cost is a few characters of headroom on text\n * with typographic punctuation.\n */\nexport const REMOTE_CONFIG_DESCRIPTION_MAX_BYTES = 256\n\nfunction utf8ByteLength(text: string): number {\n let bytes = 0\n for (const character of text) {\n const codePoint = character.codePointAt(0) ?? 0\n bytes +=\n codePoint < 0x80 ? 1 : codePoint < 0x800 ? 2 : codePoint < 0x10000 ? 3 : 4\n }\n return bytes\n}\n\n/** Whether Remote Config accepts `text` as a parameter description. */\nexport function fitsRemoteConfigDescription(text: string): boolean {\n return utf8ByteLength(text) <= REMOTE_CONFIG_DESCRIPTION_MAX_BYTES\n}\n\nconst DESCRIPTION_ELLIPSIS = '…'\n\n/**\n * `text` cut to a length Remote Config accepts, at a word boundary, with an\n * ellipsis marking the cut. Text that already fits comes back unchanged.\n *\n * The cut takes whole code points, so a multi-byte character is never split.\n * It backs up to the last space when it lands inside a word (only a single\n * word longer than the whole budget is cut hard), and punctuation left\n * dangling before the ellipsis is dropped.\n */\nexport function clampRemoteConfigDescription(text: string): string {\n if (fitsRemoteConfigDescription(text)) return text\n const budget =\n REMOTE_CONFIG_DESCRIPTION_MAX_BYTES - utf8ByteLength(DESCRIPTION_ELLIPSIS)\n let kept = ''\n let bytes = 0\n for (const character of text) {\n const size = utf8ByteLength(character)\n if (bytes + size > budget) break\n kept += character\n bytes += size\n }\n const next = text.charAt(kept.length)\n if (next && !/\\s/.test(next)) {\n const lastSpace = kept.search(/\\s\\S*$/)\n if (lastSpace > 0) kept = kept.slice(0, lastSpace)\n }\n return `${kept.replace(/[\\s.,;:(–—-]+$/, '')}${DESCRIPTION_ELLIPSIS}`\n}\n\n/**\n * The description to publish with a release flag's Remote Config parameter\n * (AGL-3048). Always one Remote Config accepts:\n *\n * 1. The registry description, when it fits, so the flags page and the\n * parameter say the same thing.\n * 2. Otherwise the LIVE parameter's description, when it has one that fits.\n * Remote Config has already accepted exactly that text, and someone chose\n * it for the Firebase console. The first 250 characters of a longer\n * paragraph would drop whatever the paragraph says last: for\n * `release_assist`, the `/legal/subprocessors` precondition that its\n * AGL-1909 suite wants in front of whoever reads the flag there. The full\n * registry text stays on the staff flags page either way.\n * 3. Otherwise, as on a first publish with nothing live to keep, the\n * registry description clamped at a word boundary.\n */\nexport function releaseFlagParameterDescription(\n registryDescription: string,\n liveDescription: string | null | undefined,\n): string {\n if (fitsRemoteConfigDescription(registryDescription)) {\n return registryDescription\n }\n if (\n typeof liveDescription === 'string' &&\n liveDescription.trim().length > 0 &&\n fitsRemoteConfigDescription(liveDescription)\n ) {\n return liveDescription\n }\n return clampRemoteConfigDescription(registryDescription)\n}\n\n/**\n * FNV-1a 32-bit hash → 0–99 bucket. Deterministic so a subject keeps the\n * same rollout verdict across sessions and surfaces, and seeded with the\n * flag key so a subject doesn't land in the same bucket for every flag.\n */\nexport function releaseFlagBucket(flagKey: string, subjectId: string): number {\n let hash = 0x811c9dc5\n const seed = `${flagKey}:${subjectId}`\n for (let index = 0; index < seed.length; index += 1) {\n hash ^= seed.charCodeAt(index)\n hash = Math.imul(hash, 0x01000193)\n }\n return (hash >>> 0) % 100\n}\n\n/**\n * The gating verdict for one subject.\n *\n * `subjectId` is the ORG ID, or nothing. A rollout is a cohort of\n * workspaces, so a whole workspace has to land on one side of the\n * percentage: every surface that asks about an org must ask with the same\n * string, or they answer differently about the same customer.\n *\n * This docstring used to sanction falling back to the uid, and the server\n * gates fell back to a hostId. Since a hostId, a uid and an orgId hash to\n * three different buckets, a mid-rollout flag could be on in the console\n * and off on the published site for one workspace — stable per subject, so\n * it never flickered, it just stayed wrong (AGL-1656).\n *\n * An empty subject only passes fully-enabled flags. That is the deliberate\n * cost: a request with no resolvable org never joins a partial rollout,\n * which is the conservative answer rather than a confidently wrong one.\n */\nexport function isReleaseFlagOn(\n flagKey: ReleaseFlagKey,\n value: ReleaseFlagValue,\n subjectId: string | null | undefined,\n /**\n * The subject org's plan, when the caller knows it (AGL-2486). Optional so\n * every pre-existing call site compiles and answers unchanged: a flag that\n * declares no tier targeting never reads this.\n */\n plan?: OrgPlan | null,\n): boolean {\n if (!releaseFlagTargetsPlan(value, plan)) return false\n if (value.enabled) return true\n const percent = clampPercent(value.rolloutPercent)\n if (percent <= 0 || !subjectId) return false\n if (percent >= 100) return true\n return releaseFlagBucket(flagKey, subjectId) < percent\n}\n\n/**\n * Does this flag's tier targeting admit `plan`? (AGL-2486)\n *\n * THE SEMANTICS, because an operator who cannot predict the audience will\n * not stage a rollout at all:\n *\n * - The tier list is a FILTER, applied before and independently of the\n * percentage. The percentage then picks a cohort WITHIN the admitted\n * tiers. \"Pro and above at 50%\" is therefore both \"half of the Pro+\n * workspaces\" and \"the global 50% cohort, restricted to Pro+\" — the two\n * readings name the same set, and they do so because\n * {@link releaseFlagBucket} hashes `flagKey:orgId` and NOTHING ELSE.\n * - Which is also why the bucket is stable. Adding, removing or reordering\n * tiers cannot reshuffle the bucket, so an org already inside a 50%\n * rollout keeps the feature when an unrelated tier joins the list. Had\n * the plan been mixed into the hash — the obvious way to write this — a\n * tier edit would have re-drawn the cohort under every customer already\n * in it, and a plan change would have re-rolled the dice for one.\n * - The filter binds the FULLY-ENABLED path too, not just the rollout.\n * \"On, Enterprise + Agency\" is how a launch to the top of the ladder is\n * expressed, and it is what was actually asked for. Untargeted flags are\n * unaffected: no list means every tier, so `enabled` still means everyone.\n * - An UNKNOWN plan fails a declared list. Same conservatism as a missing\n * subject on a percentage rollout: a caller that cannot say which\n * workspace it is asking about gets the safe answer rather than a\n * confidently wrong one. A per-org staff override still wins over all of\n * it — see {@link isReleaseFlagOnForOrg} — so a targeted flag can still be\n * handed to one org off-ladder.\n */\nexport function releaseFlagTargetsPlan(\n value: ReleaseFlagValue,\n plan: OrgPlan | null | undefined,\n): boolean {\n const plans = value.plans\n // `!plans` would be the idiom here, but `strictNullChecks` is off repo-wide\n // and an empty array is truthy — both \"absent\" and \"empty\" have to be named\n // for the every-tier reading to actually hold.\n if (plans == null || plans.length === 0) return true\n if (!plan) return false\n return plans.includes(plan)\n}\n\n/**\n * Per-org release-flag overrides (AGL-1635), stored on the org doc at\n * `releaseFlags`. A present key is a staff DECISION about one organization\n * and wins over both the Remote Config value and the rollout bucket; an\n * absent key inherits.\n *\n * A separate field from `entitlements.features` on purpose: those ask\n * whether the org's PLAN includes a feature, these ask whether a\n * not-yet-released feature is switched on for this one customer. Folding\n * them together would make \"granted by the deal\" and \"previewing an\n * unreleased build\" indistinguishable at the point a support question is\n * asked.\n *\n * Why the org doc and not a Remote Config condition: RC conditions are\n * template-global and would need one published condition per org, with a\n * template publish (a manual, separate deploy) for every grant.\n */\nexport type OrgReleaseFlagOverrides = Partial<Record<ReleaseFlagKey, boolean>>\n\n/**\n * Sanitises whatever is actually stored at `org.releaseFlags`.\n *\n * Tolerant for the same reason `parseReleaseFlagValue` is: this map is\n * hand-editable in the Firebase console and survives registry renames, so a\n * retired flag key or a non-boolean must be dropped rather than allowed to\n * gate anything. Unknown keys are discarded — a stale key can never grant a\n * flag that no longer exists, and a typo silently inherits instead of\n * silently forcing.\n */\nexport function parseOrgReleaseFlagOverrides(\n raw: unknown,\n): OrgReleaseFlagOverrides {\n if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return {}\n const overrides: OrgReleaseFlagOverrides = {}\n for (const [key, value] of Object.entries(raw as Record<string, unknown>)) {\n if (typeof value === 'boolean' && isReleaseFlagKey(key)) {\n overrides[key] = value\n }\n }\n return overrides\n}\n\n/**\n * The gating verdict with a per-org override applied on top of\n * `isReleaseFlagOn`.\n *\n * The override is checked FIRST and short-circuits, so a forced-off flag\n * stays off for an org even while the flag is globally enabled — the\n * per-org kill switch is half the point, not just the per-org grant. Every\n * release-flag gate resolves through here so the console, the tenant\n * runtime and the API dispatchers cannot disagree about one org.\n */\nexport function isReleaseFlagOnForOrg(\n flagKey: ReleaseFlagKey,\n value: ReleaseFlagValue,\n subjectId: string | null | undefined,\n overrides: OrgReleaseFlagOverrides | null | undefined,\n /**\n * The org's plan, for tier targeting (AGL-2486). Checked only AFTER the\n * override: a staff grant is a decision about one named customer and\n * outranks the tier filter exactly as it already outranks the rollout\n * bucket. That ordering is what lets a Free org preview a\n * Business-targeted flag without widening the flag for every Free org.\n *\n * REQUIRED, and `null` has to be typed out. It was optional for one\n * release and that cost a silent revenue bug: `report-usage` held the org\n * document, dropped the argument, and every `plans`-declaring flag read\n * OFF — so the contacts overage went uninvoiced for exactly the orgs\n * entitled to reach the feature, with nothing thrown and nothing logged.\n * An unknown tier still refuses, which is the correct conservatism; what\n * cannot be allowed is a caller MANUFACTURING an unknown out of a tier it\n * already has in hand. Spelling `null` makes that a statement rather than\n * an omission, and makes the next call site that forgets fail to compile\n * instead of failing to bill. `getOrgReleaseFlagTargeting` returns the\n * plan beside the overrides from ONE document read precisely so that\n * passing it costs nothing.\n */\n plan: OrgPlan | null,\n): boolean {\n const override = overrides?.[flagKey]\n if (typeof override === 'boolean') return override\n return isReleaseFlagOn(flagKey, value, subjectId, plan)\n}\n"],"names":["PLAN_LABELS","PLAN_LADDER","PLATFORM_BRAND_NAME","PLUGIN_RELEASE_FLAGS","RELEASE_FLAG_STAGES","isReleaseFlagStage","value","includes","PLATFORM_RELEASE_FLAGS","key","label","description","defaultEnabled","stage","RELEASE_FLAGS","RELEASE_FLAG_KEYS","map","definition","isReleaseFlagKey","getReleaseFlagDefinition","find","entry","Error","releaseFlagStage","undefined","isBetaStaged","showsBetaStage","released","releaseStageOfSurface","keys","flags","some","BETA_STAGED_RELEASE_FLAG_KEYS","filter","clampPercent","percent","Number","isFinite","Math","min","max","round","RELEASE_FLAG_PLAN_LADDER","isOrgPlan","Object","prototype","hasOwnProperty","call","releaseFlagPlansAtOrAbove","plan","index","indexOf","slice","parseReleaseFlagPlans","raw","Array","isArray","named","Set","size","has","parseReleaseFlagValue","fallbackEnabled","text","trim","enabled","parsed","JSON","parse","plans","rolloutPercent","note","REMOTE_CONFIG_DESCRIPTION_MAX_BYTES","utf8ByteLength","bytes","character","codePoint","codePointAt","fitsRemoteConfigDescription","DESCRIPTION_ELLIPSIS","clampRemoteConfigDescription","budget","kept","next","charAt","length","test","lastSpace","search","replace","releaseFlagParameterDescription","registryDescription","liveDescription","releaseFlagBucket","flagKey","subjectId","hash","seed","charCodeAt","imul","isReleaseFlagOn","releaseFlagTargetsPlan","parseOrgReleaseFlagOverrides","overrides","entries","isReleaseFlagOnForOrg","override"],"mappings":"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"}
|
|
1
|
+
{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/release-flags.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 * Release flags (AGL-227): platform-level \"is this feature launched\"\n * gating backed by Firebase Remote Config. A separate axis from plan\n * entitlements (`plan-entitlements.ts`) — entitlements ask whether the\n * tenant's PLAN includes a feature, release flags ask whether the feature\n * is released to the public at all (or partially, via percentage rollout).\n * Staff bypass release flags everywhere but see a flagged warning.\n */\n\n/** Remote Config parameter keys for release-gated features. */\nimport type { OrgPlan } from '../foundation'\nimport { PLAN_LABELS, PLAN_LADDER } from './plan-entitlements'\nimport { PLATFORM_BRAND_NAME } from './platform-brand'\nimport {\n PLUGIN_RELEASE_FLAGS,\n type PluginReleaseFlagKey,\n} from './plugin-release-flags.generated'\n\n/**\n * Every release flag: the ones plugins declare (compiled from\n * plugins.config.json, AGL-3080) and the platform's own below.\n */\nexport type ReleaseFlagKey =\n | PluginReleaseFlagKey\n | 'release_addon_store'\n | 'release_native_checkout'\n | 'release_edit_bar'\n | 'release_assist'\n | 'release_video_uploads'\n | 'release_video_delivery'\n | 'release_ai_generative'\n | 'release_ai_site_import'\n | 'release_ai_site_import_generative'\n | 'release_crm_assist_whole_record'\n | 'release_ai_site_inspiration'\n | 'release_ad_audience_sync'\n | 'release_site_starters'\n | 'release_video_embed_posters'\n\nexport interface ReleaseFlagDefinition {\n key: ReleaseFlagKey\n label: string\n description: string\n /**\n * Fallback verdict when Remote Config is unreachable (offline, blocked,\n * first paint before activate). MUST match the seeded value in\n * cloud/firebase-remoteconfig.template.json so environments without a\n * published template behave like the template intends.\n */\n defaultEnabled: boolean\n /** Host dashboard tab id (host-nav-tabs.ts) this flag hides, if any. */\n navTabId?: string\n /**\n * Where a RELEASED feature stands, when it is still changing. Absent means\n * generally available, which is what every feature without a stage is.\n *\n * Data only. A stage never gates anything, and it says nothing while the\n * flag is off: an off feature is rolling out, whatever its stage reads. The\n * console labels an on, `beta`-staged feature Beta beside its nav tab and\n * its hub header, and the docs open its pages with a `:::note Beta`\n * admonition, which `docs-release-flags.spec.ts` holds to this field.\n */\n stage?: ReleaseFlagStage\n}\n\n/**\n * The stages a released feature can be in short of general availability.\n * One today. A stage is per feature, never platform-wide: features keep\n * arriving in beta for as long as the product grows.\n */\nexport const RELEASE_FLAG_STAGES = ['beta'] as const\n\nexport type ReleaseFlagStage = (typeof RELEASE_FLAG_STAGES)[number]\n\nexport function isReleaseFlagStage(value: unknown): value is ReleaseFlagStage {\n return (RELEASE_FLAG_STAGES as readonly unknown[]).includes(value)\n}\n\n/** A release flag a plugin declares, as the generator compiles it. */\nexport type PluginReleaseFlagDefinition = ReleaseFlagDefinition & {\n key: PluginReleaseFlagKey\n}\n\n/**\n * The platform's own release flags: features no plugin owns.\n *\n * Every first-party plugin is release-flagged too (AGL-422) — the flag feeds\n * the plugin LOADER (console, published sites, API dispatch), not just nav\n * visibility, so staff can kill-switch a whole plugin platform-wide from the\n * Feature Flags page. Those flags are the plugins' own: each is defined by\n * its catalog row's `releaseFlagDefinition` in plugins.config.json and\n * compiled into `PLUGIN_RELEASE_FLAGS`, so adding a plugin edits nothing\n * here.\n */\nconst PLATFORM_RELEASE_FLAGS: readonly ReleaseFlagDefinition[] = [\n {\n key: 'release_addon_store',\n label: 'Add-on store',\n description:\n 'Self-serve add-on purchases on the Billing page: seats, datasets, ' +\n 'extra sites, POS registers, Event Calendar (AGL-524..531).',\n defaultEnabled: true,\n },\n // Released to every workspace 2026-10-06 (AGL-3606). Storefront-only since\n // the console's plan checkout stopped rendering Stripe Checkout at all. Still\n // the surface's kill switch, globally or per org: off, both storefront\n // checkout routes return the hosted redirect again.\n {\n key: 'release_native_checkout',\n label: 'In-page checkout',\n description:\n 'Storefront shoppers pay on the merchant\\u2019s own site: the Payment ' +\n 'Element, email, shipping address and method, and a live total with ' +\n 'tax open in place under the Buy or Checkout button, styled with the ' +\n 'site theme, instead of a redirect to checkout.stripe.com (AGL-1944). ' +\n 'Released to every workspace 2026-10-06 (AGL-3606). The webhook is ' +\n 'still the only thing that fulfils. Also gated on ' +\n 'NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY, so a deployment without one keeps ' +\n 'the redirect; turning this off returns every storefront to the redirect.',\n defaultEnabled: true,\n },\n // Released to every site 2026-09-16 (AGL-3041). Still the whole surface's\n // kill switch, globally or for one org by override: off, the tenant slot\n // renders nothing, both token mints refuse, and `/api/edit-context` turns\n // away every token already issued.\n {\n key: 'release_edit_bar',\n label: 'Site admin bar',\n description:\n 'Admin bar on published sites: a signed-in editor jumps from a live ' +\n 'page straight into the Besigner to edit it. Released ' +\n '2026-09-16 (AGL-3041) for every site; turning it off hides the bar ' +\n 'and revokes every outstanding edit token at the verify site.',\n defaultEnabled: true,\n },\n {\n key: 'release_assist',\n label: `${PLATFORM_BRAND_NAME} Assist`,\n // Released to every workspace and still changing: what it answers, what\n // it can build from a message and how it cites the docs.\n stage: 'beta',\n description:\n 'The in-console AI chat helper on every page (AGL-1860): docs-' +\n 'grounded answers with deep links, page-context guidance on Pro+. ' +\n 'ON in production, and gated on TWO published legal artifacts ' +\n '(AGL-1909), neither of which is a repo file — both are live besigner ' +\n 'pages, so publication is what satisfies them: (1) the privacy-policy ' +\n 'disclosure for stored Q&A, because the data loop records every ' +\n 'exchange org-scoped under orgs/{orgId}/assistExchanges; and (2) the ' +\n 'Anthropic row on /legal/subprocessors, which was deliberately ' +\n 'REMOVED on 2026-08-13 (subprocessorsV2a-20260813) on the premise ' +\n 'that no production key existed — so the page is not merely ' +\n 'incomplete without it, it is affirmatively wrong. NOTE the real ' +\n 'trigger is ANTHROPIC_API_KEY, not this flag: /api/ai/assist (the ' +\n 'besigner copy assistant, AGL-89/130/169) carries no release flag at ' +\n 'all and sends customer site content to Anthropic on the key plus a ' +\n 'Pro entitlement alone. Setting the key in production therefore makes ' +\n 'Anthropic a subprocessor whether or not this flag is ever flipped.',\n defaultEnabled: true,\n },\n // Ingress only, and with no staff preview on the server: a video a staff\n // session uploads into a customer's library serves on that customer's pages\n // like any other, so a grant goes to the org through its override.\n // `apps/console/utils/server/video-uploads.ts` holds the gate.\n {\n key: 'release_video_uploads',\n label: 'Video uploads',\n description:\n 'New video in the media library, on every upload path (AGL-2830). ' +\n 'Off: refused with 403 video_uploads_paused, as DAM video delivery is ' +\n 'not yet metered or bounded per org (AGL-2810, AGL-2812). Images, ' +\n 'documents and stored videos are unaffected.',\n defaultEnabled: false,\n },\n // Delivery, not ingress: this flag decides whether a video already in the\n // library is COPIED to the configured delivery provider and served from it\n // through a short-lived signed redirect (AGL-2824). Per org, with no staff\n // preview on the server — a copy is customer data at the provider, so a\n // grant goes to the org through its override. Off, or with no provider\n // configured, every video serves from this platform exactly as before.\n // `media-delivery.ts` in `tenant-data-admin` holds the gate.\n {\n key: 'release_video_delivery',\n label: 'Video delivery',\n description:\n 'Serves library video from a configured delivery provider through ' +\n 'short-lived signed redirects, and copies each video to it (AGL-2824). ' +\n 'OFF by default: video serves from this platform as before. Also ' +\n \"needs the provider's settings.\",\n defaultEnabled: false,\n },\n // The generative doors share one runtime with Assist (AGL-2903) but not\n // its flag: `release_assist` answers questions, this builds things, and\n // the two are sold, metered and disclosed separately. The server-side\n // gate lives in `aiGateLadder` (404 when off, staff preview).\n // Labeled for what it switches — the generative doors — and not with the\n // add-on's own name, which is sold and live whether or not the doors are\n // released: the docs name the add-on, and a flag wearing the same words\n // reads as documented when it is not.\n {\n key: 'release_ai_generative',\n label: `${PLATFORM_BRAND_NAME} AI generation`,\n // Released to every workspace and still changing: the guided start, page\n // and section generation and the other generative doors.\n stage: 'beta',\n description:\n 'Generative building and automation behind the AI add-on ' +\n '(AGL-2903): sections, pages and workflows written by a model from ' +\n 'a brief, on the shared Anthropic runtime. ON for every workspace ' +\n 'since 2026-09-29; every generative route answers 404 while it is ' +\n 'off. On, it sends customer briefs and site content to Anthropic ' +\n 'on the same ANTHROPIC_API_KEY and under the same subprocessor ' +\n 'disclosure as Assist (AGL-1909).',\n defaultEnabled: true,\n },\n // \"Bring my site\" (AGL-3973): proving a workspace owns a website, and the\n // crawl that reads it once it has. OFF by default so a code change can\n // never be what releases it; the doors answer 404 while it is off, with a\n // staff preview. Its own flag rather than `release_ai_generative`, because\n // reading someone's website is a different thing to disclose than\n // writing from a brief.\n {\n key: 'release_ai_site_import',\n label: 'Bring my site',\n // Released on every paid plan and still changing: how pages are read,\n // rewritten in the new design and brought in wave by wave.\n stage: 'beta',\n description:\n 'Bring an existing website into a workspace on a paid plan (AGL-3973): ' +\n 'the workspace proves it owns the domain (a DNS record, a home page ' +\n 'meta tag, or a code emailed to an address at the domain), then ' +\n 'AglynBot reads the site within robots.txt, same-origin only, under ' +\n 'page, byte and time budgets. ON since 2026-10-25 (beta.282, after the ' +\n 'Legal v18 import clause and the blocked-page reason, AGL-4029); turned ' +\n 'off, the ownership and crawl doors answer 404.',\n defaultEnabled: true,\n },\n // Improve it, generative (AGL-4152): under Bring my site's Improve it, the\n // site is planned before anything is built, its menu and design drawn to it,\n // and with new copy on a page is redesigned from a ledger of what the source\n // holds, with new sections. Off by default and off everywhere in production\n // until its paid eval and the owner's read pass; a test organization gets it\n // with the per-org override, `orgs/{orgId}.releaseFlags`. Off, Improve it is\n // exactly what `release_ai_site_import` ships today.\n {\n key: 'release_ai_site_import_generative',\n label: 'Bring my site: generative Improve it',\n description:\n 'Under Improve it, the site is planned before anything is built: its ' +\n 'menu, footer, design and one proposed page. With new copy on, each main ' +\n 'page is redesigned from what the source holds: sections added, new copy ' +\n 'written and checked so that it invents no name, number, price or ' +\n 'credential (AGL-4152). OFF by default; on for one organization by its per-org ' +\n 'override while it is evaluated. Off, Improve it is unchanged.',\n defaultEnabled: false,\n },\n // What CRM assistance hands the model provider, not whether it runs:\n // `release_ai_generative` opens the doors, this widens what a record sends\n // through them. Per org, with no staff preview — the data is the customer's,\n // and a staff session reading a customer's record must send what the\n // published pages promise. The CRM's record-facts readers hold the gate.\n {\n key: 'release_crm_assist_whole_record',\n label: 'CRM assistance: whole record',\n description:\n 'What AI assistance in the CRM (a record summary, next step or ' +\n 'email draft) sends the model provider (AGL-3520). OFF: the ' +\n 'disclosed fields, with addresses and numbers in typed text ' +\n 'replaced. ON: the whole record, contact details and custom fields ' +\n 'included. ON since 2026-10-05, after Privacy Policy section 2 and ' +\n 'the Subprocessors row were republished; see ' +\n 'docs/drafts/agl-3520-crm-assistance-whole-record-disclosure.md.',\n defaultEnabled: true,\n },\n // Per org, with no staff preview on the server: the site job reads the\n // sites a person names only where the org's verdict is on, and the guided\n // start asks for them by the same verdict. `model/ai-site-inspiration.ts`\n // in the AI plugin holds the key.\n {\n key: 'release_ai_site_inspiration',\n label: 'AI site start: sites you like',\n description:\n 'The guided AI site start asks for sites the person likes (AGL-3975): ' +\n 'one on Free, three on a paid plan. The site job reads each home page ' +\n 'and two of its stylesheets through the SSRF-guarded fetch and keeps ' +\n 'signals only (section order, spacing, header, colors, type mood, ' +\n 'button and card shape, motion, and on a paid plan the features it ' +\n 'offers), never its words, images or logos. ON since 2026-10-28, ' +\n 'after its live eval re-run passed; turned off, no field is shown ' +\n 'and no site is read.',\n defaultEnabled: true,\n },\n // Platform-wide, never per org: the nightly job reads only the platform\n // value, because it is the operator's own marketing and no workspace's\n // feature. `apps/console/app/api/admin/ad-audience-sync/route.ts` holds the\n // gate; a dry run reports the counts whichever way it is set.\n {\n key: 'release_ad_audience_sync',\n label: 'Account-holder ad audiences',\n description:\n 'Nightly sync of United States account holders, as SHA-256 hashed ' +\n 'email addresses, to the operator\\u2019s own Meta, Google and LinkedIn ' +\n 'customer-list audiences (AGL-3780). OFF by default: nothing is sent ' +\n 'until the Privacy Policy that discloses it is published.',\n defaultEnabled: false,\n },\n // Per org (AGL-4049): \"Create site\" is to offer the starter picker only\n // where the org's verdict is on. Nothing reads the flag yet, and off it\n // creates the default site as it always has.\n {\n key: 'release_site_starters',\n label: 'Site starters from the marketplace',\n description:\n 'Create site asks the person to choose a starter (AGL-4049): every ' +\n `option, ${PLATFORM_BRAND_NAME}\\u2019s own included, is a marketplace listing any ` +\n 'publisher may list and price, for a base start or an AI start. OFF ' +\n 'by default: Create site makes the default site as it always has.',\n defaultEnabled: false,\n },\n // Per org (AGL-4140): the tenant loader reads it for the site's workspace\n // into `SiteContextValue.videoEmbedPosters`, the lockdown verdict reads it\n // for the middleware's `img-src`, and a site import stamps it on each wave\n // as the wave starts. Off, a poster-less YouTube film asks for a poster,\n // as it always has.\n {\n key: 'release_video_embed_posters',\n label: 'YouTube thumbnails as video posters',\n description:\n 'A YouTube film placed or imported with no poster shows YouTube\\u2019s ' +\n 'own thumbnail (AGL-4140), which each visitor\\u2019s browser loads from ' +\n 'i.ytimg.com with the page. OFF by default: nothing is requested from ' +\n 'Google until the Subprocessors page that discloses it is published.',\n defaultEnabled: false,\n },\n]\n\n/**\n * The registry: one entry per gated feature, the plugins' first. Adding a\n * platform flag = add it above, seed it in the Remote Config template, and\n * (optionally) wrap the page in `<FeatureGate>` — the staff admin editor and\n * nav filtering pick it up from this list.\n */\nexport const RELEASE_FLAGS: readonly ReleaseFlagDefinition[] = [\n ...PLUGIN_RELEASE_FLAGS,\n ...PLATFORM_RELEASE_FLAGS,\n]\n\nexport const RELEASE_FLAG_KEYS = RELEASE_FLAGS.map(\n (definition) => definition.key,\n) as readonly ReleaseFlagKey[]\n\nexport function isReleaseFlagKey(value: string): value is ReleaseFlagKey {\n return (RELEASE_FLAG_KEYS as readonly string[]).includes(value)\n}\n\nexport function getReleaseFlagDefinition(\n key: ReleaseFlagKey,\n): ReleaseFlagDefinition {\n const definition = RELEASE_FLAGS.find((entry) => entry.key === key)\n if (!definition) throw new Error(`Unknown release flag: ${key}`)\n return definition\n}\n\n/**\n * The stage a flag's definition declares, or `undefined` for a generally\n * available feature (and for a key the registry does not know, so a retired\n * key can never label anything).\n */\nexport function releaseFlagStage(\n key: ReleaseFlagKey | null | undefined,\n): ReleaseFlagStage | undefined {\n if (!key) return undefined\n return RELEASE_FLAGS.find((entry) => entry.key === key)?.stage\n}\n\n/** Whether a flag's definition declares the `beta` stage. */\nexport function isBetaStaged(key: ReleaseFlagKey | null | undefined): boolean {\n return releaseFlagStage(key) === 'beta'\n}\n\n/**\n * Whether a surface wears the Beta label: its feature is RELEASED for this\n * viewer's workspace and its flag is staged `beta`.\n *\n * `released` is the rollout verdict without the staff bypass. A staff member\n * looking at a workspace whose flag is off is previewing a feature that is\n * still rolling out, which the staff preview marker already says; calling it\n * Beta there would describe a feature the workspace does not have.\n */\nexport function showsBetaStage(\n key: ReleaseFlagKey | null | undefined,\n released: boolean | null | undefined,\n): boolean {\n return released === true && isBetaStaged(key)\n}\n\n/**\n * The stage a console surface wears, from the release flags that govern it:\n * a hub's own flag and its open section's, either of which may be absent.\n * `beta` when any of them is released for this workspace and staged beta.\n *\n * `flags` is the console's verdict map, read for `released` (the rollout\n * verdict without the staff bypass) for the reason {@link showsBetaStage}\n * gives.\n */\nexport function releaseStageOfSurface(\n keys: readonly (ReleaseFlagKey | null | undefined)[],\n flags: Partial<Record<ReleaseFlagKey, { released?: boolean } | undefined>>,\n): ReleaseFlagStage | undefined {\n return keys.some((key) => key && showsBetaStage(key, flags[key]?.released))\n ? 'beta'\n : undefined\n}\n\n/** Every flag staged `beta`, in registry order. */\nexport const BETA_STAGED_RELEASE_FLAG_KEYS: readonly ReleaseFlagKey[] =\n RELEASE_FLAGS.filter((definition) => definition.stage === 'beta').map(\n (definition) => definition.key,\n )\n\n/**\n * The JSON payload stored in each Remote Config parameter. `enabled: true`\n * turns the feature on for everyone; `enabled: false` with a positive\n * `rolloutPercent` enables it for that percentage of subjects (stable\n * per-tenant bucketing, GrowthBook-style); `plans` narrows either of those\n * to a set of tiers (AGL-2486).\n */\nexport interface ReleaseFlagValue {\n enabled: boolean\n /** 0–100; only consulted while `enabled` is false. */\n rolloutPercent?: number\n /**\n * Plan/tier targeting (AGL-2486). The tiers this flag is being rolled out\n * to, or ABSENT for \"every tier\".\n *\n * ABSENT AND EMPTY BOTH MEAN EVERY TIER, and that is load-bearing: every\n * flag stored before this field existed parses to `undefined` here, and an\n * operator who unticks every box has plainly not asked for a flag that\n * reaches nobody. Reading an empty list as \"no tiers\" would dark-launch\n * nothing while the console still said the flag was on — the inverted\n * reading of this field is the whole hazard, so it is closed in the parser\n * rather than left to each call site.\n */\n plans?: OrgPlan[]\n /** Free-form staff note (\"waiting on AGL-199\", owner, etc.). */\n note?: string\n}\n\nconst clampPercent = (value: unknown): number => {\n const percent = typeof value === 'number' && Number.isFinite(value) ? value : 0\n return Math.min(100, Math.max(0, Math.round(percent)))\n}\n\n/**\n * Every plan a flag may target, cheapest first — `PLAN_LADDER`: the\n * self-serve plans, the plans pricing v4 retired (AGL-4126) in their old\n * place, then `enterprise`. Derived, never re-typed: pricing v3 inserted\n * `scale` mid-ladder and added `agency`, and a second hand-written tier list\n * here would have missed both. The retired plans stay targetable because a\n * workspace can still be ON one, and a flag aimed at \"Pro and above\" must\n * reach it; a stored list naming one must not lose it on the next save.\n */\nexport const RELEASE_FLAG_PLAN_LADDER: readonly OrgPlan[] = PLAN_LADDER\n\nconst isOrgPlan = (value: unknown): value is OrgPlan =>\n typeof value === 'string' &&\n Object.prototype.hasOwnProperty.call(PLAN_LABELS, value)\n\n/**\n * The tiers on the ladder at or above `plan` — what the console's \"Pro and\n * above\" shortcut expands to before it is STORED as an explicit list.\n *\n * Deliberately a UI convenience and not a stored \"minimum plan\" mode: a\n * stored threshold would silently re-aim every live flag the day a tier is\n * inserted into the middle of the ladder (pricing v3 did exactly that with\n * `scale`). An explicit list means the audience of a published flag only\n * ever changes because a human changed it.\n */\nexport function releaseFlagPlansAtOrAbove(plan: OrgPlan): OrgPlan[] {\n const index = RELEASE_FLAG_PLAN_LADDER.indexOf(plan)\n return index < 0 ? [] : RELEASE_FLAG_PLAN_LADDER.slice(index)\n}\n\n/**\n * Sanitises whatever is stored at `plans`, in ladder order.\n *\n * Returns `undefined` — not `[]` — for \"no targeting declared\", so the\n * absence survives a round trip through the staff editor and cannot be\n * written back as a list that means something else. Unknown tier names are\n * dropped for the same reason `parseOrgReleaseFlagOverrides` drops unknown\n * keys: a renamed or retired tier must never gate anything. A list that\n * names ONLY unknown tiers collapses to `undefined` (every tier) rather than\n * to an empty list, because a typo must inherit, never silently target.\n */\nexport function parseReleaseFlagPlans(raw: unknown): OrgPlan[] | undefined {\n if (!Array.isArray(raw)) return undefined\n const named = new Set(raw.filter(isOrgPlan))\n if (named.size === 0) return undefined\n return RELEASE_FLAG_PLAN_LADDER.filter((plan) => named.has(plan))\n}\n\n/**\n * Parses a Remote Config parameter string into a `ReleaseFlagValue`.\n * Tolerant by design — the template is hand-editable in the Firebase\n * console, so plain \"true\"/\"false\" strings and malformed JSON must not\n * crash gating: anything unreadable falls back to the registry default.\n */\nexport function parseReleaseFlagValue(\n raw: string | null | undefined,\n fallbackEnabled: boolean,\n): ReleaseFlagValue {\n const text = raw?.trim()\n if (!text) return { enabled: fallbackEnabled }\n if (text === 'true') return { enabled: true }\n if (text === 'false') return { enabled: false }\n try {\n const parsed = JSON.parse(text)\n if (typeof parsed === 'boolean') return { enabled: parsed }\n if (parsed && typeof parsed === 'object') {\n const plans = parseReleaseFlagPlans(parsed.plans)\n return {\n enabled: parsed.enabled === true,\n rolloutPercent: clampPercent(parsed.rolloutPercent),\n // Spread, so a flag stored before AGL-2486 has NO `plans` key at all\n // rather than an explicit `undefined`. `JSON.stringify` drops both,\n // but the two are not the same to `'plans' in value`, which is what\n // the staff PUT uses to tell \"the operator cleared the targeting\"\n // apart from \"this client never sent the field\".\n ...(plans ? { plans } : {}),\n note: typeof parsed.note === 'string' ? parsed.note : undefined,\n }\n }\n } catch {\n // fall through to the registry default\n }\n return { enabled: fallbackEnabled }\n}\n\n/**\n * The longest parameter description Remote Config will publish (AGL-3048).\n *\n * One description past it refuses the WHOLE publish with\n * `DESCRIPTION_EXCEEDS_MAXIMUM_SIZE`, which the staff flags route answered as\n * a 500. Registry descriptions are written for the staff flags page, and\n * several run far past the limit, so what the page shows and what a\n * parameter carries cannot always be the same text.\n *\n * Counted in UTF-8 BYTES. Remote Config states the limit in characters\n * without saying how it counts them, and a UTF-8 byte count is never smaller\n * than the code-point or UTF-16 count, so text within 256 bytes is within the\n * limit on every reading. The cost is a few characters of headroom on text\n * with typographic punctuation.\n */\nexport const REMOTE_CONFIG_DESCRIPTION_MAX_BYTES = 256\n\nfunction utf8ByteLength(text: string): number {\n let bytes = 0\n for (const character of text) {\n const codePoint = character.codePointAt(0) ?? 0\n bytes +=\n codePoint < 0x80 ? 1 : codePoint < 0x800 ? 2 : codePoint < 0x10000 ? 3 : 4\n }\n return bytes\n}\n\n/** Whether Remote Config accepts `text` as a parameter description. */\nexport function fitsRemoteConfigDescription(text: string): boolean {\n return utf8ByteLength(text) <= REMOTE_CONFIG_DESCRIPTION_MAX_BYTES\n}\n\nconst DESCRIPTION_ELLIPSIS = '…'\n\n/**\n * `text` cut to a length Remote Config accepts, at a word boundary, with an\n * ellipsis marking the cut. Text that already fits comes back unchanged.\n *\n * The cut takes whole code points, so a multi-byte character is never split.\n * It backs up to the last space when it lands inside a word (only a single\n * word longer than the whole budget is cut hard), and punctuation left\n * dangling before the ellipsis is dropped.\n */\nexport function clampRemoteConfigDescription(text: string): string {\n if (fitsRemoteConfigDescription(text)) return text\n const budget =\n REMOTE_CONFIG_DESCRIPTION_MAX_BYTES - utf8ByteLength(DESCRIPTION_ELLIPSIS)\n let kept = ''\n let bytes = 0\n for (const character of text) {\n const size = utf8ByteLength(character)\n if (bytes + size > budget) break\n kept += character\n bytes += size\n }\n const next = text.charAt(kept.length)\n if (next && !/\\s/.test(next)) {\n const lastSpace = kept.search(/\\s\\S*$/)\n if (lastSpace > 0) kept = kept.slice(0, lastSpace)\n }\n return `${kept.replace(/[\\s.,;:(–—-]+$/, '')}${DESCRIPTION_ELLIPSIS}`\n}\n\n/**\n * The description to publish with a release flag's Remote Config parameter\n * (AGL-3048). Always one Remote Config accepts:\n *\n * 1. The registry description, when it fits, so the flags page and the\n * parameter say the same thing.\n * 2. Otherwise the LIVE parameter's description, when it has one that fits.\n * Remote Config has already accepted exactly that text, and someone chose\n * it for the Firebase console. The first 250 characters of a longer\n * paragraph would drop whatever the paragraph says last: for\n * `release_assist`, the `/legal/subprocessors` precondition that its\n * AGL-1909 suite wants in front of whoever reads the flag there. The full\n * registry text stays on the staff flags page either way.\n * 3. Otherwise, as on a first publish with nothing live to keep, the\n * registry description clamped at a word boundary.\n */\nexport function releaseFlagParameterDescription(\n registryDescription: string,\n liveDescription: string | null | undefined,\n): string {\n if (fitsRemoteConfigDescription(registryDescription)) {\n return registryDescription\n }\n if (\n typeof liveDescription === 'string' &&\n liveDescription.trim().length > 0 &&\n fitsRemoteConfigDescription(liveDescription)\n ) {\n return liveDescription\n }\n return clampRemoteConfigDescription(registryDescription)\n}\n\n/**\n * FNV-1a 32-bit hash → 0–99 bucket. Deterministic so a subject keeps the\n * same rollout verdict across sessions and surfaces, and seeded with the\n * flag key so a subject doesn't land in the same bucket for every flag.\n */\nexport function releaseFlagBucket(flagKey: string, subjectId: string): number {\n let hash = 0x811c9dc5\n const seed = `${flagKey}:${subjectId}`\n for (let index = 0; index < seed.length; index += 1) {\n hash ^= seed.charCodeAt(index)\n hash = Math.imul(hash, 0x01000193)\n }\n return (hash >>> 0) % 100\n}\n\n/**\n * The gating verdict for one subject.\n *\n * `subjectId` is the ORG ID, or nothing. A rollout is a cohort of\n * workspaces, so a whole workspace has to land on one side of the\n * percentage: every surface that asks about an org must ask with the same\n * string, or they answer differently about the same customer.\n *\n * This docstring used to sanction falling back to the uid, and the server\n * gates fell back to a hostId. Since a hostId, a uid and an orgId hash to\n * three different buckets, a mid-rollout flag could be on in the console\n * and off on the published site for one workspace — stable per subject, so\n * it never flickered, it just stayed wrong (AGL-1656).\n *\n * An empty subject only passes fully-enabled flags. That is the deliberate\n * cost: a request with no resolvable org never joins a partial rollout,\n * which is the conservative answer rather than a confidently wrong one.\n */\nexport function isReleaseFlagOn(\n flagKey: ReleaseFlagKey,\n value: ReleaseFlagValue,\n subjectId: string | null | undefined,\n /**\n * The subject org's plan, when the caller knows it (AGL-2486). Optional so\n * every pre-existing call site compiles and answers unchanged: a flag that\n * declares no tier targeting never reads this.\n */\n plan?: OrgPlan | null,\n): boolean {\n if (!releaseFlagTargetsPlan(value, plan)) return false\n if (value.enabled) return true\n const percent = clampPercent(value.rolloutPercent)\n if (percent <= 0 || !subjectId) return false\n if (percent >= 100) return true\n return releaseFlagBucket(flagKey, subjectId) < percent\n}\n\n/**\n * Does this flag's tier targeting admit `plan`? (AGL-2486)\n *\n * THE SEMANTICS, because an operator who cannot predict the audience will\n * not stage a rollout at all:\n *\n * - The tier list is a FILTER, applied before and independently of the\n * percentage. The percentage then picks a cohort WITHIN the admitted\n * tiers. \"Pro and above at 50%\" is therefore both \"half of the Pro+\n * workspaces\" and \"the global 50% cohort, restricted to Pro+\" — the two\n * readings name the same set, and they do so because\n * {@link releaseFlagBucket} hashes `flagKey:orgId` and NOTHING ELSE.\n * - Which is also why the bucket is stable. Adding, removing or reordering\n * tiers cannot reshuffle the bucket, so an org already inside a 50%\n * rollout keeps the feature when an unrelated tier joins the list. Had\n * the plan been mixed into the hash — the obvious way to write this — a\n * tier edit would have re-drawn the cohort under every customer already\n * in it, and a plan change would have re-rolled the dice for one.\n * - The filter binds the FULLY-ENABLED path too, not just the rollout.\n * \"On, Enterprise + Agency\" is how a launch to the top of the ladder is\n * expressed, and it is what was actually asked for. Untargeted flags are\n * unaffected: no list means every tier, so `enabled` still means everyone.\n * - An UNKNOWN plan fails a declared list. Same conservatism as a missing\n * subject on a percentage rollout: a caller that cannot say which\n * workspace it is asking about gets the safe answer rather than a\n * confidently wrong one. A per-org staff override still wins over all of\n * it — see {@link isReleaseFlagOnForOrg} — so a targeted flag can still be\n * handed to one org off-ladder.\n */\nexport function releaseFlagTargetsPlan(\n value: ReleaseFlagValue,\n plan: OrgPlan | null | undefined,\n): boolean {\n const plans = value.plans\n // `!plans` would be the idiom here, but `strictNullChecks` is off repo-wide\n // and an empty array is truthy — both \"absent\" and \"empty\" have to be named\n // for the every-tier reading to actually hold.\n if (plans == null || plans.length === 0) return true\n if (!plan) return false\n return plans.includes(plan)\n}\n\n/**\n * Per-org release-flag overrides (AGL-1635), stored on the org doc at\n * `releaseFlags`. A present key is a staff DECISION about one organization\n * and wins over both the Remote Config value and the rollout bucket; an\n * absent key inherits.\n *\n * A separate field from `entitlements.features` on purpose: those ask\n * whether the org's PLAN includes a feature, these ask whether a\n * not-yet-released feature is switched on for this one customer. Folding\n * them together would make \"granted by the deal\" and \"previewing an\n * unreleased build\" indistinguishable at the point a support question is\n * asked.\n *\n * Why the org doc and not a Remote Config condition: RC conditions are\n * template-global and would need one published condition per org, with a\n * template publish (a manual, separate deploy) for every grant.\n */\nexport type OrgReleaseFlagOverrides = Partial<Record<ReleaseFlagKey, boolean>>\n\n/**\n * Sanitises whatever is actually stored at `org.releaseFlags`.\n *\n * Tolerant for the same reason `parseReleaseFlagValue` is: this map is\n * hand-editable in the Firebase console and survives registry renames, so a\n * retired flag key or a non-boolean must be dropped rather than allowed to\n * gate anything. Unknown keys are discarded — a stale key can never grant a\n * flag that no longer exists, and a typo silently inherits instead of\n * silently forcing.\n */\nexport function parseOrgReleaseFlagOverrides(\n raw: unknown,\n): OrgReleaseFlagOverrides {\n if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return {}\n const overrides: OrgReleaseFlagOverrides = {}\n for (const [key, value] of Object.entries(raw as Record<string, unknown>)) {\n if (typeof value === 'boolean' && isReleaseFlagKey(key)) {\n overrides[key] = value\n }\n }\n return overrides\n}\n\n/**\n * The gating verdict with a per-org override applied on top of\n * `isReleaseFlagOn`.\n *\n * The override is checked FIRST and short-circuits, so a forced-off flag\n * stays off for an org even while the flag is globally enabled — the\n * per-org kill switch is half the point, not just the per-org grant. Every\n * release-flag gate resolves through here so the console, the tenant\n * runtime and the API dispatchers cannot disagree about one org.\n */\nexport function isReleaseFlagOnForOrg(\n flagKey: ReleaseFlagKey,\n value: ReleaseFlagValue,\n subjectId: string | null | undefined,\n overrides: OrgReleaseFlagOverrides | null | undefined,\n /**\n * The org's plan, for tier targeting (AGL-2486). Checked only AFTER the\n * override: a staff grant is a decision about one named customer and\n * outranks the tier filter exactly as it already outranks the rollout\n * bucket. That ordering is what lets a Free org preview a\n * Business-targeted flag without widening the flag for every Free org.\n *\n * REQUIRED, and `null` has to be typed out. It was optional for one\n * release and that cost a silent revenue bug: `report-usage` held the org\n * document, dropped the argument, and every `plans`-declaring flag read\n * OFF — so the contacts overage went uninvoiced for exactly the orgs\n * entitled to reach the feature, with nothing thrown and nothing logged.\n * An unknown tier still refuses, which is the correct conservatism; what\n * cannot be allowed is a caller MANUFACTURING an unknown out of a tier it\n * already has in hand. Spelling `null` makes that a statement rather than\n * an omission, and makes the next call site that forgets fail to compile\n * instead of failing to bill. `getOrgReleaseFlagTargeting` returns the\n * plan beside the overrides from ONE document read precisely so that\n * passing it costs nothing.\n */\n plan: OrgPlan | null,\n): boolean {\n const override = overrides?.[flagKey]\n if (typeof override === 'boolean') return override\n return isReleaseFlagOn(flagKey, value, subjectId, plan)\n}\n"],"names":["PLAN_LABELS","PLAN_LADDER","PLATFORM_BRAND_NAME","PLUGIN_RELEASE_FLAGS","RELEASE_FLAG_STAGES","isReleaseFlagStage","value","includes","PLATFORM_RELEASE_FLAGS","key","label","description","defaultEnabled","stage","RELEASE_FLAGS","RELEASE_FLAG_KEYS","map","definition","isReleaseFlagKey","getReleaseFlagDefinition","find","entry","Error","releaseFlagStage","undefined","isBetaStaged","showsBetaStage","released","releaseStageOfSurface","keys","flags","some","BETA_STAGED_RELEASE_FLAG_KEYS","filter","clampPercent","percent","Number","isFinite","Math","min","max","round","RELEASE_FLAG_PLAN_LADDER","isOrgPlan","Object","prototype","hasOwnProperty","call","releaseFlagPlansAtOrAbove","plan","index","indexOf","slice","parseReleaseFlagPlans","raw","Array","isArray","named","Set","size","has","parseReleaseFlagValue","fallbackEnabled","text","trim","enabled","parsed","JSON","parse","plans","rolloutPercent","note","REMOTE_CONFIG_DESCRIPTION_MAX_BYTES","utf8ByteLength","bytes","character","codePoint","codePointAt","fitsRemoteConfigDescription","DESCRIPTION_ELLIPSIS","clampRemoteConfigDescription","budget","kept","next","charAt","length","test","lastSpace","search","replace","releaseFlagParameterDescription","registryDescription","liveDescription","releaseFlagBucket","flagKey","subjectId","hash","seed","charCodeAt","imul","isReleaseFlagOn","releaseFlagTargetsPlan","parseOrgReleaseFlagOverrides","overrides","entries","isReleaseFlagOnForOrg","override"],"mappings":"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"}
|
|
@@ -54,6 +54,15 @@ export interface SiteContextValue {
|
|
|
54
54
|
* Absent in the besigner/preview, so blocks must keep working without it.
|
|
55
55
|
*/
|
|
56
56
|
pageData?: Record<string, unknown>;
|
|
57
|
+
/**
|
|
58
|
+
* Whether a hosted film with no poster shows its host's own still
|
|
59
|
+
* (AGL-4140): `release_video_embed_posters`, as the tenant loader read it
|
|
60
|
+
* for the site's workspace. The still loads from the host's own image
|
|
61
|
+
* origin on page load, which the published page's `img-src` admits only
|
|
62
|
+
* where the same flag is on, so absent (the canvas, Preview, an older
|
|
63
|
+
* page) shows no still.
|
|
64
|
+
*/
|
|
65
|
+
videoEmbedPosters?: boolean;
|
|
57
66
|
}
|
|
58
67
|
export declare const SiteContext: import("react").Context<SiteContextValue>;
|
|
59
68
|
/** The rendered site's identity; empty in the besigner canvas. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/site-context.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 { createContext, useCallback, useContext } from 'react'\n\n/**\n * Identity of the published site a node tree renders inside. Provided by\n * the tenant page and by the console's Preview; absent in the besigner\n * canvas, which is how components with side effects (forms) know to stay\n * inert.\n *\n * Lives banner-free in @aglyn/aglyn for the same reason as\n * ScreenLinkContext: a 'use client' banner in this module graph duplicates\n * the canvas singleton and blanks the tenant site (AGL-52).\n */\nexport interface SiteContextValue {\n /** Host document id of the rendered site. */\n hostId?: string\n /**\n * True on the console's Preview surface (AGL-1139).\n *\n * Preview now supplies a real `hostId`, because without one every plugin\n * block took its `if (!hostId)` placeholder branch — thirty of them — and\n * someone laying out a shop saw dashed boxes instead of their products.\n * A `hostId` is what makes those blocks resolve real data.\n *\n * The same `hostId` is what would let them WRITE it. Preview exists to\n * answer \"what will this look like and do\", not to place an order, post a\n * review or book a table, so this flag is how a block tells the difference.\n * Read through `useSiteFetch`, which refuses unsafe methods rather than\n * asking each block to remember.\n */\n preview?: boolean\n /**\n * Data a site-page resolver already loaded on the server for THIS page,\n * keyed by plugin (AGL-659).\n *\n * Blocks whose primary content came from a `useEffect` fetch rendered a\n * skeleton during SSR — so the crawler saw a product page with no product\n * in it. Seeding from here lets a block render its real content in the\n * server HTML and still hydrate normally, without giving up ISR caching.\n *\n * Absent in the besigner/preview, so blocks must keep working without it.\n */\n pageData?: Record<string, unknown>\n}\n\nexport const SiteContext = createContext<SiteContextValue>({})\nSiteContext.displayName = 'AglynSiteContext'\n\n/** The rendered site's identity; empty in the besigner canvas. */\nexport function useSite(): SiteContextValue {\n return useContext(SiteContext)\n}\n\n/**\n * Dispatched when Preview refuses a write (AGL-1139). The preview surface\n * listens once and says so; blocks do not each need their own message.\n */\nexport const PREVIEW_WRITE_BLOCKED_EVENT = 'aglyn:preview-write-blocked'\n\n/**\n * The status `useSiteFetch` answers a refused write with. Exported so a block\n * can tell \"Preview refused this\" from \"the server errored\" — the two need\n * opposite words, and a block that cannot tell them apart says \"something went\n * wrong\" about a deliberate, correct refusal (AGL-1249).\n */\nexport const PREVIEW_REFUSED_STATUS = 423\n\n/**\n * Was this response Preview declining to write, rather than a failure?\n *\n * The status alone stopped being sufficient with AGL-1511: a read-only\n * lockdown refuses a live site's writes with the SAME 423, so a block that\n * keys on the status only would tell a paying visitor \"Preview does not\n * change real data\" about a real checkout. Pass the parsed body and the\n * `preview: true` marker decides; a caller with no body in hand keeps the\n * old status-only behaviour, which is still right in the surface Preview\n * actually renders (its refusal never reaches the network, so a lockdown 423\n * cannot arrive there).\n */\nexport function isPreviewRefusal(\n response: { status?: number } | null | undefined,\n body?: unknown,\n): boolean {\n if (response?.status !== PREVIEW_REFUSED_STATUS) return false\n if (body === undefined) return true\n return (\n Boolean(body) &&\n typeof body === 'object' &&\n (body as { preview?: unknown }).preview === true\n )\n}\n\n/** Methods that cannot change server state, so Preview lets them through. */\nconst READ_METHODS = new Set(['GET', 'HEAD', 'OPTIONS'])\n\n/** What a blocked call resolves to. */\nconst BLOCKED_BODY = {\n error: 'Preview does not change real data.',\n preview: true,\n}\n\n/**\n * `fetch` for a site block, aware of which surface it is rendering on.\n *\n * Once Preview supplies a real `hostId` every block's data call starts\n * working — including the ones that book a table, post a review, register a\n * member or place an order. Those are not previews of anything; they are the\n * thing itself, triggered by someone checking their layout.\n *\n * So the boundary is drawn once, HERE, by method rather than by endpoint:\n * reads pass through, anything that can change state resolves to a 423\n * without a request being made. Drawing it per block would mean thirteen\n * files each remembering, and the fourteenth block silently not — the same\n * shape as the revalidate omission in AGL-1150.\n *\n * Deliberately resolves rather than rejects. Every caller already branches on\n * `response.ok`, so a refusal travels down the path they already have for a\n * server that said no, and no block needs a new `catch`.\n */\nexport function useSiteFetch(): typeof fetch {\n const { preview } = useSite()\n return useCallback(\n (input: RequestInfo | URL, init?: RequestInit) => {\n const method = String(\n init?.method ??\n (typeof Request !== 'undefined' && input instanceof Request\n ? input.method\n : 'GET'),\n ).toUpperCase()\n if (!preview || READ_METHODS.has(method)) return fetch(input, init)\n if (typeof window !== 'undefined') {\n window.dispatchEvent(\n new CustomEvent(PREVIEW_WRITE_BLOCKED_EVENT, { detail: { method } }),\n )\n }\n return Promise.resolve(\n new Response(JSON.stringify(BLOCKED_BODY), {\n // 423 Locked: the request was understood and refused because of the\n // surface it came from, not because it was malformed or forbidden.\n status: PREVIEW_REFUSED_STATUS,\n headers: { 'Content-Type': 'application/json' },\n }),\n )\n },\n [preview],\n )\n}\n"],"names":["createContext","useCallback","useContext","SiteContext","displayName","useSite","PREVIEW_WRITE_BLOCKED_EVENT","PREVIEW_REFUSED_STATUS","isPreviewRefusal","response","body","status","undefined","Boolean","preview","READ_METHODS","Set","BLOCKED_BODY","error","useSiteFetch","input","init","method","String","Request","toUpperCase","has","fetch","window","dispatchEvent","CustomEvent","detail","Promise","resolve","Response","JSON","stringify","headers"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,EAAEC,WAAW,EAAEC,UAAU,QAAQ,QAAO;
|
|
1
|
+
{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/site-context.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 { createContext, useCallback, useContext } from 'react'\n\n/**\n * Identity of the published site a node tree renders inside. Provided by\n * the tenant page and by the console's Preview; absent in the besigner\n * canvas, which is how components with side effects (forms) know to stay\n * inert.\n *\n * Lives banner-free in @aglyn/aglyn for the same reason as\n * ScreenLinkContext: a 'use client' banner in this module graph duplicates\n * the canvas singleton and blanks the tenant site (AGL-52).\n */\nexport interface SiteContextValue {\n /** Host document id of the rendered site. */\n hostId?: string\n /**\n * True on the console's Preview surface (AGL-1139).\n *\n * Preview now supplies a real `hostId`, because without one every plugin\n * block took its `if (!hostId)` placeholder branch — thirty of them — and\n * someone laying out a shop saw dashed boxes instead of their products.\n * A `hostId` is what makes those blocks resolve real data.\n *\n * The same `hostId` is what would let them WRITE it. Preview exists to\n * answer \"what will this look like and do\", not to place an order, post a\n * review or book a table, so this flag is how a block tells the difference.\n * Read through `useSiteFetch`, which refuses unsafe methods rather than\n * asking each block to remember.\n */\n preview?: boolean\n /**\n * Data a site-page resolver already loaded on the server for THIS page,\n * keyed by plugin (AGL-659).\n *\n * Blocks whose primary content came from a `useEffect` fetch rendered a\n * skeleton during SSR — so the crawler saw a product page with no product\n * in it. Seeding from here lets a block render its real content in the\n * server HTML and still hydrate normally, without giving up ISR caching.\n *\n * Absent in the besigner/preview, so blocks must keep working without it.\n */\n pageData?: Record<string, unknown>\n /**\n * Whether a hosted film with no poster shows its host's own still\n * (AGL-4140): `release_video_embed_posters`, as the tenant loader read it\n * for the site's workspace. The still loads from the host's own image\n * origin on page load, which the published page's `img-src` admits only\n * where the same flag is on, so absent (the canvas, Preview, an older\n * page) shows no still.\n */\n videoEmbedPosters?: boolean\n}\n\nexport const SiteContext = createContext<SiteContextValue>({})\nSiteContext.displayName = 'AglynSiteContext'\n\n/** The rendered site's identity; empty in the besigner canvas. */\nexport function useSite(): SiteContextValue {\n return useContext(SiteContext)\n}\n\n/**\n * Dispatched when Preview refuses a write (AGL-1139). The preview surface\n * listens once and says so; blocks do not each need their own message.\n */\nexport const PREVIEW_WRITE_BLOCKED_EVENT = 'aglyn:preview-write-blocked'\n\n/**\n * The status `useSiteFetch` answers a refused write with. Exported so a block\n * can tell \"Preview refused this\" from \"the server errored\" — the two need\n * opposite words, and a block that cannot tell them apart says \"something went\n * wrong\" about a deliberate, correct refusal (AGL-1249).\n */\nexport const PREVIEW_REFUSED_STATUS = 423\n\n/**\n * Was this response Preview declining to write, rather than a failure?\n *\n * The status alone stopped being sufficient with AGL-1511: a read-only\n * lockdown refuses a live site's writes with the SAME 423, so a block that\n * keys on the status only would tell a paying visitor \"Preview does not\n * change real data\" about a real checkout. Pass the parsed body and the\n * `preview: true` marker decides; a caller with no body in hand keeps the\n * old status-only behaviour, which is still right in the surface Preview\n * actually renders (its refusal never reaches the network, so a lockdown 423\n * cannot arrive there).\n */\nexport function isPreviewRefusal(\n response: { status?: number } | null | undefined,\n body?: unknown,\n): boolean {\n if (response?.status !== PREVIEW_REFUSED_STATUS) return false\n if (body === undefined) return true\n return (\n Boolean(body) &&\n typeof body === 'object' &&\n (body as { preview?: unknown }).preview === true\n )\n}\n\n/** Methods that cannot change server state, so Preview lets them through. */\nconst READ_METHODS = new Set(['GET', 'HEAD', 'OPTIONS'])\n\n/** What a blocked call resolves to. */\nconst BLOCKED_BODY = {\n error: 'Preview does not change real data.',\n preview: true,\n}\n\n/**\n * `fetch` for a site block, aware of which surface it is rendering on.\n *\n * Once Preview supplies a real `hostId` every block's data call starts\n * working — including the ones that book a table, post a review, register a\n * member or place an order. Those are not previews of anything; they are the\n * thing itself, triggered by someone checking their layout.\n *\n * So the boundary is drawn once, HERE, by method rather than by endpoint:\n * reads pass through, anything that can change state resolves to a 423\n * without a request being made. Drawing it per block would mean thirteen\n * files each remembering, and the fourteenth block silently not — the same\n * shape as the revalidate omission in AGL-1150.\n *\n * Deliberately resolves rather than rejects. Every caller already branches on\n * `response.ok`, so a refusal travels down the path they already have for a\n * server that said no, and no block needs a new `catch`.\n */\nexport function useSiteFetch(): typeof fetch {\n const { preview } = useSite()\n return useCallback(\n (input: RequestInfo | URL, init?: RequestInit) => {\n const method = String(\n init?.method ??\n (typeof Request !== 'undefined' && input instanceof Request\n ? input.method\n : 'GET'),\n ).toUpperCase()\n if (!preview || READ_METHODS.has(method)) return fetch(input, init)\n if (typeof window !== 'undefined') {\n window.dispatchEvent(\n new CustomEvent(PREVIEW_WRITE_BLOCKED_EVENT, { detail: { method } }),\n )\n }\n return Promise.resolve(\n new Response(JSON.stringify(BLOCKED_BODY), {\n // 423 Locked: the request was understood and refused because of the\n // surface it came from, not because it was malformed or forbidden.\n status: PREVIEW_REFUSED_STATUS,\n headers: { 'Content-Type': 'application/json' },\n }),\n )\n },\n [preview],\n )\n}\n"],"names":["createContext","useCallback","useContext","SiteContext","displayName","useSite","PREVIEW_WRITE_BLOCKED_EVENT","PREVIEW_REFUSED_STATUS","isPreviewRefusal","response","body","status","undefined","Boolean","preview","READ_METHODS","Set","BLOCKED_BODY","error","useSiteFetch","input","init","method","String","Request","toUpperCase","has","fetch","window","dispatchEvent","CustomEvent","detail","Promise","resolve","Response","JSON","stringify","headers"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,EAAEC,WAAW,EAAEC,UAAU,QAAQ,QAAO;AAqD9D,OAAO,MAAMC,cAAcH,cAAgC,CAAC,GAAE;AAC9DG,YAAYC,WAAW,GAAG;AAE1B,gEAAgE,GAChE,OAAO,SAASC;IACd,OAAOH,WAAWC;AACpB;AAEA;;;CAGC,GACD,OAAO,MAAMG,8BAA8B,8BAA6B;AAExE;;;;;CAKC,GACD,OAAO,MAAMC,yBAAyB,IAAG;AAEzC;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,iBACdC,QAAgD,EAChDC,IAAc;IAEd,IAAID,CAAAA,4BAAAA,SAAUE,MAAM,MAAKJ,wBAAwB,OAAO;IACxD,IAAIG,SAASE,WAAW,OAAO;IAC/B,OACEC,QAAQH,SACR,OAAOA,SAAS,YAChB,AAACA,KAA+BI,OAAO,KAAK;AAEhD;AAEA,2EAA2E,GAC3E,MAAMC,eAAe,IAAIC,IAAI;IAAC;IAAO;IAAQ;CAAU;AAEvD,qCAAqC,GACrC,MAAMC,eAAe;IACnBC,OAAO;IACPJ,SAAS;AACX;AAEA;;;;;;;;;;;;;;;;;CAiBC,GACD,OAAO,SAASK;IACd,MAAM,EAAEL,OAAO,EAAE,GAAGT;IACpB,OAAOJ,YACL,CAACmB,OAA0BC;;QACzB,MAAMC,SAASC,eACbF,wBAAAA,KAAMC,MAAM,mBACT,OAAOE,YAAY,eAAeJ,iBAAiBI,UAChDJ,MAAME,MAAM,GACZ,OACNG,WAAW;QACb,IAAI,CAACX,WAAWC,aAAaW,GAAG,CAACJ,SAAS,OAAOK,MAAMP,OAAOC;QAC9D,IAAI,OAAOO,WAAW,aAAa;YACjCA,OAAOC,aAAa,CAClB,IAAIC,YAAYxB,6BAA6B;gBAAEyB,QAAQ;oBAAET;gBAAO;YAAE;QAEtE;QACA,OAAOU,QAAQC,OAAO,CACpB,IAAIC,SAASC,KAAKC,SAAS,CAACnB,eAAe;YACzC,oEAAoE;YACpE,mEAAmE;YACnEN,QAAQJ;YACR8B,SAAS;gBAAE,gBAAgB;YAAmB;QAChD;IAEJ,GACA;QAACvB;KAAQ;AAEb"}
|
|
@@ -16,16 +16,34 @@
|
|
|
16
16
|
*/
|
|
17
17
|
import type { AglynOrgMember, HostAccessRole } from '../foundation';
|
|
18
18
|
import type { AglynOrgCustomRole } from './org-permissions';
|
|
19
|
-
/** The one site `visibleTo` places a resource on, or `null` for every site, several, or none. */
|
|
20
|
-
export declare function oneSitePlacement(visibleTo: unknown): string | null;
|
|
21
19
|
/**
|
|
22
|
-
*
|
|
20
|
+
* Where a resource sits: the fields of its document that decide it. A whole
|
|
21
|
+
* document, never `visibleTo` alone, so no caller can answer without the marker.
|
|
22
|
+
*/
|
|
23
|
+
export type ScopePlaced = Readonly<{
|
|
24
|
+
visibleTo?: unknown;
|
|
25
|
+
scopeMode?: unknown;
|
|
26
|
+
scopeExcept?: unknown;
|
|
27
|
+
}>;
|
|
28
|
+
/**
|
|
29
|
+
* The one site a resource is placed on, or `null` for every site, several, or
|
|
30
|
+
* none.
|
|
31
|
+
*
|
|
32
|
+
* `null` for a document shared with all sites except some, however few it reaches
|
|
33
|
+
* today. Its list can shrink to one site while it still belongs to the whole
|
|
34
|
+
* workspace, and the next new site joins it, so that one site never comes to
|
|
35
|
+
* answer for it. Read as the rules' `scopePlacement` reads it: either key present
|
|
36
|
+
* is marked, so a stored null or half a marker fails closed.
|
|
37
|
+
*/
|
|
38
|
+
export declare function oneSitePlacement(placed: ScopePlaced | null | undefined): string | null;
|
|
39
|
+
/**
|
|
40
|
+
* The verdict for a resource placed as `placed` says: see above. `site` is asked
|
|
23
41
|
* only when the workspace key did not settle it, so a door pays for reading the
|
|
24
42
|
* site only then.
|
|
25
43
|
*/
|
|
26
44
|
export declare function placementVerdict<T extends boolean | Promise<boolean>>(input: {
|
|
27
45
|
member: Partial<AglynOrgMember> | null | undefined;
|
|
28
|
-
|
|
46
|
+
placed: ScopePlaced | null | undefined;
|
|
29
47
|
workspace: boolean;
|
|
30
48
|
site: (hostId: string) => T;
|
|
31
49
|
}): boolean | T;
|
|
@@ -48,9 +66,9 @@ export declare function stampedPlacementKey(stamps: {
|
|
|
48
66
|
export declare function resolvedPlacementKey(member: Partial<AglynOrgMember> | null | undefined, hostId: string, key: string, customRole?: AglynOrgCustomRole | null): boolean;
|
|
49
67
|
/**
|
|
50
68
|
* Whether deleting a resource is out of this member's reach whatever they hold:
|
|
51
|
-
* they do not reach every site, and it is placed on every site
|
|
52
|
-
* belongs to the whole workspace.
|
|
69
|
+
* they do not reach every site, and it is placed on every site, on several, or on
|
|
70
|
+
* all sites except some. It belongs to the whole workspace.
|
|
53
71
|
*/
|
|
54
|
-
export declare function deleteBeyondReach(member: Partial<AglynOrgMember> | null | undefined,
|
|
72
|
+
export declare function deleteBeyondReach(member: Partial<AglynOrgMember> | null | undefined, placed: ScopePlaced | null | undefined): boolean;
|
|
55
73
|
/** The refusal for it, which names the reach it takes because no permission decides it. */
|
|
56
74
|
export declare function deleteBeyondReachRefusal(label: string): string;
|
|
@@ -15,37 +15,29 @@
|
|
|
15
15
|
* limitations under the License.
|
|
16
16
|
*/ import { hostStampedSitePermission, resolveMemberHostPermissions, siteMayNarrow } from "./host-permissions.js";
|
|
17
17
|
import { hostRoleFor, isOrgWideMember } from "./organizations.js";
|
|
18
|
-
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
* The workspace's shared resources carry `visibleTo`, and one placed on exactly
|
|
22
|
-
* one site belongs to it. Where a plugin decides a resource's writes that way,
|
|
23
|
-
* its keys come in pairs: a workspace key, and a site key that follows it for a
|
|
24
|
-
* member of the whole workspace, which a site can narrow and raise
|
|
25
|
-
* (`narrowsPerSite`, `raisesPerSite`), and which a site collaborator holds by
|
|
26
|
-
* their site role. The verdict:
|
|
27
|
-
*
|
|
28
|
-
* - the workspace key admits, unless a site narrows the member on the one site
|
|
29
|
-
* the resource sits on;
|
|
30
|
-
* - else, on that one site, the site key.
|
|
31
|
-
*
|
|
32
|
-
* Placed on every site or on several, the workspace key alone: no one site can be
|
|
33
|
-
* asked, and a security rule cannot look through a list of them.
|
|
18
|
+
/**
|
|
19
|
+
* The one site a resource is placed on, or `null` for every site, several, or
|
|
20
|
+
* none.
|
|
34
21
|
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
|
|
22
|
+
* `null` for a document shared with all sites except some, however few it reaches
|
|
23
|
+
* today. Its list can shrink to one site while it still belongs to the whole
|
|
24
|
+
* workspace, and the next new site joins it, so that one site never comes to
|
|
25
|
+
* answer for it. Read as the rules' `scopePlacement` reads it: either key present
|
|
26
|
+
* is marked, so a stored null or half a marker fails closed.
|
|
27
|
+
*/ export function oneSitePlacement(placed) {
|
|
28
|
+
if (!placed || placed.scopeMode !== undefined || placed.scopeExcept !== undefined) return null;
|
|
29
|
+
const { visibleTo } = placed;
|
|
38
30
|
if (!Array.isArray(visibleTo) || visibleTo.length !== 1) return null;
|
|
39
31
|
const [token] = visibleTo;
|
|
40
32
|
const match = typeof token === 'string' ? /^host:([^:/]+)$/.exec(token) : null;
|
|
41
33
|
return match ? match[1] : null;
|
|
42
34
|
}
|
|
43
35
|
/**
|
|
44
|
-
* The verdict for a resource placed
|
|
36
|
+
* The verdict for a resource placed as `placed` says: see above. `site` is asked
|
|
45
37
|
* only when the workspace key did not settle it, so a door pays for reading the
|
|
46
38
|
* site only then.
|
|
47
39
|
*/ export function placementVerdict(input) {
|
|
48
|
-
const hostId = oneSitePlacement(input.
|
|
40
|
+
const hostId = oneSitePlacement(input.placed);
|
|
49
41
|
if (!hostId) return input.workspace;
|
|
50
42
|
if (input.workspace && !siteMayNarrow(input.member, hostId)) return true;
|
|
51
43
|
return input.site(hostId);
|
|
@@ -76,10 +68,10 @@ import { hostRoleFor, isOrgWideMember } from "./organizations.js";
|
|
|
76
68
|
}
|
|
77
69
|
/**
|
|
78
70
|
* Whether deleting a resource is out of this member's reach whatever they hold:
|
|
79
|
-
* they do not reach every site, and it is placed on every site
|
|
80
|
-
* belongs to the whole workspace.
|
|
81
|
-
*/ export function deleteBeyondReach(member,
|
|
82
|
-
return !isOrgWideMember(member) && oneSitePlacement(
|
|
71
|
+
* they do not reach every site, and it is placed on every site, on several, or on
|
|
72
|
+
* all sites except some. It belongs to the whole workspace.
|
|
73
|
+
*/ export function deleteBeyondReach(member, placed) {
|
|
74
|
+
return !isOrgWideMember(member) && oneSitePlacement(placed) === null;
|
|
83
75
|
}
|
|
84
76
|
/** The refusal for it, which names the reach it takes because no permission decides it. */ export function deleteBeyondReachRefusal(label) {
|
|
85
77
|
return `This ${label.toLowerCase()} is shared beyond one site, so deleting it takes access to every site in the workspace.`;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/site-placement.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 type { AglynOrgMember, HostAccessRole } from '../foundation'\nimport { hostStampedSitePermission, resolveMemberHostPermissions, siteMayNarrow } from './host-permissions'\nimport type { AglynOrgCustomRole } from './org-permissions'\nimport { hostRoleFor, isOrgWideMember } from './organizations'\n\n/*\n * A RESOURCE PLACED ON ONE SITE ANSWERS TO THAT SITE (AGL-4047).\n *\n * The workspace's shared resources carry `visibleTo`, and one placed on exactly\n * one site belongs to it. Where a plugin decides a resource's writes that way,\n * its keys come in pairs: a workspace key, and a site key that follows it for a\n * member of the whole workspace, which a site can narrow and raise\n * (`narrowsPerSite`, `raisesPerSite`), and which a site collaborator holds by\n * their site role. The verdict:\n *\n * - the workspace key admits, unless a site narrows the member on the one site\n * the resource sits on;\n * - else, on that one site, the site key.\n *\n * Placed on every site or on
|
|
1
|
+
{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/site-placement.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 type { AglynOrgMember, HostAccessRole } from '../foundation'\nimport { hostStampedSitePermission, resolveMemberHostPermissions, siteMayNarrow } from './host-permissions'\nimport type { AglynOrgCustomRole } from './org-permissions'\nimport { hostRoleFor, isOrgWideMember } from './organizations'\n\n/*\n * A RESOURCE PLACED ON ONE SITE ANSWERS TO THAT SITE (AGL-4047).\n *\n * The workspace's shared resources carry `visibleTo`, and one placed on exactly\n * one site belongs to it. Where a plugin decides a resource's writes that way,\n * its keys come in pairs: a workspace key, and a site key that follows it for a\n * member of the whole workspace, which a site can narrow and raise\n * (`narrowsPerSite`, `raisesPerSite`), and which a site collaborator holds by\n * their site role. The verdict:\n *\n * - the workspace key admits, unless a site narrows the member on the one site\n * the resource sits on;\n * - else, on that one site, the site key.\n *\n * Placed on every site, on several, or on all sites except some, the workspace key\n * alone: no one site can be asked, and a security rule cannot look through a list\n * of them.\n *\n * The rules ask the same thing in their own words, so these are kept in step with\n * them, placement test included.\n */\n\n/**\n * Where a resource sits: the fields of its document that decide it. A whole\n * document, never `visibleTo` alone, so no caller can answer without the marker.\n */\nexport type ScopePlaced = Readonly<{ visibleTo?: unknown; scopeMode?: unknown; scopeExcept?: unknown }>\n\n/**\n * The one site a resource is placed on, or `null` for every site, several, or\n * none.\n *\n * `null` for a document shared with all sites except some, however few it reaches\n * today. Its list can shrink to one site while it still belongs to the whole\n * workspace, and the next new site joins it, so that one site never comes to\n * answer for it. Read as the rules' `scopePlacement` reads it: either key present\n * is marked, so a stored null or half a marker fails closed.\n */\nexport function oneSitePlacement(placed: ScopePlaced | null | undefined): string | null {\n if (!placed || placed.scopeMode !== undefined || placed.scopeExcept !== undefined) return null\n const { visibleTo } = placed\n if (!Array.isArray(visibleTo) || visibleTo.length !== 1) return null\n const [token] = visibleTo as unknown[]\n const match = typeof token === 'string' ? /^host:([^:/]+)$/.exec(token) : null\n return match ? match[1] : null\n}\n\n/**\n * The verdict for a resource placed as `placed` says: see above. `site` is asked\n * only when the workspace key did not settle it, so a door pays for reading the\n * site only then.\n */\nexport function placementVerdict<T extends boolean | Promise<boolean>>(input: {\n member: Partial<AglynOrgMember> | null | undefined\n placed: ScopePlaced | null | undefined\n workspace: boolean\n site: (hostId: string) => T\n}): boolean | T {\n const hostId = oneSitePlacement(input.placed)\n if (!hostId) return input.workspace\n if (input.workspace && !siteMayNarrow(input.member, hostId)) return true\n return input.site(hostId)\n}\n\n/**\n * The site key as the site's stamp gives it, read as the rules read it:\n * `memberPermissions[uid][key]`, else, on a site the projection has not reached\n * since the key existed, the site role's preset, unless someone decided against\n * this member in a way the stamp would carry: a custom role, or their own\n * workspace key refused. Those wait for the stamp, so nobody refused regains it\n * from `memberRoles`.\n */\nexport function stampedPlacementKey(\n stamps: { memberPermissions?: unknown; memberRoles?: unknown } | null | undefined,\n uid: string,\n key: string,\n preset: Readonly<Partial<Record<HostAccessRole, boolean>>>,\n member: (Partial<AglynOrgMember> & { roleId?: unknown; permissions?: unknown }) | null | undefined,\n workspaceKey: string,\n): boolean {\n const stamp = (stamps?.memberPermissions as Record<string, Record<string, unknown> | undefined> | undefined)?.[uid]?.[key]\n if (typeof stamp === 'boolean') return stamp\n if (member?.roleId != null || (member?.permissions as Record<string, unknown> | undefined)?.[workspaceKey] === false) return false\n return hostStampedSitePermission({ memberRoles: stamps?.memberRoles }, uid, key, preset)\n}\n\n/** The site key from the membership alone, by the function the site's stamp is written from. */\nexport function resolvedPlacementKey(\n member: Partial<AglynOrgMember> | null | undefined,\n hostId: string,\n key: string,\n customRole?: AglynOrgCustomRole | null,\n): boolean {\n if (!member || !hostRoleFor(member, hostId)) return false\n return resolveMemberHostPermissions({ member, customRole: customRole ?? null, hostId })[key] === true\n}\n\n/**\n * Whether deleting a resource is out of this member's reach whatever they hold:\n * they do not reach every site, and it is placed on every site, on several, or on\n * all sites except some. It belongs to the whole workspace.\n */\nexport function deleteBeyondReach(\n member: Partial<AglynOrgMember> | null | undefined,\n placed: ScopePlaced | null | undefined,\n): boolean {\n return !isOrgWideMember(member) && oneSitePlacement(placed) === null\n}\n\n/** The refusal for it, which names the reach it takes because no permission decides it. */\nexport function deleteBeyondReachRefusal(label: string): string {\n return `This ${label.toLowerCase()} is shared beyond one site, so deleting it takes access to every site in the workspace.`\n}\n"],"names":["hostStampedSitePermission","resolveMemberHostPermissions","siteMayNarrow","hostRoleFor","isOrgWideMember","oneSitePlacement","placed","scopeMode","undefined","scopeExcept","visibleTo","Array","isArray","length","token","match","exec","placementVerdict","input","hostId","workspace","member","site","stampedPlacementKey","stamps","uid","key","preset","workspaceKey","stamp","memberPermissions","roleId","permissions","memberRoles","resolvedPlacementKey","customRole","deleteBeyondReach","deleteBeyondReachRefusal","label","toLowerCase"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,SAASA,yBAAyB,EAAEC,4BAA4B,EAAEC,aAAa,QAAQ,wBAAoB;AAE3G,SAASC,WAAW,EAAEC,eAAe,QAAQ,qBAAiB;AA8B9D;;;;;;;;;CASC,GACD,OAAO,SAASC,iBAAiBC,MAAsC;IACrE,IAAI,CAACA,UAAUA,OAAOC,SAAS,KAAKC,aAAaF,OAAOG,WAAW,KAAKD,WAAW,OAAO;IAC1F,MAAM,EAAEE,SAAS,EAAE,GAAGJ;IACtB,IAAI,CAACK,MAAMC,OAAO,CAACF,cAAcA,UAAUG,MAAM,KAAK,GAAG,OAAO;IAChE,MAAM,CAACC,MAAM,GAAGJ;IAChB,MAAMK,QAAQ,OAAOD,UAAU,WAAW,kBAAkBE,IAAI,CAACF,SAAS;IAC1E,OAAOC,QAAQA,KAAK,CAAC,EAAE,GAAG;AAC5B;AAEA;;;;CAIC,GACD,OAAO,SAASE,iBAAuDC,KAKtE;IACC,MAAMC,SAASd,iBAAiBa,MAAMZ,MAAM;IAC5C,IAAI,CAACa,QAAQ,OAAOD,MAAME,SAAS;IACnC,IAAIF,MAAME,SAAS,IAAI,CAAClB,cAAcgB,MAAMG,MAAM,EAAEF,SAAS,OAAO;IACpE,OAAOD,MAAMI,IAAI,CAACH;AACpB;AAEA;;;;;;;CAOC,GACD,OAAO,SAASI,oBACdC,MAAiF,EACjFC,GAAW,EACXC,GAAW,EACXC,MAA0D,EAC1DN,MAAkG,EAClGO,YAAoB;QAEN,+BAACJ,2BAEgBH;IAF/B,MAAMQ,QAASL,2BAAAA,4BAAAA,OAAQM,iBAAiB,sBAA1B,gCAAA,AAACN,yBAA+F,CAACC,IAAI,qBAArG,6BAAuG,CAACC,IAAI;IAC1H,IAAI,OAAOG,UAAU,WAAW,OAAOA;IACvC,IAAIR,CAAAA,0BAAAA,OAAQU,MAAM,KAAI,QAAQ,CAACV,2BAAAA,sBAAAA,OAAQW,WAAW,qBAApB,AAACX,mBAA6D,CAACO,aAAa,MAAK,OAAO,OAAO;IAC7H,OAAO5B,0BAA0B;QAAEiC,WAAW,EAAET,0BAAAA,OAAQS,WAAW;IAAC,GAAGR,KAAKC,KAAKC;AACnF;AAEA,8FAA8F,GAC9F,OAAO,SAASO,qBACdb,MAAkD,EAClDF,MAAc,EACdO,GAAW,EACXS,UAAsC;IAEtC,IAAI,CAACd,UAAU,CAAClB,YAAYkB,QAAQF,SAAS,OAAO;IACpD,OAAOlB,6BAA6B;QAAEoB;QAAQc,UAAU,EAAEA,qBAAAA,aAAc;QAAMhB;IAAO,EAAE,CAACO,IAAI,KAAK;AACnG;AAEA;;;;CAIC,GACD,OAAO,SAASU,kBACdf,MAAkD,EAClDf,MAAsC;IAEtC,OAAO,CAACF,gBAAgBiB,WAAWhB,iBAAiBC,YAAY;AAClE;AAEA,yFAAyF,GACzF,OAAO,SAAS+B,yBAAyBC,KAAa;IACpD,OAAO,CAAC,KAAK,EAAEA,MAAMC,WAAW,GAAG,uFAAuF,CAAC;AAC7H"}
|
|
@@ -46,6 +46,12 @@ export type SiteStarterMode = 'base' | 'ai';
|
|
|
46
46
|
*/
|
|
47
47
|
export declare const SITE_THEME_BASES: readonly ["starter", "material-ui", "bootstrap", "minimal", "material3", "ant-design", "fluent", "carbon", "cupertino"];
|
|
48
48
|
export type SiteThemeBase = (typeof SITE_THEME_BASES)[number];
|
|
49
|
+
/**
|
|
50
|
+
* Each base as a person reads it (AGL-4049): the name the themes plugin's
|
|
51
|
+
* preset carries (its `presets.spec.ts` holds the two equal), and `Starter`
|
|
52
|
+
* for the theme a new site is born with.
|
|
53
|
+
*/
|
|
54
|
+
export declare const SITE_THEME_BASE_NAMES: Readonly<Record<SiteThemeBase, string>>;
|
|
49
55
|
/** Whether a value names one of the {@link SITE_THEME_BASES}. */
|
|
50
56
|
export declare function isSiteThemeBase(value: unknown): value is SiteThemeBase;
|
|
51
57
|
/**
|
|
@@ -45,6 +45,21 @@
|
|
|
45
45
|
'carbon',
|
|
46
46
|
'cupertino'
|
|
47
47
|
];
|
|
48
|
+
/**
|
|
49
|
+
* Each base as a person reads it (AGL-4049): the name the themes plugin's
|
|
50
|
+
* preset carries (its `presets.spec.ts` holds the two equal), and `Starter`
|
|
51
|
+
* for the theme a new site is born with.
|
|
52
|
+
*/ export const SITE_THEME_BASE_NAMES = {
|
|
53
|
+
starter: 'Starter',
|
|
54
|
+
'material-ui': 'Material UI',
|
|
55
|
+
bootstrap: 'Bootstrap',
|
|
56
|
+
minimal: 'Minimal',
|
|
57
|
+
material3: 'Material 3',
|
|
58
|
+
'ant-design': 'Ant Design',
|
|
59
|
+
fluent: 'Fluent',
|
|
60
|
+
carbon: 'Carbon',
|
|
61
|
+
cupertino: 'Cupertino'
|
|
62
|
+
};
|
|
48
63
|
/** Whether a value names one of the {@link SITE_THEME_BASES}. */ export function isSiteThemeBase(value) {
|
|
49
64
|
return typeof value === 'string' && SITE_THEME_BASES.includes(value);
|
|
50
65
|
}
|