rotur-sdk 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,985 @@
+declare class ApiError extends Error {
+    status: number;
+    data: any;
+    constructor(status: number, data: any);
+}
+declare class Http {
+    private baseUrl;
+    private getToken;
+    constructor(getToken: () => string | null);
+    private buildUrl;
+    get<T>(path: string, params?: Record<string, any>, auth?: boolean): Promise<T>;
+    post<T>(path: string, body?: any, auth?: boolean): Promise<T>;
+    patch<T>(path: string, body?: any): Promise<T>;
+    del<T>(path: string, body?: any): Promise<T>;
+    private handle;
+}
+
+type UserId = string;
+type Username = string;
+type Presence = "online" | "idle" | "dnd" | "invisible";
+type StandingLevel = "good" | "warning" | "suspended" | "banned";
+type JoinPolicy = "OPEN" | "REQUEST" | "INVITE";
+type TokenPermission = "account:delete" | "account:profile" | "account:settings" | "account:view" | "credits:view" | "credits:manage" | "credits:transfer" | "credits:daily" | "friends:view" | "friends:manage" | "friends:request" | "friends:accept" | "friends:remove" | "posts:view" | "posts:create" | "posts:delete" | "posts:manage" | "posts:like" | "posts:reply" | "posts:repost" | "following:view" | "following:follow" | "following:unfollow" | "files:view" | "files:manage" | "files:delete" | "keys:view" | "keys:manage" | "groups:view" | "groups:manage" | "groups:join" | "groups:leave" | "notifications:view" | "notifications:send" | "gifts:view" | "gifts:create" | "gifts:claim" | "gifts:cancel" | "items:view" | "items:buy" | "items:sell" | "items:manage" | "validators:generate" | "blocked:view" | "blocked:manage" | "tokens:manage" | "cosmetics:view" | "cosmetics:buy" | "cosmetics:equip";
+interface UserProfile {
+    username: Username;
+    pfp: string;
+    banner?: string;
+    bio?: string;
+    pronouns?: string;
+    system: string;
+    created: number;
+    followers: number;
+    following: number;
+    currency: number;
+    subscription: string;
+    max_size: string;
+    badges: Badge[];
+    theme?: Record<string, any>;
+    private: boolean;
+    banned: boolean;
+    status?: RoomMember;
+    posts?: NetPost[];
+    followed?: boolean;
+    follows_me?: boolean;
+    id: UserId;
+    index: number;
+}
+interface Badge {
+    name: string;
+    icon: string;
+    description: string;
+}
+interface Transaction {
+    type: string;
+    user: Username;
+    amount: number;
+    note: string;
+    time: number;
+    new_total: number;
+    petition_id?: string;
+    key_name?: string;
+    key_id?: string;
+    gift_id?: string;
+    gift_code?: string;
+}
+interface NetPost {
+    id: string;
+    content: string;
+    user: Username;
+    timestamp: number;
+    attachment?: string;
+    profile_only: boolean;
+    os?: string;
+    replies?: NetReply[];
+    likes?: Username[];
+    pinned?: boolean;
+    is_repost: boolean;
+    original_post?: NetPost;
+}
+interface NetReply {
+    id: string;
+    content: string;
+    user: Username;
+    timestamp: number;
+}
+interface NetKey {
+    key: string;
+    name: string;
+    price: number;
+    type: string;
+    total_income?: number;
+    webhook?: string;
+    subscription?: KeySubscription;
+    users: Record<Username, KeyUserData>;
+    creator: Username;
+    data?: string;
+}
+interface KeySubscription {
+    active: boolean;
+    frequency: number;
+    period: string;
+    next_billing: any;
+}
+interface KeyUserData {
+    time: number;
+    price?: number;
+    next_billing?: any;
+    cancel_at?: any;
+}
+interface KeyPublic {
+    key: string;
+    name: string;
+    price: number;
+    type: string;
+}
+interface NetItem {
+    name: string;
+    description: string;
+    price: number;
+    selling: boolean;
+    author: Username;
+    owner: Username;
+    private_data?: any;
+    created: number;
+    transfer_history: NetTransferHistory[];
+    total_income: number;
+}
+interface NetTransferHistory {
+    from?: Username;
+    to: Username;
+    timestamp: number;
+    type: string;
+    price?: number;
+}
+interface GiftPublic {
+    code: string;
+    amount: number;
+    note: string;
+    creator_id: Username;
+    expires_at: number;
+}
+interface GiftNet {
+    id: string;
+    code: string;
+    amount: number;
+    note: string;
+    creator_id: Username;
+    created_at: number;
+    expires_at: number;
+    claimed_at?: number;
+    claimed_by?: Username;
+}
+interface SubTokenPublic {
+    id: string;
+    name: string;
+    permissions: TokenPermission[];
+    created_at: number;
+    last_used_at?: number;
+    expires_at?: number;
+    revoked: boolean;
+    revoked_at?: number;
+    origin?: string;
+    description?: string;
+    websites?: string[];
+}
+interface SubTokenCreate {
+    id: string;
+    name: string;
+    token: string;
+    permissions: TokenPermission[];
+    created_at: number;
+    expires_at?: number;
+    origin?: string;
+    description?: string;
+    websites?: string[];
+}
+interface TokenAbilities {
+    token_type: "main" | "sub";
+    permissions: TokenPermission[];
+    name?: string;
+    id?: string;
+}
+interface PermissionGroup {
+    name: string;
+    description: string;
+    permissions: TokenPermission[];
+}
+interface GroupPublic {
+    tag: string;
+    name: string;
+    description: string;
+    icon_url: string;
+    banner_url: string;
+    owner_user_id: Username;
+    public: boolean;
+    join_policy: JoinPolicy;
+    created_at: number;
+    credits_balance: number;
+    member_count: number;
+}
+interface GroupAnnouncement {
+    id: string;
+    group_tag: string;
+    title: string;
+    body: string;
+    author_user_id: UserId;
+    created_at: number;
+    ping_members: boolean;
+}
+interface GroupEvent {
+    id: string;
+    group_tag: string;
+    title: string;
+    description: string;
+    start_time: number;
+    end_time: number;
+    location: string;
+    visibility: "MEMBERS" | "PUBLIC";
+    created_by: UserId;
+    published: boolean;
+}
+interface GroupRole {
+    id: string;
+    group_tag: string;
+    name: string;
+    description: string;
+    assign_on_join: boolean;
+    self_assignable: boolean;
+    benefits: string[];
+    permissions: string[];
+}
+interface GroupTip {
+    id: string;
+    group_tag: string;
+    from_user_id: UserId;
+    amount_credits: number;
+    created_at: number;
+}
+interface RoomMember {
+    user_id: UserId;
+    username: Username;
+    status: string;
+    presence: Presence;
+    activities: Activity[];
+}
+interface Activity {
+    id: string;
+    title: string;
+    application?: ActivityApplication;
+    image?: string;
+    url?: string;
+    status?: string;
+    start_time?: number;
+    media?: ActivityMedia;
+}
+interface ActivityApplication {
+    name: string;
+    url?: string;
+}
+interface ActivityMedia {
+    title: string;
+    artist?: string;
+    album?: string;
+    start: number;
+    end: number;
+}
+interface UserStatusResponse {
+    username: Username;
+    status: string;
+    presence: string;
+    activities: Record<string, Activity>;
+}
+interface NotificationEntry {
+    type: string;
+    id: string;
+    timestamp: number;
+    [key: string]: any;
+}
+interface NotifyEndpoint {
+    device_id: string;
+    endpoint: string;
+    p256dh: string;
+    auth: string;
+    source: string;
+    created_at: number;
+}
+interface NotifyAllowedSender {
+    username: Username;
+    count: number;
+}
+interface NotifyLogEntry {
+    from: Username;
+    source: string;
+    title?: string;
+    body?: string;
+    at: number;
+}
+interface FileEntry {
+    uuid: string;
+    name: string;
+    path: string;
+    size: number;
+    created: number;
+    modified: number;
+}
+interface System {
+    name: string;
+    owner: {
+        name: Username;
+        discord_id: string;
+    };
+    wallpaper: string;
+    designation: string;
+    icon: string;
+}
+interface EconomyStats {
+    average: number;
+    total: number;
+    variance: number;
+    currency_comparison: {
+        pence: string;
+        cents: string;
+    };
+}
+interface UserStats {
+    total_users: number;
+    banned_users: number;
+    active_users: number;
+}
+interface CosmeticItem {
+    id: string;
+    name: string;
+    description: string;
+    type: string;
+    price: number;
+    available: boolean;
+}
+interface ValidatorResult {
+    valid: boolean;
+    username?: Username;
+    id?: UserId;
+    error?: string;
+}
+interface ValidatorGenerateResult {
+    validator: string;
+}
+interface StandingInfo {
+    username: Username;
+    standing: StandingLevel;
+    recover_at: number;
+    history: StandingHistoryEntry[];
+}
+interface StandingHistoryEntry {
+    level: StandingLevel;
+    reason: string;
+    set_by: string;
+    set_at: number;
+}
+interface ExistsResponse {
+    exists: boolean;
+}
+interface LimitsResponse {
+    content_length: number;
+    content_length_premium: number;
+    attachment_length: number;
+}
+interface CheckAuthResponse {
+    auth: boolean;
+    username: string;
+    token_type: "main" | "sub";
+    permissions?: TokenPermission[];
+}
+interface CheckBannedResponse {
+    banned: string[];
+}
+interface EscrowTransferResult {
+    message: string;
+    from: Username;
+    amount: number;
+    petition_id: string;
+    new_balance: number;
+}
+interface EscrowReleaseResult {
+    message: string;
+    to: Username;
+    amount: number;
+    petition_id: string;
+    new_balance: number;
+}
+interface CosmeticCatalogEntryPublic {
+    id: string;
+    cosmetic_type: string;
+    name: string;
+    description: string;
+    image_url: string;
+    pricing_type: "free" | "paid";
+    price: number;
+    creator: Username;
+    creator_pct: number;
+    featured: boolean;
+    purchases: number;
+    created_at: number;
+}
+interface ShopResponse {
+    items: CosmeticCatalogEntryPublic[];
+    total: number;
+    offset: number;
+    limit: number;
+}
+interface MyCosmeticsResponse {
+    active_cosmetics: Record<string, CosmeticCatalogEntryPublic>;
+    owned_cosmetics: CosmeticCatalogEntryPublic[];
+}
+interface CosmeticPurchaseResult {
+    message: string;
+    cosmetic: CosmeticCatalogEntryPublic;
+    price: number;
+    creator_share?: number;
+    platform_share?: number;
+    new_total?: number;
+}
+interface AdminCosmeticCreate {
+    id: string;
+    cosmetic_type: string;
+    name: string;
+    description: string;
+    image_url: string;
+    pricing_type: "free" | "paid";
+    price: number;
+    creator: string;
+    creator_pct: number;
+    featured: boolean;
+}
+interface AdminCosmeticUpdate {
+    name?: string;
+    description?: string;
+    image_url?: string;
+    pricing_type?: "free" | "paid";
+    price?: number;
+    creator?: string;
+    creator_pct?: number;
+    featured?: boolean;
+    cosmetic_type?: string;
+}
+type WSMessage = {
+    cmd: "ready";
+    user_id: UserId;
+    username: Username;
+    user: Record<string, any>;
+} | {
+    cmd: "join_ok";
+    room: string;
+} | {
+    cmd: "room_state";
+    room: string;
+    members: RoomMember[];
+} | {
+    cmd: "member_join";
+    room: string;
+    user_id: UserId;
+    username: Username;
+    status: string;
+    presence: Presence;
+    activities?: Record<string, Activity>;
+} | {
+    cmd: "member_leave";
+    room: string;
+    user_id: UserId;
+} | {
+    cmd: "status_update";
+    room?: string;
+    user_id: UserId;
+    username?: Username;
+    status?: string;
+    presence?: Presence;
+    activities?: Record<string, Activity>;
+} | {
+    cmd: "profile_update";
+    user_id: UserId;
+    username: Username;
+    key: string;
+    value: any;
+} | {
+    cmd: "key_update";
+    key: string;
+    value: any;
+} | {
+    cmd: "error";
+    message: string;
+} | {
+    cmd: "leave_ok";
+    room: string;
+} | {
+    cmd: "rooms";
+    rooms: string[];
+};
+
+type Handler = (msg: any) => void;
+declare class RoturSocket extends EventTarget {
+    private url;
+    private ws;
+    private token;
+    private reconnectTimer;
+    private heartbeat;
+    private _connected;
+    private _userId;
+    private _username;
+    private handlers;
+    private rooms;
+    constructor(url?: string);
+    get connected(): boolean;
+    get userId(): string | null;
+    get username(): string | null;
+    get joinedRooms(): string[];
+    connect(token: string): Promise<{
+        user_id: UserId;
+        username: Username;
+        user: Record<string, any>;
+    }>;
+    private startHeartbeat;
+    private scheduleReconnect;
+    private cleanup;
+    private emit;
+    private send;
+    on(cmd: string, handler: Handler): () => void;
+    off(cmd: string, handler: Handler): void;
+    once(cmd: string): Promise<any>;
+    join(rooms: string | string[]): void;
+    leave(rooms: string | string[]): void;
+    listRooms(): Promise<string[]>;
+    roomState(room: string): void;
+    setPresence(presence: Presence): void;
+    setStatus(status: string): void;
+    addActivity(activity: Activity & {
+        id: string;
+    }): void;
+    removeActivity(id: string): void;
+    setMusic(application: string, media: ActivityMedia, title?: string): void;
+    setPlaying(application: string, options?: {
+        url?: string;
+        title?: string;
+        status?: string;
+        image?: string;
+    }): void;
+    clearActivity(id: string): void;
+    disconnect(): void;
+}
+
+declare class Rotur {
+    private _token;
+    readonly _http: Http;
+    socket: RoturSocket;
+    readonly me: MeNamespace;
+    readonly posts: PostsNamespace;
+    readonly friends: FriendsNamespace;
+    readonly following: FollowingNamespace;
+    readonly notifications: NotificationsNamespace;
+    readonly keys: KeysNamespace;
+    readonly items: ItemsNamespace;
+    readonly gifts: GiftsNamespace;
+    readonly tokens: TokensNamespace;
+    readonly groups: GroupsNamespace;
+    readonly systems: SystemsNamespace;
+    readonly stats: StatsNamespace;
+    readonly status: StatusNamespace;
+    readonly validators: ValidatorsNamespace;
+    readonly link: LinkNamespace;
+    readonly cosmetics: CosmeticsNamespace;
+    readonly push: PushNamespace;
+    readonly files: FilesNamespace;
+    readonly standing: StandingNamespace;
+    readonly profiles: ProfilesNamespace;
+    readonly devfund: DevFundNamespace;
+    readonly check: CheckNamespace;
+    constructor(options?: {
+        token?: string;
+        wsUrl?: string;
+    });
+    get token(): string | null;
+    get loggedIn(): boolean;
+    setToken(token: string): void;
+    login(options?: {
+        system?: string;
+        timeout?: number;
+        signal?: AbortSignal;
+    }): Promise<this>;
+    connectSocket(): Promise<{
+        user_id: string;
+        username: string;
+        user: Record<string, any>;
+    }>;
+    logout(): void;
+}
+declare abstract class Namespace {
+    protected r: Rotur;
+    constructor(r: Rotur);
+    protected $get<T>(path: string, params?: Record<string, any>, auth?: boolean): Promise<T>;
+    protected $post<T>(path: string, body?: any, auth?: boolean): Promise<T>;
+    protected $patch<T>(path: string, body?: any): Promise<T>;
+    protected $del<T>(path: string, body?: any): Promise<T>;
+}
+declare class ProfilesNamespace extends Namespace {
+    get(username: Username, includePosts?: boolean): Promise<UserProfile>;
+    exists(username: Username): Promise<ExistsResponse>;
+    supporters(): Promise<Array<{
+        username: Username;
+        subscription: string;
+    }>>;
+    getAvatarUrl(username: Username, cache?: string): string;
+}
+declare class MeNamespace extends Namespace {
+    get(): Promise<Record<string, any>>;
+    update(key: string, value: any): Promise<any>;
+    deleteKey(key: string): Promise<void>;
+    deleteAccount(): Promise<any>;
+    refreshToken(): Promise<{
+        token: string;
+    }>;
+    transfer(to: Username, amount: number, note?: string): Promise<any>;
+    claimDaily(): Promise<{
+        message: string;
+    }>;
+    claimTime(): Promise<{
+        wait_time: number;
+    }>;
+    badges(): Promise<{
+        badge_names: string[];
+    }>;
+    acceptTos(): Promise<{
+        message: string;
+    }>;
+    abilities(): Promise<TokenAbilities>;
+    blocked(): Promise<{
+        blocked: Username[];
+    }>;
+    block(username: Username): Promise<any>;
+    unblock(username: Username): Promise<any>;
+    note(username: Username, content: string): Promise<void>;
+    deleteNote(username: Username): Promise<void>;
+    resendVerification(): Promise<any>;
+    verifyEmail(token: string): Promise<any>;
+    checkAuth(): Promise<CheckAuthResponse>;
+    requests(): Promise<{
+        requests: Username[];
+    }>;
+    transactions(): Promise<any[]>;
+    subscription(): Promise<{
+        active: boolean;
+        tier: string;
+        next_billing: number;
+    }>;
+}
+declare class PostsNamespace extends Namespace {
+    create(content: string, options?: {
+        attachment?: string;
+        profileOnly?: boolean;
+        os?: string;
+    }): Promise<NetPost>;
+    delete(id: string): Promise<any>;
+    like(id: string): Promise<any>;
+    unlike(id: string): Promise<any>;
+    reply(id: string, content: string): Promise<NetReply>;
+    repost(id: string): Promise<NetPost>;
+    pin(id: string): Promise<any>;
+    unpin(id: string): Promise<any>;
+    feed(limit?: number, offset?: number): Promise<NetPost[]>;
+    followingFeed(limit?: number): Promise<NetPost[]>;
+    top(limit?: number, timePeriod?: number): Promise<NetPost[]>;
+    search(query: string, limit?: number): Promise<NetPost[]>;
+    limits(): Promise<LimitsResponse>;
+}
+declare class FriendsNamespace extends Namespace {
+    list(): Promise<{
+        friends: Username[];
+    }>;
+    request(username: Username): Promise<any>;
+    accept(username: Username): Promise<any>;
+    reject(username: Username): Promise<any>;
+    remove(username: Username): Promise<any>;
+}
+declare class FollowingNamespace extends Namespace {
+    follow(username: Username): Promise<any>;
+    unfollow(username: Username): Promise<any>;
+    followers(username: Username): Promise<{
+        followers: Username[];
+    }>;
+    following(username: Username): Promise<{
+        following: Username[];
+    }>;
+}
+declare class NotificationsNamespace extends Namespace {
+    list(afterDays?: number): Promise<NotificationEntry[]>;
+}
+declare class KeysNamespace extends Namespace {
+    create(name: string, options?: {
+        description?: string;
+        price?: number;
+        subscription?: boolean;
+        frequency?: number;
+        period?: string;
+    }): Promise<any>;
+    mine(): Promise<NetKey[]>;
+    get(id: string): Promise<KeyPublic>;
+    check(username: Username, key: string): Promise<{
+        owned: boolean;
+    }>;
+    rename(id: string, name: string): Promise<any>;
+    update(id: string, key: string, data: string): Promise<any>;
+    revoke(id: string, user: Username): Promise<any>;
+    delete(id: string): Promise<any>;
+    addUser(id: string, user: Username): Promise<any>;
+    removeUser(id: string, user: Username): Promise<any>;
+    buy(id: string): Promise<any>;
+    cancel(id: string): Promise<any>;
+}
+declare class ItemsNamespace extends Namespace {
+    create(item: {
+        name: string;
+        description?: string;
+        price?: number;
+        selling?: boolean;
+        data?: any;
+    }): Promise<NetItem>;
+    get(name: string): Promise<NetItem>;
+    list(username: Username): Promise<NetItem[]>;
+    selling(limit?: number): Promise<NetItem[]>;
+    buy(name: string): Promise<any>;
+    transfer(name: string, username: Username): Promise<any>;
+    sell(name: string): Promise<any>;
+    stopSelling(name: string): Promise<any>;
+    setPrice(name: string, price: number): Promise<any>;
+    update(name: string, data: Record<string, any>): Promise<NetItem>;
+    delete(name: string): Promise<any>;
+}
+declare class GiftsNamespace extends Namespace {
+    create(amount: number, options?: {
+        note?: string;
+        expiresInHrs?: number;
+    }): Promise<any>;
+    get(code: string): Promise<{
+        gift: GiftPublic;
+    }>;
+    claim(code: string): Promise<any>;
+    cancel(id: string): Promise<any>;
+    mine(): Promise<{
+        gifts: GiftNet[];
+        count: number;
+    }>;
+}
+declare class TokensNamespace extends Namespace {
+    permissions(): Promise<{
+        permissions: TokenPermission[];
+        groups: PermissionGroup[];
+    }>;
+    list(): Promise<{
+        tokens: SubTokenPublic[];
+        total: number;
+    }>;
+    active(): Promise<{
+        tokens: SubTokenPublic[];
+        total: number;
+    }>;
+    create(name: string, permissions: TokenPermission[], options?: {
+        expiresInHrs?: number;
+        origin?: string;
+        description?: string;
+        websites?: string[];
+    }): Promise<SubTokenCreate>;
+    get(id: string): Promise<SubTokenPublic>;
+    activity(id: string): Promise<any>;
+    update(id: string, options: {
+        name?: string;
+        permissions?: TokenPermission[];
+        description?: string;
+        websites?: string[];
+    }): Promise<SubTokenPublic>;
+    rename(id: string, name: string): Promise<any>;
+    revoke(id: string): Promise<any>;
+    delete(id: string): Promise<any>;
+}
+declare class GroupsNamespace extends Namespace {
+    mine(): Promise<GroupPublic[]>;
+    search(query: string): Promise<GroupPublic[]>;
+    create(tag: string, name: string, options?: {
+        description?: string;
+        iconUrl?: string;
+        bannerUrl?: string;
+        public?: boolean;
+        joinPolicy?: JoinPolicy;
+    }): Promise<GroupPublic>;
+    get(grouptag: string): Promise<GroupPublic>;
+    update(grouptag: string, updates: Record<string, any>): Promise<GroupPublic>;
+    delete(grouptag: string): Promise<any>;
+    join(grouptag: string): Promise<GroupPublic>;
+    leave(grouptag: string): Promise<any>;
+    represent(grouptag: string): Promise<any>;
+    disrepresent(grouptag: string): Promise<any>;
+    report(grouptag: string): Promise<any>;
+    announcements(grouptag: string): Promise<GroupAnnouncement[]>;
+    createAnnouncement(grouptag: string, title: string, body: string, options?: {
+        pingMembers?: boolean;
+    }): Promise<GroupAnnouncement>;
+    deleteAnnouncement(grouptag: string, id: string): Promise<any>;
+    muteAnnouncements(grouptag: string): Promise<any>;
+    events(grouptag: string): Promise<GroupEvent[]>;
+    createEvent(grouptag: string, event: Partial<GroupEvent>): Promise<GroupEvent>;
+    tips(grouptag: string): Promise<GroupTip[]>;
+    sendTip(grouptag: string, amount: number): Promise<any>;
+    roles(grouptag: string): Promise<GroupRole[]>;
+    createRole(grouptag: string, role: Partial<GroupRole>): Promise<GroupRole>;
+    updateRole(grouptag: string, roleId: string, updates: Partial<GroupRole>): Promise<GroupRole>;
+    deleteRole(grouptag: string, roleId: string): Promise<any>;
+    userRoles(grouptag: string, userId: UserId): Promise<GroupRole[]>;
+    userPermissions(grouptag: string, userId: UserId): Promise<string[]>;
+    userBenefits(grouptag: string, userId: UserId): Promise<string[]>;
+    assignRole(grouptag: string, userId: UserId, roleId: string): Promise<any>;
+    removeRole(grouptag: string, userId: UserId, roleId: string): Promise<any>;
+}
+declare class SystemsNamespace extends Namespace {
+    list(): Promise<Record<string, System>>;
+    users(system: string): Promise<Username[]>;
+    update(system: string, key: string, value: any): Promise<any>;
+    reload(): Promise<any>;
+}
+declare class StatsNamespace extends Namespace {
+    economy(): Promise<EconomyStats>;
+    users(): Promise<UserStats>;
+    mostGained(max?: number): Promise<Array<{
+        user: Username;
+        earned: number;
+    }>>;
+    systems(): Promise<Record<string, number>>;
+    followers(max?: number): Promise<Array<{
+        username: Username;
+        follower_count: number;
+    }>>;
+}
+declare class StatusNamespace extends Namespace {
+    get(username: Username): Promise<UserStatusResponse>;
+}
+declare class ValidatorsNamespace extends Namespace {
+    generate(key: string): Promise<ValidatorGenerateResult>;
+    validate(validator: string, key: string): Promise<ValidatorResult>;
+}
+declare class LinkNamespace extends Namespace {
+    getCode(): Promise<{
+        code: string;
+    }>;
+    status(code: string): Promise<{
+        status: string;
+    }>;
+    linkedUser(code: string): Promise<{
+        linked: boolean;
+        token?: string;
+    }>;
+    linkCode(code: string): Promise<string>;
+    pollUntilLinked(code: string, intervalMs?: number, timeoutMs?: number): Promise<string>;
+}
+declare class CosmeticsNamespace extends Namespace {
+    shop(options?: {
+        type?: string;
+        featured?: boolean;
+        search?: string;
+        sort?: "newest" | "price_low" | "price_high" | "popular";
+        limit?: number;
+        offset?: number;
+    }): Promise<ShopResponse>;
+    get(id: string): Promise<CosmeticCatalogEntryPublic>;
+    mine(): Promise<MyCosmeticsResponse>;
+    purchase(id: string): Promise<CosmeticPurchaseResult>;
+    equip(id: string): Promise<{
+        message: string;
+    }>;
+    unequip(type: string): Promise<{
+        message: string;
+    }>;
+    overlays(filepath: string): Promise<Response>;
+    /** Admin: List all cosmetics in catalog */
+    adminList(options?: {
+        type?: string;
+    }): Promise<{
+        cosmetics: CosmeticCatalogEntryPublic[];
+        total: number;
+    }>;
+    /** Admin: Create a cosmetic */
+    adminCreate(data: AdminCosmeticCreate): Promise<{
+        message: string;
+        cosmetic: CosmeticCatalogEntryPublic;
+    }>;
+    /** Admin: Update a cosmetic */
+    adminUpdate(id: string, data: AdminCosmeticUpdate): Promise<{
+        message: string;
+        cosmetic: CosmeticCatalogEntryPublic;
+    }>;
+    /** Admin: Delete a cosmetic */
+    adminDelete(id: string): Promise<{
+        message: string;
+    }>;
+}
+declare class PushNamespace extends Namespace {
+    vapidKeys(): Promise<{
+        public_key: string;
+        subject: string;
+    }>;
+    register(endpoint: string, p256dh: string, auth: string, source: string, fingerprint: string): Promise<any>;
+    check(source: string, fingerprint: string): Promise<{
+        registered: boolean;
+        device_id?: string;
+    }>;
+    endpoints(): Promise<{
+        endpoints: NotifyEndpoint[];
+        count: number;
+    }>;
+    deleteDevice(deviceId: string): Promise<any>;
+    allowedSenders(): Promise<Record<string, {
+        senders: NotifyAllowedSender[];
+    }>>;
+    allowSender(username: Username, source: string): Promise<any>;
+    removeSender(username: Username, source: string): Promise<any>;
+    log(): Promise<{
+        log: NotifyLogEntry[];
+        count: number;
+    }>;
+    send(username: Username, source: string, options?: {
+        title?: string;
+        body?: string;
+        data?: Record<string, any>;
+    }): Promise<any>;
+    sendMany(users: string[], source: string, options?: {
+        title?: string;
+        body?: string;
+        data?: Record<string, any>;
+    }): Promise<any>;
+    notifiableUsers(source: string): Promise<{
+        source: string;
+        users: Array<{
+            username: Username;
+            id: UserId;
+        }>;
+    }>;
+}
+declare class FilesNamespace extends Namespace {
+    index(): Promise<FileEntry[]>;
+    all(): Promise<FileEntry[]>;
+    getByUUID(uuid: string): Promise<FileEntry>;
+    getByPath(path: string): Promise<FileEntry>;
+    usage(): Promise<{
+        used: number;
+        max: number;
+    }>;
+    stats(uuids: string[]): Promise<any>;
+    byUUIDs(uuids: string[]): Promise<FileEntry[]>;
+    pathIndex(): Promise<any>;
+    upload(files: Record<string, any>): Promise<any>;
+    deleteAll(): Promise<any>;
+}
+declare class StandingNamespace extends Namespace {
+    get(username: Username): Promise<StandingInfo>;
+}
+declare class DevFundNamespace extends Namespace {
+    /** Transfer credits to escrow for a dev fund petition */
+    escrowTransfer(amount: number, petitionId: string, note?: string): Promise<EscrowTransferResult>;
+    /** Release escrow credits to a developer (admin only) */
+    escrowRelease(amount: number, toUsername: Username, petitionId: string, note?: string): Promise<EscrowReleaseResult>;
+}
+declare class CheckNamespace extends Namespace {
+    /** Check if a list of usernames are banned */
+    banned(usernames: Username[]): Promise<CheckBannedResponse>;
+}
+
+interface AuthOptions {
+    system?: string;
+    timeout?: number;
+    signal?: AbortSignal;
+}
+interface AuthResult {
+    token: string;
+}
+declare class AuthError extends Error {
+    code: "timeout" | "aborted" | "popup_blocked" | "no_token";
+    constructor(code: "timeout" | "aborted" | "popup_blocked" | "no_token", message: string);
+}
+declare function performAuth(options?: AuthOptions): Promise<AuthResult>;
+
+export { type Activity, type ActivityApplication, type ActivityMedia, type AdminCosmeticCreate, type AdminCosmeticUpdate, ApiError, AuthError, type AuthOptions, type AuthResult, type Badge, type CheckAuthResponse, type CheckBannedResponse, type CosmeticCatalogEntryPublic, type CosmeticItem, type CosmeticPurchaseResult, type EconomyStats, type EscrowReleaseResult, type EscrowTransferResult, type ExistsResponse, type FileEntry, type GiftNet, type GiftPublic, type GroupAnnouncement, type GroupEvent, type GroupPublic, type GroupRole, type GroupTip, type JoinPolicy, type KeyPublic, type KeySubscription, type KeyUserData, type LimitsResponse, type MyCosmeticsResponse, type NetItem, type NetKey, type NetPost, type NetReply, type NetTransferHistory, type NotificationEntry, type NotifyAllowedSender, type NotifyEndpoint, type NotifyLogEntry, type PermissionGroup, type Presence, type RoomMember, Rotur, RoturSocket, type ShopResponse, type StandingHistoryEntry, type StandingInfo, type StandingLevel, type SubTokenCreate, type SubTokenPublic, type System, type TokenAbilities, type TokenPermission, type Transaction, type UserId, type UserProfile, type UserStats, type UserStatusResponse, type Username, type ValidatorGenerateResult, type ValidatorResult, type WSMessage, performAuth };