@dereekb/firebase-server 13.11.14 → 13.11.15

package/model/index.cjs.js

@@ -186,7 +186,7 @@ function _ts_generator$h(thisArg, body) {
         };
     }
 }
-var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST = 50;
+var DEFAULT_MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_MAX_BATCH_SIZE_PER_REQUEST = 50;
 /**
  * Creates a {@link NotificationEmailSendService} that sends notification emails via Mailgun.
  *
@@ -194,8 +194,8 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  * converts each batch to a {@link MailgunTemplateEmailRequest} using the configured template builders,
  * and dispatches them through the Mailgun API.
  *
- * @param config - service configuration including the Mailgun service, template builders, and batch size
- * @returns a {@link NotificationEmailSendService} that batches and sends emails through Mailgun
+ * @param config - Service configuration including the Mailgun service, template builders, and batch size.
+ * @returns A {@link NotificationEmailSendService} that batches and sends emails through Mailgun.
  *
  * @example
  * ```ts
@@ -213,7 +213,7 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  */ function mailgunNotificationEmailSendService(config) {
     var mailgunService = config.mailgunService, defaultSendTemplateName = config.defaultSendTemplateName, inputMaxBatchSizePerRequest = config.maxBatchSizePerRequest, inputMessageBuilders = config.messageBuilders;
     var lowercaseKeysMessageBuilders = util.mapObjectKeysToLowercase(inputMessageBuilders);
-    var maxBatchSizePerRequest = inputMaxBatchSizePerRequest !== null && inputMaxBatchSizePerRequest !== void 0 ? inputMaxBatchSizePerRequest : MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST;
+    var maxBatchSizePerRequest = inputMaxBatchSizePerRequest !== null && inputMaxBatchSizePerRequest !== void 0 ? inputMaxBatchSizePerRequest : DEFAULT_MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_MAX_BATCH_SIZE_PER_REQUEST;
     var sendService = {
         buildSendInstanceForEmailNotificationMessages: function buildSendInstanceForEmailNotificationMessages(notificationMessages) {
             return _async_to_generator$h(function() {
@@ -329,7 +329,7 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  *
  * Thrown when attempting to create a {@link Notification} document without providing the mandatory ID field.
  *
- * @returns a precondition conflict error with the notification ID required error code
+ * @returns A precondition conflict error with the notification ID required error code.
  */ function createNotificationIdRequiredError() {
     return firebaseServer.preconditionConflictError({
         message: "The required id was not present when attempting to create a Notification.",
@@ -342,7 +342,7 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  * Thrown during initialization when `throwErrorIfAlreadyInitialized` is true and the model's
  * setup flag (`s`) indicates it was previously initialized.
  *
- * @returns a precondition conflict error with the already-initialized error code
+ * @returns A precondition conflict error with the already-initialized error code.
  */ function notificationModelAlreadyInitializedError() {
     return firebaseServer.preconditionConflictError({
         message: "This model has already been initialized.",
@@ -354,8 +354,8 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  *
  * Thrown when the model key's collection name does not match any registered notification model type.
  *
- * @param key - the Firestore model key that has no registered notification model type
- * @returns a precondition conflict error with the unregistered model type error code
+ * @param key - The Firestore model key that has no registered notification model type.
+ * @returns A precondition conflict error with the unregistered model type error code.
  */ function notificationBoxUnregistredModelTypeInitializationError(key) {
     return firebaseServer.preconditionConflictError({
         message: "This NotificationBox is associated with an unregistered model type.",
@@ -370,7 +370,7 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  *
  * Thrown when an operation requires a NotificationBox but none has been created for the given model key.
  *
- * @returns a precondition conflict error with the box-not-found error code
+ * @returns A precondition conflict error with the box-not-found error code.
  */ function notificationBoxDoesNotExist() {
     return firebaseServer.preconditionConflictError({
         message: "A NotificationBox does not exist for this model.",
@@ -383,7 +383,7 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  * Thrown when the target recipient on the {@link NotificationBox} does not exist on the box
  * or does not have a UID, making it ineligible for exclusion.
  *
- * @returns a precondition conflict error with the invalid exclusion target error code
+ * @returns A precondition conflict error with the invalid exclusion target error code.
  */ function notificationBoxExclusionTargetInvalidError() {
     return firebaseServer.preconditionConflictError({
         message: "The target for exclusion is invalid. The target recipient on the NotificationBox must be exist on the NotificationBox and have a uid to be excluded.",
@@ -395,7 +395,7 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  *
  * Thrown when attempting to create a duplicate NotificationBox for a model that already has one.
  *
- * @returns a precondition conflict error with the box-exists error code
+ * @returns A precondition conflict error with the box-exists error code.
  */ function notificationBoxExistsForModelError() {
     return firebaseServer.preconditionConflictError({
         message: "A NotificationBox already exists for this model.",
@@ -408,7 +408,7 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  * Thrown when attempting to update a recipient that is not registered on the box
  * and `insert=true` was not passed to allow creating a new recipient entry.
  *
- * @returns a precondition conflict error with the recipient-not-found error code
+ * @returns A precondition conflict error with the recipient-not-found error code.
  */ function notificationBoxRecipientDoesNotExistsError() {
     return firebaseServer.preconditionConflictError({
         message: "An existing NotificationBox recipient for the target does not exist. You must pass insert=true to create a new recipient.",
@@ -420,8 +420,8 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  *
  * Thrown during {@link NotificationUser} creation when the provided UID cannot be found in Firebase Auth.
  *
- * @param uid - the Firebase Auth user ID that was not found
- * @returns a precondition conflict error with the invalid-uid error code
+ * @param uid - The Firebase Auth user ID that was not found.
+ * @returns A precondition conflict error with the invalid-uid error code.
  */ function notificationUserInvalidUidForCreateError(uid) {
     return firebaseServer.preconditionConflictError({
         message: "The user with the uid '".concat(uid, "' does not exist. Cannot create a NotificationUser for them."),
@@ -437,8 +437,8 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  * Thrown when a {@link NotificationUser} has the `bk` (blocked-from-add) flag set on their config
  * and an operation attempts to insert them into a {@link NotificationBox}'s recipient list.
  *
- * @param uid - the Firebase Auth user ID of the blocked user
- * @returns a precondition conflict error with the blocked-from-add error code
+ * @param uid - The Firebase Auth user ID of the blocked user.
+ * @returns A precondition conflict error with the blocked-from-add error code.
  */ function notificationUserBlockedFromBeingAddedToRecipientsError(uid) {
     return firebaseServer.preconditionConflictError({
         message: "The user with the uid '".concat(uid, "' has blocked themselves from from being added recipients."),
@@ -454,8 +454,8 @@ var MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST =
  * Thrown when a {@link NotificationUser} has the `lk` (locked) flag set on their config
  * and an operation attempts to modify their recipient settings on a {@link NotificationBox}.
  *
- * @param uid - the Firebase Auth user ID of the locked user
- * @returns a precondition conflict error with the locked-config error code
+ * @param uid - The Firebase Auth user ID of the locked user.
+ * @returns A precondition conflict error with the locked-config error code.
  */ function notificationUserLockedConfigFromBeingUpdatedError(uid) {
     return firebaseServer.preconditionConflictError({
         message: "The user with the uid '".concat(uid, "' has locked their config from being updated."),
@@ -673,8 +673,8 @@ function _ts_generator$g(thisArg, body) {
  * Sets the creation timestamp to now, associates the summary with the given model key,
  * and initializes with an empty notifications array.
  *
- * @param model - the model key to associate the summary with
- * @returns a blank {@link NotificationSummary} with creation timestamp and empty notifications
+ * @param model - The model key to associate the summary with.
+ * @returns A blank {@link NotificationSummary} with creation timestamp and empty notifications.
  *
  * @example
  * ```ts
@@ -697,8 +697,8 @@ function _ts_generator$g(thisArg, body) {
  *
  * Recipients are each configurable and may be defined with as little info as a single contact info, or have multiple contact info pieces associated with them.
  *
- * @param input - the notification, box, auth service, and recipient configuration
- * @returns channel-specific recipient lists (email, text, notification summary) ready for delivery
+ * @param input - The notification, box, auth service, and recipient configuration.
+ * @returns Channel-specific recipient lists (email, text, notification summary) ready for delivery.
  */ function expandNotificationRecipients(input) {
     return _async_to_generator$g(function() {
         var _ref, notificationUserAccessor, authService, notification, notificationBox, inputGlobalRecipients, recipientFlagOverride, inputNotificationSummaryIdForUid, inputOnlySendToExplicitlyEnabledRecipients, inputOnlyTextExplicitlyEnabledRecipients, notificationBoxId, notificationSummaryIdForUid, notificationTemplateType, recipientFlag, onlyTextExplicitlyEnabledRecipients, onlySendToExplicitlyEnabledRecipients, onlyEmailExplicitlyEnabledRecipients, onlySendNotificationSummaryExplicitlyEnabledRecipients, _allowedNotificationRecipients, canSendToGlobalRecipients, canSendToBoxRecipients, canSendToExplicitRecipients, initialExplicitRecipients, initialGlobalRecipients, explicitRecipients, globalRecipients, explicitAndGlobalRecipients, allBoxRecipientConfigs, recipientUids, relevantBoxRecipientConfigs, nonNotificationBoxUidRecipientConfigs, otherNotificationUserUidOptOuts, otherNotificationUserUidSendExclusions, notificationUserRecipientConfigs, nonNotificationBoxRecipientUids, notificationUserDocuments, notificationUsers, otherRecipientConfigs, explicitOtherRecipientEmailAddresses, explicitOtherRecipientTextNumbers, explicitOtherRecipientNotificationSummaryIds, allUserDetails, userDetailsMap, _internal, emails, emailUidsSet, texts, textUidsSet, notificationSummaries, notificationSummaryKeysSet, notificationSummaryUidsSet, result;
@@ -1100,10 +1100,10 @@ function _ts_generator$g(thisArg, body) {
  *
  * Also re-applies send exclusions to the updated config array.
  *
- * @param input - the current state and intended change
- * @returns the updated box config array and notification box recipient, if changes occurred
- * @throws notificationUserBlockedFromBeingAddedToRecipientsError when inserting a blocked user
- * @throws notificationUserLockedConfigFromBeingUpdatedError when updating a locked user's config
+ * @param input - The current state and intended change.
+ * @returns The updated box config array and notification box recipient, if changes occurred.
+ * @throws {Error} NotificationUserBlockedFromBeingAddedToRecipientsError when inserting a blocked user.
+ * @throws {Error} NotificationUserLockedConfigFromBeingUpdatedError when updating a locked user's config.
  */ function updateNotificationUserNotificationBoxRecipientConfig(input) {
     var _notificationUser_bc_currentNotificationUserBoxIndex;
     var notificationBoxId = input.notificationBoxId, notificationUserId = input.notificationUserId, notificationUser = input.notificationUser, insertingRecipientIntoNotificationBox = input.insertingRecipientIntoNotificationBox, removeRecipientFromNotificationBox = input.removeRecipientFromNotificationBox, notificationBoxRecipient = input.notificationBoxRecipient;
@@ -1197,9 +1197,9 @@ function _ts_generator$g(thisArg, body) {
  * If `removeFromCompletedCheckpoints` is set, removes only those specific checkpoints.
  * Otherwise, returns the original array unchanged.
  *
- * @param inputCompletions - the current list of completed checkpoint strings
- * @param handleTaskResult - the handler result containing removal instructions
- * @returns the filtered completions array with specified checkpoints removed
+ * @param inputCompletions - The current list of completed checkpoint strings.
+ * @param handleTaskResult - The handler result containing removal instructions.
+ * @returns The filtered completions array with specified checkpoints removed.
  *
  * @example
  * ```ts
@@ -1494,8 +1494,8 @@ function _ts_generator$f(thisArg, body) {
  * Creates a concrete {@link NotificationServerActions} implementation by wiring each action
  * to its factory function using the provided context.
  *
- * @param context - the fully assembled notification server actions context
- * @returns a fully wired {@link NotificationServerActions} instance
+ * @param context - The fully assembled notification server actions context.
+ * @returns A fully wired {@link NotificationServerActions} instance.
  *
  * @example
  * ```ts
@@ -1527,8 +1527,8 @@ function _ts_generator$f(thisArg, body) {
  * Validates the UID exists in Firebase Auth, then creates a new {@link NotificationUser} document
  * with empty default and global configs. Throws if the UID is not found in Auth.
  *
- * @param context - the notification server actions context with auth and collection access
- * @returns a transform-and-validate function that creates a new notification user document
+ * @param context - The notification server actions context with auth and collection access.
+ * @returns A transform-and-validate function that creates a new notification user document.
  */ function createNotificationUserFactory(context) {
     var firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, notificationUserCollection = context.notificationUserCollection, authService = context.authService;
     return firebaseServerActionTransformFunctionFactory(firebase.createNotificationUserParamsType, function(params) {
@@ -1594,8 +1594,8 @@ function _ts_generator$f(thisArg, body) {
  * box configs (`bc`). When the global config changes, iterates all box configs to propagate
  * effective recipient changes and marks affected entries for sync.
  *
- * @param context - the notification server actions context with Firestore and collection access
- * @returns a transform-and-validate function that updates an existing notification user document
+ * @param context - The notification server actions context with Firestore and collection access.
+ * @returns A transform-and-validate function that updates an existing notification user document.
  */ function updateNotificationUserFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, notificationUserCollection = context.notificationUserCollection, appNotificationTemplateTypeInfoRecordService = context.appNotificationTemplateTypeInfoRecordService;
     return firebaseServerActionTransformFunctionFactory(firebase.updateNotificationUserParamsType, function(params) {
@@ -1636,26 +1636,29 @@ function _ts_generator$f(thisArg, body) {
                                                                         updateTemplate.gc = nextGc;
                                                                         // iterate and update any box config that has the effective recipient change
                                                                         updateTemplate.bc = notificationUser.bc.map(function(currentConfig) {
+                                                                            var updatedConfig = currentConfig;
                                                                             // check item isn't already marked for sync or marked as removed
-                                                                            if (currentConfig.ns === true || currentConfig.rm === true) {
-                                                                                return currentConfig;
+                                                                            if (currentConfig.ns !== true && currentConfig.rm !== true) {
+                                                                                var currentEffectiveRecipient = firebase.effectiveNotificationBoxRecipientConfig({
+                                                                                    uid: notificationUser.uid,
+                                                                                    appNotificationTemplateTypeInfoRecordService: appNotificationTemplateTypeInfoRecordService,
+                                                                                    gc: notificationUser.gc,
+                                                                                    boxConfig: currentConfig
+                                                                                });
+                                                                                var nextEffectiveRecipient = firebase.effectiveNotificationBoxRecipientConfig({
+                                                                                    uid: notificationUser.uid,
+                                                                                    appNotificationTemplateTypeInfoRecordService: appNotificationTemplateTypeInfoRecordService,
+                                                                                    gc: nextGc,
+                                                                                    boxConfig: currentConfig
+                                                                                });
+                                                                                var effectiveConfigChanged = !util.areEqualPOJOValues(currentEffectiveRecipient, nextEffectiveRecipient);
+                                                                                if (effectiveConfigChanged) {
+                                                                                    updatedConfig = _object_spread_props$a(_object_spread$b({}, currentConfig), {
+                                                                                        ns: true
+                                                                                    });
+                                                                                }
                                                                             }
-                                                                            var currentEffectiveRecipient = firebase.effectiveNotificationBoxRecipientConfig({
-                                                                                uid: notificationUser.uid,
-                                                                                appNotificationTemplateTypeInfoRecordService: appNotificationTemplateTypeInfoRecordService,
-                                                                                gc: notificationUser.gc,
-                                                                                boxConfig: currentConfig
-                                                                            });
-                                                                            var nextEffectiveRecipient = firebase.effectiveNotificationBoxRecipientConfig({
-                                                                                uid: notificationUser.uid,
-                                                                                appNotificationTemplateTypeInfoRecordService: appNotificationTemplateTypeInfoRecordService,
-                                                                                gc: nextGc,
-                                                                                boxConfig: currentConfig
-                                                                            });
-                                                                            var effectiveConfigChanged = !util.areEqualPOJOValues(currentEffectiveRecipient, nextEffectiveRecipient);
-                                                                            return effectiveConfigChanged ? _object_spread_props$a(_object_spread$b({}, currentConfig), {
-                                                                                ns: true
-                                                                            }) : currentConfig;
+                                                                            return updatedConfig;
                                                                         });
                                                                     }
                                                                 }
@@ -1716,8 +1719,8 @@ var MAX_NOTIFICATION_BOXES_TO_UPDATE_PER_BATCH = 50;
  * and merging the user's preferences back into the box's recipient list. Handles removed entries
  * and cleans up stale box references.
  *
- * @param context - the notification server actions context with Firestore and collection access
- * @returns a transform-and-validate function that resyncs a notification user's box configurations
+ * @param context - The notification server actions context with Firestore and collection access.
+ * @returns A transform-and-validate function that resyncs a notification user's box configurations.
  */ function resyncNotificationUserFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, notificationBoxCollection = context.notificationBoxCollection, notificationUserCollection = context.notificationUserCollection, appNotificationTemplateTypeInfoRecordService = context.appNotificationTemplateTypeInfoRecordService;
     return firebaseServerActionTransformFunctionFactory(firebase.resyncNotificationUserParamsType, function() {
@@ -1953,8 +1956,8 @@ var MAX_NOTIFICATION_BOXES_TO_UPDATE_PER_BATCH = 50;
  * for entries with `ns=true`, then calling the resync logic for each in parallel
  * (up to 5 concurrent tasks). Loops until no more flagged users are found.
  *
- * @param context - the notification server actions context with collection access
- * @returns an async function that resyncs all flagged notification users and returns aggregate results
+ * @param context - The notification server actions context with collection access.
+ * @returns An async function that resyncs all flagged notification users and returns aggregate results.
  */ function resyncAllNotificationUsersFactory(context) {
     var notificationUserCollection = context.notificationUserCollection;
     var resyncNotificationUser = resyncNotificationUserFactory(context);
@@ -2041,8 +2044,8 @@ var MAX_NOTIFICATION_BOXES_TO_UPDATE_PER_BATCH = 50;
  * Creates a new {@link NotificationSummary} document for a model, generating the summary ID
  * from the model key and initializing it with a blank template.
  *
- * @param context - the notification server actions context with collection access
- * @returns a transform-and-validate function that creates a new notification summary document
+ * @param context - The notification server actions context with collection access.
+ * @returns A transform-and-validate function that creates a new notification summary document.
  */ function createNotificationSummaryFactory(context) {
     var firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, notificationSummaryCollection = context.notificationSummaryCollection;
     return firebaseServerActionTransformFunctionFactory(firebase.createNotificationSummaryParamsType, function(params) {
@@ -2086,8 +2089,8 @@ var MAX_NOTIFICATION_BOXES_TO_UPDATE_PER_BATCH = 50;
  * Updates an existing {@link NotificationSummary} document's owner or setup flag.
  * Runs within a Firestore transaction to ensure consistency.
  *
- * @param context - the notification server actions context
- * @returns a transform-and-validate function that updates an existing notification summary document
+ * @param context - The notification server actions context.
+ * @returns A transform-and-validate function that updates an existing notification summary document.
  */ function updateNotificationSummaryFactory(context) {
     var firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     return firebaseServerActionTransformFunctionFactory(firebase.updateNotificationSummaryParamsType, function(params) {
@@ -2143,8 +2146,8 @@ var MAX_NOTIFICATION_BOXES_TO_UPDATE_PER_BATCH = 50;
  * Checks for existing boxes and throws if one already exists for the model.
  * Also syncs initial recipients with their corresponding {@link NotificationUser} documents.
  *
- * @param context - the base notification server actions context with collection access
- * @returns an async function that creates a notification box within a transaction and returns the document and template
+ * @param context - The base notification server actions context with collection access.
+ * @returns An async function that creates a notification box within a transaction and returns the document and template.
  */ function createNotificationBoxInTransactionFactory(context) {
     var notificationBoxCollection = context.notificationBoxCollection;
     return function(params, transaction) {
@@ -2194,8 +2197,8 @@ var MAX_NOTIFICATION_BOXES_TO_UPDATE_PER_BATCH = 50;
  * Wraps {@link createNotificationBoxInTransactionFactory} in a Firestore transaction
  * and follows the transform-and-validate pattern.
  *
- * @param context - the notification server actions context with Firestore and collection access
- * @returns a transform-and-validate function that creates a new notification box document
+ * @param context - The notification server actions context with Firestore and collection access.
+ * @returns A transform-and-validate function that creates a new notification box document.
  */ function createNotificationBoxFactory(context) {
     var firestoreContext = context.firestoreContext, notificationBoxCollection = context.notificationBoxCollection, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var createNotificationBoxInTransaction = createNotificationBoxInTransactionFactory(context);
@@ -2258,8 +2261,8 @@ var MAX_NOTIFICATION_BOXES_TO_UPDATE_PER_BATCH = 50;
  * Currently a no-op placeholder that returns the document unchanged.
  * Reserved for future box-level update logic.
  *
- * @param context - the notification server actions context (destructured for the transform factory)
- * @returns a transform-and-validate function that returns the notification box document unchanged
+ * @param context - The notification server actions context (destructured for the transform factory)
+ * @returns A transform-and-validate function that returns the notification box document unchanged.
  */ function updateNotificationBoxFactory(context) {
     var firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     return firebaseServerActionTransformFunctionFactory(firebase.updateNotificationBoxParamsType, function() {
@@ -2289,8 +2292,8 @@ var MAX_NOTIFICATION_BOXES_TO_UPDATE_PER_BATCH = 50;
  * Manages the exclusion list (`x`) on both the box recipient and the corresponding
  * {@link NotificationUser}'s send exclusion array, keeping them in sync.
  *
- * @param context - the base notification server actions context with collection access
- * @returns an async function that updates recipient exclusions within a transaction
+ * @param context - The base notification server actions context with collection access.
+ * @returns An async function that updates recipient exclusions within a transaction.
  */ function updateNotificationBoxRecipientExclusionInTransactionFactory(context) {
     var notificationBoxCollection = context.notificationBoxCollection, notificationUserCollection = context.notificationUserCollection;
     return function(input, transaction) {
@@ -2383,8 +2386,8 @@ var MAX_NOTIFICATION_BOXES_TO_UPDATE_PER_BATCH = 50;
  * Syncs changes with the recipient's {@link NotificationUser} document and manages
  * recipient index assignment via a sorted-values free-index calculator.
  *
- * @param context - the base notification server actions context with auth and collection access
- * @returns an async function that updates a recipient on a notification box within a transaction
+ * @param context - The base notification server actions context with auth and collection access.
+ * @returns An async function that updates a recipient on a notification box within a transaction.
  */ function updateNotificationBoxRecipientInTransactionFactory(context) {
     var authService = context.authService, notificationBoxCollection = context.notificationBoxCollection, notificationUserCollection = context.notificationUserCollection;
     var createNotificationBoxInTransaction = createNotificationBoxInTransactionFactory(context);
@@ -2631,8 +2634,8 @@ var MAX_NOTIFICATION_BOXES_TO_UPDATE_PER_BATCH = 50;
  * Wraps the in-transaction recipient update logic, handling both recipient changes
  * and send exclusion updates in a single Firestore transaction.
  *
- * @param context - the notification server actions context with Firestore and collection access
- * @returns a transform-and-validate function that updates a recipient on a notification box
+ * @param context - The notification server actions context with Firestore and collection access.
+ * @returns A transform-and-validate function that updates a recipient on a notification box.
  */ function updateNotificationBoxRecipientFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var updateNotificationBoxRecipientInTransaction = updateNotificationBoxRecipientInTransactionFactory(context);
@@ -2735,8 +2738,8 @@ var NOTIFICATION_TASK_TYPE_FAILURE_DELAY_MS = dateFns.hoursToMilliseconds(NOTIFI
  * Supports throttling via `sendAt` time, configurable send flags, and task-based
  * async workflows for notifications that require multi-step processing.
  *
- * @param context - the notification server actions context with template, send, and task services
- * @returns a transform-and-validate function that processes and sends a notification document
+ * @param context - The notification server actions context with template, send, and task services.
+ * @returns A transform-and-validate function that processes and sends a notification document.
  */ function sendNotificationFactory(context) {
     var appNotificationTemplateTypeInfoRecordService = context.appNotificationTemplateTypeInfoRecordService, notificationSendService = context.notificationSendService, notificationTaskService = context.notificationTaskService, notificationTemplateService = context.notificationTemplateService, authService = context.authService, notificationBoxCollection = context.notificationBoxCollection, notificationCollectionGroup = context.notificationCollectionGroup, notificationUserCollection = context.notificationUserCollection, firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var createNotificationBoxInTransaction = createNotificationBoxInTransactionFactory(context);
@@ -3948,8 +3951,8 @@ var NOTIFICATION_TASK_TYPE_FAILURE_DELAY_MS = dateFns.hoursToMilliseconds(NOTIFI
  * Continues processing batches until no more queued notifications are found
  * or the time budget is exhausted.
  *
- * @param context - the notification server actions context with collection group and send factory access
- * @returns a transform-and-validate function that processes all queued notifications and returns aggregate results
+ * @param context - The notification server actions context with collection group and send factory access.
+ * @returns A transform-and-validate function that processes all queued notifications and returns aggregate results.
  */ function sendQueuedNotificationsFactory(context) {
     var firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, notificationCollectionGroup = context.notificationCollectionGroup;
     var sendNotification = sendNotificationFactory(context);
@@ -4118,8 +4121,8 @@ var NOTIFICATION_TASK_TYPE_FAILURE_DELAY_MS = dateFns.hoursToMilliseconds(NOTIFI
  * past the retention window) and deletes them in batches. Continues until no more
  * cleanup-eligible notifications are found.
  *
- * @param context - the notification server actions context with Firestore and collection access
- * @returns a transform-and-validate function that cleans up sent notification documents and returns aggregate results
+ * @param context - The notification server actions context with Firestore and collection access.
+ * @returns A transform-and-validate function that cleans up sent notification documents and returns aggregate results.
  */ function cleanupSentNotificationsFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, notificationCollectionGroup = context.notificationCollectionGroup, notificationBoxCollection = context.notificationBoxCollection, notificationWeekCollectionFactory = context.notificationWeekCollectionFactory, notificationLoggedEventDayCollectionFactory = context.notificationLoggedEventDayCollectionFactory, notificationLoggedEventDayPagedItemsCollectionFactory = context.notificationLoggedEventDayPagedItemsCollectionFactory;
     return firebaseServerActionTransformFunctionFactory(firebase.cleanupSentNotificationsParamsType, function() {
@@ -4514,8 +4517,8 @@ var NOTIFICATION_TASK_TYPE_FAILURE_DELAY_MS = dateFns.hoursToMilliseconds(NOTIFI
  * For each old day, all docs in the day's paged subcollection are deleted before the wrapper doc
  * itself, so a partial failure leaves the index pointing at zero pages rather than orphaned ones.
  *
- * @param context - the notification server actions context with paged-items collection access
- * @returns a transform-and-validate function that purges old logged-event days and returns aggregate counts
+ * @param context - The notification server actions context with paged-items collection access.
+ * @returns A transform-and-validate function that purges old logged-event days and returns aggregate counts.
  */ function cleanupOldNotificationLoggedEventDaysFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, notificationLoggedEventDayCollectionGroup = context.notificationLoggedEventDayCollectionGroup, notificationLoggedEventDayPagedItemsCollectionFactory = context.notificationLoggedEventDayPagedItemsCollectionFactory;
     function deleteOldLoggedEventDay(dayDocument) {
@@ -4826,8 +4829,8 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
  * Creates a concrete {@link NotificationInitServerActions} implementation by wiring each
  * initialization action to its factory function.
  *
- * @param context - the initialization context with template functions and Firestore access
- * @returns a fully wired {@link NotificationInitServerActions} instance
+ * @param context - The initialization context with template functions and Firestore access.
+ * @returns A fully wired {@link NotificationInitServerActions} instance.
  *
  * @example
  * ```ts
@@ -4853,9 +4856,9 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
  *
  * Skips initialization if the model is already initialized, optionally throwing an error.
  *
- * @param input - the document, transaction, template function, and options
- * @returns an object with `initialized` and `alreadyInitialized` boolean flags
- * @throws notificationModelAlreadyInitializedError when `throwErrorIfAlreadyInitialized` is true
+ * @param input - The document, transaction, template function, and options.
+ * @returns An object with `initialized` and `alreadyInitialized` boolean flags.
+ * @throws {Error} NotificationModelAlreadyInitializedError when `throwErrorIfAlreadyInitialized` is true.
  */ function initializeNotificationModelInTransaction(input) {
     return _async_to_generator$e(function() {
         var makeTemplateFunction, throwErrorIfAlreadyInitialized, transaction, documentInTransaction, notificationBox, initialized, alreadyInitialized, flatModelKey, modelKey, modelCollectionName, _$input, template;
@@ -4957,8 +4960,8 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
  * Loads the box document in the transaction, reads its current data, and delegates
  * to {@link initializeNotificationModelInTransaction} with the box-specific template function.
  *
- * @param context - the initialization context with collection references and template functions
- * @returns an async function that initializes a notification box given params, document, and transaction
+ * @param context - The initialization context with collection references and template functions.
+ * @returns An async function that initializes a notification box given params, document, and transaction.
  */ function initializeNotificationBoxInTransactionFactory(context) {
     var notificationBoxCollection = context.notificationBoxCollection, makeTemplateForNotificationBoxInitialization = context.makeTemplateForNotificationBoxInitialization;
     return function(params, notificationBoxDocument, transaction) {
@@ -4996,8 +4999,8 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
  * Wraps the in-transaction initialization in a Firestore transaction
  * and follows the transform-and-validate pattern.
  *
- * @param context - the initialization context with Firestore access and template functions
- * @returns a transform-and-validate function that initializes a single notification box
+ * @param context - The initialization context with Firestore access and template functions.
+ * @returns A transform-and-validate function that initializes a single notification box.
  */ function initializeNotificationBoxFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var initializeNotificationBoxInTransaction = initializeNotificationBoxInTransactionFactory(context);
@@ -5039,8 +5042,8 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
  * by querying for entries with `s=true` (setup needed), then initializing each in
  * parallel (up to 5 concurrent tasks). Loops until no more flagged boxes are found.
  *
- * @param context - the initialization context with Firestore access and collection references
- * @returns a transform-and-validate function that batch-initializes all applicable notification boxes
+ * @param context - The initialization context with Firestore access and collection references.
+ * @returns A transform-and-validate function that batch-initializes all applicable notification boxes.
  */ function initializeAllApplicableNotificationBoxesFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, notificationBoxCollection = context.notificationBoxCollection;
     var initializeNotificationBoxInTransaction = initializeNotificationBoxInTransactionFactory(context);
@@ -5054,7 +5057,7 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
                             var notificationBoxesVisited, notificationBoxesSucceeded, notificationBoxesFailed, notificationBoxesAlreadyInitialized, initializeNotificationBoxParams, initializeNotificationBoxesResults, found, result;
                             function initializeNotificationBoxes() {
                                 return _async_to_generator$e(function() {
-                                    var query, notificationBoxDocuments, result;
+                                    var query, notificationBoxDocuments;
                                     return _ts_generator$e(this, function(_state) {
                                         switch(_state.label){
                                             case 0:
@@ -5066,7 +5069,7 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
                                             case 1:
                                                 notificationBoxDocuments = _state.sent();
                                                 return [
-                                                    4,
+                                                    2,
                                                     util.performAsyncTasks(notificationBoxDocuments, function(notificationBoxDocument) {
                                                         return _async_to_generator$e(function() {
                                                             return _ts_generator$e(this, function(_state) {
@@ -5082,12 +5085,6 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
                                                         maxParallelTasks: 5
                                                     })
                                                 ];
-                                            case 2:
-                                                result = _state.sent();
-                                                return [
-                                                    2,
-                                                    result
-                                                ];
                                         }
                                     });
                                 })();
@@ -5159,8 +5156,8 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
  * Loads the summary document in the transaction, reads its current data, and delegates
  * to {@link initializeNotificationModelInTransaction} with the summary-specific template function.
  *
- * @param context - the initialization context with collection references and template functions
- * @returns an async function that initializes a notification summary given params, document, and transaction
+ * @param context - The initialization context with collection references and template functions.
+ * @returns An async function that initializes a notification summary given params, document, and transaction.
  */ function initializeNotificationSummaryInTransactionFactory(context) {
     var notificationSummaryCollection = context.notificationSummaryCollection, makeTemplateForNotificationSummaryInitialization = context.makeTemplateForNotificationSummaryInitialization;
     return function(params, notificationSummaryDocument, transaction) {
@@ -5198,8 +5195,8 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
  * Wraps the in-transaction summary initialization in a Firestore transaction
  * and follows the transform-and-validate pattern.
  *
- * @param context - the initialization context with Firestore access and template functions
- * @returns a transform-and-validate function that initializes a single notification summary
+ * @param context - The initialization context with Firestore access and template functions.
+ * @returns A transform-and-validate function that initializes a single notification summary.
  */ function initializeNotificationSummaryFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var initializeNotificationSummaryInTransaction = initializeNotificationSummaryInTransactionFactory(context);
@@ -5241,8 +5238,8 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
  * by querying for entries with `s=true` (setup needed), then initializing each in
  * parallel (up to 5 concurrent tasks). Loops until no more flagged summaries are found.
  *
- * @param context - the initialization context with Firestore access and collection references
- * @returns a transform-and-validate function that batch-initializes all applicable notification summaries
+ * @param context - The initialization context with Firestore access and collection references.
+ * @returns A transform-and-validate function that batch-initializes all applicable notification summaries.
  */ function initializeAllApplicableNotificationSummariesFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, notificationSummaryCollection = context.notificationSummaryCollection;
     var initializeNotificationSummaryInTransaction = initializeNotificationSummaryInTransactionFactory(context);
@@ -5256,7 +5253,7 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
                             var notificationSummariesVisited, notificationSummariesSucceeded, notificationSummariesFailed, notificationSummariesAlreadyInitialized, initializeNotificationSummaryParams, initializeNotificationSummariesResults, found, result;
                             function initializeNotificationSummaries() {
                                 return _async_to_generator$e(function() {
-                                    var query, notificationSummaryDocuments, result;
+                                    var query, notificationSummaryDocuments;
                                     return _ts_generator$e(this, function(_state) {
                                         switch(_state.label){
                                             case 0:
@@ -5268,7 +5265,7 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
                                             case 1:
                                                 notificationSummaryDocuments = _state.sent();
                                                 return [
-                                                    4,
+                                                    2,
                                                     util.performAsyncTasks(notificationSummaryDocuments, function(notificationSummaryDocument) {
                                                         return _async_to_generator$e(function() {
                                                             return _ts_generator$e(this, function(_state) {
@@ -5284,12 +5281,6 @@ var MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_
                                                         maxParallelTasks: 5
                                                     })
                                                 ];
-                                            case 2:
-                                                result = _state.sent();
-                                                return [
-                                                    2,
-                                                    result
-                                                ];
                                         }
                                     });
                                 })();
@@ -5582,8 +5573,8 @@ function _ts_generator$d(thisArg, body) {
             /**
      * Returns the default factory and optional type-specific config for the given template type.
      *
-     * @param type - the notification template type to look up
-     * @returns a tuple of [defaultFactory, typeConfig] where either may be undefined
+     * @param type - The notification template type to look up.
+     * @returns A tuple of [defaultFactory, typeConfig] where either may be undefined.
      */ key: "configPairForType",
             value: function configPairForType(type) {
                 return [
@@ -5597,8 +5588,8 @@ function _ts_generator$d(thisArg, body) {
      * Creates a {@link NotificationTemplateServiceInstance} scoped to a single template type,
      * pre-wired with the resolved factory for that type.
      *
-     * @param type - the notification template type
-     * @returns a new {@link NotificationTemplateServiceInstance} bound to the given type
+     * @param type - The notification template type.
+     * @returns A new {@link NotificationTemplateServiceInstance} bound to the given type.
      */ key: "templateInstanceForType",
             value: function templateInstanceForType(type) {
                 return notificationTemplateServiceInstance(this, type);
@@ -5618,9 +5609,9 @@ exports.NotificationTemplateService = __decorate([
  * Resolves the factory from the service's type-specific config first, falling back to
  * a no-content default factory when no config is registered for the type.
  *
- * @param service - the parent template service
- * @param type - the template type to bind
- * @returns a {@link NotificationTemplateServiceInstance} with the resolved factory for the type
+ * @param service - The parent template service.
+ * @param type - The template type to bind.
+ * @returns A {@link NotificationTemplateServiceInstance} with the resolved factory for the type.
  *
  * @example
  * ```ts
@@ -5841,9 +5832,9 @@ function _ts_generator$c(thisArg, body) {
  *
  * Does not support Firestore transactions, as running should occur outside of a transaction.
  *
- * @param input - creation and run configuration
- * @returns the creation pair result with optional send/enqueue outcomes
- * @throws Error if the notification template is not flagged as unique
+ * @param input - Creation and run configuration.
+ * @returns The creation pair result with optional send/enqueue outcomes.
+ * @throws {Error} If the notification template is not flagged as unique.
  *
  * @example
  * ```ts
@@ -6200,9 +6191,9 @@ function _ts_generator$b(thisArg, body) {
 };
 /**
  * Creates a new NotificationExpediteServiceInstance with the input NotificationExpediteService.
- 
- * @param notificationExpediteService - the expedite service to use for sending
- * @returns a new {@link NotificationExpediteServiceInstance} with an internal queue
+ *
+ * @param notificationExpediteService - The expedite service to use for sending.
+ * @returns A new {@link NotificationExpediteServiceInstance} with an internal queue.
  */ function notificationExpediteServiceInstance(notificationExpediteService) {
     var _documentsToSend = [];
     var initialize = function initialize() {
@@ -6261,7 +6252,7 @@ function _ts_generator$b(thisArg, body) {
             /**
      * Returns the configured NotificationServerActions instance.
      *
-     * @returns the current {@link NotificationServerActions} instance
+     * @returns The current {@link NotificationServerActions} instance.
      */ key: "getNotificationServerActions",
             value: function getNotificationServerActions() {
                 return this._notificationServerActions;
@@ -6271,7 +6262,7 @@ function _ts_generator$b(thisArg, body) {
             /**
      * Sets the NotificationServerActions instance to use.
      *
-     * @param notificationServerActions - the actions instance to configure
+     * @param notificationServerActions - The actions instance to configure.
      */ key: "setNotificationServerActions",
             value: function setNotificationServerActions(notificationServerActions) {
                 this._notificationServerActions = notificationServerActions;
@@ -6320,7 +6311,7 @@ exports.MutableNotificationExpediteService = __decorate([
  *
  * This should generally be used in the global module of an app.
  *
- * @returns an array of NestJS providers for both MutableNotificationExpediteService and NotificationExpediteService
+ * @returns Array of NestJS providers for both MutableNotificationExpediteService and NotificationExpediteService.
  */ function provideMutableNotificationExpediteService() {
     return [
         exports.MutableNotificationExpediteService,
@@ -6335,7 +6326,7 @@ exports.MutableNotificationExpediteService = __decorate([
  *
  * This should generally be used in the global module of an app.
  *
- * @returns an array of abstract classes to export from the NestJS module
+ * @returns The abstract classes to export from the NestJS module.
  */ function exportMutableNotificationExpediteService() {
     return [
         NotificationExpediteService,
@@ -6425,12 +6416,12 @@ function _unsupported_iterable_to_array$6(o, minLen) {
  * Factory that assembles the full {@link NotificationServerActionsContext} by combining
  * the base context with the template, send, task, and expedite services.
  *
- * @param context - the base server actions context
- * @param notificationTemplateService - resolves message factories for notification template types
- * @param notificationSendService - handles sending notification messages
- * @param notificationTaskService - handles notification task dispatch
- * @param notificationsExpediteService - expedites immediate notification delivery
- * @returns the assembled {@link NotificationServerActionsContext}
+ * @param context - The base server actions context.
+ * @param notificationTemplateService - Resolves message factories for notification template types.
+ * @param notificationSendService - Handles sending notification messages.
+ * @param notificationTaskService - Handles notification task dispatch.
+ * @param notificationsExpediteService - Expedites immediate notification delivery.
+ * @returns The assembled {@link NotificationServerActionsContext}
  */ // eslint-disable-next-line @typescript-eslint/max-params
 function notificationServerActionsContextFactory(context, notificationTemplateService, notificationSendService, notificationTaskService, notificationsExpediteService) {
     return _object_spread_props$7(_object_spread$7({}, context), {
@@ -6443,8 +6434,8 @@ function notificationServerActionsContextFactory(context, notificationTemplateSe
 /**
  * Factory that creates a {@link NotificationServerActions} instance from the assembled context.
  *
- * @param context - the assembled notification server actions context
- * @returns a new {@link NotificationServerActions} instance
+ * @param context - The assembled notification server actions context.
+ * @returns A new {@link NotificationServerActions} instance.
  */ function notificationServerActionsFactory(context) {
     return notificationServerActions(context);
 }
@@ -6452,9 +6443,9 @@ function notificationServerActionsContextFactory(context, notificationTemplateSe
  * Factory that creates a {@link NotificationInitServerActions} instance by merging the
  * server actions context with the init-specific configuration.
  *
- * @param context - the assembled notification server actions context
- * @param notificationInitServerActionsContextConfig - init-specific configuration
- * @returns a new {@link NotificationInitServerActions} instance
+ * @param context - The assembled notification server actions context.
+ * @param notificationInitServerActionsContextConfig - Init-specific configuration.
+ * @returns A new {@link NotificationInitServerActions} instance.
  */ function notificationInitServerActionsFactory(context, notificationInitServerActionsContextConfig) {
     return notificationInitServerActions(_object_spread$7({}, context, notificationInitServerActionsContextConfig));
 }
@@ -6470,8 +6461,8 @@ function notificationServerActionsContextFactory(context, notificationTemplateSe
  *
  * Be sure the class that delares the module using this function also extends AbstractAppNotificationModule.
  *
- * @param config - module metadata configuration including dependency module and additional providers
- * @returns the assembled {@link ModuleMetadata} for the notification module
+ * @param config - Module metadata configuration including dependency module and additional providers.
+ * @returns The assembled {@link ModuleMetadata} for the notification module.
  */ function appNotificationModuleMetadata(config$1) {
     var dependencyModule = config$1.dependencyModule, imports = config$1.imports, exports$1 = config$1.exports, providers = config$1.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -6793,8 +6784,8 @@ function _ts_generator$a(thisArg, body) {
  *
  * Each summary update runs in a Firestore transaction to prevent concurrent write conflicts.
  *
- * @param config - service configuration including Firestore context and collection references
- * @returns a {@link NotificationSummarySendService} backed by Firestore
+ * @param config - Service configuration including Firestore context and collection references.
+ * @returns A {@link NotificationSummarySendService} backed by Firestore.
  *
  * @example
  * ```ts
@@ -7115,7 +7106,7 @@ function _ts_generator$9(thisArg, body) {
  * Useful as a placeholder when your app's notification pipeline is fully wired for SMS
  * but actual delivery is not yet enabled, avoiding the need for conditional logic elsewhere.
  *
- * @returns a no-op {@link NotificationTextSendService} that ignores all messages
+ * @returns A no-op {@link NotificationTextSendService} that ignores all messages.
  *
  * @example
  * ```ts
@@ -7295,8 +7286,8 @@ function _ts_generator$8(thisArg, body) {
  * finds the next uncompleted checkpoint in the flow and executes its handler function.
  * If all checkpoints are complete, the task is marked as done.
  *
- * @param config - handler configurations and optional validation list
- * @returns a {@link NotificationTaskService} that dispatches tasks to the registered handlers
+ * @param config - Handler configurations and optional validation list.
+ * @returns A {@link NotificationTaskService} that dispatches tasks to the registered handlers.
  *
  * @example
  * ```ts
@@ -7678,8 +7669,8 @@ function _ts_generator$7(thisArg, body) {
  * This is the primary entry point for building complex, multi-step notification task handlers
  * such as storage file processing or other async workflows.
  *
- * @param factoryConfig - shared configuration including the input function, cleanup logic, and task type
- * @returns a factory function that produces {@link NotificationTaskServiceTaskHandlerConfig} entries
+ * @param factoryConfig - Shared configuration including the input function, cleanup logic, and task type.
+ * @returns A factory function that produces {@link NotificationTaskServiceTaskHandlerConfig} entries.
  *
  * @example
  * ```ts
@@ -7703,8 +7694,9 @@ function _ts_generator$7(thisArg, body) {
         var processorFunctionForConfig = /**
          * Structure is similar to notificationTaskService(), but contained to handle the subtasks.
          *
-         * @param processorConfig - the processor configuration with target, flow, and cleanup
-         * @returns a processor with process and optional cleanup functions
+         * @param processorConfig - The processor configuration with target, flow, and cleanup.
+         * @returns A processor with process and optional cleanup functions.
+         * @throws {Error} When `processorConfig.flow` is empty or contains more than one non-subtask entry.
          */ function processorFunctionForConfig(processorConfig) {
             var inputFlows = processorConfig.flow, cleanup = processorConfig.cleanup, processorAllowRunMultipleParts = processorConfig.allowRunMultipleParts;
             var _separateValues = util.separateValues(inputFlows, function(x) {
@@ -8102,7 +8094,7 @@ function _ts_generator$7(thisArg, body) {
 /**
  * Creates a NotificationTaskSubTaskMissingRequiredDataTermination.
  *
- * @returns a new {@link NotificationTaskSubTaskMissingRequiredDataTermination} error instance
+ * @returns A new {@link NotificationTaskSubTaskMissingRequiredDataTermination} error instance.
  */ function notificationTaskSubTaskMissingRequiredDataTermination() {
     return new NotificationTaskSubTaskMissingRequiredDataTermination();
 }
@@ -8891,30 +8883,28 @@ var PDF_NAME_SMASK = pdfLib.PDFName.of('SMask');
 var PDF_NAME_MASK = pdfLib.PDFName.of('Mask');
 function isCompressibleImageStream(stream) {
     var dict = stream.dict;
+    var result = false;
     // Must be Type /XObject (when present) and Subtype /Image
     var type = dict.get(PDF_NAME_TYPE);
-    if (type !== undefined && !pdfNameEquals(type, PDF_NAME_XOBJECT)) {
-        return false;
-    }
-    var subtype = dict.get(PDF_NAME_SUBTYPE);
-    if (subtype === undefined || !pdfNameEquals(subtype, PDF_NAME_IMAGE)) {
-        return false;
-    }
-    // Skip images with masks; replacing them risks breaking the mask alignment.
-    if (dict.get(PDF_NAME_SMASK) !== undefined || dict.get(PDF_NAME_MASK) !== undefined) {
-        return false;
-    }
-    // Only DCTDecode (JPEG) streams in v1.
-    var filter = dict.get(PDF_NAME_FILTER);
-    var isDct = false;
-    if (filter !== undefined) {
-        if (_instanceof$1(filter, pdfLib.PDFArray)) {
-            isDct = filter.size() === 1 && pdfNameEquals(filter.get(0), PDF_NAME_DCTDECODE);
-        } else {
-            isDct = pdfNameEquals(filter, PDF_NAME_DCTDECODE);
+    var typeOk = type === undefined || pdfNameEquals(type, PDF_NAME_XOBJECT);
+    if (typeOk) {
+        var subtype = dict.get(PDF_NAME_SUBTYPE);
+        var subtypeOk = subtype !== undefined && pdfNameEquals(subtype, PDF_NAME_IMAGE);
+        // Skip images with masks; replacing them risks breaking the mask alignment.
+        var hasMask = dict.get(PDF_NAME_SMASK) !== undefined || dict.get(PDF_NAME_MASK) !== undefined;
+        if (subtypeOk && !hasMask) {
+            // Only DCTDecode (JPEG) streams in v1.
+            var filter = dict.get(PDF_NAME_FILTER);
+            if (filter !== undefined) {
+                if (_instanceof$1(filter, pdfLib.PDFArray)) {
+                    result = filter.size() === 1 && pdfNameEquals(filter.get(0), PDF_NAME_DCTDECODE);
+                } else {
+                    result = pdfNameEquals(filter, PDF_NAME_DCTDECODE);
+                }
+            }
         }
     }
-    return isDct;
+    return result;
 }
 function pdfNameEquals(candidate, name) {
     return _instanceof$1(candidate, pdfLib.PDFName) && candidate.asString() === name.asString();
@@ -8939,7 +8929,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that a storage file model has already been initialized.
  *
- * @returns a precondition-conflict HttpsError with the STORAGE_FILE_MODEL_ALREADY_INITIALIZED error code
+ * @returns A precondition-conflict HttpsError with the STORAGE_FILE_MODEL_ALREADY_INITIALIZED error code.
  */ function storageFileModelAlreadyInitializedError() {
     return firebaseServer.preconditionConflictError({
         message: "This model has already been initialized.",
@@ -8949,7 +8939,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the StorageFile is not flagged for group sync.
  *
- * @returns a precondition-conflict HttpsError with the STORAGE_FILE_NOT_FLAGGED_FOR_GROUPS_SYNC error code
+ * @returns A precondition-conflict HttpsError with the STORAGE_FILE_NOT_FLAGGED_FOR_GROUPS_SYNC error code.
  */ function storageFileNotFlaggedForGroupsSyncError() {
     return firebaseServer.preconditionConflictError({
         message: "This StorageFile has not been flagged for sync with its groups.",
@@ -8959,7 +8949,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the target uploaded file does not exist in storage.
  *
- * @returns a precondition-conflict HttpsError with the UPLOADED_FILE_DOES_NOT_EXIST error code
+ * @returns A precondition-conflict HttpsError with the UPLOADED_FILE_DOES_NOT_EXIST error code.
  */ function uploadedFileDoesNotExistError() {
     return firebaseServer.preconditionConflictError({
         message: "The target uploaded file does not exist.",
@@ -8969,7 +8959,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the file is not allowed to be initialized (rejected by the check function).
  *
- * @returns a precondition-conflict HttpsError with the UPLOADED_FILE_NOT_ALLOWED_TO_BE_INITIALIZED error code
+ * @returns A precondition-conflict HttpsError with the UPLOADED_FILE_NOT_ALLOWED_TO_BE_INITIALIZED error code.
  */ function uploadedFileIsNotAllowedToBeInitializedError() {
     return firebaseServer.preconditionConflictError({
         message: "The target uploaded file is not allowed to be initialized.",
@@ -8979,8 +8969,8 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the file initialization failed with the given result type.
  *
- * @param data - error data containing the result type that caused the failure
- * @returns an internal-server HttpsError with the UPLOADED_FILE_INITIALIZATION_FAILED error code and the result type
+ * @param data - Error data containing the result type that caused the failure.
+ * @returns An internal-server HttpsError with the UPLOADED_FILE_INITIALIZATION_FAILED error code and the result type.
  */ function uploadedFileInitializationFailedError(data) {
     return firebaseServer.internalServerError({
         message: 'The target uploaded file initialization failed with result type "'.concat(data.resultType, '".'),
@@ -8993,7 +8983,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the initialization result was discarded (e.g., the created file no longer exists).
  *
- * @returns an internal-server HttpsError with the UPLOADED_FILE_INITIALIZATION_DISCARDED error code
+ * @returns An internal-server HttpsError with the UPLOADED_FILE_INITIALIZATION_DISCARDED error code.
  */ function uploadedFileInitializationDiscardedError() {
     return firebaseServer.internalServerError({
         message: "The target uploaded file initialization was discarded.",
@@ -9003,7 +8993,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the StorageFile is not in a valid state for processing.
  *
- * @returns a precondition-conflict HttpsError with the STORAGE_FILE_PROCESSING_NOT_ALLOWED_FOR_INVALID_STATE error code
+ * @returns A precondition-conflict HttpsError with the STORAGE_FILE_PROCESSING_NOT_ALLOWED_FOR_INVALID_STATE error code.
  */ function storageFileProcessingNotAllowedForInvalidStateError() {
     return firebaseServer.preconditionConflictError({
         message: "The target StorageFileDocument must be in an OK state to be processed and processing not flagged as SHOULD_NOT_PROCESS.",
@@ -9013,7 +9003,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the StorageFile is not queued for processing.
  *
- * @returns a precondition-conflict HttpsError with the STORAGE_FILE_PROCESSING_NOT_QUEUED_FOR_PROCESSING error code
+ * @returns A precondition-conflict HttpsError with the STORAGE_FILE_PROCESSING_NOT_QUEUED_FOR_PROCESSING error code.
  */ function storageFileProcessingNotQueuedForProcessingError() {
     return firebaseServer.preconditionConflictError({
         message: "The target StorageFileDocument is not queued for processing.",
@@ -9023,7 +9013,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that no processor is configured for the StorageFile's type.
  *
- * @returns a precondition-conflict HttpsError with the STORAGE_FILE_PROCESSING_NOT_AVAILABLE_FOR_TYPE error code
+ * @returns A precondition-conflict HttpsError with the STORAGE_FILE_PROCESSING_NOT_AVAILABLE_FOR_TYPE error code.
  */ function storageFileProcessingNotAvailableForTypeError() {
     return firebaseServer.preconditionConflictError({
         message: "The target StorageFileDocument is not available for processing.",
@@ -9033,7 +9023,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the StorageFile has already finished processing.
  *
- * @returns a precondition-conflict HttpsError with the STORAGE_FILE_ALREADY_PROCESSED error code
+ * @returns A precondition-conflict HttpsError with the STORAGE_FILE_ALREADY_PROCESSED error code.
  */ function storageFileAlreadyProcessedError() {
     return firebaseServer.preconditionConflictError({
         message: "The target StorageFileDocument has already finished processing.",
@@ -9043,7 +9033,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the StorageFile is not flagged for deletion.
  *
- * @returns a precondition-conflict HttpsError with the STORAGE_FILE_NOT_FLAGGED_FOR_DELETION error code
+ * @returns A precondition-conflict HttpsError with the STORAGE_FILE_NOT_FLAGGED_FOR_DELETION error code.
  */ function storageFileNotFlaggedForDeletionError() {
     return firebaseServer.preconditionConflictError({
         message: "The target StorageFileDocument is not flagged for deletion.",
@@ -9053,7 +9043,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the StorageFile's scheduled deletion time has not yet passed.
  *
- * @returns a precondition-conflict HttpsError with the STORAGE_FILE_CANNOT_BE_DELETED_YET error code
+ * @returns A precondition-conflict HttpsError with the STORAGE_FILE_CANNOT_BE_DELETED_YET error code.
  */ function storageFileCannotBeDeletedYetError() {
     return firebaseServer.preconditionConflictError({
         message: "The target StorageFileDocument cannot be deleted yet.",
@@ -9063,7 +9053,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the StorageFileGroup is still queued for initialization and cannot be operated on.
  *
- * @returns a precondition-conflict HttpsError with the STORAGE_FILE_GROUP_QUEUED_FOR_INITIALIZATION error code
+ * @returns A precondition-conflict HttpsError with the STORAGE_FILE_GROUP_QUEUED_FOR_INITIALIZATION error code.
  */ function storageFileGroupQueuedForInitializationError() {
     return firebaseServer.preconditionConflictError({
         message: "The target StorageFileGroupDocument is queued for initialization.",
@@ -9073,7 +9063,7 @@ function replaceImageStream(input) {
 /**
  * Creates an error indicating that the required model key or storageFileId is missing when creating a StorageFileGroup.
  *
- * @returns a precondition-conflict HttpsError with the STORAGE_FILE_GROUP_CREATE_INPUT error code
+ * @returns A precondition-conflict HttpsError with the STORAGE_FILE_GROUP_CREATE_INPUT error code.
  */ function createStorageFileGroupInputError() {
     return firebaseServer.preconditionConflictError({
         message: "The model or storageFileId is required for creating a StorageFileGroup.",
@@ -9345,10 +9335,9 @@ function _ts_generator$4(thisArg, body) {
  * Creates a concrete {@link StorageFileServerActions} implementation by wiring each action
  * to its factory function using the provided context.
  *
- * @param context - the fully assembled storage file server actions context
- *
- * @param context - the fully assembled storage file server actions context
- * @returns a concrete {@link StorageFileServerActions} with all action methods wired to their factories
+ * @param context - The fully assembled storage file server actions context.
+ * @param context - The fully assembled storage file server actions context.
+ * @returns A concrete {@link StorageFileServerActions} with all action methods wired to their factories.
  *
  * @example
  * ```ts
@@ -9382,8 +9371,8 @@ function _ts_generator$4(thisArg, body) {
  *
  * Creates a new {@link StorageFile} document using the provided template data.
  *
- * @param context - the base server actions context providing Firestore and storage access
- * @returns an async transform-and-validate function that creates a StorageFile document
+ * @param context - The base server actions context providing Firestore and storage access.
+ * @returns An async transform-and-validate function that creates a StorageFile document.
  */ function createStorageFileFactory(context) {
     var firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     return firebaseServerActionTransformFunctionFactory(firebase.createStorageFileParamsType, function(params) {
@@ -9414,8 +9403,8 @@ function _ts_generator$4(thisArg, body) {
  * initializes each one via the upload service, and cleans up the source upload
  * on success. Failed initializations are logged but do not halt the batch.
  *
- * @param context - the storage file server actions context with storage service and upload initialization
- * @returns an async transform-and-validate function that returns batch initialization results
+ * @param context - The storage file server actions context with storage service and upload initialization.
+ * @returns An async transform-and-validate function that returns batch initialization results.
  */ function initializeAllStorageFilesFromUploadsFactory(context) {
     var storageService = context.storageService, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var _initializeStorageFileFromUploadFile = _initializeStorageFileFromUploadFileFactory(context);
@@ -9515,8 +9504,8 @@ function _ts_generator$4(thisArg, body) {
  * Validates the file exists and is allowed, runs the upload initializer, deletes the upload source
  * on success, and optionally expedites processing of the created storage file.
  *
- * @param context - the storage file server actions context
- * @returns an async function that accepts an upload file input and returns the created StorageFileDocument
+ * @param context - The storage file server actions context.
+ * @returns An async function that accepts an upload file input and returns the created StorageFileDocument.
  */ function _initializeStorageFileFromUploadFileFactory(context) {
     var firestoreContext = context.firestoreContext, storageFileInitializeFromUploadService = context.storageFileInitializeFromUploadService, notificationExpediteService = context.notificationExpediteService;
     var processStorageFileInTransaction = _processStorageFileInTransactionFactory(context);
@@ -9782,8 +9771,8 @@ function _ts_generator$4(thisArg, body) {
  * Validates the file exists and is allowed, runs the type determiner and initializer,
  * then cleans up the upload source on success.
  *
- * @param context - the storage file server actions context with storage and upload services
- * @returns an async transform-and-validate function that creates a StorageFile from an upload
+ * @param context - The storage file server actions context with storage and upload services.
+ * @returns An async transform-and-validate function that creates a StorageFile from an upload.
  */ function initializeStorageFileFromUploadFactory(context) {
     var storageService = context.storageService, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var _initializeStorageFileFromUploadFile = _initializeStorageFileFromUploadFileFactory(context);
@@ -9822,8 +9811,8 @@ function _ts_generator$4(thisArg, body) {
  *
  * Updates an existing {@link StorageFile} document with the provided schedule-delete-at time.
  *
- * @param context - the base server actions context providing Firestore access
- * @returns an async transform-and-validate function that updates a StorageFile document
+ * @param context - The base server actions context providing Firestore access.
+ * @returns An async transform-and-validate function that updates a StorageFile document.
  */ function updateStorageFileFactory(context) {
     var firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     return firebaseServerActionTransformFunctionFactory(firebase.updateStorageFileParamsType, function(params) {
@@ -9867,8 +9856,8 @@ function _ts_generator$4(thisArg, body) {
  * Updates embedded file entries within a {@link StorageFileGroup} document inside a
  * Firestore transaction, merging display name changes into the existing entries.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that updates a StorageFileGroup document
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that updates a StorageFileGroup document.
  */ function updateStorageFileGroupFactory(context) {
     var firestoreContext = context.firestoreContext, storageFileGroupCollection = context.storageFileGroupCollection, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     return firebaseServerActionTransformFunctionFactory(firebase.updateStorageFileGroupParamsType, function(params) {
@@ -9952,8 +9941,8 @@ function _ts_generator$4(thisArg, body) {
  * processing notification task for each file and optionally expedites delivery.
  * Handles stuck-processing detection with a throttle check.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that returns batch processing results
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that returns batch processing results.
  */ function processAllQueuedStorageFilesFactory(context) {
     var storageFileCollection = context.storageFileCollection, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var processStorageFile = processStorageFileFactory(context);
@@ -10047,8 +10036,8 @@ function _ts_generator$4(thisArg, body) {
  * Creates or restarts a notification task for the file based on its current processing state,
  * handling stuck-processing detection, forced restarts, and re-processing of already-successful files.
  *
- * @param context - the storage file server actions context
- * @returns an async function that processes a storage file within a transaction
+ * @param context - The storage file server actions context.
+ * @returns An async function that processes a storage file within a transaction.
  */ function _processStorageFileInTransactionFactory(context) {
     var storageFileCollection = context.storageFileCollection, notificationCollectionGroup = context.notificationCollectionGroup;
     return function(input, transaction) {
@@ -10322,8 +10311,8 @@ function _ts_generator$4(thisArg, body) {
  * Processes a single {@link StorageFile} by creating a notification task for it
  * and marking it as processing. Validates the file is in a valid state for processing.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that processes a single StorageFile
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that processes a single StorageFile.
  */ function processStorageFileFactory(context) {
     var firestoreContext = context.firestoreContext, notificationExpediteService = context.notificationExpediteService, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var processStorageFileInTransaction = _processStorageFileInTransactionFactory(context);
@@ -10408,8 +10397,8 @@ function _ts_generator$4(thisArg, body) {
  * scheduled delete time has passed. Removes both the Firestore document and
  * the associated file in Cloud Storage.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that returns batch deletion results
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that returns batch deletion results.
  */ function deleteAllQueuedStorageFilesFactory(context) {
     var storageFileCollection = context.storageFileCollection, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var deleteStorageFile = deleteStorageFileFactory(context);
@@ -10505,8 +10494,8 @@ function _ts_generator$4(thisArg, body) {
  * Deletes a single {@link StorageFile} document and its associated Cloud Storage file.
  * Validates the file is flagged for deletion and the scheduled delete time has passed.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that deletes a StorageFile and its storage object
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that deletes a StorageFile and its storage object.
  */ function deleteStorageFileFactory(context) {
     var firestoreContext = context.firestoreContext, storageService = context.storageService, storageFileCollection = context.storageFileCollection, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var syncStorageFileWithGroupsInTransaction = _syncStorageFileWithGroupsInTransactionFactory(context);
@@ -10606,8 +10595,8 @@ function _ts_generator$4(thisArg, body) {
  * When `throwOnFirstError` is true, the first failure throws immediately (single-download behavior).
  * When false, failures are collected in the errors array (batch behavior).
  *
- * @param context - the storage file server actions context
- * @returns an async function that processes a {@link DownloadMultipleStorageFilesFactoryInput} and returns a {@link DownloadMultipleStorageFilesResult}
+ * @param context - The storage file server actions context.
+ * @returns An async function that processes a {@link DownloadMultipleStorageFilesFactoryInput} and returns a {@link DownloadMultipleStorageFilesResult}
  */ function _downloadMultipleStorageFilesFactory(context) {
     var storageService = context.storageService, storageFileCollection = context.storageFileCollection;
     return function(input) {
@@ -10721,8 +10710,8 @@ function _ts_generator$4(thisArg, body) {
  * Generates a signed download URL for a {@link StorageFile}'s associated Cloud Storage file.
  * Delegates to {@link _downloadMultipleStorageFilesFactory} with a single item and `throwOnFirstError: true`.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that generates a signed download URL
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that generates a signed download URL.
  */ function downloadStorageFileFactory(context) {
     var firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var downloadMultipleStorageFiles = _downloadMultipleStorageFilesFactory(context);
@@ -10778,8 +10767,8 @@ function _ts_generator$4(thisArg, body) {
  * By default, individual failures are collected in the errors array rather than failing the entire batch.
  * Set `throwOnFirstError` in params to throw on the first failure instead.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that generates signed download URLs for multiple files
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that generates signed download URLs for multiple files.
  */ function downloadMultipleStorageFilesFactory(context) {
     var firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var downloadMultipleStorageFiles = _downloadMultipleStorageFilesFactory(context);
@@ -10831,8 +10820,8 @@ function _ts_generator$4(thisArg, body) {
  * The created group is flagged for initialization (`s=true`) and uses a dummy owner key
  * that will be set during the initialization step.
  *
- * @param context - the storage file server actions context
- * @returns an async function that creates a StorageFileGroup within a transaction
+ * @param context - The storage file server actions context.
+ * @returns An async function that creates a StorageFileGroup within a transaction.
  */ function createStorageFileGroupInTransactionFactory(context) {
     var storageFileGroupCollection = context.storageFileGroupCollection;
     return function(params, transaction) {
@@ -10880,8 +10869,8 @@ function _ts_generator$4(thisArg, body) {
  * Creates a new {@link StorageFileGroup} document within a Firestore transaction,
  * associating it with a model key or storage file.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that creates a new StorageFileGroup
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that creates a new StorageFileGroup.
  */ function createStorageFileGroupFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var createStorageFileGroupInTransaction = createStorageFileGroupInTransactionFactory(context);
@@ -10939,8 +10928,8 @@ function _ts_generator$4(thisArg, body) {
  * Adds the storage file to groups it is missing from, removes it from groups when requested,
  * and optionally creates new groups for references that do not yet exist.
  *
- * @param context - the storage file server actions context
- * @returns an async function that syncs a storage file with its groups within a transaction
+ * @param context - The storage file server actions context.
+ * @returns An async function that syncs a storage file with its groups within a transaction.
  */ function _syncStorageFileWithGroupsInTransactionFactory(context) {
     var storageFileCollection = context.storageFileCollection, storageFileGroupCollection = context.storageFileGroupCollection;
     var createStorageFileGroupInTransaction = createStorageFileGroupInTransactionFactory(context);
@@ -11137,8 +11126,8 @@ function _ts_generator$4(thisArg, body) {
  * Syncs a single {@link StorageFile}'s embedded data into its associated {@link StorageFileGroup}
  * documents and clears the sync flag on completion.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that syncs a StorageFile with its groups
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that syncs a StorageFile with its groups.
  */ function syncStorageFileWithGroupsFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var syncStorageFileWithGroupsInTransaction = _syncStorageFileWithGroupsInTransactionFactory(context);
@@ -11183,8 +11172,8 @@ function _ts_generator$4(thisArg, body) {
  * updating their associated {@link StorageFileGroup} documents and flagging
  * groups for content regeneration when changes occur.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that returns batch sync results
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that returns batch sync results.
  */ function syncAllFlaggedStorageFilesWithGroupsFactory(context) {
     var firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, storageFileCollection = context.storageFileCollection;
     var syncStorageFileWithGroups = syncStorageFileWithGroupsFactory(context);
@@ -11301,8 +11290,8 @@ function _ts_generator$4(thisArg, body) {
  * Regenerates the content of a single {@link StorageFileGroup}, including building a ZIP
  * archive from the group's embedded files and updating the group's content metadata.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that regenerates a StorageFileGroup's content
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that regenerates a StorageFileGroup's content.
  */ function regenerateStorageFileGroupContentFactory(context) {
     var firestoreContext = context.firestoreContext, storageService = context.storageService, storageFileCollection = context.storageFileCollection, storageFileGroupCollection = context.storageFileGroupCollection, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var processStorageFileInTransaction = _processStorageFileInTransactionFactory(context);
@@ -11443,8 +11432,8 @@ function _ts_generator$4(thisArg, body) {
  * Batch-processes all {@link StorageFileGroup} documents flagged for content regeneration,
  * rebuilding their ZIP archives and updating content metadata.
  *
- * @param context - the storage file server actions context
- * @returns an async transform-and-validate function that returns batch regeneration results
+ * @param context - The storage file server actions context.
+ * @returns An async transform-and-validate function that returns batch regeneration results.
  */ function regenerateAllFlaggedStorageFileGroupsContentFactory(context) {
     var firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, storageFileGroupCollection = context.storageFileGroupCollection;
     var regenerateStorageFileGroupContent = regenerateStorageFileGroupContentFactory(context);
@@ -11732,8 +11721,8 @@ var MAKE_TEMPLATE_FOR_STORAGEFILE_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_R
  * Creates a concrete {@link StorageFileInitServerActions} implementation by wiring each
  * initialization action to its factory function.
  *
- * @param context - the initialization context with template function and Firestore access
- * @returns a {@link StorageFileInitServerActions} wired to the provided context
+ * @param context - The initialization context with template function and Firestore access.
+ * @returns A {@link StorageFileInitServerActions} wired to the provided context.
  */ function storageFileInitServerActions(context) {
     return {
         initializeStorageFileGroup: initializeStorageFileGroupFactory(context),
@@ -11748,9 +11737,9 @@ var MAKE_TEMPLATE_FOR_STORAGEFILE_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_R
  * - Returns `null`/`undefined` → marks the model as invalid (`fi=true`)
  * - Returns `false` → deletes the document entirely
  *
- * @param input - the document, transaction, template function, and options
- * @returns an object indicating whether the document was initialized or was already initialized
- * @throws storageFileModelAlreadyInitializedError when `throwErrorIfAlreadyInitialized` is true
+ * @param input - The document, transaction, template function, and options.
+ * @returns An object indicating whether the document was initialized or was already initialized.
+ * @throws {Error} StorageFileModelAlreadyInitializedError when `throwErrorIfAlreadyInitialized` is true.
  */ function initializeStorageFileModelInTransaction(input) {
     return _async_to_generator$3(function() {
         var makeTemplateFunction, throwErrorIfAlreadyInitialized, transaction, documentInTransaction, storageFileModel, initialized, alreadyInitialized, flatModelKey, modelKey, modelCollectionName, _$input, template;
@@ -11852,8 +11841,8 @@ var MAKE_TEMPLATE_FOR_STORAGEFILE_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_R
  * Applies the app-specific template function, restricting the template to only the `o` (owner)
  * and content flag properties, and always flags the group for content regeneration.
  *
- * @param context - the initialization context providing collection access and the template function
- * @returns an async function that initializes a storage file group document within a transaction
+ * @param context - The initialization context providing collection access and the template function.
+ * @returns An async function that initializes a storage file group document within a transaction.
  */ function initializeStorageFileGroupInTransactionFactory(context) {
     var storageFileGroupCollection = context.storageFileGroupCollection, makeTemplateForStorageFileGroupInitialization = context.makeTemplateForStorageFileGroupInitialization;
     return function(params, storageFileGroupDocument, transaction) {
@@ -11915,8 +11904,8 @@ var MAKE_TEMPLATE_FOR_STORAGEFILE_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_R
  * Wraps the in-transaction group initialization in a Firestore transaction
  * and follows the transform-and-validate pattern.
  *
- * @param context - the initialization context with Firestore access and template function
- * @returns a transform-and-validate function for single storage file group initialization
+ * @param context - The initialization context with Firestore access and template function.
+ * @returns A transform-and-validate function for single storage file group initialization.
  */ function initializeStorageFileGroupFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory;
     var initializeStorageFileGroupInTransaction = initializeStorageFileGroupInTransactionFactory(context);
@@ -11958,8 +11947,8 @@ var MAKE_TEMPLATE_FOR_STORAGEFILE_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_R
  * initializing each in parallel (up to 5 concurrent tasks). Loops until no more
  * flagged groups are found.
  *
- * @param context - the initialization context with Firestore access, collection, and template function
- * @returns a transform-and-validate function for batch storage file group initialization
+ * @param context - The initialization context with Firestore access, collection, and template function.
+ * @returns A transform-and-validate function for batch storage file group initialization.
  */ function initializeAllApplicableStorageFileGroupsFactory(context) {
     var firestoreContext = context.firestoreContext, firebaseServerActionTransformFunctionFactory = context.firebaseServerActionTransformFunctionFactory, storageFileGroupCollection = context.storageFileGroupCollection;
     var initializeStorageFileGroupInTransaction = initializeStorageFileGroupInTransactionFactory(context);
@@ -12161,9 +12150,9 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * Factory that assembles the full {@link StorageFileServerActionsContext} by combining
  * the base context with the upload initialization service.
  *
- * @param context - the base server actions context providing Firebase infrastructure
- * @param storageFileInitializeFromUploadService - the service for initializing storage files from uploads
- * @returns the fully assembled StorageFileServerActionsContext
+ * @param context - The base server actions context providing Firebase infrastructure.
+ * @param storageFileInitializeFromUploadService - The service for initializing storage files from uploads.
+ * @returns The fully assembled StorageFileServerActionsContext.
  */ function storageFileServerActionsContextFactory(context, storageFileInitializeFromUploadService) {
     return _object_spread_props$2(_object_spread$2({}, context), {
         storageFileInitializeFromUploadService: storageFileInitializeFromUploadService
@@ -12172,8 +12161,8 @@ function _unsupported_iterable_to_array$1(o, minLen) {
 /**
  * Factory that creates a {@link StorageFileServerActions} instance from the assembled context.
  *
- * @param context - the fully assembled storage file server actions context
- * @returns a concrete StorageFileServerActions instance
+ * @param context - The fully assembled storage file server actions context.
+ * @returns A concrete StorageFileServerActions instance.
  */ function storageFileServerActionsFactory(context) {
     return storageFileServerActions(context);
 }
@@ -12181,9 +12170,9 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * Factory that creates a {@link StorageFileInitServerActions} instance by merging the
  * server actions context with the init-specific configuration.
  *
- * @param context - the storage file server actions context
- * @param storageFileInitServerActionsContextConfig - init-specific configuration with the template function
- * @returns a concrete StorageFileInitServerActions instance
+ * @param context - The storage file server actions context.
+ * @param storageFileInitServerActionsContextConfig - Init-specific configuration with the template function.
+ * @returns A concrete StorageFileInitServerActions instance.
  */ function storageFileInitServerActionsFactory(context, storageFileInitServerActionsContextConfig) {
     return storageFileInitServerActions(_object_spread$2({}, context, storageFileInitServerActionsContextConfig));
 }
@@ -12197,8 +12186,8 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  *
  * Be sure the class that delares the module using this function also extends AbstractAppStorageFileModule.
  *
- * @param config - the module configuration including optional dependency module, imports, exports, and providers
- * @returns the assembled {@link ModuleMetadata} for the storage file module
+ * @param config - The module configuration including optional dependency module, imports, exports, and providers.
+ * @returns The assembled {@link ModuleMetadata} for the storage file module.
  */ function appStorageFileModuleMetadata(config$1) {
     var dependencyModule = config$1.dependencyModule, imports = config$1.imports, exports = config$1.exports, providers = config$1.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -12372,7 +12361,7 @@ function _ts_generator$2(thisArg, body) {
 /**
  * Performs a query and flags the matching StorageFiles for deletion.
  *
- * @param input The input for the query and flagging.
+ * @param input - The input for the query and flagging.
  * @returns The result of the query and flagging.
  */ function queryAndFlagStorageFilesForDelete(input) {
     return _async_to_generator$2(function() {
@@ -12443,7 +12432,7 @@ function _ts_generator$2(thisArg, body) {
 /**
  * Creates a template for updating a StorageFile to be queued for deletion at the input time.
  *
- * @param queueForDeleteTime When to delete the StorageFile. If true or unset, the StorageFile will be flagged to be deleted immediately.
+ * @param queueForDeleteTime - When to delete the StorageFile. If true or unset, the StorageFile will be flagged to be deleted immediately.
  * @returns The update template for the StorageFile.
  */ function markStorageFileForDeleteTemplate(queueForDeleteTime) {
     var updateTemplate = {
@@ -12667,8 +12656,8 @@ var storageFileProcessingNotificationTaskHandlerDefaultCleanup = function storag
  * determines its purpose, and dispatches to the appropriate purpose-specific processor.
  * Includes optional StorageFileGroup processors (e.g., ZIP generation) by default.
  *
- * @param config - handler configuration including processors, storage accessor, and Firestore collections
- * @returns a NotificationTaskServiceTaskHandlerConfig wired for storage file processing
+ * @param config - Handler configuration including processors, storage accessor, and Firestore collections.
+ * @returns A NotificationTaskServiceTaskHandlerConfig wired for storage file processing.
  */ function storageFileProcessingNotificationTaskHandler(config) {
     var inputProcessors = config.processors, storageAccessor = config.storageAccessor, storageFileFirestoreCollections = config.storageFileFirestoreCollections, allStorageFileGroupProcessorConfig = config.allStorageFileGroupProcessorConfig;
     var storageFileDocumentAccessor = storageFileFirestoreCollections.storageFileCollection.documentAccessor();
@@ -12824,8 +12813,8 @@ var storageFileProcessingNotificationTaskHandlerDefaultCleanup = function storag
 /**
  * Assembles all built-in StorageFileGroup subtask processors, such as ZIP generation.
  *
- * @param config - configuration controlling which group processors to include
- * @returns an array of subtask processor configs for StorageFileGroup processing purposes
+ * @param config - Configuration controlling which group processors to include.
+ * @returns The subtask processor configs for StorageFileGroup processing purposes.
  */ function allStorageFileGroupStorageFileProcessingPurposeSubtaskProcessors(config) {
     var excludeZipProcessing = config.excludeZipProcessing;
     var processors = [];
@@ -12840,8 +12829,8 @@ var storageFileProcessingNotificationTaskHandlerDefaultCleanup = function storag
  * This processor streams all files in the group into a ZIP archive, attaches an info JSON
  * manifest, and uploads the result to the group's designated storage path.
  *
- * @param config - configuration providing Firestore collections, storage accessor, and ZIP options
- * @returns a subtask processor config targeting the StorageFileGroup ZIP purpose
+ * @param config - Configuration providing Firestore collections, storage accessor, and ZIP options.
+ * @returns A subtask processor config targeting the StorageFileGroup ZIP purpose.
  */ function storageFileGroupZipStorageFileProcessingPurposeSubtaskProcessor(config) {
     var _ref;
     var storageFileFirestoreCollections = config.storageFileFirestoreCollections, storageAccessor = config.storageAccessor, zip = config.zip;
@@ -13378,9 +13367,9 @@ function _ts_generator(thisArg, body) {
  * Convenience factory for creating a permanent failure result, indicating the file
  * should be discarded and any created intermediate files cleaned up.
  *
- * @param error - the error that caused the permanent failure
- * @param createdFile - optional path to a file that was created before the error and should be deleted
- * @returns a permanent failure result with the error and optional created file reference
+ * @param error - The error that caused the permanent failure.
+ * @param createdFile - Optional path to a file that was created before the error and should be deleted.
+ * @returns A permanent failure result with the error and optional created file reference.
  */ function storageFileInitializeFromUploadServiceInitializerResultPermanentFailure(error, createdFile) {
     return {
         error: error,
@@ -13399,8 +13388,8 @@ function _ts_generator(thisArg, body) {
  * 3. The created file is linked back to the StorageFile document via custom metadata
  * 4. Optionally, previous files for the same purpose/user are flagged for deletion
  *
- * @param config - service configuration including determiners, initializers, and storage references
- * @returns a {@link StorageFileInitializeFromUploadService} with type detection and upload initialization
+ * @param config - Service configuration including determiners, initializers, and storage references.
+ * @returns A {@link StorageFileInitializeFromUploadService} with type detection and upload initialization.
  *
  * @example
  * ```ts
@@ -13690,9 +13679,9 @@ exports.DEFAULT_COMPRESS_PDF_IMAGE_MAX_DIMENSION = DEFAULT_COMPRESS_PDF_IMAGE_MA
 exports.DEFAULT_COMPRESS_PDF_IMAGE_QUALITY = DEFAULT_COMPRESS_PDF_IMAGE_QUALITY;
 exports.DEFAULT_COMPRESS_PDF_IMAGE_SIZE_THRESHOLD_BYTES = DEFAULT_COMPRESS_PDF_IMAGE_SIZE_THRESHOLD_BYTES;
 exports.DEFAULT_DOWNLOAD_MULTIPLE_STORAGE_FILES_MAX_PARALLEL_TASKS = DEFAULT_DOWNLOAD_MULTIPLE_STORAGE_FILES_MAX_PARALLEL_TASKS;
+exports.DEFAULT_MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_MAX_BATCH_SIZE_PER_REQUEST = DEFAULT_MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_MAX_BATCH_SIZE_PER_REQUEST;
 exports.KNOWN_BUT_UNCONFIGURED_NOTIFICATION_TEMPLATE_TYPE_DELETE_AFTER_RETRY_ATTEMPTS = KNOWN_BUT_UNCONFIGURED_NOTIFICATION_TEMPLATE_TYPE_DELETE_AFTER_RETRY_ATTEMPTS;
 exports.KNOWN_BUT_UNCONFIGURED_NOTIFICATION_TEMPLATE_TYPE_HOURS_DELAY = KNOWN_BUT_UNCONFIGURED_NOTIFICATION_TEMPLATE_TYPE_HOURS_DELAY;
-exports.MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST = MAILGUN_NOTIFICATION_EMAIL_SEND_SERVICE_DEFAULT_MAX_BATCH_SIZE_PER_REQUEST;
 exports.MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_RESPONSE = MAKE_TEMPLATE_FOR_NOTIFICATION_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_RESPONSE;
 exports.MAKE_TEMPLATE_FOR_STORAGEFILE_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_RESPONSE = MAKE_TEMPLATE_FOR_STORAGEFILE_RELATED_MODEL_INITIALIZATION_FUNCTION_DELETE_RESPONSE;
 exports.NOTIFICATION_BOX_NOT_INITIALIZED_DELAY_MINUTES = NOTIFICATION_BOX_NOT_INITIALIZED_DELAY_MINUTES;