@haven-chat-org/core 1.0.0

package/dist/export/reader.js

@@ -0,0 +1,101 @@
+import { unzipSync } from "fflate";
+import { fromBase64 } from "../crypto/utils.js";
+import { verifyManifest, computeFileHash } from "./signing.js";
+/**
+ * Reads and verifies a .haven archive (ZIP).
+ */
+export class HavenArchiveReader {
+    files;
+    manifest;
+    constructor(files, manifest) {
+        this.files = files;
+        this.manifest = manifest;
+    }
+    /**
+     * Parse a .haven archive from raw ZIP bytes.
+     */
+    static async fromBlob(data) {
+        const files = unzipSync(data);
+        const manifestData = files["manifest.json"];
+        if (!manifestData) {
+            throw new Error("Invalid .haven archive: missing manifest.json");
+        }
+        const manifest = JSON.parse(new TextDecoder().decode(manifestData));
+        return new HavenArchiveReader(files, manifest);
+    }
+    getManifest() {
+        return this.manifest;
+    }
+    getChannelExport(channelName) {
+        // Try channels/ first, then dms/
+        const key = `channels/${channelName}.json`;
+        const dmKey = `dms/${channelName}.json`;
+        const data = this.files[key] ?? this.files[dmKey];
+        if (!data)
+            return null;
+        return JSON.parse(new TextDecoder().decode(data));
+    }
+    /** Return all channel exports (channels/ and dms/ directories). */
+    getChannelExports() {
+        const results = [];
+        const decoder = new TextDecoder();
+        for (const [path, data] of Object.entries(this.files)) {
+            if ((path.startsWith("channels/") || path.startsWith("dms/")) && path.endsWith(".json")) {
+                try {
+                    results.push(JSON.parse(decoder.decode(data)));
+                }
+                catch {
+                    // Skip malformed channel files
+                }
+            }
+        }
+        return results;
+    }
+    getServerMeta() {
+        const data = this.files["server.json"];
+        if (!data)
+            return null;
+        return JSON.parse(new TextDecoder().decode(data));
+    }
+    getAttachment(fileRef) {
+        return this.files[fileRef] ?? null;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getAuditLog() {
+        const data = this.files["audit-log.json"];
+        if (!data)
+            return null;
+        return JSON.parse(new TextDecoder().decode(data));
+    }
+    /**
+     * Verify archive integrity: file hashes and optional Ed25519 signature.
+     */
+    async verify() {
+        const issues = [];
+        // Check all files listed in manifest exist and match hashes
+        for (const [path, expected] of Object.entries(this.manifest.files)) {
+            const fileData = this.files[path];
+            if (!fileData) {
+                issues.push(`Missing file: ${path}`);
+                continue;
+            }
+            const actualHash = await computeFileHash(fileData);
+            if (actualHash !== expected.sha256) {
+                issues.push(`Hash mismatch for ${path}: expected ${expected.sha256}, got ${actualHash}`);
+            }
+            if (fileData.byteLength !== expected.size) {
+                issues.push(`Size mismatch for ${path}: expected ${expected.size}, got ${fileData.byteLength}`);
+            }
+        }
+        // Verify Ed25519 signature if present
+        if (this.manifest.user_signature) {
+            const publicKey = fromBase64(this.manifest.exported_by.identity_key);
+            const valid = verifyManifest(this.manifest, this.manifest.user_signature, publicKey);
+            if (!valid) {
+                issues.push("User signature verification failed");
+            }
+        }
+        return { valid: issues.length === 0, issues };
+    }
+}
+//# sourceMappingURL=reader.js.map

package/dist/export/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/export/reader.ts"],"names":[],"mappings":"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"}

package/dist/export/signing.d.ts

@@ -0,0 +1,15 @@
+import type { HavenManifest } from "./types.js";
+/**
+ * Sign a manifest with an Ed25519 private key.
+ * Returns a base64-encoded detached signature.
+ */
+export declare function signManifest(manifest: HavenManifest, privateKey: Uint8Array): string;
+/**
+ * Verify an Ed25519 signature over a manifest.
+ */
+export declare function verifyManifest(manifest: HavenManifest, signature: string, publicKey: Uint8Array): boolean;
+/**
+ * Compute SHA-256 hex digest of arbitrary data.
+ * Uses libsodium for Node.js + browser compatibility.
+ */
+export declare function computeFileHash(data: Uint8Array): Promise<string>;

package/dist/export/signing.js

@@ -0,0 +1,44 @@
+import { getSodium, toBase64, fromBase64 } from "../crypto/utils.js";
+/**
+ * Produce a canonical JSON representation of the manifest for signing.
+ * Excludes signature fields and uses sorted keys for determinism.
+ */
+function canonicalManifest(manifest) {
+    const { user_signature: _u, server_signature: _s, ...rest } = manifest;
+    return JSON.stringify(rest, Object.keys(rest).sort());
+}
+/**
+ * Sign a manifest with an Ed25519 private key.
+ * Returns a base64-encoded detached signature.
+ */
+export function signManifest(manifest, privateKey) {
+    const sodium = getSodium();
+    const message = new TextEncoder().encode(canonicalManifest(manifest));
+    const signature = sodium.crypto_sign_detached(message, privateKey);
+    return toBase64(signature);
+}
+/**
+ * Verify an Ed25519 signature over a manifest.
+ */
+export function verifyManifest(manifest, signature, publicKey) {
+    const sodium = getSodium();
+    const message = new TextEncoder().encode(canonicalManifest(manifest));
+    try {
+        return sodium.crypto_sign_verify_detached(fromBase64(signature), message, publicKey);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Compute SHA-256 hex digest of arbitrary data.
+ * Uses libsodium for Node.js + browser compatibility.
+ */
+export async function computeFileHash(data) {
+    const sodium = getSodium();
+    const hash = sodium.crypto_hash_sha256(data);
+    return Array.from(hash)
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+}
+//# sourceMappingURL=signing.js.map

package/dist/export/signing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.js","sourceRoot":"","sources":["../../src/export/signing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrE;;;GAGG;AACH,SAAS,iBAAiB,CAAC,QAAuB;IAChD,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC;IACvE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAuB,EAAE,UAAsB;IAC1E,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnE,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAuB,EACvB,SAAiB,EACjB,SAAqB;IAErB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,2BAA2B,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAgB;IACpD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAkB,CAAC;SAClC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACnD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/export/types.d.ts

@@ -0,0 +1,128 @@
+/** Top-level manifest included in every .haven archive. */
+export interface HavenManifest {
+    version: number;
+    format: "haven-export";
+    exported_by: {
+        user_id: string;
+        username: string;
+        identity_key: string;
+    };
+    exported_at: string;
+    scope?: "server" | "channel" | "dm";
+    server_id?: string;
+    channel_id?: string;
+    instance_url: string;
+    files: Record<string, {
+        sha256: string;
+        size: number;
+    }>;
+    message_count: number;
+    date_range: {
+        from: string;
+        to: string;
+    };
+    user_signature?: string;
+    server_signature?: string;
+}
+/** Per-channel export data stored in channels/<name>.json or dms/<name>.json. */
+export interface HavenChannelExport {
+    channel: {
+        id: string;
+        name: string;
+        type: string;
+        encrypted: boolean;
+        category?: string;
+        created_at: string;
+    };
+    exported_at: string;
+    exported_by: string;
+    message_count: number;
+    date_range: {
+        from: string;
+        to: string;
+    };
+    messages: HavenExportMessage[];
+}
+/** A single message in the export. */
+export interface HavenExportMessage {
+    id: string;
+    sender_id: string;
+    sender_name: string;
+    sender_display_name: string | null;
+    timestamp: string;
+    text: string | null;
+    content_type: string;
+    formatting: string | null;
+    edited: boolean;
+    reply_to: string | null;
+    type: string;
+    reactions: {
+        emoji: string;
+        count: number;
+        users: string[];
+    }[];
+    pinned: boolean;
+    attachments: HavenAttachmentRef[];
+}
+/** Reference to an attachment file within the archive. */
+export interface HavenAttachmentRef {
+    id: string;
+    filename: string;
+    mime_type: string;
+    size: number;
+    width?: number;
+    height?: number;
+    file_ref: string;
+}
+/** Server-level metadata export stored in server.json. */
+export interface HavenServerExport {
+    server: {
+        id: string;
+        name: string;
+        description: string | null;
+        icon_url: string | null;
+        created_at: string;
+    };
+    categories: {
+        id: string;
+        name: string;
+        position: number;
+    }[];
+    channels: {
+        id: string;
+        name: string;
+        type: string;
+        category_id: string | null;
+        position: number;
+        encrypted: boolean;
+        is_private: boolean;
+    }[];
+    roles: {
+        id: string;
+        name: string;
+        color: string | null;
+        permissions: number;
+        position: number;
+        is_default: boolean;
+    }[];
+    members: {
+        user_id: string;
+        username: string;
+        display_name: string | null;
+        nickname: string | null;
+        roles: string[];
+        joined_at: string;
+    }[];
+    emojis: {
+        id: string;
+        name: string;
+        image_ref?: string;
+    }[];
+    permission_overwrites: {
+        channel_id: string;
+        target_type: string;
+        target_id: string;
+        allow: number;
+        deny: number;
+    }[];
+}

package/dist/export/types.js

@@ -0,0 +1,3 @@
+// ─── Haven Export Archive Types ─────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/export/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/export/types.ts"],"names":[],"mappings":"AAAA,2DAA2D"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./crypto/index.js";
+export * from "./net/index.js";
+export * from "./store/index.js";
+export * from "./export/index.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./crypto/index.js";
+export * from "./net/index.js";
+export * from "./store/index.js";
+export * from "./export/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/net/api.d.ts

@@ -0,0 +1,200 @@
+import type { RegisterInput, LoginRequest, AuthResponse, LoginResponse, TotpSetupResponse, TotpVerifyRequest, KeyBundle, UploadPreKeysRequest, PreKeyCountResponse, CreateServerRequest, ServerResponse, CreateChannelRequest, ChannelResponse, CreateDmRequest, SendMessageRequest, MessageResponse, MessageQuery, UploadResponse, CreateInviteRequest, InviteResponse, ServerMemberResponse, DistributeSenderKeyRequest, SenderKeyDistributionResponse, ChannelMemberKeyInfo, PresenceEntry, UpdateKeysRequest, ReactionGroup, UserProfileResponse, UpdateProfileRequest, BlockedUserResponse, CategoryResponse, CreateCategoryRequest, UpdateCategoryRequest, ReorderCategoriesRequest, ReorderChannelsRequest, SetChannelCategoryRequest, RoleResponse, CreateRoleRequest, UpdateRoleRequest, AssignRoleRequest, OverwriteResponse, SetOverwriteRequest, FriendResponse, FriendRequestBody, DmRequestAction, UpdateDmPrivacyRequest, ChangePasswordRequest, CreateGroupDmRequest, ChannelMemberInfo, BanResponse, CreateBanRequest, CreateReportRequest, ReportResponse, VoiceTokenResponse, VoiceParticipant, UploadKeyBackupRequest, KeyBackupResponse, KeyBackupStatusResponse, CustomEmojiResponse, PowChallengeResponse, AuditLogEntry, ReadStateResponse, ChannelUnreadInfo, AdminStats, AdminUserResponse, InviteRequiredResponse, RegistrationInviteResponse, GifSearchResponse, SessionResponse, RestoreServerResponse, ImportMessage } from "../types.js";
+export interface ApiClientOptions {
+    baseUrl: string;
+    onTokenExpired?: () => void;
+}
+/**
+ * Type-safe REST client for the Haven backend.
+ * Handles JWT token management and automatic refresh.
+ */
+export declare class HavenApi {
+    private baseUrl;
+    private accessToken;
+    private refreshToken;
+    private onTokenExpired?;
+    constructor(options: ApiClientOptions);
+    /** Set auth tokens (after login/register/refresh). */
+    setTokens(access: string, refresh: string): void;
+    clearTokens(): void;
+    get currentAccessToken(): string | null;
+    /** Fetch a PoW challenge from the server. */
+    getChallenge(): Promise<PowChallengeResponse>;
+    /**
+     * Register a new account. Automatically fetches and solves a PoW challenge.
+     * The PoW solving runs in a Web Worker when available, otherwise falls back to main thread.
+     */
+    register(input: RegisterInput): Promise<AuthResponse>;
+    login(req: LoginRequest): Promise<LoginResponse>;
+    refresh(): Promise<AuthResponse>;
+    logout(): Promise<void>;
+    totpSetup(): Promise<TotpSetupResponse>;
+    totpVerify(req: TotpVerifyRequest): Promise<void>;
+    totpDisable(): Promise<void>;
+    changePassword(req: ChangePasswordRequest): Promise<void>;
+    getSessions(): Promise<SessionResponse[]>;
+    revokeSession(familyId: string): Promise<void>;
+    getUserByUsername(username: string): Promise<import("../types.js").UserPublic>;
+    getKeyBundle(userId: string): Promise<KeyBundle>;
+    uploadPreKeys(req: UploadPreKeysRequest): Promise<void>;
+    /** Delete all unused one-time prekeys from the server (stale keys whose private keys are lost). */
+    clearPreKeys(): Promise<void>;
+    getPreKeyCount(): Promise<PreKeyCountResponse>;
+    updateKeys(req: UpdateKeysRequest): Promise<void>;
+    uploadKeyBackup(req: UploadKeyBackupRequest): Promise<void>;
+    getKeyBackup(): Promise<KeyBackupResponse>;
+    getKeyBackupStatus(): Promise<KeyBackupStatusResponse>;
+    deleteKeyBackup(): Promise<void>;
+    listServers(): Promise<ServerResponse[]>;
+    createServer(req: CreateServerRequest): Promise<ServerResponse>;
+    getServer(serverId: string): Promise<ServerResponse>;
+    getMyPermissions(serverId: string): Promise<{
+        permissions: string;
+        is_owner: boolean;
+    }>;
+    updateServer(serverId: string, req: {
+        system_channel_id?: string | null;
+        encrypted_meta?: string;
+    }): Promise<{
+        ok: boolean;
+    }>;
+    listServerChannels(serverId: string): Promise<ChannelResponse[]>;
+    createChannel(serverId: string, req: CreateChannelRequest): Promise<ChannelResponse>;
+    joinChannel(channelId: string): Promise<void>;
+    updateChannel(channelId: string, req: {
+        encrypted_meta: string;
+        encrypted?: boolean;
+    }): Promise<ChannelResponse>;
+    deleteChannel(channelId: string): Promise<void>;
+    listDmChannels(): Promise<ChannelResponse[]>;
+    createDm(req: CreateDmRequest): Promise<ChannelResponse>;
+    createGroupDm(req: CreateGroupDmRequest): Promise<ChannelResponse>;
+    listChannelMembers(channelId: string): Promise<ChannelMemberInfo[]>;
+    leaveChannel(channelId: string): Promise<void>;
+    hideChannel(channelId: string): Promise<void>;
+    logExport(req: {
+        scope: string;
+        server_id?: string;
+        channel_id?: string;
+        message_count: number;
+    }): Promise<void>;
+    restoreServer(serverId: string, data: import("../export/types.js").HavenServerExport): Promise<RestoreServerResponse>;
+    importMessages(channelId: string, messages: ImportMessage[]): Promise<{
+        imported: number;
+    }>;
+    listCategories(serverId: string): Promise<CategoryResponse[]>;
+    createCategory(serverId: string, req: CreateCategoryRequest): Promise<CategoryResponse>;
+    updateCategory(serverId: string, categoryId: string, req: UpdateCategoryRequest): Promise<CategoryResponse>;
+    deleteCategory(serverId: string, categoryId: string): Promise<void>;
+    reorderCategories(serverId: string, req: ReorderCategoriesRequest): Promise<void>;
+    reorderChannels(serverId: string, req: ReorderChannelsRequest): Promise<void>;
+    setChannelCategory(channelId: string, req: SetChannelCategoryRequest): Promise<ChannelResponse>;
+    listRoles(serverId: string): Promise<RoleResponse[]>;
+    createRole(serverId: string, req: CreateRoleRequest): Promise<RoleResponse>;
+    updateRole(serverId: string, roleId: string, req: UpdateRoleRequest): Promise<RoleResponse>;
+    deleteRole(serverId: string, roleId: string): Promise<void>;
+    assignRole(serverId: string, userId: string, req: AssignRoleRequest): Promise<void>;
+    unassignRole(serverId: string, userId: string, roleId: string): Promise<void>;
+    listOverwrites(channelId: string): Promise<OverwriteResponse[]>;
+    setOverwrite(channelId: string, req: SetOverwriteRequest): Promise<OverwriteResponse>;
+    deleteOverwrite(channelId: string, targetType: string, targetId: string): Promise<void>;
+    getMessages(channelId: string, query?: MessageQuery): Promise<MessageResponse[]>;
+    sendMessage(channelId: string, req: SendMessageRequest): Promise<MessageResponse>;
+    getChannelReactions(channelId: string): Promise<ReactionGroup[]>;
+    getMessageReactions(messageId: string): Promise<ReactionGroup[]>;
+    getPinnedMessages(channelId: string): Promise<MessageResponse[]>;
+    getPinnedMessageIds(channelId: string): Promise<string[]>;
+    /** Upload encrypted blob directly to backend. Returns attachment_id + storage_key. */
+    uploadAttachment(blob: ArrayBuffer): Promise<UploadResponse>;
+    /** Download encrypted blob from backend. Returns raw bytes. */
+    downloadAttachment(attachmentId: string): Promise<ArrayBuffer>;
+    /** Toggle DM export consent for a channel. */
+    setExportConsent(channelId: string, allowed: boolean): Promise<void>;
+    createInvite(serverId: string, req: CreateInviteRequest): Promise<InviteResponse>;
+    listInvites(serverId: string): Promise<InviteResponse[]>;
+    deleteInvite(serverId: string, inviteId: string): Promise<void>;
+    joinByInvite(code: string): Promise<ServerResponse>;
+    listServerMembers(serverId: string): Promise<ServerMemberResponse[]>;
+    kickMember(serverId: string, userId: string): Promise<void>;
+    setNickname(serverId: string, nickname: string | null): Promise<void>;
+    setMemberNickname(serverId: string, userId: string, nickname: string | null): Promise<void>;
+    leaveServer(serverId: string): Promise<void>;
+    deleteServer(serverId: string): Promise<void>;
+    banMember(serverId: string, userId: string, req: CreateBanRequest): Promise<BanResponse>;
+    revokeBan(serverId: string, userId: string): Promise<void>;
+    listBans(serverId: string): Promise<BanResponse[]>;
+    markChannelRead(channelId: string): Promise<ReadStateResponse>;
+    getReadStates(): Promise<ChannelUnreadInfo[]>;
+    getAdminStats(): Promise<AdminStats>;
+    listAdminUsers(search?: string, limit?: number, offset?: number): Promise<AdminUserResponse[]>;
+    setUserAdmin(userId: string, isAdmin: boolean): Promise<void>;
+    adminDeleteUser(userId: string): Promise<void>;
+    timeoutMember(serverId: string, userId: string, durationSeconds: number, reason?: string): Promise<void>;
+    removeTimeout(serverId: string, userId: string): Promise<void>;
+    bulkDeleteMessages(channelId: string, messageIds: string[]): Promise<void>;
+    getAuditLog(serverId: string, opts?: {
+        limit?: number;
+        before?: string;
+    }): Promise<AuditLogEntry[]>;
+    addGroupMember(channelId: string, userId: string): Promise<void>;
+    distributeSenderKeys(channelId: string, req: DistributeSenderKeyRequest): Promise<void>;
+    getSenderKeys(channelId: string): Promise<SenderKeyDistributionResponse[]>;
+    getChannelMemberKeys(channelId: string): Promise<ChannelMemberKeyInfo[]>;
+    fetchLinkPreview(url: string): Promise<{
+        url: string;
+        title?: string;
+        description?: string;
+        image?: string;
+        site_name?: string;
+    }>;
+    getPresence(userIds: string[]): Promise<PresenceEntry[]>;
+    getUserProfile(userId: string, serverId?: string): Promise<UserProfileResponse>;
+    updateProfile(req: UpdateProfileRequest): Promise<import("../types.js").UserPublic>;
+    uploadAvatar(blob: ArrayBuffer): Promise<import("../types.js").UserPublic>;
+    uploadBanner(blob: ArrayBuffer): Promise<import("../types.js").UserPublic>;
+    distributeProfileKeys(req: import("../types.js").DistributeProfileKeysRequest): Promise<{
+        distributed: number;
+    }>;
+    getProfileKey(userId: string): Promise<import("../types.js").ProfileKeyResponse>;
+    listFriends(): Promise<FriendResponse[]>;
+    sendFriendRequest(req: FriendRequestBody): Promise<FriendResponse>;
+    acceptFriendRequest(friendshipId: string): Promise<FriendResponse>;
+    declineFriendRequest(friendshipId: string): Promise<void>;
+    removeFriend(friendshipId: string): Promise<void>;
+    listDmRequests(): Promise<ChannelResponse[]>;
+    handleDmRequest(channelId: string, req: DmRequestAction): Promise<void>;
+    updateDmPrivacy(req: UpdateDmPrivacyRequest): Promise<void>;
+    blockUser(userId: string): Promise<void>;
+    unblockUser(userId: string): Promise<void>;
+    getBlockedUsers(): Promise<BlockedUserResponse[]>;
+    reportMessage(req: CreateReportRequest): Promise<ReportResponse>;
+    listServerEmojis(serverId: string): Promise<CustomEmojiResponse[]>;
+    uploadEmoji(serverId: string, name: string, imageData: ArrayBuffer): Promise<CustomEmojiResponse>;
+    renameEmoji(serverId: string, emojiId: string, name: string): Promise<CustomEmojiResponse>;
+    deleteEmoji(serverId: string, emojiId: string): Promise<void>;
+    uploadServerIcon(serverId: string, blob: ArrayBuffer): Promise<{
+        icon_url: string;
+    }>;
+    deleteServerIcon(serverId: string): Promise<void>;
+    /** Check if the instance requires an invite code to register (no auth needed). */
+    checkInviteRequired(): Promise<InviteRequiredResponse>;
+    /** List the current user's registration invite codes. */
+    listMyRegistrationInvites(): Promise<RegistrationInviteResponse[]>;
+    deleteAccount(password: string): Promise<void>;
+    joinVoice(channelId: string): Promise<VoiceTokenResponse>;
+    leaveVoice(channelId: string): Promise<void>;
+    getVoiceParticipants(channelId: string): Promise<VoiceParticipant[]>;
+    serverMuteUser(channelId: string, userId: string, muted: boolean): Promise<void>;
+    serverDeafenUser(channelId: string, userId: string, deafened: boolean): Promise<void>;
+    searchGifs(query: string, offset?: number): Promise<GifSearchResponse>;
+    trendingGifs(): Promise<GifSearchResponse>;
+    private get;
+    private post;
+    private put;
+    private patch;
+    private delete;
+    private request;
+}
+export declare class HavenApiError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}