@wildo-ai/saas-frontend-lib 1.0.1

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

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

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

@@ -0,0 +1,61 @@
+/**
+ * RMMRegistry — Global singleton managing RMM instances with ref counting.
+ *
+ * Pure TypeScript (no React). Instances are keyed by `${resourceType}:${resourceId}`.
+ * Ref counting + deferred destruction (100ms) ensures React Strict Mode safety:
+ * unmount→remount within the same tick reuses the existing instance.
+ *
+ * LRU eviction at capacity targets idle instances (refCount === 0) first.
+ * Active instances are never evicted — the limit is soft.
+ */
+import { ResourceMutationManager } from './ResourceMutationManager.js';
+import type { ResourceMutationManagerConfig } from './types.js';
+export interface RMMRegistryOptions {
+    maxInstances?: number;
+}
+type ActiveInstancesSnapshot = Array<{
+    key: string;
+    resourceType: string;
+    resourceId: string;
+    rmm: ResourceMutationManager;
+}>;
+export declare class RMMRegistry {
+    private _instances;
+    private _activeInstanceListeners;
+    private readonly MAX_INSTANCES;
+    private _clockOffset;
+    constructor(options?: RMMRegistryOptions);
+    get clockOffset(): number;
+    /**
+     * Sets the clock offset and propagates it to all active RMM instances.
+     * Called by the calibration effect in RMMRegistryProvider.
+     */
+    setClockOffset(offset: number): void;
+    getOrCreate(resourceType: string, resourceId: string, config: ResourceMutationManagerConfig): ResourceMutationManager;
+    get(resourceType: string, resourceId: string): ResourceMutationManager | undefined;
+    /**
+     * Returns all active (refCount > 0, not mid-destroy) RMM instances.
+     * Used by RMMWebSocketBridge for reconnection version sync.
+     */
+    getActiveInstances(): Array<{
+        key: string;
+        resourceType: string;
+        resourceId: string;
+        rmm: ResourceMutationManager;
+    }>;
+    subscribeActiveInstances(listener: (instances: ActiveInstancesSnapshot) => void): () => void;
+    notifyInstanceRuntimeChanged(): void;
+    keyFor(resourceType: string, resourceId: string): string;
+    release(key: string): void;
+    remove(key: string): void;
+    destroy(): void;
+    /**
+     * Evict the least-recently-used idle instance when at capacity.
+     * Only entries with refCount === 0 are eligible. If no evictable entry
+     * exists, log a warning but allow creation (soft limit).
+     */
+    private _evictIfNeeded;
+    private _emitActiveInstancesChanged;
+}
+export {};
+//# sourceMappingURL=RMMRegistry.d.ts.map

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

@@ -0,0 +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,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,OAAO,CAAC,2BAA2B;CASpC"}

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

@@ -0,0 +1,239 @@
+/**
+ * RMMRegistry — Global singleton managing RMM instances with ref counting.
+ *
+ * Pure TypeScript (no React). Instances are keyed by `${resourceType}:${resourceId}`.
+ * Ref counting + deferred destruction (100ms) ensures React Strict Mode safety:
+ * unmount→remount within the same tick reuses the existing instance.
+ *
+ * LRU eviction at capacity targets idle instances (refCount === 0) first.
+ * Active instances are never evicted — the limit is soft.
+ */
+import { ResourceMutationManager } from './ResourceMutationManager.js';
+import { RMM_REGISTRY_CAPACITY_WARNING, RMM_REGISTRY_DESTROY_DELAY_MS, RMM_REGISTRY_MAX_INSTANCES, } from './rmm-constants.js';
+import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
+const logger = LoggerFrontendService.getLogger();
+const logDebug = logger.debugByType('RMMRegistry');
+logger.setDebugTypeLogging('RMMRegistry', false);
+export class RMMRegistry {
+    _instances = new Map();
+    _activeInstanceListeners = new Set();
+    MAX_INSTANCES;
+    _clockOffset = 0;
+    constructor(options) {
+        this.MAX_INSTANCES = options?.maxInstances ?? RMM_REGISTRY_MAX_INSTANCES;
+        logDebug('constructor', { maxInstances: this.MAX_INSTANCES });
+    }
+    get clockOffset() {
+        return this._clockOffset;
+    }
+    /**
+     * Sets the clock offset and propagates it to all active RMM instances.
+     * Called by the calibration effect in RMMRegistryProvider.
+     */
+    setClockOffset(offset) {
+        this._clockOffset = offset;
+        for (const [, entry] of this._instances) {
+            if (entry.refCount > 0 && !entry.destroying) {
+                entry.rmm.clockOffset = offset;
+            }
+        }
+    }
+    getOrCreate(resourceType, resourceId, config) {
+        const key = this.keyFor(resourceType, resourceId);
+        const existing = this._instances.get(key);
+        if (existing && !existing.destroying) {
+            if (existing.destroyTimer) {
+                clearTimeout(existing.destroyTimer);
+                existing.destroyTimer = null;
+                logDebug('getOrCreate: cancelled pending destroy', { key });
+            }
+            const previousReadOperationPathKey = existing.rmm.readOperationPathKey;
+            if (config.readOperationPathKey !== undefined
+                && previousReadOperationPathKey !== undefined
+                && config.readOperationPathKey !== previousReadOperationPathKey) {
+                logger.warn('RMMRegistry updating canonical read path on reused instance', {
+                    key,
+                    previousReadOperationPathKey,
+                    nextReadOperationPathKey: config.readOperationPathKey,
+                });
+            }
+            existing.rmm.syncRuntimeRoutingConfig({
+                transportAdapter: config.transportAdapter,
+                currentUserId: config.currentUserId,
+                contextResourceIdentifiers: config.contextResourceIdentifiers,
+                contextualParameters: config.contextualParameters,
+                parentResourcesRequirements: config.parentResourcesRequirements,
+                operationPathKey: config.operationPathKey,
+                readOperationPathKey: config.readOperationPathKey,
+                conflictPolicy: config.conflictPolicy,
+                resourceSchema: config.resourceSchema,
+            });
+            // Registry identity is resourceType + resourceId, not route instance. A
+            // reused RMM therefore has to resync transport/context/read-path inputs on
+            // every acquisition so navigation changes do not leave a live instance on
+            // stale runtime routing.
+            existing.refCount++;
+            existing.lastAccessedAt = Date.now();
+            logDebug('getOrCreate: reused', {
+                key,
+                refCount: existing.refCount,
+            });
+            this._emitActiveInstancesChanged();
+            return existing.rmm;
+        }
+        if (existing?.destroying) {
+            logDebug('getOrCreate: old instance mid-destroy, replacing', { key });
+            this._instances.delete(key);
+        }
+        this._evictIfNeeded();
+        const rmm = new ResourceMutationManager(config);
+        if (this._clockOffset !== 0) {
+            rmm.clockOffset = this._clockOffset;
+        }
+        this._instances.set(key, {
+            rmm,
+            refCount: 1,
+            destroyTimer: null,
+            lastAccessedAt: Date.now(),
+            destroying: false,
+        });
+        logDebug('getOrCreate: created', {
+            key,
+            instanceCount: this._instances.size,
+        });
+        if (this._instances.size >= this.MAX_INSTANCES * RMM_REGISTRY_CAPACITY_WARNING) {
+            logger.warn('RMMRegistry approaching capacity', {
+                current: this._instances.size,
+                max: this.MAX_INSTANCES,
+            });
+        }
+        this._emitActiveInstancesChanged();
+        return rmm;
+    }
+    get(resourceType, resourceId) {
+        return this._instances.get(this.keyFor(resourceType, resourceId))?.rmm;
+    }
+    /**
+     * Returns all active (refCount > 0, not mid-destroy) RMM instances.
+     * Used by RMMWebSocketBridge for reconnection version sync.
+     */
+    getActiveInstances() {
+        const active = [];
+        for (const [key, entry] of this._instances) {
+            if (entry.refCount > 0 && !entry.destroying) {
+                const colonIdx = key.indexOf(':');
+                if (colonIdx < 0)
+                    continue;
+                const resourceType = key.substring(0, colonIdx);
+                const resourceId = key.substring(colonIdx + 1);
+                active.push({ key, resourceType, resourceId, rmm: entry.rmm });
+            }
+        }
+        return active;
+    }
+    subscribeActiveInstances(listener) {
+        this._activeInstanceListeners.add(listener);
+        listener(this.getActiveInstances());
+        return () => {
+            this._activeInstanceListeners.delete(listener);
+        };
+    }
+    notifyInstanceRuntimeChanged() {
+        this._emitActiveInstancesChanged();
+    }
+    keyFor(resourceType, resourceId) {
+        return `${resourceType}:${resourceId}`;
+    }
+    release(key) {
+        const entry = this._instances.get(key);
+        if (!entry)
+            return;
+        entry.refCount--;
+        logDebug('release', { key, refCount: entry.refCount });
+        if (entry.refCount <= 0) {
+            entry.refCount = 0;
+            if (!entry.destroyTimer) {
+                entry.destroyTimer = setTimeout(() => {
+                    entry.destroyTimer = null;
+                    entry.destroying = true;
+                    logDebug('release: destroy timer fired', { key });
+                    entry.rmm.destroy()
+                        .then(() => this.remove(key))
+                        .catch(() => {
+                        logDebug('release: destroy failed, force-removing', { key });
+                        this.remove(key);
+                    });
+                }, RMM_REGISTRY_DESTROY_DELAY_MS);
+            }
+        }
+        this._emitActiveInstancesChanged();
+    }
+    remove(key) {
+        const entry = this._instances.get(key);
+        if (!entry)
+            return;
+        if (entry.destroyTimer) {
+            clearTimeout(entry.destroyTimer);
+        }
+        this._instances.delete(key);
+        logDebug('remove', { key, remainingInstances: this._instances.size });
+        this._emitActiveInstancesChanged();
+    }
+    destroy() {
+        logDebug('destroy: cleaning up all instances', { count: this._instances.size });
+        for (const [key, entry] of this._instances) {
+            if (entry.destroyTimer) {
+                clearTimeout(entry.destroyTimer);
+            }
+            entry.rmm.destroy().catch(() => {
+                logDebug('destroy: instance cleanup failed', { key });
+            });
+        }
+        this._instances.clear();
+        this._emitActiveInstancesChanged();
+    }
+    /**
+     * Evict the least-recently-used idle instance when at capacity.
+     * Only entries with refCount === 0 are eligible. If no evictable entry
+     * exists, log a warning but allow creation (soft limit).
+     */
+    _evictIfNeeded() {
+        if (this._instances.size < this.MAX_INSTANCES)
+            return;
+        let lruKey = null;
+        let lruTime = Infinity;
+        for (const [key, entry] of this._instances) {
+            if (entry.refCount === 0 && entry.lastAccessedAt < lruTime) {
+                lruKey = key;
+                lruTime = entry.lastAccessedAt;
+            }
+        }
+        if (lruKey) {
+            const entry = this._instances.get(lruKey);
+            if (entry.destroyTimer) {
+                clearTimeout(entry.destroyTimer);
+            }
+            logDebug('_evictIfNeeded: evicting LRU', { key: lruKey, lastAccessedAt: lruTime });
+            entry.rmm.destroy().catch(() => {
+                logDebug('_evictIfNeeded: eviction cleanup failed', { key: lruKey });
+            });
+            this._instances.delete(lruKey);
+        }
+        else {
+            logger.warn('RMMRegistry at capacity with no idle instances to evict', {
+                instanceCount: this._instances.size,
+                maxInstances: this.MAX_INSTANCES,
+            });
+        }
+    }
+    _emitActiveInstancesChanged() {
+        if (this._activeInstanceListeners.size === 0) {
+            return;
+        }
+        const snapshot = this.getActiveInstances();
+        for (const listener of this._activeInstanceListeners) {
+            listener(snapshot);
+        }
+    }
+}
+//# sourceMappingURL=RMMRegistry.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * RMM Registry Context + Provider
+ *
+ * Follows the same pattern as ResourceRegistryContext.tsx:
+ * - createContext<T | undefined>(undefined)
+ * - Hook in separate file (useResourceMutationManager.ts) for React Fast Refresh
+ * - Provider cleanup on unmount
+ *
+ * The registry is created once per app lifetime. Options changes require app remount.
+ * The provider does NOT inject currentUserId — that's done in useResourceMutationManager
+ * which reads from useUserOrgs(). This keeps the provider decoupled from auth context.
+ *
+ * Clock offset calibration uses NTP-style min-RTT sampling against `/health/time`.
+ */
+import React from 'react';
+import type { ReactNode } from 'react';
+import { RMMRegistry } from './RMMRegistry.js';
+import type { RMMRegistryOptions } from './RMMRegistry.js';
+/**
+ * @internal — Use useResourceMutationManager() hook instead of accessing this directly
+ */
+export declare const RMMRegistryContext: React.Context<RMMRegistry>;
+interface RMMRegistryProviderProps {
+    children: ReactNode;
+    options?: RMMRegistryOptions;
+    apiBaseUrl?: string;
+}
+export declare function RMMRegistryProvider({ children, options, apiBaseUrl }: RMMRegistryProviderProps): React.ReactElement;
+export {};
+//# sourceMappingURL=RMMRegistryContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RMMRegistryContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/RMMRegistryContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAoD,MAAM,OAAO,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AA4DxD;;GAEG;AACH,eAAO,MAAM,kBAAkB,4BAAoD,CAAC;AAEpF,UAAU,wBAAwB;IAChC,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,wBAAwB,GAAG,KAAK,CAAC,YAAY,CA2CnH"}

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

@@ -0,0 +1,103 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * RMM Registry Context + Provider
+ *
+ * Follows the same pattern as ResourceRegistryContext.tsx:
+ * - createContext<T | undefined>(undefined)
+ * - Hook in separate file (useResourceMutationManager.ts) for React Fast Refresh
+ * - Provider cleanup on unmount
+ *
+ * The registry is created once per app lifetime. Options changes require app remount.
+ * The provider does NOT inject currentUserId — that's done in useResourceMutationManager
+ * which reads from useUserOrgs(). This keeps the provider decoupled from auth context.
+ *
+ * Clock offset calibration uses NTP-style min-RTT sampling against `/health/time`.
+ */
+import { createContext, useEffect, useMemo, useRef } from 'react';
+import { WildoHeaderKeys, ENGINE_ROOT_ROUTES, EngineRootRouteKey } from '@wildo-ai/saas-models';
+import { RMMRegistry } from './RMMRegistry.js';
+import { CLOCK_SYNC_RECALIBRATE_INTERVAL_MS, CLOCK_SYNC_SAMPLE_COUNT, CLOCK_SYNC_STALE_THRESHOLD_MS, } from './rmm-constants.js';
+import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
+const clockLogger = LoggerFrontendService.getLogger();
+const logDebug = clockLogger.debugByType('RMMClockSync');
+clockLogger.setDebugTypeLogging('RMMClockSync', false);
+function calibrateClockOffset(samples) {
+    if (samples.length === 0)
+        return 0;
+    const bestSample = samples.reduce((best, s) => s.rtt < best.rtt ? s : best);
+    return bestSample.offset;
+}
+async function collectCalibrationSamples(apiBaseUrl) {
+    const samples = [];
+    for (let i = 0; i < CLOCK_SYNC_SAMPLE_COUNT; i++) {
+        try {
+            const start = Date.now();
+            const res = await fetch(`${apiBaseUrl}${ENGINE_ROOT_ROUTES[EngineRootRouteKey.HEALTH_TIME]}`);
+            const end = Date.now();
+            const serverTimeStr = res.headers.get(WildoHeaderKeys.X_SERVER_TIME);
+            if (serverTimeStr) {
+                const serverTime = Number(serverTimeStr);
+                const rtt = end - start;
+                const offset = serverTime - (end - rtt / 2);
+                samples.push({ offset, rtt });
+            }
+        }
+        catch {
+            // Network error — skip this sample
+        }
+    }
+    return samples;
+}
+/**
+ * Runs a full calibration cycle: collect NTP-style samples, pick the
+ * lowest-RTT sample, and push the offset into the registry.
+ * Returns the timestamp at which calibration completed (for staleness tracking).
+ */
+async function runCalibration(apiBaseUrl, registry) {
+    const samples = await collectCalibrationSamples(apiBaseUrl);
+    if (samples.length > 0) {
+        const offset = calibrateClockOffset(samples);
+        const minRtt = samples.reduce((m, s) => Math.min(m, s.rtt), Number.POSITIVE_INFINITY);
+        registry.setClockOffset(offset);
+        logDebug('calibrated', { offset, sampleCount: samples.length, minRtt });
+    }
+    return Date.now();
+}
+/**
+ * @internal — Use useResourceMutationManager() hook instead of accessing this directly
+ */
+export const RMMRegistryContext = createContext(undefined);
+export function RMMRegistryProvider({ children, options, apiBaseUrl }) {
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- registry is app-level singleton, deps intentionally empty
+    const registry = useMemo(() => new RMMRegistry(options), []);
+    const lastCalibrationRef = useRef(0);
+    // Clock calibration: initial + periodic
+    useEffect(() => {
+        if (!apiBaseUrl)
+            return;
+        runCalibration(apiBaseUrl, registry).then(ts => { lastCalibrationRef.current = ts; });
+        const interval = setInterval(() => {
+            runCalibration(apiBaseUrl, registry).then(ts => { lastCalibrationRef.current = ts; });
+        }, CLOCK_SYNC_RECALIBRATE_INTERVAL_MS);
+        return () => { clearInterval(interval); };
+    }, [registry, apiBaseUrl]);
+    // Clock calibration: recalibrate on tab becoming visible when stale
+    useEffect(() => {
+        if (!apiBaseUrl)
+            return;
+        function onVisibilityChange() {
+            if (document.visibilityState !== 'visible')
+                return;
+            if (Date.now() - lastCalibrationRef.current >= CLOCK_SYNC_STALE_THRESHOLD_MS) {
+                runCalibration(apiBaseUrl, registry).then(ts => { lastCalibrationRef.current = ts; });
+            }
+        }
+        document.addEventListener('visibilitychange', onVisibilityChange);
+        return () => { document.removeEventListener('visibilitychange', onVisibilityChange); };
+    }, [registry, apiBaseUrl]);
+    useEffect(() => {
+        return () => registry.destroy();
+    }, [registry]);
+    return (_jsx(RMMRegistryContext.Provider, { value: registry, children: children }));
+}
+//# sourceMappingURL=RMMRegistryContext.js.map

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * RMMWebSocketBridge
+ *
+ * Routes synchronization-grade WebSocket resource events to active RMM instances.
+ * Mounted once at app root inside both WebSocketProvider and RMMRegistryProvider.
+ *
+ * - `RESOURCE_UPDATED` with `deliveryTarget=RESOURCE_ROOM_SYNC` → path-aware replay
+ * - `RESOURCE_UPDATED` with notification-grade delivery → authoritative refetch
+ * - `RESOURCE_DELETED` → `rmm.handleDeletion(REMOTE)`
+ *
+ * Coexists with `WebSocketEventBridge`, which consumes both resource-room and
+ * scope-room update notifications for generic refresh behavior.
+ */
+import type { DoOperationFn } from './HttpTransportAdapter.js';
+import type { ResourceMutationManager } from './ResourceMutationManager.js';
+export declare function diffResourceFieldPaths(incoming: Record<string, unknown>, current: Record<string, unknown>): Record<string, unknown>;
+export declare function refetchAuthoritativeRMMState(params: {
+    resourceType: string;
+    resourceId: string;
+    rmm: ResourceMutationManager;
+    doOperation: DoOperationFn;
+}): Promise<void>;
+export declare const RMMWebSocketBridge: React.FC;
+//# sourceMappingURL=RMMWebSocketBridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RMMWebSocketBridge.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/RMMWebSocketBridge.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgBH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAkFzE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAED,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,uBAAuB,CAAC;IAC7B,WAAW,EAAE,aAAa,CAAC;CAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CAwChB;AAED,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAuRtC,CAAC"}