@fluojs/slack 1.0.0-beta.4 → 1.0.0

package/README.ko.md

@@ -128,6 +128,7 @@ Behavioral contract 메모:
 - `SlackService.send(...)`는 전달 전에 `defaultChannel`을 해석합니다.
 - `SlackService.sendMany(...)`는 메시지를 순차적으로 보내며, fail-fast 대신 batch result가 필요한 호출자를 위해 `continueOnError`를 지원합니다.
 - 서비스는 모듈 bootstrap 시 transport를 초기화하고, factory가 소유한 리소스만 애플리케이션 shutdown 시 닫습니다.
+- shutdown이 시작된 뒤에는 `SlackService.send(...)`와 `SlackService.sendNotification(...)`이 transport를 재사용하거나 lazy 생성하지 않고 `SlackLifecycleError`로 실패합니다. 진행 중인 factory 소유 transport 생성은 shutdown이 기다린 뒤 닫습니다.
 - `SlackService.createPlatformStatusSnapshot()`은 호출자가 내부 옵션에 접근하지 않아도 lifecycle, readiness, transport 소유권을 보고합니다.
 - 이 패키지는 절대로 `process.env`를 직접 읽지 않습니다. 모든 설정은 명시적인 옵션 또는 DI를 통해 들어와야 합니다.
 
@@ -218,7 +219,10 @@ Slack 패키지는 의도적으로 다음을 **포함하지 않습니다**:
 - `SlackModule.forRoot(options)` / `SlackModule.forRootAsync(options)`
 - `createSlackProviders(options)`
 - `SlackService`
+- `SlackService.send(message, options)`
 - `SlackService.sendMany(messages, options)`
+- `SlackService.sendNotification(notification, options)`
+- `SlackService.createPlatformStatusSnapshot()`
 - `SlackChannel`
 - `SLACK`
 - `SLACK_CHANNEL`
@@ -256,6 +260,7 @@ Slack 패키지는 의도적으로 다음을 **포함하지 않습니다**:
 - `SlackLifecycleState`
 - `SlackStatusAdapterInput`
 - `SlackConfigurationError`
+- `SlackLifecycleError`: lifecycle로 차단된 전달, transport 초기화, 소유 리소스 shutdown 실패에서 발생합니다. 애플리케이션 teardown과 전송이 경합할 수 있다면 이 에러를 catch하세요.
 - `SlackMessageValidationError`
 - `SlackTransportError`
 

package/README.md

@@ -128,6 +128,7 @@ Behavioral contract notes:
 - `SlackService.send(...)` resolves `defaultChannel` before delivery.
 - `SlackService.sendMany(...)` sends messages sequentially and supports `continueOnError` when callers need a batch result instead of fail-fast behavior.
 - The service initializes the configured transport during module bootstrap and closes factory-owned resources during application shutdown.
+- Once shutdown starts, `SlackService.send(...)` and `SlackService.sendNotification(...)` fail with `SlackLifecycleError` instead of reusing or lazily creating transports; any in-flight factory-owned transport creation is awaited and closed by shutdown.
 - `SlackService.createPlatformStatusSnapshot()` reports lifecycle, readiness, and transport ownership without requiring callers to reach into internal options.
 - The package never reads `process.env` directly. All configuration must enter through explicit options or DI.
 
@@ -218,7 +219,10 @@ These limitations are part of the package contract so runtime choice, provider c
 - `SlackModule.forRoot(options)` / `SlackModule.forRootAsync(options)`
 - `createSlackProviders(options)`
 - `SlackService`
+- `SlackService.send(message, options)`
 - `SlackService.sendMany(messages, options)`
+- `SlackService.sendNotification(notification, options)`
+- `SlackService.createPlatformStatusSnapshot()`
 - `SlackChannel`
 - `SLACK`
 - `SLACK_CHANNEL`
@@ -256,6 +260,7 @@ These limitations are part of the package contract so runtime choice, provider c
 - `SlackLifecycleState`
 - `SlackStatusAdapterInput`
 - `SlackConfigurationError`
+- `SlackLifecycleError`: thrown by lifecycle-gated delivery, transport initialization, and owned-resource shutdown failures. Catch this error when sends can race with application teardown.
 - `SlackMessageValidationError`
 - `SlackTransportError`
 

package/dist/errors.d.ts

@@ -10,6 +10,12 @@ export declare class SlackConfigurationError extends Error {
 export declare class SlackMessageValidationError extends Error {
     constructor(message: string);
 }
+/**
+ * Thrown when Slack delivery is requested after the service lifecycle has started shutting down.
+ */
+export declare class SlackLifecycleError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
 /**
  * Thrown when one concrete Slack transport reports a caller-visible delivery failure.
  */

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -18,6 +18,16 @@ export class SlackMessageValidationError extends Error {
   }
 }
 
+/**
+ * Thrown when Slack delivery is requested after the service lifecycle has started shutting down.
+ */
+export class SlackLifecycleError extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = 'SlackLifecycleError';
+  }
+}
+
 /**
  * Thrown when one concrete Slack transport reports a caller-visible delivery failure.
  */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { SlackConfigurationError, SlackMessageValidationError, SlackTransportError, } from './errors.js';
+export { SlackConfigurationError, SlackLifecycleError, SlackMessageValidationError, SlackTransportError, } from './errors.js';
 export { SlackChannel } from './channel.js';
 export { SlackModule, createSlackProviders } from './module.js';
 export { SlackService } from './service.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC7G,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EACV,sBAAsB,EACtB,KAAK,EACL,uBAAuB,EACvB,eAAe,EACf,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gCAAgC,EAChC,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC7G,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EACV,sBAAsB,EACtB,KAAK,EACL,uBAAuB,EACvB,eAAe,EACf,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gCAAgC,EAChC,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
-export { SlackConfigurationError, SlackMessageValidationError, SlackTransportError } from './errors.js';
+export { SlackConfigurationError, SlackLifecycleError, SlackMessageValidationError, SlackTransportError } from './errors.js';
 export { SlackChannel } from './channel.js';
 export { SlackModule, createSlackProviders } from './module.js';
 export { SlackService } from './service.js';

package/dist/service.d.ts

@@ -72,6 +72,8 @@ export declare class SlackService implements Slack, OnModuleInit, OnApplicationS
      */
     sendNotification(notification: SlackNotificationDispatchRequest, options?: SlackSendOptions): Promise<SlackSendResult>;
     private ensureTransport;
+    private assertCanCreateOrUseTransport;
+    private assertCanDeliver;
     private normalizeMessage;
     private resolveNotificationChannel;
     private renderNotification;

package/dist/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK3E,OAAO,KAAK,EAEV,4BAA4B,EAC5B,KAAK,EACL,YAAY,EACZ,gCAAgC,EAChC,oBAAoB,EAEpB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EAGhB,MAAM,YAAY,CAAC;AAqBpB;;;;;;;GAOG;AACH,qBACa,YAAa,YAAW,KAAK,EAAE,YAAY,EAAE,qBAAqB;IAKjE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,cAAc,CAAmF;IACzG,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,gBAAgB,CAAsC;gBAEjC,OAAO,EAAE,4BAA4B;IAE5D,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAetC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC;;;;OAIG;IACH,4BAA4B;IAW5B;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAqB3F;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6BpH;;;;;;;;;;;;;;;;OAgBG;IACG,gBAAgB,CACpB,YAAY,EAAE,gCAAgC,EAC9C,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC;YA6Bb,eAAe;IAe7B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,0BAA0B;YAkBpB,kBAAkB;CAejC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK3E,OAAO,KAAK,EAEV,4BAA4B,EAC5B,KAAK,EACL,YAAY,EACZ,gCAAgC,EAChC,oBAAoB,EAEpB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EAGhB,MAAM,YAAY,CAAC;AA2CpB;;;;;;;GAOG;AACH,qBACa,YAAa,YAAW,KAAK,EAAE,YAAY,EAAE,qBAAqB;IAKjE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,gBAAgB,CAAsC;gBAEjC,OAAO,EAAE,4BAA4B;IAE5D,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBtC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCnC;;;;OAIG;IACH,4BAA4B;IAW5B;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAqB3F;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6BpH;;;;;;;;;;;;;;;;OAgBG;IACG,gBAAgB,CACpB,YAAY,EAAE,gCAAgC,EAC9C,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC;YAgCb,eAAe;IAiB7B,OAAO,CAAC,6BAA6B;IAMrC,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,0BAA0B;YAkBpB,kBAAkB;CAejC"}

package/dist/service.js

@@ -5,7 +5,7 @@ function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e =
 function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
 function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
 import { Inject } from '@fluojs/core';
-import { SlackMessageValidationError } from './errors.js';
+import { SlackLifecycleError, SlackMessageValidationError } from './errors.js';
 import { createSlackPlatformStatusSnapshot } from './status.js';
 import { SLACK_OPTIONS } from './tokens.js';
 function createAbortError() {
@@ -13,6 +13,22 @@ function createAbortError() {
   error.name = 'AbortError';
   return error;
 }
+function assertNotAborted(signal) {
+  if (signal?.aborted) {
+    throw createAbortError();
+  }
+}
+function createLifecycleError(message, cause) {
+  return new SlackLifecycleError(message, {
+    cause
+  });
+}
+function createDeliveryLifecycleError(state) {
+  return new SlackLifecycleError(`Slack delivery cannot start while the service lifecycle is ${state}.`);
+}
+function isShutdownLifecycleState(state) {
+  return state === 'stopping' || state === 'stopped';
+}
 function normalizeOptionalString(value) {
   const trimmed = value?.trim();
   return trimmed && trimmed.length > 0 ? trimmed : undefined;
@@ -45,26 +61,39 @@ class SlackService {
   async onApplicationShutdown() {
     this.lifecycleState = 'stopping';
     try {
-      if (this.resolvedTransport && this.options.transport.ownsResources && this.resolvedTransport.close) {
-        await this.resolvedTransport.close();
+      const transport = this.resolvedTransport ?? (this.transportPromise ? await this.transportPromise : undefined);
+      if (transport && this.options.transport.ownsResources && transport.close) {
+        await transport.close();
       }
       this.lifecycleState = 'stopped';
-    } catch {
+    } catch (error) {
       this.lifecycleState = 'failed';
-      throw new Error('Slack transport failed to close cleanly.');
+      throw createLifecycleError('Slack transport failed to close cleanly.', error);
     }
   }
   async onModuleInit() {
+    if (this.lifecycleState === 'stopping' || this.lifecycleState === 'stopped') {
+      return;
+    }
     this.lifecycleState = 'starting';
     try {
       const transport = await this.ensureTransport();
+      if (this.lifecycleState !== 'starting') {
+        return;
+      }
       if (this.options.verifyOnModuleInit && transport.verify) {
         await transport.verify();
       }
+      if (this.lifecycleState !== 'starting') {
+        return;
+      }
       this.lifecycleState = 'ready';
-    } catch {
+    } catch (error) {
+      if (isShutdownLifecycleState(this.lifecycleState)) {
+        throw error;
+      }
       this.lifecycleState = 'failed';
-      throw new Error('Slack transport failed to initialize.');
+      throw createLifecycleError('Slack transport failed to initialize.', error);
     }
   }
 
@@ -101,12 +130,12 @@ class SlackService {
    * ```
    */
   async send(message, options = {}) {
-    if (options.signal?.aborted) {
-      throw createAbortError();
-    }
+    assertNotAborted(options.signal);
+    this.assertCanDeliver();
     const transport = await this.ensureTransport();
     const normalized = this.normalizeMessage(message);
     assertMessageContent(normalized);
+    this.assertCanDeliver();
     const result = await transport.send(normalized, options);
     return {
       channel: result.channel ?? normalized.channel,
@@ -175,6 +204,8 @@ class SlackService {
    * ```
    */
   async sendNotification(notification, options = {}) {
+    assertNotAborted(options.signal);
+    this.assertCanDeliver();
     const payload = notification.payload;
     const rendered = await this.renderNotification(notification);
     return this.send({
@@ -203,6 +234,7 @@ class SlackService {
     }, options);
   }
   async ensureTransport() {
+    this.assertCanCreateOrUseTransport();
     if (this.resolvedTransport) {
       return this.resolvedTransport;
     }
@@ -214,6 +246,14 @@ class SlackService {
     }
     return this.transportPromise;
   }
+  assertCanCreateOrUseTransport() {
+    if (this.lifecycleState === 'stopping' || this.lifecycleState === 'stopped' || this.lifecycleState === 'failed') {
+      throw createDeliveryLifecycleError(this.lifecycleState);
+    }
+  }
+  assertCanDeliver() {
+    this.assertCanCreateOrUseTransport();
+  }
   normalizeMessage(message) {
     return {
       attachments: message.attachments ?? [],

package/package.json

@@ -9,7 +9,7 @@
     "portable",
     "fetch"
   ],
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -36,10 +36,10 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/core": "^1.0.0-beta.5",
-    "@fluojs/di": "^1.0.0-beta.7",
-    "@fluojs/notifications": "^1.0.0-beta.4",
-    "@fluojs/runtime": "^1.0.0-beta.12"
+    "@fluojs/core": "^1.0.0",
+    "@fluojs/di": "^1.0.0",
+    "@fluojs/notifications": "^1.0.0",
+    "@fluojs/runtime": "^1.0.0"
   },
   "devDependencies": {
     "vitest": "^3.2.4"