forlogic-core 2.5.2 → 2.5.4

package/dist/auth/contexts/AuthContext.d.ts

@@ -17,6 +17,7 @@ interface AuthContextType extends AuthState {
  */
 export declare const AuthProvider: React.FC<{
     children: React.ReactNode;
+    moduleAlias?: string;
 }>;
 /**
  * Hook para acessar informações de autenticação e gerenciar sessão

package/dist/config/environments.d.ts

@@ -24,6 +24,11 @@ export interface EnvironmentConfig {
         scope: string;
     };
     qualiexApiUrl: string;
+    /**
+     * Base da Documents API (v4). Usada por `forlogic-core/documents` (upload/download de
+     * anexos de registro, files_associations). Sem barra nem `/api` no final.
+     */
+    documentsApiUrl: string;
     /**
      * Override explícito da base do ident-api. Vazio (`''`) = deriva da common-v4
      * (ver `getIdentBaseUrl`). Sem barra nem `/api` no final.

package/dist/config/index.d.ts

@@ -45,6 +45,8 @@ export declare const shouldUseDevTokens: () => boolean;
 export declare const isDevEnvironment: () => boolean;
 export { isDevEnv, getAppEnv, type AppEnv } from './environments';
 export declare const getQualiexApiUrl: () => string;
+/** Base da Documents API v4 (anexos de registro / files_associations). */
+export declare const getDocumentsApiUrl: () => string;
 /** Override explícito da base do ident-api (`''` = derivar da common-v4). */
 export declare const getIdentApiUrlOverride: () => string;
 /** Override explícito da base do login-api (`''` = derivar da common-v4). */

package/dist/documents/components/DocumentFileUpload.d.ts

@@ -0,0 +1,44 @@
+import { type DocumentAssociationType } from '../documentsApi';
+/**
+ * "Quem está implementando": a QUAL registro os arquivos se vinculam. É o análogo do
+ * `IQexFileAssociation` do Angular — o módulo consumidor passa isto e o componente
+ * cuida de todo o resto (listar/subir/ver/baixar/remover) contra a Documents API.
+ */
+export interface DocumentFileAssociation {
+    type: DocumentAssociationType;
+    associationId: string;
+    associationFieldId?: string;
+}
+export interface DocumentFileUploadProps {
+    association: DocumentFileAssociation;
+    canUpload?: boolean;
+    canRemove?: boolean;
+    canDownload?: boolean;
+    canView?: boolean;
+    /** Limite de arquivos (ex.: 1 para "evidência única"). Sem limite se omitido. */
+    maxFiles?: number;
+    /** Extensões permitidas (ex.: ['pdf','png']). Vazio = todas. */
+    allowedExtensions?: string[];
+    /** Tamanho máximo por arquivo (default 300MB, igual ao backend). */
+    maxSizeInBytes?: number;
+    disabled?: boolean;
+    /** Rótulo opcional exibido acima da área. */
+    label?: string;
+    /** Chamado após upload/remove com a contagem atual de anexos. */
+    onFilesChanged?: (count: number) => void;
+    className?: string;
+}
+/**
+ * `DocumentFileUpload` — gestor de anexos de registro (Documents API), equivalente React
+ * do `qex-file-upload` do Angular. Self-contained: recebe apenas a `association` e faz
+ * list/upload/view/download/remove sozinho. Compõe o `SingleFileUpload` (primitiva de UI).
+ *
+ * @example
+ * <DocumentFileUpload
+ *   association={{ type: EDocumentAssociationType.Trainings, associationId: evaluationId }}
+ *   maxFiles={1}
+ *   allowedExtensions={['pdf','png','jpg']}
+ *   onFilesChanged={(n) => setHasEvidence(n > 0)}
+ * />
+ */
+export declare function DocumentFileUpload({ association, canUpload, canRemove, canDownload, canView, maxFiles, allowedExtensions, maxSizeInBytes, disabled, label, onFilesChanged, className, }: DocumentFileUploadProps): import("react/jsx-runtime").JSX.Element;

package/dist/documents/documentsApi.d.ts

@@ -0,0 +1,69 @@
+/**
+ * forlogic-core/documents — cliente da Documents API v4 para ANEXOS DE REGISTRO
+ * (`files_associations`: par `type` + `associationId`). É a camada de dados por trás
+ * do componente `DocumentFileUpload` (equivalente React do `@forlogic/qex`).
+ *
+ * NÃO cobre documento controlado (type = Docs = 17, com pasta/categoria/fluxo de
+ * aprovação) — para isso o app consumidor usa seu próprio DocumentUploadService.
+ * Aqui é só o anexo solto vinculado a um registro (type != Docs).
+ *
+ * Auth: Bearer (TokenManager) + header `un-alias` (obrigatório na stack Qualiex v4).
+ * Base: `getDocumentsApiUrl()` (config central por VITE_APP_ENV) + `/api/documents/v1`.
+ *
+ * Contrato derivado do backend `api/src/Documents` + paridade com o qex-file-upload
+ * (Angular). NÃO testado em runtime; validar contra a Documents API real antes de prod.
+ */
+/** Subconjunto de `EAssociationType` (backend Documents) usado no front React. */
+export declare const EDocumentAssociationType: {
+    /** Documento controlado (pasta/categoria/fluxo) — NÃO tratado por este cliente. */
+    readonly Docs: 17;
+    /** Anexo de registro do módulo Treinamentos. */
+    readonly Trainings: 19;
+};
+export type DocumentAssociationType = (typeof EDocumentAssociationType)[keyof typeof EDocumentAssociationType];
+/** Link SAS temporário devolvido pelo Download (`QueryResult<FileLink>`, onlyOne). */
+export interface DocumentFileLink {
+    code: string;
+    revisionId: string;
+    revisionName: string;
+    name: string;
+    extension: string;
+    url: string;
+}
+/** Referência de um arquivo associado (lista). */
+export interface DocumentFileRef {
+    /** Id do arquivo (usado no Download). */
+    id: string;
+    name: string;
+    extension: string;
+    size?: number;
+    /**
+     * Id da linha `files_associations` (o vínculo arquivo↔registro) — é o que o
+     * DELETE `/files/associations` espera (`filesAssociationsIds`), NÃO o id do arquivo.
+     */
+    associationRowId?: string;
+}
+/** Resultado do upload (`resultData` do CommandResult). */
+export interface DocumentUploadResult {
+    id: string;
+    code?: string;
+    size?: number;
+}
+export declare const documentsFilesApi: {
+    /**
+     * Sobe um anexo vinculado a um registro. Multipart com duas chaves: `command`
+     * (JSON) e o arquivo (chave = nome do arquivo). Devolve `{ id }` (resultData.id).
+     */
+    upload(associationType: DocumentAssociationType, associationId: string, file: File, associationFieldId?: string): Promise<DocumentUploadResult>;
+    /** URL SAS temporária para abrir/baixar o arquivo (null se falhar). */
+    downloadUrl(fileId: string, minutesToExpire?: number): Promise<string | null>;
+    /** Lista os anexos ativos de um registro (id do arquivo + nome + id da associação). */
+    listByAssociation(associationType: DocumentAssociationType, associationId: string, associationFieldId?: string): Promise<DocumentFileRef[]>;
+    /**
+     * Remove o VÍNCULO arquivo↔registro (não apaga o arquivo, que pode estar associado a
+     * outros registros). `associationRowId` vem do `listByAssociation`.
+     */
+    remove(associationRowId: string, justification?: string): Promise<boolean>;
+    /** Conta os anexos de um registro (badge "tem N anexos"). */
+    count(associationType: DocumentAssociationType, associationId: string, associationFieldId?: string): Promise<number>;
+};

package/dist/documents/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * forlogic-core/documents — anexos de registro (Documents API v4).
+ *
+ * - `documentsFilesApi` — cliente HTTP (upload/download/list/count/remove).
+ * - `DocumentFileUpload` — componente self-contained (equivalente React do qex-file-upload):
+ *   recebe a `association` e cuida de listar/subir/ver/baixar/remover sozinho.
+ *
+ * Reexportado no barrel principal (`forlogic-core`) — usa TokenManager/config do próprio
+ * barrel, sem duplicação. NÃO cobre documento controlado (type=Docs=17).
+ */
+export { documentsFilesApi, EDocumentAssociationType, type DocumentAssociationType, type DocumentFileLink, type DocumentFileRef, type DocumentUploadResult, } from './documentsApi';
+export { DocumentFileUpload, type DocumentFileUploadProps, type DocumentFileAssociation, } from './components/DocumentFileUpload';

package/dist/index.d.ts

@@ -105,6 +105,7 @@ export * from './components/modules';
 export * from './media';
 export * from './updates';
 export * from './file-upload';
+export { documentsFilesApi, EDocumentAssociationType, DocumentFileUpload, type DocumentAssociationType, type DocumentFileLink, type DocumentFileRef, type DocumentUploadResult, type DocumentFileUploadProps, type DocumentFileAssociation, } from './documents';
 export * from './custom-form-fields';
 export * from './approval-flow';
 export * from './team-selector';