@blinq_ai/widget 0.1.0

package/README.md

@@ -0,0 +1,59 @@
+# @blinq_ai/widget
+
+Browser widget, npm SDK, and CLI for Blinq AI.
+
+## Install
+
+```bash
+npm install @blinq_ai/widget
+```
+
+`npm install` by itself is not enough. You still need to mount the widget once in your app.
+
+## Custom element
+
+```html
+<blinq-widget
+  public-token="bq_pk_..."
+  api-base-url="https://api.blinq.kz"
+  mcp-endpoint="https://mcp.blinq.kz"
+></blinq-widget>
+<script type="module">
+  import "@blinq_ai/widget/browser"
+</script>
+```
+
+## SDK
+
+```ts
+import { init } from "@blinq_ai/widget"
+
+await init({
+  publicToken: "bq_pk_...",
+  apiBaseUrl: "https://api.blinq.kz",
+  mcpEndpoint: "https://mcp.blinq.kz",
+})
+```
+
+## Config bootstrap
+
+```ts
+import config from "./blinq-widget.config.json"
+import { initFromConfig } from "@blinq_ai/widget"
+
+await initFromConfig(config)
+```
+
+## CLI
+
+```bash
+npx @blinq_ai/widget login
+npx @blinq_ai/widget init
+```
+
+## Updates
+
+- Publish a new version to npm when the package changes.
+- Clients that pin an exact version need to bump that version in their app.
+- Clients using a semver range pick up updates on the next install/deploy.
+- After the widget is mounted once, normal product copy, prompts, and dashboard config changes do not require code changes in the client app.