@fluojs/notifications 1.0.0-beta.4 → 1.0.0-beta.5

package/README.ko.md

@@ -121,9 +121,9 @@ Behavioral contract 메모:
 - queue adapter가 있어도 직접 전달을 강제하려면 `dispatch(..., { queue: false })`를 사용합니다.
 - 큐 기반 전달은 단건 dispatch에서는 opt-in이고, `dispatchMany(...)`에서는 threshold 기반으로 동작합니다.
 - Queue job에는 `notification.id`가 있으면 그 값을, 없으면 notification envelope에서 파생한 deterministic `id` idempotency key가 포함됩니다. Queue adapter는 deduplication을 지원하는 backing queue에 이 값을 전달해야 합니다.
-- `dispatchMany(..., { continueOnError: true })`는 direct delivery에서 첫 실패를 던지는 대신 실패들을 수집합니다.
-- queue enqueue가 실패하면 서비스는 enqueue 에러를 다시 던지기 전에 결정적인 `notification.dispatch.failed` 라이프사이클 이벤트를 발행합니다.
-- `enqueueMany(...)`가 없으면 대량 queue delivery는 각 job을 개별적으로 enqueue하는 방식으로 fallback합니다.
+- `dispatchMany(..., { continueOnError: true })`는 direct delivery 또는 순차 queue fallback enqueue에서 첫 실패를 던지는 대신 실패들을 수집합니다.
+- queue enqueue가 실패하면 서비스는 enqueue 에러를 다시 던지기 전에 결정적인 `notification.dispatch.failed` 라이프사이클 이벤트를 발행합니다. queued bulk dispatch는 queue 미구성, channel 해석, provider/adapter failure 경로를 포함해 이미 `requested`를 발행한 모든 notification에 대해 terminal `queued` 또는 `failed` 이벤트도 발행합니다.
+- `enqueueMany(...)`가 없으면 대량 queue delivery는 input order대로 각 job을 개별 enqueue하는 방식으로 fallback합니다. `continueOnError: true`이면 성공한 enqueue는 `results`에 남고 실패한 enqueue는 `failures`로 반환됩니다. 그렇지 않으면 첫 enqueue failure를 다시 던지기 전에 아직 terminal 상태가 없는 나머지 requested fallback job에 `failed` 라이프사이클 이벤트를 발행합니다.
 - foundation 패키지는 특정 큐 구현을 가정하거나 import하지 않습니다.
 
 ### 이벤트 발행자를 통한 라이프사이클 발행

package/README.md

@@ -121,9 +121,9 @@ Behavioral contract notes:
 - Use `dispatch(..., { queue: false })` to force direct delivery even when a queue adapter exists.
 - Queue-backed delivery is opt-in for single dispatch and threshold-driven for `dispatchMany(...)`.
 - Queue jobs include a deterministic `id` idempotency key derived from `notification.id` when present, otherwise from the notification envelope. Queue adapters should pass this value to backing queues that support deduplication.
-- `dispatchMany(..., { continueOnError: true })` collects failures instead of throwing on the first failed direct delivery.
-- When queue enqueue fails, the service emits deterministic `notification.dispatch.failed` lifecycle events before rethrowing the enqueue error to the caller.
-- If `enqueueMany(...)` is unavailable, bulk queue delivery falls back to enqueueing each job individually.
+- `dispatchMany(..., { continueOnError: true })` collects failures instead of throwing on the first failed direct delivery or sequential queue fallback enqueue.
+- When queue enqueue fails, the service emits deterministic `notification.dispatch.failed` lifecycle events before rethrowing the enqueue error to the caller. Queued bulk dispatch also publishes a terminal `queued` or `failed` event for every notification that already emitted `requested`, including queue-missing, channel-resolution, and provider/adapter failure paths.
+- If `enqueueMany(...)` is unavailable, bulk queue delivery falls back to enqueueing each job individually in input order. With `continueOnError: true`, successful enqueues remain visible in `results` while failed enqueues are returned in `failures`; without it, the first enqueue failure is rethrown after the remaining requested fallback jobs receive `failed` lifecycle events.
 - The foundation package does not assume or import a concrete queue implementation.
 
 ### Lifecycle publication through an event publisher

package/dist/service.d.ts

@@ -59,5 +59,7 @@ export declare class NotificationsService implements Notifications {
     private publishLifecycleEvent;
     private publishLifecycleEventSafely;
     private publishFailureLifecycleEvent;
+    private publishFailureLifecycleEvents;
+    private dispatchManyThroughSequentialQueueFallback;
 }
 //# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,oCAAoC,EACpC,mBAAmB,EACnB,+BAA+B,EAC/B,+BAA+B,EAC/B,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAE1B,aAAa,EAEd,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,qBACa,oBAAqB,YAAW,aAAa;IAItD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0C;gBAGtD,OAAO,EAAE,oCAAoC,EAC9D,QAAQ,EAAE,SAAS,mBAAmB,EAAE;IAO1C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,QAAQ,CAAC,QAAQ,SAAS,2BAA2B,EACzD,YAAY,EAAE,QAAQ,EACtB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC;IA+DtC;;;;;;;;OAQG;IACG,YAAY,CAAC,QAAQ,SAAS,2BAA2B,EAC7D,aAAa,EAAE,SAAS,QAAQ,EAAE,EAClC,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,+BAA+B,CAAC,QAAQ,CAAC,CAAC;IAuGrD;;;;OAIG;IACH,4BAA4B;IAS5B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,yBAAyB;IAIjC,OAAO,CAAC,WAAW;YAYL,qBAAqB;YA4BrB,2BAA2B;YAc3B,4BAA4B;CAW3C"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,oCAAoC,EACpC,mBAAmB,EACnB,+BAA+B,EAC/B,+BAA+B,EAC/B,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAE1B,aAAa,EAEd,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,qBACa,oBAAqB,YAAW,aAAa;IAItD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0C;gBAGtD,OAAO,EAAE,oCAAoC,EAC9D,QAAQ,EAAE,SAAS,mBAAmB,EAAE;IAO1C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,QAAQ,CAAC,QAAQ,SAAS,2BAA2B,EACzD,YAAY,EAAE,QAAQ,EACtB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC;IA+DtC;;;;;;;;OAQG;IACG,YAAY,CAAC,QAAQ,SAAS,2BAA2B,EAC7D,aAAa,EAAE,SAAS,QAAQ,EAAE,EAClC,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,+BAA+B,CAAC,QAAQ,CAAC,CAAC;IAmGrD;;;;OAIG;IACH,4BAA4B;IAS5B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,yBAAyB;IAIjC,OAAO,CAAC,WAAW;YAYL,qBAAqB;YA4BrB,2BAA2B;YAc3B,4BAA4B;YAY5B,6BAA6B;YAoB7B,0CAA0C;CA2DzD"}

package/dist/service.js

@@ -120,28 +120,33 @@ class NotificationsService {
       };
     }
     if (this.shouldQueue(notifications.length, options)) {
-      const queue = this.requireQueueAdapter();
       for (const notification of notifications) {
         await this.publishLifecycleEventSafely('notification.dispatch.requested', notification, options);
       }
-      for (const notification of notifications) {
-        try {
+      let queue;
+      try {
+        queue = this.requireQueueAdapter();
+      } catch (error) {
+        await this.publishFailureLifecycleEvents(notifications, options, error);
+        throw error;
+      }
+      try {
+        for (const notification of notifications) {
           this.requireChannel(notification.channel);
-        } catch (error) {
-          await this.publishFailureLifecycleEvent(notification, options, error);
-          throw error;
         }
+      } catch (error) {
+        await this.publishFailureLifecycleEvents(notifications, options, error);
+        throw error;
       }
       const jobs = notifications.map(notification => this.createQueueJob(notification));
+      if (!queue.enqueueMany) {
+        return this.dispatchManyThroughSequentialQueueFallback(notifications, jobs, options);
+      }
       let ids;
       try {
-        ids = queue.enqueueMany ? await queue.enqueueMany(jobs) : await Promise.all(jobs.map(job => queue.enqueue(job)));
+        ids = await queue.enqueueMany(jobs);
       } catch (error) {
-        const failurePublicationResults = await Promise.allSettled(notifications.map(notification => this.publishLifecycleEvent('notification.dispatch.failed', notification, options, undefined, error)));
-        const publicationFailures = failurePublicationResults.filter(result => result.status === 'rejected').map(result => result.reason);
-        if (publicationFailures.length > 0) {
-          throw createLifecyclePublicationFailureError(error, ...publicationFailures);
-        }
+        await this.publishFailureLifecycleEvents(notifications, options, error);
         throw error;
       }
       const results = notifications.map((notification, index) => ({
@@ -285,6 +290,58 @@ class NotificationsService {
       throw createLifecyclePublicationFailureError(error, publicationError);
     }
   }
+  async publishFailureLifecycleEvents(notifications, options, error) {
+    const failurePublicationResults = await Promise.allSettled(notifications.map(notification => this.publishLifecycleEvent('notification.dispatch.failed', notification, options, undefined, error)));
+    const publicationFailures = failurePublicationResults.filter(result => result.status === 'rejected').map(result => result.reason);
+    if (publicationFailures.length > 0) {
+      throw createLifecyclePublicationFailureError(error, ...publicationFailures);
+    }
+  }
+  async dispatchManyThroughSequentialQueueFallback(notifications, jobs, options) {
+    const queue = this.requireQueueAdapter();
+    const results = [];
+    const failures = [];
+    for (let index = 0; index < jobs.length; index += 1) {
+      const job = jobs[index];
+      const notification = notifications[index];
+      if (!job || !notification) {
+        continue;
+      }
+      try {
+        const deliveryId = this.normalizeDeliveryId(await queue.enqueue(job), notification);
+        const result = {
+          channel: notification.channel,
+          deliveryId,
+          queued: true,
+          status: 'queued'
+        };
+        results.push(result);
+        await this.publishLifecycleEventSafely('notification.dispatch.queued', notification, options, deliveryId);
+      } catch (error) {
+        const failure = {
+          error: error instanceof Error ? error : new Error('Notification queue enqueue failed.'),
+          notification
+        };
+        if (!(options.continueOnError ?? false)) {
+          await this.publishFailureLifecycleEvents(notifications.slice(index), options, error);
+          throw error;
+        }
+        try {
+          await this.publishFailureLifecycleEvent(notification, options, error);
+        } catch (publicationError) {
+          failure.error = publicationError instanceof Error ? publicationError : createLifecyclePublicationFailureError(error, publicationError);
+        }
+        failures.push(failure);
+      }
+    }
+    return {
+      failed: failures.length,
+      failures,
+      queued: results.length,
+      results,
+      succeeded: results.length
+    };
+  }
   static {
     _initClass();
   }

package/package.json

@@ -9,7 +9,7 @@
     "event-bus",
     "channels"
   ],
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0-beta.5",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -36,8 +36,8 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/core": "^1.0.0-beta.5",
-    "@fluojs/di": "^1.0.0-beta.7",
+    "@fluojs/core": "^1.0.0-beta.6",
+    "@fluojs/di": "^1.0.0-beta.8",
     "@fluojs/runtime": "^1.0.0-beta.12"
   },
   "devDependencies": {