@xpert-ai/plugin-live-dashboard 0.4.1 → 0.6.0

package/dist/lib/view.provider.d.ts

@@ -1,8 +1,10 @@
+import { DashboardSaveRequests } from './save-requests';
 import { DashboardProjectsService } from './projects.service';
-import type { XpertExtensionViewManifest, XpertResolvedViewHostContext, XpertViewActionRequest, XpertViewQuery } from '@xpert-ai/contracts';
-import { type IXpertViewExtensionProvider } from '@xpert-ai/plugin-sdk';
+import type { XpertExtensionViewManifest, XpertResolvedViewHostContext, XpertViewActionRequest, XpertViewQuery, XpertViewFileAccessRequest } from '@xpert-ai/contracts';
+import { type IXpertViewExtensionProvider, type XpertViewFileActionFile } from '@xpert-ai/plugin-sdk';
 import { DashboardService } from './dashboard.service';
 import { DashboardSharingService } from './sharing.service';
+import { DashboardArchiveService } from './archive.service';
 export declare const VIEW_KEY = "live-dashboard";
 export declare const VIEW_PROVIDER = "live-dashboard";
 export declare const FEATURE = "live_dashboard";
@@ -10,7 +12,9 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
     private readonly service;
     private readonly sharing;
     private readonly projects;
-    constructor(service: DashboardService, sharing: DashboardSharingService, projects: DashboardProjectsService);
+    private readonly archives;
+    private readonly saves?;
+    constructor(service: DashboardService, sharing: DashboardSharingService, projects: DashboardProjectsService, archives: DashboardArchiveService, saves?: DashboardSaveRequests | undefined);
     supports(context: XpertResolvedViewHostContext): boolean;
     getViewManifests(context: XpertResolvedViewHostContext, slot: string): XpertExtensionViewManifest[];
     getRemoteComponentEntry(): Promise<{
@@ -57,9 +61,9 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
         } | {
             saved: {
                 manifest: {
-                    schema: "xpert.live-dashboard";
-                    id: string;
                     title: string;
+                    id: string;
+                    schema: "xpert.live-dashboard";
                     bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
                     controls: {
                         type: "string" | "number" | "boolean" | "date";
@@ -70,19 +74,34 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
                     }[];
                     charts: {
                         type: "bar" | "line" | "area" | "pie" | "scatter";
-                        id: string;
                         title: string;
+                        id: string;
                         datasetId: string;
                         x: string;
                         y: string;
                         color?: string | undefined;
                     }[];
                     tables: {
-                        id: string;
                         title: string;
+                        id: string;
                         datasetId: string;
                         fields: string[];
                     }[];
+                    sourceMetadata?: {
+                        bindingId: string;
+                        title: string;
+                        description?: string | undefined;
+                    }[] | undefined;
+                    components?: {
+                        title: string;
+                        id: string;
+                        elementId: string;
+                        kind: "filter" | "metric" | "chart" | "table" | "text";
+                        sources: {
+                            bindingId: string;
+                            fieldIds?: string[] | undefined;
+                        }[];
+                    }[] | undefined;
                     presentation?: {
                         type: "html";
                         html: string;
@@ -100,7 +119,7 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
                 artifactId: string;
                 versionId: string | null | undefined;
                 versionNumber: number | undefined;
-            };
+            } | undefined;
             versions: {
                 current: boolean;
                 artifactId: string;
@@ -181,6 +200,49 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
         };
     }>;
     executeViewAction(context: XpertResolvedViewHostContext, viewKey: string, action: string, request: XpertViewActionRequest): Promise<{
+        success: boolean;
+        data: {
+            artifactId: string;
+            draftId: string;
+            draftRevision: number;
+            baseVersionId: string | null;
+            status: "draft";
+            title: string;
+        } | {
+            cursor: string;
+            nextAction: string;
+            error?: string | undefined;
+            sourceFile?: {
+                path: string;
+                sha256: string;
+            } | undefined;
+            dashboard?: {
+                status: "draft";
+                title: string;
+                artifactId: string;
+                draftRevision: number;
+                draftId: string;
+                baseVersionId: string | null;
+            } | undefined;
+            requestId: string;
+            state: "failed" | "running" | "succeeded" | "queued";
+            stage: string;
+            completed: number;
+            total: number;
+            terminal: boolean;
+        };
+        refresh: boolean;
+    } | {
+        success: boolean;
+        data: import("@xpert-ai/contracts").AnalyticsDiscoveryResult;
+        refresh: boolean;
+    } | {
+        success: boolean;
+        data: {
+            discarded: boolean;
+        };
+        refresh: boolean;
+    } | {
         success: boolean;
         data: {
             canEdit: boolean;
@@ -239,9 +301,152 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
             artifactId: string;
         };
         refresh: boolean;
+    } | {
+        success: boolean;
+        data: {
+            payload?: {
+                ok: boolean;
+                widget_type: string;
+                surface: string;
+                sources: never[];
+                manifest: {
+                    version: number;
+                    surface: string;
+                    title: string;
+                    cards: never[];
+                    filters: never[];
+                    sources: never[];
+                    charts: {
+                        id: string;
+                        title: string;
+                        type: "bar" | "line" | "area" | "pie" | "scatter";
+                        dataset: string;
+                        encodings: {
+                            color?: {
+                                field: string;
+                            } | undefined;
+                            x: {
+                                field: string;
+                            };
+                            y: {
+                                field: string;
+                            };
+                        };
+                    }[];
+                    tables: {
+                        id: string;
+                        title: string;
+                        dataset: string;
+                        columns: {
+                            field: string;
+                            label: string;
+                        }[];
+                    }[];
+                    blocks: ({
+                        id: string;
+                        type: string;
+                        chartId: string;
+                    } | {
+                        id: string;
+                        type: string;
+                        tableId: string;
+                    })[];
+                };
+                snapshot: {
+                    version: number;
+                    generatedAt: string;
+                    status: string;
+                    datasets: any;
+                };
+            } | undefined;
+            datasets: import("@xpert-ai/contracts").AnalyticalDataset[];
+            failures: {
+                bindingId: string;
+                datasetId: string;
+                reason: "unavailable";
+            }[];
+        };
+        refresh: boolean;
     } | {
         success: boolean;
         data: import("@xpert-ai/contracts").AnalyticalDataset;
         refresh: boolean;
     }>;
+    executeViewFileAction(context: XpertResolvedViewHostContext, viewKey: string, action: string, _request: XpertViewActionRequest, file: XpertViewFileActionFile): Promise<{
+        success: boolean;
+        data: {
+            importId: `${string}-${string}-${string}-${string}-${string}`;
+            manifest: {
+                title: string;
+                id: string;
+                schema: "xpert.live-dashboard";
+                bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
+                controls: {
+                    type: "string" | "number" | "boolean" | "date";
+                    controlId: string;
+                    label: string;
+                    defaultValue?: string | number | boolean | null | undefined;
+                    allowedValues?: (string | number | boolean | null)[] | undefined;
+                }[];
+                charts: {
+                    type: "bar" | "line" | "area" | "pie" | "scatter";
+                    title: string;
+                    id: string;
+                    datasetId: string;
+                    x: string;
+                    y: string;
+                    color?: string | undefined;
+                }[];
+                tables: {
+                    title: string;
+                    id: string;
+                    datasetId: string;
+                    fields: string[];
+                }[];
+                sourceMetadata?: {
+                    bindingId: string;
+                    title: string;
+                    description?: string | undefined;
+                }[] | undefined;
+                components?: {
+                    title: string;
+                    id: string;
+                    elementId: string;
+                    kind: "filter" | "metric" | "chart" | "table" | "text";
+                    sources: {
+                        bindingId: string;
+                        fieldIds?: string[] | undefined;
+                    }[];
+                }[] | undefined;
+                presentation?: {
+                    type: "html";
+                    html: string;
+                    dependencies?: import("@xpert-ai/plugin-sdk/artifact-document").ArtifactDocumentDependencyLock[] | undefined;
+                } | undefined;
+            };
+            requirements: {
+                schema: string;
+                version: number;
+                bindings: {
+                    id: string;
+                    providerId: string;
+                    operation: string;
+                    contractVersion: number;
+                    source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+                }[];
+                externalResources: string[];
+                dynamicResourcesMayExist: boolean;
+                includesQueryResults: boolean;
+                requiresAuthorizedHost: boolean;
+            };
+            sources: import("@xpert-ai/contracts").AnalyticsSourceSummary[];
+        };
+        refresh: boolean;
+    }>;
+    resolveViewFile(context: XpertResolvedViewHostContext, viewKey: string, request: XpertViewFileAccessRequest): Promise<{
+        reference: import("@xpert-ai/plugin-sdk").WorkspacePortableFileReference;
+        fileName: string;
+        mimeType: string;
+        size: number;
+    }>;
 }

package/dist/lib/view.provider.js

@@ -8,8 +8,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DashboardViewProvider = exports.FEATURE = exports.VIEW_PROVIDER = exports.VIEW_KEY = void 0;
+const node_crypto_1 = require("node:crypto");
+const save_requests_1 = require("./save-requests");
 const projects_service_1 = require("./projects.service");
 const projects_schema_1 = require("./projects.schema");
 const common_1 = require("@nestjs/common");
@@ -24,15 +29,19 @@ const dashboard_receipt_1 = require("./dashboard-receipt");
 const dashboard_navigation_1 = require("./dashboard-navigation");
 const project_1 = require("./project");
 const dashboard_icon_1 = require("./dashboard-icon");
+const dashboard_sources_1 = require("./dashboard-sources");
+const archive_service_1 = require("./archive.service");
 exports.VIEW_KEY = 'live-dashboard';
 exports.VIEW_PROVIDER = 'live-dashboard';
 exports.FEATURE = 'live_dashboard';
 const text = (en_US, zh_Hans) => ({ en_US, zh_Hans });
 let DashboardViewProvider = class DashboardViewProvider {
-    constructor(service, sharing, projects) {
+    constructor(service, sharing, projects, archives, saves) {
         this.service = service;
         this.sharing = sharing;
         this.projects = projects;
+        this.archives = archives;
+        this.saves = saves;
     }
     supports(context) { return context.hostType === 'agent'; }
     getViewManifests(context, slot) {
@@ -44,6 +53,7 @@ let DashboardViewProvider = class DashboardViewProvider {
                 workbench: { projectType: project_1.DASHBOARD_PROJECT_TYPE, fixed: true, openMode: 'on-demand', menu: { enabled: true, label: text('Live dashboards', '实时看板'), icon: dashboard_icon_1.dashboardIcon, order: 35 } },
                 view: { type: 'remote_component', runtime: 'react', protocolVersion: 1, component: { isolation: 'iframe', entry: exports.VIEW_KEY }, dataSource: { mode: 'platform' } },
                 dataSource: { mode: 'platform', querySchema: { supportsSelection: true, supportsParameters: true, supportsPagination: true, defaultPageSize: 50 }, cache: { enabled: false } },
+                fileAccess: { purposes: ['download'] },
                 clientCommands: [{ key: 'workbench.content.status' }, { key: 'workbench.content.resolve' }, { key: contracts_1.ASSISTANT_CONTEXT_SET_COMMAND, label: text('Select dashboard for Assistant', '设置助理当前看板') },
                     { key: contracts_1.ASSISTANT_CHAT_SEND_MESSAGE_COMMAND, label: text('Create with Assistant', '交给助理制作') },
                     { key: contracts_1.ARTIFACT_PRESENTATION_OPEN_COMMAND, label: text('Open shared page', '打开独立页面') },
@@ -51,6 +61,8 @@ let DashboardViewProvider = class DashboardViewProvider {
                 hostEvents: { subscriptions: [{ key: 'dashboard-created', event: 'assistant.tool.completed',
                             filter: { toolNames: dashboard_receipt_1.DASHBOARD_MUTATION_TOOLS }, action: { type: 'forward', debounceMs: 0 } }] },
                 actions: [
+                    { key: 'import-preview', label: text('Import dashboard file', '导入看板文件'), actionType: 'invoke', transport: 'file' },
+                    ...['import-commit', 'import-discard', 'import-browse', 'save-wait', 'save-status'].map(key => ({ key, label: text('Import dashboard', '导入看板'), actionType: 'invoke' })),
                     ...[
                         { key: 'dashboards', label: text('Select dashboard', '选择看板') },
                         { key: 'projects', label: text('Select project', '选择项目') },
@@ -80,15 +92,28 @@ let DashboardViewProvider = class DashboardViewProvider {
             : undefined;
         const versions = params.artifactId ? await this.service.history(context, params.artifactId) : undefined;
         const unavailable = params.artifactId && mode === 'published' && !params.versionId && !versions?.some(version => version.current);
+        const saved = !unavailable && params.artifactId ? await this.service.openDocument(context, params.artifactId, params.versionId, params.draftRevision, mode) : undefined;
         return { meta: { navigationTarget: (0, dashboard_navigation_1.dashboardNavigationTarget)(context), access, mode, currentProject,
                 dashboards: page.items, selectedDashboard, pagination: { page: page.page, pageSize: page.pageSize, hasMore: page.hasMore },
                 sources: access.canEdit ? await this.service.sources(context) : [],
                 ...(unavailable ? { notice: 'not_published' } : params.artifactId ? {
-                    saved: await this.service.openDocument(context, params.artifactId, params.versionId, params.draftRevision, mode), versions
+                    saved: saved && { ...saved, manifest: access.canEdit ? saved.manifest : (0, dashboard_sources_1.publicDashboardManifest)(saved.manifest) }, versions
                 } : {}) } };
     }
     async executeViewAction(context, viewKey, action, request) {
         assertView(viewKey);
+        if (action === 'save-wait' && this.saves) {
+            const input = save_requests_1.waitSaveRequestSchema.parse(request.input);
+            return { success: true, data: await this.saves.wait(context, input.requestId, input.cursor), refresh: false };
+        }
+        if (action === 'save-status' && this.saves)
+            return { success: true, data: await this.saves.get(context, save_requests_1.saveRequestSchema.parse(request.input).requestId), refresh: false };
+        if (action === 'import-commit')
+            return { success: true, data: await this.archives.commit(context, archive_service_1.importInputSchema.parse(request.input)), refresh: false };
+        if (action === 'import-browse')
+            return { success: true, data: await this.archives.browse(context, archive_service_1.importBrowseSchema.parse(request.input)), refresh: false };
+        if (action === 'import-discard')
+            return { success: true, data: await this.archives.discard(context, v3_1.z.object({ importId: v3_1.z.string().uuid() }).strict().parse(request.input).importId), refresh: false };
         if (action === 'dashboards') {
             const parsed = projects_schema_1.dashboardSearchSchema.safeParse(request.input);
             if (!parsed.success)
@@ -124,11 +149,15 @@ let DashboardViewProvider = class DashboardViewProvider {
         }
         if (action === 'save') {
             const input = dashboard_schema_1.saveSchema.parse(request.input);
-            return { success: true, data: await this.service.save(context, input.manifest, input.expectedVersionId, input.expectedRevision), refresh: false };
+            const data = this.saves && input.manifest.bindings.length > 8
+                ? await this.saves.submit(context, input.manifest, input.expectedVersionId, input.expectedRevision, (0, node_crypto_1.createHash)('sha256').update(JSON.stringify(input)).digest('hex'))
+                : await this.service.save(context, input.manifest, input.expectedVersionId, input.expectedRevision);
+            return { success: true, data, refresh: false };
         }
         if (action === 'query') {
             const input = dashboard_schema_1.querySchema.parse(request.input);
-            return { success: true, data: await this.service.query(context, input.artifactId, input.versionId, input.controls, input.draftRevision), refresh: false };
+            const result = await this.service.query(context, input.artifactId, input.versionId, input.controls, input.draftRevision);
+            return { success: true, data: { datasets: result.datasets, failures: result.failures, ...('payload' in result ? { payload: result.payload } : {}) }, refresh: false };
         }
         if (action === 'query-binding') {
             const parsed = dashboard_schema_1.queryBindingSchema.safeParse(request.input);
@@ -139,11 +168,24 @@ let DashboardViewProvider = class DashboardViewProvider {
         }
         throw new common_1.BadRequestException('DASHBOARD_ACTION_UNSUPPORTED');
     }
+    async executeViewFileAction(context, viewKey, action, _request, file) {
+        assertView(viewKey);
+        if (action !== 'import-preview')
+            throw new common_1.BadRequestException('DASHBOARD_ACTION_UNSUPPORTED');
+        return { success: true, data: await this.archives.prepare(context, file.buffer), refresh: false };
+    }
+    async resolveViewFile(context, viewKey, request) {
+        assertView(viewKey);
+        if (request.purpose !== 'download')
+            throw new common_1.ForbiddenException('DASHBOARD_ACTION_UNSUPPORTED');
+        return this.archives.exportFile(context, request.fileKey);
+    }
 };
 exports.DashboardViewProvider = DashboardViewProvider;
 exports.DashboardViewProvider = DashboardViewProvider = __decorate([
     (0, plugin_sdk_1.ViewExtensionProvider)(exports.VIEW_PROVIDER),
-    __metadata("design:paramtypes", [dashboard_service_1.DashboardService, sharing_service_1.DashboardSharingService, projects_service_1.DashboardProjectsService])
+    __param(4, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [dashboard_service_1.DashboardService, sharing_service_1.DashboardSharingService, projects_service_1.DashboardProjectsService, archive_service_1.DashboardArchiveService, save_requests_1.DashboardSaveRequests])
 ], DashboardViewProvider);
 function assertView(key) { if (key !== exports.VIEW_KEY)
     throw new common_1.BadRequestException('DASHBOARD_VIEW_UNSUPPORTED'); }