@donotdev/firebase 0.0.1

package/dist/client/firestore.d.ts

@@ -0,0 +1,147 @@
+/**
+ * @fileoverview Firestore Client SDK Exports
+ * @description Re-exports all Firestore client functions with framework integration. Provides direct access to Firestore client SDK functions while maintaining the framework's separation between client-safe and server-only operations. All functions are browser-safe and can be used in client-side applications. Features direct Firestore SDK access, framework data transformation utilities integration, type-safe operations with proper error handling, real-time subscriptions support, and query building and filtering capabilities.
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import { type Firestore } from 'firebase/firestore';
+/**
+ * Get Firestore instance with automatic emulator connection
+ *
+ * Ensures Firebase app is initialized and returns Firestore instance.
+ * Handles emulator connection automatically in development.
+ * Safe to call from any consumer - handles initialization order automatically.
+ *
+ * @returns Promise resolving to Firestore instance
+ * @throws Error if initialization fails
+ *
+ * @example
+ * ```typescript
+ * const firestore = await getFirebaseFirestore();
+ * const docRef = doc(firestore, 'users', 'user123');
+ * ```
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export declare function getFirebaseFirestore(): Promise<Firestore>;
+export { getFirestore } from 'firebase/firestore';
+/**
+ * Document reference operations
+ */
+export { doc, getDoc, getDocs, setDoc, updateDoc, deleteDoc, addDoc, } from 'firebase/firestore';
+/**
+ * Collection operations
+ */
+export { collection, collectionGroup } from 'firebase/firestore';
+/**
+ * Query operations
+ */
+export { query, where, orderBy, limit, limitToLast, startAt, startAfter, endAt, endBefore, } from 'firebase/firestore';
+/**
+ * Real-time subscriptions
+ */
+export { onSnapshot, onSnapshotsInSync } from 'firebase/firestore';
+/**
+ * Batch operations
+ */
+export { writeBatch, runTransaction } from 'firebase/firestore';
+/**
+ * Server timestamp
+ */
+export { serverTimestamp, increment, arrayUnion, arrayRemove, } from 'firebase/firestore';
+/**
+ * Field value operations
+ * Note: Timestamp type is defined in @donotdev/core, this exports the Firebase SDK Timestamp class
+ */
+export { FieldValue, GeoPoint } from 'firebase/firestore';
+export { Timestamp as FirestoreTimestampClass } from 'firebase/firestore';
+/**
+ * Transform Firestore data to application format
+ * Converts Firestore Timestamps to ISO strings and handles other type conversions
+ *
+ * @param data - Raw Firestore document data
+ * @returns Transformed data ready for application use
+ *
+ * @example
+ * ```typescript
+ * const snapshot = await getDoc(docRef);
+ * const appData = transformFirestoreData(snapshot.data());
+ * ```
+ */
+export { transformFirestoreData } from '../shared/transform';
+/**
+ * Convert ISO date strings to Date objects for schema validation
+ * Schema validation expects Date objects for timestamp fields, not ISO strings.
+ * This function recursively converts ISO date strings back to Date objects.
+ *
+ * @param data - Data containing ISO date strings
+ * @returns Data with ISO strings converted to Date objects
+ *
+ * @example
+ * ```typescript
+ * const data = { createdAt: '2025-12-27T23:13:00.727Z' };
+ * const converted = convertISOStringsToDates(data);
+ * // { createdAt: Date('2025-12-27T23:13:00.727Z') }
+ * ```
+ */
+export { convertISOStringsToDates } from '../shared/transform';
+/**
+ * Prepare application data for Firestore storage
+ * Converts ISO strings to Firestore Timestamps and handles other type conversions
+ *
+ * @param data - Application data to store
+ * @returns Data formatted for Firestore storage
+ *
+ * @example
+ * ```typescript
+ * const firestoreData = prepareForFirestore(userData);
+ * await setDoc(docRef, firestoreData);
+ * ```
+ */
+export { prepareForFirestore } from '../shared/transform';
+/**
+ * Convert Date or ISO string to Firestore Timestamp
+ *
+ * @param date - Date object or ISO string
+ * @returns Firestore Timestamp
+ *
+ * @example
+ * ```typescript
+ * const timestamp = toTimestamp(new Date());
+ * ```
+ */
+export { toTimestamp } from '../shared/transform';
+/**
+ * Convert DateValue to ISO string
+ * Note: For generic Date conversion, use toISOString from @donotdev/core
+ *
+ * @param dateValue - Date, Timestamp, or ISO string
+ * @returns ISO string representation
+ *
+ * @example
+ * ```typescript
+ * const isoString = firestoreToISOString(timestamp);
+ * ```
+ */
+export { firestoreToISOString } from '../shared/transform';
+/**
+ * Create partial update object for Firestore
+ *
+ * @param updates - Partial data updates
+ * @returns Firestore-compatible update object
+ *
+ * @example
+ * ```typescript
+ * const updates = createFirestorePartialUpdate({ name: 'New Name' });
+ * await updateDoc(docRef, updates);
+ * ```
+ */
+export { createFirestorePartialUpdate } from '../shared/transform';
+/**
+ * Firestore types for TypeScript integration
+ */
+export type { DocumentData, DocumentSnapshot, QuerySnapshot, QueryDocumentSnapshot, DocumentReference, CollectionReference, Query, QueryConstraint, WhereFilterOp, OrderByDirection, FirestoreError, Unsubscribe, SnapshotOptions, DocumentChange, DocumentChangeType, Timestamp as FirestoreTimestamp, GeoPoint as FirestoreGeoPoint, FieldValue as FirestoreFieldValue, } from 'firebase/firestore';
+//# sourceMappingURL=firestore.d.ts.map

package/dist/client/firestore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.d.ts","sourceRoot":"","sources":["../../src/client/firestore.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAa5B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,SAAS,CAAC,CAqB/D;AAOD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,OAAO,EACL,GAAG,EACH,MAAM,EACN,OAAO,EACP,MAAM,EACN,SAAS,EACT,SAAS,EACT,MAAM,GACP,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;GAEG;AACH,OAAO,EACL,KAAK,EACL,KAAK,EACL,OAAO,EACP,KAAK,EACL,WAAW,EACX,OAAO,EACP,UAAU,EACV,KAAK,EACL,SAAS,GACV,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;GAEG;AACH,OAAO,EACL,eAAe,EACf,SAAS,EACT,UAAU,EACV,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,SAAS,IAAI,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAM1E;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAMnE;;GAEG;AACH,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,EACL,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,SAAS,IAAI,kBAAkB,EAC/B,QAAQ,IAAI,iBAAiB,EAC7B,UAAU,IAAI,mBAAmB,GAClC,MAAM,oBAAoB,CAAC"}

package/dist/client/firestore.js

@@ -0,0 +1 @@
+import{getFirestore as m,connectFirestoreEmulator as p}from"firebase/firestore";import{getPlatformEnvVar as r}from"@donotdev/core";import{getFirebaseSDK as c}from"./sdk";let e=null,t=!1;async function F(){if(e)return e;const o=await c().getApp();e=m(o);const s=r("NODE_ENV")==="development",a=r("USE_FIREBASE_EMULATOR")==="true";if(s&&a&&!t){const n=r("FIREBASE_EMULATOR_HOST")||"localhost",i=parseInt(r("FIREBASE_FIRESTORE_EMULATOR_PORT")||"8080");p(e,n,i),t=!0}return e}import{getFirestore as S}from"firebase/firestore";import{doc as D,getDoc as g,getDocs as A,setDoc as R,updateDoc as I,deleteDoc as O,addDoc as _}from"firebase/firestore";import{collection as v,collectionGroup as y}from"firebase/firestore";import{query as U,where as L,orderBy as P,limit as w,limitToLast as M,startAt as V,startAfter as b,endAt as k,endBefore as C}from"firebase/firestore";import{onSnapshot as N,onSnapshotsInSync as q}from"firebase/firestore";import{writeBatch as K,runTransaction as j}from"firebase/firestore";import{serverTimestamp as J,increment as Q,arrayUnion as W,arrayRemove as X}from"firebase/firestore";import{FieldValue as Z,GeoPoint as $}from"firebase/firestore";import{Timestamp as re}from"firebase/firestore";import{transformFirestoreData as oe}from"../shared/transform";import{convertISOStringsToDates as ae}from"../shared/transform";import{prepareForFirestore as ie}from"../shared/transform";import{toTimestamp as pe}from"../shared/transform";import{firestoreToISOString as fe}from"../shared/transform";import{createFirestorePartialUpdate as Ee}from"../shared/transform";export{Z as FieldValue,re as FirestoreTimestampClass,$ as GeoPoint,_ as addDoc,X as arrayRemove,W as arrayUnion,v as collection,y as collectionGroup,ae as convertISOStringsToDates,Ee as createFirestorePartialUpdate,O as deleteDoc,D as doc,k as endAt,C as endBefore,fe as firestoreToISOString,g as getDoc,A as getDocs,F as getFirebaseFirestore,S as getFirestore,Q as increment,w as limit,M as limitToLast,N as onSnapshot,q as onSnapshotsInSync,P as orderBy,ie as prepareForFirestore,U as query,j as runTransaction,J as serverTimestamp,R as setDoc,b as startAfter,V as startAt,pe as toTimestamp,oe as transformFirestoreData,I as updateDoc,L as where,K as writeBatch};

package/dist/client/functions.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Firebase Functions Client SDK
+ * @description Framework-integrated Firebase Functions client utilities. Provides singleton access to Firebase Functions with automatic app initialization and emulator support.
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import { type Functions } from 'firebase/functions';
+/**
+ * Get Firebase Functions instance
+ *
+ * Ensures Firebase app is initialized and returns Functions instance.
+ * Handles emulator connection automatically in development.
+ * Safe to call from any consumer - handles initialization order automatically.
+ *
+ * @param region - Functions region (defaults to FIREBASE_FUNCTIONS_REGION or 'europe-west1')
+ * @returns Promise resolving to Functions instance
+ * @throws Error if initialization fails
+ *
+ * @example
+ * ```typescript
+ * const functions = await getFirebaseFunctions('europe-west1');
+ * const callable = httpsCallable(functions, 'myFunction');
+ * ```
+ */
+export declare function getFirebaseFunctions(region?: string): Promise<Functions>;
+export { httpsCallable, type HttpsCallable, type HttpsCallableOptions, type HttpsCallableResult, } from 'firebase/functions';
+//# sourceMappingURL=functions.d.ts.map

package/dist/client/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../src/client/functions.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAY5B;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,CA4DpB;AAGD,OAAO,EACL,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/client/functions.js

@@ -0,0 +1 @@
+import{getFunctions as d,connectFunctionsEmulator as m}from"firebase/functions";import{getPlatformEnvVar as e}from"@donotdev/core";import{getFirebaseSDK as p}from"./sdk";const n=new Set;async function O(a){const r=await p().getApp(),s=a||e("FIREBASE_FUNCTIONS_REGION")||"europe-west1",c=d(r,s),i=e("NODE_ENV")==="development",l=e("USE_FIREBASE_EMULATOR")==="true";if(i&&l){const o=`${r.name}_${s}`;if(!n.has(o)){const u=e("FIREBASE_EMULATOR_HOST")||"localhost",E=e("FIREBASE_FUNCTIONS_EMULATOR_PORT")||"5001";try{m(c,u,parseInt(E)),n.add(o),typeof window<"u"}catch(t){(t instanceof Error?t.message:String(t)).includes("already")&&typeof window<"u",n.add(o)}}}return c}import{httpsCallable as A}from"firebase/functions";export{O as getFirebaseFunctions,A as httpsCallable};

package/dist/client/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Firebase client SDK barrel exports
+ * @description Browser-safe Firebase operations using client SDK. Exports Auth SDK and Firestore SDK functions for client-side use.
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export * from './sdk';
+export * from './firestore';
+export * from './functions';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAGH,cAAc,OAAO,CAAC;AAGtB,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC"}

package/dist/client/index.js

@@ -0,0 +1 @@
+export*from"./sdk";export*from"./firestore";export*from"./functions";