@gofreego/tsutils 0.1.14 → 0.1.15

package/dist/index.d.ts

@@ -1,8 +1,236 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode, CSSProperties } from 'react';
 import { AlertColor, IconButtonProps } from '@mui/material';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Highlighter } from 'shiki';
 
+declare function NotFoundPage(): react_jsx_runtime.JSX.Element;
+
+interface HttpClientConfig {
+    baseURL?: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+interface RequestConfig extends Omit<RequestInit, 'body'> {
+    params?: Record<string, string | number | boolean>;
+    data?: any;
+    timeout?: number;
+}
+interface HttpResponse<T = any> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Headers;
+}
+interface ErrorData {
+    code: number;
+    message: string;
+}
+interface HttpError extends Error {
+    status?: number;
+    statusText?: string;
+    data?: ErrorData;
+}
+
+declare class HttpClient {
+    private baseURL;
+    private timeout;
+    private defaultHeaders;
+    constructor(config?: HttpClientConfig);
+    private buildURL;
+    private request;
+    setDefaultHeader(key: string, value: string): void;
+    removeDefaultHeader(key: string): void;
+    getDefaultHeaders(): Record<string, string>;
+    get<T = any>(url: string, config?: RequestConfig): Promise<HttpResponse<T>>;
+    post<T = any>(url: string, data?: any, config?: RequestConfig): Promise<HttpResponse<T>>;
+    put<T = any>(url: string, data?: any, config?: RequestConfig): Promise<HttpResponse<T>>;
+    patch<T = any>(url: string, data?: any, config?: RequestConfig): Promise<HttpResponse<T>>;
+    delete<T = any>(url: string, config?: RequestConfig): Promise<HttpResponse<T>>;
+}
+declare function extractErrorMessage(error: any): string;
+
+interface User {
+    id: string;
+    uuid: string;
+    username: string;
+    email?: string | undefined;
+    phone?: string | undefined;
+    /** Display name for the user */
+    name?: string | undefined;
+    /** URL to user's avatar image */
+    avatarUrl?: string | undefined;
+    emailVerified: boolean;
+    phoneVerified: boolean;
+    deactivated: boolean;
+    isActive: boolean;
+    isLocked: boolean;
+    failedLoginAttempts: number;
+    lastLoginAt?: string | undefined;
+    passwordChangedAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface SignInMetadata {
+    /** Unique device identifier */
+    deviceId?: string | undefined;
+    /** Human-readable device name */
+    deviceName?: string | undefined;
+    /** web, mobile, desktop, tablet */
+    deviceType?: string | undefined;
+    lat?: number | undefined;
+    long?: number | undefined;
+}
+/** SignInRequest for user authentication */
+interface SignInRequest {
+    username: string;
+    password?: string | undefined;
+    otp?: string | undefined;
+    rememberMe?: boolean | undefined;
+    metadata?: SignInMetadata | undefined;
+    profiles?: boolean | undefined;
+    includePermissions?: boolean | undefined;
+    verificationId?: string | undefined;
+}
+/** SignInResponse with authentication tokens and user data */
+interface SignInResponse {
+    accessToken: string;
+    refreshToken: string;
+    /** Access token expiration (Unix timestamp) */
+    expiresAt: string;
+    /** Refresh token expiration (Unix timestamp) */
+    refreshExpiresAt: string;
+    user: User | undefined;
+    /** Session UUID for tracking */
+    sessionId: string;
+    message: string;
+}
+/** RefreshTokenRequest to refresh access token */
+interface RefreshTokenRequest {
+    refreshToken: string;
+    deviceId?: string | undefined;
+    profiles?: boolean | undefined;
+    includePermissions?: boolean | undefined;
+}
+/** RefreshTokenResponse with new tokens */
+interface RefreshTokenResponse {
+    accessToken: string;
+    /** New refresh token (rotation) */
+    refreshToken: string;
+    expiresAt: string;
+    refreshExpiresAt: string;
+    message: string;
+}
+/** LogoutRequest to end user session */
+interface LogoutRequest {
+    /** Specific session to logout */
+    sessionId?: string | undefined;
+    /** Logout from all devices */
+    allSessions?: boolean | undefined;
+}
+/** LogoutResponse */
+interface LogoutResponse {
+    success: boolean;
+    message: string;
+    /** Number of sessions ended */
+    sessionsTerminated: number;
+}
+/** GenerateLoginTokenRequest - user is identified from Authorization header */
+interface GenerateLoginTokenRequest {
+    /** Token TTL in seconds (default: 60, max: 300) */
+    ttlSeconds?: number | undefined;
+}
+/** SignInWithLoginTokenRequest - sign in using a single-use login token */
+interface SignInWithLoginTokenRequest {
+    loginToken: string;
+    metadata?: SignInMetadata | undefined;
+    profiles?: boolean | undefined;
+    includePermissions?: boolean | undefined;
+}
+/** GenerateLoginTokenResponse - short-lived single-use token */
+interface GenerateLoginTokenResponse {
+    /** Opaque single-use token (prefix: ltk_) */
+    loginToken: string;
+    /** Unix timestamp (seconds), TTL ~1 min */
+    expiresAt: string;
+}
+
+interface ISessionManager {
+    /** Persist session to localStorage and set the auth header. */
+    save(session: SignInResponse): void;
+    /** Partially update stored session fields (e.g. after token refresh). */
+    patch(updates: Partial<SignInResponse>): void;
+    /** Clear session from localStorage and remove the auth header. */
+    clear(): void;
+    /** Return the full stored session, or null if absent / unparseable. */
+    get(): SignInResponse | null;
+    /** Return the stored access token, or undefined. */
+    getAccessToken(): string | undefined;
+    /** Return the stored refresh token, or undefined. */
+    getRefreshToken(): string | undefined;
+    /** Return the session UUID, or undefined. */
+    getSessionId(): string | undefined;
+    /** True when a non-expired access token is stored. */
+    isAuthenticated(): boolean;
+    /** Called on app startup: restore the auth header or wipe an expired session. */
+    initialize(): void;
+}
+declare class SessionManager implements ISessionManager {
+    private static instance;
+    private readonly key;
+    private readonly client;
+    private cache;
+    private constructor();
+    static getInstance(client: HttpClient): SessionManager;
+    save(session: SignInResponse): void;
+    patch(updates: Partial<SignInResponse>): void;
+    clear(): void;
+    get(): SignInResponse | null;
+    getAccessToken(): string | undefined;
+    getRefreshToken(): string | undefined;
+    getSessionId(): string | undefined;
+    isAuthenticated(): boolean;
+    initialize(): void;
+    private setAuthToken;
+    private clearAuthToken;
+}
+
+interface IAuthService {
+    signIn(request: SignInRequest): Promise<SignInResponse>;
+    refreshToken(request?: Partial<RefreshTokenRequest>): Promise<RefreshTokenResponse>;
+    logout(request: LogoutRequest): Promise<LogoutResponse>;
+    generateLoginToken(request?: GenerateLoginTokenRequest): Promise<GenerateLoginTokenResponse>;
+    signInWithLoginToken(request: SignInWithLoginTokenRequest): Promise<SignInResponse>;
+    isAuthenticated(): boolean;
+    getAccessToken(): string | undefined;
+    getSessionDetails(): SignInResponse | null;
+    getSessionId(): string | undefined;
+    initializeAuth(): void;
+}
+declare class AuthService implements IAuthService {
+    private static instance;
+    private readonly client;
+    private readonly sessionManager;
+    private constructor();
+    static getInstance(client: HttpClient): AuthService;
+    signIn(request: SignInRequest): Promise<SignInResponse>;
+    refreshToken(request?: Partial<RefreshTokenRequest>): Promise<RefreshTokenResponse>;
+    logout(request: LogoutRequest): Promise<LogoutResponse>;
+    generateLoginToken(request?: GenerateLoginTokenRequest): Promise<GenerateLoginTokenResponse>;
+    signInWithLoginToken(request: SignInWithLoginTokenRequest): Promise<SignInResponse>;
+    isAuthenticated(): boolean;
+    getAccessToken(): string | undefined;
+    getSessionDetails(): SignInResponse | null;
+    getSessionId(): string | undefined;
+    initializeAuth(): void;
+}
+
+interface LoginCallbackPageProps {
+    authService: IAuthService;
+    navigateTo?: string;
+    onLoginFailed?: () => void;
+}
+declare function LoginCallbackPage({ authService, navigateTo, onLoginFailed }: LoginCallbackPageProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Menu item configuration
  */
@@ -495,50 +723,6 @@ declare namespace tokens {
   export { tokens_borderRadius as borderRadius, tokens_elevation as elevation, tokens_fontSize as fontSize, tokens_fontWeight as fontWeight, tokens_lineHeight as lineHeight, tokens_spacing as spacing, tokens_transition as transition, tokens_zIndex as zIndex };
 }
 
-interface HttpClientConfig {
-    baseURL?: string;
-    timeout?: number;
-    headers?: Record<string, string>;
-}
-interface RequestConfig extends Omit<RequestInit, 'body'> {
-    params?: Record<string, string | number | boolean>;
-    data?: any;
-    timeout?: number;
-}
-interface HttpResponse<T = any> {
-    data: T;
-    status: number;
-    statusText: string;
-    headers: Headers;
-}
-interface ErrorData {
-    code: number;
-    message: string;
-}
-interface HttpError extends Error {
-    status?: number;
-    statusText?: string;
-    data?: ErrorData;
-}
-
-declare class HttpClient {
-    private baseURL;
-    private timeout;
-    private defaultHeaders;
-    constructor(config?: HttpClientConfig);
-    private buildURL;
-    private request;
-    setDefaultHeader(key: string, value: string): void;
-    removeDefaultHeader(key: string): void;
-    getDefaultHeaders(): Record<string, string>;
-    get<T = any>(url: string, config?: RequestConfig): Promise<HttpResponse<T>>;
-    post<T = any>(url: string, data?: any, config?: RequestConfig): Promise<HttpResponse<T>>;
-    put<T = any>(url: string, data?: any, config?: RequestConfig): Promise<HttpResponse<T>>;
-    patch<T = any>(url: string, data?: any, config?: RequestConfig): Promise<HttpResponse<T>>;
-    delete<T = any>(url: string, config?: RequestConfig): Promise<HttpResponse<T>>;
-}
-declare function extractErrorMessage(error: any): string;
-
 /**
  * Merges class names together
  * Useful for conditional className composition
@@ -604,179 +788,4 @@ declare class LocalStorage {
 
 declare const getHighlighter: () => Promise<Highlighter>;
 
-interface User {
-    id: string;
-    uuid: string;
-    username: string;
-    email?: string | undefined;
-    phone?: string | undefined;
-    /** Display name for the user */
-    name?: string | undefined;
-    /** URL to user's avatar image */
-    avatarUrl?: string | undefined;
-    emailVerified: boolean;
-    phoneVerified: boolean;
-    deactivated: boolean;
-    isActive: boolean;
-    isLocked: boolean;
-    failedLoginAttempts: number;
-    lastLoginAt?: string | undefined;
-    passwordChangedAt: string;
-    createdAt: string;
-    updatedAt: string;
-}
-interface SignInMetadata {
-    /** Unique device identifier */
-    deviceId?: string | undefined;
-    /** Human-readable device name */
-    deviceName?: string | undefined;
-    /** web, mobile, desktop, tablet */
-    deviceType?: string | undefined;
-    lat?: number | undefined;
-    long?: number | undefined;
-}
-/** SignInRequest for user authentication */
-interface SignInRequest {
-    username: string;
-    password?: string | undefined;
-    otp?: string | undefined;
-    rememberMe?: boolean | undefined;
-    metadata?: SignInMetadata | undefined;
-    profiles?: boolean | undefined;
-    includePermissions?: boolean | undefined;
-    verificationId?: string | undefined;
-}
-/** SignInResponse with authentication tokens and user data */
-interface SignInResponse {
-    accessToken: string;
-    refreshToken: string;
-    /** Access token expiration (Unix timestamp) */
-    expiresAt: string;
-    /** Refresh token expiration (Unix timestamp) */
-    refreshExpiresAt: string;
-    user: User | undefined;
-    /** Session UUID for tracking */
-    sessionId: string;
-    message: string;
-}
-/** RefreshTokenRequest to refresh access token */
-interface RefreshTokenRequest {
-    refreshToken: string;
-    deviceId?: string | undefined;
-    profiles?: boolean | undefined;
-    includePermissions?: boolean | undefined;
-}
-/** RefreshTokenResponse with new tokens */
-interface RefreshTokenResponse {
-    accessToken: string;
-    /** New refresh token (rotation) */
-    refreshToken: string;
-    expiresAt: string;
-    refreshExpiresAt: string;
-    message: string;
-}
-/** LogoutRequest to end user session */
-interface LogoutRequest {
-    /** Specific session to logout */
-    sessionId?: string | undefined;
-    /** Logout from all devices */
-    allSessions?: boolean | undefined;
-}
-/** LogoutResponse */
-interface LogoutResponse {
-    success: boolean;
-    message: string;
-    /** Number of sessions ended */
-    sessionsTerminated: number;
-}
-/** GenerateLoginTokenRequest - user is identified from Authorization header */
-interface GenerateLoginTokenRequest {
-    /** Token TTL in seconds (default: 60, max: 300) */
-    ttlSeconds?: number | undefined;
-}
-/** SignInWithLoginTokenRequest - sign in using a single-use login token */
-interface SignInWithLoginTokenRequest {
-    loginToken: string;
-    metadata?: SignInMetadata | undefined;
-    profiles?: boolean | undefined;
-    includePermissions?: boolean | undefined;
-}
-/** GenerateLoginTokenResponse - short-lived single-use token */
-interface GenerateLoginTokenResponse {
-    /** Opaque single-use token (prefix: ltk_) */
-    loginToken: string;
-    /** Unix timestamp (seconds), TTL ~1 min */
-    expiresAt: string;
-}
-
-interface ISessionManager {
-    /** Persist session to localStorage and set the auth header. */
-    save(session: SignInResponse): void;
-    /** Partially update stored session fields (e.g. after token refresh). */
-    patch(updates: Partial<SignInResponse>): void;
-    /** Clear session from localStorage and remove the auth header. */
-    clear(): void;
-    /** Return the full stored session, or null if absent / unparseable. */
-    get(): SignInResponse | null;
-    /** Return the stored access token, or undefined. */
-    getAccessToken(): string | undefined;
-    /** Return the stored refresh token, or undefined. */
-    getRefreshToken(): string | undefined;
-    /** Return the session UUID, or undefined. */
-    getSessionId(): string | undefined;
-    /** True when a non-expired access token is stored. */
-    isAuthenticated(): boolean;
-    /** Called on app startup: restore the auth header or wipe an expired session. */
-    initialize(): void;
-}
-declare class SessionManager implements ISessionManager {
-    private static instance;
-    private readonly key;
-    private readonly client;
-    private cache;
-    private constructor();
-    static getInstance(client: HttpClient): SessionManager;
-    save(session: SignInResponse): void;
-    patch(updates: Partial<SignInResponse>): void;
-    clear(): void;
-    get(): SignInResponse | null;
-    getAccessToken(): string | undefined;
-    getRefreshToken(): string | undefined;
-    getSessionId(): string | undefined;
-    isAuthenticated(): boolean;
-    initialize(): void;
-    private setAuthToken;
-    private clearAuthToken;
-}
-
-interface IAuthService {
-    signIn(request: SignInRequest): Promise<SignInResponse>;
-    refreshToken(request?: Partial<RefreshTokenRequest>): Promise<RefreshTokenResponse>;
-    logout(request: LogoutRequest): Promise<LogoutResponse>;
-    generateLoginToken(request?: GenerateLoginTokenRequest): Promise<GenerateLoginTokenResponse>;
-    signInWithLoginToken(request: SignInWithLoginTokenRequest): Promise<SignInResponse>;
-    isAuthenticated(): boolean;
-    getAccessToken(): string | undefined;
-    getSessionDetails(): SignInResponse | null;
-    getSessionId(): string | undefined;
-    initializeAuth(): void;
-}
-declare class AuthService implements IAuthService {
-    private static instance;
-    private readonly client;
-    private readonly sessionManager;
-    private constructor();
-    static getInstance(client: HttpClient): AuthService;
-    signIn(request: SignInRequest): Promise<SignInResponse>;
-    refreshToken(request?: Partial<RefreshTokenRequest>): Promise<RefreshTokenResponse>;
-    logout(request: LogoutRequest): Promise<LogoutResponse>;
-    generateLoginToken(request?: GenerateLoginTokenRequest): Promise<GenerateLoginTokenResponse>;
-    signInWithLoginToken(request: SignInWithLoginTokenRequest): Promise<SignInResponse>;
-    isAuthenticated(): boolean;
-    getAccessToken(): string | undefined;
-    getSessionDetails(): SignInResponse | null;
-    getSessionId(): string | undefined;
-    initializeAuth(): void;
-}
-
-export { AuthService, ConfirmDialog, type ConfirmDialogProps, type ErrorData, type GenerateLoginTokenRequest, type GenerateLoginTokenResponse, HttpClient, type HttpClientConfig, type HttpError, type HttpResponse, type IAuthService, type ISessionManager, LocalStorage, type LogoutRequest, type LogoutResponse, type MenuItem, type Notification, type NotificationContextType, NotificationProvider, type NotificationProviderProps, ReadmeViewer, type RefreshTokenRequest, type RefreshTokenResponse, type RequestConfig, type ResolvedThemeMode, SessionManager, SidebarLayout, type SidebarLayoutProps, type SignInMetadata, type SignInRequest, type SignInResponse, type SignInWithLoginTokenRequest, type Theme, type ThemeContextValue, type ThemeMode, ThemeProvider, ThemeToggle, type User, borderRadius, cn, darkTheme, debounce, elevation, extractErrorMessage, fontSize, fontWeight, formatDate, getHighlighter, lightTheme, lineHeight, spacing, throttle, tokens, transition, useNotification, useTheme, zIndex };
+export { AuthService, ConfirmDialog, type ConfirmDialogProps, type ErrorData, type GenerateLoginTokenRequest, type GenerateLoginTokenResponse, HttpClient, type HttpClientConfig, type HttpError, type HttpResponse, type IAuthService, type ISessionManager, LocalStorage, LoginCallbackPage, type LoginCallbackPageProps, type LogoutRequest, type LogoutResponse, type MenuItem, NotFoundPage, type Notification, type NotificationContextType, NotificationProvider, type NotificationProviderProps, ReadmeViewer, type RefreshTokenRequest, type RefreshTokenResponse, type RequestConfig, type ResolvedThemeMode, SessionManager, SidebarLayout, type SidebarLayoutProps, type SignInMetadata, type SignInRequest, type SignInResponse, type SignInWithLoginTokenRequest, type Theme, type ThemeContextValue, type ThemeMode, ThemeProvider, ThemeToggle, type User, borderRadius, cn, darkTheme, debounce, elevation, extractErrorMessage, fontSize, fontWeight, formatDate, getHighlighter, lightTheme, lineHeight, spacing, throttle, tokens, transition, useNotification, useTheme, zIndex };