@gurulu/web 1.0.1 → 1.0.2

package/dist/crypto.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Async SHA-256 hex digest. Subtle yoksa hata fırlatır — caller
+ * (fingerprint.computeFingerprint) önce `window.crypto?.subtle` kontrolü yapar.
+ */
+export declare function sha256Hex(input: string): Promise<string>;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc9D"}

package/dist/fingerprint.d.ts

@@ -0,0 +1,31 @@
+export interface FingerprintComponents {
+    ua: string;
+    screen: string;
+    language: string;
+    /** Minutes. */
+    tz_offset: number;
+    canvas_hash: string;
+    audio_hash: string;
+}
+export interface DeviceHint {
+    ua_hash: string;
+    screen_hash?: string;
+    audio_hash?: string;
+    tz_offset?: number;
+    language?: string;
+}
+/**
+ * Compute device fingerprint hint. Returns `null` in non-browser env or when
+ * SubtleCrypto unavailable. localStorage cache hit on second call.
+ *
+ * Caller responsibility — guard with consent check (`categories.fingerprint`).
+ */
+export declare function computeFingerprint(): Promise<DeviceHint | null>;
+/**
+ * Sync cache read — `computeFingerprint()` warm path için. SDK init'te
+ * async `computeFingerprint()` cache'i populate eder; sonraki sync track
+ * çağrılarında bu helper sıfır maliyetle hint döndürür.
+ */
+export declare function readFingerprintCacheSync(): DeviceHint | null;
+export declare function clearFingerprintCache(): void;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;;;;GAKG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA0CrE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,UAAU,GAAG,IAAI,CAW5D;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C"}

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.0.2",
   "private": false,
   "license": "MIT",
   "publishConfig": {