@dereekb/firebase-server 3.0.0

package/src/test/firebase/firebase.admin.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firebaseAdminFirestoreContextWithFixture = exports.firebaseAdminFirestoreContextFixture = exports.firebaseAdminTestContextFactory = exports.firebaseAdminTestBuilder = exports.AbstractFirebaseAdminTestContextInstanceChild = exports.FirebaseAdminTestContextInstance = exports.FirebaseAdminTestContextFixture = exports.wrapCloudFunctionForTests = void 0;
+const tslib_1 = require("tslib");
+const admin = require("firebase-admin");
+const firebase_1 = require("@dereekb/firebase");
+const util_1 = require("@dereekb/util");
+const driver_1 = require("../../lib/firestore/driver");
+const firestore_1 = require("../firestore/firestore");
+const firebase_2 = require("./firebase");
+function wrapCloudFunctionForTests(wrapper, getter) {
+    return () => wrapper.wrapCloudFunction(getter());
+}
+exports.wrapCloudFunctionForTests = wrapCloudFunctionForTests;
+class FirebaseAdminTestContextFixture extends util_1.AbstractJestTestContextFixture {
+    // MARK: FirebaseAdminTestContext (Forwarded)
+    get app() {
+        return this.instance.app;
+    }
+    get auth() {
+        return this.instance.auth;
+    }
+    get firestore() {
+        return this.instance.firestore;
+    }
+    get firestoreInstance() {
+        return this.instance.firestoreInstance;
+    }
+    get firestoreContext() {
+        return this.instance.firestoreContext;
+    }
+    get wrapCloudFunction() {
+        return this.instance.wrapCloudFunction;
+    }
+}
+exports.FirebaseAdminTestContextFixture = FirebaseAdminTestContextFixture;
+// MARK: FirebaseAdminTestBuilder
+class FirebaseAdminTestContextInstance {
+    constructor(app) {
+        this.app = app;
+        this.getTestFirestoreInstance = (0, util_1.cachedGetter)(() => {
+            const drivers = (0, firebase_1.makeTestingFirestoreDrivers)((0, driver_1.googleCloudFirestoreDrivers)());
+            return new firestore_1.GoogleCloudTestFirestoreInstance(drivers, this.firestore);
+        });
+    }
+    get auth() {
+        return this.app.auth();
+    }
+    get firestore() {
+        return this.app.firestore();
+    }
+    get firestoreInstance() {
+        return this.getTestFirestoreInstance();
+    }
+    get firestoreContext() {
+        return this.firestoreInstance.context;
+    }
+    get wrapCloudFunction() {
+        return () => {
+            throw new Error('wrapCloudFunction is unsupported by this type.');
+        };
+    }
+}
+exports.FirebaseAdminTestContextInstance = FirebaseAdminTestContextInstance;
+class AbstractFirebaseAdminTestContextInstanceChild {
+    constructor(parent) {
+        this.parent = parent;
+    }
+    // MARK: FirebaseAdminTestContext (Forwarded)
+    get app() {
+        return this.parent.app;
+    }
+    get auth() {
+        return this.parent.auth;
+    }
+    get firestore() {
+        return this.parent.firestore;
+    }
+    get firestoreInstance() {
+        return this.parent.firestoreInstance;
+    }
+    get firestoreContext() {
+        return this.parent.firestoreContext;
+    }
+    get wrapCloudFunction() {
+        return this.parent.wrapCloudFunction;
+    }
+}
+exports.AbstractFirebaseAdminTestContextInstanceChild = AbstractFirebaseAdminTestContextInstanceChild;
+/**
+ * A JestTestContextBuilderFunction for building firebase test context factories using firebase-admin.
+ *
+ * This can be used to easily build a testing context that sets up RulesTestEnvironment for tests that sets itself up and tears itself down.
+ */
+exports.firebaseAdminTestBuilder = (0, util_1.jestTestContextBuilder)({
+    buildConfig: (input) => {
+        const config = Object.assign({}, input);
+        return config;
+    },
+    buildFixture: () => new FirebaseAdminTestContextFixture(),
+    setupInstance: (config) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+        if (!(0, firebase_2.isAdminEnvironmentInitialized)()) {
+            throw new Error('Call initFirebaseAdminTestEnvironment() from @dereekb/firebase-server was not called before using adminFirebaseTestBuilder().');
+        }
+        const projectId = (0, firebase_2.generateNewProjectId)();
+        const app = admin.initializeApp({ projectId });
+        return new FirebaseAdminTestContextInstance(app);
+    }),
+    teardownInstance: (instance, config) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+        yield instance.app.delete(); // clean up the instance
+    })
+});
+exports.firebaseAdminTestContextFactory = (0, exports.firebaseAdminTestBuilder)({});
+// MARK: Firestore Context
+/**
+ * Convenience function to build a JestTestFirestoreContextFactory from a FirebaseAdminTestContextFactory.
+ *
+ * This is useful for composing child tests that will benefit from the firestore testing context, but want the full app available.
+ *
+ * @param factory
+ * @returns
+ */
+function firebaseAdminFirestoreContextFixture(factory) {
+    return (buildTests) => {
+        factory((f) => firebaseAdminFirestoreContextWithFixture(f, buildTests));
+    };
+}
+exports.firebaseAdminFirestoreContextFixture = firebaseAdminFirestoreContextFixture;
+function firebaseAdminFirestoreContextWithFixture(f, buildTests) {
+    (0, util_1.useJestContextFixture)({
+        fixture: new firebase_1.TestFirestoreContextFixture(),
+        /**
+         * Build tests by passing the fixture to the testing functions.
+         *
+         * This will inject all tests and sub Jest lifecycle items.
+         */
+        buildTests,
+        initInstance: () => f.instance.getTestFirestoreInstance()
+    });
+}
+exports.firebaseAdminFirestoreContextWithFixture = firebaseAdminFirestoreContextWithFixture;
+//# sourceMappingURL=firebase.admin.js.map

package/src/test/firebase/firebase.admin.js.map

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

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

@@ -0,0 +1,62 @@
+import { AbstractChildJestTestContextFixture, ArrayOrValue, ClassType, Getter, JestBuildTestsWithContextFunction, JestTestContextFactory, JestTestContextFixture } from "@dereekb/util";
+import { AbstractFirebaseAdminTestContextInstanceChild, FirebaseAdminTestContextInstance } from './firebase.admin';
+import { Abstract, INestApplicationContext, Provider, Type } from '@nestjs/common/interfaces';
+import { NestAppPromiseGetter } from "../../lib/nest/app";
+import { TestingModule } from '@nestjs/testing';
+export interface FirebaseAdminNestTestContext {
+    readonly nest: TestingModule;
+    readonly nestAppPromiseGetter: NestAppPromiseGetter;
+    get<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Abstract<TInput> | string | symbol, options?: {
+        strict: boolean;
+    }): TResult;
+}
+export declare type FirebaseAdminNestTestContextFixtureType<PI extends FirebaseAdminTestContextInstance> = FirebaseAdminNestTestContext & JestTestContextFixture<PI>;
+export declare class FirebaseAdminNestTestContextFixture<PI extends FirebaseAdminTestContextInstance = FirebaseAdminTestContextInstance, PF extends JestTestContextFixture<PI> = JestTestContextFixture<PI>, I extends FirebaseAdminNestTestContextInstance<PI> = FirebaseAdminNestTestContextInstance<PI>> extends AbstractChildJestTestContextFixture<I, PF> implements FirebaseAdminNestTestContext {
+    get nest(): TestingModule;
+    get nestAppPromiseGetter(): Getter<Promise<INestApplicationContext>>;
+    get<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Abstract<TInput> | string | symbol, options?: {
+        strict: boolean;
+    }): TResult;
+}
+export declare class FirebaseAdminNestTestContextInstance<PI extends FirebaseAdminTestContextInstance = FirebaseAdminTestContextInstance> extends AbstractFirebaseAdminTestContextInstanceChild<PI> implements FirebaseAdminNestTestContext {
+    readonly nest: TestingModule;
+    readonly nestAppPromiseGetter: Getter<Promise<INestApplicationContext>>;
+    constructor(parent: PI, nest: TestingModule);
+    get<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Abstract<TInput> | string | symbol, options?: {
+        strict: boolean;
+    }): TResult;
+}
+export interface FirebaseAdminNestTestConfig<PI extends FirebaseAdminTestContextInstance = FirebaseAdminTestContextInstance, PF extends JestTestContextFixture<PI> = JestTestContextFixture<PI>, I extends FirebaseAdminNestTestContextInstance<PI> = FirebaseAdminNestTestContextInstance<PI>, C extends FirebaseAdminNestTestContextFixture<PI, PF, I> = FirebaseAdminNestTestContextFixture<PI, PF, I>> {
+    /**
+     * Creates a new fixture.
+     */
+    makeFixture?: (f: PF) => C;
+    /**
+     * Root module to import.
+     */
+    nestModules: ArrayOrValue<ClassType>;
+    /**
+     * Whether or not to inject the firebase server provider (firebaseServerAppTokenProvider()).
+     *
+     * This makes FIREBASE_APP_TOKEN available globally and provides the app configured for this test.
+     */
+    injectFirebaseServerAppTokenProvider?: boolean;
+    /**
+     * Optional providers to pass to the TestingModule initialization.
+     */
+    makeProviders?: (instance: PI) => Provider<any>[];
+    /**
+     * Creates a new instance.
+     */
+    makeInstance?: (instance: PI, nest: TestingModule) => I;
+    /**
+     * Optional function to initialize the instance.
+     */
+    initInstance?: (instance: I) => Promise<void>;
+}
+export declare type FirebaseAdminNestTestContextFactory<PI extends FirebaseAdminTestContextInstance = FirebaseAdminTestContextInstance, PF extends JestTestContextFixture<PI> = JestTestContextFixture<PI>, I extends FirebaseAdminNestTestContextInstance<PI> = FirebaseAdminNestTestContextInstance<PI>, C extends FirebaseAdminNestTestContextFixture<PI, PF, I> = FirebaseAdminNestTestContextFixture<PI, PF, I>> = JestTestContextFactory<C>;
+export declare function firebaseAdminNestContextFixture<PI extends FirebaseAdminTestContextInstance = FirebaseAdminTestContextInstance, PF extends JestTestContextFixture<PI> = JestTestContextFixture<PI>, I extends FirebaseAdminNestTestContextInstance<PI> = FirebaseAdminNestTestContextInstance<PI>, C extends FirebaseAdminNestTestContextFixture<PI, PF, I> = FirebaseAdminNestTestContextFixture<PI, PF, I>>(config: FirebaseAdminNestTestConfig<PI, PF, I, C>, factory: JestTestContextFactory<PF>): FirebaseAdminNestTestContextFactory<PI, PF, I, C>;
+export declare class FirebaseAdminNestRootModule {
+}
+export declare function firebaseAdminNestContextWithFixture<PI extends FirebaseAdminTestContextInstance = FirebaseAdminTestContextInstance, PF extends JestTestContextFixture<PI> = JestTestContextFixture<PI>, I extends FirebaseAdminNestTestContextInstance<PI> = FirebaseAdminNestTestContextInstance<PI>, C extends FirebaseAdminNestTestContextFixture<PI, PF, I> = FirebaseAdminNestTestContextFixture<PI, PF, I>>(config: FirebaseAdminNestTestConfig<PI, PF, I, C>, f: PF, buildTests: JestBuildTestsWithContextFunction<C>): void;
+export declare function firebaseAdminNestContextFactory<I extends FirebaseAdminNestTestContextInstance<FirebaseAdminTestContextInstance> = FirebaseAdminNestTestContextInstance<FirebaseAdminTestContextInstance>>(config: FirebaseAdminNestTestConfig<FirebaseAdminTestContextInstance, JestTestContextFixture<FirebaseAdminTestContextInstance>, I>): FirebaseAdminNestTestContextFactory<FirebaseAdminTestContextInstance, JestTestContextFixture<FirebaseAdminTestContextInstance>, I>;

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

@@ -0,0 +1,22 @@
+import { NestApplicationRunnableHttpFunctionFactory } from "../../lib/nest/function/nest";
+import { WrappedCloudFunction } from "./firebase.admin";
+import { FirebaseAdminFunctionNestTestContext } from "./firebase.admin.nest.function";
+export interface CloudFunctionTestConfig<I> {
+    f: FirebaseAdminFunctionNestTestContext;
+    fn: NestApplicationRunnableHttpFunctionFactory<I>;
+}
+/**
+ * Used to provide a test builder that exposes a WrappedCloudFunction using the input configuration.
+ *
+ * @param config
+ * @param buildTests
+ */
+export declare function cloudFunctionTest<I>(config: CloudFunctionTestConfig<I>, buildTests: (fn: WrappedCloudFunction<I>) => void): void;
+/**
+ * Convenience function that calls describe and cloudFunctionContext together.
+ *
+ * @param label
+ * @param config
+ * @param buildTests
+ */
+export declare function describeCloudFunctionTest<I>(label: string, config: CloudFunctionTestConfig<I>, buildTests: (fn: WrappedCloudFunction<I>) => void): void;

package/src/test/firebase/firebase.admin.nest.function.context.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeCloudFunctionTest = exports.cloudFunctionTest = void 0;
+const util_1 = require("@dereekb/util");
+const firebase_admin_nest_function_1 = require("./firebase.admin.nest.function");
+/**
+ * Used to provide a test builder that exposes a WrappedCloudFunction using the input configuration.
+ *
+ * @param config
+ * @param buildTests
+ */
+function cloudFunctionTest(config, buildTests) {
+    const { f, fn } = config;
+    (0, util_1.useJestFunctionFixture)({
+        fn: () => {
+            const x = (0, firebase_admin_nest_function_1.wrapCloudFunctionForNestTestsGetter)(f, fn)();
+            return x;
+        }
+    }, buildTests);
+}
+exports.cloudFunctionTest = cloudFunctionTest;
+/**
+ * Convenience function that calls describe and cloudFunctionContext together.
+ *
+ * @param label
+ * @param config
+ * @param buildTests
+ */
+function describeCloudFunctionTest(label, config, buildTests) {
+    describe(label, () => {
+        cloudFunctionTest(config, buildTests);
+    });
+}
+exports.describeCloudFunctionTest = describeCloudFunctionTest;
+//# sourceMappingURL=firebase.admin.nest.function.context.js.map

package/src/test/firebase/firebase.admin.nest.function.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase.admin.nest.function.context.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/test/firebase/firebase.admin.nest.function.context.ts"],"names":[],"mappings":";;;AAAA,wCAAuD;AAGvD,iFAA2H;AAO3H;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAI,MAAkC,EAAE,UAAiD;IACxH,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;IAEzB,IAAA,6BAAsB,EAA0B;QAC9C,EAAE,EAAE,GAAG,EAAE;YACP,MAAM,CAAC,GAAG,IAAA,kEAAmC,EAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,CAAC;QACX,CAAC;KACF,EAAE,UAAU,CAAC,CAAC;AACjB,CAAC;AATD,8CASC;AAED;;;;;;GAMG;AACH,SAAgB,yBAAyB,CAAI,KAAa,EAAE,MAAkC,EAAE,UAAiD;IAC/I,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;QACnB,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAJD,8DAIC"}

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

@@ -0,0 +1,25 @@
+import { Getter, JestBuildTestsWithContextFunction, JestTestContextFactory, JestTestContextFixture } from "@dereekb/util";
+import { FirebaseAdminNestTestConfig, FirebaseAdminNestTestContext, FirebaseAdminNestTestContextFixture, FirebaseAdminNestTestContextInstance } from "./firebase.admin.nest";
+import { FirebaseAdminFunctionTestContextInstance } from "./firebase.admin.function";
+import { FirebaseAdminCloudFunctionWrapper, WrapCloudFunction, WrappedCloudFunction } from './firebase.admin';
+import { NestApplicationRunnableHttpFunctionFactory } from "../../lib/nest/function/nest";
+export declare function wrapCloudFunctionForNestTestsGetter<I>(wrapper: FirebaseAdminFunctionNestTestContext, fn: NestApplicationRunnableHttpFunctionFactory<I>): Getter<WrappedCloudFunction<I>>;
+export interface FirebaseAdminFunctionNestTestContext extends FirebaseAdminNestTestContext, FirebaseAdminCloudFunctionWrapper {
+    get wrapCloudFunction(): WrapCloudFunction;
+}
+export declare class FirebaseAdminFunctionNestTestContextFixture<PI extends FirebaseAdminFunctionTestContextInstance = FirebaseAdminFunctionTestContextInstance, PF extends JestTestContextFixture<PI> = JestTestContextFixture<PI>, I extends FirebaseAdminFunctionNestTestContextInstance<PI> = FirebaseAdminFunctionNestTestContextInstance<PI>> extends FirebaseAdminNestTestContextFixture<PI, PF, I> implements FirebaseAdminFunctionNestTestContext {
+    get wrapCloudFunction(): WrapCloudFunction;
+    wrapCloudFunctionForNestTests<I>(fn: NestApplicationRunnableHttpFunctionFactory<I>): WrappedCloudFunction<I>;
+    wrapCloudFunctionForNestTestsGetter<I>(fn: NestApplicationRunnableHttpFunctionFactory<I>): Getter<WrappedCloudFunction<I>>;
+}
+export declare class FirebaseAdminFunctionNestTestContextInstance<PI extends FirebaseAdminFunctionTestContextInstance = FirebaseAdminFunctionTestContextInstance> extends FirebaseAdminNestTestContextInstance<PI> implements FirebaseAdminFunctionNestTestContext {
+    get wrapCloudFunction(): WrapCloudFunction;
+}
+export interface FirebaseAdminFunctionNestTestConfig<PI extends FirebaseAdminFunctionTestContextInstance = FirebaseAdminFunctionTestContextInstance, PF extends JestTestContextFixture<PI> = JestTestContextFixture<PI>, I extends FirebaseAdminFunctionNestTestContextInstance<PI> = FirebaseAdminFunctionNestTestContextInstance<PI>, C extends FirebaseAdminFunctionNestTestContextFixture<PI, PF, I> = FirebaseAdminFunctionNestTestContextFixture<PI, PF, I>> extends FirebaseAdminNestTestConfig<PI, PF, I, C> {
+}
+export declare type FirebaseAdminFunctionNestTestContextFactory<PI extends FirebaseAdminFunctionTestContextInstance = FirebaseAdminFunctionTestContextInstance, PF extends JestTestContextFixture<PI> = JestTestContextFixture<PI>, I extends FirebaseAdminFunctionNestTestContextInstance<PI> = FirebaseAdminFunctionNestTestContextInstance<PI>, C extends FirebaseAdminFunctionNestTestContextFixture<PI, PF, I> = FirebaseAdminFunctionNestTestContextFixture<PI, PF, I>> = JestTestContextFactory<C>;
+export declare function firebaseAdminFunctionNestContextFixture<PI extends FirebaseAdminFunctionTestContextInstance = FirebaseAdminFunctionTestContextInstance, PF extends JestTestContextFixture<PI> = JestTestContextFixture<PI>, I extends FirebaseAdminFunctionNestTestContextInstance<PI> = FirebaseAdminFunctionNestTestContextInstance<PI>, C extends FirebaseAdminFunctionNestTestContextFixture<PI, PF, I> = FirebaseAdminFunctionNestTestContextFixture<PI, PF, I>>(config: FirebaseAdminFunctionNestTestConfig<PI, PF, I, C>, factory: JestTestContextFactory<PF>): FirebaseAdminFunctionNestTestContextFactory<PI, PF, I, C>;
+export declare class FirebaseAdminFunctionNestRootModule {
+}
+export declare function firebaseAdminFunctionNestContextWithFixture<PI extends FirebaseAdminFunctionTestContextInstance = FirebaseAdminFunctionTestContextInstance, PF extends JestTestContextFixture<PI> = JestTestContextFixture<PI>, I extends FirebaseAdminFunctionNestTestContextInstance<PI> = FirebaseAdminFunctionNestTestContextInstance<PI>, C extends FirebaseAdminFunctionNestTestContextFixture<PI, PF, I> = FirebaseAdminFunctionNestTestContextFixture<PI, PF, I>>(config: FirebaseAdminFunctionNestTestConfig<PI, PF, I, C>, f: PF, buildTests: JestBuildTestsWithContextFunction<C>): void;
+export declare function firebaseAdminFunctionNestContextFactory<I extends FirebaseAdminFunctionNestTestContextInstance<FirebaseAdminFunctionTestContextInstance> = FirebaseAdminFunctionNestTestContextInstance<FirebaseAdminFunctionTestContextInstance>>(config: FirebaseAdminFunctionNestTestConfig<FirebaseAdminFunctionTestContextInstance, JestTestContextFixture<FirebaseAdminFunctionTestContextInstance>, I>): FirebaseAdminFunctionNestTestContextFactory<FirebaseAdminFunctionTestContextInstance, JestTestContextFixture<FirebaseAdminFunctionTestContextInstance>, I>;

package/src/test/firebase/firebase.admin.nest.function.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firebaseAdminFunctionNestContextFactory = exports.firebaseAdminFunctionNestContextWithFixture = exports.FirebaseAdminFunctionNestRootModule = exports.firebaseAdminFunctionNestContextFixture = exports.FirebaseAdminFunctionNestTestContextInstance = exports.FirebaseAdminFunctionNestTestContextFixture = exports.wrapCloudFunctionForNestTestsGetter = void 0;
+const firebase_admin_nest_1 = require("./firebase.admin.nest");
+const firebase_admin_function_1 = require("./firebase.admin.function");
+const firebase_admin_1 = require("./firebase.admin");
+// MARK: Utility
+function wrapCloudFunctionForNestTestsGetter(wrapper, fn) {
+    return (0, firebase_admin_1.wrapCloudFunctionForTests)(wrapper, () => fn(wrapper.nestAppPromiseGetter));
+}
+exports.wrapCloudFunctionForNestTestsGetter = wrapCloudFunctionForNestTestsGetter;
+class FirebaseAdminFunctionNestTestContextFixture extends firebase_admin_nest_1.FirebaseAdminNestTestContextFixture {
+    // MARK: FirebaseAdminTestContext (Forwarded)
+    get wrapCloudFunction() {
+        return this.parent.instance.wrapCloudFunction;
+    }
+    wrapCloudFunctionForNestTests(fn) {
+        return this.wrapCloudFunctionForNestTestsGetter(fn)();
+    }
+    wrapCloudFunctionForNestTestsGetter(fn) {
+        return wrapCloudFunctionForNestTestsGetter(this, fn);
+    }
+}
+exports.FirebaseAdminFunctionNestTestContextFixture = FirebaseAdminFunctionNestTestContextFixture;
+class FirebaseAdminFunctionNestTestContextInstance extends firebase_admin_nest_1.FirebaseAdminNestTestContextInstance {
+    // MARK: FirebaseAdminTestContext (Forwarded)
+    get wrapCloudFunction() {
+        return this.parent.wrapCloudFunction;
+    }
+}
+exports.FirebaseAdminFunctionNestTestContextInstance = FirebaseAdminFunctionNestTestContextInstance;
+function firebaseAdminFunctionNestContextFixture(config, factory) {
+    return (buildTests) => {
+        factory((f) => firebaseAdminFunctionNestContextWithFixture(config, f, buildTests));
+    };
+}
+exports.firebaseAdminFunctionNestContextFixture = firebaseAdminFunctionNestContextFixture;
+class FirebaseAdminFunctionNestRootModule {
+}
+exports.FirebaseAdminFunctionNestRootModule = FirebaseAdminFunctionNestRootModule;
+function firebaseAdminFunctionNestContextWithFixture(config, f, buildTests) {
+    const mergedConfig = Object.assign({ makeFixture: (parent) => new FirebaseAdminFunctionNestTestContextFixture(parent), makeInstance: (instance, nest) => new FirebaseAdminFunctionNestTestContextInstance(instance, nest) }, config);
+    return (0, firebase_admin_nest_1.firebaseAdminNestContextWithFixture)(mergedConfig, f, buildTests);
+}
+exports.firebaseAdminFunctionNestContextWithFixture = firebaseAdminFunctionNestContextWithFixture;
+function firebaseAdminFunctionNestContextFactory(config) {
+    return firebaseAdminFunctionNestContextFixture(config, firebase_admin_function_1.firebaseAdminFunctionTestContextFactory);
+}
+exports.firebaseAdminFunctionNestContextFactory = firebaseAdminFunctionNestContextFactory;
+//# sourceMappingURL=firebase.admin.nest.function.js.map

package/src/test/firebase/firebase.admin.nest.function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase.admin.nest.function.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/test/firebase/firebase.admin.nest.function.ts"],"names":[],"mappings":";;;AACA,+DAAkN;AAClN,uEAA8H;AAC9H,qDAAyI;AAGzI,gBAAgB;AAChB,SAAgB,mCAAmC,CAAI,OAA6C,EAAE,EAAiD;IACrJ,OAAO,IAAA,0CAAyB,EAAI,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;AACvF,CAAC;AAFD,kFAEC;AAOD,MAAa,2CAIT,SAAQ,yDAA8C;IAExD,6CAA6C;IAC7C,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAChD,CAAC;IAED,6BAA6B,CAAI,EAAiD;QAChF,OAAO,IAAI,CAAC,mCAAmC,CAAC,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,mCAAmC,CAAI,EAAiD;QACtF,OAAO,mCAAmC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;CAEF;AAnBD,kGAmBC;AAED,MAAa,4CAET,SAAQ,0DAAwC;IAElD,6CAA6C;IAC7C,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC;IACvC,CAAC;CAEF;AATD,oGASC;AAgBD,SAAgB,uCAAuC,CAKrD,MAAyD,EAAE,OAAmC;IAC9F,OAAO,CAAC,UAAgD,EAAE,EAAE;QAC1D,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,2CAA2C,CAAe,MAAM,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IACnG,CAAC,CAAC;AACJ,CAAC;AATD,0FASC;AAED,MAAa,mCAAmC;CAAI;AAApD,kFAAoD;AAEpD,SAAgB,2CAA2C,CAKzD,MAAyD,EAAE,CAAK,EAAE,UAAgD;IAClH,MAAM,YAAY,mBAChB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,2CAA2C,CAAC,MAAM,CAAM,EACrF,YAAY,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,4CAA4C,CAAK,QAAQ,EAAE,IAAI,CAAM,IACxG,MAAM,CACV,CAAC;IAEF,OAAO,IAAA,yDAAmC,EAAe,YAAY,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;AACxF,CAAC;AAbD,kGAaC;AAED,SAAgB,uCAAuC,CAErD,MAA0J;IAC1J,OAAO,uCAAuC,CAAgH,MAAM,EAAE,iEAAuC,CAAC,CAAC;AACjN,CAAC;AAJD,0FAIC"}

package/src/test/firebase/firebase.admin.nest.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firebaseAdminNestContextFactory = exports.firebaseAdminNestContextWithFixture = exports.FirebaseAdminNestRootModule = exports.firebaseAdminNestContextFixture = exports.FirebaseAdminNestTestContextInstance = exports.FirebaseAdminNestTestContextFixture = void 0;
+const tslib_1 = require("tslib");
+const util_1 = require("@dereekb/util");
+const firebase_admin_1 = require("./firebase.admin");
+const testing_1 = require("@nestjs/testing");
+const firebase_nest_1 = require("../../lib/firebase/firebase.nest");
+class FirebaseAdminNestTestContextFixture extends util_1.AbstractChildJestTestContextFixture {
+    // MARK: Forwarded
+    get nest() {
+        return this.instance.nest;
+    }
+    get nestAppPromiseGetter() {
+        return this.instance.nestAppPromiseGetter;
+    }
+    get(typeOrToken, options) {
+        return this.instance.get(typeOrToken, options);
+    }
+}
+exports.FirebaseAdminNestTestContextFixture = FirebaseAdminNestTestContextFixture;
+class FirebaseAdminNestTestContextInstance extends firebase_admin_1.AbstractFirebaseAdminTestContextInstanceChild {
+    constructor(parent, nest) {
+        super(parent);
+        this.nest = nest;
+        this.nestAppPromiseGetter = () => Promise.resolve(this.nest);
+    }
+    get(typeOrToken, options) {
+        return this.nest.get(typeOrToken, options);
+    }
+}
+exports.FirebaseAdminNestTestContextInstance = FirebaseAdminNestTestContextInstance;
+function firebaseAdminNestContextFixture(config, factory) {
+    return (buildTests) => {
+        factory((f) => firebaseAdminNestContextWithFixture(config, f, buildTests));
+    };
+}
+exports.firebaseAdminNestContextFixture = firebaseAdminNestContextFixture;
+class FirebaseAdminNestRootModule {
+}
+exports.FirebaseAdminNestRootModule = FirebaseAdminNestRootModule;
+function firebaseAdminNestContextWithFixture(config, f, buildTests) {
+    const { nestModules, makeProviders = () => [], injectFirebaseServerAppTokenProvider, makeFixture = (parent) => new FirebaseAdminNestTestContextFixture(parent), makeInstance = (instance, nest) => new FirebaseAdminNestTestContextInstance(instance, nest), initInstance } = config;
+    (0, util_1.useJestContextFixture)({
+        fixture: makeFixture(f),
+        /**
+         * Build tests by passing the fixture to the testing functions.
+         *
+         * This will inject all tests and sub Jest lifecycle items.
+         */
+        buildTests,
+        initInstance: () => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const imports = (0, util_1.asArray)(nestModules);
+            const providers = (_a = makeProviders(f.instance)) !== null && _a !== void 0 ? _a : [];
+            // Inject the firebaseServerAppTokenProvider
+            if (injectFirebaseServerAppTokenProvider) {
+                providers.push((0, firebase_nest_1.firebaseServerAppTokenProvider)((0, util_1.asGetter)(f.instance.app)));
+            }
+            const rootModule = {
+                module: FirebaseAdminNestRootModule,
+                providers,
+                exports: providers,
+                global: true
+            };
+            const builder = (testing_1.Test.createTestingModule({
+                imports: [rootModule, ...imports]
+            }));
+            const nest = yield builder.compile();
+            const instance = makeInstance(f.instance, nest);
+            if (initInstance) {
+                yield initInstance(instance);
+            }
+            return instance;
+        }),
+        destroyInstance: (instance) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            yield instance.nest.close();
+        })
+    });
+}
+exports.firebaseAdminNestContextWithFixture = firebaseAdminNestContextWithFixture;
+function firebaseAdminNestContextFactory(config) {
+    return firebaseAdminNestContextFixture(config, firebase_admin_1.firebaseAdminTestContextFactory);
+}
+exports.firebaseAdminNestContextFactory = firebaseAdminNestContextFactory;
+//# sourceMappingURL=firebase.admin.nest.js.map

package/src/test/firebase/firebase.admin.nest.js.map

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

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

@@ -0,0 +1,3 @@
+import { TestFirestoreContextFixture, TestFirestoreInstance } from "@dereekb/firebase";
+export declare function initFirebaseServerAdminTestEnvironment(): void;
+export declare function describeFirestoreTest(s: TestFirestoreContextFixture<TestFirestoreInstance>): void;

package/src/test/firebase/firebase.admin.test.server.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeFirestoreTest = exports.initFirebaseServerAdminTestEnvironment = void 0;
+const tslib_1 = require("tslib");
+const firebase_1 = require("@dereekb/firebase");
+const firebase_2 = require("./firebase");
+function initFirebaseServerAdminTestEnvironment() {
+    (0, firebase_2.initFirebaseAdminTestEnvironment)({
+        emulators: {
+            auth: '0.0.0.0:9903',
+            firestore: '0.0.0.0:9904',
+            storage: '0.0.0.0:9906'
+        }
+    });
+}
+exports.initFirebaseServerAdminTestEnvironment = initFirebaseServerAdminTestEnvironment;
+function describeFirestoreTest(s) {
+    let collection;
+    beforeEach(() => {
+        collection = (0, firebase_1.mockItemFirestoreCollection)(s.context);
+    });
+    describe('firestore', () => {
+        it('should interact with the firestore.', () => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const document = collection.documentAccessor().newDocument();
+            const setData = {
+                value: 'a',
+                test: true
+            };
+            yield document.accessor.set(setData);
+            const exists = yield document.accessor.exists();
+            expect(exists).toBe(true);
+            const snapshot = yield document.accessor.get();
+            const data = snapshot.data();
+            expect(data).toBeDefined();
+        }));
+    });
+}
+exports.describeFirestoreTest = describeFirestoreTest;
+//# sourceMappingURL=firebase.admin.test.server.js.map

package/src/test/firebase/firebase.admin.test.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase.admin.test.server.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/test/firebase/firebase.admin.test.server.ts"],"names":[],"mappings":";;;;AAAA,gDAAiJ;AACjJ,yCAA8D;AAE9D,SAAgB,sCAAsC;IACpD,IAAA,2CAAgC,EAAC;QAC/B,SAAS,EAAE;YACT,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,cAAc;YACzB,OAAO,EAAE,cAAc;SACxB;KACF,CAAC,CAAA;AACJ,CAAC;AARD,wFAQC;AAED,SAAgB,qBAAqB,CAAC,CAAqD;IAEzF,IAAI,UAAuC,CAAC;IAE5C,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG,IAAA,sCAA2B,EAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QAEzB,EAAE,CAAC,qCAAqC,EAAE,GAAS,EAAE;YACnD,MAAM,QAAQ,GAAG,UAAU,CAAC,gBAAgB,EAAE,CAAC,WAAW,EAAE,CAAC;YAE7D,MAAM,OAAO,GAAG;gBACd,KAAK,EAAE,GAAG;gBACV,IAAI,EAAE,IAAI;aACX,CAAC;YAEF,MAAM,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAErC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE1B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;YAE7B,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC,CAAA,CAAC,CAAC;IAEL,CAAC,CAAC,CAAC;AAEL,CAAC;AA/BD,sDA+BC"}

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

@@ -0,0 +1,30 @@
+/**
+ * Host url:port combo.
+ *
+ * I.E. localhost:8080
+ */
+export declare type FirebaseAdminTestEnvironmentHost = string;
+export interface FirebaseAdminTestEnvironmentEmulatorsConfig {
+    auth: FirebaseAdminTestEnvironmentHost | null;
+    storage: FirebaseAdminTestEnvironmentHost | null;
+    firestore: FirebaseAdminTestEnvironmentHost | null;
+}
+export interface FirebaseAdminTestEnvironmentConfig {
+    emulators: FirebaseAdminTestEnvironmentEmulatorsConfig;
+}
+export declare function isAdminEnvironmentInitialized(): boolean;
+export declare function generateNewProjectId(): string;
+export declare function rollNewGCloudProjectEnvironmentVariable(): string;
+export declare function getGCloudProjectId(): string | undefined;
+export declare function getGCloudTestProjectId(): string | undefined;
+/**
+ * Applies the current GCLOUD_PROJECT to FIREBASE_CONFIG.
+ *
+ * This is done as some external testing libraries (firebase-functions-test) will overwrite but we want to enforce using our project id
+ * so that each component can also
+ */
+export declare function applyFirebaseGCloudTestProjectIdToFirebaseConfigEnv(): string;
+/**
+ * Should be called before calling/using adminFirebaseTestBuilder(). This should only be called once.
+ */
+export declare function initFirebaseAdminTestEnvironment(config: FirebaseAdminTestEnvironmentConfig): void;

package/src/test/firebase/firebase.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initFirebaseAdminTestEnvironment = exports.applyFirebaseGCloudTestProjectIdToFirebaseConfigEnv = exports.getGCloudTestProjectId = exports.getGCloudProjectId = exports.rollNewGCloudProjectEnvironmentVariable = exports.generateNewProjectId = exports.isAdminEnvironmentInitialized = void 0;
+let adminEnvironmentInitialized = false;
+function isAdminEnvironmentInitialized() {
+    return adminEnvironmentInitialized;
+}
+exports.isAdminEnvironmentInitialized = isAdminEnvironmentInitialized;
+function generateNewProjectId() {
+    const projectId = 'firebase-test-' + new Date().getTime();
+    return projectId;
+}
+exports.generateNewProjectId = generateNewProjectId;
+function rollNewGCloudProjectEnvironmentVariable() {
+    const projectId = generateNewProjectId();
+    process.env.GCLOUD_TEST_PROJECT = projectId;
+    process.env.GCLOUD_PROJECT = projectId;
+    applyFirebaseGCloudTestProjectIdToFirebaseConfigEnv();
+    return projectId;
+}
+exports.rollNewGCloudProjectEnvironmentVariable = rollNewGCloudProjectEnvironmentVariable;
+function getGCloudProjectId() {
+    return process.env.GCLOUD_PROJECT;
+}
+exports.getGCloudProjectId = getGCloudProjectId;
+function getGCloudTestProjectId() {
+    return process.env.GCLOUD_TEST_PROJECT;
+}
+exports.getGCloudTestProjectId = getGCloudTestProjectId;
+/**
+ * Applies the current GCLOUD_PROJECT to FIREBASE_CONFIG.
+ *
+ * This is done as some external testing libraries (firebase-functions-test) will overwrite but we want to enforce using our project id
+ * so that each component can also
+ */
+function applyFirebaseGCloudTestProjectIdToFirebaseConfigEnv() {
+    var _a;
+    // firebase-functions-test overwrites this each time.
+    // https://github.com/firebase/firebase-functions-test/blob/acb068f4c086f3355b2960b9e9e5895716c7f8cc/src/lifecycle.ts#L37
+    const testProjectId = getGCloudTestProjectId();
+    // console.log('Test project: ', testProjectId);
+    if (!testProjectId) {
+        throw new Error('No test project id was available in the environment. Did you call initFirebaseAdminTestEnvironment() first?');
+    }
+    let config = JSON.parse((_a = process.env.FIREBASE_CONFIG) !== null && _a !== void 0 ? _a : '{}');
+    config.projectId = testProjectId;
+    process.env.FIREBASE_CONFIG = JSON.stringify(config);
+    process.env.GCLOUD_PROJECT = testProjectId; // re-apply to GCLOUD_PROJECT too
+    return testProjectId;
+}
+exports.applyFirebaseGCloudTestProjectIdToFirebaseConfigEnv = applyFirebaseGCloudTestProjectIdToFirebaseConfigEnv;
+/**
+ * Should be called before calling/using adminFirebaseTestBuilder(). This should only be called once.
+ */
+function initFirebaseAdminTestEnvironment(config) {
+    function crashForEmulator(emulator) {
+        throw new Error(`Emulator for ${emulator} was not set null or to a host. Crashing to prevent contamination.`);
+    }
+    function configureEmulator(emulator, envKey) {
+        const emulatorConfig = config.emulators[emulator];
+        if (emulatorConfig) {
+            process.env[envKey] = emulatorConfig;
+        }
+        else if (config.emulators.firestore !== null) {
+            crashForEmulator(emulator);
+        }
+    }
+    rollNewGCloudProjectEnvironmentVariable();
+    configureEmulator('auth', 'FIREBASE_AUTH_EMULATOR_HOST');
+    configureEmulator('firestore', 'FIRESTORE_EMULATOR_HOST');
+    configureEmulator('storage', 'FIREBASE_STORAGE_EMULATOR_HOST');
+    applyFirebaseGCloudTestProjectIdToFirebaseConfigEnv();
+    adminEnvironmentInitialized = true;
+}
+exports.initFirebaseAdminTestEnvironment = initFirebaseAdminTestEnvironment;
+//# sourceMappingURL=firebase.js.map

package/src/test/firebase/firebase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/test/firebase/firebase.ts"],"names":[],"mappings":";;;AAAA,IAAI,2BAA2B,GAAG,KAAK,CAAC;AAmBxC,SAAgB,6BAA6B;IAC3C,OAAO,2BAA2B,CAAC;AACrC,CAAC;AAFD,sEAEC;AAED,SAAgB,oBAAoB;IAClC,MAAM,SAAS,GAAG,gBAAgB,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1D,OAAO,SAAS,CAAC;AACnB,CAAC;AAHD,oDAGC;AAED,SAAgB,uCAAuC;IACrD,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,SAAS,CAAC;IACvC,mDAAmD,EAAE,CAAC;IACtD,OAAO,SAAS,CAAC;AACnB,CAAC;AAND,0FAMC;AAED,SAAgB,kBAAkB;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AACpC,CAAC;AAFD,gDAEC;AAED,SAAgB,sBAAsB;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AACzC,CAAC;AAFD,wDAEC;AAED;;;;;GAKG;AACH,SAAgB,mDAAmD;;IACjE,qDAAqD;IACrD,yHAAyH;IACzH,MAAM,aAAa,GAAG,sBAAsB,EAAE,CAAC;IAE/C,gDAAgD;IAEhD,IAAI,CAAC,aAAa,EAAE;QAClB,MAAM,IAAI,KAAK,CAAC,6GAA6G,CAAC,CAAC;KAChI;IAED,IAAI,MAAM,GAAQ,IAAI,CAAC,KAAK,CAAC,MAAA,OAAO,CAAC,GAAG,CAAC,eAAe,mCAAI,IAAI,CAAC,CAAC;IAClE,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC;IAEjC,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,aAAa,CAAC,CAAE,iCAAiC;IAE9E,OAAO,aAAa,CAAC;AACvB,CAAC;AAlBD,kHAkBC;AAED;;GAEG;AACH,SAAgB,gCAAgC,CAAC,MAA0C;IAEzF,SAAS,gBAAgB,CAAC,QAAgB;QACxC,MAAM,IAAI,KAAK,CAAC,gBAAgB,QAAQ,oEAAoE,CAAC,CAAC;IAChH,CAAC;IAED,SAAS,iBAAiB,CAAC,QAA2D,EAAE,MAAc;QACpG,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAElD,IAAI,cAAc,EAAE;YAClB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC;SACtC;aAAM,IAAI,MAAM,CAAC,SAAS,CAAC,SAAS,KAAK,IAAI,EAAE;YAC9C,gBAAgB,CAAC,QAAQ,CAAC,CAAC;SAC5B;IACH,CAAC;IAED,uCAAuC,EAAE,CAAC;IAC1C,iBAAiB,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;IACzD,iBAAiB,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC;IAC1D,iBAAiB,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;IAE/D,mDAAmD,EAAE,CAAC;IAEtD,2BAA2B,GAAG,IAAI,CAAC;AACrC,CAAC;AAxBD,4EAwBC"}

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

@@ -0,0 +1,8 @@
+export * from './firebase';
+export * from './firebase.admin';
+export * from './firebase.admin.nest';
+export * from './firebase.admin.function';
+export * from './firebase.admin.nest.function';
+export * from './firebase.admin.nest.function.context';
+export * from './firebase.admin.auth';
+export * from './firebase.admin.collection';