@blocklet/payment-vendor 1.20.6

package/examples/usage-example.ts

@@ -0,0 +1,321 @@
+/* eslint-disable import/prefer-default-export */
+
+/**
+ * @blocklet/payment-vendor 使用示例
+ * 
+ * 这个示例展示了如何集成 SDK 来创建一个完整的供应商服务
+ */
+
+import VendorSDK from '@blocklet/payment-vendor';
+import express from 'express';
+
+// ==================== 基础服务设置 ====================
+
+const app = express();
+
+// 基础中间件
+app.use(express.json());
+
+// ==================== 中介配置 ====================
+
+// 方式1: 静态配置（适用于固定中介列表）
+VendorSDK.setBrokers([
+  {
+    id: 'payment-kit',
+    name: 'Payment Kit Service',
+    publicKey: process.env.PAYMENT_KIT_PUBLIC_KEY || '0x680688a033b86da179f39018e074410439ae82a97c4cb8e1ad16c26eabcc1795',
+    status: 'active',
+    rateLimit: 100
+  }
+]);
+
+// 方式2: 动态配置（适用于需要实时更新的场景）
+// VendorSDK.setBrokers(() => {
+//   // 从环境变量读取配置
+//   const configSource = process.env.VENDOR_DISTRIBUTORS || '[]';
+//   try {
+//     const brokers = JSON.parse(configSource);
+//     return brokers.map((item: any) => ({
+//       id: item.brokerId,
+//       name: item.name,
+//       publicKey: item.publicKey,
+//       status: item.enabled ? 'active' : 'inactive',
+//       rateLimit: item.rateLimit || 100
+//     }));
+//   } catch (error) {
+//     console.error('Failed to parse broker config:', error);
+//     return [];
+//   }
+// });
+
+// ==================== 中间件配置 ====================
+
+// 限流中间件
+app.use('/api/vendor', VendorSDK.middleware.rateLimiter({
+  windowMs: 60000, // 1分钟
+  max: 1000        // 最多1000次请求
+}));
+
+// 认证中间件
+app.use('/api/vendor', VendorSDK.middleware.ensureAuth({
+  skipTimestamp: false,
+  maxAge: 300000 // 5分钟
+}));
+
+// ==================== 业务端点 ====================
+
+/**
+ * 主要业务端点：处理发货、状态查询、退货等操作
+ */
+app.post('/api/vendor/deliveries', async (req, res) => {
+  try {
+    const { userInfo, deliveryParams, description } = req.body;
+    
+    console.log(`Processing delivery request - User: ${userInfo.userDid}, Instance: ${deliveryParams.instanceName}`);
+    
+    // 处理发货逻辑
+    const fulfillResult = await handleFulfillment(userInfo, deliveryParams, description);
+    res.json({
+      success: fulfillResult.success,
+      status: fulfillResult.success ? 'completed' : 'failed',
+      data: fulfillResult.data,
+      message: fulfillResult.message
+    });
+  } catch (error: any) {
+    console.error('Request processing failed:', error);
+    res.status(500).json({
+      success: false,
+      status: 'failed',
+      error: '内部服务器错误',
+      message: error.message
+    });
+  }
+});
+
+// ==================== 管理端点 ====================
+
+/**
+ * 健康检查端点
+ */
+app.get('/health', VendorSDK.middleware.healthCheck());
+
+/**
+ * 中介状态查询端点
+ */
+app.get('/api/admin/brokers', async (req, res) => {
+  try {
+    const brokers = await VendorSDK.getWhitelist();
+    res.json({
+      total: brokers.length,
+      active: brokers.filter((d: any) => d.status === 'active').length,
+      brokers: brokers.map((d: any) => ({
+        id: d.id,
+        name: d.name,
+        status: d.status,
+        rateLimit: d.rateLimit,
+        // 不暴露公钥全文，只显示前缀
+        publicKeyPrefix: d.publicKey.substring(0, 10) + '...'
+      }))
+    });
+  } catch (error: any) {
+    res.status(500).json({ 
+      error: '获取中介列表失败',
+      message: error.message 
+    });
+  }
+});
+
+/**
+ * 系统信息端点
+ */
+app.get('/api/admin/info', (req, res) => {
+  res.json({
+    service: 'Vendor Service',
+    version: '1.0.0',
+    uptime: Math.floor(process.uptime()),
+    memory: {
+      used: Math.round(process.memoryUsage().heapUsed / 1024 / 1024),
+      total: Math.round(process.memoryUsage().heapTotal / 1024 / 1024)
+    },
+    nodeVersion: process.version,
+    timestamp: new Date().toISOString()
+  });
+});
+
+// ==================== 错误处理 ====================
+
+/**
+ * 统一错误处理中间件
+ */
+app.use(VendorSDK.middleware.errorHandler);
+
+// ==================== 业务逻辑函数 ====================
+
+/**
+ * 处理发货逻辑
+ */
+async function handleFulfillment(userInfo: any, deliveryParams: any, description: string) {
+  console.log(`Processing delivery - User: ${userInfo.userDid}, Instance: ${deliveryParams.instanceName}`, {
+    userEmail: userInfo.email,
+    productId: deliveryParams.productId,
+    description
+  });
+  
+  try {
+    // 模拟业务处理时间
+    await new Promise(resolve => setTimeout(resolve, 1000));
+    
+    // 模拟成功率（90%成功）
+    const isSuccess = Math.random() > 0.1;
+    
+    if (isSuccess) {
+      const instanceId = `inst_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+      
+      return {
+        success: true,
+        data: {
+          instanceId,
+          serviceUrl: `https://example.com/service/${deliveryParams.instanceName}`,
+          installUrl: `https://example.com/install/${instanceId}`,
+          expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString()
+        },
+        message: '发货成功'
+      };
+    } else {
+      return {
+        success: false,
+        data: null,
+        message: '发货失败，请重试'
+      };
+    }
+  } catch (error: any) {
+    console.error('Delivery processing failed:', error);
+    return {
+      success: false,
+      data: null,
+      message: `发货异常: ${error.message}`
+    };
+  }
+}
+
+/**
+ * 处理状态查询逻辑 (可选的附加端点)
+ */
+async function getDeliveryStatus(instanceId: string) {
+  console.log(`Querying delivery status - Instance: ${instanceId}`);
+  
+  try {
+    // 模拟状态查询
+    const statuses = ['pending', 'processing', 'completed'];
+    const status = statuses[Math.floor(Math.random() * statuses.length)];
+    
+    let progress = 0;
+    let estimatedTime = 0;
+    
+    switch (status) {
+      case 'pending':
+        progress = 0;
+        estimatedTime = 300; // 5分钟
+        break;
+      case 'processing':
+        progress = Math.floor(Math.random() * 80) + 10; // 10-90%
+        estimatedTime = Math.floor(Math.random() * 180) + 60; // 1-3分钟
+        break;
+      case 'completed':
+        progress = 100;
+        estimatedTime = 0;
+        break;
+    }
+    
+    return {
+      instanceId,
+      status,
+      progress,
+      estimatedTime,
+      serviceUrl: status === 'completed' ? `https://example.com/service/${instanceId}` : undefined
+    };
+  } catch (error: any) {
+    console.error('Status query failed:', error);
+    return {
+      instanceId,
+      status: 'failed',
+      progress: 0,
+      estimatedTime: 0,
+      error: error.message
+    };
+  }
+}
+
+// ==================== 服务启动 ====================
+
+const port = parseInt(process.env.PORT || '3000', 10);
+
+app.listen(port, () => {
+  console.log('Vendor service started successfully!');
+  console.log(`Service URL: http://localhost:${port}`);
+  console.log(`Health check: http://localhost:${port}/health`);
+});
+
+// ==================== 优雅关闭 ====================
+
+process.on('SIGTERM', () => {
+  console.log('Received SIGTERM signal, starting graceful shutdown...');
+  process.exit(0);
+});
+
+process.on('SIGINT', () => {
+  console.log('Received SIGINT signal, starting graceful shutdown...');
+  process.exit(0);
+});
+
+// ==================== 导出 (可选) ====================
+
+export default app;
+
+// ==================== 使用说明 ====================
+
+/*
+
+环境变量配置:
+
+```bash
+# 中介配置
+export PAYMENT_KIT_PUBLIC_KEY="0x680688a033b86da179f39018e074410439ae82a97c4cb8e1ad16c26eabcc1795"
+
+# 动态配置示例
+export VENDOR_DISTRIBUTORS='[{
+  "brokerId": "payment-kit",
+  "name": "Payment Kit Service", 
+  "publicKey": "0x680688a033b86da179f39018e074410439ae82a97c4cb8e1ad16c26eabcc1795",
+  "enabled": true,
+  "rateLimit": 100
+}]'
+
+# 服务端口
+export PORT=3000
+```
+
+启动服务:
+
+```bash
+# 开发模式
+npm run dev
+
+# 生产模式
+npm start
+```
+
+测试接口:
+
+```bash
+# 健康检查
+curl http://localhost:3000/health
+
+# 中介列表
+curl http://localhost:3000/api/admin/brokers
+
+# 系统信息
+curl http://localhost:3000/api/admin/info
+```
+
+*/

package/lib/auth.d.ts

@@ -0,0 +1,58 @@
+import type { VendorRequest, VendorSignedRequest } from './types';
+export declare class VendorAuth {
+    /**
+     * @example
+     * ```typescript
+     * const request = {
+     *   orderId: 'order_123',
+     *   brokerId: 'payment-kit',
+     *   timestamp: Date.now(),
+     *   operation: 'fulfill',
+     *   params: { appName: 'test-app' }
+     * };
+     *
+     * const signature = VendorAuth.signRequest(request, process.env.SERVER_SK);
+     * ```
+     */
+    static signRequest(request: VendorRequest): string;
+    /**
+     * @example
+     * ```typescript
+     * const broker = WhitelistManager.getBroker('payment-kit');
+     * const verified = VendorAuth.verifyRequest(signedRequest, publicKey);
+     * ```
+     */
+    static verifyRequest(request: VendorSignedRequest, brokerPublicKey: string): Promise<boolean>;
+    static validateTimestamp(timestamp: number, maxAge?: number): boolean;
+    /**
+     * @example
+     * ```typescript
+     * const headers = VendorAuth.generateHeaders(request);
+     *
+     * fetch(brokerEndpoint, { method: 'POST', headers, body: JSON.stringify(request) });
+     * ```
+     */
+    static generateHeaders(request: VendorRequest): Record<string, string>;
+    /**
+     * @example
+     * ```typescript
+     * const { headers, body } = VendorAuth.signRequestWithHeaders(
+     *   orderData,
+     *   wallet.secretKey,
+     *   wallet.publicKey
+     * );
+     *
+     * const response = await fetch('/api/broker/deliveries', {
+     *   method: 'POST',
+     *   headers,
+     *   body
+     * });
+     * ```
+     */
+    static signRequestWithHeaders(request: Record<string, any>): {
+        headers: Record<string, string>;
+        body: string;
+    };
+    static signAndSerialize(request: VendorRequest): string;
+}
+//# sourceMappingURL=auth.d.ts.map

package/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAIlE,qBAAa,UAAU;IACrB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;IAgBlD;;;;;;OAMG;WACU,aAAa,CAAC,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBnG,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAS,GAAG,OAAO;IAcrE;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAetE;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAW9G,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;CASxD"}

package/lib/auth.js

@@ -0,0 +1,138 @@
+"use strict";
+/* eslint-disable import/prefer-default-export */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VendorAuth = void 0;
+const wallet_1 = __importDefault(require("@blocklet/sdk/lib/wallet"));
+const util_1 = require("@ocap/util");
+const wallet_2 = require("@ocap/wallet");
+const json_stable_stringify_1 = __importDefault(require("json-stable-stringify"));
+const logger_1 = __importDefault(require("./logger"));
+const { secretKey, publicKey } = (0, wallet_1.default)();
+class VendorAuth {
+    /**
+     * @example
+     * ```typescript
+     * const request = {
+     *   orderId: 'order_123',
+     *   brokerId: 'payment-kit',
+     *   timestamp: Date.now(),
+     *   operation: 'fulfill',
+     *   params: { appName: 'test-app' }
+     * };
+     *
+     * const signature = VendorAuth.signRequest(request, process.env.SERVER_SK);
+     * ```
+     */
+    static signRequest(request) {
+        try {
+            if (!secretKey) {
+                throw new Error('brokerSk is required for signing');
+            }
+            const wallet = (0, wallet_2.fromSecretKey)(secretKey);
+            const payload = (0, json_stable_stringify_1.default)(request || {});
+            const signature = wallet.sign(payload);
+            return (0, util_1.toBase58)(signature);
+        }
+        catch (error) {
+            throw new Error(`Failed to sign vendor request: ${error.message}`);
+        }
+    }
+    /**
+     * @example
+     * ```typescript
+     * const broker = WhitelistManager.getBroker('payment-kit');
+     * const verified = VendorAuth.verifyRequest(signedRequest, publicKey);
+     * ```
+     */
+    static async verifyRequest(request, brokerPublicKey) {
+        try {
+            const { signature, ...payload } = request;
+            const wallet = (0, wallet_2.fromPublicKey)(brokerPublicKey);
+            const payloadString = (0, json_stable_stringify_1.default)(payload || {});
+            const signatureBytes = (0, util_1.fromBase58)(signature);
+            const verified = await wallet.verify(payloadString, signatureBytes);
+            return verified;
+        }
+        catch (error) {
+            // Critical: Log signature verification errors
+            logger_1.default.error('Signature verification failed', { error: error.message });
+            return false;
+        }
+    }
+    static validateTimestamp(timestamp, maxAge = 300000) {
+        try {
+            if (!Number.isFinite(timestamp) || timestamp <= 0) {
+                return false;
+            }
+            const now = Date.now();
+            const age = Math.abs(now - timestamp);
+            return age <= maxAge;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * @example
+     * ```typescript
+     * const headers = VendorAuth.generateHeaders(request);
+     *
+     * fetch(brokerEndpoint, { method: 'POST', headers, body: JSON.stringify(request) });
+     * ```
+     */
+    static generateHeaders(request) {
+        try {
+            const signature = VendorAuth.signRequest(request);
+            return {
+                'Content-Type': 'application/json',
+                'x-broker-sig': signature,
+                'x-broker-did': publicKey,
+                'User-Agent': '@arcblock/vendor-sdk/1.19.18',
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to generate headers: ${error.message}`);
+        }
+    }
+    /**
+     * @example
+     * ```typescript
+     * const { headers, body } = VendorAuth.signRequestWithHeaders(
+     *   orderData,
+     *   wallet.secretKey,
+     *   wallet.publicKey
+     * );
+     *
+     * const response = await fetch('/api/broker/deliveries', {
+     *   method: 'POST',
+     *   headers,
+     *   body
+     * });
+     * ```
+     */
+    static signRequestWithHeaders(request) {
+        try {
+            const headers = VendorAuth.generateHeaders(request);
+            const body = JSON.stringify(request);
+            return { headers, body };
+        }
+        catch (error) {
+            throw new Error(`Failed to sign request with headers: ${error.message}`);
+        }
+    }
+    static signAndSerialize(request) {
+        try {
+            const signature = VendorAuth.signRequest(request);
+            const signedRequest = { ...request, signature };
+            return JSON.stringify(signedRequest);
+        }
+        catch (error) {
+            throw new Error(`Failed to sign and serialize request: ${error.message}`);
+        }
+    }
+}
+exports.VendorAuth = VendorAuth;
+//# sourceMappingURL=auth.js.map

package/lib/auth.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,70 @@
+import { VendorAuth } from './auth';
+import { WhitelistManager } from './whitelist';
+import { ensureVendorAuth, healthCheck, errorHandler, rateLimiter } from './middleware';
+export { VendorAuth } from './auth';
+export { WhitelistManager } from './whitelist';
+export { ensureVendorAuth, healthCheck, errorHandler, rateLimiter } from './middleware';
+export type { VendorOrderStatus, BrokerStatus, DeliveryRequest, VendorRequest, VendorSignedRequest, VendorResponse, BrokerConfig, SigningOptions, AuthMiddlewareOptions, VendorOrder, VendorHooks, VendorStorage, CreateOrderParams, UpdateOrderParams, HealthCheckResponse, } from './types';
+declare const VendorSDK: {
+    Auth: typeof VendorAuth;
+    Whitelist: typeof WhitelistManager;
+    middleware: {
+        ensureAuth: typeof ensureVendorAuth;
+        healthCheck: typeof healthCheck;
+        errorHandler: typeof errorHandler;
+        rateLimiter: typeof rateLimiter;
+    };
+    utils: {
+        validateTimestamp: typeof VendorAuth.validateTimestamp;
+        generateHeaders: typeof VendorAuth.generateHeaders;
+        signAndSerialize: typeof VendorAuth.signAndSerialize;
+        signRequestWithHeaders: typeof VendorAuth.signRequestWithHeaders;
+        getBroker: typeof WhitelistManager.getBroker;
+        getBrokerByPublicKey: typeof WhitelistManager.getBrokerByPublicKey;
+    };
+    /**
+     * @example
+     * VendorSDK.setBrokers([{ id: 'payment-kit', ... }]);
+     * VendorSDK.setBrokers(() => parseMyConfig());
+     */
+    setBrokers: typeof WhitelistManager.setBrokers;
+    /**
+     * @example
+     * const whitelist = await VendorSDK.getWhitelist();
+     * console.log('Current whitelist:', whitelist);
+     */
+    getWhitelist: typeof WhitelistManager.getWhitelist;
+    getActiveBrokers: typeof WhitelistManager.getActiveBrokers;
+    clearBrokers: typeof WhitelistManager.clearBrokers;
+    constants: {
+        OrderStatus: {
+            PENDING: "pending";
+            PROCESSING: "processing";
+            COMPLETED: "completed";
+            FAILED: "failed";
+            CANCELLED: "cancelled";
+            RETURN_REQUESTED: "return_requested";
+        };
+        Operation: {
+            FULFILL: "fulfill";
+            STATUS: "status";
+            RETURN: "return";
+        };
+        Defaults: {
+            TIMESTAMP_MAX_AGE: number;
+            RATE_LIMIT: number;
+            RATE_LIMIT_WINDOW: number;
+            MAX_RETRIES: number;
+        };
+    };
+};
+export default VendorSDK;
+export declare const Auth: typeof VendorAuth;
+export declare const Whitelist: typeof WhitelistManager;
+export declare const middleware: {
+    ensureAuth: typeof ensureVendorAuth;
+    healthCheck: typeof healthCheck;
+    errorHandler: typeof errorHandler;
+    rateLimiter: typeof rateLimiter;
+};
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAExF,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,WAAW,EACX,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;IAoBb;;;;OAIG;;IAGH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;CA4BJ,CAAC;AAEF,eAAe,SAAS,CAAC;AAEzB,eAAO,MAAM,IAAI,mBAAa,CAAC;AAC/B,eAAO,MAAM,SAAS,yBAAmB,CAAC;AAC1C,eAAO,MAAM,UAAU;;;;;CAKtB,CAAC"}

package/lib/index.js

@@ -0,0 +1,79 @@
+"use strict";
+/* eslint-disable import/prefer-default-export */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.middleware = exports.Whitelist = exports.Auth = exports.rateLimiter = exports.errorHandler = exports.healthCheck = exports.ensureVendorAuth = exports.WhitelistManager = exports.VendorAuth = void 0;
+const auth_1 = require("./auth");
+const whitelist_1 = require("./whitelist");
+const middleware_1 = require("./middleware");
+var auth_2 = require("./auth");
+Object.defineProperty(exports, "VendorAuth", { enumerable: true, get: function () { return auth_2.VendorAuth; } });
+var whitelist_2 = require("./whitelist");
+Object.defineProperty(exports, "WhitelistManager", { enumerable: true, get: function () { return whitelist_2.WhitelistManager; } });
+var middleware_2 = require("./middleware");
+Object.defineProperty(exports, "ensureVendorAuth", { enumerable: true, get: function () { return middleware_2.ensureVendorAuth; } });
+Object.defineProperty(exports, "healthCheck", { enumerable: true, get: function () { return middleware_2.healthCheck; } });
+Object.defineProperty(exports, "errorHandler", { enumerable: true, get: function () { return middleware_2.errorHandler; } });
+Object.defineProperty(exports, "rateLimiter", { enumerable: true, get: function () { return middleware_2.rateLimiter; } });
+const VendorSDK = {
+    Auth: auth_1.VendorAuth,
+    Whitelist: whitelist_1.WhitelistManager,
+    middleware: {
+        ensureAuth: middleware_1.ensureVendorAuth,
+        healthCheck: middleware_1.healthCheck,
+        errorHandler: middleware_1.errorHandler,
+        rateLimiter: middleware_1.rateLimiter,
+    },
+    utils: {
+        validateTimestamp: auth_1.VendorAuth.validateTimestamp,
+        generateHeaders: auth_1.VendorAuth.generateHeaders,
+        signAndSerialize: auth_1.VendorAuth.signAndSerialize,
+        signRequestWithHeaders: auth_1.VendorAuth.signRequestWithHeaders,
+        getBroker: whitelist_1.WhitelistManager.getBroker,
+        getBrokerByPublicKey: whitelist_1.WhitelistManager.getBrokerByPublicKey,
+    },
+    /**
+     * @example
+     * VendorSDK.setBrokers([{ id: 'payment-kit', ... }]);
+     * VendorSDK.setBrokers(() => parseMyConfig());
+     */
+    setBrokers: whitelist_1.WhitelistManager.setBrokers,
+    /**
+     * @example
+     * const whitelist = await VendorSDK.getWhitelist();
+     * console.log('Current whitelist:', whitelist);
+     */
+    getWhitelist: whitelist_1.WhitelistManager.getWhitelist,
+    getActiveBrokers: whitelist_1.WhitelistManager.getActiveBrokers,
+    clearBrokers: whitelist_1.WhitelistManager.clearBrokers,
+    constants: {
+        OrderStatus: {
+            PENDING: 'pending',
+            PROCESSING: 'processing',
+            COMPLETED: 'completed',
+            FAILED: 'failed',
+            CANCELLED: 'cancelled',
+            RETURN_REQUESTED: 'return_requested',
+        },
+        Operation: {
+            FULFILL: 'fulfill',
+            STATUS: 'status',
+            RETURN: 'return',
+        },
+        Defaults: {
+            TIMESTAMP_MAX_AGE: 300000,
+            RATE_LIMIT: 100,
+            RATE_LIMIT_WINDOW: 60000,
+            MAX_RETRIES: 3,
+        },
+    },
+};
+exports.default = VendorSDK;
+exports.Auth = auth_1.VendorAuth;
+exports.Whitelist = whitelist_1.WhitelistManager;
+exports.middleware = {
+    ensureAuth: middleware_1.ensureVendorAuth,
+    healthCheck: middleware_1.healthCheck,
+    errorHandler: middleware_1.errorHandler,
+    rateLimiter: middleware_1.rateLimiter,
+};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,iDAAiD;;;AAEjD,iCAAoC;AACpC,2CAA+C;AAC/C,6CAAwF;AAExF,+BAAoC;AAA3B,kGAAA,UAAU,OAAA;AACnB,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AAEzB,2CAAwF;AAA/E,8GAAA,gBAAgB,OAAA;AAAE,yGAAA,WAAW,OAAA;AAAE,0GAAA,YAAY,OAAA;AAAE,yGAAA,WAAW,OAAA;AAoBjE,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE,iBAAU;IAEhB,SAAS,EAAE,4BAAgB;IAC3B,UAAU,EAAE;QACV,UAAU,EAAE,6BAAgB;QAC5B,WAAW,EAAX,wBAAW;QACX,YAAY,EAAZ,yBAAY;QACZ,WAAW,EAAX,wBAAW;KACZ;IAED,KAAK,EAAE;QACL,iBAAiB,EAAE,iBAAU,CAAC,iBAAiB;QAC/C,eAAe,EAAE,iBAAU,CAAC,eAAe;QAC3C,gBAAgB,EAAE,iBAAU,CAAC,gBAAgB;QAC7C,sBAAsB,EAAE,iBAAU,CAAC,sBAAsB;QACzD,SAAS,EAAE,4BAAgB,CAAC,SAAS;QACrC,oBAAoB,EAAE,4BAAgB,CAAC,oBAAoB;KAC5D;IAED;;;;OAIG;IACH,UAAU,EAAE,4BAAgB,CAAC,UAAU;IAEvC;;;;OAIG;IACH,YAAY,EAAE,4BAAgB,CAAC,YAAY;IAC3C,gBAAgB,EAAE,4BAAgB,CAAC,gBAAgB;IACnD,YAAY,EAAE,4BAAgB,CAAC,YAAY;IAE3C,SAAS,EAAE;QACT,WAAW,EAAE;YACX,OAAO,EAAE,SAAkB;YAC3B,UAAU,EAAE,YAAqB;YACjC,SAAS,EAAE,WAAoB;YAC/B,MAAM,EAAE,QAAiB;YACzB,SAAS,EAAE,WAAoB;YAC/B,gBAAgB,EAAE,kBAA2B;SAC9C;QAED,SAAS,EAAE;YACT,OAAO,EAAE,SAAkB;YAC3B,MAAM,EAAE,QAAiB;YACzB,MAAM,EAAE,QAAiB;SAC1B;QAED,QAAQ,EAAE;YACR,iBAAiB,EAAE,MAAM;YACzB,UAAU,EAAE,GAAG;YACf,iBAAiB,EAAE,KAAK;YACxB,WAAW,EAAE,CAAC;SACf;KACF;CACF,CAAC;AAEF,kBAAe,SAAS,CAAC;AAEZ,QAAA,IAAI,GAAG,iBAAU,CAAC;AAClB,QAAA,SAAS,GAAG,4BAAgB,CAAC;AAC7B,QAAA,UAAU,GAAG;IACxB,UAAU,EAAE,6BAAgB;IAC5B,WAAW,EAAX,wBAAW;IACX,YAAY,EAAZ,yBAAY;IACZ,WAAW,EAAX,wBAAW;CACZ,CAAC"}