firetender-admin 0.10.0

package/dist/firestore-deps.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.js.map

package/dist/firestore-deps.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { FiretenderError, FiretenderInternalError, FiretenderIOError, FiretenderUsageError } from "./errors";
+import { FiretenderCollection } from "./FiretenderCollection";
+import type { FiretenderDocOptions } from "./FiretenderDoc";
+import { FiretenderDoc } from "./FiretenderDoc";
+import { futureTimestampDays, serverTimestamp, serverTimestampWithClientTime, timestampSchema } from "./timestamps";
+export { FiretenderCollection, FiretenderDoc, FiretenderDocOptions, FiretenderError, FiretenderInternalError, FiretenderIOError, FiretenderUsageError, futureTimestampDays, serverTimestamp, serverTimestampWithClientTime, timestampSchema, };

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timestampSchema = exports.serverTimestampWithClientTime = exports.serverTimestamp = exports.futureTimestampDays = exports.FiretenderUsageError = exports.FiretenderIOError = exports.FiretenderInternalError = exports.FiretenderError = exports.FiretenderDoc = exports.FiretenderCollection = void 0;
+const errors_1 = require("./errors");
+Object.defineProperty(exports, "FiretenderError", { enumerable: true, get: function () { return errors_1.FiretenderError; } });
+Object.defineProperty(exports, "FiretenderInternalError", { enumerable: true, get: function () { return errors_1.FiretenderInternalError; } });
+Object.defineProperty(exports, "FiretenderIOError", { enumerable: true, get: function () { return errors_1.FiretenderIOError; } });
+Object.defineProperty(exports, "FiretenderUsageError", { enumerable: true, get: function () { return errors_1.FiretenderUsageError; } });
+const FiretenderCollection_1 = require("./FiretenderCollection");
+Object.defineProperty(exports, "FiretenderCollection", { enumerable: true, get: function () { return FiretenderCollection_1.FiretenderCollection; } });
+const FiretenderDoc_1 = require("./FiretenderDoc");
+Object.defineProperty(exports, "FiretenderDoc", { enumerable: true, get: function () { return FiretenderDoc_1.FiretenderDoc; } });
+const timestamps_1 = require("./timestamps");
+Object.defineProperty(exports, "futureTimestampDays", { enumerable: true, get: function () { return timestamps_1.futureTimestampDays; } });
+Object.defineProperty(exports, "serverTimestamp", { enumerable: true, get: function () { return timestamps_1.serverTimestamp; } });
+Object.defineProperty(exports, "serverTimestampWithClientTime", { enumerable: true, get: function () { return timestamps_1.serverTimestampWithClientTime; } });
+Object.defineProperty(exports, "timestampSchema", { enumerable: true, get: function () { return timestamps_1.timestampSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAKkB;AAehB,gGAnBA,wBAAe,OAmBA;AACf,wGAnBA,gCAAuB,OAmBA;AACvB,kGAnBA,0BAAiB,OAmBA;AACjB,qGAnBA,6BAAoB,OAmBA;AAjBtB,iEAA8D;AAW5D,qGAXO,2CAAoB,OAWP;AATtB,mDAAgD;AAU9C,8FAVO,6BAAa,OAUP;AATf,6CAKsB;AAUpB,oGAdA,gCAAmB,OAcA;AACnB,gGAdA,4BAAe,OAcA;AACf,8GAdA,0CAA6B,OAcA;AAC7B,gGAdA,4BAAe,OAcA"}

package/dist/proxies.d.ts

@@ -0,0 +1,62 @@
+import { z } from "zod";
+/**
+ * Wraps a top-level array, its elements, or its elements' subfields in a proxy
+ * that watches for changes.
+ *
+ * Firestore supports limited modification of arrays; see the 2018 blog entry at
+ * https://firebase.blog/posts/2018/08/better-arrays-in-cloud-firestore for
+ * details and some history.  The tl;dr is that we can't update array entries;
+ * we can only append or remove them.
+ *
+ * For this reason, this proxy only works with top-level arrays: the wrapped
+ * array cannot be inside a parent array, though it may be in a record or nested
+ * records.  Child proxies maintain a link to the top-level array and trigger a
+ * rewrite of the whole thing if there are any changes to the contents.  As a
+ * consequence, the watchFieldForChanges proxy (below) can produce child
+ * watchArrayForChanges proxies, but all children of watchArrayForChanges will
+ * always use the watchArrayForChanges proxy to maintain a reference to the
+ * top-level array.
+ *
+ * Appending an element to the top-level array could in theory be supported, but
+ * Firestore's arrayUnion operator only appends entries that don't already
+ * exist.  That is not how Javascript arrays work, so to reduce logical overhead
+ * we don't bother with it.
+ *
+ * Deletion of entries in the top-level array are handled using Firestore's
+ * arrayRemove operator.  The deleted element gets removed entirely, so the
+ * resulting array remains dense.  Note that this behavior differs from how
+ * Javascript's delete operator normally works with arrays, but here we favor
+ * Firestore's array semantics.
+ *
+ * @param arrayPath the dot-delimited path of the top-level array.
+ * @param array a reference to the top-level array.
+ * @param fieldSchema schema of the array element or a field nested within it.
+ * @param field reference to the array element or one of its subfields.
+ * @param addToUpdateList callback to register modifications to this array.
+ */
+export declare function watchArrayForChanges<ArrayElementType, FieldSchemaType extends z.ZodTypeAny>(arrayPath: string[], array: ArrayElementType[], fieldSchema: FieldSchemaType, field: z.infer<FieldSchemaType>, addToUpdateList: (path: string[], newValue: any) => void): z.infer<FieldSchemaType>;
+/**
+ * Wraps an object based on a Zod schema in a proxy that watches for changes.
+ *
+ * Nested fields are monitored by creating a chain of proxies.  Consider this
+ * case:
+ *
+ *   testDoc.w.record1.record2.someStringValue = "foo";
+ *
+ * There is a top-level proxy (call it proxy 0) for the ".w" accessor.  Getting
+ * ".record1" from it returns a child proxy (1) wrapping that field.  Getting
+ * ".record2" from that returns another child proxy (2) wrapping that subfield.
+ * Finally, setting ".someStringValue" uses the setter of proxy 2 to set the new
+ * value locally and register an update to be sent to Firestore.
+ *
+ * The proxy returned by watchFieldForChanges is used for fields and subfields
+ * when no parent is an array.  If a field or subfield is an array, the proxy
+ * returned by watchArrayForChanges is used for it and all of its children,
+ * regardless of whether they are arrays.
+ *
+ * @param fieldPath the dot-delimited path of the object being wrapped.
+ * @param fieldSchema schema of the object's field.
+ * @param field reference to the field in the local document data.
+ * @param addToUpdateList callback to register modifications to this field.
+ */
+export declare function watchFieldForChanges<FieldSchemaType extends z.ZodTypeAny>(fieldPath: string[], fieldSchema: FieldSchemaType, field: z.infer<FieldSchemaType>, addToUpdateList: (path: string[], newValue: any) => void): z.infer<FieldSchemaType>;

package/dist/proxies.js

@@ -0,0 +1,243 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watchFieldForChanges = exports.watchArrayForChanges = void 0;
+const zod_1 = require("zod");
+const firestore_deps_1 = require("./firestore-deps");
+const ts_helpers_1 = require("./ts-helpers");
+/**
+ * Given a Zod schema representing a collection, returns the sub-schema of the
+ * specified property.
+ */
+function getPropertySchema(parent, parentSchema, propertyKey) {
+    let schema = parentSchema;
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        switch (schema._def.typeName) {
+            // If the schema object is wrapped (e.g., by being optional or having a
+            // default), unwrap it until we get to the underlying collection type.
+            case zod_1.z.ZodFirstPartyTypeKind.ZodOptional:
+            case zod_1.z.ZodFirstPartyTypeKind.ZodNullable:
+                schema = schema.unwrap();
+                continue;
+            case zod_1.z.ZodFirstPartyTypeKind.ZodDefault:
+                schema = schema.removeDefault();
+                continue;
+            case zod_1.z.ZodFirstPartyTypeKind.ZodEffects:
+                schema = schema.innerType();
+                continue;
+            // Return the sub-schemas of supported collection types.
+            case zod_1.z.ZodFirstPartyTypeKind.ZodRecord:
+                if (schema.keySchema._def.typeName !== zod_1.z.ZodFirstPartyTypeKind.ZodString) {
+                    throw TypeError(`The ZodRecord for property ${propertyKey} has keys of type ${schema.keySchema._def.typeName}.  Only strings are supported.`);
+                }
+                return schema.valueSchema;
+            case zod_1.z.ZodFirstPartyTypeKind.ZodArray:
+                return schema.element;
+            case zod_1.z.ZodFirstPartyTypeKind.ZodObject:
+                return schema.shape[propertyKey];
+            case zod_1.z.ZodFirstPartyTypeKind.ZodDiscriminatedUnion:
+                return schema.optionsMap.get(parent[schema.discriminator]);
+            // If the parent is of type ZodAny, so are its properties.
+            case zod_1.z.ZodFirstPartyTypeKind.ZodAny:
+                return zod_1.z.any();
+            default:
+                throw TypeError(`Unsupported schema type for property "${propertyKey}": ${schema._def.typeName}`);
+        }
+    }
+}
+/**
+ * Getting this symbol from one of our proxies returns the proxy's target.
+ */
+const PROXY_TARGET_SYMBOL = Symbol("proxy_target");
+/**
+ * Wraps a top-level array, its elements, or its elements' subfields in a proxy
+ * that watches for changes.
+ *
+ * Firestore supports limited modification of arrays; see the 2018 blog entry at
+ * https://firebase.blog/posts/2018/08/better-arrays-in-cloud-firestore for
+ * details and some history.  The tl;dr is that we can't update array entries;
+ * we can only append or remove them.
+ *
+ * For this reason, this proxy only works with top-level arrays: the wrapped
+ * array cannot be inside a parent array, though it may be in a record or nested
+ * records.  Child proxies maintain a link to the top-level array and trigger a
+ * rewrite of the whole thing if there are any changes to the contents.  As a
+ * consequence, the watchFieldForChanges proxy (below) can produce child
+ * watchArrayForChanges proxies, but all children of watchArrayForChanges will
+ * always use the watchArrayForChanges proxy to maintain a reference to the
+ * top-level array.
+ *
+ * Appending an element to the top-level array could in theory be supported, but
+ * Firestore's arrayUnion operator only appends entries that don't already
+ * exist.  That is not how Javascript arrays work, so to reduce logical overhead
+ * we don't bother with it.
+ *
+ * Deletion of entries in the top-level array are handled using Firestore's
+ * arrayRemove operator.  The deleted element gets removed entirely, so the
+ * resulting array remains dense.  Note that this behavior differs from how
+ * Javascript's delete operator normally works with arrays, but here we favor
+ * Firestore's array semantics.
+ *
+ * @param arrayPath the dot-delimited path of the top-level array.
+ * @param array a reference to the top-level array.
+ * @param fieldSchema schema of the array element or a field nested within it.
+ * @param field reference to the array element or one of its subfields.
+ * @param addToUpdateList callback to register modifications to this array.
+ */
+function watchArrayForChanges(arrayPath, array, fieldSchema, field, addToUpdateList) {
+    return new Proxy(field, {
+        get(target, propertyKey) {
+            const property = target[propertyKey];
+            if (property instanceof Function) {
+                // All methods of an array or its children are presumed to make
+                // modifications, thus triggering an update of the full array.
+                // TODO: #11 Only mark the change for mutating function calls.
+                const result = (...args) => property.apply(field, args);
+                addToUpdateList(arrayPath, array);
+                return result;
+            }
+            if (typeof propertyKey === "symbol") {
+                if (propertyKey === PROXY_TARGET_SYMBOL) {
+                    return target;
+                }
+                // Allow all other symbols to pass through.
+                return property;
+            }
+            if (property instanceof Object) {
+                // Wrap nested objects, including nested arrays, in child proxies.
+                return watchArrayForChanges(arrayPath, array, getPropertySchema(field, fieldSchema, propertyKey), property, addToUpdateList);
+            }
+            // Otherwise we must be getting a primitive.  No need to wrap it.
+            return property;
+        },
+        set(target, propertyKey, value) {
+            if (typeof propertyKey === "symbol") {
+                // Allow symbols to pass through.
+                return Reflect.set(target, propertyKey, value);
+            }
+            let processedValue = value;
+            // If the new value is an object wrapped in a Firetender proxy, which can
+            // commonly happen when referencing it inside a mutator function passed to
+            // FiretenderDoc.prototype.update(), unwrap it.
+            if (value instanceof Object) {
+                const valueTarget = value[PROXY_TARGET_SYMBOL];
+                if (valueTarget !== undefined) {
+                    processedValue = valueTarget;
+                }
+            }
+            // An array element or one of its subfields is being set to a new value.
+            // Parse the new value with the appropriate schema, set it in the local
+            // data, and mark the entire top-level array as needing to be written.
+            const propertySchema = getPropertySchema(field, fieldSchema, propertyKey);
+            processedValue = propertySchema.parse(processedValue);
+            const result = Reflect.set(target, propertyKey, processedValue);
+            addToUpdateList(arrayPath, array);
+            return result;
+        },
+        deleteProperty(target, propertyKey) {
+            (0, ts_helpers_1.assertKeyIsString)(propertyKey);
+            // Calling Reflect.deleteProperty on an array item sets it to undefined,
+            // which causes Firestore updates to fail unless ignoreUndefinedProperties
+            // is set, and which is generally not what we want.  Hence splice.
+            const removedValues = array.splice(Number(propertyKey), 1);
+            if (removedValues.length !== 1) {
+                throw RangeError(`Failed to delete array item with index ${propertyKey}.  Out of bounds?`);
+            }
+            // Only top-level elements can be deleted with Firestore's arrayRemove.
+            if (target === array) {
+                addToUpdateList(arrayPath, (0, firestore_deps_1.arrayRemove)(removedValues[0]));
+            }
+            else {
+                addToUpdateList(arrayPath, array);
+            }
+            return true;
+        },
+    });
+}
+exports.watchArrayForChanges = watchArrayForChanges;
+/**
+ * Wraps an object based on a Zod schema in a proxy that watches for changes.
+ *
+ * Nested fields are monitored by creating a chain of proxies.  Consider this
+ * case:
+ *
+ *   testDoc.w.record1.record2.someStringValue = "foo";
+ *
+ * There is a top-level proxy (call it proxy 0) for the ".w" accessor.  Getting
+ * ".record1" from it returns a child proxy (1) wrapping that field.  Getting
+ * ".record2" from that returns another child proxy (2) wrapping that subfield.
+ * Finally, setting ".someStringValue" uses the setter of proxy 2 to set the new
+ * value locally and register an update to be sent to Firestore.
+ *
+ * The proxy returned by watchFieldForChanges is used for fields and subfields
+ * when no parent is an array.  If a field or subfield is an array, the proxy
+ * returned by watchArrayForChanges is used for it and all of its children,
+ * regardless of whether they are arrays.
+ *
+ * @param fieldPath the dot-delimited path of the object being wrapped.
+ * @param fieldSchema schema of the object's field.
+ * @param field reference to the field in the local document data.
+ * @param addToUpdateList callback to register modifications to this field.
+ */
+function watchFieldForChanges(fieldPath, fieldSchema, field, addToUpdateList) {
+    return new Proxy(field, {
+        get(target, propertyKey) {
+            const property = target[propertyKey];
+            if (property instanceof Function) {
+                // Provide methods with a "this" reference for the underlying field.
+                return (...args) => property.apply(field, args);
+            }
+            if (typeof propertyKey === "symbol") {
+                if (propertyKey === PROXY_TARGET_SYMBOL) {
+                    return target;
+                }
+                // Allow all other symbols to pass through.
+                return property;
+            }
+            if (property instanceof Array) {
+                // Wrap array subfields in the watchArrayForChanges proxy.  It is
+                // necessarily a top-level array, because otherwise we would be in
+                // watchArrayForChanges already.
+                return watchArrayForChanges([...fieldPath, propertyKey], property, getPropertySchema(field, fieldSchema, propertyKey), property, addToUpdateList);
+            }
+            if (property instanceof Object) {
+                // Wrap nested objects in another instance of this proxy.
+                return watchFieldForChanges([...fieldPath, propertyKey], getPropertySchema(field, fieldSchema, propertyKey), property, addToUpdateList);
+            }
+            // Otherwise we must be getting a primitive.  No need to wrap it.
+            return property;
+        },
+        set(target, propertyKey, value) {
+            if (typeof propertyKey === "symbol") {
+                // Allow symbols to pass through.
+                return Reflect.set(target, propertyKey, value);
+            }
+            let processedValue = value;
+            // If the new value is an object wrapped in a Firetender proxy, which can
+            // commonly happen when referencing it inside a mutator function passed to
+            // FiretenderDoc.prototype.update(), unwrap it.
+            if (value instanceof Object) {
+                const valueTarget = value[PROXY_TARGET_SYMBOL];
+                if (valueTarget !== undefined) {
+                    processedValue = valueTarget;
+                }
+            }
+            // A property of this object is being set to a new value.  Parse the new
+            // value with the appropriate schema, set it in the local data, and mark
+            // the entire top-level array as needing to be written.
+            const propertySchema = getPropertySchema(field, fieldSchema, propertyKey);
+            processedValue = propertySchema.parse(processedValue);
+            addToUpdateList([...fieldPath, propertyKey], processedValue);
+            return Reflect.set(target, propertyKey, processedValue);
+        },
+        deleteProperty(target, propertyKey) {
+            (0, ts_helpers_1.assertKeyIsString)(propertyKey);
+            // Delete the field in Firestore by marking it with the deleteField
+            // operator.
+            addToUpdateList([...fieldPath, propertyKey], (0, firestore_deps_1.deleteField)());
+            return Reflect.deleteProperty(target, propertyKey);
+        },
+    });
+}
+exports.watchFieldForChanges = watchFieldForChanges;
+//# sourceMappingURL=proxies.js.map

package/dist/proxies.js.map

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

package/dist/timestamps.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { Timestamp } from "./firestore-deps";
+/**
+ * Timestamp representation used by Firestore: seconds and nanoseconds since the
+ * epoch.
+ */
+export declare const timestampSchema: z.ZodType<Timestamp, z.ZodTypeDef, Timestamp>;
+/**
+ * Returns a Firestore Timestamp for some future date.  The result is typically
+ * used for writing TTLs.
+ *
+ * The client's clock (specifically `Date.now()`) is used to generate the
+ * timestamp.  For TTLs days in the future, this is generally not a concern.
+ * However, this function should not be depended on for short offsets.
+ *
+ * @param daysFromNow days in the future to set this Timestamp.
+ */
+export declare function futureTimestampDays(daysFromNow: number): Timestamp;
+/**
+ * Returns a sentinel to include a server-generated timestamp in the written
+ * data.
+ *
+ * Note that the sentinel, despite being typed as a Timestamp, has none of that
+ * class's properties or methods.  For a sentinel that can be immediately used
+ * as a Timestamp, see {@link serverTimestampWithClientTime}.
+ */
+export declare function serverTimestamp(): Timestamp;
+/**
+ * Returns a sentinel to include a server-generated timestamp in the written
+ * data.  The returned object also includes all properties and methods of
+ * Timestamp, allowing its immediate use without retrieving the server-set time.
+ *
+ * Note that the time returned by the Timestamp methods will likely differ from
+ * the time set by the server.  It may differ substantially if the client's
+ * clock is incorrect.  Caveat coder.
+ */
+export declare function serverTimestampWithClientTime(): Timestamp;

package/dist/timestamps.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serverTimestampWithClientTime = exports.serverTimestamp = exports.futureTimestampDays = exports.timestampSchema = void 0;
+const zod_1 = require("zod");
+const firestore_deps_1 = require("./firestore-deps");
+/**
+ * Timestamp representation used by Firestore: seconds and nanoseconds since the
+ * epoch.
+ */
+exports.timestampSchema = zod_1.z.custom((data) => data instanceof firestore_deps_1.Timestamp || (0, firestore_deps_1.isServerTimestamp)(data));
+/**
+ * Returns a Firestore Timestamp for some future date.  The result is typically
+ * used for writing TTLs.
+ *
+ * The client's clock (specifically `Date.now()`) is used to generate the
+ * timestamp.  For TTLs days in the future, this is generally not a concern.
+ * However, this function should not be depended on for short offsets.
+ *
+ * @param daysFromNow days in the future to set this Timestamp.
+ */
+function futureTimestampDays(daysFromNow) {
+    return firestore_deps_1.Timestamp.fromMillis(Date.now() + daysFromNow * 24 * 60 * 60 * 1000);
+}
+exports.futureTimestampDays = futureTimestampDays;
+/**
+ * Returns a sentinel to include a server-generated timestamp in the written
+ * data.
+ *
+ * Note that the sentinel, despite being typed as a Timestamp, has none of that
+ * class's properties or methods.  For a sentinel that can be immediately used
+ * as a Timestamp, see {@link serverTimestampWithClientTime}.
+ */
+function serverTimestamp() {
+    return (0, firestore_deps_1.serverTimestamp)();
+}
+exports.serverTimestamp = serverTimestamp;
+/**
+ * Returns a sentinel to include a server-generated timestamp in the written
+ * data.  The returned object also includes all properties and methods of
+ * Timestamp, allowing its immediate use without retrieving the server-set time.
+ *
+ * Note that the time returned by the Timestamp methods will likely differ from
+ * the time set by the server.  It may differ substantially if the client's
+ * clock is incorrect.  Caveat coder.
+ */
+function serverTimestampWithClientTime() {
+    const sentinel = (0, firestore_deps_1.serverTimestamp)();
+    const timestamp = firestore_deps_1.Timestamp.now();
+    Object.assign(sentinel, timestamp);
+    sentinel.isEqual = (other) => timestamp.isEqual(other);
+    sentinel.toDate = () => timestamp.toDate();
+    sentinel.toMillis = () => timestamp.toMillis();
+    sentinel.toString = () => timestamp.toString();
+    sentinel.valueOf = () => timestamp.valueOf();
+    return sentinel;
+}
+exports.serverTimestampWithClientTime = serverTimestampWithClientTime;
+//# sourceMappingURL=timestamps.js.map

package/dist/timestamps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamps.js","sourceRoot":"","sources":["../src/timestamps.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,qDAI0B;AAE1B;;;GAGG;AACU,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CACrC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,YAAY,0BAAS,IAAI,IAAA,kCAAiB,EAAC,IAAI,CAAC,CACpE,CAAC;AAEF;;;;;;;;;GASG;AACH,SAAgB,mBAAmB,CAAC,WAAmB;IACrD,OAAO,0BAAS,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AAC9E,CAAC;AAFD,kDAEC;AAED;;;;;;;GAOG;AACH,SAAgB,eAAe;IAC7B,OAAO,IAAA,gCAAwB,GAAe,CAAC;AACjD,CAAC;AAFD,0CAEC;AAED;;;;;;;;GAQG;AACH,SAAgB,6BAA6B;IAC3C,MAAM,QAAQ,GAAG,IAAA,gCAAwB,GAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,0BAAS,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClC,QAAgB,CAAC,OAAO,GAAG,CAAC,KAAgB,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1E,QAAgB,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;IACnD,QAAgB,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IACvD,QAAgB,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IACvD,QAAgB,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IACtD,OAAO,QAAqB,CAAC;AAC/B,CAAC;AAVD,sEAUC"}

package/dist/ts-helpers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Typescript-related helper functions and types.
+ */
+export type DeepPartial<T> = T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+export type DeepReadonly<T> = T extends Array<infer ArrKey> ? ReadonlyArray<DeepReadonly<ArrKey>> : T extends Map<infer MapKey, infer MapVal> ? ReadonlyMap<DeepReadonly<MapKey>, DeepReadonly<MapVal>> : T extends Set<infer SetKey> ? ReadonlySet<DeepReadonly<SetKey>> : T extends Record<any, unknown> ? {
+    readonly [ObjKey in keyof T]: DeepReadonly<T[ObjKey]>;
+} : T;
+export type MakeFieldsWithDefaultsOptional<T> = T extends Array<infer ArrKey> ? ReadonlyArray<DeepReadonly<ArrKey>> : T extends Map<infer MapKey, infer MapVal> ? ReadonlyMap<DeepReadonly<MapKey>, DeepReadonly<MapVal>> : T extends Set<infer SetKey> ? ReadonlySet<DeepReadonly<SetKey>> : T extends Record<any, unknown> ? {
+    readonly [ObjKey in keyof T]: DeepReadonly<T[ObjKey]>;
+} : T;
+export declare function assertIsDefined<T>(value: T): asserts value is NonNullable<T>;
+export declare function assertKeyIsString(key: any): asserts key is string;

package/dist/ts-helpers.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Typescript-related helper functions and types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertKeyIsString = exports.assertIsDefined = void 0;
+function assertIsDefined(value) {
+    if (value === undefined || value === null) {
+        throw new TypeError(`${value} is not defined`);
+    }
+}
+exports.assertIsDefined = assertIsDefined;
+function assertKeyIsString(key) {
+    if (typeof key !== "string") {
+        throw TypeError("Property access using symbols is not supported.");
+    }
+}
+exports.assertKeyIsString = assertKeyIsString;
+//# sourceMappingURL=ts-helpers.js.map

package/dist/ts-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-helpers.js","sourceRoot":"","sources":["../src/ts-helpers.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA0BH,SAAgB,eAAe,CAAI,KAAQ;IACzC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE;QACzC,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,iBAAiB,CAAC,CAAC;KAChD;AACH,CAAC;AAJD,0CAIC;AAED,SAAgB,iBAAiB,CAAC,GAAQ;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;QAC3B,MAAM,SAAS,CAAC,iDAAiD,CAAC,CAAC;KACpE;AACH,CAAC;AAJD,8CAIC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "firetender-admin",
+  "displayName": "Firetender (for firebase-admin/firestore)",
+  "description": "Typescript wrapper for Firestore documents",
+  "version": "0.10.0",
+  "author": "Jake Hartman",
+  "license": "MIT",
+  "homepage": "https://github.com/jakes-space/firetender",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jakes-space/firetender.git"
+  },
+  "keywords": [
+    "firestore",
+    "typescript",
+    "schema"
+  ],
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "/dist",
+    "/src/*.ts"
+  ],
+  "scripts": {
+    "use-web-firestore": "cp package-web.json package.json && cp src/firestore-deps-web.ts src/firestore-deps.ts && npm install",
+    "use-admin-firestore": "echo Already using admin firestore.",
+    "diff-web-admin": "diff package-web.json package-admin.json",
+    "lint:check": "eslint src --ext .ts",
+    "lint:fix": "eslint --fix src --ext .ts",
+    "prettier:check": "prettier --check src/*.ts src/**/*.ts",
+    "prettier:fix": "prettier --write src/*.ts src/**/*.ts",
+    "check": "npm run lint:check && npm run prettier:check",
+    "fix": "npm run lint:fix && npm run prettier:fix",
+    "emulate-db": "firebase emulators:start --project=firetender",
+    "test": "jest --forceExit --detectOpenHandles",
+    "prepare": "husky install",
+    "clean": "rm -rf dist/*",
+    "build": "npm run clean && tsc && rm -rf dist/__tests__",
+    "prepublishOnly": "npm run check && npm run test && npm run build"
+  },
+  "dependencies": {
+    "firebase-admin": "^11.6.0",
+    "zod": "^3.20.6"
+  },
+  "devDependencies": {
+    "@firebase/rules-unit-testing": "^2.0.7",
+    "@rushstack/eslint-patch": "^1.2.0",
+    "@types/jest": "^29.4.0",
+    "@typescript-eslint/eslint-plugin": "^5.54.0",
+    "@typescript-eslint/parser": "^5.54.0",
+    "eslint": "^8.35.0",
+    "eslint-config-prettier": "^8.6.0",
+    "eslint-import-resolver-typescript": "^3.5.3",
+    "eslint-plugin-import": "^2.27.5",
+    "eslint-plugin-prettier": "^4.2.1",
+    "eslint-plugin-simple-import-sort": "^10.0.0",
+    "firebase-admin": "^11.6.0",
+    "husky": "^8.0.3",
+    "jest": "^29.4.3",
+    "prettier": "^2.8.4",
+    "ts-jest": "^29.0.5",
+    "tslib": "^2.5.0",
+    "typescript": "^4.9.5"
+  }
+}