@outlit/browser 0.0.0-canary-202512180440-754f4ab-20251218044038 → 0.0.0-canary-202601161920-3feb1db-20260116192046

package/dist/{tracker-DFcTv3EM.d.ts → tracker-DK-2gYCi.d.ts}

@@ -45,6 +45,11 @@ interface OutlitOptions extends TrackerConfig {
      */
     idleTimeout?: number;
 }
+interface UserIdentity {
+    email?: string;
+    userId?: string;
+    traits?: Record<string, string | number | boolean | null>;
+}
 declare class Outlit {
     private publicKey;
     private apiHost;
@@ -57,6 +62,8 @@ declare class Outlit {
     private options;
     private hasHandledExit;
     private sessionTracker;
+    private currentUser;
+    private pendingUser;
     constructor(options: OutlitOptions);
     /**
      * Enable tracking. Call this after obtaining user consent.
@@ -79,8 +86,61 @@ declare class Outlit {
     /**
      * Identify the current visitor.
      * Links the anonymous visitor to a known user.
+     *
+     * When email or userId is provided, also sets the current user identity
+     * for stage events (activate, engaged, paid).
      */
     identify(options: BrowserIdentifyOptions): void;
+    /**
+     * Set the current user identity.
+     * This is useful for SPA applications where you know the user's identity
+     * after authentication. Calls identify() under the hood.
+     *
+     * If called before tracking is enabled, the identity is stored as pending
+     * and applied automatically when enableTracking() is called.
+     *
+     * Note: Both setUser() and identify() enable stage events. The difference is
+     * setUser() can be called before tracking is enabled (identity is queued),
+     * while identify() requires tracking to be enabled first.
+     */
+    setUser(identity: UserIdentity): void;
+    /**
+     * Clear the current user identity.
+     * Call this when the user logs out.
+     */
+    clearUser(): void;
+    /**
+     * Apply user identity and send identify event.
+     */
+    private applyUser;
+    /**
+     * Mark the current user as activated.
+     * This is typically called after a user completes onboarding or a key activation milestone.
+     * Requires the user to be identified (via setUser or identify with userId).
+     */
+    activate(properties?: Record<string, string | number | boolean | null>): void;
+    /**
+     * Mark the current user as engaged.
+     * This is typically called when a user reaches a usage milestone.
+     * Can also be computed automatically by the engagement cron.
+     */
+    engaged(properties?: Record<string, string | number | boolean | null>): void;
+    /**
+     * Mark the current user as paid.
+     * This is typically called after a successful payment/subscription.
+     * Can also be triggered by Stripe integration.
+     */
+    paid(properties?: Record<string, string | number | boolean | null>): void;
+    /**
+     * Mark the current user as churned.
+     * This is typically called when a subscription is cancelled.
+     * Can also be triggered by Stripe integration.
+     */
+    churned(properties?: Record<string, string | number | boolean | null>): void;
+    /**
+     * Internal method to send a stage event.
+     */
+    private sendStageEvent;
     /**
      * Get the current visitor ID.
      * Returns null if tracking is not enabled.
@@ -133,5 +193,35 @@ declare function enableTracking(): void;
  * Convenience method that uses the singleton instance.
  */
 declare function isTrackingEnabled(): boolean;
+/**
+ * Set the current user identity.
+ * Convenience method that uses the singleton instance.
+ */
+declare function setUser(identity: UserIdentity): void;
+/**
+ * Clear the current user identity (on logout).
+ * Convenience method that uses the singleton instance.
+ */
+declare function clearUser(): void;
+/**
+ * Mark the current user as activated.
+ * Convenience method that uses the singleton instance.
+ */
+declare function activate(properties?: Record<string, string | number | boolean | null>): void;
+/**
+ * Mark the current user as engaged.
+ * Convenience method that uses the singleton instance.
+ */
+declare function engaged(properties?: Record<string, string | number | boolean | null>): void;
+/**
+ * Mark the current user as paid.
+ * Convenience method that uses the singleton instance.
+ */
+declare function paid(properties?: Record<string, string | number | boolean | null>): void;
+/**
+ * Mark the current user as churned.
+ * Convenience method that uses the singleton instance.
+ */
+declare function churned(properties?: Record<string, string | number | boolean | null>): void;
 
-export { Outlit as O, identify as a, isTrackingEnabled as b, type OutlitOptions as c, enableTracking as e, getInstance as g, init as i, track as t };
+export { Outlit as O, type UserIdentity as U, identify as a, isTrackingEnabled as b, clearUser as c, activate as d, enableTracking as e, engaged as f, getInstance as g, churned as h, init as i, type OutlitOptions as j, paid as p, setUser as s, track as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outlit/browser",
-  "version": "0.0.0-canary-202512180440-754f4ab-20251218044038",
+  "version": "0.0.0-canary-202601161920-3feb1db-20260116192046",
   "description": "Outlit browser tracking SDK with React bindings",
   "license": "Apache-2.0",
   "author": "Outlit AI",
@@ -45,17 +45,21 @@
     "dist"
   ],
   "dependencies": {
-    "@outlit/core": "0.0.0-canary-202512180440-754f4ab-20251218044038"
+    "@outlit/core": "0.0.0-canary-202601161920-3feb1db-20260116192046"
   },
   "devDependencies": {
     "@playwright/test": "^1.48.0",
+    "@testing-library/react": "^14.0.0",
     "@types/node": "^20.0.0",
     "@types/react": "^18.2.0",
+    "jsdom": "^24.0.0",
     "react": "^18.2.0",
+    "react-dom": "^18.2.0",
     "tsup": "^8.0.1",
     "tsx": "^4.0.0",
     "typescript": "^5.3.3",
-    "@outlit/typescript-config": "0.0.0-canary-202512180440-754f4ab-20251218044038"
+    "vitest": "^1.2.1",
+    "@outlit/typescript-config": "0.0.1"
   },
   "peerDependencies": {
     "react": ">=17.0.0"
@@ -73,6 +77,7 @@
     "format": "biome format --write .",
     "typecheck": "tsc --noEmit",
     "test": "playwright test",
+    "test:unit": "vitest run",
     "test:ui": "playwright test --ui",
     "test:headed": "playwright test --headed",
     "serve:test": "tsx ./__tests__/e2e/serve.ts",