@dereekb/firebase-server 13.4.0 → 13.4.1

package/index.cjs.js

@@ -612,6 +612,63 @@ function _is_native_reflect_construct$5() {
         return !!result;
     })();
 }
+/**
+ * Thrown by {@link AbstractFirebaseServerNewUserService.createNewUser} when Firebase Auth rejects
+ * user creation because the provided phone number or email is already associated with another account.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await newUserService.initializeNewUser({ email, phone });
+ * } catch (e) {
+ *   if (e instanceof FirebaseServerAuthUserExistsError && e.identifierType === 'phone') {
+ *     const existingUser = await auth.getUserByPhoneNumber(e.identifierValue);
+ *   }
+ * }
+ * ```
+ */ var FirebaseServerAuthUserExistsError = /*#__PURE__*/ function(BaseError) {
+    _inherits$5(FirebaseServerAuthUserExistsError, BaseError);
+    function FirebaseServerAuthUserExistsError(code, identifierType, identifierValue) {
+        _class_call_check$o(this, FirebaseServerAuthUserExistsError);
+        var _this;
+        _this = _call_super$5(this, FirebaseServerAuthUserExistsError, [
+            "A user with the provided ".concat(identifierType, " already exists.")
+        ]), _define_property$s(_this, "code", void 0), _define_property$s(_this, "identifierType", void 0), _define_property$s(_this, "identifierValue", void 0);
+        _this.code = code;
+        _this.identifierType = identifierType;
+        _this.identifierValue = identifierValue;
+        return _this;
+    }
+    return FirebaseServerAuthUserExistsError;
+}(makeError.BaseError);
+/**
+ * Thrown by {@link AbstractFirebaseServerNewUserService.createNewUser} when Firebase Auth rejects
+ * user creation due to invalid input (e.g., a malformed phone number).
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await newUserService.initializeNewUser({ email, phone: 'not-e164' });
+ * } catch (e) {
+ *   if (e instanceof FirebaseServerAuthUserBadInputError) {
+ *     console.log(`Bad input (${e.code}): ${e.inputValue}`);
+ *   }
+ * }
+ * ```
+ */ var FirebaseServerAuthUserBadInputError = /*#__PURE__*/ function(BaseError) {
+    _inherits$5(FirebaseServerAuthUserBadInputError, BaseError);
+    function FirebaseServerAuthUserBadInputError(code, inputValue, message) {
+        _class_call_check$o(this, FirebaseServerAuthUserBadInputError);
+        var _this;
+        _this = _call_super$5(this, FirebaseServerAuthUserBadInputError, [
+            message !== null && message !== void 0 ? message : "Invalid input for user creation: ".concat(inputValue)
+        ]), _define_property$s(_this, "code", void 0), _define_property$s(_this, "inputValue", void 0);
+        _this.code = code;
+        _this.inputValue = inputValue;
+        return _this;
+    }
+    return FirebaseServerAuthUserBadInputError;
+}(makeError.BaseError);
 /**
  * Thrown by sendSetupDetails() if the user has no setup configuration available, meaning they probably already have accepted their invite or is in an invalid state.
  */ var FirebaseServerAuthNewUserSendSetupDetailsNoSetupConfigError = /*#__PURE__*/ function(BaseError) {
@@ -1770,12 +1827,20 @@ function _ts_generator$b(thisArg, body) {
      * @throws Throws if the Firebase Admin SDK rejects the user creation.
      */ function createNewUser(input) {
                 return _async_to_generator$b(function() {
-                    var uid, displayName, email, phoneNumber, inputPassword, password, user;
+                    var uid, displayName, email, phoneNumber, inputPassword, password, user, e, firebaseError, errorCode;
                     return _ts_generator$b(this, function(_state) {
                         switch(_state.label){
                             case 0:
                                 uid = input.uid, displayName = input.displayName, email = input.email, phoneNumber = input.phone, inputPassword = input.setupPassword;
                                 password = inputPassword !== null && inputPassword !== void 0 ? inputPassword : this.generateRandomSetupPassword();
+                                _state.label = 1;
+                            case 1:
+                                _state.trys.push([
+                                    1,
+                                    3,
+                                    ,
+                                    4
+                                ]);
                                 return [
                                     4,
                                     this.authService.auth.createUser({
@@ -1786,8 +1851,25 @@ function _ts_generator$b(thisArg, body) {
                                         password: password
                                     })
                                 ];
-                            case 1:
+                            case 2:
                                 user = _state.sent();
+                                return [
+                                    3,
+                                    4
+                                ];
+                            case 3:
+                                e = _state.sent();
+                                firebaseError = e;
+                                errorCode = firebaseError === null || firebaseError === void 0 ? void 0 : firebaseError.code;
+                                if (errorCode === firebase.FIREBASE_AUTH_PHONE_NUMBER_ALREADY_EXISTS_ERROR && phoneNumber) {
+                                    throw new FirebaseServerAuthUserExistsError(errorCode, 'phone', phoneNumber);
+                                } else if (errorCode === firebase.FIREBASE_AUTH_EMAIL_ALREADY_EXISTS_ERROR && email) {
+                                    throw new FirebaseServerAuthUserExistsError(errorCode, 'email', email);
+                                } else if (errorCode === firebase.FIREBASE_AUTH_INVALID_PHONE_NUMBER_ERROR && phoneNumber) {
+                                    throw new FirebaseServerAuthUserBadInputError(errorCode, phoneNumber);
+                                }
+                                throw e;
+                            case 4:
                                 return [
                                     2,
                                     {
@@ -3492,7 +3574,7 @@ function _ts_generator$9(thisArg, body) {
  */ function handleFirebaseAuthError(e, handleUnknownCode) {
     handleFirebaseError(e, function(firebaseError) {
         switch(firebaseError.code){
-            case 'auth/phone-number-already-exists':
+            case firebase.FIREBASE_AUTH_PHONE_NUMBER_ALREADY_EXISTS_ERROR:
                 throw phoneNumberAlreadyExistsError();
             default:
                 handleUnknownCode === null || handleUnknownCode === void 0 ? void 0 : handleUnknownCode(firebaseError);
@@ -9399,16 +9481,24 @@ function _ts_generator(thisArg, body) {
 /**
  * Abstract class that wraps an INestApplicationContext value.
  */ var AbstractNestContext = /*#__PURE__*/ function() {
-    function AbstractNestContext(nest) {
+    function AbstractNestContext(nestApplication) {
         _class_call_check$1(this, AbstractNestContext);
-        _define_property$1(this, "_nest", void 0);
-        this._nest = nest;
+        _define_property$1(this, "_nestApplication", void 0);
+        this._nestApplication = nestApplication;
     }
     _create_class$1(AbstractNestContext, [
         {
             key: "nest",
+            get: /**
+     * @deprecated use nestApplication instead.
+     */ function get() {
+                return this._nestApplication;
+            }
+        },
+        {
+            key: "nestApplication",
             get: function get() {
-                return this._nest;
+                return this._nestApplication;
             }
         }
     ]);
@@ -9604,6 +9694,8 @@ exports.FirebaseServerAuthNewUserSendSetupDetailsNoSetupConfigError = FirebaseSe
 exports.FirebaseServerAuthNewUserSendSetupDetailsSendOnceError = FirebaseServerAuthNewUserSendSetupDetailsSendOnceError;
 exports.FirebaseServerAuthNewUserSendSetupDetailsThrottleError = FirebaseServerAuthNewUserSendSetupDetailsThrottleError;
 exports.FirebaseServerAuthService = FirebaseServerAuthService;
+exports.FirebaseServerAuthUserBadInputError = FirebaseServerAuthUserBadInputError;
+exports.FirebaseServerAuthUserExistsError = FirebaseServerAuthUserExistsError;
 exports.FirebaseServerEnvService = FirebaseServerEnvService;
 exports.FirebaseServerStorageService = FirebaseServerStorageService;
 exports.GlobalRoutePrefixConfig = GlobalRoutePrefixConfig;

package/index.esm.js

@@ -1,4 +1,4 @@
-import { DBX_FIREBASE_SERVER_NO_AUTH_ERROR_CODE, FIREBASE_AUTH_USER_NOT_FOUND_ERROR, FIREBASE_SERVER_AUTH_CLAIMS_RESET_PASSWORD_KEY, FIREBASE_SERVER_AUTH_CLAIMS_RESET_LAST_COM_DATE_KEY, FIREBASE_SERVER_AUTH_CLAIMS_SETUP_PASSWORD_KEY, FIREBASE_SERVER_AUTH_CLAIMS_SETUP_LAST_COM_DATE_KEY, FirestoreDocumentContextType, streamFromOnSnapshot, makeFirestoreQueryConstraintFunctionsDriver, FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE, FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE, FIRESTORE_ORDER_BY_QUERY_CONSTRAINT_TYPE, FIRESTORE_ORDER_BY_DOCUMENT_ID_QUERY_CONSTRAINT_TYPE, FIRESTORE_WHERE_QUERY_CONSTRAINT_TYPE, FIRESTORE_WHERE_DOCUMENT_ID_QUERY_CONSTRAINT_TYPE, FIRESTORE_OFFSET_QUERY_CONSTRAINT_TYPE, FIRESTORE_START_AT_QUERY_CONSTRAINT_TYPE, FIRESTORE_START_AT_VALUE_QUERY_CONSTRAINT_TYPE, FIRESTORE_START_AFTER_QUERY_CONSTRAINT_TYPE, FIRESTORE_END_AT_QUERY_CONSTRAINT_TYPE, FIRESTORE_END_AT_VALUE_QUERY_CONSTRAINT_TYPE, FIRESTORE_END_BEFORE_QUERY_CONSTRAINT_TYPE, firestoreContextFactory, firestoreField, optionalFirestoreField, setIdAndKeyFromKeyIdRefOnDocumentData, MODEL_FUNCTION_FIREBASE_CRUD_FUNCTION_SPECIFIER_DEFAULT, SCHEDULED_FUNCTION_DEV_FUNCTION_SPECIFIER, storageListFilesResultFactory, assertStorageUploadOptionsStringFormat, firebaseStorageContextFactory, inContextFirebaseModelsServiceFactory, useFirebaseModelsService } from '@dereekb/firebase';
+import { DBX_FIREBASE_SERVER_NO_AUTH_ERROR_CODE, FIREBASE_AUTH_USER_NOT_FOUND_ERROR, FIREBASE_SERVER_AUTH_CLAIMS_RESET_PASSWORD_KEY, FIREBASE_SERVER_AUTH_CLAIMS_RESET_LAST_COM_DATE_KEY, FIREBASE_SERVER_AUTH_CLAIMS_SETUP_PASSWORD_KEY, FIREBASE_AUTH_PHONE_NUMBER_ALREADY_EXISTS_ERROR, FIREBASE_AUTH_EMAIL_ALREADY_EXISTS_ERROR, FIREBASE_AUTH_INVALID_PHONE_NUMBER_ERROR, FIREBASE_SERVER_AUTH_CLAIMS_SETUP_LAST_COM_DATE_KEY, FirestoreDocumentContextType, streamFromOnSnapshot, makeFirestoreQueryConstraintFunctionsDriver, FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE, FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE, FIRESTORE_ORDER_BY_QUERY_CONSTRAINT_TYPE, FIRESTORE_ORDER_BY_DOCUMENT_ID_QUERY_CONSTRAINT_TYPE, FIRESTORE_WHERE_QUERY_CONSTRAINT_TYPE, FIRESTORE_WHERE_DOCUMENT_ID_QUERY_CONSTRAINT_TYPE, FIRESTORE_OFFSET_QUERY_CONSTRAINT_TYPE, FIRESTORE_START_AT_QUERY_CONSTRAINT_TYPE, FIRESTORE_START_AT_VALUE_QUERY_CONSTRAINT_TYPE, FIRESTORE_START_AFTER_QUERY_CONSTRAINT_TYPE, FIRESTORE_END_AT_QUERY_CONSTRAINT_TYPE, FIRESTORE_END_AT_VALUE_QUERY_CONSTRAINT_TYPE, FIRESTORE_END_BEFORE_QUERY_CONSTRAINT_TYPE, firestoreContextFactory, firestoreField, optionalFirestoreField, setIdAndKeyFromKeyIdRefOnDocumentData, MODEL_FUNCTION_FIREBASE_CRUD_FUNCTION_SPECIFIER_DEFAULT, SCHEDULED_FUNCTION_DEV_FUNCTION_SPECIFIER, storageListFilesResultFactory, assertStorageUploadOptionsStringFormat, firebaseStorageContextFactory, inContextFirebaseModelsServiceFactory, useFirebaseModelsService } from '@dereekb/firebase';
 import { partialServerError, isServerError, randomNumberFactory, cachedGetter, filterNullAndUndefinedValues, asSet, AUTH_ADMIN_ROLE, AUTH_TOS_SIGNED_ROLE, forEachKeyValue, KeyValueTypleValueFilter, filterUndefinedValues, isThrottled, mapObjectMap, batch, objectToMap, serverError, asArray, containsAllValues, websiteUrlDetails, mergeObjects, cronExpressionRepeatingEveryNMinutes, mapIdentityFunction, slashPathName, toRelativeSlashPathStartType, fixMultiSlashesInSlashPath, SLASH_PATH_SEPARATOR, objectHasNoKeys, pushItemOrArrayItemsIntoArray, makeGetter, asGetter, build } from '@dereekb/util';
 import { HttpsError } from 'firebase-functions/https';
 import { hoursToMs, toISODateString } from '@dereekb/date';
@@ -610,6 +610,63 @@ function _is_native_reflect_construct$5() {
         return !!result;
     })();
 }
+/**
+ * Thrown by {@link AbstractFirebaseServerNewUserService.createNewUser} when Firebase Auth rejects
+ * user creation because the provided phone number or email is already associated with another account.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await newUserService.initializeNewUser({ email, phone });
+ * } catch (e) {
+ *   if (e instanceof FirebaseServerAuthUserExistsError && e.identifierType === 'phone') {
+ *     const existingUser = await auth.getUserByPhoneNumber(e.identifierValue);
+ *   }
+ * }
+ * ```
+ */ var FirebaseServerAuthUserExistsError = /*#__PURE__*/ function(BaseError) {
+    _inherits$5(FirebaseServerAuthUserExistsError, BaseError);
+    function FirebaseServerAuthUserExistsError(code, identifierType, identifierValue) {
+        _class_call_check$o(this, FirebaseServerAuthUserExistsError);
+        var _this;
+        _this = _call_super$5(this, FirebaseServerAuthUserExistsError, [
+            "A user with the provided ".concat(identifierType, " already exists.")
+        ]), _define_property$s(_this, "code", void 0), _define_property$s(_this, "identifierType", void 0), _define_property$s(_this, "identifierValue", void 0);
+        _this.code = code;
+        _this.identifierType = identifierType;
+        _this.identifierValue = identifierValue;
+        return _this;
+    }
+    return FirebaseServerAuthUserExistsError;
+}(BaseError);
+/**
+ * Thrown by {@link AbstractFirebaseServerNewUserService.createNewUser} when Firebase Auth rejects
+ * user creation due to invalid input (e.g., a malformed phone number).
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await newUserService.initializeNewUser({ email, phone: 'not-e164' });
+ * } catch (e) {
+ *   if (e instanceof FirebaseServerAuthUserBadInputError) {
+ *     console.log(`Bad input (${e.code}): ${e.inputValue}`);
+ *   }
+ * }
+ * ```
+ */ var FirebaseServerAuthUserBadInputError = /*#__PURE__*/ function(BaseError) {
+    _inherits$5(FirebaseServerAuthUserBadInputError, BaseError);
+    function FirebaseServerAuthUserBadInputError(code, inputValue, message) {
+        _class_call_check$o(this, FirebaseServerAuthUserBadInputError);
+        var _this;
+        _this = _call_super$5(this, FirebaseServerAuthUserBadInputError, [
+            message !== null && message !== void 0 ? message : "Invalid input for user creation: ".concat(inputValue)
+        ]), _define_property$s(_this, "code", void 0), _define_property$s(_this, "inputValue", void 0);
+        _this.code = code;
+        _this.inputValue = inputValue;
+        return _this;
+    }
+    return FirebaseServerAuthUserBadInputError;
+}(BaseError);
 /**
  * Thrown by sendSetupDetails() if the user has no setup configuration available, meaning they probably already have accepted their invite or is in an invalid state.
  */ var FirebaseServerAuthNewUserSendSetupDetailsNoSetupConfigError = /*#__PURE__*/ function(BaseError) {
@@ -1768,12 +1825,20 @@ function _ts_generator$b(thisArg, body) {
      * @throws Throws if the Firebase Admin SDK rejects the user creation.
      */ function createNewUser(input) {
                 return _async_to_generator$b(function() {
-                    var uid, displayName, email, phoneNumber, inputPassword, password, user;
+                    var uid, displayName, email, phoneNumber, inputPassword, password, user, e, firebaseError, errorCode;
                     return _ts_generator$b(this, function(_state) {
                         switch(_state.label){
                             case 0:
                                 uid = input.uid, displayName = input.displayName, email = input.email, phoneNumber = input.phone, inputPassword = input.setupPassword;
                                 password = inputPassword !== null && inputPassword !== void 0 ? inputPassword : this.generateRandomSetupPassword();
+                                _state.label = 1;
+                            case 1:
+                                _state.trys.push([
+                                    1,
+                                    3,
+                                    ,
+                                    4
+                                ]);
                                 return [
                                     4,
                                     this.authService.auth.createUser({
@@ -1784,8 +1849,25 @@ function _ts_generator$b(thisArg, body) {
                                         password: password
                                     })
                                 ];
-                            case 1:
+                            case 2:
                                 user = _state.sent();
+                                return [
+                                    3,
+                                    4
+                                ];
+                            case 3:
+                                e = _state.sent();
+                                firebaseError = e;
+                                errorCode = firebaseError === null || firebaseError === void 0 ? void 0 : firebaseError.code;
+                                if (errorCode === FIREBASE_AUTH_PHONE_NUMBER_ALREADY_EXISTS_ERROR && phoneNumber) {
+                                    throw new FirebaseServerAuthUserExistsError(errorCode, 'phone', phoneNumber);
+                                } else if (errorCode === FIREBASE_AUTH_EMAIL_ALREADY_EXISTS_ERROR && email) {
+                                    throw new FirebaseServerAuthUserExistsError(errorCode, 'email', email);
+                                } else if (errorCode === FIREBASE_AUTH_INVALID_PHONE_NUMBER_ERROR && phoneNumber) {
+                                    throw new FirebaseServerAuthUserBadInputError(errorCode, phoneNumber);
+                                }
+                                throw e;
+                            case 4:
                                 return [
                                     2,
                                     {
@@ -3490,7 +3572,7 @@ function _ts_generator$9(thisArg, body) {
  */ function handleFirebaseAuthError(e, handleUnknownCode) {
     handleFirebaseError(e, function(firebaseError) {
         switch(firebaseError.code){
-            case 'auth/phone-number-already-exists':
+            case FIREBASE_AUTH_PHONE_NUMBER_ALREADY_EXISTS_ERROR:
                 throw phoneNumberAlreadyExistsError();
             default:
                 handleUnknownCode === null || handleUnknownCode === void 0 ? void 0 : handleUnknownCode(firebaseError);
@@ -9397,16 +9479,24 @@ function _ts_generator(thisArg, body) {
 /**
  * Abstract class that wraps an INestApplicationContext value.
  */ var AbstractNestContext = /*#__PURE__*/ function() {
-    function AbstractNestContext(nest) {
+    function AbstractNestContext(nestApplication) {
         _class_call_check$1(this, AbstractNestContext);
-        _define_property$1(this, "_nest", void 0);
-        this._nest = nest;
+        _define_property$1(this, "_nestApplication", void 0);
+        this._nestApplication = nestApplication;
     }
     _create_class$1(AbstractNestContext, [
         {
             key: "nest",
+            get: /**
+     * @deprecated use nestApplication instead.
+     */ function get() {
+                return this._nestApplication;
+            }
+        },
+        {
+            key: "nestApplication",
             get: function get() {
-                return this._nest;
+                return this._nestApplication;
             }
         }
     ]);
@@ -9571,4 +9661,4 @@ function _define_property(obj, key, value) {
 } 
 ();
 
-export { ALREADY_EXISTS_ERROR_CODE, AbstractFirebaseNestContext, AbstractFirebaseServerActionsContext, AbstractFirebaseServerAuthContext, AbstractFirebaseServerAuthService, AbstractFirebaseServerAuthUserContext, AbstractFirebaseServerNewUserService, AbstractNestContext, AbstractServerFirebaseNestContext, BAD_REQUEST_ERROR_CODE, CONFLICT_ERROR_CODE, ConfigureFirebaseAppCheckMiddlewareModule, ConfigureFirebaseWebhookMiddlewareModule, DEFAULT_FIREBASE_PASSWORD_NUMBER_GENERATOR, DEFAULT_SETUP_COM_THROTTLE_TIME, DefaultFirebaseServerEnvService, FIREBASE_APP_TOKEN, FIREBASE_AUTH_TOKEN, FIREBASE_FIRESTORE_CONTEXT_TOKEN, FIREBASE_FIRESTORE_TOKEN, FIREBASE_SERVER_ENV_TOKEN, FIREBASE_SERVER_VALIDATION_ERROR_CODE, FIREBASE_STORAGE_CONTEXT_FACTORY_CONFIG_TOKEN, FIREBASE_STORAGE_CONTEXT_TOKEN, FIREBASE_STORAGE_TOKEN, FIRESTORE_CLIENT_QUERY_CONSTRAINT_HANDLER_MAPPING, FORBIDDEN_ERROR_CODE, FirebaseAppCheckMiddleware, FirebaseAppCheckMiddlewareConfig, FirebaseNestServerRootModule, FirebaseRawBodyMiddleware, FirebaseServerAnalyticsSegmentListenerService, FirebaseServerAnalyticsSegmentModule, FirebaseServerAnalyticsService, FirebaseServerAnalyticsServiceListener, FirebaseServerAuthModule, FirebaseServerAuthNewUserSendSetupDetailsNoSetupConfigError, FirebaseServerAuthNewUserSendSetupDetailsSendOnceError, FirebaseServerAuthNewUserSendSetupDetailsThrottleError, FirebaseServerAuthService, FirebaseServerEnvService, FirebaseServerFirestoreContextModule, FirebaseServerFirestoreModule, FirebaseServerStorageContextModule, FirebaseServerStorageModule, FirebaseServerStorageService, GlobalRoutePrefixConfig, INTERNAL_SERVER_ERROR_CODE, MODEL_NOT_AVAILABLE_ERROR_CODE, NOT_FOUND_ERROR_CODE, NO_RUN_NAME_SPECIFIED_FOR_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_CODE, NoSetupContentFirebaseServerNewUserService, ON_CALL_MODEL_ANALYTICS_HANDLER, ON_CALL_MODEL_ANALYTICS_SERVICE, OnCallModelAnalyticsService, PERMISSION_DENIED_ERROR_CODE, PHONE_NUMBER_ALREADY_EXISTS_ERROR_CODE, SkipAppCheck, UNAUTHENTICATED_ERROR_CODE, UNAVAILABLE_ERROR_CODE, UNAVAILABLE_OR_DEACTIVATED_FUNCTION_ERROR_CODE, UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_NAME_CODE, UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_TYPE_CODE, _onCallWithCallTypeFunction, aggregateCrudModelApiDetails, aggregateModelApiDetails, aggregateSpecifierApiDetails, alreadyExistsError, appAnalyticsModuleMetadata, appFirestoreModuleMetadata, assertContextHasAuth, assertDocumentExists, assertHasRolesInRequest, assertHasSignedTosInRequest, assertIsAdminInRequest, assertIsAdminOrTargetUserInRequestData, assertIsContextWithAuthData, assertRequestRequiresAuthForFunction, assertSnapshotData, assertSnapshotDataWithKey, badRequestError, blockingFunctionHandlerWithNestContextFactory, buildNestServerRootModule, callWithAnalytics, cloudEventHandlerWithNestContextFactory, collectionRefForPath, createModelUnknownModelTypeError, defaultFirebaseServerActionsTransformFactoryLogErrorFunction, defaultProvideFirebaseServerStorageServiceSimple, deleteModelUnknownModelTypeError, developmentUnknownSpecifierError, docRefForPath, documentModelNotAvailableError, firebaseAuthTokenFromDecodedIdToken, firebaseServerActionsContext, firebaseServerActionsTransformContext, firebaseServerActionsTransformFactory, firebaseServerAppTokenProvider, firebaseServerAuthModuleMetadata, firebaseServerDevFunctions, firebaseServerEnvTokenProvider, firebaseServerEnvTokenProviders, firebaseServerErrorInfo, firebaseServerErrorInfoCodePair, firebaseServerErrorInfoServerErrorCodePair, firebaseServerErrorInfoServerErrorPair, firebaseServerStorageDefaultBucketIdTokenProvider, firebaseServerStorageModuleMetadata, firebaseServerValidationError, firebaseServerValidationServerError, firestoreClientQueryConstraintFunctionsDriver, firestoreEncryptedField, firestoreServerIncrementUpdateToUpdateData, forbiddenError, getAuthUserOrUndefined, getModelApiDetails, googleCloudFileMetadataToStorageMetadata, googleCloudFirebaseStorageContextFactory, googleCloudFirebaseStorageDrivers, googleCloudFirestoreAccessorDriver, googleCloudFirestoreContextFactory, googleCloudFirestoreDrivers, googleCloudFirestoreQueryDriver, googleCloudStorageAccessorFile, googleCloudStorageAccessorFolder, googleCloudStorageBucketForStorageFilePath, googleCloudStorageFileForStorageFilePath, googleCloudStorageFirebaseStorageAccessorDriver, googleCloudStorageFromFirebaseAdminStorage, googleCloudStorageListFilesResultFactory, handleFirebaseAuthError, handleFirebaseError, hasAuthRolesInRequest, hasNewUserSetupPasswordInRequest, hasSignedTosInRequest, inAuthContext, injectNestApplicationContextIntoRequest, injectNestIntoRequest, internalServerError, isActualSpecifier, isAdminInRequest, isAdminOrTargetUserInRequestData, isContextWithAuthData, isFirebaseError, isFirebaseHttpsError, isOnCallCrudModelApiDetails, isOnCallHandlerApiDetails, isOnCallModelTypeApiDetails, isOnCallSpecifierApiDetails, makeBlockingFunctionWithHandler, makeOnScheduleHandlerWithNestApplicationRequest, makeScheduledFunctionDevelopmentFunction, modelNotAvailableError, nestAppHasDevelopmentSchedulerEnabled, nestAppIsProductionEnvironment, nestFirebaseDoesNotExistError, nestFirebaseForbiddenPermissionError, nestServerInstance, noRunNameSpecifiedForScheduledFunctionDevelopmentFunction, noopFirebaseServerAnalyticsServiceListener, notFoundError, onCallAnalyticsEmitterInstance, onCallCreateModel, onCallDeleteModel, onCallDevelopmentFunction, onCallHandlerWithNestApplicationFactory, onCallHandlerWithNestContextFactory, onCallModel, onCallModelMissingCallTypeError, onCallModelUnknownCallTypeError, onCallReadModel, onCallSpecifierHandler, onCallUpdateModel, onScheduleHandlerWithNestApplicationFactory, onScheduleHandlerWithNestContextFactory, optionalAuthContext, optionalFirestoreEncryptedField, permissionDeniedError, phoneNumberAlreadyExistsError, preconditionConflictError, provideAppFirestoreCollections, provideFirebaseServerAuthService, provideFirebaseServerStorageService, readApiDetails, readModelUnknownModelTypeError, resolveAnalyticsFromApiDetails, setNestContextOnRequest, setNestContextOnScheduleRequest, taskQueueFunctionHandlerWithNestContextFactory, unauthenticatedContextHasNoAuthData, unauthenticatedContextHasNoUidError, unauthenticatedError, unavailableError, unavailableOrDeactivatedFunctionError, unknownModelCrudFunctionSpecifierError, unknownScheduledFunctionDevelopmentFunctionName, unknownScheduledFunctionDevelopmentFunctionType, updateModelUnknownModelTypeError, userContextFromUid, verifyAppCheckInRequest, withApiDetails };
+export { ALREADY_EXISTS_ERROR_CODE, AbstractFirebaseNestContext, AbstractFirebaseServerActionsContext, AbstractFirebaseServerAuthContext, AbstractFirebaseServerAuthService, AbstractFirebaseServerAuthUserContext, AbstractFirebaseServerNewUserService, AbstractNestContext, AbstractServerFirebaseNestContext, BAD_REQUEST_ERROR_CODE, CONFLICT_ERROR_CODE, ConfigureFirebaseAppCheckMiddlewareModule, ConfigureFirebaseWebhookMiddlewareModule, DEFAULT_FIREBASE_PASSWORD_NUMBER_GENERATOR, DEFAULT_SETUP_COM_THROTTLE_TIME, DefaultFirebaseServerEnvService, FIREBASE_APP_TOKEN, FIREBASE_AUTH_TOKEN, FIREBASE_FIRESTORE_CONTEXT_TOKEN, FIREBASE_FIRESTORE_TOKEN, FIREBASE_SERVER_ENV_TOKEN, FIREBASE_SERVER_VALIDATION_ERROR_CODE, FIREBASE_STORAGE_CONTEXT_FACTORY_CONFIG_TOKEN, FIREBASE_STORAGE_CONTEXT_TOKEN, FIREBASE_STORAGE_TOKEN, FIRESTORE_CLIENT_QUERY_CONSTRAINT_HANDLER_MAPPING, FORBIDDEN_ERROR_CODE, FirebaseAppCheckMiddleware, FirebaseAppCheckMiddlewareConfig, FirebaseNestServerRootModule, FirebaseRawBodyMiddleware, FirebaseServerAnalyticsSegmentListenerService, FirebaseServerAnalyticsSegmentModule, FirebaseServerAnalyticsService, FirebaseServerAnalyticsServiceListener, FirebaseServerAuthModule, FirebaseServerAuthNewUserSendSetupDetailsNoSetupConfigError, FirebaseServerAuthNewUserSendSetupDetailsSendOnceError, FirebaseServerAuthNewUserSendSetupDetailsThrottleError, FirebaseServerAuthService, FirebaseServerAuthUserBadInputError, FirebaseServerAuthUserExistsError, FirebaseServerEnvService, FirebaseServerFirestoreContextModule, FirebaseServerFirestoreModule, FirebaseServerStorageContextModule, FirebaseServerStorageModule, FirebaseServerStorageService, GlobalRoutePrefixConfig, INTERNAL_SERVER_ERROR_CODE, MODEL_NOT_AVAILABLE_ERROR_CODE, NOT_FOUND_ERROR_CODE, NO_RUN_NAME_SPECIFIED_FOR_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_CODE, NoSetupContentFirebaseServerNewUserService, ON_CALL_MODEL_ANALYTICS_HANDLER, ON_CALL_MODEL_ANALYTICS_SERVICE, OnCallModelAnalyticsService, PERMISSION_DENIED_ERROR_CODE, PHONE_NUMBER_ALREADY_EXISTS_ERROR_CODE, SkipAppCheck, UNAUTHENTICATED_ERROR_CODE, UNAVAILABLE_ERROR_CODE, UNAVAILABLE_OR_DEACTIVATED_FUNCTION_ERROR_CODE, UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_NAME_CODE, UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_TYPE_CODE, _onCallWithCallTypeFunction, aggregateCrudModelApiDetails, aggregateModelApiDetails, aggregateSpecifierApiDetails, alreadyExistsError, appAnalyticsModuleMetadata, appFirestoreModuleMetadata, assertContextHasAuth, assertDocumentExists, assertHasRolesInRequest, assertHasSignedTosInRequest, assertIsAdminInRequest, assertIsAdminOrTargetUserInRequestData, assertIsContextWithAuthData, assertRequestRequiresAuthForFunction, assertSnapshotData, assertSnapshotDataWithKey, badRequestError, blockingFunctionHandlerWithNestContextFactory, buildNestServerRootModule, callWithAnalytics, cloudEventHandlerWithNestContextFactory, collectionRefForPath, createModelUnknownModelTypeError, defaultFirebaseServerActionsTransformFactoryLogErrorFunction, defaultProvideFirebaseServerStorageServiceSimple, deleteModelUnknownModelTypeError, developmentUnknownSpecifierError, docRefForPath, documentModelNotAvailableError, firebaseAuthTokenFromDecodedIdToken, firebaseServerActionsContext, firebaseServerActionsTransformContext, firebaseServerActionsTransformFactory, firebaseServerAppTokenProvider, firebaseServerAuthModuleMetadata, firebaseServerDevFunctions, firebaseServerEnvTokenProvider, firebaseServerEnvTokenProviders, firebaseServerErrorInfo, firebaseServerErrorInfoCodePair, firebaseServerErrorInfoServerErrorCodePair, firebaseServerErrorInfoServerErrorPair, firebaseServerStorageDefaultBucketIdTokenProvider, firebaseServerStorageModuleMetadata, firebaseServerValidationError, firebaseServerValidationServerError, firestoreClientQueryConstraintFunctionsDriver, firestoreEncryptedField, firestoreServerIncrementUpdateToUpdateData, forbiddenError, getAuthUserOrUndefined, getModelApiDetails, googleCloudFileMetadataToStorageMetadata, googleCloudFirebaseStorageContextFactory, googleCloudFirebaseStorageDrivers, googleCloudFirestoreAccessorDriver, googleCloudFirestoreContextFactory, googleCloudFirestoreDrivers, googleCloudFirestoreQueryDriver, googleCloudStorageAccessorFile, googleCloudStorageAccessorFolder, googleCloudStorageBucketForStorageFilePath, googleCloudStorageFileForStorageFilePath, googleCloudStorageFirebaseStorageAccessorDriver, googleCloudStorageFromFirebaseAdminStorage, googleCloudStorageListFilesResultFactory, handleFirebaseAuthError, handleFirebaseError, hasAuthRolesInRequest, hasNewUserSetupPasswordInRequest, hasSignedTosInRequest, inAuthContext, injectNestApplicationContextIntoRequest, injectNestIntoRequest, internalServerError, isActualSpecifier, isAdminInRequest, isAdminOrTargetUserInRequestData, isContextWithAuthData, isFirebaseError, isFirebaseHttpsError, isOnCallCrudModelApiDetails, isOnCallHandlerApiDetails, isOnCallModelTypeApiDetails, isOnCallSpecifierApiDetails, makeBlockingFunctionWithHandler, makeOnScheduleHandlerWithNestApplicationRequest, makeScheduledFunctionDevelopmentFunction, modelNotAvailableError, nestAppHasDevelopmentSchedulerEnabled, nestAppIsProductionEnvironment, nestFirebaseDoesNotExistError, nestFirebaseForbiddenPermissionError, nestServerInstance, noRunNameSpecifiedForScheduledFunctionDevelopmentFunction, noopFirebaseServerAnalyticsServiceListener, notFoundError, onCallAnalyticsEmitterInstance, onCallCreateModel, onCallDeleteModel, onCallDevelopmentFunction, onCallHandlerWithNestApplicationFactory, onCallHandlerWithNestContextFactory, onCallModel, onCallModelMissingCallTypeError, onCallModelUnknownCallTypeError, onCallReadModel, onCallSpecifierHandler, onCallUpdateModel, onScheduleHandlerWithNestApplicationFactory, onScheduleHandlerWithNestContextFactory, optionalAuthContext, optionalFirestoreEncryptedField, permissionDeniedError, phoneNumberAlreadyExistsError, preconditionConflictError, provideAppFirestoreCollections, provideFirebaseServerAuthService, provideFirebaseServerStorageService, readApiDetails, readModelUnknownModelTypeError, resolveAnalyticsFromApiDetails, setNestContextOnRequest, setNestContextOnScheduleRequest, taskQueueFunctionHandlerWithNestContextFactory, unauthenticatedContextHasNoAuthData, unauthenticatedContextHasNoUidError, unauthenticatedError, unavailableError, unavailableOrDeactivatedFunctionError, unknownModelCrudFunctionSpecifierError, unknownScheduledFunctionDevelopmentFunctionName, unknownScheduledFunctionDevelopmentFunctionType, updateModelUnknownModelTypeError, userContextFromUid, verifyAppCheckInRequest, withApiDetails };

package/mailgun/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/mailgun",
-  "version": "13.4.0",
+  "version": "13.4.1",
   "peerDependencies": {
-    "@dereekb/analytics": "13.4.0",
-    "@dereekb/firebase": "13.4.0",
-    "@dereekb/firebase-server": "13.4.0",
-    "@dereekb/date": "13.4.0",
-    "@dereekb/nestjs": "13.4.0",
-    "@dereekb/model": "13.4.0",
-    "@dereekb/rxjs": "13.4.0",
-    "@dereekb/util": "13.4.0"
+    "@dereekb/analytics": "13.4.1",
+    "@dereekb/firebase": "13.4.1",
+    "@dereekb/firebase-server": "13.4.1",
+    "@dereekb/date": "13.4.1",
+    "@dereekb/nestjs": "13.4.1",
+    "@dereekb/model": "13.4.1",
+    "@dereekb/rxjs": "13.4.1",
+    "@dereekb/util": "13.4.1"
   },
   "exports": {
     "./package.json": "./package.json",

package/model/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/model",
-  "version": "13.4.0",
+  "version": "13.4.1",
   "peerDependencies": {
-    "@dereekb/analytics": "13.4.0",
-    "@dereekb/date": "13.4.0",
-    "@dereekb/firebase": "13.4.0",
-    "@dereekb/firebase-server": "13.4.0",
-    "@dereekb/model": "13.4.0",
-    "@dereekb/nestjs": "13.4.0",
-    "@dereekb/rxjs": "13.4.0",
-    "@dereekb/util": "13.4.0",
+    "@dereekb/analytics": "13.4.1",
+    "@dereekb/date": "13.4.1",
+    "@dereekb/firebase": "13.4.1",
+    "@dereekb/firebase-server": "13.4.1",
+    "@dereekb/model": "13.4.1",
+    "@dereekb/nestjs": "13.4.1",
+    "@dereekb/rxjs": "13.4.1",
+    "@dereekb/util": "13.4.1",
     "@nestjs/common": "^11.1.16",
     "@nestjs/config": "^4.0.3",
     "archiver": "^7.0.0",

package/oidc/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@dereekb/firebase-server/oidc",
-  "version": "13.4.0",
+  "version": "13.4.1",
   "peerDependencies": {
-    "@dereekb/analytics": "13.4.0",
-    "@dereekb/date": "13.4.0",
-    "@dereekb/firebase": "13.4.0",
-    "@dereekb/firebase-server": "13.4.0",
-    "@dereekb/model": "13.4.0",
-    "@dereekb/nestjs": "13.4.0",
-    "@dereekb/rxjs": "13.4.0",
-    "@dereekb/util": "13.4.0",
-    "@dereekb/zoho": "13.4.0",
+    "@dereekb/analytics": "13.4.1",
+    "@dereekb/date": "13.4.1",
+    "@dereekb/firebase": "13.4.1",
+    "@dereekb/firebase-server": "13.4.1",
+    "@dereekb/model": "13.4.1",
+    "@dereekb/nestjs": "13.4.1",
+    "@dereekb/rxjs": "13.4.1",
+    "@dereekb/util": "13.4.1",
+    "@dereekb/zoho": "13.4.1",
     "@nestjs/common": "^11.1.16",
     "@nestjs/config": "^4.0.3",
     "express": "^5.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/firebase-server",
-  "version": "13.4.0",
+  "version": "13.4.1",
   "exports": {
     "./test": {
       "module": "./test/index.esm.js",
@@ -43,15 +43,15 @@
   "main": "./index.cjs.js",
   "types": "./src/index.d.ts",
   "peerDependencies": {
-    "@dereekb/analytics": "13.4.0",
-    "@dereekb/date": "13.4.0",
-    "@dereekb/dbx-core": "13.4.0",
-    "@dereekb/firebase": "13.4.0",
-    "@dereekb/model": "13.4.0",
-    "@dereekb/nestjs": "13.4.0",
-    "@dereekb/rxjs": "13.4.0",
-    "@dereekb/util": "13.4.0",
-    "@dereekb/zoho": "13.4.0",
+    "@dereekb/analytics": "13.4.1",
+    "@dereekb/date": "13.4.1",
+    "@dereekb/dbx-core": "13.4.1",
+    "@dereekb/firebase": "13.4.1",
+    "@dereekb/model": "13.4.1",
+    "@dereekb/nestjs": "13.4.1",
+    "@dereekb/rxjs": "13.4.1",
+    "@dereekb/util": "13.4.1",
+    "@dereekb/zoho": "13.4.1",
     "@google-cloud/firestore": "^7.11.6",
     "@google-cloud/storage": "^7.19.0",
     "@nestjs/common": "^11.1.16",

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

@@ -322,7 +322,10 @@ export interface FirebaseServerAuthInitializeNewUser<D = unknown> {
      */
     readonly email?: EmailAddress;
     /**
-     * Phone for the new user, if applicable.
+     * Phone for the new user, if applicable. Must be a valid {@link E164PhoneNumber} (e.g. `'+17206620850'`).
+     *
+     * Firebase Auth requires E.164 format. If the value is not valid, {@link FirebaseServerAuthUserBadInputError}
+     * is thrown with code `auth/invalid-phone-number`.
      */
     readonly phone?: E164PhoneNumber;
     /**

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

@@ -1,4 +1,50 @@
+import { type FirebaseErrorCode } from '@dereekb/firebase';
 import { BaseError } from 'make-error';
+/**
+ * The type of identifier that caused the user-already-exists conflict.
+ */
+export type FirebaseServerAuthUserExistsErrorIdentifierType = 'phone' | 'email';
+/**
+ * Thrown by {@link AbstractFirebaseServerNewUserService.createNewUser} when Firebase Auth rejects
+ * user creation because the provided phone number or email is already associated with another account.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await newUserService.initializeNewUser({ email, phone });
+ * } catch (e) {
+ *   if (e instanceof FirebaseServerAuthUserExistsError && e.identifierType === 'phone') {
+ *     const existingUser = await auth.getUserByPhoneNumber(e.identifierValue);
+ *   }
+ * }
+ * ```
+ */
+export declare class FirebaseServerAuthUserExistsError extends BaseError {
+    readonly code: FirebaseErrorCode;
+    readonly identifierType: FirebaseServerAuthUserExistsErrorIdentifierType;
+    readonly identifierValue: string;
+    constructor(code: FirebaseErrorCode, identifierType: FirebaseServerAuthUserExistsErrorIdentifierType, identifierValue: string);
+}
+/**
+ * Thrown by {@link AbstractFirebaseServerNewUserService.createNewUser} when Firebase Auth rejects
+ * user creation due to invalid input (e.g., a malformed phone number).
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await newUserService.initializeNewUser({ email, phone: 'not-e164' });
+ * } catch (e) {
+ *   if (e instanceof FirebaseServerAuthUserBadInputError) {
+ *     console.log(`Bad input (${e.code}): ${e.inputValue}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class FirebaseServerAuthUserBadInputError extends BaseError {
+    readonly code: FirebaseErrorCode;
+    readonly inputValue: string;
+    constructor(code: FirebaseErrorCode, inputValue: string, message?: string);
+}
 /**
  * Thrown by sendSetupDetails() if the user has no setup configuration available, meaning they probably already have accepted their invite or is in an invalid state.
  */

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

@@ -25,9 +25,13 @@ export type MakeNestContext<C> = (nest: INestApplicationContext) => C;
  * Abstract class that wraps an INestApplicationContext value.
  */
 export declare abstract class AbstractNestContext {
-    private readonly _nest;
-    constructor(nest: INestApplicationContext);
+    private readonly _nestApplication;
+    constructor(nestApplication: INestApplicationContext);
+    /**
+     * @deprecated use nestApplication instead.
+     */
     get nest(): INestApplicationContext;
+    get nestApplication(): INestApplicationContext;
 }
 /**
  * Abstract class used for the top-level NestJS context for Firebase services.

package/test/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/test",
-  "version": "13.4.0",
+  "version": "13.4.1",
   "peerDependencies": {
-    "@dereekb/analytics": "13.4.0",
-    "@dereekb/date": "13.4.0",
-    "@dereekb/firebase": "13.4.0",
-    "@dereekb/firebase-server": "13.4.0",
-    "@dereekb/model": "13.4.0",
-    "@dereekb/nestjs": "13.4.0",
-    "@dereekb/rxjs": "13.4.0",
-    "@dereekb/util": "13.4.0",
+    "@dereekb/analytics": "13.4.1",
+    "@dereekb/date": "13.4.1",
+    "@dereekb/firebase": "13.4.1",
+    "@dereekb/firebase-server": "13.4.1",
+    "@dereekb/model": "13.4.1",
+    "@dereekb/nestjs": "13.4.1",
+    "@dereekb/rxjs": "13.4.1",
+    "@dereekb/util": "13.4.1",
     "@google-cloud/firestore": "^7.11.6",
     "@google-cloud/storage": "^7.19.0",
     "@nestjs/common": "^11.1.16",
@@ -21,7 +21,7 @@
     "make-error": "^1.3.0"
   },
   "devDependencies": {
-    "@dereekb/nestjs": "13.4.0"
+    "@dereekb/nestjs": "13.4.1"
   },
   "exports": {
     "./package.json": "./package.json",

package/zoho/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/zoho",
-  "version": "13.4.0",
+  "version": "13.4.1",
   "peerDependencies": {
-    "@dereekb/analytics": "13.4.0",
-    "@dereekb/date": "13.4.0",
-    "@dereekb/model": "13.4.0",
-    "@dereekb/nestjs": "13.4.0",
-    "@dereekb/rxjs": "13.4.0",
-    "@dereekb/firebase": "13.4.0",
-    "@dereekb/util": "13.4.0",
-    "@dereekb/zoho": "13.4.0"
+    "@dereekb/analytics": "13.4.1",
+    "@dereekb/date": "13.4.1",
+    "@dereekb/model": "13.4.1",
+    "@dereekb/nestjs": "13.4.1",
+    "@dereekb/rxjs": "13.4.1",
+    "@dereekb/firebase": "13.4.1",
+    "@dereekb/util": "13.4.1",
+    "@dereekb/zoho": "13.4.1"
   },
   "exports": {
     "./package.json": "./package.json",