@fayz-ai/plugin-forms 0.1.1

package/src/locales/en.ts

@@ -0,0 +1,75 @@
+export const en: Record<string, string> = {
+  // Settings
+  'customForms.settingsTitle': 'Forms & Documents',
+  'customForms.settingsSubtitle': 'Create and manage custom forms for your business',
+
+  // Templates
+  'customForms.templates': 'Templates',
+  'customForms.newTemplate': 'New Template',
+  'customForms.editTemplate': 'Edit Template',
+  'customForms.templateName': 'Form name',
+  'customForms.templateDescription': 'Description',
+  'customForms.templateCategory': 'Category',
+  'customForms.templateSpecialty': 'Specialty',
+  'customForms.noTemplates': 'No form templates yet',
+  'customForms.noTemplatesDescription': 'Create your first custom form to start collecting structured data.',
+  'customForms.deleteTemplateConfirm': 'Delete this form template? Existing documents will be preserved.',
+
+  // Categories
+  'customForms.category.anamnesis': 'Anamnesis',
+  'customForms.category.evolution': 'Evolution Note',
+  'customForms.category.report': 'Report',
+  'customForms.category.contract': 'Contract',
+  'customForms.category.general': 'General',
+
+  // Builder
+  'customForms.builder.fields': 'Fields',
+  'customForms.builder.fieldCount': '{{count}} fields',
+  'customForms.builder.settings': 'Settings',
+  'customForms.builder.save': 'Save',
+  'customForms.builder.saving': 'Saving...',
+  'customForms.builder.saved': 'Form saved',
+  'customForms.builder.emptyCanvas': 'Drag fields from the left panel to start building your form',
+  'customForms.builder.fieldLabel': 'Field label',
+  'customForms.builder.fieldPlaceholder': 'Placeholder',
+  'customForms.builder.fieldRequired': 'Required',
+  'customForms.builder.fieldOptions': 'Options',
+  'customForms.builder.addOption': 'Add option',
+  'customForms.builder.colSpan': 'Column span',
+  'customForms.builder.deleteField': 'Remove field',
+
+  // Field types
+  'customForms.fieldType.title': 'Title',
+  'customForms.fieldType.text': 'Simple Text',
+  'customForms.fieldType.memo': 'Memo',
+  'customForms.fieldType.richtext': 'Rich Text',
+  'customForms.fieldType.date': 'Date',
+  'customForms.fieldType.select': 'Select',
+  'customForms.fieldType.radio': 'Radio',
+  'customForms.fieldType.tags': 'Tags',
+  'customForms.fieldType.checkbox': 'Checkbox',
+  'customForms.fieldType.image': 'Image / Drawing',
+  'customForms.fieldType.gallery': 'Gallery',
+  'customForms.fieldType.budget': 'Budget',
+
+  // Documents
+  'customForms.documents': 'Documents',
+  'customForms.addDocument': 'Add Document',
+  'customForms.selectTemplate': 'Select a form',
+  'customForms.noDocuments': 'No documents yet',
+  'customForms.noDocumentsDescription': 'Add a document to start recording information.',
+  'customForms.documentTitle': 'Document title',
+  'customForms.saveAsDraft': 'Save as Draft',
+  'customForms.saveAndComplete': 'Save & Complete',
+  'customForms.deleteDocumentConfirm': 'Delete this document?',
+
+  // Registry
+  'registry.form-categories': 'Categories',
+  'registry.form-categories.description': 'Categories for organizing form templates',
+
+  // Status
+  'customForms.status.draft': 'Draft',
+  'customForms.status.completed': 'Completed',
+  'customForms.status.signed': 'Signed',
+  'customForms.status.archived': 'Archived',
+}

package/src/locales/index.ts

@@ -0,0 +1,7 @@
+import { en } from './en'
+import { ptBR } from './pt-BR'
+
+export const customFormsLocales: Record<string, Record<string, string>> = {
+  en,
+  'pt-BR': ptBR,
+}

package/src/locales/pt-BR.ts

@@ -0,0 +1,75 @@
+export const ptBR: Record<string, string> = {
+  // Settings
+  'customForms.settingsTitle': 'Formulários e Documentos',
+  'customForms.settingsSubtitle': 'Crie e gerencie formulários personalizados para o seu negócio',
+
+  // Templates
+  'customForms.templates': 'Modelos',
+  'customForms.newTemplate': 'Novo Modelo',
+  'customForms.editTemplate': 'Editar Modelo',
+  'customForms.templateName': 'Nome do formulário',
+  'customForms.templateDescription': 'Descrição',
+  'customForms.templateCategory': 'Categoria',
+  'customForms.templateSpecialty': 'Especialidade',
+  'customForms.noTemplates': 'Nenhum modelo criado',
+  'customForms.noTemplatesDescription': 'Crie seu primeiro formulário personalizado para começar a coletar dados estruturados.',
+  'customForms.deleteTemplateConfirm': 'Excluir este modelo de formulário? Documentos existentes serão preservados.',
+
+  // Categories
+  'customForms.category.anamnesis': 'Anamnese',
+  'customForms.category.evolution': 'Evolução',
+  'customForms.category.report': 'Laudo',
+  'customForms.category.contract': 'Contrato',
+  'customForms.category.general': 'Geral',
+
+  // Builder
+  'customForms.builder.fields': 'Campos',
+  'customForms.builder.fieldCount': '{{count}} campos',
+  'customForms.builder.settings': 'Configurações',
+  'customForms.builder.save': 'Salvar',
+  'customForms.builder.saving': 'Salvando...',
+  'customForms.builder.saved': 'Formulário salvo',
+  'customForms.builder.emptyCanvas': 'Arraste os campos do painel esquerdo para começar a montar seu formulário',
+  'customForms.builder.fieldLabel': 'Rótulo do campo',
+  'customForms.builder.fieldPlaceholder': 'Placeholder',
+  'customForms.builder.fieldRequired': 'Obrigatório',
+  'customForms.builder.fieldOptions': 'Opções',
+  'customForms.builder.addOption': 'Adicionar opção',
+  'customForms.builder.colSpan': 'Largura em colunas',
+  'customForms.builder.deleteField': 'Remover campo',
+
+  // Field types
+  'customForms.fieldType.title': 'Título',
+  'customForms.fieldType.text': 'Texto Simples',
+  'customForms.fieldType.memo': 'Memorando',
+  'customForms.fieldType.richtext': 'Texto Rico',
+  'customForms.fieldType.date': 'Data',
+  'customForms.fieldType.select': 'Seleção',
+  'customForms.fieldType.radio': 'Radio',
+  'customForms.fieldType.tags': 'Tags',
+  'customForms.fieldType.checkbox': 'Checkbox',
+  'customForms.fieldType.image': 'Imagem / Desenho',
+  'customForms.fieldType.gallery': 'Galeria',
+  'customForms.fieldType.budget': 'Orçamento',
+
+  // Documents
+  'customForms.documents': 'Documentos',
+  'customForms.addDocument': 'Novo Documento',
+  'customForms.selectTemplate': 'Selecione um formulário',
+  'customForms.noDocuments': 'Nenhum documento',
+  'customForms.noDocumentsDescription': 'Adicione um documento para começar a registrar informações.',
+  'customForms.documentTitle': 'Título do documento',
+  'customForms.saveAsDraft': 'Salvar Rascunho',
+  'customForms.saveAndComplete': 'Salvar e Finalizar',
+  'customForms.deleteDocumentConfirm': 'Excluir este documento?',
+
+  // Registry
+  'registry.form-categories': 'Categorias',
+  'registry.form-categories.description': 'Categorias para organizar modelos de formulários',
+
+  // Status
+  'customForms.status.draft': 'Rascunho',
+  'customForms.status.completed': 'Finalizado',
+  'customForms.status.signed': 'Assinado',
+  'customForms.status.archived': 'Arquivado',
+}

package/src/migrations/001_frm_base.sql

@@ -0,0 +1,138 @@
+-- ============================================================
+-- Custom Forms Plugin — Base Tables
+-- ============================================================
+
+-- frm_templates: form template definitions (versioned)
+CREATE TABLE IF NOT EXISTS public.frm_templates (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  name text NOT NULL,
+  description text,
+  category text NOT NULL DEFAULT 'general',
+  version integer NOT NULL DEFAULT 1,
+  is_current boolean NOT NULL DEFAULT true,
+  parent_id uuid REFERENCES public.frm_templates(id),
+  schema jsonb NOT NULL DEFAULT '{"fields":[],"layout":{"columns":12}}',
+  specialty text,
+  tags text[] DEFAULT '{}',
+  metadata jsonb DEFAULT '{}',
+  is_active boolean NOT NULL DEFAULT true,
+  is_deleted boolean NOT NULL DEFAULT false,
+  created_by uuid,
+  updated_by uuid,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE public.frm_templates ENABLE ROW LEVEL SECURITY;
+
+CREATE INDEX IF NOT EXISTS idx_frm_templates_tenant
+  ON public.frm_templates(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_frm_templates_parent
+  ON public.frm_templates(parent_id);
+CREATE INDEX IF NOT EXISTS idx_frm_templates_category
+  ON public.frm_templates(tenant_id, category);
+CREATE INDEX IF NOT EXISTS idx_frm_templates_current
+  ON public.frm_templates(tenant_id, is_current, is_active)
+  WHERE is_current = true AND is_active = true AND is_deleted = false;
+
+CREATE POLICY "frm_templates_select" ON public.frm_templates
+  FOR SELECT TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_templates_insert" ON public.frm_templates
+  FOR INSERT TO authenticated
+  WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_templates_update" ON public.frm_templates
+  FOR UPDATE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_templates_delete" ON public.frm_templates
+  FOR DELETE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+
+-- frm_documents: filled form instances
+CREATE TABLE IF NOT EXISTS public.frm_documents (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  template_id uuid NOT NULL REFERENCES public.frm_templates(id),
+  person_id uuid REFERENCES saas_core.persons(id) ON DELETE SET NULL,
+  title text,
+  data jsonb NOT NULL DEFAULT '{}',
+  status text NOT NULL DEFAULT 'draft',
+  signed_at timestamptz,
+  signed_by uuid,
+  notes text,
+  metadata jsonb DEFAULT '{}',
+  is_deleted boolean NOT NULL DEFAULT false,
+  created_by uuid,
+  updated_by uuid,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE public.frm_documents ENABLE ROW LEVEL SECURITY;
+
+CREATE INDEX IF NOT EXISTS idx_frm_documents_tenant
+  ON public.frm_documents(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_frm_documents_person
+  ON public.frm_documents(person_id);
+CREATE INDEX IF NOT EXISTS idx_frm_documents_template
+  ON public.frm_documents(template_id);
+CREATE INDEX IF NOT EXISTS idx_frm_documents_status
+  ON public.frm_documents(tenant_id, status);
+
+CREATE POLICY "frm_documents_select" ON public.frm_documents
+  FOR SELECT TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_documents_insert" ON public.frm_documents
+  FOR INSERT TO authenticated
+  WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_documents_update" ON public.frm_documents
+  FOR UPDATE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_documents_delete" ON public.frm_documents
+  FOR DELETE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+
+-- frm_document_files: file attachments for image/gallery/drawing fields
+CREATE TABLE IF NOT EXISTS public.frm_document_files (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  document_id uuid NOT NULL REFERENCES public.frm_documents(id) ON DELETE CASCADE,
+  field_key text NOT NULL,
+  file_url text NOT NULL,
+  file_name text,
+  file_size integer,
+  mime_type text,
+  sort_order integer DEFAULT 0,
+  metadata jsonb DEFAULT '{}',
+  created_at timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE public.frm_document_files ENABLE ROW LEVEL SECURITY;
+
+CREATE INDEX IF NOT EXISTS idx_frm_document_files_document
+  ON public.frm_document_files(document_id);
+
+CREATE POLICY "frm_document_files_select" ON public.frm_document_files
+  FOR SELECT TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_document_files_insert" ON public.frm_document_files
+  FOR INSERT TO authenticated
+  WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_document_files_update" ON public.frm_document_files
+  FOR UPDATE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_document_files_delete" ON public.frm_document_files
+  FOR DELETE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+
+-- View: frm_documents with template name joined
+CREATE OR REPLACE VIEW public.v_frm_documents AS
+SELECT
+  d.*,
+  t.name AS template_name,
+  t.category AS template_category,
+  p.name AS person_name
+FROM public.frm_documents d
+LEFT JOIN public.frm_templates t ON t.id = d.template_id
+LEFT JOIN saas_core.persons p ON p.id = d.person_id;

package/src/migrations/002_document_archetype.sql

@@ -0,0 +1,135 @@
+-- ============================================================
+-- Document Archetype — saas_core.documents
+-- A document is any record associated with a person (or standalone):
+-- forms, images, attachments, prescriptions, contracts, etc.
+-- The `kind` column discriminates the type.
+-- ============================================================
+
+CREATE TABLE IF NOT EXISTS saas_core.documents (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  kind text NOT NULL DEFAULT 'attachment',
+  -- kind: 'form', 'image', 'attachment', 'prescription', 'contract', etc.
+  person_id uuid REFERENCES saas_core.persons(id) ON DELETE SET NULL,
+  title text,
+  description text,
+  status text NOT NULL DEFAULT 'draft',
+  -- status: 'draft', 'completed', 'signed', 'archived'
+  file_url text,
+  file_name text,
+  file_size integer,
+  mime_type text,
+  tags text[] DEFAULT '{}',
+  notes text,
+  is_active boolean NOT NULL DEFAULT true,
+  metadata jsonb DEFAULT '{}',
+  created_by uuid,
+  updated_by uuid,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE saas_core.documents ENABLE ROW LEVEL SECURITY;
+
+CREATE INDEX IF NOT EXISTS idx_documents_tenant ON saas_core.documents(tenant_id, kind);
+CREATE INDEX IF NOT EXISTS idx_documents_person ON saas_core.documents(person_id);
+CREATE INDEX IF NOT EXISTS idx_documents_status ON saas_core.documents(tenant_id, status);
+
+CREATE POLICY "documents_select" ON saas_core.documents
+  FOR SELECT TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "documents_insert" ON saas_core.documents
+  FOR INSERT TO authenticated
+  WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "documents_update" ON saas_core.documents
+  FOR UPDATE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "documents_delete" ON saas_core.documents
+  FOR DELETE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+
+-- ============================================================
+-- Alter frm_documents to become extension table for 'form' kind
+-- ============================================================
+
+-- Drop old frm_documents and recreate as extension
+DROP VIEW IF EXISTS public.v_frm_documents;
+DROP TABLE IF EXISTS public.frm_document_files;
+DROP TABLE IF EXISTS public.frm_documents;
+
+-- frm_documents: extension table for form-type documents
+CREATE TABLE public.frm_documents (
+  document_id uuid PRIMARY KEY REFERENCES saas_core.documents(id) ON DELETE CASCADE,
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  template_id uuid NOT NULL REFERENCES public.frm_templates(id),
+  data jsonb NOT NULL DEFAULT '{}',
+  signed_at timestamptz,
+  signed_by uuid,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE public.frm_documents ENABLE ROW LEVEL SECURITY;
+
+CREATE INDEX IF NOT EXISTS idx_frm_documents_template ON public.frm_documents(template_id);
+
+CREATE POLICY "frm_documents_select" ON public.frm_documents
+  FOR SELECT TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_documents_insert" ON public.frm_documents
+  FOR INSERT TO authenticated
+  WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_documents_update" ON public.frm_documents
+  FOR UPDATE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_documents_delete" ON public.frm_documents
+  FOR DELETE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+
+-- frm_document_files: file attachments for form fields
+CREATE TABLE public.frm_document_files (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  document_id uuid NOT NULL REFERENCES saas_core.documents(id) ON DELETE CASCADE,
+  field_key text NOT NULL,
+  file_url text NOT NULL,
+  file_name text,
+  file_size integer,
+  mime_type text,
+  sort_order integer DEFAULT 0,
+  metadata jsonb DEFAULT '{}',
+  created_at timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE public.frm_document_files ENABLE ROW LEVEL SECURITY;
+
+CREATE INDEX IF NOT EXISTS idx_frm_document_files_document ON public.frm_document_files(document_id);
+
+CREATE POLICY "frm_document_files_select" ON public.frm_document_files
+  FOR SELECT TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_document_files_insert" ON public.frm_document_files
+  FOR INSERT TO authenticated
+  WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_document_files_update" ON public.frm_document_files
+  FOR UPDATE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY "frm_document_files_delete" ON public.frm_document_files
+  FOR DELETE TO authenticated
+  USING (tenant_id IN (SELECT public.user_tenant_ids()));
+
+-- View: all documents for a person with form data joined when applicable
+CREATE OR REPLACE VIEW public.v_documents AS
+SELECT
+  d.*,
+  f.template_id,
+  f.data AS form_data,
+  f.signed_at,
+  f.signed_by,
+  t.name AS template_name,
+  t.category AS template_category,
+  p.name AS person_name
+FROM saas_core.documents d
+LEFT JOIN public.frm_documents f ON f.document_id = d.id
+LEFT JOIN public.frm_templates t ON t.id = f.template_id
+LEFT JOIN saas_core.persons p ON p.id = d.person_id;

package/src/store.ts

@@ -0,0 +1,167 @@
+import { create } from 'zustand'
+import type { CustomFormsDataProvider } from './data/types'
+import type {
+  FormTemplate,
+  FormDocument,
+  TemplateQuery,
+  DocumentQuery,
+  CreateTemplateInput,
+  UpdateTemplateInput,
+  CreateDocumentInput,
+  UpdateDocumentInput,
+} from './types'
+
+export interface CustomFormsState {
+  // Templates
+  templates: FormTemplate[]
+  templatesTotal: number
+  templatesLoading: boolean
+  templatesError: string | null
+
+  // Documents
+  documents: FormDocument[]
+  documentsTotal: number
+  documentsLoading: boolean
+  documentsError: string | null
+
+  // Active template (for builder)
+  activeTemplate: FormTemplate | null
+  activeTemplateLoading: boolean
+
+  // Active document (for viewer/editor)
+  activeDocument: FormDocument | null
+  activeDocumentLoading: boolean
+
+  // Actions
+  fetchTemplates(query?: TemplateQuery): Promise<void>
+  fetchTemplateById(id: string): Promise<FormTemplate | null>
+  createTemplate(input: CreateTemplateInput): Promise<FormTemplate>
+  updateTemplate(id: string, input: UpdateTemplateInput): Promise<FormTemplate>
+  deleteTemplate(id: string): Promise<void>
+
+  fetchDocuments(query?: DocumentQuery): Promise<void>
+  fetchDocumentById(id: string): Promise<FormDocument | null>
+  createDocument(input: CreateDocumentInput): Promise<FormDocument>
+  updateDocument(id: string, input: UpdateDocumentInput): Promise<FormDocument>
+  deleteDocument(id: string): Promise<void>
+}
+
+export function createCustomFormsStore(provider: CustomFormsDataProvider) {
+  return create<CustomFormsState>((set) => ({
+    templates: [],
+    templatesTotal: 0,
+    templatesLoading: false,
+    templatesError: null,
+
+    documents: [],
+    documentsTotal: 0,
+    documentsLoading: false,
+    documentsError: null,
+
+    activeTemplate: null,
+    activeTemplateLoading: false,
+
+    activeDocument: null,
+    activeDocumentLoading: false,
+
+    async fetchTemplates(query?: TemplateQuery) {
+      set({ templatesLoading: true, templatesError: null })
+      try {
+        const result = await provider.getTemplates(query ?? {})
+        set({ templates: result.data, templatesTotal: result.total })
+      } catch (e: any) {
+        set({ templatesError: e.message ?? 'Failed to fetch templates' })
+      } finally {
+        set({ templatesLoading: false })
+      }
+    },
+
+    async fetchTemplateById(id: string) {
+      set({ activeTemplateLoading: true })
+      try {
+        const template = await provider.getTemplateById(id)
+        set({ activeTemplate: template })
+        return template
+      } catch {
+        set({ activeTemplate: null })
+        return null
+      } finally {
+        set({ activeTemplateLoading: false })
+      }
+    },
+
+    async createTemplate(input: CreateTemplateInput) {
+      const template = await provider.createTemplate(input)
+      set((s) => ({ templates: [template, ...s.templates], templatesTotal: s.templatesTotal + 1 }))
+      return template
+    },
+
+    async updateTemplate(id: string, input: UpdateTemplateInput) {
+      const template = await provider.updateTemplate(id, input)
+      set((s) => ({
+        templates: s.templates.map((t) => (t.id === id ? template : t)),
+        activeTemplate: s.activeTemplate?.id === id ? template : s.activeTemplate,
+      }))
+      return template
+    },
+
+    async deleteTemplate(id: string) {
+      await provider.deleteTemplate(id)
+      set((s) => ({
+        templates: s.templates.filter((t) => t.id !== id),
+        templatesTotal: s.templatesTotal - 1,
+      }))
+    },
+
+    async fetchDocuments(query?: DocumentQuery) {
+      set({ documentsLoading: true, documentsError: null })
+      try {
+        const result = await provider.getDocuments(query ?? {})
+        set({ documents: result.data, documentsTotal: result.total })
+      } catch (e: any) {
+        set({ documentsError: e.message ?? 'Failed to fetch documents' })
+      } finally {
+        set({ documentsLoading: false })
+      }
+    },
+
+    async fetchDocumentById(id: string) {
+      set({ activeDocumentLoading: true })
+      try {
+        const doc = await provider.getDocumentById(id)
+        set({ activeDocument: doc })
+        return doc
+      } catch {
+        set({ activeDocument: null })
+        return null
+      } finally {
+        set({ activeDocumentLoading: false })
+      }
+    },
+
+    async createDocument(input: CreateDocumentInput) {
+      const doc = await provider.createDocument(input)
+      set((s) => ({ documents: [doc, ...s.documents], documentsTotal: s.documentsTotal + 1 }))
+      return doc
+    },
+
+    async updateDocument(id: string, input: UpdateDocumentInput) {
+      const doc = await provider.updateDocument(id, input)
+      set((s) => ({
+        documents: s.documents.map((d) => (d.id === id ? doc : d)),
+        activeDocument: s.activeDocument?.id === id ? doc : s.activeDocument,
+      }))
+      return doc
+    },
+
+    async deleteDocument(id: string) {
+      await provider.deleteDocument(id)
+      set((s) => ({
+        documents: s.documents.filter((d) => d.id !== id),
+        documentsTotal: s.documentsTotal - 1,
+      }))
+    },
+  }))
+}
+
+export type CustomFormsStore = ReturnType<typeof createCustomFormsStore>