@scalemule/nextjs 0.1.38 → 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" }));