@gurulu/web 1.0.1 → 1.1.0

package/dist/replay.d.ts

@@ -0,0 +1,97 @@
+export type ReplayCaptureMode = 'always_on' | 'sampled' | 'triggered';
+export interface ReplaySettings {
+    capture_mode: ReplayCaptureMode;
+    /** 0..1 — only used when capture_mode = 'sampled'. */
+    sample_rate: number;
+    capture_console: boolean;
+    capture_network: boolean;
+    capture_custom_events: boolean;
+    /** rrweb `maskAllInputs`. */
+    privacy_mask_inputs: boolean;
+    /** Banner_required → require explicit `consent.replay === true`. */
+    consent_required: boolean;
+}
+export interface ReplayConsentState {
+    /** Explicit replay opt-in. Falsy → if `consent_required` is true, no capture. */
+    replay?: boolean;
+}
+export interface ReplayConfig {
+    workspaceId: string;
+    apiKey: string;
+    /** Default: 'https://ingest.gurulu.io'. */
+    ingestBaseUrl: string;
+    anonymousId: string;
+    sessionId: string;
+    /** Optional initial consent snapshot. */
+    consent?: ReplayConsentState;
+    /** SDK version for chunk metadata. */
+    sdkVersion?: string;
+    /** Default settings override — Agent A backend fetch wires real endpoint here. */
+    settingsOverride?: ReplaySettings;
+    /** Test seam — settings fetcher (default reads sessionStorage cache + hard-coded defaults). */
+    fetchSettings?: () => Promise<ReplaySettings>;
+    /** Test seam — transport. */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * GuruluReplay — orchestrates rrweb capture + chunk flush. One instance per
+ * Gurulu SDK lifecycle; `stop()` on `reset()/logout()`.
+ */
+export declare class GuruluReplay {
+    private config;
+    private stopFn;
+    private buffer;
+    private chunkSeq;
+    private flushTimer;
+    private settings;
+    private rrweb;
+    private sessionStartedAt;
+    private lastChunkEndOffset;
+    private hasConsoleError;
+    private hasConversion;
+    private networkOriginals;
+    private consoleOriginals;
+    private windowErrorHandler;
+    private started;
+    private debug;
+    constructor(config: ReplayConfig, opts?: {
+        debug?: boolean;
+    });
+    /** Begin capture — async (rrweb dynamic import + settings fetch). Idempotent. */
+    start(): Promise<void>;
+    /** Annotate a tracked event into the replay stream. */
+    annotateCustomEvent(eventName: string, properties: Record<string, unknown>): void;
+    /** Mark conversion — next chunk carries `has_conversion: true`. */
+    markConversion(): void;
+    /** Mark error — next chunk carries `has_console_error: true`. */
+    markError(): void;
+    /** Stop capture + final flush. */
+    stop(): void;
+    private shouldCapture;
+    private resolveSettings;
+    private cachedDefaults;
+    private loadRrweb;
+    private attachConsoleCapture;
+    private detachConsoleCapture;
+    private attachNetworkCapture;
+    private detachNetworkCapture;
+    private flush;
+    private warn;
+}
+declare function safeStringify(v: unknown): string;
+/**
+ * gzip string → Uint8Array via CompressionStream API. Modern browsers only
+ * (Chrome 80+/Firefox 113+/Safari 16.4+). Legacy fallback out of scope.
+ */
+declare function gzipString(input: string): Promise<Uint8Array>;
+declare function base64FromBytes(bytes: Uint8Array): string;
+export declare const __test__: {
+    DEFAULT_SETTINGS: ReplaySettings;
+    REPLAY_SETTINGS_CACHE_KEY: string;
+    REPLAY_SETTINGS_TTL_MS: number;
+    gzipString: typeof gzipString;
+    base64FromBytes: typeof base64FromBytes;
+    safeStringify: typeof safeStringify;
+};
+export {};
+//# sourceMappingURL=replay.d.ts.map

package/dist/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gurulu/web",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "private": false,
   "license": "MIT",
   "publishConfig": {
@@ -28,12 +28,17 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "default": "./dist/react.js"
+    },
     "./t.js": "./dist/t.js",
     "./package.json": "./package.json"
   },
   "scripts": {
     "build": "rm -rf dist && bun run build:esm && bun run build:cdn && bun run build:types",
-    "build:esm": "bun build ./src/index.ts --outdir ./dist --target browser --format=esm",
+    "build:esm": "bun build ./src/index.ts ./src/react.ts --outdir ./dist --target browser --format=esm --external react",
     "build:cdn": "bun build ./src/index.ts --outdir ./dist --entry-naming t.js --target browser --minify --sourcemap=external",
     "build:types": "tsc -p tsconfig.build.json",
     "build:dev": "bun build ./src/index.ts --outdir ./dist --target browser",
@@ -43,7 +48,17 @@
     "clean": "rm -rf dist .turbo"
   },
   "dependencies": {},
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
     "typescript": "^5.6.0"
   }
 }