@dereekb/firebase 13.32.0 → 13.34.0

package/test/index.esm.js

@@ -1,14 +1,17 @@
 import { performAsyncTasks, cachedGetter, bitwiseObjectDencoder, modelFieldConversions, compareStrings, waitForMs, isEvenNumber, unique, arrayFactory, mapGetter, randomNumberFactory, randomFromArrayFactory, idBatchFactory, arrayContainsDuplicateValue, useCallback, readableStreamToBuffer, SLASH_PATH_SEPARATOR } from '@dereekb/util';
 import { initializeTestEnvironment } from '@firebase/rules-unit-testing';
+export { assertFails, assertSucceeds } from '@firebase/rules-unit-testing';
 import { firebaseStorageContextFactory, firestoreContextFactory, firebaseFirestoreClientDrivers, firebaseStorageClientDrivers, firestoreModelIdentity, snapshotConverterFunctions, firestoreBoolean, optionalFirestoreNumber, optionalFirestoreDate, optionalFirestoreArray, optionalFirestoreString, firestoreDate, firestoreBitwiseObjectMap, firestoreUniqueStringArray, firestoreNumber, firestoreString, firestoreUID, copyUserRelatedDataAccessorFactoryFunction, firestoreSubObject, defaultPagedItemPageDataConverter, AbstractFirestoreDocument, AbstractFirestoreDocumentWithParent, firebaseModelServiceFactory, grantFullAccessIfAdmin, firebaseModelsService, systemStateFirestoreCollection, allChildDocumentsUnderParent, where, makeDocuments, getDocumentSnapshotPairs, useDocumentSnapshot, useDocumentSnapshotData, firestoreIdBatchVerifierFactory, limit, orderBy, limitToLast, whereDocumentId, loadAllFirestoreDocumentSnapshotPairs, loadAllFirestoreDocumentSnapshot, iterateFirestoreDocumentSnapshotPairs, iterateFirestoreDocumentSnapshots, iterateFirestoreDocumentSnapshotPairBatches, iterateFirestoreDocumentSnapshotBatches, whereStringHasRootIdentityModelKey, whereStringValueHasPrefix, whereDateIsAfterWithSort, whereDateIsBeforeWithSort, whereDateIsOnOrAfterWithSort, whereDateIsOnOrBeforeWithSort, whereDateIsInRange, whereDateIsBetween, startAt, orderByDocumentId, startAtValue, startAfter, endAt, endAtValue, endBefore, streamFromOnSnapshot, latestSnapshotsFromDocuments, newDocuments, loadDocumentsForDocumentReferences, loadDocumentsForDocumentReferencesFromValues, loadDocumentsForKeys, loadDocumentsForKeysFromValues, loadDocumentsForIds, loadDocumentsForIdsFromValues, firestoreDocumentLoader, setIdAndKeyFromKeyIdRefOnDocumentData, firestoreModelIdFromDocument, firestoreModelIdsFromDocuments, firestoreModelKeyFromDocument, firestoreModelKeysFromDocuments, documentReferenceFromDocument, documentReferencesFromDocuments, limitedFirestoreDocumentAccessorSnapshotCache, mapLatestSnapshotsFromDocuments, streamDocumentSnapshotsData, dataFromDocumentSnapshots, streamDocumentSnapshotDataPairs, streamDocumentSnapshotDataPairsWithData, getDocumentSnapshots, getDocumentSnapshotPair, getDocumentSnapshotDataPair, getDocumentSnapshotDataPairs, getDocumentSnapshotDataPairsWithData, getDocumentSnapshotDataTuples, getDocumentSnapshotData, getDocumentSnapshotsData, getDataFromDocumentSnapshots, loadDocumentsForSnapshots, firestoreDocumentSnapshotPairsLoader, documentData, documentDataFunction, documentDataWithIdAndKey, setIdAndKeyFromSnapshotOnDocumentData, firebaseQuerySnapshotAccumulator, firebaseQueryItemAccumulator, uploadFileWithStream, iterateStorageListFilesByEachFile } from '@dereekb/firebase';
 import { setLogLevel } from 'firebase/firestore';
 import { AbstractTestContextFixture, instanceWrapTestContextFactory, AbstractWrappedFixtureWithInstance, itShouldFail, callbackTest, expectFail } from '@dereekb/util/test';
+import { existsSync, readFileSync, createReadStream } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { firstValueFrom, filter, skip, from, first, map, switchMap } from 'rxjs';
 import { SubscriptionObject, isLoadingStateFinishedLoading, flattenAccumulatorResultItemArray, iteratorNextPageUntilPage, accumulatorCurrentPageListLoadingState, accumulatorFlattenPageListLoadingState } from '@dereekb/rxjs';
 import { addDays, startOfDay, addHours } from 'date-fns';
 import { DateRangeType } from '@dereekb/date';
 import { Readable } from 'node:stream';
-import { createReadStream } from 'node:fs';
 
 function _array_like_to_array$2(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
@@ -21,7 +24,7 @@ function _array_with_holes$1(arr) {
 function _array_without_holes$2(arr) {
     if (Array.isArray(arr)) return _array_like_to_array$2(arr);
 }
-function asyncGeneratorStep$6(gen, resolve, reject, _next, _throw, key, arg) {
+function asyncGeneratorStep$7(gen, resolve, reject, _next, _throw, key, arg) {
     try {
         var info = gen[key](arg);
         var value = info.value;
@@ -35,22 +38,22 @@ function asyncGeneratorStep$6(gen, resolve, reject, _next, _throw, key, arg) {
         Promise.resolve(value).then(_next, _throw);
     }
 }
-function _async_to_generator$6(fn) {
+function _async_to_generator$7(fn) {
     return function() {
         var self = this, args = arguments;
         return new Promise(function(resolve, reject) {
             var gen = fn.apply(self, args);
             function _next(value) {
-                asyncGeneratorStep$6(gen, resolve, reject, _next, _throw, "next", value);
+                asyncGeneratorStep$7(gen, resolve, reject, _next, _throw, "next", value);
             }
             function _throw(err) {
-                asyncGeneratorStep$6(gen, resolve, reject, _next, _throw, "throw", err);
+                asyncGeneratorStep$7(gen, resolve, reject, _next, _throw, "throw", err);
             }
             _next(undefined);
         });
     };
 }
-function _define_property$9(obj, key, value) {
+function _define_property$a(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -96,7 +99,7 @@ function _non_iterable_rest$1() {
 function _non_iterable_spread$2() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _object_spread$3(target) {
+function _object_spread$4(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
         var ownKeys = Object.keys(source);
@@ -106,7 +109,7 @@ function _object_spread$3(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$9(target, key, source[key]);
+            _define_property$a(target, key, source[key]);
         });
     }
     return target;
@@ -144,7 +147,7 @@ function _unsupported_iterable_to_array$2(o, minLen) {
     if (n === "Map" || n === "Set") return Array.from(n);
     if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$2(o, minLen);
 }
-function _ts_generator$6(thisArg, body) {
+function _ts_generator$7(thisArg, body) {
     var f, y, t, _ = {
         label: 0,
         sent: function() {
@@ -300,7 +303,7 @@ function _ts_generator$6(thisArg, body) {
         });
         return fuzzedMap;
     };
-    var injectedDriver = _object_spread_props$2(_object_spread$3({}, driver), {
+    var injectedDriver = _object_spread_props$2(_object_spread$4({}, driver), {
         collection: fuzzedCollection,
         collectionGroup: fuzzedCollectionGroup,
         subcollection: fuzzedSubcollection,
@@ -318,7 +321,7 @@ function _ts_generator$6(thisArg, body) {
  * @param drivers - The base Firestore drivers to wrap.
  * @returns A {@link TestingFirestoreDrivers} marked with `firestoreDriverType: 'testing'` and a wrapped accessor driver from {@link makeTestingFirestoreAccesorDriver}.
  */ function makeTestingFirestoreDrivers(drivers) {
-    return _object_spread_props$2(_object_spread$3({}, drivers), {
+    return _object_spread_props$2(_object_spread$4({}, drivers), {
         firestoreDriverType: 'testing',
         firestoreAccessorDriver: makeTestingFirestoreAccesorDriver(drivers.firestoreAccessorDriver)
     });
@@ -331,9 +334,9 @@ function _ts_generator$6(thisArg, body) {
  * @param context - The test context whose fuzzed collections should be cleared.
  * @param clearCollection - Callback that performs the actual deletion for a single collection.
  */ function clearTestFirestoreContextCollections(context, clearCollection) {
-    return _async_to_generator$6(function() {
+    return _async_to_generator$7(function() {
         var names, tuples;
-        return _ts_generator$6(this, function(_state) {
+        return _ts_generator$7(this, function(_state) {
             switch(_state.label){
                 case 0:
                     names = context.drivers.firestoreAccessorDriver.getFuzzedCollectionsNameMap();
@@ -355,7 +358,7 @@ function _ts_generator$6(thisArg, body) {
     })();
 }
 
-function _define_property$8(obj, key, value) {
+function _define_property$9(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -368,7 +371,7 @@ function _define_property$8(obj, key, value) {
     }
     return obj;
 }
-function _object_spread$2(target) {
+function _object_spread$3(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
         var ownKeys = Object.keys(source);
@@ -378,7 +381,7 @@ function _object_spread$2(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$8(target, key, source[key]);
+            _define_property$9(target, key, source[key]);
         });
     }
     return target;
@@ -421,7 +424,7 @@ var bucketTestNameKey = 0;
         var random = Math.ceil(Math.random() * 999999) % 999999;
         return "test-bucket-".concat(time, "-").concat(random, "-").concat(bucketTestNameKey += 1);
     }) : driver.getDefaultBucket;
-    var injectedDriver = _object_spread_props$1(_object_spread$2({}, driver), {
+    var injectedDriver = _object_spread_props$1(_object_spread$3({}, driver), {
         getDefaultBucket: defaultBucket
     });
     return injectedDriver;
@@ -433,7 +436,7 @@ var bucketTestNameKey = 0;
  * @param config - Optional config forwarded to {@link makeTestingFirebaseStorageAccesorDriver}; controls test-bucket override behavior.
  * @returns A {@link TestingFirebaseStorageDrivers} marked with `storageDriverType: 'testing'` and a wrapped accessor driver.
  */ function makeTestingFirebaseStorageDrivers(drivers, config) {
-    return _object_spread_props$1(_object_spread$2({}, drivers), {
+    return _object_spread_props$1(_object_spread$3({}, drivers), {
         storageDriverType: 'testing',
         storageAccessorDriver: makeTestingFirebaseStorageAccesorDriver(drivers.storageAccessorDriver, config)
     });
@@ -467,7 +470,7 @@ function _create_class$6(Constructor, protoProps, staticProps) {
     if (protoProps) _defineProperties$6(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$7(obj, key, value) {
+function _define_property$8(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -533,8 +536,8 @@ function _is_native_reflect_construct$6() {
  */ var TestFirebaseInstance = /*#__PURE__*/ function() {
     function TestFirebaseInstance(firestoreContext, storageContext) {
         _class_call_check$7(this, TestFirebaseInstance);
-        _define_property$7(this, "firestoreContext", void 0);
-        _define_property$7(this, "storageContext", void 0);
+        _define_property$8(this, "firestoreContext", void 0);
+        _define_property$8(this, "storageContext", void 0);
         this.firestoreContext = firestoreContext;
         this.storageContext = storageContext;
     }
@@ -603,7 +606,7 @@ function _assert_this_initialized$5(self) {
     }
     return self;
 }
-function asyncGeneratorStep$5(gen, resolve, reject, _next, _throw, key, arg) {
+function asyncGeneratorStep$6(gen, resolve, reject, _next, _throw, key, arg) {
     try {
         var info = gen[key](arg);
         var value = info.value;
@@ -617,16 +620,16 @@ function asyncGeneratorStep$5(gen, resolve, reject, _next, _throw, key, arg) {
         Promise.resolve(value).then(_next, _throw);
     }
 }
-function _async_to_generator$5(fn) {
+function _async_to_generator$6(fn) {
     return function() {
         var self = this, args = arguments;
         return new Promise(function(resolve, reject) {
             var gen = fn.apply(self, args);
             function _next(value) {
-                asyncGeneratorStep$5(gen, resolve, reject, _next, _throw, "next", value);
+                asyncGeneratorStep$6(gen, resolve, reject, _next, _throw, "next", value);
             }
             function _throw(err) {
-                asyncGeneratorStep$5(gen, resolve, reject, _next, _throw, "throw", err);
+                asyncGeneratorStep$6(gen, resolve, reject, _next, _throw, "throw", err);
             }
             _next(undefined);
         });
@@ -654,7 +657,7 @@ function _create_class$5(Constructor, protoProps, staticProps) {
     if (protoProps) _defineProperties$5(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$6(obj, key, value) {
+function _define_property$7(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -686,7 +689,7 @@ function _inherits$5(subClass, superClass) {
     });
     if (superClass) _set_prototype_of$5(subClass, superClass);
 }
-function _object_spread$1(target) {
+function _object_spread$2(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
         var ownKeys = Object.keys(source);
@@ -696,7 +699,7 @@ function _object_spread$1(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$6(target, key, source[key]);
+            _define_property$7(target, key, source[key]);
         });
     }
     return target;
@@ -745,7 +748,7 @@ function _is_native_reflect_construct$5() {
         return !!result;
     })();
 }
-function _ts_generator$5(thisArg, body) {
+function _ts_generator$6(thisArg, body) {
     var f, y, t, _ = {
         label: 0,
         sent: function() {
@@ -855,7 +858,7 @@ function _ts_generator$5(thisArg, body) {
  * @param rulesTestContext - The per-test rules context (authenticated or unauthenticated) used to obtain the Firestore instance.
  * @returns A {@link RulesUnitTestTestFirestoreContext} that exposes the rules-test environment and context alongside the standard Firestore context.
  */ function makeRulesTestFirestoreContext(drivers, rulesTestEnvironment, rulesTestContext) {
-    var context = _object_spread_props(_object_spread$1({}, firestoreContextFactory(drivers)(rulesTestContext.firestore())), {
+    var context = _object_spread_props(_object_spread$2({}, firestoreContextFactory(drivers)(rulesTestContext.firestore())), {
         drivers: drivers,
         rulesTestContext: rulesTestContext,
         rulesTestEnvironment: rulesTestEnvironment
@@ -873,7 +876,7 @@ function _ts_generator$5(thisArg, body) {
  * @param rulesTestContext - The per-test rules context used to obtain the Storage instance.
  * @returns A {@link RulesUnitTestTestFirebaseStorageContext} that exposes the rules-test environment and context alongside the standard Storage context.
  */ function makeRulesTestFirebaseStorageContext(drivers, rulesTestEnvironment, rulesTestContext) {
-    var context = _object_spread_props(_object_spread$1({}, firebaseStorageContextFactory(drivers)(rulesTestContext.storage())), {
+    var context = _object_spread_props(_object_spread$2({}, firebaseStorageContextFactory(drivers)(rulesTestContext.storage())), {
         drivers: drivers,
         rulesTestContext: rulesTestContext,
         rulesTestEnvironment: rulesTestEnvironment
@@ -890,13 +893,13 @@ function _ts_generator$5(thisArg, body) {
     function RulesUnitTestTestFirebaseInstance(drivers, rulesTestEnvironment, rulesTestContext) {
         var _this = this;
         _class_call_check$6(this, RulesUnitTestTestFirebaseInstance);
-        _define_property$6(this, "drivers", void 0);
-        _define_property$6(this, "rulesTestEnvironment", void 0);
-        _define_property$6(this, "rulesTestContext", void 0);
-        _define_property$6(this, "_firestoreContext", cachedGetter(function() {
+        _define_property$7(this, "drivers", void 0);
+        _define_property$7(this, "rulesTestEnvironment", void 0);
+        _define_property$7(this, "rulesTestContext", void 0);
+        _define_property$7(this, "_firestoreContext", cachedGetter(function() {
             return makeRulesTestFirestoreContext(_this.drivers, _this.rulesTestEnvironment, _this.rulesTestContext);
         }));
-        _define_property$6(this, "_storageContext", cachedGetter(function() {
+        _define_property$7(this, "_storageContext", cachedGetter(function() {
             return makeRulesTestFirebaseStorageContext(_this.drivers, _this.rulesTestEnvironment, _this.rulesTestContext);
         }));
         this.drivers = drivers;
@@ -970,8 +973,8 @@ function _ts_generator$5(thisArg, body) {
         // Initialize the emulator environment once per test suite.
         // This is the expensive operation that hits the emulator's REST API (e.g. PUT /internal/setRules).
         beforeAll(function() {
-            return _async_to_generator$5(function() {
-                return _ts_generator$5(this, function(_state) {
+            return _async_to_generator$6(function() {
+                return _ts_generator$6(this, function(_state) {
                     switch(_state.label){
                         case 0:
                             return [
@@ -989,8 +992,8 @@ function _ts_generator$5(thisArg, body) {
         });
         // Clean up the emulator environment once after all tests complete.
         afterAll(function() {
-            return _async_to_generator$5(function() {
-                return _ts_generator$5(this, function(_state) {
+            return _async_to_generator$6(function() {
+                return _ts_generator$6(this, function(_state) {
                     switch(_state.label){
                         case 0:
                             if (!rulesTestEnvironment) return [
@@ -1020,11 +1023,11 @@ function _ts_generator$5(thisArg, body) {
         // (via makeTestingFirestoreAccesorDriver) to provide data isolation between tests.
         var clearInstance = null;
         beforeEach(function() {
-            return _async_to_generator$5(function() {
+            return _async_to_generator$6(function() {
                 var drivers, rulesTestContext, instance;
-                return _ts_generator$5(this, function(_state) {
+                return _ts_generator$6(this, function(_state) {
                     try {
-                        drivers = _object_spread$1({}, makeTestingFirestoreDrivers(firebaseFirestoreClientDrivers()), makeTestingFirebaseStorageDrivers(firebaseStorageClientDrivers(), {
+                        drivers = _object_spread$2({}, makeTestingFirestoreDrivers(firebaseFirestoreClientDrivers()), makeTestingFirebaseStorageDrivers(firebaseStorageClientDrivers(), {
                             useTestDefaultBucket: true
                         }));
                         if (config.testEnvironment.collectionNames) {
@@ -1172,7 +1175,7 @@ function _create_class$4(Constructor, protoProps, staticProps) {
     if (protoProps) _defineProperties$4(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$5(obj, key, value) {
+function _define_property$6(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1854,7 +1857,7 @@ function _is_native_reflect_construct$4() {
  *
  * Used when creating the mock system state Firestore collection to register
  * the {@link MockSystemData} converter under the {@link MOCK_SYSTEM_STATE_TYPE} key.
- */ var MOCK_ITEM_SYSTEM_STATE_STORED_DATA_CONVERTER_MAP = _define_property$5({}, MOCK_SYSTEM_STATE_TYPE, mockItemSystemDataConverter);
+ */ var MOCK_ITEM_SYSTEM_STATE_STORED_DATA_CONVERTER_MAP = _define_property$6({}, MOCK_SYSTEM_STATE_TYPE, mockItemSystemDataConverter);
 
 function _class_call_check$4(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
@@ -2049,7 +2052,7 @@ function _create_class$3(Constructor, protoProps, staticProps) {
     if (protoProps) _defineProperties$3(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$4(obj, key, value) {
+function _define_property$5(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -2115,8 +2118,8 @@ function _is_native_reflect_construct$3() {
  */ var MockItemCollectionFixtureInstance = /*#__PURE__*/ function() {
     function MockItemCollectionFixtureInstance(fixture) {
         _class_call_check$3(this, MockItemCollectionFixtureInstance);
-        _define_property$4(this, "fixture", void 0);
-        _define_property$4(this, "collections", void 0);
+        _define_property$5(this, "fixture", void 0);
+        _define_property$5(this, "collections", void 0);
         this.fixture = fixture;
         this.collections = makeMockItemCollections(fixture.parent.firestoreContext);
     }
@@ -2266,7 +2269,7 @@ function _create_class$2(Constructor, protoProps, staticProps) {
     if (protoProps) _defineProperties$2(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$3(obj, key, value) {
+function _define_property$4(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -2331,7 +2334,7 @@ function _is_native_reflect_construct$2() {
  */ var MockItemStorageFixtureInstance = /*#__PURE__*/ function() {
     function MockItemStorageFixtureInstance(fixture) {
         _class_call_check$2(this, MockItemStorageFixtureInstance);
-        _define_property$3(this, "fixture", void 0);
+        _define_property$4(this, "fixture", void 0);
         this.fixture = fixture;
     }
     _create_class$2(MockItemStorageFixtureInstance, [
@@ -2421,6 +2424,314 @@ function _is_native_reflect_construct$2() {
  * Uses @firebase/storage. This is ONLY for the client.
  */ var authorizedTestWithMockItemStorage = testWithMockItemStorageFixture()(authorizedFirebaseFactory);
 
+function asyncGeneratorStep$5(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator$5(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep$5(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep$5(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _define_property$3(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _object_spread$1(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property$3(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function _ts_generator$5(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+/**
+ * Default file name of the workspace's Firestore security rules.
+ */ var DEFAULT_FIRESTORE_RULES_FILE_NAME = 'firestore.rules';
+/**
+ * Reads the workspace's Firestore rules file by walking up from the given module/path.
+ *
+ * @param config - The starting location and optional file name.
+ * @returns The contents of the rules file.
+ * @throws {Error} When no rules file is found at or above the starting location.
+ */ function readFirestoreRulesFile(config) {
+    var from = config.from, _config_fileName = config.fileName, fileName = _config_fileName === void 0 ? DEFAULT_FIRESTORE_RULES_FILE_NAME : _config_fileName;
+    var startPath = from.startsWith('file:') ? dirname(fileURLToPath(from)) : from;
+    var directory = startPath;
+    var found = null;
+    // walk up to the filesystem root looking for the rules file.
+    while(!found){
+        var candidate = join(directory, fileName !== null && fileName !== void 0 ? fileName : DEFAULT_FIRESTORE_RULES_FILE_NAME);
+        if (existsSync(candidate)) {
+            found = candidate;
+        } else {
+            var parent = dirname(directory);
+            if (parent === directory) {
+                break;
+            }
+            directory = parent;
+        }
+    }
+    if (!found) {
+        throw new Error('readFirestoreRulesFile(): could not find "'.concat(fileName, '" at or above "').concat(startPath, '".'));
+    }
+    return readFileSync(found, 'utf8');
+}
+/**
+ * Registers vitest hooks that initialize a Firestore security-rules test environment, and invokes
+ * the given callback with a {@link FirestoreRulesTestFixture}.
+ *
+ * The environment is created once per suite (`beforeAll`), torn down once (`afterAll`), and the
+ * Firestore data is cleared between tests (`beforeEach`).
+ *
+ * @param config - The project id and rules to load.
+ * @returns A function that takes the test body builder.
+ *
+ * @example
+ * ```ts
+ * const rulesTest = firestoreRulesTestBuilder({
+ *   projectId: 'demo-api-rules-test',
+ *   rules: readFirestoreRulesFile({ from: import.meta.url })
+ * });
+ *
+ * describe('firestore.rules', () => {
+ *   rulesTest((f) => {
+ *     it('allows the owner to read their own document', async () => {
+ *       await assertSucceeds(getDoc(doc(f.firestoreForUser('a'), 'uec', 'a')));
+ *     });
+ *   });
+ * });
+ * ```
+ */ function firestoreRulesTestBuilder(config) {
+    var projectId = config.projectId, rules = config.rules, firestore = config.firestore;
+    return function(buildTests) {
+        var rulesTestEnvironment;
+        var contextFirestore = function contextFirestore(context) {
+            return context.firestore();
+        };
+        var fixture = {
+            get rulesTestEnvironment () {
+                return rulesTestEnvironment;
+            },
+            firestoreForUser: function firestoreForUser(userId, tokenOptions) {
+                return contextFirestore(rulesTestEnvironment.authenticatedContext(userId, tokenOptions !== null && tokenOptions !== void 0 ? tokenOptions : undefined));
+            },
+            unauthenticatedFirestore: function unauthenticatedFirestore() {
+                return contextFirestore(rulesTestEnvironment.unauthenticatedContext());
+            },
+            withSecurityRulesDisabled: function withSecurityRulesDisabled(fn) {
+                return rulesTestEnvironment.withSecurityRulesDisabled(function(context) {
+                    return fn(contextFirestore(context));
+                });
+            }
+        };
+        beforeAll(function() {
+            return _async_to_generator$5(function() {
+                return _ts_generator$5(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            return [
+                                4,
+                                initializeTestEnvironment({
+                                    projectId: projectId,
+                                    firestore: _object_spread$1({
+                                        rules: rules
+                                    }, firestore)
+                                })
+                            ];
+                        case 1:
+                            rulesTestEnvironment = _state.sent();
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        });
+        afterAll(function() {
+            return _async_to_generator$5(function() {
+                return _ts_generator$5(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            if (!rulesTestEnvironment) return [
+                                3,
+                                2
+                            ];
+                            return [
+                                4,
+                                rulesTestEnvironment.cleanup().catch(function(e) {
+                                    console.warn('firestoreRulesTestBuilder(): Failed to cleanup rules test environment', e);
+                                    throw e;
+                                })
+                            ];
+                        case 1:
+                            _state.sent();
+                            _state.label = 2;
+                        case 2:
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        });
+        beforeEach(function() {
+            return _async_to_generator$5(function() {
+                return _ts_generator$5(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            return [
+                                4,
+                                rulesTestEnvironment.clearFirestore()
+                            ];
+                        case 1:
+                            _state.sent();
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        });
+        buildTests(fixture);
+    };
+}
+
 function _assert_this_initialized$1(self) {
     if (self === void 0) {
         throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
@@ -13685,4 +13996,4 @@ function _ts_generator(thisArg, body) {
     });
 }
 
-export { AUTHORIZED_FIRESTORE_RULES, AUTHORIZED_STORAGE_RULES, DEFAULT_MOCK_ITEM_PAGED_MAX_ITEMS_PER_PAGE, MOCK_FIREBASE_MODEL_SERVICE_FACTORIES, MOCK_ITEM_PAGED_ALPHA_DISTRIBUTION_SCHEME, MOCK_ITEM_PAGED_ENTRY_CONVERTER, MOCK_ITEM_SYSTEM_STATE_STORED_DATA_CONVERTER_MAP, MOCK_ITEM_USER_COLLECTION_NAME, MOCK_ITEM_USER_IDENTIFIER, MOCK_SYSTEM_STATE_TYPE, MockItemCollectionFixture, MockItemCollectionFixtureInstance, MockItemCollections, MockItemDocument, MockItemPagedDocument, MockItemPrivateDocument, MockItemSettingsItemEnum, MockItemStorageFixture, MockItemStorageFixtureInstance, MockItemSubItemDeepDocument, MockItemSubItemDocument, MockItemUserDocument, RulesUnitTestFirebaseTestingContextFixture, RulesUnitTestTestFirebaseInstance, TESTING_AUTHORIZED_FIREBASE_USER_ID, TestFirebaseContextFixture, TestFirebaseInstance, TestFirebaseStorageContextFixture, TestFirebaseStorageInstance, TestFirestoreContextFixture, TestFirestoreInstance, allChildMockItemSubItemDeepsWithinMockItem, authorizedFirebaseFactory, authorizedFirestoreOnlyFactory, authorizedTestWithMockItemCollection, authorizedTestWithMockItemStorage, changeFirestoreLogLevelBeforeAndAfterTests, clearTestFirestoreContextCollections, describeFirebaseStorageAccessorDriverTests, describeFirestoreAccessorDriverTests, describeFirestoreDocumentAccessorTests, describeFirestoreDocumentUtilityTests, describeFirestoreIterationTests, describeFirestoreQueryDriverTests, firebaseRulesUnitTestBuilder, makeMockItemCollections, makeRulesTestFirebaseStorageContext, makeRulesTestFirestoreContext, makeTestingFirebaseStorageAccesorDriver, makeTestingFirebaseStorageDrivers, makeTestingFirestoreAccesorDriver, makeTestingFirestoreDrivers, mockFirebaseModelServices, mockItemCollectionReference, mockItemConverter, mockItemFirebaseModelServiceFactory, mockItemFirestoreCollection, mockItemIdentity, mockItemPagedCollectionReference, mockItemPagedFirebaseModelServiceFactory, mockItemPagedFirestoreCollection, mockItemPagedFirestoreCollectionGroup, mockItemPagedIdentity, mockItemPrivateCollectionReference, mockItemPrivateCollectionReferenceFactory, mockItemPrivateConverter, mockItemPrivateFirebaseModelServiceFactory, mockItemPrivateFirestoreCollection, mockItemPrivateFirestoreCollectionGroup, mockItemPrivateIdentity, mockItemSettingsItemDencoder, mockItemSubItemCollectionReference, mockItemSubItemCollectionReferenceFactory, mockItemSubItemConverter, mockItemSubItemDeepCollectionReference, mockItemSubItemDeepCollectionReferenceFactory, mockItemSubItemDeepConverter, mockItemSubItemDeepFirebaseModelServiceFactory, mockItemSubItemDeepFirestoreCollection, mockItemSubItemDeepFirestoreCollectionGroup, mockItemSubItemDeepIdentity, mockItemSubItemFirebaseModelServiceFactory, mockItemSubItemFirestoreCollection, mockItemSubItemFirestoreCollectionGroup, mockItemSubItemIdentity, mockItemSystemDataConverter, mockItemSystemStateFirebaseModelServiceFactory, mockItemUserAccessorFactory, mockItemUserCollectionReference, mockItemUserCollectionReferenceFactory, mockItemUserConverter, mockItemUserFirebaseModelServiceFactory, mockItemUserFirestoreCollection, mockItemUserFirestoreCollectionGroup, mockItemUserIdentity, mockItemWithTestValue, mockItemWithValue, testWithMockItemCollectionFixture, testWithMockItemStorageFixture };
+export { AUTHORIZED_FIRESTORE_RULES, AUTHORIZED_STORAGE_RULES, DEFAULT_FIRESTORE_RULES_FILE_NAME, DEFAULT_MOCK_ITEM_PAGED_MAX_ITEMS_PER_PAGE, MOCK_FIREBASE_MODEL_SERVICE_FACTORIES, MOCK_ITEM_PAGED_ALPHA_DISTRIBUTION_SCHEME, MOCK_ITEM_PAGED_ENTRY_CONVERTER, MOCK_ITEM_SYSTEM_STATE_STORED_DATA_CONVERTER_MAP, MOCK_ITEM_USER_COLLECTION_NAME, MOCK_ITEM_USER_IDENTIFIER, MOCK_SYSTEM_STATE_TYPE, MockItemCollectionFixture, MockItemCollectionFixtureInstance, MockItemCollections, MockItemDocument, MockItemPagedDocument, MockItemPrivateDocument, MockItemSettingsItemEnum, MockItemStorageFixture, MockItemStorageFixtureInstance, MockItemSubItemDeepDocument, MockItemSubItemDocument, MockItemUserDocument, RulesUnitTestFirebaseTestingContextFixture, RulesUnitTestTestFirebaseInstance, TESTING_AUTHORIZED_FIREBASE_USER_ID, TestFirebaseContextFixture, TestFirebaseInstance, TestFirebaseStorageContextFixture, TestFirebaseStorageInstance, TestFirestoreContextFixture, TestFirestoreInstance, allChildMockItemSubItemDeepsWithinMockItem, authorizedFirebaseFactory, authorizedFirestoreOnlyFactory, authorizedTestWithMockItemCollection, authorizedTestWithMockItemStorage, changeFirestoreLogLevelBeforeAndAfterTests, clearTestFirestoreContextCollections, describeFirebaseStorageAccessorDriverTests, describeFirestoreAccessorDriverTests, describeFirestoreDocumentAccessorTests, describeFirestoreDocumentUtilityTests, describeFirestoreIterationTests, describeFirestoreQueryDriverTests, firebaseRulesUnitTestBuilder, firestoreRulesTestBuilder, makeMockItemCollections, makeRulesTestFirebaseStorageContext, makeRulesTestFirestoreContext, makeTestingFirebaseStorageAccesorDriver, makeTestingFirebaseStorageDrivers, makeTestingFirestoreAccesorDriver, makeTestingFirestoreDrivers, mockFirebaseModelServices, mockItemCollectionReference, mockItemConverter, mockItemFirebaseModelServiceFactory, mockItemFirestoreCollection, mockItemIdentity, mockItemPagedCollectionReference, mockItemPagedFirebaseModelServiceFactory, mockItemPagedFirestoreCollection, mockItemPagedFirestoreCollectionGroup, mockItemPagedIdentity, mockItemPrivateCollectionReference, mockItemPrivateCollectionReferenceFactory, mockItemPrivateConverter, mockItemPrivateFirebaseModelServiceFactory, mockItemPrivateFirestoreCollection, mockItemPrivateFirestoreCollectionGroup, mockItemPrivateIdentity, mockItemSettingsItemDencoder, mockItemSubItemCollectionReference, mockItemSubItemCollectionReferenceFactory, mockItemSubItemConverter, mockItemSubItemDeepCollectionReference, mockItemSubItemDeepCollectionReferenceFactory, mockItemSubItemDeepConverter, mockItemSubItemDeepFirebaseModelServiceFactory, mockItemSubItemDeepFirestoreCollection, mockItemSubItemDeepFirestoreCollectionGroup, mockItemSubItemDeepIdentity, mockItemSubItemFirebaseModelServiceFactory, mockItemSubItemFirestoreCollection, mockItemSubItemFirestoreCollectionGroup, mockItemSubItemIdentity, mockItemSystemDataConverter, mockItemSystemStateFirebaseModelServiceFactory, mockItemUserAccessorFactory, mockItemUserCollectionReference, mockItemUserCollectionReferenceFactory, mockItemUserConverter, mockItemUserFirebaseModelServiceFactory, mockItemUserFirestoreCollection, mockItemUserFirestoreCollectionGroup, mockItemUserIdentity, mockItemWithTestValue, mockItemWithValue, readFirestoreRulesFile, testWithMockItemCollectionFixture, testWithMockItemStorageFixture };