@chevre/domain 24.0.0-alpha.14 → 24.0.0-alpha.16

package/lib/chevre/repo/transaction/moneyTransfer.d.ts

@@ -0,0 +1,61 @@
+import type { Connection, FilterQuery } from 'mongoose';
+import * as factory from '../../factory';
+type IKeyOfProjection = keyof Pick<factory.transaction.ITransaction<factory.transactionType.MoneyTransfer>, 'agent' | 'endDate' | 'expires' | 'project' | 'startDate' | 'status' | 'typeOf'> | Exclude<keyof factory.transaction.ITransaction<factory.transactionType.MoneyTransfer>, 'id'>;
+type IOmittedFieldsInProgress = 'tasksExportAction' | 'tasksExportedAt' | 'tasksExportationStatus';
+export type IMoneyTransferTransactionInProgress = Omit<factory.transaction.moneyTransfer.ITransaction, IOmittedFieldsInProgress>;
+type IStartedTransactionFields = 'expires' | 'id' | 'startDate' | 'status';
+export type IStartedTransaction = Pick<factory.transaction.ITransaction<factory.transactionType>, IStartedTransactionFields>;
+/**
+ * 通貨転送取引リポジトリ
+ */
+export declare class MoneyTransferRepo {
+    private readonly transactionModel;
+    constructor(connection: Connection);
+    static CREATE_MONGO_CONDITIONS(params: factory.transaction.ISearchConditions<factory.transactionType.MoneyTransfer>): FilterQuery<import("@chevre/factory/lib/assetTransaction/cancelReservation").ITransaction | import("@chevre/factory/lib/assetTransaction/moneyTransfer").ITransaction | import("@chevre/factory/lib/assetTransaction/pay").ITransaction | import("@chevre/factory/lib/assetTransaction/refund").ITransaction | import("@chevre/factory/lib/assetTransaction/registerService").ITransaction | import("@chevre/factory/lib/assetTransaction/reserve").ITransaction>[];
+    /**
+     * 取引を開始する
+     */
+    startMoneyTransfer(params: factory.transaction.IStartParams<factory.transactionType.MoneyTransfer>): Promise<IStartedTransaction>;
+    /**
+     * 特定取引検索
+     */
+    findMoneyTransferById(params: {
+        typeOf: factory.transactionType.MoneyTransfer;
+        id: string;
+    }, inclusion: IKeyOfProjection[]): Promise<factory.transaction.ITransaction<factory.transactionType.MoneyTransfer>>;
+    /**
+     * 進行中の取引を取得する
+     */
+    findMoneyTransferInProgressById(params: {
+        typeOf: factory.transactionType.MoneyTransfer;
+        id: string;
+    }, inclusion: IKeyOfProjection[]): Promise<IMoneyTransferTransactionInProgress>;
+    /**
+     * 取引を確定する
+     */
+    confirmMoneyTransfer(params: {
+        typeOf: factory.transactionType.MoneyTransfer;
+        id: string;
+        result: factory.transaction.IResult<factory.transactionType.MoneyTransfer>;
+        potentialActions: factory.transaction.IPotentialActions<factory.transactionType.MoneyTransfer>;
+    }): Promise<void>;
+    /**
+     * 取引を中止する
+     */
+    cancelMoneyTransfer(params: {
+        typeOf: factory.transactionType.MoneyTransfer;
+        id: string;
+    }): Promise<void>;
+    countMoneyTransfer(params: factory.transaction.ISearchConditions<factory.transactionType.MoneyTransfer>): Promise<{
+        count: number;
+    }>;
+    /**
+     * 取引を検索する
+     */
+    findMoneyTransferTransactions(params: factory.transaction.ISearchConditions<factory.transactionType.MoneyTransfer> & {
+        inclusion: IKeyOfProjection[];
+    }): Promise<(Pick<factory.transaction.ITransaction<factory.transactionType.MoneyTransfer>, IKeyOfProjection> & {
+        id: string;
+    })[]>;
+}
+export {};

package/lib/chevre/repo/transaction/moneyTransfer.js

@@ -0,0 +1,379 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoneyTransferRepo = void 0;
+const moment_1 = __importDefault(require("moment"));
+const transaction_1 = require("../../eventEmitter/transaction");
+const factory = __importStar(require("../../factory"));
+const settings_1 = require("../../settings");
+const transaction_2 = require("../mongoose/schemas/transaction");
+const AVAILABLE_PROJECT_FIELDS = [
+    'project',
+    'status',
+    'typeOf',
+    'agent',
+    'recipient',
+    'seller',
+    'error',
+    'result',
+    'object',
+    'expires',
+    'startDate',
+    'endDate',
+    'tasksExportAction',
+    'potentialActions',
+    // 'instrument'
+];
+/**
+ * 通貨転送取引リポジトリ
+ */
+class MoneyTransferRepo {
+    transactionModel;
+    constructor(connection) {
+        this.transactionModel = connection.model(transaction_2.modelName, (0, transaction_2.createSchema)());
+    }
+    static CREATE_MONGO_CONDITIONS(params) {
+        if (params.typeOf !== factory.transactionType.MoneyTransfer) {
+            throw new factory.errors.Argument('typeOf', `must be ${factory.transactionType.MoneyTransfer}`);
+        }
+        const andConditions = [];
+        const projectIdEq = params.project?.id?.$eq;
+        if (typeof projectIdEq === 'string') {
+            andConditions.push({ 'project.id': { $eq: projectIdEq } });
+        }
+        if (typeof params.typeOf === 'string') {
+            andConditions.push({ typeOf: { $eq: params.typeOf } });
+        }
+        if (params.startFrom !== undefined) {
+            andConditions.push({
+                startDate: { $gte: params.startFrom }
+            });
+        }
+        if (params.startThrough !== undefined) {
+            andConditions.push({
+                startDate: { $lte: params.startThrough }
+            });
+        }
+        if (params.endFrom !== undefined) {
+            andConditions.push({
+                endDate: {
+                    $exists: true,
+                    $gte: params.endFrom
+                }
+            });
+        }
+        if (params.endThrough !== undefined) {
+            andConditions.push({
+                endDate: {
+                    $exists: true,
+                    $lt: params.endThrough
+                }
+            });
+        }
+        if (Array.isArray(params.ids)) {
+            andConditions.push({
+                _id: { $in: params.ids }
+            });
+        }
+        if (Array.isArray(params.statuses)) {
+            andConditions.push({ status: { $in: params.statuses } });
+        }
+        const statusIn = params.status?.$in;
+        if (Array.isArray(statusIn)) {
+            andConditions.push({ status: { $in: statusIn } });
+        }
+        if (params.agent !== undefined) {
+            if (params.agent.typeOf !== undefined) {
+                andConditions.push({
+                    'agent.typeOf': {
+                        $exists: true,
+                        $eq: params.agent.typeOf
+                    }
+                });
+            }
+            if (Array.isArray(params.agent.ids)) {
+                andConditions.push({
+                    'agent.id': {
+                        $exists: true,
+                        $in: params.agent.ids
+                    }
+                });
+            }
+            if (Array.isArray(params.agent.identifiers)) {
+                andConditions.push({
+                    'agent.identifier': {
+                        $exists: true,
+                        $in: params.agent.identifiers
+                    }
+                });
+            }
+        }
+        const tasksExportActionStatusIn = params.tasksExportAction?.actionStatus?.$in;
+        if (Array.isArray(tasksExportActionStatusIn)) {
+            andConditions.push({ 'tasksExportAction.actionStatus': { $exists: true, $in: tasksExportActionStatusIn } });
+        }
+        const tasksExportActionStatusEq = params.tasksExportAction?.actionStatus?.$eq;
+        if (typeof tasksExportActionStatusEq === 'string') {
+            andConditions.push({ 'tasksExportAction.actionStatus': { $exists: true, $eq: tasksExportActionStatusEq } });
+        }
+        switch (params.typeOf) {
+            case factory.transactionType.PlaceOrder:
+                throw new factory.errors.NotImplemented(`use PlaceOrderRepo`);
+            case factory.transactionType.ReturnOrder:
+                throw new factory.errors.NotImplemented(`use ReturnOrderRepo`);
+            default:
+        }
+        return andConditions;
+    }
+    /**
+     * 取引を開始する
+     */
+    // public async startNoPlaceOrder<
+    async startMoneyTransfer(params) {
+        const status = factory.transactionStatusType.InProgress;
+        const tasksExportAction = { actionStatus: factory.actionStatusType.PotentialActionStatus };
+        // const tasksExportationStatus = factory.transactionTasksExportationStatus.Unexported; // discontinue(2024-06-20~)
+        const startDate = new Date();
+        // let expires: Date;
+        const { typeOf } = params;
+        const expires = params.expires;
+        let creatingTransaction;
+        if (typeOf === factory.transactionType.MoneyTransfer) {
+            const { agent, project, object, seller, recipient } = params;
+            creatingTransaction = {
+                status, startDate, expires, typeOf, tasksExportAction,
+                agent, project, seller, object, recipient
+            };
+        }
+        else {
+            throw new factory.errors.NotImplemented(`${typeOf} not implemented`);
+        }
+        // reimplemnt with insertMany(2024-05-30~)
+        const result = await this.transactionModel.insertMany(creatingTransaction, { rawResult: true });
+        const id = result.insertedIds?.[0]?.toHexString();
+        if (typeof id !== 'string') {
+            throw new factory.errors.Internal('transaction not saved');
+        }
+        // 取引開始時にも取引イベントエミッター連携(2024-03-21~)
+        transaction_1.transactionEventEmitter.emitTransactionStatusChanged({ id, typeOf, status });
+        return { expires, id, startDate, status }; // minimize response(2024-05-30~)
+    }
+    /**
+     * 特定取引検索
+     */
+    async findMoneyTransferById(params, inclusion // make required(2024-05-31~)
+    ) {
+        let positiveProjectionFields = AVAILABLE_PROJECT_FIELDS;
+        if (Array.isArray(inclusion) && inclusion.length > 0) {
+            positiveProjectionFields = positiveProjectionFields.filter((key) => inclusion.includes(key));
+        }
+        else {
+            throw new factory.errors.NotImplemented('inclusion must be specified'); // 2024-08-26~
+        }
+        const projection = {
+            _id: 0,
+            id: { $toString: '$_id' },
+            ...Object.fromEntries(positiveProjectionFields.map((key) => ([key, 1])))
+        };
+        const doc = await this.transactionModel.findOne({
+            _id: { $eq: params.id },
+            typeOf: { $eq: params.typeOf }
+        }, projection)
+            .lean() // 2024-08-26~
+            .exec();
+        if (doc === null) {
+            throw new factory.errors.NotFound(this.transactionModel.modelName, `${params.typeOf} not found`);
+        }
+        return doc;
+    }
+    /**
+     * 進行中の取引を取得する
+     */
+    async findMoneyTransferInProgressById(params, inclusion // make required(2024-05-29~)
+    ) {
+        let positiveProjectionFields = AVAILABLE_PROJECT_FIELDS;
+        if (Array.isArray(inclusion) && inclusion.length > 0) {
+            positiveProjectionFields = positiveProjectionFields.filter((key) => inclusion.includes(key));
+        }
+        else {
+            throw new factory.errors.NotImplemented('inclusion must be specified'); // 2024-08-26~
+        }
+        const projection = {
+            _id: 0,
+            id: { $toString: '$_id' },
+            ...Object.fromEntries(positiveProjectionFields.map((key) => ([key, 1])))
+        };
+        const filter = {
+            _id: { $eq: params.id },
+            typeOf: { $eq: params.typeOf },
+            status: { $eq: factory.transactionStatusType.InProgress },
+            // expiresを条件に追加(2023-05-12~),
+            expires: { $gt: new Date() }
+        };
+        const doc = await this.transactionModel.findOne(filter, projection)
+            .lean() // 2024-08-26~
+            .exec();
+        if (doc === null) {
+            throw new factory.errors.NotFound(this.transactionModel.modelName, `${params.typeOf} ${factory.transactionStatusType.InProgress} not found`);
+        }
+        return doc;
+    }
+    /**
+     * 取引を確定する
+     */
+    // public async confirmNoPlaceOrder<
+    async confirmMoneyTransfer(params) {
+        const endDate = new Date();
+        const doc = await this.transactionModel.findOneAndUpdate({
+            _id: { $eq: params.id },
+            typeOf: { $eq: params.typeOf },
+            status: { $eq: factory.transactionStatusType.InProgress },
+            expires: { $gt: endDate } // add expires(2025-02-27~)
+        }, {
+            status: factory.transactionStatusType.Confirmed, // ステータス変更
+            endDate,
+            // 'object.authorizeActions': params.authorizeActions,
+            result: params.result, // resultを更新
+            potentialActions: params.potentialActions // resultを更新
+        }, {
+            new: true,
+            projection: { _id: 1 }
+        })
+            .lean()
+            .exec();
+        // NotFoundであれば取引状態確認
+        if (doc === null) {
+            const { expires, status } = await this.findMoneyTransferById({ typeOf: params.typeOf, id: params.id }, ['expires', 'status']);
+            if (status === factory.transactionStatusType.Confirmed) {
+                // すでに確定済の場合スルー
+            }
+            else if (status === factory.transactionStatusType.Expired) {
+                throw new factory.errors.Argument('Transaction id', 'Already expired');
+            }
+            else if (status === factory.transactionStatusType.Canceled) {
+                throw new factory.errors.Argument('Transaction id', 'Already canceled');
+            }
+            else {
+                if ((0, moment_1.default)(expires)
+                    .isSameOrBefore((0, moment_1.default)(endDate))) {
+                    throw new factory.errors.Argument('Transaction id', 'potentially expired');
+                }
+                throw new factory.errors.NotFound(this.transactionModel.modelName, `${params.typeOf} ${factory.transactionStatusType.InProgress} not found`);
+            }
+        }
+        transaction_1.transactionEventEmitter.emitTransactionStatusChanged({
+            id: params.id,
+            typeOf: params.typeOf,
+            status: factory.transactionStatusType.Confirmed
+        });
+    }
+    /**
+     * 取引を中止する
+     */
+    async cancelMoneyTransfer(params) {
+        const endDate = new Date();
+        // 進行中ステータスの取引を中止する
+        const doc = await this.transactionModel.findOneAndUpdate({
+            typeOf: params.typeOf,
+            _id: params.id,
+            status: factory.transactionStatusType.InProgress
+        }, {
+            status: factory.transactionStatusType.Canceled,
+            endDate: endDate
+        }, {
+            new: true,
+            projection: { _id: 1 }
+        })
+            .lean()
+            .exec();
+        // NotFoundであれば取引状態確認
+        if (doc === null) {
+            const { status } = await this.findMoneyTransferById(params, ['status']);
+            if (status === factory.transactionStatusType.Canceled) {
+                // すでに中止済の場合スルー
+            }
+            else if (status === factory.transactionStatusType.Expired) {
+                throw new factory.errors.Argument('Transaction id', 'Transaction already expired');
+            }
+            else if (status === factory.transactionStatusType.Confirmed) {
+                throw new factory.errors.Argument('Transaction id', 'Confirmed transaction unable to cancel');
+            }
+            else {
+                throw new factory.errors.NotFound(this.transactionModel.modelName, `${params.typeOf} ${factory.transactionStatusType.InProgress} not found`);
+            }
+        }
+        transaction_1.transactionEventEmitter.emitTransactionStatusChanged({
+            id: params.id,
+            typeOf: params.typeOf,
+            status: factory.transactionStatusType.Canceled
+        });
+    }
+    async countMoneyTransfer(params) {
+        const { limit } = params;
+        const conditions = MoneyTransferRepo.CREATE_MONGO_CONDITIONS(params);
+        const query = this.transactionModel.countDocuments((conditions.length > 0) ? { $and: conditions } : {});
+        if (typeof limit === 'number' && limit >= 0) {
+            query.limit(limit);
+        }
+        const count = await query.setOptions({ maxTimeMS: settings_1.MONGO_MAX_TIME_MS })
+            .exec();
+        return { count };
+    }
+    /**
+     * 取引を検索する
+     */
+    async findMoneyTransferTransactions(params) {
+        const { inclusion } = params;
+        const conditions = MoneyTransferRepo.CREATE_MONGO_CONDITIONS(params);
+        let positiveProjectionFields = AVAILABLE_PROJECT_FIELDS;
+        if (Array.isArray(inclusion) && inclusion.length > 0) {
+            positiveProjectionFields = positiveProjectionFields.filter((key) => inclusion.includes(key));
+        }
+        const projection = {
+            _id: 0,
+            id: { $toString: '$_id' },
+            ...Object.fromEntries(positiveProjectionFields.map((key) => ([key, 1])))
+        };
+        const query = this.transactionModel.find((conditions.length > 0) ? { $and: conditions } : {})
+            .select(projection);
+        if (typeof params.limit === 'number' && params.limit > 0) {
+            const page = (typeof params.page === 'number' && params.page > 0) ? params.page : 1;
+            query.limit(params.limit)
+                .skip(params.limit * (page - 1));
+        }
+        if (params.sort?.startDate !== undefined) {
+            query.sort({ startDate: params.sort.startDate });
+        }
+        // const explainResult = await (<any>query).explain();
+        // console.log(explainResult[0].executionStats.allPlansExecution.map((e: any) => e.executionStages.inputStage));
+        return query.setOptions({ maxTimeMS: settings_1.MONGO_MAX_TIME_MS })
+            .lean()
+            .exec();
+    }
+}
+exports.MoneyTransferRepo = MoneyTransferRepo;

package/lib/chevre/repo/transaction/returnOrder.d.ts

@@ -1,6 +1,8 @@
 import type { Connection, FilterQuery } from 'mongoose';
 import * as factory from '../../factory';
 type IKeyOfProjection = keyof Pick<factory.transaction.ITransaction<factory.transactionType.ReturnOrder>, 'agent' | 'endDate' | 'expires' | 'project' | 'startDate' | 'status' | 'typeOf'> | Exclude<keyof factory.transaction.ITransaction<factory.transactionType.ReturnOrder>, 'id'>;
+type IStartedTransactionFields = 'expires' | 'id' | 'startDate' | 'status';
+export type IStartedTransaction = Pick<factory.transaction.ITransaction<factory.transactionType.ReturnOrder>, IStartedTransactionFields>;
 /**
  * 返品取引リポジトリ
  */
@@ -19,5 +21,25 @@ export declare class ReturnOrderRepo {
     }): Promise<(Pick<factory.transaction.ITransaction<factory.transactionType.ReturnOrder>, IKeyOfProjection> & {
         id: string;
     })[]>;
+    /**
+     * 取引を開始する
+     */
+    startReturnOrder(params: factory.transaction.IStartParams<factory.transactionType.ReturnOrder>): Promise<IStartedTransaction>;
+    /**
+     * 特定取引検索
+     */
+    findReturnOrderById(params: {
+        typeOf: factory.transactionType.ReturnOrder;
+        id: string;
+    }, inclusion: IKeyOfProjection[]): Promise<factory.transaction.ITransaction<factory.transactionType.ReturnOrder>>;
+    /**
+     * 取引を確定する
+     */
+    confirmReturnOrder(params: {
+        typeOf: factory.transactionType.ReturnOrder;
+        id: string;
+        result: factory.transaction.IResult<factory.transactionType.ReturnOrder>;
+        potentialActions: factory.transaction.IPotentialActions<factory.transactionType.ReturnOrder>;
+    }): Promise<void>;
 }
 export {};

package/lib/chevre/repo/transaction/returnOrder.js

@@ -22,12 +22,16 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReturnOrderRepo = void 0;
-// import { transactionEventEmitter } from '../../eventEmitter/transaction';
+const moment_1 = __importDefault(require("moment"));
+const transaction_1 = require("../../eventEmitter/transaction");
 const factory = __importStar(require("../../factory"));
 const settings_1 = require("../../settings");
-const transaction_1 = require("../mongoose/schemas/transaction");
+const transaction_2 = require("../mongoose/schemas/transaction");
 const AVAILABLE_PROJECT_FIELDS = [
     'project',
     'status',
@@ -45,17 +49,13 @@ const AVAILABLE_PROJECT_FIELDS = [
     'potentialActions',
     // 'instrument'
 ];
-// type IOmittedFieldsInProgress = 'tasksExportAction' | 'tasksExportedAt' | 'tasksExportationStatus';
-// export type IMoneyTransferTransactionInProgress = Omit<factory.transaction.moneyTransfer.ITransaction, IOmittedFieldsInProgress>;
-// type IStartedTransactionFields = 'expires' | 'id' | 'startDate' | 'status';
-// export type IStartedTransaction = Pick<factory.transaction.ITransaction<factory.transactionType>, IStartedTransactionFields>;
 /**
  * 返品取引リポジトリ
  */
 class ReturnOrderRepo {
     transactionModel;
     constructor(connection) {
-        this.transactionModel = connection.model(transaction_1.modelName, (0, transaction_1.createSchema)());
+        this.transactionModel = connection.model(transaction_2.modelName, (0, transaction_2.createSchema)());
     }
     static CREATE_MONGO_CONDITIONS(params) {
         if (params.typeOf !== factory.transactionType.ReturnOrder) {
@@ -209,5 +209,133 @@ class ReturnOrderRepo {
             .lean()
             .exec();
     }
+    /**
+     * 取引を開始する
+     */
+    async startReturnOrder(params) {
+        const status = factory.transactionStatusType.InProgress;
+        const tasksExportAction = { actionStatus: factory.actionStatusType.PotentialActionStatus };
+        // const tasksExportationStatus = factory.transactionTasksExportationStatus.Unexported; // discontinue(2024-06-20~)
+        const startDate = new Date();
+        let expires;
+        const { typeOf } = params;
+        // expiresInSecondsの指定があれば優先して適用する(2022-11-25~)
+        if (typeof params.expiresInSeconds === 'number' && params.expiresInSeconds > 0) {
+            expires = (0, moment_1.default)(startDate)
+                .add(params.expiresInSeconds, 'seconds')
+                .toDate();
+        }
+        else {
+            throw new factory.errors.ArgumentNull('expiresInSeconds');
+        }
+        let creatingTransaction;
+        if (typeOf === factory.transactionType.ReturnOrder) {
+            const { agent, project, object, seller } = params;
+            creatingTransaction = {
+                status, startDate, expires, typeOf, tasksExportAction,
+                agent, project, seller, object
+            };
+        }
+        else {
+            throw new factory.errors.NotImplemented(`${typeOf} not implemented`);
+        }
+        // reimplemnt with insertMany(2024-05-30~)
+        const result = await this.transactionModel.insertMany(creatingTransaction, { rawResult: true });
+        const id = result.insertedIds?.[0]?.toHexString();
+        if (typeof id !== 'string') {
+            throw new factory.errors.Internal('transaction not saved');
+        }
+        // 取引開始時にも取引イベントエミッター連携(2024-03-21~)
+        transaction_1.transactionEventEmitter.emitTransactionStatusChanged({ id, typeOf, status });
+        return { expires, id, startDate, status }; // minimize response(2024-05-30~)
+    }
+    /**
+     * 特定取引検索
+     */
+    async findReturnOrderById(params, inclusion // make required(2024-05-31~)
+    ) {
+        let positiveProjectionFields = AVAILABLE_PROJECT_FIELDS;
+        if (Array.isArray(inclusion) && inclusion.length > 0) {
+            positiveProjectionFields = positiveProjectionFields.filter((key) => inclusion.includes(key));
+        }
+        else {
+            throw new factory.errors.NotImplemented('inclusion must be specified'); // 2024-08-26~
+        }
+        const projection = {
+            _id: 0,
+            id: { $toString: '$_id' },
+            ...Object.fromEntries(positiveProjectionFields.map((key) => ([key, 1])))
+        };
+        // let projection: { [key in (IKeyOfProjection<T> | '__v' | 'createdAt' | 'updatedAt')]?: AnyExpression } = {};
+        // if (Array.isArray(inclusion) && inclusion.length > 0) {
+        //     inclusion.forEach((field) => {
+        //         projection[field] = 1;
+        //     });
+        // } else {
+        //     projection = {
+        //         __v: 0,
+        //         createdAt: 0,
+        //         updatedAt: 0
+        //     };
+        // }
+        const doc = await this.transactionModel.findOne({
+            _id: { $eq: params.id },
+            typeOf: { $eq: params.typeOf }
+        }, projection)
+            .lean() // 2024-08-26~
+            .exec();
+        if (doc === null) {
+            throw new factory.errors.NotFound(this.transactionModel.modelName, `${params.typeOf} not found`);
+        }
+        return doc;
+    }
+    /**
+     * 取引を確定する
+     */
+    async confirmReturnOrder(params) {
+        const endDate = new Date();
+        const doc = await this.transactionModel.findOneAndUpdate({
+            _id: { $eq: params.id },
+            typeOf: { $eq: params.typeOf },
+            status: { $eq: factory.transactionStatusType.InProgress },
+            expires: { $gt: endDate } // add expires(2025-02-27~)
+        }, {
+            status: factory.transactionStatusType.Confirmed, // ステータス変更
+            endDate,
+            // 'object.authorizeActions': params.authorizeActions,
+            result: params.result, // resultを更新
+            potentialActions: params.potentialActions // resultを更新
+        }, {
+            new: true,
+            projection: { _id: 1 }
+        })
+            .lean()
+            .exec();
+        // NotFoundであれば取引状態確認
+        if (doc === null) {
+            const { expires, status } = await this.findReturnOrderById({ typeOf: params.typeOf, id: params.id }, ['expires', 'status']);
+            if (status === factory.transactionStatusType.Confirmed) {
+                // すでに確定済の場合スルー
+            }
+            else if (status === factory.transactionStatusType.Expired) {
+                throw new factory.errors.Argument('Transaction id', 'Already expired');
+            }
+            else if (status === factory.transactionStatusType.Canceled) {
+                throw new factory.errors.Argument('Transaction id', 'Already canceled');
+            }
+            else {
+                if ((0, moment_1.default)(expires)
+                    .isSameOrBefore((0, moment_1.default)(endDate))) {
+                    throw new factory.errors.Argument('Transaction id', 'potentially expired');
+                }
+                throw new factory.errors.NotFound(this.transactionModel.modelName, `${params.typeOf} ${factory.transactionStatusType.InProgress} not found`);
+            }
+        }
+        transaction_1.transactionEventEmitter.emitTransactionStatusChanged({
+            id: params.id,
+            typeOf: params.typeOf,
+            status: factory.transactionStatusType.Confirmed
+        });
+    }
 }
 exports.ReturnOrderRepo = ReturnOrderRepo;