@fluojs/discord 1.0.0 → 1.0.2

package/README.ko.md

@@ -96,6 +96,7 @@ Behavioral contract 메모:
 
 - `DiscordService.send(...)`는 전달 전에 `defaultThreadId`를 해석합니다.
 - 서비스는 모듈 bootstrap 시 transport를 초기화하고, factory가 소유한 리소스만 애플리케이션 shutdown 시 닫습니다.
+- send는 bootstrap이 transport를 `ready`로 표시한 뒤에만 허용됩니다. bootstrap 전, startup 중, bootstrap 실패 후, shutdown 중, shutdown 후 시도는 전달 전에 거부됩니다.
 - 서비스가 shutdown 중이거나 이미 stopped 상태라면 cached transport를 재사용하지 않고 send를 거부합니다.
 - 빈 `defaultThreadId`와 `notifications.channel` 값은 trim 후 무시됩니다. notifications channel은 기본적으로 `discord`입니다.
 - 이 패키지는 절대로 `process.env`를 직접 읽지 않습니다. 모든 설정은 명시적인 옵션 또는 DI를 통해 들어와야 합니다.
@@ -166,8 +167,8 @@ bot 기반 REST 전달처럼 더 풍부한 API 연동이 필요하다면 export
 Behavioral contract 메모:
 
 - 내장 webhook transport는 `408`, `429`, `5xx` 같은 일시적 응답뿐 아니라 transport-level exception도 bounded exponential backoff로 재시도한 뒤 호출자에게 에러를 노출합니다. 영구적인 upstream 응답은 재시도하지 않습니다.
+- 성공한 webhook 응답은 `DiscordSendResult.response`로 노출됩니다. rate-limit 재시도가 끝내 실패한 경우를 포함해, 호출자에게 보이는 `DiscordTransportError` 메시지는 기본적으로 raw upstream response body를 포함하지 않습니다.
 - 잘못되었거나 절대 URL이 아닌 `webhookUrl` 값은 전달 실패로 재시도하지 않고 즉시 `DiscordConfigurationError`로 거부됩니다.
-- 호출자에게 보이는 `DiscordTransportError` 메시지는 기본적으로 raw upstream response body를 포함하지 않습니다.
 
 ### 의도적인 제한 사항
 
@@ -184,7 +185,10 @@ Discord 패키지는 의도적으로 다음을 **포함하지 않습니다**:
 
 ### 핵심
 
+- `Discord`
 - `DiscordModule.forRoot(options)` / `DiscordModule.forRootAsync(options)`
+- `DiscordModuleOptions`
+- `DiscordAsyncModuleOptions`
 - `DiscordService`
 - `DiscordChannel`
 - `DISCORD`
@@ -196,11 +200,11 @@ Discord 패키지는 의도적으로 다음을 **포함하지 않습니다**:
 
 - `DiscordMessage`
 - `NormalizedDiscordMessage`
-- `DiscordAsyncModuleOptions`
 - `DiscordWebhookTransportOptions`
 - `DiscordFetchLike`
 - `DiscordFetchResponse`
 - `DiscordSendResult`
+- `DiscordSendOptions`
 - `DiscordSendManyOptions`
 - `DiscordSendBatchResult`
 - `DiscordSendFailure`
@@ -212,7 +216,9 @@ Discord 패키지는 의도적으로 다음을 **포함하지 않습니다**:
 - `DiscordEmbed`
 - `DiscordPoll`
 - `DiscordTransport`
+- `DiscordTransportContext`
 - `DiscordTransportFactory`
+- `DiscordTransportReceipt`
 - `DiscordTemplateRenderInput`
 - `DiscordTemplateRenderResult`
 - `DiscordTemplateRenderer`
@@ -222,6 +228,8 @@ Discord 패키지는 의도적으로 다음을 **포함하지 않습니다**:
 
 - `createDiscordPlatformStatusSnapshot(...)`
 - `DiscordLifecycleState`
+- `DiscordPlatformStatusSnapshot`
+- `DiscordStatusAdapterInput`
 - `DiscordConfigurationError`
 - `DiscordMessageValidationError`
 - `DiscordTransportError`

package/README.md

@@ -96,6 +96,7 @@ Behavioral contract notes:
 
 - `DiscordService.send(...)` resolves `defaultThreadId` before delivery.
 - The service initializes the configured transport during module bootstrap and closes factory-owned resources during application shutdown.
+- Sends are accepted only after bootstrap marks the transport `ready`; attempts before bootstrap, during startup, after failed bootstrap, while shutting down, or after shutdown are rejected before delivery.
 - Sends attempted while the service is shutting down or already stopped are rejected before reusing the cached transport.
 - Blank `defaultThreadId` and `notifications.channel` values are trimmed and ignored; the notifications channel defaults to `discord`.
 - The package never reads `process.env` directly. All configuration must enter through explicit options or DI.
@@ -166,8 +167,8 @@ For richer API integrations such as bot-backed REST delivery, implement the expo
 Behavioral contract notes:
 
 - The built-in webhook transport retries transient `408`, `429`, and `5xx` responses, and also retries transport-level exceptions, using bounded exponential backoff before surfacing an error. Permanent upstream responses are not retried.
+- Successful webhook responses are exposed through `DiscordSendResult.response`; caller-visible `DiscordTransportError` messages still omit raw upstream response bodies by default, including after rate-limit retries fail.
 - Malformed or non-absolute `webhookUrl` values are rejected immediately as `DiscordConfigurationError` instead of being retried as delivery failures.
-- Caller-visible `DiscordTransportError` messages omit raw upstream response bodies by default.
 
 ### Intentional limitations
 
@@ -184,7 +185,10 @@ These limitations are part of the package contract so runtime choice, provider c
 
 ### Core
 
+- `Discord`
 - `DiscordModule.forRoot(options)` / `DiscordModule.forRootAsync(options)`
+- `DiscordModuleOptions`
+- `DiscordAsyncModuleOptions`
 - `DiscordService`
 - `DiscordChannel`
 - `DISCORD`
@@ -196,11 +200,11 @@ Compose applications through `DiscordModule` and integrate notifications through
 
 - `DiscordMessage`
 - `NormalizedDiscordMessage`
-- `DiscordAsyncModuleOptions`
 - `DiscordWebhookTransportOptions`
 - `DiscordFetchLike`
 - `DiscordFetchResponse`
 - `DiscordSendResult`
+- `DiscordSendOptions`
 - `DiscordSendManyOptions`
 - `DiscordSendBatchResult`
 - `DiscordSendFailure`
@@ -212,7 +216,9 @@ Compose applications through `DiscordModule` and integrate notifications through
 - `DiscordEmbed`
 - `DiscordPoll`
 - `DiscordTransport`
+- `DiscordTransportContext`
 - `DiscordTransportFactory`
+- `DiscordTransportReceipt`
 - `DiscordTemplateRenderInput`
 - `DiscordTemplateRenderResult`
 - `DiscordTemplateRenderer`
@@ -222,6 +228,8 @@ Compose applications through `DiscordModule` and integrate notifications through
 
 - `createDiscordPlatformStatusSnapshot(...)`
 - `DiscordLifecycleState`
+- `DiscordPlatformStatusSnapshot`
+- `DiscordStatusAdapterInput`
 - `DiscordConfigurationError`
 - `DiscordMessageValidationError`
 - `DiscordTransportError`

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,EACV,OAAO,EACP,cAAc,EACd,kCAAkC,EAClC,sBAAsB,EAEtB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EAIjB,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAyBpB;;;;;;;GAOG;AACH,qBACa,cAAe,YAAW,OAAO,EAAE,YAAY,EAAE,qBAAqB;IAKrE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,cAAc,CAAmF;IACzG,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,gBAAgB,CAAwC;gBAEnC,OAAO,EAAE,8BAA8B;IAE9D,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAetC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC;;;;OAIG;IACH,4BAA4B;IAW5B;;;;;;;;;;;;;;OAcG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyBjG;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA6B1H;;;;;;;;;;;;;;;;OAgBG;IACG,gBAAgB,CACpB,YAAY,EAAE,kCAAkC,EAChD,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;YAiCf,eAAe;IAe7B,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,2BAA2B;YAkBrB,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,EACV,OAAO,EACP,cAAc,EACd,kCAAkC,EAClC,sBAAsB,EAEtB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EAIjB,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAyCpB;;;;;;;GAOG;AACH,qBACa,cAAe,YAAW,OAAO,EAAE,YAAY,EAAE,qBAAqB;IAKrE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,cAAc,CAA2C;IACjE,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,gBAAgB,CAAwC;gBAEnC,OAAO,EAAE,8BAA8B;IAE9D,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAetC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC;;;;OAIG;IACH,4BAA4B;IAW5B;;;;;;;;;;;;;;OAcG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyBjG;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA6B1H;;;;;;;;;;;;;;;;OAgBG;IACG,gBAAgB,CACpB,YAAY,EAAE,kCAAkC,EAChD,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;YAiCf,eAAe;IAe7B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,2BAA2B;YAkBrB,kBAAkB;CAejC"}

package/dist/service.js

@@ -16,16 +16,22 @@ function createAbortError() {
 function createStoppedTransportError() {
   return new DiscordTransportError('Discord transport is shutting down or already stopped.');
 }
+function createLifecycleReadinessError(lifecycleState) {
+  if (lifecycleState === 'failed') {
+    return new DiscordTransportError('Discord transport failed to initialize.');
+  }
+  return new DiscordTransportError('Discord transport is not ready for delivery.');
+}
 function normalizeOptionalString(value) {
   const trimmed = value?.trim();
   return trimmed && trimmed.length > 0 ? trimmed : undefined;
 }
 function assertMessageContent(message) {
-  if (!message.content && message.embeds.length === 0 && message.components.length === 0 && message.attachments.length === 0) {
-    throw new DiscordMessageValidationError('Discord messages require `content`, `embeds`, `components`, or `attachments` content.');
+  if (!message.content && message.embeds.length === 0 && message.components.length === 0 && message.attachments.length === 0 && !message.poll) {
+    throw new DiscordMessageValidationError('Discord messages require `content`, `embeds`, `components`, `attachments`, or `poll` content.');
   }
 }
-
+let _DiscordService;
 /**
  * Injectable Discord delivery service for standalone and notifications-backed usage.
  *
@@ -34,7 +40,6 @@ function assertMessageContent(message) {
  * explicitly injected {@link DiscordTransport} contracts, and translates
  * `@fluojs/notifications` envelopes into concrete Discord messages.
  */
-let _DiscordService;
 class DiscordService {
   static {
     [_DiscordService, _initClass] = _applyDecs(this, [Inject(DISCORD_OPTIONS)], []).c;
@@ -230,6 +235,9 @@ class DiscordService {
     if (this.lifecycleState === 'stopping' || this.lifecycleState === 'stopped') {
       throw createStoppedTransportError();
     }
+    if (this.lifecycleState !== 'ready') {
+      throw createLifecycleReadinessError(this.lifecycleState);
+    }
   }
   normalizeMessage(message) {
     return {

package/package.json

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