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

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

@@ -28,10 +28,10 @@
  * that, which is the entire point — the previous hand-rolled pane WAS the override.
  */
 import { useCallback, useMemo } from 'react';
-import { CoreResourceOperation, NavigationZoneName } from '@wildo-ai/saas-models';
+import { CoreResourceOperation, NavigationZoneName, ResourceOperationFrontendSurface } from '@wildo-ai/saas-models';
 import { useResourceRegistry } from './useResourceRegistry.js';
 import { frontendResourceUtils, FrontendResourceUtils } from './frontend-resource.utils.js';
-import { pickPreferredOperationForCoreSemanticAddressability } from './resource-addressability.frontend.utils.js';
+import { pickPreferredOperationForCoreSemanticAddressability, } from './resource-addressability.frontend.utils.js';
 import { useNavigationController } from '../../core/navigation/useNavigationController.js';
 export function useHostlessResourceNavigation() {
     const { registry } = useResourceRegistry();
@@ -45,27 +45,20 @@ export function useHostlessResourceNavigation() {
         if (!resourceConfig) {
             return false;
         }
-        const targetContextResourceIdentifiers = {
-            ...contextResourceIdentifiers,
-            [resourceType]: resourceId,
-        };
+        const targetContextResourceIdentifiers = frontendResourceUtils.buildRecordIdentifiersFromCollection(contextResourceIdentifiers, resourceType, resourceId);
         /*
-         * `requireFrontendAddressable: true` with no EMBEDDED fallback, unlike `ResourceLayout_List`.
-         * That list can fall back because it HAS a host to render an embedded read inside; a composite
-         * view does not, so an EMBEDDED read reached from here would have nowhere to go — and answering
-         * `false` is a visible no-op the author can debug, where navigating to a surface that cannot
-         * render is not.
+         * An ADDRESSABLE read first; failing that, an EMBEDDED one (#2063).
+         *
+         * This used to stop at the addressable read, on the reasoning that a composite view has no host
+         * for an embedded read, so it "would have nowhere to go". The navigation layer answers that: an
+         * EMBEDDED read navigated into a structural zone is coerced to an OVERLAY
+         * (`NavigationPlacementAdjustment.EMBEDDED_COERCED_TO_OVERLAY`), which is exactly how a reference
+         * to an aspect row opens it (`resolveFkOverlayTarget` in the reference display emits the same
+         * navigation). Without the fallback every workbench aspect row — whose READ is EMBEDDED by design —
+         * was unopenable from Home, a card or a `?open=` deep link: the call answered `false`, the caller
+         * ignored it, and no request was ever sent.
          */
-        const readOperation = pickPreferredOperationForCoreSemanticAddressability({
-            resourceConfig,
-            operations: resourceConfig.operations ?? [],
-            coreOperation: CoreResourceOperation.READ,
-            registry,
-            hasResourceId: true,
-            requireFrontendAddressable: true,
-            contextResourceIdentifiers: targetContextResourceIdentifiers,
-            contextualParameters: FrontendResourceUtils.buildContextualParameters(targetContextResourceIdentifiers, registry),
-        });
+        const readOperation = pickHostlessReadOperation(resourceConfig, registry, targetContextResourceIdentifiers);
         if (!readOperation) {
             return false;
         }
@@ -78,4 +71,25 @@ export function useHostlessResourceNavigation() {
     }, [registry, navigateToResource]);
     return useMemo(() => ({ navigateToResourceRead }), [navigateToResourceRead]);
 }
+/**
+ * The READ a hostless navigation opens: the preferred addressable one, else an `EMBEDDED` one (opened as
+ * an overlay by the navigation layer). `API_ONLY` and every other surface yield `undefined`.
+ */
+function pickHostlessReadOperation(resourceConfig, registry, contextResourceIdentifiers) {
+    const pick = (requireFrontendAddressable) => pickPreferredOperationForCoreSemanticAddressability({
+        resourceConfig,
+        operations: resourceConfig?.operations ?? [],
+        coreOperation: CoreResourceOperation.READ,
+        registry,
+        hasResourceId: true,
+        requireFrontendAddressable,
+        contextResourceIdentifiers,
+        contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),
+    });
+    const addressable = pick(true);
+    if (addressable)
+        return addressable;
+    const anyRead = pick(false);
+    return anyRead?.operationFrontendConfig?.surface === ResourceOperationFrontendSurface.EMBEDDED ? anyRead : undefined;
+}
 //# sourceMappingURL=useHostlessResourceNavigation.js.map

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/useOperationEnabled.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationEnabled.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/useOperationEnabled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"useOperationEnabled.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useOperationEnabled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,6BAA6B,CAAC"}

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"}