@bowenqt/qiniu-ai-sdk 0.1.0 → 0.2.0

package/README.md

@@ -67,10 +67,114 @@ console.log(results);
 ### Client Initialization
 
 ```typescript
+import { QiniuAI, consoleLogger } from '@bowenqt/qiniu-ai-sdk';
+
 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)
+  logger?: Logger;          // Optional: Custom logger (use consoleLogger for debug output)
+  logLevel?: LogLevel;      // Optional: 'debug' | 'info' | 'warn' | 'error' | 'silent' (default: 'info')
+});
+```
+
+### Logging
+
+Enable debug logging to see request/response details:
+
+```typescript
+import { QiniuAI, consoleLogger } from '@bowenqt/qiniu-ai-sdk';
+
+const client = new QiniuAI({
+  apiKey: 'Sk-xxx',
+  logger: consoleLogger,
+  logLevel: 'debug',
+});
+
+// Now you'll see logs like:
+// [QiniuAI:DEBUG] HTTP Request { requestId: 'req_123...', method: 'POST', url: '...', timeout: 60000 }
+// [QiniuAI:DEBUG] HTTP Response { requestId: 'req_123...', status: 200, duration: 1234 }
+```
+
+Use a custom logger (e.g., pino, winston):
+
+```typescript
+import { QiniuAI, Logger } from '@bowenqt/qiniu-ai-sdk';
+import pino from 'pino';
+
+const pinoLogger = pino();
+
+const customLogger: Logger = {
+  debug: (msg, meta) => pinoLogger.debug(meta, msg),
+  info: (msg, meta) => pinoLogger.info(meta, msg),
+  warn: (msg, meta) => pinoLogger.warn(meta, msg),
+  error: (msg, meta) => pinoLogger.error(meta, msg),
+};
+
+const client = new QiniuAI({
+  apiKey: 'Sk-xxx',
+  logger: customLogger,
+});
+```
+
+### Middleware
+
+Use middleware to intercept and modify requests/responses:
+
+```typescript
+import { QiniuAI, Middleware, retryMiddleware, headersMiddleware } from '@bowenqt/qiniu-ai-sdk';
+
+// Built-in retry middleware (retries on 5xx errors)
+const retry = retryMiddleware({ maxRetries: 3, retryDelay: 1000 });
+
+// Built-in headers middleware (adds custom headers)
+const customHeaders = headersMiddleware({
+  'X-Custom-Header': 'my-value',
+});
+
+// Custom middleware
+const loggingMiddleware: Middleware = async (request, next) => {
+  console.log('Request:', request.method, request.url);
+  const response = await next(request);
+  console.log('Response:', response.status, response.duration + 'ms');
+  return response;
+};
+
+const client = new QiniuAI({
+  apiKey: 'Sk-xxx',
+  middleware: [retry, customHeaders, loggingMiddleware],
+});
+```
+
+### Custom HTTP Adapter
+
+Replace the default `fetch` with a custom HTTP client:
+
+```typescript
+import { QiniuAI, FetchAdapter } from '@bowenqt/qiniu-ai-sdk';
+import axios from 'axios';
+
+const axiosAdapter: FetchAdapter = {
+  async fetch(url, init) {
+    const response = await axios({
+      url,
+      method: init.method as any,
+      headers: init.headers as Record<string, string>,
+      data: init.body,
+      signal: init.signal,
+      validateStatus: () => true, // Don't throw on non-2xx
+    });
+    
+    return new Response(JSON.stringify(response.data), {
+      status: response.status,
+      headers: response.headers as any,
+    });
+  },
+};
+
+const client = new QiniuAI({
+  apiKey: 'Sk-xxx',
+  adapter: axiosAdapter,
 });
 ```
 

package/dist/client.d.ts

@@ -1,4 +1,7 @@
+import { RequestOptions } from './lib/request';
 import { IQiniuClient } from './lib/types';
+import { Logger, noopLogger, consoleLogger, LogLevel, createFilteredLogger } from './lib/logger';
+import { FetchAdapter, defaultFetchAdapter, Middleware, composeMiddleware, retryMiddleware, headersMiddleware, timingMiddleware } from './lib/middleware';
 import { Chat } from './modules/chat';
 import { Image } from './modules/image';
 import { Video } from './modules/video';
@@ -7,6 +10,26 @@ export interface QiniuAIOptions {
     apiKey: string;
     baseUrl?: string;
     timeout?: number;
+    /**
+     * Custom logger instance. Use `consoleLogger` for debug output.
+     * Default: silent (no logging)
+     */
+    logger?: Logger;
+    /**
+     * Log level filter. Only applies if using a logger.
+     * Default: 'info'
+     */
+    logLevel?: LogLevel;
+    /**
+     * Custom HTTP adapter. Allows replacing fetch with axios, got, etc.
+     * Default: native fetch
+     */
+    adapter?: FetchAdapter;
+    /**
+     * Middleware functions to process requests/responses.
+     * Executed in order, wrapping the core request.
+     */
+    middleware?: Middleware[];
 }
 export declare class QiniuAI implements IQiniuClient {
     chat: Chat;
@@ -16,14 +39,25 @@ export declare class QiniuAI implements IQiniuClient {
     private apiKey;
     private baseUrl;
     private timeout;
+    private logger;
+    private requestContext;
     constructor(options: QiniuAIOptions);
     /**
-     * Generic POST request wrapper
+     * Get the logger instance (for modules to use)
+     */
+    getLogger(): Logger;
+    /**
+     * Generic POST request wrapper with optional per-request options
      */
-    post<T>(endpoint: string, body: any): Promise<T>;
+    post<T>(endpoint: string, body: unknown, requestId?: string, options?: RequestOptions): Promise<T>;
     /**
-     * Generic GET request wrapper
+     * Generic GET request wrapper with optional per-request options
      */
-    get<T>(endpoint: string, params?: Record<string, string>): Promise<T>;
+    get<T>(endpoint: string, params?: Record<string, string>, requestId?: string, options?: RequestOptions): Promise<T>;
 }
+export { consoleLogger, noopLogger, createFilteredLogger };
+export type { Logger, LogLevel };
+export { defaultFetchAdapter, composeMiddleware, retryMiddleware, headersMiddleware, timingMiddleware };
+export type { FetchAdapter, Middleware, MiddlewareRequest, MiddlewareResponse } from './lib/middleware';
+export type { RequestOptions } from './lib/request';
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,cAAc,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EACH,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACnB,MAAM,kBAAkB,CAAC;AAC1B,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;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;CAC7B;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;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAiB;gBAE3B,OAAO,EAAE,cAAc;IAoDnC;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAWxG;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;CAgB5H;AAGD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC;AAC3D,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAGjC,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACnB,CAAC;AACF,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxG,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/client.js

@@ -1,7 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QiniuAI = void 0;
+exports.timingMiddleware = exports.headersMiddleware = exports.retryMiddleware = exports.composeMiddleware = exports.defaultFetchAdapter = exports.createFilteredLogger = exports.noopLogger = exports.consoleLogger = exports.QiniuAI = void 0;
 const request_1 = require("./lib/request");
+const logger_1 = require("./lib/logger");
+Object.defineProperty(exports, "noopLogger", { enumerable: true, get: function () { return logger_1.noopLogger; } });
+Object.defineProperty(exports, "consoleLogger", { enumerable: true, get: function () { return logger_1.consoleLogger; } });
+Object.defineProperty(exports, "createFilteredLogger", { enumerable: true, get: function () { return logger_1.createFilteredLogger; } });
+const middleware_1 = require("./lib/middleware");
+Object.defineProperty(exports, "defaultFetchAdapter", { enumerable: true, get: function () { return middleware_1.defaultFetchAdapter; } });
+Object.defineProperty(exports, "composeMiddleware", { enumerable: true, get: function () { return middleware_1.composeMiddleware; } });
+Object.defineProperty(exports, "retryMiddleware", { enumerable: true, get: function () { return middleware_1.retryMiddleware; } });
+Object.defineProperty(exports, "headersMiddleware", { enumerable: true, get: function () { return middleware_1.headersMiddleware; } });
+Object.defineProperty(exports, "timingMiddleware", { enumerable: true, get: function () { return middleware_1.timingMiddleware; } });
 const chat_1 = require("./modules/chat");
 const image_1 = require("./modules/image");
 const video_1 = require("./modules/video");
@@ -20,6 +30,30 @@ class QiniuAI {
         if (this.timeout <= 0) {
             throw new Error('Timeout must be a positive number');
         }
+        // Setup logger with level filtering
+        const baseLogger = options.logger || logger_1.noopLogger;
+        const logLevel = options.logLevel || 'info';
+        this.logger = (0, logger_1.createFilteredLogger)(baseLogger, logLevel);
+        // Setup request context
+        const adapter = options.adapter || middleware_1.defaultFetchAdapter;
+        const middleware = options.middleware?.length
+            ? (0, middleware_1.composeMiddleware)(options.middleware)
+            : undefined;
+        this.requestContext = {
+            logger: this.logger,
+            adapter,
+            middleware,
+            baseHeaders: {
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            defaultTimeout: this.timeout,
+        };
+        this.logger.info('QiniuAI client initialized', {
+            baseUrl: this.baseUrl,
+            timeout: this.timeout,
+            hasMiddleware: !!middleware,
+            hasCustomAdapter: !!options.adapter,
+        });
         // Initialize modules
         this.chat = new chat_1.Chat(this);
         this.image = new image_1.Image(this);
@@ -27,36 +61,29 @@ class QiniuAI {
         this.sys = new tools_1.Tools(this);
     }
     /**
-     * Generic POST request wrapper
+     * Get the logger instance (for modules to use)
      */
-    async post(endpoint, body) {
+    getLogger() {
+        return this.logger;
+    }
+    /**
+     * Generic POST request wrapper with optional per-request options
+     */
+    async post(endpoint, body, requestId, options) {
         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,
-        });
+        return (0, request_1.request)(url, 'POST', body, this.requestContext, { ...options, requestId });
     }
     /**
-     * Generic GET request wrapper
+     * Generic GET request wrapper with optional per-request options
      */
-    async get(endpoint, params) {
+    async get(endpoint, params, requestId, options) {
         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,
-        });
+        return (0, request_1.request)(url.toString(), 'GET', undefined, this.requestContext, { ...options, requestId });
     }
 }
 exports.QiniuAI = QiniuAI;

package/dist/client.js.map

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

package/dist/client.mjs

@@ -1,4 +1,6 @@
 import { request } from './lib/request.mjs';
+import { noopLogger, consoleLogger, createFilteredLogger } from './lib/logger.mjs';
+import { defaultFetchAdapter, composeMiddleware, retryMiddleware, headersMiddleware, timingMiddleware, } from './lib/middleware.mjs';
 import { Chat } from './modules/chat.mjs';
 import { Image } from './modules/image.mjs';
 import { Video } from './modules/video.mjs';
@@ -17,6 +19,30 @@ export class QiniuAI {
         if (this.timeout <= 0) {
             throw new Error('Timeout must be a positive number');
         }
+        // Setup logger with level filtering
+        const baseLogger = options.logger || noopLogger;
+        const logLevel = options.logLevel || 'info';
+        this.logger = createFilteredLogger(baseLogger, logLevel);
+        // Setup request context
+        const adapter = options.adapter || defaultFetchAdapter;
+        const middleware = options.middleware?.length
+            ? composeMiddleware(options.middleware)
+            : undefined;
+        this.requestContext = {
+            logger: this.logger,
+            adapter,
+            middleware,
+            baseHeaders: {
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            defaultTimeout: this.timeout,
+        };
+        this.logger.info('QiniuAI client initialized', {
+            baseUrl: this.baseUrl,
+            timeout: this.timeout,
+            hasMiddleware: !!middleware,
+            hasCustomAdapter: !!options.adapter,
+        });
         // Initialize modules
         this.chat = new Chat(this);
         this.image = new Image(this);
@@ -24,36 +50,33 @@ export class QiniuAI {
         this.sys = new Tools(this);
     }
     /**
-     * Generic POST request wrapper
+     * Get the logger instance (for modules to use)
      */
-    async post(endpoint, body) {
+    getLogger() {
+        return this.logger;
+    }
+    /**
+     * Generic POST request wrapper with optional per-request options
+     */
+    async post(endpoint, body, requestId, options) {
         const url = `${this.baseUrl}${endpoint}`;
-        return request(url, {
-            method: 'POST',
-            headers: {
-                'Authorization': `Bearer ${this.apiKey}`,
-            },
-            body: JSON.stringify(body),
-            timeout: this.timeout,
-        });
+        return request(url, 'POST', body, this.requestContext, { ...options, requestId });
     }
     /**
-     * Generic GET request wrapper
+     * Generic GET request wrapper with optional per-request options
      */
-    async get(endpoint, params) {
+    async get(endpoint, params, requestId, options) {
         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,
-        });
+        return request(url.toString(), 'GET', undefined, this.requestContext, { ...options, requestId });
     }
 }
+// Re-export logger utilities
+export { consoleLogger, noopLogger, createFilteredLogger };
+// Re-export middleware utilities
+export { defaultFetchAdapter, composeMiddleware, retryMiddleware, headersMiddleware, timingMiddleware };
 //# sourceMappingURL=client.js.map

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { QiniuAI, QiniuAIOptions } from './client';
+export { QiniuAI, consoleLogger, noopLogger, createFilteredLogger, defaultFetchAdapter, composeMiddleware, retryMiddleware, headersMiddleware, timingMiddleware, } from './client';
+export type { QiniuAIOptions, Logger, LogLevel, FetchAdapter, Middleware, MiddlewareRequest, MiddlewareResponse, RequestOptions, } from './client';
 export { APIError } from './lib/request';
 export * from './lib/types';
 export type { ChatCompletionRequest, ChatCompletionResponse, ChatCompletionChunk, ChatMessage, ContentPart, ToolCall } from './lib/types';

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,OAAO,EACP,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GACnB,MAAM,UAAU,CAAC;AAElB,YAAY,EACR,cAAc,EACd,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACjB,MAAM,UAAU,CAAC;AAGlB,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

@@ -14,10 +14,18 @@ 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;
+exports.APIError = exports.timingMiddleware = exports.headersMiddleware = exports.retryMiddleware = exports.composeMiddleware = exports.defaultFetchAdapter = exports.createFilteredLogger = exports.noopLogger = exports.consoleLogger = exports.QiniuAI = void 0;
 // Main client
 var client_1 = require("./client");
 Object.defineProperty(exports, "QiniuAI", { enumerable: true, get: function () { return client_1.QiniuAI; } });
+Object.defineProperty(exports, "consoleLogger", { enumerable: true, get: function () { return client_1.consoleLogger; } });
+Object.defineProperty(exports, "noopLogger", { enumerable: true, get: function () { return client_1.noopLogger; } });
+Object.defineProperty(exports, "createFilteredLogger", { enumerable: true, get: function () { return client_1.createFilteredLogger; } });
+Object.defineProperty(exports, "defaultFetchAdapter", { enumerable: true, get: function () { return client_1.defaultFetchAdapter; } });
+Object.defineProperty(exports, "composeMiddleware", { enumerable: true, get: function () { return client_1.composeMiddleware; } });
+Object.defineProperty(exports, "retryMiddleware", { enumerable: true, get: function () { return client_1.retryMiddleware; } });
+Object.defineProperty(exports, "headersMiddleware", { enumerable: true, get: function () { return client_1.headersMiddleware; } });
+Object.defineProperty(exports, "timingMiddleware", { enumerable: true, get: function () { return client_1.timingMiddleware; } });
 // Error types
 var request_1 = require("./lib/request");
 Object.defineProperty(exports, "APIError", { enumerable: true, get: function () { return request_1.APIError; } });

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,cAAc;AACd,mCAUkB;AATd,iGAAA,OAAO,OAAA;AACP,uGAAA,aAAa,OAAA;AACb,oGAAA,UAAU,OAAA;AACV,8GAAA,oBAAoB,OAAA;AACpB,6GAAA,mBAAmB,OAAA;AACnB,2GAAA,iBAAiB,OAAA;AACjB,yGAAA,eAAe,OAAA;AACf,2GAAA,iBAAiB,OAAA;AACjB,0GAAA,gBAAgB,OAAA;AAcpB,cAAc;AACd,yCAAyC;AAAhC,mGAAA,QAAQ,OAAA;AAEjB,eAAe;AACf,8CAA4B"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // Main client
-export { QiniuAI } from './client.mjs';
+export { QiniuAI, consoleLogger, noopLogger, createFilteredLogger, defaultFetchAdapter, composeMiddleware, retryMiddleware, headersMiddleware, timingMiddleware, } from './client.mjs';
 // Error types
 export { APIError } from './lib/request.mjs';
 // Shared types

package/dist/lib/logger.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Logger interface for SDK observability.
+ * Users can provide their own logger (e.g., pino, winston, console).
+ */
+export interface Logger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Default no-op logger (silent)
+ */
+export declare const noopLogger: Logger;
+/**
+ * Console logger for development/debugging
+ */
+export declare const consoleLogger: Logger;
+/**
+ * Log levels for filtering
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Creates a filtered logger that only logs messages at or above the specified level
+ */
+export declare function createFilteredLogger(baseLogger: Logger, level: LogLevel): Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,MAAM;IACnB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAChE;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAKxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAK3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAUtE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAyBhF"}

package/dist/lib/logger.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consoleLogger = exports.noopLogger = void 0;
+exports.createFilteredLogger = createFilteredLogger;
+/**
+ * Default no-op logger (silent)
+ */
+exports.noopLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * Console logger for development/debugging
+ */
+exports.consoleLogger = {
+    debug: (msg, meta) => console.debug(`[QiniuAI:DEBUG] ${msg}`, meta ?? ''),
+    info: (msg, meta) => console.info(`[QiniuAI:INFO] ${msg}`, meta ?? ''),
+    warn: (msg, meta) => console.warn(`[QiniuAI:WARN] ${msg}`, meta ?? ''),
+    error: (msg, meta) => console.error(`[QiniuAI:ERROR] ${msg}`, meta ?? ''),
+};
+const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+/**
+ * Creates a filtered logger that only logs messages at or above the specified level
+ */
+function createFilteredLogger(baseLogger, level) {
+    const minPriority = LOG_LEVEL_PRIORITY[level];
+    return {
+        debug: (msg, meta) => {
+            if (LOG_LEVEL_PRIORITY.debug >= minPriority) {
+                baseLogger.debug(msg, meta);
+            }
+        },
+        info: (msg, meta) => {
+            if (LOG_LEVEL_PRIORITY.info >= minPriority) {
+                baseLogger.info(msg, meta);
+            }
+        },
+        warn: (msg, meta) => {
+            if (LOG_LEVEL_PRIORITY.warn >= minPriority) {
+                baseLogger.warn(msg, meta);
+            }
+        },
+        error: (msg, meta) => {
+            if (LOG_LEVEL_PRIORITY.error >= minPriority) {
+                baseLogger.error(msg, meta);
+            }
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":";;;AA+CA,oDAyBC;AA7DD;;GAEG;AACU,QAAA,UAAU,GAAW;IAC9B,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC;IAChB,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC;IACf,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC;CACnB,CAAC;AAEF;;GAEG;AACU,QAAA,aAAa,GAAW;IACjC,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,GAAG,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;IACzE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;IACtE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;IACtE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,GAAG,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;CAC5E,CAAC;AAOF,MAAM,kBAAkB,GAA6B;IACjD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACZ,CAAC;AAEF;;GAEG;AACH,SAAgB,oBAAoB,CAAC,UAAkB,EAAE,KAAe;IACpE,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAE9C,OAAO;QACH,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACjB,IAAI,kBAAkB,CAAC,KAAK,IAAI,WAAW,EAAE,CAAC;gBAC1C,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAChC,CAAC;QACL,CAAC;QACD,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YAChB,IAAI,kBAAkB,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;gBACzC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC/B,CAAC;QACL,CAAC;QACD,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YAChB,IAAI,kBAAkB,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;gBACzC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC/B,CAAC;QACL,CAAC;QACD,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACjB,IAAI,kBAAkB,CAAC,KAAK,IAAI,WAAW,EAAE,CAAC;gBAC1C,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAChC,CAAC;QACL,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/lib/logger.mjs

@@ -0,0 +1,54 @@
+/**
+ * Default no-op logger (silent)
+ */
+export const noopLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * Console logger for development/debugging
+ */
+export const consoleLogger = {
+    debug: (msg, meta) => console.debug(`[QiniuAI:DEBUG] ${msg}`, meta ?? ''),
+    info: (msg, meta) => console.info(`[QiniuAI:INFO] ${msg}`, meta ?? ''),
+    warn: (msg, meta) => console.warn(`[QiniuAI:WARN] ${msg}`, meta ?? ''),
+    error: (msg, meta) => console.error(`[QiniuAI:ERROR] ${msg}`, meta ?? ''),
+};
+const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+/**
+ * Creates a filtered logger that only logs messages at or above the specified level
+ */
+export function createFilteredLogger(baseLogger, level) {
+    const minPriority = LOG_LEVEL_PRIORITY[level];
+    return {
+        debug: (msg, meta) => {
+            if (LOG_LEVEL_PRIORITY.debug >= minPriority) {
+                baseLogger.debug(msg, meta);
+            }
+        },
+        info: (msg, meta) => {
+            if (LOG_LEVEL_PRIORITY.info >= minPriority) {
+                baseLogger.info(msg, meta);
+            }
+        },
+        warn: (msg, meta) => {
+            if (LOG_LEVEL_PRIORITY.warn >= minPriority) {
+                baseLogger.warn(msg, meta);
+            }
+        },
+        error: (msg, meta) => {
+            if (LOG_LEVEL_PRIORITY.error >= minPriority) {
+                baseLogger.error(msg, meta);
+            }
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/middleware.d.ts

@@ -0,0 +1,58 @@
+/**
+ * FetchAdapter interface for custom HTTP implementations.
+ * Allows users to replace the default fetch with axios, got, undici, etc.
+ */
+export interface FetchAdapter {
+    fetch(url: string, init: RequestInit): Promise<Response>;
+}
+/**
+ * Default adapter using native fetch
+ */
+export declare const defaultFetchAdapter: FetchAdapter;
+/**
+ * Request object passed through middleware chain
+ */
+export interface MiddlewareRequest {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+    timeout: number;
+    endpoint: string;
+    requestId: string;
+}
+/**
+ * Response object from middleware chain
+ */
+export interface MiddlewareResponse {
+    status: number;
+    headers: Record<string, string>;
+    data: unknown;
+    requestId: string;
+    duration: number;
+}
+/**
+ * Middleware function type.
+ * Can modify request before sending, and response after receiving.
+ */
+export type Middleware = (request: MiddlewareRequest, next: (request: MiddlewareRequest) => Promise<MiddlewareResponse>) => Promise<MiddlewareResponse>;
+/**
+ * Compose multiple middlewares into a single middleware chain
+ */
+export declare function composeMiddleware(middlewares: Middleware[]): Middleware;
+/**
+ * Built-in middleware: Retry on 5xx errors
+ */
+export declare function retryMiddleware(options?: {
+    maxRetries?: number;
+    retryDelay?: number;
+}): Middleware;
+/**
+ * Built-in middleware: Add custom headers to all requests
+ */
+export declare function headersMiddleware(headers: Record<string, string>): Middleware;
+/**
+ * Built-in middleware: Request/response timing
+ */
+export declare function timingMiddleware(onTiming: (endpoint: string, duration: number, status: number) => void): Middleware;
+//# sourceMappingURL=middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/lib/middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAEjC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CACrB,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,KAChE,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEjC;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,CAoBvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,UAAU,CA4BtG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,CAU7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GACvE,UAAU,CAMZ"}