payment-kit 1.21.13 → 1.21.15

package/src/components/uploader.tsx

@@ -3,6 +3,7 @@ import { Stack, styled } from '@mui/system';
 import { lazy, Suspense, useCallback, useEffect, useRef } from 'react';
 import { CloudUpload, Delete, Edit } from '@mui/icons-material';
 import { createPortal } from 'react-dom';
+import { useLocaleContext } from '@arcblock/ux/lib/Locale/context';
 
 const UploaderComponent = lazy(() =>
   import(/* webpackChunkName: "blocklet-uploader" */ '@blocklet/uploader').then((res) => ({
@@ -27,6 +28,7 @@ export default function Uploader({
   allowedFileExts = ['.png', '.jpeg', '.webp', '.svg', '.jpg'],
   disabled = false,
 }: Props) {
+  const { locale } = useLocaleContext();
   const uploaderRef = useRef<any>(null);
   const handleOpen = useCallback(() => {
     if (!uploaderRef.current) return;
@@ -72,6 +74,7 @@ export default function Uploader({
           uploader: '/api/uploads',
           companion: '/api/companion',
         }}
+        locale={locale}
       />
     </Suspense>
   );

package/src/hooks/cache-state.ts

@@ -0,0 +1,84 @@
+import { useCallback, useState } from 'react';
+
+type StorageType = 'localStorage' | 'sessionStorage' | 'cookie';
+
+interface CacheStateOptions<T> {
+  defaultValue: T;
+  storage?: StorageType;
+  getUrlParams?: () => Partial<T>;
+  clearUrlParams?: () => void;
+}
+
+const getStorageValue = <T>(key: string, storage: StorageType): T | undefined => {
+  try {
+    if (storage === 'cookie') {
+      const matches = document.cookie.match(
+        new RegExp(`(?:^|; )${key.replace(/([.$?*|{}()[\]\\/+^])/g, '\\$1')}=([^;]*)`)
+      );
+      return matches?.[1] ? JSON.parse(decodeURIComponent(matches[1])) : undefined;
+    }
+    const storageObj = storage === 'sessionStorage' ? sessionStorage : localStorage;
+    const value = storageObj.getItem(key);
+    return value ? JSON.parse(value) : undefined;
+  } catch {
+    return undefined;
+  }
+};
+
+const setStorageValue = <T>(key: string, value: T, storage: StorageType): void => {
+  try {
+    const serialized = JSON.stringify(value);
+    if (storage === 'cookie') {
+      document.cookie = `${encodeURIComponent(key)}=${encodeURIComponent(serialized)}; path=/`;
+      return;
+    }
+    const storageObj = storage === 'sessionStorage' ? sessionStorage : localStorage;
+    storageObj.setItem(key, serialized);
+  } catch (error) {
+    console.error(`Failed to set ${storage} value:`, error);
+  }
+};
+
+const getInitialValue = <T>(
+  key: string,
+  storage: StorageType,
+  defaultValue: T,
+  getUrlParams?: () => Partial<T>,
+  clearUrlParams?: () => void
+): T => {
+  const cachedValue = getStorageValue<T>(key, storage);
+  const urlParams = getUrlParams?.();
+
+  if (urlParams && Object.keys(urlParams).length > 0) {
+    const mergedValue = {
+      ...(cachedValue || defaultValue),
+      ...urlParams,
+    };
+    setStorageValue(key, mergedValue, storage);
+    clearUrlParams?.();
+    return mergedValue;
+  }
+
+  return cachedValue !== undefined ? cachedValue : defaultValue;
+};
+
+export const useCacheState = <T = any>(key: string, options: CacheStateOptions<T>) => {
+  const { defaultValue, storage = 'localStorage', getUrlParams, clearUrlParams } = options;
+
+  const [state, setState] = useState<T>(() =>
+    getInitialValue(key, storage, defaultValue, getUrlParams, clearUrlParams)
+  );
+
+  const setStateAndStorage = useCallback(
+    (value: T | ((prev: T) => T)) => {
+      setState((prevState) => {
+        const nextState = typeof value === 'function' ? (value as (prev: T) => T)(prevState) : value;
+        setStorageValue(key, nextState, storage);
+        return nextState;
+      });
+    },
+    [key, storage]
+  );
+
+  return [state, setStateAndStorage] as const;
+};

package/src/locales/en.tsx

@@ -5,6 +5,7 @@ export default flat({
     redirecting: 'Redirecting...',
     title: 'Name',
     estimated: 'Estimated',
+    total: 'Total',
     active: 'Active',
     inactive: 'Inactive',
     metadata: {
@@ -41,18 +42,28 @@ export default flat({
     quickStart: 'Quick Start Guides',
     advancedFeatures: 'Advanced Features',
     quickStarts: 'Quick Starts',
+    homeTagline: 'A decentralized Stripe-like payment solution for Blocklets',
+    adminDashboard: 'Admin Dashboard',
+    customerPortal: 'Customer Portal',
     copy: 'Copy',
     copied: 'Copied',
     copySuccess: 'Copied successfully',
     copyFailed: 'Copy failed',
     copyTip: 'Please copy manually',
     save: 'Save',
+    saving: 'Saving...',
     cancel: 'Cancel',
+    back: 'Back',
     know: 'I Know',
     confirm: 'Confirm',
     edit: 'Edit',
+    view: 'View',
+    select: 'Select',
+    clear: 'Clear',
     delete: 'Delete',
     deleting: 'Deleting...',
+    activate: 'Activate',
+    deactivate: 'Deactivate',
     yes: 'Yes',
     no: 'No',
     never: 'Never',
@@ -95,6 +106,7 @@ export default flat({
     viewInvoice: 'View Invoice',
     viewSourceData: 'View Source',
     goToConfigure: 'Go to Configure',
+    noData: 'No data',
   },
   notification: {
     preferences: {
@@ -120,6 +132,52 @@ export default flat({
     metrics: 'Metrics',
     attention: 'Attention',
     overview: 'Overview',
+    overviewPage: {
+      financialIndicatorsTitle: 'Financial Indicators',
+      businessMonitoringTitle: 'Business Monitoring',
+      filters: {
+        dateRange: 'Select Date Range',
+        currencyLabel: 'Currencies',
+        productLabel: 'Products',
+        regionLabel: 'Regions',
+        allCurrencies: 'All Currencies',
+        allProducts: 'All Products',
+        allRegions: 'All Regions',
+      },
+      financialIndicators: {
+        totalIncome: {
+          title: 'Total Income',
+          subtitle: "User's actual payment",
+        },
+        costOfGoods: {
+          title: 'Cost of Goods',
+          subtitle: 'Supplier share',
+        },
+        netRevenue: {
+          title: 'Net Revenue',
+          subtitle: 'Revenue after vendor costs',
+        },
+        promotionCost: {
+          title: 'Promotion Cost',
+          subtitle: 'Discount',
+        },
+        taxedRevenue: {
+          title: 'Taxed Revenue',
+          subtitle: 'Revenue with tax',
+        },
+      },
+      charts: {
+        title: 'Transaction Trends',
+        payments: 'Payments',
+        payouts: 'Payouts',
+        refunds: 'Refunds',
+        allCurrencies: 'All currencies',
+      },
+      metrics: {
+        transaction: 'Transaction Metrics',
+        essential: 'Essential Metrics',
+      },
+    },
     payments: 'Payments',
     connections: 'Connections',
     back: 'Back',
@@ -136,6 +194,69 @@ export default flat({
     invoiceItems: 'Invoice Items',
     pricing: 'Pricing',
     coupons: 'Coupons',
+    tax: 'Tax',
+    taxRates: 'Tax Rates',
+    taxRate: {
+      create: 'Create Tax Rate',
+      createTitle: 'Create Tax Rate',
+      createAction: 'Add Tax Rate',
+      created: 'Tax rate created successfully',
+      updated: 'Tax rate updated successfully',
+      deleted: 'Tax rate deleted successfully',
+      label: 'Tax Rate',
+      view: 'View Tax Rate',
+      displayName: 'Display Name',
+      displayNamePlaceholder: 'Name shown on invoices and reports',
+      displayNameAuto: 'Auto-generated if left empty',
+      displayNameRequired: 'Display name is required',
+      description: 'Description',
+      descriptionPlaceholder: 'Optional description',
+      country: 'Country',
+      countryRequired: 'Country is required',
+      state: 'State/Province',
+      postalCode: 'Postal Code',
+      taxCode: 'Product Tax Code',
+      taxCodeDescription:
+        'Tax codes are used to calculate automatic taxes based on product type and location. You can ',
+      taxCodeDescriptionLink: 'manage tax rates',
+      taxCodeDescriptionSuffix: ' to create custom tax rates for specific tax codes and regions.',
+      selectTaxCode: 'Select product tax code',
+      percentage: 'Tax Rate (%)',
+      percentageRequired: 'Tax rate percentage is required',
+      percentageMin: 'Tax rate must be 0% or higher',
+      percentageMax: 'Tax rate must be less than 100%',
+      active: 'Active by default',
+      location: 'Region',
+      advanced: 'Advanced options',
+      search: 'Search tax rates',
+      searchCountry: 'Search country',
+      back: 'Back to tax rates',
+      associatedInvoices: 'Related Invoices',
+      deleteTitle: 'Delete Tax Rate',
+      deleteMessage: 'Are you sure you want to delete tax rate “{name}”? This action cannot be undone.',
+      deactivateTitle: 'Deactivate Tax Rate',
+      deactivateMessage: 'Deactivate “{name}”? It will no longer apply automatically to invoices.',
+      activateTitle: 'Activate Tax Rate',
+      activateMessage: 'Activate “{name}”? It will be available for future invoices.',
+      createTitleShort: 'Add tax rate',
+      edit: 'Edit',
+      editTitle: 'Edit Tax Rate',
+      selectTaxCodeHint: "We'll use this tax code to calculate automatic tax on invoices.",
+      searchPlaceholder: 'Search by product or tax code',
+      previewPlaceholder: 'Select a tax code to see details.',
+      usePreset: 'Use preset',
+      noPreset: 'No preset selected',
+      noSuggestions: 'No tax codes match your search.',
+      relatedInvoiceNum: 'Related Invoices',
+      notUsed: 'Not used',
+      taxCodeLabel: 'Tax code: {code}',
+      types: {
+        general: 'General',
+        digital: 'Digital products',
+        services: 'Services',
+        physical: 'Physical goods',
+      },
+    },
     pricingTables: 'Pricing tables',
     vendors: 'Vendors',
     billing: 'Billing',
@@ -449,8 +570,12 @@ export default flat({
       type: {
         label: 'Product Type',
         service: 'Service',
+        serviceDesc: 'Digital services or subscriptions',
         credit: 'Credit',
+        creditDesc: 'Credit top-up product for credit-based billing scenarios',
+        creditDescLink: 'Create meters first',
         good: 'Good',
+        goodDesc: 'Physical products or tangible goods',
       },
       vendorConfig: {
         title: 'Vendor Configuration',
@@ -489,6 +614,7 @@ export default flat({
       additional: 'Additional options',
       model: 'Pricing model',
       amount: 'Price',
+      amountDescription: 'This is the tax-inclusive price that customers will pay.',
       locked: 'This price is locked because it is used by a subscription or a payment.',
       amountTip: 'Choose recurring for subscriptions and one-time for everything else.',
       duplicate: 'Duplicate price',
@@ -898,6 +1024,11 @@ export default flat({
       view: 'View payment detail',
       empty: 'No payment intent',
       refund: 'Refund payment',
+      status: {
+        active: 'Active',
+        paid: 'Paid',
+        succeeded: 'Succeeded',
+      },
       received: 'Received',
       attention: 'Failed payments',
       refundError: 'Failed to refund payment',
@@ -928,6 +1059,11 @@ export default flat({
       view: 'View payout',
       empty: 'No payout',
       attention: 'Failed payouts',
+      status: {
+        active: 'Active',
+        paid: 'Paid',
+        succeeded: 'Succeeded',
+      },
     },
     paymentMethod: {
       _name: 'Payment Method',
@@ -1074,7 +1210,13 @@ export default flat({
     invoice: {
       view: 'View invoice',
       attention: 'Uncollectible invoices',
+      metric: 'Paid invoices',
       name: 'Invoice',
+      status: {
+        active: 'Active',
+        paid: 'Paid',
+        succeeded: 'Succeeded',
+      },
       from: 'Billed from',
       empty: 'No invoices',
       number: 'Invoice Number',
@@ -1181,6 +1323,11 @@ export default flat({
       view: 'View subscription',
       name: 'Subscription',
       empty: 'No subscriptions',
+      status: {
+        active: 'Active',
+        paid: 'Paid',
+        succeeded: 'Succeeded',
+      },
       viewAll: 'View all subscriptions',
       noActiveEmpty: 'You currently have no active subscriptions. You can choose to view your subscription history.',
       includedServices: 'Included Services',
@@ -1389,6 +1536,11 @@ export default flat({
       name: 'Refunds',
       view: 'View refund detail',
       attention: 'Failed refunds',
+      status: {
+        active: 'Active',
+        paid: 'Paid',
+        succeeded: 'Succeeded',
+      },
     },
     usageRecord: {
       empty: 'No usage records',

package/src/locales/zh.tsx

@@ -5,6 +5,7 @@ export default flat({
     redirecting: '跳转中...',
     title: '名称',
     estimated: '预估',
+    total: '总量',
     active: '生效中',
     metadata: {
       label: '元数据',
@@ -39,18 +40,28 @@ export default flat({
     quickStart: '快速入门指南',
     advancedFeatures: '高级功能',
     quickStarts: '快速入门',
+    homeTagline: '为 Blocklet 构建的去中心化支付解决方案',
+    adminDashboard: '管理后台',
+    customerPortal: '客户门户',
     copy: '复制',
     copied: '已复制',
     copySuccess: '复制成功',
     copyFailed: '复制失败',
     copyTip: '请手动复制',
     save: '保存',
+    saving: '保存中...',
     cancel: '取消',
+    back: '返回',
     know: '知道了',
     confirm: '确认',
     edit: '编辑',
+    view: '查看',
+    select: '选择',
+    clear: '清除',
     delete: '删除',
     deleting: '删除中...',
+    activate: '启用',
+    deactivate: '停用',
     yes: '是',
     no: '否',
     never: '永不',
@@ -94,6 +105,7 @@ export default flat({
     viewInvoice: '查看账单',
     viewSourceData: '查看来源',
     goToConfigure: '前往配置',
+    noData: '暂无数据',
   },
   notification: {
     preferences: {
@@ -119,6 +131,52 @@ export default flat({
     metrics: '指标',
     attention: '注意',
     overview: '总览',
+    overviewPage: {
+      financialIndicatorsTitle: '财务指标',
+      businessMonitoringTitle: '业务监控',
+      filters: {
+        dateRange: '选择日期范围',
+        currencyLabel: '币种',
+        productLabel: '产品',
+        regionLabel: '地区',
+        allCurrencies: '全部币种',
+        allProducts: '全部产品',
+        allRegions: '全部地区',
+      },
+      financialIndicators: {
+        totalIncome: {
+          title: '总收入',
+          subtitle: '用户实际支付',
+        },
+        costOfGoods: {
+          title: '进货成本',
+          subtitle: '供应商分成',
+        },
+        netRevenue: {
+          title: '净收入',
+          subtitle: '扣除供货成本后的收入',
+        },
+        promotionCost: {
+          title: '促销成本',
+          subtitle: '折扣',
+        },
+        taxedRevenue: {
+          title: '含税收入',
+          subtitle: '包含税费的收入',
+        },
+      },
+      charts: {
+        title: '交易趋势',
+        payments: '付款',
+        payouts: '出款',
+        refunds: '退款',
+        allCurrencies: '全部币种',
+      },
+      metrics: {
+        transaction: '交易指标',
+        essential: '关键指标',
+      },
+    },
     payments: '支付管理',
     connections: '连接',
     back: '返回',
@@ -134,6 +192,67 @@ export default flat({
     products: '产品定价',
     invoiceItems: '账单明细',
     coupons: '优惠券',
+    tax: '税务',
+    taxRates: '税率',
+    taxRate: {
+      create: '创建税率',
+      createTitle: '新建税率',
+      createAction: '添加税率',
+      created: '税率创建成功',
+      updated: '税率更新成功',
+      deleted: '税率删除成功',
+      label: '税率',
+      view: '查看税率',
+      displayName: '显示名称',
+      displayNamePlaceholder: '显示在账单和报表上的名称',
+      displayNameAuto: '留空则自动生成',
+      displayNameRequired: '请填写显示名称',
+      description: '描述',
+      descriptionPlaceholder: '可选描述信息',
+      country: '国家/地区',
+      countryRequired: '请选择国家/地区',
+      state: '州 / 省',
+      postalCode: '邮政编码',
+      taxCode: '产品税码',
+      taxCodeDescription: '产品税码用于根据产品类型和地区自动计算税费。您可以',
+      taxCodeDescriptionLink: '管理税率',
+      taxCodeDescriptionSuffix: '以创建针对特定税码和地区的自定义税率。',
+      selectTaxCode: '选择产品税码',
+      percentage: '税率 (%)',
+      percentageRequired: '请填写税率',
+      percentageMin: '税率需大于或等于 0%',
+      percentageMax: '税率需小于 100%',
+      active: '默认启用',
+      location: '适用区域',
+      advanced: '高级选项',
+      search: '搜索税率',
+      searchCountry: '搜索国家/地区',
+      back: '返回税率列表',
+      associatedInvoices: '关联账单',
+      deleteTitle: '删除税率',
+      deleteMessage: '确定要删除税率“{name}”吗？该操作无法撤销。',
+      deactivateTitle: '停用税率',
+      deactivateMessage: '确定要停用“{name}”吗？停用后将不再自动应用。',
+      activateTitle: '启用税率',
+      activateMessage: '确定要启用"{name}"吗？启用后可用于新的账单。',
+      edit: '编辑',
+      editTitle: '编辑税率',
+      selectTaxCodeHint: '税率将用于自动计算账单中的税费。',
+      searchPlaceholder: '按产品或税码搜索',
+      previewPlaceholder: '请选择税码以查看详情。',
+      usePreset: '默认税码',
+      noPreset: '暂无默认税码',
+      noSuggestions: '没有符合搜索条件的税码。',
+      relatedInvoiceNum: '关联账单数',
+      notUsed: '未使用',
+      taxCodeLabel: '税码：{code}',
+      types: {
+        general: '通用类别',
+        digital: '数字产品',
+        services: '服务类',
+        physical: '实物商品',
+      },
+    },
     pricing: '定价',
     pricingTables: '定价表',
     vendors: '供应商',
@@ -422,8 +541,12 @@ export default flat({
       type: {
         label: '产品类型',
         service: '服务',
+        serviceDesc: '数字服务或订阅',
         credit: 'Credit',
+        creditDesc: '用于基于 Credit 计费场景的充值产品',
+        creditDescLink: '请先创建计量器',
         good: '商品',
+        goodDesc: '实体商品或有形产品',
       },
       vendorConfig: {
         title: '供应商配置',
@@ -460,6 +583,7 @@ export default flat({
       additional: '附加选项',
       model: '定价模型',
       amount: '价格',
+      amountDescription: '这是客户将支付的含税价格。',
       locked: '此价格已锁定，因为它用于订阅或支付。',
       amountTip: '对于订阅选择周期，对于其他所有选择一次性。',
       duplicate: '复制价格',
@@ -836,6 +960,11 @@ export default flat({
       view: '查看对外支付',
       empty: '没有记录',
       attention: '失败的对外支付',
+      status: {
+        active: '生效中',
+        paid: '已支付',
+        succeeded: '成功',
+      },
     },
     pricingTable: {
       view: '查看定价表',
@@ -864,6 +993,11 @@ export default flat({
       view: '查看付款详情',
       empty: '没有付款记录',
       refund: '退款',
+      status: {
+        active: '生效中',
+        paid: '已支付',
+        succeeded: '成功',
+      },
       received: '实收金额',
       attention: '失败的付款',
       refundError: '退款申请失败',
@@ -1048,6 +1182,11 @@ export default flat({
       name: '账单',
       from: '账单来自',
       empty: '没有账单',
+      status: {
+        active: '生效中',
+        paid: '已支付',
+        succeeded: '成功',
+      },
       number: '账单编号',
       description: '账单说明',
       dueDate: '截止日期',
@@ -1153,6 +1292,11 @@ export default flat({
       view: '查看订阅',
       name: '订阅',
       empty: '没有订阅',
+      status: {
+        active: '生效中',
+        paid: '已支付',
+        succeeded: '成功',
+      },
       viewAll: '查看历史订阅',
       noActiveEmpty: '您当前没有服务中的订阅，您可以选择查看历史订阅',
       includedServices: '包含的服务',
@@ -1351,6 +1495,11 @@ export default flat({
       name: '退款',
       attention: '失败的退款',
       view: '查看退款详情',
+      status: {
+        active: '生效中',
+        paid: '已支付',
+        succeeded: '成功',
+      },
     },
     usageRecord: {
       empty: '用量记录为空',

package/src/pages/admin/billing/invoices/detail.tsx

@@ -389,7 +389,7 @@ export default function InvoiceDetail(props: { id: string }) {
           <Box className="section">
             <SectionHeader title={t('admin.summary')} />
             <Box className="section-body">
-              <InvoiceTable invoice={data} emptyNodeText={t('empty.summary')} />
+              <InvoiceTable invoice={data} emptyNodeText={t('empty.summary')} mode="admin" />
             </Box>
           </Box>
           <Divider />

package/src/pages/admin/index.tsx

@@ -14,6 +14,7 @@ const groups = {
   customers: React.lazy(() => import('./customers/index')),
   products: React.lazy(() => import('./products/index')),
   billing: React.lazy(() => import('./billing/index')),
+  tax: React.lazy(() => import('./tax')),
   developers: React.lazy(() => import('./developers/index')),
   settings: React.lazy(() => import('./settings/index')),
 };
@@ -64,6 +65,7 @@ function Admin() {
     { label: t('admin.payments'), value: 'payments' },
     { label: t('admin.customers'), value: 'customers' },
     { label: t('admin.products'), value: 'products' },
+    { label: t('admin.tax'), value: 'tax' },
     { label: t('admin.billing'), value: 'billing' },
     { label: t('admin.settings'), value: 'settings' },
   ];