@scalemule/nextjs 0.1.11 → 0.1.12

package/dist/index.d.mts

@@ -436,9 +436,17 @@ interface ScaleMuleMediaProps {
     alt?: string;
     /**
      * Polling interval while waiting for the media pipeline to complete.
-     * Defaults to 2000ms; set to `null` to disable polling. Polling stops
-     * automatically once scan is clean. When `conversationId` is set the
-     * component receives push updates and you can usually pass `null`.
+     *
+     * Default behaviour:
+     *   - With `conversationId` set: polling **off** (the realtime
+     *     conversation channel pushes `file_status_changed` events;
+     *     a poll loop on top would just be wasted requests).
+     *   - Without `conversationId`: 2000ms.
+     *
+     * Override either way by passing a number (belt-and-suspenders if you
+     * don't trust your websocket) or `null` (disable explicitly).
+     * Polling stops automatically once both scan and any expected
+     * pipeline (optimize / transcode) have settled.
      */
     pollIntervalMs?: number | null;
     /**

package/dist/index.d.ts

@@ -436,9 +436,17 @@ interface ScaleMuleMediaProps {
     alt?: string;
     /**
      * Polling interval while waiting for the media pipeline to complete.
-     * Defaults to 2000ms; set to `null` to disable polling. Polling stops
-     * automatically once scan is clean. When `conversationId` is set the
-     * component receives push updates and you can usually pass `null`.
+     *
+     * Default behaviour:
+     *   - With `conversationId` set: polling **off** (the realtime
+     *     conversation channel pushes `file_status_changed` events;
+     *     a poll loop on top would just be wasted requests).
+     *   - Without `conversationId`: 2000ms.
+     *
+     * Override either way by passing a number (belt-and-suspenders if you
+     * don't trust your websocket) or `null` (disable explicitly).
+     * Polling stops automatically once both scan and any expected
+     * pipeline (optimize / transcode) have settled.
      */
     pollIntervalMs?: number | null;
     /**

package/dist/index.js

@@ -9257,17 +9257,18 @@ function ScaleMuleMedia(props) {
     className,
     style,
     alt,
-    pollIntervalMs = 2e3,
+    pollIntervalMs,
     conversationId = null,
     conversationKind,
     renderPlaceholder,
     renderBlocked,
     renderOverride
   } = props;
+  const effectivePollIntervalMs = pollIntervalMs !== void 0 ? pollIntervalMs : conversationId ? null : 2e3;
   const { gatewayUrl } = useScaleMule();
   const { status, isReady } = useFileStatus({
     fileId,
-    pollIntervalMs,
+    pollIntervalMs: effectivePollIntervalMs,
     conversationId,
     conversationKind
   });

package/dist/index.mjs

@@ -9237,17 +9237,18 @@ function ScaleMuleMedia(props) {
     className,
     style,
     alt,
-    pollIntervalMs = 2e3,
+    pollIntervalMs,
     conversationId = null,
     conversationKind,
     renderPlaceholder,
     renderBlocked,
     renderOverride
   } = props;
+  const effectivePollIntervalMs = pollIntervalMs !== void 0 ? pollIntervalMs : conversationId ? null : 2e3;
   const { gatewayUrl } = useScaleMule();
   const { status, isReady } = useFileStatus({
     fileId,
-    pollIntervalMs,
+    pollIntervalMs: effectivePollIntervalMs,
     conversationId,
     conversationKind
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/nextjs",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "ScaleMule SDK for Next.js applications - authentication, storage, and user management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",