@hartl-services/medusa-base 1.0.0 → 1.1.0

package/.medusa/server/src/workflows/email/prepare-return-email.js

@@ -4,8 +4,61 @@ exports.prepareReturnEmailWorkflow = exports.prepareReturnEmail = void 0;
 const utils_1 = require("@medusajs/framework/utils");
 const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
 const business_keys_1 = require("../../email/domain/business-keys");
+const return_summary_1 = require("../../email/domain/return-summary");
+const load_email_shop_details_1 = require("../../email/rendering/load-email-shop-details");
 const email_1 = require("../../modules/email");
 const dispatch_email_message_1 = require("./dispatch-email-message");
+/**
+ * The snapshot must never block the return confirmation: a return that
+ * cannot be read or mapped is confirmed without it.
+ */
+const returnSummaryData = async (container, orderReturn) => {
+    try {
+        const query = container.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+        const { data: returns } = await query.graph({
+            entity: "return",
+            fields: [...return_summary_1.RETURN_SUMMARY_FIELDS],
+            filters: { id: orderReturn.id },
+        });
+        const { data: locations } = orderReturn.location_id
+            ? await query.graph({
+                entity: "stock_location",
+                fields: [...return_summary_1.RETURN_LOCATION_FIELDS],
+                filters: { id: orderReturn.location_id },
+            })
+            : { data: [] };
+        return {
+            summary: (0, return_summary_1.toReturnSummary)(returns[0], locations[0] ?? null, await (0, load_email_shop_details_1.loadEmailShopDetails)(container)),
+        };
+    }
+    catch {
+        container
+            .resolve(utils_1.ContainerRegistrationKeys.LOGGER)
+            .warn("Email: return summary unavailable; confirming without it.");
+        return {};
+    }
+};
+/**
+ * The snapshot must never block the return receipt: a return that cannot be
+ * read or mapped is confirmed without it.
+ */
+const returnReceivedSummaryData = async (container, returnId) => {
+    try {
+        const query = container.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+        const { data } = await query.graph({
+            entity: "return",
+            fields: [...return_summary_1.RETURN_RECEIVED_SUMMARY_FIELDS],
+            filters: { id: returnId },
+        });
+        return { summary: (0, return_summary_1.toReturnReceivedSummary)(data[0]) };
+    }
+    catch {
+        container
+            .resolve(utils_1.ContainerRegistrationKeys.LOGGER)
+            .warn("Email: received return summary unavailable; confirming without it.");
+        return {};
+    }
+};
 const prepareReturnEmail = async (container, input) => {
     const orders = container.resolve(utils_1.Modules.ORDER);
     const orderReturn = (await orders.retrieveReturn(input.return_id));
@@ -32,7 +85,11 @@ const prepareReturnEmail = async (container, input) => {
             ...requestedIdentity,
             recipient: order.email ?? null,
             fact: "requested",
-            template_data: { order_id: order.id, return_id: orderReturn.id },
+            template_data: {
+                order_id: order.id,
+                return_id: orderReturn.id,
+                ...(await returnSummaryData(container, orderReturn)),
+            },
         });
     }
     const receivedIdentity = {
@@ -53,7 +110,11 @@ const prepareReturnEmail = async (container, input) => {
             ...receivedIdentity,
             recipient: order.email ?? null,
             fact: "received",
-            template_data: { order_id: order.id, return_id: orderReturn.id },
+            template_data: {
+                order_id: order.id,
+                return_id: orderReturn.id,
+                ...(await returnReceivedSummaryData(container, orderReturn.id)),
+            },
         });
     }
     await (0, dispatch_email_message_1.dispatchEmailMessageWorkflow)(container).run({
@@ -72,4 +133,4 @@ const prepareReturnEmail = async (container, input) => {
 exports.prepareReturnEmail = prepareReturnEmail;
 const prepareReturnEmailStep = (0, workflows_sdk_1.createStep)("email-prepare-return", async (input, { container }) => new workflows_sdk_1.StepResponse(await (0, exports.prepareReturnEmail)(container, input)));
 exports.prepareReturnEmailWorkflow = (0, workflows_sdk_1.createWorkflow)("email-prepare-return", (input) => new workflows_sdk_1.WorkflowResponse(prepareReturnEmailStep(input)));
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJlcGFyZS1yZXR1cm4tZW1haWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvd29ya2Zsb3dzL2VtYWlsL3ByZXBhcmUtcmV0dXJuLWVtYWlsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUlBLHFEQUFpRTtBQUNqRSxxRUFLMkM7QUFFM0Msb0VBRzBDO0FBQzFDLCtDQUFtRDtBQUVuRCxxRUFBd0U7QUFxQmpFLE1BQU0sa0JBQWtCLEdBQUcsS0FBSyxFQUNyQyxTQUEwQixFQUMxQixLQUE4QixFQUNLLEVBQUU7SUFDckMsTUFBTSxNQUFNLEdBQUcsU0FBUyxDQUFDLE9BQU8sQ0FBc0IsZUFBTyxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQ3JFLE1BQU0sV0FBVyxHQUFHLENBQUMsTUFBTSxNQUFNLENBQUMsY0FBYyxDQUM5QyxLQUFLLENBQUMsU0FBUyxDQUNoQixDQUFpQixDQUFDO0lBQ25CLElBQUksV0FBVyxDQUFDLFFBQVEsS0FBSyxLQUFLLENBQUMsUUFBUSxFQUFFLENBQUM7UUFDNUMsTUFBTSxJQUFJLG1CQUFXLENBQ25CLG1CQUFXLENBQUMsS0FBSyxDQUFDLFlBQVksRUFDOUIsZ0RBQWdELENBQ2pELENBQUM7SUFDSixDQUFDO0lBQ0QsTUFBTSxLQUFLLEdBQUcsTUFBTSxNQUFNLENBQUMsYUFBYSxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUN6RCxNQUFNLEtBQUssR0FBRyxTQUFTLENBQUMsT0FBTyxDQUFxQixvQkFBWSxDQUFDLENBQUM7SUFDbEUsTUFBTSxlQUFlLEdBQ25CLFdBQVcsQ0FBQyxlQUFlLEtBQUssSUFBSSxDQUFDLENBQUMsQ0FBQyx3QkFBd0IsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDO0lBQ3pFLE1BQU0saUJBQWlCLEdBQUc7UUFDeEIsSUFBSSxFQUFFLHdCQUFpQztRQUN2QyxZQUFZLEVBQUUsSUFBQSwwQ0FBMEIsRUFBQyxXQUFXLENBQUMsRUFBRSxD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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJlcGFyZS1yZXR1cm4tZW1haWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvd29ya2Zsb3dzL2VtYWlsL3ByZXBhcmUtcmV0dXJuLWVtYWlsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUtBLHFEQUltQztBQUNuQyxxRUFLMkM7QUFFM0Msb0VBRzBDO0FBQzFDLHNFQU0yQztBQUMzQywyRkFBcUY7QUFFckYsK0NBQW1EO0FBRW5ELHFFQUF3RTtBQXNCeEU7OztHQUdHO0FBQ0gsTUFBTSxpQkFBaUIsR0FBRyxLQUFLLEVBQzdCLFNBQTBCLEVBQzFCLFdBQXlCLEVBQ2EsRUFBRTtJQUN4QyxJQUFJLENBQUM7UUFDSCxNQUFNLEtBQUssR0FBRyxTQUFTLENBQUMsT0FBTyxDQUFDLGlDQUF5QixDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQ2pFLE1BQU0sRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFLEdBQUcsTUFBTSxLQUFLLENBQUMsS0FBSyxDQUFDO1lBQzFDLE1BQU0sRUFBRSxRQUFRO1lBQ2hCLE1BQU0sRUFBRSxDQUFDLEdBQUcsc0NBQXFCLENBQUM7WUFDbEMsT0FBTyxFQUFFLEVBQUUsRUFBRSxFQUFFLFdBQVcsQ0FBQyxFQUFFLEVBQUU7U0FDaEMsQ0FBQyxDQUFDO1FBQ0gsTUFBTSxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsR0FBRyxXQUFXLENBQUMsV0FBVztZQUNqRCxDQUFDLENBQUMsTUFBTSxLQUFLLENBQUMsS0FBSyxDQUFDO2dCQUNoQixNQUFNLEVBQUUsZ0JBQWdCO2dCQUN4QixNQUFNLEVBQUUsQ0FBQyxHQUFHLHVDQUFzQixDQUFDO2dCQUNuQyxPQUFPLEVBQUUsRUFBRSxFQUFFLEVBQUUsV0FBVyxDQUFDLFdBQVcsRUFBRTthQUN6QyxDQUFDO1lBQ0osQ0FBQyxDQUFDLEVBQUUsSUFBSSxFQUFFLEVBQUUsRUFBRSxDQUFDO1FBQ2pCLE9BQU87WUFDTCxPQUFPLEVBQUUsSUFBQSxn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

package/.medusa/server/src/workflows/email/prepare-shipment-email.js

@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.prepareShipmentEmailWorkflow = exports.prepareShipmentEmail = void 0;
 const utils_1 = require("@medusajs/framework/utils");
 const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const core_flows_1 = require("@medusajs/medusa/core-flows");
 const business_keys_1 = require("../../email/domain/business-keys");
 const documents_fact_fingerprint_1 = require("../../email/domain/documents-fact-fingerprint");
+const shipment_summary_1 = require("../../email/domain/shipment-summary");
 const email_1 = require("../../modules/email");
 const dispatch_email_message_1 = require("./dispatch-email-message");
 const documents_required_facts_1 = require("./documents-required-facts");
@@ -17,6 +19,27 @@ const findOrderIdForFulfillment = async (container, fulfillmentId) => {
     }
     return records[0].order_id;
 };
+/**
+ * The shipment snapshot must never block the shipping confirmation: a
+ * fulfillment that cannot be read or mapped is confirmed without it.
+ */
+const shipmentSummaryData = async (container, order, fulfillmentId) => {
+    try {
+        const query = container.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+        const { data } = await query.graph({
+            entity: "fulfillment",
+            fields: [...shipment_summary_1.SHIPMENT_FULFILLMENT_FIELDS],
+            filters: { id: fulfillmentId },
+        });
+        return { shipment: (0, shipment_summary_1.toShipmentSummary)(order, data[0]) };
+    }
+    catch {
+        container
+            .resolve(utils_1.ContainerRegistrationKeys.LOGGER)
+            .warn("Email: shipment summary unavailable; confirming without it.");
+        return {};
+    }
+};
 const prepareShipmentEmail = async (container, input) => {
     const email = container.resolve(email_1.EMAIL_MODULE);
     const businessKey = (0, business_keys_1.orderShippedBusinessKey)(input.fulfillment_id);
@@ -39,6 +62,7 @@ const prepareShipmentEmail = async (container, input) => {
             template_data: {
                 order_id: input.order_id,
                 fulfillment_id: input.fulfillment_id,
+                invoice_attached: input.decision === "carrier",
                 documents_fact_fingerprint: (0, documents_fact_fingerprint_1.fingerprintDocumentsFact)({
                     schema_version: input.schema_version,
                     order_id: input.order_id,
@@ -54,8 +78,16 @@ const prepareShipmentEmail = async (container, input) => {
         })
         : await (async () => {
             const orderId = await findOrderIdForFulfillment(container, input.fulfillment_id);
-            const orders = container.resolve(utils_1.Modules.ORDER);
-            const order = await orders.retrieveOrder(orderId);
+            const { result } = await (0, core_flows_1.getOrderDetailWorkflow)(container).run({
+                input: {
+                    order_id: orderId,
+                    fields: ["id", "email", ...shipment_summary_1.SHIPMENT_ORDER_FIELDS],
+                },
+            });
+            if (!result) {
+                throw new utils_1.MedusaError(utils_1.MedusaError.Types.NOT_FOUND, "The shipped fulfillment's order was not found.");
+            }
+            const order = result;
             return await email.upsertMessageFact({
                 ...identity,
                 fact: "shipment",
@@ -63,6 +95,7 @@ const prepareShipmentEmail = async (container, input) => {
                 template_data: {
                     order_id: order.id,
                     fulfillment_id: input.fulfillment_id,
+                    ...(await shipmentSummaryData(container, order, input.fulfillment_id)),
                 },
                 suppression_code: input.no_notification === true ? "notifications_disabled" : null,
             });
@@ -79,4 +112,4 @@ const prepareShipmentEmail = async (container, input) => {
 exports.prepareShipmentEmail = prepareShipmentEmail;
 const prepareShipmentEmailStep = (0, workflows_sdk_1.createStep)("email-prepare-shipment", async (input, { container }) => new workflows_sdk_1.StepResponse(await (0, exports.prepareShipmentEmail)(container, input)));
 exports.prepareShipmentEmailWorkflow = (0, workflows_sdk_1.createWorkflow)("email-prepare-shipment", (input) => new workflows_sdk_1.WorkflowResponse(prepareShipmentEmailStep(input)));
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJlcGFyZS1zaGlwbWVudC1lbWFpbC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3MvZW1haWwvcHJlcGFyZS1zaGlwbWVudC1lbWFpbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFJQSxxREFJbUM7QUFDbkMscUVBSzJDO0FBRzNDLG9FQUEyRTtBQUMzRSw4RkFBeUY7QUFDekYsK0NBQW1EO0FBRW5ELHFFQUF3RTtBQUN4RSx5RUFBMkU7QUF3QzNFLE1BQU0seUJBQXlCLEdBQUcsS0FBSyxFQUNyQyxTQUEwQixFQUMxQixhQUFxQixFQUNKLEVBQUU7SUFDbkIsTUFBTSxLQUFLLEdBQUcsU0FBUyxDQUFDLE9BQU8sQ0FDN0IsaUNBQXlCLENBQUMsSUFBSSxDQUNMLENBQUM7SUFDNUIsTUFBTSxvQkFBb0IsR0FBRyxLQUFLLENBQUMsYUFBYSxDQUM5QyxlQUFPLENBQUMsS0FBSyxFQUNiLFVBQVUsRUFDVixlQUFPLENBQUMsV0FBVyxFQUNuQixnQkFBZ0IsQ0FDakIsQ0FBQztJQUNGLE1BQU0sT0FBTyxHQUFHLE1BQU0sb0JBQW9CLENBQUMsSUFBSSxDQUM3QyxFQUFFLGNBQWMsRUFBRSxhQUFhLEVBQUUsRUFDakMsRUFBRSxNQUFNLEVBQUUsQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUN6QixDQUFDO0lBQ0YsSUFBSSxPQUFPLENBQUMsTUFBTSxLQUFLLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsRUFBRSxRQUFRLEVBQUUsQ0FBQztRQUNsRCxNQUFNLElBQUksbUJBQVcsQ0FDbkIsbUJBQVcsQ0FBQyxLQUFLLENBQUMsU0FBUyxFQUMzQixtREFBbUQsQ0FDcEQsQ0FBQztJQUNKLENBQUM7SUFDRCxPQUFPLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUM7QUFDN0IsQ0FBQyxDQUFDO0FBRUssTUFBTSxvQkFBb0IsR0FBRyxLQUFLLEVBQ3ZDLFNBQTBCLEVBQzFCLEtBQWdDLEVBQ0ssRUFBRTtJQUN2QyxNQUFNLEtBQUssR0FBRyxTQUFTLENBQUMsT0FBTyxDQUFxQixvQkFBWSxDQUFDLENBQUM7SUFDbEUsTUFBTSxXQUFXLEdBQUcsSUFBQSx1Q0FBdUIsRUFBQyxLQUFLLENBQUMsY0FBYyxDQUFDLENBQUM7SUFDbEUsTUFBTSxhQUFhLEdBQUcsTUFBTSxJQUFBLHdEQUE2QixFQUFDLFNBQVMsRUFBRSxLQUFLLEVBQUU7UUFDMUUsWUFBWSxFQUFFLFdBQVc7UUFDekIsV0FBVyxFQUFFLFVBQVU7UUFDdkIsY0FBYyxFQUFFLEtBQUssQ0FBQyxNQUFNLEtBQUssV0FBVztLQUM3QyxDQUFDLENBQUM7SUFDSCxNQUFNLFFBQVEsR0FBRztRQUNmLElBQUksRUFBRSxlQUF3QjtRQUM5QixZQUFZLEVBQUUsV0FBVztRQUN6QixhQUFhLEVBQUUsYUFBYTtRQUM1QixXQUFXLEVBQUUsS0FBSyxDQUFDLGNBQWM7UUFDakMsY0FBYyxFQUFFLGFBQWE7S0FDOUIsQ0FBQztJQUVGLE1BQU0sT0FBTyxHQUNYLEtBQUssQ0FBQyxNQUFNLEtBQUssV0FBVztRQUMxQixDQUFDLENBQUMsTUFBTSxLQUFLLENBQUMsaUJBQWlCLENBQUM7WUFDNUIsR0FBRyxRQUFRO1lBQ1gsSUFBSSxFQUFFLFdBQVc7WUFDakIsYUFBYSxFQUFFO2dCQUNiLFFBQVEsRUFBRSxLQUFLLENBQUMsUUFBUTtnQkFDeEIsY0FBYyxFQUFFLEtBQUssQ0FBQyxjQUFjO2dCQUNwQywwQkFBMEIsRUFBRSxJQUFBLHFEQUF3QixFQUFDO29CQUNuRCxjQUFjLEVBQUUsS0FBSyxDQUFDLGNBQWM7b0JBQ3BDLFFBQVEsRUFBRSxLQUFLLENBQUMsUUFBUTtvQkFDeEIsY0FBYyxFQUFFLEtBQUssQ0FBQyxjQUFjO29CQUNwQyxRQUFRLEVBQUUsS0FBSyxDQUFDLFFBQVE7b0JBQ3hCLHNCQUFzQixFQUNwQixLQUFLLENBQUMsUUFBUSxLQUFLLFNBQVM7d0JBQzFCLENBQUMsQ0FBQyxLQUFLLENBQUMsc0JBQXNCO3dCQUM5QixDQUFDLENBQUMsSUFBSTtvQkFDVixnQkFBZ0IsRUFDZCxLQUFLLENBQUMsUUFBUSxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLGdCQUFnQixDQUFDLENBQUMsQ0FBQyxJQUFJO2lCQUMvRCxDQUFDO2FBQ0g7WUFDRCxXQUFXLEVBQ1QsS0FBSyxDQUFDLFFBQVEsS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLGdCQUFnQixDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUU7U0FDL0QsQ0FBQztRQUNKLENBQUMsQ0FBQyxNQUFNLENBQUMsS0FBSyxJQUFJLEVBQUU7WUFDaEIsTUFBTSxPQUFPLEdBQUcsTUFBTSx5QkFBeUIsQ0FDN0MsU0FBUyxFQUNULEtBQUssQ0FBQyxjQUFjLENBQ3JCLENBQUM7WUFDRixNQUFNLE1BQU0sR0FBRyxTQUFTLENBQUMsT0FBTyxDQUFzQixlQUFPLENBQUMsS0FBSyxDQUFDLENBQUM7WUFDckUsTUFBTSxLQUFLLEdBQUcsTUFBTSxNQUFNLENBQUMsYUFBYSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1lBQ2xELE9BQU8sTUFBTSxLQUFLLENBQUMsaUJBQWlCLENBQUM7Z0JBQ25DLEdBQUcsUUFBUTtnQkFDWCxJQUFJLEVBQUUsVUFBVTtnQkFDaEIsU0FBUyxFQUFFLEtBQUssQ0FBQyxLQUFLLElBQUksSUFBSTtnQkFDOUIsYUFBYSxFQUFFO29CQUNiLFFBQVEsRUFBRSxLQUFLLENBQUMsRUFBRTtvQkFDbEIsY0FBYyxFQUFFLEtBQUssQ0FBQyxjQUFjO2lCQUNyQztnQkFDRCxnQkFBZ0IsRUFDZCxLQUFLLENBQUMsZUFBZSxLQUFLLElBQUksQ0FBQyxDQUFDLENBQUMsd0JBQXdCLENBQUMsQ0FBQyxDQUFDLElBQUk7YUFDbkUsQ0FBQyxDQUFDO1FBQ0wsQ0FBQyxDQUFDLEVBQUUsQ0FBQztJQUVYLE1BQU0sRUFBRSxNQUFNLEVBQUUsUUFBUSxFQUFFLEdBQUcsTUFBTSxJQUFBLHFEQUE0QixFQUM3RCxTQUFTLENBQ1YsQ0FBQyxHQUFHLENBQUM7UUFDSixLQUFLLEVBQUUsRUFBRSxVQUFVLEVBQUUsT0FBTyxDQUFDLEVBQUUsRUFBRTtLQUNsQyxDQUFDLENBQUM7SUFDSCxPQUFPO1FBQ0wsZUFBZSxFQUFFLFFBQVEsQ0FBQyxNQUFNO1FBQ2hDLFVBQVUsRUFBRSxPQUFPLENBQUMsRUFBRTtRQUN0QixNQUFNLEVBQUUsT0FBTyxDQUFDLE1BQU07S0FDdkIsQ0FBQztBQUNKLENBQUMsQ0FBQztBQXpFVyxRQUFBLG9CQUFvQix3QkF5RS9CO0FBRUYsTUFBTSx3QkFBd0IsR0FBRyxJQUFBLDBCQUFVLEVBS3pDLHdCQUF3QixFQUN4QixLQUFLLEVBQUUsS0FBSyxFQUFFLEVBQUUsU0FBUyxFQUFFLEVBQUUsRUFBRSxDQUM3QixJQUFJLDRCQUFZLENBQUMsTUFBTSxJQUFBLDRCQUFvQixFQUFDLFNBQVMsRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUNqRSxDQUFDO0FBRVcsUUFBQSw0QkFBNEIsR0FBRyxJQUFBLDhCQUFjLEVBQ3hELHdCQUF3QixFQUN4QixDQUFDLEtBQWdDLEVBQUUsRUFBRSxDQUNuQyxJQUFJLGdDQUFnQixDQUFDLHdCQUF3QixDQUFDLEtBQUssQ0FBQyxDQUFDLENBQ3hELENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJlcGFyZS1zaGlwbWVudC1lbWFpbC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3MvZW1haWwvcHJlcGFyZS1zaGlwbWVudC1lbWFpbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFDQSxxREFJbUM7QUFDbkMscUVBSzJDO0FBQzNDLDREQUFxRTtBQUdyRSxvRUFBMkU7QUFDM0UsOEZBQXlGO0FBQ3pGLDBFQUk2QztBQUU3QywrQ0FBbUQ7QUFFbkQscUVBQXdFO0FBQ3hFLHlFQUEyRTtBQXdDM0UsTUFBTSx5QkFBeUIsR0FBRyxLQUFLLEVBQ3JDLFNBQTBCLEVBQzFCLGFBQXFCLEVBQ0osRUFBRTtJQUNuQixNQUFNLEtBQUssR0FBRyxTQUFTLENBQUMsT0FBTyxDQUM3QixpQ0FBeUIsQ0FBQyxJQUFJLENBQ0wsQ0FBQztJQUM1QixNQUFNLG9CQUFvQixHQUFHLEtBQUssQ0FBQyxhQUFhLENBQzlDLGVBQU8sQ0FBQyxLQUFLLEVBQ2IsVUFBVSxFQUNWLGVBQU8sQ0FBQyxXQUFXLEVBQ25CLGdCQUFnQixDQUNqQixDQUFDO0lBQ0YsTUFBTSxPQUFPLEdBQUcsTUFBTSxvQkFBb0IsQ0FBQyxJQUFJLENBQzdDLEVBQUUsY0FBYyxFQUFFLGFBQWEsRUFBRSxFQUNqQyxFQUFFLE1BQU0sRUFBRSxDQUFDLFVBQVUsQ0FBQyxFQUFFLENBQ3pCLENBQUM7SUFDRixJQUFJLE9BQU8sQ0FBQyxNQUFNLEtBQUssQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxFQUFFLFFBQVEsRUFBRSxDQUFDO1FBQ2xELE1BQU0sSUFBSSxtQkFBVyxDQUNuQixtQkFBVyxDQUFDLEtBQUssQ0FBQyxTQUFTLEVBQzNCLG1EQUFtRCxDQUNwRCxDQUFDO0lBQ0osQ0FBQztJQUNELE9BQU8sT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQztBQUM3QixDQUFDLENBQUM7QUFFRjs7O0dBR0c7QUFD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

package/README.md

@@ -318,7 +318,10 @@ class DemoModuleService extends MedusaService({ /* models */ }) {
 
 - Types: `string`, `url` (http/https), `number` (finite, optional inclusive
   `min`/`max`), `boolean`, `secret`, `select` (`options: [{ value, label }]`,
-  non-empty, unique values; the stored value must be one of them). Keys
+  non-empty, unique values; the stored value must be one of them), `image`
+  (the http(s) URL of a PNG/JPEG of at most 2 MiB that the Admin uploads
+  through Medusa's `/admin/uploads` into the public File Module storage and
+  previews; replacing or removing it leaves the old file in storage). Keys
   follow the feature key format and are unique. A `secret` has no default;
   any other default must match its type, options and bounds. `options` exist
   only on `select`, `min`/`max` only on `number`. `required` defaults to
@@ -891,6 +894,10 @@ meantime, such as a password-reset link, is not sent). A toggle read
 failure fails the subscriber with its fixed sentinel (the Event Bus retries
 it) or fails the job run.
 
+The plugin declares one setting, edited in the Einstellungen section of its
+Admin page: `logo` (type `image`, optional), the PNG/JPG shown on top of every
+mail. It is not a Shop-Stammdaten field; Documents has its own `logo`.
+
 Admin surfaces of a disabled feature are hidden. The E-Mail settings page
 keeps `PluginFeatureSections` visible (so the plugin can be switched back on)
 and gates the Terms PDF versions and mail log sections below it on the
@@ -1060,20 +1067,130 @@ has at most 35 characters. Email runtime-validates every contract before use.
 - Password-reset messages cannot be retried by the generic retry job or resent
   by an Admin.
 - Unknown transport outcomes are never automatically resent.
-- Shop branding is only the configured `displayName`; a shop overrides the
-  default layout or single renderers in its own configuration, not in the
-  plugin.
+- Shop branding is the configured `displayName` plus the `logo` setting of
+  the E-Mail plugin and the company details of the Shop-Stammdaten; a shop overrides the default layout or
+  single renderers in its own configuration, not in the plugin.
 
 Read this section and the central design before changing Email domain behavior.
 
 ### Shop configuration and default templates
 
-The E-Mail module ships a neutral German layout and one renderer per accepted kind.
-Both show the shop only as the configured `displayName` (escaped in HTML; the
-layout header and footer, the password-reset and invite subjects). A shop
+The E-Mail module ships a neutral German layout in grey tones (table-based,
+inline styles) and one renderer per accepted kind. The layout shows, from top
+to bottom: the `logo` centered (an `image` setting of the E-Mail plugin,
+edited on its Admin page; without one, the configured `displayName`), a white card with the subject as heading and the
+renderer's body, a contact line ("Fragen? Dann schreib uns an … oder ruf uns
+an unter …", only with `email`/`phone`), and a footer with the company details
+(`legal_name` or `displayName`, address, UID, Firmenbuchnummer and
+Firmenbuchgericht, website) plus "Diese E-Mail wurde automatisch versendet.".
+Missing master data fields are left out. Email reads the logo and the
+Shop-Stammdaten when it sends a mail, so a change applies to the next mail; if
+a read fails the mail is sent without that part (logo or company details)
+instead of failing. Besides
+the layout, `displayName` appears in the password-reset and invite subjects.
+A custom `layout` receives the same data as `shop` (`EmailShopDetails`, every
+field optional) next to `bodyHtml`, `preheader` and `subject`. A shop
 therefore needs only `displayName`, `affiliatePortalUrl`, `inviteUrl`,
 `passwordResetUrl` and `orderNotificationEmail`.
 
+The order confirmation (`order.received`) receives an `OrderSummary` as
+`summary`: the display ID, the items with quantity and gross amount, the
+shipping method names, subtotal, shipping, discount, included tax and total,
+plus the billing and shipping address. Email freezes it when the order is
+placed, so a resend shows the order as it was placed. `summary` is absent for
+messages stored before the summary existed; a custom renderer must handle
+that case.
+
+The shop's order notification (`order.received.admin`) receives the same
+`summary` (with the order's `email` and `placed_at`). Its subject names the
+order number and the customer ("Neue Bestellung #1042 von Ada Beispiel"),
+an info box lists number, customer, e-mail and order time, followed by an
+"Im Admin öffnen" button and the items, totals and addresses. Two optional
+`ShopEmailConfiguration` fields drive it: `adminOrderUrl({ orderId })` (the
+button is left out without it) and `timeZone` (IANA; the order time is left
+out without it). `buildFoodShopConfig` sets both (`<MEDUSA_BACKEND_URL>/app/
+orders/<id>` and its `timeZone` option). The layout receives `audience`
+(`"shop"` for this kind and `user.invite`, `"customer"` for all others) and
+shows the contact line only to customers.
+
+The shipping confirmation (`order.shipped`, one per fulfillment) receives a
+`ShipmentSummary` as `shipment`, frozen when the shipment fact arrives: the
+display ID, the shipping option name, the tracking numbers and URLs entered
+at shipping, the parcel's items (title and variant of the order line,
+shipped quantity), the delivery address and `more_to_follow` (some ordered
+quantity is not shipped yet). `invoice_attached` is `true` when Documents chose
+this shipment for the invoice PDF. Its subject is "Deine Bestellung bei
+<displayName> ist unterwegs"; a single http(s) tracking URL becomes a
+"Sendung verfolgen" button, several become one link each. A fulfillment that
+cannot be read is confirmed without `shipment`, like a message stored before
+the snapshot existed.
+
+The cancellation confirmation (`order.canceled`) receives the same
+`OrderSummary` as `summary` plus `canceled_at`, frozen when the cancellation
+fact arrives, and `cancellation_attached` (`true` when Documents attached at
+least one cancellation document). Its subject is "Deine Bestellung #1042 bei
+<displayName> wurde storniert"; an info box lists the order number and the
+cancellation date (left out without `timeZone`), followed by a fixed refund
+note and the canceled items and totals without addresses. An order that
+cannot be summarized is confirmed without `summary` and without its internal
+ID.
+
+The return confirmation (`order.return_requested`) receives a `ReturnSummary`
+as `summary`, frozen when the return is requested: return and order numbers,
+the return shipping method, the items to send back (title and variant of the
+order line, quantity, return reason label) and the return address. It is
+the stock location's address, addressed to the location's company or else
+the master data's `legal_name`; without a location address it falls back to
+the master data's company address. Its subject is "Deine Rücksendung zur
+Bestellung #1042 bei <displayName>"; the mail asks the customer to enclose
+the return number (`#R5`). A return that cannot be read is confirmed without
+`summary` and without internal IDs.
+
+The return receipt (`order.return_received`, sent once the return is
+completely received) receives a `ReturnReceivedSummary` as `summary`: return
+and order numbers, `received_at` and the received items (title and variant
+of the order line, received quantity and the damaged part of it). Its subject
+is "Deine Rücksendung zur Bestellung #1042 bei <displayName> ist
+eingetroffen"; the arrival date needs `timeZone`, damaged units are noted per
+item, and a fixed sentence says that an eventual refund follows on the
+original payment method, without promising a separate mail (`order.refunded`
+only exists with Documents).
+
+The refund confirmation (`order.refunded`, one per non-cancellation refund,
+Documents only) receives a `RefundSummary` as `summary`, frozen when the
+Documents refund fact arrives and read through the refund's payment: order
+number, refunded gross amount and currency, `refunded_at` and the Admin's
+refund reason label. `cancellation_attached` is `true` when Documents attached
+a cancellation document. Its subject is "Deine Erstattung zur Bestellung #1042
+bei <displayName>"; the info box shows number, amount, date (needs
+`timeZone`) and reason, followed by a fixed note on bank processing times.
+Without `summary` the mail keeps the intro and the attachment note.
+
+The password reset (`auth.password_reset`) has the subject "Neues Passwort
+für dein Kundenkonto bei <displayName>", a "Neues Passwort festlegen" button,
+the link as copyable text below it, the link's lifetime ("Der Link ist 15
+Minuten gültig.", computed from the token's `exp` − `iat` and left out
+without `iat`) and a note that the mail can be ignored. The lifetime is
+passed as the ephemeral `valid_minutes` next to `reset_url` and is never
+persisted.
+
+The affiliate reminder (`affiliate.consignment_report_due`) greets the
+affiliate by `affiliate_display_name`, names the report month ("September
+2026", Austrian month names) and the due date ("10.10.2026") as calendar
+values formatted in UTC so no time zone shifts them, explains that the counted
+stock determines the billed sales, links `affiliatePortalUrl` as a "Zum
+Partnerbereich" button and says the mail can be ignored once the report is
+submitted. The button leads to a 404 while the affiliate plugin's
+`partner_portal` toggle is off.
+
+The Admin invite (`user.invite`) has the subject "Einladung ins Admin-Team von
+<displayName>", an "Einladung annehmen" button with the link as copyable text,
+the invite's current expiry ("Die Einladung ist gültig bis 02.10.2026, 01:40
+Uhr.", needs `timeZone`; read from the invite at send time, so a resend shows
+its new expiry) and a note that the mail can be ignored. The expiry is passed
+as the ephemeral `expires_at` next to `invite_url`. The invite goes to the
+shop's team, so its layout audience is `"shop"` (no contact line).
+
 - `layout` (optional) replaces the default layout completely.
 - `renderers` (optional, `Partial<EmailRendererMap>`) replaces only the listed
   kinds; every other kind keeps its default renderer.
@@ -1384,8 +1501,9 @@ below. `medusa db:migrate` creates its tables.
 `@hartl-services/medusa-base/config` exports, next to the environment helpers,
 build-time values for `medusa-config.ts` and tests:
 
-- `createDefaultDocumentHtmlFactory({ timeZone })` — the built-in factory, to
-  use as it is or to wrap (for example to add a header to the default HTML).
+- `createDefaultDocumentHtmlFactory({ timeZone, theme? })` — the built-in
+  factory, to use as it is, with a shop theme (see "Layout, logo, payment
+  terms and shop theme" below) or to wrap.
 - `DOCUMENTS_BUILD_PLACEHOLDERS` — `{ DOCUMENT_PDF_EXECUTABLE: "google-chrome" }`.
   `medusa build` evaluates `medusa-config.ts` without the runtime-only
   environment, so spread it under the real environment while building.
@@ -1393,6 +1511,44 @@ build-time values for `medusa-config.ts` and tests:
 The document types (`DocumentMerchantOption`, `DocumentHtmlFactory`,
 `DocumentRenderInput`, ...) come from `@hartl-services/medusa-base/types`.
 
+### Layout, logo, payment terms and shop theme
+
+The default markup prints an A4 letterhead: logo top left, document title and
+key data (number, order, date, customer UID for exempt B2B supplies) on the
+right, the billing address on the left, the item table with batch and
+best-before date per line, the totals below the price columns and a
+three-column footer (sender with UID and company register, contact, bank) on
+every page. Packing lists show only the sender in the footer. Every page
+carries "Seite x von y" bottom right in an 8 mm bottom page margin
+(`@page { @bottom-right }`; the page count exists only in page margin boxes).
+
+Settings under Settings → "Hartl Services Plugins" → **Dokumente**, read on
+every render and passed as `input.settings` (`DocumentRenderSettings`). Like
+the merchant data they are not part of the snapshot: a regenerated document
+shows the current values.
+
+- **Logo** (`logo`, PNG or JPG): each render downloads it (10 s timeout, at
+  most 2 MiB) and passes it inline as `settings.logo_src` (`data:` URL), so
+  Chromium never waits on the network. Without a logo, or when the download
+  fails (logged as a warning), the document shows the merchant's legal name;
+  a logo never blocks issuance.
+- **Zahlungskonditionen** (`payment_terms`, text): printed below the totals
+  of invoices only (not on cancellations or credit notes); blank means none.
+  Line breaks in the text are kept.
+
+**Theme:** `createDefaultDocumentHtmlFactory({ timeZone, theme })` keeps the
+content and markup and changes only the look. `theme.stylesheet` is CSS
+appended after the default stylesheet (later rules win; the defaults use the
+custom properties `--accent`, `--text`, `--muted`, `--line`, `--table-head`,
+`--page-x`, `--page-top`, `--footer-height`). Put a watermark or other
+full-page image into `@page { background: ... / 210mm 297mm }`: it covers the
+whole sheet on every page, whereas Chromium clips fixed elements at the page
+margin and sizes an inline `<svg>` in them wrongly from the second page on.
+Restyle the page number with `@page { @bottom-right { ... } }`. Embed web
+fonts as `data:` URLs; the container's Chromium has only its system fonts. A
+shop passes its factory through the preset option `documentHtmlFactory` (see
+"Shop-Config-Preset").
+
 ### Merchant data
 
 The legal sender printed on every document comes from the base plugin's shop
@@ -2207,6 +2363,7 @@ validate the environment; a missing variable fails with the variable's name.
 | `orderNotificationEmail` | Receives order notification e-mails; must look like an e-mail address. |
 | `timeZone` | IANA time zone (validated with `Intl`). Chooses the annual document-number period, the printed dates on documents and the affiliate consignment reminder time zone. |
 | `storefrontCountryCode` | 2-letter lowercase country code of the storefront route. Links: `<STOREFRONT_URL>/<cc>/partnerportal` (affiliate portal), `<STOREFRONT_URL>/<cc>/reset-password` (the e-mail plugin appends `#token=`), referral base `<STOREFRONT_URL>/<cc>`. The Admin invite link is `<MEDUSA_BACKEND_URL>/app/invite?token=`. |
+| `documentHtmlFactory` | Optional `DocumentHtmlFactory` that replaces the default document markup, typically `createDefaultDocumentHtmlFactory({ timeZone, theme })` from `/config` with the shop's CSS and watermark (see "Layout, logo, payment terms and shop theme"). Must be a function. |
 | `loadEnvFile` | Default `true`: calls `loadEnv(NODE_ENV \|\| "development", process.cwd())`. Pass `false` when the environment is already complete (tests, isolated child processes). |
 
 ### Environment variables

package/dist/admin-components/features/plugin-features/components/ImageSettingInput.d.ts

@@ -0,0 +1,15 @@
+type ImageSettingInputProps = {
+    id: string;
+    hintId: string;
+    label: string;
+    /** Public URL of the current image; `""` = none. */
+    value: string;
+    disabled: boolean;
+    onChange: (url: string) => void;
+};
+/**
+ * Uploads an image to the public File Module storage and hands its URL to
+ * the settings draft; the form stores it on save like any other value.
+ */
+export declare const ImageSettingInput: ({ id, hintId, label, value, disabled, onChange, }: ImageSettingInputProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin-components/features/plugin-features/components/ImageSettingInput.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Hint, Text } from "@medusajs/ui";
+import { useMutation } from "@tanstack/react-query";
+import { useRef, useState } from "react";
+import { texts } from "../../../i18n/texts";
+import { sdk } from "../../../lib/sdk";
+import { validateSettingImage } from "../lib/image-upload";
+/**
+ * Uploads an image to the public File Module storage and hands its URL to
+ * the settings draft; the form stores it on save like any other value.
+ */
+export const ImageSettingInput = ({ id, hintId, label, value, disabled, onChange, }) => {
+    const fileInput = useRef(null);
+    const [error, setError] = useState(null);
+    const upload = useMutation({
+        mutationFn: async (file) => {
+            const { files } = await sdk.admin.upload.create({ files: [file] });
+            const url = files[0]?.url;
+            if (!url) {
+                throw new Error("upload returned no file");
+            }
+            return url;
+        },
+        onSuccess: (url) => onChange(url),
+        onError: () => setError(texts.settings.imageUploadFailed),
+    });
+    const busy = disabled || upload.isPending;
+    const selectFile = (file) => {
+        if (!file) {
+            return;
+        }
+        const invalid = validateSettingImage(file);
+        setError(invalid);
+        if (!invalid) {
+            upload.mutate(file);
+        }
+    };
+    return (_jsxs("div", { className: "grid gap-2", children: [value && (_jsx("div", { className: "bg-ui-bg-subtle flex items-center justify-center rounded-md border p-4", children: _jsx("img", { src: value, alt: texts.settings.imagePreviewAlt(label), className: "max-h-24 max-w-full object-contain" }) })), _jsx("input", { ref: fileInput, id: id, "aria-describedby": hintId, type: "file", accept: "image/png,image/jpeg", className: "hidden", onChange: (event) => {
+                    selectFile(event.target.files?.[0]);
+                    event.target.value = "";
+                } }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Button, { type: "button", size: "small", variant: "secondary", isLoading: upload.isPending, disabled: busy, onClick: () => fileInput.current?.click(), children: value ? texts.settings.imageReplace : texts.settings.imageUpload }), value && (_jsx(Button, { type: "button", size: "small", variant: "transparent", disabled: busy, onClick: () => onChange(""), children: texts.settings.imageRemove })), !value && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: texts.settings.imageNone }))] }), error && _jsx(Hint, { variant: "error", children: error })] }));
+};

package/dist/admin-components/features/plugin-features/components/PluginSettingsForm.js

@@ -2,6 +2,7 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Alert, Button, Container, Heading, Hint, Input, Label, Select, Switch, Text, } from "@medusajs/ui";
 import { texts } from "../../../i18n/texts";
 import { usePluginSettingsForm } from "../hooks/usePluginSettingsForm";
+import { ImageSettingInput } from "./ImageSettingInput";
 const fieldId = (pluginKey, key) => `plugin-setting-${pluginKey}-${key}`;
 export const missingLabels = (plugin) => plugin.missing
     .map((key) => plugin.settings.find((setting) => setting.key === key)?.label ?? key)
@@ -27,13 +28,14 @@ const SettingField = ({ pluginKey, setting, invalidatesLabels, value, invalid, d
                             ? texts.settings.secretClearUndoLabel(setting.label)
                             : texts.settings.secretClearLabel(setting.label), onClick: () => onChange(clearPending ? "" : null), children: clearPending
                             ? texts.settings.secretClearUndo
-                            : texts.settings.secretClear }))] })) : setting.type === "select" ? (_jsxs(Select, { value: typeof value === "string" ? value : "", disabled: disabled, onValueChange: (next) => onChange(next), children: [_jsx(Select.Trigger, { id: id, "aria-describedby": hintId, children: _jsx(Select.Value, { placeholder: texts.settings.selectPlaceholder }) }), _jsx(Select.Content, { children: setting.options.map((option) => (_jsx(Select.Item, { value: option.value, children: option.label }, option.value))) })] })) : setting.type === "number" ? (_jsx(Input, { id: id, "aria-describedby": hintId, "aria-invalid": invalid, type: "number", step: "any", min: setting.min ?? undefined, max: setting.max ?? undefined, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value, event.target.validity.badInput) })) : (_jsx(Input, { id: id, "aria-describedby": hintId, "aria-invalid": invalid, type: setting.type === "url" ? "url" : "text", value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value) })), _jsxs("div", { id: hintId, className: "grid gap-1", children: [setting.description && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: setting.description })), clearPending && (_jsx(Hint, { variant: "info", children: texts.settings.secretClearPending })), invalidatesLabels && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: texts.settings.invalidates(invalidatesLabels) })), bounds && !invalid && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: bounds })), invalid && (_jsx(Hint, { variant: "error", children: bounds ?? texts.settings.invalidNumber }))] })] }));
+                            : texts.settings.secretClear }))] })) : setting.type === "select" ? (_jsxs(Select, { value: typeof value === "string" ? value : "", disabled: disabled, onValueChange: (next) => onChange(next), children: [_jsx(Select.Trigger, { id: id, "aria-describedby": hintId, children: _jsx(Select.Value, { placeholder: texts.settings.selectPlaceholder }) }), _jsx(Select.Content, { children: setting.options.map((option) => (_jsx(Select.Item, { value: option.value, children: option.label }, option.value))) })] })) : setting.type === "image" ? (_jsx(ImageSettingInput, { id: id, hintId: hintId, label: setting.label, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (url) => onChange(url) })) : setting.type === "number" ? (_jsx(Input, { id: id, "aria-describedby": hintId, "aria-invalid": invalid, type: "number", step: "any", min: setting.min ?? undefined, max: setting.max ?? undefined, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value, event.target.validity.badInput) })) : (_jsx(Input, { id: id, "aria-describedby": hintId, "aria-invalid": invalid, type: setting.type === "url" ? "url" : "text", value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value) })), _jsxs("div", { id: hintId, className: "grid gap-1", children: [setting.description && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: setting.description })), clearPending && (_jsx(Hint, { variant: "info", children: texts.settings.secretClearPending })), invalidatesLabels && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: texts.settings.invalidates(invalidatesLabels) })), bounds && !invalid && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: bounds })), invalid && (_jsx(Hint, { variant: "error", children: bounds ?? texts.settings.invalidNumber }))] })] }));
 };
 export const PluginSettingsForm = ({ plugin }) => {
     const form = usePluginSettingsForm(plugin);
     const pending = form.mutation.isPending;
     const hasTextFields = plugin.settings.some((setting) => setting.type !== "boolean" &&
         setting.type !== "secret" &&
-        setting.type !== "select");
+        setting.type !== "select" &&
+        setting.type !== "image");
     return (_jsxs(Container, { className: "divide-y p-0", "aria-busy": pending, children: [_jsxs("div", { className: "px-6 py-4", children: [_jsx(Heading, { level: "h2", children: texts.sections.settings }), hasTextFields && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: texts.settings.clearHint }))] }), _jsxs("form", { onSubmit: form.submit, className: "grid gap-5 px-6 py-5", children: [!plugin.configured && (_jsx(Alert, { variant: "warning", children: texts.settings.missing(missingLabels(plugin)) })), plugin.settings.map((setting) => (_jsx(SettingField, { pluginKey: plugin.plugin_key, setting: setting, invalidatesLabels: invalidatesLabels(plugin, setting), value: form.draft[setting.key], invalid: form.invalid.includes(setting.key), disabled: pending, onChange: (value, badInput) => form.setValue(setting.key, value, badInput) }, setting.key))), _jsx("div", { className: "flex justify-end", children: _jsx(Button, { type: "submit", size: "small", isLoading: pending, disabled: !form.dirty || form.invalid.length > 0 || pending, children: texts.settings.save }) })] })] }));
 };

package/dist/admin-components/features/plugin-features/hooks/usePluginFeatureEnabled.d.ts

@@ -74,7 +74,7 @@ export declare const pluginFeatureEnabledQueryOptions: (pluginKey: string, featu
                 source: "default" | "stored" | "config" | "none";
                 invalidates: string[];
             } | {
-                type: "string" | "boolean" | "url";
+                type: "string" | "boolean" | "url" | "image";
                 default: string | number | boolean | null;
                 value: string | number | boolean | null;
                 key: string;

package/dist/admin-components/features/plugin-features/hooks/usePluginFeatures.d.ts

@@ -54,7 +54,7 @@ export declare function usePluginFeatures(): import("@tanstack/react-query").Use
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -141,7 +141,7 @@ export declare function usePluginFeature(pluginKey: string | undefined): import(
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -222,7 +222,7 @@ export declare function useUpdatePluginFeatures(): import("@tanstack/react-query
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -307,7 +307,7 @@ export declare function useUpdatePluginSettings(pluginKey: string): import("@tan
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;

package/dist/admin-components/features/plugin-features/hooks/usePluginSettingsForm.d.ts

@@ -63,7 +63,7 @@ export declare function usePluginSettingsForm(plugin: AdminPluginFeatures): {
                 source: "default" | "stored" | "config" | "none";
                 invalidates: string[];
             } | {
-                type: "string" | "boolean" | "url";
+                type: "string" | "boolean" | "url" | "image";
                 default: string | number | boolean | null;
                 value: string | number | boolean | null;
                 key: string;

package/dist/admin-components/features/plugin-features/lib/image-upload.d.ts

@@ -0,0 +1,6 @@
+/** Largest image an `image` setting accepts in the Admin. */
+export declare const SETTING_IMAGE_MAX_BYTES: number;
+type ImageSelection = Pick<File, "size" | "type">;
+/** Why `file` cannot be uploaded for an `image` setting; `null` = valid. */
+export declare const validateSettingImage: (file: ImageSelection) => string | null;
+export {};

package/dist/admin-components/features/plugin-features/lib/image-upload.js

@@ -0,0 +1,17 @@
+/** Largest image an `image` setting accepts in the Admin. */
+export const SETTING_IMAGE_MAX_BYTES = 2 * 1024 * 1024;
+// Gmail and Outlook do not display SVG or WebP in e-mails.
+const IMAGE_TYPES = new Set(["image/png", "image/jpeg"]);
+/** Why `file` cannot be uploaded for an `image` setting; `null` = valid. */
+export const validateSettingImage = (file) => {
+    if (!IMAGE_TYPES.has(file.type)) {
+        return "Bitte eine PNG- oder JPG-Datei auswählen.";
+    }
+    if (file.size === 0) {
+        return "Die Bilddatei ist leer.";
+    }
+    if (file.size > SETTING_IMAGE_MAX_BYTES) {
+        return "Die Bilddatei darf maximal 2 MiB groß sein.";
+    }
+    return null;
+};