@gravito/signal 3.1.0 → 4.0.0

package/dist/transports/BaseTransport.d.ts

@@ -5,6 +5,9 @@ import type { Message, Transport } from '../types';
  * Defines the behavior of the automatic retry mechanism, including the number of attempts
  * and the timing between them using exponential backoff.
  *
+ * @deprecated Configuration now handled internally by @gravito/resilience RetryOptions.
+ * Kept for backward compat of existing subclass constructors.
+ *
  * @example
  * ```typescript
  * const options: TransportOptions = {
@@ -29,21 +32,17 @@ export interface TransportOptions {
     /**
      * Multiplier applied to the delay after each failed attempt.
      * Used to implement exponential backoff to avoid overwhelming the service.
+     * @deprecated Backoff is now managed by @gravito/resilience (ExponentialBackoff).
      */
     backoffMultiplier?: number;
 }
 /**
- * Base transport class with automatic retry mechanism.
+ * Base transport class with automatic retry via @gravito/resilience.
  *
  * This abstract class provides a robust foundation for all transport implementations by
- * handling transient failures through an exponential backoff retry strategy. It ensures
- * that temporary network issues or service rate limits do not immediately fail the email delivery.
- *
- * The retry mechanism works as follows:
- * 1. Attempt to send the message via `doSend()`.
- * 2. If it fails, wait for `retryDelay` milliseconds.
- * 3. Increment the delay by `backoffMultiplier` for the next attempt.
- * 4. Repeat until success or `maxRetries` is reached.
+ * handling transient failures through the unified @gravito/resilience withRetry primitive.
+ * Only errors whose `retryable` flag is true (e.g., CONNECTION_FAILED, RATE_LIMIT) are
+ * retried automatically.
  *
  * @example
  * ```typescript
@@ -54,7 +53,7 @@ export interface TransportOptions {
  *
  *   protected async doSend(message: Message): Promise<void> {
  *     // Actual implementation of the sending logic
- *     // If this throws, BaseTransport will catch and retry
+ *     // If this throws, BaseTransport will retry via withRetry
  *   }
  * }
  * ```
@@ -70,14 +69,14 @@ export declare abstract class BaseTransport implements Transport {
      */
     constructor(options?: TransportOptions);
     /**
-     * Orchestrates the message delivery with retry logic.
+     * Orchestrates the message delivery with automatic retry via @gravito/resilience.
      *
-     * This method wraps the concrete `doSend` implementation in a retry loop.
-     * It tracks the last error encountered to provide context if all retries fail.
+     * Delegates to `doSend()` and retries on retryable InfrastructureException errors
+     * (CONNECTION_FAILED, RATE_LIMIT). Non-retryable errors surface immediately.
      *
      * @param message - The message to be delivered.
      * @returns A promise that resolves when the message is successfully sent.
-     * @throws {MailTransportError} If the message cannot be sent after the maximum number of retries.
+     * @throws {MailTransportError} If the message cannot be sent after the maximum number of attempts.
      *
      * @example
      * ```typescript
@@ -94,18 +93,11 @@ export declare abstract class BaseTransport implements Transport {
      * Actual transport implementation to be provided by subclasses.
      *
      * This method should contain the protocol-specific logic for delivering the message.
-     * It will be automatically retried by the `send` method if it throws an error.
+     * It will be automatically retried by `send()` if it throws a retryable error.
      *
      * @param message - The message to send.
      * @returns A promise that resolves when the delivery is successful.
-     * @throws {Error} Any error encountered during delivery, which will trigger a retry.
+     * @throws {Error} Any error encountered during delivery, which may trigger a retry.
      */
     protected abstract doSend(message: Message): Promise<void>;
-    /**
-     * Utility method to pause execution for a given duration.
-     *
-     * @param ms - Milliseconds to sleep.
-     * @returns A promise that resolves after the delay.
-     */
-    private sleep;
 }

package/package.json

@@ -1,11 +1,18 @@
 {
   "name": "@gravito/signal",
   "sideEffects": false,
-  "version": "3.1.0",
+  "version": "4.0.0",
   "description": "Powerful email framework for Gravito applications with Dev UI and multi-renderer support.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
   "scripts": {
     "build": "bun run build.ts",
     "build:dts": "bun run build.ts --dts-only",
@@ -16,6 +23,10 @@
     "test:unit": "bun test tests/ --timeout=10000",
     "test:integration": "test $(find tests -name '*.integration.test.ts' 2>/dev/null | wc -l) -gt 0 && find tests -name '*.integration.test.ts' -print0 | xargs -0 bun test --timeout=10000 || echo 'No integration tests found'"
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "keywords": [
     "gravito",
     "mail",
@@ -28,12 +39,13 @@
   "license": "MIT",
   "dependencies": {
     "@aws-sdk/client-ses": "^3.953.0",
+    "@gravito/resilience": "workspace:*",
     "nodemailer": "^7.0.11"
   },
   "peerDependencies": {
-    "@gravito/core": "^2.0.0",
-    "@gravito/stream": "^2.1.0",
-    "@gravito/prism": "^3.1.1",
+    "@gravito/core": "^3.0.0",
+    "@gravito/stream": "^3.0.0",
+    "@gravito/prism": "^4.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "vue": "^3.0.0"

package/CHANGELOG.md

@@ -1,74 +0,0 @@
-# @gravito/signal
-
-## 3.0.4
-
-### Patch Changes
-
-- Convert all workspace:\* dependencies to version numbers for npm publishing
-
-  - Fixed 144 workspace:\* dependencies across 58 packages
-  - Ensures all packages work properly when installed from npm
-  - Resolves issues with bunx and npm installation of CLI tools
-  - All internal dependencies now use explicit version constraints
-
-- Updated dependencies
-  - @gravito/core@1.6.1
-  - @gravito/prism@3.1.1
-  - @gravito/stream@2.0.2
-
-## 3.0.3
-
-### Patch Changes
-
-- Updated dependencies [6234dab]
-  - @gravito/prism@3.0.2
-
-## 3.0.2
-
-### Patch Changes
-
-- Updated dependencies [905588f]
-  - @gravito/stream@2.0.1
-
-## 3.0.1
-
-### Patch Changes
-
-- Updated dependencies
-  - @gravito/core@1.2.1
-  - @gravito/stream@1.0.3
-  - @gravito/prism@3.0.1
-
-## 3.0.0
-
-### Patch Changes
-
-- Updated dependencies
-  - @gravito/core@1.2.0
-  - @gravito/prism@3.0.0
-  - @gravito/stream@1.0.2
-
-## 2.0.0
-
-### Patch Changes
-
-- Updated dependencies
-- Updated dependencies
-  - @gravito/core@1.1.0
-  - @gravito/prism@2.0.0
-  - @gravito/stream@1.0.1
-
-## 1.0.1
-
-### Patch Changes
-
-- Refactored all scaffold generators (Enterprise MVC, Clean Architecture, Action Domain, DDD) to adopt the Service Provider pattern and a modern 4-step bootstrap lifecycle. Fixed a missing mock in @gravito/signal tests.
-
-## 1.0.0
-
-### Patch Changes
-
-- Updated dependencies
-  - @gravito/core@1.0.0
-  - @gravito/stream@1.0.0
-  - @gravito/prism@1.0.0

package/build.ts

@@ -1,133 +0,0 @@
-import { cp, type Dirent, mkdir, readdir, rm } from 'node:fs/promises'
-import { basename } from 'node:path'
-import { build } from 'bun'
-
-const isDtsOnly = process.argv.includes('--dts-only')
-const pkgName = basename(import.meta.dirname) // "signal"
-
-console.log(
-  isDtsOnly ? 'Building @gravito/signal DTS...' : 'Building @gravito/signal in parallel...'
-)
-
-// Clean dist
-await rm('dist', { recursive: true, force: true })
-
-// External dependencies（peer deps + framework 包）
-const externalDeps = [
-  '@gravito/core',
-  '@gravito/stream',
-  '@gravito/prism',
-  'react',
-  'react-dom',
-  'vue',
-  '@vue/server-renderer',
-  'nodemailer',
-  '@aws-sdk/client-ses',
-]
-
-async function buildInParallel() {
-  const tasks: Promise<number>[] = []
-  const tempDir = isDtsOnly ? 'dist' : '.tsc-temp'
-
-  if (!isDtsOnly) {
-    await rm(tempDir, { recursive: true, force: true })
-
-    // Task 1: bun build ESM
-    const esmPromise = (async () => {
-      const buildResult = await build({
-        entrypoints: ['src/index.ts'],
-        outdir: 'dist',
-        format: 'esm',
-        target: 'node',
-        splitting: false,
-        sourcemap: 'external',
-        external: externalDeps,
-        naming: '[dir]/[name].mjs',
-      })
-
-      if (!buildResult.success) {
-        console.error('❌ ESM build failed:', buildResult.logs)
-        return 1
-      }
-      return 0
-    })()
-    tasks.push(esmPromise)
-
-    // Task 2: bun build CJS
-    const cjsPromise = (async () => {
-      const cjsResult = await build({
-        entrypoints: ['src/index.ts'],
-        outdir: 'dist',
-        format: 'cjs',
-        target: 'node',
-        splitting: false,
-        sourcemap: 'external',
-        naming: '[dir]/[name].cjs',
-        external: externalDeps,
-      })
-
-      if (!cjsResult.success) {
-        console.error('❌ CJS build failed:', cjsResult.logs)
-        return 1
-      }
-      return 0
-    })()
-    tasks.push(cjsPromise)
-  }
-
-  // Task 3: tsc 生成型別宣告（使用 tsconfig.build.json + noCheck）
-  const tscPromise = (async () => {
-    const tsc = Bun.spawn(['bunx', 'tsc', '-p', 'tsconfig.build.json', '--outDir', tempDir], {
-      stdout: 'inherit',
-      stderr: 'inherit',
-      cwd: import.meta.dirname,
-    })
-    return await tsc.exited
-  })()
-  tasks.push(tscPromise)
-
-  const results = await Promise.all(tasks)
-  for (const result of results) {
-    if (result !== 0) {
-      process.exit(1)
-    }
-  }
-}
-
-// 遞迴複製 .d.ts 檔案
-async function copyDtsFiles(src: string, dest: string) {
-  let entries: Dirent[]
-  try {
-    entries = await readdir(src, { withFileTypes: true })
-  } catch (_e) {
-    return
-  }
-
-  for (const entry of entries) {
-    const srcPath = `${src}/${entry.name}`
-    const destPath = `${dest}/${entry.name}`
-
-    if (entry.isDirectory()) {
-      await mkdir(destPath, { recursive: true }).catch(() => {})
-      await copyDtsFiles(srcPath, destPath)
-    } else if (entry.isFile() && entry.name.endsWith('.d.ts')) {
-      await cp(srcPath, destPath)
-    }
-  }
-}
-
-await buildInParallel()
-
-// 後處理：tsc 輸出到 .tsc-temp/{pkgName}/src/，需要移到 dist/
-const tempDir = isDtsOnly ? 'dist' : '.tsc-temp'
-if (!isDtsOnly) {
-  try {
-    const dtsSourceDir = `${tempDir}/${pkgName}/src`
-    await copyDtsFiles(dtsSourceDir, 'dist')
-    await rm(tempDir, { recursive: true, force: true })
-  } catch (e) {
-    console.warn('⚠️  Warning: Failed to copy type declarations:', e)
-  }
-}
-
-console.log('✅ @gravito/signal build completed')