@dereekb/firebase-server 13.11.14 → 13.11.16

package/test/index.esm.js

@@ -425,7 +425,7 @@ function _ts_generator$a(thisArg, body) {
      * @param fn - Wrapped gen 2 callable request to invoke.
      * @param params - Request payload to pass to the callable, simulating the JSON body of an HTTP call.
      * @param skipJsonConversion - When `true`, skip the JSON serialize/parse round-trip applied to `params` (default `false`).
-     * @returns A promise resolving to the callable's return value.
+     * @returns Promise resolving to the callable's return value.
      */ key: "callWrappedFunction",
             value: function callWrappedFunction(fn, params, skipJsonConversion) {
                 // Parse to JSON then back to simulate sending JSON to the server, and the server parsing it as a POJO.
@@ -461,7 +461,7 @@ function _ts_generator$a(thisArg, body) {
      * @param input.eventType - Discriminator for the auth event being simulated (`google.firebase.auth.user.create` or `google.firebase.auth.user.delete`).
      * @param input.eventOverride - Partial event fields used to override the default placeholder values (e.g., `ipAddress`, `userAgent`, `resource`).
      * @param input.skipJsonConversion - When `true`, skip the JSON serialize/parse round-trip applied to the event payload (default `false`).
-     * @returns A promise that resolves once the blocking function has completed.
+     * @returns Resolves once the blocking function has completed.
      */ key: "callAuthBlockingFunction",
             value: function callAuthBlockingFunction(input) {
                 var fn = input.fn, userRecord = input.userRecord, eventType = input.eventType, eventOverride = input.eventOverride, _input_skipJsonConversion = input.skipJsonConversion, skipJsonConversion = _input_skipJsonConversion === void 0 ? false : _input_skipJsonConversion;
@@ -485,13 +485,13 @@ function _ts_generator$a(thisArg, body) {
         },
         {
             /**
-     * @deprecated gen 1
-     *
      * @param fn
      * @param params
      * @param contextOptions
      * @param skipJsonConversion
      * @returns
+     *
+     * @deprecated gen 1
      */ // eslint-disable-next-line @typescript-eslint/max-params -- deprecated gen 1 signature kept for downstream compatibility
             key: "callEventCloudFunction",
             value: function callEventCloudFunction(fn, params, contextOptions) {
@@ -535,7 +535,7 @@ function _ts_generator$a(thisArg, body) {
  * custom claims, and post-create initialization) and tear it down afterward.
  *
  * @param config - Factory configuration: optional uid generator, custom fixture/instance constructors, user-detail builder, and `initUser` hook.
- * @returns A function that, given runtime params and a `buildTests` callback, wires the authorized-user fixture into the active test context.
+ * @returns Function that, given runtime params and a `buildTests` callback, wires the authorized-user fixture into the active test context.
  */ function authorizedUserContextFactory(config) {
     var uidGetter = config.uid, _config_makeInstance = config.makeInstance, makeInstance = _config_makeInstance === void 0 ? function(uid, testInstance) {
         return new AuthorizedUserTestContextInstance(uid, testInstance);
@@ -1146,7 +1146,7 @@ function _ts_generator$9(thisArg, body) {
  * build the test context instance, optionally initialize the document, and clean up after each test.
  *
  * @param config - Factory configuration that resolves the collection, optionally produces document refs, builds fixtures/instances, and tears down state.
- * @returns A function that, given runtime params and a `buildTests` callback, registers the model fixture hooks against the active test context.
+ * @returns Function that, given runtime params and a `buildTests` callback, registers the model fixture hooks against the active test context.
  *
  * @see {@link ModelTestContextFactoryParams} for configuration options
  */ function modelTestContextFactory(config) {
@@ -1308,7 +1308,7 @@ var adminEnvironmentInitialized = false;
  * so that each component can also
  *
  * @returns The test project ID that was re-applied to `FIREBASE_CONFIG`/`GCLOUD_PROJECT`.
- * @throws Error when no test project ID is present in the environment (i.e., {@link initFirebaseAdminTestEnvironment} has not been called).
+ * @throws {Error} When no test project ID is present in the environment (i.e., {@link initFirebaseAdminTestEnvironment} has not been called).
  */ function applyFirebaseGCloudTestProjectIdToFirebaseConfigEnv() {
     var _process_env_FIREBASE_CONFIG;
     // firebase-functions-test overwrites this each time.
@@ -2680,24 +2680,16 @@ function _ts_generator$5(thisArg, body) {
             return _async_to_generator$5(function() {
                 var _ref, request;
                 return _ts_generator$5(this, function(_state) {
-                    switch(_state.label){
-                        case 0:
-                            request = _object_spread_props$2(_object_spread$3({}, context), {
-                                data: data,
-                                // NOTE: These will typically not be used/available as they are express.js properties that are not available or useful to the handlers
-                                rawRequest: (_ref = context === null || context === void 0 ? void 0 : context.rawRequest) !== null && _ref !== void 0 ? _ref : {},
-                                acceptsStreaming: false
-                            });
-                            return [
-                                4,
-                                wrappedCloudFunction(request)
-                            ];
-                        case 1:
-                            return [
-                                2,
-                                _state.sent()
-                            ];
-                    }
+                    request = _object_spread_props$2(_object_spread$3({}, context), {
+                        data: data,
+                        // NOTE: These will typically not be used/available as they are express.js properties that are not available or useful to the handlers
+                        rawRequest: (_ref = context === null || context === void 0 ? void 0 : context.rawRequest) !== null && _ref !== void 0 ? _ref : {},
+                        acceptsStreaming: false
+                    });
+                    return [
+                        2,
+                        wrappedCloudFunction(request)
+                    ];
                 });
             })();
         };
@@ -2721,28 +2713,6 @@ function _ts_generator$5(thisArg, body) {
     };
     return wrapper;
 }
-/**
- * Creates a lazy getter that wraps a gen 1 cloud function for testing each time it is called.
- *
- * The returned getter re-wraps on every invocation, so it always reflects the latest function
- * reference from the provided getter — useful when the function under test is re-created between tests.
- *
- * @param wrapper - The cloud function wrapper providing gen 1 wrap support.
- * @param getter - Lazy accessor for the gen 1 cloud function under test; re-evaluated on every getter call.
- * @returns A getter that, when invoked, returns a freshly wrapped gen 1 cloud function ready for invocation in tests.
- *
- * @example
- * ```ts
- * const getWrapped = wrapCloudFunctionV1ForTests(wrapper, () => myV1Function);
- * const result = await getWrapped()({ /* event data *\/ });
- * ```
- *
- * @deprecated Prefer gen 2 functions and {@link wrapCloudFunctionV2ForTests} or {@link wrapCloudFunctionTests}.
- */ function wrapCloudFunctionV1ForTests(wrapper, getter) {
-    return function() {
-        return wrapper.wrapV1CloudFunction(getter());
-    };
-}
 /**
  * Creates a lazy getter that wraps a {@link CallableHttpFunction} for testing each time it is called.
  *
@@ -2763,6 +2733,28 @@ function _ts_generator$5(thisArg, body) {
         return wrapper.wrapCallableRequest(getter());
     };
 }
+/**
+ * Creates a lazy getter that wraps a gen 1 cloud function for testing each time it is called.
+ *
+ * The returned getter re-wraps on every invocation, so it always reflects the latest function
+ * reference from the provided getter — useful when the function under test is re-created between tests.
+ *
+ * @param wrapper - The cloud function wrapper providing gen 1 wrap support.
+ * @param getter - Lazy accessor for the gen 1 cloud function under test; re-evaluated on every getter call.
+ * @returns A getter that, when invoked, returns a freshly wrapped gen 1 cloud function ready for invocation in tests.
+ *
+ * @deprecated Prefer gen 2 functions and {@link wrapCloudFunctionV2ForTests} or {@link wrapCloudFunctionTests}.
+ *
+ * @example
+ * ```ts
+ * const getWrapped = wrapCloudFunctionV1ForTests(wrapper, () => myV1Function);
+ * const result = await getWrapped()({ /* event data *\/ });
+ * ```
+ */ function wrapCloudFunctionV1ForTests(wrapper, getter) {
+    return function() {
+        return wrapper.wrapV1CloudFunction(getter());
+    };
+}
 
 function _assert_this_initialized$4(self) {
     if (self === void 0) {
@@ -3033,7 +3025,7 @@ var functionsInitialized = false;
  * @param reroll - When `true`, generates a new project ID instead of reusing the current one.
  * @returns The initialized {@link FeaturesList} singleton.
  *
- * @throws Error if `initFirebaseAdminTestEnvironment()` has not been called.
+ * @throws {Error} If `initFirebaseAdminTestEnvironment()` has not been called.
  *
  * @example
  * ```ts
@@ -4907,18 +4899,17 @@ function _ts_generator$1(thisArg, body) {
  * @returns The space-separated scope string to pass to the `/oidc/auth` endpoint.
  */ function resolveScopes(nestApp, config) {
     return _async_to_generator$1(function() {
-        var accountService;
+        var result, accountService;
         return _ts_generator$1(this, function(_state) {
             if (config === null || config === void 0 ? void 0 : config.scopes) {
-                return [
-                    2,
-                    config.scopes
-                ];
+                result = config.scopes;
+            } else {
+                accountService = nestApp.get(OidcAccountService);
+                result = Object.keys(accountService.providerConfig.claims).join(' ');
             }
-            accountService = nestApp.get(OidcAccountService);
             return [
                 2,
-                Object.keys(accountService.providerConfig.claims).join(' ')
+                result
             ];
         });
     })();
@@ -4935,7 +4926,7 @@ function _ts_generator$1(thisArg, body) {
  * @param input.uid - Firebase user ID for whom the test ID token is minted and the OAuth flow is authorized.
  * @param input.config - Optional flow overrides (scopes, redirect URI, client name, token endpoint auth method).
  * @returns The exchanged access token and ID token from the OIDC `/token` endpoint.
- * @throws Error when the token exchange step fails (the response body and status are included in the message).
+ * @throws {Error} When the token exchange step fails (the response body and status are included in the message).
  */ function performFullOAuthFlow(input) {
     return _async_to_generator$1(function() {
         var _ref, _ref1, _ref2, server, oidcClientService, nestApp, uid, config, _createCookieJar, collectCookies, cookieHeader, redirectUri, clientName, tokenEndpointAuthMethod, scopes, _ref3, client_id, client_secret, codeVerifier, codeChallenge, authRes, loginUid, idToken, loginRes, resumeAfterLoginPath, consentRedirectRes, consentUid, consentRes, resumeAfterConsentPath, callbackRedirectRes, callbackUrl, authorizationCode, tokenRes;
@@ -5470,7 +5461,7 @@ function _ts_generator(thisArg, body) {
  * and provides an authenticated supertest agent and helper methods.
  *
  * @param config - Optional flow overrides (scopes, redirect URI, client name, timeout) and custom fixture/instance constructors.
- * @returns A function that, given parent fixtures and a `buildTests` callback, registers a `describe('(oauth)', ...)` block which performs the full OAuth flow and exposes the authenticated supertest fixture.
+ * @returns Function that, given parent fixtures and a `buildTests` callback, registers a `describe('(oauth)', ...)` block which performs the full OAuth flow and exposes the authenticated supertest fixture.
  *
  * @example
  * ```typescript

package/test/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@dereekb/firebase-server/test",
-  "version": "13.11.14",
+  "version": "13.11.16",
   "peerDependencies": {
-    "@dereekb/analytics": "13.11.14",
-    "@dereekb/date": "13.11.14",
-    "@dereekb/firebase": "13.11.14",
-    "@dereekb/firebase-server": "13.11.14",
-    "@dereekb/firebase-server/oidc": "13.11.14",
-    "@dereekb/model": "13.11.14",
-    "@dereekb/nestjs": "13.11.14",
-    "@dereekb/rxjs": "13.11.14",
-    "@dereekb/util": "13.11.14",
+    "@dereekb/analytics": "13.11.16",
+    "@dereekb/date": "13.11.16",
+    "@dereekb/firebase": "13.11.16",
+    "@dereekb/firebase-server": "13.11.16",
+    "@dereekb/firebase-server/oidc": "13.11.16",
+    "@dereekb/model": "13.11.16",
+    "@dereekb/nestjs": "13.11.16",
+    "@dereekb/rxjs": "13.11.16",
+    "@dereekb/util": "13.11.16",
     "@google-cloud/firestore": "^7.11.6",
     "@google-cloud/storage": "^7.19.0",
     "@nestjs/common": "^11.1.19",
@@ -23,7 +23,7 @@
     "supertest": "^7.2.2"
   },
   "devDependencies": {
-    "@dereekb/nestjs": "13.11.14"
+    "@dereekb/nestjs": "13.11.16"
   },
   "exports": {
     "./package.json": "./package.json",

package/test/src/lib/firebase/firebase.admin.auth.d.ts

@@ -83,13 +83,6 @@ export declare class AuthorizedUserTestContextFixture<PI extends FirebaseAdminTe
     callCloudFunction<F extends WrappedCloudFunctionV1<any>, O = unknown>(fn: F, params: CallCloudFunctionParams<F>, skipJsonConversion?: boolean): Promise<O>;
     callCloudFunction<F extends WrappedFunction<any>, O = unknown>(fn: F, params: CallCloudFunctionParams<F>, skipJsonConversion?: boolean): Promise<O>;
 }
-/**
- * Partial event context for gen 1 event-triggered cloud functions, with the `auth` field omitted
- * since it is injected automatically by the test context.
- *
- * @deprecated Used only with gen 1 event cloud functions via {@link AuthorizedUserTestContextInstance.callEventCloudFunction}.
- */
-export type CallEventFunctionEventContext = Partial<Omit<EventContext, 'auth'>>;
 /**
  * Concrete implementation of {@link AuthorizedUserTestContext} that holds a Firebase user UID
  * and a reference to the parent {@link FirebaseAdminTestContext}.
@@ -119,7 +112,7 @@ export declare class AuthorizedUserTestContextInstance<PI extends FirebaseAdminT
      * @param fn - Wrapped gen 2 callable request to invoke.
      * @param params - Request payload to pass to the callable, simulating the JSON body of an HTTP call.
      * @param skipJsonConversion - When `true`, skip the JSON serialize/parse round-trip applied to `params` (default `false`).
-     * @returns A promise resolving to the callable's return value.
+     * @returns Promise resolving to the callable's return value.
      */
     callWrappedFunction<F extends WrappedCallableRequest<any, any>>(fn: F, params: WrappedCallableRequestParams<F>, skipJsonConversion?: boolean): Promise<WrappedCallableRequestOutput<F>>;
     /**
@@ -146,7 +139,7 @@ export declare class AuthorizedUserTestContextInstance<PI extends FirebaseAdminT
      * @param input.eventType - Discriminator for the auth event being simulated (`google.firebase.auth.user.create` or `google.firebase.auth.user.delete`).
      * @param input.eventOverride - Partial event fields used to override the default placeholder values (e.g., `ipAddress`, `userAgent`, `resource`).
      * @param input.skipJsonConversion - When `true`, skip the JSON serialize/parse round-trip applied to the event payload (default `false`).
-     * @returns A promise that resolves once the blocking function has completed.
+     * @returns Resolves once the blocking function has completed.
      */
     callAuthBlockingFunction(input: {
         fn: WrappedBlockingFunctionWithHandler<AuthBlockingEvent, void>;
@@ -156,13 +149,13 @@ export declare class AuthorizedUserTestContextInstance<PI extends FirebaseAdminT
         skipJsonConversion?: boolean;
     }): Promise<void>;
     /**
-     * @deprecated gen 1
-     *
      * @param fn
      * @param params
      * @param contextOptions
      * @param skipJsonConversion
      * @returns
+     *
+     * @deprecated gen 1
      */
     callEventCloudFunction<F extends WrappedFunction<any>, O = unknown>(fn: F, params: CallCloudFunctionParams<F>, contextOptions?: CallEventFunctionEventContext, skipJsonConversion?: boolean): Promise<O>;
 }
@@ -189,27 +182,27 @@ export interface AuthorizedUserTestContextDetailsTemplate {
  * authorizedUserContext/authorizedUserContextFactory parameters.
  */
 export interface AuthorizedUserTestContextParams<PI extends FirebaseAdminTestContext = FirebaseAdminTestContext, PF extends TestContextFixture<PI> = TestContextFixture<PI>, I extends AuthorizedUserTestContextInstance<PI> = AuthorizedUserTestContextInstance<PI>, F extends AuthorizedUserTestContextFixture<PI, PF, I> = AuthorizedUserTestContextFixture<PI, PF, I>, C extends AuthorizedUserTestContextFactoryParams<PI, PF> = AuthorizedUserTestContextFactoryParams<PI, PF>> {
-    f: PF;
+    readonly f: PF;
     /**
      * uid value/getter to use. If not provided, a random one will be generated.
      */
-    uid?: GetterOrValue<FirebaseAuthUserId>;
+    readonly uid?: GetterOrValue<FirebaseAuthUserId>;
     /**
      * Additional user details to attach to the create request.
      */
-    makeUserDetails?: (uid: FirebaseAuthUserId, params: C) => AuthorizedUserTestContextDetailsTemplate;
+    readonly makeUserDetails?: (uid: FirebaseAuthUserId, params: C) => AuthorizedUserTestContextDetailsTemplate;
     /**
      * Creates the custom fixture. If not defined, a AuthorizedUserTestContextFixture is created.
      */
-    makeFixture?: (parent: PF) => F;
+    readonly makeFixture?: (parent: PF) => F;
     /**
      * Custom make instance function. If not defined, a AuthorizedUserTestContextInstance will be generated.
      */
-    makeInstance?: (uid: FirebaseAuthUserId, testInstance: PI, params: C, userRecord: UserRecord) => PromiseOrValue<I>;
+    readonly makeInstance?: (uid: FirebaseAuthUserId, testInstance: PI, params: C, userRecord: UserRecord) => PromiseOrValue<I>;
     /**
      * Optional function to initialize the user for this instance.
      */
-    initUser?: (instance: I, params: C) => Promise<void>;
+    readonly initUser?: (instance: I, params: C) => Promise<void>;
 }
 /**
  * Convenience function for using authorizedUserContextFactory directly and passing buildTests.
@@ -262,7 +255,7 @@ export declare const AUTHORIZED_USER_RANDOM_PHONE_NUMBER_FACTORY: import("@deree
  * custom claims, and post-create initialization) and tear it down afterward.
  *
  * @param config - Factory configuration: optional uid generator, custom fixture/instance constructors, user-detail builder, and `initUser` hook.
- * @returns A function that, given runtime params and a `buildTests` callback, wires the authorized-user fixture into the active test context.
+ * @returns Function that, given runtime params and a `buildTests` callback, wires the authorized-user fixture into the active test context.
  */
 export declare function authorizedUserContextFactory<PI extends FirebaseAdminTestContext = FirebaseAdminTestContext, PF extends TestContextFixture<PI> = TestContextFixture<PI>, I extends AuthorizedUserTestContextInstance<PI> = AuthorizedUserTestContextInstance<PI>, F extends AuthorizedUserTestContextFixture<PI, PF, I> = AuthorizedUserTestContextFixture<PI, PF, I>, C extends AuthorizedUserTestContextFactoryParams<PI, PF> = AuthorizedUserTestContextFactoryParams<PI, PF>>(config: AuthorizedUserTestContextFactoryConfig<PI, PF, I, F>): (params: C, buildTests: (u: F) => void) => void;
 /**
@@ -346,3 +339,10 @@ export declare function decodeEncodedCreateCustomTokenResult(token: TestEncodedF
  * @see {@link createEncodedTestFirestoreTokenForUserRecord}
  */
 export declare function testFirestoreClaimsFromUserRecord(userRecord: UserRecord): object;
+/**
+ * Partial event context for gen 1 event-triggered cloud functions, with the `auth` field omitted
+ * since it is injected automatically by the test context.
+ *
+ * @deprecated Used only with gen 1 event cloud functions via {@link AuthorizedUserTestContextInstance.callEventCloudFunction}.
+ */
+export type CallEventFunctionEventContext = Partial<Omit<EventContext, 'auth'>>;

package/test/src/lib/firebase/firebase.admin.collection.d.ts

@@ -70,31 +70,31 @@ export interface ModelTestContextFactoryParams<T, D extends FirestoreDocument<T>
     /**
      * Creates a ModelTestContextInstanceDelegate from the parent instance.
      */
-    getCollection: (parentInstance: PI, config: C) => CL;
+    readonly getCollection: (parentInstance: PI, config: C) => CL;
     /**
      * Creates the custom fixture. If not defined, a ModelTestContextFixture is created.
      */
-    makeFixture?: (parent: PF) => F;
+    readonly makeFixture?: (parent: PF) => F;
     /**
      * Optional function to create a DocumentReference.
      *
      * If not provided, expects the input CL type to be a full FirestoreCollection, instead of a FirestoreCollectionLike.
      */
-    makeRef?: (collection: CL, config: C, parentInstance: PI) => Promise<DocumentReference<T>>;
+    readonly makeRef?: (collection: CL, config: C, parentInstance: PI) => Promise<DocumentReference<T>>;
     /**
      * Custom make instance function. If not defined, a ModelTestContextInstance will be generated.
      */
-    makeInstance?: (collection: CL, ref: DocumentReference<T>, testInstance: PI) => PromiseOrValue<I>;
+    readonly makeInstance?: (collection: CL, ref: DocumentReference<T>, testInstance: PI) => PromiseOrValue<I>;
     /**
      * Optional function to initialize the document for this instance.
      */
-    initDocument?: (instance: I, config: C) => Promise<void>;
+    readonly initDocument?: (instance: I, config: C) => Promise<void>;
     /**
      * Optional function to retrieve a collection given the input document.
      *
      * Required if using ModelTestContextDocumentRefParam as input.
      */
-    collectionForDocument?: (parentInstance: PI, document: D) => CL;
+    readonly collectionForDocument?: (parentInstance: PI, document: D) => CL;
     /**
      * Optional teardown function to cleanup after this object.
      */
@@ -133,7 +133,7 @@ export type ModelTestContextParams<C = any, PI extends FirebaseAdminTestContext
  * build the test context instance, optionally initialize the document, and clean up after each test.
  *
  * @param config - Factory configuration that resolves the collection, optionally produces document refs, builds fixtures/instances, and tears down state.
- * @returns A function that, given runtime params and a `buildTests` callback, registers the model fixture hooks against the active test context.
+ * @returns Function that, given runtime params and a `buildTests` callback, registers the model fixture hooks against the active test context.
  *
  * @see {@link ModelTestContextFactoryParams} for configuration options
  */

package/test/src/lib/firebase/firebase.admin.d.ts

@@ -1,6 +1,6 @@
 import admin from 'firebase-admin';
 import { type Firestore } from '@google-cloud/firestore';
-import { type JestTestFirestoreContextFactory, type TestFirestoreContext, TestFirestoreContextFixture, type TestFirestoreInstance, type TestFirebaseStorageContext, type TestFirebaseStorageInstance } from '@dereekb/firebase/test';
+import { type TestFirestoreContextFactory, type TestFirestoreContext, TestFirestoreContextFixture, type TestFirestoreInstance, type TestFirebaseStorageContext, type TestFirebaseStorageInstance } from '@dereekb/firebase/test';
 import { AbstractTestContextFixture, type BuildTestsWithContextFunction, type TestContextFactory, type TestContextFixture } from '@dereekb/util/test';
 import { GoogleCloudTestFirestoreInstance } from '../firestore/firestore';
 import { type FirebaseAdminCloudFunctionWrapper, type FirebaseAdminCloudFunctionWrapperSource } from './firebase.function';
@@ -126,7 +126,7 @@ export declare const firebaseAdminTestContextFactory: FirebaseAdminTestContextFa
  * @param factory
  * @returns
  */
-export declare function firebaseAdminFirestoreContextFixture(factory: TestContextFactory<TestContextFixture<FirebaseAdminTestContextInstance>>): JestTestFirestoreContextFactory;
+export declare function firebaseAdminFirestoreContextFixture(factory: TestContextFactory<TestContextFixture<FirebaseAdminTestContextInstance>>): TestFirestoreContextFactory;
 /**
  * Sets up a {@link TestFirestoreContextFixture} as a child context within an existing
  * {@link FirebaseAdminTestContextInstance} fixture.

package/test/src/lib/firebase/firebase.admin.function.d.ts

@@ -15,7 +15,7 @@ import { type Storage as GoogleCloudStorage } from '@google-cloud/storage';
  * @param reroll - When `true`, generates a new project ID instead of reusing the current one.
  * @returns The initialized {@link FeaturesList} singleton.
  *
- * @throws Error if `initFirebaseAdminTestEnvironment()` has not been called.
+ * @throws {Error} If `initFirebaseAdminTestEnvironment()` has not been called.
  *
  * @example
  * ```ts
@@ -38,7 +38,7 @@ export interface FirebaseAdminFunctionTestConfig {
      *
      * @deprecated Is false by default to allow a new app to be defined each time. Usage of the singleton does not make sense. Remove later, and require that tests be run in serial if testing framework isn't behaving.
      */
-    useFunctionSingletonContext: boolean;
+    readonly useFunctionSingletonContext: boolean;
 }
 /**
  * Test context type for Firebase Admin function tests.

package/test/src/lib/firebase/firebase.admin.nest.function.callable.context.d.ts

@@ -43,7 +43,7 @@ export interface CallableRequestTestMultipleConfig<I, T extends CallableRequestT
     /**
      * Map of named callable function factories to wrap for testing.
      */
-    fns: T;
+    readonly fns: T;
 }
 /**
  * Suffix appended to each key in a {@link CallableRequestTestConfigMapObject} when building

package/test/src/lib/firebase/firebase.admin.nest.function.cloud.context.d.ts

@@ -14,7 +14,7 @@ export interface CloudFunctionTestBaseConfig {
     /**
      * The test context fixture providing NestJS module and function wrapping access.
      */
-    f: FirebaseAdminFunctionNestTestContext;
+    readonly f: FirebaseAdminFunctionNestTestContext;
 }
 /**
  * Configuration for testing a single cloud function (v1 schedule, blocking, or cloud event).
@@ -24,7 +24,7 @@ export interface CloudFunctionTestSingleConfig<I extends object> extends CloudFu
     /**
      * The cloud function factory to wrap for testing.
      */
-    fn: WrapCloudFunctionForNestTestsInput<I>;
+    readonly fn: WrapCloudFunctionForNestTestsInput<I>;
 }
 /**
  * Test callback for a single cloud function. Receives the wrapped function and should
@@ -46,7 +46,7 @@ export interface CloudFunctionTestMultipleConfig<I extends object, T extends Clo
     /**
      * Map of named cloud function factories to wrap for testing.
      */
-    fns: T;
+    readonly fns: T;
 }
 /**
  * Mapped type that transforms a {@link CloudFunctionTestConfigMapObject} into an object

package/test/src/lib/firebase/firebase.d.ts

@@ -1,3 +1,4 @@
+import type { Maybe } from '@dereekb/util';
 /**
  * A `host:port` string used to connect to a Firebase emulator.
  *
@@ -20,9 +21,9 @@ export type FirebaseAdminTestEnvironmentHost = string;
  * accidental connections to production services.
  */
 export interface FirebaseAdminTestEnvironmentEmulatorsConfig {
-    auth: FirebaseAdminTestEnvironmentHost | null;
-    storage: FirebaseAdminTestEnvironmentHost | null;
-    firestore: FirebaseAdminTestEnvironmentHost | null;
+    readonly auth: Maybe<FirebaseAdminTestEnvironmentHost>;
+    readonly storage: Maybe<FirebaseAdminTestEnvironmentHost>;
+    readonly firestore: Maybe<FirebaseAdminTestEnvironmentHost>;
 }
 /**
  * Top-level configuration for initializing the Firebase Admin test environment.
@@ -30,7 +31,7 @@ export interface FirebaseAdminTestEnvironmentEmulatorsConfig {
  * Passed to {@link initFirebaseAdminTestEnvironment} to configure which emulators the test suite connects to.
  */
 export interface FirebaseAdminTestEnvironmentConfig {
-    emulators: FirebaseAdminTestEnvironmentEmulatorsConfig;
+    readonly emulators: FirebaseAdminTestEnvironmentEmulatorsConfig;
 }
 /**
  * Returns whether {@link initFirebaseAdminTestEnvironment} has already been called.
@@ -91,7 +92,7 @@ export declare function getGCloudTestProjectId(): string | undefined;
  * so that each component can also
  *
  * @returns The test project ID that was re-applied to `FIREBASE_CONFIG`/`GCLOUD_PROJECT`.
- * @throws Error when no test project ID is present in the environment (i.e., {@link initFirebaseAdminTestEnvironment} has not been called).
+ * @throws {Error} When no test project ID is present in the environment (i.e., {@link initFirebaseAdminTestEnvironment} has not been called).
  */
 export declare function applyFirebaseGCloudTestProjectIdToFirebaseConfigEnv(): string;
 /**

package/test/src/lib/firebase/firebase.function.d.ts

@@ -20,18 +20,6 @@ export type CloudFunctionV1TypeFix<T> = Omit<CloudFunctionV1Input<T>, '__trigger
  * with the union-compatibility fix applied.
  */
 export type CloudFunctionV1<T> = CloudFunctionV1TypeFix<T>;
-/**
- * @deprecated deprecated gen 1 firebase function type
- */
-export type WrappedCloudFunctionV1<T> = WrappedScheduledFunction | WrappedFunction<T>;
-/**
- * @deprecated deprecated gen 1 firebase function type
- */
-export type WrapCloudFunctionV1 = <T>(cloudFunction: CloudFunctionV1<T>) => WrappedCloudFunctionV1<T>;
-/**
- * @deprecated deprecated gen 1 firebase function type
- */
-export type WrapCloudFunctionV1Input<T> = CloudFunctionV1<T>;
 /**
  * Wrapped callable function that only takes in data and options that are used to simulate a Firebase request, then returns the result.
  */
@@ -178,25 +166,6 @@ export interface FirebaseAdminCloudFunctionWrapper {
  * ```
  */
 export declare function firebaseAdminCloudFunctionWrapper(instance: FeaturesList): FirebaseAdminCloudFunctionWrapper;
-/**
- * Creates a lazy getter that wraps a gen 1 cloud function for testing each time it is called.
- *
- * The returned getter re-wraps on every invocation, so it always reflects the latest function
- * reference from the provided getter — useful when the function under test is re-created between tests.
- *
- * @param wrapper - The cloud function wrapper providing gen 1 wrap support.
- * @param getter - Lazy accessor for the gen 1 cloud function under test; re-evaluated on every getter call.
- * @returns A getter that, when invoked, returns a freshly wrapped gen 1 cloud function ready for invocation in tests.
- *
- * @example
- * ```ts
- * const getWrapped = wrapCloudFunctionV1ForTests(wrapper, () => myV1Function);
- * const result = await getWrapped()({ /* event data *\/ });
- * ```
- *
- * @deprecated Prefer gen 2 functions and {@link wrapCloudFunctionV2ForTests} or {@link wrapCloudFunctionTests}.
- */
-export declare function wrapCloudFunctionV1ForTests<I, T extends WrapCloudFunctionV1Input<I> = WrapCloudFunctionV1Input<I>>(wrapper: FirebaseAdminCloudFunctionWrapper, getter: Getter<T>): Getter<WrappedCloudFunctionV1<I>>;
 /**
  * Creates a lazy getter that wraps a gen 2 cloud function for testing each time it is called.
  *
@@ -249,6 +218,37 @@ export declare function wrapCloudFunctionTests<I extends object>(wrapper: Fireba
  * ```
  */
 export declare function wrapCallableRequestForTests<I, O = unknown, T extends WrapCallableRequestInput<I, O> = WrapCallableRequestInput<I, O>>(wrapper: FirebaseAdminCloudFunctionWrapper, getter: Getter<T>): Getter<WrappedCallableRequest<I, O>>;
+/**
+ * @deprecated deprecated gen 1 firebase function type
+ */
+export type WrappedCloudFunctionV1<T> = WrappedScheduledFunction | WrappedFunction<T>;
+/**
+ * @deprecated deprecated gen 1 firebase function type
+ */
+export type WrapCloudFunctionV1 = <T>(cloudFunction: CloudFunctionV1<T>) => WrappedCloudFunctionV1<T>;
+/**
+ * @deprecated deprecated gen 1 firebase function type
+ */
+export type WrapCloudFunctionV1Input<T> = CloudFunctionV1<T>;
+/**
+ * Creates a lazy getter that wraps a gen 1 cloud function for testing each time it is called.
+ *
+ * The returned getter re-wraps on every invocation, so it always reflects the latest function
+ * reference from the provided getter — useful when the function under test is re-created between tests.
+ *
+ * @param wrapper - The cloud function wrapper providing gen 1 wrap support.
+ * @param getter - Lazy accessor for the gen 1 cloud function under test; re-evaluated on every getter call.
+ * @returns A getter that, when invoked, returns a freshly wrapped gen 1 cloud function ready for invocation in tests.
+ *
+ * @deprecated Prefer gen 2 functions and {@link wrapCloudFunctionV2ForTests} or {@link wrapCloudFunctionTests}.
+ *
+ * @example
+ * ```ts
+ * const getWrapped = wrapCloudFunctionV1ForTests(wrapper, () => myV1Function);
+ * const result = await getWrapped()({ /* event data *\/ });
+ * ```
+ */
+export declare function wrapCloudFunctionV1ForTests<I, T extends WrapCloudFunctionV1Input<I> = WrapCloudFunctionV1Input<I>>(wrapper: FirebaseAdminCloudFunctionWrapper, getter: Getter<T>): Getter<WrappedCloudFunctionV1<I>>;
 /**
  * @deprecated use WrappedCallableRequest instead.
  */

package/test/src/lib/firestore/firestore.d.ts

@@ -4,8 +4,8 @@ import { type TestFirestoreContext, TestFirestoreInstance, TestFirestoreContextF
  * Configuration for connecting to a Google Cloud Firestore emulator in tests.
  */
 export interface GoogleCloudTestFirestoreConfig {
-    host: string;
-    port: number;
+    readonly host: string;
+    readonly port: number;
 }
 /**
  * A {@link TestFirestoreContext} backed by `@google-cloud/firestore`.

package/test/src/lib/oidc/oidc.test.fixture.d.ts

@@ -121,7 +121,7 @@ export declare class OAuthAuthorizedSuperTestFixture extends AbstractTestContext
  * and provides an authenticated supertest agent and helper methods.
  *
  * @param config - Optional flow overrides (scopes, redirect URI, client name, timeout) and custom fixture/instance constructors.
- * @returns A function that, given parent fixtures and a `buildTests` callback, registers a `describe('(oauth)', ...)` block which performs the full OAuth flow and exposes the authenticated supertest fixture.
+ * @returns Function that, given parent fixtures and a `buildTests` callback, registers a `describe('(oauth)', ...)` block which performs the full OAuth flow and exposes the authenticated supertest fixture.
  *
  * @example
  * ```typescript

package/test/src/lib/oidc/oidc.test.flow.d.ts

@@ -50,7 +50,7 @@ export interface PerformFullOAuthFlowInput {
  * @param input.uid - Firebase user ID for whom the test ID token is minted and the OAuth flow is authorized.
  * @param input.config - Optional flow overrides (scopes, redirect URI, client name, token endpoint auth method).
  * @returns The exchanged access token and ID token from the OIDC `/token` endpoint.
- * @throws Error when the token exchange step fails (the response body and status are included in the message).
+ * @throws {Error} When the token exchange step fails (the response body and status are included in the message).
  */
 export declare function performFullOAuthFlow(input: PerformFullOAuthFlowInput): Promise<PerformFullOAuthFlowResult>;
 /**

package/test/src/lib/storage/storage.d.ts

@@ -4,8 +4,8 @@ import { type FirebaseStorage } from '@dereekb/firebase';
  * Configuration for connecting to a Google Cloud Storage emulator in tests.
  */
 export interface GoogleCloudTestFirebaseStorageConfig {
-    host: string;
-    port: number;
+    readonly host: string;
+    readonly port: number;
 }
 /**
  * A {@link TestFirebaseStorageContext} backed by `@google-cloud/storage`.