@scalemule/nextjs 0.1.39 → 0.1.40

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" }));

package/dist/index.mjs

@@ -15,9 +15,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",
@@ -594,7 +616,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...");
@@ -856,10 +879,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/server/auth.js

@@ -12,6 +12,9 @@ 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;
   }
 };
 
@@ -106,6 +109,25 @@ function buildClientContextHeaders(context) {
   return headers2;
 }
 
+// src/error-context.ts
+function withErrorContext(error, responseData, headers2) {
+  const enriched = { ...error };
+  const meta = responseData?.meta;
+  const requestId = meta?.request_id ?? headers2?.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/server/client.ts
 var GATEWAY_URLS = {
   dev: "https://api-dev.scalemule.com",
@@ -525,7 +547,11 @@ var ScaleMuleServer = class {
           }
           if (!response.ok) {
             throw new ScaleMuleApiError(
-              responseData?.error || { code: "UPLOAD_FAILED", message: text || "Upload failed" }
+              withErrorContext(
+                responseData?.error || { code: "UPLOAD_FAILED", message: text || "Upload failed" },
+                responseData,
+                response.headers
+              )
             );
           }
           const data = responseData?.data !== void 0 ? responseData.data : responseData;
@@ -768,10 +794,11 @@ var ScaleMuleServer = class {
       } catch {
       }
       if (!response.ok) {
-        const error = responseData?.error || {
+        const baseError = responseData?.error || {
           code: `HTTP_${response.status}`,
           message: responseData?.message || text || response.statusText
         };
+        const error = withErrorContext(baseError, responseData, response.headers);
         if (response.status === 401 && options.sessionToken && !options.isAutoRefresh) {
           if (this.debug) console.log("[ScaleMule Server] 401 received, attempting auto-refresh...");
           try {

package/dist/server/auth.mjs

@@ -10,6 +10,9 @@ 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;
   }
 };
 
@@ -104,6 +107,25 @@ function buildClientContextHeaders(context) {
   return headers2;
 }
 
+// src/error-context.ts
+function withErrorContext(error, responseData, headers2) {
+  const enriched = { ...error };
+  const meta = responseData?.meta;
+  const requestId = meta?.request_id ?? headers2?.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/server/client.ts
 var GATEWAY_URLS = {
   dev: "https://api-dev.scalemule.com",
@@ -523,7 +545,11 @@ var ScaleMuleServer = class {
           }
           if (!response.ok) {
             throw new ScaleMuleApiError(
-              responseData?.error || { code: "UPLOAD_FAILED", message: text || "Upload failed" }
+              withErrorContext(
+                responseData?.error || { code: "UPLOAD_FAILED", message: text || "Upload failed" },
+                responseData,
+                response.headers
+              )
             );
           }
           const data = responseData?.data !== void 0 ? responseData.data : responseData;
@@ -766,10 +792,11 @@ var ScaleMuleServer = class {
       } catch {
       }
       if (!response.ok) {
-        const error = responseData?.error || {
+        const baseError = responseData?.error || {
           code: `HTTP_${response.status}`,
           message: responseData?.message || text || response.statusText
         };
+        const error = withErrorContext(baseError, responseData, response.headers);
         if (response.status === 401 && options.sessionToken && !options.isAutoRefresh) {
           if (this.debug) console.log("[ScaleMule Server] 401 received, attempting auto-refresh...");
           try {

package/dist/server/index.d.mts

@@ -1,6 +1,6 @@
-import { S as ServerConfig } from '../webhook-handler-DN4WBjbm.mjs';
-export { a as ScaleMuleServer, V as VideoFailedEvent, b as VideoReadyEvent, c as VideoTranscodedEvent, d as VideoUploadedEvent, W as WebhookEvent, e as WebhookRoutesConfig, f as createServerClient, g as createWebhookHandler, h as createWebhookRoutes, p as parseWebhookEvent, r as registerVideoWebhook, i as resolveGatewayUrl, v as verifyWebhookSignature } from '../webhook-handler-DN4WBjbm.mjs';
-import { p as ClientContext, A as ApiError } from '../index-Tq5WdDfS.mjs';
+import { S as ServerConfig } from '../webhook-handler-CVmBvPFN.mjs';
+export { a as ScaleMuleServer, V as VideoFailedEvent, b as VideoReadyEvent, c as VideoTranscodedEvent, d as VideoUploadedEvent, W as WebhookEvent, e as WebhookRoutesConfig, f as createServerClient, g as createWebhookHandler, h as createWebhookRoutes, p as parseWebhookEvent, r as registerVideoWebhook, i as resolveGatewayUrl, v as verifyWebhookSignature } from '../webhook-handler-CVmBvPFN.mjs';
+import { p as ClientContext, A as ApiError } from '../index-Bv1m_qQ8.mjs';
 export { L as LedveryRoutesConfig, a as LedverySessionData, S as SM_LEDVERY_ACCESS_TOKEN_COOKIE, b as SM_LEDVERY_ID_TOKEN_COOKIE, c as SM_LEDVERY_NONCE_COOKIE, d as SM_LEDVERY_PKCE_VERIFIER_COOKIE, e as SM_LEDVERY_STATE_COOKIE, f as createLedveryRoutes, g as getLedverySession } from '../ledvery-CxPzZpxP.mjs';
 import { NextRequest, NextResponse } from 'next/server';
 import '@scalemule/money';
@@ -509,7 +509,21 @@ declare class ScaleMuleError extends Error {
     readonly code: string;
     readonly status: number;
     readonly details?: Record<string, unknown> | undefined;
-    constructor(code: string, message: string, status?: number, details?: Record<string, unknown> | undefined);
+    /**
+     * Correlation id of the upstream platform request that produced this
+     * error, when there was one. `apiHandler()` echoes it back to the browser
+     * as `meta.request_id` so a client-side failure can be traced all the way
+     * through the route handler to the platform service.
+     */
+    readonly requestId?: string | undefined;
+    constructor(code: string, message: string, status?: number, details?: Record<string, unknown> | undefined, 
+    /**
+     * Correlation id of the upstream platform request that produced this
+     * error, when there was one. `apiHandler()` echoes it back to the browser
+     * as `meta.request_id` so a client-side failure can be traced all the way
+     * through the route handler to the platform service.
+     */
+    requestId?: string | undefined);
 }
 declare function errorCodeToStatus(code: string): number;
 /**
@@ -521,6 +535,12 @@ type SdkResult<T> = {
     data?: T | null;
     error?: ApiError | null;
     success?: boolean;
+    /** Platform envelope metadata; `request_id` is echoed onto ScaleMuleError. */
+    meta?: {
+        request_id?: string;
+        trace_id?: string;
+        timestamp?: string;
+    };
 };
 /**
  * Convert an SDK result into throw-on-error, or pass through a raw value.

package/dist/server/index.d.ts

@@ -1,6 +1,6 @@
-import { S as ServerConfig } from '../webhook-handler-Cfa7-yKN.js';
-export { a as ScaleMuleServer, V as VideoFailedEvent, b as VideoReadyEvent, c as VideoTranscodedEvent, d as VideoUploadedEvent, W as WebhookEvent, e as WebhookRoutesConfig, f as createServerClient, g as createWebhookHandler, h as createWebhookRoutes, p as parseWebhookEvent, r as registerVideoWebhook, i as resolveGatewayUrl, v as verifyWebhookSignature } from '../webhook-handler-Cfa7-yKN.js';
-import { p as ClientContext, A as ApiError } from '../index-Tq5WdDfS.js';
+import { S as ServerConfig } from '../webhook-handler-5ymVecTD.js';
+export { a as ScaleMuleServer, V as VideoFailedEvent, b as VideoReadyEvent, c as VideoTranscodedEvent, d as VideoUploadedEvent, W as WebhookEvent, e as WebhookRoutesConfig, f as createServerClient, g as createWebhookHandler, h as createWebhookRoutes, p as parseWebhookEvent, r as registerVideoWebhook, i as resolveGatewayUrl, v as verifyWebhookSignature } from '../webhook-handler-5ymVecTD.js';
+import { p as ClientContext, A as ApiError } from '../index-Bv1m_qQ8.js';
 export { L as LedveryRoutesConfig, a as LedverySessionData, S as SM_LEDVERY_ACCESS_TOKEN_COOKIE, b as SM_LEDVERY_ID_TOKEN_COOKIE, c as SM_LEDVERY_NONCE_COOKIE, d as SM_LEDVERY_PKCE_VERIFIER_COOKIE, e as SM_LEDVERY_STATE_COOKIE, f as createLedveryRoutes, g as getLedverySession } from '../ledvery-CxPzZpxP.js';
 import { NextRequest, NextResponse } from 'next/server';
 import '@scalemule/money';
@@ -509,7 +509,21 @@ declare class ScaleMuleError extends Error {
     readonly code: string;
     readonly status: number;
     readonly details?: Record<string, unknown> | undefined;
-    constructor(code: string, message: string, status?: number, details?: Record<string, unknown> | undefined);
+    /**
+     * Correlation id of the upstream platform request that produced this
+     * error, when there was one. `apiHandler()` echoes it back to the browser
+     * as `meta.request_id` so a client-side failure can be traced all the way
+     * through the route handler to the platform service.
+     */
+    readonly requestId?: string | undefined;
+    constructor(code: string, message: string, status?: number, details?: Record<string, unknown> | undefined, 
+    /**
+     * Correlation id of the upstream platform request that produced this
+     * error, when there was one. `apiHandler()` echoes it back to the browser
+     * as `meta.request_id` so a client-side failure can be traced all the way
+     * through the route handler to the platform service.
+     */
+    requestId?: string | undefined);
 }
 declare function errorCodeToStatus(code: string): number;
 /**
@@ -521,6 +535,12 @@ type SdkResult<T> = {
     data?: T | null;
     error?: ApiError | null;
     success?: boolean;
+    /** Platform envelope metadata; `request_id` is echoed onto ScaleMuleError. */
+    meta?: {
+        request_id?: string;
+        trace_id?: string;
+        timestamp?: string;
+    };
 };
 /**
  * Convert an SDK result into throw-on-error, or pass through a raw value.

package/dist/server/index.js

@@ -17,6 +17,9 @@ 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;
   }
 };
 
@@ -179,6 +182,25 @@ function buildFlagContext(clientContext, extraContext = {}) {
   return context;
 }
 
+// src/error-context.ts
+function withErrorContext(error, responseData, headers3) {
+  const enriched = { ...error };
+  const meta = responseData?.meta;
+  const requestId = meta?.request_id ?? headers3?.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/server/client.ts
 var GATEWAY_URLS = {
   dev: "https://api-dev.scalemule.com",
@@ -598,7 +620,11 @@ var ScaleMuleServer = class {
           }
           if (!response.ok) {
             throw new ScaleMuleApiError(
-              responseData?.error || { code: "UPLOAD_FAILED", message: text || "Upload failed" }
+              withErrorContext(
+                responseData?.error || { code: "UPLOAD_FAILED", message: text || "Upload failed" },
+                responseData,
+                response.headers
+              )
             );
           }
           const data = responseData?.data !== void 0 ? responseData.data : responseData;
@@ -841,10 +867,11 @@ var ScaleMuleServer = class {
       } catch {
       }
       if (!response.ok) {
-        const error = responseData?.error || {
+        const baseError = responseData?.error || {
           code: `HTTP_${response.status}`,
           message: responseData?.message || text || response.statusText
         };
+        const error = withErrorContext(baseError, responseData, response.headers);
         if (response.status === 401 && options.sessionToken && !options.isAutoRefresh) {
           if (this.debug) console.log("[ScaleMule Server] 401 received, attempting auto-refresh...");
           try {
@@ -2537,11 +2564,12 @@ function createNotificationRoutes(config) {
 
 // src/server/errors.ts
 var ScaleMuleError = class extends Error {
-  constructor(code, message, status = 400, details) {
+  constructor(code, message, status = 400, details, requestId) {
     super(message);
     this.code = code;
     this.status = status;
     this.details = details;
+    this.requestId = requestId;
     this.name = "ScaleMuleError";
   }
 };
@@ -2595,7 +2623,8 @@ function unwrap(result) {
         code,
         err?.message || "An error occurred",
         status,
-        err?.details
+        err?.details,
+        err?.requestId ?? envelope.meta?.request_id
       );
     }
     return envelope.data;
@@ -2644,7 +2673,11 @@ function apiHandler(handler, options) {
           console.error("Internal API error:", error.message);
         }
         return Response.json(
-          { success: false, error: { code: error.code, message: safeMessage } },
+          {
+            success: false,
+            error: { code: error.code, message: safeMessage },
+            ...error.requestId ? { meta: { request_id: error.requestId } } : {}
+          },
           { status: error.status }
         );
       }

package/dist/server/index.mjs

@@ -15,6 +15,9 @@ 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;
   }
 };
 
@@ -177,6 +180,25 @@ function buildFlagContext(clientContext, extraContext = {}) {
   return context;
 }
 
+// src/error-context.ts
+function withErrorContext(error, responseData, headers3) {
+  const enriched = { ...error };
+  const meta = responseData?.meta;
+  const requestId = meta?.request_id ?? headers3?.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/server/client.ts
 var GATEWAY_URLS = {
   dev: "https://api-dev.scalemule.com",
@@ -596,7 +618,11 @@ var ScaleMuleServer = class {
           }
           if (!response.ok) {
             throw new ScaleMuleApiError(
-              responseData?.error || { code: "UPLOAD_FAILED", message: text || "Upload failed" }
+              withErrorContext(
+                responseData?.error || { code: "UPLOAD_FAILED", message: text || "Upload failed" },
+                responseData,
+                response.headers
+              )
             );
           }
           const data = responseData?.data !== void 0 ? responseData.data : responseData;
@@ -839,10 +865,11 @@ var ScaleMuleServer = class {
       } catch {
       }
       if (!response.ok) {
-        const error = responseData?.error || {
+        const baseError = responseData?.error || {
           code: `HTTP_${response.status}`,
           message: responseData?.message || text || response.statusText
         };
+        const error = withErrorContext(baseError, responseData, response.headers);
         if (response.status === 401 && options.sessionToken && !options.isAutoRefresh) {
           if (this.debug) console.log("[ScaleMule Server] 401 received, attempting auto-refresh...");
           try {
@@ -2535,11 +2562,12 @@ function createNotificationRoutes(config) {
 
 // src/server/errors.ts
 var ScaleMuleError = class extends Error {
-  constructor(code, message, status = 400, details) {
+  constructor(code, message, status = 400, details, requestId) {
     super(message);
     this.code = code;
     this.status = status;
     this.details = details;
+    this.requestId = requestId;
     this.name = "ScaleMuleError";
   }
 };
@@ -2593,7 +2621,8 @@ function unwrap(result) {
         code,
         err?.message || "An error occurred",
         status,
-        err?.details
+        err?.details,
+        err?.requestId ?? envelope.meta?.request_id
       );
     }
     return envelope.data;
@@ -2642,7 +2671,11 @@ function apiHandler(handler, options) {
           console.error("Internal API error:", error.message);
         }
         return Response.json(
-          { success: false, error: { code: error.code, message: safeMessage } },
+          {
+            success: false,
+            error: { code: error.code, message: safeMessage },
+            ...error.requestId ? { meta: { request_id: error.requestId } } : {}
+          },
           { status: error.status }
         );
       }

package/dist/server/webhook-handler.d.mts

@@ -1,3 +1,3 @@
-export { g as createWebhookHandler } from '../webhook-handler-DN4WBjbm.mjs';
+export { g as createWebhookHandler } from '../webhook-handler-CVmBvPFN.mjs';
 import '@scalemule/money';
-import '../index-Tq5WdDfS.mjs';
+import '../index-Bv1m_qQ8.mjs';

package/dist/server/webhook-handler.d.ts

@@ -1,3 +1,3 @@
-export { g as createWebhookHandler } from '../webhook-handler-Cfa7-yKN.js';
+export { g as createWebhookHandler } from '../webhook-handler-5ymVecTD.js';
 import '@scalemule/money';
-import '../index-Tq5WdDfS.js';
+import '../index-Bv1m_qQ8.js';

package/dist/testing.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { U as User, A as ApiError, a9 as StorageFile } from './index-Tq5WdDfS.mjs';
+import { U as User, A as ApiError, a9 as StorageFile } from './index-Bv1m_qQ8.mjs';
 
 interface MockUserOptions {
     id?: string;

package/dist/testing.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { U as User, A as ApiError, a9 as StorageFile } from './index-Tq5WdDfS.js';
+import { U as User, A as ApiError, a9 as StorageFile } from './index-Bv1m_qQ8.js';
 
 interface MockUserOptions {
     id?: string;

package/dist/testing.js

@@ -11,6 +11,9 @@ 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;
   }
 };
 function createMockUser(options = {}) {

package/dist/testing.mjs

@@ -9,6 +9,9 @@ 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;
   }
 };
 function createMockUser(options = {}) {

package/dist/{webhook-handler-Cfa7-yKN.d.ts → webhook-handler-5ymVecTD.d.ts}

@@ -1,5 +1,5 @@
 import { MoneyClient } from '@scalemule/money';
-import { A as ApiError, $ as RegisterRequest, p as ClientContext, U as User, v as LoginRequest, L as LoginResponse, c as ListFilesParams, t as ListFilesResponse, a9 as StorageFile, af as UploadResponse } from './index-Tq5WdDfS.js';
+import { A as ApiError, $ as RegisterRequest, p as ClientContext, U as User, v as LoginRequest, L as LoginResponse, c as ListFilesParams, t as ListFilesResponse, a9 as StorageFile, af as UploadResponse } from './index-Bv1m_qQ8.js';
 
 /**
  * Server-Side ScaleMule Client

package/dist/{webhook-handler-DN4WBjbm.d.mts → webhook-handler-CVmBvPFN.d.mts}

@@ -1,5 +1,5 @@
 import { MoneyClient } from '@scalemule/money';
-import { A as ApiError, $ as RegisterRequest, p as ClientContext, U as User, v as LoginRequest, L as LoginResponse, c as ListFilesParams, t as ListFilesResponse, a9 as StorageFile, af as UploadResponse } from './index-Tq5WdDfS.mjs';
+import { A as ApiError, $ as RegisterRequest, p as ClientContext, U as User, v as LoginRequest, L as LoginResponse, c as ListFilesParams, t as ListFilesResponse, a9 as StorageFile, af as UploadResponse } from './index-Bv1m_qQ8.mjs';
 
 /**
  * Server-Side ScaleMule Client

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/nextjs",
-  "version": "0.1.39",
+  "version": "0.1.40",
   "description": "ScaleMule SDK for Next.js applications - authentication, storage, and user management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -55,12 +55,13 @@
     "type-check": "tsc --noEmit",
     "lint": "tsc --noEmit",
     "clean": "rm -rf dist",
-    "prepublishOnly": "node -e \"const v=require('./package.json').version; if(!/^0\\.(0|1)\\.\\d+$/.test(v)){console.error('ERR: SDK '+v+' violates patch-only policy (0.0.x or 0.1.x only). See CONTRIBUTING.md SDK versioning section.');process.exit(1)}\""
+    "prepublishOnly": "node -e \"const v=require('./package.json').version; if(!/^0\\.(0|1)\\.\\d+$/.test(v)){console.error('ERR: SDK '+v+' violates patch-only policy (0.0.x or 0.1.x only). See CONTRIBUTING.md SDK versioning section.');process.exit(1)}\"",
+    "release": "npm run build && npm test && npm run type-check && npm publish --access public"
   },
   "dependencies": {
     "@scalemule/ledvery": "^0.0.1",
     "@scalemule/money": "^0.0.1",
-    "@scalemule/sdk": "^0.0.63"
+    "@scalemule/sdk": "^0.0.64"
   },
   "peerDependencies": {
     "next": ">=14.0.0",