@aitlabs/namkwong 0.0.92

package/dist/ledger/errors/index.d.ts

@@ -0,0 +1,38 @@
+export * from './locales/zh';
+/** Ledger 模块错误码 */
+export declare const LedgerErrorCodes: {
+    /** 账户不存在 */
+    readonly LEDGER_ACCOUNT_NOT_FOUND: 'LEDGER_ACCOUNT_NOT_FOUND';
+    /** 账户状态不允许操作 */
+    readonly LEDGER_ACCOUNT_STATUS_NOT_ALLOWED: 'LEDGER_ACCOUNT_STATUS_NOT_ALLOWED';
+    /** 账户资产不匹配 */
+    readonly LEDGER_ACCOUNT_ASSET_MISMATCH: 'LEDGER_ACCOUNT_ASSET_MISMATCH';
+    /** 钱包类型与资产分类不匹配 */
+    readonly LEDGER_WALLET_ASSET_CATEGORY_MISMATCH: 'LEDGER_WALLET_ASSET_CATEGORY_MISMATCH';
+    /** 钱包类型不存在 */
+    readonly LEDGER_WALLET_TYPE_NOT_FOUND: 'LEDGER_WALLET_TYPE_NOT_FOUND';
+    /** 钱包类型不允许挂载该账户类型 */
+    readonly LEDGER_WALLET_ACCOUNT_TYPE_NOT_ALLOWED: 'LEDGER_WALLET_ACCOUNT_TYPE_NOT_ALLOWED';
+    /** 创建钱包失败 */
+    readonly LEDGER_WALLET_CREATE_FAILED: 'LEDGER_WALLET_CREATE_FAILED';
+    /** 创建账户失败 */
+    readonly LEDGER_ACCOUNT_CREATE_FAILED: 'LEDGER_ACCOUNT_CREATE_FAILED';
+    /** 余额不足 */
+    readonly LEDGER_INSUFFICIENT_BALANCE: 'LEDGER_INSUFFICIENT_BALANCE';
+    /** 冻结余额不足 */
+    readonly LEDGER_INSUFFICIENT_FROZEN_BALANCE: 'LEDGER_INSUFFICIENT_FROZEN_BALANCE';
+    /** 并发余额更新冲突 */
+    readonly LEDGER_CONCURRENT_UPDATE_CONFLICT: 'LEDGER_CONCURRENT_UPDATE_CONFLICT';
+    /** 金额必须为正数 */
+    readonly LEDGER_INVALID_AMOUNT: 'LEDGER_INVALID_AMOUNT';
+    /** 创建账本记录失败 */
+    readonly LEDGER_ENTRY_CREATE_FAILED: 'LEDGER_ENTRY_CREATE_FAILED';
+    /** 创建余额记录失败 */
+    readonly LEDGER_BALANCE_CREATE_FAILED: 'LEDGER_BALANCE_CREATE_FAILED';
+};
+type LedgerErrorCodesType = typeof LedgerErrorCodes;
+export type LedgerErrorCode = keyof LedgerErrorCodesType;
+declare module '../../error/errorcode' {
+    interface ErrorCodeRegistry extends LedgerErrorCodesType {
+    }
+}

package/dist/ledger/errors/locales/zh.d.ts

@@ -0,0 +1,22 @@
+export declare const zh: {
+    LEDGER_ACCOUNT_NOT_FOUND: string;
+    LEDGER_ACCOUNT_STATUS_NOT_ALLOWED: string;
+    LEDGER_ACCOUNT_ASSET_MISMATCH: string;
+    LEDGER_WALLET_ASSET_CATEGORY_MISMATCH: string;
+    LEDGER_WALLET_TYPE_NOT_FOUND: string;
+    LEDGER_WALLET_ACCOUNT_TYPE_NOT_ALLOWED: string;
+    LEDGER_WALLET_CREATE_FAILED: string;
+    LEDGER_ACCOUNT_CREATE_FAILED: string;
+    LEDGER_INSUFFICIENT_BALANCE: string;
+    LEDGER_INSUFFICIENT_FROZEN_BALANCE: string;
+    LEDGER_CONCURRENT_UPDATE_CONFLICT: string;
+    LEDGER_INVALID_AMOUNT: string;
+    LEDGER_ENTRY_CREATE_FAILED: string;
+    LEDGER_BALANCE_CREATE_FAILED: string;
+};
+type ZHType = typeof zh;
+declare module '../../../error/messages' {
+    interface ErrorMessageRegistry extends ZHType {
+    }
+}
+export {};

package/dist/ledger/index.d.ts

@@ -0,0 +1,6 @@
+export * from './schema';
+export type * from './db.schemas';
+export { AdminLedgerService } from './admin/service';
+export { InternalLedgerService, type BalanceChangeResult, type CreateLedgerEntryParams, } from './internal/service';
+export { UserLedgerService } from './user/service';
+export { ledgerRouter } from './user/router';

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

@@ -0,0 +1,36 @@
+import Decimal from 'decimal.js';
+import type { TransactionTx } from '../../db/transaction';
+import type { LedgerEntrySelectSchemaType } from '../db.schemas';
+export interface CreateLedgerEntryParams {
+    assetId: string;
+    fromAccountId?: string | undefined;
+    toAccountId?: string | undefined;
+    bizType: LedgerEntrySelectSchemaType['bizType'];
+    amount: string | Decimal;
+    referenceId: string;
+    referenceType: LedgerEntrySelectSchemaType['referenceType'];
+    idempotencyKey: string;
+    memo?: string | undefined;
+    operatorId?: string | undefined;
+}
+export interface BalanceChangeResult {
+    success: boolean;
+    ledgerEntryId: string;
+    fromAvailableBefore?: string | null;
+    fromAvailableAfter?: string | null;
+    fromLockedBefore?: string | null;
+    fromLockedAfter?: string | null;
+    toAvailableBefore?: string | null;
+    toAvailableAfter?: string | null;
+    toLockedBefore?: string | null;
+    toLockedAfter?: string | null;
+    isIdempotent?: boolean;
+}
+export declare abstract class InternalLedgerService {
+    static increaseAvailableBalance(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+    static decreaseAvailableBalance(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+    static freezeBalance(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+    static unfreezeBalance(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+    static deductLockedBalance(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+    static transferBetweenAccounts(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+}

package/dist/ledger/permissions.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 账本模块权限定义（Access Control 资源 -> 操作列表）
+ */
+/** 账本权限 */
+export declare const ledgerPermissions: {
+    readonly 'ledger:entry': readonly ['read', 'list', 'view_all', 'adjust'];
+};
+export type LedgerPermission = keyof typeof ledgerPermissions;

package/dist/ledger/schema.d.ts

@@ -0,0 +1,365 @@
+/** 账本业务类型 */
+export declare const ledgerBizTypeEnum: import("drizzle-orm/pg-core").PgEnum<["deposit_credit", "withdraw_freeze", "withdraw_release", "withdraw_debit", "transfer_out", "transfer_in", "internal_transfer_out", "internal_transfer_in", "manual_increase", "manual_decrease", "welfare_cycle_subscribe_transfer", "welfare_cycle_daily_yield_payout", "welfare_cycle_maturity_yield_payout", "welfare_cycle_maturity_principal_return", "asset_convert_order_pay_debit", "asset_convert_order_target_credit", "trade_market_buy_quote_transfer", "trade_market_buy_base_transfer", "trade_market_sell_base_transfer", "trade_market_sell_quote_transfer"]>;
+/** 账本业务引用类型 */
+export declare const ledgerReferenceTypeEnum: import("drizzle-orm/pg-core").PgEnum<["deposit_order", "withdraw_order", "transfer_order", "internal_transfer_order", "manual_adjustment", "welfare_cycle_subscription", "welfare_cycle_daily_payout", "welfare_cycle_maturity_settlement", "asset_convert_order", "trade_market_order"]>;
+/**
+ * 账本分录表
+ * 按账户与资产维度记账，记录双边账户快照和幂等键
+ */
+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;
+        }, {}, {}>;
+        assetId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "asset_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;
+        }, {}, {}>;
+        fromAccountId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "from_account_id";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        toAccountId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "to_account_id";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        bizType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "biz_type";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "asset_convert_order_pay_debit" | "asset_convert_order_target_credit" | "deposit_credit" | "internal_transfer_in" | "internal_transfer_out" | "manual_decrease" | "manual_increase" | "trade_market_buy_base_transfer" | "trade_market_buy_quote_transfer" | "trade_market_sell_base_transfer" | "trade_market_sell_quote_transfer" | "transfer_in" | "transfer_out" | "welfare_cycle_daily_yield_payout" | "welfare_cycle_maturity_principal_return" | "welfare_cycle_maturity_yield_payout" | "welfare_cycle_subscribe_transfer" | "withdraw_debit" | "withdraw_freeze" | "withdraw_release";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["deposit_credit", "withdraw_freeze", "withdraw_release", "withdraw_debit", "transfer_out", "transfer_in", "internal_transfer_out", "internal_transfer_in", "manual_increase", "manual_decrease", "welfare_cycle_subscribe_transfer", "welfare_cycle_daily_yield_payout", "welfare_cycle_maturity_yield_payout", "welfare_cycle_maturity_principal_return", "asset_convert_order_pay_debit", "asset_convert_order_target_credit", "trade_market_buy_quote_transfer", "trade_market_buy_base_transfer", "trade_market_sell_base_transfer", "trade_market_sell_quote_transfer"];
+            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;
+        }, {}, {}>;
+        fromAvailableBefore: import("drizzle-orm/pg-core").PgColumn<{
+            name: "from_available_before";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fromAvailableAfter: import("drizzle-orm/pg-core").PgColumn<{
+            name: "from_available_after";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fromLockedBefore: import("drizzle-orm/pg-core").PgColumn<{
+            name: "from_locked_before";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fromLockedAfter: import("drizzle-orm/pg-core").PgColumn<{
+            name: "from_locked_after";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        toAvailableBefore: import("drizzle-orm/pg-core").PgColumn<{
+            name: "to_available_before";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        toAvailableAfter: import("drizzle-orm/pg-core").PgColumn<{
+            name: "to_available_after";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        toLockedBefore: import("drizzle-orm/pg-core").PgColumn<{
+            name: "to_locked_before";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        toLockedAfter: import("drizzle-orm/pg-core").PgColumn<{
+            name: "to_locked_after";
+            tableName: "ledger_entry";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            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: "asset_convert_order" | "deposit_order" | "internal_transfer_order" | "manual_adjustment" | "trade_market_order" | "transfer_order" | "welfare_cycle_daily_payout" | "welfare_cycle_maturity_settlement" | "welfare_cycle_subscription" | "withdraw_order";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["deposit_order", "withdraw_order", "transfer_order", "internal_transfer_order", "manual_adjustment", "welfare_cycle_subscription", "welfare_cycle_daily_payout", "welfare_cycle_maturity_settlement", "asset_convert_order", "trade_market_order"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        idempotencyKey: import("drizzle-orm/pg-core").PgColumn<{
+            name: "idempotency_key";
+            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: 128;
+        }>;
+        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;
+        }, {}, {}>;
+        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;
+        }, {}, {}>;
+        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", {
+    asset: import("drizzle-orm").One<"asset", true>;
+    fromAccount: import("drizzle-orm").One<"ledger_account", false>;
+    toAccount: import("drizzle-orm").One<"ledger_account", false>;
+    operator: import("drizzle-orm").One<"user", false>;
+}>;