@r2wa-org/eden 0.0.48

package/dist/src/ledger/schema.d.ts

@@ -0,0 +1,259 @@
+/** Ledger 条目类型 */
+export declare const ledgerEntryTypeEnum: import("drizzle-orm/pg-core").PgEnum<["deposit_confirmed", "deposit_commission", "withdraw_frozen", "withdraw_confirmed", "withdraw_fee", "withdraw_rejected", "transfer_in", "transfer_out", "wallet_transfer_in", "wallet_transfer_out", "freeze", "unfreeze", "manual_increase", "manual_decrease", "subscription_purchase", "subscription_unlock"]>;
+/** 业务单据类型（referenceType） */
+export declare const referenceTypeEnum: import("drizzle-orm/pg-core").PgEnum<["deposit_order", "deposit_commission", "withdraw_order", "transfer_order", "account_transfer", "manual_adjustment", "subscription_order"]>;
+/**
+ * 账本条目表（Append-only）
+ * 记录所有余额变动，不可修改不可删除
+ */
+export declare const ledgerEntry: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "ledger_entry";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        userId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "user_id";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        walletTypeId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "wallet_type_id";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        entryType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "entry_type";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "deposit_confirmed" | "deposit_commission" | "withdraw_frozen" | "withdraw_confirmed" | "withdraw_fee" | "withdraw_rejected" | "transfer_in" | "transfer_out" | "wallet_transfer_in" | "wallet_transfer_out" | "freeze" | "unfreeze" | "manual_increase" | "manual_decrease" | "subscription_purchase" | "subscription_unlock";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["deposit_confirmed", "deposit_commission", "withdraw_frozen", "withdraw_confirmed", "withdraw_fee", "withdraw_rejected", "transfer_in", "transfer_out", "wallet_transfer_in", "wallet_transfer_out", "freeze", "unfreeze", "manual_increase", "manual_decrease", "subscription_purchase", "subscription_unlock"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        amount: import("drizzle-orm/pg-core").PgColumn<{
+            name: "amount";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        availableBefore: import("drizzle-orm/pg-core").PgColumn<{
+            name: "available_before";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        availableAfter: import("drizzle-orm/pg-core").PgColumn<{
+            name: "available_after";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        frozenBefore: import("drizzle-orm/pg-core").PgColumn<{
+            name: "frozen_before";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        frozenAfter: import("drizzle-orm/pg-core").PgColumn<{
+            name: "frozen_after";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        referenceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "reference_id";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 64;
+        }>;
+        referenceType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "reference_type";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "deposit_commission" | "deposit_order" | "withdraw_order" | "transfer_order" | "account_transfer" | "manual_adjustment" | "subscription_order";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["deposit_order", "deposit_commission", "withdraw_order", "transfer_order", "account_transfer", "manual_adjustment", "subscription_order"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        memo: import("drizzle-orm/pg-core").PgColumn<{
+            name: "memo";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        operatorId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "operator_id";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "ledger_entry";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const ledgerEntryRelations: import("drizzle-orm").Relations<"ledger_entry", {
+    user: import("drizzle-orm").One<"user", true>;
+    walletType: import("drizzle-orm").One<"wallet_type", true>;
+}>;

package/dist/src/ledger/service.d.ts

@@ -0,0 +1,208 @@
+import Decimal from "decimal.js";
+import type { PgTransaction } from "drizzle-orm/pg-core";
+import type { LedgerEntrySelectSchemaType } from "./db.schemas";
+export interface CreateLedgerEntryParams {
+    userId: string;
+    walletTypeId: string;
+    entryType: LedgerEntrySelectSchemaType["entryType"];
+    amount: string | Decimal;
+    referenceId: string;
+    referenceType: LedgerEntrySelectSchemaType["referenceType"];
+    memo?: string | undefined;
+    operatorId?: string | undefined;
+}
+export interface BalanceChangeResult {
+    success: boolean;
+    ledgerEntryId: string;
+    availableBefore: string;
+    availableAfter: string;
+    frozenBefore: string;
+    frozenAfter: string;
+    isIdempotent?: boolean;
+}
+export interface LedgerEntryQueryOptions {
+    walletTypeId?: LedgerEntrySelectSchemaType["walletTypeId"];
+    entryType?: LedgerEntrySelectSchemaType["entryType"];
+    limit?: number | undefined;
+    offset?: number | undefined;
+}
+declare abstract class BaseLedgerService {
+    protected static listLedgerEntries(userId: string, options?: LedgerEntryQueryOptions): Promise<{
+        items: {
+            id: string;
+            createdAt: Date;
+            userId: string;
+            walletTypeId: string;
+            entryType: "deposit_confirmed" | "deposit_commission" | "withdraw_frozen" | "withdraw_confirmed" | "withdraw_fee" | "withdraw_rejected" | "transfer_in" | "transfer_out" | "wallet_transfer_in" | "wallet_transfer_out" | "freeze" | "unfreeze" | "manual_increase" | "manual_decrease" | "subscription_purchase" | "subscription_unlock";
+            amount: string;
+            availableBefore: string;
+            availableAfter: string;
+            frozenBefore: string;
+            frozenAfter: string;
+            referenceId: string;
+            referenceType: "deposit_commission" | "deposit_order" | "withdraw_order" | "transfer_order" | "account_transfer" | "manual_adjustment" | "subscription_order";
+            memo: string | null;
+            operatorId: string | null;
+            walletType: {
+                id: string;
+                name: string;
+                createdAt: Date;
+                updatedAt: Date;
+                description: string | null;
+                code: "balance" | "profit" | "team" | "check_in" | "meeting_reward" | "reform_pioneer_allowance" | "reform_monthly_enjoy" | "basic_livelihood" | "basic_pension" | "basic_medical";
+                allowDeposit: boolean;
+                allowWithdraw: boolean;
+                minWithdrawAmount: string;
+                maxWithdrawAmount: string;
+                allowTransfer: boolean;
+                minTransferAmount: string;
+                maxTransferAmount: string;
+                allowExchange: boolean;
+                allowReceiveExchange: boolean;
+                minExchangeAmount: string;
+                maxExchangeAmount: string;
+                exchangeRate: string;
+                allowTransaction: boolean;
+                hasExpiry: boolean;
+                expiryDays: number | null;
+                isActive: boolean;
+                sortOrder: number;
+            };
+        }[];
+        total: number;
+    }>;
+}
+/**
+ * 用户侧账本服务
+ * 提供用户查询自己账本记录的功能
+ */
+export declare abstract class UserLedgerService extends BaseLedgerService {
+    /**
+     * 获取用户自己的账本记录
+     */
+    static getLedgerEntries(userId: string, options?: LedgerEntryQueryOptions): Promise<{
+        items: {
+            id: string;
+            createdAt: Date;
+            userId: string;
+            walletTypeId: string;
+            entryType: "deposit_confirmed" | "deposit_commission" | "withdraw_frozen" | "withdraw_confirmed" | "withdraw_fee" | "withdraw_rejected" | "transfer_in" | "transfer_out" | "wallet_transfer_in" | "wallet_transfer_out" | "freeze" | "unfreeze" | "manual_increase" | "manual_decrease" | "subscription_purchase" | "subscription_unlock";
+            amount: string;
+            availableBefore: string;
+            availableAfter: string;
+            frozenBefore: string;
+            frozenAfter: string;
+            referenceId: string;
+            referenceType: "deposit_commission" | "deposit_order" | "withdraw_order" | "transfer_order" | "account_transfer" | "manual_adjustment" | "subscription_order";
+            memo: string | null;
+            operatorId: string | null;
+            walletType: {
+                id: string;
+                name: string;
+                createdAt: Date;
+                updatedAt: Date;
+                description: string | null;
+                code: "balance" | "profit" | "team" | "check_in" | "meeting_reward" | "reform_pioneer_allowance" | "reform_monthly_enjoy" | "basic_livelihood" | "basic_pension" | "basic_medical";
+                allowDeposit: boolean;
+                allowWithdraw: boolean;
+                minWithdrawAmount: string;
+                maxWithdrawAmount: string;
+                allowTransfer: boolean;
+                minTransferAmount: string;
+                maxTransferAmount: string;
+                allowExchange: boolean;
+                allowReceiveExchange: boolean;
+                minExchangeAmount: string;
+                maxExchangeAmount: string;
+                exchangeRate: string;
+                allowTransaction: boolean;
+                hasExpiry: boolean;
+                expiryDays: number | null;
+                isActive: boolean;
+                sortOrder: number;
+            };
+        }[];
+        total: number;
+    }>;
+}
+/**
+ * 管理侧账本服务
+ * 提供管理员查询任意用户账本记录的功能
+ */
+export declare abstract class AdminLedgerService extends BaseLedgerService {
+    /**
+     * 获取指定用户的账本记录
+     */
+    static getLedgerEntries(userId: string, options?: LedgerEntryQueryOptions): Promise<{
+        items: {
+            id: string;
+            createdAt: Date;
+            userId: string;
+            walletTypeId: string;
+            entryType: "deposit_confirmed" | "deposit_commission" | "withdraw_frozen" | "withdraw_confirmed" | "withdraw_fee" | "withdraw_rejected" | "transfer_in" | "transfer_out" | "wallet_transfer_in" | "wallet_transfer_out" | "freeze" | "unfreeze" | "manual_increase" | "manual_decrease" | "subscription_purchase" | "subscription_unlock";
+            amount: string;
+            availableBefore: string;
+            availableAfter: string;
+            frozenBefore: string;
+            frozenAfter: string;
+            referenceId: string;
+            referenceType: "deposit_commission" | "deposit_order" | "withdraw_order" | "transfer_order" | "account_transfer" | "manual_adjustment" | "subscription_order";
+            memo: string | null;
+            operatorId: string | null;
+            walletType: {
+                id: string;
+                name: string;
+                createdAt: Date;
+                updatedAt: Date;
+                description: string | null;
+                code: "balance" | "profit" | "team" | "check_in" | "meeting_reward" | "reform_pioneer_allowance" | "reform_monthly_enjoy" | "basic_livelihood" | "basic_pension" | "basic_medical";
+                allowDeposit: boolean;
+                allowWithdraw: boolean;
+                minWithdrawAmount: string;
+                maxWithdrawAmount: string;
+                allowTransfer: boolean;
+                minTransferAmount: string;
+                maxTransferAmount: string;
+                allowExchange: boolean;
+                allowReceiveExchange: boolean;
+                minExchangeAmount: string;
+                maxExchangeAmount: string;
+                exchangeRate: string;
+                allowTransaction: boolean;
+                hasExpiry: boolean;
+                expiryDays: number | null;
+                isActive: boolean;
+                sortOrder: number;
+            };
+        }[];
+        total: number;
+    }>;
+}
+/**
+ * 内部账本服务
+ * 供其他模块调用，执行实际的余额变更和账本记录
+ * 由各业务模块（deposit/withdraw 等）驱动
+ */
+export declare abstract class InternalLedgerService extends BaseLedgerService {
+    /**
+     * 增加可用余额（用于充值、转入等）
+     */
+    static increaseAvailableBalance(tx: PgTransaction<any, any, any>, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+    /**
+     * 减少可用余额（用于提现、转出等）
+     */
+    static decreaseAvailableBalance(tx: PgTransaction<any, any, any>, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+    /**
+     * 冻结余额（从可用转到冻结）
+     */
+    static freezeBalance(tx: PgTransaction<any, any, any>, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+    /**
+     * 解冻余额（从冻结转回可用）
+     */
+    static unfreezeBalance(tx: PgTransaction<any, any, any>, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+    /**
+     * 从冻结中扣除（用于提现完成、订单成交等）
+     */
+    static deductFromFrozen(tx: PgTransaction<any, any, any>, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+}
+export {};

package/dist/src/nanoid/index.d.ts

@@ -0,0 +1,2 @@
+export declare const createNumericNanoid: (size?: number) => string;
+export default createNumericNanoid;