@contractspec/example.analytics-dashboard 1.46.1 → 1.47.0

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

@@ -0,0 +1,124 @@
+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"
+		}]
+	}]
+});
+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"
+		}]
+	}]
+});
+
+//#endregion
+export { CreateQueryTest, ExecuteQueryTest };
+//# sourceMappingURL=query.test-spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.test-spec.js","names":[],"sources":["../../src/query/query.test-spec.ts"],"sourcesContent":["import { defineTestSpec } from '@contractspec/lib.contracts';\n\nexport const CreateQueryTest = defineTestSpec({\n  meta: {\n    key: 'analytics.query.create.test',\n    version: '1.0.0',\n    title: 'Create Query Test',\n    description: 'Verifies query creation flow',\n    owners: ['@example.analytics-dashboard'],\n    tags: ['analytics', 'query', 'test'],\n    stability: 'stable',\n  },\n  target: {\n    type: 'operation',\n    operation: { key: 'analytics.query.create', version: '1.0.0' },\n  },\n  scenarios: [\n    {\n      key: 'success',\n      description: 'Successfully create a query',\n      when: {\n        operation: { key: 'analytics.query.create', version: '1.0.0' },\n        input: {\n          name: 'Revenue Query',\n          sql: 'SELECT * FROM revenue',\n        },\n      },\n      then: [\n        {\n          type: 'expectOutput',\n          match: {\n            name: 'Revenue Query',\n            type: 'sql',\n          },\n        },\n      ],\n    },\n    {\n      key: 'error-invalid-sql',\n      description: 'Fail with invalid SQL',\n      when: {\n        operation: { key: 'analytics.query.create', version: '1.0.0' },\n        input: {\n          name: 'Bad Query',\n          sql: '',\n        },\n      },\n      then: [\n        {\n          type: 'expectError',\n          messageIncludes: 'VALIDATION_ERROR',\n        },\n      ],\n    },\n  ],\n});\n\nexport const ExecuteQueryTest = defineTestSpec({\n  meta: {\n    key: 'analytics.query.execute.test',\n    version: '1.0.0',\n    title: 'Execute Query Test',\n    description: 'Verifies query execution',\n    owners: ['@example.analytics-dashboard'],\n    tags: ['analytics', 'query', 'test'],\n    stability: 'stable',\n  },\n  target: {\n    type: 'operation',\n    operation: { key: 'analytics.query.execute', version: '1.0.0' },\n  },\n  scenarios: [\n    {\n      key: 'success',\n      description: 'Successfully execute query',\n      when: {\n        operation: { key: 'analytics.query.execute', version: '1.0.0' },\n        input: {\n          queryId: 'q-123',\n          params: { limit: 10 },\n        },\n      },\n      then: [\n        {\n          type: 'expectOutput',\n          match: {\n            rowCount: 1,\n          },\n        },\n      ],\n    },\n    {\n      key: 'error-query-not-found',\n      description: 'Fail when query not found',\n      when: {\n        operation: { key: 'analytics.query.execute', version: '1.0.0' },\n        input: {\n          queryId: 'q-999',\n          params: {},\n        },\n      },\n      then: [\n        {\n          type: 'expectError',\n          messageIncludes: 'NOT_FOUND',\n        },\n      ],\n    },\n  ],\n});\n"],"mappings":";;;AAEA,MAAa,kBAAkB,eAAe;CAC5C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ,CAAC,+BAA+B;EACxC,MAAM;GAAC;GAAa;GAAS;GAAO;EACpC,WAAW;EACZ;CACD,QAAQ;EACN,MAAM;EACN,WAAW;GAAE,KAAK;GAA0B,SAAS;GAAS;EAC/D;CACD,WAAW,CACT;EACE,KAAK;EACL,aAAa;EACb,MAAM;GACJ,WAAW;IAAE,KAAK;IAA0B,SAAS;IAAS;GAC9D,OAAO;IACL,MAAM;IACN,KAAK;IACN;GACF;EACD,MAAM,CACJ;GACE,MAAM;GACN,OAAO;IACL,MAAM;IACN,MAAM;IACP;GACF,CACF;EACF,EACD;EACE,KAAK;EACL,aAAa;EACb,MAAM;GACJ,WAAW;IAAE,KAAK;IAA0B,SAAS;IAAS;GAC9D,OAAO;IACL,MAAM;IACN,KAAK;IACN;GACF;EACD,MAAM,CACJ;GACE,MAAM;GACN,iBAAiB;GAClB,CACF;EACF,CACF;CACF,CAAC;AAEF,MAAa,mBAAmB,eAAe;CAC7C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ,CAAC,+BAA+B;EACxC,MAAM;GAAC;GAAa;GAAS;GAAO;EACpC,WAAW;EACZ;CACD,QAAQ;EACN,MAAM;EACN,WAAW;GAAE,KAAK;GAA2B,SAAS;GAAS;EAChE;CACD,WAAW,CACT;EACE,KAAK;EACL,aAAa;EACb,MAAM;GACJ,WAAW;IAAE,KAAK;IAA2B,SAAS;IAAS;GAC/D,OAAO;IACL,SAAS;IACT,QAAQ,EAAE,OAAO,IAAI;IACtB;GACF;EACD,MAAM,CACJ;GACE,MAAM;GACN,OAAO,EACL,UAAU,GACX;GACF,CACF;EACF,EACD;EACE,KAAK;EACL,aAAa;EACb,MAAM;GACJ,WAAW;IAAE,KAAK;IAA2B,SAAS;IAAS;GAC/D,OAAO;IACL,SAAS;IACT,QAAQ,EAAE;IACX;GACF;EACD,MAAM,CACJ;GACE,MAAM;GACN,iBAAiB;GAClB,CACF;EACF,CACF;CACF,CAAC"}

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,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"}
+{"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"}

package/dist/query-engine/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["result: QueryResult","errors: string[]","columns: ColumnDefinition[]","data: Record<string, unknown>[]","row: Record<string, unknown>"],"sources":["../../src/query-engine/index.ts"],"sourcesContent":["/**\n * Analytics Query Engine\n *\n * Provides query execution and caching for analytics dashboards.\n */\n\n// ============ Types ============\n\nexport interface QueryDefinition {\n  type: 'SQL' | 'METRIC' | 'AGGREGATION' | 'CUSTOM';\n  sql?: string;\n  metricIds?: string[];\n  aggregation?: AggregationDefinition;\n  custom?: CustomQueryDefinition;\n}\n\nexport interface AggregationDefinition {\n  source: string;\n  measures: MeasureDefinition[];\n  dimensions: DimensionDefinition[];\n  filters?: FilterDefinition[];\n  orderBy?: OrderByDefinition[];\n  limit?: number;\n}\n\nexport interface MeasureDefinition {\n  name: string;\n  field: string;\n  aggregation: 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX' | 'COUNT_DISTINCT';\n  format?: string;\n}\n\nexport interface DimensionDefinition {\n  name: string;\n  field: string;\n  type?: 'TIME' | 'STRING' | 'NUMBER';\n  granularity?: 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR';\n}\n\nexport interface FilterDefinition {\n  field: string;\n  operator:\n    | 'eq'\n    | 'neq'\n    | 'gt'\n    | 'gte'\n    | 'lt'\n    | 'lte'\n    | 'in'\n    | 'nin'\n    | 'contains'\n    | 'between';\n  value: unknown;\n}\n\nexport interface OrderByDefinition {\n  field: string;\n  direction: 'ASC' | 'DESC';\n}\n\nexport interface CustomQueryDefinition {\n  handler: string;\n  parameters: Record<string, unknown>;\n}\n\nexport interface QueryParameters {\n  dateRange?: {\n    start: Date;\n    end: Date;\n    granularity?: string;\n  };\n  filters?: FilterDefinition[];\n  parameters?: Record<string, unknown>;\n}\n\nexport interface QueryResult {\n  data: Record<string, unknown>[];\n  columns: ColumnDefinition[];\n  rowCount: number;\n  executionTimeMs: number;\n  cached: boolean;\n  cachedAt?: Date;\n  error?: string;\n}\n\nexport interface ColumnDefinition {\n  name: string;\n  type: 'STRING' | 'NUMBER' | 'DATE' | 'BOOLEAN';\n  label?: string;\n  format?: string;\n}\n\n// ============ Query Engine Interface ============\n\nexport interface IQueryEngine {\n  execute(\n    definition: QueryDefinition,\n    params: QueryParameters\n  ): Promise<QueryResult>;\n  validateQuery(definition: QueryDefinition): {\n    valid: boolean;\n    errors: string[];\n  };\n}\n\n// ============ Query Cache ============\n\nexport interface IQueryCache {\n  get(key: string): Promise<QueryResult | null>;\n  set(key: string, result: QueryResult, ttlSeconds: number): Promise<void>;\n  invalidate(pattern: string): Promise<void>;\n}\n\nexport class InMemoryQueryCache implements IQueryCache {\n  private cache = new Map<string, { result: QueryResult; expiresAt: Date }>();\n\n  async get(key: string): Promise<QueryResult | null> {\n    const entry = this.cache.get(key);\n    if (!entry) return null;\n    if (entry.expiresAt < new Date()) {\n      this.cache.delete(key);\n      return null;\n    }\n    return { ...entry.result, cached: true, cachedAt: entry.expiresAt };\n  }\n\n  async set(\n    key: string,\n    result: QueryResult,\n    ttlSeconds: number\n  ): Promise<void> {\n    const expiresAt = new Date(Date.now() + ttlSeconds * 1000);\n    this.cache.set(key, { result, expiresAt });\n  }\n\n  async invalidate(pattern: string): Promise<void> {\n    const regex = new RegExp(pattern);\n    for (const key of this.cache.keys()) {\n      if (regex.test(key)) {\n        this.cache.delete(key);\n      }\n    }\n  }\n}\n\n// ============ Basic Query Engine ============\n\nexport class BasicQueryEngine implements IQueryEngine {\n  private cache: IQueryCache;\n\n  constructor(cache?: IQueryCache) {\n    this.cache = cache ?? new InMemoryQueryCache();\n  }\n\n  async execute(\n    definition: QueryDefinition,\n    params: QueryParameters\n  ): Promise<QueryResult> {\n    const startTime = Date.now();\n\n    // Validate query\n    const validation = this.validateQuery(definition);\n    if (!validation.valid) {\n      return {\n        data: [],\n        columns: [],\n        rowCount: 0,\n        executionTimeMs: Date.now() - startTime,\n        cached: false,\n        error: validation.errors.join(', '),\n      };\n    }\n\n    // Check cache\n    const cacheKey = this.buildCacheKey(definition, params);\n    const cachedResult = await this.cache.get(cacheKey);\n    if (cachedResult) {\n      return cachedResult;\n    }\n\n    // Execute query based on type\n    let result: QueryResult;\n    switch (definition.type) {\n      case 'AGGREGATION':\n        if (!definition.aggregation) {\n          throw new Error('Aggregation definition is missing');\n        }\n        result = await this.executeAggregation(definition.aggregation, params);\n        break;\n      case 'METRIC':\n        if (!definition.metricIds) {\n          throw new Error('Metric IDs are missing');\n        }\n        result = await this.executeMetric(definition.metricIds, params);\n        break;\n      case 'SQL':\n        if (!definition.sql) {\n          throw new Error('SQL query is missing');\n        }\n        result = await this.executeSql(definition.sql, params);\n        break;\n      default:\n        result = {\n          data: [],\n          columns: [],\n          rowCount: 0,\n          executionTimeMs: Date.now() - startTime,\n          cached: false,\n          error: `Unknown query type: ${definition.type}`,\n        };\n    }\n\n    result.executionTimeMs = Date.now() - startTime;\n    result.cached = false;\n\n    // Cache result\n    await this.cache.set(cacheKey, result, 300);\n\n    return result;\n  }\n\n  validateQuery(definition: QueryDefinition): {\n    valid: boolean;\n    errors: string[];\n  } {\n    const errors: string[] = [];\n\n    if (!definition.type) {\n      errors.push('Query type is required');\n    }\n\n    switch (definition.type) {\n      case 'SQL':\n        if (!definition.sql) {\n          errors.push('SQL query is required for SQL type');\n        }\n        break;\n      case 'METRIC':\n        if (!definition.metricIds || definition.metricIds.length === 0) {\n          errors.push('Metric IDs are required for METRIC type');\n        }\n        break;\n      case 'AGGREGATION':\n        if (!definition.aggregation) {\n          errors.push(\n            'Aggregation definition is required for AGGREGATION type'\n          );\n        } else {\n          if (!definition.aggregation.source) {\n            errors.push('Aggregation source is required');\n          }\n          if (\n            !definition.aggregation.measures ||\n            definition.aggregation.measures.length === 0\n          ) {\n            errors.push('At least one measure is required');\n          }\n        }\n        break;\n    }\n\n    return { valid: errors.length === 0, errors };\n  }\n\n  private buildCacheKey(\n    definition: QueryDefinition,\n    params: QueryParameters\n  ): string {\n    return JSON.stringify({ definition, params });\n  }\n\n  private async executeAggregation(\n    aggregation: AggregationDefinition,\n    params: QueryParameters\n  ): Promise<QueryResult> {\n    // In production, this would execute against a data warehouse\n    // For demo, return mock data\n    const columns: ColumnDefinition[] = [\n      ...aggregation.dimensions.map((d) => ({\n        name: d.name,\n        type: (d.type === 'NUMBER'\n          ? 'NUMBER'\n          : d.type === 'TIME'\n            ? 'DATE'\n            : 'STRING') as ColumnDefinition['type'],\n        label: d.name,\n      })),\n      ...aggregation.measures.map((m) => ({\n        name: m.name,\n        type: 'NUMBER' as const,\n        label: m.name,\n        format: m.format,\n      })),\n    ];\n\n    // Mock data generation\n    const data = this.generateMockData(aggregation, params);\n\n    return {\n      data,\n      columns,\n      rowCount: data.length,\n      executionTimeMs: 0,\n      cached: false,\n    };\n  }\n\n  private async executeMetric(\n    metricIds: string[],\n    _params: QueryParameters\n  ): Promise<QueryResult> {\n    // In production, this would fetch from metering service\n    const data = metricIds.map((id) => ({\n      metricId: id,\n      value: Math.random() * 1000,\n      change: (Math.random() - 0.5) * 20,\n    }));\n\n    return {\n      data,\n      columns: [\n        { name: 'metricId', type: 'STRING' },\n        { name: 'value', type: 'NUMBER' },\n        { name: 'change', type: 'NUMBER' },\n      ],\n      rowCount: data.length,\n      executionTimeMs: 0,\n      cached: false,\n    };\n  }\n\n  private async executeSql(\n    _sql: string,\n    _params: QueryParameters\n  ): Promise<QueryResult> {\n    // In production, this would execute SQL against a database\n    return {\n      data: [],\n      columns: [],\n      rowCount: 0,\n      executionTimeMs: 0,\n      cached: false,\n      error: 'SQL execution not implemented in demo',\n    };\n  }\n\n  private generateMockData(\n    aggregation: AggregationDefinition,\n    params: QueryParameters\n  ): Record<string, unknown>[] {\n    const data: Record<string, unknown>[] = [];\n    const rowCount = 10;\n\n    // Generate time series data if there's a time dimension\n    const timeDimension = aggregation.dimensions.find((d) => d.type === 'TIME');\n\n    for (let i = 0; i < rowCount; i++) {\n      const row: Record<string, unknown> = {};\n\n      for (const dim of aggregation.dimensions) {\n        if (dim.type === 'TIME') {\n          const date = new Date(params.dateRange?.start ?? new Date());\n          date.setDate(date.getDate() + i);\n          row[dim.name] = date.toISOString().split('T')[0];\n        } else {\n          row[dim.name] = `${dim.name}_${i % 5}`;\n        }\n      }\n\n      for (const measure of aggregation.measures) {\n        const baseValue = timeDimension ? 100 + i * 10 : Math.random() * 1000;\n        const noise = (Math.random() - 0.5) * 20;\n        row[measure.name] = Math.round((baseValue + noise) * 100) / 100;\n      }\n\n      data.push(row);\n    }\n\n    return data;\n  }\n}\n\n// ============ Factory ============\n\nexport function createQueryEngine(cache?: IQueryCache): IQueryEngine {\n  return new BasicQueryEngine(cache);\n}\n"],"mappings":";AAiHA,IAAa,qBAAb,MAAuD;CACrD,AAAQ,wBAAQ,IAAI,KAAuD;CAE3E,MAAM,IAAI,KAA0C;EAClD,MAAM,QAAQ,KAAK,MAAM,IAAI,IAAI;AACjC,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,MAAM,4BAAY,IAAI,MAAM,EAAE;AAChC,QAAK,MAAM,OAAO,IAAI;AACtB,UAAO;;AAET,SAAO;GAAE,GAAG,MAAM;GAAQ,QAAQ;GAAM,UAAU,MAAM;GAAW;;CAGrE,MAAM,IACJ,KACA,QACA,YACe;EACf,MAAM,YAAY,IAAI,KAAK,KAAK,KAAK,GAAG,aAAa,IAAK;AAC1D,OAAK,MAAM,IAAI,KAAK;GAAE;GAAQ;GAAW,CAAC;;CAG5C,MAAM,WAAW,SAAgC;EAC/C,MAAM,QAAQ,IAAI,OAAO,QAAQ;AACjC,OAAK,MAAM,OAAO,KAAK,MAAM,MAAM,CACjC,KAAI,MAAM,KAAK,IAAI,CACjB,MAAK,MAAM,OAAO,IAAI;;;AAQ9B,IAAa,mBAAb,MAAsD;CACpD,AAAQ;CAER,YAAY,OAAqB;AAC/B,OAAK,QAAQ,SAAS,IAAI,oBAAoB;;CAGhD,MAAM,QACJ,YACA,QACsB;EACtB,MAAM,YAAY,KAAK,KAAK;EAG5B,MAAM,aAAa,KAAK,cAAc,WAAW;AACjD,MAAI,CAAC,WAAW,MACd,QAAO;GACL,MAAM,EAAE;GACR,SAAS,EAAE;GACX,UAAU;GACV,iBAAiB,KAAK,KAAK,GAAG;GAC9B,QAAQ;GACR,OAAO,WAAW,OAAO,KAAK,KAAK;GACpC;EAIH,MAAM,WAAW,KAAK,cAAc,YAAY,OAAO;EACvD,MAAM,eAAe,MAAM,KAAK,MAAM,IAAI,SAAS;AACnD,MAAI,aACF,QAAO;EAIT,IAAIA;AACJ,UAAQ,WAAW,MAAnB;GACE,KAAK;AACH,QAAI,CAAC,WAAW,YACd,OAAM,IAAI,MAAM,oCAAoC;AAEtD,aAAS,MAAM,KAAK,mBAAmB,WAAW,aAAa,OAAO;AACtE;GACF,KAAK;AACH,QAAI,CAAC,WAAW,UACd,OAAM,IAAI,MAAM,yBAAyB;AAE3C,aAAS,MAAM,KAAK,cAAc,WAAW,WAAW,OAAO;AAC/D;GACF,KAAK;AACH,QAAI,CAAC,WAAW,IACd,OAAM,IAAI,MAAM,uBAAuB;AAEzC,aAAS,MAAM,KAAK,WAAW,WAAW,KAAK,OAAO;AACtD;GACF,QACE,UAAS;IACP,MAAM,EAAE;IACR,SAAS,EAAE;IACX,UAAU;IACV,iBAAiB,KAAK,KAAK,GAAG;IAC9B,QAAQ;IACR,OAAO,uBAAuB,WAAW;IAC1C;;AAGL,SAAO,kBAAkB,KAAK,KAAK,GAAG;AACtC,SAAO,SAAS;AAGhB,QAAM,KAAK,MAAM,IAAI,UAAU,QAAQ,IAAI;AAE3C,SAAO;;CAGT,cAAc,YAGZ;EACA,MAAMC,SAAmB,EAAE;AAE3B,MAAI,CAAC,WAAW,KACd,QAAO,KAAK,yBAAyB;AAGvC,UAAQ,WAAW,MAAnB;GACE,KAAK;AACH,QAAI,CAAC,WAAW,IACd,QAAO,KAAK,qCAAqC;AAEnD;GACF,KAAK;AACH,QAAI,CAAC,WAAW,aAAa,WAAW,UAAU,WAAW,EAC3D,QAAO,KAAK,0CAA0C;AAExD;GACF,KAAK;AACH,QAAI,CAAC,WAAW,YACd,QAAO,KACL,0DACD;SACI;AACL,SAAI,CAAC,WAAW,YAAY,OAC1B,QAAO,KAAK,iCAAiC;AAE/C,SACE,CAAC,WAAW,YAAY,YACxB,WAAW,YAAY,SAAS,WAAW,EAE3C,QAAO,KAAK,mCAAmC;;AAGnD;;AAGJ,SAAO;GAAE,OAAO,OAAO,WAAW;GAAG;GAAQ;;CAG/C,AAAQ,cACN,YACA,QACQ;AACR,SAAO,KAAK,UAAU;GAAE;GAAY;GAAQ,CAAC;;CAG/C,MAAc,mBACZ,aACA,QACsB;EAGtB,MAAMC,UAA8B,CAClC,GAAG,YAAY,WAAW,KAAK,OAAO;GACpC,MAAM,EAAE;GACR,MAAO,EAAE,SAAS,WACd,WACA,EAAE,SAAS,SACT,SACA;GACN,OAAO,EAAE;GACV,EAAE,EACH,GAAG,YAAY,SAAS,KAAK,OAAO;GAClC,MAAM,EAAE;GACR,MAAM;GACN,OAAO,EAAE;GACT,QAAQ,EAAE;GACX,EAAE,CACJ;EAGD,MAAM,OAAO,KAAK,iBAAiB,aAAa,OAAO;AAEvD,SAAO;GACL;GACA;GACA,UAAU,KAAK;GACf,iBAAiB;GACjB,QAAQ;GACT;;CAGH,MAAc,cACZ,WACA,SACsB;EAEtB,MAAM,OAAO,UAAU,KAAK,QAAQ;GAClC,UAAU;GACV,OAAO,KAAK,QAAQ,GAAG;GACvB,SAAS,KAAK,QAAQ,GAAG,MAAO;GACjC,EAAE;AAEH,SAAO;GACL;GACA,SAAS;IACP;KAAE,MAAM;KAAY,MAAM;KAAU;IACpC;KAAE,MAAM;KAAS,MAAM;KAAU;IACjC;KAAE,MAAM;KAAU,MAAM;KAAU;IACnC;GACD,UAAU,KAAK;GACf,iBAAiB;GACjB,QAAQ;GACT;;CAGH,MAAc,WACZ,MACA,SACsB;AAEtB,SAAO;GACL,MAAM,EAAE;GACR,SAAS,EAAE;GACX,UAAU;GACV,iBAAiB;GACjB,QAAQ;GACR,OAAO;GACR;;CAGH,AAAQ,iBACN,aACA,QAC2B;EAC3B,MAAMC,OAAkC,EAAE;EAC1C,MAAM,WAAW;EAGjB,MAAM,gBAAgB,YAAY,WAAW,MAAM,MAAM,EAAE,SAAS,OAAO;AAE3E,OAAK,IAAI,IAAI,GAAG,IAAI,UAAU,KAAK;GACjC,MAAMC,MAA+B,EAAE;AAEvC,QAAK,MAAM,OAAO,YAAY,WAC5B,KAAI,IAAI,SAAS,QAAQ;IACvB,MAAM,OAAO,IAAI,KAAK,OAAO,WAAW,yBAAS,IAAI,MAAM,CAAC;AAC5D,SAAK,QAAQ,KAAK,SAAS,GAAG,EAAE;AAChC,QAAI,IAAI,QAAQ,KAAK,aAAa,CAAC,MAAM,IAAI,CAAC;SAE9C,KAAI,IAAI,QAAQ,GAAG,IAAI,KAAK,GAAG,IAAI;AAIvC,QAAK,MAAM,WAAW,YAAY,UAAU;IAC1C,MAAM,YAAY,gBAAgB,MAAM,IAAI,KAAK,KAAK,QAAQ,GAAG;IACjE,MAAM,SAAS,KAAK,QAAQ,GAAG,MAAO;AACtC,QAAI,QAAQ,QAAQ,KAAK,OAAO,YAAY,SAAS,IAAI,GAAG;;AAG9D,QAAK,KAAK,IAAI;;AAGhB,SAAO;;;AAMX,SAAgB,kBAAkB,OAAmC;AACnE,QAAO,IAAI,iBAAiB,MAAM"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/query-engine/index.ts"],"sourcesContent":["/**\n * Analytics Query Engine\n *\n * Provides query execution and caching for analytics dashboards.\n */\n\n// ============ Types ============\n\nexport interface QueryDefinition {\n  type: 'SQL' | 'METRIC' | 'AGGREGATION' | 'CUSTOM';\n  sql?: string;\n  metricIds?: string[];\n  aggregation?: AggregationDefinition;\n  custom?: CustomQueryDefinition;\n}\n\nexport interface AggregationDefinition {\n  source: string;\n  measures: MeasureDefinition[];\n  dimensions: DimensionDefinition[];\n  filters?: FilterDefinition[];\n  orderBy?: OrderByDefinition[];\n  limit?: number;\n}\n\nexport interface MeasureDefinition {\n  name: string;\n  field: string;\n  aggregation: 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX' | 'COUNT_DISTINCT';\n  format?: string;\n}\n\nexport interface DimensionDefinition {\n  name: string;\n  field: string;\n  type?: 'TIME' | 'STRING' | 'NUMBER';\n  granularity?: 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR';\n}\n\nexport interface FilterDefinition {\n  field: string;\n  operator:\n    | 'eq'\n    | 'neq'\n    | 'gt'\n    | 'gte'\n    | 'lt'\n    | 'lte'\n    | 'in'\n    | 'nin'\n    | 'contains'\n    | 'between';\n  value: unknown;\n}\n\nexport interface OrderByDefinition {\n  field: string;\n  direction: 'ASC' | 'DESC';\n}\n\nexport interface CustomQueryDefinition {\n  handler: string;\n  parameters: Record<string, unknown>;\n}\n\nexport interface QueryParameters {\n  dateRange?: {\n    start: Date;\n    end: Date;\n    granularity?: string;\n  };\n  filters?: FilterDefinition[];\n  parameters?: Record<string, unknown>;\n}\n\nexport interface QueryResult {\n  data: Record<string, unknown>[];\n  columns: ColumnDefinition[];\n  rowCount: number;\n  executionTimeMs: number;\n  cached: boolean;\n  cachedAt?: Date;\n  error?: string;\n}\n\nexport interface ColumnDefinition {\n  name: string;\n  type: 'STRING' | 'NUMBER' | 'DATE' | 'BOOLEAN';\n  label?: string;\n  format?: string;\n}\n\n// ============ Query Engine Interface ============\n\nexport interface IQueryEngine {\n  execute(\n    definition: QueryDefinition,\n    params: QueryParameters\n  ): Promise<QueryResult>;\n  validateQuery(definition: QueryDefinition): {\n    valid: boolean;\n    errors: string[];\n  };\n}\n\n// ============ Query Cache ============\n\nexport interface IQueryCache {\n  get(key: string): Promise<QueryResult | null>;\n  set(key: string, result: QueryResult, ttlSeconds: number): Promise<void>;\n  invalidate(pattern: string): Promise<void>;\n}\n\nexport class InMemoryQueryCache implements IQueryCache {\n  private cache = new Map<string, { result: QueryResult; expiresAt: Date }>();\n\n  async get(key: string): Promise<QueryResult | null> {\n    const entry = this.cache.get(key);\n    if (!entry) return null;\n    if (entry.expiresAt < new Date()) {\n      this.cache.delete(key);\n      return null;\n    }\n    return { ...entry.result, cached: true, cachedAt: entry.expiresAt };\n  }\n\n  async set(\n    key: string,\n    result: QueryResult,\n    ttlSeconds: number\n  ): Promise<void> {\n    const expiresAt = new Date(Date.now() + ttlSeconds * 1000);\n    this.cache.set(key, { result, expiresAt });\n  }\n\n  async invalidate(pattern: string): Promise<void> {\n    const regex = new RegExp(pattern);\n    for (const key of this.cache.keys()) {\n      if (regex.test(key)) {\n        this.cache.delete(key);\n      }\n    }\n  }\n}\n\n// ============ Basic Query Engine ============\n\nexport class BasicQueryEngine implements IQueryEngine {\n  private cache: IQueryCache;\n\n  constructor(cache?: IQueryCache) {\n    this.cache = cache ?? new InMemoryQueryCache();\n  }\n\n  async execute(\n    definition: QueryDefinition,\n    params: QueryParameters\n  ): Promise<QueryResult> {\n    const startTime = Date.now();\n\n    // Validate query\n    const validation = this.validateQuery(definition);\n    if (!validation.valid) {\n      return {\n        data: [],\n        columns: [],\n        rowCount: 0,\n        executionTimeMs: Date.now() - startTime,\n        cached: false,\n        error: validation.errors.join(', '),\n      };\n    }\n\n    // Check cache\n    const cacheKey = this.buildCacheKey(definition, params);\n    const cachedResult = await this.cache.get(cacheKey);\n    if (cachedResult) {\n      return cachedResult;\n    }\n\n    // Execute query based on type\n    let result: QueryResult;\n    switch (definition.type) {\n      case 'AGGREGATION':\n        if (!definition.aggregation) {\n          throw new Error('Aggregation definition is missing');\n        }\n        result = await this.executeAggregation(definition.aggregation, params);\n        break;\n      case 'METRIC':\n        if (!definition.metricIds) {\n          throw new Error('Metric IDs are missing');\n        }\n        result = await this.executeMetric(definition.metricIds, params);\n        break;\n      case 'SQL':\n        if (!definition.sql) {\n          throw new Error('SQL query is missing');\n        }\n        result = await this.executeSql(definition.sql, params);\n        break;\n      default:\n        result = {\n          data: [],\n          columns: [],\n          rowCount: 0,\n          executionTimeMs: Date.now() - startTime,\n          cached: false,\n          error: `Unknown query type: ${definition.type}`,\n        };\n    }\n\n    result.executionTimeMs = Date.now() - startTime;\n    result.cached = false;\n\n    // Cache result\n    await this.cache.set(cacheKey, result, 300);\n\n    return result;\n  }\n\n  validateQuery(definition: QueryDefinition): {\n    valid: boolean;\n    errors: string[];\n  } {\n    const errors: string[] = [];\n\n    if (!definition.type) {\n      errors.push('Query type is required');\n    }\n\n    switch (definition.type) {\n      case 'SQL':\n        if (!definition.sql) {\n          errors.push('SQL query is required for SQL type');\n        }\n        break;\n      case 'METRIC':\n        if (!definition.metricIds || definition.metricIds.length === 0) {\n          errors.push('Metric IDs are required for METRIC type');\n        }\n        break;\n      case 'AGGREGATION':\n        if (!definition.aggregation) {\n          errors.push(\n            'Aggregation definition is required for AGGREGATION type'\n          );\n        } else {\n          if (!definition.aggregation.source) {\n            errors.push('Aggregation source is required');\n          }\n          if (\n            !definition.aggregation.measures ||\n            definition.aggregation.measures.length === 0\n          ) {\n            errors.push('At least one measure is required');\n          }\n        }\n        break;\n    }\n\n    return { valid: errors.length === 0, errors };\n  }\n\n  private buildCacheKey(\n    definition: QueryDefinition,\n    params: QueryParameters\n  ): string {\n    return JSON.stringify({ definition, params });\n  }\n\n  private async executeAggregation(\n    aggregation: AggregationDefinition,\n    params: QueryParameters\n  ): Promise<QueryResult> {\n    // In production, this would execute against a data warehouse\n    // For demo, return mock data\n    const columns: ColumnDefinition[] = [\n      ...aggregation.dimensions.map((d) => ({\n        name: d.name,\n        type: (d.type === 'NUMBER'\n          ? 'NUMBER'\n          : d.type === 'TIME'\n            ? 'DATE'\n            : 'STRING') as ColumnDefinition['type'],\n        label: d.name,\n      })),\n      ...aggregation.measures.map((m) => ({\n        name: m.name,\n        type: 'NUMBER' as const,\n        label: m.name,\n        format: m.format,\n      })),\n    ];\n\n    // Mock data generation\n    const data = this.generateMockData(aggregation, params);\n\n    return {\n      data,\n      columns,\n      rowCount: data.length,\n      executionTimeMs: 0,\n      cached: false,\n    };\n  }\n\n  private async executeMetric(\n    metricIds: string[],\n    _params: QueryParameters\n  ): Promise<QueryResult> {\n    // In production, this would fetch from metering service\n    const data = metricIds.map((id) => ({\n      metricId: id,\n      value: Math.random() * 1000,\n      change: (Math.random() - 0.5) * 20,\n    }));\n\n    return {\n      data,\n      columns: [\n        { name: 'metricId', type: 'STRING' },\n        { name: 'value', type: 'NUMBER' },\n        { name: 'change', type: 'NUMBER' },\n      ],\n      rowCount: data.length,\n      executionTimeMs: 0,\n      cached: false,\n    };\n  }\n\n  private async executeSql(\n    _sql: string,\n    _params: QueryParameters\n  ): Promise<QueryResult> {\n    // In production, this would execute SQL against a database\n    return {\n      data: [],\n      columns: [],\n      rowCount: 0,\n      executionTimeMs: 0,\n      cached: false,\n      error: 'SQL execution not implemented in demo',\n    };\n  }\n\n  private generateMockData(\n    aggregation: AggregationDefinition,\n    params: QueryParameters\n  ): Record<string, unknown>[] {\n    const data: Record<string, unknown>[] = [];\n    const rowCount = 10;\n\n    // Generate time series data if there's a time dimension\n    const timeDimension = aggregation.dimensions.find((d) => d.type === 'TIME');\n\n    for (let i = 0; i < rowCount; i++) {\n      const row: Record<string, unknown> = {};\n\n      for (const dim of aggregation.dimensions) {\n        if (dim.type === 'TIME') {\n          const date = new Date(params.dateRange?.start ?? new Date());\n          date.setDate(date.getDate() + i);\n          row[dim.name] = date.toISOString().split('T')[0];\n        } else {\n          row[dim.name] = `${dim.name}_${i % 5}`;\n        }\n      }\n\n      for (const measure of aggregation.measures) {\n        const baseValue = timeDimension ? 100 + i * 10 : Math.random() * 1000;\n        const noise = (Math.random() - 0.5) * 20;\n        row[measure.name] = Math.round((baseValue + noise) * 100) / 100;\n      }\n\n      data.push(row);\n    }\n\n    return data;\n  }\n}\n\n// ============ Factory ============\n\nexport function createQueryEngine(cache?: IQueryCache): IQueryEngine {\n  return new BasicQueryEngine(cache);\n}\n"],"mappings":"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"}

package/dist/seeders/index.d.ts

@@ -0,0 +1,10 @@
+import { DatabasePort } from "@contractspec/lib.runtime-sandbox";
+
+//#region src/seeders/index.d.ts
+declare function seedAnalyticsDashboard(params: {
+  projectId: string;
+  db: DatabasePort;
+}): Promise<void>;
+//#endregion
+export { seedAnalyticsDashboard };
+//# sourceMappingURL=index.d.ts.map

package/dist/seeders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/seeders/index.ts"],"sourcesContent":[],"mappings":";;;iBAEsB,sBAAA;;EAAA,EAAA,EAEhB,YAFgB;IAGrB"}

package/dist/seeders/index.js

@@ -0,0 +1,19 @@
+//#region src/seeders/index.ts
+async function seedAnalyticsDashboard(params) {
+	const { projectId, db } = params;
+	if ((await db.query(`SELECT COUNT(*) as count FROM analytics_dashboard WHERE "projectId" = $1`, [projectId])).rows[0]?.count > 0) return;
+	await db.execute(`INSERT INTO analytics_dashboard (id, "projectId", "organizationId", name, slug, description, status)
+     VALUES ($1, $2, $3, $4, $5, $6, $7)`, [
+		"dash_1",
+		projectId,
+		"org_demo",
+		"Sales Overview",
+		"sales-overview",
+		"Sales performance dashboard",
+		"PUBLISHED"
+	]);
+}
+
+//#endregion
+export { seedAnalyticsDashboard };
+//# sourceMappingURL=index.js.map

package/dist/seeders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/seeders/index.ts"],"sourcesContent":["import type { DatabasePort } from '@contractspec/lib.runtime-sandbox';\n\nexport async function seedAnalyticsDashboard(params: {\n  projectId: string;\n  db: DatabasePort;\n}) {\n  const { projectId, db } = params;\n\n  const existing = await db.query(\n    `SELECT COUNT(*) as count FROM analytics_dashboard WHERE \"projectId\" = $1`,\n    [projectId]\n  );\n  if ((existing.rows[0]?.count as number) > 0) return;\n\n  await db.execute(\n    `INSERT INTO analytics_dashboard (id, \"projectId\", \"organizationId\", name, slug, description, status)\n     VALUES ($1, $2, $3, $4, $5, $6, $7)`,\n    [\n      'dash_1',\n      projectId,\n      'org_demo',\n      'Sales Overview',\n      'sales-overview',\n      'Sales performance dashboard',\n      'PUBLISHED',\n    ]\n  );\n}\n"],"mappings":";AAEA,eAAsB,uBAAuB,QAG1C;CACD,MAAM,EAAE,WAAW,OAAO;AAM1B,MAJiB,MAAM,GAAG,MACxB,4EACA,CAAC,UAAU,CACZ,EACa,KAAK,IAAI,QAAmB,EAAG;AAE7C,OAAM,GAAG,QACP;2CAEA;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CACF"}

package/dist/ui/AnalyticsDashboard.d.ts

@@ -0,0 +1,7 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/ui/AnalyticsDashboard.d.ts
+declare function AnalyticsDashboard(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { AnalyticsDashboard };
+//# sourceMappingURL=AnalyticsDashboard.d.ts.map

package/dist/ui/AnalyticsDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsDashboard.d.ts","names":[],"sources":["../../src/ui/AnalyticsDashboard.tsx"],"sourcesContent":[],"mappings":";;;iBAoDgB,kBAAA,CAAA,GAAkB,kBAAA,CAAA,GAAA,CAAA"}

package/dist/ui/AnalyticsDashboard.js

@@ -0,0 +1,265 @@
+'use client';
+
+import { useAnalyticsData } from "./hooks/useAnalyticsData.js";
+import { useState } from "react";
+import { Button, ErrorState, LoaderBlock, StatCard, StatCardGroup } from "@contractspec/lib.design-system";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/ui/AnalyticsDashboard.tsx
+/**
+* Analytics Dashboard
+*
+* Interactive dashboard for the analytics-dashboard template.
+* Displays dashboards, widgets, and queries.
+*/
+const STATUS_COLORS = {
+	PUBLISHED: "bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400",
+	DRAFT: "bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400",
+	ARCHIVED: "bg-yellow-100 text-yellow-700 dark:bg-yellow-900/30 dark:text-yellow-400"
+};
+const WIDGET_ICONS = {
+	LINE_CHART: "📈",
+	BAR_CHART: "📊",
+	PIE_CHART: "🥧",
+	AREA_CHART: "📉",
+	SCATTER_PLOT: "⚬",
+	METRIC: "🔢",
+	TABLE: "📋",
+	HEATMAP: "🗺️",
+	FUNNEL: "⏬",
+	MAP: "🌍",
+	TEXT: "📝",
+	EMBED: "🔗"
+};
+const QUERY_TYPE_COLORS = {
+	SQL: "bg-blue-100 text-blue-700 dark:bg-blue-900/30 dark:text-blue-400",
+	METRIC: "bg-purple-100 text-purple-700 dark:bg-purple-900/30 dark:text-purple-400",
+	AGGREGATION: "bg-indigo-100 text-indigo-700 dark:bg-indigo-900/30 dark:text-indigo-400",
+	CUSTOM: "bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400"
+};
+function AnalyticsDashboard() {
+	const [activeTab, setActiveTab] = useState("dashboards");
+	const { dashboards, queries, selectedDashboard, widgets, loading, error, stats, refetch, selectDashboard } = useAnalyticsData();
+	const tabs = [{
+		id: "dashboards",
+		label: "Dashboards",
+		icon: "📊"
+	}, {
+		id: "queries",
+		label: "Queries",
+		icon: "🔍"
+	}];
+	if (loading) return /* @__PURE__ */ jsx(LoaderBlock, { label: "Loading Analytics..." });
+	if (error) return /* @__PURE__ */ jsx(ErrorState, {
+		title: "Failed to load Analytics",
+		description: error.message,
+		onRetry: refetch,
+		retryLabel: "Retry"
+	});
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-6",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center justify-between",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Analytics Dashboard"
+				}), /* @__PURE__ */ jsxs(Button, {
+					onClick: () => alert("Create dashboard modal"),
+					children: [/* @__PURE__ */ jsx("span", {
+						className: "mr-2",
+						children: "+"
+					}), " New Dashboard"]
+				})]
+			}),
+			/* @__PURE__ */ jsxs(StatCardGroup, { children: [
+				/* @__PURE__ */ jsx(StatCard, {
+					label: "Dashboards",
+					value: stats.totalDashboards,
+					hint: `${stats.publishedDashboards} published`
+				}),
+				/* @__PURE__ */ jsx(StatCard, {
+					label: "Queries",
+					value: stats.totalQueries,
+					hint: `${stats.sharedQueries} shared`
+				}),
+				/* @__PURE__ */ jsx(StatCard, {
+					label: "Widgets",
+					value: widgets.length,
+					hint: "on current dashboard"
+				})
+			] }),
+			/* @__PURE__ */ jsx("nav", {
+				className: "bg-muted flex gap-1 rounded-lg p-1",
+				role: "tablist",
+				children: tabs.map((tab) => /* @__PURE__ */ jsxs(Button, {
+					type: "button",
+					role: "tab",
+					"aria-selected": activeTab === tab.id,
+					onClick: () => setActiveTab(tab.id),
+					className: `flex flex-1 items-center justify-center gap-2 rounded-md px-4 py-2 text-sm font-medium transition-colors ${activeTab === tab.id ? "bg-background text-foreground shadow-sm" : "text-muted-foreground hover:text-foreground"}`,
+					children: [/* @__PURE__ */ jsx("span", { children: tab.icon }), tab.label]
+				}, tab.id))
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "min-h-[400px]",
+				role: "tabpanel",
+				children: [activeTab === "dashboards" && /* @__PURE__ */ jsxs("div", {
+					className: "space-y-6",
+					children: [/* @__PURE__ */ jsxs("div", {
+						className: "grid gap-4 sm:grid-cols-2 lg:grid-cols-3",
+						children: [dashboards.map((dashboard) => /* @__PURE__ */ jsxs("div", {
+							onClick: () => selectDashboard(dashboard),
+							className: `border-border bg-card cursor-pointer rounded-lg border p-4 transition-all ${selectedDashboard?.id === dashboard.id ? "ring-primary ring-2" : "hover:bg-muted/50"}`,
+							role: "button",
+							tabIndex: 0,
+							onKeyDown: (e) => {
+								if (e.key === "Enter" || e.key === " ") selectDashboard(dashboard);
+							},
+							children: [
+								/* @__PURE__ */ jsxs("div", {
+									className: "mb-2 flex items-center justify-between",
+									children: [/* @__PURE__ */ jsx("h3", {
+										className: "font-medium",
+										children: dashboard.name
+									}), /* @__PURE__ */ jsx("span", {
+										className: `inline-flex rounded-full px-2 py-0.5 text-xs font-medium ${STATUS_COLORS[dashboard.status] ?? ""}`,
+										children: dashboard.status
+									})]
+								}),
+								/* @__PURE__ */ jsx("p", {
+									className: "text-muted-foreground mb-3 text-sm",
+									children: dashboard.description
+								}),
+								/* @__PURE__ */ jsxs("div", {
+									className: "text-muted-foreground flex items-center justify-between text-xs",
+									children: [/* @__PURE__ */ jsxs("span", { children: ["/", dashboard.slug] }), dashboard.isPublic && /* @__PURE__ */ jsx("span", {
+										className: "text-green-600 dark:text-green-400",
+										children: "🌐 Public"
+									})]
+								})
+							]
+						}, dashboard.id)), dashboards.length === 0 && /* @__PURE__ */ jsx("div", {
+							className: "text-muted-foreground col-span-full flex h-64 items-center justify-center",
+							children: "No dashboards created yet"
+						})]
+					}), selectedDashboard && widgets.length > 0 && /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsxs("h3", {
+						className: "mb-4 text-lg font-semibold",
+						children: [
+							"Widgets in \"",
+							selectedDashboard.name,
+							"\""
+						]
+					}), /* @__PURE__ */ jsx("div", {
+						className: "grid gap-4 sm:grid-cols-2 lg:grid-cols-3",
+						children: widgets.map((widget) => /* @__PURE__ */ jsxs("div", {
+							className: "border-border bg-card rounded-lg border p-4",
+							children: [
+								/* @__PURE__ */ jsxs("div", {
+									className: "mb-2 flex items-center gap-2",
+									children: [/* @__PURE__ */ jsx("span", {
+										className: "text-xl",
+										children: WIDGET_ICONS[widget.type] ?? "📊"
+									}), /* @__PURE__ */ jsx("span", {
+										className: "font-medium",
+										children: widget.name
+									})]
+								}),
+								/* @__PURE__ */ jsx("div", {
+									className: "text-muted-foreground text-sm",
+									children: widget.type.replace(/_/g, " ")
+								}),
+								/* @__PURE__ */ jsxs("div", {
+									className: "text-muted-foreground mt-2 text-xs",
+									children: [
+										"Position: (",
+										widget.gridX,
+										", ",
+										widget.gridY,
+										") •",
+										" ",
+										widget.gridWidth,
+										"x",
+										widget.gridHeight
+									]
+								})
+							]
+						}, widget.id))
+					})] })]
+				}), activeTab === "queries" && /* @__PURE__ */ jsx("div", {
+					className: "border-border rounded-lg border",
+					children: /* @__PURE__ */ jsxs("table", {
+						className: "w-full",
+						children: [/* @__PURE__ */ jsx("thead", {
+							className: "border-border bg-muted/30 border-b",
+							children: /* @__PURE__ */ jsxs("tr", { children: [
+								/* @__PURE__ */ jsx("th", {
+									className: "px-4 py-3 text-left text-sm font-medium",
+									children: "Query"
+								}),
+								/* @__PURE__ */ jsx("th", {
+									className: "px-4 py-3 text-left text-sm font-medium",
+									children: "Type"
+								}),
+								/* @__PURE__ */ jsx("th", {
+									className: "px-4 py-3 text-left text-sm font-medium",
+									children: "Cache TTL"
+								}),
+								/* @__PURE__ */ jsx("th", {
+									className: "px-4 py-3 text-left text-sm font-medium",
+									children: "Shared"
+								})
+							] })
+						}), /* @__PURE__ */ jsxs("tbody", {
+							className: "divide-border divide-y",
+							children: [queries.map((query) => /* @__PURE__ */ jsxs("tr", {
+								className: "hover:bg-muted/50",
+								children: [
+									/* @__PURE__ */ jsxs("td", {
+										className: "px-4 py-3",
+										children: [/* @__PURE__ */ jsx("div", {
+											className: "font-medium",
+											children: query.name
+										}), /* @__PURE__ */ jsx("div", {
+											className: "text-muted-foreground text-sm",
+											children: query.description
+										})]
+									}),
+									/* @__PURE__ */ jsx("td", {
+										className: "px-4 py-3",
+										children: /* @__PURE__ */ jsx("span", {
+											className: `inline-flex rounded-full px-2 py-0.5 text-xs font-medium ${QUERY_TYPE_COLORS[query.type] ?? ""}`,
+											children: query.type
+										})
+									}),
+									/* @__PURE__ */ jsxs("td", {
+										className: "text-muted-foreground px-4 py-3 text-sm",
+										children: [query.cacheTtlSeconds, "s"]
+									}),
+									/* @__PURE__ */ jsx("td", {
+										className: "px-4 py-3",
+										children: query.isShared ? /* @__PURE__ */ jsx("span", {
+											className: "text-green-600 dark:text-green-400",
+											children: "✓"
+										}) : /* @__PURE__ */ jsx("span", {
+											className: "text-muted-foreground",
+											children: "—"
+										})
+									})
+								]
+							}, query.id)), queries.length === 0 && /* @__PURE__ */ jsx("tr", { children: /* @__PURE__ */ jsx("td", {
+								colSpan: 4,
+								className: "text-muted-foreground px-4 py-8 text-center",
+								children: "No queries saved"
+							}) })]
+						})]
+					})
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { AnalyticsDashboard };
+//# sourceMappingURL=AnalyticsDashboard.js.map

package/dist/ui/AnalyticsDashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsDashboard.js","names":[],"sources":["../../src/ui/AnalyticsDashboard.tsx"],"sourcesContent":["'use client';\n\n/**\n * Analytics Dashboard\n *\n * Interactive dashboard for the analytics-dashboard template.\n * Displays dashboards, widgets, and queries.\n */\nimport { useState } from 'react';\nimport {\n  Button,\n  ErrorState,\n  LoaderBlock,\n  StatCard,\n  StatCardGroup,\n} from '@contractspec/lib.design-system';\nimport { useAnalyticsData } from './hooks/useAnalyticsData';\n\ntype Tab = 'dashboards' | 'queries';\n\nconst STATUS_COLORS: Record<string, string> = {\n  PUBLISHED:\n    'bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400',\n  DRAFT: 'bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400',\n  ARCHIVED:\n    'bg-yellow-100 text-yellow-700 dark:bg-yellow-900/30 dark:text-yellow-400',\n};\n\nconst WIDGET_ICONS: Record<string, string> = {\n  LINE_CHART: '📈',\n  BAR_CHART: '📊',\n  PIE_CHART: '🥧',\n  AREA_CHART: '📉',\n  SCATTER_PLOT: '⚬',\n  METRIC: '🔢',\n  TABLE: '📋',\n  HEATMAP: '🗺️',\n  FUNNEL: '⏬',\n  MAP: '🌍',\n  TEXT: '📝',\n  EMBED: '🔗',\n};\n\nconst QUERY_TYPE_COLORS: Record<string, string> = {\n  SQL: 'bg-blue-100 text-blue-700 dark:bg-blue-900/30 dark:text-blue-400',\n  METRIC:\n    'bg-purple-100 text-purple-700 dark:bg-purple-900/30 dark:text-purple-400',\n  AGGREGATION:\n    'bg-indigo-100 text-indigo-700 dark:bg-indigo-900/30 dark:text-indigo-400',\n  CUSTOM: 'bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400',\n};\n\nexport function AnalyticsDashboard() {\n  const [activeTab, setActiveTab] = useState<Tab>('dashboards');\n  const {\n    dashboards,\n    queries,\n    selectedDashboard,\n    widgets,\n    loading,\n    error,\n    stats,\n    refetch,\n    selectDashboard,\n  } = useAnalyticsData();\n\n  const tabs: { id: Tab; label: string; icon: string }[] = [\n    { id: 'dashboards', label: 'Dashboards', icon: '📊' },\n    { id: 'queries', label: 'Queries', icon: '🔍' },\n  ];\n\n  if (loading) {\n    return <LoaderBlock label=\"Loading Analytics...\" />;\n  }\n\n  if (error) {\n    return (\n      <ErrorState\n        title=\"Failed to load Analytics\"\n        description={error.message}\n        onRetry={refetch}\n        retryLabel=\"Retry\"\n      />\n    );\n  }\n\n  return (\n    <div className=\"space-y-6\">\n      {/* Header */}\n      <div className=\"flex items-center justify-between\">\n        <h2 className=\"text-2xl font-bold\">Analytics Dashboard</h2>\n        <Button onClick={() => alert('Create dashboard modal')}>\n          <span className=\"mr-2\">+</span> New Dashboard\n        </Button>\n      </div>\n\n      {/* Stats Row */}\n      <StatCardGroup>\n        <StatCard\n          label=\"Dashboards\"\n          value={stats.totalDashboards}\n          hint={`${stats.publishedDashboards} published`}\n        />\n        <StatCard\n          label=\"Queries\"\n          value={stats.totalQueries}\n          hint={`${stats.sharedQueries} shared`}\n        />\n        <StatCard\n          label=\"Widgets\"\n          value={widgets.length}\n          hint=\"on current dashboard\"\n        />\n      </StatCardGroup>\n\n      {/* Navigation Tabs */}\n      <nav className=\"bg-muted flex gap-1 rounded-lg p-1\" role=\"tablist\">\n        {tabs.map((tab) => (\n          <Button\n            key={tab.id}\n            type=\"button\"\n            role=\"tab\"\n            aria-selected={activeTab === tab.id}\n            onClick={() => setActiveTab(tab.id)}\n            className={`flex flex-1 items-center justify-center gap-2 rounded-md px-4 py-2 text-sm font-medium transition-colors ${\n              activeTab === tab.id\n                ? 'bg-background text-foreground shadow-sm'\n                : 'text-muted-foreground hover:text-foreground'\n            }`}\n          >\n            <span>{tab.icon}</span>\n            {tab.label}\n          </Button>\n        ))}\n      </nav>\n\n      {/* Tab Content */}\n      <div className=\"min-h-[400px]\" role=\"tabpanel\">\n        {activeTab === 'dashboards' && (\n          <div className=\"space-y-6\">\n            {/* Dashboard List */}\n            <div className=\"grid gap-4 sm:grid-cols-2 lg:grid-cols-3\">\n              {dashboards.map((dashboard) => (\n                <div\n                  key={dashboard.id}\n                  onClick={() => selectDashboard(dashboard)}\n                  className={`border-border bg-card cursor-pointer rounded-lg border p-4 transition-all ${\n                    selectedDashboard?.id === dashboard.id\n                      ? 'ring-primary ring-2'\n                      : 'hover:bg-muted/50'\n                  }`}\n                  role=\"button\"\n                  tabIndex={0}\n                  onKeyDown={(e) => {\n                    if (e.key === 'Enter' || e.key === ' ')\n                      selectDashboard(dashboard);\n                  }}\n                >\n                  <div className=\"mb-2 flex items-center justify-between\">\n                    <h3 className=\"font-medium\">{dashboard.name}</h3>\n                    <span\n                      className={`inline-flex rounded-full px-2 py-0.5 text-xs font-medium ${STATUS_COLORS[dashboard.status] ?? ''}`}\n                    >\n                      {dashboard.status}\n                    </span>\n                  </div>\n                  <p className=\"text-muted-foreground mb-3 text-sm\">\n                    {dashboard.description}\n                  </p>\n                  <div className=\"text-muted-foreground flex items-center justify-between text-xs\">\n                    <span>/{dashboard.slug}</span>\n                    {dashboard.isPublic && (\n                      <span className=\"text-green-600 dark:text-green-400\">\n                        🌐 Public\n                      </span>\n                    )}\n                  </div>\n                </div>\n              ))}\n              {dashboards.length === 0 && (\n                <div className=\"text-muted-foreground col-span-full flex h-64 items-center justify-center\">\n                  No dashboards created yet\n                </div>\n              )}\n            </div>\n\n            {/* Widget Grid for Selected Dashboard */}\n            {selectedDashboard && widgets.length > 0 && (\n              <div>\n                <h3 className=\"mb-4 text-lg font-semibold\">\n                  Widgets in \"{selectedDashboard.name}\"\n                </h3>\n                <div className=\"grid gap-4 sm:grid-cols-2 lg:grid-cols-3\">\n                  {widgets.map((widget) => (\n                    <div\n                      key={widget.id}\n                      className=\"border-border bg-card rounded-lg border p-4\"\n                    >\n                      <div className=\"mb-2 flex items-center gap-2\">\n                        <span className=\"text-xl\">\n                          {WIDGET_ICONS[widget.type] ?? '📊'}\n                        </span>\n                        <span className=\"font-medium\">{widget.name}</span>\n                      </div>\n                      <div className=\"text-muted-foreground text-sm\">\n                        {widget.type.replace(/_/g, ' ')}\n                      </div>\n                      <div className=\"text-muted-foreground mt-2 text-xs\">\n                        Position: ({widget.gridX}, {widget.gridY}) •{' '}\n                        {widget.gridWidth}x{widget.gridHeight}\n                      </div>\n                    </div>\n                  ))}\n                </div>\n              </div>\n            )}\n          </div>\n        )}\n\n        {activeTab === 'queries' && (\n          <div className=\"border-border rounded-lg border\">\n            <table className=\"w-full\">\n              <thead className=\"border-border bg-muted/30 border-b\">\n                <tr>\n                  <th className=\"px-4 py-3 text-left text-sm font-medium\">\n                    Query\n                  </th>\n                  <th className=\"px-4 py-3 text-left text-sm font-medium\">\n                    Type\n                  </th>\n                  <th className=\"px-4 py-3 text-left text-sm font-medium\">\n                    Cache TTL\n                  </th>\n                  <th className=\"px-4 py-3 text-left text-sm font-medium\">\n                    Shared\n                  </th>\n                </tr>\n              </thead>\n              <tbody className=\"divide-border divide-y\">\n                {queries.map((query) => (\n                  <tr key={query.id} className=\"hover:bg-muted/50\">\n                    <td className=\"px-4 py-3\">\n                      <div className=\"font-medium\">{query.name}</div>\n                      <div className=\"text-muted-foreground text-sm\">\n                        {query.description}\n                      </div>\n                    </td>\n                    <td className=\"px-4 py-3\">\n                      <span\n                        className={`inline-flex rounded-full px-2 py-0.5 text-xs font-medium ${QUERY_TYPE_COLORS[query.type] ?? ''}`}\n                      >\n                        {query.type}\n                      </span>\n                    </td>\n                    <td className=\"text-muted-foreground px-4 py-3 text-sm\">\n                      {query.cacheTtlSeconds}s\n                    </td>\n                    <td className=\"px-4 py-3\">\n                      {query.isShared ? (\n                        <span className=\"text-green-600 dark:text-green-400\">\n                          ✓\n                        </span>\n                      ) : (\n                        <span className=\"text-muted-foreground\">—</span>\n                      )}\n                    </td>\n                  </tr>\n                ))}\n                {queries.length === 0 && (\n                  <tr>\n                    <td\n                      colSpan={4}\n                      className=\"text-muted-foreground px-4 py-8 text-center\"\n                    >\n                      No queries saved\n                    </td>\n                  </tr>\n                )}\n              </tbody>\n            </table>\n          </div>\n        )}\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/ui/hooks/index.d.ts

@@ -0,0 +1,2 @@
+import { AnalyticsStats, useAnalyticsData } from "./useAnalyticsData.js";
+export { type AnalyticsStats, useAnalyticsData };

package/dist/ui/hooks/index.js

@@ -0,0 +1,5 @@
+'use client';
+
+import { useAnalyticsData } from "./useAnalyticsData.js";
+
+export { useAnalyticsData };

package/dist/ui/hooks/useAnalyticsData.d.ts

@@ -0,0 +1,23 @@
+import { Dashboard, Query, Widget } from "../../handlers/analytics.handlers.js";
+
+//#region src/ui/hooks/useAnalyticsData.d.ts
+interface AnalyticsStats {
+  totalDashboards: number;
+  publishedDashboards: number;
+  totalQueries: number;
+  sharedQueries: number;
+}
+declare function useAnalyticsData(projectId?: string): {
+  dashboards: Dashboard[];
+  queries: Query[];
+  selectedDashboard: Dashboard | null;
+  widgets: Widget[];
+  loading: boolean;
+  error: Error | null;
+  stats: AnalyticsStats;
+  refetch: () => Promise<void>;
+  selectDashboard: (dashboard: Dashboard) => Promise<void>;
+};
+//#endregion
+export { AnalyticsStats, useAnalyticsData };
+//# sourceMappingURL=useAnalyticsData.d.ts.map

package/dist/ui/hooks/useAnalyticsData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalyticsData.d.ts","names":[],"sources":["../../../src/ui/hooks/useAnalyticsData.ts"],"sourcesContent":[],"mappings":";;;UAWiB,cAAA;;EAAA,mBAAc,EAAA,MAAA;EAOf,YAAA,EAAA,MAAgB;;;iBAAhB,gBAAA;;;;;EAgDM,OAAA,EAAA,OAAA;EAAS,KAAA,OAAA,GAAA,IAAA;EAAA,KAAA,gBAAA;;+BAAT,cAAS"}