@aippy/runtime 0.2.7-dev.3 → 0.2.7-dev.5

package/dist/user/bridge.d.ts

@@ -1,160 +1,29 @@
 /**
  * User SDK Bridge
- * Handles communication with:
- * - iOS native layer via window.webkit.aippyListener
- * - Parent window via postMessage (iframe scenario)
- */
-/**
- * User credentials
  */
+export { isInIframe } from '../utils/platform';
 export interface IOSUserCredentials {
     uid: string;
     token: string;
     apiBaseUrl?: string;
 }
-/**
- * User information (extended profile data)
- */
 export interface IOSUserInfo {
     uid: string;
     displayName?: string;
     nickname?: string;
+    nickName?: string;
     username?: string;
     photoUrl?: string;
     avatar?: string;
-    email?: string;
-    phone?: string;
-    bio?: string;
-    online?: boolean;
     [key: string]: unknown;
 }
-/**
- * Check if running inside an iframe
- */
-export declare function isInIframe(): boolean;
-/**
- * Request user credentials from parent window (iframe scenario)
- * Parent window should respond with postMessage containing credentials
- *
- * @param timeoutMs - Timeout in milliseconds (default: 5000)
- * @returns Promise resolving to user credentials
- */
-export declare function requestCredentialsFromParent(timeoutMs?: number): Promise<IOSUserCredentials>;
-/**
- * Request user info from parent window (iframe scenario)
- * Parent window should respond with postMessage containing user info
- * IMPORTANT: This method does NOT cache - it always requests fresh data
- *
- * @param timeoutMs - Timeout in milliseconds (default: 5000)
- * @returns Promise resolving to user info (null if unavailable)
- */
-export declare function requestUserInfoFromParent(timeoutMs?: number): Promise<IOSUserInfo | null>;
-/**
- * Try to get credentials from parent localStorage directly
- * This works when same-origin, otherwise falls back to postMessage
- *
- * localStorage format:
- * - token: JWT string
- * - user: JSON string with { uid, nickName, ... }
- */
-export declare function tryGetCredentialsFromParentStorage(): IOSUserCredentials | null;
-/**
- * Try to get user info from parent localStorage directly
- * This works when same-origin, otherwise falls back to postMessage
- * IMPORTANT: This method does NOT cache - it always reads fresh data from parent
- *
- * localStorage format:
- * - user: JSON string with { uid, nickName, username, avatar, ... }
- *
- * @returns User info or null if unavailable
- */
-export declare function tryGetUserInfoFromParentStorage(): IOSUserInfo | null;
-/**
- * Request user credentials from iOS native layer
- * Uses aippyRuntime's message passing mechanism
- *
- * @param timeoutMs - Timeout in milliseconds (default: 5000)
- * @returns Promise resolving to user credentials (empty if unavailable)
- */
-export declare function requestCredentialsFromiOS(timeoutMs?: number): Promise<IOSUserCredentials>;
-/**
- * Receive credentials directly from iOS or parent window
- * Called via: window.processUserCredentials(data)
- */
-export declare function processUserCredentials(data: unknown): void;
-/**
- * Receive user info directly from iOS or parent window
- * Called via: window.processUserInfo(data)
- */
-export declare function processUserInfo(data: unknown): void;
-/**
- * Request user info from iOS native layer
- * This method caches the result and won't request again unless forced
- *
- * @param forceRefresh - Force refresh even if cached (default: false)
- * @param timeoutMs - Timeout in milliseconds (default: 5000)
- * @returns Promise resolving to user info (null if unavailable)
- */
-export declare function requestUserInfoFromiOS(forceRefresh?: boolean, timeoutMs?: number): Promise<IOSUserInfo | null>;
-/**
- * Get user info asynchronously
- * Returns cached user info if available, otherwise requests from iOS
- *
- * @param forceRefresh - Force refresh even if cached (default: false)
- * @returns Promise resolving to user info, or null if unavailable
- */
+/** Get auth token async, auto-detects environment */
+export declare function getAuthTokenAsync(): Promise<string>;
+/** Get user info async, auto-detects environment */
 export declare function getUserInfoAsync(forceRefresh?: boolean): Promise<IOSUserInfo | null>;
-/**
- * Get user info from parent window (iframe scenario)
- * IMPORTANT: This method ALWAYS fetches fresh data, NO caching
- *
- * Strategy:
- * 1. Try to get from parent localStorage (same-origin, faster)
- * 2. If cross-origin, use postMessage (slower but works cross-origin)
- *
- * @param timeoutMs - Timeout for postMessage request (default: 5000)
- * @returns Promise resolving to fresh user info, or null if unavailable
- */
+/** Get user info from parent window (iframe only, no cache) */
 export declare function getUserInfoFromParent(timeoutMs?: number): Promise<IOSUserInfo | null>;
-/**
- * Get cached user info (synchronous, may be null if not yet received)
- */
-export declare function getCachedUserInfo(): IOSUserInfo | null;
-/**
- * Check if user info has been received
- */
-export declare function hasUserInfo(): boolean;
-/**
- * Clear cached user info (useful for logout)
- */
-export declare function clearCachedUserInfo(): void;
-/**
- * Initialize bridge and expose to window
- */
-export declare function initUserBridge(): void;
-/**
- * Auto-request credentials on SDK load
- * Tries multiple sources in order:
- * 1. iOS native bridge (if available)
- * 2. Parent localStorage (if in iframe, same-origin)
- * 3. Parent postMessage (if in iframe, cross-origin)
- */
-export declare function autoRequestCredentials(): Promise<void>;
-/**
- * 异步获取 Auth Token
- */
-export declare function getAuthTokenAsync(): Promise<string>;
-/**
- * Get current user ID asynchronously
- * Waits for credentials if not already available
- * @returns Promise resolving to user ID string, or "" if unavailable
- */
-export declare function getCurrentUserIdAsync(): Promise<string>;
-/**
- * Check if credentials have been received
- */
-export declare function hasCredentials(): boolean;
-/**
- * Get cached credentials (synchronous, may be null if not yet received)
- */
-export declare function getCachedCredentials(): IOSUserCredentials | null;
+/** Called by iOS/Android: window.processUserCredentials(data) */
+export declare function processUserCredentials(data: unknown): void;
+/** Called by iOS/Android: window.processUserInfo(data) */
+export declare function processUserInfo(data: unknown): void;

package/dist/user/config.d.ts

@@ -1,21 +1,12 @@
-import { UserSdkConfig } from './types';
 /**
- * Initialize user SDK configuration
- */
-export declare function initUserSdk(config: Partial<UserSdkConfig>): void;
-/**
- * Get current user SDK configuration
- */
-export declare function getUserSdkConfig(): UserSdkConfig;
-/**
- * Update auth token
+ * User SDK Config (internal)
  */
+interface UserSdkConfig {
+    apiBaseUrl: string;
+    authToken: string;
+    currentUserId: string | null;
+}
+export declare function initUserSdk(partial: Partial<UserSdkConfig>): void;
 export declare function setAuthToken(token: string): void;
-/**
- * Update current user ID
- */
 export declare function setCurrentUserId(userId: string | null): void;
-/**
- * Get current auth token synchronously
- */
-export declare function getAuthToken(): string;
+export {};

package/dist/user/hooks.d.ts

@@ -1,74 +1,12 @@
-import { UserProfileQueryResult, UserProfilesQueryResult, GetUserProfileByIdOptions, GetJoinedUserProfilesOptions } from './types';
-import { getAuthToken } from './config';
 /**
- * Hook to get current user ID
- * @returns Current user ID or null
- */
-export declare function useCurrentUserId(): string | null;
-/**
- * Hook to get current auth token
- * @returns Current auth token string
- */
-export declare function useAuthToken(): string;
-/**
- * Hook to get current user's profile
- * @returns Query result with current user profile data
- */
-export declare function useGetCurrentUserProfileQuery(): UserProfileQueryResult;
-/**
- * Hook to get user profile by ID
- * @param options - Options containing user ID to fetch
- * @returns Query result with user profile data
- */
-export declare function useGetUserProfileByIdQuery(options: GetUserProfileByIdOptions): UserProfileQueryResult;
-/**
- * Hook to get all joined user profiles
- * @param options - Options for filtering users
- * @returns Query result with user profiles array
- *
- * Note: This is a simplified implementation that only fetches the current user.
- * In production, this would fetch all users from a users list API.
- */
-export declare function useGetJoinedUserProfilesQuery(options?: GetJoinedUserProfilesOptions): UserProfilesQueryResult;
-/**
- * Synchronous function to get current user ID
- * Use this in non-React contexts
- */
-export declare function getCurrentUserId(): string | null;
-export { getAuthToken };
-/**
- * Hook to get user info from iOS or parent window (no backend API)
- * Automatically detects environment (iOS App or iframe) and uses appropriate method
- *
- * Uses module-level cache to avoid duplicate requests when used in multiple components
- *
- * @returns User info with avatar, nickName, username, uid
- *
- * @example
- * ```typescript
- * const { avatar, nickName, username, uid } = useUserInfo();
- *
- * <Avatar>
- *   <AvatarImage src={avatar} />
- *   <AvatarFallback>{nickName[0]}</AvatarFallback>
- * </Avatar>
- * <span>{nickName}</span>
- * ```
+ * User SDK Hooks
  */
+/** Hook to get user info (avatar, nickName, username, uid) */
 export declare function useUserInfo(): {
     avatar: string;
     nickName: string;
     username: string;
     uid: string;
 };
-/**
- * Clear the cached user info
- * Useful when user logs out or switches account
- *
- * @example
- * ```typescript
- * // When user logs out
- * clearUserInfoCache();
- * ```
- */
+/** Clear cached user info */
 export declare function clearUserInfoCache(): void;

package/dist/user/index.d.ts

@@ -1,12 +1,6 @@
 /**
- * User SDK module
- * Provides user profile fetching and session management
+ * User SDK
  */
-export type { UserProfile, UserProfileQueryResult, UserProfilesQueryResult, GetUserProfileByIdOptions, GetJoinedUserProfilesOptions, FormatDateOptions, UserSessionInfoInterface, UserSdkConfig, } from './types';
-export { initUserSdk, getUserSdkConfig, setAuthToken, setCurrentUserId, } from './config';
-export { useCurrentUserId, useAuthToken, useGetCurrentUserProfileQuery, useGetUserProfileByIdQuery, useGetJoinedUserProfilesQuery, getCurrentUserId, getAuthToken, useUserInfo, // Simple hook for iOS/iframe user info
-clearUserInfoCache, } from './hooks';
-export { fetchUserProfile, clearProfileCache } from './api';
-export { userSessionInfo } from './userSessionInfo';
-export { isInIframe, requestCredentialsFromiOS, requestCredentialsFromParent, tryGetCredentialsFromParentStorage, initUserBridge, autoRequestCredentials, getAuthTokenAsync, getCurrentUserIdAsync, hasCredentials, getCachedCredentials, requestUserInfoFromiOS, getUserInfoAsync, getCachedUserInfo, hasUserInfo, clearCachedUserInfo, requestUserInfoFromParent, tryGetUserInfoFromParentStorage, getUserInfoFromParent, } from './bridge';
+export { useUserInfo, clearUserInfoCache } from './hooks';
+export { getAuthTokenAsync, isInIframe } from './bridge';
 export type { IOSUserCredentials, IOSUserInfo } from './bridge';

package/dist/user/index.js

@@ -1,38 +1,9 @@
-import { f as r, q as a, b as t, h as n, l as o, o as u, j as i, n as f, w as U, g as d, k as I, p as C, e as g, i as l, c, d as h, r as m, u as P, m as y, s as k, a as A, t as F, v as S } from "../bridge-N9ELFpfV.js";
-import { i as G, f as T, h as p, g as Q, a as b, u as j, b as x, d as B, c as O, e as v, j as w } from "../userSessionInfo-DFvsuELU.js";
+import { c as o, u as s } from "../hooks-CE9cjXHP.js";
+import { getAuthTokenAsync as f } from "../bridge-Ca3H2iN1.js";
+import { i as t } from "../ui-y5N62DqC.js";
 export {
-  r as autoRequestCredentials,
-  a as clearCachedUserInfo,
-  G as clearProfileCache,
-  T as clearUserInfoCache,
-  p as fetchUserProfile,
-  t as getAuthToken,
-  n as getAuthTokenAsync,
-  o as getCachedCredentials,
-  u as getCachedUserInfo,
-  Q as getCurrentUserId,
-  i as getCurrentUserIdAsync,
-  f as getUserInfoAsync,
-  U as getUserInfoFromParent,
-  d as getUserSdkConfig,
-  I as hasCredentials,
-  C as hasUserInfo,
-  g as initUserBridge,
-  l as initUserSdk,
-  c as isInIframe,
-  h as requestCredentialsFromParent,
-  m as requestCredentialsFromiOS,
-  P as requestUserInfoFromParent,
-  y as requestUserInfoFromiOS,
-  k as setAuthToken,
-  A as setCurrentUserId,
-  F as tryGetCredentialsFromParentStorage,
-  S as tryGetUserInfoFromParentStorage,
-  b as useAuthToken,
-  j as useCurrentUserId,
-  x as useGetCurrentUserProfileQuery,
-  B as useGetJoinedUserProfilesQuery,
-  O as useGetUserProfileByIdQuery,
-  v as useUserInfo,
-  w as userSessionInfo
+  o as clearUserInfoCache,
+  f as getAuthTokenAsync,
+  t as isInIframe,
+  s as useUserInfo
 };

package/dist/user/types.d.ts

@@ -1,113 +1,10 @@
 /**
- * User SDK types and interfaces
- */
-/**
- * Global type declarations for User SDK iOS bridge
- * Note: webkit.messageHandlers.aippyListener is already declared in tweaks/types.ts
+ * User SDK Types
  */
 declare global {
     interface Window {
-        /** User credentials callback from iOS */
         processUserCredentials?: (data: unknown) => void;
-        /** User info callback from iOS */
         processUserInfo?: (data: unknown) => void;
     }
 }
-/**
- * User profile data structure
- */
-export interface UserProfile {
-    /** User unique identifier */
-    id: string;
-    /** Display name */
-    displayName: string;
-    /** Username (for @mentions) */
-    username: string;
-    /** Avatar URL */
-    photoUrl?: string;
-    /** Online status */
-    online?: boolean;
-    /** User bio */
-    bio?: string;
-    /** Cover image URL */
-    coverImageUrl?: string;
-    /** Additional metadata */
-    [key: string]: unknown;
-}
-/**
- * Query result for user profile
- */
-export interface UserProfileQueryResult {
-    /** User profile data */
-    data: UserProfile | null;
-    /** Loading state */
-    isLoading: boolean;
-    /** Error state */
-    isError: boolean;
-    /** Error object */
-    error: Error | null;
-    /** Refetch function */
-    refetch: () => Promise<void>;
-}
-/**
- * Options for getting user profile by ID
- */
-export interface GetUserProfileByIdOptions {
-    /** User ID to fetch */
-    id: string;
-}
-/**
- * Options for getting joined user profiles
- */
-export interface GetJoinedUserProfilesOptions {
-    /** Whether to include current user */
-    includeSelf?: boolean;
-}
-/**
- * Query result for multiple user profiles
- */
-export interface UserProfilesQueryResult {
-    /** User profiles array */
-    data: UserProfile[];
-    /** Loading state */
-    isLoading: boolean;
-    /** Error state */
-    isError: boolean;
-    /** Error object */
-    error: Error | null;
-    /** Refetch function */
-    refetch: () => Promise<void>;
-}
-/**
- * Date format options
- */
-export interface FormatDateOptions {
-    /** Timestamp in milliseconds */
-    timestampMs: number;
-    /** Format string (e.g., 'MMM d, h:mm a') */
-    formatString: string;
-}
-/**
- * User session info interface
- */
-export interface UserSessionInfoInterface {
-    /** Get current user ID synchronously */
-    getCurrentUserId: () => string | null;
-    /** Get current timestamp in milliseconds */
-    getTimestampInMs: () => number;
-    /** Format date with given format string */
-    formatDate: (options: FormatDateOptions) => string;
-}
-/**
- * User SDK configuration
- */
-export interface UserSdkConfig {
-    /** API base URL */
-    apiBaseUrl: string;
-    /** Auth token */
-    authToken: string;
-    /** Current user ID */
-    currentUserId: string | null;
-    /** Cache time in milliseconds */
-    cacheTime?: number;
-}
+export {};

package/dist/utils/index.js

@@ -1,11 +1,13 @@
-import { P as a, p as s, s as t } from "../ui-D6IZ1jrR.js";
-import { a as p, P as f, p as m, b as P } from "../pwa-CilSlaik.js";
+import { P as o, c as s, i as e, p as t, s as m } from "../ui-y5N62DqC.js";
+import { a as f, P as i, p as n, b as c } from "../pwa-CilSlaik.js";
 export {
-  p as PWAUtils,
-  f as PerformanceMonitor,
-  a as PlatformDetector,
-  m as performanceMonitor,
-  s as platform,
-  P as pwa,
-  t as showAlert
+  f as PWAUtils,
+  i as PerformanceMonitor,
+  o as PlatformDetector,
+  s as compareVersions,
+  e as isInIframe,
+  n as performanceMonitor,
+  t as platform,
+  c as pwa,
+  m as showAlert
 };

package/dist/utils/platform.d.ts

@@ -7,6 +7,34 @@ interface PlatformInfo {
     isMobile: boolean;
     isDesktop: boolean;
 }
+/**
+ * Minimum app version configuration
+ */
+export interface AppVersionConfig {
+    iOS: string;
+    Android: string;
+}
+/**
+ * App environment check result
+ */
+export interface AppEnvironmentCheckResult {
+    type: 'new_app' | 'old_ios_app' | 'old_android_app' | 'iframe' | 'web';
+    isValid: boolean;
+    aippyInfo?: {
+        platform: 'iOS' | 'Android';
+        version: string;
+    } | null;
+    message?: string;
+}
+/**
+ * Check if running inside an iframe
+ */
+export declare function isInIframe(): boolean;
+/**
+ * Compare version numbers
+ * @returns -1 if v1 < v2, 0 if v1 == v2, 1 if v1 > v2
+ */
+export declare function compareVersions(version1: string, version2: string): number;
 /**
  * Platform detection utilities
  */
@@ -17,6 +45,10 @@ export declare class PlatformDetector {
      * Get platform information
      */
     getPlatformInfo(): PlatformInfo;
+    /**
+     * Get raw UA parser result
+     */
+    getRawParserResult(): import('ua-parser-js').IResult;
     /**
      * Get platform capabilities
      */
@@ -42,7 +74,16 @@ export declare class PlatformDetector {
      */
     isAndroidChrome(): boolean;
     /**
-     * 解析 User-Agent 中的 Aippy App 信息
+     * Check if running in Android WebView (old app version)
+     * Detects by checking if browser name contains "webview"
+     */
+    isAndroidWebView(): boolean;
+    /**
+     * Check app environment and validate version
+     */
+    checkAppEnvironment(minVersions: AppVersionConfig): AppEnvironmentCheckResult;
+    /**
+     * Parse Aippy App info from User-Agent
      */
     parseAippyInfo(): {
         platform: 'iOS' | 'Android';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aippy/runtime",
-  "version": "0.2.7-dev.3",
+  "version": "0.2.7-dev.5",
   "description": "Aippy Runtime SDK - Runtime SDK for Aippy projects",
   "private": false,
   "type": "module",