@nardole/firebase-react 0.1.0

package/README.md

@@ -0,0 +1,113 @@
+# @nardole/firebase-react
+
+Elegant React bindings for @nardole/firebase-core. Provide the Firebase App via Context and access it anywhere with hooks. Works great in Micro‑Frontends thanks to the shared singleton under the hood.
+
+[![npm version](https://img.shields.io/npm/v/%40nardole%2Ffirebase-react.svg?logo=npm)](https://www.npmjs.com/package/@nardole/firebase-react)
+![types](https://img.shields.io/badge/types-TypeScript-blue?logo=typescript)
+[![license: MIT](https://img.shields.io/badge/license-MIT-green.svg)](#license)
+[![react](https://img.shields.io/badge/react-%3E%3D17-61dafb?logo=react&logoColor=white)](https://react.dev/)
+
+- Why
+- Features
+- Installation
+- Quick Start
+- Usage
+  - Provider
+  - Hook
+- Micro‑Frontend (MFE)
+- API
+- Compatibility
+- Troubleshooting
+- License
+
+## Why
+Managing Firebase initialization across multiple React apps or MFEs is error‑prone. This package provides a tiny Provider and Hook built on a shared singleton, ensuring exactly one Firebase instance.
+
+## Features
+- FirebaseAppProvider to initialize and provide the app via React Context
+- useFirebaseApp hook to access the current FirebaseApp instance
+- Designed for MFEs — initialize once (even outside React) and reuse everywhere
+
+## Installation
+- pnpm add @nardole/firebase-react @nardole/firebase-core firebase react react-dom
+- npm install @nardole/firebase-react @nardole/firebase-core firebase react react-dom
+- yarn add @nardole/firebase-react @nardole/firebase-core firebase react react-dom
+
+## Quick Start
+1. Wrap your application with the Provider using your Firebase options.
+2. Use the Hook in child components to access the shared instance.
+
+## Usage — Provider
+```tsx
+import { FirebaseAppProvider } from '@nardole/firebase-react';
+
+export function AppRoot() {
+  return (
+    <FirebaseAppProvider
+      options={{
+        apiKey: 'YOUR_API_KEY',
+        authDomain: 'YOUR_AUTH_DOMAIN',
+        projectId: 'YOUR_PROJECT_ID',
+        appId: 'YOUR_APP_ID',
+      }}
+    >
+      <YourApp />
+    </FirebaseAppProvider>
+  );
+}
+```
+
+## Usage — Hook
+```tsx
+import { useFirebaseApp } from '@nardole/firebase-react';
+
+export function AnyComponent() {
+  const app = useFirebaseApp();
+  // Use app with other firebase packages (auth, firestore, etc.)
+  return null;
+}
+```
+
+## Micro‑Frontend (MFE)
+Initialize the core service in the shell or any federated module, and React MFEs will reuse it.
+```ts
+// shell or any non-React mfe
+import { firebaseService } from '@nardole/firebase-core';
+firebaseService.init({ /* options */ });
+```
+```tsx
+// inside a React MFE
+import { FirebaseAppProvider, useFirebaseApp } from '@nardole/firebase-react';
+
+// Option A — wrap with the provider (reuses existing instance)
+<FirebaseAppProvider options={{ /* same options */ }}>
+  <YourApp />
+</FirebaseAppProvider>
+
+// Option B — if the provider isn’t available, you can still use the hook
+const app = useFirebaseApp();
+```
+
+## API
+
+| Item | Props/Signature | Description | Notes/Errors |
+| --- | --- | --- | --- |
+| FirebaseAppProvider | <FirebaseAppProvider options: FirebaseOptions, name?: string, enableAnalytics?: boolean, enablePerformance?: boolean, enableRemoteConfig?: boolean, enableStorage?: boolean, enableAuth?: boolean, enableDatabase?: boolean, enableFirestore?: boolean> | React Provider that initializes and provides Firebase App via Context. It can also pre-instantiate and expose optional Firebase services via Context. | Internally calls firebaseService.init(options, name, true) when options/name change. Optional services are only available in Context if their respective enable flags are true. |
+| useFirebaseApp | useFirebaseApp(): FirebaseApp | Hook to get the current FirebaseApp from Context. | Throws if used outside a FirebaseAppProvider: "Firebase app isn't found, did you forget to wrap your app in <FirebaseAppProvider>" |
+| useAnalytics | useAnalytics(): Analytics | Hook to access Analytics from Context. | Throws if Provider not present or enableAnalytics not set. |
+| usePerformance | usePerformance(): FirebasePerformance | Hook to access Performance from Context. | Throws if Provider not present or enablePerformance not set. |
+| useRemoteConfig | useRemoteConfig(): RemoteConfig | Hook to access Remote Config from Context. | Throws if Provider not present or enableRemoteConfig not set. |
+| useStorage | useStorage(): FirebaseStorage | Hook to access Storage from Context. | Throws if Provider not present or enableStorage not set. |
+| useAuth | useAuth(): Auth | Hook to access Auth from Context. | Throws if Provider not present or enableAuth not set. |
+| useDatabase | useDatabase(): Database | Hook to access Realtime Database from Context. | Throws if Provider not present or enableDatabase not set. |
+| useFirestore | useFirestore(): Firestore | Hook to access Firestore from Context. | Throws if Provider not present or enableFirestore not set. |
+
+## Compatibility
+- Peer: react >=17, react-dom >=17, firebase ^12, @nardole/firebase-core ^1
+
+## Troubleshooting
+- Seeing "Firebase app already initialized" warnings/errors?
+  - Ensure your MFEs share the same options and app name, or rely on the @nardole/firebase-core singleton. The Provider uses `override` to safely update when props change.
+
+## License
+MIT

package/dist/index.d.mts

@@ -0,0 +1,53 @@
+import * as _firebase_firestore from '@firebase/firestore';
+import * as _firebase_database from '@firebase/database';
+import * as _firebase_auth from '@firebase/auth';
+import * as _firebase_storage from '@firebase/storage';
+import * as _firebase_remote_config from '@firebase/remote-config';
+import * as _firebase_performance from '@firebase/performance';
+import * as _firebase_analytics from '@firebase/analytics';
+import * as _firebase_app from '@firebase/app';
+import React from 'react';
+import { FirebaseOptions, FirebaseApp } from 'firebase/app';
+import { Analytics } from 'firebase/analytics';
+import { FirebasePerformance } from 'firebase/performance';
+import { RemoteConfig } from 'firebase/remote-config';
+import { FirebaseStorage } from 'firebase/storage';
+import { Auth } from 'firebase/auth';
+import { Database } from 'firebase/database';
+import { Firestore } from 'firebase/firestore';
+
+declare function useFirebaseApp(): _firebase_app.FirebaseApp;
+declare function useAnalytics(): _firebase_analytics.Analytics;
+declare function usePerformance(): _firebase_performance.FirebasePerformance;
+declare function useRemoteConfig(): _firebase_remote_config.RemoteConfig;
+declare function useStorage(): _firebase_storage.FirebaseStorage;
+declare function useAuth(): _firebase_auth.Auth;
+declare function useDatabase(): _firebase_database.Database;
+declare function useFirestore(): _firebase_firestore.Firestore;
+
+type FirebaseAppProviderProps = React.PropsWithChildren<{
+    options: FirebaseOptions;
+    name?: string;
+    enableAnalytics?: boolean;
+    enablePerformance?: boolean;
+    enableRemoteConfig?: boolean;
+    enableStorage?: boolean;
+    enableAuth?: boolean;
+    enableDatabase?: boolean;
+    enableFirestore?: boolean;
+}>;
+declare function FirebaseAppProvider({ options, name, enableAnalytics, enablePerformance, enableRemoteConfig, enableStorage, enableAuth, enableDatabase, enableFirestore, children, }: FirebaseAppProviderProps): React.JSX.Element;
+
+type FirebaseAppContextValue = {
+    app: FirebaseApp;
+    analytics?: Analytics;
+    performance?: FirebasePerformance;
+    remoteConfig?: RemoteConfig;
+    storage?: FirebaseStorage;
+    auth?: Auth;
+    database?: Database;
+    firestore?: Firestore;
+};
+declare const FirebaseAppContext: React.Context<FirebaseAppContextValue | undefined>;
+
+export { FirebaseAppContext, type FirebaseAppContextValue, FirebaseAppProvider, type FirebaseAppProviderProps, useAnalytics, useAuth, useDatabase, useFirebaseApp, useFirestore, usePerformance, useRemoteConfig, useStorage };

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import * as _firebase_firestore from '@firebase/firestore';
+import * as _firebase_database from '@firebase/database';
+import * as _firebase_auth from '@firebase/auth';
+import * as _firebase_storage from '@firebase/storage';
+import * as _firebase_remote_config from '@firebase/remote-config';
+import * as _firebase_performance from '@firebase/performance';
+import * as _firebase_analytics from '@firebase/analytics';
+import * as _firebase_app from '@firebase/app';
+import React from 'react';
+import { FirebaseOptions, FirebaseApp } from 'firebase/app';
+import { Analytics } from 'firebase/analytics';
+import { FirebasePerformance } from 'firebase/performance';
+import { RemoteConfig } from 'firebase/remote-config';
+import { FirebaseStorage } from 'firebase/storage';
+import { Auth } from 'firebase/auth';
+import { Database } from 'firebase/database';
+import { Firestore } from 'firebase/firestore';
+
+declare function useFirebaseApp(): _firebase_app.FirebaseApp;
+declare function useAnalytics(): _firebase_analytics.Analytics;
+declare function usePerformance(): _firebase_performance.FirebasePerformance;
+declare function useRemoteConfig(): _firebase_remote_config.RemoteConfig;
+declare function useStorage(): _firebase_storage.FirebaseStorage;
+declare function useAuth(): _firebase_auth.Auth;
+declare function useDatabase(): _firebase_database.Database;
+declare function useFirestore(): _firebase_firestore.Firestore;
+
+type FirebaseAppProviderProps = React.PropsWithChildren<{
+    options: FirebaseOptions;
+    name?: string;
+    enableAnalytics?: boolean;
+    enablePerformance?: boolean;
+    enableRemoteConfig?: boolean;
+    enableStorage?: boolean;
+    enableAuth?: boolean;
+    enableDatabase?: boolean;
+    enableFirestore?: boolean;
+}>;
+declare function FirebaseAppProvider({ options, name, enableAnalytics, enablePerformance, enableRemoteConfig, enableStorage, enableAuth, enableDatabase, enableFirestore, children, }: FirebaseAppProviderProps): React.JSX.Element;
+
+type FirebaseAppContextValue = {
+    app: FirebaseApp;
+    analytics?: Analytics;
+    performance?: FirebasePerformance;
+    remoteConfig?: RemoteConfig;
+    storage?: FirebaseStorage;
+    auth?: Auth;
+    database?: Database;
+    firestore?: Firestore;
+};
+declare const FirebaseAppContext: React.Context<FirebaseAppContextValue | undefined>;
+
+export { FirebaseAppContext, type FirebaseAppContextValue, FirebaseAppProvider, type FirebaseAppProviderProps, useAnalytics, useAuth, useDatabase, useFirebaseApp, useFirestore, usePerformance, useRemoteConfig, useStorage };

package/dist/index.js

@@ -0,0 +1,131 @@
+'use strict';
+
+var React2 = require('react');
+var firebaseCore = require('@nardole/firebase-core');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React2__default = /*#__PURE__*/_interopDefault(React2);
+
+// src/hooks/index.ts
+var FirebaseAppContext = React2__default.default.createContext(void 0);
+
+// src/hooks/index.ts
+function useFirebaseApp() {
+  const value = React2.useContext(FirebaseAppContext);
+  if (!value || value.app === void 0) {
+    throw new Error(
+      "Firebase app isn't found, did you forget to wrap your app in <FirebaseAppProvider>"
+    );
+  }
+  return value.app;
+}
+function useAnalytics() {
+  const value = React2.useContext(FirebaseAppContext);
+  if (!value || value.analytics === void 0) {
+    throw new Error(
+      "Firebase analytics isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.analytics;
+}
+function usePerformance() {
+  const value = React2.useContext(FirebaseAppContext);
+  if (!value || value.performance === void 0) {
+    throw new Error(
+      "Firebase performance isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.performance;
+}
+function useRemoteConfig() {
+  const value = React2.useContext(FirebaseAppContext);
+  if (!value || value.remoteConfig === void 0) {
+    throw new Error(
+      "Firebase remote config isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.remoteConfig;
+}
+function useStorage() {
+  const value = React2.useContext(FirebaseAppContext);
+  if (!value || value.storage === void 0) {
+    throw new Error(
+      "Firebase storage isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.storage;
+}
+function useAuth() {
+  const value = React2.useContext(FirebaseAppContext);
+  if (!value || value.auth === void 0) {
+    throw new Error(
+      "Firebase auth isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.auth;
+}
+function useDatabase() {
+  const value = React2.useContext(FirebaseAppContext);
+  if (!value || value.database === void 0) {
+    throw new Error(
+      "Firebase database isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.database;
+}
+function useFirestore() {
+  const value = React2.useContext(FirebaseAppContext);
+  if (!value || value.firestore === void 0) {
+    throw new Error(
+      "Firebase firestore isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.firestore;
+}
+function FirebaseAppProvider({
+  options,
+  name,
+  enableAnalytics,
+  enablePerformance,
+  enableRemoteConfig,
+  enableStorage,
+  enableAuth,
+  enableDatabase,
+  enableFirestore,
+  children
+}) {
+  const optionsRef = React2__default.default.useRef(void 0);
+  const nameRef = React2__default.default.useRef(void 0);
+  const value = React2__default.default.useMemo(() => {
+    if (optionsRef.current !== options || nameRef.current !== name) {
+      firebaseCore.firebaseService.init(options, name, true);
+    }
+    optionsRef.current = options;
+    nameRef.current = name;
+    return {
+      app: firebaseCore.firebaseService.app,
+      analytics: enableAnalytics ? firebaseCore.firebaseService.analytics : void 0,
+      performance: enablePerformance ? firebaseCore.firebaseService.performance : void 0,
+      remoteConfig: enableRemoteConfig ? firebaseCore.firebaseService.remoteConfig : void 0,
+      storage: enableStorage ? firebaseCore.firebaseService.storage : void 0,
+      auth: enableAuth ? firebaseCore.firebaseService.auth : void 0,
+      database: enableDatabase ? firebaseCore.firebaseService.database : void 0,
+      firestore: enableFirestore ? firebaseCore.firebaseService.firestore : void 0
+    };
+  }, [options, name]);
+  return /* @__PURE__ */ React2__default.default.createElement(FirebaseAppContext.Provider, { value }, children);
+}
+
+exports.FirebaseAppContext = FirebaseAppContext;
+exports.FirebaseAppProvider = FirebaseAppProvider;
+exports.useAnalytics = useAnalytics;
+exports.useAuth = useAuth;
+exports.useDatabase = useDatabase;
+exports.useFirebaseApp = useFirebaseApp;
+exports.useFirestore = useFirestore;
+exports.usePerformance = usePerformance;
+exports.useRemoteConfig = useRemoteConfig;
+exports.useStorage = useStorage;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context/index.ts","../src/hooks/index.ts","../src/provider/index.tsx"],"names":["React","useContext","firebaseService"],"mappings":";;;;;;;;;;AAqBO,IAAM,kBAAA,GAAqBA,uBAAA,CAAM,aAAA,CAEtC,MAAS;;;ACpBJ,SAAS,cAAA,GAAiB;AAC/B,EAAA,MAAM,KAAA,GAAQC,kBAAW,kBAAkB,CAAA;AAE3C,EAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,GAAA,KAAQ,MAAA,EAAW;AACrC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA,CAAM,GAAA;AACf;AAEO,SAAS,YAAA,GAAe;AAC7B,EAAA,MAAM,KAAA,GAAQA,kBAAW,kBAAkB,CAAA;AAE3C,EAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,SAAA,KAAc,MAAA,EAAW;AAC3C,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA,CAAM,SAAA;AACf;AAEO,SAAS,cAAA,GAAiB;AAC/B,EAAA,MAAM,KAAA,GAAQA,kBAAW,kBAAkB,CAAA;AAE3C,EAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,WAAA,KAAgB,MAAA,EAAW;AAC7C,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA,CAAM,WAAA;AACf;AAEO,SAAS,eAAA,GAAkB;AAChC,EAAA,MAAM,KAAA,GAAQA,kBAAW,kBAAkB,CAAA;AAE3C,EAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,YAAA,KAAiB,MAAA,EAAW;AAC9C,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA,CAAM,YAAA;AACf;AAEO,SAAS,UAAA,GAAa;AAC3B,EAAA,MAAM,KAAA,GAAQA,kBAAW,kBAAkB,CAAA;AAE3C,EAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,OAAA,KAAY,MAAA,EAAW;AACzC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA,CAAM,OAAA;AACf;AAEO,SAAS,OAAA,GAAU;AACxB,EAAA,MAAM,KAAA,GAAQA,kBAAW,kBAAkB,CAAA;AAE3C,EAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,IAAA,KAAS,MAAA,EAAW;AACtC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA,CAAM,IAAA;AACf;AAEO,SAAS,WAAA,GAAc;AAC5B,EAAA,MAAM,KAAA,GAAQA,kBAAW,kBAAkB,CAAA;AAE3C,EAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,QAAA,KAAa,MAAA,EAAW;AAC1C,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA,CAAM,QAAA;AACf;AAEO,SAAS,YAAA,GAAe;AAC7B,EAAA,MAAM,KAAA,GAAQA,kBAAW,kBAAkB,CAAA;AAE3C,EAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,SAAA,KAAc,MAAA,EAAW;AAC3C,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA,CAAM,SAAA;AACf;AC5EO,SAAS,mBAAA,CAAoB;AAAA,EAClC,OAAA;AAAA,EACA,IAAA;AAAA,EACA,eAAA;AAAA,EACA,iBAAA;AAAA,EACA,kBAAA;AAAA,EACA,aAAA;AAAA,EACA,UAAA;AAAA,EACA,cAAA;AAAA,EACA,eAAA;AAAA,EACA;AACF,CAAA,EAA6B;AAC3B,EAAA,MAAM,UAAA,GAAaD,uBAAAA,CAAM,MAAA,CAAoC,MAAS,CAAA;AACtE,EAAA,MAAM,OAAA,GAAUA,uBAAAA,CAAM,MAAA,CAA2B,MAAS,CAAA;AAE1D,EAAA,MAAM,KAAA,GAAiCA,uBAAAA,CAAM,OAAA,CAAQ,MAAM;AACzD,IAAA,IAAI,UAAA,CAAW,OAAA,KAAY,OAAA,IAAW,OAAA,CAAQ,YAAY,IAAA,EAAM;AAC9D,MAAAE,4BAAA,CAAgB,IAAA,CAAK,OAAA,EAAS,IAAA,EAAM,IAAI,CAAA;AAAA,IAC1C;AAEA,IAAA,UAAA,CAAW,OAAA,GAAU,OAAA;AACrB,IAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAElB,IAAA,OAAO;AAAA,MACL,KAAKA,4BAAA,CAAgB,GAAA;AAAA,MACrB,SAAA,EAAW,eAAA,GAAkBA,4BAAA,CAAgB,SAAA,GAAY,MAAA;AAAA,MACzD,WAAA,EAAa,iBAAA,GAAoBA,4BAAA,CAAgB,WAAA,GAAc,MAAA;AAAA,MAC/D,YAAA,EAAc,kBAAA,GACVA,4BAAA,CAAgB,YAAA,GAChB,MAAA;AAAA,MACJ,OAAA,EAAS,aAAA,GAAgBA,4BAAA,CAAgB,OAAA,GAAU,MAAA;AAAA,MACnD,IAAA,EAAM,UAAA,GAAaA,4BAAA,CAAgB,IAAA,GAAO,MAAA;AAAA,MAC1C,QAAA,EAAU,cAAA,GAAiBA,4BAAA,CAAgB,QAAA,GAAW,MAAA;AAAA,MACtD,SAAA,EAAW,eAAA,GAAkBA,4BAAA,CAAgB,SAAA,GAAY;AAAA,KAC3D;AAAA,EACF,CAAA,EAAG,CAAC,OAAA,EAAS,IAAI,CAAC,CAAA;AAElB,EAAA,uBACEF,uBAAAA,CAAA,aAAA,CAAC,mBAAmB,QAAA,EAAnB,EAA4B,SAC1B,QACH,CAAA;AAEJ","file":"index.js","sourcesContent":["import React from \"react\";\nimport { FirebaseApp } from \"firebase/app\";\nimport { Analytics } from \"firebase/analytics\";\nimport { FirebasePerformance } from \"firebase/performance\";\nimport { RemoteConfig } from \"firebase/remote-config\";\nimport { FirebaseStorage } from \"firebase/storage\";\nimport { Auth } from \"firebase/auth\";\nimport { Database } from \"firebase/database\";\nimport { Firestore } from \"firebase/firestore\";\n\nexport type FirebaseAppContextValue = {\n  app: FirebaseApp;\n  analytics?: Analytics;\n  performance?: FirebasePerformance;\n  remoteConfig?: RemoteConfig;\n  storage?: FirebaseStorage;\n  auth?: Auth;\n  database?: Database;\n  firestore?: Firestore;\n};\n\nexport const FirebaseAppContext = React.createContext<\n  FirebaseAppContextValue | undefined\n>(undefined);\n","import { useContext } from \"react\";\nimport { FirebaseAppContext } from \"@nardole/firebase-react/context\";\n\nexport function useFirebaseApp() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.app === undefined) {\n    throw new Error(\n      \"Firebase app isn't found, did you forget to wrap your app in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.app;\n}\n\nexport function useAnalytics() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.analytics === undefined) {\n    throw new Error(\n      \"Firebase analytics isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.analytics;\n}\n\nexport function usePerformance() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.performance === undefined) {\n    throw new Error(\n      \"Firebase performance isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.performance;\n}\n\nexport function useRemoteConfig() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.remoteConfig === undefined) {\n    throw new Error(\n      \"Firebase remote config isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.remoteConfig;\n}\n\nexport function useStorage() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.storage === undefined) {\n    throw new Error(\n      \"Firebase storage isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.storage;\n}\n\nexport function useAuth() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.auth === undefined) {\n    throw new Error(\n      \"Firebase auth isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.auth;\n}\n\nexport function useDatabase() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.database === undefined) {\n    throw new Error(\n      \"Firebase database isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.database;\n}\n\nexport function useFirestore() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.firestore === undefined) {\n    throw new Error(\n      \"Firebase firestore isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.firestore;\n}\n","import React from \"react\";\nimport { FirebaseOptions } from \"firebase/app\";\nimport {\n  FirebaseAppContext,\n  FirebaseAppContextValue,\n} from \"@nardole/firebase-react/context\";\nimport { firebaseService } from \"@nardole/firebase-core\";\n\nexport type FirebaseAppProviderProps = React.PropsWithChildren<{\n  options: FirebaseOptions;\n  name?: string;\n\n  enableAnalytics?: boolean;\n  enablePerformance?: boolean;\n  enableRemoteConfig?: boolean;\n  enableStorage?: boolean;\n  enableAuth?: boolean;\n  enableDatabase?: boolean;\n  enableFirestore?: boolean;\n}>;\n\nexport function FirebaseAppProvider({\n  options,\n  name,\n  enableAnalytics,\n  enablePerformance,\n  enableRemoteConfig,\n  enableStorage,\n  enableAuth,\n  enableDatabase,\n  enableFirestore,\n  children,\n}: FirebaseAppProviderProps) {\n  const optionsRef = React.useRef<FirebaseOptions | undefined>(undefined);\n  const nameRef = React.useRef<string | undefined>(undefined);\n\n  const value: FirebaseAppContextValue = React.useMemo(() => {\n    if (optionsRef.current !== options || nameRef.current !== name) {\n      firebaseService.init(options, name, true);\n    }\n\n    optionsRef.current = options;\n    nameRef.current = name;\n\n    return {\n      app: firebaseService.app,\n      analytics: enableAnalytics ? firebaseService.analytics : undefined,\n      performance: enablePerformance ? firebaseService.performance : undefined,\n      remoteConfig: enableRemoteConfig\n        ? firebaseService.remoteConfig\n        : undefined,\n      storage: enableStorage ? firebaseService.storage : undefined,\n      auth: enableAuth ? firebaseService.auth : undefined,\n      database: enableDatabase ? firebaseService.database : undefined,\n      firestore: enableFirestore ? firebaseService.firestore : undefined,\n    };\n  }, [options, name]);\n\n  return (\n    <FirebaseAppContext.Provider value={value}>\n      {children}\n    </FirebaseAppContext.Provider>\n  );\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,116 @@
+import React2, { useContext } from 'react';
+import { firebaseService } from '@nardole/firebase-core';
+
+// src/hooks/index.ts
+var FirebaseAppContext = React2.createContext(void 0);
+
+// src/hooks/index.ts
+function useFirebaseApp() {
+  const value = useContext(FirebaseAppContext);
+  if (!value || value.app === void 0) {
+    throw new Error(
+      "Firebase app isn't found, did you forget to wrap your app in <FirebaseAppProvider>"
+    );
+  }
+  return value.app;
+}
+function useAnalytics() {
+  const value = useContext(FirebaseAppContext);
+  if (!value || value.analytics === void 0) {
+    throw new Error(
+      "Firebase analytics isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.analytics;
+}
+function usePerformance() {
+  const value = useContext(FirebaseAppContext);
+  if (!value || value.performance === void 0) {
+    throw new Error(
+      "Firebase performance isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.performance;
+}
+function useRemoteConfig() {
+  const value = useContext(FirebaseAppContext);
+  if (!value || value.remoteConfig === void 0) {
+    throw new Error(
+      "Firebase remote config isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.remoteConfig;
+}
+function useStorage() {
+  const value = useContext(FirebaseAppContext);
+  if (!value || value.storage === void 0) {
+    throw new Error(
+      "Firebase storage isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.storage;
+}
+function useAuth() {
+  const value = useContext(FirebaseAppContext);
+  if (!value || value.auth === void 0) {
+    throw new Error(
+      "Firebase auth isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.auth;
+}
+function useDatabase() {
+  const value = useContext(FirebaseAppContext);
+  if (!value || value.database === void 0) {
+    throw new Error(
+      "Firebase database isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.database;
+}
+function useFirestore() {
+  const value = useContext(FirebaseAppContext);
+  if (!value || value.firestore === void 0) {
+    throw new Error(
+      "Firebase firestore isn't found, did you forget to enable it in <FirebaseAppProvider>"
+    );
+  }
+  return value.firestore;
+}
+function FirebaseAppProvider({
+  options,
+  name,
+  enableAnalytics,
+  enablePerformance,
+  enableRemoteConfig,
+  enableStorage,
+  enableAuth,
+  enableDatabase,
+  enableFirestore,
+  children
+}) {
+  const optionsRef = React2.useRef(void 0);
+  const nameRef = React2.useRef(void 0);
+  const value = React2.useMemo(() => {
+    if (optionsRef.current !== options || nameRef.current !== name) {
+      firebaseService.init(options, name, true);
+    }
+    optionsRef.current = options;
+    nameRef.current = name;
+    return {
+      app: firebaseService.app,
+      analytics: enableAnalytics ? firebaseService.analytics : void 0,
+      performance: enablePerformance ? firebaseService.performance : void 0,
+      remoteConfig: enableRemoteConfig ? firebaseService.remoteConfig : void 0,
+      storage: enableStorage ? firebaseService.storage : void 0,
+      auth: enableAuth ? firebaseService.auth : void 0,
+      database: enableDatabase ? firebaseService.database : void 0,
+      firestore: enableFirestore ? firebaseService.firestore : void 0
+    };
+  }, [options, name]);
+  return /* @__PURE__ */ React2.createElement(FirebaseAppContext.Provider, { value }, children);
+}
+
+export { FirebaseAppContext, FirebaseAppProvider, useAnalytics, useAuth, useDatabase, useFirebaseApp, useFirestore, usePerformance, useRemoteConfig, useStorage };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context/index.ts","../src/hooks/index.ts","../src/provider/index.tsx"],"names":["React"],"mappings":"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","file":"index.mjs","sourcesContent":["import React from \"react\";\nimport { FirebaseApp } from \"firebase/app\";\nimport { Analytics } from \"firebase/analytics\";\nimport { FirebasePerformance } from \"firebase/performance\";\nimport { RemoteConfig } from \"firebase/remote-config\";\nimport { FirebaseStorage } from \"firebase/storage\";\nimport { Auth } from \"firebase/auth\";\nimport { Database } from \"firebase/database\";\nimport { Firestore } from \"firebase/firestore\";\n\nexport type FirebaseAppContextValue = {\n  app: FirebaseApp;\n  analytics?: Analytics;\n  performance?: FirebasePerformance;\n  remoteConfig?: RemoteConfig;\n  storage?: FirebaseStorage;\n  auth?: Auth;\n  database?: Database;\n  firestore?: Firestore;\n};\n\nexport const FirebaseAppContext = React.createContext<\n  FirebaseAppContextValue | undefined\n>(undefined);\n","import { useContext } from \"react\";\nimport { FirebaseAppContext } from \"@nardole/firebase-react/context\";\n\nexport function useFirebaseApp() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.app === undefined) {\n    throw new Error(\n      \"Firebase app isn't found, did you forget to wrap your app in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.app;\n}\n\nexport function useAnalytics() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.analytics === undefined) {\n    throw new Error(\n      \"Firebase analytics isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.analytics;\n}\n\nexport function usePerformance() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.performance === undefined) {\n    throw new Error(\n      \"Firebase performance isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.performance;\n}\n\nexport function useRemoteConfig() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.remoteConfig === undefined) {\n    throw new Error(\n      \"Firebase remote config isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.remoteConfig;\n}\n\nexport function useStorage() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.storage === undefined) {\n    throw new Error(\n      \"Firebase storage isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.storage;\n}\n\nexport function useAuth() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.auth === undefined) {\n    throw new Error(\n      \"Firebase auth isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.auth;\n}\n\nexport function useDatabase() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.database === undefined) {\n    throw new Error(\n      \"Firebase database isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.database;\n}\n\nexport function useFirestore() {\n  const value = useContext(FirebaseAppContext);\n\n  if (!value || value.firestore === undefined) {\n    throw new Error(\n      \"Firebase firestore isn't found, did you forget to enable it in <FirebaseAppProvider>\",\n    );\n  }\n\n  return value.firestore;\n}\n","import React from \"react\";\nimport { FirebaseOptions } from \"firebase/app\";\nimport {\n  FirebaseAppContext,\n  FirebaseAppContextValue,\n} from \"@nardole/firebase-react/context\";\nimport { firebaseService } from \"@nardole/firebase-core\";\n\nexport type FirebaseAppProviderProps = React.PropsWithChildren<{\n  options: FirebaseOptions;\n  name?: string;\n\n  enableAnalytics?: boolean;\n  enablePerformance?: boolean;\n  enableRemoteConfig?: boolean;\n  enableStorage?: boolean;\n  enableAuth?: boolean;\n  enableDatabase?: boolean;\n  enableFirestore?: boolean;\n}>;\n\nexport function FirebaseAppProvider({\n  options,\n  name,\n  enableAnalytics,\n  enablePerformance,\n  enableRemoteConfig,\n  enableStorage,\n  enableAuth,\n  enableDatabase,\n  enableFirestore,\n  children,\n}: FirebaseAppProviderProps) {\n  const optionsRef = React.useRef<FirebaseOptions | undefined>(undefined);\n  const nameRef = React.useRef<string | undefined>(undefined);\n\n  const value: FirebaseAppContextValue = React.useMemo(() => {\n    if (optionsRef.current !== options || nameRef.current !== name) {\n      firebaseService.init(options, name, true);\n    }\n\n    optionsRef.current = options;\n    nameRef.current = name;\n\n    return {\n      app: firebaseService.app,\n      analytics: enableAnalytics ? firebaseService.analytics : undefined,\n      performance: enablePerformance ? firebaseService.performance : undefined,\n      remoteConfig: enableRemoteConfig\n        ? firebaseService.remoteConfig\n        : undefined,\n      storage: enableStorage ? firebaseService.storage : undefined,\n      auth: enableAuth ? firebaseService.auth : undefined,\n      database: enableDatabase ? firebaseService.database : undefined,\n      firestore: enableFirestore ? firebaseService.firestore : undefined,\n    };\n  }, [options, name]);\n\n  return (\n    <FirebaseAppContext.Provider value={value}>\n      {children}\n    </FirebaseAppContext.Provider>\n  );\n}\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@nardole/firebase-react",
+  "version": "0.1.0",
+  "private": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "author": {
+    "name": "Luiz Braga",
+    "email": "me@nardole.dev"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/btmluiz/nardole-firebase",
+    "directory": "packages/react"
+  },
+  "devDependencies": {
+    "@types/react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+    "@types/react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+    "firebase": "^12.2.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "@nardole/firebase-core": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+    "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+    "@nardole/firebase-core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc"
+  },
+  "keywords": [
+    "firebase",
+    "react",
+    "context",
+    "hooks",
+    "provider",
+    "analytics",
+    "performance",
+    "remote-config",
+    "storage",
+    "auth",
+    "database",
+    "firestore",
+    "micro-frontend",
+    "mfe",
+    "typescript"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE*"
+  ]
+}