@contractspec/example.analytics-dashboard 1.57.0 → 1.58.0

package/dist/query/query.operation.js

@@ -1,113 +1,155 @@
-import { CreateQueryInputModel, ExecuteQueryInputModel, QueryModel, QueryResultModel } from "./query.schema.js";
-import { defineCommand, defineQuery } from "@contractspec/lib.contracts/operations";
+// @bun
+// src/query/query.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var QueryTypeEnum = defineEnum("QueryType", [
+  "SQL",
+  "METRIC",
+  "AGGREGATION",
+  "CUSTOM"
+]);
 
-//#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.0.0",
-		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.0.0",
-			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"
-			}
-		}]
-	}
+// src/query/query.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var 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 }
+  }
 });
-/**
-* Execute a data query.
-*/
-const ExecuteQueryContract = defineQuery({
-	meta: {
-		key: "analytics.query.execute",
-		version: "1.0.0",
-		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
-			}
-		}]
-	}
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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 { CreateQueryContract, ExecuteQueryContract };
-//# sourceMappingURL=query.operation.js.map
+// src/query/query.operation.ts
+import {
+  defineCommand,
+  defineQuery
+} from "@contractspec/lib.contracts/operations";
+var OWNERS = ["@example.analytics-dashboard"];
+var CreateQueryContract = defineCommand({
+  meta: {
+    key: "analytics.query.create",
+    version: "1.0.0",
+    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.0.0",
+        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" }
+      }
+    ]
+  }
+});
+var ExecuteQueryContract = defineQuery({
+  meta: {
+    key: "analytics.query.execute",
+    version: "1.0.0",
+    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: 50000 }], rowCount: 1 }
+      }
+    ]
+  }
+});
+export {
+  ExecuteQueryContract,
+  CreateQueryContract
+};

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"query.presentation.d.ts","names":[],"sources":["../../src/query/query.presentation.ts"],"mappings":";;;cAGa,uBAAA,EAuBX,4BAAA,CAvBkC,gBAAA;AAAA,cAyBvB,wBAAA,EAuBX,4BAAA,CAvBmC,gBAAA"}
+{"version":3,"file":"query.presentation.d.ts","sourceRoot":"","sources":["../../src/query/query.presentation.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,wDAuBlC,CAAC;AAEH,eAAO,MAAM,wBAAwB,wDAuBnC,CAAC"}

package/dist/query/query.presentation.js

@@ -1,60 +1,120 @@
-import { QueryModel } from "./query.schema.js";
-import { StabilityEnum, definePresentation } from "@contractspec/lib.contracts";
+// @bun
+// src/query/query.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var QueryTypeEnum = defineEnum("QueryType", [
+  "SQL",
+  "METRIC",
+  "AGGREGATION",
+  "CUSTOM"
+]);
 
-//#region src/query/query.presentation.ts
-const QueriesListPresentation = definePresentation({
-	meta: {
-		key: "analytics.query.list",
-		version: "1.0.0",
-		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"] }
+// src/query/query.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var 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 }
+  }
 });
-const QueryBuilderPresentation = definePresentation({
-	meta: {
-		key: "analytics.query.builder",
-		version: "1.0.0",
-		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"] }
+var 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 }
+  }
+});
+var 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 }
+  }
+});
+var 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 { QueriesListPresentation, QueryBuilderPresentation };
-//# sourceMappingURL=query.presentation.js.map
+// src/query/query.presentation.ts
+import { definePresentation, StabilityEnum } from "@contractspec/lib.contracts";
+var QueriesListPresentation = definePresentation({
+  meta: {
+    key: "analytics.query.list",
+    version: "1.0.0",
+    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"]
+  }
+});
+var QueryBuilderPresentation = definePresentation({
+  meta: {
+    key: "analytics.query.builder",
+    version: "1.0.0",
+    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"]
+  }
+});
+export {
+  QueryBuilderPresentation,
+  QueriesListPresentation
+};