teraprox-core-sdk 0.3.1 → 0.3.3

package/dist/{chunk-N7KKTEAH.mjs → chunk-CLNYFYWU.mjs}

@@ -54,11 +54,112 @@ function createReducersBundle(config) {
 
 // src/federation/StandaloneProvider.tsx
 import { useMemo, useCallback, useState, useEffect as useEffect2, useRef } from "react";
-import { jsx as jsx2 } from "react/jsx-runtime";
-function StandaloneProvider({ createController, addToast, firebaseConfig, tenant, children }) {
+import { jsx as jsx2, jsxs } from "react/jsx-runtime";
+async function probeEmulator(host, port) {
+  try {
+    const res = await fetch(`http://${host}:${port}/.json`, {
+      signal: AbortSignal.timeout(1500)
+    });
+    return res.ok || res.status === 404;
+  } catch (e) {
+    return false;
+  }
+}
+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 = (_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) {
+    return { type: "cloud", config: firebaseConfig };
+  }
+  const alive = await probeEmulator("localhost", 9e3);
+  if (alive) {
+    return { type: "emulator", host: "localhost", port: 9e3, namespace: "demo-local" };
+  }
+  return { type: "none" };
+}
+var _emulatorConnected = /* @__PURE__ */ new Set();
+function RtdbConfigWarning({ onDismiss }) {
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      style: {
+        position: "fixed",
+        bottom: 24,
+        right: 24,
+        zIndex: 99999,
+        background: "#1a1a2e",
+        color: "#fff",
+        borderRadius: 8,
+        padding: "16px 20px",
+        maxWidth: 420,
+        boxShadow: "0 4px 24px rgba(0,0,0,0.5)",
+        borderLeft: "4px solid #f59e0b",
+        fontFamily: "monospace",
+        fontSize: 13,
+        lineHeight: 1.6
+      },
+      children: [
+        /* @__PURE__ */ jsx2("div", { style: { fontWeight: "bold", marginBottom: 8, color: "#f59e0b", fontSize: 14 }, children: "\u26A0 RTDB n\xE3o configurado" }),
+        /* @__PURE__ */ jsxs("div", { children: [
+          "Matching Objects em tempo real desativados.",
+          /* @__PURE__ */ jsx2("br", {}),
+          "Configure no ",
+          /* @__PURE__ */ jsx2("code", { children: ".env.dev" }),
+          ":",
+          /* @__PURE__ */ jsx2("br", {}),
+          /* @__PURE__ */ jsx2("code", { style: { color: "#86efac" }, children: "REACT_APP_RTDB_EMULATOR_HOST=localhost:9000" }),
+          /* @__PURE__ */ jsx2("br", {}),
+          /* @__PURE__ */ jsxs("span", { style: { color: "#94a3b8", fontSize: 11 }, children: [
+            "ou inicie o backend com ",
+            /* @__PURE__ */ jsx2("code", { children: "RtdbEmulatorPlugin" }),
+            " do @onroad/core"
+          ] }),
+          /* @__PURE__ */ jsx2("br", {}),
+          /* @__PURE__ */ jsxs("span", { style: { color: "#94a3b8", fontSize: 11 }, children: [
+            "e rode o emulator com ",
+            /* @__PURE__ */ jsx2("code", { children: "firebase emulators:start --only database" })
+          ] })
+        ] }),
+        /* @__PURE__ */ jsx2(
+          "button",
+          {
+            onClick: onDismiss,
+            style: {
+              marginTop: 12,
+              padding: "4px 14px",
+              background: "#374151",
+              color: "#fff",
+              border: "none",
+              borderRadius: 4,
+              cursor: "pointer",
+              fontSize: 12
+            },
+            children: "Fechar"
+          }
+        )
+      ]
+    }
+  );
+}
+function StandaloneProvider({ createController, addToast, firebaseConfig, emulator, tenant, children }) {
   const [subscriptions] = useState([]);
   const subscriptionsRef = useRef(subscriptions);
   subscriptionsRef.current = subscriptions;
+  const [rtdbWarning, setRtdbWarning] = useState(false);
   const toast = useMemo(
     () => ({
       success: (msg, opts) => addToast(msg, { appearance: "success", autoDismiss: true, ...opts }),
@@ -84,16 +185,49 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
     [subscriptions]
   );
   useEffect2(() => {
-    if (!firebaseConfig || !tenant || Object.keys(firebaseConfig).length === 0) return;
+    if (!tenant) return;
     let cleanup;
+    let cancelled = false;
     (async () => {
+      var _a;
+      const strategy = await resolveRtdbStrategy(firebaseConfig, emulator);
+      if (cancelled) return;
+      if (strategy.type === "none") {
+        if (process.env.NODE_ENV !== "production") setRtdbWarning(true);
+        return;
+      }
       try {
         const { initializeApp, getApps } = await import("firebase/app");
-        const { getDatabase, ref, onChildAdded, off } = await import("firebase/database");
-        if (!getApps().length) {
-          initializeApp(firebaseConfig);
+        const { getDatabase, ref, onChildAdded } = await import("firebase/database");
+        let db;
+        if (strategy.type === "emulator") {
+          const appName = `onroad-rtdb-emulator-${strategy.port}`;
+          const existingApp = getApps().find((a) => a.name === appName);
+          const emulatorApp = existingApp != null ? existingApp : initializeApp(
+            {
+              projectId: strategy.namespace,
+              databaseURL: `http://${strategy.host}:${strategy.port}?ns=${strategy.namespace}`
+            },
+            appName
+          );
+          db = getDatabase(emulatorApp);
+          if (!_emulatorConnected.has(appName)) {
+            const { connectDatabaseEmulator } = await import("firebase/database");
+            try {
+              connectDatabaseEmulator(db, strategy.host, strategy.port);
+              _emulatorConnected.add(appName);
+            } catch (e) {
+              _emulatorConnected.add(appName);
+            }
+          }
+          console.info(
+            `[StandaloneProvider] RTDB emulator at ${strategy.host}:${strategy.port} (ns=${strategy.namespace})`
+          );
+        } else {
+          const existingApp = (_a = getApps().find((a) => a.name === "[DEFAULT]")) != null ? _a : getApps()[0];
+          const cloudApp = existingApp != null ? existingApp : initializeApp(strategy.config);
+          db = getDatabase(cloudApp);
         }
-        const db = getDatabase();
         const moRef = ref(db, `${tenant}/matchingObjects`);
         const unsub = onChildAdded(moRef, (snapshot) => {
           const data = snapshot.val();
@@ -115,17 +249,16 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
             }
           }
         });
-        cleanup = () => {
-          off(moRef, "child_added", unsub);
-        };
+        cleanup = () => unsub();
       } catch (err) {
-        console.warn("[StandaloneProvider] Firebase RTDB listener failed \u2014 continuing without real-time:", err);
+        console.warn("[StandaloneProvider] Firebase RTDB listener failed:", err);
       }
     })();
     return () => {
+      cancelled = true;
       cleanup == null ? void 0 : cleanup();
     };
-  }, [firebaseConfig, tenant]);
+  }, [firebaseConfig, emulator, tenant]);
   const value = useMemo(
     () => ({
       createController,
@@ -142,7 +275,10 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
     }),
     [createController, toast, subscribe, unsubscribe]
   );
-  return /* @__PURE__ */ jsx2(CoreServiceContext.Provider, { value, children });
+  return /* @__PURE__ */ jsxs(CoreServiceContext.Provider, { value, children: [
+    children,
+    rtdbWarning && /* @__PURE__ */ jsx2(RtdbConfigWarning, { onDismiss: () => setRtdbWarning(false) })
+  ] });
 }
 
 // src/federation/DevAutoLogin.tsx

package/dist/{federation-BANKXvQ5.d.mts → federation-UNcGnNB-.d.mts}

@@ -119,6 +119,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
@@ -131,8 +136,22 @@ interface StandaloneConfig {
      * Firebase client config object (from REACT_APP_FIREBASE_CONFIG).
      * When provided together with `tenant`, enables real-time matching
      * object listening via Firebase RTDB — same path the Core uses.
+     *
+     * If omitted, the provider auto-detects the RTDB emulator:
+     *   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`
@@ -146,9 +165,11 @@ interface StandaloneConfig {
  * Replaces the StandaloneCoreServiceProvider that each remote copies.
  * The remote only needs to provide its createController and addToast.
  *
- * When `firebaseConfig` + `tenant` are provided the provider connects
- * to Firebase RTDB and dispatches incoming matching objects to all
- * active subscribers — mirroring the behaviour of the Core host.
+ * RTDB auto-resolution order (no config required):
+ *   1. `REACT_APP_RTDB_EMULATOR_HOST` env var → connects to emulator
+ *   2. `firebaseConfig` prop → connects to Firebase cloud
+ *   3. Auto-probe `localhost:9000` → uses emulator if alive
+ *   4. None found → shows configuration popup (dev only)
  *
  * USAGE IN REMOTES:
  * ```
@@ -158,13 +179,11 @@ interface StandaloneConfig {
  *
  * function App() {
  *   const { addToast } = useToasts()
- *   const firebaseConfig = JSON.parse(process.env.REACT_APP_FIREBASE_CONFIG || '{}')
  *   const tenant = useSelector(s => s.global.companyId)
  *   return (
  *     <StandaloneProvider
  *       createController={(ctx, ep) => basicController(ctx, ep)}
  *       addToast={addToast}
- *       firebaseConfig={firebaseConfig}
  *       tenant={tenant}
  *     >
  *       <Routes />
@@ -173,7 +192,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;

package/dist/{federation-BANKXvQ5.d.ts → federation-UNcGnNB-.d.ts}

@@ -119,6 +119,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
@@ -131,8 +136,22 @@ interface StandaloneConfig {
      * Firebase client config object (from REACT_APP_FIREBASE_CONFIG).
      * When provided together with `tenant`, enables real-time matching
      * object listening via Firebase RTDB — same path the Core uses.
+     *
+     * If omitted, the provider auto-detects the RTDB emulator:
+     *   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`
@@ -146,9 +165,11 @@ interface StandaloneConfig {
  * Replaces the StandaloneCoreServiceProvider that each remote copies.
  * The remote only needs to provide its createController and addToast.
  *
- * When `firebaseConfig` + `tenant` are provided the provider connects
- * to Firebase RTDB and dispatches incoming matching objects to all
- * active subscribers — mirroring the behaviour of the Core host.
+ * RTDB auto-resolution order (no config required):
+ *   1. `REACT_APP_RTDB_EMULATOR_HOST` env var → connects to emulator
+ *   2. `firebaseConfig` prop → connects to Firebase cloud
+ *   3. Auto-probe `localhost:9000` → uses emulator if alive
+ *   4. None found → shows configuration popup (dev only)
  *
  * USAGE IN REMOTES:
  * ```
@@ -158,13 +179,11 @@ interface StandaloneConfig {
  *
  * function App() {
  *   const { addToast } = useToasts()
- *   const firebaseConfig = JSON.parse(process.env.REACT_APP_FIREBASE_CONFIG || '{}')
  *   const tenant = useSelector(s => s.global.companyId)
  *   return (
  *     <StandaloneProvider
  *       createController={(ctx, ep) => basicController(ctx, ep)}
  *       addToast={addToast}
- *       firebaseConfig={firebaseConfig}
  *       tenant={tenant}
  *     >
  *       <Routes />
@@ -173,7 +192,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;

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-BANKXvQ5.mjs';
+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-UNcGnNB-.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-BANKXvQ5.js';
+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-UNcGnNB-.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/federation.js

@@ -96,10 +96,111 @@ function createReducersBundle(config) {
 // src/federation/StandaloneProvider.tsx
 var import_react3 = require("react");
 var import_jsx_runtime2 = require("react/jsx-runtime");
-function StandaloneProvider({ createController, addToast, firebaseConfig, tenant, children }) {
+async function probeEmulator(host, port) {
+  try {
+    const res = await fetch(`http://${host}:${port}/.json`, {
+      signal: AbortSignal.timeout(1500)
+    });
+    return res.ok || res.status === 404;
+  } catch (e) {
+    return false;
+  }
+}
+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 = (_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) {
+    return { type: "cloud", config: firebaseConfig };
+  }
+  const alive = await probeEmulator("localhost", 9e3);
+  if (alive) {
+    return { type: "emulator", host: "localhost", port: 9e3, namespace: "demo-local" };
+  }
+  return { type: "none" };
+}
+var _emulatorConnected = /* @__PURE__ */ new Set();
+function RtdbConfigWarning({ onDismiss }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+    "div",
+    {
+      style: {
+        position: "fixed",
+        bottom: 24,
+        right: 24,
+        zIndex: 99999,
+        background: "#1a1a2e",
+        color: "#fff",
+        borderRadius: 8,
+        padding: "16px 20px",
+        maxWidth: 420,
+        boxShadow: "0 4px 24px rgba(0,0,0,0.5)",
+        borderLeft: "4px solid #f59e0b",
+        fontFamily: "monospace",
+        fontSize: 13,
+        lineHeight: 1.6
+      },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: { fontWeight: "bold", marginBottom: 8, color: "#f59e0b", fontSize: 14 }, children: "\u26A0 RTDB n\xE3o configurado" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { children: [
+          "Matching Objects em tempo real desativados.",
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("br", {}),
+          "Configure no ",
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("code", { children: ".env.dev" }),
+          ":",
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("br", {}),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("code", { style: { color: "#86efac" }, children: "REACT_APP_RTDB_EMULATOR_HOST=localhost:9000" }),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("br", {}),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { style: { color: "#94a3b8", fontSize: 11 }, children: [
+            "ou inicie o backend com ",
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("code", { children: "RtdbEmulatorPlugin" }),
+            " do @onroad/core"
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("br", {}),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { style: { color: "#94a3b8", fontSize: 11 }, children: [
+            "e rode o emulator com ",
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("code", { children: "firebase emulators:start --only database" })
+          ] })
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+          "button",
+          {
+            onClick: onDismiss,
+            style: {
+              marginTop: 12,
+              padding: "4px 14px",
+              background: "#374151",
+              color: "#fff",
+              border: "none",
+              borderRadius: 4,
+              cursor: "pointer",
+              fontSize: 12
+            },
+            children: "Fechar"
+          }
+        )
+      ]
+    }
+  );
+}
+function StandaloneProvider({ createController, addToast, firebaseConfig, emulator, tenant, children }) {
   const [subscriptions] = (0, import_react3.useState)([]);
   const subscriptionsRef = (0, import_react3.useRef)(subscriptions);
   subscriptionsRef.current = subscriptions;
+  const [rtdbWarning, setRtdbWarning] = (0, import_react3.useState)(false);
   const toast = (0, import_react3.useMemo)(
     () => ({
       success: (msg, opts) => addToast(msg, { appearance: "success", autoDismiss: true, ...opts }),
@@ -125,16 +226,49 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
     [subscriptions]
   );
   (0, import_react3.useEffect)(() => {
-    if (!firebaseConfig || !tenant || Object.keys(firebaseConfig).length === 0) return;
+    if (!tenant) return;
     let cleanup;
+    let cancelled = false;
     (async () => {
+      var _a;
+      const strategy = await resolveRtdbStrategy(firebaseConfig, emulator);
+      if (cancelled) return;
+      if (strategy.type === "none") {
+        if (process.env.NODE_ENV !== "production") setRtdbWarning(true);
+        return;
+      }
       try {
         const { initializeApp, getApps } = await import("firebase/app");
-        const { getDatabase, ref, onChildAdded, off } = await import("firebase/database");
-        if (!getApps().length) {
-          initializeApp(firebaseConfig);
+        const { getDatabase, ref, onChildAdded } = await import("firebase/database");
+        let db;
+        if (strategy.type === "emulator") {
+          const appName = `onroad-rtdb-emulator-${strategy.port}`;
+          const existingApp = getApps().find((a) => a.name === appName);
+          const emulatorApp = existingApp != null ? existingApp : initializeApp(
+            {
+              projectId: strategy.namespace,
+              databaseURL: `http://${strategy.host}:${strategy.port}?ns=${strategy.namespace}`
+            },
+            appName
+          );
+          db = getDatabase(emulatorApp);
+          if (!_emulatorConnected.has(appName)) {
+            const { connectDatabaseEmulator } = await import("firebase/database");
+            try {
+              connectDatabaseEmulator(db, strategy.host, strategy.port);
+              _emulatorConnected.add(appName);
+            } catch (e) {
+              _emulatorConnected.add(appName);
+            }
+          }
+          console.info(
+            `[StandaloneProvider] RTDB emulator at ${strategy.host}:${strategy.port} (ns=${strategy.namespace})`
+          );
+        } else {
+          const existingApp = (_a = getApps().find((a) => a.name === "[DEFAULT]")) != null ? _a : getApps()[0];
+          const cloudApp = existingApp != null ? existingApp : initializeApp(strategy.config);
+          db = getDatabase(cloudApp);
         }
-        const db = getDatabase();
         const moRef = ref(db, `${tenant}/matchingObjects`);
         const unsub = onChildAdded(moRef, (snapshot) => {
           const data = snapshot.val();
@@ -156,17 +290,16 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
             }
           }
         });
-        cleanup = () => {
-          off(moRef, "child_added", unsub);
-        };
+        cleanup = () => unsub();
       } catch (err) {
-        console.warn("[StandaloneProvider] Firebase RTDB listener failed \u2014 continuing without real-time:", err);
+        console.warn("[StandaloneProvider] Firebase RTDB listener failed:", err);
       }
     })();
     return () => {
+      cancelled = true;
       cleanup == null ? void 0 : cleanup();
     };
-  }, [firebaseConfig, tenant]);
+  }, [firebaseConfig, emulator, tenant]);
   const value = (0, import_react3.useMemo)(
     () => ({
       createController,
@@ -183,7 +316,10 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
     }),
     [createController, toast, subscribe, unsubscribe]
   );
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(CoreServiceContext.Provider, { value, children });
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(CoreServiceContext.Provider, { value, children: [
+    children,
+    rtdbWarning && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(RtdbConfigWarning, { onDismiss: () => setRtdbWarning(false) })
+  ] });
 }
 
 // src/federation/DevAutoLogin.tsx

package/dist/federation.mjs

@@ -3,7 +3,7 @@ import {
   FederatedBridge,
   StandaloneProvider,
   createReducersBundle
-} from "./chunk-N7KKTEAH.mjs";
+} from "./chunk-CLNYFYWU.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-BANKXvQ5.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-BANKXvQ5.mjs';
+import { C as CoreService, H as HttpController, T as ToastService } from './federation-UNcGnNB-.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-UNcGnNB-.mjs';
 import * as React from 'react';
 import { Dispatch } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CoreService, H as HttpController, T as ToastService } from './federation-BANKXvQ5.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-BANKXvQ5.js';
+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 * as React from 'react';
 import { Dispatch } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';

package/dist/index.js

@@ -1343,10 +1343,111 @@ function createReducersBundle(config) {
 // src/federation/StandaloneProvider.tsx
 var import_react19 = require("react");
 var import_jsx_runtime8 = require("react/jsx-runtime");
-function StandaloneProvider({ createController, addToast, firebaseConfig, tenant, children }) {
+async function probeEmulator(host, port) {
+  try {
+    const res = await fetch(`http://${host}:${port}/.json`, {
+      signal: AbortSignal.timeout(1500)
+    });
+    return res.ok || res.status === 404;
+  } catch (e) {
+    return false;
+  }
+}
+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 = (_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) {
+    return { type: "cloud", config: firebaseConfig };
+  }
+  const alive = await probeEmulator("localhost", 9e3);
+  if (alive) {
+    return { type: "emulator", host: "localhost", port: 9e3, namespace: "demo-local" };
+  }
+  return { type: "none" };
+}
+var _emulatorConnected = /* @__PURE__ */ new Set();
+function RtdbConfigWarning({ onDismiss }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
+    "div",
+    {
+      style: {
+        position: "fixed",
+        bottom: 24,
+        right: 24,
+        zIndex: 99999,
+        background: "#1a1a2e",
+        color: "#fff",
+        borderRadius: 8,
+        padding: "16px 20px",
+        maxWidth: 420,
+        boxShadow: "0 4px 24px rgba(0,0,0,0.5)",
+        borderLeft: "4px solid #f59e0b",
+        fontFamily: "monospace",
+        fontSize: 13,
+        lineHeight: 1.6
+      },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { style: { fontWeight: "bold", marginBottom: 8, color: "#f59e0b", fontSize: 14 }, children: "\u26A0 RTDB n\xE3o configurado" }),
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { children: [
+          "Matching Objects em tempo real desativados.",
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("br", {}),
+          "Configure no ",
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("code", { children: ".env.dev" }),
+          ":",
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("br", {}),
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("code", { style: { color: "#86efac" }, children: "REACT_APP_RTDB_EMULATOR_HOST=localhost:9000" }),
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("br", {}),
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("span", { style: { color: "#94a3b8", fontSize: 11 }, children: [
+            "ou inicie o backend com ",
+            /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("code", { children: "RtdbEmulatorPlugin" }),
+            " do @onroad/core"
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("br", {}),
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("span", { style: { color: "#94a3b8", fontSize: 11 }, children: [
+            "e rode o emulator com ",
+            /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("code", { children: "firebase emulators:start --only database" })
+          ] })
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+          "button",
+          {
+            onClick: onDismiss,
+            style: {
+              marginTop: 12,
+              padding: "4px 14px",
+              background: "#374151",
+              color: "#fff",
+              border: "none",
+              borderRadius: 4,
+              cursor: "pointer",
+              fontSize: 12
+            },
+            children: "Fechar"
+          }
+        )
+      ]
+    }
+  );
+}
+function StandaloneProvider({ createController, addToast, firebaseConfig, emulator, tenant, children }) {
   const [subscriptions] = (0, import_react19.useState)([]);
   const subscriptionsRef = (0, import_react19.useRef)(subscriptions);
   subscriptionsRef.current = subscriptions;
+  const [rtdbWarning, setRtdbWarning] = (0, import_react19.useState)(false);
   const toast = (0, import_react19.useMemo)(
     () => ({
       success: (msg, opts) => addToast(msg, { appearance: "success", autoDismiss: true, ...opts }),
@@ -1372,16 +1473,49 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
     [subscriptions]
   );
   (0, import_react19.useEffect)(() => {
-    if (!firebaseConfig || !tenant || Object.keys(firebaseConfig).length === 0) return;
+    if (!tenant) return;
     let cleanup;
+    let cancelled = false;
     (async () => {
+      var _a;
+      const strategy = await resolveRtdbStrategy(firebaseConfig, emulator);
+      if (cancelled) return;
+      if (strategy.type === "none") {
+        if (process.env.NODE_ENV !== "production") setRtdbWarning(true);
+        return;
+      }
       try {
         const { initializeApp, getApps } = await import("firebase/app");
-        const { getDatabase, ref, onChildAdded, off } = await import("firebase/database");
-        if (!getApps().length) {
-          initializeApp(firebaseConfig);
+        const { getDatabase, ref, onChildAdded } = await import("firebase/database");
+        let db;
+        if (strategy.type === "emulator") {
+          const appName = `onroad-rtdb-emulator-${strategy.port}`;
+          const existingApp = getApps().find((a) => a.name === appName);
+          const emulatorApp = existingApp != null ? existingApp : initializeApp(
+            {
+              projectId: strategy.namespace,
+              databaseURL: `http://${strategy.host}:${strategy.port}?ns=${strategy.namespace}`
+            },
+            appName
+          );
+          db = getDatabase(emulatorApp);
+          if (!_emulatorConnected.has(appName)) {
+            const { connectDatabaseEmulator } = await import("firebase/database");
+            try {
+              connectDatabaseEmulator(db, strategy.host, strategy.port);
+              _emulatorConnected.add(appName);
+            } catch (e) {
+              _emulatorConnected.add(appName);
+            }
+          }
+          console.info(
+            `[StandaloneProvider] RTDB emulator at ${strategy.host}:${strategy.port} (ns=${strategy.namespace})`
+          );
+        } else {
+          const existingApp = (_a = getApps().find((a) => a.name === "[DEFAULT]")) != null ? _a : getApps()[0];
+          const cloudApp = existingApp != null ? existingApp : initializeApp(strategy.config);
+          db = getDatabase(cloudApp);
         }
-        const db = getDatabase();
         const moRef = ref(db, `${tenant}/matchingObjects`);
         const unsub = onChildAdded(moRef, (snapshot) => {
           const data = snapshot.val();
@@ -1403,17 +1537,16 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
             }
           }
         });
-        cleanup = () => {
-          off(moRef, "child_added", unsub);
-        };
+        cleanup = () => unsub();
       } catch (err) {
-        console.warn("[StandaloneProvider] Firebase RTDB listener failed \u2014 continuing without real-time:", err);
+        console.warn("[StandaloneProvider] Firebase RTDB listener failed:", err);
       }
     })();
     return () => {
+      cancelled = true;
       cleanup == null ? void 0 : cleanup();
     };
-  }, [firebaseConfig, tenant]);
+  }, [firebaseConfig, emulator, tenant]);
   const value = (0, import_react19.useMemo)(
     () => ({
       createController,
@@ -1430,7 +1563,10 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, tenant
     }),
     [createController, toast, subscribe, unsubscribe]
   );
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(CoreServiceContext.Provider, { value, children });
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(CoreServiceContext.Provider, { value, children: [
+    children,
+    rtdbWarning && /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(RtdbConfigWarning, { onDismiss: () => setRtdbWarning(false) })
+  ] });
 }
 
 // src/federation/DevAutoLogin.tsx

package/dist/index.mjs

@@ -4,7 +4,7 @@ import {
   FederatedBridge,
   StandaloneProvider,
   createReducersBundle
-} from "./chunk-N7KKTEAH.mjs";
+} from "./chunk-CLNYFYWU.mjs";
 
 // src/hooks/useCoreService.ts
 import { useContext } from "react";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teraprox-core-sdk",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Contrato tipado Core ↔ Federados — interfaces, context, hooks e componentes compartilhados",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -46,7 +46,9 @@
     "react-router-dom": ">=6.0.0"
   },
   "peerDependenciesMeta": {
-    "firebase": { "optional": true }
+    "firebase": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@reduxjs/toolkit": "^2.0.0",