@thisbefine/analytics 0.1.0

package/dist/core/types.d.ts

@@ -0,0 +1,298 @@
+import type { ErrorCaptureConfig } from "./errors";
+import type { LogLevel } from "./logging";
+/**
+ * Configuration options for the analytics SDK
+ */
+export interface AnalyticsConfig {
+    /** Your Thisbefine API key (starts with tbf_) */
+    apiKey: string;
+    /** API host URL. Defaults to https://thisbefine.com */
+    host?: string;
+    /** Number of events to batch before sending. Default: 20 */
+    flushAt?: number;
+    /** Maximum time (ms) between flushes. Default: 10000 (10s) */
+    flushInterval?: number;
+    /** Session timeout in ms. Default: 1800000 (30 minutes) */
+    sessionTimeout?: number;
+    /** Cookie domain for cross-subdomain tracking */
+    cookieDomain?: string;
+    /** Enable debug logging to console. Default: false */
+    debug?: boolean;
+    /** Respect Do Not Track browser setting. Default: true */
+    respectDNT?: boolean;
+    /** Maximum retry attempts for failed requests. Default: 3 */
+    maxRetries?: number;
+    /** Error capture configuration */
+    errors?: ErrorCaptureConfig;
+}
+/**
+ * Internal resolved configuration with defaults applied
+ */
+export interface ResolvedConfig {
+    apiKey: string;
+    host: string;
+    flushAt: number;
+    flushInterval: number;
+    sessionTimeout: number;
+    cookieDomain: string | undefined;
+    debug: boolean;
+    respectDNT: boolean;
+    maxRetries: number;
+    errors?: ErrorCaptureConfig;
+}
+/**
+ * Event context sent with every event
+ */
+export interface EventContext {
+    library: {
+        name: string;
+        version: string;
+    };
+    userAgent: string;
+    locale: string;
+    timezone: string;
+    screen?: {
+        width: number;
+        height: number;
+    };
+    page?: {
+        url: string;
+        path: string;
+        referrer: string;
+        title: string;
+    };
+}
+/**
+ * Base event structure
+ */
+export interface BaseEvent {
+    type: "track" | "identify" | "page" | "group";
+    timestamp: string;
+    anonymousId: string;
+    userId?: string;
+    sessionId?: string;
+    accountId?: string;
+    context?: EventContext;
+}
+/**
+ * Track event for custom user actions
+ */
+export interface TrackEvent extends BaseEvent {
+    type: "track";
+    event: string;
+    properties?: Record<string, unknown>;
+}
+/**
+ * Identify event for user identification
+ */
+export interface IdentifyEvent extends BaseEvent {
+    type: "identify";
+    userId: string;
+    traits?: Record<string, unknown>;
+}
+/**
+ * Page event for pageview tracking
+ */
+export interface PageEvent extends BaseEvent {
+    type: "page";
+    name?: string;
+    properties?: Record<string, unknown>;
+    url: string;
+    referrer?: string;
+}
+/**
+ * Group event for account/company association
+ */
+export interface GroupEvent extends BaseEvent {
+    type: "group";
+    accountId: string;
+    traits?: AccountTraits;
+}
+/**
+ * Account/company traits for B2B SaaS
+ */
+export interface AccountTraits {
+    /** Company/account name */
+    name?: string;
+    /** Subscription plan (e.g., 'free', 'starter', 'pro', 'enterprise') */
+    plan?: string;
+    /** Monthly recurring revenue in dollars */
+    mrr?: number;
+    /** Industry vertical */
+    industry?: string;
+    /** Number of employees */
+    employeeCount?: number;
+    /** Account creation date */
+    createdAt?: string | Date;
+    /** Custom properties */
+    [key: string]: unknown;
+}
+/**
+ * Union type for all event types
+ */
+export type AnalyticsEvent = TrackEvent | IdentifyEvent | PageEvent | GroupEvent;
+/**
+ * User traits for identification
+ */
+export interface UserTraits {
+    email?: string;
+    name?: string;
+    avatar?: string;
+    [key: string]: unknown;
+}
+/**
+ * Current user state
+ */
+export interface UserState {
+    anonymousId: string;
+    userId?: string;
+    traits?: UserTraits;
+    accountId?: string;
+    accountTraits?: AccountTraits;
+}
+/**
+ * Batch request payload sent to the API
+ */
+export interface BatchPayload {
+    batch: Array<{
+        event: string;
+        properties?: Record<string, unknown>;
+        timestamp?: string;
+        anonymousId?: string;
+        userId?: string;
+        sessionId?: string;
+        url?: string;
+        referrer?: string;
+    }>;
+}
+/**
+ * Identify request payload
+ */
+export interface IdentifyPayload {
+    userId: string;
+    anonymousId?: string;
+    traits?: UserTraits;
+}
+/**
+ * Public Analytics interface
+ */
+export interface Analytics {
+    /**
+     * Track a custom event
+     * @param event - Event name (e.g., 'button_clicked', 'signup_completed')
+     * @param properties - Optional event properties
+     */
+    track(event: string, properties?: Record<string, unknown>): void;
+    /**
+     * Identify a user and associate traits
+     * @param userId - Unique user identifier
+     * @param traits - Optional user traits (email, name, etc.)
+     */
+    identify(userId: string, traits?: UserTraits): void;
+    /**
+     * Track a page view
+     * @param name - Optional page name
+     * @param properties - Optional page properties
+     */
+    page(name?: string, properties?: Record<string, unknown>): void;
+    /**
+     * Associate the current user with an account/company
+     * @param accountId - Unique account identifier
+     * @param traits - Optional account traits (name, plan, MRR, etc.)
+     */
+    group(accountId: string, traits?: AccountTraits): void;
+    /**
+     * Reset the current user session (call on logout)
+     */
+    reset(): void;
+    /**
+     * Manually flush the event queue
+     */
+    flush(): Promise<void>;
+    /**
+     * Opt out of tracking
+     */
+    optOut(): void;
+    /**
+     * Opt back in to tracking
+     */
+    optIn(): void;
+    /**
+     * Check if user has opted out
+     */
+    isOptedOut(): boolean;
+    /**
+     * Get current user state
+     */
+    getUser(): UserState;
+    /**
+     * Capture an exception and send to error tracking
+     * @param error - The Error object to capture
+     * @param context - Optional additional context
+     */
+    captureException(error: Error, context?: Record<string, unknown>): void;
+    /**
+     * Capture a message as an error event
+     * @param message - Error message
+     * @param level - Severity level
+     * @param context - Optional additional context
+     */
+    captureMessage(message: string, level?: "error" | "fatal" | "warning", context?: Record<string, unknown>): void;
+    /**
+     * Add a breadcrumb for error context
+     * @param breadcrumb - Breadcrumb data (type, message, optional data)
+     */
+    addBreadcrumb(breadcrumb: {
+        type: "click" | "navigation" | "network" | "console" | "custom";
+        message: string;
+        data?: Record<string, unknown>;
+    }): void;
+    /**
+     * Send a structured log event
+     * @param message - Log message
+     * @param level - Log level
+     * @param metadata - Optional additional data
+     */
+    log(message: string, level: LogLevel, metadata?: Record<string, unknown>): void;
+}
+/**
+ * Storage interface for persistence
+ */
+export interface StorageInterface {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+/**
+ * SDK library info
+ */
+export declare const LIBRARY_INFO: {
+    name: string;
+    version: string;
+};
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: {
+    readonly host: "https://thisbefine.com";
+    readonly flushAt: 20;
+    readonly flushInterval: 10000;
+    readonly sessionTimeout: number;
+    readonly debug: false;
+    readonly respectDNT: true;
+    readonly maxRetries: 3;
+};
+/**
+ * Storage key names
+ */
+export declare const STORAGE_KEYS: {
+    readonly ANONYMOUS_ID: "tif_anonymous_id";
+    readonly USER_ID: "tif_user_id";
+    readonly USER_TRAITS: "tif_user_traits";
+    readonly ACCOUNT_ID: "tif_account_id";
+    readonly ACCOUNT_TRAITS: "tif_account_traits";
+    readonly SESSION_ID: "tif_session_id";
+    readonly LAST_ACTIVITY: "tif_last_activity";
+    readonly OPT_OUT: "tif_opt_out";
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG1C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;IACF,IAAI,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACd,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC5C,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC/C,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC5C,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wBAAwB;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACvB,UAAU,GACV,aAAa,GACb,SAAS,GACT,UAAU,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEjE;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEhE;;;;OAIG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAEvD;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,MAAM,IAAI,IAAI,CAAC;IAEf;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC;IAEtB;;OAEG;IACH,OAAO,IAAI,SAAS,CAAC;IAErB;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAExE;;;;;OAKG;IACH,cAAc,CACb,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,EACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAAC;IAER;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE;QACzB,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;QAChE,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GAAG,IAAI,CAAC;IAET;;;;;OAKG;IACH,GAAG,CACF,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAAC;CACR;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;CAGxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC"}

package/dist/core/types.js

@@ -0,0 +1,34 @@
+import { VERSION } from "./version";
+/**
+ * SDK library info
+ */
+export const LIBRARY_INFO = {
+    name: "@thisbefine/analytics",
+    version: VERSION,
+};
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    host: "https://thisbefine.com",
+    flushAt: 20,
+    flushInterval: 10000,
+    sessionTimeout: 30 * 60 * 1000,
+    debug: false,
+    respectDNT: true,
+    maxRetries: 3,
+};
+/**
+ * Storage key names
+ */
+export const STORAGE_KEYS = {
+    ANONYMOUS_ID: "tif_anonymous_id",
+    USER_ID: "tif_user_id",
+    USER_TRAITS: "tif_user_traits",
+    ACCOUNT_ID: "tif_account_id",
+    ACCOUNT_TRAITS: "tif_account_traits",
+    SESSION_ID: "tif_session_id",
+    LAST_ACTIVITY: "tif_last_activity",
+    OPT_OUT: "tif_opt_out",
+};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2TpC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,OAAO;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC7B,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,EAAE;IACX,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IAC9B,KAAK,EAAE,KAAK;IACZ,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,CAAC;CACJ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,YAAY,EAAE,kBAAkB;IAChC,OAAO,EAAE,aAAa;IACtB,WAAW,EAAE,iBAAiB;IAC9B,UAAU,EAAE,gBAAgB;IAC5B,cAAc,EAAE,oBAAoB;IACpC,UAAU,EAAE,gBAAgB;IAC5B,aAAa,EAAE,mBAAmB;IAClC,OAAO,EAAE,aAAa;CACb,CAAC"}

package/dist/core/validation.d.ts

@@ -0,0 +1,11 @@
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+export declare const isNonEmptyString: (value: unknown) => value is string;
+export declare const validateEventName: (event: unknown) => ValidationResult;
+export declare const validateUserId: (userId: unknown) => ValidationResult;
+export declare const validateAccountId: (accountId: unknown) => ValidationResult;
+export declare const validateProperties: (properties: unknown) => ValidationResult;
+export declare const sanitizeString: (str: string, maxLength: number) => string;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAE1D,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,gBAWlD,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,QAAQ,OAAO,KAAG,gBAkBhD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,WAAW,OAAO,KAAG,gBAkBtD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,YAAY,OAAO,KAAG,gBA0BxD,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,EAAE,WAAW,MAAM,KAAG,MAG/D,CAAC"}

package/dist/core/validation.js

@@ -0,0 +1,82 @@
+const MAX_STRING_LENGTH = 500;
+const MAX_EVENT_NAME_LENGTH = 200;
+const MAX_PROPERTIES_SIZE = 32 * 1024;
+export const isNonEmptyString = (value) => {
+    return typeof value === "string" && value.trim().length > 0;
+};
+export const validateEventName = (event) => {
+    if (!isNonEmptyString(event)) {
+        return { valid: false, error: "Event name must be a non-empty string" };
+    }
+    if (event.length > MAX_EVENT_NAME_LENGTH) {
+        return {
+            valid: false,
+            error: `Event name exceeds ${MAX_EVENT_NAME_LENGTH} characters`,
+        };
+    }
+    return { valid: true };
+};
+export const validateUserId = (userId) => {
+    if (!isNonEmptyString(userId)) {
+        return { valid: false, error: "User ID must be a non-empty string" };
+    }
+    if (userId.length > MAX_STRING_LENGTH) {
+        return {
+            valid: false,
+            error: `User ID exceeds ${MAX_STRING_LENGTH} characters`,
+        };
+    }
+    if (userId === "undefined" ||
+        userId === "null" ||
+        userId === "[object Object]") {
+        return { valid: false, error: `Invalid user ID: "${userId}"` };
+    }
+    return { valid: true };
+};
+export const validateAccountId = (accountId) => {
+    if (!isNonEmptyString(accountId)) {
+        return { valid: false, error: "Account ID must be a non-empty string" };
+    }
+    if (accountId.length > MAX_STRING_LENGTH) {
+        return {
+            valid: false,
+            error: `Account ID exceeds ${MAX_STRING_LENGTH} characters`,
+        };
+    }
+    if (accountId === "undefined" ||
+        accountId === "null" ||
+        accountId === "[object Object]") {
+        return { valid: false, error: `Invalid account ID: "${accountId}"` };
+    }
+    return { valid: true };
+};
+export const validateProperties = (properties) => {
+    if (properties === undefined || properties === null) {
+        return { valid: true };
+    }
+    if (typeof properties !== "object" || Array.isArray(properties)) {
+        return { valid: false, error: "Properties must be an object" };
+    }
+    try {
+        const json = JSON.stringify(properties);
+        if (json.length > MAX_PROPERTIES_SIZE) {
+            return {
+                valid: false,
+                error: `Properties exceed ${MAX_PROPERTIES_SIZE} bytes`,
+            };
+        }
+    }
+    catch {
+        return {
+            valid: false,
+            error: "Properties contain circular references or non-serializable values",
+        };
+    }
+    return { valid: true };
+};
+export const sanitizeString = (str, maxLength) => {
+    if (str.length <= maxLength)
+        return str;
+    return str.slice(0, maxLength);
+};
+//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

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

package/dist/core/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/core/version.js

@@ -0,0 +1,4 @@
+// Auto-generated by scripts/generate-version.js
+// Do not edit manually
+export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,uBAAuB;AAEvB,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @thisbefine/analytics
+ *
+ * Lightweight analytics SDK for tracking events, identifying users,
+ * and measuring what matters for your SaaS.
+ *
+ * @example
+ * ```typescript
+ * import { createAnalytics } from '@thisbefine/analytics';
+ *
+ * const analytics = createAnalytics({
+ *   apiKey: 'tbf_xxx',
+ *   debug: process.env.NODE_ENV === 'development',
+ * });
+ *
+ * // Track events
+ * analytics.track('button_clicked', { buttonId: 'signup' });
+ *
+ * // Identify users
+ * analytics.identify('user_123', { email: 'user@example.com', plan: 'pro' });
+ *
+ * // Track page views
+ * analytics.page('/dashboard');
+ *
+ * // Reset on logout
+ * analytics.reset();
+ * ```
+ *
+ * For React/Next.js integration, use:
+ * ```typescript
+ * import { AnalyticsProvider, useAnalytics } from '@thisbefine/analytics/react';
+ * // or
+ * import { AnalyticsProvider, useAnalytics } from '@thisbefine/analytics/next';
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createAnalytics, getAnalytics, initAnalytics, } from "./core/analytics";
+export type { Breadcrumb, ErrorCaptureConfig, ErrorPayload, } from "./core/errors";
+export type { LogLevel } from "./core/logging";
+export type { AccountTraits, Analytics, AnalyticsConfig, AnalyticsEvent, EventContext, GroupEvent, IdentifyEvent, PageEvent, TrackEvent, UserState, UserTraits, } from "./core/types";
+export { DEFAULT_CONFIG, LIBRARY_INFO, STORAGE_KEYS } from "./core/types";
+export type { BugReportWidgetOptions } from "./widget/bug-report";
+export { createBugReportWidget } from "./widget/bug-report";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACN,eAAe,EACf,YAAY,EACZ,aAAa,GACb,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACX,UAAU,EACV,kBAAkB,EAClB,YAAY,GACZ,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,YAAY,EACX,aAAa,EACb,SAAS,EACT,eAAe,EACf,cAAc,EACd,YAAY,EACZ,UAAU,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,SAAS,EACT,UAAU,GACV,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1E,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,41 @@
+/**
+ * @thisbefine/analytics
+ *
+ * Lightweight analytics SDK for tracking events, identifying users,
+ * and measuring what matters for your SaaS.
+ *
+ * @example
+ * ```typescript
+ * import { createAnalytics } from '@thisbefine/analytics';
+ *
+ * const analytics = createAnalytics({
+ *   apiKey: 'tbf_xxx',
+ *   debug: process.env.NODE_ENV === 'development',
+ * });
+ *
+ * // Track events
+ * analytics.track('button_clicked', { buttonId: 'signup' });
+ *
+ * // Identify users
+ * analytics.identify('user_123', { email: 'user@example.com', plan: 'pro' });
+ *
+ * // Track page views
+ * analytics.page('/dashboard');
+ *
+ * // Reset on logout
+ * analytics.reset();
+ * ```
+ *
+ * For React/Next.js integration, use:
+ * ```typescript
+ * import { AnalyticsProvider, useAnalytics } from '@thisbefine/analytics/react';
+ * // or
+ * import { AnalyticsProvider, useAnalytics } from '@thisbefine/analytics/next';
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createAnalytics, getAnalytics, initAnalytics, } from "./core/analytics";
+export { DEFAULT_CONFIG, LIBRARY_INFO, STORAGE_KEYS } from "./core/types";
+export { createBugReportWidget } from "./widget/bug-report";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACN,eAAe,EACf,YAAY,EACZ,aAAa,GACb,MAAM,kBAAkB,CAAC;AAwB1B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/next/analytics.d.ts

@@ -0,0 +1,59 @@
+import type { AnalyticsConfig } from "../core/types";
+export interface NextAnalyticsProps {
+    /**
+     * Your Thisbefine API key.
+     * If not provided, reads from NEXT_PUBLIC_TBF_API_KEY environment variable.
+     */
+    apiKey?: string;
+    /**
+     * API host URL.
+     * Defaults to https://thisbefine.com
+     * For local development, use http://localhost:3000
+     */
+    host?: string;
+    /**
+     * Enable debug logging to console.
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Automatically track page views on route changes.
+     * @default true
+     */
+    trackPageviews?: boolean;
+    /**
+     * Additional configuration options
+     */
+    config?: Omit<AnalyticsConfig, "apiKey" | "host" | "debug">;
+}
+/**
+ * Next.js Analytics component - initializes Thisbefine analytics
+ *
+ * Optimized for the Next.js App Router with automatic pageview tracking
+ * on client-side navigations using usePathname/useSearchParams.
+ *
+ * Add this component once at the root of your app (e.g., in layout.tsx).
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * // Zero config - reads from NEXT_PUBLIC_TBF_API_KEY
+ * import { Analytics } from '@thisbefine/analytics/next';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         {children}
+ *         <Analytics />
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ *
+ * // With explicit config
+ * <Analytics apiKey="tbf_xxx" host="http://localhost:3000" debug />
+ * ```
+ */
+export declare const Analytics: ({ apiKey, host, debug, trackPageviews, config, }: NextAnalyticsProps) => import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/next/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/next/analytics.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,kBAAkB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC5D;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,SAAS,GAAI,kDAMvB,kBAAkB,mDAmCpB,CAAC"}