@contractspec/example.analytics-dashboard 1.44.0

package/dist/query/query.operation.js

@@ -0,0 +1,113 @@
+import { CreateQueryInputModel, ExecuteQueryInputModel, QueryModel, QueryResultModel } from "./query.schema.js";
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts/operations";
+
+//#region src/query/query.operation.ts
+const OWNERS = ["@example.analytics-dashboard"];
+/**
+* Create a data query.
+*/
+const CreateQueryContract = defineCommand({
+	meta: {
+		key: "analytics.query.create",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"analytics",
+			"query",
+			"create"
+		],
+		description: "Create a data query.",
+		goal: "Define reusable data queries.",
+		context: "Query builder."
+	},
+	io: {
+		input: CreateQueryInputModel,
+		output: QueryModel
+	},
+	policy: { auth: "user" },
+	sideEffects: {
+		emits: [{
+			key: "analytics.query.created",
+			version: 1,
+			stability: "stable",
+			owners: [...OWNERS],
+			tags: [
+				"analytics",
+				"query",
+				"created"
+			],
+			when: "Query created",
+			payload: QueryModel
+		}],
+		audit: ["analytics.query.created"]
+	},
+	acceptance: {
+		scenarios: [{
+			key: "create-query-happy-path",
+			given: ["User is authenticated"],
+			when: ["User submits valid query definition"],
+			then: ["Query is created", "QueryCreated event is emitted"]
+		}],
+		examples: [{
+			key: "create-sql-query",
+			input: {
+				name: "Monthly Revenue",
+				sql: "SELECT SUM(amount) FROM orders WHERE date >= :startDate"
+			},
+			output: {
+				id: "query-123",
+				name: "Monthly Revenue",
+				type: "sql"
+			}
+		}]
+	}
+});
+/**
+* Execute a data query.
+*/
+const ExecuteQueryContract = defineQuery({
+	meta: {
+		key: "analytics.query.execute",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"analytics",
+			"query",
+			"execute"
+		],
+		description: "Execute a data query.",
+		goal: "Fetch data for visualizations.",
+		context: "Dashboard rendering."
+	},
+	io: {
+		input: ExecuteQueryInputModel,
+		output: QueryResultModel
+	},
+	policy: { auth: "user" },
+	acceptance: {
+		scenarios: [{
+			key: "execute-query-happy-path",
+			given: ["Query exists"],
+			when: ["User executes query with parameters"],
+			then: ["Query results are returned"]
+		}],
+		examples: [{
+			key: "execute-with-params",
+			input: {
+				queryId: "query-123",
+				params: { startDate: "2025-01-01" }
+			},
+			output: {
+				columns: ["total"],
+				rows: [{ total: 5e4 }],
+				rowCount: 1
+			}
+		}]
+	}
+});
+
+//#endregion
+export { CreateQueryContract, ExecuteQueryContract };
+//# sourceMappingURL=query.operation.js.map

package/dist/query/query.operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.operation.js","names":[],"sources":["../../src/query/query.operation.ts"],"sourcesContent":["import {\n  defineCommand,\n  defineQuery,\n} from '@contractspec/lib.contracts/operations';\nimport {\n  QueryModel,\n  QueryResultModel,\n  CreateQueryInputModel,\n  ExecuteQueryInputModel,\n} from './query.schema';\n\nconst OWNERS = ['@example.analytics-dashboard'] as const;\n\n/**\n * Create a data query.\n */\nexport const CreateQueryContract = defineCommand({\n  meta: {\n    key: 'analytics.query.create',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['analytics', 'query', 'create'],\n    description: 'Create a data query.',\n    goal: 'Define reusable data queries.',\n    context: 'Query builder.',\n  },\n  io: { input: CreateQueryInputModel, output: QueryModel },\n  policy: { auth: 'user' },\n  sideEffects: {\n    emits: [\n      {\n        key: 'analytics.query.created',\n        version: 1,\n        stability: 'stable',\n        owners: [...OWNERS],\n        tags: ['analytics', 'query', 'created'],\n        when: 'Query created',\n        payload: QueryModel,\n      },\n    ],\n    audit: ['analytics.query.created'],\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'create-query-happy-path',\n        given: ['User is authenticated'],\n        when: ['User submits valid query definition'],\n        then: ['Query is created', 'QueryCreated event is emitted'],\n      },\n    ],\n    examples: [\n      {\n        key: 'create-sql-query',\n        input: {\n          name: 'Monthly Revenue',\n          sql: 'SELECT SUM(amount) FROM orders WHERE date >= :startDate',\n        },\n        output: { id: 'query-123', name: 'Monthly Revenue', type: 'sql' },\n      },\n    ],\n  },\n});\n\n/**\n * Execute a data query.\n */\nexport const ExecuteQueryContract = defineQuery({\n  meta: {\n    key: 'analytics.query.execute',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['analytics', 'query', 'execute'],\n    description: 'Execute a data query.',\n    goal: 'Fetch data for visualizations.',\n    context: 'Dashboard rendering.',\n  },\n  io: { input: ExecuteQueryInputModel, output: QueryResultModel },\n  policy: { auth: 'user' },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'execute-query-happy-path',\n        given: ['Query exists'],\n        when: ['User executes query with parameters'],\n        then: ['Query results are returned'],\n      },\n    ],\n    examples: [\n      {\n        key: 'execute-with-params',\n        input: { queryId: 'query-123', params: { startDate: '2025-01-01' } },\n        output: { columns: ['total'], rows: [{ total: 50000 }], rowCount: 1 },\n      },\n    ],\n  },\n});\n"],"mappings":";;;;AAWA,MAAM,SAAS,CAAC,+BAA+B;;;;AAK/C,MAAa,sBAAsB,cAAc;CAC/C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAa;GAAS;GAAS;EACtC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EAAE,OAAO;EAAuB,QAAQ;EAAY;CACxD,QAAQ,EAAE,MAAM,QAAQ;CACxB,aAAa;EACX,OAAO,CACL;GACE,KAAK;GACL,SAAS;GACT,WAAW;GACX,QAAQ,CAAC,GAAG,OAAO;GACnB,MAAM;IAAC;IAAa;IAAS;IAAU;GACvC,MAAM;GACN,SAAS;GACV,CACF;EACD,OAAO,CAAC,0BAA0B;EACnC;CACD,YAAY;EACV,WAAW,CACT;GACE,KAAK;GACL,OAAO,CAAC,wBAAwB;GAChC,MAAM,CAAC,sCAAsC;GAC7C,MAAM,CAAC,oBAAoB,gCAAgC;GAC5D,CACF;EACD,UAAU,CACR;GACE,KAAK;GACL,OAAO;IACL,MAAM;IACN,KAAK;IACN;GACD,QAAQ;IAAE,IAAI;IAAa,MAAM;IAAmB,MAAM;IAAO;GAClE,CACF;EACF;CACF,CAAC;;;;AAKF,MAAa,uBAAuB,YAAY;CAC9C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAa;GAAS;GAAU;EACvC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EAAE,OAAO;EAAwB,QAAQ;EAAkB;CAC/D,QAAQ,EAAE,MAAM,QAAQ;CACxB,YAAY;EACV,WAAW,CACT;GACE,KAAK;GACL,OAAO,CAAC,eAAe;GACvB,MAAM,CAAC,sCAAsC;GAC7C,MAAM,CAAC,6BAA6B;GACrC,CACF;EACD,UAAU,CACR;GACE,KAAK;GACL,OAAO;IAAE,SAAS;IAAa,QAAQ,EAAE,WAAW,cAAc;IAAE;GACpE,QAAQ;IAAE,SAAS,CAAC,QAAQ;IAAE,MAAM,CAAC,EAAE,OAAO,KAAO,CAAC;IAAE,UAAU;IAAG;GACtE,CACF;EACF;CACF,CAAC"}

package/dist/query/query.presentation.d.ts

@@ -0,0 +1,8 @@
+import { PresentationSpec } from "@contractspec/lib.contracts";
+
+//#region src/query/query.presentation.d.ts
+declare const QueriesListPresentation: PresentationSpec;
+declare const QueryBuilderPresentation: PresentationSpec;
+//#endregion
+export { QueriesListPresentation, QueryBuilderPresentation };
+//# sourceMappingURL=query.presentation.d.ts.map

package/dist/query/query.presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.presentation.d.ts","names":[],"sources":["../../src/query/query.presentation.ts"],"sourcesContent":[],"mappings":";;;cAIa,yBAAyB;cAyBzB,0BAA0B"}

package/dist/query/query.presentation.js

@@ -0,0 +1,60 @@
+import { QueryModel } from "./query.schema.js";
+import { StabilityEnum } from "@contractspec/lib.contracts";
+
+//#region src/query/query.presentation.ts
+const QueriesListPresentation = {
+	meta: {
+		key: "analytics.query.list",
+		version: 1,
+		title: "Queries List",
+		description: "List of saved queries",
+		domain: "analytics",
+		owners: ["@analytics-dashboard"],
+		tags: [
+			"analytics",
+			"queries",
+			"list"
+		],
+		stability: StabilityEnum.Experimental,
+		goal: "Browse and manage saved data queries.",
+		context: "The library of reusable data definitions."
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "QueriesList",
+		props: QueryModel
+	},
+	targets: ["react", "markdown"],
+	policy: { flags: ["analytics.queries.enabled"] }
+};
+const QueryBuilderPresentation = {
+	meta: {
+		key: "analytics.query.builder",
+		version: 1,
+		title: "Query Builder",
+		description: "Visual query builder interface",
+		domain: "analytics",
+		owners: ["@analytics-dashboard"],
+		tags: [
+			"analytics",
+			"query",
+			"builder"
+		],
+		stability: StabilityEnum.Experimental,
+		goal: "Visually construct data queries and transformations.",
+		context: "Developer tool for data analysis."
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "QueryBuilder",
+		props: QueryModel
+	},
+	targets: ["react"],
+	policy: { flags: ["analytics.queries.enabled"] }
+};
+
+//#endregion
+export { QueriesListPresentation, QueryBuilderPresentation };
+//# sourceMappingURL=query.presentation.js.map

package/dist/query/query.presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.presentation.js","names":["QueriesListPresentation: PresentationSpec","QueryBuilderPresentation: PresentationSpec"],"sources":["../../src/query/query.presentation.ts"],"sourcesContent":["import type { PresentationSpec } from '@contractspec/lib.contracts';\nimport { StabilityEnum } from '@contractspec/lib.contracts';\nimport { QueryModel } from './query.schema';\n\nexport const QueriesListPresentation: PresentationSpec = {\n  meta: {\n    key: 'analytics.query.list',\n    version: 1,\n    title: 'Queries List',\n    description: 'List of saved queries',\n    domain: 'analytics',\n    owners: ['@analytics-dashboard'],\n    tags: ['analytics', 'queries', 'list'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Browse and manage saved data queries.',\n    context: 'The library of reusable data definitions.',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'QueriesList',\n    props: QueryModel,\n  },\n  targets: ['react', 'markdown'],\n  policy: {\n    flags: ['analytics.queries.enabled'],\n  },\n};\n\nexport const QueryBuilderPresentation: PresentationSpec = {\n  meta: {\n    key: 'analytics.query.builder',\n    version: 1,\n    title: 'Query Builder',\n    description: 'Visual query builder interface',\n    domain: 'analytics',\n    owners: ['@analytics-dashboard'],\n    tags: ['analytics', 'query', 'builder'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Visually construct data queries and transformations.',\n    context: 'Developer tool for data analysis.',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'QueryBuilder',\n    props: QueryModel,\n  },\n  targets: ['react'],\n  policy: {\n    flags: ['analytics.queries.enabled'],\n  },\n};\n"],"mappings":";;;;AAIA,MAAaA,0BAA4C;CACvD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,uBAAuB;EAChC,MAAM;GAAC;GAAa;GAAW;GAAO;EACtC,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS,CAAC,SAAS,WAAW;CAC9B,QAAQ,EACN,OAAO,CAAC,4BAA4B,EACrC;CACF;AAED,MAAaC,2BAA6C;CACxD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,uBAAuB;EAChC,MAAM;GAAC;GAAa;GAAS;GAAU;EACvC,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS,CAAC,QAAQ;CAClB,QAAQ,EACN,OAAO,CAAC,4BAA4B,EACrC;CACF"}

package/dist/query/query.schema.d.ts

@@ -0,0 +1,143 @@
+import * as _contractspec_lib_schema250 from "@contractspec/lib.schema";
+
+//#region src/query/query.schema.d.ts
+/**
+ * A data query.
+ */
+declare const QueryModel: _contractspec_lib_schema250.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema250.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _contractspec_lib_schema250.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _contractspec_lib_schema250.FieldType<string, string>;
+    isOptional: true;
+  };
+  type: {
+    type: _contractspec_lib_schema250.EnumType<[string, string, string, string]>;
+    isOptional: false;
+  };
+  definition: {
+    type: _contractspec_lib_schema250.FieldType<unknown, unknown>;
+    isOptional: false;
+  };
+  sql: {
+    type: _contractspec_lib_schema250.FieldType<string, string>;
+    isOptional: true;
+  };
+  cacheTtlSeconds: {
+    type: _contractspec_lib_schema250.FieldType<number, number>;
+    isOptional: false;
+  };
+  isShared: {
+    type: _contractspec_lib_schema250.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  createdAt: {
+    type: _contractspec_lib_schema250.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>;
+/**
+ * Query execution result.
+ */
+declare const QueryResultModel: _contractspec_lib_schema250.SchemaModel<{
+  queryId: {
+    type: _contractspec_lib_schema250.FieldType<string, string>;
+    isOptional: false;
+  };
+  data: {
+    type: _contractspec_lib_schema250.FieldType<unknown, unknown>;
+    isOptional: false;
+  };
+  columns: {
+    type: _contractspec_lib_schema250.FieldType<unknown, unknown>;
+    isOptional: false;
+  };
+  rowCount: {
+    type: _contractspec_lib_schema250.FieldType<number, number>;
+    isOptional: false;
+  };
+  executionTimeMs: {
+    type: _contractspec_lib_schema250.FieldType<number, number>;
+    isOptional: false;
+  };
+  cachedAt: {
+    type: _contractspec_lib_schema250.FieldType<Date, string>;
+    isOptional: true;
+  };
+  error: {
+    type: _contractspec_lib_schema250.FieldType<string, string>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for creating a query.
+ */
+declare const CreateQueryInputModel: _contractspec_lib_schema250.SchemaModel<{
+  name: {
+    type: _contractspec_lib_schema250.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _contractspec_lib_schema250.FieldType<string, string>;
+    isOptional: true;
+  };
+  type: {
+    type: _contractspec_lib_schema250.EnumType<[string, string, string, string]>;
+    isOptional: false;
+  };
+  definition: {
+    type: _contractspec_lib_schema250.FieldType<unknown, unknown>;
+    isOptional: false;
+  };
+  sql: {
+    type: _contractspec_lib_schema250.FieldType<string, string>;
+    isOptional: true;
+  };
+  metricIds: {
+    type: _contractspec_lib_schema250.FieldType<string, string>;
+    isArray: true;
+    isOptional: true;
+  };
+  cacheTtlSeconds: {
+    type: _contractspec_lib_schema250.FieldType<number, number>;
+    isOptional: true;
+  };
+  isShared: {
+    type: _contractspec_lib_schema250.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for executing a query.
+ */
+declare const ExecuteQueryInputModel: _contractspec_lib_schema250.SchemaModel<{
+  queryId: {
+    type: _contractspec_lib_schema250.FieldType<string, string>;
+    isOptional: false;
+  };
+  parameters: {
+    type: _contractspec_lib_schema250.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  dateRange: {
+    type: _contractspec_lib_schema250.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  filters: {
+    type: _contractspec_lib_schema250.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  forceRefresh: {
+    type: _contractspec_lib_schema250.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+}>;
+//#endregion
+export { CreateQueryInputModel, ExecuteQueryInputModel, QueryModel, QueryResultModel };
+//# sourceMappingURL=query.schema.d.ts.map

package/dist/query/query.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.schema.d.ts","names":[],"sources":["../../src/query/query.schema.ts"],"sourcesContent":[],"mappings":";;;;;;AAMa,cAAA,UAaX,8BAbqB,WAarB,CAAA;EAAA,EAAA,EAAA;UAAA,2BAAA,CAAA;;;;;;;;;;EAbqB,CAAA;EAkBV,IAAA,EAAA;IAWX,IAAA,sCAAA,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;;;;;;;;+CAX2B,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,IAAA;EAgBhB,CAAA;EAgBX,eAAA,EAAA;;;;;;;;;IAhBgC,IAAA,uCAAA,KAAA,EAAA,MAAA,CAAA;IAqBrB,UAAA,EAAA,KAAA;EASX,CAAA;;;;;cA9CW,gBAqCsB,8BArCN,WAqCM,CAAA;EAAA,OAAA,EAAA;UA1BjC,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKW,mDAAqB;;UAgBhC,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKW,oDAAsB;;UASjC,2BAAA,CAAA"}

package/dist/query/query.schema.js

@@ -0,0 +1,157 @@
+import { QueryTypeEnum } from "./query.enum.js";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/query/query.schema.ts
+/**
+* A data query.
+*/
+const QueryModel = defineSchemaModel({
+	name: "QueryModel",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		description: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		type: {
+			type: QueryTypeEnum,
+			isOptional: false
+		},
+		definition: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: false
+		},
+		sql: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		cacheTtlSeconds: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		isShared: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Query execution result.
+*/
+const QueryResultModel = defineSchemaModel({
+	name: "QueryResultModel",
+	fields: {
+		queryId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		data: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: false
+		},
+		columns: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: false
+		},
+		rowCount: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		executionTimeMs: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		cachedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		error: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+/**
+* Input for creating a query.
+*/
+const CreateQueryInputModel = defineSchemaModel({
+	name: "CreateQueryInput",
+	fields: {
+		name: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		description: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		type: {
+			type: QueryTypeEnum,
+			isOptional: false
+		},
+		definition: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: false
+		},
+		sql: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		metricIds: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isArray: true,
+			isOptional: true
+		},
+		cacheTtlSeconds: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		isShared: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+/**
+* Input for executing a query.
+*/
+const ExecuteQueryInputModel = defineSchemaModel({
+	name: "ExecuteQueryInput",
+	fields: {
+		queryId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		parameters: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		},
+		dateRange: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		},
+		filters: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		},
+		forceRefresh: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+
+//#endregion
+export { CreateQueryInputModel, ExecuteQueryInputModel, QueryModel, QueryResultModel };
+//# sourceMappingURL=query.schema.js.map

package/dist/query/query.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.schema.js","names":[],"sources":["../../src/query/query.schema.ts"],"sourcesContent":["import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\nimport { QueryTypeEnum } from './query.enum';\n\n/**\n * A data query.\n */\nexport const QueryModel = defineSchemaModel({\n  name: 'QueryModel',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    type: { type: QueryTypeEnum, isOptional: false },\n    definition: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    sql: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    cacheTtlSeconds: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    isShared: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Query execution result.\n */\nexport const QueryResultModel = defineSchemaModel({\n  name: 'QueryResultModel',\n  fields: {\n    queryId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    data: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    columns: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    rowCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    executionTimeMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    cachedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    error: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\n/**\n * Input for creating a query.\n */\nexport const CreateQueryInputModel = defineSchemaModel({\n  name: 'CreateQueryInput',\n  fields: {\n    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    type: { type: QueryTypeEnum, isOptional: false },\n    definition: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    sql: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    metricIds: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isArray: true,\n      isOptional: true,\n    },\n    cacheTtlSeconds: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    isShared: { type: ScalarTypeEnum.Boolean(), isOptional: true },\n  },\n});\n\n/**\n * Input for executing a query.\n */\nexport const ExecuteQueryInputModel = defineSchemaModel({\n  name: 'ExecuteQueryInput',\n  fields: {\n    queryId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    parameters: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    dateRange: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    filters: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    forceRefresh: { type: ScalarTypeEnum.Boolean(), isOptional: true },\n  },\n});\n"],"mappings":";;;;;;;AAMA,MAAa,aAAa,kBAAkB;CAC1C,MAAM;CACN,QAAQ;EACN,IAAI;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,MAAM;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE,aAAa;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACzE,MAAM;GAAE,MAAM;GAAe,YAAY;GAAO;EAChD,YAAY;GAAE,MAAM,eAAe,MAAM;GAAE,YAAY;GAAO;EAC9D,KAAK;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACjE,iBAAiB;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAO;EAC3E,UAAU;GAAE,MAAM,eAAe,SAAS;GAAE,YAAY;GAAO;EAC/D,WAAW;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAO;EAClE;CACF,CAAC;;;;AAKF,MAAa,mBAAmB,kBAAkB;CAChD,MAAM;CACN,QAAQ;EACN,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,MAAM;GAAE,MAAM,eAAe,MAAM;GAAE,YAAY;GAAO;EACxD,SAAS;GAAE,MAAM,eAAe,MAAM;GAAE,YAAY;GAAO;EAC3D,UAAU;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAO;EACpE,iBAAiB;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAO;EAC3E,UAAU;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAM;EAC/D,OAAO;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACpE;CACF,CAAC;;;;AAKF,MAAa,wBAAwB,kBAAkB;CACrD,MAAM;CACN,QAAQ;EACN,MAAM;GAAE,MAAM,eAAe,gBAAgB;GAAE,YAAY;GAAO;EAClE,aAAa;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACzE,MAAM;GAAE,MAAM;GAAe,YAAY;GAAO;EAChD,YAAY;GAAE,MAAM,eAAe,MAAM;GAAE,YAAY;GAAO;EAC9D,KAAK;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACjE,WAAW;GACT,MAAM,eAAe,iBAAiB;GACtC,SAAS;GACT,YAAY;GACb;EACD,iBAAiB;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAM;EAC1E,UAAU;GAAE,MAAM,eAAe,SAAS;GAAE,YAAY;GAAM;EAC/D;CACF,CAAC;;;;AAKF,MAAa,yBAAyB,kBAAkB;CACtD,MAAM;CACN,QAAQ;EACN,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,YAAY;GAAE,MAAM,eAAe,MAAM;GAAE,YAAY;GAAM;EAC7D,WAAW;GAAE,MAAM,eAAe,MAAM;GAAE,YAAY;GAAM;EAC5D,SAAS;GAAE,MAAM,eAAe,MAAM;GAAE,YAAY;GAAM;EAC1D,cAAc;GAAE,MAAM,eAAe,SAAS;GAAE,YAAY;GAAM;EACnE;CACF,CAAC"}

package/dist/query-engine/index.d.ts

@@ -0,0 +1,106 @@
+//#region src/query-engine/index.d.ts
+/**
+ * Analytics Query Engine
+ *
+ * Provides query execution and caching for analytics dashboards.
+ */
+interface QueryDefinition {
+  type: 'SQL' | 'METRIC' | 'AGGREGATION' | 'CUSTOM';
+  sql?: string;
+  metricIds?: string[];
+  aggregation?: AggregationDefinition;
+  custom?: CustomQueryDefinition;
+}
+interface AggregationDefinition {
+  source: string;
+  measures: MeasureDefinition[];
+  dimensions: DimensionDefinition[];
+  filters?: FilterDefinition[];
+  orderBy?: OrderByDefinition[];
+  limit?: number;
+}
+interface MeasureDefinition {
+  name: string;
+  field: string;
+  aggregation: 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX' | 'COUNT_DISTINCT';
+  format?: string;
+}
+interface DimensionDefinition {
+  name: string;
+  field: string;
+  type?: 'TIME' | 'STRING' | 'NUMBER';
+  granularity?: 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR';
+}
+interface FilterDefinition {
+  field: string;
+  operator: 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'nin' | 'contains' | 'between';
+  value: unknown;
+}
+interface OrderByDefinition {
+  field: string;
+  direction: 'ASC' | 'DESC';
+}
+interface CustomQueryDefinition {
+  handler: string;
+  parameters: Record<string, unknown>;
+}
+interface QueryParameters {
+  dateRange?: {
+    start: Date;
+    end: Date;
+    granularity?: string;
+  };
+  filters?: FilterDefinition[];
+  parameters?: Record<string, unknown>;
+}
+interface QueryResult {
+  data: Record<string, unknown>[];
+  columns: ColumnDefinition[];
+  rowCount: number;
+  executionTimeMs: number;
+  cached: boolean;
+  cachedAt?: Date;
+  error?: string;
+}
+interface ColumnDefinition {
+  name: string;
+  type: 'STRING' | 'NUMBER' | 'DATE' | 'BOOLEAN';
+  label?: string;
+  format?: string;
+}
+interface IQueryEngine {
+  execute(definition: QueryDefinition, params: QueryParameters): Promise<QueryResult>;
+  validateQuery(definition: QueryDefinition): {
+    valid: boolean;
+    errors: string[];
+  };
+}
+interface IQueryCache {
+  get(key: string): Promise<QueryResult | null>;
+  set(key: string, result: QueryResult, ttlSeconds: number): Promise<void>;
+  invalidate(pattern: string): Promise<void>;
+}
+declare class InMemoryQueryCache implements IQueryCache {
+  private cache;
+  get(key: string): Promise<QueryResult | null>;
+  set(key: string, result: QueryResult, ttlSeconds: number): Promise<void>;
+  invalidate(pattern: string): Promise<void>;
+}
+declare class BasicQueryEngine implements IQueryEngine {
+  private cache;
+  constructor(cache?: IQueryCache);
+  execute(definition: QueryDefinition, params: QueryParameters): Promise<QueryResult>;
+  validateQuery(definition: QueryDefinition): {
+    valid: boolean;
+    errors: string[];
+  };
+  private buildCacheKey;
+  private executeAggregation;
+  private executeMetric;
+  private executeSql;
+  private generateMockData;
+}
+declare function createQueryEngine(cache?: IQueryCache): IQueryEngine;
+//#endregion
+export { AggregationDefinition, BasicQueryEngine, ColumnDefinition, CustomQueryDefinition, DimensionDefinition, FilterDefinition, IQueryCache, IQueryEngine, InMemoryQueryCache, MeasureDefinition, OrderByDefinition, QueryDefinition, QueryParameters, QueryResult, createQueryEngine };
+//# sourceMappingURL=index.d.ts.map

package/dist/query-engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/query-engine/index.ts"],"sourcesContent":[],"mappings":";;AAQA;AAQA;;;AAIY,UAZK,eAAA,CAYL;EACA,IAAA,EAAA,KAAA,GAAA,QAAA,GAAA,aAAA,GAAA,QAAA;EAAiB,GAAA,CAAA,EAAA,MAAA;EAIZ,SAAA,CAAA,EAAA,MAAA,EAAiB;EAOjB,WAAA,CAAA,EApBD,qBAoBoB;EAOnB,MAAA,CAAA,EA1BN,qBA0BsB;AAgBjC;AAKiB,UA5CA,qBAAA,CA8CH;EAGG,MAAA,EAAA,MAAA;EAEN,QAAA,EAjDC,iBAiDD,EAAA;EACF,UAAA,EAjDK,mBAiDL,EAAA;EAGG,OAAA,CAAA,EAnDA,gBAmDA,EAAA;EACG,OAAA,CAAA,EAnDH,iBAmDG,EAAA;EAAM,KAAA,CAAA,EAAA,MAAA;AAGrB;AACQ,UAnDS,iBAAA,CAmDT;EACG,IAAA,EAAA,MAAA;EAIE,KAAA,EAAA,MAAA;EAAI,WAAA,EAAA,OAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,gBAAA;EAIA,MAAA,CAAA,EAAA,MAAA;AASjB;AAEgB,UAhEC,mBAAA,CAgED;EACJ,IAAA,EAAA,MAAA;EACC,KAAA,EAAA,MAAA;EAAR,IAAA,CAAA,EAAA,MAAA,GAAA,QAAA,GAAA,QAAA;EACuB,WAAA,CAAA,EAAA,MAAA,GAAA,KAAA,GAAA,MAAA,GAAA,OAAA,GAAA,MAAA;;AAQX,UApEA,gBAAA,CAoEW;EACA,KAAA,EAAA,MAAA;EAAR,QAAA,EAAA,IAAA,GAAA,KAAA,GAAA,IAAA,GAAA,KAAA,GAAA,IAAA,GAAA,KAAA,GAAA,IAAA,GAAA,KAAA,GAAA,UAAA,GAAA,SAAA;EACO,KAAA,EAAA,OAAA;;AACI,UAvDd,iBAAA,CAuDc;EAAO,KAAA,EAAA,MAAA;EAGzB,SAAA,EAAA,KAAA,GAAA,MAAmB;;AAGN,UAxDT,qBAAA,CAwDS;EAYd,OAAA,EAAA,MAAA;EAEP,UAAA,EApES,MAoET,CAAA,MAAA,EAAA,OAAA,CAAA;;AAjBsC,UAhD1B,eAAA,CAgD0B;EAAW,SAAA,CAAA,EAAA;IAkCzC,KAAA,EAhFF,IAgFE;IAGS,GAAA,EAlFb,IAkFa;IAKN,WAAA,CAAA,EAAA,MAAA;EACJ,CAAA;EACC,OAAA,CAAA,EAtFD,gBAsFC,EAAA;EAAR,UAAA,CAAA,EArFU,MAqFV,CAAA,MAAA,EAAA,OAAA,CAAA;;AAVoC,UAxExB,WAAA,CAwEwB;EAAY,IAAA,EAvE7C,MAuE6C,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA;EA6OrC,OAAA,EAnTL,gBAmTsB,EAAA;;;;aA/SpB;;;UAII,gBAAA;;;;;;UASA,YAAA;sBAED,yBACJ,kBACP,QAAQ;4BACe;;;;;UAQX,WAAA;oBACG,QAAQ;2BACD,kCAAkC;+BAC9B;;cAGlB,kBAAA,YAA8B;;oBAGjB,QAAQ;2BAYtB,kCAEP;+BAKgC;;cAYxB,gBAAA,YAA4B;;sBAGnB;sBAKN,yBACJ,kBACP,QAAQ;4BAgEe;;;;;;;;;;iBAmKZ,iBAAA,SAA0B,cAAc"}