@aizu-chat/react 0.1.2 → 0.1.3

package/dist/components.mjs

@@ -0,0 +1,17 @@
+'use client'
+import {
+  AizuChat,
+  Button,
+  Loading,
+  QuickMenus,
+  TestComponent
+} from "./chunk-XEQE67X7.mjs";
+import "./chunk-NBQP747C.mjs";
+import "./chunk-33CPD3DF.mjs";
+export {
+  AizuChat,
+  Button,
+  Loading,
+  QuickMenus,
+  TestComponent
+};

package/dist/hooks.d.mts

@@ -0,0 +1,6 @@
+declare const useCustom: () => {
+    count: number;
+    increment: () => void;
+};
+
+export { useCustom };

package/dist/hooks.d.ts

@@ -0,0 +1,6 @@
+declare const useCustom: () => {
+    count: number;
+    increment: () => void;
+};
+
+export { useCustom };

package/dist/hooks.js

@@ -0,0 +1,40 @@
+'use client'
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/hooks/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useCustom: () => useCustom
+});
+module.exports = __toCommonJS(hooks_exports);
+
+// src/hooks/use-custom.ts
+var import_react = require("react");
+var useCustom = () => {
+  const [count, setCount] = (0, import_react.useState)(0);
+  const increment = () => {
+    setCount(count + 1);
+  };
+  return { count, increment };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useCustom
+});

package/dist/hooks.mjs

@@ -0,0 +1,8 @@
+'use client'
+import {
+  useCustom
+} from "./chunk-KLPKNMIP.mjs";
+import "./chunk-33CPD3DF.mjs";
+export {
+  useCustom
+};

package/dist/index.d.mts

@@ -39,16 +39,162 @@ declare enum TypeResponse {
     START_SHOPPING = "start_shopping"
 }
 
+/**
+ * Aizu Chat API Client
+ *
+ * A client for interacting with the Aizu Chat API. Handles authentication,
+ * request timeouts, and error handling automatically.
+ *
+ * @example
+ * ```typescript
+ * const client = new AizuClient({
+ *   hostUrl: 'https://api.aizu.chat',
+ *   apiKey: 'your-api-key',
+ *   timeout: 30000
+ * });
+ *
+ * const response = await client.chat({
+ *   query: 'Hello, how are you?',
+ *   conversationId: 'optional-conversation-id'
+ * });
+ * ```
+ */
 declare class AizuClient {
     private hostUrl;
     private apiKey;
     private timeout;
+    /**
+     * Creates a new AizuClient instance
+     *
+     * @param config - Configuration options for the client
+     * @param config.hostUrl - The base URL of the Aizu API (e.g., 'https://api.aizu.chat')
+     * @param config.apiKey - Your API key for authentication
+     * @param config.timeout - Request timeout in milliseconds (default: 30000)
+     *
+     * @throws {Error} If hostUrl is not a non-empty string
+     * @throws {Error} If apiKey is not a non-empty string
+     *
+     * @example
+     * ```typescript
+     * const client = new AizuClient({
+     *   hostUrl: 'https://api.aizu.chat',
+     *   apiKey: 'sk_test_123456',
+     *   timeout: 60000 // 60 seconds
+     * });
+     * ```
+     */
     constructor(config: AizuClientConfig);
+    /**
+     * Internal method for making HTTP requests to the API
+     *
+     * Handles timeout management, abort signal combination, and error handling.
+     * Supports both user-initiated cancellation and automatic timeout.
+     *
+     * @template T - The expected response type
+     * @template TBody - The request body type
+     *
+     * @param path - API endpoint path (e.g., '/chat/query')
+     * @param options - Request options including body and signal
+     *
+     * @returns Promise resolving to the API response
+     *
+     * @throws {Error} "Request cancelled by user" - If the request is cancelled via AbortSignal
+     * @throws {Error} "Request timeout: The server took too long to respond" - If the request exceeds the timeout
+     * @throws {Error} "API Error: {status} {statusText}" - If the API returns an error status
+     *
+     * @private
+     */
     private request;
+    /**
+     * Sends a chat query to the Aizu API
+     *
+     * @param params - Chat request parameters
+     * @param params.query - The user's message/question (required, non-empty)
+     * @param params.conversationId - Optional conversation ID to continue an existing conversation
+     * @param options - Additional options
+     * @param options.signal - Optional AbortSignal to cancel the request
+     *
+     * @returns Promise resolving to the chat response from the API
+     *
+     * @throws {Error} "Query is required" - If query is empty or whitespace only
+     * @throws {Error} "Request cancelled by user" - If the request is cancelled
+     * @throws {Error} "Request timeout: The server took too long to respond" - If the request times out
+     * @throws {Error} "API Error: {status} {statusText}" - If the API returns an error
+     *
+     * @example
+     * ```typescript
+     * // Simple query
+     * const response = await client.chat({
+     *   query: 'What is the weather today?'
+     * });
+     * console.log(response.answer);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Continue conversation
+     * const response1 = await client.chat({
+     *   query: 'What is the weather today?'
+     * });
+     *
+     * const response2 = await client.chat({
+     *   query: 'And tomorrow?',
+     *   conversationId: response1.conversationId
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // With cancellation support
+     * const controller = new AbortController();
+     *
+     * const promise = client.chat(
+     *   { query: 'Long running query...' },
+     *   { signal: controller.signal }
+     * );
+     *
+     * // Cancel after 5 seconds
+     * setTimeout(() => controller.abort(), 5000);
+     *
+     * try {
+     *   const response = await promise;
+     * } catch (error) {
+     *   console.error('Request was cancelled:', error);
+     * }
+     * ```
+     */
     chat(params: ChatRequest, options?: {
         signal?: AbortSignal;
     }): Promise<ChatResponse>;
 }
+/**
+ * Factory function to create a new AizuClient instance
+ *
+ * This is a convenience function that wraps the AizuClient constructor.
+ * Use this when you prefer a functional approach over instantiating the class directly.
+ *
+ * @param config - Configuration options for the client
+ * @param config.hostUrl - The base URL of the Aizu API
+ * @param config.apiKey - Your API key for authentication
+ * @param config.timeout - Optional request timeout in milliseconds (default: 30000)
+ *
+ * @returns A new AizuClient instance
+ *
+ * @throws {Error} If hostUrl or apiKey are invalid
+ *
+ * @example
+ * ```typescript
+ * const client = createAizuClient({
+ *   hostUrl: process.env.AIZU_HOST_URL!,
+ *   apiKey: process.env.AIZU_API_KEY!,
+ *   timeout: 45000
+ * });
+ *
+ * const response = await client.chat({
+ *   query: 'Hello!'
+ * });
+ * ```
+ */
 declare const createAizuClient: ({ hostUrl, apiKey, timeout, }: {
     hostUrl: string;
     apiKey: string;

package/dist/index.d.ts

@@ -39,16 +39,162 @@ declare enum TypeResponse {
     START_SHOPPING = "start_shopping"
 }
 
+/**
+ * Aizu Chat API Client
+ *
+ * A client for interacting with the Aizu Chat API. Handles authentication,
+ * request timeouts, and error handling automatically.
+ *
+ * @example
+ * ```typescript
+ * const client = new AizuClient({
+ *   hostUrl: 'https://api.aizu.chat',
+ *   apiKey: 'your-api-key',
+ *   timeout: 30000
+ * });
+ *
+ * const response = await client.chat({
+ *   query: 'Hello, how are you?',
+ *   conversationId: 'optional-conversation-id'
+ * });
+ * ```
+ */
 declare class AizuClient {
     private hostUrl;
     private apiKey;
     private timeout;
+    /**
+     * Creates a new AizuClient instance
+     *
+     * @param config - Configuration options for the client
+     * @param config.hostUrl - The base URL of the Aizu API (e.g., 'https://api.aizu.chat')
+     * @param config.apiKey - Your API key for authentication
+     * @param config.timeout - Request timeout in milliseconds (default: 30000)
+     *
+     * @throws {Error} If hostUrl is not a non-empty string
+     * @throws {Error} If apiKey is not a non-empty string
+     *
+     * @example
+     * ```typescript
+     * const client = new AizuClient({
+     *   hostUrl: 'https://api.aizu.chat',
+     *   apiKey: 'sk_test_123456',
+     *   timeout: 60000 // 60 seconds
+     * });
+     * ```
+     */
     constructor(config: AizuClientConfig);
+    /**
+     * Internal method for making HTTP requests to the API
+     *
+     * Handles timeout management, abort signal combination, and error handling.
+     * Supports both user-initiated cancellation and automatic timeout.
+     *
+     * @template T - The expected response type
+     * @template TBody - The request body type
+     *
+     * @param path - API endpoint path (e.g., '/chat/query')
+     * @param options - Request options including body and signal
+     *
+     * @returns Promise resolving to the API response
+     *
+     * @throws {Error} "Request cancelled by user" - If the request is cancelled via AbortSignal
+     * @throws {Error} "Request timeout: The server took too long to respond" - If the request exceeds the timeout
+     * @throws {Error} "API Error: {status} {statusText}" - If the API returns an error status
+     *
+     * @private
+     */
     private request;
+    /**
+     * Sends a chat query to the Aizu API
+     *
+     * @param params - Chat request parameters
+     * @param params.query - The user's message/question (required, non-empty)
+     * @param params.conversationId - Optional conversation ID to continue an existing conversation
+     * @param options - Additional options
+     * @param options.signal - Optional AbortSignal to cancel the request
+     *
+     * @returns Promise resolving to the chat response from the API
+     *
+     * @throws {Error} "Query is required" - If query is empty or whitespace only
+     * @throws {Error} "Request cancelled by user" - If the request is cancelled
+     * @throws {Error} "Request timeout: The server took too long to respond" - If the request times out
+     * @throws {Error} "API Error: {status} {statusText}" - If the API returns an error
+     *
+     * @example
+     * ```typescript
+     * // Simple query
+     * const response = await client.chat({
+     *   query: 'What is the weather today?'
+     * });
+     * console.log(response.answer);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Continue conversation
+     * const response1 = await client.chat({
+     *   query: 'What is the weather today?'
+     * });
+     *
+     * const response2 = await client.chat({
+     *   query: 'And tomorrow?',
+     *   conversationId: response1.conversationId
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // With cancellation support
+     * const controller = new AbortController();
+     *
+     * const promise = client.chat(
+     *   { query: 'Long running query...' },
+     *   { signal: controller.signal }
+     * );
+     *
+     * // Cancel after 5 seconds
+     * setTimeout(() => controller.abort(), 5000);
+     *
+     * try {
+     *   const response = await promise;
+     * } catch (error) {
+     *   console.error('Request was cancelled:', error);
+     * }
+     * ```
+     */
     chat(params: ChatRequest, options?: {
         signal?: AbortSignal;
     }): Promise<ChatResponse>;
 }
+/**
+ * Factory function to create a new AizuClient instance
+ *
+ * This is a convenience function that wraps the AizuClient constructor.
+ * Use this when you prefer a functional approach over instantiating the class directly.
+ *
+ * @param config - Configuration options for the client
+ * @param config.hostUrl - The base URL of the Aizu API
+ * @param config.apiKey - Your API key for authentication
+ * @param config.timeout - Optional request timeout in milliseconds (default: 30000)
+ *
+ * @returns A new AizuClient instance
+ *
+ * @throws {Error} If hostUrl or apiKey are invalid
+ *
+ * @example
+ * ```typescript
+ * const client = createAizuClient({
+ *   hostUrl: process.env.AIZU_HOST_URL!,
+ *   apiKey: process.env.AIZU_API_KEY!,
+ *   timeout: 45000
+ * });
+ *
+ * const response = await client.chat({
+ *   query: 'Hello!'
+ * });
+ * ```
+ */
 declare const createAizuClient: ({ hostUrl, apiKey, timeout, }: {
     hostUrl: string;
     apiKey: string;

package/dist/index.js

@@ -1024,6 +1024,26 @@ var useChatContext = () => {
 
 // src/sdk/client.ts
 var AizuClient = class {
+  /**
+   * Creates a new AizuClient instance
+   *
+   * @param config - Configuration options for the client
+   * @param config.hostUrl - The base URL of the Aizu API (e.g., 'https://api.aizu.chat')
+   * @param config.apiKey - Your API key for authentication
+   * @param config.timeout - Request timeout in milliseconds (default: 30000)
+   *
+   * @throws {Error} If hostUrl is not a non-empty string
+   * @throws {Error} If apiKey is not a non-empty string
+   *
+   * @example
+   * ```typescript
+   * const client = new AizuClient({
+   *   hostUrl: 'https://api.aizu.chat',
+   *   apiKey: 'sk_test_123456',
+   *   timeout: 60000 // 60 seconds
+   * });
+   * ```
+   */
   constructor(config) {
     const { hostUrl, apiKey, timeout } = config;
     if (typeof hostUrl !== "string" || hostUrl.trim().length === 0) {
@@ -1040,6 +1060,26 @@ var AizuClient = class {
     this.apiKey = apiKey;
     this.timeout = timeout != null ? timeout : 3e4;
   }
+  /**
+   * Internal method for making HTTP requests to the API
+   *
+   * Handles timeout management, abort signal combination, and error handling.
+   * Supports both user-initiated cancellation and automatic timeout.
+   *
+   * @template T - The expected response type
+   * @template TBody - The request body type
+   *
+   * @param path - API endpoint path (e.g., '/chat/query')
+   * @param options - Request options including body and signal
+   *
+   * @returns Promise resolving to the API response
+   *
+   * @throws {Error} "Request cancelled by user" - If the request is cancelled via AbortSignal
+   * @throws {Error} "Request timeout: The server took too long to respond" - If the request exceeds the timeout
+   * @throws {Error} "API Error: {status} {statusText}" - If the API returns an error status
+   *
+   * @private
+   */
   request(_0) {
     return __async(this, arguments, function* (path, options = {}) {
       const url = `${this.hostUrl}${path}`;
@@ -1110,6 +1150,64 @@ var AizuClient = class {
       }
     });
   }
+  /**
+   * Sends a chat query to the Aizu API
+   *
+   * @param params - Chat request parameters
+   * @param params.query - The user's message/question (required, non-empty)
+   * @param params.conversationId - Optional conversation ID to continue an existing conversation
+   * @param options - Additional options
+   * @param options.signal - Optional AbortSignal to cancel the request
+   *
+   * @returns Promise resolving to the chat response from the API
+   *
+   * @throws {Error} "Query is required" - If query is empty or whitespace only
+   * @throws {Error} "Request cancelled by user" - If the request is cancelled
+   * @throws {Error} "Request timeout: The server took too long to respond" - If the request times out
+   * @throws {Error} "API Error: {status} {statusText}" - If the API returns an error
+   *
+   * @example
+   * ```typescript
+   * // Simple query
+   * const response = await client.chat({
+   *   query: 'What is the weather today?'
+   * });
+   * console.log(response.answer);
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // Continue conversation
+   * const response1 = await client.chat({
+   *   query: 'What is the weather today?'
+   * });
+   *
+   * const response2 = await client.chat({
+   *   query: 'And tomorrow?',
+   *   conversationId: response1.conversationId
+   * });
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // With cancellation support
+   * const controller = new AbortController();
+   *
+   * const promise = client.chat(
+   *   { query: 'Long running query...' },
+   *   { signal: controller.signal }
+   * );
+   *
+   * // Cancel after 5 seconds
+   * setTimeout(() => controller.abort(), 5000);
+   *
+   * try {
+   *   const response = await promise;
+   * } catch (error) {
+   *   console.error('Request was cancelled:', error);
+   * }
+   * ```
+   */
   chat(params, options) {
     return __async(this, null, function* () {
       if (!params.query.trim()) {

package/dist/index.mjs

@@ -997,6 +997,26 @@ var useChatContext = () => {
 
 // src/sdk/client.ts
 var AizuClient = class {
+  /**
+   * Creates a new AizuClient instance
+   *
+   * @param config - Configuration options for the client
+   * @param config.hostUrl - The base URL of the Aizu API (e.g., 'https://api.aizu.chat')
+   * @param config.apiKey - Your API key for authentication
+   * @param config.timeout - Request timeout in milliseconds (default: 30000)
+   *
+   * @throws {Error} If hostUrl is not a non-empty string
+   * @throws {Error} If apiKey is not a non-empty string
+   *
+   * @example
+   * ```typescript
+   * const client = new AizuClient({
+   *   hostUrl: 'https://api.aizu.chat',
+   *   apiKey: 'sk_test_123456',
+   *   timeout: 60000 // 60 seconds
+   * });
+   * ```
+   */
   constructor(config) {
     const { hostUrl, apiKey, timeout } = config;
     if (typeof hostUrl !== "string" || hostUrl.trim().length === 0) {
@@ -1013,6 +1033,26 @@ var AizuClient = class {
     this.apiKey = apiKey;
     this.timeout = timeout != null ? timeout : 3e4;
   }
+  /**
+   * Internal method for making HTTP requests to the API
+   *
+   * Handles timeout management, abort signal combination, and error handling.
+   * Supports both user-initiated cancellation and automatic timeout.
+   *
+   * @template T - The expected response type
+   * @template TBody - The request body type
+   *
+   * @param path - API endpoint path (e.g., '/chat/query')
+   * @param options - Request options including body and signal
+   *
+   * @returns Promise resolving to the API response
+   *
+   * @throws {Error} "Request cancelled by user" - If the request is cancelled via AbortSignal
+   * @throws {Error} "Request timeout: The server took too long to respond" - If the request exceeds the timeout
+   * @throws {Error} "API Error: {status} {statusText}" - If the API returns an error status
+   *
+   * @private
+   */
   request(_0) {
     return __async(this, arguments, function* (path, options = {}) {
       const url = `${this.hostUrl}${path}`;
@@ -1083,6 +1123,64 @@ var AizuClient = class {
       }
     });
   }
+  /**
+   * Sends a chat query to the Aizu API
+   *
+   * @param params - Chat request parameters
+   * @param params.query - The user's message/question (required, non-empty)
+   * @param params.conversationId - Optional conversation ID to continue an existing conversation
+   * @param options - Additional options
+   * @param options.signal - Optional AbortSignal to cancel the request
+   *
+   * @returns Promise resolving to the chat response from the API
+   *
+   * @throws {Error} "Query is required" - If query is empty or whitespace only
+   * @throws {Error} "Request cancelled by user" - If the request is cancelled
+   * @throws {Error} "Request timeout: The server took too long to respond" - If the request times out
+   * @throws {Error} "API Error: {status} {statusText}" - If the API returns an error
+   *
+   * @example
+   * ```typescript
+   * // Simple query
+   * const response = await client.chat({
+   *   query: 'What is the weather today?'
+   * });
+   * console.log(response.answer);
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // Continue conversation
+   * const response1 = await client.chat({
+   *   query: 'What is the weather today?'
+   * });
+   *
+   * const response2 = await client.chat({
+   *   query: 'And tomorrow?',
+   *   conversationId: response1.conversationId
+   * });
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // With cancellation support
+   * const controller = new AbortController();
+   *
+   * const promise = client.chat(
+   *   { query: 'Long running query...' },
+   *   { signal: controller.signal }
+   * );
+   *
+   * // Cancel after 5 seconds
+   * setTimeout(() => controller.abort(), 5000);
+   *
+   * try {
+   *   const response = await promise;
+   * } catch (error) {
+   *   console.error('Request was cancelled:', error);
+   * }
+   * ```
+   */
   chat(params, options) {
     return __async(this, null, function* () {
       if (!params.query.trim()) {

package/dist/sdk.d.mts

@@ -0,0 +1,55 @@
+interface AizuClientConfig {
+    hostUrl: string;
+    apiKey: string;
+    timeout?: number;
+}
+interface ChatRequest {
+    query: string;
+    thread_id?: string;
+    resource_id?: string;
+}
+interface ChatResponse {
+    thread_id: string;
+    resource_id: string;
+    response: string;
+    products?: Product[];
+    type?: TypeResponse;
+}
+interface Product {
+    product_id: string;
+    spu?: string;
+    sku: string;
+    title: string;
+    description: string;
+    handle: string;
+    price: number;
+    stock: number;
+    thumbnail?: string | null;
+    rating?: number;
+    review_count?: number;
+    estimated_delivery_days?: number;
+    similarity?: number;
+}
+declare enum TypeResponse {
+    SUGGEST_PRODUCTS = "suggest_products",
+    REQUEST_CLARIFICATION = "request_clarification",
+    START_SHOPPING = "start_shopping"
+}
+
+declare class AizuClient {
+    private hostUrl;
+    private apiKey;
+    private timeout;
+    constructor(config: AizuClientConfig);
+    private request;
+    chat(params: ChatRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<ChatResponse>;
+}
+declare const createAizuClient: ({ hostUrl, apiKey, timeout, }: {
+    hostUrl: string;
+    apiKey: string;
+    timeout?: number;
+}) => AizuClient;
+
+export { AizuClient, type AizuClientConfig, type ChatRequest, type ChatResponse, type Product, TypeResponse, createAizuClient };