alphana-sdk 1.6.6 → 1.8.0

package/dist/index.d.mts

@@ -4,6 +4,11 @@ interface TrackerConfig {
      * Defaults to `https://api.alphana.ir/api/events` (Alphana Cloud).
      */
     endpoint?: string;
+    /**
+     * Override unified ingest URL. When omitted, derived from `endpoint` as
+     * `…/api/collect`.
+     */
+    collectEndpoint?: string;
     /**
      * App ID obtained from the UserTracker dashboard.
      * Sent in every request body so the backend associates events with the correct app.
@@ -39,6 +44,16 @@ interface TrackerConfig {
      * Default: 5000 (5 s)
      */
     flushInterval?: number;
+    /**
+     * Gzip-compress large ingest payloads before upload when the browser supports
+     * `CompressionStream`. Default: true
+     */
+    compressPayloads?: boolean;
+    /**
+     * Minimum UTF-8 JSON size (bytes) before gzip compression is attempted.
+     * Default: 1024
+     */
+    compressionThresholdBytes?: number;
     /**
      * Automatically capture console.info/warn/error, window.onerror, and
      * unhandledrejection events and send them to the backend log endpoint.
@@ -357,15 +372,17 @@ interface LogEntry {
 }
 /**
  * Automatically captures console.info/warn/error output and unhandled errors,
- * then ships them to the backend `/logs/ingest` endpoint.
+ * then ships them to the unified `/api/collect` ingest endpoint.
  *
  * All console methods are restored exactly in `destroy()`.
  */
 declare class LogCapture {
-    private readonly endpoint;
+    private readonly collectUrl;
     private readonly sessionId;
     private readonly appId?;
     private readonly authHeaders;
+    private readonly compressPayloads;
+    private readonly compressionThresholdBytes;
     private origInfo;
     private origWarn;
     private origError;
@@ -374,9 +391,12 @@ declare class LogCapture {
     private initialized;
     constructor(options: {
         endpoint: string;
+        collectEndpoint?: string;
         sessionId: string;
         secretKey?: string;
         appId?: string;
+        compressPayloads?: boolean;
+        compressionThresholdBytes?: number;
     });
     init(): void;
     destroy(): void;
@@ -540,6 +560,8 @@ declare class UserTracker {
     getHeatmapData(path: string): HeatmapPoint[];
     /** Heatmap points for all tracked paths. */
     getHeatmapData(): Record<string, HeatmapPoint[]>;
+    private get collectUrl();
+    private currentPath;
     /**
      * Immediately drain the event queue and POST pending events to `/batch`.
      * Fire-and-forget; errors are intentionally swallowed like other analytics calls.
@@ -553,7 +575,6 @@ declare class UserTracker {
      * cancelled by the browser before it completes.
      */
     private flushBeacon;
-    private buildBatchBody;
     private sendBatch;
 }
 

package/dist/index.d.ts

@@ -4,6 +4,11 @@ interface TrackerConfig {
      * Defaults to `https://api.alphana.ir/api/events` (Alphana Cloud).
      */
     endpoint?: string;
+    /**
+     * Override unified ingest URL. When omitted, derived from `endpoint` as
+     * `…/api/collect`.
+     */
+    collectEndpoint?: string;
     /**
      * App ID obtained from the UserTracker dashboard.
      * Sent in every request body so the backend associates events with the correct app.
@@ -39,6 +44,16 @@ interface TrackerConfig {
      * Default: 5000 (5 s)
      */
     flushInterval?: number;
+    /**
+     * Gzip-compress large ingest payloads before upload when the browser supports
+     * `CompressionStream`. Default: true
+     */
+    compressPayloads?: boolean;
+    /**
+     * Minimum UTF-8 JSON size (bytes) before gzip compression is attempted.
+     * Default: 1024
+     */
+    compressionThresholdBytes?: number;
     /**
      * Automatically capture console.info/warn/error, window.onerror, and
      * unhandledrejection events and send them to the backend log endpoint.
@@ -357,15 +372,17 @@ interface LogEntry {
 }
 /**
  * Automatically captures console.info/warn/error output and unhandled errors,
- * then ships them to the backend `/logs/ingest` endpoint.
+ * then ships them to the unified `/api/collect` ingest endpoint.
  *
  * All console methods are restored exactly in `destroy()`.
  */
 declare class LogCapture {
-    private readonly endpoint;
+    private readonly collectUrl;
     private readonly sessionId;
     private readonly appId?;
     private readonly authHeaders;
+    private readonly compressPayloads;
+    private readonly compressionThresholdBytes;
     private origInfo;
     private origWarn;
     private origError;
@@ -374,9 +391,12 @@ declare class LogCapture {
     private initialized;
     constructor(options: {
         endpoint: string;
+        collectEndpoint?: string;
         sessionId: string;
         secretKey?: string;
         appId?: string;
+        compressPayloads?: boolean;
+        compressionThresholdBytes?: number;
     });
     init(): void;
     destroy(): void;
@@ -540,6 +560,8 @@ declare class UserTracker {
     getHeatmapData(path: string): HeatmapPoint[];
     /** Heatmap points for all tracked paths. */
     getHeatmapData(): Record<string, HeatmapPoint[]>;
+    private get collectUrl();
+    private currentPath;
     /**
      * Immediately drain the event queue and POST pending events to `/batch`.
      * Fire-and-forget; errors are intentionally swallowed like other analytics calls.
@@ -553,7 +575,6 @@ declare class UserTracker {
      * cancelled by the browser before it completes.
      */
     private flushBeacon;
-    private buildBatchBody;
     private sendBatch;
 }