firetender-admin 0.10.0

package/dist/FiretenderDoc.js

@@ -0,0 +1,361 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FiretenderDoc = void 0;
+const errors_1 = require("./errors");
+const firestore_deps_1 = require("./firestore-deps");
+const proxies_1 = require("./proxies");
+const ts_helpers_1 = require("./ts-helpers");
+/**
+ * A local representation of a Firestore document.
+ */
+class FiretenderDoc {
+    /**
+     * @param schema the Zod object schema describing this document's data.
+     * @param ref either a document reference specifying the full path of the
+     *   document, or a collection reference specifying where a new document will
+     *   be created.
+     * @param options optional parameters for the resulting FiretenderDoc; see
+     *   FiretenderDocOptions for detail.
+     */
+    constructor(schema, ref, options = {}) {
+        /** Firestore document ID; undefined for new docs not yet on Firestore */
+        this.docID = undefined;
+        /** Local copy of the document data, parsed into the Zod type */
+        this.data = undefined;
+        /** Proxy to intercept write (.w) access to the data and track the changes */
+        this.dataProxy = undefined;
+        /** Map from the dot-delimited field path (per updateDoc()) to new value */
+        this.updates = new Map();
+        this.schema = schema;
+        this.ref = ref;
+        this.isNewDoc = options.createDoc ?? false;
+        this.isSettingNewContents = this.isNewDoc;
+        if (options.initialData) {
+            this.data = schema.parse(options.initialData);
+        }
+        else if (this.isNewDoc) {
+            throw ReferenceError("Initial data must be given when creating a new doc.");
+        }
+        if (this.ref instanceof firestore_deps_1.DocumentReference) {
+            this.docID = this.ref.path.split("/").pop();
+        }
+        else if (!this.isNewDoc) {
+            throw TypeError("FiretenderDoc can only take a collection reference when creating a new document.  Use .createNewDoc() if this is your intent.");
+        }
+    }
+    /**
+     * Returns a FiretenderDoc representing a new Firestore document.
+     *
+     * This method does not create the document in Firestore.  To do so, call the
+     * write() method.
+     *
+     * @param schema the Zod object schema describing this document's data.
+     * @param ref either a document reference specifying the full path of the
+     *   document, or a collection reference specifying where a new document will
+     *   be created.
+     * @param initialData the document's initial data, which must define a valid
+     *   instance of this document according to its schema.
+     * @param options optional parameters for the resulting FiretenderDoc; see
+     *   FiretenderDocOptions for detail.
+     */
+    static createNewDoc(schema, ref, initialData, options = {}) {
+        const mergedOptions = {
+            ...options,
+            createDoc: true,
+            initialData,
+        };
+        return new FiretenderDoc(schema, ref, mergedOptions);
+    }
+    /**
+     * Creates a copy of this document.  Returns a deep copy of its data with a
+     * specified or undefined Firestore ID and reference.
+     *
+     * This method does not create the document in Firestore.  To do so, call the
+     * write() method.  If a document ID or reference is not provided, those will
+     * be unset until the write.
+     *
+     * The location of the new document depends on the type of the `dest`
+     * argument:
+     * - `undefined` (default): It will be in the same collection and will be
+     *   assigned a random ID when written to Firestore.
+     * - `string`: It will be in the same collection and have a document ID given
+     *   by `dest`.
+     * - `string[]`: It will be in the specified subcollection and receive a
+     *   random ID (if `type` does not give an ID for the deepest subcollection)
+     *   or have the fully specified Firestore path (if `type` does).
+     * - `DocumentReference`: It will have the given Firestore reference.
+     * - `CollectionReference`: It will be in the given subcollection and have a
+     *   randomly assigned ID upon writing.
+     *
+     * @param dest the location of the new document; see above for details.
+     * @param options optional parameters for the resulting FiretenderDoc; see
+     *   FiretenderDocOptions for detail.
+     */
+    copy(dest = undefined, options = {}) {
+        if (!this.data) {
+            throw new errors_1.FiretenderUsageError("You must call load() before making a copy.");
+        }
+        let ref;
+        if (dest instanceof firestore_deps_1.DocumentReference ||
+            dest instanceof firestore_deps_1.CollectionReference) {
+            ref = dest;
+        }
+        else if (Array.isArray(dest)) {
+            const path = this.ref.path.split("/");
+            if (path.length % 2 === 0) {
+                // If this doc has a ID for the deepest collection, remove it so that
+                // path always starts as a collection path.
+                path.length -= 1;
+            }
+            const collectionDepth = (path.length + 1) / 2;
+            if (dest.length < collectionDepth - 1 || dest.length > collectionDepth) {
+                throw new errors_1.FiretenderUsageError("copy() with a path array requires an ID for all collections and subcollections, except optionally the last.");
+            }
+            dest.forEach((id, index) => {
+                path[index * 2 + 1] = id;
+            });
+            ref =
+                dest.length === collectionDepth
+                    ? (0, firestore_deps_1.doc)(this.ref.firestore, path[0], ...path.slice(1))
+                    : (0, firestore_deps_1.collection)(this.ref.firestore, path[0], ...path.slice(1));
+        }
+        else {
+            // For a string or undefined ...
+            const collectionRef = this.ref instanceof firestore_deps_1.DocumentReference ? this.ref.parent : this.ref;
+            if (dest) {
+                ref = (0, firestore_deps_1.doc)(collectionRef, dest);
+            }
+            else {
+                ref = collectionRef;
+            }
+        }
+        const mergedOptions = {
+            ...options,
+            createDoc: true,
+            initialData: this.data,
+        };
+        return new FiretenderDoc(this.schema, ref, mergedOptions);
+    }
+    /**
+     * The document's ID string.
+     *
+     * @throws Throws an error if the document does not yet have an ID.
+     */
+    get id() {
+        if (!this.docID) {
+            throw new errors_1.FiretenderUsageError("id can only be accessed after the new doc has been written.");
+        }
+        return this.docID;
+    }
+    /**
+     * The document's Firestore reference.
+     *
+     * @throws Throws an error if the document does not yet have a reference.
+     */
+    get docRef() {
+        if (!(this.ref instanceof firestore_deps_1.DocumentReference)) {
+            throw new errors_1.FiretenderUsageError("docRef can only be accessed after the new doc has been written.");
+        }
+        return this.ref;
+    }
+    /**
+     * Is this a new doc that has not yet been written to Firestore?
+     */
+    isNew() {
+        return this.isNewDoc;
+    }
+    /**
+     * Does the document contain data, either because it was successfully loaded
+     * or is newly created?
+     */
+    isLoaded() {
+        return this.data !== undefined;
+    }
+    /**
+     * Does this document contain data that has not yet been written to Firestore?
+     */
+    isPendingWrite() {
+        return this.isSettingNewContents || this.updates.size > 0;
+    }
+    /**
+     * Loads this document's data from Firestore.
+     *
+     * @param force force a read from Firestore.  Normally load() does nothing if
+     *   the document already contains data.
+     */
+    async load(force = false) {
+        if (this.isNewDoc || this.ref instanceof firestore_deps_1.CollectionReference) {
+            throw new errors_1.FiretenderUsageError("load() should not be called for new documents.");
+        }
+        if (!this.data || force) {
+            if (this.resolvesWaitingForLoad !== undefined) {
+                await new Promise((resolve, reject) => {
+                    (0, ts_helpers_1.assertIsDefined)(this.resolvesWaitingForLoad);
+                    this.resolvesWaitingForLoad.push({ resolve, reject });
+                });
+            }
+            else {
+                this.resolvesWaitingForLoad = [];
+                let snapshot;
+                try {
+                    snapshot = await (0, firestore_deps_1.getDoc)(this.ref);
+                }
+                catch (error) {
+                    (0, errors_1.addContextToError)(error, "getDoc", this.ref);
+                    throw error;
+                }
+                // DocumentSnapshot.prototype.exists is a boolean for
+                // "firebase-admin/firestore" and a function for "firebase/firestore".
+                if ((typeof snapshot.exists === "boolean" && !snapshot.exists) ||
+                    (typeof snapshot.exists === "function" && !snapshot.exists())) {
+                    const error = new errors_1.FiretenderIOError(`Document does not exist: "${this.ref.path}"`);
+                    this.resolvesWaitingForLoad.forEach((wait) => wait.reject(error));
+                    throw error;
+                }
+                this.data = this.schema.parse(snapshot.data());
+                // Dereference the old proxy, if any, to force a recapture of data.
+                this.dataProxy = undefined;
+                this.resolvesWaitingForLoad.forEach((wait) => wait.resolve());
+                this.resolvesWaitingForLoad = undefined;
+            }
+        }
+        return this;
+    }
+    /**
+     * Read-only accessor to the contents of this document.
+     */
+    get r() {
+        if (!this.data) {
+            throw new errors_1.FiretenderUsageError("load() must be called before reading the document.");
+        }
+        return this.data;
+    }
+    /**
+     * Writable accessor to update the contents of this document.
+     *
+     * Only use this accessor when making changes to the doc.  The .r accessor is
+     * considerably more efficient when reading.
+     */
+    get w() {
+        if (this.isSettingNewContents) {
+            // No need to monitor changes if we're setting rather than updating.
+            return this.data;
+        }
+        if (!this.dataProxy) {
+            if (!this.data) {
+                // TODO #23: Consider being able to update a doc without loading it.
+                throw new errors_1.FiretenderUsageError("load() must be called before updating the document.");
+            }
+            this.dataProxy = (0, proxies_1.watchFieldForChanges)([], this.schema, this.data, this.addToUpdateList.bind(this));
+        }
+        return this.dataProxy;
+    }
+    /**
+     * Writable accessor to overwrite all the document data.
+     */
+    set w(newData) {
+        this.data = this.schema.parse(newData);
+        this.isSettingNewContents = true;
+        this.dataProxy = undefined;
+    }
+    /**
+     * Writes the document or any updates to Firestore.
+     */
+    async write() {
+        // For new docs, this.data should contain its initial state.
+        if (this.isSettingNewContents) {
+            (0, ts_helpers_1.assertIsDefined)(this.data);
+            if (this.ref instanceof firestore_deps_1.DocumentReference) {
+                try {
+                    await (0, firestore_deps_1.setDoc)(this.ref, this.data);
+                }
+                catch (error) {
+                    (0, errors_1.addContextToError)(error, "setDoc", this.ref, this.data);
+                    throw error;
+                }
+            }
+            else {
+                try {
+                    this.ref = await (0, firestore_deps_1.addDoc)(this.ref, this.data);
+                }
+                catch (error) {
+                    (0, errors_1.addContextToError)(error, "addDoc", this.ref, this.data);
+                    throw error;
+                }
+                this.docID = this.ref.path.split("/").pop(); // ID is last part of path.
+            }
+            this.isSettingNewContents = false;
+            this.isNewDoc = false;
+        }
+        // For existing docs, this.updates should contain a list of changes.
+        else {
+            if (!(this.ref instanceof firestore_deps_1.DocumentReference)) {
+                // We should never get here.
+                throw new errors_1.FiretenderInternalError("Internal error.  Firetender object should always reference a document when updating an existing doc.");
+            }
+            if (this.updates.size > 0) {
+                const updateData = Object.fromEntries(this.updates);
+                try {
+                    await (0, firestore_deps_1.updateDoc)(this.ref, updateData);
+                }
+                catch (error) {
+                    (0, errors_1.addContextToError)(error, "updateDoc", this.ref, updateData);
+                    throw error;
+                }
+                this.updates.clear();
+            }
+        }
+        return this;
+    }
+    /**
+     * Updates the document's data with a single call.
+     *
+     * This function loads the document's data, if necessary; calls the given
+     * function to make changes to the data; then write the changes to Firestore.
+     * If nothing else, it helps you avoid forgetting to call .write()!
+     *
+     * @param mutator function that accepts a writable data object and makes
+     *   changes to it.
+     */
+    async update(mutator) {
+        await this.load();
+        mutator(this.w);
+        await this.write();
+        return this;
+    }
+    //////////////////////////////////////////////////////////////////////////////
+    // Private functions
+    /**
+     * Adds a field and its new value to the list of updates to be passed to
+     * Firestore's updateDoc().  Called when the proxies detect changes to the
+     * document data.
+     */
+    addToUpdateList(fieldPath, newValue) {
+        let pathString = "";
+        if (this.updates.size > 0) {
+            // If there is already a list of mutations to send to Firestore, check if
+            // a parent of this update is in it.  Objects in the update list are
+            // references into this.data, so the parent field will automatically
+            // reflect this change; no additional Firestore mutation is needed.
+            if (fieldPath.some((field, i) => {
+                pathString = pathString ? `${pathString}.${field}` : field;
+                return i < fieldPath.length - 1 && this.updates.has(pathString);
+            })) {
+                return;
+            }
+            // Remove any previous updates that this one overwrites.
+            this.updates.forEach((value, key) => {
+                if (key.startsWith(pathString)) {
+                    this.updates.delete(key);
+                }
+            });
+        }
+        else {
+            // Shortcut for the common case of a single update being made.
+            pathString = fieldPath.join(".");
+        }
+        this.updates.set(pathString, newValue);
+    }
+}
+exports.FiretenderDoc = FiretenderDoc;
+//# sourceMappingURL=FiretenderDoc.js.map

package/dist/FiretenderDoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FiretenderDoc.js","sourceRoot":"","sources":["../src/FiretenderDoc.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,30 @@
+import { CollectionReference, DocumentReference } from "./firestore-deps";
+export declare class FiretenderError extends Error {
+}
+/**
+ * Something went wrong with a Firestore operation, such as trying to load a
+ * document that does not exist.
+ */
+export declare class FiretenderIOError extends FiretenderError {
+}
+/**
+ * The caller did something wrong: a function was called at the wrong time or
+ * with the wrong parameters.
+ */
+export declare class FiretenderUsageError extends FiretenderError {
+}
+/**
+ * Something went wrong internally.  These errors indicate a bug in Firetender.
+ */
+export declare class FiretenderInternalError extends FiretenderError {
+}
+/**
+ * Adds a "firetenderContext" property to the given error.
+ *
+ * @param error the error to which the context is added.  If `error` is not an
+ *   object, this call does not modify it.
+ * @param call the name of the Firestore function in which the error occurred.
+ * @param ref the path of the target document or collection, if any.
+ * @param data arbitrary data associated with this call.
+ */
+export declare function addContextToError(error: any, call: string, ref?: DocumentReference | CollectionReference, data?: any): void;

package/dist/errors.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addContextToError = exports.FiretenderInternalError = exports.FiretenderUsageError = exports.FiretenderIOError = exports.FiretenderError = void 0;
+class FiretenderError extends Error {
+}
+exports.FiretenderError = FiretenderError;
+/**
+ * Something went wrong with a Firestore operation, such as trying to load a
+ * document that does not exist.
+ */
+class FiretenderIOError extends FiretenderError {
+}
+exports.FiretenderIOError = FiretenderIOError;
+/**
+ * The caller did something wrong: a function was called at the wrong time or
+ * with the wrong parameters.
+ */
+class FiretenderUsageError extends FiretenderError {
+}
+exports.FiretenderUsageError = FiretenderUsageError;
+/**
+ * Something went wrong internally.  These errors indicate a bug in Firetender.
+ */
+class FiretenderInternalError extends FiretenderError {
+}
+exports.FiretenderInternalError = FiretenderInternalError;
+/**
+ * Adds a "firetenderContext" property to the given error.
+ *
+ * @param error the error to which the context is added.  If `error` is not an
+ *   object, this call does not modify it.
+ * @param call the name of the Firestore function in which the error occurred.
+ * @param ref the path of the target document or collection, if any.
+ * @param data arbitrary data associated with this call.
+ */
+function addContextToError(error, call, ref, data) {
+    if (typeof error !== "object") {
+        return;
+    }
+    error.firetenderContext = { call };
+    if (ref) {
+        error.firetenderContext.ref = ref.path;
+    }
+    if (data !== undefined) {
+        error.firetenderContext.data = data;
+    }
+}
+exports.addContextToError = addContextToError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAEA,MAAa,eAAgB,SAAQ,KAAK;CAAG;AAA7C,0CAA6C;AAE7C;;;GAGG;AACH,MAAa,iBAAkB,SAAQ,eAAe;CAAG;AAAzD,8CAAyD;AAEzD;;;GAGG;AACH,MAAa,oBAAqB,SAAQ,eAAe;CAAG;AAA5D,oDAA4D;AAE5D;;GAEG;AACH,MAAa,uBAAwB,SAAQ,eAAe;CAAG;AAA/D,0DAA+D;AAE/D;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAC/B,KAAU,EACV,IAAY,EACZ,GAA6C,EAC7C,IAAU;IAEV,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC7B,OAAO;KACR;IACD,KAAK,CAAC,iBAAiB,GAAG,EAAE,IAAI,EAAE,CAAC;IACnC,IAAI,GAAG,EAAE;QACP,KAAK,CAAC,iBAAiB,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC;KACxC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE;QACtB,KAAK,CAAC,iBAAiB,CAAC,IAAI,GAAG,IAAI,CAAC;KACrC;AACH,CAAC;AAhBD,8CAgBC"}

package/dist/firestore-deps-admin.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Provides all dependencies normally imported from "firebase/firestore".
+ *
+ * For web clients, the "firebase/firestore" API is simply re-exported.
+ *
+ * For the server client API, ...
+ */
+import { CollectionGroup, CollectionReference, DocumentReference, DocumentSnapshot, FieldValue, Filter, Firestore, Query, QuerySnapshot, Timestamp, UpdateData, WithFieldValue } from "@google-cloud/firestore";
+export declare const FIRESTORE_DEPS_TYPE: "web" | "admin";
+export { CollectionReference, DocumentReference, DocumentSnapshot, Firestore, Query, QuerySnapshot, Timestamp, };
+export type QueryConstraint = Filter;
+export declare const where: typeof Filter.where;
+export declare const arrayRemove: typeof FieldValue.arrayRemove;
+export declare const deleteField: typeof FieldValue.delete;
+export declare const serverTimestamp: typeof FieldValue.serverTimestamp;
+export declare const isServerTimestamp: (x: any) => boolean;
+export declare const addDoc: <T>(ref: CollectionReference<T>, data: WithFieldValue<T>) => Promise<DocumentReference<T>>;
+export declare const collection: (firestoreOrRef: Firestore | CollectionReference, path: string, ...pathSegments: string[]) => CollectionReference;
+export declare const collectionGroup: (firestore: Firestore, collectionID: string) => CollectionGroup;
+export declare const deleteDoc: (ref: DocumentReference<unknown>) => Promise<void>;
+export declare const doc: (firestoreOrRef: Firestore | CollectionReference, path?: string, ...pathSegments: string[]) => DocumentReference;
+export declare const getDoc: <T>(ref: DocumentReference<T>) => Promise<DocumentSnapshot<T>>;
+export declare const getDocs: <T>(query: Query<T>) => Promise<QuerySnapshot<T>>;
+export declare const query: <T>(ref: Query<T>, ...queryConstraints: QueryConstraint[]) => Query<T>;
+export declare const setDoc: <T>(ref: DocumentReference<T>, data: WithFieldValue<T>) => Promise<void>;
+export declare const updateDoc: <T>(ref: DocumentReference<T>, data: UpdateData<T>) => Promise<void>;

package/dist/firestore-deps-admin.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Provides all dependencies normally imported from "firebase/firestore".
+ *
+ * For web clients, the "firebase/firestore" API is simply re-exported.
+ *
+ * For the server client API, ...
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateDoc = exports.setDoc = exports.query = exports.getDocs = exports.getDoc = exports.doc = exports.deleteDoc = exports.collectionGroup = exports.collection = exports.addDoc = exports.isServerTimestamp = exports.serverTimestamp = exports.deleteField = exports.arrayRemove = exports.where = exports.Timestamp = exports.QuerySnapshot = exports.Query = exports.Firestore = exports.DocumentSnapshot = exports.DocumentReference = exports.CollectionReference = exports.FIRESTORE_DEPS_TYPE = void 0;
+const firestore_1 = require("@google-cloud/firestore");
+Object.defineProperty(exports, "CollectionReference", { enumerable: true, get: function () { return firestore_1.CollectionReference; } });
+Object.defineProperty(exports, "DocumentReference", { enumerable: true, get: function () { return firestore_1.DocumentReference; } });
+Object.defineProperty(exports, "DocumentSnapshot", { enumerable: true, get: function () { return firestore_1.DocumentSnapshot; } });
+Object.defineProperty(exports, "Firestore", { enumerable: true, get: function () { return firestore_1.Firestore; } });
+Object.defineProperty(exports, "Query", { enumerable: true, get: function () { return firestore_1.Query; } });
+Object.defineProperty(exports, "QuerySnapshot", { enumerable: true, get: function () { return firestore_1.QuerySnapshot; } });
+Object.defineProperty(exports, "Timestamp", { enumerable: true, get: function () { return firestore_1.Timestamp; } });
+exports.FIRESTORE_DEPS_TYPE = "admin";
+exports.where = firestore_1.Filter.where;
+exports.arrayRemove = firestore_1.FieldValue.arrayRemove;
+exports.deleteField = firestore_1.FieldValue.delete;
+exports.serverTimestamp = firestore_1.FieldValue.serverTimestamp;
+const isServerTimestamp = (x) => x instanceof firestore_1.FieldValue;
+exports.isServerTimestamp = isServerTimestamp;
+const addDoc = (ref, data) => ref.add(data);
+exports.addDoc = addDoc;
+const collection = (firestoreOrRef, path, ...pathSegments) => firestoreOrRef instanceof firestore_1.Firestore
+    ? firestoreOrRef.collection([path, ...pathSegments].join("/"))
+    : firestoreOrRef.firestore.collection([firestoreOrRef.path, path, ...pathSegments].join("/"));
+exports.collection = collection;
+const collectionGroup = (firestore, collectionID) => firestore.collectionGroup(collectionID);
+exports.collectionGroup = collectionGroup;
+const deleteDoc = async (ref) => {
+    await ref.delete();
+};
+exports.deleteDoc = deleteDoc;
+const doc = (firestoreOrRef, path, ...pathSegments) => firestoreOrRef instanceof firestore_1.Firestore
+    ? firestoreOrRef.doc([path, ...pathSegments].join("/"))
+    : path
+        ? firestoreOrRef.doc([path, ...pathSegments].join("/"))
+        : firestoreOrRef.doc();
+exports.doc = doc;
+const getDoc = (ref) => ref.get();
+exports.getDoc = getDoc;
+const getDocs = (query) => query.get();
+exports.getDocs = getDocs;
+const query = (ref, ...queryConstraints) => queryConstraints.length === 0
+    ? ref
+    : queryConstraints.length === 1
+        ? ref.where(queryConstraints[0])
+        : ref.where(firestore_1.Filter.and(...queryConstraints));
+exports.query = query;
+const setDoc = async (ref, data) => {
+    await ref.set(data);
+};
+exports.setDoc = setDoc;
+const updateDoc = async (ref, data) => {
+    await ref.update(data);
+};
+exports.updateDoc = updateDoc;
+//# sourceMappingURL=firestore-deps-admin.js.map

package/dist/firestore-deps-admin.js.map

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

package/dist/firestore-deps-web.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Provides all dependencies normally imported from "firebase/firestore".
+ *
+ * For web clients, the "firebase/firestore" API is simply re-exported.
+ *
+ * For the server client API, ...
+ */
+export * from "firebase/firestore";
+export declare const FIRESTORE_DEPS_TYPE: "web" | "admin";
+export declare const isServerTimestamp: (data: any) => boolean;

package/dist/firestore-deps-web.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Provides all dependencies normally imported from "firebase/firestore".
+ *
+ * For web clients, the "firebase/firestore" API is simply re-exported.
+ *
+ * For the server client API, ...
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isServerTimestamp = exports.FIRESTORE_DEPS_TYPE = void 0;
+__exportStar(require("firebase/firestore"), exports);
+exports.FIRESTORE_DEPS_TYPE = "web";
+const isServerTimestamp = (data) => data._methodName === "serverTimestamp";
+exports.isServerTimestamp = isServerTimestamp;
+//# sourceMappingURL=firestore-deps-web.js.map

package/dist/firestore-deps-web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-deps-web.js","sourceRoot":"","sources":["../src/firestore-deps-web.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;AAEH,qDAAmC;AAEtB,QAAA,mBAAmB,GAAoB,KAAK,CAAC;AAEnD,MAAM,iBAAiB,GAAG,CAAC,IAAS,EAAE,EAAE,CAC7C,IAAI,CAAC,WAAW,KAAK,iBAAiB,CAAC;AAD5B,QAAA,iBAAiB,qBACW"}

package/dist/firestore-deps.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Provides all dependencies normally imported from "firebase/firestore".
+ *
+ * For web clients, the "firebase/firestore" API is simply re-exported.
+ *
+ * For the server client API, ...
+ */
+import { CollectionGroup, CollectionReference, DocumentReference, DocumentSnapshot, FieldValue, Filter, Firestore, Query, QuerySnapshot, Timestamp, UpdateData, WithFieldValue } from "@google-cloud/firestore";
+export declare const FIRESTORE_DEPS_TYPE: "web" | "admin";
+export { CollectionReference, DocumentReference, DocumentSnapshot, Firestore, Query, QuerySnapshot, Timestamp, };
+export type QueryConstraint = Filter;
+export declare const where: typeof Filter.where;
+export declare const arrayRemove: typeof FieldValue.arrayRemove;
+export declare const deleteField: typeof FieldValue.delete;
+export declare const serverTimestamp: typeof FieldValue.serverTimestamp;
+export declare const isServerTimestamp: (x: any) => boolean;
+export declare const addDoc: <T>(ref: CollectionReference<T>, data: WithFieldValue<T>) => Promise<DocumentReference<T>>;
+export declare const collection: (firestoreOrRef: Firestore | CollectionReference, path: string, ...pathSegments: string[]) => CollectionReference;
+export declare const collectionGroup: (firestore: Firestore, collectionID: string) => CollectionGroup;
+export declare const deleteDoc: (ref: DocumentReference<unknown>) => Promise<void>;
+export declare const doc: (firestoreOrRef: Firestore | CollectionReference, path?: string, ...pathSegments: string[]) => DocumentReference;
+export declare const getDoc: <T>(ref: DocumentReference<T>) => Promise<DocumentSnapshot<T>>;
+export declare const getDocs: <T>(query: Query<T>) => Promise<QuerySnapshot<T>>;
+export declare const query: <T>(ref: Query<T>, ...queryConstraints: QueryConstraint[]) => Query<T>;
+export declare const setDoc: <T>(ref: DocumentReference<T>, data: WithFieldValue<T>) => Promise<void>;
+export declare const updateDoc: <T>(ref: DocumentReference<T>, data: UpdateData<T>) => Promise<void>;