@umituz/web-firebase 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,96 @@
+import { FirebaseApp, FirebaseOptions } from 'firebase/app';
+import { Auth, UserCredential } from 'firebase/auth';
+import { Firestore, DocumentData, CollectionReference, QueryConstraint } from 'firebase/firestore';
+import { FirebaseStorage } from 'firebase/storage';
+import { Functions } from 'firebase/functions';
+import * as _firebase_firestore from '@firebase/firestore';
+
+/**
+ * Firebase Entity Types
+ */
+type FirebaseTimestamp = {
+    toDate(): Date;
+} | Date;
+interface FirebaseUser {
+    uid: string;
+    email: string | null;
+    displayName: string | null;
+    photoURL: string | null;
+    emailVerified: boolean;
+}
+
+/**
+ * Base Repository Interface
+ */
+interface IBaseRepository<T> {
+    getById(id: string, parentPath?: string): Promise<T | null>;
+    getAll(constraints?: any[], parentPath?: string): Promise<T[]>;
+    create(id: string, data: Omit<T, 'id'>, parentPath?: string): Promise<void>;
+    update(id: string, data: Partial<T>, parentPath?: string): Promise<void>;
+    delete(id: string, parentPath?: string): Promise<void>;
+}
+
+/**
+ * Firebase Service Infrastructure
+ * @description Initialization and instance management for Firebase
+ */
+interface FirebaseInstances {
+    app: FirebaseApp;
+    auth: Auth;
+    db: Firestore;
+    storage: FirebaseStorage;
+    functions: Functions;
+}
+declare function initializeFirebase(config: FirebaseOptions, appName?: string): FirebaseInstances;
+
+/**
+ * Firestore Repository Implementation
+ * @description Generic CRUD operations for Firestore collections
+ */
+declare class FirestoreRepository<T extends DocumentData> implements IBaseRepository<T> {
+    protected db: Firestore;
+    protected collectionName: string;
+    constructor(db: Firestore, collectionName: string);
+    protected getCollection(parentPath?: string): CollectionReference<T>;
+    protected getDocRef(id: string, parentPath?: string): _firebase_firestore.DocumentReference<DocumentData, DocumentData>;
+    getById(id: string, parentPath?: string): Promise<T | null>;
+    getAll(constraints?: QueryConstraint[], parentPath?: string): Promise<T[]>;
+    create(id: string, data: Omit<T, 'id'>, parentPath?: string): Promise<void>;
+    update(id: string, data: Partial<T>, parentPath?: string): Promise<void>;
+    delete(id: string, parentPath?: string): Promise<void>;
+}
+
+/**
+ * Firebase Storage Utils
+ * @description Upload and delete helpers for Firebase Storage
+ */
+interface UploadResult {
+    url: string;
+    path: string;
+}
+declare function uploadFile(storage: FirebaseStorage, path: string, file: File | Blob): Promise<UploadResult>;
+declare function uploadBase64(storage: FirebaseStorage, path: string, base64: string, mimeType?: string): Promise<UploadResult>;
+declare function deleteFile(storage: FirebaseStorage, path: string): Promise<void>;
+
+/**
+ * useFirebaseAuth Hook
+ * @description Hook to manage Firebase authentication state and operations
+ */
+interface UseFirebaseAuthOptions {
+    onUserChange?: (user: FirebaseUser | null) => void;
+}
+interface UseFirebaseAuthReturn {
+    user: FirebaseUser | null;
+    loading: boolean;
+    isAuthenticated: boolean;
+    signIn(email: string, password: string): Promise<UserCredential>;
+    signUp(email: string, password: string, name?: string): Promise<UserCredential>;
+    signOut(): Promise<void>;
+    updateUserProfile(name: string, photoURL?: string): Promise<void>;
+    updateUserPassword(newPassword: string): Promise<void>;
+    resetPassword(email: string): Promise<void>;
+    getIdToken(): Promise<string>;
+}
+declare function useFirebaseAuth(auth: Auth, options?: UseFirebaseAuthOptions): UseFirebaseAuthReturn;
+
+export { type FirebaseInstances, type FirebaseTimestamp, type FirebaseUser, FirestoreRepository, type IBaseRepository, type UploadResult, type UseFirebaseAuthOptions, type UseFirebaseAuthReturn, deleteFile, initializeFirebase, uploadBase64, uploadFile, useFirebaseAuth };

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+import { FirebaseApp, FirebaseOptions } from 'firebase/app';
+import { Auth, UserCredential } from 'firebase/auth';
+import { Firestore, DocumentData, CollectionReference, QueryConstraint } from 'firebase/firestore';
+import { FirebaseStorage } from 'firebase/storage';
+import { Functions } from 'firebase/functions';
+import * as _firebase_firestore from '@firebase/firestore';
+
+/**
+ * Firebase Entity Types
+ */
+type FirebaseTimestamp = {
+    toDate(): Date;
+} | Date;
+interface FirebaseUser {
+    uid: string;
+    email: string | null;
+    displayName: string | null;
+    photoURL: string | null;
+    emailVerified: boolean;
+}
+
+/**
+ * Base Repository Interface
+ */
+interface IBaseRepository<T> {
+    getById(id: string, parentPath?: string): Promise<T | null>;
+    getAll(constraints?: any[], parentPath?: string): Promise<T[]>;
+    create(id: string, data: Omit<T, 'id'>, parentPath?: string): Promise<void>;
+    update(id: string, data: Partial<T>, parentPath?: string): Promise<void>;
+    delete(id: string, parentPath?: string): Promise<void>;
+}
+
+/**
+ * Firebase Service Infrastructure
+ * @description Initialization and instance management for Firebase
+ */
+interface FirebaseInstances {
+    app: FirebaseApp;
+    auth: Auth;
+    db: Firestore;
+    storage: FirebaseStorage;
+    functions: Functions;
+}
+declare function initializeFirebase(config: FirebaseOptions, appName?: string): FirebaseInstances;
+
+/**
+ * Firestore Repository Implementation
+ * @description Generic CRUD operations for Firestore collections
+ */
+declare class FirestoreRepository<T extends DocumentData> implements IBaseRepository<T> {
+    protected db: Firestore;
+    protected collectionName: string;
+    constructor(db: Firestore, collectionName: string);
+    protected getCollection(parentPath?: string): CollectionReference<T>;
+    protected getDocRef(id: string, parentPath?: string): _firebase_firestore.DocumentReference<DocumentData, DocumentData>;
+    getById(id: string, parentPath?: string): Promise<T | null>;
+    getAll(constraints?: QueryConstraint[], parentPath?: string): Promise<T[]>;
+    create(id: string, data: Omit<T, 'id'>, parentPath?: string): Promise<void>;
+    update(id: string, data: Partial<T>, parentPath?: string): Promise<void>;
+    delete(id: string, parentPath?: string): Promise<void>;
+}
+
+/**
+ * Firebase Storage Utils
+ * @description Upload and delete helpers for Firebase Storage
+ */
+interface UploadResult {
+    url: string;
+    path: string;
+}
+declare function uploadFile(storage: FirebaseStorage, path: string, file: File | Blob): Promise<UploadResult>;
+declare function uploadBase64(storage: FirebaseStorage, path: string, base64: string, mimeType?: string): Promise<UploadResult>;
+declare function deleteFile(storage: FirebaseStorage, path: string): Promise<void>;
+
+/**
+ * useFirebaseAuth Hook
+ * @description Hook to manage Firebase authentication state and operations
+ */
+interface UseFirebaseAuthOptions {
+    onUserChange?: (user: FirebaseUser | null) => void;
+}
+interface UseFirebaseAuthReturn {
+    user: FirebaseUser | null;
+    loading: boolean;
+    isAuthenticated: boolean;
+    signIn(email: string, password: string): Promise<UserCredential>;
+    signUp(email: string, password: string, name?: string): Promise<UserCredential>;
+    signOut(): Promise<void>;
+    updateUserProfile(name: string, photoURL?: string): Promise<void>;
+    updateUserPassword(newPassword: string): Promise<void>;
+    resetPassword(email: string): Promise<void>;
+    getIdToken(): Promise<string>;
+}
+declare function useFirebaseAuth(auth: Auth, options?: UseFirebaseAuthOptions): UseFirebaseAuthReturn;
+
+export { type FirebaseInstances, type FirebaseTimestamp, type FirebaseUser, FirestoreRepository, type IBaseRepository, type UploadResult, type UseFirebaseAuthOptions, type UseFirebaseAuthReturn, deleteFile, initializeFirebase, uploadBase64, uploadFile, useFirebaseAuth };

package/dist/index.js

@@ -0,0 +1,194 @@
+"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 index_exports = {};
+__export(index_exports, {
+  FirestoreRepository: () => FirestoreRepository,
+  deleteFile: () => deleteFile,
+  initializeFirebase: () => initializeFirebase,
+  uploadBase64: () => uploadBase64,
+  uploadFile: () => uploadFile,
+  useFirebaseAuth: () => useFirebaseAuth
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/infrastructure/services/firebase.service.ts
+var import_app = require("firebase/app");
+var import_auth = require("firebase/auth");
+var import_firestore = require("firebase/firestore");
+var import_storage = require("firebase/storage");
+var import_functions = require("firebase/functions");
+function initializeFirebase(config, appName) {
+  const existing = (0, import_app.getApps)().find((a) => a.name === (appName ?? "[DEFAULT]"));
+  const app = existing ?? (0, import_app.initializeApp)(config, appName);
+  return {
+    app,
+    auth: (0, import_auth.getAuth)(app),
+    db: (0, import_firestore.getFirestore)(app),
+    storage: (0, import_storage.getStorage)(app),
+    functions: (0, import_functions.getFunctions)(app)
+  };
+}
+
+// src/infrastructure/services/firestore.repository.ts
+var import_firestore2 = require("firebase/firestore");
+var FirestoreRepository = class {
+  constructor(db, collectionName) {
+    this.db = db;
+    this.collectionName = collectionName;
+  }
+  getCollection(parentPath) {
+    const fullPath = parentPath ? `${parentPath}/${this.collectionName}` : this.collectionName;
+    return (0, import_firestore2.collection)(this.db, fullPath);
+  }
+  getDocRef(id, parentPath) {
+    const fullPath = parentPath ? `${parentPath}/${this.collectionName}` : this.collectionName;
+    return (0, import_firestore2.doc)(this.db, fullPath, id);
+  }
+  async getById(id, parentPath) {
+    const snap = await (0, import_firestore2.getDoc)(this.getDocRef(id, parentPath));
+    return snap.exists() ? { id: snap.id, ...snap.data() } : null;
+  }
+  async getAll(constraints = [], parentPath) {
+    const q = (0, import_firestore2.query)(this.getCollection(parentPath), ...constraints);
+    const snap = await (0, import_firestore2.getDocs)(q);
+    return snap.docs.map((d) => ({ id: d.id, ...d.data() }));
+  }
+  async create(id, data, parentPath) {
+    await (0, import_firestore2.setDoc)(this.getDocRef(id, parentPath), {
+      ...data,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
+  async update(id, data, parentPath) {
+    await (0, import_firestore2.updateDoc)(this.getDocRef(id, parentPath), {
+      ...data,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
+  async delete(id, parentPath) {
+    await (0, import_firestore2.deleteDoc)(this.getDocRef(id, parentPath));
+  }
+};
+
+// src/infrastructure/utils/storage.util.ts
+var import_storage2 = require("firebase/storage");
+async function uploadFile(storage, path, file) {
+  const storageRef = (0, import_storage2.ref)(storage, path);
+  await (0, import_storage2.uploadBytes)(storageRef, file);
+  const url = await (0, import_storage2.getDownloadURL)(storageRef);
+  return { url, path };
+}
+async function uploadBase64(storage, path, base64, mimeType = "image/jpeg") {
+  const storageRef = (0, import_storage2.ref)(storage, path);
+  const dataUrl = base64.startsWith("data:") ? base64 : `data:${mimeType};base64,${base64}`;
+  await (0, import_storage2.uploadString)(storageRef, dataUrl, "data_url");
+  const url = await (0, import_storage2.getDownloadURL)(storageRef);
+  return { url, path };
+}
+async function deleteFile(storage, path) {
+  await (0, import_storage2.deleteObject)((0, import_storage2.ref)(storage, path));
+}
+
+// src/presentation/hooks/useFirebaseAuth.ts
+var import_react = require("react");
+var import_auth2 = require("firebase/auth");
+function mapUser(u) {
+  return {
+    uid: u.uid,
+    email: u.email,
+    displayName: u.displayName,
+    photoURL: u.photoURL,
+    emailVerified: u.emailVerified
+  };
+}
+function useFirebaseAuth(auth, options) {
+  const [user, setUser] = (0, import_react.useState)(null);
+  const [loading, setLoading] = (0, import_react.useState)(true);
+  (0, import_react.useEffect)(() => {
+    const unsub = (0, import_auth2.onAuthStateChanged)(auth, (firebaseUser) => {
+      const mapped = firebaseUser ? mapUser(firebaseUser) : null;
+      setUser(mapped);
+      setLoading(false);
+      options?.onUserChange?.(mapped);
+    });
+    return unsub;
+  }, [auth, options]);
+  const signIn = (0, import_react.useCallback)(
+    (email, password) => (0, import_auth2.signInWithEmailAndPassword)(auth, email, password),
+    [auth]
+  );
+  const signUp = (0, import_react.useCallback)(
+    async (email, password, name) => {
+      const cred = await (0, import_auth2.createUserWithEmailAndPassword)(auth, email, password);
+      if (name && cred.user) await (0, import_auth2.updateProfile)(cred.user, { displayName: name });
+      return cred;
+    },
+    [auth]
+  );
+  const signOut = (0, import_react.useCallback)(() => (0, import_auth2.signOut)(auth), [auth]);
+  const updateUserProfile = (0, import_react.useCallback)(
+    async (name, photoURL) => {
+      if (!auth.currentUser) throw new Error("No authenticated user");
+      await (0, import_auth2.updateProfile)(auth.currentUser, {
+        displayName: name,
+        ...photoURL !== void 0 && { photoURL }
+      });
+    },
+    [auth]
+  );
+  const updateUserPassword = (0, import_react.useCallback)(
+    async (newPassword) => {
+      if (!auth.currentUser) throw new Error("No authenticated user");
+      await (0, import_auth2.updatePassword)(auth.currentUser, newPassword);
+    },
+    [auth]
+  );
+  const resetPassword = (0, import_react.useCallback)(
+    (email) => (0, import_auth2.sendPasswordResetEmail)(auth, email),
+    [auth]
+  );
+  const getIdToken = (0, import_react.useCallback)(async () => {
+    if (!auth.currentUser) throw new Error("No authenticated user");
+    return auth.currentUser.getIdToken();
+  }, [auth]);
+  return {
+    user,
+    loading,
+    isAuthenticated: !!user,
+    signIn,
+    signUp,
+    signOut,
+    updateUserProfile,
+    updateUserPassword,
+    resetPassword,
+    getIdToken
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FirestoreRepository,
+  deleteFile,
+  initializeFirebase,
+  uploadBase64,
+  uploadFile,
+  useFirebaseAuth
+});

package/dist/index.mjs

@@ -0,0 +1,185 @@
+// src/infrastructure/services/firebase.service.ts
+import { initializeApp, getApps } from "firebase/app";
+import { getAuth } from "firebase/auth";
+import { getFirestore } from "firebase/firestore";
+import { getStorage } from "firebase/storage";
+import { getFunctions } from "firebase/functions";
+function initializeFirebase(config, appName) {
+  const existing = getApps().find((a) => a.name === (appName ?? "[DEFAULT]"));
+  const app = existing ?? initializeApp(config, appName);
+  return {
+    app,
+    auth: getAuth(app),
+    db: getFirestore(app),
+    storage: getStorage(app),
+    functions: getFunctions(app)
+  };
+}
+
+// src/infrastructure/services/firestore.repository.ts
+import {
+  collection,
+  doc,
+  getDoc,
+  getDocs,
+  setDoc,
+  updateDoc,
+  deleteDoc,
+  query
+} from "firebase/firestore";
+var FirestoreRepository = class {
+  constructor(db, collectionName) {
+    this.db = db;
+    this.collectionName = collectionName;
+  }
+  getCollection(parentPath) {
+    const fullPath = parentPath ? `${parentPath}/${this.collectionName}` : this.collectionName;
+    return collection(this.db, fullPath);
+  }
+  getDocRef(id, parentPath) {
+    const fullPath = parentPath ? `${parentPath}/${this.collectionName}` : this.collectionName;
+    return doc(this.db, fullPath, id);
+  }
+  async getById(id, parentPath) {
+    const snap = await getDoc(this.getDocRef(id, parentPath));
+    return snap.exists() ? { id: snap.id, ...snap.data() } : null;
+  }
+  async getAll(constraints = [], parentPath) {
+    const q = query(this.getCollection(parentPath), ...constraints);
+    const snap = await getDocs(q);
+    return snap.docs.map((d) => ({ id: d.id, ...d.data() }));
+  }
+  async create(id, data, parentPath) {
+    await setDoc(this.getDocRef(id, parentPath), {
+      ...data,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
+  async update(id, data, parentPath) {
+    await updateDoc(this.getDocRef(id, parentPath), {
+      ...data,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
+  async delete(id, parentPath) {
+    await deleteDoc(this.getDocRef(id, parentPath));
+  }
+};
+
+// src/infrastructure/utils/storage.util.ts
+import {
+  ref,
+  uploadBytes,
+  uploadString,
+  getDownloadURL,
+  deleteObject
+} from "firebase/storage";
+async function uploadFile(storage, path, file) {
+  const storageRef = ref(storage, path);
+  await uploadBytes(storageRef, file);
+  const url = await getDownloadURL(storageRef);
+  return { url, path };
+}
+async function uploadBase64(storage, path, base64, mimeType = "image/jpeg") {
+  const storageRef = ref(storage, path);
+  const dataUrl = base64.startsWith("data:") ? base64 : `data:${mimeType};base64,${base64}`;
+  await uploadString(storageRef, dataUrl, "data_url");
+  const url = await getDownloadURL(storageRef);
+  return { url, path };
+}
+async function deleteFile(storage, path) {
+  await deleteObject(ref(storage, path));
+}
+
+// src/presentation/hooks/useFirebaseAuth.ts
+import { useState, useEffect, useCallback } from "react";
+import {
+  onAuthStateChanged,
+  signInWithEmailAndPassword,
+  createUserWithEmailAndPassword,
+  signOut as firebaseSignOut,
+  updateProfile,
+  updatePassword,
+  sendPasswordResetEmail
+} from "firebase/auth";
+function mapUser(u) {
+  return {
+    uid: u.uid,
+    email: u.email,
+    displayName: u.displayName,
+    photoURL: u.photoURL,
+    emailVerified: u.emailVerified
+  };
+}
+function useFirebaseAuth(auth, options) {
+  const [user, setUser] = useState(null);
+  const [loading, setLoading] = useState(true);
+  useEffect(() => {
+    const unsub = onAuthStateChanged(auth, (firebaseUser) => {
+      const mapped = firebaseUser ? mapUser(firebaseUser) : null;
+      setUser(mapped);
+      setLoading(false);
+      options?.onUserChange?.(mapped);
+    });
+    return unsub;
+  }, [auth, options]);
+  const signIn = useCallback(
+    (email, password) => signInWithEmailAndPassword(auth, email, password),
+    [auth]
+  );
+  const signUp = useCallback(
+    async (email, password, name) => {
+      const cred = await createUserWithEmailAndPassword(auth, email, password);
+      if (name && cred.user) await updateProfile(cred.user, { displayName: name });
+      return cred;
+    },
+    [auth]
+  );
+  const signOut = useCallback(() => firebaseSignOut(auth), [auth]);
+  const updateUserProfile = useCallback(
+    async (name, photoURL) => {
+      if (!auth.currentUser) throw new Error("No authenticated user");
+      await updateProfile(auth.currentUser, {
+        displayName: name,
+        ...photoURL !== void 0 && { photoURL }
+      });
+    },
+    [auth]
+  );
+  const updateUserPassword = useCallback(
+    async (newPassword) => {
+      if (!auth.currentUser) throw new Error("No authenticated user");
+      await updatePassword(auth.currentUser, newPassword);
+    },
+    [auth]
+  );
+  const resetPassword = useCallback(
+    (email) => sendPasswordResetEmail(auth, email),
+    [auth]
+  );
+  const getIdToken = useCallback(async () => {
+    if (!auth.currentUser) throw new Error("No authenticated user");
+    return auth.currentUser.getIdToken();
+  }, [auth]);
+  return {
+    user,
+    loading,
+    isAuthenticated: !!user,
+    signIn,
+    signUp,
+    signOut,
+    updateUserProfile,
+    updateUserPassword,
+    resetPassword,
+    getIdToken
+  };
+}
+export {
+  FirestoreRepository,
+  deleteFile,
+  initializeFirebase,
+  uploadBase64,
+  uploadFile,
+  useFirebaseAuth
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@umituz/web-firebase",
+  "version": "1.0.0",
+  "description": "Universal Firebase utilities for web applications",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./domain": "./src/domain/index.ts",
+    "./infrastructure": "./src/infrastructure/index.ts",
+    "./presentation": "./src/presentation/index.ts"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean --external react --external firebase --external firebase/app --external firebase/auth --external firebase/firestore --external firebase/storage --external firebase/functions",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch --external react --external firebase",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "firebase",
+    "firestore",
+    "auth",
+    "storage",
+    "react",
+    "web"
+  ],
+  "author": "Antigravity",
+  "license": "MIT",
+  "peerDependencies": {
+    "firebase": ">=10",
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "firebase": "^11.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}