zynko 0.0.0-stage → 0.1.0

package/dist/gateway.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The realtime link (docs.zynko.org/api/gateway): HELLO, IDENTIFY with the token and the
+ * intents, heartbeats, and a fresh IDENTIFY after any drop (there is no RESUME: READY always
+ * brings the whole state again).
+ */
+export interface GatewayOptions {
+    url: string;
+    token: string;
+    intents: number;
+    onDispatch: (t: string, d: any) => void;
+    onState: (state: 'connecting' | 'ready' | 'reconnecting' | 'closed', detail?: unknown) => void;
+}
+export declare class Gateway {
+    private readonly opts;
+    private ws;
+    private beat;
+    private retry;
+    private stopped;
+    private lastAck;
+    constructor(opts: GatewayOptions);
+    connect(): void;
+    /** Sends an op (4: voice state). Returns whether the link was open. */
+    send(op: number, d: unknown): boolean;
+    close(): void;
+    private onMessage;
+    private onClose;
+    private clearBeat;
+}

package/dist/gateway.js

@@ -0,0 +1,102 @@
+/**
+ * The realtime link (docs.zynko.org/api/gateway): HELLO, IDENTIFY with the token and the
+ * intents, heartbeats, and a fresh IDENTIFY after any drop (there is no RESUME: READY always
+ * brings the whole state again).
+ */
+/** Close codes after which trying again cannot help. */
+const FATAL = new Set([4004]);
+export class Gateway {
+    opts;
+    ws = null;
+    beat = null;
+    retry = 0;
+    stopped = false;
+    lastAck = 0;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    connect() {
+        this.stopped = false;
+        this.opts.onState(this.retry ? 'reconnecting' : 'connecting');
+        const ws = new WebSocket(this.opts.url);
+        this.ws = ws;
+        ws.onmessage = (e) => this.onMessage(typeof e.data === 'string' ? e.data : String(e.data));
+        ws.onclose = (e) => this.onClose(ws, e.code, e.reason);
+        ws.onerror = () => {
+            /* onclose follows */
+        };
+    }
+    /** Sends an op (4: voice state). Returns whether the link was open. */
+    send(op, d) {
+        if (this.ws?.readyState !== WebSocket.OPEN)
+            return false;
+        this.ws.send(JSON.stringify({ op, d }));
+        return true;
+    }
+    close() {
+        this.stopped = true;
+        this.clearBeat();
+        this.ws?.close(1000);
+        this.ws = null;
+    }
+    onMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        switch (msg.op) {
+            case 10: {
+                this.send(2, { token: this.opts.token, intents: this.opts.intents });
+                this.clearBeat();
+                this.lastAck = Date.now();
+                const every = msg.d?.heartbeat_interval ?? 30_000;
+                this.beat = setInterval(() => {
+                    // No answer to two beats in a row: the link is dead even if the socket says otherwise.
+                    if (Date.now() - this.lastAck > every * 2 + 5_000)
+                        return this.ws?.close(4900, 'heartbeat timeout');
+                    this.send(1, null);
+                }, every);
+                return;
+            }
+            case 11:
+                this.lastAck = Date.now();
+                return;
+            case 0:
+                this.lastAck = Date.now();
+                if (msg.t === 'READY') {
+                    this.retry = 0;
+                    this.opts.onState('ready');
+                }
+                if (msg.t)
+                    this.opts.onDispatch(msg.t, msg.d);
+                return;
+        }
+    }
+    onClose(ws, code, reason) {
+        if (ws !== this.ws)
+            return;
+        this.clearBeat();
+        this.ws = null;
+        if (this.stopped)
+            return;
+        if (FATAL.has(code)) {
+            this.stopped = true;
+            this.opts.onState('closed', new Error(`Token recusado pelo gateway (${code} ${reason})`));
+            return;
+        }
+        // 1s, 2s, 4s... up to 30s, with some jitter so a server restart is not hit all at once.
+        const wait = Math.min(30_000, 1000 * 2 ** this.retry) * (0.75 + Math.random() / 2);
+        this.retry++;
+        this.opts.onState('reconnecting', { code, reason, wait });
+        setTimeout(() => !this.stopped && this.connect(), wait);
+    }
+    clearBeat() {
+        if (this.beat)
+            clearInterval(this.beat);
+        this.beat = null;
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * zynko: the official library for Zynko bots (docs.zynko.org/bots).
+ * API and gateway with no dependencies; voice through `@livekit/rtc-node`, loaded only when
+ * a bot joins a voice room.
+ */
+export { Client, type CachedGuild, type ClientEvents, type ClientOptions } from './client.js';
+export { Intents, Permissions, idTime } from './bits.js';
+export { Interaction } from './interaction.js';
+export { Message } from './message.js';
+export { Rest, ZynkoError, type EditOptions, type FileInput, type ReplyOptions, type RestOptions, type SendOptions } from './rest.js';
+export { AudioPlayer, tone, type AudioInput, type PlayerEvents, type PlayerOptions, type Track } from './player.js';
+export type { JoinVoiceOptions, VoiceConnection, VoiceEvents } from './voice.js';
+export * from './types.js';

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * zynko: the official library for Zynko bots (docs.zynko.org/bots).
+ * API and gateway with no dependencies; voice through `@livekit/rtc-node`, loaded only when
+ * a bot joins a voice room.
+ */
+export { Client } from './client.js';
+export { Intents, Permissions, idTime } from './bits.js';
+export { Interaction } from './interaction.js';
+export { Message } from './message.js';
+export { Rest, ZynkoError } from './rest.js';
+export { AudioPlayer, tone } from './player.js';
+export * from './types.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;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAA2D,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,UAAU,EAA2F,MAAM,WAAW,CAAC;AACtI,OAAO,EAAE,WAAW,EAAE,IAAI,EAAsE,MAAM,aAAa,CAAC;AAEpH,cAAc,YAAY,CAAC"}

package/dist/interaction.d.ts

@@ -0,0 +1,45 @@
+import type { Client } from './client.js';
+import { Message } from './message.js';
+import type { EditOptions, ReplyOptions } from './rest.js';
+import type { Channel, Id, InteractionData, Member, User } from './types.js';
+/**
+ * Someone used one of the bot's "/" commands, or clicked a button on one of its messages.
+ * Answer within 15 minutes: `reply` posts a message (or one only they see), `update` changes
+ * the message whose button was clicked.
+ *
+ * ```ts
+ * client.on('interaction', async (i) => {
+ *   if (i.command === 'dado') await i.reply(`🎲 ${1 + Math.floor(Math.random() * (i.option<number>('lados') ?? 6))}`);
+ * });
+ * ```
+ */
+export declare class Interaction {
+    readonly client: Client;
+    readonly data: InteractionData;
+    readonly id: Id;
+    readonly token: string;
+    readonly type: 'command' | 'button';
+    readonly channelId: Id;
+    readonly guildId: Id | null;
+    /** Who used it. */
+    readonly user: User;
+    readonly member: Member | null;
+    /** The command's name, for commands. */
+    readonly command: string | null;
+    /** What was typed for each option, by name. */
+    readonly options: Record<string, string | number | boolean>;
+    /** The clicked button's `custom_id`, for buttons. */
+    readonly customId: string | null;
+    /** The message whose button was clicked. */
+    readonly message: Message | null;
+    /** Whether it was answered already. */
+    replied: boolean;
+    constructor(client: Client, data: InteractionData);
+    /** One option's value; `undefined` when it was left out. User, channel and role options are ids. */
+    option<T extends string | number | boolean = string>(name: string): T | undefined;
+    get channel(): Channel | undefined;
+    /** Answers with a message in the channel, or only for that person with `ephemeral: true`. May be called again for follow-ups. */
+    reply(answer: string | ReplyOptions): Promise<Message>;
+    /** Changes the message whose button was clicked: whatever is given (text, cards, buttons). */
+    update(edit: string | EditOptions): Promise<Message>;
+}

package/dist/interaction.js

@@ -0,0 +1,73 @@
+import { Message } from './message.js';
+/**
+ * Someone used one of the bot's "/" commands, or clicked a button on one of its messages.
+ * Answer within 15 minutes: `reply` posts a message (or one only they see), `update` changes
+ * the message whose button was clicked.
+ *
+ * ```ts
+ * client.on('interaction', async (i) => {
+ *   if (i.command === 'dado') await i.reply(`🎲 ${1 + Math.floor(Math.random() * (i.option<number>('lados') ?? 6))}`);
+ * });
+ * ```
+ */
+export class Interaction {
+    client;
+    data;
+    id;
+    token;
+    type;
+    channelId;
+    guildId;
+    /** Who used it. */
+    user;
+    member;
+    /** The command's name, for commands. */
+    command;
+    /** What was typed for each option, by name. */
+    options;
+    /** The clicked button's `custom_id`, for buttons. */
+    customId;
+    /** The message whose button was clicked. */
+    message;
+    /** Whether it was answered already. */
+    replied = false;
+    constructor(client, data) {
+        this.client = client;
+        this.data = data;
+        this.id = data.id;
+        this.token = data.token;
+        this.type = data.type;
+        this.channelId = data.channel_id;
+        this.guildId = data.guild_id;
+        this.user = data.user;
+        this.member = data.member;
+        this.command = data.command?.name ?? null;
+        this.options = Object.fromEntries((data.command?.options ?? []).map((o) => [o.name, o.value]));
+        this.customId = data.custom_id ?? null;
+        this.message = data.message ? new Message(client, data.message) : null;
+    }
+    /** One option's value; `undefined` when it was left out. User, channel and role options are ids. */
+    option(name) {
+        return this.options[name];
+    }
+    get channel() {
+        return this.client.channels.get(this.channelId);
+    }
+    /** Answers with a message in the channel, or only for that person with `ephemeral: true`. May be called again for follow-ups. */
+    async reply(answer) {
+        const body = typeof answer === 'string' ? { content: answer } : answer;
+        const msg = await this.client.rest.interactionCallback(this.id, this.token, { ...body, type: 'message' });
+        this.replied = true;
+        return new Message(this.client, msg);
+    }
+    /** Changes the message whose button was clicked: whatever is given (text, cards, buttons). */
+    async update(edit) {
+        if (this.type !== 'button')
+            throw new Error('update() é só para cliques em botões');
+        const body = typeof edit === 'string' ? { content: edit } : edit;
+        const msg = await this.client.rest.interactionCallback(this.id, this.token, { ...body, type: 'update' });
+        this.replied = true;
+        return new Message(this.client, msg);
+    }
+}
+//# sourceMappingURL=interaction.js.map

package/dist/interaction.js.map

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

package/dist/message.d.ts

@@ -0,0 +1,40 @@
+import type { Client } from './client.js';
+import type { EditOptions, SendOptions } from './rest.js';
+import type { Attachment, Card, Channel, Components, Embed, Id, InteractionRef, Member, MessageData, MessageRef, ReactionCount, User } from './types.js';
+/** A message, with shortcuts to answer it, react, edit and delete. */
+export declare class Message {
+    readonly client: Client;
+    readonly id: Id;
+    readonly channelId: Id;
+    readonly author: User;
+    content: string;
+    readonly timestamp: number;
+    editedTimestamp: number | null;
+    readonly replyTo: MessageRef | null;
+    attachments: Attachment[];
+    reactions: ReactionCount[];
+    embeds: Embed[];
+    cards: Card[];
+    components: Components;
+    /** The command or click this (bot) message answers. */
+    readonly interaction: InteractionRef | null;
+    /** Only its reader sees it, and it is not kept. */
+    readonly ephemeral: boolean;
+    readonly nonce: string | null;
+    constructor(client: Client, data: MessageData);
+    /** The channel, when the client has seen it. */
+    get channel(): Channel | undefined;
+    /** The house the message is in; null in a DM. */
+    get guildId(): Id | null;
+    /** The author as a member of the house (nickname, roles); undefined in DMs. */
+    get member(): Member | undefined;
+    /** Whether the author is the bot itself. */
+    get mine(): boolean;
+    /** Answers in the same channel, as a reply to this message. */
+    reply(message: string | Omit<SendOptions, 'replyTo'>): Promise<Message>;
+    react: (emoji: string) => Promise<unknown>;
+    unreact: (emoji: string) => Promise<unknown>;
+    /** Only the author edits: a bot edits its own messages (text, cards, buttons). */
+    edit: (edit: string | EditOptions) => Promise<Message>;
+    delete: () => Promise<unknown>;
+}

package/dist/message.js

@@ -0,0 +1,67 @@
+/** A message, with shortcuts to answer it, react, edit and delete. */
+export class Message {
+    client;
+    id;
+    channelId;
+    author;
+    content;
+    timestamp;
+    editedTimestamp;
+    replyTo;
+    attachments;
+    reactions;
+    embeds;
+    cards;
+    components;
+    /** The command or click this (bot) message answers. */
+    interaction;
+    /** Only its reader sees it, and it is not kept. */
+    ephemeral;
+    nonce;
+    constructor(client, data) {
+        this.client = client;
+        this.id = data.id;
+        this.channelId = data.channel_id;
+        this.author = data.author;
+        this.content = data.content;
+        this.timestamp = data.timestamp;
+        this.editedTimestamp = data.edited_timestamp;
+        this.replyTo = data.reply_to;
+        this.attachments = data.attachments ?? [];
+        this.reactions = data.reactions ?? [];
+        this.embeds = data.embeds ?? [];
+        this.cards = data.cards ?? [];
+        this.components = data.components ?? [];
+        this.interaction = data.interaction ?? null;
+        this.ephemeral = !!data.ephemeral;
+        this.nonce = data.nonce;
+    }
+    /** The channel, when the client has seen it. */
+    get channel() {
+        return this.client.channels.get(this.channelId);
+    }
+    /** The house the message is in; null in a DM. */
+    get guildId() {
+        return this.channel?.guild_id ?? null;
+    }
+    /** The author as a member of the house (nickname, roles); undefined in DMs. */
+    get member() {
+        const g = this.guildId;
+        return g ? this.client.guilds.get(g)?.members.get(this.author.id) : undefined;
+    }
+    /** Whether the author is the bot itself. */
+    get mine() {
+        return this.author.id === this.client.user?.id;
+    }
+    /** Answers in the same channel, as a reply to this message. */
+    async reply(message) {
+        const opts = typeof message === 'string' ? { content: message } : message;
+        return this.client.send(this.channelId, { ...opts, replyTo: this.id });
+    }
+    react = (emoji) => this.client.rest.react(this.channelId, this.id, emoji);
+    unreact = (emoji) => this.client.rest.unreact(this.channelId, this.id, emoji);
+    /** Only the author edits: a bot edits its own messages (text, cards, buttons). */
+    edit = async (edit) => new Message(this.client, await this.client.rest.editMessage(this.channelId, this.id, edit));
+    delete = () => this.client.rest.deleteMessage(this.channelId, this.id);
+}
+//# sourceMappingURL=message.js.map

package/dist/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAIA,sEAAsE;AACtE,MAAM,OAAO,OAAO;IAoBP;IAnBF,EAAE,CAAK;IACP,SAAS,CAAK;IACd,MAAM,CAAO;IACtB,OAAO,CAAS;IACP,SAAS,CAAS;IAC3B,eAAe,CAAgB;IACtB,OAAO,CAAoB;IACpC,WAAW,CAAe;IAC1B,SAAS,CAAkB;IAC3B,MAAM,CAAU;IAChB,KAAK,CAAS;IACd,UAAU,CAAa;IACvB,uDAAuD;IAC9C,WAAW,CAAwB;IAC5C,mDAAmD;IAC1C,SAAS,CAAU;IACnB,KAAK,CAAgB;IAE9B,YACW,MAAc,EACvB,IAAiB;QADR,WAAM,GAAN,MAAM,CAAQ;QAGvB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,gDAAgD;IAChD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,iDAAiD;IACjD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;IACxC,CAAC;IAED,+EAA+E;IAC/E,IAAI,MAAM;QACR,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,CAAC;IAED,4CAA4C;IAC5C,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACjD,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,KAAK,CAAC,OAA8C;QACxD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAClF,OAAO,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACtF,kFAAkF;IAClF,IAAI,GAAG,KAAK,EAAE,IAA0B,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;IACzI,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;CACxE"}

package/dist/player.d.ts

@@ -0,0 +1,78 @@
+import type { Readable } from 'node:stream';
+export declare const SAMPLE_RATE = 48000;
+export declare const CHANNELS = 2;
+export declare const FRAME_SAMPLES = 960;
+/**
+ * What to play:
+ * - a path or an http(s) link, opened by ffmpeg;
+ * - `{ stream }`: encoded audio (an mp3 download, a pipe), decoded by ffmpeg;
+ * - `{ pcm }`: raw PCM already at 48 kHz, stereo, 16-bit little-endian.
+ */
+export type AudioInput = string | {
+    stream: Readable | AsyncIterable<Uint8Array>;
+} | {
+    pcm: Readable | AsyncIterable<Uint8Array>;
+};
+export interface Track<M = unknown> {
+    input: AudioInput;
+    /** Whatever you want back in events: a title, who asked for it... */
+    meta?: M;
+}
+export interface PlayerOptions {
+    /** ffmpeg's path. Default: FFMPEG_PATH, or `ffmpeg` on the PATH. */
+    ffmpeg?: string;
+    /**
+     * Hand http(s) links to yt-dlp first (its path, or true for `yt-dlp` on the PATH), for
+     * pages of sites it supports instead of direct audio links.
+     */
+    ytdlp?: boolean | string;
+}
+/** Where the player writes frames: the voice connection. */
+export interface FrameSink {
+    capture(frame: Int16Array): Promise<void>;
+    /** Drops what is buffered, so a skip or pause is heard at once. */
+    flush(): void;
+}
+export interface PlayerEvents<M> {
+    start: [track: Track<M>];
+    finish: [track: Track<M>];
+    error: [error: Error, track: Track<M>];
+    /** Nothing left in the queue. */
+    idle: [];
+}
+/** A sine wave, for testing: `{ pcm: tone(440, 2) }`. */
+export declare function tone(hz?: number, seconds?: number, volume?: number): AsyncGenerator<Uint8Array>;
+export declare class AudioPlayer<M = unknown> {
+    private readonly sink;
+    private readonly opts;
+    /** Played after the current one, in order. */
+    readonly queue: Track<M>[];
+    /** What is playing now. */
+    current: Track<M> | null;
+    paused: boolean;
+    private _volume;
+    private readonly emitter;
+    private abort;
+    private resumeWaiters;
+    private running;
+    constructor(sink: FrameSink, opts?: PlayerOptions);
+    on<K extends keyof PlayerEvents<M>>(event: K, listener: (...args: PlayerEvents<M>[K]) => void): this;
+    off<K extends keyof PlayerEvents<M>>(event: K, listener: (...args: PlayerEvents<M>[K]) => void): this;
+    /** 0 (silent) to 2 (twice as loud); 1 is as it came. */
+    get volume(): number;
+    set volume(v: number);
+    /** Plays now, in place of what was playing (the queue stays). */
+    play(input: AudioInput, meta?: M): Track<M>;
+    /** Adds to the end of the queue; starts if nothing is playing. */
+    enqueue(input: AudioInput, meta?: M): Track<M>;
+    /** Goes to the next in the queue. */
+    skip(): void;
+    /** Stops and empties the queue. */
+    stop(): void;
+    pause(): void;
+    resume(): void;
+    private loop;
+    private playOne;
+    /** The input as raw PCM. */
+    private open;
+}