@wildo-ai/saas-models 1.1.5 → 1.1.7

package/dist/esm/organizations/organization-unit-narrowing.shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"organization-unit-narrowing.shared.js","sourceRoot":"","sources":["../../../../src/organizations/organization-unit-narrowing.shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization-unit narrowing — the opt-in registry and its hard containment rule.\n *\n * Unit grants are ADDITIVE (plan decision D-C3b): they widen a principal's reach, never shrink it.\n * A caller whose organization-wide grant already satisfies an operation is not narrowed at all; a\n * caller who would otherwise be denied gains access to the rows of the units they hold.\n *\n * A resource participates ONLY by opting in here. Narrowing is never implicit: inferring it from the\n * presence of an `organizationUnitId` field would silently change the result set of every existing\n * LIST the moment such a field was added.\n */\n\nimport { CoreResourceType } from '../resources/resources.shared.core.definitions';\n\n/**\n * @wildo_source:part:start saas.models.organization-unit-narrowing-declaration facet:layer:shared facet:family:authorization\n *\n * How one resource is narrowed: the field carrying the unit a row belongs to.\n *\n * Import from `@wildo-ai/saas-models`. Declare narrowing by passing an\n * `organizationUnitNarrowing` map to application startup, keyed by resource type:\n *\n * ```ts\n * organizationUnitNarrowing: {\n *   [MyResourceType.PROJECTS]: { unitFieldName: 'organizationUnitId' },\n * }\n * ```\n *\n * `unitFieldName` must name a real field on the resource's main schema that stores the owning\n * `ORGANIZATION_UNITS` id — it becomes a query predicate on every read and a write-time check on\n * every create/update, so a misspelled field is an authorization defect, not a typo.\n *\n * Opting in is ADDITIVE: a caller whose organization-wide role already satisfies the operation is\n * never narrowed and keeps seeing the whole tenant, while a caller who would otherwise be denied\n * gains access to the rows of the units they hold. Opting a resource in therefore cannot shrink any\n * existing result set.\n *\n * Deliberately an object rather than a bare boolean so per-operation narrowing can be added later as\n * an optional property (D-C5) without migrating any existing declaration — Dynamics carries depth\n * per privilege, and Wildo already declares roles per operation variant, so that is the likely next\n * shape. Resource-level is a strict subset of it.\n */\nexport type OrganizationUnitNarrowingDeclaration = {\n  /** The field on the resource holding the owning `ORGANIZATION_UNITS` id. */\n  readonly unitFieldName: string;\n};\n/** @wildo_source:part:end saas.models.organization-unit-narrowing-declaration */\n\n/**\n * @wildo_source:part:start saas.models.organization-unit-narrowing-containment facet:layer:shared facet:family:authorization facet:audience:app-developer\n *\n * Resources that may NEVER be unit-narrowable — the authorization plane.\n *\n * ## The loop this closes\n *\n * A resource that ISSUES authority must not be governed by the authority it issues. Were\n * `ORGANIZATION_UNIT_MEMBERS` narrowable:\n *\n *   1. a principal who is organization-wide `ORG_MEMBER` but `ORG_ADMIN` of ONE unit\n *   2. satisfies the `ORG_ADMIN` gate on the grant surface via that unit grant,\n *   3. grants themselves `ORG_ADMIN` in every other unit,\n *   4. and the union of all units is organization-wide admin — assembled from a single unit grant.\n *\n * Step 3 is blocked today only because the role ceiling derives from organization-wide grants. That\n * is one refactor away from being undone (see the `D-C4 LOCK` regression test), so the containment\n * is also structural: a unit grant can never reach these resources at all.\n *\n * Every major suite enforces the same separation — SAP puts user↔role assignment behind dedicated\n * authorization objects, Azure puts role assignment outside the data plane behind\n * `Microsoft.Authorization/roleAssignments/write`, and Dynamics forbids assigning a role you do not\n * hold.\n *\n * `ORGANIZATION_MEMBERS` is listed for the same reason one level up: it carries the organization-wide\n * `roles` array that produces `initiatorRoles`. The roles-bearing machine credentials are listed\n * because the roles written at CREATE become the authority of every token minted from them.\n *\n * ## `ORGANIZATIONS` is listed for a SECOND, distinct reason — scope inversion\n *\n * The rule above is \"a resource that ISSUES authority may not be governed by the authority it\n * issues\". `ORGANIZATIONS` is barred by its sibling: **a resource that DEFINES a scope may not be\n * governed by a narrowing INSIDE that scope.** A unit is owned BY an organization, so letting the\n * owned thing gate access to its owner inverts the containment.\n *\n * That is not abstract. The tenant lifecycle verbs live on this resource, and\n * `request_deletion` / `suspend` are `ORG_ADMIN`-gated. Were `ORGANIZATIONS` narrowable, a principal\n * who is organization-wide `ORG_MEMBER` but `ORG_ADMIN` of ONE unit would satisfy that gate through\n * the unit grant — and one division's administrator could mark the ENTIRE tenant for deletion, or\n * halt it. The blast radius is the whole organization, reached from a grant that was supposed to\n * confine them to a subtree of it.\n *\n * It is also meaningless independently of the hazard: an organization is not located inside one of\n * its own units, so there is no honest `unitFieldName` to declare. Listing it turns a declaration\n * that could never be correct into a boot failure instead of a silent authorization hole.\n */\nexport const ORGANIZATION_UNIT_NARROWING_FORBIDDEN_RESOURCES: readonly CoreResourceType[] = [\n  CoreResourceType.ORGANIZATION_UNIT_MEMBERS,\n  CoreResourceType.ORGANIZATION_MEMBERS,\n  CoreResourceType.ORGANIZATION_UNITS,\n  // The tenant itself — scope inversion, and the door to the tenant lifecycle verbs. See the\n  // dedicated section above; this is a different rule from the issues-authority one.\n  CoreResourceType.ORGANIZATIONS,\n  CoreResourceType.ORG_API_KEYS,\n  CoreResourceType.OAUTH_CLIENTS_ORGANIZATION,\n  // A credential authenticates the WHOLE TENANT toward a third party — there is one Slack workspace\n  // behind it, not one per division. Narrowing it to a unit would let a unit-scoped administrator\n  // rotate or delete the credential every other unit spends, which is the same issues-authority\n  // hazard the sibling entries above record: the grant confines them to a subtree, the object they\n  // reach does not live in one.\n  CoreResourceType.ORG_PROVIDER_CREDENTIALS,\n];\n/** @wildo_source:part:end saas.models.organization-unit-narrowing-containment */\n\n/**\n * The engine's opted-in resources.\n *\n * EMPTY BY DESIGN. No engine resource carries a unit FK yet, and opting one in is a deliberate\n * per-resource decision, not a default. The mechanism ships ahead of its first consumer so that the\n * containment rule is enforced from the start rather than retrofitted after a resource has already\n * been narrowed incorrectly.\n */\nexport const ENGINE_ORGANIZATION_UNIT_NARROWING: Readonly<Partial<Record<CoreResourceType, OrganizationUnitNarrowingDeclaration>>> = {};\n\n/**\n * Merge the engine's opt-ins with an application's into the map that GOVERNS RUNTIME.\n *\n * The engine ships none today, so in practice this is the application's own map — but the merge\n * exists rather than the application map being used directly, because the containment validation and\n * every runtime lookup must see ONE map. A second, unmerged source is how a resource ends up narrowed\n * on the read path and not on the write path.\n *\n * An application declaration for a resource the engine also declares REPLACES it: the application\n * owns the field name on its own schema. Nothing here validates the result — the caller passes the\n * merged map to {@link collectOrganizationUnitNarrowingViolations} and fails closed at boot, so that\n * an application cannot narrow the authorization plane merely by declaring it later than the engine.\n */\nexport function mergeOrganizationUnitNarrowingDeclarations(\n  engineNarrowing: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>,\n  applicationNarrowing: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>> | undefined,\n): Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>> {\n  return { ...engineNarrowing, ...(applicationNarrowing ?? {}) };\n}\n\n/** A declaration that violates the D-C4 containment rule, or contradicts a DERIVED one. */\nexport type OrganizationUnitNarrowingViolation = {\n  readonly resourceType: string;\n  readonly reason:\n    | 'authorization_plane_resource_cannot_be_unit_narrowable'\n    | 'missing_unit_field_name'\n    /**\n     * An application named a different `unitFieldName` for a resource the ENGINE derives (#1058 R7).\n     *\n     * Refused rather than resolved either way. Letting the application win puts a read-through\n     * resource's confinement on a field no projector writes, so every caller sees nothing; letting\n     * the engine win silently makes the application's own declaration a lie it can read in its\n     * source and never observe. The remedy is to delete the declaration, which is why the message\n     * says so — the engine supplies it.\n     */\n    | 'derived_narrowing_contradicted';\n};\n\n/**\n * Fold the ENGINE's derived declarations over an application's, refusing any disagreement.\n *\n * Separate from {@link mergeOrganizationUnitNarrowingDeclarations}, and the asymmetry is the point.\n * That merge lets an APPLICATION replace an engine opt-in, because the application owns the field\n * name on its own schema. A DERIVED declaration is the opposite case: the field is the engine's, it\n * is written by the engine's own projector, and an application has no way to change where it lands.\n * So a disagreement there is not an override — it is a statement that cannot be true.\n *\n * An application declaration that AGREES is left alone rather than reported: it is redundant, not\n * wrong, and refusing redundancy would break every application that wrote down what the engine\n * would have derived anyway.\n */\nexport function foldDerivedOrganizationUnitNarrowing(\n  declared: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>,\n  derived: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>,\n): {\n  readonly merged: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>;\n  readonly violations: OrganizationUnitNarrowingViolation[];\n} {\n  const violations: OrganizationUnitNarrowingViolation[] = [];\n  const merged: Record<string, OrganizationUnitNarrowingDeclaration> = { ...declared };\n\n  for (const [resourceType, declaration] of Object.entries(derived)) {\n    if (!declaration) continue;\n    const existing = declared[resourceType];\n    if (existing !== undefined && existing.unitFieldName !== declaration.unitFieldName) {\n      violations.push({ resourceType, reason: 'derived_narrowing_contradicted' });\n    }\n    merged[resourceType] = declaration;\n  }\n\n  return { merged, violations };\n}\n\n/**\n * Validate a narrowing registry against the containment rule.\n *\n * Returns violations rather than throwing so the caller owns the failure mode — the engine boot path\n * turns these into a startup error (fail closed: a misdeclared narrowing is a silent authorization\n * hole, so the application must not start), while tooling can report them without dying.\n */\nexport function collectOrganizationUnitNarrowingViolations(\n  narrowingRegistry: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>,\n): OrganizationUnitNarrowingViolation[] {\n  const forbidden = new Set<string>(ORGANIZATION_UNIT_NARROWING_FORBIDDEN_RESOURCES);\n  const violations: OrganizationUnitNarrowingViolation[] = [];\n\n  for (const [resourceType, declaration] of Object.entries(narrowingRegistry)) {\n    if (!declaration) continue;\n    if (forbidden.has(resourceType)) {\n      violations.push({ resourceType, reason: 'authorization_plane_resource_cannot_be_unit_narrowable' });\n      continue;\n    }\n    if (typeof declaration.unitFieldName !== 'string' || declaration.unitFieldName.length === 0) {\n      violations.push({ resourceType, reason: 'missing_unit_field_name' });\n    }\n  }\n\n  return violations;\n}\n\n/**\n * Is this resource narrowed by organization unit?\n *\n * The single question every consumer asks. Reading the registry directly is how a call site ends up\n * disagreeing with the containment rule — the forbidden set is re-checked here so a registry that\n * was assembled without validation still cannot narrow the authorization plane.\n */\nexport function resolveOrganizationUnitNarrowing(\n  narrowingRegistry: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>,\n  resourceType: string,\n): OrganizationUnitNarrowingDeclaration | undefined {\n  if (ORGANIZATION_UNIT_NARROWING_FORBIDDEN_RESOURCES.includes(resourceType as CoreResourceType)) return undefined;\n  const declaration = narrowingRegistry[resourceType];\n  if (!declaration?.unitFieldName) return undefined;\n  return declaration;\n}\n"]}
+{"version":3,"file":"organization-unit-narrowing.shared.js","sourceRoot":"","sources":["../../../src/organizations/organization-unit-narrowing.shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization-unit narrowing — the opt-in registry and its hard containment rule.\n *\n * Unit grants are ADDITIVE (plan decision D-C3b): they widen a principal's reach, never shrink it.\n * A caller whose organization-wide grant already satisfies an operation is not narrowed at all; a\n * caller who would otherwise be denied gains access to the rows of the units they hold.\n *\n * A resource participates ONLY by opting in here. Narrowing is never implicit: inferring it from the\n * presence of an `organizationUnitId` field would silently change the result set of every existing\n * LIST the moment such a field was added.\n */\n\nimport { CoreResourceType } from '../resources/resources.shared.core.definitions';\n\n/**\n * @wildo_source:part:start saas.models.organization-unit-narrowing-declaration facet:layer:shared facet:family:authorization\n *\n * How one resource is narrowed: the field carrying the unit a row belongs to.\n *\n * Import from `@wildo-ai/saas-models`. Declare narrowing by passing an\n * `organizationUnitNarrowing` map to application startup, keyed by resource type:\n *\n * ```ts\n * organizationUnitNarrowing: {\n *   [MyResourceType.PROJECTS]: { unitFieldName: 'organizationUnitId' },\n * }\n * ```\n *\n * `unitFieldName` must name a real field on the resource's main schema that stores the owning\n * `ORGANIZATION_UNITS` id — it becomes a query predicate on every read and a write-time check on\n * every create/update, so a misspelled field is an authorization defect, not a typo.\n *\n * Opting in is ADDITIVE: a caller whose organization-wide role already satisfies the operation is\n * never narrowed and keeps seeing the whole tenant, while a caller who would otherwise be denied\n * gains access to the rows of the units they hold. Opting a resource in therefore cannot shrink any\n * existing result set.\n *\n * Deliberately an object rather than a bare boolean so per-operation narrowing can be added later as\n * an optional property (D-C5) without migrating any existing declaration — Dynamics carries depth\n * per privilege, and Wildo already declares roles per operation variant, so that is the likely next\n * shape. Resource-level is a strict subset of it.\n */\nexport type OrganizationUnitNarrowingDeclaration = {\n  /** The field on the resource holding the owning `ORGANIZATION_UNITS` id. */\n  readonly unitFieldName: string;\n};\n/** @wildo_source:part:end saas.models.organization-unit-narrowing-declaration */\n\n/**\n * @wildo_source:part:start saas.models.organization-unit-narrowing-containment facet:layer:shared facet:family:authorization facet:audience:app-developer\n *\n * Resources that may NEVER be unit-narrowable — the authorization plane.\n *\n * ## The loop this closes\n *\n * A resource that ISSUES authority must not be governed by the authority it issues. Were\n * `ORGANIZATION_UNIT_MEMBERS` narrowable:\n *\n *   1. a principal who is organization-wide `ORG_MEMBER` but `ORG_ADMIN` of ONE unit\n *   2. satisfies the `ORG_ADMIN` gate on the grant surface via that unit grant,\n *   3. grants themselves `ORG_ADMIN` in every other unit,\n *   4. and the union of all units is organization-wide admin — assembled from a single unit grant.\n *\n * Step 3 is blocked today only because the role ceiling derives from organization-wide grants. That\n * is one refactor away from being undone (see the `D-C4 LOCK` regression test), so the containment\n * is also structural: a unit grant can never reach these resources at all.\n *\n * Every major suite enforces the same separation — SAP puts user↔role assignment behind dedicated\n * authorization objects, Azure puts role assignment outside the data plane behind\n * `Microsoft.Authorization/roleAssignments/write`, and Dynamics forbids assigning a role you do not\n * hold.\n *\n * `ORGANIZATION_MEMBERS` is listed for the same reason one level up: it carries the organization-wide\n * `roles` array that produces `initiatorRoles`. The roles-bearing machine credentials are listed\n * because the roles written at CREATE become the authority of every token minted from them.\n *\n * ## `ORGANIZATIONS` is listed for a SECOND, distinct reason — scope inversion\n *\n * The rule above is \"a resource that ISSUES authority may not be governed by the authority it\n * issues\". `ORGANIZATIONS` is barred by its sibling: **a resource that DEFINES a scope may not be\n * governed by a narrowing INSIDE that scope.** A unit is owned BY an organization, so letting the\n * owned thing gate access to its owner inverts the containment.\n *\n * That is not abstract. The tenant lifecycle verbs live on this resource, and\n * `request_deletion` / `suspend` are `ORG_ADMIN`-gated. Were `ORGANIZATIONS` narrowable, a principal\n * who is organization-wide `ORG_MEMBER` but `ORG_ADMIN` of ONE unit would satisfy that gate through\n * the unit grant — and one division's administrator could mark the ENTIRE tenant for deletion, or\n * halt it. The blast radius is the whole organization, reached from a grant that was supposed to\n * confine them to a subtree of it.\n *\n * It is also meaningless independently of the hazard: an organization is not located inside one of\n * its own units, so there is no honest `unitFieldName` to declare. Listing it turns a declaration\n * that could never be correct into a boot failure instead of a silent authorization hole.\n */\nexport const ORGANIZATION_UNIT_NARROWING_FORBIDDEN_RESOURCES: readonly CoreResourceType[] = [\n  CoreResourceType.ORGANIZATION_UNIT_MEMBERS,\n  CoreResourceType.ORGANIZATION_MEMBERS,\n  CoreResourceType.ORGANIZATION_UNITS,\n  // The tenant itself — scope inversion, and the door to the tenant lifecycle verbs. See the\n  // dedicated section above; this is a different rule from the issues-authority one.\n  CoreResourceType.ORGANIZATIONS,\n  CoreResourceType.ORG_API_KEYS,\n  CoreResourceType.OAUTH_CLIENTS_ORGANIZATION,\n  // A credential authenticates the WHOLE TENANT toward a third party — there is one Slack workspace\n  // behind it, not one per division. Narrowing it to a unit would let a unit-scoped administrator\n  // rotate or delete the credential every other unit spends, which is the same issues-authority\n  // hazard the sibling entries above record: the grant confines them to a subtree, the object they\n  // reach does not live in one.\n  CoreResourceType.ORG_PROVIDER_CREDENTIALS,\n  // Service-provider relationships (#1597) ISSUE authority: accepting one, amending its scope or assigning\n  // an expert to it hands a person outside the organization a membership inside it. A unit administrator\n  // must never reach the verbs that do that, for the same issues-authority reason as the entries above.\n  CoreResourceType.SERVICE_PROVIDER_RELATIONSHIPS,\n  CoreResourceType.SERVICE_ENGAGEMENTS,\n  CoreResourceType.SERVICE_ENGAGEMENT_ASSIGNMENTS,\n  // A capability grant (#1631) issues ADMINISTRATIVE authority to people outside the organization — the most direct\n  // form of the issues-authority hazard above.\n  CoreResourceType.SERVICE_PROVIDER_CAPABILITY_GRANTS,\n];\n/** @wildo_source:part:end saas.models.organization-unit-narrowing-containment */\n\n/**\n * The engine's opted-in resources.\n *\n * EMPTY BY DESIGN. No engine resource carries a unit FK yet, and opting one in is a deliberate\n * per-resource decision, not a default. The mechanism ships ahead of its first consumer so that the\n * containment rule is enforced from the start rather than retrofitted after a resource has already\n * been narrowed incorrectly.\n */\nexport const ENGINE_ORGANIZATION_UNIT_NARROWING: Readonly<Partial<Record<CoreResourceType, OrganizationUnitNarrowingDeclaration>>> = {};\n\n/**\n * Merge the engine's opt-ins with an application's into the map that GOVERNS RUNTIME.\n *\n * The engine ships none today, so in practice this is the application's own map — but the merge\n * exists rather than the application map being used directly, because the containment validation and\n * every runtime lookup must see ONE map. A second, unmerged source is how a resource ends up narrowed\n * on the read path and not on the write path.\n *\n * An application declaration for a resource the engine also declares REPLACES it: the application\n * owns the field name on its own schema. Nothing here validates the result — the caller passes the\n * merged map to {@link collectOrganizationUnitNarrowingViolations} and fails closed at boot, so that\n * an application cannot narrow the authorization plane merely by declaring it later than the engine.\n */\nexport function mergeOrganizationUnitNarrowingDeclarations(\n  engineNarrowing: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>,\n  applicationNarrowing: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>> | undefined,\n): Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>> {\n  return { ...engineNarrowing, ...(applicationNarrowing ?? {}) };\n}\n\n/** A declaration that violates the D-C4 containment rule, or contradicts a DERIVED one. */\nexport type OrganizationUnitNarrowingViolation = {\n  readonly resourceType: string;\n  readonly reason:\n    | 'authorization_plane_resource_cannot_be_unit_narrowable'\n    | 'missing_unit_field_name'\n    /**\n     * An application named a different `unitFieldName` for a resource the ENGINE derives (#1058 R7).\n     *\n     * Refused rather than resolved either way. Letting the application win puts a read-through\n     * resource's confinement on a field no projector writes, so every caller sees nothing; letting\n     * the engine win silently makes the application's own declaration a lie it can read in its\n     * source and never observe. The remedy is to delete the declaration, which is why the message\n     * says so — the engine supplies it.\n     */\n    | 'derived_narrowing_contradicted';\n};\n\n/**\n * Fold the ENGINE's derived declarations over an application's, refusing any disagreement.\n *\n * Separate from {@link mergeOrganizationUnitNarrowingDeclarations}, and the asymmetry is the point.\n * That merge lets an APPLICATION replace an engine opt-in, because the application owns the field\n * name on its own schema. A DERIVED declaration is the opposite case: the field is the engine's, it\n * is written by the engine's own projector, and an application has no way to change where it lands.\n * So a disagreement there is not an override — it is a statement that cannot be true.\n *\n * An application declaration that AGREES is left alone rather than reported: it is redundant, not\n * wrong, and refusing redundancy would break every application that wrote down what the engine\n * would have derived anyway.\n */\nexport function foldDerivedOrganizationUnitNarrowing(\n  declared: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>,\n  derived: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>,\n): {\n  readonly merged: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>;\n  readonly violations: OrganizationUnitNarrowingViolation[];\n} {\n  const violations: OrganizationUnitNarrowingViolation[] = [];\n  const merged: Record<string, OrganizationUnitNarrowingDeclaration> = { ...declared };\n\n  for (const [resourceType, declaration] of Object.entries(derived)) {\n    if (!declaration) continue;\n    const existing = declared[resourceType];\n    if (existing !== undefined && existing.unitFieldName !== declaration.unitFieldName) {\n      violations.push({ resourceType, reason: 'derived_narrowing_contradicted' });\n    }\n    merged[resourceType] = declaration;\n  }\n\n  return { merged, violations };\n}\n\n/**\n * Validate a narrowing registry against the containment rule.\n *\n * Returns violations rather than throwing so the caller owns the failure mode — the engine boot path\n * turns these into a startup error (fail closed: a misdeclared narrowing is a silent authorization\n * hole, so the application must not start), while tooling can report them without dying.\n */\nexport function collectOrganizationUnitNarrowingViolations(\n  narrowingRegistry: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>,\n): OrganizationUnitNarrowingViolation[] {\n  const forbidden = new Set<string>(ORGANIZATION_UNIT_NARROWING_FORBIDDEN_RESOURCES);\n  const violations: OrganizationUnitNarrowingViolation[] = [];\n\n  for (const [resourceType, declaration] of Object.entries(narrowingRegistry)) {\n    if (!declaration) continue;\n    if (forbidden.has(resourceType)) {\n      violations.push({ resourceType, reason: 'authorization_plane_resource_cannot_be_unit_narrowable' });\n      continue;\n    }\n    if (typeof declaration.unitFieldName !== 'string' || declaration.unitFieldName.length === 0) {\n      violations.push({ resourceType, reason: 'missing_unit_field_name' });\n    }\n  }\n\n  return violations;\n}\n\n/**\n * Is this resource narrowed by organization unit?\n *\n * The single question every consumer asks. Reading the registry directly is how a call site ends up\n * disagreeing with the containment rule — the forbidden set is re-checked here so a registry that\n * was assembled without validation still cannot narrow the authorization plane.\n */\nexport function resolveOrganizationUnitNarrowing(\n  narrowingRegistry: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>,\n  resourceType: string,\n): OrganizationUnitNarrowingDeclaration | undefined {\n  if (ORGANIZATION_UNIT_NARROWING_FORBIDDEN_RESOURCES.includes(resourceType as CoreResourceType)) return undefined;\n  const declaration = narrowingRegistry[resourceType];\n  if (!declaration?.unitFieldName) return undefined;\n  return declaration;\n}\n"]}

package/dist/esm/organizations/organization-units.shared.path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organization-units.shared.path.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organization-units.shared.path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,sFAAsF;AACtF,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGnH;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEzF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC3B,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC,OAAO,CAET;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI/G;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAE5E;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpE"}
+{"version":3,"file":"organization-units.shared.path.d.ts","sourceRoot":"","sources":["../../../src/organizations/organization-units.shared.path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,sFAAsF;AACtF,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGnH;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEzF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC3B,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC,OAAO,CAET;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI/G;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAE5E;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpE"}

package/dist/esm/organizations/organization-units.shared.path.js.map

@@ -1 +1 @@
-{"version":3,"file":"organization-units.shared.path.js","sourceRoot":"","sources":["../../../../src/organizations/organization-units.shared.path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,sFAAsF;AACtF,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAAC,UAA4D;IACzG,IAAI,CAAC,UAAU;QAAE,OAAO,2BAA2B,CAAC;IACpD,OAAO,GAAG,6BAA6B,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAmC;IAC/E,OAAO,GAAG,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,SAA2B,EAC3B,IAAmC;IAEnC,OAAO,6BAA6B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,CAAC,CAAC;AACvG,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,cAAsB,EAAE,SAAiB,EAAE,SAAiB;IACrG,MAAM,UAAU,GAAG,6BAA6B,CAAC,cAAc,CAAC,CAAC;IACjE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,UAAU,CAAC;IACzD,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAsB;IAChE,OAAO,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,qBAAqB,CAAC,IAAsB;IAC1D,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAClD,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,6BAA6B,CAAC,IAA+B;IACpE,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,2BAA2B;QAAE,OAAO,2BAA2B,CAAC;IACtF,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7D,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC;AACrE,CAAC","sourcesContent":["/**\n * Organization-unit materialized-path contract (plan decision D-B1).\n *\n * ## Format\n *\n * `path` is the slash-delimited chain of a node's ANCESTOR ids, with a leading AND trailing slash.\n * It describes the route TO the node and deliberately does NOT include the node's own id:\n *\n * ```\n * root R                 path = \"/\"          fullKey = \"/R\"\n * child C of R           path = \"/R/\"        fullKey = \"/R/C\"\n * grandchild G of C      path = \"/R/C/\"      fullKey = \"/R/C/G\"\n * ```\n *\n * ## Why ancestors-only, rather than a self-inclusive `/R/C/G`\n *\n * A self-inclusive path cannot be computed where it must be written. The materialized path has to\n * be set on the SAME write that inserts the row (a second write would leave a window in exactly the\n * broken state this field exists to remove — a row whose `path` is empty), but a CREATE custom\n * implementation never receives the new row's `_id`: the framework passes\n * `IdOrIdsOrFilterType | undefined` as the operation target, and for CREATE there is no target yet.\n *\n * The two alternatives were rejected:\n *  - **Pre-generate the `_id` in the prefix** — id generation is adapter-specific (Mongo `ObjectId`\n *    vs SQL uuid). Minting one in domain code couples the org-unit domain to a persistence adapter.\n *  - **Write the path in a POSTFIX, after insert** — two writes per CREATE, and a failure between\n *    them persists a unit with no path. Fixing \"the required `path` is never written\" by introducing\n *    a new way for it to be missing is not a fix.\n *\n * Ancestors-only needs only the PARENT, which the prefix can read, so one write does the whole job.\n * Every property the format was chosen for survives: it is rename-stable (ids, not codes), the\n * cycle test stays a prefix comparison, and MOVE stays a prefix rewrite. The only cost is that\n * \"descendants of N\" keys off {@link organizationUnitSubtreePrefix} (`path + _id + '/'`) rather\n * than off `path` directly.\n *\n * ## Invariants\n *\n * - Always starts and ends with `/`. A root's path is exactly `/`.\n * - Contains ONLY ancestor ids, ordered root-first.\n * - Depth of a node = number of segments in `path` (a root has depth 0).\n * - Ids are opaque strings; this module never parses or validates them beyond emptiness.\n */\n\n/** The path of a unit that hangs directly under the organization (no parent unit). */\nexport const ORGANIZATION_UNIT_ROOT_PATH = '/';\n\n/**\n * The path to give a NEW child of `parentUnit`, or {@link ORGANIZATION_UNIT_ROOT_PATH} when the new\n * node is a root.\n *\n * This is the single place the \"descend one level\" rule is expressed — CREATE and MOVE both use it,\n * so a format change can never apply to one and miss the other.\n */\nexport function buildOrganizationUnitChildPath(parentUnit: { _id: string; path: string } | null | undefined): string {\n  if (!parentUnit) return ORGANIZATION_UNIT_ROOT_PATH;\n  return `${normalizeOrganizationUnitPath(parentUnit.path)}${parentUnit._id}/`;\n}\n\n/**\n * The prefix EVERY descendant of `unit` carries in its own `path`.\n *\n * `descendants(N) === { row | row.path.startsWith(subtreePrefix(N)) }`. Note this correctly EXCLUDES\n * `N` itself, whose path stops one level short.\n */\nexport function organizationUnitSubtreePrefix(unit: { _id: string; path: string }): string {\n  return `${normalizeOrganizationUnitPath(unit.path)}${unit._id}/`;\n}\n\n/**\n * Is `candidate` inside `unit`'s subtree (strictly below it)?\n *\n * The O(1) cycle test MOVE depends on: re-parenting `unit` under one of its own descendants would\n * detach the branch from the tree and strand it in a ring.\n */\nexport function isOrganizationUnitInSubtree(\n  candidate: { path: string },\n  unit: { _id: string; path: string },\n): boolean {\n  return normalizeOrganizationUnitPath(candidate.path).startsWith(organizationUnitSubtreePrefix(unit));\n}\n\n/**\n * Rewrite one descendant's path when its ancestor moves.\n *\n * MOVE changes only the prefix above the moved node; everything from the moved node downward keeps\n * its relative shape. Swapping the old subtree prefix for the new one therefore re-homes an entire\n * branch without re-deriving any node's position.\n *\n * Returns the path unchanged when it does not carry `oldPrefix`, so a caller that over-scans cannot\n * corrupt unrelated rows.\n */\nexport function rebaseOrganizationUnitPath(descendantPath: string, oldPrefix: string, newPrefix: string): string {\n  const normalized = normalizeOrganizationUnitPath(descendantPath);\n  if (!normalized.startsWith(oldPrefix)) return normalized;\n  return `${newPrefix}${normalized.slice(oldPrefix.length)}`;\n}\n\n/**\n * The ancestor ids of a node, root-first — the ready-made input for a breadcrumb.\n *\n * Human-readable breadcrumbs are rendered from these ids against already-loaded ancestor rows; a\n * second, name-based path is deliberately NOT persisted (it would have to be rewritten on every\n * rename, and `code` is optional so it is not always well-formed).\n */\nexport function organizationUnitAncestorIds(unit: { path: string }): string[] {\n  return normalizeOrganizationUnitPath(unit.path).split('/').filter((segment) => segment.length > 0);\n}\n\n/** Depth of a node in the tree; a root is depth 0. */\nexport function organizationUnitDepth(unit: { path: string }): number {\n  return organizationUnitAncestorIds(unit).length;\n}\n\n/**\n * Coerce a stored path to the canonical bounded form.\n *\n * Defensive rather than decorative: rows written before `path` was materialized carry `undefined` or\n * `''`, and treating those as the root path keeps a legacy row addressable instead of throwing\n * mid-traversal. A value missing its delimiters would otherwise make `startsWith` comparisons match\n * across sibling ids (`/R1` would prefix-match `/R12`), which is precisely how a materialized-path\n * scheme silently leaks rows between branches.\n */\nfunction normalizeOrganizationUnitPath(path: string | null | undefined): string {\n  if (!path || path === ORGANIZATION_UNIT_ROOT_PATH) return ORGANIZATION_UNIT_ROOT_PATH;\n  const withLeading = path.startsWith('/') ? path : `/${path}`;\n  return withLeading.endsWith('/') ? withLeading : `${withLeading}/`;\n}\n"]}
+{"version":3,"file":"organization-units.shared.path.js","sourceRoot":"","sources":["../../../src/organizations/organization-units.shared.path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,sFAAsF;AACtF,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAAC,UAA4D;IACzG,IAAI,CAAC,UAAU;QAAE,OAAO,2BAA2B,CAAC;IACpD,OAAO,GAAG,6BAA6B,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAmC;IAC/E,OAAO,GAAG,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,SAA2B,EAC3B,IAAmC;IAEnC,OAAO,6BAA6B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,CAAC,CAAC;AACvG,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,cAAsB,EAAE,SAAiB,EAAE,SAAiB;IACrG,MAAM,UAAU,GAAG,6BAA6B,CAAC,cAAc,CAAC,CAAC;IACjE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,UAAU,CAAC;IACzD,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAsB;IAChE,OAAO,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,qBAAqB,CAAC,IAAsB;IAC1D,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAClD,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,6BAA6B,CAAC,IAA+B;IACpE,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,2BAA2B;QAAE,OAAO,2BAA2B,CAAC;IACtF,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7D,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC;AACrE,CAAC","sourcesContent":["/**\n * Organization-unit materialized-path contract (plan decision D-B1).\n *\n * ## Format\n *\n * `path` is the slash-delimited chain of a node's ANCESTOR ids, with a leading AND trailing slash.\n * It describes the route TO the node and deliberately does NOT include the node's own id:\n *\n * ```\n * root R                 path = \"/\"          fullKey = \"/R\"\n * child C of R           path = \"/R/\"        fullKey = \"/R/C\"\n * grandchild G of C      path = \"/R/C/\"      fullKey = \"/R/C/G\"\n * ```\n *\n * ## Why ancestors-only, rather than a self-inclusive `/R/C/G`\n *\n * A self-inclusive path cannot be computed where it must be written. The materialized path has to\n * be set on the SAME write that inserts the row (a second write would leave a window in exactly the\n * broken state this field exists to remove — a row whose `path` is empty), but a CREATE custom\n * implementation never receives the new row's `_id`: the framework passes\n * `IdOrIdsOrFilterType | undefined` as the operation target, and for CREATE there is no target yet.\n *\n * The two alternatives were rejected:\n *  - **Pre-generate the `_id` in the prefix** — id generation is adapter-specific (Mongo `ObjectId`\n *    vs SQL uuid). Minting one in domain code couples the org-unit domain to a persistence adapter.\n *  - **Write the path in a POSTFIX, after insert** — two writes per CREATE, and a failure between\n *    them persists a unit with no path. Fixing \"the required `path` is never written\" by introducing\n *    a new way for it to be missing is not a fix.\n *\n * Ancestors-only needs only the PARENT, which the prefix can read, so one write does the whole job.\n * Every property the format was chosen for survives: it is rename-stable (ids, not codes), the\n * cycle test stays a prefix comparison, and MOVE stays a prefix rewrite. The only cost is that\n * \"descendants of N\" keys off {@link organizationUnitSubtreePrefix} (`path + _id + '/'`) rather\n * than off `path` directly.\n *\n * ## Invariants\n *\n * - Always starts and ends with `/`. A root's path is exactly `/`.\n * - Contains ONLY ancestor ids, ordered root-first.\n * - Depth of a node = number of segments in `path` (a root has depth 0).\n * - Ids are opaque strings; this module never parses or validates them beyond emptiness.\n */\n\n/** The path of a unit that hangs directly under the organization (no parent unit). */\nexport const ORGANIZATION_UNIT_ROOT_PATH = '/';\n\n/**\n * The path to give a NEW child of `parentUnit`, or {@link ORGANIZATION_UNIT_ROOT_PATH} when the new\n * node is a root.\n *\n * This is the single place the \"descend one level\" rule is expressed — CREATE and MOVE both use it,\n * so a format change can never apply to one and miss the other.\n */\nexport function buildOrganizationUnitChildPath(parentUnit: { _id: string; path: string } | null | undefined): string {\n  if (!parentUnit) return ORGANIZATION_UNIT_ROOT_PATH;\n  return `${normalizeOrganizationUnitPath(parentUnit.path)}${parentUnit._id}/`;\n}\n\n/**\n * The prefix EVERY descendant of `unit` carries in its own `path`.\n *\n * `descendants(N) === { row | row.path.startsWith(subtreePrefix(N)) }`. Note this correctly EXCLUDES\n * `N` itself, whose path stops one level short.\n */\nexport function organizationUnitSubtreePrefix(unit: { _id: string; path: string }): string {\n  return `${normalizeOrganizationUnitPath(unit.path)}${unit._id}/`;\n}\n\n/**\n * Is `candidate` inside `unit`'s subtree (strictly below it)?\n *\n * The O(1) cycle test MOVE depends on: re-parenting `unit` under one of its own descendants would\n * detach the branch from the tree and strand it in a ring.\n */\nexport function isOrganizationUnitInSubtree(\n  candidate: { path: string },\n  unit: { _id: string; path: string },\n): boolean {\n  return normalizeOrganizationUnitPath(candidate.path).startsWith(organizationUnitSubtreePrefix(unit));\n}\n\n/**\n * Rewrite one descendant's path when its ancestor moves.\n *\n * MOVE changes only the prefix above the moved node; everything from the moved node downward keeps\n * its relative shape. Swapping the old subtree prefix for the new one therefore re-homes an entire\n * branch without re-deriving any node's position.\n *\n * Returns the path unchanged when it does not carry `oldPrefix`, so a caller that over-scans cannot\n * corrupt unrelated rows.\n */\nexport function rebaseOrganizationUnitPath(descendantPath: string, oldPrefix: string, newPrefix: string): string {\n  const normalized = normalizeOrganizationUnitPath(descendantPath);\n  if (!normalized.startsWith(oldPrefix)) return normalized;\n  return `${newPrefix}${normalized.slice(oldPrefix.length)}`;\n}\n\n/**\n * The ancestor ids of a node, root-first — the ready-made input for a breadcrumb.\n *\n * Human-readable breadcrumbs are rendered from these ids against already-loaded ancestor rows; a\n * second, name-based path is deliberately NOT persisted (it would have to be rewritten on every\n * rename, and `code` is optional so it is not always well-formed).\n */\nexport function organizationUnitAncestorIds(unit: { path: string }): string[] {\n  return normalizeOrganizationUnitPath(unit.path).split('/').filter((segment) => segment.length > 0);\n}\n\n/** Depth of a node in the tree; a root is depth 0. */\nexport function organizationUnitDepth(unit: { path: string }): number {\n  return organizationUnitAncestorIds(unit).length;\n}\n\n/**\n * Coerce a stored path to the canonical bounded form.\n *\n * Defensive rather than decorative: rows written before `path` was materialized carry `undefined` or\n * `''`, and treating those as the root path keeps a legacy row addressable instead of throwing\n * mid-traversal. A value missing its delimiters would otherwise make `startsWith` comparisons match\n * across sibling ids (`/R1` would prefix-match `/R12`), which is precisely how a materialized-path\n * scheme silently leaks rows between branches.\n */\nfunction normalizeOrganizationUnitPath(path: string | null | undefined): string {\n  if (!path || path === ORGANIZATION_UNIT_ROOT_PATH) return ORGANIZATION_UNIT_ROOT_PATH;\n  const withLeading = path.startsWith('/') ? path : `/${path}`;\n  return withLeading.endsWith('/') ? withLeading : `${withLeading}/`;\n}\n"]}

package/dist/esm/organizations/organization-units.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organization-units.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organization-units.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAoD,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAU/H,oBAAY,2BAA2B;IACrC,IAAI,SAAS,CAAE,gCAAgC;IAC/C,OAAO,YAAY,CAAE,eAAe;IACpC,OAAO,YAAY;CACpB;AASD,KAAK,8BAA8B,GAC/B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAKjC,eAAO,MAAM,2DAA2D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;mBAsLxH,CAAC"}
+{"version":3,"file":"organization-units.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/organizations/organization-units.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAoD,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAU/H,oBAAY,2BAA2B;IACrC,IAAI,SAAS,CAAE,gCAAgC;IAC/C,OAAO,YAAY,CAAE,eAAe;IACpC,OAAO,YAAY;CACpB;AASD,KAAK,8BAA8B,GAC/B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAKjC,eAAO,MAAM,2DAA2D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;mBA2LxH,CAAC"}

package/dist/esm/organizations/organization-units.shared.resources-config.schemas.js

@@ -89,7 +89,8 @@ export const organizationUnitResourceConfiguration_InitializationFactory = (reso
                     roles: [CORE_ORG_ROLES.ORG_MEMBER],
                     riskLevel: ResourceOperationRiskLevel.LOW,
                     isSearchable: true,
-                    searchableFields: ['name', 'description'],
+                    // A unit has a `code`, not a `description` (#1952).
+                    searchableFields: ['name', 'code'],
                     searchableOptions: { caseSensitive: false, fullMatchOnly: false },
                     filterFields: ORGANIZATION_UNIT_FILTER_FIELDS,
                     sortFields: ORGANIZATION_UNIT_SORT_FIELDS,
@@ -140,8 +141,10 @@ export const organizationUnitResourceConfiguration_InitializationFactory = (reso
                     auditableEvent: { reasonField: 'reason' },
                     resourceOperationLike: CoreResourceOperation.UPDATE,
                     requestDto: z.object({
-                        newParentUnitId: z.string().optional(),
+                        newParentUnitId: z.string().optional()
+                            .describe('The unit to move this unit under, within the same organization. Omit it to make the unit a top-level unit. The whole subtree moves with it; a unit cannot be moved under itself or one of its own descendants.'),
                         reason: z.string().max(500).optional()
+                            .describe('Why the unit is being moved. Recorded with the audit event for the move.')
                     }),
                 }
             ],
@@ -163,6 +166,7 @@ export const organizationUnitResourceConfiguration_InitializationFactory = (reso
                     resourceOperationLike: CoreResourceOperation.UPDATE,
                     requestDto: z.object({
                         reason: z.string().min(1).max(500)
+                            .describe('Why the unit is being archived. Recorded with the audit event for the archive.')
                     }),
                 }
             ],
@@ -184,6 +188,7 @@ export const organizationUnitResourceConfiguration_InitializationFactory = (reso
                     resourceOperationLike: CoreResourceOperation.UPDATE,
                     requestDto: z.object({
                         reason: z.string().max(500).optional()
+                            .describe('Why the unit is being restored. Recorded with the audit event for the restore.')
                     }),
                 }
             ],

package/dist/esm/organizations/organization-units.shared.resources-config.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"organization-units.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-units.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization Unit Shared Resource Configuration\n *\n * Resource configuration for organization unit management.\n * Comprehensive unit lifecycle and hierarchical organization management.\n */\n\nimport { z } from 'zod';\nimport { OrganizationUnitSchema } from './organization-units.shared.schemas';\nimport { CoreResourceOperation } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationRiskLevel, ResourcePrimaryScope, ResourceRelationship } from '../resources/resources.shared.schemas';\nimport { CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationVariantType } from '../resources/resources.shared.schemas';\nimport { CoreUserNotificationTarget, CoreUserNotificationChannel } from '../notifications/notifications.shared.schemas';\n\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\n\nimport { CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\n\n// Custom operations enum for organization units\nexport enum OrganizationUnit_Operations {\n  MOVE = 'move', // Move unit to different parent\n  ARCHIVE = 'archive', // Archive unit\n  RESTORE = 'restore', // Restore archived unit\n}\n\nconst ORGANIZATION_UNIT_SORT_FIELDS = ['name', 'createdAt'];\n\nconst ORGANIZATION_UNIT_FILTER_FIELDS = {\n  name: z.string(),\n  parentUnitId: z.string(),\n};\n\ntype OrganizationUnitCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.SEARCH\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.DELETE;\n\n/*\nOrganization Unit Resource Configuration Factory\n*/\nexport const organizationUnitResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  typeof OrganizationUnit_Operations,\n  OrganizationUnitCoreOperations,\n  typeof OrganizationUnitSchema\n>({\n  mainSchema: OrganizationUnitSchema,\n  resourceIdentifier: CoreResourceType.ORGANIZATION_UNITS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATION_UNITS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.SEARCH,\n    CoreResourceOperation.CREATE,\n    CoreResourceOperation.UPDATE,\n    CoreResourceOperation.DELETE,\n  ],\n\n  customOperation: OrganizationUnit_Operations,\n\n  operationsConfiguration: {\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can create units\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          // requestDto auto-derived from decorators\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.READ]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER], // Org members can view units\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.LIST]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER], // Org members can list units\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.SEARCH]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n          isSearchable: true,\n          searchableFields: ['name', 'description'],\n          searchableOptions: { caseSensitive: false, fullMatchOnly: false },\n          filterFields: ORGANIZATION_UNIT_FILTER_FIELDS,\n          sortFields: ORGANIZATION_UNIT_SORT_FIELDS,\n          maxPaginatedResultPerPageLimit: 50,\n        }\n      ],\n    },\n\n    [CoreResourceOperation.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can update units\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          // requestDto auto-derived from decorators\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.DELETE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can delete units\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    },\n\n    [OrganizationUnit_Operations.MOVE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can move units\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n          auditableEvent: { reasonField: 'reason' },\n          resourceOperationLike: CoreResourceOperation.UPDATE,\n          requestDto: z.object({\n            newParentUnitId: z.string().optional(),\n            reason: z.string().max(500).optional()\n          }),\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    },\n\n    [OrganizationUnit_Operations.ARCHIVE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can archive units\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n          auditableEvent: { reasonField: 'reason' },\n          resourceOperationLike: CoreResourceOperation.UPDATE,\n          requestDto: z.object({\n            reason: z.string().min(1).max(500)\n          }),\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    },\n\n    [OrganizationUnit_Operations.RESTORE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can restore units\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          auditableEvent: { auditBelowRiskFloor: true, reasonField: 'reason' },\n          resourceOperationLike: CoreResourceOperation.UPDATE,\n          requestDto: z.object({\n            reason: z.string().max(500).optional()\n          }),\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    }\n  },\n});\n"]}
+{"version":3,"file":"organization-units.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/organizations/organization-units.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization Unit Shared Resource Configuration\n *\n * Resource configuration for organization unit management.\n * Comprehensive unit lifecycle and hierarchical organization management.\n */\n\nimport { z } from 'zod';\nimport { OrganizationUnitSchema } from './organization-units.shared.schemas';\nimport { CoreResourceOperation } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationRiskLevel, ResourcePrimaryScope, ResourceRelationship } from '../resources/resources.shared.schemas';\nimport { CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationVariantType } from '../resources/resources.shared.schemas';\nimport { CoreUserNotificationTarget, CoreUserNotificationChannel } from '../notifications/notifications.shared.schemas';\n\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\n\nimport { CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\n\n// Custom operations enum for organization units\nexport enum OrganizationUnit_Operations {\n  MOVE = 'move', // Move unit to different parent\n  ARCHIVE = 'archive', // Archive unit\n  RESTORE = 'restore', // Restore archived unit\n}\n\nconst ORGANIZATION_UNIT_SORT_FIELDS = ['name', 'createdAt'];\n\nconst ORGANIZATION_UNIT_FILTER_FIELDS = {\n  name: z.string(),\n  parentUnitId: z.string(),\n};\n\ntype OrganizationUnitCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.SEARCH\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.DELETE;\n\n/*\nOrganization Unit Resource Configuration Factory\n*/\nexport const organizationUnitResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  typeof OrganizationUnit_Operations,\n  OrganizationUnitCoreOperations,\n  typeof OrganizationUnitSchema\n>({\n  mainSchema: OrganizationUnitSchema,\n  resourceIdentifier: CoreResourceType.ORGANIZATION_UNITS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATION_UNITS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.SEARCH,\n    CoreResourceOperation.CREATE,\n    CoreResourceOperation.UPDATE,\n    CoreResourceOperation.DELETE,\n  ],\n\n  customOperation: OrganizationUnit_Operations,\n\n  operationsConfiguration: {\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can create units\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          // requestDto auto-derived from decorators\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.READ]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER], // Org members can view units\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.LIST]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER], // Org members can list units\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.SEARCH]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n          isSearchable: true,\n          // A unit has a `code`, not a `description` (#1952).\n          searchableFields: ['name', 'code'],\n          searchableOptions: { caseSensitive: false, fullMatchOnly: false },\n          filterFields: ORGANIZATION_UNIT_FILTER_FIELDS,\n          sortFields: ORGANIZATION_UNIT_SORT_FIELDS,\n          maxPaginatedResultPerPageLimit: 50,\n        }\n      ],\n    },\n\n    [CoreResourceOperation.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can update units\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          // requestDto auto-derived from decorators\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.DELETE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can delete units\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    },\n\n    [OrganizationUnit_Operations.MOVE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can move units\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n          auditableEvent: { reasonField: 'reason' },\n          resourceOperationLike: CoreResourceOperation.UPDATE,\n          requestDto: z.object({\n            newParentUnitId: z.string().optional()\n              .describe('The unit to move this unit under, within the same organization. Omit it to make the unit a top-level unit. The whole subtree moves with it; a unit cannot be moved under itself or one of its own descendants.'),\n            reason: z.string().max(500).optional()\n              .describe('Why the unit is being moved. Recorded with the audit event for the move.')\n          }),\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    },\n\n    [OrganizationUnit_Operations.ARCHIVE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can archive units\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n          auditableEvent: { reasonField: 'reason' },\n          resourceOperationLike: CoreResourceOperation.UPDATE,\n          requestDto: z.object({\n            reason: z.string().min(1).max(500)\n              .describe('Why the unit is being archived. Recorded with the audit event for the archive.')\n          }),\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    },\n\n    [OrganizationUnit_Operations.RESTORE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN], // Org admins can restore units\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          auditableEvent: { auditBelowRiskFloor: true, reasonField: 'reason' },\n          resourceOperationLike: CoreResourceOperation.UPDATE,\n          requestDto: z.object({\n            reason: z.string().max(500).optional()\n              .describe('Why the unit is being restored. Recorded with the audit event for the restore.')\n          }),\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.ORGANIZATION_ADMINISTRATIVE,\n          channel: CoreUserNotificationChannel.EMAIL,\n        }\n      ]\n    }\n  },\n});\n"]}

package/dist/esm/organizations/organization-units.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organization-units.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organization-units.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AAMnG;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB;AAED,oBAAY,sBAAsB;IAChC,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,oBAAY,0CAA0C;IACpD,qEAAqE;IACrE,YAAY,iBAAiB;IAC7B,wGAAwG;IACxG,cAAc,mBAAmB;CAClC;AAGD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;kBA4FlC,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAED,eAAO,MAAM,8BAA8B,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAG7E,CAAC"}
+{"version":3,"file":"organization-units.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/organizations/organization-units.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AAMnG;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB;AAED,oBAAY,sBAAsB;IAChC,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,oBAAY,0CAA0C;IACpD,qEAAqE;IACrE,YAAY,iBAAiB;IAC7B,wGAAwG;IACxG,cAAc,mBAAmB;CAClC;AAGD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;kBA4FlC,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAED,eAAO,MAAM,8BAA8B,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAG7E,CAAC"}

package/dist/esm/organizations/organization-units.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"organization-units.shared.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-units.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization Unit Shared Schemas\n * \n * Hierarchical organizational structures for enterprise access control.\n * Supports nested organizational units with downward-only permission-inheritance rules.\n *\n * Units ARE an authorization axis (WS-C, shipped 2026-08-01): a member's per-unit role is emitted\n * into `initiatorRoles` as a narrowed grant, and for resources that opt into unit narrowing it admits\n * the member at the operation gate and confines their rows to the units that grant covers —\n * propagating to descendants where {@link OrganizationUnit_PermissionInheritanceType.INHERIT_DOWN}\n * says so. A unit is a NARROWING dimension inside `ResourcePrimaryScope.ORGANIZATIONS`, never a scope\n * of its own (decision D-C1), so tenant isolation is unchanged.\n *\n * Narrowing is strictly opt-in per resource and ADDITIVE: an organization-wide role that already\n * satisfies an operation is never confined. See\n * `.claude/plans/tenant-teardown-and-organization-units-domain.md` (WS-C).\n */\n\nimport { z } from 'zod';\n\nimport { ErrorCustomMessageReference } from '../errors/errors.custom-message-ref.shared.definitions';\nimport { ExternalIdentitySource } from '../security/authentications/authentication.shared.schemas';\n\n// ===============================\n// ORGANIZATION UNIT ENUMS\n// ===============================\n\n/**\n * Organization unit type enum\n */\nexport enum OrganizationUnitType {\n  COMPANY = 'company',\n  DIVISION = 'division',\n  DEPARTMENT = 'department',\n  TEAM = 'team',\n  SUBTEAM = 'subteam',\n  PROJECT_GROUP = 'project_group',\n  GEOGRAPHIC = 'geographic',\n  FUNCTIONAL = 'functional',\n  CUSTOM = 'custom'\n}\n\nexport enum OrganizationUnitStatus {\n  ACTIVE = 'active',\n  INACTIVE = 'inactive',\n  ARCHIVED = 'archived',\n  SUSPENDED = 'suspended'\n}\n\n/**\n * Direction in which a role held at one unit propagates across that unit's hierarchy edges.\n *\n * DOWNWARD ONLY, BY DESIGN. Only two directions exist, and that is a deliberate security\n * constraint rather than an unfinished vocabulary. A role granted at a unit may widen to that\n * unit's DESCENDANTS (the intuitive \"a division manager manages its teams\") or to nothing at all.\n *\n * `INHERIT_UP` and `BOTH_DIRECTIONS` were REMOVED (2026-07-31, decision D-C2). Upward propagation\n * means a role held at a leaf confers authority over its ANCESTORS — a team lead acquiring\n * division-wide authority by virtue of sitting inside it. That is privilege escalation along the\n * org chart, and it is the exact shape the role-ceiling gate\n * (`assertRequestedRolesWithinCallerCeiling`) exists to prevent on every other role-granting\n * surface; offering it as a one-field toggle here would have re-opened it structurally.\n *\n * If upward VISIBILITY is genuinely needed (\"a division head sees rolled-up team data\"), model it\n * as a reporting/aggregation concern — a read projection over the subtree — NOT as role\n * propagation. The two are different semantics and merging them costs the fail-closed guarantee.\n *\n * ENFORCED since 2026-08-01 (WS-C phase 3). The authorization gate expands a unit-scoped grant across\n * this edge before stamping it on the execution context, so the value governs how far the grant\n * actually reaches on every narrowed resource — read and write alike. The expansion is a PREFIX test\n * over the materialized `path`, never a recursive walk.\n *\n * ⚠️ Enforcement reads this field literally: an ABSENT value is treated as `NO_INHERITANCE`, which\n * deliberately differs from the write-time default below. A row reaching an authorization decision\n * without the field bypassed the schema that would have supplied that default, and a grant must never\n * widen on data the authorizer cannot vouch for.\n *\n * ⚠️ A grant at a ROOT unit with downward inheritance reaches the entire chart — functionally\n * organization-wide access assembled from one narrow grant. That is sound under the additive model but\n * must stay legible, which is why the access record reports directly-held and inherited units\n * separately (decision D-C4, watch item 4).\n *\n * assurance-control: WILDO.ACCESS.LEAST_PRIVILEGE — least-privilege by construction: the\n * vocabulary cannot express an upward privilege grant.\n */\nexport enum OrganizationUnit_PermissionInheritanceType {\n  /** A role held at this unit also applies to its descendant units. */\n  INHERIT_DOWN = 'inherit_down',\n  /** A role held at this unit applies to this unit only; the node is isolated for permission purposes. */\n  NO_INHERITANCE = 'no_inheritance',\n}\n\n\n/**\n * A node of an organization's tree.\n *\n * **Business key — `code` is unique among siblings.** Declared here rather than only in the\n * application guard because the guard is a read-then-write: two concurrent CREATEs of the same code\n * under the same parent can each find nothing and each succeed. The compound index closes that\n * window at the database.\n *\n * BOTH adapters enforce it. This said the index was a \"MongoDB-only guarantee today\" because the SQL\n * planner only records uniqueness as intent — true of the PLANNER, and stale about the system:\n * enforcement is migration-owned and the migrations exist, so a PostgreSQL-backed application really\n * does carry\n * `create unique index … (\"organizationId\", \"parentUnitId\", \"code\") nulls not distinct where \"code\"\n * is not null` (read from `wonder-crm`'s initial schema, 2026-09-20). Corrected rather than deleted\n * because the reasoning is what a reader needs: the plan is INTENT, the migration is ENFORCEMENT, and\n * a resource change is not finished until every PostgreSQL-backed surface has one\n * (`.claude/rules/engine-resource-changes-owe-migrations.md`).\n *\n * The application guard in the unit custom implementation is KEPT anyway — not as a cross-adapter\n * backstop now, but because it raises the same\n * {@link ErrorCustomMessageReference.ORGANIZATION_UNIT_CODE_EXISTS} the index maps to, so a client\n * sees one code for one condition whichever layer catches it first.\n */\nexport const OrganizationUnitSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n  /**\n   * The parent node of this unit; absent on a root that hangs directly under the organization.\n   *\n   * `.excludeFromUpdate()` (plan decision D-B2): re-parenting is owned exclusively by the MOVE\n   * operation. A reparent has a subtree-wide side effect — every descendant's materialized\n   * {@link OrganizationUnitSchema.shape.path} has to be rewritten — and it must be refused when the\n   * destination sits inside the moved node's own subtree. Generic UPDATE performs neither, so\n   * allowing it here would silently produce a tree whose paths describe a shape that no longer\n   * exists, or a detached cycle. One operation, one authority.\n   */\n  parentUnitId: z.string().optional().isDBIndexed().isForeignKey().excludeFromUpdate(),\n  status: z.enum(OrganizationUnitStatus).default(OrganizationUnitStatus.ACTIVE).isDBIndexed().isSummaryField(),\n  inheritanceType: z.enum(OrganizationUnit_PermissionInheritanceType).default(OrganizationUnit_PermissionInheritanceType.INHERIT_DOWN).isDBIndexed(),\n  \n  path: z.string().isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  \n  // Unit Identity\n  name: z.string().min(1).max(100).isDBIndexed().isSummaryField(),\n  /**\n   * Short human-assigned handle for the unit, unique among its siblings — see the\n   * {@link OrganizationUnitSchema} business key below for the exact scope and why it is optional.\n   */\n  code: z.string().min(1).max(20).optional(),\n  type: z.enum(OrganizationUnitType).optional().isDBIndexed().isSummaryField(),\n\n  /**\n   * Which external system ASSERTS this unit — present only on a unit a directory created.\n   *\n   * Set to {@link ExternalIdentitySource.SCIM} by `POST /scim/v2/Groups` and by nothing else. It is the\n   * ownership marker the SCIM Groups path keys on, and it has two jobs:\n   *\n   * 1. **`/Groups` reads and mutates ONLY units carrying it.** A hand-made unit answers 404 there.\n   *    Entra locates a group by `displayName` before creating it, so exposing every unit would let a\n   *    directory adopt a hand-authored \"Sales\" unit by name and start rewriting its membership —\n   *    name-matching into an authorization axis, which `scim-organization-unit-mapping.shared.ts`\n   *    refuses for the department path for the same reason.\n   * 2. **The department path never removes an assignment on such a unit** — see\n   *    `resolveScimOrganizationUnitReconciliation`. Without that, every `/Users` push in an\n   *    organization using the department mapping would delete the memberships `/Groups` made, and a\n   *    directory that only sends membership DELTAS would never restore them.\n   *\n   * Why this is NOT derived from {@link OrganizationUnitSchema.shape.externalId}: Okta creates a group\n   * with `schemas`, `displayName` and `members` only, so a unit can be directory-owned and carry no\n   * `externalId` at all. Ownership and the directory's own identifier are two facts.\n   *\n   * `.excludeFromCreate()` / `.excludeFromUpdate()`: never client-settable. An organization admin who\n   * could set it would hand a unit's membership to the directory; one who could clear it would strand\n   * a group the directory still believes it manages.\n   *\n   * `.isSummaryField()`: the admin screen lists units through their SUMMARY projection, and this is\n   * the one fact that explains why a rename there does not stick (#1392) — so it travels with the\n   * row, like `status`, rather than only on the full read.\n   */\n  externalSource: z.enum(ExternalIdentitySource).optional().isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate(),\n  /**\n   * The DIRECTORY's own identifier for the group this unit represents (SCIM `externalId`).\n   *\n   * Client-owned by the protocol: the provisioning client issues it and the service provider stores\n   * it, while the SCIM resource `id` is this unit's `_id`. `UserIdentityLink.providerUserId` is the\n   * same idea one resource over.\n   *\n   * Unique PER ORGANIZATION and sparse — most units have no directory group. Planned as the composite\n   * `[organizationId, externalId]` on both adapters; on PostgreSQL the index is PARTIAL\n   * (`where \"externalId\" is not null`), and that predicate, not `nulls not distinct`, is what lets any\n   * number of group-less units coexist (measured on PostgreSQL 17.11, 2026-09-20).\n   *\n   * ⚠️ NEVER write an explicit `null` here. The MongoDB index is a partial filter on\n   * `{ externalId: { $exists: true } }`, and `$exists: true` matches a stored `null` — so the SECOND\n   * unit in an organization to be \"cleared\" with `null` collides, while PostgreSQL accepts it. An\n   * absent value must be an absent key. The SCIM Groups controller therefore never clears it.\n   *\n   * `.excludeFromCreate()` / `.excludeFromUpdate()` for the same reason as `externalSource`: only the\n   * directory, through the trusted SCIM door, states it.\n   */\n  externalId: z.string().min(1).max(255).optional().isUnique({ scope: 'organization', sparse: true }).excludeFromCreate().excludeFromUpdate(),\n\n  createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n}).businessKeySet(\n  ['organizationId', 'parentUnitId', 'code'],\n  {\n    // A row with no `code` has no key at all, so it must sit OUTSIDE the constraint: any number of\n    // code-less siblings under one parent is legitimate. `parentUnitId` is deliberately NOT listed\n    // — an absent parent means \"root\", which is a real position in the tree, so roots must still\n    // collide with each other. Listing it would exclude every root from the index and quietly lose\n    // uniqueness for exactly the nodes an org chart starts with.\n    skipRowsMissing: ['code'],\n    conflictMessageReference: ErrorCustomMessageReference.ORGANIZATION_UNIT_CODE_EXISTS,\n  },\n);\nexport type OrganizationUnit = z.infer<typeof OrganizationUnitSchema>;\n\n// RECURSIVE type - keep explicit interface\nexport interface OrganizationUnitTreeNode {\n  unit: OrganizationUnit;\n  children: OrganizationUnitTreeNode[];\n}\n\nexport const OrganizationUnitTreeNodeSchema: z.ZodType<OrganizationUnitTreeNode> = z.object({\n  unit: OrganizationUnitSchema,\n  children: z.array(z.lazy(() => OrganizationUnitTreeNodeSchema)).default([]),\n});\n\n"]}
+{"version":3,"file":"organization-units.shared.schemas.js","sourceRoot":"","sources":["../../../src/organizations/organization-units.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization Unit Shared Schemas\n * \n * Hierarchical organizational structures for enterprise access control.\n * Supports nested organizational units with downward-only permission-inheritance rules.\n *\n * Units ARE an authorization axis (WS-C, shipped 2026-08-01): a member's per-unit role is emitted\n * into `initiatorRoles` as a narrowed grant, and for resources that opt into unit narrowing it admits\n * the member at the operation gate and confines their rows to the units that grant covers —\n * propagating to descendants where {@link OrganizationUnit_PermissionInheritanceType.INHERIT_DOWN}\n * says so. A unit is a NARROWING dimension inside `ResourcePrimaryScope.ORGANIZATIONS`, never a scope\n * of its own (decision D-C1), so tenant isolation is unchanged.\n *\n * Narrowing is strictly opt-in per resource and ADDITIVE: an organization-wide role that already\n * satisfies an operation is never confined. See\n * `.claude/plans/tenant-teardown-and-organization-units-domain.md` (WS-C).\n */\n\nimport { z } from 'zod';\n\nimport { ErrorCustomMessageReference } from '../errors/errors.custom-message-ref.shared.definitions';\nimport { ExternalIdentitySource } from '../security/authentications/authentication.shared.schemas';\n\n// ===============================\n// ORGANIZATION UNIT ENUMS\n// ===============================\n\n/**\n * Organization unit type enum\n */\nexport enum OrganizationUnitType {\n  COMPANY = 'company',\n  DIVISION = 'division',\n  DEPARTMENT = 'department',\n  TEAM = 'team',\n  SUBTEAM = 'subteam',\n  PROJECT_GROUP = 'project_group',\n  GEOGRAPHIC = 'geographic',\n  FUNCTIONAL = 'functional',\n  CUSTOM = 'custom'\n}\n\nexport enum OrganizationUnitStatus {\n  ACTIVE = 'active',\n  INACTIVE = 'inactive',\n  ARCHIVED = 'archived',\n  SUSPENDED = 'suspended'\n}\n\n/**\n * Direction in which a role held at one unit propagates across that unit's hierarchy edges.\n *\n * DOWNWARD ONLY, BY DESIGN. Only two directions exist, and that is a deliberate security\n * constraint rather than an unfinished vocabulary. A role granted at a unit may widen to that\n * unit's DESCENDANTS (the intuitive \"a division manager manages its teams\") or to nothing at all.\n *\n * `INHERIT_UP` and `BOTH_DIRECTIONS` were REMOVED (2026-07-31, decision D-C2). Upward propagation\n * means a role held at a leaf confers authority over its ANCESTORS — a team lead acquiring\n * division-wide authority by virtue of sitting inside it. That is privilege escalation along the\n * org chart, and it is the exact shape the role-ceiling gate\n * (`assertRequestedRolesWithinCallerCeiling`) exists to prevent on every other role-granting\n * surface; offering it as a one-field toggle here would have re-opened it structurally.\n *\n * If upward VISIBILITY is genuinely needed (\"a division head sees rolled-up team data\"), model it\n * as a reporting/aggregation concern — a read projection over the subtree — NOT as role\n * propagation. The two are different semantics and merging them costs the fail-closed guarantee.\n *\n * ENFORCED since 2026-08-01 (WS-C phase 3). The authorization gate expands a unit-scoped grant across\n * this edge before stamping it on the execution context, so the value governs how far the grant\n * actually reaches on every narrowed resource — read and write alike. The expansion is a PREFIX test\n * over the materialized `path`, never a recursive walk.\n *\n * ⚠️ Enforcement reads this field literally: an ABSENT value is treated as `NO_INHERITANCE`, which\n * deliberately differs from the write-time default below. A row reaching an authorization decision\n * without the field bypassed the schema that would have supplied that default, and a grant must never\n * widen on data the authorizer cannot vouch for.\n *\n * ⚠️ A grant at a ROOT unit with downward inheritance reaches the entire chart — functionally\n * organization-wide access assembled from one narrow grant. That is sound under the additive model but\n * must stay legible, which is why the access record reports directly-held and inherited units\n * separately (decision D-C4, watch item 4).\n *\n * assurance-control: WILDO.ACCESS.LEAST_PRIVILEGE — least-privilege by construction: the\n * vocabulary cannot express an upward privilege grant.\n */\nexport enum OrganizationUnit_PermissionInheritanceType {\n  /** A role held at this unit also applies to its descendant units. */\n  INHERIT_DOWN = 'inherit_down',\n  /** A role held at this unit applies to this unit only; the node is isolated for permission purposes. */\n  NO_INHERITANCE = 'no_inheritance',\n}\n\n\n/**\n * A node of an organization's tree.\n *\n * **Business key — `code` is unique among siblings.** Declared here rather than only in the\n * application guard because the guard is a read-then-write: two concurrent CREATEs of the same code\n * under the same parent can each find nothing and each succeed. The compound index closes that\n * window at the database.\n *\n * BOTH adapters enforce it. This said the index was a \"MongoDB-only guarantee today\" because the SQL\n * planner only records uniqueness as intent — true of the PLANNER, and stale about the system:\n * enforcement is migration-owned and the migrations exist, so a PostgreSQL-backed application really\n * does carry\n * `create unique index … (\"organizationId\", \"parentUnitId\", \"code\") nulls not distinct where \"code\"\n * is not null` (read from `wonder-crm`'s initial schema, 2026-09-20). Corrected rather than deleted\n * because the reasoning is what a reader needs: the plan is INTENT, the migration is ENFORCEMENT, and\n * a resource change is not finished until every PostgreSQL-backed surface has one\n * (`.claude/rules/engine-resource-changes-owe-migrations.md`).\n *\n * The application guard in the unit custom implementation is KEPT anyway — not as a cross-adapter\n * backstop now, but because it raises the same\n * {@link ErrorCustomMessageReference.ORGANIZATION_UNIT_CODE_EXISTS} the index maps to, so a client\n * sees one code for one condition whichever layer catches it first.\n */\nexport const OrganizationUnitSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n  /**\n   * The parent node of this unit; absent on a root that hangs directly under the organization.\n   *\n   * `.excludeFromUpdate()` (plan decision D-B2): re-parenting is owned exclusively by the MOVE\n   * operation. A reparent has a subtree-wide side effect — every descendant's materialized\n   * {@link OrganizationUnitSchema.shape.path} has to be rewritten — and it must be refused when the\n   * destination sits inside the moved node's own subtree. Generic UPDATE performs neither, so\n   * allowing it here would silently produce a tree whose paths describe a shape that no longer\n   * exists, or a detached cycle. One operation, one authority.\n   */\n  parentUnitId: z.string().optional().isDBIndexed().isForeignKey().excludeFromUpdate(),\n  status: z.enum(OrganizationUnitStatus).default(OrganizationUnitStatus.ACTIVE).isDBIndexed().isSummaryField(),\n  inheritanceType: z.enum(OrganizationUnit_PermissionInheritanceType).default(OrganizationUnit_PermissionInheritanceType.INHERIT_DOWN).isDBIndexed(),\n  \n  path: z.string().isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  \n  // Unit Identity\n  name: z.string().min(1).max(100).isDBIndexed().isSummaryField(),\n  /**\n   * Short human-assigned handle for the unit, unique among its siblings — see the\n   * {@link OrganizationUnitSchema} business key below for the exact scope and why it is optional.\n   */\n  code: z.string().min(1).max(20).optional(),\n  type: z.enum(OrganizationUnitType).optional().isDBIndexed().isSummaryField(),\n\n  /**\n   * Which external system ASSERTS this unit — present only on a unit a directory created.\n   *\n   * Set to {@link ExternalIdentitySource.SCIM} by `POST /scim/v2/Groups` and by nothing else. It is the\n   * ownership marker the SCIM Groups path keys on, and it has two jobs:\n   *\n   * 1. **`/Groups` reads and mutates ONLY units carrying it.** A hand-made unit answers 404 there.\n   *    Entra locates a group by `displayName` before creating it, so exposing every unit would let a\n   *    directory adopt a hand-authored \"Sales\" unit by name and start rewriting its membership —\n   *    name-matching into an authorization axis, which `scim-organization-unit-mapping.shared.ts`\n   *    refuses for the department path for the same reason.\n   * 2. **The department path never removes an assignment on such a unit** — see\n   *    `resolveScimOrganizationUnitReconciliation`. Without that, every `/Users` push in an\n   *    organization using the department mapping would delete the memberships `/Groups` made, and a\n   *    directory that only sends membership DELTAS would never restore them.\n   *\n   * Why this is NOT derived from {@link OrganizationUnitSchema.shape.externalId}: Okta creates a group\n   * with `schemas`, `displayName` and `members` only, so a unit can be directory-owned and carry no\n   * `externalId` at all. Ownership and the directory's own identifier are two facts.\n   *\n   * `.excludeFromCreate()` / `.excludeFromUpdate()`: never client-settable. An organization admin who\n   * could set it would hand a unit's membership to the directory; one who could clear it would strand\n   * a group the directory still believes it manages.\n   *\n   * `.isSummaryField()`: the admin screen lists units through their SUMMARY projection, and this is\n   * the one fact that explains why a rename there does not stick (#1392) — so it travels with the\n   * row, like `status`, rather than only on the full read.\n   */\n  externalSource: z.enum(ExternalIdentitySource).optional().isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate(),\n  /**\n   * The DIRECTORY's own identifier for the group this unit represents (SCIM `externalId`).\n   *\n   * Client-owned by the protocol: the provisioning client issues it and the service provider stores\n   * it, while the SCIM resource `id` is this unit's `_id`. `UserIdentityLink.providerUserId` is the\n   * same idea one resource over.\n   *\n   * Unique PER ORGANIZATION and sparse — most units have no directory group. Planned as the composite\n   * `[organizationId, externalId]` on both adapters; on PostgreSQL the index is PARTIAL\n   * (`where \"externalId\" is not null`), and that predicate, not `nulls not distinct`, is what lets any\n   * number of group-less units coexist (measured on PostgreSQL 17.11, 2026-09-20).\n   *\n   * ⚠️ NEVER write an explicit `null` here. The MongoDB index is a partial filter on\n   * `{ externalId: { $exists: true } }`, and `$exists: true` matches a stored `null` — so the SECOND\n   * unit in an organization to be \"cleared\" with `null` collides, while PostgreSQL accepts it. An\n   * absent value must be an absent key. The SCIM Groups controller therefore never clears it.\n   *\n   * `.excludeFromCreate()` / `.excludeFromUpdate()` for the same reason as `externalSource`: only the\n   * directory, through the trusted SCIM door, states it.\n   */\n  externalId: z.string().min(1).max(255).optional().isUnique({ scope: 'organization', sparse: true }).excludeFromCreate().excludeFromUpdate(),\n\n  createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n}).businessKeySet(\n  ['organizationId', 'parentUnitId', 'code'],\n  {\n    // A row with no `code` has no key at all, so it must sit OUTSIDE the constraint: any number of\n    // code-less siblings under one parent is legitimate. `parentUnitId` is deliberately NOT listed\n    // — an absent parent means \"root\", which is a real position in the tree, so roots must still\n    // collide with each other. Listing it would exclude every root from the index and quietly lose\n    // uniqueness for exactly the nodes an org chart starts with.\n    skipRowsMissing: ['code'],\n    conflictMessageReference: ErrorCustomMessageReference.ORGANIZATION_UNIT_CODE_EXISTS,\n  },\n);\nexport type OrganizationUnit = z.infer<typeof OrganizationUnitSchema>;\n\n// RECURSIVE type - keep explicit interface\nexport interface OrganizationUnitTreeNode {\n  unit: OrganizationUnit;\n  children: OrganizationUnitTreeNode[];\n}\n\nexport const OrganizationUnitTreeNodeSchema: z.ZodType<OrganizationUnitTreeNode> = z.object({\n  unit: OrganizationUnitSchema,\n  children: z.array(z.lazy(() => OrganizationUnitTreeNodeSchema)).default([]),\n});\n\n"]}

package/dist/esm/organizations/organizations.shared.resources-config.schemas.d.ts

@@ -92,7 +92,7 @@ type OrganizationCoreOperations = CoreResourceOperation.READ | CoreResourceOpera
 export declare const organizationResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => import("..").ResourceConfiguration<typeof Organization_Lifecycle_Operations, OrganizationCoreOperations, z.ZodObject<{
     _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
     name: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
-    type: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    type: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>;
     slug: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>>;
     status: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodEnum<typeof OrganizationStatus>>>>>;
     platformAccessApprovalRequired: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
@@ -100,6 +100,8 @@ export declare const organizationResourceConfiguration_InitializationFactory: (r
     updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>>;
     deletionRequestedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodNullable<z.ZodDate>>>>>>;
     ownerFloorSerializationToken: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>>>>;
+    serviceProviderRelationshipSerializationToken: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>>>>;
+    autonomousAgentBindingSerializationToken: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>>>>;
     purgeScheduledAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodNullable<z.ZodDate>>>>>>;
 }, z.core.$strip>>;
 export {};

package/dist/esm/organizations/organizations.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organizations.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organizations.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAoD,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAW/H;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,oBAAY,iCAAiC;IAC3C,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,6BAA6B,+BAA+B;IAC5D;;;;;;;OAOG;IACH,gBAAgB,qBAAqB;IACrC;;;;;;OAMG;IACH,OAAO,YAAY;CACpB;AAQD,KAAK,0BAA0B,GAC3B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAKjC,eAAO,MAAM,uDAAuD,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;kBAqwBpH,CAAC"}
+{"version":3,"file":"organizations.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/organizations/organizations.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAoD,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAW/H;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,oBAAY,iCAAiC;IAC3C,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,6BAA6B,+BAA+B;IAC5D;;;;;;;OAOG;IACH,gBAAgB,qBAAqB;IACrC;;;;;;OAMG;IACH,OAAO,YAAY;CACpB;AAQD,KAAK,0BAA0B,GAC3B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAKjC,eAAO,MAAM,uDAAuD,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;kBAywBpH,CAAC"}

package/dist/esm/organizations/organizations.shared.resources-config.schemas.js

@@ -302,7 +302,8 @@ export const organizationResourceConfiguration_InitializationFactory = (resource
                     roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN], // Same scope-root contract as LIST above
                     riskLevel: ResourceOperationRiskLevel.LOW,
                     isSearchable: true,
-                    searchableFields: ['name', 'slug', 'email'],
+                    // An organization has no `email` (#1952): the name failed every PostgreSQL search on a missing column.
+                    searchableFields: ['name', 'slug'],
                     searchableOptions: { caseSensitive: false, fullMatchOnly: false },
                     filterFields: ORGANIZATION_ADMIN_FILTER_FIELDS,
                     sortFields: ORGANIZATION_ADMIN_SORT_FIELDS,
@@ -463,7 +464,7 @@ export const organizationResourceConfiguration_InitializationFactory = (resource
                     // nothing, so admitting the crossing costs no reversibility.
                     admitsCrossTenantPlatformAdministration: true,
                     requestDto: z.object({
-                        reason: z.string().max(500).optional()
+                        reason: z.string().max(500).optional().describe('Why this is being done. Recorded on the audit trail, not on the organization.')
                     }),
                     // Conditional availability by org status. ACTIVATE re-enables a halted
                     // or inactive organization, so it is available only from SUSPENDED or
@@ -506,8 +507,8 @@ export const organizationResourceConfiguration_InitializationFactory = (resource
                     riskLevel: ResourceOperationRiskLevel.CRITICAL,
                     resourceOperationLike: CoreResourceOperation.UPDATE,
                     requestDto: z.object({
-                        suspensionReason: z.string().min(1).max(500),
-                        notifyMembers: z.boolean().default(true)
+                        suspensionReason: z.string().min(1).max(500).describe('Why the organization is suspended. Recorded on the audit trail, not on the organization.'),
+                        notifyMembers: z.boolean().default(true).describe('Whether the organization\'s members are told of the suspension. Omitted means they are.')
                     }),
                     // Conditional availability by org status. SUSPEND halts an operational
                     // organization, so it is available only from ACTIVE or TRIAL — never
@@ -598,7 +599,8 @@ export const organizationResourceConfiguration_InitializationFactory = (resource
                     riskLevel: ResourceOperationRiskLevel.CRITICAL,
                     resourceOperationLike: CoreResourceOperation.UPDATE,
                     requestDto: z.object({
-                        reason: z.string().max(500).optional()
+                        reason: z.string().max(500).optional().describe('Why this is being done. Recorded on the audit trail, not on the organization.')
+                            .describe('Why the organization is being scheduled for deletion. Recorded with the audit event for the deletion request.')
                     }),
                     requiresStepUpAuthentication: true,
                     // Available only from a state the tenant can still be marked FROM. Never from DELETED
@@ -646,7 +648,8 @@ export const organizationResourceConfiguration_InitializationFactory = (resource
                     riskLevel: ResourceOperationRiskLevel.HIGH,
                     resourceOperationLike: CoreResourceOperation.UPDATE,
                     requestDto: z.object({
-                        reason: z.string().max(500).optional()
+                        reason: z.string().max(500).optional().describe('Why this is being done. Recorded on the audit trail, not on the organization.')
+                            .describe('Why the organization is being scheduled for deletion. Recorded with the audit event for the deletion request.')
                     }),
                     // The flag is per-VARIANT — nothing is inherited from the variant above. Marking someone
                     // else's tenant for destruction is not a lesser act than marking your own.
@@ -732,7 +735,7 @@ export const organizationResourceConfiguration_InitializationFactory = (resource
                     admitsCrossTenantPlatformAdministration: true,
                     resourceOperationLike: CoreResourceOperation.UPDATE,
                     requestDto: z.object({
-                        reason: z.string().max(500).optional()
+                        reason: z.string().max(500).optional().describe('Why this is being done. Recorded on the audit trail, not on the organization.')
                     }),
                     // Only a MARKED tenant can be restored. From any live state this is a no-op, and from
                     // the terminal CANCELLED it is not a deletion being undone.
@@ -808,7 +811,8 @@ export const organizationResourceConfiguration_InitializationFactory = (resource
                     riskLevel: ResourceOperationRiskLevel.CRITICAL,
                     resourceOperationLike: CoreResourceOperation.UPDATE,
                     requestDto: z.object({
-                        justification: z.string().min(1).max(1000),
+                        justification: z.string().min(1).max(1000)
+                            .describe('Why this organization becomes the one that operates the application. Required, because the promotion cannot be undone; it is recorded on the audit event beside the organization type it replaced.'),
                     }),
                     // Irreversible and it re-points everything the application owns as an operator. A hijacked
                     // session must not reach it on the strength of a login that happened at some earlier point.