@happyvertical/smrt-reports 0.51.31 → 0.51.33

package/dist/index.d.ts

@@ -1,1276 +1,16 @@
-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';
-import { DatabaseInterface } from '@happyvertical/sql';
-import { DataQueryFieldDescriptor } from '@happyvertical/smrt-types';
-import { DataQueryFilter } from '@happyvertical/smrt-types';
-import { DataQueryFreshness } from '@happyvertical/smrt-types';
-import { DataQueryRequest } from '@happyvertical/smrt-types';
-import { DataQueryResult } from '@happyvertical/smrt-types';
-import { DataQuerySchema } from '@happyvertical/smrt-types';
-import { DataQuerySort } from '@happyvertical/smrt-types';
-import { DurableJobPayloadIntegrity } from '@happyvertical/smrt-jobs';
-import { DurableJobPayloadSigner } from '@happyvertical/smrt-jobs';
-import { EventEmitter } from 'node:events';
-import { JobExecutionContext } from '@happyvertical/smrt-jobs';
-import { SmrtCollection } from '@happyvertical/smrt-core';
-import { SmrtJob } from '@happyvertical/smrt-jobs';
-import { SmrtListOptions } from '@happyvertical/smrt-core';
-import { SmrtObject } from '@happyvertical/smrt-core';
-import { SmrtObjectOptions } from '@happyvertical/smrt-core';
-import { SmrtSelectedRow } from '@happyvertical/smrt-core';
-import { SmrtSelectField } from '@happyvertical/smrt-core';
-import { SmrtStiReadScope } from '@happyvertical/smrt-core';
-import { SqlAdapterType } from '@happyvertical/sql';
-import { WhereClause } from '@happyvertical/sql';
-
-export declare function aggregate(options: AggregateDecoratorOptions): PropertyDecorator;
-
-export { AggregateBuildResult }
-
-declare interface AggregateDecoratorOptions {
-    fn: ReportAggregateFn;
-    column?: string;
-    distinct?: boolean;
-}
-
-export { AggregateSelectExpr }
-
-export { AggregateSpec }
-
-export declare type AppliedReportExport = {
-    phase: 'apply';
-    execution: 'stream';
-    status: 'ready';
-    request: ReportExportRequest;
-} | {
-    phase: 'apply';
-    execution: 'background';
-    status: 'queued';
-    taskId: string;
-    request: ReportExportRequest;
-};
-
-export declare interface AppliedReportRefresh {
-    phase: 'apply';
-    job: ReportRefreshJobHandle;
-}
-
-/**
- * Queue large exports without embedding rows in a browser/agent response.
- * A host must verify current principal, tenant, report definition, and field
- * policy again before it renders or serves the artifact.
- */
-export declare function applyReportExport(descriptor: ReportAdapterDescriptor, request: ReportExportRequest, host: ReportExportActionHost, options?: {
-    confirmed?: boolean;
-}): Promise<AppliedReportExport>;
-
-/** Queue a manual refresh only after the action host authorizes and audits it. */
-export declare function applyReportRefresh(reportCtor: ReportCtor, options: ApplyReportRefreshOptions): Promise<AppliedReportRefresh>;
-
-export declare interface ApplyReportRefreshOptions extends PreviewReportRefreshOptions {
-    jobIntegritySigner?: DurableJobPayloadSigner;
-    queue?: string;
-    priority?: number;
-    timeout?: number;
-    maxAttempts?: number;
-    tenantJobCap?: number;
-}
-
-export declare function assertReportTablesReady(db: DatabaseInterface, tables?: readonly string[]): Promise<void>;
-
-export declare const avg: (column?: string, options?: {
-    distinct?: boolean;
-}) => PropertyDecorator;
-
-export { bucketExpr }
-
-export { buildAggregate }
-
-export declare function buildReportAdapterDescriptor(reportCtor: new (...args: any[]) => SmrtObject, options?: ReportAdapterOptions): Promise<ReportAdapterDescriptor>;
-
-export declare function buildReportDefinition(reportCtor: new (...args: any[]) => SmrtObject): Promise<ReportDefinition>;
-
-/**
- * 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>;
-
-export declare function compileReportDefinition(definition: ReportDefinition): AggregateSpec;
-
-export declare function compileReportSpec(reportCtor: new (...args: any[]) => SmrtObject): Promise<AggregateSpec>;
-
-export declare function count(): PropertyDecorator;
-
-export declare function count(column: string, options?: {
-    distinct?: boolean;
-}): PropertyDecorator;
-
-export declare function count(options: {
-    distinct?: boolean;
-}): PropertyDecorator;
-
-/**
- * Build one bounded page of the immutable export read. The host applies the
- * opaque snapshot binding separately; this function preserves the frozen
- * projection, predicate, and deterministic sort while replacing only visible
- * pagination. A zero-row export therefore has no pages to execute.
- */
-export declare function createReportExportPageRequest(descriptor: ReportAdapterDescriptor, request: ReportExportRequest, offset: number): DataQueryRequest;
-
-/**
- * Build one common request for both agent and human export clients. The
- * resulting request carries no actor, tenant, storage location, or token.
- */
-export declare function createReportExportRequest(descriptor: ReportAdapterDescriptor, snapshot: ReportExportSnapshot, value: unknown): ReportExportRequest;
-
-/**
- * Freeze a previously executed materialized read for export. The caller must
- * supply the exact request and a result that exposes lifecycle freshness; an
- * export never invents an as-of value or accepts a caller-supplied tenant.
- */
-export declare function createReportExportSnapshot(descriptor: ReportAdapterDescriptor, input: unknown, result: Pick<DataQueryResult, 'queryFingerprint' | 'identityField' | 'total' | 'freshness' | 'truncated'> & Pick<ReportDataQueryResult, 'reportLifecycle'>, binding: unknown): ReportExportSnapshot;
-
-export declare const day: (sourceColumn: string) => PropertyDecorator;
-
-export declare function enqueueReportRefresh(options: EnqueueReportRefreshOptions): Promise<SmrtJob>;
-
-export declare interface EnqueueReportRefreshOptions extends ReportRefreshJobArgs {
-    report?: ReportCtor_3;
-    reportClass: string;
-    db: DatabaseInterface;
-    queue?: string;
-    priority?: number;
-    timeout?: number;
-    maxAttempts?: number;
-    tenantJobCap?: number;
-    /** Server-only signer; register the same key in every worker process. */
-    integritySigner?: DurableJobPayloadSigner;
-}
-
-export declare function ensureReportRefreshSchedules(options: EnsureReportSchedulesOptions): Promise<void>;
-
-export declare interface EnsureReportSchedulesOptions {
-    db: DatabaseInterface;
-    reports: ReportCtor_3[];
-    tenantIds?: string[];
-    queue?: string;
-    priority?: number;
-    timeout?: number;
-}
-
-export declare function getReportGroupingColumns(definition: Pick<ReportDefinition, 'fields'>): string[];
-
-/**
- * Read only the ambient tenant's report state. The caller cannot supply a
- * tenant selector, which prevents lifecycle lookup from becoming a tenant
- * enumeration surface.
- */
-export declare function getReportLifecycle(reportCtor: ReportCtor, options: ReportLifecycleOptions): Promise<ReportLifecycleSnapshot>;
-
-export declare function getRuntimeReportOptions(ctor: Function): ReportOptions | undefined;
-
-export declare function groupBy(sourceColumn?: string): PropertyDecorator;
-
-export declare const hour: (sourceColumn: string) => PropertyDecorator;
-
-declare const INHERITED_REPORT_SCOPE: readonly ["principal", "tenant", "report-definition", "field-policy"];
-
-export declare const max: (column?: string, options?: {
-    distinct?: boolean;
-}) => PropertyDecorator;
-
-/**
- * Version 0 is the original unversioned persisted layout shape. It contains
- * the same allowlisted fields as v1, so the migration only records the schema
- * version; current descriptor normalization still revalidates every field.
- */
-export declare function migrateReportSavedView(value: unknown): SavedViewInput;
-
-export declare const min: (column?: string, options?: {
-    distinct?: boolean;
-}) => PropertyDecorator;
-
-export declare const minute: (sourceColumn: string) => PropertyDecorator;
-
-export declare const month: (sourceColumn: string) => PropertyDecorator;
-
-/**
- * Normalize a view both when it is saved and when it is restored. Re-running
- * this against the live descriptor is what prevents a former field/action
- * grant from surviving a policy or definition change.
- */
-export declare function normalizeReportSavedView(descriptor: ReportAdapterDescriptor, value: unknown): ReportSavedView;
-
-export declare function previewReportExport(descriptor: ReportAdapterDescriptor, request: ReportExportRequest, host: ReportExportActionHost): Promise<ReportExportPreview>;
-
-/** Preview only declares a separately authorized and audited refresh request. */
-export declare function previewReportRefresh(reportCtor: ReportCtor, options: PreviewReportRefreshOptions): Promise<ReportRefreshPreview>;
-
-export declare interface PreviewReportRefreshOptions extends ReportLifecycleOptions {
-    host: ReportRefreshActionHost;
-    mode?: ReportRefreshMode;
-    /**
-     * Pass `descriptor.refresh.action` when the adapter declares a custom
-     * refresh permission, so the displayed and enforced action stay aligned.
-     */
-    refreshAction?: Pick<ReportRefreshActionDescriptor, 'requiredPermission'>;
-}
-
-export declare const quarter: (sourceColumn: string) => PropertyDecorator;
-
-/**
- * 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>;
-
-export declare function refreshReport(reportCtor: ReportCtor_2, options?: ReportRefreshOptions): Promise<ReportRefreshResult>;
-
-export declare function registerReportRefreshExecutionAuthorityHost(hostId: string, host: ReportRefreshExecutionAuthorityHost): () => void;
-
-export declare function registerReportRefreshInterceptor(options: ReportRefreshInterceptorOptions): () => boolean;
-
-export declare function registerReportRefreshJobIntegritySigner(signer: DurableJobPayloadSigner): () => void;
-
-export declare function report(options: ReportOptions): <T extends abstract new (...args: any[]) => any>(ctor: T) => T;
-
-export declare const REPORT_LOCKS_TABLE = "_smrt_report_locks";
-
-export declare const REPORT_REFRESH_TASKS_TABLE = "_smrt_report_refresh_tasks";
-
-export declare const REPORT_RUNS_TABLE = "_smrt_report_runs";
-
-export declare const REPORT_RUNTIME_TABLES: readonly ["_smrt_report_runs", "_smrt_report_watermarks", "_smrt_report_locks"];
-
-export declare const REPORT_SCHEDULER_TABLES: readonly ["_smrt_report_schedules", "_smrt_report_refresh_tasks"];
-
-export declare const REPORT_SCHEDULES_TABLE = "_smrt_report_schedules";
-
-export declare const REPORT_WATERMARKS_TABLE = "_smrt_report_watermarks";
-
-/**
- * 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 declare 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;
-}
-
-export declare 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;
-}
-
-export declare interface ReportAggregateFieldMetadata {
-    kind: 'aggregate';
-    fn: ReportAggregateFn;
-    column?: string;
-    distinct?: boolean;
-}
-
-export declare type ReportAggregateFn = AggregateFunction;
-
-/**
- * An authority-free job handoff. The queue must re-enter the bound principal
- * and tenant, resolve the current report definition/field policy, and verify
- * this snapshot before materializing an artifact.
- */
-export declare interface ReportBackgroundExportTask {
-    version: 1;
-    execution: 'background';
-    request: ReportExportRequest;
-    inherits: Array<(typeof INHERITED_REPORT_SCOPE)[number]>;
-}
-
-/** Background execution is possible only through an application-owned queue host. */
-export declare interface ReportBackgroundQueryOptions extends ReportQueryCommonOptions {
-    execution: 'background';
-    enqueueBackgroundQuery(task: ReportBackgroundQueryTask): Promise<{
-        taskId: string;
-    }>;
-}
-
-/** Queuing a background query returns a handle, never rows from another scope. */
-export declare interface ReportBackgroundQueryResult {
-    version: 1;
-    execution: 'background';
-    status: 'queued';
-    taskId: string;
-    queryFingerprint: string;
-}
-
-/**
- * The exact bounded request a background host may persist. Tenant, principal,
- * collection, database, and display state deliberately remain with that host.
- */
-export declare interface ReportBackgroundQueryTask {
-    version: 1;
-    execution: 'background';
-    resourceId: string;
-    reportClassName: string;
-    request: DataQueryRequest;
-    inherits: Array<'principal' | 'tenant' | 'report-definition' | 'field-policy'>;
-}
-
-export declare interface ReportBucketFieldMetadata {
-    kind: 'bucket';
-    unit: ReportTimeBucketUnit;
-    sourceColumn: string;
-}
-
-export declare type ReportColumnCapability = 'read' | 'project' | 'filter' | 'sort' | 'facet' | 'group' | 'aggregate';
-
-export declare 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 declare type ReportColumnKind = 'identity' | 'group' | 'bucket' | 'aggregate';
-
-/** Presentation and policy metadata understood by the report adapter. */
-export declare type ReportColumnSensitivity = 'public' | 'personal' | 'sensitive' | 'secret';
-
-declare type ReportCtor = new (...args: any[]) => SmrtObject;
-
-declare type ReportCtor_2 = new (...args: any[]) => SmrtObject;
-
-declare type ReportCtor_3 = new (...args: any[]) => SmrtObject;
-
-export declare interface ReportDataQueryResult extends DataQueryResult {
-    /** Delivery intent only; the adapter never mutates a visible surface. */
-    execution: 'visible' | 'silent';
-    reportLifecycle?: ReportMaterializedReadLifecycle;
-}
-
-export declare 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;
-}
-
-/** Per-column presentation overrides owned by the consuming report surface. */
-export declare interface ReportDataTableColumnOverride {
-    label?: string;
-    headerPath?: readonly ReportDataTableHeaderPathSegment[];
-    valueFormat?: ReportDataTableValueFormat;
-    align?: 'left' | 'right';
-    role?: ReportDataTableColumnRole;
-    responsive?: ReportDataTableColumnResponsive;
-}
-
-/** Responsive metadata that maps directly to a consumer's table contract. */
-export declare interface ReportDataTableColumnResponsive {
-    /** Higher values make a column more important during responsive collapse. */
-    priority?: number;
-    /** Keep key dimensions reachable during responsive collapse. */
-    keepVisible?: boolean;
-}
-
-export declare type ReportDataTableColumnRole = 'data' | 'status' | 'action';
-
-export declare interface ReportDataTableDescriptor {
-    rowKey: 'id';
-    manualPagination: true;
-    manualSorting: true;
-    enableFiltering: true;
-    enableSearch: false;
-    columns: ReportDataTableColumn[];
-    structuralRows: ReportDataTableStructuralRow[];
-}
-
-/** Structural DataTable view hints; deliberately not a smrt-ui dependency. */
-export declare interface ReportDataTableHeaderPathSegment {
-    /** Stable group identity within a header level. */
-    id: string;
-    /** Human-readable grouped-header label. */
-    label: string;
-}
-
-export declare 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[];
-}
-
-/**
- * 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 declare interface ReportDataTableStructuralRow extends ReportDataTableStructuralRowInput {
-    selection: 'excluded';
-    actions: 'excluded';
-}
-
-/** Input supplied by a report consumer that computes a summary or subtotal. */
-export declare 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;
-}
-
-export declare type ReportDataTableStructuralRowKind = 'summary' | 'subtotal' | 'aggregate' | 'footer';
-
-/**
- * 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 declare type ReportDataTableValueFormat = 'text' | 'date' | 'datetime' | 'percentage' | 'count' | 'money' | 'number';
-
-export declare interface ReportDefinition {
-    reportClassName: string;
-    sourceClassName: string;
-    sourceTable: string;
-    fields: ReportFieldDefinition[];
-    where?: WhereClause;
-    having?: WhereClause;
-    refresh?: ReportRefreshConfig;
-}
-
-/**
- * A change to report fields, their capabilities, schema, scope, or source
- * invalidates a stored view/export snapshot rather than silently widening it.
- */
-export declare function reportDefinitionFingerprint(descriptor: ReportAdapterDescriptor): string;
-
-export declare interface ReportDrilldownConstraint {
-    id: string;
-    sourceColumn: string;
-    kind: 'group' | 'bucket';
-    value: unknown;
-    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 declare interface ReportDrilldownDescriptor {
-    id: 'drilldown';
-    sourceClassName: string;
-    fields: ReportDrilldownFieldDescriptor[];
-    inherits: Array<'principal' | 'tenant' | 'report-definition' | 'field-policy'>;
-}
-
-/** One row value that can safely constrain a source-record drilldown. */
-export declare 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;
-}
-
-/** A server adapter uses this authority-free handoff to execute a source drilldown. */
-export declare interface ReportDrilldownQuery {
-    version: 1;
-    resourceId: string;
-    reportClassName: string;
-    sourceClassName: string;
-    constraints: ReportDrilldownConstraint[];
-    inherits: Array<'principal' | 'tenant' | 'report-definition' | 'field-policy'>;
-}
-
-export declare interface ReportExecutionPrincipalReference {
-    version: 1;
-    actorUserId: string;
-    tenantId: string | null;
-    onBehalfOfUserId?: string | null;
-    actsAsProfileId?: string | null;
-    agentClass?: string | null;
-}
-
-export declare interface ReportExportActionContext {
-    phase: 'preview' | 'apply';
-    reportClassName: string;
-    resourceId: string;
-    requiredPermission: string;
-    confirmationRequired: boolean;
-    execution: 'stream' | 'background';
-    queryFingerprint: string;
-    definitionFingerprint: string;
-    snapshotId: string;
-    asOf: string;
-    pageSize: number;
-}
-
-/** The same host is used by human and agent callers. */
-export declare interface ReportExportActionHost {
-    /**
-     * Prove that this opaque binding still resolves to the exact immutable
-     * materialization snapshot under the host's current principal and tenant.
-     * The background worker must call `validateReportExportExecution()` again
-     * before reading or serving any rows.
-     */
-    assertSnapshot(context: ReportExportSnapshotContext): Promise<void> | void;
-    authorize(context: ReportExportActionContext): Promise<void> | void;
-    audit(context: ReportExportActionContext): Promise<void> | void;
-    enqueue?(task: ReportBackgroundExportTask): Promise<{
-        taskId: string;
-    }> | {
-        taskId: string;
-    };
-}
-
-/**
- * Artifact metadata is deliberately URL- and token-free. An application-owned
- * serving boundary must authorize every download using the caller's current
- * principal and tenant before it reveals any artifact location.
- */
-export declare interface ReportExportArtifact {
-    id: string;
-    request: ReportExportRequest;
-    progress: ReportExportProgress;
-    expiresAt: string;
-}
-
-export declare type ReportExportFormat = 'csv' | 'json';
-
-/** Every export is bounded before it is streamed or delegated to a worker. */
-export declare interface ReportExportLimits {
-    maxRows: number;
-    maxBytes: number;
-    deadlineMs: number;
-    /** Exports above this exact row count must use the application queue. */
-    foregroundRowLimit: number;
-}
-
-export declare interface ReportExportPreview {
-    phase: 'preview';
-    action: ReportExportActionContext;
-    request: ReportExportRequest;
-}
-
-export declare interface ReportExportProgress {
-    state: 'queued' | 'running' | 'completed' | 'failed';
-    rowCount: number;
-    byteCount: number;
-    truncated: boolean;
-}
-
-/**
- * A deterministic offset-page plan over the immutable host snapshot. A worker
- * starts at offset zero and advances by `page.limit` until `rowCount` rows have
- * been produced or the byte/deadline limits are reached.
- */
-export declare interface ReportExportReadPlan {
-    snapshotId: string;
-    queryFingerprint: string;
-    asOf: string;
-    page: {
-        kind: 'offset';
-        offset: 0;
-        limit: number;
-    };
-}
-
-export declare interface ReportExportRequest {
-    version: 1;
-    format: ReportExportFormat;
-    execution: 'stream' | 'background';
-    snapshot: ReportExportSnapshot;
-    limits: ReportExportLimits;
-    read: ReportExportReadPlan;
-    rowCount: number;
-    truncated: boolean;
-    action: {
-        id: 'export';
-        requiredPermission: string;
-        auditRequired: true;
-        confirmationRequired: boolean;
-    };
-}
-
-export declare interface ReportExportSnapshot {
-    version: 1;
-    resourceId: string;
-    reportClassName: string;
-    definitionFingerprint: string;
-    binding: ReportExportSnapshotBinding;
-    request: DataQueryRequest;
-    queryFingerprint: string;
-    projection: string[];
-    sort: DataQuerySort[];
-    freshness: DataQueryFreshness;
-    snapshot: {
-        asOf: string;
-        refreshedAt?: string;
-        stale: boolean;
-    };
-    total: {
-        kind: 'exact';
-        value: number;
-    };
-    inherits: Array<(typeof INHERITED_REPORT_SCOPE)[number]>;
-}
-
-/**
- * Opaque identity of a host-captured materialization snapshot. The application
- * creates and verifies it while bound to its principal and tenant; callers
- * cannot turn an `asOf` label into a snapshot by supplying this id alone.
- */
-export declare interface ReportExportSnapshotBinding {
-    id: string;
-}
-
-export declare interface ReportExportSnapshotContext {
-    bindingId: string;
-    resourceId: string;
-    reportClassName: string;
-    definitionFingerprint: string;
-    queryFingerprint: string;
-    asOf: string;
-}
-
-export declare interface ReportFieldDefinition {
-    fieldName: string;
-    columnName?: string;
-    type?: string;
-    report?: ReportFieldMetadata;
-}
-
-export declare type ReportFieldMetadata = ReportGroupFieldMetadata | ReportBucketFieldMetadata | ReportAggregateFieldMetadata;
-
-/**
- * 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 declare type ReportFilterScope = 'where' | 'having';
-
-export declare interface ReportGroupFieldMetadata {
-    kind: 'group';
-    sourceColumn?: string;
-}
-
-export declare interface ReportLifecycleOptions {
-    db: DatabaseInterface;
-    /** Test seam; production callers use the current clock. */
-    now?: Date;
-}
-
-export declare interface ReportLifecycleRun {
-    id: string;
-    status: 'running' | 'success' | 'failed' | 'skipped';
-    mode: ReportRefreshMode;
-    trigger: ReportRefreshTrigger;
-    startedAt?: string;
-    completedAt?: string;
-    rowCount: number;
-    changedGroupCount: number;
-    /** A failed run is safe to retry through the separately permissioned action. */
-    mayRetry: boolean;
-}
-
-/**
- * Transport-neutral report lifecycle state. It deliberately never includes a
- * lock owner, a raw failure message, or tenant fanout identifiers.
- */
-export declare interface ReportLifecycleSnapshot {
-    version: 1;
-    state: ReportLifecycleState;
-    asOf?: string;
-    refreshedAt?: string;
-    /** Whether existing materialized rows can remain visible while work changes state. */
-    hasUsableRows: boolean;
-    mode: ReportRefreshMode;
-    run?: ReportLifecycleRun;
-    /** A stable, redacted failure signal; raw executor errors stay server-side. */
-    failure?: {
-        code: 'refresh_failed';
-        retryable: true;
-    };
-    lock: {
-        held: boolean;
-        expiresAt?: string;
-    };
-}
-
-export declare type ReportLifecycleState = 'current' | 'stale' | 'refreshing' | 'lock-skipped' | 'failed';
-
-/** Lifecycle context attached only when a caller explicitly opts in. */
-export declare interface ReportMaterializedReadLifecycle {
-    snapshot: ReportLifecycleSnapshot;
-    /** Whether this collection read appears to have completed a TTL refresh. */
-    read: 'current' | 'stale' | 'refresh-triggered';
-}
-
-/** Read the already-materialized primary key; never use a display/page index. */
-export declare function reportMaterializedRowKey(row: Record<string, unknown>): string;
-
-export declare interface ReportOptions {
-    source: ReportSource;
-    where?: WhereClause;
-    having?: WhereClause;
-    refresh?: ReportRefreshConfig;
-}
-
-declare 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?: 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'>;
-}
-
-export declare 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;
-    };
-}
-
-/**
- * Delivery choices for the same bounded report query. They never add
- * authority: a host owns visible state and background-job execution.
- */
-export declare type ReportQueryExecutionMode = 'visible' | 'background' | 'silent';
-
-/** Visible is the default; silent has identical data authority but no UI intent. */
-export declare interface ReportQueryOptions extends ReportQueryCommonOptions {
-    execution?: 'visible' | 'silent';
-}
-
-export declare interface ReportRefreshActionContext {
-    phase: 'preview' | 'apply';
-    reportClassName: string;
-    /** The action always applies to the caller's already-bound tenant scope. */
-    tenantScope: 'ambient';
-    mode: ReportRefreshMode;
-    requiredPermission: string;
-}
-
-/** A report-wide lifecycle action, never a mutation performed by this adapter. */
-export declare interface ReportRefreshActionDescriptor {
-    id: 'refresh';
-    label: 'Refresh report';
-    scope: 'surface';
-    phases: Array<'preview' | 'apply'>;
-    requiresPermission: true;
-    requiredPermission: string;
-    auditRequired: true;
-}
-
-/** Authority and audit stay with the application action host, not reports. */
-export declare interface ReportRefreshActionHost {
-    authorize(context: ReportRefreshActionContext, authority?: ReportRefreshExecutionAuthority): Promise<void> | void;
-    audit(context: ReportRefreshActionContext, authority?: ReportRefreshExecutionAuthority): Promise<void> | void;
-    /** Capture only a non-secret identity reference for worker-time reauthorization. */
-    executionAuthority?(context: ReportRefreshActionContext): ReportRefreshExecutionAuthority | Promise<ReportRefreshExecutionAuthority>;
-    /** Server-only signer shared with report worker processes. */
-    jobIntegritySigner?(context: ReportRefreshActionContext): DurableJobPayloadSigner | Promise<DurableJobPayloadSigner>;
-}
-
-export 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;
-}
-
-export declare 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;
-}
-
-export declare interface ReportRefreshExecutionAuditEvent extends ReportRefreshExecutionAuthorityContext {
-    outcome: 'allowed' | 'denied';
-    principal: ReportExecutionPrincipalReference;
-    reason?: string;
-}
-
-export declare interface ReportRefreshExecutionAuthority {
-    version: 1;
-    hostId: string;
-    principal: ReportExecutionPrincipalReference;
-}
-
-export declare interface ReportRefreshExecutionAuthorityContext {
-    phase: 'execute';
-    reportClass: string;
-    mode: ReportRefreshMode;
-    trigger: ReportRefreshTrigger;
-    tenantId: string | null;
-}
-
-export declare interface ReportRefreshExecutionAuthorityHost {
-    authorize(principal: Readonly<ReportExecutionPrincipalReference>, context: Readonly<ReportRefreshExecutionAuthorityContext>): Promise<void> | void;
-    audit(event: Readonly<ReportRefreshExecutionAuditEvent>): Promise<void> | void;
-}
-
-export declare interface ReportRefreshInterceptorOptions {
-    db: DatabaseInterface;
-    reports: ReportCtor_3[];
-    enqueue?: boolean;
-    queue?: string;
-    priority?: number;
-    timeout?: number;
-    tenantJobCap?: number;
-    name?: string;
-    integritySigner?: DurableJobPayloadSigner;
-}
-
-export declare interface ReportRefreshJobArgs {
-    reportClass?: string;
-    mode?: ReportRefreshMode;
-    trigger?: ReportRefreshTrigger;
-    tenantId?: string | null;
-    tenantIds?: string[];
-    scheduleId?: string;
-    adapterType?: SqlAdapterType;
-    changedRows?: Record<string, unknown>[];
-    _scheduleId?: string;
-    executionAuthority?: ReportRefreshExecutionAuthority;
-    integrity?: DurableJobPayloadIntegrity;
-}
-
-export declare interface ReportRefreshJobHandle {
-    jobId: string;
-    status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
-    attempts: number;
-    maxAttempts: number;
-    /** Bounded polling guidance; this API does not create a second queue. */
-    pollAfterMs: number;
-}
-
-export declare type ReportRefreshMode = 'rebuild' | 'incremental';
-
-export declare interface ReportRefreshOptions {
-    db?: DatabaseInterface;
-    mode?: ReportRefreshMode;
-    adapterType?: SqlAdapterType;
-    trigger?: ReportRefreshTrigger;
-    tenantId?: string | null;
-    tenantIds?: string[];
-    lock?: boolean;
-    lockTtlMs?: number;
-    trackRuns?: boolean;
-    scheduleId?: string;
-    changedRows?: Record<string, unknown>[];
-}
-
-export declare interface ReportRefreshOutcome {
-    state: 'current' | 'lock-skipped' | 'partial';
-    rowCount: number;
-    changedGroupCount: number;
-    completedScopes: number;
-    lockSkippedScopes: number;
-    mode: ReportRefreshMode;
-    refreshedAt: string;
-    runId?: string;
-}
-
-/** Normalize executor results without exposing the tenant identifiers in a fanout. */
-export declare function reportRefreshOutcome(result: ReportRefreshResult): ReportRefreshOutcome;
-
-export declare interface ReportRefreshPreview {
-    phase: 'preview';
-    lifecycle: ReportLifecycleSnapshot;
-    action: ReportRefreshActionContext;
-    execution: 'background';
-}
-
-export declare interface ReportRefreshResult {
-    rowCount: number;
-    refreshedAt: Date;
-    mode: ReportRefreshMode;
-    tenantId?: string | null;
-    runId?: string;
-    changedGroupCount?: number;
-    skipped?: boolean;
-    tenantResults?: ReportRefreshResult[];
-}
-
-export declare type ReportRefreshTrigger = 'manual' | 'schedule' | 'change' | 'ttl' | 'job';
-
-export declare function reportRowIdentity(row: Record<string, any>, definition: ReportDefinition): string;
-
-declare type ReportRunStatus = 'running' | 'success' | 'failed' | 'skipped';
-
-/**
- * A normalized, policy-neutral stored view. The storage host associates it
- * with its owner and tenant; neither identity is accepted here.
- */
-export declare interface ReportSavedView {
-    version: 1;
-    id: string;
-    title: string;
-    resourceId: string;
-    reportClassName: string;
-    definitionFingerprint: string;
-    query: DataQueryRequest;
-    columns: ReportSavedViewColumn[];
-    grouping?: ReportSavedViewGrouping;
-    display?: ReportSavedViewDisplay;
-}
-
-/** A view's column order is its array order; ids are always adapter-defined. */
-export declare interface ReportSavedViewColumn {
-    id: string;
-    width?: number;
-    pinned?: ReportSavedViewPinnedSide;
-}
-
-export declare interface ReportSavedViewDisplay {
-    density: 'compact' | 'comfortable';
-    showTotals?: boolean;
-}
-
-export declare interface ReportSavedViewGrouping {
-    fields: string[];
-    expanded?: boolean;
-}
-
-export declare type ReportSavedViewPinnedSide = 'start' | 'end';
-
-export declare interface ReportScheduleInfo {
-    id: string;
-    reportClass: string;
-    tenantId: string | null;
-    cron: string;
-    mode: ReportRefreshMode;
-}
-
-export declare class ReportScheduleRunner extends EventEmitter {
-    readonly id: string;
-    private readonly config;
-    private db;
-    private running;
-    private pollTimer;
-    constructor(config?: ReportScheduleRunnerConfig);
-    initialize(db: DatabaseInterface): Promise<void>;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    isRunning(): boolean;
-    handleJobCompletion(scheduleId: string, success: boolean, errorMessage?: string): Promise<void>;
-    private startPolling;
-    poll(): Promise<void>;
-    private triggerSchedule;
-}
-
-export declare interface ReportScheduleRunnerConfig {
-    id?: string;
-    pollInterval?: number;
-    batchSize?: number;
-    integritySigner?: DurableJobPayloadSigner;
-}
-
-export declare interface ReportScheduleRunnerEvents {
-    'schedule:triggered': (schedule: ReportScheduleInfo) => void;
-    'schedule:error': (schedule: ReportScheduleInfo, error: Error) => void;
-    'schedule:completed': (scheduleId: string) => void;
-    'schedule:failed': (scheduleId: string, error: string) => void;
-    'runner:started': () => void;
-    'runner:stopped': () => void;
-    'runner:error': (error: Error) => void;
-}
-
-declare type ReportScheduleStatus = 'active' | 'paused' | 'disabled' | 'error';
-
-export declare type ReportSource = string | (new (...args: any[]) => SmrtObject) | (abstract new (...args: any[]) => SmrtObject);
-
-export declare class ReportSurfaceValidationError extends Error {
-    constructor(message: string);
-}
-
-export declare type ReportTimeBucketUnit = AggregateTimeBucketUnit;
-
-/** Restore through current policy rather than trusting a stored JSON record. */
-export declare function restoreReportSavedView(descriptor: ReportAdapterDescriptor, savedView: ReportSavedView): ReportSavedView;
-
-declare interface SavedViewInput {
-    version?: unknown;
-    id: unknown;
-    title: unknown;
-    resourceId?: unknown;
-    reportClassName?: unknown;
-    definitionFingerprint?: unknown;
-    query: unknown;
-    columns?: unknown;
-    grouping?: unknown;
-    display?: unknown;
-}
-
-export declare function scopeKeyForTenant(tenantId: string | null | undefined): string;
-
-/** Worker target whose authority requirement cannot be downgraded by job args. */
-export declare class SmrtPrincipalReportRefreshTask extends SmrtReportRefreshTask {
-    run(args?: ReportRefreshJobArgs, context?: JobExecutionContext): Promise<unknown>;
-}
-
-export declare class SmrtReport extends SmrtObject {
-    static readonly _isReportBase: true;
-    refreshedAt: Date | null;
-    constructor(options?: SmrtObjectOptions);
-    isStale(ttlMs?: number): boolean;
-    refresh(options?: Omit<ReportRefreshOptions, 'db'>): Promise<ReportRefreshResult>;
-}
-
-export declare class SmrtReportCollection<ModelType extends SmrtReport> extends SmrtCollection<ModelType> {
-    private refreshIfStale;
-    refresh(options?: Omit<ReportRefreshOptions, 'db'>): Promise<ReportRefreshResult>;
-    list<const Select extends readonly SmrtSelectField<ModelType>[]>(options: Omit<SmrtListOptions<ModelType>, 'select' | 'stiScope'> & {
-        select: Select;
-        include?: never;
-        stiScope: SmrtStiReadScope;
-    }): Promise<Record<string, unknown>[]>;
-    list<const Select extends readonly SmrtSelectField<ModelType>[]>(options: Omit<SmrtListOptions<ModelType>, 'select' | 'stiScope'> & {
-        select: Select;
-        include?: never;
-        stiScope?: undefined;
-    }): Promise<SmrtSelectedRow<ModelType, Select>[]>;
-    list(options: Omit<SmrtListOptions<ModelType>, 'select' | 'stiScope'> & {
-        select?: undefined;
-        stiScope: SmrtStiReadScope;
-    }): Promise<SmrtObject[]>;
-    list(options?: undefined): Promise<ModelType[]>;
-    list(options: Omit<SmrtListOptions<ModelType>, 'select' | 'stiScope'> & {
-        select?: undefined;
-        stiScope?: undefined;
-    }): Promise<ModelType[]>;
-    list(options: (Omit<SmrtListOptions<ModelType>, 'select'> & {
-        select?: undefined;
-    }) | undefined): Promise<SmrtObject[]>;
-    list(options: SmrtListOptions<ModelType> | undefined): Promise<SmrtObject[] | Record<string, unknown>[]>;
-    get(filter: Parameters<SmrtCollection<ModelType>['get']>[0], options?: Parameters<SmrtCollection<ModelType>['get']>[1]): Promise<ModelType | null>;
-}
-
-export declare class SmrtReportLock extends SmrtObject {
-    tenantId: string | null;
-    scopeKey: string;
-    reportClass: string;
-    ownerId: string | null;
-    acquiredAt: Date | null;
-    heartbeatAt: Date | null;
-    expiresAt: Date | null;
-}
-
-export declare class SmrtReportLockCollection extends SmrtCollection<SmrtReportLock> {
-    static readonly _itemClass: typeof SmrtReportLock;
-}
-
-export declare class SmrtReportRefreshTask extends SmrtObject {
-    tenantId: string | null;
-    reportClass: string;
-    mode: ReportRefreshMode;
-    trigger: ReportRefreshTrigger;
-    args: ReportRefreshJobArgs;
-    run(args?: ReportRefreshJobArgs, context?: JobExecutionContext): Promise<unknown>;
-}
-
-export declare class SmrtReportRun extends SmrtObject {
-    tenantId: string | null;
-    scopeKey: string;
-    reportClass: string;
-    sourceClass: string;
-    mode: ReportRefreshMode;
-    trigger: ReportRefreshTrigger;
-    status: ReportRunStatus;
-    startedAt: Date;
-    completedAt: Date | null;
-    rowCount: number;
-    changedGroupCount: number;
-    watermarkBefore: string | null;
-    watermarkAfter: string | null;
-    error: string | null;
-    metadata: Record<string, unknown>;
-}
-
-export declare class SmrtReportRunCollection extends SmrtCollection<SmrtReportRun> {
-    static readonly _itemClass: typeof SmrtReportRun;
-}
-
-export declare class SmrtReportSchedule extends SmrtObject {
-    tenantId: string | null;
-    scopeKey: string;
-    reportClass: string;
-    cron: string;
-    trigger: ReportRefreshTrigger;
-    mode: ReportRefreshMode;
-    enabled: boolean;
-    status: ReportScheduleStatus;
-    nextRun: Date | null;
-    lastRun: Date | null;
-    lastStatus: 'success' | 'failed' | null;
-    lastError: string | null;
-    runCount: number;
-    successCount: number;
-    failureCount: number;
-    runningCount: number;
-    maxConcurrent: number;
-    queue: string;
-    priority: number;
-    timeout: number;
-}
-
-export declare class SmrtReportScheduleCollection extends SmrtCollection<SmrtReportSchedule> {
-    static readonly _itemClass: typeof SmrtReportSchedule;
-}
-
-export declare class SmrtReportWatermark extends SmrtObject {
-    tenantId: string | null;
-    scopeKey: string;
-    reportClass: string;
-    sourceClass: string;
-    watermarkColumn: string;
-    watermarkValue: string | null;
-    lastRunId: string | null;
-}
-
-export declare class SmrtReportWatermarkCollection extends SmrtCollection<SmrtReportWatermark> {
-    static readonly _itemClass: typeof SmrtReportWatermark;
-}
-
-/**
- * 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;
-};
-
-export declare const sum: (column?: string, options?: {
-    distinct?: boolean;
-}) => PropertyDecorator;
-
-/**
- * Validate artifact metadata before a host serves it. Download locations and
- * tokens stay application-private; expired artifacts fail before that boundary.
- */
-export declare function validateReportExportArtifact(descriptor: ReportAdapterDescriptor, artifact: ReportExportArtifact, now?: Date): ReportExportArtifact;
-
-/**
- * Revalidate the request and prove the opaque snapshot binding through the
- * application host. Preview, apply, and every background worker use this same
- * operation before reading or serving export data.
- */
-export declare function validateReportExportExecution(descriptor: ReportAdapterDescriptor, request: ReportExportRequest, host: Pick<ReportExportActionHost, 'assertSnapshot'>): Promise<ReportExportRequest>;
-
-/**
- * Recreate the deterministic request from its current descriptor and frozen
- * snapshot. Preview, apply, queue, and serving hosts call this instead of
- * trusting browser- or agent-supplied action metadata.
- */
-export declare function validateReportExportRequest(descriptor: ReportAdapterDescriptor, request: ReportExportRequest): ReportExportRequest;
-
-/** Reject definitions/policies that changed after a snapshot was frozen. */
-export declare function verifyReportExportSnapshot(descriptor: ReportAdapterDescriptor, snapshot: ReportExportSnapshot): ReportExportSnapshot;
-
-export declare const week: (sourceColumn: string) => PropertyDecorator;
-
-export declare const year: (sourceColumn: string) => PropertyDecorator;
-
-export { }
+export type { ReportAdapterDescriptor, ReportAdapterOptions, ReportBackgroundQueryOptions, ReportBackgroundQueryResult, ReportBackgroundQueryTask, ReportColumnCapability, ReportColumnDescriptor, ReportColumnKind, ReportColumnSensitivity, ReportDataQueryResult, ReportDataTableColumn, ReportDataTableColumnOverride, ReportDataTableColumnResponsive, ReportDataTableColumnRole, ReportDataTableDescriptor, ReportDataTableHeaderPathSegment, ReportDataTablePresentationOptions, ReportDataTableStructuralRow, ReportDataTableStructuralRowInput, ReportDataTableStructuralRowKind, ReportDataTableValueFormat, ReportDrilldownConstraint, ReportDrilldownDescriptor, ReportDrilldownFieldDescriptor, ReportDrilldownQuery, ReportFilterScope, ReportMaterializedReadLifecycle, ReportQueryExecutionDescriptor, ReportQueryExecutionMode, ReportQueryOptions, ReportRefreshActionDescriptor, ReportRefreshDescriptor, } from './adapter.js';
+export { buildReportAdapterDescriptor, buildReportDrilldownQuery, queryReportMaterializedRows, reportMaterializedRowKey, splitReportFilterScopes, } from './adapter.js';
+export { bucketExpr, buildAggregate, } from './aggregate.js';
+export { buildReportDefinition, compileReportDefinition, compileReportSpec, getReportGroupingColumns, } from './compiler.js';
+export { aggregate, avg, count, day, getRuntimeReportOptions, groupBy, hour, max, min, minute, month, quarter, report, sum, week, year, } from './decorators.js';
+export type { AppliedReportRefresh, ApplyReportRefreshOptions, PreviewReportRefreshOptions, ReportLifecycleOptions, ReportLifecycleRun, ReportLifecycleSnapshot, ReportLifecycleState, ReportRefreshActionContext, ReportRefreshActionHost, ReportRefreshJobHandle, ReportRefreshOutcome, ReportRefreshPreview, } from './lifecycle.js';
+export { applyReportRefresh, getReportLifecycle, previewReportRefresh, reportRefreshOutcome, } from './lifecycle.js';
+export { refreshReport, reportRowIdentity, } from './refresh.js';
+export { SmrtReport, SmrtReportCollection } from './report.js';
+export type { EnqueueReportRefreshOptions, EnsureReportSchedulesOptions, ReportExecutionPrincipalReference, ReportRefreshExecutionAuditEvent, ReportRefreshExecutionAuthority, ReportRefreshExecutionAuthorityContext, ReportRefreshExecutionAuthorityHost, ReportRefreshInterceptorOptions, ReportRefreshJobArgs, ReportScheduleInfo, ReportScheduleRunnerConfig, ReportScheduleRunnerEvents, } from './scheduler.js';
+export { enqueueReportRefresh, ensureReportRefreshSchedules, ReportScheduleRunner, registerReportRefreshExecutionAuthorityHost, registerReportRefreshInterceptor, registerReportRefreshJobIntegritySigner, SmrtPrincipalReportRefreshTask, SmrtReportRefreshTask, } from './scheduler.js';
+export { assertReportTablesReady, REPORT_LOCKS_TABLE, REPORT_REFRESH_TASKS_TABLE, REPORT_RUNS_TABLE, REPORT_RUNTIME_TABLES, REPORT_SCHEDULER_TABLES, REPORT_SCHEDULES_TABLE, REPORT_WATERMARKS_TABLE, SmrtReportLock, SmrtReportLockCollection, SmrtReportRun, SmrtReportRunCollection, SmrtReportSchedule, SmrtReportScheduleCollection, SmrtReportWatermark, SmrtReportWatermarkCollection, scopeKeyForTenant, } from './state.js';
+export type { AggregateBuildResult, AggregateSelectExpr, AggregateSpec, ReportAggregateFieldMetadata, ReportAggregateFn, ReportBucketFieldMetadata, ReportDefinition, ReportFieldDefinition, ReportFieldMetadata, ReportGroupFieldMetadata, ReportOptions, ReportRefreshConfig, ReportRefreshMode, ReportRefreshOptions, ReportRefreshResult, ReportRefreshTrigger, ReportSource, ReportTimeBucketUnit, } from './types.js';
+export type { AppliedReportExport, ReportBackgroundExportTask, ReportExportActionContext, ReportExportActionHost, ReportExportArtifact, ReportExportFormat, ReportExportLimits, ReportExportPreview, ReportExportProgress, ReportExportReadPlan, ReportExportRequest, ReportExportSnapshot, ReportExportSnapshotBinding, ReportExportSnapshotContext, ReportSavedView, ReportSavedViewColumn, ReportSavedViewDisplay, ReportSavedViewGrouping, ReportSavedViewPinnedSide, } from './views.js';
+export { applyReportExport, createReportExportPageRequest, createReportExportRequest, createReportExportSnapshot, migrateReportSavedView, normalizeReportSavedView, previewReportExport, ReportSurfaceValidationError, reportDefinitionFingerprint, restoreReportSavedView, validateReportExportArtifact, validateReportExportExecution, validateReportExportRequest, verifyReportExportSnapshot, } from './views.js';
+//# sourceMappingURL=index.d.ts.map