metrickit 0.1.2

package/dist/helpers/clickhouse.d.ts

@@ -0,0 +1,27 @@
+import type { TimeGranularity } from '../schemas/index.ts';
+declare const CLICKHOUSE_GRANULARITY_FUNCTIONS: {
+    readonly hour: "toStartOfHour";
+    readonly day: "toStartOfDay";
+    readonly week: "toStartOfWeek";
+    readonly month: "toStartOfMonth";
+    readonly quarter: "toStartOfQuarter";
+    readonly year: "toStartOfYear";
+};
+export type ClickhouseGranularityFunction = (typeof CLICKHOUSE_GRANULARITY_FUNCTIONS)[TimeGranularity];
+export declare function getClickhouseGranularity(granularity: TimeGranularity): ClickhouseGranularityFunction;
+export declare function buildClickhouseBucketExpr(columnName: string, granularity: TimeGranularity): string;
+export type DayBoundary = 'start' | 'end';
+export declare function toClickhouseDatetime(date: Date, boundary?: DayBoundary): string;
+export declare function buildClickhouseTimeParams(filters: {
+    from?: Date;
+    to?: Date;
+}): {
+    from?: string;
+    to?: string;
+};
+export declare function buildClickhouseTimeWhere(columnName: string, options: {
+    from?: boolean;
+    to?: boolean;
+}): string;
+export declare function parseClickhouseBucketToTimestamp(bucket: string): number;
+export {};

package/dist/helpers/distribution.d.ts

@@ -0,0 +1,15 @@
+import type { DistributionOutput, DistributionChartType } from '../schemas/index.ts';
+export interface SegmentInput<Key extends string = string> {
+    key: Key;
+    label: string;
+    value: number;
+}
+export interface DistributionOptions {
+    chartType?: DistributionChartType;
+}
+export declare function calculateDistribution<const Segments extends readonly SegmentInput[]>(segments: Segments, options?: DistributionOptions): DistributionOutput<Segments[number]['key']>;
+export declare function calculateDistributionFromGroups<TKey extends string, TGroup extends {
+    _count: {
+        _all: number;
+    };
+} & Record<TKey, string>>(groups: TGroup[], keyField: TKey, labelMap?: Record<string, string>, options?: DistributionOptions): DistributionOutput<TGroup[TKey]>;

package/dist/helpers/index.d.ts

@@ -0,0 +1,6 @@
+export { getClickhouseGranularity, buildClickhouseBucketExpr, toClickhouseDatetime, buildClickhouseTimeParams, buildClickhouseTimeWhere, parseClickhouseBucketToTimestamp, type ClickhouseGranularityFunction, type DayBoundary } from './clickhouse.ts';
+export { buildTimeRangeWhere, buildTimeRangeWhereObject, buildScopedTimeWhere, type TimeRangeWhere } from './prisma.ts';
+export { calculateDistribution, calculateDistributionFromGroups, type SegmentInput, type DistributionOptions } from './distribution.ts';
+export { mapBucketsToPoints, createEmptyPoints } from './timeseries.ts';
+export { resolveMetricType, calculateMetricModeValue, getMetricModeLabel, getBucketCountForMetricMode } from './metric-type.ts';
+export { createPivotMatrix, addPivotCell, computePivotTotals, formatPivotBucketLabel, buildPivotOutput } from './pivot.ts';

package/dist/helpers/metric-type.d.ts

@@ -0,0 +1,21 @@
+import type { MetricType } from '../schemas/metric-type.ts';
+export declare function resolveMetricType(metric: MetricType | undefined, defaultMetric: MetricType): MetricType;
+export declare function calculateMetricModeValue(args: {
+    total: number;
+    averageDivisor: number;
+    metric: MetricType | undefined;
+    defaultMetric: MetricType;
+    bucketCount?: number;
+    postProcess?: (value: number) => number;
+}): number;
+export declare function getMetricModeLabel<Labels extends Record<MetricType, string>>(args: {
+    metric: MetricType | undefined;
+    defaultMetric: MetricType;
+    labels: Labels;
+}): Labels[MetricType];
+export declare function getBucketCountForMetricMode(args: {
+    metric: MetricType | undefined;
+    defaultMetric: MetricType;
+    from: Date;
+    to: Date;
+}): number | undefined;

package/dist/helpers/pivot.d.ts

@@ -0,0 +1,15 @@
+import type { TimeGranularity } from '../schemas/index.ts';
+import { type PivotOutput, type PivotTotals } from '../schemas/index.ts';
+export declare function createPivotMatrix(rowCount: number, columnCount: number): number[][];
+export declare function addPivotCell(values: number[][], rowIndex: number, columnIndex: number, delta: number): void;
+export declare function computePivotTotals(values: number[][]): PivotTotals;
+export declare function formatPivotBucketLabel(bucket: Date, granularity: TimeGranularity): string;
+export declare function buildPivotOutput(args: {
+    rowDimension: PivotOutput['rowDimension'];
+    columnDimension: PivotOutput['columnDimension'];
+    rows: string[];
+    columns: string[];
+    values: number[][];
+    cellTooltips?: string[][];
+    totals?: PivotTotals;
+}): PivotOutput;

package/dist/helpers/prisma.d.ts

@@ -0,0 +1,20 @@
+export interface TimeRangeWhere {
+    gte?: Date;
+    lte?: Date;
+}
+export declare function buildTimeRangeWhere(filters: {
+    from?: Date;
+    to?: Date;
+}): TimeRangeWhere | undefined;
+export declare function buildTimeRangeWhereObject<T extends string>(columnName: T, filters: {
+    from?: Date;
+    to?: Date;
+}): {
+    [K in T]?: TimeRangeWhere;
+};
+export declare function buildScopedTimeWhere<TIdColumn extends string>(idColumn: TIdColumn, timeColumn: string, filters: {
+    scopeIds?: string[];
+    scopeId?: string;
+    from?: Date;
+    to?: Date;
+}): Record<string, unknown>;

package/dist/helpers/timeseries.d.ts

@@ -0,0 +1,6 @@
+import type { TimeGranularity } from '../schemas/index.ts';
+import type { TimeSeriesPoint } from '../schemas/output.ts';
+export declare function mapBucketsToPoints<T extends {
+    bucket?: string;
+}>(buckets: Date[], rows: T[], valueExtractor: (row: T) => number): TimeSeriesPoint[];
+export declare function createEmptyPoints(from: Date, to: Date, granularity: TimeGranularity): TimeSeriesPoint[];

package/dist/helpers.d.ts

@@ -0,0 +1 @@
+export * from './helpers/index.ts';