@thisbefine/analytics 0.1.0

package/dist/core/analytics.js

@@ -0,0 +1,334 @@
+import { ErrorCapture } from "./errors";
+import { createLogger } from "./logger";
+import { log as sendLog } from "./logging";
+import { Privacy } from "./privacy";
+import { Queue } from "./queue";
+import { Session } from "./session";
+import { Storage } from "./storage";
+import { DEFAULT_CONFIG, LIBRARY_INFO } from "./types";
+import { validateAccountId, validateEventName, validateProperties, validateUserId, } from "./validation";
+/**
+ * Main Analytics class - the primary entry point for the SDK
+ *
+ * Usage:
+ * ```typescript
+ * const analytics = createAnalytics({ apiKey: 'tbf_xxx' });
+ *
+ * analytics.track('button_clicked', { buttonId: 'signup' });
+ * analytics.identify('user_123', { email: 'user@example.com' });
+ * analytics.page('/dashboard');
+ * ```
+ */
+export class AnalyticsImpl {
+    constructor(config) {
+        this.errorCapture = null;
+        this.initialized = false;
+        this.config = this.resolveConfig(config);
+        this.logger = createLogger("Analytics", this.config.debug);
+        this.storage = new Storage(this.config.cookieDomain);
+        this.session = new Session(this.storage, this.config.sessionTimeout, this.config.debug);
+        this.privacy = new Privacy(this.storage, this.config.respectDNT, this.config.debug);
+        this.queue = new Queue(this.config);
+        if (this.config.errors?.enabled !== false) {
+            this.errorCapture = new ErrorCapture(this.config, this.session, this.config.errors);
+            this.errorCapture.install();
+        }
+        this.initialized = true;
+        this.logger.log("Analytics initialized", {
+            host: this.config.host,
+            debug: this.config.debug,
+            storageType: this.storage.getStorageType(),
+            errorCapture: this.errorCapture !== null,
+        });
+    }
+    /**
+     * Resolve configuration with defaults
+     */
+    resolveConfig(config) {
+        return {
+            apiKey: config.apiKey,
+            host: config.host ?? DEFAULT_CONFIG.host,
+            flushAt: config.flushAt ?? DEFAULT_CONFIG.flushAt,
+            flushInterval: config.flushInterval ?? DEFAULT_CONFIG.flushInterval,
+            sessionTimeout: config.sessionTimeout ?? DEFAULT_CONFIG.sessionTimeout,
+            cookieDomain: config.cookieDomain,
+            debug: config.debug ?? DEFAULT_CONFIG.debug,
+            respectDNT: config.respectDNT ?? DEFAULT_CONFIG.respectDNT,
+            maxRetries: config.maxRetries ?? DEFAULT_CONFIG.maxRetries,
+            errors: config.errors,
+        };
+    }
+    /**
+     * Track a custom event
+     */
+    track(event, properties) {
+        if (!this.shouldTrack())
+            return;
+        const eventValidation = validateEventName(event);
+        if (!eventValidation.valid) {
+            this.logger.warn("Invalid event:", eventValidation.error);
+            return;
+        }
+        const propsValidation = validateProperties(properties);
+        if (!propsValidation.valid) {
+            this.logger.warn("Invalid properties:", propsValidation.error);
+            return;
+        }
+        const trackEvent = {
+            type: "track",
+            event,
+            properties,
+            timestamp: new Date().toISOString(),
+            anonymousId: this.session.getAnonymousId(),
+            userId: this.session.getUserId(),
+            sessionId: this.session.getSessionId(),
+            accountId: this.session.getAccountId(),
+            context: this.getContext(),
+        };
+        this.queue.push(trackEvent);
+        this.session.updateLastActivity();
+    }
+    /**
+     * Identify a user with traits
+     */
+    identify(userId, traits) {
+        if (!this.shouldTrack())
+            return;
+        const userIdValidation = validateUserId(userId);
+        if (!userIdValidation.valid) {
+            this.logger.warn("Invalid userId:", userIdValidation.error);
+            return;
+        }
+        const traitsValidation = validateProperties(traits);
+        if (!traitsValidation.valid) {
+            this.logger.warn("Invalid traits:", traitsValidation.error);
+            return;
+        }
+        this.session.setUserId(userId);
+        if (traits) {
+            this.session.setUserTraits(traits);
+        }
+        const identifyEvent = {
+            type: "identify",
+            userId,
+            traits,
+            timestamp: new Date().toISOString(),
+            anonymousId: this.session.getAnonymousId(),
+            sessionId: this.session.getSessionId(),
+            accountId: this.session.getAccountId(),
+            context: this.getContext(),
+        };
+        this.queue.push(identifyEvent);
+        this.session.updateLastActivity();
+    }
+    /**
+     * Track a page view
+     */
+    page(name, properties) {
+        if (!this.shouldTrack())
+            return;
+        const propsValidation = validateProperties(properties);
+        if (!propsValidation.valid) {
+            this.logger.warn("Invalid properties:", propsValidation.error);
+            return;
+        }
+        const url = typeof window !== "undefined" ? window.location.href : "";
+        const referrer = typeof document !== "undefined" ? document.referrer : undefined;
+        const pageEvent = {
+            type: "page",
+            name,
+            properties,
+            url,
+            referrer,
+            timestamp: new Date().toISOString(),
+            anonymousId: this.session.getAnonymousId(),
+            userId: this.session.getUserId(),
+            sessionId: this.session.getSessionId(),
+            accountId: this.session.getAccountId(),
+            context: this.getContext(),
+        };
+        this.queue.push(pageEvent);
+        this.session.updateLastActivity();
+    }
+    /**
+     * Associate the current user with an account/company
+     */
+    group(accountId, traits) {
+        if (!this.shouldTrack())
+            return;
+        const accountIdValidation = validateAccountId(accountId);
+        if (!accountIdValidation.valid) {
+            this.logger.warn("Invalid accountId:", accountIdValidation.error);
+            return;
+        }
+        const traitsValidation = validateProperties(traits);
+        if (!traitsValidation.valid) {
+            this.logger.warn("Invalid traits:", traitsValidation.error);
+            return;
+        }
+        this.session.setAccountId(accountId);
+        if (traits) {
+            this.session.setAccountTraits(traits);
+        }
+        const groupEvent = {
+            type: "group",
+            accountId,
+            traits,
+            timestamp: new Date().toISOString(),
+            anonymousId: this.session.getAnonymousId(),
+            userId: this.session.getUserId(),
+            sessionId: this.session.getSessionId(),
+            context: this.getContext(),
+        };
+        this.queue.push(groupEvent);
+        this.session.updateLastActivity();
+    }
+    /**
+     * Capture an exception and send to error tracking
+     */
+    captureException(error, context) {
+        if (!this.shouldTrack())
+            return;
+        this.errorCapture?.captureException(error, context);
+    }
+    /**
+     * Capture a message as an error event
+     */
+    captureMessage(message, level, context) {
+        if (!this.shouldTrack())
+            return;
+        this.errorCapture?.captureMessage(message, level, context);
+    }
+    /**
+     * Add a breadcrumb for error context
+     */
+    addBreadcrumb(breadcrumb) {
+        this.errorCapture?.addBreadcrumb(breadcrumb);
+    }
+    /**
+     * Send a structured log event
+     */
+    log(message, level, metadata) {
+        if (!this.shouldTrack())
+            return;
+        sendLog(this, message, level, metadata);
+    }
+    /**
+     * Reset the current user session (call on logout)
+     */
+    reset() {
+        this.queue.flush();
+        this.session.reset();
+        this.errorCapture?.clearBreadcrumbs();
+        this.logger.log("Session reset");
+    }
+    /**
+     * Manually flush the event queue
+     */
+    async flush() {
+        await this.queue.flush();
+    }
+    /**
+     * Opt out of tracking
+     */
+    optOut() {
+        this.privacy.optOut();
+    }
+    /**
+     * Opt back in to tracking
+     */
+    optIn() {
+        this.privacy.optIn();
+    }
+    /**
+     * Check if user has opted out
+     */
+    isOptedOut() {
+        return this.privacy.isOptedOut();
+    }
+    /**
+     * Get current user state
+     */
+    getUser() {
+        return this.session.getUserState();
+    }
+    /**
+     * Check if tracking should be allowed
+     */
+    shouldTrack() {
+        if (!this.initialized) {
+            this.logger.log("Analytics not initialized, skipping event");
+            return false;
+        }
+        if (!this.privacy.shouldTrack()) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Build event context
+     */
+    getContext() {
+        const context = {
+            library: LIBRARY_INFO,
+            userAgent: typeof navigator !== "undefined" ? navigator.userAgent : "unknown",
+            locale: typeof navigator !== "undefined" ? navigator.language : "en",
+            timezone: typeof Intl !== "undefined"
+                ? Intl.DateTimeFormat().resolvedOptions().timeZone
+                : "UTC",
+        };
+        if (typeof window !== "undefined" && window.screen) {
+            context.screen = {
+                width: window.screen.width,
+                height: window.screen.height,
+            };
+        }
+        if (typeof window !== "undefined") {
+            context.page = {
+                url: window.location.href,
+                path: window.location.pathname,
+                referrer: document.referrer,
+                title: document.title,
+            };
+        }
+        return context;
+    }
+}
+/**
+ * Create a new Analytics instance
+ *
+ * @param config - Analytics configuration
+ * @returns Analytics instance
+ *
+ * @example
+ * ```typescript
+ * const analytics = createAnalytics({
+ *   apiKey: 'tbf_xxx',
+ *   debug: process.env.NODE_ENV === 'development',
+ * });
+ *
+ * analytics.track('signup_completed', { plan: 'pro' });
+ * ```
+ */
+export const createAnalytics = (config) => {
+    return new AnalyticsImpl(config);
+};
+let globalInstance = null;
+/**
+ * Get or create a global analytics instance (for script tag usage)
+ */
+export const getAnalytics = () => {
+    return globalInstance;
+};
+/**
+ * Initialize the global analytics instance
+ */
+export const initAnalytics = (config) => {
+    if (globalInstance) {
+        console.warn("[Thisbefine] Analytics already initialized");
+        return globalInstance;
+    }
+    globalInstance = createAnalytics(config);
+    return globalInstance;
+};
+//# sourceMappingURL=analytics.js.map

package/dist/core/analytics.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,94 @@
+import type { Session } from "./session";
+import type { ResolvedConfig } from "./types";
+export interface Breadcrumb {
+    type: "click" | "navigation" | "network" | "console" | "custom";
+    message: string;
+    timestamp: string;
+    data?: Record<string, unknown>;
+}
+export interface ErrorPayload {
+    message: string;
+    stack?: string;
+    type?: string;
+    level?: "error" | "fatal" | "warning";
+    fingerprint: string;
+    url?: string;
+    breadcrumbs?: Breadcrumb[];
+    tags?: Record<string, string>;
+    context?: Record<string, unknown>;
+    timestamp?: string;
+    anonymousId?: string;
+    userId?: string;
+    sessionId?: string;
+}
+export interface ErrorCaptureConfig {
+    /** Enable error capture. Default: true */
+    enabled?: boolean;
+    /** Capture console.error calls as breadcrumbs. Default: false */
+    captureConsoleErrors?: boolean;
+    /** Capture fetch/XHR failures as breadcrumbs. Default: false */
+    captureNetworkErrors?: boolean;
+    /** Max breadcrumbs to retain. Default: 25 */
+    maxBreadcrumbs?: number;
+    /** Modify or filter errors before sending. Return null to discard. */
+    beforeSend?: (payload: ErrorPayload) => ErrorPayload | null;
+}
+/**
+ * Error capture module for the analytics SDK.
+ *
+ * Captures unhandled exceptions, unhandled promise rejections,
+ * and records breadcrumbs (clicks, navigation, console, network).
+ */
+export declare class ErrorCapture {
+    private config;
+    private errorConfig;
+    private session;
+    private breadcrumbs;
+    private installed;
+    private logger;
+    private originalOnError;
+    private originalConsoleError;
+    private originalFetch;
+    private unhandledRejectionHandler;
+    private clickHandler;
+    private lastClickTarget;
+    private lastClickTime;
+    private originalPushState;
+    private originalReplaceState;
+    private popstateHandler;
+    constructor(config: ResolvedConfig, session: Session, errorConfig?: ErrorCaptureConfig);
+    /**
+     * Install global error handlers and breadcrumb collectors
+     */
+    install(): void;
+    /**
+     * Remove all handlers and restore originals
+     */
+    uninstall(): void;
+    /**
+     * Add a breadcrumb manually
+     */
+    addBreadcrumb(breadcrumb: Omit<Breadcrumb, "timestamp">): void;
+    /**
+     * Clear all breadcrumbs
+     */
+    clearBreadcrumbs(): void;
+    /**
+     * Capture an exception and send it to the API
+     */
+    captureException(error: Error, context?: Record<string, unknown>): void;
+    /**
+     * Capture a message as an error event
+     */
+    captureMessage(message: string, level?: "error" | "fatal" | "warning", context?: Record<string, unknown>): void;
+    private installErrorHandler;
+    private installUnhandledRejectionHandler;
+    private installClickBreadcrumbs;
+    private installNavigationBreadcrumbs;
+    private installConsoleBreadcrumbs;
+    private installNetworkBreadcrumbs;
+    private pushBreadcrumb;
+    private sendError;
+    private postError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

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