@botonic/webchat-core 2.36.0 → 2.38.0

package/src/lib/infra/repositories/storage/base-storage.js

@@ -1,8 +1,12 @@
 import { __awaiter } from "tslib";
-const DEFAULT_KEY_PREFIX = 'botonic-webchat';
+import { APP_CLIENT_STATE_PLACEHOLDER_USER_ID, DEFAULT_KEY_PREFIX, } from './client-state-constants';
 export class BaseStorageRepository {
-    constructor(keyPrefix = DEFAULT_KEY_PREFIX) {
-        this.keyPrefix = keyPrefix;
+    constructor(options = DEFAULT_KEY_PREFIX) {
+        var _a;
+        this.keyPrefix =
+            typeof options === 'string'
+                ? options
+                : ((_a = options.keyPrefix) !== null && _a !== void 0 ? _a : DEFAULT_KEY_PREFIX);
     }
     getConversationKey(appId, userId) {
         return `${this.keyPrefix}:${appId}:${userId}`;
@@ -10,6 +14,16 @@ export class BaseStorageRepository {
     getAppStoragePrefix(appId) {
         return `${this.keyPrefix}:${appId}:`;
     }
+    createStoredAnonymousUser(userId, lastActiveAt) {
+        return {
+            id: userId,
+            name: 'Anonymous User',
+            locale: '',
+            country: '',
+            system_locale: '',
+            lastActiveAt,
+        };
+    }
     getConversationData(appId, userId) {
         const key = this.getConversationKey(appId, userId);
         const data = this.getData(key);
@@ -19,6 +33,65 @@ export class BaseStorageRepository {
         const key = this.getConversationKey(appId, userId);
         this.setData(key, data);
     }
+    getCustomState(data) {
+        var _a;
+        return (_a = data.custom) !== null && _a !== void 0 ? _a : {};
+    }
+    withCustomState(data, customState) {
+        return Object.assign(Object.assign({}, data), { custom: customState });
+    }
+    resolveClientStateUserId(appId) {
+        var _a;
+        const prefix = this.getAppStoragePrefix(appId);
+        const keys = this.getKeysWithPrefix(prefix);
+        let mostRecentUserId = null;
+        let mostRecentTimestamp = null;
+        for (const key of keys) {
+            const suffix = key.slice(prefix.length);
+            if (!suffix || suffix === APP_CLIENT_STATE_PLACEHOLDER_USER_ID) {
+                continue;
+            }
+            const data = this.getData(key);
+            if ((_a = data === null || data === void 0 ? void 0 : data.user) === null || _a === void 0 ? void 0 : _a.lastActiveAt) {
+                if (!mostRecentTimestamp ||
+                    new Date(data.user.lastActiveAt) > new Date(mostRecentTimestamp)) {
+                    mostRecentUserId = data.user.id;
+                    mostRecentTimestamp = data.user.lastActiveAt;
+                }
+            }
+        }
+        return mostRecentUserId !== null && mostRecentUserId !== void 0 ? mostRecentUserId : APP_CLIENT_STATE_PLACEHOLDER_USER_ID;
+    }
+    findAppClientState(appId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const userId = this.resolveClientStateUserId(appId);
+            const data = this.getConversationData(appId, userId);
+            return Object.assign({}, this.getCustomState(data));
+        });
+    }
+    saveAppClientState(appId, state) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const userId = this.resolveClientStateUserId(appId);
+            const data = this.getConversationData(appId, userId);
+            this.saveConversationData(appId, userId, this.withCustomState(data, state));
+        });
+    }
+    reconcilePlaceholderConversation(appId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const placeholderKey = this.getConversationKey(appId, APP_CLIENT_STATE_PLACEHOLDER_USER_ID);
+            if (this.getData(placeholderKey) == null) {
+                return;
+            }
+            const lastUser = yield this.findLastUserSession(appId);
+            if (lastUser) {
+                let data = this.getConversationData(appId, lastUser.id);
+                data = this.mergePlaceholderCustomIntoUser(appId, lastUser.id, data);
+                this.saveConversationData(appId, lastUser.id, data);
+                return;
+            }
+            yield this.clearConversation(appId, APP_CLIENT_STATE_PLACEHOLDER_USER_ID);
+        });
+    }
     saveMessage(appId, userId, message) {
         return __awaiter(this, void 0, void 0, function* () {
             const data = this.getConversationData(appId, userId);
@@ -37,6 +110,9 @@ export class BaseStorageRepository {
         return __awaiter(this, void 0, void 0, function* () {
             const data = this.getConversationData(appId, userId);
             data.messages = messages;
+            const now = new Date().toISOString();
+            data.user = data.user
+                ? Object.assign(Object.assign({}, data.user), { lastActiveAt: now }) : this.createStoredAnonymousUser(userId, now);
             this.saveConversationData(appId, userId, data);
         });
     }
@@ -46,9 +122,20 @@ export class BaseStorageRepository {
             return data.messages;
         });
     }
+    mergePlaceholderCustomIntoUser(appId, userId, data) {
+        const placeholder = this.getConversationData(appId, APP_CLIENT_STATE_PLACEHOLDER_USER_ID);
+        const placeholderState = this.getCustomState(placeholder);
+        if (Object.keys(placeholderState).length === 0) {
+            return data;
+        }
+        const mergedState = Object.assign(Object.assign({}, placeholderState), this.getCustomState(data));
+        this.clearConversation(appId, APP_CLIENT_STATE_PLACEHOLDER_USER_ID);
+        return this.withCustomState(data, mergedState);
+    }
     saveUser(appId, user) {
         return __awaiter(this, void 0, void 0, function* () {
-            const data = this.getConversationData(appId, user.id);
+            let data = this.getConversationData(appId, user.id);
+            data = this.mergePlaceholderCustomIntoUser(appId, user.id, data);
             const webchatUser = Object.assign(Object.assign({}, user), { lastActiveAt: new Date().toISOString() });
             data.user = webchatUser;
             this.saveConversationData(appId, user.id, data);
@@ -67,12 +154,16 @@ export class BaseStorageRepository {
     }
     findLastUserSession(appId) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a;
+            var _a, _b;
             const prefix = this.getAppStoragePrefix(appId);
             const keys = this.getKeysWithPrefix(prefix);
             let mostRecentUser = null;
             let mostRecentTimestamp = null;
             for (const key of keys) {
+                const suffix = key.slice(prefix.length);
+                if (!suffix || suffix === APP_CLIENT_STATE_PLACEHOLDER_USER_ID) {
+                    continue;
+                }
                 const data = this.getData(key);
                 if ((_a = data === null || data === void 0 ? void 0 : data.user) === null || _a === void 0 ? void 0 : _a.lastActiveAt) {
                     if (!mostRecentTimestamp ||
@@ -82,7 +173,27 @@ export class BaseStorageRepository {
                     }
                 }
             }
-            return mostRecentUser;
+            if (mostRecentUser) {
+                return mostRecentUser;
+            }
+            let fallbackUser = null;
+            let fallbackMessageCount = -1;
+            for (const key of keys) {
+                const suffix = key.slice(prefix.length);
+                if (!suffix || suffix === APP_CLIENT_STATE_PLACEHOLDER_USER_ID) {
+                    continue;
+                }
+                const data = this.getData(key);
+                if (!data || data.messages.length === 0) {
+                    continue;
+                }
+                if (data.messages.length > fallbackMessageCount) {
+                    fallbackMessageCount = data.messages.length;
+                    fallbackUser =
+                        (_b = data.user) !== null && _b !== void 0 ? _b : this.createStoredAnonymousUser(suffix, new Date().toISOString());
+                }
+            }
+            return fallbackUser;
         });
     }
     clearConversation(appId, userId) {

package/src/lib/infra/repositories/storage/base-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-storage.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/base-storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-storage.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/base-storage.ts"],"names":[],"mappings":"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"}

package/src/lib/infra/repositories/storage/browser-storage.js

@@ -1,14 +1,11 @@
 import { BaseStorageRepository } from './base-storage';
+import { parseConversationData } from './parse-conversation-data';
 export class BrowserStorageRepository extends BaseStorageRepository {
     getData(key) {
         const stored = this.storage.getItem(key);
         if (stored) {
             try {
-                const parsed = JSON.parse(stored);
-                return {
-                    messages: Array.isArray(parsed.messages) ? parsed.messages : [],
-                    user: parsed.user || null,
-                };
+                return parseConversationData(JSON.parse(stored));
             }
             catch (error) {
                 console.error('Failed to parse conversation data:', error);

package/src/lib/infra/repositories/storage/browser-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-storage.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/browser-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAGtD,MAAM,OAAgB,wBAAyB,SAAQ,qBAAqB;IAGhE,OAAO,CAAC,GAAW;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAExC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBACjC,OAAO;oBACL,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;oBAC/D,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;iBAC1B,CAAA;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAA;YAC5D,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAES,OAAO,CAAC,GAAW,EAAE,IAAsB;QACnD,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK;gBACtB,CAAC,KAAK,CAAC,IAAI,KAAK,oBAAoB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;YAC1E,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAA;YAC1E,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAES,UAAU,CAAC,GAAW;QAC9B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IAES,iBAAiB,CAAC,MAAc;QACxC,MAAM,IAAI,GAAa,EAAE,CAAA;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAC/B,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAChB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}
+{"version":3,"file":"browser-storage.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/browser-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAGjE,MAAM,OAAgB,wBAAyB,SAAQ,qBAAqB;IAGhE,OAAO,CAAC,GAAW;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAExC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBACH,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;YAClD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAA;YAC5D,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAES,OAAO,CAAC,GAAW,EAAE,IAAsB;QACnD,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK;gBACtB,CAAC,KAAK,CAAC,IAAI,KAAK,oBAAoB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;YAC1E,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAA;YAC1E,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAES,UAAU,CAAC,GAAW;QAC9B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IAES,iBAAiB,CAAC,MAAc;QACxC,MAAM,IAAI,GAAa,EAAE,CAAA;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAC/B,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAChB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/src/lib/infra/repositories/storage/client-state-constants.d.ts

@@ -0,0 +1,4 @@
+/** Framework default storage key prefix (`{prefix}:{appId}:{userId}`). */
+export declare const DEFAULT_KEY_PREFIX = "botonic-webchat";
+/** Conversation user id used before a Hubtype user exists (empty — filled when a real session starts). */
+export declare const APP_CLIENT_STATE_PLACEHOLDER_USER_ID = "";

package/src/lib/infra/repositories/storage/client-state-constants.js

@@ -0,0 +1,5 @@
+/** Framework default storage key prefix (`{prefix}:{appId}:{userId}`). */
+export const DEFAULT_KEY_PREFIX = 'botonic-webchat';
+/** Conversation user id used before a Hubtype user exists (empty — filled when a real session starts). */
+export const APP_CLIENT_STATE_PLACEHOLDER_USER_ID = '';
+//# sourceMappingURL=client-state-constants.js.map

package/src/lib/infra/repositories/storage/client-state-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-state-constants.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/client-state-constants.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAA;AAEnD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,oCAAoC,GAAG,EAAE,CAAA"}

package/src/lib/infra/repositories/storage/factory.js

@@ -1,20 +1,22 @@
+import { DEFAULT_KEY_PREFIX } from './client-state-constants';
 import { InMemoryRepository } from './in-memory';
 import { LocalStorageRepository } from './local-storage';
 import { SessionStorageRepository } from './session-storage';
 export function createStorageRepository(config) {
-    const { type = 'localStorage', keyPrefix = 'botonic-webchat' } = config || {};
+    const { type = 'localStorage', keyPrefix = DEFAULT_KEY_PREFIX } = config || {};
+    const repositoryOptions = { keyPrefix };
     if (type === 'inMemory') {
-        return new InMemoryRepository();
+        return new InMemoryRepository(repositoryOptions);
     }
     if (typeof window === 'undefined') {
-        return new InMemoryRepository();
+        return new InMemoryRepository(repositoryOptions);
     }
     if (type === 'sessionStorage' && window.sessionStorage) {
-        return new SessionStorageRepository(keyPrefix);
+        return new SessionStorageRepository(repositoryOptions);
     }
     if (type === 'localStorage' && window.localStorage) {
-        return new LocalStorageRepository(keyPrefix);
+        return new LocalStorageRepository(repositoryOptions);
     }
-    return new InMemoryRepository();
+    return new InMemoryRepository(repositoryOptions);
 }
 //# sourceMappingURL=factory.js.map

package/src/lib/infra/repositories/storage/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAG5D,MAAM,UAAU,uBAAuB,CACrC,MAAsB;IAEtB,MAAM,EAAE,IAAI,GAAG,cAAc,EAAE,SAAS,GAAG,iBAAiB,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;IAE7E,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,IAAI,kBAAkB,EAAE,CAAA;IACjC,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,kBAAkB,EAAE,CAAA;IACjC,CAAC;IAED,IAAI,IAAI,KAAK,gBAAgB,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QACvD,OAAO,IAAI,wBAAwB,CAAC,SAAS,CAAC,CAAA;IAChD,CAAC;IAED,IAAI,IAAI,KAAK,cAAc,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACnD,OAAO,IAAI,sBAAsB,CAAC,SAAS,CAAC,CAAA;IAC9C,CAAC;IAED,OAAO,IAAI,kBAAkB,EAAE,CAAA;AACjC,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAG5D,MAAM,UAAU,uBAAuB,CACrC,MAAsB;IAEtB,MAAM,EAAE,IAAI,GAAG,cAAc,EAAE,SAAS,GAAG,kBAAkB,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;IAC9E,MAAM,iBAAiB,GAAG,EAAE,SAAS,EAAE,CAAA;IAEvC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;IAClD,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;IAClD,CAAC;IAED,IAAI,IAAI,KAAK,gBAAgB,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QACvD,OAAO,IAAI,wBAAwB,CAAC,iBAAiB,CAAC,CAAA;IACxD,CAAC;IAED,IAAI,IAAI,KAAK,cAAc,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACnD,OAAO,IAAI,sBAAsB,CAAC,iBAAiB,CAAC,CAAA;IACtD,CAAC;IAED,OAAO,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;AAClD,CAAC"}

package/src/lib/infra/repositories/storage/in-memory.js

@@ -15,7 +15,13 @@ export class InMemoryRepository extends BaseStorageRepository {
         this.storage.delete(key);
     }
     getKeysWithPrefix(prefix) {
-        return Array.from(this.storage.keys()).filter(key => key.startsWith(prefix));
+        const keys = [];
+        for (const key of this.storage.keys()) {
+            if (key.startsWith(prefix)) {
+                keys.push(key);
+            }
+        }
+        return keys;
     }
 }
 //# sourceMappingURL=in-memory.js.map

package/src/lib/infra/repositories/storage/in-memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAGtD,MAAM,OAAO,kBAAmB,SAAQ,qBAAqB;IAA7D;;QACU,YAAO,GAAG,IAAI,GAAG,EAA4B,CAAA;IAiBvD,CAAC;IAfW,OAAO,CAAC,GAAW;;QAC3B,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,mCAAI,IAAI,CAAA;IACtC,CAAC;IAES,OAAO,CAAC,GAAW,EAAE,IAAsB;QACnD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC7B,CAAC;IAES,UAAU,CAAC,GAAW;QAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;IAES,iBAAiB,CAAC,MAAc;QACxC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;IAC9E,CAAC;CACF"}
+{"version":3,"file":"in-memory.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAGtD,MAAM,OAAO,kBAAmB,SAAQ,qBAAqB;IAA7D;;QACU,YAAO,GAAG,IAAI,GAAG,EAA4B,CAAA;IAuBvD,CAAC;IArBW,OAAO,CAAC,GAAW;;QAC3B,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,mCAAI,IAAI,CAAA;IACtC,CAAC;IAES,OAAO,CAAC,GAAW,EAAE,IAAsB;QACnD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC7B,CAAC;IAES,UAAU,CAAC,GAAW;QAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;IAES,iBAAiB,CAAC,MAAc;QACxC,MAAM,IAAI,GAAa,EAAE,CAAA;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAChB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/src/lib/infra/repositories/storage/index.d.ts

@@ -3,5 +3,6 @@ export { BrowserStorageRepository } from './browser-storage';
 export { createStorageRepository } from './factory';
 export { InMemoryRepository } from './in-memory';
 export { LocalStorageRepository } from './local-storage';
+export { resetWebchatSessionInitLocksForTests, resolveWebchatSessionUser, } from './resolve-webchat-session-user';
 export { SessionStorageRepository } from './session-storage';
-export type { ConversationData, StorageConfig, StorageRepository, StorageType, StoredMessage, WebchatHubtypeUser, } from './types';
+export type { AppClientState, ConversationData, StorageConfig, StorageRepository, StorageType, StoredMessage, WebchatHubtypeUser, } from './types';

package/src/lib/infra/repositories/storage/index.js

@@ -3,5 +3,6 @@ export { BrowserStorageRepository } from './browser-storage';
 export { createStorageRepository } from './factory';
 export { InMemoryRepository } from './in-memory';
 export { LocalStorageRepository } from './local-storage';
+export { resetWebchatSessionInitLocksForTests, resolveWebchatSessionUser, } from './resolve-webchat-session-user';
 export { SessionStorageRepository } from './session-storage';
 //# sourceMappingURL=index.js.map

package/src/lib/infra/repositories/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EACL,oCAAoC,EACpC,yBAAyB,GAC1B,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA"}

package/src/lib/infra/repositories/storage/parse-conversation-data.d.ts

@@ -0,0 +1,2 @@
+import type { ConversationData } from './types';
+export declare function parseConversationData(parsed: unknown): ConversationData;

package/src/lib/infra/repositories/storage/parse-conversation-data.js

@@ -0,0 +1,19 @@
+export function parseConversationData(parsed) {
+    if (!parsed || typeof parsed !== 'object') {
+        return { messages: [], user: null };
+    }
+    const record = parsed;
+    const customRaw = record.custom;
+    let custom;
+    if (customRaw && typeof customRaw === 'object') {
+        custom = customRaw;
+    }
+    return {
+        messages: Array.isArray(record.messages)
+            ? record.messages
+            : [],
+        user: record.user || null,
+        custom,
+    };
+}
+//# sourceMappingURL=parse-conversation-data.js.map

package/src/lib/infra/repositories/storage/parse-conversation-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-conversation-data.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/parse-conversation-data.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACrC,CAAC;IACD,MAAM,MAAM,GAAG,MAAiC,CAAA;IAChD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAA;IAC/B,IAAI,MAAkC,CAAA;IACtC,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC/C,MAAM,GAAG,SAA2B,CAAA;IACtC,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YACtC,CAAC,CAAE,MAAM,CAAC,QAAyC;YACnD,CAAC,CAAC,EAAE;QACN,IAAI,EAAG,MAAM,CAAC,IAAiC,IAAI,IAAI;QACvD,MAAM;KACP,CAAA;AACH,CAAC"}

package/src/lib/infra/repositories/storage/resolve-webchat-session-user.d.ts

@@ -0,0 +1,9 @@
+import type { HubtypeUser } from '@botonic/shared';
+import type { StorageRepository } from './types';
+/**
+ * Returns the persisted session user for an app, or creates and saves one exactly once
+ * even when multiple webchat inits run in parallel (e.g. React Strict Mode remount).
+ */
+export declare function resolveWebchatSessionUser(storage: StorageRepository, appId: string, createAnonymous: () => HubtypeUser): Promise<HubtypeUser>;
+/** @internal */
+export declare function resetWebchatSessionInitLocksForTests(): void;

package/src/lib/infra/repositories/storage/resolve-webchat-session-user.js

@@ -0,0 +1,41 @@
+import { __awaiter } from "tslib";
+const pendingSessionByAppId = new Map();
+/**
+ * Returns the persisted session user for an app, or creates and saves one exactly once
+ * even when multiple webchat inits run in parallel (e.g. React Strict Mode remount).
+ */
+export function resolveWebchatSessionUser(storage, appId, createAnonymous) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const existing = yield storage.findLastUserSession(appId);
+        if (existing) {
+            return existing;
+        }
+        const inFlight = pendingSessionByAppId.get(appId);
+        if (inFlight) {
+            return inFlight;
+        }
+        const promise = (() => __awaiter(this, void 0, void 0, function* () {
+            const again = yield storage.findLastUserSession(appId);
+            if (again) {
+                return again;
+            }
+            const user = createAnonymous();
+            yield storage.saveUser(appId, user);
+            return user;
+        }))();
+        pendingSessionByAppId.set(appId, promise);
+        try {
+            return yield promise;
+        }
+        finally {
+            if (pendingSessionByAppId.get(appId) === promise) {
+                pendingSessionByAppId.delete(appId);
+            }
+        }
+    });
+}
+/** @internal */
+export function resetWebchatSessionInitLocksForTests() {
+    pendingSessionByAppId.clear();
+}
+//# sourceMappingURL=resolve-webchat-session-user.js.map

package/src/lib/infra/repositories/storage/resolve-webchat-session-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-webchat-session-user.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/resolve-webchat-session-user.ts"],"names":[],"mappings":";AAIA,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAgC,CAAA;AAErE;;;GAGG;AACH,MAAM,UAAgB,yBAAyB,CAC7C,OAA0B,EAC1B,KAAa,EACb,eAAkC;;QAElC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAA;QACzD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,MAAM,QAAQ,GAAG,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,GAAS,EAAE;YAC1B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAA;YACtD,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,KAAK,CAAA;YACd,CAAC;YACD,MAAM,IAAI,GAAG,eAAe,EAAE,CAAA;YAC9B,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YACnC,OAAO,IAAI,CAAA;QACb,CAAC,CAAA,CAAC,EAAE,CAAA;QAEJ,qBAAqB,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAEzC,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAA;QACtB,CAAC;gBAAS,CAAC;YACT,IAAI,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC;gBACjD,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;IACH,CAAC;CAAA;AAED,gBAAgB;AAChB,MAAM,UAAU,oCAAoC;IAClD,qBAAqB,CAAC,KAAK,EAAE,CAAA;AAC/B,CAAC"}

package/src/lib/infra/repositories/storage/storage-test-helpers.d.ts

@@ -0,0 +1,2 @@
+import type { HubtypeUser } from '@botonic/shared';
+export declare function createMockUser(id: string): HubtypeUser;

package/src/lib/infra/repositories/storage/storage-test-helpers.js

@@ -0,0 +1,10 @@
+export function createMockUser(id) {
+    return {
+        id,
+        name: 'Test User',
+        locale: 'en',
+        country: 'US',
+        system_locale: 'en-US',
+    };
+}
+//# sourceMappingURL=storage-test-helpers.js.map

package/src/lib/infra/repositories/storage/storage-test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-test-helpers.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/webchat-core/src/lib/infra/repositories/storage/storage-test-helpers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,OAAO;KACvB,CAAA;AACH,CAAC"}

package/src/lib/infra/repositories/storage/types.d.ts

@@ -9,9 +9,12 @@ export interface WebchatHubtypeUser extends HubtypeUser {
     botId?: string;
     chatId?: string;
 }
+/** Flat attribute bag on `ConversationData.custom` (app-specific attrs via `WebchatClientState`). */
+export type AppClientState = Record<string, unknown>;
 export interface ConversationData {
     messages: StoredMessage[];
     user: WebchatHubtypeUser | null;
+    custom?: AppClientState;
 }
 export interface StorageRepository {
     saveMessage(appId: string, userId: string, message: StoredMessage): Promise<void>;
@@ -23,9 +26,17 @@ export interface StorageRepository {
     findLastUserSession(appId: string): Promise<HubtypeUser | null>;
     clearConversation(appId: string, userId: string): Promise<void>;
     clearAppData(appId: string): Promise<void>;
+    findAppClientState(appId: string): Promise<AppClientState>;
+    saveAppClientState(appId: string, state: AppClientState): Promise<void>;
+    /**
+     * Merges placeholder-key client state into the active user conversation and
+     * deletes the orphan `prefix:appId:` row (e.g. after pre-user `saveAppClientState`).
+     */
+    reconcilePlaceholderConversation(appId: string): Promise<void>;
 }
 export type StorageType = 'localStorage' | 'sessionStorage' | 'inMemory';
 export interface StorageConfig {
     type?: StorageType;
+    /** Storage key prefix (default `botonic-webchat`; apps may set e.g. `botonicLocalState`). */
     keyPrefix?: string;
 }

package/src/lib/machines/embed-trigger.d.ts

@@ -0,0 +1,17 @@
+export interface EmbedTriggerContext {
+    firstHoverExpandShown: boolean;
+}
+export type EmbedTriggerInput = Record<string, never>;
+export type EmbedTriggerEvent = {
+    type: 'MARK_FIRST_HOVER_EXPAND_SHOWN';
+};
+/** In-memory first-visit hover expand flag (not written to `WebchatClientState`). */
+export declare const embedTriggerMachine: import("xstate").StateMachine<EmbedTriggerContext, EmbedTriggerEvent, {}, never, never, never, never, "ready", string, EmbedTriggerInput, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+    id: "embedTrigger";
+    states: {
+        readonly ready: {};
+    };
+}>;
+export declare function isEmbedTriggerHydrated(state: {
+    matches: (value: string) => boolean;
+}): boolean;

package/src/lib/machines/embed-trigger.js

@@ -0,0 +1,29 @@
+import { assign, setup } from 'xstate';
+/** In-memory first-visit hover expand flag (not written to `WebchatClientState`). */
+export const embedTriggerMachine = setup({
+    types: {
+        context: {},
+        input: {},
+        events: {},
+    },
+}).createMachine({
+    id: 'embedTrigger',
+    initial: 'ready',
+    context: {
+        firstHoverExpandShown: false,
+    },
+    states: {
+        ready: {
+            on: {
+                MARK_FIRST_HOVER_EXPAND_SHOWN: {
+                    guard: ({ context }) => !context.firstHoverExpandShown,
+                    actions: assign({ firstHoverExpandShown: true }),
+                },
+            },
+        },
+    },
+});
+export function isEmbedTriggerHydrated(state) {
+    return state.matches('ready');
+}
+//# sourceMappingURL=embed-trigger.js.map

package/src/lib/machines/embed-trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-trigger.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/webchat-core/src/lib/machines/embed-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAUtC,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;IACvC,KAAK,EAAE;QACL,OAAO,EAAE,EAAyB;QAClC,KAAK,EAAE,EAAuB;QAC9B,MAAM,EAAE,EAAuB;KAChC;CACF,CAAC,CAAC,aAAa,CAAC;IACf,EAAE,EAAE,cAAc;IAClB,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE;QACP,qBAAqB,EAAE,KAAK;KAC7B;IACD,MAAM,EAAE;QACN,KAAK,EAAE;YACL,EAAE,EAAE;gBACF,6BAA6B,EAAE;oBAC7B,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB;oBACtD,OAAO,EAAE,MAAM,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC;iBACjD;aACF;SACF;KACF;CACF,CAAC,CAAA;AAEF,MAAM,UAAU,sBAAsB,CAAC,KAEtC;IACC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC"}