@mercurjs/core 2.3.6-canary.0 → 2.3.6-canary.10

package/.medusa/server/src/workflows/payment/utils/split-order-payment-group.d.ts

@@ -0,0 +1,141 @@
+import { BigNumberInput, LinkDefinition, MedusaContainer } from "@medusajs/framework/types";
+/** Set on a cart's payment collection once it is split into its orders'. */
+export declare const SPLIT_ORDER_COLLECTIONS_FLAG = "split_order_collections";
+/** Set on an order's payment collection, pointing at the cart's. */
+export declare const CART_PAYMENT_COLLECTION_KEY = "cart_payment_collection_id";
+type PaymentMovement = {
+    id: string;
+    amount: BigNumberInput;
+    raw_amount?: BigNumberInput | null;
+};
+export type SplitOrderGroupPayment = {
+    id: string;
+    provider_id: string;
+    currency_code: string;
+    amount: BigNumberInput;
+    raw_amount?: BigNumberInput | null;
+    data?: Record<string, unknown> | null;
+    captured_at?: Date | string | null;
+    canceled_at?: Date | string | null;
+    captures?: PaymentMovement[] | null;
+    refunds?: PaymentMovement[] | null;
+};
+export type SplitOrderGroupCollection = {
+    id: string;
+    currency_code: string;
+    metadata?: Record<string, unknown> | null;
+    payments?: SplitOrderGroupPayment[] | null;
+};
+export type SplitOrderGroupOrder = {
+    id: string;
+    status: string;
+    canceled_at?: Date | string | null;
+    total: BigNumberInput;
+    payment_collections?: SplitOrderGroupCollection[] | null;
+};
+/** Fields to query on `cart_payment_collection` to plan a split or a void. */
+export declare const cartPaymentCollectionFields: string[];
+/** Fields to query on `order_cart` to plan a split or a void. */
+export declare const cartOrderFields: string[];
+export declare const isPaymentCaptured: (payment: SplitOrderGroupPayment) => boolean;
+export declare const isOrderCanceled: (order: {
+    status: string;
+    canceled_at?: Date | string | null;
+}) => boolean;
+export declare const hasSplitOrderCollections: (paymentCollection?: {
+    metadata?: Record<string, unknown> | null;
+} | null) => boolean;
+/**
+ * The payment collections that pay for an order. Until the cart payment is
+ * captured that is the cart's shared collection; afterwards the order has its
+ * own. An order canceled before the capture never gets one and keeps showing
+ * the cart's.
+ */
+export declare const resolveOrderPaymentCollections: (order: {
+    cart?: {
+        payment_collection?: {
+            metadata?: Record<string, unknown> | null;
+        } | null;
+    } | null;
+    payment_collections?: unknown[];
+}) => unknown[];
+/**
+ * Resolves the cart a payment or an order belongs to. A payment can be the
+ * cart's own or one created for an order when the cart payment was split.
+ */
+export declare const resolveSplitOrderCartId: (container: MedusaContainer, input: {
+    order_id: string;
+} | {
+    payment_id: string;
+}) => Promise<string | undefined>;
+export type CartPaymentSplitPlan = {
+    /** Payment collections to create, one per order that has none yet. */
+    collections: {
+        order_id: string;
+        currency_code: string;
+        amount: BigNumberInput;
+        metadata: Record<string, unknown>;
+    }[];
+    /**
+     * Payments to create. `payment_collection_id` is unset for an order whose
+     * collection is created in the same run.
+     */
+    payments: {
+        order_id: string;
+        payment_collection_id?: string;
+        provider_id: string;
+        currency_code: string;
+        amount: BigNumberInput;
+        data: Record<string, unknown>;
+    }[];
+    /**
+     * Captures to record. `payment_id` is unset for an order whose payment is
+     * created in the same run.
+     */
+    captures: {
+        order_id: string;
+        payment_id?: string;
+        amount: BigNumberInput;
+    }[];
+    /**
+     * Captures the orders' payments already hold. Their order transactions are
+     * written again on every run, which is a no-op unless an earlier run stopped
+     * between recording a capture and writing its transaction.
+     */
+    recorded: {
+        order_id: string;
+        currency_code: string;
+        capture_id: string;
+        amount: BigNumberInput;
+    }[];
+    /** What was charged for orders canceled before the capture. */
+    refunds: {
+        payment_id: string;
+        amount: BigNumberInput;
+        note: string;
+    }[];
+    /** Set when the cart collection still has to be flagged as split. */
+    cart_payment_collection?: {
+        id: string;
+        metadata: Record<string, unknown>;
+    };
+};
+/**
+ * Works out what is missing for every order of a cart to hold its share of
+ * what the cart payment has captured. Only ever plans the difference, so a
+ * cart that is already split yields an empty plan.
+ */
+export declare const planCartPaymentSplit: (cartCollection: SplitOrderGroupCollection | null | undefined, orders: SplitOrderGroupOrder[]) => CartPaymentSplitPlan;
+/** The links between the orders and the payment collections created for them. */
+export declare const buildOrderPaymentCollectionLinks: (plan: CartPaymentSplitPlan, createdCollections: {
+    id: string;
+}[]) => LinkDefinition[];
+/**
+ * The cart payment to void: set once every order of the cart is canceled and
+ * nothing of the payment was captured.
+ */
+export declare const planCartPaymentVoid: (cartCollection: SplitOrderGroupCollection | null | undefined, orders: SplitOrderGroupOrder[]) => {
+    payment_ids: string[];
+    payment_collection_ids: string[];
+};
+export {};

package/.medusa/server/src/workflows/payment/utils/split-order-payment-group.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planCartPaymentVoid = exports.buildOrderPaymentCollectionLinks = exports.planCartPaymentSplit = exports.resolveSplitOrderCartId = exports.resolveOrderPaymentCollections = exports.hasSplitOrderCollections = exports.isOrderCanceled = exports.isPaymentCaptured = exports.cartOrderFields = exports.cartPaymentCollectionFields = exports.CART_PAYMENT_COLLECTION_KEY = exports.SPLIT_ORDER_COLLECTIONS_FLAG = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const split_order_payment_1 = require("./split-order-payment");
+/** Set on a cart's payment collection once it is split into its orders'. */
+exports.SPLIT_ORDER_COLLECTIONS_FLAG = "split_order_collections";
+/** Set on an order's payment collection, pointing at the cart's. */
+exports.CART_PAYMENT_COLLECTION_KEY = "cart_payment_collection_id";
+const PAYMENT_FIELDS = [
+    "id",
+    "provider_id",
+    "currency_code",
+    "amount",
+    "raw_amount",
+    "data",
+    "captured_at",
+    "canceled_at",
+    "captures.id",
+    "captures.amount",
+    "captures.raw_amount",
+    "refunds.id",
+    "refunds.amount",
+    "refunds.raw_amount",
+];
+const COLLECTION_FIELDS = [
+    "id",
+    "currency_code",
+    "metadata",
+    ...PAYMENT_FIELDS.map((field) => `payments.${field}`),
+];
+/** Fields to query on `cart_payment_collection` to plan a split or a void. */
+exports.cartPaymentCollectionFields = COLLECTION_FIELDS.map((field) => `payment_collection.${field}`);
+/** Fields to query on `order_cart` to plan a split or a void. */
+exports.cartOrderFields = [
+    "order.id",
+    "order.status",
+    "order.canceled_at",
+    "order.total",
+    ...COLLECTION_FIELDS.map((field) => `order.payment_collections.${field}`),
+];
+const amountOf = (movement) => movement.raw_amount ?? movement.amount;
+const sum = (movements) => (movements ?? []).reduce((acc, movement) => utils_1.MathBN.add(acc, amountOf(movement)), utils_1.MathBN.convert(0));
+const isPaymentCaptured = (payment) => !!payment.captured_at || (payment.captures ?? []).length > 0;
+exports.isPaymentCaptured = isPaymentCaptured;
+const isOrderCanceled = (order) => order.status === utils_1.OrderStatus.CANCELED || !!order.canceled_at;
+exports.isOrderCanceled = isOrderCanceled;
+const hasSplitOrderCollections = (paymentCollection) => paymentCollection?.metadata?.[exports.SPLIT_ORDER_COLLECTIONS_FLAG] === true;
+exports.hasSplitOrderCollections = hasSplitOrderCollections;
+/**
+ * The payment collections that pay for an order. Until the cart payment is
+ * captured that is the cart's shared collection; afterwards the order has its
+ * own. An order canceled before the capture never gets one and keeps showing
+ * the cart's.
+ */
+const resolveOrderPaymentCollections = (order) => {
+    const own = order.payment_collections ?? [];
+    const cartPaymentCollection = order.cart?.payment_collection;
+    if (!cartPaymentCollection) {
+        return own;
+    }
+    return (0, exports.hasSplitOrderCollections)(cartPaymentCollection) && own.length
+        ? own
+        : [cartPaymentCollection];
+};
+exports.resolveOrderPaymentCollections = resolveOrderPaymentCollections;
+/**
+ * Resolves the cart a payment or an order belongs to. A payment can be the
+ * cart's own or one created for an order when the cart payment was split.
+ */
+const resolveSplitOrderCartId = async (container, input) => {
+    const query = container.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+    if ("order_id" in input) {
+        const { data: [orderCart], } = await query.graph({
+            entity: "order_cart",
+            fields: ["cart_id"],
+            filters: { order_id: input.order_id },
+        });
+        return orderCart?.cart_id;
+    }
+    const { data: [payment], } = await query.graph({
+        entity: "payment",
+        fields: ["id", "payment_collection.id", "payment_collection.metadata"],
+        filters: { id: input.payment_id },
+    });
+    const collection = payment?.payment_collection;
+    if (!collection) {
+        return undefined;
+    }
+    const { data: [cartLink], } = await query.graph({
+        entity: "cart_payment_collection",
+        fields: ["cart_id"],
+        filters: {
+            payment_collection_id: collection.metadata?.[exports.CART_PAYMENT_COLLECTION_KEY] ?? collection.id,
+        },
+    });
+    return cartLink?.cart_id;
+};
+exports.resolveSplitOrderCartId = resolveSplitOrderCartId;
+const getCartPayment = (collection) => (collection?.payments ?? []).find((payment) => !payment.canceled_at);
+const getOrderCollection = (order, cartCollectionId) => (order.payment_collections ?? []).find((collection) => collection.metadata?.[exports.CART_PAYMENT_COLLECTION_KEY] === cartCollectionId);
+const EMPTY_PLAN = {
+    collections: [],
+    payments: [],
+    captures: [],
+    recorded: [],
+    refunds: [],
+};
+/**
+ * Works out what is missing for every order of a cart to hold its share of
+ * what the cart payment has captured. Only ever plans the difference, so a
+ * cart that is already split yields an empty plan.
+ */
+const planCartPaymentSplit = (cartCollection, orders) => {
+    const cartPayment = getCartPayment(cartCollection);
+    if (!cartCollection || !cartPayment || !orders.length) {
+        return EMPTY_PLAN;
+    }
+    const captured = sum(cartPayment.captures);
+    if (!utils_1.MathBN.gt(captured, 0)) {
+        return EMPTY_PLAN;
+    }
+    const decimalDigits = (0, split_order_payment_1.getCurrencyDecimalDigits)(cartPayment.currency_code);
+    const weights = orders.map((order) => order.total);
+    // What each order is entitled to of the authorization, and of the part of
+    // it captured so far.
+    const shares = (0, split_order_payment_1.allocateProportionally)({
+        amount: amountOf(cartPayment),
+        weights,
+        decimalDigits,
+    });
+    const targets = (0, split_order_payment_1.allocateProportionally)({
+        amount: captured,
+        weights,
+        decimalDigits,
+    });
+    const plan = {
+        collections: [],
+        payments: [],
+        captures: [],
+        recorded: [],
+        refunds: [],
+    };
+    let attributed = utils_1.MathBN.convert(0);
+    orders.forEach((order, index) => {
+        const collection = getOrderCollection(order, cartCollection.id);
+        const payment = collection?.payments?.[0];
+        const recorded = sum(payment?.captures);
+        const missing = utils_1.MathBN.sub(targets[index], recorded);
+        attributed = utils_1.MathBN.add(attributed, recorded);
+        for (const capture of payment?.captures ?? []) {
+            plan.recorded.push({
+                order_id: order.id,
+                currency_code: cartPayment.currency_code,
+                capture_id: capture.id,
+                amount: amountOf(capture),
+            });
+        }
+        // An order canceled before the capture is not paid: its part of the
+        // charge stays unattributed and is refunded.
+        if ((0, exports.isOrderCanceled)(order) || !utils_1.MathBN.gt(missing, 0)) {
+            return;
+        }
+        if (!collection) {
+            plan.collections.push({
+                order_id: order.id,
+                currency_code: cartPayment.currency_code,
+                amount: shares[index],
+                metadata: { [exports.CART_PAYMENT_COLLECTION_KEY]: cartCollection.id },
+            });
+        }
+        if (!payment) {
+            plan.payments.push({
+                order_id: order.id,
+                payment_collection_id: collection?.id,
+                provider_id: cartPayment.provider_id,
+                currency_code: cartPayment.currency_code,
+                amount: shares[index],
+                data: cartPayment.data ?? {},
+            });
+        }
+        plan.captures.push({
+            order_id: order.id,
+            payment_id: payment?.id,
+            amount: missing,
+        });
+        attributed = utils_1.MathBN.add(attributed, missing);
+    });
+    const unattributed = utils_1.MathBN.sub(captured, attributed, sum(cartPayment.refunds));
+    if (utils_1.MathBN.gt(unattributed, 0)) {
+        plan.refunds.push({
+            payment_id: cartPayment.id,
+            amount: unattributed,
+            note: "Share of orders canceled before the payment was captured",
+        });
+    }
+    if (!(0, exports.hasSplitOrderCollections)(cartCollection)) {
+        plan.cart_payment_collection = {
+            id: cartCollection.id,
+            metadata: {
+                ...cartCollection.metadata,
+                [exports.SPLIT_ORDER_COLLECTIONS_FLAG]: true,
+            },
+        };
+    }
+    return plan;
+};
+exports.planCartPaymentSplit = planCartPaymentSplit;
+/** The links between the orders and the payment collections created for them. */
+const buildOrderPaymentCollectionLinks = (plan, createdCollections) => plan.collections.map((collection, index) => ({
+    [utils_1.Modules.ORDER]: { order_id: collection.order_id },
+    [utils_1.Modules.PAYMENT]: { payment_collection_id: createdCollections[index].id },
+}));
+exports.buildOrderPaymentCollectionLinks = buildOrderPaymentCollectionLinks;
+/**
+ * The cart payment to void: set once every order of the cart is canceled and
+ * nothing of the payment was captured.
+ */
+const planCartPaymentVoid = (cartCollection, orders) => {
+    const cartPayment = getCartPayment(cartCollection);
+    if (!cartCollection ||
+        !cartPayment ||
+        !orders.length ||
+        (0, exports.isPaymentCaptured)(cartPayment) ||
+        !orders.every(exports.isOrderCanceled)) {
+        return { payment_ids: [], payment_collection_ids: [] };
+    }
+    return {
+        payment_ids: [cartPayment.id],
+        payment_collection_ids: [cartCollection.id],
+    };
+};
+exports.planCartPaymentVoid = planCartPaymentVoid;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3BsaXQtb3JkZXItcGF5bWVudC1ncm91cC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3MvcGF5bWVudC91dGlscy9zcGxpdC1vcmRlci1wYXltZW50LWdyb3VwLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUtBLHFEQUtrQztBQUVsQywrREFHOEI7QUFFOUIsNEVBQTRFO0FBQy9ELFFBQUEsNEJBQTRCLEdBQUcseUJBQXlCLENBQUE7QUFFckUsb0VBQW9FO0FBQ3ZELFFBQUEsMkJBQTJCLEdBQUcsNEJBQTRCLENBQUE7QUFvQ3ZFLE1BQU0sY0FBYyxHQUFHO0lBQ3JCLElBQUk7SUFDSixhQUFhO0lBQ2IsZUFBZTtJQUNmLFFBQVE7SUFDUixZQUFZO0lBQ1osTUFBTTtJQUNOLGFBQWE7SUFDYixhQUFhO0lBQ2IsYUFBYTtJQUNiLGlCQUFpQjtJQUNqQixxQkFBcUI7SUFDckIsWUFBWTtJQUNaLGdCQUFnQjtJQUNoQixvQkFBb0I7Q0FDckIsQ0FBQTtBQUVELE1BQU0saUJBQWlCLEdBQUc7SUFDeEIsSUFBSTtJQUNKLGVBQWU7SUFDZixVQUFVO0lBQ1YsR0FBRyxjQUFjLENBQUMsR0FBRyxDQUFDLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxZQUFZLEtBQUssRUFBRSxDQUFDO0NBQ3RELENBQUE7QUFFRCw4RUFBOEU7QUFDakUsUUFBQSwyQkFBMkIsR0FBRyxpQkFBaUIsQ0FBQyxHQUFHLENBQzlELENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxzQkFBc0IsS0FBSyxFQUFFLENBQ3pDLENBQUE7QUFFRCxpRUFBaUU7QUFDcEQsUUFBQSxlQUFlLEdBQUc7SUFDN0IsVUFBVTtJQUNWLGNBQWM7SUFDZCxtQkFBbUI7SUFDbkIsYUFBYTtJQUNiLEdBQUcsaUJBQWlCLENBQUMsR0FBRyxDQUFDLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyw2QkFBNkIsS0FBSyxFQUFFLENBQUM7Q0FDMUUs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

package/.medusa/server/src/workflows/payment/utils/split-order-payment.d.ts

@@ -0,0 +1,15 @@
+import { BigNumberInput } from "@medusajs/framework/types";
+import { MathBN } from "@medusajs/framework/utils";
+type BigNumberValue = ReturnType<typeof MathBN.convert>;
+export declare const getCurrencyDecimalDigits: (currencyCode?: string | null) => number;
+/**
+ * Splits `amount` across `weights` proportionally. Shares are rounded down to
+ * the currency precision and the remainder is handed out one minor unit at a
+ * time to the largest fractions, so the shares always sum exactly to `amount`.
+ */
+export declare const allocateProportionally: ({ amount, weights, decimalDigits, }: {
+    amount: BigNumberInput;
+    weights: BigNumberInput[];
+    decimalDigits: number;
+}) => BigNumberValue[];
+export {};

package/.medusa/server/src/workflows/payment/utils/split-order-payment.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allocateProportionally = exports.getCurrencyDecimalDigits = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const DEFAULT_DECIMAL_DIGITS = 2;
+const getCurrencyDecimalDigits = (currencyCode) => {
+    const currency = utils_1.defaultCurrencies[(currencyCode ?? "").toUpperCase()];
+    return currency?.decimal_digits ?? DEFAULT_DECIMAL_DIGITS;
+};
+exports.getCurrencyDecimalDigits = getCurrencyDecimalDigits;
+const floorTo = (value, decimalDigits) => {
+    const rounded = utils_1.MathBN.convert(value, decimalDigits);
+    if (utils_1.MathBN.lte(rounded, value)) {
+        return rounded;
+    }
+    return utils_1.MathBN.sub(rounded, utils_1.MathBN.div(1, utils_1.MathBN.convert(10).pow(decimalDigits)));
+};
+/**
+ * Splits `amount` across `weights` proportionally. Shares are rounded down to
+ * the currency precision and the remainder is handed out one minor unit at a
+ * time to the largest fractions, so the shares always sum exactly to `amount`.
+ */
+const allocateProportionally = ({ amount, weights, decimalDigits, }) => {
+    if (!weights.length) {
+        return [];
+    }
+    const total = utils_1.MathBN.convert(amount);
+    const positiveWeights = weights.map((weight) => utils_1.MathBN.max(utils_1.MathBN.convert(weight), 0));
+    const weightSum = positiveWeights.reduce((acc, weight) => utils_1.MathBN.add(acc, weight), utils_1.MathBN.convert(0));
+    const effectiveWeights = utils_1.MathBN.gt(weightSum, 0)
+        ? positiveWeights
+        : positiveWeights.map(() => utils_1.MathBN.convert(1));
+    const effectiveSum = utils_1.MathBN.gt(weightSum, 0)
+        ? weightSum
+        : utils_1.MathBN.convert(effectiveWeights.length);
+    const unit = utils_1.MathBN.div(1, utils_1.MathBN.convert(10).pow(decimalDigits));
+    const exact = effectiveWeights.map((weight) => utils_1.MathBN.div(utils_1.MathBN.mult(total, weight), effectiveSum));
+    const shares = exact.map((share) => floorTo(share, decimalDigits));
+    let leftover = utils_1.MathBN.sub(total, shares.reduce((acc, share) => utils_1.MathBN.add(acc, share), utils_1.MathBN.convert(0)));
+    const byLargestFraction = exact
+        .map((share, index) => ({
+        index,
+        fraction: utils_1.MathBN.sub(share, shares[index]),
+    }))
+        .sort((a, b) => utils_1.MathBN.eq(a.fraction, b.fraction)
+        ? a.index - b.index
+        : utils_1.MathBN.gt(a.fraction, b.fraction)
+            ? -1
+            : 1);
+    for (const { index } of byLargestFraction) {
+        if (utils_1.MathBN.lt(leftover, unit)) {
+            break;
+        }
+        shares[index] = utils_1.MathBN.add(shares[index], unit);
+        leftover = utils_1.MathBN.sub(leftover, unit);
+    }
+    // Only reachable when `amount` itself is finer than the currency precision.
+    if (utils_1.MathBN.gt(leftover, 0)) {
+        const { index } = byLargestFraction[0];
+        shares[index] = utils_1.MathBN.add(shares[index], leftover);
+    }
+    return shares;
+};
+exports.allocateProportionally = allocateProportionally;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3BsaXQtb3JkZXItcGF5bWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3MvcGF5bWVudC91dGlscy9zcGxpdC1vcmRlci1wYXltZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLHFEQUFxRTtBQUlyRSxNQUFNLHNCQUFzQixHQUFHLENBQUMsQ0FBQTtBQUV6QixNQUFNLHdCQUF3QixHQUFHLENBQUMsWUFBNEIsRUFBRSxFQUFFO0lBQ3ZFLE1BQU0sUUFBUSxHQUFHLHlCQUFpQixDQUFDLENBQUMsWUFBWSxJQUFJLEVBQUUsQ0FBQyxDQUFDLFdBQVcsRUFBRSxDQUFDLENBQUE7SUFDdEUsT0FBTyxRQUFRLEVBQUUsY0FBYyxJQUFJLHNCQUFzQixDQUFBO0FBQzNELENBQUMsQ0FBQTtBQUhZLFFBQUEsd0JBQXdCLDRCQUdwQztBQUVELE1BQU0sT0FBTyxHQUFHLENBQUMsS0FBcUIsRUFBRSxhQUFxQixFQUFFLEVBQUU7SUFDL0QsTUFBTSxPQUFPLEdBQUcsY0FBTSxDQUFDLE9BQU8sQ0FBQyxLQUFLLEVBQUUsYUFBYSxDQUFDLENBQUE7SUFDcEQsSUFBSSxjQUFNLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQy9CLE9BQU8sT0FBTyxDQUFBO0lBQ2hCLENBQUM7SUFDRCxPQUFPLGNBQU0sQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLGNBQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxFQUFFLGNBQU0sQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDLENBQUMsR0FBRyxDQUFDLGFBQWEsQ0FBQyxDQUFDLENBQUMsQ0FBQTtBQUNsRixDQUFDLENBQUE7QUFFRDs7OztHQUlHO0FBQ0ksTUFBTSxzQkFBc0IsR0FBRyxDQUFDLEVBQ3JDLE1BQU0sRUFDTixPQUFPLEVBQ1AsYUFBYSxHQUtkLEVBQW9CLEVBQUU7SUFDckIsSUFBSSxDQUFDLE9BQU8s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

package/.medusa/server/src/workflows/payment/workflows/index.d.ts

@@ -1 +1,3 @@
 export * from "./process-payment";
+export * from "./payment-hooks";
+export * from "./split-order-payments";

package/.medusa/server/src/workflows/payment/workflows/index.js

@@ -15,4 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./process-payment"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi9zcmMvd29ya2Zsb3dzL3BheW1lbnQvd29ya2Zsb3dzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxvREFBaUMifQ==
+__exportStar(require("./payment-hooks"), exports);
+__exportStar(require("./split-order-payments"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi9zcmMvd29ya2Zsb3dzL3BheW1lbnQvd29ya2Zsb3dzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxvREFBaUM7QUFDakMsa0RBQStCO0FBQy9CLHlEQUFzQyJ9

package/.medusa/server/src/workflows/payment/workflows/payment-hooks.d.ts

@@ -0,0 +1,25 @@
+import type { BigNumberInput, PaymentDTO } from "@medusajs/framework/types";
+import type { Hook, ReturnWorkflow } from "@medusajs/framework/workflows-sdk";
+import { type CapturePaymentWorkflowInput, type RefundPaymentWorkflowInput } from "@medusajs/medusa/core-flows";
+export type CapturePaymentWorkflowHooks = [
+    Hook<"paymentCaptured", {
+        payment: PaymentDTO;
+        order_id: string | null;
+        amount: BigNumberInput | null;
+    }, unknown>
+];
+export type RefundPaymentWorkflowHooks = [
+    Hook<"paymentRefunded", {
+        payment: PaymentDTO;
+        order_id: string | null;
+        amount: BigNumberInput | null;
+        credit_line_amount: BigNumberInput;
+        refund_reason: {
+            id: string;
+            label: string;
+            code: string | null;
+        } | null;
+    }, unknown>
+];
+export declare const capturePaymentWorkflow: ReturnWorkflow<CapturePaymentWorkflowInput, PaymentDTO, CapturePaymentWorkflowHooks>;
+export declare const refundPaymentWorkflow: ReturnWorkflow<RefundPaymentWorkflowInput, PaymentDTO, RefundPaymentWorkflowHooks>;

package/.medusa/server/src/workflows/payment/workflows/payment-hooks.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.refundPaymentWorkflow = exports.capturePaymentWorkflow = void 0;
+const core_flows_1 = require("@medusajs/medusa/core-flows");
+// The hooks come from the core-flows payment-hooks patch, which is applied in
+// memory and cannot reach Medusa's shipped typings, so the patched shape is
+// asserted here. Keep in sync with patches/@medusajs+core-flows@*-payment-hooks.patch.
+exports.capturePaymentWorkflow = core_flows_1.capturePaymentWorkflow;
+exports.refundPaymentWorkflow = core_flows_1.refundPaymentWorkflow;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGF5bWVudC1ob29rcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3MvcGF5bWVudC93b3JrZmxvd3MvcGF5bWVudC1ob29rcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFFQSw0REFLb0M7QUE0QnBDLDhFQUE4RTtBQUM5RSw0RUFBNEU7QUFDNUUsdUZBQXVGO0FBQzFFLFFBQUEsc0JBQXNCLEdBQ2pDLG1DQUlDLENBQUE7QUFFVSxRQUFBLHFCQUFxQixHQUNoQyxrQ0FJQyxDQUFBIn0=

package/.medusa/server/src/workflows/payment/workflows/split-order-payments.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The cart whose payment to split.
+ */
+export type SplitCapturedCartPaymentWorkflowInput = {
+    /**
+     * The ID of the cart.
+     */
+    cart_id: string;
+};
+export declare const splitCapturedCartPaymentWorkflowId = "split-captured-cart-payment";
+/**
+ * This workflow splits a captured cart payment between the orders of the
+ * cart. Every order gets a payment collection of its own, linked to the order,
+ * with a captured payment for the order's share on the cart payment's provider
+ * and pointing at the same charge, so Medusa's refund and cancel workflows
+ * apply to the order. What was charged for orders canceled before the capture
+ * is refunded against the cart payment.
+ *
+ * The workflow only adds what is missing: it does nothing until the cart
+ * payment has a capture, and nothing when run again for the same capture.
+ *
+ * @example
+ * const { result } = await splitCapturedCartPaymentWorkflow(container)
+ * .run({
+ *   input: {
+ *     cart_id: "cart_123",
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Split a captured cart payment into a payment per order.
+ */
+export declare const splitCapturedCartPaymentWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<SplitCapturedCartPaymentWorkflowInput, import("@medusajs/types").PaymentDTO[], []>;
+/**
+ * The cart whose payment to void.
+ */
+export type VoidCanceledCartPaymentWorkflowInput = {
+    /**
+     * The ID of the cart.
+     */
+    cart_id: string;
+};
+export declare const voidCanceledCartPaymentWorkflowId = "void-canceled-cart-payment";
+/**
+ * This workflow voids a cart's payment once every order of the cart is
+ * canceled. Until it is captured, the authorization is shared by the cart's
+ * orders, so canceling a single order leaves it in place. The workflow does
+ * nothing while an order is still open or once the payment is captured.
+ *
+ * @example
+ * const { result } = await voidCanceledCartPaymentWorkflow(container)
+ * .run({
+ *   input: {
+ *     cart_id: "cart_123",
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Void a cart's payment when all of its orders are canceled.
+ */
+export declare const voidCanceledCartPaymentWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<VoidCanceledCartPaymentWorkflowInput, {
+    payment_ids: string[];
+    payment_collection_ids: string[];
+}, []>;