adonisjs-server-stats 1.5.3 → 1.6.1

package/dist/src/{edge/client → styles}/stats-bar.css

@@ -53,6 +53,16 @@
   }
 }
 
+/* ── Reset: inherit font-family on form elements ─────────────── */
+.ss-bar button,
+.ss-bar input,
+.ss-bar select,
+.ss-bar textarea,
+.ss-toggle button,
+.ss-toggle input {
+  font-family: inherit;
+}
+
 /* ── Theme: Light (manual override) ───────────────────────────── */
 .ss-bar[data-ss-theme='light'],
 .ss-toggle[data-ss-theme='light'] {
@@ -113,11 +123,7 @@
   flex: 1;
   min-width: 0;
   padding-right: 8px;
-  scrollbar-width: none;
-  -ms-overflow-style: none;
-}
-.ss-bar-scroll::-webkit-scrollbar {
-  display: none;
+  /* scrollbar hiding → utilities.css */
 }
 
 .ss-group {
@@ -149,6 +155,9 @@
 .ss-badge-link {
   cursor: pointer;
 }
+.ss-badge-link:hover {
+  opacity: 0.85;
+}
 .ss-badge:hover {
   background: var(--ss-hover);
 }
@@ -165,7 +174,7 @@
 .ss-value {
   font-size: 11px;
   font-weight: 600;
-  font-variant-numeric: tabular-nums;
+  /* tabular-nums → utilities.css */
   color: var(--ss-accent);
 }
 
@@ -225,6 +234,16 @@
   bottom: 12px;
 }
 
+.ss-toggle-arrow {
+  font-size: 8px;
+  line-height: 1;
+}
+.ss-toggle-label {
+  font-size: 10px;
+  color: #737373;
+  margin-left: 4px;
+}
+
 .ss-toggle-summary {
   display: flex;
   align-items: center;
@@ -234,7 +253,7 @@
 .ss-toggle-summary .ss-value {
   font-size: 10px;
   font-weight: 600;
-  font-variant-numeric: tabular-nums;
+  /* tabular-nums → utilities.css */
 }
 
 /* Tooltip — positioned absolutely within .ss-bar (outside scroll area) via JS */
@@ -267,7 +286,6 @@
   cursor: pointer;
   padding: 0 4px;
   line-height: 1;
-  font-family: inherit;
 }
 .ss-tooltip-close:hover {
   color: var(--ss-text-bright);
@@ -288,7 +306,7 @@
 }
 .ss-tooltip-current {
   margin-top: 6px;
-  font-variant-numeric: tabular-nums;
+  /* tabular-nums → utilities.css */
 }
 .ss-tooltip-current-label {
   color: var(--ss-text-secondary);
@@ -302,7 +320,7 @@
   display: flex;
   gap: 12px;
   font-size: 10px;
-  font-variant-numeric: tabular-nums;
+  /* tabular-nums → utilities.css */
   color: var(--ss-text-secondary);
 }
 .ss-tooltip-details {

package/dist/src/styles/tokens.css

@@ -0,0 +1,153 @@
+/* Shared design tokens for adonisjs-server-stats.
+ * Extracted from dashboard.css — used by the full-page dashboard.
+ * Loaded via readFileSync and prepended at runtime (not via @import).
+ */
+
+/* ── Theme: Dark (default) ─────────────────────────────────────── */
+:root {
+  --ss-bg: #0f0f0f;
+  --ss-surface: #171717;
+  --ss-surface-alt: #141414;
+  --ss-text: #e5e5e5;
+  --ss-text-secondary: #b5b5b5;
+  --ss-accent: #34d399;
+  --ss-accent-dim: #064e3b;
+  --ss-border: #333;
+  --ss-border-dim: #262626;
+  --ss-border-faint: #1f1f1f;
+  --ss-muted: #9ca3af;
+  --ss-dim: #6b7280;
+  --ss-hover: rgba(38, 38, 38, 0.4);
+  --ss-hover-accent: rgba(52, 211, 153, 0.08);
+  --ss-input-bg: #1a1a1a;
+  --ss-shadow: rgb(0 0 0 / 0.4);
+  /* Status colors */
+  --ss-green-bg: #064e3b;
+  --ss-green-fg: #34d399;
+  --ss-blue-bg: #1e3a5f;
+  --ss-blue-fg: #60a5fa;
+  --ss-amber-bg: #422006;
+  --ss-amber-fg: #fbbf24;
+  --ss-red-bg: #450a0a;
+  --ss-red-fg: #f87171;
+  --ss-purple-bg: #2e1065;
+  --ss-purple-fg: #c084fc;
+  --ss-sql-color: #93c5fd;
+  --ss-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  --ss-text-primary: var(--ss-text);
+  --ss-reqid-bg: #1e1b2e;
+  --ss-reqid-fg: #6d28d9;
+  --ss-reqid-hover-bg: #2e2644;
+  --ss-reqid-hover-fg: #a78bfa;
+}
+
+/* ── Theme: Dark (explicit toggle override) ───────────────────── */
+[data-theme='dark'] {
+  --ss-bg: #0f0f0f;
+  --ss-surface: #171717;
+  --ss-surface-alt: #141414;
+  --ss-text: #e5e5e5;
+  --ss-text-secondary: #b5b5b5;
+  --ss-accent: #34d399;
+  --ss-accent-dim: #064e3b;
+  --ss-border: #333;
+  --ss-border-dim: #262626;
+  --ss-border-faint: #1f1f1f;
+  --ss-muted: #9ca3af;
+  --ss-dim: #6b7280;
+  --ss-hover: rgba(38, 38, 38, 0.4);
+  --ss-hover-accent: rgba(52, 211, 153, 0.08);
+  --ss-input-bg: #1a1a1a;
+  --ss-shadow: rgb(0 0 0 / 0.4);
+  --ss-green-bg: #064e3b;
+  --ss-green-fg: #34d399;
+  --ss-blue-bg: #1e3a5f;
+  --ss-blue-fg: #60a5fa;
+  --ss-amber-bg: #422006;
+  --ss-amber-fg: #fbbf24;
+  --ss-red-bg: #450a0a;
+  --ss-red-fg: #f87171;
+  --ss-purple-bg: #2e1065;
+  --ss-purple-fg: #c084fc;
+  --ss-sql-color: #93c5fd;
+  --ss-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  --ss-text-primary: var(--ss-text);
+  --ss-reqid-bg: #1e1b2e;
+  --ss-reqid-fg: #6d28d9;
+  --ss-reqid-hover-bg: #2e2644;
+  --ss-reqid-hover-fg: #a78bfa;
+}
+
+/* ── Theme: Light ──────────────────────────────────────────────── */
+@media (prefers-color-scheme: light) {
+  :root:not([data-theme='dark']) {
+    --ss-bg: #fafafa;
+    --ss-surface: #ffffff;
+    --ss-surface-alt: #f5f5f5;
+    --ss-text: #171717;
+    --ss-text-secondary: #525252;
+    --ss-accent: #059669;
+    --ss-accent-dim: #d1fae5;
+    --ss-border: #e5e5e5;
+    --ss-border-dim: #e5e5e5;
+    --ss-border-faint: #f0f0f0;
+    --ss-muted: #6b7280;
+    --ss-dim: #9ca3af;
+    --ss-hover: rgba(0, 0, 0, 0.03);
+    --ss-hover-accent: rgba(5, 150, 105, 0.06);
+    --ss-input-bg: #ffffff;
+    --ss-shadow: rgb(0 0 0 / 0.08);
+    --ss-green-bg: #d1fae5;
+    --ss-green-fg: #059669;
+    --ss-blue-bg: #dbeafe;
+    --ss-blue-fg: #2563eb;
+    --ss-amber-bg: #fef3c7;
+    --ss-amber-fg: #b45309;
+    --ss-red-bg: #fee2e2;
+    --ss-red-fg: #dc2626;
+    --ss-purple-bg: #ede9fe;
+    --ss-purple-fg: #7c3aed;
+    --ss-sql-color: #2563eb;
+    --ss-text-primary: var(--ss-text);
+    --ss-reqid-bg: #ede9fe;
+    --ss-reqid-fg: #7c3aed;
+    --ss-reqid-hover-bg: #ddd6fe;
+    --ss-reqid-hover-fg: #6d28d9;
+  }
+}
+
+/* ── Theme: Light (explicit toggle override) ──────────────────── */
+[data-theme='light'] {
+  --ss-bg: #fafafa;
+  --ss-surface: #ffffff;
+  --ss-surface-alt: #f5f5f5;
+  --ss-text: #171717;
+  --ss-text-secondary: #525252;
+  --ss-accent: #059669;
+  --ss-accent-dim: #d1fae5;
+  --ss-border: #e5e5e5;
+  --ss-border-dim: #e5e5e5;
+  --ss-border-faint: #f0f0f0;
+  --ss-muted: #6b7280;
+  --ss-dim: #9ca3af;
+  --ss-hover: rgba(0, 0, 0, 0.03);
+  --ss-hover-accent: rgba(5, 150, 105, 0.06);
+  --ss-input-bg: #ffffff;
+  --ss-shadow: rgb(0 0 0 / 0.08);
+  --ss-green-bg: #d1fae5;
+  --ss-green-fg: #059669;
+  --ss-blue-bg: #dbeafe;
+  --ss-blue-fg: #2563eb;
+  --ss-amber-bg: #fef3c7;
+  --ss-amber-fg: #b45309;
+  --ss-red-bg: #fee2e2;
+  --ss-red-fg: #dc2626;
+  --ss-purple-bg: #ede9fe;
+  --ss-purple-fg: #7c3aed;
+  --ss-sql-color: #2563eb;
+  --ss-text-primary: var(--ss-text);
+  --ss-reqid-bg: #ede9fe;
+  --ss-reqid-fg: #7c3aed;
+  --ss-reqid-hover-bg: #ddd6fe;
+  --ss-reqid-hover-fg: #6d28d9;
+}

package/dist/src/styles/utilities.css

@@ -0,0 +1,75 @@
+/* Reusable utility classes for adonisjs-server-stats.
+ * Each utility groups all selectors that share the same pattern,
+ * so the inline declarations can be removed from individual CSS files.
+ *
+ * Loaded AFTER tokens.css + components.css, BEFORE dashboard/debug/stats-bar.
+ */
+
+/* ── Scrollbar hiding ────────────────────────────────────────── */
+.ss-u-no-scrollbar,
+.ss-dash-sidebar,
+.ss-bar-scroll,
+.ss-dbg-tabs-scroll,
+.ss-dbg-pane,
+.ss-dbg-data-full,
+#ss-dbg-tl-waterfall,
+.ss-dbg-cache-detail pre,
+.ss-dbg-config-table-wrap {
+  scrollbar-width: none;
+  -ms-overflow-style: none;
+}
+.ss-u-no-scrollbar::-webkit-scrollbar,
+.ss-dash-sidebar::-webkit-scrollbar,
+.ss-bar-scroll::-webkit-scrollbar,
+.ss-dbg-tabs-scroll::-webkit-scrollbar,
+.ss-dbg-pane::-webkit-scrollbar,
+.ss-dbg-data-full::-webkit-scrollbar,
+#ss-dbg-tl-waterfall::-webkit-scrollbar,
+.ss-dbg-cache-detail pre::-webkit-scrollbar,
+.ss-dbg-config-table-wrap::-webkit-scrollbar {
+  display: none;
+}
+
+/* ── Text truncation ─────────────────────────────────────────── */
+/* NOTE: table td, tl-label, info-card-value, config-inner-table td
+ * are already in components.css — not duplicated here. */
+.ss-u-truncate,
+.ss-dash-sql,
+.ss-dash-secondary-list li > span:first-child,
+.ss-dash-env-key,
+.ss-dash-env-val,
+.ss-dash-widget-row-link > span:first-child,
+.ss-dbg-sql,
+.ss-dbg-event-name,
+.ss-dbg-event-data,
+.ss-dbg-data-preview,
+.ss-dbg-data-cell,
+.ss-dbg-tl-detail-url,
+.ss-dbg-env-key,
+.ss-dbg-env-val {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* ── Tabular numbers ─────────────────────────────────────────── */
+/* NOTE: duration, log-time, tl-dur are already in components.css — not
+ * duplicated here. */
+.ss-u-tabular,
+.ss-dash-nav-badge,
+.ss-dash-event-time,
+.ss-dash-card-value,
+.ss-dash-secondary-list-value,
+.ss-dash-cache-stat-value,
+.ss-dash-job-stat-value,
+.ss-dash-widget-stat-value,
+.ss-value,
+.ss-toggle-summary .ss-value,
+.ss-tooltip-current,
+.ss-tooltip-stats,
+.ss-dbg-event-time,
+.ss-dbg-mini-stat-value,
+.ss-dbg-cache-stat-value,
+.ss-dbg-job-stat-value {
+  font-variant-numeric: tabular-nums;
+}

package/dist/src/types.d.ts

@@ -298,23 +298,73 @@ export interface DevToolbarOptions {
      * @default '/admin/api/debug'
      */
     debugEndpoint?: string;
+    /**
+     * Client-side rendering library for the Edge integration.
+     *
+     * - `'preact'` — lightweight Preact + React-compat components (default)
+     * - `'vue'` — Vue 3 components (ideal if your app already uses Vue / Inertia)
+     *
+     * Both renderers share the same CSS and JSON config; only the JS bundle differs.
+     *
+     * @default 'preact'
+     */
+    renderer?: 'preact' | 'vue';
+}
+/**
+ * Toolbar settings (new simplified config).
+ * Maps to the relevant fields in DevToolbarOptions.
+ */
+export interface ToolbarConfig {
+    slowQueryThreshold?: number;
+    tracing?: boolean;
+    persist?: boolean;
+    panes?: DebugPane[];
+    excludeFromTracing?: string[];
+}
+/**
+ * Dashboard settings (new simplified config).
+ * Maps to devToolbar.dashboard + devToolbar.dashboardPath + devToolbar.retentionDays.
+ */
+export interface DashboardConfig {
+    path?: string;
+    retentionDays?: number;
+}
+/**
+ * Advanced options that most users never need.
+ */
+export interface AdvancedConfig {
+    skipInTest?: boolean;
+    channelName?: string;
+    debugEndpoint?: string;
+    renderer?: 'preact' | 'vue';
+    dbPath?: string;
+    persistPath?: string;
+    maxQueries?: number;
+    maxEvents?: number;
+    maxEmails?: number;
+    maxTraces?: number;
 }
 /**
  * Top-level configuration for `adonisjs-server-stats`.
  *
  * Pass this to {@link defineConfig} in `config/server_stats.ts`.
+ * All fields are optional — `defineConfig({})` works out of the box.
  *
  * @example
  * ```ts
+ * // Minimal — zero config, auto-detects everything
  * import { defineConfig } from 'adonisjs-server-stats'
- * import { processCollector, httpCollector } from 'adonisjs-server-stats/collectors'
+ * export default defineConfig({})
+ * ```
  *
+ * @example
+ * ```ts
+ * // Common setup
+ * import { defineConfig } from 'adonisjs-server-stats'
  * export default defineConfig({
- *   intervalMs: 3000,
- *   transport: 'transmit',
- *   channelName: 'admin/server-stats',
- *   endpoint: '/admin/api/server-stats',
- *   collectors: [processCollector(), httpCollector()],
+ *   authorize: (ctx) => ctx.auth?.user?.role === 'admin',
+ *   toolbar: true,
+ *   dashboard: true,
  * })
  * ```
  */
@@ -327,8 +377,9 @@ export interface ServerStatsConfig {
      * CPU and network overhead.
      *
      * @default 3000
+     * @deprecated Use {@link pollInterval} instead. Will be removed in the next major version.
      */
-    intervalMs: number;
+    intervalMs?: number;
     /**
      * How collected stats are pushed to connected clients.
      *
@@ -338,8 +389,9 @@ export interface ServerStatsConfig {
      *   HTTP endpoint.
      *
      * @default 'transmit'
+     * @deprecated Use {@link realtime} instead (`true` = transmit, `false` = none). Will be removed in the next major version.
      */
-    transport: 'transmit' | 'none';
+    transport?: 'transmit' | 'none';
     /**
      * Transmit channel name used for SSE broadcasting.
      *
@@ -347,8 +399,9 @@ export interface ServerStatsConfig {
      * Only relevant when `transport` is `'transmit'`.
      *
      * @default 'admin/server-stats'
+     * @deprecated Use `advanced.channelName` instead. Will be removed in the next major version.
      */
-    channelName: string;
+    channelName?: string;
     /**
      * HTTP endpoint path that returns the latest stats snapshot as JSON.
      *
@@ -356,14 +409,19 @@ export interface ServerStatsConfig {
      * (e.g. if you provide your own controller).
      *
      * @default '/admin/api/server-stats'
+     * @deprecated Use {@link statsEndpoint} instead. Will be removed in the next major version.
      */
-    endpoint: string | false;
+    endpoint?: string | false;
     /**
-     * Array of collector instances that will be run each tick.
+     * Collector instances that will be run each tick, or `'auto'`
+     * to let the package auto-detect available collectors.
+     *
+     * When an array is provided, order does not matter -- all
+     * collectors run in parallel via `Promise.all`. Each collector
+     * contributes a subset of fields to the merged
+     * {@link ServerStats} snapshot.
      *
-     * Order does not matter -- all collectors run in parallel via
-     * `Promise.all`. Each collector contributes a subset of fields
-     * to the merged {@link ServerStats} snapshot.
+     * @default 'auto'
      *
      * @example
      * ```ts
@@ -375,7 +433,7 @@ export interface ServerStatsConfig {
      * ]
      * ```
      */
-    collectors: MetricCollector[];
+    collectors?: 'auto' | MetricCollector[];
     /**
      * Skip metric collection during test runs (`NODE_ENV=test`).
      *
@@ -383,6 +441,7 @@ export interface ServerStatsConfig {
      * and speeds up the test suite.
      *
      * @default true
+     * @deprecated Use `advanced.skipInTest` instead. Will be removed in the next major version.
      */
     skipInTest?: boolean;
     /**
@@ -409,6 +468,7 @@ export interface ServerStatsConfig {
      * table, and live logs.
      *
      * @see {@link DevToolbarOptions}
+     * @deprecated Use {@link toolbar}, {@link dashboard}, and {@link advanced} instead. Will be removed in the next major version.
      */
     devToolbar?: DevToolbarOptions;
     /**
@@ -432,7 +492,50 @@ export interface ServerStatsConfig {
      * // Only in development
      * shouldShow: () => process.env.NODE_ENV === 'development'
      * ```
+     *
+     * @deprecated Use {@link authorize} instead. Will be removed in the next major version.
      */
-    shouldShow?: (ctx: any) => boolean;
+    shouldShow?: (ctx: import('@adonisjs/core/http').HttpContext) => boolean;
+    /** Alias for `intervalMs`. New preferred name. */
+    pollInterval?: number;
+    /** Alias for `transport`. `true` = 'transmit', `false` = 'none'. */
+    realtime?: boolean;
+    /** Alias for `endpoint`. New preferred name. */
+    statsEndpoint?: string | false;
+    /** Alias for `shouldShow`. New preferred name. */
+    authorize?: (ctx: import('@adonisjs/core/http').HttpContext) => boolean;
+    /** Enable toolbar. Alias for `devToolbar`. `true` = enabled with defaults. */
+    toolbar?: boolean | ToolbarConfig;
+    /** Enable dashboard. Top-level shortcut for `devToolbar.dashboard`. `true` = enabled at /__stats. */
+    dashboard?: boolean | DashboardConfig;
+    /** Advanced options. */
+    advanced?: AdvancedConfig;
+}
+/**
+ * Fully resolved configuration with all defaults applied.
+ *
+ * This is the return type of {@link defineConfig}. Consumers that
+ * read from `app.config.get('server_stats')` receive this type,
+ * so all required fields are guaranteed to be present.
+ */
+export interface ResolvedServerStatsConfig {
+    /** Collection interval in milliseconds. Always present after `defineConfig()`. */
+    intervalMs: number;
+    /** Transport mode. Always present after `defineConfig()`. */
+    transport: 'transmit' | 'none';
+    /** Transmit channel name. Always present after `defineConfig()`. */
+    channelName: string;
+    /** HTTP endpoint path or `false` to disable. Always present after `defineConfig()`. */
+    endpoint: string | false;
+    /** Collectors array or `'auto'`. Always present after `defineConfig()`. */
+    collectors: 'auto' | MetricCollector[];
+    /** Whether to skip collection in test environments. Always present after `defineConfig()`. */
+    skipInTest: boolean;
+    /** Optional per-tick callback. */
+    onStats?: (stats: Partial<ServerStats>) => void;
+    /** Optional dev toolbar configuration. */
+    devToolbar?: DevToolbarOptions;
+    /** Optional access-control callback. */
+    shouldShow?: (ctx: import('@adonisjs/core/http').HttpContext) => boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAMnD;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAG1B,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAA;IAEnB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IAEd,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAA;IAEnB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAA;IAEpB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAA;IAElB;;;;;;;;;;;OAWG;IACH,YAAY,EAAE,MAAM,CAAA;IAEpB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAA;IAIjB;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,CAAA;IAEzB;;;;;;;;OAQG;IACH,iBAAiB,EAAE,MAAM,CAAA;IAEzB;;;;;;;;;;OAUG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB,iDAAiD;IACjD,qBAAqB,EAAE,MAAM,CAAA;IAI7B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAA;IAElB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAA;IAElB,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAA;IAErB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAA;IAIjB,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAA;IAEhB,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAA;IAEzB,sDAAsD;IACtD,qBAAqB,EAAE,MAAM,CAAA;IAE7B,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAA;IAEtB;;;;;;;;;;OAUG;IACH,YAAY,EAAE,MAAM,CAAA;IAIpB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAA;IAEnB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAA;IAEpB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAA;IAEpB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAA;IAEnB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAA;IAIxB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAA;IAEvB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAA;IAEvB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAA;IAExB,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,CAAA;IAE3B,gDAAgD;IAChD,kBAAkB,EAAE,MAAM,CAAA;IAE1B,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAA;IAIpB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAA;IAEnB,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAA;IAEvB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAA;IAIrB,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAA;IAEvB,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,CAAA;IAEzB,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAA;IAExB,gEAAgE;IAChE,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAMD;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAA;IAEpB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAA;IAEtB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAA;IAErB,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAA;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAE7B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;IAEnB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAEnC;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;;;;;;;;;;;OAgBG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE7B;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;CAC5B;AAMD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;IAE/B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAEzB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAAA;IAEvC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,IAAI,CAAA;IAE/C;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAE9B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,qBAAqB,EAAE,WAAW,KAAK,OAAO,CAAA;IAMxE,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC9B,kDAAkD;IAClD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,qBAAqB,EAAE,WAAW,KAAK,OAAO,CAAA;IACvE,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,CAAA;IACjC,qGAAqG;IACrG,SAAS,CAAC,EAAE,OAAO,GAAG,eAAe,CAAA;IACrC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAA;CAC1B;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAA;IAElB,6DAA6D;IAC7D,SAAS,EAAE,UAAU,GAAG,MAAM,CAAA;IAE9B,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAA;IAEnB,uFAAuF;IACvF,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAA;IAExB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,GAAG,eAAe,EAAE,CAAA;IAEtC,8FAA8F;IAC9F,UAAU,EAAE,OAAO,CAAA;IAEnB,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,IAAI,CAAA;IAE/C,0CAA0C;IAC1C,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAE9B,wCAAwC;IACxC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,qBAAqB,EAAE,WAAW,KAAK,OAAO,CAAA;CACzE"}

package/dist/src/utils/json_helpers.d.ts

@@ -2,7 +2,7 @@
  * Shared JSON parsing utilities with safe fallbacks.
  */
 /** Safely parse a JSON string, returning the original value on failure. */
-export declare function safeParseJson(value: any): any;
+export declare function safeParseJson(value: unknown): unknown;
 /** Safely parse a JSON string expected to be an array, returning [] on failure. */
-export declare function safeParseJsonArray(value: any): any[];
+export declare function safeParseJsonArray(value: unknown): unknown[];
 //# sourceMappingURL=json_helpers.d.ts.map

package/dist/src/utils/json_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json_helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/json_helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAQ7C;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,CAGpD"}
+{"version":3,"file":"json_helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/json_helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQrD;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAG5D"}

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,17 @@
+export declare const dim: (s: string) => string;
+export declare const bold: (s: string) => string;
+export declare const green: (s: string) => string;
+export declare const yellow: (s: string) => string;
+export declare const log: {
+    /** Tagged info message. */
+    info(message: string): void;
+    /** Tagged warning (yellow). */
+    warn(message: string): void;
+    /** Tagged info with a blank line before. */
+    section(message: string): void;
+    /** Bulleted list under a section heading. */
+    list(heading: string, items: string[]): void;
+    /** Multi-line block (for code examples, hints, etc). */
+    block(heading: string, lines: string[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,WAAyB,CAAA;AACtD,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,WAAyB,CAAA;AACvD,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,WAA0B,CAAA;AACzD,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,WAA0B,CAAA;AAE1D,eAAO,MAAM,GAAG;IACd,2BAA2B;kBACb,MAAM;IAIpB,+BAA+B;kBACjB,MAAM;IAIpB,4CAA4C;qBAC3B,MAAM;IAIvB,6CAA6C;kBAC/B,MAAM,SAAS,MAAM,EAAE;IAMrC,wDAAwD;mBACzC,MAAM,SAAS,MAAM,EAAE;CAGvC,CAAA"}

package/dist/src/utils/logger.js

@@ -0,0 +1,27 @@
+const TAG = '\x1b[36m[ \x1b[1m🔍 server-stats\x1b[0m\x1b[36m ]\x1b[0m';
+export const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+export const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+export const green = (s) => `\x1b[32m${s}\x1b[0m`;
+export const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+export const log = {
+    /** Tagged info message. */
+    info(message) {
+        console.log(`${TAG} ${message}`);
+    },
+    /** Tagged warning (yellow). */
+    warn(message) {
+        console.warn(`${TAG} ${yellow(message)}`);
+    },
+    /** Tagged info with a blank line before. */
+    section(message) {
+        console.log(`\n${TAG} ${message}`);
+    },
+    /** Bulleted list under a section heading. */
+    list(heading, items) {
+        console.log(`\n${TAG} ${heading}\n` + items.map((item) => `  ${dim('→')} ${bold(item)}`).join('\n'));
+    },
+    /** Multi-line block (for code examples, hints, etc). */
+    block(heading, lines) {
+        console.log(`\n${TAG} ${heading}\n` + lines.map((l) => `  ${l}`).join('\n'));
+    },
+};

package/dist/src/utils/mail_helpers.d.ts

@@ -9,5 +9,5 @@
  * - An object: `{ address: "user@example.com", name: "User" }`
  * - An array of strings or objects
  */
-export declare function extractAddresses(value: any): string;
+export declare function extractAddresses(value: unknown): string;
 //# sourceMappingURL=mail_helpers.d.ts.map

package/dist/src/utils/mail_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mail_helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/mail_helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAWnD"}
+{"version":3,"file":"mail_helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/mail_helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcvD"}

package/dist/src/utils/mail_helpers.js

@@ -16,7 +16,7 @@ export function extractAddresses(value) {
         return value;
     if (Array.isArray(value)) {
         return value
-            .map((v) => (typeof v === 'string' ? v : v?.address || ''))
+            .map((v) => typeof v === 'string' ? v : v?.address || '')
             .filter(Boolean)
             .join(', ');
     }