@happyvertical/smrt-reports 0.36.5

package/dist/index.d.ts

@@ -0,0 +1,407 @@
+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 { EventEmitter } from 'node:events';
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { SmrtJob } from '@happyvertical/smrt-jobs';
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { SmrtObjectOptions } 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 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 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 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 enqueueReportRefresh(options: EnqueueReportRefreshOptions): Promise<SmrtJob>;
+
+export declare interface EnqueueReportRefreshOptions extends ReportRefreshJobArgs {
+    report?: ReportCtor_2;
+    reportClass: string;
+    db: DatabaseInterface;
+    queue?: string;
+    priority?: number;
+    timeout?: number;
+    maxAttempts?: number;
+    tenantJobCap?: number;
+}
+
+export declare function ensureReportRefreshSchedules(options: EnsureReportSchedulesOptions): Promise<void>;
+
+export declare interface EnsureReportSchedulesOptions {
+    db: DatabaseInterface;
+    reports: ReportCtor_2[];
+    tenantIds?: string[];
+    queue?: string;
+    priority?: number;
+    timeout?: number;
+}
+
+export declare function getReportGroupingColumns(definition: Pick<ReportDefinition, 'fields'>): string[];
+
+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 refreshReport(reportCtor: ReportCtor, options?: ReportRefreshOptions): Promise<ReportRefreshResult>;
+
+export declare function registerReportRefreshInterceptor(options: ReportRefreshInterceptorOptions): () => boolean;
+
+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";
+
+export declare interface ReportAggregateFieldMetadata {
+    kind: 'aggregate';
+    fn: ReportAggregateFn;
+    column?: string;
+    distinct?: boolean;
+}
+
+export declare type ReportAggregateFn = AggregateFunction;
+
+export declare interface ReportBucketFieldMetadata {
+    kind: 'bucket';
+    unit: ReportTimeBucketUnit;
+    sourceColumn: string;
+}
+
+declare type ReportCtor = new (...args: any[]) => SmrtObject;
+
+declare type ReportCtor_2 = new (...args: any[]) => SmrtObject;
+
+export declare interface ReportDefinition {
+    reportClassName: string;
+    sourceClassName: string;
+    sourceTable: string;
+    fields: ReportFieldDefinition[];
+    where?: WhereClause;
+    having?: WhereClause;
+    refresh?: ReportRefreshConfig;
+}
+
+export declare interface ReportFieldDefinition {
+    fieldName: string;
+    columnName?: string;
+    type?: string;
+    report?: ReportFieldMetadata;
+}
+
+export declare type ReportFieldMetadata = ReportGroupFieldMetadata | ReportBucketFieldMetadata | ReportAggregateFieldMetadata;
+
+export declare interface ReportGroupFieldMetadata {
+    kind: 'group';
+    sourceColumn?: string;
+}
+
+export declare interface ReportOptions {
+    source: ReportSource;
+    where?: WhereClause;
+    having?: WhereClause;
+    refresh?: ReportRefreshConfig;
+}
+
+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 ReportRefreshInterceptorOptions {
+    db: DatabaseInterface;
+    reports: ReportCtor_2[];
+    enqueue?: boolean;
+    queue?: string;
+    priority?: number;
+    timeout?: number;
+    tenantJobCap?: number;
+    name?: string;
+}
+
+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;
+}
+
+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 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';
+
+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;
+}
+
+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 type ReportTimeBucketUnit = AggregateTimeBucketUnit;
+
+export declare function scopeKeyForTenant(tenantId: string | null | undefined): string;
+
+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(options?: Parameters<SmrtCollection<ModelType>['list']>[0]): Promise<ModelType[]>;
+    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): 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;
+}
+
+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 { }

package/dist/index.js

@@ -0,0 +1,162 @@
+import { validateColumnName } from "@happyvertical/sql";
+import { bucketExpr, buildAggregate } from "@happyvertical/sql";
+import { buildReportDefinition } from "./compiler.js";
+import { compileReportDefinition, compileReportSpec, getReportGroupingColumns } from "./compiler.js";
+import { aggregate, avg, count, day, getRuntimeReportOptions, groupBy, hour, max, min, minute, month, quarter, report, sum, week, year } from "./decorators.js";
+import { refreshReport } from "./refresh.js";
+import { reportRowIdentity } from "./refresh.js";
+import { SmrtObject, SmrtCollection, ObjectRegistry } from "@happyvertical/smrt-core";
+import { toSnakeCase } from "@happyvertical/smrt-core/utils";
+import { getTenantId } from "@happyvertical/smrt-tenancy";
+import { ReportScheduleRunner, SmrtReportRefreshTask, enqueueReportRefresh, ensureReportRefreshSchedules, registerReportRefreshInterceptor } from "./scheduler.js";
+import { 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, assertReportTablesReady, scopeKeyForTenant } from "./state.js";
+function registryColumnName(fieldName, field) {
+  return validateColumnName(
+    field?.columnName ?? field?._meta?.columnName ?? toSnakeCase(fieldName)
+  );
+}
+function findFieldColumn(fields, fieldName) {
+  const direct = fields.get(fieldName);
+  if (direct) return registryColumnName(fieldName, direct);
+  const requestedColumn = toSnakeCase(fieldName);
+  for (const [name, field] of fields.entries()) {
+    if (toSnakeCase(name) === requestedColumn) {
+      return registryColumnName(name, field);
+    }
+  }
+  return validateColumnName(requestedColumn);
+}
+function findTenantColumn(fields, configuredField) {
+  if (configuredField) {
+    return registryColumnName(configuredField, fields.get(configuredField));
+  }
+  for (const [fieldName, field] of fields.entries()) {
+    if (fieldName === "tenantId" || field?._meta?.__tenancy?.isTenantIdField) {
+      return registryColumnName(fieldName, field);
+    }
+  }
+  return null;
+}
+class SmrtReport extends SmrtObject {
+  static _isReportBase = true;
+  refreshedAt = null;
+  constructor(options = {}) {
+    super(options);
+    if (options.refreshedAt !== void 0) {
+      this.refreshedAt = options.refreshedAt instanceof Date ? options.refreshedAt : options.refreshedAt ? new Date(options.refreshedAt) : null;
+    }
+  }
+  isStale(ttlMs) {
+    if (!this.refreshedAt) return true;
+    if (ttlMs === void 0) return false;
+    return Date.now() - this.refreshedAt.getTime() > ttlMs;
+  }
+  async refresh(options = {}) {
+    const result = await refreshReport(this.constructor, {
+      ...options,
+      db: this.db
+    });
+    this.refreshedAt = result.refreshedAt;
+    return result;
+  }
+}
+class SmrtReportCollection extends SmrtCollection {
+  async refreshIfStale() {
+    const reportCtor = this.getItemClass();
+    const definition = await buildReportDefinition(reportCtor);
+    const refresh = definition.refresh;
+    if (!refresh?.ttl || refresh.manual) return;
+    const registered = ObjectRegistry.getClassByConstructor(reportCtor) ?? ObjectRegistry.getClass(reportCtor.name);
+    const reportClass = registered?.qualifiedName ?? registered?.name ?? reportCtor.name;
+    const tableName = ObjectRegistry.getTableName(reportClass);
+    if (!tableName) return;
+    const fields = await ObjectRegistry.getAllFields(reportClass);
+    const safeTableName = validateColumnName(tableName);
+    const refreshedAtColumn = findFieldColumn(fields, "refreshedAt");
+    const tenantColumn = findTenantColumn(
+      fields,
+      registered?.tenantScopedConfig?.field
+    );
+    const tenantId = getTenantId() ?? null;
+    const result = tenantColumn ? await this.db.query(
+      `SELECT MAX(${refreshedAtColumn}) AS refreshed_at FROM ${safeTableName} WHERE ${tenantColumn} ${tenantId ? "= ?" : "IS NULL"}`,
+      ...tenantId ? [tenantId] : []
+    ) : await this.db.query(
+      `SELECT MAX(${refreshedAtColumn}) AS refreshed_at FROM ${safeTableName}`
+    );
+    const refreshedAt = result.rows[0]?.refreshed_at ? new Date(result.rows[0].refreshed_at) : null;
+    const stale = !refreshedAt || Date.now() - refreshedAt.getTime() > refresh.ttl;
+    if (!stale) return;
+    await refreshReport(reportCtor, {
+      db: this.db,
+      mode: refresh.mode ?? "rebuild",
+      trigger: "ttl",
+      tenantId
+    });
+  }
+  async refresh(options = {}) {
+    return refreshReport(this.getItemClass(), {
+      ...options,
+      db: this.db
+    });
+  }
+  async list(options = {}) {
+    await this.refreshIfStale();
+    return super.list(options);
+  }
+  async get(filter, options = {}) {
+    await this.refreshIfStale();
+    return super.get(filter, options);
+  }
+}
+export {
+  REPORT_LOCKS_TABLE,
+  REPORT_REFRESH_TASKS_TABLE,
+  REPORT_RUNS_TABLE,
+  REPORT_RUNTIME_TABLES,
+  REPORT_SCHEDULER_TABLES,
+  REPORT_SCHEDULES_TABLE,
+  REPORT_WATERMARKS_TABLE,
+  ReportScheduleRunner,
+  SmrtReport,
+  SmrtReportCollection,
+  SmrtReportLock,
+  SmrtReportLockCollection,
+  SmrtReportRefreshTask,
+  SmrtReportRun,
+  SmrtReportRunCollection,
+  SmrtReportSchedule,
+  SmrtReportScheduleCollection,
+  SmrtReportWatermark,
+  SmrtReportWatermarkCollection,
+  aggregate,
+  assertReportTablesReady,
+  avg,
+  bucketExpr,
+  buildAggregate,
+  buildReportDefinition,
+  compileReportDefinition,
+  compileReportSpec,
+  count,
+  day,
+  enqueueReportRefresh,
+  ensureReportRefreshSchedules,
+  getReportGroupingColumns,
+  getRuntimeReportOptions,
+  groupBy,
+  hour,
+  max,
+  min,
+  minute,
+  month,
+  quarter,
+  refreshReport,
+  registerReportRefreshInterceptor,
+  report,
+  reportRowIdentity,
+  scopeKeyForTenant,
+  sum,
+  week,
+  year
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/report.ts"],"sourcesContent":["import {\n  ObjectRegistry,\n  SmrtCollection,\n  SmrtObject,\n  type SmrtObjectOptions,\n} from '@happyvertical/smrt-core';\nimport { toSnakeCase } from '@happyvertical/smrt-core/utils';\nimport { getTenantId } from '@happyvertical/smrt-tenancy';\nimport { validateColumnName } from '@happyvertical/sql';\nimport { buildReportDefinition } from './compiler.js';\nimport { refreshReport } from './refresh.js';\nimport type { ReportRefreshOptions, ReportRefreshResult } from './types.js';\n\ntype RegistryField = {\n  columnName?: string;\n  _meta?: {\n    columnName?: string;\n    __tenancy?: { isTenantIdField?: boolean };\n  };\n};\n\nfunction registryColumnName(fieldName: string, field?: RegistryField): string {\n  return validateColumnName(\n    field?.columnName ?? field?._meta?.columnName ?? toSnakeCase(fieldName),\n  );\n}\n\nfunction findFieldColumn(\n  fields: Map<string, RegistryField>,\n  fieldName: string,\n): string {\n  const direct = fields.get(fieldName);\n  if (direct) return registryColumnName(fieldName, direct);\n  const requestedColumn = toSnakeCase(fieldName);\n  for (const [name, field] of fields.entries()) {\n    if (toSnakeCase(name) === requestedColumn) {\n      return registryColumnName(name, field);\n    }\n  }\n  return validateColumnName(requestedColumn);\n}\n\nfunction findTenantColumn(\n  fields: Map<string, RegistryField>,\n  configuredField?: string,\n): string | null {\n  if (configuredField) {\n    return registryColumnName(configuredField, fields.get(configuredField));\n  }\n  for (const [fieldName, field] of fields.entries()) {\n    if (fieldName === 'tenantId' || field?._meta?.__tenancy?.isTenantIdField) {\n      return registryColumnName(fieldName, field);\n    }\n  }\n  return null;\n}\n\nexport class SmrtReport extends SmrtObject {\n  static readonly _isReportBase = true as const;\n\n  refreshedAt: Date | null = null;\n\n  constructor(options: SmrtObjectOptions = {}) {\n    super(options);\n    if (options.refreshedAt !== undefined) {\n      this.refreshedAt =\n        options.refreshedAt instanceof Date\n          ? options.refreshedAt\n          : options.refreshedAt\n            ? new Date(options.refreshedAt)\n            : null;\n    }\n  }\n\n  isStale(ttlMs?: number): boolean {\n    if (!this.refreshedAt) return true;\n    if (ttlMs === undefined) return false;\n    return Date.now() - this.refreshedAt.getTime() > ttlMs;\n  }\n\n  async refresh(\n    options: Omit<ReportRefreshOptions, 'db'> = {},\n  ): Promise<ReportRefreshResult> {\n    const result = await refreshReport(this.constructor as typeof SmrtReport, {\n      ...options,\n      db: this.db,\n    });\n    this.refreshedAt = result.refreshedAt;\n    return result;\n  }\n}\n\nexport class SmrtReportCollection<\n  ModelType extends SmrtReport,\n> extends SmrtCollection<ModelType> {\n  private async refreshIfStale(): Promise<void> {\n    const reportCtor = this.getItemClass();\n    const definition = await buildReportDefinition(reportCtor);\n    const refresh = definition.refresh;\n    if (!refresh?.ttl || refresh.manual) return;\n\n    const registered =\n      ObjectRegistry.getClassByConstructor(reportCtor) ??\n      ObjectRegistry.getClass(reportCtor.name);\n    const reportClass =\n      registered?.qualifiedName ?? registered?.name ?? reportCtor.name;\n    const tableName = ObjectRegistry.getTableName(reportClass);\n    if (!tableName) return;\n\n    const fields = (await ObjectRegistry.getAllFields(reportClass)) as Map<\n      string,\n      RegistryField\n    >;\n    const safeTableName = validateColumnName(tableName);\n    const refreshedAtColumn = findFieldColumn(fields, 'refreshedAt');\n    const tenantColumn = findTenantColumn(\n      fields,\n      registered?.tenantScopedConfig?.field,\n    );\n    const tenantId = getTenantId() ?? null;\n    const result = tenantColumn\n      ? await this.db.query(\n          `SELECT MAX(${refreshedAtColumn}) AS refreshed_at FROM ${safeTableName} WHERE ${tenantColumn} ${tenantId ? '= ?' : 'IS NULL'}`,\n          ...(tenantId ? [tenantId] : []),\n        )\n      : await this.db.query(\n          `SELECT MAX(${refreshedAtColumn}) AS refreshed_at FROM ${safeTableName}`,\n        );\n    const refreshedAt = result.rows[0]?.refreshed_at\n      ? new Date(result.rows[0].refreshed_at as string)\n      : null;\n    const stale =\n      !refreshedAt || Date.now() - refreshedAt.getTime() > refresh.ttl;\n    if (!stale) return;\n\n    await refreshReport(reportCtor, {\n      db: this.db,\n      mode: refresh.mode ?? 'rebuild',\n      trigger: 'ttl',\n      tenantId,\n    });\n  }\n\n  async refresh(\n    options: Omit<ReportRefreshOptions, 'db'> = {},\n  ): Promise<ReportRefreshResult> {\n    return refreshReport(this.getItemClass(), {\n      ...options,\n      db: this.db,\n    });\n  }\n\n  override async list(\n    options: Parameters<SmrtCollection<ModelType>['list']>[0] = {},\n  ): Promise<ModelType[]> {\n    await this.refreshIfStale();\n    return super.list(options);\n  }\n\n  override async get(\n    filter: Parameters<SmrtCollection<ModelType>['get']>[0],\n    options: Parameters<SmrtCollection<ModelType>['get']>[1] = {},\n  ): Promise<ModelType | null> {\n    await this.refreshIfStale();\n    return super.get(filter, options);\n  }\n}\n"],"names":[],"mappings":"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"}