@dereekb/firebase-server 3.0.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
+
+# [3.0.0](https://github.com/dereekb/dbx-components/compare/v2.1.0...v3.0.0) (2022-05-13)
+
+
+### Features
+
+* added firebase-server ([676cf9e](https://github.com/dereekb/dbx-components/commit/676cf9e6c44aab5ca993b5a1a9c347c021b41a4a))
+* added jestFunctionFixture ([1ea2d7d](https://github.com/dereekb/dbx-components/commit/1ea2d7d4c852449f34279eeedfadd2d69c1e7f2b))
+* added modelConversionOptions to modelMapFunction ([2de30e0](https://github.com/dereekb/dbx-components/commit/2de30e07527bbaf27c51a8472054a35e73d2ae2b))
+* added modelTestContextFactory ([0a96442](https://github.com/dereekb/dbx-components/commit/0a9644252ffc670cb2e861a4c02ace6790eeae52))
+* added onCallWithNestContext to firebase-server ([ad4fcf8](https://github.com/dereekb/dbx-components/commit/ad4fcf80e71e7b954197dd89924d31180c03c911))
+* firebaseServerAuthModule ([db9a4d3](https://github.com/dereekb/dbx-components/commit/db9a4d3d47fd15317186c7a034c25083ae395251))

package/README.md

@@ -0,0 +1,7 @@
+# firebase-server
+
+This library was generated with [Nx](https://nx.dev).
+
+## Running unit tests
+
+Run `nx test firebase-server` to execute the unit tests via [Jest](https://jestjs.io).

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@dereekb/firebase-server",
+  "version": "3.0.0",
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts",
+  "dependencies": {},
+  "peerDependencies": {
+    "firebase-admin": "^10.2.0",
+    "@nestjs/common": "^8.4.0",
+    "@dereekb/util": "3.0.0",
+    "make-error": "^1.3.0",
+    "extra-set": "^2.2.11",
+    "change-case": "^4.1.2",
+    "firebase-functions": "^3.21.0",
+    "@dereekb/firebase": "3.0.0",
+    "rxjs": "^7.0.0",
+    "rxfire": "^6.0.3",
+    "firebase": "^9.8.0",
+    "@dereekb/rxjs": "3.0.0",
+    "ms": "^3.0.0-canary.1",
+    "@dereekb/date": "3.0.0",
+    "class-transformer": "^0.5.1",
+    "date-fns": "^2.28.0",
+    "class-validator": "^0.13.2",
+    "date-fns-tz": "^1.3.0",
+    "rrule": "git+https://git@github.com/dereekb/rrule.git#17adf5708d6567b4d01a3a8afd106261421ea492",
+    "@dereekb/model": "3.0.0",
+    "@google-cloud/firestore": "^5.0.2",
+    "@nestjs/core": "^8.4.0",
+    "@nestjs/platform-express": "^8.4.0",
+    "jsonwebtoken": "^8.0.0",
+    "tslib": "^2.0.0"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib';
+export * from './test';

package/src/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib"), exports);
+tslib_1.__exportStar(require("./test"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/firebase-server/src/index.ts"],"names":[],"mappings":";;;AAAA,gDAAsB;AACtB,iDAAuB"}

package/src/lib/auth/auth.nest.d.ts

@@ -0,0 +1,28 @@
+import * as admin from 'firebase-admin';
+import { FactoryProvider, InjectionToken, ModuleMetadata, Provider } from "@nestjs/common";
+import { FirebaseServerAuthService } from './auth.service';
+/**
+ * Token to access the Auth for the app.
+ */
+export declare const FIREBASE_AUTH_TOKEN: InjectionToken;
+/**
+ * Nest provider module for Firebase that provides a firestore, etc. from the firestore token.
+ */
+export declare class FirebaseServerAuthModule {
+}
+export declare type ProvideFirestoreServerAuthServiceSimple<T extends FirebaseServerAuthService> = Pick<FactoryProvider<T>, 'provide'> & {
+    useFactory: (auth: admin.auth.Auth) => T;
+};
+export declare type ProvideFirebaseServerAuthService<T extends FirebaseServerAuthService> = FactoryProvider<T> | ProvideFirestoreServerAuthServiceSimple<T>;
+export declare function provideFirebaseServerAuthService<T extends FirebaseServerAuthService>(provider: ProvideFirebaseServerAuthService<T>): [ProvideFirebaseServerAuthService<T>, Provider<T>];
+export interface FirebaseServerAuthModuleMetadataConfig<T extends FirebaseServerAuthService> extends Pick<ModuleMetadata, 'imports' | 'exports' | 'providers'> {
+    readonly serviceProvider: ProvideFirebaseServerAuthService<T>;
+}
+/**
+ * Convenience function used to generate ModuleMetadata for an app's Auth related modules and FirebaseServerAuthService provider.
+ *
+ * @param provide
+ * @param useFactory
+ * @returns
+ */
+export declare function firebaseServerAuthModuleMetadata<T extends FirebaseServerAuthService>(config: FirebaseServerAuthModuleMetadataConfig<T>): ModuleMetadata;

package/src/lib/auth/auth.nest.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firebaseServerAuthModuleMetadata = exports.provideFirebaseServerAuthService = exports.FirebaseServerAuthModule = exports.FIREBASE_AUTH_TOKEN = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const firebase_nest_1 = require("../firebase/firebase.nest");
+const auth_service_1 = require("./auth.service");
+// MARK: Tokens
+/**
+ * Token to access the Auth for the app.
+ */
+exports.FIREBASE_AUTH_TOKEN = 'FIREBASE_AUTH_TOKEN';
+/**
+ * Nest provider module for Firebase that provides a firestore, etc. from the firestore token.
+ */
+let FirebaseServerAuthModule = class FirebaseServerAuthModule {
+};
+FirebaseServerAuthModule = tslib_1.__decorate([
+    (0, common_1.Module)({
+        providers: [{
+                provide: exports.FIREBASE_AUTH_TOKEN,
+                useFactory: (app) => app.auth(),
+                inject: [firebase_nest_1.FIREBASE_APP_TOKEN]
+            }],
+        exports: [exports.FIREBASE_AUTH_TOKEN]
+    })
+], FirebaseServerAuthModule);
+exports.FirebaseServerAuthModule = FirebaseServerAuthModule;
+function provideFirebaseServerAuthService(provider) {
+    var _a;
+    return [
+        Object.assign(Object.assign({}, provider), { inject: (_a = provider.inject) !== null && _a !== void 0 ? _a : [exports.FIREBASE_AUTH_TOKEN] }),
+        {
+            provide: auth_service_1.FirebaseServerAuthService,
+            useExisting: provider.provide
+        }
+    ];
+}
+exports.provideFirebaseServerAuthService = provideFirebaseServerAuthService;
+/**
+ * Convenience function used to generate ModuleMetadata for an app's Auth related modules and FirebaseServerAuthService provider.
+ *
+ * @param provide
+ * @param useFactory
+ * @returns
+ */
+function firebaseServerAuthModuleMetadata(config) {
+    var _a, _b, _c;
+    return {
+        imports: [FirebaseServerAuthModule, ...((_a = config.imports) !== null && _a !== void 0 ? _a : [])],
+        exports: [FirebaseServerAuthModule, config.serviceProvider.provide, ...((_b = config.exports) !== null && _b !== void 0 ? _b : [])],
+        providers: [...provideFirebaseServerAuthService(config.serviceProvider), ...((_c = config.providers) !== null && _c !== void 0 ? _c : [])]
+    };
+}
+exports.firebaseServerAuthModuleMetadata = firebaseServerAuthModuleMetadata;
+//# sourceMappingURL=auth.nest.js.map

package/src/lib/auth/auth.nest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.nest.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/lib/auth/auth.nest.ts"],"names":[],"mappings":";;;;AACA,2CAAmG;AACnG,6DAA+D;AAC/D,iDAA2D;AAE3D,eAAe;AACf;;GAEG;AACU,QAAA,mBAAmB,GAAmB,qBAAqB,CAAC;AAEzE;;GAEG;AASH,IAAa,wBAAwB,GAArC,MAAa,wBAAwB;CAAI,CAAA;AAA5B,wBAAwB;IARpC,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC;gBACV,OAAO,EAAE,2BAAmB;gBAC5B,UAAU,EAAE,CAAC,GAAkB,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE;gBAC9C,MAAM,EAAE,CAAC,kCAAkB,CAAC;aAC7B,CAAC;QACF,OAAO,EAAE,CAAC,2BAAmB,CAAC;KAC/B,CAAC;GACW,wBAAwB,CAAI;AAA5B,4DAAwB;AASrC,SAAgB,gCAAgC,CAAsC,QAA6C;;IACjI,OAAO;wCAEA,QAAQ,KACX,MAAM,EAAE,MAAC,QAAgB,CAAC,MAAM,mCAAI,CAAC,2BAAmB,CAAC;QAE3D;YACE,OAAO,EAAE,wCAAyB;YAClC,WAAW,EAAE,QAAQ,CAAC,OAAO;SAC9B;KACF,CAAC;AACJ,CAAC;AAXD,4EAWC;AAOD;;;;;;GAMG;AACH,SAAgB,gCAAgC,CAAsC,MAAiD;;IACrI,OAAO;QACL,OAAO,EAAE,CAAC,wBAAwB,EAAE,GAAG,CAAC,MAAA,MAAM,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC;QAC9D,OAAO,EAAE,CAAC,wBAAwB,EAAE,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,MAAA,MAAM,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC;QAC9F,SAAS,EAAE,CAAC,GAAG,gCAAgC,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAA,MAAM,CAAC,SAAS,mCAAI,EAAE,CAAC,CAAC;KACtG,CAAC;AACJ,CAAC;AAND,4EAMC"}

package/src/lib/auth/auth.service.d.ts

@@ -0,0 +1,161 @@
+import * as functions from 'firebase-functions';
+import * as admin from 'firebase-admin';
+import { FirebaseAuthUserId } from '@dereekb/firebase';
+import { AuthClaims, AuthRoleSet, ArrayOrValue, AuthRole, AuthClaimsUpdate } from '@dereekb/util';
+import { CallableContextWithAuthData } from '../function/context';
+export interface FirebaseServerAuthUserIdentifierContext {
+    /**
+     * UID of the user for this context.
+     */
+    readonly uid: FirebaseAuthUserId;
+}
+export interface FirebaseServerAuthUserContext extends FirebaseServerAuthUserIdentifierContext {
+    /**
+     * Loads the record of the user.
+     */
+    loadRecord(): Promise<admin.auth.UserRecord>;
+    /**
+     * Loads the roles of the user.
+     */
+    loadRoles(): Promise<AuthRoleSet>;
+    /**
+     * Adds the given roles to the user.
+     *
+     * @param roles
+     */
+    addRoles(roles: ArrayOrValue<AuthRole>): Promise<void>;
+    /**
+     * Removes the given roles from the user.
+     *
+     * @param roles
+     */
+    removeRoles(roles: ArrayOrValue<AuthRole>): Promise<void>;
+    /**
+     * Updates the claims for a user by merging existing claims in with the input.
+     *
+     * All null values are cleared from the existing claims. Undefined values are ignored.
+     *
+     * @param claims
+     */
+    updateClaims(claims: AuthClaimsUpdate): Promise<void>;
+    /**
+     * Sets the claims for a user. All previous claims are cleared.
+     *
+     * @param claims
+     */
+    setClaims(claims: AuthClaimsUpdate): Promise<void>;
+    /**
+     * Clears all claims for the user.
+     *
+     * @param claims
+     */
+    clearClaims(): Promise<void>;
+}
+export declare abstract class AbstractFirebaseServerAuthUserContext<S extends FirebaseServerAuthService> implements FirebaseServerAuthUserContext {
+    readonly service: S;
+    readonly uid: FirebaseAuthUserId;
+    private readonly _loadRecord;
+    constructor(service: S, uid: FirebaseAuthUserId);
+    loadRecord(): Promise<admin.auth.UserRecord>;
+    loadRoles(): Promise<AuthRoleSet>;
+    addRoles(roles: ArrayOrValue<AuthRole>): Promise<void>;
+    removeRoles(roles: ArrayOrValue<AuthRole>): Promise<void>;
+    protected _claimsForRolesChange(roles: ArrayOrValue<AuthRole>): AuthClaims<any>;
+    loadClaims(): Promise<AuthClaims>;
+    updateClaims(claims: AuthClaimsUpdate): Promise<void>;
+    clearClaims(): Promise<void>;
+    setClaims(claims: AuthClaimsUpdate): Promise<void>;
+}
+export interface FirebaseServerAuthContext<U extends FirebaseServerAuthUserContext = FirebaseServerAuthUserContext> extends FirebaseServerAuthUserIdentifierContext {
+    /**
+     * The wrapped context.
+     */
+    readonly context: CallableContextWithAuthData;
+    /**
+     * Returns the user context for this type.
+     */
+    readonly userContext: U;
+    /**
+     * Whether or not the context sees the user as an admin of the system.
+     */
+    readonly isAdmin: boolean;
+    /**
+     * The auth roles provided by the token in this context.
+     */
+    readonly authRoles: AuthRoleSet;
+    /**
+     * The token in the context.
+     */
+    readonly token: admin.auth.DecodedIdToken;
+    /**
+     * The claims in the context.
+     */
+    readonly claims: AuthClaims;
+}
+export declare abstract class AbstractFirebaseServerAuthContext<C extends FirebaseServerAuthContext, U extends FirebaseServerAuthUserContext = FirebaseServerAuthUserContext, S extends FirebaseServerAuthService<U, C> = FirebaseServerAuthService<U, C>> implements FirebaseServerAuthContext {
+    readonly service: S;
+    readonly context: CallableContextWithAuthData;
+    private readonly _isAdmin;
+    private readonly _authRoles;
+    private readonly _userContext;
+    constructor(service: S, context: CallableContextWithAuthData);
+    get userContext(): U;
+    get isAdmin(): boolean;
+    get authRoles(): AuthRoleSet;
+    get token(): admin.auth.DecodedIdToken;
+    get claims(): AuthClaims;
+    get uid(): string;
+}
+/**
+ * FirebaseServer auth service that provides accessors to auth-related components.
+ */
+export declare abstract class FirebaseServerAuthService<U extends FirebaseServerAuthUserContext = FirebaseServerAuthUserContext, C extends FirebaseServerAuthContext = FirebaseServerAuthContext> {
+    abstract readonly auth: admin.auth.Auth;
+    /**
+     * Creates a context with the input CallableContext. This creation also asserts that a uid is available to the request.
+     *
+     * If the input context is not a CallableContextWithAuthData, an exception is thrown.
+     *
+     * @param context
+     */
+    abstract context(context: functions.https.CallableContext): C;
+    /**
+     * Creates a FirebaseServerAuthUserContext instance for the input uid.
+     *
+     * The user's existence is not checked.
+     *
+     * @param uid
+     */
+    abstract userContext(uid: FirebaseAuthUserId): U;
+    /**
+     * Whether or not the input claims indicate admin priviledges.
+     */
+    abstract isAdmin(claims: AuthClaims): boolean;
+    /**
+     * Reads the AuthRoleSet from the input claims.
+     *
+     * @param claims
+     */
+    abstract readRoles(claims: AuthClaims): AuthRoleSet;
+    /**
+     * Creates the claims that reflect the input roles.
+     *
+     * The resultant claims value should include ALL claim values, with those that are unset to be null.
+     *
+     * @param roles
+     */
+    abstract claimsForRoles(roles: AuthRoleSet): AuthClaims;
+}
+/**
+ * Abstract FirebaseServerAuthService implementation.
+ */
+export declare abstract class AbstractFirebaseServerAuthService<U extends FirebaseServerAuthUserContext = FirebaseServerAuthUserContext, C extends FirebaseServerAuthContext<U> = FirebaseServerAuthContext<U>> implements FirebaseServerAuthService<U, C> {
+    readonly auth: admin.auth.Auth;
+    constructor(auth: admin.auth.Auth);
+    context(context: functions.https.CallableContext): C;
+    protected abstract _context(context: CallableContextWithAuthData): C;
+    abstract userContext(uid: FirebaseAuthUserId): U;
+    isAdmin(claims: AuthClaims): boolean;
+    abstract readRoles(claims: AuthClaims): AuthRoleSet;
+    abstract claimsForRoles(roles: AuthRoleSet): AuthClaims;
+}

package/src/lib/auth/auth.service.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractFirebaseServerAuthService = exports.FirebaseServerAuthService = exports.AbstractFirebaseServerAuthContext = exports.AbstractFirebaseServerAuthUserContext = void 0;
+const tslib_1 = require("tslib");
+const util_1 = require("@dereekb/util");
+const context_1 = require("../function/context");
+class AbstractFirebaseServerAuthUserContext {
+    constructor(service, uid) {
+        this.service = service;
+        this.uid = uid;
+        this._loadRecord = (0, util_1.cachedGetter)(() => this.service.auth.getUser(this.uid));
+    }
+    loadRecord() {
+        return this._loadRecord();
+    }
+    loadRoles() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const claims = yield this.loadClaims();
+            return this.service.readRoles(claims);
+        });
+    }
+    addRoles(roles) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            let claims = this._claimsForRolesChange(roles);
+            return this.updateClaims(claims);
+        });
+    }
+    removeRoles(roles) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const baseClaims = this._claimsForRolesChange(roles);
+            let claims = {};
+            (0, util_1.forEachKeyValue)(baseClaims, {
+                forEach: ([key]) => {
+                    claims[key] = null;
+                },
+                filter: util_1.KeyValueTypleValueFilter.NONE // hit all values
+            });
+            return this.updateClaims(claims);
+        });
+    }
+    _claimsForRolesChange(roles) {
+        // filter null/undefined since the claims will contain null values for claims that are not related.
+        return (0, util_1.filterNullAndUndefinedValues)(this.service.claimsForRoles((0, util_1.asSet)(roles)));
+    }
+    loadClaims() {
+        return this.loadRecord().then(x => { var _a; return (_a = x.customClaims) !== null && _a !== void 0 ? _a : {}; });
+    }
+    updateClaims(claims) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const currentClaims = yield this.loadClaims();
+            let newClaims;
+            if (currentClaims) {
+                newClaims = Object.assign(Object.assign({}, currentClaims), (0, util_1.filterUndefinedValues)(claims, false));
+                newClaims = (0, util_1.filterNullAndUndefinedValues)(newClaims);
+            }
+            else {
+                newClaims = claims;
+            }
+            return this.setClaims(newClaims);
+        });
+    }
+    clearClaims() {
+        return this.setClaims(null);
+    }
+    setClaims(claims) {
+        return this.service.auth.setCustomUserClaims(this.uid, claims).then(() => {
+            this._loadRecord.reset(); // reset the cache
+        });
+    }
+}
+exports.AbstractFirebaseServerAuthUserContext = AbstractFirebaseServerAuthUserContext;
+class AbstractFirebaseServerAuthContext {
+    constructor(service, context) {
+        this.service = service;
+        this.context = context;
+        this._isAdmin = (0, util_1.cachedGetter)(() => this.service.isAdmin(this.context.auth.token));
+        this._authRoles = (0, util_1.cachedGetter)(() => this.service.readRoles(this.context.auth.token));
+        this._userContext = (0, util_1.cachedGetter)(() => this.service.userContext(this.context.auth.uid));
+    }
+    get userContext() {
+        return this._userContext();
+    }
+    get isAdmin() {
+        return this._isAdmin();
+    }
+    get authRoles() {
+        return this._authRoles();
+    }
+    get token() {
+        return this.context.auth.token;
+    }
+    get claims() {
+        return this.context.auth.token;
+    }
+    // MARK: FirebaseServerAuthUserContext
+    get uid() {
+        return this.userContext.uid;
+    }
+}
+exports.AbstractFirebaseServerAuthContext = AbstractFirebaseServerAuthContext;
+// MARK: Service
+/**
+ * FirebaseServer auth service that provides accessors to auth-related components.
+ */
+class FirebaseServerAuthService {
+}
+exports.FirebaseServerAuthService = FirebaseServerAuthService;
+/**
+ * Abstract FirebaseServerAuthService implementation.
+ */
+class AbstractFirebaseServerAuthService {
+    constructor(auth) {
+        this.auth = auth;
+    }
+    context(context) {
+        (0, context_1.assertIsContextWithAuthData)(context);
+        context.auth.token;
+        return this._context(context);
+    }
+    isAdmin(claims) {
+        return this.readRoles(claims).has(util_1.AUTH_ADMIN_ROLE);
+    }
+}
+exports.AbstractFirebaseServerAuthService = AbstractFirebaseServerAuthService;
+//# sourceMappingURL=auth.service.js.map

package/src/lib/auth/auth.service.js.map

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

package/src/lib/auth/auth.user.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=auth.user.js.map

package/src/lib/auth/auth.user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.user.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/lib/auth/auth.user.ts"],"names":[],"mappings":""}

package/src/lib/auth/index.d.ts

@@ -0,0 +1,2 @@
+export * from './auth.service';
+export * from './auth.nest';

package/src/lib/auth/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./auth.service"), exports);
+tslib_1.__exportStar(require("./auth.nest"), exports);
+// export * from './auth.user';
+//# sourceMappingURL=index.js.map

package/src/lib/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/lib/auth/index.ts"],"names":[],"mappings":";;;AAAA,yDAA+B;AAC/B,sDAA4B;AAC5B,+BAA+B"}

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

@@ -0,0 +1,7 @@
+import * as admin from 'firebase-admin';
+import { FactoryProvider, InjectionToken } from "@nestjs/common";
+/**
+ * Nest Injection Token to access the
+ */
+export declare const FIREBASE_APP_TOKEN: InjectionToken;
+export declare function firebaseServerAppTokenProvider(useFactory: () => admin.app.App): FactoryProvider<any>;

package/src/lib/firebase/firebase.nest.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firebaseServerAppTokenProvider = exports.FIREBASE_APP_TOKEN = void 0;
+// MARK: Tokens
+/**
+ * Nest Injection Token to access the
+ */
+exports.FIREBASE_APP_TOKEN = 'FIREBASE_APP_TOKEN';
+// MARK: Firebase Admin Provider
+function firebaseServerAppTokenProvider(useFactory) {
+    return {
+        provide: exports.FIREBASE_APP_TOKEN,
+        useFactory
+    };
+}
+exports.firebaseServerAppTokenProvider = firebaseServerAppTokenProvider;
+//# sourceMappingURL=firebase.nest.js.map

package/src/lib/firebase/firebase.nest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase.nest.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/lib/firebase/firebase.nest.ts"],"names":[],"mappings":";;;AAGA,eAAe;AACf;;GAEG;AACU,QAAA,kBAAkB,GAAmB,oBAAoB,CAAC;AAEvE,gCAAgC;AAChC,SAAgB,8BAA8B,CAAC,UAA+B;IAC5E,OAAO;QACL,OAAO,EAAE,0BAAkB;QAC3B,UAAU;KACX,CAAC;AACJ,CAAC;AALD,wEAKC"}

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

@@ -0,0 +1 @@
+export * from './firebase.nest';

package/src/lib/firebase/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./firebase.nest"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/firebase/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/lib/firebase/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC"}

package/src/lib/firestore/driver.accessor.batch.d.ts

@@ -0,0 +1,31 @@
+import { DocumentReference, WriteBatch as GoogleCloudWriteBatch, DocumentSnapshot } from "@google-cloud/firestore";
+import { Observable } from "rxjs";
+import { WithFieldValue, FirestoreDocumentContext, FirestoreDocumentContextType, FirestoreDocumentDataAccessor, FirestoreDocumentDataAccessorFactory, FirestoreDocumentDeleteParams, FirestoreDocumentUpdateParams, UpdateData } from "@dereekb/firebase";
+/**
+ * FirestoreDocumentDataAccessor implementation for a batch.
+ */
+export declare class WriteBatchFirestoreDocumentDataAccessor<T> implements FirestoreDocumentDataAccessor<T> {
+    readonly batch: GoogleCloudWriteBatch;
+    readonly documentRef: DocumentReference<T>;
+    constructor(batch: GoogleCloudWriteBatch, documentRef: DocumentReference<T>);
+    stream(): Observable<DocumentSnapshot<T>>;
+    exists(): Promise<boolean>;
+    get(): Promise<DocumentSnapshot<T>>;
+    delete(params?: FirestoreDocumentDeleteParams): Promise<void>;
+    set(data: WithFieldValue<T>): Promise<void>;
+    update(data: UpdateData<T>, params?: FirestoreDocumentUpdateParams): Promise<void>;
+}
+/**
+ * Creates a new FirestoreDocumentDataAccessorFactory for a Batch.
+ *
+ * @param batch
+ * @returns
+ */
+export declare function writeBatchAccessorFactory<T>(writeBatch: GoogleCloudWriteBatch): FirestoreDocumentDataAccessorFactory<T>;
+export declare class WriteBatchFirestoreDocumentContext<T> implements FirestoreDocumentContext<T> {
+    readonly batch: GoogleCloudWriteBatch;
+    readonly contextType = FirestoreDocumentContextType.BATCH;
+    readonly accessorFactory: FirestoreDocumentDataAccessorFactory<T>;
+    constructor(batch: GoogleCloudWriteBatch);
+}
+export declare function writeBatchDocumentContext<T>(batch: GoogleCloudWriteBatch): WriteBatchFirestoreDocumentContext<T>;

package/src/lib/firestore/driver.accessor.batch.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeBatchDocumentContext = exports.WriteBatchFirestoreDocumentContext = exports.writeBatchAccessorFactory = exports.WriteBatchFirestoreDocumentDataAccessor = void 0;
+const rxjs_1 = require("rxjs");
+const firebase_1 = require("@dereekb/firebase");
+// MARK: Accessor
+/**
+ * FirestoreDocumentDataAccessor implementation for a batch.
+ */
+class WriteBatchFirestoreDocumentDataAccessor {
+    constructor(batch, documentRef) {
+        this.batch = batch;
+        this.documentRef = documentRef;
+    }
+    stream() {
+        return (0, rxjs_1.from)(this.get()); // todo
+    }
+    exists() {
+        return this.get().then(x => x.exists);
+    }
+    get() {
+        return this.documentRef.get();
+    }
+    delete(params) {
+        this.batch.delete(this.documentRef, params === null || params === void 0 ? void 0 : params.precondition);
+        return Promise.resolve();
+    }
+    set(data) {
+        this.batch.set(this.documentRef, data);
+        return Promise.resolve();
+    }
+    update(data, params) {
+        // todo: look into data typing casting more for this and the other types. Currently fails the building the demo-api app. "data as GoogleCloudUpdateData<T>"
+        // problem is related to T here being too open, but also the demo-api project shouldn't care.
+        this.batch.update(this.documentRef, data, params === null || params === void 0 ? void 0 : params.precondition);
+        return Promise.resolve();
+    }
+}
+exports.WriteBatchFirestoreDocumentDataAccessor = WriteBatchFirestoreDocumentDataAccessor;
+/**
+ * Creates a new FirestoreDocumentDataAccessorFactory for a Batch.
+ *
+ * @param batch
+ * @returns
+ */
+function writeBatchAccessorFactory(writeBatch) {
+    return {
+        accessorFor: (ref) => new WriteBatchFirestoreDocumentDataAccessor(writeBatch, ref)
+    };
+}
+exports.writeBatchAccessorFactory = writeBatchAccessorFactory;
+// MARK: Context
+class WriteBatchFirestoreDocumentContext {
+    constructor(batch) {
+        this.batch = batch;
+        this.contextType = firebase_1.FirestoreDocumentContextType.BATCH;
+        this.accessorFactory = writeBatchAccessorFactory(this.batch);
+    }
+}
+exports.WriteBatchFirestoreDocumentContext = WriteBatchFirestoreDocumentContext;
+function writeBatchDocumentContext(batch) {
+    return new WriteBatchFirestoreDocumentContext(batch);
+}
+exports.writeBatchDocumentContext = writeBatchDocumentContext;
+//# sourceMappingURL=driver.accessor.batch.js.map

package/src/lib/firestore/driver.accessor.batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.accessor.batch.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/lib/firestore/driver.accessor.batch.ts"],"names":[],"mappings":";;;AACA,+BAAwC;AACxC,gDAA0P;AAE1P,iBAAiB;AACjB;;GAEG;AACH,MAAa,uCAAuC;IAElD,YAAqB,KAA4B,EAAW,WAAiC;QAAxE,UAAK,GAAL,KAAK,CAAuB;QAAW,gBAAW,GAAX,WAAW,CAAsB;IAAI,CAAC;IAElG,MAAM;QACJ,OAAO,IAAA,WAAI,EAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAE,OAAO;IACnC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,MAAsC;QAC3C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,YAAY,CAAC,CAAC;QAC1D,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,IAAuB;QACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,IAAmB,EAAE,MAAsC;QAChE,2JAA2J;QAC3J,6FAA6F;QAC7F,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,IAAW,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,YAAY,CAAC,CAAC;QACvE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CAEF;AAjCD,0FAiCC;AAED;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAI,UAAiC;IAC5E,OAAO;QACL,WAAW,EAAE,CAAC,GAAyB,EAAE,EAAE,CAAC,IAAI,uCAAuC,CAAC,UAAU,EAAE,GAAG,CAAC;KACzG,CAAC;AACJ,CAAC;AAJD,8DAIC;AAED,gBAAgB;AAChB,MAAa,kCAAkC;IAK7C,YAAqB,KAA4B;QAA5B,UAAK,GAAL,KAAK,CAAuB;QAHxC,gBAAW,GAAG,uCAA4B,CAAC,KAAK,CAAC;QACjD,oBAAe,GAAG,yBAAyB,CAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAEf,CAAC;CAEvD;AAPD,gFAOC;AAED,SAAgB,yBAAyB,CAAI,KAA4B;IACvE,OAAO,IAAI,kCAAkC,CAAI,KAAK,CAAC,CAAC;AAC1D,CAAC;AAFD,8DAEC"}

package/src/lib/firestore/driver.accessor.d.ts

@@ -0,0 +1,11 @@
+import { FirestoreAccessorDriver, CollectionReference, DocumentReference } from "@dereekb/firebase";
+interface DocRefForPathInput {
+    doc: (path: string) => DocumentReference;
+}
+interface CollectionRefForPathInput {
+    collection: (path: string) => CollectionReference;
+}
+export declare function collectionRefForPath<T>(start: CollectionRefForPathInput, path: string, pathSegments?: string[]): CollectionReference<T>;
+export declare function docRefForPath<T>(start: DocRefForPathInput, path?: string, pathSegments?: string[]): DocumentReference<T>;
+export declare function firestoreClientAccessorDriver(): FirestoreAccessorDriver;
+export {};