@memori.ai/memori-react 8.44.0 → 8.45.1

package/esm/helpers/nats/useNatsSession.js

@@ -1,6 +1,12 @@
 import { useEffect, useRef, useState } from 'react';
-import { wsconnect } from '@nats-io/nats-core';
+import { wsconnect, jwtAuthenticator, AuthorizationError, UserAuthenticationExpiredError, } from '@nats-io/nats-core';
 import { jetstream, DeliverPolicy, } from '@nats-io/jetstream';
+export function isNatsAuthError(error) {
+    return (error instanceof AuthorizationError ||
+        error instanceof UserAuthenticationExpiredError ||
+        (error instanceof Error &&
+            /authorization violation|authentication expired|user authentication expired/i.test(error.message)));
+}
 function readString(raw, camelKey, snakeKey) {
     var _a;
     const value = (_a = raw[camelKey]) !== null && _a !== void 0 ? _a : raw[snakeKey];
@@ -63,9 +69,10 @@ function decodeMessage(subject, received, raw, onMessage) {
     console.debug(`[NATS] message #${received} on ${subject} (eventType=${payload.eventType})`, payload);
     onMessage(payload);
 }
-async function consumeCoreSubscription(nc, subject, onMessage) {
+async function consumeCoreSubscription(nc, subject, onMessage, onReady) {
     const sub = nc.subscribe(subject);
     console.info('[NATS] subscribed to subject', subject);
+    onReady();
     let received = 0;
     for await (const msg of sub) {
         received += 1;
@@ -78,7 +85,7 @@ async function consumeCoreSubscription(nc, subject, onMessage) {
     }
     console.info(`[NATS] subscription on ${subject} closed (received ${received} messages)`);
 }
-async function consumeJetStream(nc, config, subject, mode, onMessage, setConsumerMessages) {
+async function consumeJetStream(nc, config, subject, mode, onMessage, setConsumerMessages, onReady) {
     const js = jetstream(nc);
     const consumer = config.consumer
         ? await js.consumers.get(config.stream, config.consumer)
@@ -93,6 +100,7 @@ async function consumeJetStream(nc, config, subject, mode, onMessage, setConsume
         : { stream: config.stream, subject, mode });
     const messages = await consumer.consume();
     setConsumerMessages(messages);
+    onReady();
     let received = 0;
     for await (const msg of messages) {
         received += 1;
@@ -112,15 +120,19 @@ function closeNatsSession(consumerMessagesRef, connRef) {
     (_b = connRef.current) === null || _b === void 0 ? void 0 : _b.close();
     connRef.current = null;
 }
-export function useNatsSession(sessionId, config, onMessage) {
+export function useNatsSession(sessionId, config, onMessage, lifecycle = {}) {
     const connRef = useRef(null);
     const consumerMessagesRef = useRef(null);
     const onMessageRef = useRef(onMessage);
+    const lifecycleRef = useRef(lifecycle);
     const wasHiddenRef = useRef(false);
     const [resumeGeneration, setResumeGeneration] = useState(0);
     useEffect(() => {
         onMessageRef.current = onMessage;
     }, [onMessage]);
+    useEffect(() => {
+        lifecycleRef.current = lifecycle;
+    }, [lifecycle]);
     useEffect(() => {
         if (!sessionId || !(config === null || config === void 0 ? void 0 : config.stream)) {
             return;
@@ -174,7 +186,7 @@ export function useNatsSession(sessionId, config, onMessage) {
             console.info('[NATS] connecting to', config.url, 'for session', sessionId, useJetStream ? `(JetStream/${jetStreamMode})` : '(core)');
             const nc = await wsconnect({
                 servers: [config.url],
-                token: config.token,
+                authenticator: jwtAuthenticator(config.token),
             });
             if (closed) {
                 console.debug('[NATS] connection established after cleanup, closing immediately');
@@ -186,15 +198,43 @@ export function useNatsSession(sessionId, config, onMessage) {
             const dispatch = (event) => {
                 onMessageRef.current(event);
             };
+            const ready = () => { var _a, _b; return (_b = (_a = lifecycleRef.current).onConnected) === null || _b === void 0 ? void 0 : _b.call(_a); };
+            let authRefreshRequested = false;
+            const requestAuthRefresh = (error) => {
+                var _a, _b;
+                if (closed || authRefreshRequested)
+                    return;
+                authRefreshRequested = true;
+                (_b = (_a = lifecycleRef.current).onAuthError) === null || _b === void 0 ? void 0 : _b.call(_a, error);
+            };
+            void (async () => {
+                for await (const status of nc.status()) {
+                    if (status.type === 'error' && isNatsAuthError(status.error)) {
+                        requestAuthRefresh(status.error);
+                        return;
+                    }
+                }
+            })();
+            void nc.closed().then(error => {
+                if (error && isNatsAuthError(error)) {
+                    requestAuthRefresh(error);
+                }
+            });
             if (useJetStream) {
                 await consumeJetStream(nc, config, subject, jetStreamMode, dispatch, messages => {
                     consumerMessagesRef.current = messages;
-                });
+                }, ready);
             }
             else {
-                await consumeCoreSubscription(nc, subject, dispatch);
+                await consumeCoreSubscription(nc, subject, dispatch, ready);
+            }
+        })().catch(err => {
+            var _a, _b;
+            console.error('[NATS] connection error', err);
+            if (!closed && isNatsAuthError(err)) {
+                (_b = (_a = lifecycleRef.current).onAuthError) === null || _b === void 0 ? void 0 : _b.call(_a, err);
             }
-        })().catch(err => console.error('[NATS] connection error', err));
+        });
         return () => {
             console.info('[NATS] cleanup: closing connection for subject', subject);
             closed = true;

package/esm/helpers/nats/useNatsSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"useNatsSession.js","sourceRoot":"","sources":["../../../src/helpers/nats/useNatsSession.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAyB,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAkB,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACL,SAAS,EACT,aAAa,GAEd,MAAM,oBAAoB,CAAC;AAkD5B,SAAS,UAAU,CACjB,GAA4B,EAC5B,QAAgB,EAChB,QAAgB;;IAEhB,MAAM,KAAK,GAAG,MAAA,GAAG,CAAC,QAAQ,CAAC,mCAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,UAAU,CACjB,GAA4B,EAC5B,QAAgB,EAChB,QAAgB;;IAEhB,MAAM,KAAK,GAAG,MAAA,GAAG,CAAC,QAAQ,CAAC,mCAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAWD,SAAS,iBAAiB,CAAC,KAAc;IACvC,IACE,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,cAAc,IAAK,KAAiC,EACpD;QACA,OAAQ,KAAiC,CAAC,YAAY,CAAC;KACxD;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAKD,MAAM,UAAU,kBAAkB,CAAC,GAA4B;;IAC7D,MAAM,SAAS,GAAG,CAAC,MAAA,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC,mCAC3D,SAAS,CAAkC,CAAC;IAE9C,MAAM,aAAa,GACjB,MAAA,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,gBAAgB,CAAC,mCAClD,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;IAErD,IAAI,SAAS,KAAK,UAAU,EAAE;QAC5B,OAAO;YACL,SAAS,EAAE,UAAU;YACrB,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC;YACzC,WAAW,EAAE,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,cAAc,CAAC;YAC3D,SAAS,EAAE,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC;YACrD,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YAClE,YAAY,EAAE,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,eAAe,CAAC;YAC9D,aAAa;SACd,CAAC;KACH;IAED,IAAI,SAAS,KAAK,8BAA8B,EAAE;QAChD,OAAO;YACL,SAAS,EAAE,8BAA8B;YACzC,SAAS,EACP,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YAC/D,UAAU,EACR,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;YACjE,aAAa,EACX,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;YACvE,YAAY,EAAE,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAC;YACjD,aAAa;SACd,CAAC;KACH;IAED,IAAI,SAAS,KAAK,OAAO,EAAE;QACzB,OAAO;YACL,SAAS,EAAE,OAAO;YAClB,SAAS,EAAE,CAAC,MAAA,GAAG,CAAC,SAAS,mCAAI,GAAG,CAAC,UAAU,CAAgC;YAC3E,YAAY,EAAE,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,eAAe,CAAC;YAC9D,SAAS,EAAE,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YACxE,aAAa;SACd,CAAC;KACH;IAED,OAAO;QACL,SAAS;QACT,aAAa;KACM,CAAC;AACxB,CAAC;AAED,SAAS,aAAa,CACpB,OAAe,EACf,QAAgB,EAChB,GAA4B,EAC5B,SAA4C;IAE5C,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,CAAC,KAAK,CACX,mBAAmB,QAAQ,OAAO,OAAO,eAAe,OAAO,CAAC,SAAS,GAAG,EAC5E,OAAO,CACR,CAAC;IACF,SAAS,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,EAAkB,EAClB,OAAe,EACf,SAA4C;IAE5C,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,EAAE;QAC3B,QAAQ,IAAI,CAAC,CAAC;QACd,IAAI;YACF,aAAa,CACX,OAAO,EACP,QAAQ,EACR,GAAG,CAAC,IAAI,EAA2B,EACnC,SAAS,CACV,CAAC;SACH;QAAC,OAAO,GAAG,EAAE;YACZ,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;SACnD;KACF;IACD,OAAO,CAAC,IAAI,CACV,0BAA0B,OAAO,qBAAqB,QAAQ,YAAY,CAC3E,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,EAAkB,EAClB,MAA+C,EAC/C,OAAe,EACf,IAA0B,EAC1B,SAA4C,EAC5C,mBAAyD;IAEzD,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;IACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ;QAC9B,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,MAAO,EAAE,MAAM,CAAC,QAAQ,CAAC;QACzD,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,MAAO,EAAE;YACrC,eAAe,EAAE,CAAC,OAAO,CAAC;YAC1B,cAAc,EACZ,IAAI,KAAK,UAAU;gBACjB,CAAC,CAAC,aAAa,CAAC,cAAc;gBAC9B,CAAC,CAAC,aAAa,CAAC,GAAG;SACxB,CAAC,CAAC;IAEP,OAAO,CAAC,IAAI,CACV,iCAAiC,EACjC,MAAM,CAAC,QAAQ;QACb,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;QACrE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAC7C,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC1C,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,QAAQ,EAAE;QAChC,QAAQ,IAAI,CAAC,CAAC;QACd,IAAI;YACF,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;SACzD;QAAC,OAAO,GAAG,EAAE;YACZ,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;SACnD;KACF;IACD,OAAO,CAAC,IAAI,CACV,gCAAgC,OAAO,qBAAqB,QAAQ,YAAY,CACjF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,mBAA8D,EAC9D,OAAgD;;IAEhD,MAAA,mBAAmB,CAAC,OAAO,0CAAE,IAAI,EAAE,CAAC;IACpC,mBAAmB,CAAC,OAAO,GAAG,IAAI,CAAC;IACnC,MAAA,OAAO,CAAC,OAAO,0CAAE,KAAK,EAAE,CAAC;IACzB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;AACzB,CAAC;AAcD,MAAM,UAAU,cAAc,CAC5B,SAA6B,EAC7B,MAA8B,EAC9B,SAA4C;IAE5C,MAAM,OAAO,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IACpD,MAAM,mBAAmB,GAAG,MAAM,CAA0B,IAAI,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAG5D,SAAS,CAAC,GAAG,EAAE;QACb,YAAY,CAAC,OAAO,GAAG,SAAS,CAAC;IACnC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAGhB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS,IAAI,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,CAAA,EAAE;YACjC,OAAO;SACR;QAED,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,EAAE;gBAC1C,OAAO;aACR;YACD,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YAC1E,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC;QAEF,MAAM,kBAAkB,GAAG,GAAG,EAAE;YAC9B,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAAE;gBACzC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC5B,OAAO;aACR;YACD,IAAI,YAAY,CAAC,OAAO,EAAE;gBACxB,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC;gBAC7B,aAAa,EAAE,CAAC;aACjB;QACH,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,CAAC,KAA0B,EAAE,EAAE;YAChD,IAAI,KAAK,CAAC,SAAS,EAAE;gBACnB,aAAa,EAAE,CAAC;aACjB;QACH,CAAC,CAAC;QAEF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QAClE,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACjD,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAEhD,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;YACrE,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;YACpD,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACrD,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,CAAC,CAAC,CAAC;IAEhC,SAAS,CAAC,GAAG,EAAE;;QACb,IAAI,CAAC,SAAS,IAAI,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,CAAA,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;YAC/C,OAAO,CAAC,KAAK,CACX,2DAA2D,EAC3D;gBACE,SAAS;gBACT,MAAM,EAAE,CAAC,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,CAAA;gBACrB,QAAQ,EAAE,CAAC,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,CAAA;aAC1B,CACF,CAAC;YACF,OAAO;SACR;QAED,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,MAAM,OAAO,GAAG,MAAA,MAAM,CAAC,OAAO,mCAAI,YAAY,SAAS,EAAE,CAAC;QAC1D,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QACrC,MAAM,aAAa,GACjB,YAAY,IAAI,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;QAE7D,CAAC,KAAK,IAAI,EAAE;YACV,OAAO,CAAC,IAAI,CACV,sBAAsB,EACtB,MAAM,CAAC,GAAG,EACV,aAAa,EACb,SAAS,EACT,YAAY,CAAC,CAAC,CAAC,cAAc,aAAa,GAAG,CAAC,CAAC,CAAC,QAAQ,CACzD,CAAC;YACF,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC;gBACzB,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;YACH,IAAI,MAAM,EAAE;gBACV,OAAO,CAAC,KAAK,CACX,kEAAkE,CACnE,CAAC;gBACF,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;gBACjB,OAAO;aACR;YACD,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;YAEpD,MAAM,QAAQ,GAAG,CAAC,KAAuB,EAAE,EAAE;gBAC3C,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC,CAAC;YAEF,IAAI,YAAY,EAAE;gBAChB,MAAM,gBAAgB,CACpB,EAAE,EACF,MAAM,EACN,OAAO,EACP,aAAa,EACb,QAAQ,EACR,QAAQ,CAAC,EAAE;oBACT,mBAAmB,CAAC,OAAO,GAAG,QAAQ,CAAC;gBACzC,CAAC,CACF,CAAC;aACH;iBAAM;gBACL,MAAM,uBAAuB,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;aACtD;QACH,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC,CAAC;QAEjE,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,IAAI,CAAC,gDAAgD,EAAE,OAAO,CAAC,CAAC;YACxE,MAAM,GAAG,IAAI,CAAC;YACd,gBAAgB,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAG1C,SAAS,CAAC,GAAG,EAAE;QACb,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"useNatsSession.js","sourceRoot":"","sources":["../../../src/helpers/nats/useNatsSession.ts"],"names":[],"mappings":"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"}

package/esm/version.d.ts

@@ -1 +1 @@
-export declare const version = "8.44.0";
+export declare const version = "8.45.1";

package/esm/version.js

@@ -1,2 +1,2 @@
-export const version = '8.44.0';
+export const version = '8.45.1';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "8.44.0",
+  "version": "8.45.1",
   "name": "@memori.ai/memori-react",
   "author": "Memori Srl",
   "main": "dist/index.js",

package/src/components/MemoriWidget/MemoriWidget.tsx

@@ -159,6 +159,22 @@ function readCorrelationID(response: {
   return typeof value === 'string' && value.length > 0 ? value : undefined;
 }
 
+/** Stable engine-owned fields used to tell whether a pending turn completed. */
+export function dialogStateFingerprint(state: DialogState | undefined): string {
+  if (!state) return '';
+  return JSON.stringify({
+    state: state.state,
+    previousState: state.previousState,
+    emission: state.emission,
+    emitter: state.emitter,
+    lastMatchedMemoryID: state.lastMatchedMemoryID,
+    currentDate: state.currentDate,
+    currentMemoryID: state.currentMemoryID,
+    contextVars: state.contextVars,
+    emittedMedia: state.emittedMedia,
+  });
+}
+
 type MemoriTextEnteredEvent = CustomEvent<{
   text: string;
   waitForPrevious?: boolean;
@@ -724,6 +740,7 @@ const MemoriWidget = ({
 
   type PendingEnterText = EnterTextRetryParams & {
     msg?: string;
+    stateBeforeRequest?: string;
     waitForResponse?: {
       resolve: (event: NatsDialogResponseEvent) => void;
       reject: (error: Error) => void;
@@ -1073,6 +1090,7 @@ const MemoriWidget = ({
       if (response.resultCode === 0 && correlationID) {
         registerPendingEnterText(correlationID, {
           msg,
+          stateBeforeRequest: dialogStateFingerprint(currentDialogState),
           text,
           media,
           translate,
@@ -2363,6 +2381,7 @@ const MemoriWidget = ({
         }, timeoutMs);
 
         registerPendingEnterText(correlationID, {
+          stateBeforeRequest: dialogStateFingerprint(currentDialogState),
           waitForResponse: {
             resolve: event => {
               clearTimeout(timeoutId);
@@ -2376,9 +2395,53 @@ const MemoriWidget = ({
           },
         });
       }),
-    [registerPendingEnterText, clearEnterTextPending]
+    [registerPendingEnterText, clearEnterTextPending, currentDialogState]
   );
 
+  const catchUpPendingEnterText = useCallback(async () => {
+    if (!sessionId || pendingEnterTextRef.current.size === 0) return;
+
+    // Async turns are registered in send order. The current session state can
+    // only represent the latest completed turn, so reconcile the latest one.
+    const latest = Array.from(pendingEnterTextRef.current.entries()).pop();
+    if (!latest) return;
+    const [correlationID, pending] = latest;
+
+    try {
+      const { currentState, resultCode, resultMessage, requestID } =
+        await getSession(sessionId);
+
+      if (resultCode !== 0 || !currentState) {
+        deliverEnterTextNatsResponse(correlationID, {
+          eventType: 'dialog_text_entered_response',
+          correlationID,
+          requestID,
+          resultCode,
+          resultMessage,
+          currentState,
+        });
+        return;
+      }
+
+      if (dialogStateFingerprint(currentState) === pending.stateBeforeRequest) {
+        console.info('[NATS] catch-up: pending turn has not completed yet');
+        return;
+      }
+
+      console.info('[NATS] catch-up: applying current engine session state');
+      deliverEnterTextNatsResponse(correlationID, {
+        eventType: 'dialog_text_entered_response',
+        correlationID,
+        requestID,
+        resultCode,
+        resultMessage,
+        currentState,
+      });
+    } catch (error) {
+      logWidgetError('NATS catch-up failed', error);
+    }
+  }, [sessionId, deliverEnterTextNatsResponse]);
+
   // NATS subscription: receives progress updates and the async enter-text response.
   useNats({
     baseUrl,
@@ -2403,6 +2466,7 @@ const MemoriWidget = ({
       [deliverEnterTextNatsResponse]
     ),
     onError: deliverEnterTextNatsError,
+    onCatchUp: catchUpPendingEnterText,
   });
 
   const focusChatInput = () => {

package/src/helpers/nats/getNatsConfig.ts

@@ -7,7 +7,10 @@
 export interface NatsConfig {
   /** WebSocket URL of the NATS server (e.g. wss://nats.hz.slnode.net:8080). */
   url: string;
-  /** Bearer token used to authenticate the WebSocket connection. */
+  /**
+   * Per-session NATS user JWT. Presented with `jwtAuthenticator` (bearer:
+   * no nkey seed on the client).
+   */
   token: string;
   /**
    * JetStream stream that stores session events. When set, the client consumes

package/src/helpers/nats/useNats.test.tsx

@@ -0,0 +1,81 @@
+import { act, renderHook, waitFor } from '@testing-library/react';
+import { getNatsConfig } from './getNatsConfig';
+import { useNats } from './useNats';
+import { NatsSessionLifecycle, useNatsSession } from './useNatsSession';
+
+jest.mock('./getNatsConfig', () => ({
+  getNatsConfig: jest.fn(),
+}));
+
+jest.mock('./useNatsSession', () => ({
+  useNatsSession: jest.fn(),
+}));
+
+const mockGetNatsConfig = getNatsConfig as jest.MockedFunction<
+  typeof getNatsConfig
+>;
+const mockUseNatsSession = useNatsSession as jest.MockedFunction<
+  typeof useNatsSession
+>;
+
+function latestLifecycle(): NatsSessionLifecycle {
+  return mockUseNatsSession.mock.calls.at(-1)?.[3] ?? {};
+}
+
+describe('useNats credential lifecycle', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+    mockGetNatsConfig.mockResolvedValue({
+      url: 'wss://nats.example.test',
+      token: 'fresh-jwt',
+    });
+    Object.defineProperty(document, 'visibilityState', {
+      configurable: true,
+      value: 'visible',
+    });
+  });
+
+  it('refreshes the JWT on resume and catches up after reconnecting', async () => {
+    const onCatchUp = jest.fn();
+    renderHook(() =>
+      useNats({
+        baseUrl: 'https://dashboard.example.test',
+        sessionId: 'session-a',
+        onCatchUp,
+      })
+    );
+
+    await waitFor(() => expect(mockGetNatsConfig).toHaveBeenCalledTimes(1));
+
+    act(() => {
+      (document.dispatchEvent as (event: Event) => boolean)(
+        new Event('visibilitychange')
+      );
+    });
+    await waitFor(() => expect(mockGetNatsConfig).toHaveBeenCalledTimes(2));
+
+    act(() => latestLifecycle().onConnected?.());
+    expect(onCatchUp).toHaveBeenCalledTimes(1);
+  });
+
+  it('refreshes the JWT after an authorization error', async () => {
+    const onCatchUp = jest.fn();
+    renderHook(() =>
+      useNats({
+        baseUrl: 'https://dashboard.example.test',
+        sessionId: 'session-a',
+        onCatchUp,
+      })
+    );
+
+    await waitFor(() => expect(mockGetNatsConfig).toHaveBeenCalledTimes(1));
+
+    act(() => {
+      latestLifecycle().onAuthError?.(new Error('Authorization Violation'));
+    });
+    await waitFor(() => expect(mockGetNatsConfig).toHaveBeenCalledTimes(2));
+
+    act(() => latestLifecycle().onConnected?.());
+    expect(onCatchUp).toHaveBeenCalledTimes(1);
+  });
+});

package/src/helpers/nats/useNats.ts

@@ -24,6 +24,11 @@ export interface UseNatsOptions {
   onDialogResponse?: (event: NatsDialogResponseEvent) => void;
   /** `error` events (logging / user notification). */
   onError?: (event: NatsErrorEvent) => void;
+  /**
+   * Reconcile a pending turn from the engine after a resumed or reauthenticated
+   * subscription is installed.
+   */
+  onCatchUp?: () => void | Promise<void>;
 }
 
 /**
@@ -38,6 +43,7 @@ export function useNats({
   onProgress,
   onDialogResponse,
   onError,
+  onCatchUp,
 }: UseNatsOptions) {
   const [config, setConfig] = useState<NatsConfig | null>(null);
   const [configError, setConfigError] = useState<Error | null>(null);
@@ -46,33 +52,42 @@ export function useNats({
   const onProgressRef = useRef(onProgress);
   const onDialogResponseRef = useRef(onDialogResponse);
   const onErrorRef = useRef(onError);
+  const onCatchUpRef = useRef(onCatchUp);
+  const abortRef = useRef<AbortController | null>(null);
+  const catchUpAfterConnectRef = useRef(false);
+  const refreshInFlightRef = useRef(false);
+  const lastAuthRefreshRef = useRef(0);
   useEffect(() => {
     onProgressRef.current = onProgress;
     onDialogResponseRef.current = onDialogResponse;
     onErrorRef.current = onError;
-  }, [onProgress, onDialogResponse, onError]);
+    onCatchUpRef.current = onCatchUp;
+  }, [onProgress, onDialogResponse, onError, onCatchUp]);
 
-  // Fetch connection config whenever the active session changes.
-  useEffect(() => {
-    if (!sessionId) {
-      console.debug('[NATS] no sessionId, skipping config fetch');
-      setConfig(null);
-      setConfigError(null);
-      return;
-    }
+  const refreshConfig = useCallback(
+    async (reason: 'initial' | 'resume' | 'auth') => {
+      if (!sessionId || refreshInFlightRef.current) return;
+      if (reason === 'auth' && Date.now() - lastAuthRefreshRef.current < 5000) {
+        return;
+      }
 
-    const controller = new AbortController();
-    let cancelled = false;
-
-    console.info(
-      '[NATS] fetching config from',
-      `${baseUrl}/api/nats`,
-      'for session',
-      sessionId
-    );
-    getNatsConfig(baseUrl, sessionId, controller.signal)
-      .then(cfg => {
-        if (!cancelled) {
+      refreshInFlightRef.current = true;
+      if (reason === 'auth') lastAuthRefreshRef.current = Date.now();
+      abortRef.current?.abort();
+      const controller = new AbortController();
+      abortRef.current = controller;
+
+      console.info(
+        '[NATS] fetching config from',
+        `${baseUrl}/api/nats`,
+        'for session',
+        sessionId,
+        `(${reason})`
+      );
+      try {
+        const cfg = await getNatsConfig(baseUrl, sessionId, controller.signal);
+        if (!controller.signal.aborted) {
+          catchUpAfterConnectRef.current = reason !== 'initial';
           console.info('[NATS] config received', {
             url: cfg.url,
             jetStream: !!cfg.stream,
@@ -81,20 +96,65 @@ export function useNats({
           setConfig(cfg);
           setConfigError(null);
         }
-      })
-      .catch(err => {
-        if (!cancelled && err?.name !== 'AbortError') {
+      } catch (err: any) {
+        if (!controller.signal.aborted && err?.name !== 'AbortError') {
           console.error('[NATS] config error', err);
           setConfig(null);
           setConfigError(err instanceof Error ? err : new Error(String(err)));
         }
-      });
+      } finally {
+        if (abortRef.current === controller) {
+          abortRef.current = null;
+          refreshInFlightRef.current = false;
+        }
+      }
+    },
+    [baseUrl, sessionId]
+  );
 
+  // Fetch connection config whenever the active session changes.
+  useEffect(() => {
+    if (!sessionId) {
+      console.debug('[NATS] no sessionId, skipping config fetch');
+      setConfig(null);
+      setConfigError(null);
+      return;
+    }
+
+    void refreshConfig('initial');
     return () => {
-      cancelled = true;
-      controller.abort();
+      abortRef.current?.abort();
+      abortRef.current = null;
+      refreshInFlightRef.current = false;
     };
-  }, [baseUrl, sessionId]);
+  }, [sessionId, refreshConfig]);
+
+  // A suspended browser may lose core NATS messages. Refresh the short-lived
+  // JWT, reconnect, then reconcile the pending turn from the engine.
+  useEffect(() => {
+    if (!sessionId) return;
+
+    const requestResume = () => {
+      if (document.visibilityState === 'visible') {
+        void refreshConfig('resume');
+      }
+    };
+    const onVisibilityChange = () => {
+      if (document.visibilityState === 'visible') requestResume();
+    };
+    const onPageShow = (event: PageTransitionEvent) => {
+      if (event.persisted) requestResume();
+    };
+
+    document.addEventListener('visibilitychange', onVisibilityChange);
+    window.addEventListener('online', requestResume);
+    window.addEventListener('pageshow', onPageShow);
+    return () => {
+      document.removeEventListener('visibilitychange', onVisibilityChange);
+      window.removeEventListener('online', requestResume);
+      window.removeEventListener('pageshow', onPageShow);
+    };
+  }, [sessionId, refreshConfig]);
 
   const handleMessage = useCallback((event: NatsSessionEvent) => {
     console.debug('[NATS] dispatching event', { eventType: event.eventType });
@@ -113,7 +173,27 @@ export function useNats({
     }
   }, []);
 
-  useNatsSession(sessionId, config ?? undefined, handleMessage);
+  const handleConnected = useCallback(() => {
+    if (!catchUpAfterConnectRef.current) return;
+    catchUpAfterConnectRef.current = false;
+    void onCatchUpRef.current?.();
+  }, []);
+
+  const handleAuthError = useCallback(
+    (error: Error) => {
+      console.warn(
+        '[NATS] JWT rejected or expired; refreshing credentials',
+        error
+      );
+      void refreshConfig('auth');
+    },
+    [refreshConfig]
+  );
+
+  useNatsSession(sessionId, config ?? undefined, handleMessage, {
+    onConnected: handleConnected,
+    onAuthError: handleAuthError,
+  });
 
   return {
     /** True once connection config has been retrieved. */

package/src/helpers/nats/useNatsSession.test.ts

@@ -0,0 +1,16 @@
+import { AuthorizationError } from '@nats-io/nats-core';
+import { isNatsAuthError } from './useNatsSession';
+
+describe('isNatsAuthError', () => {
+  it('recognizes typed NATS authorization failures', () => {
+    expect(isNatsAuthError(new AuthorizationError('test'))).toBe(true);
+  });
+
+  it('recognizes the server authorization violation message', () => {
+    expect(isNatsAuthError(new Error('Authorization Violation'))).toBe(true);
+  });
+
+  it('does not classify unrelated connection failures as auth failures', () => {
+    expect(isNatsAuthError(new Error('connection refused'))).toBe(false);
+  });
+});