agentlink-sdk 1.0.5 → 1.0.6

package/README.md

@@ -34,12 +34,17 @@ pnpm add agentlink-sdk
 
 ### 基本使用
 
+SDK 默认使用服务端地址 `https://mixlab.top`，可直接创建客户端；如需使用自建或其它服务端，可传入 `serverUrl` 覆盖默认值。
+
 ```typescript
 import { AgentLinkClient } from 'agentlink-sdk';
 
-// 创建客户端实例
+// 使用默认地址 https://mixlab.top
+const client = new AgentLinkClient();
+
+// 或指定自定义服务端地址
 const client = new AgentLinkClient({
-  serverUrl: 'https://agent-link-server.vercel.app'
+  serverUrl: 'https://your-agentlink-server.com'
 });
 
 // 发送数据
@@ -69,7 +74,7 @@ new AgentLinkClient(options: AgentLinkClientOptions)
 
 **参数：**
 
-- `options.serverUrl` (string, 必需): 服务端验证地址，例如 `'https://agentlink-server.vercel.app'`
+- `options.serverUrl` (string, 可选): 服务端验证地址。不传时使用默认地址 `https://mixlab.top`；可传入自定义地址如 `'https://your-server.com'`
 
 #### 方法
 
@@ -223,10 +228,18 @@ console.log('所有白名单:', allInfo.whitelist);
 
 ```typescript
 interface AgentLinkClientOptions {
-  serverUrl: string;
+  serverUrl?: string;  // 可选，默认 'https://mixlab.top'
 }
 ```
 
+### DEFAULT_SERVER_URL
+
+```typescript
+const DEFAULT_SERVER_URL = 'https://mixlab.top';
+```
+
+如需与默认地址保持一致（例如在配置中引用），可从 SDK 导入：`import { DEFAULT_SERVER_URL } from 'agentlink-sdk'`。
+
 ### SenderInfo
 
 ```typescript
@@ -289,9 +302,8 @@ interface WhitelistResponse {
 ### 发送数据示例
 
 ```typescript
-const client = new AgentLinkClient({
-  serverUrl: 'https://agent-link-server.vercel.app'
-});
+// 使用默认地址
+const client = new AgentLinkClient();
 
 // 发送复杂数据
 await client.sendData(
@@ -310,9 +322,8 @@ await client.sendData(
 ### 接收数据示例
 
 ```typescript
-const client = new AgentLinkClient({
-  serverUrl: 'https://agent-link-server.vercel.app'
-});
+// 使用默认地址，也可传入 serverUrl 使用自建服务端
+const client = new AgentLinkClient();
 
 // 监听数据
 client.receiveData((data, type, senderInfo, verification) => {

package/dist/index.d.mts

@@ -1,12 +1,15 @@
 interface AgentLinkClientOptions {
     /**
-     * 服务端验证地址
-     * 例如: 'https://agentlink-server.vercel.app'
+     * 服务端验证地址，不传则使用默认地址 https://mixlab.top
+     * 例如: 'https://mixlab.top' 或自定义 'https://your-server.com'
      */
-    serverUrl: string;
+    serverUrl?: string;
 }
+/** 默认服务端地址 */
+declare const DEFAULT_SERVER_URL = "https://mixlab.top";
 interface WhitelistInfo {
     domain: string;
+    name?: string | null;
     description?: string | null;
 }
 interface WhitelistResponse {
@@ -28,7 +31,7 @@ declare class AgentLinkClient {
     private static tokenCache;
     private static whitelistCache;
     private static CACHE_TTL;
-    constructor(options: AgentLinkClientOptions);
+    constructor(options?: AgentLinkClientOptions);
     /**
      * 确保有 Token（自动获取）
      */
@@ -117,4 +120,4 @@ declare function verifyWhitelist(serverUrl: string, origin?: string): Promise<bo
  */
 declare function fetchWhitelistInfo(serverUrl: string, includeAll?: boolean): Promise<any>;
 
-export { AgentLinkClient, type AgentLinkClientOptions, type SenderInfo, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, fetchWhitelistInfo, uint8ArrayToBase64, verifyWhitelist };
+export { AgentLinkClient, type AgentLinkClientOptions, DEFAULT_SERVER_URL, type SenderInfo, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, fetchWhitelistInfo, uint8ArrayToBase64, verifyWhitelist };

package/dist/index.d.ts

@@ -1,12 +1,15 @@
 interface AgentLinkClientOptions {
     /**
-     * 服务端验证地址
-     * 例如: 'https://agentlink-server.vercel.app'
+     * 服务端验证地址，不传则使用默认地址 https://mixlab.top
+     * 例如: 'https://mixlab.top' 或自定义 'https://your-server.com'
      */
-    serverUrl: string;
+    serverUrl?: string;
 }
+/** 默认服务端地址 */
+declare const DEFAULT_SERVER_URL = "https://mixlab.top";
 interface WhitelistInfo {
     domain: string;
+    name?: string | null;
     description?: string | null;
 }
 interface WhitelistResponse {
@@ -28,7 +31,7 @@ declare class AgentLinkClient {
     private static tokenCache;
     private static whitelistCache;
     private static CACHE_TTL;
-    constructor(options: AgentLinkClientOptions);
+    constructor(options?: AgentLinkClientOptions);
     /**
      * 确保有 Token（自动获取）
      */
@@ -117,4 +120,4 @@ declare function verifyWhitelist(serverUrl: string, origin?: string): Promise<bo
  */
 declare function fetchWhitelistInfo(serverUrl: string, includeAll?: boolean): Promise<any>;
 
-export { AgentLinkClient, type AgentLinkClientOptions, type SenderInfo, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, fetchWhitelistInfo, uint8ArrayToBase64, verifyWhitelist };
+export { AgentLinkClient, type AgentLinkClientOptions, DEFAULT_SERVER_URL, type SenderInfo, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, fetchWhitelistInfo, uint8ArrayToBase64, verifyWhitelist };

package/dist/index.js

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AgentLinkClient: () => AgentLinkClient,
+  DEFAULT_SERVER_URL: () => DEFAULT_SERVER_URL,
   base64ToUint8Array: () => base64ToUint8Array,
   compress: () => compress,
   decodeDataFromUrl: () => decodeDataFromUrl,
@@ -173,12 +174,14 @@ async function fetchWhitelistInfo(serverUrl, includeAll = false) {
 }
 
 // src/client.ts
+var DEFAULT_SERVER_URL = "https://mixlab.top";
 var _AgentLinkClient = class _AgentLinkClient {
-  constructor(options) {
+  constructor(options = {}) {
     // 发送端 Token 缓存（实例级别）
     this.token = null;
     this.tokenPromise = null;
-    this.serverUrl = options.serverUrl.replace(/\/$/, "");
+    const base = options.serverUrl ?? DEFAULT_SERVER_URL;
+    this.serverUrl = base.replace(/\/$/, "");
   }
   /**
    * 确保有 Token（自动获取）

package/dist/index.mjs

@@ -139,12 +139,14 @@ async function fetchWhitelistInfo(serverUrl, includeAll = false) {
 }
 
 // src/client.ts
+var DEFAULT_SERVER_URL = "https://mixlab.top";
 var _AgentLinkClient = class _AgentLinkClient {
-  constructor(options) {
+  constructor(options = {}) {
     // 发送端 Token 缓存（实例级别）
     this.token = null;
     this.tokenPromise = null;
-    this.serverUrl = options.serverUrl.replace(/\/$/, "");
+    const base = options.serverUrl ?? DEFAULT_SERVER_URL;
+    this.serverUrl = base.replace(/\/$/, "");
   }
   /**
    * 确保有 Token（自动获取）
@@ -304,6 +306,7 @@ _AgentLinkClient.CACHE_TTL = 60 * 60 * 1e3;
 var AgentLinkClient = _AgentLinkClient;
 export {
   AgentLinkClient,
+  DEFAULT_SERVER_URL,
   base64ToUint8Array,
   compress,
   decodeDataFromUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentlink-sdk",
-    "version": "1.0.5",
+    "version": "1.0.6",
     "description": "AgentLink client SDK for cross-domain data synchronization via URL hash",
     "main": "dist/index.js",
     "module": "dist/index.esm.js",