@lzpenguin/economy 1.0.0

package/README.md

@@ -0,0 +1,78 @@
+# @lzpenguin/economy
+
+Riffle 经济系统客户端 SDK，用于在游戏中管理用户的金币和钻石。
+
+## 安装
+
+```bash
+npm install @lzpenguin/economy
+```
+
+## 快速开始
+
+```javascript
+import { RiffleEconomy } from '@lzpenguin/economy';
+
+// 创建实例（token 会自动从 URL 参数 ?token=xxx 中读取）
+const economy = new RiffleEconomy({
+  baseURL: 'https://api.riffle.app'
+});
+
+// 查询账户余额
+const account = await economy.query();
+console.log('金币:', account.coin, '钻石:', account.diamond);
+
+// 使用货币（带错误处理）
+try {
+  const result = await economy.consume('coin', 10);
+  console.log('✅ 使用成功，剩余金币:', result.coin);
+} catch (error) {
+  console.error('❌ 失败:', error.message);
+}
+
+// 充值货币
+const recharged = await economy.recharge('diamond', 50);
+console.log('充值后钻石:', recharged.diamond);
+```
+
+## API
+
+### `new RiffleEconomy(options)`
+创建实例
+- `options.baseURL` - API 服务器 URL
+
+### `query()`
+查询账户余额
+- **返回:** `Promise<{coin: number, diamond: number}>`
+
+### `consume(type, num)`
+使用货币
+- `type` - 货币类型：`'coin'` 或 `'diamond'`
+- `num` - 数量（必须 > 0）
+- **返回:** `Promise<{coin: number, diamond: number}>`
+
+### `recharge(type, num)`
+充值货币
+- `type` - 货币类型：`'coin'` 或 `'diamond'`
+- `num` - 数量（必须 > 0）
+- **返回:** `Promise<{coin: number, diamond: number}>`
+
+## TypeScript
+
+```typescript
+import { RiffleEconomy, CurrencyType, AccountInfo } from '@lzpenguin/economy';
+
+const economy = new RiffleEconomy({ baseURL: 'https://api.riffle.app' });
+const account: AccountInfo = await economy.query();
+```
+
+## 常见错误
+
+- `token not found in browser URL parameters` - URL 缺少 token 参数
+- `type must be "coin" or "diamond"` - 货币类型错误
+- `num must be greater than 0` - 数量必须大于 0
+- `金币余额不足` / `钻石余额不足` - 余额不足
+
+## 许可证
+
+ISC

package/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Riffle 经济系统客户端 SDK
+ */
+
+/**
+ * RiffleEconomy 构造函数选项
+ */
+export interface RiffleEconomyOptions {
+  /** API 服务器 URL（例如：'https://api.riffle.app'） */
+  baseURL: string;
+}
+
+/**
+ * 货币类型
+ */
+export type CurrencyType = 'coin' | 'diamond';
+
+/**
+ * 账户信息
+ */
+export interface AccountInfo {
+  /** 金币数量 */
+  coin: number;
+  /** 钻石数量 */
+  diamond: number;
+}
+
+/**
+ * RiffleEconomy - 经济系统客户端
+ * 
+ * @example
+ * ```typescript
+ * import { RiffleEconomy } from '@lzpenguin/economy';
+ * 
+ * const economy = new RiffleEconomy({
+ *   baseURL: 'https://api.riffle.app'
+ *   // token 会自动从浏览器 URL 参数中读取
+ *   // 例如：https://example.com/game.html?token=xxx
+ * });
+ * 
+ * // 查询账户余额
+ * const account = await economy.query();
+ * console.log('Coin:', account.coin);
+ * console.log('Diamond:', account.diamond);
+ * 
+ * // 使用货币
+ * const result = await economy.consume('coin', 10);
+ * 
+ * // 充值货币
+ * const recharged = await economy.recharge('diamond', 50);
+ * ```
+ */
+export class RiffleEconomy {
+  /**
+   * 创建 RiffleEconomy 实例
+   * @param options 配置选项
+   */
+  constructor(options: RiffleEconomyOptions);
+
+  /**
+   * 查询用户货币账户
+   * @returns 账户信息，包含 coin 和 diamond
+   */
+  query(): Promise<AccountInfo>;
+
+  /**
+   * 使用货币
+   * @param type 货币类型 ('coin' 或 'diamond')
+   * @param num 使用数量（必须大于 0）
+   * @returns 更新后的账户信息
+   */
+  consume(type: CurrencyType, num: number): Promise<AccountInfo>;
+
+  /**
+   * 充值货币
+   * @param type 货币类型 ('coin' 或 'diamond')
+   * @param num 充值数量（必须大于 0）
+   * @returns 更新后的账户信息
+   */
+  recharge(type: CurrencyType, num: number): Promise<AccountInfo>;
+}
+

package/index.js

@@ -0,0 +1,158 @@
+// 检测运行环境
+let isBrowser = typeof window !== 'undefined';
+
+/**
+ * RiffleEconomy - 经济系统客户端
+ * 
+ * @example
+ * ```js
+ * import { RiffleEconomy } from '@lzpenguin/economy';
+ * 
+ * const economy = new RiffleEconomy({
+ *   baseURL: 'https://api.riffle.app'
+ *   // token 会自动从浏览器 URL 参数中读取
+ *   // 例如：https://example.com/game.html?token=xxx
+ * });
+ * 
+ * // 查询账户余额
+ * const account = await economy.query();
+ * console.log('Coin:', account.coin);
+ * console.log('Diamond:', account.diamond);
+ * 
+ * // 使用货币
+ * const result = await economy.consume('coin', 10);
+ * console.log('Remaining coin:', result.coin);
+ * 
+ * // 充值货币
+ * const recharged = await economy.recharge('diamond', 50);
+ * console.log('New diamond:', recharged.diamond);
+ * ```
+ */
+export class RiffleEconomy {
+  /**
+   * @param {Object} options - 配置选项
+   * @param {string} options.baseURL - API 服务器 URL（例如：'https://api.riffle.app'）
+   */
+  constructor(options) {
+    const { baseURL } = options;
+
+    if (!baseURL) {
+      throw new Error('baseURL is required');
+    }
+
+    this.baseURL = baseURL.replace(/\/$/, ''); // 移除末尾的斜杠
+
+    // 从浏览器 URL 参数中读取 token
+    let token;
+
+    if (isBrowser && typeof window !== 'undefined' && window.location) {
+      const urlParams = new URLSearchParams(window.location.search);
+      if (urlParams.has('token')) {
+        token = urlParams.get('token');
+      }
+    }
+
+    if (!token) {
+      throw new Error('token not found in browser URL parameters. Please ensure URL contains ?token=xxx');
+    }
+
+    this.token = token;
+  }
+
+  /**
+   * 发送 HTTP 请求
+   * @private
+   * @param {string} path - API 路径
+   * @param {Object} [body] - 请求体（可选）
+   * @returns {Promise<Object>} 响应数据
+   */
+  async _request(path, body = null) {
+    const url = `${this.baseURL}${path}`;
+    
+    const options = {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${this.token}`
+      }
+    };
+
+    if (body) {
+      options.body = JSON.stringify(body);
+    }
+
+    try {
+      const response = await fetch(url, options);
+      
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new Error(errorData.message || `HTTP ${response.status}: ${response.statusText}`);
+      }
+
+      const data = await response.json();
+      
+      // 检查响应中是否有错误
+      if (data.code !== 0) {
+        throw new Error(data.message || 'API request failed');
+      }
+
+      return data.data;
+    } catch (error) {
+      console.error('[RiffleEconomy] Request failed:', error);
+      throw error;
+    }
+  }
+
+  /**
+   * 查询用户货币账户
+   * @returns {Promise<{coin: number, diamond: number}>} 账户信息
+   * @example
+   * const account = await economy.query();
+   * console.log('Coin:', account.coin);
+   * console.log('Diamond:', account.diamond);
+   */
+  async query() {
+    return await this._request('/api/v1/economy/query');
+  }
+
+  /**
+   * 使用货币
+   * @param {string} type - 货币类型 ('coin' 或 'diamond')
+   * @param {number} num - 使用数量
+   * @returns {Promise<{coin: number, diamond: number}>} 更新后的账户信息
+   * @example
+   * const result = await economy.consume('coin', 10);
+   * console.log('Remaining coin:', result.coin);
+   */
+  async consume(type, num) {
+    if (!type || (type !== 'coin' && type !== 'diamond')) {
+      throw new Error('type must be "coin" or "diamond"');
+    }
+    if (!num || num <= 0) {
+      throw new Error('num must be greater than 0');
+    }
+
+    return await this._request('/api/v1/economy/consume', { type, num });
+  }
+
+  /**
+   * 充值货币
+   * @param {string} type - 货币类型 ('coin' 或 'diamond')
+   * @param {number} num - 充值数量
+   * @returns {Promise<{coin: number, diamond: number}>} 更新后的账户信息
+   * @example
+   * const result = await economy.recharge('diamond', 50);
+   * console.log('New diamond:', result.diamond);
+   */
+  async recharge(type, num) {
+    if (!type || (type !== 'coin' && type !== 'diamond')) {
+      throw new Error('type must be "coin" or "diamond"');
+    }
+    if (!num || num <= 0) {
+      throw new Error('num must be greater than 0');
+    }
+
+    return await this._request('/api/v1/economy/recharge', { type, num });
+  }
+}
+

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@lzpenguin/economy",
+  "version": "1.0.0",
+  "description": "Riffle 经济系统客户端 SDK",
+  "license": "ISC",
+  "author": "lzpenguin",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md"
+  ],
+  "keywords": [
+    "riffle",
+    "economy",
+    "currency"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.10.0"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  }
+}
+