@xbstracts/medusa-coupons 0.0.1

package/.medusa/server/src/workflows/hooks/validate-coupon-add-to-cart.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_flows_1 = require("@medusajs/medusa/core-flows");
+const validate_coupon_purchase_1 = require("../validate-coupon-purchase");
+core_flows_1.addToCartWorkflow.hooks.validate(async ({ input, cart }, { container }) => {
+    await (0, validate_coupon_purchase_1.validateCouponPurchaseForCart)({
+        cart,
+        container,
+        deferMissingCountry: true,
+        inputItems: input.items || [],
+    });
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGUtY291cG9uLWFkZC10by1jYXJ0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL3dvcmtmbG93cy9ob29rcy92YWxpZGF0ZS1jb3Vwb24tYWRkLXRvLWNhcnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFBQSw0REFBK0Q7QUFDL0QsMEVBQTJFO0FBRTNFLDhCQUFpQixDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsS0FBSyxFQUFFLEVBQUUsS0FBSyxFQUFFLElBQUksRUFBRSxFQUFFLEVBQUUsU0FBUyxFQUFFLEVBQUUsRUFBRTtJQUN4RSxNQUFNLElBQUEsd0RBQTZCLEVBQUM7UUFDbEMsSUFBSTtRQUNKLFNBQVM7UUFDVCxtQkFBbUIsRUFBRSxJQUFJO1FBQ3pCLFVBQVUsRUFBRyxLQUFhLENBQUMsS0FBSyxJQUFJLEVBQUU7S0FDdkMsQ0FBQyxDQUFBO0FBQ0osQ0FBQyxDQUFDLENBQUEifQ==

package/.medusa/server/src/workflows/hooks/validate-coupon-complete-cart.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_flows_1 = require("@medusajs/medusa/core-flows");
+const validate_coupon_purchase_1 = require("../validate-coupon-purchase");
+core_flows_1.completeCartWorkflow.hooks.validate(async ({ cart }, { container }) => {
+    await (0, validate_coupon_purchase_1.validateCouponPurchaseForCart)({ cart, container });
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGUtY291cG9uLWNvbXBsZXRlLWNhcnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvd29ya2Zsb3dzL2hvb2tzL3ZhbGlkYXRlLWNvdXBvbi1jb21wbGV0ZS1jYXJ0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQUEsNERBQWtFO0FBQ2xFLDBFQUEyRTtBQUUzRSxpQ0FBb0IsQ0FBQyxLQUFLLENBQUMsUUFBUSxDQUFDLEtBQUssRUFBRSxFQUFFLElBQUksRUFBRSxFQUFFLEVBQUUsU0FBUyxFQUFFLEVBQUUsRUFBRTtJQUNwRSxNQUFNLElBQUEsd0RBQTZCLEVBQUMsRUFBRSxJQUFJLEVBQUUsU0FBUyxFQUFFLENBQUMsQ0FBQTtBQUMxRCxDQUFDLENBQUMsQ0FBQSJ9

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateCouponProductConfigStep = exports.issueCustomerCouponsFromOrderStep = exports.createCouponProductConfigStep = exports.issueCustomerCouponsFromOrderWorkflow = exports.updateCouponProductConfigWorkflow = exports.createCouponProductConfigWorkflow = void 0;
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const steps_1 = require("./steps");
+Object.defineProperty(exports, "createCouponProductConfigStep", { enumerable: true, get: function () { return steps_1.createCouponProductConfigStep; } });
+Object.defineProperty(exports, "issueCustomerCouponsFromOrderStep", { enumerable: true, get: function () { return steps_1.issueCustomerCouponsFromOrderStep; } });
+Object.defineProperty(exports, "updateCouponProductConfigStep", { enumerable: true, get: function () { return steps_1.updateCouponProductConfigStep; } });
+exports.createCouponProductConfigWorkflow = (0, workflows_sdk_1.createWorkflow)("create-coupon-product-config-workflow", (input) => {
+    const config = (0, steps_1.createCouponProductConfigStep)(input);
+    return new workflows_sdk_1.WorkflowResponse(config);
+});
+exports.updateCouponProductConfigWorkflow = (0, workflows_sdk_1.createWorkflow)("update-coupon-product-config-workflow", (input) => {
+    const config = (0, steps_1.updateCouponProductConfigStep)(input);
+    return new workflows_sdk_1.WorkflowResponse(config);
+});
+exports.issueCustomerCouponsFromOrderWorkflow = (0, workflows_sdk_1.createWorkflow)("issue-customer-coupons-from-order-workflow", (input) => {
+    const issuances = (0, steps_1.issueCustomerCouponsFromOrderStep)(input);
+    return new workflows_sdk_1.WorkflowResponse(issuances);
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvd29ya2Zsb3dzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHFFQUkwQztBQUUxQyxtQ0FJZ0I7QUEyQmQsOEdBOUJBLHFDQUE2QixPQThCQTtBQUM3QixrSEE5QkEseUNBQWlDLE9BOEJBO0FBQ2pDLDhHQTlCQSxxQ0FBNkIsT0E4QkE7QUEzQmxCLFFBQUEsaUNBQWlDLEdBQUcsSUFBQSw4QkFBYyxFQUM3RCx1Q0FBdUMsRUFDdkMsQ0FBQyxLQUFnRSxFQUFFLEVBQUU7SUFDbkUsTUFBTSxNQUFNLEdBQUcsSUFBQSxxQ0FBNkIsRUFBQyxLQUFLLENBQUMsQ0FBQTtJQUNuRCxPQUFPLElBQUksZ0NBQWdCLENBQUMsTUFBTSxDQUFDLENBQUE7QUFDckMsQ0FBQyxDQUNGLENBQUE7QUFFWSxRQUFBLGlDQUFpQyxHQUFHLElBQUEsOEJBQWMsRUFDN0QsdUNBQXVDLEVBQ3ZDLENBQUMsS0FBd0QsRUFBRSxFQUFFO0lBQzNELE1BQU0sTUFBTSxHQUFHLElBQUEscUNBQTZCLEVBQUMsS0FBSyxDQUFDLENBQUE7SUFDbkQsT0FBTyxJQUFJLGdDQUFnQixDQUFDLE1BQU0sQ0FBQyxDQUFBO0FBQ3JDLENBQUMsQ0FDRixDQUFBO0FBRVksUUFBQSxxQ0FBcUMsR0FBRyxJQUFBLDhCQUFjLEVBQ2pFLDRDQUE0QyxFQUM1QyxDQUFDLEtBQWdDLEVBQUUsRUFBRTtJQUNuQyxNQUFNLFNBQVMsR0FBRyxJQUFBLHlDQUFpQyxFQUFDLEtBQUssQ0FBQyxDQUFBO0lBQzFELE9BQU8sSUFBSSxnQ0FBZ0IsQ0FBQyxTQUFTLENBQUMsQ0FBQTtBQUN4QyxDQUFDLENBQ0YsQ0FBQSJ9

package/.medusa/server/src/workflows/steps.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.issueCustomerCouponsFromOrderStep = exports.updateCouponProductConfigStep = exports.createCouponProductConfigStep = void 0;
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const coupon_1 = require("../modules/coupon");
+exports.createCouponProductConfigStep = (0, workflows_sdk_1.createStep)("create-coupon-product-config", async (input, { container }) => {
+    const service = container.resolve(coupon_1.COUPON_MODULE);
+    const config = await service.createProductConfig(input);
+    return new workflows_sdk_1.StepResponse(config, config.id);
+}, async (id, { container }) => {
+    if (!id)
+        return;
+    const service = container.resolve(coupon_1.COUPON_MODULE);
+    await service.deleteCouponProductConfigs(id);
+});
+exports.updateCouponProductConfigStep = (0, workflows_sdk_1.createStep)("update-coupon-product-config", async (input, { container }) => {
+    const service = container.resolve(coupon_1.COUPON_MODULE);
+    const { id, ...data } = input;
+    const config = await service.updateProductConfig(id, data);
+    return new workflows_sdk_1.StepResponse(config);
+});
+exports.issueCustomerCouponsFromOrderStep = (0, workflows_sdk_1.createStep)("issue-customer-coupons-from-order", async (input, { container }) => {
+    const service = container.resolve(coupon_1.COUPON_MODULE);
+    const issuances = await service.issueFromOrder(input);
+    return new workflows_sdk_1.StepResponse(issuances);
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RlcHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvd29ya2Zsb3dzL3N0ZXBzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHFFQUE0RTtBQUM1RSw4Q0FBaUQ7QUFJcEMsUUFBQSw2QkFBNkIsR0FBRyxJQUFBLDBCQUFVLEVBQ3JELDhCQUE4QixFQUM5QixLQUFLLEVBQ0gsS0FBa0QsRUFDbEQsRUFBRSxTQUFTLEVBQUUsRUFDYixFQUFFO0lBQ0YsTUFBTSxPQUFPLEdBQXdCLFNBQVMsQ0FBQyxPQUFPLENBQUMsc0JBQWEsQ0FBQyxDQUFBO0lBQ3JFLE1BQU0sTUFBTSxHQUFHLE1BQU0sT0FBTyxDQUFDLG1CQUFtQixDQUFDLEtBQUssQ0FBQyxDQUFBO0lBQ3ZELE9BQU8sSUFBSSw0QkFBWSxDQUFDLE1BQU0sRUFBRSxNQUFNLENBQUMsRUFBRSxDQUFDLENBQUE7QUFDNUMsQ0FBQyxFQUNELEtBQUssRUFBRSxFQUFFLEVBQUUsRUFBRSxTQUFTLEVBQUUsRUFBRSxFQUFFO0lBQzFCLElBQUksQ0FBQyxFQUFFO1FBQUUsT0FBTTtJQUNmLE1BQU0sT0FBTyxHQUF3QixTQUFTLENBQUMsT0FBTyxDQUFDLHNCQUFhLENBQUMsQ0FBQTtJQUNyRSxNQUFNLE9BQU8sQ0FBQywwQkFBMEIsQ0FBQyxFQUFFLENBQUMsQ0FBQTtBQUM5QyxDQUFDLENBQ0YsQ0FBQTtBQUVZLFFBQUEsNkJBQTZCLEdBQUcsSUFBQSwwQkFBVSxFQUNyRCw4QkFBOEIsRUFDOUIsS0FBSyxFQUFFLEtBQTBDLEVBQUUsRUFBRSxTQUFTLEVBQUUsRUFBRSxFQUFFO0lBQ2xFLE1BQU0sT0FBTyxHQUF3QixTQUFTLENBQUMsT0FBTyxDQUFDLHNCQUFhLENBQUMsQ0FBQTtJQUNyRSxNQUFNLEVBQUUsRUFBRSxFQUFFLEdBQUcsSUFBSSxFQUFFLEdBQUcsS0FBSyxDQUFBO0lBQzdCLE1BQU0sTUFBTSxHQUFHLE1BQU0sT0FBTyxDQUFDLG1CQUFtQixDQUFDLEVBQUUsRUFBRSxJQUFJLENBQUMsQ0FBQTtJQUMxRCxPQUFPLElBQUksNEJBQVksQ0FBQyxNQUFNLENBQUMsQ0FBQTtBQUNqQyxDQUFDLENBQ0YsQ0FBQTtBQUVZLFFBQUEsaUNBQWlDLEdBQUcsSUFBQSwwQkFBVSxFQUN6RCxtQ0FBbUMsRUFDbkMsS0FBSyxFQUFFLEtBQWtCLEVBQUUsRUFBRSxTQUFTLEVBQUUsRUFBRSxFQUFFO0lBQzFDLE1BQU0sT0FBTyxHQUF3QixTQUFTLENBQUMsT0FBTyxDQUFDLHNCQUFhLENBQUMsQ0FBQTtJQUNyRSxNQUFNLFNBQVMsR0FBRyxNQUFNLE9BQU8sQ0FBQyxjQUFjLENBQUMsS0FBSyxDQUFDLENBQUE7SUFDckQsT0FBTyxJQUFJLDRCQUFZLENBQUMsU0FBUyxDQUFDLENBQUE7QUFDcEMsQ0FBQyxDQUNGLENBQUEifQ==

package/.medusa/server/src/workflows/validate-coupon-purchase.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCouponPurchaseForCart = validateCouponPurchaseForCart;
+const utils_1 = require("@medusajs/framework/utils");
+const coupon_1 = require("../modules/coupon");
+const purchase_conditions_1 = require("../modules/coupon/purchase-conditions");
+const ATTRIBUTE_LABELS = {
+    "customer.groups.id": "Customer Group",
+    "region.id": "Region",
+    "shipping_address.country_code": "Country",
+    sales_channel_id: "Sales Channel",
+    currency_code: "Currency Code",
+};
+async function retrieveCouponPurchaseCart(container, cartId) {
+    const query = container.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+    const { data } = await query.graph({
+        entity: "cart",
+        fields: [
+            "id",
+            "currency_code",
+            "region_id",
+            "sales_channel_id",
+            "region.id",
+            "sales_channel.id",
+            "shipping_address.country_code",
+            "customer.id",
+            "customer.groups.id",
+            "items.id",
+            "items.product_id",
+            "items.variant_id",
+            "items.product.id",
+            "items.variant.id",
+        ],
+        filters: { id: cartId },
+    });
+    return data?.[0] || null;
+}
+async function resolveInputLines(container, items) {
+    const variantIds = Array.from(new Set(items.map((item) => item.variant_id).filter(Boolean)));
+    if (!variantIds.length)
+        return [];
+    const query = container.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+    const { data } = await query.graph({
+        entity: "variant",
+        fields: ["id", "product_id", "product.id"],
+        filters: { id: variantIds },
+    });
+    const byId = Object.fromEntries((data || []).map((variant) => [variant.id, variant]));
+    return items.flatMap((item) => {
+        const variant = byId[item.variant_id];
+        return variant
+            ? [
+                {
+                    product_id: variant.product_id || variant.product?.id,
+                    variant_id: variant.id,
+                    product: variant.product,
+                    variant,
+                },
+            ]
+            : [];
+    });
+}
+async function validateCouponPurchaseForCart({ cart, container, deferMissingCountry = false, inputItems, }) {
+    const fullCart = await retrieveCouponPurchaseCart(container, cart.id);
+    if (!fullCart)
+        return;
+    const lines = inputItems?.length
+        ? await resolveInputLines(container, inputItems)
+        : (fullCart.items || []);
+    const service = container.resolve(coupon_1.COUPON_MODULE);
+    const context = (0, purchase_conditions_1.buildCouponPurchaseContext)(fullCart);
+    for (const line of lines) {
+        const config = await service.resolveConfigForLineItem(line);
+        if (!config?.purchase_conditions.length)
+            continue;
+        const evaluation = (0, purchase_conditions_1.evaluateCouponPurchaseConditions)(config.purchase_conditions, context, { defer_missing_country: deferMissingCountry });
+        if (!evaluation.eligible) {
+            const failed = evaluation.failed_attributes
+                .map((attribute) => ATTRIBUTE_LABELS[attribute] || attribute)
+                .join(", ");
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.NOT_ALLOWED, `This coupon product cannot be purchased with the current cart conditions: ${failed}`);
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGUtY291cG9uLXB1cmNoYXNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3dvcmtmbG93cy92YWxpZGF0ZS1jb3Vwb24tcHVyY2hhc2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUEwRUEsc0VBdUNDO0FBakhELHFEQUFrRjtBQUNsRiw4Q0FBaUQ7QUFHakQsK0VBRzhDO0FBRTlDLE1BQU0sZ0JBQWdCLEdBQTJCO0lBQy9DLG9CQUFvQixFQUFFLGdCQUFnQjtJQUN0QyxXQUFXLEVBQUUsUUFBUTtJQUNyQiwrQkFBK0IsRUFBRSxTQUFTO0lBQzFDLGdCQUFnQixFQUFFLGVBQWU7SUFDakMsYUFBYSxFQUFFLGVBQWU7Q0FDL0IsQ0FBQTtBQUVELEtBQUssVUFBVSwwQkFBMEIsQ0FBQyxTQUFjLEVBQUUsTUFBYztJQUN0RSxNQUFNLEtBQUssR0FBRyxTQUFTLENBQUMsT0FBTyxDQUFDLGlDQUF5QixDQUFDLEtBQUssQ0FBQyxDQUFBO0lBQ2hFLE1BQU0sRUFBRSxJQUFJLEVBQUUsR0FBRyxNQUFNLEtBQUssQ0FBQyxLQUFLLENBQUM7UUFDakMsTUFBTSxFQUFFLE1BQU07UUFDZCxNQUFNLEVBQUU7WUFDTixJQUFJO1lBQ0osZUFBZTtZQUNmLFdBQVc7WUFDWCxrQkFBa0I7WUFDbEIsV0FBVztZQUNYLGtCQUFrQjtZQUNsQiwrQkFBK0I7WUFDL0IsYUFBYTtZQUNiLG9CQUFvQjtZQUNwQixVQUFVO1lBQ1Ysa0JBQWtCO1lBQ2xCLGtCQUFrQjtZQUNsQixrQkFBa0I7WUFDbEIsa0JBQWtCO1NBQ25CO1FBQ0QsT0FBTyxFQUFFLEVBQUUsRUFBRSxFQUFFLE1BQU0sRUFBRTtLQUN4QixDQUFDLENBQUE7SUFFRixPQUFPLElBQUksRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLElBQUksQ0FBQTtBQUMxQixDQUFDO0FBRUQsS0FBSyxVQUFVLGlCQUFpQixDQUFDLFNBQWMsRUFBRSxLQUFZO0lBQzNELE1BQU0s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

package/README.md

@@ -0,0 +1,84 @@
+# medusa-coupons
+
+Reusable Medusa v2 plugin for coupon products.
+
+## Scope
+
+`medusa-coupons` treats a coupon product as a normal Medusa product or variant with coupon issuance configuration. When a configured product is purchased, the plugin creates generic Medusa-owned customer coupon entitlements and emits coupon events that a project integration can consume.
+
+This plugin intentionally does not implement gift cards, store credit, POS sync, digital downloads, license keys, Strapi sync, or His/Her-specific behavior. Medusa's loyalty plugin remains responsible for gift cards and store credit.
+
+## Main Surfaces
+
+- Module: `coupon`
+- Admin routes: `/admin/coupon-products/*`
+- Dashboard pages: `/dashboard/coupons` and `/dashboard/coupons/products`
+- Subscriber: `payment.captured` coupon issuance and redemption
+- Events:
+  - `coupon_product_config.created`
+  - `coupon_product_config.updated`
+  - `coupon_product_config.deleted`
+  - `coupon_product.purchased`
+  - `coupon_issuance.created`
+  - `customer_coupon_entitlement.issued`
+  - `customer_coupon_entitlement.redeemed`
+  - `customer_coupon_entitlement.canceled`
+  - `coupon_promotion_mirror.created`
+  - `coupon_promotion_mirror.failed`
+
+## Data Model
+
+- `CouponProductConfig`: product-level coupon defaults.
+- `CouponProductVariantConfig`: optional variant-level overrides.
+- `CouponIssuance`: idempotent order line issuance record.
+- `CustomerCouponEntitlement`: generic Medusa-owned customer entitlement.
+- `CouponPromotionMirror`: optional Medusa Promotion mirror state.
+
+Product config is authoritative. Product metadata only receives a small `metadata.medusa_coupons` marker for discovery.
+
+Fixed-amount coupons use `amounts: [{ currency_code, amount }]`. Issued
+entitlements keep an immutable copy of every configured currency amount. The
+plugin translates entitlement codes applied to Medusa carts and draft orders
+into one-use internal promotions for the exact order currency; it never
+converts currencies or falls back to another configured amount.
+
+Percentage coupons can target products or the whole order. Product-scoped
+coupons preserve `each` or `once` allocation. Order-scoped coupons persist
+`promotion_template.application_method.target_type = "order"` and always use
+`allocation = "across"`. The target and allocation are copied into immutable
+issuance and entitlement snapshots.
+
+## Purchase Conditions
+
+Coupon products can restrict purchase by customer group, region, shipping
+country, sales channel, and currency. Conditions use `eq`, `in`, or `ne`, each
+attribute can appear once, and all configured conditions must match. A product
+without conditions is available to every cart context.
+
+Fixed-amount coupons require a Currency Code condition. Their coupon values are
+stored once per effective currency; product selling prices remain independent.
+A `ne` currency condition derives its effective values from the store's current
+supported currencies, so the coupon must be reviewed when a new store currency
+is introduced.
+
+The Sales Channel condition also synchronizes the product's Medusa sales-channel
+links. Country validation is deferred while adding a line when the cart has no
+shipping address, then enforced strictly by `completeCartWorkflow`. Every other
+condition is enforced during both add-to-cart and checkout. Issuance snapshots
+retain the configured conditions and the cart context that matched them.
+
+## Promotion Mirroring
+
+Promotion mirroring is opt-in. Shared-code configs can create reusable Medusa
+promotions. Unique and shared entitlement codes are also resolved at checkout
+to customer-bound, one-use internal promotions. Percentage-off-order coupons
+map to a Medusa `PERCENTAGE + ORDER + ACROSS` application method; percentage
+redemption is recorded separately from fixed-amount redemption.
+
+## Commands
+
+```bash
+npm install
+npm test
+npm run build
+```

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@xbstracts/medusa-coupons",
+  "version": "0.0.1",
+  "description": "Reusable Medusa coupon product plugin.",
+  "license": "MIT",
+  "homepage": "https://github.com/xbstracts/medusa-coupons#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xbstracts/medusa-coupons.git"
+  },
+  "bugs": {
+    "url": "https://github.com/xbstracts/medusa-coupons/issues"
+  },
+  "author": "Patiparnne <patiparnne@gmail.com>",
+  "buy_me_a_coffee": "https://buymeacoffee.com/patiparnne",
+  "patreon": "https://www.patreon.com/patiparnne",
+  "files": [
+    ".medusa/server"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    "./workflows": "./.medusa/server/src/workflows/index.js",
+    "./.medusa/server/src/modules/*": "./.medusa/server/src/modules/*/index.js",
+    "./modules/*": "./.medusa/server/src/modules/*/index.js",
+    "./providers/*": "./.medusa/server/src/providers/*/index.js",
+    "./*": "./.medusa/server/src/*.js",
+    "./admin": {
+      "import": "./.medusa/server/src/admin/index.mjs",
+      "require": "./.medusa/server/src/admin/index.js",
+      "default": "./.medusa/server/src/admin/index.js"
+    },
+    "./vendor": {
+      "import": "./.medusa/server/src/vendor/index.mjs",
+      "default": "./.medusa/server/src/vendor/index.mjs"
+    }
+  },
+  "keywords": [
+    "medusa",
+    "coupon-products",
+    "coupons",
+    "plugin",
+    "medusa-plugin",
+    "medusa-v2"
+  ],
+  "scripts": {
+    "build": "medusa plugin:build && node scripts/write-dashboard-extension-mjs.mjs && node scripts/assert-dashboard-extensions.mjs",
+    "dev": "medusa plugin:develop",
+    "lint": "medusa lint",
+    "test": "jest --runInBand",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@medusajs/admin-sdk": "2.13.4",
+    "@medusajs/framework": "2.13.4",
+    "@medusajs/icons": "2.13.4",
+    "@medusajs/medusa": "2.13.4",
+    "@medusajs/ui": "4.1.1",
+    "@mercurjs/dashboard-sdk": "2.1.1",
+    "@tanstack/react-query": "5.64.2",
+    "multer": "^2.0.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-i18next": "13.5.0",
+    "react-router-dom": "6.30.3"
+  },
+  "devDependencies": {
+    "@hookform/resolvers": "3.4.2",
+    "@medusajs/cli": "2.13.4",
+    "@medusajs/eslint-plugin": "2.17.2",
+    "@medusajs/test-utils": "2.13.4",
+    "@swc/core": "^1.7.28",
+    "@swc/jest": "^0.2.36",
+    "@types/jest": "^29.5.13",
+    "@types/multer": "^2.0.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.3.2",
+    "@types/react-dom": "^18.2.25",
+    "esbuild": "0.21.5",
+    "eslint": "^9.0.0",
+    "jest": "^29.7.0",
+    "jiti": "^2.0.0",
+    "prop-types": "^15.8.1",
+    "react-hook-form": "7.49.1",
+    "ts-node": "^10.9.2",
+    "typescript": "5.9.3",
+    "vite": "^5.2.11",
+    "yalc": "^1.0.0-pre.53"
+  },
+  "peerDependencies": {
+    "@medusajs/admin-sdk": "2.13.4",
+    "@medusajs/cli": "2.13.4",
+    "@medusajs/framework": "2.13.4",
+    "@medusajs/icons": "2.13.4",
+    "@medusajs/medusa": "2.13.4",
+    "@medusajs/test-utils": "2.13.4",
+    "@medusajs/ui": "4.1.1"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "npm@11.4.2"
+}