@botonic/webchat-core 2.23.0

package/CHANGELOG.md

@@ -0,0 +1,247 @@
+## 2.23.0 (2026-03-23)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.22.1 (2026-03-19)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.22.0 (2026-03-16)
+
+### 🚀 Features
+
+- webchat to retrieve pusher config from backend ([#742](https://github.com/metis-ai/hubtype-product/pull/742))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.21.0 (2026-03-16)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.20.0 (2026-03-13)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.19.0 (2026-03-12)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.18.0 (2026-03-04)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.17.0 (2026-03-02)
+
+### 🚀 Features
+
+- botonic working with v2 input format ([#660](https://github.com/metis-ai/hubtype-product/pull/660))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.16.0 (2026-02-23)
+
+### 🚀 Features
+
+- **webchat:** lazy loading trigger with optimized bundle splitting ([#614](https://github.com/metis-ai/hubtype-product/pull/614))
+
+### 🩹 Fixes
+
+- update webhook urls after backend changes ([#674](https://github.com/metis-ai/hubtype-product/pull/674))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+- Marc Rabat @vanbasten17
+
+## 2.15.0 (2026-02-13)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.14.0 (2026-02-05)
+
+### 🩹 Fixes
+
+- **botonic:** align tsconfig outDir with Nx outputPath to fix TS6305 errors ([#594](https://github.com/metis-ai/hubtype-product/pull/594))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.13.4 (2026-02-02)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.13.3 (2026-01-30)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.13.2 (2026-01-30)
+
+### 🩹 Fixes
+
+- broken styles after publishing packages and use of them along with generator ([#571](https://github.com/metis-ai/hubtype-product/pull/571))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.13.1 (2026-01-30)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.13.0 (2026-01-29)
+
+### 🚀 Features
+
+- add generic overlay system for webviews and cover components ([#547](https://github.com/metis-ai/hubtype-product/pull/547))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.12.0 (2026-01-28)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.11.5 (2026-01-28)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.11.4 (2026-01-28)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.11.3 (2026-01-28)
+
+### 🩹 Fixes
+
+- update entrypoints to use .js and .d.ts extensions for module and types ([#552](https://github.com/metis-ai/hubtype-product/pull/552))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.11.2 (2026-01-21)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.11.1 (2026-01-21)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.11.0 (2026-01-21)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.10.1 (2026-01-19)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.10.0 (2026-01-18)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.9.1 (2026-01-17)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.9.0 (2026-01-17)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.8.1 (2026-01-16)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.8.0 (2026-01-16)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.7.1 (2026-01-16)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.7.0 (2026-01-15)
+
+### 🚀 Features
+
+- webchat data persistence to support local, session and inMemory storages ([#506](https://github.com/metis-ai/hubtype-product/pull/506))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.6.0 (2025-12-09)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.5.0 (2025-12-09)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.4.1 (2025-12-08)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.4.0 (2025-12-05)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.3.3 (2025-12-04)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.3.2 (2025-12-04)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.3.1 (2025-12-04)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.3.0 (2025-12-04)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.2.1 (2025-12-04)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.
+
+## 2.2.0 (2025-12-04)
+
+### 🚀 Features
+
+- receiving unsent messages through pusher auth ([#453](https://github.com/metis-ai/hubtype-product/pull/453))
+- add Botonic Pusher configuration to environment files and enhance webchat rendering options ([#444](https://github.com/metis-ai/hubtype-product/pull/444))
+- implement locale detection and user data handling in webchat, refactor user-related methods for consistency #BLT-2045 ([#435](https://github.com/metis-ai/hubtype-product/pull/435))
+- fine tuning botonic release #BLT-2010 ([#428](https://github.com/metis-ai/hubtype-product/pull/428))
+
+### 🩹 Fixes
+
+- update user actions in WebchatMachine to include saveUser ([#451](https://github.com/metis-ai/hubtype-product/pull/451))
+- pass botonic headers to webchat auth to avoid deduplicated chats ([#447](https://github.com/metis-ai/hubtype-product/pull/447))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+- Marc Rabat @vanbasten17
+
+## 2.1.0 (2025-12-02)
+
+### 🚀 Features
+
+- add Botonic Pusher configuration to environment files and enhance webchat rendering options ([#444](https://github.com/metis-ai/hubtype-product/pull/444))
+- implement locale detection and user data handling in webchat, refactor user-related methods for consistency #BLT-2045 ([#435](https://github.com/metis-ai/hubtype-product/pull/435))
+- fine tuning botonic release #BLT-2010 ([#428](https://github.com/metis-ai/hubtype-product/pull/428))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.0.1-alpha.0 (2025-11-27)
+
+This was a version bump only for @botonic/webchat-core to align it with other projects, there were no code changes.

package/PR-LOCALE-SUPPORT.md

@@ -0,0 +1,156 @@
+# feat: Add HubtypeUserLocale support with autodetection
+
+## Summary
+
+Implements locale, country, and system_locale properties on the webchat user with automatic browser detection when not explicitly provided.
+
+## Changes
+
+### Type Definitions
+
+**`HubtypeUserLocale`** (`@botonic/shared`)
+
+```typescript
+// Before
+export type HubtypeUserLocale = {
+  locale?: string
+  country?: string
+  system_locale?: string
+  extra_data?: Record<string, any>
+}
+
+// After
+export type HubtypeUserLocale = {
+  locale?: string
+  country?: string
+  system_locale?: string
+}
+```
+
+**`HubtypeUser`** (`@botonic/shared`)
+
+```typescript
+// Before
+export type HubtypeUser = {
+  id: string
+  username?: string
+  name?: string
+} & HubtypeUserLocale
+
+// After
+export type HubtypeUser = {
+  id: string
+  username?: string
+  name?: string
+  extra_data?: Record<string, any> // Moved here from HubtypeUserLocale
+} & HubtypeUserLocale
+```
+
+**`WebchatConfig`** (`@botonic/webchat-core`)
+
+```typescript
+// Before
+export type WebchatConfig = WebchatConnectionConfig & HubtypeUserLocale
+
+// After
+export type WebchatConfig = WebchatConnectionConfig & HubtypeUserLocale & Pick<HubtypeUser, 'extra_data'>
+```
+
+**`WebchatControllerContext`** (`@botonic/webchat-core`)
+
+```typescript
+// Before
+export interface WebchatControllerContext {
+  config: WebchatConnectionConfig
+  // ...
+}
+
+// After
+export interface WebchatControllerContext {
+  config: WebchatConfig // Now includes locale props
+  // ...
+}
+```
+
+**WebchatMachine input type**
+
+```typescript
+// Added explicit input type to machine
+types: {} as {
+  context: WebchatControllerContext
+  events: WebchatControllerEvents
+  input: WebchatConfig  // NEW: Typed machine input
+  emitted: // ...
+}
+```
+
+### Locale Autodetection
+
+- Created `libs/botonic/webchat-core/src/lib/utils/locale-detection.ts`
+  - `detectUserLocale()` function that autodetects locale props from browser
+- Created `libs/botonic/webchat-core/src/lib/utils/timezone-to-country.ts`
+  - Timezone to ISO country code mapping for country detection
+
+| Property        | Detection Method                                                     |
+| --------------- | -------------------------------------------------------------------- |
+| `locale`        | `navigator.language`                                                 |
+| `country`       | `Intl.DateTimeFormat().resolvedOptions().timeZone` → country mapping |
+| `system_locale` | Falls back to detected/provided `locale`                             |
+
+### Webchat Machine
+
+- Updated `generateAnonymousUser()` to use `detectUserLocale()` utility
+- Locale props are autodetected if not provided in config
+- `extra_data` can be passed via config
+
+### Controller API
+
+Added setter methods for runtime locale updates:
+
+| Method                          | Description            |
+| ------------------------------- | ---------------------- |
+| `setUserLocale(locale)`         | Set user locale        |
+| `setUserCountry(country)`       | Set user country       |
+| `setSystemLocale(systemLocale)` | Set user system locale |
+| `setUserExtraData(extraData)`   | Set user extra data    |
+
+Available on both `WebchatController` and `PublicWebchatController` (window.botonic).
+
+### Documentation
+
+- Updated `ARCHITECTURE.md` with new utilities and locale autodetection section
+
+## Usage
+
+```typescript
+// Config with explicit locale (optional - will autodetect if not provided)
+const config: WebchatConfig = {
+  appId: 'my-app',
+  locale: 'es',
+  country: 'ES',
+  system_locale: 'es-ES',
+  extra_data: { customField: 'value' },
+}
+
+// Runtime updates via controller
+controller.setUserLocale('en')
+controller.setUserCountry('US')
+
+// Or via window.botonic
+botonic.setUserLocale('en')
+botonic.setUserCountry('US')
+```
+
+## Files Changed
+
+- `libs/botonic/shared/src/lib/services/webchat-api.ts`
+- `libs/botonic/webchat-core/src/lib/domain/index.ts`
+- `libs/botonic/webchat-core/src/lib/machines/webchat.ts`
+- `libs/botonic/webchat-core/src/lib/controllers/webchat.ts`
+- `libs/botonic/webchat-core/src/lib/controllers/public.ts`
+- `libs/botonic/webchat-react/ARCHITECTURE.md`
+
+## Files Created
+
+- `libs/botonic/webchat-core/src/lib/utils/locale-detection.ts`
+- `libs/botonic/webchat-core/src/lib/utils/timezone-to-country.ts`

package/README.md

@@ -0,0 +1,11 @@
+# webchat-core
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build webchat-core` to build the library.
+
+## Running unit tests
+
+Run `nx test webchat-core` to execute the unit tests via [Vitest](https://vitest.dev/).

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@botonic/webchat-core",
+  "version": "2.23.0",
+  "type": "module",
+  "types": "./src/index.d.ts",
+  "module": "./src/index.js",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
+    }
+  },
+  "dependencies": {
+    "@botonic/shared": "2.23.0",
+    "pusher-js": "^8.4.0",
+    "tslib": "^2.3.0",
+    "uuid": "^11.1.0",
+    "xstate": "^5.19.3"
+  },
+  "references": [
+    {
+      "path": "../shared/tsconfig.lib.json"
+    }
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./src/index.js"
+}

package/src/index.d.ts

@@ -0,0 +1,11 @@
+export * from './lib/domain';
+export * from './lib/machines/message';
+export * from './lib/machines/overlay';
+export * from './lib/machines/webchat';
+export * from './lib/controllers';
+export type { WebchatEmittedEvent } from './lib/controllers/webchat';
+export * from './lib/infra/clients';
+export * from './lib/services/webchat-service';
+export type { ConversationData, StorageConfig, StorageRepository, StorageType, StoredMessage, WebchatHubtypeUser, } from './lib/infra/repositories';
+export { createStorageRepository, InMemoryRepository, LocalStorageRepository, SessionStorageRepository, } from './lib/infra/repositories';
+export * from './lib/webview';

package/src/index.js

@@ -0,0 +1,15 @@
+// Domain types
+export * from './lib/domain';
+// XState machines (internal)
+export * from './lib/machines/message';
+export * from './lib/machines/overlay';
+export * from './lib/machines/webchat';
+// Webchat Internal and Public controllers
+export * from './lib/controllers';
+// Infrastructure clients
+export * from './lib/infra/clients';
+export * from './lib/services/webchat-service';
+export { createStorageRepository, InMemoryRepository, LocalStorageRepository, SessionStorageRepository, } from './lib/infra/repositories';
+// Webview utilities, constants, and types
+export * from './lib/webview';
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/botonic/webchat-core/src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,cAAc,cAAc,CAAA;AAE5B,6BAA6B;AAC7B,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AAEtC,0CAA0C;AAC1C,cAAc,mBAAmB,CAAA;AAKjC,yBAAyB;AACzB,cAAc,qBAAqB,CAAA;AACnC,cAAc,gCAAgC,CAAA;AAW9C,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,0BAA0B,CAAA;AAEjC,0CAA0C;AAC1C,cAAc,eAAe,CAAA"}

package/src/lib/controllers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './public';
+export * from './webchat';

package/src/lib/controllers/index.js

@@ -0,0 +1,3 @@
+export * from './public';
+export * from './webchat';
+//# sourceMappingURL=index.js.map

package/src/lib/controllers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/webchat-core/src/lib/controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA"}