@dereekb/firebase 13.32.0 → 13.33.0

package/test/index.cjs.js

@@ -5,12 +5,14 @@ var rulesUnitTesting = require('@firebase/rules-unit-testing');
 var firebase = require('@dereekb/firebase');
 var firestore = require('firebase/firestore');
 var test = require('@dereekb/util/test');
+var node_fs = require('node:fs');
+var node_path = require('node:path');
+var node_url = require('node:url');
 var rxjs$1 = require('rxjs');
 var rxjs = require('@dereekb/rxjs');
 var dateFns = require('date-fns');
 var date = require('@dereekb/date');
 var node_stream = require('node:stream');
-var node_fs = require('node:fs');
 
 function _array_like_to_array$2(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
@@ -23,7 +25,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;
@@ -37,22 +39,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,
@@ -98,7 +100,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);
@@ -108,7 +110,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;
@@ -146,7 +148,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() {
@@ -302,7 +304,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,
@@ -320,7 +322,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)
     });
@@ -333,9 +335,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();
@@ -357,7 +359,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,
@@ -370,7 +372,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);
@@ -380,7 +382,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;
@@ -423,7 +425,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;
@@ -435,7 +437,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)
     });
@@ -469,7 +471,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,
@@ -535,8 +537,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;
     }
@@ -605,7 +607,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;
@@ -619,16 +621,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);
         });
@@ -656,7 +658,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,
@@ -688,7 +690,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);
@@ -698,7 +700,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;
@@ -747,7 +749,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() {
@@ -857,7 +859,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({}, firebase.firestoreContextFactory(drivers)(rulesTestContext.firestore())), {
+    var context = _object_spread_props(_object_spread$2({}, firebase.firestoreContextFactory(drivers)(rulesTestContext.firestore())), {
         drivers: drivers,
         rulesTestContext: rulesTestContext,
         rulesTestEnvironment: rulesTestEnvironment
@@ -875,7 +877,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({}, firebase.firebaseStorageContextFactory(drivers)(rulesTestContext.storage())), {
+    var context = _object_spread_props(_object_spread$2({}, firebase.firebaseStorageContextFactory(drivers)(rulesTestContext.storage())), {
         drivers: drivers,
         rulesTestContext: rulesTestContext,
         rulesTestEnvironment: rulesTestEnvironment
@@ -892,13 +894,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", util.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", util.cachedGetter(function() {
             return makeRulesTestFirestoreContext(_this.drivers, _this.rulesTestEnvironment, _this.rulesTestContext);
         }));
-        _define_property$6(this, "_storageContext", util.cachedGetter(function() {
+        _define_property$7(this, "_storageContext", util.cachedGetter(function() {
             return makeRulesTestFirebaseStorageContext(_this.drivers, _this.rulesTestEnvironment, _this.rulesTestContext);
         }));
         this.drivers = drivers;
@@ -972,8 +974,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 [
@@ -991,8 +993,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 [
@@ -1022,11 +1024,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(firebase.firebaseFirestoreClientDrivers()), makeTestingFirebaseStorageDrivers(firebase.firebaseStorageClientDrivers(), {
+                        drivers = _object_spread$2({}, makeTestingFirestoreDrivers(firebase.firebaseFirestoreClientDrivers()), makeTestingFirebaseStorageDrivers(firebase.firebaseStorageClientDrivers(), {
                             useTestDefaultBucket: true
                         }));
                         if (config.testEnvironment.collectionNames) {
@@ -1174,7 +1176,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,
@@ -1856,7 +1858,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)) {
@@ -2051,7 +2053,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,
@@ -2117,8 +2119,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);
     }
@@ -2268,7 +2270,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,
@@ -2333,7 +2335,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, [
@@ -2423,6 +2425,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:') ? node_path.dirname(node_url.fileURLToPath(from)) : from;
+    var directory = startPath;
+    var found = null;
+    // walk up to the filesystem root looking for the rules file.
+    while(!found){
+        var candidate = node_path.join(directory, fileName !== null && fileName !== void 0 ? fileName : DEFAULT_FIRESTORE_RULES_FILE_NAME);
+        if (node_fs.existsSync(candidate)) {
+            found = candidate;
+        } else {
+            var parent = node_path.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 node_fs.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,
+                                rulesUnitTesting.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");
@@ -13687,8 +13997,17 @@ function _ts_generator(thisArg, body) {
     });
 }
 
+Object.defineProperty(exports, "assertFails", {
+    enumerable: true,
+    get: function () { return rulesUnitTesting.assertFails; }
+});
+Object.defineProperty(exports, "assertSucceeds", {
+    enumerable: true,
+    get: function () { return rulesUnitTesting.assertSucceeds; }
+});
 exports.AUTHORIZED_FIRESTORE_RULES = AUTHORIZED_FIRESTORE_RULES;
 exports.AUTHORIZED_STORAGE_RULES = AUTHORIZED_STORAGE_RULES;
+exports.DEFAULT_FIRESTORE_RULES_FILE_NAME = DEFAULT_FIRESTORE_RULES_FILE_NAME;
 exports.DEFAULT_MOCK_ITEM_PAGED_MAX_ITEMS_PER_PAGE = DEFAULT_MOCK_ITEM_PAGED_MAX_ITEMS_PER_PAGE;
 exports.MOCK_FIREBASE_MODEL_SERVICE_FACTORIES = MOCK_FIREBASE_MODEL_SERVICE_FACTORIES;
 exports.MOCK_ITEM_PAGED_ALPHA_DISTRIBUTION_SCHEME = MOCK_ITEM_PAGED_ALPHA_DISTRIBUTION_SCHEME;
@@ -13731,6 +14050,7 @@ exports.describeFirestoreDocumentUtilityTests = describeFirestoreDocumentUtility
 exports.describeFirestoreIterationTests = describeFirestoreIterationTests;
 exports.describeFirestoreQueryDriverTests = describeFirestoreQueryDriverTests;
 exports.firebaseRulesUnitTestBuilder = firebaseRulesUnitTestBuilder;
+exports.firestoreRulesTestBuilder = firestoreRulesTestBuilder;
 exports.makeMockItemCollections = makeMockItemCollections;
 exports.makeRulesTestFirebaseStorageContext = makeRulesTestFirebaseStorageContext;
 exports.makeRulesTestFirestoreContext = makeRulesTestFirestoreContext;
@@ -13783,5 +14103,6 @@ exports.mockItemUserFirestoreCollectionGroup = mockItemUserFirestoreCollectionGr
 exports.mockItemUserIdentity = mockItemUserIdentity;
 exports.mockItemWithTestValue = mockItemWithTestValue;
 exports.mockItemWithValue = mockItemWithValue;
+exports.readFirestoreRulesFile = readFirestoreRulesFile;
 exports.testWithMockItemCollectionFixture = testWithMockItemCollectionFixture;
 exports.testWithMockItemStorageFixture = testWithMockItemStorageFixture;