@acmekit/core-flows 2.13.2 → 2.13.4

package/dist/cart/workflows/add-shipping-method-to-cart.d.ts

@@ -1,63 +0,0 @@
-import { WorkflowData } from "@acmekit/framework/workflows-sdk";
-import { AdditionalData } from "@acmekit/types";
-/**
- * The data to add a shipping method to a cart.
- */
-export interface AddShippingMethodToCartWorkflowInput {
-    /**
-     * The ID of the cart to add the shipping method to.
-     */
-    cart_id: string;
-    /**
-     * The shipping options to create the shipping methods from and add to the cart.
-     */
-    options: {
-        /**
-         * The ID of the shipping option.
-         */
-        id: string;
-        /**
-         * Custom data useful for the fulfillment provider processing the shipping option or method.
-         *
-         * Learn more in [this documentation](https://docs.acmekit.com/resources/commerce-modules/fulfillment/shipping-option#data-property).
-         */
-        data?: Record<string, unknown>;
-    }[];
-}
-export declare const addShippingMethodToCartWorkflowId = "add-shipping-method-to-cart";
-/**
- * This workflow adds a shipping method to a cart. It's executed by the
- * [Add Shipping Method Store API Route](https://docs.acmekit.com/api/store#carts_postcartsidshippingmethods).
- *
- * You can use this workflow within your own customizations or custom workflows, allowing you to wrap custom logic around adding a shipping method to the cart.
- *
- * @example
- * const { result } = await addShippingMethodToCartWorkflow(container)
- * .run({
- *   input: {
- *     cart_id: "cart_123",
- *     options: [
- *       {
- *         id: "so_123",
- *       },
- *       {
- *         id: "so_124",
- *         data: {
- *           carrier_code: "fedex",
- *         }
- *       }
- *     ]
- *   }
- * })
- *
- * @summary
- *
- * Add a shipping method to a cart.
- *
- * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
- */
-export declare const addShippingMethodToCartWorkflow: import("@acmekit/framework/workflows-sdk").ReturnWorkflow<AddShippingMethodToCartWorkflowInput & AdditionalData, undefined, [import("@acmekit/framework/workflows-sdk").Hook<"validate", {
-    input: WorkflowData<AddShippingMethodToCartWorkflowInput & AdditionalData>;
-    cart: any;
-}, unknown>]>;
-//# sourceMappingURL=add-shipping-method-to-cart.d.ts.map

package/dist/cart/workflows/add-shipping-method-to-cart.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"add-shipping-method-to-cart.d.ts","sourceRoot":"","sources":["../../../src/cart/workflows/add-shipping-method-to-cart.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,YAAY,EAEb,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAgB/C;;GAEG;AACH,MAAM,WAAW,oCAAoC;IACnD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,OAAO,EAAE;QACP;;WAEG;QACH,EAAE,EAAE,MAAM,CAAA;QACV;;;;WAIG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC/B,EAAE,CAAA;CACJ;AAED,eAAO,MAAM,iCAAiC,gCAAgC,CAAA;AAC9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,+BAA+B;;;aAmJ3C,CAAA"}

package/dist/cart/workflows/add-shipping-method-to-cart.js

@@ -1,146 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addShippingMethodToCartWorkflow = exports.addShippingMethodToCartWorkflowId = void 0;
-const utils_1 = require("@acmekit/framework/utils");
-const workflows_sdk_1 = require("@acmekit/framework/workflows-sdk");
-const emit_event_1 = require("../../common/steps/emit-event");
-const use_remote_query_1 = require("../../common/steps/use-remote-query");
-const locking_1 = require("../../locking");
-const steps_1 = require("../steps");
-const validate_cart_1 = require("../steps/validate-cart");
-const validate_shipping_methods_data_1 = require("../steps/validate-shipping-methods-data");
-const validate_shipping_options_price_1 = require("../steps/validate-shipping-options-price");
-const fields_1 = require("../utils/fields");
-const list_shipping_options_for_cart_with_pricing_1 = require("./list-shipping-options-for-cart-with-pricing");
-const refresh_cart_items_1 = require("./refresh-cart-items");
-exports.addShippingMethodToCartWorkflowId = "add-shipping-method-to-cart";
-/**
- * This workflow adds a shipping method to a cart. It's executed by the
- * [Add Shipping Method Store API Route](https://docs.acmekit.com/api/store#carts_postcartsidshippingmethods).
- *
- * You can use this workflow within your own customizations or custom workflows, allowing you to wrap custom logic around adding a shipping method to the cart.
- *
- * @example
- * const { result } = await addShippingMethodToCartWorkflow(container)
- * .run({
- *   input: {
- *     cart_id: "cart_123",
- *     options: [
- *       {
- *         id: "so_123",
- *       },
- *       {
- *         id: "so_124",
- *         data: {
- *           carrier_code: "fedex",
- *         }
- *       }
- *     ]
- *   }
- * })
- *
- * @summary
- *
- * Add a shipping method to a cart.
- *
- * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
- */
-exports.addShippingMethodToCartWorkflow = (0, workflows_sdk_1.createWorkflow)(exports.addShippingMethodToCartWorkflowId, (input) => {
-    (0, locking_1.acquireLockStep)({
-        key: input.cart_id,
-        timeout: 2,
-        ttl: 10,
-    });
-    const cart = (0, use_remote_query_1.useRemoteQueryStep)({
-        entry_point: "cart",
-        fields: fields_1.cartFieldsForRefreshSteps,
-        variables: { id: input.cart_id },
-        list: false,
-        throw_if_key_not_found: true,
-    });
-    (0, validate_cart_1.validateCartStep)({ cart });
-    const validate = (0, workflows_sdk_1.createHook)("validate", {
-        input,
-        cart,
-    });
-    const optionIds = (0, workflows_sdk_1.transform)({ input }, (data) => {
-        return (data.input.options ?? []).map((i) => i.id);
-    });
-    const shippingOptions = list_shipping_options_for_cart_with_pricing_1.listShippingOptionsForCartWithPricingWorkflow.runAsStep({
-        input: {
-            options: input.options,
-            cart_id: cart.id,
-            is_return: false,
-            additional_data: input.additional_data,
-        },
-    });
-    (0, steps_1.validateCartShippingOptionsStep)({
-        option_ids: optionIds,
-        prefetched_shipping_options: shippingOptions,
-    });
-    (0, validate_shipping_options_price_1.validateCartShippingOptionsPriceStep)({ shippingOptions });
-    const validateShippingMethodsDataInput = (0, workflows_sdk_1.transform)({ input, shippingOptions, cart }, ({ input, shippingOptions, cart }) => {
-        return input.options.map((inputOption) => {
-            const shippingOption = shippingOptions.find((so) => so.id === inputOption.id);
-            return {
-                id: inputOption.id,
-                provider_id: shippingOption?.provider_id,
-                option_data: shippingOption?.data ?? {},
-                method_data: inputOption.data ?? {},
-                context: {
-                    ...cart,
-                    from_location: shippingOption?.stock_location ?? {},
-                },
-            };
-        });
-    });
-    const validatedMethodData = (0, validate_shipping_methods_data_1.validateAndReturnShippingMethodsDataStep)(validateShippingMethodsDataInput);
-    const shippingMethodInput = (0, workflows_sdk_1.transform)({
-        input,
-        shippingOptions,
-        validatedMethodData,
-    }, (data) => {
-        const options = (data.input.options ?? []).map((option) => {
-            const shippingOption = data.shippingOptions.find((so) => so.id === option.id);
-            if (!shippingOption?.calculated_price) {
-                throw new utils_1.AcmeKitError(utils_1.AcmeKitError.Types.INVALID_DATA, `Shipping option with ID ${shippingOption.id} do not have a price`);
-            }
-            const methodData = data.validatedMethodData?.find((methodData) => {
-                return methodData?.[option.id];
-            });
-            return {
-                shipping_option_id: shippingOption.id,
-                amount: shippingOption.calculated_price.calculated_amount,
-                is_tax_inclusive: !!shippingOption.calculated_price
-                    .is_calculated_price_tax_inclusive,
-                data: methodData?.[option.id] ?? {},
-                name: shippingOption.name,
-                cart_id: data.input.cart_id,
-            };
-        });
-        return options;
-    });
-    const currentShippingMethods = (0, workflows_sdk_1.transform)({ cart }, ({ cart }) => cart.shipping_methods.map((sm) => sm.id));
-    const [, createdShippingMethods] = (0, workflows_sdk_1.parallelize)((0, steps_1.removeShippingMethodFromCartStep)({
-        shipping_method_ids: currentShippingMethods,
-    }), (0, steps_1.addShippingMethodToCartStep)({
-        shipping_methods: shippingMethodInput,
-    }));
-    refresh_cart_items_1.refreshCartItemsWorkflow.runAsStep({
-        input: {
-            cart_id: cart.id,
-            shipping_methods: createdShippingMethods,
-            additional_data: input.additional_data,
-        },
-    });
-    (0, workflows_sdk_1.parallelize)((0, emit_event_1.emitEventStep)({
-        eventName: utils_1.CartWorkflowEvents.UPDATED,
-        data: { id: input.cart_id },
-    }), (0, locking_1.releaseLockStep)({
-        key: cart.id,
-    }));
-    return new workflows_sdk_1.WorkflowResponse(void 0, {
-        hooks: [validate],
-    });
-});
-//# sourceMappingURL=add-shipping-method-to-cart.js.map

package/dist/cart/workflows/add-shipping-method-to-cart.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"add-shipping-method-to-cart.js","sourceRoot":"","sources":["../../../src/cart/workflows/add-shipping-method-to-cart.ts"],"names":[],"mappings":"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"}

package/dist/cart/workflows/add-to-cart.d.ts

@@ -1,78 +0,0 @@
-import { AdditionalData, AddToCartWorkflowInputDTO } from "@acmekit/framework/types";
-export declare const addToCartWorkflowId = "add-to-cart";
-/**
- * This workflow adds a product variant to a cart as a line item. It's executed by the
- * [Add Line Item Store API Route](https://docs.acmekit.com/api/store#carts_postcartsidlineitems).
- *
- * You can use this workflow within your own customizations or custom workflows, allowing you to wrap custom logic around adding an item to the cart.
- * For example, you can use this workflow to add a line item to the cart with a custom price.
- *
- * @example
- * const { result } = await addToCartWorkflow(container)
- * .run({
- *   input: {
- *     cart_id: "cart_123",
- *     items: [
- *       {
- *         variant_id: "variant_123",
- *         quantity: 1,
- *       },
- *       {
- *         variant_id: "variant_456",
- *         quantity: 1,
- *         unit_price: 20
- *       }
- *     ]
- *   }
- * })
- *
- * @summary
- *
- * Add a line item to a cart.
- *
- * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
- * @property hooks.setPricingContext - This hook is executed after the cart is retrieved and before the line items are created. You can consume this hook to return any custom context useful for the prices retrieval of the variants to be added to the cart.
- *
- * For example, assuming you have the following custom pricing rule:
- *
- * ```json
- * {
- *   "attribute": "location_id",
- *   "operator": "eq",
- *   "value": "sloc_123",
- * }
- * ```
- *
- * You can consume the `setPricingContext` hook to add the `location_id` context to the prices calculation:
- *
- * ```ts
- * import { addToCartWorkflow } from "@acmekit/acmekit/core-flows";
- * import { StepResponse } from "@acmekit/workflows-sdk";
- *
- * addToCartWorkflow.hooks.setPricingContext((
- *   { cart, variantIds, items, additional_data }, { container }
- * ) => {
- *   return new StepResponse({
- *     location_id: "sloc_123", // Special price for in-store purchases
- *   });
- * });
- * ```
- *
- * The variants' prices will now be retrieved using the context you return.
- *
- * :::note
- *
- * Learn more about prices calculation context in the [Prices Calculation](https://docs.acmekit.com/resources/commerce-modules/pricing/price-calculation) documentation.
- *
- * :::
- */
-export declare const addToCartWorkflow: import("@acmekit/framework/workflows-sdk").ReturnWorkflow<AddToCartWorkflowInputDTO & AdditionalData, undefined, [import("@acmekit/framework/workflows-sdk").Hook<"validate", {
-    input: AddToCartWorkflowInputDTO & AdditionalData;
-    cart: any;
-}, unknown>, import("@acmekit/framework/workflows-sdk").Hook<"setPricingContext", {
-    cart: any;
-    variantIds: import("@acmekit/framework/workflows-sdk").WorkflowData<string[]>;
-    items: import("@acmekit/framework/types").CreateCartCreateLineItemDTO[];
-    additional_data: Record<string, unknown> | undefined;
-}, Record<string, any> | undefined>]>;
-//# sourceMappingURL=add-to-cart.d.ts.map

package/dist/cart/workflows/add-to-cart.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"add-to-cart.d.ts","sourceRoot":"","sources":["../../../src/cart/workflows/add-to-cart.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,yBAAyB,EAG1B,MAAM,0BAA0B,CAAA;AA2CjC,eAAO,MAAM,mBAAmB,gBAAgB,CAAA;AAChD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;qCAoP7B,CAAA"}

package/dist/cart/workflows/add-to-cart.js

@@ -1,249 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addToCartWorkflow = exports.addToCartWorkflowId = void 0;
-const utils_1 = require("@acmekit/framework/utils");
-const workflows_sdk_1 = require("@acmekit/framework/workflows-sdk");
-const common_1 = require("../../common");
-const emit_event_1 = require("../../common/steps/emit-event");
-const locking_1 = require("../../locking");
-const steps_1 = require("../steps");
-const validate_cart_1 = require("../steps/validate-cart");
-const validate_line_item_prices_1 = require("../steps/validate-line-item-prices");
-const fields_1 = require("../utils/fields");
-const prepare_confirm_inventory_input_1 = require("../utils/prepare-confirm-inventory-input");
-const prepare_line_item_data_1 = require("../utils/prepare-line-item-data");
-const schemas_1 = require("../utils/schemas");
-const confirm_variant_inventory_1 = require("./confirm-variant-inventory");
-const get_variants_and_items_with_prices_1 = require("./get-variants-and-items-with-prices");
-const refresh_cart_items_1 = require("./refresh-cart-items");
-const cartFields = ["completed_at", "locale"].concat(fields_1.cartFieldsForPricingContext);
-exports.addToCartWorkflowId = "add-to-cart";
-/**
- * This workflow adds a product variant to a cart as a line item. It's executed by the
- * [Add Line Item Store API Route](https://docs.acmekit.com/api/store#carts_postcartsidlineitems).
- *
- * You can use this workflow within your own customizations or custom workflows, allowing you to wrap custom logic around adding an item to the cart.
- * For example, you can use this workflow to add a line item to the cart with a custom price.
- *
- * @example
- * const { result } = await addToCartWorkflow(container)
- * .run({
- *   input: {
- *     cart_id: "cart_123",
- *     items: [
- *       {
- *         variant_id: "variant_123",
- *         quantity: 1,
- *       },
- *       {
- *         variant_id: "variant_456",
- *         quantity: 1,
- *         unit_price: 20
- *       }
- *     ]
- *   }
- * })
- *
- * @summary
- *
- * Add a line item to a cart.
- *
- * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
- * @property hooks.setPricingContext - This hook is executed after the cart is retrieved and before the line items are created. You can consume this hook to return any custom context useful for the prices retrieval of the variants to be added to the cart.
- *
- * For example, assuming you have the following custom pricing rule:
- *
- * ```json
- * {
- *   "attribute": "location_id",
- *   "operator": "eq",
- *   "value": "sloc_123",
- * }
- * ```
- *
- * You can consume the `setPricingContext` hook to add the `location_id` context to the prices calculation:
- *
- * ```ts
- * import { addToCartWorkflow } from "@acmekit/acmekit/core-flows";
- * import { StepResponse } from "@acmekit/workflows-sdk";
- *
- * addToCartWorkflow.hooks.setPricingContext((
- *   { cart, variantIds, items, additional_data }, { container }
- * ) => {
- *   return new StepResponse({
- *     location_id: "sloc_123", // Special price for in-store purchases
- *   });
- * });
- * ```
- *
- * The variants' prices will now be retrieved using the context you return.
- *
- * :::note
- *
- * Learn more about prices calculation context in the [Prices Calculation](https://docs.acmekit.com/resources/commerce-modules/pricing/price-calculation) documentation.
- *
- * :::
- */
-exports.addToCartWorkflow = (0, workflows_sdk_1.createWorkflow)({
-    name: exports.addToCartWorkflowId,
-    idempotent: false,
-}, (input) => {
-    (0, locking_1.acquireLockStep)({
-        key: input.cart_id,
-        timeout: 2,
-        ttl: 10,
-    });
-    const { data: cart } = (0, common_1.useQueryGraphStep)({
-        entity: "cart",
-        filters: { id: input.cart_id },
-        fields: cartFields,
-        options: { throwIfKeyNotFound: true, isList: false },
-    }).config({ name: "get-cart" });
-    (0, validate_cart_1.validateCartStep)({ cart });
-    const validate = (0, workflows_sdk_1.createHook)("validate", {
-        input,
-        cart,
-    });
-    const variantIds = (0, workflows_sdk_1.transform)({ input }, (data) => {
-        return (data.input.items ?? [])
-            .map((i) => i.variant_id)
-            .filter((v) => !!v);
-    });
-    const setPricingContext = (0, workflows_sdk_1.createHook)("setPricingContext", {
-        cart,
-        variantIds,
-        items: input.items,
-        additional_data: input.additional_data,
-    }, {
-        resultValidator: schemas_1.pricingContextResult,
-    });
-    const setPricingContextResult = setPricingContext.getResult();
-    const { variants: variantsData, lineItems: lineItemsData } = (0, workflows_sdk_1.when)("should-calculate-prices", { variantIds }, ({ variantIds }) => {
-        return !!variantIds.length;
-    }).then(() => {
-        const { variants: variantsData, lineItems: items } = get_variants_and_items_with_prices_1.getVariantsAndItemsWithPrices.runAsStep({
-            input: {
-                cart,
-                items: input.items,
-                setPricingContextResult: setPricingContextResult,
-                variants: {
-                    id: variantIds,
-                    fields: (0, utils_1.deduplicate)([
-                        ...fields_1.productVariantsFields,
-                        ...prepare_confirm_inventory_input_1.requiredVariantFieldsForInventoryConfirmation,
-                    ]),
-                },
-            },
-        });
-        const lineItems = (0, workflows_sdk_1.transform)({ items }, ({ items }) => {
-            return items.map((item) => {
-                return item.data;
-            });
-        });
-        return { variants: variantsData, lineItems };
-    });
-    const fetchedVariants = (0, workflows_sdk_1.when)("fetch-variants", { variantsData, variantIds }, ({ variantsData, variantIds }) => {
-        return !variantsData?.length && !!variantIds.length;
-    }).then(() => {
-        return (0, common_1.useQueryGraphStep)({
-            entity: "variants",
-            fields: (0, utils_1.deduplicate)([
-                ...fields_1.productVariantsFields,
-                ...prepare_confirm_inventory_input_1.requiredVariantFieldsForInventoryConfirmation,
-            ]),
-            filters: {
-                id: variantIds,
-            },
-            options: {
-                cache: {
-                    enable: true,
-                },
-            },
-        }).config({ name: "fetch-variants" });
-    });
-    const variants = (0, workflows_sdk_1.transform)({ variantsData, fetchedVariants }, ({ variantsData, fetchedVariants }) => {
-        return (variantsData ??
-            fetchedVariants);
-    });
-    const lineItems = (0, workflows_sdk_1.transform)({ cart_id: input.cart_id, items: input.items, lineItemsData, variants }, ({ cart_id, items: items_, lineItemsData, variants }) => {
-        if (lineItemsData?.length) {
-            return lineItemsData;
-        }
-        const items = (items_ ?? []).map((item) => {
-            const variant = (variants ?? []).find((v) => v.id === item.variant_id);
-            const input = {
-                item,
-                variant: variant,
-                cartId: cart_id,
-                unitPrice: item.unit_price,
-                isTaxInclusive: item.is_tax_inclusive ??
-                    variant?.calculated_price?.is_calculated_price_tax_inclusive,
-                isCustomPrice: (0, utils_1.isDefined)(item?.unit_price),
-            };
-            if (variant && !(0, utils_1.isDefined)(input.unitPrice)) {
-                input.unitPrice = variant.calculated_price?.calculated_amount;
-            }
-            return (0, prepare_line_item_data_1.prepareLineItemData)(input);
-        });
-        return items;
-    });
-    (0, validate_line_item_prices_1.validateLineItemPricesStep)({ items: lineItems });
-    const { itemsToCreate = [], itemsToUpdate = [] } = (0, steps_1.getLineItemActionsStep)({
-        id: cart.id,
-        items: lineItems,
-    });
-    const itemsToConfirmInventory = (0, workflows_sdk_1.transform)({ itemsToUpdate, itemsToCreate }, (data) => {
-        return data.itemsToUpdate
-            .concat(data.itemsToCreate)
-            .filter((item) => (0, utils_1.isDefined)("data" in item ? item.data?.variant_id : item.variant_id));
-    });
-    confirm_variant_inventory_1.confirmVariantInventoryWorkflow.runAsStep({
-        input: {
-            sales_channel_id: cart.sales_channel_id,
-            variants: variants,
-            items: input.items,
-            itemsToUpdate: itemsToConfirmInventory,
-        },
-    });
-    const itemsToCreateVariants = (0, workflows_sdk_1.transform)({ itemsToCreate, variants }, (data) => {
-        if (!data.itemsToCreate?.length) {
-            return [];
-        }
-        const variantsMap = new Map(data.variants?.map((v) => [v.id, v]));
-        return data.itemsToCreate
-            .map((item) => item.variant_id && variantsMap.get(item.variant_id))
-            .filter(Boolean);
-    });
-    const translatedItemsToCreate = (0, common_1.getTranslatedLineItemsStep)({
-        items: itemsToCreate,
-        variants: itemsToCreateVariants,
-        locale: cart.locale,
-    });
-    const [createdLineItems, updatedLineItems] = (0, workflows_sdk_1.parallelize)((0, steps_1.createLineItemsStep)({
-        id: cart.id,
-        items: translatedItemsToCreate,
-    }), (0, steps_1.updateLineItemsStep)({
-        id: cart.id,
-        items: itemsToUpdate,
-    }));
-    const allItems = (0, workflows_sdk_1.transform)({ createdLineItems, updatedLineItems }, ({ createdLineItems = [], updatedLineItems = [] }) => {
-        return createdLineItems.concat(updatedLineItems);
-    });
-    refresh_cart_items_1.refreshCartItemsWorkflow.runAsStep({
-        input: {
-            cart_id: cart.id,
-            items: allItems,
-            additional_data: input.additional_data,
-        },
-    });
-    (0, workflows_sdk_1.parallelize)((0, emit_event_1.emitEventStep)({
-        eventName: utils_1.CartWorkflowEvents.UPDATED,
-        data: { id: cart.id },
-    }), (0, locking_1.releaseLockStep)({
-        key: cart.id,
-    }));
-    return new workflows_sdk_1.WorkflowResponse(void 0, {
-        hooks: [validate, setPricingContext],
-    });
-});
-//# sourceMappingURL=add-to-cart.js.map

package/dist/cart/workflows/add-to-cart.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"add-to-cart.js","sourceRoot":"","sources":["../../../src/cart/workflows/add-to-cart.ts"],"names":[],"mappings":"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"}