@yassirbenmoussa/aicommerce-sdk 1.0.0

package/README.md

@@ -0,0 +1,163 @@
+# AI Commerce SDK
+
+AI-powered product recommendations for e-commerce. This SDK allows you to easily integrate AI Commerce into your website or application.
+
+## Installation
+
+### npm / yarn / pnpm
+
+```bash
+npm install @ai-commerce/sdk
+# or
+yarn add @ai-commerce/sdk
+# or
+pnpm add @ai-commerce/sdk
+```
+
+### Script Tag (CDN)
+
+```html
+<script src="https://cdn.aicommerce.dev/sdk/ai-commerce.min.js"></script>
+```
+
+## Quick Start
+
+### ES Modules / TypeScript
+
+```typescript
+import { AICommerce } from '@ai-commerce/sdk';
+
+// Initialize the client
+const client = new AICommerce({
+  apiKey: 'your-api-key',
+});
+
+// Send a message and get product recommendations
+const response = await client.chat('I need a laptop under $1000');
+
+console.log(response.reply);      // AI response text
+console.log(response.products);   // Recommended products
+```
+
+### CommonJS
+
+```javascript
+const { AICommerce } = require('@ai-commerce/sdk');
+
+const client = new AICommerce({
+  apiKey: 'your-api-key',
+});
+
+client.chat('I need a laptop').then(response => {
+  console.log(response.products);
+});
+```
+
+### Script Tag
+
+```html
+<script src="https://cdn.aicommerce.dev/sdk/ai-commerce.min.js"></script>
+<script>
+  const client = new AICommerceSDK.AICommerce({
+    apiKey: 'your-api-key'
+  });
+
+  client.chat('I need a laptop').then(response => {
+    console.log(response.products);
+  });
+</script>
+```
+
+## API Reference
+
+### `new AICommerce(config)`
+
+Create a new AI Commerce client.
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `apiKey` | `string` | Yes | Your API key from the dashboard |
+| `baseUrl` | `string` | No | API base URL (defaults to auto-detect) |
+| `timeout` | `number` | No | Request timeout in ms (default: 30000) |
+
+### `client.chat(message, context?)`
+
+Send a message and get product recommendations.
+
+```typescript
+const response = await client.chat('I need running shoes', {
+  budget: { max: 150, currency: 'USD' },
+  preferences: ['comfortable', 'lightweight']
+});
+```
+
+**Returns:**
+
+```typescript
+{
+  reply: string;           // AI response text
+  products: Product[];     // Recommended products
+  sessionToken: string;    // For follow-up messages
+  suggestions?: string[];  // Suggested follow-up questions
+  confidence?: number;     // AI confidence score (0-1)
+}
+```
+
+### `client.createSession()`
+
+Create a new chat session explicitly.
+
+```typescript
+const session = await client.createSession();
+console.log(session.token);
+```
+
+### `client.clearSession()`
+
+Clear the current session token.
+
+### `AICommerce.quickChat(options)`
+
+Static method for one-off requests without creating a client instance.
+
+```typescript
+const response = await AICommerce.quickChat({
+  apiKey: 'your-api-key',
+  message: 'I need a laptop',
+  context: { budget: { max: 1000 } }
+});
+```
+
+## TypeScript Support
+
+Full TypeScript support with exported types:
+
+```typescript
+import type {
+  AICommerceConfig,
+  ChatRequest,
+  ChatResponse,
+  Product,
+  ChatContext
+} from '@ai-commerce/sdk';
+```
+
+## Error Handling
+
+```typescript
+import { AICommerce, AICommerceError } from '@ai-commerce/sdk';
+
+try {
+  const response = await client.chat('Hello');
+} catch (error) {
+  if (error instanceof AICommerceError) {
+    console.log(error.code);    // Error code (e.g., 'UNAUTHORIZED')
+    console.log(error.status);  // HTTP status code
+    console.log(error.message); // Error message
+  }
+}
+```
+
+## License
+
+MIT

package/dist/ai-commerce.min.js

@@ -0,0 +1,4 @@
+var AICommerceSDK=(function(exports){'use strict';/*! AI Commerce SDK v1.0.0 | MIT License | https://aicommerce.dev */
+var m=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var w=(s,e)=>()=>(s&&(e=s(s=0)),e);var g=(s,e)=>{for(var t in e)m(s,t,{get:e[t],enumerable:true});},f=(s,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of C(e))!T.call(s,r)&&r!==t&&m(s,r,{get:()=>e[r],enumerable:!(n=y(e,r))||n.enumerable});return s};var d=s=>f(m({},"__esModule",{value:true}),s);var p={};g(p,{AICommerce:()=>exports.AICommerce,AICommerceError:()=>exports.AICommerceError});exports.AICommerce=void 0;exports.AICommerceError=void 0;var c=w(()=>{exports.AICommerce=class s{constructor(e){this.sessionToken=null;if(!e.apiKey)throw new Error("AICommerce: apiKey is required");this.apiKey=e.apiKey,this.baseUrl=this.normalizeUrl(e.baseUrl||this.detectBaseUrl()),this.timeout=e.timeout||3e4;}detectBaseUrl(){return typeof window<"u"?window.location.origin:"https://api.aicommerce.dev"}normalizeUrl(e){return e.replace(/\/$/,"")}async request(e,t={}){let n=`${this.baseUrl}${e}`,r=new AbortController,l=setTimeout(()=>r.abort(),this.timeout);try{let o=await fetch(n,{...t,signal:r.signal,headers:{"Content-Type":"application/json","X-API-Key":this.apiKey,...this.sessionToken&&{"X-Session-Token":this.sessionToken},...t.headers}});if(clearTimeout(l),!o.ok){let h=await o.json().catch(()=>({})),u={code:h.code||"UNKNOWN_ERROR",message:h.message||h.error||`HTTP ${o.status}`,status:o.status};throw new exports.AICommerceError(u.message,u.code,u.status)}return o.json()}catch(o){throw clearTimeout(l),o instanceof exports.AICommerceError?o:o instanceof Error&&o.name==="AbortError"?new exports.AICommerceError("Request timeout","TIMEOUT",408):new exports.AICommerceError(o instanceof Error?o.message:"Unknown error","NETWORK_ERROR",0)}}async chat(e,t){let n=typeof e=="string"?{message:e,context:t,sessionToken:this.sessionToken||void 0}:{...e,sessionToken:e.sessionToken||this.sessionToken||void 0},r=await this.request("/api/v1/chat",{method:"POST",body:JSON.stringify(n)});return r.sessionToken&&(this.sessionToken=r.sessionToken),r}async createSession(){let e=await this.request("/api/v1/chat/session",{method:"POST"});return this.sessionToken=e.session.token,e.session}clearSession(){this.sessionToken=null;}getSessionToken(){return this.sessionToken}setSessionToken(e){this.sessionToken=e;}static async quickChat(e){return new s({apiKey:e.apiKey,baseUrl:e.baseUrl}).chat(e.message,e.context)}},exports.AICommerceError=class s extends Error{constructor(e,t,n){super(e),this.name="AICommerceError",this.code=t,this.status=n,Object.setPrototypeOf(this,s.prototype);}};});c();var R="1.0.0";typeof window<"u"&&(window.AICommerce=(c(),d(p)).AICommerce,window.AICommerceError=(c(),d(p)).AICommerceError);
+exports.VERSION=R;return exports;})({});//# sourceMappingURL=index.min.js.map
+//# sourceMappingURL=index.min.js.map

package/dist/index.cjs

@@ -0,0 +1,203 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  AICommerce: () => exports.AICommerce,
+  AICommerceError: () => exports.AICommerceError
+});
+exports.AICommerce = void 0; exports.AICommerceError = void 0;
+var init_client = __esm({
+  "src/client.ts"() {
+    exports.AICommerce = class _AICommerce {
+      constructor(config) {
+        this.sessionToken = null;
+        if (!config.apiKey) {
+          throw new Error("AICommerce: apiKey is required");
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = this.normalizeUrl(config.baseUrl || this.detectBaseUrl());
+        this.timeout = config.timeout || 3e4;
+      }
+      /**
+       * Detect the base URL based on environment
+       */
+      detectBaseUrl() {
+        if (typeof window !== "undefined") {
+          return window.location.origin;
+        }
+        return "https://api.aicommerce.dev";
+      }
+      /**
+       * Normalize URL (remove trailing slash)
+       */
+      normalizeUrl(url) {
+        return url.replace(/\/$/, "");
+      }
+      /**
+       * Make an API request
+       */
+      async request(endpoint, options = {}) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+          const response = await fetch(url, {
+            ...options,
+            signal: controller.signal,
+            headers: {
+              "Content-Type": "application/json",
+              "X-API-Key": this.apiKey,
+              ...this.sessionToken && { "X-Session-Token": this.sessionToken },
+              ...options.headers
+            }
+          });
+          clearTimeout(timeoutId);
+          if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            const error = {
+              code: errorData.code || "UNKNOWN_ERROR",
+              message: errorData.message || errorData.error || `HTTP ${response.status}`,
+              status: response.status
+            };
+            throw new exports.AICommerceError(error.message, error.code, error.status);
+          }
+          return response.json();
+        } catch (error) {
+          clearTimeout(timeoutId);
+          if (error instanceof exports.AICommerceError) {
+            throw error;
+          }
+          if (error instanceof Error && error.name === "AbortError") {
+            throw new exports.AICommerceError("Request timeout", "TIMEOUT", 408);
+          }
+          throw new exports.AICommerceError(
+            error instanceof Error ? error.message : "Unknown error",
+            "NETWORK_ERROR",
+            0
+          );
+        }
+      }
+      /**
+       * Send a chat message and get product recommendations
+       * 
+       * @param message - The user's message or full ChatRequest object
+       * @param context - Optional context for better recommendations
+       * @returns Chat response with AI reply and products
+       * 
+       * @example
+       * ```typescript
+       * // Simple usage
+       * const response = await client.chat('I need running shoes');
+       * 
+       * // With context
+       * const response = await client.chat('I need running shoes', {
+       *   budget: { max: 150 },
+       *   preferences: ['comfortable', 'lightweight']
+       * });
+       * ```
+       */
+      async chat(message, context) {
+        const request = typeof message === "string" ? { message, context, sessionToken: this.sessionToken || void 0 } : { ...message, sessionToken: message.sessionToken || this.sessionToken || void 0 };
+        const response = await this.request("/api/v1/chat", {
+          method: "POST",
+          body: JSON.stringify(request)
+        });
+        if (response.sessionToken) {
+          this.sessionToken = response.sessionToken;
+        }
+        return response;
+      }
+      /**
+       * Create a new chat session
+       * 
+       * @returns Session information with token
+       */
+      async createSession() {
+        const response = await this.request("/api/v1/chat/session", {
+          method: "POST"
+        });
+        this.sessionToken = response.session.token;
+        return response.session;
+      }
+      /**
+       * Clear the current session
+       */
+      clearSession() {
+        this.sessionToken = null;
+      }
+      /**
+       * Get the current session token
+       */
+      getSessionToken() {
+        return this.sessionToken;
+      }
+      /**
+       * Set a session token (for restoring sessions)
+       */
+      setSessionToken(token) {
+        this.sessionToken = token;
+      }
+      /**
+       * Static method for one-off chat requests
+       * 
+       * @example
+       * ```typescript
+       * const response = await AICommerce.quickChat({
+       *   apiKey: 'your-api-key',
+       *   message: 'I need a laptop'
+       * });
+       * ```
+       */
+      static async quickChat(options) {
+        const client = new _AICommerce({
+          apiKey: options.apiKey,
+          baseUrl: options.baseUrl
+        });
+        return client.chat(options.message, options.context);
+      }
+    };
+    exports.AICommerceError = class _AICommerceError extends Error {
+      constructor(message, code, status) {
+        super(message);
+        this.name = "AICommerceError";
+        this.code = code;
+        this.status = status;
+        Object.setPrototypeOf(this, _AICommerceError.prototype);
+      }
+    };
+  }
+});
+
+// src/index.ts
+init_client();
+var VERSION = "1.0.0";
+if (typeof window !== "undefined") {
+  window.AICommerce = (init_client(), __toCommonJS(client_exports)).AICommerce;
+  window.AICommerceError = (init_client(), __toCommonJS(client_exports)).AICommerceError;
+}
+
+exports.VERSION = VERSION;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/index.ts"],"names":["AICommerce","AICommerceError"],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\r\n    AICommerceConfig,\r\n    ChatRequest,\r\n    ChatResponse,\r\n    ChatContext,\r\n    Session,\r\n    APIError,\r\n} from './types';\r\n\r\n/**\r\n * AI Commerce SDK Client\r\n * \r\n * @example\r\n * ```typescript\r\n * import { AICommerce } from '@ai-commerce/sdk';\r\n * \r\n * const client = new AICommerce({ apiKey: 'your-api-key' });\r\n * const response = await client.chat('I need a laptop under $1000');\r\n * console.log(response.products);\r\n * ```\r\n */\r\nexport class AICommerce {\r\n    private readonly apiKey: string;\r\n    private readonly baseUrl: string;\r\n    private readonly timeout: number;\r\n    private sessionToken: string | null = null;\r\n\r\n    constructor(config: AICommerceConfig) {\r\n        if (!config.apiKey) {\r\n            throw new Error('AICommerce: apiKey is required');\r\n        }\r\n\r\n        this.apiKey = config.apiKey;\r\n        this.baseUrl = this.normalizeUrl(config.baseUrl || this.detectBaseUrl());\r\n        this.timeout = config.timeout || 30000;\r\n    }\r\n\r\n    /**\r\n     * Detect the base URL based on environment\r\n     */\r\n    private detectBaseUrl(): string {\r\n        // Browser environment\r\n        if (typeof window !== 'undefined') {\r\n            return window.location.origin;\r\n        }\r\n        // Node.js or default\r\n        return 'https://api.aicommerce.dev';\r\n    }\r\n\r\n    /**\r\n     * Normalize URL (remove trailing slash)\r\n     */\r\n    private normalizeUrl(url: string): string {\r\n        return url.replace(/\\/$/, '');\r\n    }\r\n\r\n    /**\r\n     * Make an API request\r\n     */\r\n    private async request<T>(\r\n        endpoint: string,\r\n        options: RequestInit = {}\r\n    ): Promise<T> {\r\n        const url = `${this.baseUrl}${endpoint}`;\r\n\r\n        const controller = new AbortController();\r\n        const timeoutId = setTimeout(() => controller.abort(), this.timeout);\r\n\r\n        try {\r\n            const response = await fetch(url, {\r\n                ...options,\r\n                signal: controller.signal,\r\n                headers: {\r\n                    'Content-Type': 'application/json',\r\n                    'X-API-Key': this.apiKey,\r\n                    ...(this.sessionToken && { 'X-Session-Token': this.sessionToken }),\r\n                    ...options.headers,\r\n                },\r\n            });\r\n\r\n            clearTimeout(timeoutId);\r\n\r\n            if (!response.ok) {\r\n                const errorData = await response.json().catch(() => ({}));\r\n                const error: APIError = {\r\n                    code: errorData.code || 'UNKNOWN_ERROR',\r\n                    message: errorData.message || errorData.error || `HTTP ${response.status}`,\r\n                    status: response.status,\r\n                };\r\n                throw new AICommerceError(error.message, error.code, error.status);\r\n            }\r\n\r\n            return response.json();\r\n        } catch (error) {\r\n            clearTimeout(timeoutId);\r\n\r\n            if (error instanceof AICommerceError) {\r\n                throw error;\r\n            }\r\n\r\n            if (error instanceof Error && error.name === 'AbortError') {\r\n                throw new AICommerceError('Request timeout', 'TIMEOUT', 408);\r\n            }\r\n\r\n            throw new AICommerceError(\r\n                error instanceof Error ? error.message : 'Unknown error',\r\n                'NETWORK_ERROR',\r\n                0\r\n            );\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Send a chat message and get product recommendations\r\n     * \r\n     * @param message - The user's message or full ChatRequest object\r\n     * @param context - Optional context for better recommendations\r\n     * @returns Chat response with AI reply and products\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * // Simple usage\r\n     * const response = await client.chat('I need running shoes');\r\n     * \r\n     * // With context\r\n     * const response = await client.chat('I need running shoes', {\r\n     *   budget: { max: 150 },\r\n     *   preferences: ['comfortable', 'lightweight']\r\n     * });\r\n     * ```\r\n     */\r\n    async chat(\r\n        message: string | ChatRequest,\r\n        context?: ChatContext\r\n    ): Promise<ChatResponse> {\r\n        const request: ChatRequest = typeof message === 'string'\r\n            ? { message, context, sessionToken: this.sessionToken || undefined }\r\n            : { ...message, sessionToken: message.sessionToken || this.sessionToken || undefined };\r\n\r\n        const response = await this.request<ChatResponse>('/api/v1/chat', {\r\n            method: 'POST',\r\n            body: JSON.stringify(request),\r\n        });\r\n\r\n        // Store session token for follow-up messages\r\n        if (response.sessionToken) {\r\n            this.sessionToken = response.sessionToken;\r\n        }\r\n\r\n        return response;\r\n    }\r\n\r\n    /**\r\n     * Create a new chat session\r\n     * \r\n     * @returns Session information with token\r\n     */\r\n    async createSession(): Promise<Session> {\r\n        const response = await this.request<{ session: Session }>('/api/v1/chat/session', {\r\n            method: 'POST',\r\n        });\r\n\r\n        this.sessionToken = response.session.token;\r\n        return response.session;\r\n    }\r\n\r\n    /**\r\n     * Clear the current session\r\n     */\r\n    clearSession(): void {\r\n        this.sessionToken = null;\r\n    }\r\n\r\n    /**\r\n     * Get the current session token\r\n     */\r\n    getSessionToken(): string | null {\r\n        return this.sessionToken;\r\n    }\r\n\r\n    /**\r\n     * Set a session token (for restoring sessions)\r\n     */\r\n    setSessionToken(token: string): void {\r\n        this.sessionToken = token;\r\n    }\r\n\r\n    /**\r\n     * Static method for one-off chat requests\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * const response = await AICommerce.quickChat({\r\n     *   apiKey: 'your-api-key',\r\n     *   message: 'I need a laptop'\r\n     * });\r\n     * ```\r\n     */\r\n    static async quickChat(options: {\r\n        apiKey: string;\r\n        message: string;\r\n        baseUrl?: string;\r\n        context?: ChatContext;\r\n    }): Promise<ChatResponse> {\r\n        const client = new AICommerce({\r\n            apiKey: options.apiKey,\r\n            baseUrl: options.baseUrl,\r\n        });\r\n        return client.chat(options.message, options.context);\r\n    }\r\n}\r\n\r\n/**\r\n * Custom error class for AI Commerce SDK\r\n */\r\nexport class AICommerceError extends Error {\r\n    readonly code: string;\r\n    readonly status: number;\r\n\r\n    constructor(message: string, code: string, status: number) {\r\n        super(message);\r\n        this.name = 'AICommerceError';\r\n        this.code = code;\r\n        this.status = status;\r\n\r\n        // Maintain proper prototype chain\r\n        Object.setPrototypeOf(this, AICommerceError.prototype);\r\n    }\r\n}\r\n","/**\r\n * AI Commerce SDK\r\n * \r\n * AI-powered product recommendations for e-commerce\r\n * \r\n * @packageDocumentation\r\n * @module @ai-commerce/sdk\r\n * \r\n * @example\r\n * ```typescript\r\n * // npm usage\r\n * import { AICommerce } from '@ai-commerce/sdk';\r\n * \r\n * const client = new AICommerce({ apiKey: 'your-api-key' });\r\n * const response = await client.chat('I need a laptop');\r\n * console.log(response.products);\r\n * ```\r\n * \r\n * @example\r\n * ```html\r\n * <!-- Script tag usage -->\r\n * <script src=\"https://cdn.aicommerce.dev/sdk.min.js\"></script>\r\n * <script>\r\n *   const client = new AICommerce({ apiKey: 'your-api-key' });\r\n *   client.chat('I need a laptop').then(response => {\r\n *     console.log(response.products);\r\n *   });\r\n * </script>\r\n * ```\r\n */\r\n\r\n// Export main client\r\nexport { AICommerce, AICommerceError } from './client';\r\n\r\n// Export all types\r\nexport type {\r\n    AICommerceConfig,\r\n    ChatRequest,\r\n    ChatResponse,\r\n    ChatContext,\r\n    Product,\r\n    Session,\r\n    APIError,\r\n    EventType,\r\n    EventCallback,\r\n} from './types';\r\n\r\n// Version\r\nexport const VERSION = '1.0.0';\r\n\r\n// For UMD builds, attach to window\r\nif (typeof window !== 'undefined') {\r\n    // @ts-expect-error - Attaching to window for UMD\r\n    window.AICommerce = require('./client').AICommerce;\r\n    // @ts-expect-error - Attaching to window for UMD\r\n    window.AICommerceError = require('./client').AICommerceError;\r\n}\r\n"]}

package/dist/index.d.mts

@@ -0,0 +1,224 @@
+/**
+ * AI Commerce SDK Types
+ */
+/** SDK Configuration options */
+interface AICommerceConfig {
+    /** Your API key from the AI Commerce dashboard */
+    apiKey: string;
+    /** Base URL for the API (defaults to current origin or https://api.aicommerce.dev) */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/** Chat message request */
+interface ChatRequest {
+    /** The user's message */
+    message: string;
+    /** Optional session token for conversation continuity */
+    sessionToken?: string;
+    /** Optional context for better recommendations */
+    context?: ChatContext;
+}
+/** Additional context for chat requests */
+interface ChatContext {
+    /** Budget range */
+    budget?: {
+        min?: number;
+        max?: number;
+        currency?: string;
+    };
+    /** User preferences */
+    preferences?: string[];
+    /** Category to focus on */
+    category?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/** Chat response from the API */
+interface ChatResponse {
+    /** AI-generated response text */
+    reply: string;
+    /** Recommended products */
+    products: Product[];
+    /** Session token for follow-up messages */
+    sessionToken: string;
+    /** Suggested follow-up questions */
+    suggestions?: string[];
+    /** AI confidence score (0-1) */
+    confidence?: number;
+}
+/** Product information */
+interface Product {
+    /** Unique product ID */
+    id: string;
+    /** Product name */
+    name: string;
+    /** Product description */
+    description?: string;
+    /** Price in the store's currency */
+    price: number;
+    /** Currency code */
+    currency?: string;
+    /** Primary image URL */
+    imageUrl?: string;
+    /** All image URLs */
+    images?: string[];
+    /** Product category */
+    category?: string;
+    /** Product attributes */
+    attributes?: Record<string, string>;
+    /** Relevance score (0-1) */
+    relevanceScore?: number;
+    /** Product URL */
+    url?: string;
+}
+/** Session information */
+interface Session {
+    /** Session token */
+    token: string;
+    /** Session expiration time */
+    expiresAt?: string;
+}
+/** API Error response */
+interface APIError {
+    /** Error code */
+    code: string;
+    /** Error message */
+    message: string;
+    /** HTTP status code */
+    status: number;
+}
+/** Event types for callbacks */
+type EventType = 'message' | 'products' | 'error' | 'session';
+/** Event callback */
+type EventCallback<T = unknown> = (data: T) => void;
+
+/**
+ * AI Commerce SDK Client
+ *
+ * @example
+ * ```typescript
+ * import { AICommerce } from '@ai-commerce/sdk';
+ *
+ * const client = new AICommerce({ apiKey: 'your-api-key' });
+ * const response = await client.chat('I need a laptop under $1000');
+ * console.log(response.products);
+ * ```
+ */
+declare class AICommerce {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    private sessionToken;
+    constructor(config: AICommerceConfig);
+    /**
+     * Detect the base URL based on environment
+     */
+    private detectBaseUrl;
+    /**
+     * Normalize URL (remove trailing slash)
+     */
+    private normalizeUrl;
+    /**
+     * Make an API request
+     */
+    private request;
+    /**
+     * Send a chat message and get product recommendations
+     *
+     * @param message - The user's message or full ChatRequest object
+     * @param context - Optional context for better recommendations
+     * @returns Chat response with AI reply and products
+     *
+     * @example
+     * ```typescript
+     * // Simple usage
+     * const response = await client.chat('I need running shoes');
+     *
+     * // With context
+     * const response = await client.chat('I need running shoes', {
+     *   budget: { max: 150 },
+     *   preferences: ['comfortable', 'lightweight']
+     * });
+     * ```
+     */
+    chat(message: string | ChatRequest, context?: ChatContext): Promise<ChatResponse>;
+    /**
+     * Create a new chat session
+     *
+     * @returns Session information with token
+     */
+    createSession(): Promise<Session>;
+    /**
+     * Clear the current session
+     */
+    clearSession(): void;
+    /**
+     * Get the current session token
+     */
+    getSessionToken(): string | null;
+    /**
+     * Set a session token (for restoring sessions)
+     */
+    setSessionToken(token: string): void;
+    /**
+     * Static method for one-off chat requests
+     *
+     * @example
+     * ```typescript
+     * const response = await AICommerce.quickChat({
+     *   apiKey: 'your-api-key',
+     *   message: 'I need a laptop'
+     * });
+     * ```
+     */
+    static quickChat(options: {
+        apiKey: string;
+        message: string;
+        baseUrl?: string;
+        context?: ChatContext;
+    }): Promise<ChatResponse>;
+}
+/**
+ * Custom error class for AI Commerce SDK
+ */
+declare class AICommerceError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(message: string, code: string, status: number);
+}
+
+/**
+ * AI Commerce SDK
+ *
+ * AI-powered product recommendations for e-commerce
+ *
+ * @packageDocumentation
+ * @module @ai-commerce/sdk
+ *
+ * @example
+ * ```typescript
+ * // npm usage
+ * import { AICommerce } from '@ai-commerce/sdk';
+ *
+ * const client = new AICommerce({ apiKey: 'your-api-key' });
+ * const response = await client.chat('I need a laptop');
+ * console.log(response.products);
+ * ```
+ *
+ * @example
+ * ```html
+ * <!-- Script tag usage -->
+ * <script src="https://cdn.aicommerce.dev/sdk.min.js"></script>
+ * <script>
+ *   const client = new AICommerce({ apiKey: 'your-api-key' });
+ *   client.chat('I need a laptop').then(response => {
+ *     console.log(response.products);
+ *   });
+ * </script>
+ * ```
+ */
+
+declare const VERSION = "1.0.0";
+
+export { AICommerce, type AICommerceConfig, AICommerceError, type APIError, type ChatContext, type ChatRequest, type ChatResponse, type EventCallback, type EventType, type Product, type Session, VERSION };

package/dist/index.d.ts

@@ -0,0 +1,224 @@
+/**
+ * AI Commerce SDK Types
+ */
+/** SDK Configuration options */
+interface AICommerceConfig {
+    /** Your API key from the AI Commerce dashboard */
+    apiKey: string;
+    /** Base URL for the API (defaults to current origin or https://api.aicommerce.dev) */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/** Chat message request */
+interface ChatRequest {
+    /** The user's message */
+    message: string;
+    /** Optional session token for conversation continuity */
+    sessionToken?: string;
+    /** Optional context for better recommendations */
+    context?: ChatContext;
+}
+/** Additional context for chat requests */
+interface ChatContext {
+    /** Budget range */
+    budget?: {
+        min?: number;
+        max?: number;
+        currency?: string;
+    };
+    /** User preferences */
+    preferences?: string[];
+    /** Category to focus on */
+    category?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/** Chat response from the API */
+interface ChatResponse {
+    /** AI-generated response text */
+    reply: string;
+    /** Recommended products */
+    products: Product[];
+    /** Session token for follow-up messages */
+    sessionToken: string;
+    /** Suggested follow-up questions */
+    suggestions?: string[];
+    /** AI confidence score (0-1) */
+    confidence?: number;
+}
+/** Product information */
+interface Product {
+    /** Unique product ID */
+    id: string;
+    /** Product name */
+    name: string;
+    /** Product description */
+    description?: string;
+    /** Price in the store's currency */
+    price: number;
+    /** Currency code */
+    currency?: string;
+    /** Primary image URL */
+    imageUrl?: string;
+    /** All image URLs */
+    images?: string[];
+    /** Product category */
+    category?: string;
+    /** Product attributes */
+    attributes?: Record<string, string>;
+    /** Relevance score (0-1) */
+    relevanceScore?: number;
+    /** Product URL */
+    url?: string;
+}
+/** Session information */
+interface Session {
+    /** Session token */
+    token: string;
+    /** Session expiration time */
+    expiresAt?: string;
+}
+/** API Error response */
+interface APIError {
+    /** Error code */
+    code: string;
+    /** Error message */
+    message: string;
+    /** HTTP status code */
+    status: number;
+}
+/** Event types for callbacks */
+type EventType = 'message' | 'products' | 'error' | 'session';
+/** Event callback */
+type EventCallback<T = unknown> = (data: T) => void;
+
+/**
+ * AI Commerce SDK Client
+ *
+ * @example
+ * ```typescript
+ * import { AICommerce } from '@ai-commerce/sdk';
+ *
+ * const client = new AICommerce({ apiKey: 'your-api-key' });
+ * const response = await client.chat('I need a laptop under $1000');
+ * console.log(response.products);
+ * ```
+ */
+declare class AICommerce {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    private sessionToken;
+    constructor(config: AICommerceConfig);
+    /**
+     * Detect the base URL based on environment
+     */
+    private detectBaseUrl;
+    /**
+     * Normalize URL (remove trailing slash)
+     */
+    private normalizeUrl;
+    /**
+     * Make an API request
+     */
+    private request;
+    /**
+     * Send a chat message and get product recommendations
+     *
+     * @param message - The user's message or full ChatRequest object
+     * @param context - Optional context for better recommendations
+     * @returns Chat response with AI reply and products
+     *
+     * @example
+     * ```typescript
+     * // Simple usage
+     * const response = await client.chat('I need running shoes');
+     *
+     * // With context
+     * const response = await client.chat('I need running shoes', {
+     *   budget: { max: 150 },
+     *   preferences: ['comfortable', 'lightweight']
+     * });
+     * ```
+     */
+    chat(message: string | ChatRequest, context?: ChatContext): Promise<ChatResponse>;
+    /**
+     * Create a new chat session
+     *
+     * @returns Session information with token
+     */
+    createSession(): Promise<Session>;
+    /**
+     * Clear the current session
+     */
+    clearSession(): void;
+    /**
+     * Get the current session token
+     */
+    getSessionToken(): string | null;
+    /**
+     * Set a session token (for restoring sessions)
+     */
+    setSessionToken(token: string): void;
+    /**
+     * Static method for one-off chat requests
+     *
+     * @example
+     * ```typescript
+     * const response = await AICommerce.quickChat({
+     *   apiKey: 'your-api-key',
+     *   message: 'I need a laptop'
+     * });
+     * ```
+     */
+    static quickChat(options: {
+        apiKey: string;
+        message: string;
+        baseUrl?: string;
+        context?: ChatContext;
+    }): Promise<ChatResponse>;
+}
+/**
+ * Custom error class for AI Commerce SDK
+ */
+declare class AICommerceError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(message: string, code: string, status: number);
+}
+
+/**
+ * AI Commerce SDK
+ *
+ * AI-powered product recommendations for e-commerce
+ *
+ * @packageDocumentation
+ * @module @ai-commerce/sdk
+ *
+ * @example
+ * ```typescript
+ * // npm usage
+ * import { AICommerce } from '@ai-commerce/sdk';
+ *
+ * const client = new AICommerce({ apiKey: 'your-api-key' });
+ * const response = await client.chat('I need a laptop');
+ * console.log(response.products);
+ * ```
+ *
+ * @example
+ * ```html
+ * <!-- Script tag usage -->
+ * <script src="https://cdn.aicommerce.dev/sdk.min.js"></script>
+ * <script>
+ *   const client = new AICommerce({ apiKey: 'your-api-key' });
+ *   client.chat('I need a laptop').then(response => {
+ *     console.log(response.products);
+ *   });
+ * </script>
+ * ```
+ */
+
+declare const VERSION = "1.0.0";
+
+export { AICommerce, type AICommerceConfig, AICommerceError, type APIError, type ChatContext, type ChatRequest, type ChatResponse, type EventCallback, type EventType, type Product, type Session, VERSION };

package/dist/index.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/index.ts"],"names":["client_exports","__export","AICommerce","AICommerceError","init_client","__esmMin","_AICommerce","config","url","endpoint","options","controller","timeoutId","response","errorData","error","message","context","request","token","_AICommerceError","code","status","VERSION"],"mappings":"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","file":"index.min.js","sourcesContent":["import type {\r\n    AICommerceConfig,\r\n    ChatRequest,\r\n    ChatResponse,\r\n    ChatContext,\r\n    Session,\r\n    APIError,\r\n} from './types';\r\n\r\n/**\r\n * AI Commerce SDK Client\r\n * \r\n * @example\r\n * ```typescript\r\n * import { AICommerce } from '@ai-commerce/sdk';\r\n * \r\n * const client = new AICommerce({ apiKey: 'your-api-key' });\r\n * const response = await client.chat('I need a laptop under $1000');\r\n * console.log(response.products);\r\n * ```\r\n */\r\nexport class AICommerce {\r\n    private readonly apiKey: string;\r\n    private readonly baseUrl: string;\r\n    private readonly timeout: number;\r\n    private sessionToken: string | null = null;\r\n\r\n    constructor(config: AICommerceConfig) {\r\n        if (!config.apiKey) {\r\n            throw new Error('AICommerce: apiKey is required');\r\n        }\r\n\r\n        this.apiKey = config.apiKey;\r\n        this.baseUrl = this.normalizeUrl(config.baseUrl || this.detectBaseUrl());\r\n        this.timeout = config.timeout || 30000;\r\n    }\r\n\r\n    /**\r\n     * Detect the base URL based on environment\r\n     */\r\n    private detectBaseUrl(): string {\r\n        // Browser environment\r\n        if (typeof window !== 'undefined') {\r\n            return window.location.origin;\r\n        }\r\n        // Node.js or default\r\n        return 'https://api.aicommerce.dev';\r\n    }\r\n\r\n    /**\r\n     * Normalize URL (remove trailing slash)\r\n     */\r\n    private normalizeUrl(url: string): string {\r\n        return url.replace(/\\/$/, '');\r\n    }\r\n\r\n    /**\r\n     * Make an API request\r\n     */\r\n    private async request<T>(\r\n        endpoint: string,\r\n        options: RequestInit = {}\r\n    ): Promise<T> {\r\n        const url = `${this.baseUrl}${endpoint}`;\r\n\r\n        const controller = new AbortController();\r\n        const timeoutId = setTimeout(() => controller.abort(), this.timeout);\r\n\r\n        try {\r\n            const response = await fetch(url, {\r\n                ...options,\r\n                signal: controller.signal,\r\n                headers: {\r\n                    'Content-Type': 'application/json',\r\n                    'X-API-Key': this.apiKey,\r\n                    ...(this.sessionToken && { 'X-Session-Token': this.sessionToken }),\r\n                    ...options.headers,\r\n                },\r\n            });\r\n\r\n            clearTimeout(timeoutId);\r\n\r\n            if (!response.ok) {\r\n                const errorData = await response.json().catch(() => ({}));\r\n                const error: APIError = {\r\n                    code: errorData.code || 'UNKNOWN_ERROR',\r\n                    message: errorData.message || errorData.error || `HTTP ${response.status}`,\r\n                    status: response.status,\r\n                };\r\n                throw new AICommerceError(error.message, error.code, error.status);\r\n            }\r\n\r\n            return response.json();\r\n        } catch (error) {\r\n            clearTimeout(timeoutId);\r\n\r\n            if (error instanceof AICommerceError) {\r\n                throw error;\r\n            }\r\n\r\n            if (error instanceof Error && error.name === 'AbortError') {\r\n                throw new AICommerceError('Request timeout', 'TIMEOUT', 408);\r\n            }\r\n\r\n            throw new AICommerceError(\r\n                error instanceof Error ? error.message : 'Unknown error',\r\n                'NETWORK_ERROR',\r\n                0\r\n            );\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Send a chat message and get product recommendations\r\n     * \r\n     * @param message - The user's message or full ChatRequest object\r\n     * @param context - Optional context for better recommendations\r\n     * @returns Chat response with AI reply and products\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * // Simple usage\r\n     * const response = await client.chat('I need running shoes');\r\n     * \r\n     * // With context\r\n     * const response = await client.chat('I need running shoes', {\r\n     *   budget: { max: 150 },\r\n     *   preferences: ['comfortable', 'lightweight']\r\n     * });\r\n     * ```\r\n     */\r\n    async chat(\r\n        message: string | ChatRequest,\r\n        context?: ChatContext\r\n    ): Promise<ChatResponse> {\r\n        const request: ChatRequest = typeof message === 'string'\r\n            ? { message, context, sessionToken: this.sessionToken || undefined }\r\n            : { ...message, sessionToken: message.sessionToken || this.sessionToken || undefined };\r\n\r\n        const response = await this.request<ChatResponse>('/api/v1/chat', {\r\n            method: 'POST',\r\n            body: JSON.stringify(request),\r\n        });\r\n\r\n        // Store session token for follow-up messages\r\n        if (response.sessionToken) {\r\n            this.sessionToken = response.sessionToken;\r\n        }\r\n\r\n        return response;\r\n    }\r\n\r\n    /**\r\n     * Create a new chat session\r\n     * \r\n     * @returns Session information with token\r\n     */\r\n    async createSession(): Promise<Session> {\r\n        const response = await this.request<{ session: Session }>('/api/v1/chat/session', {\r\n            method: 'POST',\r\n        });\r\n\r\n        this.sessionToken = response.session.token;\r\n        return response.session;\r\n    }\r\n\r\n    /**\r\n     * Clear the current session\r\n     */\r\n    clearSession(): void {\r\n        this.sessionToken = null;\r\n    }\r\n\r\n    /**\r\n     * Get the current session token\r\n     */\r\n    getSessionToken(): string | null {\r\n        return this.sessionToken;\r\n    }\r\n\r\n    /**\r\n     * Set a session token (for restoring sessions)\r\n     */\r\n    setSessionToken(token: string): void {\r\n        this.sessionToken = token;\r\n    }\r\n\r\n    /**\r\n     * Static method for one-off chat requests\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * const response = await AICommerce.quickChat({\r\n     *   apiKey: 'your-api-key',\r\n     *   message: 'I need a laptop'\r\n     * });\r\n     * ```\r\n     */\r\n    static async quickChat(options: {\r\n        apiKey: string;\r\n        message: string;\r\n        baseUrl?: string;\r\n        context?: ChatContext;\r\n    }): Promise<ChatResponse> {\r\n        const client = new AICommerce({\r\n            apiKey: options.apiKey,\r\n            baseUrl: options.baseUrl,\r\n        });\r\n        return client.chat(options.message, options.context);\r\n    }\r\n}\r\n\r\n/**\r\n * Custom error class for AI Commerce SDK\r\n */\r\nexport class AICommerceError extends Error {\r\n    readonly code: string;\r\n    readonly status: number;\r\n\r\n    constructor(message: string, code: string, status: number) {\r\n        super(message);\r\n        this.name = 'AICommerceError';\r\n        this.code = code;\r\n        this.status = status;\r\n\r\n        // Maintain proper prototype chain\r\n        Object.setPrototypeOf(this, AICommerceError.prototype);\r\n    }\r\n}\r\n","/**\r\n * AI Commerce SDK\r\n * \r\n * AI-powered product recommendations for e-commerce\r\n * \r\n * @packageDocumentation\r\n * @module @ai-commerce/sdk\r\n * \r\n * @example\r\n * ```typescript\r\n * // npm usage\r\n * import { AICommerce } from '@ai-commerce/sdk';\r\n * \r\n * const client = new AICommerce({ apiKey: 'your-api-key' });\r\n * const response = await client.chat('I need a laptop');\r\n * console.log(response.products);\r\n * ```\r\n * \r\n * @example\r\n * ```html\r\n * <!-- Script tag usage -->\r\n * <script src=\"https://cdn.aicommerce.dev/sdk.min.js\"></script>\r\n * <script>\r\n *   const client = new AICommerce({ apiKey: 'your-api-key' });\r\n *   client.chat('I need a laptop').then(response => {\r\n *     console.log(response.products);\r\n *   });\r\n * </script>\r\n * ```\r\n */\r\n\r\n// Export main client\r\nexport { AICommerce, AICommerceError } from './client';\r\n\r\n// Export all types\r\nexport type {\r\n    AICommerceConfig,\r\n    ChatRequest,\r\n    ChatResponse,\r\n    ChatContext,\r\n    Product,\r\n    Session,\r\n    APIError,\r\n    EventType,\r\n    EventCallback,\r\n} from './types';\r\n\r\n// Version\r\nexport const VERSION = '1.0.0';\r\n\r\n// For UMD builds, attach to window\r\nif (typeof window !== 'undefined') {\r\n    // @ts-expect-error - Attaching to window for UMD\r\n    window.AICommerce = require('./client').AICommerce;\r\n    // @ts-expect-error - Attaching to window for UMD\r\n    window.AICommerceError = require('./client').AICommerceError;\r\n}\r\n"]}

package/dist/index.mjs

@@ -0,0 +1,201 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  AICommerce: () => AICommerce,
+  AICommerceError: () => AICommerceError
+});
+var AICommerce, AICommerceError;
+var init_client = __esm({
+  "src/client.ts"() {
+    AICommerce = class _AICommerce {
+      constructor(config) {
+        this.sessionToken = null;
+        if (!config.apiKey) {
+          throw new Error("AICommerce: apiKey is required");
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = this.normalizeUrl(config.baseUrl || this.detectBaseUrl());
+        this.timeout = config.timeout || 3e4;
+      }
+      /**
+       * Detect the base URL based on environment
+       */
+      detectBaseUrl() {
+        if (typeof window !== "undefined") {
+          return window.location.origin;
+        }
+        return "https://api.aicommerce.dev";
+      }
+      /**
+       * Normalize URL (remove trailing slash)
+       */
+      normalizeUrl(url) {
+        return url.replace(/\/$/, "");
+      }
+      /**
+       * Make an API request
+       */
+      async request(endpoint, options = {}) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+          const response = await fetch(url, {
+            ...options,
+            signal: controller.signal,
+            headers: {
+              "Content-Type": "application/json",
+              "X-API-Key": this.apiKey,
+              ...this.sessionToken && { "X-Session-Token": this.sessionToken },
+              ...options.headers
+            }
+          });
+          clearTimeout(timeoutId);
+          if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            const error = {
+              code: errorData.code || "UNKNOWN_ERROR",
+              message: errorData.message || errorData.error || `HTTP ${response.status}`,
+              status: response.status
+            };
+            throw new AICommerceError(error.message, error.code, error.status);
+          }
+          return response.json();
+        } catch (error) {
+          clearTimeout(timeoutId);
+          if (error instanceof AICommerceError) {
+            throw error;
+          }
+          if (error instanceof Error && error.name === "AbortError") {
+            throw new AICommerceError("Request timeout", "TIMEOUT", 408);
+          }
+          throw new AICommerceError(
+            error instanceof Error ? error.message : "Unknown error",
+            "NETWORK_ERROR",
+            0
+          );
+        }
+      }
+      /**
+       * Send a chat message and get product recommendations
+       * 
+       * @param message - The user's message or full ChatRequest object
+       * @param context - Optional context for better recommendations
+       * @returns Chat response with AI reply and products
+       * 
+       * @example
+       * ```typescript
+       * // Simple usage
+       * const response = await client.chat('I need running shoes');
+       * 
+       * // With context
+       * const response = await client.chat('I need running shoes', {
+       *   budget: { max: 150 },
+       *   preferences: ['comfortable', 'lightweight']
+       * });
+       * ```
+       */
+      async chat(message, context) {
+        const request = typeof message === "string" ? { message, context, sessionToken: this.sessionToken || void 0 } : { ...message, sessionToken: message.sessionToken || this.sessionToken || void 0 };
+        const response = await this.request("/api/v1/chat", {
+          method: "POST",
+          body: JSON.stringify(request)
+        });
+        if (response.sessionToken) {
+          this.sessionToken = response.sessionToken;
+        }
+        return response;
+      }
+      /**
+       * Create a new chat session
+       * 
+       * @returns Session information with token
+       */
+      async createSession() {
+        const response = await this.request("/api/v1/chat/session", {
+          method: "POST"
+        });
+        this.sessionToken = response.session.token;
+        return response.session;
+      }
+      /**
+       * Clear the current session
+       */
+      clearSession() {
+        this.sessionToken = null;
+      }
+      /**
+       * Get the current session token
+       */
+      getSessionToken() {
+        return this.sessionToken;
+      }
+      /**
+       * Set a session token (for restoring sessions)
+       */
+      setSessionToken(token) {
+        this.sessionToken = token;
+      }
+      /**
+       * Static method for one-off chat requests
+       * 
+       * @example
+       * ```typescript
+       * const response = await AICommerce.quickChat({
+       *   apiKey: 'your-api-key',
+       *   message: 'I need a laptop'
+       * });
+       * ```
+       */
+      static async quickChat(options) {
+        const client = new _AICommerce({
+          apiKey: options.apiKey,
+          baseUrl: options.baseUrl
+        });
+        return client.chat(options.message, options.context);
+      }
+    };
+    AICommerceError = class _AICommerceError extends Error {
+      constructor(message, code, status) {
+        super(message);
+        this.name = "AICommerceError";
+        this.code = code;
+        this.status = status;
+        Object.setPrototypeOf(this, _AICommerceError.prototype);
+      }
+    };
+  }
+});
+
+// src/index.ts
+init_client();
+var VERSION = "1.0.0";
+if (typeof window !== "undefined") {
+  window.AICommerce = (init_client(), __toCommonJS(client_exports)).AICommerce;
+  window.AICommerceError = (init_client(), __toCommonJS(client_exports)).AICommerceError;
+}
+
+export { AICommerce, AICommerceError, VERSION };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type {\r\n    AICommerceConfig,\r\n    ChatRequest,\r\n    ChatResponse,\r\n    ChatContext,\r\n    Session,\r\n    APIError,\r\n} from './types';\r\n\r\n/**\r\n * AI Commerce SDK Client\r\n * \r\n * @example\r\n * ```typescript\r\n * import { AICommerce } from '@ai-commerce/sdk';\r\n * \r\n * const client = new AICommerce({ apiKey: 'your-api-key' });\r\n * const response = await client.chat('I need a laptop under $1000');\r\n * console.log(response.products);\r\n * ```\r\n */\r\nexport class AICommerce {\r\n    private readonly apiKey: string;\r\n    private readonly baseUrl: string;\r\n    private readonly timeout: number;\r\n    private sessionToken: string | null = null;\r\n\r\n    constructor(config: AICommerceConfig) {\r\n        if (!config.apiKey) {\r\n            throw new Error('AICommerce: apiKey is required');\r\n        }\r\n\r\n        this.apiKey = config.apiKey;\r\n        this.baseUrl = this.normalizeUrl(config.baseUrl || this.detectBaseUrl());\r\n        this.timeout = config.timeout || 30000;\r\n    }\r\n\r\n    /**\r\n     * Detect the base URL based on environment\r\n     */\r\n    private detectBaseUrl(): string {\r\n        // Browser environment\r\n        if (typeof window !== 'undefined') {\r\n            return window.location.origin;\r\n        }\r\n        // Node.js or default\r\n        return 'https://api.aicommerce.dev';\r\n    }\r\n\r\n    /**\r\n     * Normalize URL (remove trailing slash)\r\n     */\r\n    private normalizeUrl(url: string): string {\r\n        return url.replace(/\\/$/, '');\r\n    }\r\n\r\n    /**\r\n     * Make an API request\r\n     */\r\n    private async request<T>(\r\n        endpoint: string,\r\n        options: RequestInit = {}\r\n    ): Promise<T> {\r\n        const url = `${this.baseUrl}${endpoint}`;\r\n\r\n        const controller = new AbortController();\r\n        const timeoutId = setTimeout(() => controller.abort(), this.timeout);\r\n\r\n        try {\r\n            const response = await fetch(url, {\r\n                ...options,\r\n                signal: controller.signal,\r\n                headers: {\r\n                    'Content-Type': 'application/json',\r\n                    'X-API-Key': this.apiKey,\r\n                    ...(this.sessionToken && { 'X-Session-Token': this.sessionToken }),\r\n                    ...options.headers,\r\n                },\r\n            });\r\n\r\n            clearTimeout(timeoutId);\r\n\r\n            if (!response.ok) {\r\n                const errorData = await response.json().catch(() => ({}));\r\n                const error: APIError = {\r\n                    code: errorData.code || 'UNKNOWN_ERROR',\r\n                    message: errorData.message || errorData.error || `HTTP ${response.status}`,\r\n                    status: response.status,\r\n                };\r\n                throw new AICommerceError(error.message, error.code, error.status);\r\n            }\r\n\r\n            return response.json();\r\n        } catch (error) {\r\n            clearTimeout(timeoutId);\r\n\r\n            if (error instanceof AICommerceError) {\r\n                throw error;\r\n            }\r\n\r\n            if (error instanceof Error && error.name === 'AbortError') {\r\n                throw new AICommerceError('Request timeout', 'TIMEOUT', 408);\r\n            }\r\n\r\n            throw new AICommerceError(\r\n                error instanceof Error ? error.message : 'Unknown error',\r\n                'NETWORK_ERROR',\r\n                0\r\n            );\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Send a chat message and get product recommendations\r\n     * \r\n     * @param message - The user's message or full ChatRequest object\r\n     * @param context - Optional context for better recommendations\r\n     * @returns Chat response with AI reply and products\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * // Simple usage\r\n     * const response = await client.chat('I need running shoes');\r\n     * \r\n     * // With context\r\n     * const response = await client.chat('I need running shoes', {\r\n     *   budget: { max: 150 },\r\n     *   preferences: ['comfortable', 'lightweight']\r\n     * });\r\n     * ```\r\n     */\r\n    async chat(\r\n        message: string | ChatRequest,\r\n        context?: ChatContext\r\n    ): Promise<ChatResponse> {\r\n        const request: ChatRequest = typeof message === 'string'\r\n            ? { message, context, sessionToken: this.sessionToken || undefined }\r\n            : { ...message, sessionToken: message.sessionToken || this.sessionToken || undefined };\r\n\r\n        const response = await this.request<ChatResponse>('/api/v1/chat', {\r\n            method: 'POST',\r\n            body: JSON.stringify(request),\r\n        });\r\n\r\n        // Store session token for follow-up messages\r\n        if (response.sessionToken) {\r\n            this.sessionToken = response.sessionToken;\r\n        }\r\n\r\n        return response;\r\n    }\r\n\r\n    /**\r\n     * Create a new chat session\r\n     * \r\n     * @returns Session information with token\r\n     */\r\n    async createSession(): Promise<Session> {\r\n        const response = await this.request<{ session: Session }>('/api/v1/chat/session', {\r\n            method: 'POST',\r\n        });\r\n\r\n        this.sessionToken = response.session.token;\r\n        return response.session;\r\n    }\r\n\r\n    /**\r\n     * Clear the current session\r\n     */\r\n    clearSession(): void {\r\n        this.sessionToken = null;\r\n    }\r\n\r\n    /**\r\n     * Get the current session token\r\n     */\r\n    getSessionToken(): string | null {\r\n        return this.sessionToken;\r\n    }\r\n\r\n    /**\r\n     * Set a session token (for restoring sessions)\r\n     */\r\n    setSessionToken(token: string): void {\r\n        this.sessionToken = token;\r\n    }\r\n\r\n    /**\r\n     * Static method for one-off chat requests\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * const response = await AICommerce.quickChat({\r\n     *   apiKey: 'your-api-key',\r\n     *   message: 'I need a laptop'\r\n     * });\r\n     * ```\r\n     */\r\n    static async quickChat(options: {\r\n        apiKey: string;\r\n        message: string;\r\n        baseUrl?: string;\r\n        context?: ChatContext;\r\n    }): Promise<ChatResponse> {\r\n        const client = new AICommerce({\r\n            apiKey: options.apiKey,\r\n            baseUrl: options.baseUrl,\r\n        });\r\n        return client.chat(options.message, options.context);\r\n    }\r\n}\r\n\r\n/**\r\n * Custom error class for AI Commerce SDK\r\n */\r\nexport class AICommerceError extends Error {\r\n    readonly code: string;\r\n    readonly status: number;\r\n\r\n    constructor(message: string, code: string, status: number) {\r\n        super(message);\r\n        this.name = 'AICommerceError';\r\n        this.code = code;\r\n        this.status = status;\r\n\r\n        // Maintain proper prototype chain\r\n        Object.setPrototypeOf(this, AICommerceError.prototype);\r\n    }\r\n}\r\n","/**\r\n * AI Commerce SDK\r\n * \r\n * AI-powered product recommendations for e-commerce\r\n * \r\n * @packageDocumentation\r\n * @module @ai-commerce/sdk\r\n * \r\n * @example\r\n * ```typescript\r\n * // npm usage\r\n * import { AICommerce } from '@ai-commerce/sdk';\r\n * \r\n * const client = new AICommerce({ apiKey: 'your-api-key' });\r\n * const response = await client.chat('I need a laptop');\r\n * console.log(response.products);\r\n * ```\r\n * \r\n * @example\r\n * ```html\r\n * <!-- Script tag usage -->\r\n * <script src=\"https://cdn.aicommerce.dev/sdk.min.js\"></script>\r\n * <script>\r\n *   const client = new AICommerce({ apiKey: 'your-api-key' });\r\n *   client.chat('I need a laptop').then(response => {\r\n *     console.log(response.products);\r\n *   });\r\n * </script>\r\n * ```\r\n */\r\n\r\n// Export main client\r\nexport { AICommerce, AICommerceError } from './client';\r\n\r\n// Export all types\r\nexport type {\r\n    AICommerceConfig,\r\n    ChatRequest,\r\n    ChatResponse,\r\n    ChatContext,\r\n    Product,\r\n    Session,\r\n    APIError,\r\n    EventType,\r\n    EventCallback,\r\n} from './types';\r\n\r\n// Version\r\nexport const VERSION = '1.0.0';\r\n\r\n// For UMD builds, attach to window\r\nif (typeof window !== 'undefined') {\r\n    // @ts-expect-error - Attaching to window for UMD\r\n    window.AICommerce = require('./client').AICommerce;\r\n    // @ts-expect-error - Attaching to window for UMD\r\n    window.AICommerceError = require('./client').AICommerceError;\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+    "name": "@yassirbenmoussa/aicommerce-sdk",
+    "version": "1.0.0",
+    "description": "AI Commerce SDK - AI-powered product recommendations for e-commerce",
+    "author": "AI Commerce",
+    "license": "MIT",
+    "main": "dist/index.cjs",
+    "module": "dist/index.mjs",
+    "browser": "dist/ai-commerce.min.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.cjs",
+            "browser": "./dist/ai-commerce.min.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "typecheck": "tsc --noEmit",
+        "clean": "rimraf dist"
+    },
+    "keywords": [
+        "ai",
+        "commerce",
+        "ecommerce",
+        "product-recommendations",
+        "chatbot",
+        "ai-assistant"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/your-org/ai-commerce"
+    },
+    "devDependencies": {
+        "tsup": "^8.0.0",
+        "typescript": "^5.3.0",
+        "rimraf": "^5.0.0"
+    },
+    "peerDependencies": {},
+    "engines": {
+        "node": ">=16"
+    }
+}