@rahul_vendure/ai-chat-plugin 0.1.0

package/README.md

@@ -0,0 +1,214 @@
+# @rahul_vendure/ai-chat-plugin
+
+AI-powered shopping assistant plugin for [Vendure](https://www.vendure.io/) e-commerce. Adds an LLM-driven chat endpoint to your Vendure server with product search, vector search, cart management, order tracking, and checkout assistance.
+
+## Features
+
+- **LLM Chat** — GPT-4o-mini powered shopping assistant via Vercel AI SDK
+- **14 Built-in Tools** — search, vector search, collections, price filter, add-to-cart, cart view/adjust, order history/tracking, checkout (addresses, shipping)
+- **Streaming** — Real-time streaming responses via `POST /ai-assistant/stream` (compatible with `useChat()` from `@ai-sdk/react`)
+- **Non-streaming** — JSON response via `POST /ai-assistant/chat`
+- **Vector Search** — pgvector-powered semantic search over products and collections
+- **Auto-Embedding** — Automatic embedding generation on product/variant/collection create/update/delete
+- **Bulk Embedding** — Admin GraphQL mutation `triggerEmbedAll` to embed all existing catalog data
+- **Self-Managing Schema** — Automatically creates pgvector extension and embedding columns
+
+## Requirements
+
+- Vendure `>=3.0.0`
+- PostgreSQL with [pgvector](https://github.com/pgvector/pgvector) extension
+- OpenAI API key
+
+## Installation
+
+```bash
+npm install @rahul_vendure/ai-chat-plugin
+```
+
+## Setup
+
+### 1. Add the plugin to your Vendure config
+
+```ts
+// vendure-config.ts
+import { AiAssistantPlugin } from '@rahul_vendure/ai-chat-plugin';
+
+export const config: VendureConfig = {
+    // CORS — allow your storefront origin so the browser can call /ai-assistant/stream directly
+    apiOptions: {
+        cors: {
+            origin: ['http://localhost:3001', 'https://my-storefront.com'],
+        },
+    },
+    plugins: [
+        // ... other plugins
+        AiAssistantPlugin.init({
+            openaiApiKey: process.env.OPENAI_API_KEY!,
+            embeddingModel: 'text-embedding-3-small', // optional, this is the default
+            assetBaseUrl: 'https://my-vendure.com/assets/', // optional, auto-detected in dev
+        }),
+    ],
+};
+```
+
+### 2. Embed your catalog
+
+After starting the server, run the `triggerEmbedAll` mutation from the Admin API (GraphiQL at `/admin-api`):
+
+```graphql
+mutation {
+    triggerEmbedAll {
+        jobId
+        message
+    }
+}
+```
+
+This generates vector embeddings for all products, variants, and collections in the background. You only need to run this once — after that, embeddings are automatically kept in sync on create/update/delete.
+
+### 3. Add the frontend
+
+Use the companion package [`@rahul_vendure/ai-chat-react`](../ai-chat-react) for a drop-in React chat UI:
+
+```bash
+npm install @rahul_vendure/ai-chat-react ai @ai-sdk/react
+```
+
+```tsx
+<VendureAiChat vendureUrl="https://my-vendure.com" />
+```
+
+See the [`@rahul_vendure/ai-chat-react` README](../ai-chat-react) for full docs.
+
+## Configuration Options
+
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
+| `openaiApiKey` | `string` | Yes | — | Your OpenAI API key |
+| `embeddingModel` | `string` | No | `'text-embedding-3-small'` | OpenAI embedding model to use |
+| `assetBaseUrl` | `string` | No | Auto-detected | Base URL for product images (e.g. `https://my-vendure.com/assets/`) |
+
+## API Endpoints
+
+### `POST /ai-assistant/stream`
+
+Streaming endpoint compatible with the Vercel AI SDK `useChat()` hook. Returns a [UI Message Stream](https://sdk.vercel.ai/docs/ai-sdk-ui/stream-protocol#ui-message-stream-protocol) response.
+
+The `@rahul_vendure/ai-chat-react` package connects to this endpoint automatically — you don't need to call it manually.
+
+**Request:**
+```json
+{
+    "message": "Show me laptops under $1000",
+    "history": [
+        { "role": "user", "content": "Hi" },
+        { "role": "assistant", "content": "Hello! How can I help?" }
+    ]
+}
+```
+
+**Auth:** Pass a Bearer token in the `Authorization` header for logged-in user features (cart, orders).
+
+### `POST /ai-assistant/chat`
+
+Non-streaming endpoint. Returns the full response as JSON after all tool calls complete.
+
+**Response:**
+```json
+{
+    "message": "Here are some laptops I found!",
+    "products": [
+        { "id": "1", "name": "Gaming Laptop", "slug": "gaming-laptop", "price": 89900, "image": "https://...", "variantId": "42" }
+    ],
+    "collections": [],
+    "addToCartAction": null,
+    "activeOrder": null
+}
+```
+
+## CORS
+
+The React frontend connects **directly** to the Vendure server from the browser (no proxy needed). You must configure CORS to allow your storefront origin:
+
+```ts
+export const config: VendureConfig = {
+    apiOptions: {
+        cors: {
+            origin: ['https://my-storefront.com'],
+        },
+    },
+};
+```
+
+> In development, Vendure allows all origins by default, so no CORS config is needed for `localhost`.
+
+## Tools
+
+The AI assistant has 14 built-in tools:
+
+| Tool | Description |
+|------|-------------|
+| `searchProducts` | Keyword search using Vendure's fulltext search index |
+| `vectorSearch` | Semantic/intent-based search using pgvector embeddings |
+| `getCollections` | List product collections/categories |
+| `filterByPrice` | Filter products by price range |
+| `addToCart` | Add a product variant to the customer's cart |
+| `getActiveOrder` | Get the current cart with all line items |
+| `adjustOrderLine` | Change quantity or remove items from cart |
+| `getOrderHistory` | List past orders for the customer |
+| `trackOrder` | Get order status and tracking information |
+| `getAvailableCountries` | List countries for shipping/billing |
+| `getEligibleShippingMethods` | Get shipping options for active order |
+| `setShippingAddress` | Set shipping address on active order |
+| `setBillingAddress` | Set billing address on active order |
+| `setShippingMethod` | Set shipping method on active order |
+
+## Entities
+
+The plugin adds three entities to your database:
+
+- `product_embedding` — Vector embeddings for products
+- `variant_embedding` — Vector embeddings for product variants
+- `collection_embedding` — Vector embeddings for collections
+
+These are automatically managed. The plugin creates the pgvector extension and embedding columns on startup.
+
+## Admin Dashboard AI Chat
+
+The plugin also includes a built-in admin chat endpoint at `POST /admin-ai-chat/chat` with admin-specific tools:
+
+| Tool | Description |
+|------|-------------|
+| `searchProducts` | Keyword search with admin details (stock levels, enabled status, variant count) |
+| `vectorSearch` | Semantic search for products by intent |
+| `getProductDetails` | Full product details with all variants, SKUs, stock |
+| `searchOrders` | Search orders by code, customer, or state |
+| `searchCustomers` | Search customers by name/email with order stats |
+| `getCollections` | List/search collections with product counts |
+
+To add the admin chat UI to your Vendure dashboard, install the companion package:
+
+```bash
+npm install @rahul_vendure/ai-chat-dashboard
+```
+
+See the [`@rahul_vendure/ai-chat-dashboard` README](https://www.npmjs.com/package/@rahul_vendure/ai-chat-dashboard) for setup instructions.
+
+## Exported Services
+
+For advanced use cases, you can inject these services in your own plugins:
+
+```ts
+import {
+    AiChatService,          // Storefront chat service
+    AdminAiChatService,     // Admin dashboard chat service
+    EmbeddingService,
+    ProductEmbeddingService,
+    VariantEmbeddingService,
+    CollectionEmbeddingService,
+} from '@rahul_vendure/ai-chat-plugin';
+```
+
+## License
+
+MIT

package/dist/ai-assistant.plugin.d.ts

@@ -0,0 +1,18 @@
+import { OnApplicationBootstrap } from '@nestjs/common';
+import { EventBus } from '@vendure/core';
+import { ProductEmbeddingHandler } from './handlers/product-embedding-handler';
+import { VariantEmbeddingHandler } from './handlers/variant-embedding-handler';
+import { CollectionEmbeddingHandler } from './handlers/collection-embedding-handler';
+import { type AiAssistantPluginOptions } from './constants';
+export type { AiAssistantPluginOptions } from './constants';
+export declare class AiAssistantPlugin implements OnApplicationBootstrap {
+    private eventBus;
+    private productHandler;
+    private variantHandler;
+    private collectionHandler;
+    static options: AiAssistantPluginOptions;
+    static init(options: AiAssistantPluginOptions): typeof AiAssistantPlugin;
+    constructor(eventBus: EventBus, productHandler: ProductEmbeddingHandler, variantHandler: VariantEmbeddingHandler, collectionHandler: CollectionEmbeddingHandler);
+    onApplicationBootstrap(): void;
+}
+//# sourceMappingURL=ai-assistant.plugin.d.ts.map

package/dist/ai-assistant.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-assistant.plugin.d.ts","sourceRoot":"","sources":["../src/ai-assistant.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAqC,MAAM,eAAe,CAAC;AAU5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAMrF,OAAO,EAAwB,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAGlF,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAO5D,qBAwBa,iBAAkB,YAAW,sBAAsB;IASxD,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,iBAAiB;IAX7B,MAAM,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAEzC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,iBAAiB;gBAM5D,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,uBAAuB,EACvC,cAAc,EAAE,uBAAuB,EACvC,iBAAiB,EAAE,0BAA0B;IAGzD,sBAAsB;CAKzB"}

package/dist/ai-assistant.plugin.js

@@ -0,0 +1,86 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var AiAssistantPlugin_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiAssistantPlugin = void 0;
+const core_1 = require("@vendure/core");
+const product_embedding_entity_1 = require("./entities/product-embedding.entity");
+const variant_embedding_entity_1 = require("./entities/variant-embedding.entity");
+const collection_embedding_entity_1 = require("./entities/collection-embedding.entity");
+const embedding_service_1 = require("./services/embedding.service");
+const product_embedding_service_1 = require("./services/product-embedding.service");
+const variant_embedding_service_1 = require("./services/variant-embedding.service");
+const collection_embedding_service_1 = require("./services/collection-embedding.service");
+const ai_chat_service_1 = require("./services/ai-chat.service");
+const conversation_cache_service_1 = require("./services/conversation-cache.service");
+const product_embedding_handler_1 = require("./handlers/product-embedding-handler");
+const variant_embedding_handler_1 = require("./handlers/variant-embedding-handler");
+const collection_embedding_handler_1 = require("./handlers/collection-embedding-handler");
+const embed_all_job_service_1 = require("./services/embed-all-job.service");
+const ai_assistant_resolver_1 = require("./api/ai-assistant.resolver");
+const ai_assistant_controller_1 = require("./controllers/ai-assistant.controller");
+const admin_chat_controller_1 = require("./controllers/admin-chat.controller");
+const admin_ai_chat_service_1 = require("./services/admin-ai-chat.service");
+const constants_1 = require("./constants");
+const schema_extensions_1 = require("./api/schema-extensions");
+const defaultOptions = {
+    embeddingModel: 'text-embedding-3-small',
+    enableConversationCache: true,
+};
+let AiAssistantPlugin = AiAssistantPlugin_1 = class AiAssistantPlugin {
+    static init(options) {
+        this.options = { ...defaultOptions, ...options };
+        return AiAssistantPlugin_1;
+    }
+    constructor(eventBus, productHandler, variantHandler, collectionHandler) {
+        this.eventBus = eventBus;
+        this.productHandler = productHandler;
+        this.variantHandler = variantHandler;
+        this.collectionHandler = collectionHandler;
+    }
+    onApplicationBootstrap() {
+        void this.productHandler;
+        void this.variantHandler;
+        void this.collectionHandler;
+    }
+};
+exports.AiAssistantPlugin = AiAssistantPlugin;
+exports.AiAssistantPlugin = AiAssistantPlugin = AiAssistantPlugin_1 = __decorate([
+    (0, core_1.VendurePlugin)({
+        imports: [core_1.PluginCommonModule],
+        entities: [product_embedding_entity_1.ProductEmbedding, variant_embedding_entity_1.VariantEmbedding, collection_embedding_entity_1.CollectionEmbedding],
+        adminApiExtensions: {
+            schema: () => schema_extensions_1.embedAllSchemaExtension,
+            resolvers: [ai_assistant_resolver_1.AiAssistantResolver],
+        },
+        controllers: [ai_assistant_controller_1.AiAssistantController, admin_chat_controller_1.AdminChatController],
+        providers: [
+            { provide: constants_1.AI_ASSISTANT_OPTIONS, useFactory: () => AiAssistantPlugin.options },
+            embedding_service_1.EmbeddingService,
+            product_embedding_service_1.ProductEmbeddingService,
+            variant_embedding_service_1.VariantEmbeddingService,
+            collection_embedding_service_1.CollectionEmbeddingService,
+            ai_chat_service_1.AiChatService,
+            admin_ai_chat_service_1.AdminAiChatService,
+            conversation_cache_service_1.ConversationCacheService,
+            product_embedding_handler_1.ProductEmbeddingHandler,
+            variant_embedding_handler_1.VariantEmbeddingHandler,
+            collection_embedding_handler_1.CollectionEmbeddingHandler,
+            embed_all_job_service_1.EmbedAllJobService,
+        ],
+        compatibility: '^3.0.0',
+    }),
+    __metadata("design:paramtypes", [core_1.EventBus,
+        product_embedding_handler_1.ProductEmbeddingHandler,
+        variant_embedding_handler_1.VariantEmbeddingHandler,
+        collection_embedding_handler_1.CollectionEmbeddingHandler])
+], AiAssistantPlugin);
+//# sourceMappingURL=ai-assistant.plugin.js.map

package/dist/ai-assistant.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-assistant.plugin.js","sourceRoot":"","sources":["../src/ai-assistant.plugin.ts"],"names":[],"mappings":";;;;;;;;;;;;;AACA,wCAA4E;AAC5E,kFAAuE;AACvE,kFAAuE;AACvE,wFAA6E;AAC7E,oEAAgE;AAChE,oFAA+E;AAC/E,oFAA+E;AAC/E,0FAAqF;AACrF,gEAA2D;AAC3D,sFAAiF;AACjF,oFAA+E;AAC/E,oFAA+E;AAC/E,0FAAqF;AACrF,4EAAsE;AACtE,uEAAkE;AAClE,mFAA8E;AAC9E,+EAA0E;AAC1E,4EAAsE;AACtE,2CAAkF;AAClF,+DAAkE;AAIlE,MAAM,cAAc,GAA2F;IAC3G,cAAc,EAAE,wBAAwB;IACxC,uBAAuB,EAAE,IAAI;CAChC,CAAC;AA0BK,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAG1B,MAAM,CAAC,IAAI,CAAC,OAAiC;QACzC,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;QACjD,OAAO,mBAAiB,CAAC;IAC7B,CAAC;IAED,YACY,QAAkB,EAClB,cAAuC,EACvC,cAAuC,EACvC,iBAA6C;QAH7C,aAAQ,GAAR,QAAQ,CAAU;QAClB,mBAAc,GAAd,cAAc,CAAyB;QACvC,mBAAc,GAAd,cAAc,CAAyB;QACvC,sBAAiB,GAAjB,iBAAiB,CAA4B;IACtD,CAAC;IAEJ,sBAAsB;QAClB,KAAK,IAAI,CAAC,cAAc,CAAC;QACzB,KAAK,IAAI,CAAC,cAAc,CAAC;QACzB,KAAK,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;CACJ,CAAA;AApBY,8CAAiB;4BAAjB,iBAAiB;IAxB7B,IAAA,oBAAa,EAAC;QACX,OAAO,EAAE,CAAC,yBAAkB,CAAC;QAC7B,QAAQ,EAAE,CAAC,2CAAgB,EAAE,2CAAgB,EAAE,iDAAmB,CAAC;QACnE,kBAAkB,EAAE;YAChB,MAAM,EAAE,GAAG,EAAE,CAAC,2CAAuB;YACrC,SAAS,EAAE,CAAC,2CAAmB,CAAC;SACnC;QACD,WAAW,EAAE,CAAC,+CAAqB,EAAE,2CAAmB,CAAC;QACzD,SAAS,EAAE;YACP,EAAE,OAAO,EAAE,gCAAoB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE;YAC9E,oCAAgB;YAChB,mDAAuB;YACvB,mDAAuB;YACvB,yDAA0B;YAC1B,+BAAa;YACb,0CAAkB;YAClB,qDAAwB;YACxB,mDAAuB;YACvB,mDAAuB;YACvB,yDAA0B;YAC1B,0CAAkB;SACrB;QACD,aAAa,EAAE,QAAQ;KAC1B,CAAC;qCAUwB,eAAQ;QACF,mDAAuB;QACvB,mDAAuB;QACpB,yDAA0B;GAZhD,iBAAiB,CAoB7B"}

package/dist/api/ai-assistant.resolver.d.ts

@@ -0,0 +1,11 @@
+import { RequestContext } from '@vendure/core';
+import { EmbedAllJobService } from '../services/embed-all-job.service';
+export declare class AiAssistantResolver {
+    private embedAllJobService;
+    constructor(embedAllJobService: EmbedAllJobService);
+    triggerEmbedAll(ctx: RequestContext): Promise<{
+        jobId: string;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=ai-assistant.resolver.d.ts.map

package/dist/api/ai-assistant.resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-assistant.resolver.d.ts","sourceRoot":"","sources":["../../src/api/ai-assistant.resolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,qBACa,mBAAmB;IAChB,OAAO,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,kBAAkB;IAGpD,eAAe,CAAQ,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC;QACvD,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;CAQL"}

package/dist/api/ai-assistant.resolver.js

@@ -0,0 +1,43 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiAssistantResolver = void 0;
+const graphql_1 = require("@nestjs/graphql");
+const core_1 = require("@vendure/core");
+const embed_all_job_service_1 = require("../services/embed-all-job.service");
+let AiAssistantResolver = class AiAssistantResolver {
+    constructor(embedAllJobService) {
+        this.embedAllJobService = embedAllJobService;
+    }
+    async triggerEmbedAll(ctx) {
+        const { jobId } = await this.embedAllJobService.enqueue();
+        return {
+            jobId,
+            message: 'Embed-all job enqueued. Products, variants, and collections will be embedded in the background.',
+        };
+    }
+};
+exports.AiAssistantResolver = AiAssistantResolver;
+__decorate([
+    (0, graphql_1.Mutation)(),
+    __param(0, (0, core_1.Ctx)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext]),
+    __metadata("design:returntype", Promise)
+], AiAssistantResolver.prototype, "triggerEmbedAll", null);
+exports.AiAssistantResolver = AiAssistantResolver = __decorate([
+    (0, graphql_1.Resolver)(),
+    __metadata("design:paramtypes", [embed_all_job_service_1.EmbedAllJobService])
+], AiAssistantResolver);
+//# sourceMappingURL=ai-assistant.resolver.js.map

package/dist/api/ai-assistant.resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-assistant.resolver.js","sourceRoot":"","sources":["../../src/api/ai-assistant.resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,6CAAqD;AACrD,wCAAoD;AACpD,6EAAuE;AAGhE,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC5B,YAAoB,kBAAsC;QAAtC,uBAAkB,GAAlB,kBAAkB,CAAoB;IAAG,CAAC;IAGxD,AAAN,KAAK,CAAC,eAAe,CAAQ,GAAmB;QAI5C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;QAC1D,OAAO;YACH,KAAK;YACL,OAAO,EACH,iGAAiG;SACxG,CAAC;IACN,CAAC;CACJ,CAAA;AAfY,kDAAmB;AAItB;IADL,IAAA,kBAAQ,GAAE;IACY,WAAA,IAAA,UAAG,GAAE,CAAA;;qCAAM,qBAAc;;0DAU/C;8BAdQ,mBAAmB;IAD/B,IAAA,kBAAQ,GAAE;qCAEiC,0CAAkB;GADjD,mBAAmB,CAe/B"}

package/dist/api/schema-extensions.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentNode } from 'graphql';
+export declare const embedAllSchemaExtension: DocumentNode;
+//# sourceMappingURL=schema-extensions.d.ts.map

package/dist/api/schema-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-extensions.d.ts","sourceRoot":"","sources":["../../src/api/schema-extensions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,eAAO,MAAM,uBAAuB,EAAE,YASpC,CAAC"}

package/dist/api/schema-extensions.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.embedAllSchemaExtension = void 0;
+const graphql_1 = require("graphql");
+exports.embedAllSchemaExtension = (0, graphql_1.parse)(`
+  type EmbedAllResult {
+    jobId: ID!
+    message: String!
+  }
+  extend type Mutation {
+    """Enqueue a background job to embed all products, variants, and collections."""
+    triggerEmbedAll: EmbedAllResult!
+  }
+`);
+//# sourceMappingURL=schema-extensions.js.map

package/dist/api/schema-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-extensions.js","sourceRoot":"","sources":["../../src/api/schema-extensions.ts"],"names":[],"mappings":";;;AAAA,qCAAgC;AAGnB,QAAA,uBAAuB,GAAiB,IAAA,eAAK,EAAC;;;;;;;;;CAS1D,CAAC,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,41 @@
+export declare const AI_ASSISTANT_OPTIONS: unique symbol;
+export declare const EMBEDDING_DIMENSIONS = 1536;
+export declare const EMBED_ALL_QUEUE_NAME = "embed-all";
+/** Min cosine similarity (1 - distance) to consider a product relevant. Lower = more results (e.g. short queries like "laptops"). */
+export declare const SIMILARITY_THRESHOLD = 0.28;
+/** When first pass returns 0, we fallback to top-N without threshold. Only use fallback if best score >= this (avoids returning irrelevant results e.g. "private jets"). */
+export declare const FALLBACK_MIN_SCORE = 0.25;
+/** Max number of products to return in chat; only those above SIMILARITY_THRESHOLD are included. */
+export declare const MAX_CHAT_PRODUCTS = 5;
+/** Max number of Vendure collections to return in chat (e.g. "electronics", "sports"). */
+export declare const MAX_CHAT_COLLECTIONS = 3;
+/**
+ * Format a price in the smallest currency unit (cents) to a human-readable dollar string.
+ * Used in tool result summaries so the LLM sees formatted prices (e.g. "$42.63")
+ * instead of raw cent values that it might misinterpret.
+ */
+export declare function formatPrice(cents: number): string;
+export interface AiAssistantPluginOptions {
+    openaiApiKey: string;
+    embeddingModel?: string;
+    /**
+     * Base URL for product asset images. Should match your AssetServerPlugin's
+     * public URL including the route, e.g. "https://my-vendure.com/assets/".
+     * If not set, will be auto-detected from apiOptions (works for dev).
+     */
+    assetBaseUrl?: string;
+    /**
+     * Whether to cache conversation history server-side using Vendure's CacheService.
+     *
+     * When enabled, the frontend sends a `conversationId` with each request and the
+     * server stores/retrieves conversation history from cache instead of requiring
+     * the full message array in every request.
+     *
+     * Requires `DefaultCachePlugin` or `RedisCachePlugin` to be configured for
+     * persistence across server restarts. Falls back to in-memory cache otherwise.
+     *
+     * @default true
+     */
+    enableConversationCache?: boolean;
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AACnE,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD,qIAAqI;AACrI,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,4KAA4K;AAC5K,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,MAAM,WAAW,wBAAwB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;OAWG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACrC"}

package/dist/constants.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_CHAT_COLLECTIONS = exports.MAX_CHAT_PRODUCTS = exports.FALLBACK_MIN_SCORE = exports.SIMILARITY_THRESHOLD = exports.EMBED_ALL_QUEUE_NAME = exports.EMBEDDING_DIMENSIONS = exports.AI_ASSISTANT_OPTIONS = void 0;
+exports.formatPrice = formatPrice;
+exports.AI_ASSISTANT_OPTIONS = Symbol('AI_ASSISTANT_OPTIONS');
+exports.EMBEDDING_DIMENSIONS = 1536; // text-embedding-3-small
+exports.EMBED_ALL_QUEUE_NAME = 'embed-all';
+/** Min cosine similarity (1 - distance) to consider a product relevant. Lower = more results (e.g. short queries like "laptops"). */
+exports.SIMILARITY_THRESHOLD = 0.28;
+/** When first pass returns 0, we fallback to top-N without threshold. Only use fallback if best score >= this (avoids returning irrelevant results e.g. "private jets"). */
+exports.FALLBACK_MIN_SCORE = 0.25;
+/** Max number of products to return in chat; only those above SIMILARITY_THRESHOLD are included. */
+exports.MAX_CHAT_PRODUCTS = 5;
+/** Max number of Vendure collections to return in chat (e.g. "electronics", "sports"). */
+exports.MAX_CHAT_COLLECTIONS = 3;
+/**
+ * Format a price in the smallest currency unit (cents) to a human-readable dollar string.
+ * Used in tool result summaries so the LLM sees formatted prices (e.g. "$42.63")
+ * instead of raw cent values that it might misinterpret.
+ */
+function formatPrice(cents) {
+    return `$${(cents / 100).toFixed(2)}`;
+}
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAkBA,kCAEC;AApBY,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AACtD,QAAA,oBAAoB,GAAG,IAAI,CAAC,CAAC,yBAAyB;AACtD,QAAA,oBAAoB,GAAG,WAAW,CAAC;AAEhD,qIAAqI;AACxH,QAAA,oBAAoB,GAAG,IAAI,CAAC;AACzC,4KAA4K;AAC/J,QAAA,kBAAkB,GAAG,IAAI,CAAC;AACvC,oGAAoG;AACvF,QAAA,iBAAiB,GAAG,CAAC,CAAC;AACnC,0FAA0F;AAC7E,QAAA,oBAAoB,GAAG,CAAC,CAAC;AAEtC;;;;GAIG;AACH,SAAgB,WAAW,CAAC,KAAa;IACrC,OAAO,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC"}

package/dist/controllers/admin-chat.controller.d.ts

@@ -0,0 +1,21 @@
+import { Request } from 'express';
+import { RequestContextService, SessionService } from '@vendure/core';
+import { AdminAiChatService, AdminChatResult } from '../services/admin-ai-chat.service';
+export interface AdminChatRequest {
+    message: string;
+    history?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+}
+export interface AdminChatResponse extends AdminChatResult {
+}
+export declare class AdminChatController {
+    private adminAiChatService;
+    private requestContextService;
+    private sessionService;
+    private readonly logger;
+    constructor(adminAiChatService: AdminAiChatService, requestContextService: RequestContextService, sessionService: SessionService);
+    chat(body: AdminChatRequest, req: Request): Promise<AdminChatResponse>;
+}
+//# sourceMappingURL=admin-chat.controller.d.ts.map

package/dist/controllers/admin-chat.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-chat.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/admin-chat.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAExF,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;CAAG;AAE7D,qBACa,mBAAmB;IAIxB,OAAO,CAAC,kBAAkB;IAC1B,OAAO,CAAC,qBAAqB;IAC7B,OAAO,CAAC,cAAc;IAL1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;gBAGnD,kBAAkB,EAAE,kBAAkB,EACtC,qBAAqB,EAAE,qBAAqB,EAC5C,cAAc,EAAE,cAAc;IAIpC,IAAI,CAAS,IAAI,EAAE,gBAAgB,EAAS,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAwB9F"}

package/dist/controllers/admin-chat.controller.js

@@ -0,0 +1,64 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var AdminChatController_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminChatController = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const admin_ai_chat_service_1 = require("../services/admin-ai-chat.service");
+let AdminChatController = AdminChatController_1 = class AdminChatController {
+    constructor(adminAiChatService, requestContextService, sessionService) {
+        this.adminAiChatService = adminAiChatService;
+        this.requestContextService = requestContextService;
+        this.sessionService = sessionService;
+        this.logger = new common_1.Logger(AdminChatController_1.name);
+    }
+    async chat(body, req) {
+        var _a, _b;
+        const authHeader = req.get('Authorization');
+        const tokenMatch = authHeader === null || authHeader === void 0 ? void 0 : authHeader.trim().match(/^bearer\s(.+)$/i);
+        const sessionToken = tokenMatch === null || tokenMatch === void 0 ? void 0 : tokenMatch[1];
+        let session;
+        if (sessionToken) {
+            session = await this.sessionService.getSessionFromToken(sessionToken);
+        }
+        const ctx = await this.requestContextService.fromRequest(req, undefined, undefined, session);
+        const message = ((_a = body.message) !== null && _a !== void 0 ? _a : '').trim();
+        const history = (_b = body.history) !== null && _b !== void 0 ? _b : [];
+        if (!message) {
+            return {
+                message: "Hi! I'm your store admin assistant. I can help you look up products, orders, customers, and collections. What would you like to know?",
+                products: [],
+                collections: [],
+            };
+        }
+        return this.adminAiChatService.chat(ctx, message, history);
+    }
+};
+exports.AdminChatController = AdminChatController;
+__decorate([
+    (0, common_1.Post)('chat'),
+    __param(0, (0, common_1.Body)()),
+    __param(1, (0, common_1.Req)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AdminChatController.prototype, "chat", null);
+exports.AdminChatController = AdminChatController = AdminChatController_1 = __decorate([
+    (0, common_1.Controller)('admin-ai-chat'),
+    __metadata("design:paramtypes", [admin_ai_chat_service_1.AdminAiChatService,
+        core_1.RequestContextService,
+        core_1.SessionService])
+], AdminChatController);
+//# sourceMappingURL=admin-chat.controller.js.map

package/dist/controllers/admin-chat.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-chat.controller.js","sourceRoot":"","sources":["../../src/controllers/admin-chat.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAqE;AAErE,wCAAsE;AACtE,6EAAwF;AAUjF,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAG5B,YACY,kBAAsC,EACtC,qBAA4C,EAC5C,cAA8B;QAF9B,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,mBAAc,GAAd,cAAc,CAAgB;QALzB,WAAM,GAAG,IAAI,eAAM,CAAC,qBAAmB,CAAC,IAAI,CAAC,CAAC;IAM5D,CAAC;IAGE,AAAN,KAAK,CAAC,IAAI,CAAS,IAAsB,EAAS,GAAY;;QAC1D,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,IAAI,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC/D,MAAM,YAAY,GAAG,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,CAAC,CAAC,CAAC;QAErC,IAAI,OAAO,CAAC;QACZ,IAAI,YAAY,EAAE,CAAC;YACf,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7F,MAAM,OAAO,GAAG,CAAC,MAAA,IAAI,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAA,IAAI,CAAC,OAAO,mCAAI,EAAE,CAAC;QAEnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO;gBACH,OAAO,EAAE,uIAAuI;gBAChJ,QAAQ,EAAE,EAAE;gBACZ,WAAW,EAAE,EAAE;aAClB,CAAC;QACN,CAAC;QAED,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;CACJ,CAAA;AAlCY,kDAAmB;AAUtB;IADL,IAAA,aAAI,EAAC,MAAM,CAAC;IACD,WAAA,IAAA,aAAI,GAAE,CAAA;IAA0B,WAAA,IAAA,YAAG,GAAE,CAAA;;;;+CAuBhD;8BAjCQ,mBAAmB;IAD/B,IAAA,mBAAU,EAAC,eAAe,CAAC;qCAKQ,0CAAkB;QACf,4BAAqB;QAC5B,qBAAc;GANjC,mBAAmB,CAkC/B"}