streamops-twitch-connector 0.0.0-stage → 0.1.2

package/README.md

@@ -1,3 +1,89 @@
-# Temporary Holding Version
+# streamops-twitch-connector
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# StreamOps Twitch Connector
+
+A framework-independent TypeScript connector for Twitch OAuth, Helix API
+requests, chat messaging, and EventSub WebSocket notifications.
+
+## Requirements
+
+- Node.js 22 or newer
+- A Twitch application with a registered Client ID
+- A token store implementation supplied by the consuming application
+
+## Install dependencies
+
+```text
+npm install
+```
+
+## Build
+
+```text
+npm run build
+```
+
+## Basic usage
+
+```typescript
+import {
+  TwitchClient,
+  type TwitchTokenStore,
+  type TwitchTokens,
+} from 'streamops-twitch-connector';
+
+const tokenStore: TwitchTokenStore = {
+  async load(): Promise<TwitchTokens | null> {
+    // Load tokens from your preferred secure storage.
+    return null;
+  },
+
+  async save(tokens: TwitchTokens): Promise<void> {
+    // Persist tokens securely.
+  },
+
+  async clear(): Promise<void> {
+    // Remove persisted tokens.
+  },
+};
+
+const twitch = new TwitchClient({
+  clientId: process.env.TWITCH_CLIENT_ID!,
+  scopes: ['user:read:chat', 'user:write:chat'],
+  tokenStore,
+});
+
+const login = await twitch.tokens.startLogin();
+
+console.log('Open:', login.verificationUri);
+console.log('Enter code:', login.userCode);
+
+// Call completeLogin() after starting the login flow.
+// The method polls until authorization succeeds or fails.
+await twitch.tokens.completeLogin();
+
+twitch.chat.onMessage(async (message) => {
+  console.log(`${message.chatterName}: ${message.text}`);
+});
+
+await twitch.connectEventSub();
+
+// After receiving the EventSub session welcome, subscribe using
+// twitch.eventSub.currentSessionId and twitch.subscriptions.
+```
+
+## Design
+
+- No dependency on NestJS or Express.
+- OAuth tokens are persisted through a caller-provided token store.
+- Helix requests automatically include the Client ID and access token.
+- Chat messages are received through EventSub and sent through Helix.
+- EventSub subscriptions use the active WebSocket session ID.
+
+## Notes
+
+The initial implementation assumes one authenticated Twitch account.
+A separate bot account and multi-account token management are not included.
+
+Treat token storage as sensitive. Do not commit access tokens or refresh
+tokens to source control.

package/dist/api/twitch-api-client.d.ts

@@ -0,0 +1,13 @@
+import type { TwitchConnectorConfig } from './types.js';
+import { TokenManager } from '../auth/token-manager.js';
+export declare class TwitchApiClient {
+    private readonly config;
+    private readonly tokenManager;
+    constructor(config: Pick<TwitchConnectorConfig, 'clientId' | 'fetch'>, tokenManager: TokenManager);
+    private get fetcher();
+    request<T>(path: string, init?: RequestInit): Promise<T>;
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+}
+//# sourceMappingURL=twitch-api-client.d.ts.map

package/dist/api/twitch-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitch-api-client.d.ts","sourceRoot":"","sources":["../../src/api/twitch-api-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAKxD,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAIvB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAJZ,MAAM,EAAE,IAAI,CAC3B,qBAAqB,EACrB,UAAU,GAAG,OAAO,CACrB,EACgB,YAAY,EAAE,YAAY;IAG7C,OAAO,KAAK,OAAO,GAElB;IAEK,OAAO,CAAC,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,CAAC,CAAC;IAqCb,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAOhD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAKpC"}

package/dist/api/twitch-api-client.js

@@ -0,0 +1,50 @@
+import { TwitchError } from '../errors/twitch-error.js';
+const HELIX_BASE_URL = 'https://api.twitch.tv/helix';
+export class TwitchApiClient {
+    config;
+    tokenManager;
+    constructor(config, tokenManager) {
+        this.config = config;
+        this.tokenManager = tokenManager;
+    }
+    get fetcher() {
+        return this.config.fetch ?? fetch;
+    }
+    async request(path, init = {}) {
+        const accessToken = await this.tokenManager.getAccessToken();
+        const url = new URL(path.replace(/^\/+/, ''), `${HELIX_BASE_URL}/`);
+        const headers = new Headers(init.headers);
+        headers.set('Client-Id', this.config.clientId);
+        headers.set('Authorization', `Bearer ${accessToken}`);
+        if (init.body && !headers.has('Content-Type')) {
+            headers.set('Content-Type', 'application/json');
+        }
+        const response = await this.fetcher(url, {
+            ...init,
+            headers,
+        });
+        if (!response.ok) {
+            const responseText = await response.text().catch(() => '');
+            throw new TwitchError(`Twitch Helix request failed (${response.status})${responseText ? `: ${responseText}` : ''}`, response.status);
+        }
+        if (response.status === 204) {
+            return undefined;
+        }
+        return (await response.json());
+    }
+    get(path) {
+        return this.request(path);
+    }
+    post(path, body) {
+        return this.request(path, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    delete(path) {
+        return this.request(path, {
+            method: 'DELETE',
+        });
+    }
+}
+//# sourceMappingURL=twitch-api-client.js.map

package/dist/api/twitch-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitch-api-client.js","sourceRoot":"","sources":["../../src/api/twitch-api-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAErD,MAAM,OAAO,eAAe;IAEP;IAIA;IALnB,YACmB,MAGhB,EACgB,YAA0B;QAJ1B,WAAM,GAAN,MAAM,CAGtB;QACgB,iBAAY,GAAZ,YAAY,CAAc;IAC1C,CAAC;IAEJ,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,OAAoB,EAAE;QAEtB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC;QAC7D,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EACxB,GAAG,cAAc,GAAG,CACrB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,WAAW,EAAE,CAAC,CAAC;QAEtD,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YACvC,GAAG,IAAI;YACP,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3D,MAAM,IAAI,WAAW,CACnB,gCAAgC,QAAQ,CAAC,MAAM,IAC7C,YAAY,CAAC,CAAC,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC,CAAC,EACvC,EAAE,EACF,QAAQ,CAAC,MAAM,CAChB,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,SAAc,CAAC;QACxB,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IACtC,CAAC;IAED,GAAG,CAAI,IAAY;QACjB,OAAO,IAAI,CAAC,OAAO,CAAI,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAI,IAAY,EAAE,IAAa;QACjC,OAAO,IAAI,CAAC,OAAO,CAAI,IAAI,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAI,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAI,IAAI,EAAE;YAC3B,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/api/types.d.ts

@@ -0,0 +1,15 @@
+import type { TwitchTokenStore } from '../auth/token-store.js';
+export interface TwitchConnectorConfig {
+    clientId: string;
+    scopes: string[];
+    tokenStore: TwitchTokenStore;
+    fetch?: typeof fetch;
+}
+export interface TwitchValidatedToken {
+    client_id: string;
+    login: string;
+    scopes: string[];
+    user_id: string;
+    expires_in: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/api/types.js

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

package/dist/api/types.js.map

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

package/dist/auth/device-code-flow.d.ts

@@ -0,0 +1,29 @@
+import type { TwitchConnectorConfig } from '../api/types.js';
+export interface DeviceCodeTokenResponse {
+    access_token: string;
+    refresh_token: string;
+    expires_in: number;
+    scope: string[];
+    token_type: string;
+}
+export interface DeviceCodeLogin {
+    userCode: string;
+    verificationUri: string;
+    expiresIn: number;
+    interval: number;
+}
+export declare class DeviceCodeFlow {
+    private readonly config;
+    private readonly fetchImpl;
+    private deviceCode;
+    private expiresAt;
+    private pollInterval;
+    private loginInProgress;
+    constructor(config: Pick<TwitchConnectorConfig, 'clientId' | 'scopes' | 'fetch'>);
+    startLogin(): Promise<DeviceCodeLogin>;
+    waitForAuthorization(signal?: AbortSignal): Promise<DeviceCodeTokenResponse>;
+    private readResponse;
+    private asOAuthError;
+    private delay;
+}
+//# sourceMappingURL=device-code-flow.d.ts.map

package/dist/auth/device-code-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-code-flow.d.ts","sourceRoot":"","sources":["../../src/auth/device-code-flow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAW7D,MAAM,WAAW,uBAAuB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAQD,qBAAa,cAAc;IAQnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAP3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAS;gBAGX,MAAM,EAAE,IAAI,CACzB,qBAAqB,EACrB,UAAU,GAAG,QAAQ,GAAG,OAAO,CAClC;IAKC,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAqFtC,oBAAoB,CACtB,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,uBAAuB,CAAC;YAgJrB,YAAY;IAgB1B,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,KAAK;CAqChB"}

package/dist/auth/device-code-flow.js

@@ -0,0 +1,185 @@
+import { TwitchError } from '../errors/twitch-error.js';
+export class DeviceCodeFlow {
+    config;
+    fetchImpl;
+    deviceCode = null;
+    expiresAt = 0;
+    pollInterval = 5;
+    loginInProgress = false;
+    constructor(config) {
+        this.config = config;
+        this.fetchImpl = config.fetch ?? fetch;
+    }
+    async startLogin() {
+        if (this.loginInProgress || this.deviceCode !== null) {
+            throw new TwitchError('A Twitch device login is already active.', undefined, 'login_already_active');
+        }
+        const body = new URLSearchParams({
+            client_id: this.config.clientId,
+            scopes: this.config.scopes.join(' '),
+        });
+        let response;
+        try {
+            response = await this.fetchImpl('https://id.twitch.tv/oauth2/device', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+                body,
+            });
+        }
+        catch (cause) {
+            throw new TwitchError('Unable to contact Twitch to start device login.', undefined, 'device_login_network_error', { cause });
+        }
+        const data = await this.readResponse(response, 'start device login');
+        if (!response.ok) {
+            const error = this.asOAuthError(data);
+            throw new TwitchError(error.message ??
+                error.error ??
+                'Failed to start Twitch device login.', response.status, error.error ?? 'device_login_failed');
+        }
+        const result = data;
+        if (typeof result.device_code !== 'string' ||
+            !result.device_code ||
+            typeof result.user_code !== 'string' ||
+            !result.user_code ||
+            typeof result.verification_uri !== 'string' ||
+            !result.verification_uri ||
+            typeof result.expires_in !== 'number' ||
+            !Number.isFinite(result.expires_in) ||
+            result.expires_in <= 0) {
+            throw new TwitchError('Twitch returned an invalid device login response.', response.status, 'invalid_device_response');
+        }
+        this.deviceCode = result.device_code;
+        this.expiresAt = Date.now() + result.expires_in * 1000;
+        this.pollInterval =
+            typeof result.interval === 'number' && result.interval > 0
+                ? result.interval
+                : 5;
+        return {
+            userCode: result.user_code,
+            verificationUri: result.verification_uri,
+            expiresIn: result.expires_in,
+            interval: this.pollInterval,
+        };
+    }
+    async waitForAuthorization(signal) {
+        const deviceCode = this.deviceCode;
+        if (!deviceCode) {
+            throw new TwitchError('No active device login. Call startLogin() first.', undefined, 'no_active_device_login');
+        }
+        if (this.loginInProgress) {
+            throw new TwitchError('Device authorization polling is already active.', undefined, 'login_poll_already_active');
+        }
+        this.loginInProgress = true;
+        try {
+            while (Date.now() < this.expiresAt) {
+                await this.delay(this.pollInterval * 1000, signal);
+                if (signal?.aborted) {
+                    throw new TwitchError('Twitch device login was cancelled.', undefined, 'login_cancelled');
+                }
+                const body = new URLSearchParams({
+                    client_id: this.config.clientId,
+                    scopes: this.config.scopes.join(' '),
+                    device_code: deviceCode,
+                    grant_type: 'urn:ietf:params:oauth:grant-type:device_code',
+                });
+                let response;
+                try {
+                    response = await this.fetchImpl('https://id.twitch.tv/oauth2/token', {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/x-www-form-urlencoded',
+                        },
+                        body,
+                        signal,
+                    });
+                }
+                catch (cause) {
+                    if (signal?.aborted) {
+                        throw new TwitchError('Twitch device login was cancelled.', undefined, 'login_cancelled', { cause });
+                    }
+                    throw new TwitchError('Unable to contact Twitch while waiting for device authorization.', undefined, 'device_login_network_error', { cause });
+                }
+                const data = await this.readResponse(response, 'poll device login');
+                if (response.ok) {
+                    const token = data;
+                    if (typeof token.access_token !== 'string' ||
+                        typeof token.refresh_token !== 'string' ||
+                        typeof token.expires_in !== 'number' ||
+                        !Array.isArray(token.scope)) {
+                        throw new TwitchError('Twitch returned an invalid device token response.', response.status, 'invalid_token_response');
+                    }
+                    return token;
+                }
+                const error = this.asOAuthError(data);
+                switch (error.error ?? error.message) {
+                    case 'authorization_pending':
+                        continue;
+                    case 'slow_down':
+                        this.pollInterval += 5;
+                        continue;
+                    case 'access_denied':
+                        throw new TwitchError('Twitch device login was denied by the user.', response.status, 'access_denied');
+                    case 'expired_token':
+                        throw new TwitchError('The Twitch device login code has expired.', response.status, 'device_code_expired');
+                    default:
+                        throw new TwitchError(error.message ??
+                            error.error ??
+                            'Twitch device authorization failed.', response.status, error.error ?? 'device_authorization_failed');
+                }
+            }
+            throw new TwitchError('The Twitch device login code has expired.', undefined, 'device_code_expired');
+        }
+        finally {
+            this.deviceCode = null;
+            this.expiresAt = 0;
+            this.pollInterval = 5;
+            this.loginInProgress = false;
+        }
+    }
+    async readResponse(response, action) {
+        try {
+            return await response.json();
+        }
+        catch (cause) {
+            throw new TwitchError(`Twitch returned an invalid response while attempting to ${action}.`, response.status, 'invalid_oauth_response', { cause });
+        }
+    }
+    asOAuthError(value) {
+        if (!value || typeof value !== 'object') {
+            return {};
+        }
+        const data = value;
+        return {
+            error: typeof data.error === 'string'
+                ? data.error
+                : undefined,
+            message: typeof data.message === 'string'
+                ? data.message
+                : undefined,
+            status: typeof data.status === 'number'
+                ? data.status
+                : undefined,
+        };
+    }
+    delay(ms, signal) {
+        return new Promise((resolve, reject) => {
+            if (signal?.aborted) {
+                reject(new TwitchError('Twitch device login was cancelled.', undefined, 'login_cancelled'));
+                return;
+            }
+            const timer = setTimeout(() => {
+                signal?.removeEventListener('abort', onAbort);
+                resolve();
+            }, ms);
+            const onAbort = () => {
+                clearTimeout(timer);
+                signal?.removeEventListener('abort', onAbort);
+                reject(new TwitchError('Twitch device login was cancelled.', undefined, 'login_cancelled'));
+            };
+            signal?.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+}
+//# sourceMappingURL=device-code-flow.js.map

package/dist/auth/device-code-flow.js.map

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

package/dist/auth/token-manager.d.ts

@@ -0,0 +1,20 @@
+import type { TwitchConnectorConfig, TwitchValidatedToken } from '../api/types.js';
+import type { DeviceCodeFlow } from './device-code-flow.js';
+import type { TwitchTokenStore, TwitchTokens } from './token-store.js';
+export declare class TokenManager {
+    private readonly config;
+    private readonly tokenStore;
+    private readonly deviceCodeFlow;
+    private refreshPromise;
+    constructor(config: Pick<TwitchConnectorConfig, 'clientId' | 'scopes' | 'fetch'>, tokenStore: TwitchTokenStore, deviceCodeFlow: DeviceCodeFlow);
+    private get fetcher();
+    getTokens(): Promise<TwitchTokens>;
+    getAccessToken(): Promise<string>;
+    getValidatedToken(): Promise<TwitchValidatedToken>;
+    startLogin(): Promise<import("./device-code-flow.js").DeviceCodeLogin>;
+    completeLogin(signal?: AbortSignal): Promise<TwitchTokens>;
+    logout(): Promise<void>;
+    private refreshTokens;
+    private performRefresh;
+}
+//# sourceMappingURL=token-manager.d.ts.map

package/dist/auth/token-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-manager.d.ts","sourceRoot":"","sources":["../../src/auth/token-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAavE,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAIvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IARjC,OAAO,CAAC,cAAc,CAAsC;gBAGzC,MAAM,EAAE,IAAI,CAC3B,qBAAqB,EACrB,UAAU,GAAG,QAAQ,GAAG,OAAO,CAChC,EACgB,UAAU,EAAE,gBAAgB,EAC5B,cAAc,EAAE,cAAc;IAGjD,OAAO,KAAK,OAAO,GAElB;IAEK,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAclC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIjC,iBAAiB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAmBlD,UAAU;IAIV,aAAa,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAc1D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,OAAO,CAAC,aAAa;YAYP,cAAc;CA4C7B"}

package/dist/auth/token-manager.js

@@ -0,0 +1,100 @@
+import { TwitchError } from '../errors/twitch-error.js';
+const TWITCH_VALIDATE_URL = 'https://id.twitch.tv/oauth2/validate';
+const TWITCH_TOKEN_URL = 'https://id.twitch.tv/oauth2/token';
+export class TokenManager {
+    config;
+    tokenStore;
+    deviceCodeFlow;
+    refreshPromise = null;
+    constructor(config, tokenStore, deviceCodeFlow) {
+        this.config = config;
+        this.tokenStore = tokenStore;
+        this.deviceCodeFlow = deviceCodeFlow;
+    }
+    get fetcher() {
+        return this.config.fetch ?? fetch;
+    }
+    async getTokens() {
+        const tokens = await this.tokenStore.load();
+        if (!tokens) {
+            throw new TwitchError('Not authenticated with Twitch.');
+        }
+        if (tokens.expiresAt > Date.now() + 60_000) {
+            return tokens;
+        }
+        return this.refreshTokens(tokens);
+    }
+    async getAccessToken() {
+        return (await this.getTokens()).accessToken;
+    }
+    async getValidatedToken() {
+        const tokens = await this.getTokens();
+        const response = await this.fetcher(TWITCH_VALIDATE_URL, {
+            headers: {
+                Authorization: `OAuth ${tokens.accessToken}`,
+            },
+        });
+        if (!response.ok) {
+            throw new TwitchError('Twitch token validation failed.', response.status);
+        }
+        return (await response.json());
+    }
+    async startLogin() {
+        return this.deviceCodeFlow.startLogin();
+    }
+    async completeLogin(signal) {
+        const response = await this.deviceCodeFlow.waitForAuthorization(signal);
+        const tokens = {
+            accessToken: response.access_token,
+            refreshToken: response.refresh_token,
+            expiresAt: Date.now() + response.expires_in * 1000,
+            scopes: response.scope,
+        };
+        await this.tokenStore.save(tokens);
+        return tokens;
+    }
+    async logout() {
+        await this.tokenStore.clear();
+    }
+    refreshTokens(current) {
+        if (this.refreshPromise) {
+            return this.refreshPromise;
+        }
+        this.refreshPromise = this.performRefresh(current).finally(() => {
+            this.refreshPromise = null;
+        });
+        return this.refreshPromise;
+    }
+    async performRefresh(current) {
+        const body = new URLSearchParams({
+            grant_type: 'refresh_token',
+            refresh_token: current.refreshToken,
+            client_id: this.config.clientId,
+        });
+        const response = await this.fetcher(TWITCH_TOKEN_URL, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+            body,
+        });
+        if (!response.ok) {
+            throw new TwitchError('Twitch token refresh failed. You may need to log in again.', response.status);
+        }
+        const result = (await response.json());
+        if (!result.access_token ||
+            !result.refresh_token ||
+            !Number.isFinite(result.expires_in)) {
+            throw new TwitchError('Twitch returned an invalid refresh response.');
+        }
+        const tokens = {
+            accessToken: result.access_token,
+            refreshToken: result.refresh_token,
+            expiresAt: Date.now() + result.expires_in * 1000,
+            scopes: result.scope ?? current.scopes,
+        };
+        await this.tokenStore.save(tokens);
+        return tokens;
+    }
+}
+//# sourceMappingURL=token-manager.js.map

package/dist/auth/token-manager.js.map

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

package/dist/auth/token-store.d.ts

@@ -0,0 +1,13 @@
+export interface TwitchTokens {
+    accessToken: string;
+    refreshToken: string;
+    /** Unix timestamp in milliseconds. */
+    expiresAt: number;
+    scopes: string[];
+}
+export interface TwitchTokenStore {
+    load(): Promise<TwitchTokens | null>;
+    save(tokens: TwitchTokens): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=token-store.d.ts.map

package/dist/auth/token-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-store.d.ts","sourceRoot":"","sources":["../../src/auth/token-store.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/auth/token-store.js

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

package/dist/auth/token-store.js.map

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

package/dist/chat/twitch-chat-client.d.ts

@@ -0,0 +1,11 @@
+import type { TwitchApiClient } from '../api/twitch-api-client.js';
+import type { SendChatMessageOptions, SendChatMessageResult, TwitchChatMessageHandler } from './types.js';
+export declare class TwitchChatClient {
+    private readonly api;
+    private readonly handlers;
+    constructor(api: TwitchApiClient);
+    onMessage(handler: TwitchChatMessageHandler): () => void;
+    handleEventSubMessage(payload: unknown): Promise<void>;
+    sendMessage(options: SendChatMessageOptions): Promise<SendChatMessageResult>;
+}
+//# sourceMappingURL=twitch-chat-client.d.ts.map

package/dist/chat/twitch-chat-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitch-chat-client.d.ts","sourceRoot":"","sources":["../../src/chat/twitch-chat-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EAErB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAyBpB,qBAAa,gBAAgB;IAGf,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;gBAEnC,GAAG,EAAE,eAAe;IAEjD,SAAS,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAKlD,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BtD,WAAW,CACf,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC;CA6BlC"}

package/dist/chat/twitch-chat-client.js

@@ -0,0 +1,54 @@
+import { TwitchError } from '../errors/twitch-error.js';
+export class TwitchChatClient {
+    api;
+    handlers = new Set();
+    constructor(api) {
+        this.api = api;
+    }
+    onMessage(handler) {
+        this.handlers.add(handler);
+        return () => this.handlers.delete(handler);
+    }
+    async handleEventSubMessage(payload) {
+        const event = payload;
+        if (!event.message_id ||
+            !event.broadcaster_user_id ||
+            !event.chatter_user_id) {
+            return;
+        }
+        const message = {
+            messageId: event.message_id,
+            broadcasterId: event.broadcaster_user_id,
+            chatterId: event.chatter_user_id,
+            chatterName: event.chatter_user_name ?? '',
+            text: event.message?.text ?? '',
+            sentAt: event.message_timestamp ?? new Date().toISOString(),
+            raw: payload,
+        };
+        for (const handler of this.handlers) {
+            await handler(message);
+        }
+    }
+    async sendMessage(options) {
+        const senderId = options.senderId ?? options.broadcasterId;
+        if (!options.message.trim()) {
+            throw new TwitchError('Chat message cannot be empty.');
+        }
+        const response = await this.api.post('/chat/messages', {
+            broadcaster_id: options.broadcasterId,
+            sender_id: senderId,
+            message: options.message,
+        });
+        const result = response.data?.[0];
+        if (!result) {
+            throw new TwitchError('Twitch returned no chat-send result.');
+        }
+        return {
+            messageId: result.message_id,
+            isSent: result.is_sent,
+            dropReason: result.drop_reason?.message ?? result.drop_reason?.code,
+            raw: response,
+        };
+    }
+}
+//# sourceMappingURL=twitch-chat-client.js.map