teraprox-core-sdk 0.3.10 → 0.3.14

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

@@ -78,6 +78,12 @@ interface IObservabilityPort {
     logBreadcrumb(payload: BreadcrumbPayload): void;
 }
 
+interface RateLimitEntry {
+    used: number;
+    limit: number;
+    exceeded: boolean;
+    windowReset: string;
+}
 interface CoreService {
     /** Cria um HttpController configurado para um contexto/endpoint */
     createController(context: string, baseEndPoint?: string): HttpController;
@@ -97,6 +103,8 @@ interface CoreService {
     hostedByCore: boolean;
     /** Porta de observabilidade — tracking, vitals e breadcrumbs */
     observability: IObservabilityPort;
+    /** Estado de rate limit em tempo real via RTDB. pathGroup → uso atual. */
+    rateLimits: Record<string, RateLimitEntry>;
 }
 
 interface FederatedBridgeProps {
@@ -123,28 +131,151 @@ interface FederatedBridgeProps {
 declare function FederatedBridge({ coreService, children }: FederatedBridgeProps): react_jsx_runtime.JSX.Element;
 
 /**
- * Factory for creating a standardized ReducersBundle.
+ * Indica se o bundle atual está sendo executado dentro do shell teraprox-core
+ * (Module Federation). O host define `window.__TERAPROX_HOSTED_BY_CORE__` via
+ * `FederatedBridge` ao montar o remote.
  *
- * Each remote only needs to declare ITS reducers and context map.
- * Resolution, deduplication, and loading logic lives here in the SDK.
+ * Use para ramificações raras (ex.: não montar `StandaloneProvider` duplicado).
+ * Para HTTP, prefira sempre `useCoreService().createController` — no host vem
+ * do `CoreServiceProvider`; em standalone vem do `StandaloneProvider`.
+ */
+declare function isHostedByCore(): boolean;
+
+/**
+ * Dependência de reducer declarada no manifest.
  *
- * USAGE IN REMOTES:
- * ```
- * import { createReducersBundle } from 'teraprox-core-sdk/federation'
+ * Cada rota declara quais fatias do Redux precisa.
+ * O core injeta APENAS essas fatias antes de montar o componente.
  *
- * export default createReducersBundle({
- *   reducers: {
- *     ordemDeServico: () => import('../Reducers/osReducer'),
- *     ordemDeManutencao: () => import('../Reducers/omReducer'),
- *   },
- *   contextMap: {
- *     visaoGeral: ['ordemDeServico', 'ordemDeManutencao'],
- *     ordemDeServico: ['ordemDeServico'],
- *   },
- *   defaults: ['picker', 'globalError'],
- * })
- * ```
+ * A string é a chave no store (ex: 'tarefa', 'solicitacaoDeServico').
+ */
+type ReducerDep = string;
+/**
+ * Manifesto que cada remote exporta para o Core
+ * montar menu e rotas dinamicamente.
+ */
+interface RemoteMenuItem {
+    /** Label exibido no menu */
+    label: string;
+    /** Rota no react-router (ex: '/manutencao/ordens-de-servico') */
+    path: string;
+    /** Nome do módulo no exposes do webpack (ex: './OrdensDeServico') */
+    module: string;
+    /** Contexto para ReducersBundle (ex: 'ordemDeServico') */
+    context: string;
+    /** Reducer keys que esta tela precisa no store do core */
+    reducers?: ReducerDep[];
+    /** ID do componente para withPermission */
+    componentId?: string;
+    /** Ícone react-icons (ex: 'FaTools') */
+    icon?: string;
+    /**
+     * Ordem dentro da sub-section (quando mesma `section.label` é declarada
+     * por múltiplos remotes e items são merged). Default = 999.
+     */
+    order?: number;
+}
+interface RemoteMenuSection {
+    /** Nome da seção no menu (ex: 'Manutenção') */
+    label: string;
+    /** Ícone da seção */
+    icon?: string;
+    items: RemoteMenuItem[];
+    /**
+     * NOVO: agrupamento global na MenuBar (ex: 'SGM').
+     * Sections com mesmo `group` (ou cujo manifest tem `menuGroup.name` igual)
+     * são fundidas em 1 nó top-level.
+     */
+    group?: string;
+    /** NOVO: ordem dentro do group (ou top-level). Default = 999 (final). */
+    order?: number;
+    /**
+     * NOVO: se true e dentro de group, items vão direto pro group
+     * (sem sub-grupo intermediário pela section.label). Default false.
+     */
+    flatten?: boolean;
+}
+/**
+ * Rota de formulário / tela interna que não aparece no menu,
+ * mas precisa ser registrada como <Route> no host.
+ */
+interface RemoteFormRoute {
+    /** Rota no react-router (ex: '/solicitacaoDeServicoForm') */
+    path: string;
+    /** Nome do módulo no exposes do webpack (ex: './SolicitacaoDeServicoForm') */
+    module: string;
+    /** Contexto para ReducersBundle e HTTP (ex: 'solicitacaoDeServico') */
+    context: string;
+    /** Reducer keys que esta tela precisa no store do core */
+    reducers?: ReducerDep[];
+}
+/**
+ * Reducers que o remote disponibiliza, agrupados por chave do store.
+ * O manifest declara quais cada rota precisa; o ReducersBundle provê os importadores.
+ */
+interface RemoteReducerMap {
+    [storeKey: string]: () => Promise<any>;
+}
+/**
+ * Reducers defaults que são injetados em TODAS as rotas do remote,
+ * independentemente do que cada rota declara.
+ */
+type DefaultReducerKeys = string[];
+interface RemoteManifest {
+    /** Nome do remote (deve corresponder ao name do ModuleFederationPlugin) */
+    name: string;
+    /** Versão semântica */
+    version: string;
+    /** Seções de menu que este remote contribui */
+    menuSections: RemoteMenuSection[];
+    /** Rotas internas (formulários, detalhe) que não aparecem no menu */
+    formRoutes?: RemoteFormRoute[];
+    /**
+     * Mapa de TODOS os reducers que este remote disponibiliza.
+     * Chave = nome no store, valor = lazy import do reducer.
+     * Se presente, o core usa isso + reducers[] de cada rota para injeção granular.
+     * Se ausente, fallback para o ReducersBundle legado.
+     */
+    reducerMap?: RemoteReducerMap;
+    /** Reducer keys injetados em TODAS as rotas deste remote */
+    defaultReducers?: DefaultReducerKeys;
+    /**
+     * NOVO opcional: aplica `group=name` a TODAS as `menuSections` deste remote
+     * (atalho declarativo). Sections com seu próprio `group` ainda têm precedência.
+     */
+    menuGroup?: {
+        name: string;
+        icon?: string;
+        order?: number;
+    };
+}
+
+/**
+ * Factories for creating standardized ReducersBundles.
+ *
+ * Two APIs:
+ *
+ * 1. `createReducersFromManifest` (RECOMENDADO) — Manifest-driven.
+ *    O manifest.js é a FONTE ÚNICA DE VERDADE: declara rotas, menu E reducer deps.
+ *    Zero contextMap manual.
+ *
+ *    ```ts
+ *    import { createReducersFromManifest } from 'teraprox-core-sdk/federation'
+ *    import { manifest } from './manifest'
+ *
+ *    export default createReducersFromManifest(manifest, {
+ *      solicitacaoDeServico: () => import('../Reducers/solicitacaoDeServicoReducer'),
+ *      tarefa:               () => import('../Reducers/tarefaReducer'),
+ *      justificativa:        () => import('../Reducers/justificativaReducer'),
+ *      globalError:          () => import('../Reducers/default-reducers/globalErrorReducer'),
+ *    })
+ *    ```
+ *
+ * 2. `createReducersBundle` (LEGADO) — contextMap manual.
+ *    Mantido para retrocompatibilidade com remotes que ainda não declararam
+ *    `reducers[]` nas rotas do manifest.
  */
+
 interface ReducersBundleConfig {
     /** Map de nome → importador lazy do reducer */
     reducers: Record<string, () => Promise<any>>;
@@ -159,10 +290,22 @@ interface ReducersBundle {
     getReducersForModule(opts: {
         context?: string;
         modulePath?: string;
+        reducerKeys?: string[];
     }): Promise<Record<string, any>>;
     loadAllReducers(): Promise<Record<string, any>>;
     baseReducers: Record<string, never>;
 }
+/**
+ * Cria um ReducersBundle a partir do manifest + mapa de importadores.
+ *
+ * O contextMap é DERIVADO automaticamente dos campos `reducers[]` e `context`
+ * de cada rota do manifest. Nenhuma declaração manual de contexto é necessária.
+ *
+ * @param manifest   — O mesmo objeto exportado como ./Manifest
+ * @param reducerMap — { storeKey: () => import('...') } para TODOS os reducers do remote
+ * @param defaultReducerKeys — Keys injetadas em todas as rotas (ex: 'globalError', 'notification')
+ */
+declare function createReducersFromManifest(manifest: RemoteManifest, reducerMap: Record<string, () => Promise<any>>, defaultReducerKeys?: string[]): ReducersBundle;
 declare function createReducersBundle(config: ReducersBundleConfig): ReducersBundle;
 
 interface EmulatorConfig {
@@ -172,12 +315,30 @@ interface EmulatorConfig {
 }
 interface StandaloneConfig {
     /**
-     * Factory for creating an HttpController. The remote provides its
-     * local implementation (using basicController + axios).
+     * Implementação de `CoreService.createController` **somente para modo standalone**
+     * (npm start do remote sem o shell). É a mesma *assinatura* que o core expõe
+     * em `CoreServiceProvider`, mas o host injeta a dele via `FederatedBridge`;
+     * telas devem sempre usar `useCoreService().createController` — nunca chamar
+     * esta factory diretamente.
      */
     createController: (context: string, baseEndPoint?: string) => HttpController;
-    /** Toast function from react-toast-notifications */
-    addToast: (message: string, options?: any) => void;
+    /**
+     * Pass a ToastService implementation directly (preferred).
+     * Eliminates the need for an addToast bridge in every remote.
+     *
+     * Example:
+     * ```
+     * const myToast: ToastService = { success: ..., warning: ..., error: ..., info: ... }
+     * <StandaloneProvider toast={myToast} ...>
+     * ```
+     */
+    toast?: ToastService;
+    /**
+     * react-toast-notifications style callback — kept for backward compatibility
+     * with remotes that already use ToastProvider + useToasts().
+     * When `toast` prop is provided, `addToast` is ignored.
+     */
+    addToast?: (message: string, options?: any) => void;
     /**
      * Firebase client config object (from REACT_APP_FIREBASE_CONFIG).
      * When provided together with `tenant`, enables real-time matching
@@ -201,6 +362,13 @@ interface StandaloneConfig {
     /**
      * Tenant / company ID used to build the RTDB path:
      * `{tenant}/matchingObjects`
+     *
+     * Resolution order (first non-empty value wins):
+     *   1. This prop (dynamic — typically from Redux state after login)
+     *   2. `REACT_APP_RTDB_TENANT` env var (static — set in the app's .env)
+     *   3. `'dev-local'` as last resort in NODE_ENV=development
+     *
+     * In production the prop MUST be provided; env-var fallback is for dev only.
      */
     tenant?: string;
     children: React__default.ReactNode;
@@ -238,7 +406,7 @@ interface StandaloneConfig {
  * }
  * ```
  */
-declare function StandaloneProvider({ createController, addToast, firebaseConfig, emulator, tenant, children }: StandaloneConfig): react_jsx_runtime.JSX.Element;
+declare function StandaloneProvider({ createController, toast: toastProp, addToast, firebaseConfig, emulator, tenant, children, }: StandaloneConfig): react_jsx_runtime.JSX.Element;
 
 interface DevUser {
     firstName: string;
@@ -283,37 +451,51 @@ interface DevAutoLoginProps {
 declare function DevAutoLogin({ actions, devUser, children }: DevAutoLoginProps): react_jsx_runtime.JSX.Element;
 
 /**
- * Manifesto que cada remote exporta para o Core
- * montar menu e rotas dinamicamente.
+ * Nó top-level da árvore de menu agregada.
+ * Pode representar um `group` (vários remotes/sections fundidos)
+ * ou uma section sem group (legacy / retrocompat).
  */
-interface RemoteMenuItem {
-    /** Label exibido no menu */
+interface MenuTreeNode {
+    /** Identificador único — `group:<name>` ou `<remote>:<sectionLabel>` */
+    key: string;
+    /** Label exibido no dropdown principal */
     label: string;
-    /** Rota no react-router (ex: '/manutencao/ordens-de-servico') */
-    path: string;
-    /** Nome do módulo no exposes do webpack (ex: './OrdensDeServico') */
-    module: string;
-    /** Contexto para ReducersBundle (ex: 'ordemDeServico') */
-    context: string;
-    /** ID do componente para withPermission */
-    componentId?: string;
-    /** Ícone react-icons (ex: 'FaTools') */
+    /** Ícone (react-icons name) */
     icon?: string;
+    /** Order (default 999) — usado para sort estável */
+    order: number;
+    /** Filhos: sub-sections (quando agrupando) ou items diretos */
+    children: MenuTreeChild[];
 }
-interface RemoteMenuSection {
-    /** Nome da seção no menu (ex: 'Manutenção') */
+/**
+ * Filho de um MenuTreeNode.
+ * - kind='section': sub-cabeçalho com items aninhados (default p/ group)
+ * - kind='item': item direto (top-level legacy ou flatten=true)
+ */
+type MenuTreeChild = {
+    kind: 'section';
     label: string;
-    /** Ícone da seção */
     icon?: string;
     items: RemoteMenuItem[];
-}
-interface RemoteManifest {
-    /** Nome do remote (deve corresponder ao name do ModuleFederationPlugin) */
-    name: string;
-    /** Versão semântica */
-    version: string;
-    /** Seções de menu que este remote contribui */
-    menuSections: RemoteMenuSection[];
-}
+    order?: number;
+} | {
+    kind: 'item';
+    item: RemoteMenuItem;
+    order?: number;
+};
+/**
+ * Recebe array de manifests e produz árvore agregada por `group`.
+ *
+ * Regras:
+ * - Sections sem group e sem `manifest.menuGroup` → top-level node próprio
+ *   (children = items diretos kind='item' — comportamento legado)
+ * - Sections com group (próprio ou herdado de menuGroup) → fundidas sob 1 node
+ *   `{ key='group:<name>', label=<name> }`
+ *   - flatten=true: items entram direto como children kind='item'
+ *   - flatten=false (default): wrapping `{kind:'section', label, items}`
+ * - `menuGroup` do manifest aplica fallback para sections que não declaram
+ *   o próprio `group` (não sobrescreve override por section).
+ */
+declare function groupMenuSections(manifests: RemoteManifest[]): MenuTreeNode[];
 
-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 };
+export { type BreadcrumbPayload as B, type CoreService as C, type DefaultReducerKeys as D, FederatedBridge as F, type HttpController as H, type IObservabilityPort as I, type MatchingObjectSubscription as M, type RateLimitEntry as R, StandaloneProvider as S, type ToastService as T, type VitalsPayload as V, type InteractionPayload as a, DevAutoLogin as b, type MenuTreeChild as c, type MenuTreeNode as d, type ReducerDep as e, type ReducersBundle as f, type ReducersBundleConfig as g, type RemoteFormRoute as h, type RemoteManifest as i, type RemoteMenuItem as j, type RemoteMenuSection as k, type RemoteReducerMap as l, type ToastOptions as m, createReducersBundle as n, createReducersFromManifest as o, groupMenuSections as p, isHostedByCore as q };

package/dist/federation.d.mts

@@ -1,3 +1,3 @@
-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';
+export { D as DefaultReducerKeys, b as DevAutoLogin, F as FederatedBridge, c as MenuTreeChild, d as MenuTreeNode, e as ReducerDep, f as ReducersBundle, g as ReducersBundleConfig, h as RemoteFormRoute, i as RemoteManifest, j as RemoteMenuItem, k as RemoteMenuSection, l as RemoteReducerMap, S as StandaloneProvider, n as createReducersBundle, o as createReducersFromManifest, p as groupMenuSections, q as isHostedByCore } from './federation-Cp_lk0Xd.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, b as ReducersBundleConfig, c as RemoteManifest, d as RemoteMenuItem, e as RemoteMenuSection, S as StandaloneProvider, g as createReducersBundle } from './federation-Bhx0XhSP.js';
+export { D as DefaultReducerKeys, b as DevAutoLogin, F as FederatedBridge, c as MenuTreeChild, d as MenuTreeNode, e as ReducerDep, f as ReducersBundle, g as ReducersBundleConfig, h as RemoteFormRoute, i as RemoteManifest, j as RemoteMenuItem, k as RemoteMenuSection, l as RemoteReducerMap, S as StandaloneProvider, n as createReducersBundle, o as createReducersFromManifest, p as groupMenuSections, q as isHostedByCore } from './federation-Cp_lk0Xd.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/federation.js

@@ -33,7 +33,10 @@ __export(federation_exports, {
   DevAutoLogin: () => DevAutoLogin,
   FederatedBridge: () => FederatedBridge,
   StandaloneProvider: () => StandaloneProvider,
-  createReducersBundle: () => createReducersBundle
+  createReducersBundle: () => createReducersBundle,
+  createReducersFromManifest: () => createReducersFromManifest,
+  groupMenuSections: () => groupMenuSections,
+  isHostedByCore: () => isHostedByCore
 });
 module.exports = __toCommonJS(federation_exports);
 
@@ -58,25 +61,78 @@ function FederatedBridge({ coreService, children }) {
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CoreServiceContext.Provider, { value: coreService, children });
 }
 
+// src/federation/isHostedByCore.ts
+function isHostedByCore() {
+  if (typeof window === "undefined") return false;
+  return !!window.__TERAPROX_HOSTED_BY_CORE__;
+}
+
 // src/federation/createReducersBundle.ts
+function buildGetReducersForKeys(reducers) {
+  return async (keys = []) => {
+    const uniqueKeys = [...new Set(keys)].filter((key) => !!reducers[key]);
+    const loaded = await Promise.all(
+      uniqueKeys.map(async (key) => {
+        const mod = await reducers[key]();
+        return [key, mod.default || mod];
+      })
+    );
+    return Object.fromEntries(loaded);
+  };
+}
+function createReducersFromManifest(manifest, reducerMap, defaultReducerKeys = []) {
+  var _a, _b, _c, _d, _e, _f;
+  const allKeys = Object.keys(reducerMap);
+  const getReducersForKeys = buildGetReducersForKeys(reducerMap);
+  const allRoutes = [];
+  for (const section of (_a = manifest.menuSections) != null ? _a : []) {
+    allRoutes.push(...(_b = section.items) != null ? _b : []);
+  }
+  allRoutes.push(...(_c = manifest.formRoutes) != null ? _c : []);
+  const derivedContextMap = {};
+  for (const route of allRoutes) {
+    if (!route.context) continue;
+    const routeReducers = (_d = route.reducers) != null ? _d : [];
+    const existing = (_e = derivedContextMap[route.context]) != null ? _e : [];
+    derivedContextMap[route.context] = [.../* @__PURE__ */ new Set([...existing, ...routeReducers])];
+  }
+  const mergedDefaults = [
+    .../* @__PURE__ */ new Set([...defaultReducerKeys, ...(_f = manifest.defaultReducers) != null ? _f : []])
+  ];
+  const getReducerKeysByContext = (context) => {
+    const contextKeys = derivedContextMap[context];
+    if (!contextKeys || contextKeys.length === 0) return allKeys;
+    return [.../* @__PURE__ */ new Set([...mergedDefaults, ...contextKeys])];
+  };
+  const getReducersForModule = async ({
+    context,
+    reducerKeys
+  } = {}) => {
+    if (reducerKeys && reducerKeys.length > 0) {
+      const keys2 = [.../* @__PURE__ */ new Set([...mergedDefaults, ...reducerKeys])];
+      return getReducersForKeys(keys2);
+    }
+    const keys = getReducerKeysByContext(context || "");
+    return getReducersForKeys(keys);
+  };
+  const loadAllReducers = () => getReducersForKeys(allKeys);
+  return {
+    getReducerKeysByContext,
+    getReducersForKeys,
+    getReducersForModule,
+    loadAllReducers,
+    baseReducers: {}
+  };
+}
 function createReducersBundle(config) {
   const { reducers, contextMap, defaults = [] } = config;
   const allKeys = Object.keys(reducers);
+  const getReducersForKeys = buildGetReducersForKeys(reducers);
   const getReducerKeysByContext = (context) => {
     const contextKeys = contextMap[context];
     if (!contextKeys) return allKeys;
     return [.../* @__PURE__ */ new Set([...defaults, ...contextKeys])];
   };
-  const getReducersForKeys = async (keys = []) => {
-    const uniqueKeys = [...new Set(keys)].filter((key) => !!reducers[key]);
-    const loaded = await Promise.all(
-      uniqueKeys.map(async (key) => {
-        const module2 = await reducers[key]();
-        return [key, module2.default || module2];
-      })
-    );
-    return Object.fromEntries(loaded);
-  };
   const getReducersForModule = async ({
     context
   } = {}) => {
@@ -215,20 +271,38 @@ function RtdbConfigWarning({ onDismiss }) {
     }
   );
 }
-function StandaloneProvider({ createController, addToast, firebaseConfig, emulator, tenant, children }) {
+function StandaloneProvider({
+  createController,
+  toast: toastProp,
+  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 }),
-      warning: (msg, opts) => addToast(msg, { appearance: "warning", autoDismiss: true, ...opts }),
-      error: (msg, opts) => addToast(msg, { appearance: "error", autoDismiss: true, ...opts }),
-      info: (msg, opts) => addToast(msg, { appearance: "info", autoDismiss: true, ...opts })
-    }),
-    [addToast]
-  );
+  const _envTenant = typeof process !== "undefined" ? process.env.REACT_APP_RTDB_TENANT : void 0;
+  const resolvedTenant = tenant || _envTenant || (process.env.NODE_ENV !== "production" ? "dev-local" : void 0);
+  const toast = (0, import_react3.useMemo)(() => {
+    if (toastProp) return toastProp;
+    if (addToast) {
+      return {
+        success: (msg, opts) => addToast(msg, { appearance: "success", autoDismiss: true, ...opts }),
+        warning: (msg, opts) => addToast(msg, { appearance: "warning", autoDismiss: true, ...opts }),
+        error: (msg, opts) => addToast(msg, { appearance: "error", autoDismiss: true, ...opts }),
+        info: (msg, opts) => addToast(msg, { appearance: "info", autoDismiss: true, ...opts })
+      };
+    }
+    const noop = (msg) => {
+      if (process.env.NODE_ENV !== "production") {
+        console.warn("[StandaloneProvider] Toast called but no toast/addToast prop provided:", msg);
+      }
+    };
+    return { success: noop, warning: noop, error: noop, info: noop };
+  }, [toastProp, addToast]);
   const subscribe = (0, import_react3.useCallback)(
     (mo) => {
       subscriptions.push(mo);
@@ -245,7 +319,16 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, emulat
     [subscriptions]
   );
   (0, import_react3.useEffect)(() => {
-    if (!tenant) return;
+    if (resolvedTenant || process.env.NODE_ENV === "production") return;
+    const timer = setTimeout(() => {
+      console.warn(
+        '[StandaloneProvider] RTDB listener deferred: tenant could not be resolved after 5 s.\nFix with any of:\n  \u2022 Pass `tenant` prop (e.g. from Redux state.global.companyId)\n  \u2022 Set REACT_APP_RTDB_TENANT=<companyId> in your .env\n  \u2022 Run in NODE_ENV=development (auto-falls back to "dev-local")'
+      );
+    }, 5e3);
+    return () => clearTimeout(timer);
+  }, [resolvedTenant]);
+  (0, import_react3.useEffect)(() => {
+    if (!resolvedTenant) return;
     let cleanup;
     let cancelled = false;
     (async () => {
@@ -288,7 +371,7 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, emulat
           const cloudApp = existingApp != null ? existingApp : initializeApp(strategy.config);
           db = getDatabase(cloudApp);
         }
-        const moRef = ref(db, `${tenant}/matchingObjects`);
+        const moRef = ref(db, `${resolvedTenant}/matchingObjects`);
         const unsub = onChildAdded(moRef, (snapshot) => {
           const data = snapshot.val();
           if (!data) return;
@@ -318,7 +401,7 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, emulat
       cancelled = true;
       cleanup == null ? void 0 : cleanup();
     };
-  }, [firebaseConfig, emulator, tenant]);
+  }, [firebaseConfig, emulator, resolvedTenant]);
   const value = (0, import_react3.useMemo)(
     () => ({
       createController,
@@ -332,7 +415,8 @@ function StandaloneProvider({ createController, addToast, firebaseConfig, emulat
       handleLogout: () => {
       },
       hostedByCore: false,
-      observability: new NullObservabilityAdapter()
+      observability: new NullObservabilityAdapter(),
+      rateLimits: {}
     }),
     [createController, toast, subscribe, unsubscribe]
   );
@@ -377,10 +461,99 @@ function DevAutoLogin({ actions, devUser, children }) {
   }, [dispatch, hostedByCore, token, actions, devUser]);
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_jsx_runtime3.Fragment, { children });
 }
+
+// src/federation/groupMenuSections.ts
+function groupMenuSections(manifests) {
+  var _a, _b, _c, _d, _e, _f, _g;
+  const groupMap = /* @__PURE__ */ new Map();
+  const topLevel = [];
+  for (const manifest of manifests) {
+    const fallbackGroup = manifest.menuGroup;
+    for (const section of (_a = manifest.menuSections) != null ? _a : []) {
+      const groupName = (_b = section.group) != null ? _b : fallbackGroup == null ? void 0 : fallbackGroup.name;
+      if (!groupName) {
+        topLevel.push({
+          key: `${manifest.name}:${section.label}`,
+          label: section.label,
+          icon: section.icon,
+          order: (_c = section.order) != null ? _c : 999,
+          children: section.items.map((item) => ({ kind: "item", item }))
+        });
+        continue;
+      }
+      let groupNode = groupMap.get(groupName);
+      if (!groupNode) {
+        groupNode = {
+          key: `group:${groupName}`,
+          label: groupName,
+          icon: (_d = fallbackGroup == null ? void 0 : fallbackGroup.icon) != null ? _d : section.icon,
+          order: (_f = (_e = fallbackGroup == null ? void 0 : fallbackGroup.order) != null ? _e : section.order) != null ? _f : 999,
+          children: []
+        };
+        groupMap.set(groupName, groupNode);
+      } else if (!groupNode.icon) {
+        const candidate = (_g = fallbackGroup == null ? void 0 : fallbackGroup.icon) != null ? _g : section.icon;
+        if (candidate) groupNode.icon = candidate;
+      }
+      if (section.flatten) {
+        for (const item of section.items) {
+          groupNode.children.push({ kind: "item", item, order: section.order });
+        }
+      } else {
+        const existing = groupNode.children.find(
+          (c) => c.kind === "section" && c.label === section.label
+        );
+        if (existing) {
+          existing.items = [...existing.items, ...section.items];
+          if (!existing.icon && section.icon) existing.icon = section.icon;
+          if (section.order != null && (existing.order == null || section.order < existing.order)) {
+            existing.order = section.order;
+          }
+        } else {
+          groupNode.children.push({
+            kind: "section",
+            label: section.label,
+            icon: section.icon,
+            items: [...section.items],
+            order: section.order
+          });
+        }
+      }
+    }
+  }
+  for (const node of groupMap.values()) {
+    node.children.sort((a, b) => {
+      var _a2, _b2, _c2, _d2;
+      const oa = (_a2 = a.order) != null ? _a2 : 999;
+      const ob = (_b2 = b.order) != null ? _b2 : 999;
+      if (oa !== ob) return oa - ob;
+      const la = a.kind === "section" ? a.label : (_c2 = a.item.label) != null ? _c2 : "";
+      const lb = b.kind === "section" ? b.label : (_d2 = b.item.label) != null ? _d2 : "";
+      return la.localeCompare(lb);
+    });
+    for (const child of node.children) {
+      if (child.kind === "section") {
+        child.items.sort((a, b) => {
+          var _a2, _b2, _c2, _d2;
+          const oa = (_a2 = a.order) != null ? _a2 : 999;
+          const ob = (_b2 = b.order) != null ? _b2 : 999;
+          if (oa !== ob) return oa - ob;
+          return ((_c2 = a.label) != null ? _c2 : "").localeCompare((_d2 = b.label) != null ? _d2 : "");
+        });
+      }
+    }
+  }
+  const all = [...topLevel, ...groupMap.values()];
+  all.sort((a, b) => a.order - b.order || a.label.localeCompare(b.label));
+  return all;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DevAutoLogin,
   FederatedBridge,
   StandaloneProvider,
-  createReducersBundle
+  createReducersBundle,
+  createReducersFromManifest,
+  groupMenuSections,
+  isHostedByCore
 });