teraprox-core-sdk 0.3.3 → 0.3.6

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CoreService, H as HttpController, T as ToastService } from './federation-UNcGnNB-.js';
-export { D as DevAutoLogin, F as FederatedBridge, M as MatchingObjectSubscription, R as ReducersBundle, a as ReducersBundleConfig, b as RemoteManifest, c as RemoteMenuItem, d as RemoteMenuSection, S as StandaloneProvider, e as ToastOptions, f as createReducersBundle } from './federation-UNcGnNB-.js';
+import { C as CoreService, T as ToastService, I as IObservabilityPort, H as HttpController, a as InteractionPayload, V as VitalsPayload, B as BreadcrumbPayload } from './federation-Bhx0XhSP.js';
+export { D as DevAutoLogin, F as FederatedBridge, M as MatchingObjectSubscription, R as ReducersBundle, b as ReducersBundleConfig, c as RemoteManifest, d as RemoteMenuItem, e as RemoteMenuSection, S as StandaloneProvider, f as ToastOptions, g as createReducersBundle } from './federation-Bhx0XhSP.js';
 import * as React from 'react';
 import { Dispatch } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -34,8 +34,257 @@ interface NavigationConfig {
 }
 type NavigateFn = (path: string | number, config?: NavigationConfig, pageName?: string) => void;
 
+type StatusSolicitacao = 'PENDENTE' | 'APROVADO' | 'REPROVADO' | 'CANCELADO' | 'EM_EXECUCAO';
+interface SolicitacaoDeServico {
+    id: string | number;
+    status: StatusSolicitacao;
+    dataDeAbertura: string;
+    descricaoDoProblema: string;
+    solicitante: {
+        id: string | number;
+        nome: string;
+    };
+    recurso?: {
+        id: string | number;
+        nome: string;
+    };
+    recursoNome?: string;
+    prioridade?: 'BAIXA' | 'MEDIA' | 'ALTA' | 'URGENTE';
+    setor?: string;
+    equipamento?: string;
+}
+
 declare const CoreServiceContext: React.Context<CoreService | null>;
 
+declare class FetchHttpAdapter implements HttpController {
+    private endpoint;
+    private extraHeaders?;
+    constructor(endpoint: string, extraHeaders?: Record<string, string> | undefined);
+    private request;
+    get(path?: string): Promise<any>;
+    post(path?: string, data?: any): Promise<any>;
+    put(path?: string, data?: any): Promise<any>;
+    patch(path?: string, data?: any): Promise<any>;
+    delete(path?: string, id?: string | number): Promise<any>;
+    deleteSimple(path?: string): Promise<any>;
+    save(path?: string, data?: any): Promise<any>;
+    read(path?: string, id?: string | number): Promise<any>;
+    readAll(path?: string): Promise<any>;
+    readAllwithPage(path?: string): Promise<any>;
+    bulkDelete(path?: string): Promise<any>;
+}
+declare class CoreServiceBuilder {
+    private _toast;
+    private _httpEndpoint?;
+    private _rtdbConfig?;
+    private _hostedByCore;
+    private _observability;
+    private _tracing;
+    withToast(toast: ToastService): this;
+    withHttpEndpoint(url: string): this;
+    withRtdbConfig(config: any): this;
+    setHostedByCore(hosted: boolean): this;
+    withObservability(observability: IObservabilityPort): this;
+    /**
+     * Ativa Distributed Tracing W3C nos controllers HTTP.
+     * Quando habilitado, `createController` retorna `TracingHttpAdapter` em vez de `FetchHttpAdapter`.
+     * O header `traceparent` é injetado em todas as requisições automaticamente.
+     */
+    withTracing(enabled?: boolean): this;
+    build(): CoreService;
+}
+
+declare class NullToastService implements ToastService {
+    success(message: string): void;
+    warning(message: string): void;
+    error(message: string): void;
+    info(message: string): void;
+}
+declare class NullHttpController implements HttpController {
+    private logAndResolve;
+    get(path?: string): Promise<{
+        id: number;
+        nome: string;
+        branchLevel: {
+            level: number;
+        };
+        status: string;
+    }[]> | Promise<{
+        id: number;
+        level: number;
+        nome: string;
+    }[]>;
+    post(path?: string): Promise<{
+        id: number;
+        nome: string;
+        branchLevel: {
+            level: number;
+        };
+        status: string;
+    }[]> | Promise<{
+        id: number;
+        level: number;
+        nome: string;
+    }[]>;
+    put(path?: string): Promise<{
+        id: number;
+        nome: string;
+        branchLevel: {
+            level: number;
+        };
+        status: string;
+    }[]> | Promise<{
+        id: number;
+        level: number;
+        nome: string;
+    }[]>;
+    patch(path?: string): Promise<{
+        id: number;
+        nome: string;
+        branchLevel: {
+            level: number;
+        };
+        status: string;
+    }[]> | Promise<{
+        id: number;
+        level: number;
+        nome: string;
+    }[]>;
+    delete(path?: string, id?: string | number): Promise<{
+        id: number;
+        nome: string;
+        branchLevel: {
+            level: number;
+        };
+        status: string;
+    }[]> | Promise<{
+        id: number;
+        level: number;
+        nome: string;
+    }[]>;
+    deleteSimple(path?: string): Promise<{
+        id: number;
+        nome: string;
+        branchLevel: {
+            level: number;
+        };
+        status: string;
+    }[]> | Promise<{
+        id: number;
+        level: number;
+        nome: string;
+    }[]>;
+    save(path?: string): Promise<{
+        id: number;
+        nome: string;
+        branchLevel: {
+            level: number;
+        };
+        status: string;
+    }[]> | Promise<{
+        id: number;
+        level: number;
+        nome: string;
+    }[]>;
+    read(path?: string, id?: string | number): Promise<{
+        id: number;
+        nome: string;
+        branchLevel: {
+            level: number;
+        };
+        status: string;
+    }[]> | Promise<{
+        id: number;
+        level: number;
+        nome: string;
+    }[]>;
+    readAll(path?: string): Promise<{
+        id: number;
+        nome: string;
+        branchLevel: {
+            level: number;
+        };
+        status: string;
+    }[]> | Promise<{
+        id: number;
+        level: number;
+        nome: string;
+    }[]>;
+    readAllwithPage(path?: string): Promise<{
+        id: number;
+        nome: string;
+        branchLevel: {
+            level: number;
+        };
+        status: string;
+    }[]> | Promise<{
+        id: number;
+        level: number;
+        nome: string;
+    }[]>;
+    bulkDelete(path?: string): Promise<{
+        id: number;
+        nome: string;
+        branchLevel: {
+            level: number;
+        };
+        status: string;
+    }[]> | Promise<{
+        id: number;
+        level: number;
+        nome: string;
+    }[]>;
+}
+declare const NullCoreService: CoreService;
+
+/**
+ * Null Object Pattern — implementação fallback de `IObservabilityPort`.
+ * Apenas loga no console; substitua pela implementação real (Datadog/Sentry/Grafana)
+ * via `CoreServiceBuilder.withObservability()` no host.
+ */
+declare class NullObservabilityAdapter implements IObservabilityPort {
+    trackInteraction(payload: InteractionPayload): void;
+    captureVitals(payload: VitalsPayload): void;
+    logBreadcrumb(payload: BreadcrumbPayload): void;
+}
+
+/**
+ * Decorator de HTTP que implementa Distributed Tracing via W3C TraceContext.
+ *
+ * - Gera um `trace-id` único por instância (cobre todos os spans de um contexto/controller).
+ * - Gera um `span-id` único por requisição HTTP.
+ * - Injeta o header `traceparent` em todas as chamadas: GET, POST, PUT, PATCH, DELETE, etc.
+ * - Mesclado com quaisquer `extraHeaders` já presentes na chamada.
+ *
+ * Uso via CoreServiceBuilder:
+ * ```ts
+ * new CoreServiceBuilder()
+ *   .withHttpEndpoint(process.env.REACT_APP_END_POINT)
+ *   .withTracing()
+ *   .build()
+ * ```
+ */
+declare class TracingHttpAdapter implements HttpController {
+    private readonly endpoint;
+    private readonly extraHeaders?;
+    /** Identificador único desta cadeia de spans — compartilhado por todas as reqs do controller. */
+    private readonly traceId;
+    constructor(endpoint: string, extraHeaders?: Record<string, string> | undefined);
+    private mergeHeaders;
+    private request;
+    get(path?: string): Promise<any>;
+    post(path?: string, data?: any, extraHeaders?: Record<string, string>): Promise<any>;
+    put(path?: string, data?: any, extraHeaders?: Record<string, string>): Promise<any>;
+    patch(path?: string, data?: any, extraHeaders?: Record<string, string>): Promise<any>;
+    delete(path?: string, id?: string | number, extraHeaders?: Record<string, string>): Promise<any>;
+    deleteSimple(path?: string, extraHeaders?: Record<string, string>): Promise<any>;
+    save(path?: string, data?: any, extraHeaders?: Record<string, string>): Promise<any>;
+    read(path?: string, id?: string | number, extraHeaders?: Record<string, string>): Promise<any>;
+    readAll(path?: string, extraHeaders?: Record<string, string>): Promise<any>;
+    readAllwithPage(path?: string): Promise<any>;
+    bulkDelete(path?: string, ids?: (string | number)[], extraHeaders?: Record<string, string>): Promise<any>;
+}
+
 declare function useCoreService(): CoreService;
 
 declare function useHttpController(context: string, baseEndPoint?: string): HttpController;
@@ -80,6 +329,16 @@ interface NavigatorConfig {
  */
 declare function useNavigator(config: NavigatorConfig): NavigateFn;
 
+/**
+ * Atalho para acessar o Port de observabilidade via React context.
+ * Retorna a implementação real (quando fornecida pelo host) ou o NullObservabilityAdapter.
+ *
+ * @example
+ * const obs = useObservability()
+ * obs.logBreadcrumb({ category: 'action', message: 'Solicitação aprovada', data: { id } })
+ */
+declare function useObservability(): IObservabilityPort;
+
 interface FetchDataReturn<T = any> {
     data: T | null;
     loading: boolean;
@@ -198,6 +457,36 @@ declare const _default: redux.Reducer<PickerState>;
 
 declare function pickTextColorBasedOnBgColorAdvanced(bgColor: string, lightColor: string, darkColor: string): string;
 
+/**
+ * Instala PerformanceObserver para LCP e CLS automaticamente no bootstrap do módulo.
+ * Fallback silencioso em ambientes que não suportam a API (Node, browsers antigos).
+ *
+ * @param observability - Implementação de IObservabilityPort para receber as métricas.
+ */
+declare function initWebVitals(observability: IObservabilityPort): void;
+
+/**
+ * Utilitários de Distributed Tracing seguindo a especificação W3C TraceContext.
+ * https://www.w3.org/TR/trace-context/
+ */
+/**
+ * Gera um trace-id de 128 bits (32 chars hex) conforme W3C TraceContext.
+ * Usado uma vez por instância de adapter — identifica toda a cadeia de spans de um contexto.
+ */
+declare function generateTraceId(): string;
+/**
+ * Gera um span-id de 64 bits (16 chars hex) conforme W3C TraceContext.
+ * Chamado a cada requisição HTTP — identifica um span individual.
+ */
+declare function generateSpanId(): string;
+/**
+ * Monta o header `traceparent` no formato W3C:
+ * `{version}-{traceId}-{spanId}-{flags}`
+ *
+ * Flags: `01` = sampled (enviado ao coletor), `00` = não-amostrado.
+ */
+declare function buildTraceparent(traceId: string, spanId: string, sampled?: boolean): string;
+
 /**
  * Formats a date for display in Brazilian format.
  * Corresponds to the duplicated dateUtils.js in SGM/SGP/Services/default/.
@@ -219,4 +508,4 @@ declare function removeAccents(str: string): string;
 declare function slugify(str: string): string;
 declare function isBlank(str: string | null | undefined): boolean;
 
-export { CoreService, CoreServiceContext, HttpController, type NavigateFn, type NavigationConfig, type Notification, type NotificationState, RecursoDisplayer, ToastService, addDays, _default$1 as branchLevelReducer, capitalize, clearBranchLevelForm, clearPicker, daysBetween, formatDate, formatDateTime, isBlank, isDateAfter, isDateBefore, pickTextColorBasedOnBgColorAdvanced, _default as pickerReducer, populateToEdit, removeAccents, setColor, setExcludeLevels, setHaveComponente, setLevel, setLevels, setNome, setPickerContext, setPickerItems, setPickerSelected, setPickerVisible, slugify, toISOString, truncate, useAnexoUpload, useCoreService, useFetchData, useFormStorage, useHttpController, useMatchingObject, useNavigator, useNotifications, usePostData, useSmartSearch, useToast, useValidation };
+export { BreadcrumbPayload, CoreService, CoreServiceBuilder, CoreServiceContext, FetchHttpAdapter, HttpController, IObservabilityPort, InteractionPayload, type NavigateFn, type NavigationConfig, type Notification, type NotificationState, NullCoreService, NullHttpController, NullObservabilityAdapter, NullToastService, RecursoDisplayer, type SolicitacaoDeServico, type StatusSolicitacao, ToastService, TracingHttpAdapter, VitalsPayload, addDays, _default$1 as branchLevelReducer, buildTraceparent, capitalize, clearBranchLevelForm, clearPicker, daysBetween, formatDate, formatDateTime, generateSpanId, generateTraceId, initWebVitals, isBlank, isDateAfter, isDateBefore, pickTextColorBasedOnBgColorAdvanced, _default as pickerReducer, populateToEdit, removeAccents, setColor, setExcludeLevels, setHaveComponente, setLevel, setLevels, setNome, setPickerContext, setPickerItems, setPickerSelected, setPickerVisible, slugify, toISOString, truncate, useAnexoUpload, useCoreService, useFetchData, useFormStorage, useHttpController, useMatchingObject, useNavigator, useNotifications, useObservability, usePostData, useSmartSearch, useToast, useValidation };