firetender-admin 0.13.0 → 0.13.2

package/dist/cjs/src/__tests__/FiretenderDoc.spec.js

@@ -1,1400 +0,0 @@
-"use strict";
-/**
- * Start before testing: firebase emulators:start --project=firetender
- *
- * TODO: #5 zod effects and preprocessing, but disallowing transforms
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const zod_1 = require("zod");
-const errors_1 = require("../errors");
-const firestore_deps_1 = require("../firestore-deps");
-const FiretenderDoc_1 = require("../FiretenderDoc");
-const timestamps_1 = require("../timestamps");
-const firestore_emulator_1 = require("./firestore-emulator");
-const testDataSchema = zod_1.z.object({
-    email: zod_1.z.string().email(),
-    ttl: timestamps_1.timestampSchema.optional(),
-    recordOfPrimitives: zod_1.z.record(zod_1.z.string()).default({}),
-    recordOfObjects: zod_1.z
-        .record(zod_1.z.object({
-        rating: zod_1.z.number(),
-        tags: zod_1.z.array(zod_1.z.string()).default([]),
-        favoriteColor: zod_1.z.string().optional(),
-    }))
-        .default({}),
-    nestedRecords: zod_1.z.record(zod_1.z.record(zod_1.z.number())).default({}),
-    arrayOfObjects: zod_1.z
-        .array(zod_1.z.object({
-        name: zod_1.z.string(),
-        entries: zod_1.z.record(zod_1.z.number()).default({}),
-        favoriteColor: zod_1.z.string().optional(),
-    }))
-        .default([]),
-    arrayOfDiscUnions: zod_1.z
-        .array(zod_1.z.discriminatedUnion("type", [
-        zod_1.z.object({ type: zod_1.z.literal("A"), someNumber: zod_1.z.number() }),
-        zod_1.z.object({ type: zod_1.z.literal("B"), someString: zod_1.z.string() }),
-        zod_1.z.object({ type: zod_1.z.literal("C"), someBoolean: zod_1.z.boolean() }),
-    ]))
-        .optional(),
-    unreadable: zod_1.z.boolean().optional(),
-});
-let firestore;
-let testCollection;
-beforeAll(async () => {
-    firestore = await (0, firestore_emulator_1.getFirestoreEmulator)();
-    testCollection = (0, firestore_deps_1.collection)(firestore, "doctests");
-});
-afterAll(firestore_emulator_1.cleanupFirestoreEmulator);
-async function createAndLoadDoc(data, options = {}) {
-    const docRef = await (0, firestore_deps_1.addDoc)(testCollection, data);
-    return new FiretenderDoc_1.FiretenderDoc(testDataSchema, docRef, options).load();
-}
-describe("load", () => {
-    it("must be called before referencing the accessors.", async () => {
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, (0, firestore_deps_1.doc)(testCollection, "foo"));
-        expect(testDoc.isLoaded).toBe(false);
-        expect(() => testDoc.r.email).toThrowError("load() must be called before reading the document.");
-        expect(() => testDoc.w.email).toThrowError("load() must be called before updating the document.");
-    });
-    it("throws for a non-existent doc.", async () => {
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, (0, firestore_deps_1.doc)(testCollection, "foo"));
-        await expect(testDoc.load()).rejects.toThrowError("does not exist");
-    });
-    it("throws for a doc blocked by Firestore rules.", async () => {
-        // Admin can read anywhere, so this test does not throw an error.
-        if (firestore_deps_1.FIRESTORE_DEPS_TYPE === "admin")
-            return;
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, {
-            email: "bob@example.com",
-            unreadable: true,
-        });
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, docRef);
-        await expect(testDoc.load()).rejects.toThrowError(errors_1.FiretenderIOError);
-    });
-    it("throws for a created but not yet written doc.", async () => {
-        const testDoc = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, {
-            email: "bob@example.com",
-        });
-        await expect(testDoc.load()).rejects.toThrowError("should not be called for new documents.");
-    });
-    it("throws for an invalid doc.", async () => {
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, {}); // Missing email.
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, docRef);
-        await expect(testDoc.load()).rejects.toThrowError('"message": "Required"');
-    });
-    it("always reads from Firestore if force is set.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-        });
-        // testDoc does not show a change in Firestore until after a forced load.
-        await (0, firestore_deps_1.updateDoc)(testDoc.docRef, { email: "alice@example.com" });
-        await testDoc.load(); // Does nothing.
-        expect(testDoc.r.email).toBe("bob@example.com");
-        await testDoc.load({ force: true });
-        expect(testDoc.r.email).toBe("alice@example.com");
-    });
-    it("waits if a load call is already in progress", async () => {
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, { email: "bob@example.com" });
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, docRef);
-        const loadingPromise1 = testDoc.load();
-        expect(testDoc.isLoaded).toBeFalsy();
-        const loadingPromise2 = testDoc.load();
-        expect(testDoc.isLoaded).toBeFalsy();
-        const loadingPromise3 = testDoc.load();
-        expect(testDoc.isLoaded).toBeFalsy();
-        await Promise.all([loadingPromise1, loadingPromise2, loadingPromise3]);
-        expect(testDoc.isLoaded).toBeTruthy();
-        expect(testDoc.r.email).toBe("bob@example.com");
-    });
-});
-describe("listener", () => {
-    it("can listen for changes to a doc", async () => {
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, { email: "bob@example.com" });
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, docRef);
-        let callbackCount = 0;
-        await testDoc.load({
-            listen: () => {
-                callbackCount += 1;
-            },
-        });
-        expect(testDoc.isListening).toBeTruthy();
-        expect(callbackCount).toEqual(0);
-        expect(testDoc.r.email).toBe("bob@example.com");
-        await (0, firestore_deps_1.updateDoc)(testDoc.docRef, { email: "alice@example.com" });
-        expect(callbackCount).toEqual(1);
-        expect(testDoc.r.email).toBe("alice@example.com");
-        testDoc.stopListening();
-        expect(testDoc.isListening).toBeFalsy();
-        await (0, firestore_deps_1.updateDoc)(testDoc.docRef, { email: "cindy@example.com" });
-        expect(callbackCount).toEqual(1);
-        expect(testDoc.r.email).toBe("alice@example.com");
-    });
-    it("can merge local and Firestore changse", async () => {
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, { email: "bob@example.com" });
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, docRef);
-        let callbackCount = 0;
-        await testDoc.load({
-            listen: () => {
-                callbackCount += 1;
-            },
-        });
-        expect(callbackCount).toEqual(0);
-        expect(testDoc.r.email).toBe("bob@example.com");
-        testDoc.w.ttl = new firestore_deps_1.Timestamp(123, 456000);
-        await (0, firestore_deps_1.updateDoc)(testDoc.docRef, { email: "alice@example.com" });
-        expect(callbackCount).toEqual(0);
-        await testDoc.write();
-        expect(callbackCount).toEqual(1);
-        expect(testDoc.r).toEqual({
-            email: "alice@example.com",
-            ttl: new firestore_deps_1.Timestamp(123, 456000),
-            recordOfPrimitives: {},
-            recordOfObjects: {},
-            nestedRecords: {},
-            arrayOfObjects: [],
-        });
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "alice@example.com",
-            ttl: new firestore_deps_1.Timestamp(123, 456000),
-        });
-    });
-    it("marks the doc as new if the remote doc is deleted", async () => {
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, { email: "bob@example.com" });
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, docRef);
-        let callbackCount = 0;
-        await testDoc.load({
-            listen: () => {
-                callbackCount += 1;
-            },
-        });
-        expect(callbackCount).toEqual(0);
-        await (0, firestore_deps_1.deleteDoc)(testDoc.docRef);
-        expect(callbackCount).toEqual(1);
-        expect(testDoc.isNew).toBeTruthy();
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfPrimitives: {},
-            recordOfObjects: {},
-            nestedRecords: {},
-            arrayOfObjects: [],
-        });
-    });
-    it("ignores server timestamp's initial update of null", async () => {
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, { email: "bob@example.com" });
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, docRef);
-        let callbackCount = 0;
-        await testDoc.load({
-            listen: () => {
-                callbackCount += 1;
-            },
-        });
-        const nowMillis = Date.now();
-        await testDoc.update((doc) => {
-            doc.ttl = (0, timestamps_1.serverTimestamp)();
-        });
-        // Wait a second for the timestamp to be set by the server.
-        await new Promise((resolve) => setTimeout(resolve, 1000));
-        expect(callbackCount).toEqual(1);
-        const doc = await (0, firestore_deps_1.getDoc)(testDoc.docRef);
-        const millisDiff = Math.abs(doc.data()?.ttl.toMillis() - nowMillis);
-        expect(millisDiff).toBeLessThan(10000); // Less than 10 seconds apart.
-    });
-});
-describe("patch", () => {
-    it("applies patches to the data.", async () => {
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, {});
-        const patcher = (data) => {
-            data.email = "alice@example.com";
-            return true;
-        };
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, docRef, {
-            patchers: [patcher],
-            savePatchAfterDelay: 0, // Save at next opportunity.
-        });
-        await testDoc.load();
-        expect(testDoc.r.email).toBe("alice@example.com");
-        await new Promise((resolve) => setTimeout(resolve, 500));
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "alice@example.com",
-            recordOfPrimitives: {},
-            recordOfObjects: {},
-            nestedRecords: {},
-            arrayOfObjects: [],
-        });
-    });
-});
-describe("read-only accessor (.r)", () => {
-    it("reads a primitive field.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-        });
-        expect(testDoc.r.email).toBe("bob@example.com");
-    });
-    it("does not contain a missing optional field.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-        });
-        expect("ttl" in testDoc.r).toBe(false);
-    });
-});
-describe("writable accessor (.w)", () => {
-    it("enforces schema rules when a field is set.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-        });
-        expect(() => {
-            testDoc.w.email = "not a valid email";
-        }).toThrowError("Invalid email");
-    });
-    it("allows symbol properties to pass through objects.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 10,
-                },
-            },
-        });
-        // Converting an Object to a string gets its Symbol.toStringTag property.
-        expect(String(testDoc.w.recordOfObjects)).toBe("[object Object]");
-    });
-    it("allows symbol properties to pass through arrays.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-            arrayOfObjects: [
-                { name: "foo", entries: {} },
-                { name: "bar", entries: { a: 111, b: 222 } },
-            ],
-        });
-        // Converting an Array to a string gets its Symbol.toStringTag property.
-        expect(String(testDoc.w.arrayOfObjects)).toBe("[object Object],[object Object]");
-    });
-    it("can replace all document data", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 10,
-                },
-            },
-        });
-        testDoc.w = { email: "alice@example.com" };
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "alice@example.com",
-            recordOfPrimitives: {},
-            recordOfObjects: {},
-            nestedRecords: {},
-            arrayOfObjects: [],
-        });
-    });
-    it("clears an optional field with delete operator", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-            ttl: new firestore_deps_1.Timestamp(123, 456000),
-        });
-        delete testDoc.w.ttl;
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-        });
-        // Note that Typescript itself prevents you from deleting required fields.
-        // Attempting "delete testDoc.w.email;" is a TS compiler error.
-    });
-    it("clears an optional field set to undefined", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-            ttl: new firestore_deps_1.Timestamp(123, 456000),
-        });
-        testDoc.w.ttl = undefined;
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-        });
-    });
-    it("deeply removes undefined fields", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-            recordOfObjects: {
-                c: { rating: 3, tags: ["111", "222"], favoriteColor: "red" },
-                d: { rating: 4, tags: ["333", "444"] },
-            },
-            arrayOfObjects: [
-                { name: "abc", entries: { x: 1, y: 2 } },
-                { name: "xyz", favoriteColor: "blue" },
-            ],
-        });
-        await testDoc.update((doc) => {
-            doc.recordOfObjects.c = { rating: 5, tags: [], favoriteColor: undefined };
-            doc.arrayOfObjects[1] = {
-                name: "xyz",
-                entries: {},
-                favoriteColor: undefined,
-            };
-        });
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                c: { rating: 5, tags: [] },
-                d: { rating: 4, tags: ["333", "444"] },
-            },
-            arrayOfObjects: [
-                { name: "abc", entries: { x: 1, y: 2 } },
-                { name: "xyz", entries: {} },
-            ],
-        });
-    });
-    it("throws in readonly mode.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-        }, { readonly: true });
-        expect(testDoc.isReadonly).toBeTruthy();
-        expect(() => {
-            testDoc.w.email = "alice@example.com";
-        }).toThrowError("An attempt was made to modify or write a read-only doc");
-    });
-});
-describe("write", () => {
-    it("sets a primitive field and updates Firestore.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-        });
-        await testDoc.write(); // Should be a no-op since nothing has been changed.
-        testDoc.w.email = "alice@example.com";
-        expect(testDoc.r.email).toBe("alice@example.com");
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({ email: "alice@example.com" });
-    });
-    it("can update multiple fields.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-        });
-        testDoc.w.email = "alice@example.com";
-        testDoc.w.ttl = new firestore_deps_1.Timestamp(123, 456000);
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "alice@example.com",
-            ttl: new firestore_deps_1.Timestamp(123, 456000),
-        });
-    });
-    it("provides context on errors when adding a doc.", async () => {
-        // Admin can read anywhere, so this test does not throw an error.
-        if (firestore_deps_1.FIRESTORE_DEPS_TYPE === "admin")
-            return;
-        const badRef = (0, firestore_deps_1.collection)(firestore, "not-in-access-rules");
-        const badDoc = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, badRef, {
-            email: "bob@example.com",
-        });
-        await expect(badDoc.write()).rejects.toThrowError();
-        try {
-            await badDoc.write();
-        }
-        catch (error) {
-            expect(error.firetenderContext).toEqual({
-                call: "addDoc",
-                ref: "not-in-access-rules",
-                data: {
-                    email: "bob@example.com",
-                    recordOfPrimitives: {},
-                    recordOfObjects: {},
-                    nestedRecords: {},
-                    arrayOfObjects: [],
-                },
-            });
-        }
-    });
-    it("provides context on errors when updating a doc.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-        });
-        await (0, firestore_deps_1.deleteDoc)(testDoc.docRef);
-        testDoc.w.email = "alice@example.com";
-        await expect(testDoc.write()).rejects.toThrowError();
-        try {
-            await testDoc.write();
-        }
-        catch (error) {
-            expect(error.firetenderContext).toEqual({
-                call: "updateDoc",
-                ref: testDoc.docRef.path,
-                data: { email: "alice@example.com" },
-            });
-        }
-    });
-    it("throws in readonly mode.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-        }, { readonly: true });
-        await expect(testDoc.write()).rejects.toThrowError("An attempt was made to modify or write a read-only doc");
-    });
-});
-describe("update", () => {
-    it("loads, updates, and writes a document", async () => {
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, { email: "bob@example.com" });
-        await new FiretenderDoc_1.FiretenderDoc(testDataSchema, docRef).update((data) => {
-            data.email = "alice@example.com";
-            data.arrayOfObjects.push({ name: "foo", entries: {} });
-        });
-        const result = (await (0, firestore_deps_1.getDoc)(docRef)).data();
-        expect(result).toEqual({
-            email: "alice@example.com",
-            arrayOfObjects: [
-                {
-                    name: "foo",
-                    entries: {},
-                },
-            ],
-        });
-    });
-    it("throws in readonly mode.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-        }, { readonly: true });
-        expect(testDoc.isReadonly).toBeTruthy();
-        await expect(testDoc.update((data) => {
-            data.email = "alice@example.com";
-        })).rejects.toThrowError("An attempt was made to modify or write a read-only doc");
-    });
-    it("updates a new doc.", async () => {
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, testCollection, {
-            createDoc: true,
-            initialData: {
-                email: "bob@example.com",
-            },
-        });
-        expect(testDoc.isNew).toBeTruthy();
-        await testDoc.update((data) => {
-            data.email = "alice@example.com";
-        });
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "alice@example.com",
-            recordOfPrimitives: {},
-            nestedRecords: {},
-            recordOfObjects: {},
-            arrayOfObjects: [],
-        });
-    });
-});
-describe("record of primitives", () => {
-    const initialState = {
-        email: "bob@example.com",
-        recordOfPrimitives: {
-            foo: "xyz",
-        },
-    };
-    it("reads an entry.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        expect(testDoc.r.recordOfPrimitives.foo).toBe("xyz");
-    });
-    it("modifies an existing entry.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.recordOfPrimitives.foo = "abc";
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfPrimitives: {
-                foo: "abc",
-            },
-        });
-    });
-    it("adds an entry.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.recordOfPrimitives.bar = "abc";
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfPrimitives: {
-                foo: "xyz",
-                bar: "abc",
-            },
-        });
-    });
-    it("deletes an entry.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-            recordOfPrimitives: { foo: "xyz" },
-        });
-        delete testDoc.w.recordOfPrimitives.foo;
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfPrimitives: {},
-        });
-    });
-    it("can set all record contents.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-            recordOfPrimitives: { foo: "xyz" },
-        });
-        testDoc.w.recordOfPrimitives = { bar: "abc" };
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfPrimitives: {
-                bar: "abc",
-            },
-        });
-    });
-});
-describe("record of objects", () => {
-    const initialState = {
-        email: "bob@example.com",
-        recordOfObjects: {
-            "ice cream": {
-                rating: 10,
-            },
-            spinach: {
-                rating: 5,
-                tags: ["green", "healthy"],
-            },
-        },
-    };
-    it("reads an entry.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        expect("ice cream" in testDoc.r.recordOfObjects).toBe(true);
-        expect(testDoc.r.recordOfObjects["ice cream"].rating).toBe(10);
-        expect(testDoc.r.recordOfObjects["ice cream"].tags.length).toBe(0);
-        expect(testDoc.r.recordOfObjects.spinach.tags.includes("green")).toBe(true);
-    });
-    it("modifies an entry.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.recordOfObjects["ice cream"] = {
-            rating: 8,
-            tags: ["too much lactose"],
-        };
-        testDoc.w.recordOfObjects.spinach.rating = 6;
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 8,
-                    tags: ["too much lactose"],
-                },
-                spinach: {
-                    rating: 6,
-                    tags: ["green", "healthy"],
-                },
-            },
-        });
-    });
-    it("correctly updates a parent field followed by a child.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.recordOfObjects["ice cream"] = { rating: 4, tags: ["abc"] };
-        testDoc.w.recordOfObjects["ice cream"].rating = 5;
-        testDoc.w.recordOfObjects["ice cream"].tags.push("xyz");
-        // .updates is private, so we coerce testDoc into "any".
-        const updates = testDoc.updates;
-        expect(updates.size).toBe(1);
-        expect(updates.keys().next().value).toBe("recordOfObjects.ice cream");
-        expect(updates.values().next().value).toEqual({
-            rating: 5,
-            tags: ["abc", "xyz"],
-        });
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 5,
-                    tags: ["abc", "xyz"],
-                },
-                spinach: {
-                    rating: 5,
-                    tags: ["green", "healthy"],
-                },
-            },
-        });
-    });
-    it("correctly updates a child field followed by a parent.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.recordOfObjects["ice cream"].rating = 5;
-        testDoc.w.recordOfObjects["ice cream"].tags.push("xyz");
-        testDoc.w.recordOfObjects["ice cream"] = { rating: 4, tags: ["abc"] };
-        // .updates is private, so we coerce testDoc into "any".
-        const updates = testDoc.updates;
-        expect(updates.size).toBe(1);
-        expect(updates.keys().next().value).toBe("recordOfObjects.ice cream");
-        expect(updates.values().next().value).toEqual({
-            rating: 4,
-            tags: ["abc"],
-        });
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 4,
-                    tags: ["abc"],
-                },
-                spinach: {
-                    rating: 5,
-                    tags: ["green", "healthy"],
-                },
-            },
-        });
-    });
-    it("adds an entry", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.recordOfObjects.tacos = { rating: 9, tags: ["crunchy"] };
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 10,
-                },
-                spinach: {
-                    rating: 5,
-                    tags: ["green", "healthy"],
-                },
-                tacos: {
-                    rating: 9,
-                    tags: ["crunchy"],
-                },
-            },
-        });
-    });
-    it("deletes an entry", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        delete testDoc.w.recordOfObjects.spinach;
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 10,
-                },
-            },
-        });
-    });
-    it("can set all record contents.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.recordOfObjects = {
-            tacos: {
-                rating: 9,
-                tags: ["crunchy"],
-            },
-        };
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                tacos: {
-                    rating: 9,
-                    tags: ["crunchy"],
-                },
-            },
-        });
-    });
-});
-describe("nested records", () => {
-    const initialState = {
-        email: "bob@example.com",
-        nestedRecords: {
-            x: {
-                a: 111,
-                b: 222,
-            },
-            y: {
-                c: 333,
-            },
-        },
-    };
-    it("reads an entry.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        expect("x" in testDoc.r.nestedRecords).toBe(true);
-        expect("a" in testDoc.r.nestedRecords.x).toBe(true);
-        expect(testDoc.r.nestedRecords.x.a).toBe(111);
-        expect(testDoc.r.nestedRecords.x.b).toBe(222);
-        expect(testDoc.r.nestedRecords.y.c).toBe(333);
-    });
-    it("modifies an entry.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.nestedRecords.x.b = 234;
-        testDoc.w.nestedRecords.y = { d: 444 };
-        await testDoc.write();
-        expect(testDoc.r.nestedRecords.x.b).toBe(234);
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            nestedRecords: {
-                x: {
-                    a: 111,
-                    b: 234,
-                },
-                y: {
-                    d: 444,
-                },
-            },
-        });
-    });
-    it("adds an entry", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.nestedRecords.y.d = 444;
-        testDoc.w.nestedRecords.z = { e: 555 };
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            nestedRecords: {
-                x: {
-                    a: 111,
-                    b: 222,
-                },
-                y: {
-                    c: 333,
-                    d: 444,
-                },
-                z: {
-                    e: 555,
-                },
-            },
-        });
-    });
-    it("deletes an entry", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        delete testDoc.w.nestedRecords.x.a;
-        delete testDoc.w.nestedRecords.y;
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            nestedRecords: {
-                x: {
-                    b: 222,
-                },
-            },
-        });
-    });
-});
-describe("array of objects", () => {
-    const initialState = {
-        email: "bob@example.com",
-        arrayOfObjects: [
-            { name: "foo", entries: {} },
-            { name: "bar", entries: { a: 111, b: 222 }, favoriteColor: "blue" },
-        ],
-    };
-    it("reads an entry.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        expect(testDoc.r.arrayOfObjects.length).toBe(2);
-        expect(testDoc.r.arrayOfObjects[0].name).toBe("foo");
-        expect(testDoc.r.arrayOfObjects[1].name).toBe("bar");
-        expect("a" in testDoc.r.arrayOfObjects[1].entries).toBe(true);
-        expect(testDoc.r.arrayOfObjects[1].entries.b).toBe(222);
-    });
-    it("modifies an entry.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.arrayOfObjects[0] = {
-            name: "constants",
-            entries: { pi: 3.14159, e: 2.71828 },
-        };
-        testDoc.w.arrayOfObjects[1].name += "bell";
-        testDoc.w.arrayOfObjects[1].entries.a = 123;
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            arrayOfObjects: [
-                { name: "constants", entries: { pi: 3.14159, e: 2.71828 } },
-                { name: "barbell", entries: { a: 123, b: 222 }, favoriteColor: "blue" },
-            ],
-        });
-    });
-    it("adds an entry", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.arrayOfObjects.push({ name: "baz", entries: { c: 333 } });
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            arrayOfObjects: [
-                { name: "foo", entries: {} },
-                { name: "bar", entries: { a: 111, b: 222 }, favoriteColor: "blue" },
-                { name: "baz", entries: { c: 333 } },
-            ],
-        });
-    });
-    it("deletes an entry", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        delete testDoc.w.arrayOfObjects[0];
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            arrayOfObjects: [
-                { name: "bar", entries: { a: 111, b: 222 }, favoriteColor: "blue" },
-            ],
-        });
-    });
-    it("handles an array index that is out of bounds.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        expect(delete testDoc.w.arrayOfObjects[99]).toBeTruthy();
-    });
-    it("fails to delete for malformed indices.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        expect(() => {
-            delete testDoc.w.arrayOfObjects[-99];
-        }).toThrow(TypeError);
-    });
-    it("deletes the correct entry when there are multiple copies.", async () => {
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-            arrayOfObjects: [
-                { name: "A", entries: {} },
-                { name: "foo", entries: {} },
-                { name: "B", entries: {} },
-                { name: "foo", entries: {} },
-                { name: "C", entries: {} },
-                { name: "foo", entries: {} },
-                { name: "D", entries: {} },
-                { name: "foo", entries: {} },
-                { name: "E", entries: {} },
-            ],
-        });
-        delete testDoc.w.arrayOfObjects[5];
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            arrayOfObjects: [
-                { name: "A", entries: {} },
-                { name: "foo", entries: {} },
-                { name: "B", entries: {} },
-                { name: "foo", entries: {} },
-                { name: "C", entries: {} },
-                { name: "D", entries: {} },
-                { name: "foo", entries: {} },
-                { name: "E", entries: {} },
-            ],
-        });
-    });
-    it("removes a field within an entry with the delete operator", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        delete testDoc.w.arrayOfObjects[1].entries.a;
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            arrayOfObjects: [
-                { name: "foo", entries: {} },
-                { name: "bar", entries: { b: 222 }, favoriteColor: "blue" },
-            ],
-        });
-    });
-    it("removes a field within an entry when set to undefined", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.arrayOfObjects[1].favoriteColor = undefined;
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            arrayOfObjects: [
-                { name: "foo", entries: {} },
-                { name: "bar", entries: { a: 111, b: 222 } },
-            ],
-        });
-    });
-    it("can set the array contents.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.arrayOfObjects = [
-            { name: "baz", entries: {} },
-            { name: "qux", entries: { a: 111, b: 222 } },
-        ];
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            arrayOfObjects: [
-                { name: "baz", entries: {} },
-                { name: "qux", entries: { a: 111, b: 222 } },
-            ],
-        });
-    });
-    it("truncates an array using its length property.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        testDoc.w.arrayOfObjects.length = 1;
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            arrayOfObjects: [{ name: "foo", entries: {} }],
-        });
-    });
-});
-describe("array of discriminating unions", () => {
-    const initialState = {
-        email: "bob@example.com",
-        arrayOfDiscUnions: [
-            { type: "A", someNumber: 123 },
-            { type: "B", someString: "yo" },
-            { type: "C", someBoolean: true },
-        ],
-    };
-    it("reads entries.", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        expect(testDoc.r.arrayOfDiscUnions).toBeDefined();
-        expect(testDoc.r.arrayOfDiscUnions.length).toBe(3);
-        expect(testDoc.r.arrayOfDiscUnions[0].type).toBe("A");
-        expect(testDoc.r.arrayOfDiscUnions[0].someNumber).toBe(123);
-        expect(testDoc.r.arrayOfDiscUnions[1].type).toBe("B");
-        expect(testDoc.r.arrayOfDiscUnions[1].someString).toBe("yo");
-        expect(testDoc.r.arrayOfDiscUnions[2].type).toBe("C");
-        expect(testDoc.r.arrayOfDiscUnions[2].someBoolean).toBe(true);
-    });
-    it("updates entries and changes type", async () => {
-        const testDoc = await createAndLoadDoc(initialState);
-        const entry0 = testDoc.w.arrayOfDiscUnions[0];
-        expect(entry0.type).toBe("A");
-        if (entry0.type === "A") {
-            entry0.someNumber = 456;
-        }
-        testDoc.w.arrayOfDiscUnions[1] = {
-            type: "C",
-            someBoolean: false,
-        };
-        testDoc.w.arrayOfDiscUnions.push({
-            type: "B",
-            someString: "hello",
-        });
-        await testDoc.write();
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            arrayOfDiscUnions: [
-                { type: "A", someNumber: 456 },
-                { type: "C", someBoolean: false },
-                { type: "C", someBoolean: true },
-                { type: "B", someString: "hello" },
-            ],
-        });
-    });
-});
-describe("createNewDoc", () => {
-    const initialState = {
-        email: "bob@example.com",
-    };
-    it("does not provide an ID or doc ref until write is called.", async () => {
-        const testDoc = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, initialState);
-        expect(() => testDoc.id).toThrowError("id can only be accessed after");
-        expect(() => testDoc.docRef).toThrowError("docRef can only be accessed after");
-    });
-    it("adds a document without a specified ID.", async () => {
-        const testDoc = await FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, initialState).write();
-        expect(testDoc.id).toMatch(/^[A-Za-z0-9]{12,}$/);
-        expect(testDoc.docRef).toBeDefined();
-        const result = testDoc.docRef
-            ? (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data()
-            : undefined;
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfPrimitives: {},
-            nestedRecords: {},
-            recordOfObjects: {},
-            arrayOfObjects: [],
-        });
-    });
-    it("adds a document with a given ID.", async () => {
-        const docID = "abcdef123456";
-        const testDoc = await FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, (0, firestore_deps_1.doc)(testCollection, docID), initialState).write();
-        expect(testDoc.id).toBe(docID);
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            email: "bob@example.com",
-            recordOfPrimitives: {},
-            nestedRecords: {},
-            recordOfObjects: {},
-            arrayOfObjects: [],
-        });
-    });
-    it("can change an added document, before and after writing.", async () => {
-        const testDoc = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, initialState);
-        testDoc.w.recordOfObjects.x = { rating: 5, tags: ["hi"] };
-        expect(testDoc.isNew).toBe(true);
-        expect(testDoc.isLoaded).toBe(true);
-        expect(testDoc.isPendingWrite).toBe(true);
-        await testDoc.write();
-        expect(testDoc.isPendingWrite).toBe(false);
-        const result1 = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result1).toEqual({
-            email: "bob@example.com",
-            recordOfPrimitives: {},
-            nestedRecords: {},
-            recordOfObjects: { x: { rating: 5, tags: ["hi"] } },
-            arrayOfObjects: [],
-        });
-        testDoc.w.recordOfPrimitives.a = "bye";
-        expect(testDoc.isPendingWrite).toBe(true);
-        await testDoc.write();
-        expect(testDoc.isPendingWrite).toBe(false);
-        const result2 = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result2).toEqual({
-            email: "bob@example.com",
-            recordOfPrimitives: { a: "bye" },
-            nestedRecords: {},
-            recordOfObjects: { x: { rating: 5, tags: ["hi"] } },
-            arrayOfObjects: [],
-        });
-    });
-});
-describe("copy", () => {
-    const initialState = {
-        email: "bob@example.com",
-        recordOfObjects: {
-            "ice cream": {
-                rating: 10,
-            },
-            spinach: {
-                rating: 5,
-                tags: ["green", "healthy"],
-            },
-        },
-    };
-    it("performs a deep copy of a document.", async () => {
-        const testDoc1 = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, initialState);
-        const testDoc2 = testDoc1.copy();
-        const iceCream = testDoc2.w.recordOfObjects["ice cream"];
-        iceCream.rating = 9;
-        iceCream.tags.push("melting");
-        await Promise.all([testDoc1.write(), testDoc2.write()]);
-        const result1 = (await (0, firestore_deps_1.getDoc)(testDoc1.docRef)).data();
-        expect(result1).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 10,
-                    tags: [],
-                },
-                spinach: {
-                    rating: 5,
-                    tags: ["green", "healthy"],
-                },
-            },
-            recordOfPrimitives: {},
-            nestedRecords: {},
-            arrayOfObjects: [],
-        });
-        const result2 = (await (0, firestore_deps_1.getDoc)(testDoc2.docRef)).data();
-        expect(result2).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 9,
-                    tags: ["melting"],
-                },
-                spinach: {
-                    rating: 5,
-                    tags: ["green", "healthy"],
-                },
-            },
-            recordOfPrimitives: {},
-            nestedRecords: {},
-            arrayOfObjects: [],
-        });
-    });
-    it("throws if the copied doc exists but was not loaded.", async () => {
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, initialState);
-        const testDoc = new FiretenderDoc_1.FiretenderDoc(testDataSchema, docRef);
-        expect(() => testDoc.copy()).toThrowError();
-    });
-    it("can copy into a specified collection.", async () => {
-        const testDoc1 = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, initialState);
-        const testDoc2 = testDoc1.copy(testCollection);
-        await Promise.all([testDoc1.write(), testDoc2.write()]);
-        const result2 = (await (0, firestore_deps_1.getDoc)(testDoc2.docRef)).data();
-        expect(result2).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 10,
-                    tags: [],
-                },
-                spinach: {
-                    rating: 5,
-                    tags: ["green", "healthy"],
-                },
-            },
-            recordOfPrimitives: {},
-            nestedRecords: {},
-            arrayOfObjects: [],
-        });
-    });
-    it("can copy into a specified doc reference.", async () => {
-        const testDoc1 = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, initialState);
-        const testDoc2 = testDoc1.copy((0, firestore_deps_1.doc)(testCollection, "copy-with-doc-ref"));
-        await Promise.all([testDoc1.write(), testDoc2.write()]);
-        expect(testDoc2.id).toBe("copy-with-doc-ref");
-        const result2 = (await (0, firestore_deps_1.getDoc)(testDoc2.docRef)).data();
-        expect(result2).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 10,
-                    tags: [],
-                },
-                spinach: {
-                    rating: 5,
-                    tags: ["green", "healthy"],
-                },
-            },
-            recordOfPrimitives: {},
-            nestedRecords: {},
-            arrayOfObjects: [],
-        });
-    });
-    it("can copy into a specified ID.", async () => {
-        const testDoc1 = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, (0, firestore_deps_1.doc)(testCollection, "copy-original"), initialState);
-        const testDoc2 = testDoc1.copy("copy-with-id-string");
-        await Promise.all([testDoc1.write(), testDoc2.write()]);
-        expect(testDoc2.id).toBe("copy-with-id-string");
-        const result2 = (await (0, firestore_deps_1.getDoc)(testDoc2.docRef)).data();
-        expect(result2).toEqual({
-            email: "bob@example.com",
-            recordOfObjects: {
-                "ice cream": {
-                    rating: 10,
-                    tags: [],
-                },
-                spinach: {
-                    rating: 5,
-                    tags: ["green", "healthy"],
-                },
-            },
-            recordOfPrimitives: {},
-            nestedRecords: {},
-            arrayOfObjects: [],
-        });
-    });
-    it("can copy into a doc given by string[].", async () => {
-        const testDoc1 = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, (0, firestore_deps_1.collection)(testCollection, "id-A", "subcol-1"), initialState);
-        const testDoc2 = testDoc1.copy(["id-B", "copy-with-doc-ids"]);
-        expect(testDoc2.docRef.path).toBe("doctests/id-B/subcol-1/copy-with-doc-ids");
-    });
-    it("can copy into a collection using string[] (for new doc).", async () => {
-        const testDoc1 = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, (0, firestore_deps_1.collection)(testCollection, "id-A", "subcol-1"), initialState);
-        const testDoc2 = await testDoc1.copy(["id-B"]).write();
-        expect(testDoc2.docRef.path).toMatch(/^doctests\/id-B\/subcol-1\/[^/]+$/);
-    });
-    it("can copy into a collection using string[] (existing doc).", async () => {
-        const testDoc1 = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, (0, firestore_deps_1.collection)(testCollection, "id-A", "subcol-1"), initialState);
-        await testDoc1.write();
-        const testDoc2 = await testDoc1.copy(["id-B"]).write();
-        expect(testDoc2.docRef.path).toMatch(/^doctests\/id-B\/subcol-1\/[^/]+$/);
-    });
-    it("throws when given string[] with the wrong number of IDs.", async () => {
-        const testDoc1 = FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, (0, firestore_deps_1.collection)(testCollection, "id-A", "subcol-1", "id-B", "subcol-2"), initialState);
-        expect(() => testDoc1.copy(["A"])).toThrowError();
-        expect(() => testDoc1.copy(["A", "B", "C", "D"])).toThrowError();
-    });
-});
-describe("other zod types", () => {
-    it("handles z.any", async () => {
-        const schema = zod_1.z.object({
-            anything: zod_1.z.any(),
-            arrayOfAnythings: zod_1.z.array(zod_1.z.any()),
-        });
-        const data = {
-            anything: {
-                foo: "hello",
-                bar: 123,
-            },
-            arrayOfAnythings: [{ a: { x: 123, y: 234 }, b: 222 }, { c: 333 }],
-        };
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, data);
-        const testDoc = await new FiretenderDoc_1.FiretenderDoc(schema, docRef).load();
-        expect(testDoc.r).toEqual(data);
-        await testDoc.update((data) => {
-            data.anything = "I can haz primitive?";
-            data.arrayOfAnythings[1] = data.arrayOfAnythings[0];
-            const a = data.arrayOfAnythings[1].a;
-            data.arrayOfAnythings.push(a);
-        });
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({
-            anything: "I can haz primitive?",
-            arrayOfAnythings: [
-                { a: { x: 123, y: 234 }, b: 222 },
-                { a: { x: 123, y: 234 }, b: 222 },
-                { x: 123, y: 234 },
-            ],
-        });
-    });
-    it("handles enums", async () => {
-        const schema = zod_1.z.object({
-            x: zod_1.z.enum(["a", "b", "c"]),
-        });
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, { x: "b" });
-        const testDoc = await new FiretenderDoc_1.FiretenderDoc(schema, docRef).load();
-        expect(testDoc.r).toEqual({ x: "b" });
-        await testDoc.update((data) => {
-            data.x = "c";
-        });
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({ x: "c" });
-    });
-    it("handles nullable fields", async () => {
-        const schema = zod_1.z.object({
-            x: zod_1.z.number().nullable(),
-            y: zod_1.z.number().nullable(),
-            z: zod_1.z.object({ a: zod_1.z.string(), b: zod_1.z.string() }).nullable(),
-        });
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, {
-            x: 111,
-            y: null,
-            z: { a: "foo", b: "bar" },
-        });
-        const testDoc = await new FiretenderDoc_1.FiretenderDoc(schema, docRef).load();
-        expect(testDoc.r).toEqual({ x: 111, y: null, z: { a: "foo", b: "bar" } });
-        await testDoc.update((data) => {
-            data.x = null;
-            data.y = 222;
-            if (data.z) {
-                data.z.b = "baz";
-            }
-        });
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({ x: null, y: 222, z: { a: "foo", b: "baz" } });
-    });
-    it("handles discriminating unions", async () => {
-        const schema = zod_1.z.object({
-            someUnion: zod_1.z.discriminatedUnion("type", [
-                zod_1.z.object({
-                    type: zod_1.z.literal("x"),
-                    x: zod_1.z.object({
-                        x2: zod_1.z.string(),
-                    }),
-                }),
-                zod_1.z.object({
-                    type: zod_1.z.literal("y"),
-                    y: zod_1.z.object({
-                        y2: zod_1.z.number(),
-                    }),
-                }),
-            ]),
-        });
-        const docRef = await (0, firestore_deps_1.addDoc)(testCollection, {
-            someUnion: {
-                type: "x",
-                x: { x2: "123" },
-            },
-        });
-        const testDoc = await new FiretenderDoc_1.FiretenderDoc(schema, docRef).load();
-        expect(testDoc.r).toEqual({ someUnion: { type: "x", x: { x2: "123" } } });
-        await testDoc.update((data) => {
-            let x2 = "";
-            if (data.someUnion.type === "x") {
-                x2 = data.someUnion.x.x2;
-            }
-            data.someUnion = { type: "y", y: { y2: Number(x2) } };
-        });
-        const result = (await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data();
-        expect(result).toEqual({ someUnion: { type: "y", y: { y2: 123 } } });
-    });
-});
-describe("timestamps", () => {
-    it("writes Firestore's Timestamp type", async () => {
-        const now = new Date();
-        const testDoc = await FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, {
-            email: "bob@example.com",
-            ttl: firestore_deps_1.Timestamp.fromDate(now),
-        }).write();
-        const doc = await (0, firestore_deps_1.getDoc)(testDoc.docRef);
-        expect(doc.data()?.ttl.toDate()).toEqual(now);
-    });
-    it("reads Firestore's Timestamp type.", async () => {
-        const now = new Date();
-        const testDoc = await createAndLoadDoc({
-            email: "bob@example.com",
-            ttl: firestore_deps_1.Timestamp.fromDate(now),
-        });
-        expect(testDoc.r.ttl?.toDate()).toEqual(now);
-    });
-    it("generates server timestamps in new doc", async () => {
-        const testDoc = await FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, {
-            email: "bob@example.com",
-            ttl: (0, timestamps_1.serverTimestamp)(),
-        }).write();
-        const doc = await (0, firestore_deps_1.getDoc)(testDoc.docRef);
-        const millisDiff = Math.abs(doc.data()?.ttl.toMillis() - Date.now());
-        expect(millisDiff).toBeLessThan(10000); // Less than 10 seconds apart.
-    });
-    it("generates server timestamps in existing doc", async () => {
-        const pastDate = new Date(2001, 2, 3);
-        const testDoc = await FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, {
-            email: "bob@example.com",
-            ttl: firestore_deps_1.Timestamp.fromDate(pastDate),
-        }).write();
-        expect((await (0, firestore_deps_1.getDoc)(testDoc.docRef)).data()?.ttl.toDate()).toEqual(pastDate);
-        await testDoc.update((doc) => {
-            doc.ttl = (0, timestamps_1.serverTimestamp)();
-        });
-        const doc = await (0, firestore_deps_1.getDoc)(testDoc.docRef);
-        const millisDiff = Math.abs(doc.data()?.ttl.toMillis() - Date.now());
-        expect(millisDiff).toBeLessThan(10000); // Less than 10 seconds apart.
-    });
-    it("provides temporary client-generated timestamps", async () => {
-        const now = new Date();
-        const testDoc = await FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, {
-            email: "bob@example.com",
-            ttl: (0, timestamps_1.serverTimestampWithClientTime)(),
-        });
-        // Wait 100 ms before writing to avoid coincident timestamps.  The test
-        // server runs locally, so this should always work....
-        await new Promise((resolve) => setTimeout(resolve, 100));
-        await testDoc.write();
-        // Was a temp timestamp defined, and is it approximately now?
-        const tempTimestamp = testDoc.r.ttl;
-        expect(tempTimestamp).toBeDefined();
-        let millisDiff = Math.abs(tempTimestamp.toMillis() - now.valueOf());
-        expect(millisDiff).toBeLessThan(10000); // Less than 10 seconds apart.
-        // Check that the temp timestamp's polyfills are working.  Note that the
-        // firestore-admin version of Timestamp has underscores preceding its
-        // seconds and nanoseconds properties.
-        expect(tempTimestamp.isEqual(new firestore_deps_1.Timestamp(tempTimestamp.seconds ?? tempTimestamp._seconds, tempTimestamp.nanoseconds ?? tempTimestamp._nanoseconds)));
-        expect(tempTimestamp.toDate().getTime() === tempTimestamp.toMillis());
-        expect(tempTimestamp.toString().length > 0);
-        expect(tempTimestamp.valueOf().length > 0);
-        // On reading, is there a server timestamp that differs from the temp one?
-        await testDoc.load({ force: true });
-        const assignedTimestamp = testDoc.r.ttl;
-        expect(assignedTimestamp).toBeDefined();
-        expect(assignedTimestamp.toMillis() !== tempTimestamp.toMillis());
-        // Is the server timestamp approximately now?
-        millisDiff = Math.abs(assignedTimestamp.toMillis() - now.valueOf());
-        expect(millisDiff).toBeLessThan(10000); // Less than 10 seconds apart.
-    });
-    it("generates future timestamps", async () => {
-        const testDoc = await FiretenderDoc_1.FiretenderDoc.createNewDoc(testDataSchema, testCollection, {
-            email: "bob@example.com",
-            ttl: (0, timestamps_1.futureTimestamp)({ days: 30 }),
-        }).write();
-        const doc = await (0, firestore_deps_1.getDoc)(testDoc.docRef);
-        const futureMillis = Date.now() + 30 * 86400e3;
-        const millisDiff = Math.abs(doc.data()?.ttl.toMillis() - futureMillis);
-        expect(millisDiff).toBeLessThan(10000); // Less than 10 seconds apart.
-    });
-});
-//# sourceMappingURL=FiretenderDoc.spec.js.map