@vertesia/client 1.5.0-dev.20260717.131047Z → 1.5.0-dev.20260722.120446Z

package/src/store/ViewsApi.test.ts

@@ -0,0 +1,33 @@
+import { describe, expect, it, vi } from 'vitest';
+import { ZenoClient } from './client.js';
+
+describe('StoreViewsApi', () => {
+    it('uses the View execution resource for persisted and draft execution', async () => {
+        const requests: Request[] = [];
+        const fetchMock = vi.fn(async () => {
+            return new Response(JSON.stringify({}), {
+                status: 200,
+                headers: { 'content-type': 'application/json' },
+            });
+        });
+        const client = new ZenoClient({
+            serverUrl: 'https://api.example.com',
+            fetch: fetchMock,
+            onRequest: (request) => requests.push(request),
+        });
+
+        await client.views.execute('app:content:document-library');
+        await client.views.preview({
+            configuration: {
+                name: 'Document library',
+                description: 'Browse documents.',
+                scope: {},
+            },
+        });
+
+        expect(requests.map((request) => request.url)).toEqual([
+            'https://api.example.com/api/v1/view-executions/app%3Acontent%3Adocument-library/execute',
+            'https://api.example.com/api/v1/view-executions/preview',
+        ]);
+    });
+});

package/src/store/ViewsApi.ts

@@ -0,0 +1,20 @@
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type { ExecuteViewRequest, PreviewViewExperienceRequest, ViewExecutionResult } from '@vertesia/common';
+
+export class StoreViewsApi extends ApiTopic {
+    constructor(parent: ClientBase) {
+        super(parent, '/api/v1/view-executions');
+    }
+
+    execute(id: string, payload: ExecuteViewRequest = {}): Promise<ViewExecutionResult> {
+        return this.post(`/${encodeURIComponent(id)}/execute`, { payload });
+    }
+
+    /**
+     * Validate and execute an unsaved View configuration without persisting it.
+     * Returns the same normalized results as {@link execute}.
+     */
+    preview(payload: PreviewViewExperienceRequest): Promise<ViewExecutionResult> {
+        return this.post('/preview', { payload });
+    }
+}

package/src/store/client.ts

@@ -24,6 +24,7 @@ import { RenderingApi } from './RenderingApi.js';
 import { SchedulesApi } from './SchedulesApi.js';
 import { TaskApi } from './TaskApi.js';
 import { TypesApi } from './TypesApi.js';
+import { StoreViewsApi } from './ViewsApi.js';
 import { VERSION, VERSION_HEADER } from './version.js';
 import { WorkflowsApi } from './WorkflowsApi.js';
 
@@ -125,4 +126,5 @@ export class ZenoClient extends AbstractFetchClient<ZenoClient> {
     query = new QueryApi(this);
     hiveMemory = new HiveMemoryApi(this);
     rendering = new RenderingApi(this);
+    views = new StoreViewsApi(this);
 }

package/src/store/index.ts

@@ -20,5 +20,6 @@ export * from './signed-url.js';
 export * from './TaskApi.js';
 export * from './TypeCatalogApi.js';
 export * from './TypesApi.js';
+export * from './ViewsApi.js';
 export { APP_VERSION_HEADER } from './version.js';
 export * from './WorkflowsApi.js';