@brixel_ai/artifact-sdk 1.0.3 → 1.0.5

package/README.md

@@ -157,28 +157,30 @@ interface BrixelContext {
 ## Executing Other UI Tasks
 
 The SDK allows UI Tasks to execute other UI Tasks programmatically using the `executeTask` function.
-On success, `executeTask` returns the action `result` directly. On failure, it returns an `ExecuteTaskError`.
+`executeTask` returns `{ success, data }`:
+- `success: true` => `data` is the task result
+- `success: false` => `data` is an `ExecuteTaskError`
 
 ### Basic Usage
 
 ```tsx
-import { isExecuteTaskError, useBrixelArtifact } from "@brixel_ai/artifact-sdk";
+import { useBrixelArtifact } from "@brixel_ai/artifact-sdk";
 
 function MyUITask() {
   const { executeTask } = useBrixelArtifact();
 
   const handleExecuteTask = async () => {
-    const result = await executeTask<{ message: string }>({
+    const response = await executeTask<{ message: string }>({
       taskId: "78c2482f-b47d-461c-9fd0-509476687be9",
       inputs: { name: "value" },
     });
 
-    if (isExecuteTaskError(result)) {
-      console.error("Error:", result);
+    if (!response.success) {
+      console.error("Error:", response.data);
       return;
     }
 
-    console.debug("Task executed:", result);
+    console.debug("Task executed:", response.data);
   };
 
   return <button onClick={handleExecuteTask}>Execute Task</button>;

package/dist/index.d.mts

@@ -249,11 +249,23 @@ interface ExecuteTaskError {
     details?: unknown;
 }
 /**
- * Return value from executeTask:
- * - success: returns task result directly
- * - failure: returns ExecuteTaskError
+ * Successful executeTask response.
  */
-type ExecuteTaskResponse<TOutput = unknown> = TOutput | ExecuteTaskError;
+interface ExecuteTaskSuccessResponse<TOutput = unknown> {
+    success: true;
+    data: TOutput;
+}
+/**
+ * Failed executeTask response.
+ */
+interface ExecuteTaskFailureResponse {
+    success: false;
+    data: ExecuteTaskError;
+}
+/**
+ * Return value from executeTask.
+ */
+type ExecuteTaskResponse<TOutput = unknown> = ExecuteTaskSuccessResponse<TOutput> | ExecuteTaskFailureResponse;
 /**
  * Parameters for uploading a file to Brixel
  */
@@ -349,7 +361,7 @@ declare function createExecuteTask(contextAuth?: {
 }): <TOutput = unknown>(params: Omit<ExecuteTaskParams, "conversationId" | "apiToken" | "apiBaseUrl"> & {
     organizationId?: string;
 }) => Promise<ExecuteTaskResponse<TOutput>>;
-declare function isExecuteTaskError(value: unknown): value is ExecuteTaskError;
+declare function isExecuteTaskError(value: unknown): value is ExecuteTaskError | ExecuteTaskFailureResponse;
 
 declare function uploadFile<TOutput = InternalFilePublicOut>(params: UploadFileParams): Promise<UploadFileResponse<TOutput>>;
 declare function createUploadFile(contextAuth?: {
@@ -413,4 +425,4 @@ declare function simulateBrixelInit<TInputs = unknown>(inputs: TInputs, options?
  */
 declare function listenToUITaskMessages(callback: (message: unknown) => void): () => void;
 
-export { type ArtifactManifest, type BrixelContext, type CancelMessage, type CompleteMessage, type DestroyMessage, type ErrorMessage, type ExecuteTaskError, type ExecuteTaskParams, type ExecuteTaskResponse, type FileContentData, type GetFileContentParams, type GetFileContentResponse, type HostToIframeMessage, type IframeToHostMessage, type InitMessage, type InternalFileMimeType, type InternalFilePublicOut, type LogMessage, type ReadyMessage, type RenderMode, type ResizeMessage, type TaskStatus, type UpdateInputsMessage, type UpdateLocaleMessage, type UpdateThemeMessage, type UploadFileParams, type UploadFileResponse, type UseBrixelTaskOptions, type UseBrixelTaskResult, createExecuteTask, createGetFileContent, createUploadFile, executeTask, getFileContent, isExecuteTaskError, listenToUITaskMessages, simulateBrixelInit, uploadFile, useBrixelArtifact };
+export { type ArtifactManifest, type BrixelContext, type CancelMessage, type CompleteMessage, type DestroyMessage, type ErrorMessage, type ExecuteTaskError, type ExecuteTaskFailureResponse, type ExecuteTaskParams, type ExecuteTaskResponse, type ExecuteTaskSuccessResponse, type FileContentData, type GetFileContentParams, type GetFileContentResponse, type HostToIframeMessage, type IframeToHostMessage, type InitMessage, type InternalFileMimeType, type InternalFilePublicOut, type LogMessage, type ReadyMessage, type RenderMode, type ResizeMessage, type TaskStatus, type UpdateInputsMessage, type UpdateLocaleMessage, type UpdateThemeMessage, type UploadFileParams, type UploadFileResponse, type UseBrixelTaskOptions, type UseBrixelTaskResult, createExecuteTask, createGetFileContent, createUploadFile, executeTask, getFileContent, isExecuteTaskError, listenToUITaskMessages, simulateBrixelInit, uploadFile, useBrixelArtifact };

package/dist/index.d.ts

@@ -249,11 +249,23 @@ interface ExecuteTaskError {
     details?: unknown;
 }
 /**
- * Return value from executeTask:
- * - success: returns task result directly
- * - failure: returns ExecuteTaskError
+ * Successful executeTask response.
  */
-type ExecuteTaskResponse<TOutput = unknown> = TOutput | ExecuteTaskError;
+interface ExecuteTaskSuccessResponse<TOutput = unknown> {
+    success: true;
+    data: TOutput;
+}
+/**
+ * Failed executeTask response.
+ */
+interface ExecuteTaskFailureResponse {
+    success: false;
+    data: ExecuteTaskError;
+}
+/**
+ * Return value from executeTask.
+ */
+type ExecuteTaskResponse<TOutput = unknown> = ExecuteTaskSuccessResponse<TOutput> | ExecuteTaskFailureResponse;
 /**
  * Parameters for uploading a file to Brixel
  */
@@ -349,7 +361,7 @@ declare function createExecuteTask(contextAuth?: {
 }): <TOutput = unknown>(params: Omit<ExecuteTaskParams, "conversationId" | "apiToken" | "apiBaseUrl"> & {
     organizationId?: string;
 }) => Promise<ExecuteTaskResponse<TOutput>>;
-declare function isExecuteTaskError(value: unknown): value is ExecuteTaskError;
+declare function isExecuteTaskError(value: unknown): value is ExecuteTaskError | ExecuteTaskFailureResponse;
 
 declare function uploadFile<TOutput = InternalFilePublicOut>(params: UploadFileParams): Promise<UploadFileResponse<TOutput>>;
 declare function createUploadFile(contextAuth?: {
@@ -413,4 +425,4 @@ declare function simulateBrixelInit<TInputs = unknown>(inputs: TInputs, options?
  */
 declare function listenToUITaskMessages(callback: (message: unknown) => void): () => void;
 
-export { type ArtifactManifest, type BrixelContext, type CancelMessage, type CompleteMessage, type DestroyMessage, type ErrorMessage, type ExecuteTaskError, type ExecuteTaskParams, type ExecuteTaskResponse, type FileContentData, type GetFileContentParams, type GetFileContentResponse, type HostToIframeMessage, type IframeToHostMessage, type InitMessage, type InternalFileMimeType, type InternalFilePublicOut, type LogMessage, type ReadyMessage, type RenderMode, type ResizeMessage, type TaskStatus, type UpdateInputsMessage, type UpdateLocaleMessage, type UpdateThemeMessage, type UploadFileParams, type UploadFileResponse, type UseBrixelTaskOptions, type UseBrixelTaskResult, createExecuteTask, createGetFileContent, createUploadFile, executeTask, getFileContent, isExecuteTaskError, listenToUITaskMessages, simulateBrixelInit, uploadFile, useBrixelArtifact };
+export { type ArtifactManifest, type BrixelContext, type CancelMessage, type CompleteMessage, type DestroyMessage, type ErrorMessage, type ExecuteTaskError, type ExecuteTaskFailureResponse, type ExecuteTaskParams, type ExecuteTaskResponse, type ExecuteTaskSuccessResponse, type FileContentData, type GetFileContentParams, type GetFileContentResponse, type HostToIframeMessage, type IframeToHostMessage, type InitMessage, type InternalFileMimeType, type InternalFilePublicOut, type LogMessage, type ReadyMessage, type RenderMode, type ResizeMessage, type TaskStatus, type UpdateInputsMessage, type UpdateLocaleMessage, type UpdateThemeMessage, type UploadFileParams, type UploadFileResponse, type UseBrixelTaskOptions, type UseBrixelTaskResult, createExecuteTask, createGetFileContent, createUploadFile, executeTask, getFileContent, isExecuteTaskError, listenToUITaskMessages, simulateBrixelInit, uploadFile, useBrixelArtifact };

package/dist/index.js

@@ -90,16 +90,16 @@ async function executeTask(params) {
   debugApiBaseUrl(baseUrl);
   try {
     if (!organizationId) {
-      return {
+      return toExecuteTaskFailure({
         code: "MISSING_ORGANIZATION_ID",
         message: "organizationId is required to execute a task"
-      };
+      });
     }
     if (!taskId) {
-      return {
+      return toExecuteTaskFailure({
         code: "MISSING_TASK_ID",
         message: "taskId is required to execute a task"
-      };
+      });
     }
     const headers = {
       "Content-Type": "application/json"
@@ -120,21 +120,22 @@ async function executeTask(params) {
         body: JSON.stringify({ inputs })
       }
     );
-    const data = await parseJsonOrText(response);
+    const rawData = await parseJsonOrText(response);
+    const data = decodeBase64BytesPayloads(rawData);
     if (!response.ok) {
-      return toHttpError(response, data);
+      return toExecuteTaskFailure(toHttpError(response, data));
     }
     if (isActionExecutePayload(data)) {
       if (data.success === false) {
-        return toActionExecutionError(data);
+        return toExecuteTaskFailure(toActionExecutionError(data));
       }
       if ("result" in data) {
-        return data.result;
+        return toExecuteTaskSuccess(data.result);
       }
     }
-    return data ?? void 0;
+    return toExecuteTaskSuccess(data ?? void 0);
   } catch (error) {
-    return toNetworkError(error);
+    return toExecuteTaskFailure(toNetworkError(error));
   }
 }
 function createExecuteTask(contextAuth) {
@@ -152,6 +153,48 @@ function createExecuteTask(contextAuth) {
 function isRecord(value) {
   return typeof value === "object" && value !== null;
 }
+function isBase64BytesPayload(value) {
+  if (!isRecord(value)) {
+    return false;
+  }
+  return value.type === "bytes" && value.encoding === "base64" && typeof value.content === "string";
+}
+function decodeBase64BytesPayloads(value) {
+  if (isBase64BytesPayload(value)) {
+    try {
+      return decodeBase64ToUint8Array(value.content);
+    } catch {
+      return value;
+    }
+  }
+  if (Array.isArray(value)) {
+    return value.map((entry) => decodeBase64BytesPayloads(entry));
+  }
+  if (!isRecord(value)) {
+    return value;
+  }
+  const transformed = {};
+  for (const [key, nestedValue] of Object.entries(value)) {
+    transformed[key] = decodeBase64BytesPayloads(nestedValue);
+  }
+  return transformed;
+}
+function decodeBase64ToUint8Array(base64Value) {
+  const normalizedBase64 = base64Value.replace(/\s+/g, "");
+  if (typeof globalThis.atob === "function") {
+    const decoded = globalThis.atob(normalizedBase64);
+    const bytes = new Uint8Array(decoded.length);
+    for (let index = 0; index < decoded.length; index += 1) {
+      bytes[index] = decoded.charCodeAt(index);
+    }
+    return bytes;
+  }
+  const globalWithOptionalBuffer = globalThis;
+  if (globalWithOptionalBuffer.Buffer) {
+    return Uint8Array.from(globalWithOptionalBuffer.Buffer.from(normalizedBase64, "base64"));
+  }
+  throw new Error("No base64 decoder available in this environment");
+}
 function isActionExecutePayload(value) {
   return isRecord(value) && ("result" in value || "success" in value || "error" in value);
 }
@@ -163,8 +206,29 @@ function toActionExecutionError(payload) {
     details: payload
   };
 }
+function toExecuteTaskSuccess(data) {
+  return {
+    success: true,
+    data
+  };
+}
+function toExecuteTaskFailure(error) {
+  return {
+    success: false,
+    data: error
+  };
+}
 function isExecuteTaskError(value) {
-  return isRecord(value) && typeof value.code === "string" && typeof value.message === "string";
+  if (!isRecord(value)) {
+    return false;
+  }
+  if (typeof value.code === "string" && typeof value.message === "string") {
+    return true;
+  }
+  if (value.success !== false || !("data" in value) || !isRecord(value.data)) {
+    return false;
+  }
+  return typeof value.data.code === "string" && typeof value.data.message === "string";
 }
 
 // src/uploadFile.ts

package/dist/index.mjs

@@ -55,16 +55,16 @@ async function executeTask(params) {
   debugApiBaseUrl(baseUrl);
   try {
     if (!organizationId) {
-      return {
+      return toExecuteTaskFailure({
         code: "MISSING_ORGANIZATION_ID",
         message: "organizationId is required to execute a task"
-      };
+      });
     }
     if (!taskId) {
-      return {
+      return toExecuteTaskFailure({
         code: "MISSING_TASK_ID",
         message: "taskId is required to execute a task"
-      };
+      });
     }
     const headers = {
       "Content-Type": "application/json"
@@ -85,21 +85,22 @@ async function executeTask(params) {
         body: JSON.stringify({ inputs })
       }
     );
-    const data = await parseJsonOrText(response);
+    const rawData = await parseJsonOrText(response);
+    const data = decodeBase64BytesPayloads(rawData);
     if (!response.ok) {
-      return toHttpError(response, data);
+      return toExecuteTaskFailure(toHttpError(response, data));
     }
     if (isActionExecutePayload(data)) {
       if (data.success === false) {
-        return toActionExecutionError(data);
+        return toExecuteTaskFailure(toActionExecutionError(data));
       }
       if ("result" in data) {
-        return data.result;
+        return toExecuteTaskSuccess(data.result);
       }
     }
-    return data ?? void 0;
+    return toExecuteTaskSuccess(data ?? void 0);
   } catch (error) {
-    return toNetworkError(error);
+    return toExecuteTaskFailure(toNetworkError(error));
   }
 }
 function createExecuteTask(contextAuth) {
@@ -117,6 +118,48 @@ function createExecuteTask(contextAuth) {
 function isRecord(value) {
   return typeof value === "object" && value !== null;
 }
+function isBase64BytesPayload(value) {
+  if (!isRecord(value)) {
+    return false;
+  }
+  return value.type === "bytes" && value.encoding === "base64" && typeof value.content === "string";
+}
+function decodeBase64BytesPayloads(value) {
+  if (isBase64BytesPayload(value)) {
+    try {
+      return decodeBase64ToUint8Array(value.content);
+    } catch {
+      return value;
+    }
+  }
+  if (Array.isArray(value)) {
+    return value.map((entry) => decodeBase64BytesPayloads(entry));
+  }
+  if (!isRecord(value)) {
+    return value;
+  }
+  const transformed = {};
+  for (const [key, nestedValue] of Object.entries(value)) {
+    transformed[key] = decodeBase64BytesPayloads(nestedValue);
+  }
+  return transformed;
+}
+function decodeBase64ToUint8Array(base64Value) {
+  const normalizedBase64 = base64Value.replace(/\s+/g, "");
+  if (typeof globalThis.atob === "function") {
+    const decoded = globalThis.atob(normalizedBase64);
+    const bytes = new Uint8Array(decoded.length);
+    for (let index = 0; index < decoded.length; index += 1) {
+      bytes[index] = decoded.charCodeAt(index);
+    }
+    return bytes;
+  }
+  const globalWithOptionalBuffer = globalThis;
+  if (globalWithOptionalBuffer.Buffer) {
+    return Uint8Array.from(globalWithOptionalBuffer.Buffer.from(normalizedBase64, "base64"));
+  }
+  throw new Error("No base64 decoder available in this environment");
+}
 function isActionExecutePayload(value) {
   return isRecord(value) && ("result" in value || "success" in value || "error" in value);
 }
@@ -128,8 +171,29 @@ function toActionExecutionError(payload) {
     details: payload
   };
 }
+function toExecuteTaskSuccess(data) {
+  return {
+    success: true,
+    data
+  };
+}
+function toExecuteTaskFailure(error) {
+  return {
+    success: false,
+    data: error
+  };
+}
 function isExecuteTaskError(value) {
-  return isRecord(value) && typeof value.code === "string" && typeof value.message === "string";
+  if (!isRecord(value)) {
+    return false;
+  }
+  if (typeof value.code === "string" && typeof value.message === "string") {
+    return true;
+  }
+  if (value.success !== false || !("data" in value) || !isRecord(value.data)) {
+    return false;
+  }
+  return typeof value.data.code === "string" && typeof value.data.message === "string";
 }
 
 // src/uploadFile.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brixel_ai/artifact-sdk",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "SDK for building Brixel Artifacts - interactive React components that integrate with Brixel workflows",
   "main": "dist/index.js",
   "module": "dist/index.mjs",