@scalemule/nextjs 0.1.9 → 0.1.11

package/dist/index.d.mts

@@ -216,13 +216,13 @@ interface ScaleMuleProviderProps extends ScaleMuleConfig {
      *
      * The platform stores the per-app policy in
      * `application_storage_settings.media_policy` (Phase 4 / P3, live in
-     * prod). That endpoint is `MemberOnly` admin-auth, so end-user-context
-     * provider can't fetch it directly — apps that want policy-driven
-     * defaults should declare the value here, mirroring whatever the
-     * platform admin set.
+     * prod). On boot, the provider fetches `GET /v1/storage/policy` (a
+     * lightweight `EndUserOnly` endpoint added in `@scalemule/sdk@0.0.45`)
+     * and uses the returned policy as the effective default.
      *
-     * Default: undefined → `useMedia()` falls back to its built-in
-     * `safe_visible` default.
+     * Passing this prop overrides the auto-fetched value — useful for
+     * tests or when an app needs to force a specific mode regardless of
+     * platform config.
      */
     mediaPolicy?: MediaPolicy;
 }

package/dist/index.d.ts

@@ -216,13 +216,13 @@ interface ScaleMuleProviderProps extends ScaleMuleConfig {
      *
      * The platform stores the per-app policy in
      * `application_storage_settings.media_policy` (Phase 4 / P3, live in
-     * prod). That endpoint is `MemberOnly` admin-auth, so end-user-context
-     * provider can't fetch it directly — apps that want policy-driven
-     * defaults should declare the value here, mirroring whatever the
-     * platform admin set.
+     * prod). On boot, the provider fetches `GET /v1/storage/policy` (a
+     * lightweight `EndUserOnly` endpoint added in `@scalemule/sdk@0.0.45`)
+     * and uses the returned policy as the effective default.
      *
-     * Default: undefined → `useMedia()` falls back to its built-in
-     * `safe_visible` default.
+     * Passing this prop overrides the auto-fetched value — useful for
+     * tests or when an app needs to force a specific mode regardless of
+     * platform config.
      */
     mediaPolicy?: MediaPolicy;
 }

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.
@@ -7569,6 +7583,28 @@ function ScaleMuleProvider({
       debug
     });
   }, [apiKey, applicationId, environment, resolvedGatewayUrl, debug]);
+  const [fetchedPolicy, setFetchedPolicy] = React.useState(void 0);
+  React.useEffect(() => {
+    if (mediaPolicy) return;
+    let mounted = true;
+    void (async () => {
+      try {
+        const fn = baseClient.storage.getPolicy;
+        if (typeof fn !== "function") return;
+        const r = await fn.call(baseClient.storage);
+        if (!mounted) return;
+        const v = r?.data?.media_policy;
+        if (v === "fast_trusted" || v === "safe_visible" || v === "safe_public" || v === "moderated" || v === "compliance") {
+          setFetchedPolicy(v);
+        }
+      } catch {
+      }
+    })();
+    return () => {
+      mounted = false;
+    };
+  }, [baseClient, mediaPolicy]);
+  const effectiveMediaPolicy = mediaPolicy ?? fetchedPolicy;
   React.useEffect(() => {
     const token = client.getSessionToken();
     if (token) {
@@ -7672,7 +7708,7 @@ function ScaleMuleProvider({
       photo: baseClient.photo,
       video: baseClient.video,
       audio: baseClient.audio,
-      mediaPolicy,
+      mediaPolicy: effectiveMediaPolicy,
       user,
       setUser: handleSetUser,
       initializing,
@@ -7687,7 +7723,7 @@ function ScaleMuleProvider({
       accountSwitcherPrivacy,
       bootstrapFlags
     }),
-    [client, money$1, baseClient, user, handleSetUser, initializing, error, analyticsProxyUrl, authProxyUrl, publishableKey, resolvedGatewayUrl, environment, enableAccountSwitcher, accountSwitcherPrivacy, bootstrapFlags, mediaPolicy]
+    [client, money$1, baseClient, user, handleSetUser, initializing, error, analyticsProxyUrl, authProxyUrl, publishableKey, resolvedGatewayUrl, environment, enableAccountSwitcher, accountSwitcherPrivacy, bootstrapFlags, effectiveMediaPolicy]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(ScaleMuleContext.Provider, { value, children });
 }
@@ -9103,10 +9139,13 @@ function useMedia() {
     async (fileId) => {
       setError(null);
       try {
-        const r = await storage.delete(fileId);
-        if (r.error) {
-          if (r.error.status === 404) return;
-          throw r.error;
+        const [, storageResult] = await Promise.all([
+          photo.delete(fileId).catch(() => void 0),
+          storage.delete(fileId)
+        ]);
+        if (storageResult.error) {
+          if (storageResult.error.status === 404) return;
+          throw storageResult.error;
         }
       } catch (err) {
         const e = err;
@@ -9114,7 +9153,7 @@ function useMedia() {
         throw e;
       }
     },
-    [storage]
+    [storage, photo]
   );
   return { upload, cancelUpload, error, uploading };
 }
@@ -9171,13 +9210,26 @@ function useFileStatus(options) {
   }, [fetchStatus]);
   React.useEffect(() => {
     if (!pollIntervalMs || disabled || !fileId) return;
-    const isClean = status?.scan.status === "clean";
-    if (isClean) return;
+    const scan = status?.scan.status;
+    if (scan === "threat" || scan === "quarantined" || scan === "error") return;
+    const optimizePending = status?.optimize != null && status.optimize.status !== "done";
+    const transcodePending = status?.transcode != null && status.transcode.status !== "done";
+    const pipelinePending = optimizePending || transcodePending;
+    const isSettled = scan === "clean" && !pipelinePending;
+    if (isSettled) return;
     const id = setInterval(() => {
       void fetchStatus();
     }, pollIntervalMs);
     return () => clearInterval(id);
-  }, [pollIntervalMs, disabled, fileId, status?.scan.status, fetchStatus]);
+  }, [
+    pollIntervalMs,
+    disabled,
+    fileId,
+    status?.scan.status,
+    status?.optimize,
+    status?.transcode,
+    fetchStatus
+  ]);
   React.useEffect(() => {
     if (!conversationId || !fileId || disabled) return;
     const channel = conversationChannel(conversationKind, conversationId);
@@ -9212,33 +9264,48 @@ function ScaleMuleMedia(props) {
     renderBlocked,
     renderOverride
   } = props;
+  const { gatewayUrl } = useScaleMule();
   const { status, isReady } = useFileStatus({
     fileId,
     pollIntervalMs,
     conversationId,
     conversationKind
   });
+  const absoluteUrl = React__namespace.useCallback(
+    (url) => {
+      if (!url) return null;
+      if (url.startsWith("http://") || url.startsWith("https://") || url.startsWith("blob:") || url.startsWith("data:")) {
+        return url;
+      }
+      if (!gatewayUrl) return url;
+      const base = gatewayUrl.endsWith("/") ? gatewayUrl.slice(0, -1) : gatewayUrl;
+      const path = url.startsWith("/") ? url : `/${url}`;
+      return `${base}${path}`;
+    },
+    [gatewayUrl]
+  );
   const isImage = mimeType.startsWith("image/");
   const isVideo = mimeType.startsWith("video/");
   const isAudio = mimeType.startsWith("audio/");
   const src = React.useMemo(() => {
     const scan = status?.scan.status;
     if (scan === "threat" || scan === "quarantined") return null;
-    if (status && isReady) {
-      if (isImage && status.urls.optimized) return status.urls.optimized;
-      if (isVideo && status.urls.hls) return status.urls.hls;
-      return status.urls.original ?? null;
-    }
-    if (blobPreview) return blobPreview;
-    return null;
-  }, [status, isReady, isImage, isVideo, blobPreview]);
+    if (!status) {
+      return blobPreview ?? null;
+    }
+    if (isImage && status.urls.optimized) return absoluteUrl(status.urls.optimized);
+    if (isVideo && status.urls.hls) return absoluteUrl(status.urls.hls);
+    if (status.urls.original) return absoluteUrl(status.urls.original);
+    return blobPreview ?? null;
+  }, [status, isImage, isVideo, blobPreview, absoluteUrl]);
   const renderState = React.useMemo(() => {
     const scan = status?.scan.status;
     if (scan === "threat" || scan === "quarantined") return "blocked";
+    if (status?.urls.original) return "ready";
     if (isReady) return "ready";
     if (blobPreview) return "preview";
     return "pending";
-  }, [status?.scan.status, isReady, blobPreview]);
+  }, [status?.scan.status, status?.urls.original, isReady, blobPreview]);
   const videoRef = React__namespace.useRef(null);
   React.useEffect(() => {
     if (!isVideo) return;
@@ -9279,9 +9346,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",
@@ -9293,6 +9357,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.
@@ -7549,6 +7563,28 @@ function ScaleMuleProvider({
       debug
     });
   }, [apiKey, applicationId, environment, resolvedGatewayUrl, debug]);
+  const [fetchedPolicy, setFetchedPolicy] = useState(void 0);
+  useEffect(() => {
+    if (mediaPolicy) return;
+    let mounted = true;
+    void (async () => {
+      try {
+        const fn = baseClient.storage.getPolicy;
+        if (typeof fn !== "function") return;
+        const r = await fn.call(baseClient.storage);
+        if (!mounted) return;
+        const v = r?.data?.media_policy;
+        if (v === "fast_trusted" || v === "safe_visible" || v === "safe_public" || v === "moderated" || v === "compliance") {
+          setFetchedPolicy(v);
+        }
+      } catch {
+      }
+    })();
+    return () => {
+      mounted = false;
+    };
+  }, [baseClient, mediaPolicy]);
+  const effectiveMediaPolicy = mediaPolicy ?? fetchedPolicy;
   useEffect(() => {
     const token = client.getSessionToken();
     if (token) {
@@ -7652,7 +7688,7 @@ function ScaleMuleProvider({
       photo: baseClient.photo,
       video: baseClient.video,
       audio: baseClient.audio,
-      mediaPolicy,
+      mediaPolicy: effectiveMediaPolicy,
       user,
       setUser: handleSetUser,
       initializing,
@@ -7667,7 +7703,7 @@ function ScaleMuleProvider({
       accountSwitcherPrivacy,
       bootstrapFlags
     }),
-    [client, money, baseClient, user, handleSetUser, initializing, error, analyticsProxyUrl, authProxyUrl, publishableKey, resolvedGatewayUrl, environment, enableAccountSwitcher, accountSwitcherPrivacy, bootstrapFlags, mediaPolicy]
+    [client, money, baseClient, user, handleSetUser, initializing, error, analyticsProxyUrl, authProxyUrl, publishableKey, resolvedGatewayUrl, environment, enableAccountSwitcher, accountSwitcherPrivacy, bootstrapFlags, effectiveMediaPolicy]
   );
   return /* @__PURE__ */ jsx(ScaleMuleContext.Provider, { value, children });
 }
@@ -9083,10 +9119,13 @@ function useMedia() {
     async (fileId) => {
       setError(null);
       try {
-        const r = await storage.delete(fileId);
-        if (r.error) {
-          if (r.error.status === 404) return;
-          throw r.error;
+        const [, storageResult] = await Promise.all([
+          photo.delete(fileId).catch(() => void 0),
+          storage.delete(fileId)
+        ]);
+        if (storageResult.error) {
+          if (storageResult.error.status === 404) return;
+          throw storageResult.error;
         }
       } catch (err) {
         const e = err;
@@ -9094,7 +9133,7 @@ function useMedia() {
         throw e;
       }
     },
-    [storage]
+    [storage, photo]
   );
   return { upload, cancelUpload, error, uploading };
 }
@@ -9151,13 +9190,26 @@ function useFileStatus(options) {
   }, [fetchStatus]);
   useEffect(() => {
     if (!pollIntervalMs || disabled || !fileId) return;
-    const isClean = status?.scan.status === "clean";
-    if (isClean) return;
+    const scan = status?.scan.status;
+    if (scan === "threat" || scan === "quarantined" || scan === "error") return;
+    const optimizePending = status?.optimize != null && status.optimize.status !== "done";
+    const transcodePending = status?.transcode != null && status.transcode.status !== "done";
+    const pipelinePending = optimizePending || transcodePending;
+    const isSettled = scan === "clean" && !pipelinePending;
+    if (isSettled) return;
     const id = setInterval(() => {
       void fetchStatus();
     }, pollIntervalMs);
     return () => clearInterval(id);
-  }, [pollIntervalMs, disabled, fileId, status?.scan.status, fetchStatus]);
+  }, [
+    pollIntervalMs,
+    disabled,
+    fileId,
+    status?.scan.status,
+    status?.optimize,
+    status?.transcode,
+    fetchStatus
+  ]);
   useEffect(() => {
     if (!conversationId || !fileId || disabled) return;
     const channel = conversationChannel(conversationKind, conversationId);
@@ -9192,33 +9244,48 @@ function ScaleMuleMedia(props) {
     renderBlocked,
     renderOverride
   } = props;
+  const { gatewayUrl } = useScaleMule();
   const { status, isReady } = useFileStatus({
     fileId,
     pollIntervalMs,
     conversationId,
     conversationKind
   });
+  const absoluteUrl = React.useCallback(
+    (url) => {
+      if (!url) return null;
+      if (url.startsWith("http://") || url.startsWith("https://") || url.startsWith("blob:") || url.startsWith("data:")) {
+        return url;
+      }
+      if (!gatewayUrl) return url;
+      const base = gatewayUrl.endsWith("/") ? gatewayUrl.slice(0, -1) : gatewayUrl;
+      const path = url.startsWith("/") ? url : `/${url}`;
+      return `${base}${path}`;
+    },
+    [gatewayUrl]
+  );
   const isImage = mimeType.startsWith("image/");
   const isVideo = mimeType.startsWith("video/");
   const isAudio = mimeType.startsWith("audio/");
   const src = useMemo(() => {
     const scan = status?.scan.status;
     if (scan === "threat" || scan === "quarantined") return null;
-    if (status && isReady) {
-      if (isImage && status.urls.optimized) return status.urls.optimized;
-      if (isVideo && status.urls.hls) return status.urls.hls;
-      return status.urls.original ?? null;
-    }
-    if (blobPreview) return blobPreview;
-    return null;
-  }, [status, isReady, isImage, isVideo, blobPreview]);
+    if (!status) {
+      return blobPreview ?? null;
+    }
+    if (isImage && status.urls.optimized) return absoluteUrl(status.urls.optimized);
+    if (isVideo && status.urls.hls) return absoluteUrl(status.urls.hls);
+    if (status.urls.original) return absoluteUrl(status.urls.original);
+    return blobPreview ?? null;
+  }, [status, isImage, isVideo, blobPreview, absoluteUrl]);
   const renderState = useMemo(() => {
     const scan = status?.scan.status;
     if (scan === "threat" || scan === "quarantined") return "blocked";
+    if (status?.urls.original) return "ready";
     if (isReady) return "ready";
     if (blobPreview) return "preview";
     return "pending";
-  }, [status?.scan.status, isReady, blobPreview]);
+  }, [status?.scan.status, status?.urls.original, isReady, blobPreview]);
   const videoRef = React.useRef(null);
   useEffect(() => {
     if (!isVideo) return;
@@ -9259,9 +9326,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",
@@ -9273,6 +9337,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.9",
+  "version": "0.1.11",
   "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",