@hartl-services/medusa-base 0.4.0 → 1.1.0

package/.medusa/server/src/migration-scripts/dismiss-orphaned-cart-promotion-links.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dismissOrphanedCartPromotionLinks = void 0;
+exports.default = dismissOrphanedCartPromotionLinksScript;
+const utils_1 = require("@medusajs/framework/utils");
+const cart_promotion_links_1 = require("../utils/cart-promotion-links");
+/**
+ * One-off repair, run exactly once by `medusa db:migrate`: removes every
+ * `cart_promotion` link whose promotion was deleted before the
+ * `promotionsDeleted` hook (src/workflows/hooks/dismiss-deleted-
+ * promotion-cart-links.ts) existed. Such links surface as `null` entries in
+ * `cart.promotions` and crashed both the storefront cart and the affiliate
+ * plugin's cart hooks.
+ */
+const dismissOrphanedCartPromotionLinks = async (container) => {
+    const orphaned = await (0, cart_promotion_links_1.findOrphanedCartPromotionLinks)(container);
+    await (0, cart_promotion_links_1.dismissCartPromotionLinks)(container, orphaned);
+    return orphaned.length;
+};
+exports.dismissOrphanedCartPromotionLinks = dismissOrphanedCartPromotionLinks;
+async function dismissOrphanedCartPromotionLinksScript({ container, }) {
+    const logger = container.resolve(utils_1.ContainerRegistrationKeys.LOGGER);
+    const removed = await (0, exports.dismissOrphanedCartPromotionLinks)(container);
+    logger.info(`Removed ${removed} cart_promotion link(s) pointing at deleted promotions.`);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGlzbWlzcy1vcnBoYW5lZC1jYXJ0LXByb21vdGlvbi1saW5rcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9taWdyYXRpb24tc2NyaXB0cy9kaXNtaXNzLW9ycGhhbmVkLWNhcnQtcHJvbW90aW9uLWxpbmtzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQXdCQSwwREFVQztBQWpDRCxxREFBcUU7QUFFckUsd0VBR3NDO0FBRXRDOzs7Ozs7O0dBT0c7QUFDSSxNQUFNLGlDQUFpQyxHQUFHLEtBQUssRUFDcEQsU0FBMEIsRUFDVCxFQUFFO0lBQ25CLE1BQU0sUUFBUSxHQUFHLE1BQU0sSUFBQSxxREFBOEIsRUFBQyxTQUFTLENBQUMsQ0FBQTtJQUNoRSxNQUFNLElBQUEsZ0RBQXlCLEVBQUMsU0FBUyxFQUFFLFFBQVEsQ0FBQyxDQUFBO0lBQ3BELE9BQU8sUUFBUSxDQUFDLE1BQU0sQ0FBQTtBQUN4QixDQUFDLENBQUE7QUFOWSxRQUFBLGlDQUFpQyxxQ0FNN0M7QUFFYyxLQUFLLFVBQVUsdUNBQXVDLENBQUMsRUFDcEUsU0FBUyxHQUdWO0lBQ0MsTUFBTSxNQUFNLEdBQUcsU0FBUyxDQUFDLE9BQU8sQ0FBQyxpQ0FBeUIsQ0FBQyxNQUFNLENBQUMsQ0FBQTtJQUNsRSxNQUFNLE9BQU8sR0FBRyxNQUFNLElBQUEseUNBQWlDLEVBQUMsU0FBUyxDQUFDLENBQUE7SUFDbEUsTUFBTSxDQUFDLElBQUksQ0FDVCxXQUFXLE9BQU8seURBQXlELENBQzVFLENBQUE7QUFDSCxDQUFDIn0=

package/.medusa/server/src/modules/documents/domain/cancellation-snapshot.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCancellationSnapshot = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const snapshot_normalization_1 = require("./snapshot-normalization");
+const tax_breakdown_1 = require("./tax-breakdown");
+const asPositiveAmount = (value, field) => {
+    const amount = utils_1.MathBN.convert(value);
+    if (!amount.isFinite() || !utils_1.MathBN.gt(amount, 0)) {
+        throw new Error(`${field} must be a positive monetary amount.`);
+    }
+    return amount;
+};
+const scaleAsNegativeMoney = (input) => {
+    if (input.money.currency_code !== input.currency_code) {
+        throw new Error("The original invoice snapshot contains mixed currencies.");
+    }
+    const decimalPlaces = (0, tax_breakdown_1.getCurrencyDecimalPlaces)(input.currency_code);
+    const amount = utils_1.MathBN.mult(utils_1.MathBN.div(utils_1.MathBN.convert(input.money.amount), input.source_total), input.refund_amount)
+        .negated()
+        .decimalPlaces(decimalPlaces)
+        .toFixed(decimalPlaces);
+    return {
+        amount,
+        currency_code: input.currency_code,
+    };
+};
+/**
+ * Builds a negative correction from the invoice snapshot that the customer
+ * actually received. A payment refund has no item allocation, therefore the
+ * stored invoice's tax and total distribution is applied proportionally.
+ */
+const createCancellationSnapshot = (input) => {
+    const sourceInvoice = (0, snapshot_normalization_1.normalizeDocumentSnapshot)(input.source_invoice);
+    if (sourceInvoice.document.kind !== "invoice" ||
+        !sourceInvoice.document.number) {
+        throw new Error("A numbered invoice snapshot is required for a cancellation.");
+    }
+    if (Number.isNaN(input.issued_at.getTime())) {
+        throw new Error("The cancellation issue date is invalid.");
+    }
+    const currencyCode = sourceInvoice.order.currency_code;
+    const sourceTotal = asPositiveAmount(sourceInvoice.totals.total.amount, "The original invoice total");
+    const refundAmount = asPositiveAmount(input.refund_amount, "The refund amount");
+    if (utils_1.MathBN.gt(refundAmount, sourceTotal)) {
+        throw new Error("The refund amount cannot exceed the original invoice total.");
+    }
+    const scale = (money) => scaleAsNegativeMoney({
+        money,
+        source_total: sourceTotal,
+        refund_amount: refundAmount,
+        currency_code: currencyCode,
+    });
+    const subtotal = scale(sourceInvoice.totals.subtotal);
+    const taxTotal = scale(sourceInvoice.totals.tax_total);
+    const taxBreakdown = (0, tax_breakdown_1.roundTaxBreakdown)(sourceInvoice.totals.tax_breakdown.map((entry) => ({
+        ...entry,
+        tax_total: scale(entry.tax_total),
+    })), taxTotal);
+    const total = {
+        amount: refundAmount.negated().toFixed((0, tax_breakdown_1.getCurrencyDecimalPlaces)(currencyCode)),
+        currency_code: currencyCode,
+    };
+    return {
+        document: {
+            id: input.document_id,
+            kind: "cancellation",
+            number: input.document_number,
+            issued_at: input.issued_at.toISOString(),
+            source_document_number: sourceInvoice.document.number,
+        },
+        order: { ...sourceInvoice.order },
+        lines: [
+            {
+                id: `refund:${input.document_id}`,
+                title: `Rückerstattung zu Rechnung ${sourceInvoice.document.number}`,
+                sku: null,
+                quantity: 1,
+                unit_price: { ...subtotal },
+                subtotal,
+                tax_total: taxTotal,
+                total,
+                batch_allocations: [],
+            },
+        ],
+        totals: {
+            subtotal,
+            tax_total: taxTotal,
+            tax_breakdown: taxBreakdown,
+            shipping_total: scale(sourceInvoice.totals.shipping_total),
+            discount_total: scale(sourceInvoice.totals.discount_total),
+            total,
+        },
+    };
+};
+exports.createCancellationSnapshot = createCancellationSnapshot;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FuY2VsbGF0aW9uLXNuYXBzaG90LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL21vZHVsZXMvZG9jdW1lbnRzL2RvbWFpbi9jYW5jZWxsYXRpb24tc25hcHNob3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEscURBQWtEO0FBTWxELHFFQUFvRTtBQUNwRSxtREFBNkU7QUFFN0UsTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLEtBQWEsRUFBRSxLQUFhLEVBQUUsRUFBRTtJQUN4RCxNQUFNLE1BQU0sR0FBRyxjQUFNLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFBO0lBQ3BDLElBQUksQ0FBQyxNQUFNLENBQUMsUUFBUSxFQUFFLElBQUksQ0FBQyxjQUFNLENBQUMsRUFBRSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ2hELE1BQU0sSUFBSSxLQUFLLENBQUMsR0FBRyxLQUFLLHNDQUFzQyxDQUFDLENBQUE7SUFDakUsQ0FBQztJQUVELE9BQU8sTUFBTSxDQUFBO0FBQ2YsQ0FBQyxDQUFBO0FBRUQsTUFBTSxvQkFBb0IsR0FBRyxDQUFDLEtBSzdCLEVBQWlCLEVBQUU7SUFDbEIsSUFBSSxLQUFLLENBQUMsS0FBSyxDQUFDLGFBQWEsS0FBSyxLQUFLLENBQUMsYUFBYSxFQUFFLENBQUM7UUFDdEQsTUFBTSxJQUFJLEtBQUssQ0FBQywwREFBMEQsQ0FBQyxDQUFBO0lBQzdFLENBQUM7SUFFRCxNQUFNLGFBQWEsR0FBRyxJQUFBLHdDQUF3QixFQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsQ0FBQTtJQUNuRSxNQUFNLE1BQU0sR0FBRyxjQUFNLENBQUMsSUFBSSxDQUN4QixjQUFNLENBQUMsR0FBRyxDQUFDLGNBQU0sQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsRUFBRSxLQUFLLENBQUMsWUFBWSxDQUFDLEVBQ2xFLEtBQUssQ0FBQyxhQUFh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

package/.medusa/server/src/modules/documents/domain/document-number.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDocumentNumberPeriodYear = exports.formatDocumentNumber = void 0;
+const prefixByKind = {
+    invoice: "RE",
+    cancellation: "ST",
+    credit_note: "GS",
+};
+const formatDocumentNumber = (input) => {
+    if (!Number.isInteger(input.periodYear) || input.periodYear <= 0) {
+        throw new Error("The document-number period year must be a positive integer.");
+    }
+    if (!Number.isInteger(input.sequenceValue) || input.sequenceValue <= 0) {
+        throw new Error("The document-number sequence value must be a positive integer.");
+    }
+    return `${prefixByKind[input.kind]}-${input.periodYear}-${input.sequenceValue}`;
+};
+exports.formatDocumentNumber = formatDocumentNumber;
+const resolveDocumentNumberPeriodYear = (issuedAt, timeZone) => {
+    if (Number.isNaN(issuedAt.getTime())) {
+        throw new Error("The document issue date is invalid.");
+    }
+    const year = new Intl.DateTimeFormat("en", {
+        timeZone,
+        year: "numeric",
+    })
+        .formatToParts(issuedAt)
+        .find((part) => part.type === "year")?.value;
+    const periodYear = Number(year);
+    if (!Number.isInteger(periodYear) || periodYear <= 0) {
+        throw new Error("The document-number period year could not be resolved.");
+    }
+    return periodYear;
+};
+exports.resolveDocumentNumberPeriodYear = resolveDocumentNumberPeriodYear;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG9jdW1lbnQtbnVtYmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL21vZHVsZXMvZG9jdW1lbnRzL2RvbWFpbi9kb2N1bWVudC1udW1iZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBRUEsTUFBTSxZQUFZLEdBQWlDO0lBQ2pELE9BQU8sRUFBRSxJQUFJO0lBQ2IsWUFBWSxFQUFFLElBQUk7SUFDbEIsV0FBVyxFQUFFLElBQUk7Q0FDbEIsQ0FBQTtBQUVNLE1BQU0sb0JBQW9CLEdBQUcsQ0FBQyxLQUlwQyxFQUFVLEVBQUU7SUFDWCxJQUFJLENBQUMsTUFBTSxDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsVUFBVSxDQUFDLElBQUksS0FBSyxDQUFDLFVBQVUsSUFBSSxDQUFDLEVBQUUsQ0FBQztRQUNqRSxNQUFNLElBQUksS0FBSyxDQUFDLDZEQUE2RCxDQUFDLENBQUE7SUFDaEYsQ0FBQztJQUNELElBQUksQ0FBQyxNQUFNLENBQUMsU0FBUyxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsSUFBSSxLQUFLLENBQUMsYUFBYSxJQUFJLENBQUMsRUFBRSxDQUFDO1FBQ3ZFLE1BQU0sSUFBSSxLQUFLLENBQUMsZ0VBQWdFLENBQUMsQ0FBQTtJQUNuRixDQUFDO0lBRUQsT0FBTyxHQUFHLFlBQVksQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksS0FBSyxDQUFDLFVBQVUsSUFBSSxLQUFLLENBQUMsYUFBYSxFQUFFLENBQUE7QUFDakYsQ0FBQyxDQUFBO0FBYlksUUFBQSxvQkFBb0Isd0JBYWhDO0FBRU0sTUFBTSwrQkFBK0IsR0FBRyxDQUM3QyxRQUFjLEVBQ2QsUUFBZ0IsRUFDUixFQUFFO0lBQ1YsSUFBSSxNQUFNLENBQUMsS0FBSyxDQUFDLFFBQVEsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxFQUFFLENBQUM7UUFDckMsTUFBTSxJQUFJLEtBQUssQ0FBQyxxQ0FBcUMsQ0FBQyxDQUFBO0lBQ3hELENBQUM7SUFFRCxNQUFNLElBQUksR0FBRyxJQUFJLElBQUksQ0FBQyxjQUFjLENBQUMsSUFBSSxFQUFFO1FBQ3pDLFFBQVE7UUFDUixJQUFJLEVBQUUsU0FBUztLQUNoQixDQUFDO1NBQ0MsYUFBYSxDQUFDLFFBQVEsQ0FBQztTQUN2QixJQUFJLENBQUMsQ0FBQyxJQUFJLEVBQUUsRUFBRSxDQUFDLElBQUksQ0FBQyxJQUFJLEtBQUssTUFBTSxDQUFDLEVBQUUsS0FBSyxDQUFBO0lBQzlDLE1BQU0sVUFBVSxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQTtJQUMvQixJQUFJLENBQUMsTUFBTSxDQUFDLFNBQVMsQ0FBQyxVQUFVLENBQUMsSUFBSSxVQUFVLElBQUksQ0FBQyxFQUFFLENBQUM7UUFDckQsTUFBTSxJQUFJLEtBQUssQ0FBQyx3REFBd0QsQ0FBQyxDQUFBO0lBQzNFLENBQUM7SUFFRCxPQUFPLFVBQVUsQ0FBQTtBQUNuQixDQUFDLENBQUE7QUFwQlksUUFBQSwrQkFBK0IsbUNBb0IzQyJ9

package/.medusa/server/src/modules/documents/domain/document-resolution.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canDeleteReplacedArtifact = exports.isCancellationResolutionReady = exports.resolveRefundCommunicationOwner = exports.selectShipmentInvoiceCandidate = exports.canonicalizeRefundIds = void 0;
+const canonicalizeRefundIds = (refundIds) => [...new Set(refundIds.map((id) => id.trim()).filter(Boolean))].sort((a, b) => a.localeCompare(b));
+exports.canonicalizeRefundIds = canonicalizeRefundIds;
+const selectShipmentInvoiceCandidate = (assignments) => [...assignments]
+    .sort((left, right) => left.created_at.getTime() - right.created_at.getTime() ||
+    left.fulfillment_id.localeCompare(right.fulfillment_id))[0]?.fulfillment_id ?? null;
+exports.selectShipmentInvoiceCandidate = selectShipmentInvoiceCandidate;
+const resolveRefundCommunicationOwner = (input) => input.order_canceled || input.cancellation_resolution_exists
+    ? "cancellation"
+    : "standalone";
+exports.resolveRefundCommunicationOwner = resolveRefundCommunicationOwner;
+const isCancellationResolutionReady = (expectedRefundIds, resolutions) => {
+    const stateByRefund = new Map(resolutions.map((resolution) => [resolution.refund_id, resolution.state]));
+    return (0, exports.canonicalizeRefundIds)(expectedRefundIds).every((refundId) => {
+        const state = stateByRefund.get(refundId);
+        return state === "ready" || state === "not_applicable";
+    });
+};
+exports.isCancellationResolutionReady = isCancellationResolutionReady;
+const canDeleteReplacedArtifact = (artifact) => artifact?.communication_locked === false;
+exports.canDeleteReplacedArtifact = canDeleteReplacedArtifact;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG9jdW1lbnQtcmVzb2x1dGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy9tb2R1bGVzL2RvY3VtZW50cy9kb21haW4vZG9jdW1lbnQtcmVzb2x1dGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFLTyxNQUFNLHFCQUFxQixHQUFHLENBQUMsU0FBNEIsRUFBWSxFQUFFLENBQzlFLENBQUMsR0FBRyxJQUFJLEdBQUcsQ0FBQyxTQUFTLENBQUMsR0FBRyxDQUFDLENBQUMsRUFBRSxFQUFFLEVBQUUsQ0FBQyxFQUFFLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUMzRSxDQUFDLENBQUMsYUFBYSxDQUFDLENBQUMsQ0FBQyxDQUNuQixDQUFBO0FBSFUsUUFBQSxxQkFBcUIseUJBRy9CO0FBRUksTUFBTSw4QkFBOEIsR0FBRyxDQUM1QyxXQUFvRSxFQUNyRCxFQUFFLENBQ2pCLENBQUMsR0FBRyxXQUFXLENBQUM7S0FDYixJQUFJLENBQ0gsQ0FBQyxJQUFJLEVBQUUsS0FBSyxFQUFFLEVBQUUsQ0FDZCxJQUFJLENBQUMsVUFBVSxDQUFDLE9BQU8sRUFBRSxHQUFHLEtBQUssQ0FBQyxVQUFVLENBQUMsT0FBTyxFQUFFO0lBQ3RELElBQUksQ0FBQyxjQUFjLENBQUMsYUFBYSxDQUFDLEtBQUssQ0FBQyxjQUFjLENBQUMsQ0FDMUQsQ0FBQyxDQUFDLENBQUMsRUFBRSxjQUFjLElBQUksSUFBSSxDQUFBO0FBUm5CLFFBQUEsOEJBQThCLGtDQVFYO0FBRXpCLE1BQU0sK0JBQStCLEdBQUcsQ0FBQyxLQUcvQyxFQUE0QixFQUFFLENBQzdCLEtBQUssQ0FBQyxjQUFjLElBQUksS0FBSyxDQUFDLDhCQUE4QjtJQUMxRCxDQUFDLENBQUMsY0FBYztJQUNoQixDQUFDLENBQUMsWUFBWSxDQUFBO0FBTkwsUUFBQSwrQkFBK0IsbUNBTTFCO0FBRVgsTUFBTSw2QkFBNkIsR0FBRyxDQUMzQyxpQkFBb0MsRUFDcEMsV0FHRyxFQUNNLEVBQUU7SUFDWCxNQUFNLGFBQWEsR0FBRyxJQUFJLEdBQUcsQ0FDM0IsV0FBVyxDQUFDLEdBQUcsQ0FBQyxDQUFDLFVBQVUsRUFBRSxFQUFFLENBQUMsQ0FBQyxVQUFVLENBQUMsU0FBUyxFQUFFLFVBQVUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUMxRSxDQUFBO0lBRUQsT0FBTyxJQUFBLDZCQUFxQixFQUFDLGlCQUFpQixDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsUUFBUSxFQUFFLEVBQUU7UUFDakUsTUFBTSxLQUFLLEdBQUcsYUFBYSxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsQ0FBQTtRQUN6QyxPQUFPLEtBQUssS0FBSyxPQUFPLElBQUksS0FBSyxLQUFLLGdCQUFnQixDQUFBO0lBQ3hELENBQUMsQ0FBQyxDQUFBO0FBQ0osQ0FBQyxDQUFBO0FBZlksUUFBQSw2QkFBNkIsaUNBZXpDO0FBRU0sTUFBTSx5QkFBeUIsR0FBRyxDQUN2QyxRQUFrRCxFQUN6QyxFQUFFLENBQUMsUUFBUSxFQUFFLG9CQUFvQixLQUFLLEtBQUssQ0FBQTtBQUZ6QyxRQUFBLHlCQUF5Qiw2QkFFZ0IifQ==

package/.medusa/server/src/modules/documents/domain/issuance-rules.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canCustomerAccessDocument = exports.mapBatchAllocationsByLineItem = exports.isInvoiceIssuableAfterShipment = void 0;
+/**
+ * The single invoice is deliberately deferred until Medusa has registered the
+ * final shipment. `partially_shipped` must never produce a partial invoice.
+ */
+const isInvoiceIssuableAfterShipment = (order) => !order.canceled_at &&
+    (order.fulfillment_status === "shipped" ||
+        order.fulfillment_status === "delivered");
+exports.isInvoiceIssuableAfterShipment = isInvoiceIssuableAfterShipment;
+/**
+ * Maps immutable FEFO withdrawals to their order line. Sorting makes the
+ * template input deterministic even when a provider returns rows in a
+ * different order.
+ */
+const mapBatchAllocationsByLineItem = (allocations) => {
+    const byLineItem = {};
+    for (const allocation of allocations) {
+        const { line_item_id: lineItemId, ...documentAllocation } = allocation;
+        const lineAllocations = byLineItem[lineItemId] ?? [];
+        lineAllocations.push(documentAllocation);
+        byLineItem[lineItemId] = lineAllocations;
+    }
+    for (const lineAllocations of Object.values(byLineItem)) {
+        lineAllocations.sort((left, right) => left.batch_id.localeCompare(right.batch_id));
+    }
+    return byLineItem;
+};
+exports.mapBatchAllocationsByLineItem = mapBatchAllocationsByLineItem;
+/**
+ * Guest documents intentionally have no storefront owner and are never
+ * retrievable over Store.
+ */
+const canCustomerAccessDocument = (documentCustomerId, actorCustomerId) => typeof documentCustomerId === "string" && documentCustomerId === actorCustomerId;
+exports.canCustomerAccessDocument = canCustomerAccessDocument;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaXNzdWFuY2UtcnVsZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi9zcmMvbW9kdWxlcy9kb2N1bWVudHMvZG9tYWluL2lzc3VhbmNlLXJ1bGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQWVBOzs7R0FHRztBQUNJLE1BQU0sOEJBQThCLEdBQUcsQ0FDNUMsS0FBZ0MsRUFDdkIsRUFBRSxDQUNYLENBQUMsS0FBSyxDQUFDLFdBQVc7SUFDbEIsQ0FBQyxLQUFLLENBQUMsa0JBQWtCLEtBQUssU0FBUztRQUNyQyxLQUFLLENBQUMsa0JBQWtCLEtBQUssV0FBVyxDQUFDLENBQUE7QUFMaEMsUUFBQSw4QkFBOEIsa0NBS0U7QUFFN0M7Ozs7R0FJRztBQUNJLE1BQU0sNkJBQTZCLEdBQUcsQ0FDM0MsV0FBc0MsRUFDSyxFQUFFO0lBQzdDLE1BQU0sVUFBVSxHQUE4QyxFQUFFLENBQUE7SUFFaEUsS0FBSyxNQUFNLFVBQVUsSUFBSSxXQUFXLEVBQUUsQ0FBQztRQUNyQyxNQUFNLEVBQUUsWUFBWSxFQUFFLFVBQVUsRUFBRSxHQUFHLGtCQUFrQixFQUFFLEdBQUcsVUFBVSxDQUFBO1FBQ3RFLE1BQU0sZUFBZSxHQUFHLFVBQVUsQ0FBQyxVQUFVLENBQUMsSUFBSSxFQUFFLENBQUE7UUFDcEQsZUFBZSxDQUFDLElBQUksQ0FBQyxrQkFBa0IsQ0FBQyxDQUFBO1FBQ3hDLFVBQVUsQ0FBQyxVQUFVLENBQUMsR0FBRyxlQUFlLENBQUE7SUFDMUMsQ0FBQztJQUVELEtBQUssTUFBTSxlQUFlLElBQUksTUFBTSxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFDO1FBQ3hELGVBQWUsQ0FBQyxJQUFJLENBQUMsQ0FBQyxJQUFJLEVBQUUsS0FBSyxFQUFFLEVBQUUsQ0FDbkMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUFDLFFBQVEsQ0FBQyxDQUM1QyxDQUFBO0lBQ0gsQ0FBQztJQUVELE9BQU8sVUFBVSxDQUFBO0FBQ25CLENBQUMsQ0FBQTtBQW5CWSxRQUFBLDZCQUE2QixpQ0FtQnpDO0FBRUQ7OztHQUdHO0FBQ0ksTUFBTSx5QkFBeUIsR0FBRyxDQUN2QyxrQkFBNkMsRUFDN0MsZUFBdUIsRUFDZCxFQUFFLENBQ1gsT0FBTyxrQkFBa0IsS0FBSyxRQUFRLElBQUksa0JBQWtCLEtBQUssZUFBZSxDQUFBO0FBSnJFLFFBQUEseUJBQXlCLDZCQUk0QyJ9

package/.medusa/server/src/modules/documents/domain/merchant.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toDocumentMerchant = exports.merchantOptionToFallback = exports.MERCHANT_VAT_PLACEHOLDER = exports.DOCUMENT_MERCHANT_REQUIRED_FIELDS = void 0;
+/** Without these a financial document or packing list has no legal sender. */
+exports.DOCUMENT_MERCHANT_REQUIRED_FIELDS = [
+    "legal_name",
+    "address_line1",
+    "postal_code",
+    "city",
+    "country_code",
+];
+/** Development placeholder UID: never printed on a document. */
+exports.MERCHANT_VAT_PLACEHOLDER = "ATU00000000";
+const text = (value) => {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+};
+const vatNumber = (value) => {
+    const normalized = text(value);
+    return normalized &&
+        normalized.replace(/\s+/g, "").toUpperCase() === exports.MERCHANT_VAT_PLACEHOLDER
+        ? null
+        : normalized;
+};
+/**
+ * The plugin's `merchant` option as a per-field fallback for the shop master
+ * data. Empty values are left out so they never shadow a declared default.
+ */
+const merchantOptionToFallback = (option) => {
+    if (!option) {
+        return {};
+    }
+    const address = option.registeredAddress;
+    const entries = [
+        ["legal_name", option.legalName],
+        ["address_line1", address?.address1],
+        ["address_line2", address?.address2],
+        ["postal_code", address?.postalCode],
+        ["city", address?.city],
+        [
+            "country_code",
+            text(address?.countryCode ?? option.countryCode)?.toLowerCase(),
+        ],
+        ["vat_number", option.vatNumber],
+    ];
+    const fallback = {};
+    for (const [key, value] of entries) {
+        const normalized = text(value);
+        if (normalized) {
+            fallback[key] = normalized;
+        }
+    }
+    return fallback;
+};
+exports.merchantOptionToFallback = merchantOptionToFallback;
+/** Maps resolved shop master data to the render input's `merchant`. */
+const toDocumentMerchant = (values) => {
+    const missing = exports.DOCUMENT_MERCHANT_REQUIRED_FIELDS.filter((key) => !text(values[key]));
+    if (missing.length > 0) {
+        return { merchant: null, missing };
+    }
+    return {
+        merchant: {
+            legal_name: text(values.legal_name),
+            address_line1: text(values.address_line1),
+            address_line2: text(values.address_line2),
+            postal_code: text(values.postal_code),
+            city: text(values.city),
+            country_code: text(values.country_code).toLowerCase(),
+            vat_number: vatNumber(values.vat_number),
+            email: text(values.email),
+            phone: text(values.phone),
+            website: text(values.website),
+            iban: text(values.iban),
+            bic: text(values.bic),
+            company_register_number: text(values.company_register_number),
+            company_register_court: text(values.company_register_court),
+        },
+        missing: [],
+    };
+};
+exports.toDocumentMerchant = toDocumentMerchant;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVyY2hhbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi9zcmMvbW9kdWxlcy9kb2N1bWVudHMvZG9tYWluL21lcmNoYW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQVVBLDhFQUE4RTtBQUNqRSxRQUFBLGlDQUFpQyxHQUFHO0lBQy9DLFlBQVk7SUFDWixlQUFlO0lBQ2YsYUFBYTtJQUNiLE1BQU07SUFDTixjQUFjO0NBQ21DLENBQUE7QUFFbkQsZ0VBQWdFO0FBQ25ELFFBQUEsd0JBQXdCLEdBQUcsYUFBYSxDQUFBO0FBRXJELE1BQU0sSUFBSSxHQUFHLENBQUMsS0FBYyxFQUFpQixFQUFFO0lBQzdDLElBQUksT0FBTyxLQUFLLEtBQUssUUFBUSxFQUFFLENBQUM7UUFDOUIsT0FBTyxJQUFJLENBQUE7SUFDYixDQUFDO0lBQ0QsTUFBTSxPQUFPLEdBQUcsS0FBSyxDQUFDLElBQUksRUFBRSxDQUFBO0lBQzVCLE9BQU8sT0FBTyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQTtBQUNqQyxDQUFDLENBQUE7QUFFRCxNQUFNLFNBQVMsR0FBRyxDQUFDLEtBQWMsRUFBaUIsRUFBRTtJQUNsRCxNQUFNLFVBQVUsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUE7SUFDOUIsT0FBTyxVQUFVO1FBQ2YsVUFBVSxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDLENBQUMsV0FBVyxFQUFFLEtBQUssZ0NBQXdCO1FBQ3pFLENBQUMsQ0FBQyxJQUFJO1FBQ04sQ0FBQyxDQUFDLFVBQVUsQ0FBQTtBQUNoQixDQUFDLENBQUE7QUFFRDs7O0dBR0c7QUFDSSxNQUFNLHdCQUF3QixHQUFHLENBQ3RDLE1BQTBDLEVBQ2xCLEVBQUU7SUFDMUIsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO1FBQ1osT0FBTyxFQUFFLENBQUE7SUFDWCxDQUFDO0lBQ0QsTUFBTSxPQUFPLEdB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

package/.medusa/server/src/modules/documents/domain/options.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDocumentPluginOptions = exports.DEFAULT_NUMBERING_TIME_ZONE = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const html_factory_1 = require("../../../documents/templates/html-factory");
+const merchant_1 = require("./merchant");
+/** Used when the `documents.numbering.timeZone` option is not given. */
+exports.DEFAULT_NUMBERING_TIME_ZONE = "Europe/Vienna";
+const resolveDocumentPluginOptions = (options) => {
+    const configuredTimeZone = options?.numbering?.timeZone;
+    const timeZone = configuredTimeZone === undefined
+        ? exports.DEFAULT_NUMBERING_TIME_ZONE
+        : configuredTimeZone.trim();
+    if (!timeZone) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "The documents plugin requires a numbering time zone.");
+    }
+    try {
+        new Intl.DateTimeFormat("en", { timeZone }).format();
+    }
+    catch {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `The documents numbering time zone '${timeZone}' is invalid.`);
+    }
+    if (options?.htmlFactory !== undefined &&
+        typeof options.htmlFactory !== "function") {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "The documents 'htmlFactory' option must be a function.");
+    }
+    if (options?.merchant !== undefined &&
+        (typeof options.merchant !== "object" || options.merchant === null)) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "The documents 'merchant' option must be an object.");
+    }
+    const executablePath = options?.pdf?.executablePath?.trim() || "google-chrome";
+    return {
+        htmlFactory: options?.htmlFactory ?? (0, html_factory_1.createDefaultDocumentHtmlFactory)({ timeZone }),
+        merchantFallback: (0, merchant_1.merchantOptionToFallback)(options?.merchant),
+        numbering: { timeZone },
+        pdf: { executablePath },
+    };
+};
+exports.resolveDocumentPluginOptions = resolveDocumentPluginOptions;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3B0aW9ucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy9tb2R1bGVzL2RvY3VtZW50cy9kb21haW4vb3B0aW9ucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxxREFBdUQ7QUFFdkQsNEVBQTRGO0FBTTVGLHlDQUFrRjtBQUVsRix3RUFBd0U7QUFDM0QsUUFBQSwyQkFBMkIsR0FBRyxlQUFlLENBQUE7QUFnQ25ELE1BQU0sNEJBQTRCLEdBQUcsQ0FDMUMsT0FBMEMsRUFDWCxFQUFFO0lBQ2pDLE1BQU0sa0JBQWtCLEdBQUcsT0FBTyxFQUFFLFNBQVMsRUFBRSxRQUFRLENBQUE7SUFDdkQsTUFBTSxRQUFRLEdBQ1osa0JBQWtCLEtBQUssU0FBUztRQUM5QixDQUFDLENBQUMsbUNBQTJCO1FBQzdCLENBQUMsQ0FBQyxrQkFBa0IsQ0FBQyxJQUFJLEVBQUUsQ0FBQTtJQUMvQixJQUFJLENBQUMsUUFBUSxFQUFFLENBQUM7UUFDZCxNQUFNLElBQUksbUJBQVcsQ0FDbkIsbUJBQVcsQ0FBQyxLQUFLLENBQUMsWUFBWSxFQUM5QixzREFBc0QsQ0FDdkQsQ0FBQTtJQUNILENBQUM7SUFDRCxJQUFJLENBQUM7UUFDSCxJQUFJLElBQUksQ0FBQyxjQUFjLENBQUMsSUFBSSxFQUFFLEVBQUUsUUFBUSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQTtJQUN0RCxDQUFDO0lBQUMsTUFBTSxDQUFDO1FBQ1AsTUFBTSxJQUFJLG1CQUFXLENBQ25CLG1CQUFXLENBQUMsS0FBSyxDQUFDLFlBQVksRUFDOUIsc0NBQXNDLFFBQVEsZUFBZSxDQUM5RCxDQUFBO0lBQ0gsQ0FBQztJQUVELElBQ0UsT0FBTyxFQUFFLFdBQVcsS0FBSyxTQUFTO1FBQ2xDLE9BQU8sT0FBTyxDQUFDLFdBQVcsS0FBSyxVQUFVLEVBQ3pDLENBQUM7UUFDRCxNQUFNLElBQUksbUJBQVcsQ0FDbkIsbUJBQVcsQ0FBQyxLQUFLLENBQUMsWUFBWSxFQUM5Qix3REFBd0QsQ0FDekQsQ0FBQTtJQUNILENBQUM7SUFFRCxJQUNFLE9BQU8sRUFBRSxRQUFRLEtBQUssU0FBUztRQUMvQixDQUFDLE9BQU8sT0FBTyxDQUFDLFFBQVEsS0FBSyxRQUFRLElBQUksT0FBTyxDQUFDLFFBQVEsS0FBSyxJQUFJLENBQUMsRUFDbkUsQ0FBQztRQUNELE1BQU0sSUFBSSxtQkFBVyxDQUNuQixtQkFBVyxDQUFDLEtBQUssQ0FBQyxZQUFZLEVBQzlCLG9EQUFvRCxDQUNyRCxDQUFBO0lBQ0gsQ0FBQztJQUVELE1BQU0sY0FBYyxHQUFHLE9BQU8sRUFBRSxHQUFHLEVBQUUsY0FBYyxFQUFFLElBQUksRUFBRSxJQUFJLGVBQWUsQ0FBQTtJQUM5RSxPQUFPO1FBQ0wsV0FBVyxFQUNULE9BQU8sRUFBRSxXQUFXLElBQUksSUFBQSwrQ0FBZ0MsRUFBQyxFQUFFLFFBQVEsRUFBRSxDQUFDO1FBQ3hFLGdCQUFnQixFQUFFLElBQUEsbUNBQXdCLEVBQUMsT0FBTyxFQUFFLFFBQVEsQ0FBQztRQUM3RCxTQUFTLEVBQUUsRUFBRSxRQUFRLEVBQUU7UUFDdkIsR0FBRyxFQUFFLEVBQUUsY0FBYyxFQUFFO0tBQ3hCLENBQUE7QUFDSCxDQUFDLENBQUE7QUFuRFksUUFBQSw0QkFBNEIsZ0NBbUR4QyJ9

package/.medusa/server/src/modules/documents/domain/packing-list.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPackingListFulfillmentEligible = exports.formatPackingListNumber = exports.createPackingListLines = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const requireString = (value, field) => {
+    if (!value.trim()) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, `Packing-list field '${field}' is empty.`);
+    }
+    return value;
+};
+const requireQuantity = (value, field) => {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, `Packing-list field '${field}' must be a positive integer.`);
+    }
+    return value;
+};
+const requireIsoDate = (value, field) => {
+    const date = new Date(requireString(value, field));
+    if (Number.isNaN(date.getTime())) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, `Packing-list field '${field}' must be a valid date.`);
+    }
+    return date.toISOString();
+};
+const groupKey = (lineItemId, inventoryItemId) => `${lineItemId}\u0000${inventoryItemId ?? ""}`;
+/**
+ * Fulfillment items already contain concrete inventory quantities, including
+ * variant inventory multipliers. Grouping on the same identity used by Batch
+ * Management keeps kits and partial fulfillments independent.
+ */
+const createPackingListLines = (input) => {
+    const linesByKey = new Map();
+    for (const item of input.fulfillment_items) {
+        const lineItemId = requireString(item.line_item_id, "line_item_id");
+        const inventoryItemId = item.inventory_item_id
+            ? requireString(item.inventory_item_id, "inventory_item_id")
+            : null;
+        const key = groupKey(lineItemId, inventoryItemId);
+        const existing = linesByKey.get(key);
+        if (existing) {
+            if (existing.title !== item.title || existing.sku !== item.sku) {
+                throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, `Fulfillment item group ${lineItemId} has inconsistent item details.`);
+            }
+            existing.quantity += requireQuantity(item.quantity, "quantity");
+            continue;
+        }
+        linesByKey.set(key, {
+            line_item_id: lineItemId,
+            inventory_item_id: inventoryItemId,
+            title: requireString(item.title, "title"),
+            sku: item.sku?.trim() || null,
+            quantity: requireQuantity(item.quantity, "quantity"),
+            batch_allocations: [],
+        });
+    }
+    for (const allocation of input.batch_allocations) {
+        const key = groupKey(requireString(allocation.line_item_id, "batch.line_item_id"), requireString(allocation.inventory_item_id, "batch.inventory_item_id"));
+        const line = linesByKey.get(key);
+        if (!line) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, "A batch allocation does not belong to a fulfillment item.");
+        }
+        line.batch_allocations.push({
+            batch_id: requireString(allocation.batch_id, "batch.batch_id"),
+            lot_number: requireString(allocation.lot_number, "batch.lot_number"),
+            expiry_date: requireIsoDate(allocation.expiry_date, "batch.expiry_date"),
+            quantity: requireQuantity(allocation.quantity, "batch.quantity"),
+        });
+    }
+    const lines = [...linesByKey.values()];
+    for (const line of lines) {
+        line.batch_allocations.sort((left, right) => left.lot_number.localeCompare(right.lot_number) ||
+            left.batch_id.localeCompare(right.batch_id));
+        if (!input.batch_management_enabled || !line.inventory_item_id) {
+            continue;
+        }
+        const allocated = line.batch_allocations.reduce((sum, allocation) => sum + allocation.quantity, 0);
+        if (allocated !== line.quantity) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, `Batch allocations for fulfillment item ${line.line_item_id}/${line.inventory_item_id} total ${allocated}, expected ${line.quantity}.`);
+        }
+    }
+    return lines.sort((left, right) => left.title.localeCompare(right.title) ||
+        left.line_item_id.localeCompare(right.line_item_id) ||
+        (left.inventory_item_id ?? "").localeCompare(right.inventory_item_id ?? ""));
+};
+exports.createPackingListLines = createPackingListLines;
+const formatPackingListNumber = (input) => `PL-${input.order_display_id ?? input.order_id}-${input.fulfillment_id}`;
+exports.formatPackingListNumber = formatPackingListNumber;
+const isPackingListFulfillmentEligible = (input) => input.requires_shipping !== false &&
+    (input.canceled_at === null || input.canceled_at === undefined);
+exports.isPackingListFulfillmentEligible = isPackingListFulfillmentEligible;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGFja2luZy1saXN0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL21vZHVsZXMvZG9jdW1lbnRzL2RvbWFpbi9wYWNraW5nLWxpc3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEscURBQXVEO0FBb0J2RCxNQUFNLGFBQWEsR0FBRyxDQUFDLEtBQWEsRUFBRSxLQUFhLEVBQVUsRUFBRTtJQUM3RCxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksRUFBRSxFQUFFLENBQUM7UUFDbEIsTUFBTSxJQUFJLG1CQUFXLENBQ25CLG1CQUFXLENBQUMsS0FBSyxDQUFDLGdCQUFnQixFQUNsQyx1QkFBdUIsS0FBSyxhQUFhLENBQzFDLENBQUE7SUFDSCxDQUFDO0lBRUQsT0FBTyxLQUFLLENBQUE7QUFDZCxDQUFDLENBQUE7QUFFRCxNQUFNLGVBQWUsR0FBRyxDQUFDLEtBQWEsRUFBRSxLQUFhLEVBQVUsRUFBRTtJQUMvRCxJQUFJLENBQUMsTUFBTSxDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsSUFBSSxLQUFLLElBQUksQ0FBQyxFQUFFLENBQUM7UUFDM0MsTUFBTSxJQUFJLG1CQUFXLENBQ25CLG1CQUFXLENBQUMsS0FBSyxDQUFDLGdCQUFnQixFQUNsQyx1QkFBdUIsS0FBSywrQkFBK0IsQ0FDNUQsQ0FBQTtJQUNILENBQUM7SUFFRCxPQUFPLEtBQUssQ0FBQTtBQUNkLENBQUMsQ0FBQTtBQUVELE1BQU0sY0FBYyxHQUFHLENBQUMsS0FBYSxFQUFFLEtBQWEsRUFBVSxFQUFFO0lBQzlELE1BQU0sSUFBSSxHQUFHLElBQUksSUFBSSxDQUFDLGFBQWEsQ0FBQyxLQUFLLEVBQUUsS0FBSyxDQUFDLENBQUMsQ0FBQTtJQUNsRCxJQUFJLE1BQU0sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLE9BQU8sRUFBRSxDQUFDLEVBQUUsQ0FBQztRQUNqQyxNQUFNLElBQUksbUJBQVcsQ0FDbkIsbUJBQVcsQ0FBQyxLQUFLLENBQUMsZ0JBQWdCLEVBQ2xDLHVCQUF1QixLQUFLLHlCQUF5QixDQUN0RCxDQUFBO0lBQ0gsQ0FBQztJQUVELE9BQU8sSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFBO0FBQzNCLENBQUMsQ0FBQTtBQUVELE1BQU0sUUFBUSxHQUFHLENBQUMsVUFBa0IsRUFBRSxlQUE4QixFQUFVLEVBQUUsQ0FDOUUsR0FBRyxVQUFVLFNBQVMsZUFBZSxJQUFJLEVBQUUsRUFBRSxDQUFBO0FBRS9DOzs7O0dBSUc7QUFDSSxNQUFNLHNCQUFzQixHQUFHLENBQUMsS0FJdEMsRUFBNkIsRUFBRTtJQUM5QixNQUFNLFVBQVUsR0FBRyxJQUFJLEdBQUcsRUFBbUMsQ0FBQTtJQUU3RCxLQUFLLE1BQU0sSUFBSSxJQUFJLEtBQUssQ0FBQyxpQkFBaUIsRUFBRSxDQUFDO1FBQzNDLE1BQU0sVUFBVSxHQUFHLGFBQWEsQ0FBQyxJQUFJLENBQUMsWUFBWSxFQUFFLGNBQWMsQ0FBQyxDQUFBO1FBQ25FLE1BQU0sZUFBZSxHQUFHLElBQUksQ0FBQyxpQkFBaUI7WUFDNUMsQ0FBQyxDQUFDLGFBQWEsQ0FBQyxJQUFJLENBQUMsaUJBQWlCLEVBQUUsbUJBQW1CLENBQUM7WUFDNUQsQ0FBQyxDQUFDLElBQUksQ0FBQTtRQUNSLE1BQU0sR0FBRyxHQUFHLFFBQVEsQ0FBQyxVQUFVLEVBQUUsZUFBZSxDQUFDLENBQUE7UUFDakQsTUFBTSxRQUFRLEdBQUcsVUFBVSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQTtRQUVwQyxJQUFJLFFBQVEsRUFBRSxDQUFDO1lBQ2IsSUFBSSxRQUFRLENBQUMsS0FBSyxLQUFLLElBQUksQ0FBQyxLQUFLLElBQUksUUFBUSxDQUFDLEdBQUcsS0FBSyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7Z0JBQy9ELE1BQU0sSUFBSSxtQkFBVyxDQUNuQixtQkFBVyxDQUFDLEtBQUssQ0FBQyxnQkFBZ0IsRUFDbEMsMEJBQTBCLFVBQVUsaUNBQWlDLENBQ3RFLENBQUE7WUFDSCxDQUFDO1lBQ0QsUUFBUSxDQUFDLFFBQVEsSUFBSSxlQUFlLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxVQUFVLENBQUMsQ0FBQTtZQUMvRCxTQUFRO1FBQ1YsQ0FBQztRQUVELFVBQVUsQ0FBQyxHQUFHLENBQUMsR0FBRyxFQUFFO1lBQ2xCLFlBQVksRUFBRSxVQUFVO1lBQ3hCLGlCQUFpQixFQUFFLGVBQWU7WUFDbEMsS0FBSyxFQUFFLGFBQWEsQ0FBQyxJQUFJLENBQUMsS0FBSyxFQUFFLE9BQU8sQ0FBQztZQUN6QyxHQUFHLEVBQUUsSUFBSSxDQUFDLEdBQUcsRUFBRSxJQUFJLEVBQUUsSUFBSSxJQUFJO1lBQzdCLFFBQVEsRUFBRSxlQUFlLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxVQUFVLENBQUM7WUFDcEQsaUJBQWlCLEVBQUUsRUFBRTtTQUN0QixDQUFDLENBQUE7SUFDSixDQUFDO0lBRUQsS0FBSyxNQUFNLFVBQVUsSUFBSSxLQUFLLENBQUMsaUJBQWlCLEVBQUUsQ0FBQztRQUNqRCxNQUFNLEdBQUcsR0FBRyxRQUFRLENBQ2xCLGFBQWEsQ0FBQyxVQUFVLENBQUMsWUFBWSxFQUFFLG9CQUFvQixDQUFDLEVBQzVELGFBQWEsQ0FBQyxVQUFVLENBQUMsaUJBQWlCLEVBQUUseUJBQXlCLENBQUMsQ0FDdkUsQ0FBQTtRQUNELE1BQU0sSUFBSSxHQUFHLFVBQVUsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUE7UUFDaEMsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO1lBQ1YsTUFBTSxJQUFJLG1CQUFXLENBQ25CLG1CQUFXLENBQUMsS0FBSyxDQUFDLGdCQUFnQixFQUNsQywyREFBMkQsQ0FDNUQsQ0FBQTtRQUNILENBQUM7UUFFRCxJQUFJLENBQUMsaUJBQWlCLENBQUMsSUFBSSxDQUFDO1lBQzFCLFFBQVEsRUFBRSxhQUFhLENBQUMsVUFBVSxDQUFDLFFBQVEsRUFBRSxnQkFBZ0IsQ0FBQztZQUM5RCxVQUFVLEVBQUUsYUFBYSxDQUFDLFVBQVUsQ0FBQyxVQUFVLEVBQUUsa0JBQWtCLENBQUM7WUFDcEUsV0FBVyxFQUFFLGNBQWMsQ0FBQyxVQUFVLENBQUMsV0FBVyxFQUFFLG1CQUFtQixDQUFDO1lBQ3hFLFFBQVEsRUFBRSxlQUFlLENBQUMsVUFBVSxDQUFDLFFBQVEsRUFBRSxnQkFBZ0IsQ0FBQztTQUNqRSxDQUFDLENBQUE7SUFDSixDQUFDO0lBRUQsTUFBTSxLQUFLLEdBQUcsQ0FBQyxHQUFHLFVBQVUsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFBO0lBQ3RDLEtBQUssTUFBTSxJQUFJLElBQUksS0FBSyxFQUFFLENBQUM7UUFDekIsSUFBSSxDQUFDLGlCQUFpQixDQUFDLElBQUksQ0FDekIsQ0FBQyxJQUFJLEVBQUUsS0FBSyxFQUFFLEVBQUUsQ0FDZCxJQUFJLENBQUMsVUFBVSxDQUFDLGFBQWEsQ0FBQyxLQUFLLENBQUMsVUFBVSxDQUFDO1lBQy9DLElBQUksQ0FBQyxRQUFRLENBQUMsYUFBYSxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsQ0FDOUMsQ0FBQTtRQUVELElBQUksQ0FBQyxLQUFLLENBQUMsd0JBQXdCLElBQUksQ0FBQyxJQUFJLENBQUMsaUJBQWlCLEVBQUUsQ0FBQztZQUMvRCxTQUFRO1FBQ1YsQ0FBQztRQUVELE1BQU0sU0FBUyxHQUFHLElBQUksQ0FBQyxpQkFBaUIsQ0FBQyxNQUFNLENBQzdDLENBQUMsR0FBRyxFQUFFLFVBQVUsRUFBRSxFQUFFLENBQUMsR0FBRyxHQUFHLFVBQVUsQ0FBQyxRQUFRLEVBQzlDLENBQUMsQ0FDRixDQUFBO1FBQ0QsSUFBSSxTQUFTLEtBQUssSUFBSSxDQUFDLFFBQVEsRUFBRSxDQUFDO1lBQ2hDLE1BQU0sSUFBSSxtQkFBVyxDQUNuQixtQkFBVyxDQUFDLEtBQUssQ0FBQyxnQkFBZ0IsRUFDbEMsMENBQTBDLElBQUksQ0FBQyxZQUFZLElBQUksSUFBSSxDQUFDLGlCQUFpQixVQUFVLFNBQVMsY0FBYyxJQUFJLENBQUMsUUFBUSxHQUFHLENBQ3ZJLENBQUE7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUVELE9BQU8sS0FBSyxDQUFDLElBQUksQ0FDZixDQUFDLElBQUksRUFBRSxLQUFLLEVBQUUsRUFBRSxDQUNkLElBQUksQ0FBQyxLQUFLLENBQUMsYUFBYSxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQUM7UUFDckMsSUFBSSxDQUFDLFlBQVksQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUFDLFlBQVksQ0FBQztRQUNuRCxDQUFDLElBQUksQ0FBQyxpQkFBaUIsSUFBSSxFQUFFLENBQUMsQ0FBQyxhQUFhLENBQzFDLEtBQUssQ0FBQyxpQkFBaUIsSUFBSSxFQUFFLENBQzlCLENBQ0osQ0FBQTtBQUNILENBQUMsQ0FBQTtBQXpGWSxRQUFBLHNCQUFzQiwwQkF5RmxDO0FBRU0sTUFBTSx1QkFBdUIsR0FBRyxDQUFDLEtBSXZDLEVBQVUsRUFBRSxDQUNYLE1BQU0sS0FBSyxDQUFDLGdCQUFnQixJQUFJLEtBQUssQ0FBQyxRQUFRLElBQUksS0FBSyxDQUFDLGNBQWMsRUFBRSxDQUFBO0FBTDdELFFBQUEsdUJBQXVCLDJCQUtzQztBQUVuRSxNQUFNLGdDQUFnQyxHQUFHLENBQUMsS0FJaEQsRUFBVyxFQUFFLENBQ1osS0FBSyxDQUFDLGlCQUFpQixLQUFLLEtBQUs7SUFDakMsQ0FBQyxLQUFLLENBQUMsV0FBVyxLQUFLLElBQUksSUFBSSxLQUFLLENBQUMsV0FBVyxLQUFLLFNBQVMsQ0FBQyxDQUFBO0FBTnBELFFBQUEsZ0NBQWdDLG9DQU1vQiJ9

package/.medusa/server/src/modules/documents/domain/snapshot-normalization.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeDocumentSnapshot = void 0;
+/** Adds fields introduced after older document snapshots were persisted. */
+const normalizeDocumentSnapshot = (snapshot) => ({
+    ...snapshot,
+    order: {
+        ...snapshot.order,
+        tax_compliance: snapshot.order.tax_compliance ?? null,
+    },
+    totals: {
+        ...snapshot.totals,
+        tax_breakdown: snapshot.totals.tax_breakdown ?? [],
+    },
+});
+exports.normalizeDocumentSnapshot = normalizeDocumentSnapshot;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic25hcHNob3Qtbm9ybWFsaXphdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy9tb2R1bGVzL2RvY3VtZW50cy9kb21haW4vc25hcHNob3Qtbm9ybWFsaXphdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFFQSw0RUFBNEU7QUFDckUsTUFBTSx5QkFBeUIsR0FBRyxDQUN2QyxRQUEwQixFQUNSLEVBQUUsQ0FBQyxDQUFDO0lBQ3RCLEdBQUcsUUFBUTtJQUNYLEtBQUssRUFBRTtRQUNMLEdBQUcsUUFBUSxDQUFDLEtBQUs7UUFDakIsY0FBYyxFQUFFLFFBQVEsQ0FBQyxLQUFLLENBQUMsY0FBYyxJQUFJLElBQUk7S0FDdEQ7SUFDRCxNQUFNLEVBQUU7UUFDTixHQUFHLFFBQVEsQ0FBQyxNQUFNO1FBQ2xCLGFBQWEsRUFBRSxRQUFRLENBQUMsTUFBTSxDQUFDLGFBQWEsSUFBSSxFQUFFO0tBQ25EO0NBQ0YsQ0FBQyxDQUFBO0FBWlcsUUFBQSx5QkFBeUIsNkJBWXBDIn0=

package/.medusa/server/src/modules/documents/domain/tax-breakdown.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.roundTaxBreakdown = exports.groupTaxLines = exports.getCurrencyDecimalPlaces = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const DEFAULT_CURRENCY_DECIMAL_PLACES = 2;
+const getCurrencyDecimalPlaces = (currencyCode) => utils_1.defaultCurrencies[currencyCode.toUpperCase()]?.decimal_digits ??
+    DEFAULT_CURRENCY_DECIMAL_PLACES;
+exports.getCurrencyDecimalPlaces = getCurrencyDecimalPlaces;
+/**
+ * Sums item and shipping tax lines per configured tax rate. Lines with the
+ * same name and percentage form one entry; first occurrence defines order.
+ */
+const groupTaxLines = (lines, currencyCode) => {
+    const groups = new Map();
+    for (const line of lines) {
+        const key = JSON.stringify([line.name, line.code, line.rate]);
+        const group = groups.get(key);
+        groups.set(key, {
+            name: line.name,
+            code: line.code,
+            rate: line.rate,
+            tax_total: {
+                amount: utils_1.MathBN.add(group?.tax_total.amount ?? 0, line.amount).toFixed(),
+                currency_code: currencyCode,
+            },
+        });
+    }
+    return [...groups.values()];
+};
+exports.groupTaxLines = groupTaxLines;
+/**
+ * Rounds every entry to the currency's minor unit and assigns the rounding
+ * residue to the largest entry, so the printed rows add up exactly to the
+ * printed tax total. A residue larger than the accumulated rounding error
+ * means the entries do not describe the total and is rejected.
+ */
+const roundTaxBreakdown = (entries, taxTotal) => {
+    if (entries.length === 0) {
+        return [];
+    }
+    const currencyCode = taxTotal.currency_code;
+    const decimalPlaces = (0, exports.getCurrencyDecimalPlaces)(currencyCode);
+    const target = utils_1.MathBN.convert(taxTotal.amount).decimalPlaces(decimalPlaces);
+    const rounded = entries.map((entry) => {
+        if (entry.tax_total.currency_code !== currencyCode) {
+            throw new Error("The tax breakdown contains mixed currencies.");
+        }
+        return utils_1.MathBN.convert(entry.tax_total.amount).decimalPlaces(decimalPlaces);
+    });
+    const residue = utils_1.MathBN.sub(target, utils_1.MathBN.sum(...rounded));
+    const minorUnit = utils_1.MathBN.convert(10).pow(-decimalPlaces);
+    if (utils_1.MathBN.gt(residue.abs(), utils_1.MathBN.mult(minorUnit, entries.length))) {
+        throw new Error("The tax breakdown does not match the tax total.");
+    }
+    const largestIndex = rounded.reduce((largest, amount, index) => utils_1.MathBN.gt(amount.abs(), rounded[largest].abs()) ? index : largest, 0);
+    rounded[largestIndex] = utils_1.MathBN.add(rounded[largestIndex], residue);
+    return entries.map((entry, index) => ({
+        ...entry,
+        tax_total: {
+            amount: rounded[index].toFixed(decimalPlaces),
+            currency_code: currencyCode,
+        },
+    }));
+};
+exports.roundTaxBreakdown = roundTaxBreakdown;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGF4LWJyZWFrZG93bi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy9tb2R1bGVzL2RvY3VtZW50cy9kb21haW4vdGF4LWJyZWFrZG93bi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxxREFBcUU7QUFPckUsTUFBTSwrQkFBK0IsR0FBRyxDQUFDLENBQUE7QUFFbEMsTUFBTSx3QkFBd0IsR0FBRyxDQUFDLFlBQW9CLEVBQVUsRUFBRSxDQUN2RSx5QkFBaUIsQ0FBQyxZQUFZLENBQUMsV0FBVyxFQUFFLENBQUMsRUFBRSxjQUFjO0lBQzdELCtCQUErQixDQUFBO0FBRnBCLFFBQUEsd0JBQXdCLDRCQUVKO0FBU2pDOzs7R0FHRztBQUNJLE1BQU0sYUFBYSxHQUFHLENBQzNCLEtBQXNCLEVBQ3RCLFlBQW9CLEVBQ1MsRUFBRTtJQUMvQixNQUFNLE1BQU0sR0FBRyxJQUFJLEdBQUcsRUFBcUMsQ0FBQTtJQUMzRCxLQUFLLE1BQU0sSUFBSSxJQUFJLEtBQUssRUFBRSxDQUFDO1FBQ3pCLE1BQU0sR0FBRyxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxJQUFJLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUE7UUFDN0QsTUFBTSxLQUFLLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQTtRQUM3QixNQUFNLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRTtZQUNkLElBQUksRUFBRSxJQUFJLENBQUMsSUFBSTtZQUNmLElBQUksRUFBRSxJQUFJLENBQUMsSUFBSTtZQUNmLElBQUksRUFBRSxJQUFJLENBQUMsSUFBSTtZQUNmLFNBQVMsRUFBRTtnQkFDVCxNQUFNLEVBQUUsY0FBTSxDQUFDLEdBQUcsQ0FBQyxLQUFLLEVBQUUsU0FBUyxDQUFDLE1BQU0sSUFBSSxDQUFDLEVBQUUsSUFBSSxDQUFDLE1BQU0sQ0FB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

package/.medusa/server/src/modules/documents/index.js

@@ -0,0 +1,15 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOCUMENTS_MODULE = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const assert_private_file_storage_1 = __importDefault(require("./loaders/assert-private-file-storage"));
+const service_1 = __importDefault(require("./service"));
+exports.DOCUMENTS_MODULE = "documents";
+exports.default = (0, utils_1.Module)(exports.DOCUMENTS_MODULE, {
+    service: service_1.default,
+    loaders: [assert_private_file_storage_1.default],
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvbW9kdWxlcy9kb2N1bWVudHMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBQUEscURBQWtEO0FBRWxELHdHQUE0RTtBQUM1RSx3REFBOEM7QUFFakMsUUFBQSxnQkFBZ0IsR0FBRyxXQUFXLENBQUE7QUFFM0Msa0JBQWUsSUFBQSxjQUFNLEVBQUMsd0JBQWdCLEVBQUU7SUFDdEMsT0FBTyxFQUFFLGlCQUFzQjtJQUMvQixPQUFPLEVBQUUsQ0FBQyxxQ0FBd0IsQ0FBQztDQUNwQyxDQUFDLENBQUEifQ==

package/.medusa/server/src/modules/documents/loaders/assert-private-file-storage.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = warnAboutPublicFileStorage;
+const utils_1 = require("@medusajs/framework/utils");
+const private_file_storage_1 = require("../../../documents/utils/private-file-storage");
+/**
+ * Warns at startup when issued documents would be publicly downloadable. It
+ * does not refuse to boot: the documents module ships with the base plugin,
+ * so a shop on Medusa's default file storage must still start. Issuance itself
+ * refuses to write a document in that case (`assertPrivateFileStorage`).
+ */
+async function warnAboutPublicFileStorage({ container, }) {
+    const problem = (0, private_file_storage_1.findPubliclyServedPrivateFileStorage)(container.resolve(utils_1.ContainerRegistrationKeys.CONFIG_MODULE), process.cwd());
+    if (problem) {
+        container
+            .resolve(utils_1.ContainerRegistrationKeys.LOGGER)
+            .warn(`Documents cannot be issued: ${problem}`);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXNzZXJ0LXByaXZhdGUtZmlsZS1zdG9yYWdlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL21vZHVsZXMvZG9jdW1lbnRzL2xvYWRlcnMvYXNzZXJ0LXByaXZhdGUtZmlsZS1zdG9yYWdlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBV0EsNkNBWUM7QUF0QkQscURBQXFFO0FBRXJFLHdGQUFvRztBQUVwRzs7Ozs7R0FLRztBQUNZLEtBQUssVUFBVSwwQkFBMEIsQ0FBQyxFQUN2RCxTQUFTLEdBQ0s7SUFDZCxNQUFNLE9BQU8sR0FBRyxJQUFBLDJEQUFvQyxFQUNsRCxTQUFTLENBQUMsT0FBTyxDQUFDLGlDQUF5QixDQUFDLGFBQWEsQ0FBQyxFQUMxRCxPQUFPLENBQUMsR0FBRyxFQUFFLENBQ2QsQ0FBQTtJQUNELElBQUksT0FBTyxFQUFFLENBQUM7UUFDWixTQUFTO2FBQ04sT0FBTyxDQUFDLGlDQUF5QixDQUFDLE1BQU0sQ0FBQzthQUN6QyxJQUFJLENBQUMsK0JBQStCLE9BQU8sRUFBRSxDQUFDLENBQUE7SUFDbkQsQ0FBQztBQUNILENBQUMifQ==