@snowluma/sdk 0.1.0

package/dist/client/websocket-client.js

@@ -0,0 +1,309 @@
+import { SnowLumaAbortError, SnowLumaConnectionError, SnowLumaParseError, SnowLumaTimeoutError, } from '../errors';
+import { Emitter } from '../emitter';
+import { createEventContext, isGroupMessageEvent, isMessageEvent, isMetaEvent, isNoticeEvent, isPrivateMessageEvent, isRequestEvent, matchCommand, noticeType, requestType, } from '../events/index';
+import { SnowLumaApiClient, toJsonObject } from './api-client';
+import { raceWithAbort, throwIfAborted } from '../internal/abort';
+import { appendAccessToken, assertApiResponse, createEcho, echoKey, isJsonObject } from '../internal/json';
+import { addSocketListener, closeInfo, normalizeReconnect, rawToString, unwrapEventPayload, unwrapMessagePayload, WEBSOCKET_CLOSED, WEBSOCKET_OPEN, } from './websocket-utils';
+/** OneBot WebSocket client for SnowLuma APIs and realtime events. */
+export class SnowLumaWebSocketClient extends SnowLumaApiClient {
+    url;
+    accessToken;
+    requestTimeoutMs;
+    role;
+    protocols;
+    WebSocketCtor;
+    reconnect;
+    emitter = new Emitter();
+    pending = new Map();
+    middlewares = [];
+    socket = null;
+    connectPromise = null;
+    reconnectTimer = null;
+    reconnectAttempts = 0;
+    closedByUser = false;
+    constructor(options = {}) {
+        super();
+        this.url = options.url ?? 'ws://127.0.0.1:3001/';
+        this.accessToken = options.accessToken;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? 30_000;
+        this.role = options.role ?? 'Universal';
+        this.protocols = options.protocols;
+        this.WebSocketCtor = options.webSocket ?? globalThis.WebSocket;
+        this.reconnect = normalizeReconnect(options.reconnect);
+        if (!this.WebSocketCtor) {
+            throw new SnowLumaConnectionError('No WebSocket implementation is available');
+        }
+    }
+    /** True when the underlying WebSocket is currently open. */
+    get isConnected() {
+        return this.socket?.readyState === WEBSOCKET_OPEN;
+    }
+    /** Subscribes to low-level client events. Returns an unsubscribe function. */
+    on(event, listener) {
+        return this.emitter.on(event, listener);
+    }
+    /** Subscribes to one low-level client event, then automatically unsubscribes. */
+    once(event, listener) {
+        return this.emitter.once(event, listener);
+    }
+    /** Removes a previously registered low-level client event listener. */
+    off(event, listener) {
+        this.emitter.off(event, listener);
+    }
+    /** Subscribes to every SnowLuma event packet. */
+    onEvent(listener) {
+        return this.on('event', listener);
+    }
+    /** Adds event middleware to the dispatch pipeline. */
+    use(middleware) {
+        this.middlewares.push(middleware);
+        return () => {
+            const index = this.middlewares.indexOf(middleware);
+            if (index >= 0)
+                this.middlewares.splice(index, 1);
+        };
+    }
+    /** Runs a handler when a type guard or predicate matches an event. */
+    when(predicate, handler) {
+        return this.use(async (event, context, next) => {
+            if (predicate(event)) {
+                await handler(event, context);
+            }
+            if (!context.stopped)
+                await next();
+        });
+    }
+    onMessage(handler) {
+        return this.when(isMessageEvent, handler);
+    }
+    onPrivateMessage(handler) {
+        return this.when(isPrivateMessageEvent, handler);
+    }
+    onGroupMessage(handler) {
+        return this.when(isGroupMessageEvent, handler);
+    }
+    onNotice(typeOrHandler, handler) {
+        if (typeof typeOrHandler === 'string') {
+            if (!handler)
+                throw new TypeError('onNotice(type, handler) requires a handler');
+            return this.when(noticeType(typeOrHandler), handler);
+        }
+        return this.when(isNoticeEvent, typeOrHandler);
+    }
+    onRequest(typeOrHandler, handler) {
+        if (typeof typeOrHandler === 'string') {
+            if (!handler)
+                throw new TypeError('onRequest(type, handler) requires a handler');
+            return this.when(requestType(typeOrHandler), handler);
+        }
+        return this.when(isRequestEvent, typeOrHandler);
+    }
+    onMetaEvent(handler) {
+        return this.when(isMetaEvent, handler);
+    }
+    command(command, handler, options) {
+        return this.onMessage(async (event, context) => {
+            const matched = matchCommand(event, command, options);
+            if (!matched)
+                return;
+            await handler(event, Object.assign(context, { command: matched }), matched);
+        });
+    }
+    /** Connects to SnowLuma's OneBot WebSocket endpoint. */
+    async connect() {
+        if (this.isConnected)
+            return;
+        if (this.connectPromise)
+            return this.connectPromise;
+        this.closedByUser = false;
+        this.connectPromise = new Promise((resolve, reject) => {
+            const url = appendAccessToken(this.url, this.accessToken);
+            const socket = new this.WebSocketCtor(url, this.protocols);
+            this.socket = socket;
+            const cleanup = [
+                addSocketListener(socket, 'open', () => {
+                    cleanup.forEach((off) => off());
+                    this.bindSocket(socket);
+                    this.reconnectAttempts = 0;
+                    this.connectPromise = null;
+                    this.emitter.emit('open', undefined);
+                    resolve();
+                }),
+                addSocketListener(socket, 'error', (error) => {
+                    this.emitter.emit('error', unwrapEventPayload(error));
+                }),
+                addSocketListener(socket, 'close', (...args) => {
+                    cleanup.forEach((off) => off());
+                    this.connectPromise = null;
+                    this.socket = null;
+                    reject(new SnowLumaConnectionError('SnowLuma WebSocket closed before opening'));
+                    this.handleClose(args);
+                }),
+            ];
+        });
+        return this.connectPromise;
+    }
+    /** Closes the socket and rejects all pending API requests. */
+    close(code = 1000, reason = 'normal') {
+        this.closedByUser = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.rejectPending(new SnowLumaConnectionError('SnowLuma WebSocket client closed'));
+        if (this.socket && this.socket.readyState !== WEBSOCKET_CLOSED) {
+            this.socket.close(code, reason);
+        }
+        this.socket = null;
+        this.connectPromise = null;
+    }
+    /** Sends one OneBot action over WebSocket and returns the raw response envelope. */
+    async request(action, params, options) {
+        throwIfAborted(options?.signal);
+        await raceWithAbort(this.connect(), options?.signal, 'SnowLuma WebSocket request aborted before connection opened');
+        throwIfAborted(options?.signal);
+        const socket = this.socket;
+        if (!socket || socket.readyState !== WEBSOCKET_OPEN) {
+            throw new SnowLumaConnectionError('SnowLuma WebSocket is not open');
+        }
+        const echo = options?.echo ?? createEcho();
+        const key = echoKey(echo);
+        const timeoutMs = options?.timeoutMs ?? this.requestTimeoutMs;
+        const promise = new Promise((resolve, reject) => {
+            let timer = null;
+            let abortListener;
+            const cleanup = () => {
+                if (timer)
+                    clearTimeout(timer);
+                if (abortListener)
+                    options?.signal?.removeEventListener('abort', abortListener);
+            };
+            timer = timeoutMs > 0
+                ? setTimeout(() => {
+                    this.pending.delete(key);
+                    cleanup();
+                    reject(new SnowLumaTimeoutError(`SnowLuma WebSocket request timed out after ${timeoutMs}ms`, timeoutMs));
+                }, timeoutMs)
+                : null;
+            abortListener = () => {
+                this.pending.delete(key);
+                cleanup();
+                reject(new SnowLumaAbortError('SnowLuma WebSocket request aborted', { cause: options?.signal?.reason }));
+            };
+            options?.signal?.addEventListener('abort', abortListener, { once: true });
+            this.pending.set(key, { resolve, reject, timer, cleanup });
+        });
+        try {
+            socket.send(JSON.stringify({
+                action,
+                params: toJsonObject(params),
+                echo,
+            }));
+        }
+        catch (error) {
+            const pending = this.pending.get(key);
+            pending?.cleanup?.();
+            this.pending.delete(key);
+            throw new SnowLumaConnectionError('Failed to send SnowLuma WebSocket request', { cause: error });
+        }
+        return promise;
+    }
+    bindSocket(socket) {
+        addSocketListener(socket, 'message', (...args) => this.handleMessage(args));
+        addSocketListener(socket, 'error', (error) => this.emitter.emit('error', unwrapEventPayload(error)));
+        addSocketListener(socket, 'close', (...args) => this.handleClose(args));
+    }
+    handleMessage(args) {
+        const raw = unwrapMessagePayload(args[0]);
+        this.emitter.emit('raw', raw);
+        let parsed;
+        try {
+            parsed = JSON.parse(rawToString(raw));
+        }
+        catch (error) {
+            this.emitter.emit('error', new SnowLumaParseError('SnowLuma WebSocket returned non-JSON message', { cause: error }));
+            return;
+        }
+        if (isJsonObject(parsed) && parsed.echo !== undefined) {
+            const key = echoKey(parsed.echo);
+            const pending = this.pending.get(key);
+            if (pending) {
+                this.pending.delete(key);
+                pending.cleanup?.();
+                try {
+                    const response = assertApiResponse(parsed);
+                    pending.resolve(response);
+                    this.emitter.emit('response', response);
+                }
+                catch (error) {
+                    pending.reject(new SnowLumaParseError('SnowLuma WebSocket response is invalid', { cause: error }));
+                }
+                return;
+            }
+        }
+        if (isJsonObject(parsed) && typeof parsed.post_type === 'string') {
+            void this.dispatchEvent(parsed).catch((error) => {
+                this.emitter.emit('error', error);
+            });
+        }
+    }
+    async dispatchEvent(event) {
+        const context = createEventContext(event, this);
+        let index = -1;
+        const next = async () => {
+            index += 1;
+            const middleware = this.middlewares[index];
+            if (!middleware || context.stopped)
+                return;
+            await middleware(event, context, next);
+        };
+        await next();
+        if (!context.stopped && index >= this.middlewares.length - 1) {
+            this.emitter.emit('event', event);
+        }
+    }
+    handleClose(args) {
+        const info = closeInfo(args);
+        this.socket = null;
+        this.connectPromise = null;
+        this.rejectPending(new SnowLumaConnectionError('SnowLuma WebSocket closed'));
+        this.emitter.emit('close', info);
+        if (!this.closedByUser && this.reconnect) {
+            this.scheduleReconnect();
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        const reconnect = this.reconnect;
+        if (!reconnect)
+            return;
+        const retries = reconnect.retries ?? Number.POSITIVE_INFINITY;
+        if (this.reconnectAttempts >= retries)
+            return;
+        const minDelay = reconnect.minDelayMs ?? 1000;
+        const maxDelay = reconnect.maxDelayMs ?? 30_000;
+        const delay = Math.min(maxDelay, minDelay * 2 ** this.reconnectAttempts);
+        this.reconnectAttempts += 1;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            void this.connect().catch((error) => {
+                this.emitter.emit('error', error);
+                if (!this.closedByUser)
+                    this.scheduleReconnect();
+            });
+        }, delay);
+    }
+    rejectPending(error) {
+        for (const pending of this.pending.values()) {
+            pending.cleanup?.();
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+}
+export function createWebSocketClient(options) {
+    return new SnowLumaWebSocketClient(options);
+}
+//# sourceMappingURL=websocket-client.js.map

package/dist/client/websocket-client.js.map

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

package/dist/client/websocket-types.d.ts

@@ -0,0 +1,53 @@
+import type { ApiResponse, SnowLumaClientOptions, SnowLumaEvent, WsRole } from '../types/index';
+export interface WebSocketLike {
+    readyState: number;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    addEventListener?: (event: string, listener: (...args: unknown[]) => void) => void;
+    removeEventListener?: (event: string, listener: (...args: unknown[]) => void) => void;
+    on?: (event: string, listener: (...args: unknown[]) => void) => void;
+    off?: (event: string, listener: (...args: unknown[]) => void) => void;
+    removeListener?: (event: string, listener: (...args: unknown[]) => void) => void;
+}
+export type WebSocketConstructor = new (url: string, protocols?: string | string[]) => WebSocketLike;
+/** Reconnect policy for the WebSocket client. */
+export interface ReconnectOptions {
+    /** Maximum reconnect attempts. Omit for unlimited retries. */
+    retries?: number;
+    /** Initial reconnect delay in milliseconds. Defaults to 1000. */
+    minDelayMs?: number;
+    /** Maximum reconnect delay in milliseconds. Defaults to 30000. */
+    maxDelayMs?: number;
+}
+/** Options for the WebSocket transport client. */
+export interface SnowLumaWebSocketClientOptions extends SnowLumaClientOptions {
+    /** OneBot WebSocket endpoint. Defaults to ws://127.0.0.1:3001/. */
+    url?: string;
+    /** OneBot WebSocket role advertised by the client. */
+    role?: WsRole;
+    /** Optional WebSocket protocols argument. */
+    protocols?: string | string[];
+    /** Custom WebSocket constructor for Node runtimes or tests. */
+    webSocket?: WebSocketConstructor;
+    /** Enables or configures automatic reconnect after unexpected close. */
+    reconnect?: boolean | ReconnectOptions;
+}
+export interface WebSocketCloseInfo {
+    code?: number;
+    reason?: string;
+}
+export interface SnowLumaWebSocketEvents {
+    open: undefined;
+    close: WebSocketCloseInfo;
+    error: unknown;
+    event: SnowLumaEvent;
+    response: ApiResponse;
+    raw: unknown;
+}
+export interface PendingRequest {
+    resolve: (response: ApiResponse) => void;
+    reject: (error: Error) => void;
+    timer: ReturnType<typeof setTimeout> | null;
+    cleanup?: () => void;
+}
+//# sourceMappingURL=websocket-types.d.ts.map

package/dist/client/websocket-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-types.d.ts","sourceRoot":"","sources":["../../src/client/websocket-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,aAAa,EACb,MAAM,EACP,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACnF,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACtF,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACrE,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACtE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;CAClF;AAED,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,aAAa,CAAC;AAErG,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,kDAAkD;AAClD,MAAM,WAAW,8BAA+B,SAAQ,qBAAqB;IAC3E,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB"}

package/dist/client/websocket-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=websocket-types.js.map

package/dist/client/websocket-types.js.map

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

package/dist/client/websocket-utils.d.ts

@@ -0,0 +1,10 @@
+import type { ReconnectOptions, WebSocketCloseInfo, WebSocketLike } from './websocket-types';
+export declare const WEBSOCKET_OPEN = 1;
+export declare const WEBSOCKET_CLOSED = 3;
+export declare function normalizeReconnect(value: boolean | ReconnectOptions | undefined): ReconnectOptions | null;
+export declare function addSocketListener(socket: WebSocketLike, event: string, listener: (...args: unknown[]) => void): () => void;
+export declare function unwrapMessagePayload(value: unknown): unknown;
+export declare function unwrapEventPayload(value: unknown): unknown;
+export declare function rawToString(value: unknown): string;
+export declare function closeInfo(args: unknown[]): WebSocketCloseInfo;
+//# sourceMappingURL=websocket-utils.d.ts.map

package/dist/client/websocket-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-utils.d.ts","sourceRoot":"","sources":["../../src/client/websocket-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACd,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAIzG;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACrC,MAAM,IAAI,CAaZ;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK5D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAalD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAY7D"}

package/dist/client/websocket-utils.js

@@ -0,0 +1,68 @@
+import { isJsonObject } from '../internal/json';
+export const WEBSOCKET_OPEN = 1;
+export const WEBSOCKET_CLOSED = 3;
+export function normalizeReconnect(value) {
+    if (!value)
+        return null;
+    if (value === true)
+        return {};
+    return value;
+}
+export function addSocketListener(socket, event, listener) {
+    if (socket.addEventListener) {
+        socket.addEventListener(event, listener);
+        return () => socket.removeEventListener?.(event, listener);
+    }
+    if (socket.on) {
+        socket.on(event, listener);
+        return () => {
+            if (socket.off)
+                socket.off(event, listener);
+            else
+                socket.removeListener?.(event, listener);
+        };
+    }
+    return () => undefined;
+}
+export function unwrapMessagePayload(value) {
+    if (isJsonObject(value) && 'data' in value) {
+        return value.data;
+    }
+    return value;
+}
+export function unwrapEventPayload(value) {
+    if (isJsonObject(value) && 'error' in value) {
+        return value.error;
+    }
+    return value;
+}
+export function rawToString(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value instanceof ArrayBuffer)
+        return new TextDecoder().decode(value);
+    if (ArrayBuffer.isView(value)) {
+        return new TextDecoder().decode(value);
+    }
+    if (value instanceof Blob) {
+        throw new Error('Blob WebSocket messages are not supported synchronously');
+    }
+    if (value && typeof value === 'object' && 'toString' in value && typeof value.toString === 'function') {
+        return value.toString();
+    }
+    return String(value);
+}
+export function closeInfo(args) {
+    const first = args[0];
+    if (isJsonObject(first)) {
+        return {
+            code: typeof first.code === 'number' ? first.code : undefined,
+            reason: typeof first.reason === 'string' ? first.reason : undefined,
+        };
+    }
+    return {
+        code: typeof args[0] === 'number' ? args[0] : undefined,
+        reason: typeof args[1] === 'string' ? args[1] : undefined,
+    };
+}
+//# sourceMappingURL=websocket-utils.js.map

package/dist/client/websocket-utils.js.map

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

package/dist/emitter.d.ts

@@ -0,0 +1,11 @@
+type Listener<TPayload> = (payload: TPayload) => void;
+export declare class Emitter<TEvents extends object> {
+    private readonly listeners;
+    on<TKey extends keyof TEvents>(event: TKey, listener: Listener<TEvents[TKey]>): () => void;
+    once<TKey extends keyof TEvents>(event: TKey, listener: Listener<TEvents[TKey]>): () => void;
+    off<TKey extends keyof TEvents>(event: TKey, listener: Listener<TEvents[TKey]>): void;
+    emit<TKey extends keyof TEvents>(event: TKey, payload: TEvents[TKey]): void;
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=emitter.d.ts.map

package/dist/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;AAEtD,qBAAa,OAAO,CAAC,OAAO,SAAS,MAAM;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkD;IAE5E,EAAE,CAAC,IAAI,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,IAAI;IAU1F,IAAI,CAAC,IAAI,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,IAAI;IAQ5F,GAAG,CAAC,IAAI,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI;IAIrF,IAAI,CAAC,IAAI,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAQ3E,KAAK,IAAI,IAAI;CAGd"}

package/dist/emitter.js

@@ -0,0 +1,34 @@
+export class Emitter {
+    listeners = new Map();
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+        return () => this.off(event, listener);
+    }
+    once(event, listener) {
+        const off = this.on(event, (payload) => {
+            off();
+            listener(payload);
+        });
+        return off;
+    }
+    off(event, listener) {
+        this.listeners.get(event)?.delete(listener);
+    }
+    emit(event, payload) {
+        const set = this.listeners.get(event);
+        if (!set)
+            return;
+        for (const listener of [...set]) {
+            listener(payload);
+        }
+    }
+    clear() {
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,OAAO;IACD,SAAS,GAAG,IAAI,GAAG,EAAuC,CAAC;IAE5E,EAAE,CAA6B,KAAW,EAAE,QAAiC;QAC3E,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAA2B,CAAC,CAAC;QACrC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAA6B,KAAW,EAAE,QAAiC;QAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACrC,GAAG,EAAE,CAAC;YACN,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC;IAED,GAAG,CAA6B,KAAW,EAAE,QAAiC;QAC5E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAA2B,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAA6B,KAAW,EAAE,OAAsB;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAChC,QAAQ,CAAC,OAAgB,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,39 @@
+import type { ApiResponse } from './types/index';
+/** Base error for every exception intentionally thrown by the SnowLuma SDK. */
+export declare class SnowLumaError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Transport-layer failures before a valid OneBot API response is available. */
+export declare class SnowLumaTransportError extends SnowLumaError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** The request was cancelled by the caller's AbortSignal. */
+export declare class SnowLumaAbortError extends SnowLumaTransportError {
+    constructor(message?: string, options?: ErrorOptions);
+}
+/** The request exceeded the configured timeout. */
+export declare class SnowLumaTimeoutError extends SnowLumaTransportError {
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number, options?: ErrorOptions);
+}
+/** The SDK could not establish or keep a connection to SnowLuma. */
+export declare class SnowLumaConnectionError extends SnowLumaTransportError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** SnowLuma returned a payload that could not be parsed as the expected protocol shape. */
+export declare class SnowLumaParseError extends SnowLumaTransportError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** A OneBot API response with status failed or a non-zero retcode. */
+export declare class SnowLumaApiError<TData = unknown> extends SnowLumaError {
+    readonly response: ApiResponse<TData>;
+    readonly retcode: number;
+    readonly wording?: string;
+    constructor(response: ApiResponse<TData>);
+}
+/** Authentication or authorization failure returned by SnowLuma. */
+export declare class SnowLumaAuthError<TData = unknown> extends SnowLumaApiError<TData> {
+    constructor(response: ApiResponse<TData>);
+}
+export declare function createSnowLumaApiError<TData>(response: ApiResponse<TData>): SnowLumaApiError<TData>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,+EAA+E;AAC/E,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,gFAAgF;AAChF,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,6DAA6D;AAC7D,qBAAa,kBAAmB,SAAQ,sBAAsB;gBAChD,OAAO,SAA6B,EAAE,OAAO,CAAC,EAAE,YAAY;CAIzE;AAED,mDAAmD;AACnD,qBAAa,oBAAqB,SAAQ,sBAAsB;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKvE;AAED,oEAAoE;AACpE,qBAAa,uBAAwB,SAAQ,sBAAsB;gBACrD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,2FAA2F;AAC3F,qBAAa,kBAAmB,SAAQ,sBAAsB;gBAChD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,sEAAsE;AACtE,qBAAa,gBAAgB,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,aAAa;IAClE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC;CAOzC;AAED,oEAAoE;AACpE,qBAAa,iBAAiB,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,gBAAgB,CAAC,KAAK,CAAC;gBACjE,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC;CAIzC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAEnG"}