@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

package/dist/esm/core/resources/useHostlessResourceNavigation.js.map

@@ -1 +1 @@
-{"version":3,"file":"useHostlessResourceNavigation.js","sourceRoot":"","sources":["../../../../../src/core/resources/useHostlessResourceNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,mDAAmD,EAAE,MAAM,0CAA0C,CAAC;AAE/G,OAAO,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAC;AAmCtG,MAAM,UAAU,6BAA6B;IAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,EAAE,kBAAkB,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAEzD,MAAM,sBAAsB,GAAG,WAAW,CAAC,CAAC,MAA4C,EAAW,EAAE;QACnG,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,0BAA0B,GAAG,EAAE,EAAE,UAAU,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC;QACtH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,gCAAgC,GAAG;YACvC,GAAG,0BAA0B;YAC7B,CAAC,YAAY,CAAC,EAAE,UAAU;SAC3B,CAAC;QAEF;;;;;;WAMG;QACH,MAAM,aAAa,GAAG,mDAAmD,CAAC;YACxE,cAAc;YACd,UAAU,EAAE,cAAc,CAAC,UAAU,IAAI,EAAE;YAC3C,aAAa,EAAE,qBAAqB,CAAC,IAAI;YACzC,QAAQ;YACR,aAAa,EAAE,IAAI;YACnB,0BAA0B,EAAE,IAAI;YAChC,0BAA0B,EAAE,gCAAgC;YAC5D,oBAAoB,EAAE,qBAAqB,CAAC,yBAAyB,CACnE,gCAAgC,EAChC,QAAQ,CACT;SACF,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,kBAAkB,CAChB,qBAAqB,CAAC,mDAAmD,CAAC;YACxE,YAAY;YACZ,SAAS,EAAE,aAAa;YACxB,0BAA0B,EAAE,gCAAgC;SAC7D,CAAC,EACF,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,CAAC,IAAI,EAAE,CAC5D,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,sBAAsB,EAAE,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAC/E,CAAC","sourcesContent":["/**\n * Navigate to a resource operation from a host that is NOT a resource surface.\n *\n * ## Why this exists\n *\n * Every existing path into a resource READ starts from a resource: `useResourceOperationSurface`\n * takes a `resourceContext`, and a list row already has one to derive the target from. A COMPOSITE\n * VIEW has none — it is `APPLICATION`-scoped by definition — so a canvas, board or dashboard that\n * wants a click to open a record had no framework path at all.\n *\n * The consequence was not that such views did without. It was that they re-implemented the detail\n * pane locally: the application-creation workbench's domain-model graph held its selection in React\n * state and rendered an inline `<aside>`, which meant no URL, no back navigation, no zone semantics\n * and no responsive collapse — a hand-rolled copy of `split` + `SECONDARY` + `onEmpty` at one call\n * site, with none of their behavior (issue #174).\n *\n * So this is deliberately a NAMED SEAM rather than a widening of the barrel. The alternative was to\n * export `frontend-resource.utils` publicly, which would expose a large internal module as API to\n * solve one caller's problem — repository organization as contract, which\n * `package-public-entrypoints.md` forbids.\n *\n * ## What it does NOT do\n *\n * It does not decide WHERE the record opens. That is the navigation layout's job: the transition\n * declared for `READ` in the source zone resolves to push, split or overlay, and a composite view\n * gets the same answer a list would from the same zone. A caller wanting a detail pane declares\n * `READ → SPLIT` in its layout; a caller wanting a full page declares `PUSH`. Nothing here overrides\n * that, which is the entire point — the previous hand-rolled pane WAS the override.\n */\n\nimport { useCallback, useMemo } from 'react';\nimport { CoreResourceOperation, NavigationZoneName } from '@wildo-ai/saas-models';\n\nimport { useResourceRegistry } from './useResourceRegistry';\nimport { frontendResourceUtils, FrontendResourceUtils } from './frontend-resource.utils';\nimport { pickPreferredOperationForCoreSemanticAddressability } from './resource-addressability.frontend.utils';\nimport type { FrontendResourceOperationContext } from './resources.frontend.schemas';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport type { NavigationInitiatorContext } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\n\nexport interface HostlessResourceReadNavigationParams {\n  /** The resource whose record should open. */\n  resourceType: string;\n  /** The record's id, as the resource's own identifier field carries it. */\n  resourceId: string;\n  /**\n   * Additional context identifiers to carry (parent scope, filters). Defaults to none — an\n   * `APPLICATION`-scoped host has no ambient resource context to inherit, which is exactly what makes\n   * it hostless.\n   */\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  /**\n   * Which zone the click came from. Defaults to PRIMARY, because a composite view is primary-zone\n   * content — and it is the SOURCE zone that decides the transition, so getting this wrong sends the\n   * record somewhere the layout did not intend.\n   */\n  sourceZone?: NavigationInitiatorContext['sourceZone'];\n}\n\nexport interface HostlessResourceNavigation {\n  /**\n   * Open a resource's preferred ADDRESSABLE read.\n   *\n   * Returns `false` — without navigating — when the resource is not registered, declares no\n   * addressable READ, or the id is empty. Fails closed on purpose: navigating to\n   * `/<resource>/undefined` produces an unrenderable detail surface that re-renders in a\n   * CPU-pegging loop, which is the failure the equivalent guard in `ResourceLayout_List` exists to\n   * prevent. A no-op click is recoverable; that is not.\n   */\n  navigateToResourceRead: (params: HostlessResourceReadNavigationParams) => boolean;\n}\n\nexport function useHostlessResourceNavigation(): HostlessResourceNavigation {\n  const { registry } = useResourceRegistry();\n  const { navigateToResource } = useNavigationController();\n\n  const navigateToResourceRead = useCallback((params: HostlessResourceReadNavigationParams): boolean => {\n    const { resourceType, resourceId, contextResourceIdentifiers = {}, sourceZone = NavigationZoneName.PRIMARY } = params;\n    if (!resourceId) {\n      return false;\n    }\n\n    const resourceConfig = registry.resourceConfigurations[resourceType];\n    if (!resourceConfig) {\n      return false;\n    }\n\n    const targetContextResourceIdentifiers = {\n      ...contextResourceIdentifiers,\n      [resourceType]: resourceId,\n    };\n\n    /*\n     * `requireFrontendAddressable: true` with no EMBEDDED fallback, unlike `ResourceLayout_List`.\n     * That list can fall back because it HAS a host to render an embedded read inside; a composite\n     * view does not, so an EMBEDDED read reached from here would have nowhere to go — and answering\n     * `false` is a visible no-op the author can debug, where navigating to a surface that cannot\n     * render is not.\n     */\n    const readOperation = pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations: resourceConfig.operations ?? [],\n      coreOperation: CoreResourceOperation.READ,\n      registry,\n      hasResourceId: true,\n      requireFrontendAddressable: true,\n      contextResourceIdentifiers: targetContextResourceIdentifiers,\n      contextualParameters: FrontendResourceUtils.buildContextualParameters(\n        targetContextResourceIdentifiers,\n        registry,\n      ),\n    });\n    if (!readOperation) {\n      return false;\n    }\n\n    navigateToResource(\n      frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n        resourceType,\n        operation: readOperation,\n        contextResourceIdentifiers: targetContextResourceIdentifiers,\n      }),\n      { sourceZone, sourceOperation: CoreResourceOperation.READ },\n    );\n    return true;\n  }, [registry, navigateToResource]);\n\n  return useMemo(() => ({ navigateToResourceRead }), [navigateToResourceRead]);\n}\n"]}
+{"version":3,"file":"useHostlessResourceNavigation.js","sourceRoot":"","sources":["../../../../../src/core/resources/useHostlessResourceNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AAEpH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EACL,mDAAmD,GAEpD,MAAM,0CAA0C,CAAC;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAC;AAoCtG,MAAM,UAAU,6BAA6B;IAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,EAAE,kBAAkB,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAEzD,MAAM,sBAAsB,GAAG,WAAW,CAAC,CAAC,MAA4C,EAAW,EAAE;QACnG,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,0BAA0B,GAAG,EAAE,EAAE,UAAU,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC;QACtH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,gCAAgC,GAAG,qBAAqB,CAAC,oCAAoC,CACjG,0BAA0B,EAC1B,YAAY,EACZ,UAAU,CACX,CAAC;QAEF;;;;;;;;;;;WAWG;QACH,MAAM,aAAa,GAAG,yBAAyB,CAAC,cAAc,EAAE,QAAQ,EAAE,gCAAgC,CAAC,CAAC;QAC5G,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,kBAAkB,CAChB,qBAAqB,CAAC,mDAAmD,CAAC;YACxE,YAAY;YACZ,SAAS,EAAE,aAAa;YACxB,0BAA0B,EAAE,gCAAgC;SAC7D,CAAC,EACF,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,CAAC,IAAI,EAAE,CAC5D,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,sBAAsB,EAAE,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,SAAS,yBAAyB,CAChC,cAA+E,EAC/E,QAAmE,EACnE,0BAA0F;IAE1F,MAAM,IAAI,GAAG,CAAC,0BAAmC,EAAE,EAAE,CAAC,mDAAmD,CAAC;QACxG,cAAc;QACd,UAAU,EAAE,cAAc,EAAE,UAAU,IAAI,EAAE;QAC5C,aAAa,EAAE,qBAAqB,CAAC,IAAI;QACzC,QAAQ;QACR,aAAa,EAAE,IAAI;QACnB,0BAA0B;QAC1B,0BAA0B;QAC1B,oBAAoB,EAAE,qBAAqB,CAAC,yBAAyB,CAAC,0BAA0B,EAAE,QAAQ,CAAC;KAC5G,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,OAAO,EAAE,uBAAuB,EAAE,OAAO,KAAK,gCAAgC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACvH,CAAC","sourcesContent":["/**\n * Navigate to a resource operation from a host that is NOT a resource surface.\n *\n * ## Why this exists\n *\n * Every existing path into a resource READ starts from a resource: `useResourceOperationSurface`\n * takes a `resourceContext`, and a list row already has one to derive the target from. A COMPOSITE\n * VIEW has none — it is `APPLICATION`-scoped by definition — so a canvas, board or dashboard that\n * wants a click to open a record had no framework path at all.\n *\n * The consequence was not that such views did without. It was that they re-implemented the detail\n * pane locally: the application-creation workbench's domain-model graph held its selection in React\n * state and rendered an inline `<aside>`, which meant no URL, no back navigation, no zone semantics\n * and no responsive collapse — a hand-rolled copy of `split` + `SECONDARY` + `onEmpty` at one call\n * site, with none of their behavior (issue #174).\n *\n * So this is deliberately a NAMED SEAM rather than a widening of the barrel. The alternative was to\n * export `frontend-resource.utils` publicly, which would expose a large internal module as API to\n * solve one caller's problem — repository organization as contract, which\n * `package-public-entrypoints.md` forbids.\n *\n * ## What it does NOT do\n *\n * It does not decide WHERE the record opens. That is the navigation layout's job: the transition\n * declared for `READ` in the source zone resolves to push, split or overlay, and a composite view\n * gets the same answer a list would from the same zone. A caller wanting a detail pane declares\n * `READ → SPLIT` in its layout; a caller wanting a full page declares `PUSH`. Nothing here overrides\n * that, which is the entire point — the previous hand-rolled pane WAS the override.\n */\n\nimport { useCallback, useMemo } from 'react';\nimport { CoreResourceOperation, NavigationZoneName, ResourceOperationFrontendSurface } from '@wildo-ai/saas-models';\n\nimport { useResourceRegistry } from './useResourceRegistry';\nimport { frontendResourceUtils, FrontendResourceUtils } from './frontend-resource.utils';\nimport {\n  pickPreferredOperationForCoreSemanticAddressability,\n  type PickPreferredOperationForAddressabilityParams,\n} from './resource-addressability.frontend.utils';\nimport type { FrontendResourceOperationContext } from './resources.frontend.schemas';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport type { NavigationInitiatorContext } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\n\nexport interface HostlessResourceReadNavigationParams {\n  /** The resource whose record should open. */\n  resourceType: string;\n  /** The record's id, as the resource's own identifier field carries it. */\n  resourceId: string;\n  /**\n   * Additional context identifiers to carry (parent scope, filters). Defaults to none — an\n   * `APPLICATION`-scoped host has no ambient resource context to inherit, which is exactly what makes\n   * it hostless.\n   */\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  /**\n   * Which zone the click came from. Defaults to PRIMARY, because a composite view is primary-zone\n   * content — and it is the SOURCE zone that decides the transition, so getting this wrong sends the\n   * record somewhere the layout did not intend.\n   */\n  sourceZone?: NavigationInitiatorContext['sourceZone'];\n}\n\nexport interface HostlessResourceNavigation {\n  /**\n   * Open a resource's preferred ADDRESSABLE read — or, when it has none, its `EMBEDDED` read, which the\n   * navigation layer opens as an overlay (an EMBEDDED read never takes over a structural zone).\n   *\n   * Returns `false` — without navigating — when the resource is not registered, declares neither an\n   * addressable nor an EMBEDDED READ, or the id is empty. `API_ONLY` stays refused: headless means no\n   * interface. Fails closed on purpose: navigating to `/<resource>/undefined` produces an unrenderable\n   * detail surface that re-renders in a CPU-pegging loop, which is the failure the equivalent guard in\n   * `ResourceLayout_List` exists to prevent. A no-op click is recoverable; that is not.\n   */\n  navigateToResourceRead: (params: HostlessResourceReadNavigationParams) => boolean;\n}\n\nexport function useHostlessResourceNavigation(): HostlessResourceNavigation {\n  const { registry } = useResourceRegistry();\n  const { navigateToResource } = useNavigationController();\n\n  const navigateToResourceRead = useCallback((params: HostlessResourceReadNavigationParams): boolean => {\n    const { resourceType, resourceId, contextResourceIdentifiers = {}, sourceZone = NavigationZoneName.PRIMARY } = params;\n    if (!resourceId) {\n      return false;\n    }\n\n    const resourceConfig = registry.resourceConfigurations[resourceType];\n    if (!resourceConfig) {\n      return false;\n    }\n\n    const targetContextResourceIdentifiers = frontendResourceUtils.buildRecordIdentifiersFromCollection(\n      contextResourceIdentifiers,\n      resourceType,\n      resourceId,\n    );\n\n    /*\n     * An ADDRESSABLE read first; failing that, an EMBEDDED one (#2063).\n     *\n     * This used to stop at the addressable read, on the reasoning that a composite view has no host\n     * for an embedded read, so it \"would have nowhere to go\". The navigation layer answers that: an\n     * EMBEDDED read navigated into a structural zone is coerced to an OVERLAY\n     * (`NavigationPlacementAdjustment.EMBEDDED_COERCED_TO_OVERLAY`), which is exactly how a reference\n     * to an aspect row opens it (`resolveFkOverlayTarget` in the reference display emits the same\n     * navigation). Without the fallback every workbench aspect row — whose READ is EMBEDDED by design —\n     * was unopenable from Home, a card or a `?open=` deep link: the call answered `false`, the caller\n     * ignored it, and no request was ever sent.\n     */\n    const readOperation = pickHostlessReadOperation(resourceConfig, registry, targetContextResourceIdentifiers);\n    if (!readOperation) {\n      return false;\n    }\n\n    navigateToResource(\n      frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n        resourceType,\n        operation: readOperation,\n        contextResourceIdentifiers: targetContextResourceIdentifiers,\n      }),\n      { sourceZone, sourceOperation: CoreResourceOperation.READ },\n    );\n    return true;\n  }, [registry, navigateToResource]);\n\n  return useMemo(() => ({ navigateToResourceRead }), [navigateToResourceRead]);\n}\n\n/**\n * The READ a hostless navigation opens: the preferred addressable one, else an `EMBEDDED` one (opened as\n * an overlay by the navigation layer). `API_ONLY` and every other surface yield `undefined`.\n */\nfunction pickHostlessReadOperation(\n  resourceConfig: PickPreferredOperationForAddressabilityParams['resourceConfig'],\n  registry: PickPreferredOperationForAddressabilityParams['registry'],\n  contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'],\n) {\n  const pick = (requireFrontendAddressable: boolean) => pickPreferredOperationForCoreSemanticAddressability({\n    resourceConfig,\n    operations: resourceConfig?.operations ?? [],\n    coreOperation: CoreResourceOperation.READ,\n    registry,\n    hasResourceId: true,\n    requireFrontendAddressable,\n    contextResourceIdentifiers,\n    contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),\n  });\n  const addressable = pick(true);\n  if (addressable) return addressable;\n  const anyRead = pick(false);\n  return anyRead?.operationFrontendConfig?.surface === ResourceOperationFrontendSurface.EMBEDDED ? anyRead : undefined;\n}\n"]}

package/dist/esm/core/resources/useOperationDirectExecution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationDirectExecution.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useOperationDirectExecution.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,iCAAiC;IAChD,oHAAoH;IACpH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,gGAAgG;IAChG,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACvC;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,SAAS,EACT,YAAY,EACZ,cAAc,GACf,EAAE,iCAAiC,GAAG,wBAAwB,CA6Q9D"}
+{"version":3,"file":"useOperationDirectExecution.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useOperationDirectExecution.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,iCAAiC;IAChD,oHAAoH;IACpH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,gGAAgG;IAChG,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACvC;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,SAAS,EACT,YAAY,EACZ,cAAc,GACf,EAAE,iCAAiC,GAAG,wBAAwB,CA2R9D"}

package/dist/esm/core/resources/useOperationDirectExecution.js

@@ -1,12 +1,13 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { ResourcesConfig_OperationPathUtils } from '@wildo-ai/saas-models';
+import { useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';
+import { ResourcesConfig_OperationPathUtils, readOperationApprovalPending } from '@wildo-ai/saas-models';
+import { NotificationContext } from '../../core/events/NotificationContext.js';
 import { FrontendComponentType } from '@wildo-ai/presets-components-models';
 import { useI18n } from '../../core/i18n/useI18n.js';
 import { resolveComponentLabel } from '../../core/i18n/component-label-resolution.utils.js';
 import { useResourceOperationViewContext } from '../../core/resources/ResourceOperationViewContext.js';
 import { FrontendResourceUtils, frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
 import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
-import { allowsDirectOperationFallback, MissingRMMRuntimeError, resolveDeclaredUpdateLikeMutationFallbackMode, } from '../../core/resources/rmm/update-like-mutation-fallback.frontend.js';
+import { allowsDirectOperationFallback, MissingRMMRuntimeError, resolveUpdateLikeMutationFallbackMode, } from '../../core/resources/rmm/update-like-mutation-fallback.frontend.js';
 import { useResourceRMM } from '../../core/resources/rmm/useResourceRMM.js';
 import { mutationErrorForReport } from '../../core/resources/rmm/mutation-error-report.utils.js';
 import { ConflictStrategy, MutationPriority, MutationSourceType, MutationType } from '../../core/resources/rmm/types.js';
@@ -55,14 +56,14 @@ export function useOperationDirectExecution({ onSuccess, errorMessage, errorComp
      * is resolved (the canonical-READ bootstrap below) for both lanes, and the row's RMM is attached when
      * the row has one.
      *
-     * It runs through that RMM when there is one. Without one it runs directly only if the operation
-     * DECLARED the direct lane (`operationFrontendConfig.updateLikeMutationFallbackMode`), read through the
-     * same function the form host and `useResourceOperationSurface` read, so the two hosts pick the same lane;
-     * otherwise it fails closed.
+     * It runs through that RMM when there is one. Without one it runs directly only if the operation's lane
+     * is the direct one — declared by the operation, or derived because its resource has no field-write
+     * route (#1956) — read through the same function the form host and `useResourceOperationSurface` read, so
+     * the two hosts pick the same lane; otherwise it fails closed.
      */
     const isSingleRowUpdateLike = useMemo(() => isSingleResourceUpdateLikeOperation(operation), [operation]);
     const acceptsDirectLane = isSingleRowUpdateLike
-        && allowsDirectOperationFallback(resolveDeclaredUpdateLikeMutationFallbackMode(operation));
+        && allowsDirectOperationFallback(resolveUpdateLikeMutationFallbackMode(operation, registry.resourceConfigurations[resourceType]?.operations));
     const bootstrapContextKey = useMemo(() => JSON.stringify({
         contextResourceIdentifiers: FrontendResourceUtils.buildContextResourceIdentifiersKey(currentResourceContext.contextResourceIdentifiers ?? {}),
         parentResourcesRequirements: currentResourceContext.parentResourcesRequirements ?? [],
@@ -109,6 +110,7 @@ export function useOperationDirectExecution({ onSuccess, errorMessage, errorComp
         parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,
         contextResourceIdentifiers: contextResourceIdentifiersWithResourceId,
         resourceSchema: registry.resourceConfigurations[resourceType]?.mainSchema,
+        resourceInheritance: registry.resourceConfigurations[resourceType]?.inheritenceSchemaDefinition,
         enabled: isSingleRowUpdateLike && !!currentResourceId,
         conflictPolicy: { strategy: ConflictStrategy.ACCEPT_REMOTE },
         directFallbackAccepted: acceptsDirectLane,
@@ -130,14 +132,27 @@ export function useOperationDirectExecution({ onSuccess, errorMessage, errorComp
         ? currentResourceContext
         : { ...currentResourceContext, contextResourceIdentifiers: contextResourceIdentifiersWithResourceId }), [contextResourceIdentifiersWithResourceId, currentResourceContext]);
     const announceOutcome = useResourceOperationOutcomeEmitter(announcedContext, operation);
+    // Read directly, never through the throwing `useNotification()`: this hook must not require a provider.
+    const notification = useContext(NotificationContext);
+    const notificationRef = useRef(notification);
+    notificationRef.current = notification;
     const handleSuccess = useCallback((result) => {
+        // #2288: an operation held for another person's approval changed nothing. Said as waiting, and announced as nothing
+        // (the emitter refuses a held answer); the host still moves on, since the request was made.
+        if (readOperationApprovalPending(result)) {
+            notificationRef.current?.notifyInfo(resolveComponentLabel({
+                tComponent,
+                componentType: FrontendComponentType.RESOURCES_LAYOUTS_ACTION,
+                key: 'operationSentForApproval',
+            }));
+        }
         announceOutcome(result);
         if (onSuccess) {
             onSuccess(result);
             return;
         }
         goBackWithinZone();
-    }, [announceOutcome, goBackWithinZone, onSuccess]);
+    }, [announceOutcome, goBackWithinZone, onSuccess, tComponent]);
     const handleError = useCallback((error) => {
         reportError(error, errorMessage, errorComponent);
     }, [errorComponent, errorMessage, reportError]);
@@ -224,7 +239,7 @@ export function useOperationDirectExecution({ onSuccess, errorMessage, errorComp
                 if (!mutationResult.success) {
                     throw mutationErrorForReport(mutationResult.error, executionFailedLabel);
                 }
-                result = mutationResult.responseData;
+                result = mutationResult.heldForApproval ?? mutationResult.responseData;
             }
             else if (isSingleRowUpdateLike) {
                 /*

package/dist/esm/core/resources/useOperationDirectExecution.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationDirectExecution.js","sourceRoot":"","sources":["../../../../../src/core/resources/useOperationDirectExecution.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport type { FieldMetaEntry } from '@wildo-ai/saas-models';\nimport { ResourcesConfig_OperationPathUtils } from '@wildo-ai/saas-models';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { resolveComponentLabel } from '~wildo-frontend-lib/core/i18n/component-label-resolution.utils';\nimport { useResourceOperationViewContext } from '~wildo-frontend-lib/core/resources/ResourceOperationViewContext';\nimport { FrontendResourceUtils, frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport {\n  allowsDirectOperationFallback,\n  MissingRMMRuntimeError,\n  resolveDeclaredUpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport { useResourceRMM } from '~wildo-frontend-lib/core/resources/rmm/useResourceRMM';\nimport { mutationErrorForReport } from '~wildo-frontend-lib/core/resources/rmm/mutation-error-report.utils';\nimport { ConflictStrategy, MutationPriority, MutationSourceType, MutationType } from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n  performCanonicalRMMRead,\n  resolveCanonicalRMMReadOperationPathKey,\n} from '~wildo-frontend-lib/core/resources/rmm/canonical-read.frontend.utils';\nimport { isSingleResourceUpdateLikeOperation } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { useResourceOperationOutcomeEmitter } from '~wildo-frontend-lib/core/resources/useResourceOperationOutcomeEmitter';\n\nexport interface UseOperationDirectExecutionParams {\n  /** Replaces what happens AFTER a success. The outcome is announced either way. Omitted: go back within the zone. */\n  onSuccess?: (result: unknown) => void;\n  /** The message a failure is reported under. */\n  errorMessage: string;\n  /** The component a failure is attributed to in the report. */\n  errorComponent: string;\n}\n\nexport interface OperationDirectExecution {\n  /**\n   * Execute the hosted operation with this exact request body — no form, no validation pass beyond\n   * the server's. Resolves once the outcome has been announced (success) or reported (failure).\n   * Omitted means \"no body at all\", which is what a zero-input action sends — not an empty object.\n   */\n  execute: (requestData?: Record<string, unknown>) => Promise<void>;\n  /** True while a request is in flight. */\n  isExecuting: boolean;\n  /**\n   * True while an update-like operation with no target id in its context is resolving that id from\n   * the canonical READ. Execution must wait for it: the RMM that carries the mutation is keyed on it.\n   */\n  isBootstrapping: boolean;\n  /**\n   * The success path itself — announce the outcome, then `onSuccess` or go back. Exposed so a host\n   * that ALSO renders a form hands the form this very function, and \"what success means\" has one\n   * definition across the form and the form-less paths.\n   */\n  completeWithSuccess: (result: unknown) => void;\n  /** The failure path — reports under `errorMessage` / `errorComponent`. Same reason as above. */\n  reportFailure: (error: Error) => void;\n}\n\ntype BootstrappedTargetRow = {\n  contextKey: string;\n  row: Record<string, unknown>;\n};\n\n/**\n * Execute the NEAREST operation view's operation with a body the caller already has — the form-less\n * half of every operation host.\n *\n * ## Why this is its own hook\n *\n * It began as the zero-input branch of `ResourceLayout_SemanticOperationFallback` (\"Run\" with an\n * empty body), and a DROPDOWN action needs exactly the same thing with a one-field body: the pick is\n * the submission. The alternative — a second copy of the RMM-or-direct decision, the canonical-READ\n * bootstrap and the outcome announcement inside the dropdown — is the shape this package has already\n * paid for once (the bulk selector, spelled two ways). One hook, so a host that executes without a\n * form inherits the whole contract by using it:\n *\n * - **update-like single-resource operations run through the RMM**, never the plain `doOperation`\n *   lane, and fail closed with `MissingRMMRuntimeError` rather than writing without it;\n * - **a missing target id is resolved first** from the canonical READ, so a detail-less context (a\n *   bulk bar, a singleton) still mutates the right row;\n * - **everything else runs `executeCurrentOperation`**, which merges a bulk selection into the body;\n * - **the outcome is ALWAYS announced**, and `onSuccess` replaces only what happens next.\n *\n * Confirmation is NOT decided here. Each host owns the dialog it shows, because only the host knows\n * whether a person has already acted deliberately (typed a phrase, pressed Submit) or merely picked.\n *\n * Must be called under a `ResourceOperationViewProvider` for the operation being executed — a\n * detached host establishes one (`ResourceOperationDetachedHost`, `ResourceOperationActionDropdown`).\n */\nexport function useOperationDirectExecution({\n  onSuccess,\n  errorMessage,\n  errorComponent,\n}: UseOperationDirectExecutionParams): OperationDirectExecution {\n  const {\n    resourceContext: currentResourceContext,\n    resourceType,\n    operation,\n    reportError,\n    goBackWithinZone,\n    executeCurrentOperation,\n  } = useResourceOperationViewContext();\n  const { doOperation, registry } = useResourceRegistry();\n  // `resource` as well as the component: a resource may override the component's words, and the\n  // fallback this was extracted from resolved them resource-scoped.\n  const { tComponent } = useI18n({ component: FrontendComponentType.RESOURCES_LAYOUTS_ACTION, resource: resourceType });\n  const doOperationRef = useRef(doOperation);\n  doOperationRef.current = doOperation;\n\n  const [isExecuting, setIsExecuting] = useState(false);\n  const [isBootstrapping, setIsBootstrapping] = useState(false);\n  const [bootstrappedRow, setBootstrappedRow] = useState<BootstrappedTargetRow | null>(null);\n  /*\n   * A single-row update-like operation addresses ONE row, whichever lane it runs on, so its target id\n   * is resolved (the canonical-READ bootstrap below) for both lanes, and the row's RMM is attached when\n   * the row has one.\n   *\n   * It runs through that RMM when there is one. Without one it runs directly only if the operation\n   * DECLARED the direct lane (`operationFrontendConfig.updateLikeMutationFallbackMode`), read through the\n   * same function the form host and `useResourceOperationSurface` read, so the two hosts pick the same lane;\n   * otherwise it fails closed.\n   */\n  const isSingleRowUpdateLike = useMemo(() => isSingleResourceUpdateLikeOperation(operation), [operation]);\n  const acceptsDirectLane = isSingleRowUpdateLike\n    && allowsDirectOperationFallback(resolveDeclaredUpdateLikeMutationFallbackMode(operation));\n\n  const bootstrapContextKey = useMemo(() => JSON.stringify({\n    contextResourceIdentifiers: FrontendResourceUtils.buildContextResourceIdentifiersKey(\n      currentResourceContext.contextResourceIdentifiers ?? {},\n    ),\n    parentResourcesRequirements: currentResourceContext.parentResourcesRequirements ?? [],\n  }), [\n    currentResourceContext.contextResourceIdentifiers,\n    currentResourceContext.parentResourcesRequirements,\n  ]);\n  const routeResourceId = useMemo(() => {\n    const identifier = currentResourceContext.contextResourceIdentifiers?.[resourceType];\n    if (!identifier) {\n      return null;\n    }\n    return frontendResourceUtils.getResourceId(identifier) ?? null;\n  }, [currentResourceContext.contextResourceIdentifiers, resourceType]);\n  const currentResourceId = routeResourceId ?? (\n    bootstrappedRow?.contextKey === bootstrapContextKey\n    && typeof bootstrappedRow.row._id === 'string'\n    && bootstrappedRow.row._id.length > 0\n      ? bootstrappedRow.row._id\n      : null\n  );\n  const contextResourceIdentifiersWithResourceId = useMemo(() => {\n    if (!currentResourceId || currentResourceContext.contextResourceIdentifiers?.[resourceType]) {\n      return currentResourceContext.contextResourceIdentifiers;\n    }\n\n    return {\n      ...currentResourceContext.contextResourceIdentifiers,\n      [resourceType]: currentResourceId,\n    };\n  }, [currentResourceContext.contextResourceIdentifiers, currentResourceId, resourceType]);\n  const contextualParameters = useMemo(() => {\n    return FrontendResourceUtils.buildContextualParameters(\n      contextResourceIdentifiersWithResourceId,\n      registry,\n    );\n  }, [contextResourceIdentifiersWithResourceId, registry]);\n  const canonicalReadOperationPathKey = useMemo(() => {\n    return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {\n      hasResourceId: Boolean(currentResourceId),\n      contextResourceIdentifiers: contextResourceIdentifiersWithResourceId,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersWithResourceId, contextualParameters, currentResourceId, registry, resourceType]);\n  const { rmm } = useResourceRMM({\n    resourceType,\n    resourceId: currentResourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n    contextResourceIdentifiers: contextResourceIdentifiersWithResourceId,\n    resourceSchema: registry.resourceConfigurations[resourceType]?.mainSchema,\n    enabled: isSingleRowUpdateLike && !!currentResourceId,\n    conflictPolicy: { strategy: ConflictStrategy.ACCEPT_REMOTE },\n    directFallbackAccepted: acceptsDirectLane,\n  });\n\n  const executionFailedLabel = useMemo(() => {\n    return resolveComponentLabel({\n      tComponent,\n      componentType: FrontendComponentType.RESOURCES_LAYOUTS_ACTION,\n      key: 'executionFailed',\n    });\n  }, [tComponent]);\n\n  /*\n   * Announced with the context that carries the RESOLVED row id, not the route's. A context-addressed\n   * singleton has no id on its route; the id comes from the canonical READ, and a page showing that row\n   * re-reads only when the announcement names it (#1782). The route context named no row, so an action\n   * whose result carries no `_id` (a secret's change outcome) announced a change to nobody.\n   */\n  const announcedContext = useMemo(\n    () => (contextResourceIdentifiersWithResourceId === currentResourceContext.contextResourceIdentifiers\n      ? currentResourceContext\n      : { ...currentResourceContext, contextResourceIdentifiers: contextResourceIdentifiersWithResourceId }),\n    [contextResourceIdentifiersWithResourceId, currentResourceContext],\n  );\n  const announceOutcome = useResourceOperationOutcomeEmitter(announcedContext, operation);\n  const handleSuccess = useCallback((result: unknown) => {\n    announceOutcome(result);\n    if (onSuccess) {\n      onSuccess(result);\n      return;\n    }\n    goBackWithinZone();\n  }, [announceOutcome, goBackWithinZone, onSuccess]);\n\n  const handleError = useCallback((error: Error) => {\n    reportError(error, errorMessage, errorComponent);\n  }, [errorComponent, errorMessage, reportError]);\n\n  useEffect(() => {\n    if (!isSingleRowUpdateLike || currentResourceId || !canonicalReadOperationPathKey) {\n      return;\n    }\n\n    let cancelled = false;\n    setIsBootstrapping(true);\n    void performCanonicalRMMRead({\n      doOperation: doOperationRef.current,\n      readOperationPathKey: canonicalReadOperationPathKey,\n      contextualParameters,\n      parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n    }).then((row) => {\n      if (cancelled) return;\n      setBootstrappedRow({\n        contextKey: bootstrapContextKey,\n        row,\n      });\n    }).catch((error: unknown) => {\n      if (cancelled) return;\n      handleError(error instanceof Error ? error : new Error(String(error)));\n    }).finally(() => {\n      if (!cancelled) {\n        setIsBootstrapping(false);\n      }\n    });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [\n    bootstrapContextKey,\n    canonicalReadOperationPathKey,\n    contextualParameters,\n    currentResourceContext.parentResourcesRequirements,\n    currentResourceId,\n    handleError,\n    isSingleRowUpdateLike,\n  ]);\n\n  useEffect(() => {\n    if (!rmm || !bootstrappedRow || bootstrappedRow.contextKey !== bootstrapContextKey) {\n      return;\n    }\n\n    if (typeof rmm.getSnapshot === 'function' && rmm.getSnapshot().confirmedData !== null) {\n      return;\n    }\n\n    if (typeof rmm.setInitialState === 'function') {\n      const row = bootstrappedRow.row;\n      rmm.setInitialState(\n        row,\n        (row._version as number | undefined) ?? 0,\n        row._field_meta as Record<string, FieldMetaEntry> | undefined,\n      );\n    }\n  }, [bootstrapContextKey, bootstrappedRow, rmm]);\n\n  const execute = useCallback(async (requestData?: Record<string, unknown>) => {\n    setIsExecuting(true);\n    try {\n      let result: unknown;\n\n      if (isSingleRowUpdateLike && (rmm || !acceptsDirectLane)) {\n        if (!rmm) {\n          throw new MissingRMMRuntimeError({\n            surfaceName: 'useOperationDirectExecution',\n            resourceType,\n            operationIdentifier: String(operation.operationIdentifier),\n          });\n        }\n\n        // No optimistic patch: the body is the OPERATION's input, not a set of resource fields, and a\n        // custom operation's input names need not be the row's. The row is read back on success.\n        const mutationResult = await rmm.queueMutation({}, {\n          type: MutationType.CUSTOM,\n          priority: MutationPriority.HIGH,\n          source: {\n            type: MutationSourceType.CUSTOM,\n            subscriberId: `direct-execution:${String(operation.operationIdentifier)}`,\n          },\n          transportOverride: {\n            operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation),\n            contextualParameters,\n            parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n            requestData: requestData ?? {},\n            readBackOnSuccess: true,\n          },\n        });\n\n        if (!mutationResult.success) {\n          throw mutationErrorForReport(mutationResult.error, executionFailedLabel);\n        }\n\n        result = mutationResult.responseData;\n      } else if (isSingleRowUpdateLike) {\n        /*\n         * No RMM and the direct lane declared, still for ONE row: sent with the parameters this hook resolved, which carry the\n         * bootstrapped id when the route had none. `executeCurrentOperation` builds its parameters from the\n         * route alone, so from a detail-less context (a singleton, a bulk bar) it would address `{id}`\n         * unresolved. With no id at all the operation has no row to act on, and says so instead of sending.\n         */\n        if (!currentResourceId) {\n          throw new Error(`${String(operation.operationIdentifier)} on ${resourceType} has no row to act on: no id on the route and none from its canonical READ.`);\n        }\n        result = await doOperationRef.current(ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation), {\n          contextualParameters,\n          parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n          requestData: requestData ?? {},\n        });\n      } else {\n        result = await executeCurrentOperation(requestData);\n      }\n\n      handleSuccess(result);\n    } catch (error) {\n      handleError(error instanceof Error ? error : new Error(executionFailedLabel));\n    } finally {\n      setIsExecuting(false);\n    }\n  }, [\n    contextualParameters,\n    currentResourceContext.parentResourcesRequirements,\n    executeCurrentOperation,\n    handleError,\n    handleSuccess,\n    acceptsDirectLane,\n    isSingleRowUpdateLike,\n    currentResourceId,\n    operation,\n    resourceType,\n    rmm,\n    executionFailedLabel,\n  ]);\n\n  return {\n    execute,\n    isExecuting,\n    isBootstrapping,\n    completeWithSuccess: handleSuccess,\n    reportFailure: handleError,\n  };\n}\n"]}
+{"version":3,"file":"useOperationDirectExecution.js","sourceRoot":"","sources":["../../../../../src/core/resources/useOperationDirectExecution.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';\n\nimport type { FieldMetaEntry } from '@wildo-ai/saas-models';\nimport { ResourcesConfig_OperationPathUtils, readOperationApprovalPending } from '@wildo-ai/saas-models';\nimport { NotificationContext } from '~wildo-frontend-lib/core/events/NotificationContext';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { resolveComponentLabel } from '~wildo-frontend-lib/core/i18n/component-label-resolution.utils';\nimport { useResourceOperationViewContext } from '~wildo-frontend-lib/core/resources/ResourceOperationViewContext';\nimport { FrontendResourceUtils, frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport {\n  allowsDirectOperationFallback,\n  MissingRMMRuntimeError,\n  resolveUpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport { useResourceRMM } from '~wildo-frontend-lib/core/resources/rmm/useResourceRMM';\nimport { mutationErrorForReport } from '~wildo-frontend-lib/core/resources/rmm/mutation-error-report.utils';\nimport { ConflictStrategy, MutationPriority, MutationSourceType, MutationType } from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n  performCanonicalRMMRead,\n  resolveCanonicalRMMReadOperationPathKey,\n} from '~wildo-frontend-lib/core/resources/rmm/canonical-read.frontend.utils';\nimport { isSingleResourceUpdateLikeOperation } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { useResourceOperationOutcomeEmitter } from '~wildo-frontend-lib/core/resources/useResourceOperationOutcomeEmitter';\n\nexport interface UseOperationDirectExecutionParams {\n  /** Replaces what happens AFTER a success. The outcome is announced either way. Omitted: go back within the zone. */\n  onSuccess?: (result: unknown) => void;\n  /** The message a failure is reported under. */\n  errorMessage: string;\n  /** The component a failure is attributed to in the report. */\n  errorComponent: string;\n}\n\nexport interface OperationDirectExecution {\n  /**\n   * Execute the hosted operation with this exact request body — no form, no validation pass beyond\n   * the server's. Resolves once the outcome has been announced (success) or reported (failure).\n   * Omitted means \"no body at all\", which is what a zero-input action sends — not an empty object.\n   */\n  execute: (requestData?: Record<string, unknown>) => Promise<void>;\n  /** True while a request is in flight. */\n  isExecuting: boolean;\n  /**\n   * True while an update-like operation with no target id in its context is resolving that id from\n   * the canonical READ. Execution must wait for it: the RMM that carries the mutation is keyed on it.\n   */\n  isBootstrapping: boolean;\n  /**\n   * The success path itself — announce the outcome, then `onSuccess` or go back. Exposed so a host\n   * that ALSO renders a form hands the form this very function, and \"what success means\" has one\n   * definition across the form and the form-less paths.\n   */\n  completeWithSuccess: (result: unknown) => void;\n  /** The failure path — reports under `errorMessage` / `errorComponent`. Same reason as above. */\n  reportFailure: (error: Error) => void;\n}\n\ntype BootstrappedTargetRow = {\n  contextKey: string;\n  row: Record<string, unknown>;\n};\n\n/**\n * Execute the NEAREST operation view's operation with a body the caller already has — the form-less\n * half of every operation host.\n *\n * ## Why this is its own hook\n *\n * It began as the zero-input branch of `ResourceLayout_SemanticOperationFallback` (\"Run\" with an\n * empty body), and a DROPDOWN action needs exactly the same thing with a one-field body: the pick is\n * the submission. The alternative — a second copy of the RMM-or-direct decision, the canonical-READ\n * bootstrap and the outcome announcement inside the dropdown — is the shape this package has already\n * paid for once (the bulk selector, spelled two ways). One hook, so a host that executes without a\n * form inherits the whole contract by using it:\n *\n * - **update-like single-resource operations run through the RMM**, never the plain `doOperation`\n *   lane, and fail closed with `MissingRMMRuntimeError` rather than writing without it;\n * - **a missing target id is resolved first** from the canonical READ, so a detail-less context (a\n *   bulk bar, a singleton) still mutates the right row;\n * - **everything else runs `executeCurrentOperation`**, which merges a bulk selection into the body;\n * - **the outcome is ALWAYS announced**, and `onSuccess` replaces only what happens next.\n *\n * Confirmation is NOT decided here. Each host owns the dialog it shows, because only the host knows\n * whether a person has already acted deliberately (typed a phrase, pressed Submit) or merely picked.\n *\n * Must be called under a `ResourceOperationViewProvider` for the operation being executed — a\n * detached host establishes one (`ResourceOperationDetachedHost`, `ResourceOperationActionDropdown`).\n */\nexport function useOperationDirectExecution({\n  onSuccess,\n  errorMessage,\n  errorComponent,\n}: UseOperationDirectExecutionParams): OperationDirectExecution {\n  const {\n    resourceContext: currentResourceContext,\n    resourceType,\n    operation,\n    reportError,\n    goBackWithinZone,\n    executeCurrentOperation,\n  } = useResourceOperationViewContext();\n  const { doOperation, registry } = useResourceRegistry();\n  // `resource` as well as the component: a resource may override the component's words, and the\n  // fallback this was extracted from resolved them resource-scoped.\n  const { tComponent } = useI18n({ component: FrontendComponentType.RESOURCES_LAYOUTS_ACTION, resource: resourceType });\n  const doOperationRef = useRef(doOperation);\n  doOperationRef.current = doOperation;\n\n  const [isExecuting, setIsExecuting] = useState(false);\n  const [isBootstrapping, setIsBootstrapping] = useState(false);\n  const [bootstrappedRow, setBootstrappedRow] = useState<BootstrappedTargetRow | null>(null);\n  /*\n   * A single-row update-like operation addresses ONE row, whichever lane it runs on, so its target id\n   * is resolved (the canonical-READ bootstrap below) for both lanes, and the row's RMM is attached when\n   * the row has one.\n   *\n   * It runs through that RMM when there is one. Without one it runs directly only if the operation's lane\n   * is the direct one — declared by the operation, or derived because its resource has no field-write\n   * route (#1956) — read through the same function the form host and `useResourceOperationSurface` read, so\n   * the two hosts pick the same lane; otherwise it fails closed.\n   */\n  const isSingleRowUpdateLike = useMemo(() => isSingleResourceUpdateLikeOperation(operation), [operation]);\n  const acceptsDirectLane = isSingleRowUpdateLike\n    && allowsDirectOperationFallback(resolveUpdateLikeMutationFallbackMode(operation, registry.resourceConfigurations[resourceType]?.operations));\n\n  const bootstrapContextKey = useMemo(() => JSON.stringify({\n    contextResourceIdentifiers: FrontendResourceUtils.buildContextResourceIdentifiersKey(\n      currentResourceContext.contextResourceIdentifiers ?? {},\n    ),\n    parentResourcesRequirements: currentResourceContext.parentResourcesRequirements ?? [],\n  }), [\n    currentResourceContext.contextResourceIdentifiers,\n    currentResourceContext.parentResourcesRequirements,\n  ]);\n  const routeResourceId = useMemo(() => {\n    const identifier = currentResourceContext.contextResourceIdentifiers?.[resourceType];\n    if (!identifier) {\n      return null;\n    }\n    return frontendResourceUtils.getResourceId(identifier) ?? null;\n  }, [currentResourceContext.contextResourceIdentifiers, resourceType]);\n  const currentResourceId = routeResourceId ?? (\n    bootstrappedRow?.contextKey === bootstrapContextKey\n    && typeof bootstrappedRow.row._id === 'string'\n    && bootstrappedRow.row._id.length > 0\n      ? bootstrappedRow.row._id\n      : null\n  );\n  const contextResourceIdentifiersWithResourceId = useMemo(() => {\n    if (!currentResourceId || currentResourceContext.contextResourceIdentifiers?.[resourceType]) {\n      return currentResourceContext.contextResourceIdentifiers;\n    }\n\n    return {\n      ...currentResourceContext.contextResourceIdentifiers,\n      [resourceType]: currentResourceId,\n    };\n  }, [currentResourceContext.contextResourceIdentifiers, currentResourceId, resourceType]);\n  const contextualParameters = useMemo(() => {\n    return FrontendResourceUtils.buildContextualParameters(\n      contextResourceIdentifiersWithResourceId,\n      registry,\n    );\n  }, [contextResourceIdentifiersWithResourceId, registry]);\n  const canonicalReadOperationPathKey = useMemo(() => {\n    return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {\n      hasResourceId: Boolean(currentResourceId),\n      contextResourceIdentifiers: contextResourceIdentifiersWithResourceId,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersWithResourceId, contextualParameters, currentResourceId, registry, resourceType]);\n  const { rmm } = useResourceRMM({\n    resourceType,\n    resourceId: currentResourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n    contextResourceIdentifiers: contextResourceIdentifiersWithResourceId,\n    resourceSchema: registry.resourceConfigurations[resourceType]?.mainSchema,\n    resourceInheritance: registry.resourceConfigurations[resourceType]?.inheritenceSchemaDefinition,\n    enabled: isSingleRowUpdateLike && !!currentResourceId,\n    conflictPolicy: { strategy: ConflictStrategy.ACCEPT_REMOTE },\n    directFallbackAccepted: acceptsDirectLane,\n  });\n\n  const executionFailedLabel = useMemo(() => {\n    return resolveComponentLabel({\n      tComponent,\n      componentType: FrontendComponentType.RESOURCES_LAYOUTS_ACTION,\n      key: 'executionFailed',\n    });\n  }, [tComponent]);\n\n  /*\n   * Announced with the context that carries the RESOLVED row id, not the route's. A context-addressed\n   * singleton has no id on its route; the id comes from the canonical READ, and a page showing that row\n   * re-reads only when the announcement names it (#1782). The route context named no row, so an action\n   * whose result carries no `_id` (a secret's change outcome) announced a change to nobody.\n   */\n  const announcedContext = useMemo(\n    () => (contextResourceIdentifiersWithResourceId === currentResourceContext.contextResourceIdentifiers\n      ? currentResourceContext\n      : { ...currentResourceContext, contextResourceIdentifiers: contextResourceIdentifiersWithResourceId }),\n    [contextResourceIdentifiersWithResourceId, currentResourceContext],\n  );\n  const announceOutcome = useResourceOperationOutcomeEmitter(announcedContext, operation);\n  // Read directly, never through the throwing `useNotification()`: this hook must not require a provider.\n  const notification = useContext(NotificationContext);\n  const notificationRef = useRef(notification);\n  notificationRef.current = notification;\n  const handleSuccess = useCallback((result: unknown) => {\n    // #2288: an operation held for another person's approval changed nothing. Said as waiting, and announced as nothing\n    // (the emitter refuses a held answer); the host still moves on, since the request was made.\n    if (readOperationApprovalPending(result)) {\n      notificationRef.current?.notifyInfo(resolveComponentLabel({\n        tComponent,\n        componentType: FrontendComponentType.RESOURCES_LAYOUTS_ACTION,\n        key: 'operationSentForApproval',\n      }));\n    }\n    announceOutcome(result);\n    if (onSuccess) {\n      onSuccess(result);\n      return;\n    }\n    goBackWithinZone();\n  }, [announceOutcome, goBackWithinZone, onSuccess, tComponent]);\n\n  const handleError = useCallback((error: Error) => {\n    reportError(error, errorMessage, errorComponent);\n  }, [errorComponent, errorMessage, reportError]);\n\n  useEffect(() => {\n    if (!isSingleRowUpdateLike || currentResourceId || !canonicalReadOperationPathKey) {\n      return;\n    }\n\n    let cancelled = false;\n    setIsBootstrapping(true);\n    void performCanonicalRMMRead({\n      doOperation: doOperationRef.current,\n      readOperationPathKey: canonicalReadOperationPathKey,\n      contextualParameters,\n      parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n    }).then((row) => {\n      if (cancelled) return;\n      setBootstrappedRow({\n        contextKey: bootstrapContextKey,\n        row,\n      });\n    }).catch((error: unknown) => {\n      if (cancelled) return;\n      handleError(error instanceof Error ? error : new Error(String(error)));\n    }).finally(() => {\n      if (!cancelled) {\n        setIsBootstrapping(false);\n      }\n    });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [\n    bootstrapContextKey,\n    canonicalReadOperationPathKey,\n    contextualParameters,\n    currentResourceContext.parentResourcesRequirements,\n    currentResourceId,\n    handleError,\n    isSingleRowUpdateLike,\n  ]);\n\n  useEffect(() => {\n    if (!rmm || !bootstrappedRow || bootstrappedRow.contextKey !== bootstrapContextKey) {\n      return;\n    }\n\n    if (typeof rmm.getSnapshot === 'function' && rmm.getSnapshot().confirmedData !== null) {\n      return;\n    }\n\n    if (typeof rmm.setInitialState === 'function') {\n      const row = bootstrappedRow.row;\n      rmm.setInitialState(\n        row,\n        (row._version as number | undefined) ?? 0,\n        row._field_meta as Record<string, FieldMetaEntry> | undefined,\n      );\n    }\n  }, [bootstrapContextKey, bootstrappedRow, rmm]);\n\n  const execute = useCallback(async (requestData?: Record<string, unknown>) => {\n    setIsExecuting(true);\n    try {\n      let result: unknown;\n\n      if (isSingleRowUpdateLike && (rmm || !acceptsDirectLane)) {\n        if (!rmm) {\n          throw new MissingRMMRuntimeError({\n            surfaceName: 'useOperationDirectExecution',\n            resourceType,\n            operationIdentifier: String(operation.operationIdentifier),\n          });\n        }\n\n        // No optimistic patch: the body is the OPERATION's input, not a set of resource fields, and a\n        // custom operation's input names need not be the row's. The row is read back on success.\n        const mutationResult = await rmm.queueMutation({}, {\n          type: MutationType.CUSTOM,\n          priority: MutationPriority.HIGH,\n          source: {\n            type: MutationSourceType.CUSTOM,\n            subscriberId: `direct-execution:${String(operation.operationIdentifier)}`,\n          },\n          transportOverride: {\n            operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation),\n            contextualParameters,\n            parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n            requestData: requestData ?? {},\n            readBackOnSuccess: true,\n          },\n        });\n\n        if (!mutationResult.success) {\n          throw mutationErrorForReport(mutationResult.error, executionFailedLabel);\n        }\n\n        result = mutationResult.heldForApproval ?? mutationResult.responseData;\n      } else if (isSingleRowUpdateLike) {\n        /*\n         * No RMM and the direct lane declared, still for ONE row: sent with the parameters this hook resolved, which carry the\n         * bootstrapped id when the route had none. `executeCurrentOperation` builds its parameters from the\n         * route alone, so from a detail-less context (a singleton, a bulk bar) it would address `{id}`\n         * unresolved. With no id at all the operation has no row to act on, and says so instead of sending.\n         */\n        if (!currentResourceId) {\n          throw new Error(`${String(operation.operationIdentifier)} on ${resourceType} has no row to act on: no id on the route and none from its canonical READ.`);\n        }\n        result = await doOperationRef.current(ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation), {\n          contextualParameters,\n          parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n          requestData: requestData ?? {},\n        });\n      } else {\n        result = await executeCurrentOperation(requestData);\n      }\n\n      handleSuccess(result);\n    } catch (error) {\n      handleError(error instanceof Error ? error : new Error(executionFailedLabel));\n    } finally {\n      setIsExecuting(false);\n    }\n  }, [\n    contextualParameters,\n    currentResourceContext.parentResourcesRequirements,\n    executeCurrentOperation,\n    handleError,\n    handleSuccess,\n    acceptsDirectLane,\n    isSingleRowUpdateLike,\n    currentResourceId,\n    operation,\n    resourceType,\n    rmm,\n    executionFailedLabel,\n  ]);\n\n  return {\n    execute,\n    isExecuting,\n    isBootstrapping,\n    completeWithSuccess: handleSuccess,\n    reportFailure: handleError,\n  };\n}\n"]}

package/dist/esm/core/resources/useRecordSharing.d.ts

@@ -0,0 +1,58 @@
+import { type RelationshipRecordReach } from '@wildo-ai/saas-models';
+import type { FrontendResourceConfiguration_Operation, FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas';
+/** Where the screen's read stands. */
+export declare enum RecordSharingReadState {
+    /** Nothing is asked: the screen is not offered here. */
+    IDLE = "idle",
+    /** Asked; the answer has not arrived. The screen shows nothing yet, so nothing is offered first and withdrawn after. */
+    LOADING = "loading",
+    /** The read answered, for the record now on screen. */
+    READY = "ready",
+    /** The backend does not share records of this resource. The screen shows nothing. */
+    NOT_SHAREABLE = "not_shareable",
+    /** A read failed. The screen says so and offers nothing. */
+    FAILED = "failed"
+}
+/** One of the granting organization's relationships, as the read describes it: who it is, and what its people reach of the record. */
+export interface RecordSharingRelationship extends RelationshipRecordReach {
+    readonly relationshipId: string;
+    /** The representing organization's name, when the relationship carries it. */
+    readonly name?: string;
+}
+export interface RecordSharing {
+    readonly readState: RecordSharingReadState;
+    /**
+     * A change was made and the answer is being read again. The last answer stays shown meanwhile (READY), so the section
+     * does not vanish under the person who just acted (#2736 review F2); the screen disables its controls instead.
+     */
+    readonly refreshing: boolean;
+    readonly relationships: readonly RecordSharingRelationship[];
+    /** The relationship the record was created through, or `null` when it is the organization's own. */
+    readonly viaRelationshipId: string | null;
+    /** The relationships the organization shared the record with. */
+    readonly sharedWithRelationshipIds: readonly string[];
+    /** Every relationship reads every record of this resource by the application's declaration: a share changes nothing. */
+    readonly commonToEveryRelationship: boolean;
+    /** Share the record with one relationship, then read again. Rejects when the backend refused; it has reported why. */
+    readonly share: (relationshipId: string) => Promise<void>;
+    /** Withdraw a share, then read again. Rejects when the backend refused; it has reported why. */
+    readonly unshare: (relationshipId: string) => Promise<void>;
+}
+/**
+ * The relationships resource's default API operation `identifier`, as this frontend registers it; `undefined` when it is
+ * not registered, which leaves the screen with nothing to offer rather than a guessed URL.
+ */
+export declare function findRelationshipOperation(registry: FrontendResourcesRegistry | undefined, identifier: string): FrontendResourceConfiguration_Operation | undefined;
+/** Whether a rejected read is the backend saying it does not share this resource's records. */
+export declare function isRecordNotShareableRefusal(error: unknown): boolean;
+/**
+ * See the module comment. `enabled` is the screen's gate (the resource carries provenance, the viewer administers the
+ * granting organization the record belongs to); nothing is asked while it is false.
+ */
+export declare function useRecordSharing(input: {
+    readonly enabled: boolean;
+    readonly organizationId: string | undefined;
+    readonly resourceType: string;
+    readonly recordId: string | undefined;
+}): RecordSharing;
+//# sourceMappingURL=useRecordSharing.d.ts.map

package/dist/esm/core/resources/useRecordSharing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecordSharing.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useRecordSharing.ts"],"names":[],"mappings":"AAuBA,OAAO,EAQL,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,uCAAuC,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAOxJ,sCAAsC;AACtC,oBAAY,sBAAsB;IAChC,wDAAwD;IACxD,IAAI,SAAS;IACb,wHAAwH;IACxH,OAAO,YAAY;IACnB,uDAAuD;IACvD,KAAK,UAAU;IACf,qFAAqF;IACrF,aAAa,kBAAkB;IAC/B,4DAA4D;IAC5D,MAAM,WAAW;CAClB;AAED,sIAAsI;AACtI,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC7D,oGAAoG;IACpG,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,iEAAiE;IACjE,QAAQ,CAAC,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtD,wHAAwH;IACxH,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;IAC5C,sHAAsH;IACtH,QAAQ,CAAC,KAAK,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,gGAAgG;IAChG,QAAQ,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,yBAAyB,GAAG,SAAS,EAC/C,UAAU,EAAE,MAAM,GACjB,uCAAuC,GAAG,SAAS,CASrD;AA4BD,+FAA+F;AAC/F,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAInE;AAgBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,GAAG,aAAa,CAoIhB"}

package/dist/esm/core/resources/useRecordSharing.js

@@ -0,0 +1,220 @@
+/**
+ * One record's sharing with the organization's relationships (#2736), for the administrator of the granting organization.
+ *
+ * #2722 separated records between an organization's relationships: a record created through one relationship is that
+ * relationship's, and the organization's own records reach a representative only as its relationship kind allows. The
+ * organization's administrators widen that record by record with `shareRecord` / `unshareRecord` on the relationship.
+ *
+ * Everything the screen says comes from one administrator-only read, `readRecordSharing`, which answers whose the record
+ * is, who it is shared with, and for every live relationship (and any other the record names) what its people reach of
+ * the record: whether it confers now, whether its roles reach this record (its role and lent capabilities, and its units
+ * for a relationship limited to units), whether it reads the record without a share, and whether a share would let it.
+ * The backend decides each with the request path's own predicates and the authorizer's own answer, so the screen never
+ * offers a share that changes nothing (a record no relationship can read, a relationship that already reads it, a dormant
+ * relationship) and never claims a reach the engine would not grant (#2736 review N1, N2, M1). The
+ * provenance and shares are stripped from the record's own response: a representative reading a shared record never
+ * learns which other relationships it reaches.
+ *
+ * A resource the backend will not share at all (a system of record's rows, which have no table to hold a share) answers
+ * `RELATIONSHIP_RECORD_NOT_SHAREABLE`: the screen then has nothing to offer and says nothing
+ * ({@link RecordSharingReadState.NOT_SHAREABLE}). Any other failure is a read that did not complete and is shown as one.
+ * Presentation only: the backend authorizes every call.
+ */
+import { useCallback, useContext, useEffect, useRef, useState } from 'react';
+import { CoreResourceType, OrganizationRelationshipErrorCode, OrganizationRelationships_Operations, RelationshipRecordSharingSchema, ResourceOperationVariantType, ResourcesConfig_OperationPathUtils, isWildoBackendError, } from '@wildo-ai/saas-models';
+import { ResourceRegistryContext } from '../../core/resources/ResourceRegistryContext.js';
+import { ScopeUtilsService } from '../../core/scope/scope.utils.frontend.service.js';
+import { FrontendResourceUtils, frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+const logger = LoggerFrontendService.getLogger();
+/** Where the screen's read stands. */
+export var RecordSharingReadState;
+(function (RecordSharingReadState) {
+    /** Nothing is asked: the screen is not offered here. */
+    RecordSharingReadState["IDLE"] = "idle";
+    /** Asked; the answer has not arrived. The screen shows nothing yet, so nothing is offered first and withdrawn after. */
+    RecordSharingReadState["LOADING"] = "loading";
+    /** The read answered, for the record now on screen. */
+    RecordSharingReadState["READY"] = "ready";
+    /** The backend does not share records of this resource. The screen shows nothing. */
+    RecordSharingReadState["NOT_SHAREABLE"] = "not_shareable";
+    /** A read failed. The screen says so and offers nothing. */
+    RecordSharingReadState["FAILED"] = "failed";
+})(RecordSharingReadState || (RecordSharingReadState = {}));
+/**
+ * The relationships resource's default API operation `identifier`, as this frontend registers it; `undefined` when it is
+ * not registered, which leaves the screen with nothing to offer rather than a guessed URL.
+ */
+export function findRelationshipOperation(registry, identifier) {
+    const operations = registry?.resourceConfigurations[CoreResourceType.ORGANIZATION_RELATIONSHIPS]?.operations;
+    return operations?.find((operation) => String(operation.operationIdentifier) === identifier
+        && operation.isOperationDefault === true
+        && operation.isBulkOperation !== true
+        && operation.variantType === ResourceOperationVariantType.API_CALL);
+}
+/**
+ * The parameters one relationships call carries: the organization it acts in, and the relationship row for a verb on
+ * one. Built by the same scope utility every resource surface of the organization uses.
+ */
+function relationshipCallOf(registry, operation, organizationId, relationshipId) {
+    const resourceType = CoreResourceType.ORGANIZATION_RELATIONSHIPS;
+    const contextResourceIdentifiers = {
+        ...ScopeUtilsService.buildResourceOperationContextIdentifiers({
+            currentOrganizationId: organizationId,
+            primaryScope: registry.resourceConfigurations[resourceType]?.resourcePrimaryScope,
+            explicitContextResourceIdentifiers: {},
+        }),
+        ...(relationshipId ? { [resourceType]: relationshipId } : {}),
+    };
+    return {
+        operationPathKey: ResourcesConfig_OperationPathUtils.buildOperationPathKeyFromOperation(operation),
+        contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),
+        parentResourcesRequirements: frontendResourceUtils.buildParentResourcesRequirements(resourceType, contextResourceIdentifiers, registry),
+    };
+}
+/** Whether a rejected read is the backend saying it does not share this resource's records. */
+export function isRecordNotShareableRefusal(error) {
+    const errorLike = error;
+    const code = errorLike?.response?.data?.error?.details?.code ?? errorLike?.context?.code;
+    return code === OrganizationRelationshipErrorCode.RELATIONSHIP_RECORD_NOT_SHAREABLE;
+}
+const NOTHING_SHARED = {
+    relationships: [],
+    viaRelationshipId: null,
+    sharedWithRelationshipIds: [],
+    commonToEveryRelationship: false,
+};
+/**
+ * See the module comment. `enabled` is the screen's gate (the resource carries provenance, the viewer administers the
+ * granting organization the record belongs to); nothing is asked while it is false.
+ */
+export function useRecordSharing(input) {
+    // The context itself, so a host rendered outside the registry provider reads "nothing offered" rather than failing.
+    const registryContext = useContext(ResourceRegistryContext);
+    const registry = registryContext?.registry;
+    // The scoped `doOperation` changes identity with every scope change; read the latest through a ref so a settling scope
+    // does not cancel and resend the read (the reason `useCurrentOrganizationHoldsUnrevokedScimToken` gives).
+    const doOperationRef = useRef(registryContext?.doOperation);
+    doOperationRef.current = registryContext?.doOperation;
+    const [generation, setGeneration] = useState(0);
+    const [readState, setReadState] = useState(RecordSharingReadState.IDLE);
+    const [refreshing, setRefreshing] = useState(false);
+    const [answer, setAnswer] = useState(NOTHING_SHARED);
+    const { enabled, organizationId, resourceType, recordId } = input;
+    // The record the answer (or the failure) on hand belongs to. Read during render, so the frame in which the page has
+    // moved to another record, before the effect below runs, never shows the previous record's sharing (#2736 review I4).
+    const [answeredSubject, setAnsweredSubject] = useState(undefined);
+    const currentSubject = enabled && organizationId && recordId ? `${organizationId}|${resourceType}|${recordId}` : undefined;
+    // The record whose answer is on screen. A read for the SAME record after a change refreshes it in place; a read for
+    // another record starts from nothing; with the render-time check on `answeredSubject`, one record's sharing is never
+    // shown as another's, not even for the frame before this effect runs.
+    const settledSubjectRef = useRef(undefined);
+    useEffect(() => {
+        const doOperation = doOperationRef.current;
+        const readOperation = findRelationshipOperation(registry, OrganizationRelationships_Operations.READ_RECORD_SHARING);
+        if (!enabled || !registry || !doOperation || !organizationId || !recordId || !readOperation) {
+            settledSubjectRef.current = undefined;
+            setAnsweredSubject(undefined);
+            setReadState(RecordSharingReadState.IDLE);
+            setRefreshing(false);
+            setAnswer(NOTHING_SHARED);
+            return undefined;
+        }
+        let cancelled = false;
+        const subject = `${organizationId}|${resourceType}|${recordId}`;
+        if (settledSubjectRef.current === subject) {
+            setRefreshing(true);
+        }
+        else {
+            settledSubjectRef.current = undefined;
+            setRefreshing(false);
+            setAnswer(NOTHING_SHARED);
+            setReadState(RecordSharingReadState.LOADING);
+        }
+        void (async () => {
+            try {
+                const sharingCall = relationshipCallOf(registry, readOperation, organizationId);
+                // Silent: a refusal here is answered by the screen itself (hidden, or "could not be read").
+                const sharing = RelationshipRecordSharingSchema.parse(await doOperation(sharingCall.operationPathKey, { contextualParameters: sharingCall.contextualParameters, parentResourcesRequirements: sharingCall.parentResourcesRequirements, requestData: { resourceType, recordId } }, { silent: true }));
+                if (cancelled)
+                    return;
+                setAnswer({
+                    relationships: sharing.relationships.map(({ representingOrganizationName, ...relationship }) => ({
+                        ...relationship,
+                        ...(representingOrganizationName ? { name: representingOrganizationName } : {}),
+                    })),
+                    viaRelationshipId: sharing.viaRelationshipId,
+                    sharedWithRelationshipIds: sharing.sharedWithRelationshipIds,
+                    commonToEveryRelationship: sharing.commonToEveryRelationship,
+                });
+                settledSubjectRef.current = subject;
+                setAnsweredSubject(subject);
+                setReadState(RecordSharingReadState.READY);
+                setRefreshing(false);
+            }
+            catch (error) {
+                if (cancelled)
+                    return;
+                settledSubjectRef.current = undefined;
+                setAnsweredSubject(subject);
+                setRefreshing(false);
+                setAnswer(NOTHING_SHARED);
+                if (isRecordNotShareableRefusal(error)) {
+                    setReadState(RecordSharingReadState.NOT_SHAREABLE);
+                    return;
+                }
+                logger.warn('[RecordSharing] The record\'s sharing could not be read', { resourceType, backendError: isWildoBackendError(error) });
+                setReadState(RecordSharingReadState.FAILED);
+            }
+        })();
+        return () => { cancelled = true; };
+    }, [enabled, registry, organizationId, resourceType, recordId, generation]);
+    const change = useCallback(async (identifier, relationshipId) => {
+        const doOperation = doOperationRef.current;
+        const operation = findRelationshipOperation(registry, identifier);
+        if (!registry || !doOperation || !operation || !organizationId || !recordId) {
+            throw new Error(`The ${identifier} operation of organization relationships is not available in this frontend.`);
+        }
+        const call = relationshipCallOf(registry, operation, organizationId, relationshipId);
+        // Disabled from the click, not from the next render: the re-read below starts on the following commit, and the
+        // controls must not re-enable over the answer the change is about to replace (#2736 review N5).
+        setRefreshing(true);
+        try {
+            // Not silent: a refusal (a relationship no longer active, a record gone) is reported by the request's own handling.
+            await doOperation(call.operationPathKey, {
+                contextualParameters: call.contextualParameters,
+                parentResourcesRequirements: call.parentResourcesRequirements,
+                requestData: { resourceType, recordId },
+            });
+        }
+        finally {
+            setGeneration((value) => value + 1);
+        }
+    }, [registry, organizationId, resourceType, recordId]);
+    const share = useCallback((relationshipId) => change(OrganizationRelationships_Operations.SHARE_RECORD, relationshipId), [change]);
+    const unshare = useCallback((relationshipId) => change(OrganizationRelationships_Operations.UNSHARE_RECORD, relationshipId), [change]);
+    // An answer about another record than the one asked now is not shown: the read for this one is on its way.
+    if (readState !== RecordSharingReadState.IDLE && readState !== RecordSharingReadState.LOADING && answeredSubject !== currentSubject) {
+        return {
+            readState: RecordSharingReadState.LOADING,
+            refreshing: false,
+            relationships: NOTHING_SHARED.relationships,
+            viaRelationshipId: NOTHING_SHARED.viaRelationshipId,
+            sharedWithRelationshipIds: NOTHING_SHARED.sharedWithRelationshipIds,
+            commonToEveryRelationship: NOTHING_SHARED.commonToEveryRelationship,
+            share,
+            unshare,
+        };
+    }
+    return {
+        readState,
+        refreshing,
+        relationships: answer.relationships,
+        viaRelationshipId: answer.viaRelationshipId,
+        sharedWithRelationshipIds: answer.sharedWithRelationshipIds,
+        commonToEveryRelationship: answer.commonToEveryRelationship,
+        share,
+        unshare,
+    };
+}
+//# sourceMappingURL=useRecordSharing.js.map

package/dist/esm/core/resources/useRecordSharing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecordSharing.js","sourceRoot":"","sources":["../../../../../src/core/resources/useRecordSharing.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * One record's sharing with the organization's relationships (#2736), for the administrator of the granting organization.\n *\n * #2722 separated records between an organization's relationships: a record created through one relationship is that\n * relationship's, and the organization's own records reach a representative only as its relationship kind allows. The\n * organization's administrators widen that record by record with `shareRecord` / `unshareRecord` on the relationship.\n *\n * Everything the screen says comes from one administrator-only read, `readRecordSharing`, which answers whose the record\n * is, who it is shared with, and for every live relationship (and any other the record names) what its people reach of\n * the record: whether it confers now, whether its roles reach this record (its role and lent capabilities, and its units\n * for a relationship limited to units), whether it reads the record without a share, and whether a share would let it.\n * The backend decides each with the request path's own predicates and the authorizer's own answer, so the screen never\n * offers a share that changes nothing (a record no relationship can read, a relationship that already reads it, a dormant\n * relationship) and never claims a reach the engine would not grant (#2736 review N1, N2, M1). The\n * provenance and shares are stripped from the record's own response: a representative reading a shared record never\n * learns which other relationships it reaches.\n *\n * A resource the backend will not share at all (a system of record's rows, which have no table to hold a share) answers\n * `RELATIONSHIP_RECORD_NOT_SHAREABLE`: the screen then has nothing to offer and says nothing\n * ({@link RecordSharingReadState.NOT_SHAREABLE}). Any other failure is a read that did not complete and is shown as one.\n * Presentation only: the backend authorizes every call.\n */\nimport { useCallback, useContext, useEffect, useRef, useState } from 'react';\nimport {\n  CoreResourceType,\n  OrganizationRelationshipErrorCode,\n  OrganizationRelationships_Operations,\n  RelationshipRecordSharingSchema,\n  ResourceOperationVariantType,\n  ResourcesConfig_OperationPathUtils,\n  isWildoBackendError,\n  type RelationshipRecordReach,\n} from '@wildo-ai/saas-models';\nimport { ResourceRegistryContext } from '~wildo-frontend-lib/core/resources/ResourceRegistryContext';\nimport type { FrontendResourceConfiguration_Operation, FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { ScopeUtilsService } from '~wildo-frontend-lib/core/scope/scope.utils.frontend.service';\nimport { FrontendResourceUtils, frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\n\n/** Where the screen's read stands. */\nexport enum RecordSharingReadState {\n  /** Nothing is asked: the screen is not offered here. */\n  IDLE = 'idle',\n  /** Asked; the answer has not arrived. The screen shows nothing yet, so nothing is offered first and withdrawn after. */\n  LOADING = 'loading',\n  /** The read answered, for the record now on screen. */\n  READY = 'ready',\n  /** The backend does not share records of this resource. The screen shows nothing. */\n  NOT_SHAREABLE = 'not_shareable',\n  /** A read failed. The screen says so and offers nothing. */\n  FAILED = 'failed',\n}\n\n/** One of the granting organization's relationships, as the read describes it: who it is, and what its people reach of the record. */\nexport interface RecordSharingRelationship extends RelationshipRecordReach {\n  readonly relationshipId: string;\n  /** The representing organization's name, when the relationship carries it. */\n  readonly name?: string;\n}\n\nexport interface RecordSharing {\n  readonly readState: RecordSharingReadState;\n  /**\n   * A change was made and the answer is being read again. The last answer stays shown meanwhile (READY), so the section\n   * does not vanish under the person who just acted (#2736 review F2); the screen disables its controls instead.\n   */\n  readonly refreshing: boolean;\n  readonly relationships: readonly RecordSharingRelationship[];\n  /** The relationship the record was created through, or `null` when it is the organization's own. */\n  readonly viaRelationshipId: string | null;\n  /** The relationships the organization shared the record with. */\n  readonly sharedWithRelationshipIds: readonly string[];\n  /** Every relationship reads every record of this resource by the application's declaration: a share changes nothing. */\n  readonly commonToEveryRelationship: boolean;\n  /** Share the record with one relationship, then read again. Rejects when the backend refused; it has reported why. */\n  readonly share: (relationshipId: string) => Promise<void>;\n  /** Withdraw a share, then read again. Rejects when the backend refused; it has reported why. */\n  readonly unshare: (relationshipId: string) => Promise<void>;\n}\n\n/**\n * The relationships resource's default API operation `identifier`, as this frontend registers it; `undefined` when it is\n * not registered, which leaves the screen with nothing to offer rather than a guessed URL.\n */\nexport function findRelationshipOperation(\n  registry: FrontendResourcesRegistry | undefined,\n  identifier: string,\n): FrontendResourceConfiguration_Operation | undefined {\n  const operations = registry?.resourceConfigurations[CoreResourceType.ORGANIZATION_RELATIONSHIPS]?.operations as\n    | readonly FrontendResourceConfiguration_Operation[]\n    | undefined;\n  return operations?.find((operation) =>\n    String(operation.operationIdentifier) === identifier\n    && operation.isOperationDefault === true\n    && operation.isBulkOperation !== true\n    && operation.variantType === ResourceOperationVariantType.API_CALL);\n}\n\n/**\n * The parameters one relationships call carries: the organization it acts in, and the relationship row for a verb on\n * one. Built by the same scope utility every resource surface of the organization uses.\n */\nfunction relationshipCallOf(\n  registry: FrontendResourcesRegistry,\n  operation: FrontendResourceConfiguration_Operation,\n  organizationId: string,\n  relationshipId?: string,\n): { operationPathKey: string; contextualParameters: Record<string, string | number>; parentResourcesRequirements: ReturnType<typeof frontendResourceUtils.buildParentResourcesRequirements> } {\n  const resourceType = CoreResourceType.ORGANIZATION_RELATIONSHIPS;\n  const contextResourceIdentifiers = {\n    ...ScopeUtilsService.buildResourceOperationContextIdentifiers({\n      currentOrganizationId: organizationId,\n      primaryScope: registry.resourceConfigurations[resourceType]?.resourcePrimaryScope,\n      explicitContextResourceIdentifiers: {},\n    }),\n    ...(relationshipId ? { [resourceType]: relationshipId } : {}),\n  };\n  return {\n    operationPathKey: ResourcesConfig_OperationPathUtils.buildOperationPathKeyFromOperation(operation),\n    contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),\n    parentResourcesRequirements: frontendResourceUtils.buildParentResourcesRequirements(resourceType, contextResourceIdentifiers, registry),\n  };\n}\n\n/** Whether a rejected read is the backend saying it does not share this resource's records. */\nexport function isRecordNotShareableRefusal(error: unknown): boolean {\n  const errorLike = error as { response?: { data?: { error?: { details?: { code?: unknown } } } }; context?: { code?: unknown } } | null | undefined;\n  const code = errorLike?.response?.data?.error?.details?.code ?? errorLike?.context?.code;\n  return code === OrganizationRelationshipErrorCode.RELATIONSHIP_RECORD_NOT_SHAREABLE;\n}\n\ninterface SharingAnswer {\n  readonly relationships: readonly RecordSharingRelationship[];\n  readonly viaRelationshipId: string | null;\n  readonly sharedWithRelationshipIds: readonly string[];\n  readonly commonToEveryRelationship: boolean;\n}\n\nconst NOTHING_SHARED: SharingAnswer = {\n  relationships: [],\n  viaRelationshipId: null,\n  sharedWithRelationshipIds: [],\n  commonToEveryRelationship: false,\n};\n\n/**\n * See the module comment. `enabled` is the screen's gate (the resource carries provenance, the viewer administers the\n * granting organization the record belongs to); nothing is asked while it is false.\n */\nexport function useRecordSharing(input: {\n  readonly enabled: boolean;\n  readonly organizationId: string | undefined;\n  readonly resourceType: string;\n  readonly recordId: string | undefined;\n}): RecordSharing {\n  // The context itself, so a host rendered outside the registry provider reads \"nothing offered\" rather than failing.\n  const registryContext = useContext(ResourceRegistryContext);\n  const registry = registryContext?.registry;\n  // The scoped `doOperation` changes identity with every scope change; read the latest through a ref so a settling scope\n  // does not cancel and resend the read (the reason `useCurrentOrganizationHoldsUnrevokedScimToken` gives).\n  const doOperationRef = useRef(registryContext?.doOperation);\n  doOperationRef.current = registryContext?.doOperation;\n\n  const [generation, setGeneration] = useState(0);\n  const [readState, setReadState] = useState<RecordSharingReadState>(RecordSharingReadState.IDLE);\n  const [refreshing, setRefreshing] = useState(false);\n  const [answer, setAnswer] = useState<SharingAnswer>(NOTHING_SHARED);\n  const { enabled, organizationId, resourceType, recordId } = input;\n  // The record the answer (or the failure) on hand belongs to. Read during render, so the frame in which the page has\n  // moved to another record, before the effect below runs, never shows the previous record's sharing (#2736 review I4).\n  const [answeredSubject, setAnsweredSubject] = useState<string | undefined>(undefined);\n  const currentSubject = enabled && organizationId && recordId ? `${organizationId}|${resourceType}|${recordId}` : undefined;\n  // The record whose answer is on screen. A read for the SAME record after a change refreshes it in place; a read for\n  // another record starts from nothing; with the render-time check on `answeredSubject`, one record's sharing is never\n  // shown as another's, not even for the frame before this effect runs.\n  const settledSubjectRef = useRef<string | undefined>(undefined);\n\n  useEffect(() => {\n    const doOperation = doOperationRef.current;\n    const readOperation = findRelationshipOperation(registry, OrganizationRelationships_Operations.READ_RECORD_SHARING);\n    if (!enabled || !registry || !doOperation || !organizationId || !recordId || !readOperation) {\n      settledSubjectRef.current = undefined;\n      setAnsweredSubject(undefined);\n      setReadState(RecordSharingReadState.IDLE);\n      setRefreshing(false);\n      setAnswer(NOTHING_SHARED);\n      return undefined;\n    }\n    let cancelled = false;\n    const subject = `${organizationId}|${resourceType}|${recordId}`;\n    if (settledSubjectRef.current === subject) {\n      setRefreshing(true);\n    } else {\n      settledSubjectRef.current = undefined;\n      setRefreshing(false);\n      setAnswer(NOTHING_SHARED);\n      setReadState(RecordSharingReadState.LOADING);\n    }\n    void (async () => {\n      try {\n        const sharingCall = relationshipCallOf(registry, readOperation, organizationId);\n        // Silent: a refusal here is answered by the screen itself (hidden, or \"could not be read\").\n        const sharing = RelationshipRecordSharingSchema.parse(await doOperation(\n          sharingCall.operationPathKey,\n          { contextualParameters: sharingCall.contextualParameters, parentResourcesRequirements: sharingCall.parentResourcesRequirements, requestData: { resourceType, recordId } },\n          { silent: true },\n        ));\n        if (cancelled) return;\n        setAnswer({\n          relationships: sharing.relationships.map(({ representingOrganizationName, ...relationship }) => ({\n            ...relationship,\n            ...(representingOrganizationName ? { name: representingOrganizationName } : {}),\n          })),\n          viaRelationshipId: sharing.viaRelationshipId,\n          sharedWithRelationshipIds: sharing.sharedWithRelationshipIds,\n          commonToEveryRelationship: sharing.commonToEveryRelationship,\n        });\n        settledSubjectRef.current = subject;\n        setAnsweredSubject(subject);\n        setReadState(RecordSharingReadState.READY);\n        setRefreshing(false);\n      } catch (error: unknown) {\n        if (cancelled) return;\n        settledSubjectRef.current = undefined;\n        setAnsweredSubject(subject);\n        setRefreshing(false);\n        setAnswer(NOTHING_SHARED);\n        if (isRecordNotShareableRefusal(error)) {\n          setReadState(RecordSharingReadState.NOT_SHAREABLE);\n          return;\n        }\n        logger.warn('[RecordSharing] The record\\'s sharing could not be read', { resourceType, backendError: isWildoBackendError(error) });\n        setReadState(RecordSharingReadState.FAILED);\n      }\n    })();\n    return () => { cancelled = true; };\n  }, [enabled, registry, organizationId, resourceType, recordId, generation]);\n\n  const change = useCallback(async (identifier: string, relationshipId: string) => {\n    const doOperation = doOperationRef.current;\n    const operation = findRelationshipOperation(registry, identifier);\n    if (!registry || !doOperation || !operation || !organizationId || !recordId) {\n      throw new Error(`The ${identifier} operation of organization relationships is not available in this frontend.`);\n    }\n    const call = relationshipCallOf(registry, operation, organizationId, relationshipId);\n    // Disabled from the click, not from the next render: the re-read below starts on the following commit, and the\n    // controls must not re-enable over the answer the change is about to replace (#2736 review N5).\n    setRefreshing(true);\n    try {\n      // Not silent: a refusal (a relationship no longer active, a record gone) is reported by the request's own handling.\n      await doOperation(call.operationPathKey, {\n        contextualParameters: call.contextualParameters,\n        parentResourcesRequirements: call.parentResourcesRequirements,\n        requestData: { resourceType, recordId },\n      });\n    } finally {\n      setGeneration((value) => value + 1);\n    }\n  }, [registry, organizationId, resourceType, recordId]);\n\n  const share = useCallback((relationshipId: string) => change(OrganizationRelationships_Operations.SHARE_RECORD, relationshipId), [change]);\n  const unshare = useCallback((relationshipId: string) => change(OrganizationRelationships_Operations.UNSHARE_RECORD, relationshipId), [change]);\n\n  // An answer about another record than the one asked now is not shown: the read for this one is on its way.\n  if (readState !== RecordSharingReadState.IDLE && readState !== RecordSharingReadState.LOADING && answeredSubject !== currentSubject) {\n    return {\n      readState: RecordSharingReadState.LOADING,\n      refreshing: false,\n      relationships: NOTHING_SHARED.relationships,\n      viaRelationshipId: NOTHING_SHARED.viaRelationshipId,\n      sharedWithRelationshipIds: NOTHING_SHARED.sharedWithRelationshipIds,\n      commonToEveryRelationship: NOTHING_SHARED.commonToEveryRelationship,\n      share,\n      unshare,\n    };\n  }\n  return {\n    readState,\n    refreshing,\n    relationships: answer.relationships,\n    viaRelationshipId: answer.viaRelationshipId,\n    sharedWithRelationshipIds: answer.sharedWithRelationshipIds,\n    commonToEveryRelationship: answer.commonToEveryRelationship,\n    share,\n    unshare,\n  };\n}\n"]}

package/dist/esm/core/resources/useResourceLabels.d.ts

@@ -51,7 +51,10 @@ export interface UseResourceLabelsOptions {
      * which is what `display-text-comes-from-i18n.md` asks for.
      */
     fieldPathPrefix?: string;
-    /** Explicit i18n-key overrides — these take priority over ref-derived defaults */
+    /**
+     * Overrides that win over the i18n tree. `fields`, `descriptions` and `enums` are TEXT as written. A section or
+     * wizard-step entry carries either a key (`titleKey` / `descriptionKey`) or text (`title` / `description`); text wins.
+     */
     overrides?: {
         fields?: Record<string, string>;
         /** Explicit description overrides per field name */