@xpert-ai/plugin-live-dashboard 0.0.0-stage → 0.1.0

package/dist/lib/dashboard-navigation.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dashboardNavigationKey = exports.dashboardNavigationSchema = exports.DASHBOARD_VIEW_KEY = void 0;
+const v3_1 = require("zod/v3");
+// The host namespaces provider + local view key; cards use the resolved public key.
+exports.DASHBOARD_VIEW_KEY = 'live-dashboard__live-dashboard';
+exports.dashboardNavigationSchema = v3_1.z.object({
+    selectionId: v3_1.z.string().uuid().optional(),
+    parameters: v3_1.z.object({ artifactId: v3_1.z.string().uuid().optional(), versionId: v3_1.z.string().uuid().optional() }).strict().optional()
+}).transform((query, ctx) => {
+    const artifactId = query.selectionId ?? query.parameters?.artifactId;
+    const versionId = query.parameters?.versionId;
+    if (query.selectionId && query.parameters?.artifactId && query.selectionId !== query.parameters.artifactId || versionId && !artifactId)
+        ctx.addIssue({ code: v3_1.z.ZodIssueCode.custom, message: 'DASHBOARD_NAVIGATION_INVALID: provide one Artifact identity and an optional version' });
+    return { artifactId, versionId };
+});
+const dashboardNavigationKey = (target) => JSON.stringify([target.artifactId ?? null, target.versionId ?? null]);
+exports.dashboardNavigationKey = dashboardNavigationKey;

package/dist/lib/dashboard-queries.d.ts

@@ -0,0 +1,8 @@
+import type { AnalyticalDataset, AnalyticsValue } from '@xpert-ai/contracts';
+import { type DataSourceActor, type RuntimeCapabilityRegistry } from '@xpert-ai/plugin-sdk';
+import type { DashboardManifest } from './dashboard.schema';
+export declare function validateControls(manifest: DashboardManifest, input: Record<string, AnalyticsValue>): {
+    [x: string]: AnalyticsValue;
+};
+export declare function queryDashboardBinding(runtime: RuntimeCapabilityRegistry, actor: DataSourceActor, manifest: DashboardManifest, bindingId: string, input: Record<string, AnalyticsValue>): Promise<AnalyticalDataset>;
+export declare function queryDashboard(runtime: RuntimeCapabilityRegistry, actor: DataSourceActor, manifest: DashboardManifest, input: Record<string, AnalyticsValue>): Promise<AnalyticalDataset[]>;

package/dist/lib/dashboard-queries.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateControls = validateControls;
+exports.queryDashboardBinding = queryDashboardBinding;
+exports.queryDashboard = queryDashboard;
+const common_1 = require("@nestjs/common");
+const plugin_sdk_1 = require("@xpert-ai/plugin-sdk");
+function validateControls(manifest, input) {
+    if (Object.keys(input).some(id => !manifest.controls.some(control => control.controlId === id)))
+        throw new common_1.BadRequestException('DASHBOARD_UNKNOWN_CONTROL');
+    const values = { ...Object.fromEntries(manifest.controls.filter(control => control.defaultValue !== undefined).map(control => [control.controlId, control.defaultValue ?? null])), ...input };
+    for (const control of manifest.controls) {
+        const value = values[control.controlId];
+        if (value === undefined)
+            continue;
+        if (control.allowedValues && !control.allowedValues.includes(value))
+            throw new common_1.BadRequestException('DASHBOARD_CONTROL_VALUE_DENIED');
+        if (value !== null && (control.type === 'number' ? typeof value !== 'number' || !Number.isFinite(value) : control.type === 'boolean' ? typeof value !== 'boolean' : typeof value !== 'string'))
+            throw new common_1.BadRequestException('DASHBOARD_CONTROL_TYPE_INVALID');
+    }
+    return values;
+}
+async function queryDashboardBinding(runtime, actor, manifest, bindingId, input) {
+    const binding = manifest.bindings.find(item => item.id === bindingId);
+    if (!binding)
+        throw new common_1.ForbiddenException('DASHBOARD_BINDING_DENIED');
+    const controls = validateControls(manifest, input);
+    const selected = Object.fromEntries(Object.entries(controls).filter(([id]) => binding.parameters.some(parameter => parameter.controlId === id)));
+    return runtime.require(plugin_sdk_1.AnalyticsRuntimeCapability).query(actor, { binding, controls: selected });
+}
+async function queryDashboard(runtime, actor, manifest, input) {
+    validateControls(manifest, input);
+    const datasets = [];
+    for (const binding of manifest.bindings)
+        datasets.push(await queryDashboardBinding(runtime, actor, manifest, binding.id, input));
+    if (Buffer.byteLength(JSON.stringify(datasets)) > 3_000_000)
+        throw new common_1.BadRequestException('DASHBOARD_RESULT_TOO_LARGE');
+    return datasets;
+}

package/dist/lib/dashboard-receipt.d.ts

@@ -0,0 +1,11 @@
+export declare const DASHBOARD_MUTATION_TOOLS: string[];
+/** Tool start/failed logs can share the host event channel; only a saved receipt opens a View. */
+export declare function createdDashboard(output: unknown): {
+    status: "draft";
+    artifactId: string;
+    draftRevision: number;
+} | null;
+export declare function savedDashboardSource(output: unknown): {
+    path: string;
+    sha256: string;
+} | null;

package/dist/lib/dashboard-receipt.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DASHBOARD_MUTATION_TOOLS = void 0;
+exports.createdDashboard = createdDashboard;
+exports.savedDashboardSource = savedDashboardSource;
+const v3_1 = require("zod/v3");
+exports.DASHBOARD_MUTATION_TOOLS = ['dashboard_create', 'dashboard_create_html', 'dashboard_update'];
+const receiptSchema = v3_1.z.object({ dashboard: v3_1.z.object({ artifactId: v3_1.z.string().uuid(), draftRevision: v3_1.z.number().int().positive(), status: v3_1.z.literal('draft') }) });
+/** Tool start/failed logs can share the host event channel; only a saved receipt opens a View. */
+function createdDashboard(output) {
+    let value = output;
+    if (typeof value === 'string') {
+        try {
+            value = JSON.parse(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    const parsed = receiptSchema.safeParse(value);
+    return parsed.success ? parsed.data.dashboard : null;
+}
+function savedDashboardSource(output) {
+    let value = output;
+    if (typeof value === 'string') {
+        try {
+            value = JSON.parse(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    const parsed = v3_1.z.object({ sourceFile: v3_1.z.object({ path: v3_1.z.string(), sha256: v3_1.z.string().regex(/^[a-f0-9]{64}$/) }) }).safeParse(value);
+    return parsed.success ? parsed.data.sourceFile : null;
+}