@lssm/example.analytics-dashboard 0.0.0-canary-20251217054315 → 0.0.0-canary-20251217060804

package/dist/query/query.contracts.d.ts

@@ -0,0 +1,177 @@
+import * as _lssm_lib_schema131 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts3 from "@lssm/lib.contracts";
+
+//#region src/query/query.contracts.d.ts
+/**
+ * Create a data query.
+ */
+declare const CreateQueryContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema131.SchemaModel<{
+  name: {
+    type: _lssm_lib_schema131.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _lssm_lib_schema131.FieldType<string, string>;
+    isOptional: true;
+  };
+  type: {
+    type: _lssm_lib_schema131.EnumType<[string, string, string, string]>;
+    isOptional: false;
+  };
+  definition: {
+    type: _lssm_lib_schema131.FieldType<unknown, unknown>;
+    isOptional: false;
+  };
+  sql: {
+    type: _lssm_lib_schema131.FieldType<string, string>;
+    isOptional: true;
+  };
+  metricIds: {
+    type: _lssm_lib_schema131.FieldType<string, string>;
+    isArray: true;
+    isOptional: true;
+  };
+  cacheTtlSeconds: {
+    type: _lssm_lib_schema131.FieldType<number, number>;
+    isOptional: true;
+  };
+  isShared: {
+    type: _lssm_lib_schema131.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+}>, _lssm_lib_schema131.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema131.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema131.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _lssm_lib_schema131.FieldType<string, string>;
+    isOptional: true;
+  };
+  type: {
+    type: _lssm_lib_schema131.EnumType<[string, string, string, string]>;
+    isOptional: false;
+  };
+  definition: {
+    type: _lssm_lib_schema131.FieldType<unknown, unknown>;
+    isOptional: false;
+  };
+  sql: {
+    type: _lssm_lib_schema131.FieldType<string, string>;
+    isOptional: true;
+  };
+  cacheTtlSeconds: {
+    type: _lssm_lib_schema131.FieldType<number, number>;
+    isOptional: false;
+  };
+  isShared: {
+    type: _lssm_lib_schema131.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  createdAt: {
+    type: _lssm_lib_schema131.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, {
+  name: string;
+  version: number;
+  when: string;
+  payload: _lssm_lib_schema131.SchemaModel<{
+    id: {
+      type: _lssm_lib_schema131.FieldType<string, string>;
+      isOptional: false;
+    };
+    name: {
+      type: _lssm_lib_schema131.FieldType<string, string>;
+      isOptional: false;
+    };
+    description: {
+      type: _lssm_lib_schema131.FieldType<string, string>;
+      isOptional: true;
+    };
+    type: {
+      type: _lssm_lib_schema131.EnumType<[string, string, string, string]>;
+      isOptional: false;
+    };
+    definition: {
+      type: _lssm_lib_schema131.FieldType<unknown, unknown>;
+      isOptional: false;
+    };
+    sql: {
+      type: _lssm_lib_schema131.FieldType<string, string>;
+      isOptional: true;
+    };
+    cacheTtlSeconds: {
+      type: _lssm_lib_schema131.FieldType<number, number>;
+      isOptional: false;
+    };
+    isShared: {
+      type: _lssm_lib_schema131.FieldType<boolean, boolean>;
+      isOptional: false;
+    };
+    createdAt: {
+      type: _lssm_lib_schema131.FieldType<Date, string>;
+      isOptional: false;
+    };
+  }>;
+}[]>;
+/**
+ * Execute a data query.
+ */
+declare const ExecuteQueryContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema131.SchemaModel<{
+  queryId: {
+    type: _lssm_lib_schema131.FieldType<string, string>;
+    isOptional: false;
+  };
+  parameters: {
+    type: _lssm_lib_schema131.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  dateRange: {
+    type: _lssm_lib_schema131.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  filters: {
+    type: _lssm_lib_schema131.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  forceRefresh: {
+    type: _lssm_lib_schema131.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+}>, _lssm_lib_schema131.SchemaModel<{
+  queryId: {
+    type: _lssm_lib_schema131.FieldType<string, string>;
+    isOptional: false;
+  };
+  data: {
+    type: _lssm_lib_schema131.FieldType<unknown, unknown>;
+    isOptional: false;
+  };
+  columns: {
+    type: _lssm_lib_schema131.FieldType<unknown, unknown>;
+    isOptional: false;
+  };
+  rowCount: {
+    type: _lssm_lib_schema131.FieldType<number, number>;
+    isOptional: false;
+  };
+  executionTimeMs: {
+    type: _lssm_lib_schema131.FieldType<number, number>;
+    isOptional: false;
+  };
+  cachedAt: {
+    type: _lssm_lib_schema131.FieldType<Date, string>;
+    isOptional: true;
+  };
+  error: {
+    type: _lssm_lib_schema131.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+//#endregion
+export { CreateQueryContract, ExecuteQueryContract };

package/dist/query/query.enum.d.ts

@@ -0,0 +1,9 @@
+import * as _lssm_lib_schema207 from "@lssm/lib.schema";
+
+//#region src/query/query.enum.d.ts
+/**
+ * Query type enum.
+ */
+declare const QueryTypeEnum: _lssm_lib_schema207.EnumType<[string, string, string, string]>;
+//#endregion
+export { QueryTypeEnum };

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

@@ -0,0 +1,7 @@
+import { PresentationDescriptorV2 } from "@lssm/lib.contracts";
+
+//#region src/query/query.presentation.d.ts
+declare const QueriesListPresentation: PresentationDescriptorV2;
+declare const QueryBuilderPresentation: PresentationDescriptorV2;
+//#endregion
+export { QueriesListPresentation, QueryBuilderPresentation };

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

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

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

@@ -0,0 +1,105 @@
+//#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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.analytics-dashboard",
-  "version": "0.0.0-canary-20251217054315",
+  "version": "0.0.0-canary-20251217060804",
   "description": "Analytics Dashboard example with widgets and query engine for ContractSpec",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,38 +18,38 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@lssm/lib.schema": "0.0.0-canary-20251217054315",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217054315",
-    "@lssm/lib.bus": "0.0.0-canary-20251217054315",
-    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217054315",
-    "@lssm/lib.metering": "0.0.0-canary-20251217054315",
-    "@lssm/lib.jobs": "0.0.0-canary-20251217054315",
-    "@lssm/module.audit-trail": "0.0.0-canary-20251217054315",
+    "@lssm/lib.schema": "0.0.0-canary-20251217060804",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217060804",
+    "@lssm/lib.bus": "0.0.0-canary-20251217060804",
+    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217060804",
+    "@lssm/lib.metering": "0.0.0-canary-20251217060804",
+    "@lssm/lib.jobs": "0.0.0-canary-20251217060804",
+    "@lssm/module.audit-trail": "0.0.0-canary-20251217060804",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.typescript": "0.0.0-canary-20251217054315",
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217054315",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217060804",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217060804",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./src/index.ts",
-    "./dashboard": "./src/dashboard/index.ts",
-    "./dashboard.feature": "./src/dashboard.feature.ts",
-    "./dashboard/dashboard.contracts": "./src/dashboard/dashboard.contracts.ts",
-    "./dashboard/dashboard.enum": "./src/dashboard/dashboard.enum.ts",
-    "./dashboard/dashboard.presentation": "./src/dashboard/dashboard.presentation.ts",
-    "./dashboard/dashboard.schema": "./src/dashboard/dashboard.schema.ts",
-    "./docs": "./src/docs/index.ts",
-    "./docs/analytics-dashboard.docblock": "./src/docs/analytics-dashboard.docblock.ts",
-    "./events": "./src/events.ts",
-    "./example": "./src/example.ts",
-    "./query": "./src/query/index.ts",
-    "./query-engine": "./src/query-engine/index.ts",
-    "./query/query.contracts": "./src/query/query.contracts.ts",
-    "./query/query.enum": "./src/query/query.enum.ts",
-    "./query/query.presentation": "./src/query/query.presentation.ts",
-    "./query/query.schema": "./src/query/query.schema.ts",
+    ".": "./dist/index.js",
+    "./dashboard": "./dist/dashboard/index.js",
+    "./dashboard.feature": "./dist/dashboard.feature.js",
+    "./dashboard/dashboard.contracts": "./dist/dashboard/dashboard.contracts.js",
+    "./dashboard/dashboard.enum": "./dist/dashboard/dashboard.enum.js",
+    "./dashboard/dashboard.presentation": "./dist/dashboard/dashboard.presentation.js",
+    "./dashboard/dashboard.schema": "./dist/dashboard/dashboard.schema.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/analytics-dashboard.docblock": "./dist/docs/analytics-dashboard.docblock.js",
+    "./events": "./dist/events.js",
+    "./example": "./dist/example.js",
+    "./query": "./dist/query/index.js",
+    "./query-engine": "./dist/query-engine/index.js",
+    "./query/query.contracts": "./dist/query/query.contracts.js",
+    "./query/query.enum": "./dist/query/query.enum.js",
+    "./query/query.presentation": "./dist/query/query.presentation.js",
+    "./query/query.schema": "./dist/query/query.schema.js",
     "./*": "./*"
   },
   "module": "./dist/index.js",