@kentcdodds/twitch

@kentcdodds/twitch

Intent

Twitch Helix API helpers for Kody agents to monitor live streams, send chat messages, read chatters, and update channel settings during broadcasts. Transport is a thin OpenAPI-scaffolded client; live-status shaping and chat message guards stay in package domain helpers.

When To Use

• Check whether a Twitch channel is live and read stream metadata.
• Send chat messages or list chatters during a broadcast.
• Update channel title or game category while streaming.
• Call uncommon Helix endpoints through the low-level request helper.
• Verify saved Twitch credentials before mutating chat or channel settings.

Required setup

• OAuth integration: twitch (Authorization via createAuthenticatedFetch).
• Twitch application client id user value: twitch-client-id (sent as Client-Id — Helix requires both Authorization and Client-Id).
• Reconnect via /connect/oauth?provider=twitch when the token expires or lacks required scopes.
• The package exports TWITCH_INTEGRATION = "twitch" as metadata.
• Host approval for api.twitch.tv stays in the account security UI.

OpenAPI surface

Scaffolded from the community Helix OpenAPI document (auth kind integration for provider twitch; package merges Client-Id on every call):

• Spec: https://raw.githubusercontent.com/DmitryScaletta/twitch-api-swagger/main/openapi.json
• Slugs: get_users, get_streams, send_chat_message, get_chatters, modify_channel_information, search_categories

Exports

• ./ — package overview, connect URL, OpenAPI slug list, and export list.
• ./get-me — authenticated Twitch user profile (read-only).
• ./get-stream — live/offline status for one or more channel logins (read-only).
• ./send-chat-message — post a chat message to a channel (mutates).
• ./list-chatters — paginated chatters list for a channel (read-only).
• ./update-channel-info — update stream title and/or game category (mutates).
• ./request — low-level authenticated Helix HTTP helper.
• ./smoke-test — verify auth and sample stream status (read-only).
• ./guide — OAuth setup steps and common task hints.
• ./scopes — default and minimal OAuth scope sets.
• ./types — exported TypeScript type name catalog.

Example

import getStream from 'kody:@kentcdodds/twitch/get-stream'
import getMe from 'kody:@kentcdodds/twitch/get-me'

const me = await getMe()
const [stream] = await getStream({ login: me.login })