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

package/dist/esm/core/resources/rmm/canonical-read.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-read.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/canonical-read.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAET,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AACpI,OAAO,KAAK,EAAE,uCAAuC,EAAE,gCAAgC,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAM1L,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,yBAAyB,EACnC,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACxD,GACA,uCAAuC,GAAG,SAAS,CAmCrD;AAED,wBAAgB,uCAAuC,CACrD,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,yBAAyB,EACnC,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACxD,GACA,MAAM,GAAG,SAAS,CAuBpB;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6BAA6B,EAAE,MAAM,CAAC;IACtC,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,OAAO,CAOV;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,WAAW,EAAE,aAAa,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,GAAG,OAAO,EAAE,CAAC;CACxF,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CASnC"}
+{"version":3,"file":"canonical-read.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/canonical-read.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAET,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AACpI,OAAO,KAAK,EAAE,uCAAuC,EAAE,gCAAgC,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAM1L,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,yBAAyB,EACnC,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACxD,GACA,uCAAuC,GAAG,SAAS,CAmCrD;AAED,wBAAgB,uCAAuC,CACrD,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,yBAAyB,EACnC,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACxD,GACA,MAAM,GAAG,SAAS,CAuBpB;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6BAA6B,EAAE,MAAM,CAAC;IACtC,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,OAAO,CAOV;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,WAAW,EAAE,aAAa,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,GAAG,OAAO,EAAE,CAAC;CACxF,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CASnC"}

package/dist/esm/core/resources/rmm/mutation-error-report.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutation-error-report.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/mutation-error-report.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,KAAK,CAGvG"}
+{"version":3,"file":"mutation-error-report.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/mutation-error-report.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,KAAK,CAGvG"}

package/dist/esm/core/resources/rmm/rmm-noop-snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rmm-noop-snapshot.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/rmm-noop-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,CAAC,MAAM,IAAI,CAAa,CAAC;AAC3D,eAAO,MAAM,aAAa,EAAE,WAAgD,CAAC;AAC7E,eAAO,MAAM,iBAAiB,QAAO,WAA4B,CAAC"}
+{"version":3,"file":"rmm-noop-snapshot.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/rmm-noop-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,CAAC,MAAM,IAAI,CAAa,CAAC;AAC3D,eAAO,MAAM,aAAa,EAAE,WAAgD,CAAC;AAC7E,eAAO,MAAM,iBAAiB,QAAO,WAA4B,CAAC"}

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

@@ -1,4 +1,4 @@
-import type { DataMode, FieldMetaEntry, FieldMetaMap } from '@wildo-ai/saas-models';
+import type { DataMode, FieldMetaEntry, FieldMetaMap, ResourceOperationApprovalPending } from '@wildo-ai/saas-models';
 import type { CrdtResolutionWinner } from '@wildo-ai/saas-models';
 export declare enum RMMState {
     IDLE = "IDLE",
@@ -29,13 +29,30 @@ export declare enum MutationSourceType {
     ORCHESTRATOR = "orchestrator",
     CUSTOM = "custom"
 }
+/**
+ * Why a mutation failed, which decides what the RMM does next. Classified from the HTTP status by
+ * `HttpTransportAdapter`, following what each status means (RFC 9110 §15).
+ */
 export declare enum MutationErrorType {
+    /** The request's CONTENT is invalid (400, 422): no retry; the edit stays pending so the person can correct it. */
     VALIDATION = "validation",
+    /** The record changed underneath (409 version conflict): the conflict flow takes over. */
     CONFLICT = "conflict",
+    /** The record is gone (404, 410): no retry. */
     NOT_FOUND = "not_found",
+    /** The request may succeed if sent again (no response, 408, 425, 429): retried on the bounded ladder. */
     TRANSIENT = "transient",
+    /** The server failed (5xx): retried once. */
     SERVER = "server",
-    ABORT = "abort"
+    /** The mutation was cancelled on purpose: no retry, no notice. */
+    ABORT = "abort",
+    /**
+     * The server understood the request and will not perform it for this caller: 401, 403, and every other 4xx that
+     * sending it again cannot change. No retry, and the edit is NOT kept pending, because nothing the person can do to
+     * the field changes the answer, and a pending field rides along with every later save of the record and fails it
+     * too. These used to fall into TRANSIENT, so a refusal was retried twice and then announced as a network problem.
+     */
+    REFUSED = "refused"
 }
 export declare enum OperationResultStatus {
     SUCCESS = "success",
@@ -114,6 +131,11 @@ export interface ResourceMutationManagerConfig {
     contextualParameters: Record<string, string | number>;
     parentResourcesRequirements?: unknown[];
     resourceSchema?: unknown;
+    /**
+     * The resource's `inheritenceSchemaDefinition` (#2455): a CRDT field only a variant declares is merge-tracked too, so
+     * its timestamps are sent. Reading `resourceSchema` (the base) alone never sent them for a variant field.
+     */
+    resourceInheritance?: unknown;
     /** Operation path key for doOperation() routing. Falls back to resourceType if not provided. */
     operationPathKey?: string;
     /** Optional READ path used when custom mutations need an authoritative refresh. */
@@ -153,8 +175,20 @@ export interface MutationTransportOverride {
 export interface MutationResult {
     success: boolean;
     savedFields?: string[];
+    /**
+     * The values a PARTIAL write (a section's Save, an autosave, an inline edit) SENT, by the field paths `savedFields`
+     * names. A form marking a saved field saved compares it with what the field holds now: a field the person changed
+     * while the save was on its way holds a newer value, which the stored one must not overwrite. Absent for a
+     * whole-form write, whose values were parsed by the schema and would match no field's raw value.
+     */
+    savedValues?: Record<string, unknown>;
     newVersion?: number;
     responseData?: Record<string, unknown>;
+    /**
+     * #2288: the write was HELD for another person's approval. The record did not change, so nothing was saved: no field
+     * is marked saved, the confirmed row is untouched, and the surface says it is waiting rather than done.
+     */
+    heldForApproval?: ResourceOperationApprovalPending;
     error?: MutationError;
     retriesRemaining?: number;
 }
@@ -172,11 +206,22 @@ export interface MutationError {
     message?: string;
     /**
      * The transport failure exactly as it was caught — the HTTP client's error, carrying the backend's
-     * reference, error type and user guidance. `type` is a coarse RETRY classification (every non-conflict 4xx
-     * is `VALIDATION`), so a surface that shows the failure to a person resolves THIS through
+     * reference, error type and user guidance. `type` says what to DO next (retry, show at the fields, give up), not
+     * what to say, so a surface that shows the failure to a person resolves THIS through
      * `useUserFacingErrorMessage()` rather than `type` or `message`.
      */
     cause?: unknown;
+    /**
+     * `false` when the failed request may already have been applied and sending it again could apply it twice (#3004):
+     * a SERVER or TRANSIENT failure of a request no reason makes safe to resend (`failedRequestMayBeResentAutomatically`:
+     * not a safe method, and no `requestOutcome` from the server saying it was not applied or is repeatable; the RMM re-dispatches
+     * under a new `Idempotency-Key` and its `If-Match` is not enforced by every operation, so neither header counts here). The
+     * RMM does not retry such a failure; it settles it as it settles an exhausted one.
+     * Absent means nothing stands against a retry: the request is KNOWN never to have been sent (offline, held by the
+     * readiness gate), or no retry is considered for its type. A failure that carries no request is NOT taken as unsent: a
+     * 2xx whose answer failed the response contract is one, and the server applied it (#3004 review N1).
+     */
+    resendable?: boolean;
 }
 export interface ActiveMutation {
     entry: MutationQueueEntry;
@@ -217,6 +262,11 @@ export interface OperationDescriptor {
 export interface OperationResult {
     status: OperationResultStatus;
     data?: Record<string, unknown>;
+    /**
+     * #2288: the operation answered that it is held for approval. A SUCCESS of the request that changed no row: `data`
+     * and `newVersion` are absent, so the answer is never merged into the confirmed row (its keys are not the record's).
+     */
+    heldForApproval?: ResourceOperationApprovalPending;
     newVersion?: number;
     fieldMeta?: FieldMetaMap;
     error?: {
@@ -228,11 +278,13 @@ export interface OperationResult {
         conflictDetails?: MutationError['conflictDetails'];
         /**
          * The transport failure exactly as it was caught — the HTTP client's error, carrying the backend's
-         * reference, error type and user guidance. `type` is a coarse RETRY classification (every non-conflict 4xx
-         * is `VALIDATION`), so a surface that shows the failure to a person resolves THIS through
+         * reference, error type and user guidance. `type` says what to DO next (retry, show at the fields, give up),
+         * not what to say, so a surface that shows the failure to a person resolves THIS through
          * `useUserFacingErrorMessage()` rather than `type` or `message`.
          */
         cause?: unknown;
+        /** See {@link MutationError.resendable} (#3004). */
+        resendable?: MutationError['resendable'];
     };
 }
 export declare class MutationCancelledError extends Error {

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/types.ts"],"names":[],"mappings":"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"}

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

@@ -35,14 +35,31 @@ export var MutationSourceType;
     MutationSourceType["ORCHESTRATOR"] = "orchestrator";
     MutationSourceType["CUSTOM"] = "custom";
 })(MutationSourceType || (MutationSourceType = {}));
+/**
+ * Why a mutation failed, which decides what the RMM does next. Classified from the HTTP status by
+ * `HttpTransportAdapter`, following what each status means (RFC 9110 §15).
+ */
 export var MutationErrorType;
 (function (MutationErrorType) {
+    /** The request's CONTENT is invalid (400, 422): no retry; the edit stays pending so the person can correct it. */
     MutationErrorType["VALIDATION"] = "validation";
+    /** The record changed underneath (409 version conflict): the conflict flow takes over. */
     MutationErrorType["CONFLICT"] = "conflict";
+    /** The record is gone (404, 410): no retry. */
     MutationErrorType["NOT_FOUND"] = "not_found";
+    /** The request may succeed if sent again (no response, 408, 425, 429): retried on the bounded ladder. */
     MutationErrorType["TRANSIENT"] = "transient";
+    /** The server failed (5xx): retried once. */
     MutationErrorType["SERVER"] = "server";
+    /** The mutation was cancelled on purpose: no retry, no notice. */
     MutationErrorType["ABORT"] = "abort";
+    /**
+     * The server understood the request and will not perform it for this caller: 401, 403, and every other 4xx that
+     * sending it again cannot change. No retry, and the edit is NOT kept pending, because nothing the person can do to
+     * the field changes the answer, and a pending field rides along with every later save of the record and fails it
+     * too. These used to fall into TRANSIENT, so a refusal was retried twice and then announced as a network problem.
+     */
+    MutationErrorType["REFUSED"] = "refused";
 })(MutationErrorType || (MutationErrorType = {}));
 export var OperationResultStatus;
 (function (OperationResultStatus) {

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAKhF,gBAAgB;AAEhB,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,2BAAe,CAAA;IACf,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;AACrB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAED,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,mDAAmC,CAAA;IACnC,+CAA+B,CAAA;IAC/B,iDAAiC,CAAA;IACjC,qDAAqC,CAAA;AACvC,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED,MAAM,CAAN,IAAY,YAQX;AARD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;IACjB,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;IACjB,iCAAiB,CAAA;AACnB,CAAC,EARW,YAAY,KAAZ,YAAY,QAQvB;AAED,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,yCAAmB,CAAA;IACnB,mDAA6B,CAAA;IAC7B,uCAAiB,CAAA;AACnB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B;AAED,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,8CAAyB,CAAA;IACzB,0CAAqB,CAAA;IACrB,4CAAuB,CAAA;IACvB,4CAAuB,CAAA;IACvB,sCAAiB,CAAA;IACjB,oCAAe,CAAA;AACjB,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B;AAED,MAAM,CAAN,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC/B,4CAAmB,CAAA;IACnB,wCAAe,CAAA;AACjB,CAAC,EAHW,qBAAqB,KAArB,qBAAqB,QAGhC;AAED,MAAM,CAAN,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,mDAA+B,CAAA;IAC/B,uDAAmC,CAAA;AACrC,CAAC,EAHW,gBAAgB,KAAhB,gBAAgB,QAG3B;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,uDAAqC,CAAA;IACrC,iDAA+B,CAAA;AACjC,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,mCAAiB,CAAA;AACnB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,qDAAO,CAAA;IACP,2DAAU,CAAA;IACV,uDAAQ,CAAA;IACR,iEAAa,CAAA;AACf,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAkMD,wBAAwB;AAExB,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC7B,IAAI,GAAG,wBAAwB,CAAC;IACzC,MAAM,CAAkB;IAEjC,YAAY,MAAuB;QACjC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC3B,IAAI,GAAG,sBAAsB,CAAC;IAEhD;QACE,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAChC,IAAI,GAAG,2BAA2B,CAAC;IAErD;QACE,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACtD,CAAC;CACF","sourcesContent":["// =============================================================================\n// RMM Module — Type Definitions\n// =============================================================================\n\nimport type { DataMode, FieldMetaEntry, FieldMetaMap } from '@wildo-ai/saas-models';\nimport type { CrdtResolutionWinner } from '@wildo-ai/saas-models';\n\n// --- Enums ---\n\nexport enum RMMState {\n  IDLE = 'IDLE',\n  QUEUED = 'QUEUED',\n  SAVING = 'SAVING',\n  ERROR = 'ERROR',\n  CONFLICT = 'CONFLICT',\n  DELETED = 'DELETED',\n}\n\nexport enum RMMEventType {\n  MUTATION_RESULT = 'mutation_result',\n  REMOTE_UPDATE = 'remote_update',\n  CONFLICT_RESET = 'conflict_reset',\n  RESOURCE_DELETED = 'resource_deleted',\n}\n\nexport enum MutationType {\n  AUTOSAVE = 'autosave',\n  SUBMIT = 'submit',\n  DRAFT = 'draft',\n  PUBLISH = 'publish',\n  SECTION = 'section',\n  INLINE = 'inline',\n  CUSTOM = 'custom',\n}\n\nexport enum MutationSourceType {\n  FORM = 'form',\n  DISPLAY = 'display',\n  ORCHESTRATOR = 'orchestrator',\n  CUSTOM = 'custom',\n}\n\nexport enum MutationErrorType {\n  VALIDATION = 'validation',\n  CONFLICT = 'conflict',\n  NOT_FOUND = 'not_found',\n  TRANSIENT = 'transient',\n  SERVER = 'server',\n  ABORT = 'abort',\n}\n\nexport enum OperationResultStatus {\n  SUCCESS = 'success',\n  ERROR = 'error',\n}\n\nexport enum ConflictStrategy {\n  ACCEPT_REMOTE = 'accept-remote',\n  LAST_WRITE_WINS = 'last-write-wins',\n}\n\nexport enum ConflictReason {\n  VERSION_CONFLICT = 'version_conflict',\n  REMOTE_UPDATE = 'remote_update',\n}\n\nexport enum DeletionReason {\n  LOCAL = 'local',\n  REMOTE = 'remote',\n}\n\nexport enum MutationPriority {\n  LOW = 0,\n  NORMAL = 1,\n  HIGH = 2,\n  IMMEDIATE = 3,\n}\n\n// --- Events (Declarative Event Model §2.6) ---\n\n/**\n * Events set on `_lastEvent` to drive consumer side effects via `useEffect`.\n * Each event carries a monotonic `id` for dedup: `useEffect([snapshot.lastEvent?.id])`.\n */\nexport type RMMEvent =\n  | { type: RMMEventType.MUTATION_RESULT; result: MutationResult; source: MutationSource; id: number }\n  | { type: RMMEventType.REMOTE_UPDATE; changedFields: string[]; mergedFields: string[]; version: number; initiatorUserId: string; crdtResolutions?: Record<string, CrdtResolutionWinner>; id: number }\n  | {\n      type: RMMEventType.CONFLICT_RESET;\n      discardedFields: string[];\n      reason: ConflictReason;\n      currentData: Record<string, unknown>;\n      currentVersion: number;\n      conflictDetails?: MutationError['conflictDetails'];\n      id: number;\n    }\n  | { type: RMMEventType.RESOURCE_DELETED; reason: DeletionReason; deletedBy?: string; id: number };\n\n// --- Snapshot (for useSyncExternalStore) ---\n\nexport interface RMMSnapshot {\n  state: RMMState;\n  version: number | null;\n  confirmedData: Record<string, unknown> | null;\n  optimisticData: Record<string, unknown> | null;\n  pendingFieldNames: string[];\n  pendingFieldValues: Readonly<Record<string, unknown>>;\n  isSaving: boolean;\n  isDeleted: boolean;\n  hasUnsavedChanges: boolean;\n  error: MutationError | null;\n  queueDepth: number;\n  lastEvent: RMMEvent | null;\n}\n\n// --- Config ---\n\nexport interface ResourceMutationManagerConfig {\n  resourceType: string;\n  resourceId: string | null;\n  transportAdapter: TransportAdapter;\n  conflictPolicy: ConflictPolicy;\n  currentUserId: string;\n  contextResourceIdentifiers?: Record<string, string>;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  resourceSchema?: unknown;\n  /** Operation path key for doOperation() routing. Falls back to resourceType if not provided. */\n  operationPathKey?: string;\n  /** Optional READ path used when custom mutations need an authoritative refresh. */\n  readOperationPathKey?: string;\n  /**\n   * Optional backpressure overrides (tests, slow networks). Defaults match\n   * `ResourceMutationManager` internal `DEFAULT_BACKPRESSURE`. Only keys you set\n   * are applied; omitted keys keep defaults (explicit `undefined` does not zero timers).\n   *\n   * With `useResourceMutationManager`, config is captured on first `getOrCreate` for\n   * the registry key — changing `backpressure` on a later render has no effect.\n   */\n  backpressure?: Partial<BackpressureConfig>;\n}\n\n// --- Mutation Types ---\n\nexport interface MutationQueueEntry {\n  id: string;\n  type: MutationType;\n  fields: Record<string, unknown>;\n  priority: MutationPriority;\n  source: MutationSource;\n  resolve: (result: MutationResult) => void;\n  reject: (error: Error) => void;\n  signal?: AbortSignal;\n  transportOverride?: MutationTransportOverride;\n}\n\nexport interface MutationSource {\n  type: MutationSourceType;\n  subscriberId: string;\n}\n\nexport interface MutationTransportOverride {\n  operationPathKey?: string;\n  contextualParameters?: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  requestData?: Record<string, unknown>;\n  readBackOnSuccess?: boolean;\n}\n\nexport interface MutationResult {\n  success: boolean;\n  savedFields?: string[];\n  newVersion?: number;\n  responseData?: Record<string, unknown>;\n  error?: MutationError;\n  retriesRemaining?: number;\n}\n\nexport interface MutationError {\n  type: MutationErrorType;\n  status?: number;\n  validationErrors?: Record<string, unknown>;\n  conflictDetails?: {\n    currentVersion: number;\n    expectedVersion: number;\n    conflictingFields: string[];\n    currentValues: Record<string, unknown>;\n    submittedValues: Record<string, unknown>;\n  };\n  message?: string;\n  /**\n   * The transport failure exactly as it was caught — the HTTP client's error, carrying the backend's\n   * reference, error type and user guidance. `type` is a coarse RETRY classification (every non-conflict 4xx\n   * is `VALIDATION`), so a surface that shows the failure to a person resolves THIS through\n   * `useUserFacingErrorMessage()` rather than `type` or `message`.\n   */\n  cause?: unknown;\n}\n\nexport interface ActiveMutation {\n  entry: MutationQueueEntry;\n  savingFields: Record<string, unknown>;\n  abortController: AbortController;\n  retryCount: number;\n}\n\n// --- Conflict + CRDT Types ---\n\nexport interface ConflictPolicy {\n  strategy: ConflictStrategy;\n}\n\nexport interface DeferredSelfEvent {\n  changedFields: Record<string, unknown>;\n  version: number;\n  initiatorUserId: string;\n  fieldMeta?: Record<string, FieldMetaEntry>;\n}\n\nexport interface CRDTFieldTimestamps {\n  [fieldPath: string]: number;\n}\n\n// --- Backpressure ---\n\nexport interface BackpressureConfig {\n  maxQueueDepth: number;\n  softTimeoutMs: number;\n  hardTimeoutMs: number;\n}\n\n// --- Transport ---\n\nexport interface TransportAdapter {\n  execute(descriptor: OperationDescriptor): Promise<OperationResult>;\n}\n\nexport interface OperationDescriptor {\n  operationPathKey: string;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  dataMode?: DataMode;\n  requestData?: Record<string, unknown>;\n  expectedVersion?: number | null;\n  signal?: AbortSignal;\n  fieldTimestamps?: CRDTFieldTimestamps;\n}\n\nexport interface OperationResult {\n  status: OperationResultStatus;\n  data?: Record<string, unknown>;\n  newVersion?: number;\n  fieldMeta?: FieldMetaMap;\n  error?: {\n    type: MutationErrorType;\n    status?: number;\n    validationErrors?: Record<string, unknown>;\n    message?: string;\n    /** Populated when the backend supplies authoritative state on version conflict (409). */\n    conflictDetails?: MutationError['conflictDetails'];\n    /**\n     * The transport failure exactly as it was caught — the HTTP client's error, carrying the backend's\n     * reference, error type and user guidance. `type` is a coarse RETRY classification (every non-conflict 4xx\n     * is `VALIDATION`), so a surface that shows the failure to a person resolves THIS through\n     * `useUserFacingErrorMessage()` rather than `type` or `message`.\n     */\n    cause?: unknown;\n  };\n}\n\n// --- Error Classes ---\n\nexport class MutationCancelledError extends Error {\n  override readonly name = 'MutationCancelledError';\n  readonly source?: MutationSource;\n\n  constructor(source?: MutationSource) {\n    super('Mutation cancelled');\n    this.source = source;\n  }\n}\n\nexport class ResourceDeletedError extends Error {\n  override readonly name = 'ResourceDeletedError';\n\n  constructor() {\n    super('Resource has been deleted');\n  }\n}\n\nexport class BackpressureRejectedError extends Error {\n  override readonly name = 'BackpressureRejectedError';\n\n  constructor() {\n    super('Queue at maximum depth — mutation rejected');\n  }\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/types.ts"],"names":[],"mappings":"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","sourcesContent":["// =============================================================================\n// RMM Module — Type Definitions\n// =============================================================================\n\nimport type { DataMode, FieldMetaEntry, FieldMetaMap, ResourceOperationApprovalPending } from '@wildo-ai/saas-models';\nimport type { CrdtResolutionWinner } from '@wildo-ai/saas-models';\n\n// --- Enums ---\n\nexport enum RMMState {\n  IDLE = 'IDLE',\n  QUEUED = 'QUEUED',\n  SAVING = 'SAVING',\n  ERROR = 'ERROR',\n  CONFLICT = 'CONFLICT',\n  DELETED = 'DELETED',\n}\n\nexport enum RMMEventType {\n  MUTATION_RESULT = 'mutation_result',\n  REMOTE_UPDATE = 'remote_update',\n  CONFLICT_RESET = 'conflict_reset',\n  RESOURCE_DELETED = 'resource_deleted',\n}\n\nexport enum MutationType {\n  AUTOSAVE = 'autosave',\n  SUBMIT = 'submit',\n  DRAFT = 'draft',\n  PUBLISH = 'publish',\n  SECTION = 'section',\n  INLINE = 'inline',\n  CUSTOM = 'custom',\n}\n\nexport enum MutationSourceType {\n  FORM = 'form',\n  DISPLAY = 'display',\n  ORCHESTRATOR = 'orchestrator',\n  CUSTOM = 'custom',\n}\n\n/**\n * Why a mutation failed, which decides what the RMM does next. Classified from the HTTP status by\n * `HttpTransportAdapter`, following what each status means (RFC 9110 §15).\n */\nexport enum MutationErrorType {\n  /** The request's CONTENT is invalid (400, 422): no retry; the edit stays pending so the person can correct it. */\n  VALIDATION = 'validation',\n  /** The record changed underneath (409 version conflict): the conflict flow takes over. */\n  CONFLICT = 'conflict',\n  /** The record is gone (404, 410): no retry. */\n  NOT_FOUND = 'not_found',\n  /** The request may succeed if sent again (no response, 408, 425, 429): retried on the bounded ladder. */\n  TRANSIENT = 'transient',\n  /** The server failed (5xx): retried once. */\n  SERVER = 'server',\n  /** The mutation was cancelled on purpose: no retry, no notice. */\n  ABORT = 'abort',\n  /**\n   * The server understood the request and will not perform it for this caller: 401, 403, and every other 4xx that\n   * sending it again cannot change. No retry, and the edit is NOT kept pending, because nothing the person can do to\n   * the field changes the answer, and a pending field rides along with every later save of the record and fails it\n   * too. These used to fall into TRANSIENT, so a refusal was retried twice and then announced as a network problem.\n   */\n  REFUSED = 'refused',\n}\n\nexport enum OperationResultStatus {\n  SUCCESS = 'success',\n  ERROR = 'error',\n}\n\nexport enum ConflictStrategy {\n  ACCEPT_REMOTE = 'accept-remote',\n  LAST_WRITE_WINS = 'last-write-wins',\n}\n\nexport enum ConflictReason {\n  VERSION_CONFLICT = 'version_conflict',\n  REMOTE_UPDATE = 'remote_update',\n}\n\nexport enum DeletionReason {\n  LOCAL = 'local',\n  REMOTE = 'remote',\n}\n\nexport enum MutationPriority {\n  LOW = 0,\n  NORMAL = 1,\n  HIGH = 2,\n  IMMEDIATE = 3,\n}\n\n// --- Events (Declarative Event Model §2.6) ---\n\n/**\n * Events set on `_lastEvent` to drive consumer side effects via `useEffect`.\n * Each event carries a monotonic `id` for dedup: `useEffect([snapshot.lastEvent?.id])`.\n */\nexport type RMMEvent =\n  | { type: RMMEventType.MUTATION_RESULT; result: MutationResult; source: MutationSource; id: number }\n  | { type: RMMEventType.REMOTE_UPDATE; changedFields: string[]; mergedFields: string[]; version: number; initiatorUserId: string; crdtResolutions?: Record<string, CrdtResolutionWinner>; id: number }\n  | {\n      type: RMMEventType.CONFLICT_RESET;\n      discardedFields: string[];\n      reason: ConflictReason;\n      currentData: Record<string, unknown>;\n      currentVersion: number;\n      conflictDetails?: MutationError['conflictDetails'];\n      id: number;\n    }\n  | { type: RMMEventType.RESOURCE_DELETED; reason: DeletionReason; deletedBy?: string; id: number };\n\n// --- Snapshot (for useSyncExternalStore) ---\n\nexport interface RMMSnapshot {\n  state: RMMState;\n  version: number | null;\n  confirmedData: Record<string, unknown> | null;\n  optimisticData: Record<string, unknown> | null;\n  pendingFieldNames: string[];\n  pendingFieldValues: Readonly<Record<string, unknown>>;\n  isSaving: boolean;\n  isDeleted: boolean;\n  hasUnsavedChanges: boolean;\n  error: MutationError | null;\n  queueDepth: number;\n  lastEvent: RMMEvent | null;\n}\n\n// --- Config ---\n\nexport interface ResourceMutationManagerConfig {\n  resourceType: string;\n  resourceId: string | null;\n  transportAdapter: TransportAdapter;\n  conflictPolicy: ConflictPolicy;\n  currentUserId: string;\n  contextResourceIdentifiers?: Record<string, string>;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  resourceSchema?: unknown;\n  /**\n   * The resource's `inheritenceSchemaDefinition` (#2455): a CRDT field only a variant declares is merge-tracked too, so\n   * its timestamps are sent. Reading `resourceSchema` (the base) alone never sent them for a variant field.\n   */\n  resourceInheritance?: unknown;\n  /** Operation path key for doOperation() routing. Falls back to resourceType if not provided. */\n  operationPathKey?: string;\n  /** Optional READ path used when custom mutations need an authoritative refresh. */\n  readOperationPathKey?: string;\n  /**\n   * Optional backpressure overrides (tests, slow networks). Defaults match\n   * `ResourceMutationManager` internal `DEFAULT_BACKPRESSURE`. Only keys you set\n   * are applied; omitted keys keep defaults (explicit `undefined` does not zero timers).\n   *\n   * With `useResourceMutationManager`, config is captured on first `getOrCreate` for\n   * the registry key — changing `backpressure` on a later render has no effect.\n   */\n  backpressure?: Partial<BackpressureConfig>;\n}\n\n// --- Mutation Types ---\n\nexport interface MutationQueueEntry {\n  id: string;\n  type: MutationType;\n  fields: Record<string, unknown>;\n  priority: MutationPriority;\n  source: MutationSource;\n  resolve: (result: MutationResult) => void;\n  reject: (error: Error) => void;\n  signal?: AbortSignal;\n  transportOverride?: MutationTransportOverride;\n}\n\nexport interface MutationSource {\n  type: MutationSourceType;\n  subscriberId: string;\n}\n\nexport interface MutationTransportOverride {\n  operationPathKey?: string;\n  contextualParameters?: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  requestData?: Record<string, unknown>;\n  readBackOnSuccess?: boolean;\n}\n\nexport interface MutationResult {\n  success: boolean;\n  savedFields?: string[];\n  /**\n   * The values a PARTIAL write (a section's Save, an autosave, an inline edit) SENT, by the field paths `savedFields`\n   * names. A form marking a saved field saved compares it with what the field holds now: a field the person changed\n   * while the save was on its way holds a newer value, which the stored one must not overwrite. Absent for a\n   * whole-form write, whose values were parsed by the schema and would match no field's raw value.\n   */\n  savedValues?: Record<string, unknown>;\n  newVersion?: number;\n  responseData?: Record<string, unknown>;\n  /**\n   * #2288: the write was HELD for another person's approval. The record did not change, so nothing was saved: no field\n   * is marked saved, the confirmed row is untouched, and the surface says it is waiting rather than done.\n   */\n  heldForApproval?: ResourceOperationApprovalPending;\n  error?: MutationError;\n  retriesRemaining?: number;\n}\n\nexport interface MutationError {\n  type: MutationErrorType;\n  status?: number;\n  validationErrors?: Record<string, unknown>;\n  conflictDetails?: {\n    currentVersion: number;\n    expectedVersion: number;\n    conflictingFields: string[];\n    currentValues: Record<string, unknown>;\n    submittedValues: Record<string, unknown>;\n  };\n  message?: string;\n  /**\n   * The transport failure exactly as it was caught — the HTTP client's error, carrying the backend's\n   * reference, error type and user guidance. `type` says what to DO next (retry, show at the fields, give up), not\n   * what to say, so a surface that shows the failure to a person resolves THIS through\n   * `useUserFacingErrorMessage()` rather than `type` or `message`.\n   */\n  cause?: unknown;\n  /**\n   * `false` when the failed request may already have been applied and sending it again could apply it twice (#3004):\n   * a SERVER or TRANSIENT failure of a request no reason makes safe to resend (`failedRequestMayBeResentAutomatically`:\n   * not a safe method, and no `requestOutcome` from the server saying it was not applied or is repeatable; the RMM re-dispatches\n   * under a new `Idempotency-Key` and its `If-Match` is not enforced by every operation, so neither header counts here). The\n   * RMM does not retry such a failure; it settles it as it settles an exhausted one.\n   * Absent means nothing stands against a retry: the request is KNOWN never to have been sent (offline, held by the\n   * readiness gate), or no retry is considered for its type. A failure that carries no request is NOT taken as unsent: a\n   * 2xx whose answer failed the response contract is one, and the server applied it (#3004 review N1).\n   */\n  resendable?: boolean;\n}\n\nexport interface ActiveMutation {\n  entry: MutationQueueEntry;\n  savingFields: Record<string, unknown>;\n  abortController: AbortController;\n  retryCount: number;\n}\n\n// --- Conflict + CRDT Types ---\n\nexport interface ConflictPolicy {\n  strategy: ConflictStrategy;\n}\n\nexport interface DeferredSelfEvent {\n  changedFields: Record<string, unknown>;\n  version: number;\n  initiatorUserId: string;\n  fieldMeta?: Record<string, FieldMetaEntry>;\n}\n\nexport interface CRDTFieldTimestamps {\n  [fieldPath: string]: number;\n}\n\n// --- Backpressure ---\n\nexport interface BackpressureConfig {\n  maxQueueDepth: number;\n  softTimeoutMs: number;\n  hardTimeoutMs: number;\n}\n\n// --- Transport ---\n\nexport interface TransportAdapter {\n  execute(descriptor: OperationDescriptor): Promise<OperationResult>;\n}\n\nexport interface OperationDescriptor {\n  operationPathKey: string;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  dataMode?: DataMode;\n  requestData?: Record<string, unknown>;\n  expectedVersion?: number | null;\n  signal?: AbortSignal;\n  fieldTimestamps?: CRDTFieldTimestamps;\n}\n\nexport interface OperationResult {\n  status: OperationResultStatus;\n  data?: Record<string, unknown>;\n  /**\n   * #2288: the operation answered that it is held for approval. A SUCCESS of the request that changed no row: `data`\n   * and `newVersion` are absent, so the answer is never merged into the confirmed row (its keys are not the record's).\n   */\n  heldForApproval?: ResourceOperationApprovalPending;\n  newVersion?: number;\n  fieldMeta?: FieldMetaMap;\n  error?: {\n    type: MutationErrorType;\n    status?: number;\n    validationErrors?: Record<string, unknown>;\n    message?: string;\n    /** Populated when the backend supplies authoritative state on version conflict (409). */\n    conflictDetails?: MutationError['conflictDetails'];\n    /**\n     * The transport failure exactly as it was caught — the HTTP client's error, carrying the backend's\n     * reference, error type and user guidance. `type` says what to DO next (retry, show at the fields, give up),\n     * not what to say, so a surface that shows the failure to a person resolves THIS through\n     * `useUserFacingErrorMessage()` rather than `type` or `message`.\n     */\n    cause?: unknown;\n    /** See {@link MutationError.resendable} (#3004). */\n    resendable?: MutationError['resendable'];\n  };\n}\n\n// --- Error Classes ---\n\nexport class MutationCancelledError extends Error {\n  override readonly name = 'MutationCancelledError';\n  readonly source?: MutationSource;\n\n  constructor(source?: MutationSource) {\n    super('Mutation cancelled');\n    this.source = source;\n  }\n}\n\nexport class ResourceDeletedError extends Error {\n  override readonly name = 'ResourceDeletedError';\n\n  constructor() {\n    super('Resource has been deleted');\n  }\n}\n\nexport class BackpressureRejectedError extends Error {\n  override readonly name = 'BackpressureRejectedError';\n\n  constructor() {\n    super('Queue at maximum depth — mutation rejected');\n  }\n}\n"]}

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

@@ -19,7 +19,9 @@
  * surfaces.
  * `DIRECT_OPERATION_FALLBACK` is an explicit weaker-guarantee lane for advanced
  * callers that knowingly accept the semantic downgrade, including the loss of
- * guaranteed authoritative conflict-detail handling.
+ * guaranteed authoritative conflict-detail handling. It is also what an operation
+ * resolves to when its resource has no field-write route at all, because there no
+ * RMM can exist to downgrade from — see {@link resolveUpdateLikeMutationFallbackMode}.
  */
 export declare enum UpdateLikeMutationFallbackMode {
     RMM_REQUIRED = "RMM_REQUIRED",
@@ -41,14 +43,49 @@ export declare class MissingRMMRuntimeError extends Error {
     constructor(params: MissingRMMRuntimeErrorParams);
 }
 export declare function allowsDirectOperationFallback(mode: UpdateLikeMutationFallbackMode | undefined): boolean;
+/** The slice of a registered operation {@link resourceHasFieldWriteRoute} reads. */
+export interface FieldWriteRouteCandidate {
+    operationIdentifier: unknown;
+    variantType?: unknown;
+    isBulkOperation?: 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.
+ * Whether a resource registers the operation an RMM is built on: the LITERAL core `update`, for one row,
+ * reachable over HTTP (`API_CALL`). `undefined` when the resource's operations are not known.
+ *
+ * This is the STRUCTURAL half of what `pickInlineFieldWriteOperation` answers for one context: that
+ * picker returns the literal `update` addressable from here, or nothing, and `useResourceRMM` attaches no
+ * RMM without it. So when this is `false`, no RMM can exist for any row of the resource, in any context.
+ * The picker can still find nothing when this is `true` (the route is not addressable from the current
+ * context); that case is a real integration gap and keeps failing closed.
+ *
+ * Kept here, with no frontend-lib import, because `resources.frontend.schemas` imports this module for
+ * the enum, and the addressability and semantics utilities both import those schemas.
+ */
+export declare function resourceHasFieldWriteRoute(resourceOperations: readonly FieldWriteRouteCandidate[] | undefined): boolean | undefined;
+/**
+ * The lane an update-like operation runs on, asked by every host that runs one (the form, the form-less
+ * `useOperationDirectExecution`, `useResourceOperationSurface`, the execution surface), so an operation
+ * cannot submit from one host and be refused by another.
+ *
+ * 1. What the operation DECLARED (`operationFrontendConfig.updateLikeMutationFallbackMode`), when it did.
+ * 2. Otherwise `DIRECT_OPERATION_FALLBACK` when its resource registers no field-write route
+ *    ({@link resourceHasFieldWriteRoute} is `false`), and `RMM_REQUIRED` in every other case,
+ *    including an unknown resource.
+ *
+ * Why step 2 is derived (#1956). `RMM_REQUIRED` exists so that a host never silently trades the RMM's
+ * guarantees (optimistic state, version-conflict details) for a direct write when an RMM SHOULD be there.
+ * On a resource with no literal `update` there is nothing to trade: no RMM can ever exist, so
+ * `RMM_REQUIRED` there does not ask for a stronger lane, it asks for an impossible one, and every
+ * form-bearing verb failed closed with "This action failed" and sent nothing. The reason belongs to the
+ * resource, not to each view, and hand-declaring it per view missed 33 verbs across 10 resources (a
+ * organization relationship's End, Decline and Set activity disclosure among them, measured live
+ * 2026-10-01). A resource that DOES have a field-write route keeps the strict default: there a missing
+ * RMM is a fault to report, not an absence to work around.
  */
-export declare function resolveDeclaredUpdateLikeMutationFallbackMode(operation: {
+export declare function resolveUpdateLikeMutationFallbackMode(operation: {
     operationFrontendConfig?: {
         updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;
     };
-}): UpdateLikeMutationFallbackMode;
+}, resourceOperations: readonly FieldWriteRouteCandidate[] | undefined): 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;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"}
+{"version":3,"file":"update-like-mutation-fallback.frontend.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/update-like-mutation-fallback.frontend.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;;GAWG;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,oFAAoF;AACpF,MAAM,WAAW,wBAAwB;IACvC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,kBAAkB,EAAE,SAAS,wBAAwB,EAAE,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAMnI;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qCAAqC,CACnD,SAAS,EAAE;IAAE,uBAAuB,CAAC,EAAE;QAAE,8BAA8B,CAAC,EAAE,8BAA8B,CAAA;KAAE,CAAA;CAAE,EAC5G,kBAAkB,EAAE,SAAS,wBAAwB,EAAE,GAAG,SAAS,GAClE,8BAA8B,CAMhC"}

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

@@ -1,3 +1,4 @@
+import { CoreResourceOperation, ResourceOperationVariantType } from '@wildo-ai/saas-models';
 /**
  * Step 6 escape-hatch classification for framework mutation surfaces.
  *
@@ -19,7 +20,9 @@
  * surfaces.
  * `DIRECT_OPERATION_FALLBACK` is an explicit weaker-guarantee lane for advanced
  * callers that knowingly accept the semantic downgrade, including the loss of
- * guaranteed authoritative conflict-detail handling.
+ * guaranteed authoritative conflict-detail handling. It is also what an operation
+ * resolves to when its resource has no field-write route at all, because there no
+ * RMM can exist to downgrade from — see {@link resolveUpdateLikeMutationFallbackMode}.
  */
 export var UpdateLikeMutationFallbackMode;
 (function (UpdateLikeMutationFallbackMode) {
@@ -51,11 +54,51 @@ 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.
+ * Whether a resource registers the operation an RMM is built on: the LITERAL core `update`, for one row,
+ * reachable over HTTP (`API_CALL`). `undefined` when the resource's operations are not known.
+ *
+ * This is the STRUCTURAL half of what `pickInlineFieldWriteOperation` answers for one context: that
+ * picker returns the literal `update` addressable from here, or nothing, and `useResourceRMM` attaches no
+ * RMM without it. So when this is `false`, no RMM can exist for any row of the resource, in any context.
+ * The picker can still find nothing when this is `true` (the route is not addressable from the current
+ * context); that case is a real integration gap and keeps failing closed.
+ *
+ * Kept here, with no frontend-lib import, because `resources.frontend.schemas` imports this module for
+ * the enum, and the addressability and semantics utilities both import those schemas.
+ */
+export function resourceHasFieldWriteRoute(resourceOperations) {
+    if (!resourceOperations)
+        return undefined;
+    return resourceOperations.some((candidate) => String(candidate.operationIdentifier) === String(CoreResourceOperation.UPDATE)
+        && candidate.isBulkOperation !== true
+        && candidate.variantType === ResourceOperationVariantType.API_CALL);
+}
+/**
+ * The lane an update-like operation runs on, asked by every host that runs one (the form, the form-less
+ * `useOperationDirectExecution`, `useResourceOperationSurface`, the execution surface), so an operation
+ * cannot submit from one host and be refused by another.
+ *
+ * 1. What the operation DECLARED (`operationFrontendConfig.updateLikeMutationFallbackMode`), when it did.
+ * 2. Otherwise `DIRECT_OPERATION_FALLBACK` when its resource registers no field-write route
+ *    ({@link resourceHasFieldWriteRoute} is `false`), and `RMM_REQUIRED` in every other case,
+ *    including an unknown resource.
+ *
+ * Why step 2 is derived (#1956). `RMM_REQUIRED` exists so that a host never silently trades the RMM's
+ * guarantees (optimistic state, version-conflict details) for a direct write when an RMM SHOULD be there.
+ * On a resource with no literal `update` there is nothing to trade: no RMM can ever exist, so
+ * `RMM_REQUIRED` there does not ask for a stronger lane, it asks for an impossible one, and every
+ * form-bearing verb failed closed with "This action failed" and sent nothing. The reason belongs to the
+ * resource, not to each view, and hand-declaring it per view missed 33 verbs across 10 resources (a
+ * organization relationship's End, Decline and Set activity disclosure among them, measured live
+ * 2026-10-01). A resource that DOES have a field-write route keeps the strict default: there a missing
+ * RMM is a fault to report, not an absence to work around.
  */
-export function resolveDeclaredUpdateLikeMutationFallbackMode(operation) {
-    return operation.operationFrontendConfig?.updateLikeMutationFallbackMode ?? UpdateLikeMutationFallbackMode.RMM_REQUIRED;
+export function resolveUpdateLikeMutationFallbackMode(operation, resourceOperations) {
+    const declared = operation.operationFrontendConfig?.updateLikeMutationFallbackMode;
+    if (declared)
+        return declared;
+    return resourceHasFieldWriteRoute(resourceOperations) === false
+        ? UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK
+        : 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;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"]}
+{"version":3,"file":"update-like-mutation-fallback.frontend.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/update-like-mutation-fallback.frontend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE5F;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;;GAWG;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;AASD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CAAC,kBAAmE;IAC5G,IAAI,CAAC,kBAAkB;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAC3C,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,KAAK,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC;WAC3E,SAAS,CAAC,eAAe,KAAK,IAAI;WAClC,SAAS,CAAC,WAAW,KAAK,4BAA4B,CAAC,QAAQ,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qCAAqC,CACnD,SAA4G,EAC5G,kBAAmE;IAEnE,MAAM,QAAQ,GAAG,SAAS,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;IACnF,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,0BAA0B,CAAC,kBAAkB,CAAC,KAAK,KAAK;QAC7D,CAAC,CAAC,8BAA8B,CAAC,yBAAyB;QAC1D,CAAC,CAAC,8BAA8B,CAAC,YAAY,CAAC;AAClD,CAAC","sourcesContent":["import { CoreResourceOperation, ResourceOperationVariantType } from '@wildo-ai/saas-models';\n\n/**\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. It is also what an operation\n * resolves to when its resource has no field-write route at all, because there no\n * RMM can exist to downgrade from — see {@link resolveUpdateLikeMutationFallbackMode}.\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/** The slice of a registered operation {@link resourceHasFieldWriteRoute} reads. */\nexport interface FieldWriteRouteCandidate {\n  operationIdentifier: unknown;\n  variantType?: unknown;\n  isBulkOperation?: boolean;\n}\n\n/**\n * Whether a resource registers the operation an RMM is built on: the LITERAL core `update`, for one row,\n * reachable over HTTP (`API_CALL`). `undefined` when the resource's operations are not known.\n *\n * This is the STRUCTURAL half of what `pickInlineFieldWriteOperation` answers for one context: that\n * picker returns the literal `update` addressable from here, or nothing, and `useResourceRMM` attaches no\n * RMM without it. So when this is `false`, no RMM can exist for any row of the resource, in any context.\n * The picker can still find nothing when this is `true` (the route is not addressable from the current\n * context); that case is a real integration gap and keeps failing closed.\n *\n * Kept here, with no frontend-lib import, because `resources.frontend.schemas` imports this module for\n * the enum, and the addressability and semantics utilities both import those schemas.\n */\nexport function resourceHasFieldWriteRoute(resourceOperations: readonly FieldWriteRouteCandidate[] | undefined): boolean | undefined {\n  if (!resourceOperations) return undefined;\n  return resourceOperations.some((candidate) =>\n    String(candidate.operationIdentifier) === String(CoreResourceOperation.UPDATE)\n    && candidate.isBulkOperation !== true\n    && candidate.variantType === ResourceOperationVariantType.API_CALL);\n}\n\n/**\n * The lane an update-like operation runs on, asked by every host that runs one (the form, the form-less\n * `useOperationDirectExecution`, `useResourceOperationSurface`, the execution surface), so an operation\n * cannot submit from one host and be refused by another.\n *\n * 1. What the operation DECLARED (`operationFrontendConfig.updateLikeMutationFallbackMode`), when it did.\n * 2. Otherwise `DIRECT_OPERATION_FALLBACK` when its resource registers no field-write route\n *    ({@link resourceHasFieldWriteRoute} is `false`), and `RMM_REQUIRED` in every other case,\n *    including an unknown resource.\n *\n * Why step 2 is derived (#1956). `RMM_REQUIRED` exists so that a host never silently trades the RMM's\n * guarantees (optimistic state, version-conflict details) for a direct write when an RMM SHOULD be there.\n * On a resource with no literal `update` there is nothing to trade: no RMM can ever exist, so\n * `RMM_REQUIRED` there does not ask for a stronger lane, it asks for an impossible one, and every\n * form-bearing verb failed closed with \"This action failed\" and sent nothing. The reason belongs to the\n * resource, not to each view, and hand-declaring it per view missed 33 verbs across 10 resources (a\n * organization relationship's End, Decline and Set activity disclosure among them, measured live\n * 2026-10-01). A resource that DOES have a field-write route keeps the strict default: there a missing\n * RMM is a fault to report, not an absence to work around.\n */\nexport function resolveUpdateLikeMutationFallbackMode(\n  operation: { operationFrontendConfig?: { updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode } },\n  resourceOperations: readonly FieldWriteRouteCandidate[] | undefined,\n): UpdateLikeMutationFallbackMode {\n  const declared = operation.operationFrontendConfig?.updateLikeMutationFallbackMode;\n  if (declared) return declared;\n  return resourceHasFieldWriteRoute(resourceOperations) === false\n    ? UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK\n    : UpdateLikeMutationFallbackMode.RMM_REQUIRED;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useListInvalidation.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useListInvalidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAOtH,MAAM,WAAW,yBAAyB;IACxC,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,2BAA2B,EAAE,OAAO,EAAE,CAAC;IACvC,aAAa,CAAC,EAAE,gCAAgC,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACrE,cAAc,CAAC,EAAE,KAAK,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAC;CACvE;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,uBAAuB,GAAG,IAAI,EACnC,MAAM,EAAE,yBAAyB,GAChC,IAAI,CAmDN"}
+{"version":3,"file":"useListInvalidation.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useListInvalidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAOtH,MAAM,WAAW,yBAAyB;IACxC,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,2BAA2B,EAAE,OAAO,EAAE,CAAC;IACvC,aAAa,CAAC,EAAE,gCAAgC,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACrE,cAAc,CAAC,EAAE,KAAK,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAC;CACvE;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,uBAAuB,GAAG,IAAI,EACnC,MAAM,EAAE,yBAAyB,GAChC,IAAI,CAmDN"}

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

@@ -1 +1 @@
-{"version":3,"file":"useRMMEventHandler.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useRMMEventHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,uBAAuB,EAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GACjC,IAAI,CAWN"}
+{"version":3,"file":"useRMMEventHandler.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useRMMEventHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,uBAAuB,EAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GACjC,IAAI,CAWN"}

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

@@ -1 +1 @@
-{"version":3,"file":"useRMMSnapshot.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useRMMSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,wBAAgB,cAAc,CAAC,GAAG,EAAE,uBAAuB,GAAG,WAAW,CAExE"}
+{"version":3,"file":"useRMMSnapshot.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useRMMSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,wBAAgB,cAAc,CAAC,GAAG,EAAE,uBAAuB,GAAG,WAAW,CAExE"}

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

@@ -1 +1 @@
-{"version":3,"file":"useResourceMutationManager.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useResourceMutationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,6BAA6B,EAAE,cAAc,GAAG,YAAY,GAAG,eAAe,CAAC,CAAC;AAYhH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,uBAAuB,CAwDzB"}
+{"version":3,"file":"useResourceMutationManager.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceMutationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,6BAA6B,EAAE,cAAc,GAAG,YAAY,GAAG,eAAe,CAAC,CAAC;AAYhH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,uBAAuB,CA0DzB"}

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

@@ -56,6 +56,7 @@ export function useResourceMutationManager(resourceType, resourceId, config) {
             readOperationPathKey: config.readOperationPathKey,
             conflictPolicy: config.conflictPolicy,
             resourceSchema: config.resourceSchema,
+            resourceInheritance: config.resourceInheritance,
         });
         registry.notifyInstanceRuntimeChanged();
     }, [
@@ -69,6 +70,7 @@ export function useResourceMutationManager(resourceType, resourceId, config) {
         config.readOperationPathKey,
         config.conflictPolicy,
         config.resourceSchema,
+        config.resourceInheritance,
         config.transportAdapter,
     ]);
     return rmm;

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

@@ -1 +1 @@
-{"version":3,"file":"useResourceMutationManager.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceMutationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAM5E;;;GAGG;AACH,SAAS,cAAc;IACrB,MAAM,QAAQ,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACrG,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,YAAoB,EACpB,UAAkB,EAClB,MAAoB;IAEpB,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,GAAG,WAAW,EAAE,CAAC;IACzD,MAAM,YAAY,GAAG,wBAAwB,EAAE,MAAM,IAAI,IAAI,CAAC;IAC9D,8EAA8E;IAC9E,yEAAyE;IACzE,MAAM,yBAAyB,GAAG,MAAM,CAAS,EAAE,CAAC,CAAC;IACrD,IAAI,IAAI,EAAE,GAAG,IAAI,YAAY,EAAE,CAAC;QAC9B,yBAAyB,CAAC,OAAO,GAAG,IAAI,EAAE,GAAG,IAAI,YAAa,CAAC;IACjE,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,EAAE,GAAG,IAAI,YAAY,IAAI,yBAAyB,CAAC,OAAO,CAAC;IAErF,MAAM,GAAG,GAAG,OAAO,CACjB,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,EAAE;QACnD,GAAG,MAAM;QACT,YAAY;QACZ,UAAU;QACV,aAAa;QACb,0BAA0B,EAAE,MAAM,CAAC,0BAA0B,IAAI,EAAE;KACpE,CAAC;IACF,6FAA6F;IAC7F,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CACrC,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAC3E,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,wBAAwB,CAAC;YAC3B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,aAAa;YACb,0BAA0B,EAAE,MAAM,CAAC,0BAA0B,IAAI,EAAE;YACnE,oBAAoB,EAAE,EAAE,GAAG,MAAM,CAAC,oBAAoB,EAAE;YACxD,2BAA2B,EAAE,MAAM,CAAC,2BAA2B;YAC/D,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;YACjD,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC,CAAC,CAAC;QACH,QAAQ,CAAC,4BAA4B,EAAE,CAAC;IAC1C,CAAC,EAAE;QACD,QAAQ;QACR,GAAG;QACH,aAAa;QACb,MAAM,CAAC,0BAA0B;QACjC,MAAM,CAAC,oBAAoB;QAC3B,MAAM,CAAC,2BAA2B;QAClC,MAAM,CAAC,gBAAgB;QACvB,MAAM,CAAC,oBAAoB;QAC3B,MAAM,CAAC,cAAc;QACrB,MAAM,CAAC,cAAc;QACrB,MAAM,CAAC,gBAAgB;KACxB,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["/**\n * useResourceMutationManager Hook\n *\n * Separated from RMMRegistryContext.tsx for React Fast Refresh compatibility.\n *\n * Wraps RMMRegistry.getOrCreate + cleanup. Injects currentUserId from auth context.\n * Initial config is captured at first `getOrCreate`; a `useEffect` then calls\n * `syncRuntimeRoutingConfig` whenever routing/auth/conflict/CRDT semantics\n * change so reused instances stay aligned without remounting. `backpressure`\n * remains creation-time configuration for this low-level hook.\n */\n\nimport { useMemo, useEffect, useContext, useRef } from 'react';\nimport { RMMRegistryContext } from './RMMRegistryContext';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { ResourceMutationManagerConfig } from './types';\n\nexport type UseRMMConfig = Omit<ResourceMutationManagerConfig, 'resourceType' | 'resourceId' | 'currentUserId'>;\n\n/**\n * Local helper — not extracted to its own file because only this hook needs\n * raw registry access. If other hooks need it later, extract to a separate file.\n */\nfunction useRMMRegistry() {\n  const registry = useContext(RMMRegistryContext);\n  if (!registry) throw new Error('useResourceMutationManager must be used within RMMRegistryProvider');\n  return registry;\n}\n\nexport function useResourceMutationManager(\n  resourceType: string,\n  resourceId: string,\n  config: UseRMMConfig,\n): ResourceMutationManager {\n  const registry = useRMMRegistry();\n  const { user, primaryScopeInitiatorIds } = useUserOrgs();\n  const scopedUserId = primaryScopeInitiatorIds?.userId ?? null;\n  // Preserve the last known authenticated user id across transient auth-context\n  // dropouts so the reused RMM runtime keeps a stable self-event identity.\n  const lastKnownCurrentUserIdRef = useRef<string>('');\n  if (user?._id || scopedUserId) {\n    lastKnownCurrentUserIdRef.current = user?._id ?? scopedUserId!;\n  }\n  const currentUserId = user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;\n\n  const rmm = useMemo(\n    () => registry.getOrCreate(resourceType, resourceId, {\n      ...config,\n      resourceType,\n      resourceId,\n      currentUserId,\n      contextResourceIdentifiers: config.contextResourceIdentifiers ?? {},\n    }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- config is immutable after creation\n    [registry, resourceType, resourceId],\n  );\n\n  useEffect(() => {\n    return () => registry.release(registry.keyFor(resourceType, resourceId));\n  }, [registry, resourceType, resourceId]);\n\n  useEffect(() => {\n    rmm.syncRuntimeRoutingConfig({\n      transportAdapter: config.transportAdapter,\n      currentUserId,\n      contextResourceIdentifiers: config.contextResourceIdentifiers ?? {},\n      contextualParameters: { ...config.contextualParameters },\n      parentResourcesRequirements: config.parentResourcesRequirements,\n      operationPathKey: config.operationPathKey,\n      readOperationPathKey: config.readOperationPathKey,\n      conflictPolicy: config.conflictPolicy,\n      resourceSchema: config.resourceSchema,\n    });\n    registry.notifyInstanceRuntimeChanged();\n  }, [\n    registry,\n    rmm,\n    currentUserId,\n    config.contextResourceIdentifiers,\n    config.contextualParameters,\n    config.parentResourcesRequirements,\n    config.operationPathKey,\n    config.readOperationPathKey,\n    config.conflictPolicy,\n    config.resourceSchema,\n    config.transportAdapter,\n  ]);\n\n  return rmm;\n}\n"]}
+{"version":3,"file":"useResourceMutationManager.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceMutationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAM5E;;;GAGG;AACH,SAAS,cAAc;IACrB,MAAM,QAAQ,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACrG,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,YAAoB,EACpB,UAAkB,EAClB,MAAoB;IAEpB,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,GAAG,WAAW,EAAE,CAAC;IACzD,MAAM,YAAY,GAAG,wBAAwB,EAAE,MAAM,IAAI,IAAI,CAAC;IAC9D,8EAA8E;IAC9E,yEAAyE;IACzE,MAAM,yBAAyB,GAAG,MAAM,CAAS,EAAE,CAAC,CAAC;IACrD,IAAI,IAAI,EAAE,GAAG,IAAI,YAAY,EAAE,CAAC;QAC9B,yBAAyB,CAAC,OAAO,GAAG,IAAI,EAAE,GAAG,IAAI,YAAa,CAAC;IACjE,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,EAAE,GAAG,IAAI,YAAY,IAAI,yBAAyB,CAAC,OAAO,CAAC;IAErF,MAAM,GAAG,GAAG,OAAO,CACjB,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,EAAE;QACnD,GAAG,MAAM;QACT,YAAY;QACZ,UAAU;QACV,aAAa;QACb,0BAA0B,EAAE,MAAM,CAAC,0BAA0B,IAAI,EAAE;KACpE,CAAC;IACF,6FAA6F;IAC7F,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CACrC,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAC3E,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,wBAAwB,CAAC;YAC3B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,aAAa;YACb,0BAA0B,EAAE,MAAM,CAAC,0BAA0B,IAAI,EAAE;YACnE,oBAAoB,EAAE,EAAE,GAAG,MAAM,CAAC,oBAAoB,EAAE;YACxD,2BAA2B,EAAE,MAAM,CAAC,2BAA2B;YAC/D,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;YACjD,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;SAChD,CAAC,CAAC;QACH,QAAQ,CAAC,4BAA4B,EAAE,CAAC;IAC1C,CAAC,EAAE;QACD,QAAQ;QACR,GAAG;QACH,aAAa;QACb,MAAM,CAAC,0BAA0B;QACjC,MAAM,CAAC,oBAAoB;QAC3B,MAAM,CAAC,2BAA2B;QAClC,MAAM,CAAC,gBAAgB;QACvB,MAAM,CAAC,oBAAoB;QAC3B,MAAM,CAAC,cAAc;QACrB,MAAM,CAAC,cAAc;QACrB,MAAM,CAAC,mBAAmB;QAC1B,MAAM,CAAC,gBAAgB;KACxB,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["/**\n * useResourceMutationManager Hook\n *\n * Separated from RMMRegistryContext.tsx for React Fast Refresh compatibility.\n *\n * Wraps RMMRegistry.getOrCreate + cleanup. Injects currentUserId from auth context.\n * Initial config is captured at first `getOrCreate`; a `useEffect` then calls\n * `syncRuntimeRoutingConfig` whenever routing/auth/conflict/CRDT semantics\n * change so reused instances stay aligned without remounting. `backpressure`\n * remains creation-time configuration for this low-level hook.\n */\n\nimport { useMemo, useEffect, useContext, useRef } from 'react';\nimport { RMMRegistryContext } from './RMMRegistryContext';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { ResourceMutationManagerConfig } from './types';\n\nexport type UseRMMConfig = Omit<ResourceMutationManagerConfig, 'resourceType' | 'resourceId' | 'currentUserId'>;\n\n/**\n * Local helper — not extracted to its own file because only this hook needs\n * raw registry access. If other hooks need it later, extract to a separate file.\n */\nfunction useRMMRegistry() {\n  const registry = useContext(RMMRegistryContext);\n  if (!registry) throw new Error('useResourceMutationManager must be used within RMMRegistryProvider');\n  return registry;\n}\n\nexport function useResourceMutationManager(\n  resourceType: string,\n  resourceId: string,\n  config: UseRMMConfig,\n): ResourceMutationManager {\n  const registry = useRMMRegistry();\n  const { user, primaryScopeInitiatorIds } = useUserOrgs();\n  const scopedUserId = primaryScopeInitiatorIds?.userId ?? null;\n  // Preserve the last known authenticated user id across transient auth-context\n  // dropouts so the reused RMM runtime keeps a stable self-event identity.\n  const lastKnownCurrentUserIdRef = useRef<string>('');\n  if (user?._id || scopedUserId) {\n    lastKnownCurrentUserIdRef.current = user?._id ?? scopedUserId!;\n  }\n  const currentUserId = user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;\n\n  const rmm = useMemo(\n    () => registry.getOrCreate(resourceType, resourceId, {\n      ...config,\n      resourceType,\n      resourceId,\n      currentUserId,\n      contextResourceIdentifiers: config.contextResourceIdentifiers ?? {},\n    }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- config is immutable after creation\n    [registry, resourceType, resourceId],\n  );\n\n  useEffect(() => {\n    return () => registry.release(registry.keyFor(resourceType, resourceId));\n  }, [registry, resourceType, resourceId]);\n\n  useEffect(() => {\n    rmm.syncRuntimeRoutingConfig({\n      transportAdapter: config.transportAdapter,\n      currentUserId,\n      contextResourceIdentifiers: config.contextResourceIdentifiers ?? {},\n      contextualParameters: { ...config.contextualParameters },\n      parentResourcesRequirements: config.parentResourcesRequirements,\n      operationPathKey: config.operationPathKey,\n      readOperationPathKey: config.readOperationPathKey,\n      conflictPolicy: config.conflictPolicy,\n      resourceSchema: config.resourceSchema,\n      resourceInheritance: config.resourceInheritance,\n    });\n    registry.notifyInstanceRuntimeChanged();\n  }, [\n    registry,\n    rmm,\n    currentUserId,\n    config.contextResourceIdentifiers,\n    config.contextualParameters,\n    config.parentResourcesRequirements,\n    config.operationPathKey,\n    config.readOperationPathKey,\n    config.conflictPolicy,\n    config.resourceSchema,\n    config.resourceInheritance,\n    config.transportAdapter,\n  ]);\n\n  return rmm;\n}\n"]}

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

@@ -17,6 +17,8 @@ export interface UseResourceRMMConfig {
     parentResourcesRequirements?: unknown[];
     contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];
     resourceSchema?: unknown;
+    /** The resource's `inheritenceSchemaDefinition`, so a variant's CRDT fields are merge-tracked too (#2455). */
+    resourceInheritance?: unknown;
     /** When false, skip RMM entirely (e.g. non–UPDATE-like form or resource without UPDATE). */
     enabled?: boolean;
     conflictPolicy?: ConflictPolicy;

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;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"}
+{"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;AAatH,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,8GAA8G;IAC9G,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,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,CA0QjF"}