forlogic-core 2.3.3 → 2.3.5

package/dist/sign/types.d.ts

@@ -1,603 +1,53 @@
-import React from 'react';
-export type LoadingState = 'idle' | 'loading' | 'success' | 'error';
-export type ViewMode = 'table';
-export type SortDirection = 'asc' | 'desc';
-export type ActionType = 'create' | 'update' | 'delete' | 'fetch' | 'export';
-/**
- * Interface mínima que **toda** entidade da plataforma deve estender.
- *
- * Reflete os campos obrigatórios de qualquer tabela multi-tenant: `id`, `alias` (tenant),
- * timestamps e flags de soft delete (`is_removed`) e ativação (`is_actived`).
- *
- * @example
- * // Estendendo para uma entidade de domínio
- * interface ActionPlan extends BaseEntity {
- *   title: string;
- *   description: string | null;
- *   status: 'pending' | 'in_progress' | 'completed';
- *   id_user: string;
- * }
- *
- * @example
- * // Uso genérico em hooks/serviços CRUD
- * function useEntities<T extends BaseEntity>(table: string) {
- *   return useQuery<T[]>(['entities', table], () => fetchAll(table));
- * }
- */
-export interface BaseEntity {
+export type SignProvider = 'clicksign' | 'd4sign';
+export interface SignConfig {
     id: string;
     alias: string;
+    provider: SignProvider;
+    api_key: string;
+    crypt_key: string | null;
+    uuid_safe: string | null;
+    environment: 'sandbox' | 'production';
+    monthly_limit: number | null;
     created_at: string;
     updated_at: string;
-    is_removed: boolean;
-    is_actived: boolean;
+    deleted_at: string | null;
 }
-/**
- * BaseEntityPayload - Payload básico para criação de entidades
- * IMPORTANTE: Customize conforme as propriedades da sua entidade específica
- */
-export interface BaseEntityPayload {
-    alias: string;
-}
-export interface QueryParams {
-    page?: number;
-    limit?: number;
-    search?: string;
-    sortField?: string;
-    sortDirection?: SortDirection;
-}
-export interface PaginatedResponse<T = unknown> {
-    data: T[];
-    currentPage: number;
-    totalPages: number;
-    totalItems: number;
-    itemsPerPage: number;
-    hasNextPage: boolean;
-    hasPreviousPage: boolean;
-}
-export interface SortState {
-    field: string;
-    direction: SortDirection;
-}
-export interface CrudManager<T extends BaseEntity> {
-    entities: T[];
-    pagination: PaginatedResponse<T>;
-    isLoading: boolean;
-    isDeleting: boolean;
-    searchTerm: string;
-    sortField: string;
-    sortDirection: SortDirection;
-    currentPage: number;
-    itemsPerPage: number;
-    handleSearch: (search: string) => void;
-    handleSort: (field: string) => void;
-    handlePageChange: (page: number) => void;
-    handleItemsPerPageChange: (limit: number) => void;
-    clearFilters: () => void;
-    deleteEntity: (id: string) => void;
-    refetch: () => void;
-    selectedIds: string[];
-    selectItem: (id: string) => void;
-    selectAll: () => void;
-    clearSelection: () => void;
-    isAllSelected: boolean;
-    bulkDelete?: (ids: string[]) => Promise<void>;
-    isBulkDeleting?: boolean;
-}
-export interface CrudEntity extends BaseEntity {
-}
-/**
- * Definição de coluna usada por {@link CrudTable} e `createCrudPage`.
- *
- * Suporta tipagem semântica (`type`), ordenação (default `true`), filtros, busca textual,
- * renderização customizada e larguras controladas.
- *
- * @example
- * const columns: CrudColumn<ActionPlan>[] = [
- *   { key: 'title', header: 'Título', type: 'text', searchable: true, weight: 3 },
- *   {
- *     key: 'status',
- *     header: 'Status',
- *     type: 'select',
- *     options: [
- *       { label: 'Pendente', value: 'pending' },
- *       { label: 'Concluído', value: 'completed' },
- *     ],
- *     filterable: true,
- *     render: (row) => <StatusBadge status={row.status} />,
- *   },
- *   {
- *     key: 'created_at',
- *     header: 'Criado em',
- *     type: 'date',
- *     sortable: true,
- *     render: (row) => formatDatetime(row.created_at),
- *   },
- *   { key: 'id_user', header: 'Responsável', minWidth: 180 },
- * ];
- */
-export interface CrudColumn<T = any> {
-    key: keyof T;
-    header: string;
-    label?: string;
-    type?: 'text' | 'number' | 'date' | 'boolean' | 'select' | 'textarea' | 'email' | 'tel';
-    required?: boolean;
-    /** Coluna é ordenável. Default: true. Use `false` para desabilitar. */
-    sortable?: boolean;
-    filterable?: boolean;
-    searchable?: boolean;
-    options?: Array<{
-        label: string;
-        value: any;
-    }>;
-    render?: (item: T) => React.ReactNode;
-    validation?: (value: any) => string | undefined;
-    className?: string;
-    /** Minimum width in pixels (only applied in desktop view) */
-    minWidth?: number;
-    /** Maximum width in pixels for column resize */
-    maxWidth?: number;
-    /** Flex weight for distributing remaining space (only applied in desktop view) */
-    weight?: number;
-    /** Fixed width (overrides minWidth and weight) */
-    width?: number;
-    /** Whether the column can be resized (default: true when enableColumnResize is enabled) */
-    resizable?: boolean;
-    /** Whether the column can be hidden via column manager (default: true) */
-    hideable?: boolean;
-    /** Whether the column can be used for grouping (default: false) */
-    groupable?: boolean;
-}
-/**
- * Filtro customizado para páginas CRUD
- *
- * Permite adicionar filtros personalizados (busca, selects, checkboxes, etc)
- * nas páginas CRUD geradas automaticamente.
- *
- * **Tipos de filtro:**
- * - `'search'`: Campo de busca padrão (integrado com `manager.searchTerm`)
- * - `'select'`: Select nativo com opções predefinidas
- * - `'custom'`: Componente React customizado (Select, Checkbox, etc)
- *
- * **Posicionamento:**
- * - Desktop: Filtros aparecem inline na Action Bar (ao lado do botão "Novo")
- * - Mobile: Filtros empilhados verticalmente abaixo do botão "Novo"
- *
- * @example
- * ```typescript
- * // Filtro de busca padrão
- * const filters: CrudFilter[] = [
- *   { type: 'search' }
- * ];
- *
- * // Filtro select nativo
- * const filters: CrudFilter[] = [
- *   {
- *     type: 'select',
- *     placeholder: 'Filtrar por status',
- *     options: [
- *       { label: 'Todos', value: 'all' },
- *       { label: 'Ativos', value: 'active' },
- *       { label: 'Inativos', value: 'inactive' }
- *     ],
- *     value: statusFilter,
- *     onChange: setStatusFilter
- *   }
- * ];
- *
- * // Filtro customizado com Select
- * import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from 'forlogic-core';
- *
- * const filters: CrudFilter[] = [
- *   {
- *     type: 'custom',
- *     component: ({ value, onChange }) => (
- *       <Select value={value} onValueChange={onChange}>
- *         <SelectTrigger className="w-[180px]">
- *           <SelectValue placeholder="Status" />
- *         </SelectTrigger>
- *         <SelectContent>
- *           <SelectItem value="all">Todos</SelectItem>
- *           <SelectItem value="active">Ativos</SelectItem>
- *           <SelectItem value="inactive">Inativos</SelectItem>
- *         </SelectContent>
- *       </Select>
- *     ),
- *     props: { value: statusFilter, onChange: setStatusFilter }
- *   }
- * ];
- * ```
- *
- * @example
- * ```typescript
- * // Múltiplos filtros customizados
- * function ProcessesPage() {
- *   const [statusFilter, setStatusFilter] = useState('all');
- *   const [typeFilter, setTypeFilter] = useState('all');
- *
- *   const filters: CrudFilter[] = [
- *     { type: 'search' },
- *     {
- *       type: 'select',
- *       placeholder: 'Status',
- *       options: [
- *         { label: 'Todos', value: 'all' },
- *         { label: 'Ativos', value: 'active' },
- *         { label: 'Inativos', value: 'inactive' }
- *       ],
- *       value: statusFilter,
- *       onChange: setStatusFilter
- *     },
- *     {
- *       type: 'custom',
- *       component: TypeSelect,
- *       props: { value: typeFilter, onChange: setTypeFilter }
- *     }
- *   ];
- *
- *   // Filtrar dados baseado nos filtros customizados
- *   const filteredData = useMemo(() => {
- *     let data = manager.entities;
- *     if (statusFilter !== 'all') {
- *       data = data.filter(item => item.status === statusFilter);
- *     }
- *     if (typeFilter !== 'all') {
- *       data = data.filter(item => item.type === typeFilter);
- *     }
- *     return data;
- *   }, [manager.entities, statusFilter, typeFilter]);
- *
- *   return <CrudPage manager={{ ...manager, entities: filteredData }} />;
- * }
- * ```
- *
- * @see {@link FilterBar} - Componente que renderiza os filtros
- */
-export interface CrudFilter {
-    /** Tipo do filtro: 'search' para busca padrão, 'select' para select nativo, 'custom' para componente personalizado */
-    type: 'search' | 'select' | 'custom';
-    /** Placeholder para select (quando type='select') */
-    placeholder?: string;
-    /** Opções para select (quando type='select') */
-    options?: Array<{
-        label: string;
-        value: string;
-    }>;
-    /** Valor atual do filtro (quando type='select') */
-    value?: string;
-    /** Callback quando o valor muda (quando type='select') */
-    onChange?: (value: string) => void;
-    /** Componente React customizado (obrigatório quando type='custom') */
-    component?: React.ComponentType<any>;
-    /** Props passadas para o componente customizado (value, onChange, etc) */
-    props?: Record<string, any>;
-    /** Função para controlar visibilidade do filtro baseado no estado do manager */
-    show?: (manager: CrudManager<any>) => boolean;
-}
-export interface BulkAction<T extends BaseEntity> {
-    label: string;
-    icon?: React.ComponentType<{
-        size?: number;
-        className?: string;
-    }>;
-    variant?: 'default' | 'destructive' | 'outline';
-    action: (items: T[]) => void | Promise<void>;
-    confirmMessage?: string;
-    /** Se a ação está desabilitada */
-    disabled?: boolean;
-    /** Motivo do bloqueio (exibido em tooltip quando disabled=true) */
-    disabledReason?: string;
-}
-export interface CrudPageConfig<T extends CrudEntity> {
-    entityName: string;
-    entityNamePlural: string;
-    filters?: CrudFilter[];
-    columns: CrudColumn<T>[];
-    cardFields?: Array<{
-        key: keyof T;
-        label: string;
-        render?: (value: any, item: T) => React.ReactNode;
-    }>;
-    onNew?: () => void;
-    onEdit?: (entity: T) => void;
-    useCustomRouting?: boolean;
-    /** @deprecated Use showNewButton={false} instead */
-    hideNewButton?: boolean;
-    /** Exibir botão "Novo" (default: true) */
-    showNewButton?: boolean;
-    /** Texto customizado para o botão "Novo" */
-    newButtonLabel?: string;
-    newButtonText?: string;
-    title?: string;
-    searchPlaceholder?: string;
-    /** Exibir busca integrada na Action Bar (default: false - usa busca global) */
-    showSearch?: boolean;
-    /** Exibir Action Bar (default: true) */
-    showActionBar?: boolean;
-    enableBulkActions?: boolean;
-    bulkActions?: BulkAction<T>[];
-    customActions?: Array<{
-        label: string;
-        icon?: React.ComponentType<{
-            size?: number;
-            className?: string;
-        }>;
-        variant?: 'default' | 'destructive' | 'outline' | 'ghost';
-        action: () => void;
-        /** Se a ação está desabilitada */
-        disabled?: boolean;
-        /** Motivo do bloqueio (exibido em tooltip quando disabled=true) */
-        disabledReason?: string;
-    }>;
-    customRowActions?: (item: T) => Array<{
-        icon: any;
-        label: string;
-        onClick: () => void;
-    }>;
-    customListView?: (items: T[], manager?: CrudManager<T>) => React.ReactNode;
-    /** Colunas ocultas por padrão (antes de qualquer interação do usuário). */
-    defaultHiddenColumns?: string[];
-}
-export interface EntityWithId {
-    id: string | number;
-}
-export type CreateEntityInput<T extends EntityWithId> = Omit<T, 'id' | 'created_at' | 'updated_at'>;
-export type UpdateEntityInput<T extends EntityWithId> = Partial<CreateEntityInput<T>>;
-export interface GeneratedCrudConfig<T extends EntityWithId> {
-    title: string;
-    columns: CrudColumn<T>[];
-    searchPlaceholder?: string;
-    itemsPerPage?: number;
-    enableCreate?: boolean;
-    enableEdit?: boolean;
-    enableDelete?: boolean;
-    enableSearch?: boolean;
-    enableFilters?: boolean;
-    customActions?: Array<{
-        label: string;
-        icon?: React.ComponentType;
-        onClick: (item: T) => void;
-        variant?: 'default' | 'destructive' | 'outline';
-    }>;
-}
-export interface FormField {
-    name: string;
-    label: string;
-    type: 'text' | 'textarea' | 'select' | 'multiselect' | 'date' | 'datetime-local' | 'number' | 'user-select' | 'group' | 'checkbox' | 'switch' | 'email' | 'password' | 'color' | 'color-picker' | 'icon-picker' | 'custom';
-    required?: boolean;
-    disabled?: boolean;
-    options?: {
-        label: string;
-        value: string | number;
-    }[];
-    placeholder?: string;
-    component?: React.ComponentType<any>;
-    componentProps?: Record<string, any>;
-    value?: any;
-    defaultValue?: any;
-    dependsOn?: string;
-    computedValue?: (formData: any) => any;
-    validation?: {
-        custom?: (value: any, formData?: any) => string | undefined;
-    } | ((value: any, formData?: any) => string | undefined);
-    layout?: 'horizontal' | 'vertical';
-    className?: string;
-    fields?: FormField[];
-    onValueChange?: (value: any) => void;
-    step?: number;
-    rows?: number;
-    mode?: 'single' | 'multiple';
-    columns?: number;
-    render?: (props: {
-        value: any;
-        onChange: (value: any) => void;
-        error?: string;
-        disabled?: boolean;
-    }) => React.ReactNode;
-}
-export interface FormSection {
-    id: string;
-    title: string;
-    label?: string;
-    fields: FormField[];
-    component?: React.ComponentType<any>;
-    disabled?: boolean;
-    condition?: (formData: any) => boolean;
-}
-export interface BaseFormConfig<T> {
-    title: string;
-    sections: FormSection[];
-    initialData?: Partial<T>;
-    onSubmit: (data: T) => void;
-    onCancel: () => void;
-    submitButtonText?: string;
-    isMobile?: boolean;
-}
-export interface BaseFormProps<T> extends BaseFormConfig<T> {
-    open: boolean;
-}
-export interface GenericQueryConfig<TData, TParams> {
-    queryKey: string[];
-    queryFn: (params: TParams) => Promise<TData>;
-    params: TParams;
-    hookName: string;
-    enabled?: boolean;
-    defaultPagination?: {
-        currentPage: number;
-        totalPages: number;
-        totalItems: number;
-        itemsPerPage: number;
-        hasNextPage: boolean;
-        hasPreviousPage: boolean;
-    };
-    dataMapper?: (data: TData) => unknown;
-    dataExtractor?: (response: TData) => unknown;
-    paginationExtractor?: (response: TData) => unknown;
-}
-export interface GenericDataQueryResult<TItem> {
-    data: TItem[];
-    pagination: unknown;
-    isLoading: boolean;
-    error: unknown;
-    refetch: () => void;
-}
-export interface AuthTokens {
-    accessToken: string;
-    idToken: string;
-    supabaseToken?: string;
-}
-export interface UserInfo {
-    id: string;
-    email: string;
-    name: string;
-    identifier: string;
-    alias?: string;
-    isSysAdmin: boolean;
-}
-export interface Company {
-    id: string;
-    alias: string;
-    name: string;
-}
-export interface SelectedUnit {
-    id: string;
-    name: string;
-    alias: string;
-}
-export interface CompanyTokenData {
-    id: string;
-    alias: string;
-    name: string;
-    payload: any;
-}
-export interface AuthState {
-    isAuthenticated: boolean;
-    isLoading: boolean;
-    user: UserInfo | null;
-    alias: string | null;
-    companies: Company[];
-    selectedUnit: SelectedUnit | null;
-    userId: string | null;
-    userAlias: string | null;
-    placeId: string | null;
-    placeName: string | null;
-    activePlaceId?: string | null;
-    activePlaceName?: string | null;
-}
-export interface IdTokenPayload {
-    subNewId: string;
-    email: string;
-    name: string;
-    identifier: string;
-    default?: string;
-    [key: string]: any;
-}
-export interface AccessTokenPayload {
-    default?: string;
-    [key: string]: any;
-}
-export interface QualiexUser {
-    id?: string;
-    userId?: string;
-    userName?: string;
-    userEmail?: string;
-    placeId?: string | null;
-    placeName?: string | null;
-    roleId?: string;
-    roleName?: string;
-    companyId?: string;
-    companyName?: string;
-    /** Indica se o usuário está ativo no Qualiex. Default `true` quando ausente. */
-    isActive?: boolean;
-}
-export interface QualiexUserFieldMapping {
-    /** Nome do campo de ID de usuário na entidade (ex: "target_user_id") */
-    idField: string;
-    /** Nome do campo de saída para o nome (ex: "target_user_name"). Default: idField + "_name" */
-    nameField?: string;
-    /** Nome do campo de saída para o email (ex: "target_user_email"). Default: idField + "_email" */
-    emailField?: string;
-    /** Nome do campo de saída para o username (ex: "target_user_username"). Default: idField + "_username" */
-    usernameField?: string;
-}
-export interface QualiexEnrichmentConfig {
-    /** Sufixo padrão para campos de nome (default: "_name") */
-    userNameFieldSuffix?: string;
-    /** Sufixo padrão para campos de email (default: "_email") */
-    userEmailFieldSuffix?: string;
-    /** Sufixo padrão para campos de username (default: "_username") */
-    userUsernameFieldSuffix?: string;
-}
-/**
- * Representa um módulo/software disponível na plataforma Qualiex.
- * Retornado pela API GET /api/common/v1/softwares
- */
-export interface Software {
-    id: number;
-    alias: string;
-    color: string;
-    colorLight: string;
-    namePtBr: string;
-    nameUs: string;
-    nameEs: string;
-}
-/**
- * Representa uma associação do usuário com uma empresa/unidade.
- * Retornado pela API GET /api/common/v1/Users/{userId}/associations
- *
- * O array `softwares` contém os IDs dos módulos aos quais o usuário tem acesso.
- * O `roleId` e `roleName` representam o papel do usuário naquela associação.
- */
-export interface UserAssociation {
-    associationId: string;
-    userId: string;
-    userName: string;
-    companyId: string;
-    companyName: string;
-    companyAlias: string;
-    companyPhotoDate?: string;
-    language?: string;
-    roleId: string;
-    roleName: string;
-    placeId?: string;
-    placeName?: string;
-    softwares: number[];
-    functionalities: string[];
-    isQualitfy?: boolean;
-    isMetroex?: boolean;
-}
-/**
- * Resultado do hook useModuleAccess
- */
-export interface ModuleAccessResult {
-    /** Se o usuário tem acesso ao módulo configurado/especificado */
-    hasAccess: boolean;
-    /** Se os dados ainda estão carregando */
-    isLoading: boolean;
-    /** Role do usuário na associação atual */
-    role: {
-        id: string;
-        name: string;
-    } | null;
-    /** Associação completa do usuário para a unidade atual */
-    association: UserAssociation | null;
-    /** Função para verificar acesso a outro(s) módulo(s) */
-    hasAccessTo: (alias: string | string[]) => boolean;
-}
-export interface ApiResponse<T = unknown> {
-    data: T;
+export interface SignEnvelopeResult {
     success: boolean;
-    message?: string;
-    error?: string;
-}
-export interface ValidationResult {
-    isValid: boolean;
-    errors: string[];
-    warnings?: string[];
-}
-export interface NotificationConfig {
-    title: string;
-    description?: string;
-    type: 'success' | 'error' | 'warning' | 'info';
-    duration?: number;
+    provider: SignProvider;
+    envelope_id: string;
+    document_id: string;
+    signer_id: string;
+    signer_email?: string;
+    environment: 'sandbox' | 'production';
+}
+export interface SignedDocumentResult {
+    success: boolean;
+    download_url: string | null;
+    document: Record<string, unknown> | null;
+}
+export interface DocumentSignerProps {
+    file?: File;
+    onDocumentSigned?: (data: SignEnvelopeResult) => void;
+    onError?: (error: Error) => void;
+    showEventLog?: boolean;
+}
+export interface SignWidgetProps {
+    signerId: string;
+    environment: 'sandbox' | 'production';
+    onSign?: () => void;
+    onError?: (error: Error) => void;
+    onClose?: () => void;
+}
+export interface D4SignWidgetProps {
+    documentKey: string;
+    signerEmail: string;
+    signerName?: string;
+    keySigner?: string;
+    environment: 'sandbox' | 'production';
+    onSign?: () => void;
+    onError?: (error: Error) => void;
+}
+export interface SignConfigFormProps {
+    onSaved?: () => void;
 }

package/dist/updates/components/UpdatesBar.d.ts

@@ -0,0 +1,10 @@
+import type { UserUpdateBarItem } from '../types';
+export interface UpdatesBarProps {
+    item: UserUpdateBarItem;
+    onDismiss: (id: string) => void;
+}
+/**
+ * Barra horizontal de atualização, exibida no topo do app pelo consumidor.
+ * Cor de fundo vem do backend (`item.color`); demais estilos via tokens semânticos.
+ */
+export declare function UpdatesBar({ item, onDismiss }: UpdatesBarProps): import("react/jsx-runtime").JSX.Element;

package/dist/updates/components/UpdatesDialog.d.ts

@@ -0,0 +1,10 @@
+import type { UserUpdateDialogItem } from '../types';
+export interface UpdatesDialogProps {
+    item: UserUpdateDialogItem;
+    open: boolean;
+    onClose: (opts: {
+        liked: boolean;
+        doNotShowAgain: boolean;
+    }) => void;
+}
+export declare function UpdatesDialog({ item, open, onClose }: UpdatesDialogProps): import("react/jsx-runtime").JSX.Element;

package/dist/updates/components/UserUpdatesViewer.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Orquestrador: lê barras e diálogos do usuário, renderiza um por vez,
+ * dispara markUpdateVisualized no servidor e persiste dismissals por alias.
+ */
+export declare function UserUpdatesViewer(): import("react/jsx-runtime").JSX.Element;

package/dist/updates/hooks/useUserUpdates.d.ts

@@ -0,0 +1,5 @@
+import { markUpdateVisualized } from '../services/userUpdatesApi';
+import type { UserUpdateBarItem, UserUpdateDialogItem } from '../types';
+export declare function useUserUpdatesBar(): import("@tanstack/react-query").UseQueryResult<UserUpdateBarItem[], Error>;
+export declare function useUserUpdatesDialog(): import("@tanstack/react-query").UseQueryResult<UserUpdateDialogItem[], Error>;
+export { markUpdateVisualized };

package/dist/updates/index.d.ts

@@ -0,0 +1,9 @@
+export { UpdatesBar } from './components/UpdatesBar';
+export type { UpdatesBarProps } from './components/UpdatesBar';
+export { UpdatesDialog } from './components/UpdatesDialog';
+export type { UpdatesDialogProps } from './components/UpdatesDialog';
+export { UserUpdatesViewer } from './components/UserUpdatesViewer';
+export { useUserUpdatesBar, useUserUpdatesDialog, markUpdateVisualized, } from './hooks/useUserUpdates';
+export type { UserUpdateBarItem, UserUpdateDialogItem, UpdateTypeId } from './types';
+export { getCommonBaseUrl, getIdentBaseUrl, buildQualiexHeaders, qualiexFetch, } from '../qualiex/services/qualiexApiService';
+export { useQualiexReady } from '../qualiex/hooks/useQualiexReady';

package/dist/updates/services/userUpdatesApi.d.ts

@@ -0,0 +1,3 @@
+import type { UpdateTypeId } from '../types';
+export declare function fetchUserView<T>(alias: string, type: 1 | 2): Promise<T[]>;
+export declare function markUpdateVisualized(alias: string, id: string, idUpdateType: UpdateTypeId, liked?: boolean): Promise<void>;