@scalemule/nextjs 0.1.10 → 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

@@ -2771,6 +2771,20 @@ var StorageService = class extends ServiceModule {
   async getFileStatus(fileId, options) {
     return this._get(`/files/${fileId}/status`, options);
   }
+  /**
+   * Read the application's active media policy. Lightweight endpoint
+   * (`GET /v1/storage/policy`) used by the SDK on boot to pick up the
+   * platform-default `media_policy` without requiring app-admin auth.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.storage.getPolicy();
+   * console.log(data?.media_policy); // 'safe_visible'
+   * ```
+   */
+  async getPolicy(options) {
+    return this._get(`/policy`, options);
+  }
   /**
    * Get a signed view URL for inline display (img src, thumbnails).
    * Returns CloudFront signed URL (fast, ~1us) or S3 presigned fallback.
@@ -9243,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
   });
@@ -9332,9 +9347,6 @@ function ScaleMuleMedia(props) {
       if (hls) hls.destroy();
     };
   }, [isVideo, src]);
-  if (renderOverride) {
-    return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: renderOverride({ src, state: renderState }) });
-  }
   if (renderState === "blocked") {
     return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: renderBlocked ? renderBlocked() : /* @__PURE__ */ jsxRuntime.jsx(
       "div",
@@ -9346,6 +9358,9 @@ function ScaleMuleMedia(props) {
       }
     ) });
   }
+  if (renderOverride) {
+    return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: renderOverride({ src, state: renderState }) });
+  }
   if (renderState === "pending" && !src) {
     return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: renderPlaceholder ? renderPlaceholder() : /* @__PURE__ */ jsxRuntime.jsx(
       "div",

package/dist/index.mjs

@@ -2751,6 +2751,20 @@ var StorageService = class extends ServiceModule {
   async getFileStatus(fileId, options) {
     return this._get(`/files/${fileId}/status`, options);
   }
+  /**
+   * Read the application's active media policy. Lightweight endpoint
+   * (`GET /v1/storage/policy`) used by the SDK on boot to pick up the
+   * platform-default `media_policy` without requiring app-admin auth.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.storage.getPolicy();
+   * console.log(data?.media_policy); // 'safe_visible'
+   * ```
+   */
+  async getPolicy(options) {
+    return this._get(`/policy`, options);
+  }
   /**
    * Get a signed view URL for inline display (img src, thumbnails).
    * Returns CloudFront signed URL (fast, ~1us) or S3 presigned fallback.
@@ -9223,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
   });
@@ -9312,9 +9327,6 @@ function ScaleMuleMedia(props) {
       if (hls) hls.destroy();
     };
   }, [isVideo, src]);
-  if (renderOverride) {
-    return /* @__PURE__ */ jsx(Fragment, { children: renderOverride({ src, state: renderState }) });
-  }
   if (renderState === "blocked") {
     return /* @__PURE__ */ jsx(Fragment, { children: renderBlocked ? renderBlocked() : /* @__PURE__ */ jsx(
       "div",
@@ -9326,6 +9338,9 @@ function ScaleMuleMedia(props) {
       }
     ) });
   }
+  if (renderOverride) {
+    return /* @__PURE__ */ jsx(Fragment, { children: renderOverride({ src, state: renderState }) });
+  }
   if (renderState === "pending" && !src) {
     return /* @__PURE__ */ jsx(Fragment, { children: renderPlaceholder ? renderPlaceholder() : /* @__PURE__ */ jsx(
       "div",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/nextjs",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "ScaleMule SDK for Next.js applications - authentication, storage, and user management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -54,7 +54,7 @@
   },
   "dependencies": {
     "@scalemule/money": "^0.0.1",
-    "@scalemule/sdk": "^0.0.43"
+    "@scalemule/sdk": ">=0.0.45 <0.1.0"
   },
   "peerDependencies": {
     "next": ">=14.0.0",