@nexussdk/tracker 0.0.1 → 0.0.4

package/src/transport.ts

@@ -1,137 +0,0 @@
-/**
- * @fileoverview Hybrid transport dispatcher for error payload delivery.
- * Prefers fetch with keepalive; falls back to navigator.sendBeacon during page unload.
- * @module @nexus/sdk-tracker/transport
- */
-
-import type { ErrorEventPayload } from '@nexussdk/contracts';
-import { safeStringify, computeBackoffMs } from '@nexussdk/core';
-
-/**
- * Options for configuring the transport dispatcher.
- */
-export interface TransportOptions {
-  /** Go-Gin ingestion endpoint URL. */
-  endpoint: string;
-  /** Public API key for Authorization header. */
-  apiKey: string;
-  /** Maximum retry attempts on network failures. Defaults to 2. */
-  maxRetries?: number;
-}
-
-/**
- * Hybrid transport dispatcher that intelligently selects the delivery mechanism:
- * - **Normal execution**: `fetch(url, { keepalive: true })` with retry
- * - **Page teardown** (`visibilityState === 'hidden'` or `pagehide`): `navigator.sendBeacon`
- *
- * @example
- * const transport = new Transport({
- *   endpoint: 'http://localhost:8080/api/v1/telemetry/errors',
- *   apiKey: 'pk_live_...',
- * });
- * transport.send(errorPayload);
- */
-export class Transport {
-  private readonly options: TransportOptions;
-  private readonly maxRetries: number;
-  private isPageHiding = false;
-
-  constructor(options: TransportOptions) {
-    this.options = options;
-    this.maxRetries = options.maxRetries ?? 2;
-
-    // Detect page teardown events to switch to sendBeacon
-    if (typeof document !== 'undefined') {
-      document.addEventListener('visibilitychange', () => {
-        if (document.visibilityState === 'hidden') {
-          this.isPageHiding = true;
-        }
-      });
-    }
-    if (typeof window !== 'undefined') {
-      window.addEventListener('pagehide', () => {
-        this.isPageHiding = true;
-      });
-    }
-  }
-
-  /**
-   * Dispatches an error payload to the Go-Gin ingestion endpoint.
-   * Automatically selects fetch or sendBeacon based on page lifecycle state.
-   *
-   * @param payload - The sanitized {@link ErrorEventPayload} to transmit.
-   *
-   * @example
-   * transport.send({
-   *   fingerprint: 'fp_abc123',
-   *   errorType: 'TypeError',
-   *   errorMessage: "Cannot read property 'map' of undefined",
-   *   // ...
-   * });
-   */
-  send(payload: ErrorEventPayload): void {
-    const body = safeStringify(payload);
-
-    // Use sendBeacon during page teardown — prevents cancelled fetch requests
-    if (
-      this.isPageHiding &&
-      typeof navigator !== 'undefined' &&
-      typeof navigator.sendBeacon === 'function'
-    ) {
-      const blob = new Blob([body], { type: 'application/json' });
-      navigator.sendBeacon(this.options.endpoint, blob);
-      return;
-    }
-
-    // Normal execution: fetch with keepalive and exponential backoff retry
-    void this.sendWithRetry(body, 0);
-  }
-
-  /**
-   * Forces immediate flush of all pending events using sendBeacon.
-   * Called during manual flush or SDK destroy lifecycle.
-   *
-   * @param payload - The error payload to flush.
-   * @returns Promise that resolves when the beacon is dispatched.
-   */
-  async flush(payload: ErrorEventPayload): Promise<void> {
-    const body = safeStringify(payload);
-    if (typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {
-      const blob = new Blob([body], { type: 'application/json' });
-      navigator.sendBeacon(this.options.endpoint, blob);
-      return;
-    }
-    await this.sendWithRetry(body, 0);
-  }
-
-  private async sendWithRetry(body: string, attempt: number): Promise<void> {
-    try {
-      const response = await fetch(this.options.endpoint, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          Authorization: `Bearer ${this.options.apiKey}`,
-        },
-        body,
-        keepalive: true,
-      });
-
-      if (response.ok) return;
-
-      // Retry on 5xx
-      if (response.status >= 500 && attempt < this.maxRetries) {
-        const delay = computeBackoffMs(attempt, 1000, 30_000);
-        await new Promise((r) => setTimeout(r, delay));
-        await this.sendWithRetry(body, attempt + 1);
-      }
-    } catch {
-      // Network failure — retry with backoff
-      if (attempt < this.maxRetries) {
-        const delay = computeBackoffMs(attempt, 1000, 30_000);
-        await new Promise((r) => setTimeout(r, delay));
-        await this.sendWithRetry(body, attempt + 1);
-      }
-      // All retries exhausted — silently drop to prevent host app instability
-    }
-  }
-}

package/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src"
-  },
-  "include": ["src"]
-}

package/tsup.config.ts

@@ -1,19 +0,0 @@
-import { defineConfig } from 'tsup';
-
-export default defineConfig({
-  entry: ['src/index.ts'],
-  format: ['esm', 'cjs', 'iife'],
-  globalName: 'NexusTracker',
-  dts: true,
-  splitting: false,
-  sourcemap: true,
-  clean: true,
-  minify: true,
-  treeshake: true,
-  target: 'es2022',
-  outExtension({ format }) {
-    return {
-      js: format === 'esm' ? '.mjs' : format === 'cjs' ? '.cjs' : '.global.js',
-    };
-  },
-});