@hartl-services/medusa-base 1.0.0 → 2.0.0

package/dist/email/types/template-data.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EmailRenderDataSchemas = exports.EmailPersistedDataSchemas = void 0;
+exports.EmailRenderDataSchemas = exports.EmailPersistedDataSchemas = exports.RefundSummarySchema = exports.ReturnReceivedSummarySchema = exports.ReturnSummarySchema = exports.ShipmentSummarySchema = exports.OrderSummarySchema = void 0;
 const zod_1 = require("@medusajs/framework/zod");
 const affiliate_1 = require("@hartl-services/medusa-food-supplements-contracts/schemas/affiliate");
 const NonEmptyStringSchema = zod_1.z.string().trim().min(1);
@@ -9,15 +9,146 @@ const DocumentsFactFingerprintSchema = zod_1.z
     .string()
     .regex(/^[a-f0-9]{64}$/)
     .optional();
+const AmountSchema = zod_1.z.string().regex(/^-?\d+(\.\d+)?$/);
+const OptionalTextSchema = zod_1.z.string().nullable();
+const OrderSummaryAddressSchema = zod_1.z
+    .object({
+    first_name: OptionalTextSchema,
+    last_name: OptionalTextSchema,
+    company: OptionalTextSchema,
+    address_1: OptionalTextSchema,
+    address_2: OptionalTextSchema,
+    postal_code: OptionalTextSchema,
+    city: OptionalTextSchema,
+    country_code: OptionalTextSchema,
+})
+    .strict();
+/**
+ * Snapshot of an order when it was placed. Amounts are Medusa's gross
+ * decimal strings: item and shipping rows before discounts, so
+ * `original_item_total + original_shipping_total - discount_total` is the
+ * `total`, which already contains `tax_total`.
+ */
+exports.OrderSummarySchema = zod_1.z
+    .object({
+    display_id: zod_1.z.number().int().nullable(),
+    /** The order's e-mail address; `null` when the order has none. */
+    email: OptionalTextSchema,
+    /** When the order was placed (ISO 8601). */
+    placed_at: zod_1.z.string().datetime(),
+    currency_code: NonEmptyStringSchema,
+    items: zod_1.z.array(zod_1.z
+        .object({
+        title: NonEmptyStringSchema,
+        variant_title: OptionalTextSchema,
+        quantity: zod_1.z.number().positive(),
+        original_total: AmountSchema,
+    })
+        .strict()),
+    shipping_method_names: zod_1.z.array(NonEmptyStringSchema),
+    original_item_total: AmountSchema,
+    original_shipping_total: AmountSchema,
+    discount_total: AmountSchema,
+    tax_total: AmountSchema,
+    total: AmountSchema,
+    billing_address: OrderSummaryAddressSchema.nullable(),
+    shipping_address: OrderSummaryAddressSchema.nullable(),
+})
+    .strict();
+/**
+ * Snapshot of one shipment when it was shipped: the parcel's items (title
+ * of the order line, shipped quantity), tracking numbers and links as
+ * entered at shipping, and whether more of the order is still to be shipped.
+ */
+exports.ShipmentSummarySchema = zod_1.z
+    .object({
+    display_id: zod_1.z.number().int().nullable(),
+    shipping_method_name: OptionalTextSchema,
+    tracking: zod_1.z.array(zod_1.z
+        .object({
+        number: OptionalTextSchema,
+        url: OptionalTextSchema,
+    })
+        .strict()),
+    items: zod_1.z.array(zod_1.z
+        .object({
+        title: NonEmptyStringSchema,
+        variant_title: OptionalTextSchema,
+        quantity: zod_1.z.number().positive(),
+    })
+        .strict()),
+    delivery_address: OrderSummaryAddressSchema.nullable(),
+    more_to_follow: zod_1.z.boolean(),
+})
+    .strict();
+/**
+ * Snapshot of a return when it was requested: the return and order numbers,
+ * the items to send back (title of the order line, quantity, reason label),
+ * the return shipping option and where to send the parcel.
+ */
+exports.ReturnSummarySchema = zod_1.z
+    .object({
+    display_id: zod_1.z.number().int().nullable(),
+    order_display_id: zod_1.z.number().int().nullable(),
+    shipping_method_name: OptionalTextSchema,
+    items: zod_1.z.array(zod_1.z
+        .object({
+        title: NonEmptyStringSchema,
+        variant_title: OptionalTextSchema,
+        quantity: zod_1.z.number().positive(),
+        reason: OptionalTextSchema,
+    })
+        .strict()),
+    return_address: OrderSummaryAddressSchema.nullable(),
+})
+    .strict();
+/**
+ * Snapshot of a return when it was completely received: the return and
+ * order numbers, when it arrived and the received items (title of the order
+ * line, received quantity and how much of it arrived damaged).
+ */
+exports.ReturnReceivedSummarySchema = zod_1.z
+    .object({
+    display_id: zod_1.z.number().int().nullable(),
+    order_display_id: zod_1.z.number().int().nullable(),
+    received_at: zod_1.z.string().datetime().nullable(),
+    items: zod_1.z.array(zod_1.z
+        .object({
+        title: NonEmptyStringSchema,
+        variant_title: OptionalTextSchema,
+        quantity: zod_1.z.number().positive(),
+        damaged_quantity: zod_1.z.number().nonnegative(),
+    })
+        .strict()),
+})
+    .strict();
+/**
+ * Snapshot of one refund when its Documents fact arrived: the order number,
+ * the refunded gross amount, when it was refunded and the refund reason
+ * chosen in the Admin.
+ */
+exports.RefundSummarySchema = zod_1.z
+    .object({
+    order_display_id: zod_1.z.number().int().nullable(),
+    amount: AmountSchema,
+    currency_code: NonEmptyStringSchema,
+    refunded_at: zod_1.z.string().datetime().nullable(),
+    reason: OptionalTextSchema,
+})
+    .strict();
 exports.EmailPersistedDataSchemas = {
     "order.received": zod_1.z
         .object({
         order_id: NonEmptyStringSchema,
+        // Optional: messages stored before the summary existed have none.
+        summary: exports.OrderSummarySchema.optional(),
     })
         .strict(),
     "order.received.admin": zod_1.z
         .object({
         order_id: NonEmptyStringSchema,
+        // Optional: messages stored before the summary existed have none.
+        summary: exports.OrderSummarySchema.optional(),
     })
         .strict(),
     "order.shipped": zod_1.z
@@ -25,24 +156,38 @@ exports.EmailPersistedDataSchemas = {
         order_id: NonEmptyStringSchema,
         fulfillment_id: NonEmptyStringSchema,
         documents_fact_fingerprint: DocumentsFactFingerprintSchema,
+        // Optional: messages stored before the snapshot existed have none.
+        shipment: exports.ShipmentSummarySchema.optional(),
+        /** The invoice PDF is attached (Documents chose this shipment). */
+        invoice_attached: zod_1.z.boolean().optional(),
     })
         .strict(),
     "order.canceled": zod_1.z
         .object({
         order_id: NonEmptyStringSchema,
         documents_fact_fingerprint: DocumentsFactFingerprintSchema,
+        // Optional: messages stored before the snapshot existed have none.
+        summary: exports.OrderSummarySchema.optional(),
+        /** When the order was canceled (ISO 8601). */
+        canceled_at: zod_1.z.string().datetime().optional(),
+        /** A cancellation document PDF is attached (from Documents). */
+        cancellation_attached: zod_1.z.boolean().optional(),
     })
         .strict(),
     "order.return_requested": zod_1.z
         .object({
         order_id: NonEmptyStringSchema,
         return_id: NonEmptyStringSchema,
+        // Optional: messages stored before the snapshot existed have none.
+        summary: exports.ReturnSummarySchema.optional(),
     })
         .strict(),
     "order.return_received": zod_1.z
         .object({
         order_id: NonEmptyStringSchema,
         return_id: NonEmptyStringSchema,
+        // Optional: messages stored before the snapshot existed have none.
+        summary: exports.ReturnReceivedSummarySchema.optional(),
     })
         .strict(),
     "order.refunded": zod_1.z
@@ -50,6 +195,10 @@ exports.EmailPersistedDataSchemas = {
         order_id: NonEmptyStringSchema,
         refund_id: NonEmptyStringSchema,
         documents_fact_fingerprint: DocumentsFactFingerprintSchema,
+        // Optional: messages stored before the snapshot existed have none.
+        summary: exports.RefundSummarySchema.optional(),
+        /** A cancellation document PDF is attached (from Documents). */
+        cancellation_attached: zod_1.z.boolean().optional(),
     })
         .strict(),
     "auth.password_reset": zod_1.z
@@ -71,8 +220,12 @@ exports.EmailRenderDataSchemas = {
     ...exports.EmailPersistedDataSchemas,
     "auth.password_reset": exports.EmailPersistedDataSchemas["auth.password_reset"].extend({
         reset_url: zod_1.z.string().url(),
+        /** How long the reset link is valid, from the token; `undefined` if unknown. */
+        valid_minutes: zod_1.z.number().int().positive().optional(),
     }),
     "user.invite": exports.EmailPersistedDataSchemas["user.invite"].extend({
         invite_url: zod_1.z.string().url(),
+        /** When the invite expires (ISO 8601), from the current invite. */
+        expires_at: zod_1.z.string().datetime().optional(),
     }),
 };

package/dist/modules/documents/domain/options.d.ts

@@ -1,6 +1,5 @@
 import type { DocumentHtmlFactory } from "../../../documents/types/html-factory";
-import type { DocumentMerchantOption, DocumentPdfOptions } from "../../../documents/types/documents";
-import { type DocumentMerchantValues } from "./merchant";
+import type { DocumentPdfOptions } from "../../../documents/types/documents";
 /** Used when the `documents.numbering.timeZone` option is not given. */
 export declare const DEFAULT_NUMBERING_TIME_ZONE = "Europe/Vienna";
 /** The `documents` namespace of the base plugin options. */
@@ -10,11 +9,6 @@ export type DocumentPluginOptions = {
      * `createDefaultDocumentHtmlFactory` with the `numbering.timeZone`.
      */
     htmlFactory?: DocumentHtmlFactory;
-    /**
-     * Fallback for the shop master data of the base plugin: used per field
-     * only where no value is stored there.
-     */
-    merchant?: DocumentMerchantOption;
     numbering?: {
         timeZone?: string;
     };
@@ -22,8 +16,6 @@ export type DocumentPluginOptions = {
 };
 export type ResolvedDocumentPluginOptions = {
     htmlFactory: DocumentHtmlFactory;
-    /** The `merchant` option keyed by shop master data field. */
-    merchantFallback: DocumentMerchantValues;
     numbering: {
         timeZone: string;
     };

package/dist/modules/documents/domain/options.js

@@ -3,7 +3,6 @@ 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) => {
@@ -24,14 +23,9 @@ const resolveDocumentPluginOptions = (options) => {
         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 },
     };

package/dist/public/descriptor.js

@@ -11,6 +11,7 @@ const SETTING_TYPES = new Set([
     "boolean",
     "secret",
     "select",
+    "image",
 ]);
 const ACTION_MODES = new Set(["sync", "background"]);
 const ADMIN_PAGE_PREFIX = "/settings/hartl-services/";
@@ -33,6 +34,7 @@ const defaultMatchesType = (setting) => {
         case "string":
             return hasText(value);
         case "url":
+        case "image":
             return typeof value === "string" && isHttpUrl(value);
         case "number":
             return typeof value === "number" && Number.isFinite(value);

package/dist/public/shop-master-data.d.ts

@@ -1,11 +1,10 @@
 import type { MedusaContainer } from "@medusajs/framework/types";
-import type { PluginSettingsFallback } from "./types";
 /**
  * The base's own descriptor: the shop's master data (Firmenangaben), edited
  * on the generic plugin page like any plugin's settings. It cannot be
  * switched off and declares no features.
  */
-export declare const shopMasterDataDescriptor: import("./types").PluginFeatureDescriptor<string, "legal_name" | "address_line1" | "address_line2" | "postal_code" | "city" | "country_code" | "vat_number" | "email" | "phone" | "website" | "iban" | "bic" | "company_register_number" | "company_register_court", never>;
+export declare const shopMasterDataDescriptor: import("./types").PluginFeatureDescriptor<string, "country_code" | "legal_name" | "address_line1" | "address_line2" | "postal_code" | "city" | "vat_number" | "email" | "phone" | "website" | "iban" | "bic" | "company_register_number" | "company_register_court", never>;
 /** Keys of the shop master data settings. */
 export type ShopMasterDataKey = "legal_name" | "address_line1" | "address_line2" | "postal_code" | "city" | "country_code" | "vat_number" | "email" | "phone" | "website" | "iban" | "bic" | "company_register_number" | "company_register_court";
 /** Every key that has a value (stored > fallback). All values are strings. */
@@ -18,8 +17,8 @@ export type ResolvedShopMasterData = {
     missing: ShopMasterDataKey[];
 };
 /**
- * The shop's master data for server-side code. Precedence per key: stored in
- * the Admin > `fallback` (e.g. a plugin's own medusa-config option). A
- * missing base plugin fails with `UNEXPECTED_STATE`; read failures propagate.
+ * The shop's master data for server-side code, exactly as stored in the
+ * Admin: there is no config fallback. A missing base plugin fails with
+ * `UNEXPECTED_STATE`; read failures propagate.
  */
-export declare function getShopMasterData(container: MedusaContainer, fallback?: PluginSettingsFallback<ShopMasterDataKey>): Promise<ResolvedShopMasterData>;
+export declare function getShopMasterData(container: MedusaContainer): Promise<ResolvedShopMasterData>;

package/dist/public/shop-master-data.js

@@ -12,7 +12,7 @@ const settings_1 = require("./settings");
 exports.shopMasterDataDescriptor = (0, descriptor_1.definePluginFeatures)({
     plugin_key: "shop",
     label: "Shop-Stammdaten",
-    description: "Firmenangaben des Shops für Rechnungen, Dokumente und Steuerprüfungen.",
+    description: "Firmenangaben des Shops für E-Mails, Rechnungen, Dokumente und Steuerprüfungen.",
     switchable: false,
     features: [],
     settings: [
@@ -74,12 +74,12 @@ exports.shopMasterDataDescriptor = (0, descriptor_1.definePluginFeatures)({
     ],
 });
 /**
- * The shop's master data for server-side code. Precedence per key: stored in
- * the Admin > `fallback` (e.g. a plugin's own medusa-config option). A
- * missing base plugin fails with `UNEXPECTED_STATE`; read failures propagate.
+ * The shop's master data for server-side code, exactly as stored in the
+ * Admin: there is no config fallback. A missing base plugin fails with
+ * `UNEXPECTED_STATE`; read failures propagate.
  */
-async function getShopMasterData(container, fallback) {
-    const resolved = await (0, settings_1.getPluginSettings)(container, exports.shopMasterDataDescriptor, fallback);
+async function getShopMasterData(container) {
+    const resolved = await (0, settings_1.getPluginSettings)(container, exports.shopMasterDataDescriptor);
     const values = {};
     for (const [key, value] of Object.entries(resolved.values)) {
         if (typeof value === "string") {

package/dist/public/types.d.ts

@@ -30,7 +30,8 @@ export type PluginFeatureDefinition<K extends string = string> = {
     readonly default_enabled: boolean;
     readonly parent_key?: K;
 };
-export type PluginSettingType = "string" | "url" | "number" | "boolean" | "secret" | "select";
+/** `image`: public http(s) URL of an image the Admin uploads (PNG/JPEG). */
+export type PluginSettingType = "string" | "url" | "number" | "boolean" | "secret" | "select" | "image";
 /** One allowed value of a `"select"` setting. */
 export type PluginSettingOption = {
     readonly value: string;

package/dist/shop-config/build-food-shop-config.js

@@ -18,7 +18,6 @@ const options_1 = require("./options");
  */
 function buildFoodShopConfig(options, environment = process.env) {
     (0, options_1.assertFoodShopConfigOptions)(options);
-    const { merchant } = options;
     if (options.loadEnvFile !== false) {
         (0, utils_1.loadEnv)(process.env.NODE_ENV || "development", process.cwd());
     }
@@ -144,6 +143,8 @@ function buildFoodShopConfig(options, environment = process.env) {
                 email: {
                     jwtSecret: env.JWT_SECRET,
                     shop: {
+                        // The Admin dashboard mounts under admin.path ("/app").
+                        adminOrderUrl: ({ orderId }) => new URL(`/app/orders/${encodeURIComponent(orderId)}`, backendOrigin).toString(),
                         displayName: options.displayName,
                         affiliatePortalUrl: (0, config_1.shopUrl)(storefrontOrigin, `${storefrontPath}/partnerportal`),
                         // The Admin dashboard mounts "/invite" under admin.path ("/app").
@@ -155,12 +156,11 @@ function buildFoodShopConfig(options, environment = process.env) {
                         orderNotificationEmail: options.orderNotificationEmail,
                         // The e-mail module appends "#token=<token>".
                         passwordResetUrl: () => (0, config_1.shopUrl)(storefrontOrigin, `${storefrontPath}/reset-password`),
+                        timeZone: options.timeZone,
                     },
                 },
                 documents: {
-                    // Fallback only: the shop master data in the Admin ("Hartl Services
-                    // Plugins" -> Shop-Stammdaten) wins per field.
-                    merchant,
+                    htmlFactory: options.documentHtmlFactory,
                     numbering: {
                         // Chooses the annual document-number period; matches the date the
                         // HTML factory prints.
@@ -175,7 +175,7 @@ function buildFoodShopConfig(options, environment = process.env) {
         },
         {
             resolve: "@hartl-services/medusa-tax-compliance",
-            options: { merchant },
+            options: {},
         },
         {
             resolve: "@hartl-services/medusa-free-shipping",

package/dist/shop-config/options.d.ts

@@ -1,23 +1,21 @@
-import type { DocumentMerchantOption } from "../documents/types";
+import type { DocumentHtmlFactory } from "../documents/types";
 /**
  * The shop-specific facts of a food shop. Deployment values and secrets are
  * not options: they come from the environment (see the README).
  */
 export type FoodShopConfigOptions = Readonly<{
     /**
-     * Fallback for the shop master data (Admin -> "Hartl Services Plugins" ->
-     * Shop-Stammdaten) that documents and tax compliance read per field. Its
-     * `legalName` is also the seeded store name.
+     * Shop name in the branding of the default e-mail templates (and the store
+     * name of a shop's initial seed). Company name, address and UID are not
+     * options: they come only from the Shop-Stammdaten in the Admin.
      */
-    merchant: DocumentMerchantOption;
-    /** Shop name in the branding of the default e-mail templates. */
     displayName: string;
     /** Receives the shop's order notification e-mails. */
     orderNotificationEmail: string;
     /**
      * IANA time zone (e.g. "Europe/Vienna"): chooses the annual document-number
-     * period, matches the dates printed on documents, and schedules the
-     * affiliate consignment reminders.
+     * period, matches the dates printed on documents and e-mails, and
+     * schedules the affiliate consignment reminders.
      */
     timeZone: string;
     /**
@@ -26,6 +24,13 @@ export type FoodShopConfigOptions = Readonly<{
      * affiliate referral links to `/<code>`.
      */
     storefrontCountryCode: string;
+    /**
+     * Replaces the default document markup (documents `htmlFactory`), e.g.
+     * `createDefaultDocumentHtmlFactory({ timeZone, theme })` from
+     * `@hartl-services/medusa-base/config` with the shop's own CSS and
+     * watermark. Omit it for the plugin's default look.
+     */
+    documentHtmlFactory?: DocumentHtmlFactory;
     /**
      * Load `.env.<NODE_ENV>` from the working directory into `process.env`
      * like `medusa-config.ts` does by default. Pass `false` when the

package/dist/shop-config/options.js

@@ -45,24 +45,14 @@ const requireObject = (value, name) => {
  */
 function assertFoodShopConfigOptions(options) {
     const candidate = requireObject(options, "options");
-    const merchant = requireObject(candidate.merchant, "merchant");
-    requireText(merchant.legalName, "merchant.legalName");
-    requireCountryCode(merchant.countryCode, "merchant.countryCode");
-    if (merchant.vatNumber !== undefined) {
-        requireText(merchant.vatNumber, "merchant.vatNumber");
-    }
-    const address = requireObject(merchant.registeredAddress, "merchant.registeredAddress");
-    requireText(address.address1, "merchant.registeredAddress.address1");
-    if (address.address2 !== undefined) {
-        requireText(address.address2, "merchant.registeredAddress.address2");
-    }
-    requireText(address.city, "merchant.registeredAddress.city");
-    requireText(address.postalCode, "merchant.registeredAddress.postalCode");
-    requireCountryCode(address.countryCode, "merchant.registeredAddress.countryCode");
     requireText(candidate.displayName, "displayName");
     requireEmail(candidate.orderNotificationEmail, "orderNotificationEmail");
     requireTimeZone(candidate.timeZone, "timeZone");
     requireCountryCode(candidate.storefrontCountryCode, "storefrontCountryCode");
+    if (candidate.documentHtmlFactory !== undefined &&
+        typeof candidate.documentHtmlFactory !== "function") {
+        fail("documentHtmlFactory", "a function");
+    }
     if (candidate.loadEnvFile !== undefined &&
         typeof candidate.loadEnvFile !== "boolean") {
         fail("loadEnvFile", "a boolean");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hartl-services/medusa-base",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Base plugin for Hartl Services Medusa shops: per-plugin feature toggles with a generic Admin settings page, a Store endpoint for storefronts, enforcement helpers, the complete-cart hook composition, the root redirect, cart-promotion link repair, the built-in E-Mail, Documents and S3 file storage modules, config helpers with the turnkey food-shop preset, and the Sentry logger wrapper and instrumentation.",
   "license": "MIT",
   "files": [
@@ -88,7 +88,7 @@
     "mime-types": "3.0.1",
     "nodemailer": "6.10.1",
     "ulid": "^2.4.0",
-    "@hartl-services/medusa-food-supplements-contracts": "^0.16.0"
+    "@hartl-services/medusa-food-supplements-contracts": "^0.17.0"
   },
   "devDependencies": {
     "@medusajs/admin-sdk": "2.19.0",

package/dist/modules/documents/domain/merchant.d.ts

@@ -1,22 +0,0 @@
-import type { DocumentMerchant, DocumentMerchantOption } from "../../../documents/types/documents";
-/** Shop master data keys (base plugin, `plugin_key: "shop"`) documents read. */
-export type DocumentMerchantKey = keyof DocumentMerchant;
-export type DocumentMerchantValues = Partial<Record<DocumentMerchantKey, string>>;
-/** Without these a financial document or packing list has no legal sender. */
-export declare const DOCUMENT_MERCHANT_REQUIRED_FIELDS: readonly ["legal_name", "address_line1", "postal_code", "city", "country_code"];
-/** Development placeholder UID: never printed on a document. */
-export declare const MERCHANT_VAT_PLACEHOLDER = "ATU00000000";
-/**
- * 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.
- */
-export declare const merchantOptionToFallback: (option: DocumentMerchantOption | undefined) => DocumentMerchantValues;
-export type DocumentMerchantResolution = {
-    merchant: DocumentMerchant;
-    missing: [];
-} | {
-    merchant: null;
-    missing: DocumentMerchantKey[];
-};
-/** Maps resolved shop master data to the render input's `merchant`. */
-export declare const toDocumentMerchant: (values: DocumentMerchantValues) => DocumentMerchantResolution;

package/dist/modules/documents/domain/merchant.js

@@ -1,85 +0,0 @@
-"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;