@lssm/example.analytics-dashboard 0.0.0-canary-20251206160926

package/dist/presentations/index.d.ts

@@ -0,0 +1,473 @@
+//#region src/presentations/index.d.ts
+/**
+ * Analytics Dashboard Presentation Descriptors
+ *
+ * These presentation descriptors define how analytics dashboards
+ * and widgets should be rendered across different surfaces.
+ */
+declare const DashboardListPresentation: {
+  name: string;
+  type: "list";
+  description: string;
+  layout: {
+    header: {
+      title: string;
+      actions: string[];
+    };
+    filters: string[];
+    list: {
+      itemType: string;
+      pagination: boolean;
+      itemsPerPage: number;
+    };
+  };
+  dataSource: {
+    query: string;
+    defaultParams: {
+      status: undefined;
+      limit: number;
+      offset: number;
+    };
+  };
+  actions: {
+    create_dashboard: {
+      label: string;
+      icon: string;
+      command: string;
+    };
+  };
+};
+declare const DashboardViewPresentation: {
+  name: string;
+  type: "dashboard";
+  description: string;
+  layout: {
+    header: {
+      title: string;
+      breadcrumbs: string[];
+      actions: string[];
+    };
+    toolbar: {
+      dateRangePicker: boolean;
+      filters: boolean;
+      refreshInterval: boolean;
+    };
+    grid: {
+      type: string;
+      columns: number;
+      rowHeight: number;
+      margin: number;
+    };
+    widgets: {
+      dragEnabled: string;
+      resizeEnabled: string;
+    };
+  };
+  dataSource: {
+    query: string;
+    params: {
+      dashboardId: string;
+      slug: string;
+    };
+  };
+  actions: {
+    edit: {
+      label: string;
+      icon: string;
+      toggleState: string;
+      requiresPermission: string;
+    };
+    share: {
+      label: string;
+      icon: string;
+      openModal: string;
+    };
+    refresh: {
+      label: string;
+      icon: string;
+      action: string;
+    };
+    export: {
+      label: string;
+      icon: string;
+      openMenu: string[];
+    };
+  };
+};
+declare const DashboardEditorPresentation: {
+  name: string;
+  type: "editor";
+  description: string;
+  layout: {
+    header: {
+      title: string;
+      actions: string[];
+    };
+    sidebar: {
+      widgetPalette: boolean;
+      queryBuilder: boolean;
+      settings: boolean;
+    };
+    main: {
+      type: string;
+      columns: number;
+      rowHeight: number;
+      snapToGrid: boolean;
+    };
+    footer: {
+      statusBar: boolean;
+      lastSaved: boolean;
+    };
+  };
+  widgetPalette: {
+    categories: {
+      name: string;
+      widgets: string[];
+    }[];
+  };
+  actions: {
+    save: {
+      label: string;
+      icon: string;
+      command: string;
+      primary: boolean;
+    };
+    preview: {
+      label: string;
+      icon: string;
+      toggleState: string;
+    };
+    discard: {
+      label: string;
+      icon: string;
+      confirmMessage: string;
+      action: string;
+    };
+  };
+};
+declare const WidgetConfigurationPresentation: {
+  name: string;
+  type: "modal";
+  description: string;
+  layout: {
+    tabs: string[];
+  };
+  tabs: {
+    data: {
+      label: string;
+      sections: {
+        name: string;
+        fields: string[];
+      }[];
+    };
+    visualization: {
+      label: string;
+      sections: {
+        name: string;
+        fields: string[];
+      }[];
+    };
+    formatting: {
+      label: string;
+      sections: {
+        name: string;
+        fields: string[];
+      }[];
+    };
+  };
+};
+declare const QueryBuilderPresentation: {
+  name: string;
+  type: "builder";
+  description: string;
+  layout: {
+    header: {
+      title: string;
+      actions: string[];
+    };
+    main: {
+      queryTypeSelector: boolean;
+      builderArea: boolean;
+      preview: boolean;
+    };
+    footer: {
+      executionStats: boolean;
+    };
+  };
+  queryTypes: {
+    metric: {
+      label: string;
+      icon: string;
+      description: string;
+    };
+    aggregation: {
+      label: string;
+      icon: string;
+      description: string;
+    };
+    sql: {
+      label: string;
+      icon: string;
+      description: string;
+    };
+  };
+  builderComponents: {
+    metricSelector: {
+      type: string;
+      source: string;
+    };
+    measureBuilder: {
+      type: string;
+      fields: string[];
+    };
+    dimensionBuilder: {
+      type: string;
+      fields: string[];
+    };
+    filterBuilder: {
+      type: string;
+      operators: string[];
+    };
+    sqlEditor: {
+      type: string;
+      language: string;
+      autoComplete: boolean;
+      formatOnSave: boolean;
+    };
+  };
+};
+declare const AnalyticsDashboardPresentations: {
+  DashboardListPresentation: {
+    name: string;
+    type: "list";
+    description: string;
+    layout: {
+      header: {
+        title: string;
+        actions: string[];
+      };
+      filters: string[];
+      list: {
+        itemType: string;
+        pagination: boolean;
+        itemsPerPage: number;
+      };
+    };
+    dataSource: {
+      query: string;
+      defaultParams: {
+        status: undefined;
+        limit: number;
+        offset: number;
+      };
+    };
+    actions: {
+      create_dashboard: {
+        label: string;
+        icon: string;
+        command: string;
+      };
+    };
+  };
+  DashboardViewPresentation: {
+    name: string;
+    type: "dashboard";
+    description: string;
+    layout: {
+      header: {
+        title: string;
+        breadcrumbs: string[];
+        actions: string[];
+      };
+      toolbar: {
+        dateRangePicker: boolean;
+        filters: boolean;
+        refreshInterval: boolean;
+      };
+      grid: {
+        type: string;
+        columns: number;
+        rowHeight: number;
+        margin: number;
+      };
+      widgets: {
+        dragEnabled: string;
+        resizeEnabled: string;
+      };
+    };
+    dataSource: {
+      query: string;
+      params: {
+        dashboardId: string;
+        slug: string;
+      };
+    };
+    actions: {
+      edit: {
+        label: string;
+        icon: string;
+        toggleState: string;
+        requiresPermission: string;
+      };
+      share: {
+        label: string;
+        icon: string;
+        openModal: string;
+      };
+      refresh: {
+        label: string;
+        icon: string;
+        action: string;
+      };
+      export: {
+        label: string;
+        icon: string;
+        openMenu: string[];
+      };
+    };
+  };
+  DashboardEditorPresentation: {
+    name: string;
+    type: "editor";
+    description: string;
+    layout: {
+      header: {
+        title: string;
+        actions: string[];
+      };
+      sidebar: {
+        widgetPalette: boolean;
+        queryBuilder: boolean;
+        settings: boolean;
+      };
+      main: {
+        type: string;
+        columns: number;
+        rowHeight: number;
+        snapToGrid: boolean;
+      };
+      footer: {
+        statusBar: boolean;
+        lastSaved: boolean;
+      };
+    };
+    widgetPalette: {
+      categories: {
+        name: string;
+        widgets: string[];
+      }[];
+    };
+    actions: {
+      save: {
+        label: string;
+        icon: string;
+        command: string;
+        primary: boolean;
+      };
+      preview: {
+        label: string;
+        icon: string;
+        toggleState: string;
+      };
+      discard: {
+        label: string;
+        icon: string;
+        confirmMessage: string;
+        action: string;
+      };
+    };
+  };
+  WidgetConfigurationPresentation: {
+    name: string;
+    type: "modal";
+    description: string;
+    layout: {
+      tabs: string[];
+    };
+    tabs: {
+      data: {
+        label: string;
+        sections: {
+          name: string;
+          fields: string[];
+        }[];
+      };
+      visualization: {
+        label: string;
+        sections: {
+          name: string;
+          fields: string[];
+        }[];
+      };
+      formatting: {
+        label: string;
+        sections: {
+          name: string;
+          fields: string[];
+        }[];
+      };
+    };
+  };
+  QueryBuilderPresentation: {
+    name: string;
+    type: "builder";
+    description: string;
+    layout: {
+      header: {
+        title: string;
+        actions: string[];
+      };
+      main: {
+        queryTypeSelector: boolean;
+        builderArea: boolean;
+        preview: boolean;
+      };
+      footer: {
+        executionStats: boolean;
+      };
+    };
+    queryTypes: {
+      metric: {
+        label: string;
+        icon: string;
+        description: string;
+      };
+      aggregation: {
+        label: string;
+        icon: string;
+        description: string;
+      };
+      sql: {
+        label: string;
+        icon: string;
+        description: string;
+      };
+    };
+    builderComponents: {
+      metricSelector: {
+        type: string;
+        source: string;
+      };
+      measureBuilder: {
+        type: string;
+        fields: string[];
+      };
+      dimensionBuilder: {
+        type: string;
+        fields: string[];
+      };
+      filterBuilder: {
+        type: string;
+        operators: string[];
+      };
+      sqlEditor: {
+        type: string;
+        language: string;
+        autoComplete: boolean;
+        formatOnSave: boolean;
+      };
+    };
+  };
+};
+//#endregion
+export { AnalyticsDashboardPresentations, DashboardEditorPresentation, DashboardListPresentation, DashboardViewPresentation, QueryBuilderPresentation, WidgetConfigurationPresentation };

package/dist/presentations/index.js

@@ -0,0 +1 @@
+const e={name:`analytics.dashboards.list`,type:`list`,description:`Dashboard listing page with search and filters`,layout:{header:{title:`Analytics Dashboards`,actions:[`create_dashboard`]},filters:[`status`,`search`],list:{itemType:`dashboard_card`,pagination:!0,itemsPerPage:20}},dataSource:{query:`analytics.dashboard.list`,defaultParams:{status:void 0,limit:20,offset:0}},actions:{create_dashboard:{label:`New Dashboard`,icon:`plus`,command:`analytics.dashboard.create`}}},t={name:`analytics.dashboard.view`,type:`dashboard`,description:`Dashboard viewing/editing interface`,layout:{header:{title:`{{dashboard.name}}`,breadcrumbs:[`Dashboards`,`{{dashboard.name}}`],actions:[`edit`,`share`,`refresh`,`export`]},toolbar:{dateRangePicker:!0,filters:!0,refreshInterval:!0},grid:{type:`responsive`,columns:12,rowHeight:100,margin:16},widgets:{dragEnabled:`{{isEditing}}`,resizeEnabled:`{{isEditing}}`}},dataSource:{query:`analytics.dashboard.get`,params:{dashboardId:`{{params.dashboardId}}`,slug:`{{params.slug}}`}},actions:{edit:{label:`Edit`,icon:`edit`,toggleState:`isEditing`,requiresPermission:`dashboard:edit`},share:{label:`Share`,icon:`share`,openModal:`share_dashboard`},refresh:{label:`Refresh`,icon:`refresh`,action:`refreshAllWidgets`},export:{label:`Export`,icon:`download`,openMenu:[`export_pdf`,`export_png`,`export_csv`]}}},n={name:`analytics.dashboard.editor`,type:`editor`,description:`Dashboard editing interface with widget palette`,layout:{header:{title:`Edit: {{dashboard.name}}`,actions:[`save`,`preview`,`discard`]},sidebar:{widgetPalette:!0,queryBuilder:!0,settings:!0},main:{type:`grid_editor`,columns:12,rowHeight:100,snapToGrid:!0},footer:{statusBar:!0,lastSaved:!0}},widgetPalette:{categories:[{name:`Charts`,widgets:[`line_chart`,`bar_chart`,`pie_chart`,`area_chart`,`scatter_plot`]},{name:`Data`,widgets:[`metric`,`table`,`funnel`]},{name:`Visualization`,widgets:[`heatmap`,`map`,`text`,`embed`]}]},actions:{save:{label:`Save`,icon:`save`,command:`analytics.dashboard.update`,primary:!0},preview:{label:`Preview`,icon:`eye`,toggleState:`previewMode`},discard:{label:`Discard Changes`,icon:`x`,confirmMessage:`Discard unsaved changes?`,action:`discardChanges`}}},r={name:`analytics.widget.configure`,type:`modal`,description:`Widget configuration panel`,layout:{tabs:[`data`,`visualization`,`formatting`]},tabs:{data:{label:`Data`,sections:[{name:`Query`,fields:[`queryId`,`createNewQuery`]},{name:`Filters`,fields:[`inheritDashboardFilters`,`additionalFilters`]}]},visualization:{label:`Visualization`,sections:[{name:`Chart Type`,fields:[`chartType`,`chartVariant`]},{name:`Axes`,fields:[`xAxis`,`yAxis`,`secondaryYAxis`]},{name:`Legend`,fields:[`showLegend`,`legendPosition`]}]},formatting:{label:`Formatting`,sections:[{name:`Title`,fields:[`title`,`subtitle`,`titleAlignment`]},{name:`Colors`,fields:[`colorScheme`,`customColors`]},{name:`Numbers`,fields:[`numberFormat`,`decimals`,`prefix`,`suffix`]}]}}},i={name:`analytics.query.builder`,type:`builder`,description:`Visual query builder interface`,layout:{header:{title:`Query Builder`,actions:[`run`,`save`,`clear`]},main:{queryTypeSelector:!0,builderArea:!0,preview:!0},footer:{executionStats:!0}},queryTypes:{metric:{label:`Metric Query`,icon:`hash`,description:`Query usage metrics`},aggregation:{label:`Aggregation`,icon:`layers`,description:`Aggregate data with measures and dimensions`},sql:{label:`SQL`,icon:`code`,description:`Write custom SQL query`}},builderComponents:{metricSelector:{type:`multi_select`,source:`metering.metrics.list`},measureBuilder:{type:`field_list`,fields:[`name`,`field`,`aggregation`,`format`]},dimensionBuilder:{type:`field_list`,fields:[`name`,`field`,`type`,`granularity`]},filterBuilder:{type:`condition_builder`,operators:[`eq`,`neq`,`gt`,`gte`,`lt`,`lte`,`in`,`contains`,`between`]},sqlEditor:{type:`code_editor`,language:`sql`,autoComplete:!0,formatOnSave:!0}}},a={DashboardListPresentation:e,DashboardViewPresentation:t,DashboardEditorPresentation:n,WidgetConfigurationPresentation:r,QueryBuilderPresentation:i};export{a as AnalyticsDashboardPresentations,n as DashboardEditorPresentation,e as DashboardListPresentation,t as DashboardViewPresentation,i as QueryBuilderPresentation,r as WidgetConfigurationPresentation};

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/dist/query-engine/index.js

@@ -0,0 +1 @@
+var e=class{cache=new Map;async get(e){let t=this.cache.get(e);return t?t.expiresAt<new Date?(this.cache.delete(e),null):{...t.result,cached:!0,cachedAt:t.expiresAt}:null}async set(e,t,n){let r=new Date(Date.now()+n*1e3);this.cache.set(e,{result:t,expiresAt:r})}async invalidate(e){let t=new RegExp(e);for(let e of this.cache.keys())t.test(e)&&this.cache.delete(e)}},t=class{cache;constructor(t){this.cache=t??new e}async execute(e,t){let n=Date.now(),r=this.validateQuery(e);if(!r.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:r.errors.join(`, `)};let i=this.buildCacheKey(e,t),a=await this.cache.get(i);if(a)return a;let o;switch(e.type){case`AGGREGATION`:o=await this.executeAggregation(e.aggregation,t);break;case`METRIC`:o=await this.executeMetric(e.metricIds,t);break;case`SQL`:o=await this.executeSql(e.sql,t);break;default:o={data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:`Unknown query type: ${e.type}`}}return o.executionTimeMs=Date.now()-n,o.cached=!1,await this.cache.set(i,o,300),o}validateQuery(e){let t=[];switch(e.type||t.push(`Query type is required`),e.type){case`SQL`:e.sql||t.push(`SQL query is required for SQL type`);break;case`METRIC`:(!e.metricIds||e.metricIds.length===0)&&t.push(`Metric IDs are required for METRIC type`);break;case`AGGREGATION`:e.aggregation?(e.aggregation.source||t.push(`Aggregation source is required`),(!e.aggregation.measures||e.aggregation.measures.length===0)&&t.push(`At least one measure is required`)):t.push(`Aggregation definition is required for AGGREGATION type`);break}return{valid:t.length===0,errors:t}}buildCacheKey(e,t){return JSON.stringify({definition:e,params:t})}async executeAggregation(e,t){let n=[...e.dimensions.map(e=>({name:e.name,type:e.type===`NUMBER`?`NUMBER`:e.type===`TIME`?`DATE`:`STRING`,label:e.name})),...e.measures.map(e=>({name:e.name,type:`NUMBER`,label:e.name,format:e.format}))],r=this.generateMockData(e,t);return{data:r,columns:n,rowCount:r.length,executionTimeMs:0,cached:!1}}async executeMetric(e,t){let n=e.map(e=>({metricId:e,value:Math.random()*1e3,change:(Math.random()-.5)*20}));return{data:n,columns:[{name:`metricId`,type:`STRING`},{name:`value`,type:`NUMBER`},{name:`change`,type:`NUMBER`}],rowCount:n.length,executionTimeMs:0,cached:!1}}async executeSql(e,t){return{data:[],columns:[],rowCount:0,executionTimeMs:0,cached:!1,error:`SQL execution not implemented in demo`}}generateMockData(e,t){let n=[],r=e.dimensions.find(e=>e.type===`TIME`);for(let i=0;i<10;i++){let a={};for(let n of e.dimensions)if(n.type===`TIME`){let e=new Date(t.dateRange?.start??new Date);e.setDate(e.getDate()+i),a[n.name]=e.toISOString().split(`T`)[0]}else a[n.name]=`${n.name}_${i%5}`;for(let t of e.measures){let e=r?100+i*10:Math.random()*1e3,n=(Math.random()-.5)*20;a[t.name]=Math.round((e+n)*100)/100}n.push(a)}return n}};function n(e){return new t(e)}export{t as BasicQueryEngine,e as InMemoryQueryCache,n as createQueryEngine};