@esengine/transaction 2.0.7 → 2.1.1

package/dist/operations/InventoryOperation.d.ts

@@ -0,0 +1,152 @@
+/**
+ * @zh 背包操作
+ * @en Inventory operation
+ */
+import type { ITransactionContext, OperationResult } from '../core/types.js';
+import { BaseOperation } from './BaseOperation.js';
+/**
+ * @zh 背包操作类型
+ * @en Inventory operation type
+ */
+export type InventoryOperationType = 'add' | 'remove' | 'update';
+/**
+ * @zh 物品数据
+ * @en Item data
+ */
+export interface ItemData {
+    /**
+     * @zh 物品 ID
+     * @en Item ID
+     */
+    itemId: string;
+    /**
+     * @zh 数量
+     * @en Quantity
+     */
+    quantity: number;
+    /**
+     * @zh 物品属性
+     * @en Item properties
+     */
+    properties?: Record<string, unknown>;
+}
+/**
+ * @zh 背包操作数据
+ * @en Inventory operation data
+ */
+export interface InventoryOperationData {
+    /**
+     * @zh 操作类型
+     * @en Operation type
+     */
+    type: InventoryOperationType;
+    /**
+     * @zh 玩家 ID
+     * @en Player ID
+     */
+    playerId: string;
+    /**
+     * @zh 物品 ID
+     * @en Item ID
+     */
+    itemId: string;
+    /**
+     * @zh 数量
+     * @en Quantity
+     */
+    quantity: number;
+    /**
+     * @zh 物品属性（用于更新）
+     * @en Item properties (for update)
+     */
+    properties?: Record<string, unknown>;
+    /**
+     * @zh 原因/来源
+     * @en Reason/source
+     */
+    reason?: string;
+}
+/**
+ * @zh 背包操作结果
+ * @en Inventory operation result
+ */
+export interface InventoryOperationResult {
+    /**
+     * @zh 操作前的物品数据
+     * @en Item data before operation
+     */
+    beforeItem?: ItemData;
+    /**
+     * @zh 操作后的物品数据
+     * @en Item data after operation
+     */
+    afterItem?: ItemData;
+}
+/**
+ * @zh 背包数据提供者接口
+ * @en Inventory data provider interface
+ */
+export interface IInventoryProvider {
+    /**
+     * @zh 获取物品
+     * @en Get item
+     */
+    getItem(playerId: string, itemId: string): Promise<ItemData | null>;
+    /**
+     * @zh 设置物品
+     * @en Set item
+     */
+    setItem(playerId: string, itemId: string, item: ItemData | null): Promise<void>;
+    /**
+     * @zh 检查背包容量
+     * @en Check inventory capacity
+     */
+    hasCapacity?(playerId: string, count: number): Promise<boolean>;
+}
+/**
+ * @zh 背包操作
+ * @en Inventory operation
+ *
+ * @zh 用于处理物品的添加、移除和更新
+ * @en Used for handling item addition, removal, and update
+ *
+ * @example
+ * ```typescript
+ * // 添加物品
+ * tx.addOperation(new InventoryOperation({
+ *     type: 'add',
+ *     playerId: 'player1',
+ *     itemId: 'sword_001',
+ *     quantity: 1,
+ * }))
+ *
+ * // 移除物品
+ * tx.addOperation(new InventoryOperation({
+ *     type: 'remove',
+ *     playerId: 'player1',
+ *     itemId: 'potion_hp',
+ *     quantity: 5,
+ * }))
+ * ```
+ */
+export declare class InventoryOperation extends BaseOperation<InventoryOperationData, InventoryOperationResult> {
+    readonly name = "inventory";
+    private _provider;
+    private _beforeItem;
+    /**
+     * @zh 设置背包数据提供者
+     * @en Set inventory data provider
+     */
+    setProvider(provider: IInventoryProvider): this;
+    validate(ctx: ITransactionContext): Promise<boolean>;
+    execute(ctx: ITransactionContext): Promise<OperationResult<InventoryOperationResult>>;
+    compensate(ctx: ITransactionContext): Promise<void>;
+    private _getItem;
+    private _setItem;
+}
+/**
+ * @zh 创建背包操作
+ * @en Create inventory operation
+ */
+export declare function createInventoryOperation(data: InventoryOperationData): InventoryOperation;
+//# sourceMappingURL=InventoryOperation.d.ts.map

package/dist/operations/InventoryOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InventoryOperation.d.ts","sourceRoot":"","sources":["../../src/operations/InventoryOperation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACnC;;;OAGG;IACH,IAAI,EAAE,sBAAsB,CAAA;IAE5B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEpC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,CAAA;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;IAEnE;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/E;;;OAGG;IACH,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAClE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,kBAAmB,SAAQ,aAAa,CAAC,sBAAsB,EAAE,wBAAwB,CAAC;IACnG,QAAQ,CAAC,IAAI,eAAe;IAE5B,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,WAAW,CAAyB;IAE5C;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAKzC,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBpD,OAAO,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC;IAkErF,UAAU,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;YAI3C,QAAQ;YAcR,QAAQ;CAgBzB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,sBAAsB,GAAG,kBAAkB,CAEzF"}

package/dist/operations/TradeOperation.d.ts

@@ -0,0 +1,155 @@
+/**
+ * @zh 交易操作
+ * @en Trade operation
+ */
+import type { ITransactionContext, OperationResult } from '../core/types.js';
+import { BaseOperation } from './BaseOperation.js';
+import { type ICurrencyProvider } from './CurrencyOperation.js';
+import { type IInventoryProvider } from './InventoryOperation.js';
+/**
+ * @zh 交易物品
+ * @en Trade item
+ */
+export interface TradeItem {
+    /**
+     * @zh 物品 ID
+     * @en Item ID
+     */
+    itemId: string;
+    /**
+     * @zh 数量
+     * @en Quantity
+     */
+    quantity: number;
+}
+/**
+ * @zh 交易货币
+ * @en Trade currency
+ */
+export interface TradeCurrency {
+    /**
+     * @zh 货币类型
+     * @en Currency type
+     */
+    currency: string;
+    /**
+     * @zh 数量
+     * @en Amount
+     */
+    amount: number;
+}
+/**
+ * @zh 交易方数据
+ * @en Trade party data
+ */
+export interface TradeParty {
+    /**
+     * @zh 玩家 ID
+     * @en Player ID
+     */
+    playerId: string;
+    /**
+     * @zh 给出的物品
+     * @en Items to give
+     */
+    items?: TradeItem[];
+    /**
+     * @zh 给出的货币
+     * @en Currencies to give
+     */
+    currencies?: TradeCurrency[];
+}
+/**
+ * @zh 交易操作数据
+ * @en Trade operation data
+ */
+export interface TradeOperationData {
+    /**
+     * @zh 交易 ID
+     * @en Trade ID
+     */
+    tradeId: string;
+    /**
+     * @zh 交易发起方
+     * @en Trade initiator
+     */
+    partyA: TradeParty;
+    /**
+     * @zh 交易接收方
+     * @en Trade receiver
+     */
+    partyB: TradeParty;
+    /**
+     * @zh 原因/备注
+     * @en Reason/note
+     */
+    reason?: string;
+}
+/**
+ * @zh 交易操作结果
+ * @en Trade operation result
+ */
+export interface TradeOperationResult {
+    /**
+     * @zh 交易 ID
+     * @en Trade ID
+     */
+    tradeId: string;
+    /**
+     * @zh 交易是否成功
+     * @en Whether trade succeeded
+     */
+    completed: boolean;
+}
+/**
+ * @zh 交易数据提供者
+ * @en Trade data provider
+ */
+export interface ITradeProvider {
+    currencyProvider?: ICurrencyProvider;
+    inventoryProvider?: IInventoryProvider;
+}
+/**
+ * @zh 交易操作
+ * @en Trade operation
+ *
+ * @zh 用于处理玩家之间的物品和货币交换
+ * @en Used for handling item and currency exchange between players
+ *
+ * @example
+ * ```typescript
+ * tx.addOperation(new TradeOperation({
+ *     tradeId: 'trade_001',
+ *     partyA: {
+ *         playerId: 'player1',
+ *         items: [{ itemId: 'sword', quantity: 1 }],
+ *     },
+ *     partyB: {
+ *         playerId: 'player2',
+ *         currencies: [{ currency: 'gold', amount: 1000 }],
+ *     },
+ * }))
+ * ```
+ */
+export declare class TradeOperation extends BaseOperation<TradeOperationData, TradeOperationResult> {
+    readonly name = "trade";
+    private _provider;
+    private _subOperations;
+    private _executedCount;
+    /**
+     * @zh 设置交易数据提供者
+     * @en Set trade data provider
+     */
+    setProvider(provider: ITradeProvider): this;
+    validate(ctx: ITransactionContext): Promise<boolean>;
+    execute(ctx: ITransactionContext): Promise<OperationResult<TradeOperationResult>>;
+    compensate(ctx: ITransactionContext): Promise<void>;
+    private _buildSubOperations;
+    private _compensateExecuted;
+}
+/**
+ * @zh 创建交易操作
+ * @en Create trade operation
+ */
+export declare function createTradeOperation(data: TradeOperationData): TradeOperation;
+//# sourceMappingURL=TradeOperation.d.ts.map

package/dist/operations/TradeOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TradeOperation.d.ts","sourceRoot":"","sources":["../../src/operations/TradeOperation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAiD,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/G,OAAO,EAAmD,KAAK,kBAAkB,EAAiB,MAAM,yBAAyB,CAAC;AAElI;;;GAGG;AACH,MAAM,WAAW,SAAS;IACtB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,aAAa,EAAE,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,MAAM,EAAE,UAAU,CAAA;IAElB;;;OAGG;IACH,MAAM,EAAE,UAAU,CAAA;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,gBAAgB,CAAC,EAAE,iBAAiB,CAAA;IACpC,iBAAiB,CAAC,EAAE,kBAAkB,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,cAAe,SAAQ,aAAa,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IACvF,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,cAAc,CAAkD;IACxE,OAAO,CAAC,cAAc,CAAK;IAE3B;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAKrC,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAapD,OAAO,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAyBjF,UAAU,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,OAAO,CAAC,mBAAmB;YA8Gb,mBAAmB;CAKpC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CAE7E"}

package/dist/operations/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @zh 操作模块导出
+ * @en Operations module exports
+ */
+export { BaseOperation } from './BaseOperation.js';
+export { CurrencyOperation, createCurrencyOperation, type CurrencyOperationType, type CurrencyOperationData, type CurrencyOperationResult, type ICurrencyProvider } from './CurrencyOperation.js';
+export { InventoryOperation, createInventoryOperation, type InventoryOperationType, type InventoryOperationData, type InventoryOperationResult, type IInventoryProvider, type ItemData } from './InventoryOperation.js';
+export { TradeOperation, createTradeOperation, type TradeOperationData, type TradeOperationResult, type TradeItem, type TradeCurrency, type TradeParty, type ITradeProvider } from './TradeOperation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/operations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EACH,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACzB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACH,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EAChB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACH,cAAc,EACd,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,EACtB,MAAM,qBAAqB,CAAC"}

package/dist/storage/MemoryStorage.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @zh 内存存储实现
+ * @en Memory storage implementation
+ *
+ * @zh 用于开发和测试环境，不支持分布式
+ * @en For development and testing, does not support distributed scenarios
+ */
+import type { ITransactionStorage, TransactionLog, TransactionState, OperationLog } from '../core/types.js';
+/**
+ * @zh 内存存储配置
+ * @en Memory storage configuration
+ */
+export interface MemoryStorageConfig {
+    /**
+     * @zh 最大事务日志数量
+     * @en Maximum transaction log count
+     */
+    maxTransactions?: number;
+}
+/**
+ * @zh 内存存储
+ * @en Memory storage
+ *
+ * @zh 适用于单机开发和测试，数据仅保存在内存中
+ * @en Suitable for single-machine development and testing, data is stored in memory only
+ */
+export declare class MemoryStorage implements ITransactionStorage {
+    private _transactions;
+    private _data;
+    private _locks;
+    private _maxTransactions;
+    constructor(config?: MemoryStorageConfig);
+    acquireLock(key: string, ttl: number): Promise<string | null>;
+    releaseLock(key: string, token: string): Promise<boolean>;
+    saveTransaction(tx: TransactionLog): Promise<void>;
+    getTransaction(id: string): Promise<TransactionLog | null>;
+    updateTransactionState(id: string, state: TransactionState): Promise<void>;
+    updateOperationState(transactionId: string, operationIndex: number, state: OperationLog['state'], error?: string): Promise<void>;
+    getPendingTransactions(serverId?: string): Promise<TransactionLog[]>;
+    deleteTransaction(id: string): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    /**
+     * @zh 清空所有数据（测试用）
+     * @en Clear all data (for testing)
+     */
+    clear(): void;
+    /**
+     * @zh 获取事务数量
+     * @en Get transaction count
+     */
+    get transactionCount(): number;
+    private _cleanExpiredLocks;
+    private _cleanExpiredData;
+    private _cleanOldTransactions;
+}
+/**
+ * @zh 创建内存存储
+ * @en Create memory storage
+ */
+export declare function createMemoryStorage(config?: MemoryStorageConfig): MemoryStorage;
+//# sourceMappingURL=MemoryStorage.d.ts.map

package/dist/storage/MemoryStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStorage.d.ts","sourceRoot":"","sources":["../../src/storage/MemoryStorage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACR,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACf,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,mBAAmB;IACrD,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,KAAK,CAAiE;IAC9E,OAAO,CAAC,MAAM,CAA+D;IAC7E,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,GAAE,mBAAwB;IAQtC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiB7D,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAczD,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK1D,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1E,oBAAoB,CACtB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAC5B,KAAK,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAgBV,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAcpE,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IActC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ3C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,qBAAqB;CAYhC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,mBAAwB,GAAG,aAAa,CAEnF"}

package/dist/storage/MongoStorage.d.ts

@@ -0,0 +1,118 @@
+/**
+ * @zh MongoDB 存储实现
+ * @en MongoDB storage implementation
+ *
+ * @zh 基于共享连接的事务存储，使用 @esengine/database-drivers 提供的连接
+ * @en Transaction storage based on shared connection from @esengine/database-drivers
+ */
+import type { IMongoConnection } from '@esengine/database-drivers';
+import type { ITransactionStorage, TransactionLog, TransactionState, OperationLog } from '../core/types.js';
+/**
+ * @zh MongoDB 存储配置
+ * @en MongoDB storage configuration
+ */
+export interface MongoStorageConfig {
+    /**
+     * @zh MongoDB 连接（来自 @esengine/database-drivers）
+     * @en MongoDB connection (from @esengine/database-drivers)
+     */
+    connection: IMongoConnection;
+    /**
+     * @zh 事务日志集合名称
+     * @en Transaction log collection name
+     */
+    transactionCollection?: string;
+    /**
+     * @zh 数据集合名称
+     * @en Data collection name
+     */
+    dataCollection?: string;
+    /**
+     * @zh 锁集合名称
+     * @en Lock collection name
+     */
+    lockCollection?: string;
+}
+/**
+ * @zh MongoDB 存储
+ * @en MongoDB storage
+ *
+ * @zh 基于 MongoDB 的事务存储，使用 @esengine/database-drivers 的共享连接
+ * @en MongoDB-based transaction storage using shared connection from @esengine/database-drivers
+ *
+ * @example
+ * ```typescript
+ * import { createMongoConnection } from '@esengine/database-drivers'
+ * import { MongoStorage } from '@esengine/transaction'
+ *
+ * const mongo = createMongoConnection({
+ *     uri: 'mongodb://localhost:27017',
+ *     database: 'game'
+ * })
+ * await mongo.connect()
+ *
+ * const storage = new MongoStorage({ connection: mongo })
+ * ```
+ */
+export declare class MongoStorage implements ITransactionStorage {
+    private readonly _connection;
+    private readonly _transactionCollection;
+    private readonly _dataCollection;
+    private readonly _lockCollection;
+    private _closed;
+    constructor(config: MongoStorageConfig);
+    /**
+     * @zh 获取集合
+     * @en Get collection
+     */
+    private _getCollection;
+    /**
+     * @zh 关闭存储
+     * @en Close storage
+     *
+     * @zh 不会关闭共享连接，只标记存储为已关闭
+     * @en Does not close shared connection, only marks storage as closed
+     */
+    close(): Promise<void>;
+    /**
+     * @zh 支持 await using 语法
+     * @en Support await using syntax
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * @zh 确保索引存在
+     * @en Ensure indexes exist
+     */
+    ensureIndexes(): Promise<void>;
+    acquireLock(key: string, ttl: number): Promise<string | null>;
+    releaseLock(key: string, token: string): Promise<boolean>;
+    saveTransaction(tx: TransactionLog): Promise<void>;
+    getTransaction(id: string): Promise<TransactionLog | null>;
+    updateTransactionState(id: string, state: TransactionState): Promise<void>;
+    updateOperationState(transactionId: string, operationIndex: number, state: OperationLog['state'], error?: string): Promise<void>;
+    getPendingTransactions(serverId?: string): Promise<TransactionLog[]>;
+    deleteTransaction(id: string): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+}
+/**
+ * @zh 创建 MongoDB 存储
+ * @en Create MongoDB storage
+ *
+ * @example
+ * ```typescript
+ * import { createMongoConnection } from '@esengine/database-drivers'
+ * import { createMongoStorage } from '@esengine/transaction'
+ *
+ * const mongo = createMongoConnection({
+ *     uri: 'mongodb://localhost:27017',
+ *     database: 'game'
+ * })
+ * await mongo.connect()
+ *
+ * const storage = createMongoStorage(mongo)
+ * ```
+ */
+export declare function createMongoStorage(connection: IMongoConnection, options?: Omit<MongoStorageConfig, 'connection'>): MongoStorage;
+//# sourceMappingURL=MongoStorage.d.ts.map

package/dist/storage/MongoStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoStorage.d.ts","sourceRoot":"","sources":["../../src/storage/MongoStorage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,4BAA4B,CAAC;AACrF,OAAO,KAAK,EACR,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACf,MAAM,kBAAkB,CAAC;AAM1B;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;OAGG;IACH,UAAU,EAAE,gBAAgB,CAAA;IAE5B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAE9B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CAC1B;AAsBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAa,YAAW,mBAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,OAAO,CAAkB;gBAErB,MAAM,EAAE,kBAAkB;IAWtC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAYtB;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAuB7D,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUzD,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAclD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAU1D,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1E,oBAAoB,CACtB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAC5B,KAAK,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAwBV,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAepE,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IActC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAK9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAC9B,UAAU,EAAE,gBAAgB,EAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,GACjD,YAAY,CAEd"}

package/dist/storage/RedisStorage.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @zh Redis 存储实现
+ * @en Redis storage implementation
+ *
+ * @zh 支持分布式锁和快速缓存
+ * @en Supports distributed locking and fast caching
+ */
+import type { ITransactionStorage, TransactionLog, TransactionState, OperationLog } from '../core/types.js';
+/**
+ * @zh Redis 客户端接口（兼容 ioredis）
+ * @en Redis client interface (compatible with ioredis)
+ */
+export interface RedisClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ...args: string[]): Promise<string | null>;
+    del(...keys: string[]): Promise<number>;
+    eval(script: string, numkeys: number, ...args: (string | number)[]): Promise<unknown>;
+    hget(key: string, field: string): Promise<string | null>;
+    hset(key: string, ...args: (string | number)[]): Promise<number>;
+    hdel(key: string, ...fields: string[]): Promise<number>;
+    hgetall(key: string): Promise<Record<string, string>>;
+    keys(pattern: string): Promise<string[]>;
+    expire(key: string, seconds: number): Promise<number>;
+    quit(): Promise<string>;
+}
+/**
+ * @zh Redis 连接工厂
+ * @en Redis connection factory
+ */
+export type RedisClientFactory = () => RedisClient | Promise<RedisClient>;
+/**
+ * @zh Redis 存储配置
+ * @en Redis storage configuration
+ */
+export interface RedisStorageConfig {
+    /**
+     * @zh Redis 客户端工厂（惰性连接）
+     * @en Redis client factory (lazy connection)
+     *
+     * @example
+     * ```typescript
+     * import Redis from 'ioredis'
+     * const storage = new RedisStorage({
+     *     factory: () => new Redis('redis://localhost:6379')
+     * })
+     * ```
+     */
+    factory: RedisClientFactory;
+    /**
+     * @zh 键前缀
+     * @en Key prefix
+     */
+    prefix?: string;
+    /**
+     * @zh 事务日志过期时间（秒）
+     * @en Transaction log expiration time in seconds
+     */
+    transactionTTL?: number;
+}
+/**
+ * @zh Redis 存储
+ * @en Redis storage
+ *
+ * @zh 基于 Redis 的分布式事务存储，支持分布式锁和惰性连接
+ * @en Redis-based distributed transaction storage with distributed locking and lazy connection
+ *
+ * @example
+ * ```typescript
+ * import Redis from 'ioredis'
+ *
+ * // 创建存储（惰性连接，首次操作时才连接）
+ * const storage = new RedisStorage({
+ *     factory: () => new Redis('redis://localhost:6379')
+ * })
+ *
+ * // 使用后手动关闭
+ * await storage.close()
+ *
+ * // 或使用 await using 自动关闭 (TypeScript 5.2+)
+ * await using storage = new RedisStorage({
+ *     factory: () => new Redis('redis://localhost:6379')
+ * })
+ * // 作用域结束时自动关闭
+ * ```
+ */
+export declare class RedisStorage implements ITransactionStorage {
+    private _client;
+    private _factory;
+    private _prefix;
+    private _transactionTTL;
+    private _closed;
+    constructor(config: RedisStorageConfig);
+    /**
+     * @zh 获取 Redis 客户端（惰性连接）
+     * @en Get Redis client (lazy connection)
+     */
+    private _getClient;
+    /**
+     * @zh 关闭存储连接
+     * @en Close storage connection
+     */
+    close(): Promise<void>;
+    /**
+     * @zh 支持 await using 语法
+     * @en Support await using syntax
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    acquireLock(key: string, ttl: number): Promise<string | null>;
+    releaseLock(key: string, token: string): Promise<boolean>;
+    saveTransaction(tx: TransactionLog): Promise<void>;
+    getTransaction(id: string): Promise<TransactionLog | null>;
+    updateTransactionState(id: string, state: TransactionState): Promise<void>;
+    updateOperationState(transactionId: string, operationIndex: number, state: OperationLog['state'], error?: string): Promise<void>;
+    getPendingTransactions(serverId?: string): Promise<TransactionLog[]>;
+    deleteTransaction(id: string): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+}
+/**
+ * @zh 创建 Redis 存储
+ * @en Create Redis storage
+ */
+export declare function createRedisStorage(config: RedisStorageConfig): RedisStorage;
+//# sourceMappingURL=RedisStorage.d.ts.map

package/dist/storage/RedisStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisStorage.d.ts","sourceRoot":"","sources":["../../src/storage/RedisStorage.ts"],"names":[],"mappings":"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"}

package/dist/storage/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zh 存储模块导出
+ * @en Storage module exports
+ */
+export { MemoryStorage, createMemoryStorage, type MemoryStorageConfig } from './MemoryStorage.js';
+export { RedisStorage, createRedisStorage, type RedisStorageConfig, type RedisClient } from './RedisStorage.js';
+export { MongoStorage, createMongoStorage, type MongoStorageConfig } from './MongoStorage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}