zynko 0.0.0-stage → 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,306 @@
+/**
+ * The Zynko API's objects, as the server sends them (docs.zynko.org/api/objetos). Ids are
+ * strings; times are milliseconds since 1970.
+ */
+export type Id = string;
+export interface User {
+    id: Id;
+    username: string;
+    display_name: string;
+    avatar: string | null;
+    bot: boolean;
+}
+export interface Profile {
+    user: User;
+    bio: string | null;
+    banner: string | null;
+    accent: string | null;
+}
+export interface Guild {
+    id: Id;
+    name: string;
+    icon: string | null;
+    owner_id: Id;
+}
+/** A house as READY and GUILD_CREATE bring it. */
+export interface GuildFull extends Guild {
+    channels: Channel[];
+    members: Member[];
+    /** Ids of the members online now. */
+    presences: Id[];
+    roles: Role[];
+    emojis: Emoji[];
+}
+export declare const ChannelType: {
+    readonly TEXT: 0;
+    readonly DM: 1;
+    readonly VOICE: 2;
+    readonly CATEGORY: 4;
+    readonly POST: 11;
+    readonly FORUM: 15;
+};
+export interface Overwrite {
+    id: Id;
+    /** 0 = role, 1 = member. */
+    type: number;
+    allow: number;
+    deny: number;
+}
+export interface ForumTag {
+    id: Id;
+    name: string;
+    emoji: string | null;
+    moderated?: boolean;
+}
+export interface Channel {
+    id: Id;
+    guild_id: Id | null;
+    type: number;
+    name: string;
+    topic: string | null;
+    position: number;
+    parent_id: Id | null;
+    last_message_id: Id | null;
+    rate_limit_per_user?: number;
+    owner_id?: Id;
+    pinned?: boolean;
+    locked?: boolean;
+    message_count?: number;
+    applied_tags?: Id[];
+    /** The voice server a room runs on, when someone picked one. */
+    voice_server?: string;
+    available_tags?: ForumTag[];
+    /** In a DM: the other person. */
+    recipients?: User[];
+    permission_overwrites?: Overwrite[];
+}
+export interface Member {
+    guild_id: Id;
+    user: User;
+    nick: string | null;
+    is_admin: boolean;
+    joined_at: number;
+    /** Not including @everyone, which everybody has. */
+    roles: Id[];
+}
+export interface Role {
+    id: Id;
+    guild_id: Id;
+    name: string;
+    color: number | null;
+    position: number;
+    permissions: number;
+    hoist: boolean;
+}
+export interface Emoji {
+    id: Id;
+    guild_id: Id;
+    name: string;
+    url: string;
+    animated: boolean;
+}
+export interface Attachment {
+    id: Id;
+    filename: string;
+    content_type: string;
+    size: number;
+    /** `/api/attachments/{id}`: needs the token to download. */
+    url: string;
+    thumbnail?: string | null;
+    width?: number | null;
+    height?: number | null;
+}
+export interface ReactionCount {
+    /** A Unicode emoji, or `name:id` for a house emoji. */
+    emoji: string;
+    count: number;
+    me: boolean;
+}
+export interface MessageRef {
+    id: Id;
+    author: User | null;
+    content: string | null;
+}
+export interface Embed {
+    url: string;
+    site_name?: string;
+    title?: string;
+    description?: string;
+    author?: string;
+    color?: string;
+    image?: {
+        url: string;
+        width?: number;
+        height?: number;
+        large: boolean;
+    };
+    video?: {
+        provider: string;
+        id: string;
+    };
+}
+/** A bot's card: a title, text, fields and pictures with a colored edge. */
+export interface Card {
+    title?: string;
+    /** Markdown, like a message. */
+    description?: string;
+    /** Where the title points. */
+    url?: string;
+    /** The edge's color, 0xRRGGBB. */
+    color?: number;
+    author?: {
+        name: string;
+        url?: string;
+        icon_url?: string;
+    };
+    fields?: {
+        name: string;
+        value: string;
+        inline?: boolean;
+    }[];
+    /** Wide, under the text. */
+    image?: {
+        url: string;
+    };
+    /** Small, beside the text. */
+    thumbnail?: {
+        url: string;
+    };
+    footer?: {
+        text: string;
+        icon_url?: string;
+    };
+    /** Shown in the footer, in ms. */
+    timestamp?: number;
+}
+export type ButtonStyle = 'primary' | 'secondary' | 'success' | 'danger' | 'link';
+export interface Button {
+    style: ButtonStyle;
+    label?: string;
+    emoji?: string;
+    /** What the bot gets back when it is clicked (all but links). */
+    custom_id?: string;
+    /** Link buttons only. */
+    url?: string;
+    disabled?: boolean;
+}
+/** Rows of buttons, top to bottom: up to 5 rows of 5. */
+export type Components = Button[][];
+/** The command or click a bot's message answers. */
+export interface InteractionRef {
+    id: Id;
+    /** The command; absent for a button. */
+    name?: string;
+    user: User;
+}
+export type OptionType = 'string' | 'integer' | 'number' | 'boolean' | 'user' | 'channel' | 'role';
+export interface CommandOption {
+    name: string;
+    description: string;
+    type: OptionType;
+    required?: boolean;
+    /** The only values allowed. */
+    choices?: {
+        name: string;
+        value: string | number;
+    }[];
+    min_value?: number;
+    max_value?: number;
+}
+/** A "/" command (docs.zynko.org/bots/comandos). */
+export interface Command {
+    /** 1 to 32 lowercase letters, digits, _ or -. */
+    name: string;
+    description: string;
+    options?: CommandOption[];
+}
+export interface InteractionData {
+    id: Id;
+    token: string;
+    type: 'command' | 'button';
+    channel_id: Id;
+    guild_id: Id | null;
+    user: User;
+    member: Member | null;
+    command?: {
+        name: string;
+        options: {
+            name: string;
+            type: OptionType;
+            value: string | number | boolean;
+        }[];
+    };
+    custom_id?: string;
+    message?: MessageData;
+}
+/**
+ * MESSAGE_UPDATE is always partial: an edit brings the text (and cards or buttons, when they
+ * changed); link previews come in one of their own. No author.
+ */
+export type MessageUpdate = Pick<MessageData, 'id' | 'channel_id'> & Partial<Pick<MessageData, 'content' | 'edited_timestamp' | 'embeds' | 'cards' | 'components'>>;
+export interface MessageData {
+    id: Id;
+    channel_id: Id;
+    author: User;
+    content: string;
+    timestamp: number;
+    edited_timestamp: number | null;
+    reply_to: MessageRef | null;
+    attachments: Attachment[];
+    reactions: ReactionCount[];
+    nonce: string | null;
+    embeds: Embed[];
+    cards?: Card[];
+    components?: Components;
+    interaction?: InteractionRef;
+    /** Only the person who used the command sees it. */
+    ephemeral?: boolean;
+}
+export interface Invite {
+    code: string;
+    guild_id: Id;
+    creator_id: Id;
+    uses: number;
+    max_uses: number | null;
+    expires_at: number | null;
+}
+export interface VoiceState {
+    user_id: Id;
+    guild_id: Id | null;
+    /** null when the account left voice. */
+    channel_id: Id | null;
+    self_mute: boolean;
+    self_deaf: boolean;
+    self_stream: boolean;
+    self_video: boolean;
+    session_id: string;
+}
+export interface Ready {
+    user: User;
+    guilds: GuildFull[];
+    dm_channels: Channel[];
+    presences: Id[];
+    voice_states: VoiceState[];
+    session_id: string;
+}
+export interface ReactionEvent {
+    message_id: Id;
+    channel_id: Id;
+    user_id: Id;
+    emoji: string;
+}
+export interface TypingEvent {
+    channel_id: Id;
+    user_id: Id;
+    timestamp: number;
+}
+/** The answer to joining a voice room (POST /channels/{id}/voice). */
+export interface VoiceJoin {
+    url: string;
+    /** The voice server's id (Brasil 1, Brasil 2...). */
+    server?: string;
+    token: string;
+    room: string;
+    can_speak: boolean;
+    can_stream: boolean;
+}

package/dist/types.js

@@ -0,0 +1,13 @@
+/**
+ * The Zynko API's objects, as the server sends them (docs.zynko.org/api/objetos). Ids are
+ * strings; times are milliseconds since 1970.
+ */
+export const ChannelType = {
+    TEXT: 0,
+    DM: 1,
+    VOICE: 2,
+    CATEGORY: 4,
+    POST: 11,
+    FORUM: 15,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,CAAC;IACP,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACD,CAAC"}

package/dist/voice.d.ts

@@ -0,0 +1,63 @@
+import type { Client } from './client.js';
+import { AudioPlayer, type FrameSink, type PlayerOptions } from './player.js';
+import type { Channel, Id, VoiceState } from './types.js';
+export interface JoinVoiceOptions extends PlayerOptions {
+    /**
+     * Hear the room: `audio` events with each person's sound (48 kHz). Off by default, so a
+     * bot that only plays does not download everyone's audio.
+     */
+    receive?: boolean;
+    /** "Conexão alternativa": media only through the voice server's relay. */
+    relay?: boolean;
+    /** Show the bot as deafened in the room (it still plays). */
+    deaf?: boolean;
+}
+export interface VoiceEvents {
+    /** Connected to the room's media (again, after a server move). */
+    ready: [];
+    /** One person's audio: interleaved 16-bit samples at 48 kHz, `channels` channels. */
+    audio: [userId: Id, samples: Int16Array, channels: number];
+    /** Who is speaking now, by user id. */
+    speaking: [userIds: Id[]];
+    /** Out of the room for good: left, removed, or the room went away. */
+    disconnect: [reason: string];
+    error: [error: Error];
+}
+export declare class VoiceConnection implements FrameSink {
+    readonly client: Client;
+    readonly channelId: Id;
+    private readonly opts;
+    status: 'connecting' | 'connected' | 'reconnecting' | 'closed';
+    /** The voice server the room is on (Brasil 1, Brasil 2...). */
+    server: string | null;
+    /** Can speak here: a room's roles may let the bot only listen. */
+    canSpeak: boolean;
+    readonly player: AudioPlayer;
+    private room;
+    private source;
+    private readonly emitter;
+    private leaving;
+    /** The server has confirmed the bot is in this room. */
+    private inRoom;
+    private moving;
+    constructor(client: Client, channelId: Id, opts?: JoinVoiceOptions);
+    on<K extends keyof VoiceEvents>(event: K, listener: (...args: VoiceEvents[K]) => void): this;
+    off<K extends keyof VoiceEvents>(event: K, listener: (...args: VoiceEvents[K]) => void): this;
+    /** The room's channel. */
+    get channel(): Channel | undefined;
+    /** Connects to the room's media and tells the house the bot is there. */
+    connect(): Promise<void>;
+    /** Leaves the room. */
+    leave(): Promise<void>;
+    capture(frame: Int16Array): Promise<void>;
+    flush(): void;
+    /** The room moved to another voice server (someone picked Brasil 1 or 2): follow it. */
+    onChannelUpdate(c: Channel): void;
+    /** The server says where the bot is in voice: elsewhere, or nowhere, ends this connection. */
+    onOwnState(v: VoiceState): void;
+    /** After the gateway reconnects: say again where the bot is. */
+    resync(): void;
+    private announce;
+    private hear;
+    private end;
+}

package/dist/voice.js

@@ -0,0 +1,203 @@
+/**
+ * A bot in a voice room. The Zynko server hands out a media token (POST /channels/{id}/voice)
+ * and the house learns where the bot is from gateway op 4; the audio itself travels through
+ * LiveKit, the same media server the apps use, through the `@livekit/rtc-node` package.
+ *
+ * ```ts
+ * const voice = await client.joinVoice(channelId);
+ * voice.player.enqueue('https://exemplo.com/musica.mp3');
+ * ```
+ */
+import { EventEmitter } from 'node:events';
+import { AudioPlayer, CHANNELS, FRAME_SAMPLES, SAMPLE_RATE } from './player.js';
+let rtc = null;
+async function loadRtc() {
+    if (rtc)
+        return rtc;
+    try {
+        rtc = (await import('@livekit/rtc-node'));
+    }
+    catch {
+        throw new Error('A voz precisa do pacote @livekit/rtc-node: npm install @livekit/rtc-node');
+    }
+    return rtc;
+}
+export class VoiceConnection {
+    client;
+    channelId;
+    opts;
+    status = 'connecting';
+    /** The voice server the room is on (Brasil 1, Brasil 2...). */
+    server = null;
+    /** Can speak here: a room's roles may let the bot only listen. */
+    canSpeak = true;
+    player;
+    room = null;
+    source = null;
+    emitter = new EventEmitter();
+    leaving = false;
+    /** The server has confirmed the bot is in this room. */
+    inRoom = false;
+    moving = null;
+    constructor(client, channelId, opts = {}) {
+        this.client = client;
+        this.channelId = channelId;
+        this.opts = opts;
+        this.player = new AudioPlayer(this, opts);
+        this.emitter.on('error', () => { });
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return this;
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+        return this;
+    }
+    /** The room's channel. */
+    get channel() {
+        return this.client.channels.get(this.channelId);
+    }
+    /** Connects to the room's media and tells the house the bot is there. */
+    async connect() {
+        const lk = await loadRtc();
+        const join = await this.client.rest.voiceToken(this.channelId);
+        this.server = join.server ?? null;
+        this.canSpeak = join.can_speak !== false;
+        const room = new lk.Room();
+        this.room = room;
+        room
+            .on(lk.RoomEvent.Disconnected, (reason) => {
+            if (this.room !== room || this.leaving)
+                return;
+            // The room closed under us: a server move is followed through CHANNEL_UPDATE; anything
+            // else (removed, room deleted) ends the connection.
+            if (this.moving)
+                return;
+            void this.end(`desconectado (${lk.DisconnectReason[reason] ?? reason})`);
+        })
+            .on(lk.RoomEvent.ActiveSpeakersChanged, (speakers) => this.emitter.emit('speaking', speakers.map((p) => p.identity)))
+            .on(lk.RoomEvent.TrackSubscribed, (track, _pub, participant) => {
+            if (track.kind !== lk.TrackKind.KIND_AUDIO || !this.opts.receive)
+                return;
+            void this.hear(lk, track, participant.identity);
+        });
+        const rtcConfig = this.opts.relay
+            ? { iceTransportType: lk.IceTransportType.TRANSPORT_RELAY, continualGatheringPolicy: lk.ContinualGatheringPolicy.GATHER_CONTINUALLY, iceServers: [] }
+            : undefined;
+        await room.connect(join.url, join.token, { autoSubscribe: !!this.opts.receive, dynacast: false, ...(rtcConfig ? { rtcConfig } : {}) });
+        if (this.room !== room)
+            return void room.disconnect();
+        if (this.canSpeak) {
+            const source = new lk.AudioSource(SAMPLE_RATE, CHANNELS, 200);
+            const track = lk.LocalAudioTrack.createAudioTrack('zynko', source);
+            await room.localParticipant.publishTrack(track, new lk.TrackPublishOptions({ source: lk.TrackSource.SOURCE_MICROPHONE, dtx: false, red: false, audioEncoding: { maxBitrate: 128000n } }));
+            this.source = source;
+        }
+        this.announce();
+        this.status = 'connected';
+        this.emitter.emit('ready');
+    }
+    /** Leaves the room. */
+    async leave() {
+        if (this.status === 'closed')
+            return;
+        this.leaving = true;
+        this.player.stop();
+        this.client.sendOp(4, { channel_id: null, self_mute: false, self_deaf: false });
+        await this.end('saiu');
+    }
+    // ---------- FrameSink, for the player ----------
+    async capture(frame) {
+        const lk = rtc;
+        if (!lk)
+            return;
+        // Moving to another server: wait for the new connection, then go on where it was.
+        if (this.moving)
+            await this.moving.catch(() => { });
+        const source = this.source;
+        if (!source || this.status === 'closed')
+            return;
+        await source.captureFrame(new lk.AudioFrame(frame, SAMPLE_RATE, CHANNELS, FRAME_SAMPLES));
+    }
+    flush() {
+        this.source?.clearQueue();
+    }
+    // ---------- from the client ----------
+    /** The room moved to another voice server (someone picked Brasil 1 or 2): follow it. */
+    onChannelUpdate(c) {
+        if (c.id !== this.channelId || this.status !== 'connected' || !c.voice_server || c.voice_server === this.server)
+            return;
+        this.moving = (async () => {
+            this.status = 'reconnecting';
+            const old = this.room;
+            const oldSource = this.source;
+            this.room = null;
+            this.source = null;
+            await old?.disconnect();
+            await oldSource?.close();
+            try {
+                await this.connect();
+            }
+            catch (e) {
+                await this.end('não conseguiu entrar no servidor novo');
+                this.emitter.emit('error', e instanceof Error ? e : new Error(String(e)));
+            }
+        })().finally(() => (this.moving = null));
+    }
+    /** The server says where the bot is in voice: elsewhere, or nowhere, ends this connection. */
+    onOwnState(v) {
+        if (this.status === 'closed' || this.leaving)
+            return;
+        if (v.channel_id === this.channelId) {
+            this.inRoom = true;
+            return;
+        }
+        // Moving from another room, its "left" state can arrive after this one began: only a state
+        // that comes once the server has the bot here means it was moved or removed.
+        if (!this.inRoom)
+            return;
+        void this.end(v.channel_id ? 'entrou em outra sala' : 'removido da sala');
+    }
+    /** After the gateway reconnects: say again where the bot is. */
+    resync() {
+        if (this.status === 'connected' || this.status === 'reconnecting')
+            this.announce();
+    }
+    announce() {
+        this.client.sendOp(4, { channel_id: this.channelId, self_mute: !this.canSpeak, self_deaf: !!this.opts.deaf });
+    }
+    async hear(lk, track, userId) {
+        const reader = new lk.AudioStream(track, SAMPLE_RATE, 1).getReader();
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done || this.status === 'closed')
+                    break;
+                this.emitter.emit('audio', userId, value.data, value.channels);
+            }
+        }
+        catch {
+            /* the track went away */
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    async end(reason) {
+        if (this.status === 'closed')
+            return;
+        this.status = 'closed';
+        this.player.stop();
+        const room = this.room;
+        const source = this.source;
+        this.room = null;
+        this.source = null;
+        await room?.disconnect().catch(() => { });
+        await source?.close().catch(() => { });
+        if (this.client.voice === this)
+            this.client.voice = null;
+        this.emitter.emit('disconnect', reason);
+    }
+}
+//# sourceMappingURL=voice.js.map

package/dist/voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../src/voice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAsC,MAAM,aAAa,CAAC;AAIpH,IAAI,GAAG,GAAe,IAAI,CAAC;AAE3B,KAAK,UAAU,OAAO;IACpB,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,IAAI,CAAC;QACH,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAQ,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AA0BD,MAAM,OAAO,eAAe;IAgBf;IACA;IACQ;IAjBnB,MAAM,GAA2D,YAAY,CAAC;IAC9E,+DAA+D;IAC/D,MAAM,GAAkB,IAAI,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,GAAG,IAAI,CAAC;IACP,MAAM,CAAc;IACrB,IAAI,GAAoB,IAAI,CAAC;IAC7B,MAAM,GAA2B,IAAI,CAAC;IAC7B,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IACtC,OAAO,GAAG,KAAK,CAAC;IACxB,wDAAwD;IAChD,MAAM,GAAG,KAAK,CAAC;IACf,MAAM,GAAyB,IAAI,CAAC;IAE5C,YACW,MAAc,EACd,SAAa,EACL,OAAyB,EAAE;QAFnC,WAAM,GAAN,MAAM,CAAQ;QACd,cAAS,GAAT,SAAS,CAAI;QACL,SAAI,GAAJ,IAAI,CAAuB;QAE5C,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,EAAE,CAA8B,KAAQ,EAAE,QAA2C;QACnF,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAqC,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAA8B,KAAQ,EAAE,QAA2C;QACpF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAqC,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0BAA0B;IAC1B,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,OAAO;QACX,MAAM,EAAE,GAAG,MAAM,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI;aACD,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACxC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO;YAC/C,uFAAuF;YACvF,oDAAoD;YACpD,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO;YACxB,KAAK,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;QAC3E,CAAC,CAAC;aACD,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;aACpH,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;YAC7D,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YACzE,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACL,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK;YAC/B,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,CAAC,eAAe,EAAE,wBAAwB,EAAE,EAAE,CAAC,wBAAwB,CAAC,kBAAkB,EAAE,UAAU,EAAE,EAAE,EAAE;YACrJ,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QACtD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC9D,MAAM,KAAK,GAAG,EAAE,CAAC,eAAe,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACnE,MAAM,IAAI,CAAC,gBAAiB,CAAC,YAAY,CACvC,KAAK,EACL,IAAI,EAAE,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,iBAAiB,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,OAAQ,EAAE,EAAE,CAAC,CAC1I,CAAC;YACF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAChF,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,kDAAkD;IAElD,KAAK,CAAC,OAAO,CAAC,KAAiB;QAC7B,MAAM,EAAE,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,kFAAkF;QAClF,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO;QAChD,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IAC5B,CAAC;IAED,wCAAwC;IAExC,wFAAwF;IACxF,eAAe,CAAC,CAAU;QACxB,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO;QACxH,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;YACtB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;YAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,MAAM,GAAG,EAAE,UAAU,EAAE,CAAC;YACxB,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACvB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;gBACxD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,8FAA8F;IAC9F,UAAU,CAAC,CAAa;QACtB,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACrD,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO;QACT,CAAC;QACD,2FAA2F;QAC3F,6EAA6E;QAC7E,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,gEAAgE;IAChE,MAAM;QACJ,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc;YAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IACrF,CAAC;IAEO,QAAQ;QACd,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,EAAO,EAAE,KAAsB,EAAE,MAAU;QAC5D,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QACrE,IAAI,CAAC;YACH,SAAS,CAAC;gBACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;oBAAE,MAAM;gBAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,MAAc;QAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO;QACrC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACzC,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;QACzD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "zynko",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Biblioteca oficial para bots do Zynko: API, gateway e voz.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  },
+  "peerDependencies": {
+    "@livekit/rtc-node": "1.2.1"
+  },
+  "peerDependenciesMeta": {
+    "@livekit/rtc-node": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "zynko",
+    "bot",
+    "chat",
+    "voice"
+  ],
+  "devDependencies": {
+    "@livekit/rtc-node": "^1.2.1",
+    "@types/node": "^22.20.5",
+    "typescript": "^5.9.3"
+  }
+}