copilot-chat-widget 0.1.11 → 0.1.13

package/README.md

@@ -1,25 +1,25 @@
-# Copilot Chat Widget (NPM)
+# Copilot Chat Widget
 
-Widget chat Copilot có thể nhúng theo hai cách:
-1. Qua NPM (khuyến nghị cho SPA/Next.js/React/Vue).
-2. Qua thẻ `<script>` (tương thích ngược, không cần build).
+Embeddable chat widget ready for CDN drop-in or npm import.
 
-## Cài đặt
+## Install
 ```bash
 npm install copilot-chat-widget
-# hoặc
+# or
 yarn add copilot-chat-widget
 ```
 
-## Sử dụng với NPM (import)
+## Quick start (npm / bundler)
 ```js
 import { loadCopilotChatWidget } from "copilot-chat-widget";
 
-loadCopilotChatWidget({ token: "YOUR_WIDGET_TOKEN" });
+loadCopilotChatWidget({
+  token: "YOUR_WIDGET_TOKEN",
+  // optional when backend is another origin:
+  // baseUrl: "https://your-backend-domain"
+});
 ```
-
-Hàm này sẽ gắn script `chat-widget.min.js` (IIFE) vào trang, đọc `token` từ options (hoặc `window.CopilotChatConfig` nếu bạn set trước).
-- Nếu backend widget không cùng origin với web hiện tại, truyền thêm `baseUrl: "https://your-backend-domain"` để gọi đúng API. Nếu không truyền, widget sẽ dùng giá trị build-time `WIDGET_BASE_URL` (đọc từ `.env` khi build), sau đó mới fallback sang origin của script/trang.
+`loadCopilotChatWidget` injects the standalone bundle (`chat-widget.min.js`) and boots the widget with the given token.
 
 ### React/Next.js
 ```jsx
@@ -30,7 +30,7 @@ export default function Page() {
   useEffect(() => {
     loadCopilotChatWidget({
       token: process.env.NEXT_PUBLIC_CHAT_WIDGET_TOKEN,
-      baseUrl: process.env.NEXT_PUBLIC_WIDGET_BASE_URL // nếu backend khác origin; nếu không, sẽ dùng giá trị build-time hoặc origin hiện tại
+      baseUrl: process.env.NEXT_PUBLIC_WIDGET_BASE_URL // optional override
     });
   }, []);
 
@@ -38,38 +38,35 @@ export default function Page() {
 }
 ```
 
-## Sử dụng qua thẻ `<script>` (giữ hành vi cũ)
+## Quick start (script tag)
 ```html
 <script
-  src="https://cdn.example.com/chat-widget.min.js"
+  src="https://unpkg.com/copilot-chat-widget/dist/chat-widget.min.js"
   data-token="YOUR_WIDGET_TOKEN"
-  data-base-url="https://your-backend-domain" <!-- tùy chọn nếu khác origin -->
+  data-base-url="https://your-backend-domain" <!-- optional if backend is another origin -->
 ></script>
 ```
-- `data-token`: bắt buộc.
-- `data-autoload="false"`: nếu muốn chèn script nhưng tự gọi `window.CopilotChat.init()` sau.
-- `data-base-url`: override host backend nếu khác origin hoặc bạn không build sẵn `WIDGET_BASE_URL`.
+- `data-token`: required.
+- `data-base-url`: optional override; if omitted, the widget uses the build-time `WIDGET_BASE_URL`, then falls back to the script/page origin.
+- `data-autoload="false"`: insert script but call `window.CopilotChat.init()` yourself.
 
-## API cấu hình
-- `token` (string, bắt buộc): mã token widget.
-- `autoload` (boolean): đặt `false` nếu muốn tự gọi `window.CopilotChat.load()`.
-- `baseUrl` (string): host/backend cung cấp API `/api/chat-widget/config`. Cần khi web embed khác origin; nếu không truyền sẽ dùng `WIDGET_BASE_URL` build-time rồi fallback origin.
+## Configuration
+- `token` (string, required): widget token.
+- `baseUrl` (string): backend host serving `/api/chat-widget/config`. Needed when the embedding page is on a different origin. Fallback order: `baseUrl` option/data attribute → `WIDGET_BASE_URL` (build-time) → script/page origin.
+- `autoload` (boolean): set `false` to defer bootstrap and call `window.CopilotChat.load()` manually.
 
-Khi script đã load, có thể gọi:
+Runtime controls:
 ```js
-window.CopilotChat.open();   // mở widget
-window.CopilotChat.close();  // đóng widget
-window.CopilotChat.load();   // khởi tạo lại nếu autoload=false
+window.CopilotChat.open();   // open widget
+window.CopilotChat.close();  // close widget
+window.CopilotChat.load();   // initialize if autoload=false
 ```
 
-## Build và publish package
+## Build & publish (for maintainers)
 ```bash
 cd webui/widget
 npm install
-WIDGET_BASE_URL=https://your-backend-domain npm run build  # gắn default baseUrl vào bundle
-```
-Sau khi kiểm tra output trong `webui/widget/dist`, có thể publish lên NPM:
-```bash
+WIDGET_BASE_URL=https://your-backend-domain npm run build  # embed default baseUrl into bundle
 npm publish --access public
 ```
-Nếu muốn đổi tên package cho phù hợp scope công ty, sửa trường `name` trong `webui/widget/package.json` trước khi publish.
+To use a different package name, update `name` in `webui/widget/package.json` before publishing.

package/dist/chat-widget.min.js

@@ -1,4 +1,4 @@
-(function(){"use strict";(()=>{if(typeof window>"u"||typeof document>"u"||window.__copilotWidgetLoaded)return;window.__copilotWidgetLoaded=!0;const v="http://localhost:3009",m=64,f=720,C=document.currentScript,y=t=>{if(!t?.src)return{};try{const i=new URL(t.src,window.location.href),o={};return i.searchParams.forEach((a,s)=>{o[s]=a}),o}catch(i){return console.warn("[CopilotChat] Failed to parse script query params:",i),{}}},S=t=>{document.readyState==="complete"||document.readyState==="interactive"?setTimeout(t,0):document.addEventListener("DOMContentLoaded",t)},x=()=>C||Array.from(document.querySelectorAll("script")).reverse().find(o=>o.dataset?.token||o.src&&o.src.includes("chat-widget"))||null,U=({iframeUrl:t,launcherIcon:i})=>{const o=document.querySelector("[data-copilot-widget-root]");o&&o.remove();const a=document.createElement("div");a.setAttribute("data-copilot-widget-root","true");const s=a.attachShadow({mode:"open"});document.body.appendChild(a);const e=document.createElement("button");e.type="button",e.setAttribute("aria-label","Open Copilot chat"),e.innerHTML=`
+(function(){"use strict";(()=>{if(typeof window>"u"||typeof document>"u"||window.__copilotWidgetLoaded)return;window.__copilotWidgetLoaded=!0;const v="http://localhost:3000",m=64,f=720,C=document.currentScript,y=t=>{if(!t?.src)return{};try{const i=new URL(t.src,window.location.href),o={};return i.searchParams.forEach((a,s)=>{o[s]=a}),o}catch(i){return console.warn("[CopilotChat] Failed to parse script query params:",i),{}}},S=t=>{document.readyState==="complete"||document.readyState==="interactive"?setTimeout(t,0):document.addEventListener("DOMContentLoaded",t)},x=()=>C||Array.from(document.querySelectorAll("script")).reverse().find(o=>o.dataset?.token||o.src&&o.src.includes("chat-widget"))||null,U=({iframeUrl:t,launcherIcon:i})=>{const o=document.querySelector("[data-copilot-widget-root]");o&&o.remove();const a=document.createElement("div");a.setAttribute("data-copilot-widget-root","true");const s=a.attachShadow({mode:"open"});document.body.appendChild(a);const e=document.createElement("button");e.type="button",e.setAttribute("aria-label","Open Copilot chat"),e.innerHTML=`
       <img
         src="${i}"
         alt="Copilot chat launcher"

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});var n=typeof document<"u"?document.currentScript:null;const r="http://localhost:3009";function l(d={}){if(typeof window>"u"||typeof document>"u")return null;const{token:a,autoload:i,baseUrl:t=r}=d;window.CopilotChatConfig={...window.CopilotChatConfig,...d,baseUrl:t||window.CopilotChatConfig?.baseUrl||void 0};const o=document.getElementById("copilot-chat-widget-loader");if(o)return a&&(o.dataset.token=a),t&&(o.dataset.baseUrl=t),i===!1&&(o.dataset.autoload="false"),o;const e=document.createElement("script");return e.id="copilot-chat-widget-loader",e.src=new URL("./chat-widget.min.js",typeof document>"u"?require("url").pathToFileURL(__filename).href:n&&n.tagName.toUpperCase()==="SCRIPT"&&n.src||new URL("index.cjs",document.baseURI).href).href,e.async=!0,a&&(e.dataset.token=a),t&&(e.dataset.baseUrl=t),i===!1&&(e.dataset.autoload="false"),document.body.appendChild(e),e}exports.default=l;exports.loadCopilotChatWidget=l;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});var n=typeof document<"u"?document.currentScript:null;const r="http://localhost:3000";function l(d={}){if(typeof window>"u"||typeof document>"u")return null;const{token:a,autoload:i,baseUrl:t=r}=d;window.CopilotChatConfig={...window.CopilotChatConfig,...d,baseUrl:t||window.CopilotChatConfig?.baseUrl||void 0};const o=document.getElementById("copilot-chat-widget-loader");if(o)return a&&(o.dataset.token=a),t&&(o.dataset.baseUrl=t),i===!1&&(o.dataset.autoload="false"),o;const e=document.createElement("script");return e.id="copilot-chat-widget-loader",e.src=new URL("./chat-widget.min.js",typeof document>"u"?require("url").pathToFileURL(__filename).href:n&&n.tagName.toUpperCase()==="SCRIPT"&&n.src||new URL("index.cjs",document.baseURI).href).href,e.async=!0,a&&(e.dataset.token=a),t&&(e.dataset.baseUrl=t),i===!1&&(e.dataset.autoload="false"),document.body.appendChild(e),e}exports.default=l;exports.loadCopilotChatWidget=l;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-const n = "http://localhost:3009";
+const n = "http://localhost:3000";
 function l(i = {}) {
   if (typeof window > "u" || typeof document > "u")
     return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "copilot-chat-widget",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Embeddable Copilot chat widget that can be loaded via NPM or a script tag.",
   "type": "module",
   "main": "./dist/index.cjs",