@contractspec/example.analytics-dashboard 1.44.0

package/dist/dashboard/dashboard.schema.js

@@ -0,0 +1,236 @@
+import { DashboardStatusEnum, RefreshIntervalEnum, WidgetTypeEnum } from "./dashboard.enum.js";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/dashboard/dashboard.schema.ts
+/**
+* A dashboard widget.
+*/
+const WidgetModel = defineSchemaModel({
+	name: "WidgetModel",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		dashboardId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		type: {
+			type: WidgetTypeEnum,
+			isOptional: false
+		},
+		gridX: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		gridY: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		gridWidth: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		gridHeight: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		queryId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		config: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		}
+	}
+});
+/**
+* An analytics dashboard.
+*/
+const DashboardModel = defineSchemaModel({
+	name: "DashboardModel",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		slug: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		description: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		status: {
+			type: DashboardStatusEnum,
+			isOptional: false
+		},
+		refreshInterval: {
+			type: RefreshIntervalEnum,
+			isOptional: false
+		},
+		isPublic: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		widgets: {
+			type: WidgetModel,
+			isArray: true,
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Input for creating a dashboard.
+*/
+const CreateDashboardInputModel = defineSchemaModel({
+	name: "CreateDashboardInput",
+	fields: {
+		name: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		slug: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		description: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		refreshInterval: {
+			type: RefreshIntervalEnum,
+			isOptional: true
+		},
+		dateRange: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		}
+	}
+});
+/**
+* Input for adding a widget.
+*/
+const AddWidgetInputModel = defineSchemaModel({
+	name: "AddWidgetInput",
+	fields: {
+		dashboardId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		type: {
+			type: WidgetTypeEnum,
+			isOptional: false
+		},
+		gridX: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		gridY: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		gridWidth: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		gridHeight: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		queryId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		config: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		}
+	}
+});
+/**
+* Input for listing dashboards.
+*/
+const ListDashboardsInputModel = defineSchemaModel({
+	name: "ListDashboardsInput",
+	fields: {
+		status: {
+			type: DashboardStatusEnum,
+			isOptional: true
+		},
+		search: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		limit: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true,
+			defaultValue: 20
+		},
+		offset: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true,
+			defaultValue: 0
+		}
+	}
+});
+/**
+* Output for listing dashboards.
+*/
+const ListDashboardsOutputModel = defineSchemaModel({
+	name: "ListDashboardsOutput",
+	fields: {
+		dashboards: {
+			type: DashboardModel,
+			isArray: true,
+			isOptional: false
+		},
+		total: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Input for getting a dashboard.
+*/
+const GetDashboardInputModel = defineSchemaModel({
+	name: "GetDashboardInput",
+	fields: {
+		dashboardId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		slug: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		shareToken: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+
+//#endregion
+export { AddWidgetInputModel, CreateDashboardInputModel, DashboardModel, GetDashboardInputModel, ListDashboardsInputModel, ListDashboardsOutputModel, WidgetModel };
+//# sourceMappingURL=dashboard.schema.js.map

package/dist/dashboard/dashboard.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.schema.js","names":[],"sources":["../../src/dashboard/dashboard.schema.ts"],"sourcesContent":["import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\nimport {\n  DashboardStatusEnum,\n  WidgetTypeEnum,\n  RefreshIntervalEnum,\n} from './dashboard.enum';\n\n/**\n * A dashboard widget.\n */\nexport const WidgetModel = defineSchemaModel({\n  name: 'WidgetModel',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    dashboardId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    type: { type: WidgetTypeEnum, isOptional: false },\n    gridX: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    gridY: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    gridWidth: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    gridHeight: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    queryId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    config: { type: ScalarTypeEnum.JSON(), isOptional: true },\n  },\n});\n\n/**\n * An analytics dashboard.\n */\nexport const DashboardModel = defineSchemaModel({\n  name: 'DashboardModel',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    status: { type: DashboardStatusEnum, isOptional: false },\n    refreshInterval: { type: RefreshIntervalEnum, isOptional: false },\n    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    widgets: { type: WidgetModel, isArray: true, isOptional: true },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Input for creating a dashboard.\n */\nexport const CreateDashboardInputModel = defineSchemaModel({\n  name: 'CreateDashboardInput',\n  fields: {\n    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    slug: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    refreshInterval: { type: RefreshIntervalEnum, isOptional: true },\n    dateRange: { type: ScalarTypeEnum.JSON(), isOptional: true },\n  },\n});\n\n/**\n * Input for adding a widget.\n */\nexport const AddWidgetInputModel = defineSchemaModel({\n  name: 'AddWidgetInput',\n  fields: {\n    dashboardId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    type: { type: WidgetTypeEnum, isOptional: false },\n    gridX: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    gridY: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    gridWidth: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    gridHeight: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    queryId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    config: { type: ScalarTypeEnum.JSON(), isOptional: true },\n  },\n});\n\n/**\n * Input for listing dashboards.\n */\nexport const ListDashboardsInputModel = defineSchemaModel({\n  name: 'ListDashboardsInput',\n  fields: {\n    status: { type: DashboardStatusEnum, isOptional: true },\n    search: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    limit: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n      defaultValue: 20,\n    },\n    offset: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n      defaultValue: 0,\n    },\n  },\n});\n\n/**\n * Output for listing dashboards.\n */\nexport const ListDashboardsOutputModel = defineSchemaModel({\n  name: 'ListDashboardsOutput',\n  fields: {\n    dashboards: { type: DashboardModel, isArray: true, isOptional: false },\n    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n  },\n});\n\n/**\n * Input for getting a dashboard.\n */\nexport const GetDashboardInputModel = defineSchemaModel({\n  name: 'GetDashboardInput',\n  fields: {\n    dashboardId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    shareToken: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n"],"mappings":"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"}

package/dist/dashboard/index.d.ts

@@ -0,0 +1,4 @@
+import { DashboardStatusEnum, RefreshIntervalEnum, WidgetTypeEnum } from "./dashboard.enum.js";
+import { AddWidgetContract, CreateDashboardContract, GetDashboardContract, ListDashboardsContract } from "./dashboard.operation.js";
+import { AddWidgetInputModel, CreateDashboardInputModel, DashboardModel, GetDashboardInputModel, ListDashboardsInputModel, ListDashboardsOutputModel, WidgetModel } from "./dashboard.schema.js";
+export { AddWidgetContract, AddWidgetInputModel, CreateDashboardContract, CreateDashboardInputModel, DashboardModel, DashboardStatusEnum, GetDashboardContract, GetDashboardInputModel, ListDashboardsContract, ListDashboardsInputModel, ListDashboardsOutputModel, RefreshIntervalEnum, WidgetModel, WidgetTypeEnum };

package/dist/dashboard/index.js

@@ -0,0 +1,5 @@
+import { DashboardStatusEnum, RefreshIntervalEnum, WidgetTypeEnum } from "./dashboard.enum.js";
+import { AddWidgetInputModel, CreateDashboardInputModel, DashboardModel, GetDashboardInputModel, ListDashboardsInputModel, ListDashboardsOutputModel, WidgetModel } from "./dashboard.schema.js";
+import { AddWidgetContract, CreateDashboardContract, GetDashboardContract, ListDashboardsContract } from "./dashboard.operation.js";
+
+export { AddWidgetContract, AddWidgetInputModel, CreateDashboardContract, CreateDashboardInputModel, DashboardModel, DashboardStatusEnum, GetDashboardContract, GetDashboardInputModel, ListDashboardsContract, ListDashboardsInputModel, ListDashboardsOutputModel, RefreshIntervalEnum, WidgetModel, WidgetTypeEnum };

package/dist/dashboard.feature.d.ts

@@ -0,0 +1,8 @@
+import { FeatureModuleSpec } from "@contractspec/lib.contracts";
+
+//#region src/dashboard.feature.d.ts
+
+declare const AnalyticsDashboardFeature: FeatureModuleSpec;
+//#endregion
+export { AnalyticsDashboardFeature };
+//# sourceMappingURL=dashboard.feature.d.ts.map

package/dist/dashboard.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.feature.d.ts","names":[],"sources":["../src/dashboard.feature.ts"],"sourcesContent":[],"mappings":";;;;cAca,2BAA2B"}

package/dist/dashboard.feature.js

@@ -0,0 +1,166 @@
+//#region src/dashboard.feature.ts
+const AnalyticsDashboardFeature = {
+	meta: {
+		key: "analytics-dashboard",
+		version: 1,
+		title: "Analytics Dashboard",
+		description: "Analytics dashboards with customizable widgets and queries",
+		domain: "analytics",
+		owners: ["@analytics-dashboard"],
+		tags: [
+			"analytics",
+			"dashboards",
+			"widgets",
+			"queries"
+		],
+		stability: "experimental"
+	},
+	operations: [
+		{
+			key: "analytics.dashboard.create",
+			version: 1
+		},
+		{
+			key: "analytics.dashboard.list",
+			version: 1
+		},
+		{
+			key: "analytics.dashboard.get",
+			version: 1
+		},
+		{
+			key: "analytics.widget.add",
+			version: 1
+		},
+		{
+			key: "analytics.query.create",
+			version: 1
+		},
+		{
+			key: "analytics.query.execute",
+			version: 1
+		}
+	],
+	events: [
+		{
+			key: "analytics.dashboard.created",
+			version: 1
+		},
+		{
+			key: "analytics.widget.added",
+			version: 1
+		},
+		{
+			key: "analytics.query.created",
+			version: 1
+		}
+	],
+	presentations: [
+		{
+			key: "analytics.dashboard.list",
+			version: 1
+		},
+		{
+			key: "analytics.dashboard.view",
+			version: 1
+		},
+		{
+			key: "analytics.dashboard.editor",
+			version: 1
+		},
+		{
+			key: "analytics.query.list",
+			version: 1
+		},
+		{
+			key: "analytics.query.builder",
+			version: 1
+		}
+	],
+	opToPresentation: [
+		{
+			op: {
+				key: "analytics.dashboard.list",
+				version: 1
+			},
+			pres: {
+				key: "analytics.dashboard.list",
+				version: 1
+			}
+		},
+		{
+			op: {
+				key: "analytics.dashboard.get",
+				version: 1
+			},
+			pres: {
+				key: "analytics.dashboard.view",
+				version: 1
+			}
+		},
+		{
+			op: {
+				key: "analytics.dashboard.create",
+				version: 1
+			},
+			pres: {
+				key: "analytics.dashboard.editor",
+				version: 1
+			}
+		},
+		{
+			op: {
+				key: "analytics.query.create",
+				version: 1
+			},
+			pres: {
+				key: "analytics.query.builder",
+				version: 1
+			}
+		}
+	],
+	presentationsTargets: [
+		{
+			key: "analytics.dashboard.list",
+			version: 1,
+			targets: [
+				"react",
+				"markdown",
+				"application/json"
+			]
+		},
+		{
+			key: "analytics.dashboard.view",
+			version: 1,
+			targets: ["react", "markdown"]
+		},
+		{
+			key: "analytics.dashboard.editor",
+			version: 1,
+			targets: ["react"]
+		},
+		{
+			key: "analytics.query.builder",
+			version: 1,
+			targets: ["react"]
+		}
+	],
+	capabilities: { requires: [
+		{
+			key: "identity",
+			version: 1
+		},
+		{
+			key: "metering",
+			version: 1
+		},
+		{
+			key: "audit-trail",
+			version: 1
+		}
+	] }
+};
+
+//#endregion
+export { AnalyticsDashboardFeature };
+//# sourceMappingURL=dashboard.feature.js.map

package/dist/dashboard.feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.feature.js","names":["AnalyticsDashboardFeature: FeatureModuleSpec"],"sources":["../src/dashboard.feature.ts"],"sourcesContent":["/**\n * Analytics Dashboard Feature Module\n *\n * Comprehensive analytics and dashboarding solution for data visualization\n * and reporting across the platform.\n *\n * This feature module bundles all dashboard and query operations, events,\n * and presentations into an installable feature following FeatureModuleSpec.\n */\n\nimport type { FeatureModuleSpec } from '@contractspec/lib.contracts';\n\n// ============ Feature Definition ============\n\nexport const AnalyticsDashboardFeature: FeatureModuleSpec = {\n  meta: {\n    key: 'analytics-dashboard',\n    version: 1,\n    title: 'Analytics Dashboard',\n    description: 'Analytics dashboards with customizable widgets and queries',\n    domain: 'analytics',\n    owners: ['@analytics-dashboard'],\n    tags: ['analytics', 'dashboards', 'widgets', 'queries'],\n    stability: 'experimental',\n  },\n\n  // ============ Contract Operations ============\n  // All contract operations included in this feature (OpRef[])\n  operations: [\n    // Dashboard operations\n    { key: 'analytics.dashboard.create', version: 1 },\n    { key: 'analytics.dashboard.list', version: 1 },\n    { key: 'analytics.dashboard.get', version: 1 },\n\n    // Widget operations\n    { key: 'analytics.widget.add', version: 1 },\n\n    // Query operations\n    { key: 'analytics.query.create', version: 1 },\n    { key: 'analytics.query.execute', version: 1 },\n  ],\n\n  // ============ Events ============\n  // Events emitted by this feature (EventRef[])\n  events: [\n    // Dashboard events\n    { key: 'analytics.dashboard.created', version: 1 },\n\n    // Widget events\n    { key: 'analytics.widget.added', version: 1 },\n\n    // Query events\n    { key: 'analytics.query.created', version: 1 },\n  ],\n\n  // ============ Presentations ============\n  // Presentations associated with this feature (PresentationRef[])\n  presentations: [\n    // Dashboard presentations\n    { key: 'analytics.dashboard.list', version: 1 },\n    { key: 'analytics.dashboard.view', version: 1 },\n    { key: 'analytics.dashboard.editor', version: 1 },\n\n    // Query presentations\n    { key: 'analytics.query.list', version: 1 },\n    { key: 'analytics.query.builder', version: 1 },\n  ],\n\n  // ============ Op-to-Presentation Links ============\n  // Links operations to their primary presentations\n  opToPresentation: [\n    {\n      op: { key: 'analytics.dashboard.list', version: 1 },\n      pres: { key: 'analytics.dashboard.list', version: 1 },\n    },\n    {\n      op: { key: 'analytics.dashboard.get', version: 1 },\n      pres: { key: 'analytics.dashboard.view', version: 1 },\n    },\n    {\n      op: { key: 'analytics.dashboard.create', version: 1 },\n      pres: { key: 'analytics.dashboard.editor', version: 1 },\n    },\n    {\n      op: { key: 'analytics.query.create', version: 1 },\n      pres: { key: 'analytics.query.builder', version: 1 },\n    },\n  ],\n\n  // ============ Presentation Targets ============\n  // Target requirements for multi-surface rendering\n  presentationsTargets: [\n    {\n      key: 'analytics.dashboard.list',\n      version: 1,\n      targets: ['react', 'markdown', 'application/json'],\n    },\n    {\n      key: 'analytics.dashboard.view',\n      version: 1,\n      targets: ['react', 'markdown'],\n    },\n    {\n      key: 'analytics.dashboard.editor',\n      version: 1,\n      targets: ['react'],\n    },\n    {\n      key: 'analytics.query.builder',\n      version: 1,\n      targets: ['react'],\n    },\n  ],\n\n  // ============ Capabilities ============\n  // Capability requirements for this feature\n  capabilities: {\n    requires: [\n      { key: 'identity', version: 1 },\n      { key: 'metering', version: 1 },\n      { key: 'audit-trail', version: 1 },\n    ],\n  },\n};\n"],"mappings":";AAcA,MAAaA,4BAA+C;CAC1D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,uBAAuB;EAChC,MAAM;GAAC;GAAa;GAAc;GAAW;GAAU;EACvD,WAAW;EACZ;CAID,YAAY;EAEV;GAAE,KAAK;GAA8B,SAAS;GAAG;EACjD;GAAE,KAAK;GAA4B,SAAS;GAAG;EAC/C;GAAE,KAAK;GAA2B,SAAS;GAAG;EAG9C;GAAE,KAAK;GAAwB,SAAS;GAAG;EAG3C;GAAE,KAAK;GAA0B,SAAS;GAAG;EAC7C;GAAE,KAAK;GAA2B,SAAS;GAAG;EAC/C;CAID,QAAQ;EAEN;GAAE,KAAK;GAA+B,SAAS;GAAG;EAGlD;GAAE,KAAK;GAA0B,SAAS;GAAG;EAG7C;GAAE,KAAK;GAA2B,SAAS;GAAG;EAC/C;CAID,eAAe;EAEb;GAAE,KAAK;GAA4B,SAAS;GAAG;EAC/C;GAAE,KAAK;GAA4B,SAAS;GAAG;EAC/C;GAAE,KAAK;GAA8B,SAAS;GAAG;EAGjD;GAAE,KAAK;GAAwB,SAAS;GAAG;EAC3C;GAAE,KAAK;GAA2B,SAAS;GAAG;EAC/C;CAID,kBAAkB;EAChB;GACE,IAAI;IAAE,KAAK;IAA4B,SAAS;IAAG;GACnD,MAAM;IAAE,KAAK;IAA4B,SAAS;IAAG;GACtD;EACD;GACE,IAAI;IAAE,KAAK;IAA2B,SAAS;IAAG;GAClD,MAAM;IAAE,KAAK;IAA4B,SAAS;IAAG;GACtD;EACD;GACE,IAAI;IAAE,KAAK;IAA8B,SAAS;IAAG;GACrD,MAAM;IAAE,KAAK;IAA8B,SAAS;IAAG;GACxD;EACD;GACE,IAAI;IAAE,KAAK;IAA0B,SAAS;IAAG;GACjD,MAAM;IAAE,KAAK;IAA2B,SAAS;IAAG;GACrD;EACF;CAID,sBAAsB;EACpB;GACE,KAAK;GACL,SAAS;GACT,SAAS;IAAC;IAAS;IAAY;IAAmB;GACnD;EACD;GACE,KAAK;GACL,SAAS;GACT,SAAS,CAAC,SAAS,WAAW;GAC/B;EACD;GACE,KAAK;GACL,SAAS;GACT,SAAS,CAAC,QAAQ;GACnB;EACD;GACE,KAAK;GACL,SAAS;GACT,SAAS,CAAC,QAAQ;GACnB;EACF;CAID,cAAc,EACZ,UAAU;EACR;GAAE,KAAK;GAAY,SAAS;GAAG;EAC/B;GAAE,KAAK;GAAY,SAAS;GAAG;EAC/B;GAAE,KAAK;GAAe,SAAS;GAAG;EACnC,EACF;CACF"}

package/dist/docs/analytics-dashboard.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/analytics-dashboard.docblock.js

@@ -0,0 +1,114 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/analytics-dashboard.docblock.ts
+registerDocBlocks([
+	{
+		id: "docs.examples.analytics-dashboard",
+		title: "Analytics Dashboard",
+		summary: "Multi-tenant analytics with dashboards, widgets, query builder, and scheduled reports built on the Event Bus.",
+		kind: "reference",
+		visibility: "public",
+		route: "/docs/examples/analytics-dashboard",
+		tags: [
+			"analytics",
+			"dashboards",
+			"bi",
+			"queries"
+		],
+		body: `## Entities
+
+- Dashboard, Widget, Query, Report.
+- Widget/query configs stay declarative for regeneration.
+
+## Contracts
+
+- \`analytics.dashboard.create\`, \`analytics.widget.add\`, \`analytics.query.execute\`, \`analytics.dashboard.get\`.
+- Metrics can source from Event Bus schemas and Usage/Metering module.
+
+## Events
+
+- dashboard.created/updated, widget.added, report.scheduled/sent.
+- Emitted for audit + notification hooks.
+
+## UI / Presentations
+
+- Dashboard list, dashboard view, query builder, widget gallery.
+- Registered under \`analytics-dashboard\` template in Template Registry.
+
+## Notes
+
+- Enforce org scoping for multi-tenant isolation.
+- Use Feature Flags for beta widgets; Metering to track query volume.
+`
+	},
+	{
+		id: "docs.examples.analytics-dashboard.goal",
+		title: "Analytics Dashboard — Goal",
+		summary: "Why this template matters and what success looks like.",
+		kind: "goal",
+		visibility: "public",
+		route: "/docs/examples/analytics-dashboard/goal",
+		tags: ["analytics", "goal"],
+		body: `## Why it matters
+- Give teams a regenerable analytics workspace that stays in sync with Event Bus, Usage/Metering, and presentations.
+- Avoid dashboard drift by keeping schema-first widgets/queries.
+
+## Business/Product goal
+- Deliver tenant-scoped dashboards, governed queries, and scheduled reports with clear ownership and auditability.
+- Enable feature-flagged rollout of new widgets and sampling for cost control.
+
+## Success criteria
+- Dashboards can be regenerated safely from spec changes.
+- Queries/widgets have enforced validation; PII is redacted per policy.`
+	},
+	{
+		id: "docs.examples.analytics-dashboard.usage",
+		title: "Analytics Dashboard — Usage",
+		summary: "How to seed, extend, and safely regenerate dashboards.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/examples/analytics-dashboard/usage",
+		tags: ["analytics", "usage"],
+		body: `## Setup
+1) Seed dashboards/widgets (via template registry) to preload sample queries.
+2) Configure org/tenant scope and attach Usage/Metering for cost/sampling controls.
+
+## Extend & regenerate
+1) Add or modify widget/query schemas in the spec (inputs, validation, PII paths).
+2) Regenerate to update UI + API + events; review presentations for redaction.
+3) Use Feature Flags to roll out new widgets or sampling knobs gradually.
+
+## Guardrails
+- Keep all query inputs validated; mark PII paths in policy.
+- Use Audit Trail for report deliveries; Notifications for scheduled sends.`
+	},
+	{
+		id: "docs.examples.analytics-dashboard.constraints",
+		title: "Analytics Dashboard — Constraints & Safety",
+		summary: "Internal guardrails for queries, widgets, and regeneration.",
+		kind: "reference",
+		visibility: "internal",
+		route: "/docs/examples/analytics-dashboard/constraints",
+		tags: [
+			"analytics",
+			"constraints",
+			"internal"
+		],
+		body: `## Constraints
+- Queries and widgets must declare inputs/validation in spec; no ad-hoc query strings.
+- Regeneration must preserve sampling/windowing semantics; document changes explicitly.
+- Events/usage metrics should remain consistent with Metering/Audit wiring.
+
+## PII & Data
+- Mark PII paths (user ids, emails) in presentations for redaction.
+- Avoid exposing raw query payloads in MCP/web without policy checks.
+
+## Verification
+- Add fixtures for widget/query schema changes and scheduled reports.
+- Run regeneration diff when adjusting query builders; ensure UI/markdown targets updated.
+- Confirm feature-flagged widgets default to safe/off for new tenants.`
+	}
+]);
+
+//#endregion
+//# sourceMappingURL=analytics-dashboard.docblock.js.map

package/dist/docs/analytics-dashboard.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-dashboard.docblock.js","names":[],"sources":["../../src/docs/analytics-dashboard.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst analyticsDashboardDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.examples.analytics-dashboard',\n    title: 'Analytics Dashboard',\n    summary:\n      'Multi-tenant analytics with dashboards, widgets, query builder, and scheduled reports built on the Event Bus.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/analytics-dashboard',\n    tags: ['analytics', 'dashboards', 'bi', 'queries'],\n    body: `## Entities\n\n- Dashboard, Widget, Query, Report.\n- Widget/query configs stay declarative for regeneration.\n\n## Contracts\n\n- \\`analytics.dashboard.create\\`, \\`analytics.widget.add\\`, \\`analytics.query.execute\\`, \\`analytics.dashboard.get\\`.\n- Metrics can source from Event Bus schemas and Usage/Metering module.\n\n## Events\n\n- dashboard.created/updated, widget.added, report.scheduled/sent.\n- Emitted for audit + notification hooks.\n\n## UI / Presentations\n\n- Dashboard list, dashboard view, query builder, widget gallery.\n- Registered under \\`analytics-dashboard\\` template in Template Registry.\n\n## Notes\n\n- Enforce org scoping for multi-tenant isolation.\n- Use Feature Flags for beta widgets; Metering to track query volume.\n`,\n  },\n  {\n    id: 'docs.examples.analytics-dashboard.goal',\n    title: 'Analytics Dashboard — Goal',\n    summary: 'Why this template matters and what success looks like.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/analytics-dashboard/goal',\n    tags: ['analytics', 'goal'],\n    body: `## Why it matters\n- Give teams a regenerable analytics workspace that stays in sync with Event Bus, Usage/Metering, and presentations.\n- Avoid dashboard drift by keeping schema-first widgets/queries.\n\n## Business/Product goal\n- Deliver tenant-scoped dashboards, governed queries, and scheduled reports with clear ownership and auditability.\n- Enable feature-flagged rollout of new widgets and sampling for cost control.\n\n## Success criteria\n- Dashboards can be regenerated safely from spec changes.\n- Queries/widgets have enforced validation; PII is redacted per policy.`,\n  },\n  {\n    id: 'docs.examples.analytics-dashboard.usage',\n    title: 'Analytics Dashboard — Usage',\n    summary: 'How to seed, extend, and safely regenerate dashboards.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/analytics-dashboard/usage',\n    tags: ['analytics', 'usage'],\n    body: `## Setup\n1) Seed dashboards/widgets (via template registry) to preload sample queries.\n2) Configure org/tenant scope and attach Usage/Metering for cost/sampling controls.\n\n## Extend & regenerate\n1) Add or modify widget/query schemas in the spec (inputs, validation, PII paths).\n2) Regenerate to update UI + API + events; review presentations for redaction.\n3) Use Feature Flags to roll out new widgets or sampling knobs gradually.\n\n## Guardrails\n- Keep all query inputs validated; mark PII paths in policy.\n- Use Audit Trail for report deliveries; Notifications for scheduled sends.`,\n  },\n  {\n    id: 'docs.examples.analytics-dashboard.constraints',\n    title: 'Analytics Dashboard — Constraints & Safety',\n    summary: 'Internal guardrails for queries, widgets, and regeneration.',\n    kind: 'reference',\n    visibility: 'internal',\n    route: '/docs/examples/analytics-dashboard/constraints',\n    tags: ['analytics', 'constraints', 'internal'],\n    body: `## Constraints\n- Queries and widgets must declare inputs/validation in spec; no ad-hoc query strings.\n- Regeneration must preserve sampling/windowing semantics; document changes explicitly.\n- Events/usage metrics should remain consistent with Metering/Audit wiring.\n\n## PII & Data\n- Mark PII paths (user ids, emails) in presentations for redaction.\n- Avoid exposing raw query payloads in MCP/web without policy checks.\n\n## Verification\n- Add fixtures for widget/query schema changes and scheduled reports.\n- Run regeneration diff when adjusting query builders; ensure UI/markdown targets updated.\n- Confirm feature-flagged widgets default to safe/off for new tenants.`,\n  },\n];\n\nregisterDocBlocks(analyticsDashboardDocBlocks);\n"],"mappings":";;;AAwGA,kBArGgD;CAC9C;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAa;GAAc;GAAM;GAAU;EAClD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;EAyBP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,aAAa,OAAO;EAC3B,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,aAAa,QAAQ;EAC5B,MAAM;;;;;;;;;;;;EAYP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAa;GAAe;GAAW;EAC9C,MAAM;;;;;;;;;;;;;EAaP;CACF,CAE6C"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./analytics-dashboard.docblock.js";