@dereekb/firebase 2.0.0 → 4.0.0

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

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

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

@@ -0,0 +1,23 @@
+import { Firestore, Transaction, ReadOnlyTransactionOptions, ReadWriteTransactionOptions } from '../types';
+/**
+ * Function that runs in a transaction context and returns a value.
+ */
+export declare type TransactionFunction<T = any> = (transaction: Transaction) => Promise<T>;
+/**
+ * Factory for running transactions. Creates a new Transaction, runs it with the input TransactionFunction, and returns the result.
+ */
+export declare type RunTransaction = <T>(fn: TransactionFunction<T>, options?: RunTransactionParams) => Promise<T>;
+export declare type RunTransactionParams = ReadOnlyTransactionOptions | ReadWriteTransactionOptions;
+/**
+ * Factory for making a RunTransactionFunction for the input Firestore.
+ */
+export declare type RunTransactionForFirestoreFactory = (firestore: Firestore) => RunTransaction;
+export interface RunTransactionFactoryReference {
+    readonly runTransaction: RunTransaction;
+}
+/**
+ * Driver for prividing a RunTransactionForFirestoreFactory
+ */
+export interface FirestoreTransactionFactoryDriver {
+    readonly transactionFactoryForFirestore: RunTransactionForFirestoreFactory;
+}

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

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

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

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

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

@@ -0,0 +1,8 @@
+export * from './accessor';
+export * from './snapshot';
+export * from './query';
+export * from './context';
+export * from './driver';
+export * from './collection';
+export * from './types';
+export * from './reference';

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./accessor"), exports);
+tslib_1.__exportStar(require("./snapshot"), exports);
+tslib_1.__exportStar(require("./query"), exports);
+tslib_1.__exportStar(require("./context"), exports);
+tslib_1.__exportStar(require("./driver"), exports);
+tslib_1.__exportStar(require("./collection"), exports);
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./reference"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/firebase/src/lib/common/firestore/index.ts"],"names":[],"mappings":";;;AAAA,qDAA2B;AAC3B,qDAA2B;AAC3B,kDAAwB;AACxB,oDAA0B;AAC1B,mDAAyB;AACzB,uDAA6B;AAC7B,kDAAwB;AACxB,sDAA4B"}

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

@@ -0,0 +1,24 @@
+import { ItemAccumulatorInstance, ItemAccumulatorMapFunction, PageItemIteration } from "@dereekb/rxjs";
+import { MapFunction } from "@dereekb/util";
+import { DocumentDataWithId, QueryDocumentSnapshotArray } from "../types";
+import { FirestoreItemPageIterationInstance } from "./iterator";
+export declare type MappedFirebaseQuerySnapshotAccumulator<O, T> = ItemAccumulatorInstance<O, QueryDocumentSnapshotArray<T>, PageItemIteration<QueryDocumentSnapshotArray<T>>>;
+export declare type FirebaseQuerySnapshotAccumulator<T> = MappedFirebaseQuerySnapshotAccumulator<QueryDocumentSnapshotArray<T>, T>;
+/**
+ * Mapped accumulator for QueryDocumentSnapshotArray values that returns the DocumentDataWithId values for the items returned in the query.
+ */
+export declare type FirebaseQueryItemAccumulator<T> = MappedFirebaseQuerySnapshotAccumulator<DocumentDataWithId<T>[], T>;
+/**
+ * Wrapper for itemAccumulator that has typings for a FirestoreItemPageIterationInstance. Can optionally map the snapshots to another type.
+ *
+ * @param iteration
+ */
+export declare function firebaseQuerySnapshotAccumulator<O, T>(iteration: FirestoreItemPageIterationInstance<T>): FirebaseQuerySnapshotAccumulator<T>;
+export declare function firebaseQuerySnapshotAccumulator<O, T>(iteration: FirestoreItemPageIterationInstance<T>, mapSnapshots?: ItemAccumulatorMapFunction<O, QueryDocumentSnapshotArray<T>>): MappedFirebaseQuerySnapshotAccumulator<O, T>;
+/**
+ * Convenience function for creating a FirebaseQueryItemAccumulator
+ *
+ * @param iteration
+ */
+export declare function firebaseQueryItemAccumulator<T>(iteration: FirestoreItemPageIterationInstance<T>): FirebaseQueryItemAccumulator<T>;
+export declare function firebaseQueryItemAccumulator<U, T>(iteration: FirestoreItemPageIterationInstance<T>, mapItem?: MapFunction<DocumentDataWithId<T>, U>): MappedFirebaseQuerySnapshotAccumulator<U[], T>;

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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firebaseQueryItemAccumulator = exports.firebaseQuerySnapshotAccumulator = void 0;
+const rxjs_1 = require("@dereekb/rxjs");
+function firebaseQuerySnapshotAccumulator(iteration, mapSnapshots) {
+    return (0, rxjs_1.itemAccumulator)(iteration, mapSnapshots);
+}
+exports.firebaseQuerySnapshotAccumulator = firebaseQuerySnapshotAccumulator;
+function firebaseQueryItemAccumulator(iteration, mapItem) {
+    mapItem = mapItem !== null && mapItem !== void 0 ? mapItem : ((x) => x);
+    const mapFn = (x) => {
+        const result = x.map(y => {
+            const data = y.data();
+            data.id = y.id;
+            return mapItem(data);
+        });
+        return result;
+    };
+    return firebaseQuerySnapshotAccumulator(iteration, mapFn);
+}
+exports.firebaseQueryItemAccumulator = firebaseQueryItemAccumulator;
+//# sourceMappingURL=accumulator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accumulator.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/query/accumulator.ts"],"names":[],"mappings":";;;AAAA,wCAAwH;AAoBxH,SAAgB,gCAAgC,CAAO,SAAgD,EAAE,YAA2E;IAClL,OAAO,IAAA,sBAAe,EAAqF,SAAS,EAAE,YAAY,CAAC,CAAC;AACtI,CAAC;AAFD,4EAEC;AASD,SAAgB,4BAA4B,CAAO,SAAgD,EAAE,OAA+C;IAClJ,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAK,CAAC,CAAC,CAAwB,EAAE,EAAE,CAAC,CAAC,CAAsD,CAAC;IAE7G,MAAM,KAAK,GAAmE,CAAC,CAAgC,EAAE,EAAE;QACjH,MAAM,MAAM,GAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAA2B,CAAC;YAC/C,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;YACf,OAAO,OAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,gCAAgC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC;AAdD,oEAcC"}

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

@@ -0,0 +1,112 @@
+import { ArrayOrValue, SeparateResult } from '@dereekb/util';
+import { SortingOrder, Maybe, ObjectMap } from '@dereekb/util';
+import { DocumentSnapshot, DocumentData, FieldPath } from '../types';
+export declare type FirestoreQueryConstraintType = string;
+/**
+ * A constraint. Used by drivers to apply native firebase query constraints.
+ */
+export interface FirestoreQueryConstraint<T = any> {
+    type: FirestoreQueryConstraintType;
+    data: T;
+}
+export declare function firestoreQueryConstraint<T>(type: string, data: T): FirestoreQueryConstraint<T>;
+export declare function firestoreQueryConstraintFactory(type: string): <T>(data: T) => FirestoreQueryConstraint<T>;
+export declare const FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE = "limit";
+export interface LimitQueryConstraintData {
+    limit: number;
+}
+/**
+ * Limits the maximum number of documents to return.
+ *
+ * @param limit
+ * @returns
+ */
+export declare function limit(limit: number): FirestoreQueryConstraint<LimitQueryConstraintData>;
+export declare const FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE = "limit_to_last";
+export interface LimitToLastQueryConstraintData {
+    limit: number;
+}
+/**
+ * Returns the last matching documents in the query, up to the limit.
+ *
+ * Does not work with queries with streamed results.
+ */
+export declare function limitToLast(limit: number): FirestoreQueryConstraint<LimitToLastQueryConstraintData>;
+export declare const FIRESTORE_OFFSET_QUERY_CONSTRAINT_TYPE = "offset";
+export interface OffsetQueryConstraintData {
+    offset: number;
+}
+export declare function offset(offset: number): FirestoreQueryConstraint<OffsetQueryConstraintData>;
+export declare const FIRESTORE_WHERE_QUERY_CONSTRAINT_TYPE = "where";
+export declare type WhereFilterOp = '<' | '<=' | '==' | '!=' | '>=' | '>' | 'array-contains' | 'in' | 'array-contains-any' | 'not-in';
+export interface WhereQueryConstraintData {
+    fieldPath: string | FieldPath;
+    opStr: WhereFilterOp;
+    value: unknown;
+}
+export declare function where<T>(fieldPath: keyof T, opStr: WhereFilterOp, value: unknown): FirestoreQueryConstraint<WhereQueryConstraintData>;
+export declare function where(fieldPath: string | FieldPath, opStr: WhereFilterOp, value: unknown): FirestoreQueryConstraint<WhereQueryConstraintData>;
+export declare const FIRESTORE_ORDER_BY_QUERY_CONSTRAINT_TYPE = "order_by";
+export declare type OrderByDirection = SortingOrder;
+export interface OrderByQueryConstraintData {
+    fieldPath: string | FieldPath;
+    directionStr?: OrderByDirection;
+}
+export declare function orderBy(fieldPath: string | FieldPath, directionStr?: OrderByDirection): FirestoreQueryConstraint<OrderByQueryConstraintData>;
+export declare const FIRESTORE_START_AT_QUERY_CONSTRAINT_TYPE = "start_at";
+export interface StartAtQueryConstraintData<T = DocumentData> {
+    snapshot: DocumentSnapshot<T>;
+}
+export declare function startAt<T = DocumentData>(snapshot: DocumentSnapshot<T>): FirestoreQueryConstraint<StartAtQueryConstraintData<T>>;
+export declare const FIRESTORE_START_AFTER_QUERY_CONSTRAINT_TYPE = "start_after";
+export interface StartAfterQueryConstraintData<T = DocumentData> {
+    snapshot: DocumentSnapshot<T>;
+}
+export declare function startAfter<T = DocumentData>(snapshot: DocumentSnapshot<T>): FirestoreQueryConstraint<StartAfterQueryConstraintData<T>>;
+export declare const FIRESTORE_END_AT_QUERY_CONSTRAINT_TYPE = "end_at";
+export interface EndAtQueryConstraintData<T = DocumentData> {
+    snapshot: DocumentSnapshot<T>;
+}
+/**
+ *
+ * @param snapshot
+ * @returns
+ */
+export declare function endAt<T = DocumentData>(snapshot: DocumentSnapshot<T>): FirestoreQueryConstraint<EndAtQueryConstraintData<T>>;
+export declare const FIRESTORE_END_BEFORE_QUERY_CONSTRAINT_TYPE = "end_before";
+export interface EndBeforeQueryConstraintData<T = DocumentData> {
+    snapshot: DocumentSnapshot<T>;
+}
+/**
+ *
+ * @param snapshot
+ * @returns
+ */
+export declare function endBefore<T = DocumentData>(snapshot: DocumentSnapshot<T>): FirestoreQueryConstraint<EndBeforeQueryConstraintData<T>>;
+/**
+ * Updates the input builder with the passed constraint value.
+ */
+export declare type FirestoreQueryConstraintHandlerFunction<B, D = any> = (builder: B, data: D, constraint: FirestoreQueryConstraint<D>) => B;
+export declare type FirestoreQueryConstraintHandlerMap<B> = ObjectMap<Maybe<FirestoreQueryConstraintHandlerFunction<B>>>;
+export declare type FullFirestoreQueryConstraintDataMapping = {
+    [FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE]: LimitQueryConstraintData;
+    [FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE]: LimitToLastQueryConstraintData;
+    [FIRESTORE_WHERE_QUERY_CONSTRAINT_TYPE]: WhereQueryConstraintData;
+    [FIRESTORE_OFFSET_QUERY_CONSTRAINT_TYPE]: OffsetQueryConstraintData;
+    [FIRESTORE_ORDER_BY_QUERY_CONSTRAINT_TYPE]: OrderByQueryConstraintData;
+    [FIRESTORE_START_AT_QUERY_CONSTRAINT_TYPE]: StartAtQueryConstraintData;
+    [FIRESTORE_START_AFTER_QUERY_CONSTRAINT_TYPE]: StartAfterQueryConstraintData;
+    [FIRESTORE_END_AT_QUERY_CONSTRAINT_TYPE]: EndAtQueryConstraintData;
+    [FIRESTORE_END_BEFORE_QUERY_CONSTRAINT_TYPE]: EndBeforeQueryConstraintData;
+};
+export declare type FullFirestoreQueryConstraintMapping = {
+    [K in keyof FullFirestoreQueryConstraintDataMapping]: FirestoreQueryConstraint<FullFirestoreQueryConstraintDataMapping[K]>;
+};
+export declare type FullFirestoreQueryConstraintHandlersMapping<B> = {
+    [K in keyof FullFirestoreQueryConstraintMapping]: Maybe<FirestoreQueryConstraintHandlerFunction<B, FullFirestoreQueryConstraintDataMapping[K]>>;
+};
+export declare function addOrReplaceLimitInConstraints(limit: number, addedLimitType?: (typeof FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE | typeof FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE)): (constraints: FirestoreQueryConstraint[]) => FirestoreQueryConstraint[];
+export declare type FirestoreQueryConstraintMapFunction = (constraints: FirestoreQueryConstraint[]) => FirestoreQueryConstraint[];
+export declare function filterConstraintsOfType(...types: FirestoreQueryConstraintType[]): FirestoreQueryConstraintMapFunction;
+export declare function replaceConstraints(replaceFn: (constraints: FirestoreQueryConstraint[]) => Maybe<ArrayOrValue<FirestoreQueryConstraint>>, types: FirestoreQueryConstraintType[]): (constraints: FirestoreQueryConstraint[]) => FirestoreQueryConstraint[];
+export declare function separateConstraints(...types: FirestoreQueryConstraintType[]): (constraints: FirestoreQueryConstraint[]) => SeparateResult<FirestoreQueryConstraint>;

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

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.separateConstraints = exports.replaceConstraints = exports.filterConstraintsOfType = exports.addOrReplaceLimitInConstraints = exports.endBefore = exports.FIRESTORE_END_BEFORE_QUERY_CONSTRAINT_TYPE = exports.endAt = exports.FIRESTORE_END_AT_QUERY_CONSTRAINT_TYPE = exports.startAfter = exports.FIRESTORE_START_AFTER_QUERY_CONSTRAINT_TYPE = exports.startAt = exports.FIRESTORE_START_AT_QUERY_CONSTRAINT_TYPE = exports.orderBy = exports.FIRESTORE_ORDER_BY_QUERY_CONSTRAINT_TYPE = exports.where = exports.FIRESTORE_WHERE_QUERY_CONSTRAINT_TYPE = exports.offset = exports.FIRESTORE_OFFSET_QUERY_CONSTRAINT_TYPE = exports.limitToLast = exports.FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE = exports.limit = exports.FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE = exports.firestoreQueryConstraintFactory = exports.firestoreQueryConstraint = void 0;
+const util_1 = require("@dereekb/util");
+function firestoreQueryConstraint(type, data) {
+    return {
+        type,
+        data
+    };
+}
+exports.firestoreQueryConstraint = firestoreQueryConstraint;
+function firestoreQueryConstraintFactory(type) {
+    return (data) => firestoreQueryConstraint(type, data);
+}
+exports.firestoreQueryConstraintFactory = firestoreQueryConstraintFactory;
+// MARK: Limit
+exports.FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE = 'limit';
+/**
+ * Limits the maximum number of documents to return.
+ *
+ * @param limit
+ * @returns
+ */
+function limit(limit) {
+    return firestoreQueryConstraint(exports.FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE, { limit });
+}
+exports.limit = limit;
+// MARK: Limit To Last
+exports.FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE = 'limit_to_last';
+/**
+ * Returns the last matching documents in the query, up to the limit.
+ *
+ * Does not work with queries with streamed results.
+ */
+function limitToLast(limit) {
+    return firestoreQueryConstraint(exports.FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE, { limit });
+}
+exports.limitToLast = limitToLast;
+// MARK: Offset
+exports.FIRESTORE_OFFSET_QUERY_CONSTRAINT_TYPE = 'offset';
+function offset(offset) {
+    return firestoreQueryConstraint(exports.FIRESTORE_OFFSET_QUERY_CONSTRAINT_TYPE, { offset });
+}
+exports.offset = offset;
+// MARK: Where
+exports.FIRESTORE_WHERE_QUERY_CONSTRAINT_TYPE = 'where';
+function where(fieldPath, opStr, value) {
+    return firestoreQueryConstraint(exports.FIRESTORE_WHERE_QUERY_CONSTRAINT_TYPE, { fieldPath, opStr, value });
+}
+exports.where = where;
+// MARK: OrderBy
+exports.FIRESTORE_ORDER_BY_QUERY_CONSTRAINT_TYPE = 'order_by';
+function orderBy(fieldPath, directionStr) {
+    return firestoreQueryConstraint(exports.FIRESTORE_ORDER_BY_QUERY_CONSTRAINT_TYPE, { fieldPath, directionStr });
+}
+exports.orderBy = orderBy;
+// MARK: Start At
+exports.FIRESTORE_START_AT_QUERY_CONSTRAINT_TYPE = 'start_at';
+function startAt(snapshot) {
+    return firestoreQueryConstraint(exports.FIRESTORE_START_AT_QUERY_CONSTRAINT_TYPE, { snapshot });
+}
+exports.startAt = startAt;
+// MARK: Start After
+exports.FIRESTORE_START_AFTER_QUERY_CONSTRAINT_TYPE = 'start_after';
+function startAfter(snapshot) {
+    return firestoreQueryConstraint(exports.FIRESTORE_START_AFTER_QUERY_CONSTRAINT_TYPE, { snapshot });
+}
+exports.startAfter = startAfter;
+// MARK: End At
+exports.FIRESTORE_END_AT_QUERY_CONSTRAINT_TYPE = 'end_at';
+/**
+ *
+ * @param snapshot
+ * @returns
+ */
+function endAt(snapshot) {
+    return firestoreQueryConstraint(exports.FIRESTORE_END_AT_QUERY_CONSTRAINT_TYPE, { snapshot });
+}
+exports.endAt = endAt;
+// MARK: End Before
+exports.FIRESTORE_END_BEFORE_QUERY_CONSTRAINT_TYPE = 'end_before';
+/**
+ *
+ * @param snapshot
+ * @returns
+ */
+function endBefore(snapshot) {
+    return firestoreQueryConstraint(exports.FIRESTORE_END_BEFORE_QUERY_CONSTRAINT_TYPE, { snapshot });
+}
+exports.endBefore = endBefore;
+// MARK: Utils
+function addOrReplaceLimitInConstraints(limit, addedLimitType = exports.FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE) {
+    const replace = replaceConstraints((constraints) => {
+        let type;
+        if (constraints.length) {
+            type = constraints[0].type;
+        }
+        else {
+            type = addedLimitType;
+        }
+        return {
+            type,
+            data: {
+                limit
+            }
+        };
+    }, [exports.FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE, exports.FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE]);
+    return replace;
+}
+exports.addOrReplaceLimitInConstraints = addOrReplaceLimitInConstraints;
+function filterConstraintsOfType(...types) {
+    const typesToFilterOut = new Set(types);
+    return (constraints) => constraints.filter(x => !typesToFilterOut.has(x.type));
+}
+exports.filterConstraintsOfType = filterConstraintsOfType;
+function replaceConstraints(replaceFn, types) {
+    const separateFn = separateConstraints(...types);
+    return (constraints) => {
+        const separated = separateFn(constraints);
+        const replacements = (0, util_1.asArray)(replaceFn(separated.excluded));
+        return (replacements) ? (0, util_1.mergeArrayOrValueIntoArray)(separated.included, replacements) : separated.included;
+    };
+}
+exports.replaceConstraints = replaceConstraints;
+function separateConstraints(...types) {
+    return (constraints) => {
+        const typesToFilterOut = new Set(types);
+        const separated = (0, util_1.separateValues)(constraints, (x) => !typesToFilterOut.has(x.type));
+        return separated;
+    };
+}
+exports.separateConstraints = separateConstraints;
+//# sourceMappingURL=constraint.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constraint.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/query/constraint.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,6 @@
+export * from './accumulator';
+export * from './constraint';
+export * from './iterator';
+export * from './query';
+export * from './query.util';
+export * from './watcher';

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./accumulator"), exports);
+tslib_1.__exportStar(require("./constraint"), exports);
+tslib_1.__exportStar(require("./iterator"), exports);
+tslib_1.__exportStar(require("./query"), exports);
+tslib_1.__exportStar(require("./query.util"), exports);
+tslib_1.__exportStar(require("./watcher"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/query/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,uDAA6B;AAC7B,qDAA2B;AAC3B,kDAAwB;AACxB,uDAA6B;AAC7B,oDAA0B"}

package/src/lib/{firestore → common/firestore/query}/iterator.d.ts

@@ -1,29 +1,55 @@
-import { PageLoadingState, ItemPageIterator, ItemPageIterationInstance, ItemPageIterationConfig, ItemPageIteratorDelegate, MappedPageItemIterationInstance } from '@dereekb/rxjs';
-import { QueryDocumentSnapshot, QueryConstraint, QuerySnapshot } from "@firebase/firestore";
-import { Maybe } from '@dereekb/util';
-import { FirestoreCollectionReference } from './reference';
-export interface FirestoreItemPageIteratorFilter {
-    queryConstraints?: Maybe<QueryConstraint[]>;
+import { PageLoadingState, ItemPageIterator, ItemPageIterationInstance, ItemPageIterationConfig, ItemPageIteratorDelegate, MappedPageItemIterationInstance, ItemPageLimit } from '@dereekb/rxjs';
+import { QueryDocumentSnapshotArray, QuerySnapshot, SnapshotListenOptions } from "../types";
+import { Maybe, ArrayOrValue } from '@dereekb/util';
+import { Observable } from "rxjs";
+import { CollectionReferenceRef } from '../reference';
+import { FirestoreQueryDriverRef } from '../driver/query';
+import { FirestoreQueryConstraint } from './constraint';
+export interface FirestoreItemPageIteratorFilter extends ItemPageLimit {
+    /**
+     * Overrides the default limit, if applicable.
+     */
+    limit?: Maybe<number>;
+    /**
+     * Constraints to query on.
+     */
+    constraints?: Maybe<ArrayOrValue<FirestoreQueryConstraint>>;
 }
-export interface FirestoreItemPageIterationBaseConfig<T> extends FirestoreCollectionReference<T> {
+export interface FirestoreItemPageIterationBaseConfig<T> extends CollectionReferenceRef<T>, FirestoreQueryDriverRef, ItemPageLimit {
     itemsPerPage: number;
 }
 export interface FirestoreItemPageIterationConfig<T> extends FirestoreItemPageIterationBaseConfig<T>, ItemPageIterationConfig<FirestoreItemPageIteratorFilter> {
 }
 export interface FirestoreItemPageQueryResult<T> {
+    /**
+     * Time the result was read at.
+     */
+    readonly time: Date;
     /**
      * The relevant docs for this page result. This value will omit the cursor.
      */
-    docs: QueryDocumentSnapshot<T>[];
+    readonly docs: QueryDocumentSnapshotArray<T>;
     /**
      * The raw snapshot returned from the query.
      */
-    snapshot: QuerySnapshot<T>;
+    readonly snapshot: QuerySnapshot<T>;
+    /**
+     * Reloads these results as a snapshot.
+     */
+    reload(): Promise<QuerySnapshot<T>>;
+    /**
+     * Streams these results.
+     */
+    stream(options?: FirestoreItemPageQueryResultStreamOptions<T>): Observable<QuerySnapshot<T>>;
+}
+export interface FirestoreItemPageQueryResultStreamOptions<T> {
+    options?: Maybe<SnapshotListenOptions>;
 }
 export declare type FirestoreItemPageIteratorDelegate<T> = ItemPageIteratorDelegate<FirestoreItemPageQueryResult<T>, FirestoreItemPageIteratorFilter, FirestoreItemPageIterationConfig<T>>;
 export declare type InternalFirestoreItemPageIterationInstance<T> = ItemPageIterationInstance<FirestoreItemPageQueryResult<T>, FirestoreItemPageIteratorFilter, FirestoreItemPageIterationConfig<T>>;
+export declare function filterDisallowedFirestoreItemPageIteratorInputContraints(constraints: FirestoreQueryConstraint[]): FirestoreQueryConstraint[];
 export declare function makeFirestoreItemPageIteratorDelegate<T>(): FirestoreItemPageIteratorDelegate<T>;
-export declare class FirestoreItemPageIterationInstance<T> extends MappedPageItemIterationInstance<QueryDocumentSnapshot<T>[], FirestoreItemPageQueryResult<T>, PageLoadingState<QueryDocumentSnapshot<T>[]>, PageLoadingState<FirestoreItemPageQueryResult<T>>, InternalFirestoreItemPageIterationInstance<T>> {
+export declare class FirestoreItemPageIterationInstance<T> extends MappedPageItemIterationInstance<QueryDocumentSnapshotArray<T>, FirestoreItemPageQueryResult<T>, PageLoadingState<QueryDocumentSnapshotArray<T>>, PageLoadingState<FirestoreItemPageQueryResult<T>>, InternalFirestoreItemPageIterationInstance<T>> {
     constructor(snapshotIteration: InternalFirestoreItemPageIterationInstance<T>);
     get snapshotIteration(): InternalFirestoreItemPageIterationInstance<T>;
 }
@@ -31,7 +57,7 @@ export declare class FirestoreItemPageIterationInstance<T> extends MappedPageIte
  * FirestoreItemPageIteration factory.
  */
 export interface FirestoreItemPageIterationFactory<T> {
-    firestoreIteration(filter?: FirestoreItemPageIteratorFilter): FirestoreItemPageIterationInstance<T>;
+    readonly firestoreIteration: FirestoreItemPageIterationFactoryFunction<T>;
 }
 /**
  * Function that creates a FirestoreItemPageIterationInstance from the input filter.

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

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firestoreItemPageIteration = exports.FIRESTORE_ITEM_PAGE_ITERATOR = exports.FIRESTORE_ITEM_PAGE_ITERATOR_DELEGATE = exports.firestoreItemPageIterationFactory = exports.FirestoreItemPageIterationInstance = exports.makeFirestoreItemPageIteratorDelegate = exports.filterDisallowedFirestoreItemPageIteratorInputContraints = void 0;
+const rxjs_1 = require("@dereekb/rxjs");
+const util_1 = require("@dereekb/util");
+const rxjs_2 = require("rxjs");
+const constraint_1 = require("./constraint");
+function filterDisallowedFirestoreItemPageIteratorInputContraints(constraints) {
+    const isIllegal = new Set([constraint_1.FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE]);
+    return constraints.filter(x => !isIllegal.has(x.type));
+}
+exports.filterDisallowedFirestoreItemPageIteratorInputContraints = filterDisallowedFirestoreItemPageIteratorInputContraints;
+function makeFirestoreItemPageIteratorDelegate() {
+    return {
+        loadItemsForPage: (request) => {
+            const { page, iteratorConfig } = request;
+            const prevQueryResult$ = (page > 0) ? request.lastItem$ : (0, rxjs_2.of)(undefined);
+            const { collection, itemsPerPage, filter, firestoreQueryDriver: driver } = iteratorConfig;
+            const { limit: filterLimit, constraints: filterConstraints } = filter !== null && filter !== void 0 ? filter : {};
+            return prevQueryResult$.pipe((0, rxjs_2.exhaustMap)((prevResult) => {
+                if ((prevResult === null || prevResult === void 0 ? void 0 : prevResult.snapshot.empty) === true) { // TODO: Shouldn't happen. Remove this later.
+                    return (0, rxjs_2.of)({ end: true });
+                }
+                else {
+                    const constraints = [];
+                    // Add filter constraints
+                    if (filterConstraints != null) {
+                        (0, util_1.mergeIntoArray)(constraints, filterDisallowedFirestoreItemPageIteratorInputContraints((0, util_1.asArray)(filterConstraints)));
+                    }
+                    // Add cursor
+                    const cursorDocument = (prevResult) ? (0, util_1.lastValue)(prevResult.docs) : undefined;
+                    const startAfterFilter = (cursorDocument) ? (0, constraint_1.startAfter)(cursorDocument) : undefined;
+                    if (startAfterFilter) {
+                        constraints.push(startAfterFilter);
+                    }
+                    // Add Limit
+                    const limitCount = filterLimit !== null && filterLimit !== void 0 ? filterLimit : itemsPerPage + ((startAfterFilter) ? 1 : 0); // todo: may not be needed.
+                    const limitConstraint = (0, constraint_1.limit)(limitCount);
+                    const constraintsWithLimit = [...constraints, limitConstraint];
+                    // make query
+                    const batchQuery = driver.query(collection, ...constraintsWithLimit);
+                    const resultPromise = driver.getDocs(batchQuery).then((snapshot) => {
+                        const time = new Date();
+                        const docs = snapshot.docs;
+                        const result = {
+                            value: {
+                                time,
+                                docs,
+                                snapshot,
+                                reload() {
+                                    return driver.getDocs(batchQuery);
+                                },
+                                stream(options) {
+                                    // todo: consider allowing limit to be changed here to stream a subset. This will be useful for detecting collection changes.
+                                    return driver.streamDocs(batchQuery, options === null || options === void 0 ? void 0 : options.options);
+                                }
+                            },
+                            end: snapshot.empty
+                        };
+                        return result;
+                    });
+                    return (0, rxjs_2.from)(resultPromise);
+                }
+            }));
+        }
+    };
+}
+exports.makeFirestoreItemPageIteratorDelegate = makeFirestoreItemPageIteratorDelegate;
+class FirestoreItemPageIterationInstance extends rxjs_1.MappedPageItemIterationInstance {
+    constructor(snapshotIteration) {
+        super(snapshotIteration, {
+            forwardDestroy: true,
+            mapValue: (x) => x.docs
+        });
+    }
+    get snapshotIteration() {
+        return this.itemIterator;
+    }
+}
+exports.FirestoreItemPageIterationInstance = FirestoreItemPageIterationInstance;
+/**
+ * Creates a new factory function that can build FirestoreItemPageIterationInstance values from just the input filter.
+ *
+ * @param baseConfig
+ * @returns FirestoreItemPageIterationInstance
+ */
+function firestoreItemPageIterationFactory(baseConfig) {
+    return (filter) => {
+        var _a;
+        const result = firestoreItemPageIteration({
+            collection: baseConfig.collection,
+            itemsPerPage: baseConfig.itemsPerPage,
+            firestoreQueryDriver: baseConfig.firestoreQueryDriver,
+            maxPageLoadLimit: (_a = filter === null || filter === void 0 ? void 0 : filter.maxPageLoadLimit) !== null && _a !== void 0 ? _a : baseConfig.maxPageLoadLimit,
+            filter
+        });
+        return result;
+    };
+}
+exports.firestoreItemPageIterationFactory = firestoreItemPageIterationFactory;
+exports.FIRESTORE_ITEM_PAGE_ITERATOR_DELEGATE = makeFirestoreItemPageIteratorDelegate();
+exports.FIRESTORE_ITEM_PAGE_ITERATOR = new rxjs_1.ItemPageIterator(exports.FIRESTORE_ITEM_PAGE_ITERATOR_DELEGATE);
+function firestoreItemPageIteration(config) {
+    const iterator = exports.FIRESTORE_ITEM_PAGE_ITERATOR.instance(config);
+    return new FirestoreItemPageIterationInstance(iterator);
+}
+exports.firestoreItemPageIteration = firestoreItemPageIteration;
+//# sourceMappingURL=iterator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iterator.js","sourceRoot":"","sources":["../../../../../../../../packages/firebase/src/lib/common/firestore/query/iterator.ts"],"names":[],"mappings":";;;AAAA,wCAAkP;AAElP,wCAAwF;AACxF,+BAA6D;AAG7D,6CAAkH;AAiDlH,SAAgB,wDAAwD,CAAC,WAAuC;IAC9G,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,kDAAqC,CAAC,CAAC,CAAC;IACnE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC;AAHD,4HAGC;AAED,SAAgB,qCAAqC;IACnD,OAAO;QACL,gBAAgB,EAAE,CAAC,OAAuI,EAAuE,EAAE;YACjO,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;YACzC,MAAM,gBAAgB,GAAuD,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,SAAE,EAAC,SAAS,CAAC,CAAC;YAE5H,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC;YAC1F,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC;YAE5E,OAAO,gBAAgB,CAAC,IAAI,CAC1B,IAAA,iBAAU,EAAC,CAAC,UAAU,EAAE,EAAE;gBACxB,IAAI,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,QAAQ,CAAC,KAAK,MAAK,IAAI,EAAE,EAAG,6CAA6C;oBACvF,OAAO,IAAA,SAAE,EAA0D,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;iBACnF;qBAAM;oBACL,MAAM,WAAW,GAA+B,EAAE,CAAC;oBAEnD,yBAAyB;oBACzB,IAAI,iBAAiB,IAAI,IAAI,EAAE;wBAC7B,IAAA,qBAAc,EAAC,WAAW,EAAE,wDAAwD,CAAC,IAAA,cAAO,EAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;qBACnH;oBAED,aAAa;oBACb,MAAM,cAAc,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAA,gBAAS,EAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC7E,MAAM,gBAAgB,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAA,uBAAU,EAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBAEnF,IAAI,gBAAgB,EAAE;wBACpB,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;qBACpC;oBAED,YAAY;oBACZ,MAAM,UAAU,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,YAAY,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAI,2BAA2B;oBAC7G,MAAM,eAAe,GAAG,IAAA,kBAAK,EAAC,UAAU,CAAC,CAAC;oBAC1C,MAAM,oBAAoB,GAAG,CAAC,GAAG,WAAW,EAAE,eAAe,CAAC,CAAC;oBAE/D,aAAa;oBACb,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAI,UAAU,EAAE,GAAG,oBAAoB,CAAC,CAAC;oBACxE,MAAM,aAAa,GAAqE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;wBACnI,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;wBACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;wBAE3B,MAAM,MAAM,GAA4D;4BACtE,KAAK,EAAE;gCACL,IAAI;gCACJ,IAAI;gCACJ,QAAQ;gCACR,MAAM;oCACJ,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gCACpC,CAAC;gCACD,MAAM,CAAC,OAAsD;oCAC3D,6HAA6H;oCAC7H,OAAO,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,CAAC,CAAC;gCACzD,CAAC;6BACF;4BACD,GAAG,EAAE,QAAQ,CAAC,KAAK;yBACpB,CAAC;wBAEF,OAAO,MAAM,CAAC;oBAChB,CAAC,CAAC,CAAC;oBAEH,OAAO,IAAA,WAAI,EAAC,aAAa,CAAC,CAAC;iBAC5B;YACH,CAAC,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAA;AACH,CAAC;AAjED,sFAiEC;AAED,MAAa,kCAAsC,SAAQ,sCAM1D;IAEC,YAAY,iBAAgE;QAC1E,KAAK,CAAC,iBAAiB,EAAE;YACvB,cAAc,EAAE,IAAI;YACpB,QAAQ,EAAE,CAAC,CAAkC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;SACzD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;CAEF;AAnBD,gFAmBC;AAgBD;;;;;GAKG;AACH,SAAgB,iCAAiC,CAAI,UAAmD;IACtG,OAAO,CAAC,MAAwC,EAAE,EAAE;;QAClD,MAAM,MAAM,GAA0C,0BAA0B,CAAI;YAClF,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,oBAAoB,EAAE,UAAU,CAAC,oBAAoB;YACrD,gBAAgB,EAAE,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,gBAAgB,mCAAI,UAAU,CAAC,gBAAgB;YACzE,MAAM;SACP,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAZD,8EAYC;AAEY,QAAA,qCAAqC,GAA2C,qCAAqC,EAAS,CAAC;AAC/H,QAAA,4BAA4B,GAAG,IAAI,uBAAgB,CAA4G,6CAAqC,CAAC,CAAC;AAEnN,SAAgB,0BAA0B,CAAI,MAA2C;IACvF,MAAM,QAAQ,GAAkD,oCAA4B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9G,OAAO,IAAI,kCAAkC,CAAI,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAHD,gEAGC"}

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

@@ -0,0 +1,49 @@
+import { Observable } from 'rxjs';
+import { ArrayOrValue, Maybe } from "@dereekb/util";
+import { CollectionReferenceRef } from "../reference";
+import { Query, QueryDocumentSnapshot, QuerySnapshot, Transaction } from "../types";
+import { FirestoreQueryConstraint } from "./constraint";
+import { FirestoreQueryDriverRef } from '../driver/query';
+export interface FirestoreExecutableQueryGetDocsContext {
+    readonly transaction?: Transaction;
+}
+/**
+ * Immutable wrapper of a query and a way to retrieve the docs.
+ */
+export interface FirestoreExecutableQuery<T> {
+    readonly query: Query<T>;
+    /**
+     * Returns the first/single document.
+     */
+    getFirstDoc(transaction?: Transaction): Promise<Maybe<QueryDocumentSnapshot<T>>>;
+    /**
+     * Returns the results in a Promise.
+     */
+    getDocs(transaction?: Transaction): Promise<QuerySnapshot<T>>;
+    /**
+     * Streams the results as an Observable.
+     */
+    streamDocs(): Observable<QuerySnapshot<T>>;
+    /**
+     * Extend this query by adding additional filters.
+     *
+     * @param queryConstraints
+     */
+    filter(...queryConstraints: ArrayOrValue<FirestoreQueryConstraint>[]): FirestoreExecutableQuery<T>;
+}
+export declare type FirestoreQueryFactoryFunction<T> = (...queryConstraints: ArrayOrValue<FirestoreQueryConstraint>[]) => FirestoreExecutableQuery<T>;
+export interface FirestoreQueryFactory<T> {
+    /**
+     * Creates a new FirestoreExecutableQuery from the input constraints.
+     */
+    readonly query: FirestoreQueryFactoryFunction<T>;
+}
+export interface FirestoreQueryConfig<T> extends FirestoreQueryDriverRef, CollectionReferenceRef<T> {
+}
+/**
+ * Creates a FirestoreCollectionQuery.
+ *
+ * @param config
+ * @returns
+ */
+export declare function firestoreQueryFactory<T>(config: FirestoreQueryConfig<T>): FirestoreQueryFactory<T>;