@dereekb/firebase-server 13.6.6 → 13.6.7

package/index.cjs.js

@@ -3374,7 +3374,15 @@ var _obj;
 }
 
 /**
- * Creates a FirestoreContextFactory that uses the @'@google-cloud/firestore package.
+ * Pre-configured {@link FirestoreContextFactory} for Google Cloud Firestore (Admin SDK) usage.
+ *
+ * Wires the server-side Firestore drivers into the abstract {@link FirestoreContextFactory}
+ * so that collections, documents, queries, and transactions all use the Admin SDK implementation.
+ *
+ * @example
+ * ```ts
+ * const context = googleCloudFirestoreContextFactory(firestore);
+ * ```
  */ var googleCloudFirestoreContextFactory = firebase.firestoreContextFactory(googleCloudFirestoreDrivers());
 
 // MARK: Field Converters
@@ -6625,7 +6633,8 @@ exports.FirebaseServerFirestoreModule = __decorate([
     })
 ], exports.FirebaseServerFirestoreModule);
 /**
- * Nest provider module for firebase that includes the FirebaseServerFirestoreModule and provides a value for FIRESTORE_CONTEXT_TOKEN using the googleCloudFirestoreContextFactory.
+ * Nest provider module for firebase that includes the FirebaseServerFirestoreModule and provides
+ * a value for FIRESTORE_CONTEXT_TOKEN using the googleCloudFirestoreContextFactory without caching.
  */ exports.FirebaseServerFirestoreContextModule = function FirebaseServerFirestoreContextModule() {
     _class_call_check$b(this, FirebaseServerFirestoreContextModule);
 };
@@ -6649,6 +6658,48 @@ exports.FirebaseServerFirestoreContextModule = __decorate([
         ]
     })
 ], exports.FirebaseServerFirestoreContextModule);
+/**
+ * Generates NestJS {@link ModuleMetadata} for a dynamic Firestore context module
+ * that includes the {@link FirebaseServerFirestoreModule} and provides a
+ * {@link FIREBASE_FIRESTORE_CONTEXT_TOKEN} with cache support.
+ *
+ * If caching is not needed, use {@link FirebaseServerFirestoreContextModule} directly instead.
+ *
+ * @param config - Configuration including the cache factory
+ * @returns Module metadata ready for the `@Module()` decorator
+ *
+ * @example
+ * ```typescript
+ * @Module(firebaseServerFirestoreContextModuleMetadata({
+ *   firestoreContextCacheFactory: inMemoryFirestoreContextCacheFactory()
+ * }))
+ * export class AppFirestoreContextModule {}
+ * ```
+ */ function firebaseServerFirestoreContextModuleMetadata(config) {
+    var params = {
+        firestoreContextCacheFactory: config.firestoreContextCacheFactory
+    };
+    return {
+        imports: [
+            exports.FirebaseServerFirestoreModule
+        ],
+        providers: [
+            {
+                provide: FIREBASE_FIRESTORE_CONTEXT_TOKEN,
+                useFactory: function useFactory(firestore) {
+                    return googleCloudFirestoreContextFactory(firestore, params);
+                },
+                inject: [
+                    FIREBASE_FIRESTORE_TOKEN
+                ]
+            }
+        ],
+        exports: [
+            exports.FirebaseServerFirestoreModule,
+            FIREBASE_FIRESTORE_CONTEXT_TOKEN
+        ]
+    };
+}
 /**
  * Creates a NestJS provider that initializes a Firestore collections instance from the app's {@link FirestoreContext}.
  *
@@ -6677,8 +6728,13 @@ exports.FirebaseServerFirestoreContextModule = __decorate([
     ];
 }
 /**
- * Generates NestJS {@link ModuleMetadata} for an app's Firestore module, including the
- * {@link FirebaseServerFirestoreContextModule} import and the app's collections provider.
+ * Generates NestJS {@link ModuleMetadata} for an app's Firestore module, including
+ * the Firestore context module and the app's collections provider.
+ *
+ * When a {@link FirestoreContextCacheFactory} is provided via
+ * {@link ProvideAppFirestoreModuleMetadataConfig.firestoreContextCacheFactory},
+ * a dynamic context module with cache support is used instead of the default
+ * {@link FirebaseServerFirestoreContextModule}.
  *
  * @param config - The Firestore collections config plus optional additional module metadata.
  * @returns NestJS module metadata ready to be passed to the `@Module()` decorator.
@@ -6691,17 +6747,35 @@ exports.FirebaseServerFirestoreContextModule = __decorate([
  * }))
  * export class AppFirestoreModule {}
  * ```
+ *
+ * @example
+ * ```typescript
+ * // With caching
+ * @Module(appFirestoreModuleMetadata({
+ *   provide: DemoFirestoreCollections,
+ *   useFactory: (context) => new DemoFirestoreCollections(context),
+ *   firestoreContextCacheFactory: inMemoryFirestoreContextCacheFactory()
+ * }))
+ * export class AppFirestoreModule {}
+ * ```
  */ function appFirestoreModuleMetadata(config) {
-    var _config_imports, _config_exports, _config_providers;
-    return {
+    var _contextModuleMetadata_imports, _config_imports, _contextModuleMetadata_exports, _config_exports, _contextModuleMetadata_providers, _config_providers;
+    var contextModuleMetadata = config.firestoreContextCacheFactory ? firebaseServerFirestoreContextModuleMetadata({
+        firestoreContextCacheFactory: config.firestoreContextCacheFactory
+    }) : {
         imports: [
             exports.FirebaseServerFirestoreContextModule
-        ].concat(_to_consumable_array$3((_config_imports = config.imports) !== null && _config_imports !== void 0 ? _config_imports : [])),
+        ],
         exports: [
-            exports.FirebaseServerFirestoreContextModule,
+            exports.FirebaseServerFirestoreContextModule
+        ]
+    };
+    return {
+        imports: _to_consumable_array$3((_contextModuleMetadata_imports = contextModuleMetadata.imports) !== null && _contextModuleMetadata_imports !== void 0 ? _contextModuleMetadata_imports : []).concat(_to_consumable_array$3((_config_imports = config.imports) !== null && _config_imports !== void 0 ? _config_imports : [])),
+        exports: _to_consumable_array$3((_contextModuleMetadata_exports = contextModuleMetadata.exports) !== null && _contextModuleMetadata_exports !== void 0 ? _contextModuleMetadata_exports : []).concat([
             config.provide
-        ].concat(_to_consumable_array$3((_config_exports = config.exports) !== null && _config_exports !== void 0 ? _config_exports : [])),
-        providers: _to_consumable_array$3(provideAppFirestoreCollections(config)).concat(_to_consumable_array$3((_config_providers = config.providers) !== null && _config_providers !== void 0 ? _config_providers : []))
+        ], _to_consumable_array$3((_config_exports = config.exports) !== null && _config_exports !== void 0 ? _config_exports : [])),
+        providers: _to_consumable_array$3((_contextModuleMetadata_providers = contextModuleMetadata.providers) !== null && _contextModuleMetadata_providers !== void 0 ? _contextModuleMetadata_providers : []).concat(_to_consumable_array$3(provideAppFirestoreCollections(config)), _to_consumable_array$3((_config_providers = config.providers) !== null && _config_providers !== void 0 ? _config_providers : []))
     };
 }
 
@@ -10172,6 +10246,7 @@ exports.firebaseServerErrorInfo = firebaseServerErrorInfo;
 exports.firebaseServerErrorInfoCodePair = firebaseServerErrorInfoCodePair;
 exports.firebaseServerErrorInfoServerErrorCodePair = firebaseServerErrorInfoServerErrorCodePair;
 exports.firebaseServerErrorInfoServerErrorPair = firebaseServerErrorInfoServerErrorPair;
+exports.firebaseServerFirestoreContextModuleMetadata = firebaseServerFirestoreContextModuleMetadata;
 exports.firebaseServerStorageDefaultBucketIdTokenProvider = firebaseServerStorageDefaultBucketIdTokenProvider;
 exports.firebaseServerStorageModuleMetadata = firebaseServerStorageModuleMetadata;
 exports.firebaseServerValidationError = firebaseServerValidationError;

package/index.esm.js

@@ -3372,7 +3372,15 @@ var _obj;
 }
 
 /**
- * Creates a FirestoreContextFactory that uses the @'@google-cloud/firestore package.
+ * Pre-configured {@link FirestoreContextFactory} for Google Cloud Firestore (Admin SDK) usage.
+ *
+ * Wires the server-side Firestore drivers into the abstract {@link FirestoreContextFactory}
+ * so that collections, documents, queries, and transactions all use the Admin SDK implementation.
+ *
+ * @example
+ * ```ts
+ * const context = googleCloudFirestoreContextFactory(firestore);
+ * ```
  */ var googleCloudFirestoreContextFactory = firestoreContextFactory(googleCloudFirestoreDrivers());
 
 // MARK: Field Converters
@@ -6623,7 +6631,8 @@ FirebaseServerFirestoreModule = __decorate([
     })
 ], FirebaseServerFirestoreModule);
 /**
- * Nest provider module for firebase that includes the FirebaseServerFirestoreModule and provides a value for FIRESTORE_CONTEXT_TOKEN using the googleCloudFirestoreContextFactory.
+ * Nest provider module for firebase that includes the FirebaseServerFirestoreModule and provides
+ * a value for FIRESTORE_CONTEXT_TOKEN using the googleCloudFirestoreContextFactory without caching.
  */ var FirebaseServerFirestoreContextModule = function FirebaseServerFirestoreContextModule() {
     _class_call_check$b(this, FirebaseServerFirestoreContextModule);
 };
@@ -6647,6 +6656,48 @@ FirebaseServerFirestoreContextModule = __decorate([
         ]
     })
 ], FirebaseServerFirestoreContextModule);
+/**
+ * Generates NestJS {@link ModuleMetadata} for a dynamic Firestore context module
+ * that includes the {@link FirebaseServerFirestoreModule} and provides a
+ * {@link FIREBASE_FIRESTORE_CONTEXT_TOKEN} with cache support.
+ *
+ * If caching is not needed, use {@link FirebaseServerFirestoreContextModule} directly instead.
+ *
+ * @param config - Configuration including the cache factory
+ * @returns Module metadata ready for the `@Module()` decorator
+ *
+ * @example
+ * ```typescript
+ * @Module(firebaseServerFirestoreContextModuleMetadata({
+ *   firestoreContextCacheFactory: inMemoryFirestoreContextCacheFactory()
+ * }))
+ * export class AppFirestoreContextModule {}
+ * ```
+ */ function firebaseServerFirestoreContextModuleMetadata(config) {
+    var params = {
+        firestoreContextCacheFactory: config.firestoreContextCacheFactory
+    };
+    return {
+        imports: [
+            FirebaseServerFirestoreModule
+        ],
+        providers: [
+            {
+                provide: FIREBASE_FIRESTORE_CONTEXT_TOKEN,
+                useFactory: function useFactory(firestore) {
+                    return googleCloudFirestoreContextFactory(firestore, params);
+                },
+                inject: [
+                    FIREBASE_FIRESTORE_TOKEN
+                ]
+            }
+        ],
+        exports: [
+            FirebaseServerFirestoreModule,
+            FIREBASE_FIRESTORE_CONTEXT_TOKEN
+        ]
+    };
+}
 /**
  * Creates a NestJS provider that initializes a Firestore collections instance from the app's {@link FirestoreContext}.
  *
@@ -6675,8 +6726,13 @@ FirebaseServerFirestoreContextModule = __decorate([
     ];
 }
 /**
- * Generates NestJS {@link ModuleMetadata} for an app's Firestore module, including the
- * {@link FirebaseServerFirestoreContextModule} import and the app's collections provider.
+ * Generates NestJS {@link ModuleMetadata} for an app's Firestore module, including
+ * the Firestore context module and the app's collections provider.
+ *
+ * When a {@link FirestoreContextCacheFactory} is provided via
+ * {@link ProvideAppFirestoreModuleMetadataConfig.firestoreContextCacheFactory},
+ * a dynamic context module with cache support is used instead of the default
+ * {@link FirebaseServerFirestoreContextModule}.
  *
  * @param config - The Firestore collections config plus optional additional module metadata.
  * @returns NestJS module metadata ready to be passed to the `@Module()` decorator.
@@ -6689,17 +6745,35 @@ FirebaseServerFirestoreContextModule = __decorate([
  * }))
  * export class AppFirestoreModule {}
  * ```
+ *
+ * @example
+ * ```typescript
+ * // With caching
+ * @Module(appFirestoreModuleMetadata({
+ *   provide: DemoFirestoreCollections,
+ *   useFactory: (context) => new DemoFirestoreCollections(context),
+ *   firestoreContextCacheFactory: inMemoryFirestoreContextCacheFactory()
+ * }))
+ * export class AppFirestoreModule {}
+ * ```
  */ function appFirestoreModuleMetadata(config) {
-    var _config_imports, _config_exports, _config_providers;
-    return {
+    var _contextModuleMetadata_imports, _config_imports, _contextModuleMetadata_exports, _config_exports, _contextModuleMetadata_providers, _config_providers;
+    var contextModuleMetadata = config.firestoreContextCacheFactory ? firebaseServerFirestoreContextModuleMetadata({
+        firestoreContextCacheFactory: config.firestoreContextCacheFactory
+    }) : {
         imports: [
             FirebaseServerFirestoreContextModule
-        ].concat(_to_consumable_array$3((_config_imports = config.imports) !== null && _config_imports !== void 0 ? _config_imports : [])),
+        ],
         exports: [
-            FirebaseServerFirestoreContextModule,
+            FirebaseServerFirestoreContextModule
+        ]
+    };
+    return {
+        imports: _to_consumable_array$3((_contextModuleMetadata_imports = contextModuleMetadata.imports) !== null && _contextModuleMetadata_imports !== void 0 ? _contextModuleMetadata_imports : []).concat(_to_consumable_array$3((_config_imports = config.imports) !== null && _config_imports !== void 0 ? _config_imports : [])),
+        exports: _to_consumable_array$3((_contextModuleMetadata_exports = contextModuleMetadata.exports) !== null && _contextModuleMetadata_exports !== void 0 ? _contextModuleMetadata_exports : []).concat([
             config.provide
-        ].concat(_to_consumable_array$3((_config_exports = config.exports) !== null && _config_exports !== void 0 ? _config_exports : [])),
-        providers: _to_consumable_array$3(provideAppFirestoreCollections(config)).concat(_to_consumable_array$3((_config_providers = config.providers) !== null && _config_providers !== void 0 ? _config_providers : []))
+        ], _to_consumable_array$3((_config_exports = config.exports) !== null && _config_exports !== void 0 ? _config_exports : [])),
+        providers: _to_consumable_array$3((_contextModuleMetadata_providers = contextModuleMetadata.providers) !== null && _contextModuleMetadata_providers !== void 0 ? _contextModuleMetadata_providers : []).concat(_to_consumable_array$3(provideAppFirestoreCollections(config)), _to_consumable_array$3((_config_providers = config.providers) !== null && _config_providers !== void 0 ? _config_providers : []))
     };
 }
 
@@ -10075,4 +10149,4 @@ function _define_property(obj, key, value) {
 } 
 ();
 
-export { ALREADY_EXISTS_ERROR_CODE, AbstractFirebaseNestContext, AbstractFirebaseServerActionsContext, AbstractFirebaseServerAuthContext, AbstractFirebaseServerAuthService, AbstractFirebaseServerAuthUserContext, AbstractFirebaseServerNewUserService, AbstractNestContext, AbstractServerFirebaseNestContext, BAD_REQUEST_ERROR_CODE, CONFLICT_ERROR_CODE, ConfigureFirebaseAppCheckMiddlewareModule, ConfigureFirebaseWebhookMiddlewareModule, DEFAULT_FIREBASE_PASSWORD_NUMBER_GENERATOR, DEFAULT_SETUP_COM_THROTTLE_TIME, DefaultFirebaseServerEnvService, FIREBASE_APP_TOKEN, FIREBASE_AUTH_TOKEN, FIREBASE_FIRESTORE_CONTEXT_TOKEN, FIREBASE_FIRESTORE_TOKEN, FIREBASE_SERVER_ENV_TOKEN, FIREBASE_SERVER_VALIDATION_ERROR_CODE, FIREBASE_STORAGE_CONTEXT_FACTORY_CONFIG_TOKEN, FIREBASE_STORAGE_CONTEXT_TOKEN, FIREBASE_STORAGE_TOKEN, FIRESTORE_CLIENT_QUERY_CONSTRAINT_HANDLER_MAPPING, FORBIDDEN_ERROR_CODE, FirebaseAppCheckMiddleware, FirebaseAppCheckMiddlewareConfig, FirebaseNestServerRootModule, FirebaseRawBodyMiddleware, FirebaseServerAnalyticsSegmentListenerService, FirebaseServerAnalyticsSegmentModule, FirebaseServerAnalyticsService, FirebaseServerAnalyticsServiceListener, FirebaseServerAuthModule, FirebaseServerAuthNewUserSendSetupDetailsNoSetupConfigError, FirebaseServerAuthNewUserSendSetupDetailsSendOnceError, FirebaseServerAuthNewUserSendSetupDetailsThrottleError, FirebaseServerAuthService, FirebaseServerAuthUserBadInputError, FirebaseServerAuthUserExistsError, FirebaseServerEnvService, FirebaseServerFirestoreContextModule, FirebaseServerFirestoreModule, FirebaseServerStorageContextModule, FirebaseServerStorageModule, FirebaseServerStorageService, GlobalRoutePrefixConfig, INTERNAL_SERVER_ERROR_CODE, MODEL_NOT_AVAILABLE_ERROR_CODE, NOT_FOUND_ERROR_CODE, NO_RUN_NAME_SPECIFIED_FOR_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_CODE, NoSetupContentFirebaseServerNewUserService, ON_CALL_MODEL_ANALYTICS_HANDLER, ON_CALL_MODEL_ANALYTICS_SERVICE, OnCallModelAnalyticsService, PERMISSION_DENIED_ERROR_CODE, PHONE_NUMBER_ALREADY_EXISTS_ERROR_CODE, SkipAppCheck, UNAUTHENTICATED_ERROR_CODE, UNAVAILABLE_ERROR_CODE, UNAVAILABLE_OR_DEACTIVATED_FUNCTION_ERROR_CODE, UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_NAME_CODE, UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_TYPE_CODE, _onCallWithCallTypeFunction, aggregateCrudModelApiDetails, aggregateModelApiDetails, aggregateSpecifierApiDetails, alreadyExistsError, appAnalyticsModuleMetadata, appFirestoreModuleMetadata, assertContextHasAuth, assertDocumentExists, assertHasRolesInRequest, assertHasSignedTosInRequest, assertIsAdminInRequest, assertIsAdminOrTargetUserInRequestData, assertIsContextWithAuthData, assertRequestRequiresAuthForFunction, assertSnapshotData, assertSnapshotDataWithKey, badRequestError, blockingFunctionHandlerWithNestContextFactory, buildNestServerRootModule, callWithAnalytics, cloudEventHandlerWithNestContextFactory, collectionRefForPath, createModelUnknownModelTypeError, defaultFirebaseServerActionsTransformFactoryLogErrorFunction, defaultProvideFirebaseServerStorageServiceSimple, deleteModelUnknownModelTypeError, developmentUnknownSpecifierError, docRefForPath, documentModelNotAvailableError, firebaseAuthTokenFromDecodedIdToken, firebaseServerActionsContext, firebaseServerActionsTransformContext, firebaseServerActionsTransformFactory, firebaseServerAppTokenProvider, firebaseServerAuthModuleMetadata, firebaseServerDevFunctions, firebaseServerEnvTokenProvider, firebaseServerEnvTokenProviders, firebaseServerErrorInfo, firebaseServerErrorInfoCodePair, firebaseServerErrorInfoServerErrorCodePair, firebaseServerErrorInfoServerErrorPair, firebaseServerStorageDefaultBucketIdTokenProvider, firebaseServerStorageModuleMetadata, firebaseServerValidationError, firebaseServerValidationServerError, firestoreClientQueryConstraintFunctionsDriver, firestoreEncryptedField, firestoreServerIncrementUpdateToUpdateData, forbiddenError, getAuthUserOrUndefined, getModelApiDetails, googleCloudFileMetadataToStorageMetadata, googleCloudFirebaseStorageContextFactory, googleCloudFirebaseStorageDrivers, googleCloudFirestoreAccessorDriver, googleCloudFirestoreContextFactory, googleCloudFirestoreDrivers, googleCloudFirestoreQueryDriver, googleCloudStorageAccessorFile, googleCloudStorageAccessorFolder, googleCloudStorageBucketForStorageFilePath, googleCloudStorageFileForStorageFilePath, googleCloudStorageFirebaseStorageAccessorDriver, googleCloudStorageFromFirebaseAdminStorage, googleCloudStorageListFilesResultFactory, handleFirebaseAuthError, handleFirebaseError, hasAuthRolesInRequest, hasNewUserSetupPasswordInRequest, hasSignedTosInRequest, inAuthContext, injectNestApplicationContextIntoRequest, injectNestIntoRequest, internalServerError, isActualSpecifier, isAdminInRequest, isAdminOrTargetUserInRequestData, isContextWithAuthData, isFirebaseError, isFirebaseHttpsError, isOnCallCrudModelApiDetails, isOnCallHandlerApiDetails, isOnCallModelTypeApiDetails, isOnCallSpecifierApiDetails, makeBlockingFunctionWithHandler, makeOnScheduleHandlerWithNestApplicationRequest, makeScheduledFunctionDevelopmentFunction, modelNotAvailableError, nestAppHasDevelopmentSchedulerEnabled, nestAppIsProductionEnvironment, nestFirebaseDoesNotExistError, nestFirebaseForbiddenPermissionError, nestServerInstance, noRunNameSpecifiedForScheduledFunctionDevelopmentFunction, noopFirebaseServerAnalyticsServiceListener, noopOnCallModelAnalyticsService, notFoundError, onCallAnalyticsEmitterInstance, onCallCreateModel, onCallDeleteModel, onCallDevelopmentFunction, onCallHandlerWithNestApplicationFactory, onCallHandlerWithNestContextFactory, onCallModel, onCallModelMissingCallTypeError, onCallModelUnknownCallTypeError, onCallReadModel, onCallSpecifierHandler, onCallUpdateModel, onScheduleHandlerWithNestApplicationFactory, onScheduleHandlerWithNestContextFactory, optionalAuthContext, optionalFirestoreEncryptedField, permissionDeniedError, phoneNumberAlreadyExistsError, preconditionConflictError, provideAppFirestoreCollections, provideFirebaseServerAuthService, provideFirebaseServerStorageService, readApiDetails, readModelUnknownModelTypeError, resolveAnalyticsFromApiDetails, setNestContextOnRequest, setNestContextOnScheduleRequest, taskQueueFunctionHandlerWithNestContextFactory, unauthenticatedContextHasNoAuthData, unauthenticatedContextHasNoUidError, unauthenticatedError, unavailableError, unavailableOrDeactivatedFunctionError, unknownModelCrudFunctionSpecifierError, unknownScheduledFunctionDevelopmentFunctionName, unknownScheduledFunctionDevelopmentFunctionType, updateModelUnknownModelTypeError, userContextFromUid, verifyAppCheckInRequest, withApiDetails };
+export { ALREADY_EXISTS_ERROR_CODE, AbstractFirebaseNestContext, AbstractFirebaseServerActionsContext, AbstractFirebaseServerAuthContext, AbstractFirebaseServerAuthService, AbstractFirebaseServerAuthUserContext, AbstractFirebaseServerNewUserService, AbstractNestContext, AbstractServerFirebaseNestContext, BAD_REQUEST_ERROR_CODE, CONFLICT_ERROR_CODE, ConfigureFirebaseAppCheckMiddlewareModule, ConfigureFirebaseWebhookMiddlewareModule, DEFAULT_FIREBASE_PASSWORD_NUMBER_GENERATOR, DEFAULT_SETUP_COM_THROTTLE_TIME, DefaultFirebaseServerEnvService, FIREBASE_APP_TOKEN, FIREBASE_AUTH_TOKEN, FIREBASE_FIRESTORE_CONTEXT_TOKEN, FIREBASE_FIRESTORE_TOKEN, FIREBASE_SERVER_ENV_TOKEN, FIREBASE_SERVER_VALIDATION_ERROR_CODE, FIREBASE_STORAGE_CONTEXT_FACTORY_CONFIG_TOKEN, FIREBASE_STORAGE_CONTEXT_TOKEN, FIREBASE_STORAGE_TOKEN, FIRESTORE_CLIENT_QUERY_CONSTRAINT_HANDLER_MAPPING, FORBIDDEN_ERROR_CODE, FirebaseAppCheckMiddleware, FirebaseAppCheckMiddlewareConfig, FirebaseNestServerRootModule, FirebaseRawBodyMiddleware, FirebaseServerAnalyticsSegmentListenerService, FirebaseServerAnalyticsSegmentModule, FirebaseServerAnalyticsService, FirebaseServerAnalyticsServiceListener, FirebaseServerAuthModule, FirebaseServerAuthNewUserSendSetupDetailsNoSetupConfigError, FirebaseServerAuthNewUserSendSetupDetailsSendOnceError, FirebaseServerAuthNewUserSendSetupDetailsThrottleError, FirebaseServerAuthService, FirebaseServerAuthUserBadInputError, FirebaseServerAuthUserExistsError, FirebaseServerEnvService, FirebaseServerFirestoreContextModule, FirebaseServerFirestoreModule, FirebaseServerStorageContextModule, FirebaseServerStorageModule, FirebaseServerStorageService, GlobalRoutePrefixConfig, INTERNAL_SERVER_ERROR_CODE, MODEL_NOT_AVAILABLE_ERROR_CODE, NOT_FOUND_ERROR_CODE, NO_RUN_NAME_SPECIFIED_FOR_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_CODE, NoSetupContentFirebaseServerNewUserService, ON_CALL_MODEL_ANALYTICS_HANDLER, ON_CALL_MODEL_ANALYTICS_SERVICE, OnCallModelAnalyticsService, PERMISSION_DENIED_ERROR_CODE, PHONE_NUMBER_ALREADY_EXISTS_ERROR_CODE, SkipAppCheck, UNAUTHENTICATED_ERROR_CODE, UNAVAILABLE_ERROR_CODE, UNAVAILABLE_OR_DEACTIVATED_FUNCTION_ERROR_CODE, UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_NAME_CODE, UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_TYPE_CODE, _onCallWithCallTypeFunction, aggregateCrudModelApiDetails, aggregateModelApiDetails, aggregateSpecifierApiDetails, alreadyExistsError, appAnalyticsModuleMetadata, appFirestoreModuleMetadata, assertContextHasAuth, assertDocumentExists, assertHasRolesInRequest, assertHasSignedTosInRequest, assertIsAdminInRequest, assertIsAdminOrTargetUserInRequestData, assertIsContextWithAuthData, assertRequestRequiresAuthForFunction, assertSnapshotData, assertSnapshotDataWithKey, badRequestError, blockingFunctionHandlerWithNestContextFactory, buildNestServerRootModule, callWithAnalytics, cloudEventHandlerWithNestContextFactory, collectionRefForPath, createModelUnknownModelTypeError, defaultFirebaseServerActionsTransformFactoryLogErrorFunction, defaultProvideFirebaseServerStorageServiceSimple, deleteModelUnknownModelTypeError, developmentUnknownSpecifierError, docRefForPath, documentModelNotAvailableError, firebaseAuthTokenFromDecodedIdToken, firebaseServerActionsContext, firebaseServerActionsTransformContext, firebaseServerActionsTransformFactory, firebaseServerAppTokenProvider, firebaseServerAuthModuleMetadata, firebaseServerDevFunctions, firebaseServerEnvTokenProvider, firebaseServerEnvTokenProviders, firebaseServerErrorInfo, firebaseServerErrorInfoCodePair, firebaseServerErrorInfoServerErrorCodePair, firebaseServerErrorInfoServerErrorPair, firebaseServerFirestoreContextModuleMetadata, firebaseServerStorageDefaultBucketIdTokenProvider, firebaseServerStorageModuleMetadata, firebaseServerValidationError, firebaseServerValidationServerError, firestoreClientQueryConstraintFunctionsDriver, firestoreEncryptedField, firestoreServerIncrementUpdateToUpdateData, forbiddenError, getAuthUserOrUndefined, getModelApiDetails, googleCloudFileMetadataToStorageMetadata, googleCloudFirebaseStorageContextFactory, googleCloudFirebaseStorageDrivers, googleCloudFirestoreAccessorDriver, googleCloudFirestoreContextFactory, googleCloudFirestoreDrivers, googleCloudFirestoreQueryDriver, googleCloudStorageAccessorFile, googleCloudStorageAccessorFolder, googleCloudStorageBucketForStorageFilePath, googleCloudStorageFileForStorageFilePath, googleCloudStorageFirebaseStorageAccessorDriver, googleCloudStorageFromFirebaseAdminStorage, googleCloudStorageListFilesResultFactory, handleFirebaseAuthError, handleFirebaseError, hasAuthRolesInRequest, hasNewUserSetupPasswordInRequest, hasSignedTosInRequest, inAuthContext, injectNestApplicationContextIntoRequest, injectNestIntoRequest, internalServerError, isActualSpecifier, isAdminInRequest, isAdminOrTargetUserInRequestData, isContextWithAuthData, isFirebaseError, isFirebaseHttpsError, isOnCallCrudModelApiDetails, isOnCallHandlerApiDetails, isOnCallModelTypeApiDetails, isOnCallSpecifierApiDetails, makeBlockingFunctionWithHandler, makeOnScheduleHandlerWithNestApplicationRequest, makeScheduledFunctionDevelopmentFunction, modelNotAvailableError, nestAppHasDevelopmentSchedulerEnabled, nestAppIsProductionEnvironment, nestFirebaseDoesNotExistError, nestFirebaseForbiddenPermissionError, nestServerInstance, noRunNameSpecifiedForScheduledFunctionDevelopmentFunction, noopFirebaseServerAnalyticsServiceListener, noopOnCallModelAnalyticsService, notFoundError, onCallAnalyticsEmitterInstance, onCallCreateModel, onCallDeleteModel, onCallDevelopmentFunction, onCallHandlerWithNestApplicationFactory, onCallHandlerWithNestContextFactory, onCallModel, onCallModelMissingCallTypeError, onCallModelUnknownCallTypeError, onCallReadModel, onCallSpecifierHandler, onCallUpdateModel, onScheduleHandlerWithNestApplicationFactory, onScheduleHandlerWithNestContextFactory, optionalAuthContext, optionalFirestoreEncryptedField, permissionDeniedError, phoneNumberAlreadyExistsError, preconditionConflictError, provideAppFirestoreCollections, provideFirebaseServerAuthService, provideFirebaseServerStorageService, readApiDetails, readModelUnknownModelTypeError, resolveAnalyticsFromApiDetails, setNestContextOnRequest, setNestContextOnScheduleRequest, taskQueueFunctionHandlerWithNestContextFactory, unauthenticatedContextHasNoAuthData, unauthenticatedContextHasNoUidError, unauthenticatedError, unavailableError, unavailableOrDeactivatedFunctionError, unknownModelCrudFunctionSpecifierError, unknownScheduledFunctionDevelopmentFunctionName, unknownScheduledFunctionDevelopmentFunctionType, updateModelUnknownModelTypeError, userContextFromUid, verifyAppCheckInRequest, withApiDetails };

package/mailgun/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/mailgun",
-  "version": "13.6.6",
+  "version": "13.6.7",
   "peerDependencies": {
-    "@dereekb/analytics": "13.6.6",
-    "@dereekb/firebase": "13.6.6",
-    "@dereekb/firebase-server": "13.6.6",
-    "@dereekb/date": "13.6.6",
-    "@dereekb/nestjs": "13.6.6",
-    "@dereekb/model": "13.6.6",
-    "@dereekb/rxjs": "13.6.6",
-    "@dereekb/util": "13.6.6"
+    "@dereekb/analytics": "13.6.7",
+    "@dereekb/firebase": "13.6.7",
+    "@dereekb/firebase-server": "13.6.7",
+    "@dereekb/date": "13.6.7",
+    "@dereekb/nestjs": "13.6.7",
+    "@dereekb/model": "13.6.7",
+    "@dereekb/rxjs": "13.6.7",
+    "@dereekb/util": "13.6.7"
   },
   "exports": {
     "./package.json": "./package.json",

package/model/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/model",
-  "version": "13.6.6",
+  "version": "13.6.7",
   "peerDependencies": {
-    "@dereekb/analytics": "13.6.6",
-    "@dereekb/date": "13.6.6",
-    "@dereekb/firebase": "13.6.6",
-    "@dereekb/firebase-server": "13.6.6",
-    "@dereekb/model": "13.6.6",
-    "@dereekb/nestjs": "13.6.6",
-    "@dereekb/rxjs": "13.6.6",
-    "@dereekb/util": "13.6.6",
+    "@dereekb/analytics": "13.6.7",
+    "@dereekb/date": "13.6.7",
+    "@dereekb/firebase": "13.6.7",
+    "@dereekb/firebase-server": "13.6.7",
+    "@dereekb/model": "13.6.7",
+    "@dereekb/nestjs": "13.6.7",
+    "@dereekb/rxjs": "13.6.7",
+    "@dereekb/util": "13.6.7",
     "@nestjs/common": "^11.1.17",
     "@nestjs/config": "^4.0.3",
     "archiver": "^7.0.0",

package/oidc/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@dereekb/firebase-server/oidc",
-  "version": "13.6.6",
+  "version": "13.6.7",
   "peerDependencies": {
-    "@dereekb/analytics": "13.6.6",
-    "@dereekb/date": "13.6.6",
-    "@dereekb/firebase": "13.6.6",
-    "@dereekb/firebase-server": "13.6.6",
-    "@dereekb/model": "13.6.6",
-    "@dereekb/nestjs": "13.6.6",
-    "@dereekb/rxjs": "13.6.6",
-    "@dereekb/util": "13.6.6",
-    "@dereekb/zoho": "13.6.6",
+    "@dereekb/analytics": "13.6.7",
+    "@dereekb/date": "13.6.7",
+    "@dereekb/firebase": "13.6.7",
+    "@dereekb/firebase-server": "13.6.7",
+    "@dereekb/model": "13.6.7",
+    "@dereekb/nestjs": "13.6.7",
+    "@dereekb/rxjs": "13.6.7",
+    "@dereekb/util": "13.6.7",
+    "@dereekb/zoho": "13.6.7",
     "@nestjs/common": "^11.1.17",
     "@nestjs/config": "^4.0.3",
     "express": "^5.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/firebase-server",
-  "version": "13.6.6",
+  "version": "13.6.7",
   "exports": {
     "./test": {
       "module": "./test/index.esm.js",
@@ -43,15 +43,15 @@
   "main": "./index.cjs.js",
   "types": "./src/index.d.ts",
   "peerDependencies": {
-    "@dereekb/analytics": "13.6.6",
-    "@dereekb/date": "13.6.6",
-    "@dereekb/dbx-core": "13.6.6",
-    "@dereekb/firebase": "13.6.6",
-    "@dereekb/model": "13.6.6",
-    "@dereekb/nestjs": "13.6.6",
-    "@dereekb/rxjs": "13.6.6",
-    "@dereekb/util": "13.6.6",
-    "@dereekb/zoho": "13.6.6",
+    "@dereekb/analytics": "13.6.7",
+    "@dereekb/date": "13.6.7",
+    "@dereekb/dbx-core": "13.6.7",
+    "@dereekb/firebase": "13.6.7",
+    "@dereekb/model": "13.6.7",
+    "@dereekb/nestjs": "13.6.7",
+    "@dereekb/rxjs": "13.6.7",
+    "@dereekb/util": "13.6.7",
+    "@dereekb/zoho": "13.6.7",
     "@google-cloud/firestore": "^7.11.6",
     "@google-cloud/storage": "^7.19.0",
     "@nestjs/common": "^11.1.17",

package/src/lib/firestore/firestore.d.ts

@@ -1,5 +1,13 @@
 import { type FirestoreContextFactory } from '@dereekb/firebase';
 /**
- * Creates a FirestoreContextFactory that uses the @'@google-cloud/firestore package.
+ * Pre-configured {@link FirestoreContextFactory} for Google Cloud Firestore (Admin SDK) usage.
+ *
+ * Wires the server-side Firestore drivers into the abstract {@link FirestoreContextFactory}
+ * so that collections, documents, queries, and transactions all use the Admin SDK implementation.
+ *
+ * @example
+ * ```ts
+ * const context = googleCloudFirestoreContextFactory(firestore);
+ * ```
  */
 export declare const googleCloudFirestoreContextFactory: FirestoreContextFactory;

package/src/lib/nest/firestore/firestore.module.d.ts

@@ -1,5 +1,5 @@
 import { type InjectionToken, type ModuleMetadata, type Provider } from '@nestjs/common';
-import { type FirestoreContext } from '@dereekb/firebase';
+import { type FirestoreContext, type FirestoreContextCacheFactory } from '@dereekb/firebase';
 import { type ClassLikeType } from '@dereekb/util';
 /**
  * Token to access the Firestore.
@@ -15,10 +15,42 @@ export declare const FIREBASE_FIRESTORE_CONTEXT_TOKEN: InjectionToken;
 export declare class FirebaseServerFirestoreModule {
 }
 /**
- * Nest provider module for firebase that includes the FirebaseServerFirestoreModule and provides a value for FIRESTORE_CONTEXT_TOKEN using the googleCloudFirestoreContextFactory.
+ * Nest provider module for firebase that includes the FirebaseServerFirestoreModule and provides
+ * a value for FIRESTORE_CONTEXT_TOKEN using the googleCloudFirestoreContextFactory without caching.
  */
 export declare class FirebaseServerFirestoreContextModule {
 }
+/**
+ * Configuration for {@link firebaseServerFirestoreContextModuleMetadata}.
+ */
+export interface FirebaseServerFirestoreContextModuleConfig {
+    /**
+     * Cache factory that creates a {@link FirestoreContextCache} for the context.
+     *
+     * The context cache provides TTL-based caching for document reads. Generally not needed
+     * for short-lived Cloud Function invocations, but useful for long-running processes.
+     */
+    readonly firestoreContextCacheFactory: FirestoreContextCacheFactory;
+}
+/**
+ * Generates NestJS {@link ModuleMetadata} for a dynamic Firestore context module
+ * that includes the {@link FirebaseServerFirestoreModule} and provides a
+ * {@link FIREBASE_FIRESTORE_CONTEXT_TOKEN} with cache support.
+ *
+ * If caching is not needed, use {@link FirebaseServerFirestoreContextModule} directly instead.
+ *
+ * @param config - Configuration including the cache factory
+ * @returns Module metadata ready for the `@Module()` decorator
+ *
+ * @example
+ * ```typescript
+ * @Module(firebaseServerFirestoreContextModuleMetadata({
+ *   firestoreContextCacheFactory: inMemoryFirestoreContextCacheFactory()
+ * }))
+ * export class AppFirestoreContextModule {}
+ * ```
+ */
+export declare function firebaseServerFirestoreContextModuleMetadata(config: FirebaseServerFirestoreContextModuleConfig): ModuleMetadata;
 /**
  * Factory function that creates an app's Firestore collections instance from a {@link FirestoreContext}.
  */
@@ -47,11 +79,16 @@ export interface ProvideAppFirestoreCollectionsConfig<T> {
  * ```
  */
 export declare function provideAppFirestoreCollections<T>({ provide, useFactory }: ProvideAppFirestoreCollectionsConfig<T>): [Provider<T>];
-export interface ProvideAppFirestoreModuleMetadataConfig<T> extends ProvideAppFirestoreCollectionsConfig<T>, Pick<ModuleMetadata, 'imports' | 'exports' | 'providers'> {
+export interface ProvideAppFirestoreModuleMetadataConfig<T> extends ProvideAppFirestoreCollectionsConfig<T>, Pick<ModuleMetadata, 'imports' | 'exports' | 'providers'>, Partial<FirebaseServerFirestoreContextModuleConfig> {
 }
 /**
- * Generates NestJS {@link ModuleMetadata} for an app's Firestore module, including the
- * {@link FirebaseServerFirestoreContextModule} import and the app's collections provider.
+ * Generates NestJS {@link ModuleMetadata} for an app's Firestore module, including
+ * the Firestore context module and the app's collections provider.
+ *
+ * When a {@link FirestoreContextCacheFactory} is provided via
+ * {@link ProvideAppFirestoreModuleMetadataConfig.firestoreContextCacheFactory},
+ * a dynamic context module with cache support is used instead of the default
+ * {@link FirebaseServerFirestoreContextModule}.
  *
  * @param config - The Firestore collections config plus optional additional module metadata.
  * @returns NestJS module metadata ready to be passed to the `@Module()` decorator.
@@ -64,5 +101,16 @@ export interface ProvideAppFirestoreModuleMetadataConfig<T> extends ProvideAppFi
  * }))
  * export class AppFirestoreModule {}
  * ```
+ *
+ * @example
+ * ```typescript
+ * // With caching
+ * @Module(appFirestoreModuleMetadata({
+ *   provide: DemoFirestoreCollections,
+ *   useFactory: (context) => new DemoFirestoreCollections(context),
+ *   firestoreContextCacheFactory: inMemoryFirestoreContextCacheFactory()
+ * }))
+ * export class AppFirestoreModule {}
+ * ```
  */
 export declare function appFirestoreModuleMetadata<T>(config: ProvideAppFirestoreModuleMetadataConfig<T>): ModuleMetadata;

package/test/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/test",
-  "version": "13.6.6",
+  "version": "13.6.7",
   "peerDependencies": {
-    "@dereekb/analytics": "13.6.6",
-    "@dereekb/date": "13.6.6",
-    "@dereekb/firebase": "13.6.6",
-    "@dereekb/firebase-server": "13.6.6",
-    "@dereekb/model": "13.6.6",
-    "@dereekb/nestjs": "13.6.6",
-    "@dereekb/rxjs": "13.6.6",
-    "@dereekb/util": "13.6.6",
+    "@dereekb/analytics": "13.6.7",
+    "@dereekb/date": "13.6.7",
+    "@dereekb/firebase": "13.6.7",
+    "@dereekb/firebase-server": "13.6.7",
+    "@dereekb/model": "13.6.7",
+    "@dereekb/nestjs": "13.6.7",
+    "@dereekb/rxjs": "13.6.7",
+    "@dereekb/util": "13.6.7",
     "@google-cloud/firestore": "^7.11.6",
     "@google-cloud/storage": "^7.19.0",
     "@nestjs/common": "^11.1.17",
@@ -21,7 +21,7 @@
     "make-error": "^1.3.0"
   },
   "devDependencies": {
-    "@dereekb/nestjs": "13.6.6"
+    "@dereekb/nestjs": "13.6.7"
   },
   "exports": {
     "./package.json": "./package.json",

package/zoho/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/zoho",
-  "version": "13.6.6",
+  "version": "13.6.7",
   "peerDependencies": {
-    "@dereekb/analytics": "13.6.6",
-    "@dereekb/date": "13.6.6",
-    "@dereekb/model": "13.6.6",
-    "@dereekb/nestjs": "13.6.6",
-    "@dereekb/rxjs": "13.6.6",
-    "@dereekb/firebase": "13.6.6",
-    "@dereekb/util": "13.6.6",
-    "@dereekb/zoho": "13.6.6"
+    "@dereekb/analytics": "13.6.7",
+    "@dereekb/date": "13.6.7",
+    "@dereekb/model": "13.6.7",
+    "@dereekb/nestjs": "13.6.7",
+    "@dereekb/rxjs": "13.6.7",
+    "@dereekb/firebase": "13.6.7",
+    "@dereekb/util": "13.6.7",
+    "@dereekb/zoho": "13.6.7"
   },
   "exports": {
     "./package.json": "./package.json",