userpath-js 0.0.0 → 0.0.2

package/dist/types/src/base/events.d.ts

@@ -0,0 +1,184 @@
+import { Config } from '../schemas/config';
+import { SessionClient } from './session';
+/**
+ * Session client for managing user sessions and automatic tracking
+ */
+export declare class EventsClient {
+    #private;
+    constructor(session: SessionClient, config?: Config);
+    destroy(): void;
+    /**
+     * Set up automatic click event tracking
+     */
+    private setupClickTracking;
+    /**
+     * Handle click events
+     */
+    private handleClick;
+    /**
+     * Handle scroll and resize events
+     */
+    private handleScroll;
+    /**
+     * Set up automatic scroll event tracking
+     */
+    private setupScrollTracking;
+    /**
+     * Calculate the current scroll depth as a percentage
+     */
+    private calculateScrollDepth;
+    /**
+     * Check and track scroll depth milestones
+     */
+    private checkAndTrackScrollDepth;
+    /**
+     * Extract a meaningful label from a clicked element
+     */
+    private extractClickLabel;
+    /**
+     * Find the label text for an input element
+     */
+    private findInputLabel;
+    /**
+     * Track a page view event
+     */
+    trackPageView(): void;
+    /**
+     * Track a custom event
+     */
+    trackCustomEvent(name: string, properties?: Record<string, any>, options?: {
+        immediate: boolean;
+    }): void;
+    /**
+     * Track a purchase event
+     */
+    trackPurchase(params: {
+        productId: string;
+        price: number;
+        currency: string;
+        properties?: Record<string, any>;
+    }): void;
+    /**
+     * Set up automatic form input tracking
+     */
+    private setupFormTracking;
+    /**
+     * Handle input focus events
+     */
+    private handleInputFocus;
+    /**
+     * Get the current value of an input element
+     */
+    private getElementValue;
+    /**
+     * Handle input blur events
+     */
+    private handleInputBlur;
+    /**
+     * Get a meaningful identifier for the form if available
+     */
+    private getFormName;
+    /**
+     * Get an identifier for an input when no label is found
+     */
+    private getInputIdentifier;
+    /**
+     * Find the label text for a form element
+     */
+    private findFormElementLabel;
+    /**
+     * Handle form change events (select, radio, checkbox)
+     */
+    private handleFormChange;
+    /**
+     * Track select element changes
+     */
+    private trackSelectChange;
+    /**
+     * Track radio button changes
+     */
+    private trackRadioChange;
+    /**
+     * Track checkbox changes
+     */
+    private trackCheckboxChange;
+    /**
+     * Track range input changes
+     */
+    private trackRangeChange;
+    /**
+     * Handle form submission events
+     */
+    private handleFormSubmit;
+    /**
+     * Set up automatic video tracking
+     */
+    private setupVideoTracking;
+    /**
+     * Get video metadata for tracking
+     */
+    private getVideoMetadata;
+    /**
+     * Handle video play events
+     */
+    private handleVideoPlay;
+    /**
+     * Handle video pause events
+     */
+    private handleVideoPause;
+    /**
+     * Handle video end events
+     */
+    private handleVideoEnd;
+    /**
+     * Set up page time tracking
+     */
+    private setupPageTimeTracking;
+    /**
+     * Handle visibility change events (tab switch, minimize)
+     */
+    private handleVisibilityChange;
+    /**
+     * Handle page unload events
+     */
+    private handleBeforeUnload;
+    /**
+     * Set up inactivity tracking
+     */
+    private setupInactivityTracking;
+    /**
+     * Handle user activity events
+     */
+    private handleUserActivity;
+    /**
+     * Check for user inactivity
+     */
+    private checkInactivity;
+    /**
+     * Install global error handlers
+     */
+    installErrorHandler(): void;
+    /**
+     * Remove global error handlers
+     */
+    uninstallErrorHandler(): void;
+    /**
+     * Get error handler installation state
+     */
+    isErrorHandlerInstalled(): boolean;
+    /**
+     * Handle uncaught errors
+     */
+    private handleError;
+    /**
+     * Handle unhandled promise rejections
+     */
+    private handleRejection;
+    /**
+     * Track an error event
+     */
+    trackError(error: Error, properties?: Record<string, any>, options?: {
+        immediate: boolean;
+    }): void;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/types/src/base/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/base/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAkB,MAAM,mBAAmB,CAAC;AAO3D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AA6D1C;;GAEG;AAEH,qBAAa,YAAY;;gBAoCZ,OAAO,EAAE,aAAa,EAAE,MAAM,GAAE,MAAuB;IAkE5D,OAAO,IAAI,IAAI;IAiCtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACI,aAAa,IAAI,IAAI;IAY5B;;OAEG;IACI,gBAAgB,CACtB,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EACpC,OAAO,GAAE;QACR,SAAS,EAAE,OAAO,CAAC;KAGnB,GACC,IAAI;IAiBP;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,GAAG,IAAI;IAkBR;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,eAAe;IA0CvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA4B5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACI,mBAAmB,IAAI,IAAI;IAclC;;OAEG;IACI,qBAAqB,IAAI,IAAI;IAWpC;;OAEG;IACI,uBAAuB,IAAI,OAAO;IAIzC;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACI,UAAU,CAChB,KAAK,EAAE,KAAK,EACZ,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EACpC,OAAO,GAAE;QACR,SAAS,EAAE,OAAO,CAAC;KAGnB,GACC,IAAI;CAoCP"}

package/dist/types/src/base/session.d.ts

@@ -0,0 +1,64 @@
+import { Config } from '../schemas/config';
+import { Event } from '../schemas/events';
+import { UserIdentity } from '../schemas/identity';
+import { ApiClient } from './api';
+import { EventsClient } from './events';
+/**
+ * Session client for managing user sessions and automatic tracking
+ */
+export declare class SessionClient {
+    #private;
+    constructor(api: ApiClient, config?: Config);
+    init(events: EventsClient): void;
+    destroy(): void;
+    /**
+     * Setup session tracking
+     */
+    private setup;
+    /**
+     * Set up tracking for history/navigation changes
+     */
+    private setupHistoryChange;
+    /**
+     * Track page view only if URL has changed
+     */
+    private trackPageViewIfUrlChanged;
+    /**
+     * Get the current user ID if available
+     */
+    getUserId(): string | undefined;
+    /**
+     * Set the user ID
+     */
+    setUserId(userId: string): void;
+    /**
+     * Get the current app ID
+     */
+    getAppId(): string;
+    /**
+     * Set the app ID
+     */
+    setAppId(appId: string): void;
+    /**
+     * Add an event to the queue and flush if needed
+     */
+    track(event: Event): void;
+    /**
+     * Identify a user so that we can show in the User Journey
+     */
+    identify(identity: UserIdentity): Promise<void>;
+    /**
+     * Flush queued events to the server
+     */
+    protected flush(): void;
+    publish(events: any[]): Promise<Response>;
+    /**
+     * Get or generate a session ID
+     */
+    getSessionId(): string;
+    /**
+     * Generate a UUID v4
+     */
+    generateId(): string;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/types/src/base/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/base/session.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,qBAAa,aAAa;;gBASb,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM;IAMpC,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAKhC,OAAO,IAAI,IAAI;IAStB;;OAEG;IACH,OAAO,CAAC,KAAK;IAiBb;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAQjC;;OAEG;IACI,SAAS,IAAI,MAAM,GAAG,SAAS;IAItC;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACI,QAAQ,IAAI,MAAM;IAIzB;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACI,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAQhC;;OAEG;IACU,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5D;;OAEG;IACH,SAAS,CAAC,KAAK,IAAI,IAAI;IAaV,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE;IAgClC;;OAEG;IACI,YAAY,IAAI,MAAM;IAS7B;;OAEG;IACI,UAAU,IAAI,MAAM;CAU3B"}

package/dist/types/src/index.d.ts

@@ -0,0 +1,57 @@
+import { Config } from './schemas/config';
+import { UserIdentity } from './schemas/identity';
+declare class UserPath {
+    #private;
+    constructor(config: Config);
+    /**
+     * Get the current app ID
+     */
+    getAppId(): string;
+    /**
+     * Set the app ID directly
+     */
+    setAppId(appId: string): void;
+    /**
+     * Install global error handlers
+     */
+    installErrorHandler(): void;
+    /**
+     * Remove global error handlers
+     */
+    uninstallErrorHandler(): void;
+    /**
+     * Track an error
+     */
+    trackError(error: Error, properties?: Record<string, any>): void;
+    /**
+     * Set the user ID directly
+     */
+    setUserId(userId: string): void;
+    /**
+     * Get the current user ID
+     */
+    getUserId(): string | undefined;
+    /**
+     * Identify a user and associate them with their anonymous ID
+     */
+    identify(identity: UserIdentity): Promise<void>;
+    /**
+     * Track an event
+     */
+    track(eventType: 'page_view'): void;
+    track(eventType: 'event', params: {
+        name: string;
+        properties?: Record<string, any>;
+    }): void;
+    track(eventType: 'purchase', params: {
+        price: number;
+        amount?: number;
+        currency: string;
+        properties?: Record<string, any>;
+    }): void;
+}
+export * from './schemas/events';
+export * from './schemas/config';
+export * from './schemas/identity';
+export { UserPath };
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAkB,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,cAAM,QAAQ;;gBAMD,MAAM,EAAE,MAAM;IAyB1B;;OAEG;IACI,QAAQ,IAAI,MAAM;IAIzB;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACI,mBAAmB,IAAI,IAAI;IAIlC;;OAEG;IACI,qBAAqB,IAAI,IAAI;IAIpC;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;IAY3E;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACI,SAAS,IAAI,MAAM,GAAG,SAAS;IAItC;;OAEG;IACU,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;OAEG;IACI,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IACnC,KAAK,CACX,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GACxD,IAAI;IACA,KAAK,CACX,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,GACC,IAAI;CAkBP;AAGD,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/types/src/pixel.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pixel.d.ts.map

package/dist/types/src/pixel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel.d.ts","sourceRoot":"","sources":["../../../src/pixel.ts"],"names":[],"mappings":""}

package/dist/types/src/schemas/config.d.ts

@@ -0,0 +1,32 @@
+export interface Config {
+    appId: string;
+    serverUrl?: string;
+    version?: number;
+    userId?: string;
+    autoTrackErrors?: boolean;
+    autoTrack?: {
+        errors?: boolean;
+        clicks?: boolean;
+        scrolling?: boolean;
+        forms?: boolean;
+        videos?: boolean;
+        pageVisibility?: boolean;
+        inactivity?: boolean;
+    };
+}
+export declare const DEFAULT_CONFIG: {
+    readonly appId: "";
+    readonly serverUrl: "https://api.userpath.co";
+    readonly version: 1;
+    readonly autoTrackErrors: true;
+    readonly autoTrack: {
+        readonly errors: true;
+        readonly clicks: true;
+        readonly scrolling: true;
+        readonly forms: true;
+        readonly videos: true;
+        readonly pageVisibility: true;
+        readonly inactivity: true;
+    };
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/types/src/schemas/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/schemas/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,UAAU,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;CACF;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAcjB,CAAC"}

package/dist/types/src/schemas/events.d.ts

@@ -0,0 +1,58 @@
+export interface PageViewEvent {
+    name: 'page_view';
+    url: string;
+    referrer: string;
+    title: string;
+    user_id?: string;
+    timestamp: string;
+}
+export interface CustomEvent {
+    name: string;
+    url: string;
+    referrer: string;
+    title: string;
+    properties: Record<string, any>;
+    user_id?: string;
+    timestamp: string;
+}
+export interface PurchaseEvent {
+    name: 'purchase';
+    productId: string;
+    price: number;
+    currency: string;
+    properties?: Record<string, any>;
+    user_id?: string;
+    timestamp: string;
+    url: string;
+    referrer: string;
+    title: string;
+}
+export interface IdentifyEvent {
+    name: 'identify';
+    anonymousId: string;
+    userId: string;
+    email?: string;
+    properties?: Record<string, any>;
+    user_id?: string;
+    timestamp: string;
+    url?: string;
+    referrer?: string;
+    title?: string;
+}
+export interface ErrorEvent {
+    name: 'error';
+    message: string;
+    stack?: string;
+    source?: string;
+    lineno?: number;
+    colno?: number;
+    filename?: string;
+    properties?: Record<string, any>;
+    user_id?: string;
+    timestamp: string;
+    url?: string;
+    referrer?: string;
+    title?: string;
+}
+export type Event = PageViewEvent | CustomEvent | PurchaseEvent | IdentifyEvent | ErrorEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/types/src/schemas/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/schemas/events.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,KAAK,GACd,aAAa,GACb,WAAW,GACX,aAAa,GACb,aAAa,GACb,UAAU,CAAC"}

package/dist/types/src/schemas/identity.d.ts

@@ -0,0 +1,7 @@
+export interface UserIdentity {
+    id: string;
+    name?: string;
+    email?: string;
+    properties?: Record<string, any>;
+}
+//# sourceMappingURL=identity.d.ts.map

package/dist/types/src/schemas/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../../src/schemas/identity.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC"}

package/dist/types/src/server/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * First party server integration for UserPath
+ * UserPath is compliant with WinterCG
+ * meaning you can extend it with any framework that supports the native Fetch API
+ * including cloudflare workers.
+ */
+export declare const userpath: {
+    /**
+     * Fetch Handler for First Party Server Integration
+     * @param request - The request object
+     * @returns The response object
+     * @example
+     * ```ts
+     * import { userpath } from 'userpath-js/server';
+     *
+     * // Using Node.js
+     * http
+     *   .createServer(function (req, res) {
+     *     return userpath.fetch(req);
+     *   })
+     *   .listen(3000);
+     *
+     * // Using Bun
+     * Bun.serve({
+     *   fetch(req) {
+     *     return userpath.fetch(req);
+     *   },
+     * });
+     *
+     * // Using Elysia
+     * const app = new Elysia({ name: 'my-userpath' });
+     *
+     * app.get('/', () => 'Hello World from Elysia');
+     *
+     * app.mount('/events', userpath.fetch); // Mount the UserPath server
+     *
+     * app.listen(3000);
+     * ```
+     */
+    fetch(request: Request): Promise<any>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;IACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;mBACkB,OAAO;CAqD5B,CAAC"}

package/package.json

@@ -1,14 +1,35 @@
 {
 	"name": "userpath-js",
-	"version": "0.0.0",
+	"version": "0.0.2",
 	"private": false,
-	"main": "dist/pixel.js",
+	"main": "dist/index.js",
+	"types": "dist/types/src/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/types/src/index.d.ts",
+			"default": "./dist/index.js"
+		},
+		"./server": {
+			"types": "./dist/types/src/server/index.d.ts",
+			"default": "./dist/server/index.js"
+		}
+	},
+	"files": [
+		"dist/index.js",
+		"dist/types",
+		"dist/server"
+	],
 	"scripts": {
 		"dev": "bun build src/index.ts --outdir ./dist --watch",
-		"build": "bun build src/index.ts --outdir ./dist --minify",
+		"types": "tsc",
+		"build": "bun run build.client && bun run build.pixel && bun run build.server",
+		"build.prod": "bun run build.client.prod && bun run build.pixel.prod && bun run build.server.prod",
+		"build.client": "bun run types && bun build src/index.ts --outdir ./dist --no-cache",
+		"build.client.prod": "bun run types && bun build src/index.ts --outdir ./dist --minify",
 		"build.pixel": "bun build src/pixel.ts --outdir ./dist",
 		"build.pixel.prod": "bun build src/pixel.ts --outdir ./dist --minify",
-		"prepublish": "bun run build.pixel.prod"
+		"build.server": "bun run types && bun build src/server/index.ts --outdir ./dist/server",
+		"build.server.prod": "bun run types && bun build src/server/index.ts --outdir ./dist/server --minify"
 	},
 	"devDependencies": {
 		"bun-types": "latest",

package/dist/pixel.js

@@ -1 +0,0 @@
-class n{namespace;constructor({namespace:r}){this.namespace=r}getItem(r){let t=localStorage.getItem(`${this.namespace}.${r}`)||"";try{return JSON.parse(t)}catch(e){return null}}setItem(r,t){localStorage.setItem(`${this.namespace}.${r}`,JSON.stringify(t))}removeItem(r){localStorage.removeItem(`${this.namespace}.${r}`)}}var u=new n({namespace:"userpath"});class c{baseUrl;siteId;queue=[];flushInterval=null;constructor(r){this.baseUrl=r.baseUrl||"",this.siteId=r.siteId,this.flushInterval=window.setInterval(()=>this.flush(),5000)}track(r){if(this.queue.push(r),this.queue.length>=10)this.flush()}flush(){if(this.queue.length===0)return;let r=[...this.queue];this.queue=[],fetch(`${this.baseUrl}/events`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({siteId:this.siteId,sessionId:this.getSessionId(),timestamp:new Date().toISOString(),userAgent:navigator.userAgent,screenWidth:window.screen.width,screenHeight:window.screen.height,language:navigator.language,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone,events:r}),keepalive:!0}).catch((t)=>{this.queue=[...r,...this.queue].slice(0,100),console.error("Error sending analytics data:",t)})}getSessionId(){let r=u.getItem("session_id");if(!r)r=this.generateId(),u.setItem("session_id",r);return r}generateId(){return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,function(r){let t=Math.random()*16|0;return(r==="x"?t:t&3|8).toString(16)})}}class o{api;constructor(r){this.api=r}trackPageView(){let r={type:"pageview",url:window.location.href,referrer:document.referrer,title:document.title};this.api.track(r)}trackCustomEvent(r,t={}){let e={type:"event",name:r,properties:t};this.api.track(e)}trackPurchase(r){let t={type:"purchase",...r};this.api.track(t)}}class g{api;anonymousId=null;currentUser=null;constructor(r){this.api=r;this.anonymousId=this.getStoredAnonymousId()}getAnonymousId(){if(!this.anonymousId)this.anonymousId=this.api.generateId(),localStorage.setItem("up_anonymous_id",this.anonymousId);return this.anonymousId}getUserId(){return this.currentUser?.userId||null}identify(r){this.currentUser=r,this.api.track({type:"identify",anonymousId:this.getAnonymousId(),...r})}getStoredAnonymousId(){return localStorage.getItem("up_anonymous_id")}}class p{api;events;constructor(r){this.api=r;this.events=new o(r),this.initialize()}initialize(){this.events.trackPageView(),this.setupHistoryChange()}setupHistoryChange(){let{pushState:r,replaceState:t}=history;history.pushState=(...e)=>{r.apply(history,e),this.events.trackPageView()},history.replaceState=(...e)=>{t.apply(history,e),this.events.trackPageView()},window.addEventListener("popstate",()=>{this.events.trackPageView()})}}class m{events;session;identity;constructor(r){let t=new c(r);this.events=new o(t),this.session=new p(t),this.identity=new g(t)}getAnonymousId(){return this.identity.getAnonymousId()}getUserId(){return this.identity.getUserId()}identify(r){this.identity.identify(r)}trackPageView(){this.events.trackPageView()}trackEvent(r,t={}){this.events.trackCustomEvent(r,t)}trackPurchase(r){this.events.trackPurchase(r)}}var w=typeof window!=="undefined";document.addEventListener("DOMContentLoaded",()=>{if(!w)return;try{let r=document.querySelector("[data-up]").getAttribute("data-up")||"",t=document.querySelector("[data-up]").getAttribute("src")||"",a=new URL(t).origin+"/v1",d=new m({siteId:r,baseUrl:a});window.userpath=d,setTimeout(()=>{console.log(r,a,d)},1000)}catch(r){console.error(r)}});

package/examples/usage.ts

@@ -1,83 +0,0 @@
-// Example code showing how the client SDK should handle user identity resolution
-
-import { UserPath } from '../src';
-
-// Initialize the tracking SDK
-const userpath = new UserPath({
-	siteId: 'site_123', // Required
-	baseUrl: 'https://api.userpath.to/v1', // Optional
-});
-
-// When a user first visits the site, they get an anonymous ID
-// This is stored in local storage
-const anonymousId = userpath.getAnonymousId();
-console.log('Anonymous visitor ID:', anonymousId);
-
-// Example: Track a page view (this is done automatically on initialization)
-// But you can also track it manually if needed
-userpath.trackPageView();
-
-// Example: Track a custom event (like clicking the purchase button)
-function onPurchaseButtonClick() {
-	userpath.trackEvent('click_purchase', {
-		buttonId: 'purchase-btn',
-		plan: 'premium',
-	});
-}
-
-// Example: When user identifies themselves (e.g., signs up or logs in)
-function onUserIdentified(user: { id: string; email: string; name: string }) {
-	// Identify the user and connect them to their anonymous activity
-	userpath.identify({
-		userId: user.id,
-		email: user.email,
-		name: user.name,
-	});
-
-	console.log('User identified:', userpath.getUserId());
-}
-
-// Example: Track a purchase event
-function trackPurchase(purchaseDetails: {
-	productId: string;
-	price: number;
-	currency: string;
-	plan: string;
-	couponApplied?: string;
-}) {
-	userpath.trackPurchase({
-		productId: purchaseDetails.productId,
-		price: purchaseDetails.price,
-		currency: purchaseDetails.currency,
-		properties: {
-			plan: purchaseDetails.plan,
-			couponApplied: purchaseDetails.couponApplied,
-			// Include user identification if available
-			userId: userpath.getUserId(),
-			anonymousId: userpath.getAnonymousId(),
-		},
-	});
-}
-
-// Example usage flow:
-
-// 1. SDK is initialized and first pageview is tracked automatically
-
-// 2. User clicks purchase button while still anonymous
-onPurchaseButtonClick();
-
-// 3. User signs up or logs in
-onUserIdentified({
-	id: 'user_123',
-	email: 'john@example.com',
-	name: 'John Doe',
-});
-
-// 4. User completes a purchase (now as an identified user)
-trackPurchase({
-	productId: 'plan_premium',
-	price: 1337,
-	currency: 'USD',
-	plan: 'Premium Annual',
-	couponApplied: 'WELCOME20',
-});