@quantabit/membership-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QuantaBit Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @quantabit/membership-sdk
+
+> QuantaBit Membership SDK - Membership card management and points-based benefit redemption
+
+## 📦 Installation
+
+```bash
+npm install @quantabit/membership-sdk
+# or
+yarn add @quantabit/membership-sdk
+```
+
+## 🚀 Quick Start
+
+### Using Components
+
+```jsx
+import { MembershipCard, useMembershipCard } from "@quantabit/membership-sdk";
+
+function MyMembership() {
+  const { card, loading } = useMembershipCard();
+
+  if (loading) return <div>Loading...</div>;
+  return <MembershipCard card={card} />;
+}
+```
+
+### API Client
+
+```javascript
+import { membershipApi, CardType } from "@quantabit/membership-sdk";
+
+// Get my membership card
+const card = await membershipApi.getMyCard();
+
+// Get all available cards
+const cards = await membershipApi.getCards();
+
+// Redeem membership with points
+await membershipApi.redeemWithPoints(CardType.GOLD, 5000);
+
+// Extend membership
+await membershipApi.extendCard("card_123", 3); // 3 months
+
+// Get card benefits
+const benefits = await membershipApi.getBenefits(CardType.GOLD);
+
+// Use a benefit
+await membershipApi.useBenefit("benefit_123");
+```
+
+## 📚 Components
+
+| Component        | Description                                          |
+| ---------------- | ---------------------------------------------------- |
+| `MembershipCard` | Gradient membership card with type, name, and expiry |
+
+## 🪝 Hooks
+
+| Hook                | Description                         |
+| ------------------- | ----------------------------------- |
+| `useMembershipCard` | Load current user's membership card |
+
+## 📖 Type Definitions
+
+```javascript
+import { CardType, CardStatus } from "@quantabit/membership-sdk";
+
+// Card types
+CardType.BASIC; // Basic
+CardType.SILVER; // Silver
+CardType.GOLD; // Gold
+CardType.PLATINUM; // Platinum
+
+// Card status
+CardStatus.ACTIVE; // Active
+CardStatus.EXPIRED; // Expired
+CardStatus.FROZEN; // Frozen
+```
+
+## 📄 License
+
+MIT License
+
+
+
+---
+
+## 🌐 Brand & Links
+- Official Mainnet: [QuantaBit Chain](https://qbitchain.io/)
+- Developer Platform: [Developer Platform](https://developer.quantabit.io/)
+- Open Platform: [Open Platform](https://open.quantabit.io/)
+- Payment Platform: [Pay Platform](https://pay.qbitwallet.io/)
+- Feedback: [Feedback](https://xwin.live/qbit)

package/dist/index.cjs

@@ -0,0 +1,548 @@
+'use client';
+'use strict';
+
+var sdkConfig = require('@quantabit/sdk-config');
+var React = require('react');
+
+/**
+ * Membership SDK - API 客户端
+ * 会员卡系统后端接口封装
+ * 
+ * 使用 BaseApiClient 基类，继承统一的配置、认证、错误处理
+ */
+
+
+/**
+ * 会员卡 API 客户端
+ */
+class MembershipApiClient extends sdkConfig.BaseApiClient {
+  constructor(config = {}) {
+    super('/membership', config);
+  }
+
+  // ============ 会员卡查询 ============
+
+  /**
+   * 获取当前用户的会员卡
+   */
+  async getMyCard() {
+    return this.get('/card');
+  }
+
+  /**
+   * 获取所有会员卡类型
+   */
+  async getCards() {
+    return this.get('/cards');
+  }
+
+  /**
+   * 获取会员卡详情
+   * @param {string} cardId - 会员卡 ID
+   */
+  async getCardDetail(cardId) {
+    return this.get(`/cards/${cardId}`);
+  }
+
+  // ============ 会员卡操作 ============
+
+  /**
+   * 使用积分兑换会员卡
+   * @param {string} cardType - 卡片类型 (basic/silver/gold/platinum)
+   * @param {number} points - 积分数量
+   */
+  async redeemWithPoints(cardType, points) {
+    return this.post('/redeem', {
+      cardType,
+      points
+    });
+  }
+
+  /**
+   * 延长会员卡有效期
+   * @param {string} cardId - 会员卡 ID
+   * @param {number} months - 延长月数
+   */
+  async extendCard(cardId, months) {
+    return this.post(`/cards/${cardId}/extend`, {
+      months
+    });
+  }
+
+  /**
+   * 升级会员卡
+   * @param {string} cardId - 会员卡 ID
+   * @param {string} targetType - 目标卡片类型
+   */
+  async upgradeCard(cardId, targetType) {
+    return this.post(`/cards/${cardId}/upgrade`, {
+      target_type: targetType
+    });
+  }
+
+  // ============ 权益管理 ============
+
+  /**
+   * 获取卡片权益列表
+   * @param {string} cardType - 卡片类型
+   */
+  async getBenefits(cardType) {
+    return this.get(`/cards/${cardType}/benefits`);
+  }
+
+  /**
+   * 使用权益
+   * @param {string} benefitId - 权益 ID
+   */
+  async useBenefit(benefitId) {
+    return this.post(`/benefits/${benefitId}/use`);
+  }
+
+  /**
+   * 获取权益使用记录
+   * @param {Object} params - 查询参数
+   */
+  async getBenefitHistory(params = {}) {
+    return this.get('/benefits/history', params);
+  }
+}
+
+// 创建默认实例
+const membershipApi = new MembershipApiClient();
+
+/**
+ * Membership SDK - React Hooks
+ * 会员卡 React 钩子
+ */
+
+
+/**
+ * 获取当前用户的会员卡信息
+ */
+function useMembershipCard() {
+  const [card, setCard] = React.useState(null);
+  const [loading, setLoading] = React.useState(true);
+  const [error, setError] = React.useState(null);
+  const fetchCard = React.useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await membershipApi.getMyCard();
+      setCard(result.data || result);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+  React.useEffect(() => {
+    fetchCard();
+  }, [fetchCard]);
+  return {
+    card,
+    loading,
+    error,
+    refresh: fetchCard
+  };
+}
+
+/**
+ * 获取所有可用的会员卡类型
+ */
+function useMembershipCards() {
+  const [cards, setCards] = React.useState([]);
+  const [loading, setLoading] = React.useState(true);
+  const [error, setError] = React.useState(null);
+  const fetchCards = React.useCallback(async () => {
+    setLoading(true);
+    try {
+      const result = await membershipApi.getCards();
+      setCards(result.data || []);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+  React.useEffect(() => {
+    fetchCards();
+  }, [fetchCards]);
+  return {
+    cards,
+    loading,
+    error,
+    refresh: fetchCards
+  };
+}
+
+/**
+ * 会员卡权益管理
+ * @param {string} cardType - 卡片类型
+ */
+function useBenefits(cardType) {
+  const [benefits, setBenefits] = React.useState([]);
+  const [loading, setLoading] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const fetchBenefits = React.useCallback(async () => {
+    if (!cardType) return;
+    setLoading(true);
+    try {
+      const result = await membershipApi.getBenefits(cardType);
+      setBenefits(result.data || []);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [cardType]);
+  const useBenefit = React.useCallback(async benefitId => {
+    const result = await membershipApi.useBenefit(benefitId);
+    await fetchBenefits();
+    return result;
+  }, [fetchBenefits]);
+  React.useEffect(() => {
+    fetchBenefits();
+  }, [fetchBenefits]);
+  return {
+    benefits,
+    loading,
+    error,
+    useBenefit,
+    refresh: fetchBenefits
+  };
+}
+
+/**
+ * Membership SDK - 国际化
+ * 会员卡系统多语言支持
+ */
+
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+const messages = {
+  zh: {
+    membershipCard: '会员卡',
+    cardType: {
+      basic: '基础会员',
+      silver: '银卡会员',
+      gold: '金卡会员',
+      platinum: '铂金会员'
+    },
+    validUntil: '有效期至',
+    points: '积分',
+    use: '使用',
+    noBenefits: '暂无可用权益',
+    redeem: '兑换',
+    upgrade: '升级',
+    extend: '续期',
+    benefits: '会员权益',
+    history: '使用记录',
+    loading: '加载中...',
+    expired: '已过期',
+    active: '有效',
+    frozen: '已冻结'
+  },
+  en: {
+    membershipCard: 'Membership Card',
+    cardType: {
+      basic: 'Basic',
+      silver: 'Silver',
+      gold: 'Gold',
+      platinum: 'Platinum'
+    },
+    validUntil: 'Valid until',
+    points: 'Points',
+    use: 'Use',
+    noBenefits: 'No benefits available',
+    redeem: 'Redeem',
+    upgrade: 'Upgrade',
+    extend: 'Extend',
+    benefits: 'Benefits',
+    history: 'History',
+    loading: 'Loading...',
+    expired: 'Expired',
+    active: 'Active',
+    frozen: 'Frozen'
+  },
+  ja: {
+    membershipCard: 'メンバーシップカード',
+    cardType: {
+      basic: 'ベーシック',
+      silver: 'シルバー',
+      gold: 'ゴールド',
+      platinum: 'プラチナ'
+    },
+    validUntil: '有効期限',
+    points: 'ポイント',
+    use: '使用',
+    noBenefits: '利用可能な特典はありません',
+    redeem: '交換',
+    upgrade: 'アップグレード',
+    extend: '延長',
+    benefits: '特典',
+    history: '履歴',
+    loading: '読み込み中...',
+    expired: '期限切れ',
+    active: '有効',
+    frozen: '凍結'
+  },
+  ko: {
+    membershipCard: '멤버십 카드',
+    cardType: {
+      basic: '기본',
+      silver: '실버',
+      gold: '골드',
+      platinum: '플래티넘'
+    },
+    validUntil: '유효 기한',
+    points: '포인트',
+    use: '사용',
+    noBenefits: '사용 가능한 혜택이 없습니다',
+    redeem: '교환',
+    upgrade: '업그레이드',
+    extend: '연장',
+    benefits: '혜택',
+    history: '기록',
+    loading: '로딩 중...',
+    expired: '만료',
+    active: '활성',
+    frozen: '동결'
+  }
+};
+
+// 当前语言
+let currentLanguage = 'zh';
+
+/**
+ * 设置语言
+ * @param {string} lang - 语言代码
+ */
+function setLanguage(lang) {
+  if (SUPPORTED_LANGUAGES.includes(lang)) {
+    currentLanguage = lang;
+  }
+}
+
+/**
+ * 获取当前语言
+ * @returns {string}
+ */
+function getLanguage() {
+  return currentLanguage;
+}
+
+/**
+ * 翻译函数
+ * @param {string} key - 翻译键，支持点号路径（如 'cardType.gold'）
+ * @param {Object} params - 插值参数
+ * @returns {string}
+ */
+function t(key, params = {}) {
+  const lang = messages[currentLanguage] || messages.zh;
+
+  // 支持点号路径访问
+  const keys = key.split('.');
+  let value = lang;
+  for (const k of keys) {
+    value = value?.[k];
+    if (value === undefined) break;
+  }
+  if (typeof value !== 'string') {
+    // 回退到中文
+    value = lang;
+    for (const k of keys) {
+      value = value?.[k];
+      if (value === undefined) break;
+    }
+  }
+  if (typeof value !== 'string') return key;
+
+  // 简单插值替换
+  return value.replace(/\{(\w+)\}/g, (_, k) => params[k] ?? '');
+}
+
+// 监听全局语言变更事件
+if (typeof window !== 'undefined') {
+  window.addEventListener('qbit-did:language-change', e => {
+    if (e.detail?.language) {
+      setLanguage(e.detail.language);
+    }
+  });
+}
+
+/**
+ * Membership SDK - 会员卡组件
+ * 支持 i18n 国际化
+ */
+
+
+/**
+ * 会员卡类型对应的渐变色配置
+ */
+const CARD_GRADIENTS = {
+  basic: {
+    from: '#6b7280',
+    to: '#4b5563',
+    label: '🪪'
+  },
+  silver: {
+    from: '#94a3b8',
+    to: '#64748b',
+    label: '🥈'
+  },
+  gold: {
+    from: '#f59e0b',
+    to: '#d97706',
+    label: '🥇'
+  },
+  platinum: {
+    from: '#a855f7',
+    to: '#7c3aed',
+    label: '💎'
+  }
+};
+
+/**
+ * 会员卡展示组件
+ * @param {Object} props
+ * @param {Object} props.card - 会员卡数据
+ * @param {Function} props.onClick - 点击回调
+ */
+function MembershipCard({
+  card,
+  onClick
+}) {
+  if (!card) return null;
+  const gradient = CARD_GRADIENTS[card.type] || CARD_GRADIENTS.basic;
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-membership-card",
+    style: {
+      background: `linear-gradient(135deg, ${gradient.from}, ${gradient.to})`,
+      borderRadius: '16px',
+      padding: '24px',
+      color: '#fff',
+      cursor: onClick ? 'pointer' : 'default',
+      position: 'relative',
+      overflow: 'hidden',
+      minHeight: '180px'
+    },
+    onClick: () => onClick?.(card)
+  }, /*#__PURE__*/React.createElement("div", {
+    style: {
+      position: 'absolute',
+      top: '16px',
+      right: '20px',
+      fontSize: '32px',
+      opacity: 0.3
+    }
+  }, gradient.label), /*#__PURE__*/React.createElement("div", {
+    style: {
+      fontSize: '12px',
+      letterSpacing: '2px',
+      textTransform: 'uppercase',
+      opacity: 0.8
+    }
+  }, t('membershipCard')), /*#__PURE__*/React.createElement("div", {
+    style: {
+      fontSize: '20px',
+      fontWeight: 'bold',
+      marginTop: '8px',
+      textTransform: 'uppercase'
+    }
+  }, t(`cardType.${card.type}`) || card.type), /*#__PURE__*/React.createElement("div", {
+    style: {
+      marginTop: '24px',
+      fontSize: '16px'
+    }
+  }, card.userName), /*#__PURE__*/React.createElement("div", {
+    style: {
+      display: 'flex',
+      justifyContent: 'space-between',
+      marginTop: '16px',
+      fontSize: '12px',
+      opacity: 0.8
+    }
+  }, /*#__PURE__*/React.createElement("span", null, t('validUntil'), ": ", card.expiryDate), /*#__PURE__*/React.createElement("span", null, card.points, " ", t('points'))));
+}
+
+/**
+ * 会员权益列表组件
+ * @param {Object} props
+ * @param {Array} props.benefits - 权益列表
+ * @param {Function} props.onUseBenefit - 使用权益回调
+ */
+function BenefitList({
+  benefits = [],
+  onUseBenefit
+}) {
+  if (!benefits.length) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-empty"
+    }, t('noBenefits'));
+  }
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-benefit-list"
+  }, benefits.map(benefit => /*#__PURE__*/React.createElement("div", {
+    key: benefit.id,
+    className: "eco-benefit-item",
+    style: {
+      display: 'flex',
+      justifyContent: 'space-between',
+      alignItems: 'center',
+      padding: '12px 16px',
+      borderBottom: '1px solid #f0f0f0'
+    }
+  }, /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
+    style: {
+      fontWeight: 500
+    }
+  }, benefit.name), /*#__PURE__*/React.createElement("div", {
+    style: {
+      fontSize: '12px',
+      color: '#999'
+    }
+  }, benefit.description)), benefit.available && /*#__PURE__*/React.createElement("button", {
+    className: "eco-btn eco-btn-sm",
+    onClick: () => onUseBenefit?.(benefit.id)
+  }, t('use')))));
+}
+
+/**
+ * @quantabit/membership-sdk
+ * 
+ * QuantaBit Membership SDK
+ * 
+ * Provides reusable membership card features:
+ * - Membership card display & management
+ * - Points-based card redemption
+ * - Card upgrade & extension
+ * - Benefit management & usage
+ */
+
+// ============ Types ============
+const CardType = {
+  BASIC: 'basic',
+  SILVER: 'silver',
+  GOLD: 'gold',
+  PLATINUM: 'platinum'
+};
+const CardStatus = {
+  ACTIVE: 'active',
+  EXPIRED: 'expired',
+  FROZEN: 'frozen'
+};
+
+exports.BenefitList = BenefitList;
+exports.CardStatus = CardStatus;
+exports.CardType = CardType;
+exports.MembershipApiClient = MembershipApiClient;
+exports.MembershipCard = MembershipCard;
+exports.SUPPORTED_LANGUAGES = SUPPORTED_LANGUAGES;
+exports.getLanguage = getLanguage;
+exports.membershipApi = membershipApi;
+exports.messages = messages;
+exports.setLanguage = setLanguage;
+exports.t = t;
+exports.useBenefits = useBenefits;
+exports.useMembershipCard = useMembershipCard;
+exports.useMembershipCards = useMembershipCards;
+//# sourceMappingURL=index.cjs.map