@vertesia/client 1.2.0 → 1.4.0-dev.20260614.160504Z

package/src/store/AnalyzeDocApi.ts

@@ -1,61 +1,79 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import { AdaptedTable, AdaptTablesRequest, DocAnalyzerResultResponse, DocAnalyzeRunStatusResponse, DocImage, DocTableCsv, DocTableJson, ExportTableFormats, GetAdaptedTablesRequestQuery, PdfToRichtextOptions, WorkflowRunStatus } from "@vertesia/common";
+import { ApiTopic, type ClientBase, type IRequestParams } from '@vertesia/api-fetch-client';
+import type {
+    AdaptedTable,
+    AdaptTablesRequest,
+    DocAnalyzeRunStatusResponse,
+    DocAnalyzerResultResponse,
+    DocImage,
+    DocTableCsv,
+    DocTableJson,
+    ExportTableFormats,
+    GetAdaptedTablesRequestQuery,
+    PdfToRichtextOptions,
+    WorkflowRunStatus,
+} from '@vertesia/common';
 
 export class AnalyzeDocApi extends ApiTopic {
-    constructor(parent: ClientBase, public objectId: string) {
+    constructor(
+        parent: ClientBase,
+        public objectId: string,
+    ) {
         super(parent, `/${objectId}/analyze`);
     }
 
     async start(payload: PdfToRichtextOptions): Promise<DocAnalyzeRunStatusResponse> {
-        return this.post("/", { payload });
+        return this.post('/', { payload });
     }
 
     async getStatus(): Promise<DocAnalyzeRunStatusResponse> {
-        return this.get("/status");
+        return this.get('/status');
     }
 
     async getResults(): Promise<DocAnalyzerResultResponse> {
-        return this.get("/results");
+        return this.get('/results');
     }
 
     async adaptTables(payload: AdaptTablesRequest): Promise<WorkflowRunStatus> {
-        return this.post("/adapt_tables", { payload });
+        return this.post('/adapt_tables', { payload });
     }
 
-    async getAdaptedTables(runId?: string, query?: GetAdaptedTablesRequestQuery): Promise<Record<number, AdaptedTable>> {
-        const path = runId ? `/adapt_tables/${runId}` : "/adapt_tables";
-        
+    async getAdaptedTables(
+        runId?: string,
+        query?: GetAdaptedTablesRequestQuery,
+    ): Promise<Record<number, AdaptedTable>> {
+        const path = runId ? `/adapt_tables/${runId}` : '/adapt_tables';
+
         // Build query parameters
-        const queryParams: any = {};
+        const queryParams: NonNullable<IRequestParams['query']> = {};
         if (query?.format) queryParams.format = query.format;
         if (query?.raw !== undefined) queryParams.raw = query.raw;
-        
+
         // If format is CSV, set response type to text to avoid automatic JSON parsing
-        const options: any = { query: queryParams };
+        const options: IRequestParams & { responseType?: 'text' } = { query: queryParams };
         if (query?.format === 'csv') {
             options.responseType = 'text';
         }
-        
+
         return this.get(path, options);
     }
 
     async getXml(): Promise<string> {
-        return this.get("/xml");
+        return this.get('/xml');
     }
 
     async getTables(format?: ExportTableFormats): Promise<DocTableCsv[] | DocTableJson[]> {
-        const options: any = {};
+        const options: IRequestParams = {};
         if (format) {
-            options.query = {format: format}
+            options.query = { format: format };
         }
-        return this.get("/tables", options);
+        return this.get('/tables', options);
     }
 
     async getImages(): Promise<DocImage[]> {
-        return this.get("/images");
+        return this.get('/images');
     }
 
     async getAnnotated(): Promise<{ url: string }> {
-        return this.get("/annotated");
+        return this.get('/annotated');
     }
-}
+}

package/src/store/CollectionsApi.ts

@@ -1,42 +1,40 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import {
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type {
     Collection,
     ComplexCollectionSearchQuery,
     ComplexSearchPayload,
     ComputeCollectionFacetPayload,
-    ComputeObjectFacetPayload,
     ComputedFacetResponse,
+    ComputeObjectFacetPayload,
     ContentObjectItem,
     ContentObjectStatus,
     CreateCollectionPayload,
     DynamicCollection,
-    ObjectSearchResponse
-} from "@vertesia/common";
-
+    ObjectSearchResponse,
+} from '@vertesia/common';
 
 export class CollectionsApi extends ApiTopic {
-
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/collections");
+        super(parent, '/api/v1/collections');
     }
 
     /**
      * List collections
      * @param payload: CollectionSearchPayload
      * @returns Collection[] list of collections
-    **/
+     **/
     search(payload: ComplexCollectionSearchQuery): Promise<Collection[]> {
-        return this.post("/search", { payload });
+        return this.post('/search', { payload });
     }
 
     /**
      * Compute facets for List collections
      * @param query: ComputeCollectionFacetPayload
      * @returns ComputeFacetsResponse list of facets
-    **/
+     **/
     computeListFacets(query: ComputeCollectionFacetPayload): Promise<ComputedFacetResponse> {
-        return this.post("/facets", {
-            payload: query
+        return this.post('/facets', {
+            payload: query,
         });
     }
 
@@ -51,13 +49,13 @@ export class CollectionsApi extends ApiTopic {
 
     create(payload: CreateCollectionPayload): Promise<Collection> {
         return this.post(`/`, {
-            payload
+            payload,
         });
     }
 
     update(collectionId: string, payload: Partial<CreateCollectionPayload>): Promise<{ id: string }> {
         return this.put(`/${collectionId}`, {
-            payload
+            payload,
         });
     }
 
@@ -65,27 +63,30 @@ export class CollectionsApi extends ApiTopic {
         return this.post(`/${collectionId}/members`, {
             payload: {
                 action: 'add',
-                members
-            }
+                members,
+            },
         });
     }
 
-    listMembers(collectionId: string, payload: {
-        limit?: number,
-        offset?: number,
-        status?: ContentObjectStatus,
-        type?: string,
-    }): Promise<ContentObjectItem[]> {
+    listMembers(
+        collectionId: string,
+        payload: {
+            limit?: number;
+            offset?: number;
+            status?: ContentObjectStatus;
+            type?: string;
+        },
+    ): Promise<ContentObjectItem[]> {
         return this.get(`/${collectionId}/members`, {
             query: {
-                ...payload
-            }
+                ...payload,
+            },
         });
     }
 
     computeFacets(collectionId: string, query: ComputeObjectFacetPayload): Promise<ComputedFacetResponse> {
         return this.post(`/${collectionId}/facets`, {
-            payload: query
+            payload: query,
         });
     }
 
@@ -97,8 +98,8 @@ export class CollectionsApi extends ApiTopic {
         return this.post(`/${collectionId}/members`, {
             payload: {
                 action: 'delete',
-                members
-            }
+                members,
+            },
         });
     }
 
@@ -106,8 +107,8 @@ export class CollectionsApi extends ApiTopic {
         return this.post(`/${collectionId}/children`, {
             payload: {
                 action: 'add',
-                children
-            }
+                children,
+            },
         });
     }
 
@@ -115,14 +116,14 @@ export class CollectionsApi extends ApiTopic {
         return this.post(`/${collectionId}/children`, {
             payload: {
                 action: 'delete',
-                children
-            }
+                children,
+            },
         });
     }
 
     searchChildren(collectionId: string, query: ComplexCollectionSearchQuery = {}): Promise<Collection[]> {
         return this.post(`/${collectionId}/children/search`, {
-            payload: query
+            payload: query,
         });
     }
 
@@ -136,12 +137,15 @@ export class CollectionsApi extends ApiTopic {
      * @param permissions - Map of permission types to principal arrays
      * @returns Object with collection id, updated security, and number of objects updated
      */
-    updatePermissions(collectionId: string, permissions: Record<string, string[]>): Promise<{
+    updatePermissions(
+        collectionId: string,
+        permissions: Record<string, string[]>,
+    ): Promise<{
         id: string;
         security: Record<string, string[]>;
     }> {
         return this.put(`/${collectionId}/permissions`, {
-            payload: permissions
+            payload: permissions,
         });
     }
 
@@ -168,10 +172,8 @@ export class CollectionsApi extends ApiTopic {
     propagateSharedProperties(collectionId: string): Promise<{
         id: string;
         message: string;
-        shared_properties: string[]
+        shared_properties: string[];
     }> {
         return this.post(`/${collectionId}/propagate-shared-props`);
     }
-
-
 }

package/src/store/CostApi.ts

@@ -1,5 +1,5 @@
-import { ApiTopic, ClientBase } from '@vertesia/api-fetch-client';
-import {
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type {
     CostAnalyticsQuery,
     CostAnalyticsResponse,
     CostExportQuery,
@@ -19,9 +19,7 @@ export class CostApi extends ApiTopic {
      * Returns cost breakdown by model/environment with pricing from billing export.
      * Covers all inference types: direct, agent, embedding.
      */
-    getAnalytics(
-        query: CostAnalyticsQuery = {}
-    ): Promise<CostAnalyticsResponse> {
+    getAnalytics(query: CostAnalyticsQuery = {}): Promise<CostAnalyticsResponse> {
         return this.post('/analytics', { payload: query });
     }
 
@@ -29,36 +27,28 @@ export class CostApi extends ApiTopic {
      * Get platform-wide cost analytics across all customers.
      * Requires Vertesia staff privileges. Defaults to group_by='account'.
      */
-    getGlobalAnalytics(
-        query: CostAnalyticsQuery = {}
-    ): Promise<CostAnalyticsResponse> {
+    getGlobalAnalytics(query: CostAnalyticsQuery = {}): Promise<CostAnalyticsResponse> {
         return this.post('/analytics/global', { payload: query });
     }
 
     /**
      * Get current list prices and effective prices for the selected period.
      */
-    getModelPrices(
-        query: CostModelPricesQuery = {}
-    ): Promise<ModelPriceComparisonResponse> {
+    getModelPrices(query: CostModelPricesQuery = {}): Promise<ModelPriceComparisonResponse> {
         return this.get('/model-prices', { query: { ...query } });
     }
 
     /**
      * Price a single interaction run or agent run.
      */
-    getRunPrice(
-        query: CostRunPriceQuery
-    ): Promise<CostRunPriceResponse> {
+    getRunPrice(query: CostRunPriceQuery): Promise<CostRunPriceResponse> {
         return this.post('/run-price', { payload: query });
     }
 
     /**
      * Price a run and include the full model pricing catalog for comparison.
      */
-    getRunPriceComparison(
-        query: CostRunPriceQuery
-    ): Promise<CostRunPriceResponse> {
+    getRunPriceComparison(query: CostRunPriceQuery): Promise<CostRunPriceResponse> {
         return this.post('/run-price', { payload: { ...query, include_comparison_pricing: true } });
     }
 
@@ -67,8 +57,13 @@ export class CostApi extends ApiTopic {
      */
     getExportUrl(params?: CostExportQuery): string {
         const searchParams = new URLSearchParams();
-        if (params?.from) searchParams.set('from', typeof params.from === 'number' ? new Date(params.from).toISOString() : params.from);
-        if (params?.to) searchParams.set('to', typeof params.to === 'number' ? new Date(params.to).toISOString() : params.to);
+        if (params?.from)
+            searchParams.set(
+                'from',
+                typeof params.from === 'number' ? new Date(params.from).toISOString() : params.from,
+            );
+        if (params?.to)
+            searchParams.set('to', typeof params.to === 'number' ? new Date(params.to).toISOString() : params.to);
         if (params?.scope) searchParams.set('scope', params.scope);
         if (params?.project_id) searchParams.set('project_id', params.project_id);
         if (params?.workflow_id) searchParams.set('workflow_id', params.workflow_id);

package/src/store/DashboardApi.ts

@@ -1,20 +1,20 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import {
-    CreateDashboardPayload,
-    CreateDashboardSnapshotPayload,
-    Dashboard,
-    DashboardArchiveResult,
-    DashboardBulkArchiveResult,
-    DashboardBulkDeleteResult,
-    DashboardItem,
-    DashboardStatus,
-    DashboardVersion,
-    DashboardVersionItem,
-    DashboardVersioningStatusResponse,
+    type CreateDashboardPayload,
+    type CreateDashboardSnapshotPayload,
+    type Dashboard,
+    type DashboardArchiveResult,
+    type DashboardBulkArchiveResult,
+    type DashboardBulkDeleteResult,
+    type DashboardItem,
+    type DashboardStatus,
+    type DashboardVersion,
+    type DashboardVersionItem,
+    type DashboardVersioningStatusResponse,
     DataStoreApiHeaders,
-    PromoteDashboardVersionPayload,
-    UpdateDashboardPayload,
-} from "@vertesia/common";
+    type PromoteDashboardVersionPayload,
+    type UpdateDashboardPayload,
+} from '@vertesia/common';
 
 /**
  * Client API for managing Vega-based dashboards linked to data stores.
@@ -86,7 +86,7 @@ export class DashboardApi extends ApiTopic {
      * ```
      */
     create(payload: CreateDashboardPayload): Promise<Dashboard> {
-        return this.post("/", { payload, headers: this.storeHeaders() });
+        return this.post('/', { payload, headers: this.storeHeaders() });
     }
 
     /**
@@ -153,7 +153,7 @@ export class DashboardApi extends ApiTopic {
      */
     listVersions(
         dashboardId: string,
-        options?: { snapshotsOnly?: boolean; limit?: number }
+        options?: { snapshotsOnly?: boolean; limit?: number },
     ): Promise<DashboardVersionItem[]> {
         const params = new URLSearchParams();
         if (options?.snapshotsOnly) params.set('snapshots_only', 'true');
@@ -180,10 +180,7 @@ export class DashboardApi extends ApiTopic {
      * @param payload - Snapshot name and message
      * @returns The created snapshot version
      */
-    createSnapshot(
-        dashboardId: string,
-        payload: CreateDashboardSnapshotPayload
-    ): Promise<DashboardVersionItem> {
+    createSnapshot(dashboardId: string, payload: CreateDashboardSnapshotPayload): Promise<DashboardVersionItem> {
         return this.post(`/${dashboardId}/versions`, { payload, headers: this.storeHeaders() });
     }
 
@@ -199,9 +196,12 @@ export class DashboardApi extends ApiTopic {
     promoteVersion(
         dashboardId: string,
         versionId: string,
-        payload?: PromoteDashboardVersionPayload
+        payload?: PromoteDashboardVersionPayload,
     ): Promise<Dashboard> {
-        return this.post(`/${dashboardId}/versions/${versionId}/promote`, { payload: payload || {}, headers: this.storeHeaders() });
+        return this.post(`/${dashboardId}/versions/${versionId}/promote`, {
+            payload: payload || {},
+            headers: this.storeHeaders(),
+        });
     }
 
     /**
@@ -211,10 +211,7 @@ export class DashboardApi extends ApiTopic {
      * @param enabled - Whether versioning should be enabled
      * @returns The updated versioning state
      */
-    setVersioningEnabled(
-        dashboardId: string,
-        enabled: boolean
-    ): Promise<DashboardVersioningStatusResponse> {
+    setVersioningEnabled(dashboardId: string, enabled: boolean): Promise<DashboardVersioningStatusResponse> {
         return this.put(`/${dashboardId}/versioning`, { payload: { enabled }, headers: this.storeHeaders() });
     }
 }

package/src/store/DataApi.ts

@@ -1,30 +1,30 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import {
-    AlterTablePayload,
-    BatchQueryResult,
-    CreateDataStorePayload,
-    CreateSnapshotPayload,
-    CreateTablesPayload,
-    DataSchema,
-    DataSchemaForAI,
-    DataStoreArchiveResult,
-    DataStore,
+    type AlterTablePayload,
+    type BatchQueryResult,
+    type CreateDataStorePayload,
+    type CreateSnapshotPayload,
+    type CreateTablesPayload,
+    type DataSchema,
+    type DataSchemaForAI,
+    type DataStore,
     DataStoreApiHeaders,
-    DataStoreDownloadInfo,
-    DataStoreItem,
-    DataStoreVersion,
-    DataTable,
-    DataStoreTableDetail,
-    DataStoreTableDropResult,
-    DataTableSummary,
-    ImportDataPayload,
-    ImportJob,
-    QueryPayload,
-    QueryResult,
-    QueryValidationResult,
-    UpdateSchemaPayload,
-} from "@vertesia/common";
-import { DashboardApi } from "./DashboardApi.js";
+    type DataStoreArchiveResult,
+    type DataStoreDownloadInfo,
+    type DataStoreItem,
+    type DataStoreTableDetail,
+    type DataStoreTableDropResult,
+    type DataStoreVersion,
+    type DataTable,
+    type DataTableSummary,
+    type ImportDataPayload,
+    type ImportJob,
+    type QueryPayload,
+    type QueryResult,
+    type QueryValidationResult,
+    type UpdateSchemaPayload,
+} from '@vertesia/common';
+import { DashboardApi } from './DashboardApi.js';
 
 /**
  * Client API for managing versioned analytical data stores.
@@ -37,7 +37,7 @@ import { DashboardApi } from "./DashboardApi.js";
  */
 export class DataApi extends ApiTopic {
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/data");
+        super(parent, '/api/v1/data');
     }
 
     /**
@@ -56,7 +56,7 @@ export class DataApi extends ApiTopic {
      * List all data stores in the project.
      */
     list(): Promise<DataStoreItem[]> {
-        return this.get("/");
+        return this.get('/');
     }
 
     /**
@@ -74,7 +74,7 @@ export class DataApi extends ApiTopic {
      * ```
      */
     create(payload: CreateDataStorePayload): Promise<DataStore> {
-        return this.post("/", { payload });
+        return this.post('/', { payload });
     }
 
     /**
@@ -418,10 +418,7 @@ export class DataApi extends ApiTopic {
      * }
      * ```
      */
-    validateQueries(
-        id: string,
-        queries: Array<{ name: string; sql: string }>
-    ): Promise<QueryValidationResult> {
+    validateQueries(id: string, queries: Array<{ name: string; sql: string }>): Promise<QueryValidationResult> {
         return this.post(`/${id}/query/validate`, { payload: { queries }, headers: this.storeHeaders(id) });
     }
 

package/src/store/EmailApi.ts

@@ -1,5 +1,5 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import { EmailRouteData } from "@vertesia/common";
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type { EmailRouteData } from '@vertesia/common';
 
 /**
  * Request payload for sending an email via the agent.
@@ -110,7 +110,7 @@ export interface CreateRouteRequest {
  */
 export class EmailApi extends ApiTopic {
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/email");
+        super(parent, '/api/v1/email');
     }
 
     /**
@@ -118,7 +118,7 @@ export class EmailApi extends ApiTopic {
      * Creates a route key if not provided, sends via Resend, and returns routing info.
      */
     send(request: SendEmailRequest): Promise<SendEmailResponse> {
-        return this.post("/send", { payload: request });
+        return this.post('/send', { payload: request });
     }
 
     /**
@@ -127,7 +127,7 @@ export class EmailApi extends ApiTopic {
      * @deprecated Use getRoute() instead
      */
     resolveRoute(routeKey: string): Promise<EmailRouteData> {
-        return this.post("/resolve-route", { payload: { route_key: routeKey } });
+        return this.post('/resolve-route', { payload: { route_key: routeKey } });
     }
 
     // ============================================================================
@@ -151,7 +151,7 @@ export class EmailApi extends ApiTopic {
      * ```
      */
     createRoute(request: CreateRouteRequest): Promise<CreateRouteResponse> {
-        return this.post("/routes", { payload: request });
+        return this.post('/routes', { payload: request });
     }
 
     /**

package/src/store/EmbeddingsApi.ts

@@ -1,39 +1,39 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import {
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type {
     EmbeddingsStatusResponse,
     GenericCommandResponse,
-    ProjectConfigurationEmbeddings,
+    ProjectConfigurationEmbeddingEnablePayload,
     SupportedEmbeddingTypes,
-} from "@vertesia/common";
+} from '@vertesia/common';
 
 /**
  * @since 0.52.0
  */
 export class EmbeddingsApi extends ApiTopic {
-
-    constructor(parent: ClientBase, basePath: string = "/api/v1/embeddings") {
+    constructor(parent: ClientBase, basePath: string = '/api/v1/embeddings') {
         super(parent, basePath);
     }
 
     async status(type: SupportedEmbeddingTypes): Promise<EmbeddingsStatusResponse> {
-        return this.get(type + "/status");
+        return this.get(`${type}/status`);
     }
 
-    async activate(type: SupportedEmbeddingTypes, config: Partial<ProjectConfigurationEmbeddings>): Promise<GenericCommandResponse> {
-
+    async activate(
+        type: SupportedEmbeddingTypes,
+        config: ProjectConfigurationEmbeddingEnablePayload,
+    ): Promise<GenericCommandResponse> {
         if (!config.environment) {
-            throw new Error("Invalid configuration: select environment");
+            throw new Error('Invalid configuration: select environment');
         }
 
-        return this.post(type + "/enable", { payload: config });
+        return this.post(`${type}/enable`, { payload: config });
     }
 
     async disable(type: SupportedEmbeddingTypes): Promise<GenericCommandResponse> {
-        return this.post(type + "/disable");
+        return this.post(`${type}/disable`);
     }
 
     async recalculate(type: SupportedEmbeddingTypes): Promise<GenericCommandResponse> {
-        return this.post(type + "/recalculate");
+        return this.post(`${type}/recalculate`);
     }
-
-}
+}