@sidebandchat/client 0.0.0-stage → 0.2.0

package/dist/client/sideband-client.d.ts

@@ -0,0 +1,141 @@
+import type { ChannelId, CommunityId, ConversationId, DeviceId, UserId } from "../entity-id.js";
+import type { InboxEntry } from "../domain.js";
+import { ActivitySharingController, type ActivitySharingPlatform } from "../activity/activity-sharing-controller.js";
+import type { InstanceEndpoint } from "../instance-endpoint.js";
+import type { InstancePolicy } from "../instance/instance-policy.js";
+import { SbpMessagingClient } from "../conversations/messaging-client.js";
+import { SbpCommunitiesClient } from "../communities/community-client.js";
+import { SbpAttachmentsClient } from "../attachments/attachment-client.js";
+import { SbpCallsClient } from "../calls/calls-client.js";
+import { SbpPrivateConversationsClient } from "../private-conversation/private-conversations-client.js";
+import { SbpDevicesClient } from "../devices/device-client.js";
+import { SbpRealtimeClient } from "../realtime/realtime-client.js";
+import { SessionRuntime } from "./session-runtime.js";
+import { EphemeralStateController } from "./ephemeral-state.js";
+import type { CallMediaAdapter, PrivateCryptoAdapter, PrivateTransferAdapter, CallMediaPreferences } from "./platform-adapters.js";
+import { SbpSocialClient } from "../social/social-client.js";
+import { WorkspaceController } from "../workspace/workspace-controller.js";
+import { RepliesController } from "../conversations/replies-controller.js";
+import { type SbpSessionOptions } from "../sbp/session.js";
+import { AccountStateController, type MessageCache, type AccountState } from "./state.js";
+export type AccountKey = {
+    instanceDomain: string;
+    userId: UserId;
+    username?: string;
+};
+export type StoredCredential = AccountKey & {
+    deviceId: DeviceId;
+    token: Uint8Array;
+    expiresAt: string;
+    username?: string;
+};
+export type CredentialStore = {
+    load: (account: AccountKey) => Promise<StoredCredential | undefined>;
+    save: (credential: StoredCredential) => Promise<void>;
+    delete: (account: AccountKey) => Promise<void>;
+};
+export type SidebandClientState = {
+    connection: "offline" | "connecting" | "reconnecting" | "online";
+    endpoint?: InstanceEndpoint;
+    policy?: InstancePolicy;
+    account?: AccountState;
+    error?: unknown;
+};
+export type SidebandClientOptions = {
+    clientFamily: string;
+    clientVersion: string;
+    credentials: CredentialStore;
+    messages?: (account: AccountKey) => MessageCache;
+    session?: SbpSessionOptions;
+    capabilities?: number[];
+    onError?: (reason: unknown) => void;
+    media?: CallMediaAdapter;
+    privateCrypto?: PrivateCryptoAdapter;
+    privateTransfers?: PrivateTransferAdapter;
+    mediaPreferences?: CallMediaPreferences;
+};
+/**
+ * Owns one authenticated SBP account lifecycle. Platform applications supply
+ * secure credential and message persistence, but never manipulate the
+ * protocol session directly.
+ */
+export declare class SidebandClient {
+    private readonly options;
+    private current;
+    private listeners;
+    private notificationListeners;
+    private session?;
+    private liveEvents?;
+    private stateController?;
+    private messagingClient?;
+    private communitiesClient?;
+    private attachmentsClient?;
+    private callsClient?;
+    private privateConversationsClient?;
+    private devicesClient?;
+    private realtimeClient?;
+    private liveSessionRuntime?;
+    private ephemeralStateController?;
+    private socialClient?;
+    private repliesController?;
+    private readonly emptyEphemeralState;
+    private workspaceController;
+    private unsubscribeStatus?;
+    private unsubscribeState?;
+    private unsubscribeEphemeral?;
+    private generation;
+    private reconnectTimer?;
+    private stateEmitTimer?;
+    private reconnectAttempt;
+    private retryReconnect?;
+    private communityMemberLoads;
+    constructor(options: SidebandClientOptions);
+    get state(): SidebandClientState;
+    get accountState(): AccountState | undefined;
+    get ephemeralState(): import("./ephemeral-state.js").EphemeralState;
+    get messaging(): SbpMessagingClient;
+    get social(): SbpSocialClient;
+    get communities(): SbpCommunitiesClient;
+    get attachments(): SbpAttachmentsClient;
+    get calls(): SbpCallsClient;
+    get privateConversations(): SbpPrivateConversationsClient;
+    get devices(): SbpDevicesClient;
+    get realtime(): SbpRealtimeClient;
+    get liveSessions(): SessionRuntime;
+    get ephemeral(): EphemeralStateController;
+    get workspace(): WorkspaceController;
+    get replies(): RepliesController;
+    createActivitySharingRuntime(platform: ActivitySharingPlatform, account: UserId): ActivitySharingController;
+    openConversation(conversationId: ConversationId): Promise<void>;
+    openDirectConversation(userId: UserId): Promise<import("../domain.js").ConversationSummary>;
+    acceptCommunityInvitation(token: string): Promise<import("../domain.js").Community>;
+    selectCommunity(communityId: CommunityId): Promise<void>;
+    selectChannel(channelId: ChannelId): Promise<void>;
+    loadChannelMembers(channelId: ChannelId): Promise<void>;
+    loadChannelOnlineMembers(channelId: ChannelId): Promise<void>;
+    private loadChannelMemberPage;
+    private loadNextChannelMemberPage;
+    private watchSelectedChannel;
+    private clearChannelMemberWatch;
+    showFriends(): void;
+    showDirectMessages(): void;
+    subscribe: (listener: () => void) => () => boolean;
+    subscribeNotifications: (listener: (entry: InboxEntry) => void) => () => void;
+    connectStored(endpoint: InstanceEndpoint, account: AccountKey): Promise<import("../sbp/session.js").SbpAuthenticatedSession>;
+    connect(endpoint: InstanceEndpoint, credential: StoredCredential): Promise<import("../sbp/session.js").SbpAuthenticatedSession>;
+    retryConnection(): void;
+    loadConversation(conversationId: Parameters<AccountStateController["loadConversation"]>[0]): Promise<import("../domain.js").ConversationSnapshot>;
+    loadOlderHistory(conversationId: ConversationId, limit?: number): Promise<import("../domain.js").HistoryPage>;
+    private loadSelectedConversation;
+    disconnect(): void;
+    forget(account: AccountKey): Promise<void>;
+    private disposeRuntime;
+    private scheduleReconnect;
+    private reconnect;
+    private clearReconnectTimer;
+    private reportError;
+    private set;
+    private scheduleStateEmit;
+    private emit;
+}
+//# sourceMappingURL=sideband-client.d.ts.map

package/dist/client/sideband-client.d.ts.map

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