@be-link/ecommerce-backend-bff-service-node-sdk 0.0.10 → 0.0.12

package/README.md

@@ -1,11 +1,33 @@
+## 开发
+
+### 添加新服务
+
+1. **创建 types.ts 文件**
+   ```bash
+   # 在对应平台和模块目录下创建 types.ts
+   # 例如：src/bff/modules/miniprogram/product/types.ts
+   ```
+
+2. **生成服务代码**
+   ```bash
+   # ⚠️ 必须在 packages/sdk 目录下运行
+   cd packages/sdk
+   npm run generate miniprogram/product
+   ```
+
+
+
 # EcommerceBackendBffService SDK
 
-EcommerceBackendBffService Node.js SDK - 统一平台 SDK，支持 Web/H5 和微信小程序
+EcommerceBackendBffService Node.js SDK - 按平台分离的 SDK，支持 Pandora 管理后台和微信小程序
 
 ## 特性
 
+- ✅ **平台分离架构**：PandoraSDK 和 MiniProgramSDK 独立，避免命名冲突
 - ✅ **统一命名空间结构**：与后端 SDK 保持一致的类型定义
 - ✅ **自动生成 Swagger 文档**：使用 tsoa 自动生成 OpenAPI 3.0 文档
+- ✅ **双模块格式支持**：同时支持 ESM 和 CommonJS，兼容 Vite、Webpack 等现代构建工具
+- ✅ **编译时装饰器移除**：使用 TypeScript transformer 在编译时移除 tsoa 装饰器，前端零依赖
 - ✅ **多平台支持**：自动检测并适配 Web/H5 和微信小程序环境
 - ✅ **类型安全**：完整的 TypeScript 类型定义
 - ✅ **标准响应格式**：统一的 `StandardResponse<T>` 响应结构
@@ -18,11 +40,46 @@ npm install @be-link/ecommerce-backend-bff-service-node-sdk
 
 ## 使用
 
-### Web/H5 环境
+> 💡 **重要变更**：SDK 现在按平台分离，请使用 `PandoraSDK` 或 `MiniProgramSDK`。详见 [平台 SDK 指南](./PLATFORM_SDK_GUIDE.md)
+
+### Pandora 管理后台
+
+```typescript
+import { PandoraSDK } from '@be-link/ecommerce-backend-bff-service-node-sdk'
+
+const sdk = new PandoraSDK({
+  getToken: async () => localStorage.getItem('token') || '',
+  getUserId: async () => localStorage.getItem('userId') || '',
+  getRoleId: async () => localStorage.getItem('roleId') || '',
+  environment: 'production'
+})
+
+// 使用 Pandora 服务
+const result = await sdk.example.getExampleData({ id: '123' })
+```
+
+### 微信小程序
+
+```typescript
+import { MiniProgramSDK } from '@be-link/ecommerce-backend-bff-service-node-sdk'
+
+const sdk = new MiniProgramSDK({
+  getToken: async () => wx.getStorageSync('token') || '',
+  getUserId: async () => wx.getStorageSync('userId') || '',
+  getRoleId: async () => wx.getStorageSync('roleId') || '',
+  environment: 'production'
+})
+
+// 使用小程序服务
+const result = await sdk.demo.getDemoData({ page: 1 })
+```
+
+### 旧版本兼容（不推荐）
 
 ```typescript
 import { EcommerceBackendBffSDK } from '@be-link/ecommerce-backend-bff-service-node-sdk'
 
+// ⚠️ 已废弃，请迁移到 PandoraSDK 或 MiniProgramSDK
 const sdk = new EcommerceBackendBffSDK({
   getToken: async () => localStorage.getItem('token') || '',
   getUserId: async () => localStorage.getItem('userId') || '',
@@ -71,6 +128,23 @@ type UserProfile = ExampleServiceTypes.Response.getUserProfile
 
 ## 开发
 
+### 添加新服务
+
+1. **创建 types.ts 文件**
+   ```bash
+   # 在对应平台和模块目录下创建 types.ts
+   # 例如：src/bff/modules/miniprogram/product/types.ts
+   ```
+
+2. **生成服务代码**
+   ```bash
+   # ⚠️ 必须在 packages/sdk 目录下运行
+   cd packages/sdk
+   npm run generate miniprogram/product
+   ```
+
+### 其他命令
+
 ```bash
 # 构建
 npm run build
@@ -85,6 +159,8 @@ npm run build:swagger
 npm test
 ```
 
+详细的生成器使用说明请查看：[Generator README](./scripts/generator/README.md)
+
 ## 文档
 
 - [目录结构说明](./DIRECTORY_STRUCTURE.md) - 项目目录结构和组织方式
@@ -92,6 +168,7 @@ npm test
 - [Swagger 文档](./SWAGGER.md) - API 文档生成和使用指南
 - [类型兼容性](./TYPES_COMPATIBILITY.md) - 类型定义和兼容性说明
 - [SDK vs Server](./SDK_VS_SERVER.md) - SDK 和 Server 的区别
+- [TSOA Transformer](./TSOA_TRANSFORMER.md) - TypeScript 装饰器移除机制说明
 
 ## API 文档
 

package/cjs/bff/modules/BaseService.d.ts

@@ -6,7 +6,7 @@ import { HttpClient } from '../request/client';
  */
 export default abstract class BaseService {
     /**
-     * 服务的 URL 前缀路径（例如 '/api/v1/user'）
+     * 服务的 URL 前缀路径（例如 '/miniprogram/user' 或 '/pandora/user'）
      * 必须由子类定义
      */
     protected abstract prefixUrl: string;

package/cjs/bff/modules/miniprogram/demo/service.d.ts

@@ -0,0 +1,16 @@
+import { Service } from './types';
+import BaseService from '../../BaseService';
+import type { StandardResponse } from '../../../../types';
+/**
+ * DemoService - Demo 服务模块
+ * 提供 Demo 相关的 API 方法
+ */
+export declare class MiniProgramDemoService extends BaseService {
+    protected prefixUrl: string;
+    /**
+     * 示例接口
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    demoFunc(request: Service.Request.demoFunc): Promise<StandardResponse<Service.Response.demoFunc>>;
+}

package/cjs/bff/modules/{demo → miniprogram/demo}/service.js

@@ -3,28 +3,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const BaseService_1 = __importDefault(require("../BaseService"));
+exports.MiniProgramDemoService = void 0;
+const BaseService_1 = __importDefault(require("../../BaseService"));
 /**
  * DemoService - Demo 服务模块
  * 提供 Demo 相关的 API 方法
  */
-class DemoService extends BaseService_1.default {
+class MiniProgramDemoService extends BaseService_1.default {
     constructor() {
         super(...arguments);
-        this.prefixUrl = '/demo';
+        this.prefixUrl = '/miniprogram/demo';
     }
     /**
-     * Demo 方法
+     * 示例接口
      * @param request - 请求参数
      * @returns Promise，解析为标准响应格式
-     * @example
-     * const result = await sdk.demo.demoFunc({ demoParam: 'test' })
-     * console.log(result.data)       // 业务数据
-     * console.log(result.message)    // 响应消息
-     * console.log(result.requestId)  // 请求 ID
      */
     demoFunc(request) {
         return this.request(this.demoFunc, request);
     }
 }
-exports.default = DemoService;
+exports.MiniProgramDemoService = MiniProgramDemoService;

package/cjs/bff/modules/pandora/example/service.d.ts

@@ -0,0 +1,29 @@
+import { Service } from './types';
+import BaseService from '../../BaseService';
+import type { StandardResponse } from '../../../../types';
+/**
+ * PandoraExampleService - Pandora Example 服务模块
+ * 提供 Pandora Example 相关的 API 方法
+ * 平台: pandora
+ */
+export declare class PandoraExampleService extends BaseService {
+    protected prefixUrl: string;
+    /**
+     * 获取用户资料
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getUserProfile(request: Service.Request.getUserProfile): Promise<StandardResponse<Service.Response.getUserProfile>>;
+    /**
+     * 更新用户资料
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    updateProfile(request: Service.Request.updateProfile): Promise<StandardResponse<Service.Response.updateProfile>>;
+    /**
+     * 获取订单列表
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getOrderList(request: Service.Request.getOrderList): Promise<StandardResponse<Service.Response.getOrderList>>;
+}

package/cjs/bff/modules/pandora/example/service.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PandoraExampleService = void 0;
+const BaseService_1 = __importDefault(require("../../BaseService"));
+/**
+ * PandoraExampleService - Pandora Example 服务模块
+ * 提供 Pandora Example 相关的 API 方法
+ * 平台: pandora
+ */
+class PandoraExampleService extends BaseService_1.default {
+    constructor() {
+        super(...arguments);
+        this.prefixUrl = '/pandora/example';
+    }
+    /**
+     * 获取用户资料
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getUserProfile(request) {
+        return this.request(this.getUserProfile, request);
+    }
+    /**
+     * 更新用户资料
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    updateProfile(request) {
+        return this.request(this.updateProfile, request);
+    }
+    /**
+     * 获取订单列表
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getOrderList(request) {
+        return this.request(this.getOrderList, request);
+    }
+}
+exports.PandoraExampleService = PandoraExampleService;

package/cjs/index.d.ts

@@ -1,56 +1,47 @@
-import { ExampleService } from './bff/modules/example/service';
-import DemoService from './bff/modules/demo/service';
+import { PandoraExampleService } from './bff/modules/pandora/example/service';
+import { MiniProgramDemoService } from './bff/modules/miniprogram/demo/service';
 import type { SdkOptions } from './types';
 /**
- * EcommerceBackendBffSDK - 统一平台 SDK 的主入口
- * 支持 Web/H5 和微信小程序环境
- *
- * @example
- * ```typescript
- * // Web/H5 环境 - 生产环境
- * const sdk = new EcommerceBackendBffSDK({
- *   getToken: async () => localStorage.getItem('token') || '',
- *   getUserId: async () => localStorage.getItem('userId') || '',
- *   getRoleId: async () => localStorage.getItem('roleId') || '',
- *   environment: 'production'
- * })
- *
- * // 小程序环境 - 测试环境
- * const sdk = new EcommerceBackendBffSDK({
- *   getToken: async () => wx.getStorageSync('token') || '',
- *   getUserId: async () => wx.getStorageSync('userId') || '',
- *   getRoleId: async () => wx.getStorageSync('roleId') || '',
- *   environment: 'test'
- * })
- *
- * // 使用服务模块
- * const profile = await sdk.example.getUserProfile('user123')
- * const demoResult = await sdk.demo.demoFunc({ demoParam: 'test' })
- * ```
+ * Pandora 平台 SDK（管理后台）
+ * 包含所有 Pandora 平台相关的服务
  */
-export declare class EcommerceBackendBffSDK {
+export declare class PandoraSDK {
     /**
      * HttpClient 实例，管理平台特定的请求策略
      */
     private http;
     /**
-     * 示例服务模块，演示 SDK 使用模式
+     * Pandora 示例服务模块
      */
-    example: ExampleService;
+    example: PandoraExampleService;
     /**
-     * Demo 服务模块（从旧版 config 服务迁移而来）
+     * 使用配置选项初始化 Pandora SDK
+     * @param options - SDK 配置，包含凭证回调函数
+     */
+    constructor(options: SdkOptions);
+}
+/**
+ * 小程序平台 SDK
+ * 包含所有小程序平台相关的服务
+ */
+export declare class MiniProgramSDK {
+    /**
+     * HttpClient 实例，管理平台特定的请求策略
+     */
+    private http;
+    /**
+     * 小程序 Demo 服务模块
      */
-    demo: DemoService;
+    demo: MiniProgramDemoService;
     /**
-     * 使用配置选项初始化 SDK
+     * 使用配置选项初始化小程序 SDK
      * @param options - SDK 配置，包含凭证回调函数
      */
     constructor(options: SdkOptions);
 }
-export { default as DemoService } from './bff/modules/demo/service';
-export { ExampleService } from './bff/modules/example/service';
-export type { Service as DemoControllerTypes } from './bff/modules/demo/types';
-export type { Service as EcommerceBackendBffServiceControllerTypes } from './bff/modules/demo/types';
-export type { Service as ExampleServiceTypes } from './bff/modules/example/types';
 export { SdkError, BizError, SystemError } from './errors';
 export type { SdkOptions, IRequestStrategy, StandardResponse } from './types';
+export { MiniProgramDemoService } from './bff/modules/miniprogram/demo/service';
+export { PandoraExampleService } from './bff/modules/pandora/example/service';
+export type { Service as MiniProgramDemoTypes } from './bff/modules/miniprogram/demo/types';
+export type { Service as PandoraExampleTypes } from './bff/modules/pandora/example/types';

package/cjs/index.js

@@ -1,60 +1,51 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SystemError = exports.BizError = exports.SdkError = exports.ExampleService = exports.DemoService = exports.EcommerceBackendBffSDK = void 0;
+exports.PandoraExampleService = exports.MiniProgramDemoService = exports.SystemError = exports.BizError = exports.SdkError = exports.MiniProgramSDK = exports.PandoraSDK = void 0;
 const client_1 = require("./bff/request/client");
-const service_1 = require("./bff/modules/example/service");
-const service_2 = __importDefault(require("./bff/modules/demo/service"));
+const service_1 = require("./bff/modules/pandora/example/service");
+const service_2 = require("./bff/modules/miniprogram/demo/service");
 /**
- * EcommerceBackendBffSDK - 统一平台 SDK 的主入口
- * 支持 Web/H5 和微信小程序环境
- *
- * @example
- * ```typescript
- * // Web/H5 环境 - 生产环境
- * const sdk = new EcommerceBackendBffSDK({
- *   getToken: async () => localStorage.getItem('token') || '',
- *   getUserId: async () => localStorage.getItem('userId') || '',
- *   getRoleId: async () => localStorage.getItem('roleId') || '',
- *   environment: 'production'
- * })
- *
- * // 小程序环境 - 测试环境
- * const sdk = new EcommerceBackendBffSDK({
- *   getToken: async () => wx.getStorageSync('token') || '',
- *   getUserId: async () => wx.getStorageSync('userId') || '',
- *   getRoleId: async () => wx.getStorageSync('roleId') || '',
- *   environment: 'test'
- * })
- *
- * // 使用服务模块
- * const profile = await sdk.example.getUserProfile('user123')
- * const demoResult = await sdk.demo.demoFunc({ demoParam: 'test' })
- * ```
+ * Pandora 平台 SDK（管理后台）
+ * 包含所有 Pandora 平台相关的服务
  */
-class EcommerceBackendBffSDK {
+class PandoraSDK {
     /**
-     * 使用配置选项初始化 SDK
+     * 使用配置选项初始化 Pandora SDK
      * @param options - SDK 配置，包含凭证回调函数
      */
     constructor(options) {
         // 使用提供的选项初始化 HttpClient
         this.http = new client_1.HttpClient(options);
-        // 使用 HttpClient 实例化所有服务模块
-        this.example = new service_1.ExampleService(this.http);
-        this.demo = new service_2.default(this.http);
+        // 使用 HttpClient 实例化所有 Pandora 服务模块
+        this.example = new service_1.PandoraExampleService(this.http);
     }
 }
-exports.EcommerceBackendBffSDK = EcommerceBackendBffSDK;
-// 导出服务类以便直接实例化（如需要）
-var service_3 = require("./bff/modules/demo/service");
-Object.defineProperty(exports, "DemoService", { enumerable: true, get: function () { return __importDefault(service_3).default; } });
-var service_4 = require("./bff/modules/example/service");
-Object.defineProperty(exports, "ExampleService", { enumerable: true, get: function () { return service_4.ExampleService; } });
+exports.PandoraSDK = PandoraSDK;
+/**
+ * 小程序平台 SDK
+ * 包含所有小程序平台相关的服务
+ */
+class MiniProgramSDK {
+    /**
+     * 使用配置选项初始化小程序 SDK
+     * @param options - SDK 配置，包含凭证回调函数
+     */
+    constructor(options) {
+        // 使用提供的选项初始化 HttpClient
+        this.http = new client_1.HttpClient(options);
+        // 使用 HttpClient 实例化所有小程序服务模块
+        this.demo = new service_2.MiniProgramDemoService(this.http);
+    }
+}
+exports.MiniProgramSDK = MiniProgramSDK;
+// ==================== 导出 ====================
 // 错误类
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "SdkError", { enumerable: true, get: function () { return errors_1.SdkError; } });
 Object.defineProperty(exports, "BizError", { enumerable: true, get: function () { return errors_1.BizError; } });
 Object.defineProperty(exports, "SystemError", { enumerable: true, get: function () { return errors_1.SystemError; } });
+// 服务类（按平台分组）
+var service_3 = require("./bff/modules/miniprogram/demo/service");
+Object.defineProperty(exports, "MiniProgramDemoService", { enumerable: true, get: function () { return service_3.MiniProgramDemoService; } });
+var service_4 = require("./bff/modules/pandora/example/service");
+Object.defineProperty(exports, "PandoraExampleService", { enumerable: true, get: function () { return service_4.PandoraExampleService; } });

package/esm/bff/modules/BaseService.d.ts

@@ -6,7 +6,7 @@ import { HttpClient } from '../request/client';
  */
 export default abstract class BaseService {
     /**
-     * 服务的 URL 前缀路径（例如 '/api/v1/user'）
+     * 服务的 URL 前缀路径（例如 '/miniprogram/user' 或 '/pandora/user'）
      * 必须由子类定义
      */
     protected abstract prefixUrl: string;

package/esm/bff/modules/miniprogram/demo/service.d.ts

@@ -0,0 +1,16 @@
+import { Service } from './types';
+import BaseService from '../../BaseService';
+import type { StandardResponse } from '../../../../types';
+/**
+ * DemoService - Demo 服务模块
+ * 提供 Demo 相关的 API 方法
+ */
+export declare class MiniProgramDemoService extends BaseService {
+    protected prefixUrl: string;
+    /**
+     * 示例接口
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    demoFunc(request: Service.Request.demoFunc): Promise<StandardResponse<Service.Response.demoFunc>>;
+}

package/esm/bff/modules/miniprogram/demo/service.mjs

@@ -0,0 +1,19 @@
+import BaseService from '../../BaseService.mjs';
+/**
+ * DemoService - Demo 服务模块
+ * 提供 Demo 相关的 API 方法
+ */
+export class MiniProgramDemoService extends BaseService {
+    constructor() {
+        super(...arguments);
+        this.prefixUrl = '/miniprogram/demo';
+    }
+    /**
+     * 示例接口
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    demoFunc(request) {
+        return this.request(this.demoFunc, request);
+    }
+}

package/esm/bff/modules/pandora/example/service.d.ts

@@ -0,0 +1,29 @@
+import { Service } from './types';
+import BaseService from '../../BaseService';
+import type { StandardResponse } from '../../../../types';
+/**
+ * PandoraExampleService - Pandora Example 服务模块
+ * 提供 Pandora Example 相关的 API 方法
+ * 平台: pandora
+ */
+export declare class PandoraExampleService extends BaseService {
+    protected prefixUrl: string;
+    /**
+     * 获取用户资料
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getUserProfile(request: Service.Request.getUserProfile): Promise<StandardResponse<Service.Response.getUserProfile>>;
+    /**
+     * 更新用户资料
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    updateProfile(request: Service.Request.updateProfile): Promise<StandardResponse<Service.Response.updateProfile>>;
+    /**
+     * 获取订单列表
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getOrderList(request: Service.Request.getOrderList): Promise<StandardResponse<Service.Response.getOrderList>>;
+}

package/esm/bff/modules/pandora/example/service.mjs

@@ -0,0 +1,36 @@
+import BaseService from '../../BaseService.mjs';
+/**
+ * PandoraExampleService - Pandora Example 服务模块
+ * 提供 Pandora Example 相关的 API 方法
+ * 平台: pandora
+ */
+export class PandoraExampleService extends BaseService {
+    constructor() {
+        super(...arguments);
+        this.prefixUrl = '/pandora/example';
+    }
+    /**
+     * 获取用户资料
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getUserProfile(request) {
+        return this.request(this.getUserProfile, request);
+    }
+    /**
+     * 更新用户资料
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    updateProfile(request) {
+        return this.request(this.updateProfile, request);
+    }
+    /**
+     * 获取订单列表
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getOrderList(request) {
+        return this.request(this.getOrderList, request);
+    }
+}

package/esm/index.d.ts

@@ -1,56 +1,47 @@
-import { ExampleService } from './bff/modules/example/service';
-import DemoService from './bff/modules/demo/service';
+import { PandoraExampleService } from './bff/modules/pandora/example/service';
+import { MiniProgramDemoService } from './bff/modules/miniprogram/demo/service';
 import type { SdkOptions } from './types';
 /**
- * EcommerceBackendBffSDK - 统一平台 SDK 的主入口
- * 支持 Web/H5 和微信小程序环境
- *
- * @example
- * ```typescript
- * // Web/H5 环境 - 生产环境
- * const sdk = new EcommerceBackendBffSDK({
- *   getToken: async () => localStorage.getItem('token') || '',
- *   getUserId: async () => localStorage.getItem('userId') || '',
- *   getRoleId: async () => localStorage.getItem('roleId') || '',
- *   environment: 'production'
- * })
- *
- * // 小程序环境 - 测试环境
- * const sdk = new EcommerceBackendBffSDK({
- *   getToken: async () => wx.getStorageSync('token') || '',
- *   getUserId: async () => wx.getStorageSync('userId') || '',
- *   getRoleId: async () => wx.getStorageSync('roleId') || '',
- *   environment: 'test'
- * })
- *
- * // 使用服务模块
- * const profile = await sdk.example.getUserProfile('user123')
- * const demoResult = await sdk.demo.demoFunc({ demoParam: 'test' })
- * ```
+ * Pandora 平台 SDK（管理后台）
+ * 包含所有 Pandora 平台相关的服务
  */
-export declare class EcommerceBackendBffSDK {
+export declare class PandoraSDK {
     /**
      * HttpClient 实例，管理平台特定的请求策略
      */
     private http;
     /**
-     * 示例服务模块，演示 SDK 使用模式
+     * Pandora 示例服务模块
      */
-    example: ExampleService;
+    example: PandoraExampleService;
     /**
-     * Demo 服务模块（从旧版 config 服务迁移而来）
+     * 使用配置选项初始化 Pandora SDK
+     * @param options - SDK 配置，包含凭证回调函数
+     */
+    constructor(options: SdkOptions);
+}
+/**
+ * 小程序平台 SDK
+ * 包含所有小程序平台相关的服务
+ */
+export declare class MiniProgramSDK {
+    /**
+     * HttpClient 实例，管理平台特定的请求策略
+     */
+    private http;
+    /**
+     * 小程序 Demo 服务模块
      */
-    demo: DemoService;
+    demo: MiniProgramDemoService;
     /**
-     * 使用配置选项初始化 SDK
+     * 使用配置选项初始化小程序 SDK
      * @param options - SDK 配置，包含凭证回调函数
      */
     constructor(options: SdkOptions);
 }
-export { default as DemoService } from './bff/modules/demo/service';
-export { ExampleService } from './bff/modules/example/service';
-export type { Service as DemoControllerTypes } from './bff/modules/demo/types';
-export type { Service as EcommerceBackendBffServiceControllerTypes } from './bff/modules/demo/types';
-export type { Service as ExampleServiceTypes } from './bff/modules/example/types';
 export { SdkError, BizError, SystemError } from './errors';
 export type { SdkOptions, IRequestStrategy, StandardResponse } from './types';
+export { MiniProgramDemoService } from './bff/modules/miniprogram/demo/service';
+export { PandoraExampleService } from './bff/modules/pandora/example/service';
+export type { Service as MiniProgramDemoTypes } from './bff/modules/miniprogram/demo/types';
+export type { Service as PandoraExampleTypes } from './bff/modules/pandora/example/types';

package/esm/index.mjs

@@ -1,48 +1,41 @@
 import { HttpClient } from './bff/request/client.mjs';
-import { ExampleService } from './bff/modules/example/service.mjs';
-import DemoService from './bff/modules/demo/service.mjs';
+import { PandoraExampleService } from './bff/modules/pandora/example/service.mjs';
+import { MiniProgramDemoService } from './bff/modules/miniprogram/demo/service.mjs';
 /**
- * EcommerceBackendBffSDK - 统一平台 SDK 的主入口
- * 支持 Web/H5 和微信小程序环境
- *
- * @example
- * ```typescript
- * // Web/H5 环境 - 生产环境
- * const sdk = new EcommerceBackendBffSDK({
- *   getToken: async () => localStorage.getItem('token') || '',
- *   getUserId: async () => localStorage.getItem('userId') || '',
- *   getRoleId: async () => localStorage.getItem('roleId') || '',
- *   environment: 'production'
- * })
- *
- * // 小程序环境 - 测试环境
- * const sdk = new EcommerceBackendBffSDK({
- *   getToken: async () => wx.getStorageSync('token') || '',
- *   getUserId: async () => wx.getStorageSync('userId') || '',
- *   getRoleId: async () => wx.getStorageSync('roleId') || '',
- *   environment: 'test'
- * })
- *
- * // 使用服务模块
- * const profile = await sdk.example.getUserProfile('user123')
- * const demoResult = await sdk.demo.demoFunc({ demoParam: 'test' })
- * ```
+ * Pandora 平台 SDK（管理后台）
+ * 包含所有 Pandora 平台相关的服务
  */
-export class EcommerceBackendBffSDK {
+export class PandoraSDK {
     /**
-     * 使用配置选项初始化 SDK
+     * 使用配置选项初始化 Pandora SDK
      * @param options - SDK 配置，包含凭证回调函数
      */
     constructor(options) {
         // 使用提供的选项初始化 HttpClient
         this.http = new HttpClient(options);
-        // 使用 HttpClient 实例化所有服务模块
-        this.example = new ExampleService(this.http);
-        this.demo = new DemoService(this.http);
+        // 使用 HttpClient 实例化所有 Pandora 服务模块
+        this.example = new PandoraExampleService(this.http);
     }
 }
-// 导出服务类以便直接实例化（如需要）
-export { default as DemoService } from './bff/modules/demo/service.mjs';
-export { ExampleService } from './bff/modules/example/service.mjs';
+/**
+ * 小程序平台 SDK
+ * 包含所有小程序平台相关的服务
+ */
+export class MiniProgramSDK {
+    /**
+     * 使用配置选项初始化小程序 SDK
+     * @param options - SDK 配置，包含凭证回调函数
+     */
+    constructor(options) {
+        // 使用提供的选项初始化 HttpClient
+        this.http = new HttpClient(options);
+        // 使用 HttpClient 实例化所有小程序服务模块
+        this.demo = new MiniProgramDemoService(this.http);
+    }
+}
+// ==================== 导出 ====================
 // 错误类
 export { SdkError, BizError, SystemError } from './errors/index.mjs';
+// 服务类（按平台分组）
+export { MiniProgramDemoService } from './bff/modules/miniprogram/demo/service.mjs';
+export { PandoraExampleService } from './bff/modules/pandora/example/service.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@be-link/ecommerce-backend-bff-service-node-sdk",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "EcommerceBackendBffService Node.js SDK",
   "type": "commonjs",
   "main": "./cjs/index.js",
@@ -28,6 +28,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "tsoa": "^6.4.0",
     "typescript": "^5.0.0"
   }
 }

package/cjs/bff/modules/demo/service.d.ts

@@ -1,22 +0,0 @@
-import { Service } from './types';
-import BaseService from '../BaseService';
-import type { StandardResponse } from '../../../types';
-/**
- * DemoService - Demo 服务模块
- * 提供 Demo 相关的 API 方法
- */
-declare class DemoService extends BaseService {
-    protected prefixUrl: string;
-    /**
-     * Demo 方法
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式
-     * @example
-     * const result = await sdk.demo.demoFunc({ demoParam: 'test' })
-     * console.log(result.data)       // 业务数据
-     * console.log(result.message)    // 响应消息
-     * console.log(result.requestId)  // 请求 ID
-     */
-    demoFunc(request: Service.Request.demoFunc): Promise<StandardResponse<Service.Response.demoFunc>>;
-}
-export default DemoService;

package/cjs/bff/modules/example/service.d.ts

@@ -1,46 +0,0 @@
-import BaseService from '../BaseService';
-import type { StandardResponse } from '../../../types';
-import { Service } from './types';
-/**
- * ExampleService - 演示如何创建服务模块
- * 此服务提供用户资料和订单管理的示例方法
- */
-export declare class ExampleService extends BaseService {
-    /**
-     * 此服务的 API 路径前缀
-     * 此服务中的所有方法都将使用此前缀
-     */
-    protected prefixUrl: string;
-    /**
-     * 根据 ID 获取用户资料
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式，包含用户资料数据
-     * @example
-     * const result = await exampleService.getUserProfile({ id: 'user123' })
-     * console.log(result.data)       // 用户资料数据
-     * console.log(result.message)    // 响应消息
-     * console.log(result.requestId)  // 请求 ID
-     */
-    getUserProfile(request: Service.Request.getUserProfile): Promise<StandardResponse<Service.Response.getUserProfile>>;
-    /**
-     * 更新用户资料
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式
-     * @example
-     * const result = await exampleService.updateProfile({ name: 'John Doe', email: 'john@example.com' })
-     * console.log(result.message)    // 'success'
-     * console.log(result.success)    // true
-     */
-    updateProfile(request: Service.Request.updateProfile): Promise<StandardResponse<Service.Response.updateProfile>>;
-    /**
-     * 获取分页订单列表
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式，包含订单列表数据
-     * @example
-     * const result = await exampleService.getOrderList({ page: 1, pageSize: 20 })
-     * console.log(result.data.orders)  // 订单列表
-     * console.log(result.data.total)   // 总数
-     * console.log(result.requestId)    // 请求 ID
-     */
-    getOrderList(request: Service.Request.getOrderList): Promise<StandardResponse<Service.Response.getOrderList>>;
-}

package/cjs/bff/modules/example/service.js

@@ -1,60 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExampleService = void 0;
-const BaseService_1 = __importDefault(require("../BaseService"));
-/**
- * ExampleService - 演示如何创建服务模块
- * 此服务提供用户资料和订单管理的示例方法
- */
-class ExampleService extends BaseService_1.default {
-    constructor() {
-        super(...arguments);
-        /**
-         * 此服务的 API 路径前缀
-         * 此服务中的所有方法都将使用此前缀
-         */
-        this.prefixUrl = '/api/v1/user';
-    }
-    /**
-     * 根据 ID 获取用户资料
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式，包含用户资料数据
-     * @example
-     * const result = await exampleService.getUserProfile({ id: 'user123' })
-     * console.log(result.data)       // 用户资料数据
-     * console.log(result.message)    // 响应消息
-     * console.log(result.requestId)  // 请求 ID
-     */
-    async getUserProfile(request) {
-        return this.request(this.getUserProfile, request);
-    }
-    /**
-     * 更新用户资料
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式
-     * @example
-     * const result = await exampleService.updateProfile({ name: 'John Doe', email: 'john@example.com' })
-     * console.log(result.message)    // 'success'
-     * console.log(result.success)    // true
-     */
-    async updateProfile(request) {
-        return this.request(this.updateProfile, request);
-    }
-    /**
-     * 获取分页订单列表
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式，包含订单列表数据
-     * @example
-     * const result = await exampleService.getOrderList({ page: 1, pageSize: 20 })
-     * console.log(result.data.orders)  // 订单列表
-     * console.log(result.data.total)   // 总数
-     * console.log(result.requestId)    // 请求 ID
-     */
-    async getOrderList(request) {
-        return this.request(this.getOrderList, request);
-    }
-}
-exports.ExampleService = ExampleService;

package/esm/bff/modules/demo/service.d.ts

@@ -1,22 +0,0 @@
-import { Service } from './types';
-import BaseService from '../BaseService';
-import type { StandardResponse } from '../../../types';
-/**
- * DemoService - Demo 服务模块
- * 提供 Demo 相关的 API 方法
- */
-declare class DemoService extends BaseService {
-    protected prefixUrl: string;
-    /**
-     * Demo 方法
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式
-     * @example
-     * const result = await sdk.demo.demoFunc({ demoParam: 'test' })
-     * console.log(result.data)       // 业务数据
-     * console.log(result.message)    // 响应消息
-     * console.log(result.requestId)  // 请求 ID
-     */
-    demoFunc(request: Service.Request.demoFunc): Promise<StandardResponse<Service.Response.demoFunc>>;
-}
-export default DemoService;

package/esm/bff/modules/demo/service.mjs

@@ -1,25 +0,0 @@
-import BaseService from '../BaseService.mjs';
-/**
- * DemoService - Demo 服务模块
- * 提供 Demo 相关的 API 方法
- */
-class DemoService extends BaseService {
-    constructor() {
-        super(...arguments);
-        this.prefixUrl = '/demo';
-    }
-    /**
-     * Demo 方法
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式
-     * @example
-     * const result = await sdk.demo.demoFunc({ demoParam: 'test' })
-     * console.log(result.data)       // 业务数据
-     * console.log(result.message)    // 响应消息
-     * console.log(result.requestId)  // 请求 ID
-     */
-    demoFunc(request) {
-        return this.request(this.demoFunc, request);
-    }
-}
-export default DemoService;

package/esm/bff/modules/example/service.d.ts

@@ -1,46 +0,0 @@
-import BaseService from '../BaseService';
-import type { StandardResponse } from '../../../types';
-import { Service } from './types';
-/**
- * ExampleService - 演示如何创建服务模块
- * 此服务提供用户资料和订单管理的示例方法
- */
-export declare class ExampleService extends BaseService {
-    /**
-     * 此服务的 API 路径前缀
-     * 此服务中的所有方法都将使用此前缀
-     */
-    protected prefixUrl: string;
-    /**
-     * 根据 ID 获取用户资料
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式，包含用户资料数据
-     * @example
-     * const result = await exampleService.getUserProfile({ id: 'user123' })
-     * console.log(result.data)       // 用户资料数据
-     * console.log(result.message)    // 响应消息
-     * console.log(result.requestId)  // 请求 ID
-     */
-    getUserProfile(request: Service.Request.getUserProfile): Promise<StandardResponse<Service.Response.getUserProfile>>;
-    /**
-     * 更新用户资料
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式
-     * @example
-     * const result = await exampleService.updateProfile({ name: 'John Doe', email: 'john@example.com' })
-     * console.log(result.message)    // 'success'
-     * console.log(result.success)    // true
-     */
-    updateProfile(request: Service.Request.updateProfile): Promise<StandardResponse<Service.Response.updateProfile>>;
-    /**
-     * 获取分页订单列表
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式，包含订单列表数据
-     * @example
-     * const result = await exampleService.getOrderList({ page: 1, pageSize: 20 })
-     * console.log(result.data.orders)  // 订单列表
-     * console.log(result.data.total)   // 总数
-     * console.log(result.requestId)    // 请求 ID
-     */
-    getOrderList(request: Service.Request.getOrderList): Promise<StandardResponse<Service.Response.getOrderList>>;
-}

package/esm/bff/modules/example/service.mjs

@@ -1,53 +0,0 @@
-import BaseService from '../BaseService.mjs';
-/**
- * ExampleService - 演示如何创建服务模块
- * 此服务提供用户资料和订单管理的示例方法
- */
-export class ExampleService extends BaseService {
-    constructor() {
-        super(...arguments);
-        /**
-         * 此服务的 API 路径前缀
-         * 此服务中的所有方法都将使用此前缀
-         */
-        this.prefixUrl = '/api/v1/user';
-    }
-    /**
-     * 根据 ID 获取用户资料
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式，包含用户资料数据
-     * @example
-     * const result = await exampleService.getUserProfile({ id: 'user123' })
-     * console.log(result.data)       // 用户资料数据
-     * console.log(result.message)    // 响应消息
-     * console.log(result.requestId)  // 请求 ID
-     */
-    async getUserProfile(request) {
-        return this.request(this.getUserProfile, request);
-    }
-    /**
-     * 更新用户资料
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式
-     * @example
-     * const result = await exampleService.updateProfile({ name: 'John Doe', email: 'john@example.com' })
-     * console.log(result.message)    // 'success'
-     * console.log(result.success)    // true
-     */
-    async updateProfile(request) {
-        return this.request(this.updateProfile, request);
-    }
-    /**
-     * 获取分页订单列表
-     * @param request - 请求参数
-     * @returns Promise，解析为标准响应格式，包含订单列表数据
-     * @example
-     * const result = await exampleService.getOrderList({ page: 1, pageSize: 20 })
-     * console.log(result.data.orders)  // 订单列表
-     * console.log(result.data.total)   // 总数
-     * console.log(result.requestId)    // 请求 ID
-     */
-    async getOrderList(request) {
-        return this.request(this.getOrderList, request);
-    }
-}