@jini-ai/admin 0.4.2 → 0.4.3

package/dist/redirects/react/hooks/use-redirects.hooks.js

@@ -0,0 +1,63 @@
+import { useCallback, useEffect, useRef } from 'react';
+import { useFetchQuery, useFetchMutation, useInvalidate } from '@jini-ai/ui/fetch-query';
+import { buildAgentListHandles } from '@jini-ai/agentic';
+import { useController } from '../../../core/react/use-controller.js';
+import { createRedirectsController } from '../../controllers/redirects.controller.js';
+import { KEYS, buildCreateRedirectPayload, nextRedirectStatus, firstWriteError, isAnyWritePending, visibleRedirectsError } from '../../rules.js';
+import { translateRedirectsEn } from '../../messages.en.js';
+/** Preserve the fetch-query pilot's cache/invalidation lifecycle and first-load-only screen guard.
+ * One list read, three independent writes, the same error precedence and no form reset on failure.
+ * Localization arrives once from the host, preventing N independent settings reads per table row.
+ */
+export function useRedirects({ api }, { t = translateRedirectsEn, locale = 'en', events } = {}) {
+    const list = useFetchQuery({ key: KEYS.list, fetch: () => api.listRedirects({}) });
+    const invalidate = useInvalidate();
+    const invalidateList = useCallback(() => invalidate({ key: KEYS.list }), [invalidate]);
+    useEffect(() => events?.subscribe(invalidateList), [events, invalidateList]);
+    // Writes name their cache rather than calling a loader. Other views of the key refresh too,
+    // and background reads keep the last successful table on screen.
+    const createRule = useFetchMutation({ run: ({ input: form }) => api.createRedirect(buildCreateRedirectPayload({ form })) }, { invalidates: [KEYS.list] });
+    const toggleStatus = useFetchMutation({ run: ({ input: rule }) => api.updateRedirect({ id: rule.id }, { status: nextRedirectStatus({ currentStatus: rule.status }) }) }, { invalidates: [KEYS.list] });
+    const removeRule = useFetchMutation({ run: ({ input: rule }) => api.tombstoneRedirect({ id: rule.id }) }, { invalidates: [KEYS.list] });
+    const writes = [createRule, toggleStatus, removeRule];
+    const saving = isAnyWritePending({ writes });
+    const error = visibleRedirectsError({ writeError: firstWriteError({ writes }), saving, listError: list.error });
+    const actions = useRef(null);
+    actions.current = {
+        saving,
+        create: form => createRule.mutate({ input: form }),
+        toggle: rule => toggleStatus.mutate({ input: rule }),
+        remove: rule => removeRule.mutate({ input: rule }),
+        resetOthers(active) {
+            const activeWrite = { create: createRule, toggle: toggleStatus, remove: removeRule }[active];
+            // A new write used to clear one shared error. Reset siblings so an earlier create failure
+            // cannot blame a later successful toggle merely because create is first in the array.
+            for (const write of writes)
+                if (write !== activeWrite)
+                    write.reset();
+        },
+    };
+    const { controller, snapshot } = useController({ create: () => createRedirectsController({ actions: () => actions.current }), dependencies: [] });
+    const redirects = list.data;
+    const createRedirect = (form) => controller?.createRedirect({ form }) ?? Promise.resolve(false);
+    function submitCreate(e) {
+        e.preventDefault();
+        // Capture synchronously: React clears currentTarget after dispatch. Reset only on success.
+        const form = e.currentTarget;
+        void createRedirect(new FormData(form)).then(succeeded => { if (succeeded)
+            form.reset(); });
+    }
+    return {
+        redirects, listStatus: list.status, listError: list.error, error, saving,
+        pendingDelete: snapshot?.pendingDelete ?? null,
+        setPendingDelete: (rule) => controller?.setPendingDelete({ rule }),
+        confirmDelete: () => controller?.confirmDelete(), deletePending: removeRule.status === 'pending',
+        createRedirect, submitCreate,
+        onToggleStatus: (rule) => controller?.onToggleStatus({ rule }),
+        onRequestDelete: (rule) => controller?.onRequestDelete({ rule }),
+        t, locale,
+        // Stable, unique ids disambiguate every row's action menu and lazy hits button.
+        rowMenuHandles: buildAgentListHandles({ prefix: 'redirects-row', ids: (redirects ?? []).map(rule => rule.id) }),
+    };
+}
+//# sourceMappingURL=use-redirects.hooks.js.map

package/dist/redirects/react/hooks/wired.hooks.d.ts

@@ -0,0 +1,55 @@
+import type { ChangeEvent } from 'react';
+import type { AdminRedirectImportFailure } from '../../../core/ports/redirects.js';
+import type { RedirectsTranslate } from '../../models.js';
+/** Resolve localization once for the list; every row receives that bound translator. */
+export declare function useWiredRedirects(_required?: Record<string, never>, _optional?: {}): {
+    redirects: readonly import("../../index.js").AdminRedirect[] | undefined;
+    listStatus: import("@jini-ai/ui").QueryStatus;
+    listError: Error | null;
+    error: Error | null;
+    saving: boolean;
+    pendingDelete: import("../../index.js").AdminRedirect | null;
+    setPendingDelete: (rule: import("../../index.js").AdminRedirect | null) => void | undefined;
+    confirmDelete: () => void | undefined;
+    deletePending: boolean;
+    createRedirect: (form: FormData) => Promise<boolean>;
+    submitCreate: (e: import("react").FormEvent<HTMLFormElement>) => void;
+    onToggleStatus: (rule: import("../../index.js").AdminRedirect) => void | undefined;
+    onRequestDelete: (rule: import("../../index.js").AdminRedirect) => void | undefined;
+    t: RedirectsTranslate;
+    locale: string;
+    rowMenuHandles: string[];
+};
+/** Hit counts stay gesture-gated and use the same scoped resource port as list and import. */
+export declare function useWiredHitCountCell({ redirectId, t }: {
+    redirectId: string;
+    t: RedirectsTranslate;
+}, _optional?: {}): {
+    error: Error | null;
+    data: {
+        data: import("../../index.js").AdminRedirectHitStats;
+    } | undefined;
+    isFetching: boolean;
+    request: () => void | undefined;
+    t: RedirectsTranslate;
+};
+/** Derive copy and input handlers outside TSX. Partial results remain individual created/failed rows. */
+export declare function useWiredImportRedirectsForm({ t, locale }: {
+    t: RedirectsTranslate;
+    locale: string;
+}, _optional?: {}): {
+    changeRaw: (event: ChangeEvent<HTMLTextAreaElement>) => void | undefined;
+    rulesLabel: import("react").ReactNode;
+    resultSummary: string;
+    createdText: string;
+    failedLabel: (failure: AdminRedirectImportFailure) => string;
+    raw: string;
+    setRaw: (raw: string) => void | undefined;
+    error: string | null;
+    result: import("../../index.js").AdminRedirectImportResult | null;
+    importing: boolean;
+    submit: (e: import("react").FormEvent) => Promise<void>;
+    t: RedirectsTranslate;
+    locale: string;
+};
+//# sourceMappingURL=wired.hooks.d.ts.map

package/dist/redirects/react/hooks/wired.hooks.js

@@ -0,0 +1,31 @@
+import { createElement } from 'react';
+import { useRedirectsPorts } from './RedirectsPorts.hooks.js';
+import { useRedirectsOptions } from './RedirectsOptions.hooks.js';
+import { useRedirects } from './use-redirects.hooks.js';
+import { useHitCountCell } from './use-hit-count-cell.hooks.js';
+import { useImportRedirectsForm } from './use-import-redirects-form.hooks.js';
+/** Resolve localization once for the list; every row receives that bound translator. */
+export function useWiredRedirects(_required = {}, _optional = {}) {
+    const { redirectsApi: api, redirectsEvents: events } = useRedirectsPorts();
+    const { t, locale } = useRedirectsOptions();
+    return useRedirects({ api }, { t, locale, ...(events ? { events } : {}) });
+}
+/** Hit counts stay gesture-gated and use the same scoped resource port as list and import. */
+export function useWiredHitCountCell({ redirectId, t }, _optional = {}) {
+    const { redirectsApi: api } = useRedirectsPorts();
+    return useHitCountCell({ redirectId, api }, { t });
+}
+/** Derive copy and input handlers outside TSX. Partial results remain individual created/failed rows. */
+export function useWiredImportRedirectsForm({ t, locale }, _optional = {}) {
+    const { redirectsApi: api } = useRedirectsPorts();
+    const { renderMessage } = useRedirectsOptions();
+    const form = useImportRedirectsForm({ api }, { t, locale });
+    return { ...form,
+        changeRaw: (event) => form.setRaw(event.target.value),
+        rulesLabel: renderMessage({ key: 'importRulesLabel', shapeCode: createElement('code', { key: 'shape' }, '{matchType, fromPattern, toTarget, statusCode, override?, priority?}') }),
+        resultSummary: form.result ? t('{created} created, {failed} failed.', { created: form.result.created.length, failed: form.result.failed.length }) : '',
+        createdText: t('Created'),
+        failedLabel: (failure) => t('Item {index} ({code})', { index: failure.index, code: failure.code }),
+    };
+}
+//# sourceMappingURL=wired.hooks.js.map

package/dist/redirects/react/index.d.ts

@@ -0,0 +1,316 @@
+import type { RedirectsReactOptions } from './hooks/RedirectsOptions.hooks.js';
+export type { RedirectsReactOptions, RedirectsRenderMessageInput } from './hooks/RedirectsOptions.hooks.js';
+export { useRedirectsPorts } from './hooks/RedirectsPorts.hooks.js';
+export { useRedirects } from './hooks/use-redirects.hooks.js';
+export { useHitCountCell } from './hooks/use-hit-count-cell.hooks.js';
+export { useImportRedirectsForm } from './hooks/use-import-redirects-form.hooks.js';
+/** Instance-scoped options and lazy list page; host supplies publish action and localized markup.
+ * @example redirects({}, { t, headerActions, slots: { renderMessage } });
+ */
+export declare function redirects(_required: Record<string, never>, options?: RedirectsReactOptions): {
+    id: "redirects";
+    requires: {
+        readonly redirectsApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminRedirectsPort, "admin.redirects.api">;
+    };
+    optional: {
+        readonly redirectsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").RedirectsEventsPort, "admin.redirects.events">;
+    };
+    messages: {
+        readonly "Loading\u2026": "Loading…";
+        readonly "Load hits": "Load hits";
+        readonly "Bulk import": "Bulk import";
+        readonly "rule objects (1-500 items)": "rule objects (1-500 items)";
+        readonly "Importing\u2026": "Importing…";
+        readonly Import: "Import";
+        readonly Marketing: "Marketing";
+        readonly Redirects: "Redirects";
+        readonly "Manual URL redirect rules. Rules created automatically from a slug change (source": "Manual URL redirect rules. Rules created automatically from a slug change (source";
+        readonly ") also show up here.": ") also show up here.";
+        readonly "Match type": "Match type";
+        readonly "From path": "From path";
+        readonly "To target": "To target";
+        readonly "Status code": "Status code";
+        readonly "301 (permanent)": "301 (permanent)";
+        readonly "302 (temporary)": "302 (temporary)";
+        readonly "307 (temporary, method-preserving)": "307 (temporary, method-preserving)";
+        readonly "308 (permanent, method-preserving)": "308 (permanent, method-preserving)";
+        readonly "Add redirect": "Add redirect";
+        readonly "No redirect rules yet.": "No redirect rules yet.";
+        readonly From: "From";
+        readonly To: "To";
+        readonly Type: "Type";
+        readonly Code: "Code";
+        readonly Source: "Source";
+        readonly Hits: "Hits";
+        readonly "Delete redirect rule?": "Delete redirect rule?";
+        readonly "Loading redirects\u2026": "Loading redirects…";
+        readonly "Not valid JSON.": "Not valid JSON.";
+        readonly "Must be a JSON array of rule objects.": "Must be a JSON array of rule objects.";
+        readonly exact: "exact";
+        readonly prefix: "prefix";
+        readonly wildcard: "wildcard";
+        readonly Status: "Status";
+        readonly More: "More";
+        readonly Delete: "Delete";
+        readonly Disable: "Disable";
+        readonly Enable: "Enable";
+        readonly "Saving\u2026": "Saving…";
+        readonly Created: "Created";
+        readonly active: "active";
+        readonly disabled: "disabled";
+        readonly "{created} created, {failed} failed.": "{created} created, {failed} failed.";
+        readonly "Item {index} ({code})": "Item {index} ({code})";
+        readonly "Actions for redirect rule from \"{fromPattern}\"": "Actions for redirect rule from \"{fromPattern}\"";
+        readonly "Paste a JSON array of ": "Paste a JSON array of ";
+        readonly " rule objects (1-500 items)": " rule objects (1-500 items)";
+        readonly "Delete the redirect rule from \"": "Delete the redirect rule from \"";
+        readonly "\"?": "\"?";
+    };
+    pages: {
+        readonly list: {
+            readonly path: "/redirects";
+            readonly label: "Redirects";
+            readonly permissions: readonly ["admin.redirects.manage"];
+            readonly agentReachable: true;
+            readonly nav: {
+                readonly group: "marketing";
+                readonly icon: "arrow-right";
+            };
+            readonly tabs: {};
+        };
+    };
+} & {
+    react: {
+        Provider: ({ admin, children, options: currentOptions }: Parameters<({ admin, children }: {
+            admin: import("../../core/module/types.js").AdminInstance;
+            children: import("react").ReactNode;
+        }, _optional?: Record<string, never>) => import("react").FunctionComponentElement<import("react").ProviderProps<import("../../core/module/types.js").ScopedPorts<{
+            readonly id: "redirects";
+            readonly requires: {
+                readonly redirectsApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminRedirectsPort, "admin.redirects.api">;
+            };
+            readonly optional: {
+                readonly redirectsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").RedirectsEventsPort, "admin.redirects.events">;
+            };
+            readonly messages: {
+                readonly "Loading\u2026": "Loading…";
+                readonly "Load hits": "Load hits";
+                readonly "Bulk import": "Bulk import";
+                readonly "rule objects (1-500 items)": "rule objects (1-500 items)";
+                readonly "Importing\u2026": "Importing…";
+                readonly Import: "Import";
+                readonly Marketing: "Marketing";
+                readonly Redirects: "Redirects";
+                readonly "Manual URL redirect rules. Rules created automatically from a slug change (source": "Manual URL redirect rules. Rules created automatically from a slug change (source";
+                readonly ") also show up here.": ") also show up here.";
+                readonly "Match type": "Match type";
+                readonly "From path": "From path";
+                readonly "To target": "To target";
+                readonly "Status code": "Status code";
+                readonly "301 (permanent)": "301 (permanent)";
+                readonly "302 (temporary)": "302 (temporary)";
+                readonly "307 (temporary, method-preserving)": "307 (temporary, method-preserving)";
+                readonly "308 (permanent, method-preserving)": "308 (permanent, method-preserving)";
+                readonly "Add redirect": "Add redirect";
+                readonly "No redirect rules yet.": "No redirect rules yet.";
+                readonly From: "From";
+                readonly To: "To";
+                readonly Type: "Type";
+                readonly Code: "Code";
+                readonly Source: "Source";
+                readonly Hits: "Hits";
+                readonly "Delete redirect rule?": "Delete redirect rule?";
+                readonly "Loading redirects\u2026": "Loading redirects…";
+                readonly "Not valid JSON.": "Not valid JSON.";
+                readonly "Must be a JSON array of rule objects.": "Must be a JSON array of rule objects.";
+                readonly exact: "exact";
+                readonly prefix: "prefix";
+                readonly wildcard: "wildcard";
+                readonly Status: "Status";
+                readonly More: "More";
+                readonly Delete: "Delete";
+                readonly Disable: "Disable";
+                readonly Enable: "Enable";
+                readonly "Saving\u2026": "Saving…";
+                readonly Created: "Created";
+                readonly active: "active";
+                readonly disabled: "disabled";
+                readonly "{created} created, {failed} failed.": "{created} created, {failed} failed.";
+                readonly "Item {index} ({code})": "Item {index} ({code})";
+                readonly "Actions for redirect rule from \"{fromPattern}\"": "Actions for redirect rule from \"{fromPattern}\"";
+                readonly "Paste a JSON array of ": "Paste a JSON array of ";
+                readonly " rule objects (1-500 items)": " rule objects (1-500 items)";
+                readonly "Delete the redirect rule from \"": "Delete the redirect rule from \"";
+                readonly "\"?": "\"?";
+            };
+            readonly pages: {
+                readonly list: {
+                    readonly path: "/redirects";
+                    readonly label: "Redirects";
+                    readonly permissions: readonly ["admin.redirects.manage"];
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "marketing";
+                        readonly icon: "arrow-right";
+                    };
+                    readonly tabs: {};
+                };
+            };
+        }> | null>>>[0] & {
+            options?: RedirectsReactOptions;
+        }) => import("react").FunctionComponentElement<import("react").ProviderProps<RedirectsReactOptions>>;
+        module: {
+            readonly id: "redirects";
+            readonly requires: {
+                readonly redirectsApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminRedirectsPort, "admin.redirects.api">;
+            };
+            readonly optional: {
+                readonly redirectsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").RedirectsEventsPort, "admin.redirects.events">;
+            };
+            readonly messages: {
+                readonly "Loading\u2026": "Loading…";
+                readonly "Load hits": "Load hits";
+                readonly "Bulk import": "Bulk import";
+                readonly "rule objects (1-500 items)": "rule objects (1-500 items)";
+                readonly "Importing\u2026": "Importing…";
+                readonly Import: "Import";
+                readonly Marketing: "Marketing";
+                readonly Redirects: "Redirects";
+                readonly "Manual URL redirect rules. Rules created automatically from a slug change (source": "Manual URL redirect rules. Rules created automatically from a slug change (source";
+                readonly ") also show up here.": ") also show up here.";
+                readonly "Match type": "Match type";
+                readonly "From path": "From path";
+                readonly "To target": "To target";
+                readonly "Status code": "Status code";
+                readonly "301 (permanent)": "301 (permanent)";
+                readonly "302 (temporary)": "302 (temporary)";
+                readonly "307 (temporary, method-preserving)": "307 (temporary, method-preserving)";
+                readonly "308 (permanent, method-preserving)": "308 (permanent, method-preserving)";
+                readonly "Add redirect": "Add redirect";
+                readonly "No redirect rules yet.": "No redirect rules yet.";
+                readonly From: "From";
+                readonly To: "To";
+                readonly Type: "Type";
+                readonly Code: "Code";
+                readonly Source: "Source";
+                readonly Hits: "Hits";
+                readonly "Delete redirect rule?": "Delete redirect rule?";
+                readonly "Loading redirects\u2026": "Loading redirects…";
+                readonly "Not valid JSON.": "Not valid JSON.";
+                readonly "Must be a JSON array of rule objects.": "Must be a JSON array of rule objects.";
+                readonly exact: "exact";
+                readonly prefix: "prefix";
+                readonly wildcard: "wildcard";
+                readonly Status: "Status";
+                readonly More: "More";
+                readonly Delete: "Delete";
+                readonly Disable: "Disable";
+                readonly Enable: "Enable";
+                readonly "Saving\u2026": "Saving…";
+                readonly Created: "Created";
+                readonly active: "active";
+                readonly disabled: "disabled";
+                readonly "{created} created, {failed} failed.": "{created} created, {failed} failed.";
+                readonly "Item {index} ({code})": "Item {index} ({code})";
+                readonly "Actions for redirect rule from \"{fromPattern}\"": "Actions for redirect rule from \"{fromPattern}\"";
+                readonly "Paste a JSON array of ": "Paste a JSON array of ";
+                readonly " rule objects (1-500 items)": " rule objects (1-500 items)";
+                readonly "Delete the redirect rule from \"": "Delete the redirect rule from \"";
+                readonly "\"?": "\"?";
+            };
+            readonly pages: {
+                readonly list: {
+                    readonly path: "/redirects";
+                    readonly label: "Redirects";
+                    readonly permissions: readonly ["admin.redirects.manage"];
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "marketing";
+                        readonly icon: "arrow-right";
+                    };
+                    readonly tabs: {};
+                };
+            };
+        };
+        pages: {
+            readonly list: {
+                Page: import("react").LazyExoticComponent<import("react").ComponentType<import("../../react/bind-react.js").ModulePageProps>>;
+                tabs: {};
+            };
+        };
+        usePorts: (_required?: Record<string, never>, _optional?: Record<string, never>) => import("../../core/module/types.js").ScopedPorts<{
+            readonly id: "redirects";
+            readonly requires: {
+                readonly redirectsApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminRedirectsPort, "admin.redirects.api">;
+            };
+            readonly optional: {
+                readonly redirectsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").RedirectsEventsPort, "admin.redirects.events">;
+            };
+            readonly messages: {
+                readonly "Loading\u2026": "Loading…";
+                readonly "Load hits": "Load hits";
+                readonly "Bulk import": "Bulk import";
+                readonly "rule objects (1-500 items)": "rule objects (1-500 items)";
+                readonly "Importing\u2026": "Importing…";
+                readonly Import: "Import";
+                readonly Marketing: "Marketing";
+                readonly Redirects: "Redirects";
+                readonly "Manual URL redirect rules. Rules created automatically from a slug change (source": "Manual URL redirect rules. Rules created automatically from a slug change (source";
+                readonly ") also show up here.": ") also show up here.";
+                readonly "Match type": "Match type";
+                readonly "From path": "From path";
+                readonly "To target": "To target";
+                readonly "Status code": "Status code";
+                readonly "301 (permanent)": "301 (permanent)";
+                readonly "302 (temporary)": "302 (temporary)";
+                readonly "307 (temporary, method-preserving)": "307 (temporary, method-preserving)";
+                readonly "308 (permanent, method-preserving)": "308 (permanent, method-preserving)";
+                readonly "Add redirect": "Add redirect";
+                readonly "No redirect rules yet.": "No redirect rules yet.";
+                readonly From: "From";
+                readonly To: "To";
+                readonly Type: "Type";
+                readonly Code: "Code";
+                readonly Source: "Source";
+                readonly Hits: "Hits";
+                readonly "Delete redirect rule?": "Delete redirect rule?";
+                readonly "Loading redirects\u2026": "Loading redirects…";
+                readonly "Not valid JSON.": "Not valid JSON.";
+                readonly "Must be a JSON array of rule objects.": "Must be a JSON array of rule objects.";
+                readonly exact: "exact";
+                readonly prefix: "prefix";
+                readonly wildcard: "wildcard";
+                readonly Status: "Status";
+                readonly More: "More";
+                readonly Delete: "Delete";
+                readonly Disable: "Disable";
+                readonly Enable: "Enable";
+                readonly "Saving\u2026": "Saving…";
+                readonly Created: "Created";
+                readonly active: "active";
+                readonly disabled: "disabled";
+                readonly "{created} created, {failed} failed.": "{created} created, {failed} failed.";
+                readonly "Item {index} ({code})": "Item {index} ({code})";
+                readonly "Actions for redirect rule from \"{fromPattern}\"": "Actions for redirect rule from \"{fromPattern}\"";
+                readonly "Paste a JSON array of ": "Paste a JSON array of ";
+                readonly " rule objects (1-500 items)": " rule objects (1-500 items)";
+                readonly "Delete the redirect rule from \"": "Delete the redirect rule from \"";
+                readonly "\"?": "\"?";
+            };
+            readonly pages: {
+                readonly list: {
+                    readonly path: "/redirects";
+                    readonly label: "Redirects";
+                    readonly permissions: readonly ["admin.redirects.manage"];
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "marketing";
+                        readonly icon: "arrow-right";
+                    };
+                    readonly tabs: {};
+                };
+            };
+        }>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/redirects/react/index.js

@@ -0,0 +1,28 @@
+import { createElement } from 'react';
+import { bindReact } from '../../core/react/bind-react.js';
+import { redirectsModule } from '../redirects.module.js';
+import { RedirectsPortsContext } from './hooks/RedirectsPorts.hooks.js';
+import { RedirectsOptionsContext } from './hooks/RedirectsOptions.hooks.js';
+export { useRedirectsPorts } from './hooks/RedirectsPorts.hooks.js';
+export { useRedirects } from './hooks/use-redirects.hooks.js';
+export { useHitCountCell } from './hooks/use-hit-count-cell.hooks.js';
+export { useImportRedirectsForm } from './hooks/use-import-redirects-form.hooks.js';
+/** Instance-scoped options and lazy list page; host supplies publish action and localized markup.
+ * @example redirects({}, { t, headerActions, slots: { renderMessage } });
+ */
+export function redirects(_required, options = {}) {
+    const react = bindReact({ module: redirectsModule, views: { list: { tabs: {}, page: async () => {
+                    const { RedirectsPage } = await import('./pages/RedirectsPage.js');
+                    return { default: () => createElement(RedirectsPage) };
+                } } } }, { context: RedirectsPortsContext });
+    const ScopeProvider = react.Provider;
+    /** Live host options keep the mounted page and its drafts intact across locale changes.
+     * Factory options remain the default for hosts without a live override.
+     * @example createElement(feature.react.Provider, { admin, options: localizedOptions, children });
+     */
+    function Provider({ admin, children, options: currentOptions = options }) {
+        return createElement(RedirectsOptionsContext.Provider, { value: currentOptions }, createElement(ScopeProvider, { admin, children }));
+    }
+    return Object.assign({ ...redirectsModule }, { react: { ...react, Provider } });
+}
+//# sourceMappingURL=index.js.map

package/dist/redirects/react/pages/RedirectsPage.d.ts

@@ -0,0 +1,15 @@
+import { useWiredRedirects } from '../hooks/wired.hooks.js';
+/** Redirects list markup. The original fetch-query pilot rationale is retained in SOURCE-RATIONALE.md.
+ * Controllers own local state; hooks bind query effects, table projections and the host's translator.
+ * Locale is supplied once per scope, never fetched independently by each row.
+ */
+export interface RedirectsProps {
+    /**
+     * Dependency injection seam for tests — the same convention `@jini-ai/ui`'s `CustomSelect` uses
+     * for `useCustomSelect`. Defaulted to the real hook, so production callers (`panels.tsx`) pass
+     * nothing and behave exactly as before. See `PostsProps.usePostsHook` for the full rationale.
+     */
+    useRedirectsHook?: typeof useWiredRedirects;
+}
+export declare function RedirectsPage({ useRedirectsHook }?: RedirectsProps): import("react").JSX.Element;
+//# sourceMappingURL=RedirectsPage.d.ts.map

package/dist/redirects/react/pages/RedirectsPage.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DataTable, ConfirmDialog } from '../../../react/index.js';
+import { agentHandle } from '@jini-ai/agentic';
+import { describeApiError } from '../../../core/transport/errors.js';
+import { ImportRedirectsForm } from '../components/ImportRedirectsForm.js';
+import { useWiredRedirects } from '../hooks/wired.hooks.js';
+import { useRedirectsPage } from '../hooks/RedirectsPage.hooks.js';
+export function RedirectsPage({ useRedirectsHook = useWiredRedirects } = {}) {
+    const { redirects, listStatus, listError, error, saving, pendingDelete, confirmDelete, deletePending, submitCreate, t, locale, columns, deleteBody, cancelDelete, headerActions } = useRedirectsPage({ useRedirectsHook });
+    // Only a FIRST load blocks the screen. A refetch triggered by a write keeps
+    // the table on screen (`status` stays `'success'`), where the old
+    // `if (!redirects)` guard blanked the whole page after every single edit.
+    if (listStatus === "error" && !redirects) {
+        return _jsx("div", { className: "notice error", children: describeApiError({ e: listError, fallback: "failed to load redirects" }) });
+    }
+    if (!redirects)
+        return _jsx("div", { className: "notice", children: t("Loading redirects…") });
+    return (_jsxs("div", { className: "page", children: [_jsxs("div", { className: "page-header", children: [_jsxs("div", { className: "page-header-text", children: [_jsx("p", { className: "page-kicker", children: t("Marketing") }), _jsx("h1", { className: "page-title", children: t("Redirects") }), _jsxs("p", { className: "page-description", children: [t("Manual URL redirect rules. Rules created automatically from a slug change (source"), _jsx("code", { children: " auto_slug_change" }), t(") also show up here.")] })] }), _jsx("div", { className: "page-actions", children: headerActions })] }), error ? _jsx("div", { className: "notice error", children: describeApiError({ e: error, fallback: "request failed" }) }) : null, _jsxs("form", { className: "card form-measure", onSubmit: submitCreate, children: [_jsx("div", { className: "field-group", children: _jsxs("div", { className: "field-row", children: [_jsxs("div", { className: "field", children: [_jsx("label", { className: "field-label", htmlFor: "redirect-match-type", children: t("Match type") }), _jsxs("select", { id: "redirect-match-type", name: "matchType", defaultValue: "exact", ...agentHandle({ handle: "redirects-create-match-type" }, { role: "field", label: "New redirect's match type" }), children: [_jsx("option", { value: "exact", children: t("exact") }), _jsx("option", { value: "prefix", children: t("prefix") }), _jsx("option", { value: "wildcard", children: t("wildcard") })] })] }), _jsxs("div", { className: "field", children: [_jsx("label", { className: "field-label", htmlFor: "redirect-from-pattern", children: t("From path") }), _jsx("input", { id: "redirect-from-pattern", name: "fromPattern", placeholder: "/old-path", required: true, ...agentHandle({ handle: "redirects-create-from-pattern" }, { role: "field", label: "New redirect's source path or pattern" }) })] }), _jsxs("div", { className: "field", children: [_jsx("label", { className: "field-label", htmlFor: "redirect-to-target", children: t("To target") }), _jsx("input", { id: "redirect-to-target", name: "toTarget", placeholder: "/new-path or https://example.com/...", required: true, ...agentHandle({ handle: "redirects-create-to-target" }, { role: "field", label: "New redirect's destination path or URL" }) })] }), _jsxs("div", { className: "field", children: [_jsx("label", { className: "field-label", htmlFor: "redirect-status-code", children: t("Status code") }), _jsxs("select", { id: "redirect-status-code", name: "statusCode", defaultValue: "301", ...agentHandle({ handle: "redirects-create-status-code" }, { role: "field", label: "New redirect's HTTP status code" }), children: [_jsx("option", { value: "301", children: t("301 (permanent)") }), _jsx("option", { value: "302", children: t("302 (temporary)") }), _jsx("option", { value: "307", children: t("307 (temporary, method-preserving)") }), _jsx("option", { value: "308", children: t("308 (permanent, method-preserving)") })] })] })] }) }), _jsx("div", { className: "editor-actions form-actions", children: _jsx("button", { type: "submit", disabled: saving, ...agentHandle({ handle: "redirects-create-submit" }, { role: "button", label: "Add this redirect rule" }), children: saving ? t("Saving…") : t("Add redirect") }) })] }), _jsx(ImportRedirectsForm, { t: t, locale: locale }), _jsx(DataTable, { rows: redirects, rowKey: (rule) => rule.id, empty: _jsx("div", { className: "card", children: _jsx("div", { className: "empty-state", children: _jsx("p", { children: t("No redirect rules yet.") }) }) }), columns: columns }), _jsx(ConfirmDialog, { open: pendingDelete !== null, agentHandle: "redirects-delete", title: t("Delete redirect rule?"), body: deleteBody, confirmLabel: t("Delete"), destructive: true, pending: deletePending, onConfirm: confirmDelete, onCancel: cancelDelete })] }));
+}
+//# sourceMappingURL=RedirectsPage.js.map

package/dist/redirects/redirects.module.d.ts

@@ -0,0 +1,75 @@
+/** Existing route identity and permission are part of the host's navigation contract. */
+export declare const redirectsModule: {
+    readonly id: "redirects";
+    readonly requires: {
+        readonly redirectsApi: import("../core/module/token.js").AdminPortToken<import("./ports.js").AdminRedirectsPort, "admin.redirects.api">;
+    };
+    readonly optional: {
+        readonly redirectsEvents: import("../core/module/token.js").AdminPortToken<import("./ports.js").RedirectsEventsPort, "admin.redirects.events">;
+    };
+    readonly messages: {
+        readonly "Loading\u2026": "Loading…";
+        readonly "Load hits": "Load hits";
+        readonly "Bulk import": "Bulk import";
+        readonly "rule objects (1-500 items)": "rule objects (1-500 items)";
+        readonly "Importing\u2026": "Importing…";
+        readonly Import: "Import";
+        readonly Marketing: "Marketing";
+        readonly Redirects: "Redirects";
+        readonly "Manual URL redirect rules. Rules created automatically from a slug change (source": "Manual URL redirect rules. Rules created automatically from a slug change (source";
+        readonly ") also show up here.": ") also show up here.";
+        readonly "Match type": "Match type";
+        readonly "From path": "From path";
+        readonly "To target": "To target";
+        readonly "Status code": "Status code";
+        readonly "301 (permanent)": "301 (permanent)";
+        readonly "302 (temporary)": "302 (temporary)";
+        readonly "307 (temporary, method-preserving)": "307 (temporary, method-preserving)";
+        readonly "308 (permanent, method-preserving)": "308 (permanent, method-preserving)";
+        readonly "Add redirect": "Add redirect";
+        readonly "No redirect rules yet.": "No redirect rules yet.";
+        readonly From: "From";
+        readonly To: "To";
+        readonly Type: "Type";
+        readonly Code: "Code";
+        readonly Source: "Source";
+        readonly Hits: "Hits";
+        readonly "Delete redirect rule?": "Delete redirect rule?";
+        readonly "Loading redirects\u2026": "Loading redirects…";
+        readonly "Not valid JSON.": "Not valid JSON.";
+        readonly "Must be a JSON array of rule objects.": "Must be a JSON array of rule objects.";
+        readonly exact: "exact";
+        readonly prefix: "prefix";
+        readonly wildcard: "wildcard";
+        readonly Status: "Status";
+        readonly More: "More";
+        readonly Delete: "Delete";
+        readonly Disable: "Disable";
+        readonly Enable: "Enable";
+        readonly "Saving\u2026": "Saving…";
+        readonly Created: "Created";
+        readonly active: "active";
+        readonly disabled: "disabled";
+        readonly "{created} created, {failed} failed.": "{created} created, {failed} failed.";
+        readonly "Item {index} ({code})": "Item {index} ({code})";
+        readonly "Actions for redirect rule from \"{fromPattern}\"": "Actions for redirect rule from \"{fromPattern}\"";
+        readonly "Paste a JSON array of ": "Paste a JSON array of ";
+        readonly " rule objects (1-500 items)": " rule objects (1-500 items)";
+        readonly "Delete the redirect rule from \"": "Delete the redirect rule from \"";
+        readonly "\"?": "\"?";
+    };
+    readonly pages: {
+        readonly list: {
+            readonly path: "/redirects";
+            readonly label: "Redirects";
+            readonly permissions: readonly ["admin.redirects.manage"];
+            readonly agentReachable: true;
+            readonly nav: {
+                readonly group: "marketing";
+                readonly icon: "arrow-right";
+            };
+            readonly tabs: {};
+        };
+    };
+};
+//# sourceMappingURL=redirects.module.d.ts.map

package/dist/redirects/redirects.module.js

@@ -0,0 +1,13 @@
+import { defineAdminModule } from '../core/module/index.js';
+import { redirectsApiToken, redirectsEventsToken } from './ports.js';
+import { redirectsMessagesEn } from './messages.en.js';
+/** Existing route identity and permission are part of the host's navigation contract. */
+export const redirectsModule = defineAdminModule({
+    id: 'redirects',
+    requires: { redirectsApi: redirectsApiToken },
+    optional: { redirectsEvents: redirectsEventsToken },
+    messages: redirectsMessagesEn,
+    pages: { list: { path: '/redirects', label: 'Redirects', permissions: ['admin.redirects.manage'],
+            agentReachable: true, nav: { group: 'marketing', icon: 'arrow-right' }, tabs: {} } },
+});
+//# sourceMappingURL=redirects.module.js.map