@dereekb/firebase-server 13.6.17 → 13.8.0

package/mailgun/index.cjs.js

@@ -337,7 +337,97 @@ function _ts_generator(thisArg, body) {
         }
     ]);
     return AbstractMailgunContentFirebaseServerNewUserService;
+}(firebaseServer.AbstractFirebaseServerNewUserService);
+/**
+ * Abstract {@link FirebaseServerUserPasswordResetService} implementation that sends a password reset
+ * email to users via Mailgun templates.
+ *
+ * Subclasses implement `buildPasswordResetMailgunContentRequest` to define the template, subject,
+ * and any custom variables. The user's email, display name, UID, and reset password are
+ * automatically injected as Mailgun user variables.
+ *
+ * @example
+ * ```ts
+ * class PasswordResetEmailService extends AbstractMailgunContentFirebaseServerUserPasswordResetService {
+ *   protected async buildPasswordResetMailgunContentRequest(details) {
+ *     return {
+ *       template: 'password-reset',
+ *       subject: 'Reset Your Password',
+ *       from: 'noreply@example.com'
+ *     };
+ *   }
+ * }
+ * ```
+ */ var AbstractMailgunContentFirebaseServerUserPasswordResetService = /*#__PURE__*/ function(AbstractFirebaseServerUserPasswordResetService) {
+    _inherits(AbstractMailgunContentFirebaseServerUserPasswordResetService, AbstractFirebaseServerUserPasswordResetService);
+    function AbstractMailgunContentFirebaseServerUserPasswordResetService(authService, mailgunService) {
+        _class_call_check(this, AbstractMailgunContentFirebaseServerUserPasswordResetService);
+        var _this;
+        _this = _call_super(this, AbstractMailgunContentFirebaseServerUserPasswordResetService, [
+            authService
+        ]), _define_property(_this, "mailgunService", void 0);
+        _this.mailgunService = mailgunService;
+        return _this;
+    }
+    _create_class(AbstractMailgunContentFirebaseServerUserPasswordResetService, [
+        {
+            key: "sendPasswordResetContentToUser",
+            value: function sendPasswordResetContentToUser(details) {
+                return _async_to_generator(function() {
+                    var userRecord, resetPassword, uid, displayName, email, baseRequest, baseRequestTo;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    details.userContext.loadRecord()
+                                ];
+                            case 1:
+                                userRecord = _state.sent();
+                                resetPassword = details.claims.resetPassword;
+                                uid = userRecord.uid, displayName = userRecord.displayName, email = userRecord.email;
+                                if (!email) {
+                                    throw new Error('Email is not present/available for the user record "'.concat(userRecord.uid, '"'));
+                                }
+                                return [
+                                    4,
+                                    this.buildPasswordResetMailgunContentRequest(details)
+                                ];
+                            case 2:
+                                baseRequest = _state.sent();
+                                baseRequestTo = baseRequest.to;
+                                return [
+                                    4,
+                                    this.mailgunService.sendTemplateEmail(_object_spread_props(_object_spread({
+                                        batchSend: false
+                                    }, baseRequest), {
+                                        to: {
+                                            name: baseRequestTo === null || baseRequestTo === void 0 ? void 0 : baseRequestTo.name,
+                                            email: email,
+                                            userVariables: _object_spread_props(_object_spread({
+                                                resetPassword: resetPassword
+                                            }, baseRequestTo === null || baseRequestTo === void 0 ? void 0 : baseRequestTo.userVariables), {
+                                                displayName: displayName,
+                                                uid: uid
+                                            })
+                                        },
+                                        sendTestEmails: baseRequest.sendTestEmails || details.sendDetailsInTestEnvironment || undefined
+                                    }))
+                                ];
+                            case 3:
+                                _state.sent();
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        }
+    ]);
+    return AbstractMailgunContentFirebaseServerUserPasswordResetService;
 } 
-(firebaseServer.AbstractFirebaseServerNewUserService);
+(firebaseServer.AbstractFirebaseServerUserPasswordResetService);
 
 exports.AbstractMailgunContentFirebaseServerNewUserService = AbstractMailgunContentFirebaseServerNewUserService;
+exports.AbstractMailgunContentFirebaseServerUserPasswordResetService = AbstractMailgunContentFirebaseServerUserPasswordResetService;

package/mailgun/index.esm.js

@@ -1,4 +1,4 @@
-import { AbstractFirebaseServerNewUserService } from '@dereekb/firebase-server';
+import { AbstractFirebaseServerNewUserService, AbstractFirebaseServerUserPasswordResetService } from '@dereekb/firebase-server';
 
 function _assert_this_initialized(self) {
     if (self === void 0) {
@@ -335,7 +335,96 @@ function _ts_generator(thisArg, body) {
         }
     ]);
     return AbstractMailgunContentFirebaseServerNewUserService;
+}(AbstractFirebaseServerNewUserService);
+/**
+ * Abstract {@link FirebaseServerUserPasswordResetService} implementation that sends a password reset
+ * email to users via Mailgun templates.
+ *
+ * Subclasses implement `buildPasswordResetMailgunContentRequest` to define the template, subject,
+ * and any custom variables. The user's email, display name, UID, and reset password are
+ * automatically injected as Mailgun user variables.
+ *
+ * @example
+ * ```ts
+ * class PasswordResetEmailService extends AbstractMailgunContentFirebaseServerUserPasswordResetService {
+ *   protected async buildPasswordResetMailgunContentRequest(details) {
+ *     return {
+ *       template: 'password-reset',
+ *       subject: 'Reset Your Password',
+ *       from: 'noreply@example.com'
+ *     };
+ *   }
+ * }
+ * ```
+ */ var AbstractMailgunContentFirebaseServerUserPasswordResetService = /*#__PURE__*/ function(AbstractFirebaseServerUserPasswordResetService) {
+    _inherits(AbstractMailgunContentFirebaseServerUserPasswordResetService, AbstractFirebaseServerUserPasswordResetService);
+    function AbstractMailgunContentFirebaseServerUserPasswordResetService(authService, mailgunService) {
+        _class_call_check(this, AbstractMailgunContentFirebaseServerUserPasswordResetService);
+        var _this;
+        _this = _call_super(this, AbstractMailgunContentFirebaseServerUserPasswordResetService, [
+            authService
+        ]), _define_property(_this, "mailgunService", void 0);
+        _this.mailgunService = mailgunService;
+        return _this;
+    }
+    _create_class(AbstractMailgunContentFirebaseServerUserPasswordResetService, [
+        {
+            key: "sendPasswordResetContentToUser",
+            value: function sendPasswordResetContentToUser(details) {
+                return _async_to_generator(function() {
+                    var userRecord, resetPassword, uid, displayName, email, baseRequest, baseRequestTo;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    details.userContext.loadRecord()
+                                ];
+                            case 1:
+                                userRecord = _state.sent();
+                                resetPassword = details.claims.resetPassword;
+                                uid = userRecord.uid, displayName = userRecord.displayName, email = userRecord.email;
+                                if (!email) {
+                                    throw new Error('Email is not present/available for the user record "'.concat(userRecord.uid, '"'));
+                                }
+                                return [
+                                    4,
+                                    this.buildPasswordResetMailgunContentRequest(details)
+                                ];
+                            case 2:
+                                baseRequest = _state.sent();
+                                baseRequestTo = baseRequest.to;
+                                return [
+                                    4,
+                                    this.mailgunService.sendTemplateEmail(_object_spread_props(_object_spread({
+                                        batchSend: false
+                                    }, baseRequest), {
+                                        to: {
+                                            name: baseRequestTo === null || baseRequestTo === void 0 ? void 0 : baseRequestTo.name,
+                                            email: email,
+                                            userVariables: _object_spread_props(_object_spread({
+                                                resetPassword: resetPassword
+                                            }, baseRequestTo === null || baseRequestTo === void 0 ? void 0 : baseRequestTo.userVariables), {
+                                                displayName: displayName,
+                                                uid: uid
+                                            })
+                                        },
+                                        sendTestEmails: baseRequest.sendTestEmails || details.sendDetailsInTestEnvironment || undefined
+                                    }))
+                                ];
+                            case 3:
+                                _state.sent();
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        }
+    ]);
+    return AbstractMailgunContentFirebaseServerUserPasswordResetService;
 } 
-(AbstractFirebaseServerNewUserService);
+(AbstractFirebaseServerUserPasswordResetService);
 
-export { AbstractMailgunContentFirebaseServerNewUserService };
+export { AbstractMailgunContentFirebaseServerNewUserService, AbstractMailgunContentFirebaseServerUserPasswordResetService };

package/mailgun/package.json

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

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

@@ -1,5 +1,5 @@
 import { type MailgunRecipient, type MailgunService, type MailgunTemplateEmailRequest } from '@dereekb/nestjs/mailgun';
-import { AbstractFirebaseServerNewUserService, type FirebaseServerAuthContext, type FirebaseServerAuthNewUserSetupDetails, type FirebaseServerAuthService, type FirebaseServerAuthUserContext } from '@dereekb/firebase-server';
+import { AbstractFirebaseServerNewUserService, AbstractFirebaseServerUserPasswordResetService, type FirebaseServerAuthContext, type FirebaseServerAuthNewUserSetupDetails, type FirebaseServerAuthPasswordResetDetails, type FirebaseServerAuthService, type FirebaseServerAuthUserContext } from '@dereekb/firebase-server';
 /**
  * Partial {@link MailgunTemplateEmailRequest} for {@link AbstractMailgunContentFirebaseServerNewUserService}.
  *
@@ -36,3 +36,39 @@ export declare abstract class AbstractMailgunContentFirebaseServerNewUserService
     protected sendSetupContentToUser(user: FirebaseServerAuthNewUserSetupDetails<U, D>): Promise<void>;
     protected abstract buildNewUserMailgunContentRequest(user: FirebaseServerAuthNewUserSetupDetails<U, D>): Promise<NewUserMailgunContentRequest>;
 }
+/**
+ * Partial {@link MailgunTemplateEmailRequest} for {@link AbstractMailgunContentFirebaseServerUserPasswordResetService}.
+ *
+ * The `to` field is omitted because the user's email and details are automatically
+ * configured from the Firebase Auth user record during `sendPasswordResetContentToUser`.
+ */
+export interface ResetPasswordMailgunContentRequest extends Omit<MailgunTemplateEmailRequest, 'to'> {
+    to?: Partial<Omit<MailgunRecipient, 'email'>>;
+}
+/**
+ * Abstract {@link FirebaseServerUserPasswordResetService} implementation that sends a password reset
+ * email to users via Mailgun templates.
+ *
+ * Subclasses implement `buildPasswordResetMailgunContentRequest` to define the template, subject,
+ * and any custom variables. The user's email, display name, UID, and reset password are
+ * automatically injected as Mailgun user variables.
+ *
+ * @example
+ * ```ts
+ * class PasswordResetEmailService extends AbstractMailgunContentFirebaseServerUserPasswordResetService {
+ *   protected async buildPasswordResetMailgunContentRequest(details) {
+ *     return {
+ *       template: 'password-reset',
+ *       subject: 'Reset Your Password',
+ *       from: 'noreply@example.com'
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class AbstractMailgunContentFirebaseServerUserPasswordResetService<U extends FirebaseServerAuthUserContext = FirebaseServerAuthUserContext, C extends FirebaseServerAuthContext = FirebaseServerAuthContext, D = unknown> extends AbstractFirebaseServerUserPasswordResetService<U, C, D> {
+    readonly mailgunService: MailgunService;
+    constructor(authService: FirebaseServerAuthService<U, C>, mailgunService: MailgunService);
+    protected sendPasswordResetContentToUser(details: FirebaseServerAuthPasswordResetDetails<U, D>): Promise<void>;
+    protected abstract buildPasswordResetMailgunContentRequest(details: FirebaseServerAuthPasswordResetDetails<U, D>): Promise<ResetPasswordMailgunContentRequest>;
+}

package/model/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@dereekb/firebase-server/model",
-  "version": "13.6.17",
+  "version": "13.8.0",
   "peerDependencies": {
-    "@dereekb/analytics": "13.6.17",
-    "@dereekb/date": "13.6.17",
-    "@dereekb/firebase": "13.6.17",
-    "@dereekb/firebase-server": "13.6.17",
-    "@dereekb/model": "13.6.17",
-    "@dereekb/nestjs": "13.6.17",
-    "@dereekb/rxjs": "13.6.17",
-    "@dereekb/util": "13.6.17",
+    "@dereekb/analytics": "13.8.0",
+    "@dereekb/date": "13.8.0",
+    "@dereekb/firebase": "13.8.0",
+    "@dereekb/firebase-server": "13.8.0",
+    "@dereekb/model": "13.8.0",
+    "@dereekb/nestjs": "13.8.0",
+    "@dereekb/rxjs": "13.8.0",
+    "@dereekb/util": "13.8.0",
     "@nestjs/common": "^11.1.17",
-    "@nestjs/config": "^4.0.3",
+    "@nestjs/config": "^4.0.4",
     "archiver": "^7.0.0",
     "date-fns": "^4.0.0",
     "firebase-functions": "^7.0.0",

package/model/src/lib/storagefile/storagefile.action.server.d.ts

@@ -1,4 +1,4 @@
-import { type FirestoreContextReference, type InitializeStorageFileFromUploadParams, type AsyncStorageFileCreateAction, type StorageFileFirestoreCollections, type ProcessStorageFileParams, type StorageFileDocument, type ProcessStorageFileResult, type CreateStorageFileParams, type AsyncStorageFileUpdateAction, type UpdateStorageFileParams, type NotificationFirestoreCollections, type FirebaseStorageAccessorFile, type InitializeAllStorageFilesFromUploadsResult, type InitializeAllStorageFilesFromUploadsParams, type ProcessAllQueuedStorageFilesParams, type ProcessAllQueuedStorageFilesResult, type DeleteAllQueuedStorageFilesParams, type DeleteAllQueuedStorageFilesResult, type DeleteStorageFileParams, type AsyncStorageFileDeleteAction, type StorageFile, type DownloadStorageFileParams, type DownloadStorageFileResult, type DownloadMultipleStorageFilesParams, type DownloadMultipleStorageFilesResult, type DownloadMultipleStorageFileSuccessItem, type FirestoreModelKey, type SyncStorageFileWithGroupsParams, type SyncAllFlaggedStorageFilesWithGroupsParams, type SyncAllFlaggedStorageFilesWithGroupsResult, type SyncStorageFileWithGroupsResult, type RegenerateAllFlaggedStorageFileGroupsContentParams, type RegenerateAllFlaggedStorageFileGroupsContentResult, type RegenerateStorageFileGroupContentParams, type RegenerateStorageFileGroupContentResult, type StorageFileGroupDocument, type AsyncStorageFileGroupCreateAction, type CreateStorageFileGroupParams, type Transaction, type StorageFileGroup, type StorageFileGroupDocumentReferencePair, type StorageFileGroupId, type UpdateStorageFileGroupParams, DownloadStorageFileOptions } from '@dereekb/firebase';
+import { type FirestoreContextReference, type InitializeStorageFileFromUploadParams, type AsyncStorageFileCreateAction, type StorageFileFirestoreCollections, type ProcessStorageFileParams, type StorageFileDocument, type ProcessStorageFileResult, type CreateStorageFileParams, type AsyncStorageFileUpdateAction, type UpdateStorageFileParams, type NotificationFirestoreCollections, type FirebaseStorageAccessorFile, type InitializeAllStorageFilesFromUploadsResult, type InitializeAllStorageFilesFromUploadsParams, type ProcessAllQueuedStorageFilesParams, type ProcessAllQueuedStorageFilesResult, type DeleteAllQueuedStorageFilesParams, type DeleteAllQueuedStorageFilesResult, type DeleteStorageFileParams, type AsyncStorageFileDeleteAction, type StorageFile, type DownloadStorageFileParams, type DownloadStorageFileResult, type DownloadMultipleStorageFilesParams, type DownloadMultipleStorageFilesResult, type DownloadMultipleStorageFileSuccessItem, type FirestoreModelKey, type SyncStorageFileWithGroupsParams, type SyncAllFlaggedStorageFilesWithGroupsParams, type SyncAllFlaggedStorageFilesWithGroupsResult, type SyncStorageFileWithGroupsResult, type RegenerateAllFlaggedStorageFileGroupsContentParams, type RegenerateAllFlaggedStorageFileGroupsContentResult, type RegenerateStorageFileGroupContentParams, type RegenerateStorageFileGroupContentResult, type StorageFileGroupDocument, type AsyncStorageFileGroupCreateAction, type CreateStorageFileGroupParams, type Transaction, type StorageFileGroup, type StorageFileGroupDocumentReferencePair, type StorageFileGroupId, type UpdateStorageFileGroupParams, type DownloadStorageFileOptions } from '@dereekb/firebase';
 import { type FirebaseServerStorageServiceRef, type FirebaseServerActionsContext, type FirebaseServerAuthServiceRef } from '@dereekb/firebase-server';
 import { type TransformAndValidateFunctionResult } from '@dereekb/model';
 import { type InjectionToken } from '@nestjs/common';