LuanRT · Illusion137 · Aug 15, 2026 · Aug 15, 2026 · Aug 15, 2026 · Aug 15, 2026
diff --git a/examples/posts/.gitignore b/examples/posts/.gitignore
@@ -0,0 +1 @@
+package-lock.json
diff --git a/examples/posts/package.json b/examples/posts/package.json
@@ -0,0 +1,18 @@
+{
+  "name": "posts",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {},
+  "devDependencies": {
+    "@types/jsdom": "^27.0.0",
+    "typescript": "^5.0.4"
+  },
+  "dependencies": {
+    "bgutils-js": "^4.0.3",
+    "cookie-eater": "^1.0.0",
+    "image-size": "^2.0.2",
+    "jsdom": "^28.1.0",
+    "youtubei.js": "file:../../"
+  }
+}
diff --git a/examples/posts/src/index.ts b/examples/posts/src/index.ts
@@ -0,0 +1,30 @@
+import { Innertube, UniversalCache } from 'youtubei.js';
+import { botguard_solver, get_channel_id, image_path_to_post_image, youtube_cookies } from './utils.ts';
+
+(async () => {
+  const COOKIES = await youtube_cookies();
+
+  const yt = await Innertube.create({ cache: new UniversalCache(false), cookie: COOKIES });
+  const CHANNEL_ID = await get_channel_id(yt);
+
+  const posts_manager = yt.posts(botguard_solver);
+  const create_post_result = await posts_manager.create({
+    comment_text: 'Test post 001',
+    // scheduled_publish_time_seconds: String(Math.floor(Date.now() / 1000) + (60 * 60)) // upload in a hour
+  }, CHANNEL_ID, 
+  {
+    type: "IMAGE_POLL",
+    options: [
+      {text: "Yes", image: {
+        source: await image_path_to_post_image(""), 
+        preview_coordinates: {left: 0, top: 0, right: 1, bottom: 1}
+      }},
+      {text: "No", image: {
+        source: await image_path_to_post_image(""), 
+        preview_coordinates: {left: 0, top: 0, right: 1, bottom: 1}
+      }}
+    ]
+  });
+
+  console.log(create_post_result);
+})();
diff --git a/examples/posts/src/utils.ts b/examples/posts/src/utils.ts
@@ -0,0 +1,67 @@
+import { readFile } from 'node:fs/promises';
+import { BotGuardClient } from "bgutils-js/botguard";
+import { USER_AGENT } from "bgutils-js/utils";
+import { imageSize } from 'image-size';
+import { JSDOM, VirtualConsole } from "jsdom";
+import Innertube, { type Types } from 'youtubei.js';
+import { get_cookies } from 'cookie-eater';
+
+export const botguard_solver: Types.BotGuardSolver<string> = {
+  solve: async(botguard_challenge, binding) => {
+    const virtual_console = new VirtualConsole();
+    const dom = new JSDOM('<!DOCTYPE html><html lang="en"><head><title></title></head><body></body></html>', { url: "https://www.youtube.com", referrer: "https://www.youtube.com/", userAgent: USER_AGENT, resources: "usable", runScripts: "dangerously", virtualConsole: virtual_console });
+
+    Object.assign(globalThis, { window: dom.window, document: dom.window.document, location: dom.window.location, origin: dom.window.origin });
+
+    if (!("navigator" in globalThis)) {
+      Object.defineProperty(globalThis, "navigator", { value: dom.window.navigator });
+    }
+
+    Object.defineProperty(dom.window.HTMLCanvasElement.prototype, "getContext", { value: () => null, writable: true });
+
+    let interpreter_url = botguard_challenge.interpreter_url.private_do_not_access_or_else_safe_script_wrapped_value ?? botguard_challenge.interpreter_url.private_do_not_access_or_else_trusted_resource_url_wrapped_value ?? "";
+
+    if (interpreter_url.startsWith("//")) interpreter_url = `https:${interpreter_url}`;
+
+    const bg_script_response = await fetch(interpreter_url);
+    const interpreter_javascript = await bg_script_response.text();
+
+    new Function(interpreter_javascript)();
+
+    const botguard = await BotGuardClient.create({ program: botguard_challenge.program, globalName: botguard_challenge.global_name, globalObject: globalThis });
+
+    const botguard_response = await botguard.snapshot({ contentBinding: { atr_challenge: binding } });
+    return botguard_response;
+  }
+};
+
+export async function get_channel_id(yt: Innertube, index?: number): Promise<string> {
+  const account_info = await yt.account.getInfo(true);
+  const account = account_info[index ?? 0];
+  if (account === undefined) throw new Error("No accounts found");
+  const resolve_url = `https://www.youtube.com/${account.channel_handle.text}`;
+  const resolved = await yt.resolveURL(resolve_url);
+  const channel_id = resolved.payload.browseId as string;
+  return channel_id;
+}
+
+export async function image_path_to_post_image(image_path: string): Promise<Types.PostImage> {
+  const body = await readFile(image_path);
+  const { width, height, type } = imageSize(body);
+  return {
+    body,
+    size: body.length,
+    width,
+    height,
+    base64: `data:image/${type ?? 'png'};base64,${body.toString('base64')}`
+  };
+}
+
+export async function youtube_cookies(): Promise<string|undefined> {
+  const HOST_NAME = '.youtube.com';
+  const cookies_map = await get_cookies([HOST_NAME]);
+  const cookies = cookies_map?.[HOST_NAME].toString() ?? undefined;
+
+  if(cookies) console.log(`Successfully found ${cookies_map?.[HOST_NAME].getCookies().length} cookies`);
+  return cookies;
+}
diff --git a/examples/posts/tsconfig.json b/examples/posts/tsconfig.json
@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "moduleResolution": "bundler",
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "noEmit": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "skipLibCheck": true,
+    "allowImportingTsExtensions": true
+  }
+}
diff --git a/protos/generated/misc/params.ts b/protos/generated/misc/params.ts