@whanext/core 0.19.15 → 0.19.16

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.19.16
+
+### Fixed
+- Remote media URLs are now streamed into Zapo instead of being fully materialized as `Uint8Array` in memory before upload. This removes the extra whole-file buffering step that could stall or intermittently fail larger MP3/audio sends.
+- Remote media fetches now have a bounded 120-second transfer timeout and surface provider errors when the source cannot be opened or returns an empty body.
+- Local paths and caller-provided byte arrays keep their existing behavior.
+
+### Performance
+- URL-backed audio/video/image uploads now follow Zapo's recommended streaming media path, keeping memory usage flat while Zapo stages, hashes, encrypts, and uploads the attachment.
+
 ## 0.19.15
 
 ### Added

package/README.md

@@ -537,6 +537,8 @@ const downloaded = await app.media.download(message);
 await writeFile(`./downloads/${downloaded.fileName ?? message.id}`, downloaded.data);
 ```
 
+Ao enviar `{ url }`, o provider abre a origem remota como stream e entrega o fluxo ao pipeline de mídia do Zapo; o arquivo não é carregado inteiro na memória antes do upload. Para arquivos locais, `{ path }` continua sendo a opção mais direta.
+
 `download()` aceita a `Message` recebida, uma `QuotedMessage` ou uma `MessageKey` e devolve o buffer junto dos metadados normalizados. A mídia deve ser baixada enquanto a mensagem ainda está no cache da instância; o provider tenta renovar a URL de mídia automaticamente quando necessário.
 
 Para visualização única citada, o provider oficial preserva os metadados do envelope sem expor tipos do Zapo:

package/dist/index.d.ts

@@ -646,8 +646,8 @@ declare const guards: {
     custom(guard: CommandGuard): CommandGuard;
 };
 
-type CommandScope = "global" | "user" | "chat" | "user-chat" | "user-group";
-type ConcurrencyStrategy = "parallel" | "reject" | "queue" | "replace";
+type CommandScope = 'global' | 'user' | 'chat' | 'user-chat' | 'user-group';
+type ConcurrencyStrategy = 'parallel' | 'reject' | 'queue' | 'replace';
 interface CommandCooldown {
     durationMs: number;
     scope?: CommandScope;

package/dist/index.js

@@ -2406,6 +2406,7 @@ var Browser = /* @__PURE__ */ ((Browser2) => {
 // src/provider/zapo/zapo-provider.ts
 import { mkdir, stat } from "fs/promises";
 import { createRequire as createRequire2 } from "module";
+import { Readable } from "stream";
 import { basename, dirname as dirname2, join, resolve as resolve2 } from "path";
 import { createMediaProcessor } from "@zapo-js/media-utils";
 import { createSqliteStore } from "@zapo-js/store-sqlite";
@@ -2930,6 +2931,7 @@ var fatalDisconnectReasons = /* @__PURE__ */ new Set([
 ]);
 var fatalDisconnectCodes = /* @__PURE__ */ new Set([401, 403, 405, 406, 409, 516]);
 var sharedMediaProcessor = createMediaProcessor();
+var REMOTE_MEDIA_TIMEOUT_MS = 12e4;
 var messageSnapshotRetentionSeconds = 7 * 24 * 60 * 60;
 var messageSnapshotMaxPerSession = 2e4;
 var messageSnapshotPruneInterval = 256;
@@ -3968,8 +3970,20 @@ var ZapoProvider = class {
   async #media(source) {
     if (source instanceof Uint8Array) return source;
     if ("path" in source) return source.path;
-    const response = await fetch(source.url);
+    let response;
+    try {
+      response = await fetch(source.url, {
+        signal: AbortSignal.timeout(REMOTE_MEDIA_TIMEOUT_MS)
+      });
+    } catch (error) {
+      throw new WhaNextError(
+        "PROVIDER_ERROR",
+        "Could not open the remote media source.",
+        { cause: error, recoverable: true }
+      );
+    }
     if (!response.ok) {
+      await response.body?.cancel().catch(() => void 0);
       throw new WhaNextError(
         "PROVIDER_ERROR",
         "Could not download the remote media source.",
@@ -3979,7 +3993,16 @@ var ZapoProvider = class {
         }
       );
     }
-    return new Uint8Array(await response.arrayBuffer());
+    if (!response.body) {
+      throw new WhaNextError(
+        "PROVIDER_ERROR",
+        "The remote media source returned an empty response body.",
+        { recoverable: true }
+      );
+    }
+    return Readable.fromWeb(
+      response.body
+    );
   }
   #mentions(mentions) {
     return mentions.map((mention) => typeof mention === "string" ? mention : mention.mentionId);