@ezychat/web 0.0.0-stage → 0.1.39

package/dist-lib/types/api/queries.d.ts

@@ -0,0 +1,664 @@
+import { type InfiniteData, type QueryClient } from '@tanstack/react-query';
+import { type CreateApiTokenBodyInput, type Chat, type ChatListResponse, type ChatStatus, type Message, type MessageListResponse, type PatchUserBody, type Settings, type User } from '@ezychat/shared';
+export interface ChatFilters {
+    status?: ChatStatus;
+    assigned: 'me' | 'none' | 'any';
+    q?: string;
+    /** customer tag filter */
+    tag?: string;
+}
+export declare const qk: {
+    me: readonly ["me"];
+    setupStatus: readonly ["setup-status"];
+    chats: (f: ChatFilters) => readonly ["chats", ChatFilters];
+    chatsAll: readonly ["chats"];
+    openChatCount: readonly ["open-chat-count"];
+    chat: (jid: string) => readonly ["chat", string];
+    messages: (jid: string) => readonly ["messages", string];
+    notes: (jid: string) => readonly ["notes", string];
+    customerProfile: (jid: string) => readonly ["customer-profile", string];
+    groupMembers: (jid: string) => readonly ["group-members", string];
+    memberAbout: (groupJid: string, member: string) => readonly ["member-about", string, string];
+    customerTags: (q: string) => readonly ["customer-tags", string];
+    quickReplies: readonly ["quick-replies"];
+    users: readonly ["users"];
+    directory: readonly ["users", "directory"];
+    wa: readonly ["wa"];
+    tunnel: readonly ["tunnel"];
+    cloudflareSetup: readonly ["cloudflare-setup"];
+    settings: readonly ["settings"];
+    audit: readonly ["audit"];
+    mcpSettings: readonly ["integrations", "mcp"];
+    apiTokens: readonly ["integrations", "tokens"];
+};
+export type ChatsData = InfiniteData<ChatListResponse, string | null>;
+/** pages[0] holds the NEWEST messages; each page's `messages` are in ascending time order. */
+export type MessagesData = InfiniteData<MessageListResponse, string | null>;
+/**
+ * A direct chat's profile name changed: relabel that customer's cached group messages
+ * (the server attaches `senderProfile` only when messages are loaded or arrive).
+ */
+export declare function patchSenderProfilesInCache(qc: QueryClient, chat: Chat): void;
+/** Same URL the server builds for a message's media (`mediaUrlFor` in messages/repo.ts). */
+export declare function mediaUrlFor(id: string): string;
+/** Insert or replace a message in the messages cache of its chat. */
+export declare function upsertMessageInCache(qc: QueryClient, m: Message): void;
+/** Patch a message (located by id, or by clientId / `local-<clientId>`) in a chat's messages cache. */
+export declare function patchMessageInCache(qc: QueryClient, chatJid: string, match: {
+    id: string;
+    clientId: string | null;
+}, patch: Partial<Message>): void;
+/** Remove a message (by id or `local-<clientId>`) from a chat's messages cache. */
+export declare function removeMessageFromCache(qc: QueryClient, chatJid: string, clientId: string): void;
+/** Replace a chat in every cached chat list and in its detail entry. */
+export declare function upsertChatInCache(qc: QueryClient, chat: Chat): void;
+export declare function newClientId(): string;
+/** Current user, or `null` when not logged in (401 is not an error here). */
+export declare function useMe(): import("@tanstack/react-query").UseQueryResult<{
+    id: number;
+    username: string;
+    displayName: string;
+    role: "admin" | "agent";
+    mustChangePassword: boolean;
+    disabled: boolean;
+    createdAt: number;
+    locale: "en" | "ms" | "zh-CN" | null;
+    kind?: "human" | "ai" | undefined;
+    aiRole?: "sales" | undefined;
+} | null, Error>;
+export declare function useSetupStatus(): import("@tanstack/react-query").UseQueryResult<{
+    needsSetup: boolean;
+}, Error>;
+/** Create the first admin (server logs them in). */
+export declare function useSetupAdmin(): import("@tanstack/react-query").UseMutationResult<unknown, Error, {
+    username: string;
+    displayName: string;
+    password: string;
+}, unknown>;
+export declare function useLogin(): import("@tanstack/react-query").UseMutationResult<{
+    id: number;
+    username: string;
+    displayName: string;
+    role: "admin" | "agent";
+    mustChangePassword: boolean;
+    disabled: boolean;
+    createdAt: number;
+    locale: "en" | "ms" | "zh-CN" | null;
+    kind?: "human" | "ai" | undefined;
+    aiRole?: "sales" | undefined;
+} | null, Error, {
+    username: string;
+    password: string;
+}, unknown>;
+/**
+ * Best-effort removal of this browser's push subscription (server row + browser subscription).
+ * Never throws: logout / session revocation must proceed regardless.
+ */
+export declare function dropPushSubscription(): Promise<void>;
+export declare function useLogout(): import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
+/** Saves the signed-in user's language preference (null = follow the browser). */
+export declare function useSetMyLocale(): import("@tanstack/react-query").UseMutationResult<{
+    id: number;
+    username: string;
+    displayName: string;
+    role: "admin" | "agent";
+    mustChangePassword: boolean;
+    disabled: boolean;
+    createdAt: number;
+    locale: "en" | "ms" | "zh-CN" | null;
+    kind?: "human" | "ai" | undefined;
+    aiRole?: "sales" | undefined;
+}, Error, "en" | "ms" | "zh-CN" | null, unknown>;
+export declare function useChangePassword(): import("@tanstack/react-query").UseMutationResult<unknown, Error, {
+    currentPassword: string;
+    newPassword: string;
+}, unknown>;
+export declare function useChats(filters: ChatFilters): import("@tanstack/react-query").UseInfiniteQueryResult<InfiniteData<{
+    chats: {
+        jid: string;
+        type: "dm" | "group";
+        name: string;
+        avatarUrl: string | null;
+        unreadCount: number;
+        lastMessageAt: number | null;
+        lastMessagePreview: string | null;
+        status: "open" | "resolved";
+        assignedTo: number | null;
+        updatedAt: number;
+        phone: string | null;
+        tags?: string[] | undefined;
+        whatsappName?: string | null | undefined;
+    }[];
+    nextCursor: string | null;
+}, unknown>, Error>;
+export declare function useChat(jid: string | null | undefined): import("@tanstack/react-query").UseQueryResult<{
+    chat: {
+        jid: string;
+        type: "dm" | "group";
+        name: string;
+        avatarUrl: string | null;
+        unreadCount: number;
+        lastMessageAt: number | null;
+        lastMessagePreview: string | null;
+        status: "open" | "resolved";
+        assignedTo: number | null;
+        updatedAt: number;
+        phone: string | null;
+        tags?: string[] | undefined;
+        whatsappName?: string | null | undefined;
+    };
+    events: {
+        id: number;
+        chatJid: string;
+        type: "resolved" | "assigned" | "unassigned" | "reopened" | "ai_tool_used";
+        actorId: number | null;
+        payload: Record<string, unknown>;
+        at: number;
+    }[];
+}, Error>;
+export declare function useOpenChatCount(): import("@tanstack/react-query").UseQueryResult<{
+    openCount: number;
+}, Error>;
+export declare function useResolveAllChats(): import("@tanstack/react-query").UseMutationResult<{
+    resolvedCount: number;
+}, Error, void, unknown>;
+/** Infinite message history; `fetchNextPage()` loads OLDER messages (pages[1..] are older). */
+export declare function useMessages(jid: string | null | undefined): import("@tanstack/react-query").UseInfiniteQueryResult<InfiniteData<{
+    messages: {
+        id: string;
+        chatJid: string;
+        senderJid: string | null;
+        senderName: string | null;
+        fromMe: boolean;
+        sentByUserId: number | null;
+        type: "text" | "image" | "video" | "audio" | "document" | "sticker" | "system";
+        body: string | null;
+        mediaUrl: string | null;
+        mediaMime: string | null;
+        mediaName: string | null;
+        mediaStatus: "none" | "pending" | "failed" | "ok";
+        quotedId: string | null;
+        status: "pending" | "failed" | "sent" | "delivered" | "read";
+        error: string | null;
+        timestamp: number;
+        clientId: string | null;
+        voiceNote?: boolean | undefined;
+        transcript?: string | null | undefined;
+        transcriptLang?: string | null | undefined;
+        transcriptStatus?: "pending" | "failed" | "ok" | "too_long" | "unsupported" | "skipped" | null | undefined;
+        senderProfile?: {
+            chatJid: string;
+            name: string;
+        } | null | undefined;
+    }[];
+    nextBefore: string | null;
+}, unknown>, Error>;
+/** Flatten MessagesData into ascending order. */
+export declare function flattenMessages(data: MessagesData | undefined): Message[];
+export interface SendTextInput {
+    text: string;
+    quotedId?: string;
+    /** Generate with `newClientId()` (crypto.randomUUID). */
+    clientId: string;
+}
+/** Optimistic text send: inserts a pending bubble immediately, reconciled by clientId. */
+export declare function useSendText(jid: string): import("@tanstack/react-query").UseMutationResult<{
+    id: string;
+    chatJid: string;
+    senderJid: string | null;
+    senderName: string | null;
+    fromMe: boolean;
+    sentByUserId: number | null;
+    type: "text" | "image" | "video" | "audio" | "document" | "sticker" | "system";
+    body: string | null;
+    mediaUrl: string | null;
+    mediaMime: string | null;
+    mediaName: string | null;
+    mediaStatus: "none" | "pending" | "failed" | "ok";
+    quotedId: string | null;
+    status: "pending" | "failed" | "sent" | "delivered" | "read";
+    error: string | null;
+    timestamp: number;
+    clientId: string | null;
+    voiceNote?: boolean | undefined;
+    transcript?: string | null | undefined;
+    transcriptLang?: string | null | undefined;
+    transcriptStatus?: "pending" | "failed" | "ok" | "too_long" | "unsupported" | "skipped" | null | undefined;
+    senderProfile?: {
+        chatJid: string;
+        name: string;
+    } | null | undefined;
+}, Error, SendTextInput, {
+    clientId: string;
+}>;
+export interface SendMediaInput {
+    file: File;
+    caption?: string;
+    clientId: string;
+    /** Reply to this message (WhatsApp shows it as a quote). */
+    quotedId?: string;
+    /** A recorded Ogg/Opus voice note: sent as a WhatsApp voice note, never with a caption. */
+    voiceNote?: boolean;
+}
+export declare function useSendMedia(jid: string): import("@tanstack/react-query").UseMutationResult<{
+    id: string;
+    chatJid: string;
+    senderJid: string | null;
+    senderName: string | null;
+    fromMe: boolean;
+    sentByUserId: number | null;
+    type: "text" | "image" | "video" | "audio" | "document" | "sticker" | "system";
+    body: string | null;
+    mediaUrl: string | null;
+    mediaMime: string | null;
+    mediaName: string | null;
+    mediaStatus: "none" | "pending" | "failed" | "ok";
+    quotedId: string | null;
+    status: "pending" | "failed" | "sent" | "delivered" | "read";
+    error: string | null;
+    timestamp: number;
+    clientId: string | null;
+    voiceNote?: boolean | undefined;
+    transcript?: string | null | undefined;
+    transcriptLang?: string | null | undefined;
+    transcriptStatus?: "pending" | "failed" | "ok" | "too_long" | "unsupported" | "skipped" | null | undefined;
+    senderProfile?: {
+        chatJid: string;
+        name: string;
+    } | null | undefined;
+}, Error, SendMediaInput, void>;
+export declare function useRetryMessage(): import("@tanstack/react-query").UseMutationResult<{
+    id: string;
+    chatJid: string;
+    senderJid: string | null;
+    senderName: string | null;
+    fromMe: boolean;
+    sentByUserId: number | null;
+    type: "text" | "image" | "video" | "audio" | "document" | "sticker" | "system";
+    body: string | null;
+    mediaUrl: string | null;
+    mediaMime: string | null;
+    mediaName: string | null;
+    mediaStatus: "none" | "pending" | "failed" | "ok";
+    quotedId: string | null;
+    status: "pending" | "failed" | "sent" | "delivered" | "read";
+    error: string | null;
+    timestamp: number;
+    clientId: string | null;
+    voiceNote?: boolean | undefined;
+    transcript?: string | null | undefined;
+    transcriptLang?: string | null | undefined;
+    transcriptStatus?: "pending" | "failed" | "ok" | "too_long" | "unsupported" | "skipped" | null | undefined;
+    senderProfile?: {
+        chatJid: string;
+        name: string;
+    } | null | undefined;
+}, Error, string, unknown>;
+export declare function usePatchChat(jid: string): import("@tanstack/react-query").UseMutationResult<{
+    jid: string;
+    type: "dm" | "group";
+    name: string;
+    avatarUrl: string | null;
+    unreadCount: number;
+    lastMessageAt: number | null;
+    lastMessagePreview: string | null;
+    status: "open" | "resolved";
+    assignedTo: number | null;
+    updatedAt: number;
+    phone: string | null;
+    tags?: string[] | undefined;
+    whatsappName?: string | null | undefined;
+}, Error, {
+    assignedTo?: number | null | undefined;
+    status?: "open" | "resolved" | undefined;
+}, unknown>;
+export declare function useMarkRead(jid: string): import("@tanstack/react-query").UseMutationResult<unknown, Error, void, void>;
+export declare function useNotes(jid: string | null | undefined): import("@tanstack/react-query").UseQueryResult<{
+    id: number;
+    chatJid: string;
+    userId: number;
+    body: string;
+    createdAt: number;
+}[], Error>;
+export declare function useAddNote(jid: string): import("@tanstack/react-query").UseMutationResult<{
+    id: number;
+    chatJid: string;
+    userId: number;
+    body: string;
+    createdAt: number;
+}, Error, string, unknown>;
+/** Members of a group chat (read from WhatsApp by the server, cached there for a few minutes). */
+export declare function useGroupMembers(jid: string | null | undefined, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<{
+    group: {
+        jid: string;
+        name: string | null;
+        description: string | null;
+        createdAt: number | null;
+        createdBy: {
+            jid: string;
+            name: string | null;
+            phone: string | null;
+        } | null;
+        size: number;
+        adminCount: number;
+    };
+    members: {
+        jid: string;
+        phone: string | null;
+        lid: string | null;
+        name: string | null;
+        username: string | null;
+        role: "admin" | "member" | "superadmin";
+        isMe: boolean;
+        chatJid: string | null;
+    }[];
+    fetchedAt: number;
+}, Error>;
+/** A member's WhatsApp About text, fetched only when their details are opened. */
+export declare function useMemberAbout(groupJid: string, member: string | null): import("@tanstack/react-query").UseQueryResult<{
+    about: string | null;
+}, Error>;
+/** Open (or create) the direct chat with a group member. */
+export declare function useStartMemberChat(groupJid: string): import("@tanstack/react-query").UseMutationResult<{
+    chatJid: string;
+}, Error, string, unknown>;
+export declare function useCustomerProfile(jid: string | null | undefined): import("@tanstack/react-query").UseQueryResult<{
+    profile: {
+        id: string | null;
+        name: string | null;
+        company: string | null;
+        email: string | null;
+        otherPhone: string | null;
+        address: string | null;
+        tags: string[];
+        updatedAt: number | null;
+        updatedBy: number | null;
+    };
+    whatsappName: string | null;
+    whatsappPhone?: string | null | undefined;
+    whatsapp?: {
+        pushName: string | null;
+        savedName: string | null;
+        phone: string | null;
+        lid: string | null;
+    } | undefined;
+}, Error>;
+export declare function useSaveCustomerProfile(jid: string): import("@tanstack/react-query").UseMutationResult<{
+    profile: {
+        id: string | null;
+        name: string | null;
+        company: string | null;
+        email: string | null;
+        otherPhone: string | null;
+        address: string | null;
+        tags: string[];
+        updatedAt: number | null;
+        updatedBy: number | null;
+    };
+    whatsappName: string | null;
+    whatsappPhone?: string | null | undefined;
+    whatsapp?: {
+        pushName: string | null;
+        savedName: string | null;
+        phone: string | null;
+        lid: string | null;
+    } | undefined;
+}, Error, {
+    name: string;
+    company: string;
+    email: string;
+    otherPhone: string;
+    address: string;
+    tags: string[];
+}, unknown>;
+export declare function useCustomerTags(q: string): import("@tanstack/react-query").UseQueryResult<string[], Error>;
+export declare function useQuickReplies(): import("@tanstack/react-query").UseQueryResult<{
+    id: number;
+    shortcut: string;
+    body: string;
+    updatedAt: number;
+}[], Error>;
+/** Create (no id) or update (with id). */
+export declare function useSaveQuickReply(): import("@tanstack/react-query").UseMutationResult<{
+    id: number;
+    shortcut: string;
+    body: string;
+    updatedAt: number;
+}, Error, {
+    shortcut: string;
+    body: string;
+} & {
+    id?: number;
+}, unknown>;
+export declare function useDeleteQuickReply(): import("@tanstack/react-query").UseMutationResult<unknown, Error, number, unknown>;
+export declare function useUsers(opts?: {
+    enabled?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<{
+    id: number;
+    username: string;
+    displayName: string;
+    role: "admin" | "agent";
+    mustChangePassword: boolean;
+    disabled: boolean;
+    createdAt: number;
+    locale: "en" | "ms" | "zh-CN" | null;
+    kind?: "human" | "ai" | undefined;
+    aiRole?: "sales" | undefined;
+}[], Error>;
+/** Public team-member fields every logged-in user may see (`GET /api/users/directory`). */
+export type DirectoryUser = Pick<User, 'id' | 'displayName' | 'role' | 'disabled' | 'kind' | 'aiRole'>;
+/**
+ * Team directory for every role (agents included). Needs the server route
+ * `GET /api/users/directory`; when it is missing (404) or forbidden, resolves to an empty list
+ * so the UI falls back to "Agent #<id>" instead of erroring.
+ */
+export declare function useUserDirectory(opts?: {
+    enabled?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<DirectoryUser[], Error>;
+export declare function useCreateUser(): import("@tanstack/react-query").UseMutationResult<{
+    id: number;
+    username: string;
+    displayName: string;
+    role: "admin" | "agent";
+    mustChangePassword: boolean;
+    disabled: boolean;
+    createdAt: number;
+    locale: "en" | "ms" | "zh-CN" | null;
+    kind?: "human" | "ai" | undefined;
+    aiRole?: "sales" | undefined;
+}, Error, {
+    username: string;
+    displayName: string;
+    role: "admin" | "agent";
+    password: string;
+}, unknown>;
+export declare function usePatchUser(): import("@tanstack/react-query").UseMutationResult<{
+    id: number;
+    username: string;
+    displayName: string;
+    role: "admin" | "agent";
+    mustChangePassword: boolean;
+    disabled: boolean;
+    createdAt: number;
+    locale: "en" | "ms" | "zh-CN" | null;
+    kind?: "human" | "ai" | undefined;
+    aiRole?: "sales" | undefined;
+}, Error, {
+    id: number;
+    patch: PatchUserBody;
+}, unknown>;
+export declare function useResetPassword(): import("@tanstack/react-query").UseMutationResult<{
+    password: string;
+}, Error, number, unknown>;
+export declare function useRevokeSessions(): import("@tanstack/react-query").UseMutationResult<unknown, Error, number, unknown>;
+export declare function useWaStatus(opts?: {
+    enabled?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<{
+    state: "open" | "qr" | "disconnected" | "connecting" | "logged_out" | "replaced" | "blocked";
+    me: {
+        jid: string;
+        name: string | null;
+    } | null;
+    qr: string | null;
+    lastError: string | null;
+}, Error>;
+export type WaAction = 'logout' | 'relink' | 'takeover';
+export declare function useWaAction(): import("@tanstack/react-query").UseMutationResult<unknown, Error, WaAction, unknown>;
+/** Link by phone number: returns the 8-character code to enter in WhatsApp → Linked devices. */
+export declare function useRequestPairingCode(): import("@tanstack/react-query").UseMutationResult<{
+    code: string;
+}, Error, string, unknown>;
+export declare function useTunnel(opts?: {
+    enabled?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<{
+    mode: "off" | "quick" | "named";
+    state: "error" | "stopped" | "starting" | "running";
+    url: string | null;
+    hostname: string | null;
+    lastError: string | null;
+    logTail: string[];
+}, Error>;
+/** Poll only while Cloudflare is signing in or provisioning an inbox address. */
+export declare function useCloudflareSetupStatus(): import("@tanstack/react-query").UseQueryResult<{
+    state: "connected" | "error" | "signed_out" | "signing_in" | "awaiting_approval";
+    loginUrl: string | null;
+    error: string | null;
+    domains: {
+        id: string;
+        name: string;
+        accountName: string | null;
+    }[];
+    busy: boolean;
+    managed: {
+        id: string;
+        name: string;
+        hostname: string;
+    } | null;
+}, Error>;
+export type CloudflareAccountAction = 'login' | 'login/cancel' | 'refresh';
+/** Account actions all return the same public setup state; credentials stay on the server. */
+export declare function useCloudflareAccountAction(): import("@tanstack/react-query").UseMutationResult<{
+    state: "connected" | "error" | "signed_out" | "signing_in" | "awaiting_approval";
+    loginUrl: string | null;
+    error: string | null;
+    domains: {
+        id: string;
+        name: string;
+        accountName: string | null;
+    }[];
+    busy: boolean;
+    managed: {
+        id: string;
+        name: string;
+        hostname: string;
+    } | null;
+}, Error, CloudflareAccountAction, unknown>;
+export declare function useCreateCloudflareTunnel(): import("@tanstack/react-query").UseMutationResult<{
+    mode: "off" | "quick" | "named";
+    state: "error" | "stopped" | "starting" | "running";
+    url: string | null;
+    hostname: string | null;
+    lastError: string | null;
+    logTail: string[];
+}, Error, {
+    domainId: string;
+    subdomain: string;
+    tunnelName: string;
+}, unknown>;
+export declare function useStartTunnel(): import("@tanstack/react-query").UseMutationResult<{
+    mode: "off" | "quick" | "named";
+    state: "error" | "stopped" | "starting" | "running";
+    url: string | null;
+    hostname: string | null;
+    lastError: string | null;
+    logTail: string[];
+}, Error, {
+    mode: "quick" | "named";
+    token?: string | undefined;
+    hostname?: string | undefined;
+}, unknown>;
+export declare function useStopTunnel(): import("@tanstack/react-query").UseMutationResult<{
+    mode: "off" | "quick" | "named";
+    state: "error" | "stopped" | "starting" | "running";
+    url: string | null;
+    hostname: string | null;
+    lastError: string | null;
+    logTail: string[];
+}, Error, void, unknown>;
+export declare function useSettings(): import("@tanstack/react-query").UseQueryResult<{
+    port: number;
+    lanEnabled: boolean;
+    historyDays: number;
+    namedTunnelHostname: string | null;
+    hasTunnelToken: boolean;
+}, Error>;
+export interface PatchSettingsResult {
+    settings: Settings;
+    restartRequired: boolean;
+}
+export declare function usePatchSettings(): import("@tanstack/react-query").UseMutationResult<PatchSettingsResult, Error, {
+    port?: number | undefined;
+    lanEnabled?: boolean | undefined;
+    historyDays?: number | undefined;
+    namedTunnelHostname?: string | null | undefined;
+}, unknown>;
+/** Audit log, newest first; `fetchNextPage()` loads older entries (cursor = last entry id). */
+export declare function useAudit(limit?: number): import("@tanstack/react-query").UseInfiniteQueryResult<InfiniteData<{
+    entries: {
+        id: number;
+        userId: number | null;
+        action: string;
+        ip: string | null;
+        meta: Record<string, unknown>;
+        at: number;
+        apiToken?: {
+            name: string;
+            prefix: string;
+        } | null | undefined;
+    }[];
+}, unknown>, Error>;
+export declare function useMcpSettings(): import("@tanstack/react-query").UseQueryResult<{
+    enabled: boolean;
+    endpointPath: string;
+    publicUrl: string | null;
+    localUrl: string;
+}, Error>;
+export declare function usePatchMcpSettings(): import("@tanstack/react-query").UseMutationResult<{
+    enabled: boolean;
+    endpointPath: string;
+    publicUrl: string | null;
+    localUrl: string;
+}, Error, {
+    enabled: boolean;
+}, unknown>;
+export declare function useApiTokens(): import("@tanstack/react-query").UseQueryResult<{
+    id: number;
+    userId: number;
+    userName: string;
+    name: string;
+    prefix: string;
+    createdAt: number;
+    lastUsedAt: number | null;
+    expiresAt: number | null;
+}[], Error>;
+export interface CreateApiTokenVars {
+    body: CreateApiTokenBodyInput;
+    /**
+     * Receives the one-time secret. It is handed straight to the caller's component state and is
+     * never the mutation's result, so it stays out of the react-query caches.
+     */
+    onSecret: (secret: string) => void;
+}
+/** Creates a token; the mutation result is the token metadata only (see `onSecret`). */
+export declare function useCreateApiToken(): import("@tanstack/react-query").UseMutationResult<{
+    id: number;
+    userId: number;
+    userName: string;
+    name: string;
+    prefix: string;
+    createdAt: number;
+    lastUsedAt: number | null;
+    expiresAt: number | null;
+}, Error, CreateApiTokenVars, unknown>;
+/** Revokes a token; one that is already gone (404) counts as revoked. */
+export declare function useRevokeApiToken(): import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;

package/dist-lib/types/api/resume-reconnect.d.ts

@@ -0,0 +1,15 @@
+import type { Socket } from 'socket.io-client';
+type ResumeSocket = Pick<Socket, 'active' | 'connected'> & {
+    io: {
+        engine?: {
+            readyState: string;
+        };
+    };
+    connect(): unknown;
+    disconnect(): unknown;
+    on(event: 'connect' | 'disconnect', listener: () => void): unknown;
+    off(event: 'connect' | 'disconnect', listener: () => void): unknown;
+};
+/** Reconnect a live session when its page resumes, without background wake-ups. */
+export declare function registerResumeReconnect(socket: ResumeSocket): () => void;
+export {};