@dereekb/firebase-server 9.7.7 → 9.9.1

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [9.9.1](https://github.com/dereekb/dbx-components/compare/v9.9.0-dev...v9.9.1) (2022-09-18)
+
+
+### Bug Fixes
+
+* fixed dependencies for release ([7c57c7e](https://github.com/dereekb/dbx-components/commit/7c57c7ef5df664b8df2641fb3b50b82b3fb2c650))
+
+
+
+# [9.9.0](https://github.com/dereekb/dbx-components/compare/v9.8.0-dev...v9.9.0) (2022-09-17)
+
+
+### Features
+
+* mailgun ([#16](https://github.com/dereekb/dbx-components/issues/16)) ([9c7d4cc](https://github.com/dereekb/dbx-components/commit/9c7d4cc997e86b664ff7e2bc6e04392e650b7910))
+
+
+
+# [9.8.0](https://github.com/dereekb/dbx-components/compare/v9.7.7-dev...v9.8.0) (2022-09-15)
+
+
+### Features
+
+* added FirebaseServerNewUserService ([10d64dc](https://github.com/dereekb/dbx-components/commit/10d64dc137e533a62d7449709a93056741a840e4))
+
+
+
 ## [9.7.7](https://github.com/dereekb/dbx-components/compare/v9.7.6-dev...v9.7.7) (2022-09-12)
 
 

package/README.md

@@ -1,7 +1,6 @@
-# firebase-server
+@dereekb/firebase-server
+=======
 
-This library was generated with [Nx](https://nx.dev).
+The sources for this package are in the main [@dereekb/dbx-components](https://github.com/dereekb/dbx-components) repo. Please file issues and pull requests against that repo.
 
-## Running unit tests
-
-Run `nx test firebase-server` to execute the unit tests via [Jest](https://jestjs.io).
+License: MIT

package/mailgun/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@dereekb/firebase-server/mailgun",
+  "version": "9.9.1",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts",
+  "dependencies": {},
+  "peerDependencies": {
+    "@dereekb/nestjs/mailgun": "9.9.1",
+    "@nestjs/common": "^9.0.0",
+    "mailgun.js": "^8.0.0",
+    "form-data": "4.0.0",
+    "@dereekb/util": "9.9.1",
+    "lodash.isequal": "^4.5.0",
+    "make-error": "^1.3.0",
+    "ts-essentials": "^9.1.2",
+    "extra-set": "^2.2.11",
+    "@dereekb/nestjs": "9.9.1",
+    "@nestjs/config": "^2.0.1",
+    "@dereekb/firebase-server": "9.9.1",
+    "jsonwebtoken": "^8.0.0",
+    "@dereekb/firebase": "9.9.1",
+    "rxjs": "^7.5.0",
+    "firebase": "^9.9.2",
+    "@dereekb/rxjs": "9.9.1",
+    "ms": "^3.0.0-canary.1",
+    "@dereekb/model": "9.9.1",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.13.2",
+    "@dereekb/date": "9.9.1",
+    "date-fns": "^2.29.0",
+    "date-fns-tz": "^1.3.0",
+    "rrule": "git+https://git@github.com/dereekb/rrule#2b13b1ea881059ba2ecfec380e12ef244ef54570",
+    "@vvo/tzdb": "^6.56.0",
+    "firebase-functions": "^3.22.0",
+    "firebase-admin": "^11.0.0",
+    "@google-cloud/firestore": "^5.0.2",
+    "@nestjs/core": "^9.0.0",
+    "@nestjs/platform-express": "^9.0.0",
+    "tslib": "^2.0.0"
+  }
+}

package/mailgun/src/index.d.ts

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

package/mailgun/src/index.js

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

package/mailgun/src/index.js.map

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

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

@@ -0,0 +1,17 @@
+import { MailgunService, MailgunTemplateEmailRequest } from '@dereekb/nestjs/mailgun';
+import { AbstractFirebaseServerNewUserService, FirebaseServerAuthNewUserSetupDetails, FirebaseServerAuthService, FirebaseServerAuthUserContext } from '@dereekb/firebase-server';
+/**
+ * MailgunTemplateEmailRequest for AbstractMailgunContentFirebaseServerNewUserService.
+ *
+ * Omits the "to" input since it gets configured by the input.
+ */
+export declare type NewUserMailgunContentRequest = Omit<MailgunTemplateEmailRequest, 'to'>;
+/**
+ * Abstract FirebaseServerNewUserService implementation that sends an email to a template on Mailgun.
+ */
+export declare abstract class AbstractMailgunContentFirebaseServerNewUserService<U extends FirebaseServerAuthUserContext = FirebaseServerAuthUserContext> extends AbstractFirebaseServerNewUserService<U> {
+    readonly mailgunService: MailgunService;
+    constructor(authService: FirebaseServerAuthService<U>, mailgunService: MailgunService);
+    protected sendSetupContentToUser(user: FirebaseServerAuthNewUserSetupDetails<U>): Promise<void>;
+    protected abstract buildNewUserMailgunContentRequest(user: FirebaseServerAuthNewUserSetupDetails<U>): Promise<NewUserMailgunContentRequest>;
+}

package/mailgun/src/lib/auth.mailgun.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractMailgunContentFirebaseServerNewUserService = void 0;
+const tslib_1 = require("tslib");
+const firebase_server_1 = require("@dereekb/firebase-server");
+/**
+ * Abstract FirebaseServerNewUserService implementation that sends an email to a template on Mailgun.
+ */
+class AbstractMailgunContentFirebaseServerNewUserService extends firebase_server_1.AbstractFirebaseServerNewUserService {
+    constructor(authService, mailgunService) {
+        super(authService);
+        this.mailgunService = mailgunService;
+    }
+    sendSetupContentToUser(user) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const userRecord = yield user.userContext.loadRecord();
+            const { setupPassword } = user.claims;
+            const { uid, displayName, email } = userRecord;
+            if (!email) {
+                throw new Error(`Email is not present/available for the user record "${userRecord.uid}"`);
+            }
+            const baseRequest = yield this.buildNewUserMailgunContentRequest(user);
+            yield this.mailgunService.sendTemplateEmail(Object.assign(Object.assign({}, baseRequest), { to: {
+                    email,
+                    userVariables: {
+                        uid,
+                        displayName,
+                        setupPassword
+                    }
+                } }));
+        });
+    }
+}
+exports.AbstractMailgunContentFirebaseServerNewUserService = AbstractMailgunContentFirebaseServerNewUserService;
+//# sourceMappingURL=auth.mailgun.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.mailgun.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/mailgun/src/lib/auth.mailgun.ts"],"names":[],"mappings":";;;;AACA,8DAAiL;AASjL;;GAEG;AACH,MAAsB,kDAA4H,SAAQ,sDAAuC;IAC/L,YAAY,WAAyC,EAAW,cAA8B;QAC5F,KAAK,CAAC,WAAW,CAAC,CAAC;QAD2C,mBAAc,GAAd,cAAc,CAAgB;IAE9F,CAAC;IAEe,sBAAsB,CAAC,IAA8C;;YACnF,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;YACvD,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;YACtC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;YAE/C,IAAI,CAAC,KAAK,EAAE;gBACV,MAAM,IAAI,KAAK,CAAC,uDAAuD,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC;aAC3F;YAED,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC;YACvE,MAAM,IAAI,CAAC,cAAc,CAAC,iBAAiB,iCACtC,WAAW,KACd,EAAE,EAAE;oBACF,KAAK;oBACL,aAAa,EAAE;wBACb,GAAG;wBACH,WAAW;wBACX,aAAa;qBACd;iBACF,IACD,CAAC;QACL,CAAC;KAAA;CAGF;AA7BD,gHA6BC"}

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

@@ -0,0 +1 @@
+export * from './auth.mailgun';

package/mailgun/src/lib/index.js

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

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

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

package/package.json

@@ -1,25 +1,25 @@
 {
   "name": "@dereekb/firebase-server",
-  "version": "9.7.7",
+  "version": "9.9.1",
   "devDependencies": {
     "firebase-functions-test": "2.0.2"
   },
   "peerDependencies": {
     "jsonwebtoken": "^8.0.0",
-    "@dereekb/firebase": "9.7.7",
+    "@dereekb/firebase": "9.9.1",
     "rxjs": "^7.5.0",
     "firebase": "^9.9.2",
-    "@dereekb/util": "9.7.7",
+    "@dereekb/util": "9.9.1",
     "lodash.isequal": "^4.5.0",
     "make-error": "^1.3.0",
     "ts-essentials": "^9.1.2",
     "extra-set": "^2.2.11",
-    "@dereekb/rxjs": "9.7.7",
+    "@dereekb/rxjs": "9.9.1",
     "ms": "^3.0.0-canary.1",
-    "@dereekb/model": "9.7.7",
+    "@dereekb/model": "9.9.1",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.13.2",
-    "@dereekb/date": "9.7.7",
+    "@dereekb/date": "9.9.1",
     "date-fns": "^2.29.0",
     "date-fns-tz": "^1.3.0",
     "rrule": "git+https://git@github.com/dereekb/rrule#2b13b1ea881059ba2ecfec380e12ef244ef54570",
@@ -30,7 +30,7 @@
     "@nestjs/common": "^9.0.0",
     "@nestjs/core": "^9.0.0",
     "@nestjs/platform-express": "^9.0.0",
-    "@dereekb/nestjs": "9.7.7",
+    "@dereekb/nestjs": "9.9.1",
     "@nestjs/config": "^2.0.1",
     "tslib": "^2.0.0"
   },
@@ -44,6 +44,11 @@
       "main": "./test/index.js",
       "types": "./test/index.d.ts",
       "default": "./test/index.js"
+    },
+    "./mailgun": {
+      "main": "./mailgun/index.js",
+      "types": "./mailgun/index.d.ts",
+      "default": "./mailgun/index.js"
     }
   },
   "main": "./src/index.js",

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

@@ -1,7 +1,7 @@
 import * as functions from 'firebase-functions';
 import * as admin from 'firebase-admin';
 import { FirebaseAuthContextInfo, FirebaseAuthUserId } from '@dereekb/firebase';
-import { AuthClaims, AuthRoleSet, ArrayOrValue, AuthRole, AuthClaimsUpdate, AuthClaimsObject, Maybe } from '@dereekb/util';
+import { ISO8601DateString, Milliseconds, AuthClaims, AuthRoleSet, ArrayOrValue, AuthRole, AuthClaimsUpdate, AuthClaimsObject, Maybe, EmailAddress, E164PhoneNumber, PasswordString } from '@dereekb/util';
 import { CallableContextWithAuthData } from '../function/context';
 import { AuthDataRef } from './auth.context';
 export interface FirebaseServerAuthUserIdentifierContext {
@@ -11,6 +11,10 @@ export interface FirebaseServerAuthUserIdentifierContext {
     readonly uid: FirebaseAuthUserId;
 }
 export interface FirebaseServerAuthUserContext extends FirebaseServerAuthUserIdentifierContext {
+    /**
+     * Returns true if the user exists.
+     */
+    exists(): Promise<boolean>;
     /**
      * Loads the record of the user.
      */
@@ -48,13 +52,13 @@ export interface FirebaseServerAuthUserContext extends FirebaseServerAuthUserIde
      *
      * @param claims
      */
-    updateClaims(claims: AuthClaimsUpdate): Promise<void>;
+    updateClaims<T extends AuthClaimsObject = AuthClaimsObject>(claims: AuthClaimsUpdate<T>): Promise<void>;
     /**
      * Sets the claims for a user. All previous claims are cleared.
      *
      * @param claims
      */
-    setClaims(claims: AuthClaimsUpdate): Promise<void>;
+    setClaims<T extends AuthClaimsObject = AuthClaimsObject>(claims: AuthClaimsUpdate<T>): Promise<void>;
     /**
      * Clears all claims for the user.
      *
@@ -67,6 +71,7 @@ export declare abstract class AbstractFirebaseServerAuthUserContext<S extends Fi
     readonly uid: FirebaseAuthUserId;
     private readonly _loadRecord;
     constructor(service: S, uid: FirebaseAuthUserId);
+    exists(): Promise<boolean>;
     loadRecord(): Promise<admin.auth.UserRecord>;
     loadRoles(): Promise<AuthRoleSet>;
     addRoles(roles: ArrayOrValue<AuthRole>): Promise<void>;
@@ -78,9 +83,9 @@ export declare abstract class AbstractFirebaseServerAuthUserContext<S extends Fi
         [x: symbol]: null;
     }>;
     loadClaims<T extends AuthClaimsObject = AuthClaimsObject>(): Promise<AuthClaims<T>>;
-    updateClaims(claims: AuthClaimsUpdate): Promise<void>;
+    updateClaims<T extends AuthClaimsObject = AuthClaimsObject>(claims: AuthClaimsUpdate<T>): Promise<void>;
     clearClaims(): Promise<void>;
-    setClaims(claims: AuthClaimsUpdate | null): Promise<void>;
+    setClaims<T extends AuthClaimsObject = AuthClaimsObject>(claims: AuthClaimsUpdate<T> | null): Promise<void>;
 }
 export interface FirebaseServerAuthContext<U extends FirebaseServerAuthUserContext = FirebaseServerAuthUserContext> extends FirebaseServerAuthUserIdentifierContext {
     /**
@@ -128,6 +133,94 @@ export declare abstract class AbstractFirebaseServerAuthContext<C extends Fireba
     get claims(): AuthClaims;
     get uid(): string;
 }
+export declare const FIREBASE_SERVER_AUTH_CLAIMS_SETUP_PASSWORD_KEY = "setupPassword";
+export declare const FIREBASE_SERVER_AUTH_CLAIMS_SETUP_LAST_COM_DATE_KEY = "setupCommunicationAt";
+/**
+ * Password used for completing setup.
+ */
+export declare type FirebaseServerAuthSetupPassword = PasswordString;
+export interface FirebaseServerAuthNewUserClaims extends AuthClaimsObject {
+    /**
+     * Setup password time
+     */
+    setupPassword: FirebaseServerAuthSetupPassword;
+    /**
+     * Last setup communication time.
+     */
+    setupCommunicationAt: ISO8601DateString;
+}
+export interface FirebaseServerAuthInitializeNewUser {
+    /**
+     * Specific user identifier to use.
+     */
+    readonly uid?: FirebaseAuthUserId;
+    /**
+     * User's display name
+     */
+    readonly displayName?: string;
+    /**
+     * Email for the new user, if applicable.
+     */
+    readonly email?: EmailAddress;
+    /**
+     * Phone for the new user, if applicable.
+     */
+    readonly phone?: E164PhoneNumber;
+    /**
+     * Password to set on the user if not created yet.
+     *
+     * This is a setup password and should not be the user's permenant/final password.
+     */
+    readonly setupPassword?: FirebaseServerAuthSetupPassword;
+    /**
+     * Whether or not to send a setup email. Is true by default.
+     */
+    readonly sendSetupContent?: boolean;
+}
+export interface FirebaseServerAuthCreateNewUserResult {
+    readonly user: admin.auth.UserRecord;
+    readonly password: FirebaseServerAuthSetupPassword;
+}
+export interface FirebaseServerAuthNewUserSetupDetails<U extends FirebaseServerAuthUserContext = FirebaseServerAuthUserContext> {
+    readonly userContext: U;
+    readonly claims: FirebaseServerAuthNewUserClaims;
+}
+export interface FirebaseServerNewUserService {
+    initializeNewUser(input: FirebaseServerAuthInitializeNewUser): Promise<admin.auth.UserRecord>;
+    sendSetupContent(uid: FirebaseAuthUserId): Promise<boolean>;
+    markUserSetupAsComplete(uid: FirebaseAuthUserId): Promise<boolean>;
+}
+export declare const DEFAULT_FIREBASE_PASSWORD_NUMBER_GENERATOR: import("@dereekb/util").RandomNumberFactory;
+export declare const DEFAULT_SETUP_COM_THROTTLE_TIME: number;
+export declare abstract class AbstractFirebaseServerNewUserService<U extends FirebaseServerAuthUserContext = FirebaseServerAuthUserContext, C extends FirebaseServerAuthContext = FirebaseServerAuthContext> implements FirebaseServerNewUserService {
+    readonly authService: FirebaseServerAuthService<U, C>;
+    protected setupThrottleTime: Milliseconds;
+    constructor(authService: FirebaseServerAuthService<U, C>);
+    initializeNewUser(input: FirebaseServerAuthInitializeNewUser): Promise<admin.auth.UserRecord>;
+    /**
+     * Sends the setup content to the user. Returns true if content was sent or was already recently sent.
+     *
+     * @param uid
+     */
+    sendSetupContent(uid: FirebaseAuthUserId): Promise<boolean>;
+    loadSetupDetails(uid: FirebaseAuthUserId): Promise<Maybe<FirebaseServerAuthNewUserSetupDetails<U>>>;
+    protected updateSetupContentSentTime(details: FirebaseServerAuthNewUserSetupDetails<U>): Promise<void>;
+    /**
+     * Update a user's claims to clear any setup-related content.
+     *
+     * Returns true if a user was updated.
+     *
+     * @param uid
+     */
+    markUserSetupAsComplete(uid: FirebaseAuthUserId): Promise<boolean>;
+    protected createNewUser(input: FirebaseServerAuthInitializeNewUser): Promise<FirebaseServerAuthCreateNewUserResult>;
+    protected generateRandomSetupPassword(): FirebaseServerAuthSetupPassword;
+    protected abstract sendSetupContentToUser(user: FirebaseServerAuthNewUserSetupDetails<U>): Promise<void>;
+    protected updateClaimsToClearUser(userContext: U): Promise<void>;
+}
+export declare class NoSetupContentFirebaseServerNewUserService<U extends FirebaseServerAuthUserContext = FirebaseServerAuthUserContext> extends AbstractFirebaseServerNewUserService<U> {
+    protected sendSetupContentToUser(user: FirebaseServerAuthNewUserSetupDetails<U>): Promise<void>;
+}
 /**
  * Reference to a FirebaseServerAuthService
  */
@@ -199,6 +292,10 @@ export declare abstract class FirebaseServerAuthService<U extends FirebaseServer
      * @param context
      */
     abstract authContextInfo(context: AuthDataRef): Maybe<FirebaseAuthContextInfo>;
+    /**
+     * Returns the new user service to create a new user programmatically.
+     */
+    abstract newUser(): FirebaseServerNewUserService;
 }
 /**
  * Abstract FirebaseServerAuthService implementation.
@@ -215,5 +312,6 @@ export declare abstract class AbstractFirebaseServerAuthService<U extends Fireba
     hasSignedTosInRoles(roles: AuthRoleSet): boolean;
     abstract readRoles(claims: AuthClaims): AuthRoleSet;
     abstract claimsForRoles(roles: AuthRoleSet): AuthClaimsUpdate;
+    newUser(): FirebaseServerNewUserService;
     authContextInfo(context: AuthDataRef): Maybe<FirebaseAuthContextInfo>;
 }

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

@@ -1,16 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractFirebaseServerAuthService = exports.FirebaseServerAuthService = exports.AbstractFirebaseServerAuthContext = exports.AbstractFirebaseServerAuthUserContext = void 0;
+exports.AbstractFirebaseServerAuthService = exports.FirebaseServerAuthService = exports.NoSetupContentFirebaseServerNewUserService = exports.AbstractFirebaseServerNewUserService = exports.DEFAULT_SETUP_COM_THROTTLE_TIME = exports.DEFAULT_FIREBASE_PASSWORD_NUMBER_GENERATOR = exports.FIREBASE_SERVER_AUTH_CLAIMS_SETUP_LAST_COM_DATE_KEY = exports.FIREBASE_SERVER_AUTH_CLAIMS_SETUP_PASSWORD_KEY = exports.AbstractFirebaseServerAuthContext = exports.AbstractFirebaseServerAuthUserContext = void 0;
 const tslib_1 = require("tslib");
 const util_1 = require("@dereekb/util");
 const context_1 = require("../function/context");
 const auth_context_1 = require("./auth.context");
+const date_1 = require("@dereekb/date");
+const auth_util_1 = require("./auth.util");
 class AbstractFirebaseServerAuthUserContext {
     constructor(service, uid) {
         this.service = service;
         this.uid = uid;
         this._loadRecord = (0, util_1.cachedGetter)(() => this.service.auth.getUser(this.uid));
     }
+    exists() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return (0, auth_util_1.getAuthUserOrUndefined)(this._loadRecord()).then((x) => Boolean(x));
+        });
+    }
     loadRecord() {
         return this._loadRecord();
     }
@@ -109,6 +116,150 @@ class AbstractFirebaseServerAuthContext {
     }
 }
 exports.AbstractFirebaseServerAuthContext = AbstractFirebaseServerAuthContext;
+// MARK: New Account Initialization
+exports.FIREBASE_SERVER_AUTH_CLAIMS_SETUP_PASSWORD_KEY = 'setupPassword';
+exports.FIREBASE_SERVER_AUTH_CLAIMS_SETUP_LAST_COM_DATE_KEY = 'setupCommunicationAt';
+exports.DEFAULT_FIREBASE_PASSWORD_NUMBER_GENERATOR = (0, util_1.randomNumberFactory)({ min: 100000, max: 1000000 - 1 });
+exports.DEFAULT_SETUP_COM_THROTTLE_TIME = (0, date_1.hoursToMs)(1);
+class AbstractFirebaseServerNewUserService {
+    constructor(authService) {
+        this.authService = authService;
+        this.setupThrottleTime = exports.DEFAULT_SETUP_COM_THROTTLE_TIME;
+    }
+    initializeNewUser(input) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { uid, displayName, email, phone, sendSetupContent: sendSetupEmail } = input;
+            let userRecordPromise;
+            if (uid) {
+                userRecordPromise = this.authService.auth.getUser(uid);
+            }
+            else if (email) {
+                userRecordPromise = this.authService.auth.getUserByEmail(email);
+            }
+            else if (phone) {
+                userRecordPromise = this.authService.auth.getUserByPhoneNumber(phone);
+            }
+            else {
+                throw new Error('email or phone is required to initialize a new user.');
+            }
+            let userRecord = yield (0, auth_util_1.getAuthUserOrUndefined)(userRecordPromise);
+            if (!userRecord) {
+                const createResult = yield this.createNewUser(input);
+                // add the setup password to the user's credentials
+                const userContext = this.authService.userContext(createResult.user.uid);
+                yield userContext.updateClaims({
+                    [exports.FIREBASE_SERVER_AUTH_CLAIMS_SETUP_PASSWORD_KEY]: createResult.password
+                });
+                if (sendSetupEmail !== false) {
+                    yield this.sendSetupContent(createResult.user.uid);
+                }
+                // return the new record
+                userRecord = yield userContext.loadRecord();
+            }
+            return userRecord;
+        });
+    }
+    /**
+     * Sends the setup content to the user. Returns true if content was sent or was already recently sent.
+     *
+     * @param uid
+     */
+    sendSetupContent(uid) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const setupDetails = yield this.loadSetupDetails(uid);
+            if (setupDetails) {
+                const { setupCommunicationAt } = setupDetails.claims;
+                if (!setupCommunicationAt || (0, date_1.timeHasExpired)(new Date(setupCommunicationAt), this.setupThrottleTime)) {
+                    yield this.sendSetupContentToUser(setupDetails);
+                    yield this.updateSetupContentSentTime(setupDetails);
+                }
+            }
+            return false;
+        });
+    }
+    loadSetupDetails(uid) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const userContext = this.authService.userContext(uid);
+            const userExists = yield userContext.exists();
+            let details;
+            if (userExists) {
+                const { setupPassword, setupCommunicationAt } = yield userContext.loadClaims();
+                if (setupPassword) {
+                    details = {
+                        userContext,
+                        claims: {
+                            setupPassword,
+                            setupCommunicationAt
+                        }
+                    };
+                }
+            }
+            return details;
+        });
+    }
+    updateSetupContentSentTime(details) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            yield details.userContext.updateClaims({
+                setupCommunicationAt: (0, date_1.toISODateString)(new Date())
+            });
+        });
+    }
+    /**
+     * Update a user's claims to clear any setup-related content.
+     *
+     * Returns true if a user was updated.
+     *
+     * @param uid
+     */
+    markUserSetupAsComplete(uid) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const userContext = this.authService.userContext(uid);
+            const userExists = yield userContext.exists();
+            if (userExists) {
+                yield this.updateClaimsToClearUser(userContext);
+            }
+            return userExists;
+        });
+    }
+    createNewUser(input) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { uid, displayName, email, phone: phoneNumber, setupPassword: inputPassword } = input;
+            const password = inputPassword !== null && inputPassword !== void 0 ? inputPassword : this.generateRandomSetupPassword();
+            const user = yield this.authService.auth.createUser({
+                uid,
+                displayName,
+                email,
+                phoneNumber,
+                password
+            });
+            return {
+                user,
+                password
+            };
+        });
+    }
+    generateRandomSetupPassword() {
+        const x = (0, exports.DEFAULT_FIREBASE_PASSWORD_NUMBER_GENERATOR)();
+        return `${x}`;
+    }
+    updateClaimsToClearUser(userContext) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            yield userContext.updateClaims({
+                [exports.FIREBASE_SERVER_AUTH_CLAIMS_SETUP_PASSWORD_KEY]: null,
+                [exports.FIREBASE_SERVER_AUTH_CLAIMS_SETUP_LAST_COM_DATE_KEY]: null
+            });
+        });
+    }
+}
+exports.AbstractFirebaseServerNewUserService = AbstractFirebaseServerNewUserService;
+class NoSetupContentFirebaseServerNewUserService extends AbstractFirebaseServerNewUserService {
+    sendSetupContentToUser(user) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            // send nothing.
+        });
+    }
+}
+exports.NoSetupContentFirebaseServerNewUserService = NoSetupContentFirebaseServerNewUserService;
 /**
  * FirebaseServer auth service that provides accessors to auth-related components.
  */
@@ -138,6 +289,9 @@ class AbstractFirebaseServerAuthService {
     hasSignedTosInRoles(roles) {
         return roles.has(util_1.AUTH_TOS_SIGNED_ROLE);
     }
+    newUser() {
+        return new NoSetupContentFirebaseServerNewUserService(this);
+    }
     authContextInfo(context) {
         const { auth } = context;
         let result;

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

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

@@ -0,0 +1,8 @@
+import { Maybe } from '@dereekb/util';
+import * as admin from 'firebase-admin';
+/**
+ * Awaits the load result from the input promise. If it encounters a FIREBASE_AUTH_USER_NOT_FOUND_ERROR, then returns undefined. Throws the error otherwise.
+ * @param promise
+ * @returns
+ */
+export declare function getAuthUserOrUndefined(promise: Promise<admin.auth.UserRecord>): Promise<Maybe<admin.auth.UserRecord>>;

package/src/lib/auth/auth.util.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAuthUserOrUndefined = void 0;
+const tslib_1 = require("tslib");
+const firebase_1 = require("@dereekb/firebase");
+/**
+ * Awaits the load result from the input promise. If it encounters a FIREBASE_AUTH_USER_NOT_FOUND_ERROR, then returns undefined. Throws the error otherwise.
+ * @param promise
+ * @returns
+ */
+function getAuthUserOrUndefined(promise) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        try {
+            return yield promise;
+        }
+        catch (error) {
+            if ((error === null || error === void 0 ? void 0 : error.code) === firebase_1.FIREBASE_AUTH_USER_NOT_FOUND_ERROR) {
+                return undefined;
+            }
+            else {
+                throw error;
+            }
+        }
+    });
+}
+exports.getAuthUserOrUndefined = getAuthUserOrUndefined;
+//# sourceMappingURL=auth.util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.util.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/lib/auth/auth.util.ts"],"names":[],"mappings":";;;;AAAA,gDAA0F;AAI1F;;;;GAIG;AACH,SAAsB,sBAAsB,CAAC,OAAuC;;QAClF,IAAI;YACF,OAAO,MAAM,OAAO,CAAC;SACtB;QAAC,OAAO,KAAc,EAAE;YACvB,IAAI,CAAC,KAA2B,aAA3B,KAAK,uBAAL,KAAK,CAAwB,IAAI,MAAK,6CAAkC,EAAE;gBAC7E,OAAO,SAAS,CAAC;aAClB;iBAAM;gBACL,MAAM,KAAK,CAAC;aACb;SACF;IACH,CAAC;CAAA;AAVD,wDAUC"}