@memori.ai/memori-react 9.0.0-alpha.0 → 9.0.0-alpha.10

package/esm/helpers/nats/getNatsConfig.js

@@ -0,0 +1,61 @@
+function readStringField(raw, ...keys) {
+    for (const key of keys) {
+        const value = raw[key];
+        if (typeof value === 'string' && value.length > 0) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function readBooleanField(raw, ...keys) {
+    for (const key of keys) {
+        const value = raw[key];
+        if (typeof value === 'boolean') {
+            return value;
+        }
+    }
+    return undefined;
+}
+export function parseNatsConfig(raw) {
+    const url = readStringField(raw, 'url');
+    const token = readStringField(raw, 'token');
+    if (!url || !token) {
+        throw new Error('Invalid response from NATS config service');
+    }
+    const useJetStream = readBooleanField(raw, 'useJetStream', 'use_jetstream');
+    const stream = readStringField(raw, 'stream', 'streamName', 'stream_name');
+    const consumer = readStringField(raw, 'consumer', 'consumerName', 'consumer_name', 'durableName', 'durable_name');
+    const subject = readStringField(raw, 'subject', 'filterSubject', 'filter_subject');
+    if (useJetStream && !stream) {
+        throw new Error('Invalid response from NATS config service: JetStream enabled but stream missing');
+    }
+    return {
+        url,
+        token,
+        ...(stream ? { stream } : {}),
+        ...(consumer ? { consumer } : {}),
+        ...(subject ? { subject } : {}),
+    };
+}
+export async function getNatsConfig(baseUrl, sessionId, signal) {
+    if (!sessionId) {
+        throw new Error('Missing sessionId for NATS config request');
+    }
+    const response = await fetch(`${baseUrl}/api/nats?sessionId=${encodeURIComponent(sessionId)}`, { signal });
+    if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        switch (response.status) {
+            case 400:
+                throw new Error(errorData.error || 'NATS config error: missing sessionId');
+            case 404:
+                throw new Error(errorData.error || 'NATS config error: invalid session');
+            case 500:
+                throw new Error(errorData.error || 'NATS config error: NATS configuration missing');
+            default:
+                throw new Error(errorData.error || `NATS config error: ${response.status}`);
+        }
+    }
+    const data = (await response.json());
+    return parseNatsConfig(data);
+}
+//# sourceMappingURL=getNatsConfig.js.map

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

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

package/esm/helpers/nats/isSessionExpiredError.d.ts

@@ -0,0 +1,3 @@
+import type { NatsDialogResponseEvent, NatsErrorEvent } from './useNatsSession';
+export declare function isSessionExpiredNatsError(event: NatsErrorEvent): boolean;
+export declare function isSessionExpiredNatsResponse(event: NatsDialogResponseEvent): boolean;

package/esm/helpers/nats/isSessionExpiredError.js

@@ -0,0 +1,32 @@
+const SESSION_NOT_FOUND = -101;
+const SESSION_EXPIRED = -103;
+const SESSION_NOT_FOUND_MESSAGE = /session\s+with\s+id\s+["']?[^"']+["']?\s+not\s+found/i;
+function isExpiredResultCode(resultCode) {
+    return (resultCode === 404 ||
+        resultCode === SESSION_EXPIRED ||
+        resultCode === SESSION_NOT_FOUND);
+}
+function isExpiredErrorMessage(message) {
+    if (!message)
+        return false;
+    return SESSION_NOT_FOUND_MESSAGE.test(message);
+}
+export function isSessionExpiredNatsError(event) {
+    if (isExpiredResultCode(event.errorCode)) {
+        return true;
+    }
+    if (typeof event.errorCode === 'string') {
+        const code = event.errorCode.toUpperCase();
+        if (code.includes('SESSION_EXPIRED') || code.includes('SESSION_NOT_FOUND')) {
+            return true;
+        }
+    }
+    return isExpiredErrorMessage(event.errorMessage);
+}
+export function isSessionExpiredNatsResponse(event) {
+    if (isExpiredResultCode(event.resultCode)) {
+        return true;
+    }
+    return isExpiredErrorMessage(event.resultMessage);
+}
+//# sourceMappingURL=isSessionExpiredError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isSessionExpiredError.js","sourceRoot":"","sources":["../../../src/helpers/nats/isSessionExpiredError.ts"],"names":[],"mappings":"AAMA,MAAM,iBAAiB,GAAG,CAAC,GAAG,CAAC;AAC/B,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC;AAE7B,MAAM,yBAAyB,GAC7B,uDAAuD,CAAC;AAE1D,SAAS,mBAAmB,CAAC,UAAmB;IAC9C,OAAO,CACL,UAAU,KAAK,GAAG;QAClB,UAAU,KAAK,eAAe;QAC9B,UAAU,KAAK,iBAAiB,CACjC,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAgB;IAC7C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAGD,MAAM,UAAU,yBAAyB,CAAC,KAAqB;IAC7D,IAAI,mBAAmB,CAAC,KAAK,CAAC,SAA+B,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,qBAAqB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AACnD,CAAC;AAGD,MAAM,UAAU,4BAA4B,CAC1C,KAA8B;IAE9B,IAAI,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,qBAAqB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AACpD,CAAC"}

package/esm/helpers/nats/useNats.d.ts

@@ -0,0 +1,12 @@
+import { NatsProgressEvent, NatsDialogResponseEvent, NatsErrorEvent } from './useNatsSession';
+export interface UseNatsOptions {
+    baseUrl: string;
+    sessionId?: string;
+    onProgress?: (event: NatsProgressEvent) => void;
+    onDialogResponse?: (event: NatsDialogResponseEvent) => void;
+    onError?: (event: NatsErrorEvent) => void;
+}
+export declare function useNats({ baseUrl, sessionId, onProgress, onDialogResponse, onError, }: UseNatsOptions): {
+    connected: boolean;
+    configError: Error | null;
+};

package/esm/helpers/nats/useNats.js

@@ -0,0 +1,72 @@
+import { useEffect, useRef, useState, useCallback } from 'react';
+import { getNatsConfig } from './getNatsConfig';
+import { useNatsSession, } from './useNatsSession';
+export function useNats({ baseUrl, sessionId, onProgress, onDialogResponse, onError, }) {
+    const [config, setConfig] = useState(null);
+    const [configError, setConfigError] = useState(null);
+    const onProgressRef = useRef(onProgress);
+    const onDialogResponseRef = useRef(onDialogResponse);
+    const onErrorRef = useRef(onError);
+    useEffect(() => {
+        onProgressRef.current = onProgress;
+        onDialogResponseRef.current = onDialogResponse;
+        onErrorRef.current = onError;
+    }, [onProgress, onDialogResponse, onError]);
+    useEffect(() => {
+        if (!sessionId) {
+            console.debug('[NATS] no sessionId, skipping config fetch');
+            setConfig(null);
+            setConfigError(null);
+            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) {
+                console.info('[NATS] config received', {
+                    url: cfg.url,
+                    jetStream: !!cfg.stream,
+                    stream: cfg.stream,
+                });
+                setConfig(cfg);
+                setConfigError(null);
+            }
+        })
+            .catch(err => {
+            if (!cancelled && (err === null || err === void 0 ? void 0 : err.name) !== 'AbortError') {
+                console.error('[NATS] config error', err);
+                setConfig(null);
+                setConfigError(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+        return () => {
+            cancelled = true;
+            controller.abort();
+        };
+    }, [baseUrl, sessionId]);
+    const handleMessage = useCallback((event) => {
+        var _a, _b, _c;
+        console.debug('[NATS] dispatching event', { eventType: event.eventType });
+        switch (event.eventType) {
+            case 'progress':
+                (_a = onProgressRef.current) === null || _a === void 0 ? void 0 : _a.call(onProgressRef, event);
+                break;
+            case 'dialog_text_entered_response':
+                (_b = onDialogResponseRef.current) === null || _b === void 0 ? void 0 : _b.call(onDialogResponseRef, event);
+                break;
+            case 'error':
+                (_c = onErrorRef.current) === null || _c === void 0 ? void 0 : _c.call(onErrorRef, event);
+                break;
+            default:
+                console.warn('Unknown NATS event', event);
+        }
+    }, []);
+    useNatsSession(sessionId, config !== null && config !== void 0 ? config : undefined, handleMessage);
+    return {
+        connected: !!config,
+        configError,
+    };
+}
+//# sourceMappingURL=useNats.js.map

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

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

package/esm/helpers/nats/useNatsSession.d.ts

@@ -0,0 +1,28 @@
+import type { NatsConfig } from './getNatsConfig';
+export interface NatsProgressEvent {
+    eventType: 'progress';
+    jobId?: string;
+    currentStep?: number;
+    finalStep?: number;
+    message?: string;
+    startingTime?: string;
+    correlationID?: string;
+}
+export interface NatsDialogResponseEvent {
+    eventType: 'dialog_text_entered_response';
+    requestID?: string;
+    resultCode?: number;
+    resultMessage?: string;
+    currentState?: any;
+    correlationID?: string;
+}
+export interface NatsErrorEvent {
+    eventType: 'error';
+    errorCode?: string | number;
+    errorMessage?: string;
+    backtrace?: string;
+    correlationID?: string;
+}
+export type NatsSessionEvent = NatsProgressEvent | NatsDialogResponseEvent | NatsErrorEvent;
+export declare function normalizeNatsEvent(raw: Record<string, unknown>): NatsSessionEvent;
+export declare function useNatsSession(sessionId: string | undefined, config: NatsConfig | undefined, onMessage: (event: NatsSessionEvent) => void): void;

package/esm/helpers/nats/useNatsSession.js

@@ -0,0 +1,208 @@
+import { useEffect, useRef, useState } from 'react';
+import { wsconnect } from '@nats-io/nats-core';
+import { jetstream, DeliverPolicy, } from '@nats-io/jetstream';
+function readString(raw, camelKey, snakeKey) {
+    var _a;
+    const value = (_a = raw[camelKey]) !== null && _a !== void 0 ? _a : raw[snakeKey];
+    return typeof value === 'string' ? value : undefined;
+}
+function readNumber(raw, camelKey, snakeKey) {
+    var _a;
+    const value = (_a = raw[camelKey]) !== null && _a !== void 0 ? _a : raw[snakeKey];
+    return typeof value === 'number' ? value : undefined;
+}
+function unwrapDialogState(value) {
+    if (value &&
+        typeof value === 'object' &&
+        'currentState' in value) {
+        return value.currentState;
+    }
+    return value;
+}
+export function normalizeNatsEvent(raw) {
+    var _a, _b, _c;
+    const eventType = ((_a = readString(raw, 'eventType', 'event_type')) !== null && _a !== void 0 ? _a : 'unknown');
+    const correlationID = (_b = readString(raw, 'correlationID', 'correlation_id')) !== null && _b !== void 0 ? _b : readString(raw, 'correlationId', 'correlation_id');
+    if (eventType === 'progress') {
+        return {
+            eventType: 'progress',
+            jobId: readString(raw, 'jobId', 'job_id'),
+            currentStep: readNumber(raw, 'currentStep', 'current_step'),
+            finalStep: readNumber(raw, 'finalStep', 'final_step'),
+            message: typeof raw.message === 'string' ? raw.message : undefined,
+            startingTime: readString(raw, 'startingTime', 'starting_time'),
+            correlationID,
+        };
+    }
+    if (eventType === 'dialog_text_entered_response') {
+        return {
+            eventType: 'dialog_text_entered_response',
+            requestID: typeof raw.requestID === 'string' ? raw.requestID : undefined,
+            resultCode: typeof raw.resultCode === 'number' ? raw.resultCode : undefined,
+            resultMessage: typeof raw.resultMessage === 'string' ? raw.resultMessage : undefined,
+            currentState: unwrapDialogState(raw.currentState),
+            correlationID,
+        };
+    }
+    if (eventType === 'error') {
+        return {
+            eventType: 'error',
+            errorCode: ((_c = raw.errorCode) !== null && _c !== void 0 ? _c : raw.error_code),
+            errorMessage: readString(raw, 'errorMessage', 'error_message'),
+            backtrace: typeof raw.backtrace === 'string' ? raw.backtrace : undefined,
+            correlationID,
+        };
+    }
+    return {
+        eventType,
+        correlationID,
+    };
+}
+function decodeMessage(subject, received, raw, onMessage) {
+    const payload = normalizeNatsEvent(raw);
+    console.debug(`[NATS] message #${received} on ${subject} (eventType=${payload.eventType})`, payload);
+    onMessage(payload);
+}
+async function consumeCoreSubscription(nc, subject, onMessage) {
+    const sub = nc.subscribe(subject);
+    console.info('[NATS] subscribed to subject', subject);
+    let received = 0;
+    for await (const msg of sub) {
+        received += 1;
+        try {
+            decodeMessage(subject, received, msg.json(), onMessage);
+        }
+        catch (err) {
+            console.error('[NATS] message decode error', err);
+        }
+    }
+    console.info(`[NATS] subscription on ${subject} closed (received ${received} messages)`);
+}
+async function consumeJetStream(nc, config, subject, mode, onMessage, setConsumerMessages) {
+    const js = jetstream(nc);
+    const consumer = config.consumer
+        ? await js.consumers.get(config.stream, config.consumer)
+        : await js.consumers.get(config.stream, {
+            filter_subjects: [subject],
+            deliver_policy: mode === 'catch-up'
+                ? DeliverPolicy.LastPerSubject
+                : DeliverPolicy.New,
+        });
+    console.info('[NATS] JetStream consumer ready', config.consumer
+        ? { stream: config.stream, consumer: config.consumer, subject, mode }
+        : { stream: config.stream, subject, mode });
+    const messages = await consumer.consume();
+    setConsumerMessages(messages);
+    let received = 0;
+    for await (const msg of messages) {
+        received += 1;
+        try {
+            decodeMessage(subject, received, msg.json(), onMessage);
+        }
+        catch (err) {
+            console.error('[NATS] message decode error', err);
+        }
+    }
+    console.info(`[NATS] JetStream consumer on ${subject} closed (received ${received} messages)`);
+}
+function closeNatsSession(consumerMessagesRef, connRef) {
+    var _a, _b;
+    (_a = consumerMessagesRef.current) === null || _a === void 0 ? void 0 : _a.stop();
+    consumerMessagesRef.current = null;
+    (_b = connRef.current) === null || _b === void 0 ? void 0 : _b.close();
+    connRef.current = null;
+}
+export function useNatsSession(sessionId, config, onMessage) {
+    const connRef = useRef(null);
+    const consumerMessagesRef = useRef(null);
+    const onMessageRef = useRef(onMessage);
+    const wasHiddenRef = useRef(false);
+    const [resumeGeneration, setResumeGeneration] = useState(0);
+    useEffect(() => {
+        onMessageRef.current = onMessage;
+    }, [onMessage]);
+    useEffect(() => {
+        if (!sessionId || !(config === null || config === void 0 ? void 0 : config.stream)) {
+            return;
+        }
+        const requestResume = () => {
+            if (document.visibilityState !== 'visible') {
+                return;
+            }
+            console.info('[NATS] resuming JetStream after visibility/network change');
+            setResumeGeneration(generation => generation + 1);
+        };
+        const onVisibilityChange = () => {
+            if (document.visibilityState === 'hidden') {
+                wasHiddenRef.current = true;
+                return;
+            }
+            if (wasHiddenRef.current) {
+                wasHiddenRef.current = false;
+                requestResume();
+            }
+        };
+        const onPageShow = (event) => {
+            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, config === null || config === void 0 ? void 0 : config.stream]);
+    useEffect(() => {
+        var _a;
+        if (!sessionId || !(config === null || config === void 0 ? void 0 : config.url) || !config.token) {
+            console.debug('[NATS] subscription skipped (missing sessionId/url/token)', {
+                sessionId,
+                hasUrl: !!(config === null || config === void 0 ? void 0 : config.url),
+                hasToken: !!(config === null || config === void 0 ? void 0 : config.token),
+            });
+            return;
+        }
+        let closed = false;
+        const subject = (_a = config.subject) !== null && _a !== void 0 ? _a : `sessions.${sessionId}`;
+        const useJetStream = !!config.stream;
+        const jetStreamMode = useJetStream && resumeGeneration > 0 ? 'catch-up' : 'live';
+        (async () => {
+            console.info('[NATS] connecting to', config.url, 'for session', sessionId, useJetStream ? `(JetStream/${jetStreamMode})` : '(core)');
+            const nc = await wsconnect({
+                servers: [config.url],
+                token: config.token,
+            });
+            if (closed) {
+                console.debug('[NATS] connection established after cleanup, closing immediately');
+                await nc.close();
+                return;
+            }
+            connRef.current = nc;
+            console.info('[NATS] connected to', nc.getServer());
+            const dispatch = (event) => {
+                onMessageRef.current(event);
+            };
+            if (useJetStream) {
+                await consumeJetStream(nc, config, subject, jetStreamMode, dispatch, messages => {
+                    consumerMessagesRef.current = messages;
+                });
+            }
+            else {
+                await consumeCoreSubscription(nc, subject, dispatch);
+            }
+        })().catch(err => console.error('[NATS] connection error', err));
+        return () => {
+            console.info('[NATS] cleanup: closing connection for subject', subject);
+            closed = true;
+            closeNatsSession(consumerMessagesRef, connRef);
+        };
+    }, [sessionId, config, resumeGeneration]);
+    useEffect(() => {
+        setResumeGeneration(0);
+    }, [sessionId]);
+}
+//# sourceMappingURL=useNatsSession.js.map

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

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

package/esm/helpers/positionPopover.d.ts

@@ -0,0 +1 @@
+export declare function shouldRestartSessionOnPositionPopoverClose(wasOpen: boolean, nextOpen: boolean, autoStart: boolean): boolean;

package/esm/helpers/positionPopover.js

@@ -0,0 +1,4 @@
+export function shouldRestartSessionOnPositionPopoverClose(wasOpen, nextOpen, autoStart) {
+    return wasOpen && !nextOpen && !!autoStart;
+}
+//# sourceMappingURL=positionPopover.js.map

package/esm/helpers/positionPopover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positionPopover.js","sourceRoot":"","sources":["../../src/helpers/positionPopover.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,0CAA0C,CACxD,OAAgB,EAChB,QAAiB,EACjB,SAAkB;IAElB,OAAO,OAAO,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC"}

package/esm/helpers/usePressTooltip.d.ts

@@ -0,0 +1,13 @@
+import { type MouseEvent, type PointerEvent } from 'react';
+export declare function usePressTooltip(defaultOpen?: boolean): {
+    open: boolean;
+    setOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    pressTriggerProps: {
+        readonly onPointerDown: (e: PointerEvent) => void;
+        readonly onClick: (e: MouseEvent | PointerEvent) => void;
+    };
+    tooltipProps: {
+        readonly open: boolean;
+        readonly onOpenChange: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    };
+};

package/esm/helpers/usePressTooltip.js

@@ -0,0 +1,20 @@
+import { useCallback, useState, } from 'react';
+export function usePressTooltip(defaultOpen = false) {
+    const [open, setOpen] = useState(defaultOpen);
+    const toggleOpen = useCallback((e) => {
+        e.stopPropagation();
+        setOpen(prev => !prev);
+    }, []);
+    const pressTriggerProps = {
+        onPointerDown: (e) => {
+            e.stopPropagation();
+        },
+        onClick: toggleOpen,
+    };
+    const tooltipProps = {
+        open,
+        onOpenChange: setOpen,
+    };
+    return { open, setOpen, pressTriggerProps, tooltipProps };
+}
+//# sourceMappingURL=usePressTooltip.js.map

package/esm/helpers/usePressTooltip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePressTooltip.js","sourceRoot":"","sources":["../../src/helpers/usePressTooltip.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,QAAQ,GAGT,MAAM,OAAO,CAAC;AAEf,MAAM,UAAU,eAAe,CAAC,WAAW,GAAG,KAAK;IACjD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAE9C,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAA4B,EAAE,EAAE;QAC9D,CAAC,CAAC,eAAe,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,iBAAiB,GAAG;QACxB,aAAa,EAAE,CAAC,CAAe,EAAE,EAAE;YACjC,CAAC,CAAC,eAAe,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,EAAE,UAAU;KACX,CAAC;IAEX,MAAM,YAAY,GAAG;QACnB,IAAI;QACJ,YAAY,EAAE,OAAO;KACb,CAAC;IAEX,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;AAC5D,CAAC"}

package/esm/helpers/utils.d.ts

@@ -15,7 +15,28 @@ export declare function useDebounceFn<T extends (...args: any) => any>(fn: T, de
 export declare const stripDuplicates: (text: string) => string;
 export declare const stripEmojis: (text: string) => string;
 export declare const stripMarkdown: (text: string) => string;
+export declare const OFFICE_NATIVE_EXTENSIONS: readonly [".doc", ".docx", ".dotx", ".xltx", ".potx"];
+export declare const isOfficeNativeFilename: (filename: string) => boolean;
+export type ParsedDocumentAttachment = {
+    filename: string;
+    type: string;
+    content: string;
+    url: string;
+};
+export declare const parseDocumentAttachmentsFromMessage: (text: string) => ParsedDocumentAttachment[];
+export declare const extractAttachmentLinks: (content: string) => string[];
+export declare const extractAttachmentLink: (content: string) => string | null;
 export declare const stripDocumentAttachmentTags: (text: string) => string;
+export declare const getDocumentAttachmentAssetUrl: (attachment: {
+    content?: string | null;
+    url?: string | null;
+}) => string;
+export declare const isAssetOnlyDocumentAttachment: (attachment: {
+    title?: string;
+    name?: string;
+    content?: string | null;
+    url?: string | null;
+}) => boolean;
 export declare const stripOutputTags: (text: string) => string;
 export declare const stripReasoningTags: (text: string) => string;
 export declare const stripHTML: (text: string) => string;

package/esm/helpers/utils.js

@@ -1,6 +1,7 @@
 import { useState, useEffect, useRef, useMemo } from 'react';
 import { MeshStandardMaterial } from 'three';
 import * as THREE from 'three';
+import { officeNativeExtensions } from './constants';
 export const hasTouchscreen = () => {
     let hasTouchScreen = false;
     if (typeof window === 'undefined' || typeof navigator === 'undefined') {
@@ -168,6 +169,45 @@ export const stripMarkdown = (text) => {
     text = text.replaceAll(/\s+/g, ' ').trim();
     return text;
 };
+export const OFFICE_NATIVE_EXTENSIONS = officeNativeExtensions;
+export const isOfficeNativeFilename = (filename) => {
+    var _a;
+    const ext = `.${((_a = filename.split('.').pop()) === null || _a === void 0 ? void 0 : _a.toLowerCase()) || ''}`;
+    return officeNativeExtensions.includes(ext);
+};
+const DOCUMENT_ATTACHMENT_REGEX = /<document_attachment filename="([^"]+)" type="([^"]+)">([\s\S]*?)<\/document_attachment>/g;
+const ATTACHMENT_LINK_AFTER_REGEX = /<attachment_link>\s*([\s\S]*?)\s*<\/attachment_link>/;
+export const parseDocumentAttachmentsFromMessage = (text) => {
+    var _a;
+    if (!text)
+        return [];
+    const attachments = [];
+    const regex = new RegExp(DOCUMENT_ATTACHMENT_REGEX.source, 'g');
+    let match;
+    while ((match = regex.exec(text)) !== null) {
+        const [, filename, type, content] = match;
+        const afterTag = text.slice(match.index + match[0].length);
+        const linkMatch = afterTag.match(ATTACHMENT_LINK_AFTER_REGEX);
+        const rawUrl = ((_a = linkMatch === null || linkMatch === void 0 ? void 0 : linkMatch[1]) === null || _a === void 0 ? void 0 : _a.trim()) || '';
+        const url = /^https?:\/\//.test(rawUrl) ? rawUrl : '';
+        attachments.push({
+            filename,
+            type,
+            content: content.trim(),
+            url,
+        });
+    }
+    return attachments;
+};
+export const extractAttachmentLinks = (content) => {
+    return parseDocumentAttachmentsFromMessage(content).map(attachment => attachment.url);
+};
+export const extractAttachmentLink = (content) => {
+    var _a;
+    const match = content === null || content === void 0 ? void 0 : content.match(/<attachment_link>\s*([\s\S]*?)\s*<\/attachment_link>/);
+    const rawUrl = ((_a = match === null || match === void 0 ? void 0 : match[1]) === null || _a === void 0 ? void 0 : _a.trim()) || '';
+    return /^https?:\/\//.test(rawUrl) ? rawUrl : null;
+};
 export const stripDocumentAttachmentTags = (text) => {
     const documentAttachmentTagRegex = /<document_attachment filename="([^"]+)" type="([^"]+)">([\s\S]*?)<\/document_attachment>/g;
     return text
@@ -175,6 +215,25 @@ export const stripDocumentAttachmentTags = (text) => {
         .replace(/<attachment_source>\s*[\s\S]*?\s*<\/attachment_source>/g, '')
         .replace(/<attachment_link>\s*[\s\S]*?\s*<\/attachment_link>/g, '');
 };
+export const getDocumentAttachmentAssetUrl = (attachment) => {
+    var _a;
+    return ((_a = attachment.url) === null || _a === void 0 ? void 0 : _a.trim()) ||
+        extractAttachmentLink(attachment.content || '') ||
+        '';
+};
+export const isAssetOnlyDocumentAttachment = (attachment) => {
+    const filename = attachment.title || attachment.name || '';
+    const assetUrl = getDocumentAttachmentAssetUrl(attachment);
+    if (!assetUrl)
+        return false;
+    if (isOfficeNativeFilename(filename)) {
+        return true;
+    }
+    const strippedContent = attachment.content
+        ? stripDocumentAttachmentTags(attachment.content).trim()
+        : '';
+    return !strippedContent;
+};
 export const stripOutputTags = (text) => {
     const outputTagRegex = /<output.*?<\/output>/gs;
     if (!outputTagRegex.test(text)) {
@@ -192,9 +251,15 @@ export const stripReasoningTags = (text) => {
     return strippedText;
 };
 export const stripHTML = (text) => {
-    const el = document.createElement('div');
-    el.innerHTML = text;
-    return el.textContent || '';
+    if (typeof DOMParser !== 'undefined') {
+        try {
+            return (new DOMParser().parseFromString(text, 'text/html').body.textContent ||
+                '');
+        }
+        catch (_a) {
+        }
+    }
+    return text.replace(/<[^>]*>/g, '');
 };
 export const withLinksOpenInNewTab = (html) => html.replace(/<a\s+/gi, '<a target="_blank" rel="noopener noreferrer" ');
 export const escapeHTML = (text) => {