@happyvertical/smrt-reports 0.36.5

package/dist/state.d.ts

@@ -0,0 +1,108 @@
+import { DatabaseInterface } from '@happyvertical/sql';
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { SmrtObject } from '@happyvertical/smrt-core';
+
+export declare function assertReportTablesReady(db: DatabaseInterface, tables?: readonly string[]): Promise<void>;
+
+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";
+
+declare type ReportRefreshMode = 'rebuild' | 'incremental';
+
+declare type ReportRefreshTrigger = 'manual' | 'schedule' | 'change' | 'ttl' | 'job';
+
+export declare type ReportRunStatus = 'running' | 'success' | 'failed' | 'skipped';
+
+export declare type ReportScheduleStatus = 'active' | 'paused' | 'disabled' | 'error';
+
+export declare function scopeKeyForTenant(tenantId: string | null | undefined): string;
+
+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 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 { }

package/dist/state.js

@@ -0,0 +1,320 @@
+import { field, smrt, SmrtObject, SmrtCollection } from "@happyvertical/smrt-core";
+import { tenantId, TenantScoped } from "@happyvertical/smrt-tenancy";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+const REPORT_RUNS_TABLE = "_smrt_report_runs";
+const REPORT_WATERMARKS_TABLE = "_smrt_report_watermarks";
+const REPORT_LOCKS_TABLE = "_smrt_report_locks";
+const REPORT_SCHEDULES_TABLE = "_smrt_report_schedules";
+const REPORT_REFRESH_TASKS_TABLE = "_smrt_report_refresh_tasks";
+const REPORT_RUNTIME_TABLES = [
+  REPORT_RUNS_TABLE,
+  REPORT_WATERMARKS_TABLE,
+  REPORT_LOCKS_TABLE
+];
+const REPORT_SCHEDULER_TABLES = [
+  REPORT_SCHEDULES_TABLE,
+  REPORT_REFRESH_TASKS_TABLE
+];
+function scopeKeyForTenant(tenantId2) {
+  return tenantId2 ? `tenant:${tenantId2}` : "global";
+}
+async function assertReportTablesReady(db, tables = REPORT_RUNTIME_TABLES) {
+  for (const table of tables) {
+    const ready = await db.tableExists(table);
+    if (!ready) {
+      throw new Error(
+        `Report runtime table '${table}' does not exist. Run smrt db:migrate before refreshing reports.`
+      );
+    }
+  }
+}
+const INTERNAL_SURFACE = {
+  api: false,
+  cli: {
+    include: ["list", "get"],
+    skipApiCheck: true,
+    http: false
+  },
+  mcp: false
+};
+let SmrtReportRun = class extends SmrtObject {
+  tenantId = null;
+  scopeKey = "global";
+  reportClass = "";
+  sourceClass = "";
+  mode = "rebuild";
+  trigger = "manual";
+  status = "running";
+  startedAt = /* @__PURE__ */ new Date();
+  completedAt = null;
+  rowCount = 0;
+  changedGroupCount = 0;
+  watermarkBefore = null;
+  watermarkAfter = null;
+  error = null;
+  metadata = {};
+};
+__decorateClass([
+  tenantId({ nullable: true })
+], SmrtReportRun.prototype, "tenantId", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportRun.prototype, "scopeKey", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportRun.prototype, "reportClass", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportRun.prototype, "sourceClass", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportRun.prototype, "mode", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportRun.prototype, "trigger", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportRun.prototype, "status", 2);
+__decorateClass([
+  field({ type: "datetime", required: true })
+], SmrtReportRun.prototype, "startedAt", 2);
+__decorateClass([
+  field({ type: "datetime", nullable: true })
+], SmrtReportRun.prototype, "completedAt", 2);
+__decorateClass([
+  field({ type: "integer", required: true })
+], SmrtReportRun.prototype, "rowCount", 2);
+__decorateClass([
+  field({ type: "integer", required: true })
+], SmrtReportRun.prototype, "changedGroupCount", 2);
+__decorateClass([
+  field({ type: "text", nullable: true })
+], SmrtReportRun.prototype, "watermarkBefore", 2);
+__decorateClass([
+  field({ type: "text", nullable: true })
+], SmrtReportRun.prototype, "watermarkAfter", 2);
+__decorateClass([
+  field({ type: "text", nullable: true })
+], SmrtReportRun.prototype, "error", 2);
+__decorateClass([
+  field({ type: "json" })
+], SmrtReportRun.prototype, "metadata", 2);
+SmrtReportRun = __decorateClass([
+  TenantScoped({ mode: "optional" }),
+  smrt({
+    tableName: "_smrt_report_runs",
+    ...INTERNAL_SURFACE
+  })
+], SmrtReportRun);
+class SmrtReportRunCollection extends SmrtCollection {
+  static _itemClass = SmrtReportRun;
+}
+let SmrtReportWatermark = class extends SmrtObject {
+  tenantId = null;
+  scopeKey = "global";
+  reportClass = "";
+  sourceClass = "";
+  watermarkColumn = "";
+  watermarkValue = null;
+  lastRunId = null;
+};
+__decorateClass([
+  tenantId({ nullable: true })
+], SmrtReportWatermark.prototype, "tenantId", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportWatermark.prototype, "scopeKey", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportWatermark.prototype, "reportClass", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportWatermark.prototype, "sourceClass", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportWatermark.prototype, "watermarkColumn", 2);
+__decorateClass([
+  field({ type: "text", nullable: true })
+], SmrtReportWatermark.prototype, "watermarkValue", 2);
+__decorateClass([
+  field({ type: "text", nullable: true })
+], SmrtReportWatermark.prototype, "lastRunId", 2);
+SmrtReportWatermark = __decorateClass([
+  TenantScoped({ mode: "optional" }),
+  smrt({
+    tableName: "_smrt_report_watermarks",
+    conflictColumns: [
+      "report_class",
+      "scope_key",
+      "source_class",
+      "watermark_column"
+    ],
+    ...INTERNAL_SURFACE
+  })
+], SmrtReportWatermark);
+class SmrtReportWatermarkCollection extends SmrtCollection {
+  static _itemClass = SmrtReportWatermark;
+}
+let SmrtReportLock = class extends SmrtObject {
+  tenantId = null;
+  scopeKey = "global";
+  reportClass = "";
+  ownerId = null;
+  acquiredAt = null;
+  heartbeatAt = null;
+  expiresAt = null;
+};
+__decorateClass([
+  tenantId({ nullable: true })
+], SmrtReportLock.prototype, "tenantId", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportLock.prototype, "scopeKey", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportLock.prototype, "reportClass", 2);
+__decorateClass([
+  field({ type: "text", nullable: true })
+], SmrtReportLock.prototype, "ownerId", 2);
+__decorateClass([
+  field({ type: "datetime", nullable: true })
+], SmrtReportLock.prototype, "acquiredAt", 2);
+__decorateClass([
+  field({ type: "datetime", nullable: true })
+], SmrtReportLock.prototype, "heartbeatAt", 2);
+__decorateClass([
+  field({ type: "datetime", nullable: true })
+], SmrtReportLock.prototype, "expiresAt", 2);
+SmrtReportLock = __decorateClass([
+  TenantScoped({ mode: "optional" }),
+  smrt({
+    tableName: "_smrt_report_locks",
+    conflictColumns: ["report_class", "scope_key"],
+    ...INTERNAL_SURFACE
+  })
+], SmrtReportLock);
+class SmrtReportLockCollection extends SmrtCollection {
+  static _itemClass = SmrtReportLock;
+}
+let SmrtReportSchedule = class extends SmrtObject {
+  tenantId = null;
+  scopeKey = "global";
+  reportClass = "";
+  cron = "";
+  trigger = "schedule";
+  mode = "incremental";
+  enabled = true;
+  status = "active";
+  nextRun = null;
+  lastRun = null;
+  lastStatus = null;
+  lastError = null;
+  runCount = 0;
+  successCount = 0;
+  failureCount = 0;
+  runningCount = 0;
+  maxConcurrent = 1;
+  queue = "reports";
+  priority = 70;
+  timeout = 36e5;
+};
+__decorateClass([
+  tenantId({ nullable: true })
+], SmrtReportSchedule.prototype, "tenantId", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportSchedule.prototype, "scopeKey", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportSchedule.prototype, "reportClass", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportSchedule.prototype, "cron", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportSchedule.prototype, "trigger", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportSchedule.prototype, "mode", 2);
+__decorateClass([
+  field({ type: "boolean", required: true })
+], SmrtReportSchedule.prototype, "enabled", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportSchedule.prototype, "status", 2);
+__decorateClass([
+  field({ type: "datetime", nullable: true })
+], SmrtReportSchedule.prototype, "nextRun", 2);
+__decorateClass([
+  field({ type: "datetime", nullable: true })
+], SmrtReportSchedule.prototype, "lastRun", 2);
+__decorateClass([
+  field({ type: "text", nullable: true })
+], SmrtReportSchedule.prototype, "lastStatus", 2);
+__decorateClass([
+  field({ type: "text", nullable: true })
+], SmrtReportSchedule.prototype, "lastError", 2);
+__decorateClass([
+  field({ type: "integer", required: true })
+], SmrtReportSchedule.prototype, "runCount", 2);
+__decorateClass([
+  field({ type: "integer", required: true })
+], SmrtReportSchedule.prototype, "successCount", 2);
+__decorateClass([
+  field({ type: "integer", required: true })
+], SmrtReportSchedule.prototype, "failureCount", 2);
+__decorateClass([
+  field({ type: "integer", required: true })
+], SmrtReportSchedule.prototype, "runningCount", 2);
+__decorateClass([
+  field({ type: "integer", required: true })
+], SmrtReportSchedule.prototype, "maxConcurrent", 2);
+__decorateClass([
+  field({ type: "text", required: true })
+], SmrtReportSchedule.prototype, "queue", 2);
+__decorateClass([
+  field({ type: "integer", required: true })
+], SmrtReportSchedule.prototype, "priority", 2);
+__decorateClass([
+  field({ type: "integer", required: true })
+], SmrtReportSchedule.prototype, "timeout", 2);
+SmrtReportSchedule = __decorateClass([
+  TenantScoped({ mode: "optional" }),
+  smrt({
+    tableName: "_smrt_report_schedules",
+    conflictColumns: ["report_class", "scope_key", "cron", "mode"],
+    ...INTERNAL_SURFACE
+  })
+], SmrtReportSchedule);
+class SmrtReportScheduleCollection extends SmrtCollection {
+  static _itemClass = SmrtReportSchedule;
+}
+export {
+  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
+};
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sources":["../src/state.ts"],"sourcesContent":["import {\n  field,\n  SmrtCollection,\n  SmrtObject,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport type { DatabaseInterface } from '@happyvertical/sql';\nimport type { ReportRefreshMode, ReportRefreshTrigger } from './types.js';\n\nexport const REPORT_RUNS_TABLE = '_smrt_report_runs';\nexport const REPORT_WATERMARKS_TABLE = '_smrt_report_watermarks';\nexport const REPORT_LOCKS_TABLE = '_smrt_report_locks';\nexport const REPORT_SCHEDULES_TABLE = '_smrt_report_schedules';\nexport const REPORT_REFRESH_TASKS_TABLE = '_smrt_report_refresh_tasks';\n\nexport const REPORT_RUNTIME_TABLES = [\n  REPORT_RUNS_TABLE,\n  REPORT_WATERMARKS_TABLE,\n  REPORT_LOCKS_TABLE,\n] as const;\n\nexport const REPORT_SCHEDULER_TABLES = [\n  REPORT_SCHEDULES_TABLE,\n  REPORT_REFRESH_TASKS_TABLE,\n] as const;\n\nexport type ReportRunStatus = 'running' | 'success' | 'failed' | 'skipped';\nexport type ReportScheduleStatus = 'active' | 'paused' | 'disabled' | 'error';\n\nexport function scopeKeyForTenant(tenantId: string | null | undefined): string {\n  return tenantId ? `tenant:${tenantId}` : 'global';\n}\n\nexport async function assertReportTablesReady(\n  db: DatabaseInterface,\n  tables: readonly string[] = REPORT_RUNTIME_TABLES,\n): Promise<void> {\n  for (const table of tables) {\n    const ready = await db.tableExists(table);\n    if (!ready) {\n      throw new Error(\n        `Report runtime table '${table}' does not exist. ` +\n          'Run smrt db:migrate before refreshing reports.',\n      );\n    }\n  }\n}\n\nconst INTERNAL_SURFACE = {\n  api: false,\n  cli: {\n    include: ['list', 'get'],\n    skipApiCheck: true,\n    http: false,\n  },\n  mcp: false,\n};\n\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: '_smrt_report_runs',\n  ...INTERNAL_SURFACE,\n})\nexport class SmrtReportRun extends SmrtObject {\n  @tenantId({ nullable: true })\n  tenantId: string | null = null;\n\n  @field({ type: 'text', required: true })\n  scopeKey: string = 'global';\n\n  @field({ type: 'text', required: true })\n  reportClass: string = '';\n\n  @field({ type: 'text', required: true })\n  sourceClass: string = '';\n\n  @field({ type: 'text', required: true })\n  mode: ReportRefreshMode = 'rebuild';\n\n  @field({ type: 'text', required: true })\n  trigger: ReportRefreshTrigger = 'manual';\n\n  @field({ type: 'text', required: true })\n  status: ReportRunStatus = 'running';\n\n  @field({ type: 'datetime', required: true })\n  startedAt: Date = new Date();\n\n  @field({ type: 'datetime', nullable: true })\n  completedAt: Date | null = null;\n\n  @field({ type: 'integer', required: true })\n  rowCount: number = 0;\n\n  @field({ type: 'integer', required: true })\n  changedGroupCount: number = 0;\n\n  @field({ type: 'text', nullable: true })\n  watermarkBefore: string | null = null;\n\n  @field({ type: 'text', nullable: true })\n  watermarkAfter: string | null = null;\n\n  @field({ type: 'text', nullable: true })\n  error: string | null = null;\n\n  @field({ type: 'json' })\n  metadata: Record<string, unknown> = {};\n}\n\nexport class SmrtReportRunCollection extends SmrtCollection<SmrtReportRun> {\n  static readonly _itemClass = SmrtReportRun;\n}\n\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: '_smrt_report_watermarks',\n  conflictColumns: [\n    'report_class',\n    'scope_key',\n    'source_class',\n    'watermark_column',\n  ],\n  ...INTERNAL_SURFACE,\n})\nexport class SmrtReportWatermark extends SmrtObject {\n  @tenantId({ nullable: true })\n  tenantId: string | null = null;\n\n  @field({ type: 'text', required: true })\n  scopeKey: string = 'global';\n\n  @field({ type: 'text', required: true })\n  reportClass: string = '';\n\n  @field({ type: 'text', required: true })\n  sourceClass: string = '';\n\n  @field({ type: 'text', required: true })\n  watermarkColumn: string = '';\n\n  @field({ type: 'text', nullable: true })\n  watermarkValue: string | null = null;\n\n  @field({ type: 'text', nullable: true })\n  lastRunId: string | null = null;\n}\n\nexport class SmrtReportWatermarkCollection extends SmrtCollection<SmrtReportWatermark> {\n  static readonly _itemClass = SmrtReportWatermark;\n}\n\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: '_smrt_report_locks',\n  conflictColumns: ['report_class', 'scope_key'],\n  ...INTERNAL_SURFACE,\n})\nexport class SmrtReportLock extends SmrtObject {\n  @tenantId({ nullable: true })\n  tenantId: string | null = null;\n\n  @field({ type: 'text', required: true })\n  scopeKey: string = 'global';\n\n  @field({ type: 'text', required: true })\n  reportClass: string = '';\n\n  @field({ type: 'text', nullable: true })\n  ownerId: string | null = null;\n\n  @field({ type: 'datetime', nullable: true })\n  acquiredAt: Date | null = null;\n\n  @field({ type: 'datetime', nullable: true })\n  heartbeatAt: Date | null = null;\n\n  @field({ type: 'datetime', nullable: true })\n  expiresAt: Date | null = null;\n}\n\nexport class SmrtReportLockCollection extends SmrtCollection<SmrtReportLock> {\n  static readonly _itemClass = SmrtReportLock;\n}\n\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: '_smrt_report_schedules',\n  conflictColumns: ['report_class', 'scope_key', 'cron', 'mode'],\n  ...INTERNAL_SURFACE,\n})\nexport class SmrtReportSchedule extends SmrtObject {\n  @tenantId({ nullable: true })\n  tenantId: string | null = null;\n\n  @field({ type: 'text', required: true })\n  scopeKey: string = 'global';\n\n  @field({ type: 'text', required: true })\n  reportClass: string = '';\n\n  @field({ type: 'text', required: true })\n  cron: string = '';\n\n  @field({ type: 'text', required: true })\n  trigger: ReportRefreshTrigger = 'schedule';\n\n  @field({ type: 'text', required: true })\n  mode: ReportRefreshMode = 'incremental';\n\n  @field({ type: 'boolean', required: true })\n  enabled: boolean = true;\n\n  @field({ type: 'text', required: true })\n  status: ReportScheduleStatus = 'active';\n\n  @field({ type: 'datetime', nullable: true })\n  nextRun: Date | null = null;\n\n  @field({ type: 'datetime', nullable: true })\n  lastRun: Date | null = null;\n\n  @field({ type: 'text', nullable: true })\n  lastStatus: 'success' | 'failed' | null = null;\n\n  @field({ type: 'text', nullable: true })\n  lastError: string | null = null;\n\n  @field({ type: 'integer', required: true })\n  runCount: number = 0;\n\n  @field({ type: 'integer', required: true })\n  successCount: number = 0;\n\n  @field({ type: 'integer', required: true })\n  failureCount: number = 0;\n\n  @field({ type: 'integer', required: true })\n  runningCount: number = 0;\n\n  @field({ type: 'integer', required: true })\n  maxConcurrent: number = 1;\n\n  @field({ type: 'text', required: true })\n  queue: string = 'reports';\n\n  @field({ type: 'integer', required: true })\n  priority: number = 70;\n\n  @field({ type: 'integer', required: true })\n  timeout: number = 3600000;\n}\n\nexport class SmrtReportScheduleCollection extends SmrtCollection<SmrtReportSchedule> {\n  static readonly _itemClass = SmrtReportSchedule;\n}\n"],"names":["tenantId"],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,114 @@
+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 { DatabaseInterface } from '@happyvertical/sql';
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { SqlAdapterType } from '@happyvertical/sql';
+import { WhereClause } from '@happyvertical/sql';
+
+export { AggregateBuildResult }
+
+export { AggregateSelectExpr }
+
+export { AggregateSpec }
+
+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;
+}
+
+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 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 type ReportSource = string | (new (...args: any[]) => SmrtObject) | (abstract new (...args: any[]) => SmrtObject);
+
+export declare type ReportTimeBucketUnit = AggregateTimeBucketUnit;
+
+export { }

package/dist/types.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@happyvertical/smrt-reports",
+  "version": "0.36.5",
+  "description": "Materialized aggregate report models for SMRT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CLAUDE.md",
+    "AGENTS.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./aggregate": {
+      "types": "./dist/aggregate.d.ts",
+      "import": "./dist/aggregate.js"
+    },
+    "./compiler": {
+      "types": "./dist/compiler.d.ts",
+      "import": "./dist/compiler.js"
+    },
+    "./decorators": {
+      "types": "./dist/decorators.d.ts",
+      "import": "./dist/decorators.js"
+    },
+    "./refresh": {
+      "types": "./dist/refresh.d.ts",
+      "import": "./dist/refresh.js"
+    },
+    "./scheduler": {
+      "types": "./dist/scheduler.d.ts",
+      "import": "./dist/scheduler.js"
+    },
+    "./state": {
+      "types": "./dist/state.d.ts",
+      "import": "./dist/state.js"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./manifest.json": "./dist/manifest.json"
+  },
+  "dependencies": {
+    "@happyvertical/sql": "^0.74.10",
+    "@happyvertical/smrt-core": "0.36.5",
+    "@happyvertical/smrt-tenancy": "0.36.5",
+    "@happyvertical/smrt-jobs": "0.36.5"
+  },
+  "devDependencies": {
+    "@types/node": "25.0.9",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.17",
+    "@happyvertical/smrt-vitest": "0.36.5"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "reports",
+    "materialized-views",
+    "smrt"
+  ],
+  "author": "HappyVertical",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/reports"
+  },
+  "scripts": {
+    "build": "vite build --mode library",
+    "build:watch": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "dev": "vite dev",
+    "pretest": "[ -f ../cli/dist/index.js ] && node ../cli/dist/index.js test --manifest-only || true",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "verify:pack": "node ../../scripts/verify-package-types-exports.js ."
+  }
+}