@gravito/signal 3.1.0 → 4.0.0

package/dist/OrbitSignal.d.ts

@@ -200,6 +200,12 @@ export declare class OrbitSignal implements GravitoOrbit {
      * ```
      */
     install(core: PlanetCore): void;
+    /**
+     * Gracefully release transport and dev resources.
+     *
+     * Called during shutdown. Detects closeable transports via type narrowing (no `as any`).
+     */
+    private cleanup;
     /**
      * Internal: Handle processed webhook.
      */

package/dist/errors/codes.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Structured error codes for @gravito/signal mail operations.
+ * Follows fortify's dot-separated namespace convention.
+ *
+ * NOTE: This replaces MailErrorCode enum for new code.
+ * The existing enum in ../errors.ts remains until Phase 18-19 migration.
+ *
+ * @public
+ */
+export declare const MailErrorCodes: {
+    readonly CONNECTION_FAILED: "mail.connection_failed";
+    readonly AUTH_FAILED: "mail.auth_failed";
+    readonly RECIPIENT_REJECTED: "mail.recipient_rejected";
+    readonly MESSAGE_REJECTED: "mail.message_rejected";
+    readonly RATE_LIMIT: "mail.rate_limit";
+    readonly SEND_FAILED: "mail.send_failed";
+    readonly UNKNOWN: "mail.unknown";
+};
+export type MailErrorCode = (typeof MailErrorCodes)[keyof typeof MailErrorCodes];

package/dist/errors.d.ts

@@ -1,9 +1,10 @@
+import { InfrastructureException } from '@gravito/core';
+import { type MailErrorCode as MailErrorCodeType } from './errors/codes';
 /**
- * Mail transport error codes.
- *
- * Categorizes common failure modes in the mail delivery process to allow
- * for programmatic handling (e.g., retries on rate limits).
+ * Mail transport error codes (legacy enum — kept for backward compat).
+ * New code should use MailErrorCodes from './errors/codes' instead.
  *
+ * @deprecated Use MailErrorCodes from './errors/codes'
  * @public
  * @since 3.1.0
  */
@@ -24,8 +25,9 @@ export declare enum MailErrorCode {
 /**
  * Error class for mail transport failures.
  *
- * Provides structured error information for mail sending failures,
- * including error codes and original cause tracking for debugging.
+ * Extends InfrastructureException for unified error handling across Gravito.
+ * Carries a `retryable` flag indicating whether the operation can be retried,
+ * and preserves backward compat with the legacy MailErrorCode enum via `.legacyCode`.
  *
  * @example
  * ```typescript
@@ -39,14 +41,19 @@ export declare enum MailErrorCode {
  * @public
  * @since 3.1.0
  */
-export declare class MailTransportError extends Error {
-    readonly code: MailErrorCode;
-    readonly cause?: Error;
+export declare class MailTransportError extends InfrastructureException {
+    /**
+     * Legacy enum code — preserved for backward compat with callers that switch on MailErrorCode.
+     * @deprecated Prefer checking `.code` (mail.* namespaced string) instead.
+     */
+    readonly legacyCode: MailErrorCode;
     /**
      * Create a new mail transport error.
      *
+     * Accepts both the legacy MailErrorCode enum and new mail.* namespaced string codes.
+     *
      * @param message - Human-readable error message
-     * @param code - Categorized error code
+     * @param code - Categorized error code (legacy enum or new mail.* string)
      * @param cause - Original error that caused this failure
      *
      * @example
@@ -54,5 +61,5 @@ export declare class MailTransportError extends Error {
      * const error = new MailTransportError('Auth failed', MailErrorCode.AUTH_FAILED);
      * ```
      */
-    constructor(message: string, code: MailErrorCode, cause?: Error);
+    constructor(message: string, code?: MailErrorCode | MailErrorCodeType, cause?: Error);
 }