@spfn/monitor 0.1.0-beta.1

package/dist/index.d.ts

@@ -0,0 +1,157 @@
+import * as _spfn_core_nextjs from '@spfn/core/nextjs';
+import * as _spfn_core_route from '@spfn/core/route';
+import * as _sinclair_typebox from '@sinclair/typebox';
+import { M as MonitorStats, m as monitorRouter } from './index-C9IUDNIv.js';
+export { a as ERROR_GROUP_STATUSES, E as ErrorGroupStatus, b as LOG_LEVELS, L as LogLevel } from './index-C9IUDNIv.js';
+import 'drizzle-orm/pg-core';
+
+/**
+ * Type-safe API client for monitor routes
+ *
+ * @example
+ * ```typescript
+ * import { monitorApi } from '@spfn/monitor';
+ *
+ * // Get dashboard stats
+ * const stats = await monitorApi.getStats.call({});
+ *
+ * // List errors
+ * const errors = await monitorApi.listErrors.call({
+ *     query: { status: 'active', limit: 20 }
+ * });
+ * ```
+ */
+declare const monitorApi: _spfn_core_nextjs.Client<_spfn_core_route.Router<{
+    listErrors: _spfn_core_route.RouteDef<{
+        query: _sinclair_typebox.TObject<{
+            status: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            path: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            search: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            dateFrom: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            dateTo: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            limit: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+            offset: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+        }>;
+    }, {}, {
+        status: "active" | "resolved" | "ignored";
+        path: string;
+        id: number;
+        fingerprint: string;
+        name: string;
+        message: string;
+        method: string;
+        statusCode: number;
+        count: number;
+        firstSeenAt: Date;
+        lastSeenAt: Date;
+        resolvedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }[]>;
+    getErrorDetail: _spfn_core_route.RouteDef<{
+        params: _sinclair_typebox.TObject<{
+            id: _sinclair_typebox.TNumber;
+        }>;
+    }, {}, {
+        group: {
+            status: "active" | "resolved" | "ignored";
+            path: string;
+            id: number;
+            fingerprint: string;
+            name: string;
+            message: string;
+            method: string;
+            statusCode: number;
+            count: number;
+            firstSeenAt: Date;
+            lastSeenAt: Date;
+            resolvedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+        };
+        events: {
+            query: Record<string, string> | null;
+            id: number;
+            statusCode: number;
+            createdAt: Date;
+            updatedAt: Date;
+            headers: Record<string, string> | null;
+            groupId: number;
+            requestId: string | null;
+            userId: string | null;
+            stackTrace: string | null;
+            metadata: Record<string, unknown> | null;
+        }[];
+    }>;
+    updateErrorStatus: _spfn_core_route.RouteDef<{
+        params: _sinclair_typebox.TObject<{
+            id: _sinclair_typebox.TNumber;
+        }>;
+        body: _sinclair_typebox.TObject<{
+            status: _sinclair_typebox.TString;
+        }>;
+    }, {}, {
+        status: "active" | "resolved" | "ignored";
+        path: string;
+        id: number;
+        fingerprint: string;
+        name: string;
+        message: string;
+        method: string;
+        statusCode: number;
+        count: number;
+        firstSeenAt: Date;
+        lastSeenAt: Date;
+        resolvedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    listErrorEvents: _spfn_core_route.RouteDef<{
+        params: _sinclair_typebox.TObject<{
+            id: _sinclair_typebox.TNumber;
+        }>;
+        query: _sinclair_typebox.TObject<{
+            limit: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+            offset: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+        }>;
+    }, {}, {
+        query: Record<string, string> | null;
+        id: number;
+        statusCode: number;
+        createdAt: Date;
+        updatedAt: Date;
+        headers: Record<string, string> | null;
+        groupId: number;
+        requestId: string | null;
+        userId: string | null;
+        stackTrace: string | null;
+        metadata: Record<string, unknown> | null;
+    }[]>;
+    listLogs: _spfn_core_route.RouteDef<{
+        query: _sinclair_typebox.TObject<{
+            level: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            source: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            search: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            requestId: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            userId: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            dateFrom: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            dateTo: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            limit: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+            offset: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+        }>;
+    }, {}, {
+        id: number;
+        message: string;
+        createdAt: Date;
+        updatedAt: Date;
+        requestId: string | null;
+        userId: string | null;
+        metadata: Record<string, unknown> | null;
+        level: "debug" | "info" | "warn" | "error" | "fatal";
+        source: string | null;
+    }[]>;
+    getStats: _spfn_core_route.RouteDef<{}, {}, MonitorStats>;
+}>>;
+type MonitorRouter = typeof monitorRouter;
+
+export { type MonitorRouter, MonitorStats, monitorApi };

package/dist/index.js

@@ -0,0 +1,105 @@
+// src/index.ts
+import { createApi } from "@spfn/core/nextjs";
+
+// src/server/entities/schema.ts
+import { createSchema } from "@spfn/core/db";
+var monitorSchema = createSchema("@spfn/monitor");
+
+// src/server/entities/error-groups.ts
+import { text, integer, index } from "drizzle-orm/pg-core";
+import { id, timestamps, enumText, utcTimestamp } from "@spfn/core/db";
+var ERROR_GROUP_STATUSES = ["active", "resolved", "ignored"];
+var errorGroups = monitorSchema.table(
+  "error_groups",
+  {
+    // Primary Key
+    id: id(),
+    // Business Key — SHA-256 first 16 hex chars of (name:message:path)
+    fingerprint: text("fingerprint").notNull().unique(),
+    // Error identification
+    name: text("name").notNull(),
+    message: text("message").notNull(),
+    path: text("path").notNull(),
+    method: text("method").notNull(),
+    statusCode: integer("status_code").notNull(),
+    // Status
+    status: enumText("status", ERROR_GROUP_STATUSES).default("active").notNull(),
+    // Counters
+    count: integer("count").notNull().default(1),
+    // Timeline
+    firstSeenAt: utcTimestamp("first_seen_at").notNull(),
+    lastSeenAt: utcTimestamp("last_seen_at").notNull(),
+    resolvedAt: utcTimestamp("resolved_at"),
+    ...timestamps()
+  },
+  (table) => [
+    index("monitor_eg_fingerprint_idx").on(table.fingerprint),
+    index("monitor_eg_status_idx").on(table.status),
+    index("monitor_eg_last_seen_at_idx").on(table.lastSeenAt),
+    index("monitor_eg_path_idx").on(table.path)
+  ]
+);
+
+// src/server/entities/error-events.ts
+import { text as text2, integer as integer2, jsonb, index as index2 } from "drizzle-orm/pg-core";
+import { id as id2, timestamps as timestamps2, foreignKey } from "@spfn/core/db";
+var errorEvents = monitorSchema.table(
+  "error_events",
+  {
+    // Primary Key
+    id: id2(),
+    // Foreign Key
+    groupId: foreignKey("group", () => errorGroups.id).notNull(),
+    // Request context
+    requestId: text2("request_id"),
+    userId: text2("user_id"),
+    statusCode: integer2("status_code").notNull(),
+    // Request details
+    headers: jsonb("headers").$type(),
+    query: jsonb("query").$type(),
+    stackTrace: text2("stack_trace"),
+    metadata: jsonb("metadata").$type(),
+    ...timestamps2()
+  },
+  (table) => [
+    index2("monitor_ee_group_id_idx").on(table.groupId),
+    index2("monitor_ee_created_at_idx").on(table.createdAt),
+    index2("monitor_ee_user_id_idx").on(table.userId)
+  ]
+);
+
+// src/server/entities/logs.ts
+import { text as text3, jsonb as jsonb2, index as index3 } from "drizzle-orm/pg-core";
+import { id as id3, timestamps as timestamps3, enumText as enumText2 } from "@spfn/core/db";
+var LOG_LEVELS = ["debug", "info", "warn", "error", "fatal"];
+var logs = monitorSchema.table(
+  "logs",
+  {
+    // Primary Key
+    id: id3(),
+    // Log data
+    level: enumText2("level", LOG_LEVELS).notNull(),
+    message: text3("message").notNull(),
+    source: text3("source"),
+    // Request context
+    requestId: text3("request_id"),
+    userId: text3("user_id"),
+    // Extra data
+    metadata: jsonb2("metadata").$type(),
+    ...timestamps3()
+  },
+  (table) => [
+    index3("monitor_log_level_idx").on(table.level),
+    index3("monitor_log_source_idx").on(table.source),
+    index3("monitor_log_created_at_idx").on(table.createdAt)
+  ]
+);
+
+// src/index.ts
+var monitorApi = createApi({});
+export {
+  ERROR_GROUP_STATUSES,
+  LOG_LEVELS,
+  monitorApi
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/server/entities/schema.ts","../src/server/entities/error-groups.ts","../src/server/entities/error-events.ts","../src/server/entities/logs.ts"],"sourcesContent":["/**\n * @spfn/monitor\n *\n * Error tracking, log management, and monitoring dashboard for SPFN\n *\n * @example\n * ```typescript\n * // Server-side\n * import { monitorRouter, createMonitorErrorHandler } from '@spfn/monitor/server';\n *\n * // Client-side (API calls)\n * import { monitorApi } from '@spfn/monitor';\n * const stats = await monitorApi.getStats.call({});\n * ```\n */\n\n// ============================================================================\n// API Client\n// ============================================================================\nimport { createApi } from '@spfn/core/nextjs';\nimport { monitorRouter } from './server/routes';\n\n/**\n * Type-safe API client for monitor routes\n *\n * @example\n * ```typescript\n * import { monitorApi } from '@spfn/monitor';\n *\n * // Get dashboard stats\n * const stats = await monitorApi.getStats.call({});\n *\n * // List errors\n * const errors = await monitorApi.listErrors.call({\n *     query: { status: 'active', limit: 20 }\n * });\n * ```\n */\nexport const monitorApi = createApi<typeof monitorRouter>({});\n\n// Router type for external use\nexport type MonitorRouter = typeof monitorRouter;\n\n// ============================================================================\n// Shared Types (client-safe)\n// ============================================================================\nexport type {\n    ErrorGroupStatus,\n    LogLevel,\n} from './server/entities';\n\nexport type { MonitorStats } from './server/services/stats.service';\n\nexport {\n    ERROR_GROUP_STATUSES,\n    LOG_LEVELS,\n} from './server/entities';\n","/**\n * @spfn/monitor - Database Schema Definition\n *\n * Defines the 'spfn_monitor' PostgreSQL schema for all monitor-related tables\n */\n\nimport { createSchema } from '@spfn/core/db';\n\n/**\n * Monitor schema for all monitoring tables\n * Tables: error_groups, error_events, logs\n */\nexport const monitorSchema = createSchema('@spfn/monitor');\n","/**\n * @spfn/monitor - Error Groups Entity\n *\n * Groups errors by fingerprint (name + message + path) to avoid\n * duplicate tracking. Tracks count, status, and first/last seen times.\n */\n\nimport { text, integer, index } from 'drizzle-orm/pg-core';\nimport { id, timestamps, enumText, utcTimestamp } from '@spfn/core/db';\nimport { monitorSchema } from './schema';\n\n/**\n * Error group status types\n */\nexport const ERROR_GROUP_STATUSES = ['active', 'resolved', 'ignored'] as const;\nexport type ErrorGroupStatus = typeof ERROR_GROUP_STATUSES[number];\n\n/**\n * Error groups table — groups errors by fingerprint\n */\nexport const errorGroups = monitorSchema.table('error_groups',\n    {\n        // Primary Key\n        id: id(),\n\n        // Business Key — SHA-256 first 16 hex chars of (name:message:path)\n        fingerprint: text('fingerprint').notNull().unique(),\n\n        // Error identification\n        name: text('name').notNull(),\n        message: text('message').notNull(),\n        path: text('path').notNull(),\n        method: text('method').notNull(),\n        statusCode: integer('status_code').notNull(),\n\n        // Status\n        status: enumText('status', ERROR_GROUP_STATUSES).default('active').notNull(),\n\n        // Counters\n        count: integer('count').notNull().default(1),\n\n        // Timeline\n        firstSeenAt: utcTimestamp('first_seen_at').notNull(),\n        lastSeenAt: utcTimestamp('last_seen_at').notNull(),\n        resolvedAt: utcTimestamp('resolved_at'),\n\n        ...timestamps(),\n    },\n    (table) => [\n        index('monitor_eg_fingerprint_idx').on(table.fingerprint),\n        index('monitor_eg_status_idx').on(table.status),\n        index('monitor_eg_last_seen_at_idx').on(table.lastSeenAt),\n        index('monitor_eg_path_idx').on(table.path),\n    ]\n);\n\nexport type ErrorGroup = typeof errorGroups.$inferSelect;\nexport type NewErrorGroup = typeof errorGroups.$inferInsert;\n","/**\n * @spfn/monitor - Error Events Entity\n *\n * Individual error occurrences linked to an error group.\n * Stores request-specific context (headers, query, stack trace).\n */\n\nimport { text, integer, jsonb, index } from 'drizzle-orm/pg-core';\nimport { id, timestamps, foreignKey } from '@spfn/core/db';\nimport { monitorSchema } from './schema';\nimport { errorGroups } from './error-groups';\n\n/**\n * Error events table — individual error occurrences\n */\nexport const errorEvents = monitorSchema.table('error_events',\n    {\n        // Primary Key\n        id: id(),\n\n        // Foreign Key\n        groupId: foreignKey('group', () => errorGroups.id).notNull(),\n\n        // Request context\n        requestId: text('request_id'),\n        userId: text('user_id'),\n        statusCode: integer('status_code').notNull(),\n\n        // Request details\n        headers: jsonb('headers').$type<Record<string, string>>(),\n        query: jsonb('query').$type<Record<string, string>>(),\n        stackTrace: text('stack_trace'),\n        metadata: jsonb('metadata').$type<Record<string, unknown>>(),\n\n        ...timestamps(),\n    },\n    (table) => [\n        index('monitor_ee_group_id_idx').on(table.groupId),\n        index('monitor_ee_created_at_idx').on(table.createdAt),\n        index('monitor_ee_user_id_idx').on(table.userId),\n    ]\n);\n\nexport type ErrorEvent = typeof errorEvents.$inferSelect;\nexport type NewErrorEvent = typeof errorEvents.$inferInsert;\n","/**\n * @spfn/monitor - Logs Entity\n *\n * Developer logs stored in DB for retrieval via admin dashboard.\n * Supports level-based filtering, source tracking, and metadata.\n */\n\nimport { text, jsonb, index } from 'drizzle-orm/pg-core';\nimport { id, timestamps, enumText } from '@spfn/core/db';\nimport { monitorSchema } from './schema';\n\n/**\n * Log level types\n */\nexport const LOG_LEVELS = ['debug', 'info', 'warn', 'error', 'fatal'] as const;\nexport type LogLevel = typeof LOG_LEVELS[number];\n\n/**\n * Logs table — developer log entries\n */\nexport const logs = monitorSchema.table('logs',\n    {\n        // Primary Key\n        id: id(),\n\n        // Log data\n        level: enumText('level', LOG_LEVELS).notNull(),\n        message: text('message').notNull(),\n        source: text('source'),\n\n        // Request context\n        requestId: text('request_id'),\n        userId: text('user_id'),\n\n        // Extra data\n        metadata: jsonb('metadata').$type<Record<string, unknown>>(),\n\n        ...timestamps(),\n    },\n    (table) => [\n        index('monitor_log_level_idx').on(table.level),\n        index('monitor_log_source_idx').on(table.source),\n        index('monitor_log_created_at_idx').on(table.createdAt),\n    ]\n);\n\nexport type Log = typeof logs.$inferSelect;\nexport type NewLog = typeof logs.$inferInsert;\n"],"mappings":"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","names":["text","integer","index","id","timestamps","id","text","integer","timestamps","index","text","jsonb","index","id","timestamps","enumText","id","enumText","text","jsonb","timestamps","index"]}

package/dist/nextjs/client.d.ts

@@ -0,0 +1,45 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * @spfn/monitor - Monitor Dashboard Component
+ *
+ * Main entry point combining StatsOverview, ErrorListView, and LogViewer in tabs
+ */
+declare function MonitorDashboard(): react_jsx_runtime.JSX.Element;
+
+/**
+ * @spfn/monitor - Stats Overview Component
+ *
+ * Displays error/log counts and trend indicators
+ */
+declare function StatsOverview(): react_jsx_runtime.JSX.Element;
+
+/**
+ * @spfn/monitor - Error List View Component
+ *
+ * Displays error groups in a filterable table with status badges
+ */
+interface ErrorListViewProps {
+    onSelect?: (id: number) => void;
+}
+declare function ErrorListView({ onSelect }: ErrorListViewProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @spfn/monitor - Error Detail View Component
+ *
+ * Shows error group details with event timeline and status change buttons
+ */
+interface ErrorDetailViewProps {
+    errorId: number;
+    onBack?: () => void;
+}
+declare function ErrorDetailView({ errorId, onBack }: ErrorDetailViewProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @spfn/monitor - Log Viewer Component
+ *
+ * Searchable, filterable log list with expandable metadata
+ */
+declare function LogViewer(): react_jsx_runtime.JSX.Element;
+
+export { ErrorDetailView, ErrorListView, LogViewer, MonitorDashboard, StatsOverview };