@hartl-services/medusa-base 0.2.0 → 0.4.0

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

@@ -0,0 +1,12 @@
+import type { AdminPluginFeatures } from "@hartl-services/medusa-food-supplements-contracts/types/plugin-features-admin";
+type PluginFeaturesCardProps = {
+    plugin: AdminPluginFeatures;
+    /** Heading of the card; the plugin label when omitted. */
+    title?: string;
+};
+/**
+ * Plugin switch (unless the plugin is not switchable) plus the feature
+ * switches of one plugin; saves immediately.
+ */
+export declare const PluginFeaturesCard: ({ plugin, title }: PluginFeaturesCardProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,34 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Container, Heading, Label, Switch, Text } from "@medusajs/ui";
+import { texts } from "../../../i18n/texts";
+import { useUpdatePluginFeatures } from "../hooks/usePluginFeatures";
+const configuredFeatures = (plugin) => Object.fromEntries(plugin.features.map((feature) => [feature.key, feature.enabled]));
+/**
+ * Plugin switch (unless the plugin is not switchable) plus the feature
+ * switches of one plugin; saves immediately.
+ */
+export const PluginFeaturesCard = ({ plugin, title }) => {
+    const mutation = useUpdatePluginFeatures();
+    const pending = mutation.isPending;
+    const labels = new Map(plugin.features.map((feature) => [feature.key, feature.label]));
+    const configured = configuredFeatures(plugin);
+    const pluginSwitchId = `plugin-features-${plugin.plugin_key}`;
+    const save = (enabled, features) => {
+        mutation.mutate({
+            plugin_key: plugin.plugin_key,
+            expected_version: plugin.version,
+            enabled,
+            features,
+        });
+    };
+    return (_jsxs(Container, { className: "divide-y p-0", "aria-busy": pending, children: [_jsxs("div", { className: "flex items-start justify-between gap-4 px-6 py-4", children: [_jsxs("div", { className: "min-w-0", children: [_jsx(Heading, { level: "h2", children: title ?? plugin.label }), title === undefined && plugin.description && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: plugin.description })), !plugin.enabled && (_jsx(Text, { size: "small", className: "text-ui-fg-muted mt-1", children: texts.hints.pluginDisabled })), pending && (_jsx(Text, { size: "small", className: "text-ui-fg-muted mt-1", children: texts.hints.saving }))] }), plugin.switchable && (_jsx(Switch, { id: pluginSwitchId, "aria-label": texts.plugin.switchLabel(plugin.label), className: "shrink-0", checked: plugin.enabled, disabled: pending, onCheckedChange: (checked) => save(checked === true, configured) }))] }), plugin.features.map((feature) => {
+                const switchId = `${pluginSwitchId}-${feature.key}`;
+                const parent = plugin.features.find((candidate) => candidate.key === feature.parent_key);
+                const parentOff = parent !== undefined && !parent.enabled;
+                const locked = pending || !plugin.enabled || parentOff;
+                return (_jsxs("div", { className: `flex items-start justify-between gap-4 py-3 pr-6 ${feature.parent_key ? "pl-12" : "pl-6"}`, children: [_jsxs("div", { className: "min-w-0", children: [_jsx(Label, { htmlFor: switchId, size: "small", weight: "plus", className: locked ? "text-ui-fg-disabled" : undefined, children: feature.label }), feature.description && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: feature.description })), plugin.enabled && parentOff && feature.parent_key && (_jsx(Text, { size: "small", className: "text-ui-fg-muted mt-1", children: texts.hints.parentDisabled(labels.get(feature.parent_key) ?? feature.parent_key) }))] }), _jsx(Switch, { id: switchId, className: "shrink-0", checked: feature.enabled, disabled: locked, onCheckedChange: (checked) => save(plugin.enabled, {
+                                ...configured,
+                                [feature.key]: checked === true,
+                            }) })] }, feature.key));
+            })] }));
+};

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

@@ -0,0 +1,5 @@
+/**
+ * Hub: one card per installed plugin. Plugins that cannot be switched off
+ * (the shop master data) come first; the rest keep the server's order.
+ */
+export declare const PluginFeaturesSettingsPage: () => import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,16 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Container, Heading, Text } from "@medusajs/ui";
+import { texts } from "../../../i18n/texts";
+import { usePluginFeatures } from "../hooks/usePluginFeatures";
+import { PluginHubCard } from "./PluginHubCard";
+/**
+ * Hub: one card per installed plugin. Plugins that cannot be switched off
+ * (the shop master data) come first; the rest keep the server's order.
+ */
+export const PluginFeaturesSettingsPage = () => {
+    const query = usePluginFeatures();
+    return (_jsxs("div", { className: "flex flex-col gap-y-3", children: [_jsxs(Container, { className: "px-6 py-4", children: [_jsx(Heading, { level: "h1", children: texts.page.title }), _jsx(Text, { className: "text-ui-fg-subtle", children: texts.page.description })] }), query.isPending ? (_jsx(Container, { children: _jsx(Text, { className: "text-ui-fg-subtle", children: texts.states.loading }) })) : query.isError ? (_jsxs(Container, { className: "flex flex-wrap items-center justify-between gap-3", children: [_jsx(Text, { className: "text-ui-fg-error", children: texts.states.error }), _jsx(Button, { size: "small", variant: "secondary", isLoading: query.isFetching, onClick: () => void query.refetch(), children: texts.states.retry })] })) : query.data.plugins.length === 0 ? (_jsx(Container, { children: _jsx(Text, { className: "text-ui-fg-subtle", children: texts.states.empty }) })) : ([
+                ...query.data.plugins.filter((plugin) => !plugin.switchable),
+                ...query.data.plugins.filter((plugin) => plugin.switchable),
+            ].map((plugin) => (_jsx(PluginHubCard, { plugin: plugin }, plugin.plugin_key))))] }));
+};

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

@@ -0,0 +1,7 @@
+import type { AdminPluginFeatures } from "@hartl-services/medusa-food-supplements-contracts/types/plugin-features-admin";
+type PluginHubCardProps = {
+    plugin: AdminPluginFeatures;
+};
+/** One plugin on the hub: status, plugin switch and the link to its page. */
+export declare const PluginHubCard: ({ plugin }: PluginHubCardProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Container, Heading, Switch, Text } from "@medusajs/ui";
+import { Link } from "react-router-dom";
+import { texts } from "../../../i18n/texts";
+import { useUpdatePluginFeatures } from "../hooks/usePluginFeatures";
+import { pluginDetailPath } from "../lib/plugin-paths";
+import { PluginStatusChips } from "./PluginStatusChips";
+/** One plugin on the hub: status, plugin switch and the link to its page. */
+export const PluginHubCard = ({ plugin }) => {
+    const mutation = useUpdatePluginFeatures();
+    const pending = mutation.isPending;
+    const toggle = (enabled) => {
+        mutation.mutate({
+            plugin_key: plugin.plugin_key,
+            expected_version: plugin.version,
+            enabled,
+            features: Object.fromEntries(plugin.features.map((feature) => [feature.key, feature.enabled])),
+        });
+    };
+    return (_jsxs(Container, { className: "flex flex-wrap items-start justify-between gap-4 px-6 py-4", "aria-busy": pending, children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx(Heading, { level: "h2", children: plugin.label }), plugin.description && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: plugin.description })), _jsx(PluginStatusChips, { plugin: plugin }), pending && (_jsx(Text, { size: "small", className: "text-ui-fg-muted mt-1", children: texts.hints.saving }))] }), _jsxs("div", { className: "flex shrink-0 items-center gap-3", children: [plugin.switchable && (_jsx(Switch, { "aria-label": texts.plugin.switchLabel(plugin.label), checked: plugin.enabled, disabled: pending, onCheckedChange: (checked) => toggle(checked === true) })), _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.plugin.open }) })] })] }));
+};

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

@@ -0,0 +1,13 @@
+import type { ReactNode } from "react";
+type PluginPageShellProps = {
+    pluginKey: string;
+    /** Rendered below the header once the plugin is loaded. */
+    children?: ReactNode;
+};
+/**
+ * Frame of a plugin's page: back link to the hub, the plugin's label,
+ * description and status, then `children`. Shows loading, not-installed and
+ * error states instead of `children`.
+ */
+export declare const PluginPageShell: ({ pluginKey, children }: PluginPageShellProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,20 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button, Container, Heading, Text } from "@medusajs/ui";
+import { Link } from "react-router-dom";
+import { texts } from "../../../i18n/texts";
+import { usePluginFeature } from "../hooks/usePluginFeatures";
+import { PLUGIN_HUB_PATH } from "../lib/plugin-paths";
+import { PluginStatusChips } from "./PluginStatusChips";
+const isNotFound = (error) => typeof error === "object" &&
+    error !== null &&
+    error.status === 404;
+/**
+ * Frame of a plugin's page: back link to the hub, the plugin's label,
+ * description and status, then `children`. Shows loading, not-installed and
+ * error states instead of `children`.
+ */
+export const PluginPageShell = ({ pluginKey, children }) => {
+    const query = usePluginFeature(pluginKey);
+    const plugin = query.data?.plugin;
+    return (_jsxs("div", { className: "flex flex-col gap-y-3", children: [_jsx("div", { children: _jsxs(Link, { to: PLUGIN_HUB_PATH, className: "text-ui-fg-subtle hover:text-ui-fg-base txt-compact-small-plus", children: ["\u2190 ", texts.detail.back] }) }), plugin ? (_jsxs(_Fragment, { children: [_jsxs(Container, { className: "px-6 py-4", children: [_jsx(Heading, { level: "h1", children: plugin.label }), plugin.description && (_jsx(Text, { className: "text-ui-fg-subtle", children: plugin.description })), _jsx(PluginStatusChips, { plugin: plugin })] }), children] })) : query.isPending ? (_jsx(Container, { children: _jsx(Text, { className: "text-ui-fg-subtle", children: texts.states.loading }) })) : isNotFound(query.error) ? (_jsx(Container, { children: _jsx(Text, { className: "text-ui-fg-subtle", children: texts.states.notFound }) })) : (_jsxs(Container, { className: "flex flex-wrap items-center justify-between gap-3", children: [_jsx(Text, { className: "text-ui-fg-error", children: texts.states.error }), _jsx(Button, { size: "small", variant: "secondary", isLoading: query.isFetching, onClick: () => void query.refetch(), children: texts.states.retry })] }))] }));
+};

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

@@ -0,0 +1,7 @@
+import type { AdminPluginFeatures } from "@hartl-services/medusa-food-supplements-contracts/types/plugin-features-admin";
+type PluginSettingsFormProps = {
+    plugin: AdminPluginFeatures;
+};
+export declare const missingLabels: (plugin: AdminPluginFeatures) => string;
+export declare const PluginSettingsForm: ({ plugin }: PluginSettingsFormProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,39 @@
+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";
+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)
+    .join(", ");
+/** "API-Key, Passwort" for the secrets a change of `setting` deletes. */
+const invalidatesLabels = (plugin, setting) => setting.invalidates
+    .map((key) => plugin.settings.find((candidate) => candidate.key === key)?.label ?? key)
+    .join(", ");
+/** "Zwischen 0 und 100." etc.; `undefined` without bounds. */
+const boundsText = (setting) => setting.min !== null && setting.max !== null
+    ? texts.settings.numberRange(setting.min, setting.max)
+    : setting.min !== null
+        ? texts.settings.numberMin(setting.min)
+        : setting.max !== null
+            ? texts.settings.numberMax(setting.max)
+            : undefined;
+const SettingField = ({ pluginKey, setting, invalidatesLabels, value, invalid, disabled, onChange, }) => {
+    const id = fieldId(pluginKey, setting.key);
+    const hintId = `${id}-hint`;
+    const clearPending = setting.type === "secret" && value === null;
+    const bounds = setting.type === "number" ? boundsText(setting) : undefined;
+    return (_jsxs("div", { className: "grid gap-2", children: [_jsxs("div", { className: "flex items-center justify-between gap-3", children: [_jsxs(Label, { htmlFor: id, size: "small", weight: "plus", children: [setting.label, setting.required && (_jsxs("span", { className: "text-ui-fg-muted", children: [" (", texts.settings.required, ")"] }))] }), _jsx(Text, { size: "xsmall", className: "text-ui-fg-muted shrink-0", children: texts.settings.source[setting.source] })] }), setting.type === "boolean" ? (_jsx(Switch, { id: id, "aria-describedby": hintId, checked: value === true, disabled: disabled, onCheckedChange: (checked) => onChange(checked === true) })) : setting.type === "secret" ? (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Input, { id: id, "aria-describedby": hintId, className: "flex-1", type: "password", autoComplete: "new-password", placeholder: setting.is_set ? texts.settings.secretPlaceholder : "", 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": 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 }))] })] }));
+};
+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");
+    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/components/PluginStatusChips.d.ts

@@ -0,0 +1,5 @@
+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. */
+export declare const PluginStatusChips: ({ plugin }: {
+    plugin: AdminPluginFeatures;
+}) => import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,8 @@
+import { jsx as _jsx, 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)) }))] }));

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

@@ -0,0 +1,114 @@
+import type { AdminPluginFeaturesListResponse } from "@hartl-services/medusa-food-supplements-contracts/types/plugin-features-admin";
+export type PluginFeatureEnabledState = {
+    /** `false` while loading and on error, so gated UI never flashes. */
+    enabled: boolean;
+    isPending: boolean;
+    isError: boolean;
+};
+/** Widgets re-read the toggles at most every 30 s (hub saves update at once). */
+export declare const PLUGIN_FEATURE_ENABLED_STALE_TIME = 30000;
+/**
+ * Like the server's `isPluginFeatureEnabled`: the plugin switch and every
+ * given key must be effective; an unknown plugin or key is `false`.
+ */
+export declare const isPluginFeatureEnabledIn: (data: AdminPluginFeaturesListResponse, pluginKey: string, featureKeys: readonly string[]) => boolean;
+/**
+ * Query options shared with the hub's list (`GET /admin/plugin-features`,
+ * same key), so the hub's toggle mutations update gated widgets too.
+ */
+export declare const pluginFeatureEnabledQueryOptions: (pluginKey: string, featureKeys: readonly string[]) => {
+    queryKey: readonly ["plugin-features", "list"];
+    queryFn: () => Promise<{
+        plugins: {
+            plugin_key: string;
+            label: string;
+            description: string | null;
+            default_enabled: boolean;
+            switchable: boolean;
+            enabled: boolean;
+            version: number;
+            features: {
+                key: string;
+                label: string;
+                description: string | null;
+                parent_key: string | null;
+                default_enabled: boolean;
+                enabled: boolean;
+                effective_enabled: boolean;
+            }[];
+            settings: ({
+                type: "secret";
+                key: string;
+                label: string;
+                description: string | null;
+                required: boolean;
+                is_set: boolean;
+                source: "default" | "stored" | "config" | "none";
+                invalidates: string[];
+            } | {
+                type: "select";
+                options: {
+                    value: string;
+                    label: string;
+                }[];
+                default: string | null;
+                value: string | null;
+                key: string;
+                label: string;
+                description: string | null;
+                required: boolean;
+                is_set: boolean;
+                source: "default" | "stored" | "config" | "none";
+                invalidates: string[];
+            } | {
+                type: "number";
+                min: number | null;
+                max: number | null;
+                default: number | null;
+                value: number | null;
+                key: string;
+                label: string;
+                description: string | null;
+                required: boolean;
+                is_set: boolean;
+                source: "default" | "stored" | "config" | "none";
+                invalidates: string[];
+            } | {
+                type: "string" | "boolean" | "url";
+                default: string | number | boolean | null;
+                value: string | number | boolean | null;
+                key: string;
+                label: string;
+                description: string | null;
+                required: boolean;
+                is_set: boolean;
+                source: "default" | "stored" | "config" | "none";
+                invalidates: string[];
+            })[];
+            configured: boolean;
+            missing: string[];
+            settings_version: number;
+            actions: {
+                key: string;
+                label: string;
+                description: string | null;
+                mode: "sync" | "background";
+                confirm: string | null;
+            }[];
+            admin_page: string | null;
+        }[];
+    }>;
+    staleTime: number;
+    select: (data: AdminPluginFeaturesListResponse) => boolean;
+};
+export declare const toPluginFeatureEnabledState: (result: {
+    data: boolean | undefined;
+    isPending: boolean;
+    isError: boolean;
+}) => PluginFeatureEnabledState;
+/**
+ * Whether a plugin (and optionally some of its features) is effectively on,
+ * for hiding widgets and pages of a disabled feature. No keys = plugin
+ * switch only; several keys = all must be on.
+ */
+export declare function usePluginFeatureEnabled(pluginKey: string, ...featureKeys: string[]): PluginFeatureEnabledState;

package/dist/admin-components/features/plugin-features/hooks/usePluginFeatureEnabled.js

@@ -0,0 +1,40 @@
+import { useQuery } from "@tanstack/react-query";
+import { listPluginFeatures } from "../lib/plugin-features-admin-client";
+import { pluginFeatureKeys } from "../queries/pluginFeatureKeys";
+/** Widgets re-read the toggles at most every 30 s (hub saves update at once). */
+export const PLUGIN_FEATURE_ENABLED_STALE_TIME = 30_000;
+/**
+ * Like the server's `isPluginFeatureEnabled`: the plugin switch and every
+ * given key must be effective; an unknown plugin or key is `false`.
+ */
+export const isPluginFeatureEnabledIn = (data, pluginKey, featureKeys) => {
+    const plugin = data.plugins.find((entry) => entry.plugin_key === pluginKey);
+    if (!plugin?.enabled) {
+        return false;
+    }
+    return featureKeys.every((key) => plugin.features.find((feature) => feature.key === key)
+        ?.effective_enabled === true);
+};
+/**
+ * Query options shared with the hub's list (`GET /admin/plugin-features`,
+ * same key), so the hub's toggle mutations update gated widgets too.
+ */
+export const pluginFeatureEnabledQueryOptions = (pluginKey, featureKeys) => ({
+    queryKey: pluginFeatureKeys.list(),
+    queryFn: listPluginFeatures,
+    staleTime: PLUGIN_FEATURE_ENABLED_STALE_TIME,
+    select: (data) => isPluginFeatureEnabledIn(data, pluginKey, featureKeys),
+});
+export const toPluginFeatureEnabledState = (result) => ({
+    enabled: !result.isPending && !result.isError && result.data === true,
+    isPending: result.isPending,
+    isError: result.isError,
+});
+/**
+ * Whether a plugin (and optionally some of its features) is effectively on,
+ * for hiding widgets and pages of a disabled feature. No keys = plugin
+ * switch only; several keys = all must be on.
+ */
+export function usePluginFeatureEnabled(pluginKey, ...featureKeys) {
+    return toPluginFeatureEnabledState(useQuery(pluginFeatureEnabledQueryOptions(pluginKey, featureKeys)));
+}