emusks 2.0.18 → 2.1.1

package/README.md

@@ -1,7 +1,7 @@
 <img src="https://emusks.tiago.zip/icon.svg" width="120">
 <h1>emusks: Reverse-engineered Twitter API client</h1>
 
-Log in and interact with the unofficial X API using any client identity — web, Android, iOS, or TweetDeck
+Log in and interact with the unofficial X API using any client identity - web, Android, iOS, or TweetDeck. Covers tweets, users, DMs, communities, spaces, and XChat (X's end-to-end encrypted chat): send encrypted DMs in one call.
 
 officially dmca'd by twitter™ 🏆  •  includes a few leaked ads bearers
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "emusks",
-  "version": "2.0.18",
-  "description": "Reverse-engineered Twitter API client. Log in and interact with the unofficial X API using any client identity — web, Android, iOS, or TweetDeck",
+  "version": "2.1.1",
+  "description": "Reverse-engineered Twitter API client. Log in and interact with the unofficial X API using any client identity - web, Android, iOS, or TweetDeck",
   "keywords": [
     "client",
     "reverse-engineering",
@@ -24,8 +24,25 @@
   "exports": {
     ".": "./src/index.js"
   },
+  "files": [
+    "src",
+    "README.md"
+  ],
   "dependencies": {
     "cycletls": "^2.0.5",
+    "linkedom": "^0.18.12",
+    "tweetnacl": "^1.0.3",
     "x-client-transaction-id": "^0.2.0"
+  },
+  "peerDependencies": {
+    "@roamhq/wrtc": "^0.10.0"
+  },
+  "peerDependenciesMeta": {
+    "@roamhq/wrtc": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@roamhq/wrtc": "^0.10.0"
   }
 }

package/src/cycletls.js

@@ -2,7 +2,8 @@ import initCycleTLS from "cycletls";
 
 let cycleTLS;
 
-initCycleTLS().then((c) => {
+const port = process.env.CYCLETLS_PORT ? Number(process.env.CYCLETLS_PORT) : undefined;
+initCycleTLS(port ? { port } : {}).then((c) => {
   cycleTLS = c;
 });
 

package/src/flow.js

@@ -1,5 +1,6 @@
 import getCycleTLS from "./cycletls.js";
 import clients from "./clients.js";
+import { solveJsInstrumentation } from "./instrumentation.js";
 
 const BASE_URL = "https://api.x.com/1.1/onboarding/task.json";
 const GUEST_ACTIVATE_URL = "https://api.x.com/1.1/guest/activate.json";
@@ -103,6 +104,33 @@ class CookieSession {
 
     return response;
   }
+
+  async get(url, options = {}) {
+    const headers = options.headers || {};
+    const cookieString = this.getCookieString();
+    if (cookieString) {
+      headers["Cookie"] = cookieString;
+    }
+
+    const response = await this.cycleTLS(
+      url,
+      {
+        ja3: clients.web.fingerprints.ja3,
+        ja4r: clients.web.fingerprints.ja4r,
+        userAgent: USER_AGENT,
+        headers,
+        proxy: this.proxy || undefined,
+      },
+      "get",
+    );
+
+    const setCookie = response.headers?.["Set-Cookie"] || response.headers?.["set-cookie"];
+    if (setCookie) {
+      this.parseCookies(setCookie);
+    }
+
+    return response;
+  }
 }
 
 function getFlowHeaders(guestToken) {
@@ -200,12 +228,39 @@ async function initFlow(session, guestToken) {
   return [flowToken, headers, data];
 }
 
-async function submitJsInstrumentation(session, flowToken, headers) {
+const DEFAULT_JS_INST_URL = "https://twitter.com/i/js_inst?c_name=ui_metrics";
+
+async function fetchChallengeJs(session, url) {
+  const response = await session.get(url, {
+    Accept: "*/*",
+    "Accept-Language": "en-US,en;q=0.9",
+    Referer: "https://x.com/",
+    "User-Agent": USER_AGENT,
+  });
+
+  if (response.status !== 200) {
+    throw new Error(`Failed to fetch js_instrumentation challenge: ${response.status}`);
+  }
+
+  let body = response.body ?? response.data;
+  if (body && typeof body === "object") {
+    body = Buffer.from(body.data ?? body).toString("utf8");
+  }
+  if (typeof body !== "string" || body.length === 0) {
+    throw new Error("js_instrumentation challenge returned an empty body");
+  }
+  return body;
+}
+
+async function submitJsInstrumentation(session, flowToken, headers, subtask) {
+  const url = subtask?.js_instrumentation?.url || DEFAULT_JS_INST_URL;
+  const challengeJs = await fetchChallengeJs(session, url);
+  const response = solveJsInstrumentation(challengeJs);
+
   return await makeRequest(session, headers, flowToken, {
     subtask_id: "LoginJsInstrumentationSubtask",
     js_instrumentation: {
-      response:
-        '{"rf":{"a4fc506d24bb4843c48a1966940c2796bf4fb7617a2d515ad3297b7df6b459b6":121,"bff66e16f1d7ea28c04653dc32479cf416a9c8b67c80cb8ad533b2a44fee82a3":-1,"ac4008077a7e6ca03210159dbe2134dea72a616f03832178314bb9931645e4f7":-22,"c3a8a81a9b2706c6fec42c771da65a9597c537b8e4d9b39e8e58de9fe31ff239":-12},"s":"ZHYaDA9iXRxOl2J3AZ9cc23iJx-Fg5E82KIBA_fgeZFugZGYzRtf8Bl3EUeeYgsK30gLFD2jTQx9fAMsnYCw0j8ahEy4Pb5siM5zD6n7YgOeWmFFaXoTwaGY4H0o-jQnZi5yWZRAnFi4lVuCVouNz_xd2BO2sobCO7QuyOsOxQn2CWx7bjD8vPAzT5BS1mICqUWyjZDjLnRZJU6cSQG5YFIHEPBa8Kj-v1JFgkdAfAMIdVvP7C80HWoOqYivQR7IBuOAI4xCeLQEdxlGeT-JYStlP9dcU5St7jI6ExyMeQnRicOcxXLXsan8i5Joautk2M8dAJFByzBaG4wtrPhQ3QAAAZEi-_t7"}',
+      response,
       link: "next_link",
     },
   });
@@ -306,7 +361,8 @@ async function resolve(staticValue, onRequest, type) {
 }
 
 export default async function flowLogin(opts) {
-  const { username, password, email, phone, onRequest, proxy } = opts;
+  const { username, password, email, phone, onRequest, proxy, debug } = opts;
+  const log = debug ? (...a) => console.error("[flow]", ...a) : () => {};
 
   if (!username) throw new Error("username is required for flow login");
   if (!password) throw new Error("password is required for flow login");
@@ -315,6 +371,7 @@ export default async function flowLogin(opts) {
   const session = new CookieSession(cycleTLS, proxy);
 
   const guestToken = await getGuestToken(session);
+  log("guest token", guestToken);
 
   let [flowToken, headers, data] = await initFlow(session, guestToken);
   headers["X-Guest-Token"] = guestToken;
@@ -324,16 +381,23 @@ export default async function flowLogin(opts) {
   while (!isLoginComplete(data) && step < MAX_FLOW_STEPS) {
     step++;
     const subtaskIds = getSubtaskIds(data);
+    log(`step ${step}: subtasks [${subtaskIds.join(", ")}]`);
 
     if (subtaskIds.length === 0) {
       throw new Error("Login flow returned no subtasks and login is not complete");
     }
 
     const current = subtaskIds[0];
+    const currentSubtask = data.subtasks.find((s) => s.subtask_id === current);
 
     switch (current) {
       case "LoginJsInstrumentationSubtask":
-        [flowToken, data] = await submitJsInstrumentation(session, flowToken, headers);
+        [flowToken, data] = await submitJsInstrumentation(
+          session,
+          flowToken,
+          headers,
+          currentSubtask,
+        );
         break;
 
       case "LoginEnterUserIdentifierSSO":

package/src/graphql.js

@@ -141,7 +141,11 @@ export default async function graphql(queryName, { variables, fieldToggles, body
   ).json();
 
   if (res?.errors?.[0]) {
-    throw new Error(res.errors.map((err) => err.message).join(", "));
+    const hasData =
+      res.data != null && typeof res.data === "object" && Object.keys(res.data).length > 0;
+    if (!hasData) {
+      throw new Error(res.errors.map((err) => err.message).join(", "));
+    }
   }
 
   return res;

package/src/helpers/index.js

@@ -2,6 +2,7 @@ import * as account from "./account.js";
 import * as bookmarks from "./bookmarks.js";
 import * as communities from "./communities.js";
 import * as dms from "./dms.js";
+import * as jetfuel from "./jetfuel.js";
 import * as lists from "./lists.js";
 import * as media from "./media.js";
 import * as notifications from "./notifications.js";
@@ -13,6 +14,7 @@ import * as topics from "./topics.js";
 import * as trends from "./trends.js";
 import * as tweets from "./tweets.js";
 import * as users from "./users.js";
+import * as xchat from "./xchat.js";
 
 function namespace(proto, name, methods) {
   Object.defineProperty(proto, name, {
@@ -48,4 +50,6 @@ export default function initHelpers(proto) {
   namespace(proto, "topics", topics);
   namespace(proto, "media", media);
   namespace(proto, "syndication", syndication);
+  namespace(proto, "xchat", xchat);
+  namespace(proto, "jetfuel", jetfuel);
 }

package/src/helpers/jetfuel.js

@@ -0,0 +1,175 @@
+import {
+  buildTimelineToken,
+  decodeJetfuel,
+  decodeTimelineToken,
+  extractTimelineTokens,
+} from "../parsers/jetfuel.js";
+import parseTimeline from "../parsers/timeline.js";
+
+export const ENGAGEMENTS = ["Likes", "Replies", "Bookmarks", "Quotes", "VideoQualityViews"];
+
+export const PERIODS = ["Daily", "Weekly", "Monthly"];
+
+export const COUNTRIES = [
+  "All", "USA", "CAN", "GBR", "AUS", "DEU", "FRA", "JPN", "BRA", "IND", "MEX",
+  "ESP", "ITA", "KOR", "NLD", "ARG", "POL", "TUR", "IDN", "SAU", "ZAF", "NGA",
+  "PHL", "THA", "VNM", "EGY", "PAK", "MYS", "SGP", "ARE", "COL", "CHL", "SWE",
+  "NOR", "DNK", "FIN", "BEL", "AUT", "CHE", "PRT", "GRC", "IRL", "NZL", "ISR",
+  "RUS", "UKR", "CZE", "ROU", "HUN",
+];
+
+function assertEnum(value, allowed, label) {
+  if (!allowed.includes(value)) {
+    throw new Error(`invalid ${label} "${value}", expected one of: ${allowed.join(", ")}`);
+  }
+}
+
+export async function page(route, opts = {}) {
+  const res = await this.jf(route, opts);
+  return { ...decodeJetfuel(res.buffer), status: res.status, contentType: res.contentType };
+}
+
+export async function remote(route, opts = {}) {
+  return await page.call(this, route, opts);
+}
+
+export async function raw(route, opts = {}) {
+  return await this.jf(route, opts);
+}
+
+export function decode(buffer) {
+  return decodeJetfuel(buffer);
+}
+
+export function topPostsTimelineId({ engagement = "Likes", period = "Daily", country = "All" } = {}) {
+  assertEnum(engagement, ENGAGEMENTS, "engagement");
+  assertEnum(period, PERIODS, "period");
+  return buildTimelineToken({ engagement, country, period });
+}
+
+export async function topPostsFeed({ engagement = "Likes", period = "Daily", country = "All" } = {}) {
+  assertEnum(engagement, ENGAGEMENTS, "engagement");
+  assertEnum(period, PERIODS, "period");
+
+  const params = { engagement, period };
+  if (country && country !== "All") params.country = country;
+
+  const res = await this.jf("creators/inspiration/remote/urt", { params });
+  const tokens = extractTimelineTokens(res.buffer);
+  const token = tokens[0] || null;
+
+  return {
+    status: res.status,
+    token,
+    params: token ? decodeTimelineToken(token) : null,
+    decoded: decodeJetfuel(res.buffer),
+  };
+}
+
+export async function topPosts(opts = {}) {
+  const { engagement = "Likes", period = "Daily", country = "All", count = 20, cursor, viaRemote, raw: returnRaw } = opts;
+  assertEnum(engagement, ENGAGEMENTS, "engagement");
+  assertEnum(period, PERIODS, "period");
+
+  let timelineId;
+  if (viaRemote) {
+    const feed = await topPostsFeed.call(this, { engagement, period, country });
+    if (!feed.token) throw new Error("inspiration feed returned no timeline token");
+    timelineId = feed.token;
+  } else {
+    timelineId = buildTimelineToken({ engagement, country, period });
+  }
+
+  const variables = {
+    timelineId,
+    count,
+    withQuickPromoteEligibilityTweetFields: true,
+  };
+  if (cursor) variables.cursor = cursor;
+
+  const res = await this.graphql("GenericTimelineById", { variables });
+  if (returnRaw) return res;
+
+  const parsed = parseTimeline(res);
+  return { ...parsed, engagement, period, country, timelineId };
+}
+
+export async function inspirationPage(opts = {}) {
+  return await page.call(this, "creators/inspiration/top_posts", opts);
+}
+
+export async function stories(opts = {}) {
+  return await page.call(this, "stories/home", opts);
+}
+
+export async function storiesRemote({ category } = {}, opts = {}) {
+  const params = { ...opts.params };
+  if (category) params.category = category;
+  return await remote.call(this, "stories/storiesRemote", { ...opts, params });
+}
+
+export async function newsArticle(id, opts = {}) {
+  if (!id) throw new Error("newsArticle requires an article id");
+  return await page.call(this, `news/article/id/${id}`, opts);
+}
+
+export const SPORT_EVENTS = {
+  nba: { noun: "game", home: true },
+  nfl: { noun: "game", home: true },
+  f1: { noun: "race", home: true },
+  nhl: { noun: "game", home: false },
+  soccer: { noun: "match", home: false },
+};
+
+export async function sportHome(sport, opts = {}) {
+  if (!sport) throw new Error("sportHome requires a sport");
+  return await page.call(this, `${sport}/home`, opts);
+}
+
+export async function league(sport, opts = {}) {
+  if (!sport) throw new Error("league requires a sport");
+  return await page.call(this, `${sport}/league/home`, opts);
+}
+
+export async function game({ sport, id, noun, home } = {}, opts = {}) {
+  if (!sport || !id) throw new Error("game requires { sport, id }");
+  const shape = SPORT_EVENTS[sport] || {};
+  const eventNoun = noun ?? shape.noun ?? "game";
+  const hasHome = home ?? shape.home ?? false;
+  const route = `${sport}/${eventNoun}${hasHome ? "/home" : ""}/id/${id}`;
+  return await page.call(this, route, opts);
+}
+
+export async function event(id, opts = {}) {
+  if (!id) throw new Error("event requires an id");
+  return await page.call(this, "events/event", { ...opts, params: { id, ...opts.params } });
+}
+
+export async function brackets(opts = {}) {
+  return await page.call(this, "brackets/home", opts);
+}
+
+export async function bracketView(userId, opts = {}) {
+  return await page.call(this, userId ? `brackets/view/id/${userId}` : "brackets/view", opts);
+}
+
+export async function creatorsStudio(opts = {}) {
+  return await page.call(this, "creators/studio", opts);
+}
+
+export async function onboardingTopics(opts = {}) {
+  return await remote.call(this, "onboarding/remotes/topics", opts);
+}
+
+export async function health(opts = {}) {
+  const res = await this.jf("health", { ...opts, origin: "jf" });
+  return res.text();
+}
+
+export function ogImageUrl(tweetId) {
+  return `https://jf.x.com/images/post/${tweetId}`;
+}
+
+export function mediaPreviewUrl(tweetId) {
+  return `https://jf.x.com/images/media-preview/${tweetId}`;
+}

package/src/helpers/juicebox/chunk-BNv3lrIs.js

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,t)=>()=>(e&&(t=e(e=0)),t),s=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),c=(e,n)=>{let r={};for(var i in e)t(r,i,{get:e[i],enumerable:!0});return n||t(r,Symbol.toStringTag,{value:`Module`}),r},l=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},u=(n,r,a)=>(a=n==null?{}:e(i(n)),l(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n)),d=e=>a.call(e,`module.exports`)?e[`module.exports`]:l(t({},`__esModule`,{value:!0}),e);export{u as a,d as i,o as n,c as r,s as t};

package/src/helpers/juicebox/index.js

@@ -0,0 +1,30 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const dir = dirname(fileURLToPath(import.meta.url));
+const wasmPath = join(dir, "juicebox-sdk_bg.wasm");
+
+let authTokenResolver = () => {
+  throw new Error("juicebox: auth-token resolver not set");
+};
+export function setAuthTokenResolver(fn) {
+  authTokenResolver = fn;
+}
+
+globalThis.JuiceboxGetAuthToken = (realmId) => Promise.resolve(authTokenResolver(realmId));
+
+const origFetch = globalThis.fetch.bind(globalThis);
+globalThis.fetch = (input, init) => {
+  const url = typeof input === "string" ? input : (input?.url ?? String(input));
+  if (url.includes("juicebox-sdk_bg") && url.endsWith(".wasm")) {
+    return Promise.resolve(
+      new Response(readFileSync(wasmPath), { headers: { "Content-Type": "application/wasm" } }),
+    );
+  }
+  return origFetch(input, init);
+};
+
+const glue = await import("./sdk.js");
+
+export const { Client, Configuration, RecoverError, RecoverErrorReason } = glue;

package/src/helpers/juicebox/sdk.js

@@ -0,0 +1 @@
+import{n as e,r as t}from"./chunk-BNv3lrIs.js";var n,r=e((()=>{n=`/assets/juicebox-sdk_bg-B54z_Bsk.wasm`})),i,a=e((()=>{i=async(e={},t)=>{let n;if(t.startsWith(`data:`)){let r=t.replace(/^data:.*?base64,/,``),i;if(typeof Buffer==`function`&&typeof Buffer.from==`function`)i=Buffer.from(r,`base64`);else if(typeof atob==`function`){let e=atob(r);i=new Uint8Array(e.length);for(let t=0;t<e.length;t++)i[t]=e.charCodeAt(t)}else throw Error(`Cannot decode base64-encoded data URL`);n=await WebAssembly.instantiate(i,e)}else{let r=await fetch(t),i=r.headers.get(`Content-Type`)||``;if(`instantiateStreaming`in WebAssembly&&i.startsWith(`application/wasm`))n=await WebAssembly.instantiateStreaming(r,e);else{let t=await r.arrayBuffer();n=await WebAssembly.instantiate(t,e)}}return n.instance.exports}}));function o(e){V=e}function s(e){return H[e]}function c(e){e<132||(H[e]=U,U=e)}function l(e){let t=s(e);return c(e),t}function u(){return(G===null||G.byteLength===0)&&(G=new Uint8Array(V.memory.buffer)),G}function d(e,t,n){if(n===void 0){let n=K.encode(e),r=t(n.length,1)>>>0;return u().subarray(r,r+n.length).set(n),W=n.length,r}let r=e.length,i=t(r,1)>>>0,a=u(),o=0;for(;o<r;o++){let t=e.charCodeAt(o);if(t>127)break;a[i+o]=t}if(o!==r){o!==0&&(e=e.slice(o)),i=n(i,r,r=o+e.length*3,1)>>>0;let t=u().subarray(i+o,i+r),a=mt(e,t);o+=a.written}return W=o,i}function f(e){return e==null}function p(){return(q===null||q.byteLength===0)&&(q=new Int32Array(V.memory.buffer)),q}function m(e,t){return e>>>=0,J.decode(u().subarray(e,e+t))}function h(e){U===H.length&&H.push(H.length+1);let t=U;return U=H[t],H[t]=e,t}function ee(){return(Y===null||Y.byteLength===0)&&(Y=new Float64Array(V.memory.buffer)),Y}function g(e){let t=typeof e;if(t==`number`||t==`boolean`||e==null)return`${e}`;if(t==`string`)return`"${e}"`;if(t==`symbol`){let t=e.description;return t==null?`Symbol`:`Symbol(${t})`}if(t==`function`){let t=e.name;return typeof t==`string`&&t.length>0?`Function(${t})`:`Function`}if(Array.isArray(e)){let t=e.length,n=`[`;t>0&&(n+=g(e[0]));for(let r=1;r<t;r++)n+=`, `+g(e[r]);return n+=`]`,n}let n=/\[object ([^\]]+)\]/.exec(toString.call(e)),r;if(n.length>1)r=n[1];else return toString.call(e);if(r==`Object`)try{return`Object(`+JSON.stringify(e)+`)`}catch{return`Object`}return e instanceof Error?`${e.name}: ${e.message}\n${e.stack}`:r}function te(e,t,n,r){let i={a:e,b:t,cnt:1,dtor:n},a=(...e)=>{i.cnt++;let t=i.a;i.a=0;try{return r(t,i.b,...e)}finally{--i.cnt===0?V.__wbindgen_export_2.get(i.dtor)(t,i.b):i.a=t}};return a.original=i,a}function ne(e,t){V.wasm_bindgen__convert__closures__invoke0_mut__hcf60f8fe499c96ac(e,t)}function re(e,t,n){V._dyn_core__ops__function__FnMut__A____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__h664375554e075ae3(e,t,h(n))}function ie(e,t){if(!(e instanceof t))throw Error(`expected instance of ${t.name}`);return e.ptr}function _(e,t){let n=t(e.length*1,1)>>>0;return u().set(e,n/1),W=e.length,n}function v(e,t){try{return e.apply(this,t)}catch(e){V.__wbindgen_exn_store(h(e))}}function ae(e,t,n,r){V.wasm_bindgen__convert__closures__invoke2_mut__h35a3737c9c8313d7(e,t,h(n),h(r))}function oe(e){l(e)}function se(e){return h(Z.__wrap(e))}function ce(e){let t=l(e).original;return t.cnt--==1?(t.a=0,!0):!1}function le(e,t){let n=s(t),r=typeof n==`string`?n:void 0;var i=f(r)?0:d(r,V.__wbindgen_malloc,V.__wbindgen_realloc),a=W;p()[e/4+1]=a,p()[e/4+0]=i}function ue(e){return typeof s(e)==`string`}function de(e){let t=s(e);return typeof t==`object`&&!!t}function fe(e){return s(e)===void 0}function pe(e,t){return s(e)in s(t)}function y(e,t){return h(Error(m(e,t)))}function b(e){return h(fetch(s(e)))}function x(){return v(function(e,t){return h(setTimeout(s(e),t))},arguments)}function S(){return v(function(e){return h(JuiceboxGetAuthToken(l(e)))},arguments)}function C(){return h(Error())}function w(e,t){let n=s(t).stack,r=d(n,V.__wbindgen_malloc,V.__wbindgen_realloc),i=W;p()[e/4+1]=i,p()[e/4+0]=r}function T(e,t){let n,r;try{n=e,r=t,console.error(m(e,t))}finally{V.__wbindgen_free(n,r,1)}}function E(e){queueMicrotask(s(e))}function D(e){let t=s(e).queueMicrotask;return h(t)}function O(e){return typeof s(e)==`function`}function k(e){return h(s(e))}function A(e,t){return s(e)==s(t)}function j(e){let t=s(e);return typeof t==`boolean`?+!!t:2}function M(e,t){let n=s(t),r=typeof n==`number`?n:void 0;ee()[e/8+1]=f(r)?0:r,p()[e/4+0]=!f(r)}function N(e){return+s(e)}function P(e){return h(e)}function F(e,t){return h(m(e,t))}function I(e,t){let n=s(e)[s(t)];return h(n)}function L(){return Date.now()}function R(e){return s(e).now()}function z(e){let t=s(e).headers;return h(t)}function B(){return v(function(e,t,n){return h(new Request(m(e,t),s(n)))},arguments)}function me(){return v(function(e,t,n,r,i){s(e).set(m(t,n),m(r,i))},arguments)}function he(e){return h(s(e).arrayBuffer())}function ge(e){let t;try{t=s(e)instanceof Response}catch{t=!1}return t}function _e(e){return s(e).status}function ve(e){let t=s(e).headers;return h(t)}function ye(){return v(function(e){return h(s(e).blob())},arguments)}function be(e){let t=s(e).crypto;return h(t)}function xe(e){let t=s(e).process;return h(t)}function Se(e){let t=s(e).versions;return h(t)}function Ce(e){let t=s(e).node;return h(t)}function we(e){let t=s(e).msCrypto;return h(t)}function Te(){return v(function(){let e=module.require;return h(e)},arguments)}function Ee(){return v(function(e,t){s(e).randomFillSync(l(t))},arguments)}function De(){return v(function(e,t){s(e).getRandomValues(s(t))},arguments)}function Oe(e,t){let n=s(e)[t>>>0];return h(n)}function ke(e){return s(e).length}function Ae(e,t){return h(Function(m(e,t)))}function je(e){let t=s(e).next;return h(t)}function Me(){return v(function(e){return h(s(e).next())},arguments)}function Ne(e){return s(e).done}function Pe(e){let t=s(e).value;return h(t)}function Fe(){let e=Symbol.iterator;return h(e)}function Ie(){return v(function(e,t){return h(Reflect.get(s(e),s(t)))},arguments)}function Le(){return v(function(e,t){return h(s(e).call(s(t)))},arguments)}function Re(){return h({})}function ze(){return v(function(){let e=self.self;return h(e)},arguments)}function Be(){return v(function(){let e=window.window;return h(e)},arguments)}function Ve(){return v(function(){let e=globalThis.globalThis;return h(e)},arguments)}function He(){return v(function(){let e=global.global;return h(e)},arguments)}function Ue(e){return h(Array.from(s(e)))}function We(e){return Array.isArray(s(e))}function Ge(e){let t;try{t=s(e)instanceof ArrayBuffer}catch{t=!1}return t}function Ke(){return v(function(e,t,n){return h(s(e).call(s(t),s(n)))},arguments)}function qe(e){return Number.isSafeInteger(s(e))}function Je(e){return h(Object.entries(s(e)))}function Ye(e,t){try{var n={a:e,b:t};return h(new Promise((e,t)=>{let r=n.a;n.a=0;try{return ae(r,n.b,e,t)}finally{n.a=r}}))}finally{n.a=n.b=0}}function Xe(e){return h(Promise.resolve(s(e)))}function Ze(e,t){return h(s(e).then(s(t)))}function Qe(e,t,n){return h(s(e).then(s(t),s(n)))}function $e(e){let t=s(e).buffer;return h(t)}function et(e,t,n){return h(new Uint8Array(s(e),t>>>0,n>>>0))}function tt(e){return h(new Uint8Array(s(e)))}function nt(e,t,n){s(e).set(s(t),n>>>0)}function rt(e){return s(e).length}function it(e){let t;try{t=s(e)instanceof Uint8Array}catch{t=!1}return t}function at(e){return h(new Uint8Array(e>>>0))}function ot(e,t,n){return h(s(e).subarray(t>>>0,n>>>0))}function st(){return v(function(e){return h(JSON.stringify(s(e)))},arguments)}function ct(){return v(function(e,t,n){return Reflect.set(s(e),s(t),s(n))},arguments)}function lt(e,t){let n=d(g(s(t)),V.__wbindgen_malloc,V.__wbindgen_realloc),r=W;p()[e/4+1]=r,p()[e/4+0]=n}function ut(e,t){throw Error(m(e,t))}function dt(){let e=V.memory;return h(e)}function ft(e,t,n){return h(te(e,t,123,ne))}function pt(e,t,n){return h(te(e,t,217,re))}var V,H,U,W,G,K,mt,q,J,Y,ht,gt,_t,vt,yt,X,Z,Q=e((()=>{H=Array(128).fill(void 0),H.push(void 0,null,!0,!1),U=H.length,W=0,G=null,K=new(typeof TextEncoder>`u`?(0,module.require)(`util`).TextEncoder:TextEncoder)(`utf-8`),mt=typeof K.encodeInto==`function`?function(e,t){return K.encodeInto(e,t)}:function(e,t){let n=K.encode(e);return t.set(n),{read:e.length,written:n.length}},q=null,J=new(typeof TextDecoder>`u`?(0,module.require)(`util`).TextDecoder:TextDecoder)(`utf-8`,{ignoreBOM:!0,fatal:!0}),J.decode(),Y=null,ht=Object.freeze({InvalidAuth:0,0:`InvalidAuth`,UpgradeRequired:1,1:`UpgradeRequired`,RateLimitExceeded:2,2:`RateLimitExceeded`,Assertion:3,3:`Assertion`,Transient:4,4:`Transient`}),gt=Object.freeze({InvalidAuth:0,0:`InvalidAuth`,UpgradeRequired:1,1:`UpgradeRequired`,RateLimitExceeded:2,2:`RateLimitExceeded`,Assertion:3,3:`Assertion`,Transient:4,4:`Transient`}),_t=Object.freeze({InvalidPin:0,0:`InvalidPin`,NotRegistered:1,1:`NotRegistered`,InvalidAuth:2,2:`InvalidAuth`,UpgradeRequired:3,3:`UpgradeRequired`,RateLimitExceeded:4,4:`RateLimitExceeded`,Assertion:5,5:`Assertion`,Transient:6,6:`Transient`}),vt=class{__destroy_into_raw(){let e=this.__wbg_ptr;return this.__wbg_ptr=0,e}free(){let e=this.__destroy_into_raw();V.__wbg_authtokengenerator_free(e)}constructor(e){let t=V.authtokengenerator_new(h(e));return this.__wbg_ptr=t>>>0,this}vend(e,t){let n,r;try{let o=V.__wbindgen_add_to_stack_pointer(-16),s=d(e,V.__wbindgen_malloc,V.__wbindgen_realloc),c=W,l=d(t,V.__wbindgen_malloc,V.__wbindgen_realloc),u=W;V.authtokengenerator_vend(o,this.__wbg_ptr,s,c,l,u);var i=p()[o/4+0],a=p()[o/4+1];return n=i,r=a,m(i,a)}finally{V.__wbindgen_add_to_stack_pointer(16),V.__wbindgen_free(n,r,1)}}static random_secret_id(){let e,t;try{let i=V.__wbindgen_add_to_stack_pointer(-16);V.authtokengenerator_random_secret_id(i);var n=p()[i/4+0],r=p()[i/4+1];return e=n,t=r,m(n,r)}finally{V.__wbindgen_add_to_stack_pointer(16),V.__wbindgen_free(e,t,1)}}},yt=class{__destroy_into_raw(){let e=this.__wbg_ptr;return this.__wbg_ptr=0,e}free(){let e=this.__destroy_into_raw();V.__wbg_client_free(e)}constructor(e,t){ie(e,X);var n=e.__destroy_into_raw();let r=V.client_new(n,h(t));return this.__wbg_ptr=r>>>0,this}register(e,t,n,r){let i=_(e,V.__wbindgen_malloc),a=W,o=_(t,V.__wbindgen_malloc),s=W,c=_(n,V.__wbindgen_malloc),u=W;return l(V.client_register(this.__wbg_ptr,i,a,o,s,c,u,r))}recover(e,t){let n=_(e,V.__wbindgen_malloc),r=W,i=_(t,V.__wbindgen_malloc),a=W;return l(V.client_recover(this.__wbg_ptr,n,r,i,a))}delete(){return l(V.client_delete(this.__wbg_ptr))}},X=class{__destroy_into_raw(){let e=this.__wbg_ptr;return this.__wbg_ptr=0,e}free(){let e=this.__destroy_into_raw();V.__wbg_configuration_free(e)}constructor(e){let t=V.configuration_new(h(e));return this.__wbg_ptr=t>>>0,this}},Z=class e{static __wrap(t){t>>>=0;let n=Object.create(e.prototype);return n.__wbg_ptr=t,n}__destroy_into_raw(){let e=this.__wbg_ptr;return this.__wbg_ptr=0,e}free(){let e=this.__destroy_into_raw();V.__wbg_recovererror_free(e)}get reason(){return V.__wbg_get_recovererror_reason(this.__wbg_ptr)}set reason(e){V.__wbg_set_recovererror_reason(this.__wbg_ptr,e)}get guesses_remaining(){let e=V.__wbg_get_recovererror_guesses_remaining(this.__wbg_ptr);return e===16777215?void 0:e}set guesses_remaining(e){V.__wbg_set_recovererror_guesses_remaining(this.__wbg_ptr,f(e)?16777215:e)}}})),bt=t({__wbg_authtokengenerator_free:()=>Pt,__wbg_client_free:()=>At,__wbg_configuration_free:()=>Ct,__wbg_get_recovererror_guesses_remaining:()=>Dt,__wbg_get_recovererror_reason:()=>Tt,__wbg_recovererror_free:()=>wt,__wbg_set_recovererror_guesses_remaining:()=>Ot,__wbg_set_recovererror_reason:()=>Et,__wbindgen_add_to_stack_pointer:()=>Wt,__wbindgen_exn_store:()=>Ut,__wbindgen_export_2:()=>Bt,__wbindgen_free:()=>Gt,__wbindgen_malloc:()=>Rt,__wbindgen_realloc:()=>zt,_dyn_core__ops__function__FnMut__A____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__h664375554e075ae3:()=>Ht,authtokengenerator_new:()=>Ft,authtokengenerator_random_secret_id:()=>Lt,authtokengenerator_vend:()=>It,client_delete:()=>$,client_new:()=>jt,client_recover:()=>Nt,client_register:()=>Mt,configuration_new:()=>kt,memory:()=>St,wasm_bindgen__convert__closures__invoke0_mut__hcf60f8fe499c96ac:()=>Vt,wasm_bindgen__convert__closures__invoke2_mut__h35a3737c9c8313d7:()=>Kt}),xt,St,Ct,wt,Tt,Et,Dt,Ot,kt,At,jt,Mt,Nt,$,Pt,Ft,It,Lt,Rt,zt,Bt,Vt,Ht,Ut,Wt,Gt,Kt,qt=e((async()=>{r(),a(),Q(),URL=globalThis.URL,xt=await i({"./juicebox-sdk_bg.js":{__wbindgen_object_drop_ref:oe,__wbg_recovererror_new:se,__wbindgen_cb_drop:ce,__wbindgen_string_get:le,__wbindgen_is_string:ue,__wbindgen_is_object:de,__wbindgen_is_undefined:fe,__wbindgen_in:pe,__wbindgen_error_new:y,__wbg_fetch_d70cd3e887817ac6:b,__wbg_setTimeout_deb7786d942a7ab5:x,__wbg_JuiceboxGetAuthToken_c2d75c5bf1346f44:S,__wbg_new_abda76e883ba8a5f:C,__wbg_stack_658279fe44541cf6:w,__wbg_error_f851667af71bcfc6:T,__wbg_queueMicrotask_4d890031a6a5a50c:E,__wbg_queueMicrotask_adae4bc085237231:D,__wbindgen_is_function:O,__wbindgen_object_clone_ref:k,__wbindgen_jsval_loose_eq:A,__wbindgen_boolean_get:j,__wbindgen_number_get:M,__wbindgen_as_number:N,__wbindgen_number_new:P,__wbindgen_string_new:F,__wbg_getwithrefkey_4a92a5eca60879b9:I,__wbg_now_0343d9c3e0e8eedc:L,__wbg_now_b724952e890dc703:R,__wbg_headers_d135d2bb8cc60413:z,__wbg_newwithstrandinit_f581dff0d19a8b03:B,__wbg_set_27f236f6d7a28c29:me,__wbg_arrayBuffer_a9d862b05aaee2f9:he,__wbg_instanceof_Response_4c3b1446206114d1:ge,__wbg_status_d6d47ad2837621eb:_e,__wbg_headers_24def508a7518df9:ve,__wbg_blob_c6537f3e31e66dad:ye,__wbg_crypto_58f13aa23ffcb166:be,__wbg_process_5b786e71d465a513:xe,__wbg_versions_c2ab80650590b6a2:Se,__wbg_node_523d7bd03ef69fba:Ce,__wbg_msCrypto_abcb1295e768d1f2:we,__wbg_require_2784e593a4674877:Te,__wbg_randomFillSync_a0d98aa11c81fe89:Ee,__wbg_getRandomValues_504510b5564925af:De,__wbg_get_f01601b5a68d10e3:Oe,__wbg_length_1009b1af0c481d7b:ke,__wbg_newnoargs_c62ea9419c21fbac:Ae,__wbg_next_9b877f231f476d01:je,__wbg_next_6529ee0cca8d57ed:Me,__wbg_done_5fe336b092d60cf2:Ne,__wbg_value_0c248a78fdc8e19f:Pe,__wbg_iterator_db7ca081358d4fb2:Fe,__wbg_get_7b48513de5dc5ea4:Ie,__wbg_call_90c26b09837aba1c:Le,__wbg_new_9fb8d994e1c0aaac:Re,__wbg_self_f0e34d89f33b99fd:ze,__wbg_window_d3b084224f4774d7:Be,__wbg_globalThis_9caa27ff917c6860:Ve,__wbg_global_35dfdd59a4da3e74:He,__wbg_from_71add2e723d1f1b2:Ue,__wbg_isArray_74fb723e24f76012:We,__wbg_instanceof_ArrayBuffer_e7d53d51371448e2:Ge,__wbg_call_5da1969d7cd31ccd:Ke,__wbg_isSafeInteger_f93fde0dca9820f8:qe,__wbg_entries_9e2e2aa45aa5094a:Je,__wbg_new_60f57089c7563e81:Ye,__wbg_resolve_6e1c6553a82f85b7:Xe,__wbg_then_3ab08cd4fbb91ae9:Ze,__wbg_then_8371cc12cfedc5a2:Qe,__wbg_buffer_a448f833075b71ba:$e,__wbg_newwithbyteoffsetandlength_d0482f893617af71:et,__wbg_new_8f67e318f15d7254:tt,__wbg_set_2357bf09366ee480:nt,__wbg_length_1d25fa9e4ac21ce7:rt,__wbg_instanceof_Uint8Array_bced6f43aed8c1aa:it,__wbg_newwithlength_6c2df9e2f3028c43:at,__wbg_subarray_2e940e41c0f5a1d9:ot,__wbg_stringify_e1b19966d964d242:st,__wbg_set_759f75cd92b612d2:ct,__wbindgen_debug_string:lt,__wbindgen_throw:ut,__wbindgen_memory:dt,__wbindgen_closure_wrapper610:ft,__wbindgen_closure_wrapper898:pt}},n),{memory:St,__wbg_configuration_free:Ct,__wbg_recovererror_free:wt,__wbg_get_recovererror_reason:Tt,__wbg_set_recovererror_reason:Et,__wbg_get_recovererror_guesses_remaining:Dt,__wbg_set_recovererror_guesses_remaining:Ot,configuration_new:kt,__wbg_client_free:At,client_new:jt,client_register:Mt,client_recover:Nt,client_delete:$,__wbg_authtokengenerator_free:Pt,authtokengenerator_new:Ft,authtokengenerator_vend:It,authtokengenerator_random_secret_id:Lt,__wbindgen_malloc:Rt,__wbindgen_realloc:zt,__wbindgen_export_2:Bt,wasm_bindgen__convert__closures__invoke0_mut__hcf60f8fe499c96ac:Vt,_dyn_core__ops__function__FnMut__A____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__h664375554e075ae3:Ht,__wbindgen_exn_store:Ut,__wbindgen_add_to_stack_pointer:Wt,__wbindgen_free:Gt,wasm_bindgen__convert__closures__invoke2_mut__h35a3737c9c8313d7:Kt}=xt}));await e((async()=>{await qt(),Q(),Q(),o(bt)}))();export{vt as AuthTokenGenerator,yt as Client,X as Configuration,ht as DeleteError,Z as RecoverError,_t as RecoverErrorReason,gt as RegisterError,S as __wbg_JuiceboxGetAuthToken_c2d75c5bf1346f44,he as __wbg_arrayBuffer_a9d862b05aaee2f9,ye as __wbg_blob_c6537f3e31e66dad,$e as __wbg_buffer_a448f833075b71ba,Ke as __wbg_call_5da1969d7cd31ccd,Le as __wbg_call_90c26b09837aba1c,be as __wbg_crypto_58f13aa23ffcb166,Ne as __wbg_done_5fe336b092d60cf2,Je as __wbg_entries_9e2e2aa45aa5094a,T as __wbg_error_f851667af71bcfc6,b as __wbg_fetch_d70cd3e887817ac6,Ue as __wbg_from_71add2e723d1f1b2,De as __wbg_getRandomValues_504510b5564925af,Ie as __wbg_get_7b48513de5dc5ea4,Oe as __wbg_get_f01601b5a68d10e3,I as __wbg_getwithrefkey_4a92a5eca60879b9,Ve as __wbg_globalThis_9caa27ff917c6860,He as __wbg_global_35dfdd59a4da3e74,ve as __wbg_headers_24def508a7518df9,z as __wbg_headers_d135d2bb8cc60413,Ge as __wbg_instanceof_ArrayBuffer_e7d53d51371448e2,ge as __wbg_instanceof_Response_4c3b1446206114d1,it as __wbg_instanceof_Uint8Array_bced6f43aed8c1aa,We as __wbg_isArray_74fb723e24f76012,qe as __wbg_isSafeInteger_f93fde0dca9820f8,Fe as __wbg_iterator_db7ca081358d4fb2,ke as __wbg_length_1009b1af0c481d7b,rt as __wbg_length_1d25fa9e4ac21ce7,we as __wbg_msCrypto_abcb1295e768d1f2,Ye as __wbg_new_60f57089c7563e81,tt as __wbg_new_8f67e318f15d7254,Re as __wbg_new_9fb8d994e1c0aaac,C as __wbg_new_abda76e883ba8a5f,Ae as __wbg_newnoargs_c62ea9419c21fbac,et as __wbg_newwithbyteoffsetandlength_d0482f893617af71,at as __wbg_newwithlength_6c2df9e2f3028c43,B as __wbg_newwithstrandinit_f581dff0d19a8b03,Me as __wbg_next_6529ee0cca8d57ed,je as __wbg_next_9b877f231f476d01,Ce as __wbg_node_523d7bd03ef69fba,L as __wbg_now_0343d9c3e0e8eedc,R as __wbg_now_b724952e890dc703,xe as __wbg_process_5b786e71d465a513,E as __wbg_queueMicrotask_4d890031a6a5a50c,D as __wbg_queueMicrotask_adae4bc085237231,Ee as __wbg_randomFillSync_a0d98aa11c81fe89,se as __wbg_recovererror_new,Te as __wbg_require_2784e593a4674877,Xe as __wbg_resolve_6e1c6553a82f85b7,ze as __wbg_self_f0e34d89f33b99fd,x as __wbg_setTimeout_deb7786d942a7ab5,nt as __wbg_set_2357bf09366ee480,me as __wbg_set_27f236f6d7a28c29,ct as __wbg_set_759f75cd92b612d2,o as __wbg_set_wasm,w as __wbg_stack_658279fe44541cf6,_e as __wbg_status_d6d47ad2837621eb,st as __wbg_stringify_e1b19966d964d242,ot as __wbg_subarray_2e940e41c0f5a1d9,Ze as __wbg_then_3ab08cd4fbb91ae9,Qe as __wbg_then_8371cc12cfedc5a2,Pe as __wbg_value_0c248a78fdc8e19f,Se as __wbg_versions_c2ab80650590b6a2,Be as __wbg_window_d3b084224f4774d7,N as __wbindgen_as_number,j as __wbindgen_boolean_get,ce as __wbindgen_cb_drop,ft as __wbindgen_closure_wrapper610,pt as __wbindgen_closure_wrapper898,lt as __wbindgen_debug_string,y as __wbindgen_error_new,pe as __wbindgen_in,O as __wbindgen_is_function,de as __wbindgen_is_object,ue as __wbindgen_is_string,fe as __wbindgen_is_undefined,A as __wbindgen_jsval_loose_eq,dt as __wbindgen_memory,M as __wbindgen_number_get,P as __wbindgen_number_new,k as __wbindgen_object_clone_ref,oe as __wbindgen_object_drop_ref,le as __wbindgen_string_get,F as __wbindgen_string_new,ut as __wbindgen_throw};

package/src/helpers/lists.js

@@ -1,3 +1,5 @@
+import parseTimeline from "../parsers/timeline.js";
+
 export async function create(name, opts = {}) {
   return await this.graphql("CreateList", {
     body: {
@@ -54,7 +56,7 @@ export async function removeMember(listId, userId) {
 }
 
 export async function members(listId, opts = {}) {
-  return await this.graphql("ListMembers", {
+  const raw = await this.graphql("ListMembers", {
     variables: {
       listId,
       count: opts.count || 20,
@@ -62,10 +64,11 @@ export async function members(listId, opts = {}) {
       ...opts.variables,
     },
   });
+  return parseTimeline(raw);
 }
 
 export async function subscribers(listId, opts = {}) {
-  return await this.graphql("ListSubscribers", {
+  const raw = await this.graphql("ListSubscribers", {
     variables: {
       listId,
       count: opts.count || 20,
@@ -73,6 +76,7 @@ export async function subscribers(listId, opts = {}) {
       ...opts.variables,
     },
   });
+  return parseTimeline(raw);
 }
 
 export async function subscribe(listId) {

package/src/helpers/tweets.js

@@ -1,4 +1,5 @@
 import getCycleTLS from "../cycletls.js";
+import parseTimeline from "../parsers/timeline.js";
 import parseTweet from "../parsers/tweet.js";
 
 async function createPollCard(instance, poll) {
@@ -262,7 +263,7 @@ export async function getMany(tweetIds) {
 }
 
 export async function detail(tweetId, opts = {}) {
-  return await this.graphql("TweetDetail", {
+  const raw = await this.graphql("TweetDetail", {
     variables: {
       focalTweetId: tweetId,
       with_rux_injections: false,
@@ -280,6 +281,7 @@ export async function detail(tweetId, opts = {}) {
       withAuxiliaryUserLabels: false,
     },
   });
+  return parseTimeline(raw);
 }
 
 export async function editHistory(tweetId) {

package/src/helpers/xchat-call-media.js

@@ -0,0 +1,127 @@
+import { spawn } from "node:child_process";
+
+const FFMPEG = process.env.FFMPEG_PATH || "ffmpeg";
+
+function decodeAll(args) {
+  return new Promise((resolve, reject) => {
+    const ff = spawn(FFMPEG, ["-hide_banner", "-loglevel", "error", ...args]);
+    const chunks = [];
+    const err = [];
+    ff.stdout.on("data", (d) => chunks.push(d));
+    ff.stderr.on("data", (d) => err.push(d));
+    ff.on("error", reject);
+    ff.on("close", (code) => {
+      if (code === 0) return resolve(Buffer.concat(chunks));
+      reject(new Error(`ffmpeg exited ${code}: ${Buffer.concat(err).toString().slice(0, 400)}`));
+    });
+  });
+}
+
+// Decode any audio file to raw PCM and push it into an RTCAudioSource at 10ms cadence.
+// Returns { done: Promise, stop() }.
+export async function streamAudioFile(source, filePath, opts = {}) {
+  const sampleRate = opts.sampleRate ?? 48000;
+  const channels = opts.channels ?? 1;
+  const samplesPerFrame = (sampleRate / 100) * channels; // 10ms
+  const bytesPerFrame = samplesPerFrame * 2;
+  const pcm = await decodeAll(["-i", filePath, "-f", "s16le", "-acodec", "pcm_s16le", "-ac", String(channels), "-ar", String(sampleRate), "pipe:1"]);
+
+  let offset = 0;
+  let timer = null;
+  let resolveDone;
+  const done = new Promise((r) => (resolveDone = r));
+  const tick = () => {
+    if (offset >= pcm.length) {
+      clearInterval(timer);
+      resolveDone({ frames: Math.ceil(pcm.length / bytesPerFrame) });
+      return;
+    }
+    const samples = new Int16Array(samplesPerFrame); // own 960-byte buffer, no aliasing
+    Buffer.from(samples.buffer).set(pcm.subarray(offset, Math.min(offset + bytesPerFrame, pcm.length)));
+    offset += bytesPerFrame;
+    source.onData({ samples, sampleRate, bitsPerSample: 16, channelCount: channels, numberOfFrames: sampleRate / 100 });
+  };
+  timer = setInterval(tick, 10);
+  return { done, stop: () => { if (timer) clearInterval(timer); resolveDone?.({ stopped: true }); } };
+}
+
+// Decode any video file to raw I420 frames and push them into an RTCVideoSource at the given fps.
+export async function streamVideoFile(source, filePath, opts = {}) {
+  const width = opts.width ?? 320;
+  const height = opts.height ?? 240;
+  const fps = opts.fps ?? 15;
+  const frameBytes = (width * height * 3) / 2;
+  const raw = await decodeAll(["-i", filePath, "-f", "rawvideo", "-pix_fmt", "yuv420p", "-s", `${width}x${height}`, "-r", String(fps), "pipe:1"]);
+
+  let offset = 0;
+  let timer = null;
+  let resolveDone;
+  const done = new Promise((r) => (resolveDone = r));
+  const tick = () => {
+    if (offset + frameBytes > raw.length) {
+      clearInterval(timer);
+      resolveDone({ frames: Math.floor(raw.length / frameBytes) });
+      return;
+    }
+    const data = new Uint8ClampedArray(raw.subarray(offset, offset + frameBytes));
+    offset += frameBytes;
+    source.onFrame({ width, height, data });
+  };
+  timer = setInterval(tick, Math.round(1000 / fps));
+  return { done, stop: () => { if (timer) clearInterval(timer); resolveDone?.({ stopped: true }); } };
+}
+
+// Pipe a received RTCAudioSink's PCM frames into a file (wav by default). Returns { stop() }.
+export function recordAudioSink(sink, filePath, opts = {}) {
+  let ff = null;
+  let sampleRate = opts.sampleRate ?? 48000;
+  let channels = opts.channels ?? 1;
+  let frames = 0;
+  const start = (sr, ch) => {
+    sampleRate = sr;
+    channels = ch;
+    ff = spawn(FFMPEG, ["-hide_banner", "-loglevel", "error", "-y", "-f", "s16le", "-ar", String(sr), "-ac", String(ch), "-i", "pipe:0", filePath]);
+  };
+  sink.ondata = (d) => {
+    if (!ff) start(d.sampleRate, d.channelCount);
+    frames++;
+    ff.stdin.write(Buffer.from(d.samples.buffer, d.samples.byteOffset, d.samples.byteLength));
+  };
+  return {
+    get frames() { return frames; },
+    stop: () => new Promise((res) => {
+      sink.stop?.();
+      if (!ff) return res({ frames: 0 });
+      ff.stdin.end();
+      ff.on("close", () => res({ frames, sampleRate, channels }));
+    }),
+  };
+}
+
+// Pipe a received RTCVideoSink's I420 frames into a file (mp4 by default). Returns { stop() }.
+export function recordVideoSink(sink, filePath, opts = {}) {
+  let ff = null;
+  let fps = opts.fps ?? 15;
+  let frames = 0;
+  let dims = null;
+  const start = (w, h) => {
+    dims = { w, h };
+    ff = spawn(FFMPEG, ["-hide_banner", "-loglevel", "error", "-y", "-f", "rawvideo", "-pix_fmt", "yuv420p", "-s", `${w}x${h}`, "-r", String(fps), "-i", "pipe:0", "-pix_fmt", "yuv420p", filePath]);
+  };
+  sink.onframe = ({ frame }) => {
+    if (!ff) start(frame.width, frame.height);
+    if (frame.width !== dims.w || frame.height !== dims.h) return;
+    frames++;
+    ff.stdin.write(Buffer.from(frame.data.buffer, frame.data.byteOffset, frame.data.byteLength));
+  };
+  return {
+    get frames() { return frames; },
+    get dims() { return dims; },
+    stop: () => new Promise((res) => {
+      sink.stop?.();
+      if (!ff) return res({ frames: 0 });
+      ff.stdin.end();
+      ff.on("close", () => res({ frames, dims }));
+    }),
+  };
+}