@vertesia/client 0.78.0 → 0.79.0

package/src/store/ObjectsApi.ts

@@ -1,5 +1,6 @@
 import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
 import {
+    ContentObjectApiHeaders,
     ComplexSearchPayload,
     ComputeObjectFacetPayload,
     ContentObject,
@@ -48,7 +49,7 @@ export interface ComputeFacetsResponse {
     type?: { _id: string; count: number }[];
     location?: { _id: string; count: number }[];
     status?: { _id: string; count: number }[];
-    total?: { count: number }[];
+    total?: number;
 }
 
 export interface SearchResponse {
@@ -231,9 +232,18 @@ export class ObjectsApi extends ApiTopic {
         ) {
             createPayload.content = await this.upload(payload.content);
         }
+
+        const headers: Record<string, string> = {};
+        if (options?.processing_priority) {
+            headers[ContentObjectApiHeaders.PROCESSING_PRIORITY] = options.processing_priority;
+        } 
+        if (options?.collection_id) {
+            headers[ContentObjectApiHeaders.COLLECTION_ID] = options.collection_id;
+        }
+
         return await this.post("/", {
             payload: createPayload,
-            query: options || {},
+            headers: headers,
         });
     }
 
@@ -243,11 +253,16 @@ export class ObjectsApi extends ApiTopic {
      * For the s3 blobs you must use a hash with the blob #region. Ex: s3://bucket/path/to/file#us-east-1
      * @param uri
      * @param payload
+     * @param options
      * @returns
      */
     async createFromExternalSource(
         uri: string,
         payload: CreateContentObjectPayload = {},
+        options?: {
+            collection_id?: string;
+            processing_priority?: ContentObjectProcessingPriority;
+        },
     ): Promise<ContentObject> {
         const metadata = await (this.client as ZenoClient).files.getMetadata(
             uri,
@@ -261,8 +276,18 @@ export class ObjectsApi extends ApiTopic {
                 etag: metadata.etag,
             },
         };
+
+        const headers: Record<string, string> = {};
+        if (options?.processing_priority) {
+            headers[ContentObjectApiHeaders.PROCESSING_PRIORITY] = options.processing_priority;
+        } 
+        if (options?.collection_id) {
+            headers[ContentObjectApiHeaders.COLLECTION_ID] = options.collection_id;
+        }
+
         return await this.post("/", {
             payload: createPayload,
+            headers: headers,
         });
     }
 
@@ -298,19 +323,21 @@ export class ObjectsApi extends ApiTopic {
             updatePayload.content = await this.upload(payload.content);
         }
 
+        const headers: Record<string, string> = {};
+        if (options?.processing_priority) {
+            headers[ContentObjectApiHeaders.PROCESSING_PRIORITY] = options.processing_priority;
+        }
         if (options?.createRevision) {
-            return this.put(`/${id}`, {
-                payload: updatePayload,
-                headers: {
-                    "x-create-revision": "true",
-                    "x-revision-label": options.revisionLabel || "",
-                },
-            });
-        } else {
-            return this.put(`/${id}`, {
-                payload: updatePayload,
-            });
+            headers[ContentObjectApiHeaders.CREATE_REVISION] = "true";
+            if (options.revisionLabel) {
+                headers[ContentObjectApiHeaders.REVISION_LABEL] = options.revisionLabel;
+            }
         }
+
+        return this.put(`/${id}`, {
+            payload: updatePayload,
+            headers,
+        });
     }
 
     /**

package/src/store/client.ts

@@ -1,14 +1,15 @@
 import { AbstractFetchClient, RequestError } from "@vertesia/api-fetch-client";
 import { BulkOperationPayload, BulkOperationResult } from "@vertesia/common";
 import { AgentsApi } from "./AgentsApi.js";
+import { CollectionsApi } from "./CollectionsApi.js";
 import { CommandsApi } from "./CommandsApi.js";
 import { EmbeddingsApi } from "./EmbeddingsApi.js";
 import { ZenoClientNotFoundError } from "./errors.js";
 import { FilesApi } from "./FilesApi.js";
 import { ObjectsApi } from "./ObjectsApi.js";
 import { TypesApi } from "./TypesApi.js";
+import { VERSION, VERSION_HEADER } from "./version.js";
 import { WorkflowsApi } from "./WorkflowsApi.js";
-import { CollectionsApi } from "./CollectionsApi.js";
 
 export interface ZenoClientProps {
     serverUrl?: string;
@@ -44,6 +45,15 @@ export class ZenoClient extends AbstractFetchClient<ZenoClient> {
         }
     }
 
+    withApiVersion(version: string | number | null) {
+        if (!version) {
+            delete this.headers[VERSION_HEADER];
+        } else {
+            this.headers[VERSION_HEADER] = String(version);
+        }
+        return this;
+    }
+
     withApiKey(apiKey: string | null) {
         return this.withAuthCallback(
             apiKey ? () => Promise.resolve(`Bearer ${apiKey}`) : undefined
@@ -56,6 +66,13 @@ export class ZenoClient extends AbstractFetchClient<ZenoClient> {
         });
     }
 
+    get initialHeaders() {
+        return {
+            ...super.initialHeaders,
+            [VERSION_HEADER]: VERSION
+        }
+    }
+
     objects = new ObjectsApi(this);
     types = new TypesApi(this);
     workflows = new WorkflowsApi(this);

package/src/store/version.ts

@@ -0,0 +1,2 @@
+export const VERSION = '20250925' // YYYYMMDD, client versioning for API endpoints. Increment manually for breaking changes
+export const VERSION_HEADER = 'x-api-version';