@mux/ai 0.14.0 → 0.15.1

package/dist/index.d.ts

@@ -9,7 +9,44 @@ import '@ai-sdk/anthropic';
 import '@ai-sdk/google';
 import '@ai-sdk/openai';
 
-var version = "0.14.0";
+var version = "0.15.1";
+
+type MuxAiErrorType = "validation_error" | "processing_error" | "timeout_error";
+/**
+ * An error whose message is safe to surface verbatim to the customer.
+ *
+ * Uses a structural brand (`__robots_error = true`) so that downstream
+ * consumers can identify customer-safe errors via duck typing — no
+ * shared dependency required. Errors from @mux/ai that DON'T carry
+ * this brand (unexpected SDK failures, upstream provider errors, etc.)
+ * should be treated as internal and obfuscated.
+ *
+ * Own properties (`publicMessage`, `publicType`, `retryable`) survive
+ * JSON serialization across workflow step boundaries, unlike inherited
+ * `Error.message`.
+ */
+declare class MuxAiError extends Error {
+    /** Structural brand for duck-type identification. */
+    readonly __robots_error = true;
+    /** Error category shown in the API response. */
+    readonly publicType: MuxAiErrorType;
+    /** Customer-facing message. Must be safe to show verbatim. */
+    readonly publicMessage: string;
+    /** Whether the customer should retry the job. */
+    readonly retryable: boolean;
+    constructor(message: string, opts?: {
+        type?: MuxAiErrorType;
+        retryable?: boolean;
+    });
+}
+/**
+ * Re-throws {@link MuxAiError} instances to preserve the structural brand,
+ * wraps everything else in a plain `Error` with a contextual message.
+ *
+ * Use this in catch blocks that re-throw so a customer-safe error from a
+ * callee isn't accidentally converted into an internal error.
+ */
+declare function wrapError(error: unknown, message: string): never;
 
 /**
  * A function that returns workflow credentials, either synchronously or asynchronously.
@@ -45,4 +82,4 @@ declare class WorkflowStorageClient {
 }
 declare function createWorkflowStorageClient(options?: WorkflowStorageClientOptions): WorkflowStorageClient;
 
-export { StoragePresignGetObjectInput, StoragePutObjectInput, WorkflowCredentials, type WorkflowCredentialsProvider, WorkflowStorageClient, createWorkflowStorageClient, setWorkflowCredentialsProvider, version };
+export { MuxAiError, type MuxAiErrorType, StoragePresignGetObjectInput, StoragePutObjectInput, WorkflowCredentials, type WorkflowCredentialsProvider, WorkflowStorageClient, createWorkflowStorageClient, setWorkflowCredentialsProvider, version, wrapError };