@alertsamurai/sdk-js 0.0.2 → 0.0.5

package/README.md

@@ -171,7 +171,7 @@ import type {
   SendAlertOptions,
   SendAlertResponse,
   AlertPriority,
-} from "@alertsamurai/sdk";
+} from "@alertsamurai/sdk-js";
 
 const options: SendMetricOptions = {
   metricType: "api_latency",

package/dist/index.d.mts

@@ -10,6 +10,12 @@ interface AlertSamuraiConfig {
     timeout?: number;
     /** Number of retries on network failure (optional) - defaults to 3 */
     retries?: number;
+    /**
+     * Silent mode (optional) - defaults to true
+     * When true, errors are swallowed silently
+     * When false, warnings/errors are logged to console
+     */
+    silent?: boolean;
 }
 /**
  * Options for sending a metric
@@ -32,12 +38,16 @@ interface SendMetricOptions {
  * Response from sending a metric
  */
 interface SendMetricResponse {
-    /** ID of the created metric record */
-    id: string;
+    /** ID of the created metric record (present on success) */
+    id?: string;
     /** Whether the metric was successfully processed */
     success: boolean;
     /** Whether any threshold-based alerts were triggered */
     alertTriggered?: boolean;
+    /** True if client is disabled (no DSN configured) */
+    disabled?: boolean;
+    /** Error message if the request failed */
+    error?: string;
 }
 /**
  * Alert priority levels
@@ -60,15 +70,23 @@ interface SendAlertOptions {
  * Response from sending an alert
  */
 interface SendAlertResponse {
-    /** ID of the created alert record */
-    id: string;
+    /** ID of the created alert record (present on success) */
+    id?: string;
     /** Whether the alert was successfully processed */
     success: boolean;
+    /** True if client is disabled (no DSN configured) */
+    disabled?: boolean;
+    /** Error message if the request failed */
+    error?: string;
 }
 
 /**
  * AlertSamurai SDK client for sending metrics and alerts
  *
+ * The client is designed to be fault-tolerant and will never throw errors
+ * that could crash your application. If misconfigured, it operates in
+ * "disabled" mode and silently returns empty responses.
+ *
  * @example
  * ```typescript
  * const client = new AlertSamuraiClient({
@@ -91,7 +109,13 @@ declare class AlertSamuraiClient {
     private baseUrl;
     private timeout;
     private retries;
-    constructor(config: AlertSamuraiConfig);
+    private enabled;
+    private silent;
+    constructor(config?: AlertSamuraiConfig | null);
+    /**
+     * Check if the client is enabled and configured properly
+     */
+    isEnabled(): boolean;
     /**
      * Send a custom metric for tracking and threshold-based alerting
      *

package/dist/index.d.ts

@@ -10,6 +10,12 @@ interface AlertSamuraiConfig {
     timeout?: number;
     /** Number of retries on network failure (optional) - defaults to 3 */
     retries?: number;
+    /**
+     * Silent mode (optional) - defaults to true
+     * When true, errors are swallowed silently
+     * When false, warnings/errors are logged to console
+     */
+    silent?: boolean;
 }
 /**
  * Options for sending a metric
@@ -32,12 +38,16 @@ interface SendMetricOptions {
  * Response from sending a metric
  */
 interface SendMetricResponse {
-    /** ID of the created metric record */
-    id: string;
+    /** ID of the created metric record (present on success) */
+    id?: string;
     /** Whether the metric was successfully processed */
     success: boolean;
     /** Whether any threshold-based alerts were triggered */
     alertTriggered?: boolean;
+    /** True if client is disabled (no DSN configured) */
+    disabled?: boolean;
+    /** Error message if the request failed */
+    error?: string;
 }
 /**
  * Alert priority levels
@@ -60,15 +70,23 @@ interface SendAlertOptions {
  * Response from sending an alert
  */
 interface SendAlertResponse {
-    /** ID of the created alert record */
-    id: string;
+    /** ID of the created alert record (present on success) */
+    id?: string;
     /** Whether the alert was successfully processed */
     success: boolean;
+    /** True if client is disabled (no DSN configured) */
+    disabled?: boolean;
+    /** Error message if the request failed */
+    error?: string;
 }
 
 /**
  * AlertSamurai SDK client for sending metrics and alerts
  *
+ * The client is designed to be fault-tolerant and will never throw errors
+ * that could crash your application. If misconfigured, it operates in
+ * "disabled" mode and silently returns empty responses.
+ *
  * @example
  * ```typescript
  * const client = new AlertSamuraiClient({
@@ -91,7 +109,13 @@ declare class AlertSamuraiClient {
     private baseUrl;
     private timeout;
     private retries;
-    constructor(config: AlertSamuraiConfig);
+    private enabled;
+    private silent;
+    constructor(config?: AlertSamuraiConfig | null);
+    /**
+     * Check if the client is enabled and configured properly
+     */
+    isEnabled(): boolean;
     /**
      * Send a custom metric for tracking and threshold-based alerting
      *

package/dist/index.js

@@ -83,18 +83,37 @@ function sleep(ms) {
 }
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api.alertsamurai.com";
+var DEFAULT_BASE_URL = "https://monitor.alertsamurai.com";
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_RETRIES = 3;
 var AlertSamuraiClient = class {
   constructor(config) {
-    if (!config.dsn) {
-      throw new ValidationError("DSN is required");
+    if (!config || !config.dsn) {
+      this.enabled = false;
+      this.dsn = "";
+      this.baseUrl = DEFAULT_BASE_URL;
+      this.timeout = DEFAULT_TIMEOUT;
+      this.retries = DEFAULT_RETRIES;
+      this.silent = config?.silent ?? true;
+      if (!this.silent) {
+        console.warn(
+          "[AlertSamurai] Client disabled: DSN is required. Calls will be no-ops."
+        );
+      }
+      return;
     }
+    this.enabled = true;
     this.dsn = config.dsn;
     this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.timeout = config.timeout || DEFAULT_TIMEOUT;
     this.retries = config.retries ?? DEFAULT_RETRIES;
+    this.silent = config.silent ?? true;
+  }
+  /**
+   * Check if the client is enabled and configured properly
+   */
+  isEnabled() {
+    return this.enabled;
   }
   /**
    * Send a custom metric for tracking and threshold-based alerting
@@ -114,16 +133,29 @@ var AlertSamuraiClient = class {
    * ```
    */
   async sendMetric(options) {
-    this.validateMetric(options);
-    const body = {
-      metricType: options.metricType,
-      value: options.value,
-      unit: options.unit,
-      environment: options.environment,
-      metadata: options.metadata,
-      timestamp: this.normalizeTimestamp(options.timestamp)
-    };
-    return this.request("/api/metrics", body);
+    if (!this.enabled) {
+      return { success: false, disabled: true };
+    }
+    try {
+      this.validateMetric(options);
+      const body = {
+        metricType: options.metricType,
+        value: options.value,
+        unit: options.unit,
+        environment: options.environment,
+        metadata: options.metadata,
+        timestamp: this.normalizeTimestamp(options.timestamp)
+      };
+      return this.request("/api/metrics", body);
+    } catch (error) {
+      if (!this.silent) {
+        console.error("[AlertSamurai] sendMetric failed:", error);
+      }
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
   }
   /**
    * Send an application alert with priority level
@@ -142,8 +174,21 @@ var AlertSamuraiClient = class {
    * ```
    */
   async sendAlert(options) {
-    this.validateAlert(options);
-    return this.request("/api/alerts", options);
+    if (!this.enabled) {
+      return { success: false, disabled: true };
+    }
+    try {
+      this.validateAlert(options);
+      return this.request("/api/alerts", options);
+    } catch (error) {
+      if (!this.silent) {
+        console.error("[AlertSamurai] sendAlert failed:", error);
+      }
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
   }
   /**
    * Send a critical priority alert

package/dist/index.mjs

@@ -53,18 +53,37 @@ function sleep(ms) {
 }
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api.alertsamurai.com";
+var DEFAULT_BASE_URL = "https://monitor.alertsamurai.com";
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_RETRIES = 3;
 var AlertSamuraiClient = class {
   constructor(config) {
-    if (!config.dsn) {
-      throw new ValidationError("DSN is required");
+    if (!config || !config.dsn) {
+      this.enabled = false;
+      this.dsn = "";
+      this.baseUrl = DEFAULT_BASE_URL;
+      this.timeout = DEFAULT_TIMEOUT;
+      this.retries = DEFAULT_RETRIES;
+      this.silent = config?.silent ?? true;
+      if (!this.silent) {
+        console.warn(
+          "[AlertSamurai] Client disabled: DSN is required. Calls will be no-ops."
+        );
+      }
+      return;
     }
+    this.enabled = true;
     this.dsn = config.dsn;
     this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.timeout = config.timeout || DEFAULT_TIMEOUT;
     this.retries = config.retries ?? DEFAULT_RETRIES;
+    this.silent = config.silent ?? true;
+  }
+  /**
+   * Check if the client is enabled and configured properly
+   */
+  isEnabled() {
+    return this.enabled;
   }
   /**
    * Send a custom metric for tracking and threshold-based alerting
@@ -84,16 +103,29 @@ var AlertSamuraiClient = class {
    * ```
    */
   async sendMetric(options) {
-    this.validateMetric(options);
-    const body = {
-      metricType: options.metricType,
-      value: options.value,
-      unit: options.unit,
-      environment: options.environment,
-      metadata: options.metadata,
-      timestamp: this.normalizeTimestamp(options.timestamp)
-    };
-    return this.request("/api/metrics", body);
+    if (!this.enabled) {
+      return { success: false, disabled: true };
+    }
+    try {
+      this.validateMetric(options);
+      const body = {
+        metricType: options.metricType,
+        value: options.value,
+        unit: options.unit,
+        environment: options.environment,
+        metadata: options.metadata,
+        timestamp: this.normalizeTimestamp(options.timestamp)
+      };
+      return this.request("/api/metrics", body);
+    } catch (error) {
+      if (!this.silent) {
+        console.error("[AlertSamurai] sendMetric failed:", error);
+      }
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
   }
   /**
    * Send an application alert with priority level
@@ -112,8 +144,21 @@ var AlertSamuraiClient = class {
    * ```
    */
   async sendAlert(options) {
-    this.validateAlert(options);
-    return this.request("/api/alerts", options);
+    if (!this.enabled) {
+      return { success: false, disabled: true };
+    }
+    try {
+      this.validateAlert(options);
+      return this.request("/api/alerts", options);
+    } catch (error) {
+      if (!this.silent) {
+        console.error("[AlertSamurai] sendAlert failed:", error);
+      }
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
   }
   /**
    * Send a critical priority alert

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alertsamurai/sdk-js",
-  "version": "0.0.2",
+  "version": "0.0.5",
   "description": "TypeScript SDK for AlertSamurai metrics and alerting",
   "main": "dist/index.js",
   "module": "dist/index.mjs",