@wtfalch/reporting 0.2.1 → 0.3.1

package/dist/tables.d.ts

@@ -1243,12 +1243,276 @@ export declare const reportingAnalyticsWeekly: import("drizzle-orm/pg-core").PgT
     };
     dialect: "pg";
 }>;
+/** One row per fingerprint; mirrored from migrations/0003_errors.sql. */
+export declare const reportingErrors: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "reporting_errors";
+    schema: undefined;
+    columns: {
+        fingerprint: import("drizzle-orm/pg-core").PgColumn<{
+            name: "fingerprint";
+            tableName: "reporting_errors";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        site: import("drizzle-orm/pg-core").PgColumn<{
+            name: "site";
+            tableName: "reporting_errors";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        kind: import("drizzle-orm/pg-core").PgColumn<{
+            name: "kind";
+            tableName: "reporting_errors";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        message: import("drizzle-orm/pg-core").PgColumn<{
+            name: "message";
+            tableName: "reporting_errors";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        stack: import("drizzle-orm/pg-core").PgColumn<{
+            name: "stack";
+            tableName: "reporting_errors";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        runtime: import("drizzle-orm/pg-core").PgColumn<{
+            name: "runtime";
+            tableName: "reporting_errors";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        release: import("drizzle-orm/pg-core").PgColumn<{
+            name: "release";
+            tableName: "reporting_errors";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        firstSeenAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "first_seen_at";
+            tableName: "reporting_errors";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastSeenAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_seen_at";
+            tableName: "reporting_errors";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        occurrences: import("drizzle-orm/pg-core").PgColumn<{
+            name: "occurrences";
+            tableName: "reporting_errors";
+            dataType: "number";
+            columnType: "PgBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        state: import("drizzle-orm/pg-core").PgColumn<{
+            name: "state";
+            tableName: "reporting_errors";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        resolvedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "resolved_at";
+            tableName: "reporting_errors";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        resolvedBy: import("drizzle-orm/pg-core").PgColumn<{
+            name: "resolved_by";
+            tableName: "reporting_errors";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        tenantId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "tenant_id";
+            tableName: "reporting_errors";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        requestId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "request_id";
+            tableName: "reporting_errors";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
 export type ReportingEventRow = typeof reportingEvents.$inferSelect;
 export type ReportingAnalyticsRow = typeof reportingAnalytics.$inferSelect;
 export type ReportingAnalyticsDailyRow = typeof reportingAnalyticsDaily.$inferSelect;
 export type ReportingAnalyticsWeeklyRow = typeof reportingAnalyticsWeekly.$inferSelect;
 export type ReportingTaskRow = typeof reportingTasks.$inferSelect;
 export type ReportingSettingRow = typeof reportingSettings.$inferSelect;
+export type ReportingErrorRow = typeof reportingErrors.$inferSelect;
 export declare const tables: {
     events: import("drizzle-orm/pg-core").PgTableWithColumns<{
         name: "reporting_events";
@@ -2485,4 +2749,266 @@ export declare const tables: {
         };
         dialect: "pg";
     }>;
+    errors: import("drizzle-orm/pg-core").PgTableWithColumns<{
+        name: "reporting_errors";
+        schema: undefined;
+        columns: {
+            fingerprint: import("drizzle-orm/pg-core").PgColumn<{
+                name: "fingerprint";
+                tableName: "reporting_errors";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: true;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            site: import("drizzle-orm/pg-core").PgColumn<{
+                name: "site";
+                tableName: "reporting_errors";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            kind: import("drizzle-orm/pg-core").PgColumn<{
+                name: "kind";
+                tableName: "reporting_errors";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            message: import("drizzle-orm/pg-core").PgColumn<{
+                name: "message";
+                tableName: "reporting_errors";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            stack: import("drizzle-orm/pg-core").PgColumn<{
+                name: "stack";
+                tableName: "reporting_errors";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            runtime: import("drizzle-orm/pg-core").PgColumn<{
+                name: "runtime";
+                tableName: "reporting_errors";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            release: import("drizzle-orm/pg-core").PgColumn<{
+                name: "release";
+                tableName: "reporting_errors";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            firstSeenAt: import("drizzle-orm/pg-core").PgColumn<{
+                name: "first_seen_at";
+                tableName: "reporting_errors";
+                dataType: "date";
+                columnType: "PgTimestamp";
+                data: Date;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            lastSeenAt: import("drizzle-orm/pg-core").PgColumn<{
+                name: "last_seen_at";
+                tableName: "reporting_errors";
+                dataType: "date";
+                columnType: "PgTimestamp";
+                data: Date;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            occurrences: import("drizzle-orm/pg-core").PgColumn<{
+                name: "occurrences";
+                tableName: "reporting_errors";
+                dataType: "number";
+                columnType: "PgBigInt53";
+                data: number;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            state: import("drizzle-orm/pg-core").PgColumn<{
+                name: "state";
+                tableName: "reporting_errors";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            resolvedAt: import("drizzle-orm/pg-core").PgColumn<{
+                name: "resolved_at";
+                tableName: "reporting_errors";
+                dataType: "date";
+                columnType: "PgTimestamp";
+                data: Date;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            resolvedBy: import("drizzle-orm/pg-core").PgColumn<{
+                name: "resolved_by";
+                tableName: "reporting_errors";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            tenantId: import("drizzle-orm/pg-core").PgColumn<{
+                name: "tenant_id";
+                tableName: "reporting_errors";
+                dataType: "string";
+                columnType: "PgUUID";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            requestId: import("drizzle-orm/pg-core").PgColumn<{
+                name: "request_id";
+                tableName: "reporting_errors";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+        };
+        dialect: "pg";
+    }>;
 };

package/dist/tables.js

@@ -138,6 +138,29 @@ export const reportingAnalyticsWeekly = pgTable('reporting_analytics_weekly', {
         columns: [t.week, t.site, t.tenantKey],
     }),
 ]);
+/** One row per fingerprint; mirrored from migrations/0003_errors.sql. */
+export const reportingErrors = pgTable('reporting_errors', {
+    fingerprint: text('fingerprint').primaryKey(),
+    site: text('site').notNull(),
+    kind: text('kind').notNull(),
+    message: text('message').notNull(),
+    stack: text('stack'),
+    runtime: text('runtime').notNull(),
+    release: text('release'),
+    firstSeenAt: timestamp('first_seen_at', { withTimezone: true }).notNull(),
+    lastSeenAt: timestamp('last_seen_at', { withTimezone: true }).notNull(),
+    occurrences: bigint('occurrences', { mode: 'number' }).notNull().default(1),
+    state: text('state').notNull().default('open'),
+    resolvedAt: timestamp('resolved_at', { withTimezone: true }),
+    resolvedBy: text('resolved_by'),
+    tenantId: uuid('tenant_id'),
+    requestId: text('request_id'),
+}, (t) => [
+    index('reporting_errors_site_open_idx')
+        .on(t.site, t.lastSeenAt.desc())
+        .where(sql `${t.state} = 'open'`),
+    index('reporting_errors_state_idx').on(t.state, t.lastSeenAt.desc()),
+]);
 export const tables = {
     events: reportingEvents,
     tasks: reportingTasks,
@@ -145,4 +168,5 @@ export const tables = {
     analytics: reportingAnalytics,
     analyticsDaily: reportingAnalyticsDaily,
     analyticsWeekly: reportingAnalyticsWeekly,
+    errors: reportingErrors,
 };

package/dist/types.d.ts

@@ -1,8 +1,8 @@
 import type { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
 import type { RecentEvent, RecentOptions, SeriesOptions, SeriesPoint, WeeklyPoint } from './analytics/reader.js';
 import type { Device } from './analytics/schema.js';
-import type { Actor, EventInput, FlatData, Level } from './schema.js';
-import type { ReportingEventRow, tables } from './tables.js';
+import type { Actor, ErrorRuntime, ErrorState, EventInput, FlatData, Level } from './schema.js';
+import type { ReportingErrorRow, ReportingEventRow, tables } from './tables.js';
 /**
  * The host's drizzle handle, whatever driver it runs on. postgres-js in the
  * apps, PGlite in this package's own tests; the queries here use nothing
@@ -82,6 +82,35 @@ export interface EventsPage {
         readonly id: number;
     } | null;
 }
+export interface ErrorsPageOptions {
+    readonly limit?: number;
+    readonly after?: {
+        readonly lastSeenAt: Date;
+        readonly fingerprint: string;
+    };
+    readonly site?: string;
+    readonly state?: ErrorState;
+    readonly runtime?: ErrorRuntime;
+}
+export interface ErrorsPage {
+    readonly items: readonly ReportingErrorRow[];
+    readonly next: {
+        readonly lastSeenAt: Date;
+        readonly fingerprint: string;
+    } | null;
+}
+/**
+ * What `captureError` knows about an exception's surroundings; every field
+ * is optional because a boot-time crash has none of them.
+ */
+export interface CaptureContext {
+    readonly runtime?: ErrorRuntime;
+    readonly tenantId?: string | null;
+    readonly requestId?: string | null;
+    readonly release?: string | null;
+    /** Overrides `errorKind(error)` when the caller already knows the class name better than the thrown value can say — a JSON-serialised browser report, say. */
+    readonly kind?: string;
+}
 export interface Stats {
     readonly queued: number;
     readonly dropped: number;
@@ -121,6 +150,8 @@ export interface Reporting {
     event(input: EventInput): void;
     /** An `alert.<check>` row at level `alert`, then the host's `onAlert`. */
     alert(finding: AlertFinding): void;
+    /** An uncaught exception, redacted and fingerprinted (./errors/capture.js). Never throws. */
+    captureError(error: unknown, context?: CaptureContext): void;
     /** Drain the queue now. Bounded by `deadlineMs` (default 5,000). Never throws. */
     flush(opts?: {
         deadlineMs?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wtfalch/reporting",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "The estate's operational event log and housekeeping tick: a writer that never fails a request, a claim protocol that needs no scheduler, and the readers an operator opens. Per-app Postgres, host-supplied logger, framework-neutral core with a Next entry.",
   "repository": {
     "type": "git",
@@ -42,6 +42,10 @@
       "types": "./dist/react/charts.d.ts",
       "default": "./dist/react/charts.js"
     },
+    "./react/errors": {
+      "types": "./dist/react/errors.d.ts",
+      "default": "./dist/react/errors.js"
+    },
     "./migrations/*.sql": "./dist/migrations/*.sql",
     "./package.json": "./package.json"
   },