@meistrari/tela-sdk-js 2.10.0 → 2.12.0

package/README.md

@@ -636,11 +636,16 @@ const { data, meta } = await tela.tasks.list({
     status: ['validating', 'completed'],
     tags: 'product:my-app',
     createdAtSince: new Date('2024-01-01'),
+    excludeInputOutputColumns: true, // omit raw input/input content/original output
     orderBy: ['createdAt'],
     order: 'desc',
     limit: 50,
 })
 
+// Lean list rows still include outputContent and flattened inputFiles.
+// Fetch a single task when you need raw input or original output payloads.
+const fullTask = await tela.tasks.get(data[0].id)
+
 // Mutations
 await tela.tasks.rename('task-id', 'New name')
 await tela.tasks.approve('task-id') // sets status: 'completed'
@@ -686,7 +691,7 @@ const uiStatus = normalizeTaskStatus(task.status)
 // 'failed' | 'cancelled'  → 'failed'
 ```
 
-The full `Task`, `TaskInputFile`, `TaskListQuery`, `TaskUpdatePayload`, and `TaskStatus` types are exported from the package root, so you don't need to type any task-related responses by hand.
+The full `Task`, `TaskListItem`, `TaskInputFile`, `TaskListQuery`, `TaskUpdatePayload`, and `TaskStatus` types are exported from the package root, so you don't need to type any task-related responses by hand.
 
 ### Vault API
 
@@ -1199,5 +1204,6 @@ When you execute a canvas using `applicationId`, it creates a task in the applic
 
 If you encounter issues during migration, please:
 - Check the [examples](./examples/) directory for updated usage patterns
-- Review the [API documentation](./docs/)
+- Review the [API documentation](https://sdk-js.tela.tools/)
+- Generate the API reference locally with `bun run docs` when checking changes
 - Open an issue at [GitHub Issues](https://github.com/meistrari/tela-sdk-js/issues)

package/dist/index.cjs

@@ -23,7 +23,7 @@ const changeCase__namespace = /*#__PURE__*/_interopNamespaceCompat(changeCase);
 const z__default = /*#__PURE__*/_interopDefaultCompat(z);
 const Emittery__default = /*#__PURE__*/_interopDefaultCompat(Emittery);
 
-const version = "2.10.0";
+const version = "2.12.0";
 
 var __defProp$a = Object.defineProperty;
 var __defNormalProp$a = (obj, key, value) => key in obj ? __defProp$a(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -2574,6 +2574,40 @@ var __publicField$4 = (obj, key, value) => {
   __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
+function resolveBatchQueue(queue) {
+  if (!queue) {
+    return void 0;
+  }
+  const type = queue.type === void 0 ? "customer" : queue.type;
+  if (type !== "internal" && type !== "customer") {
+    throw new Error('Batch queue type must be either "internal" or "customer"');
+  }
+  if (typeof queue.application !== "string" || queue.application.trim().length === 0) {
+    throw new Error("Batch queue application is required when queue is provided");
+  }
+  return {
+    type,
+    application: queue.application.trim()
+  };
+}
+function createBatchRequestHeaders(params) {
+  const headers = new Headers();
+  let hasHeaders = false;
+  const queue = resolveBatchQueue(params.queue);
+  if (queue) {
+    headers.set("x-batch-source", queue.type);
+    headers.set("x-batch-source-application", queue.application);
+    hasHeaders = true;
+  }
+  if (params.webhook?.headers) {
+    for (const [key, value] of Object.entries(params.webhook.headers)) {
+      const headerKey = key.toLowerCase().startsWith("x-tela-forward-") ? key : `x-tela-forward-${key}`;
+      headers.set(headerKey, value);
+      hasHeaders = true;
+    }
+  }
+  return hasHeaders ? headers : void 0;
+}
 const BatchResultItem = z__default.looseObject({
   reference_id: z__default.string(),
   status: z__default.string(),
@@ -3304,6 +3338,7 @@ class Batch {
     const client = this._client;
     const params = this._params;
     async function execute() {
+      const headers = createBatchRequestHeaders(params);
       const { fileUrl } = await uploadFile(file, client);
       const webhookUrl = params.webhook?.url ?? params.webhookUrl;
       const body = {
@@ -3311,31 +3346,22 @@ class Batch {
         inputFile: fileUrl,
         webhookUrl
       };
-      const forwardHeaders = {};
-      if (params.webhook?.headers) {
-        for (const [key, value] of Object.entries(params.webhook.headers)) {
-          const headerKey = key.toLowerCase().startsWith("x-tela-forward-") ? key : `x-tela-forward-${key}`;
-          forwardHeaders[headerKey] = value;
-        }
-      }
-      let headers;
-      if (Object.keys(forwardHeaders).length > 0) {
-        headers = new Headers();
-        for (const [key, value] of Object.entries(forwardHeaders)) {
-          headers.set(key, value);
-        }
-      }
       return client.post("/_services/batch/batches", {
         body,
         ...headers && { headers }
       }).then((response) => new BatchExecution(response.id, client, params, response));
     }
+    let executionPromise;
+    function getExecution() {
+      executionPromise ?? (executionPromise = execute());
+      return executionPromise;
+    }
     return {
       then(onfulfilled, onrejected) {
-        return Promise.resolve(execute()).then((execution) => onfulfilled?.(execution) ?? execution).catch(onrejected);
+        return getExecution().then((execution) => onfulfilled?.(execution) ?? execution).catch(onrejected);
       },
       get result() {
-        return Promise.resolve(execute()).then((execution) => execution.result);
+        return getExecution().then((execution) => execution.result);
       }
     };
   }
@@ -3937,6 +3963,7 @@ const TaskListFilters = z__default.looseObject({
 const TaskListOptions = z__default.looseObject({
   limit: z__default.number().optional(),
   offset: z__default.number().optional(),
+  excludeInputOutputColumns: z__default.boolean().optional(),
   order: z__default.object({
     by: z__default.enum(["createdAt", "updatedAt", "approvedAt", "status", "reference", "name"]),
     direction: z__default.enum(["asc", "desc"])
@@ -4239,6 +4266,7 @@ class Workstation {
   async *iterateTasks({ filters, options }) {
     let rawQuery;
     let hasMore = true;
+    const validatedOptions = TaskListOptions.optional().parse(options);
     while (hasMore) {
       const { tasks, meta } = await this.listTasks({
         filters,
@@ -4251,7 +4279,8 @@ class Workstation {
       if (meta.links.next !== null) {
         rawQuery = {
           ...meta.links.next,
-          objectLinks: true
+          objectLinks: true,
+          ...validatedOptions?.excludeInputOutputColumns !== void 0 ? { excludeInputOutputColumns: validatedOptions.excludeInputOutputColumns } : {}
         };
       } else {
         hasMore = false;
@@ -4305,9 +4334,6 @@ class Tasks {
       ...NO_TRANSFORM
     });
   }
-  /**
-   * Lists tasks with optional filters and pagination.
-   */
   async list(query = {}) {
     const serialized = serializeTaskListQuery(query);
     return this.client.get("/task", {

package/dist/index.d.cts

@@ -1947,6 +1947,27 @@ interface BatchWebhookConfig {
      */
     headers?: Record<string, string>;
 }
+/**
+ * Source type for routing batch executions.
+ *
+ * @category Canvas
+ */
+type BatchQueueType = 'internal' | 'customer';
+/**
+ * Queue/source metadata sent as headers when creating a batch execution.
+ *
+ * @category Canvas
+ */
+interface BatchQueueConfig {
+    /**
+     * Source type for the batch. Defaults to `customer` when omitted.
+     */
+    type?: BatchQueueType;
+    /**
+     * Name of the application creating the batch. Required when `queue` is provided.
+     */
+    application: string;
+}
 /**
  * Configuration options for batch execution.
  *
@@ -2007,6 +2028,14 @@ interface BatchParams extends Omit<BaseExecutionParams, ExcludedParams> {
      * ```
      */
     webhook?: BatchWebhookConfig;
+    /**
+     * Optional queue/source metadata sent as headers when creating the batch.
+     *
+     * Sends:
+     * - `x-batch-source`: `queue.type` or `customer` by default.
+     * - `x-batch-source-application`: `queue.application`.
+     */
+    queue?: BatchQueueConfig;
 }
 /**
  * Promise-like wrapper for batch execution that provides direct result access.
@@ -3277,6 +3306,7 @@ type TaskListFilters = z.input<typeof TaskListFilters>;
 declare const TaskListOptions: z.ZodPipe<z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
+    excludeInputOutputColumns: z.ZodOptional<z.ZodBoolean>;
     order: z.ZodOptional<z.ZodObject<{
         by: z.ZodEnum<{
             name: "name";
@@ -3294,12 +3324,14 @@ declare const TaskListOptions: z.ZodPipe<z.ZodObject<{
 }, z.core.$loose>, z.ZodTransform<{
     limit?: number | undefined;
     offset?: number | undefined;
+    excludeInputOutputColumns?: boolean | undefined;
     orderBy: "name" | "status" | "reference" | "approvedAt" | "createdAt" | "updatedAt" | undefined;
     orderDirection: "asc" | "desc" | undefined;
 }, {
     [x: string]: unknown;
     limit?: number | undefined;
     offset?: number | undefined;
+    excludeInputOutputColumns?: boolean | undefined;
     order?: {
         by: "name" | "status" | "reference" | "approvedAt" | "createdAt" | "updatedAt";
         direction: "asc" | "desc";
@@ -3340,6 +3372,8 @@ type LinkParams = {
     limit: number;
     /** Starting offset for the page */
     offset: number;
+    /** Whether heavy input/output columns are omitted from task rows */
+    excludeInputOutputColumns?: boolean;
 };
 /**
  * Navigation links for paginated task lists.
@@ -3663,6 +3697,16 @@ interface Task<TOutput = unknown> {
     updatedAt: string;
     deletedAt: string | null;
 }
+/**
+ * A lean task row returned when `excludeInputOutputColumns` is enabled.
+ *
+ * The API omits `rawInput`, `inputContent`, and `originalOutputContent` from
+ * each row, while still returning the current `outputContent` and flattened
+ * `inputFiles`. Fetch the task by id to retrieve the full task payload.
+ */
+type TaskListItem<TOutput = unknown> = Omit<Task<TOutput>, 'inputContent' | 'originalOutputContent' | 'rawInput'> & {
+    inputFiles: Array<TaskInputFile>;
+};
 /**
  * Payload accepted by `tasks.update()`.
  *
@@ -3705,14 +3749,22 @@ interface TaskListQuery {
     order?: 'asc' | 'desc';
     limit?: number;
     offset?: number;
+    /**
+     * Omits raw input, normalized input content, and original output columns
+     * from each listed task. The list rows still include the current
+     * `outputContent` and flattened `inputFiles`.
+     *
+     * Use `tasks.get(id)` when you need the full task detail, including raw
+     * input and original output payloads.
+     */
     excludeInputOutputColumns?: boolean;
 }
 type TaskOrderBy = 'name' | 'reference' | 'approvedAt' | 'createdAt' | 'updatedAt' | 'id' | 'status' | 'approvedBy' | 'createdBy';
 /**
  * Paginated response wrapper.
  */
-interface TaskListResult<TOutput = unknown> {
-    data: Array<Task<TOutput>>;
+interface TaskListResult<TOutput = unknown, TItem extends Task<TOutput> | TaskListItem<TOutput> = Task<TOutput>> {
+    data: Array<TItem>;
     meta: {
         totalCount?: number;
         limit?: number;
@@ -3836,6 +3888,9 @@ declare class Tasks {
     /**
      * Lists tasks with optional filters and pagination.
      */
+    list<TOutput = unknown>(query: TaskListQuery & {
+        excludeInputOutputColumns: true;
+    }): Promise<TaskListResult<TOutput, TaskListItem<TOutput>>>;
     list<TOutput = unknown>(query?: TaskListQuery): Promise<TaskListResult<TOutput>>;
     /**
      * Updates one or more fields of a task.
@@ -4254,4 +4309,4 @@ declare class TelaSDK extends BaseClient {
  */
 declare function createTelaClient(opts: TelaSDKOptions): TelaSDK;
 
-export { APIError, AuthenticationError, AuthorizationError, BadRequestError, BaseClient, type BaseClientOptions, type BaseTelaFileOptions, BatchExecutionFailedError, ConflictApiKeyAndJWTError, ConflictAuthMethodsError, ConflictError, ConnectionError, ConnectionTimeout, EmptyFileError, ExecutionFailedError, ExecutionNotStartedError, FileUploadError, type HTTPMethods, InternalServerError, InvalidExecutionModeError, InvalidFileURL, MissingApiKeyOrJWTError, MissingAuthError, type NormalizedTaskStatus, NotFoundError, RateLimitError, type RequestOptions, type SchemaBuilder, type Task, type TaskDeleteBulkResult, type TaskDeleteResult, TaskFailedError, type TaskInputContent, type TaskInputFile, type TaskListQuery, type TaskListResult, type TaskOrderBy, type TaskOutputContent, type TaskRerunResult, type TaskStatus, type TaskUndoApprovalBulkResult, type TaskUpdatePayload, Tasks, TelaError, TelaFile, type TelaFileInput, type TelaFileOptions, type TelaFileOptionsWithMimeType, TelaFileSchema, TelaSDK, type TelaSDKOptions, UnprocessableEntityError, UserAbortError, Vault, createTelaClient, extractTaskOutput, isTelaFile, isTelaFileArray, normalizeTaskStatus, toError };
+export { APIError, AuthenticationError, AuthorizationError, BadRequestError, BaseClient, type BaseClientOptions, type BaseTelaFileOptions, BatchExecutionFailedError, type BatchParams, type BatchQueueConfig, type BatchQueueType, type BatchWebhookConfig, ConflictApiKeyAndJWTError, ConflictAuthMethodsError, ConflictError, ConnectionError, ConnectionTimeout, EmptyFileError, ExecutionFailedError, ExecutionNotStartedError, FileUploadError, type HTTPMethods, InternalServerError, InvalidExecutionModeError, InvalidFileURL, MissingApiKeyOrJWTError, MissingAuthError, type NormalizedTaskStatus, NotFoundError, RateLimitError, type RequestOptions, type SchemaBuilder, type Task, type TaskDeleteBulkResult, type TaskDeleteResult, TaskFailedError, type TaskInputContent, type TaskInputFile, type TaskListItem, type TaskListQuery, type TaskListResult, type TaskOrderBy, type TaskOutputContent, type TaskRerunResult, type TaskStatus, type TaskUndoApprovalBulkResult, type TaskUpdatePayload, Tasks, TelaError, TelaFile, type TelaFileInput, type TelaFileOptions, type TelaFileOptionsWithMimeType, TelaFileSchema, TelaSDK, type TelaSDKOptions, UnprocessableEntityError, UserAbortError, Vault, createTelaClient, extractTaskOutput, isTelaFile, isTelaFileArray, normalizeTaskStatus, toError };

package/dist/index.d.mts

@@ -1947,6 +1947,27 @@ interface BatchWebhookConfig {
      */
     headers?: Record<string, string>;
 }
+/**
+ * Source type for routing batch executions.
+ *
+ * @category Canvas
+ */
+type BatchQueueType = 'internal' | 'customer';
+/**
+ * Queue/source metadata sent as headers when creating a batch execution.
+ *
+ * @category Canvas
+ */
+interface BatchQueueConfig {
+    /**
+     * Source type for the batch. Defaults to `customer` when omitted.
+     */
+    type?: BatchQueueType;
+    /**
+     * Name of the application creating the batch. Required when `queue` is provided.
+     */
+    application: string;
+}
 /**
  * Configuration options for batch execution.
  *
@@ -2007,6 +2028,14 @@ interface BatchParams extends Omit<BaseExecutionParams, ExcludedParams> {
      * ```
      */
     webhook?: BatchWebhookConfig;
+    /**
+     * Optional queue/source metadata sent as headers when creating the batch.
+     *
+     * Sends:
+     * - `x-batch-source`: `queue.type` or `customer` by default.
+     * - `x-batch-source-application`: `queue.application`.
+     */
+    queue?: BatchQueueConfig;
 }
 /**
  * Promise-like wrapper for batch execution that provides direct result access.
@@ -3277,6 +3306,7 @@ type TaskListFilters = z.input<typeof TaskListFilters>;
 declare const TaskListOptions: z.ZodPipe<z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
+    excludeInputOutputColumns: z.ZodOptional<z.ZodBoolean>;
     order: z.ZodOptional<z.ZodObject<{
         by: z.ZodEnum<{
             name: "name";
@@ -3294,12 +3324,14 @@ declare const TaskListOptions: z.ZodPipe<z.ZodObject<{
 }, z.core.$loose>, z.ZodTransform<{
     limit?: number | undefined;
     offset?: number | undefined;
+    excludeInputOutputColumns?: boolean | undefined;
     orderBy: "name" | "status" | "reference" | "approvedAt" | "createdAt" | "updatedAt" | undefined;
     orderDirection: "asc" | "desc" | undefined;
 }, {
     [x: string]: unknown;
     limit?: number | undefined;
     offset?: number | undefined;
+    excludeInputOutputColumns?: boolean | undefined;
     order?: {
         by: "name" | "status" | "reference" | "approvedAt" | "createdAt" | "updatedAt";
         direction: "asc" | "desc";
@@ -3340,6 +3372,8 @@ type LinkParams = {
     limit: number;
     /** Starting offset for the page */
     offset: number;
+    /** Whether heavy input/output columns are omitted from task rows */
+    excludeInputOutputColumns?: boolean;
 };
 /**
  * Navigation links for paginated task lists.
@@ -3663,6 +3697,16 @@ interface Task<TOutput = unknown> {
     updatedAt: string;
     deletedAt: string | null;
 }
+/**
+ * A lean task row returned when `excludeInputOutputColumns` is enabled.
+ *
+ * The API omits `rawInput`, `inputContent`, and `originalOutputContent` from
+ * each row, while still returning the current `outputContent` and flattened
+ * `inputFiles`. Fetch the task by id to retrieve the full task payload.
+ */
+type TaskListItem<TOutput = unknown> = Omit<Task<TOutput>, 'inputContent' | 'originalOutputContent' | 'rawInput'> & {
+    inputFiles: Array<TaskInputFile>;
+};
 /**
  * Payload accepted by `tasks.update()`.
  *
@@ -3705,14 +3749,22 @@ interface TaskListQuery {
     order?: 'asc' | 'desc';
     limit?: number;
     offset?: number;
+    /**
+     * Omits raw input, normalized input content, and original output columns
+     * from each listed task. The list rows still include the current
+     * `outputContent` and flattened `inputFiles`.
+     *
+     * Use `tasks.get(id)` when you need the full task detail, including raw
+     * input and original output payloads.
+     */
     excludeInputOutputColumns?: boolean;
 }
 type TaskOrderBy = 'name' | 'reference' | 'approvedAt' | 'createdAt' | 'updatedAt' | 'id' | 'status' | 'approvedBy' | 'createdBy';
 /**
  * Paginated response wrapper.
  */
-interface TaskListResult<TOutput = unknown> {
-    data: Array<Task<TOutput>>;
+interface TaskListResult<TOutput = unknown, TItem extends Task<TOutput> | TaskListItem<TOutput> = Task<TOutput>> {
+    data: Array<TItem>;
     meta: {
         totalCount?: number;
         limit?: number;
@@ -3836,6 +3888,9 @@ declare class Tasks {
     /**
      * Lists tasks with optional filters and pagination.
      */
+    list<TOutput = unknown>(query: TaskListQuery & {
+        excludeInputOutputColumns: true;
+    }): Promise<TaskListResult<TOutput, TaskListItem<TOutput>>>;
     list<TOutput = unknown>(query?: TaskListQuery): Promise<TaskListResult<TOutput>>;
     /**
      * Updates one or more fields of a task.
@@ -4254,4 +4309,4 @@ declare class TelaSDK extends BaseClient {
  */
 declare function createTelaClient(opts: TelaSDKOptions): TelaSDK;
 
-export { APIError, AuthenticationError, AuthorizationError, BadRequestError, BaseClient, type BaseClientOptions, type BaseTelaFileOptions, BatchExecutionFailedError, ConflictApiKeyAndJWTError, ConflictAuthMethodsError, ConflictError, ConnectionError, ConnectionTimeout, EmptyFileError, ExecutionFailedError, ExecutionNotStartedError, FileUploadError, type HTTPMethods, InternalServerError, InvalidExecutionModeError, InvalidFileURL, MissingApiKeyOrJWTError, MissingAuthError, type NormalizedTaskStatus, NotFoundError, RateLimitError, type RequestOptions, type SchemaBuilder, type Task, type TaskDeleteBulkResult, type TaskDeleteResult, TaskFailedError, type TaskInputContent, type TaskInputFile, type TaskListQuery, type TaskListResult, type TaskOrderBy, type TaskOutputContent, type TaskRerunResult, type TaskStatus, type TaskUndoApprovalBulkResult, type TaskUpdatePayload, Tasks, TelaError, TelaFile, type TelaFileInput, type TelaFileOptions, type TelaFileOptionsWithMimeType, TelaFileSchema, TelaSDK, type TelaSDKOptions, UnprocessableEntityError, UserAbortError, Vault, createTelaClient, extractTaskOutput, isTelaFile, isTelaFileArray, normalizeTaskStatus, toError };
+export { APIError, AuthenticationError, AuthorizationError, BadRequestError, BaseClient, type BaseClientOptions, type BaseTelaFileOptions, BatchExecutionFailedError, type BatchParams, type BatchQueueConfig, type BatchQueueType, type BatchWebhookConfig, ConflictApiKeyAndJWTError, ConflictAuthMethodsError, ConflictError, ConnectionError, ConnectionTimeout, EmptyFileError, ExecutionFailedError, ExecutionNotStartedError, FileUploadError, type HTTPMethods, InternalServerError, InvalidExecutionModeError, InvalidFileURL, MissingApiKeyOrJWTError, MissingAuthError, type NormalizedTaskStatus, NotFoundError, RateLimitError, type RequestOptions, type SchemaBuilder, type Task, type TaskDeleteBulkResult, type TaskDeleteResult, TaskFailedError, type TaskInputContent, type TaskInputFile, type TaskListItem, type TaskListQuery, type TaskListResult, type TaskOrderBy, type TaskOutputContent, type TaskRerunResult, type TaskStatus, type TaskUndoApprovalBulkResult, type TaskUpdatePayload, Tasks, TelaError, TelaFile, type TelaFileInput, type TelaFileOptions, type TelaFileOptionsWithMimeType, TelaFileSchema, TelaSDK, type TelaSDKOptions, UnprocessableEntityError, UserAbortError, Vault, createTelaClient, extractTaskOutput, isTelaFile, isTelaFileArray, normalizeTaskStatus, toError };

package/dist/index.d.ts

@@ -1947,6 +1947,27 @@ interface BatchWebhookConfig {
      */
     headers?: Record<string, string>;
 }
+/**
+ * Source type for routing batch executions.
+ *
+ * @category Canvas
+ */
+type BatchQueueType = 'internal' | 'customer';
+/**
+ * Queue/source metadata sent as headers when creating a batch execution.
+ *
+ * @category Canvas
+ */
+interface BatchQueueConfig {
+    /**
+     * Source type for the batch. Defaults to `customer` when omitted.
+     */
+    type?: BatchQueueType;
+    /**
+     * Name of the application creating the batch. Required when `queue` is provided.
+     */
+    application: string;
+}
 /**
  * Configuration options for batch execution.
  *
@@ -2007,6 +2028,14 @@ interface BatchParams extends Omit<BaseExecutionParams, ExcludedParams> {
      * ```
      */
     webhook?: BatchWebhookConfig;
+    /**
+     * Optional queue/source metadata sent as headers when creating the batch.
+     *
+     * Sends:
+     * - `x-batch-source`: `queue.type` or `customer` by default.
+     * - `x-batch-source-application`: `queue.application`.
+     */
+    queue?: BatchQueueConfig;
 }
 /**
  * Promise-like wrapper for batch execution that provides direct result access.
@@ -3277,6 +3306,7 @@ type TaskListFilters = z.input<typeof TaskListFilters>;
 declare const TaskListOptions: z.ZodPipe<z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
+    excludeInputOutputColumns: z.ZodOptional<z.ZodBoolean>;
     order: z.ZodOptional<z.ZodObject<{
         by: z.ZodEnum<{
             name: "name";
@@ -3294,12 +3324,14 @@ declare const TaskListOptions: z.ZodPipe<z.ZodObject<{
 }, z.core.$loose>, z.ZodTransform<{
     limit?: number | undefined;
     offset?: number | undefined;
+    excludeInputOutputColumns?: boolean | undefined;
     orderBy: "name" | "status" | "reference" | "approvedAt" | "createdAt" | "updatedAt" | undefined;
     orderDirection: "asc" | "desc" | undefined;
 }, {
     [x: string]: unknown;
     limit?: number | undefined;
     offset?: number | undefined;
+    excludeInputOutputColumns?: boolean | undefined;
     order?: {
         by: "name" | "status" | "reference" | "approvedAt" | "createdAt" | "updatedAt";
         direction: "asc" | "desc";
@@ -3340,6 +3372,8 @@ type LinkParams = {
     limit: number;
     /** Starting offset for the page */
     offset: number;
+    /** Whether heavy input/output columns are omitted from task rows */
+    excludeInputOutputColumns?: boolean;
 };
 /**
  * Navigation links for paginated task lists.
@@ -3663,6 +3697,16 @@ interface Task<TOutput = unknown> {
     updatedAt: string;
     deletedAt: string | null;
 }
+/**
+ * A lean task row returned when `excludeInputOutputColumns` is enabled.
+ *
+ * The API omits `rawInput`, `inputContent`, and `originalOutputContent` from
+ * each row, while still returning the current `outputContent` and flattened
+ * `inputFiles`. Fetch the task by id to retrieve the full task payload.
+ */
+type TaskListItem<TOutput = unknown> = Omit<Task<TOutput>, 'inputContent' | 'originalOutputContent' | 'rawInput'> & {
+    inputFiles: Array<TaskInputFile>;
+};
 /**
  * Payload accepted by `tasks.update()`.
  *
@@ -3705,14 +3749,22 @@ interface TaskListQuery {
     order?: 'asc' | 'desc';
     limit?: number;
     offset?: number;
+    /**
+     * Omits raw input, normalized input content, and original output columns
+     * from each listed task. The list rows still include the current
+     * `outputContent` and flattened `inputFiles`.
+     *
+     * Use `tasks.get(id)` when you need the full task detail, including raw
+     * input and original output payloads.
+     */
     excludeInputOutputColumns?: boolean;
 }
 type TaskOrderBy = 'name' | 'reference' | 'approvedAt' | 'createdAt' | 'updatedAt' | 'id' | 'status' | 'approvedBy' | 'createdBy';
 /**
  * Paginated response wrapper.
  */
-interface TaskListResult<TOutput = unknown> {
-    data: Array<Task<TOutput>>;
+interface TaskListResult<TOutput = unknown, TItem extends Task<TOutput> | TaskListItem<TOutput> = Task<TOutput>> {
+    data: Array<TItem>;
     meta: {
         totalCount?: number;
         limit?: number;
@@ -3836,6 +3888,9 @@ declare class Tasks {
     /**
      * Lists tasks with optional filters and pagination.
      */
+    list<TOutput = unknown>(query: TaskListQuery & {
+        excludeInputOutputColumns: true;
+    }): Promise<TaskListResult<TOutput, TaskListItem<TOutput>>>;
     list<TOutput = unknown>(query?: TaskListQuery): Promise<TaskListResult<TOutput>>;
     /**
      * Updates one or more fields of a task.
@@ -4254,4 +4309,4 @@ declare class TelaSDK extends BaseClient {
  */
 declare function createTelaClient(opts: TelaSDKOptions): TelaSDK;
 
-export { APIError, AuthenticationError, AuthorizationError, BadRequestError, BaseClient, type BaseClientOptions, type BaseTelaFileOptions, BatchExecutionFailedError, ConflictApiKeyAndJWTError, ConflictAuthMethodsError, ConflictError, ConnectionError, ConnectionTimeout, EmptyFileError, ExecutionFailedError, ExecutionNotStartedError, FileUploadError, type HTTPMethods, InternalServerError, InvalidExecutionModeError, InvalidFileURL, MissingApiKeyOrJWTError, MissingAuthError, type NormalizedTaskStatus, NotFoundError, RateLimitError, type RequestOptions, type SchemaBuilder, type Task, type TaskDeleteBulkResult, type TaskDeleteResult, TaskFailedError, type TaskInputContent, type TaskInputFile, type TaskListQuery, type TaskListResult, type TaskOrderBy, type TaskOutputContent, type TaskRerunResult, type TaskStatus, type TaskUndoApprovalBulkResult, type TaskUpdatePayload, Tasks, TelaError, TelaFile, type TelaFileInput, type TelaFileOptions, type TelaFileOptionsWithMimeType, TelaFileSchema, TelaSDK, type TelaSDKOptions, UnprocessableEntityError, UserAbortError, Vault, createTelaClient, extractTaskOutput, isTelaFile, isTelaFileArray, normalizeTaskStatus, toError };
+export { APIError, AuthenticationError, AuthorizationError, BadRequestError, BaseClient, type BaseClientOptions, type BaseTelaFileOptions, BatchExecutionFailedError, type BatchParams, type BatchQueueConfig, type BatchQueueType, type BatchWebhookConfig, ConflictApiKeyAndJWTError, ConflictAuthMethodsError, ConflictError, ConnectionError, ConnectionTimeout, EmptyFileError, ExecutionFailedError, ExecutionNotStartedError, FileUploadError, type HTTPMethods, InternalServerError, InvalidExecutionModeError, InvalidFileURL, MissingApiKeyOrJWTError, MissingAuthError, type NormalizedTaskStatus, NotFoundError, RateLimitError, type RequestOptions, type SchemaBuilder, type Task, type TaskDeleteBulkResult, type TaskDeleteResult, TaskFailedError, type TaskInputContent, type TaskInputFile, type TaskListItem, type TaskListQuery, type TaskListResult, type TaskOrderBy, type TaskOutputContent, type TaskRerunResult, type TaskStatus, type TaskUndoApprovalBulkResult, type TaskUpdatePayload, Tasks, TelaError, TelaFile, type TelaFileInput, type TelaFileOptions, type TelaFileOptionsWithMimeType, TelaFileSchema, TelaSDK, type TelaSDKOptions, UnprocessableEntityError, UserAbortError, Vault, createTelaClient, extractTaskOutput, isTelaFile, isTelaFileArray, normalizeTaskStatus, toError };

package/dist/index.mjs

@@ -3,7 +3,7 @@ import { Minimatch } from 'minimatch';
 import z, { z as z$1, ZodError } from 'zod';
 import Emittery from 'emittery';
 
-const version = "2.10.0";
+const version = "2.12.0";
 
 var __defProp$a = Object.defineProperty;
 var __defNormalProp$a = (obj, key, value) => key in obj ? __defProp$a(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -2554,6 +2554,40 @@ var __publicField$4 = (obj, key, value) => {
   __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
+function resolveBatchQueue(queue) {
+  if (!queue) {
+    return void 0;
+  }
+  const type = queue.type === void 0 ? "customer" : queue.type;
+  if (type !== "internal" && type !== "customer") {
+    throw new Error('Batch queue type must be either "internal" or "customer"');
+  }
+  if (typeof queue.application !== "string" || queue.application.trim().length === 0) {
+    throw new Error("Batch queue application is required when queue is provided");
+  }
+  return {
+    type,
+    application: queue.application.trim()
+  };
+}
+function createBatchRequestHeaders(params) {
+  const headers = new Headers();
+  let hasHeaders = false;
+  const queue = resolveBatchQueue(params.queue);
+  if (queue) {
+    headers.set("x-batch-source", queue.type);
+    headers.set("x-batch-source-application", queue.application);
+    hasHeaders = true;
+  }
+  if (params.webhook?.headers) {
+    for (const [key, value] of Object.entries(params.webhook.headers)) {
+      const headerKey = key.toLowerCase().startsWith("x-tela-forward-") ? key : `x-tela-forward-${key}`;
+      headers.set(headerKey, value);
+      hasHeaders = true;
+    }
+  }
+  return hasHeaders ? headers : void 0;
+}
 const BatchResultItem = z.looseObject({
   reference_id: z.string(),
   status: z.string(),
@@ -3284,6 +3318,7 @@ class Batch {
     const client = this._client;
     const params = this._params;
     async function execute() {
+      const headers = createBatchRequestHeaders(params);
       const { fileUrl } = await uploadFile(file, client);
       const webhookUrl = params.webhook?.url ?? params.webhookUrl;
       const body = {
@@ -3291,31 +3326,22 @@ class Batch {
         inputFile: fileUrl,
         webhookUrl
       };
-      const forwardHeaders = {};
-      if (params.webhook?.headers) {
-        for (const [key, value] of Object.entries(params.webhook.headers)) {
-          const headerKey = key.toLowerCase().startsWith("x-tela-forward-") ? key : `x-tela-forward-${key}`;
-          forwardHeaders[headerKey] = value;
-        }
-      }
-      let headers;
-      if (Object.keys(forwardHeaders).length > 0) {
-        headers = new Headers();
-        for (const [key, value] of Object.entries(forwardHeaders)) {
-          headers.set(key, value);
-        }
-      }
       return client.post("/_services/batch/batches", {
         body,
         ...headers && { headers }
       }).then((response) => new BatchExecution(response.id, client, params, response));
     }
+    let executionPromise;
+    function getExecution() {
+      executionPromise ?? (executionPromise = execute());
+      return executionPromise;
+    }
     return {
       then(onfulfilled, onrejected) {
-        return Promise.resolve(execute()).then((execution) => onfulfilled?.(execution) ?? execution).catch(onrejected);
+        return getExecution().then((execution) => onfulfilled?.(execution) ?? execution).catch(onrejected);
       },
       get result() {
-        return Promise.resolve(execute()).then((execution) => execution.result);
+        return getExecution().then((execution) => execution.result);
       }
     };
   }
@@ -3917,6 +3943,7 @@ const TaskListFilters = z.looseObject({
 const TaskListOptions = z.looseObject({
   limit: z.number().optional(),
   offset: z.number().optional(),
+  excludeInputOutputColumns: z.boolean().optional(),
   order: z.object({
     by: z.enum(["createdAt", "updatedAt", "approvedAt", "status", "reference", "name"]),
     direction: z.enum(["asc", "desc"])
@@ -4219,6 +4246,7 @@ class Workstation {
   async *iterateTasks({ filters, options }) {
     let rawQuery;
     let hasMore = true;
+    const validatedOptions = TaskListOptions.optional().parse(options);
     while (hasMore) {
       const { tasks, meta } = await this.listTasks({
         filters,
@@ -4231,7 +4259,8 @@ class Workstation {
       if (meta.links.next !== null) {
         rawQuery = {
           ...meta.links.next,
-          objectLinks: true
+          objectLinks: true,
+          ...validatedOptions?.excludeInputOutputColumns !== void 0 ? { excludeInputOutputColumns: validatedOptions.excludeInputOutputColumns } : {}
         };
       } else {
         hasMore = false;
@@ -4285,9 +4314,6 @@ class Tasks {
       ...NO_TRANSFORM
     });
   }
-  /**
-   * Lists tasks with optional filters and pagination.
-   */
   async list(query = {}) {
     const serialized = serializeTaskListQuery(query);
     return this.client.get("/task", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/tela-sdk-js",
-  "version": "2.10.0",
+  "version": "2.12.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/meistrari/tela-sdk-js.git"