@asteby/metacore-runtime-react 31.0.0 → 31.1.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @asteby/metacore-runtime-react
 
+## 31.1.0
+
+### Minor Changes
+
+- 50c832f: Plantillas: hooks y editor para el overlay HTML por organización de documents[] del addon.
+
 ## 31.0.0
 
 ### Patch Changes

package/dist/document-template-editor.d.ts

@@ -0,0 +1,11 @@
+export interface DocumentTemplateEditorProps {
+    addonKey: string;
+    documentKey: string;
+    /** Called after a successful save or reset. */
+    onSaved?: () => void;
+    onError?: (err: unknown) => void;
+    className?: string;
+    disabled?: boolean;
+}
+export declare function DocumentTemplateEditor({ addonKey, documentKey, onSaved, onError, className, disabled, }: DocumentTemplateEditorProps): import("react").JSX.Element;
+//# sourceMappingURL=document-template-editor.d.ts.map

package/dist/document-template-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-template-editor.d.ts","sourceRoot":"","sources":["../src/document-template-editor.tsx"],"names":[],"mappings":"AAYA,MAAM,WAAW,2BAA2B;IACxC,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,sBAAsB,CAAC,EACnC,QAAQ,EACR,WAAW,EACX,OAAO,EACP,OAAO,EACP,SAAS,EACT,QAAQ,GACX,EAAE,2BAA2B,+BAiH7B"}

package/dist/document-template-editor.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// DocumentTemplateEditor — textarea + preview/save/reset for one org overlay
+// of an addon document. Headless-friendly: plain buttons + textarea, styled via
+// className. Host surfaces (ops Plantillas) can wrap this or roll their own
+// using the hooks in use-org-document-templates.
+import { useEffect, useState } from 'react';
+import { useOrgDocumentTemplate, usePreviewOrgDocumentTemplate, useResetOrgDocumentTemplate, useSaveOrgDocumentTemplate, } from './use-org-document-templates';
+export function DocumentTemplateEditor({ addonKey, documentKey, onSaved, onError, className, disabled, }) {
+    const { template, isLoading } = useOrgDocumentTemplate(addonKey, documentKey);
+    const save = useSaveOrgDocumentTemplate();
+    const reset = useResetOrgDocumentTemplate();
+    const preview = usePreviewOrgDocumentTemplate();
+    const [html, setHtml] = useState('');
+    const [previewUrl, setPreviewUrl] = useState(null);
+    const [previewing, setPreviewing] = useState(false);
+    useEffect(() => {
+        if (template?.html != null)
+            setHtml(template.html);
+    }, [template?.html]);
+    useEffect(() => {
+        return () => {
+            if (previewUrl)
+                URL.revokeObjectURL(previewUrl);
+        };
+    }, [previewUrl]);
+    const busy = save.isPending || reset.isPending || previewing || disabled;
+    async function onPreview() {
+        setPreviewing(true);
+        try {
+            const url = await preview({
+                addonKey,
+                documentKey,
+                html,
+                paper: template?.paper,
+            });
+            setPreviewUrl((prev) => {
+                if (prev)
+                    URL.revokeObjectURL(prev);
+                return url;
+            });
+        }
+        catch (err) {
+            onError?.(err);
+        }
+        finally {
+            setPreviewing(false);
+        }
+    }
+    async function onSave() {
+        try {
+            await save.mutateAsync({
+                addonKey,
+                documentKey,
+                html,
+                paper: template?.paper,
+            });
+            onSaved?.();
+        }
+        catch (err) {
+            onError?.(err);
+        }
+    }
+    async function onReset() {
+        try {
+            const detail = await reset.mutateAsync({ addonKey, documentKey });
+            setHtml(detail.html);
+            onSaved?.();
+        }
+        catch (err) {
+            onError?.(err);
+        }
+    }
+    if (isLoading && !template) {
+        return _jsx("p", { className: className, children: "\u2026" });
+    }
+    return (_jsxs("div", { className: className, children: [_jsx("textarea", { value: html, onChange: (e) => setHtml(e.target.value), disabled: busy, spellCheck: false, rows: 22, style: {
+                    width: '100%',
+                    fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace',
+                    fontSize: 12,
+                    lineHeight: 1.45,
+                } }), _jsxs("div", { style: { display: 'flex', gap: 8, marginTop: 12, flexWrap: 'wrap' }, children: [_jsx("button", { type: "button", disabled: busy, onClick: () => void onPreview(), children: previewing ? '…' : 'Vista previa' }), _jsx("button", { type: "button", disabled: busy, onClick: () => void onSave(), children: "Guardar" }), _jsx("button", { type: "button", disabled: busy || !template?.customized, onClick: () => void onReset(), children: "Restaurar default" })] }), previewUrl ? (_jsx("iframe", { title: "Vista previa", src: previewUrl, style: {
+                    width: '100%',
+                    height: 480,
+                    marginTop: 12,
+                    border: '1px solid #e5e7eb',
+                } })) : null] }));
+}

package/dist/index.d.ts

@@ -32,6 +32,8 @@ export * from './api-context';
 export * from './use-addon-settings';
 export * from './use-print-document';
 export * from './print-document-button';
+export * from './use-org-document-templates';
+export * from './document-template-editor';
 export * from './metadata-cache';
 export { ADDON_MANIFEST_CHANGED_TYPE, wireHotSwapInvalidation, useManifestHotSwapSubscriber, type AddonManifestChangedMessage, type ManifestHotSwapClient, type WireHotSwapInvalidationOptions, } from './manifest-hotswap-subscriber';
 export { useHotSwapReload, applyHotSwapReload, withVersionParam, clearFederationContainer, shortenHash, type HotSwapReloadStrategy, type HotSwapReloadConfig, type HotSwapReloadAction, type HotSwapReloadDeps, type UseHotSwapReloadResult, } from './hotswap-reload-policy';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -37,6 +37,8 @@ export * from './api-context';
 export * from './use-addon-settings';
 export * from './use-print-document';
 export * from './print-document-button';
+export * from './use-org-document-templates';
+export * from './document-template-editor';
 export * from './metadata-cache';
 export { ADDON_MANIFEST_CHANGED_TYPE, wireHotSwapInvalidation, useManifestHotSwapSubscriber, } from './manifest-hotswap-subscriber';
 export { useHotSwapReload, applyHotSwapReload, withVersionParam, clearFederationContainer, shortenHash, } from './hotswap-reload-policy';

package/dist/use-org-document-templates.d.ts

@@ -0,0 +1,71 @@
+export interface OrgDocumentCatalogItem {
+    addon_key: string;
+    addon_name: string;
+    document_key: string;
+    label: string;
+    model: string;
+    paper: string;
+    filename?: string;
+    customized: boolean;
+}
+export interface OrgDocumentTemplateDetail extends OrgDocumentCatalogItem {
+    html: string;
+    default_html: string;
+}
+export declare function orgDocumentCatalogKey(): readonly ["org-document-templates"];
+export declare function orgDocumentTemplateKey(addonKey: string, documentKey: string): readonly ["org-document-templates", string, string];
+export declare function useOrgDocumentCatalog(opts?: {
+    enabled?: boolean;
+}): {
+    items: NoInfer<OrgDocumentCatalogItem[]>;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+export declare function useOrgDocumentTemplate(addonKey: string, documentKey: string, opts?: {
+    enabled?: boolean;
+}): {
+    template: NoInfer<OrgDocumentTemplateDetail> | undefined;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+export declare function useSaveOrgDocumentTemplate(): import("@tanstack/react-query").UseMutationResult<OrgDocumentTemplateDetail, Error, {
+    addonKey: string;
+    documentKey: string;
+    html: string;
+    paper?: string;
+}, unknown>;
+export declare function useResetOrgDocumentTemplate(): import("@tanstack/react-query").UseMutationResult<OrgDocumentTemplateDetail, Error, {
+    addonKey: string;
+    documentKey: string;
+}, unknown>;
+/**
+ * Renders a PDF preview of unsaved HTML against dummy record + org branding.
+ * Returns a blob URL the caller should revoke.
+ */
+export declare function usePreviewOrgDocumentTemplate(): (args: {
+    addonKey: string;
+    documentKey: string;
+    html: string;
+    paper?: string;
+}) => Promise<string>;
+export declare function groupDocumentCatalog(items: OrgDocumentCatalogItem[]): {
+    addonKey: string;
+    addonName: string;
+    documents: OrgDocumentCatalogItem[];
+}[];
+export declare function useGroupedOrgDocumentCatalog(opts?: {
+    enabled?: boolean;
+}): {
+    groups: {
+        addonKey: string;
+        addonName: string;
+        documents: OrgDocumentCatalogItem[];
+    }[];
+    items: NoInfer<OrgDocumentCatalogItem[]>;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+//# sourceMappingURL=use-org-document-templates.d.ts.map

package/dist/use-org-document-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-org-document-templates.d.ts","sourceRoot":"","sources":["../src/use-org-document-templates.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,sBAAsB;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,yBAA0B,SAAQ,sBAAsB;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;CACvB;AAED,wBAAgB,qBAAqB,wCAEpC;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uDAE3E;AAQD,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;EAoBjE;AAED,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;EAsB/B;AAED,wBAAgB,0BAA0B;cAMtB,MAAM;iBAAe,MAAM;UAAQ,MAAM;YAAU,MAAM;YAgB5E;AAED,wBAAgB,2BAA2B;cAMvB,MAAM;iBAAe,MAAM;YAe9C;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,WAGxB;IACT,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB,KAAG,OAAO,CAAC,MAAM,CAAC,CAmB1B;AAED,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,sBAAsB,EAAE,GAChC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,sBAAsB,EAAE,CAAA;CAAE,EAAE,CAoBhF;AAED,wBAAgB,4BAA4B,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;;kBAtB1D,MAAM;mBAAa,MAAM;mBAAa,sBAAsB,EAAE;;;;;;EA6B5E"}

package/dist/use-org-document-templates.js

@@ -0,0 +1,147 @@
+// useOrgDocumentTemplates — host primitive for the per-org overlay of addon
+// printable documents (Ajustes → Organización → Plantillas).
+//
+// The addon still owns the default HTML in its bundle. The host persists an
+// optional override per (org, addon, document key) and resolves
+// `org overlay → addon default` at PDF render time, so a business can change
+// tickets/PDFs without a new addon version.
+//
+//   GET    /api/settings/templates
+//   GET    /api/settings/templates/:addon/:key
+//   PUT    /api/settings/templates/:addon/:key   { html, paper? }
+//   DELETE /api/settings/templates/:addon/:key
+//   POST   /api/settings/templates/preview       → application/pdf
+//
+// ApiClient is a PEER via <ApiProvider> (same one usePrintDocument uses).
+import { useCallback, useMemo } from 'react';
+import { useMutation, useQuery, useQueryClient, } from '@tanstack/react-query';
+import { useApi } from './api-context';
+export function orgDocumentCatalogKey() {
+    return ['org-document-templates'];
+}
+export function orgDocumentTemplateKey(addonKey, documentKey) {
+    return ['org-document-templates', addonKey, documentKey];
+}
+function unwrapData(res) {
+    const body = res.data;
+    const values = body?.success ? body.data : body;
+    return values;
+}
+export function useOrgDocumentCatalog(opts) {
+    const api = useApi();
+    const query = useQuery({
+        queryKey: orgDocumentCatalogKey(),
+        queryFn: async () => {
+            const res = await api.get('/settings/templates');
+            const data = unwrapData(res);
+            return Array.isArray(data) ? data : [];
+        },
+        staleTime: 30_000,
+        enabled: opts?.enabled ?? true,
+    });
+    return {
+        items: query.data ?? [],
+        isLoading: query.isLoading,
+        error: query.error,
+        refetch: () => {
+            void query.refetch();
+        },
+    };
+}
+export function useOrgDocumentTemplate(addonKey, documentKey, opts) {
+    const api = useApi();
+    const query = useQuery({
+        queryKey: orgDocumentTemplateKey(addonKey, documentKey),
+        queryFn: async () => {
+            const res = await api.get(`/settings/templates/${encodeURIComponent(addonKey)}/${encodeURIComponent(documentKey)}`);
+            return unwrapData(res);
+        },
+        enabled: (opts?.enabled ?? true) && !!addonKey && !!documentKey,
+    });
+    return {
+        template: query.data,
+        isLoading: query.isLoading,
+        error: query.error,
+        refetch: () => {
+            void query.refetch();
+        },
+    };
+}
+export function useSaveOrgDocumentTemplate() {
+    const api = useApi();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ addonKey, documentKey, html, paper }) => {
+            const res = await api.put(`/settings/templates/${encodeURIComponent(addonKey)}/${encodeURIComponent(documentKey)}`, { html, paper });
+            return unwrapData(res);
+        },
+        onSuccess: (_data, vars) => {
+            void qc.invalidateQueries({ queryKey: orgDocumentCatalogKey() });
+            void qc.invalidateQueries({
+                queryKey: orgDocumentTemplateKey(vars.addonKey, vars.documentKey),
+            });
+        },
+    });
+}
+export function useResetOrgDocumentTemplate() {
+    const api = useApi();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ addonKey, documentKey }) => {
+            const res = await api.delete(`/settings/templates/${encodeURIComponent(addonKey)}/${encodeURIComponent(documentKey)}`);
+            return unwrapData(res);
+        },
+        onSuccess: (_data, vars) => {
+            void qc.invalidateQueries({ queryKey: orgDocumentCatalogKey() });
+            void qc.invalidateQueries({
+                queryKey: orgDocumentTemplateKey(vars.addonKey, vars.documentKey),
+            });
+        },
+    });
+}
+/**
+ * Renders a PDF preview of unsaved HTML against dummy record + org branding.
+ * Returns a blob URL the caller should revoke.
+ */
+export function usePreviewOrgDocumentTemplate() {
+    const api = useApi();
+    return useCallback(async (args) => {
+        const res = await api.post('/settings/templates/preview', {
+            addon_key: args.addonKey,
+            document_key: args.documentKey,
+            html: args.html,
+            paper: args.paper,
+        }, { responseType: 'blob' });
+        const blob = res.data instanceof Blob
+            ? res.data
+            : new Blob([res.data], { type: 'application/pdf' });
+        return URL.createObjectURL(blob);
+    }, [api]);
+}
+export function groupDocumentCatalog(items) {
+    const order = [];
+    const byAddon = new Map();
+    for (const item of items) {
+        const list = byAddon.get(item.addon_key);
+        if (list) {
+            list.push(item);
+        }
+        else {
+            order.push(item.addon_key);
+            byAddon.set(item.addon_key, [item]);
+        }
+    }
+    return order.map((addonKey) => {
+        const documents = byAddon.get(addonKey) ?? [];
+        return {
+            addonKey,
+            addonName: documents[0]?.addon_name || addonKey,
+            documents,
+        };
+    });
+}
+export function useGroupedOrgDocumentCatalog(opts) {
+    const catalog = useOrgDocumentCatalog(opts);
+    const groups = useMemo(() => groupDocumentCatalog(catalog.items), [catalog.items]);
+    return { ...catalog, groups };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "31.0.0",
+  "version": "31.1.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",

package/src/document-template-editor.tsx

@@ -0,0 +1,143 @@
+// DocumentTemplateEditor — textarea + preview/save/reset for one org overlay
+// of an addon document. Headless-friendly: plain buttons + textarea, styled via
+// className. Host surfaces (ops Plantillas) can wrap this or roll their own
+// using the hooks in use-org-document-templates.
+import { useEffect, useState } from 'react'
+import {
+    useOrgDocumentTemplate,
+    usePreviewOrgDocumentTemplate,
+    useResetOrgDocumentTemplate,
+    useSaveOrgDocumentTemplate,
+} from './use-org-document-templates'
+
+export interface DocumentTemplateEditorProps {
+    addonKey: string
+    documentKey: string
+    /** Called after a successful save or reset. */
+    onSaved?: () => void
+    onError?: (err: unknown) => void
+    className?: string
+    disabled?: boolean
+}
+
+export function DocumentTemplateEditor({
+    addonKey,
+    documentKey,
+    onSaved,
+    onError,
+    className,
+    disabled,
+}: DocumentTemplateEditorProps) {
+    const { template, isLoading } = useOrgDocumentTemplate(addonKey, documentKey)
+    const save = useSaveOrgDocumentTemplate()
+    const reset = useResetOrgDocumentTemplate()
+    const preview = usePreviewOrgDocumentTemplate()
+    const [html, setHtml] = useState('')
+    const [previewUrl, setPreviewUrl] = useState<string | null>(null)
+    const [previewing, setPreviewing] = useState(false)
+
+    useEffect(() => {
+        if (template?.html != null) setHtml(template.html)
+    }, [template?.html])
+
+    useEffect(() => {
+        return () => {
+            if (previewUrl) URL.revokeObjectURL(previewUrl)
+        }
+    }, [previewUrl])
+
+    const busy = save.isPending || reset.isPending || previewing || disabled
+
+    async function onPreview() {
+        setPreviewing(true)
+        try {
+            const url = await preview({
+                addonKey,
+                documentKey,
+                html,
+                paper: template?.paper,
+            })
+            setPreviewUrl((prev) => {
+                if (prev) URL.revokeObjectURL(prev)
+                return url
+            })
+        } catch (err) {
+            onError?.(err)
+        } finally {
+            setPreviewing(false)
+        }
+    }
+
+    async function onSave() {
+        try {
+            await save.mutateAsync({
+                addonKey,
+                documentKey,
+                html,
+                paper: template?.paper,
+            })
+            onSaved?.()
+        } catch (err) {
+            onError?.(err)
+        }
+    }
+
+    async function onReset() {
+        try {
+            const detail = await reset.mutateAsync({ addonKey, documentKey })
+            setHtml(detail.html)
+            onSaved?.()
+        } catch (err) {
+            onError?.(err)
+        }
+    }
+
+    if (isLoading && !template) {
+        return <p className={className}>…</p>
+    }
+
+    return (
+        <div className={className}>
+            <textarea
+                value={html}
+                onChange={(e) => setHtml(e.target.value)}
+                disabled={busy}
+                spellCheck={false}
+                rows={22}
+                style={{
+                    width: '100%',
+                    fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace',
+                    fontSize: 12,
+                    lineHeight: 1.45,
+                }}
+            />
+            <div style={{ display: 'flex', gap: 8, marginTop: 12, flexWrap: 'wrap' }}>
+                <button type="button" disabled={busy} onClick={() => void onPreview()}>
+                    {previewing ? '…' : 'Vista previa'}
+                </button>
+                <button type="button" disabled={busy} onClick={() => void onSave()}>
+                    Guardar
+                </button>
+                <button
+                    type="button"
+                    disabled={busy || !template?.customized}
+                    onClick={() => void onReset()}
+                >
+                    Restaurar default
+                </button>
+            </div>
+            {previewUrl ? (
+                <iframe
+                    title="Vista previa"
+                    src={previewUrl}
+                    style={{
+                        width: '100%',
+                        height: 480,
+                        marginTop: 12,
+                        border: '1px solid #e5e7eb',
+                    }}
+                />
+            ) : null}
+        </div>
+    )
+}

package/src/index.ts

@@ -179,6 +179,8 @@ export * from './api-context'
 export * from './use-addon-settings'
 export * from './use-print-document'
 export * from './print-document-button'
+export * from './use-org-document-templates'
+export * from './document-template-editor'
 export * from './metadata-cache'
 export {
     ADDON_MANIFEST_CHANGED_TYPE,

package/src/use-org-document-templates.ts

@@ -0,0 +1,214 @@
+// useOrgDocumentTemplates — host primitive for the per-org overlay of addon
+// printable documents (Ajustes → Organización → Plantillas).
+//
+// The addon still owns the default HTML in its bundle. The host persists an
+// optional override per (org, addon, document key) and resolves
+// `org overlay → addon default` at PDF render time, so a business can change
+// tickets/PDFs without a new addon version.
+//
+//   GET    /api/settings/templates
+//   GET    /api/settings/templates/:addon/:key
+//   PUT    /api/settings/templates/:addon/:key   { html, paper? }
+//   DELETE /api/settings/templates/:addon/:key
+//   POST   /api/settings/templates/preview       → application/pdf
+//
+// ApiClient is a PEER via <ApiProvider> (same one usePrintDocument uses).
+import { useCallback, useMemo } from 'react'
+import {
+    useMutation,
+    useQuery,
+    useQueryClient,
+} from '@tanstack/react-query'
+import { useApi } from './api-context'
+
+export interface OrgDocumentCatalogItem {
+    addon_key: string
+    addon_name: string
+    document_key: string
+    label: string
+    model: string
+    paper: string
+    filename?: string
+    customized: boolean
+}
+
+export interface OrgDocumentTemplateDetail extends OrgDocumentCatalogItem {
+    html: string
+    default_html: string
+}
+
+export function orgDocumentCatalogKey() {
+    return ['org-document-templates'] as const
+}
+
+export function orgDocumentTemplateKey(addonKey: string, documentKey: string) {
+    return ['org-document-templates', addonKey, documentKey] as const
+}
+
+function unwrapData<T>(res: { data?: unknown }): T {
+    const body = (res as { data: any }).data
+    const values = body?.success ? body.data : body
+    return values as T
+}
+
+export function useOrgDocumentCatalog(opts?: { enabled?: boolean }) {
+    const api = useApi()
+    const query = useQuery<OrgDocumentCatalogItem[]>({
+        queryKey: orgDocumentCatalogKey(),
+        queryFn: async () => {
+            const res = await api.get('/settings/templates')
+            const data = unwrapData<OrgDocumentCatalogItem[] | null>(res)
+            return Array.isArray(data) ? data : []
+        },
+        staleTime: 30_000,
+        enabled: opts?.enabled ?? true,
+    })
+    return {
+        items: query.data ?? [],
+        isLoading: query.isLoading,
+        error: query.error,
+        refetch: () => {
+            void query.refetch()
+        },
+    }
+}
+
+export function useOrgDocumentTemplate(
+    addonKey: string,
+    documentKey: string,
+    opts?: { enabled?: boolean },
+) {
+    const api = useApi()
+    const query = useQuery<OrgDocumentTemplateDetail>({
+        queryKey: orgDocumentTemplateKey(addonKey, documentKey),
+        queryFn: async () => {
+            const res = await api.get(
+                `/settings/templates/${encodeURIComponent(addonKey)}/${encodeURIComponent(documentKey)}`,
+            )
+            return unwrapData<OrgDocumentTemplateDetail>(res)
+        },
+        enabled:
+            (opts?.enabled ?? true) && !!addonKey && !!documentKey,
+    })
+    return {
+        template: query.data,
+        isLoading: query.isLoading,
+        error: query.error,
+        refetch: () => {
+            void query.refetch()
+        },
+    }
+}
+
+export function useSaveOrgDocumentTemplate() {
+    const api = useApi()
+    const qc = useQueryClient()
+    return useMutation<
+        OrgDocumentTemplateDetail,
+        Error,
+        { addonKey: string; documentKey: string; html: string; paper?: string }
+    >({
+        mutationFn: async ({ addonKey, documentKey, html, paper }) => {
+            const res = await api.put(
+                `/settings/templates/${encodeURIComponent(addonKey)}/${encodeURIComponent(documentKey)}`,
+                { html, paper },
+            )
+            return unwrapData<OrgDocumentTemplateDetail>(res)
+        },
+        onSuccess: (_data, vars) => {
+            void qc.invalidateQueries({ queryKey: orgDocumentCatalogKey() })
+            void qc.invalidateQueries({
+                queryKey: orgDocumentTemplateKey(vars.addonKey, vars.documentKey),
+            })
+        },
+    })
+}
+
+export function useResetOrgDocumentTemplate() {
+    const api = useApi()
+    const qc = useQueryClient()
+    return useMutation<
+        OrgDocumentTemplateDetail,
+        Error,
+        { addonKey: string; documentKey: string }
+    >({
+        mutationFn: async ({ addonKey, documentKey }) => {
+            const res = await api.delete(
+                `/settings/templates/${encodeURIComponent(addonKey)}/${encodeURIComponent(documentKey)}`,
+            )
+            return unwrapData<OrgDocumentTemplateDetail>(res)
+        },
+        onSuccess: (_data, vars) => {
+            void qc.invalidateQueries({ queryKey: orgDocumentCatalogKey() })
+            void qc.invalidateQueries({
+                queryKey: orgDocumentTemplateKey(vars.addonKey, vars.documentKey),
+            })
+        },
+    })
+}
+
+/**
+ * Renders a PDF preview of unsaved HTML against dummy record + org branding.
+ * Returns a blob URL the caller should revoke.
+ */
+export function usePreviewOrgDocumentTemplate() {
+    const api = useApi()
+    return useCallback(
+        async (args: {
+            addonKey: string
+            documentKey: string
+            html: string
+            paper?: string
+        }): Promise<string> => {
+            const res = await api.post(
+                '/settings/templates/preview',
+                {
+                    addon_key: args.addonKey,
+                    document_key: args.documentKey,
+                    html: args.html,
+                    paper: args.paper,
+                },
+                { responseType: 'blob' },
+            )
+            const blob =
+                res.data instanceof Blob
+                    ? res.data
+                    : new Blob([res.data], { type: 'application/pdf' })
+            return URL.createObjectURL(blob)
+        },
+        [api],
+    )
+}
+
+export function groupDocumentCatalog(
+    items: OrgDocumentCatalogItem[],
+): { addonKey: string; addonName: string; documents: OrgDocumentCatalogItem[] }[] {
+    const order: string[] = []
+    const byAddon = new Map<string, OrgDocumentCatalogItem[]>()
+    for (const item of items) {
+        const list = byAddon.get(item.addon_key)
+        if (list) {
+            list.push(item)
+        } else {
+            order.push(item.addon_key)
+            byAddon.set(item.addon_key, [item])
+        }
+    }
+    return order.map((addonKey) => {
+        const documents = byAddon.get(addonKey) ?? []
+        return {
+            addonKey,
+            addonName: documents[0]?.addon_name || addonKey,
+            documents,
+        }
+    })
+}
+
+export function useGroupedOrgDocumentCatalog(opts?: { enabled?: boolean }) {
+    const catalog = useOrgDocumentCatalog(opts)
+    const groups = useMemo(
+        () => groupDocumentCatalog(catalog.items),
+        [catalog.items],
+    )
+    return { ...catalog, groups }
+}