@aglyn/aglyn 1.12.0 → 1.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/package.json +11 -11
  2. package/src/lib/app-utils/docs-help-sections.generated.js +8 -2
  3. package/src/lib/app-utils/docs-help-sections.generated.js.map +1 -1
  4. package/src/lib/app-utils/docs-help.generated.d.ts +1 -1
  5. package/src/lib/app-utils/docs-help.generated.js +7 -0
  6. package/src/lib/app-utils/docs-help.generated.js.map +1 -1
  7. package/src/lib/app-utils/docs-index.generated.js +44 -30
  8. package/src/lib/app-utils/docs-index.generated.js.map +1 -1
  9. package/src/lib/app-utils/host-permissions.d.ts +12 -0
  10. package/src/lib/app-utils/host-permissions.js +26 -1
  11. package/src/lib/app-utils/host-permissions.js.map +1 -1
  12. package/src/lib/app-utils/media-asset-facts.d.ts +2 -2
  13. package/src/lib/app-utils/media-asset-facts.js +4 -3
  14. package/src/lib/app-utils/media-asset-facts.js.map +1 -1
  15. package/src/lib/app-utils/media-cdn-scope.d.ts +19 -4
  16. package/src/lib/app-utils/media-cdn-scope.js +19 -5
  17. package/src/lib/app-utils/media-cdn-scope.js.map +1 -1
  18. package/src/lib/app-utils/media-ref.d.ts +10 -6
  19. package/src/lib/app-utils/media-ref.js +34 -8
  20. package/src/lib/app-utils/media-ref.js.map +1 -1
  21. package/src/lib/app-utils/org-permissions.d.ts +7 -0
  22. package/src/lib/app-utils/org-permissions.js +2 -0
  23. package/src/lib/app-utils/org-permissions.js.map +1 -1
  24. package/src/lib/app-utils/org-role-grants.d.ts +7 -0
  25. package/src/lib/app-utils/org-role-grants.js +7 -5
  26. package/src/lib/app-utils/org-role-grants.js.map +1 -1
  27. package/src/lib/app-utils/scope-tokens.d.ts +132 -3
  28. package/src/lib/app-utils/scope-tokens.js +276 -3
  29. package/src/lib/app-utils/scope-tokens.js.map +1 -1
  30. package/src/lib/app-utils/site-placement.d.ts +56 -0
  31. package/src/lib/app-utils/site-placement.js +88 -0
  32. package/src/lib/app-utils/site-placement.js.map +1 -0
  33. package/src/lib/app-utils/transfer-launcher-context.d.ts +17 -1
  34. package/src/lib/app-utils/transfer-launcher-context.js.map +1 -1
  35. package/src/lib/data-transfer/access.d.ts +10 -18
  36. package/src/lib/data-transfer/access.js +21 -25
  37. package/src/lib/data-transfer/access.js.map +1 -1
  38. package/src/lib/data-transfer/resource.d.ts +13 -14
  39. package/src/lib/data-transfer/resource.js +9 -10
  40. package/src/lib/data-transfer/resource.js.map +1 -1
  41. package/src/lib/plugin-manager/first-party-plugins.generated.js +3 -4
  42. package/src/lib/plugin-manager/first-party-plugins.generated.js.map +1 -1
  43. package/src/lib/plugin-manager/plugin-entitlements.d.ts +12 -0
  44. package/src/lib/plugin-manager/plugin-entitlements.js +3 -1
  45. package/src/lib/plugin-manager/plugin-entitlements.js.map +1 -1
  46. package/src/lib/plugin-manager/plugin-scope-sharing.d.ts +52 -0
  47. package/src/lib/plugin-manager/plugin-scope-sharing.generated.d.ts +10 -0
  48. package/src/lib/plugin-manager/plugin-scope-sharing.generated.js +82 -0
  49. package/src/lib/plugin-manager/plugin-scope-sharing.generated.js.map +1 -0
  50. package/src/lib/plugin-manager/plugin-scope-sharing.js +85 -0
  51. package/src/lib/plugin-manager/plugin-scope-sharing.js.map +1 -0
  52. package/src/lib/plugin-manager/plugin-transfer-resources.d.ts +56 -1
  53. package/src/lib/plugin-manager/plugin-transfer-resources.js +13 -0
  54. package/src/lib/plugin-manager/plugin-transfer-resources.js.map +1 -1
@@ -186,6 +186,16 @@ export interface PluginOrgPermissionDeclaration {
186
186
  * key whose preset is the site role (`presetFromSiteRole`).
187
187
  */
188
188
  narrowsPerSite?: boolean | Partial<Record<OrgRole, boolean>>;
189
+ /**
190
+ * A site can also RAISE this key (AGL-4047). Where a member of the whole
191
+ * workspace has wider access to one site than their workspace role, the key
192
+ * reads `hostRoleDefaults` for that access there, unless a custom role or
193
+ * their own permissions decide it or the key it `follows`. For a key that
194
+ * narrows and raises with the site, which `presetFromSiteRole` cannot be:
195
+ * that gives up the workspace's verdict, and with it `narrowsPerSite`'s
196
+ * "Keep this permission". Needs `hostRoleDefaults`.
197
+ */
198
+ raisesPerSite?: boolean;
189
199
  /**
190
200
  * The key's preset is the member's role ON THE SITE, for every member
191
201
  * (AGL-4047), not only for a site collaborator: the owner and admins are
@@ -242,6 +252,8 @@ export interface PluginCatalogPermission {
242
252
  * default for whether it does, normalized from the declaration.
243
253
  */
244
254
  narrowsPerSite?: Readonly<Record<OrgRole, boolean>>;
255
+ /** A site can raise the key (AGL-4047); see the declaration's. */
256
+ raisesPerSite?: true;
245
257
  /** The key's preset is the member's role on the site (AGL-4047); see the declaration's. */
246
258
  presetFromSiteRole?: true;
247
259
  /** That preset holds for members of the whole workspace only (AGL-4047); see the declaration's. */
@@ -243,7 +243,9 @@ const reportedCatalogRefusals = new Set();
243
243
  presetFromSiteRole: true
244
244
  }, permission.workspaceMembersOnly ? {
245
245
  workspaceMembersOnly: true
246
- } : {}) : narrowingDefaultsOf(permission.narrowsPerSite)));
246
+ } : {}) : narrowingDefaultsOf(permission.narrowsPerSite), permission.raisesPerSite && permission.hostRoleDefaults && !permission.presetFromSiteRole ? {
247
+ raisesPerSite: true
248
+ } : {}));
247
249
  }
248
250
  for (const permission of listPluginPermissions()){
249
251
  var _permission_description, _permission_group1, _permission_groupLabel1;
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-entitlements.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 * Plugin-declared billing and access keys (AGL-2940).\n *\n * A plugin that sells something, gates something, or can be switched off in\n * an incident declares the KEYS here — a seat add-on, a feature flag, a\n * lockdown lever, a permission — and the core catalogs that used to be\n * edited for each one read the declarations instead:\n *\n * - `plan-entitlements` folds every registered seat add-on into\n * `resolveOrgEntitlements` (a quota raised per unit, features switched on)\n * and answers a registered feature's plan defaults;\n * - `lockdown` lists a registered lever on the staff page, carries its label,\n * its staff-bypass rule and its visitor notice, and maps the API paths it\n * names onto it for the plugin dispatcher;\n * - `plugin-permissions` receives the permissions with the owner filled in;\n * - `org-permissions` folds every declared catalog key into the org\n * permission catalog — the role editor, custom roles, per-member overrides\n * and the rules stamp — and `host-permissions` decides the keys that\n * declare host-role defaults for a site collaborator, per site.\n *\n * The NUMBERS stay where they are checked. A seat add-on's price is a row in\n * `PLAN_PRICING`, read by the Stripe wiring and reconciled by\n * `check-pricing-drift`; a declaration names the quota it widens and by how\n * much per plan, and nothing here restates a price.\n *\n * Registration order is deterministic: the catalog order of\n * `FIRST_PARTY_PLUGINS`, then any other id alphabetically. Plugin modules\n * load in parallel, so the order they REGISTER in is whatever the network\n * gave, and a list that followed it would put the staff lockdown checklist\n * in a different order per session.\n */\n\nimport type { AglynOrgBilling, HostAccessRole, OrgPlan, OrgRole } from '../foundation'\nimport { declarationRoleDefaults } from '../app-utils/org-role-grants'\nimport { FIRST_PARTY_PLUGINS } from './enabled-plugins'\nimport {\n listPluginPermissions,\n registerPluginPermissions,\n type PluginPermission,\n} from './plugin-permissions'\n\nexport interface PluginSeatAddonDeclaration {\n /** The `org.seatAddons` key the purchase is stored under (`aiAddon`). */\n key: string\n label: string\n /**\n * How many purchased units count. `1` for an org-wide add-on that is\n * bought once, where a doubled webhook item or a hand edit above one is\n * still one purchase; absent to count the stored quantity.\n */\n maxUnits?: number\n /**\n * The quota each unit widens: the resolved entitlement named by `key`\n * gains `perUnit(org, plan) × units` when the figure depends on WHAT was\n * bought (the Aglyn AI tier, AGL-3965), else `perUnitByPlan[plan] × units`.\n * A plan the add-on is not sold on answers 0.\n */\n quota?: {\n key: string\n perUnitByPlan?: Readonly<Record<OrgPlan, number>>\n /**\n * The per-unit figure read off the org itself. `org` is the billing\n * document as `resolveOrgEntitlements` received it and `plan` its\n * effective plan.\n */\n perUnit?: (org: Readonly<Partial<AglynOrgBilling>>, plan: OrgPlan) => number\n }\n /** Feature flags a purchased unit switches on. */\n features?: readonly string[]\n /**\n * Whether a plan sells the add-on, when `perUnitByPlan` cannot say so\n * (a `perUnit` quota, AGL-3965). Absent: sold where `perUnitByPlan` names\n * a figure above zero, or everywhere for an add-on with no quota.\n */\n soldOn?: (plan: OrgPlan) => boolean\n}\n\n/**\n * Whether a plan sells a declared seat add-on: its own `soldOn`, else a\n * `perUnitByPlan` figure above zero for the plan, else (no quota) yes.\n */\nexport function pluginSeatAddonSoldOn(\n addon: PluginSeatAddonDeclaration,\n plan: OrgPlan,\n): boolean {\n if (addon.soldOn) return addon.soldOn(plan)\n if (!addon.quota) return true\n return (addon.quota.perUnitByPlan?.[plan] ?? 0) > 0\n}\n\nexport interface PluginFeatureDeclaration {\n /** The `OrgFeatureFlags` key. */\n key: string\n label: string\n /**\n * The plan defaults, when the key is not one the plan tables already\n * carry. Absent means the plan tables decide, which is the case for every\n * key that predates this registry.\n */\n defaultByPlan?: Readonly<Partial<Record<OrgPlan, boolean>>>\n}\n\nexport interface PluginLockdownFeatureDeclaration {\n /** The lever's wire identity (`ai-generate`). */\n key: string\n /** The staff checklist's label. */\n label: string\n /**\n * What the lever is called in the customer's mail when staff pull it for\n * their workspace (`media uploads`, `AI generation`). A noun phrase that\n * reads right mid-sentence (\"our team paused media uploads\") and after a\n * colon, so lowercase unless it starts with a name or an acronym. The\n * staff `label` never reaches a customer.\n */\n customerName: string\n /**\n * Whether a verified staff claim passes the lock. Granted where a staff\n * action aids incident response — one real call proves a provider is back\n * — and withheld where the staff action would BE the incident.\n */\n staffBypass: boolean\n /**\n * What a visitor reads while the lever is pulled: what is paused AND what\n * still works. The expected-back window is appended by the notice builder.\n */\n notice: { title: string; body: string }\n /**\n * Plugin API paths the lever gates at the dispatcher: exact paths, and\n * prefixes matched on a segment boundary (`ai/generate` also gates\n * `ai/generate/section`, never `ai/generated-report`).\n */\n apiPaths?: { exact?: readonly string[]; prefixes?: readonly string[] }\n}\n\n/**\n * A key a plugin adds to the org permission CATALOG (AGL-2984): the granular\n * map custom roles and per-member overrides are stored in, that\n * `resolveOrgPermissions` layers and the rules stamp carries, and that the\n * role editor lists. A declared key is stored, layered and resolved exactly\n * like a core key; the declaration supplies what a core key's catalog entry\n * and role table supply.\n */\nexport interface PluginOrgPermissionDeclaration {\n /** The dotted key a custom role and a per-member override store (`reviews.reply`). */\n key: string\n /** The role editor's line for the key, and the word a refusal names. */\n label: string\n /** What the key opens, under the label in the role editor. */\n description: string\n /** Each org role's verdict when no custom role or per-member override sets the key. */\n roleDefaults: Readonly<Record<OrgRole, boolean>>\n /**\n * Each HOST role's verdict, for a key a site collaborator holds per site.\n *\n * A collaborator's membership carries no org standing to refine — it\n * exists only to carry access to named sites — so a key with this field is\n * decided for them on the site a request names: the host role they hold\n * there, refined by the per-site toggle on their member document. A key\n * without it is never held by a collaborator.\n */\n hostRoleDefaults?: Readonly<Record<HostAccessRole, boolean>>\n /**\n * The role editor's group for the key (AGL-4047): a core group id\n * (`CORE_ORG_PERMISSION_GROUPS`) or, absent, a group of the plugin's own.\n */\n group?: string\n /** The heading of a group of the plugin's own; absent: the plugin's catalog label. */\n groupLabel?: string\n /**\n * A broader key this one is a finer part of (AGL-4047): never granted\n * without it, and following it where nothing sets this key. See\n * `PluginPermission.refines`.\n */\n refines?: string\n /**\n * A key this one takes its verdict from where nothing sets it, without\n * needing it (AGL-4047). See `PluginPermission.follows`.\n */\n follows?: string\n /**\n * A site can narrow this key, and the built-in roles' default for whether\n * it does (AGL-4047). See `PluginPermission.narrowsPerSite`. Ignored on a\n * key whose preset is the site role (`presetFromSiteRole`).\n */\n narrowsPerSite?: boolean | Partial<Record<OrgRole, boolean>>\n /**\n * The key's preset is the member's role ON THE SITE, for every member\n * (AGL-4047), not only for a site collaborator: the owner and admins are\n * admins of every site, a workspace-wide editor or viewer holds their\n * workspace role on a site unless the site gives them other access there\n * (narrower or wider), and a collaborator holds their site role. So the\n * key reads `hostRoleDefaults` for whatever access the member has on the\n * site a request names, exactly as a gate on that host role did, and a\n * custom role, the member's own permissions and that site's toggle then\n * grant or refuse it like any other key. Needs `hostRoleDefaults`, and\n * `roleDefaults` that match them tier for tier (the owner and admins on\n * Admin, editors on Editor, viewers on Viewer), which is the answer with\n * no site named.\n *\n * For a key that replaces a gate on the site role (who may edit a site's\n * stays, say), so the built-in roles keep exactly the access they had\n * while the key becomes grantable and deniable like every other.\n */\n presetFromSiteRole?: boolean\n /**\n * With `presetFromSiteRole`: the site role is the preset only for a member\n * of the WHOLE workspace (AGL-4047). Someone added to one site only holds\n * the key there when the site's toggle grants it, whatever their site role,\n * and `hostRoleDefaults` is not their default. For a key that replaces a\n * gate asking for an admin of the whole workspace who is also this site's\n * admin (refunds, say): a site's Members card can make a contractor the\n * admin of one site, and that never carried those acts.\n */\n workspaceMembersOnly?: boolean\n}\n\n/**\n * One key of the ONE permission catalog that a plugin contributes (AGL-4047),\n * whichever of the two declaration APIs it came through:\n * `registerPluginEntitlements({ orgPermissions })` (`source: 'catalog'`) or\n * `registerPluginPermissions` (`source: 'tier'`, its per-tier defaults read\n * as org-role defaults, the owner on the admin tier).\n */\nexport interface PluginCatalogPermission {\n key: string\n label: string\n description: string\n pluginId: string\n roleDefaults: Readonly<Record<OrgRole, boolean>>\n hostRoleDefaults?: Readonly<Record<HostAccessRole, boolean>>\n group: string\n groupLabel: string\n source: 'catalog' | 'tier'\n /** The broader key this one refines, when it does. */\n refines?: string\n /** The key this one follows without needing it, when it does. */\n follows?: string\n /**\n * Present when a site can narrow the key (AGL-4047): each built-in role's\n * default for whether it does, normalized from the declaration.\n */\n narrowsPerSite?: Readonly<Record<OrgRole, boolean>>\n /** The key's preset is the member's role on the site (AGL-4047); see the declaration's. */\n presetFromSiteRole?: true\n /** That preset holds for members of the whole workspace only (AGL-4047); see the declaration's. */\n workspaceMembersOnly?: true\n}\n\nexport interface PluginEntitlementRegistration {\n pluginId: string\n seatAddons?: readonly PluginSeatAddonDeclaration[]\n features?: readonly PluginFeatureDeclaration[]\n lockdownFeatures?: readonly PluginLockdownFeatureDeclaration[]\n /** Per-tier keys a plugin's own pages read (`registerPluginPermissions`). */\n permissions?: readonly Omit<PluginPermission, 'pluginId'>[]\n /** Keys added to the org permission catalog — see {@link PluginOrgPermissionDeclaration}. */\n orgPermissions?: readonly PluginOrgPermissionDeclaration[]\n}\n\n/**\n * The registrations and their listeners, held on `globalThis` rather than in\n * module `const`s (AGL-3596), as the custom field registry and the\n * declarations repair hook are (AGL-3412).\n *\n * An app registers the plugins' declarations from `instrumentation.ts`, which\n * Next compiles into a different module graph from the routes. A module-scoped\n * map was filled in the instrumentation's copy and read empty in a route's, so\n * a core route that never loaded a plugin knew none of its keys: the site\n * create door asked for `ai.generate`, read `undefined` from a catalog that\n * had never heard of it, and every guided AI start was born with the starter.\n * One map per process, under a `Symbol.for` key, is the same map in every\n * copy.\n */\nconst REGISTRY_KEY = Symbol.for('@aglyn/aglyn:plugin-entitlements')\n\ninterface PluginEntitlementsRegistry {\n registrations: Map<string, PluginEntitlementRegistration>\n /**\n * Readers of the registrations that keep a derived view in step with them —\n * every copy of the org permission catalog rebuilds itself on every\n * registration and reset, because a plugin's declarations can register\n * after a module that imported the catalog was evaluated, and in another\n * module graph's copy of this file.\n */\n listeners: Set<() => void>\n}\n\nconst globalScope = globalThis as typeof globalThis & {\n [REGISTRY_KEY]?: PluginEntitlementsRegistry\n}\n\nconst registry: PluginEntitlementsRegistry = (globalScope[REGISTRY_KEY] ??= {\n registrations: new Map(),\n listeners: new Set(),\n})\n\nconst registrations = registry.registrations\nconst listeners = registry.listeners\n\n/** Calls `listener` after every registration and reset; answers the unsubscribe. */\nexport function subscribePluginEntitlements(listener: () => void): () => void {\n listeners.add(listener)\n return () => {\n listeners.delete(listener)\n }\n}\n\nfunction notifyListeners(): void {\n for (const listener of [...listeners]) listener()\n}\n\nconst CATALOG_ORDER = new Map(\n FIRST_PARTY_PLUGINS.map((plugin, index) => [plugin.id, index]),\n)\n\nfunction catalogRank(pluginId: string): number {\n return CATALOG_ORDER.get(pluginId) ?? Number.MAX_SAFE_INTEGER\n}\n\nfunction orderedRegistrations(): PluginEntitlementRegistration[] {\n return [...registrations.values()].sort(\n (a, b) =>\n catalogRank(a.pluginId) - catalogRank(b.pluginId) ||\n a.pluginId.localeCompare(b.pluginId),\n )\n}\n\nfunction refuseStolenKeys(\n pluginId: string,\n kind: 'seat add-on' | 'lockdown feature' | 'org permission',\n keys: readonly string[],\n ownerOf: (key: string) => string | undefined,\n): void {\n for (const key of keys) {\n const owner = ownerOf(key)\n if (owner && owner !== pluginId) {\n throw new Error(\n `${kind} \"${key}\" is already declared by \"${owner}\"; refused \"${pluginId}\"`,\n )\n }\n }\n}\n\n/**\n * Idempotent per plugin — re-registration replaces that plugin's\n * declarations. A seat add-on, lockdown or catalog permission key another\n * plugin already owns refuses the whole registration: one key, one owner,\n * or the two declarations disagree about what the key means.\n */\nexport function registerPluginEntitlements(\n registration: PluginEntitlementRegistration,\n): void {\n const pluginId = registration.pluginId.trim()\n if (!pluginId) throw new Error('plugin entitlements need a pluginId')\n refuseStolenKeys(\n pluginId,\n 'seat add-on',\n (registration.seatAddons ?? []).map((entry) => entry.key),\n (key) => pluginSeatAddonOwner(key),\n )\n refuseStolenKeys(\n pluginId,\n 'lockdown feature',\n (registration.lockdownFeatures ?? []).map((entry) => entry.key),\n (key) => pluginLockdownFeatureOwner(key),\n )\n refuseStolenKeys(\n pluginId,\n 'org permission',\n (registration.orgPermissions ?? []).map((entry) => entry.key),\n (key) => pluginOrgPermissionOwner(key) ?? pluginTierPermissionOwner(key),\n )\n registrations.set(pluginId, { ...registration, pluginId })\n if (registration.permissions?.length) {\n registerPluginPermissions(\n registration.permissions.map((permission) => ({ ...permission, pluginId })),\n )\n }\n notifyListeners()\n}\n\nfunction pluginSeatAddonOwner(key: string): string | undefined {\n for (const entry of registrations.values()) {\n if (entry.seatAddons?.some((addon) => addon.key === key)) return entry.pluginId\n }\n return undefined\n}\n\nfunction pluginLockdownFeatureOwner(key: string): string | undefined {\n for (const entry of registrations.values()) {\n if (entry.lockdownFeatures?.some((feature) => feature.key === key)) {\n return entry.pluginId\n }\n }\n return undefined\n}\n\nfunction pluginOrgPermissionOwner(key: string): string | undefined {\n for (const entry of registrations.values()) {\n if (entry.orgPermissions?.some((permission) => permission.key === key)) {\n return entry.pluginId\n }\n }\n return undefined\n}\n\nfunction pluginTierPermissionOwner(key: string): string | undefined {\n return listPluginPermissions().find((permission) => permission.key === key)?.pluginId\n}\n\n/** Refusals already logged by `listPluginCatalogPermissions`, so each is reported once. */\n// boot-registry: per copy — it only de-duplicates a warning; a second compiled copy logging the same refusal once more is harmless, and nothing reads it to decide anything.\nconst reportedCatalogRefusals = new Set<string>()\n\n/** A plugin's catalog label, the heading its own permission group carries. */\nfunction pluginLabel(pluginId: string): string {\n return FIRST_PARTY_PLUGINS.find((plugin) => plugin.id === pluginId)?.label ?? pluginId\n}\n\n/**\n * A declaration's `narrowsPerSite`, normalized to each built-in role's\n * default (AGL-4047): `true` or `false` names every role, a map names each,\n * a role it leaves out keeps. Absent: the key is not one a site can narrow.\n */\nfunction narrowingDefaultsOf(\n declared: boolean | Partial<Record<OrgRole, boolean>> | undefined,\n): { narrowsPerSite?: Readonly<Record<OrgRole, boolean>> } {\n if (declared === undefined || declared === null) return {}\n const every = typeof declared === 'boolean' ? declared : undefined\n const map = typeof declared === 'object' ? declared : {}\n return {\n narrowsPerSite: {\n owner: every ?? map.owner === true,\n admin: every ?? map.admin === true,\n editor: every ?? map.editor === true,\n viewer: every ?? map.viewer === true,\n },\n }\n}\n\n/**\n * Every key plugins contribute to the permission catalog, through EITHER\n * declaration API, in catalog order (AGL-4047): per plugin, its\n * `orgPermissions` declarations and then its `registerPluginPermissions`\n * keys. A key both APIs carry for the same plugin is the catalog\n * declaration's; one a DIFFERENT plugin already declared is refused and\n * logged once, the first declaration keeping its meaning and defaults.\n *\n * Read live: both registries fill at plugin module scope, which can be after\n * any reader of this was evaluated.\n */\nexport function listPluginCatalogPermissions(): PluginCatalogPermission[] {\n const byPlugin = new Map<string, PluginCatalogPermission[]>()\n const owner = new Map<string, string>()\n const add = (entry: PluginCatalogPermission): void => {\n const incumbent = owner.get(entry.key)\n if (incumbent !== undefined) {\n if (incumbent !== entry.pluginId) {\n const refusal = `${entry.pluginId}\\x00${entry.key}`\n if (!reportedCatalogRefusals.has(refusal)) {\n reportedCatalogRefusals.add(refusal)\n console.error(\n `[plugins] refused permission key \"${entry.key}\" to \"${entry.pluginId}\": ` +\n `already declared by \"${incumbent}\"`,\n )\n }\n }\n return\n }\n owner.set(entry.key, entry.pluginId)\n const list = byPlugin.get(entry.pluginId) ?? []\n list.push(entry)\n byPlugin.set(entry.pluginId, list)\n }\n for (const permission of listPluginOrgPermissions()) {\n add({\n key: permission.key,\n label: permission.label,\n description: permission.description,\n pluginId: permission.pluginId,\n roleDefaults: declarationRoleDefaults(permission),\n ...(permission.hostRoleDefaults ? { hostRoleDefaults: permission.hostRoleDefaults } : {}),\n group: permission.group ?? permission.pluginId,\n groupLabel: permission.groupLabel ?? pluginLabel(permission.pluginId),\n source: 'catalog',\n ...(permission.refines ? { refines: permission.refines } : {}),\n ...(permission.follows ? { follows: permission.follows } : {}),\n // A key whose preset is the site role follows every site's access\n // already, so it offers no narrowing control (AGL-4047).\n ...(permission.presetFromSiteRole && permission.hostRoleDefaults\n ? {\n presetFromSiteRole: true as const,\n ...(permission.workspaceMembersOnly ? { workspaceMembersOnly: true as const } : {}),\n }\n : narrowingDefaultsOf(permission.narrowsPerSite)),\n })\n }\n for (const permission of listPluginPermissions()) {\n add({\n key: permission.key,\n label: permission.label,\n description: permission.description ?? '',\n pluginId: permission.pluginId,\n roleDefaults: declarationRoleDefaults(permission),\n group: permission.group ?? permission.pluginId,\n groupLabel: permission.groupLabel ?? pluginLabel(permission.pluginId),\n source: 'tier',\n ...(permission.refines ? { refines: permission.refines } : {}),\n ...(permission.follows ? { follows: permission.follows } : {}),\n ...narrowingDefaultsOf(permission.narrowsPerSite),\n })\n }\n return [...byPlugin.keys()]\n .sort((a, b) => catalogRank(a) - catalogRank(b) || a.localeCompare(b))\n .flatMap((pluginId) => byPlugin.get(pluginId) ?? [])\n}\n\n/** Every declared catalog permission, in catalog order, with the plugin that declared it. */\nexport function listPluginOrgPermissions(): Array<\n PluginOrgPermissionDeclaration & { pluginId: string }\n> {\n return orderedRegistrations().flatMap((entry) =>\n (entry.orgPermissions ?? []).map((permission) => ({\n ...permission,\n pluginId: entry.pluginId,\n })),\n )\n}\n\n/** Every declared seat add-on, in catalog order. */\nexport function listPluginSeatAddons(): PluginSeatAddonDeclaration[] {\n return orderedRegistrations().flatMap((entry) => [...(entry.seatAddons ?? [])])\n}\n\n/** One declared seat add-on by its `seatAddons` key. */\nexport function pluginSeatAddon(key: string): PluginSeatAddonDeclaration | undefined {\n return listPluginSeatAddons().find((entry) => entry.key === key)\n}\n\n/** Every declared feature, in catalog order. */\nexport function listPluginFeatures(): PluginFeatureDeclaration[] {\n return orderedRegistrations().flatMap((entry) => [...(entry.features ?? [])])\n}\n\n/** Every declared lockdown lever, in catalog order. */\nexport function listPluginLockdownFeatures(): PluginLockdownFeatureDeclaration[] {\n return orderedRegistrations().flatMap((entry) => [\n ...(entry.lockdownFeatures ?? []),\n ])\n}\n\n/** One declared lockdown lever by key. */\nexport function pluginLockdownFeature(\n key: string,\n): PluginLockdownFeatureDeclaration | undefined {\n return listPluginLockdownFeatures().find((entry) => entry.key === key)\n}\n\n/** The plugin that declared a lockdown lever, for attribution. */\nexport function pluginIdForLockdownFeature(key: string): string | undefined {\n return pluginLockdownFeatureOwner(key)\n}\n\n/** Every registration, in catalog order. */\nexport function listPluginEntitlementRegistrations(): PluginEntitlementRegistration[] {\n return orderedRegistrations()\n}\n\n/**\n * Test seam: forget every registration. The per-tier permissions stay\n * registered; the catalog permissions go with their registrations.\n */\nexport function resetPluginEntitlementsForTests(): void {\n registrations.clear()\n notifyListeners()\n}\n"],"names":["globalScope","REGISTRY_KEY","declarationRoleDefaults","FIRST_PARTY_PLUGINS","listPluginPermissions","registerPluginPermissions","pluginSeatAddonSoldOn","addon","plan","soldOn","quota","perUnitByPlan","Symbol","for","globalThis","registry","registrations","Map","listeners","Set","subscribePluginEntitlements","listener","add","delete","notifyListeners","CATALOG_ORDER","map","plugin","index","id","catalogRank","pluginId","get","Number","MAX_SAFE_INTEGER","orderedRegistrations","values","sort","a","b","localeCompare","refuseStolenKeys","kind","keys","ownerOf","key","owner","Error","registerPluginEntitlements","registration","trim","seatAddons","entry","pluginSeatAddonOwner","lockdownFeatures","pluginLockdownFeatureOwner","orgPermissions","pluginOrgPermissionOwner","pluginTierPermissionOwner","set","permissions","length","permission","some","undefined","feature","find","reportedCatalogRefusals","pluginLabel","label","narrowingDefaultsOf","declared","every","narrowsPerSite","admin","editor","viewer","listPluginCatalogPermissions","byPlugin","incumbent","refusal","has","console","error","list","push","listPluginOrgPermissions","description","roleDefaults","hostRoleDefaults","group","groupLabel","source","refines","follows","presetFromSiteRole","workspaceMembersOnly","flatMap","listPluginSeatAddons","pluginSeatAddon","listPluginFeatures","features","listPluginLockdownFeatures","pluginLockdownFeature","pluginIdForLockdownFeature","listPluginEntitlementRegistrations","resetPluginEntitlementsForTests","clear"],"mappings":"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"}
1
+ {"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-entitlements.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 * Plugin-declared billing and access keys (AGL-2940).\n *\n * A plugin that sells something, gates something, or can be switched off in\n * an incident declares the KEYS here — a seat add-on, a feature flag, a\n * lockdown lever, a permission — and the core catalogs that used to be\n * edited for each one read the declarations instead:\n *\n * - `plan-entitlements` folds every registered seat add-on into\n * `resolveOrgEntitlements` (a quota raised per unit, features switched on)\n * and answers a registered feature's plan defaults;\n * - `lockdown` lists a registered lever on the staff page, carries its label,\n * its staff-bypass rule and its visitor notice, and maps the API paths it\n * names onto it for the plugin dispatcher;\n * - `plugin-permissions` receives the permissions with the owner filled in;\n * - `org-permissions` folds every declared catalog key into the org\n * permission catalog — the role editor, custom roles, per-member overrides\n * and the rules stamp — and `host-permissions` decides the keys that\n * declare host-role defaults for a site collaborator, per site.\n *\n * The NUMBERS stay where they are checked. A seat add-on's price is a row in\n * `PLAN_PRICING`, read by the Stripe wiring and reconciled by\n * `check-pricing-drift`; a declaration names the quota it widens and by how\n * much per plan, and nothing here restates a price.\n *\n * Registration order is deterministic: the catalog order of\n * `FIRST_PARTY_PLUGINS`, then any other id alphabetically. Plugin modules\n * load in parallel, so the order they REGISTER in is whatever the network\n * gave, and a list that followed it would put the staff lockdown checklist\n * in a different order per session.\n */\n\nimport type { AglynOrgBilling, HostAccessRole, OrgPlan, OrgRole } from '../foundation'\nimport { declarationRoleDefaults } from '../app-utils/org-role-grants'\nimport { FIRST_PARTY_PLUGINS } from './enabled-plugins'\nimport {\n listPluginPermissions,\n registerPluginPermissions,\n type PluginPermission,\n} from './plugin-permissions'\n\nexport interface PluginSeatAddonDeclaration {\n /** The `org.seatAddons` key the purchase is stored under (`aiAddon`). */\n key: string\n label: string\n /**\n * How many purchased units count. `1` for an org-wide add-on that is\n * bought once, where a doubled webhook item or a hand edit above one is\n * still one purchase; absent to count the stored quantity.\n */\n maxUnits?: number\n /**\n * The quota each unit widens: the resolved entitlement named by `key`\n * gains `perUnit(org, plan) × units` when the figure depends on WHAT was\n * bought (the Aglyn AI tier, AGL-3965), else `perUnitByPlan[plan] × units`.\n * A plan the add-on is not sold on answers 0.\n */\n quota?: {\n key: string\n perUnitByPlan?: Readonly<Record<OrgPlan, number>>\n /**\n * The per-unit figure read off the org itself. `org` is the billing\n * document as `resolveOrgEntitlements` received it and `plan` its\n * effective plan.\n */\n perUnit?: (org: Readonly<Partial<AglynOrgBilling>>, plan: OrgPlan) => number\n }\n /** Feature flags a purchased unit switches on. */\n features?: readonly string[]\n /**\n * Whether a plan sells the add-on, when `perUnitByPlan` cannot say so\n * (a `perUnit` quota, AGL-3965). Absent: sold where `perUnitByPlan` names\n * a figure above zero, or everywhere for an add-on with no quota.\n */\n soldOn?: (plan: OrgPlan) => boolean\n}\n\n/**\n * Whether a plan sells a declared seat add-on: its own `soldOn`, else a\n * `perUnitByPlan` figure above zero for the plan, else (no quota) yes.\n */\nexport function pluginSeatAddonSoldOn(\n addon: PluginSeatAddonDeclaration,\n plan: OrgPlan,\n): boolean {\n if (addon.soldOn) return addon.soldOn(plan)\n if (!addon.quota) return true\n return (addon.quota.perUnitByPlan?.[plan] ?? 0) > 0\n}\n\nexport interface PluginFeatureDeclaration {\n /** The `OrgFeatureFlags` key. */\n key: string\n label: string\n /**\n * The plan defaults, when the key is not one the plan tables already\n * carry. Absent means the plan tables decide, which is the case for every\n * key that predates this registry.\n */\n defaultByPlan?: Readonly<Partial<Record<OrgPlan, boolean>>>\n}\n\nexport interface PluginLockdownFeatureDeclaration {\n /** The lever's wire identity (`ai-generate`). */\n key: string\n /** The staff checklist's label. */\n label: string\n /**\n * What the lever is called in the customer's mail when staff pull it for\n * their workspace (`media uploads`, `AI generation`). A noun phrase that\n * reads right mid-sentence (\"our team paused media uploads\") and after a\n * colon, so lowercase unless it starts with a name or an acronym. The\n * staff `label` never reaches a customer.\n */\n customerName: string\n /**\n * Whether a verified staff claim passes the lock. Granted where a staff\n * action aids incident response — one real call proves a provider is back\n * — and withheld where the staff action would BE the incident.\n */\n staffBypass: boolean\n /**\n * What a visitor reads while the lever is pulled: what is paused AND what\n * still works. The expected-back window is appended by the notice builder.\n */\n notice: { title: string; body: string }\n /**\n * Plugin API paths the lever gates at the dispatcher: exact paths, and\n * prefixes matched on a segment boundary (`ai/generate` also gates\n * `ai/generate/section`, never `ai/generated-report`).\n */\n apiPaths?: { exact?: readonly string[]; prefixes?: readonly string[] }\n}\n\n/**\n * A key a plugin adds to the org permission CATALOG (AGL-2984): the granular\n * map custom roles and per-member overrides are stored in, that\n * `resolveOrgPermissions` layers and the rules stamp carries, and that the\n * role editor lists. A declared key is stored, layered and resolved exactly\n * like a core key; the declaration supplies what a core key's catalog entry\n * and role table supply.\n */\nexport interface PluginOrgPermissionDeclaration {\n /** The dotted key a custom role and a per-member override store (`reviews.reply`). */\n key: string\n /** The role editor's line for the key, and the word a refusal names. */\n label: string\n /** What the key opens, under the label in the role editor. */\n description: string\n /** Each org role's verdict when no custom role or per-member override sets the key. */\n roleDefaults: Readonly<Record<OrgRole, boolean>>\n /**\n * Each HOST role's verdict, for a key a site collaborator holds per site.\n *\n * A collaborator's membership carries no org standing to refine — it\n * exists only to carry access to named sites — so a key with this field is\n * decided for them on the site a request names: the host role they hold\n * there, refined by the per-site toggle on their member document. A key\n * without it is never held by a collaborator.\n */\n hostRoleDefaults?: Readonly<Record<HostAccessRole, boolean>>\n /**\n * The role editor's group for the key (AGL-4047): a core group id\n * (`CORE_ORG_PERMISSION_GROUPS`) or, absent, a group of the plugin's own.\n */\n group?: string\n /** The heading of a group of the plugin's own; absent: the plugin's catalog label. */\n groupLabel?: string\n /**\n * A broader key this one is a finer part of (AGL-4047): never granted\n * without it, and following it where nothing sets this key. See\n * `PluginPermission.refines`.\n */\n refines?: string\n /**\n * A key this one takes its verdict from where nothing sets it, without\n * needing it (AGL-4047). See `PluginPermission.follows`.\n */\n follows?: string\n /**\n * A site can narrow this key, and the built-in roles' default for whether\n * it does (AGL-4047). See `PluginPermission.narrowsPerSite`. Ignored on a\n * key whose preset is the site role (`presetFromSiteRole`).\n */\n narrowsPerSite?: boolean | Partial<Record<OrgRole, boolean>>\n /**\n * A site can also RAISE this key (AGL-4047). Where a member of the whole\n * workspace has wider access to one site than their workspace role, the key\n * reads `hostRoleDefaults` for that access there, unless a custom role or\n * their own permissions decide it or the key it `follows`. For a key that\n * narrows and raises with the site, which `presetFromSiteRole` cannot be:\n * that gives up the workspace's verdict, and with it `narrowsPerSite`'s\n * \"Keep this permission\". Needs `hostRoleDefaults`.\n */\n raisesPerSite?: boolean\n /**\n * The key's preset is the member's role ON THE SITE, for every member\n * (AGL-4047), not only for a site collaborator: the owner and admins are\n * admins of every site, a workspace-wide editor or viewer holds their\n * workspace role on a site unless the site gives them other access there\n * (narrower or wider), and a collaborator holds their site role. So the\n * key reads `hostRoleDefaults` for whatever access the member has on the\n * site a request names, exactly as a gate on that host role did, and a\n * custom role, the member's own permissions and that site's toggle then\n * grant or refuse it like any other key. Needs `hostRoleDefaults`, and\n * `roleDefaults` that match them tier for tier (the owner and admins on\n * Admin, editors on Editor, viewers on Viewer), which is the answer with\n * no site named.\n *\n * For a key that replaces a gate on the site role (who may edit a site's\n * stays, say), so the built-in roles keep exactly the access they had\n * while the key becomes grantable and deniable like every other.\n */\n presetFromSiteRole?: boolean\n /**\n * With `presetFromSiteRole`: the site role is the preset only for a member\n * of the WHOLE workspace (AGL-4047). Someone added to one site only holds\n * the key there when the site's toggle grants it, whatever their site role,\n * and `hostRoleDefaults` is not their default. For a key that replaces a\n * gate asking for an admin of the whole workspace who is also this site's\n * admin (refunds, say): a site's Members card can make a contractor the\n * admin of one site, and that never carried those acts.\n */\n workspaceMembersOnly?: boolean\n}\n\n/**\n * One key of the ONE permission catalog that a plugin contributes (AGL-4047),\n * whichever of the two declaration APIs it came through:\n * `registerPluginEntitlements({ orgPermissions })` (`source: 'catalog'`) or\n * `registerPluginPermissions` (`source: 'tier'`, its per-tier defaults read\n * as org-role defaults, the owner on the admin tier).\n */\nexport interface PluginCatalogPermission {\n key: string\n label: string\n description: string\n pluginId: string\n roleDefaults: Readonly<Record<OrgRole, boolean>>\n hostRoleDefaults?: Readonly<Record<HostAccessRole, boolean>>\n group: string\n groupLabel: string\n source: 'catalog' | 'tier'\n /** The broader key this one refines, when it does. */\n refines?: string\n /** The key this one follows without needing it, when it does. */\n follows?: string\n /**\n * Present when a site can narrow the key (AGL-4047): each built-in role's\n * default for whether it does, normalized from the declaration.\n */\n narrowsPerSite?: Readonly<Record<OrgRole, boolean>>\n /** A site can raise the key (AGL-4047); see the declaration's. */\n raisesPerSite?: true\n /** The key's preset is the member's role on the site (AGL-4047); see the declaration's. */\n presetFromSiteRole?: true\n /** That preset holds for members of the whole workspace only (AGL-4047); see the declaration's. */\n workspaceMembersOnly?: true\n}\n\nexport interface PluginEntitlementRegistration {\n pluginId: string\n seatAddons?: readonly PluginSeatAddonDeclaration[]\n features?: readonly PluginFeatureDeclaration[]\n lockdownFeatures?: readonly PluginLockdownFeatureDeclaration[]\n /** Per-tier keys a plugin's own pages read (`registerPluginPermissions`). */\n permissions?: readonly Omit<PluginPermission, 'pluginId'>[]\n /** Keys added to the org permission catalog — see {@link PluginOrgPermissionDeclaration}. */\n orgPermissions?: readonly PluginOrgPermissionDeclaration[]\n}\n\n/**\n * The registrations and their listeners, held on `globalThis` rather than in\n * module `const`s (AGL-3596), as the custom field registry and the\n * declarations repair hook are (AGL-3412).\n *\n * An app registers the plugins' declarations from `instrumentation.ts`, which\n * Next compiles into a different module graph from the routes. A module-scoped\n * map was filled in the instrumentation's copy and read empty in a route's, so\n * a core route that never loaded a plugin knew none of its keys: the site\n * create door asked for `ai.generate`, read `undefined` from a catalog that\n * had never heard of it, and every guided AI start was born with the starter.\n * One map per process, under a `Symbol.for` key, is the same map in every\n * copy.\n */\nconst REGISTRY_KEY = Symbol.for('@aglyn/aglyn:plugin-entitlements')\n\ninterface PluginEntitlementsRegistry {\n registrations: Map<string, PluginEntitlementRegistration>\n /**\n * Readers of the registrations that keep a derived view in step with them —\n * every copy of the org permission catalog rebuilds itself on every\n * registration and reset, because a plugin's declarations can register\n * after a module that imported the catalog was evaluated, and in another\n * module graph's copy of this file.\n */\n listeners: Set<() => void>\n}\n\nconst globalScope = globalThis as typeof globalThis & {\n [REGISTRY_KEY]?: PluginEntitlementsRegistry\n}\n\nconst registry: PluginEntitlementsRegistry = (globalScope[REGISTRY_KEY] ??= {\n registrations: new Map(),\n listeners: new Set(),\n})\n\nconst registrations = registry.registrations\nconst listeners = registry.listeners\n\n/** Calls `listener` after every registration and reset; answers the unsubscribe. */\nexport function subscribePluginEntitlements(listener: () => void): () => void {\n listeners.add(listener)\n return () => {\n listeners.delete(listener)\n }\n}\n\nfunction notifyListeners(): void {\n for (const listener of [...listeners]) listener()\n}\n\nconst CATALOG_ORDER = new Map(\n FIRST_PARTY_PLUGINS.map((plugin, index) => [plugin.id, index]),\n)\n\nfunction catalogRank(pluginId: string): number {\n return CATALOG_ORDER.get(pluginId) ?? Number.MAX_SAFE_INTEGER\n}\n\nfunction orderedRegistrations(): PluginEntitlementRegistration[] {\n return [...registrations.values()].sort(\n (a, b) =>\n catalogRank(a.pluginId) - catalogRank(b.pluginId) ||\n a.pluginId.localeCompare(b.pluginId),\n )\n}\n\nfunction refuseStolenKeys(\n pluginId: string,\n kind: 'seat add-on' | 'lockdown feature' | 'org permission',\n keys: readonly string[],\n ownerOf: (key: string) => string | undefined,\n): void {\n for (const key of keys) {\n const owner = ownerOf(key)\n if (owner && owner !== pluginId) {\n throw new Error(\n `${kind} \"${key}\" is already declared by \"${owner}\"; refused \"${pluginId}\"`,\n )\n }\n }\n}\n\n/**\n * Idempotent per plugin — re-registration replaces that plugin's\n * declarations. A seat add-on, lockdown or catalog permission key another\n * plugin already owns refuses the whole registration: one key, one owner,\n * or the two declarations disagree about what the key means.\n */\nexport function registerPluginEntitlements(\n registration: PluginEntitlementRegistration,\n): void {\n const pluginId = registration.pluginId.trim()\n if (!pluginId) throw new Error('plugin entitlements need a pluginId')\n refuseStolenKeys(\n pluginId,\n 'seat add-on',\n (registration.seatAddons ?? []).map((entry) => entry.key),\n (key) => pluginSeatAddonOwner(key),\n )\n refuseStolenKeys(\n pluginId,\n 'lockdown feature',\n (registration.lockdownFeatures ?? []).map((entry) => entry.key),\n (key) => pluginLockdownFeatureOwner(key),\n )\n refuseStolenKeys(\n pluginId,\n 'org permission',\n (registration.orgPermissions ?? []).map((entry) => entry.key),\n (key) => pluginOrgPermissionOwner(key) ?? pluginTierPermissionOwner(key),\n )\n registrations.set(pluginId, { ...registration, pluginId })\n if (registration.permissions?.length) {\n registerPluginPermissions(\n registration.permissions.map((permission) => ({ ...permission, pluginId })),\n )\n }\n notifyListeners()\n}\n\nfunction pluginSeatAddonOwner(key: string): string | undefined {\n for (const entry of registrations.values()) {\n if (entry.seatAddons?.some((addon) => addon.key === key)) return entry.pluginId\n }\n return undefined\n}\n\nfunction pluginLockdownFeatureOwner(key: string): string | undefined {\n for (const entry of registrations.values()) {\n if (entry.lockdownFeatures?.some((feature) => feature.key === key)) {\n return entry.pluginId\n }\n }\n return undefined\n}\n\nfunction pluginOrgPermissionOwner(key: string): string | undefined {\n for (const entry of registrations.values()) {\n if (entry.orgPermissions?.some((permission) => permission.key === key)) {\n return entry.pluginId\n }\n }\n return undefined\n}\n\nfunction pluginTierPermissionOwner(key: string): string | undefined {\n return listPluginPermissions().find((permission) => permission.key === key)?.pluginId\n}\n\n/** Refusals already logged by `listPluginCatalogPermissions`, so each is reported once. */\n// boot-registry: per copy — it only de-duplicates a warning; a second compiled copy logging the same refusal once more is harmless, and nothing reads it to decide anything.\nconst reportedCatalogRefusals = new Set<string>()\n\n/** A plugin's catalog label, the heading its own permission group carries. */\nfunction pluginLabel(pluginId: string): string {\n return FIRST_PARTY_PLUGINS.find((plugin) => plugin.id === pluginId)?.label ?? pluginId\n}\n\n/**\n * A declaration's `narrowsPerSite`, normalized to each built-in role's\n * default (AGL-4047): `true` or `false` names every role, a map names each,\n * a role it leaves out keeps. Absent: the key is not one a site can narrow.\n */\nfunction narrowingDefaultsOf(\n declared: boolean | Partial<Record<OrgRole, boolean>> | undefined,\n): { narrowsPerSite?: Readonly<Record<OrgRole, boolean>> } {\n if (declared === undefined || declared === null) return {}\n const every = typeof declared === 'boolean' ? declared : undefined\n const map = typeof declared === 'object' ? declared : {}\n return {\n narrowsPerSite: {\n owner: every ?? map.owner === true,\n admin: every ?? map.admin === true,\n editor: every ?? map.editor === true,\n viewer: every ?? map.viewer === true,\n },\n }\n}\n\n/**\n * Every key plugins contribute to the permission catalog, through EITHER\n * declaration API, in catalog order (AGL-4047): per plugin, its\n * `orgPermissions` declarations and then its `registerPluginPermissions`\n * keys. A key both APIs carry for the same plugin is the catalog\n * declaration's; one a DIFFERENT plugin already declared is refused and\n * logged once, the first declaration keeping its meaning and defaults.\n *\n * Read live: both registries fill at plugin module scope, which can be after\n * any reader of this was evaluated.\n */\nexport function listPluginCatalogPermissions(): PluginCatalogPermission[] {\n const byPlugin = new Map<string, PluginCatalogPermission[]>()\n const owner = new Map<string, string>()\n const add = (entry: PluginCatalogPermission): void => {\n const incumbent = owner.get(entry.key)\n if (incumbent !== undefined) {\n if (incumbent !== entry.pluginId) {\n const refusal = `${entry.pluginId}\\x00${entry.key}`\n if (!reportedCatalogRefusals.has(refusal)) {\n reportedCatalogRefusals.add(refusal)\n console.error(\n `[plugins] refused permission key \"${entry.key}\" to \"${entry.pluginId}\": ` +\n `already declared by \"${incumbent}\"`,\n )\n }\n }\n return\n }\n owner.set(entry.key, entry.pluginId)\n const list = byPlugin.get(entry.pluginId) ?? []\n list.push(entry)\n byPlugin.set(entry.pluginId, list)\n }\n for (const permission of listPluginOrgPermissions()) {\n add({\n key: permission.key,\n label: permission.label,\n description: permission.description,\n pluginId: permission.pluginId,\n roleDefaults: declarationRoleDefaults(permission),\n ...(permission.hostRoleDefaults ? { hostRoleDefaults: permission.hostRoleDefaults } : {}),\n group: permission.group ?? permission.pluginId,\n groupLabel: permission.groupLabel ?? pluginLabel(permission.pluginId),\n source: 'catalog',\n ...(permission.refines ? { refines: permission.refines } : {}),\n ...(permission.follows ? { follows: permission.follows } : {}),\n // A key whose preset is the site role follows every site's access\n // already, so it offers no narrowing control (AGL-4047).\n ...(permission.presetFromSiteRole && permission.hostRoleDefaults\n ? {\n presetFromSiteRole: true as const,\n ...(permission.workspaceMembersOnly ? { workspaceMembersOnly: true as const } : {}),\n }\n : narrowingDefaultsOf(permission.narrowsPerSite)),\n ...(permission.raisesPerSite && permission.hostRoleDefaults && !permission.presetFromSiteRole\n ? { raisesPerSite: true as const }\n : {}),\n })\n }\n for (const permission of listPluginPermissions()) {\n add({\n key: permission.key,\n label: permission.label,\n description: permission.description ?? '',\n pluginId: permission.pluginId,\n roleDefaults: declarationRoleDefaults(permission),\n group: permission.group ?? permission.pluginId,\n groupLabel: permission.groupLabel ?? pluginLabel(permission.pluginId),\n source: 'tier',\n ...(permission.refines ? { refines: permission.refines } : {}),\n ...(permission.follows ? { follows: permission.follows } : {}),\n ...narrowingDefaultsOf(permission.narrowsPerSite),\n })\n }\n return [...byPlugin.keys()]\n .sort((a, b) => catalogRank(a) - catalogRank(b) || a.localeCompare(b))\n .flatMap((pluginId) => byPlugin.get(pluginId) ?? [])\n}\n\n/** Every declared catalog permission, in catalog order, with the plugin that declared it. */\nexport function listPluginOrgPermissions(): Array<\n PluginOrgPermissionDeclaration & { pluginId: string }\n> {\n return orderedRegistrations().flatMap((entry) =>\n (entry.orgPermissions ?? []).map((permission) => ({\n ...permission,\n pluginId: entry.pluginId,\n })),\n )\n}\n\n/** Every declared seat add-on, in catalog order. */\nexport function listPluginSeatAddons(): PluginSeatAddonDeclaration[] {\n return orderedRegistrations().flatMap((entry) => [...(entry.seatAddons ?? [])])\n}\n\n/** One declared seat add-on by its `seatAddons` key. */\nexport function pluginSeatAddon(key: string): PluginSeatAddonDeclaration | undefined {\n return listPluginSeatAddons().find((entry) => entry.key === key)\n}\n\n/** Every declared feature, in catalog order. */\nexport function listPluginFeatures(): PluginFeatureDeclaration[] {\n return orderedRegistrations().flatMap((entry) => [...(entry.features ?? [])])\n}\n\n/** Every declared lockdown lever, in catalog order. */\nexport function listPluginLockdownFeatures(): PluginLockdownFeatureDeclaration[] {\n return orderedRegistrations().flatMap((entry) => [\n ...(entry.lockdownFeatures ?? []),\n ])\n}\n\n/** One declared lockdown lever by key. */\nexport function pluginLockdownFeature(\n key: string,\n): PluginLockdownFeatureDeclaration | undefined {\n return listPluginLockdownFeatures().find((entry) => entry.key === key)\n}\n\n/** The plugin that declared a lockdown lever, for attribution. */\nexport function pluginIdForLockdownFeature(key: string): string | undefined {\n return pluginLockdownFeatureOwner(key)\n}\n\n/** Every registration, in catalog order. */\nexport function listPluginEntitlementRegistrations(): PluginEntitlementRegistration[] {\n return orderedRegistrations()\n}\n\n/**\n * Test seam: forget every registration. The per-tier permissions stay\n * registered; the catalog permissions go with their registrations.\n */\nexport function resetPluginEntitlementsForTests(): void {\n registrations.clear()\n notifyListeners()\n}\n"],"names":["globalScope","REGISTRY_KEY","declarationRoleDefaults","FIRST_PARTY_PLUGINS","listPluginPermissions","registerPluginPermissions","pluginSeatAddonSoldOn","addon","plan","soldOn","quota","perUnitByPlan","Symbol","for","globalThis","registry","registrations","Map","listeners","Set","subscribePluginEntitlements","listener","add","delete","notifyListeners","CATALOG_ORDER","map","plugin","index","id","catalogRank","pluginId","get","Number","MAX_SAFE_INTEGER","orderedRegistrations","values","sort","a","b","localeCompare","refuseStolenKeys","kind","keys","ownerOf","key","owner","Error","registerPluginEntitlements","registration","trim","seatAddons","entry","pluginSeatAddonOwner","lockdownFeatures","pluginLockdownFeatureOwner","orgPermissions","pluginOrgPermissionOwner","pluginTierPermissionOwner","set","permissions","length","permission","some","undefined","feature","find","reportedCatalogRefusals","pluginLabel","label","narrowingDefaultsOf","declared","every","narrowsPerSite","admin","editor","viewer","listPluginCatalogPermissions","byPlugin","incumbent","refusal","has","console","error","list","push","listPluginOrgPermissions","description","roleDefaults","hostRoleDefaults","group","groupLabel","source","refines","follows","presetFromSiteRole","workspaceMembersOnly","raisesPerSite","flatMap","listPluginSeatAddons","pluginSeatAddon","listPluginFeatures","features","listPluginLockdownFeatures","pluginLockdownFeature","pluginIdForLockdownFeature","listPluginEntitlementRegistrations","resetPluginEntitlementsForTests","clear"],"mappings":"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"}
@@ -0,0 +1,52 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Aglyn LLC
4
+ *
5
+ * Licensed under the Apache License, Version 2.0 (the "License");
6
+ * you may not use this file except in compliance with the License.
7
+ * You may obtain a copy of the License at
8
+ *
9
+ * http://www.apache.org/licenses/LICENSE-2.0
10
+ *
11
+ * Unless required by applicable law or agreed to in writing, software
12
+ * distributed under the License is distributed on an "AS IS" BASIS,
13
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ * See the License for the specific language governing permissions and
15
+ * limitations under the License.
16
+ */
17
+ /** One collection under `orgs/{orgId}` whose documents can be all-except. */
18
+ export interface ScopeSharingCollection {
19
+ /** The subcollection, spelled as Firestore holds it. */
20
+ name: string;
21
+ /** Stored fields follow `visibleTo`: a patch function is registered. */
22
+ patch?: boolean;
23
+ /** The most sites one document may reach; past it the list stops widening. */
24
+ maxIncluded?: number;
25
+ /** Fields naming sites that stay included though they are excluded. */
26
+ keepSiteFields?: string[];
27
+ }
28
+ /** A declaration with its owner; `core` for what the platform holds itself. */
29
+ export type ResolvedScopeSharingCollection = ScopeSharingCollection & {
30
+ pluginId: string;
31
+ };
32
+ /**
33
+ * Every collection the sweep walks, in a stable order: a sweep's cursor names
34
+ * a position in this list, and resuming relies on the ones before it being done.
35
+ */
36
+ export declare function listScopeSharingCollections(): ResolvedScopeSharingCollection[];
37
+ /**
38
+ * Recomputes the fields a document derives from its scope: `next` is the whole
39
+ * document as it will be stored, and the answer is merged into the write.
40
+ */
41
+ export type ScopeSharingPatch = (collection: string, next: Record<string, unknown>) => Promise<Record<string, unknown>> | Record<string, unknown>;
42
+ /**
43
+ * Registers the patch for collections a plugin declared with `patch: true`.
44
+ * Refuses a collection another plugin declared, or one declared without it.
45
+ */
46
+ export declare function registerPluginScopeSharingPatch(collections: readonly string[], patch: ScopeSharingPatch, options?: {
47
+ pluginId?: string;
48
+ }): void;
49
+ /** The patch registered for a collection, or `null`. */
50
+ export declare function scopeSharingPatchFor(collection: string): ScopeSharingPatch | null;
51
+ /** Test seam: forget every patch. */
52
+ export declare function resetScopeSharingPatchesForTests(): void;
@@ -0,0 +1,10 @@
1
+ /**
2
+ * GENERATED FILE — do not edit. Regenerate with:
3
+ * node tools/scripts/generate-plugin-manifests.mjs
4
+ *
5
+ * The collections plugins keep documents shared with all sites except some
6
+ * (AGL-4047): each plugin's `scopeSharingCollections` block in
7
+ * plugins.config.json. Core's `plugin-scope-sharing.ts` reads them.
8
+ */
9
+ import type { ResolvedScopeSharingCollection } from './plugin-scope-sharing';
10
+ export declare const PLUGIN_SCOPE_SHARING_COLLECTIONS_DECLARED: readonly ResolvedScopeSharingCollection[];
@@ -0,0 +1,82 @@
1
+ /**
2
+ * GENERATED FILE — do not edit. Regenerate with:
3
+ * node tools/scripts/generate-plugin-manifests.mjs
4
+ *
5
+ * The collections plugins keep documents shared with all sites except some
6
+ * (AGL-4047): each plugin's `scopeSharingCollections` block in
7
+ * plugins.config.json. Core's `plugin-scope-sharing.ts` reads them.
8
+ */ export const PLUGIN_SCOPE_SHARING_COLLECTIONS_DECLARED = [
9
+ {
10
+ "pluginId": "crm",
11
+ "name": "contacts",
12
+ "patch": true,
13
+ "maxIncluded": 30,
14
+ "keepSiteFields": [
15
+ "hostId",
16
+ "capturedByHostIds"
17
+ ]
18
+ },
19
+ {
20
+ "pluginId": "crm",
21
+ "name": "leads",
22
+ "patch": true,
23
+ "maxIncluded": 30,
24
+ "keepSiteFields": [
25
+ "hostId",
26
+ "capturedByHostIds"
27
+ ]
28
+ },
29
+ {
30
+ "pluginId": "crm",
31
+ "name": "companies",
32
+ "patch": true,
33
+ "maxIncluded": 30,
34
+ "keepSiteFields": [
35
+ "hostId",
36
+ "capturedByHostIds"
37
+ ]
38
+ },
39
+ {
40
+ "pluginId": "crm",
41
+ "name": "deals",
42
+ "patch": true,
43
+ "maxIncluded": 30,
44
+ "keepSiteFields": [
45
+ "hostId",
46
+ "capturedByHostIds"
47
+ ]
48
+ },
49
+ {
50
+ "pluginId": "crm",
51
+ "name": "crmTasks",
52
+ "patch": true,
53
+ "maxIncluded": 30,
54
+ "keepSiteFields": [
55
+ "hostId",
56
+ "capturedByHostIds"
57
+ ]
58
+ },
59
+ {
60
+ "pluginId": "crm",
61
+ "name": "crmActivities",
62
+ "maxIncluded": 30,
63
+ "keepSiteFields": [
64
+ "hostId",
65
+ "capturedByHostIds"
66
+ ]
67
+ },
68
+ {
69
+ "pluginId": "data",
70
+ "name": "datasets"
71
+ },
72
+ {
73
+ "pluginId": "marketing",
74
+ "name": "emailCampaigns"
75
+ },
76
+ {
77
+ "pluginId": "workflows",
78
+ "name": "automations"
79
+ }
80
+ ];
81
+
82
+ //# sourceMappingURL=plugin-scope-sharing.generated.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-scope-sharing.generated.ts"],"sourcesContent":["/**\n * GENERATED FILE — do not edit. Regenerate with:\n * node tools/scripts/generate-plugin-manifests.mjs\n *\n * The collections plugins keep documents shared with all sites except some\n * (AGL-4047): each plugin's `scopeSharingCollections` block in\n * plugins.config.json. Core's `plugin-scope-sharing.ts` reads them.\n */\n\nimport type { ResolvedScopeSharingCollection } from './plugin-scope-sharing'\n\nexport const PLUGIN_SCOPE_SHARING_COLLECTIONS_DECLARED: readonly ResolvedScopeSharingCollection[] = [\n {\n \"pluginId\": \"crm\",\n \"name\": \"contacts\",\n \"patch\": true,\n \"maxIncluded\": 30,\n \"keepSiteFields\": [\n \"hostId\",\n \"capturedByHostIds\"\n ]\n },\n {\n \"pluginId\": \"crm\",\n \"name\": \"leads\",\n \"patch\": true,\n \"maxIncluded\": 30,\n \"keepSiteFields\": [\n \"hostId\",\n \"capturedByHostIds\"\n ]\n },\n {\n \"pluginId\": \"crm\",\n \"name\": \"companies\",\n \"patch\": true,\n \"maxIncluded\": 30,\n \"keepSiteFields\": [\n \"hostId\",\n \"capturedByHostIds\"\n ]\n },\n {\n \"pluginId\": \"crm\",\n \"name\": \"deals\",\n \"patch\": true,\n \"maxIncluded\": 30,\n \"keepSiteFields\": [\n \"hostId\",\n \"capturedByHostIds\"\n ]\n },\n {\n \"pluginId\": \"crm\",\n \"name\": \"crmTasks\",\n \"patch\": true,\n \"maxIncluded\": 30,\n \"keepSiteFields\": [\n \"hostId\",\n \"capturedByHostIds\"\n ]\n },\n {\n \"pluginId\": \"crm\",\n \"name\": \"crmActivities\",\n \"maxIncluded\": 30,\n \"keepSiteFields\": [\n \"hostId\",\n \"capturedByHostIds\"\n ]\n },\n {\n \"pluginId\": \"data\",\n \"name\": \"datasets\"\n },\n {\n \"pluginId\": \"marketing\",\n \"name\": \"emailCampaigns\"\n },\n {\n \"pluginId\": \"workflows\",\n \"name\": \"automations\"\n }\n]\n"],"names":["PLUGIN_SCOPE_SHARING_COLLECTIONS_DECLARED"],"mappings":"AAAA;;;;;;;CAOC,GAID,OAAO,MAAMA,4CAAuF;IAClG;QACE,YAAY;QACZ,QAAQ;QACR,SAAS;QACT,eAAe;QACf,kBAAkB;YAChB;YACA;SACD;IACH;IACA;QACE,YAAY;QACZ,QAAQ;QACR,SAAS;QACT,eAAe;QACf,kBAAkB;YAChB;YACA;SACD;IACH;IACA;QACE,YAAY;QACZ,QAAQ;QACR,SAAS;QACT,eAAe;QACf,kBAAkB;YAChB;YACA;SACD;IACH;IACA;QACE,YAAY;QACZ,QAAQ;QACR,SAAS;QACT,eAAe;QACf,kBAAkB;YAChB;YACA;SACD;IACH;IACA;QACE,YAAY;QACZ,QAAQ;QACR,SAAS;QACT,eAAe;QACf,kBAAkB;YAChB;YACA;SACD;IACH;IACA;QACE,YAAY;QACZ,QAAQ;QACR,eAAe;QACf,kBAAkB;YAChB;YACA;SACD;IACH;IACA;QACE,YAAY;QACZ,QAAQ;IACV;IACA;QACE,YAAY;QACZ,QAAQ;IACV;IACA;QACE,YAAY;QACZ,QAAQ;IACV;CACD,CAAA"}
@@ -0,0 +1,85 @@
1
+ import { _ as _extends } from "@swc/helpers/_/_extends";
2
+ var _globalScope_PATCHES_KEY;
3
+ /**
4
+ * @license
5
+ * Copyright 2026 Aglyn LLC
6
+ *
7
+ * Licensed under the Apache License, Version 2.0 (the "License");
8
+ * you may not use this file except in compliance with the License.
9
+ * You may obtain a copy of the License at
10
+ *
11
+ * http://www.apache.org/licenses/LICENSE-2.0
12
+ *
13
+ * Unless required by applicable law or agreed to in writing, software
14
+ * distributed under the License is distributed on an "AS IS" BASIS,
15
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
+ * See the License for the specific language governing permissions and
17
+ * limitations under the License.
18
+ */ /**
19
+ * WHICH COLLECTIONS HOLD DOCUMENTS SHARED WITH "ALL SITES EXCEPT…" (AGL-4047).
20
+ *
21
+ * Such a document names its included sites in `visibleTo`, so that list has
22
+ * to change when a site joins or leaves the workspace. One sweep does that for
23
+ * every collection (`scope-sharing-sweep.ts`), and it can only walk what it
24
+ * has been told about, so a plugin declares its collections in the
25
+ * `scopeSharingCollections` block of `plugins.config.json`, compiled like its
26
+ * other storage. Media belongs to the platform and is listed here.
27
+ *
28
+ * A collection whose documents store fields derived from `visibleTo` declares
29
+ * `patch: true` and registers the function that recomputes them. The sweep
30
+ * refuses to write such a collection while the function is missing, because a
31
+ * `visibleTo` written without them leaves a document its list cannot find.
32
+ */ import { getRegisteringPluginId } from "../app-utils/registering-plugin.js";
33
+ import { PLUGIN_SCOPE_SHARING_COLLECTIONS_DECLARED } from "./plugin-scope-sharing.generated.js";
34
+ /** The platform's own: media belongs to no plugin. */ const CORE_SCOPE_SHARING_COLLECTIONS = [
35
+ {
36
+ pluginId: 'core',
37
+ name: 'media'
38
+ },
39
+ {
40
+ pluginId: 'core',
41
+ name: 'mediaFolders'
42
+ }
43
+ ];
44
+ /**
45
+ * Every collection the sweep walks, in a stable order: a sweep's cursor names
46
+ * a position in this list, and resuming relies on the ones before it being done.
47
+ */ export function listScopeSharingCollections() {
48
+ return [
49
+ ...CORE_SCOPE_SHARING_COLLECTIONS,
50
+ ...PLUGIN_SCOPE_SHARING_COLLECTIONS_DECLARED
51
+ ].map((row)=>_extends({}, row));
52
+ }
53
+ /**
54
+ * One map per process, on `globalThis`, for the reason `plugin-site-resources`
55
+ * gives: the declarations register from `instrumentation.ts`, which Next
56
+ * compiles apart from the route that runs the sweep.
57
+ */ const PATCHES_KEY = Symbol.for('@aglyn/aglyn:plugin-scope-sharing-patches');
58
+ const globalScope = globalThis;
59
+ const patches = (_globalScope_PATCHES_KEY = globalScope[PATCHES_KEY]) != null ? _globalScope_PATCHES_KEY : globalScope[PATCHES_KEY] = new Map();
60
+ /**
61
+ * Registers the patch for collections a plugin declared with `patch: true`.
62
+ * Refuses a collection another plugin declared, or one declared without it.
63
+ */ export function registerPluginScopeSharingPatch(collections, patch, options) {
64
+ var _ref, _getRegisteringPluginId;
65
+ const pluginId = ((_ref = (_getRegisteringPluginId = getRegisteringPluginId()) != null ? _getRegisteringPluginId : options == null ? void 0 : options.pluginId) != null ? _ref : '').trim();
66
+ if (!pluginId) {
67
+ throw new Error('a scope-sharing patch was registered with no owner: pass { pluginId } ' + 'when registering outside a plugin register fn');
68
+ }
69
+ for (const name of collections){
70
+ const declared = PLUGIN_SCOPE_SHARING_COLLECTIONS_DECLARED.find((row)=>row.name === name);
71
+ if ((declared == null ? void 0 : declared.pluginId) !== pluginId || !declared.patch) {
72
+ throw new Error(`${pluginId} did not declare ${name} with patch: true in scopeSharingCollections`);
73
+ }
74
+ }
75
+ for (const name of collections)patches.set(name, patch);
76
+ }
77
+ /** The patch registered for a collection, or `null`. */ export function scopeSharingPatchFor(collection) {
78
+ var _patches_get;
79
+ return (_patches_get = patches.get(collection)) != null ? _patches_get : null;
80
+ }
81
+ /** Test seam: forget every patch. */ export function resetScopeSharingPatchesForTests() {
82
+ patches.clear();
83
+ }
84
+
85
+ //# sourceMappingURL=plugin-scope-sharing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-scope-sharing.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 * WHICH COLLECTIONS HOLD DOCUMENTS SHARED WITH \"ALL SITES EXCEPT…\" (AGL-4047).\n *\n * Such a document names its included sites in `visibleTo`, so that list has\n * to change when a site joins or leaves the workspace. One sweep does that for\n * every collection (`scope-sharing-sweep.ts`), and it can only walk what it\n * has been told about, so a plugin declares its collections in the\n * `scopeSharingCollections` block of `plugins.config.json`, compiled like its\n * other storage. Media belongs to the platform and is listed here.\n *\n * A collection whose documents store fields derived from `visibleTo` declares\n * `patch: true` and registers the function that recomputes them. The sweep\n * refuses to write such a collection while the function is missing, because a\n * `visibleTo` written without them leaves a document its list cannot find.\n */\n\nimport { getRegisteringPluginId } from '../app-utils/registering-plugin'\nimport { PLUGIN_SCOPE_SHARING_COLLECTIONS_DECLARED } from './plugin-scope-sharing.generated'\n\n/** One collection under `orgs/{orgId}` whose documents can be all-except. */\nexport interface ScopeSharingCollection {\n /** The subcollection, spelled as Firestore holds it. */\n name: string\n /** Stored fields follow `visibleTo`: a patch function is registered. */\n patch?: boolean\n /** The most sites one document may reach; past it the list stops widening. */\n maxIncluded?: number\n /** Fields naming sites that stay included though they are excluded. */\n keepSiteFields?: string[]\n}\n\n/** A declaration with its owner; `core` for what the platform holds itself. */\nexport type ResolvedScopeSharingCollection = ScopeSharingCollection & {\n pluginId: string\n}\n\n/** The platform's own: media belongs to no plugin. */\nconst CORE_SCOPE_SHARING_COLLECTIONS: readonly ResolvedScopeSharingCollection[] = [\n { pluginId: 'core', name: 'media' },\n { pluginId: 'core', name: 'mediaFolders' },\n]\n\n/**\n * Every collection the sweep walks, in a stable order: a sweep's cursor names\n * a position in this list, and resuming relies on the ones before it being done.\n */\nexport function listScopeSharingCollections(): ResolvedScopeSharingCollection[] {\n return [\n ...CORE_SCOPE_SHARING_COLLECTIONS,\n ...PLUGIN_SCOPE_SHARING_COLLECTIONS_DECLARED,\n ].map((row) => ({ ...row }))\n}\n\n/**\n * Recomputes the fields a document derives from its scope: `next` is the whole\n * document as it will be stored, and the answer is merged into the write.\n */\nexport type ScopeSharingPatch = (\n collection: string,\n next: Record<string, unknown>,\n) => Promise<Record<string, unknown>> | Record<string, unknown>\n\n/**\n * One map per process, on `globalThis`, for the reason `plugin-site-resources`\n * gives: the declarations register from `instrumentation.ts`, which Next\n * compiles apart from the route that runs the sweep.\n */\nconst PATCHES_KEY = Symbol.for('@aglyn/aglyn:plugin-scope-sharing-patches')\n\nconst globalScope = globalThis as typeof globalThis & {\n [PATCHES_KEY]?: Map<string, ScopeSharingPatch>\n}\n\nconst patches: Map<string, ScopeSharingPatch> =\n globalScope[PATCHES_KEY] ?? (globalScope[PATCHES_KEY] = new Map())\n\n/**\n * Registers the patch for collections a plugin declared with `patch: true`.\n * Refuses a collection another plugin declared, or one declared without it.\n */\nexport function registerPluginScopeSharingPatch(\n collections: readonly string[],\n patch: ScopeSharingPatch,\n options?: { pluginId?: string },\n): void {\n const pluginId = (getRegisteringPluginId() ?? options?.pluginId ?? '').trim()\n if (!pluginId) {\n throw new Error(\n 'a scope-sharing patch was registered with no owner: pass { pluginId } ' +\n 'when registering outside a plugin register fn',\n )\n }\n for (const name of collections) {\n const declared = PLUGIN_SCOPE_SHARING_COLLECTIONS_DECLARED.find((row) => row.name === name)\n if (declared?.pluginId !== pluginId || !declared.patch) {\n throw new Error(`${pluginId} did not declare ${name} with patch: true in scopeSharingCollections`)\n }\n }\n for (const name of collections) patches.set(name, patch)\n}\n\n/** The patch registered for a collection, or `null`. */\nexport function scopeSharingPatchFor(collection: string): ScopeSharingPatch | null {\n return patches.get(collection) ?? null\n}\n\n/** Test seam: forget every patch. */\nexport function resetScopeSharingPatchesForTests(): void {\n patches.clear()\n}\n"],"names":["globalScope","getRegisteringPluginId","PLUGIN_SCOPE_SHARING_COLLECTIONS_DECLARED","CORE_SCOPE_SHARING_COLLECTIONS","pluginId","name","listScopeSharingCollections","map","row","PATCHES_KEY","Symbol","for","globalThis","patches","Map","registerPluginScopeSharingPatch","collections","patch","options","trim","Error","declared","find","set","scopeSharingPatchFor","collection","get","resetScopeSharingPatchesForTests","clear"],"mappings":";IA2FEA;AA3FF;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;CAcC,GAED,SAASC,sBAAsB,QAAQ,qCAAiC;AACxE,SAASC,yCAAyC,QAAQ,sCAAkC;AAmB5F,oDAAoD,GACpD,MAAMC,iCAA4E;IAChF;QAAEC,UAAU;QAAQC,MAAM;IAAQ;IAClC;QAAED,UAAU;QAAQC,MAAM;IAAe;CAC1C;AAED;;;CAGC,GACD,OAAO,SAASC;IACd,OAAO;WACFH;WACAD;KACJ,CAACK,GAAG,CAAC,CAACC,MAAS,aAAKA;AACvB;AAWA;;;;CAIC,GACD,MAAMC,cAAcC,OAAOC,GAAG,CAAC;AAE/B,MAAMX,cAAcY;AAIpB,MAAMC,WACJb,2BAAAA,WAAW,CAACS,YAAY,YAAxBT,2BAA6BA,WAAW,CAACS,YAAY,GAAG,IAAIK;AAE9D;;;CAGC,GACD,OAAO,SAASC,gCACdC,WAA8B,EAC9BC,KAAwB,EACxBC,OAA+B;QAEbjB,MAAAA;IAAlB,MAAMG,WAAW,EAACH,QAAAA,0BAAAA,oCAAAA,0BAA4BiB,2BAAAA,QAASd,QAAQ,YAA7CH,OAAiD,IAAIkB,IAAI;IAC3E,IAAI,CAACf,UAAU;QACb,MAAM,IAAIgB,MACR,2EACE;IAEN;IACA,KAAK,MAAMf,QAAQW,YAAa;QAC9B,MAAMK,WAAWnB,0CAA0CoB,IAAI,CAAC,CAACd,MAAQA,IAAIH,IAAI,KAAKA;QACtF,IAAIgB,CAAAA,4BAAAA,SAAUjB,QAAQ,MAAKA,YAAY,CAACiB,SAASJ,KAAK,EAAE;YACtD,MAAM,IAAIG,MAAM,GAAGhB,SAAS,iBAAiB,EAAEC,KAAK,4CAA4C,CAAC;QACnG;IACF;IACA,KAAK,MAAMA,QAAQW,YAAaH,QAAQU,GAAG,CAAClB,MAAMY;AACpD;AAEA,sDAAsD,GACtD,OAAO,SAASO,qBAAqBC,UAAkB;QAC9CZ;IAAP,QAAOA,eAAAA,QAAQa,GAAG,CAACD,uBAAZZ,eAA2B;AACpC;AAEA,mCAAmC,GACnC,OAAO,SAASc;IACdd,QAAQe,KAAK;AACf"}
@@ -29,6 +29,7 @@ import type { TransferChunk, TransferRowResult, TransferUndoEntry, TransferUndoS
29
29
  import { type TransferField, type TransferResourceDescriptor } from '../data-transfer/resource';
30
30
  import { type TransferPlanRequiredResponse } from '../data-transfer/transfer-api';
31
31
  import type { MdiIconProps } from '../types/nodes';
32
+ import type { PluginIndexedRecord } from './plugin-record-index';
32
33
  /**
33
34
  * WHAT A PLUGIN CAN IMPORT AND EXPORT (AGL-3523), the extension point every
34
35
  * import wizard, export dialog and transfer job reads.
@@ -497,7 +498,7 @@ export interface TransferPackageHooks<T = unknown> {
497
498
  * {@link TransferPackageHooks} member — checked against the declaration at
498
499
  * registration.
499
500
  */
500
- export type PluginTransferResource = Partial<TransferRecordsHooks> & Partial<TransferPackageHooks> & TransferPlanGateHooks;
501
+ export type PluginTransferResource = Partial<TransferRecordsHooks> & TransferImportAccessHooks & Partial<TransferPackageHooks> & TransferPlanGateHooks;
501
502
  /** The workspace a plan question is asked about, as the gate read it. */
502
503
  export interface TransferPlanSubject {
503
504
  /** The resource key, naming the instance for one declared with `instances`. */
@@ -524,6 +525,40 @@ export interface TransferPlanGateHooks {
524
525
  */
525
526
  planGate?(subject: TransferPlanSubject, intent: TransferAccessIntent): Promise<TransferPlanRefusal | null> | TransferPlanRefusal | null;
526
527
  }
528
+ /** Who is asking to import into a resource, as the gate read them. */
529
+ export interface TransferImportAccessSubject {
530
+ /** The resource key, naming the instance for one declared with `instances`. */
531
+ resource: string;
532
+ orgId: string;
533
+ uid: string;
534
+ /** The caller's workspace membership. */
535
+ member: Readonly<Record<string, unknown>>;
536
+ }
537
+ /** The import hook a resource may answer with, beside its kind's. */
538
+ export interface TransferImportAccessHooks {
539
+ /**
540
+ * Whether this member may import into THIS instance of the resource
541
+ * (AGL-4047), in place of `data.manage` on the workspace: for records whose
542
+ * answer depends on where the instance is placed, which the declaration
543
+ * cannot say. Answers the refusal's permission key when it refuses, so the
544
+ * gate names the right one. May read the database and load its module with
545
+ * its first call.
546
+ */
547
+ importAccess?(subject: TransferImportAccessSubject): Promise<TransferImportAccessVerdict> | TransferImportAccessVerdict;
548
+ }
549
+ /** A resource's own answer on importing: allowed, or the permission that is missing. */
550
+ export type TransferImportAccessVerdict = {
551
+ allowed: true;
552
+ } | {
553
+ allowed: false;
554
+ permission: string;
555
+ };
556
+ /**
557
+ * The resource's own answer on importing into this instance, or `null` when
558
+ * it has none (or its server half cannot be reached, which the route that
559
+ * needs it answers) and the gate's `data.manage` stands.
560
+ */
561
+ export declare function transferImportAccess(subject: TransferImportAccessSubject): Promise<TransferImportAccessVerdict | null>;
527
562
  /**
528
563
  * The refusal a resource with no `planGate` gets: its plan feature as
529
564
  * `code`, and a sentence naming the plan that includes it, from the same
@@ -681,6 +716,26 @@ export interface PluginTransferResourceUi {
681
716
  * resource to the plugin's own surface.
682
717
  */
683
718
  instancesFrom?: string;
719
+ /**
720
+ * For a resource whose server half answers `importAccess`: that answer for one
721
+ * instance the hub lists, from what the browser already holds, so its Import
722
+ * says what the route will. Not a security boundary: the route still decides.
723
+ */
724
+ instanceImportAccess?(subject: TransferInstanceImportSubject): TransferInstanceImportAnswer;
725
+ }
726
+ /** What a resource is asked about one listed instance. */
727
+ export interface TransferInstanceImportSubject {
728
+ /** The instance, as its record list reads it. */
729
+ record: PluginIndexedRecord;
730
+ /** The signed-in member's document. */
731
+ member: Readonly<Record<string, unknown>>;
732
+ /** Their custom role, when they carry one and it could be read. */
733
+ customRole: Readonly<Record<string, unknown>> | null;
734
+ }
735
+ /** The answer, and the refusal to show beside a switched-off Import. */
736
+ export interface TransferInstanceImportAnswer {
737
+ allowed: boolean;
738
+ reason: string;
684
739
  }
685
740
  /**
686
741
  * Registers the client half of a resource the plugin declared, from its
@@ -52,6 +52,19 @@ import { runPluginDeclarationsRepair } from "./plugin-declarations-repair.js";
52
52
  }) : enabled);
53
53
  return listDeclaredTransferResources().filter((one)=>one.scope === subject.scope && running.has(one.pluginId));
54
54
  }
55
+ /**
56
+ * The resource's own answer on importing into this instance, or `null` when
57
+ * it has none (or its server half cannot be reached, which the route that
58
+ * needs it answers) and the gate's `data.manage` stands.
59
+ */ export async function transferImportAccess(subject) {
60
+ let hook;
61
+ try {
62
+ hook = (await resolveTransferResource(subject.resource)).impl.importAccess;
63
+ } catch (unused) {
64
+ hook = undefined;
65
+ }
66
+ return hook ? hook(subject) : null;
67
+ }
55
68
  /** "Companies" → "companies", "CRM fields" unchanged: the label inside a sentence. */ function inSentence(label) {
56
69
  return /^[A-Z][a-z]/.test(label) ? label.charAt(0).toLowerCase() + label.slice(1) : label;
57
70
  }