@vertesia/client 1.0.0-dev.20260128.144200 → 1.0.0-dev.20260225.024852Z

package/src/store/RenderingApi.ts

@@ -0,0 +1,105 @@
+import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import {
+    isWorkflowTerminalStatus,
+    RenderMarkdownPollOptions,
+    RenderMarkdownPayload,
+    RenderMarkdownStartResponse,
+    RenderMarkdownStatusResponse,
+    RenderMarkdownResponse,
+    WorkflowExecutionStatus,
+} from "@vertesia/common";
+
+/**
+ * API for rendering markdown documents to PDF or DOCX.
+ * Rendering is performed on workflow workers (not on the API server).
+ */
+export class RenderingApi extends ApiTopic {
+    constructor(parent: ClientBase) {
+        super(parent, "/api/v1/rendering");
+    }
+
+    /**
+     * Render markdown content to PDF or DOCX.
+     *
+     * @param payload - Rendering options including format and either object_id or inline content
+     * @returns Rendering result with download URL
+     *
+     * @example
+     * // Render an existing markdown document
+     * const result = await client.rendering.render({
+     *     format: MarkdownRenditionFormat.pdf,
+     *     object_id: "doc-123"
+     * });
+     * // Download from result.download_url
+     *
+     * @example
+     * // Render inline markdown content
+     * const result = await client.rendering.render({
+     *     format: MarkdownRenditionFormat.docx,
+     *     content: "# My Report\n\nContent here...",
+     *     title: "My Report"
+     * });
+     */
+    start(payload: RenderMarkdownPayload): Promise<RenderMarkdownStartResponse> {
+        return this.post("/jobs", { payload });
+    }
+
+    getStatus(
+        workflowId: string,
+        workflowRunId: string,
+    ): Promise<RenderMarkdownStatusResponse> {
+        return this.get("/jobs/status", {
+            query: {
+                workflow_id: workflowId,
+                workflow_run_id: workflowRunId,
+            },
+        });
+    }
+
+    async render(
+        payload: RenderMarkdownPayload,
+        options: RenderMarkdownPollOptions = {},
+    ): Promise<RenderMarkdownResponse> {
+        const pollIntervalMs = options.pollIntervalMs ?? 1500;
+        const timeoutMs = options.timeoutMs ?? 10 * 60 * 1000;
+
+        const started = await this.start(payload);
+        if (!started.workflow_id || !started.workflow_run_id) {
+            throw new Error("Failed to start rendering workflow");
+        }
+
+        const startTime = Date.now();
+
+        // Poll until workflow reaches terminal state.
+        while (true) {
+            const status = await this.getStatus(started.workflow_id, started.workflow_run_id);
+
+            if (status.status === WorkflowExecutionStatus.COMPLETED) {
+                if (!status.download_url && !status.file_uri) {
+                    throw new Error(status.error || "Rendering completed but no output file was produced");
+                }
+                return {
+                    status: "success",
+                    format: payload.format,
+                    download_url: status.download_url,
+                    file_uri: status.file_uri,
+                };
+            }
+
+            if (isWorkflowTerminalStatus(status.status)) {
+                const statusLabel = WorkflowExecutionStatus[status.status] || String(status.status);
+                throw new Error(status.error || `Rendering failed with status: ${statusLabel}`);
+            }
+
+            if (Date.now() - startTime >= timeoutMs) {
+                throw new Error(`Rendering timed out after ${timeoutMs}ms`);
+            }
+
+            await sleep(pollIntervalMs);
+        }
+    }
+}
+
+function sleep(ms: number): Promise<void> {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/src/store/TypeCatalogApi.ts

@@ -0,0 +1,53 @@
+import { ApiTopic, ClientBase } from '@vertesia/api-fetch-client';
+import { ContentObjectTypeItem, ContentObjectTypeRef } from '@vertesia/common';
+
+
+export class TypeCatalogApi extends ApiTopic {
+    constructor(parent: ClientBase) {
+        super(parent, '/api/v1/types/catalog');
+    }
+
+    /**
+     * List all content types (system + app + stored)
+     */
+    list(query: { tag?: string, limit?: number, offset?: number, layout?: boolean, schema?: boolean } = {}): Promise<ContentObjectTypeItem[]> {
+        return this.get('/', { query });
+    }
+
+    /**
+     * List system types only
+     */
+    listSysTypes(tag?: string): Promise<ContentObjectTypeItem[]> {
+        return this.get('/sys', {
+            query: { tag }
+        });
+    }
+
+    /**
+     * List all app types from all installed apps
+     */
+    listAppTypes(tag?: string): Promise<ContentObjectTypeItem[]> {
+        return this.get('/apps', {
+            query: { tag }
+        });
+    }
+
+    /**
+     * List stored types only
+     */
+    listStoredTypes(query: { tag?: string, limit?: number, offset?: number, layout?: boolean, schema?: boolean } = {}): Promise<ContentObjectTypeItem[]> {
+        return this.get('/stored', {
+            query
+        });
+    }
+
+    /**
+     * Resolve a type to its full definition.
+     * Accepts a string (type ID or code) or a ContentObjectTypeRef (extracts code or id automatically).
+     * @param typeOrRef Type identifier string, or a ContentObjectTypeRef from a content object
+     */
+    resolve(typeOrRef: string | ContentObjectTypeRef): Promise<ContentObjectTypeItem> {
+        const typeId = typeof typeOrRef === 'string' ? typeOrRef : (typeOrRef.code || typeOrRef.id!);
+        return this.get(`/resolve/${typeId}`);
+    }
+}

package/src/store/TypesApi.ts

@@ -1,11 +1,14 @@
 import { ContentObjectType, ContentObjectTypeItem, CreateContentObjectTypePayload, FindPayload, ObjectTypeSearchQuery, ObjectTypeSearchPayload } from "@vertesia/common";
 import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { TypeCatalogApi } from "./TypeCatalogApi.js";
 
 
 export class TypesApi extends ApiTopic {
+    catalog: TypeCatalogApi;
 
     constructor(parent: ClientBase) {
         super(parent, "/api/v1/types");
+        this.catalog = new TypeCatalogApi(parent);
     }
 
     /**

package/src/store/client.ts

@@ -4,11 +4,15 @@ import { CollectionsApi } from "./CollectionsApi.js";
 import { CommandsApi } from "./CommandsApi.js";
 import { DataApi } from "./DataApi.js";
 import { EmailApi } from "./EmailApi.js";
+import { IndexingApi } from "./IndexingApi.js";
 import { EmbeddingsApi } from "./EmbeddingsApi.js";
 import { ZenoClientNotFoundError } from "./errors.js";
 import { FilesApi } from "./FilesApi.js";
+import { HiveMemoryApi } from "./HiveMemoryApi.js";
 import { ObjectsApi } from "./ObjectsApi.js";
 import { PendingAsksApi } from "./PendingAsksApi.js";
+import { QueryApi } from "./QueryApi.js";
+import { RenderingApi } from "./RenderingApi.js";
 import { SchedulesApi } from "./SchedulesApi.js";
 import { ToolsApi } from "./ToolsApi.js";
 import { TypesApi } from "./TypesApi.js";
@@ -92,4 +96,8 @@ export class ZenoClient extends AbstractFetchClient<ZenoClient> {
     pendingAsks = new PendingAsksApi(this);
     data = new DataApi(this);
     tools = new ToolsApi(this);
+    indexing = new IndexingApi(this);
+    query = new QueryApi(this);
+    hiveMemory = new HiveMemoryApi(this);
+    rendering = new RenderingApi(this);
 }

package/src/store/index.ts

@@ -2,10 +2,16 @@ export * from "./client.js";
 export * from "./CommandsApi.js";
 export * from "./DataApi.js";
 export * from "./EmailApi.js";
+export * from "./errors.js";
 export * from "./FilesApi.js";
+export * from "./HiveMemoryApi.js";
+export * from "./IndexingApi.js";
 export * from "./ObjectsApi.js";
 export * from "./PendingAsksApi.js";
+export * from "./QueryApi.js";
+export * from "./RenderingApi.js";
 export * from "./SchedulesApi.js";
+export * from "./TypeCatalogApi.js";
 export * from "./TypesApi.js";
 export * from "./WorkflowsApi.js";
 

package/src/store/version.ts

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