@overlive/se 0.1.0

package/dist/SEAdapter.d.ts

@@ -0,0 +1,42 @@
+import type { RestCapableAdapter, AdapterEventHandler, ConnectionState, SuppressionMap, AdapterStateInfo } from '@overlive/core';
+import { SERestClient } from './SERestClient.js';
+export interface SEAdapterConfig {
+    /**
+     * StreamElements JWT token.
+     * Found at https://streamelements.com/dashboard/account/channels
+     */
+    jwt: string;
+    /**
+     * Your StreamElements channel ID.
+     */
+    channelId: string;
+}
+export declare class SEAdapter implements RestCapableAdapter {
+    private readonly config;
+    readonly platform: "streamelements";
+    readonly displayName = "StreamElements";
+    /**
+     * When Twitch is present, SE defers on all events it can't own exclusively.
+     * Tips/donations are NOT in this list — SE owns those.
+     */
+    readonly suppressedBy: SuppressionMap;
+    private _state;
+    private handler;
+    private stateHandler;
+    private socket;
+    readonly rest: SERestClient;
+    constructor(config: SEAdapterConfig);
+    get state(): ConnectionState;
+    onEvent(handler: AdapterEventHandler): void;
+    onStateChange(handler: (info: AdapterStateInfo) => void): void;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    private dispatchSEEvent;
+    private normalizeTip;
+    private normalizeSub;
+    private normalizeRaid;
+    private normalizeFollow;
+    private normalizeCheer;
+    private setState;
+}
+//# sourceMappingURL=SEAdapter.d.ts.map

package/dist/SEAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SEAdapter.d.ts","sourceRoot":"","sources":["../src/SEAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,gBAAgB,EAMjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAShD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;IAEX;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,SAAU,YAAW,kBAAkB;IA8BtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IA7BnC,QAAQ,CAAC,QAAQ,mBAAW;IAC5B,QAAQ,CAAC,WAAW,oBAAmB;IAEvC;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,cAAc,CAapC;IAED,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,YAAY,CAAkD;IACtE,OAAO,CAAC,MAAM,CAAgB;IAE9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;gBAEE,MAAM,EAAE,eAAe;IAIpD,IAAI,KAAK,IAAI,eAAe,CAE3B;IAED,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAI3C,aAAa,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAIxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoDxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,QAAQ;CAYjB"}

package/dist/SEAdapter.js

@@ -0,0 +1,232 @@
+const randomUUID = () => globalThis.crypto.randomUUID();
+import { SERestClient } from './SERestClient.js';
+const PLATFORM = 'streamelements';
+const SE_REALTIME = 'https://realtime.streamelements.com';
+export class SEAdapter {
+    config;
+    platform = PLATFORM;
+    displayName = 'StreamElements';
+    /**
+     * When Twitch is present, SE defers on all events it can't own exclusively.
+     * Tips/donations are NOT in this list — SE owns those.
+     */
+    suppressedBy = {
+        subscription: ['twitch'],
+        gift_bomb: ['twitch'],
+        raid: ['twitch'],
+        follow: ['twitch'],
+        ban: ['twitch'],
+        'chat.message': ['twitch'],
+        'chat.command': ['twitch'],
+        'chat.delete': ['twitch'],
+        'ad.start': ['twitch'],
+        'ad.end': ['twitch'],
+        'stream.online': ['twitch'],
+        'stream.offline': ['twitch'],
+    };
+    _state = 'disconnected';
+    handler = null;
+    stateHandler = null;
+    socket = null;
+    rest;
+    constructor(config) {
+        this.config = config;
+        this.rest = new SERestClient(config.jwt, config.channelId);
+    }
+    get state() {
+        return this._state;
+    }
+    onEvent(handler) {
+        this.handler = handler;
+    }
+    onStateChange(handler) {
+        this.stateHandler = handler;
+    }
+    async connect() {
+        this.setState('connecting');
+        const { io } = await import('socket.io-client');
+        const socket = io(SE_REALTIME, {
+            transports: ['websocket'],
+        });
+        return new Promise((resolve, reject) => {
+            socket.on('connect', () => {
+                socket.emit('authenticate', {
+                    method: 'jwt',
+                    token: this.config.jwt,
+                });
+            });
+            socket.on('authenticated', () => {
+                this.setState('connected');
+                resolve();
+            });
+            socket.on('unauthorized', (err) => {
+                this.setState('error', { reason: 'token_revoked', message: `SE authentication failed: ${String(err)}` });
+                reject(new Error(`SE authentication failed: ${String(err)}`));
+            });
+            socket.on('disconnect', () => {
+                this.setState('disconnected');
+            });
+            socket.on('reconnecting', () => {
+                this.setState('reconnecting');
+            });
+            socket.on('event', (data) => {
+                this.dispatchSEEvent(data);
+            });
+            socket.on('event:test', (data) => {
+                this.dispatchSEEvent(data);
+            });
+            socket.on('connect_error', (err) => {
+                this.setState('error', { reason: 'network', message: err.message });
+                reject(err);
+            });
+            this.socket = socket;
+        });
+    }
+    async disconnect() {
+        if (this.socket) {
+            ;
+            this.socket.disconnect();
+            this.socket = null;
+        }
+        this.setState('disconnected');
+    }
+    // ─── SE event dispatch ────────────────────────────────────────────────────
+    dispatchSEEvent(raw) {
+        if (!this.handler)
+            return;
+        const data = raw;
+        const type = String(data['type'] ?? '');
+        const channel = this.config.channelId;
+        try {
+            switch (type) {
+                case 'tip':
+                    this.handler(this.normalizeTip(data, channel));
+                    break;
+                case 'subscriber':
+                    this.handler(this.normalizeSub(data, channel));
+                    break;
+                case 'raid':
+                    this.handler(this.normalizeRaid(data, channel));
+                    break;
+                case 'follower':
+                    this.handler(this.normalizeFollow(data, channel));
+                    break;
+                case 'cheer':
+                    this.handler(this.normalizeCheer(data, channel));
+                    break;
+                // merch, redemptions etc. can be added as SE exposes them
+            }
+        }
+        catch (e) {
+            console.error(`[overlive:se] Error normalizing ${type}:`, e);
+        }
+    }
+    // ─── Normalizers ──────────────────────────────────────────────────────────
+    normalizeTip(data, channel) {
+        const e = (data['event'] ?? data);
+        return {
+            id: String(e['_id'] ?? randomUUID()),
+            type: 'redemption',
+            platform: PLATFORM,
+            channel,
+            timestamp: new Date(String(e['createdAt'] ?? Date.now())),
+            raw: data,
+            data: {
+                username: String(e['username'] ?? ''),
+                displayName: String(e['username'] ?? ''),
+                currency: {
+                    kind: 'tip',
+                    amount: Number(e['amount'] ?? 0),
+                    currency: String(e['currency'] ?? 'USD'),
+                    formattedAmount: String(e['formattedAmount'] ?? `$${e['amount']}`),
+                },
+                ...(e['message'] ? { message: String(e['message']) } : {}),
+            },
+        };
+    }
+    normalizeSub(data, channel) {
+        const e = (data['event'] ?? data);
+        return {
+            id: randomUUID(),
+            type: 'subscription',
+            platform: PLATFORM,
+            channel,
+            timestamp: new Date(),
+            raw: data,
+            data: {
+                username: String(e['name'] ?? ''),
+                displayName: String(e['displayName'] ?? e['name'] ?? ''),
+                tier: 'tier1', // SE doesn't always expose tier
+                months: Number(e['amount'] ?? 1),
+                isFirst: false,
+                isResub: Number(e['amount'] ?? 1) > 1,
+                isGift: Boolean(e['gifted']),
+                ...(e['sender'] ? { gifter: { username: String(e['sender']), displayName: String(e['sender']) } } : {}),
+                ...(e['message'] ? { message: String(e['message']) } : {}),
+            },
+        };
+    }
+    normalizeRaid(data, channel) {
+        const e = (data['event'] ?? data);
+        return {
+            id: randomUUID(),
+            type: 'raid',
+            platform: PLATFORM,
+            channel,
+            timestamp: new Date(),
+            raw: data,
+            data: {
+                from: {
+                    username: String(e['name'] ?? ''),
+                    displayName: String(e['displayName'] ?? e['name'] ?? ''),
+                },
+                viewerCount: Number(e['amount'] ?? 0),
+            },
+        };
+    }
+    normalizeFollow(data, channel) {
+        const e = (data['event'] ?? data);
+        return {
+            id: randomUUID(),
+            type: 'follow',
+            platform: PLATFORM,
+            channel,
+            timestamp: new Date(String(e['createdAt'] ?? Date.now())),
+            raw: data,
+            data: {
+                username: String(e['name'] ?? ''),
+                displayName: String(e['displayName'] ?? e['name'] ?? ''),
+            },
+        };
+    }
+    normalizeCheer(data, channel) {
+        const e = (data['event'] ?? data);
+        return {
+            id: randomUUID(),
+            type: 'redemption',
+            platform: PLATFORM,
+            channel,
+            timestamp: new Date(),
+            raw: data,
+            data: {
+                username: String(e['name'] ?? ''),
+                displayName: String(e['displayName'] ?? e['name'] ?? ''),
+                currency: {
+                    kind: 'bits',
+                    amount: Number(e['amount'] ?? 0),
+                },
+                ...(e['message'] ? { message: String(e['message']) } : {}),
+            },
+        };
+    }
+    setState(state, detail) {
+        this._state = state;
+        const info = {
+            state,
+            ...(detail?.reason !== undefined && { reason: detail.reason }),
+            ...(detail?.message !== undefined && { message: detail.message }),
+        };
+        this.stateHandler?.(info);
+    }
+}
+//# sourceMappingURL=SEAdapter.js.map

package/dist/SEAdapter.js.map

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

package/dist/SERestClient.d.ts

@@ -0,0 +1,29 @@
+import type { AdapterRestClient, Platform, TopDonor } from '@overlive/core';
+export declare class SERestClient implements AdapterRestClient {
+    private readonly jwt;
+    private readonly channelId;
+    readonly platform: Platform;
+    constructor(jwt: string, channelId: string);
+    private get;
+    getTopDonors(options?: {
+        limit?: number;
+        period?: 'session' | 'week' | 'month' | 'alltime';
+    }): Promise<TopDonor[]>;
+    getSessionData(): Promise<Record<string, unknown>>;
+    getUserPoints(username: string): Promise<{
+        points: number;
+        rank: number;
+    } | null>;
+    getTopPoints(limit?: number): Promise<Array<{
+        username: string;
+        points: number;
+        rank: number;
+    }>>;
+    getStoreItems(): Promise<Array<{
+        id: string;
+        name: string;
+        cost: number;
+        enabled: boolean;
+    }>>;
+}
+//# sourceMappingURL=SERestClient.d.ts.map

package/dist/SERestClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SERestClient.d.ts","sourceRoot":"","sources":["../src/SERestClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAI3E,qBAAa,YAAa,YAAW,iBAAiB;IAIlD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAmB;gBAG3B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM;YAGtB,GAAG;IAiBX,YAAY,CAAC,OAAO,GAAE;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;KAC7C,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAuBtB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMlD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAcjF,YAAY,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAiB5F,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAapG"}

package/dist/SERestClient.js

@@ -0,0 +1,81 @@
+const SE_API = 'https://api.streamelements.com/kappa/v2';
+export class SERestClient {
+    jwt;
+    channelId;
+    platform = 'streamelements';
+    constructor(jwt, channelId) {
+        this.jwt = jwt;
+        this.channelId = channelId;
+    }
+    async get(path) {
+        const res = await fetch(`${SE_API}${path}`, {
+            headers: {
+                Authorization: `Bearer ${this.jwt}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`SE API error: ${res.status} ${res.statusText} (${path})`);
+        }
+        return res.json();
+    }
+    // ─── Top donors ───────────────────────────────────────────────────────────
+    async getTopDonors(options = {}) {
+        const period = options.period ?? 'alltime';
+        const limit = options.limit ?? 10;
+        const data = await this.get(`/tips/${this.channelId}/leaderboard?limit=${limit}&period=${period}`);
+        return data.docs.map((d) => {
+            const doc = d;
+            const user = (doc['user'] ?? {});
+            return {
+                username: String(user['username'] ?? ''),
+                displayName: String(user['displayName'] ?? user['username'] ?? ''),
+                amount: Number(doc['amount'] ?? 0),
+                currency: String(doc['currency'] ?? 'USD'),
+                platform: 'streamelements',
+            };
+        });
+    }
+    // ─── Session data ─────────────────────────────────────────────────────────
+    async getSessionData() {
+        return this.get(`/sessions/${this.channelId}`);
+    }
+    // ─── Points / loyalty ─────────────────────────────────────────────────────
+    async getUserPoints(username) {
+        try {
+            const data = await this.get(`/points/${this.channelId}/${username}`);
+            return {
+                points: Number(data['points'] ?? 0),
+                rank: Number(data['rank'] ?? 0),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async getTopPoints(limit = 10) {
+        const data = await this.get(`/points/${this.channelId}/top?limit=${limit}`);
+        return data.users.map((u, i) => {
+            const user = u;
+            return {
+                username: String(user['username'] ?? ''),
+                points: Number(user['points'] ?? 0),
+                rank: i + 1,
+            };
+        });
+    }
+    // ─── Store / redemptions ──────────────────────────────────────────────────
+    async getStoreItems() {
+        const data = await this.get(`/store/${this.channelId}/items`);
+        return data.items.map((item) => {
+            const i = item;
+            return {
+                id: String(i['_id'] ?? ''),
+                name: String(i['name'] ?? ''),
+                cost: Number(i['cost'] ?? 0),
+                enabled: Boolean(i['enabled']),
+            };
+        });
+    }
+}
+//# sourceMappingURL=SERestClient.js.map

package/dist/SERestClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SERestClient.js","sourceRoot":"","sources":["../src/SERestClient.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,yCAAyC,CAAA;AAExD,MAAM,OAAO,YAAY;IAIJ;IACA;IAJV,QAAQ,GAAa,gBAAgB,CAAA;IAE9C,YACmB,GAAW,EACX,SAAiB;QADjB,QAAG,GAAH,GAAG,CAAQ;QACX,cAAS,GAAT,SAAS,CAAQ;IACjC,CAAC;IAEI,KAAK,CAAC,GAAG,CAAI,IAAY;QAC/B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,EAAE;YAC1C,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,GAAG,EAAE;gBACnC,MAAM,EAAE,kBAAkB;aAC3B;SACF,CAAC,CAAA;QAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,GAAG,CAAC,CAAA;QAC5E,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAA;IACjC,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,YAAY,CAAC,UAGf,EAAE;QACJ,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAA;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAA;QAEjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CACzB,SAAS,IAAI,CAAC,SAAS,sBAAsB,KAAK,WAAW,MAAM,EAAE,CACtE,CAAA;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACzB,MAAM,GAAG,GAAG,CAA4B,CAAA;YACxC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAA4B,CAAA;YAC3D,OAAO;gBACL,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;gBACxC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;gBAClE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAClC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;gBAC1C,QAAQ,EAAE,gBAA4B;aACvC,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;IAChD,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,aAAa,CAAC,QAAgB;QAClC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CACzB,WAAW,IAAI,CAAC,SAAS,IAAI,QAAQ,EAAE,CACxC,CAAA;YACD,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACnC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;aAChC,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAK,GAAG,EAAE;QAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CACzB,WAAW,IAAI,CAAC,SAAS,cAAc,KAAK,EAAE,CAC/C,CAAA;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC7B,MAAM,IAAI,GAAG,CAA4B,CAAA;YACzC,OAAO;gBACL,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACnC,IAAI,EAAE,CAAC,GAAG,CAAC;aACZ,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAuB,UAAU,IAAI,CAAC,SAAS,QAAQ,CAAC,CAAA;QAEnF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC7B,MAAM,CAAC,GAAG,IAA+B,CAAA;YACzC,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC1B,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC7B,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC5B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;aAC/B,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { SEAdapter } from './SEAdapter.js';
+export type { SEAdapterConfig } from './SEAdapter.js';
+export { SERestClient } from './SERestClient.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { SEAdapter } from './SEAdapter.js';
+export { SERestClient } from './SERestClient.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,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@overlive/se",
+  "version": "0.1.0",
+  "description": "StreamElements adapter for the Overlive SDK",
+  "license": "UNLICENSED",
+  "author": "fennsorenn",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fennsorenn/overlive.git",
+    "directory": "packages/se"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "socket.io-client": "^4.7.0",
+    "@overlive/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}