@redonvn/event-ws-cliproxyapi-sdk 0.2.1 → 0.2.3

package/README.md

@@ -259,7 +259,8 @@ import { CliproxyWSProvider } from 'event-ws-cliproxyapi-sdk';
 const provider = new CliproxyWSProvider({
   baseUrl: 'http://127.0.0.1:8317',
   accessKey: 'andev',
-  managementKey: 'mgmt_xxx'
+  managementKey: 'mgmt_xxx',
+  authViaQuery: false
 });
 
 await provider.connect({
@@ -279,8 +280,16 @@ await provider.connect({
   }
 });
 
-provider.close();
-```
+provider.close();
+```
+
+Update credentials at runtime:
+```ts
+provider.setCredentials('api_new', 'mgmt_new');
+await provider.reconnect();
+// or:
+await provider.setCredentialsAndReconnect('api_new', 'mgmt_new');
+```
 
 ## Usage (HTTP Client)
 
@@ -429,5 +438,8 @@ await openai.postChatCompletions({
   - `Authorization: Bearer <accessKey>` (backward compatible)
   - `X-Access-Key: <accessKey>`
   - `X-Management-Key: <managementKey>` (if provided)
+- Optional query fallback (`authViaQuery: true`):
+  - `key=<accessKey>` + `auth_token=<accessKey>`
+  - `management_key=<managementKey>` + `mgmt_key=<managementKey>`
 - Management APIs require `managementKey` (or local password for `/keep-alive` if enabled).
 - HTTP client returns `Response` for streaming endpoints; parse SSE or chunks based on your client.

package/dist/ws/client.d.ts

@@ -7,9 +7,15 @@ export declare class CliproxyWSProvider {
     private ws?;
     private options;
     private handlers?;
+    private lastHandlers?;
     constructor(options: ProviderOptions);
     connect(handlers: ProviderHandlers): Promise<void>;
     close(): void;
+    reconnect(): Promise<void>;
+    setAccessKey(accessKey?: string): void;
+    setManagementKey(managementKey?: string): void;
+    setCredentials(accessKey?: string, managementKey?: string): void;
+    setCredentialsAndReconnect(accessKey?: string, managementKey?: string): Promise<void>;
     private handleMessage;
     private handleClose;
     private emitError;

package/dist/ws/client.js

@@ -10,10 +10,25 @@ export class CliproxyWSProvider {
     // It resolves once the socket is open.
     connect(handlers) {
         this.handlers = handlers;
+        this.lastHandlers = handlers;
         if (this.ws && this.ws.readyState === WebSocket.OPEN)
             return Promise.resolve();
         const base = this.options.baseUrl.replace(/\/+$/, '');
-        const url = `${base.replace(/^http/, 'ws')}/v1/ws`;
+        const wsPath = (this.options.wsPath || '/v1/ws').startsWith('/')
+            ? (this.options.wsPath || '/v1/ws')
+            : `/${this.options.wsPath || '/v1/ws'}`;
+        const urlObj = new URL(`${base.replace(/^http/, 'ws')}${wsPath}`);
+        if (this.options.authViaQuery) {
+            if (this.options.accessKey) {
+                urlObj.searchParams.set('key', this.options.accessKey);
+                urlObj.searchParams.set('auth_token', this.options.accessKey);
+            }
+            if (this.options.managementKey) {
+                urlObj.searchParams.set('management_key', this.options.managementKey);
+                urlObj.searchParams.set('mgmt_key', this.options.managementKey);
+            }
+        }
+        const url = urlObj.toString();
         const headers = {};
         if (this.options.accessKey) {
             headers['Authorization'] = `Bearer ${this.options.accessKey}`;
@@ -43,6 +58,27 @@ export class CliproxyWSProvider {
     close() {
         this.ws?.close();
     }
+    async reconnect() {
+        this.close();
+        if (!this.lastHandlers) {
+            throw new Error('wsrelay: reconnect requires handlers (call connect at least once)');
+        }
+        await this.connect(this.lastHandlers);
+    }
+    setAccessKey(accessKey) {
+        this.options.accessKey = accessKey;
+    }
+    setManagementKey(managementKey) {
+        this.options.managementKey = managementKey;
+    }
+    setCredentials(accessKey, managementKey) {
+        this.options.accessKey = accessKey;
+        this.options.managementKey = managementKey;
+    }
+    async setCredentialsAndReconnect(accessKey, managementKey) {
+        this.setCredentials(accessKey, managementKey);
+        await this.reconnect();
+    }
     handleMessage(raw) {
         let msg;
         try {

package/dist/ws/types.d.ts

@@ -76,6 +76,8 @@ export interface ProviderOptions {
     baseUrl: string;
     accessKey?: string;
     managementKey?: string;
+    wsPath?: string;
+    authViaQuery?: boolean;
 }
 export type ProviderEvent = {
     type: 'error';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redonvn/event-ws-cliproxyapi-sdk",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "TypeScript SDK for CLIProxyAPI WebSocket relay (provider-side).",
   "license": "MIT",
   "type": "module",