@dereekb/dbx-firebase 13.6.6 → 13.6.7

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@dereekb/dbx-firebase",
-  "version": "13.6.6",
+  "version": "13.6.7",
   "peerDependencies": {
     "@angular/common": "21.2.3",
     "@angular/core": "21.2.3",
     "@angular/fire": "21.0.0-rc.0-canary.ac3dd7c",
     "@angular/material": "21.2.3",
-    "@dereekb/date": "13.6.6",
-    "@dereekb/dbx-analytics": "13.6.6",
-    "@dereekb/dbx-core": "13.6.6",
-    "@dereekb/dbx-form": "13.6.6",
-    "@dereekb/dbx-web": "13.6.6",
-    "@dereekb/firebase": "13.6.6",
-    "@dereekb/model": "13.6.6",
-    "@dereekb/rxjs": "13.6.6",
-    "@dereekb/util": "13.6.6",
+    "@dereekb/date": "13.6.7",
+    "@dereekb/dbx-analytics": "13.6.7",
+    "@dereekb/dbx-core": "13.6.7",
+    "@dereekb/dbx-form": "13.6.7",
+    "@dereekb/dbx-web": "13.6.7",
+    "@dereekb/firebase": "13.6.7",
+    "@dereekb/model": "13.6.7",
+    "@dereekb/rxjs": "13.6.7",
+    "@dereekb/util": "13.6.7",
     "@ngrx/component-store": "^21.0.0",
     "@ngx-formly/core": "git+https://git@github.com/dereekb/ngx-formly#996d1041c8d2afbe429985a5ad394e59327bfa1d",
     "firebase": "^12.0.0",

package/types/dereekb-dbx-firebase.d.ts

@@ -6,7 +6,7 @@ import { Auth, User as User$1, IdTokenResult, ParsedToken, AuthProvider, PopupRe
 import * as rxjs from 'rxjs';
 import { Observable, BehaviorSubject, Subject, OperatorFunction, Subscription } from 'rxjs';
 import * as _dereekb_firebase from '@dereekb/firebase';
-import { FirebaseAuthToken, FirebaseAuthIdToken, FirebaseAuthContextInfo, FirebaseDevelopmentFunctions, ScheduledFunctionDevelopmentFirebaseFunctionListEntry, FirestoreContext, NotificationFirestoreCollections, StorageFileFirestoreCollections, SystemStateFirestoreCollections, FirebaseFunctionsMap, FirebaseFunctionsConfigMap, FirestoreQueryConstraint, FirestoreItemPageIterationInstance, DocumentDataWithIdAndKey, IterationQueryDocChangeWatcher, FirebaseQuerySnapshotAccumulator, FirebaseQueryItemAccumulator, FirebaseQueryItemAccumulatorNextPageUntilResultsCountFunction, IterationQueryDocChangeWatcherEvent, FirestoreDocument, FirestoreCollectionLike, FirestoreModelKey, DocumentReference, FirestoreItemPageIteratorFilter, FirestoreModelId, DocumentSnapshot, FirestoreDocumentAccessor, LimitedFirestoreDocumentAccessor, FirestoreModelType, FirestoreDocumentData, FirestoreAccessorStreamMode, SnapshotOptions, FirebasePermissionErrorContext, InModelContextFirebaseModelService, InContextFirebaseModelsService, FirebaseModelsService, FirestoreModelIdentityTypeMap, FirestoreModelIdentity, FirestoreCollectionType, FirestoreCollection, FlatFirestoreModelKey, TwoWayFlatFirestoreModelKey, FirestoreModelCollectionAndIdPair, FirestoreModelCollectionAndIdPairObject, IterationQueryDocChangeWatcherChangeType, OnCallCreateModelResult, ModelFirebaseCreateFunction, ModelFirebaseCrudFunction, TargetModelParams, InferredTargetModelParams, ModelFirebaseDeleteFunction, ModelFirebaseReadFunction, ModelFirebaseUpdateFunction, FirestoreCollectionWithParentFactory, FirestoreCollectionGroup, SystemState, SystemStateDocument, SystemStateStoredData, SystemStateTypeIdentifier, AppNotificationTemplateTypeInfoRecordService, NotificationItemMetadata, NotificationItem, NotificationItemSubjectMessagePair, NotificationId, Notification, NotificationBox, NotificationDocument, NotificationBoxDocument, NotificationFunctions, NotificationSummary, NotificationSummaryDocument, UnreadNotificationItemsResult, NotificationUser, NotificationUserDocument, NotificationTemplateType, NotificationTemplateTypeInfo, FirebaseAuthUserId, StorageFileId, StorageFileSignedDownloadUrl, FirestoreModelIdInput, StorageFileFunctions, StorageFileKey, DownloadStorageFileParams, DownloadStorageFileResult, StorageFileDownloadUrl, StoragePathInput, FirebaseStorageAccessorFile, StorageFile, StorageFileDocument, StorageFileGroup, StorageFileGroupDocument, FirebaseStorageAccessor, FirebaseStorageContext, FirebaseStorageAccessorFolder, StorageUploadTask, StorageUploadOptions, StorageCustomMetadata, FirebaseStorageContextFactoryConfig } from '@dereekb/firebase';
+import { FirebaseAuthToken, FirebaseAuthIdToken, FirebaseAuthContextInfo, FirebaseDevelopmentFunctions, ScheduledFunctionDevelopmentFirebaseFunctionListEntry, FirestoreContext, FirestoreContextCacheFactory, NotificationFirestoreCollections, StorageFileFirestoreCollections, SystemStateFirestoreCollections, FirebaseFunctionsMap, FirebaseFunctionsConfigMap, FirestoreQueryConstraint, FirestoreItemPageIterationInstance, DocumentDataWithIdAndKey, IterationQueryDocChangeWatcher, FirebaseQuerySnapshotAccumulator, FirebaseQueryItemAccumulator, FirebaseQueryItemAccumulatorNextPageUntilResultsCountFunction, IterationQueryDocChangeWatcherEvent, FirestoreDocument, FirestoreCollectionLike, FirestoreModelKey, DocumentReference, FirestoreItemPageIteratorFilter, FirestoreModelId, DocumentSnapshot, FirestoreDocumentAccessor, LimitedFirestoreDocumentAccessor, FirestoreModelType, FirestoreDocumentData, FirestoreAccessorStreamMode, SnapshotOptions, FirebasePermissionErrorContext, InModelContextFirebaseModelService, InContextFirebaseModelsService, FirebaseModelsService, FirestoreModelIdentityTypeMap, FirestoreModelIdentity, FirestoreCollectionType, FirestoreCollection, FlatFirestoreModelKey, TwoWayFlatFirestoreModelKey, FirestoreModelCollectionAndIdPair, FirestoreModelCollectionAndIdPairObject, IterationQueryDocChangeWatcherChangeType, OnCallCreateModelResult, ModelFirebaseCreateFunction, ModelFirebaseCrudFunction, TargetModelParams, InferredTargetModelParams, ModelFirebaseDeleteFunction, ModelFirebaseReadFunction, ModelFirebaseUpdateFunction, FirestoreCollectionWithParentFactory, FirestoreCollectionGroup, SystemState, SystemStateDocument, SystemStateStoredData, SystemStateTypeIdentifier, AppNotificationTemplateTypeInfoRecordService, NotificationItemMetadata, NotificationItem, NotificationItemSubjectMessagePair, NotificationId, Notification, NotificationBox, NotificationDocument, NotificationBoxDocument, NotificationFunctions, NotificationSummary, NotificationSummaryDocument, UnreadNotificationItemsResult, NotificationUser, NotificationUserDocument, NotificationTemplateType, NotificationTemplateTypeInfo, FirebaseAuthUserId, StorageFileId, StorageFileSignedDownloadUrl, FirestoreModelIdInput, StorageFileFunctions, StorageFileKey, DownloadStorageFileParams, DownloadStorageFileResult, StorageFileDownloadUrl, StoragePathInput, FirebaseStorageAccessorFile, StorageFile, StorageFileDocument, StorageFileGroup, StorageFileGroupDocument, FirebaseStorageAccessor, FirebaseStorageContext, FirebaseStorageAccessorFolder, StorageUploadTask, StorageUploadOptions, StorageCustomMetadata, FirebaseStorageContextFactoryConfig } from '@dereekb/firebase';
 import { UserInfo, User, IdTokenResult as IdTokenResult$1 } from 'firebase/auth';
 import * as i0 from '@angular/core';
 import { EnvironmentProviders, Type, InjectionToken, OnInit, Component, EventEmitter, Injector, AfterViewInit, ElementRef, Signal, Provider, PipeTransform } from '@angular/core';
@@ -1509,6 +1509,24 @@ interface ProvideDbxFirebaseFirestoreCollectionConfig<T> {
      * False by default.
      */
     readonly provideStorageFileFirestoreCollections?: boolean;
+    /**
+     * Optional cache factory to enable collection-level caching.
+     *
+     * When provided, the Firestore context will create a {@link FirestoreContextCache}
+     * that provides TTL-based caching for document reads across all collections.
+     *
+     * @example
+     * ```ts
+     * import { inMemoryFirestoreContextCacheFactory } from '@dereekb/firebase';
+     *
+     * provideDbxFirestoreCollection({
+     *   appCollectionClass: MyCollections,
+     *   collectionFactory: (ctx) => new MyCollections(ctx),
+     *   firestoreContextCacheFactory: inMemoryFirestoreContextCacheFactory()
+     * });
+     * ```
+     */
+    readonly firestoreContextCacheFactory?: Maybe<FirestoreContextCacheFactory>;
 }
 /**
  * Creates EnvironmentProviders for the DBX_FIRESTORE_CONTEXT_TOKEN, appCollectionClass, and optionally the SystemStateFirestoreCollections and NotificationFirestoreCollections.