@gravito/flare 4.0.2 → 5.0.0

package/dist/index.cjs

@@ -200,6 +200,8 @@ __export(index_exports, {
   AbortError: () => AbortError,
   BroadcastChannel: () => BroadcastChannel,
   DatabaseChannel: () => DatabaseChannel,
+  FlareError: () => FlareError,
+  FlareErrorCodes: () => FlareErrorCodes,
   LazyNotification: () => LazyNotification,
   MailChannel: () => MailChannel,
   MemoryStore: () => MemoryStore,
@@ -225,6 +227,37 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/errors/FlareError.ts
+var import_core = require("@gravito/core");
+var FlareError = class extends import_core.InfrastructureException {
+  /**
+   * Creates a new FlareError instance.
+   *
+   * @param code - The error code.
+   * @param message - The error message.
+   * @param options - Optional infrastructure exception options.
+   */
+  constructor(code, message, options = {}) {
+    const status = options.retryable ? 503 : 500;
+    super(status, code, { message, ...options });
+    this.name = "FlareError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/errors/codes.ts
+var FlareErrorCodes = {
+  RATE_LIMIT_EXCEEDED: "flare.rate_limit_exceeded",
+  SERIALIZATION_FAILED: "flare.serialization_failed",
+  TEMPLATE_NOT_DEFINED: "flare.template_not_defined",
+  NOTIFIABLE_MISSING_EMAIL: "flare.notifiable_missing_email",
+  INVALID_CONFIG: "flare.invalid_config",
+  NOTIFICATION_METHOD_NOT_IMPLEMENTED: "flare.notification_method_not_implemented",
+  UNSUPPORTED_PROVIDER: "flare.unsupported_provider",
+  CREDENTIALS_MISSING: "flare.credentials_missing",
+  SEND_FAILED: "flare.send_failed"
+};
+
 // src/channels/TimeoutChannel.ts
 var TimeoutError = class extends Error {
   constructor(message) {
@@ -322,7 +355,10 @@ var BroadcastChannel = class {
     const innerChannel = {
       send: async (notification, notifiable, _options) => {
         if (!notification.toBroadcast) {
-          throw new Error("Notification does not implement toBroadcast method");
+          throw new FlareError(
+            FlareErrorCodes.NOTIFICATION_METHOD_NOT_IMPLEMENTED,
+            "Notification does not implement toBroadcast method"
+          );
         }
         const broadcastNotification = notification.toBroadcast(notifiable);
         const notifiableId = notifiable.getNotifiableId();
@@ -356,7 +392,10 @@ var DatabaseChannel = class {
     const innerChannel = {
       send: async (notification, notifiable, _options) => {
         if (!notification.toDatabase) {
-          throw new Error("Notification does not implement toDatabase method");
+          throw new FlareError(
+            FlareErrorCodes.NOTIFICATION_METHOD_NOT_IMPLEMENTED,
+            "Notification does not implement toDatabase method"
+          );
         }
         const dbNotification = notification.toDatabase(notifiable);
         await this.dbService.insertNotification({
@@ -388,7 +427,10 @@ var MailChannel = class {
     const innerChannel = {
       send: async (notification, notifiable, _options) => {
         if (!notification.toMail) {
-          throw new Error("Notification does not implement toMail method");
+          throw new FlareError(
+            FlareErrorCodes.NOTIFICATION_METHOD_NOT_IMPLEMENTED,
+            "Notification does not implement toMail method"
+          );
         }
         const message = notification.toMail(notifiable);
         await this.mailService.send(message);
@@ -414,7 +456,10 @@ var SlackChannel = class {
     const innerChannel = {
       send: async (notification, notifiable, options) => {
         if (!notification.toSlack) {
-          throw new Error("Notification does not implement toSlack method");
+          throw new FlareError(
+            FlareErrorCodes.NOTIFICATION_METHOD_NOT_IMPLEMENTED,
+            "Notification does not implement toSlack method"
+          );
         }
         const slackMessage = notification.toSlack(notifiable);
         const response = await fetch(this.config.webhookUrl, {
@@ -433,7 +478,10 @@ var SlackChannel = class {
           // Pass AbortSignal to fetch
         });
         if (!response.ok) {
-          throw new Error(`Failed to send Slack notification: ${response.statusText}`);
+          throw new FlareError(
+            FlareErrorCodes.SEND_FAILED,
+            `Failed to send Slack notification: ${response.statusText}`
+          );
         }
       }
     };
@@ -457,7 +505,10 @@ var SmsChannel = class {
     const innerChannel = {
       send: async (notification, notifiable, options) => {
         if (!notification.toSms) {
-          throw new Error("Notification does not implement toSms method");
+          throw new FlareError(
+            FlareErrorCodes.NOTIFICATION_METHOD_NOT_IMPLEMENTED,
+            "Notification does not implement toSms method"
+          );
         }
         const smsMessage = notification.toSms(notifiable);
         switch (this.config.provider) {
@@ -468,7 +519,10 @@ var SmsChannel = class {
             await this.sendViaAwsSns(smsMessage, options?.signal);
             break;
           default:
-            throw new Error(`Unsupported SMS provider: ${this.config.provider}`);
+            throw new FlareError(
+              FlareErrorCodes.UNSUPPORTED_PROVIDER,
+              `Unsupported SMS provider: ${this.config.provider}`
+            );
         }
       }
     };
@@ -487,7 +541,10 @@ var SmsChannel = class {
    */
   async sendViaTwilio(message, signal) {
     if (!this.config.apiKey || !this.config.apiSecret) {
-      throw new Error("Twilio API key and secret are required");
+      throw new FlareError(
+        FlareErrorCodes.CREDENTIALS_MISSING,
+        "Twilio API key and secret are required"
+      );
     }
     const accountSid = this.config.apiKey;
     const authToken = this.config.apiSecret;
@@ -510,7 +567,7 @@ var SmsChannel = class {
     );
     if (!response.ok) {
       const error = await response.text();
-      throw new Error(`Failed to send SMS via Twilio: ${error}`);
+      throw new FlareError(FlareErrorCodes.SEND_FAILED, `Failed to send SMS via Twilio: ${error}`);
     }
   }
   /**
@@ -524,7 +581,8 @@ var SmsChannel = class {
       SNSClient = awsSns.SNSClient;
       PublishCommand = awsSns.PublishCommand;
     } catch {
-      throw new Error(
+      throw new FlareError(
+        FlareErrorCodes.UNSUPPORTED_PROVIDER,
         "AWS SNS SMS requires @aws-sdk/client-sns. Install it with: bun add @aws-sdk/client-sns"
       );
     }
@@ -555,7 +613,10 @@ var SmsChannel = class {
       await client.send(command, { abortSignal: signal });
     } catch (error) {
       const err = error instanceof Error ? error : new Error(String(error));
-      throw new Error(`Failed to send SMS via AWS SNS: ${err.message}`);
+      throw new FlareError(
+        FlareErrorCodes.SEND_FAILED,
+        `Failed to send SMS via AWS SNS: ${err.message}`
+      );
     }
   }
 };
@@ -907,7 +968,8 @@ var RateLimitMiddleware = class {
       if (bucket) {
         const allowed = bucket.tryConsume();
         if (!allowed) {
-          throw new Error(
+          throw new FlareError(
+            FlareErrorCodes.RATE_LIMIT_EXCEEDED,
             `Rate limit exceeded for channel '${channel}' (${window}ly limit). Please try again later.`
           );
         }
@@ -1210,7 +1272,8 @@ function checkSerializable(obj, path = "") {
 function assertSerializable(obj) {
   const result = checkSerializable(obj);
   if (!result.serializable) {
-    throw new Error(
+    throw new FlareError(
+      FlareErrorCodes.SERIALIZATION_FAILED,
       `\u7269\u4EF6\u5305\u542B\u4E0D\u53EF\u5E8F\u5217\u5316\u7684\u5C6C\u6027:
 \u554F\u984C\u8DEF\u5F91: ${result.problematicPaths.join(", ")}
 \u8A73\u7D30\u8CC7\u8A0A:
@@ -1729,24 +1792,30 @@ var OrbitFlare = class _OrbitFlare {
     if (options.enableSlack) {
       const slack = options.channels?.slack;
       if (!slack?.webhookUrl) {
-        throw new Error(
+        throw new FlareError(
+          FlareErrorCodes.INVALID_CONFIG,
           "[OrbitFlare] Slack channel enabled but webhookUrl not provided. Configure channels.slack.webhookUrl or set enableSlack to false."
         );
       }
       if (!this.isValidUrl(slack.webhookUrl)) {
-        throw new Error(`[OrbitFlare] Invalid Slack webhook URL: ${slack.webhookUrl}`);
+        throw new FlareError(
+          FlareErrorCodes.INVALID_CONFIG,
+          `[OrbitFlare] Invalid Slack webhook URL: ${slack.webhookUrl}`
+        );
       }
     }
     if (options.enableSms) {
       const sms = options.channels?.sms;
       if (!sms?.provider) {
-        throw new Error(
+        throw new FlareError(
+          FlareErrorCodes.INVALID_CONFIG,
           "[OrbitFlare] SMS channel enabled but provider not specified. Configure channels.sms.provider or set enableSms to false."
         );
       }
       const supportedProviders = ["twilio", "aws-sns"];
       if (!supportedProviders.includes(sms.provider)) {
-        throw new Error(
+        throw new FlareError(
+          FlareErrorCodes.UNSUPPORTED_PROVIDER,
           `[OrbitFlare] Unsupported SMS provider: ${sms.provider}. Supported providers: ${supportedProviders.join(", ")}`
         );
       }
@@ -1869,7 +1938,7 @@ var OrbitFlare = class _OrbitFlare {
 };
 
 // src/templates/NotificationTemplate.ts
-var import_core = require("@gravito/core");
+var import_core2 = require("@gravito/core");
 var TemplatedNotification = class extends Notification {
   data = {};
   with(data) {
@@ -1889,7 +1958,7 @@ var TemplatedNotification = class extends Notification {
   // Auto-implement toSlack
   toSlack(_notifiable) {
     if (!this.slackTemplate) {
-      throw new Error("slackTemplate not defined");
+      throw new FlareError(FlareErrorCodes.TEMPLATE_NOT_DEFINED, "slackTemplate not defined");
     }
     const template = this.slackTemplate();
     return {
@@ -1919,8 +1988,8 @@ var TemplatedNotification = class extends Notification {
       return "";
     }
     const interpolated = this.interpolate(template);
-    const md = (0, import_core.getMarkdownAdapter)();
-    const sanitizeCallbacks = (0, import_core.createHtmlRenderCallbacks)({
+    const md = (0, import_core2.getMarkdownAdapter)();
+    const sanitizeCallbacks = (0, import_core2.createHtmlRenderCallbacks)({
       html: (rawHtml) => sanitizeHtml(rawHtml)
     });
     return md.render(interpolated, sanitizeCallbacks);
@@ -1932,7 +2001,10 @@ var TemplatedNotification = class extends Notification {
     if ("email" in notifiable && typeof notifiable.email === "string") {
       return notifiable.email;
     }
-    throw new Error("Notifiable does not have an email property");
+    throw new FlareError(
+      FlareErrorCodes.NOTIFIABLE_MISSING_EMAIL,
+      "Notifiable does not have an email property"
+    );
   }
 };
 var DANGEROUS_TAGS = /^<\/?(?:script|iframe|object|embed|form|input|textarea|button|select|style|link|meta|base)\b[^>]*>$/i;
@@ -2004,6 +2076,8 @@ var LazyNotification = class extends Notification {
   AbortError,
   BroadcastChannel,
   DatabaseChannel,
+  FlareError,
+  FlareErrorCodes,
   LazyNotification,
   MailChannel,
   MemoryStore,

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { PlanetCore, GravitoOrbit } from '@gravito/core';
+import { InfrastructureException, InfrastructureExceptionOptions, PlanetCore, GravitoOrbit } from '@gravito/core';
 
 /**
  * Notification system type definitions.
@@ -404,6 +404,59 @@ declare class BroadcastChannel implements NotificationChannel {
     send(notification: Notification, notifiable: Notifiable, options?: AbortableSendOptions): Promise<void>;
 }
 
+/**
+ * @fileoverview Flare error codes
+ *
+ * Namespaced error codes for the Flare notification module.
+ *
+ * @module @gravito/flare/errors
+ */
+/**
+ * Error codes for Flare module operations.
+ * Follows dot-separated namespace convention.
+ */
+declare const FlareErrorCodes: {
+    readonly RATE_LIMIT_EXCEEDED: "flare.rate_limit_exceeded";
+    readonly SERIALIZATION_FAILED: "flare.serialization_failed";
+    readonly TEMPLATE_NOT_DEFINED: "flare.template_not_defined";
+    readonly NOTIFIABLE_MISSING_EMAIL: "flare.notifiable_missing_email";
+    readonly INVALID_CONFIG: "flare.invalid_config";
+    readonly NOTIFICATION_METHOD_NOT_IMPLEMENTED: "flare.notification_method_not_implemented";
+    readonly UNSUPPORTED_PROVIDER: "flare.unsupported_provider";
+    readonly CREDENTIALS_MISSING: "flare.credentials_missing";
+    readonly SEND_FAILED: "flare.send_failed";
+};
+type FlareErrorCode = (typeof FlareErrorCodes)[keyof typeof FlareErrorCodes];
+
+/**
+ * @fileoverview Flare error types
+ *
+ * @module @gravito/flare/errors
+ */
+
+/**
+ * Base error class for Flare module.
+ *
+ * Provides structured error handling with error codes and messages.
+ * Extends InfrastructureException for unified error handling across Gravito.
+ *
+ * @example
+ * ```typescript
+ * throw new FlareError('flare.send_failed', 'Failed to send notification')
+ * ```
+ * @public
+ */
+declare class FlareError extends InfrastructureException {
+    /**
+     * Creates a new FlareError instance.
+     *
+     * @param code - The error code.
+     * @param message - The error message.
+     * @param options - Optional infrastructure exception options.
+     */
+    constructor(code: FlareErrorCode, message: string, options?: InfrastructureExceptionOptions);
+}
+
 /**
  * Database channel 配置選項。
  */
@@ -1882,4 +1935,4 @@ declare class TokenBucket {
     private refill;
 }
 
-export { AbortError, type BatchResult, BroadcastChannel, type BroadcastNotification, type CacheStore, type ChannelFailurePayload, type ChannelHookPayload, type ChannelMiddleware, type ChannelRateLimitConfig, type ChannelSuccessPayload, DatabaseChannel, type DatabaseNotification, type FlareHookEvent, type FlareHookPayloads, type FlareHooks, type HookEmitter, LazyNotification, MailChannel, type MailChannelConfig, type MailMessage, type MailTemplate, MemoryStore, type MetricsSummary, MiddlewarePriority, type MiddlewarePriorityValue, type Notifiable, Notification, type NotificationBatchCompletePayload, type NotificationBatchStartPayload, type NotificationChannel, type NotificationCompletePayload, type NotificationHookPayload, NotificationManager, type NotificationMetric, NotificationMetricsCollector, type NotificationPreference, type NotificationResult, OrbitFlare, type OrbitFlareOptions, PreferenceMiddleware, type RateLimitConfig, RateLimitMiddleware, type RetryConfig, type SendOptions, type SendResult, type SerializationCheckResult, type ShouldQueue, type ShouldRetry, SlackChannel, type SlackChannelConfig, type SlackMessage, type SlackTemplate, SmsChannel, type SmsChannelConfig, type SmsMessage, type TemplateData, TemplatedNotification, TimeoutChannel, type TimeoutConfig, TimeoutError, TokenBucket, assertSerializable, checkSerializable, createHookEmitter, deepDeserialize, deepSerialize, toPrometheusFormat };
+export { AbortError, type BatchResult, BroadcastChannel, type BroadcastNotification, type CacheStore, type ChannelFailurePayload, type ChannelHookPayload, type ChannelMiddleware, type ChannelRateLimitConfig, type ChannelSuccessPayload, DatabaseChannel, type DatabaseNotification, FlareError, type FlareErrorCode, FlareErrorCodes, type FlareHookEvent, type FlareHookPayloads, type FlareHooks, type HookEmitter, LazyNotification, MailChannel, type MailChannelConfig, type MailMessage, type MailTemplate, MemoryStore, type MetricsSummary, MiddlewarePriority, type MiddlewarePriorityValue, type Notifiable, Notification, type NotificationBatchCompletePayload, type NotificationBatchStartPayload, type NotificationChannel, type NotificationCompletePayload, type NotificationHookPayload, NotificationManager, type NotificationMetric, NotificationMetricsCollector, type NotificationPreference, type NotificationResult, OrbitFlare, type OrbitFlareOptions, PreferenceMiddleware, type RateLimitConfig, RateLimitMiddleware, type RetryConfig, type SendOptions, type SendResult, type SerializationCheckResult, type ShouldQueue, type ShouldRetry, SlackChannel, type SlackChannelConfig, type SlackMessage, type SlackTemplate, SmsChannel, type SmsChannelConfig, type SmsMessage, type TemplateData, TemplatedNotification, TimeoutChannel, type TimeoutConfig, TimeoutError, TokenBucket, assertSerializable, checkSerializable, createHookEmitter, deepDeserialize, deepSerialize, toPrometheusFormat };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PlanetCore, GravitoOrbit } from '@gravito/core';
+import { InfrastructureException, InfrastructureExceptionOptions, PlanetCore, GravitoOrbit } from '@gravito/core';
 
 /**
  * Notification system type definitions.
@@ -404,6 +404,59 @@ declare class BroadcastChannel implements NotificationChannel {
     send(notification: Notification, notifiable: Notifiable, options?: AbortableSendOptions): Promise<void>;
 }
 
+/**
+ * @fileoverview Flare error codes
+ *
+ * Namespaced error codes for the Flare notification module.
+ *
+ * @module @gravito/flare/errors
+ */
+/**
+ * Error codes for Flare module operations.
+ * Follows dot-separated namespace convention.
+ */
+declare const FlareErrorCodes: {
+    readonly RATE_LIMIT_EXCEEDED: "flare.rate_limit_exceeded";
+    readonly SERIALIZATION_FAILED: "flare.serialization_failed";
+    readonly TEMPLATE_NOT_DEFINED: "flare.template_not_defined";
+    readonly NOTIFIABLE_MISSING_EMAIL: "flare.notifiable_missing_email";
+    readonly INVALID_CONFIG: "flare.invalid_config";
+    readonly NOTIFICATION_METHOD_NOT_IMPLEMENTED: "flare.notification_method_not_implemented";
+    readonly UNSUPPORTED_PROVIDER: "flare.unsupported_provider";
+    readonly CREDENTIALS_MISSING: "flare.credentials_missing";
+    readonly SEND_FAILED: "flare.send_failed";
+};
+type FlareErrorCode = (typeof FlareErrorCodes)[keyof typeof FlareErrorCodes];
+
+/**
+ * @fileoverview Flare error types
+ *
+ * @module @gravito/flare/errors
+ */
+
+/**
+ * Base error class for Flare module.
+ *
+ * Provides structured error handling with error codes and messages.
+ * Extends InfrastructureException for unified error handling across Gravito.
+ *
+ * @example
+ * ```typescript
+ * throw new FlareError('flare.send_failed', 'Failed to send notification')
+ * ```
+ * @public
+ */
+declare class FlareError extends InfrastructureException {
+    /**
+     * Creates a new FlareError instance.
+     *
+     * @param code - The error code.
+     * @param message - The error message.
+     * @param options - Optional infrastructure exception options.
+     */
+    constructor(code: FlareErrorCode, message: string, options?: InfrastructureExceptionOptions);
+}
+
 /**
  * Database channel 配置選項。
  */
@@ -1882,4 +1935,4 @@ declare class TokenBucket {
     private refill;
 }
 
-export { AbortError, type BatchResult, BroadcastChannel, type BroadcastNotification, type CacheStore, type ChannelFailurePayload, type ChannelHookPayload, type ChannelMiddleware, type ChannelRateLimitConfig, type ChannelSuccessPayload, DatabaseChannel, type DatabaseNotification, type FlareHookEvent, type FlareHookPayloads, type FlareHooks, type HookEmitter, LazyNotification, MailChannel, type MailChannelConfig, type MailMessage, type MailTemplate, MemoryStore, type MetricsSummary, MiddlewarePriority, type MiddlewarePriorityValue, type Notifiable, Notification, type NotificationBatchCompletePayload, type NotificationBatchStartPayload, type NotificationChannel, type NotificationCompletePayload, type NotificationHookPayload, NotificationManager, type NotificationMetric, NotificationMetricsCollector, type NotificationPreference, type NotificationResult, OrbitFlare, type OrbitFlareOptions, PreferenceMiddleware, type RateLimitConfig, RateLimitMiddleware, type RetryConfig, type SendOptions, type SendResult, type SerializationCheckResult, type ShouldQueue, type ShouldRetry, SlackChannel, type SlackChannelConfig, type SlackMessage, type SlackTemplate, SmsChannel, type SmsChannelConfig, type SmsMessage, type TemplateData, TemplatedNotification, TimeoutChannel, type TimeoutConfig, TimeoutError, TokenBucket, assertSerializable, checkSerializable, createHookEmitter, deepDeserialize, deepSerialize, toPrometheusFormat };
+export { AbortError, type BatchResult, BroadcastChannel, type BroadcastNotification, type CacheStore, type ChannelFailurePayload, type ChannelHookPayload, type ChannelMiddleware, type ChannelRateLimitConfig, type ChannelSuccessPayload, DatabaseChannel, type DatabaseNotification, FlareError, type FlareErrorCode, FlareErrorCodes, type FlareHookEvent, type FlareHookPayloads, type FlareHooks, type HookEmitter, LazyNotification, MailChannel, type MailChannelConfig, type MailMessage, type MailTemplate, MemoryStore, type MetricsSummary, MiddlewarePriority, type MiddlewarePriorityValue, type Notifiable, Notification, type NotificationBatchCompletePayload, type NotificationBatchStartPayload, type NotificationChannel, type NotificationCompletePayload, type NotificationHookPayload, NotificationManager, type NotificationMetric, NotificationMetricsCollector, type NotificationPreference, type NotificationResult, OrbitFlare, type OrbitFlareOptions, PreferenceMiddleware, type RateLimitConfig, RateLimitMiddleware, type RetryConfig, type SendOptions, type SendResult, type SerializationCheckResult, type ShouldQueue, type ShouldRetry, SlackChannel, type SlackChannelConfig, type SlackMessage, type SlackTemplate, SmsChannel, type SmsChannelConfig, type SmsMessage, type TemplateData, TemplatedNotification, TimeoutChannel, type TimeoutConfig, TimeoutError, TokenBucket, assertSerializable, checkSerializable, createHookEmitter, deepDeserialize, deepSerialize, toPrometheusFormat };

package/dist/index.js

@@ -183,6 +183,37 @@ var init_PreferenceMiddleware = __esm({
   }
 });
 
+// src/errors/FlareError.ts
+import { InfrastructureException } from "@gravito/core";
+var FlareError = class extends InfrastructureException {
+  /**
+   * Creates a new FlareError instance.
+   *
+   * @param code - The error code.
+   * @param message - The error message.
+   * @param options - Optional infrastructure exception options.
+   */
+  constructor(code, message, options = {}) {
+    const status = options.retryable ? 503 : 500;
+    super(status, code, { message, ...options });
+    this.name = "FlareError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/errors/codes.ts
+var FlareErrorCodes = {
+  RATE_LIMIT_EXCEEDED: "flare.rate_limit_exceeded",
+  SERIALIZATION_FAILED: "flare.serialization_failed",
+  TEMPLATE_NOT_DEFINED: "flare.template_not_defined",
+  NOTIFIABLE_MISSING_EMAIL: "flare.notifiable_missing_email",
+  INVALID_CONFIG: "flare.invalid_config",
+  NOTIFICATION_METHOD_NOT_IMPLEMENTED: "flare.notification_method_not_implemented",
+  UNSUPPORTED_PROVIDER: "flare.unsupported_provider",
+  CREDENTIALS_MISSING: "flare.credentials_missing",
+  SEND_FAILED: "flare.send_failed"
+};
+
 // src/channels/TimeoutChannel.ts
 var TimeoutError = class extends Error {
   constructor(message) {
@@ -280,7 +311,10 @@ var BroadcastChannel = class {
     const innerChannel = {
       send: async (notification, notifiable, _options) => {
         if (!notification.toBroadcast) {
-          throw new Error("Notification does not implement toBroadcast method");
+          throw new FlareError(
+            FlareErrorCodes.NOTIFICATION_METHOD_NOT_IMPLEMENTED,
+            "Notification does not implement toBroadcast method"
+          );
         }
         const broadcastNotification = notification.toBroadcast(notifiable);
         const notifiableId = notifiable.getNotifiableId();
@@ -314,7 +348,10 @@ var DatabaseChannel = class {
     const innerChannel = {
       send: async (notification, notifiable, _options) => {
         if (!notification.toDatabase) {
-          throw new Error("Notification does not implement toDatabase method");
+          throw new FlareError(
+            FlareErrorCodes.NOTIFICATION_METHOD_NOT_IMPLEMENTED,
+            "Notification does not implement toDatabase method"
+          );
         }
         const dbNotification = notification.toDatabase(notifiable);
         await this.dbService.insertNotification({
@@ -346,7 +383,10 @@ var MailChannel = class {
     const innerChannel = {
       send: async (notification, notifiable, _options) => {
         if (!notification.toMail) {
-          throw new Error("Notification does not implement toMail method");
+          throw new FlareError(
+            FlareErrorCodes.NOTIFICATION_METHOD_NOT_IMPLEMENTED,
+            "Notification does not implement toMail method"
+          );
         }
         const message = notification.toMail(notifiable);
         await this.mailService.send(message);
@@ -372,7 +412,10 @@ var SlackChannel = class {
     const innerChannel = {
       send: async (notification, notifiable, options) => {
         if (!notification.toSlack) {
-          throw new Error("Notification does not implement toSlack method");
+          throw new FlareError(
+            FlareErrorCodes.NOTIFICATION_METHOD_NOT_IMPLEMENTED,
+            "Notification does not implement toSlack method"
+          );
         }
         const slackMessage = notification.toSlack(notifiable);
         const response = await fetch(this.config.webhookUrl, {
@@ -391,7 +434,10 @@ var SlackChannel = class {
           // Pass AbortSignal to fetch
         });
         if (!response.ok) {
-          throw new Error(`Failed to send Slack notification: ${response.statusText}`);
+          throw new FlareError(
+            FlareErrorCodes.SEND_FAILED,
+            `Failed to send Slack notification: ${response.statusText}`
+          );
         }
       }
     };
@@ -415,7 +461,10 @@ var SmsChannel = class {
     const innerChannel = {
       send: async (notification, notifiable, options) => {
         if (!notification.toSms) {
-          throw new Error("Notification does not implement toSms method");
+          throw new FlareError(
+            FlareErrorCodes.NOTIFICATION_METHOD_NOT_IMPLEMENTED,
+            "Notification does not implement toSms method"
+          );
         }
         const smsMessage = notification.toSms(notifiable);
         switch (this.config.provider) {
@@ -426,7 +475,10 @@ var SmsChannel = class {
             await this.sendViaAwsSns(smsMessage, options?.signal);
             break;
           default:
-            throw new Error(`Unsupported SMS provider: ${this.config.provider}`);
+            throw new FlareError(
+              FlareErrorCodes.UNSUPPORTED_PROVIDER,
+              `Unsupported SMS provider: ${this.config.provider}`
+            );
         }
       }
     };
@@ -445,7 +497,10 @@ var SmsChannel = class {
    */
   async sendViaTwilio(message, signal) {
     if (!this.config.apiKey || !this.config.apiSecret) {
-      throw new Error("Twilio API key and secret are required");
+      throw new FlareError(
+        FlareErrorCodes.CREDENTIALS_MISSING,
+        "Twilio API key and secret are required"
+      );
     }
     const accountSid = this.config.apiKey;
     const authToken = this.config.apiSecret;
@@ -468,7 +523,7 @@ var SmsChannel = class {
     );
     if (!response.ok) {
       const error = await response.text();
-      throw new Error(`Failed to send SMS via Twilio: ${error}`);
+      throw new FlareError(FlareErrorCodes.SEND_FAILED, `Failed to send SMS via Twilio: ${error}`);
     }
   }
   /**
@@ -482,7 +537,8 @@ var SmsChannel = class {
       SNSClient = awsSns.SNSClient;
       PublishCommand = awsSns.PublishCommand;
     } catch {
-      throw new Error(
+      throw new FlareError(
+        FlareErrorCodes.UNSUPPORTED_PROVIDER,
         "AWS SNS SMS requires @aws-sdk/client-sns. Install it with: bun add @aws-sdk/client-sns"
       );
     }
@@ -513,7 +569,10 @@ var SmsChannel = class {
       await client.send(command, { abortSignal: signal });
     } catch (error) {
       const err = error instanceof Error ? error : new Error(String(error));
-      throw new Error(`Failed to send SMS via AWS SNS: ${err.message}`);
+      throw new FlareError(
+        FlareErrorCodes.SEND_FAILED,
+        `Failed to send SMS via AWS SNS: ${err.message}`
+      );
     }
   }
 };
@@ -865,7 +924,8 @@ var RateLimitMiddleware = class {
       if (bucket) {
         const allowed = bucket.tryConsume();
         if (!allowed) {
-          throw new Error(
+          throw new FlareError(
+            FlareErrorCodes.RATE_LIMIT_EXCEEDED,
             `Rate limit exceeded for channel '${channel}' (${window}ly limit). Please try again later.`
           );
         }
@@ -1168,7 +1228,8 @@ function checkSerializable(obj, path = "") {
 function assertSerializable(obj) {
   const result = checkSerializable(obj);
   if (!result.serializable) {
-    throw new Error(
+    throw new FlareError(
+      FlareErrorCodes.SERIALIZATION_FAILED,
       `\u7269\u4EF6\u5305\u542B\u4E0D\u53EF\u5E8F\u5217\u5316\u7684\u5C6C\u6027:
 \u554F\u984C\u8DEF\u5F91: ${result.problematicPaths.join(", ")}
 \u8A73\u7D30\u8CC7\u8A0A:
@@ -1687,24 +1748,30 @@ var OrbitFlare = class _OrbitFlare {
     if (options.enableSlack) {
       const slack = options.channels?.slack;
       if (!slack?.webhookUrl) {
-        throw new Error(
+        throw new FlareError(
+          FlareErrorCodes.INVALID_CONFIG,
           "[OrbitFlare] Slack channel enabled but webhookUrl not provided. Configure channels.slack.webhookUrl or set enableSlack to false."
         );
       }
       if (!this.isValidUrl(slack.webhookUrl)) {
-        throw new Error(`[OrbitFlare] Invalid Slack webhook URL: ${slack.webhookUrl}`);
+        throw new FlareError(
+          FlareErrorCodes.INVALID_CONFIG,
+          `[OrbitFlare] Invalid Slack webhook URL: ${slack.webhookUrl}`
+        );
       }
     }
     if (options.enableSms) {
       const sms = options.channels?.sms;
       if (!sms?.provider) {
-        throw new Error(
+        throw new FlareError(
+          FlareErrorCodes.INVALID_CONFIG,
           "[OrbitFlare] SMS channel enabled but provider not specified. Configure channels.sms.provider or set enableSms to false."
         );
       }
       const supportedProviders = ["twilio", "aws-sns"];
       if (!supportedProviders.includes(sms.provider)) {
-        throw new Error(
+        throw new FlareError(
+          FlareErrorCodes.UNSUPPORTED_PROVIDER,
           `[OrbitFlare] Unsupported SMS provider: ${sms.provider}. Supported providers: ${supportedProviders.join(", ")}`
         );
       }
@@ -1847,7 +1914,7 @@ var TemplatedNotification = class extends Notification {
   // Auto-implement toSlack
   toSlack(_notifiable) {
     if (!this.slackTemplate) {
-      throw new Error("slackTemplate not defined");
+      throw new FlareError(FlareErrorCodes.TEMPLATE_NOT_DEFINED, "slackTemplate not defined");
     }
     const template = this.slackTemplate();
     return {
@@ -1890,7 +1957,10 @@ var TemplatedNotification = class extends Notification {
     if ("email" in notifiable && typeof notifiable.email === "string") {
       return notifiable.email;
     }
-    throw new Error("Notifiable does not have an email property");
+    throw new FlareError(
+      FlareErrorCodes.NOTIFIABLE_MISSING_EMAIL,
+      "Notifiable does not have an email property"
+    );
   }
 };
 var DANGEROUS_TAGS = /^<\/?(?:script|iframe|object|embed|form|input|textarea|button|select|style|link|meta|base)\b[^>]*>$/i;
@@ -1961,6 +2031,8 @@ export {
   AbortError,
   BroadcastChannel,
   DatabaseChannel,
+  FlareError,
+  FlareErrorCodes,
   LazyNotification,
   MailChannel,
   MemoryStore,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gravito/flare",
   "sideEffects": false,
-  "version": "4.0.2",
+  "version": "5.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -48,9 +48,9 @@
     "@aws-sdk/client-sns": "^3.734.0"
   },
   "peerDependencies": {
-    "@gravito/stream": "^2.1.0",
-    "@gravito/signal": "^3.1.0",
-    "@gravito/radiance": "^1.0.4"
+    "@gravito/stream": "^3.0.0",
+    "@gravito/signal": "^4.0.0",
+    "@gravito/radiance": "^2.0.0"
   },
   "devDependencies": {
     "bun-types": "latest",