@scalemule/nextjs 0.1.39 → 0.1.41

package/dist/audio.mjs

@@ -0,0 +1,364 @@
+'use client';
+"use client";
+
+// src/components/audio-player.tsx
+import {
+  useEffect,
+  useId,
+  useMemo,
+  useRef,
+  useState
+} from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+var SPEEDS = [1, 1.25, 1.5, 2, 3];
+var PLAY_EVENT = "scalemule:audio:play";
+var positive = (n) => n != null && Number.isFinite(n) && n > 0 ? n : 0;
+var durationOf = (audio) => positive(audio.duration_ms) / 1e3;
+function time(seconds) {
+  const s = Math.floor(positive(seconds));
+  return `${Math.floor(s / 60)}:${String(s % 60).padStart(2, "0")}`;
+}
+function AudioPlayer(props) {
+  if (!props.audio.url) return null;
+  return /* @__PURE__ */ jsx(PlayerSession, { ...props }, props.audioKey ?? props.audio.url);
+}
+function PlayerSession({
+  audio,
+  variant = "waveform",
+  label,
+  className,
+  style,
+  preload = "none",
+  onRefresh,
+  showRefreshButton = false,
+  onPlaybackError,
+  playbackRateStorageKey = "scalemule:audio:playback-rate",
+  exclusivePlayback = true
+}) {
+  const media = useRef(null);
+  const alive = useRef(true);
+  const request = useRef(null);
+  const triedRefresh = useRef(false);
+  const intent = useRef(false);
+  const resume = useRef(null);
+  const [source, setSource] = useState(audio);
+  const [duration, setDuration] = useState(durationOf(audio));
+  const [position, setPosition] = useState(0);
+  const [speed, setSpeed] = useState(1);
+  const [playing, setPlaying] = useState(false);
+  const [pendingPlay, setPendingPlay] = useState(false);
+  const [busy, setBusy] = useState(false);
+  const [error, setError] = useState(null);
+  const sliderId = useId();
+  const labelId = useId();
+  const rate = useRef(1);
+  useEffect(() => {
+    alive.current = true;
+    const element = media.current;
+    return () => {
+      alive.current = false;
+      intent.current = false;
+      request.current?.abort();
+      element?.pause();
+    };
+  }, []);
+  useEffect(() => {
+    request.current?.abort();
+    request.current = null;
+    setBusy(false);
+    resume.current = media.current?.currentTime ?? 0;
+    setSource(audio);
+    setDuration(durationOf(audio));
+  }, [audio.url, audio.expires_at, audio.duration_ms]);
+  useEffect(() => {
+    if (!playbackRateStorageKey) return;
+    try {
+      const saved = Number(window.localStorage.getItem(playbackRateStorageKey));
+      if (SPEEDS.includes(saved)) {
+        setSpeed(saved);
+        rate.current = saved;
+      }
+    } catch {
+    }
+  }, [playbackRateStorageKey]);
+  useEffect(() => {
+    if (media.current) {
+      media.current.playbackRate = speed;
+      media.current.preservesPitch = true;
+    }
+  }, [speed, source.url]);
+  useEffect(() => {
+    if (!exclusivePlayback) return;
+    const stop = (event) => {
+      if (event.detail !== media.current) {
+        intent.current = false;
+        setPendingPlay(false);
+        media.current?.pause();
+      }
+    };
+    document.addEventListener(PLAY_EVENT, stop);
+    return () => document.removeEventListener(PLAY_EVENT, stop);
+  }, [exclusivePlayback]);
+  function fail() {
+    if (!alive.current) return;
+    intent.current = false;
+    setPendingPlay(false);
+    setPlaying(false);
+    setBusy(false);
+    setError("Audio could not be played. Try again.");
+    onPlaybackError?.();
+  }
+  async function play() {
+    const element = media.current;
+    if (!element || !intent.current) return;
+    try {
+      await element.play();
+    } catch (e) {
+      if (!alive.current || !intent.current) return;
+      if (e.name === "NotAllowedError") {
+        fail();
+        return;
+      }
+      await recover();
+    }
+  }
+  async function recover(manual = false) {
+    if (!alive.current || request.current) return;
+    if (!onRefresh || !manual && triedRefresh.current) {
+      fail();
+      return;
+    }
+    triedRefresh.current = true;
+    const controller = new AbortController();
+    request.current = controller;
+    resume.current = media.current?.currentTime ?? position;
+    setBusy(true);
+    setError(null);
+    try {
+      const fresh = await onRefresh(controller.signal);
+      if (!alive.current || controller.signal.aborted) return;
+      if (!fresh.url) throw new Error("No audio URL");
+      setDuration(durationOf(fresh) || duration);
+      if (fresh.url === source.url) {
+        media.current?.load();
+      } else {
+        setSource(fresh);
+      }
+    } catch {
+      if (!controller.signal.aborted) fail();
+    } finally {
+      if (request.current === controller) {
+        request.current = null;
+        if (alive.current) setBusy(false);
+      }
+    }
+  }
+  function toggle() {
+    if (intent.current || playing) {
+      intent.current = false;
+      setPendingPlay(false);
+      media.current?.pause();
+      return;
+    }
+    intent.current = true;
+    setPendingPlay(true);
+    triedRefresh.current = false;
+    setError(null);
+    if (exclusivePlayback)
+      document.dispatchEvent(
+        new CustomEvent(PLAY_EVENT, { detail: media.current })
+      );
+    if (request.current) return;
+    const expiry = Date.parse(source.expires_at ?? "");
+    if (onRefresh && Number.isFinite(expiry) && expiry - Date.now() <= 6e4) {
+      void recover();
+    } else {
+      void play();
+    }
+  }
+  function seek(value) {
+    if (!media.current || !duration || !Number.isFinite(value)) return;
+    const target = Math.max(0, Math.min(duration, value));
+    try {
+      media.current.currentTime = target;
+      resume.current = target;
+      setPosition(target);
+    } catch {
+    }
+  }
+  function changeSpeed() {
+    const next = SPEEDS[(SPEEDS.indexOf(rate.current) + 1) % SPEEDS.length];
+    rate.current = next;
+    setSpeed(next);
+    if (playbackRateStorageKey) {
+      try {
+        window.localStorage.setItem(playbackRateStorageKey, String(next));
+      } catch {
+      }
+    }
+  }
+  const peaks = useMemo(() => {
+    const input = source.waveform_peaks;
+    if (!input?.length) return [];
+    const count = Math.min(64, input.length);
+    return Array.from({ length: count }, (_, i) => {
+      const value = input[Math.floor(i * input.length / count)];
+      return Number.isFinite(value) ? Math.min(1, Math.max(0.08, Math.abs(value))) : 0.08;
+    });
+  }, [source.waveform_peaks]);
+  const current = Math.min(positive(position), duration || Infinity);
+  const progress = duration ? Math.max(0, Math.min(100, current / duration * 100)) : 0;
+  const remaining = duration ? `${time((duration - current) / speed)} remaining` : "Duration available when played";
+  const title = label ?? (source.ai_generated === false ? "Listen to narration" : "Listen to AI narration");
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: `sm-audio sm-audio--${variant}${className ? ` ${className}` : ""}`,
+      style,
+      role: "group",
+      "aria-labelledby": labelId,
+      "data-audio-variant": variant,
+      children: [
+        /* @__PURE__ */ jsx(
+          "audio",
+          {
+            ref: media,
+            src: source.url ?? void 0,
+            preload,
+            onLoadedMetadata: (e) => {
+              const element = e.currentTarget;
+              const total = positive(element.duration) || durationOf(source);
+              setDuration(total);
+              element.playbackRate = rate.current;
+              element.preservesPitch = true;
+              if (resume.current != null) {
+                try {
+                  element.currentTime = Math.min(
+                    resume.current,
+                    total || resume.current
+                  );
+                } catch {
+                }
+                resume.current = null;
+              }
+              setPosition(positive(element.currentTime));
+              if (intent.current) void play();
+            },
+            onDurationChange: (e) => {
+              const d = positive(e.currentTarget.duration);
+              if (d) setDuration(d);
+            },
+            onTimeUpdate: (e) => setPosition(positive(e.currentTarget.currentTime)),
+            onPlay: () => {
+              intent.current = true;
+              setPlaying(true);
+              setError(null);
+              if (exclusivePlayback)
+                document.dispatchEvent(
+                  new CustomEvent(PLAY_EVENT, { detail: media.current })
+                );
+            },
+            onPause: () => setPlaying(false),
+            onEnded: () => {
+              intent.current = false;
+              setPendingPlay(false);
+              setPlaying(false);
+              setPosition(duration);
+            },
+            onError: () => {
+              if (intent.current) void recover();
+              else if (!request.current) {
+                setError("Audio is unavailable. Press play to retry.");
+              }
+            }
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            className: "sm-audio__play",
+            onClick: toggle,
+            "aria-label": playing || busy && pendingPlay ? "Pause narration" : "Play narration",
+            children: playing || busy && pendingPlay ? /* @__PURE__ */ jsx("svg", { viewBox: "0 0 24 24", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M6 4h4v16H6zm8 0h4v16h-4z" }) }) : /* @__PURE__ */ jsx("svg", { viewBox: "0 0 24 24", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M8 4v16l12-8z" }) })
+          }
+        ),
+        /* @__PURE__ */ jsxs("div", { className: "sm-audio__content", children: [
+          /* @__PURE__ */ jsx("span", { className: "sm-audio__label", id: labelId, children: title }),
+          /* @__PURE__ */ jsxs("div", { className: "sm-audio__times", children: [
+            /* @__PURE__ */ jsxs("span", { children: [
+              time(current),
+              " ",
+              /* @__PURE__ */ jsx("span", { className: "sm-audio__elapsed", children: "elapsed" })
+            ] }),
+            /* @__PURE__ */ jsx("span", { children: remaining })
+          ] }),
+          variant !== "inline" && /* @__PURE__ */ jsxs(
+            "div",
+            {
+              className: "sm-audio__seek",
+              style: { "--sm-audio-progress": `${progress}%` },
+              children: [
+                variant === "waveform" && peaks.length > 0 && /* @__PURE__ */ jsx("div", { className: "sm-audio__waveform", "aria-hidden": "true", children: peaks.map((peak, i) => /* @__PURE__ */ jsx(
+                  "span",
+                  {
+                    style: {
+                      height: `${peak * 100}%`,
+                      background: (i + 0.5) / peaks.length * 100 <= progress ? "var(--sm-audio-accent)" : "var(--sm-audio-wave)"
+                    }
+                  },
+                  i
+                )) }),
+                /* @__PURE__ */ jsx("label", { className: "sm-audio__sr", htmlFor: sliderId, children: "Seek narration" }),
+                /* @__PURE__ */ jsx(
+                  "input",
+                  {
+                    id: sliderId,
+                    className: "sm-audio__range",
+                    type: "range",
+                    min: "0",
+                    max: duration || 1,
+                    step: "0.1",
+                    disabled: !duration,
+                    value: Math.min(current, duration || 1),
+                    "aria-valuetext": `${time(current)} elapsed; ${remaining}`,
+                    onChange: (e) => seek(Number(e.currentTarget.value))
+                  }
+                )
+              ]
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsxs("div", { className: "sm-audio__actions", children: [
+          /* @__PURE__ */ jsxs(
+            "button",
+            {
+              type: "button",
+              className: "sm-audio__speed",
+              onClick: changeSpeed,
+              "aria-label": `Change playback speed (current ${speed}\xD7)`,
+              children: [
+                speed,
+                "\xD7"
+              ]
+            }
+          ),
+          onRefresh && showRefreshButton && /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: "sm-audio__refresh",
+              disabled: busy,
+              onClick: () => void recover(true),
+              children: "Refresh"
+            }
+          )
+        ] }),
+        (busy || error) && /* @__PURE__ */ jsx("p", { className: "sm-audio__status", role: "status", children: busy ? "Refreshing audio\u2026" : error })
+      ]
+    }
+  );
+}
+export {
+  AudioPlayer
+};

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { a8 as StorageAdapter, A as ApiError } from './index-Tq5WdDfS.mjs';
+import { a8 as StorageAdapter, A as ApiError } from './index-Bv1m_qQ8.mjs';
 
 /**
  * ScaleMule API Client

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { a8 as StorageAdapter, A as ApiError } from './index-Tq5WdDfS.js';
+import { a8 as StorageAdapter, A as ApiError } from './index-Bv1m_qQ8.js';
 
 /**
  * ScaleMule API Client

package/dist/client.js

@@ -12,9 +12,31 @@ var ScaleMuleApiError = class extends Error {
     this.code = error.code;
     this.field = error.field;
     this.status = status;
+    this.requestId = error.requestId;
+    this.traceId = error.traceId;
+    this.problem = error.problem;
   }
 };
 
+// src/error-context.ts
+function withErrorContext(error, responseData, headers) {
+  const enriched = { ...error };
+  const meta = responseData?.meta;
+  const requestId = meta?.request_id ?? headers?.get("x-request-id") ?? void 0;
+  if (requestId !== void 0 && enriched.requestId === void 0) {
+    enriched.requestId = requestId;
+  }
+  const traceId = meta?.trace_id;
+  if (traceId !== void 0 && enriched.traceId === void 0) {
+    enriched.traceId = traceId;
+  }
+  const rawError = responseData?.error;
+  if (rawError !== null && typeof rawError === "object" && enriched.problem === void 0) {
+    enriched.problem = rawError;
+  }
+  return enriched;
+}
+
 // src/client.ts
 var GATEWAY_URLS = {
   dev: "https://api-dev.scalemule.com",
@@ -591,7 +613,8 @@ var ScaleMuleClient = class {
         }
         if (!response.ok) {
           const rawError = responseData?.error;
-          const error = rawError && typeof rawError === "object" ? rawError : { code: `HTTP_${response.status}`, message: typeof rawError === "string" ? rawError : responseData?.message || text || response.statusText };
+          const baseError = rawError && typeof rawError === "object" ? rawError : { code: `HTTP_${response.status}`, message: typeof rawError === "string" ? rawError : responseData?.message || text || response.statusText };
+          const error = withErrorContext(baseError, responseData, response.headers);
           if (response.status === 401 && this.sessionToken && !options.isAutoRefresh && refreshAttempts < MAX_REFRESH_ATTEMPTS) {
             refreshAttempts++;
             if (this.debug) console.log("[ScaleMule] 401 received, attempting auto-refresh...");
@@ -853,10 +876,17 @@ var ScaleMuleClient = class {
             const unwrapped = data?.data !== void 0 ? data.data : data;
             resolve(unwrapped);
           } else {
-            reject(new ScaleMuleApiError(data?.error || {
+            const uploadError = data?.error || {
               code: `HTTP_${xhr.status}`,
               message: data?.message || xhr.responseText || "Upload failed"
-            }));
+            };
+            reject(
+              new ScaleMuleApiError(
+                withErrorContext(uploadError, data, {
+                  get: (name) => xhr.getResponseHeader(name)
+                })
+              )
+            );
           }
         } catch {
           reject(new ScaleMuleApiError({ code: "PARSE_ERROR", message: "Failed to parse response" }));

package/dist/client.mjs

@@ -10,9 +10,31 @@ var ScaleMuleApiError = class extends Error {
     this.code = error.code;
     this.field = error.field;
     this.status = status;
+    this.requestId = error.requestId;
+    this.traceId = error.traceId;
+    this.problem = error.problem;
   }
 };
 
+// src/error-context.ts
+function withErrorContext(error, responseData, headers) {
+  const enriched = { ...error };
+  const meta = responseData?.meta;
+  const requestId = meta?.request_id ?? headers?.get("x-request-id") ?? void 0;
+  if (requestId !== void 0 && enriched.requestId === void 0) {
+    enriched.requestId = requestId;
+  }
+  const traceId = meta?.trace_id;
+  if (traceId !== void 0 && enriched.traceId === void 0) {
+    enriched.traceId = traceId;
+  }
+  const rawError = responseData?.error;
+  if (rawError !== null && typeof rawError === "object" && enriched.problem === void 0) {
+    enriched.problem = rawError;
+  }
+  return enriched;
+}
+
 // src/client.ts
 var GATEWAY_URLS = {
   dev: "https://api-dev.scalemule.com",
@@ -589,7 +611,8 @@ var ScaleMuleClient = class {
         }
         if (!response.ok) {
           const rawError = responseData?.error;
-          const error = rawError && typeof rawError === "object" ? rawError : { code: `HTTP_${response.status}`, message: typeof rawError === "string" ? rawError : responseData?.message || text || response.statusText };
+          const baseError = rawError && typeof rawError === "object" ? rawError : { code: `HTTP_${response.status}`, message: typeof rawError === "string" ? rawError : responseData?.message || text || response.statusText };
+          const error = withErrorContext(baseError, responseData, response.headers);
           if (response.status === 401 && this.sessionToken && !options.isAutoRefresh && refreshAttempts < MAX_REFRESH_ATTEMPTS) {
             refreshAttempts++;
             if (this.debug) console.log("[ScaleMule] 401 received, attempting auto-refresh...");
@@ -851,10 +874,17 @@ var ScaleMuleClient = class {
             const unwrapped = data?.data !== void 0 ? data.data : data;
             resolve(unwrapped);
           } else {
-            reject(new ScaleMuleApiError(data?.error || {
+            const uploadError = data?.error || {
               code: `HTTP_${xhr.status}`,
               message: data?.message || xhr.responseText || "Upload failed"
-            }));
+            };
+            reject(
+              new ScaleMuleApiError(
+                withErrorContext(uploadError, data, {
+                  get: (name) => xhr.getResponseHeader(name)
+                })
+              )
+            );
           }
         } catch {
           reject(new ScaleMuleApiError({ code: "PARSE_ERROR", message: "Failed to parse response" }));

package/dist/{index-Tq5WdDfS.d.mts → index-Bv1m_qQ8.d.mts}

@@ -121,6 +121,20 @@ declare class ScaleMuleApiError extends Error {
     status?: number;
     field?: string;
     details?: unknown;
+    /**
+     * Correlation id for the failed request. Comes from the response envelope
+     * (`meta.request_id`), falling back to the `x-request-id` response header
+     * echoed by the gateway. Surface this in support flows.
+     */
+    requestId?: string;
+    /** Distributed-trace id, when the backend supplies `meta.trace_id`. */
+    traceId?: string;
+    /**
+     * The raw `error` object from the response body, unmodified. Escape hatch
+     * for consumers (such as `@scalemule/signals` `fromError`) that need fields
+     * this class does not model yet.
+     */
+    problem?: unknown;
     constructor(error: ApiError, status?: number);
 }
 interface ApiResponse<T> {
@@ -132,6 +146,12 @@ interface ApiError {
     code: string;
     message: string;
     field?: string;
+    /** Correlation id: envelope `meta.request_id`, else the `x-request-id` header. */
+    requestId?: string;
+    /** Distributed-trace id from envelope `meta.trace_id`. */
+    traceId?: string;
+    /** The raw body `error` object, passed through untouched. */
+    problem?: unknown;
 }
 interface User {
     id: string;

package/dist/{index-Tq5WdDfS.d.ts → index-Bv1m_qQ8.d.ts}

@@ -121,6 +121,20 @@ declare class ScaleMuleApiError extends Error {
     status?: number;
     field?: string;
     details?: unknown;
+    /**
+     * Correlation id for the failed request. Comes from the response envelope
+     * (`meta.request_id`), falling back to the `x-request-id` response header
+     * echoed by the gateway. Surface this in support flows.
+     */
+    requestId?: string;
+    /** Distributed-trace id, when the backend supplies `meta.trace_id`. */
+    traceId?: string;
+    /**
+     * The raw `error` object from the response body, unmodified. Escape hatch
+     * for consumers (such as `@scalemule/signals` `fromError`) that need fields
+     * this class does not model yet.
+     */
+    problem?: unknown;
     constructor(error: ApiError, status?: number);
 }
 interface ApiResponse<T> {
@@ -132,6 +146,12 @@ interface ApiError {
     code: string;
     message: string;
     field?: string;
+    /** Correlation id: envelope `meta.request_id`, else the `x-request-id` header. */
+    requestId?: string;
+    /** Distributed-trace id from envelope `meta.trace_id`. */
+    traceId?: string;
+    /** The raw body `error` object, passed through untouched. */
+    problem?: unknown;
 }
 interface User {
     id: string;

package/dist/index.d.mts

@@ -6,8 +6,8 @@ import { MoneyClient } from '@scalemule/money';
 export { MoneyClient, MoneyClientConfig, createMoneyClient } from '@scalemule/money';
 import { ScaleMuleClient } from './client.mjs';
 export { ClientConfig, RequestOptions, createClient } from './client.mjs';
-import { S as ScaleMuleConfig, U as User, L as LoginResponse, A as ApiError$1, a as UseAuthReturn, b as UseBillingReturn, c as ListFilesParams, d as UseContentReturn, e as UseUserReturn, f as UseAnalyticsOptions, g as UseAnalyticsReturn } from './index-Tq5WdDfS.mjs';
-export { h as AccountBalance, i as AnalyticsEvent, j as ApiResponse, B as BatchTrackRequest, k as BillingPayment, l as BillingPayout, m as BillingRefund, n as BillingTransaction, C as ChangeEmailRequest, o as ChangePasswordRequest, p as ClientContext, q as ConnectedAccount, D as DeviceFingerprint, r as DeviceInfo, E as EnhancedAnalyticsEvent, F as ForgotPasswordRequest, K as KnownAccountInfo, s as LinkedAccount, t as ListFilesResponse, u as LoginDeviceInfo, v as LoginRequest, w as LoginResponseWithMFA, x as LoginRiskInfo, M as MFAChallengeResponse, y as MFAMethod, z as MFASMSSetupResponse, G as MFASetupRequest, H as MFAStatus, I as MFATOTPSetupResponse, J as MFAVerifyRequest, O as OAuthCallbackRequest, N as OAuthCallbackResponse, P as OAuthConfig, Q as OAuthProvider, R as OAuthStartResponse, T as PageViewData, V as PayoutSchedule, W as PhoneLoginRequest, X as PhoneSendCodeRequest, Y as PhoneVerifyRequest, Z as Profile, _ as RefreshResponse, $ as RegisterRequest, a0 as ResetPasswordRequest, a1 as ScaleMuleApiError, a2 as ScaleMuleEnvironment, a3 as Session, a4 as SignedUploadCompleteRequest, a5 as SignedUploadRequest, a6 as SignedUploadResponse, a7 as SignedUploadUrl, a8 as StorageAdapter, a9 as StorageFile, aa as TrackEventResponse, ab as TransactionSummary, ac as UTMParams, ad as UpdateProfileRequest, ae as UploadOptions, af as UploadResponse, ag as VerifyEmailRequest } from './index-Tq5WdDfS.mjs';
+import { S as ScaleMuleConfig, U as User, L as LoginResponse, A as ApiError$1, a as UseAuthReturn, b as UseBillingReturn, c as ListFilesParams, d as UseContentReturn, e as UseUserReturn, f as UseAnalyticsOptions, g as UseAnalyticsReturn } from './index-Bv1m_qQ8.mjs';
+export { h as AccountBalance, i as AnalyticsEvent, j as ApiResponse, B as BatchTrackRequest, k as BillingPayment, l as BillingPayout, m as BillingRefund, n as BillingTransaction, C as ChangeEmailRequest, o as ChangePasswordRequest, p as ClientContext, q as ConnectedAccount, D as DeviceFingerprint, r as DeviceInfo, E as EnhancedAnalyticsEvent, F as ForgotPasswordRequest, K as KnownAccountInfo, s as LinkedAccount, t as ListFilesResponse, u as LoginDeviceInfo, v as LoginRequest, w as LoginResponseWithMFA, x as LoginRiskInfo, M as MFAChallengeResponse, y as MFAMethod, z as MFASMSSetupResponse, G as MFASetupRequest, H as MFAStatus, I as MFATOTPSetupResponse, J as MFAVerifyRequest, O as OAuthCallbackRequest, N as OAuthCallbackResponse, P as OAuthConfig, Q as OAuthProvider, R as OAuthStartResponse, T as PageViewData, V as PayoutSchedule, W as PhoneLoginRequest, X as PhoneSendCodeRequest, Y as PhoneVerifyRequest, Z as Profile, _ as RefreshResponse, $ as RegisterRequest, a0 as ResetPasswordRequest, a1 as ScaleMuleApiError, a2 as ScaleMuleEnvironment, a3 as Session, a4 as SignedUploadCompleteRequest, a5 as SignedUploadRequest, a6 as SignedUploadResponse, a7 as SignedUploadUrl, a8 as StorageAdapter, a9 as StorageFile, aa as TrackEventResponse, ab as TransactionSummary, ac as UTMParams, ad as UpdateProfileRequest, ae as UploadOptions, af as UploadResponse, ag as VerifyEmailRequest } from './index-Bv1m_qQ8.mjs';
 
 /**
  * Tri-state file visibility — `'private' | 'app_public' | 'anonymous_visible'`.

package/dist/index.d.ts

@@ -6,8 +6,8 @@ import { MoneyClient } from '@scalemule/money';
 export { MoneyClient, MoneyClientConfig, createMoneyClient } from '@scalemule/money';
 import { ScaleMuleClient } from './client.js';
 export { ClientConfig, RequestOptions, createClient } from './client.js';
-import { S as ScaleMuleConfig, U as User, L as LoginResponse, A as ApiError$1, a as UseAuthReturn, b as UseBillingReturn, c as ListFilesParams, d as UseContentReturn, e as UseUserReturn, f as UseAnalyticsOptions, g as UseAnalyticsReturn } from './index-Tq5WdDfS.js';
-export { h as AccountBalance, i as AnalyticsEvent, j as ApiResponse, B as BatchTrackRequest, k as BillingPayment, l as BillingPayout, m as BillingRefund, n as BillingTransaction, C as ChangeEmailRequest, o as ChangePasswordRequest, p as ClientContext, q as ConnectedAccount, D as DeviceFingerprint, r as DeviceInfo, E as EnhancedAnalyticsEvent, F as ForgotPasswordRequest, K as KnownAccountInfo, s as LinkedAccount, t as ListFilesResponse, u as LoginDeviceInfo, v as LoginRequest, w as LoginResponseWithMFA, x as LoginRiskInfo, M as MFAChallengeResponse, y as MFAMethod, z as MFASMSSetupResponse, G as MFASetupRequest, H as MFAStatus, I as MFATOTPSetupResponse, J as MFAVerifyRequest, O as OAuthCallbackRequest, N as OAuthCallbackResponse, P as OAuthConfig, Q as OAuthProvider, R as OAuthStartResponse, T as PageViewData, V as PayoutSchedule, W as PhoneLoginRequest, X as PhoneSendCodeRequest, Y as PhoneVerifyRequest, Z as Profile, _ as RefreshResponse, $ as RegisterRequest, a0 as ResetPasswordRequest, a1 as ScaleMuleApiError, a2 as ScaleMuleEnvironment, a3 as Session, a4 as SignedUploadCompleteRequest, a5 as SignedUploadRequest, a6 as SignedUploadResponse, a7 as SignedUploadUrl, a8 as StorageAdapter, a9 as StorageFile, aa as TrackEventResponse, ab as TransactionSummary, ac as UTMParams, ad as UpdateProfileRequest, ae as UploadOptions, af as UploadResponse, ag as VerifyEmailRequest } from './index-Tq5WdDfS.js';
+import { S as ScaleMuleConfig, U as User, L as LoginResponse, A as ApiError$1, a as UseAuthReturn, b as UseBillingReturn, c as ListFilesParams, d as UseContentReturn, e as UseUserReturn, f as UseAnalyticsOptions, g as UseAnalyticsReturn } from './index-Bv1m_qQ8.js';
+export { h as AccountBalance, i as AnalyticsEvent, j as ApiResponse, B as BatchTrackRequest, k as BillingPayment, l as BillingPayout, m as BillingRefund, n as BillingTransaction, C as ChangeEmailRequest, o as ChangePasswordRequest, p as ClientContext, q as ConnectedAccount, D as DeviceFingerprint, r as DeviceInfo, E as EnhancedAnalyticsEvent, F as ForgotPasswordRequest, K as KnownAccountInfo, s as LinkedAccount, t as ListFilesResponse, u as LoginDeviceInfo, v as LoginRequest, w as LoginResponseWithMFA, x as LoginRiskInfo, M as MFAChallengeResponse, y as MFAMethod, z as MFASMSSetupResponse, G as MFASetupRequest, H as MFAStatus, I as MFATOTPSetupResponse, J as MFAVerifyRequest, O as OAuthCallbackRequest, N as OAuthCallbackResponse, P as OAuthConfig, Q as OAuthProvider, R as OAuthStartResponse, T as PageViewData, V as PayoutSchedule, W as PhoneLoginRequest, X as PhoneSendCodeRequest, Y as PhoneVerifyRequest, Z as Profile, _ as RefreshResponse, $ as RegisterRequest, a0 as ResetPasswordRequest, a1 as ScaleMuleApiError, a2 as ScaleMuleEnvironment, a3 as Session, a4 as SignedUploadCompleteRequest, a5 as SignedUploadRequest, a6 as SignedUploadResponse, a7 as SignedUploadUrl, a8 as StorageAdapter, a9 as StorageFile, aa as TrackEventResponse, ab as TransactionSummary, ac as UTMParams, ad as UpdateProfileRequest, ae as UploadOptions, af as UploadResponse, ag as VerifyEmailRequest } from './index-Bv1m_qQ8.js';
 
 /**
  * Tri-state file visibility — `'private' | 'app_public' | 'anonymous_visible'`.

package/dist/index.js

@@ -35,9 +35,31 @@ var ScaleMuleApiError = class extends Error {
     this.code = error.code;
     this.field = error.field;
     this.status = status;
+    this.requestId = error.requestId;
+    this.traceId = error.traceId;
+    this.problem = error.problem;
   }
 };
 
+// src/error-context.ts
+function withErrorContext(error, responseData, headers) {
+  const enriched = { ...error };
+  const meta = responseData?.meta;
+  const requestId = meta?.request_id ?? headers?.get("x-request-id") ?? void 0;
+  if (requestId !== void 0 && enriched.requestId === void 0) {
+    enriched.requestId = requestId;
+  }
+  const traceId = meta?.trace_id;
+  if (traceId !== void 0 && enriched.traceId === void 0) {
+    enriched.traceId = traceId;
+  }
+  const rawError = responseData?.error;
+  if (rawError !== null && typeof rawError === "object" && enriched.problem === void 0) {
+    enriched.problem = rawError;
+  }
+  return enriched;
+}
+
 // src/client.ts
 var GATEWAY_URLS = {
   dev: "https://api-dev.scalemule.com",
@@ -614,7 +636,8 @@ var ScaleMuleClient = class {
         }
         if (!response.ok) {
           const rawError = responseData?.error;
-          const error = rawError && typeof rawError === "object" ? rawError : { code: `HTTP_${response.status}`, message: typeof rawError === "string" ? rawError : responseData?.message || text || response.statusText };
+          const baseError = rawError && typeof rawError === "object" ? rawError : { code: `HTTP_${response.status}`, message: typeof rawError === "string" ? rawError : responseData?.message || text || response.statusText };
+          const error = withErrorContext(baseError, responseData, response.headers);
           if (response.status === 401 && this.sessionToken && !options.isAutoRefresh && refreshAttempts < MAX_REFRESH_ATTEMPTS) {
             refreshAttempts++;
             if (this.debug) console.log("[ScaleMule] 401 received, attempting auto-refresh...");
@@ -876,10 +899,17 @@ var ScaleMuleClient = class {
             const unwrapped = data?.data !== void 0 ? data.data : data;
             resolve(unwrapped);
           } else {
-            reject(new ScaleMuleApiError(data?.error || {
+            const uploadError = data?.error || {
               code: `HTTP_${xhr.status}`,
               message: data?.message || xhr.responseText || "Upload failed"
-            }));
+            };
+            reject(
+              new ScaleMuleApiError(
+                withErrorContext(uploadError, data, {
+                  get: (name) => xhr.getResponseHeader(name)
+                })
+              )
+            );
           }
         } catch {
           reject(new ScaleMuleApiError({ code: "PARSE_ERROR", message: "Failed to parse response" }));