@fayz-ai/plugin-forms 0.9.0 → 0.9.2

package/src/store.ts

@@ -1,167 +0,0 @@
-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>

package/src/types.ts

@@ -1,217 +0,0 @@
-// ============================================================
-// FORM FIELD TYPES (builder palette)
-// ============================================================
-
-export type FormFieldType =
-  | 'title'      // Section heading (no input)
-  | 'text'       // Texto Simples
-  | 'memo'       // Memorando (multiline plain text)
-  | 'richtext'   // Texto Rico
-  | 'date'       // Data
-  | 'select'     // Seleção
-  | 'radio'      // Radio
-  | 'tags'       // Tags (multiselect chips)
-  | 'checkbox'   // Checkbox
-  | 'image'      // Imagem / Desenho
-  | 'gallery'    // Galeria
-  | 'budget'     // Orçamento (line items + prices)
-
-// ============================================================
-// FORM FIELD DEFINITION (stored in template.schema.fields[])
-// ============================================================
-
-export interface FormFieldDef {
-  id: string
-  type: FormFieldType
-  label: string
-  placeholder?: string
-  required?: boolean
-  /** Start column (0-based) */
-  col: number
-  /** Row index */
-  row: number
-  /** Column span (1–12) */
-  colSpan: number
-  /** Row span (default: 1) */
-  rowSpan?: number
-  /** Options for select / radio / tags */
-  options?: Array<{ label: string; value: string }>
-  /**
-   * Optional binding to a field on the person/contact record. When set, a new
-   * document created from a person's profile is pre-filled with that person's
-   * value (e.g. `map: 'documentNumber'` fills the field with the person's CPF).
-   * Matched tolerantly against camelCase/snake_case record keys. Only prefills
-   * empty fields; the user can still edit the value. See `lib/person-fields`.
-   */
-  map?: string
-  /**
-   * Static default value applied to a NEW document when the field has no mapped
-   * person value and no existing value — e.g. pre-written contract clause text
-   * on a richtext field. Editable by the user.
-   */
-  defaultValue?: unknown
-  /** Type-specific configuration */
-  config?: Record<string, unknown>
-}
-
-export interface FormSchema {
-  fields: FormFieldDef[]
-  layout: { columns: 12 }
-}
-
-// ============================================================
-// TEMPLATE (maps to plg_forms_templates)
-// ============================================================
-
-export type TemplateCategory =
-  | 'anamnesis'
-  | 'evolution'
-  | 'report'
-  | 'contract'
-  | 'general'
-
-export interface FormTemplate {
-  id: string
-  tenantId: string
-  name: string
-  description?: string
-  category: TemplateCategory
-  version: number
-  isCurrent: boolean
-  parentId?: string
-  schema: FormSchema
-  specialty?: string
-  tags: string[]
-  metadata: Record<string, unknown>
-  isActive: boolean
-  isDeleted: boolean
-  createdBy?: string
-  updatedBy?: string
-  createdAt: string
-  updatedAt: string
-}
-
-// ============================================================
-// DOCUMENT (maps to plg_forms_documents)
-// ============================================================
-
-export type DocumentStatus = 'draft' | 'completed' | 'signed' | 'archived'
-
-export interface FormDocument {
-  id: string
-  tenantId: string
-  templateId: string
-  templateName?: string
-  templateCategory?: TemplateCategory
-  personId?: string
-  personName?: string
-  title?: string
-  data: Record<string, unknown>
-  status: DocumentStatus
-  signedAt?: string
-  signedBy?: string
-  notes?: string
-  metadata: Record<string, unknown>
-  isDeleted: boolean
-  createdBy?: string
-  updatedBy?: string
-  createdAt: string
-  updatedAt: string
-  /** Document kind from public.documents */
-  kind?: string
-  /** File URL for image/attachment documents */
-  fileUrl?: string
-  fileName?: string
-  fileSize?: number
-  mimeType?: string
-}
-
-// ============================================================
-// DOCUMENT FILE (maps to plg_forms_document_files)
-// ============================================================
-
-export interface DocumentFile {
-  id: string
-  tenantId: string
-  documentId: string
-  fieldKey: string
-  fileUrl: string
-  fileName?: string
-  fileSize?: number
-  mimeType?: string
-  sortOrder: number
-  metadata: Record<string, unknown>
-  createdAt: string
-}
-
-// ============================================================
-// QUERIES
-// ============================================================
-
-export interface TemplateQuery {
-  category?: TemplateCategory
-  search?: string
-  page?: number
-  pageSize?: number
-}
-
-export interface DocumentQuery {
-  personId?: string
-  templateId?: string
-  status?: DocumentStatus | DocumentStatus[]
-  search?: string
-  page?: number
-  pageSize?: number
-}
-
-export interface PaginatedResult<T> {
-  data: T[]
-  total: number
-}
-
-// ============================================================
-// INPUTS
-// ============================================================
-
-export interface CreateTemplateInput {
-  name: string
-  description?: string
-  category: TemplateCategory
-  schema: FormSchema
-  specialty?: string
-  tags?: string[]
-  metadata?: Record<string, unknown>
-}
-
-export interface UpdateTemplateInput {
-  name?: string
-  description?: string
-  category?: TemplateCategory
-  schema?: FormSchema
-  specialty?: string
-  tags?: string[]
-  metadata?: Record<string, unknown>
-  isActive?: boolean
-}
-
-export interface CreateDocumentInput {
-  templateId?: string
-  personId?: string
-  title?: string
-  data?: Record<string, unknown>
-  status?: DocumentStatus
-  /** Document kind: 'form', 'image', 'attachment', etc. */
-  kind?: string
-  /** File fields for non-form documents */
-  fileUrl?: string
-  fileName?: string
-  fileSize?: number
-  mimeType?: string
-}
-
-export interface UpdateDocumentInput {
-  data?: Record<string, unknown>
-  status?: DocumentStatus
-  title?: string
-  notes?: string
-}

package/src/views/CustomFormsSettingsTab.tsx

@@ -1,105 +0,0 @@
-import React, { useState, useCallback } from 'react'
-import { TemplateListView } from './TemplateListView'
-import type { CustomFormsConfig } from '../config'
-import type { CustomFormsDataProvider } from '../data/types'
-import type { CustomFormsStore } from '../store'
-import type { FormTemplate } from '../types'
-
-interface CustomFormsSettingsTabProps {
-  config: CustomFormsConfig
-  provider: CustomFormsDataProvider
-  store: CustomFormsStore
-}
-
-const ROUTE_BASE = '/settings/custom_forms'
-
-/** Read the currently-open template id from the URL hash (the source of truth,
- *  so deep links and browser back/forward work like any CRUD detail page). */
-function readBuilderIdFromHash(): string | null {
-  const hash = window.location.hash.slice(1) || '/'
-  const m = hash.match(/\/settings\/custom_forms\/templates\/([^/]+)/)
-  if (!m) return null
-  return m[1] === 'new' ? '__new__' : m[1]
-}
-
-export function CustomFormsSettingsTab({ config, provider, store }: CustomFormsSettingsTabProps) {
-  // URL is the source of truth — opening/closing a template updates the hash,
-  // so the record id shows in the URL just like opening a CRUD record.
-  const [builderTemplateId, setBuilderTemplateId] = useState<string | null>(readBuilderIdFromHash)
-
-  const handleNew = useCallback(() => {
-    window.location.hash = `#${ROUTE_BASE}/templates/new`
-  }, [])
-
-  const handleEdit = useCallback((template: FormTemplate) => {
-    window.location.hash = `#${ROUTE_BASE}/templates/${template.id}`
-  }, [])
-
-  const handleBackFromBuilder = useCallback(() => {
-    // Return to the list route and re-fetch templates to reflect any saves.
-    window.location.hash = `#${ROUTE_BASE}/forms`
-    store.getState().fetchTemplates()
-  }, [store])
-
-  // Keep local state in sync with the URL (deep links, back/forward, and our
-  // own hash writes above all flow through here).
-  React.useEffect(() => {
-    const sync = () => setBuilderTemplateId(readBuilderIdFromHash())
-    window.addEventListener('hashchange', sync)
-    return () => window.removeEventListener('hashchange', sync)
-  }, [])
-
-  return builderTemplateId ? (
-    <BuilderWrapper
-      templateId={builderTemplateId === '__new__' ? undefined : builderTemplateId}
-      store={store}
-      provider={provider}
-      config={config}
-      onBack={handleBackFromBuilder}
-    />
-  ) : (
-    <TemplateListView
-      store={store}
-      config={config}
-      onEdit={handleEdit}
-      onNew={handleNew}
-    />
-  )
-}
-
-/** Lazy-loads the FormBuilder to avoid pulling @dnd-kit into the initial bundle */
-function BuilderWrapper({
-  templateId,
-  store,
-  provider,
-  config,
-  onBack,
-}: {
-  templateId?: string
-  store: CustomFormsStore
-  provider: CustomFormsDataProvider
-  config: CustomFormsConfig
-  onBack: () => void
-}) {
-  const FormBuilderLazy = React.lazy(() =>
-    import('../components/FormBuilder').then((m) => ({ default: m.FormBuilder })),
-  )
-
-  return (
-    <React.Suspense
-      fallback={
-        <div className="flex items-center justify-center py-12">
-          <div className="h-6 w-6 border-2 border-primary border-t-transparent animate-spin rounded-full" />
-        </div>
-      }
-    >
-      <FormBuilderLazy
-        templateId={templateId}
-        store={store}
-        provider={provider}
-        config={config}
-        onBack={onBack}
-      />
-    </React.Suspense>
-  )
-}

package/src/views/TemplateListView.tsx

@@ -1,174 +0,0 @@
-import React, { useEffect, useState, useCallback } from 'react'
-import { Plus, Pencil, Archive, FileText, Search } from 'lucide-react'
-import { Button } from '@fayz-ai/ui'
-import { Card, CardContent } from '@fayz-ai/ui'
-import { Badge } from '@fayz-ai/ui'
-import { Input } from '@fayz-ai/ui'
-import { PermissionGate } from '@fayz-ai/saas'
-import { useTranslation } from '@fayz-ai/core'
-import { getFormsTenantId } from '../lib/tenant'
-import type { CustomFormsStore } from '../store'
-import type { CustomFormsConfig } from '../config'
-import type { FormTemplate, TemplateCategory } from '../types'
-
-interface TemplateListViewProps {
-  store: CustomFormsStore
-  config: CustomFormsConfig
-  onEdit: (template: FormTemplate) => void
-  onNew: () => void
-}
-
-const CATEGORY_COLORS: Record<TemplateCategory, string> = {
-  anamnesis: 'bg-info-soft text-info-soft-foreground',
-  evolution: 'bg-success-soft text-success-soft-foreground',
-  report: 'bg-magic-soft text-magic-soft-foreground',
-  contract: 'bg-warning-soft text-warning-soft-foreground',
-  general: 'bg-muted text-muted-foreground',
-}
-
-export function TemplateListView({ store, config, onEdit, onNew }: TemplateListViewProps) {
-  const t = useTranslation()
-  const [search, setSearch] = useState('')
-
-  // Subscribe to zustand store reactively
-  const templates = store((s) => s.templates)
-  const loading = store((s) => s.templatesLoading)
-
-  const orgId = getFormsTenantId()
-
-  // Fetch when org is ready or search changes — debounce to avoid Strict Mode double-fire
-  useEffect(() => {
-    if (!orgId) return
-    const timer = setTimeout(() => {
-      store.getState().fetchTemplates({ search: search || undefined })
-    }, 50)
-    return () => clearTimeout(timer)
-  }, [orgId, search])
-
-  // Archive, not delete: deactivate the template so it drops out of the list
-  // and the "add document" picker, without destroying it or its documents.
-  const handleArchive = useCallback(async (template: FormTemplate) => {
-    if (!window.confirm(t('customForms.archiveTemplateConfirm'))) return
-    await store.getState().updateTemplate(template.id, { isActive: false })
-  }, [store, t])
-
-  // Archived (isActive=false) templates stay in the store but leave the view.
-  const visibleTemplates = templates.filter((tpl) => tpl.isActive !== false)
-
-  const categoryLabel = (cat: TemplateCategory) =>
-    t(`customForms.category.${cat}`)
-
-  return (
-    <div className="space-y-4">
-      {/* Search + New */}
-      <div className="flex items-center gap-3">
-        <div className="relative flex-1 max-w-xs">
-          <Search className="absolute left-2.5 top-1/2 -translate-y-1/2 h-3.5 w-3.5 text-muted-foreground" />
-          <Input
-            value={search}
-            onChange={(e) => setSearch(e.target.value)}
-            placeholder={t('common.search')}
-            className="h-9 pl-8 text-sm"
-          />
-        </div>
-        <PermissionGate feature="custom_forms" action="create">
-          <Button onClick={onNew} size="sm" className="h-9">
-            <Plus className="h-3.5 w-3.5 mr-1.5" />
-            {t('customForms.newTemplate')}
-          </Button>
-        </PermissionGate>
-      </div>
-
-      {/* Empty state */}
-      {!loading && visibleTemplates.length === 0 && (
-        <Card>
-          <CardContent className="flex flex-col items-center justify-center py-16 text-center">
-            <div className="flex h-12 w-12 items-center justify-center rounded-full bg-muted mb-4">
-              <FileText className="h-5 w-5 text-muted-foreground" />
-            </div>
-            <p className="font-medium">{t('customForms.noTemplates')}</p>
-            <p className="text-sm text-muted-foreground mt-1 max-w-sm">
-              {t('customForms.noTemplatesDescription')}
-            </p>
-            <PermissionGate feature="custom_forms" action="create">
-              <Button onClick={onNew} size="sm" className="mt-4">
-                <Plus className="h-3.5 w-3.5 mr-1.5" />
-                {t('customForms.newTemplate')}
-              </Button>
-            </PermissionGate>
-          </CardContent>
-        </Card>
-      )}
-
-      {/* Template list */}
-      {visibleTemplates.length > 0 && (
-        <div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-3">
-          {visibleTemplates.map((template) => (
-            <Card
-              key={template.id}
-              className="group cursor-pointer hover:shadow-md transition-shadow"
-              onClick={() => onEdit(template)}
-            >
-              <CardContent className="p-4">
-                <div className="flex items-start justify-between gap-2">
-                  <div className="min-w-0 flex-1">
-                    <h3 className="font-medium text-sm truncate">{template.name}</h3>
-                    {template.description && (
-                      <p className="text-xs text-muted-foreground mt-0.5 line-clamp-2">
-                        {template.description}
-                      </p>
-                    )}
-                  </div>
-                  <div className="flex gap-1 opacity-0 group-hover:opacity-100 transition-opacity">
-                    <button
-                      onClick={(e) => { e.stopPropagation(); onEdit(template) }}
-                      className="p-1.5 rounded-md hover:bg-muted"
-                    >
-                      <Pencil className="h-3.5 w-3.5 text-muted-foreground" />
-                    </button>
-                    <button
-                      onClick={(e) => { e.stopPropagation(); handleArchive(template) }}
-                      className="p-1.5 rounded-md hover:bg-muted"
-                      title={t('customForms.archive')}
-                    >
-                      <Archive className="h-3.5 w-3.5 text-muted-foreground" />
-                    </button>
-                  </div>
-                </div>
-                <div className="flex items-center gap-2 mt-3">
-                  <Badge variant="secondary" className={`text-[10px] ${CATEGORY_COLORS[template.category]}`}>
-                    {categoryLabel(template.category)}
-                  </Badge>
-                  <span className="text-[10px] text-muted-foreground">
-                    {template.schema.fields.length} {t('customForms.builder.fields').toLowerCase()}
-                  </span>
-                  {template.version > 1 && (
-                    <span className="text-[10px] text-muted-foreground">v{template.version}</span>
-                  )}
-                </div>
-              </CardContent>
-            </Card>
-          ))}
-        </div>
-      )}
-
-      {/* Loading skeleton */}
-      {loading && (
-        <div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-3">
-          {Array.from({ length: 3 }).map((_, i) => (
-            <Card key={i}>
-              <CardContent className="p-4 space-y-3">
-                <div className="h-4 w-2/3 bg-muted animate-pulse rounded" />
-                <div className="h-3 w-full bg-muted animate-pulse rounded" />
-                <div className="flex gap-2">
-                  <div className="h-5 w-16 bg-muted animate-pulse rounded-full" />
-                  <div className="h-5 w-12 bg-muted animate-pulse rounded-full" />
-                </div>
-              </CardContent>
-            </Card>
-          ))}
-        </div>
-      )}
-    </div>
-  )
-}