feat: Add configurable mediaTimeout option for media upload polling (#1341)

Copilot · neet · Copilot · web-flow · commit 7341c22f0e45 · 2025-10-25T11:02:48.000Z
* Initial plan * Add mediaTimeout configuration option to HttpConfig Co-authored-by: neet <19276905+neet@users.noreply.github.com> * Refactor mediaTimeout to use MediaConfigProps pattern Co-authored-by: neet <19276905+neet@users.noreply.github.com> * Add @experimental tag to mediaTimeout documentation Co-authored-by: neet <19276905+neet@users.noreply.github.com> * Update clients.ts Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: neet <19276905+neet@users.noreply.github.com> Co-authored-by: Ryō Igarashi (五十嵐 涼) <n33t5hin@gmail.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
diff --git a/src/adapters/action/dispatcher-http-hook-mastodon.spec.ts b/src/adapters/action/dispatcher-http-hook-mastodon.spec.ts
@@ -61,6 +61,29 @@ describe("DispatcherHttp", () => {
     await expect(promise).rejects.toBeInstanceOf(MastoTimeoutError);
   });
 
+  it("uses custom mediaTimeout value", async () => {
+    const http = new HttpMockImpl();
+    const customTimeout = 100; // Short timeout for fast test
+    const dispatcher = new HttpActionDispatcher(
+      http,
+      new HttpActionDispatcherHookMastodon(http, customTimeout),
+    );
+
+    httpPost.mockResolvedValueOnce({ id: "1" });
+    httpGet.mockRejectedValue(
+      new MastoHttpError({ statusCode: 404, message: "Not Found" }),
+    );
+
+    const promise = dispatcher.dispatch({
+      type: "create",
+      path: "/api/v2/media",
+      data: undefined,
+      meta: {},
+    });
+
+    await expect(promise).rejects.toBeInstanceOf(MastoTimeoutError);
+  });
+
   it("rethrows errors for media processing", async () => {
     const http = new HttpMockImpl();
     const dispatcher = new HttpActionDispatcher(
diff --git a/src/adapters/clients.ts b/src/adapters/clients.ts
@@ -34,14 +34,29 @@ interface LogConfigProps {
   readonly log?: LogType;
 }
 
+interface MediaConfigProps {
+  /**
+   * Timeout milliseconds for media upload processing.
+   *
+   * When uploading media via `/api/v2/media`, the library polls the server
+   * to wait for media processing to complete before returning. This timeout
+   * controls how long to wait before giving up.
+   *
+   * Defaults to 60000 (60 seconds).
+   *
+   * @experimental The behavior of this option may change without any announcement.
+   */
+  readonly mediaTimeout?: number;
+}
+
 export const createRestAPIClient = (
-  props: MastoHttpConfigProps & LogConfigProps,
+  props: MastoHttpConfigProps & LogConfigProps & MediaConfigProps,
 ): mastodon.rest.Client => {
   const serializer = new SerializerNativeImpl();
   const config = new HttpConfigImpl(props, serializer);
   const logger = createLogger(props.log);
   const http = new HttpNativeImpl(serializer, config, logger);
-  const hook = new HttpActionDispatcherHookMastodon(http);
+  const hook = new HttpActionDispatcherHookMastodon(http, props.mediaTimeout);
   const actionDispatcher = new HttpActionDispatcher(http, hook);
   const actionProxy = createActionProxy(actionDispatcher, {
     context: ["api"],
