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

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

@@ -0,0 +1,69 @@
+import { z } from 'zod/v3';
+import type { DashboardManifest } from './dashboard.schema';
+export declare const componentId: z.ZodString;
+export declare const sourceMetadataSchema: z.ZodArray<z.ZodObject<{
+    bindingId: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    bindingId: string;
+    title: string;
+    description?: string | undefined;
+}, {
+    bindingId: string;
+    title: string;
+    description?: string | undefined;
+}>, "many">;
+export declare const dashboardComponentsSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    elementId: z.ZodString;
+    title: z.ZodString;
+    kind: z.ZodEnum<["metric", "chart", "table", "filter", "text"]>;
+    sources: z.ZodArray<z.ZodObject<{
+        bindingId: z.ZodString;
+        fieldIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        bindingId: string;
+        fieldIds?: string[] | undefined;
+    }, {
+        bindingId: string;
+        fieldIds?: string[] | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    id: string;
+    elementId: string;
+    kind: "filter" | "metric" | "chart" | "table" | "text";
+    sources: {
+        bindingId: string;
+        fieldIds?: string[] | undefined;
+    }[];
+}, {
+    title: string;
+    id: string;
+    elementId: string;
+    kind: "filter" | "metric" | "chart" | "table" | "text";
+    sources: {
+        bindingId: string;
+        fieldIds?: string[] | undefined;
+    }[];
+}>, "many">;
+export type DashboardComponent = z.infer<typeof dashboardComponentsSchema>[number];
+export declare function dashboardComponents(manifest: DashboardManifest): DashboardComponent[];
+export declare function dashboardSources(manifest: DashboardManifest): {
+    binding: import("@xpert-ai/contracts").AnalyticsBinding;
+    title: string;
+    description: string | undefined;
+    components: {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }[];
+}[];
+/** A rendering projection never exposes provider-native query configuration to a viewer. */
+export declare function publicDashboardManifest(manifest: DashboardManifest): DashboardManifest;

package/dist/lib/dashboard-sources.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dashboardComponentsSchema = exports.sourceMetadataSchema = exports.componentId = void 0;
+exports.dashboardComponents = dashboardComponents;
+exports.dashboardSources = dashboardSources;
+exports.publicDashboardManifest = publicDashboardManifest;
+const capacity_1 = require("./capacity");
+const v3_1 = require("zod/v3");
+exports.componentId = v3_1.z.string().regex(/^[A-Za-z][A-Za-z0-9_.-]{0,79}$/);
+exports.sourceMetadataSchema = v3_1.z.array(v3_1.z.object({
+    bindingId: exports.componentId, title: v3_1.z.string().min(1).max(160), description: v3_1.z.string().max(2000).optional()
+}).strict()).max(capacity_1.MAX_DASHBOARD_BINDINGS);
+exports.dashboardComponentsSchema = v3_1.z.array(v3_1.z.object({
+    id: exports.componentId, elementId: exports.componentId, title: v3_1.z.string().min(1).max(160),
+    kind: v3_1.z.enum(['metric', 'chart', 'table', 'filter', 'text']),
+    sources: v3_1.z.array(v3_1.z.object({ bindingId: exports.componentId, fieldIds: v3_1.z.array(exports.componentId).max(80).optional() }).strict()).max(capacity_1.MAX_DASHBOARD_BINDINGS)
+}).strict()).max(160);
+function dashboardComponents(manifest) {
+    if (manifest.presentation)
+        return manifest.components ?? [];
+    return [...manifest.charts, ...manifest.tables].map(view => ({
+        id: view.id, elementId: view.id, title: view.title, kind: 'fields' in view ? 'table' : 'chart',
+        sources: manifest.bindings.filter(binding => binding.output.datasetId === view.datasetId)
+            .map(binding => ({ bindingId: binding.id, fieldIds: 'fields' in view ? view.fields : [view.x, view.y, ...(view.color ? [view.color] : [])] }))
+    }));
+}
+function dashboardSources(manifest) {
+    const components = dashboardComponents(manifest);
+    return manifest.bindings.map(binding => ({
+        binding, title: manifest.sourceMetadata?.find(item => item.bindingId === binding.id)?.title ?? binding.id,
+        description: manifest.sourceMetadata?.find(item => item.bindingId === binding.id)?.description,
+        components: components.filter(component => component.sources.some(source => source.bindingId === binding.id))
+    }));
+}
+/** A rendering projection never exposes provider-native query configuration to a viewer. */
+function publicDashboardManifest(manifest) {
+    return { ...manifest, bindings: manifest.bindings.map(binding => ({ ...binding, payload: {} })) };
+}