@broadcastingplatforms/sdk 0.0.0-dev.9cfcfc6

package/dist/auth-CRWthQ_B.d.ts

@@ -0,0 +1,1176 @@
+/**
+ * Base resource contract for typed endpoint clients.
+ */
+
+/**
+ * Convert query parameters to a URL-encoded string.
+ */
+declare const buildQueryString: (params?: ResourceQueryParams) => string;
+/**
+ * Resource operations supported by SDK namespace clients.
+ */
+interface ResourceOperations {
+    /**
+     * List resource items.
+     * @param params - Query parameters for the list operation.
+     * @param options - HTTP request options.
+     * @returns List response payload.
+     */
+    list(params?: ResourceQueryParams, options?: HttpRequestOptions): Promise<unknown>;
+    /**
+     * Retrieve a resource item by id.
+     * @param id - Resource identifier.
+     * @param options - HTTP request options.
+     * @returns Get response payload.
+     */
+    get(id: ResourceId, options?: HttpRequestOptions): Promise<unknown>;
+    /**
+     * Create a new resource item.
+     * @param payload - Payload for the create operation.
+     * @param options - HTTP request options.
+     * @returns Create response payload.
+     */
+    create(payload: unknown, options?: HttpRequestOptions): Promise<unknown>;
+    /**
+     * Update an existing resource item.
+     * @param id - Resource identifier.
+     * @param payload - Payload for the update operation.
+     * @param options - HTTP request options.
+     * @returns Update response payload.
+     */
+    update(id: ResourceId, payload: unknown, options?: HttpRequestOptions): Promise<unknown>;
+    /**
+     * Delete an existing resource item.
+     * @param id - Resource identifier.
+     * @param options - HTTP request options.
+     * @returns Delete response payload.
+     */
+    delete(id: ResourceId, options?: HttpRequestOptions): Promise<unknown>;
+    /**
+     * Create or update a resource item.
+     * @param id - Resource identifier.
+     * @param payload - Payload for the upsert operation.
+     * @param options - HTTP request options.
+     * @returns Upsert response payload.
+     */
+    upsert(id: ResourceId, payload: unknown, options?: HttpRequestOptions): Promise<unknown>;
+}
+/**
+ * Base resource contract implemented by namespace clients.
+ */
+interface BaseResource extends Partial<ResourceOperations> {
+}
+
+/**
+ * Channels HTTP namespace for the SDK core package.
+ */
+
+/**
+ * Channels namespace client backed by the shared HTTP client.
+ */
+declare class ChannelsClient implements BaseResource {
+    private readonly http;
+    /**
+     * Create a new channels client instance.
+     */
+    constructor(http: HttpClient);
+    /**
+     * Fetch a channel by username.
+     */
+    get(username: ResourceId, options?: HttpRequestOptions): Promise<ChannelResponse>;
+    /**
+     * Follow a channel by slug.
+     */
+    follow(channelSlug: string, options?: HttpRequestOptions): Promise<ChannelResponse>;
+    /**
+     * Unfollow a channel by slug.
+     */
+    unfollow(channelSlug: string, options?: HttpRequestOptions): Promise<ChannelResponse>;
+}
+
+/**
+ * Chat HTTP namespace for the SDK core package.
+ */
+
+/**
+ * Chat namespace client backed by the shared HTTP client.
+ */
+declare class ChatClient implements BaseResource {
+    private readonly http;
+    /**
+     * Create a new chat client instance.
+     */
+    constructor(http: HttpClient);
+    /**
+     * Fetch chat history for a stream.
+     */
+    getMessages(streamId: ResourceId, params?: ChatMessagesQuery, options?: HttpRequestOptions): Promise<ChatMessagesResponse>;
+    /**
+     * Resource-style alias for fetching chat messages by stream id.
+     * @param streamId - Stream identifier.
+     * @param options - Request options.
+     * @returns Chat messages response payload.
+     */
+    get(streamId: ResourceId, options?: HttpRequestOptions): Promise<ChatMessagesResponse>;
+    /**
+     * Send a message to a stream chat.
+     */
+    sendMessage(streamId: ResourceId, message: string, options?: HttpRequestOptions): Promise<ChatMessage>;
+}
+
+/**
+ * Streams namespace client backed by the shared HTTP client.
+ */
+declare class StreamsClient implements BaseResource {
+    private readonly http;
+    /**
+     * Create a new streams client instance.
+     */
+    constructor(http: HttpClient);
+    /**
+     * List active streams.
+     */
+    listActive(options?: HttpRequestOptions): Promise<StreamListResponse>;
+    /**
+     * List streams with optional query params.
+     */
+    list(params?: ResourceQueryParams, options?: HttpRequestOptions): Promise<StreamListResponse>;
+    /**
+     * Fetch a stream by id.
+     */
+    get(streamId: ResourceId, options?: HttpRequestOptions): Promise<StreamResponse>;
+    /**
+     * Fetch a stream by channel slug.
+     * @param userLogin - Channel slug or login handle.
+     * @param options - Request options.
+     * @returns Stream payload when found, otherwise null.
+     */
+    getBySlug(userLogin: string, options?: HttpRequestOptions): Promise<Stream | null>;
+    /**
+     * Fetch the player source payload for the given stream id.
+     */
+    getPlayerSource(streamId: string | number, options?: HttpRequestOptions): Promise<StreamPlayerSource | null>;
+    /**
+     * Normalize stream payloads for get operations.
+     */
+    private extractStreamPayload;
+}
+
+/**
+ * SDK error codes derived from HTTP status codes and network failures.
+ */
+type SdkErrorCode = "authentication_required" | "permission_denied" | "not_found" | "validation_failed" | "rate_limited" | "server_error" | "unknown_error";
+/**
+ * Structured error payload returned by the SDK.
+ */
+interface SdkErrorShape {
+    /**
+     * Canonical error code used by the SDK.
+     */
+    code: SdkErrorCode;
+    /**
+     * HTTP status code when available.
+     */
+    statusCode?: number;
+    /**
+     * Developer-facing error message.
+     */
+    message: string;
+    /**
+     * End-user friendly error message.
+     */
+    userMessage: string;
+    /**
+     * Request metadata (null when unavailable).
+     */
+    request: Request | null;
+    /**
+     * Response metadata (null when unavailable).
+     */
+    response: Response | null;
+}
+/**
+ * SDK error code alias matching SDKError naming.
+ */
+type SDKErrorCode = SdkErrorCode;
+/**
+ * SDK error shape alias matching SDKError naming.
+ */
+type SDKErrorShape = SdkErrorShape;
+/**
+ * Chat message user payload.
+ */
+interface ChatMessageUser {
+    /**
+     * User identifier.
+     */
+    id: number;
+    /**
+     * User nickname.
+     */
+    nick_name?: string;
+    /**
+     * User slug.
+     */
+    slug?: string;
+    /**
+     * Whether the user is a model.
+     */
+    is_model?: boolean;
+    /**
+     * Avatar URL.
+     */
+    avatar_url?: string | null;
+}
+/**
+ * Chat message transaction payload.
+ */
+interface ChatMessageTransaction {
+    /**
+     * Transaction identifier.
+     */
+    id: number;
+    /**
+     * Transaction amount.
+     */
+    amount: number;
+    /**
+     * Transaction type.
+     */
+    type: string;
+}
+/**
+ * Chat message metadata payload.
+ */
+interface ChatMessageMetadata {
+    /**
+     * Message duration.
+     */
+    duration?: number;
+    /**
+     * Message intensity.
+     */
+    intensity?: number;
+    /**
+     * Tip action payload.
+     */
+    tip_action?: string;
+    /**
+     * Reply message reference.
+     */
+    reply_to?: string;
+}
+/**
+ * Chat message payload.
+ */
+interface ChatMessage {
+    /**
+     * Message unique identifier.
+     */
+    uuid?: string;
+    /**
+     * Message body.
+     */
+    message?: string;
+    /**
+     * Message type.
+     */
+    type?: string;
+    /**
+     * Timestamp offset for playback.
+     */
+    timestamp_offset?: number;
+    /**
+     * Message creation timestamp.
+     */
+    created_at?: string;
+    /**
+     * Message author payload.
+     */
+    user?: ChatMessageUser;
+    /**
+     * Stream identifier.
+     */
+    livestream_id?: number;
+    /**
+     * Chat room name.
+     */
+    chat_room?: string;
+    /**
+     * Transaction payload when applicable.
+     */
+    transaction?: ChatMessageTransaction;
+    /**
+     * Metadata payload when applicable.
+     */
+    metadata?: ChatMessageMetadata;
+}
+/**
+ * Query parameters for chat message history.
+ */
+interface ChatMessagesQuery {
+    /**
+     * Timestamp for pagination.
+     */
+    timestamp?: string;
+    /**
+     * Message limit.
+     */
+    limit?: number;
+    /**
+     * Message status filters.
+     */
+    status?: string[] | string;
+    /**
+     * Preserve additional query parameters.
+     */
+    [key: string]: ResourceQueryValue | ResourceQueryValue[] | undefined;
+}
+/**
+ * Chat messages response payload.
+ */
+interface ChatMessagesResponse {
+    /**
+     * Chat messages payload.
+     */
+    data?: ChatMessage[];
+}
+/**
+ * Channel characteristic metadata.
+ */
+interface ChannelCharacteristics {
+    /**
+     * Age data when available.
+     */
+    age?: string;
+    /**
+     * Height data when available.
+     */
+    height?: string | null;
+}
+/**
+ * Tag metadata shared by channel and stream payloads.
+ */
+interface Tag {
+    /**
+     * Tag identifier.
+     */
+    id: number;
+    /**
+     * Tag label.
+     */
+    name: string;
+}
+/**
+ * Channel tag metadata.
+ */
+type ChannelTag = Tag;
+/**
+ * Channel link metadata.
+ */
+interface ChannelLink {
+    /**
+     * Link identifier.
+     */
+    id: number;
+    /**
+     * Provider name.
+     */
+    provider: string | null;
+    /**
+     * Link URL.
+     */
+    url: string;
+    /**
+     * Link update timestamp.
+     */
+    last_updated: string;
+}
+/**
+ * Channel payload returned by the API.
+ */
+interface Channel {
+    /**
+     * Channel identifier.
+     */
+    id: number;
+    /**
+     * Channel nickname.
+     */
+    nick_name?: string;
+    /**
+     * Channel display name.
+     */
+    display_name?: string;
+    /**
+     * Channel login handle.
+     */
+    user_login?: string;
+    /**
+     * Channel slug.
+     */
+    slug?: string;
+    /**
+     * Channel bio.
+     */
+    bio?: string;
+    /**
+     * Channel avatar URL.
+     */
+    avatar_url?: string | null;
+    /**
+     * Channel cover photo URL.
+     */
+    cover_photo_url?: string | null;
+    /**
+     * Channel cover image.
+     */
+    cover_image?: string | null;
+    /**
+     * Follower count.
+     */
+    follower_count?: number;
+    /**
+     * Whether the current user is following this channel.
+     */
+    is_following?: boolean;
+    /**
+     * Whether the channel is active.
+     */
+    is_active?: boolean;
+    /**
+     * Channel characteristics.
+     */
+    characteristics?: ChannelCharacteristics;
+    /**
+     * Channel status.
+     */
+    status?: string;
+    /**
+     * Channel timezone.
+     */
+    timezone?: string;
+    /**
+     * Channel creation timestamp.
+     */
+    created_at?: string;
+    /**
+     * Channel update timestamp.
+     */
+    updated_at?: string;
+    /**
+     * Channel tags.
+     */
+    tags?: ChannelTag[];
+    /**
+     * Channel links.
+     */
+    links?: ChannelLink[];
+}
+/**
+ * Channel response payload including active stream info.
+ */
+interface ChannelResponse {
+    /**
+     * Channel payload.
+     */
+    channel?: Channel;
+    /**
+     * Active stream payload when available.
+     */
+    active_stream?: Stream | null;
+}
+/**
+ * HTTP request shape passed through interceptors.
+ */
+interface HttpRequest {
+    /**
+     * Fully resolved request URL.
+     */
+    url: string;
+    /**
+     * Fetch options for the request.
+     */
+    init: RequestInit;
+}
+/**
+ * Hook invoked before a request is sent.
+ */
+type BeforeRequestHook = (request: HttpRequest) => HttpRequest | void | Promise<HttpRequest | void>;
+/**
+ * Fetch options for SDK HTTP requests.
+ */
+type HttpRequestOptions = RequestInit & {
+    /**
+     * Per-request headers to merge with defaults.
+     */
+    headers?: Record<string, string>;
+};
+/**
+ * Realtime connection state values.
+ */
+type RealtimeConnectionState = "connecting" | "connected" | "unavailable" | "disconnected" | "failed";
+/**
+ * Callback for realtime connection state changes.
+ */
+type RealtimeConnectionStateCallback = (state: RealtimeConnectionState) => void;
+/**
+ * Realtime channel event callback.
+ */
+type RealtimeEventCallback<T = unknown> = (payload: T) => void;
+/**
+ * Realtime channel wrapper interface.
+ */
+interface RealtimeChannel {
+    /**
+     * Listen for a realtime event.
+     */
+    listen<T = unknown>(event: string, callback: RealtimeEventCallback<T>): void;
+    /**
+     * Stop listening for a realtime event.
+     */
+    stopListening<T = unknown>(event?: string, callback?: RealtimeEventCallback<T>): void;
+}
+/**
+ * Realtime presence channel wrapper interface.
+ */
+interface RealtimePresenceChannel extends RealtimeChannel {
+    /**
+     * Get the current members in the channel.
+     * @returns Unsubscribe function for the presence callback.
+     */
+    here(callback: (members: unknown[]) => void): () => void;
+    /**
+     * Listen for members joining the channel.
+     * @returns Unsubscribe function for the presence callback.
+     */
+    joining(callback: (member: unknown) => void): () => void;
+    /**
+     * Listen for members leaving the channel.
+     * @returns Unsubscribe function for the presence callback.
+     */
+    leaving(callback: (member: unknown) => void): () => void;
+}
+/**
+ * Options for configuring the realtime client.
+ */
+interface RealtimeClientOptions {
+    /**
+     * Base API URL used for auth endpoint resolution.
+     */
+    baseUrl?: string;
+    /**
+     * Explicit auth endpoint override.
+     */
+    authEndpoint?: string;
+    /**
+     * Pusher application key.
+     */
+    appKey: string;
+    /**
+     * Websocket host for Pusher connections.
+     */
+    wsHost: string;
+    /**
+     * Websocket port override.
+     */
+    wsPort?: number;
+    /**
+     * Secure websocket port override.
+     */
+    wssPort?: number;
+    /**
+     * Force TLS for websocket connections.
+     */
+    forceTLS?: boolean;
+    /**
+     * Allowed websocket transports.
+     */
+    enabledTransports?: string[];
+    /**
+     * Pusher cluster identifier.
+     */
+    cluster?: string;
+    /**
+     * Provider function for resolving auth tokens.
+     */
+    getToken?: () => Promise<string | null> | string | null;
+}
+/**
+ * Realtime options accepted by SDK client factories.
+ * Base URL and token provider are supplied by the SDK internally.
+ */
+type RealtimeClientOverrides = Omit<RealtimeClientOptions, "baseUrl" | "getToken">;
+/**
+ * Realtime client interface.
+ */
+interface RealtimeClient {
+    /**
+     * Raw Pusher client instance for advanced usage.
+     */
+    pusher: unknown | null;
+    /**
+     * Chat realtime helpers.
+     */
+    chat: RealtimeChatClient;
+    /**
+     * Subscribe to a public channel.
+     */
+    channel(name: string): RealtimeChannel;
+    /**
+     * Subscribe to a private channel.
+     */
+    "private": (name: string) => RealtimeChannel;
+    /**
+     * Subscribe to a presence channel.
+     */
+    join(name: string): RealtimePresenceChannel;
+    /**
+     * Leave a channel.
+     */
+    leave(name: string): void;
+    /**
+     * Disconnect the realtime client.
+     */
+    disconnect(): void;
+    /**
+     * Update the auth token for realtime subscriptions.
+     */
+    setToken(token: string | null): void;
+    /**
+     * Listen for connection state changes.
+     */
+    onConnectionStateChange(callback: RealtimeConnectionStateCallback): () => void;
+}
+/**
+ * Chat realtime helpers.
+ */
+interface RealtimeChatClient {
+    /**
+     * Join a chat room presence channel for the given channel id.
+     */
+    joinRoom(channelId: ResourceId): RealtimePresenceChannel;
+    /**
+     * Leave a chat room presence channel for the given channel id.
+     */
+    leaveRoom(channelId: ResourceId): void;
+    /**
+     * Listen for new chat messages.
+     */
+    onMessage(channelId: ResourceId, callback: RealtimeEventCallback<ChatMessage>): () => void;
+    /**
+     * Listen for updated chat messages.
+     */
+    onMessageUpdated(channelId: ResourceId, callback: RealtimeEventCallback<ChatMessage>): () => void;
+    /**
+     * Listen for deleted chat messages.
+     */
+    onMessageDeleted(channelId: ResourceId, callback: RealtimeEventCallback<ChatMessage>): () => void;
+}
+/**
+ * Resource identifier type.
+ */
+type ResourceId = string | number;
+/**
+ * Query parameter values for list operations.
+ */
+type ResourceQueryValue = string | number | boolean | null | undefined;
+/**
+ * Query parameter map for list operations.
+ */
+type ResourceQueryParams = Record<string, ResourceQueryValue | ResourceQueryValue[]>;
+/**
+ * SDK client wrapper exposing HTTP and auth helpers.
+ */
+interface SdkClient {
+    /**
+     * Auth client instance.
+     */
+    auth: AuthClient;
+    /**
+     * HTTP client instance.
+     */
+    http: HttpClient;
+    /**
+     * Realtime client instance.
+     */
+    realtime: RealtimeClient;
+    /**
+     * Streams namespace client instance.
+     */
+    streams: StreamsClient;
+    /**
+     * Channels namespace client instance.
+     */
+    channels: ChannelsClient;
+    /**
+     * Chat namespace client instance.
+     */
+    chat: ChatClient;
+}
+/**
+ * Storage adapter used for persisting auth tokens.
+ */
+interface StorageAdapter {
+    /**
+     * Read a value from storage.
+     */
+    get(key: string): Promise<string | null> | string | null;
+    /**
+     * Persist a value into storage.
+     */
+    set(key: string, value: string): Promise<void> | void;
+    /**
+     * Delete a value from storage.
+     */
+    delete(key: string): Promise<void> | void;
+}
+/**
+ * Storage adapter with cookie prefix support.
+ */
+interface CookiesStorageAdapter extends StorageAdapter {
+    /**
+     * Prefix applied to cookie names for multi-app isolation.
+     */
+    cookiePrefix: string;
+}
+/**
+ * Cookie options for browser-based storage adapters.
+ */
+interface CookieOptions {
+    /**
+     * Cookie path.
+     */
+    path?: string;
+    /**
+     * Cookie domain.
+     */
+    domain?: string;
+    /**
+     * Cookie expiry (Date or number of days).
+     */
+    expires?: Date | number;
+    /**
+     * Secure cookie flag.
+     */
+    secure?: boolean;
+    /**
+     * SameSite cookie policy.
+     */
+    sameSite?: "lax" | "strict" | "none";
+}
+/**
+ * Cookie accessors for server-side runtimes.
+ */
+interface CookieAccessors {
+    /**
+     * Get a cookie value by name.
+     */
+    get(name: string): {
+        value: string;
+    } | string | null | undefined;
+    /**
+     * Set a cookie value by name.
+     */
+    set(name: string, value: string, options?: CookieOptions): void;
+    /**
+     * Delete a cookie by name when supported.
+     */
+    delete(name: string, options?: CookieOptions): void;
+}
+/**
+ * Channel metadata associated with a stream.
+ */
+type StreamChannel = Pick<Channel, "id" | "nick_name" | "display_name" | "slug" | "bio" | "avatar_url" | "cover_photo_url" | "follower_count" | "status" | "timezone" | "created_at" | "updated_at">;
+/**
+ * Stream tag metadata.
+ */
+type StreamTag = Tag;
+/**
+ * Stream response payload.
+ */
+interface Stream {
+    /**
+     * Stream identifier.
+     */
+    id: number;
+    /**
+     * Stream type (e.g. live, scheduled).
+     */
+    type?: string;
+    /**
+     * Stream title.
+     */
+    title?: string;
+    /**
+     * Stream description.
+     */
+    description?: string | null;
+    /**
+     * Stream name identifier.
+     */
+    stream_name?: string;
+    /**
+     * Stream start timestamp.
+     */
+    started_at?: string | null;
+    /**
+     * Stream end timestamp.
+     */
+    ended_at?: string | null;
+    /**
+     * Stream cover photo.
+     */
+    cover_photo?: string | null;
+    /**
+     * Stream tags.
+     */
+    tags?: StreamTag[];
+    /**
+     * Player source payload for stream playback.
+     */
+    player_source?: StreamPlayerSource;
+    /**
+     * Associated channel payload.
+     */
+    channel?: StreamChannel;
+    /**
+     * Current viewer count.
+     */
+    viewer_count?: number;
+    /**
+     * Stream creation timestamp.
+     */
+    created_at?: string;
+    /**
+     * Stream update timestamp.
+     */
+    updated_at?: string;
+    /**
+     * Stream scheduled timestamp.
+     */
+    scheduled_at?: string | null;
+    /**
+     * Expiry state flag.
+     */
+    is_expired?: boolean;
+    /**
+     * Locked state flag.
+     */
+    is_locked?: boolean;
+}
+/**
+ * Stream detail response payload.
+ */
+interface StreamResponse {
+    /**
+     * Stream payload.
+     */
+    data?: Stream;
+}
+/**
+ * Stream list response wrapper.
+ */
+interface StreamListResponse {
+    /**
+     * Stream data array.
+     */
+    data?: Stream[];
+}
+/**
+ * Stream player source payload for the player runtime.
+ */
+interface StreamPlayerSource {
+    /**
+     * H5Live configuration payload.
+     */
+    h5live?: {
+        /**
+         * Server endpoints.
+         */
+        server?: {
+            websocket?: string;
+            hls?: string;
+        };
+        /**
+         * RTMP configuration.
+         */
+        rtmp?: {
+            url?: string;
+            streamname?: string;
+        };
+        /**
+         * Security envelope.
+         */
+        security?: {
+            expires?: string;
+            tag?: string;
+            token?: string;
+            options?: string;
+        };
+    };
+    /**
+     * Start index for player entries.
+     */
+    startIndex?: number;
+    /**
+     * Player options.
+     */
+    options?: {
+        switch?: {
+            method?: string;
+            pauseOnError?: boolean;
+            forcePlay?: boolean;
+            fastStart?: boolean;
+            timeout?: number;
+            incTiming?: boolean;
+            timestampReset?: boolean;
+        };
+        adaption?: {
+            rule?: string;
+        };
+    };
+    /**
+     * Available playback entries.
+     */
+    entries?: Array<{
+        index?: number;
+        label?: string;
+        tag?: string;
+        info?: {
+            bitrate?: number;
+            width?: number;
+            height?: number;
+            framerate?: number;
+        };
+        h5live?: {
+            server?: {
+                websocket?: string;
+                hls?: string;
+            };
+            rtmp?: {
+                url?: string;
+                streamname?: string;
+            };
+            security?: {
+                expires?: string;
+                tag?: string;
+                token?: string;
+                options?: string;
+            };
+        };
+    }>;
+}
+
+/**
+ * Configuration for the SDK HTTP client.
+ */
+interface HttpClientOptions {
+    /**
+     * Base URL prepended to all requests.
+     */
+    baseUrl: string;
+    /**
+     * Default headers applied to every request.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Fetch implementation (browser or polyfill).
+     */
+    fetch?: typeof fetch;
+}
+/**
+ * SDK HTTP client that supports interceptors and error mapping.
+ */
+declare class HttpClient {
+    private readonly baseUrl;
+    private readonly defaultHeaders;
+    private readonly fetcher;
+    private beforeRequestHooks;
+    /**
+     * Create a new HTTP client instance.
+     */
+    constructor(options: HttpClientOptions);
+    /**
+     * Register a hook that runs before each request.
+     */
+    onBeforeRequest(hook: BeforeRequestHook): () => void;
+    /**
+     * Execute an HTTP request and return the parsed response.
+     */
+    request<T>(path: string, options?: HttpRequestOptions): Promise<T>;
+    /**
+     * Execute an HTTP request and return the response with request metadata.
+     */
+    requestWithMetadata<T>(path: string, options?: HttpRequestOptions): Promise<{
+        data: T;
+        request: Request;
+        response: Response;
+    }>;
+    /**
+     * Determine whether the provided URL is same-origin with the configured base URL.
+     */
+    isSameOrigin(url: string): boolean;
+}
+
+/**
+ * Supported auth state change events.
+ */
+type AuthStateChangeEvent = "SIGNED_IN" | "SIGNED_OUT" | "TOKEN_REFRESHED";
+/**
+ * Login payload for username/password authentication.
+ */
+interface SignInPayload {
+    /**
+     * User email.
+     */
+    email: string;
+    /**
+     * User password.
+     */
+    password: string;
+    /**
+     * Optional login type (member/model).
+     */
+    type?: string;
+}
+/**
+ * Options for sign-in with a provided token.
+ */
+interface SignInWithTokenOptions {
+    /**
+     * If true, ensure the token is not expired before accepting it.
+     */
+    verifySession?: boolean;
+}
+/**
+ * Options for the auth client.
+ */
+interface AuthClientOptions {
+    /**
+     * Storage adapter for persisting the token.
+     * Provide an explicit adapter when using AuthClient directly.
+     */
+    storage?: StorageAdapter;
+    /**
+     * Cookie accessors for server-side runtimes.
+     */
+    cookies?: CookieAccessors;
+    /**
+     * Service key used as a bearer token when no user session is active.
+     */
+    serviceKey?: string | null;
+    /**
+     * Storage key used for token persistence.
+     */
+    storageKey?: string;
+    /**
+     * Prefix for the default cookie storage adapter.
+     */
+    cookiePrefix?: string;
+    /**
+     * Cookie options for default cookie storage adapters.
+     */
+    cookieOptions?: CookieOptions;
+    /**
+     * Enable automatic refresh flows (defaults to false).
+     * Manual refresh via `refreshToken()` remains available regardless.
+     */
+    autoRefresh?: boolean;
+    /**
+     * Seconds before expiry to refresh the token.
+     */
+    refreshThresholdSeconds?: number;
+}
+/**
+ * Listener for auth state changes.
+ */
+type AuthStateChangeCallback = (event: AuthStateChangeEvent, token: string | null) => void;
+/**
+ * Auth client that manages token persistence and session lifecycle.
+ */
+declare class AuthClient {
+    private readonly http;
+    private readonly storage;
+    private readonly storageKey;
+    private readonly refreshEnabled;
+    private readonly refreshThresholdSeconds;
+    private readonly serviceKey;
+    private currentSession;
+    private readonly stateListeners;
+    private restorePromise;
+    /**
+     * Track whether storage restoration has already been attempted.
+     */
+    private restoreAttempted;
+    /**
+     * Create a new auth client instance.
+     */
+    constructor(http: HttpClient, options?: AuthClientOptions);
+    /**
+     * Set the current bearer token, or clear it when null.
+     */
+    setToken(token: string | null): Promise<string | null>;
+    /**
+     * Get the currently configured token (if any).
+     */
+    getToken(): string | null;
+    /**
+     * Clear the current token and session.
+     */
+    clearToken(): Promise<void>;
+    /**
+     * Sign in using a JWT token.
+     */
+    signInWithToken(token: string, options?: SignInWithTokenOptions): Promise<string>;
+    /**
+     * Sign in using email/password credentials.
+     */
+    signIn(payload: SignInPayload): Promise<string>;
+    /**
+     * Sign out the current user.
+     */
+    signOut(): Promise<void>;
+    /**
+     * Get the current session, restoring from storage if needed.
+     */
+    getSession(): Promise<string | null>;
+    /**
+     * Refresh the current session token.
+     * Manual refresh is always available; automatic refresh is controlled
+     * by the `autoRefresh` option.
+     */
+    refreshToken(): Promise<string>;
+    /**
+     * Subscribe to auth state changes.
+     */
+    onAuthStateChange(callback: AuthStateChangeCallback): () => void;
+    private emitState;
+    /**
+     * Register the auth header hook for outgoing HTTP requests.
+     */
+    private registerAuthHook;
+    /**
+     * Resolve the bearer token to use for outgoing requests.
+     */
+    private resolveRequestToken;
+    /**
+     * Persist a token update and notify listeners.
+     */
+    private applyToken;
+    /**
+     * Restore a persisted token from storage when needed.
+     */
+    private restoreFromStorage;
+    /**
+     * Determine if the client is currently using the service key.
+     */
+    private isUsingServiceKey;
+    /**
+     * Resolve the auth token from a response payload and request metadata.
+     */
+    private resolveTokenFromResponse;
+    private assertTokenNotExpired;
+}
+
+export { buildQueryString as $, AuthClient as A, type BaseResource as B, ChannelsClient as C, type ResourceId as D, type ResourceQueryParams as E, type ResourceQueryValue as F, type Stream as G, type HttpClientOptions as H, type StreamChannel as I, type StreamListResponse as J, type StreamPlayerSource as K, type StreamResponse as L, type StreamTag as M, type Channel as N, type ChannelCharacteristics as O, type ChannelLink as P, type ChannelResponse as Q, type RealtimeChannel as R, StreamsClient as S, type ChannelTag as T, type ChatMessage as U, type ChatMessageMetadata as V, type ChatMessagesQuery as W, type ChatMessagesResponse as X, type ChatMessageTransaction as Y, type ChatMessageUser as Z, type RealtimeClientOverrides as _, HttpClient as a, type Tag as a0, type AuthClientOptions as b, type AuthStateChangeCallback as c, type AuthStateChangeEvent as d, type SignInPayload as e, type SignInWithTokenOptions as f, ChatClient as g, type SdkClient as h, type BeforeRequestHook as i, type CookieAccessors as j, type CookieOptions as k, type CookiesStorageAdapter as l, type HttpRequest as m, type HttpRequestOptions as n, type RealtimeChatClient as o, type RealtimeClient as p, type RealtimeClientOptions as q, type RealtimeConnectionState as r, type RealtimeConnectionStateCallback as s, type RealtimeEventCallback as t, type RealtimePresenceChannel as u, type SDKErrorCode as v, type SdkErrorCode as w, type SDKErrorShape as x, type SdkErrorShape as y, type StorageAdapter as z };