@hartl-services/medusa-base 2.7.0 → 2.9.0

package/.medusa/server/src/admin/admin-components/features/plugin-features/components/PluginSettingsForm.js

@@ -4,9 +4,11 @@ import { texts } from "../../../i18n/texts";
 import { AdminSection } from "../../../shared/ui/AdminSection";
 import { InfoTooltip } from "../../../shared/ui/InfoTooltip";
 import { SwitchRow } from "../../../shared/ui/SwitchRow";
-import { invalidatedByLabels, invalidatesLabels, isGroupDimmed, settingInfoText, showsBoundsLine, showsSourceHint, } from "../lib/plugin-view";
+import { invalidatedByLabels, isGroupDimmed, settingInfoText, showsBoundsLine, showsSourceHint, } from "../lib/plugin-view";
 import { isHexColor, normalizeColorInput } from "../lib/settings-draft";
-import { buildSettingGroups } from "../lib/settings-layout";
+import { dateFromInputValue, inputValueFromDate } from "../../../shared/lib/date-input";
+import { AdminDatePicker } from "../../../shared/ui/AdminDatePicker";
+import { buildSettingGroups, isGroupVisible, } from "../lib/settings-layout";
 import { usePluginSettingsForm } from "../hooks/usePluginSettingsForm";
 import { ImageSettingInput } from "./ImageSettingInput";
 const fieldId = (pluginKey, key) => `plugin-setting-${pluginKey}-${key}`;
@@ -34,8 +36,9 @@ const ColorSettingInput = ({ id, hintId, label, value, invalid, required, disabl
                 className: `h-8 w-10 shrink-0 cursor-pointer rounded-md border border-ui-border-base bg-ui-bg-field p-1 disabled:cursor-not-allowed ${hasColor ? "" : "opacity-30"}`, value: hasColor ? value.trim() : "#000000", disabled: disabled, onChange: (event) => onChange(normalizeColorInput(event.target.value)) })] }));
 };
 /** A non-boolean setting: label (with source hint), control and hints. */
-const SettingField = ({ pluginKey, setting, invalidatedBy, invalidates, value, invalid, disabled, onChange, }) => {
+const SettingField = ({ pluginKey, setting, invalidatedBy, value, invalid, disabled, onChange, }) => {
     const id = fieldId(pluginKey, setting.key);
+    const labelId = `${id}-label`;
     const hintId = `${id}-hint`;
     const clearPending = setting.type === "secret" && value === null;
     const bounds = setting.type === "number" ? boundsText(setting) : undefined;
@@ -46,30 +49,30 @@ const SettingField = ({ pluginKey, setting, invalidatedBy, invalidates, value, i
     const hasHints = Boolean(hint) ||
         clearPending ||
         invalidatedBy.length > 0 ||
-        invalidates.length > 0 ||
         showBounds ||
         invalid;
     const describedBy = hasHints ? hintId : undefined;
     const placeholder = setting.placeholder ?? undefined;
-    return (_jsxs("div", { className: "flex flex-col gap-y-2", children: [_jsxs("div", { className: "flex items-center justify-between gap-3", children: [_jsxs("div", { className: "flex items-center gap-x-1", children: [_jsx(Label, { htmlFor: id, size: "small", weight: "plus", children: labelText(setting) }), info && (_jsx(InfoTooltip, { label: texts.info.label(setting.label), children: info }))] }), showsSourceHint(setting.source) && (_jsx(Text, { size: "xsmall", className: "text-ui-fg-muted shrink-0", children: texts.settings.source[setting.source] }))] }), setting.type === "secret" ? (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Input, { id: id, "aria-describedby": describedBy, "aria-required": required || undefined, className: "flex-1", type: "password", autoComplete: "new-password", placeholder: setting.is_set ? texts.settings.secretPlaceholder : placeholder, value: typeof value === "string" ? value : "", disabled: disabled || clearPending, onChange: (event) => onChange(event.target.value) }), setting.source === "stored" && (_jsx(Button, { type: "button", size: "small", variant: "secondary", disabled: disabled, "aria-label": clearPending
+    return (_jsxs("div", { className: "flex flex-col gap-y-2", children: [_jsxs("div", { className: "flex items-center justify-between gap-3", children: [_jsxs("div", { className: "flex items-center gap-x-1", children: [_jsx(Label, { id: labelId, htmlFor: id, size: "small", weight: "plus", children: labelText(setting) }), info && (_jsx(InfoTooltip, { label: texts.info.label(setting.label), children: info }))] }), showsSourceHint(setting.source) && (_jsx(Text, { size: "xsmall", className: "text-ui-fg-muted shrink-0", children: texts.settings.source[setting.source] }))] }), setting.type === "secret" ? (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Input, { id: id, "aria-describedby": describedBy, "aria-required": required || undefined, className: "flex-1", type: "password", autoComplete: "new-password", placeholder: setting.is_set ? texts.settings.secretPlaceholder : placeholder, value: typeof value === "string" ? value : "", disabled: disabled || clearPending, onChange: (event) => onChange(event.target.value) }), setting.source === "stored" && (_jsx(Button, { type: "button", size: "small", variant: "secondary", disabled: disabled, "aria-label": clearPending
                             ? 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": describedBy, "aria-required": required || undefined, 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, describedBy: describedBy, label: setting.label, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (url) => onChange(url) })) : setting.type === "color" ? (_jsx(ColorSettingInput, { id: id, hintId: describedBy, label: setting.label, value: typeof value === "string" ? value : "", invalid: invalid, required: required, disabled: disabled, onChange: (next) => onChange(next) })) : setting.type === "number" ? (_jsx(Input, { id: id, "aria-describedby": describedBy, "aria-invalid": invalid, "aria-required": required || undefined, type: "number", step: setting.integer ? 1 : "any", min: setting.min ?? undefined, max: setting.max ?? undefined, placeholder: placeholder, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value, event.target.validity.badInput) })) : (_jsx(Input, { id: id, "aria-describedby": describedBy, "aria-invalid": invalid, "aria-required": required || undefined, type: setting.type === "url" ? "url" : "text", placeholder: placeholder, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value) })), hasHints && (_jsxs("div", { id: hintId, className: "flex flex-col gap-y-1", children: [hint && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: hint })), clearPending && (_jsx(Hint, { variant: "info", children: texts.settings.secretClearPending })), invalidatedBy.length > 0 && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: texts.settings.invalidatedBy(invalidatedBy) })), invalidates.length > 0 && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: texts.settings.invalidates(invalidates.join(", ")) })), showBounds && !invalid && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: bounds })), invalid && (_jsx(Hint, { variant: "error", children: setting.type === "color"
+                            : 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": describedBy, "aria-required": required || undefined, 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, describedBy: describedBy, label: setting.label, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (url) => onChange(url) })) : setting.type === "color" ? (_jsx(ColorSettingInput, { id: id, hintId: describedBy, label: setting.label, value: typeof value === "string" ? value : "", invalid: invalid, required: required, disabled: disabled, onChange: (next) => onChange(next) })) : setting.type === "date" ? (_jsx(AdminDatePicker, { id: id, "aria-labelledby": labelId, "aria-describedby": describedBy, isDisabled: disabled, value: dateFromInputValue(typeof value === "string" ? value : ""), onChange: (date) => onChange(inputValueFromDate(date)) })) : setting.type === "number" ? (_jsx(Input, { id: id, "aria-describedby": describedBy, "aria-invalid": invalid, "aria-required": required || undefined, type: "number", step: setting.integer ? 1 : "any", min: setting.min ?? undefined, max: setting.max ?? undefined, placeholder: placeholder, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value, event.target.validity.badInput) })) : (_jsx(Input, { id: id, "aria-describedby": describedBy, "aria-invalid": invalid, "aria-required": required || undefined, type: setting.type === "url" ? "url" : "text", placeholder: placeholder, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value) })), hasHints && (_jsxs("div", { id: hintId, className: "flex flex-col gap-y-1", children: [hint && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: hint })), clearPending && (_jsx(Hint, { variant: "info", children: texts.settings.secretClearPending })), invalidatedBy.length > 0 && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: texts.settings.invalidatedBy(invalidatedBy) })), showBounds && !invalid && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: bounds })), invalid && (_jsx(Hint, { variant: "error", children: setting.type === "color"
                             ? texts.settings.invalidColor
                             : (bounds ?? texts.settings.invalidNumber) }))] }))] }));
 };
 export const PluginSettingsForm = ({ plugin }) => {
     const form = usePluginSettingsForm(plugin);
     const pending = form.mutation.isPending;
-    const groups = buildSettingGroups(plugin.settings, plugin.setting_groups, texts.sections.settings);
+    const groups = buildSettingGroups(plugin.settings, plugin.setting_groups, texts.sections.settings).filter((group) => isGroupVisible(group, form.draft));
     const hasTextFields = plugin.settings.some((setting) => setting.type === "string" ||
         setting.type === "url" ||
         setting.type === "number" ||
-        setting.type === "color");
+        setting.type === "color" ||
+        setting.type === "date");
     const renderField = (setting) => (_jsx(SettingField, { pluginKey: plugin.plugin_key, setting: setting, invalidatedBy: setting.type === "secret"
             ? invalidatedByLabels(plugin.settings, setting.key)
-            : [], invalidates: invalidatesLabels(plugin.settings, 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));
+            : [], value: form.draft[setting.key], invalid: form.invalid.includes(setting.key), disabled: pending, onChange: (value, badInput) => form.setValue(setting.key, value, badInput) }, setting.key));
     // `dimmed`: the group's required feature is off; the rows stay editable.
     const renderBlock = (block, dimmed) => {
         const dim = dimmed ? "opacity-50 transition-opacity" : "transition-opacity";

package/.medusa/server/src/admin/admin-components/features/plugin-features/hooks/usePluginFeatureEnabled.d.ts

@@ -90,7 +90,7 @@ export declare const pluginFeatureEnabledQueryOptions: (pluginKey: string, featu
                 width: "full" | "half";
                 section: string | null;
             } | {
-                type: "string" | "boolean" | "color" | "image" | "url";
+                type: "string" | "boolean" | "color" | "image" | "url" | "date";
                 default: string | number | boolean | null;
                 value: string | number | boolean | null;
                 key: string;
@@ -130,6 +130,10 @@ export declare const pluginFeatureEnabledQueryOptions: (pluginKey: string, featu
                 description: string | null;
                 note: string | null;
                 requires_feature: string | null;
+                visible_when: {
+                    setting: string;
+                    equals: string | boolean;
+                } | null;
             }[];
         }[];
     }>;

package/.medusa/server/src/admin/admin-components/features/plugin-features/hooks/usePluginFeatures.d.ts

@@ -70,7 +70,7 @@ export declare function usePluginFeatures(): import("@tanstack/react-query").Use
             width: "full" | "half";
             section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "image" | "url";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -110,6 +110,10 @@ export declare function usePluginFeatures(): import("@tanstack/react-query").Use
             description: string | null;
             note: string | null;
             requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
         }[];
     }[];
 }, Error>;
@@ -192,7 +196,7 @@ export declare function usePluginFeature(pluginKey: string | undefined): import(
             width: "full" | "half";
             section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "image" | "url";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -232,6 +236,10 @@ export declare function usePluginFeature(pluginKey: string | undefined): import(
             description: string | null;
             note: string | null;
             requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
         }[];
     };
 }, Error>;
@@ -308,7 +316,7 @@ export declare function useUpdatePluginFeatures(): import("@tanstack/react-query
             width: "full" | "half";
             section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "image" | "url";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -348,6 +356,10 @@ export declare function useUpdatePluginFeatures(): import("@tanstack/react-query
             description: string | null;
             note: string | null;
             requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
         }[];
     };
 }, Error, {
@@ -428,7 +440,7 @@ export declare function useUpdatePluginSettings(pluginKey: string): import("@tan
             width: "full" | "half";
             section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "image" | "url";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -468,6 +480,10 @@ export declare function useUpdatePluginSettings(pluginKey: string): import("@tan
             description: string | null;
             note: string | null;
             requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
         }[];
     };
 }, Error, {

package/.medusa/server/src/admin/admin-components/features/plugin-features/hooks/usePluginSettingsForm.d.ts

@@ -79,7 +79,7 @@ export declare function usePluginSettingsForm(plugin: AdminPluginFeatures): {
                 width: "full" | "half";
                 section: string | null;
             } | {
-                type: "string" | "boolean" | "color" | "image" | "url";
+                type: "string" | "boolean" | "color" | "image" | "url" | "date";
                 default: string | number | boolean | null;
                 value: string | number | boolean | null;
                 key: string;
@@ -119,6 +119,10 @@ export declare function usePluginSettingsForm(plugin: AdminPluginFeatures): {
                 description: string | null;
                 note: string | null;
                 requires_feature: string | null;
+                visible_when: {
+                    setting: string;
+                    equals: string | boolean;
+                } | null;
             }[];
         };
     }, Error, {

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/plugin-features-admin-client.d.ts

@@ -71,7 +71,7 @@ export declare const listPluginFeatures: () => Promise<{
             width: "full" | "half";
             section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "image" | "url";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -111,6 +111,10 @@ export declare const listPluginFeatures: () => Promise<{
             description: string | null;
             note: string | null;
             requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
         }[];
     }[];
 }>;
@@ -186,7 +190,7 @@ export declare const retrievePluginFeatures: (pluginKey: string) => Promise<{
             width: "full" | "half";
             section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "image" | "url";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -226,6 +230,10 @@ export declare const retrievePluginFeatures: (pluginKey: string) => Promise<{
             description: string | null;
             note: string | null;
             requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
         }[];
     };
 }>;
@@ -301,7 +309,7 @@ export declare const updatePluginFeatures: (payload: UpdatePluginFeaturesPayload
             width: "full" | "half";
             section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "image" | "url";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -341,6 +349,10 @@ export declare const updatePluginFeatures: (payload: UpdatePluginFeaturesPayload
             description: string | null;
             note: string | null;
             requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
         }[];
     };
 }>;
@@ -416,7 +428,7 @@ export declare const updatePluginSettings: (pluginKey: string, payload: UpdatePl
             width: "full" | "half";
             section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "image" | "url";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -456,6 +468,10 @@ export declare const updatePluginSettings: (pluginKey: string, payload: UpdatePl
             description: string | null;
             note: string | null;
             requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
         }[];
     };
 }>;

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/plugin-view.d.ts

@@ -27,11 +27,6 @@ export declare const disabledParent: (features: readonly AdminPluginFeature[], f
 export declare const invalidatedByLabels: (settings: readonly AdminPluginSetting[], secretKey: string) => string[];
 /** Whether a settings group is dimmed: its required feature exists and is not effective. */
 export declare const isGroupDimmed: (features: readonly AdminPluginFeature[], requiresFeature: string | null) => boolean;
-/**
- * Labels of the secrets that a change of `setting` deletes (forward
- * `invalidates`), in the setting's order; unknown keys fall back to the key.
- */
-export declare const invalidatesLabels: (settings: readonly AdminPluginSetting[], setting: Pick<AdminPluginSetting, "invalidates">) => string[];
 /**
  * The description a setting shows in its info tooltip: only when a `hint`
  * takes the place under the field and the description says something else.

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/plugin-view.js

@@ -41,11 +41,6 @@ export const invalidatedByLabels = (settings, secretKey) => settings
 export const isGroupDimmed = (features, requiresFeature) => requiresFeature !== null &&
     features.find((feature) => feature.key === requiresFeature)
         ?.effective_enabled === false;
-/**
- * Labels of the secrets that a change of `setting` deletes (forward
- * `invalidates`), in the setting's order; unknown keys fall back to the key.
- */
-export const invalidatesLabels = (settings, setting) => setting.invalidates.map((key) => settings.find((candidate) => candidate.key === key)?.label ?? key);
 /**
  * The description a setting shows in its info tooltip: only when a `hint`
  * takes the place under the field and the description says something else.

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/settings-layout.d.ts

@@ -30,6 +30,8 @@ export type SettingGroupView = {
     description: string | null;
     note: string | null;
     requiresFeature: string | null;
+    /** The group applies only while this setting's draft value equals `equals`. */
+    visibleWhen: AdminPluginSettingGroup["visible_when"];
     settings: AdminPluginSetting[];
     blocks: SettingBlock[];
 };
@@ -41,3 +43,5 @@ export declare const buildSettingBlocks: (settings: readonly AdminPluginSetting[
  * `groups` supplies the description, note and required feature per group.
  */
 export declare const buildSettingGroups: (settings: readonly AdminPluginSetting[], groups: readonly AdminPluginSettingGroup[], ungroupedTitle: string) => SettingGroupView[];
+/** Whether a group's `visible_when` holds for the current form values. */
+export declare const isGroupVisible: (group: Pick<SettingGroupView, "visibleWhen">, draft: Readonly<Record<string, string | boolean | null>>) => boolean;

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/settings-layout.js

@@ -59,8 +59,12 @@ export const buildSettingGroups = (settings, groups, ungroupedTitle) => {
             description: meta?.description ?? null,
             note: meta?.note ?? null,
             requiresFeature: meta?.requires_feature ?? null,
+            visibleWhen: meta?.visible_when ?? null,
             settings: groupSettings,
             blocks: buildSettingBlocks(groupSettings),
         };
     });
 };
+/** Whether a group's `visible_when` holds for the current form values. */
+export const isGroupVisible = (group, draft) => group.visibleWhen === null ||
+    draft[group.visibleWhen.setting] === group.visibleWhen.equals;

package/.medusa/server/src/admin/admin-components/i18n/texts.d.ts

@@ -5,6 +5,7 @@ export declare const texts: {
     breadcrumbs: {
         hub: string;
         emailAttachments: string;
+        emailDelivery: string;
     };
     page: {
         title: string;
@@ -70,8 +71,6 @@ export declare const texts: {
         secretClearUndoLabel: (label: string) => string;
         /** Shown on a secret: the settings whose change deletes it ("A", "A oder B"). */
         invalidatedBy: (labels: readonly string[]) => string;
-        /** Shown on the changing setting: the secrets its change deletes. */
-        invalidates: (labels: string) => string;
         invalidNumber: string;
         invalidColor: string;
         colorPlaceholder: string;

package/.medusa/server/src/admin/admin-components/i18n/texts.js

@@ -5,6 +5,7 @@ export const texts = {
     breadcrumbs: {
         hub: "Plugins",
         emailAttachments: "Anhänge",
+        emailDelivery: "Versand",
     },
     page: {
         title: "Hartl Services Plugins",
@@ -72,8 +73,6 @@ export const texts = {
         invalidatedBy: (labels) => `Wird gelöscht, wenn ${labels.length > 1
             ? `${labels.slice(0, -1).join(", ")} oder ${labels[labels.length - 1]}`
             : labels.join("")} sich ändert.`,
-        /** Shown on the changing setting: the secrets its change deletes. */
-        invalidates: (labels) => `Beim Ändern muss ${labels} neu eingegeben werden.`,
         invalidNumber: "Bitte eine gültige Zahl eingeben.",
         invalidColor: "Bitte eine Hex-Farbe wie #1a2b3c eingeben.",
         colorPlaceholder: "Standard",