@akropolys/kiku 1.7.16 → 1.7.20

package/package.json

@@ -1,68 +1,67 @@
-{
-  "name": "@akropolys/kiku",
-  "version": "1.7.16",
-  "description": "The chat and search widgets for Akropolys — the interface your users and their AI agents actually talk to.",
-  "license": "MIT",
-  "keywords": [
-    "akropolys",
-    "kiku",
-    "ai",
-    "chat",
-    "search",
-    "react",
-    "ui",
-    "components",
-    "ecommerce",
-    "shopping-assistant",
-    "conversational-ui"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/akropolys/sdk.git"
-  },
-  "homepage": "https://akropolys.io",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "style": "dist/styles.css",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
-    },
-    "./styles.css": "./dist/styles.css"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch"
-  },
-  "peerDependencies": {
-    "react": ">=17",
-    "react-dom": ">=17",
-    "@akropolys/sdk": "^1.8.6"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": false
-    },
-    "react-dom": {
-      "optional": false
-    }
-  },
-  "devDependencies": {
-    "@akropolys/sdk": "workspace:*",
-    "@types/react": "^18.0.0",
-    "@types/react-dom": "^18.0.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.0.0"
-  },
-  "dependencies": {
-    "clsx": "^2.1.1",
-    "tailwind-merge": "^3.6.0"
-  }
-}
+{
+  "name": "@akropolys/kiku",
+  "version": "1.7.20",
+  "description": "The real-time conversational layer for the living web.",
+  "license": "MIT",
+  "keywords": [
+    "conversational-ai",
+    "realtime",
+    "voice-ai",
+    "chat",
+    "search",
+    "rag",
+    "react",
+    "nextjs",
+    "akropolys",
+    "kiku"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/akropolys/sdk.git"
+  },
+  "homepage": "https://akropolys.io",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "style": "dist/styles.css",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./shopify": "./dist/shopify.js",
+    "./kiku.iife.js": "./dist/kiku.iife.js"
+  },
+  "files": [
+    "dist",
+    "shopify",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node scripts/gen-css.mjs && tsup && node scripts/postbuild.mjs",
+    "dev": "node scripts/gen-css.mjs && tsup --watch"
+  },
+  "peerDependencies": {
+    "react": ">=17",
+    "react-dom": ">=17",
+    "@akropolys/sdk": "^1.8.10"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": false
+    },
+    "react-dom": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@akropolys/sdk": "workspace:*",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "clsx": "^2.1.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/shopify/README.md

@@ -0,0 +1,71 @@
+# Kiku AI Assistant for Shopify
+
+Kiku is an intelligent shopping assistant that runs directly on Shopify storefronts with:
+- **Zero theme CSS conflict** via Web Component Shadow DOM isolation
+- **Automated Catalog Ingestion** on product views (`{{ product | json }}`)
+- **Native Shopify Cart Integration** via AJAX `/cart/add.js` and `/cart.js`
+- **Voice & Visual Search** built-in with multilingual support
+
+---
+
+## Quick Setup Options
+
+### Option 1: Direct Liquid Theme Embed (Fastest)
+
+Add the snippet to your theme's `layout/theme.liquid` just before `</body>`:
+
+```liquid
+{% render 'kiku-embed', site_id: 'YOUR_SITE_ID', api_token: 'YOUR_API_TOKEN' %}
+```
+
+Or paste directly:
+```html
+<script>
+  window.AkropolysConfig = {
+    siteId: "YOUR_SITE_ID",
+    apiToken: "YOUR_API_TOKEN",
+    {% if product %}
+    product: {{ product | json }},
+    {% endif %}
+  };
+</script>
+<script src="https://cdn.akropolys.cloud/kiku.iife.js" defer></script>
+```
+
+---
+
+### Option 2: Shopify Theme App Extension (Online Store 2.0)
+
+If you are packaging Kiku as a Shopify App:
+1. Copy `blocks/kiku-button.liquid` into your extension's `blocks/` directory.
+2. Copy `dist/kiku.iife.global.js` (or `dist/shopify.global.js`) as `assets/kiku.iife.js`.
+3. Merchants can add the "Kiku AI Assistant" App Block directly from the Shopify Theme Customizer!
+
+---
+
+## JavaScript API (`window.Kiku`)
+
+Once loaded, Kiku exposes `window.Kiku`:
+
+```javascript
+// Open the chat modal
+window.Kiku.open();
+
+// Close the chat modal
+window.Kiku.close();
+
+// Toggle chat modal
+window.Kiku.toggle();
+
+// Ingest a custom product dynamically
+window.Kiku.ingest({
+  id: "12345",
+  title: "Custom Hoodie",
+  price: "49.99",
+  image: "https://example.com/image.jpg",
+  url: "/products/custom-hoodie"
+});
+
+// Access underlying AkropolysClient instance
+const client = window.Kiku.getClient();
+```

package/shopify/blocks/kiku-button.liquid

@@ -0,0 +1,121 @@
+{% comment %}
+  Kiku AI Assistant App Block for Shopify Online Store 2.0
+  File: blocks/kiku-button.liquid
+{% endcomment %}
+
+<script>
+  window.AkropolysConfig = {
+    siteId: {{ block.settings.site_id | json }},
+    apiToken: {{ block.settings.api_token | json }},
+    {% if block.settings.api_url != blank %}apiUrl: {{ block.settings.api_url | json }},{% endif %}
+    buttonLabel: {{ block.settings.button_label | json }},
+    position: {{ block.settings.position | json }},
+    theme: {{ block.settings.theme | json }},
+    enableVoice: {{ block.settings.enable_voice | json }},
+    enableVision: {{ block.settings.enable_vision | json }},
+    enableAudioResponse: {{ block.settings.enable_audio | json }},
+    {% if product %}
+    product: {
+      id: {{ product.id | json }},
+      title: {{ product.title | json }},
+      handle: {{ product.handle | json }},
+      url: {{ product.url | json }},
+      price: {{ product.price | json }},
+      compare_at_price: {{ product.compare_at_price | json }},
+      featured_image: {{ product.featured_image | image_url: width: 800 | json }},
+      type: {{ product.type | json }},
+      vendor: {{ product.vendor | json }},
+      tags: {{ product.tags | json }},
+      description: {{ product.description | strip_html | json }},
+      available: {{ product.available | json }},
+      variants: [
+        {% for variant in product.variants %}
+          {
+            id: {{ variant.id | json }},
+            title: {{ variant.title | json }},
+            price: {{ variant.price | json }},
+            sku: {{ variant.sku | json }},
+            available: {{ variant.available | json }}
+          }{% unless forloop.last %},{% endunless %}
+        {% endfor %}
+      ]
+    }
+    {% endif %}
+  };
+</script>
+
+<script src="{{ 'kiku.iife.js' | asset_url }}" defer></script>
+
+{% schema %}
+{
+  "name": "Kiku AI Assistant",
+  "target": "body",
+  "settings": [
+    {
+      "type": "text",
+      "id": "site_id",
+      "label": "Akropolys Site ID",
+      "info": "Your Site ID from shell.akropolys.cloud"
+    },
+    {
+      "type": "text",
+      "id": "api_token",
+      "label": "Akropolys API Token",
+      "info": "Public client token with shopper access"
+    },
+    {
+      "type": "text",
+      "id": "api_url",
+      "label": "API URL Override",
+      "default": "https://api.akropolys.cloud/v1"
+    },
+    {
+      "type": "text",
+      "id": "button_label",
+      "label": "Button Label",
+      "default": "Ask Kiku"
+    },
+    {
+      "type": "select",
+      "id": "position",
+      "label": "Widget Position",
+      "options": [
+        { "value": "bottom-right", "label": "Bottom Right" },
+        { "value": "bottom-left", "label": "Bottom Left" },
+        { "value": "top-right", "label": "Top Right" },
+        { "value": "top-left", "label": "Top Left" },
+        { "value": "inline", "label": "Inline Container (#kiku-mount)" }
+      ],
+      "default": "bottom-right"
+    },
+    {
+      "type": "select",
+      "id": "theme",
+      "label": "Theme",
+      "options": [
+        { "value": "dark", "label": "Dark" },
+        { "value": "light", "label": "Light" }
+      ],
+      "default": "dark"
+    },
+    {
+      "type": "checkbox",
+      "id": "enable_voice",
+      "label": "Enable Voice Input & Conversation",
+      "default": true
+    },
+    {
+      "type": "checkbox",
+      "id": "enable_vision",
+      "label": "Enable Visual Photo Search",
+      "default": true
+    },
+    {
+      "type": "checkbox",
+      "id": "enable_audio",
+      "label": "Enable Audio Voice Responses",
+      "default": true
+    }
+  ]
+}
+{% endschema %}

package/shopify/snippets/kiku-embed.liquid

@@ -0,0 +1,45 @@
+{% comment %}
+  Direct Liquid snippet for Shopify themes (e.g. theme.liquid before </body>)
+  Usage: {% render 'kiku-embed', site_id: 'your_site_id', api_token: 'your_token' %}
+{% endcomment %}
+
+<script>
+  window.AkropolysConfig = {
+    siteId: {{ site_id | default: settings.akropolys_site_id | json }},
+    apiToken: {{ api_token | default: settings.akropolys_api_token | json }},
+    buttonLabel: {{ button_label | default: "Ask Kiku" | json }},
+    position: {{ position | default: "bottom-right" | json }},
+    theme: {{ theme | default: "dark" | json }},
+    enableVoice: true,
+    enableVision: true,
+    enableAudioResponse: true,
+    {% if product %}
+    product: {
+      id: {{ product.id | json }},
+      title: {{ product.title | json }},
+      handle: {{ product.handle | json }},
+      url: {{ product.url | json }},
+      price: {{ product.price | json }},
+      compare_at_price: {{ product.compare_at_price | json }},
+      featured_image: {{ product.featured_image | image_url: width: 800 | json }},
+      type: {{ product.type | json }},
+      vendor: {{ product.vendor | json }},
+      tags: {{ product.tags | json }},
+      description: {{ product.description | strip_html | json }},
+      available: {{ product.available | json }},
+      variants: [
+        {% for variant in product.variants %}
+          {
+            id: {{ variant.id | json }},
+            title: {{ variant.title | json }},
+            price: {{ variant.price | json }},
+            sku: {{ variant.sku | json }},
+            available: {{ variant.available | json }}
+          }{% unless forloop.last %},{% endunless %}
+        {% endfor %}
+      ]
+    }
+    {% endif %}
+  };
+</script>
+<script src="https://cdn.akropolys.cloud/kiku.iife.js" defer></script>