teraprox-core-sdk 0.3.3 → 0.3.6

package/dist/index.js

@@ -30,13 +30,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CoreServiceBuilder: () => CoreServiceBuilder,
   CoreServiceContext: () => CoreServiceContext,
   DevAutoLogin: () => DevAutoLogin,
   FederatedBridge: () => FederatedBridge,
+  FetchHttpAdapter: () => FetchHttpAdapter,
+  NullCoreService: () => NullCoreService,
+  NullHttpController: () => NullHttpController,
+  NullObservabilityAdapter: () => NullObservabilityAdapter,
+  NullToastService: () => NullToastService,
   RecursoDisplayer: () => RecursoDisplayer_default,
   StandaloneProvider: () => StandaloneProvider,
+  TracingHttpAdapter: () => TracingHttpAdapter,
   addDays: () => addDays,
   branchLevelReducer: () => branchLevelReducer_default,
+  buildTraceparent: () => buildTraceparent,
   capitalize: () => capitalize,
   clearBranchLevelForm: () => clearBranchLevelForm,
   clearPicker: () => clearPicker,
@@ -44,6 +52,9 @@ __export(index_exports, {
   daysBetween: () => daysBetween,
   formatDate: () => formatDate,
   formatDateTime: () => formatDateTime,
+  generateSpanId: () => generateSpanId,
+  generateTraceId: () => generateTraceId,
+  initWebVitals: () => initWebVitals,
   isBlank: () => isBlank,
   isDateAfter: () => isDateAfter,
   isDateBefore: () => isDateBefore,
@@ -72,6 +83,7 @@ __export(index_exports, {
   useMatchingObject: () => useMatchingObject,
   useNavigator: () => useNavigator,
   useNotifications: () => useNotifications,
+  useObservability: () => useObservability,
   usePostData: () => usePostData,
   useSmartSearch: () => useSmartSearch,
   useToast: () => useToast,
@@ -83,14 +95,340 @@ module.exports = __toCommonJS(index_exports);
 var import_react = require("react");
 var CoreServiceContext = (0, import_react.createContext)(null);
 
+// 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/adapters/null/NullObjectAdapters.ts
+var NullToastService = class {
+  success(message) {
+    console.log(`[Toast Fallback] SUCCESS: ${message}`);
+  }
+  warning(message) {
+    console.warn(`[Toast Fallback] WARNING: ${message}`);
+  }
+  error(message) {
+    console.error(`[Toast Fallback] ERROR: ${message}`);
+  }
+  info(message) {
+    console.info(`[Toast Fallback] INFO: ${message}`);
+  }
+};
+var NullHttpController = class {
+  logAndResolve(method, path, context) {
+    console.warn(`[Http Fallback] MOCK ${method} requisitado para ${path} (Contexto: ${context})`);
+    if (process.env.NODE_ENV !== "production") {
+      if (context === "arvoreEstrutural" && path && path.includes("branchByBranchLevel")) {
+        return Promise.resolve([
+          {
+            id: 1,
+            nome: "Planta Industrial Mock",
+            branchLevel: { level: 1 },
+            status: "Ativo"
+          }
+        ]);
+      }
+      if (context === "branchLevel" && method === "READ_ALL") {
+        return Promise.resolve([
+          { id: 1, level: 1, nome: "Empresa" },
+          { id: 2, level: 2, nome: "Unidade" },
+          { id: 3, level: 3, nome: "\xC1rea" },
+          { id: 4, level: 4, nome: "M\xE1quina" }
+        ]);
+      }
+    }
+    return Promise.resolve([]);
+  }
+  get(path) {
+    return this.logAndResolve("GET", path, this.context);
+  }
+  post(path) {
+    return this.logAndResolve("POST", path, this.context);
+  }
+  put(path) {
+    return this.logAndResolve("PUT", path, this.context);
+  }
+  patch(path) {
+    return this.logAndResolve("PATCH", path, this.context);
+  }
+  delete(path, id) {
+    return this.logAndResolve("DELETE", `${path}/${id}`, this.context);
+  }
+  deleteSimple(path) {
+    return this.logAndResolve("DELETE", path, this.context);
+  }
+  save(path) {
+    return this.logAndResolve("SAVE", path, this.context);
+  }
+  read(path, id) {
+    return this.logAndResolve("READ", `${path}/${id}`, this.context);
+  }
+  readAll(path) {
+    return this.logAndResolve("READ_ALL", path, this.context);
+  }
+  readAllwithPage(path) {
+    return this.logAndResolve("READ_ALL_PAGE", path, this.context);
+  }
+  bulkDelete(path) {
+    return this.logAndResolve("BULK_DELETE", path, this.context);
+  }
+};
+var NullCoreService = {
+  toast: new NullToastService(),
+  createController: (context) => {
+    console.warn(`[CoreService Fallback] createController chamado para "${context}" sem Adapter. Usando NullHttpController.`);
+    const controller = new NullHttpController();
+    controller.context = context;
+    return controller;
+  },
+  subscribe: (mo) => console.log(`[CoreService Fallback] Inscri\xE7\xE3o simulada RTDB: ${mo.context}`),
+  unsubscribe: (mo) => console.log(`[CoreService Fallback] Desinscri\xE7\xE3o simulada RTDB: ${mo.context}`),
+  subscribeEvent: (evt) => console.log(`[CoreService Fallback] Inscri\xE7\xE3o Evento: ${evt}`),
+  unsubscribeEvent: (evt) => console.log(`[CoreService Fallback] Desinscri\xE7\xE3o Evento: ${evt}`),
+  handleLogout: () => console.log(`[CoreService Fallback] Realizando logout...`),
+  hostedByCore: false,
+  observability: new NullObservabilityAdapter()
+};
+
+// src/utils/tracing.ts
+function toHex(bytes) {
+  return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+function generateTraceId() {
+  const bytes = new Uint8Array(16);
+  crypto.getRandomValues(bytes);
+  return toHex(bytes);
+}
+function generateSpanId() {
+  const bytes = new Uint8Array(8);
+  crypto.getRandomValues(bytes);
+  return toHex(bytes);
+}
+function buildTraceparent(traceId, spanId, sampled = true) {
+  return `00-${traceId}-${spanId}-${sampled ? "01" : "00"}`;
+}
+
+// src/adapters/TracingHttpAdapter.ts
+var TracingHttpAdapter = class {
+  constructor(endpoint, extraHeaders) {
+    this.endpoint = endpoint;
+    this.extraHeaders = extraHeaders;
+    this.traceId = generateTraceId();
+  }
+  mergeHeaders(extraHeaders, withContentType = false) {
+    const spanId = generateSpanId();
+    const headers = {
+      traceparent: buildTraceparent(this.traceId, spanId),
+      ...this.extraHeaders,
+      ...extraHeaders
+    };
+    if (withContentType && !headers["Content-Type"]) {
+      headers["Content-Type"] = "application/json";
+    }
+    return headers;
+  }
+  async request(method, extraPath, data, extraHeaders) {
+    const url = extraPath ? `${this.endpoint}/${extraPath}` : this.endpoint;
+    const isFormData = data instanceof FormData;
+    const headers = this.mergeHeaders(extraHeaders, data !== void 0 && !isFormData);
+    try {
+      const res = await fetch(url, {
+        method,
+        headers,
+        body: data !== void 0 ? isFormData ? data : JSON.stringify(data) : void 0
+      });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return await res.json();
+    } catch (e) {
+      console.warn(`[TracingHttpAdapter] Falha ao fazer ${method} para ${url}:`, e);
+      return [];
+    }
+  }
+  get(path) {
+    return this.request("GET", path || "");
+  }
+  post(path, data, extraHeaders) {
+    return this.request("POST", path || "", data, extraHeaders);
+  }
+  put(path, data, extraHeaders) {
+    return this.request("PUT", path || "", data, extraHeaders);
+  }
+  patch(path, data, extraHeaders) {
+    return this.request("PATCH", path || "", data, extraHeaders);
+  }
+  delete(path, id, extraHeaders) {
+    return this.request("DELETE", `${path || ""}/${id}`, void 0, extraHeaders);
+  }
+  deleteSimple(path, extraHeaders) {
+    return this.request("DELETE", path || "", void 0, extraHeaders);
+  }
+  save(path, data, extraHeaders) {
+    return this.request("POST", path || "", data, extraHeaders);
+  }
+  read(path, id, extraHeaders) {
+    return this.request("GET", `${path || ""}/${id}`, void 0, extraHeaders);
+  }
+  readAll(path, extraHeaders) {
+    return this.request("GET", path || "", void 0, extraHeaders);
+  }
+  readAllwithPage(path) {
+    return this.request("GET", path || "");
+  }
+  bulkDelete(path, ids, extraHeaders) {
+    return this.request("DELETE", path || "", ids, extraHeaders);
+  }
+};
+
+// src/factories/CoreServiceBuilder.ts
+var FetchHttpAdapter = class {
+  constructor(endpoint, extraHeaders) {
+    this.endpoint = endpoint;
+    this.extraHeaders = extraHeaders;
+  }
+  async request(method, extraPath, data) {
+    const url = extraPath ? `${this.endpoint}/${extraPath}` : this.endpoint;
+    try {
+      const res = await fetch(url, {
+        method,
+        headers: {
+          ...this.extraHeaders,
+          ...data ? { "Content-Type": "application/json" } : {}
+        },
+        body: data ? JSON.stringify(data) : void 0
+      });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return await res.json();
+    } catch (e) {
+      console.warn(`[FetchHttpAdapter] Falha ao fazer ${method} para ${url}:`, e);
+      return [];
+    }
+  }
+  get(path) {
+    return this.request("GET", path || "");
+  }
+  post(path, data) {
+    return this.request("POST", path || "", data);
+  }
+  put(path, data) {
+    return this.request("PUT", path || "", data);
+  }
+  patch(path, data) {
+    return this.request("PATCH", path || "", data);
+  }
+  delete(path, id) {
+    return this.request("DELETE", `${path || ""}/${id}`);
+  }
+  deleteSimple(path) {
+    return this.request("DELETE", path || "");
+  }
+  save(path, data) {
+    return this.request("POST", path || "", data);
+  }
+  read(path, id) {
+    return this.request("GET", `${path || ""}/${id}`);
+  }
+  readAll(path) {
+    return this.request("GET", path || "");
+  }
+  readAllwithPage(path) {
+    return this.request("GET", path || "");
+  }
+  bulkDelete(path) {
+    return this.request("DELETE", path || "");
+  }
+};
+var CoreServiceBuilder = class {
+  constructor() {
+    this._toast = new NullToastService();
+    this._hostedByCore = false;
+    this._observability = new NullObservabilityAdapter();
+    this._tracing = false;
+  }
+  withToast(toast) {
+    this._toast = toast;
+    return this;
+  }
+  withHttpEndpoint(url) {
+    this._httpEndpoint = url;
+    return this;
+  }
+  withRtdbConfig(config) {
+    this._rtdbConfig = config;
+    return this;
+  }
+  setHostedByCore(hosted) {
+    this._hostedByCore = hosted;
+    return this;
+  }
+  withObservability(observability) {
+    this._observability = observability;
+    return 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 = true) {
+    this._tracing = enabled;
+    return this;
+  }
+  build() {
+    return {
+      toast: this._toast,
+      createController: (context, baseEndPoint) => {
+        const endpoint = baseEndPoint != null ? baseEndPoint : this._httpEndpoint ? `${this._httpEndpoint}/${context}` : null;
+        if (!endpoint) {
+          console.warn(`[CoreServiceBuilder] HttpEndpoint nulo para "${context}". Usando NullHttpController.`);
+          const controller = new NullHttpController();
+          controller.context = context;
+          return controller;
+        }
+        const xTeraproxHost = context === "solicitacaoDeServico" || context === "manutencao" ? "manutencao" : context;
+        const extraHeaders = { "x-teraprox-host": xTeraproxHost };
+        return this._tracing ? new TracingHttpAdapter(endpoint, extraHeaders) : new FetchHttpAdapter(endpoint, extraHeaders);
+      },
+      subscribe: (mo) => {
+        console.log(`[CoreServiceBuilder RTDB] Subscribe > ${mo.context}`);
+      },
+      unsubscribe: (mo) => {
+        console.log(`[CoreServiceBuilder RTDB] Unsubscribe > ${mo.context}`);
+      },
+      subscribeEvent: (evt) => {
+      },
+      unsubscribeEvent: (evt) => {
+      },
+      handleLogout: () => console.log("Logout invocado no Standalone mode"),
+      hostedByCore: this._hostedByCore,
+      observability: this._observability
+    };
+  }
+};
+
 // src/hooks/useCoreService.ts
 var import_react2 = require("react");
 function useCoreService() {
   const ctx = (0, import_react2.useContext)(CoreServiceContext);
   if (!ctx) {
-    throw new Error(
-      "useCoreService must be used within a CoreServiceProvider. Are you running outside Core (standalone mode)?"
-    );
+    if (process.env.NODE_ENV !== "production") {
+      console.warn(
+        "[useCoreService] rodando sem Provider. O SDK ativou os Fallbacks (Null Object Pattern)."
+      );
+    }
+    return NullCoreService;
   }
   return ctx;
 }
@@ -191,6 +529,11 @@ function useNavigator(config) {
   );
 }
 
+// src/hooks/useObservability.ts
+function useObservability() {
+  return useCoreService().observability;
+}
+
 // src/hooks/useFetchData.ts
 var import_react6 = require("react");
 function useFetchData() {
@@ -1246,6 +1589,39 @@ var {
 } = pickerSlice.actions;
 var pickerReducer_default = pickerSlice.reducer;
 
+// src/utils/webVitals.ts
+function initWebVitals(observability) {
+  if (typeof PerformanceObserver === "undefined") return;
+  try {
+    const lcpObserver = new PerformanceObserver((list) => {
+      const entries = list.getEntries();
+      if (!entries.length) return;
+      const last = entries[entries.length - 1];
+      observability.captureVitals({ name: "LCP", value: Math.round(last.startTime), unit: "ms" });
+    });
+    lcpObserver.observe({ type: "largest-contentful-paint", buffered: true });
+  } catch (_) {
+  }
+  try {
+    let clsValue = 0;
+    const clsObserver = new PerformanceObserver((list) => {
+      for (const entry of list.getEntries()) {
+        const ls = entry;
+        if (!ls.hadRecentInput && typeof ls.value === "number") {
+          clsValue += ls.value;
+        }
+      }
+      observability.captureVitals({
+        name: "CLS",
+        value: parseFloat(clsValue.toFixed(4)),
+        unit: "score"
+      });
+    });
+    clsObserver.observe({ type: "layout-shift", buffered: true });
+  } catch (_) {
+  }
+}
+
 // src/utils/dateUtils.ts
 var import_dayjs = __toESM(require("dayjs"));
 function formatDate(date, format = "DD/MM/YYYY") {
@@ -1559,7 +1935,8 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, emulat
       },
       handleLogout: () => {
       },
-      hostedByCore: false
+      hostedByCore: false,
+      observability: new NullObservabilityAdapter()
     }),
     [createController, toast, subscribe, unsubscribe]
   );
@@ -1578,14 +1955,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 }) {
@@ -1606,13 +1983,21 @@ function DevAutoLogin({ actions, devUser, children }) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CoreServiceBuilder,
   CoreServiceContext,
   DevAutoLogin,
   FederatedBridge,
+  FetchHttpAdapter,
+  NullCoreService,
+  NullHttpController,
+  NullObservabilityAdapter,
+  NullToastService,
   RecursoDisplayer,
   StandaloneProvider,
+  TracingHttpAdapter,
   addDays,
   branchLevelReducer,
+  buildTraceparent,
   capitalize,
   clearBranchLevelForm,
   clearPicker,
@@ -1620,6 +2005,9 @@ function DevAutoLogin({ actions, devUser, children }) {
   daysBetween,
   formatDate,
   formatDateTime,
+  generateSpanId,
+  generateTraceId,
+  initWebVitals,
   isBlank,
   isDateAfter,
   isDateBefore,
@@ -1648,6 +2036,7 @@ function DevAutoLogin({ actions, devUser, children }) {
   useMatchingObject,
   useNavigator,
   useNotifications,
+  useObservability,
   usePostData,
   useSmartSearch,
   useToast,