X (Twitter) API TypeScript media tweets & DM media

interface TweetWriteAction {
  id: string;
  status: string;
  terminal: boolean;
  safeToRetry: boolean;
  statusUrl: string;
  request: { hash: string | null };
  billing: { charged: boolean; chargedCredits: string };
  result: { id?: string } | null;
  tweetId?: string;
}

function createTweetHandoff(
  action: TweetWriteAction,
  base: {
    account: string;
    media: string[];
    reply_to_tweet_id?: string;
  },
) {
  const thread = base.reply_to_tweet_id ? { reply_to_tweet_id: base.reply_to_tweet_id } : {};

  return {
    status: action.status,
    terminal: action.terminal,
    safe_to_retry: action.safeToRetry,
    write_action_id: action.id,
    request_hash: action.request.hash,
    tweet_id: action.result?.id ?? action.tweetId ?? null,
    charged: action.billing.charged,
    charged_credits: action.billing.chargedCredits,
    poll: action.terminal ? null : action.statusUrl,
    ...base,
    ...thread,
  };
}

const tweet = (await client.x.tweets.create({
  account: "@username",
  text: "New demo video is live.",
  media: ["https://example.com/product-demo.mp4"],
})) as TweetWriteAction;

const tweetHandoff = createTweetHandoff(tweet, {
  account: "@username",
  media: ["https://example.com/product-demo.mp4"],
});

process.stdout.write(`${JSON.stringify(tweetHandoff)}\n`);

const reply = (await client.x.tweets.create({
  account: "@username",
  text: "Here is the requested screenshot.",
  reply_to_tweet_id: "1893704267862470862",
  media: ["https://example.com/export-preview.png"],
})) as TweetCreateResult;

const replyHandoff = createTweetHandoff(reply, {
  account: "@username",
  reply_to_tweet_id: "1893704267862470862",
  media: ["https://example.com/export-preview.png"],
});

process.stdout.write(`${JSON.stringify(replyHandoff)}\n`);

import fs from "node:fs";

const media = await client.x.media.upload({
  account: "@username",
  file: fs.createReadStream("./handoff.png"),
});

const dm = await client.x.dm.send("44196397", {
  account: "@username",
  text: "Here is the asset.",
  media_ids: [media.mediaId],
});

const dmHandoff = {
  status: "sent",
  message_id: dm.messageId,
  media_id: media.mediaId,
  account: "@username",
  user_id: "44196397",
};

process.stdout.write(`${JSON.stringify(dmHandoff)}\n`);