@contractspec/lib.metering 1.57.0 → 1.59.0

package/dist/aggregation/index.d.ts

@@ -1,156 +1,153 @@
-//#region src/aggregation/index.d.ts
 /**
  * Usage aggregation engine.
  *
  * Provides periodic aggregation of usage records into summaries
  * for efficient billing and reporting queries.
  */
-type PeriodType = 'HOURLY' | 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY';
-type AggregationType = 'COUNT' | 'SUM' | 'AVG' | 'MAX' | 'MIN' | 'LAST';
-interface UsageRecord {
-  id: string;
-  metricKey: string;
-  subjectType: string;
-  subjectId: string;
-  quantity: number;
-  timestamp: Date;
+export type PeriodType = 'HOURLY' | 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY';
+export type AggregationType = 'COUNT' | 'SUM' | 'AVG' | 'MAX' | 'MIN' | 'LAST';
+export interface UsageRecord {
+    id: string;
+    metricKey: string;
+    subjectType: string;
+    subjectId: string;
+    quantity: number;
+    timestamp: Date;
 }
-interface UsageSummary {
-  id: string;
-  metricKey: string;
-  subjectType: string;
-  subjectId: string;
-  periodType: PeriodType;
-  periodStart: Date;
-  periodEnd: Date;
-  totalQuantity: number;
-  recordCount: number;
-  minQuantity?: number;
-  maxQuantity?: number;
-  avgQuantity?: number;
-}
-interface MetricDefinition {
-  key: string;
-  aggregationType: AggregationType;
-}
-interface UsageStorage {
-  /**
-   * Get unaggregated records for a period.
-   */
-  getUnaggregatedRecords(options: {
-    metricKey?: string;
+export interface UsageSummary {
+    id: string;
+    metricKey: string;
+    subjectType: string;
+    subjectId: string;
+    periodType: PeriodType;
     periodStart: Date;
     periodEnd: Date;
-    limit?: number;
-  }): Promise<UsageRecord[]>;
-  /**
-   * Mark records as aggregated.
-   */
-  markRecordsAggregated(recordIds: string[], aggregatedAt: Date): Promise<void>;
-  /**
-   * Get or create a summary record.
-   */
-  upsertSummary(summary: Omit<UsageSummary, 'id'>): Promise<UsageSummary>;
-  /**
-   * Get metric definition.
-   */
-  getMetric(key: string): Promise<MetricDefinition | null>;
-  /**
-   * List all active metrics.
-   */
-  listMetrics(): Promise<MetricDefinition[]>;
+    totalQuantity: number;
+    recordCount: number;
+    minQuantity?: number;
+    maxQuantity?: number;
+    avgQuantity?: number;
 }
-interface AggregationOptions {
-  /** Storage implementation */
-  storage: UsageStorage;
-  /** Batch size for processing records */
-  batchSize?: number;
+export interface MetricDefinition {
+    key: string;
+    aggregationType: AggregationType;
 }
-interface AggregateParams {
-  /** Period type to aggregate */
-  periodType: PeriodType;
-  /** Period start time */
-  periodStart: Date;
-  /** Period end time (optional, defaults to period boundary) */
-  periodEnd?: Date;
-  /** Specific metric to aggregate (optional, aggregates all if not specified) */
-  metricKey?: string;
+export interface UsageStorage {
+    /**
+     * Get unaggregated records for a period.
+     */
+    getUnaggregatedRecords(options: {
+        metricKey?: string;
+        periodStart: Date;
+        periodEnd: Date;
+        limit?: number;
+    }): Promise<UsageRecord[]>;
+    /**
+     * Mark records as aggregated.
+     */
+    markRecordsAggregated(recordIds: string[], aggregatedAt: Date): Promise<void>;
+    /**
+     * Get or create a summary record.
+     */
+    upsertSummary(summary: Omit<UsageSummary, 'id'>): Promise<UsageSummary>;
+    /**
+     * Get metric definition.
+     */
+    getMetric(key: string): Promise<MetricDefinition | null>;
+    /**
+     * List all active metrics.
+     */
+    listMetrics(): Promise<MetricDefinition[]>;
+}
+export interface AggregationOptions {
+    /** Storage implementation */
+    storage: UsageStorage;
+    /** Batch size for processing records */
+    batchSize?: number;
+}
+export interface AggregateParams {
+    /** Period type to aggregate */
+    periodType: PeriodType;
+    /** Period start time */
+    periodStart: Date;
+    /** Period end time (optional, defaults to period boundary) */
+    periodEnd?: Date;
+    /** Specific metric to aggregate (optional, aggregates all if not specified) */
+    metricKey?: string;
 }
-interface AggregationResult {
-  periodType: PeriodType;
-  periodStart: Date;
-  periodEnd: Date;
-  recordsProcessed: number;
-  summariesCreated: number;
-  summariesUpdated: number;
-  errors: AggregationError[];
+export interface AggregationResult {
+    periodType: PeriodType;
+    periodStart: Date;
+    periodEnd: Date;
+    recordsProcessed: number;
+    summariesCreated: number;
+    summariesUpdated: number;
+    errors: AggregationError[];
 }
-interface AggregationError {
-  metricKey: string;
-  subjectType: string;
-  subjectId: string;
-  error: string;
+export interface AggregationError {
+    metricKey: string;
+    subjectType: string;
+    subjectId: string;
+    error: string;
 }
 /**
  * Get the start of a period for a given date.
  */
-declare function getPeriodStart(date: Date, periodType: PeriodType): Date;
+export declare function getPeriodStart(date: Date, periodType: PeriodType): Date;
 /**
  * Get the end of a period for a given date.
  */
-declare function getPeriodEnd(date: Date, periodType: PeriodType): Date;
+export declare function getPeriodEnd(date: Date, periodType: PeriodType): Date;
 /**
  * Format a period key for grouping.
  */
-declare function formatPeriodKey(date: Date, periodType: PeriodType): string;
+export declare function formatPeriodKey(date: Date, periodType: PeriodType): string;
 /**
  * Usage aggregator.
  *
  * Aggregates usage records into summaries based on period type.
  */
-declare class UsageAggregator {
-  private storage;
-  private batchSize;
-  constructor(options: AggregationOptions);
-  /**
-   * Aggregate usage records for a period.
-   */
-  aggregate(params: AggregateParams): Promise<AggregationResult>;
-  /**
-   * Group records by metric, subject, and period.
-   */
-  private groupRecords;
-  /**
-   * Aggregate a group of records into a summary.
-   */
-  private aggregateGroup;
-  /**
-   * Calculate aggregation values.
-   */
-  private calculateAggregation;
+export declare class UsageAggregator {
+    private storage;
+    private batchSize;
+    constructor(options: AggregationOptions);
+    /**
+     * Aggregate usage records for a period.
+     */
+    aggregate(params: AggregateParams): Promise<AggregationResult>;
+    /**
+     * Group records by metric, subject, and period.
+     */
+    private groupRecords;
+    /**
+     * Aggregate a group of records into a summary.
+     */
+    private aggregateGroup;
+    /**
+     * Calculate aggregation values.
+     */
+    private calculateAggregation;
 }
 /**
  * In-memory usage storage for testing.
  */
-declare class InMemoryUsageStorage implements UsageStorage {
-  private records;
-  private summaries;
-  private metrics;
-  addRecord(record: UsageRecord): void;
-  addMetric(metric: MetricDefinition): void;
-  getUnaggregatedRecords(options: {
-    metricKey?: string;
-    periodStart: Date;
-    periodEnd: Date;
-    limit?: number;
-  }): Promise<UsageRecord[]>;
-  markRecordsAggregated(recordIds: string[]): Promise<void>;
-  upsertSummary(summary: Omit<UsageSummary, 'id'>): Promise<UsageSummary>;
-  getMetric(key: string): Promise<MetricDefinition | null>;
-  listMetrics(): Promise<MetricDefinition[]>;
-  getSummaries(): UsageSummary[];
-  clear(): void;
+export declare class InMemoryUsageStorage implements UsageStorage {
+    private records;
+    private summaries;
+    private metrics;
+    addRecord(record: UsageRecord): void;
+    addMetric(metric: MetricDefinition): void;
+    getUnaggregatedRecords(options: {
+        metricKey?: string;
+        periodStart: Date;
+        periodEnd: Date;
+        limit?: number;
+    }): Promise<UsageRecord[]>;
+    markRecordsAggregated(recordIds: string[]): Promise<void>;
+    upsertSummary(summary: Omit<UsageSummary, 'id'>): Promise<UsageSummary>;
+    getMetric(key: string): Promise<MetricDefinition | null>;
+    listMetrics(): Promise<MetricDefinition[]>;
+    getSummaries(): UsageSummary[];
+    clear(): void;
 }
-//#endregion
-export { AggregateParams, AggregationError, AggregationOptions, AggregationResult, AggregationType, InMemoryUsageStorage, MetricDefinition, PeriodType, UsageAggregator, UsageRecord, UsageStorage, UsageSummary, formatPeriodKey, getPeriodEnd, getPeriodStart };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/aggregation/index.ts"],"mappings":";;AASA;;;;;KAAY,UAAA;AAAA,KACA,eAAA;AAAA,UAEK,WAAA;EACf,EAAA;EACA,SAAA;EACA,WAAA;EACA,SAAA;EACA,QAAA;EACA,SAAA,EAAW,IAAA;AAAA;AAAA,UAGI,YAAA;EACf,EAAA;EACA,SAAA;EACA,WAAA;EACA,SAAA;EACA,UAAA,EAAY,UAAA;EACZ,WAAA,EAAa,IAAA;EACb,SAAA,EAAW,IAAA;EACX,aAAA;EACA,WAAA;EACA,WAAA;EACA,WAAA;EACA,WAAA;AAAA;AAAA,UAGe,gBAAA;EACf,GAAA;EACA,eAAA,EAAiB,eAAA;AAAA;AAAA,UAGF,YAAA;EAhBf;;;EAoBA,sBAAA,CAAuB,OAAA;IACrB,SAAA;IACA,WAAA,EAAa,IAAA;IACb,SAAA,EAAW,IAAA;IACX,KAAA;EAAA,IACE,OAAA,CAAQ,WAAA;EAnBZ;;;EAwBA,qBAAA,CAAsB,SAAA,YAAqB,YAAA,EAAc,IAAA,GAAO,OAAA;EAtBrD;AAGb;;EAwBE,aAAA,CAAc,OAAA,EAAS,IAAA,CAAK,YAAA,UAAsB,OAAA,CAAQ,YAAA;EAtB1B;;;EA2BhC,SAAA,CAAU,GAAA,WAAc,OAAA,CAAQ,gBAAA;EA3BA;;AAGlC;EA6BE,WAAA,IAAe,OAAA,CAAQ,gBAAA;AAAA;AAAA,UAGR,kBAAA;EAzBF;EA2Bb,OAAA,EAAS,YAAA;EAzBL;EA2BJ,SAAA;AAAA;AAAA,UAGe,eAAA;EApBQ;EAsBvB,UAAA,EAAY,UAAA;EAtBsC;EAwBlD,WAAA,EAAa,IAAA;EAnBW;EAqBxB,SAAA,GAAY,IAAA;EAhBG;EAkBf,SAAA;AAAA;AAAA,UAGe,iBAAA;EACf,UAAA,EAAY,UAAA;EACZ,WAAA,EAAa,IAAA;EACb,SAAA,EAAW,IAAA;EACX,gBAAA;EACA,gBAAA;EACA,gBAAA;EACA,MAAA,EAAQ,gBAAA;AAAA;AAAA,UAGO,gBAAA;EACf,SAAA;EACA,WAAA;EACA,SAAA;EACA,KAAA;AAAA;;;;iBAQc,cAAA,CAAe,IAAA,EAAM,IAAA,EAAM,UAAA,EAAY,UAAA,GAAa,IAAA;;;;iBAkCpD,YAAA,CAAa,IAAA,EAAM,IAAA,EAAM,UAAA,EAAY,UAAA,GAAa,IAAA;;;;iBA8BlD,eAAA,CAAgB,IAAA,EAAM,IAAA,EAAM,UAAA,EAAY,UAAA;;;;AAxGxD;;cAiJa,eAAA;EAAA,QACH,OAAA;EAAA,QACA,SAAA;cAEI,OAAA,EAAS,kBAAA;EAjJrB;;;EAyJM,SAAA,CAAU,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,iBAAA;EAtJpB;;;EAAA,QA6MtB,YAAA;EAvMI;;;EAAA,QA4NE,cAAA;EAhOF;;;EAAA,QA8QJ,oBAAA;AAAA;;;;cA+CG,oBAAA,YAAgC,YAAA;EAAA,QACnC,OAAA;EAAA,QACA,SAAA;EAAA,QACA,OAAA;EAER,SAAA,CAAU,MAAA,EAAQ,WAAA;EAIlB,SAAA,CAAU,MAAA,EAAQ,gBAAA;EAIZ,sBAAA,CAAuB,OAAA;IAC3B,SAAA;IACA,WAAA,EAAa,IAAA;IACb,SAAA,EAAW,IAAA;IACX,KAAA;EAAA,IACE,OAAA,CAAQ,WAAA;EAgBN,qBAAA,CAAsB,SAAA,aAAsB,OAAA;EAI5C,aAAA,CACJ,OAAA,EAAS,IAAA,CAAK,YAAA,UACb,OAAA,CAAQ,YAAA;EAgCL,SAAA,CAAU,GAAA,WAAc,OAAA,CAAQ,gBAAA;EAIhC,WAAA,CAAA,GAAe,OAAA,CAAQ,gBAAA;EAI7B,YAAA,CAAA,GAAgB,YAAA;EAIhB,KAAA,CAAA;AAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aggregation/index.ts"],"names":[],"mappings":"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"}