@bowenqt/qiniu-ai-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,162 @@
+# Qiniu AI SDK
+
+TypeScript SDK for Qiniu Cloud AI Token API.
+
+## Features
+
+- 🚀 **Chat Completions** - OpenAI-compatible interface
+- 🖼️ **Image Generation** - Kling, Gemini models
+- 🎥 **Video Generation** - Kling, Sora, Veo models
+- 🔍 **Web Search** - Real-time web search API
+- ⏱️ **Built-in Polling** - Async task management with retry and cancellation
+- 📦 **TypeScript First** - Full type definitions included
+
+## Requirements
+
+- Node.js >= 18.0.0 (uses native `fetch`)
+
+## Installation
+
+```bash
+npm install @bowenqt/qiniu-ai-sdk
+```
+
+## Quick Start
+
+```typescript
+import { QiniuAI } from '@bowenqt/qiniu-ai-sdk';
+
+const client = new QiniuAI({
+  apiKey: 'Sk-xxxxxxxxxxxxxxxx',
+});
+
+// Chat completion
+const chat = await client.chat.create({
+  model: 'gemini-2.5-flash',
+  messages: [{ role: 'user', content: 'Hello!' }],
+});
+console.log(chat.choices[0].message.content);
+
+// Image generation (async)
+const imageTask = await client.image.create({
+  model: 'kling-v1',
+  prompt: 'A futuristic city',
+});
+const imageResult = await client.image.waitForCompletion(imageTask.task_id);
+console.log(imageResult.data?.[0].url);
+
+// Video generation (async)
+const videoTask = await client.video.create({
+  model: 'kling-video-o1',
+  prompt: 'A cat walking on the beach',
+  duration: '5',
+});
+const videoResult = await client.video.waitForCompletion(videoTask.id);
+console.log(videoResult.task_result?.videos[0].url);
+
+// Web search
+const results = await client.sys.search({
+  query: 'Latest AI news',
+  max_results: 5,
+});
+console.log(results);
+```
+
+## API Reference
+
+### Client Initialization
+
+```typescript
+const client = new QiniuAI({
+  apiKey: string;           // Required: Your Qiniu AI API key
+  baseUrl?: string;         // Optional: API base URL (default: https://api.qnaigc.com/v1)
+  timeout?: number;         // Optional: Request timeout in ms (default: 60000)
+});
+```
+
+### Modules
+
+#### `client.chat`
+
+- `create(params: ChatCompletionRequest): Promise<ChatCompletionResponse>`
+
+#### `client.image`
+
+- `create(params: ImageGenerationRequest): Promise<{ task_id: string }>`
+- `get(taskId: string): Promise<ImageTaskResponse>`
+- `waitForCompletion(taskId: string, options?: WaitOptions): Promise<ImageTaskResponse>`
+
+#### `client.video`
+
+- `create(params: VideoGenerationRequest): Promise<{ id: string }>`
+- `get(id: string): Promise<VideoTaskResponse>`
+- `waitForCompletion(id: string, options?: WaitOptions): Promise<VideoTaskResponse>`
+
+#### `client.sys`
+
+- `search(params: WebSearchRequest): Promise<WebSearchResult[]>`
+
+### Wait Options
+
+For `waitForCompletion` methods:
+
+```typescript
+interface WaitOptions {
+  intervalMs?: number;    // Polling interval (default: 2000 for image, 3000 for video)
+  timeoutMs?: number;     // Max wait time (default: 120000 for image, 600000 for video)
+  signal?: AbortSignal;   // For cancellation support
+  maxRetries?: number;    // Max retries for transient errors (default: 3)
+}
+```
+
+### Error Handling
+
+```typescript
+import { QiniuAI, APIError } from '@bowenqt/qiniu-ai-sdk';
+
+try {
+  await client.chat.create({ ... });
+} catch (error) {
+  if (error instanceof APIError) {
+    console.log(error.status);  // HTTP status code
+    console.log(error.code);    // API error code (if any)
+    console.log(error.message); // Error message
+  }
+}
+```
+
+### Cancellation
+
+```typescript
+const controller = new AbortController();
+
+// Cancel after 10 seconds
+setTimeout(() => controller.abort(), 10000);
+
+try {
+  const result = await client.image.waitForCompletion(taskId, {
+    signal: controller.signal,
+  });
+} catch (error) {
+  if (error.message === 'Operation cancelled') {
+    console.log('Task was cancelled');
+  }
+}
+```
+
+## Supported Models
+
+### Chat
+- `gemini-2.5-flash`, `gemini-pro`, `deepseek-v3`, `claude-*`, etc.
+
+### Image Generation
+- `kling-v1`, `kling-v1-5`, `kling-v2`, `kling-v2-1`
+
+### Video Generation
+- `kling-video-o1`, `kling-v2-1`, `kling-v2-5-turbo`
+
+For the full list, check [Qiniu Model Plaza](https://www.qiniu.com/ai/models).
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,29 @@
+import { IQiniuClient } from './lib/types';
+import { Chat } from './modules/chat';
+import { Image } from './modules/image';
+import { Video } from './modules/video';
+import { Tools } from './modules/tools';
+export interface QiniuAIOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+export declare class QiniuAI implements IQiniuClient {
+    chat: Chat;
+    image: Image;
+    video: Video;
+    sys: Tools;
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    constructor(options: QiniuAIOptions);
+    /**
+     * Generic POST request wrapper
+     */
+    post<T>(endpoint: string, body: any): Promise<T>;
+    /**
+     * Generic GET request wrapper
+     */
+    get<T>(endpoint: string, params?: Record<string, string>): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,OAAQ,YAAW,YAAY;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,KAAK,CAAC;IAElB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,cAAc;IAwBnC;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAYtD;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAgB9E"}

package/dist/client.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QiniuAI = void 0;
+const request_1 = require("./lib/request");
+const chat_1 = require("./modules/chat");
+const image_1 = require("./modules/image");
+const video_1 = require("./modules/video");
+const tools_1 = require("./modules/tools");
+class QiniuAI {
+    constructor(options) {
+        // Enhanced validation
+        if (!options.apiKey || typeof options.apiKey !== 'string' || !options.apiKey.trim()) {
+            throw new Error('API Key is required and must be a non-empty string');
+        }
+        this.apiKey = options.apiKey.trim();
+        // Normalize baseUrl: remove trailing slashes
+        let baseUrl = options.baseUrl || 'https://api.qnaigc.com/v1';
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.timeout = options.timeout || 60000;
+        if (this.timeout <= 0) {
+            throw new Error('Timeout must be a positive number');
+        }
+        // Initialize modules
+        this.chat = new chat_1.Chat(this);
+        this.image = new image_1.Image(this);
+        this.video = new video_1.Video(this);
+        this.sys = new tools_1.Tools(this);
+    }
+    /**
+     * Generic POST request wrapper
+     */
+    async post(endpoint, body) {
+        const url = `${this.baseUrl}${endpoint}`;
+        return (0, request_1.request)(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(body),
+            timeout: this.timeout,
+        });
+    }
+    /**
+     * Generic GET request wrapper
+     */
+    async get(endpoint, params) {
+        const url = new URL(`${this.baseUrl}${endpoint}`);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                url.searchParams.append(key, value);
+            });
+        }
+        return (0, request_1.request)(url.toString(), {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            timeout: this.timeout,
+        });
+    }
+}
+exports.QiniuAI = QiniuAI;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAExC,yCAAsC;AACtC,2CAAwC;AACxC,2CAAwC;AACxC,2CAAwC;AAQxC,MAAa,OAAO;IAUhB,YAAY,OAAuB;QAC/B,sBAAsB;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAEpC,6CAA6C;QAC7C,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,2BAA2B,CAAC;QAC7D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAE3C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;QACxC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACzD,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,WAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,aAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,aAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,IAAI,aAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAI,QAAgB,EAAE,IAAS;QACrC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC;QACzC,OAAO,IAAA,iBAAO,EAAI,GAAG,EAAE;YACnB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aAC3C;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;SACxB,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAI,QAAgB,EAAE,MAA+B;QAC1D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC,CAAC;QAClD,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBAC5C,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,IAAA,iBAAO,EAAI,GAAG,CAAC,QAAQ,EAAE,EAAE;YAC9B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACL,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aAC3C;YACD,OAAO,EAAE,IAAI,CAAC,OAAO;SACxB,CAAC,CAAC;IACP,CAAC;CACJ;AApED,0BAoEC"}

package/dist/client.mjs

@@ -0,0 +1,59 @@
+import { request } from './lib/request.mjs';
+import { Chat } from './modules/chat.mjs';
+import { Image } from './modules/image.mjs';
+import { Video } from './modules/video.mjs';
+import { Tools } from './modules/tools.mjs';
+export class QiniuAI {
+    constructor(options) {
+        // Enhanced validation
+        if (!options.apiKey || typeof options.apiKey !== 'string' || !options.apiKey.trim()) {
+            throw new Error('API Key is required and must be a non-empty string');
+        }
+        this.apiKey = options.apiKey.trim();
+        // Normalize baseUrl: remove trailing slashes
+        let baseUrl = options.baseUrl || 'https://api.qnaigc.com/v1';
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.timeout = options.timeout || 60000;
+        if (this.timeout <= 0) {
+            throw new Error('Timeout must be a positive number');
+        }
+        // Initialize modules
+        this.chat = new Chat(this);
+        this.image = new Image(this);
+        this.video = new Video(this);
+        this.sys = new Tools(this);
+    }
+    /**
+     * Generic POST request wrapper
+     */
+    async post(endpoint, body) {
+        const url = `${this.baseUrl}${endpoint}`;
+        return request(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(body),
+            timeout: this.timeout,
+        });
+    }
+    /**
+     * Generic GET request wrapper
+     */
+    async get(endpoint, params) {
+        const url = new URL(`${this.baseUrl}${endpoint}`);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                url.searchParams.append(key, value);
+            });
+        }
+        return request(url.toString(), {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            timeout: this.timeout,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { QiniuAI, QiniuAIOptions } from './client';
+export { APIError } from './lib/request';
+export * from './lib/types';
+export type { ChatCompletionRequest, ChatCompletionResponse, ChatCompletionChunk, ChatMessage, ContentPart, ToolCall } from './lib/types';
+export type { ImageGenerationRequest, ImageTaskResponse, WaitOptions as ImageWaitOptions } from './modules/image';
+export type { VideoGenerationRequest, VideoTaskResponse, WaitOptions as VideoWaitOptions } from './modules/video';
+export type { WebSearchRequest, WebSearchResult } from './modules/tools';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAGnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,cAAc,aAAa,CAAC;AAG5B,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG1I,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGlH,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGlH,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APIError = exports.QiniuAI = void 0;
+// Main client
+var client_1 = require("./client");
+Object.defineProperty(exports, "QiniuAI", { enumerable: true, get: function () { return client_1.QiniuAI; } });
+// Error types
+var request_1 = require("./lib/request");
+Object.defineProperty(exports, "APIError", { enumerable: true, get: function () { return request_1.APIError; } });
+// Shared types
+__exportStar(require("./lib/types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,cAAc;AACd,mCAAmD;AAA1C,iGAAA,OAAO,OAAA;AAEhB,cAAc;AACd,yCAAyC;AAAhC,mGAAA,QAAQ,OAAA;AAEjB,eAAe;AACf,8CAA4B"}

package/dist/index.mjs

@@ -0,0 +1,7 @@
+// Main client
+export { QiniuAI } from './client.mjs';
+// Error types
+export { APIError } from './lib/request.mjs';
+// Shared types
+export * from './lib/types.mjs';
+//# sourceMappingURL=index.js.map

package/dist/lib/request.d.ts

@@ -0,0 +1,11 @@
+interface RequestOptions extends RequestInit {
+    timeout?: number;
+}
+export declare class APIError extends Error {
+    status: number;
+    code?: string;
+    constructor(message: string, status: number, code?: string);
+}
+export declare function request<T>(url: string, options?: RequestOptions): Promise<T>;
+export {};
+//# sourceMappingURL=request.d.ts.map

package/dist/lib/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/lib/request.ts"],"names":[],"mappings":"AAAA,UAAU,cAAe,SAAQ,WAAW;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,QAAS,SAAQ,KAAK;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;gBACF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAM7D;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAgDtF"}

package/dist/lib/request.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APIError = void 0;
+exports.request = request;
+class APIError extends Error {
+    constructor(message, status, code) {
+        super(message);
+        this.name = 'APIError';
+        this.status = status;
+        this.code = code;
+    }
+}
+exports.APIError = APIError;
+async function request(url, options = {}) {
+    const { timeout = 60000, ...fetchOptions } = options;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(url, {
+            ...fetchOptions,
+            signal: controller.signal,
+            headers: {
+                'Content-Type': 'application/json',
+                ...fetchOptions.headers,
+            },
+        });
+        if (!response.ok) {
+            let errorMessage = `Request failed with status ${response.status}`;
+            let errorCode;
+            try {
+                const errorBody = await response.json();
+                // Support both OpenAI format and potential Qiniu format
+                errorMessage = errorBody.error?.message || errorBody.message || errorMessage;
+                errorCode = errorBody.error?.code || errorBody.code;
+            }
+            catch {
+                // ignore json parse error
+            }
+            throw new APIError(errorMessage, response.status, errorCode);
+        }
+        // Handle 204 No Content
+        if (response.status === 204) {
+            return {};
+        }
+        return await response.json();
+    }
+    catch (error) {
+        if (error.name === 'AbortError') {
+            throw new APIError('Request timed out', 408);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/lib/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/lib/request.ts"],"names":[],"mappings":";;;AAeA,0BAgDC;AA3DD,MAAa,QAAS,SAAQ,KAAK;IAG/B,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACJ;AATD,4BASC;AAEM,KAAK,UAAU,OAAO,CAAI,GAAW,EAAE,UAA0B,EAAE;IACtE,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IAErD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAEhE,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC9B,GAAG,YAAY;YACf,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;gBAClC,GAAG,YAAY,CAAC,OAAO;aAC1B;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,YAAY,GAAG,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CAAC;YACnE,IAAI,SAA6B,CAAC;YAClC,IAAI,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAIpC,CAAC;gBACF,wDAAwD;gBACxD,YAAY,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,IAAI,SAAS,CAAC,OAAO,IAAI,YAAY,CAAC;gBAC7E,SAAS,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACL,0BAA0B;YAC9B,CAAC;YACD,MAAM,IAAI,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACjE,CAAC;QAED,wBAAwB;QACxB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC1B,OAAO,EAAO,CAAC;QACnB,CAAC;QAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAO,CAAC;IACtC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC9B,MAAM,IAAI,QAAQ,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,KAAK,CAAC;IAChB,CAAC;YAAS,CAAC;QACP,YAAY,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;AACL,CAAC"}

package/dist/lib/request.mjs

@@ -0,0 +1,52 @@
+export class APIError extends Error {
+    constructor(message, status, code) {
+        super(message);
+        this.name = 'APIError';
+        this.status = status;
+        this.code = code;
+    }
+}
+export async function request(url, options = {}) {
+    const { timeout = 60000, ...fetchOptions } = options;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(url, {
+            ...fetchOptions,
+            signal: controller.signal,
+            headers: {
+                'Content-Type': 'application/json',
+                ...fetchOptions.headers,
+            },
+        });
+        if (!response.ok) {
+            let errorMessage = `Request failed with status ${response.status}`;
+            let errorCode;
+            try {
+                const errorBody = await response.json();
+                // Support both OpenAI format and potential Qiniu format
+                errorMessage = errorBody.error?.message || errorBody.message || errorMessage;
+                errorCode = errorBody.error?.code || errorBody.code;
+            }
+            catch {
+                // ignore json parse error
+            }
+            throw new APIError(errorMessage, response.status, errorCode);
+        }
+        // Handle 204 No Content
+        if (response.status === 204) {
+            return {};
+        }
+        return await response.json();
+    }
+    catch (error) {
+        if (error.name === 'AbortError') {
+            throw new APIError('Request timed out', 408);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/lib/types.d.ts

@@ -0,0 +1,82 @@
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | ContentPart[];
+    name?: string;
+    tool_calls?: ToolCall[];
+}
+export interface ContentPart {
+    type: 'text' | 'image_url';
+    text?: string;
+    image_url?: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+}
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ChatCompletionRequest {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    top_p?: number;
+    n?: number;
+    stream?: boolean;
+    stop?: string | string[];
+    max_tokens?: number;
+    presence_penalty?: number;
+    frequency_penalty?: number;
+    logit_bias?: Record<string, number>;
+    user?: string;
+    tools?: {
+        type: 'function';
+        function: {
+            name: string;
+            description?: string;
+            parameters: Record<string, any>;
+        };
+    }[];
+    tool_choice?: 'none' | 'auto' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+}
+export interface ChatCompletionResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        message: ChatMessage;
+        finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
+    }[];
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface ChatCompletionChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        delta: Partial<ChatMessage>;
+        finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
+    }[];
+}
+export interface IQiniuClient {
+    post<T>(endpoint: string, body: any): Promise<T>;
+    get<T>(endpoint: string, params?: Record<string, string>): Promise<T>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Basic OpenAI-compatible types for Chat Completions
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":";AAAA,qDAAqD"}

package/dist/lib/types.mjs

@@ -0,0 +1,3 @@
+// Basic OpenAI-compatible types for Chat Completions
+export {};
+//# sourceMappingURL=types.js.map

package/dist/modules/chat/index.d.ts

@@ -0,0 +1,11 @@
+import { IQiniuClient, ChatCompletionRequest, ChatCompletionResponse } from '../../lib/types';
+export declare class Chat {
+    private client;
+    constructor(client: IQiniuClient);
+    /**
+     * Create a chat completion (non-streaming only)
+     * @throws Error if stream: true is passed (streaming not yet implemented)
+     */
+    create(params: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAuB,MAAM,iBAAiB,CAAC;AAEnH,qBAAa,IAAI;IACb,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAIhC;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAa/E"}

package/dist/modules/chat/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Chat = void 0;
+class Chat {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a chat completion (non-streaming only)
+     * @throws Error if stream: true is passed (streaming not yet implemented)
+     */
+    async create(params) {
+        if (params.stream) {
+            throw new Error('Streaming is not yet supported in this SDK. ' +
+                'Please set stream: false or omit it. ' +
+                'For streaming, use the raw HTTP endpoint directly.');
+        }
+        return this.client.post('/chat/completions', params);
+    }
+}
+exports.Chat = Chat;
+//# sourceMappingURL=index.js.map

package/dist/modules/chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/chat/index.ts"],"names":[],"mappings":";;;AAEA,MAAa,IAAI;IAGb,YAAY,MAAoB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,MAA6B;QACtC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACX,8CAA8C;gBAC9C,uCAAuC;gBACvC,oDAAoD,CACvD,CAAC;QACN,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAyB,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACjF,CAAC;CAIJ;AAxBD,oBAwBC"}

package/dist/modules/chat/index.mjs

@@ -0,0 +1,18 @@
+export class Chat {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a chat completion (non-streaming only)
+     * @throws Error if stream: true is passed (streaming not yet implemented)
+     */
+    async create(params) {
+        if (params.stream) {
+            throw new Error('Streaming is not yet supported in this SDK. ' +
+                'Please set stream: false or omit it. ' +
+                'For streaming, use the raw HTTP endpoint directly.');
+        }
+        return this.client.post('/chat/completions', params);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/image/index.d.ts

@@ -0,0 +1,51 @@
+import { IQiniuClient } from '../../lib/types';
+export interface ImageGenerationRequest {
+    model: string;
+    prompt: string;
+    negative_prompt?: string;
+    aspect_ratio?: '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '3:2' | '2:3' | '21:9';
+    n?: number;
+    image?: string;
+    image_url?: string;
+    strength?: number;
+}
+export interface ImageTaskResponse {
+    task_id: string;
+    created?: number;
+    status?: string;
+    status_message?: string;
+    data?: {
+        index: number;
+        url: string;
+    }[];
+    error?: {
+        code: string;
+        message: string;
+    };
+    quantity?: number;
+}
+export interface WaitOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    maxRetries?: number;
+}
+export declare class Image {
+    private client;
+    constructor(client: IQiniuClient);
+    /**
+     * Create an image generation task
+     */
+    create(params: ImageGenerationRequest): Promise<{
+        task_id: string;
+    }>;
+    /**
+     * Get image generation task status
+     */
+    get(taskId: string): Promise<ImageTaskResponse>;
+    /**
+     * Poll for completion with retry and cancellation support
+     */
+    waitForCompletion(taskId: string, options?: WaitOptions): Promise<ImageTaskResponse>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/image/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/image/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAChF,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE;QACH,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,KAAK,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,qBAAa,KAAK;IACd,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAIhC;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAI1E;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIrD;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA0DjG"}

package/dist/modules/image/index.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Image = void 0;
+const TERMINAL_STATUSES = ['succeed', 'failed'];
+class Image {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create an image generation task
+     */
+    async create(params) {
+        return this.client.post('/images/generations', params);
+    }
+    /**
+     * Get image generation task status
+     */
+    async get(taskId) {
+        return this.client.get(`/images/tasks/${taskId}`);
+    }
+    /**
+     * Poll for completion with retry and cancellation support
+     */
+    async waitForCompletion(taskId, options = {}) {
+        const { intervalMs = 2000, timeoutMs = 120000, signal, maxRetries = 3, } = options;
+        if (intervalMs <= 0 || timeoutMs <= 0) {
+            throw new Error('intervalMs and timeoutMs must be positive numbers');
+        }
+        const start = Date.now();
+        let consecutiveErrors = 0;
+        while (Date.now() - start < timeoutMs) {
+            // Check for cancellation
+            if (signal?.aborted) {
+                throw new Error('Operation cancelled');
+            }
+            try {
+                const result = await this.get(taskId);
+                consecutiveErrors = 0; // Reset on success
+                // Check for terminal status
+                if (result.status && TERMINAL_STATUSES.includes(result.status)) {
+                    return result;
+                }
+                // Warn if status is unexpected (but continue polling)
+                if (result.status && !['processing', ...TERMINAL_STATUSES].includes(result.status)) {
+                    console.warn(`[QiniuAI] Unexpected image task status: ${result.status}`);
+                }
+            }
+            catch (error) {
+                consecutiveErrors++;
+                if (consecutiveErrors >= maxRetries) {
+                    throw new Error(`Failed to get task status after ${maxRetries} retries: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                console.warn(`[QiniuAI] Transient error polling image task (retry ${consecutiveErrors}/${maxRetries}): ${error}`);
+            }
+            // Wait before next poll
+            await new Promise((resolve, reject) => {
+                const timeoutHandle = setTimeout(resolve, intervalMs);
+                if (signal) {
+                    signal.addEventListener('abort', () => {
+                        clearTimeout(timeoutHandle);
+                        reject(new Error('Operation cancelled'));
+                    }, { once: true });
+                }
+            });
+        }
+        throw new Error(`Timeout waiting for image generation after ${timeoutMs}ms`);
+    }
+}
+exports.Image = Image;
+//# sourceMappingURL=index.js.map

package/dist/modules/image/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/image/index.ts"],"names":[],"mappings":"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"}

package/dist/modules/image/index.mjs

@@ -0,0 +1,66 @@
+const TERMINAL_STATUSES = ['succeed', 'failed'];
+export class Image {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create an image generation task
+     */
+    async create(params) {
+        return this.client.post('/images/generations', params);
+    }
+    /**
+     * Get image generation task status
+     */
+    async get(taskId) {
+        return this.client.get(`/images/tasks/${taskId}`);
+    }
+    /**
+     * Poll for completion with retry and cancellation support
+     */
+    async waitForCompletion(taskId, options = {}) {
+        const { intervalMs = 2000, timeoutMs = 120000, signal, maxRetries = 3, } = options;
+        if (intervalMs <= 0 || timeoutMs <= 0) {
+            throw new Error('intervalMs and timeoutMs must be positive numbers');
+        }
+        const start = Date.now();
+        let consecutiveErrors = 0;
+        while (Date.now() - start < timeoutMs) {
+            // Check for cancellation
+            if (signal?.aborted) {
+                throw new Error('Operation cancelled');
+            }
+            try {
+                const result = await this.get(taskId);
+                consecutiveErrors = 0; // Reset on success
+                // Check for terminal status
+                if (result.status && TERMINAL_STATUSES.includes(result.status)) {
+                    return result;
+                }
+                // Warn if status is unexpected (but continue polling)
+                if (result.status && !['processing', ...TERMINAL_STATUSES].includes(result.status)) {
+                    console.warn(`[QiniuAI] Unexpected image task status: ${result.status}`);
+                }
+            }
+            catch (error) {
+                consecutiveErrors++;
+                if (consecutiveErrors >= maxRetries) {
+                    throw new Error(`Failed to get task status after ${maxRetries} retries: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                console.warn(`[QiniuAI] Transient error polling image task (retry ${consecutiveErrors}/${maxRetries}): ${error}`);
+            }
+            // Wait before next poll
+            await new Promise((resolve, reject) => {
+                const timeoutHandle = setTimeout(resolve, intervalMs);
+                if (signal) {
+                    signal.addEventListener('abort', () => {
+                        clearTimeout(timeoutHandle);
+                        reject(new Error('Operation cancelled'));
+                    }, { once: true });
+                }
+            });
+        }
+        throw new Error(`Timeout waiting for image generation after ${timeoutMs}ms`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/tools/index.d.ts

@@ -0,0 +1,28 @@
+import { IQiniuClient } from '../../lib/types';
+export interface WebSearchRequest {
+    query: string;
+    max_results?: number;
+    search_type?: 'web' | 'news';
+    time_filter?: 'day' | 'week' | 'month' | 'year';
+    site_filter?: string[];
+}
+export interface WebSearchResult {
+    title: string;
+    link: string;
+    snippet: string;
+    source?: string;
+}
+export interface WebSearchResponse {
+    results?: WebSearchResult[];
+    [index: number]: WebSearchResult;
+}
+export declare class Tools {
+    private client;
+    constructor(client: IQiniuClient);
+    /**
+     * Perform a web search
+     * @returns Array of search results
+     */
+    search(params: WebSearchRequest): Promise<WebSearchResult[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAE5B,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC;CACpC;AAED,qBAAa,KAAK;IACd,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAIhC;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAoBrE"}

package/dist/modules/tools/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tools = void 0;
+class Tools {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Perform a web search
+     * @returns Array of search results
+     */
+    async search(params) {
+        if (!params.query || !params.query.trim()) {
+            throw new Error('Search query is required and must be a non-empty string');
+        }
+        // Call API and handle potential response formats
+        const response = await this.client.post('/search/web', params);
+        // Normalize response: handle both array and wrapper formats
+        if (Array.isArray(response)) {
+            return response;
+        }
+        if (response && 'results' in response && Array.isArray(response.results)) {
+            return response.results;
+        }
+        // If neither, return empty array with warning
+        console.warn('[QiniuAI] Unexpected search response format:', response);
+        return [];
+    }
+}
+exports.Tools = Tools;
+//# sourceMappingURL=index.js.map

package/dist/modules/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/tools/index.ts"],"names":[],"mappings":";;;AAwBA,MAAa,KAAK;IAGd,YAAY,MAAoB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,MAAwB;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC/E,CAAC;QAED,iDAAiD;QACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAqD,aAAa,EAAE,MAAM,CAAC,CAAC;QAEnH,4DAA4D;QAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC;QACpB,CAAC;QACD,IAAI,QAAQ,IAAI,SAAS,IAAI,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACvE,OAAO,QAAQ,CAAC,OAAO,CAAC;QAC5B,CAAC;QAED,8CAA8C;QAC9C,OAAO,CAAC,IAAI,CAAC,8CAA8C,EAAE,QAAQ,CAAC,CAAC;QACvE,OAAO,EAAE,CAAC;IACd,CAAC;CACJ;AA/BD,sBA+BC"}

package/dist/modules/tools/index.mjs

@@ -0,0 +1,27 @@
+export class Tools {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Perform a web search
+     * @returns Array of search results
+     */
+    async search(params) {
+        if (!params.query || !params.query.trim()) {
+            throw new Error('Search query is required and must be a non-empty string');
+        }
+        // Call API and handle potential response formats
+        const response = await this.client.post('/search/web', params);
+        // Normalize response: handle both array and wrapper formats
+        if (Array.isArray(response)) {
+            return response;
+        }
+        if (response && 'results' in response && Array.isArray(response.results)) {
+            return response.results;
+        }
+        // If neither, return empty array with warning
+        console.warn('[QiniuAI] Unexpected search response format:', response);
+        return [];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/video/index.d.ts

@@ -0,0 +1,60 @@
+import { IQiniuClient } from '../../lib/types';
+export interface VideoGenerationRequest {
+    model: string;
+    prompt: string;
+    image?: string;
+    image_url?: string;
+    duration?: '5' | '10';
+    aspect_ratio?: '16:9' | '1:1' | '9:16';
+    mode?: 'std' | 'pro';
+    negative_prompt?: string;
+    cfg_scale?: number;
+}
+export interface VideoTaskResponse {
+    id: string;
+    object?: 'video';
+    model?: string;
+    status: string;
+    created_at?: number;
+    updated_at?: number;
+    completed_at?: number;
+    seconds?: string;
+    size?: string;
+    mode?: 'std' | 'pro';
+    task_result?: {
+        videos: {
+            id: string;
+            url: string;
+            duration: string;
+        }[];
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface WaitOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    maxRetries?: number;
+}
+export declare class Video {
+    private client;
+    constructor(client: IQiniuClient);
+    /**
+     * Create a video generation task
+     */
+    create(params: VideoGenerationRequest): Promise<{
+        id: string;
+    }>;
+    /**
+     * Get video generation task status
+     */
+    get(id: string): Promise<VideoTaskResponse>;
+    /**
+     * Poll for completion with retry and cancellation support
+     */
+    waitForCompletion(id: string, options?: WaitOptions): Promise<VideoTaskResponse>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/video/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/video/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACvC,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACrB,WAAW,CAAC,EAAE;QACV,MAAM,EAAE;YACJ,EAAE,EAAE,MAAM,CAAC;YACX,GAAG,EAAE,MAAM,CAAC;YACZ,QAAQ,EAAE,MAAM,CAAC;SACpB,EAAE,CAAC;KACP,CAAC;IACF,KAAK,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;CACL;AAED,MAAM,WAAW,WAAW;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,qBAAa,KAAK;IACd,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAIhC;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAIrE;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIjD;;OAEG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAsD7F"}

package/dist/modules/video/index.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Video = void 0;
+const TERMINAL_STATUSES = ['completed', 'failed'];
+class Video {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a video generation task
+     */
+    async create(params) {
+        return this.client.post('/videos', params);
+    }
+    /**
+     * Get video generation task status
+     */
+    async get(id) {
+        return this.client.get(`/videos/${id}`);
+    }
+    /**
+     * Poll for completion with retry and cancellation support
+     */
+    async waitForCompletion(id, options = {}) {
+        const { intervalMs = 3000, timeoutMs = 600000, // 10 minutes default for video (longer than image)
+        signal, maxRetries = 3, } = options;
+        if (intervalMs <= 0 || timeoutMs <= 0) {
+            throw new Error('intervalMs and timeoutMs must be positive numbers');
+        }
+        const start = Date.now();
+        let consecutiveErrors = 0;
+        while (Date.now() - start < timeoutMs) {
+            if (signal?.aborted) {
+                throw new Error('Operation cancelled');
+            }
+            try {
+                const result = await this.get(id);
+                consecutiveErrors = 0;
+                if (result.status && TERMINAL_STATUSES.includes(result.status)) {
+                    return result;
+                }
+                if (result.status && !['in_progress', 'pending', 'queued', ...TERMINAL_STATUSES].includes(result.status)) {
+                    console.warn(`[QiniuAI] Unexpected video task status: ${result.status}`);
+                }
+            }
+            catch (error) {
+                consecutiveErrors++;
+                if (consecutiveErrors >= maxRetries) {
+                    throw new Error(`Failed to get task status after ${maxRetries} retries: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                console.warn(`[QiniuAI] Transient error polling video task (retry ${consecutiveErrors}/${maxRetries}): ${error}`);
+            }
+            await new Promise((resolve, reject) => {
+                const timeoutHandle = setTimeout(resolve, intervalMs);
+                if (signal) {
+                    signal.addEventListener('abort', () => {
+                        clearTimeout(timeoutHandle);
+                        reject(new Error('Operation cancelled'));
+                    }, { once: true });
+                }
+            });
+        }
+        throw new Error(`Timeout waiting for video generation after ${timeoutMs}ms`);
+    }
+}
+exports.Video = Video;
+//# sourceMappingURL=index.js.map

package/dist/modules/video/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/video/index.ts"],"names":[],"mappings":"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"}

package/dist/modules/video/index.mjs

@@ -0,0 +1,63 @@
+const TERMINAL_STATUSES = ['completed', 'failed'];
+export class Video {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a video generation task
+     */
+    async create(params) {
+        return this.client.post('/videos', params);
+    }
+    /**
+     * Get video generation task status
+     */
+    async get(id) {
+        return this.client.get(`/videos/${id}`);
+    }
+    /**
+     * Poll for completion with retry and cancellation support
+     */
+    async waitForCompletion(id, options = {}) {
+        const { intervalMs = 3000, timeoutMs = 600000, // 10 minutes default for video (longer than image)
+        signal, maxRetries = 3, } = options;
+        if (intervalMs <= 0 || timeoutMs <= 0) {
+            throw new Error('intervalMs and timeoutMs must be positive numbers');
+        }
+        const start = Date.now();
+        let consecutiveErrors = 0;
+        while (Date.now() - start < timeoutMs) {
+            if (signal?.aborted) {
+                throw new Error('Operation cancelled');
+            }
+            try {
+                const result = await this.get(id);
+                consecutiveErrors = 0;
+                if (result.status && TERMINAL_STATUSES.includes(result.status)) {
+                    return result;
+                }
+                if (result.status && !['in_progress', 'pending', 'queued', ...TERMINAL_STATUSES].includes(result.status)) {
+                    console.warn(`[QiniuAI] Unexpected video task status: ${result.status}`);
+                }
+            }
+            catch (error) {
+                consecutiveErrors++;
+                if (consecutiveErrors >= maxRetries) {
+                    throw new Error(`Failed to get task status after ${maxRetries} retries: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                console.warn(`[QiniuAI] Transient error polling video task (retry ${consecutiveErrors}/${maxRetries}): ${error}`);
+            }
+            await new Promise((resolve, reject) => {
+                const timeoutHandle = setTimeout(resolve, intervalMs);
+                if (signal) {
+                    signal.addEventListener('abort', () => {
+                        clearTimeout(timeoutHandle);
+                        reject(new Error('Operation cancelled'));
+                    }, { once: true });
+                }
+            });
+        }
+        throw new Error(`Timeout waiting for video generation after ${timeoutMs}ms`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@bowenqt/qiniu-ai-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Qiniu Cloud AI Token API - Chat, Image, Video generation and more",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build:cjs && npm run build:esm",
+    "build:cjs": "tsc -p tsconfig.json",
+    "build:esm": "tsc -p tsconfig.esm.json && node scripts/fix-esm.js",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "keywords": [
+    "qiniu",
+    "ai",
+    "llm",
+    "openai",
+    "chat",
+    "image-generation",
+    "video-generation",
+    "sdk",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bowenQT/qiniu-ai-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bowenQT/qiniu-ai-sdk/issues"
+  },
+  "homepage": "https://github.com/bowenQT/qiniu-ai-sdk#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}