@manaobot/kick 1.0.0

package/README.md

@@ -0,0 +1,163 @@
+<p align="center">
+  <a href="https://github.com/tinarskii/manao">
+    <img src="https://raw.githubusercontent.com/tinarskii/manao/main/docs/manao.svg" height="64px" width="auto" />
+    <h2 align="center">@manaobot/kick</h2>
+  </a>
+  <p align="center">
+    Minimal, type-safe JavaScript SDK for building Kick.com bots.
+    Designed for Bun. Works anywhere.
+  </p>
+  <div style="display: flex; flex-wrap: wrap; justify-content: center; gap: 8px;">
+    <img src="https://img.shields.io/npm/v/@manaobot/kick?color=00e701" alt="npm version">
+    <img src="https://img.shields.io/github/license/tinarskii/manao" />
+    <img src="https://img.shields.io/badge/Bun-%E2%9C%93-black?logo=bun" alt="Bun Compatible">
+    <a href="https://discord.gg/vkW7YMyYaf"><img src="https://img.shields.io/discord/964718161624715304" /></a>
+  </div>
+</p>
+
+---
+
+## ⚡ About
+
+`@manaobot/kick` is a lightweight TypeScript SDK for building Kick.com bots, tools, and automation.
+This library focuses on **OAuth**, **Webhooks**, and **REST APIs**, everything required to build production-grade Kick bots.
+
+---
+
+## 📦 Installation
+
+```bash
+bun add @manaobot/kick
+````
+
+---
+
+## 🚀 Quick Start
+
+```ts
+import { KickClient } from "@manaobot/kick";
+
+const kick = new KickClient({
+  clientId: process.env.KICK_CLIENT_ID!,
+  clientSecret: process.env.KICK_CLIENT_SECRET!,
+  redirectUri: "http://localhost:3000/callback",
+  scopes: ["chat:write"],
+});
+
+if (!process.env.KICK_REFRESH_TOKEN) {
+  console.log(kick.getAuthURL());
+  kick.auth.createCallbackServer({ port: 3000 });
+  await kick.auth.waitForAuthorization();
+}
+
+await kick.chat.send({
+  content: "Hello from Kick SDK!"
+});
+```
+
+---
+
+## ✨ Features
+
+### 🔐 Authentication
+
+* OAuth2 Authorization Code Flow
+* Automatic token refresh
+* PKCE support
+* Built-in callback server
+
+---
+
+### 🧩 Webhooks
+
+```ts
+kick.webhooks.on("chat.message.sent", (event) => {
+  console.log(event.content);
+});
+```
+
+* Signature verification
+* ngrok integration
+* Event subscription helpers
+
+---
+
+### 💬 Chat
+
+```ts
+await kick.chat.send({ content: "Hello chat!" });
+```
+
+---
+
+### 🌐 REST APIs
+
+Available via:
+
+```ts
+kick.api.*
+```
+
+Currently supported:
+
+* Categories API
+* Users API
+* Channels API
+* Channel Rewards API
+* Moderation API
+* Livestreams API
+* KICKs Leaderboard API
+
+---
+
+## 📚 Examples
+
+The repository includes numbered examples:
+
+| Example                  | Description              |
+| ------------------------ | ------------------------ |
+| `01-authorize-bot`       | OAuth authorization      |
+| `02-webhook`             | Webhook handling         |
+| `03-ngrok`               | Public webhook tunneling |
+| `04-categories-api`      | Categories API           |
+| `05-users-api`           | Users API                |
+| `06-channels-api`        | Channels API             |
+| `07-channel-rewards-api` | Channel rewards          |
+| `08-basic-chat-bot`      | Full bot template        |
+
+Run examples with:
+
+```bash
+bun example/08-basic-chat-bot
+```
+
+---
+
+## 🤝 Contributing
+
+Pull requests are welcome.
+
+If you want to help:
+
+* improve typings
+* add new API modules
+* write examples
+
+Join the Discord server:
+
+[https://discord.gg/vkW7YMyYaf](https://discord.gg/vkW7YMyYaf)
+
+---
+
+## 📜 License
+
+GPL-3.0 License
+See LICENSE file for details.
+
+---
+
+## ❤️ Part of the Manao Ecosystem
+
+This SDK powers the **ManaoBot** project:
+
+[https://github.com/tinarskii/manao](https://github.com/tinarskii/manao)

package/biome.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.2.4/schema.json",
+  "vcs": {
+    "enabled": false,
+    "clientKind": "git",
+    "useIgnoreFile": false
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "experimentalScannerIgnores": ["dist", "node_modules", "tsconfig.json"]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "always",
+      "lineEnding": "crlf",
+      "arrowParentheses": "always",
+      "bracketSpacing": true,
+      "bracketSameLine": false
+    },
+    "parser": {
+      "unsafeParameterDecoratorsEnabled": true
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  }
+}

package/bun.lock

@@ -0,0 +1,78 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "kick.js",
+      "dependencies": {
+        "consola": "^3.4.2",
+      },
+      "devDependencies": {
+        "@biomejs/biome": "2.3.14",
+        "@ngrok/ngrok": "^1.7.0",
+        "@types/bun": "^1.3.8",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@biomejs/biome": ["@biomejs/biome@2.3.14", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.3.14", "@biomejs/cli-darwin-x64": "2.3.14", "@biomejs/cli-linux-arm64": "2.3.14", "@biomejs/cli-linux-arm64-musl": "2.3.14", "@biomejs/cli-linux-x64": "2.3.14", "@biomejs/cli-linux-x64-musl": "2.3.14", "@biomejs/cli-win32-arm64": "2.3.14", "@biomejs/cli-win32-x64": "2.3.14" }, "bin": { "biome": "bin/biome" } }, "sha512-QMT6QviX0WqXJCaiqVMiBUCr5WRQ1iFSjvOLoTk6auKukJMvnMzWucXpwZB0e8F00/1/BsS9DzcKgWH+CLqVuA=="],
+
+    "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.3.14", "", { "os": "darwin", "cpu": "arm64" }, "sha512-UJGPpvWJMkLxSRtpCAKfKh41Q4JJXisvxZL8ChN1eNW3m/WlPFJ6EFDCE7YfUb4XS8ZFi3C1dFpxUJ0Ety5n+A=="],
+
+    "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@2.3.14", "", { "os": "darwin", "cpu": "x64" }, "sha512-PNkLNQG6RLo8lG7QoWe/hhnMxJIt1tEimoXpGQjwS/dkdNiKBLPv4RpeQl8o3s1OKI3ZOR5XPiYtmbGGHAOnLA=="],
+
+    "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@2.3.14", "", { "os": "linux", "cpu": "arm64" }, "sha512-KT67FKfzIw6DNnUNdYlBg+eU24Go3n75GWK6NwU4+yJmDYFe9i/MjiI+U/iEzKvo0g7G7MZqoyrhIYuND2w8QQ=="],
+
+    "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@2.3.14", "", { "os": "linux", "cpu": "arm64" }, "sha512-LInRbXhYujtL3sH2TMCH/UBwJZsoGwfQjBrMfl84CD4hL/41C/EU5mldqf1yoFpsI0iPWuU83U+nB2TUUypWeg=="],
+
+    "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@2.3.14", "", { "os": "linux", "cpu": "x64" }, "sha512-ZsZzQsl9U+wxFrGGS4f6UxREUlgHwmEfu1IrXlgNFrNnd5Th6lIJr8KmSzu/+meSa9f4rzFrbEW9LBBA6ScoMA=="],
+
+    "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@2.3.14", "", { "os": "linux", "cpu": "x64" }, "sha512-KQU7EkbBBuHPW3/rAcoiVmhlPtDSGOGRPv9js7qJVpYTzjQmVR+C9Rfcz+ti8YCH+zT1J52tuBybtP4IodjxZQ=="],
+
+    "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@2.3.14", "", { "os": "win32", "cpu": "arm64" }, "sha512-+IKYkj/pUBbnRf1G1+RlyA3LWiDgra1xpS7H2g4BuOzzRbRB+hmlw0yFsLprHhbbt7jUzbzAbAjK/Pn0FDnh1A=="],
+
+    "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.3.14", "", { "os": "win32", "cpu": "x64" }, "sha512-oizCjdyQ3WJEswpb3Chdngeat56rIdSYK12JI3iI11Mt5T5EXcZ7WLuowzEaFPNJ3zmOQFliMN8QY1Pi+qsfdQ=="],
+
+    "@ngrok/ngrok": ["@ngrok/ngrok@1.7.0", "", { "optionalDependencies": { "@ngrok/ngrok-android-arm64": "1.7.0", "@ngrok/ngrok-darwin-arm64": "1.7.0", "@ngrok/ngrok-darwin-universal": "1.7.0", "@ngrok/ngrok-darwin-x64": "1.7.0", "@ngrok/ngrok-freebsd-x64": "1.7.0", "@ngrok/ngrok-linux-arm-gnueabihf": "1.7.0", "@ngrok/ngrok-linux-arm64-gnu": "1.7.0", "@ngrok/ngrok-linux-arm64-musl": "1.7.0", "@ngrok/ngrok-linux-x64-gnu": "1.7.0", "@ngrok/ngrok-linux-x64-musl": "1.7.0", "@ngrok/ngrok-win32-arm64-msvc": "1.7.0", "@ngrok/ngrok-win32-ia32-msvc": "1.7.0", "@ngrok/ngrok-win32-x64-msvc": "1.7.0" } }, "sha512-P06o9TpxrJbiRbHQkiwy/rUrlXRupc+Z8KT4MiJfmcdWxvIdzjCaJOdnNkcOTs6DMyzIOefG5tvk/HLdtjqr0g=="],
+
+    "@ngrok/ngrok-android-arm64": ["@ngrok/ngrok-android-arm64@1.7.0", "", { "os": "android", "cpu": "arm64" }, "sha512-8tco3ID6noSaNy+CMS7ewqPoIkIM6XO5COCzsUp3Wv3XEbMSyn65RN6cflX2JdqLfUCHcMyD0ahr9IEiHwqmbQ=="],
+
+    "@ngrok/ngrok-darwin-arm64": ["@ngrok/ngrok-darwin-arm64@1.7.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-+dmJSOzSO+MNDVrPOca2yYDP1W3KfP4qOlAkarIeFRIfqonQwq3QCBmcR7HAlZocLsSqEwyG6KP4RRvAuT0WGQ=="],
+
+    "@ngrok/ngrok-darwin-universal": ["@ngrok/ngrok-darwin-universal@1.7.0", "", { "os": "darwin" }, "sha512-fDEfewyE2pWGFBhOSwQZObeHUkc65U1l+3HIgSOe094TMHsqmyJD0KTCgW9KSn0VP4OvDZbAISi1T3nvqgZYhQ=="],
+
+    "@ngrok/ngrok-darwin-x64": ["@ngrok/ngrok-darwin-x64@1.7.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-+fwMi5uHd9G8BS42MMa9ye6exI5lwTcjUO6Ut497Vu0qgLONdVRenRqnEePV+Q3KtQR7NjqkMnomVfkr9MBjtw=="],
+
+    "@ngrok/ngrok-freebsd-x64": ["@ngrok/ngrok-freebsd-x64@1.7.0", "", { "os": "freebsd", "cpu": "x64" }, "sha512-2OGgbrjy3yLRrqAz5N6hlUKIWIXSpR5RjQa2chtZMsSbszQ6c9dI+uVQfOKAeo05tHMUgrYAZ7FocC+ig0dzdQ=="],
+
+    "@ngrok/ngrok-linux-arm-gnueabihf": ["@ngrok/ngrok-linux-arm-gnueabihf@1.7.0", "", { "os": "linux", "cpu": "arm" }, "sha512-SN9YIfEQiR9xN90QVNvdgvAemqMLoFVSeTWZs779145hQMhvF9Qd9rnWi6J+2uNNK10OczdV1oc/nq1es7u/3g=="],
+
+    "@ngrok/ngrok-linux-arm64-gnu": ["@ngrok/ngrok-linux-arm64-gnu@1.7.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-KDMgzPKFU2kbpVSaA2RZBBia5IPdJEe063YlyVFnSMJmPYWCUnMwdybBsucXfV9u1Lw/ZjKTKotIlbTWGn3HGw=="],
+
+    "@ngrok/ngrok-linux-arm64-musl": ["@ngrok/ngrok-linux-arm64-musl@1.7.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-e66vUdVrBlQ0lT9ZdamB4U604zt5Gualt8/WVcUGzbu8s5LajWd6g/mzZCUjK4UepjvMpfgmCp1/+rX7Rk8d5A=="],
+
+    "@ngrok/ngrok-linux-x64-gnu": ["@ngrok/ngrok-linux-x64-gnu@1.7.0", "", { "os": "linux", "cpu": "x64" }, "sha512-M6gF0DyOEFqXLfWxObfL3bxYZ4+PnKBHuyLVaqNfFN9Y5utY2mdPOn5422Ppbk4XoIK5/YkuhRqPJl/9FivKEw=="],
+
+    "@ngrok/ngrok-linux-x64-musl": ["@ngrok/ngrok-linux-x64-musl@1.7.0", "", { "os": "linux", "cpu": "x64" }, "sha512-4Ijm0dKeoyzZTMaYxR2EiNjtlK81ebflg/WYIO1XtleFrVy4UJEGnxtxEidYoT4BfCqi4uvXiK2Mx216xXKvog=="],
+
+    "@ngrok/ngrok-win32-arm64-msvc": ["@ngrok/ngrok-win32-arm64-msvc@1.7.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-u7qyWIJI2/YG1HTBnHwUR1+Z2tyGfAsUAItJK/+N1G0FeWJhIWQvSIFJHlaPy4oW1Dc8mSDBX9qvVsiQgLaRFg=="],
+
+    "@ngrok/ngrok-win32-ia32-msvc": ["@ngrok/ngrok-win32-ia32-msvc@1.7.0", "", { "os": "win32", "cpu": "ia32" }, "sha512-/UdYUsLNv/Q8j9YJsyIfq/jLCoD8WP+NidouucTUzSoDtmOsXBBT3itLrmPiZTEdEgKiFYLuC1Zon8XQQvbVLA=="],
+
+    "@ngrok/ngrok-win32-x64-msvc": ["@ngrok/ngrok-win32-x64-msvc@1.7.0", "", { "os": "win32", "cpu": "x64" }, "sha512-UFJg/duEWzZlLkEs61Gz6/5nYhGaKI62I8dvUGdBR3NCtIMagehnFaFxmnXZldyHmCM8U0aCIFNpWRaKcrQkoA=="],
+
+    "@types/bun": ["@types/bun@1.3.8", "", { "dependencies": { "bun-types": "1.3.8" } }, "sha512-3LvWJ2q5GerAXYxO2mffLTqOzEu5qnhEAlh48Vnu8WQfnmSwbgagjGZV6BoHKJztENYEDn6QmVd949W4uESRJA=="],
+
+    "@types/node": ["@types/node@25.2.0", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-DZ8VwRFUNzuqJ5khrvwMXHmvPe+zGayJhr2CDNiKB1WBE1ST8Djl00D0IC4vvNmHMdj6DlbYRIaFE7WHjlDl5w=="],
+
+    "bun-types": ["bun-types@1.3.8", "", { "dependencies": { "@types/node": "*" } }, "sha512-fL99nxdOWvV4LqjmC+8Q9kW3M4QTtTR1eePs94v5ctGqU8OeceWrSUaRw3JYb7tU3FkMIAjkueehrHPPPGKi5Q=="],
+
+    "consola": ["consola@3.4.2", "", {}, "sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+  }
+}

package/example/01-authorize-bot/.env.example

@@ -0,0 +1,7 @@
+KICK_CLIENT_ID=[YOUR_CLIENT_ID_HERE]
+KICK_CLIENT_SECRET=[YOUR_CLIENT_SECRET_HERE]
+
+# These two lines below are the lines you need to fill in after getting tokens
+# After running the ./index.ts file
+KICK_ACCESS_TOKEN=
+KICK_REFRESH_TOKEN=

package/example/01-authorize-bot/index.ts

@@ -0,0 +1,60 @@
+/**
+ * Example 01: Authorizing a bot application
+ *
+ * This template demonstrates how to authorize a bot application using the ManaoKick library.
+ * The bot will send a message to the chat once authorized.
+ * In the first run, it will print the access and refresh tokens to the console for
+ * you to save in your environment variables file (.env).
+ *
+ * Before running this code, ensure you have the following environment variables set:
+ * - KICK_CLIENT_ID
+ * - KICK_CLIENT_SECRET
+ *
+ * Currently, the bot cannot receive messages from the chat.
+ *
+ * SCOPES: ["chat:write"]
+ * Make sure to refresh the tokens and update your environment variables when scopes change.
+ */
+
+import { KickClient } from "../../src/KickClient.ts";
+import type { KickTokenResponse } from "../../types";
+
+// Initialize the KickClient with necessary credentials and scopes
+const kick = new KickClient({
+  clientId: Bun.env.KICK_CLIENT_ID!,
+  clientSecret: Bun.env.KICK_CLIENT_SECRET!,
+  redirectUri: "http://localhost:3000/callback",
+  scopes: ["chat:write", "events:subscribe"],
+  showLog: false,
+  auth: {
+    initialTokens: Bun.env.KICK_REFRESH_TOKEN
+      ? {
+          access_token: Bun.env.KICK_ACCESS_TOKEN!,
+          refresh_token: Bun.env.KICK_REFRESH_TOKEN!,
+        }
+      : undefined,
+    onTokenUpdate: (tokens: KickTokenResponse) => {
+      if (!Bun.env.KICK_REFRESH_TOKEN) {
+        console.log("\n[!] Copy these into your .env file:\n");
+        console.log(`KICK_ACCESS_TOKEN=${tokens.access_token}`);
+        console.log(`KICK_REFRESH_TOKEN=${tokens.refresh_token}`);
+        console.log(`\n====> Scopes granted: ${tokens.scope}`);
+      }
+
+      Bun.env.KICK_ACCESS_TOKEN = tokens.access_token;
+      Bun.env.KICK_REFRESH_TOKEN = tokens.refresh_token;
+    },
+  },
+});
+// If no refresh token is found, initiate the authorization flow
+if (!Bun.env.KICK_REFRESH_TOKEN) {
+  console.log(`Authorize the application by visiting:\n${kick.getAuthURL()}`);
+  kick.auth.createCallbackServer({ port: 3000 });
+  await kick.auth.waitForAuthorization();
+}
+
+// Confirm successful authorization
+console.log("\n[✔] Application authorized successfully!");
+await kick.chat.send({
+  content: "Hello from ManaoKick library!",
+});

package/example/02-webhook/.env.example

@@ -0,0 +1,7 @@
+KICK_CLIENT_ID=[YOUR_CLIENT_ID_HERE]
+KICK_CLIENT_SECRET=[YOUR_CLIENT_SECRET_HERE]
+
+# These two lines below are the lines you need to fill in after getting tokens
+# After running the ./index.ts file
+KICK_ACCESS_TOKEN=
+KICK_REFRESH_TOKEN=

package/example/02-webhook/index.ts

@@ -0,0 +1,80 @@
+/**
+ * Example 02: Subscribing to webhooks
+ *
+ * This template demonstrates how to subscribe to webhooks using the ManaoKick library.
+ * The bot will respond to a specific chat message event once authorized. (!ping -> pong 🏓)
+ * In the first run, it will print the access and refresh tokens to the console for
+ * you to save in your environment variables file (.env).
+ *
+ * Before running this code, ensure you have the following environment variables set:
+ * - KICK_CLIENT_ID
+ * - KICK_CLIENT_SECRET
+ *
+ * Please note that Kick server cannot access localhost webhooks. To test webhooks,
+ * consider using a tunneling service like ngrok to expose your local server to the internet.
+ *
+ * Simple bot template with ngrok adapter can be found in the next example: example/03-ngrok
+ *
+ * SCOPES: ["chat:write", "events:subscribe"]
+ * Make sure to refresh the tokens and update your environment variables when scopes change.
+ */
+
+import { KickClient } from "../../src/KickClient.ts";
+import type { ChatMessageEvent, KickTokenResponse } from "../../types";
+
+// Initialize the KickClient with necessary credentials and scopes
+const kick = new KickClient({
+  clientId: Bun.env.KICK_CLIENT_ID!,
+  clientSecret: Bun.env.KICK_CLIENT_SECRET!,
+  redirectUri: "http://localhost:3000/callback",
+  scopes: ["chat:write", "events:subscribe"],
+  showLog: false,
+  auth: {
+    initialTokens: Bun.env.KICK_REFRESH_TOKEN
+      ? {
+          access_token: Bun.env.KICK_ACCESS_TOKEN!,
+          refresh_token: Bun.env.KICK_REFRESH_TOKEN!,
+        }
+      : undefined,
+    onTokenUpdate: (tokens: KickTokenResponse) => {
+      if (!Bun.env.KICK_REFRESH_TOKEN) {
+        console.log("\n[!] Copy these into your .env file:\n");
+        console.log(`KICK_ACCESS_TOKEN=${tokens.access_token}`);
+        console.log(`KICK_REFRESH_TOKEN=${tokens.refresh_token}`);
+        console.log(`\n====> Scopes granted: ${tokens.scope}`);
+      }
+
+      Bun.env.KICK_ACCESS_TOKEN = tokens.access_token;
+      Bun.env.KICK_REFRESH_TOKEN = tokens.refresh_token;
+    },
+  },
+});
+// If no refresh token is found, initiate the authorization flow
+if (!Bun.env.KICK_REFRESH_TOKEN) {
+  console.log(`Authorize the application by visiting:\n${kick.getAuthURL()}`);
+  kick.auth.createCallbackServer({ port: 3000 });
+  await kick.auth.waitForAuthorization();
+}
+
+// Confirm successful authorization
+console.log("\n[✔] Application authorized successfully!");
+await kick.chat.send({
+  content: "Hello from ManaoKick library!",
+});
+
+// Create a webhook server to listen for incoming events
+kick.webhooks.createServer({ port: 5000, path: "/kick/webhook" });
+
+// Subscribe to webhooks once authorized
+kick.auth.onAuthorized(async () => {
+  await kick.webhooks.subscribe({
+    events: [{ name: "chat.message.sent" }],
+  });
+});
+
+// Handle incoming chat message events
+kick.webhooks.on("chat.message.sent", async (event: ChatMessageEvent) => {
+  if (event.content === "!ping") {
+    await kick.chat.send({ content: "pong 🏓" });
+  }
+});

package/example/03-ngrok/.env.example

@@ -0,0 +1,7 @@
+KICK_CLIENT_ID=[YOUR_CLIENT_ID_HERE]
+KICK_CLIENT_SECRET=[YOUR_CLIENT_SECRET_HERE]
+
+# These two lines below are the lines you need to fill in after getting tokens
+# After running the ./index.ts file
+KICK_ACCESS_TOKEN=
+KICK_REFRESH_TOKEN=

package/example/03-ngrok/index.ts

@@ -0,0 +1,92 @@
+/**
+ * Example 03: Using ngrok adapter to expose local webhooks
+ *
+ * This template demonstrates how to use the ngrok adapter to expose local webhooks using the ManaoKick library.
+ * The bot will respond to a specific chat message event once authorized. (!ping -> pong 🏓)
+ * In the first run, it will print the access and refresh tokens to the console for
+ * you to save in your environment variables file (.env).
+ *
+ * Before running this code, ensure you have the following environment variables set:
+ * - KICK_CLIENT_ID
+ * - KICK_CLIENT_SECRET
+ *
+ * Additionally, set the NGROK_AUTHTOKEN environment variable with your ngrok authtoken.
+ * You can get an authtoken by signing up at https://ngrok.com/.
+ *
+ * Make sure to enable webhooks in Kick Developer Portal for your application, and ensure
+ * the webhook URL matches the one provided by ngrok.
+ *
+ * SCOPES: ["chat:write", "events:subscribe"]
+ * Make sure to refresh the tokens and update your environment variables when scopes change.
+ *
+ */
+
+import { KickClient } from "../../src/KickClient.ts";
+import type { ChatMessageEvent, KickTokenResponse } from "../../types";
+
+// Initialize the KickClient with necessary credentials and scopes
+const kick = new KickClient({
+  clientId: Bun.env.KICK_CLIENT_ID!,
+  clientSecret: Bun.env.KICK_CLIENT_SECRET!,
+  redirectUri: "http://localhost:3000/callback",
+  scopes: ["chat:write", "events:subscribe"],
+  showLog: false,
+  auth: {
+    initialTokens: Bun.env.KICK_REFRESH_TOKEN
+      ? {
+          access_token: Bun.env.KICK_ACCESS_TOKEN!,
+          refresh_token: Bun.env.KICK_REFRESH_TOKEN!,
+        }
+      : undefined,
+    onTokenUpdate: (tokens: KickTokenResponse) => {
+      if (!Bun.env.KICK_REFRESH_TOKEN) {
+        console.log("\n[!] Copy these into your .env file:\n");
+        console.log(`KICK_ACCESS_TOKEN=${tokens.access_token}`);
+        console.log(`KICK_REFRESH_TOKEN=${tokens.refresh_token}`);
+        console.log(`\n====> Scopes granted: ${tokens.scope}`);
+      }
+
+      Bun.env.KICK_ACCESS_TOKEN = tokens.access_token;
+      Bun.env.KICK_REFRESH_TOKEN = tokens.refresh_token;
+    },
+  },
+});
+// If no refresh token is found, initiate the authorization flow
+if (!Bun.env.KICK_REFRESH_TOKEN) {
+  console.log(`Authorize the application by visiting:\n${kick.getAuthURL()}`);
+  kick.auth.createCallbackServer({ port: 3000 });
+  await kick.auth.waitForAuthorization();
+}
+
+// Confirm successful authorization
+console.log("\n[✔] Application authorized successfully!");
+await kick.chat.send({
+  content: "Hello from ManaoKick library!",
+});
+
+// Handle incoming chat message events
+kick.webhooks.on("chat.message.sent", async (event: ChatMessageEvent) => {
+  if (event.content === "!ping") {
+    await kick.chat.send({ content: "pong 🏓" });
+  }
+});
+
+// Set up ngrok to expose the webhook endpoint
+const { url, close } = await kick.webhooks.ngrok({
+  port: 5000, // Use the same port as the webhook server
+  path: "/kick/webhook",
+  domain: "topical-goshawk-leading.ngrok-free.app", // <==== Replace with YOUR OWN ngrok domain!
+  authtoken: Bun.env.NGROK_AUTHTOKEN,
+});
+
+console.log(`[✔] ngrok tunnel established at: ${url}`);
+
+// Create a webhook server to listen for incoming events
+kick.webhooks.createServer({ port: 5000, path: "/kick/webhook" }); // Use port that ngrok will forward to
+
+// Subscribe to webhooks once authorized
+kick.auth.onAuthorized(async () => {
+  await kick.webhooks.subscribe({
+    events: [{ name: "chat.message.sent" }],
+  });
+});

package/example/04-categories-api/.env.example

@@ -0,0 +1,7 @@
+KICK_CLIENT_ID=[YOUR_CLIENT_ID_HERE]
+KICK_CLIENT_SECRET=[YOUR_CLIENT_SECRET_HERE]
+
+# These two lines below are the lines you need to fill in after getting tokens
+# After running the ./index.ts file
+KICK_ACCESS_TOKEN=
+KICK_REFRESH_TOKEN=

package/example/04-categories-api/index.ts

@@ -0,0 +1,77 @@
+/**
+ * Example 04: Using Categories API
+ *
+ * This template demonstrates how to use the Categories API with the ManaoKick library.
+ * The bot will send a message to the chat once authorized.
+ * In the first run, it will print the access and refresh tokens to the console for
+ * you to save in your environment variables file (.env).
+ *
+ * Before running this code, ensure you have the following environment variables set:
+ * - KICK_CLIENT_ID
+ * - KICK_CLIENT_SECRET
+ *
+ * SCOPES: []
+ * Make sure to refresh the tokens and update your environment variables when scopes change.
+ */
+
+import { KickClient } from "../../src/KickClient.ts";
+import type { KickTokenResponse } from "../../types";
+import { logger } from "../../src/Logger.ts";
+
+// Initialize the KickClient with necessary credentials and scopes
+const kick = new KickClient({
+  clientId: Bun.env.KICK_CLIENT_ID!,
+  clientSecret: Bun.env.KICK_CLIENT_SECRET!,
+  redirectUri: "http://localhost:3000/callback",
+  scopes: ["kicks:read"],
+  showLog: false,
+  auth: {
+    initialTokens: Bun.env.KICK_REFRESH_TOKEN
+      ? {
+          access_token: Bun.env.KICK_ACCESS_TOKEN!,
+          refresh_token: Bun.env.KICK_REFRESH_TOKEN!,
+        }
+      : undefined,
+    onTokenUpdate: (tokens: KickTokenResponse) => {
+      if (!Bun.env.KICK_REFRESH_TOKEN) {
+        console.log("\n[!] Copy these into your .env file:\n");
+        console.log(`KICK_ACCESS_TOKEN=${tokens.access_token}`);
+        console.log(`KICK_REFRESH_TOKEN=${tokens.refresh_token}`);
+        console.log(`\n====> Scopes granted: ${tokens.scope}`);
+      }
+
+      Bun.env.KICK_ACCESS_TOKEN = tokens.access_token;
+      Bun.env.KICK_REFRESH_TOKEN = tokens.refresh_token;
+    },
+  },
+});
+
+// If no refresh token is found, initiate the authorization flow
+if (!Bun.env.KICK_REFRESH_TOKEN) {
+  console.log(`Authorize the application by visiting:\n${kick.getAuthURL()}`);
+  kick.auth.createCallbackServer({ port: 3000 });
+  await kick.auth.waitForAuthorization();
+}
+
+// Confirm successful authorization
+console.log("\n[✔] Application authorized successfully!");
+
+const name = (
+  await logger.prompt("Search categories by name (seperated with commas): ", {
+    type: "text",
+  })
+).split(",");
+
+let limit = Number(
+  await logger.prompt("Limit (default 10): ", {
+    type: "text",
+  }),
+);
+
+if (isNaN(limit) || limit <= 0) {
+  limit = 10;
+}
+
+const categories = await kick.api.categories.get({ name, limit });
+console.log("\n[✔] Categories fetched successfully!");
+console.log(categories);

package/example/05-users-api/.env.example

@@ -0,0 +1,7 @@
+KICK_CLIENT_ID=[YOUR_CLIENT_ID_HERE]
+KICK_CLIENT_SECRET=[YOUR_CLIENT_SECRET_HERE]
+
+# These two lines below are the lines you need to fill in after getting tokens
+# After running the ./index.ts file
+KICK_ACCESS_TOKEN=
+KICK_REFRESH_TOKEN=