@codefire/firebase-react 1.0.1

package/README.md

@@ -0,0 +1,111 @@
+# @codefire/firebase-react
+
+Plug-and-play Firebase utilities for Firestore and Storage in React and other frontend projects.
+
+## Installation
+
+```bash
+npm install @codefire/firebase-react firebase
+```
+
+`firebase` is a peer dependency; your project controls the version.
+
+## Setup
+
+Initialize Firebase once (e.g. in your app entry or root layout):
+
+```ts
+import { initFirebase } from "@codefire/firebase-react";
+
+initFirebase({
+  apiKey: "your-api-key",
+  authDomain: "your-project.firebaseapp.com",
+  projectId: "your-project-id",
+  storageBucket: "your-project.appspot.com",
+  messagingSenderId: "...",
+  appId: "...",
+});
+```
+
+## Firestore
+
+Import from the main package or the firestore subpath:
+
+```ts
+import {
+  addDocument,
+  getDocument,
+  setDocument,
+  updateDocument,
+  deleteDocument,
+  queryCollection,
+  getDb,
+  serverTimestamp,
+  where,
+  orderBy,
+  limit,
+} from "@codefire/firebase-react/firestore";
+```
+
+### API
+
+| Function | Description |
+|----------|-------------|
+| `getDb()` | Returns the Firestore instance (call after `initFirebase`). |
+| `addDocument(collectionName, data)` | Creates a document with auto-generated ID. Adds `createdAt`. Returns document ID. |
+| `setDocument(collectionName, docId, data)` | Creates or overwrites a document with the given ID. Sets `updatedAt`. |
+| `updateDocument(collectionName, docId, data)` | Updates existing document fields. Sets `updatedAt`. |
+| `deleteDocument(collectionName, docId)` | Deletes a document. |
+| `getDocument(collectionName, docId)` | Fetches a document by ID. Returns `null` if not found. Result includes `id`. |
+| `queryCollection(collectionName, constraints?)` | Fetches documents with optional `where`, `orderBy`, `limit`. Results include `id`. |
+
+Helpers `serverTimestamp`, `where`, `orderBy`, `limit` are re-exported from Firebase for building queries.
+
+### Example
+
+```ts
+const id = await addDocument("waitlist", { email: "a@b.com", city: "Santiago" });
+
+const items = await queryCollection("services", [
+  where("active", "==", true),
+  orderBy("order", "asc"),
+  limit(10),
+]);
+```
+
+## Storage
+
+```ts
+import { uploadFile, deleteFile, getFileUrl } from "@codefire/firebase-react/storage";
+```
+
+### API
+
+| Function | Description |
+|----------|-------------|
+| `uploadFile(file, options?)` | Uploads a file. Options: `folder`, `fileName`, `onProgress(percent)`. Returns `{ url, path }`. |
+| `deleteFile(path)` | Deletes a file by path. |
+| `getFileUrl(path)` | Returns the public download URL for a path. |
+
+### Example
+
+```ts
+const { url, path } = await uploadFile(file, {
+  folder: "profiles",
+  onProgress: (p) => console.log(`${p}%`),
+});
+```
+
+## Subpath imports
+
+To avoid pulling in unused code:
+
+- `@codefire/firebase-react` — core + firestore + storage
+- `@codefire/firebase-react/firestore` — Firestore only
+- `@codefire/firebase-react/storage` — Storage only
+
+You still need to call `initFirebase()` from the main package once before using Firestore or Storage.
+
+## License
+
+MIT

package/dist/firestore/index.cjs

@@ -0,0 +1,112 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/firestore/index.ts
+var firestore_exports = {};
+__export(firestore_exports, {
+  addDocument: () => addDocument,
+  deleteDocument: () => deleteDocument,
+  getDb: () => getDb,
+  getDocument: () => getDocument,
+  limit: () => import_firestore.limit,
+  orderBy: () => import_firestore.orderBy,
+  queryCollection: () => queryCollection,
+  serverTimestamp: () => import_firestore.serverTimestamp,
+  setDocument: () => setDocument,
+  updateDocument: () => updateDocument,
+  where: () => import_firestore.where
+});
+module.exports = __toCommonJS(firestore_exports);
+var import_firestore = require("firebase/firestore");
+
+// src/core.ts
+var import_app = require("firebase/app");
+var app = null;
+function getFirebaseApp() {
+  if (!app) {
+    throw new Error(
+      "@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage."
+    );
+  }
+  return app;
+}
+
+// src/firestore/index.ts
+function getDb() {
+  return (0, import_firestore.getFirestore)(getFirebaseApp());
+}
+async function addDocument(collectionName, data) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  const ref = await (0, import_firestore.addDoc)((0, import_firestore.collection)(firestore, collectionName), {
+    ...data,
+    createdAt: (0, import_firestore.serverTimestamp)()
+  });
+  return ref.id;
+}
+async function setDocument(collectionName, docId, data) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  await (0, import_firestore.setDoc)((0, import_firestore.doc)(firestore, collectionName, docId), {
+    ...data,
+    updatedAt: (0, import_firestore.serverTimestamp)()
+  });
+}
+async function updateDocument(collectionName, docId, data) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  await (0, import_firestore.updateDoc)((0, import_firestore.doc)(firestore, collectionName, docId), {
+    ...data,
+    updatedAt: (0, import_firestore.serverTimestamp)()
+  });
+}
+async function deleteDocument(collectionName, docId) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  await (0, import_firestore.deleteDoc)((0, import_firestore.doc)(firestore, collectionName, docId));
+}
+async function getDocument(collectionName, docId) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  const snap = await (0, import_firestore.getDoc)((0, import_firestore.doc)(firestore, collectionName, docId));
+  if (!snap.exists()) return null;
+  return { id: snap.id, ...snap.data() };
+}
+async function queryCollection(collectionName, constraints = []) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  const q = (0, import_firestore.query)((0, import_firestore.collection)(firestore, collectionName), ...constraints);
+  const snap = await (0, import_firestore.getDocs)(q);
+  return snap.docs.map((d) => ({ id: d.id, ...d.data() }));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addDocument,
+  deleteDocument,
+  getDb,
+  getDocument,
+  limit,
+  orderBy,
+  queryCollection,
+  serverTimestamp,
+  setDocument,
+  updateDocument,
+  where
+});
+//# sourceMappingURL=index.cjs.map

package/dist/firestore/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/firestore/index.ts","../../src/core.ts"],"sourcesContent":["import {\n  getFirestore,\n  collection,\n  doc,\n  addDoc,\n  setDoc,\n  updateDoc,\n  deleteDoc,\n  getDoc,\n  getDocs,\n  query,\n  where,\n  orderBy,\n  limit,\n  serverTimestamp,\n  type DocumentData,\n  type QueryConstraint,\n  type WithFieldValue,\n  type UpdateData,\n  type Firestore,\n} from \"firebase/firestore\";\nimport { getFirebaseApp } from \"../core\";\n\nexport function getDb(): Firestore {\n  return getFirestore(getFirebaseApp());\n}\n\nexport { serverTimestamp, where, orderBy, limit };\n\nexport async function addDocument<T extends WithFieldValue<DocumentData>>(\n  collectionName: string,\n  data: T\n): Promise<string> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const ref = await addDoc(collection(firestore, collectionName), {\n    ...data,\n    createdAt: serverTimestamp(),\n  });\n  return ref.id;\n}\n\nexport async function setDocument<T extends WithFieldValue<DocumentData>>(\n  collectionName: string,\n  docId: string,\n  data: T\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await setDoc(doc(firestore, collectionName, docId), {\n    ...data,\n    updatedAt: serverTimestamp(),\n  });\n}\n\nexport async function updateDocument<T extends DocumentData>(\n  collectionName: string,\n  docId: string,\n  data: UpdateData<T>\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await updateDoc(doc(firestore, collectionName, docId), {\n    ...data,\n    updatedAt: serverTimestamp(),\n  });\n}\n\nexport async function deleteDocument(\n  collectionName: string,\n  docId: string\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await deleteDoc(doc(firestore, collectionName, docId));\n}\n\nexport async function getDocument<T = DocumentData>(\n  collectionName: string,\n  docId: string\n): Promise<(T & { id: string }) | null> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const snap = await getDoc(doc(firestore, collectionName, docId));\n  if (!snap.exists()) return null;\n  return { id: snap.id, ...(snap.data() as T) };\n}\n\nexport async function queryCollection<T = DocumentData>(\n  collectionName: string,\n  constraints: QueryConstraint[] = []\n): Promise<(T & { id: string })[]> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const q = query(collection(firestore, collectionName), ...constraints);\n  const snap = await getDocs(q);\n  return snap.docs.map((d) => ({ id: d.id, ...(d.data() as T) }));\n}\n","import {\n  initializeApp,\n  getApps,\n  getApp,\n  type FirebaseApp,\n  type FirebaseOptions,\n} from \"firebase/app\";\n\nlet app: FirebaseApp | null = null;\n\nexport function initFirebase(config: FirebaseOptions): FirebaseApp {\n  if (getApps().length > 0) {\n    app = getApp();\n    return app;\n  }\n  app = initializeApp(config);\n  return app;\n}\n\nexport function getFirebaseApp(): FirebaseApp {\n  if (!app) {\n    throw new Error(\n      \"@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage.\"\n    );\n  }\n  return app;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAoBO;;;ACpBP,iBAMO;AAEP,IAAI,MAA0B;AAWvB,SAAS,iBAA8B;AAC5C,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;ADHO,SAAS,QAAmB;AACjC,aAAO,+BAAa,eAAe,CAAC;AACtC;AAIA,eAAsB,YACpB,gBACA,MACiB;AACjB,QAAMA,OAAM,eAAe;AAC3B,QAAM,gBAAY,+BAAaA,IAAG;AAClC,QAAM,MAAM,UAAM,6BAAO,6BAAW,WAAW,cAAc,GAAG;AAAA,IAC9D,GAAG;AAAA,IACH,eAAW,kCAAgB;AAAA,EAC7B,CAAC;AACD,SAAO,IAAI;AACb;AAEA,eAAsB,YACpB,gBACA,OACA,MACe;AACf,QAAMA,OAAM,eAAe;AAC3B,QAAM,gBAAY,+BAAaA,IAAG;AAClC,YAAM,6BAAO,sBAAI,WAAW,gBAAgB,KAAK,GAAG;AAAA,IAClD,GAAG;AAAA,IACH,eAAW,kCAAgB;AAAA,EAC7B,CAAC;AACH;AAEA,eAAsB,eACpB,gBACA,OACA,MACe;AACf,QAAMA,OAAM,eAAe;AAC3B,QAAM,gBAAY,+BAAaA,IAAG;AAClC,YAAM,gCAAU,sBAAI,WAAW,gBAAgB,KAAK,GAAG;AAAA,IACrD,GAAG;AAAA,IACH,eAAW,kCAAgB;AAAA,EAC7B,CAAC;AACH;AAEA,eAAsB,eACpB,gBACA,OACe;AACf,QAAMA,OAAM,eAAe;AAC3B,QAAM,gBAAY,+BAAaA,IAAG;AAClC,YAAM,gCAAU,sBAAI,WAAW,gBAAgB,KAAK,CAAC;AACvD;AAEA,eAAsB,YACpB,gBACA,OACsC;AACtC,QAAMA,OAAM,eAAe;AAC3B,QAAM,gBAAY,+BAAaA,IAAG;AAClC,QAAM,OAAO,UAAM,6BAAO,sBAAI,WAAW,gBAAgB,KAAK,CAAC;AAC/D,MAAI,CAAC,KAAK,OAAO,EAAG,QAAO;AAC3B,SAAO,EAAE,IAAI,KAAK,IAAI,GAAI,KAAK,KAAK,EAAQ;AAC9C;AAEA,eAAsB,gBACpB,gBACA,cAAiC,CAAC,GACD;AACjC,QAAMA,OAAM,eAAe;AAC3B,QAAM,gBAAY,+BAAaA,IAAG;AAClC,QAAM,QAAI,4BAAM,6BAAW,WAAW,cAAc,GAAG,GAAG,WAAW;AACrE,QAAM,OAAO,UAAM,0BAAQ,CAAC;AAC5B,SAAO,KAAK,KAAK,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,GAAI,EAAE,KAAK,EAAQ,EAAE;AAChE;","names":["app"]}

package/dist/firestore/index.d.cts

@@ -0,0 +1,17 @@
+import { WithFieldValue, DocumentData, Firestore, QueryConstraint, UpdateData } from 'firebase/firestore';
+export { limit, orderBy, serverTimestamp, where } from 'firebase/firestore';
+
+declare function getDb(): Firestore;
+
+declare function addDocument<T extends WithFieldValue<DocumentData>>(collectionName: string, data: T): Promise<string>;
+declare function setDocument<T extends WithFieldValue<DocumentData>>(collectionName: string, docId: string, data: T): Promise<void>;
+declare function updateDocument<T extends DocumentData>(collectionName: string, docId: string, data: UpdateData<T>): Promise<void>;
+declare function deleteDocument(collectionName: string, docId: string): Promise<void>;
+declare function getDocument<T = DocumentData>(collectionName: string, docId: string): Promise<(T & {
+    id: string;
+}) | null>;
+declare function queryCollection<T = DocumentData>(collectionName: string, constraints?: QueryConstraint[]): Promise<(T & {
+    id: string;
+})[]>;
+
+export { addDocument, deleteDocument, getDb, getDocument, queryCollection, setDocument, updateDocument };

package/dist/firestore/index.d.ts

@@ -0,0 +1,17 @@
+import { WithFieldValue, DocumentData, Firestore, QueryConstraint, UpdateData } from 'firebase/firestore';
+export { limit, orderBy, serverTimestamp, where } from 'firebase/firestore';
+
+declare function getDb(): Firestore;
+
+declare function addDocument<T extends WithFieldValue<DocumentData>>(collectionName: string, data: T): Promise<string>;
+declare function setDocument<T extends WithFieldValue<DocumentData>>(collectionName: string, docId: string, data: T): Promise<void>;
+declare function updateDocument<T extends DocumentData>(collectionName: string, docId: string, data: UpdateData<T>): Promise<void>;
+declare function deleteDocument(collectionName: string, docId: string): Promise<void>;
+declare function getDocument<T = DocumentData>(collectionName: string, docId: string): Promise<(T & {
+    id: string;
+}) | null>;
+declare function queryCollection<T = DocumentData>(collectionName: string, constraints?: QueryConstraint[]): Promise<(T & {
+    id: string;
+})[]>;
+
+export { addDocument, deleteDocument, getDb, getDocument, queryCollection, setDocument, updateDocument };

package/dist/firestore/index.js

@@ -0,0 +1,96 @@
+// src/firestore/index.ts
+import {
+  getFirestore,
+  collection,
+  doc,
+  addDoc,
+  setDoc,
+  updateDoc,
+  deleteDoc,
+  getDoc,
+  getDocs,
+  query,
+  where,
+  orderBy,
+  limit,
+  serverTimestamp
+} from "firebase/firestore";
+
+// src/core.ts
+import {
+  initializeApp,
+  getApps,
+  getApp
+} from "firebase/app";
+var app = null;
+function getFirebaseApp() {
+  if (!app) {
+    throw new Error(
+      "@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage."
+    );
+  }
+  return app;
+}
+
+// src/firestore/index.ts
+function getDb() {
+  return getFirestore(getFirebaseApp());
+}
+async function addDocument(collectionName, data) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  const ref = await addDoc(collection(firestore, collectionName), {
+    ...data,
+    createdAt: serverTimestamp()
+  });
+  return ref.id;
+}
+async function setDocument(collectionName, docId, data) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  await setDoc(doc(firestore, collectionName, docId), {
+    ...data,
+    updatedAt: serverTimestamp()
+  });
+}
+async function updateDocument(collectionName, docId, data) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  await updateDoc(doc(firestore, collectionName, docId), {
+    ...data,
+    updatedAt: serverTimestamp()
+  });
+}
+async function deleteDocument(collectionName, docId) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  await deleteDoc(doc(firestore, collectionName, docId));
+}
+async function getDocument(collectionName, docId) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  const snap = await getDoc(doc(firestore, collectionName, docId));
+  if (!snap.exists()) return null;
+  return { id: snap.id, ...snap.data() };
+}
+async function queryCollection(collectionName, constraints = []) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  const q = query(collection(firestore, collectionName), ...constraints);
+  const snap = await getDocs(q);
+  return snap.docs.map((d) => ({ id: d.id, ...d.data() }));
+}
+export {
+  addDocument,
+  deleteDocument,
+  getDb,
+  getDocument,
+  limit,
+  orderBy,
+  queryCollection,
+  serverTimestamp,
+  setDocument,
+  updateDocument,
+  where
+};
+//# sourceMappingURL=index.js.map

package/dist/firestore/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/firestore/index.ts","../../src/core.ts"],"sourcesContent":["import {\n  getFirestore,\n  collection,\n  doc,\n  addDoc,\n  setDoc,\n  updateDoc,\n  deleteDoc,\n  getDoc,\n  getDocs,\n  query,\n  where,\n  orderBy,\n  limit,\n  serverTimestamp,\n  type DocumentData,\n  type QueryConstraint,\n  type WithFieldValue,\n  type UpdateData,\n  type Firestore,\n} from \"firebase/firestore\";\nimport { getFirebaseApp } from \"../core\";\n\nexport function getDb(): Firestore {\n  return getFirestore(getFirebaseApp());\n}\n\nexport { serverTimestamp, where, orderBy, limit };\n\nexport async function addDocument<T extends WithFieldValue<DocumentData>>(\n  collectionName: string,\n  data: T\n): Promise<string> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const ref = await addDoc(collection(firestore, collectionName), {\n    ...data,\n    createdAt: serverTimestamp(),\n  });\n  return ref.id;\n}\n\nexport async function setDocument<T extends WithFieldValue<DocumentData>>(\n  collectionName: string,\n  docId: string,\n  data: T\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await setDoc(doc(firestore, collectionName, docId), {\n    ...data,\n    updatedAt: serverTimestamp(),\n  });\n}\n\nexport async function updateDocument<T extends DocumentData>(\n  collectionName: string,\n  docId: string,\n  data: UpdateData<T>\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await updateDoc(doc(firestore, collectionName, docId), {\n    ...data,\n    updatedAt: serverTimestamp(),\n  });\n}\n\nexport async function deleteDocument(\n  collectionName: string,\n  docId: string\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await deleteDoc(doc(firestore, collectionName, docId));\n}\n\nexport async function getDocument<T = DocumentData>(\n  collectionName: string,\n  docId: string\n): Promise<(T & { id: string }) | null> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const snap = await getDoc(doc(firestore, collectionName, docId));\n  if (!snap.exists()) return null;\n  return { id: snap.id, ...(snap.data() as T) };\n}\n\nexport async function queryCollection<T = DocumentData>(\n  collectionName: string,\n  constraints: QueryConstraint[] = []\n): Promise<(T & { id: string })[]> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const q = query(collection(firestore, collectionName), ...constraints);\n  const snap = await getDocs(q);\n  return snap.docs.map((d) => ({ id: d.id, ...(d.data() as T) }));\n}\n","import {\n  initializeApp,\n  getApps,\n  getApp,\n  type FirebaseApp,\n  type FirebaseOptions,\n} from \"firebase/app\";\n\nlet app: FirebaseApp | null = null;\n\nexport function initFirebase(config: FirebaseOptions): FirebaseApp {\n  if (getApps().length > 0) {\n    app = getApp();\n    return app;\n  }\n  app = initializeApp(config);\n  return app;\n}\n\nexport function getFirebaseApp(): FirebaseApp {\n  if (!app) {\n    throw new Error(\n      \"@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage.\"\n    );\n  }\n  return app;\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;;;ACpBP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP,IAAI,MAA0B;AAWvB,SAAS,iBAA8B;AAC5C,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;ADHO,SAAS,QAAmB;AACjC,SAAO,aAAa,eAAe,CAAC;AACtC;AAIA,eAAsB,YACpB,gBACA,MACiB;AACjB,QAAMA,OAAM,eAAe;AAC3B,QAAM,YAAY,aAAaA,IAAG;AAClC,QAAM,MAAM,MAAM,OAAO,WAAW,WAAW,cAAc,GAAG;AAAA,IAC9D,GAAG;AAAA,IACH,WAAW,gBAAgB;AAAA,EAC7B,CAAC;AACD,SAAO,IAAI;AACb;AAEA,eAAsB,YACpB,gBACA,OACA,MACe;AACf,QAAMA,OAAM,eAAe;AAC3B,QAAM,YAAY,aAAaA,IAAG;AAClC,QAAM,OAAO,IAAI,WAAW,gBAAgB,KAAK,GAAG;AAAA,IAClD,GAAG;AAAA,IACH,WAAW,gBAAgB;AAAA,EAC7B,CAAC;AACH;AAEA,eAAsB,eACpB,gBACA,OACA,MACe;AACf,QAAMA,OAAM,eAAe;AAC3B,QAAM,YAAY,aAAaA,IAAG;AAClC,QAAM,UAAU,IAAI,WAAW,gBAAgB,KAAK,GAAG;AAAA,IACrD,GAAG;AAAA,IACH,WAAW,gBAAgB;AAAA,EAC7B,CAAC;AACH;AAEA,eAAsB,eACpB,gBACA,OACe;AACf,QAAMA,OAAM,eAAe;AAC3B,QAAM,YAAY,aAAaA,IAAG;AAClC,QAAM,UAAU,IAAI,WAAW,gBAAgB,KAAK,CAAC;AACvD;AAEA,eAAsB,YACpB,gBACA,OACsC;AACtC,QAAMA,OAAM,eAAe;AAC3B,QAAM,YAAY,aAAaA,IAAG;AAClC,QAAM,OAAO,MAAM,OAAO,IAAI,WAAW,gBAAgB,KAAK,CAAC;AAC/D,MAAI,CAAC,KAAK,OAAO,EAAG,QAAO;AAC3B,SAAO,EAAE,IAAI,KAAK,IAAI,GAAI,KAAK,KAAK,EAAQ;AAC9C;AAEA,eAAsB,gBACpB,gBACA,cAAiC,CAAC,GACD;AACjC,QAAMA,OAAM,eAAe;AAC3B,QAAM,YAAY,aAAaA,IAAG;AAClC,QAAM,IAAI,MAAM,WAAW,WAAW,cAAc,GAAG,GAAG,WAAW;AACrE,QAAM,OAAO,MAAM,QAAQ,CAAC;AAC5B,SAAO,KAAK,KAAK,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,GAAI,EAAE,KAAK,EAAQ,EAAE;AAChE;","names":["app"]}

package/dist/index.cjs

@@ -0,0 +1,175 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  addDocument: () => addDocument,
+  deleteDocument: () => deleteDocument,
+  deleteFile: () => deleteFile,
+  getDb: () => getDb,
+  getDocument: () => getDocument,
+  getFileUrl: () => getFileUrl,
+  getFirebaseApp: () => getFirebaseApp,
+  getStorageInstance: () => getStorageInstance,
+  initFirebase: () => initFirebase,
+  limit: () => import_firestore.limit,
+  orderBy: () => import_firestore.orderBy,
+  queryCollection: () => queryCollection,
+  serverTimestamp: () => import_firestore.serverTimestamp,
+  setDocument: () => setDocument,
+  updateDocument: () => updateDocument,
+  uploadFile: () => uploadFile,
+  where: () => import_firestore.where
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/core.ts
+var import_app = require("firebase/app");
+var app = null;
+function initFirebase(config) {
+  if ((0, import_app.getApps)().length > 0) {
+    app = (0, import_app.getApp)();
+    return app;
+  }
+  app = (0, import_app.initializeApp)(config);
+  return app;
+}
+function getFirebaseApp() {
+  if (!app) {
+    throw new Error(
+      "@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage."
+    );
+  }
+  return app;
+}
+
+// src/firestore/index.ts
+var import_firestore = require("firebase/firestore");
+function getDb() {
+  return (0, import_firestore.getFirestore)(getFirebaseApp());
+}
+async function addDocument(collectionName, data) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  const ref2 = await (0, import_firestore.addDoc)((0, import_firestore.collection)(firestore, collectionName), {
+    ...data,
+    createdAt: (0, import_firestore.serverTimestamp)()
+  });
+  return ref2.id;
+}
+async function setDocument(collectionName, docId, data) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  await (0, import_firestore.setDoc)((0, import_firestore.doc)(firestore, collectionName, docId), {
+    ...data,
+    updatedAt: (0, import_firestore.serverTimestamp)()
+  });
+}
+async function updateDocument(collectionName, docId, data) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  await (0, import_firestore.updateDoc)((0, import_firestore.doc)(firestore, collectionName, docId), {
+    ...data,
+    updatedAt: (0, import_firestore.serverTimestamp)()
+  });
+}
+async function deleteDocument(collectionName, docId) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  await (0, import_firestore.deleteDoc)((0, import_firestore.doc)(firestore, collectionName, docId));
+}
+async function getDocument(collectionName, docId) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  const snap = await (0, import_firestore.getDoc)((0, import_firestore.doc)(firestore, collectionName, docId));
+  if (!snap.exists()) return null;
+  return { id: snap.id, ...snap.data() };
+}
+async function queryCollection(collectionName, constraints = []) {
+  const app2 = getFirebaseApp();
+  const firestore = (0, import_firestore.getFirestore)(app2);
+  const q = (0, import_firestore.query)((0, import_firestore.collection)(firestore, collectionName), ...constraints);
+  const snap = await (0, import_firestore.getDocs)(q);
+  return snap.docs.map((d) => ({ id: d.id, ...d.data() }));
+}
+
+// src/storage/index.ts
+var import_storage = require("firebase/storage");
+function getStorageInstance() {
+  return (0, import_storage.getStorage)(getFirebaseApp());
+}
+function buildPath(file, options) {
+  const ext = file.name.split(".").pop() ?? "";
+  const name = options.fileName ? `${options.fileName}.${ext}` : `${crypto.randomUUID()}.${ext}`;
+  return options.folder ? `${options.folder}/${name}` : name;
+}
+function uploadFile(file, options = {}) {
+  const storage = getStorageInstance();
+  return new Promise((resolve, reject) => {
+    const path = buildPath(file, options);
+    const storageRef = (0, import_storage.ref)(storage, path);
+    const task = (0, import_storage.uploadBytesResumable)(storageRef, file);
+    task.on(
+      "state_changed",
+      (snapshot) => {
+        if (options.onProgress) {
+          const percent = Math.round(
+            snapshot.bytesTransferred / snapshot.totalBytes * 100
+          );
+          options.onProgress(percent);
+        }
+      },
+      (error) => reject(error),
+      async () => {
+        const url = await (0, import_storage.getDownloadURL)(task.snapshot.ref);
+        resolve({ url, path });
+      }
+    );
+  });
+}
+async function deleteFile(path) {
+  const storage = getStorageInstance();
+  await (0, import_storage.deleteObject)((0, import_storage.ref)(storage, path));
+}
+async function getFileUrl(path) {
+  const storage = getStorageInstance();
+  return (0, import_storage.getDownloadURL)((0, import_storage.ref)(storage, path));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addDocument,
+  deleteDocument,
+  deleteFile,
+  getDb,
+  getDocument,
+  getFileUrl,
+  getFirebaseApp,
+  getStorageInstance,
+  initFirebase,
+  limit,
+  orderBy,
+  queryCollection,
+  serverTimestamp,
+  setDocument,
+  updateDocument,
+  uploadFile,
+  where
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/core.ts","../src/firestore/index.ts","../src/storage/index.ts"],"sourcesContent":["export { initFirebase, getFirebaseApp } from \"./core\";\nexport {\n  getDb,\n  addDocument,\n  setDocument,\n  updateDocument,\n  deleteDocument,\n  getDocument,\n  queryCollection,\n  serverTimestamp,\n  where,\n  orderBy,\n  limit,\n} from \"./firestore\";\nexport {\n  getStorageInstance,\n  uploadFile,\n  deleteFile,\n  getFileUrl,\n} from \"./storage\";\nexport type { UploadResult, UploadOptions } from \"./storage\";\n","import {\n  initializeApp,\n  getApps,\n  getApp,\n  type FirebaseApp,\n  type FirebaseOptions,\n} from \"firebase/app\";\n\nlet app: FirebaseApp | null = null;\n\nexport function initFirebase(config: FirebaseOptions): FirebaseApp {\n  if (getApps().length > 0) {\n    app = getApp();\n    return app;\n  }\n  app = initializeApp(config);\n  return app;\n}\n\nexport function getFirebaseApp(): FirebaseApp {\n  if (!app) {\n    throw new Error(\n      \"@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage.\"\n    );\n  }\n  return app;\n}\n","import {\n  getFirestore,\n  collection,\n  doc,\n  addDoc,\n  setDoc,\n  updateDoc,\n  deleteDoc,\n  getDoc,\n  getDocs,\n  query,\n  where,\n  orderBy,\n  limit,\n  serverTimestamp,\n  type DocumentData,\n  type QueryConstraint,\n  type WithFieldValue,\n  type UpdateData,\n  type Firestore,\n} from \"firebase/firestore\";\nimport { getFirebaseApp } from \"../core\";\n\nexport function getDb(): Firestore {\n  return getFirestore(getFirebaseApp());\n}\n\nexport { serverTimestamp, where, orderBy, limit };\n\nexport async function addDocument<T extends WithFieldValue<DocumentData>>(\n  collectionName: string,\n  data: T\n): Promise<string> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const ref = await addDoc(collection(firestore, collectionName), {\n    ...data,\n    createdAt: serverTimestamp(),\n  });\n  return ref.id;\n}\n\nexport async function setDocument<T extends WithFieldValue<DocumentData>>(\n  collectionName: string,\n  docId: string,\n  data: T\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await setDoc(doc(firestore, collectionName, docId), {\n    ...data,\n    updatedAt: serverTimestamp(),\n  });\n}\n\nexport async function updateDocument<T extends DocumentData>(\n  collectionName: string,\n  docId: string,\n  data: UpdateData<T>\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await updateDoc(doc(firestore, collectionName, docId), {\n    ...data,\n    updatedAt: serverTimestamp(),\n  });\n}\n\nexport async function deleteDocument(\n  collectionName: string,\n  docId: string\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await deleteDoc(doc(firestore, collectionName, docId));\n}\n\nexport async function getDocument<T = DocumentData>(\n  collectionName: string,\n  docId: string\n): Promise<(T & { id: string }) | null> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const snap = await getDoc(doc(firestore, collectionName, docId));\n  if (!snap.exists()) return null;\n  return { id: snap.id, ...(snap.data() as T) };\n}\n\nexport async function queryCollection<T = DocumentData>(\n  collectionName: string,\n  constraints: QueryConstraint[] = []\n): Promise<(T & { id: string })[]> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const q = query(collection(firestore, collectionName), ...constraints);\n  const snap = await getDocs(q);\n  return snap.docs.map((d) => ({ id: d.id, ...(d.data() as T) }));\n}\n","import {\n  getStorage,\n  ref,\n  uploadBytesResumable,\n  getDownloadURL,\n  deleteObject,\n  type FirebaseStorage,\n  type UploadTaskSnapshot,\n} from \"firebase/storage\";\nimport { getFirebaseApp } from \"../core\";\n\nexport function getStorageInstance(): FirebaseStorage {\n  return getStorage(getFirebaseApp());\n}\n\nexport interface UploadResult {\n  url: string;\n  path: string;\n}\n\nexport interface UploadOptions {\n  folder?: string;\n  fileName?: string;\n  onProgress?: (percent: number) => void;\n}\n\nfunction buildPath(file: File, options: UploadOptions): string {\n  const ext = file.name.split(\".\").pop() ?? \"\";\n  const name = options.fileName\n    ? `${options.fileName}.${ext}`\n    : `${crypto.randomUUID()}.${ext}`;\n  return options.folder ? `${options.folder}/${name}` : name;\n}\n\nexport function uploadFile(\n  file: File,\n  options: UploadOptions = {}\n): Promise<UploadResult> {\n  const storage = getStorageInstance();\n  return new Promise((resolve, reject) => {\n    const path = buildPath(file, options);\n    const storageRef = ref(storage, path);\n    const task = uploadBytesResumable(storageRef, file);\n\n    task.on(\n      \"state_changed\",\n      (snapshot: UploadTaskSnapshot) => {\n        if (options.onProgress) {\n          const percent = Math.round(\n            (snapshot.bytesTransferred / snapshot.totalBytes) * 100\n          );\n          options.onProgress(percent);\n        }\n      },\n      (error) => reject(error),\n      async () => {\n        const url = await getDownloadURL(task.snapshot.ref);\n        resolve({ url, path });\n      }\n    );\n  });\n}\n\nexport async function deleteFile(path: string): Promise<void> {\n  const storage = getStorageInstance();\n  await deleteObject(ref(storage, path));\n}\n\nexport async function getFileUrl(path: string): Promise<string> {\n  const storage = getStorageInstance();\n  return getDownloadURL(ref(storage, path));\n}\n"],"mappings":"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","names":["app","ref"]}

package/dist/index.d.cts

@@ -0,0 +1,10 @@
+import { FirebaseApp, FirebaseOptions } from 'firebase/app';
+export { addDocument, deleteDocument, getDb, getDocument, queryCollection, setDocument, updateDocument } from './firestore/index.cjs';
+export { UploadOptions, UploadResult, deleteFile, getFileUrl, getStorageInstance, uploadFile } from './storage/index.cjs';
+export { limit, orderBy, serverTimestamp, where } from 'firebase/firestore';
+import 'firebase/storage';
+
+declare function initFirebase(config: FirebaseOptions): FirebaseApp;
+declare function getFirebaseApp(): FirebaseApp;
+
+export { getFirebaseApp, initFirebase };

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { FirebaseApp, FirebaseOptions } from 'firebase/app';
+export { addDocument, deleteDocument, getDb, getDocument, queryCollection, setDocument, updateDocument } from './firestore/index.js';
+export { UploadOptions, UploadResult, deleteFile, getFileUrl, getStorageInstance, uploadFile } from './storage/index.js';
+export { limit, orderBy, serverTimestamp, where } from 'firebase/firestore';
+import 'firebase/storage';
+
+declare function initFirebase(config: FirebaseOptions): FirebaseApp;
+declare function getFirebaseApp(): FirebaseApp;
+
+export { getFirebaseApp, initFirebase };

package/dist/index.js

@@ -0,0 +1,157 @@
+// src/core.ts
+import {
+  initializeApp,
+  getApps,
+  getApp
+} from "firebase/app";
+var app = null;
+function initFirebase(config) {
+  if (getApps().length > 0) {
+    app = getApp();
+    return app;
+  }
+  app = initializeApp(config);
+  return app;
+}
+function getFirebaseApp() {
+  if (!app) {
+    throw new Error(
+      "@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage."
+    );
+  }
+  return app;
+}
+
+// src/firestore/index.ts
+import {
+  getFirestore,
+  collection,
+  doc,
+  addDoc,
+  setDoc,
+  updateDoc,
+  deleteDoc,
+  getDoc,
+  getDocs,
+  query,
+  where,
+  orderBy,
+  limit,
+  serverTimestamp
+} from "firebase/firestore";
+function getDb() {
+  return getFirestore(getFirebaseApp());
+}
+async function addDocument(collectionName, data) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  const ref2 = await addDoc(collection(firestore, collectionName), {
+    ...data,
+    createdAt: serverTimestamp()
+  });
+  return ref2.id;
+}
+async function setDocument(collectionName, docId, data) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  await setDoc(doc(firestore, collectionName, docId), {
+    ...data,
+    updatedAt: serverTimestamp()
+  });
+}
+async function updateDocument(collectionName, docId, data) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  await updateDoc(doc(firestore, collectionName, docId), {
+    ...data,
+    updatedAt: serverTimestamp()
+  });
+}
+async function deleteDocument(collectionName, docId) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  await deleteDoc(doc(firestore, collectionName, docId));
+}
+async function getDocument(collectionName, docId) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  const snap = await getDoc(doc(firestore, collectionName, docId));
+  if (!snap.exists()) return null;
+  return { id: snap.id, ...snap.data() };
+}
+async function queryCollection(collectionName, constraints = []) {
+  const app2 = getFirebaseApp();
+  const firestore = getFirestore(app2);
+  const q = query(collection(firestore, collectionName), ...constraints);
+  const snap = await getDocs(q);
+  return snap.docs.map((d) => ({ id: d.id, ...d.data() }));
+}
+
+// src/storage/index.ts
+import {
+  getStorage,
+  ref,
+  uploadBytesResumable,
+  getDownloadURL,
+  deleteObject
+} from "firebase/storage";
+function getStorageInstance() {
+  return getStorage(getFirebaseApp());
+}
+function buildPath(file, options) {
+  const ext = file.name.split(".").pop() ?? "";
+  const name = options.fileName ? `${options.fileName}.${ext}` : `${crypto.randomUUID()}.${ext}`;
+  return options.folder ? `${options.folder}/${name}` : name;
+}
+function uploadFile(file, options = {}) {
+  const storage = getStorageInstance();
+  return new Promise((resolve, reject) => {
+    const path = buildPath(file, options);
+    const storageRef = ref(storage, path);
+    const task = uploadBytesResumable(storageRef, file);
+    task.on(
+      "state_changed",
+      (snapshot) => {
+        if (options.onProgress) {
+          const percent = Math.round(
+            snapshot.bytesTransferred / snapshot.totalBytes * 100
+          );
+          options.onProgress(percent);
+        }
+      },
+      (error) => reject(error),
+      async () => {
+        const url = await getDownloadURL(task.snapshot.ref);
+        resolve({ url, path });
+      }
+    );
+  });
+}
+async function deleteFile(path) {
+  const storage = getStorageInstance();
+  await deleteObject(ref(storage, path));
+}
+async function getFileUrl(path) {
+  const storage = getStorageInstance();
+  return getDownloadURL(ref(storage, path));
+}
+export {
+  addDocument,
+  deleteDocument,
+  deleteFile,
+  getDb,
+  getDocument,
+  getFileUrl,
+  getFirebaseApp,
+  getStorageInstance,
+  initFirebase,
+  limit,
+  orderBy,
+  queryCollection,
+  serverTimestamp,
+  setDocument,
+  updateDocument,
+  uploadFile,
+  where
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts","../src/firestore/index.ts","../src/storage/index.ts"],"sourcesContent":["import {\n  initializeApp,\n  getApps,\n  getApp,\n  type FirebaseApp,\n  type FirebaseOptions,\n} from \"firebase/app\";\n\nlet app: FirebaseApp | null = null;\n\nexport function initFirebase(config: FirebaseOptions): FirebaseApp {\n  if (getApps().length > 0) {\n    app = getApp();\n    return app;\n  }\n  app = initializeApp(config);\n  return app;\n}\n\nexport function getFirebaseApp(): FirebaseApp {\n  if (!app) {\n    throw new Error(\n      \"@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage.\"\n    );\n  }\n  return app;\n}\n","import {\n  getFirestore,\n  collection,\n  doc,\n  addDoc,\n  setDoc,\n  updateDoc,\n  deleteDoc,\n  getDoc,\n  getDocs,\n  query,\n  where,\n  orderBy,\n  limit,\n  serverTimestamp,\n  type DocumentData,\n  type QueryConstraint,\n  type WithFieldValue,\n  type UpdateData,\n  type Firestore,\n} from \"firebase/firestore\";\nimport { getFirebaseApp } from \"../core\";\n\nexport function getDb(): Firestore {\n  return getFirestore(getFirebaseApp());\n}\n\nexport { serverTimestamp, where, orderBy, limit };\n\nexport async function addDocument<T extends WithFieldValue<DocumentData>>(\n  collectionName: string,\n  data: T\n): Promise<string> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const ref = await addDoc(collection(firestore, collectionName), {\n    ...data,\n    createdAt: serverTimestamp(),\n  });\n  return ref.id;\n}\n\nexport async function setDocument<T extends WithFieldValue<DocumentData>>(\n  collectionName: string,\n  docId: string,\n  data: T\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await setDoc(doc(firestore, collectionName, docId), {\n    ...data,\n    updatedAt: serverTimestamp(),\n  });\n}\n\nexport async function updateDocument<T extends DocumentData>(\n  collectionName: string,\n  docId: string,\n  data: UpdateData<T>\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await updateDoc(doc(firestore, collectionName, docId), {\n    ...data,\n    updatedAt: serverTimestamp(),\n  });\n}\n\nexport async function deleteDocument(\n  collectionName: string,\n  docId: string\n): Promise<void> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  await deleteDoc(doc(firestore, collectionName, docId));\n}\n\nexport async function getDocument<T = DocumentData>(\n  collectionName: string,\n  docId: string\n): Promise<(T & { id: string }) | null> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const snap = await getDoc(doc(firestore, collectionName, docId));\n  if (!snap.exists()) return null;\n  return { id: snap.id, ...(snap.data() as T) };\n}\n\nexport async function queryCollection<T = DocumentData>(\n  collectionName: string,\n  constraints: QueryConstraint[] = []\n): Promise<(T & { id: string })[]> {\n  const app = getFirebaseApp();\n  const firestore = getFirestore(app);\n  const q = query(collection(firestore, collectionName), ...constraints);\n  const snap = await getDocs(q);\n  return snap.docs.map((d) => ({ id: d.id, ...(d.data() as T) }));\n}\n","import {\n  getStorage,\n  ref,\n  uploadBytesResumable,\n  getDownloadURL,\n  deleteObject,\n  type FirebaseStorage,\n  type UploadTaskSnapshot,\n} from \"firebase/storage\";\nimport { getFirebaseApp } from \"../core\";\n\nexport function getStorageInstance(): FirebaseStorage {\n  return getStorage(getFirebaseApp());\n}\n\nexport interface UploadResult {\n  url: string;\n  path: string;\n}\n\nexport interface UploadOptions {\n  folder?: string;\n  fileName?: string;\n  onProgress?: (percent: number) => void;\n}\n\nfunction buildPath(file: File, options: UploadOptions): string {\n  const ext = file.name.split(\".\").pop() ?? \"\";\n  const name = options.fileName\n    ? `${options.fileName}.${ext}`\n    : `${crypto.randomUUID()}.${ext}`;\n  return options.folder ? `${options.folder}/${name}` : name;\n}\n\nexport function uploadFile(\n  file: File,\n  options: UploadOptions = {}\n): Promise<UploadResult> {\n  const storage = getStorageInstance();\n  return new Promise((resolve, reject) => {\n    const path = buildPath(file, options);\n    const storageRef = ref(storage, path);\n    const task = uploadBytesResumable(storageRef, file);\n\n    task.on(\n      \"state_changed\",\n      (snapshot: UploadTaskSnapshot) => {\n        if (options.onProgress) {\n          const percent = Math.round(\n            (snapshot.bytesTransferred / snapshot.totalBytes) * 100\n          );\n          options.onProgress(percent);\n        }\n      },\n      (error) => reject(error),\n      async () => {\n        const url = await getDownloadURL(task.snapshot.ref);\n        resolve({ url, path });\n      }\n    );\n  });\n}\n\nexport async function deleteFile(path: string): Promise<void> {\n  const storage = getStorageInstance();\n  await deleteObject(ref(storage, path));\n}\n\nexport async function getFileUrl(path: string): Promise<string> {\n  const storage = getStorageInstance();\n  return getDownloadURL(ref(storage, path));\n}\n"],"mappings":"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","names":["app","ref"]}

package/dist/storage/index.cjs

@@ -0,0 +1,91 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/storage/index.ts
+var storage_exports = {};
+__export(storage_exports, {
+  deleteFile: () => deleteFile,
+  getFileUrl: () => getFileUrl,
+  getStorageInstance: () => getStorageInstance,
+  uploadFile: () => uploadFile
+});
+module.exports = __toCommonJS(storage_exports);
+var import_storage = require("firebase/storage");
+
+// src/core.ts
+var import_app = require("firebase/app");
+var app = null;
+function getFirebaseApp() {
+  if (!app) {
+    throw new Error(
+      "@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage."
+    );
+  }
+  return app;
+}
+
+// src/storage/index.ts
+function getStorageInstance() {
+  return (0, import_storage.getStorage)(getFirebaseApp());
+}
+function buildPath(file, options) {
+  const ext = file.name.split(".").pop() ?? "";
+  const name = options.fileName ? `${options.fileName}.${ext}` : `${crypto.randomUUID()}.${ext}`;
+  return options.folder ? `${options.folder}/${name}` : name;
+}
+function uploadFile(file, options = {}) {
+  const storage = getStorageInstance();
+  return new Promise((resolve, reject) => {
+    const path = buildPath(file, options);
+    const storageRef = (0, import_storage.ref)(storage, path);
+    const task = (0, import_storage.uploadBytesResumable)(storageRef, file);
+    task.on(
+      "state_changed",
+      (snapshot) => {
+        if (options.onProgress) {
+          const percent = Math.round(
+            snapshot.bytesTransferred / snapshot.totalBytes * 100
+          );
+          options.onProgress(percent);
+        }
+      },
+      (error) => reject(error),
+      async () => {
+        const url = await (0, import_storage.getDownloadURL)(task.snapshot.ref);
+        resolve({ url, path });
+      }
+    );
+  });
+}
+async function deleteFile(path) {
+  const storage = getStorageInstance();
+  await (0, import_storage.deleteObject)((0, import_storage.ref)(storage, path));
+}
+async function getFileUrl(path) {
+  const storage = getStorageInstance();
+  return (0, import_storage.getDownloadURL)((0, import_storage.ref)(storage, path));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  deleteFile,
+  getFileUrl,
+  getStorageInstance,
+  uploadFile
+});
+//# sourceMappingURL=index.cjs.map

package/dist/storage/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/index.ts","../../src/core.ts"],"sourcesContent":["import {\n  getStorage,\n  ref,\n  uploadBytesResumable,\n  getDownloadURL,\n  deleteObject,\n  type FirebaseStorage,\n  type UploadTaskSnapshot,\n} from \"firebase/storage\";\nimport { getFirebaseApp } from \"../core\";\n\nexport function getStorageInstance(): FirebaseStorage {\n  return getStorage(getFirebaseApp());\n}\n\nexport interface UploadResult {\n  url: string;\n  path: string;\n}\n\nexport interface UploadOptions {\n  folder?: string;\n  fileName?: string;\n  onProgress?: (percent: number) => void;\n}\n\nfunction buildPath(file: File, options: UploadOptions): string {\n  const ext = file.name.split(\".\").pop() ?? \"\";\n  const name = options.fileName\n    ? `${options.fileName}.${ext}`\n    : `${crypto.randomUUID()}.${ext}`;\n  return options.folder ? `${options.folder}/${name}` : name;\n}\n\nexport function uploadFile(\n  file: File,\n  options: UploadOptions = {}\n): Promise<UploadResult> {\n  const storage = getStorageInstance();\n  return new Promise((resolve, reject) => {\n    const path = buildPath(file, options);\n    const storageRef = ref(storage, path);\n    const task = uploadBytesResumable(storageRef, file);\n\n    task.on(\n      \"state_changed\",\n      (snapshot: UploadTaskSnapshot) => {\n        if (options.onProgress) {\n          const percent = Math.round(\n            (snapshot.bytesTransferred / snapshot.totalBytes) * 100\n          );\n          options.onProgress(percent);\n        }\n      },\n      (error) => reject(error),\n      async () => {\n        const url = await getDownloadURL(task.snapshot.ref);\n        resolve({ url, path });\n      }\n    );\n  });\n}\n\nexport async function deleteFile(path: string): Promise<void> {\n  const storage = getStorageInstance();\n  await deleteObject(ref(storage, path));\n}\n\nexport async function getFileUrl(path: string): Promise<string> {\n  const storage = getStorageInstance();\n  return getDownloadURL(ref(storage, path));\n}\n","import {\n  initializeApp,\n  getApps,\n  getApp,\n  type FirebaseApp,\n  type FirebaseOptions,\n} from \"firebase/app\";\n\nlet app: FirebaseApp | null = null;\n\nexport function initFirebase(config: FirebaseOptions): FirebaseApp {\n  if (getApps().length > 0) {\n    app = getApp();\n    return app;\n  }\n  app = initializeApp(config);\n  return app;\n}\n\nexport function getFirebaseApp(): FirebaseApp {\n  if (!app) {\n    throw new Error(\n      \"@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage.\"\n    );\n  }\n  return app;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAQO;;;ACRP,iBAMO;AAEP,IAAI,MAA0B;AAWvB,SAAS,iBAA8B;AAC5C,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;ADfO,SAAS,qBAAsC;AACpD,aAAO,2BAAW,eAAe,CAAC;AACpC;AAaA,SAAS,UAAU,MAAY,SAAgC;AAC7D,QAAM,MAAM,KAAK,KAAK,MAAM,GAAG,EAAE,IAAI,KAAK;AAC1C,QAAM,OAAO,QAAQ,WACjB,GAAG,QAAQ,QAAQ,IAAI,GAAG,KAC1B,GAAG,OAAO,WAAW,CAAC,IAAI,GAAG;AACjC,SAAO,QAAQ,SAAS,GAAG,QAAQ,MAAM,IAAI,IAAI,KAAK;AACxD;AAEO,SAAS,WACd,MACA,UAAyB,CAAC,GACH;AACvB,QAAM,UAAU,mBAAmB;AACnC,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,OAAO,UAAU,MAAM,OAAO;AACpC,UAAM,iBAAa,oBAAI,SAAS,IAAI;AACpC,UAAM,WAAO,qCAAqB,YAAY,IAAI;AAElD,SAAK;AAAA,MACH;AAAA,MACA,CAAC,aAAiC;AAChC,YAAI,QAAQ,YAAY;AACtB,gBAAM,UAAU,KAAK;AAAA,YAClB,SAAS,mBAAmB,SAAS,aAAc;AAAA,UACtD;AACA,kBAAQ,WAAW,OAAO;AAAA,QAC5B;AAAA,MACF;AAAA,MACA,CAAC,UAAU,OAAO,KAAK;AAAA,MACvB,YAAY;AACV,cAAM,MAAM,UAAM,+BAAe,KAAK,SAAS,GAAG;AAClD,gBAAQ,EAAE,KAAK,KAAK,CAAC;AAAA,MACvB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEA,eAAsB,WAAW,MAA6B;AAC5D,QAAM,UAAU,mBAAmB;AACnC,YAAM,iCAAa,oBAAI,SAAS,IAAI,CAAC;AACvC;AAEA,eAAsB,WAAW,MAA+B;AAC9D,QAAM,UAAU,mBAAmB;AACnC,aAAO,mCAAe,oBAAI,SAAS,IAAI,CAAC;AAC1C;","names":[]}

package/dist/storage/index.d.cts

@@ -0,0 +1,17 @@
+import { FirebaseStorage } from 'firebase/storage';
+
+declare function getStorageInstance(): FirebaseStorage;
+interface UploadResult {
+    url: string;
+    path: string;
+}
+interface UploadOptions {
+    folder?: string;
+    fileName?: string;
+    onProgress?: (percent: number) => void;
+}
+declare function uploadFile(file: File, options?: UploadOptions): Promise<UploadResult>;
+declare function deleteFile(path: string): Promise<void>;
+declare function getFileUrl(path: string): Promise<string>;
+
+export { type UploadOptions, type UploadResult, deleteFile, getFileUrl, getStorageInstance, uploadFile };

package/dist/storage/index.d.ts

@@ -0,0 +1,17 @@
+import { FirebaseStorage } from 'firebase/storage';
+
+declare function getStorageInstance(): FirebaseStorage;
+interface UploadResult {
+    url: string;
+    path: string;
+}
+interface UploadOptions {
+    folder?: string;
+    fileName?: string;
+    onProgress?: (percent: number) => void;
+}
+declare function uploadFile(file: File, options?: UploadOptions): Promise<UploadResult>;
+declare function deleteFile(path: string): Promise<void>;
+declare function getFileUrl(path: string): Promise<string>;
+
+export { type UploadOptions, type UploadResult, deleteFile, getFileUrl, getStorageInstance, uploadFile };

package/dist/storage/index.js

@@ -0,0 +1,73 @@
+// src/storage/index.ts
+import {
+  getStorage,
+  ref,
+  uploadBytesResumable,
+  getDownloadURL,
+  deleteObject
+} from "firebase/storage";
+
+// src/core.ts
+import {
+  initializeApp,
+  getApps,
+  getApp
+} from "firebase/app";
+var app = null;
+function getFirebaseApp() {
+  if (!app) {
+    throw new Error(
+      "@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage."
+    );
+  }
+  return app;
+}
+
+// src/storage/index.ts
+function getStorageInstance() {
+  return getStorage(getFirebaseApp());
+}
+function buildPath(file, options) {
+  const ext = file.name.split(".").pop() ?? "";
+  const name = options.fileName ? `${options.fileName}.${ext}` : `${crypto.randomUUID()}.${ext}`;
+  return options.folder ? `${options.folder}/${name}` : name;
+}
+function uploadFile(file, options = {}) {
+  const storage = getStorageInstance();
+  return new Promise((resolve, reject) => {
+    const path = buildPath(file, options);
+    const storageRef = ref(storage, path);
+    const task = uploadBytesResumable(storageRef, file);
+    task.on(
+      "state_changed",
+      (snapshot) => {
+        if (options.onProgress) {
+          const percent = Math.round(
+            snapshot.bytesTransferred / snapshot.totalBytes * 100
+          );
+          options.onProgress(percent);
+        }
+      },
+      (error) => reject(error),
+      async () => {
+        const url = await getDownloadURL(task.snapshot.ref);
+        resolve({ url, path });
+      }
+    );
+  });
+}
+async function deleteFile(path) {
+  const storage = getStorageInstance();
+  await deleteObject(ref(storage, path));
+}
+async function getFileUrl(path) {
+  const storage = getStorageInstance();
+  return getDownloadURL(ref(storage, path));
+}
+export {
+  deleteFile,
+  getFileUrl,
+  getStorageInstance,
+  uploadFile
+};
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/index.ts","../../src/core.ts"],"sourcesContent":["import {\n  getStorage,\n  ref,\n  uploadBytesResumable,\n  getDownloadURL,\n  deleteObject,\n  type FirebaseStorage,\n  type UploadTaskSnapshot,\n} from \"firebase/storage\";\nimport { getFirebaseApp } from \"../core\";\n\nexport function getStorageInstance(): FirebaseStorage {\n  return getStorage(getFirebaseApp());\n}\n\nexport interface UploadResult {\n  url: string;\n  path: string;\n}\n\nexport interface UploadOptions {\n  folder?: string;\n  fileName?: string;\n  onProgress?: (percent: number) => void;\n}\n\nfunction buildPath(file: File, options: UploadOptions): string {\n  const ext = file.name.split(\".\").pop() ?? \"\";\n  const name = options.fileName\n    ? `${options.fileName}.${ext}`\n    : `${crypto.randomUUID()}.${ext}`;\n  return options.folder ? `${options.folder}/${name}` : name;\n}\n\nexport function uploadFile(\n  file: File,\n  options: UploadOptions = {}\n): Promise<UploadResult> {\n  const storage = getStorageInstance();\n  return new Promise((resolve, reject) => {\n    const path = buildPath(file, options);\n    const storageRef = ref(storage, path);\n    const task = uploadBytesResumable(storageRef, file);\n\n    task.on(\n      \"state_changed\",\n      (snapshot: UploadTaskSnapshot) => {\n        if (options.onProgress) {\n          const percent = Math.round(\n            (snapshot.bytesTransferred / snapshot.totalBytes) * 100\n          );\n          options.onProgress(percent);\n        }\n      },\n      (error) => reject(error),\n      async () => {\n        const url = await getDownloadURL(task.snapshot.ref);\n        resolve({ url, path });\n      }\n    );\n  });\n}\n\nexport async function deleteFile(path: string): Promise<void> {\n  const storage = getStorageInstance();\n  await deleteObject(ref(storage, path));\n}\n\nexport async function getFileUrl(path: string): Promise<string> {\n  const storage = getStorageInstance();\n  return getDownloadURL(ref(storage, path));\n}\n","import {\n  initializeApp,\n  getApps,\n  getApp,\n  type FirebaseApp,\n  type FirebaseOptions,\n} from \"firebase/app\";\n\nlet app: FirebaseApp | null = null;\n\nexport function initFirebase(config: FirebaseOptions): FirebaseApp {\n  if (getApps().length > 0) {\n    app = getApp();\n    return app;\n  }\n  app = initializeApp(config);\n  return app;\n}\n\nexport function getFirebaseApp(): FirebaseApp {\n  if (!app) {\n    throw new Error(\n      \"@codefire/firebase-react: Firebase has not been initialized. Call initFirebase(config) before using Firestore or Storage.\"\n    );\n  }\n  return app;\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;;;ACRP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP,IAAI,MAA0B;AAWvB,SAAS,iBAA8B;AAC5C,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;ADfO,SAAS,qBAAsC;AACpD,SAAO,WAAW,eAAe,CAAC;AACpC;AAaA,SAAS,UAAU,MAAY,SAAgC;AAC7D,QAAM,MAAM,KAAK,KAAK,MAAM,GAAG,EAAE,IAAI,KAAK;AAC1C,QAAM,OAAO,QAAQ,WACjB,GAAG,QAAQ,QAAQ,IAAI,GAAG,KAC1B,GAAG,OAAO,WAAW,CAAC,IAAI,GAAG;AACjC,SAAO,QAAQ,SAAS,GAAG,QAAQ,MAAM,IAAI,IAAI,KAAK;AACxD;AAEO,SAAS,WACd,MACA,UAAyB,CAAC,GACH;AACvB,QAAM,UAAU,mBAAmB;AACnC,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,OAAO,UAAU,MAAM,OAAO;AACpC,UAAM,aAAa,IAAI,SAAS,IAAI;AACpC,UAAM,OAAO,qBAAqB,YAAY,IAAI;AAElD,SAAK;AAAA,MACH;AAAA,MACA,CAAC,aAAiC;AAChC,YAAI,QAAQ,YAAY;AACtB,gBAAM,UAAU,KAAK;AAAA,YAClB,SAAS,mBAAmB,SAAS,aAAc;AAAA,UACtD;AACA,kBAAQ,WAAW,OAAO;AAAA,QAC5B;AAAA,MACF;AAAA,MACA,CAAC,UAAU,OAAO,KAAK;AAAA,MACvB,YAAY;AACV,cAAM,MAAM,MAAM,eAAe,KAAK,SAAS,GAAG;AAClD,gBAAQ,EAAE,KAAK,KAAK,CAAC;AAAA,MACvB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEA,eAAsB,WAAW,MAA6B;AAC5D,QAAM,UAAU,mBAAmB;AACnC,QAAM,aAAa,IAAI,SAAS,IAAI,CAAC;AACvC;AAEA,eAAsB,WAAW,MAA+B;AAC9D,QAAM,UAAU,mBAAmB;AACnC,SAAO,eAAe,IAAI,SAAS,IAAI,CAAC;AAC1C;","names":[]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@codefire/firebase-react",
+  "version": "1.0.1",
+  "description": "Plug-and-play Firebase utilities for Firestore and Storage in React/frontend projects",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./firestore": {
+      "types": "./dist/firestore/index.d.ts",
+      "import": "./dist/firestore/index.js",
+      "require": "./dist/firestore/index.cjs"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "import": "./dist/storage/index.js",
+      "require": "./dist/storage/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "peerDependencies": {
+    "firebase": ">=10.0.0"
+  },
+  "devDependencies": {
+    "firebase": "^12.10.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "keywords": [
+    "firebase",
+    "firestore",
+    "storage",
+    "react"
+  ],
+  "license": "MIT"
+}