@kshon/loyalty-plugin 2.14.2

package/.medusa/server/src/workflows/carts/workflows/add-gift-card-to-cart.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addGiftCardToCartWorkflow = exports.validateCartGiftCardStep = exports.retrieveGiftCardBalanceStep = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const core_flows_1 = require("@medusajs/medusa/core-flows");
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const types_1 = require("../../../types");
+const validate_gift_card_balances_1 = require("../steps/validate-gift-card-balances");
+/**
+ * This step retrieves the balance of a single gift card from its associated store
+ * credit account. Returns a map of the gift card code to its account stats.
+ *
+ * @example
+ * const data = retrieveGiftCardBalanceStep({
+ *   storeCreditAccount: {
+ *     id: "sca_123",
+ *     balance: 100,
+ *     // other store credit account properties...
+ *   },
+ *   giftCard: {
+ *     id: "gc_123",
+ *     code: "GC-XXXX",
+ *     // other gift card properties...
+ *   },
+ * })
+ */
+exports.retrieveGiftCardBalanceStep = (0, workflows_sdk_1.createStep)("retrieve-gift-cards-balance", async function ({ storeCreditAccount, giftCard, }, { container }) {
+    const accountBalanceMap = {};
+    const module = container.resolve(types_1.PluginModule.STORE_CREDIT);
+    const giftCardBalance = await module.retrieveAccountStats({
+        account_id: storeCreditAccount.id,
+    });
+    accountBalanceMap[giftCard.code] = giftCardBalance;
+    return new workflows_sdk_1.StepResponse(accountBalanceMap);
+});
+/**
+ * Validate if the gift card exists.
+ */
+const validateGiftCardStep = (0, workflows_sdk_1.createStep)("validate-gift-card", async function ({ giftCard, input, }) {
+    if (!giftCard) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Gift card (${input.code}) not found`);
+    }
+});
+/**
+ * This step validates that gift cards can be added to a cart. It throws an error
+ * if a gift card is already applied to the cart or if the gift card currency does
+ * not match the cart's currency.
+ *
+ * @example
+ * const data = validateCartGiftCardStep({
+ *   cart: {
+ *     id: "cart_123",
+ *     gift_cards: [
+ *       { code: "GC-XXXX-XXXX" },
+ *       // other gift cards applied to the cart...
+ *     ],
+ *     currency_code: "usd",
+ *     // other cart properties...
+ *   },
+ *   giftCards: [...],
+ * })
+ */
+exports.validateCartGiftCardStep = (0, workflows_sdk_1.createStep)("validate-cart-gift-card", async function ({ cart, giftCards, }) {
+    for (const giftCard of giftCards) {
+        const cartGiftCard = cart.gift_cards.find((gc) => gc.code.includes(giftCard.code));
+        if (cartGiftCard) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Gift card (${giftCard.code}) already applied to cart`);
+        }
+        if (giftCard.currency_code !== cart.currency_code) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Gift card (${giftCard.code}) currency does not match cart currency`);
+        }
+    }
+});
+/**
+ * This workflow applies a gift card to a cart by creating a credit line for the
+ * gift card's balance and linking the gift card to the cart. It validates that
+ * the gift card exists, has sufficient balance, and can be applied to the cart.
+ *
+ * You can use this workflow within your own customizations or custom workflows,
+ * allowing you to wrap custom logic around adding gift cards to carts.
+ *
+ * @example
+ * const { result } = await addGiftCardToCartWorkflow(container)
+ *   .run({
+ *     input: {
+ *       code: "GC-XXXX-XXXX",
+ *       cart_id: "cart_123",
+ *     },
+ *   })
+ *
+ * @summary
+ *
+ * Apply a gift card to a cart.
+ */
+exports.addGiftCardToCartWorkflow = (0, workflows_sdk_1.createWorkflow)("add-gift-card-to-cart", function (input) {
+    const cartQuery = (0, core_flows_1.useQueryGraphStep)({
+        entity: "cart",
+        filters: { id: input.cart_id },
+        fields: ["id", "currency_code", "total", "gift_cards.code"],
+    }).config({ name: "get-cart-query" });
+    const cart = (0, workflows_sdk_1.transform)({ cartQuery }, ({ cartQuery }) => {
+        return cartQuery.data[0];
+    });
+    const giftCardQuery = (0, core_flows_1.useQueryGraphStep)({
+        entity: "gift_card",
+        filters: { code: input.code },
+        fields: ["id", "code", "status", "currency_code"],
+    }).config({ name: "get-gift-card-query" });
+    const giftCard = (0, workflows_sdk_1.transform)({ giftCardQuery }, ({ giftCardQuery }) => {
+        return giftCardQuery.data[0];
+    });
+    validateGiftCardStep({ giftCard, input });
+    const giftCards = (0, workflows_sdk_1.transform)({ giftCardQuery }, ({ giftCardQuery }) => {
+        return giftCardQuery.data;
+    });
+    (0, exports.validateCartGiftCardStep)({ cart, giftCards });
+    const giftCardStoreCreditAccountQuery = (0, core_flows_1.useQueryGraphStep)({
+        entity: "gift_card_store_credit_account",
+        filters: {
+            gift_card_id: giftCard.id,
+        },
+        fields: ["id", "store_credit_account_id"],
+    }).config({ name: "get-gift-card-store-credit-account-query" });
+    const giftCardStoreCreditAccount = (0, workflows_sdk_1.transform)({ giftCardStoreCreditAccountQuery }, ({ giftCardStoreCreditAccountQuery }) => giftCardStoreCreditAccountQuery.data[0]);
+    const storeCreditAccountQuery = (0, core_flows_1.useQueryGraphStep)({
+        entity: "store_credit_account",
+        filters: {
+            id: giftCardStoreCreditAccount.store_credit_account_id,
+            currency_code: cart.currency_code,
+        },
+        fields: ["id", "balance"],
+    }).config({ name: "get-store-credit-account-query" });
+    const storeCreditAccount = (0, workflows_sdk_1.transform)({ storeCreditAccountQuery }, ({ storeCreditAccountQuery }) => {
+        return storeCreditAccountQuery.data[0];
+    });
+    const giftCardsBalanceMap = (0, exports.retrieveGiftCardBalanceStep)({
+        storeCreditAccount,
+        giftCard,
+    });
+    (0, validate_gift_card_balances_1.validateGiftCardBalancesStep)({
+        giftCards,
+        giftCardsBalanceMap,
+    });
+    const creditLinesToCreate = (0, workflows_sdk_1.transform)({ giftCardsBalanceMap, giftCards, cart }, ({ giftCardsBalanceMap, giftCards, cart }) => {
+        const creditLinesData = [];
+        for (const giftCard of giftCards) {
+            const stats = giftCardsBalanceMap[giftCard.code];
+            const amount = utils_1.MathBN.min(stats.balance, cart.total);
+            if (amount.gt(0)) {
+                creditLinesData.push({
+                    cart_id: cart.id,
+                    amount: amount.toNumber(),
+                    reference: "gift-card",
+                    reference_id: giftCard.id,
+                    metadata: {},
+                });
+            }
+        }
+        return creditLinesData;
+    });
+    const creditLines = core_flows_1.createCartCreditLinesWorkflow.runAsStep({
+        input: creditLinesToCreate,
+    });
+    const linksToCreate = (0, workflows_sdk_1.transform)({ creditLines, cart }, ({ creditLines, cart }) => {
+        const links = creditLines
+            .filter((creditLine) => creditLine.reference === "gift-card")
+            .map((creditLine) => ({
+            [utils_1.Modules.CART]: { cart_id: cart.id },
+            [types_1.PluginModule.LOYALTY]: { gift_card_id: creditLine.reference_id },
+        }));
+        return links;
+    });
+    core_flows_1.createLinksWorkflow.runAsStep({ input: linksToCreate });
+    core_flows_1.refreshCartItemsWorkflow.runAsStep({
+        input: { cart_id: input.cart_id },
+    });
+    return new workflows_sdk_1.WorkflowResponse(creditLines);
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWRkLWdpZnQtY2FyZC10by1jYXJ0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL3dvcmtmbG93cy9jYXJ0cy93b3JrZmxvd3MvYWRkLWdpZnQtY2FyZC10by1jYXJ0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLHFEQUF5RTtBQUN6RSw0REFLcUM7QUFDckMscUVBTTJDO0FBQzNDLDBDQUE4QztBQVE5QyxzRkFBb0Y7QUFnQnBGOzs7Ozs7Ozs7Ozs7Ozs7OztHQWlCRztBQUNVLFFBQUEsMkJBQTJCLEdBQUcsSUFBQSwwQkFBVSxFQUNuRCw2QkFBNkIsRUFDN0IsS0FBSyxXQUNILEVBQ0Usa0JBQWtCLEVBQ2xCLFFBQVEsR0FDeUIsRUFDbkMsRUFBRSxTQUFTLEVBQUU7SUFFYixNQUFNLGlCQUFpQixHQUF1QyxFQUFFLENBQUM7SUFDakUsTUFBTSxNQUFNLEdBQUcsU0FBUyxDQUFDLE9BQU8sQ0FDOUIsb0JBQVksQ0FBQyxZQUFZLENBQzFCLENBQUM7SUFFRixNQUFNLGVBQWUsR0FBRyxNQUFNLE1BQU0sQ0FBQyxvQkFBb0IsQ0FBQztRQUN4RCxVQUFVLEVBQUUsa0JBQWtCLENBQUMsRUFBRTtLQUNsQyxDQUFDLENBQUM7SUFFSCxpQkFBaUIsQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLEdBQUcsZUFBZSxDQUFDO0lBRW5ELE9BQU8sSUFBSSw0QkFBWSxDQUFDLGlCQUFpQixDQUFDLENBQUM7QUFDN0MsQ0FBQyxDQUNGLENBQUM7QUFnQkY7O0dBRUc7QUFDSCxNQUFNLG9CQUFvQixHQUFHLElBQUEsMEJBQVUsRUFDckMsb0JBQW9CLEVBQ3BCLEtBQUssV0FBVyxFQUNkLFFBQVEsRUFDUixLQUFLLEdBQzJCO0lBQ2hDLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztRQUNkLE1BQU0sSUFBSSxtQkFBVyxDQUNuQixtQkFBVyxDQUFDLEtBQUssQ0FBQyxZQUFZLEVBQzlCLGNBQWMsS0FBSyxDQUFD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

package/.medusa/server/src/workflows/carts/workflows/add-store-credits-to-cart.d.ts

@@ -0,0 +1,88 @@
+import { PluginCartDTO } from "../../../../src/types/cart";
+import { ModuleStoreCreditAccount } from "../../../types/store-credit";
+/**
+ * Input to validate that a customer's store credit account exists and has a positive balance.
+ */
+export interface ValidateCustomerStoreCreditAccountStepInput {
+    /**
+     * The customer's store credit account to validate.
+     */
+    storeCreditAccount: ModuleStoreCreditAccount;
+}
+/**
+ * This step validates that a customer's store credit account exists and has a positive
+ * balance. It throws an error if the account is not found or has no balance.
+ *
+ * @example
+ * const data = validateCustomerStoreCreditAccountStep({
+ *   storeCreditAccount: {
+ *     id: "sca_123",
+ *     balance: 100,
+ *     // other store credit account properties...
+ *   },
+ * })
+ */
+export declare const validateCustomerStoreCreditAccountStep: import("@medusajs/framework/workflows-sdk").StepFunction<ValidateCustomerStoreCreditAccountStepInput, unknown>;
+/**
+ * Input to validate that a cart is eligible for store credit usage.
+ */
+export interface ValidateCartStepInput {
+    /**
+     * The cart to validate.
+     */
+    cart: PluginCartDTO;
+    /**
+     * The workflow input containing the cart ID used in error messages.
+     */
+    input: {
+        cart_id: string;
+    };
+}
+/**
+ * This step validates that a cart is eligible for store credit usage. It throws an
+ * error if the cart is not found, does not have a customer, or does not have a
+ * currency set.
+ *
+ * @example
+ * const data = validateCartStep({
+ *   cart: { ...cart, customer_id: "cust_123", currency_code: "usd" },
+ *   input: { cart_id: "cart_123" },
+ * })
+ */
+export declare const validateCartStep: import("@medusajs/framework/workflows-sdk").StepFunction<ValidateCartStepInput, unknown>;
+/**
+ * Input to apply store credits to a cart.
+ */
+export interface AddStoreCreditsToCartWorkflowInput {
+    /**
+     * The ID of the cart to apply store credits to.
+     */
+    cart_id: string;
+    /**
+     * The amount of store credits to apply. If not provided, the full balance is applied.
+     */
+    amount?: number;
+}
+/**
+ * This workflow applies store credits to a cart. It removes any existing store-credit
+ * lines and creates a new credit line for the specified amount, or for the full store
+ * credit balance if no amount is specified. The customer must be set on the cart and
+ * have a store credit account in the cart's currency.
+ *
+ * You can use this workflow within your own customizations or custom workflows,
+ * allowing you to wrap custom logic around applying store credits to carts.
+ *
+ * @example
+ * const { result } = await addStoreCreditsToCartWorkflow(container)
+ *   .run({
+ *     input: {
+ *       cart_id: "cart_123",
+ *       amount: 50,
+ *     },
+ *   })
+ *
+ * @summary
+ *
+ * Apply store credits to a cart.
+ */
+export declare const addStoreCreditsToCartWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<AddStoreCreditsToCartWorkflowInput, import("@medusajs/framework/types").CartCreditLineDTO[], []>;

package/.medusa/server/src/workflows/carts/workflows/add-store-credits-to-cart.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addStoreCreditsToCartWorkflow = exports.validateCartStep = exports.validateCustomerStoreCreditAccountStep = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const core_flows_1 = require("@medusajs/medusa/core-flows");
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+/**
+ * This step validates that a customer's store credit account exists and has a positive
+ * balance. It throws an error if the account is not found or has no balance.
+ *
+ * @example
+ * const data = validateCustomerStoreCreditAccountStep({
+ *   storeCreditAccount: {
+ *     id: "sca_123",
+ *     balance: 100,
+ *     // other store credit account properties...
+ *   },
+ * })
+ */
+exports.validateCustomerStoreCreditAccountStep = (0, workflows_sdk_1.createStep)("validate-customer-store-credit-account", async function ({ storeCreditAccount, }) {
+    if (!storeCreditAccount) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Store credit account not found for the customer on the cart in that currency.`);
+    }
+    if (utils_1.MathBN.convert(storeCreditAccount.balance).lte(0)) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Store credit account has no balance`);
+    }
+});
+/**
+ * This step validates that a cart is eligible for store credit usage. It throws an
+ * error if the cart is not found, does not have a customer, or does not have a
+ * currency set.
+ *
+ * @example
+ * const data = validateCartStep({
+ *   cart: { ...cart, customer_id: "cust_123", currency_code: "usd" },
+ *   input: { cart_id: "cart_123" },
+ * })
+ */
+exports.validateCartStep = (0, workflows_sdk_1.createStep)("validate-cart", async function ({ cart, input, }) {
+    if (!cart) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Cart with id ${input.cart_id} not found`);
+    }
+    if (!cart.customer_id) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Cart's customer must be set to add store credits`);
+    }
+    if (!cart.currency_code) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Cart's currency must be set to add store credits`);
+    }
+});
+/**
+ * This workflow applies store credits to a cart. It removes any existing store-credit
+ * lines and creates a new credit line for the specified amount, or for the full store
+ * credit balance if no amount is specified. The customer must be set on the cart and
+ * have a store credit account in the cart's currency.
+ *
+ * You can use this workflow within your own customizations or custom workflows,
+ * allowing you to wrap custom logic around applying store credits to carts.
+ *
+ * @example
+ * const { result } = await addStoreCreditsToCartWorkflow(container)
+ *   .run({
+ *     input: {
+ *       cart_id: "cart_123",
+ *       amount: 50,
+ *     },
+ *   })
+ *
+ * @summary
+ *
+ * Apply store credits to a cart.
+ */
+exports.addStoreCreditsToCartWorkflow = (0, workflows_sdk_1.createWorkflow)("add-store-credits-to-cart", function (input) {
+    const cartQuery = (0, core_flows_1.useQueryGraphStep)({
+        entity: "cart",
+        filters: { id: input.cart_id },
+        fields: ["id", "currency_code", "total", "customer_id", "credit_lines.*"],
+    }).config({ name: "get-cart-query" });
+    const cart = (0, workflows_sdk_1.transform)({ cartQuery }, ({ cartQuery }) => {
+        return cartQuery.data[0];
+    });
+    (0, exports.validateCartStep)({ cart, input });
+    const storeCreditAccountQuery = (0, core_flows_1.useQueryGraphStep)({
+        entity: "store_credit_account",
+        filters: {
+            customer_id: cart.customer_id,
+            currency_code: cart.currency_code,
+        },
+        fields: ["id", "balance"],
+    }).config({ name: "get-store-credit-account-query" });
+    const storeCreditAccount = (0, workflows_sdk_1.transform)({ storeCreditAccountQuery }, ({ storeCreditAccountQuery }) => {
+        return storeCreditAccountQuery.data[0];
+    });
+    (0, exports.validateCustomerStoreCreditAccountStep)({
+        storeCreditAccount,
+    });
+    const creditLineActions = (0, workflows_sdk_1.transform)({ storeCreditAccount, cart, input }, ({ storeCreditAccount, cart, input }) => {
+        const creditLinesToCreate = [];
+        const creditLinesToDelete = (cart.credit_lines ?? [])
+            .filter((creditLine) => creditLine.reference === "store-credit")
+            .map((creditLine) => creditLine.id);
+        let amount = input.amount
+            ? utils_1.MathBN.convert(input.amount)
+            : utils_1.MathBN.convert(storeCreditAccount.balance);
+        if ((0, utils_1.isDefined)(input.amount) &&
+            utils_1.MathBN.convert(amount).gt(utils_1.MathBN.convert(storeCreditAccount.balance))) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Amount is greater than the store credit account balance`);
+        }
+        if (amount.gt(0)) {
+            creditLinesToCreate.push({
+                cart_id: cart.id,
+                amount: utils_1.MathBN.min(amount, cart.total).toNumber(),
+                reference: "store-credit",
+                reference_id: storeCreditAccount.id,
+                metadata: {},
+            });
+        }
+        return {
+            creditLinesToCreate,
+            creditLinesToDelete,
+        };
+    });
+    const [_deletedCreditLines, createdCreditLines] = (0, workflows_sdk_1.parallelize)(core_flows_1.deleteCartCreditLinesWorkflow.runAsStep({
+        input: {
+            id: creditLineActions.creditLinesToDelete,
+        },
+    }), core_flows_1.createCartCreditLinesWorkflow.runAsStep({
+        input: creditLineActions.creditLinesToCreate,
+    }));
+    core_flows_1.refreshCartItemsWorkflow.runAsStep({
+        input: { cart_id: input.cart_id },
+    });
+    return new workflows_sdk_1.WorkflowResponse(createdCreditLines);
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWRkLXN0b3JlLWNyZWRpdHMtdG8tY2FydC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3MvY2FydHMvd29ya2Zsb3dzL2FkZC1zdG9yZS1jcmVkaXRzLXRvLWNhcnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQ0EscURBQTJFO0FBQzNFLDREQUtxQztBQUNyQyxxRUFNMkM7QUFjM0M7Ozs7Ozs7Ozs7OztHQVlHO0FBQ1UsUUFBQSxzQ0FBc0MsR0FBRyxJQUFBLDBCQUFVLEVBQzlELHdDQUF3QyxFQUN4QyxLQUFLLFdBQVcsRUFDZCxrQkFBa0IsR0FDMEI7SUFDNUMsSUFBSSxDQUFDLGtCQUFrQixFQUFFLENBQUM7UUFDeEIsTUFBTSxJQUFJLG1CQUFXLENBQ25CLG1CQUFXLENBQUMsS0FBSyxDQUFDLFlBQVksRUFDOUIsK0VBQStFLENBQ2hGLENBQUM7SUFDSixDQUFDO0lBRUQsSUFBSSxjQUFNLENBQUMsT0FBTyxDQUFDLGtCQUFrQixDQUFDLE9BQU8sQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ3RELE1BQU0sSUFBSSxtQkFBVyxDQUNuQixtQkFBVyxDQUFDLEtBQUssQ0FBQyxZQUFZLEVBQzlCLHFDQUFxQyxDQUN0QyxDQUFDO0lBQ0osQ0FBQztBQUNILENBQUMsQ0FDRixDQUFDO0FBZ0JGOzs7Ozs7Ozs7O0dBVUc7QUFDVSxRQUFBLGdCQUFnQixHQUFHLElBQUEsMEJBQVUsRUFDeEMsZUFBZSxFQUNmLEtBQUssV0FBVyxFQUNkLElBQUksRUFDSixLQUFLLEdBQ2lCO0lBQ3RCLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUNWLE1BQU0sSUFBSSxtQkFBVyxDQUNuQixtQkFBVyxDQUFDLEtBQUssQ0FBQyxZQUFZLEVBQzlCLGdCQUFnQixLQUFLLENBQUMsT0FBTyxZQUFZLENBQzFDLENBQUM7SUFDSixDQUFDO0lBRUQsSUFBSSxDQUFDLElB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

package/.medusa/server/src/workflows/carts/workflows/confirm-cart-credit-lines.d.ts

@@ -0,0 +1,68 @@
+import { ModuleGiftCard } from "../../../types/loyalty";
+import { ModuleAccountStats } from "../../../types/store-credit";
+/**
+ * Input to validate that all gift cards on a cart have a positive balance.
+ */
+export interface ValidateStoreCreditAccountStepInput {
+    /**
+     * The gift cards to validate.
+     */
+    giftCards: ModuleGiftCard[];
+    /**
+     * A map of gift card codes to their current account statistics.
+     */
+    giftCardsBalanceMap: Record<string, ModuleAccountStats>;
+}
+/**
+ * This step validates that all gift cards on the cart have a positive balance.
+ * It throws an error for any gift card with zero or negative balance.
+ *
+ * @example
+ * const data = validateStoreCreditAccountStep({
+ *   giftCards: [
+ *     {
+ *       id: "gc_123",
+ *       code: "GC-XXXX",
+ *       // other gift card properties...
+ *     }
+ *   ],
+ *   giftCardsBalanceMap: {
+ *     "GC-XXXX": {
+ *       balance: 100,
+ *       credit: 150,
+ *       debit: 50,
+ *     }
+ *   },
+ * })
+ */
+export declare const validateStoreCreditAccountStep: import("@medusajs/framework/workflows-sdk").StepFunction<ValidateStoreCreditAccountStepInput, unknown>;
+/**
+ * Input to confirm and debit the credit lines on a cart.
+ */
+export interface ConfirmCartCreditLinesWorkflowInput {
+    /**
+     * The ID of the cart whose credit lines should be confirmed and debited.
+     */
+    cart_id: string;
+}
+/**
+ * This workflow confirms the credit lines of a cart by debiting the associated
+ * store credit and gift card accounts for the credit line amounts. It is typically
+ * called before payment authorization to lock in the store credit usage.
+ *
+ * You can use this workflow within your own customizations or custom workflows,
+ * allowing you to wrap custom logic around confirming cart credit lines.
+ *
+ * @example
+ * const { result } = await confirmCartCreditLinesWorkflow(container)
+ *   .run({
+ *     input: {
+ *       cart_id: "cart_123",
+ *     },
+ *   })
+ *
+ * @summary
+ *
+ * Confirm and debit the credit lines on a cart.
+ */
+export declare const confirmCartCreditLinesWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<ConfirmCartCreditLinesWorkflowInput, [], []>;

package/.medusa/server/src/workflows/carts/workflows/confirm-cart-credit-lines.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmCartCreditLinesWorkflow = exports.validateStoreCreditAccountStep = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const core_flows_1 = require("@medusajs/medusa/core-flows");
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const debit_accounts_1 = require("../../store-credit/workflows/debit-accounts");
+/**
+ * This step validates that all gift cards on the cart have a positive balance.
+ * It throws an error for any gift card with zero or negative balance.
+ *
+ * @example
+ * const data = validateStoreCreditAccountStep({
+ *   giftCards: [
+ *     {
+ *       id: "gc_123",
+ *       code: "GC-XXXX",
+ *       // other gift card properties...
+ *     }
+ *   ],
+ *   giftCardsBalanceMap: {
+ *     "GC-XXXX": {
+ *       balance: 100,
+ *       credit: 150,
+ *       debit: 50,
+ *     }
+ *   },
+ * })
+ */
+exports.validateStoreCreditAccountStep = (0, workflows_sdk_1.createStep)("validate-store-credit-account", async function ({ giftCards, giftCardsBalanceMap, }) {
+    for (const giftCard of giftCards) {
+        const stats = giftCardsBalanceMap[giftCard.code];
+        if (utils_1.MathBN.convert(stats.balance).lte(0)) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Gift card (${giftCard.code}) has no balance`);
+        }
+    }
+});
+/**
+ * This workflow confirms the credit lines of a cart by debiting the associated
+ * store credit and gift card accounts for the credit line amounts. It is typically
+ * called before payment authorization to lock in the store credit usage.
+ *
+ * You can use this workflow within your own customizations or custom workflows,
+ * allowing you to wrap custom logic around confirming cart credit lines.
+ *
+ * @example
+ * const { result } = await confirmCartCreditLinesWorkflow(container)
+ *   .run({
+ *     input: {
+ *       cart_id: "cart_123",
+ *     },
+ *   })
+ *
+ * @summary
+ *
+ * Confirm and debit the credit lines on a cart.
+ */
+exports.confirmCartCreditLinesWorkflow = (0, workflows_sdk_1.createWorkflow)("confirm-cart-credit-lines", function (input) {
+    const cartQuery = (0, core_flows_1.useQueryGraphStep)({
+        entity: "cart",
+        filters: { id: input.cart_id },
+        fields: [
+            "id",
+            "customer_id",
+            "currency_code",
+            "credit_lines.id",
+            "credit_lines.reference",
+            "credit_lines.reference_id",
+            "credit_lines.amount",
+            "gift_cards.code",
+        ],
+        options: { throwIfKeyNotFound: true },
+    }).config({ name: "get-existing-cart-query" });
+    const cart = (0, workflows_sdk_1.transform)({ cartQuery }, ({ cartQuery }) => {
+        return cartQuery.data[0];
+    });
+    const giftCardIds = (0, workflows_sdk_1.transform)({ cart }, ({ cart }) => {
+        return cart.gift_cards.map((gc) => gc.id);
+    });
+    const storeCreditAccountsQuery = (0, core_flows_1.useQueryGraphStep)({
+        entity: "gift_card_store_credit_account",
+        filters: { gift_card_id: giftCardIds },
+        fields: ["gift_card_id", "store_credit_account_id"],
+    }).config({ name: "get-store-credit-account-query" });
+    const storeCreditAccountsMap = (0, workflows_sdk_1.transform)({ storeCreditAccountsQuery }, ({ storeCreditAccountsQuery }) => {
+        return storeCreditAccountsQuery.data.reduce((acc, curr) => {
+            acc[curr.gift_card_id] = curr.store_credit_account_id;
+            return acc;
+        }, {});
+    });
+    const debitAccountsInput = (0, workflows_sdk_1.transform)({ cart, storeCreditAccountsMap }, ({ cart, storeCreditAccountsMap }) => {
+        return (cart.credit_lines || [])
+            .filter((cl) => cl.reference === "store-credit" || cl.reference === "gift-card")
+            .map((cl) => {
+            const storeCreditAccount = storeCreditAccountsMap[cl.reference_id];
+            return {
+                account_id: storeCreditAccount || cl.reference_id,
+                amount: cl.amount,
+                reference: "cart",
+                reference_id: cart.id,
+                note: "Gift card usage",
+            };
+        });
+    });
+    debit_accounts_1.debitAccountsWorkflow.runAsStep({
+        input: debitAccountsInput,
+    });
+    return new workflows_sdk_1.WorkflowResponse([]);
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlybS1jYXJ0LWNyZWRpdC1saW5lcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3MvY2FydHMvd29ya2Zsb3dzL2NvbmZpcm0tY2FydC1jcmVkaXQtbGluZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEscURBQWdFO0FBQ2hFLDREQUFnRTtBQUNoRSxxRUFLMkM7QUFHM0MsZ0ZBQW9GO0FBZ0JwRjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBcUJHO0FBQ1UsUUFBQSw4QkFBOEIsR0FBRyxJQUFBLDBCQUFVLEVBQ3RELCtCQUErQixFQUMvQixLQUFLLFdBQVcsRUFDZCxTQUFTLEVBQ1QsbUJBQW1CLEdBQ2lCO0lBQ3BDLEtBQUssTUFBTSxRQUFRLElBQUksU0FBUyxFQUFFLENBQUM7UUFDakMsTUFBTSxLQUFLLEdBQUcsbUJBQW1CLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBRWpELElBQUksY0FBTSxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7WUFDekMsTUFBTSxJQUFJLG1CQUFXLENBQ25CLG1CQUFXLENBQUMsS0FBSyxDQUFDLFlBQVksRUFDOUIsY0FBYyxRQUFRLENBQUMsSUFBSSxrQkFBa0IsQ0FDOUMsQ0FBQztRQUNKLENBQUM7SUFDSCxDQUFDO0FBQ0gsQ0FBQyxDQUNGLENBQUM7QUFZRjs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQW1CRztBQUNVLFFBQUEsOEJBQThCLEdBQUcsSUFBQSw4QkFBYyxFQUMxRCwyQkFBMkIsRUFDM0IsVUFBVSxLQUEwQztJQUNsRCxNQUFNLFNBQVMsR0FBRyxJQUFBLDhCQUFpQixFQUFDO1FBQ2xDLE1BQU0sRUFBRSxNQUFNO1FBQ2QsT0FBTyxFQUFFLEVBQUUsRUFBRSxFQUFFLEtBQUssQ0FBQyxPQUFPLEVBQUU7UUFDOUIsTUFBTSxFQUFFO1lB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

package/.medusa/server/src/workflows/carts/workflows/refresh-cart-gift-cards.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Data to refresh the gift card credit lines on a cart.
+ */
+export type RefreshCartGiftCardsWorkflowInput = {
+    /**
+     * The ID of the cart for which to refresh gift card credit lines.
+     */
+    cart_id: string;
+};
+/**
+ * This workflow refreshes the gift card credit lines on a cart. It removes existing
+ * gift card credit lines and recreates them based on current gift card balances,
+ * accounting for any changes to the cart total or gift card balances.
+ *
+ * You can use this workflow within your own customizations or custom workflows,
+ * allowing you to wrap custom logic around refreshing cart gift cards.
+ *
+ * @example
+ * const { result } = await refreshCartGiftCardsWorkflow(container)
+ *   .run({
+ *     input: {
+ *       cart_id: "cart_123",
+ *     },
+ *   })
+ *
+ * @summary
+ *
+ * Refresh gift card credit lines on a cart.
+ */
+export declare const refreshCartGiftCardsWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<RefreshCartGiftCardsWorkflowInput, import("@medusajs/framework/types").CartCreditLineDTO[], []>;