n8n-nodes-kuaimai 1.0.0

package/README.md

@@ -0,0 +1,356 @@
+# n8n-nodes-kuaimai
+
+快麦ERP开放平台的 n8n 社区节点，实现与快麦ERP系统的API集成。
+
+[![npm version](https://img.shields.io/npm/v/n8n-nodes-kuaimai.svg)](https://www.npmjs.com/package/n8n-nodes-kuaimai)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 📋 目录
+
+- [特性](#特性)
+- [安装](#安装)
+- [快速开始](#快速开始)
+- [配置说明](#配置说明)
+- [支持的操作](#支持的操作)
+- [开发指南](#开发指南)
+- [常见问题](#常见问题)
+- [许可证](#许可证)
+
+## ✨ 特性
+
+- ✅ **完整的 API 支持**：基于快麦开放平台官方文档实现
+- 🔐 **安全认证**：支持 HMAC-MD5、MD5、HMAC-SHA256 签名算法
+- 🔄 **会话管理**：自动处理 Token 刷新（30天有效期）
+- 📦 **资源管理**：订单、商品、仓库、基础数据查询
+- 🎯 **易于使用**：可视化配置，无需编写代码
+- 🚀 **Docker 部署**：提供完整的 Docker Compose 配置
+
+## 📦 安装
+
+### 方式一：Docker Compose（推荐）
+
+#### 快速开始
+
+1. **获取 GitHub Token**
+
+访问 [GitHub Settings](https://github.com/settings/tokens) 创建一个带有 `read:packages` 权限的 Personal Access Token。
+
+2. **配置环境变量**
+
+```bash
+# 复制环境变量模板
+cp .env.example .env
+
+# 编辑 .env 文件，填入你的 GitHub Token
+```
+
+3. **启动服务**
+
+```bash
+# 启动 n8n 和 PostgreSQL
+docker-compose up -d
+
+# 查看日志
+docker-compose logs -f n8n
+```
+
+4. **访问 n8n**
+
+打开浏览器访问 http://localhost:5678
+
+详细部署说明请参考 [QUICKSTART.md](./QUICKSTART.md) 和 [DOCKER_DEPLOYMENT.md](./DOCKER_DEPLOYMENT.md)。
+
+### 方式二：npm 安装
+
+```bash
+npm install @gabrielsworld/n8n-node-kuaimai --registry=https://npm.pkg.github.com
+```
+
+## 🚀 快速开始
+
+### 1. 获取快麦 API 凭证
+
+1. 联系快麦ERP销售或实施同学申请 API 权限
+2. 访问 [快麦开放平台](https://open.kuaimai.com/applyApp) 填写申请表
+3. 审核通过后，您将收到包含以下信息的邮件：
+   - **App Key**
+   - **App Secret**
+   - **Access Token**
+   - **Refresh Token**
+
+### 2. 在 n8n 中配置凭证
+
+1. 在 n8n 中打开 **Credentials** 页面
+2. 点击 **New Credential**
+3. 搜索并选择 **快麦ERP API**
+4. 填入从邮件中获取的凭证信息：
+
+| 字段          | 说明                   | 示例               |
+| ------------- | ---------------------- | ------------------ |
+| App Key       | 开放平台分配的应用密钥 | `123456`           |
+| App Secret    | 开放平台分配的应用秘钥 | `helloworld`       |
+| Access Token  | 访问令牌（session）    | `xxxx-xxxx-xxxx`   |
+| Refresh Token | 刷新令牌               | `yyyy-yyyy-yyyy`   |
+| 签名方法      | 签名算法               | `HMAC-MD5`（推荐） |
+| API 环境      | 请求环境               | `V2正式环境`       |
+
+5. 点击 **Save**
+
+### 3. 使用节点
+
+在工作流中添加 **快麦ERP** 节点，选择要执行的操作：
+
+```
+快麦ERP 节点
+├── 基础
+│   ├── 刷新会话
+│   ├── 查询仓库列表
+│   └── 查询店铺列表
+├── 订单
+│   └── 查询订单列表
+├── 商品
+│   └── 查询商品列表
+└── 仓库
+    └── 查询库存
+```
+
+## ⚙️ 配置说明
+
+### 签名方法
+
+快麦开放平台支持三种签名算法：
+
+| 方法         | 说明                      | 安全性   | 推荐    |
+| ------------ | ------------------------- | -------- | ------- |
+| **HMAC-MD5** | HMAC 消息认证码（MD5）    | ⭐⭐⭐   | ✅ 推荐 |
+| MD5          | 简单 MD5 摘要             | ⭐⭐     | ⚠️      |
+| HMAC-SHA256  | HMAC 消息认证码（SHA256） | ⭐⭐⭐⭐ | ✅ 推荐 |
+
+### 会话管理
+
+- **有效期**：Access Token 有效期为 **30天**
+- **刷新**：必须在会话过期前调用 **刷新会话** 操作
+- **限制**：刷新接口每小时最多调用 1 次
+
+⚠️ **重要**：建议每月至少刷新一次会话，避免 Token 过期。
+
+### API 环境
+
+| 环境               | 地址                              | 说明                              |
+| ------------------ | --------------------------------- | --------------------------------- |
+| V2正式环境（推荐） | `https://gw.superboss.cc/router`  | 2022年4月1日后申请的 App Key 使用 |
+| V2内部专用         | `https://gw3.superboss.cc/router` | 内部测试使用                      |
+
+## 🔧 支持的操作
+
+### 基础操作
+
+#### 刷新会话
+
+延长 Access Token 有效期（30天）。
+
+**输入**：无需额外参数（使用凭证中的 Refresh Token）
+
+**输出**：
+
+```json
+{
+  "session": {
+    "accessToken": "新的访问令牌",
+    "refreshToken": "新的刷新令牌",
+    "expiresIn": 2592000,
+    "userId": 12345,
+    "companyId": 67890
+  }
+}
+```
+
+#### 查询仓库列表
+
+查询公司下的所有仓库。
+
+**API 方法**：`erp.warehouse.query`
+
+#### 查询店铺列表
+
+查询公司下的所有店铺。
+
+**API 方法**：`erp.shop.query`
+
+### 订单操作
+
+#### 查询订单列表
+
+查询非淘系/拼多多订单列表。
+
+**API 方法**：`erp.trade.list.query`
+
+**参数**：
+
+| 参数     | 类型     | 必填 | 说明                             |
+| -------- | -------- | ---- | -------------------------------- |
+| 时间类型 | 选项     | ✅   | `创建时间`/`更新时间`/`付款时间` |
+| 开始时间 | 日期时间 | ✅   | 查询起始时间                     |
+| 结束时间 | 日期时间 | ✅   | 查询结束时间                     |
+| 页码     | 数字     | ✅   | 从 1 开始                        |
+| 每页数量 | 数字     | ✅   | 1-100                            |
+
+**示例**：
+
+```javascript
+// 工作流配置
+{
+  "resource": "order",
+  "operation": "queryOrders",
+  "timeType": "upd_time",
+  "startTime": "2024-01-01 00:00:00",
+  "endTime": "2024-01-31 23:59:59",
+  "pageNo": 1,
+  "pageSize": 20
+}
+```
+
+### 商品操作
+
+#### 查询商品列表
+
+查询商品信息。
+
+**API 方法**：`erp.item.list.query`
+
+### 仓库操作
+
+#### 查询库存
+
+查询商品库存信息。
+
+**API 方法**：`erp.inventory.query`
+
+## 🛠️ 开发指南
+
+### 环境要求
+
+- Node.js >= 18.x
+- npm >= 8.x
+- TypeScript >= 5.x
+
+### 本地开发
+
+```bash
+# 克隆项目
+git clone https://github.com/gabrielsworld/n8n-nodes-kuaimai.git
+cd n8n-nodes-kuaimai
+
+# 安装依赖
+npm install
+
+# 开发模式（监听文件变化）
+npm run dev
+
+# 构建
+npm run build
+
+# 运行测试
+npm test
+
+# 代码检查
+npm run lint
+
+# 格式化代码
+npm run format
+```
+
+### 项目结构
+
+```
+├── credentials/              # 凭证定义
+│   └── KuaimaiCredentials.credentials.ts
+├── nodes/                    # 节点实现
+│   └── KuaimaiErp/
+│       ├── KuaimaiErp.node.ts         # 主节点
+│       ├── KuaimaiSignature.ts        # 签名工具
+│       └── kuaimai.svg                # 图标
+├── test/                     # 测试文件
+├── dist/                     # 构建输出
+├── docker-compose.yml        # Docker 开发环境
+├── docker-compose.prod.yml   # Docker 生产环境
+├── .env.example              # 环境变量模板
+└── package.json
+```
+
+### 添加新操作
+
+1. 在 `KuaimaiErp.node.ts` 中添加操作选项
+2. 添加对应的参数配置
+3. 在 `execute` 方法中实现业务逻辑
+4. 更新文档和测试
+
+详细开发指南请参考 [AGENTS.md](./AGENTS.md)。
+
+## ❓ 常见问题
+
+### 1. 节点不显示？
+
+**解决方案**：
+
+```bash
+# 检查日志
+docker-compose logs n8n | grep -i "custom"
+
+# 重启容器
+docker-compose restart n8n
+```
+
+### 2. 会话过期怎么办？
+
+如果 Access Token 过期（超过30天未刷新）：
+
+1. 联系快麦实施或客服
+2. 在问题群告知业务机器人
+3. 格式：`公司名称-开放平台刷新授权-appKey`
+
+### 3. 签名错误？
+
+常见原因：
+
+- App Secret 填写错误
+- 时间戳误差超过10分钟
+- 参数编码问题
+
+**调试工具**：使用 [快麦 API 测试工具](https://open.kuaimai.com/tools) 验证签名。
+
+### 4. 如何获取拼多多订单？
+
+拼多多订单需要单独接入自研接口，详见：
+[拼多多自研接口接入公告](https://open.kuaimai.com/docs/question/系统公告/拼多多自研接口接入开放公告)
+
+### 5. API 调用频率限制？
+
+- 刷新会话接口：每小时 1 次
+- 其他接口：具体限制请参考快麦开放平台文档
+
+## 📚 相关文档
+
+- [快速开始指南](./QUICKSTART.md)
+- [Docker 部署文档](./DOCKER_DEPLOYMENT.md)
+- [部署检查清单](./DEPLOYMENT_CHECKLIST.md)
+- [开发指南](./AGENTS.md)
+- [快麦开放平台官方文档](https://open.kuaimai.com/)
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 📄 许可证
+
+[MIT License](LICENSE)
+
+## 📞 支持
+
+- 📧 Email: gabrielsworld@github.com
+- 🐛 Issues: https://github.com/gabrielsworld/n8n-nodes-kuaimai/issues
+- 📖 文档: https://open.kuaimai.com/
+
+---
+
+**Made with ❤️ by gabrielsworld**

package/dist/credentials/KuaimaiCredentials.credentials.d.ts

@@ -0,0 +1,8 @@
+import { ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class KuaimaiCredentials implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    test: ICredentialTestRequest;
+}

package/dist/credentials/KuaimaiCredentials.credentials.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KuaimaiCredentials = void 0;
+class KuaimaiCredentials {
+    constructor() {
+        this.name = 'kuaimaiApi';
+        this.displayName = '快麦ERP API';
+        this.documentationUrl = 'https://open.kuaimai.com/docs/api/API对接说明/接入指南';
+        this.properties = [
+            {
+                displayName: 'App Key',
+                name: 'appKey',
+                type: 'string',
+                default: '',
+                required: true,
+                description: '快麦开放平台分配的 App Key',
+            },
+            {
+                displayName: 'App Secret',
+                name: 'appSecret',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: '快麦开放平台分配的 App Secret',
+            },
+            {
+                displayName: 'Access Token',
+                name: 'accessToken',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: '访问令牌（session），由快麦开放平台邮件提供',
+            },
+            {
+                displayName: 'Refresh Token',
+                name: 'refreshToken',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: '刷新令牌，用于延长会话有效期（30天）',
+            },
+            {
+                displayName: '签名方法',
+                name: 'signMethod',
+                type: 'options',
+                options: [
+                    {
+                        name: 'HMAC-MD5',
+                        value: 'hmac',
+                    },
+                    {
+                        name: 'MD5',
+                        value: 'md5',
+                    },
+                    {
+                        name: 'HMAC-SHA256',
+                        value: 'hmac-sha256',
+                    },
+                ],
+                default: 'hmac',
+                description: '签名摘要算法',
+            },
+            {
+                displayName: 'API 环境',
+                name: 'environment',
+                type: 'options',
+                options: [
+                    {
+                        name: 'V2正式环境',
+                        value: 'production',
+                    },
+                    {
+                        name: 'V2内部专用',
+                        value: 'internal',
+                    },
+                ],
+                default: 'production',
+                description: 'API 请求环境',
+            },
+        ];
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.environment === "internal" ? "https://gw3.superboss.cc" : "https://gw.superboss.cc"}}',
+                url: '/router',
+                method: 'POST',
+            },
+        };
+    }
+}
+exports.KuaimaiCredentials = KuaimaiCredentials;

package/dist/nodes/KuaimaiErp/KuaimaiErp.node.d.ts

@@ -0,0 +1,5 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class KuaimaiErp implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/KuaimaiErp/KuaimaiErp.node.js

@@ -0,0 +1,401 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KuaimaiErp = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const KuaimaiSignature_1 = require("./KuaimaiSignature");
+class KuaimaiErp {
+    constructor() {
+        this.description = {
+            displayName: '快麦ERP',
+            name: 'kuaimaiErp',
+            icon: 'file:kuaimai.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: '与快麦ERP开放平台API交互，进行订单、商品和库存管理',
+            defaults: {
+                name: '快麦ERP',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'kuaimaiApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: '资源类型',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: '基础',
+                            value: 'base',
+                        },
+                        {
+                            name: '订单',
+                            value: 'order',
+                        },
+                        {
+                            name: '商品',
+                            value: 'product',
+                        },
+                        {
+                            name: '仓库',
+                            value: 'warehouse',
+                        },
+                    ],
+                    default: 'base',
+                },
+                // ==================== 基础操作 ====================
+                {
+                    displayName: '操作',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['base'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: '刷新会话',
+                            value: 'refreshToken',
+                            description: '刷新会话 Token，延长30天有效期',
+                            action: 'Refresh session token',
+                        },
+                        {
+                            name: '查询仓库列表',
+                            value: 'listWarehouses',
+                            description: '查询公司下的仓库列表',
+                            action: 'List warehouses',
+                        },
+                        {
+                            name: '查询店铺列表',
+                            value: 'listShops',
+                            description: '查询公司下的店铺列表',
+                            action: 'List shops',
+                        },
+                    ],
+                    default: 'refreshToken',
+                },
+                // ==================== 订单操作 ====================
+                {
+                    displayName: '操作',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['order'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: '查询订单列表',
+                            value: 'queryOrders',
+                            description: '查询订单列表（非淘系/拼多多）',
+                            action: 'Query orders',
+                        },
+                    ],
+                    default: 'queryOrders',
+                },
+                // 订单查询参数
+                {
+                    displayName: '时间类型',
+                    name: 'timeType',
+                    type: 'options',
+                    displayOptions: {
+                        show: {
+                            resource: ['order'],
+                            operation: ['queryOrders'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: '创建时间',
+                            value: 'create_time',
+                        },
+                        {
+                            name: '更新时间',
+                            value: 'upd_time',
+                        },
+                        {
+                            name: '付款时间',
+                            value: 'pay_time',
+                        },
+                    ],
+                    default: 'upd_time',
+                    description: '查询订单的时间类型',
+                },
+                {
+                    displayName: '开始时间',
+                    name: 'startTime',
+                    type: 'dateTime',
+                    displayOptions: {
+                        show: {
+                            resource: ['order'],
+                            operation: ['queryOrders'],
+                        },
+                    },
+                    default: '',
+                    required: true,
+                    description: '查询开始时间',
+                },
+                {
+                    displayName: '结束时间',
+                    name: 'endTime',
+                    type: 'dateTime',
+                    displayOptions: {
+                        show: {
+                            resource: ['order'],
+                            operation: ['queryOrders'],
+                        },
+                    },
+                    default: '',
+                    required: true,
+                    description: '查询结束时间',
+                },
+                {
+                    displayName: '页码',
+                    name: 'pageNo',
+                    type: 'number',
+                    displayOptions: {
+                        show: {
+                            resource: ['order'],
+                            operation: ['queryOrders'],
+                        },
+                    },
+                    default: 1,
+                    description: '页码，从1开始',
+                },
+                {
+                    displayName: '每页数量',
+                    name: 'pageSize',
+                    type: 'number',
+                    displayOptions: {
+                        show: {
+                            resource: ['order'],
+                            operation: ['queryOrders'],
+                        },
+                    },
+                    default: 20,
+                    typeOptions: {
+                        minValue: 1,
+                        maxValue: 100,
+                    },
+                    description: '每页返回的记录数，最大100',
+                },
+                // ==================== 商品操作 ====================
+                {
+                    displayName: '操作',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['product'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: '查询商品列表',
+                            value: 'queryProducts',
+                            action: 'Query products',
+                        },
+                    ],
+                    default: 'queryProducts',
+                },
+                // ==================== 仓库操作 ====================
+                {
+                    displayName: '操作',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['warehouse'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: '查询库存',
+                            value: 'queryInventory',
+                            description: '查询商品库存信息',
+                            action: 'Query inventory',
+                        },
+                    ],
+                    default: 'queryInventory',
+                },
+                // ==================== 附加字段 ====================
+                {
+                    displayName: '附加字段',
+                    name: 'additionalFields',
+                    type: 'collection',
+                    placeholder: '添加字段',
+                    default: {},
+                    options: [
+                        {
+                            displayName: '自定义参数',
+                            name: 'customParams',
+                            type: 'fixedCollection',
+                            placeholder: '添加参数',
+                            default: {},
+                            typeOptions: {
+                                multipleValues: true,
+                            },
+                            options: [
+                                {
+                                    name: 'parameter',
+                                    displayName: '参数',
+                                    values: [
+                                        {
+                                            displayName: '参数名',
+                                            name: 'name',
+                                            type: 'string',
+                                            default: '',
+                                            description: '参数名称',
+                                        },
+                                        {
+                                            displayName: '参数值',
+                                            name: 'value',
+                                            type: 'string',
+                                            default: '',
+                                        },
+                                    ],
+                                },
+                            ],
+                            description: '自定义请求参数',
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const credentials = await this.getCredentials('kuaimaiApi');
+                const resource = this.getNodeParameter('resource', i);
+                const operation = this.getNodeParameter('operation', i);
+                const appKey = credentials.appKey;
+                const appSecret = credentials.appSecret;
+                const accessToken = credentials.accessToken;
+                const refreshToken = credentials.refreshToken;
+                const signMethod = credentials.signMethod;
+                const environment = credentials.environment;
+                // 确定 API 端点
+                const baseURL = environment === 'internal' ? 'https://gw3.superboss.cc' : 'https://gw.superboss.cc';
+                let method = '';
+                const businessParams = {};
+                // 根据资源和操作确定 API 方法和参数
+                if (resource === 'base') {
+                    if (operation === 'refreshToken') {
+                        method = 'open.token.refresh';
+                        businessParams.refreshToken = refreshToken;
+                    }
+                    else if (operation === 'listWarehouses') {
+                        method = 'erp.warehouse.query';
+                    }
+                    else if (operation === 'listShops') {
+                        method = 'erp.shop.query';
+                    }
+                }
+                else if (resource === 'order') {
+                    if (operation === 'queryOrders') {
+                        method = 'erp.trade.list.query';
+                        const timeType = this.getNodeParameter('timeType', i);
+                        const startTime = this.getNodeParameter('startTime', i);
+                        const endTime = this.getNodeParameter('endTime', i);
+                        const pageNo = this.getNodeParameter('pageNo', i);
+                        const pageSize = this.getNodeParameter('pageSize', i);
+                        businessParams.timeType = timeType;
+                        businessParams.startTime = formatDateTimeForKuaimai(new Date(startTime));
+                        businessParams.endTime = formatDateTimeForKuaimai(new Date(endTime));
+                        businessParams.pageNo = String(pageNo);
+                        businessParams.pageSize = String(pageSize);
+                    }
+                }
+                else if (resource === 'product') {
+                    if (operation === 'queryProducts') {
+                        method = 'erp.item.list.query';
+                    }
+                }
+                else if (resource === 'warehouse') {
+                    if (operation === 'queryInventory') {
+                        method = 'erp.inventory.query';
+                    }
+                }
+                // 处理附加字段
+                const additionalFields = this.getNodeParameter('additionalFields', i, {});
+                if (additionalFields.customParams) {
+                    const customParams = additionalFields.customParams;
+                    if (customParams.parameter && Array.isArray(customParams.parameter)) {
+                        customParams.parameter.forEach((param) => {
+                            const name = param.name;
+                            const value = param.value;
+                            if (name && value !== undefined) {
+                                businessParams[name] = value;
+                            }
+                        });
+                    }
+                }
+                // 构建完整的请求参数（包含签名）
+                const requestParams = (0, KuaimaiSignature_1.buildKuaimaiRequestParams)(method, accessToken, appKey, appSecret, signMethod, businessParams);
+                // 发起 API 请求
+                const response = await this.helpers.request({
+                    method: 'POST',
+                    url: `${baseURL}/router`,
+                    headers: {
+                        'Content-Type': 'application/x-www-form-urlencoded',
+                    },
+                    form: requestParams,
+                    json: true,
+                });
+                // 检查响应
+                if (response.success === false) {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `快麦 API 错误: ${response.msg || '未知错误'} (错误码: ${response.code || 'N/A'})`, {
+                        description: `Trace ID: ${response.trace_id || 'N/A'}`,
+                    });
+                }
+                returnData.push({
+                    json: response,
+                });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: {
+                            error: error instanceof Error ? error.message : String(error),
+                        },
+                    });
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        return [returnData];
+    }
+}
+exports.KuaimaiErp = KuaimaiErp;
+/**
+ * 格式化日期时间为快麦要求的格式
+ * @param date 日期对象
+ * @returns 格式化的日期时间字符串 (yyyy-MM-dd HH:mm:ss)
+ */
+function formatDateTimeForKuaimai(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const seconds = String(date.getSeconds()).padStart(2, '0');
+    return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`;
+}

package/dist/nodes/KuaimaiErp/KuaimaiSignature.d.ts

@@ -0,0 +1,42 @@
+import { IDataObject } from 'n8n-workflow';
+/**
+ * 快麦开放平台签名工具
+ * 参考文档: https://open.kuaimai.com/docs/api/API对接说明/API调用方法详解
+ */
+export interface SignatureParams {
+    [key: string]: string | number | boolean | undefined;
+}
+/**
+ * 生成快麦 API 签名
+ * @param params 所有请求参数（包括公共参数和业务参数，但不包括 sign 参数）
+ * @param secret App Secret
+ * @param signMethod 签名方法：hmac | md5 | hmac-sha256
+ * @returns 签名字符串（32位大写十六进制）
+ */
+export declare function generateKuaimaiSignature(params: SignatureParams, secret: string, signMethod?: string): string;
+/**
+ * 构建快麦 API 公共参数
+ * @param method API 方法名
+ * @param session Access Token
+ * @param appKey App Key
+ * @param additionalParams 额外的公共参数
+ * @returns 公共参数对象
+ */
+export declare function buildKuaimaiCommonParams(method: string, session: string, appKey: string, additionalParams?: IDataObject): IDataObject;
+/**
+ * 格式化时间为快麦要求的格式
+ * @param date 日期对象
+ * @returns 格式化的时间字符串 (yyyy-MM-dd HH:mm:ss)
+ */
+export declare function formatKuaimaiTimestamp(date: Date): string;
+/**
+ * 构建完整的 API 请求参数（包含签名）
+ * @param method API 方法名
+ * @param session Access Token
+ * @param appKey App Key
+ * @param appSecret App Secret
+ * @param signMethod 签名方法
+ * @param businessParams 业务参数
+ * @returns 包含签名的完整请求参数
+ */
+export declare function buildKuaimaiRequestParams(method: string, session: string, appKey: string, appSecret: string, signMethod: string, businessParams?: IDataObject): IDataObject;

package/dist/nodes/KuaimaiErp/KuaimaiSignature.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateKuaimaiSignature = generateKuaimaiSignature;
+exports.buildKuaimaiCommonParams = buildKuaimaiCommonParams;
+exports.formatKuaimaiTimestamp = formatKuaimaiTimestamp;
+exports.buildKuaimaiRequestParams = buildKuaimaiRequestParams;
+const crypto_1 = require("crypto");
+/**
+ * 生成快麦 API 签名
+ * @param params 所有请求参数（包括公共参数和业务参数，但不包括 sign 参数）
+ * @param secret App Secret
+ * @param signMethod 签名方法：hmac | md5 | hmac-sha256
+ * @returns 签名字符串（32位大写十六进制）
+ */
+function generateKuaimaiSignature(params, secret, signMethod = 'hmac') {
+    // 1. 移除 sign 参数、null 值和 undefined 值
+    const filteredParams = {};
+    Object.keys(params).forEach((key) => {
+        const value = params[key];
+        if (key !== 'sign' && value !== null && value !== undefined) {
+            filteredParams[key] = value;
+        }
+    });
+    // 2. 按照参数名 ASCII 码排序
+    const sortedKeys = Object.keys(filteredParams).sort();
+    // 3. 拼接参数名和参数值
+    let signString = '';
+    // MD5 方法需要在前后加 secret
+    if (signMethod === 'md5') {
+        signString = secret;
+    }
+    sortedKeys.forEach((key) => {
+        signString += key + String(filteredParams[key]);
+    });
+    if (signMethod === 'md5') {
+        signString += secret;
+    }
+    // 4. 生成签名
+    let signature;
+    switch (signMethod) {
+        case 'md5':
+            signature = (0, crypto_1.createHash)('md5').update(signString, 'utf8').digest('hex');
+            break;
+        case 'hmac':
+            signature = (0, crypto_1.createHmac)('md5', secret).update(signString, 'utf8').digest('hex');
+            break;
+        case 'hmac-sha256':
+            signature = (0, crypto_1.createHmac)('sha256', secret).update(signString, 'utf8').digest('hex');
+            break;
+        default:
+            throw new Error(`不支持的签名方法: ${signMethod}`);
+    }
+    // 5. 转换为大写并返回
+    return signature.toUpperCase();
+}
+/**
+ * 构建快麦 API 公共参数
+ * @param method API 方法名
+ * @param session Access Token
+ * @param appKey App Key
+ * @param additionalParams 额外的公共参数
+ * @returns 公共参数对象
+ */
+function buildKuaimaiCommonParams(method, session, appKey, additionalParams) {
+    const timestamp = formatKuaimaiTimestamp(new Date());
+    const commonParams = {
+        method,
+        appKey,
+        timestamp,
+        format: 'json',
+        version: '1.0',
+        sign_method: (additionalParams === null || additionalParams === void 0 ? void 0 : additionalParams.sign_method) || 'hmac',
+        session,
+    };
+    // 合并额外的参数
+    if (additionalParams) {
+        Object.assign(commonParams, additionalParams);
+    }
+    return commonParams;
+}
+/**
+ * 格式化时间为快麦要求的格式
+ * @param date 日期对象
+ * @returns 格式化的时间字符串 (yyyy-MM-dd HH:mm:ss)
+ */
+function formatKuaimaiTimestamp(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const seconds = String(date.getSeconds()).padStart(2, '0');
+    return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`;
+}
+/**
+ * 构建完整的 API 请求参数（包含签名）
+ * @param method API 方法名
+ * @param session Access Token
+ * @param appKey App Key
+ * @param appSecret App Secret
+ * @param signMethod 签名方法
+ * @param businessParams 业务参数
+ * @returns 包含签名的完整请求参数
+ */
+function buildKuaimaiRequestParams(method, session, appKey, appSecret, signMethod, businessParams) {
+    // 构建公共参数
+    const commonParams = buildKuaimaiCommonParams(method, session, appKey, {
+        sign_method: signMethod,
+    });
+    // 合并业务参数
+    const allParams = { ...commonParams };
+    if (businessParams) {
+        Object.keys(businessParams).forEach((key) => {
+            const value = businessParams[key];
+            if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+                allParams[key] = value;
+            }
+        });
+    }
+    // 生成签名
+    const sign = generateKuaimaiSignature(allParams, appSecret, signMethod);
+    // 返回完整参数（包含签名）
+    return {
+        ...allParams,
+        sign,
+    };
+}

package/dist/nodes/KuaimaiErp/kuaimai.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <rect x="3" y="3" width="18" height="18" rx="2" ry="2"/>
+  <circle cx="9" cy="9" r="2"/>
+  <path d="m21 15-3.086-3.086a2 2 0 0 0-1.414-.586H13l-2.5 2.5"/>
+  <path d="M3 3l3 3 2-2 4 4"/>
+</svg>

package/index.js

@@ -0,0 +1,5 @@
+// Main entry point for n8n node package
+// This file exports all nodes and credentials
+
+export * from './dist/nodes/KuaimaiErp/KuaimaiErp.node';
+export * from './dist/credentials/KuaimaiCredentials.credentials';

package/nodes/KuaimaiErp/kuaimai.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <rect x="3" y="3" width="18" height="18" rx="2" ry="2"/>
+  <circle cx="9" cy="9" r="2"/>
+  <path d="m21 15-3.086-3.086a2 2 0 0 0-1.414-.586H13l-2.5 2.5"/>
+  <path d="M3 3l3 3 2-2 4 4"/>
+</svg>

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "n8n-nodes-kuaimai",
+  "version": "1.0.0",
+  "description": "快麦ERP开放平台的 n8n 节点 - 基于官方API实现订单、商品、库存管理",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "kuaimai",
+    "erp",
+    "ecommerce"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/gabrielsworld/n8n-nodes-kuaimai",
+  "author": {
+    "name": "gabrielsworld",
+    "email": "gabrielsworld@github.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gabrielsworld/n8n-nodes-kuaimai.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && gulp build:icons",
+    "dev": "tsc --watch",
+    "format": "prettier nodes credentials --write",
+    "lint": "eslint nodes credentials --ext .ts",
+    "lintfix": "eslint nodes credentials --ext .ts --fix",
+    "prepublishOnly": "npm run build && npm run lint -s",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/KuaimaiCredentials.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/KuaimaiErp/KuaimaiErp.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.5",
+    "@types/nock": "^10.0.3",
+    "@types/node": "^18.16.16",
+    "@typescript-eslint/eslint-plugin": "^6.7.0",
+    "@typescript-eslint/parser": "^6.7.0",
+    "eslint": "^8.49.0",
+    "eslint-plugin-n8n-nodes-base": "^1.16.1",
+    "gulp": "^4.0.2",
+    "jest": "^29.7.0",
+    "n8n-workflow": "^1.15.0",
+    "nock": "^14.0.10",
+    "prettier": "^3.0.3",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.2.2"
+  },
+  "dependencies": {
+    "fast-check": "^3.13.2",
+    "n8n-core": "^1.15.0"
+  }
+}

package/publish-npm.bat

@@ -0,0 +1,86 @@
+@echo off
+REM 发布 n8n-nodes-kuaimai 到 npm 公共 registry
+REM 使用方法: publish-npm.bat [你的2FA代码]
+
+echo ========================================
+echo  发布 n8n-nodes-kuaimai 到 npm
+echo ========================================
+echo.
+
+REM 检查是否提供了 2FA 代码
+if "%1"=="" (
+    echo [错误] 请提供 2FA 代码作为参数
+    echo.
+    echo 使用方法:
+    echo   publish-npm.bat 123456
+    echo.
+    echo 其中 123456 是你的 npm 2FA 应用中显示的 6 位数字代码
+    echo.
+    pause
+    exit /b 1
+)
+
+set OTP_CODE=%1
+
+echo [1/5] 检查 npm 登录状态...
+npm whoami
+if errorlevel 1 (
+    echo [错误] 未登录 npm，请先运行: npm login
+    pause
+    exit /b 1
+)
+echo.
+
+echo [2/5] 检查 registry 配置...
+npm config get registry
+echo.
+
+echo [3/5] 运行构建和检查...
+call npm run build
+if errorlevel 1 (
+    echo [错误] 构建失败
+    pause
+    exit /b 1
+)
+echo.
+
+echo [4/5] 正在发布到 npm...
+echo 使用 2FA 代码: %OTP_CODE%
+npm publish --access public --registry=https://registry.npmjs.org/ --otp=%OTP_CODE%
+if errorlevel 1 (
+    echo.
+    echo [错误] 发布失败
+    echo.
+    echo 可能的原因:
+    echo   1. 2FA 代码已过期（每 30 秒更新一次）
+    echo   2. 版本号已存在
+    echo   3. 网络问题
+    echo.
+    echo 解决方案:
+    echo   - 获取新的 2FA 代码并重新运行
+    echo   - 或运行: npm version patch 更新版本号
+    echo.
+    pause
+    exit /b 1
+)
+echo.
+
+echo [5/5] 验证发布结果...
+timeout /t 5 /nobreak >nul
+echo.
+echo ========================================
+echo  发布成功！
+echo ========================================
+echo.
+echo 包信息:
+npm view n8n-nodes-kuaimai version
+echo.
+echo 访问 npm 页面:
+echo   https://www.npmjs.com/package/n8n-nodes-kuaimai
+echo.
+echo 在 n8n 中安装:
+echo   1. 打开 http://localhost:5678
+echo   2. Settings -^> Community nodes -^> Install
+echo   3. 输入: n8n-nodes-kuaimai
+echo.
+pause