@dereekb/firebase 2.1.0 → 3.0.0

package/src/lib/common/firestore/accessor/document.utility.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.documentDataWithId = exports.firestoreDocumentLoader = exports.loadDocumentsForValues = exports.loadDocumentsForDocumentReferences = exports.loadDocumentsForSnapshots = exports.getDocumentSnapshots = exports.makeDocuments = exports.newDocuments = void 0;
+const tslib_1 = require("tslib");
+const util_1 = require("@dereekb/util");
+function newDocuments(documentAccessor, count) {
+    return (0, util_1.makeArray)({ count, make: () => documentAccessor.newDocument() });
+}
+exports.newDocuments = newDocuments;
+/**
+ * Makes a number of new documents.
+ *
+ * @param documentAccessor
+ * @param make
+ * @returns
+ */
+function makeDocuments(documentAccessor, make) {
+    return (0, util_1.performMakeLoop)({
+        count: make.count,
+        make: (i) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const document = documentAccessor.newDocument();
+            const data = yield make.init(i, document);
+            if (data != null) {
+                yield document.accessor.set(data);
+            }
+            return document;
+        })
+    });
+}
+exports.makeDocuments = makeDocuments;
+function getDocumentSnapshots(documents) {
+    return util_1.PromiseUtility.runTasksForValues(documents, (x) => x.accessor.get());
+}
+exports.getDocumentSnapshots = getDocumentSnapshots;
+function loadDocumentsForSnapshots(accessor, snapshots) {
+    return snapshots.docs.map(x => accessor.loadDocument(x.ref));
+}
+exports.loadDocumentsForSnapshots = loadDocumentsForSnapshots;
+function loadDocumentsForDocumentReferences(accessor, refs) {
+    return refs.map(x => accessor.loadDocument(x));
+}
+exports.loadDocumentsForDocumentReferences = loadDocumentsForDocumentReferences;
+function loadDocumentsForValues(accessor, values, getRef) {
+    return values.map(x => accessor.loadDocument(getRef(x)));
+}
+exports.loadDocumentsForValues = loadDocumentsForValues;
+/**
+ * Used to make a FirestoreDocumentLoader.
+ *
+ * @param accessorContext
+ * @returns
+ */
+function firestoreDocumentLoader(accessorContext) {
+    return (references, transaction) => {
+        const accessor = (transaction) ? accessorContext.documentAccessorForTransaction(transaction) : accessorContext.documentAccessor();
+        return loadDocumentsForDocumentReferences(accessor, references);
+    };
+}
+exports.firestoreDocumentLoader = firestoreDocumentLoader;
+/**
+ * Creates a DocumentDataWithId from the input DocumentSnapshot. If the data does not exist, returns undefined.
+ *
+ * @param snapshot
+ * @returns
+ */
+function documentDataWithId(snapshot) {
+    const data = snapshot.data();
+    if (data) {
+        data.id = snapshot.id; // attach the id to data
+    }
+    return data;
+}
+exports.documentDataWithId = documentDataWithId;
+//# sourceMappingURL=document.utility.js.map

package/src/lib/common/firestore/accessor/document.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.utility.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/accessor/document.utility.ts"],"names":[],"mappings":";;;;AAAA,wCAAkF;AAIlF,SAAgB,YAAY,CAAoC,gBAAiD,EAAE,KAAa;IAC9H,OAAO,IAAA,gBAAS,EAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAFD,oCAEC;AAYD;;;;;;GAMG;AACH,SAAgB,aAAa,CAAoC,gBAAiD,EAAE,IAA+B;IACjJ,OAAO,IAAA,sBAAe,EAAC;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,CAAO,CAAS,EAAE,EAAE;YACxB,MAAM,QAAQ,GAAM,gBAAgB,CAAC,WAAW,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAE1C,IAAI,IAAI,IAAI,IAAI,EAAE;gBAChB,MAAM,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;aACnC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAA;KACF,CAAC,CAAC;AACL,CAAC;AAdD,sCAcC;AAED,SAAgB,oBAAoB,CAAoC,SAAc;IACpF,OAAO,qBAAc,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;AAC9E,CAAC;AAFD,oDAEC;AAED,SAAgB,yBAAyB,CAAoC,QAAyC,EAAE,SAA2B;IACjJ,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,CAAC;AAFD,8DAEC;AAED,SAAgB,kCAAkC,CAAoC,QAAyC,EAAE,IAA4B;IAC3J,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAFD,gFAEC;AAED,SAAgB,sBAAsB,CAAuC,QAAyC,EAAE,MAAW,EAAE,MAA0C;IAC7K,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAFD,wDAEC;AAQD;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAoC,eAAgE;IACzI,OAAO,CAAC,UAAkC,EAAE,WAAyB,EAAE,EAAE;QACvE,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,8BAA8B,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,gBAAgB,EAAE,CAAC;QAClI,OAAO,kCAAkC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC,CAAA;AACH,CAAC;AALD,0DAKC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAI,QAA6B;IACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAA2B,CAAC;IAEtD,IAAI,IAAI,EAAE;QACR,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAI,wBAAwB;KACnD;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AARD,gDAQC"}

package/src/lib/{firestore → common/firestore/accessor}/index.d.ts

@@ -1,12 +1,10 @@
-export * from './accessor';
 export * from './accessor.batch';
 export * from './accessor.default';
 export * from './accessor.transaction';
-export * from './document';
-export * from './reference';
+export * from './accessor';
 export * from './context.batch';
 export * from './context.default';
 export * from './context.transaction';
 export * from './context';
-export * from './firestore';
-export * from './iterator';
+export * from './document';
+export * from './document.utility';

package/src/lib/common/firestore/accessor/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./accessor.batch"), exports);
+tslib_1.__exportStar(require("./accessor.default"), exports);
+tslib_1.__exportStar(require("./accessor.transaction"), exports);
+tslib_1.__exportStar(require("./accessor"), exports);
+tslib_1.__exportStar(require("./context.batch"), exports);
+tslib_1.__exportStar(require("./context.default"), exports);
+tslib_1.__exportStar(require("./context.transaction"), exports);
+tslib_1.__exportStar(require("./context"), exports);
+tslib_1.__exportStar(require("./document"), exports);
+tslib_1.__exportStar(require("./document.utility"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/common/firestore/accessor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/accessor/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,6DAAmC;AACnC,iEAAuC;AACvC,qDAA2B;AAC3B,0DAAgC;AAChC,4DAAkC;AAClC,gEAAsC;AACtC,oDAA0B;AAC1B,qDAA2B;AAC3B,6DAAmC"}

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

@@ -0,0 +1,27 @@
+import { FirestoreDocument, FirestoreDocumentAccessorFactory, FirestoreDocumentAccessorFactoryConfig, FirestoreDocumentAccessorForTransactionFactory, FirestoreDocumentAccessorForWriteBatchFactory } from "../accessor/document";
+import { FirestoreItemPageIterationBaseConfig, FirestoreItemPageIterationFactory } from "../query/iterator";
+import { CollectionReferenceRef, FirestoreContextReference } from "../reference";
+import { FirestoreQueryFactory } from '../query/query';
+import { FirestoreDrivers } from '../driver/driver';
+import { FirestoreCollectionQueryFactory } from "./collection.query";
+/**
+ * FirestoreCollection configuration
+ */
+export interface FirestoreCollectionConfig<T, D extends FirestoreDocument<T> = FirestoreDocument<T>> extends FirestoreContextReference, FirestoreDrivers, FirestoreItemPageIterationBaseConfig<T>, FirestoreDocumentAccessorFactoryConfig<T, D> {
+}
+/**
+* Instance that provides several accessors for accessing documents of a collection.
+*/
+export interface FirestoreCollection<T, D extends FirestoreDocument<T> = FirestoreDocument<T>> extends FirestoreContextReference, CollectionReferenceRef<T>, FirestoreItemPageIterationFactory<T>, FirestoreDocumentAccessorFactory<T, D>, FirestoreQueryFactory<T>, FirestoreDocumentAccessorForTransactionFactory<T, D>, FirestoreDocumentAccessorForWriteBatchFactory<T, D>, FirestoreCollectionQueryFactory<T, D> {
+    readonly config: FirestoreCollectionConfig<T, D>;
+}
+/**
+* Ref to a FirestoreCollection
+*/
+export interface FirestoreCollectionRef<T, D extends FirestoreDocument<T> = FirestoreDocument<T>> {
+    readonly firestoreCollection: FirestoreCollection<T, D>;
+}
+/**
+* Creates a new FirestoreCollection from the input config.
+*/
+export declare function makeFirestoreCollection<T, D extends FirestoreDocument<T>>(config: FirestoreCollectionConfig<T, D>): FirestoreCollection<T, D>;

package/src/lib/common/firestore/collection/collection.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeFirestoreCollection = void 0;
+const document_1 = require("../accessor/document");
+const iterator_1 = require("../query/iterator");
+const query_1 = require("../query/query");
+const collection_query_1 = require("./collection.query");
+/**
+* Creates a new FirestoreCollection from the input config.
+*/
+function makeFirestoreCollection(config) {
+    const { collection, firestoreContext, firestoreAccessorDriver } = config;
+    const firestoreIteration = (0, iterator_1.firestoreItemPageIterationFactory)(config);
+    const documentAccessor = (0, document_1.firestoreDocumentAccessorFactory)(config);
+    const queryFactory = (0, query_1.firestoreQueryFactory)(config);
+    const documentAccessorExtension = (0, document_1.firestoreDocumentAccessorContextExtension)({ documentAccessor, firestoreAccessorDriver });
+    const { queryDocument } = (0, collection_query_1.firestoreCollectionQueryFactory)(queryFactory, documentAccessorExtension);
+    const { query } = queryFactory;
+    return Object.assign(Object.assign({ config,
+        collection,
+        firestoreContext }, documentAccessorExtension), { firestoreIteration,
+        query,
+        queryDocument });
+}
+exports.makeFirestoreCollection = makeFirestoreCollection;
+//# sourceMappingURL=collection.js.map

package/src/lib/common/firestore/collection/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/collection/collection.ts"],"names":[],"mappings":";;;AAAA,mDAAyV;AACzV,gDAA0L;AAE1L,0CAA8E;AAE9E,yDAAsG;AAyBtG;;EAEE;AACF,SAAgB,uBAAuB,CAAoC,MAAuC;IAChH,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,GAAG,MAAM,CAAC;IACzE,MAAM,kBAAkB,GAAiD,IAAA,4CAAiC,EAAC,MAAM,CAAC,CAAC;IACnH,MAAM,gBAAgB,GAAmD,IAAA,2CAAgC,EAAC,MAAM,CAAC,CAAC;IAClH,MAAM,YAAY,GAA6B,IAAA,6BAAqB,EAAC,MAAM,CAAC,CAAC;IAE7E,MAAM,yBAAyB,GAAG,IAAA,oDAAyC,EAAC,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,CAAC,CAAC;IAC3H,MAAM,EAAE,aAAa,EAAE,GAAG,IAAA,kDAA+B,EAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC;IACnG,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC;IAE/B,qCACE,MAAM;QACN,UAAU;QACV,gBAAgB,IACb,yBAAyB,KAC5B,kBAAkB;QAClB,KAAK;QACL,aAAa,IACb;AACJ,CAAC;AAnBD,0DAmBC"}

package/src/lib/common/firestore/collection/collection.query.d.ts

@@ -0,0 +1,36 @@
+import { FirestoreDocumentAccessorContextExtension } from './../accessor/document';
+import { ArrayOrValue, Maybe } from "@dereekb/util";
+import { FirestoreDocument } from "../accessor/document";
+import { FirestoreExecutableQuery, FirestoreQueryFactory } from "../query";
+import { FirestoreQueryConstraint } from "../query/constraint";
+import { Transaction } from "../types";
+import { Observable } from 'rxjs';
+export interface FirestoreCollectionExecutableDocumentQuery<T, D extends FirestoreDocument<T>> {
+    readonly baseQuery: FirestoreExecutableQuery<T>;
+    /**
+     * Returns the first/single document.
+     */
+    getFirstDoc(transaction?: Transaction): Promise<Maybe<D>>;
+    /**
+     * Returns the results in a Promise.
+     */
+    getDocs(transaction?: Transaction): Promise<D[]>;
+    /**
+     * Streams the results as an Observable.
+     */
+    streamDocs(): Observable<D[]>;
+    /**
+     * Extend this query by adding additional filters.
+     *
+     * @param queryConstraints
+     */
+    filter(...queryConstraints: ArrayOrValue<FirestoreQueryConstraint>[]): FirestoreCollectionExecutableDocumentQuery<T, D>;
+}
+/**
+ * Creates a new FirestoreExecutableQuery from the input constraints for a FirestoreDocument.
+ */
+export declare type FirestoreCollectionQueryFactoryFunction<T, D extends FirestoreDocument<T>> = (...queryConstraints: ArrayOrValue<FirestoreQueryConstraint>[]) => FirestoreCollectionExecutableDocumentQuery<T, D>;
+export interface FirestoreCollectionQueryFactory<T, D extends FirestoreDocument<T>> {
+    readonly queryDocument: FirestoreCollectionQueryFactoryFunction<T, D>;
+}
+export declare function firestoreCollectionQueryFactory<T, D extends FirestoreDocument<T>>(queryFactory: FirestoreQueryFactory<T>, accessorContext: FirestoreDocumentAccessorContextExtension<T, D>): FirestoreCollectionQueryFactory<T, D>;

package/src/lib/common/firestore/collection/collection.query.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firestoreCollectionQueryFactory = void 0;
+const tslib_1 = require("tslib");
+const query_1 = require("../query");
+const rxjs_1 = require("rxjs");
+const accessor_1 = require("../accessor");
+function firestoreCollectionQueryFactory(queryFactory, accessorContext) {
+    const documentLoader = (0, accessor_1.firestoreDocumentLoader)(accessorContext);
+    const wrapQuery = (baseQuery) => {
+        return {
+            baseQuery,
+            getFirstDoc: (transaction) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                const result = yield baseQuery.getFirstDoc(transaction);
+                return (result) ? documentLoader([result.ref])[0] : undefined;
+            }),
+            getDocs: (transaction) => baseQuery.getDocs(transaction).then(x => documentLoader((0, query_1.documentReferencesFromSnapshot)(x))),
+            streamDocs: () => baseQuery.streamDocs().pipe((0, rxjs_1.map)(x => documentLoader((0, query_1.documentReferencesFromSnapshot)(x)))),
+            filter: (...queryConstraints) => wrapQuery(baseQuery.filter(...queryConstraints))
+        };
+    };
+    return {
+        queryDocument: (...queryConstraints) => wrapQuery(queryFactory.query(...queryConstraints))
+    };
+}
+exports.firestoreCollectionQueryFactory = firestoreCollectionQueryFactory;
+//# sourceMappingURL=collection.query.js.map

package/src/lib/common/firestore/collection/collection.query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.query.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/collection/collection.query.ts"],"names":[],"mappings":";;;;AAGA,oCAA2G;AAG3G,+BAAuC;AACvC,0CAAsD;AAiCtD,SAAgB,+BAA+B,CAAoC,YAAsC,EAAE,eAAgE;IACzL,MAAM,cAAc,GAAG,IAAA,kCAAuB,EAAC,eAAe,CAAC,CAAC;IAEhE,MAAM,SAAS,GAAiG,CAAC,SAAsC,EAAE,EAAE;QACzJ,OAAO;YACL,SAAS;YACT,WAAW,EAAE,CAAO,WAAyB,EAAE,EAAE;gBAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;gBACxD,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAChE,CAAC,CAAA;YACD,OAAO,EAAE,CAAC,WAAyB,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,IAAA,sCAA8B,EAAC,CAAC,CAAC,CAAC,CAAC;YACnI,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,IAAA,UAAG,EAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,IAAA,sCAA8B,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1G,MAAM,EAAE,CAAC,GAAG,gBAA0D,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC;SAC5H,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,aAAa,EAAE,CAAC,GAAG,gBAA0D,EAAE,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,CAAC;KACrI,CAAC;AACJ,CAAC;AAnBD,0EAmBC"}

package/src/lib/common/firestore/collection/index.d.ts

@@ -0,0 +1,3 @@
+export * from './collection';
+export * from './subcollection';
+export * from './subcollection.single';

package/src/lib/common/firestore/collection/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./collection"), exports);
+tslib_1.__exportStar(require("./subcollection"), exports);
+tslib_1.__exportStar(require("./subcollection.single"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/common/firestore/collection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/collection/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,0DAAgC;AAChC,iEAAuC"}

package/src/lib/common/firestore/collection/subcollection.d.ts

@@ -0,0 +1,25 @@
+import { FirestoreDocument } from "../accessor/document";
+import { FirestoreCollection, FirestoreCollectionConfig } from './collection';
+/**
+ * Used for collections that are a subcollection of a document.
+ */
+export interface FirestoreCollectionWithParentConfig<T, PT, D extends FirestoreDocument<T> = FirestoreDocument<T>, PD extends FirestoreDocument<PT> = FirestoreDocument<PT>> extends FirestoreCollectionConfig<T, D> {
+    /**
+     * The parent document.
+     */
+    readonly parent: PD;
+}
+/**
+ * A FirestoreCollection as a reference to a Subcollection.
+ */
+export interface FirestoreCollectionWithParent<T, PT, D extends FirestoreDocument<T> = FirestoreDocument<T>, PD extends FirestoreDocument<PT> = FirestoreDocument<PT>> extends FirestoreCollection<T, D> {
+    readonly parent: PD;
+}
+/**
+ * A FirestoreCollectionWithParent factory type.
+ */
+export declare type FirestoreCollectionWithParentFactory<T, PT, D extends FirestoreDocument<T> = FirestoreDocument<T>, PD extends FirestoreDocument<PT> = FirestoreDocument<PT>, C extends FirestoreCollectionWithParent<T, PT, D, PD> = FirestoreCollectionWithParent<T, PT, D, PD>> = (parent: PD) => C;
+/**
+ * Creates a new FirestoreCollectionWithParent from the input config.
+ */
+export declare function makeFirestoreCollectionWithParent<T, PT, D extends FirestoreDocument<T> = FirestoreDocument<T>, PD extends FirestoreDocument<PT> = FirestoreDocument<PT>>(config: FirestoreCollectionWithParentConfig<T, PT, D, PD>): FirestoreCollectionWithParent<T, PT, D, PD>;

package/src/lib/common/firestore/collection/subcollection.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeFirestoreCollectionWithParent = void 0;
+const collection_1 = require("./collection");
+/**
+ * Creates a new FirestoreCollectionWithParent from the input config.
+ */
+function makeFirestoreCollectionWithParent(config) {
+    const result = (0, collection_1.makeFirestoreCollection)(config);
+    result.parent = config.parent;
+    return result;
+}
+exports.makeFirestoreCollectionWithParent = makeFirestoreCollectionWithParent;
+//# sourceMappingURL=subcollection.js.map

package/src/lib/common/firestore/collection/subcollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subcollection.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/collection/subcollection.ts"],"names":[],"mappings":";;;AACA,6CAAuG;AA0BvG;;GAEG;AACH,SAAgB,iCAAiC,CAAyH,MAAyD;IACjO,MAAM,MAAM,GAAG,IAAA,oCAAuB,EAAC,MAAM,CAA+C,CAAC;IAC7F,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC;AAJD,8EAIC"}

package/src/lib/common/firestore/collection/subcollection.single.d.ts

@@ -0,0 +1,12 @@
+import { FirestoreDocument, FirestoreSingleDocumentAccessor } from "../accessor/document";
+import { FirestoreCollectionWithParent, FirestoreCollectionWithParentConfig } from './subcollection';
+export interface SingleItemFirestoreCollectionConfig<T, PT, D extends FirestoreDocument<T> = FirestoreDocument<T>, PD extends FirestoreDocument<PT> = FirestoreDocument<PT>> extends FirestoreCollectionWithParentConfig<T, PT, D, PD> {
+    /**
+     * Identifier of the single item.
+     */
+    readonly singleItemIdentifier: string;
+}
+export interface SingleItemFirestoreCollection<T, PT, D extends FirestoreDocument<T> = FirestoreDocument<T>, PD extends FirestoreDocument<PT> = FirestoreDocument<PT>> extends FirestoreSingleDocumentAccessor<T, D> {
+    readonly collection: FirestoreCollectionWithParent<T, PT, D, PD>;
+}
+export declare function makeSingleItemFirestoreCollection<T, PT, D extends FirestoreDocument<T> = FirestoreDocument<T>, PD extends FirestoreDocument<PT> = FirestoreDocument<PT>>(config: SingleItemFirestoreCollectionConfig<T, PT, D, PD>): SingleItemFirestoreCollection<T, PT, D, PD>;

package/src/lib/common/firestore/collection/subcollection.single.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeSingleItemFirestoreCollection = void 0;
+const document_1 = require("../accessor/document");
+const subcollection_1 = require("./subcollection");
+function makeSingleItemFirestoreCollection(config) {
+    const collection = (0, subcollection_1.makeFirestoreCollectionWithParent)(config);
+    return Object.assign({ collection }, (0, document_1.firestoreSingleDocumentAccessor)({
+        accessors: collection,
+        singleItemIdentifier: config.singleItemIdentifier
+    }));
+}
+exports.makeSingleItemFirestoreCollection = makeSingleItemFirestoreCollection;
+//# sourceMappingURL=subcollection.single.js.map

package/src/lib/common/firestore/collection/subcollection.single.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subcollection.single.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/collection/subcollection.single.ts"],"names":[],"mappings":";;;AAAA,mDAA2H;AAC3H,mDAAwI;AAiBxI,SAAgB,iCAAiC,CAAyH,MAAyD;IACjO,MAAM,UAAU,GAAG,IAAA,iDAAiC,EAAC,MAAM,CAAC,CAAC;IAE7D,uBACE,UAAU,IACP,IAAA,0CAA+B,EAAC;QACjC,SAAS,EAAE,UAAU;QACrB,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;KAClD,CAAC,EACF;AACJ,CAAC;AAVD,8EAUC"}

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

@@ -0,0 +1,36 @@
+import { FirestoreDocument } from './accessor/document';
+import { FirestoreCollection, FirestoreCollectionConfig, FirestoreCollectionWithParent, SingleItemFirestoreCollection } from "./collection";
+import { FirestoreDrivers } from './driver/driver';
+import { WriteBatchFactoryReference, RunTransactionFactoryReference } from './driver';
+import { DocumentReference, CollectionReference, DocumentData, Firestore } from "./types";
+/**
+ * A @dereekb/firestore FirestoreContext. Wraps the main Firestore context and the drivers, as well as utility/convenience functions.
+ */
+export interface FirestoreContext<F extends Firestore = Firestore> extends RunTransactionFactoryReference, WriteBatchFactoryReference {
+    readonly firestore: F;
+    readonly drivers: FirestoreDrivers;
+    collection<T = DocumentData>(path: string, ...pathSegments: string[]): CollectionReference<T>;
+    subcollection<T = DocumentData>(parent: DocumentReference, path: string, ...pathSegments: string[]): CollectionReference<T>;
+    firestoreCollection<T, D extends FirestoreDocument<T>>(config: FirestoreContextFirestoreCollectionConfig<T, D>): FirestoreCollection<T, D>;
+    firestoreCollectionWithParent<T, PT, D extends FirestoreDocument<T> = FirestoreDocument<T>, PD extends FirestoreDocument<PT> = FirestoreDocument<PT>>(config: FirestoreContextFirestoreCollectionWithParentConfig<T, PT, D, PD>): FirestoreCollectionWithParent<T, PT, D, PD>;
+    singleItemFirestoreCollection<T, PT, D extends FirestoreDocument<T> = FirestoreDocument<T>, PD extends FirestoreDocument<PT> = FirestoreDocument<PT>>(config: FirestoreContextSingleItemFirestoreCollectionConfig<T, PT, D, PD>): SingleItemFirestoreCollection<T, PT, D, PD>;
+}
+export interface FirestoreContextFirestoreCollectionConfig<T, D extends FirestoreDocument<T>> extends Omit<FirestoreCollectionConfig<T, D>, 'driverIdentifier' | 'driverType' | 'firestoreQueryDriver' | 'firestoreAccessorDriver'> {
+}
+export interface FirestoreContextFirestoreCollectionWithParentConfig<T, PT, D extends FirestoreDocument<T> = FirestoreDocument<T>, PD extends FirestoreDocument<PT> = FirestoreDocument<PT>> extends FirestoreContextFirestoreCollectionConfig<T, D> {
+    readonly parent: PD;
+}
+export interface FirestoreContextSingleItemFirestoreCollectionConfig<T, PT, D extends FirestoreDocument<T> = FirestoreDocument<T>, PD extends FirestoreDocument<PT> = FirestoreDocument<PT>> extends FirestoreContextFirestoreCollectionWithParentConfig<T, PT, D, PD> {
+    readonly singleItemIdentifier: string;
+}
+/**
+ * Factory function for generating a FirestoreContext given the input Firestore.
+ */
+export declare type FirestoreContextFactory<F extends Firestore = Firestore> = (firestore: F) => FirestoreContext;
+/**
+ * Creates a new FirestoreContextFactory given the input FirestoreDrivers.
+ *
+ * @param drivers
+ * @returns
+ */
+export declare function firestoreContextFactory<F extends Firestore = Firestore>(drivers: FirestoreDrivers): FirestoreContextFactory<F>;

package/src/lib/common/firestore/context.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firestoreContextFactory = void 0;
+const collection_1 = require("./collection");
+/**
+ * Creates a new FirestoreContextFactory given the input FirestoreDrivers.
+ *
+ * @param drivers
+ * @returns
+ */
+function firestoreContextFactory(drivers) {
+    return (firestore) => {
+        const makeFirestoreCollectionConfig = (config) => (Object.assign(Object.assign({}, config), { firestoreContext: context, driverIdentifier: drivers.driverIdentifier, driverType: drivers.driverType, firestoreQueryDriver: drivers.firestoreQueryDriver, firestoreAccessorDriver: drivers.firestoreAccessorDriver }));
+        const firestoreCollection = (config) => (0, collection_1.makeFirestoreCollection)(makeFirestoreCollectionConfig(config));
+        const context = {
+            firestore,
+            drivers,
+            collection: (path, ...pathSegments) => drivers.firestoreAccessorDriver.collection(firestore, path, ...pathSegments),
+            subcollection: drivers.firestoreAccessorDriver.subcollection,
+            runTransaction: drivers.firestoreAccessorDriver.transactionFactoryForFirestore(firestore),
+            batch: drivers.firestoreAccessorDriver.writeBatchFactoryForFirestore(firestore),
+            firestoreCollection,
+            firestoreCollectionWithParent(inputConfig) {
+                const config = makeFirestoreCollectionConfig(inputConfig);
+                return (0, collection_1.makeFirestoreCollectionWithParent)(config);
+            },
+            singleItemFirestoreCollection(inputConfig) {
+                const config = makeFirestoreCollectionConfig(inputConfig);
+                return (0, collection_1.makeSingleItemFirestoreCollection)(config);
+            }
+        };
+        return context;
+    };
+}
+exports.firestoreContextFactory = firestoreContextFactory;
+//# sourceMappingURL=context.js.map

package/src/lib/common/firestore/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../../../packages/firebase/src/lib/common/firestore/context.ts"],"names":[],"mappings":";;;AACA,6CAAqT;AA+BrT;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAkC,OAAyB;IAChG,OAAO,CAAC,SAAY,EAAE,EAAE;QACtB,MAAM,6BAA6B,GAAG,CAAoC,MAAmM,EAAE,EAAE,CAAC,iCAC7Q,MAAM,KACT,gBAAgB,EAAE,OAAO,EACzB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAC1C,UAAU,EAAE,OAAO,CAAC,UAAU,EAC9B,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,EAClD,uBAAuB,EAAE,OAAO,CAAC,uBAAuB,IACxD,CAAC;QAEH,MAAM,mBAAmB,GAAG,CAAoC,MAAuD,EAAE,EAAE,CAAC,IAAA,oCAAuB,EAAC,6BAA6B,CAAC,MAAM,CAAC,CAAC,CAAC;QAE3L,MAAM,OAAO,GAAwB;YACnC,SAAS;YACT,OAAO;YACP,UAAU,EAAE,CAAC,IAAY,EAAE,GAAG,YAAsB,EAAE,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC;YACrI,aAAa,EAAE,OAAO,CAAC,uBAAuB,CAAC,aAAa;YAC5D,cAAc,EAAE,OAAO,CAAC,uBAAuB,CAAC,8BAA8B,CAAC,SAAS,CAAC;YACzF,KAAK,EAAE,OAAO,CAAC,uBAAuB,CAAC,6BAA6B,CAAC,SAAS,CAAC;YAC/E,mBAAmB;YACnB,6BAA6B,CAAyH,WAA8D;gBAClN,MAAM,MAAM,GAAsD,6BAA6B,CAAC,WAAW,CAAsD,CAAC;gBAClK,OAAO,IAAA,8CAAiC,EAAC,MAAM,CAAC,CAAC;YACnD,CAAC;YACD,6BAA6B,CAAyH,WAA8E;gBAClO,MAAM,MAAM,GAAsD,6BAA6B,CAAC,WAAW,CAAsD,CAAC;gBAClK,OAAO,IAAA,8CAAiC,EAAC,MAAM,CAAC,CAAC;YACnD,CAAC;SACF,CAAC;QAEF,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC;AAjCD,0DAiCC"}

package/src/lib/common/firestore/driver/accessor.d.ts

@@ -0,0 +1,26 @@
+import { DocumentData, CollectionReference, DocumentReference, Firestore } from '../types';
+import { DefaultFirestoreDocumentContextFactory } from '../accessor/context.default';
+import { WriteBatchFirestoreDocumentContextFactory } from '../accessor/context.batch';
+import { TransactionFirestoreDocumentContextFactory } from '../accessor/context.transaction';
+import { FirestoreWriteBatchFactoryDriver } from './batch';
+import { FirestoreTransactionFactoryDriver } from './transaction';
+export declare type FirestoreAccessorDriverCollectionRefFunction = <T = DocumentData>(firestore: Firestore, path: string, ...pathSegments: string[]) => CollectionReference<T>;
+export declare type FirestoreAccessorDriverSubcollectionRefFunction = <T = DocumentData>(document: DocumentReference, path: string, ...pathSegments: string[]) => CollectionReference<T>;
+export declare type FirestoreAccessorDriverDocumentRefFunction = <T = DocumentData>(collection: CollectionReference<T>, path?: string, ...pathSegments: string[]) => DocumentReference<T>;
+/**
+ * A driver to use for query functionality.
+ */
+export interface FirestoreAccessorDriver extends FirestoreTransactionFactoryDriver, FirestoreWriteBatchFactoryDriver {
+    readonly doc: FirestoreAccessorDriverDocumentRefFunction;
+    readonly collection: FirestoreAccessorDriverCollectionRefFunction;
+    readonly subcollection: FirestoreAccessorDriverSubcollectionRefFunction;
+    readonly defaultContextFactory: DefaultFirestoreDocumentContextFactory;
+    readonly writeBatchContextFactory: WriteBatchFirestoreDocumentContextFactory;
+    readonly transactionContextFactory: TransactionFirestoreDocumentContextFactory;
+}
+/**
+ * Ref to a FirestoreAccessorDriver.
+ */
+export interface FirestoreAccessorDriverRef {
+    firestoreAccessorDriver: FirestoreAccessorDriver;
+}

package/src/lib/common/firestore/driver/accessor.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=accessor.js.map

package/src/lib/common/firestore/driver/accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessor.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/driver/accessor.ts"],"names":[],"mappings":""}

package/src/lib/common/firestore/driver/batch.d.ts

@@ -0,0 +1,22 @@
+import { Factory } from '@dereekb/util';
+import { Firestore, WriteBatch } from '../types';
+/**
+ * Factory for a WriteBatch.
+ */
+export declare type WriteBatchFactory = Factory<WriteBatch>;
+/**
+ * Factory for making a WriteBatchFactory for the input Firestore.
+ */
+export declare type WriteBatchForFirestoreFactory = (firestore: Firestore) => WriteBatchFactory;
+/**
+ * Reference to a WriteBatchFactory.
+ */
+export interface WriteBatchFactoryReference {
+    readonly batch: WriteBatchFactory;
+}
+/**
+ * Driver for prividing a WriteBatchForFirestoreFactory
+ */
+export interface FirestoreWriteBatchFactoryDriver {
+    readonly writeBatchFactoryForFirestore: WriteBatchForFirestoreFactory;
+}

package/src/lib/common/firestore/driver/batch.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=batch.js.map

package/src/lib/common/firestore/driver/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/driver/batch.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,11 @@
+import { FirestoreAccessorDriverRef } from "./accessor";
+import { FirestoreQueryDriverRef } from "./query";
+export declare type FirestoreDriverIdentifier = string;
+export declare type FirestoreDriverType = 'production' | 'testing';
+/**
+ * Implements all Firestore related driver reference interfaces.
+ */
+export interface FirestoreDrivers extends FirestoreQueryDriverRef, FirestoreAccessorDriverRef {
+    driverIdentifier?: FirestoreDriverIdentifier;
+    driverType: FirestoreDriverType;
+}

package/src/lib/common/firestore/driver/driver.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=driver.js.map

package/src/lib/common/firestore/driver/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/driver/driver.ts"],"names":[],"mappings":""}

package/src/lib/common/firestore/driver/index.d.ts

@@ -0,0 +1,6 @@
+export * from './driver';
+export * from './transaction';
+export * from './batch';
+export * from './query';
+export * from './query.handler';
+export * from './accessor';

package/src/lib/common/firestore/driver/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./driver"), exports);
+tslib_1.__exportStar(require("./transaction"), exports);
+tslib_1.__exportStar(require("./batch"), exports);
+tslib_1.__exportStar(require("./query"), exports);
+tslib_1.__exportStar(require("./query.handler"), exports);
+tslib_1.__exportStar(require("./accessor"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/common/firestore/driver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/driver/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,wDAA8B;AAC9B,kDAAwB;AACxB,kDAAwB;AACxB,0DAAgC;AAChC,qDAA2B"}

package/src/lib/common/firestore/driver/query.d.ts

@@ -0,0 +1,31 @@
+import { SnapshotListenOptions, Transaction } from './../types';
+import { Observable } from 'rxjs';
+import { Query, QuerySnapshot } from "../types";
+import { FirestoreQueryConstraint } from "../query/constraint";
+import { Maybe } from '@dereekb/util';
+export declare type FirestoreQueryDriverQueryFunction = <T>(query: Query<T>, ...queryConstraints: FirestoreQueryConstraint[]) => Query<T>;
+export interface FirestoreQueryConstraintFunctionsDriver {
+    readonly availableConstraintTypes: Set<string>;
+    query: FirestoreQueryDriverQueryFunction;
+}
+/**
+ * A driver to use for query functionality.
+ */
+export interface FirestoreQueryDriver extends FirestoreQueryConstraintFunctionsDriver {
+    /**
+     * Retrieves a QuerySnapshot based on the input Query. A transaction may optionally be provided.
+     *
+     * Drivers that do not support the use of the transaction will throw an exception.
+     *
+     * @param query
+     * @param transaction
+     */
+    getDocs<T>(query: Query<T>, transaction?: Transaction): Promise<QuerySnapshot<T>>;
+    streamDocs<T>(query: Query<T>, options?: Maybe<SnapshotListenOptions>): Observable<QuerySnapshot<T>>;
+}
+/**
+ * Ref to a FirestoreQueryDriver.
+ */
+export interface FirestoreQueryDriverRef {
+    readonly firestoreQueryDriver: FirestoreQueryDriver;
+}

package/src/lib/common/firestore/driver/query.handler.d.ts

@@ -0,0 +1,9 @@
+import { Query } from '../types';
+import { FirestoreQueryConstraintHandlerMap } from "../query/constraint";
+import { FirestoreQueryConstraintFunctionsDriver } from './query';
+export interface MakeFirestoreQueryConstraintFunctionsDriver<B> {
+    mapping: FirestoreQueryConstraintHandlerMap<B>;
+    init: <T>(query: Query<T>) => B;
+    build: <T>(builder: B) => Query<T>;
+}
+export declare function makeFirestoreQueryConstraintFunctionsDriver<B>(config: MakeFirestoreQueryConstraintFunctionsDriver<B>): FirestoreQueryConstraintFunctionsDriver;

package/src/lib/common/firestore/driver/query.handler.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeFirestoreQueryConstraintFunctionsDriver = void 0;
+const util_1 = require("@dereekb/util");
+function makeFirestoreQueryConstraintFunctionsDriver(config) {
+    const { mapping, init, build } = config;
+    const constraintsMap = (0, util_1.objectToMap)(mapping);
+    const availableConstraintTypes = new Set(constraintsMap.keys());
+    const query = (query, ...queryConstraints) => {
+        let builder = init(query);
+        queryConstraints.forEach((x) => {
+            const handler = constraintsMap.get(x.type);
+            if (!handler) {
+                throw new Error(`The current driver does not support the query constraint with type "${x.type}".`);
+            }
+            builder = handler(builder, x.data, x);
+        });
+        return build(builder);
+    };
+    return {
+        availableConstraintTypes,
+        query
+    };
+}
+exports.makeFirestoreQueryConstraintFunctionsDriver = makeFirestoreQueryConstraintFunctionsDriver;
+//# sourceMappingURL=query.handler.js.map

package/src/lib/common/firestore/driver/query.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.handler.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/driver/query.handler.ts"],"names":[],"mappings":";;;AAAA,wCAA4C;AAW5C,SAAgB,2CAA2C,CAAI,MAAsD;IACnH,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACxC,MAAM,cAAc,GAAG,IAAA,kBAAW,EAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,wBAAwB,GAAgB,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAsC,CAAI,KAAe,EAAE,GAAG,gBAA4C,EAAE,EAAE;QACvH,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAE1B,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAA2B,EAAE,EAAE;YACvD,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAE3C,IAAI,CAAC,OAAO,EAAE;gBACZ,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;aACpG;YAED,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAE,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,OAAO;QACL,wBAAwB;QACxB,KAAK;KACN,CAAC;AACJ,CAAC;AAxBD,kGAwBC"}

package/src/lib/common/firestore/driver/query.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=query.js.map