@atsail/browser 0.1.0 → 0.2.0

package/dist/index.js

@@ -5,13 +5,15 @@ var DEFAULT_MAX_BATCH_SIZE = 20;
 
 class Transport {
   publishableKey;
+  environment;
   endpoint;
   flushIntervalMs;
   maxBatchSize;
   queue = [];
   timer = null;
-  constructor(publishableKey, endpoint = DEFAULT_ENDPOINT, flushIntervalMs = DEFAULT_FLUSH_INTERVAL_MS, maxBatchSize = DEFAULT_MAX_BATCH_SIZE) {
+  constructor(publishableKey, environment, endpoint = DEFAULT_ENDPOINT, flushIntervalMs = DEFAULT_FLUSH_INTERVAL_MS, maxBatchSize = DEFAULT_MAX_BATCH_SIZE) {
     this.publishableKey = publishableKey;
+    this.environment = environment;
     this.endpoint = endpoint;
     this.flushIntervalMs = flushIntervalMs;
     this.maxBatchSize = maxBatchSize;
@@ -32,7 +34,11 @@ class Transport {
       return;
     const events = this.queue;
     this.queue = [];
-    const body = JSON.stringify({ publishableKey: this.publishableKey, events });
+    const body = JSON.stringify({
+      publishableKey: this.publishableKey,
+      environment: this.environment,
+      events
+    });
     if (useBeacon && navigator.sendBeacon) {
       const blob = new Blob([body], { type: "application/json" });
       navigator.sendBeacon(this.endpoint, blob);
@@ -130,20 +136,33 @@ function installXhrInterceptor(emit) {
 
 // src/index.ts
 var transport = null;
+var LOCAL_LIKE_ENVIRONMENTS = /^(development|dev|local|test)$/i;
 function init(options) {
   if (transport)
     return;
   if (typeof window === "undefined")
     return;
-  transport = new Transport(options.publishableKey, options.endpoint, options.flushIntervalMs, options.maxBatchSize);
+  if (!options.environment) {
+    console.warn("[atsail] init() requires an `environment` option — SDK not started");
+    return;
+  }
+  const isLocalLike = LOCAL_LIKE_ENVIRONMENTS.test(options.environment.trim());
+  if (isLocalLike && !options.enabled) {
+    console.warn(`[atsail] staying quiet in environment "${options.environment}" — pass enabled: true to capture anyway`);
+    return;
+  }
+  transport = new Transport(options.publishableKey, options.environment, options.endpoint, options.flushIntervalMs, options.maxBatchSize);
+  transport.enqueue({ type: "init", timestamp: Date.now() });
   const emit = transport.enqueue.bind(transport);
   installGlobalHandlers(emit);
   installFetchInterceptor(emit);
   installXhrInterceptor(emit);
 }
 function captureException(error, context) {
-  if (!transport)
+  if (!transport) {
+    console.warn("[atsail] captureException called before init() — event dropped");
     return;
+  }
   transport.enqueue({
     type: "exception",
     message: error instanceof Error ? error.message : String(error),
@@ -153,8 +172,10 @@ function captureException(error, context) {
   });
 }
 function captureMessage(message, level = "info", context) {
-  if (!transport)
+  if (!transport) {
+    console.warn("[atsail] captureMessage called before init() — event dropped");
     return;
+  }
   transport.enqueue({
     type: "message",
     message,
@@ -164,7 +185,11 @@ function captureMessage(message, level = "info", context) {
   });
 }
 function flush() {
-  transport?.flush();
+  if (!transport) {
+    console.warn("[atsail] flush called before init() — nothing to send");
+    return;
+  }
+  transport.flush();
 }
 export {
   init,

package/dist/transport.d.ts

@@ -1,12 +1,13 @@
 import type { AtsailEvent } from "./types";
 export declare class Transport {
     private readonly publishableKey;
+    private readonly environment;
     private readonly endpoint;
     private readonly flushIntervalMs;
     private readonly maxBatchSize;
     private queue;
     private timer;
-    constructor(publishableKey: string, endpoint?: string, flushIntervalMs?: number, maxBatchSize?: number);
+    constructor(publishableKey: string, environment: string, endpoint?: string, flushIntervalMs?: number, maxBatchSize?: number);
     enqueue(event: AtsailEvent): void;
     flush(useBeacon?: boolean): void;
     destroy(): void;

package/dist/types.d.ts

@@ -1,5 +1,8 @@
 export type EventLevel = "info" | "warning" | "error";
 export type AtsailEvent = {
+    type: "init";
+    timestamp: number;
+} | {
     type: "exception";
     message: string;
     stack?: string;
@@ -30,6 +33,8 @@ export type AtsailEvent = {
 };
 export type InitOptions = {
     publishableKey: string;
+    environment: string;
+    enabled?: boolean;
     endpoint?: string;
     flushIntervalMs?: number;
     maxBatchSize?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atsail/browser",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "AtSail browser SDK",
   "type": "module",
   "main": "./dist/index.js",