@happyvertical/smrt-reports 0.51.32 → 0.51.34

package/dist/__tests__/helpers/consumer-report-collection.d.ts

@@ -0,0 +1,5 @@
+export declare const REPORT_TABLE = "usage_daily_reports";
+export declare function registerConsumerReportCollection(): void;
+/** An unrelated class that names the report's table: still a conflict. */
+export declare function registerUnrelatedTableClaimant(): void;
+//# sourceMappingURL=consumer-report-collection.d.ts.map

package/dist/__tests__/helpers/consumer-report-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-report-collection.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/consumer-report-collection.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,YAAY,wBAAwB,CAAC;AAgBlD,wBAAgB,gCAAgC,IAAI,IAAI,CAgCvD;AAED,0EAA0E;AAC1E,wBAAgB,8BAA8B,IAAI,IAAI,CAgBrD"}

package/dist/adapter.d.ts

@@ -0,0 +1,318 @@
+import { type SmrtObject } from '@happyvertical/smrt-core';
+import type { DataQueryFieldDescriptor, DataQueryFilter, DataQueryRequest, DataQueryResult, DataQuerySchema } from '@happyvertical/smrt-types';
+import { type ReportLifecycleOptions, type ReportLifecycleSnapshot } from './lifecycle.js';
+import type { ReportAggregateFn, ReportTimeBucketUnit } from './types.js';
+/** Presentation and policy metadata understood by the report adapter. */
+export type ReportColumnSensitivity = 'public' | 'personal' | 'sensitive' | 'secret';
+export type ReportColumnCapability = 'read' | 'project' | 'filter' | 'sort' | 'facet' | 'group' | 'aggregate';
+export type ReportColumnKind = 'identity' | 'group' | 'bucket' | 'aggregate';
+/**
+ * Source-query clause a field belongs to. The materialized read executor
+ * applies both kinds through its tenant-scoped collection, but consumers use
+ * this declaration to keep dimensions/periods (WHERE) distinct from measures
+ * (HAVING) when constructing drilldowns, saved views, or a live query.
+ */
+export type ReportFilterScope = 'where' | 'having';
+export interface ReportColumnDescriptor extends DataQueryFieldDescriptor {
+    /** Stable output column id (never a property path). */
+    id: string;
+    fieldName: string;
+    label: string;
+    kind: ReportColumnKind;
+    filterScope: ReportFilterScope;
+    /** Capabilities available from this adapter revision. */
+    capabilities: ReportColumnCapability[];
+    format?: string;
+    sensitivity?: ReportColumnSensitivity;
+    sourceColumn?: string;
+    bucket?: ReportTimeBucketUnit;
+    aggregate?: ReportAggregateFn;
+    distinct?: boolean;
+}
+export interface ReportRefreshDescriptor {
+    mode: 'rebuild' | 'incremental';
+    /**
+     * Whether the report configuration lets a registered SmrtReportCollection
+     * synchronously refresh a stale read. Generic collection reads stay
+     * read-only and report unknown freshness until the lifecycle adapter runs.
+     */
+    mayRefreshOnRead: boolean;
+    ttlMs?: number;
+    triggers: Array<'manual' | 'schedule' | 'change' | 'ttl' | 'job'>;
+    /** Declared only; the lifecycle adapter owns authorization, audit, and run state. */
+    action: ReportRefreshActionDescriptor;
+}
+/** A report-wide lifecycle action, never a mutation performed by this adapter. */
+export interface ReportRefreshActionDescriptor {
+    id: 'refresh';
+    label: 'Refresh report';
+    scope: 'surface';
+    phases: Array<'preview' | 'apply'>;
+    requiresPermission: true;
+    requiredPermission: string;
+    auditRequired: true;
+}
+/**
+ * The report-owned, transport-neutral descriptor. Consumers can map `schema`
+ * to the canonical data-query runtime and `columns` to their presentation
+ * contract without importing smrt-ui or a report domain class.
+ */
+export interface ReportAdapterDescriptor {
+    version: 1;
+    resourceId: string;
+    reportClassName: string;
+    sourceClassName: string;
+    tenantScoped: boolean;
+    tenantField?: string;
+    identityField: 'id';
+    columns: ReportColumnDescriptor[];
+    schema: DataQuerySchema;
+    queryExecution: ReportQueryExecutionDescriptor;
+    dataTable: ReportDataTableDescriptor;
+    drilldown: ReportDrilldownDescriptor;
+    refresh: ReportRefreshDescriptor;
+}
+/**
+ * Delivery choices for the same bounded report query. They never add
+ * authority: a host owns visible state and background-job execution.
+ */
+export type ReportQueryExecutionMode = 'visible' | 'background' | 'silent';
+export interface ReportQueryExecutionDescriptor {
+    modes: ReportQueryExecutionMode[];
+    /** The caller may apply the returned rows to an already-authorized surface. */
+    visible: {
+        delivery: 'result';
+    };
+    /** A host queues the authority-free task and returns no materialized rows yet. */
+    background: {
+        delivery: 'queued';
+        requiresHost: true;
+    };
+    /** The caller receives rows but the adapter makes no visible-surface change. */
+    silent: {
+        delivery: 'result';
+        mutatesVisibleSurface: false;
+    };
+}
+/**
+ * The exact bounded request a background host may persist. Tenant, principal,
+ * collection, database, and display state deliberately remain with that host.
+ */
+export interface ReportBackgroundQueryTask {
+    version: 1;
+    execution: 'background';
+    resourceId: string;
+    reportClassName: string;
+    request: DataQueryRequest;
+    inherits: Array<'principal' | 'tenant' | 'report-definition' | 'field-policy'>;
+}
+/** Queuing a background query returns a handle, never rows from another scope. */
+export interface ReportBackgroundQueryResult {
+    version: 1;
+    execution: 'background';
+    status: 'queued';
+    taskId: string;
+    queryFingerprint: string;
+}
+/** One row value that can safely constrain a source-record drilldown. */
+export interface ReportDrilldownFieldDescriptor {
+    /** Stable report column id; never a display label. */
+    id: string;
+    /** Declared source field/column chosen by report metadata, not caller input. */
+    sourceColumn: string;
+    kind: 'group' | 'bucket';
+    /** A bucket stays declarative so the source adapter preserves report timezone semantics. */
+    bucket?: ReportTimeBucketUnit;
+}
+/**
+ * Declarative source-query handoff for a report row. No client can supply a
+ * principal, tenant, report definition, or arbitrary source field here.
+ */
+export interface ReportDrilldownDescriptor {
+    id: 'drilldown';
+    sourceClassName: string;
+    fields: ReportDrilldownFieldDescriptor[];
+    inherits: Array<'principal' | 'tenant' | 'report-definition' | 'field-policy'>;
+}
+export interface ReportDrilldownConstraint {
+    id: string;
+    sourceColumn: string;
+    kind: 'group' | 'bucket';
+    value: unknown;
+    bucket?: ReportTimeBucketUnit;
+}
+/** A server adapter uses this authority-free handoff to execute a source drilldown. */
+export interface ReportDrilldownQuery {
+    version: 1;
+    resourceId: string;
+    reportClassName: string;
+    sourceClassName: string;
+    constraints: ReportDrilldownConstraint[];
+    inherits: Array<'principal' | 'tenant' | 'report-definition' | 'field-policy'>;
+}
+/** Structural DataTable view hints; deliberately not a smrt-ui dependency. */
+export interface ReportDataTableHeaderPathSegment {
+    /** Stable group identity within a header level. */
+    id: string;
+    /** Human-readable grouped-header label. */
+    label: string;
+}
+/** Responsive metadata that maps directly to a consumer's table contract. */
+export interface ReportDataTableColumnResponsive {
+    /** Higher values make a column more important during responsive collapse. */
+    priority?: number;
+    /** Keep key dimensions reachable during responsive collapse. */
+    keepVisible?: boolean;
+}
+/**
+ * A rendering instruction for a raw materialized value. Formatting is never
+ * applied to a query row, so sorting, export, and agent consumers retain it.
+ */
+export type ReportDataTableValueFormat = 'text' | 'date' | 'datetime' | 'percentage' | 'count' | 'money' | 'number';
+export type ReportDataTableColumnRole = 'data' | 'status' | 'action';
+export interface ReportDataTableColumn {
+    id: string;
+    label: string;
+    accessor: string;
+    sortable: boolean;
+    searchable: false;
+    filterable: boolean;
+    /** Group ancestry for consumers with multi-level table headers. */
+    headerPath: ReportDataTableHeaderPathSegment[];
+    /** Consumer-side display instruction; materialized rows remain raw. */
+    valueFormat: ReportDataTableValueFormat;
+    /** The default alignment for the formatted display value. */
+    align: 'left' | 'right';
+    /** Generic semantic role for status/action columns introduced by later slices. */
+    role: ReportDataTableColumnRole;
+    responsive: ReportDataTableColumnResponsive;
+}
+export type ReportDataTableStructuralRowKind = 'summary' | 'subtotal' | 'aggregate' | 'footer';
+/** Input supplied by a report consumer that computes a summary or subtotal. */
+export interface ReportDataTableStructuralRowInput {
+    id: string;
+    kind: ReportDataTableStructuralRowKind;
+    label: string;
+    /** Raw values keyed by the adapter's stable column id. */
+    values?: Readonly<Record<string, unknown>>;
+    /** Column that renders this row's accessible row header. */
+    labelColumnId?: string;
+}
+/**
+ * Structural rows are intentionally separate from materialized data rows.
+ * Consumers pass them to their DataTable's structural-row slot/prop, never its
+ * selectable data collection.
+ */
+export interface ReportDataTableStructuralRow extends ReportDataTableStructuralRowInput {
+    selection: 'excluded';
+    actions: 'excluded';
+}
+/** Per-column presentation overrides owned by the consuming report surface. */
+export interface ReportDataTableColumnOverride {
+    label?: string;
+    headerPath?: readonly ReportDataTableHeaderPathSegment[];
+    valueFormat?: ReportDataTableValueFormat;
+    align?: 'left' | 'right';
+    role?: ReportDataTableColumnRole;
+    responsive?: ReportDataTableColumnResponsive;
+}
+export interface ReportDataTablePresentationOptions {
+    /** Overrides are keyed by stable adapter column id, not display labels. */
+    columns?: Readonly<Record<string, ReportDataTableColumnOverride>>;
+    /** Summary/subtotal rows remain structural rather than materialized data rows. */
+    structuralRows?: readonly ReportDataTableStructuralRowInput[];
+}
+export interface ReportDataTableDescriptor {
+    rowKey: 'id';
+    manualPagination: true;
+    manualSorting: true;
+    enableFiltering: true;
+    enableSearch: false;
+    columns: ReportDataTableColumn[];
+    structuralRows: ReportDataTableStructuralRow[];
+}
+export interface ReportAdapterOptions {
+    /** Scope used only to make a stable resource id; it is not authority. */
+    tenantScope?: 'current' | 'global' | 'tenant';
+    /** Permission that a lifecycle action host must require before refresh. */
+    refreshPermission?: string;
+    /** Consumer-owned presentational preferences; they never affect query rows. */
+    dataTable?: ReportDataTablePresentationOptions;
+}
+interface ReportQueryCommonOptions {
+    /** Injected collection seam for tests and application-owned adapters. */
+    collection?: {
+        list(options: Record<string, unknown>): Promise<Array<Record<string, unknown>>>;
+        count(options?: Record<string, unknown>): Promise<number>;
+        facets?(options: Record<string, unknown>): Promise<Array<{
+            field: string;
+            values: Array<{
+                value: string | number | boolean | null;
+                count: number;
+            }>;
+        }>>;
+    };
+    db?: import('@happyvertical/sql').DatabaseInterface;
+    /**
+     * Consumer-owned descriptor preferences. They contribute to the stable
+     * resource identity and must match the catalog used to select this report.
+     */
+    adapter?: ReportAdapterOptions;
+    /**
+     * Opt in to a tenant-safe lifecycle snapshot alongside this materialized
+     * read. It never makes a generic read mutate.
+     */
+    lifecycle?: Omit<ReportLifecycleOptions, 'db'>;
+}
+/** Visible is the default; silent has identical data authority but no UI intent. */
+export interface ReportQueryOptions extends ReportQueryCommonOptions {
+    execution?: 'visible' | 'silent';
+}
+/** Background execution is possible only through an application-owned queue host. */
+export interface ReportBackgroundQueryOptions extends ReportQueryCommonOptions {
+    execution: 'background';
+    enqueueBackgroundQuery(task: ReportBackgroundQueryTask): Promise<{
+        taskId: string;
+    }>;
+}
+/** Lifecycle context attached only when a caller explicitly opts in. */
+export interface ReportMaterializedReadLifecycle {
+    snapshot: ReportLifecycleSnapshot;
+    /** Whether this collection read appears to have completed a TTL refresh. */
+    read: 'current' | 'stale' | 'refresh-triggered';
+}
+export interface ReportDataQueryResult extends DataQueryResult {
+    /** Delivery intent only; the adapter never mutates a visible surface. */
+    execution: 'visible' | 'silent';
+    reportLifecycle?: ReportMaterializedReadLifecycle;
+}
+export declare function buildReportAdapterDescriptor(reportCtor: new (...args: any[]) => SmrtObject, options?: ReportAdapterOptions): Promise<ReportAdapterDescriptor>;
+/**
+ * Bind a materialized report row to its declared source dimensions. This is a
+ * query handoff, not an executor: an authenticated source adapter must apply
+ * the inherited principal, tenant, definition, and field policy before it
+ * reads source records.
+ */
+export declare function buildReportDrilldownQuery(reportCtor: new (...args: any[]) => SmrtObject, row: Readonly<Record<string, unknown>>, options?: ReportAdapterOptions): Promise<ReportDrilldownQuery>;
+/**
+ * Split the declared filter language by report semantics for consumers that
+ * construct a live source query. Mixed AND expressions are represented as two
+ * independent clauses; mixed OR/NOT expressions are rejected because moving
+ * either half across WHERE/HAVING would change their meaning.
+ */
+export declare function splitReportFilterScopes(descriptor: ReportAdapterDescriptor, filter: DataQueryFilter | undefined): {
+    where?: DataQueryFilter;
+    having?: DataQueryFilter;
+};
+/**
+ * Execute bounded materialized report reads through the canonical query
+ * envelope. Every predicate is an adapter-declared field/operator pair; the
+ * collection converts it to parameterized SQL and applies tenant interceptors
+ * to list, count, and facet reads alike.
+ */
+export declare function queryReportMaterializedRows(reportCtor: new (...args: any[]) => SmrtObject, input: unknown, options: ReportBackgroundQueryOptions): Promise<ReportBackgroundQueryResult>;
+export declare function queryReportMaterializedRows(reportCtor: new (...args: any[]) => SmrtObject, input: unknown, options?: ReportQueryOptions): Promise<ReportDataQueryResult>;
+/** Read the already-materialized primary key; never use a display/page index. */
+export declare function reportMaterializedRowKey(row: Record<string, unknown>): string;
+export {};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/aggregate.d.ts

@@ -1,25 +1,3 @@
-import { AggregateBuildResult } from '@happyvertical/sql';
-import { AggregateFunction } from '@happyvertical/sql';
-import { AggregateSelectExpr } from '@happyvertical/sql';
-import { AggregateSpec } from '@happyvertical/sql';
-import { AggregateTimeBucketUnit } from '@happyvertical/sql';
-import { bucketExpr } from '@happyvertical/sql';
-import { buildAggregate } from '@happyvertical/sql';
-
-export { AggregateBuildResult }
-
-export { AggregateFunction }
-export { AggregateFunction as ReportAggregateFn }
-
-export { AggregateSelectExpr }
-
-export { AggregateSpec }
-
-export { AggregateTimeBucketUnit }
-export { AggregateTimeBucketUnit as ReportTimeBucketUnit }
-
-export { bucketExpr }
-
-export { buildAggregate }
-
-export { }
+export type { AggregateBuildResult, AggregateFunction, AggregateFunction as ReportAggregateFn, AggregateSelectExpr, AggregateSpec, AggregateTimeBucketUnit, AggregateTimeBucketUnit as ReportTimeBucketUnit, } from '@happyvertical/sql';
+export { bucketExpr, buildAggregate, } from '@happyvertical/sql';
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../src/aggregate.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,IAAI,iBAAiB,EACtC,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,uBAAuB,IAAI,oBAAoB,GAChD,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,cAAc,GACf,MAAM,oBAAoB,CAAC"}

package/dist/compiler.d.ts

@@ -1,78 +1,7 @@
-import { AggregateFunction } from '@happyvertical/sql';
-import { AggregateSpec } from '@happyvertical/sql';
-import { AggregateTimeBucketUnit } from '@happyvertical/sql';
-import { SmrtObject } from '@happyvertical/smrt-core';
-import { WhereClause } from '@happyvertical/sql';
-
-export declare function buildReportDefinition(reportCtor: new (...args: any[]) => SmrtObject): Promise<ReportDefinition>;
-
-export declare function compileReportDefinition(definition: ReportDefinition): AggregateSpec;
-
-export declare function compileReportSpec(reportCtor: new (...args: any[]) => SmrtObject): Promise<AggregateSpec>;
-
-export declare function getReportGroupingColumns(definition: Pick<ReportDefinition, 'fields'>): string[];
-
-declare interface ReportAggregateFieldMetadata {
-    kind: 'aggregate';
-    fn: ReportAggregateFn;
-    column?: string;
-    distinct?: boolean;
-}
-
-declare type ReportAggregateFn = AggregateFunction;
-
-declare interface ReportBucketFieldMetadata {
-    kind: 'bucket';
-    unit: ReportTimeBucketUnit;
-    sourceColumn: string;
-}
-
-declare interface ReportDefinition {
-    reportClassName: string;
-    sourceClassName: string;
-    sourceTable: string;
-    fields: ReportFieldDefinition[];
-    where?: WhereClause;
-    having?: WhereClause;
-    refresh?: ReportRefreshConfig;
-}
-
-declare interface ReportFieldDefinition {
-    fieldName: string;
-    columnName?: string;
-    type?: string;
-    report?: ReportFieldMetadata;
-}
-
-declare type ReportFieldMetadata = ReportGroupFieldMetadata | ReportBucketFieldMetadata | ReportAggregateFieldMetadata;
-
-declare interface ReportGroupFieldMetadata {
-    kind: 'group';
-    sourceColumn?: string;
-}
-
-declare interface ReportRefreshConfig {
-    mode?: ReportRefreshMode;
-    schedule?: string;
-    onChange?: ReportSource[];
-    /**
-     * Milliseconds before collection reads trigger a synchronous refresh.
-     *
-     * TTL refresh checks add a read-time MAX(refreshedAt) query, and stale reads
-     * perform the refresh before returning list/get results.
-     */
-    ttl?: number;
-    manual?: boolean;
-    watermarkColumn?: string;
-    softDeleteColumn?: string;
-    fullRebuildSchedule?: string;
-    tenantFanout?: boolean;
-}
-
-declare type ReportRefreshMode = 'rebuild' | 'incremental';
-
-declare type ReportSource = string | (new (...args: any[]) => SmrtObject) | (abstract new (...args: any[]) => SmrtObject);
-
-declare type ReportTimeBucketUnit = AggregateTimeBucketUnit;
-
-export { }
+import { type SmrtObject } from '@happyvertical/smrt-core';
+import type { AggregateSpec, ReportDefinition } from './types.js';
+export declare function buildReportDefinition(reportCtor: new (...args: any[]) => SmrtObject): Promise<ReportDefinition>;
+export declare function getReportGroupingColumns(definition: Pick<ReportDefinition, 'fields'>): string[];
+export declare function compileReportDefinition(definition: ReportDefinition): AggregateSpec;
+export declare function compileReportSpec(reportCtor: new (...args: any[]) => SmrtObject): Promise<AggregateSpec>;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAI3E,OAAO,KAAK,EAEV,aAAa,EACb,gBAAgB,EAKjB,MAAM,YAAY,CAAC;AAiJpB,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,GAC7C,OAAO,CAAC,gBAAgB,CAAC,CAqC3B;AAoBD,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,GAC3C,MAAM,EAAE,CAQV;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,gBAAgB,GAC3B,aAAa,CAyDf;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,GAC7C,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/decorators.d.ts

@@ -1,90 +1,37 @@
-import { AggregateFunction } from '@happyvertical/sql';
-import { SmrtObject } from '@happyvertical/smrt-core';
-import { WhereClause } from '@happyvertical/sql';
-
-export declare function aggregate(options: AggregateDecoratorOptions): PropertyDecorator;
-
-export declare interface AggregateDecoratorOptions {
-    fn: ReportAggregateFn;
-    column?: string;
-    distinct?: boolean;
-}
-
-export declare const avg: (column?: string, options?: {
-    distinct?: boolean;
-}) => PropertyDecorator;
-
-export declare function count(): PropertyDecorator;
-
-export declare function count(column: string, options?: {
-    distinct?: boolean;
-}): PropertyDecorator;
-
-export declare function count(options: {
-    distinct?: boolean;
-}): PropertyDecorator;
-
-export declare const day: (sourceColumn: string) => PropertyDecorator;
-
-export declare function getRuntimeReportOptions(ctor: Function): ReportOptions | undefined;
-
-export declare function groupBy(sourceColumn?: string): PropertyDecorator;
-
-export declare const hour: (sourceColumn: string) => PropertyDecorator;
-
-export declare const max: (column?: string, options?: {
-    distinct?: boolean;
-}) => PropertyDecorator;
-
-export declare const min: (column?: string, options?: {
-    distinct?: boolean;
-}) => PropertyDecorator;
-
-export declare const minute: (sourceColumn: string) => PropertyDecorator;
-
-export declare const month: (sourceColumn: string) => PropertyDecorator;
-
-export declare const quarter: (sourceColumn: string) => PropertyDecorator;
-
-export declare function report(options: ReportOptions): <T extends abstract new (...args: any[]) => any>(ctor: T) => T;
-
-declare type ReportAggregateFn = AggregateFunction;
-
-declare interface ReportOptions {
-    source: ReportSource;
-    where?: WhereClause;
-    having?: WhereClause;
-    refresh?: ReportRefreshConfig;
-}
-
-declare interface ReportRefreshConfig {
-    mode?: ReportRefreshMode;
-    schedule?: string;
-    onChange?: ReportSource[];
-    /**
-     * Milliseconds before collection reads trigger a synchronous refresh.
-     *
-     * TTL refresh checks add a read-time MAX(refreshedAt) query, and stale reads
-     * perform the refresh before returning list/get results.
-     */
-    ttl?: number;
-    manual?: boolean;
-    watermarkColumn?: string;
-    softDeleteColumn?: string;
-    fullRebuildSchedule?: string;
-    tenantFanout?: boolean;
-}
-
-declare type ReportRefreshMode = 'rebuild' | 'incremental';
-
-declare type ReportSource = string | (new (...args: any[]) => SmrtObject) | (abstract new (...args: any[]) => SmrtObject);
-
-export declare const sum: (column?: string, options?: {
-    distinct?: boolean;
-}) => PropertyDecorator;
-
-export declare const week: (sourceColumn: string) => PropertyDecorator;
-
-export declare const year: (sourceColumn: string) => PropertyDecorator;
-
-export { }
+import type { ReportAggregateFn, ReportOptions } from './types.js';
+export declare function report(options: ReportOptions): <T extends abstract new (...args: any[]) => any>(ctor: T) => T;
+export declare function getRuntimeReportOptions(ctor: Function): ReportOptions | undefined;
+export declare function groupBy(sourceColumn?: string): PropertyDecorator;
+export declare const minute: (sourceColumn: string) => PropertyDecorator;
+export declare const hour: (sourceColumn: string) => PropertyDecorator;
+export declare const day: (sourceColumn: string) => PropertyDecorator;
+export declare const week: (sourceColumn: string) => PropertyDecorator;
+export declare const month: (sourceColumn: string) => PropertyDecorator;
+export declare const quarter: (sourceColumn: string) => PropertyDecorator;
+export declare const year: (sourceColumn: string) => PropertyDecorator;
+export interface AggregateDecoratorOptions {
+    fn: ReportAggregateFn;
+    column?: string;
+    distinct?: boolean;
+}
+export declare function aggregate(options: AggregateDecoratorOptions): PropertyDecorator;
+export declare const sum: (column?: string, options?: {
+    distinct?: boolean;
+}) => PropertyDecorator;
+export declare const avg: (column?: string, options?: {
+    distinct?: boolean;
+}) => PropertyDecorator;
+export declare const min: (column?: string, options?: {
+    distinct?: boolean;
+}) => PropertyDecorator;
+export declare const max: (column?: string, options?: {
+    distinct?: boolean;
+}) => PropertyDecorator;
+export declare function count(): PropertyDecorator;
+export declare function count(column: string, options?: {
+    distinct?: boolean;
+}): PropertyDecorator;
+export declare function count(options: {
+    distinct?: boolean;
+}): PropertyDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,iBAAiB,EAGjB,aAAa,EAEd,MAAM,YAAY,CAAC;AAIpB,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,IACnC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,CAAC,KAAG,CAAC,CAIpE;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,GACb,aAAa,GAAG,SAAS,CAE3B;AAsBD,wBAAgB,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAEhE;AAaD,eAAO,MAAM,MAAM,GAAI,cAAc,MAAM,sBAAmC,CAAC;AAC/E,eAAO,MAAM,IAAI,GAAI,cAAc,MAAM,sBAAiC,CAAC;AAC3E,eAAO,MAAM,GAAG,GAAI,cAAc,MAAM,sBAAgC,CAAC;AACzE,eAAO,MAAM,IAAI,GAAI,cAAc,MAAM,sBAAiC,CAAC;AAC3E,eAAO,MAAM,KAAK,GAAI,cAAc,MAAM,sBAAkC,CAAC;AAC7E,eAAO,MAAM,OAAO,GAAI,cAAc,MAAM,sBACX,CAAC;AAClC,eAAO,MAAM,IAAI,GAAI,cAAc,MAAM,sBAAiC,CAAC;AAE3E,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,iBAAiB,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,yBAAyB,GACjC,iBAAiB,CAOnB;AAOD,eAAO,MAAM,GAAG,YAJG,MAAM,YAAW;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,sBAId,CAAC;AAC7C,eAAO,MAAM,GAAG,YALG,MAAM,YAAW;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,sBAKd,CAAC;AAC7C,eAAO,MAAM,GAAG,YANG,MAAM,YAAW;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,sBAMd,CAAC;AAC7C,eAAO,MAAM,GAAG,YAPG,MAAM,YAAW;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,sBAOd,CAAC;AAE7C,wBAAgB,KAAK,IAAI,iBAAiB,CAAC;AAC3C,wBAAgB,KAAK,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/B,iBAAiB,CAAC;AACrB,wBAAgB,KAAK,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,iBAAiB,CAAC"}