@wildo-ai/saas-frontend-lib 1.1.5 → 1.1.6

package/dist/esm/core/resources/rmm/update-like-mutation-fallback.frontend.d.ts

@@ -41,4 +41,14 @@ export declare class MissingRMMRuntimeError extends Error {
     constructor(params: MissingRMMRuntimeErrorParams);
 }
 export declare function allowsDirectOperationFallback(mode: UpdateLikeMutationFallbackMode | undefined): boolean;
+/**
+ * The lane an operation DECLARED for itself (`operationFrontendConfig.updateLikeMutationFallbackMode`),
+ * or `RMM_REQUIRED` when it declared none. Both operation hosts, the form and the form-less one, ask this
+ * one function, so an operation cannot submit from one host and be refused by the other.
+ */
+export declare function resolveDeclaredUpdateLikeMutationFallbackMode(operation: {
+    operationFrontendConfig?: {
+        updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;
+    };
+}): UpdateLikeMutationFallbackMode;
 //# sourceMappingURL=update-like-mutation-fallback.frontend.d.ts.map

package/dist/esm/core/resources/rmm/update-like-mutation-fallback.frontend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-like-mutation-fallback.frontend.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/update-like-mutation-fallback.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,oBAAY,8BAA8B;IACxC,YAAY,iBAAiB;IAC7B,yBAAyB,8BAA8B;CACxD;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;gBAE1B,MAAM,EAAE,4BAA4B;CAcjD;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,8BAA8B,GAAG,SAAS,GAC/C,OAAO,CAET"}
+{"version":3,"file":"update-like-mutation-fallback.frontend.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/update-like-mutation-fallback.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,oBAAY,8BAA8B;IACxC,YAAY,iBAAiB;IAC7B,yBAAyB,8BAA8B;CACxD;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;gBAE1B,MAAM,EAAE,4BAA4B;CAcjD;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,8BAA8B,GAAG,SAAS,GAC/C,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,6CAA6C,CAAC,SAAS,EAAE;IACvE,uBAAuB,CAAC,EAAE;QAAE,8BAA8B,CAAC,EAAE,8BAA8B,CAAA;KAAE,CAAC;CAC/F,GAAG,8BAA8B,CAEjC"}

package/dist/esm/core/resources/rmm/update-like-mutation-fallback.frontend.js

@@ -50,4 +50,12 @@ export class MissingRMMRuntimeError extends Error {
 export function allowsDirectOperationFallback(mode) {
     return mode === UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK;
 }
+/**
+ * The lane an operation DECLARED for itself (`operationFrontendConfig.updateLikeMutationFallbackMode`),
+ * or `RMM_REQUIRED` when it declared none. Both operation hosts, the form and the form-less one, ask this
+ * one function, so an operation cannot submit from one host and be refused by the other.
+ */
+export function resolveDeclaredUpdateLikeMutationFallbackMode(operation) {
+    return operation.operationFrontendConfig?.updateLikeMutationFallbackMode ?? UpdateLikeMutationFallbackMode.RMM_REQUIRED;
+}
 //# sourceMappingURL=update-like-mutation-fallback.frontend.js.map

package/dist/esm/core/resources/rmm/update-like-mutation-fallback.frontend.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-like-mutation-fallback.frontend.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/update-like-mutation-fallback.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,8BAGX;AAHD,WAAY,8BAA8B;IACxC,+DAA6B,CAAA;IAC7B,yFAAuD,CAAA;AACzD,CAAC,EAHW,8BAA8B,KAA9B,8BAA8B,QAGzC;AAQD;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,WAAW,CAAS;IACpB,YAAY,CAAS;IACrB,mBAAmB,CAAU;IAEtC,YAAY,MAAoC;QAC9C,MAAM,eAAe,GAAG,MAAM,CAAC,mBAAmB;YAChD,CAAC,CAAC,mBAAmB,MAAM,CAAC,mBAAmB,GAAG;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,CACH,GAAG,MAAM,CAAC,WAAW,sEAAsE;YAC3F,IAAI,MAAM,CAAC,YAAY,IAAI,eAAe,gDAAgD;YAC1F,4FAA4F,CAC7F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC;IACxD,CAAC;CACF;AAED,MAAM,UAAU,6BAA6B,CAC3C,IAAgD;IAEhD,OAAO,IAAI,KAAK,8BAA8B,CAAC,yBAAyB,CAAC;AAC3E,CAAC","sourcesContent":["/**\n * Step 6 escape-hatch classification for framework mutation surfaces.\n *\n * Default engine surfaces should behave as if RMM-backed update semantics are a\n * real contract, not a best-effort preference. When a caller knowingly wants a\n * weaker direct `doOperation()` path instead, that downgrade must be explicit.\n *\n * Important: the richer RMM conflict UX is only guaranteed on the single-\n * resource RMM-backed update-like lane where the backend emits authoritative\n * nested `versionConflict` details. Explicit direct fallbacks and true bulk\n * direct lanes remain weaker-guarantee paths even when they are semantically\n * \"update-like\".\n */\n\n/**\n * Controls whether update-like framework surfaces may silently downgrade to a\n * direct `doOperation()` mutation when RMM is unavailable.\n *\n * `RMM_REQUIRED` is the engine-default contract for single-resource update-like\n * surfaces.\n * `DIRECT_OPERATION_FALLBACK` is an explicit weaker-guarantee lane for advanced\n * callers that knowingly accept the semantic downgrade, including the loss of\n * guaranteed authoritative conflict-detail handling.\n */\nexport enum UpdateLikeMutationFallbackMode {\n  RMM_REQUIRED = 'RMM_REQUIRED',\n  DIRECT_OPERATION_FALLBACK = 'DIRECT_OPERATION_FALLBACK',\n}\n\nexport interface MissingRMMRuntimeErrorParams {\n  surfaceName: string;\n  resourceType: string;\n  operationIdentifier?: string;\n}\n\n/**\n * Raised when a default single-resource update-like framework surface is mounted\n * without the RMM runtime it semantically expects.\n */\nexport class MissingRMMRuntimeError extends Error {\n  readonly surfaceName: string;\n  readonly resourceType: string;\n  readonly operationIdentifier?: string;\n\n  constructor(params: MissingRMMRuntimeErrorParams) {\n    const operationSuffix = params.operationIdentifier\n      ? ` for operation \"${params.operationIdentifier}\"`\n      : '';\n    super(\n      `${params.surfaceName} requires RMM for its default update-like mutation path on resource ` +\n      `\"${params.resourceType}\"${operationSuffix}. Mount RMMRegistryProvider or explicitly opt ` +\n      `into UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK to accept weaker guarantees.`,\n    );\n    this.name = 'MissingRMMRuntimeError';\n    this.surfaceName = params.surfaceName;\n    this.resourceType = params.resourceType;\n    this.operationIdentifier = params.operationIdentifier;\n  }\n}\n\nexport function allowsDirectOperationFallback(\n  mode: UpdateLikeMutationFallbackMode | undefined,\n): boolean {\n  return mode === UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK;\n}\n"]}
+{"version":3,"file":"update-like-mutation-fallback.frontend.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/update-like-mutation-fallback.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,8BAGX;AAHD,WAAY,8BAA8B;IACxC,+DAA6B,CAAA;IAC7B,yFAAuD,CAAA;AACzD,CAAC,EAHW,8BAA8B,KAA9B,8BAA8B,QAGzC;AAQD;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,WAAW,CAAS;IACpB,YAAY,CAAS;IACrB,mBAAmB,CAAU;IAEtC,YAAY,MAAoC;QAC9C,MAAM,eAAe,GAAG,MAAM,CAAC,mBAAmB;YAChD,CAAC,CAAC,mBAAmB,MAAM,CAAC,mBAAmB,GAAG;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,CACH,GAAG,MAAM,CAAC,WAAW,sEAAsE;YAC3F,IAAI,MAAM,CAAC,YAAY,IAAI,eAAe,gDAAgD;YAC1F,4FAA4F,CAC7F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC;IACxD,CAAC;CACF;AAED,MAAM,UAAU,6BAA6B,CAC3C,IAAgD;IAEhD,OAAO,IAAI,KAAK,8BAA8B,CAAC,yBAAyB,CAAC;AAC3E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6CAA6C,CAAC,SAE7D;IACC,OAAO,SAAS,CAAC,uBAAuB,EAAE,8BAA8B,IAAI,8BAA8B,CAAC,YAAY,CAAC;AAC1H,CAAC","sourcesContent":["/**\n * Step 6 escape-hatch classification for framework mutation surfaces.\n *\n * Default engine surfaces should behave as if RMM-backed update semantics are a\n * real contract, not a best-effort preference. When a caller knowingly wants a\n * weaker direct `doOperation()` path instead, that downgrade must be explicit.\n *\n * Important: the richer RMM conflict UX is only guaranteed on the single-\n * resource RMM-backed update-like lane where the backend emits authoritative\n * nested `versionConflict` details. Explicit direct fallbacks and true bulk\n * direct lanes remain weaker-guarantee paths even when they are semantically\n * \"update-like\".\n */\n\n/**\n * Controls whether update-like framework surfaces may silently downgrade to a\n * direct `doOperation()` mutation when RMM is unavailable.\n *\n * `RMM_REQUIRED` is the engine-default contract for single-resource update-like\n * surfaces.\n * `DIRECT_OPERATION_FALLBACK` is an explicit weaker-guarantee lane for advanced\n * callers that knowingly accept the semantic downgrade, including the loss of\n * guaranteed authoritative conflict-detail handling.\n */\nexport enum UpdateLikeMutationFallbackMode {\n  RMM_REQUIRED = 'RMM_REQUIRED',\n  DIRECT_OPERATION_FALLBACK = 'DIRECT_OPERATION_FALLBACK',\n}\n\nexport interface MissingRMMRuntimeErrorParams {\n  surfaceName: string;\n  resourceType: string;\n  operationIdentifier?: string;\n}\n\n/**\n * Raised when a default single-resource update-like framework surface is mounted\n * without the RMM runtime it semantically expects.\n */\nexport class MissingRMMRuntimeError extends Error {\n  readonly surfaceName: string;\n  readonly resourceType: string;\n  readonly operationIdentifier?: string;\n\n  constructor(params: MissingRMMRuntimeErrorParams) {\n    const operationSuffix = params.operationIdentifier\n      ? ` for operation \"${params.operationIdentifier}\"`\n      : '';\n    super(\n      `${params.surfaceName} requires RMM for its default update-like mutation path on resource ` +\n      `\"${params.resourceType}\"${operationSuffix}. Mount RMMRegistryProvider or explicitly opt ` +\n      `into UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK to accept weaker guarantees.`,\n    );\n    this.name = 'MissingRMMRuntimeError';\n    this.surfaceName = params.surfaceName;\n    this.resourceType = params.resourceType;\n    this.operationIdentifier = params.operationIdentifier;\n  }\n}\n\nexport function allowsDirectOperationFallback(\n  mode: UpdateLikeMutationFallbackMode | undefined,\n): boolean {\n  return mode === UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK;\n}\n\n/**\n * The lane an operation DECLARED for itself (`operationFrontendConfig.updateLikeMutationFallbackMode`),\n * or `RMM_REQUIRED` when it declared none. Both operation hosts, the form and the form-less one, ask this\n * one function, so an operation cannot submit from one host and be refused by the other.\n */\nexport function resolveDeclaredUpdateLikeMutationFallbackMode(operation: {\n  operationFrontendConfig?: { updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode };\n}): UpdateLikeMutationFallbackMode {\n  return operation.operationFrontendConfig?.updateLikeMutationFallbackMode ?? UpdateLikeMutationFallbackMode.RMM_REQUIRED;\n}\n"]}

package/dist/esm/core/resources/rmm/useResourceRMM.d.ts

@@ -20,6 +20,13 @@ export interface UseResourceRMMConfig {
     /** When false, skip RMM entirely (e.g. non–UPDATE-like form or resource without UPDATE). */
     enabled?: boolean;
     conflictPolicy?: ConflictPolicy;
+    /**
+     * The caller runs directly when no RMM resolves (`UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK`),
+     * so `NO_ELIGIBLE_UPDATE_OPERATION` is an expected absence rather than an integration failure, and is
+     * logged at debug. Without it, a read-only row's declared action logged the "should fail closed" warning
+     * on every mount while working exactly as declared.
+     */
+    directFallbackAccepted?: boolean;
 }
 export interface UseResourceRMMResult {
     rmm: ResourceMutationManager | null;

package/dist/esm/core/resources/rmm/useResourceRMM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceRMM.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAYtH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAiBlF,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,cAAc,EAAE,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAChD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,CAAC,EAAE,OAAO,EAAE,CAAC;IACxC,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,+BAA+B,GAAG,IAAI,CAAC;IAC7D,6BAA6B,EAAE,MAAM,GAAG,SAAS,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,oBAAY,+BAA+B;IACzC;;;OAGG;IACH,gBAAgB,qBAAqB;IACrC;;;;OAIG;IACH,QAAQ,aAAa;IACrB;;;;OAIG;IACH,mBAAmB,wBAAwB;IAC3C;;;;;OAKG;IACH,4BAA4B,iCAAiC;CAC9D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAuPjF"}
+{"version":3,"file":"useResourceRMM.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAYtH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAiBlF,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,cAAc,EAAE,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAChD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,CAAC,EAAE,OAAO,EAAE,CAAC;IACxC,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,+BAA+B,GAAG,IAAI,CAAC;IAC7D,6BAA6B,EAAE,MAAM,GAAG,SAAS,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,oBAAY,+BAA+B;IACzC;;;OAGG;IACH,gBAAgB,qBAAqB;IACrC;;;;OAIG;IACH,QAAQ,aAAa;IACrB;;;;OAIG;IACH,mBAAmB,wBAAwB;IAC3C;;;;;OAKG;IACH,4BAA4B,iCAAiC;CAC9D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAgQjF"}

package/dist/esm/core/resources/rmm/useResourceRMM.js

@@ -65,7 +65,7 @@ export var UseResourceRMMUnavailableReason;
     UseResourceRMMUnavailableReason["NO_ELIGIBLE_UPDATE_OPERATION"] = "NO_ELIGIBLE_UPDATE_OPERATION";
 })(UseResourceRMMUnavailableReason || (UseResourceRMMUnavailableReason = {}));
 export function useResourceRMM(config) {
-    const { resourceType, resourceId, doOperationRef, contextualParameters, parentResourcesRequirements, contextResourceIdentifiers, resourceSchema, enabled = true, conflictPolicy = DEFAULT_CONFLICT_POLICY, } = config;
+    const { resourceType, resourceId, doOperationRef, contextualParameters, parentResourcesRequirements, contextResourceIdentifiers, resourceSchema, enabled = true, conflictPolicy = DEFAULT_CONFLICT_POLICY, directFallbackAccepted = false, } = config;
     const rmmRegistry = useContext(RMMRegistryContext);
     const { registry } = useResourceRegistry();
     const userOrgs = useContext(UserOrgsContext);
@@ -178,6 +178,13 @@ export function useResourceRMM(config) {
             });
             return null;
         }
+        if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION && directFallbackAccepted) {
+            logDebug('RMM unavailable because no eligible UPDATE-like operation resolves; the caller runs directly, as the operation declared.', {
+                resourceType,
+                resourceId: resourceIdStr,
+            });
+            return null;
+        }
         if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION) {
             logger.warn('[useResourceRMM] RMM unavailable because no eligible UPDATE-like operation could be resolved for this surface. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {
                 resourceType,
@@ -206,7 +213,7 @@ export function useResourceRMM(config) {
             resourceSchema,
         });
         // eslint-disable-next-line react-hooks/exhaustive-deps -- registry identity + sync effect for routing/auth
-    }, [rmmOperationPathKey, rmmReadOperationPathKey, rmmRegistry, resourceType, resourceIdStr, rmmUnavailableReason]);
+    }, [directFallbackAccepted, rmmOperationPathKey, rmmReadOperationPathKey, rmmRegistry, resourceType, resourceIdStr, rmmUnavailableReason]);
     useEffect(() => {
         if (!rmm || !rmmOperationPathKey)
             return;

package/dist/esm/core/resources/rmm/useResourceRMM.js.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceRMM.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAErF,OAAO,EACL,qBAAqB,EAErB,kCAAkC,GACnC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AACnG,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,4BAA4B,EAAE,MAAM,uEAAuE,CAAC;AACrH,OAAO,EAAE,6BAA6B,EAAE,MAAM,2EAA2E,CAAC;AAC1H,OAAO,EAAE,qCAAqC,EAAE,MAAM,oFAAoF,CAAC;AAC3I,OAAO,EAAE,+CAA+C,EAAE,MAAM,gFAAgF,CAAC;AACjJ,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,mDAAmD,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAyC,MAAM,SAAS,CAAC;AAClF,OAAO,EAAE,uCAAuC,EAAE,MAAM,iCAAiC,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,CAAC;AACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;AACtD,MAAM,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,uBAAuB,GAAmB,EAAE,QAAQ,EAAE,gBAAgB,CAAC,aAAa,EAAE,CAAC;AAwB7F;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,+BAyBX;AAzBD,WAAY,+BAA+B;IACzC;;;OAGG;IACH,wEAAqC,CAAA;IACrC;;;;OAIG;IACH,wDAAqB,CAAA;IACrB;;;;OAIG;IACH,8EAA2C,CAAA;IAC3C;;;;;OAKG;IACH,gGAA6D,CAAA;AAC/D,CAAC,EAzBW,+BAA+B,KAA/B,+BAA+B,QAyB1C;AAED,MAAM,UAAU,cAAc,CAAC,MAA4B;IACzD,MAAM,EACJ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,cAAc,EACd,OAAO,GAAG,IAAI,EACd,cAAc,GAAG,uBAAuB,GACzC,GAAG,MAAM,CAAC;IAEX,MAAM,WAAW,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACnD,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,QAAQ,EAAE,wBAAwB,EAAE,MAAM,IAAI,IAAI,CAAC;IACxE,8EAA8E;IAC9E,+EAA+E;IAC/E,4CAA4C;IAC5C,MAAM,yBAAyB,GAAG,MAAM,CAAS,EAAE,CAAC,CAAC;IACrD,IAAI,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,YAAY,EAAE,CAAC;QACxC,yBAAyB,CAAC,OAAO,GAAG,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,YAAa,CAAC;IAC3E,CAAC;IACD,MAAM,aAAa,GAAG,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,YAAY,IAAI,yBAAyB,CAAC,OAAO,CAAC;IAC/F,MAAM,cAAc,GAAG,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAErE,MAAM,6BAA6B,GAAG,OAAO,CAC3C,GAAG,EAAE,CAAC,qBAAqB,CAAC,kCAAkC,CAAC,0BAA0B,CAAC,EAC1F,CAAC,0BAA0B,CAAC,CAC7B,CAAC;IACF,mEAAmE;IACnE,6EAA6E;IAC7E,mFAAmF;IACnF,oEAAoE;IACpE,+EAA+E;IAC/E,+EAA+E;IAC/E,6DAA6D;IAC7D,MAAM,8BAA8B,GAAG,OAAO,CAC5C,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,2BAA2B,IAAI,IAAI,CAAC,EACzD,CAAC,2BAA2B,CAAC,CAC9B,CAAC;IACF,MAAM,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE3D,MAAM,gBAAgB,GAAG,OAAO,CAC9B,GAAG,EAAE,CAAC,IAAI,oBAAoB,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,OAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7E,yFAAyF;IACzF,EAAE,CACH,CAAC;IAEF,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,EAAE;QACnC,OAAO,6BAA6B,CAAC;YACnC,cAAc;YACd,UAAU,EAAE,cAAc,EAAE,UAAU,IAAI,EAAE;YAC5C,QAAQ;YACR,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC;YACrC,0BAA0B;YAC1B,oBAAoB;SACrB,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,6BAA6B,EAAE,oBAAoB,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;IAEnG,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,EAAE;QACvC,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,kCAAkC,CAAC,mCAAmC,CAAC,eAAe,CAAC,CAAC;IACjG,CAAC,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;IAEpC,MAAM,uBAAuB,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3C,OAAO,uCAAuC,CAAC,YAAY,EAAE,QAAQ,EAAE;YACrE,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC;YACrC,0BAA0B;YAC1B,oBAAoB;SACrB,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,6BAA6B,EAAE,oBAAoB,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;IAE7H,MAAM,cAAc,GAAG,OAAO,CAC5B,GAAG,EAAE;QACH,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,GAAG,sBAAsB,EAAE,GAAG,0BAA0B,IAAI,EAAE,CAAC;QAC9F,MAAM,0BAA0B,GAAG,qBAAqB,CAAC,yBAAyB,CAChF,sBAAsB,EACtB,QAAQ,CACT,CAAC;QACF,OAAO,4BAA4B,CACjC,cAAc,EAAE,UAAU,IAAI,EAAE,EAChC,qBAAqB,CAAC,IAAI,CAC3B,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,EAAE,CACzB,qCAAqC,CAAC;YACpC,SAAS,EAAE,aAAa;YACxB,0BAA0B,EAAE,sBAAsB;YAClD,oBAAoB,EAAE,0BAA0B;SACjD,CAAC,CACH,CAAC;IACJ,CAAC,EACD,CAAC,6BAA6B,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,CAAC,CACpF,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAA2C,EAAE;QAChF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,+BAA+B,CAAC,QAAQ,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,+BAA+B,CAAC,mBAAmB,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,+BAA+B,CAAC,4BAA4B,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,+BAA+B,CAAC,gBAAgB,CAAC;QAC1D,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC;IAE3D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;QACvB,IAAI,oBAAoB,KAAK,+BAA+B,CAAC,QAAQ,EAAE,CAAC;YACtE,QAAQ,CAAC,kEAAkE,EAAE;gBAC3E,YAAY;gBACZ,UAAU,EAAE,aAAa;aAC1B,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,oBAAoB,KAAK,+BAA+B,CAAC,mBAAmB,EAAE,CAAC;YACjF,QAAQ,CAAC,4EAA4E,EAAE;gBACrF,YAAY;aACb,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,oBAAoB,KAAK,+BAA+B,CAAC,4BAA4B,EAAE,CAAC;YAC1F,MAAM,CAAC,IAAI,CAAC,oOAAoO,EAAE;gBAChP,YAAY;gBACZ,UAAU,EAAE,aAAa;aAC1B,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,oBAAoB,KAAK,+BAA+B,CAAC,gBAAgB,EAAE,CAAC;YAC9E,MAAM,CAAC,IAAI,CAAC,kMAAkM,EAAE;gBAC9M,YAAY;gBACZ,UAAU,EAAE,aAAa;aAC1B,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,WAAW,CAAC,WAAW,CAAC,YAAY,EAAE,aAAa,EAAE;YAC1D,YAAY;YACZ,UAAU,EAAE,aAAa;YACzB,gBAAgB;YAChB,gBAAgB,EAAE,mBAAoB;YACtC,oBAAoB,EAAE,uBAAuB;YAC7C,cAAc;YACd,aAAa;YACb,0BAA0B,EAAE,+CAA+C,CAAC,0BAA0B,CAAC;YACvG,oBAAoB;YACpB,2BAA2B;YAC3B,cAAc;SACf,CAAC,CAAC;QACH,2GAA2G;IAC7G,CAAC,EAAE,CAAC,mBAAmB,EAAE,uBAAuB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAEnH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,GAAG,IAAI,CAAC,mBAAmB;YAAE,OAAO;QACzC,GAAG,CAAC,wBAAwB,CAAC;YAC3B,gBAAgB;YAChB,aAAa;YACb,0BAA0B,EAAE,+CAA+C,CAAC,0BAA0B,CAAC;YACvG,oBAAoB;YACpB,2BAA2B;YAC3B,gBAAgB,EAAE,mBAAmB;YACrC,oBAAoB,EAAE,uBAAuB;YAC7C,cAAc;YACd,cAAc;SACf,CAAC,CAAC;QACH,WAAW,EAAE,4BAA4B,EAAE,CAAC;IAC9C,CAAC,EAAE;QACD,GAAG;QACH,WAAW;QACX,aAAa;QACb,4EAA4E;QAC5E,6EAA6E;QAC7E,6DAA6D;QAC7D,cAAc,CAAC,QAAQ;QACvB,6BAA6B;QAC7B,mBAAmB;QACnB,uBAAuB;QACvB,8BAA8B;QAC9B,oBAAoB;QACpB,cAAc;QACd,gBAAgB;KACjB,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QAC5D,OAAO,GAAG,EAAE;YACV,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;IAEpD,MAAM,WAAW,GAAG,oBAAoB,CACtC,GAAG,EAAE,SAAS,IAAI,cAAc,EAChC,GAAG,EAAE,WAAW,IAAI,iBAAiB,CACtC,CAAC;IAEF,mBAAmB,CAAC,GAAG,EAAE;QACvB,0BAA0B,EAAE,+CAA+C,CAAC,0BAA0B,CAAC;QACvG,2BAA2B,EAAE,2BAA2B,IAAI,EAAE;QAC9D,cAAc;KACf,CAAC,CAAC;IAEH,OAAO;QACL,GAAG;QACH,WAAW;QACX,WAAW,EAAE,WAAW,IAAI,IAAI;QAChC,oBAAoB;QACpB,6BAA6B,EAAE,uBAAuB;KACvD,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Shared RMM lifecycle: registry lookup, transport adapter, getOrCreate, routing sync,\n * cleanup on unmount, snapshot subscription, and list invalidation.\n */\n\nimport { useContext, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';\nimport type { RefObject } from 'react';\nimport {\n  CoreResourceOperation,\n  ResourceOperationVariantType,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\nimport type { DoOperationFn } from './HttpTransportAdapter';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getOperationsForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { pickInlineFieldWriteOperation } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport { operationInitiatorParametersSatisfied } from '~wildo-frontend-lib/core/resources/operation-initiator-satisfaction.frontend.utils';\nimport { normalizeContextResourceIdentifiersForTransport } from '~wildo-frontend-lib/core/resources/context-resource-identifiers.frontend.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { UserOrgsContext } from '~wildo-frontend-lib/core/security/UserOrgsContext';\nimport { HttpTransportAdapter } from './HttpTransportAdapter';\nimport { NOOP_GET_SNAPSHOT, NOOP_SUBSCRIBE } from './rmm-noop-snapshot';\nimport { RMMRegistryContext } from './RMMRegistryContext';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { RMMRegistry } from './RMMRegistry';\nimport { ConflictStrategy, type ConflictPolicy, type RMMSnapshot } from './types';\nimport { resolveCanonicalRMMReadOperationPathKey } from './canonical-read.frontend.utils';\nimport { useListInvalidation } from './useListInvalidation';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('useResourceRMM');\nlogger.setDebugTypeLogging('useResourceRMM', false);\n\n/**\n * Stable default conflict policy. As an inline default-parameter object literal it\n * would mint a fresh identity on every render; `conflictPolicy` is a dependency of\n * the routing-sync effect below, so a fresh identity re-fires that effect (and its\n * `rmmRegistry.notifyInstanceRuntimeChanged()`) on every commit even when nothing\n * changed. A module constant keeps the default referentially stable.\n */\nconst DEFAULT_CONFLICT_POLICY: ConflictPolicy = { strategy: ConflictStrategy.ACCEPT_REMOTE };\n\nexport interface UseResourceRMMConfig {\n  resourceType: string;\n  /** When falsy, RMM is not attached (e.g. CREATE flow or missing id). */\n  resourceId: string | null | undefined;\n  doOperationRef: RefObject<DoOperationFn | null>;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  resourceSchema?: unknown;\n  /** When false, skip RMM entirely (e.g. non–UPDATE-like form or resource without UPDATE). */\n  enabled?: boolean;\n  conflictPolicy?: ConflictPolicy;\n}\n\nexport interface UseResourceRMMResult {\n  rmm: ResourceMutationManager | null;\n  rmmSnapshot: RMMSnapshot;\n  rmmRegistry: RMMRegistry | null;\n  rmmUnavailableReason: UseResourceRMMUnavailableReason | null;\n  canonicalReadOperationPathKey: string | undefined;\n}\n\n/**\n * Why RMM is unattached for the current surface. Every reason fails closed\n * (`rmm === null`); the reason only drives diagnostics. Two of the reasons\n * are *expected absences* logged at debug, two are *genuine integration\n * failures* logged at warn — see the classification memo in\n * `useResourceRMM` for the precedence rules that keep expected absences out\n * of the loud lane.\n */\nexport enum UseResourceRMMUnavailableReason {\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id resolved an operation but no `RMMRegistryProvider` is mounted above it.\n   */\n  PROVIDER_MISSING = 'PROVIDER_MISSING',\n  /**\n   * Expected absence (debug): the caller explicitly opted out of RMM\n   * attachment (e.g. `enabled: isUpdateLikeOperation && !!resourceId` on a\n   * CREATE form).\n   */\n  DISABLED = 'DISABLED',\n  /**\n   * Expected absence (debug): no persisted resource id is attached yet\n   * (CREATE flow, parent-context singleton awaiting READ bootstrap). RMM is\n   * keyed by resource id and can never attach without one.\n   */\n  MISSING_RESOURCE_ID = 'MISSING_RESOURCE_ID',\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id could not resolve any eligible UPDATE-like operation. Default\n   * update-like surfaces fail closed on this unless they explicitly opt\n   * into a weaker direct-operation fallback.\n   */\n  NO_ELIGIBLE_UPDATE_OPERATION = 'NO_ELIGIBLE_UPDATE_OPERATION',\n}\n\nexport function useResourceRMM(config: UseResourceRMMConfig): UseResourceRMMResult {\n  const {\n    resourceType,\n    resourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements,\n    contextResourceIdentifiers,\n    resourceSchema,\n    enabled = true,\n    conflictPolicy = DEFAULT_CONFLICT_POLICY,\n  } = config;\n\n  const rmmRegistry = useContext(RMMRegistryContext);\n  const { registry } = useResourceRegistry();\n  const userOrgs = useContext(UserOrgsContext);\n  const scopedUserId = userOrgs?.primaryScopeInitiatorIds?.userId ?? null;\n  // Preserve the last known authenticated user id across transient auth-context\n  // dropouts so same-user websocket replay does not immediately degrade into the\n  // foreign-remote lane during runtime churn.\n  const lastKnownCurrentUserIdRef = useRef<string>('');\n  if (userOrgs?.user?._id || scopedUserId) {\n    lastKnownCurrentUserIdRef.current = userOrgs?.user?._id ?? scopedUserId!;\n  }\n  const currentUserId = userOrgs?.user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;\n  const resourceConfig = registry.resourceConfigurations[resourceType];\n\n  const contextResourceIdentifiersKey = useMemo(\n    () => FrontendResourceUtils.buildContextResourceIdentifiersKey(contextResourceIdentifiers),\n    [contextResourceIdentifiers],\n  );\n  // Content-stable key for the routing-sync effect dependency below.\n  // `parentResourcesRequirements` arrives as a freshly-allocated array on most\n  // renders (callers build it inline, e.g. `buildParentResourcesRequirements(...)`),\n  // so depending on its *identity* re-fires the sync effect — and its\n  // `rmmRegistry.notifyInstanceRuntimeChanged()` — on every commit even when the\n  // requirements are unchanged, which storms the WebSocket room re-subscription.\n  // Keying by content mirrors `contextResourceIdentifiersKey`.\n  const parentResourcesRequirementsKey = useMemo(\n    () => JSON.stringify(parentResourcesRequirements ?? null),\n    [parentResourcesRequirements],\n  );\n  const resourceIdStr = resourceId ? String(resourceId) : '';\n\n  const transportAdapter = useMemo(\n    () => new HttpTransportAdapter((...args) => doOperationRef.current!(...args)),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- doOperationRef is a stable ref\n    [],\n  );\n\n  const updateOperation = useMemo(() => {\n    return pickInlineFieldWriteOperation({\n      resourceConfig,\n      operations: resourceConfig?.operations ?? [],\n      registry,\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig, resourceIdStr]);\n\n  const rmmOperationPathKey = useMemo(() => {\n    if (!updateOperation) {\n      return null;\n    }\n\n    return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);\n  }, [resourceType, updateOperation]);\n\n  const rmmReadOperationPathKey = useMemo(() => {\n    return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig?.operations, resourceIdStr, resourceType]);\n\n  const listOperations = useMemo(\n    () => {\n      const { [resourceType]: _self, ...parentScopeIdentifiers } = contextResourceIdentifiers ?? {};\n      const parentContextualParameters = FrontendResourceUtils.buildContextualParameters(\n        parentScopeIdentifiers,\n        registry,\n      );\n      return getOperationsForCoreSemantic(\n        resourceConfig?.operations ?? [],\n        CoreResourceOperation.LIST,\n      ).filter((listOperation) =>\n        operationInitiatorParametersSatisfied({\n          operation: listOperation,\n          contextResourceIdentifiers: parentScopeIdentifiers,\n          contextualParameters: parentContextualParameters,\n        })\n      );\n    },\n    [contextResourceIdentifiersKey, registry, resourceConfig?.operations, resourceType],\n  );\n\n  /**\n   * Classify why RMM is unattached, expected-absence checks first. The\n   * precedence matters because the reason drives log level downstream:\n   * `DISABLED` / `MISSING_RESOURCE_ID` are expected absences (debug),\n   * `NO_ELIGIBLE_UPDATE_OPERATION` / `PROVIDER_MISSING` are genuine\n   * integration failures (warn).\n   *\n   * - `!enabled` always classifies as DISABLED, even when no update\n   *   operation resolves: the caller explicitly opted out (the form /\n   *   displayer / layout callers gate `enabled` on `<update-like> && <has\n   *   id>`; the execution participation bridge gates it on execution-level\n   *   availability), so a CREATE surface must not be reported as an\n   *   operation-eligibility failure.\n   * - The missing-id check runs before operation eligibility: without an id\n   *   RMM can never attach (the registry is keyed by resource id), and\n   *   UPDATE addressability is resolved with `hasResourceId: false`, so an\n   *   unresolved operation on an id-less surface is the expected CREATE /\n   *   pre-bootstrap shape rather than a broken update-like surface.\n   *\n   * Rejected alternative: keeping the old loud-first order and only\n   * downgrading the log level — that would still misreport create-like\n   * surfaces as `NO_ELIGIBLE_UPDATE_OPERATION` to consumers of\n   * `rmmUnavailableReason`. All reasons keep failing closed (rmm === null);\n   * only classification and log level differ.\n   */\n  const rmmUnavailableReason = useMemo((): UseResourceRMMUnavailableReason | null => {\n    if (!enabled) {\n      return UseResourceRMMUnavailableReason.DISABLED;\n    }\n    if (!resourceIdStr) {\n      return UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID;\n    }\n    if (!updateOperation) {\n      return UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION;\n    }\n    if (!rmmRegistry) {\n      return UseResourceRMMUnavailableReason.PROVIDER_MISSING;\n    }\n\n    return null;\n  }, [enabled, resourceIdStr, rmmRegistry, updateOperation]);\n\n  const rmm = useMemo(() => {\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.DISABLED) {\n      logDebug('RMM unavailable because attachment is disabled for this surface.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID) {\n      logDebug('RMM unavailable because no resource id is attached to the current surface.', {\n        resourceType,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION) {\n      logger.warn('[useResourceRMM] RMM unavailable because no eligible UPDATE-like operation could be resolved for this surface. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.PROVIDER_MISSING) {\n      logger.warn('[useResourceRMM] RMM unavailable because RMMRegistryProvider is not mounted. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n    return rmmRegistry.getOrCreate(resourceType, resourceIdStr, {\n      resourceType,\n      resourceId: resourceIdStr,\n      transportAdapter,\n      operationPathKey: rmmOperationPathKey!,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      resourceSchema,\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- registry identity + sync effect for routing/auth\n  }, [rmmOperationPathKey, rmmReadOperationPathKey, rmmRegistry, resourceType, resourceIdStr, rmmUnavailableReason]);\n\n  useEffect(() => {\n    if (!rmm || !rmmOperationPathKey) return;\n    rmm.syncRuntimeRoutingConfig({\n      transportAdapter,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      operationPathKey: rmmOperationPathKey,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      resourceSchema,\n    });\n    rmmRegistry?.notifyInstanceRuntimeChanged();\n  }, [\n    rmm,\n    rmmRegistry,\n    currentUserId,\n    // `ConflictPolicy` is `{ strategy }`; depend on the strategy value, not the\n    // (commonly inline, fresh-identity) object literal callers pass, so the sync\n    // effect does not re-fire — and re-notify — on every commit.\n    conflictPolicy.strategy,\n    contextResourceIdentifiersKey,\n    rmmOperationPathKey,\n    rmmReadOperationPathKey,\n    parentResourcesRequirementsKey,\n    contextualParameters,\n    resourceSchema,\n    transportAdapter,\n  ]);\n\n  useEffect(() => {\n    if (!rmm || !rmmRegistry || !resourceIdStr) {\n      return;\n    }\n\n    const key = rmmRegistry.keyFor(resourceType, resourceIdStr);\n    return () => {\n      rmmRegistry.release(key);\n    };\n  }, [rmm, rmmRegistry, resourceType, resourceIdStr]);\n\n  const rmmSnapshot = useSyncExternalStore(\n    rmm?.subscribe ?? NOOP_SUBSCRIBE,\n    rmm?.getSnapshot ?? NOOP_GET_SNAPSHOT,\n  );\n\n  useListInvalidation(rmm, {\n    contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n    parentResourcesRequirements: parentResourcesRequirements ?? [],\n    listOperations,\n  });\n\n  return {\n    rmm,\n    rmmSnapshot,\n    rmmRegistry: rmmRegistry ?? null,\n    rmmUnavailableReason,\n    canonicalReadOperationPathKey: rmmReadOperationPathKey,\n  };\n}\n"]}
+{"version":3,"file":"useResourceRMM.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared RMM lifecycle: registry lookup, transport adapter, getOrCreate, routing sync,\n * cleanup on unmount, snapshot subscription, and list invalidation.\n */\n\nimport { useContext, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';\nimport type { RefObject } from 'react';\nimport {\n  CoreResourceOperation,\n  ResourceOperationVariantType,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\nimport type { DoOperationFn } from './HttpTransportAdapter';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getOperationsForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { pickInlineFieldWriteOperation } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport { operationInitiatorParametersSatisfied } from '~wildo-frontend-lib/core/resources/operation-initiator-satisfaction.frontend.utils';\nimport { normalizeContextResourceIdentifiersForTransport } from '~wildo-frontend-lib/core/resources/context-resource-identifiers.frontend.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { UserOrgsContext } from '~wildo-frontend-lib/core/security/UserOrgsContext';\nimport { HttpTransportAdapter } from './HttpTransportAdapter';\nimport { NOOP_GET_SNAPSHOT, NOOP_SUBSCRIBE } from './rmm-noop-snapshot';\nimport { RMMRegistryContext } from './RMMRegistryContext';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { RMMRegistry } from './RMMRegistry';\nimport { ConflictStrategy, type ConflictPolicy, type RMMSnapshot } from './types';\nimport { resolveCanonicalRMMReadOperationPathKey } from './canonical-read.frontend.utils';\nimport { useListInvalidation } from './useListInvalidation';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('useResourceRMM');\nlogger.setDebugTypeLogging('useResourceRMM', false);\n\n/**\n * Stable default conflict policy. As an inline default-parameter object literal it\n * would mint a fresh identity on every render; `conflictPolicy` is a dependency of\n * the routing-sync effect below, so a fresh identity re-fires that effect (and its\n * `rmmRegistry.notifyInstanceRuntimeChanged()`) on every commit even when nothing\n * changed. A module constant keeps the default referentially stable.\n */\nconst DEFAULT_CONFLICT_POLICY: ConflictPolicy = { strategy: ConflictStrategy.ACCEPT_REMOTE };\n\nexport interface UseResourceRMMConfig {\n  resourceType: string;\n  /** When falsy, RMM is not attached (e.g. CREATE flow or missing id). */\n  resourceId: string | null | undefined;\n  doOperationRef: RefObject<DoOperationFn | null>;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  resourceSchema?: unknown;\n  /** When false, skip RMM entirely (e.g. non–UPDATE-like form or resource without UPDATE). */\n  enabled?: boolean;\n  conflictPolicy?: ConflictPolicy;\n  /**\n   * The caller runs directly when no RMM resolves (`UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK`),\n   * so `NO_ELIGIBLE_UPDATE_OPERATION` is an expected absence rather than an integration failure, and is\n   * logged at debug. Without it, a read-only row's declared action logged the \"should fail closed\" warning\n   * on every mount while working exactly as declared.\n   */\n  directFallbackAccepted?: boolean;\n}\n\nexport interface UseResourceRMMResult {\n  rmm: ResourceMutationManager | null;\n  rmmSnapshot: RMMSnapshot;\n  rmmRegistry: RMMRegistry | null;\n  rmmUnavailableReason: UseResourceRMMUnavailableReason | null;\n  canonicalReadOperationPathKey: string | undefined;\n}\n\n/**\n * Why RMM is unattached for the current surface. Every reason fails closed\n * (`rmm === null`); the reason only drives diagnostics. Two of the reasons\n * are *expected absences* logged at debug, two are *genuine integration\n * failures* logged at warn — see the classification memo in\n * `useResourceRMM` for the precedence rules that keep expected absences out\n * of the loud lane.\n */\nexport enum UseResourceRMMUnavailableReason {\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id resolved an operation but no `RMMRegistryProvider` is mounted above it.\n   */\n  PROVIDER_MISSING = 'PROVIDER_MISSING',\n  /**\n   * Expected absence (debug): the caller explicitly opted out of RMM\n   * attachment (e.g. `enabled: isUpdateLikeOperation && !!resourceId` on a\n   * CREATE form).\n   */\n  DISABLED = 'DISABLED',\n  /**\n   * Expected absence (debug): no persisted resource id is attached yet\n   * (CREATE flow, parent-context singleton awaiting READ bootstrap). RMM is\n   * keyed by resource id and can never attach without one.\n   */\n  MISSING_RESOURCE_ID = 'MISSING_RESOURCE_ID',\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id could not resolve any eligible UPDATE-like operation. Default\n   * update-like surfaces fail closed on this unless they explicitly opt\n   * into a weaker direct-operation fallback.\n   */\n  NO_ELIGIBLE_UPDATE_OPERATION = 'NO_ELIGIBLE_UPDATE_OPERATION',\n}\n\nexport function useResourceRMM(config: UseResourceRMMConfig): UseResourceRMMResult {\n  const {\n    resourceType,\n    resourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements,\n    contextResourceIdentifiers,\n    resourceSchema,\n    enabled = true,\n    conflictPolicy = DEFAULT_CONFLICT_POLICY,\n    directFallbackAccepted = false,\n  } = config;\n\n  const rmmRegistry = useContext(RMMRegistryContext);\n  const { registry } = useResourceRegistry();\n  const userOrgs = useContext(UserOrgsContext);\n  const scopedUserId = userOrgs?.primaryScopeInitiatorIds?.userId ?? null;\n  // Preserve the last known authenticated user id across transient auth-context\n  // dropouts so same-user websocket replay does not immediately degrade into the\n  // foreign-remote lane during runtime churn.\n  const lastKnownCurrentUserIdRef = useRef<string>('');\n  if (userOrgs?.user?._id || scopedUserId) {\n    lastKnownCurrentUserIdRef.current = userOrgs?.user?._id ?? scopedUserId!;\n  }\n  const currentUserId = userOrgs?.user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;\n  const resourceConfig = registry.resourceConfigurations[resourceType];\n\n  const contextResourceIdentifiersKey = useMemo(\n    () => FrontendResourceUtils.buildContextResourceIdentifiersKey(contextResourceIdentifiers),\n    [contextResourceIdentifiers],\n  );\n  // Content-stable key for the routing-sync effect dependency below.\n  // `parentResourcesRequirements` arrives as a freshly-allocated array on most\n  // renders (callers build it inline, e.g. `buildParentResourcesRequirements(...)`),\n  // so depending on its *identity* re-fires the sync effect — and its\n  // `rmmRegistry.notifyInstanceRuntimeChanged()` — on every commit even when the\n  // requirements are unchanged, which storms the WebSocket room re-subscription.\n  // Keying by content mirrors `contextResourceIdentifiersKey`.\n  const parentResourcesRequirementsKey = useMemo(\n    () => JSON.stringify(parentResourcesRequirements ?? null),\n    [parentResourcesRequirements],\n  );\n  const resourceIdStr = resourceId ? String(resourceId) : '';\n\n  const transportAdapter = useMemo(\n    () => new HttpTransportAdapter((...args) => doOperationRef.current!(...args)),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- doOperationRef is a stable ref\n    [],\n  );\n\n  const updateOperation = useMemo(() => {\n    return pickInlineFieldWriteOperation({\n      resourceConfig,\n      operations: resourceConfig?.operations ?? [],\n      registry,\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig, resourceIdStr]);\n\n  const rmmOperationPathKey = useMemo(() => {\n    if (!updateOperation) {\n      return null;\n    }\n\n    return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);\n  }, [resourceType, updateOperation]);\n\n  const rmmReadOperationPathKey = useMemo(() => {\n    return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig?.operations, resourceIdStr, resourceType]);\n\n  const listOperations = useMemo(\n    () => {\n      const { [resourceType]: _self, ...parentScopeIdentifiers } = contextResourceIdentifiers ?? {};\n      const parentContextualParameters = FrontendResourceUtils.buildContextualParameters(\n        parentScopeIdentifiers,\n        registry,\n      );\n      return getOperationsForCoreSemantic(\n        resourceConfig?.operations ?? [],\n        CoreResourceOperation.LIST,\n      ).filter((listOperation) =>\n        operationInitiatorParametersSatisfied({\n          operation: listOperation,\n          contextResourceIdentifiers: parentScopeIdentifiers,\n          contextualParameters: parentContextualParameters,\n        })\n      );\n    },\n    [contextResourceIdentifiersKey, registry, resourceConfig?.operations, resourceType],\n  );\n\n  /**\n   * Classify why RMM is unattached, expected-absence checks first. The\n   * precedence matters because the reason drives log level downstream:\n   * `DISABLED` / `MISSING_RESOURCE_ID` are expected absences (debug),\n   * `NO_ELIGIBLE_UPDATE_OPERATION` / `PROVIDER_MISSING` are genuine\n   * integration failures (warn).\n   *\n   * - `!enabled` always classifies as DISABLED, even when no update\n   *   operation resolves: the caller explicitly opted out (the form /\n   *   displayer / layout callers gate `enabled` on `<update-like> && <has\n   *   id>`; the execution participation bridge gates it on execution-level\n   *   availability), so a CREATE surface must not be reported as an\n   *   operation-eligibility failure.\n   * - The missing-id check runs before operation eligibility: without an id\n   *   RMM can never attach (the registry is keyed by resource id), and\n   *   UPDATE addressability is resolved with `hasResourceId: false`, so an\n   *   unresolved operation on an id-less surface is the expected CREATE /\n   *   pre-bootstrap shape rather than a broken update-like surface.\n   *\n   * Rejected alternative: keeping the old loud-first order and only\n   * downgrading the log level — that would still misreport create-like\n   * surfaces as `NO_ELIGIBLE_UPDATE_OPERATION` to consumers of\n   * `rmmUnavailableReason`. All reasons keep failing closed (rmm === null);\n   * only classification and log level differ.\n   */\n  const rmmUnavailableReason = useMemo((): UseResourceRMMUnavailableReason | null => {\n    if (!enabled) {\n      return UseResourceRMMUnavailableReason.DISABLED;\n    }\n    if (!resourceIdStr) {\n      return UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID;\n    }\n    if (!updateOperation) {\n      return UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION;\n    }\n    if (!rmmRegistry) {\n      return UseResourceRMMUnavailableReason.PROVIDER_MISSING;\n    }\n\n    return null;\n  }, [enabled, resourceIdStr, rmmRegistry, updateOperation]);\n\n  const rmm = useMemo(() => {\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.DISABLED) {\n      logDebug('RMM unavailable because attachment is disabled for this surface.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID) {\n      logDebug('RMM unavailable because no resource id is attached to the current surface.', {\n        resourceType,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION && directFallbackAccepted) {\n      logDebug('RMM unavailable because no eligible UPDATE-like operation resolves; the caller runs directly, as the operation declared.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION) {\n      logger.warn('[useResourceRMM] RMM unavailable because no eligible UPDATE-like operation could be resolved for this surface. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.PROVIDER_MISSING) {\n      logger.warn('[useResourceRMM] RMM unavailable because RMMRegistryProvider is not mounted. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n    return rmmRegistry.getOrCreate(resourceType, resourceIdStr, {\n      resourceType,\n      resourceId: resourceIdStr,\n      transportAdapter,\n      operationPathKey: rmmOperationPathKey!,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      resourceSchema,\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- registry identity + sync effect for routing/auth\n  }, [directFallbackAccepted, rmmOperationPathKey, rmmReadOperationPathKey, rmmRegistry, resourceType, resourceIdStr, rmmUnavailableReason]);\n\n  useEffect(() => {\n    if (!rmm || !rmmOperationPathKey) return;\n    rmm.syncRuntimeRoutingConfig({\n      transportAdapter,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      operationPathKey: rmmOperationPathKey,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      resourceSchema,\n    });\n    rmmRegistry?.notifyInstanceRuntimeChanged();\n  }, [\n    rmm,\n    rmmRegistry,\n    currentUserId,\n    // `ConflictPolicy` is `{ strategy }`; depend on the strategy value, not the\n    // (commonly inline, fresh-identity) object literal callers pass, so the sync\n    // effect does not re-fire — and re-notify — on every commit.\n    conflictPolicy.strategy,\n    contextResourceIdentifiersKey,\n    rmmOperationPathKey,\n    rmmReadOperationPathKey,\n    parentResourcesRequirementsKey,\n    contextualParameters,\n    resourceSchema,\n    transportAdapter,\n  ]);\n\n  useEffect(() => {\n    if (!rmm || !rmmRegistry || !resourceIdStr) {\n      return;\n    }\n\n    const key = rmmRegistry.keyFor(resourceType, resourceIdStr);\n    return () => {\n      rmmRegistry.release(key);\n    };\n  }, [rmm, rmmRegistry, resourceType, resourceIdStr]);\n\n  const rmmSnapshot = useSyncExternalStore(\n    rmm?.subscribe ?? NOOP_SUBSCRIBE,\n    rmm?.getSnapshot ?? NOOP_GET_SNAPSHOT,\n  );\n\n  useListInvalidation(rmm, {\n    contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n    parentResourcesRequirements: parentResourcesRequirements ?? [],\n    listOperations,\n  });\n\n  return {\n    rmm,\n    rmmSnapshot,\n    rmmRegistry: rmmRegistry ?? null,\n    rmmUnavailableReason,\n    canonicalReadOperationPathKey: rmmReadOperationPathKey,\n  };\n}\n"]}

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

@@ -0,0 +1,59 @@
+export interface UseOperationDirectExecutionParams {
+    /** Replaces what happens AFTER a success. The outcome is announced either way. Omitted: go back within the zone. */
+    onSuccess?: (result: unknown) => void;
+    /** The message a failure is reported under. */
+    errorMessage: string;
+    /** The component a failure is attributed to in the report. */
+    errorComponent: string;
+}
+export interface OperationDirectExecution {
+    /**
+     * Execute the hosted operation with this exact request body — no form, no validation pass beyond
+     * the server's. Resolves once the outcome has been announced (success) or reported (failure).
+     * Omitted means "no body at all", which is what a zero-input action sends — not an empty object.
+     */
+    execute: (requestData?: Record<string, unknown>) => Promise<void>;
+    /** True while a request is in flight. */
+    isExecuting: boolean;
+    /**
+     * True while an update-like operation with no target id in its context is resolving that id from
+     * the canonical READ. Execution must wait for it: the RMM that carries the mutation is keyed on it.
+     */
+    isBootstrapping: boolean;
+    /**
+     * The success path itself — announce the outcome, then `onSuccess` or go back. Exposed so a host
+     * that ALSO renders a form hands the form this very function, and "what success means" has one
+     * definition across the form and the form-less paths.
+     */
+    completeWithSuccess: (result: unknown) => void;
+    /** The failure path — reports under `errorMessage` / `errorComponent`. Same reason as above. */
+    reportFailure: (error: Error) => void;
+}
+/**
+ * Execute the NEAREST operation view's operation with a body the caller already has — the form-less
+ * half of every operation host.
+ *
+ * ## Why this is its own hook
+ *
+ * It began as the zero-input branch of `ResourceLayout_SemanticOperationFallback` ("Run" with an
+ * empty body), and a DROPDOWN action needs exactly the same thing with a one-field body: the pick is
+ * the submission. The alternative — a second copy of the RMM-or-direct decision, the canonical-READ
+ * bootstrap and the outcome announcement inside the dropdown — is the shape this package has already
+ * paid for once (the bulk selector, spelled two ways). One hook, so a host that executes without a
+ * form inherits the whole contract by using it:
+ *
+ * - **update-like single-resource operations run through the RMM**, never the plain `doOperation`
+ *   lane, and fail closed with `MissingRMMRuntimeError` rather than writing without it;
+ * - **a missing target id is resolved first** from the canonical READ, so a detail-less context (a
+ *   bulk bar, a singleton) still mutates the right row;
+ * - **everything else runs `executeCurrentOperation`**, which merges a bulk selection into the body;
+ * - **the outcome is ALWAYS announced**, and `onSuccess` replaces only what happens next.
+ *
+ * Confirmation is NOT decided here. Each host owns the dialog it shows, because only the host knows
+ * whether a person has already acted deliberately (typed a phrase, pressed Submit) or merely picked.
+ *
+ * Must be called under a `ResourceOperationViewProvider` for the operation being executed — a
+ * detached host establishes one (`ResourceOperationDetachedHost`, `ResourceOperationActionDropdown`).
+ */
+export declare function useOperationDirectExecution({ onSuccess, errorMessage, errorComponent, }: UseOperationDirectExecutionParams): OperationDirectExecution;
+//# sourceMappingURL=useOperationDirectExecution.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,278 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { ResourcesConfig_OperationPathUtils } from '@wildo-ai/saas-models';
+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 { 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';
+import { performCanonicalRMMRead, resolveCanonicalRMMReadOperationPathKey, } from '../../core/resources/rmm/canonical-read.frontend.utils.js';
+import { isSingleResourceUpdateLikeOperation } from '../../core/resources/operation-semantics.frontend.utils.js';
+import { useResourceOperationOutcomeEmitter } from '../../core/resources/useResourceOperationOutcomeEmitter.js';
+/**
+ * Execute the NEAREST operation view's operation with a body the caller already has — the form-less
+ * half of every operation host.
+ *
+ * ## Why this is its own hook
+ *
+ * It began as the zero-input branch of `ResourceLayout_SemanticOperationFallback` ("Run" with an
+ * empty body), and a DROPDOWN action needs exactly the same thing with a one-field body: the pick is
+ * the submission. The alternative — a second copy of the RMM-or-direct decision, the canonical-READ
+ * bootstrap and the outcome announcement inside the dropdown — is the shape this package has already
+ * paid for once (the bulk selector, spelled two ways). One hook, so a host that executes without a
+ * form inherits the whole contract by using it:
+ *
+ * - **update-like single-resource operations run through the RMM**, never the plain `doOperation`
+ *   lane, and fail closed with `MissingRMMRuntimeError` rather than writing without it;
+ * - **a missing target id is resolved first** from the canonical READ, so a detail-less context (a
+ *   bulk bar, a singleton) still mutates the right row;
+ * - **everything else runs `executeCurrentOperation`**, which merges a bulk selection into the body;
+ * - **the outcome is ALWAYS announced**, and `onSuccess` replaces only what happens next.
+ *
+ * Confirmation is NOT decided here. Each host owns the dialog it shows, because only the host knows
+ * whether a person has already acted deliberately (typed a phrase, pressed Submit) or merely picked.
+ *
+ * Must be called under a `ResourceOperationViewProvider` for the operation being executed — a
+ * detached host establishes one (`ResourceOperationDetachedHost`, `ResourceOperationActionDropdown`).
+ */
+export function useOperationDirectExecution({ onSuccess, errorMessage, errorComponent, }) {
+    const { resourceContext: currentResourceContext, resourceType, operation, reportError, goBackWithinZone, executeCurrentOperation, } = useResourceOperationViewContext();
+    const { doOperation, registry } = useResourceRegistry();
+    // `resource` as well as the component: a resource may override the component's words, and the
+    // fallback this was extracted from resolved them resource-scoped.
+    const { tComponent } = useI18n({ component: FrontendComponentType.RESOURCES_LAYOUTS_ACTION, resource: resourceType });
+    const doOperationRef = useRef(doOperation);
+    doOperationRef.current = doOperation;
+    const [isExecuting, setIsExecuting] = useState(false);
+    const [isBootstrapping, setIsBootstrapping] = useState(false);
+    const [bootstrappedRow, setBootstrappedRow] = useState(null);
+    /*
+     * A single-row update-like operation addresses ONE row, whichever lane it runs on, so its target id
+     * 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.
+     */
+    const isSingleRowUpdateLike = useMemo(() => isSingleResourceUpdateLikeOperation(operation), [operation]);
+    const acceptsDirectLane = isSingleRowUpdateLike
+        && allowsDirectOperationFallback(resolveDeclaredUpdateLikeMutationFallbackMode(operation));
+    const bootstrapContextKey = useMemo(() => JSON.stringify({
+        contextResourceIdentifiers: FrontendResourceUtils.buildContextResourceIdentifiersKey(currentResourceContext.contextResourceIdentifiers ?? {}),
+        parentResourcesRequirements: currentResourceContext.parentResourcesRequirements ?? [],
+    }), [
+        currentResourceContext.contextResourceIdentifiers,
+        currentResourceContext.parentResourcesRequirements,
+    ]);
+    const routeResourceId = useMemo(() => {
+        const identifier = currentResourceContext.contextResourceIdentifiers?.[resourceType];
+        if (!identifier) {
+            return null;
+        }
+        return frontendResourceUtils.getResourceId(identifier) ?? null;
+    }, [currentResourceContext.contextResourceIdentifiers, resourceType]);
+    const currentResourceId = routeResourceId ?? (bootstrappedRow?.contextKey === bootstrapContextKey
+        && typeof bootstrappedRow.row._id === 'string'
+        && bootstrappedRow.row._id.length > 0
+        ? bootstrappedRow.row._id
+        : null);
+    const contextResourceIdentifiersWithResourceId = useMemo(() => {
+        if (!currentResourceId || currentResourceContext.contextResourceIdentifiers?.[resourceType]) {
+            return currentResourceContext.contextResourceIdentifiers;
+        }
+        return {
+            ...currentResourceContext.contextResourceIdentifiers,
+            [resourceType]: currentResourceId,
+        };
+    }, [currentResourceContext.contextResourceIdentifiers, currentResourceId, resourceType]);
+    const contextualParameters = useMemo(() => {
+        return FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiersWithResourceId, registry);
+    }, [contextResourceIdentifiersWithResourceId, registry]);
+    const canonicalReadOperationPathKey = useMemo(() => {
+        return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {
+            hasResourceId: Boolean(currentResourceId),
+            contextResourceIdentifiers: contextResourceIdentifiersWithResourceId,
+            contextualParameters,
+        });
+    }, [contextResourceIdentifiersWithResourceId, contextualParameters, currentResourceId, registry, resourceType]);
+    const { rmm } = useResourceRMM({
+        resourceType,
+        resourceId: currentResourceId,
+        doOperationRef,
+        contextualParameters,
+        parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,
+        contextResourceIdentifiers: contextResourceIdentifiersWithResourceId,
+        resourceSchema: registry.resourceConfigurations[resourceType]?.mainSchema,
+        enabled: isSingleRowUpdateLike && !!currentResourceId,
+        conflictPolicy: { strategy: ConflictStrategy.ACCEPT_REMOTE },
+        directFallbackAccepted: acceptsDirectLane,
+    });
+    const executionFailedLabel = useMemo(() => {
+        return resolveComponentLabel({
+            tComponent,
+            componentType: FrontendComponentType.RESOURCES_LAYOUTS_ACTION,
+            key: 'executionFailed',
+        });
+    }, [tComponent]);
+    /*
+     * Announced with the context that carries the RESOLVED row id, not the route's. A context-addressed
+     * singleton has no id on its route; the id comes from the canonical READ, and a page showing that row
+     * re-reads only when the announcement names it (#1782). The route context named no row, so an action
+     * whose result carries no `_id` (a secret's change outcome) announced a change to nobody.
+     */
+    const announcedContext = useMemo(() => (contextResourceIdentifiersWithResourceId === currentResourceContext.contextResourceIdentifiers
+        ? currentResourceContext
+        : { ...currentResourceContext, contextResourceIdentifiers: contextResourceIdentifiersWithResourceId }), [contextResourceIdentifiersWithResourceId, currentResourceContext]);
+    const announceOutcome = useResourceOperationOutcomeEmitter(announcedContext, operation);
+    const handleSuccess = useCallback((result) => {
+        announceOutcome(result);
+        if (onSuccess) {
+            onSuccess(result);
+            return;
+        }
+        goBackWithinZone();
+    }, [announceOutcome, goBackWithinZone, onSuccess]);
+    const handleError = useCallback((error) => {
+        reportError(error, errorMessage, errorComponent);
+    }, [errorComponent, errorMessage, reportError]);
+    useEffect(() => {
+        if (!isSingleRowUpdateLike || currentResourceId || !canonicalReadOperationPathKey) {
+            return;
+        }
+        let cancelled = false;
+        setIsBootstrapping(true);
+        void performCanonicalRMMRead({
+            doOperation: doOperationRef.current,
+            readOperationPathKey: canonicalReadOperationPathKey,
+            contextualParameters,
+            parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,
+        }).then((row) => {
+            if (cancelled)
+                return;
+            setBootstrappedRow({
+                contextKey: bootstrapContextKey,
+                row,
+            });
+        }).catch((error) => {
+            if (cancelled)
+                return;
+            handleError(error instanceof Error ? error : new Error(String(error)));
+        }).finally(() => {
+            if (!cancelled) {
+                setIsBootstrapping(false);
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [
+        bootstrapContextKey,
+        canonicalReadOperationPathKey,
+        contextualParameters,
+        currentResourceContext.parentResourcesRequirements,
+        currentResourceId,
+        handleError,
+        isSingleRowUpdateLike,
+    ]);
+    useEffect(() => {
+        if (!rmm || !bootstrappedRow || bootstrappedRow.contextKey !== bootstrapContextKey) {
+            return;
+        }
+        if (typeof rmm.getSnapshot === 'function' && rmm.getSnapshot().confirmedData !== null) {
+            return;
+        }
+        if (typeof rmm.setInitialState === 'function') {
+            const row = bootstrappedRow.row;
+            rmm.setInitialState(row, row._version ?? 0, row._field_meta);
+        }
+    }, [bootstrapContextKey, bootstrappedRow, rmm]);
+    const execute = useCallback(async (requestData) => {
+        setIsExecuting(true);
+        try {
+            let result;
+            if (isSingleRowUpdateLike && (rmm || !acceptsDirectLane)) {
+                if (!rmm) {
+                    throw new MissingRMMRuntimeError({
+                        surfaceName: 'useOperationDirectExecution',
+                        resourceType,
+                        operationIdentifier: String(operation.operationIdentifier),
+                    });
+                }
+                // No optimistic patch: the body is the OPERATION's input, not a set of resource fields, and a
+                // custom operation's input names need not be the row's. The row is read back on success.
+                const mutationResult = await rmm.queueMutation({}, {
+                    type: MutationType.CUSTOM,
+                    priority: MutationPriority.HIGH,
+                    source: {
+                        type: MutationSourceType.CUSTOM,
+                        subscriberId: `direct-execution:${String(operation.operationIdentifier)}`,
+                    },
+                    transportOverride: {
+                        operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation),
+                        contextualParameters,
+                        parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,
+                        requestData: requestData ?? {},
+                        readBackOnSuccess: true,
+                    },
+                });
+                if (!mutationResult.success) {
+                    throw mutationErrorForReport(mutationResult.error, executionFailedLabel);
+                }
+                result = mutationResult.responseData;
+            }
+            else if (isSingleRowUpdateLike) {
+                /*
+                 * No RMM and the direct lane declared, still for ONE row: sent with the parameters this hook resolved, which carry the
+                 * bootstrapped id when the route had none. `executeCurrentOperation` builds its parameters from the
+                 * route alone, so from a detail-less context (a singleton, a bulk bar) it would address `{id}`
+                 * unresolved. With no id at all the operation has no row to act on, and says so instead of sending.
+                 */
+                if (!currentResourceId) {
+                    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.`);
+                }
+                result = await doOperationRef.current(ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation), {
+                    contextualParameters,
+                    parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,
+                    requestData: requestData ?? {},
+                });
+            }
+            else {
+                result = await executeCurrentOperation(requestData);
+            }
+            handleSuccess(result);
+        }
+        catch (error) {
+            handleError(error instanceof Error ? error : new Error(executionFailedLabel));
+        }
+        finally {
+            setIsExecuting(false);
+        }
+    }, [
+        contextualParameters,
+        currentResourceContext.parentResourcesRequirements,
+        executeCurrentOperation,
+        handleError,
+        handleSuccess,
+        acceptsDirectLane,
+        isSingleRowUpdateLike,
+        currentResourceId,
+        operation,
+        resourceType,
+        rmm,
+        executionFailedLabel,
+    ]);
+    return {
+        execute,
+        isExecuting,
+        isBootstrapping,
+        completeWithSuccess: handleSuccess,
+        reportFailure: handleError,
+    };
+}
+//# sourceMappingURL=useOperationDirectExecution.js.map