@hartl-services/medusa-base 2.6.1 → 2.8.0

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

@@ -1,5 +1,9 @@
 import type { AdminPluginFeatures } from "@hartl-services/medusa-food-supplements-contracts/types/plugin-features-admin";
-/** aktiv/aus (switchable plugins only), plus konfiguriert/nicht konfiguriert when the plugin has settings. */
+/**
+ * Aktiv/Aus (switchable plugins only), plus Konfiguriert/Nicht konfiguriert
+ * when the plugin has required settings. Renders bare badges: the caller
+ * lays them out (page header slot, flex row).
+ */
 export declare const PluginStatusChips: ({ plugin }: {
     plugin: AdminPluginFeatures;
 }) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,8 +1,10 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { StatusBadge } from "@medusajs/ui";
 import { texts } from "../../../i18n/texts";
-import { missingLabels } from "./PluginSettingsForm";
-/** aktiv/aus (switchable plugins only), plus konfiguriert/nicht konfiguriert when the plugin has settings. */
-export const PluginStatusChips = ({ plugin }) => (_jsxs("div", { className: "mt-2 flex flex-wrap gap-2", children: [plugin.switchable && (_jsx(StatusBadge, { color: plugin.enabled ? "green" : "grey", children: plugin.enabled ? texts.chips.enabled : texts.chips.disabled })), plugin.settings.length > 0 && (_jsx(StatusBadge, { color: plugin.configured ? "green" : "orange", children: plugin.configured
-                ? texts.chips.configured
-                : texts.chips.notConfigured(missingLabels(plugin)) }))] }));
+import { hasRequiredSettings } from "../lib/plugin-view";
+/**
+ * Aktiv/Aus (switchable plugins only), plus Konfiguriert/Nicht konfiguriert
+ * when the plugin has required settings. Renders bare badges: the caller
+ * lays them out (page header slot, flex row).
+ */
+export const PluginStatusChips = ({ plugin }) => (_jsxs(_Fragment, { children: [plugin.switchable && (_jsx(StatusBadge, { color: plugin.enabled ? "green" : "grey", children: plugin.enabled ? texts.chips.enabled : texts.chips.disabled })), hasRequiredSettings(plugin) && (_jsx(StatusBadge, { color: plugin.configured ? "green" : "orange", children: plugin.configured ? texts.chips.configured : texts.chips.notConfigured }))] }));

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

@@ -0,0 +1,11 @@
+import type { AdminPluginFeatures } from "@hartl-services/medusa-food-supplements-contracts/types/plugin-features-admin";
+/** Plugin key of the shop master data, which the hub shows as a banner above the cards. */
+export declare const SHOP_PLUGIN_KEY = "shop";
+/**
+ * The shop master data (plugin `shop`, cannot be switched off) as a banner
+ * with an edit button; a subtle "Nicht konfiguriert" while required data is
+ * missing.
+ */
+export declare const ShopMasterDataBanner: ({ plugin }: {
+    plugin: AdminPluginFeatures;
+}) => import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Container, Heading, IconBadge, StatusBadge, Text } from "@medusajs/ui";
+import { Link } from "react-router-dom";
+import { texts } from "../../../i18n/texts";
+import { PluginIcon } from "../../../shared/ui/PluginIcon";
+import { pluginDetailPath } from "../lib/plugin-paths";
+import { isUnconfigured } from "../lib/plugin-view";
+/** Plugin key of the shop master data, which the hub shows as a banner above the cards. */
+export const SHOP_PLUGIN_KEY = "shop";
+/**
+ * The shop master data (plugin `shop`, cannot be switched off) as a banner
+ * with an edit button; a subtle "Nicht konfiguriert" while required data is
+ * missing.
+ */
+export const ShopMasterDataBanner = ({ plugin }) => (_jsx(Container, { children: _jsxs("div", { className: "flex flex-wrap items-center gap-x-4 gap-y-3", children: [_jsx(IconBadge, { size: "large", children: _jsx(PluginIcon, { name: plugin.icon ?? "Buildings" }) }), _jsxs("div", { className: "flex min-w-0 flex-[1_1_320px] flex-col gap-y-0.5", children: [_jsx(Heading, { level: "h2", children: plugin.label }), _jsx(Text, { size: "small", leading: "compact", className: "text-ui-fg-subtle", children: plugin.summary ?? plugin.description })] }), isUnconfigured(plugin) && (_jsx(StatusBadge, { color: "orange", children: texts.chips.notConfigured })), _jsx(Button, { size: "small", variant: "secondary", asChild: true, children: _jsx(Link, { to: plugin.admin_page ?? pluginDetailPath(plugin.plugin_key), "aria-label": texts.plugin.openLabel(plugin.label), children: texts.page.editShop }) })] }) }));

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

@@ -44,8 +44,12 @@ export declare const pluginFeatureEnabledQueryOptions: (pluginKey: string, featu
                 group: string | null;
                 required: boolean;
                 is_set: boolean;
-                source: "default" | "stored" | "config" | "none";
+                source: "none" | "default" | "stored" | "config";
                 invalidates: string[];
+                hint: string | null;
+                placeholder: string | null;
+                width: "full" | "half";
+                section: string | null;
             } | {
                 type: "select";
                 options: {
@@ -60,12 +64,17 @@ export declare const pluginFeatureEnabledQueryOptions: (pluginKey: string, featu
                 group: string | null;
                 required: boolean;
                 is_set: boolean;
-                source: "default" | "stored" | "config" | "none";
+                source: "none" | "default" | "stored" | "config";
                 invalidates: string[];
+                hint: string | null;
+                placeholder: string | null;
+                width: "full" | "half";
+                section: string | null;
             } | {
                 type: "number";
                 min: number | null;
                 max: number | null;
+                integer: boolean;
                 default: number | null;
                 value: number | null;
                 key: string;
@@ -74,10 +83,14 @@ export declare const pluginFeatureEnabledQueryOptions: (pluginKey: string, featu
                 group: string | null;
                 required: boolean;
                 is_set: boolean;
-                source: "default" | "stored" | "config" | "none";
+                source: "none" | "default" | "stored" | "config";
                 invalidates: string[];
+                hint: string | null;
+                placeholder: string | null;
+                width: "full" | "half";
+                section: string | null;
             } | {
-                type: "string" | "boolean" | "color" | "url" | "image";
+                type: "string" | "boolean" | "color" | "image" | "url" | "date";
                 default: string | number | boolean | null;
                 value: string | number | boolean | null;
                 key: string;
@@ -86,8 +99,12 @@ export declare const pluginFeatureEnabledQueryOptions: (pluginKey: string, featu
                 group: string | null;
                 required: boolean;
                 is_set: boolean;
-                source: "default" | "stored" | "config" | "none";
+                source: "none" | "default" | "stored" | "config";
                 invalidates: string[];
+                hint: string | null;
+                placeholder: string | null;
+                width: "full" | "half";
+                section: string | null;
             })[];
             configured: boolean;
             missing: string[];
@@ -100,6 +117,24 @@ export declare const pluginFeatureEnabledQueryOptions: (pluginKey: string, featu
                 confirm: string | null;
             }[];
             admin_page: string | null;
+            icon: string | null;
+            summary: string | null;
+            disable_hint: string | null;
+            disable_confirm: string | null;
+            features_heading: string | null;
+            features_note: string | null;
+            all_off_warning: string | null;
+            require_enabled_feature: boolean;
+            setting_groups: {
+                name: string;
+                description: string | null;
+                note: string | null;
+                requires_feature: string | null;
+                visible_when: {
+                    setting: string;
+                    equals: string | boolean;
+                } | null;
+            }[];
         }[];
     }>;
     staleTime: number;

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

@@ -24,8 +24,12 @@ export declare function usePluginFeatures(): import("@tanstack/react-query").Use
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "select";
             options: {
@@ -40,12 +44,17 @@ export declare function usePluginFeatures(): import("@tanstack/react-query").Use
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "number";
             min: number | null;
             max: number | null;
+            integer: boolean;
             default: number | null;
             value: number | null;
             key: string;
@@ -54,10 +63,14 @@ export declare function usePluginFeatures(): import("@tanstack/react-query").Use
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "url" | "image";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -66,8 +79,12 @@ export declare function usePluginFeatures(): import("@tanstack/react-query").Use
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         })[];
         configured: boolean;
         missing: string[];
@@ -80,6 +97,24 @@ export declare function usePluginFeatures(): import("@tanstack/react-query").Use
             confirm: string | null;
         }[];
         admin_page: string | null;
+        icon: string | null;
+        summary: string | null;
+        disable_hint: string | null;
+        disable_confirm: string | null;
+        features_heading: string | null;
+        features_note: string | null;
+        all_off_warning: string | null;
+        require_enabled_feature: boolean;
+        setting_groups: {
+            name: string;
+            description: string | null;
+            note: string | null;
+            requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
+        }[];
     }[];
 }, Error>;
 /**
@@ -115,8 +150,12 @@ export declare function usePluginFeature(pluginKey: string | undefined): import(
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "select";
             options: {
@@ -131,12 +170,17 @@ export declare function usePluginFeature(pluginKey: string | undefined): import(
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "number";
             min: number | null;
             max: number | null;
+            integer: boolean;
             default: number | null;
             value: number | null;
             key: string;
@@ -145,10 +189,14 @@ export declare function usePluginFeature(pluginKey: string | undefined): import(
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "url" | "image";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -157,8 +205,12 @@ export declare function usePluginFeature(pluginKey: string | undefined): import(
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         })[];
         configured: boolean;
         missing: string[];
@@ -171,6 +223,24 @@ export declare function usePluginFeature(pluginKey: string | undefined): import(
             confirm: string | null;
         }[];
         admin_page: string | null;
+        icon: string | null;
+        summary: string | null;
+        disable_hint: string | null;
+        disable_confirm: string | null;
+        features_heading: string | null;
+        features_note: string | null;
+        all_off_warning: string | null;
+        require_enabled_feature: boolean;
+        setting_groups: {
+            name: string;
+            description: string | null;
+            note: string | null;
+            requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
+        }[];
     };
 }, Error>;
 /** One instance per plugin card, so pending state is scoped to that plugin. */
@@ -200,8 +270,12 @@ export declare function useUpdatePluginFeatures(): import("@tanstack/react-query
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "select";
             options: {
@@ -216,12 +290,17 @@ export declare function useUpdatePluginFeatures(): import("@tanstack/react-query
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "number";
             min: number | null;
             max: number | null;
+            integer: boolean;
             default: number | null;
             value: number | null;
             key: string;
@@ -230,10 +309,14 @@ export declare function useUpdatePluginFeatures(): import("@tanstack/react-query
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "url" | "image";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -242,8 +325,12 @@ export declare function useUpdatePluginFeatures(): import("@tanstack/react-query
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         })[];
         configured: boolean;
         missing: string[];
@@ -256,6 +343,24 @@ export declare function useUpdatePluginFeatures(): import("@tanstack/react-query
             confirm: string | null;
         }[];
         admin_page: string | null;
+        icon: string | null;
+        summary: string | null;
+        disable_hint: string | null;
+        disable_confirm: string | null;
+        features_heading: string | null;
+        features_note: string | null;
+        all_off_warning: string | null;
+        require_enabled_feature: boolean;
+        setting_groups: {
+            name: string;
+            description: string | null;
+            note: string | null;
+            requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
+        }[];
     };
 }, Error, {
     plugin_key: string;
@@ -289,8 +394,12 @@ export declare function useUpdatePluginSettings(pluginKey: string): import("@tan
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "select";
             options: {
@@ -305,12 +414,17 @@ export declare function useUpdatePluginSettings(pluginKey: string): import("@tan
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "number";
             min: number | null;
             max: number | null;
+            integer: boolean;
             default: number | null;
             value: number | null;
             key: string;
@@ -319,10 +433,14 @@ export declare function useUpdatePluginSettings(pluginKey: string): import("@tan
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "url" | "image";
+            type: "string" | "boolean" | "color" | "image" | "url" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -331,8 +449,12 @@ export declare function useUpdatePluginSettings(pluginKey: string): import("@tan
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         })[];
         configured: boolean;
         missing: string[];
@@ -345,6 +467,24 @@ export declare function useUpdatePluginSettings(pluginKey: string): import("@tan
             confirm: string | null;
         }[];
         admin_page: string | null;
+        icon: string | null;
+        summary: string | null;
+        disable_hint: string | null;
+        disable_confirm: string | null;
+        features_heading: string | null;
+        features_note: string | null;
+        all_off_warning: string | null;
+        require_enabled_feature: boolean;
+        setting_groups: {
+            name: string;
+            description: string | null;
+            note: string | null;
+            requires_feature: string | null;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
+        }[];
     };
 }, Error, {
     expected_version: number;

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

@@ -33,8 +33,12 @@ export declare function usePluginSettingsForm(plugin: AdminPluginFeatures): {
                 group: string | null;
                 required: boolean;
                 is_set: boolean;
-                source: "default" | "stored" | "config" | "none";
+                source: "none" | "default" | "stored" | "config";
                 invalidates: string[];
+                hint: string | null;
+                placeholder: string | null;
+                width: "full" | "half";
+                section: string | null;
             } | {
                 type: "select";
                 options: {
@@ -49,12 +53,17 @@ export declare function usePluginSettingsForm(plugin: AdminPluginFeatures): {
                 group: string | null;
                 required: boolean;
                 is_set: boolean;
-                source: "default" | "stored" | "config" | "none";
+                source: "none" | "default" | "stored" | "config";
                 invalidates: string[];
+                hint: string | null;
+                placeholder: string | null;
+                width: "full" | "half";
+                section: string | null;
             } | {
                 type: "number";
                 min: number | null;
                 max: number | null;
+                integer: boolean;
                 default: number | null;
                 value: number | null;
                 key: string;
@@ -63,10 +72,14 @@ export declare function usePluginSettingsForm(plugin: AdminPluginFeatures): {
                 group: string | null;
                 required: boolean;
                 is_set: boolean;
-                source: "default" | "stored" | "config" | "none";
+                source: "none" | "default" | "stored" | "config";
                 invalidates: string[];
+                hint: string | null;
+                placeholder: string | null;
+                width: "full" | "half";
+                section: string | null;
             } | {
-                type: "string" | "boolean" | "color" | "url" | "image";
+                type: "string" | "boolean" | "color" | "image" | "url" | "date";
                 default: string | number | boolean | null;
                 value: string | number | boolean | null;
                 key: string;
@@ -75,8 +88,12 @@ export declare function usePluginSettingsForm(plugin: AdminPluginFeatures): {
                 group: string | null;
                 required: boolean;
                 is_set: boolean;
-                source: "default" | "stored" | "config" | "none";
+                source: "none" | "default" | "stored" | "config";
                 invalidates: string[];
+                hint: string | null;
+                placeholder: string | null;
+                width: "full" | "half";
+                section: string | null;
             })[];
             configured: boolean;
             missing: string[];
@@ -89,6 +106,24 @@ export declare function usePluginSettingsForm(plugin: AdminPluginFeatures): {
                 confirm: string | null;
             }[];
             admin_page: string | null;
+            icon: string | null;
+            summary: string | null;
+            disable_hint: string | null;
+            disable_confirm: string | null;
+            features_heading: string | null;
+            features_note: string | null;
+            all_off_warning: string | null;
+            require_enabled_feature: boolean;
+            setting_groups: {
+                name: string;
+                description: string | null;
+                note: string | null;
+                requires_feature: string | null;
+                visible_when: {
+                    setting: string;
+                    equals: string | boolean;
+                } | null;
+            }[];
         };
     }, Error, {
         expected_version: number;

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

@@ -0,0 +1,15 @@
+import type { AdminPluginFeatures } from "@hartl-services/medusa-food-supplements-contracts/types/plugin-features-admin";
+/**
+ * Plugin switch of the hub card and of the plugin page: switching ON saves at
+ * once, switching OFF asks for confirmation first (the descriptor's
+ * `disable_confirm`, else a generic text). Saves with the loaded `version`, so
+ * a concurrent change answers 409 and reloads. After the confirmation the
+ * plugin is read from the query cache again, so a save made while the dialog
+ * was open does not send a stale `version`. Feature switches save through
+ * `saveFeatures`.
+ */
+export declare function usePluginSwitch(plugin: AdminPluginFeatures): {
+    pending: boolean;
+    setEnabled: (enabled: boolean) => undefined;
+    setFeature: (key: string, enabled: boolean) => void;
+};