@contractspec/example.analytics-dashboard 1.56.1 → 1.58.0

package/dist/query/query.test-spec.js

@@ -1,124 +1,114 @@
+// @bun
+// src/query/query.test-spec.ts
 import { defineTestSpec } from "@contractspec/lib.contracts";
-
-//#region src/query/query.test-spec.ts
-const CreateQueryTest = defineTestSpec({
-	meta: {
-		key: "analytics.query.create.test",
-		version: "1.0.0",
-		title: "Create Query Test",
-		description: "Verifies query creation flow",
-		owners: ["@example.analytics-dashboard"],
-		tags: [
-			"analytics",
-			"query",
-			"test"
-		],
-		stability: "stable"
-	},
-	target: {
-		type: "operation",
-		operation: {
-			key: "analytics.query.create",
-			version: "1.0.0"
-		}
-	},
-	scenarios: [{
-		key: "success",
-		description: "Successfully create a query",
-		when: {
-			operation: {
-				key: "analytics.query.create",
-				version: "1.0.0"
-			},
-			input: {
-				name: "Revenue Query",
-				sql: "SELECT * FROM revenue"
-			}
-		},
-		then: [{
-			type: "expectOutput",
-			match: {
-				name: "Revenue Query",
-				type: "sql"
-			}
-		}]
-	}, {
-		key: "error-invalid-sql",
-		description: "Fail with invalid SQL",
-		when: {
-			operation: {
-				key: "analytics.query.create",
-				version: "1.0.0"
-			},
-			input: {
-				name: "Bad Query",
-				sql: ""
-			}
-		},
-		then: [{
-			type: "expectError",
-			messageIncludes: "VALIDATION_ERROR"
-		}]
-	}]
+var CreateQueryTest = defineTestSpec({
+  meta: {
+    key: "analytics.query.create.test",
+    version: "1.0.0",
+    title: "Create Query Test",
+    description: "Verifies query creation flow",
+    owners: ["@example.analytics-dashboard"],
+    tags: ["analytics", "query", "test"],
+    stability: "stable"
+  },
+  target: {
+    type: "operation",
+    operation: { key: "analytics.query.create", version: "1.0.0" }
+  },
+  scenarios: [
+    {
+      key: "success",
+      description: "Successfully create a query",
+      when: {
+        operation: { key: "analytics.query.create", version: "1.0.0" },
+        input: {
+          name: "Revenue Query",
+          sql: "SELECT * FROM revenue"
+        }
+      },
+      then: [
+        {
+          type: "expectOutput",
+          match: {
+            name: "Revenue Query",
+            type: "sql"
+          }
+        }
+      ]
+    },
+    {
+      key: "error-invalid-sql",
+      description: "Fail with invalid SQL",
+      when: {
+        operation: { key: "analytics.query.create", version: "1.0.0" },
+        input: {
+          name: "Bad Query",
+          sql: ""
+        }
+      },
+      then: [
+        {
+          type: "expectError",
+          messageIncludes: "VALIDATION_ERROR"
+        }
+      ]
+    }
+  ]
 });
-const ExecuteQueryTest = defineTestSpec({
-	meta: {
-		key: "analytics.query.execute.test",
-		version: "1.0.0",
-		title: "Execute Query Test",
-		description: "Verifies query execution",
-		owners: ["@example.analytics-dashboard"],
-		tags: [
-			"analytics",
-			"query",
-			"test"
-		],
-		stability: "stable"
-	},
-	target: {
-		type: "operation",
-		operation: {
-			key: "analytics.query.execute",
-			version: "1.0.0"
-		}
-	},
-	scenarios: [{
-		key: "success",
-		description: "Successfully execute query",
-		when: {
-			operation: {
-				key: "analytics.query.execute",
-				version: "1.0.0"
-			},
-			input: {
-				queryId: "q-123",
-				params: { limit: 10 }
-			}
-		},
-		then: [{
-			type: "expectOutput",
-			match: { rowCount: 1 }
-		}]
-	}, {
-		key: "error-query-not-found",
-		description: "Fail when query not found",
-		when: {
-			operation: {
-				key: "analytics.query.execute",
-				version: "1.0.0"
-			},
-			input: {
-				queryId: "q-999",
-				params: {}
-			}
-		},
-		then: [{
-			type: "expectError",
-			messageIncludes: "NOT_FOUND"
-		}]
-	}]
+var ExecuteQueryTest = defineTestSpec({
+  meta: {
+    key: "analytics.query.execute.test",
+    version: "1.0.0",
+    title: "Execute Query Test",
+    description: "Verifies query execution",
+    owners: ["@example.analytics-dashboard"],
+    tags: ["analytics", "query", "test"],
+    stability: "stable"
+  },
+  target: {
+    type: "operation",
+    operation: { key: "analytics.query.execute", version: "1.0.0" }
+  },
+  scenarios: [
+    {
+      key: "success",
+      description: "Successfully execute query",
+      when: {
+        operation: { key: "analytics.query.execute", version: "1.0.0" },
+        input: {
+          queryId: "q-123",
+          params: { limit: 10 }
+        }
+      },
+      then: [
+        {
+          type: "expectOutput",
+          match: {
+            rowCount: 1
+          }
+        }
+      ]
+    },
+    {
+      key: "error-query-not-found",
+      description: "Fail when query not found",
+      when: {
+        operation: { key: "analytics.query.execute", version: "1.0.0" },
+        input: {
+          queryId: "q-999",
+          params: {}
+        }
+      },
+      then: [
+        {
+          type: "expectError",
+          messageIncludes: "NOT_FOUND"
+        }
+      ]
+    }
+  ]
 });
-
-//#endregion
-export { CreateQueryTest, ExecuteQueryTest };
-//# sourceMappingURL=query.test-spec.js.map
+export {
+  ExecuteQueryTest,
+  CreateQueryTest
+};

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

@@ -1,106 +1,104 @@
-//#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;
+export 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;
+export 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;
+export 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';
+export 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;
+export interface FilterDefinition {
+    field: string;
+    operator: 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'nin' | 'contains' | 'between';
+    value: unknown;
 }
-interface OrderByDefinition {
-  field: string;
-  direction: 'ASC' | 'DESC';
+export interface OrderByDefinition {
+    field: string;
+    direction: 'ASC' | 'DESC';
 }
-interface CustomQueryDefinition {
-  handler: string;
-  parameters: Record<string, unknown>;
+export interface CustomQueryDefinition {
+    handler: string;
+    parameters: Record<string, unknown>;
 }
-interface QueryParameters {
-  dateRange?: {
-    start: Date;
-    end: Date;
-    granularity?: string;
-  };
-  filters?: FilterDefinition[];
-  parameters?: Record<string, unknown>;
+export 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;
+export 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;
+export 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[];
-  };
+export 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>;
+export 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>;
+export 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;
+export 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 };
+export declare function createQueryEngine(cache?: IQueryCache): IQueryEngine;
+export { PosthogQueryEngine, createPosthogQueryEngine, } from '../datasource/posthog-datasource';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,CA4CqB;EAKrB,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query-engine/index.ts"],"names":[],"mappings":"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"}