@lpdjs/firestore-repo-service 2.6.4 → 2.6.6

package/dist/index.d.cts

@@ -110,7 +110,7 @@ declare function normalizeTimestamps<T>(value: T): T;
  *   }),
  * };
  *
- * const repos = createRepositoryMapping(db, mapping);
+ * const repos = createRepositoryMapping(() => db, mapping);
  * ```
  */
 declare function createRepositoryConfig<TSchema extends z.ZodObject<any>>(schema: TSchema): <const TForeignKeys extends readonly (keyof z.infer<TSchema>)[], const TQueryKeys extends readonly (keyof z.infer<TSchema>)[], const TIsGroup extends boolean, const TDocumentKey extends keyof z.infer<TSchema>, const TPathKey extends keyof z.infer<TSchema> | undefined = undefined, const TCreatedKey extends keyof z.infer<TSchema> | undefined = undefined, const TUpdatedKey extends keyof z.infer<TSchema> | undefined = undefined, const THistoryEnabled extends boolean = false, TRefCb = undefined>(config: {
@@ -166,7 +166,7 @@ type ResolveRelation<TMapping, TRelationConfig> = TRelationConfig extends {
  *   }
  * });
  *
- * const repos = createRepositoryMapping(db, mappingWithRelations);
+ * const repos = createRepositoryMapping(() => db, mappingWithRelations);
  * ```
  */
 declare function buildRepositoryRelations<TMapping extends Record<string, any>, const TRelations extends {
@@ -189,23 +189,39 @@ declare function buildRepositoryRelations<TMapping extends Record<string, any>,
  * @template T - Record of repository configurations
  */
 declare class RepositoryMapping<T extends Record<string, any>> {
-    private db;
-    private repositoryCache;
+    private dbFactory;
+    private _db;
     private mapping;
     private allRepositories;
+    private initialized;
     /**
      * Creates a new RepositoryMapping instance
-     * @param db - Firestore instance from firebase-admin
+     * @param dbFactory - Factory returning a Firestore instance from
+     *   firebase-admin. Invoked lazily on first repository access so
+     *   `getFirestore()` runs after `initializeApp()`.
      * @param mapping - Repository configuration mapping
      */
-    constructor(db: Firestore, mapping: T);
+    constructor(dbFactory: () => Firestore, mapping: T);
+    /**
+     * Resolve and memoize the Firestore instance. Deferred so the factory
+     * (typically `() => getFirestore()`) is only called at runtime, never
+     * during module import.
+     * @private
+     */
+    private get db();
+    /**
+     * Build every repository once, on first access, so cross-references and
+     * circular relations are wired in a single two-pass init.
+     * @private
+     */
+    private ensureInitialized;
     /**
      * Initialize all repositories in two passes to handle circular dependencies
      * @private
      */
     private initializeRepositories;
     /**
-     * Gets a repository (already initialized)
+     * Gets a repository (lazily initialized on first access)
      * @template K - Repository key
      * @param key - Repository identifier
      * @returns Configured repository instance
@@ -215,17 +231,19 @@ declare class RepositoryMapping<T extends Record<string, any>> {
 /**
  * Helper function to create a RepositoryMapping instance with full typing
  * @template T - Record of repository configurations
- * @param db - Firestore instance from firebase-admin
+ * @param dbFactory - Factory returning a Firestore instance from
+ *   firebase-admin. Invoked lazily on first repository access, so
+ *   `getFirestore()` runs after `initializeApp()` — never at import time.
  * @param mapping - Repository configurations
  * @returns RepositoryMapping instance with repository access via getters
  * @example
  * ```typescript
  * import * as admin from 'firebase-admin';
+ * import { getFirestore } from 'firebase-admin/firestore';
  *
  * admin.initializeApp();
- * const db = admin.firestore();
  *
- * const repos = createRepositoryMapping(db, {
+ * const repos = createRepositoryMapping(() => getFirestore(), {
  *   users: createRepositoryConfig<UserModel>()({
  *     path: "users",
  *     isGroup: false,
@@ -239,7 +257,7 @@ declare class RepositoryMapping<T extends Record<string, any>> {
  * const user = await repos.users.get.byDocId("123");
  * ```
  */
-declare function createRepositoryMapping<T extends Record<string, any>>(db: Firestore, mapping: T): {
+declare function createRepositoryMapping<T extends Record<string, any>>(dbFactory: () => Firestore, mapping: T): {
     [K in keyof T]: ConfiguredRepository<T[K]>;
 };
 

package/dist/index.d.ts

@@ -110,7 +110,7 @@ declare function normalizeTimestamps<T>(value: T): T;
  *   }),
  * };
  *
- * const repos = createRepositoryMapping(db, mapping);
+ * const repos = createRepositoryMapping(() => db, mapping);
  * ```
  */
 declare function createRepositoryConfig<TSchema extends z.ZodObject<any>>(schema: TSchema): <const TForeignKeys extends readonly (keyof z.infer<TSchema>)[], const TQueryKeys extends readonly (keyof z.infer<TSchema>)[], const TIsGroup extends boolean, const TDocumentKey extends keyof z.infer<TSchema>, const TPathKey extends keyof z.infer<TSchema> | undefined = undefined, const TCreatedKey extends keyof z.infer<TSchema> | undefined = undefined, const TUpdatedKey extends keyof z.infer<TSchema> | undefined = undefined, const THistoryEnabled extends boolean = false, TRefCb = undefined>(config: {
@@ -166,7 +166,7 @@ type ResolveRelation<TMapping, TRelationConfig> = TRelationConfig extends {
  *   }
  * });
  *
- * const repos = createRepositoryMapping(db, mappingWithRelations);
+ * const repos = createRepositoryMapping(() => db, mappingWithRelations);
  * ```
  */
 declare function buildRepositoryRelations<TMapping extends Record<string, any>, const TRelations extends {
@@ -189,23 +189,39 @@ declare function buildRepositoryRelations<TMapping extends Record<string, any>,
  * @template T - Record of repository configurations
  */
 declare class RepositoryMapping<T extends Record<string, any>> {
-    private db;
-    private repositoryCache;
+    private dbFactory;
+    private _db;
     private mapping;
     private allRepositories;
+    private initialized;
     /**
      * Creates a new RepositoryMapping instance
-     * @param db - Firestore instance from firebase-admin
+     * @param dbFactory - Factory returning a Firestore instance from
+     *   firebase-admin. Invoked lazily on first repository access so
+     *   `getFirestore()` runs after `initializeApp()`.
      * @param mapping - Repository configuration mapping
      */
-    constructor(db: Firestore, mapping: T);
+    constructor(dbFactory: () => Firestore, mapping: T);
+    /**
+     * Resolve and memoize the Firestore instance. Deferred so the factory
+     * (typically `() => getFirestore()`) is only called at runtime, never
+     * during module import.
+     * @private
+     */
+    private get db();
+    /**
+     * Build every repository once, on first access, so cross-references and
+     * circular relations are wired in a single two-pass init.
+     * @private
+     */
+    private ensureInitialized;
     /**
      * Initialize all repositories in two passes to handle circular dependencies
      * @private
      */
     private initializeRepositories;
     /**
-     * Gets a repository (already initialized)
+     * Gets a repository (lazily initialized on first access)
      * @template K - Repository key
      * @param key - Repository identifier
      * @returns Configured repository instance
@@ -215,17 +231,19 @@ declare class RepositoryMapping<T extends Record<string, any>> {
 /**
  * Helper function to create a RepositoryMapping instance with full typing
  * @template T - Record of repository configurations
- * @param db - Firestore instance from firebase-admin
+ * @param dbFactory - Factory returning a Firestore instance from
+ *   firebase-admin. Invoked lazily on first repository access, so
+ *   `getFirestore()` runs after `initializeApp()` — never at import time.
  * @param mapping - Repository configurations
  * @returns RepositoryMapping instance with repository access via getters
  * @example
  * ```typescript
  * import * as admin from 'firebase-admin';
+ * import { getFirestore } from 'firebase-admin/firestore';
  *
  * admin.initializeApp();
- * const db = admin.firestore();
  *
- * const repos = createRepositoryMapping(db, {
+ * const repos = createRepositoryMapping(() => getFirestore(), {
  *   users: createRepositoryConfig<UserModel>()({
  *     path: "users",
  *     isGroup: false,
@@ -239,7 +257,7 @@ declare class RepositoryMapping<T extends Record<string, any>> {
  * const user = await repos.users.get.byDocId("123");
  * ```
  */
-declare function createRepositoryMapping<T extends Record<string, any>>(db: Firestore, mapping: T): {
+declare function createRepositoryMapping<T extends Record<string, any>>(dbFactory: () => Firestore, mapping: T): {
     [K in keyof T]: ConfiguredRepository<T[K]>;
 };