teraprox-core-sdk 0.3.2 → 0.3.5

package/dist/{chunk-PATJPPYP.mjs → chunk-JK654W4P.mjs}

@@ -52,6 +52,23 @@ function createReducersBundle(config) {
   };
 }
 
+// src/adapters/null/NullObservabilityAdapter.ts
+var NullObservabilityAdapter = class {
+  trackInteraction(payload) {
+    var _a;
+    console.info(`[Observability] INTERACTION: ${payload.name}`, (_a = payload.properties) != null ? _a : {});
+  }
+  captureVitals(payload) {
+    var _a, _b;
+    const unit = (_a = payload.unit) != null ? _a : "";
+    console.info(`[Observability] VITAL: ${payload.name} = ${payload.value}${unit}`, (_b = payload.meta) != null ? _b : {});
+  }
+  logBreadcrumb(payload) {
+    var _a;
+    console.info(`[Observability] BREADCRUMB [${payload.category}]: ${payload.message}`, (_a = payload.data) != null ? _a : {});
+  }
+};
+
 // src/federation/StandaloneProvider.tsx
 import { useMemo, useCallback, useState, useEffect as useEffect2, useRef } from "react";
 import { jsx as jsx2, jsxs } from "react/jsx-runtime";
@@ -65,13 +82,21 @@ async function probeEmulator(host, port) {
     return false;
   }
 }
-async function resolveRtdbStrategy(firebaseConfig) {
-  var _a;
+async function resolveRtdbStrategy(firebaseConfig, emulator) {
+  var _a, _b;
+  if (emulator) {
+    return {
+      type: "emulator",
+      host: emulator.host,
+      port: emulator.port,
+      namespace: (_a = emulator.namespace) != null ? _a : "teraprox-default-rtdb"
+    };
+  }
   const emulatorHostEnv = typeof process !== "undefined" && process.env.REACT_APP_RTDB_EMULATOR_HOST || void 0;
   if (emulatorHostEnv) {
     const [host, portStr] = emulatorHostEnv.split(":");
     const port = parseInt(portStr != null ? portStr : "9000", 10);
-    const namespace = (_a = process.env.REACT_APP_RTDB_EMULATOR_NS) != null ? _a : "demo-local";
+    const namespace = (_b = process.env.REACT_APP_RTDB_EMULATOR_NS) != null ? _b : "demo-local";
     return { type: "emulator", host, port, namespace };
   }
   if (firebaseConfig && Object.keys(firebaseConfig).length > 0) {
@@ -147,7 +172,7 @@ function RtdbConfigWarning({ onDismiss }) {
     }
   );
 }
-function StandaloneProvider({ createController, addToast, firebaseConfig, tenant, children }) {
+function StandaloneProvider({ createController, addToast, firebaseConfig, emulator, tenant, children }) {
   const [subscriptions] = useState([]);
   const subscriptionsRef = useRef(subscriptions);
   subscriptionsRef.current = subscriptions;
@@ -182,7 +207,7 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
     let cancelled = false;
     (async () => {
       var _a;
-      const strategy = await resolveRtdbStrategy(firebaseConfig);
+      const strategy = await resolveRtdbStrategy(firebaseConfig, emulator);
       if (cancelled) return;
       if (strategy.type === "none") {
         if (process.env.NODE_ENV !== "production") setRtdbWarning(true);
@@ -250,7 +275,7 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
       cancelled = true;
       cleanup == null ? void 0 : cleanup();
     };
-  }, [firebaseConfig, tenant]);
+  }, [firebaseConfig, emulator, tenant]);
   const value = useMemo(
     () => ({
       createController,
@@ -263,7 +288,8 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
       },
       handleLogout: () => {
       },
-      hostedByCore: false
+      hostedByCore: false,
+      observability: new NullObservabilityAdapter()
     }),
     [createController, toast, subscribe, unsubscribe]
   );
@@ -282,14 +308,14 @@ var DEFAULT_DEV_USER = {
   lastName: "User",
   token: "dev-standalone-token",
   email: "dev@teraprox.local",
-  id: "dev-user-id",
+  id: "1",
   role: "admin",
   user: "devuser",
   userName: "devuser",
   setor: "Desenvolvimento",
-  userSetor: { setorId: "dev-setor-id" },
+  userSetor: { setorId: "1" },
   companyName: "Dev Company",
-  companyId: "dev-company-id",
+  companyId: "1",
   filters: []
 };
 function DevAutoLogin({ actions, devUser, children }) {
@@ -313,6 +339,7 @@ export {
   CoreServiceContext,
   FederatedBridge,
   createReducersBundle,
+  NullObservabilityAdapter,
   StandaloneProvider,
   DevAutoLogin
 };

package/dist/{federation-B4ShfmDd.d.mts → federation-Bhx0XhSP.d.mts}

@@ -34,6 +34,50 @@ interface MatchingObjectSubscription {
     userId?: string;
 }
 
+/**
+ * Port de Observabilidade — contrato entre os Use Cases/Adapters e
+ * qualquer implementação de RUM (Datadog, Sentry, Grafana, console…).
+ */
+interface VitalsPayload {
+    /** Nome da métrica Web Vital: 'LCP', 'CLS', 'FID', 'TTFB', etc. */
+    name: string;
+    /** Valor numérico da métrica */
+    value: number;
+    /** Unidade da métrica: 'ms', 'score', 'count', etc. */
+    unit?: string;
+    /** Metadados adicionais opcionais */
+    meta?: Record<string, unknown>;
+}
+interface BreadcrumbPayload {
+    /** Categoria do breadcrumb: 'action', 'navigation', 'http', 'error', etc. */
+    category: string;
+    /** Mensagem legível descrevendo o evento */
+    message: string;
+    /** Dados estruturados adicionais */
+    data?: Record<string, unknown>;
+}
+interface InteractionPayload {
+    /** Nome da interação (ex.: 'save-solicitacao', 'approve-ss', 'reject-ss') */
+    name: string;
+    /** Propriedades associadas à interação */
+    properties?: Record<string, unknown>;
+}
+interface IObservabilityPort {
+    /**
+     * Registra uma interação do usuário (clique, submit, navegação intencional).
+     * Usado para rastrear fluxos de negócio e funis.
+     */
+    trackInteraction(payload: InteractionPayload): void;
+    /**
+     * Captura métricas de performance (Web Vitals: LCP, CLS, FID, TTFB).
+     */
+    captureVitals(payload: VitalsPayload): void;
+    /**
+     * Adiciona um breadcrumb ao trail de eventos para diagnóstico de erros.
+     */
+    logBreadcrumb(payload: BreadcrumbPayload): void;
+}
+
 interface CoreService {
     /** Cria um HttpController configurado para um contexto/endpoint */
     createController(context: string, baseEndPoint?: string): HttpController;
@@ -51,6 +95,8 @@ interface CoreService {
     handleLogout(): void;
     /** Indica se o componente está hospedado pelo Core */
     hostedByCore: boolean;
+    /** Porta de observabilidade — tracking, vitals e breadcrumbs */
+    observability: IObservabilityPort;
 }
 
 interface FederatedBridgeProps {
@@ -119,6 +165,11 @@ interface ReducersBundle {
 }
 declare function createReducersBundle(config: ReducersBundleConfig): ReducersBundle;
 
+interface EmulatorConfig {
+    host: string;
+    port: number;
+    namespace?: string;
+}
 interface StandaloneConfig {
     /**
      * Factory for creating an HttpController. The remote provides its
@@ -133,11 +184,20 @@ interface StandaloneConfig {
      * object listening via Firebase RTDB — same path the Core uses.
      *
      * If omitted, the provider auto-detects the RTDB emulator:
-     *   1. Reads `REACT_APP_RTDB_EMULATOR_HOST` (e.g. `localhost:9000`)
-     *   2. Falls back to probing `localhost:9000`
-     *   3. If neither works, shows a configuration popup (dev only)
+     *   1. Uses `emulator` prop if provided
+     *   2. Reads `REACT_APP_RTDB_EMULATOR_HOST` env var
+     *   3. Falls back to probing `localhost:9000`
+     *   4. If neither works, shows a configuration popup (dev only)
      */
     firebaseConfig?: Record<string, unknown>;
+    /**
+     * Explicit emulator configuration. Preferred over env vars because
+     * DefinePlugin may not replace process.env.REACT_APP_* inside node_modules.
+     * The app should read its own env vars and pass them here.
+     *
+     * Example: `{ host: 'localhost', port: 9000, namespace: 'teraprox-default-rtdb' }`
+     */
+    emulator?: EmulatorConfig;
     /**
      * Tenant / company ID used to build the RTDB path:
      * `{tenant}/matchingObjects`
@@ -178,7 +238,7 @@ interface StandaloneConfig {
  * }
  * ```
  */
-declare function StandaloneProvider({ createController, addToast, firebaseConfig, tenant, children }: StandaloneConfig): react_jsx_runtime.JSX.Element;
+declare function StandaloneProvider({ createController, addToast, firebaseConfig, emulator, tenant, children }: StandaloneConfig): react_jsx_runtime.JSX.Element;
 
 interface DevUser {
     firstName: string;
@@ -256,4 +316,4 @@ interface RemoteManifest {
     menuSections: RemoteMenuSection[];
 }
 
-export { type CoreService as C, DevAutoLogin as D, FederatedBridge as F, type HttpController as H, type MatchingObjectSubscription as M, type ReducersBundle as R, StandaloneProvider as S, type ToastService as T, type ReducersBundleConfig as a, type RemoteManifest as b, type RemoteMenuItem as c, type RemoteMenuSection as d, type ToastOptions as e, createReducersBundle as f };
+export { type BreadcrumbPayload as B, type CoreService as C, DevAutoLogin as D, FederatedBridge as F, type HttpController as H, type IObservabilityPort as I, type MatchingObjectSubscription as M, type ReducersBundle as R, StandaloneProvider as S, type ToastService as T, type VitalsPayload as V, type InteractionPayload as a, type ReducersBundleConfig as b, type RemoteManifest as c, type RemoteMenuItem as d, type RemoteMenuSection as e, type ToastOptions as f, createReducersBundle as g };

package/dist/{federation-B4ShfmDd.d.ts → federation-Bhx0XhSP.d.ts}

@@ -34,6 +34,50 @@ interface MatchingObjectSubscription {
     userId?: string;
 }
 
+/**
+ * Port de Observabilidade — contrato entre os Use Cases/Adapters e
+ * qualquer implementação de RUM (Datadog, Sentry, Grafana, console…).
+ */
+interface VitalsPayload {
+    /** Nome da métrica Web Vital: 'LCP', 'CLS', 'FID', 'TTFB', etc. */
+    name: string;
+    /** Valor numérico da métrica */
+    value: number;
+    /** Unidade da métrica: 'ms', 'score', 'count', etc. */
+    unit?: string;
+    /** Metadados adicionais opcionais */
+    meta?: Record<string, unknown>;
+}
+interface BreadcrumbPayload {
+    /** Categoria do breadcrumb: 'action', 'navigation', 'http', 'error', etc. */
+    category: string;
+    /** Mensagem legível descrevendo o evento */
+    message: string;
+    /** Dados estruturados adicionais */
+    data?: Record<string, unknown>;
+}
+interface InteractionPayload {
+    /** Nome da interação (ex.: 'save-solicitacao', 'approve-ss', 'reject-ss') */
+    name: string;
+    /** Propriedades associadas à interação */
+    properties?: Record<string, unknown>;
+}
+interface IObservabilityPort {
+    /**
+     * Registra uma interação do usuário (clique, submit, navegação intencional).
+     * Usado para rastrear fluxos de negócio e funis.
+     */
+    trackInteraction(payload: InteractionPayload): void;
+    /**
+     * Captura métricas de performance (Web Vitals: LCP, CLS, FID, TTFB).
+     */
+    captureVitals(payload: VitalsPayload): void;
+    /**
+     * Adiciona um breadcrumb ao trail de eventos para diagnóstico de erros.
+     */
+    logBreadcrumb(payload: BreadcrumbPayload): void;
+}
+
 interface CoreService {
     /** Cria um HttpController configurado para um contexto/endpoint */
     createController(context: string, baseEndPoint?: string): HttpController;
@@ -51,6 +95,8 @@ interface CoreService {
     handleLogout(): void;
     /** Indica se o componente está hospedado pelo Core */
     hostedByCore: boolean;
+    /** Porta de observabilidade — tracking, vitals e breadcrumbs */
+    observability: IObservabilityPort;
 }
 
 interface FederatedBridgeProps {
@@ -119,6 +165,11 @@ interface ReducersBundle {
 }
 declare function createReducersBundle(config: ReducersBundleConfig): ReducersBundle;
 
+interface EmulatorConfig {
+    host: string;
+    port: number;
+    namespace?: string;
+}
 interface StandaloneConfig {
     /**
      * Factory for creating an HttpController. The remote provides its
@@ -133,11 +184,20 @@ interface StandaloneConfig {
      * object listening via Firebase RTDB — same path the Core uses.
      *
      * If omitted, the provider auto-detects the RTDB emulator:
-     *   1. Reads `REACT_APP_RTDB_EMULATOR_HOST` (e.g. `localhost:9000`)
-     *   2. Falls back to probing `localhost:9000`
-     *   3. If neither works, shows a configuration popup (dev only)
+     *   1. Uses `emulator` prop if provided
+     *   2. Reads `REACT_APP_RTDB_EMULATOR_HOST` env var
+     *   3. Falls back to probing `localhost:9000`
+     *   4. If neither works, shows a configuration popup (dev only)
      */
     firebaseConfig?: Record<string, unknown>;
+    /**
+     * Explicit emulator configuration. Preferred over env vars because
+     * DefinePlugin may not replace process.env.REACT_APP_* inside node_modules.
+     * The app should read its own env vars and pass them here.
+     *
+     * Example: `{ host: 'localhost', port: 9000, namespace: 'teraprox-default-rtdb' }`
+     */
+    emulator?: EmulatorConfig;
     /**
      * Tenant / company ID used to build the RTDB path:
      * `{tenant}/matchingObjects`
@@ -178,7 +238,7 @@ interface StandaloneConfig {
  * }
  * ```
  */
-declare function StandaloneProvider({ createController, addToast, firebaseConfig, tenant, children }: StandaloneConfig): react_jsx_runtime.JSX.Element;
+declare function StandaloneProvider({ createController, addToast, firebaseConfig, emulator, tenant, children }: StandaloneConfig): react_jsx_runtime.JSX.Element;
 
 interface DevUser {
     firstName: string;
@@ -256,4 +316,4 @@ interface RemoteManifest {
     menuSections: RemoteMenuSection[];
 }
 
-export { type CoreService as C, DevAutoLogin as D, FederatedBridge as F, type HttpController as H, type MatchingObjectSubscription as M, type ReducersBundle as R, StandaloneProvider as S, type ToastService as T, type ReducersBundleConfig as a, type RemoteManifest as b, type RemoteMenuItem as c, type RemoteMenuSection as d, type ToastOptions as e, createReducersBundle as f };
+export { type BreadcrumbPayload as B, type CoreService as C, DevAutoLogin as D, FederatedBridge as F, type HttpController as H, type IObservabilityPort as I, type MatchingObjectSubscription as M, type ReducersBundle as R, StandaloneProvider as S, type ToastService as T, type VitalsPayload as V, type InteractionPayload as a, type ReducersBundleConfig as b, type RemoteManifest as c, type RemoteMenuItem as d, type RemoteMenuSection as e, type ToastOptions as f, createReducersBundle as g };

package/dist/federation.d.mts

@@ -1,3 +1,3 @@
-export { D as DevAutoLogin, F as FederatedBridge, R as ReducersBundle, a as ReducersBundleConfig, b as RemoteManifest, c as RemoteMenuItem, d as RemoteMenuSection, S as StandaloneProvider, f as createReducersBundle } from './federation-B4ShfmDd.mjs';
+export { D as DevAutoLogin, F as FederatedBridge, R as ReducersBundle, b as ReducersBundleConfig, c as RemoteManifest, d as RemoteMenuItem, e as RemoteMenuSection, S as StandaloneProvider, g as createReducersBundle } from './federation-Bhx0XhSP.mjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/federation.d.ts

@@ -1,3 +1,3 @@
-export { D as DevAutoLogin, F as FederatedBridge, R as ReducersBundle, a as ReducersBundleConfig, b as RemoteManifest, c as RemoteMenuItem, d as RemoteMenuSection, S as StandaloneProvider, f as createReducersBundle } from './federation-B4ShfmDd.js';
+export { D as DevAutoLogin, F as FederatedBridge, R as ReducersBundle, b as ReducersBundleConfig, c as RemoteManifest, d as RemoteMenuItem, e as RemoteMenuSection, S as StandaloneProvider, g as createReducersBundle } from './federation-Bhx0XhSP.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/federation.js

@@ -95,6 +95,25 @@ function createReducersBundle(config) {
 
 // src/federation/StandaloneProvider.tsx
 var import_react3 = require("react");
+
+// src/adapters/null/NullObservabilityAdapter.ts
+var NullObservabilityAdapter = class {
+  trackInteraction(payload) {
+    var _a;
+    console.info(`[Observability] INTERACTION: ${payload.name}`, (_a = payload.properties) != null ? _a : {});
+  }
+  captureVitals(payload) {
+    var _a, _b;
+    const unit = (_a = payload.unit) != null ? _a : "";
+    console.info(`[Observability] VITAL: ${payload.name} = ${payload.value}${unit}`, (_b = payload.meta) != null ? _b : {});
+  }
+  logBreadcrumb(payload) {
+    var _a;
+    console.info(`[Observability] BREADCRUMB [${payload.category}]: ${payload.message}`, (_a = payload.data) != null ? _a : {});
+  }
+};
+
+// src/federation/StandaloneProvider.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
 async function probeEmulator(host, port) {
   try {
@@ -106,13 +125,21 @@ async function probeEmulator(host, port) {
     return false;
   }
 }
-async function resolveRtdbStrategy(firebaseConfig) {
-  var _a;
+async function resolveRtdbStrategy(firebaseConfig, emulator) {
+  var _a, _b;
+  if (emulator) {
+    return {
+      type: "emulator",
+      host: emulator.host,
+      port: emulator.port,
+      namespace: (_a = emulator.namespace) != null ? _a : "teraprox-default-rtdb"
+    };
+  }
   const emulatorHostEnv = typeof process !== "undefined" && process.env.REACT_APP_RTDB_EMULATOR_HOST || void 0;
   if (emulatorHostEnv) {
     const [host, portStr] = emulatorHostEnv.split(":");
     const port = parseInt(portStr != null ? portStr : "9000", 10);
-    const namespace = (_a = process.env.REACT_APP_RTDB_EMULATOR_NS) != null ? _a : "demo-local";
+    const namespace = (_b = process.env.REACT_APP_RTDB_EMULATOR_NS) != null ? _b : "demo-local";
     return { type: "emulator", host, port, namespace };
   }
   if (firebaseConfig && Object.keys(firebaseConfig).length > 0) {
@@ -188,7 +215,7 @@ function RtdbConfigWarning({ onDismiss }) {
     }
   );
 }
-function StandaloneProvider({ createController, addToast, firebaseConfig, tenant, children }) {
+function StandaloneProvider({ createController, addToast, firebaseConfig, emulator, tenant, children }) {
   const [subscriptions] = (0, import_react3.useState)([]);
   const subscriptionsRef = (0, import_react3.useRef)(subscriptions);
   subscriptionsRef.current = subscriptions;
@@ -223,7 +250,7 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
     let cancelled = false;
     (async () => {
       var _a;
-      const strategy = await resolveRtdbStrategy(firebaseConfig);
+      const strategy = await resolveRtdbStrategy(firebaseConfig, emulator);
       if (cancelled) return;
       if (strategy.type === "none") {
         if (process.env.NODE_ENV !== "production") setRtdbWarning(true);
@@ -291,7 +318,7 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
       cancelled = true;
       cleanup == null ? void 0 : cleanup();
     };
-  }, [firebaseConfig, tenant]);
+  }, [firebaseConfig, emulator, tenant]);
   const value = (0, import_react3.useMemo)(
     () => ({
       createController,
@@ -304,7 +331,8 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
       },
       handleLogout: () => {
       },
-      hostedByCore: false
+      hostedByCore: false,
+      observability: new NullObservabilityAdapter()
     }),
     [createController, toast, subscribe, unsubscribe]
   );
@@ -323,14 +351,14 @@ var DEFAULT_DEV_USER = {
   lastName: "User",
   token: "dev-standalone-token",
   email: "dev@teraprox.local",
-  id: "dev-user-id",
+  id: "1",
   role: "admin",
   user: "devuser",
   userName: "devuser",
   setor: "Desenvolvimento",
-  userSetor: { setorId: "dev-setor-id" },
+  userSetor: { setorId: "1" },
   companyName: "Dev Company",
-  companyId: "dev-company-id",
+  companyId: "1",
   filters: []
 };
 function DevAutoLogin({ actions, devUser, children }) {

package/dist/federation.mjs

@@ -3,7 +3,7 @@ import {
   FederatedBridge,
   StandaloneProvider,
   createReducersBundle
-} from "./chunk-PATJPPYP.mjs";
+} from "./chunk-JK654W4P.mjs";
 export {
   DevAutoLogin,
   FederatedBridge,

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as CoreService, H as HttpController, T as ToastService } from './federation-B4ShfmDd.mjs';
-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-B4ShfmDd.mjs';
+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.mjs';
+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.mjs';
 import * as React from 'react';
 import { Dispatch } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -34,8 +34,134 @@ 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;
+    constructor(endpoint: string);
+    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<never[]>;
+    post(path?: string): Promise<never[]>;
+    put(path?: string): Promise<never[]>;
+    patch(path?: string): Promise<never[]>;
+    delete(path?: string, id?: string | number): Promise<never[]>;
+    deleteSimple(path?: string): Promise<never[]>;
+    save(path?: string): Promise<never[]>;
+    read(path?: string, id?: string | number): Promise<never[]>;
+    readAll(path?: string): Promise<never[]>;
+    readAllwithPage(path?: string): Promise<never[]>;
+    bulkDelete(path?: string): Promise<never[]>;
+}
+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;
+    /** Identificador único desta cadeia de spans — compartilhado por todas as reqs do controller. */
+    private readonly traceId;
+    constructor(endpoint: string);
+    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 +206,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 +334,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 +385,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 };