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

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

@@ -5,14 +5,22 @@
  * - Passes silent: true (Tier 3 — no loading events, Decision R16)
  * - Does NOT pass loading config (no LOADING_RESOURCE_START/END events)
  * - Sends If-Match header when expectedVersion is known (Phase 3.2)
- * - Disambiguates 409 errors: VERSION_CONFLICT → CONFLICT, other 409s → VALIDATION
+ * - Disambiguates 409 errors: VERSION_CONFLICT → CONFLICT; a 409 naming fields → VALIDATION; any other 409 → REFUSED
  * - Maps errors to OperationResult (httpStatus primary path, isWildoBackendError fallback)
  */
 import type { OperationPathIdentifier } from '../../../core/resources/ResourceRegistryContext';
 import type { ResourceOperationCallParameters } from '../../../core/requests/wildo-http-client-resources.frontend.service';
 import type { RequestOptions } from '../../../core/requests/wildo-http-client.frontend.service';
+import { MutationErrorType } from './types';
 import type { TransportAdapter, OperationDescriptor, OperationResult } from './types';
 export type DoOperationFn = <TResponse = any>(operationPath: OperationPathIdentifier, parameters: ResourceOperationCallParameters, options?: RequestOptions) => Promise<TResponse>;
+/**
+ * What a status the adapter maps no further means for the RMM. A 5xx is the server failing; 408, 425 and 429 ask the
+ * client to retry; any other 4xx is a refusal that sending the same request again cannot change (401, 403, 405, 413,
+ * 415, …). Before, every 4xx without its own case was TRANSIENT: a 403 was retried twice and then announced as a
+ * network problem.
+ */
+export declare function classifyUnmappedHttpStatus(status: number): MutationErrorType;
 export declare class HttpTransportAdapter implements TransportAdapter {
     private _doOperation;
     constructor(doOperation: DoOperationFn);

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

@@ -1 +1 @@
-{"version":3,"file":"HttpTransportAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/HttpTransportAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4DAA4D,CAAC;AAC1G,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,gFAAgF,CAAC;AACtI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sEAAsE,CAAC;AAG3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAiCtF,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,GAAG,GAAG,EAC1C,aAAa,EAAE,uBAAuB,EACtC,UAAU,EAAE,+BAA+B,EAC3C,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC,SAAS,CAAC,CAAC;AAMxB,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,YAAY,CAAgB;gBAExB,WAAW,EAAE,aAAa;IAIhC,OAAO,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAqDxE;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,cAAc;CA0JvB"}
+{"version":3,"file":"HttpTransportAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/HttpTransportAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4DAA4D,CAAC;AAC1G,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,gFAAgF,CAAC;AACtI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sEAAsE,CAAC;AAG3G,OAAO,EAAE,iBAAiB,EAAyB,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAkCtF,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,GAAG,GAAG,EAC1C,aAAa,EAAE,uBAAuB,EACtC,UAAU,EAAE,+BAA+B,EAC3C,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC,SAAS,CAAC,CAAC;AASxB;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAI5E;AAgBD,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,YAAY,CAAgB;gBAExB,WAAW,EAAE,aAAa;IAIhC,OAAO,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IA+DxE;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,cAAc;CA6IvB"}

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

@@ -5,15 +5,17 @@
  * - Passes silent: true (Tier 3 — no loading events, Decision R16)
  * - Does NOT pass loading config (no LOADING_RESOURCE_START/END events)
  * - Sends If-Match header when expectedVersion is known (Phase 3.2)
- * - Disambiguates 409 errors: VERSION_CONFLICT → CONFLICT, other 409s → VALIDATION
+ * - Disambiguates 409 errors: VERSION_CONFLICT → CONFLICT; a 409 naming fields → VALIDATION; any other 409 → REFUSED
  * - Maps errors to OperationResult (httpStatus primary path, isWildoBackendError fallback)
  */
 import { isWildoBackendError, WildoHeaderKeys, ErrorCustomMessageReference, VersionConflictDetailsSchema, describeCaughtError } from '@wildo-ai/saas-models';
+import { readOperationApprovalPending } from '@wildo-ai/saas-models';
 import { MutationErrorType, OperationResultStatus } from './types.js';
 import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
 import { isAbortOrCancelError } from '../../../core/requests/request-cancellation.frontend.utils.js';
 import { isNetworkOfflineRejection } from '../../../core/requests/offline-replay-policy.frontend.js';
 import { isApiNotReadyError } from '../../../core/requests/api-readiness-checker.frontend.service.js';
+import { AutomaticResendLadder, failedRequestMayBeResentAutomatically } from '../../../core/requests/automatic-resend-safety.frontend.js';
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('HttpTransportAdapter');
 logger.setDebugTypeLogging('HttpTransportAdapter', false);
@@ -38,6 +40,34 @@ function hasHttpStatus(error) {
 // =============================================================================
 // ADAPTER
 // =============================================================================
+/** The statuses that say "send it again later" (RFC 9110 §15.5.9 408; RFC 8470 425; RFC 6585 §4 429). */
+const RETRYABLE_CLIENT_STATUSES = new Set([408, 425, 429]);
+/**
+ * What a status the adapter maps no further means for the RMM. A 5xx is the server failing; 408, 425 and 429 ask the
+ * client to retry; any other 4xx is a refusal that sending the same request again cannot change (401, 403, 405, 413,
+ * 415, …). Before, every 4xx without its own case was TRANSIENT: a 403 was retried twice and then announced as a
+ * network problem.
+ */
+export function classifyUnmappedHttpStatus(status) {
+    if (status >= 500)
+        return MutationErrorType.SERVER;
+    if (status >= 400 && !RETRYABLE_CLIENT_STATUSES.has(status))
+        return MutationErrorType.REFUSED;
+    return MutationErrorType.TRANSIENT;
+}
+/**
+ * A 409 that is not a version conflict: the request conflicts with the resource's state (RFC 9110 §15.5.10). When the
+ * server names the fields it conflicts on (a value another record already holds), it is shown at those fields, like a
+ * 422, so it keeps them: it was classed VALIDATION and dropped them, so a form could not say which field was taken.
+ * Any other 409 (an action the record's state forbids) is a refusal that sending the same request again cannot change.
+ */
+function classifyStateConflict(error, status, message) {
+    const validationErrors = error?.validationErrors;
+    if (validationErrors !== null && typeof validationErrors === 'object' && Object.keys(validationErrors).length > 0) {
+        return { type: MutationErrorType.VALIDATION, status, validationErrors: validationErrors, message };
+    }
+    return { type: MutationErrorType.REFUSED, status, message };
+}
 export class HttpTransportAdapter {
     _doOperation;
     constructor(doOperation) {
@@ -67,6 +97,15 @@ export class HttpTransportAdapter {
                 silent: true,
                 headers: Object.keys(headers).length > 0 ? headers : undefined,
             });
+            // #2288: a held answer changed no row. It travels as its own result, never as the row's data. Read by its value
+            // alone: the transport is handed a path key, not the operation, and both halves of the shared predicate
+            // (`isOperationApprovalPendingAnswer`: the variant declares approval AND this answer is the pending contract) were
+            // already asked by the HTTP client, which validated this answer against the pending schema only when both held.
+            const heldForApproval = readOperationApprovalPending(response);
+            if (heldForApproval) {
+                logDebug('execute: held for approval', { decisionRef: heldForApproval.decisionRef });
+                return { status: OperationResultStatus.SUCCESS, heldForApproval };
+            }
             const responseData = response;
             const result = {
                 status: OperationResultStatus.SUCCESS,
@@ -96,6 +135,15 @@ export class HttpTransportAdapter {
         const result = this._classifyError(error);
         if (result.error) {
             result.error.cause = error;
+            // A failure the RMM would retry is retried only if sending it again cannot apply it twice (#3004). "Never sent" counts
+            // only where it is KNOWN: an offline rejection and the readiness gate's are classed TRANSIENT above and stay
+            // retryable. Every other failure is asked of the predicate, which answers `false` for one that carries no request:
+            // that includes a 2xx whose answer failed the response contract (#3004 review N1) — the server applied it.
+            if ((result.error.type === MutationErrorType.SERVER || result.error.type === MutationErrorType.TRANSIENT)
+                && !isNetworkOfflineRejection(error) && !isApiNotReadyError(error)) {
+                // A re-dispatch mints a new `Idempotency-Key`, so only the server's own statement can make it safe.
+                result.error.resendable = failedRequestMayBeResentAutomatically(error, AutomaticResendLadder.REDISPATCH);
+            }
         }
         return result;
     }
@@ -142,6 +190,7 @@ export class HttpTransportAdapter {
         if (httpStatus != null) {
             switch (httpStatus) {
                 case 400:
+                case 422:
                     return {
                         status: OperationResultStatus.ERROR,
                         error: {
@@ -152,6 +201,7 @@ export class HttpTransportAdapter {
                         },
                     };
                 case 404:
+                case 410:
                     return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.NOT_FOUND, status: httpStatus } };
                 case 409: {
                     const customRef = error?.customMessageReference;
@@ -176,27 +226,15 @@ export class HttpTransportAdapter {
                             },
                         };
                     }
-                    if (customRef) {
-                        return {
-                            status: OperationResultStatus.ERROR,
-                            error: { type: MutationErrorType.VALIDATION, status: httpStatus, message: error?.message ?? String(error) },
-                        };
-                    }
                     return {
                         status: OperationResultStatus.ERROR,
-                        error: { type: MutationErrorType.VALIDATION, status: httpStatus, message: error?.message ?? String(error) },
+                        error: classifyStateConflict(error, httpStatus, error?.message ?? String(error)),
                     };
                 }
                 default:
-                    if (httpStatus >= 500) {
-                        return {
-                            status: OperationResultStatus.ERROR,
-                            error: { type: MutationErrorType.SERVER, status: httpStatus, message: String(error) },
-                        };
-                    }
                     return {
                         status: OperationResultStatus.ERROR,
-                        error: { type: MutationErrorType.TRANSIENT, status: httpStatus, message: String(error) },
+                        error: { type: classifyUnmappedHttpStatus(httpStatus), status: httpStatus, message: String(error) },
                     };
             }
         }
@@ -205,10 +243,10 @@ export class HttpTransportAdapter {
             if (status >= 500) {
                 return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.SERVER, status, message: String(error) } };
             }
-            if (status === 400) {
+            if (status === 400 || status === 422) {
                 return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.VALIDATION, status, message: String(error) } };
             }
-            if (status === 404) {
+            if (status === 404 || status === 410) {
                 return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.NOT_FOUND, status } };
             }
             if (status === 409) {
@@ -233,12 +271,9 @@ export class HttpTransportAdapter {
                         },
                     };
                 }
-                if (error.customMessageReference) {
-                    return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.VALIDATION, status, message: String(error) } };
-                }
-                return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.VALIDATION, status, message: String(error) } };
+                return { status: OperationResultStatus.ERROR, error: classifyStateConflict(error, status, String(error)) };
             }
-            return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.TRANSIENT, status, message: String(error) } };
+            return { status: OperationResultStatus.ERROR, error: { type: classifyUnmappedHttpStatus(status), status, message: String(error) } };
         }
         return {
             status: OperationResultStatus.ERROR,

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

@@ -1 +1 @@
-{"version":3,"file":"HttpTransportAdapter.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/HttpTransportAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,2BAA2B,EAC3B,4BAA4B,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAOnF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,uEAAuE,CAAC;AAC7G,OAAO,EAAE,yBAAyB,EAAE,MAAM,kEAAkE,CAAC;AAC7G,OAAO,EAAE,kBAAkB,EAAE,MAAM,0EAA0E,CAAC;AAE9G,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,CAAC;AACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAC5D,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;AAE1D;;;GAGG;AACH,SAAS,6BAA6B,CAAC,KAAc;IACnD,MAAM,GAAG,GAAG,mBAAmB,CAAC,KAAK,CAAC;QACpC,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAE,KAA+C,CAAC,OAAO,CAAC;IAC7D,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,MAAM,MAAM,GAAG,4BAA4B,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,MAAM,CAAC,GAAI,KAAiC,CAAC,UAAU,CAAC;IACxD,OAAO,CAAC,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAYD,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,MAAM,OAAO,oBAAoB;IACvB,YAAY,CAAgB;IAEpC,YAAY,WAA0B;QACpC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAA+B;QAC3C,QAAQ,CAAC,SAAS,EAAE;YAClB,gBAAgB,EAAE,UAAU,CAAC,gBAAgB;YAC7C,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE;YACzE,eAAe,EAAE,UAAU,CAAC,eAAe;SAC5C,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,OAAO,GAA2B,EAAE,CAAC;YAC3C,IAAI,UAAU,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;gBACvC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,WAAW,GAAG,UAAU,CAAC,eAAe;gBAC5C,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,WAAW,EAAE,iBAAiB,EAAE,UAAU,CAAC,eAAe,EAAE;gBAC9E,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC;YAE3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CACtC,UAAU,CAAC,gBAAgB,EAC3B;gBACE,oBAAoB,EAAE,UAAU,CAAC,oBAAoB;gBACrD,WAAW;gBACX,2BAA2B,EAAE,UAAU,CAAC,2BAAkC;gBAC1E,QAAQ,EAAE,UAAU,CAAC,QAAQ;aAC9B,EACD;gBACE,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;aAC/D,CACF,CAAC;YAEF,MAAM,YAAY,GAAG,QAA+C,CAAC;YAErE,MAAM,MAAM,GAAoB;gBAC9B,MAAM,EAAE,qBAAqB,CAAC,OAAO;gBACrC,IAAI,EAAE,YAAY,IAAI,SAAS;gBAC/B,UAAU,EAAE,YAAY,EAAE,QAA8B;gBACxD,SAAS,EAAE,YAAY,EAAE,WAAyD;aACnF,CAAC;YACF,QAAQ,CAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YAChE,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACrC,QAAQ,CAAC,gBAAgB,EAAE;gBACzB,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI;gBAC7B,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM;gBACjC,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO;aACpC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,SAAS,CAAC,KAAc;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAC7B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,cAAc,CAAC,KAAc;QACnC,0EAA0E;QAC1E,kEAAkE;QAClE,kEAAkE;QAClE,0EAA0E;QAC1E,4EAA4E;QAC5E,4EAA4E;QAC5E,4EAA4E;QAC5E,8EAA8E;QAC9E,2EAA2E;QAC3E,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,EAAE,EAAE,CAAC;QAC3F,CAAC;QAED,+EAA+E;QAC/E,yEAAyE;QACzE,yEAAyE;QACzE,8EAA8E;QAC9E,2EAA2E;QAC3E,6EAA6E;QAC7E,0BAA0B;QAC1B,IAAI,yBAAyB,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO;gBACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;gBACnC,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;aACrE,CAAC;QACJ,CAAC;QAED,wEAAwE;QACxE,yEAAyE;QACzE,4EAA4E;QAC5E,0EAA0E;QAC1E,oEAAoE;QACpE,wEAAwE;QACxE,yEAAyE;QACzE,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;gBACnC,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;aACrE,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,QAAQ,UAAU,EAAE,CAAC;gBACnB,KAAK,GAAG;oBACN,OAAO;wBACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;wBACnC,KAAK,EAAE;4BACL,IAAI,EAAE,iBAAiB,CAAC,UAAU;4BAClC,MAAM,EAAE,UAAU;4BAClB,gBAAgB,EAAG,KAAa,CAAC,gBAAgB;4BACjD,OAAO,EAAG,KAAa,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC;yBACjD;qBACF,CAAC;gBACJ,KAAK,GAAG;oBACN,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;gBACnH,KAAK,GAAG,CAAC,CAAC,CAAC;oBACT,MAAM,SAAS,GAAI,KAAa,EAAE,sBAAsB,CAAC;oBACzD,IAAI,SAAS,KAAK,2BAA2B,CAAC,gBAAgB,EAAE,CAAC;wBAC/D,MAAM,eAAe,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;wBAC7D,IAAI,CAAC,eAAe,EAAE,CAAC;4BACrB,OAAO;gCACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;gCACnC,KAAK,EAAE;oCACL,IAAI,EAAE,iBAAiB,CAAC,MAAM;oCAC9B,MAAM,EAAE,UAAU;oCAClB,OAAO,EAAE,mEAAmE;iCAC7E;6BACF,CAAC;wBACJ,CAAC;wBACD,OAAO;4BACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;4BACnC,KAAK,EAAE;gCACL,IAAI,EAAE,iBAAiB,CAAC,QAAQ;gCAChC,MAAM,EAAE,UAAU;gCAClB,eAAe;6BAChB;yBACF,CAAC;oBACJ,CAAC;oBACD,IAAI,SAAS,EAAE,CAAC;wBACd,OAAO;4BACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;4BACnC,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAG,KAAa,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE;yBACrH,CAAC;oBACJ,CAAC;oBACD,OAAO;wBACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;wBACnC,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAG,KAAa,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE;qBACrH,CAAC;gBACJ,CAAC;gBACD;oBACE,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;wBACtB,OAAO;4BACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;4BACnC,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE;yBACtF,CAAC;oBACJ,CAAC;oBACD,OAAO;wBACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;wBACnC,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE;qBACzF,CAAC;YACN,CAAC;QACH,CAAC;QAED,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC;YAChC,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBAClB,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YAC5H,CAAC;YACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YAChI,CAAC;YACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;YACvG,CAAC;YACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,IAAI,KAAK,CAAC,sBAAsB,KAAK,2BAA2B,CAAC,gBAAgB,EAAE,CAAC;oBAClF,MAAM,eAAe,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;oBAC7D,IAAI,CAAC,eAAe,EAAE,CAAC;wBACrB,OAAO;4BACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;4BACnC,KAAK,EAAE;gCACL,IAAI,EAAE,iBAAiB,CAAC,MAAM;gCAC9B,MAAM;gCACN,OAAO,EAAE,mEAAmE;6BAC7E;yBACF,CAAC;oBACJ,CAAC;oBACD,OAAO;wBACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;wBACnC,KAAK,EAAE;4BACL,IAAI,EAAE,iBAAiB,CAAC,QAAQ;4BAChC,MAAM;4BACN,eAAe;yBAChB;qBACF,CAAC;gBACJ,CAAC;gBACD,IAAI,KAAK,CAAC,sBAAsB,EAAE,CAAC;oBACjC,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAChI,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YAChI,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QAC/H,CAAC;QAED,OAAO;YACL,MAAM,EAAE,qBAAqB,CAAC,KAAK;YACnC,KAAK,EAAE;gBACL,IAAI,EAAE,iBAAiB,CAAC,SAAS;gBACjC,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC;aACpC;SACF,CAAC;IACJ,CAAC;CACF","sourcesContent":["/**\n * HttpTransportAdapter — Production Implementation (Phase 1.3, updated Phase 3.2)\n *\n * Wraps the existing doOperation() from ResourceRegistryContext.\n * - Passes silent: true (Tier 3 — no loading events, Decision R16)\n * - Does NOT pass loading config (no LOADING_RESOURCE_START/END events)\n * - Sends If-Match header when expectedVersion is known (Phase 3.2)\n * - Disambiguates 409 errors: VERSION_CONFLICT → CONFLICT, other 409s → VALIDATION\n * - Maps errors to OperationResult (httpStatus primary path, isWildoBackendError fallback)\n */\n\nimport {\n  isWildoBackendError,\n  WildoHeaderKeys,\n  ErrorCustomMessageReference,\n  VersionConflictDetailsSchema, describeCaughtError } from '@wildo-ai/saas-models';\nimport type { MutationError } from './types';\nimport type { FieldMetaEntry } from '@wildo-ai/saas-models';\nimport type { OperationPathIdentifier } from '~wildo-frontend-lib/core/resources/ResourceRegistryContext';\nimport type { ResourceOperationCallParameters } from '~wildo-frontend-lib/core/requests/wildo-http-client-resources.frontend.service';\nimport type { RequestOptions } from '~wildo-frontend-lib/core/requests/wildo-http-client.frontend.service';\n\nimport { MutationErrorType, OperationResultStatus } from './types';\nimport type { TransportAdapter, OperationDescriptor, OperationResult } from './types';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { isAbortOrCancelError } from '~wildo-frontend-lib/core/requests/request-cancellation.frontend.utils';\nimport { isNetworkOfflineRejection } from '~wildo-frontend-lib/core/requests/offline-replay-policy.frontend';\nimport { isApiNotReadyError } from '~wildo-frontend-lib/core/requests/api-readiness-checker.frontend.service';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('HttpTransportAdapter');\nlogger.setDebugTypeLogging('HttpTransportAdapter', false);\n\n/**\n * Only the backend-authored nested `details.versionConflict` payload is treated\n * as authoritative conflict truth.\n */\nfunction extractVersionConflictDetails(error: unknown): MutationError['conflictDetails'] | undefined {\n  const ctx = isWildoBackendError(error)\n    ? error.context\n    : (error as { context?: Record<string, unknown> }).context;\n  if (!ctx || typeof ctx !== 'object') return undefined;\n  const rec = ctx as Record<string, unknown>;\n  const parsed = VersionConflictDetailsSchema.safeParse(rec.versionConflict);\n  return parsed.success ? parsed.data : undefined;\n}\n\nfunction hasHttpStatus(error: unknown): error is { httpStatus: number } {\n  const s = (error as { httpStatus?: number }).httpStatus;\n  return s != null && typeof s === 'number' && !Number.isNaN(s);\n}\n\n// =============================================================================\n// DO OPERATION TYPE (matches ResourceRegistryContext.doOperation)\n// =============================================================================\n\nexport type DoOperationFn = <TResponse = any>(\n  operationPath: OperationPathIdentifier,\n  parameters: ResourceOperationCallParameters,\n  options?: RequestOptions\n) => Promise<TResponse>;\n\n// =============================================================================\n// ADAPTER\n// =============================================================================\n\nexport class HttpTransportAdapter implements TransportAdapter {\n  private _doOperation: DoOperationFn;\n\n  constructor(doOperation: DoOperationFn) {\n    this._doOperation = doOperation;\n  }\n\n  async execute(descriptor: OperationDescriptor): Promise<OperationResult> {\n    logDebug('execute', {\n      operationPathKey: descriptor.operationPathKey,\n      fields: descriptor.requestData ? Object.keys(descriptor.requestData) : [],\n      expectedVersion: descriptor.expectedVersion,\n    });\n\n    try {\n      const headers: Record<string, string> = {};\n      if (descriptor.expectedVersion != null) {\n        headers[WildoHeaderKeys.IF_MATCH] = String(descriptor.expectedVersion);\n      }\n\n      const requestData = descriptor.fieldTimestamps\n        ? { ...descriptor.requestData, _field_timestamps: descriptor.fieldTimestamps }\n        : descriptor.requestData;\n\n      const response = await this._doOperation(\n        descriptor.operationPathKey,\n        {\n          contextualParameters: descriptor.contextualParameters,\n          requestData,\n          parentResourcesRequirements: descriptor.parentResourcesRequirements as any,\n          dataMode: descriptor.dataMode,\n        },\n        {\n          signal: descriptor.signal,\n          silent: true,\n          headers: Object.keys(headers).length > 0 ? headers : undefined,\n        }\n      );\n\n      const responseData = response as Record<string, unknown> | undefined;\n\n      const result: OperationResult = {\n        status: OperationResultStatus.SUCCESS,\n        data: responseData ?? undefined,\n        newVersion: responseData?._version as number | undefined,\n        fieldMeta: responseData?._field_meta as Record<string, FieldMetaEntry> | undefined,\n      };\n      logDebug('execute: success', { newVersion: result.newVersion });\n      return result;\n    } catch (error: unknown) {\n      const result = this._mapError(error);\n      logDebug('execute: error', {\n        errorType: result.error?.type,\n        errorStatus: result.error?.status,\n        errorMessage: result.error?.message,\n      });\n      return result;\n    }\n  }\n\n  /**\n   * Classifies a caught failure and keeps the failure itself on `error.cause`, so a surface that shows it can\n   * still reach the backend's reference and guidance — the classification alone cannot tell a 403 from a\n   * rejected payload (#1182).\n   */\n  private _mapError(error: unknown): OperationResult {\n    const result = this._classifyError(error);\n    if (result.error) {\n      result.error.cause = error;\n    }\n    return result;\n  }\n\n  private _classifyError(error: unknown): OperationResult {\n    // Intentional cancellation → ABORT (never a TRANSIENT/retryable failure).\n    // The transport is axios, which rejects an aborted request with a\n    // `CanceledError` (`__CANCEL__` / `code: 'ERR_CANCELED'` / `name:\n    // 'CanceledError'`) — NOT a DOM `AbortError`. The two `AbortError` checks\n    // below were therefore DEAD for this transport, so a superseded mutation or\n    // a backpressure-timeout abort fell through to the final `TRANSIENT` branch\n    // and looked like a retryable error. Recognise the axios cancel shape (same\n    // shape the HTTP-client interceptor and per-consumer guards use) and keep the\n    // DOM `AbortError` checks as defense-in-depth for any non-axios transport.\n    if (isAbortOrCancelError(error)) {\n      return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.ABORT } };\n    }\n\n    // Offline rejection (mutation issued while the device was offline, or a queued\n    // read that expired) → TRANSIENT so RMM's bounded transient-retry ladder\n    // (1s, 3s) gives a brief blip a chance to recover, then settles to ERROR\n    // rather than hot-looping. It is NOT a server/validation failure and must not\n    // be classified as one. (Step 3 of the network-resilience plan may promote\n    // this to a dedicated OFFLINE mutation type once the connectivity layer owns\n    // the offline banner UX.)\n    if (isNetworkOfflineRejection(error)) {\n      return {\n        status: OperationResultStatus.ERROR,\n        error: { type: MutationErrorType.TRANSIENT, message: error.message },\n      };\n    }\n\n    // Bounded readiness-gate rejection (`ApiNotReadyError`): the backend is\n    // unreachable and the HTTP client's readiness wait gave up. TRANSIENT so\n    // the RMM's bounded retry ladder gets its chance — and, because the wait is\n    // bounded, the ladder now actually EXHAUSTS instead of parking forever at\n    // the gate. Exhaustion then reverts optimistic state and surfaces a\n    // user-visible failure (audit B1/B2). This would also land in the final\n    // TRANSIENT fallback below; the explicit branch pins the classification.\n    if (isApiNotReadyError(error)) {\n      return {\n        status: OperationResultStatus.ERROR,\n        error: { type: MutationErrorType.TRANSIENT, message: error.message },\n      };\n    }\n\n    const httpStatus = hasHttpStatus(error) ? error.httpStatus : undefined;\n    if (httpStatus != null) {\n      switch (httpStatus) {\n        case 400:\n          return {\n            status: OperationResultStatus.ERROR,\n            error: {\n              type: MutationErrorType.VALIDATION,\n              status: httpStatus,\n              validationErrors: (error as any).validationErrors,\n              message: (error as any).message ?? String(error),\n            },\n          };\n        case 404:\n          return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.NOT_FOUND, status: httpStatus } };\n        case 409: {\n          const customRef = (error as any)?.customMessageReference;\n          if (customRef === ErrorCustomMessageReference.VERSION_CONFLICT) {\n            const conflictDetails = extractVersionConflictDetails(error);\n            if (!conflictDetails) {\n              return {\n                status: OperationResultStatus.ERROR,\n                error: {\n                  type: MutationErrorType.SERVER,\n                  status: httpStatus,\n                  message: 'Version conflict response missing authoritative conflict details.',\n                },\n              };\n            }\n            return {\n              status: OperationResultStatus.ERROR,\n              error: {\n                type: MutationErrorType.CONFLICT,\n                status: httpStatus,\n                conflictDetails,\n              },\n            };\n          }\n          if (customRef) {\n            return {\n              status: OperationResultStatus.ERROR,\n              error: { type: MutationErrorType.VALIDATION, status: httpStatus, message: (error as any)?.message ?? String(error) },\n            };\n          }\n          return {\n            status: OperationResultStatus.ERROR,\n            error: { type: MutationErrorType.VALIDATION, status: httpStatus, message: (error as any)?.message ?? String(error) },\n          };\n        }\n        default:\n          if (httpStatus >= 500) {\n            return {\n              status: OperationResultStatus.ERROR,\n              error: { type: MutationErrorType.SERVER, status: httpStatus, message: String(error) },\n            };\n          }\n          return {\n            status: OperationResultStatus.ERROR,\n            error: { type: MutationErrorType.TRANSIENT, status: httpStatus, message: String(error) },\n          };\n      }\n    }\n\n    if (isWildoBackendError(error)) {\n      const status = error.statusCode;\n      if (status >= 500) {\n        return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.SERVER, status, message: String(error) } };\n      }\n      if (status === 400) {\n        return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.VALIDATION, status, message: String(error) } };\n      }\n      if (status === 404) {\n        return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.NOT_FOUND, status } };\n      }\n      if (status === 409) {\n        if (error.customMessageReference === ErrorCustomMessageReference.VERSION_CONFLICT) {\n          const conflictDetails = extractVersionConflictDetails(error);\n          if (!conflictDetails) {\n            return {\n              status: OperationResultStatus.ERROR,\n              error: {\n                type: MutationErrorType.SERVER,\n                status,\n                message: 'Version conflict response missing authoritative conflict details.',\n              },\n            };\n          }\n          return {\n            status: OperationResultStatus.ERROR,\n            error: {\n              type: MutationErrorType.CONFLICT,\n              status,\n              conflictDetails,\n            },\n          };\n        }\n        if (error.customMessageReference) {\n          return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.VALIDATION, status, message: String(error) } };\n        }\n        return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.VALIDATION, status, message: String(error) } };\n      }\n      return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.TRANSIENT, status, message: String(error) } };\n    }\n\n    return {\n      status: OperationResultStatus.ERROR,\n      error: {\n        type: MutationErrorType.TRANSIENT,\n        message: describeCaughtError(error),\n      },\n    };\n  }\n}\n"]}
+{"version":3,"file":"HttpTransportAdapter.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/HttpTransportAdapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HttpTransportAdapter — Production Implementation (Phase 1.3, updated Phase 3.2)\n *\n * Wraps the existing doOperation() from ResourceRegistryContext.\n * - Passes silent: true (Tier 3 — no loading events, Decision R16)\n * - Does NOT pass loading config (no LOADING_RESOURCE_START/END events)\n * - Sends If-Match header when expectedVersion is known (Phase 3.2)\n * - Disambiguates 409 errors: VERSION_CONFLICT → CONFLICT; a 409 naming fields → VALIDATION; any other 409 → REFUSED\n * - Maps errors to OperationResult (httpStatus primary path, isWildoBackendError fallback)\n */\n\nimport {\n  isWildoBackendError,\n  WildoHeaderKeys,\n  ErrorCustomMessageReference,\n  VersionConflictDetailsSchema, describeCaughtError } from '@wildo-ai/saas-models';\nimport type { MutationError } from './types';\nimport type { FieldMetaEntry } from '@wildo-ai/saas-models';\nimport type { OperationPathIdentifier } from '~wildo-frontend-lib/core/resources/ResourceRegistryContext';\nimport type { ResourceOperationCallParameters } from '~wildo-frontend-lib/core/requests/wildo-http-client-resources.frontend.service';\nimport type { RequestOptions } from '~wildo-frontend-lib/core/requests/wildo-http-client.frontend.service';\n\nimport { readOperationApprovalPending } from '@wildo-ai/saas-models';\nimport { MutationErrorType, OperationResultStatus } from './types';\nimport type { TransportAdapter, OperationDescriptor, OperationResult } from './types';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { isAbortOrCancelError } from '~wildo-frontend-lib/core/requests/request-cancellation.frontend.utils';\nimport { isNetworkOfflineRejection } from '~wildo-frontend-lib/core/requests/offline-replay-policy.frontend';\nimport { isApiNotReadyError } from '~wildo-frontend-lib/core/requests/api-readiness-checker.frontend.service';\nimport { AutomaticResendLadder, failedRequestMayBeResentAutomatically } from '~wildo-frontend-lib/core/requests/automatic-resend-safety.frontend';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('HttpTransportAdapter');\nlogger.setDebugTypeLogging('HttpTransportAdapter', false);\n\n/**\n * Only the backend-authored nested `details.versionConflict` payload is treated\n * as authoritative conflict truth.\n */\nfunction extractVersionConflictDetails(error: unknown): MutationError['conflictDetails'] | undefined {\n  const ctx = isWildoBackendError(error)\n    ? error.context\n    : (error as { context?: Record<string, unknown> }).context;\n  if (!ctx || typeof ctx !== 'object') return undefined;\n  const rec = ctx as Record<string, unknown>;\n  const parsed = VersionConflictDetailsSchema.safeParse(rec.versionConflict);\n  return parsed.success ? parsed.data : undefined;\n}\n\nfunction hasHttpStatus(error: unknown): error is { httpStatus: number } {\n  const s = (error as { httpStatus?: number }).httpStatus;\n  return s != null && typeof s === 'number' && !Number.isNaN(s);\n}\n\n// =============================================================================\n// DO OPERATION TYPE (matches ResourceRegistryContext.doOperation)\n// =============================================================================\n\nexport type DoOperationFn = <TResponse = any>(\n  operationPath: OperationPathIdentifier,\n  parameters: ResourceOperationCallParameters,\n  options?: RequestOptions\n) => Promise<TResponse>;\n\n// =============================================================================\n// ADAPTER\n// =============================================================================\n\n/** The statuses that say \"send it again later\" (RFC 9110 §15.5.9 408; RFC 8470 425; RFC 6585 §4 429). */\nconst RETRYABLE_CLIENT_STATUSES: ReadonlySet<number> = new Set([408, 425, 429]);\n\n/**\n * What a status the adapter maps no further means for the RMM. A 5xx is the server failing; 408, 425 and 429 ask the\n * client to retry; any other 4xx is a refusal that sending the same request again cannot change (401, 403, 405, 413,\n * 415, …). Before, every 4xx without its own case was TRANSIENT: a 403 was retried twice and then announced as a\n * network problem.\n */\nexport function classifyUnmappedHttpStatus(status: number): MutationErrorType {\n  if (status >= 500) return MutationErrorType.SERVER;\n  if (status >= 400 && !RETRYABLE_CLIENT_STATUSES.has(status)) return MutationErrorType.REFUSED;\n  return MutationErrorType.TRANSIENT;\n}\n\n/**\n * A 409 that is not a version conflict: the request conflicts with the resource's state (RFC 9110 §15.5.10). When the\n * server names the fields it conflicts on (a value another record already holds), it is shown at those fields, like a\n * 422, so it keeps them: it was classed VALIDATION and dropped them, so a form could not say which field was taken.\n * Any other 409 (an action the record's state forbids) is a refusal that sending the same request again cannot change.\n */\nfunction classifyStateConflict(error: unknown, status: number, message: string): MutationError {\n  const validationErrors = (error as { validationErrors?: unknown } | null)?.validationErrors;\n  if (validationErrors !== null && typeof validationErrors === 'object' && Object.keys(validationErrors).length > 0) {\n    return { type: MutationErrorType.VALIDATION, status, validationErrors: validationErrors as Record<string, unknown>, message };\n  }\n  return { type: MutationErrorType.REFUSED, status, message };\n}\n\nexport class HttpTransportAdapter implements TransportAdapter {\n  private _doOperation: DoOperationFn;\n\n  constructor(doOperation: DoOperationFn) {\n    this._doOperation = doOperation;\n  }\n\n  async execute(descriptor: OperationDescriptor): Promise<OperationResult> {\n    logDebug('execute', {\n      operationPathKey: descriptor.operationPathKey,\n      fields: descriptor.requestData ? Object.keys(descriptor.requestData) : [],\n      expectedVersion: descriptor.expectedVersion,\n    });\n\n    try {\n      const headers: Record<string, string> = {};\n      if (descriptor.expectedVersion != null) {\n        headers[WildoHeaderKeys.IF_MATCH] = String(descriptor.expectedVersion);\n      }\n\n      const requestData = descriptor.fieldTimestamps\n        ? { ...descriptor.requestData, _field_timestamps: descriptor.fieldTimestamps }\n        : descriptor.requestData;\n\n      const response = await this._doOperation(\n        descriptor.operationPathKey,\n        {\n          contextualParameters: descriptor.contextualParameters,\n          requestData,\n          parentResourcesRequirements: descriptor.parentResourcesRequirements as any,\n          dataMode: descriptor.dataMode,\n        },\n        {\n          signal: descriptor.signal,\n          silent: true,\n          headers: Object.keys(headers).length > 0 ? headers : undefined,\n        }\n      );\n\n      // #2288: a held answer changed no row. It travels as its own result, never as the row's data. Read by its value\n      // alone: the transport is handed a path key, not the operation, and both halves of the shared predicate\n      // (`isOperationApprovalPendingAnswer`: the variant declares approval AND this answer is the pending contract) were\n      // already asked by the HTTP client, which validated this answer against the pending schema only when both held.\n      const heldForApproval = readOperationApprovalPending(response);\n      if (heldForApproval) {\n        logDebug('execute: held for approval', { decisionRef: heldForApproval.decisionRef });\n        return { status: OperationResultStatus.SUCCESS, heldForApproval };\n      }\n\n      const responseData = response as Record<string, unknown> | undefined;\n\n      const result: OperationResult = {\n        status: OperationResultStatus.SUCCESS,\n        data: responseData ?? undefined,\n        newVersion: responseData?._version as number | undefined,\n        fieldMeta: responseData?._field_meta as Record<string, FieldMetaEntry> | undefined,\n      };\n      logDebug('execute: success', { newVersion: result.newVersion });\n      return result;\n    } catch (error: unknown) {\n      const result = this._mapError(error);\n      logDebug('execute: error', {\n        errorType: result.error?.type,\n        errorStatus: result.error?.status,\n        errorMessage: result.error?.message,\n      });\n      return result;\n    }\n  }\n\n  /**\n   * Classifies a caught failure and keeps the failure itself on `error.cause`, so a surface that shows it can\n   * still reach the backend's reference and guidance — the classification alone cannot tell a 403 from a\n   * rejected payload (#1182).\n   */\n  private _mapError(error: unknown): OperationResult {\n    const result = this._classifyError(error);\n    if (result.error) {\n      result.error.cause = error;\n      // A failure the RMM would retry is retried only if sending it again cannot apply it twice (#3004). \"Never sent\" counts\n      // only where it is KNOWN: an offline rejection and the readiness gate's are classed TRANSIENT above and stay\n      // retryable. Every other failure is asked of the predicate, which answers `false` for one that carries no request:\n      // that includes a 2xx whose answer failed the response contract (#3004 review N1) — the server applied it.\n      if ((result.error.type === MutationErrorType.SERVER || result.error.type === MutationErrorType.TRANSIENT)\n        && !isNetworkOfflineRejection(error) && !isApiNotReadyError(error)) {\n        // A re-dispatch mints a new `Idempotency-Key`, so only the server's own statement can make it safe.\n        result.error.resendable = failedRequestMayBeResentAutomatically(error, AutomaticResendLadder.REDISPATCH);\n      }\n    }\n    return result;\n  }\n\n  private _classifyError(error: unknown): OperationResult {\n    // Intentional cancellation → ABORT (never a TRANSIENT/retryable failure).\n    // The transport is axios, which rejects an aborted request with a\n    // `CanceledError` (`__CANCEL__` / `code: 'ERR_CANCELED'` / `name:\n    // 'CanceledError'`) — NOT a DOM `AbortError`. The two `AbortError` checks\n    // below were therefore DEAD for this transport, so a superseded mutation or\n    // a backpressure-timeout abort fell through to the final `TRANSIENT` branch\n    // and looked like a retryable error. Recognise the axios cancel shape (same\n    // shape the HTTP-client interceptor and per-consumer guards use) and keep the\n    // DOM `AbortError` checks as defense-in-depth for any non-axios transport.\n    if (isAbortOrCancelError(error)) {\n      return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.ABORT } };\n    }\n\n    // Offline rejection (mutation issued while the device was offline, or a queued\n    // read that expired) → TRANSIENT so RMM's bounded transient-retry ladder\n    // (1s, 3s) gives a brief blip a chance to recover, then settles to ERROR\n    // rather than hot-looping. It is NOT a server/validation failure and must not\n    // be classified as one. (Step 3 of the network-resilience plan may promote\n    // this to a dedicated OFFLINE mutation type once the connectivity layer owns\n    // the offline banner UX.)\n    if (isNetworkOfflineRejection(error)) {\n      return {\n        status: OperationResultStatus.ERROR,\n        error: { type: MutationErrorType.TRANSIENT, message: error.message },\n      };\n    }\n\n    // Bounded readiness-gate rejection (`ApiNotReadyError`): the backend is\n    // unreachable and the HTTP client's readiness wait gave up. TRANSIENT so\n    // the RMM's bounded retry ladder gets its chance — and, because the wait is\n    // bounded, the ladder now actually EXHAUSTS instead of parking forever at\n    // the gate. Exhaustion then reverts optimistic state and surfaces a\n    // user-visible failure (audit B1/B2). This would also land in the final\n    // TRANSIENT fallback below; the explicit branch pins the classification.\n    if (isApiNotReadyError(error)) {\n      return {\n        status: OperationResultStatus.ERROR,\n        error: { type: MutationErrorType.TRANSIENT, message: error.message },\n      };\n    }\n\n    const httpStatus = hasHttpStatus(error) ? error.httpStatus : undefined;\n    if (httpStatus != null) {\n      switch (httpStatus) {\n        case 400:\n        case 422:\n          return {\n            status: OperationResultStatus.ERROR,\n            error: {\n              type: MutationErrorType.VALIDATION,\n              status: httpStatus,\n              validationErrors: (error as any).validationErrors,\n              message: (error as any).message ?? String(error),\n            },\n          };\n        case 404:\n        case 410:\n          return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.NOT_FOUND, status: httpStatus } };\n        case 409: {\n          const customRef = (error as any)?.customMessageReference;\n          if (customRef === ErrorCustomMessageReference.VERSION_CONFLICT) {\n            const conflictDetails = extractVersionConflictDetails(error);\n            if (!conflictDetails) {\n              return {\n                status: OperationResultStatus.ERROR,\n                error: {\n                  type: MutationErrorType.SERVER,\n                  status: httpStatus,\n                  message: 'Version conflict response missing authoritative conflict details.',\n                },\n              };\n            }\n            return {\n              status: OperationResultStatus.ERROR,\n              error: {\n                type: MutationErrorType.CONFLICT,\n                status: httpStatus,\n                conflictDetails,\n              },\n            };\n          }\n          return {\n            status: OperationResultStatus.ERROR,\n            error: classifyStateConflict(error, httpStatus, (error as any)?.message ?? String(error)),\n          };\n        }\n        default:\n          return {\n            status: OperationResultStatus.ERROR,\n            error: { type: classifyUnmappedHttpStatus(httpStatus), status: httpStatus, message: String(error) },\n          };\n      }\n    }\n\n    if (isWildoBackendError(error)) {\n      const status = error.statusCode;\n      if (status >= 500) {\n        return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.SERVER, status, message: String(error) } };\n      }\n      if (status === 400 || status === 422) {\n        return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.VALIDATION, status, message: String(error) } };\n      }\n      if (status === 404 || status === 410) {\n        return { status: OperationResultStatus.ERROR, error: { type: MutationErrorType.NOT_FOUND, status } };\n      }\n      if (status === 409) {\n        if (error.customMessageReference === ErrorCustomMessageReference.VERSION_CONFLICT) {\n          const conflictDetails = extractVersionConflictDetails(error);\n          if (!conflictDetails) {\n            return {\n              status: OperationResultStatus.ERROR,\n              error: {\n                type: MutationErrorType.SERVER,\n                status,\n                message: 'Version conflict response missing authoritative conflict details.',\n              },\n            };\n          }\n          return {\n            status: OperationResultStatus.ERROR,\n            error: {\n              type: MutationErrorType.CONFLICT,\n              status,\n              conflictDetails,\n            },\n          };\n        }\n        return { status: OperationResultStatus.ERROR, error: classifyStateConflict(error, status, String(error)) };\n      }\n      return { status: OperationResultStatus.ERROR, error: { type: classifyUnmappedHttpStatus(status), status, message: String(error) } };\n    }\n\n    return {\n      status: OperationResultStatus.ERROR,\n      error: {\n        type: MutationErrorType.TRANSIENT,\n        message: describeCaughtError(error),\n      },\n    };\n  }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"RMMRegistry.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/RMMRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAY7D,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAWD,KAAK,uBAAuB,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,uBAAuB,CAAA;CAAE,CAAC,CAAC;AAE9H,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,wBAAwB,CAA2D;IAC3F;;;;;OAKG;IACH,OAAO,CAAC,6BAA6B,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,YAAY,CAAa;gBAErB,OAAO,CAAC,EAAE,kBAAkB;IAKxC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASpC,WAAW,CACT,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,6BAA6B,GACpC,uBAAuB;IAoF1B,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAIlF;;;OAGG;IACH,kBAAkB,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,uBAAuB,CAAA;KAAE,CAAC;IAcpH,wBAAwB,CACtB,QAAQ,EAAE,CAAC,SAAS,EAAE,uBAAuB,KAAK,IAAI,GACrD,MAAM,IAAI;IAQb,4BAA4B,IAAI,IAAI;IAIpC,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAIxD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IA4B1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAazB,OAAO,IAAI,IAAI;IAef;;;;OAIG;IACH,OAAO,CAAC,cAAc;IA+BtB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,2BAA2B;CAmBpC"}
+{"version":3,"file":"RMMRegistry.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/RMMRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAY7D,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAWD,KAAK,uBAAuB,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,uBAAuB,CAAA;CAAE,CAAC,CAAC;AAE9H,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,wBAAwB,CAA2D;IAC3F;;;;;OAKG;IACH,OAAO,CAAC,6BAA6B,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,YAAY,CAAa;gBAErB,OAAO,CAAC,EAAE,kBAAkB;IAKxC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASpC,WAAW,CACT,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,6BAA6B,GACpC,uBAAuB;IAqF1B,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAIlF;;;OAGG;IACH,kBAAkB,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,uBAAuB,CAAA;KAAE,CAAC;IAcpH,wBAAwB,CACtB,QAAQ,EAAE,CAAC,SAAS,EAAE,uBAAuB,KAAK,IAAI,GACrD,MAAM,IAAI;IAQb,4BAA4B,IAAI,IAAI;IAIpC,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAIxD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IA4B1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAazB,OAAO,IAAI,IAAI;IAef;;;;OAIG;IACH,OAAO,CAAC,cAAc;IA+BtB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,2BAA2B;CAmBpC"}

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

@@ -74,6 +74,7 @@ export class RMMRegistry {
                 readOperationPathKey: config.readOperationPathKey,
                 conflictPolicy: config.conflictPolicy,
                 resourceSchema: config.resourceSchema,
+                resourceInheritance: config.resourceInheritance,
             });
             // Registry identity is resourceType + resourceId, not route instance. A
             // reused RMM therefore has to resync transport/context/read-path inputs on

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

@@ -1 +1 @@
-{"version":3,"file":"RMMRegistry.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/RMMRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * RMMRegistry — Global singleton managing RMM instances with ref counting.\n *\n * Pure TypeScript (no React). Instances are keyed by `${resourceType}:${resourceId}`.\n * Ref counting + deferred destruction (100ms) ensures React Strict Mode safety:\n * unmount→remount within the same tick reuses the existing instance.\n *\n * LRU eviction at capacity targets idle instances (refCount === 0) first.\n * Active instances are never evicted — the limit is soft.\n */\n\nimport { ResourceMutationManager } from './ResourceMutationManager';\nimport type { ResourceMutationManagerConfig } from './types';\nimport {\n  RMM_REGISTRY_CAPACITY_WARNING,\n  RMM_REGISTRY_DESTROY_DELAY_MS,\n  RMM_REGISTRY_MAX_INSTANCES,\n} from './rmm-constants';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('RMMRegistry');\nlogger.setDebugTypeLogging('RMMRegistry', false);\n\nexport interface RMMRegistryOptions {\n  maxInstances?: number;\n}\n\ninterface RegistryEntry {\n  rmm: ResourceMutationManager;\n  refCount: number;\n  destroyTimer: ReturnType<typeof setTimeout> | null;\n  lastAccessedAt: number;\n  /** Set when the async destroy() sequence has started. Prevents reuse of a half-destroyed RMM. */\n  destroying: boolean;\n}\n\ntype ActiveInstancesSnapshot = Array<{ key: string; resourceType: string; resourceId: string; rmm: ResourceMutationManager }>;\n\nexport class RMMRegistry {\n  private _instances: Map<string, RegistryEntry> = new Map();\n  private _activeInstanceListeners = new Set<(instances: ActiveInstancesSnapshot) => void>();\n  /**\n   * Coalescing flag for the deferred active-instance notification. See\n   * `_emitActiveInstancesChanged` — notifications are flushed on a microtask so\n   * a render-phase caller (`getOrCreate` inside `useResourceRMM`'s `useMemo`)\n   * can never drive an observer's `setState` during render.\n   */\n  private _activeInstancesEmitScheduled = false;\n  private readonly MAX_INSTANCES: number;\n  private _clockOffset: number = 0;\n\n  constructor(options?: RMMRegistryOptions) {\n    this.MAX_INSTANCES = options?.maxInstances ?? RMM_REGISTRY_MAX_INSTANCES;\n    logDebug('constructor', { maxInstances: this.MAX_INSTANCES });\n  }\n\n  get clockOffset(): number {\n    return this._clockOffset;\n  }\n\n  /**\n   * Sets the clock offset and propagates it to all active RMM instances.\n   * Called by the calibration effect in RMMRegistryProvider.\n   */\n  setClockOffset(offset: number): void {\n    this._clockOffset = offset;\n    for (const [, entry] of this._instances) {\n      if (entry.refCount > 0 && !entry.destroying) {\n        entry.rmm.clockOffset = offset;\n      }\n    }\n  }\n\n  getOrCreate(\n    resourceType: string,\n    resourceId: string,\n    config: ResourceMutationManagerConfig,\n  ): ResourceMutationManager {\n    const key = this.keyFor(resourceType, resourceId);\n    const existing = this._instances.get(key);\n\n    if (existing && !existing.destroying) {\n      if (existing.destroyTimer) {\n        clearTimeout(existing.destroyTimer);\n        existing.destroyTimer = null;\n        logDebug('getOrCreate: cancelled pending destroy', { key });\n      }\n      const previousReadOperationPathKey = existing.rmm.readOperationPathKey;\n      if (\n        config.readOperationPathKey !== undefined\n        && previousReadOperationPathKey !== undefined\n        && config.readOperationPathKey !== previousReadOperationPathKey\n      ) {\n        logger.warn('RMMRegistry updating canonical read path on reused instance', {\n          key,\n          previousReadOperationPathKey,\n          nextReadOperationPathKey: config.readOperationPathKey,\n        });\n      }\n      existing.rmm.syncRuntimeRoutingConfig({\n        transportAdapter: config.transportAdapter,\n        currentUserId: config.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 identity is resourceType + resourceId, not route instance. A\n      // reused RMM therefore has to resync transport/context/read-path inputs on\n      // every acquisition so navigation changes do not leave a live instance on\n      // stale runtime routing.\n      existing.refCount++;\n      existing.lastAccessedAt = Date.now();\n\n      logDebug('getOrCreate: reused', {\n        key,\n        refCount: existing.refCount,\n      });\n\n      this._emitActiveInstancesChanged();\n      return existing.rmm;\n    }\n\n    if (existing?.destroying) {\n      logDebug('getOrCreate: old instance mid-destroy, replacing', { key });\n      this._instances.delete(key);\n    }\n\n    this._evictIfNeeded();\n\n    const rmm = new ResourceMutationManager(config);\n    if (this._clockOffset !== 0) {\n      rmm.clockOffset = this._clockOffset;\n    }\n    this._instances.set(key, {\n      rmm,\n      refCount: 1,\n      destroyTimer: null,\n      lastAccessedAt: Date.now(),\n      destroying: false,\n    });\n\n    logDebug('getOrCreate: created', {\n      key,\n      instanceCount: this._instances.size,\n    });\n\n    if (this._instances.size >= this.MAX_INSTANCES * RMM_REGISTRY_CAPACITY_WARNING) {\n      logger.warn('RMMRegistry approaching capacity', {\n        current: this._instances.size,\n        max: this.MAX_INSTANCES,\n      });\n    }\n\n    this._emitActiveInstancesChanged();\n    return rmm;\n  }\n\n  get(resourceType: string, resourceId: string): ResourceMutationManager | undefined {\n    return this._instances.get(this.keyFor(resourceType, resourceId))?.rmm;\n  }\n\n  /**\n   * Returns all active (refCount > 0, not mid-destroy) RMM instances.\n   * Used by RMMWebSocketBridge for reconnection version sync.\n   */\n  getActiveInstances(): Array<{ key: string; resourceType: string; resourceId: string; rmm: ResourceMutationManager }> {\n    const active: ActiveInstancesSnapshot = [];\n    for (const [key, entry] of this._instances) {\n      if (entry.refCount > 0 && !entry.destroying) {\n        const colonIdx = key.indexOf(':');\n        if (colonIdx < 0) continue;\n        const resourceType = key.substring(0, colonIdx);\n        const resourceId = key.substring(colonIdx + 1);\n        active.push({ key, resourceType, resourceId, rmm: entry.rmm });\n      }\n    }\n    return active;\n  }\n\n  subscribeActiveInstances(\n    listener: (instances: ActiveInstancesSnapshot) => void,\n  ): () => void {\n    this._activeInstanceListeners.add(listener);\n    listener(this.getActiveInstances());\n    return () => {\n      this._activeInstanceListeners.delete(listener);\n    };\n  }\n\n  notifyInstanceRuntimeChanged(): void {\n    this._emitActiveInstancesChanged();\n  }\n\n  keyFor(resourceType: string, resourceId: string): string {\n    return `${resourceType}:${resourceId}`;\n  }\n\n  release(key: string): void {\n    const entry = this._instances.get(key);\n    if (!entry) return;\n\n    entry.refCount--;\n\n    logDebug('release', { key, refCount: entry.refCount });\n\n    if (entry.refCount <= 0) {\n      entry.refCount = 0;\n      if (!entry.destroyTimer) {\n        entry.destroyTimer = setTimeout(() => {\n          entry.destroyTimer = null;\n          entry.destroying = true;\n          logDebug('release: destroy timer fired', { key });\n\n          entry.rmm.destroy()\n            .then(() => this.remove(key))\n            .catch(() => {\n              logDebug('release: destroy failed, force-removing', { key });\n              this.remove(key);\n            });\n        }, RMM_REGISTRY_DESTROY_DELAY_MS);\n      }\n    }\n    this._emitActiveInstancesChanged();\n  }\n\n  remove(key: string): void {\n    const entry = this._instances.get(key);\n    if (!entry) return;\n\n    if (entry.destroyTimer) {\n      clearTimeout(entry.destroyTimer);\n    }\n    this._instances.delete(key);\n\n    logDebug('remove', { key, remainingInstances: this._instances.size });\n    this._emitActiveInstancesChanged();\n  }\n\n  destroy(): void {\n    logDebug('destroy: cleaning up all instances', { count: this._instances.size });\n\n    for (const [key, entry] of this._instances) {\n      if (entry.destroyTimer) {\n        clearTimeout(entry.destroyTimer);\n      }\n      entry.rmm.destroy().catch(() => {\n        logDebug('destroy: instance cleanup failed', { key });\n      });\n    }\n    this._instances.clear();\n    this._emitActiveInstancesChanged();\n  }\n\n  /**\n   * Evict the least-recently-used idle instance when at capacity.\n   * Only entries with refCount === 0 are eligible. If no evictable entry\n   * exists, log a warning but allow creation (soft limit).\n   */\n  private _evictIfNeeded(): void {\n    if (this._instances.size < this.MAX_INSTANCES) return;\n\n    let lruKey: string | null = null;\n    let lruTime = Infinity;\n\n    for (const [key, entry] of this._instances) {\n      if (entry.refCount === 0 && entry.lastAccessedAt < lruTime) {\n        lruKey = key;\n        lruTime = entry.lastAccessedAt;\n      }\n    }\n\n    if (lruKey) {\n      const entry = this._instances.get(lruKey)!;\n      if (entry.destroyTimer) {\n        clearTimeout(entry.destroyTimer);\n      }\n      logDebug('_evictIfNeeded: evicting LRU', { key: lruKey, lastAccessedAt: lruTime });\n      entry.rmm.destroy().catch(() => {\n        logDebug('_evictIfNeeded: eviction cleanup failed', { key: lruKey });\n      });\n      this._instances.delete(lruKey);\n    } else {\n      logger.warn('RMMRegistry at capacity with no idle instances to evict', {\n        instanceCount: this._instances.size,\n        maxInstances: this.MAX_INSTANCES,\n      });\n    }\n  }\n\n  /**\n   * Notify active-instance observers (today: `RMMWebSocketBridge`) that the live\n   * RMM set — or an instance's runtime routing — changed.\n   *\n   * The notification is intentionally **deferred to a microtask**, never run\n   * synchronously. The main caller, `getOrCreate`, is invoked from inside a React\n   * `useMemo` in `useResourceRMM` — i.e. during the *render phase*. The bridge\n   * observer reacts by claiming/releasing WebSocket rooms, which calls\n   * `setSubscribedRooms` on the ancestor `WebSocketProvider`. Running that\n   * synchronously is a `setState` on an ancestor *during a descendant's render*\n   * — React's \"Cannot update a component while rendering a different component\"\n   * violation, and the closing edge of a paced render loop that froze any surface\n   * embedding an RMM-attached displayer (the todos CREATE route, which embeds a\n   * composite read view, 2026-06-27). Deferring to a microtask moves the observer\n   * side effects out of render, breaking the loop regardless of which upstream\n   * dependency churns the acquiring memo.\n   *\n   * Emits are coalesced: many calls within one synchronous task (e.g. several\n   * displayers acquiring instances in the same render pass) collapse into a\n   * single post-task notification carrying the latest snapshot. The initial,\n   * non-render-phase sync is still delivered synchronously by\n   * `subscribeActiveInstances` at subscription time.\n   */\n  private _emitActiveInstancesChanged(): void {\n    if (this._activeInstanceListeners.size === 0) {\n      return;\n    }\n    if (this._activeInstancesEmitScheduled) {\n      return;\n    }\n    this._activeInstancesEmitScheduled = true;\n    queueMicrotask(() => {\n      this._activeInstancesEmitScheduled = false;\n      if (this._activeInstanceListeners.size === 0) {\n        return;\n      }\n      const snapshot = this.getActiveInstances();\n      for (const listener of this._activeInstanceListeners) {\n        listener(snapshot);\n      }\n    });\n  }\n}\n"]}
+{"version":3,"file":"RMMRegistry.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/RMMRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * RMMRegistry — Global singleton managing RMM instances with ref counting.\n *\n * Pure TypeScript (no React). Instances are keyed by `${resourceType}:${resourceId}`.\n * Ref counting + deferred destruction (100ms) ensures React Strict Mode safety:\n * unmount→remount within the same tick reuses the existing instance.\n *\n * LRU eviction at capacity targets idle instances (refCount === 0) first.\n * Active instances are never evicted — the limit is soft.\n */\n\nimport { ResourceMutationManager } from './ResourceMutationManager';\nimport type { ResourceMutationManagerConfig } from './types';\nimport {\n  RMM_REGISTRY_CAPACITY_WARNING,\n  RMM_REGISTRY_DESTROY_DELAY_MS,\n  RMM_REGISTRY_MAX_INSTANCES,\n} from './rmm-constants';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('RMMRegistry');\nlogger.setDebugTypeLogging('RMMRegistry', false);\n\nexport interface RMMRegistryOptions {\n  maxInstances?: number;\n}\n\ninterface RegistryEntry {\n  rmm: ResourceMutationManager;\n  refCount: number;\n  destroyTimer: ReturnType<typeof setTimeout> | null;\n  lastAccessedAt: number;\n  /** Set when the async destroy() sequence has started. Prevents reuse of a half-destroyed RMM. */\n  destroying: boolean;\n}\n\ntype ActiveInstancesSnapshot = Array<{ key: string; resourceType: string; resourceId: string; rmm: ResourceMutationManager }>;\n\nexport class RMMRegistry {\n  private _instances: Map<string, RegistryEntry> = new Map();\n  private _activeInstanceListeners = new Set<(instances: ActiveInstancesSnapshot) => void>();\n  /**\n   * Coalescing flag for the deferred active-instance notification. See\n   * `_emitActiveInstancesChanged` — notifications are flushed on a microtask so\n   * a render-phase caller (`getOrCreate` inside `useResourceRMM`'s `useMemo`)\n   * can never drive an observer's `setState` during render.\n   */\n  private _activeInstancesEmitScheduled = false;\n  private readonly MAX_INSTANCES: number;\n  private _clockOffset: number = 0;\n\n  constructor(options?: RMMRegistryOptions) {\n    this.MAX_INSTANCES = options?.maxInstances ?? RMM_REGISTRY_MAX_INSTANCES;\n    logDebug('constructor', { maxInstances: this.MAX_INSTANCES });\n  }\n\n  get clockOffset(): number {\n    return this._clockOffset;\n  }\n\n  /**\n   * Sets the clock offset and propagates it to all active RMM instances.\n   * Called by the calibration effect in RMMRegistryProvider.\n   */\n  setClockOffset(offset: number): void {\n    this._clockOffset = offset;\n    for (const [, entry] of this._instances) {\n      if (entry.refCount > 0 && !entry.destroying) {\n        entry.rmm.clockOffset = offset;\n      }\n    }\n  }\n\n  getOrCreate(\n    resourceType: string,\n    resourceId: string,\n    config: ResourceMutationManagerConfig,\n  ): ResourceMutationManager {\n    const key = this.keyFor(resourceType, resourceId);\n    const existing = this._instances.get(key);\n\n    if (existing && !existing.destroying) {\n      if (existing.destroyTimer) {\n        clearTimeout(existing.destroyTimer);\n        existing.destroyTimer = null;\n        logDebug('getOrCreate: cancelled pending destroy', { key });\n      }\n      const previousReadOperationPathKey = existing.rmm.readOperationPathKey;\n      if (\n        config.readOperationPathKey !== undefined\n        && previousReadOperationPathKey !== undefined\n        && config.readOperationPathKey !== previousReadOperationPathKey\n      ) {\n        logger.warn('RMMRegistry updating canonical read path on reused instance', {\n          key,\n          previousReadOperationPathKey,\n          nextReadOperationPathKey: config.readOperationPathKey,\n        });\n      }\n      existing.rmm.syncRuntimeRoutingConfig({\n        transportAdapter: config.transportAdapter,\n        currentUserId: config.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 identity is resourceType + resourceId, not route instance. A\n      // reused RMM therefore has to resync transport/context/read-path inputs on\n      // every acquisition so navigation changes do not leave a live instance on\n      // stale runtime routing.\n      existing.refCount++;\n      existing.lastAccessedAt = Date.now();\n\n      logDebug('getOrCreate: reused', {\n        key,\n        refCount: existing.refCount,\n      });\n\n      this._emitActiveInstancesChanged();\n      return existing.rmm;\n    }\n\n    if (existing?.destroying) {\n      logDebug('getOrCreate: old instance mid-destroy, replacing', { key });\n      this._instances.delete(key);\n    }\n\n    this._evictIfNeeded();\n\n    const rmm = new ResourceMutationManager(config);\n    if (this._clockOffset !== 0) {\n      rmm.clockOffset = this._clockOffset;\n    }\n    this._instances.set(key, {\n      rmm,\n      refCount: 1,\n      destroyTimer: null,\n      lastAccessedAt: Date.now(),\n      destroying: false,\n    });\n\n    logDebug('getOrCreate: created', {\n      key,\n      instanceCount: this._instances.size,\n    });\n\n    if (this._instances.size >= this.MAX_INSTANCES * RMM_REGISTRY_CAPACITY_WARNING) {\n      logger.warn('RMMRegistry approaching capacity', {\n        current: this._instances.size,\n        max: this.MAX_INSTANCES,\n      });\n    }\n\n    this._emitActiveInstancesChanged();\n    return rmm;\n  }\n\n  get(resourceType: string, resourceId: string): ResourceMutationManager | undefined {\n    return this._instances.get(this.keyFor(resourceType, resourceId))?.rmm;\n  }\n\n  /**\n   * Returns all active (refCount > 0, not mid-destroy) RMM instances.\n   * Used by RMMWebSocketBridge for reconnection version sync.\n   */\n  getActiveInstances(): Array<{ key: string; resourceType: string; resourceId: string; rmm: ResourceMutationManager }> {\n    const active: ActiveInstancesSnapshot = [];\n    for (const [key, entry] of this._instances) {\n      if (entry.refCount > 0 && !entry.destroying) {\n        const colonIdx = key.indexOf(':');\n        if (colonIdx < 0) continue;\n        const resourceType = key.substring(0, colonIdx);\n        const resourceId = key.substring(colonIdx + 1);\n        active.push({ key, resourceType, resourceId, rmm: entry.rmm });\n      }\n    }\n    return active;\n  }\n\n  subscribeActiveInstances(\n    listener: (instances: ActiveInstancesSnapshot) => void,\n  ): () => void {\n    this._activeInstanceListeners.add(listener);\n    listener(this.getActiveInstances());\n    return () => {\n      this._activeInstanceListeners.delete(listener);\n    };\n  }\n\n  notifyInstanceRuntimeChanged(): void {\n    this._emitActiveInstancesChanged();\n  }\n\n  keyFor(resourceType: string, resourceId: string): string {\n    return `${resourceType}:${resourceId}`;\n  }\n\n  release(key: string): void {\n    const entry = this._instances.get(key);\n    if (!entry) return;\n\n    entry.refCount--;\n\n    logDebug('release', { key, refCount: entry.refCount });\n\n    if (entry.refCount <= 0) {\n      entry.refCount = 0;\n      if (!entry.destroyTimer) {\n        entry.destroyTimer = setTimeout(() => {\n          entry.destroyTimer = null;\n          entry.destroying = true;\n          logDebug('release: destroy timer fired', { key });\n\n          entry.rmm.destroy()\n            .then(() => this.remove(key))\n            .catch(() => {\n              logDebug('release: destroy failed, force-removing', { key });\n              this.remove(key);\n            });\n        }, RMM_REGISTRY_DESTROY_DELAY_MS);\n      }\n    }\n    this._emitActiveInstancesChanged();\n  }\n\n  remove(key: string): void {\n    const entry = this._instances.get(key);\n    if (!entry) return;\n\n    if (entry.destroyTimer) {\n      clearTimeout(entry.destroyTimer);\n    }\n    this._instances.delete(key);\n\n    logDebug('remove', { key, remainingInstances: this._instances.size });\n    this._emitActiveInstancesChanged();\n  }\n\n  destroy(): void {\n    logDebug('destroy: cleaning up all instances', { count: this._instances.size });\n\n    for (const [key, entry] of this._instances) {\n      if (entry.destroyTimer) {\n        clearTimeout(entry.destroyTimer);\n      }\n      entry.rmm.destroy().catch(() => {\n        logDebug('destroy: instance cleanup failed', { key });\n      });\n    }\n    this._instances.clear();\n    this._emitActiveInstancesChanged();\n  }\n\n  /**\n   * Evict the least-recently-used idle instance when at capacity.\n   * Only entries with refCount === 0 are eligible. If no evictable entry\n   * exists, log a warning but allow creation (soft limit).\n   */\n  private _evictIfNeeded(): void {\n    if (this._instances.size < this.MAX_INSTANCES) return;\n\n    let lruKey: string | null = null;\n    let lruTime = Infinity;\n\n    for (const [key, entry] of this._instances) {\n      if (entry.refCount === 0 && entry.lastAccessedAt < lruTime) {\n        lruKey = key;\n        lruTime = entry.lastAccessedAt;\n      }\n    }\n\n    if (lruKey) {\n      const entry = this._instances.get(lruKey)!;\n      if (entry.destroyTimer) {\n        clearTimeout(entry.destroyTimer);\n      }\n      logDebug('_evictIfNeeded: evicting LRU', { key: lruKey, lastAccessedAt: lruTime });\n      entry.rmm.destroy().catch(() => {\n        logDebug('_evictIfNeeded: eviction cleanup failed', { key: lruKey });\n      });\n      this._instances.delete(lruKey);\n    } else {\n      logger.warn('RMMRegistry at capacity with no idle instances to evict', {\n        instanceCount: this._instances.size,\n        maxInstances: this.MAX_INSTANCES,\n      });\n    }\n  }\n\n  /**\n   * Notify active-instance observers (today: `RMMWebSocketBridge`) that the live\n   * RMM set — or an instance's runtime routing — changed.\n   *\n   * The notification is intentionally **deferred to a microtask**, never run\n   * synchronously. The main caller, `getOrCreate`, is invoked from inside a React\n   * `useMemo` in `useResourceRMM` — i.e. during the *render phase*. The bridge\n   * observer reacts by claiming/releasing WebSocket rooms, which calls\n   * `setSubscribedRooms` on the ancestor `WebSocketProvider`. Running that\n   * synchronously is a `setState` on an ancestor *during a descendant's render*\n   * — React's \"Cannot update a component while rendering a different component\"\n   * violation, and the closing edge of a paced render loop that froze any surface\n   * embedding an RMM-attached displayer (the todos CREATE route, which embeds a\n   * composite read view, 2026-06-27). Deferring to a microtask moves the observer\n   * side effects out of render, breaking the loop regardless of which upstream\n   * dependency churns the acquiring memo.\n   *\n   * Emits are coalesced: many calls within one synchronous task (e.g. several\n   * displayers acquiring instances in the same render pass) collapse into a\n   * single post-task notification carrying the latest snapshot. The initial,\n   * non-render-phase sync is still delivered synchronously by\n   * `subscribeActiveInstances` at subscription time.\n   */\n  private _emitActiveInstancesChanged(): void {\n    if (this._activeInstanceListeners.size === 0) {\n      return;\n    }\n    if (this._activeInstancesEmitScheduled) {\n      return;\n    }\n    this._activeInstancesEmitScheduled = true;\n    queueMicrotask(() => {\n      this._activeInstancesEmitScheduled = false;\n      if (this._activeInstanceListeners.size === 0) {\n        return;\n      }\n      const snapshot = this.getActiveInstances();\n      for (const listener of this._activeInstanceListeners) {\n        listener(snapshot);\n      }\n    });\n  }\n}\n"]}

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

@@ -45,6 +45,8 @@ export declare class ResourceMutationManager {
     private _allowSettledSelfEventRepair;
     private _producedVersions;
     private _crdtFieldNames;
+    /** The variant discriminator fields of a polymorphic resource, added to every body this manager builds when it sends. */
+    private _discriminatorFieldNames;
     private _fieldMeta;
     private _pendingFieldTimestamps;
     private _lastIssuedLocalTimestamp;
@@ -87,6 +89,7 @@ export declare class ResourceMutationManager {
         readOperationPathKey?: string;
         conflictPolicy?: ResourceMutationManagerConfig['conflictPolicy'];
         resourceSchema?: ResourceMutationManagerConfig['resourceSchema'];
+        resourceInheritance?: ResourceMutationManagerConfig['resourceInheritance'];
     }): void;
     /**
      * May be called multiple times (e.g., on refetch or WS reconnection).

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

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