@tiun/types 0.2.0 → 0.3.0

package/README.md

@@ -34,6 +34,21 @@ The global `tiun` object is typed:
 
 ```typescript
 tiun.init({ snippetId: 'your-snippet-id' });
+
+// Authentication
+tiun.login();
+tiun.logout();
+
+const { isAuthenticated, user } = tiun.getUser();
+
+// Events
+tiun.on('userChange', (event) => {
+  console.log(event.isAuthenticated, event.user);
+});
+tiun.on('login', (event) => console.log(event.user.email));
+tiun.on('logout', () => {});
+
+// Paywall
 tiun.on('paywallShow', ({ isConnected }) => {});
 tiun.checkout({ productId: 'prod_123' });
 ```

package/index.d.ts

@@ -16,7 +16,14 @@
 
 export type ContentType = 'active' | 'inactive' | 'paused';
 export type MediaType = 'text' | 'audio' | 'video';
-export type TiunEventType = 'ready' | 'paywallShow' | 'paywallHide' | 'error';
+export type TiunEventType =
+  | 'ready'
+  | 'paywallShow'
+  | 'paywallHide'
+  | 'error'
+  | 'userChange'
+  | 'login'
+  | 'logout';
 
 // =============================================================================
 // Configuration
@@ -71,6 +78,21 @@ export interface TiunConfig {
    */
   onPaywallHide?: (data: PaywallHideEvent) => void;
 
+  /**
+   * Called on user state changes (init + every subsequent change)
+   */
+  onUserChange?: (data: UserChangeEvent) => void;
+
+  /**
+   * Called when user logs in
+   */
+  onLogin?: (data: LoginEvent) => void;
+
+  /**
+   * Called when user logs out
+   */
+  onLogout?: () => void;
+
   /**
    * Called on any error
    */
@@ -106,6 +128,27 @@ export interface TiunError {
   details?: unknown;
 }
 
+export interface UserInfo {
+  userId: string;
+  email: string;
+  productAccess: string[];
+}
+
+export interface UserChangeEvent {
+  event: 'init' | 'login' | 'checkout' | 'logout' | 'update';
+  isAuthenticated: boolean;
+  user: UserInfo | null;
+}
+
+export interface LoginEvent {
+  user: UserInfo;
+}
+
+export interface GetUserResponse {
+  isAuthenticated: boolean;
+  user: UserInfo | null;
+}
+
 // =============================================================================
 // Checkout Options
 // =============================================================================
@@ -168,6 +211,28 @@ export interface TiunSDK {
    */
   setContent(options: ContentOptions): Promise<void>;
 
+  /**
+   * Open the OTP login modal for returning subscribers.
+   */
+  login(): Promise<void>;
+
+  /**
+   * Clear session and fire logout + userChange events.
+   */
+  logout(): void;
+
+  /**
+   * Returns the cached user state. Does not call the backend —
+   * the snippet keeps user info in sync automatically.
+   */
+  getUser(): GetUserResponse;
+
+  /**
+   * Returns a signed JWT for server-to-server user verification.
+   * Valid for 5 minutes. Returns null if the user is not authenticated.
+   */
+  getUserVerificationToken(): Promise<string | null>;
+
   /**
    * Subscribe to an event. Returns unsubscribe function.
    */
@@ -181,6 +246,12 @@ export interface TiunSDK {
     callback: (data: PaywallHideEvent) => void
   ): () => void;
   on(event: 'error', callback: (error: TiunError) => void): () => void;
+  on(
+    event: 'userChange',
+    callback: (data: UserChangeEvent) => void
+  ): () => void;
+  on(event: 'login', callback: (data: LoginEvent) => void): () => void;
+  on(event: 'logout', callback: () => void): () => void;
 
   /**
    * Subscribe to an event once (auto-unsubscribes after first fire).
@@ -195,6 +266,12 @@ export interface TiunSDK {
     callback: (data: PaywallHideEvent) => void
   ): () => void;
   once(event: 'error', callback: (error: TiunError) => void): () => void;
+  once(
+    event: 'userChange',
+    callback: (data: UserChangeEvent) => void
+  ): () => void;
+  once(event: 'login', callback: (data: LoginEvent) => void): () => void;
+  once(event: 'logout', callback: () => void): () => void;
 
   /**
    * Destroy the SDK and cleanup all listeners.
@@ -214,6 +291,12 @@ export interface TiunSDK {
 
   /** Whether the snippet is ready */
   readonly isReady: boolean;
+
+  /** Whether the user is identified (has valid session) */
+  readonly isAuthenticated: boolean;
+
+  /** Current user info or null */
+  readonly user: UserInfo | null;
 }
 
 // =============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiun/types",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "TypeScript type definitions for tiun SDK (for script tag users)",
   "types": "./index.d.ts",
   "files": [