adonisjs-server-stats 1.5.4 → 1.6.2

package/dist/core/theme.d.ts

@@ -0,0 +1,42 @@
+/**
+ * localStorage key for persisted theme preference.
+ */
+export declare const STORAGE_KEY = "ss-dash-theme";
+/**
+ * The two supported theme values.
+ */
+export type Theme = 'dark' | 'light';
+/**
+ * Read the current theme preference.
+ *
+ * Resolution order:
+ * 1. Explicit value stored in `localStorage` under {@link STORAGE_KEY}.
+ * 2. System preference via `prefers-color-scheme` media query.
+ * 3. Falls back to `'light'` if neither is available (e.g. SSR).
+ */
+export declare function getTheme(): Theme;
+/**
+ * Persist a theme preference to `localStorage` and notify
+ * all in-page listeners via a custom DOM event.
+ *
+ * Other tabs will be notified via the native `storage` event,
+ * which listeners created by {@link onThemeChange} also handle.
+ */
+export declare function setTheme(theme: Theme): void;
+/**
+ * Toggle the current theme and persist the new value.
+ *
+ * @returns The newly active theme.
+ */
+export declare function toggleTheme(): Theme;
+/**
+ * Subscribe to theme changes from:
+ * - Same-tab components (via custom {@link THEME_CHANGE_EVENT} event)
+ * - Other tabs (via native `storage` event)
+ * - System preference changes (via `prefers-color-scheme` media query)
+ *
+ * @param callback - Invoked with the new theme value whenever it changes.
+ * @returns An unsubscribe function that removes all listeners.
+ */
+export declare function onThemeChange(callback: (theme: Theme) => void): () => void;
+//# sourceMappingURL=theme.d.ts.map

package/dist/core/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/core/theme.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,WAAW,kBAAkB,CAAA;AAa1C;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;AAEpC;;;;;;;GAOG;AACH,wBAAgB,QAAQ,IAAI,KAAK,CAUhC;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAQ3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,KAAK,CAKnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CA6C1E"}

package/dist/core/trace-utils.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Raw trace detail as returned by the dashboard API.
+ *
+ * Fields may arrive in either snake_case or camelCase depending on the
+ * database driver / ORM serialization layer. Spans and warnings may be
+ * JSON-encoded strings when coming from SQLite.
+ */
+export interface TraceDetail {
+    method?: string;
+    url?: string;
+    status_code?: number;
+    statusCode?: number;
+    total_duration?: number;
+    totalDuration?: number;
+    duration?: number;
+    spanCount?: number;
+    span_count?: number;
+    spans: unknown[] | string;
+    warnings: string[] | string;
+}
+/**
+ * Normalized trace with consistent camelCase field names and parsed arrays.
+ */
+export interface NormalizedTrace {
+    method: string;
+    url: string;
+    statusCode: number;
+    totalDuration: number;
+    spanCount: number;
+    spans: unknown[];
+    warnings: string[];
+}
+/**
+ * Parse raw span data that may be a JSON string, an array, or undefined.
+ *
+ * The dashboard API may return spans as a JSON-encoded string when the
+ * underlying storage is SQLite. This function handles all cases and
+ * always returns a plain array.
+ */
+export declare function parseTraceSpans(raw: unknown): unknown[];
+/**
+ * Parse raw warning data that may be a JSON string, an array, or undefined.
+ *
+ * Same rationale as {@link parseTraceSpans} -- the warnings column may be
+ * stored as a JSON string in SQLite.
+ */
+export declare function parseTraceWarnings(raw: unknown): string[];
+/**
+ * Resolve a numeric field that may appear under a snake_case or camelCase key.
+ *
+ * Returns the first truthy value found, or the provided fallback (default `0`).
+ */
+export declare function resolveTraceField(trace: Record<string, unknown>, snakeKey: string, camelKey: string, fallback?: number): number;
+/**
+ * Normalize a raw trace record into a consistent shape with camelCase
+ * field names and parsed span/warning arrays.
+ *
+ * Handles both snake_case and camelCase field names, and parses spans
+ * and warnings from JSON strings if necessary.
+ */
+export declare function normalizeTraceFields(trace: Record<string, unknown>): NormalizedTrace;
+//# sourceMappingURL=trace-utils.d.ts.map

package/dist/core/trace-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-utils.d.ts","sourceRoot":"","sources":["../../src/core/trace-utils.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IACzB,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,EAAE,CAUvD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAUzD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAU,GACnB,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAapF"}

package/dist/core/transmit-adapter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Configuration for creating a Transmit SSE subscription.
+ */
+export interface TransmitSubscriptionConfig {
+    /** Base URL for the Transmit endpoint (same as the API base URL). */
+    baseUrl: string;
+    /** Transmit channel name (e.g. `'admin/server-stats'`). */
+    channelName: string;
+    /** Callback invoked with each incoming message payload. */
+    onMessage: (data: unknown) => void;
+    /** Callback invoked when an error occurs. */
+    onError?: (error: unknown) => void;
+    /** Optional Bearer token for auth. */
+    authToken?: string;
+}
+/**
+ * Handle returned by {@link createTransmitSubscription}.
+ */
+export interface TransmitSubscriptionHandle {
+    /** Subscribe to the channel and start receiving messages. */
+    subscribe: () => Promise<void>;
+    /** Unsubscribe and clean up. */
+    unsubscribe: () => Promise<void>;
+}
+export declare function createTransmitSubscription(config: TransmitSubscriptionConfig): TransmitSubscriptionHandle;
+/**
+ * Configuration for {@link subscribeToChannel}.
+ * Extends the base config with connect / disconnect lifecycle callbacks.
+ */
+export interface ChannelSubscriptionConfig {
+    /** Base URL for the Transmit endpoint. */
+    baseUrl: string;
+    /** Transmit channel name. */
+    channelName: string;
+    /** Optional Bearer token for auth. */
+    authToken?: string;
+    /** Callback invoked with each incoming message payload. */
+    onMessage: (data: unknown) => void;
+    /** Callback invoked when an error occurs. */
+    onError?: (error: unknown) => void;
+    /** Callback invoked once the subscription is established. */
+    onConnect?: () => void;
+    /** Callback invoked when the subscription is lost. */
+    onDisconnect?: () => void;
+}
+/**
+ * Subscribe to a Transmit channel and immediately start receiving messages.
+ *
+ * This is a convenience wrapper around {@link createTransmitSubscription} that
+ * auto-calls `subscribe()`, reports connect / disconnect via callbacks, and
+ * returns a simple `{ unsubscribe }` handle.
+ *
+ * @param config - Channel subscription configuration.
+ * @returns A handle with an `unsubscribe()` method.
+ */
+export declare function subscribeToChannel(config: ChannelSubscriptionConfig): {
+    unsubscribe: () => void;
+};
+//# sourceMappingURL=transmit-adapter.d.ts.map

package/dist/core/transmit-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transmit-adapter.d.ts","sourceRoot":"","sources":["../../src/core/transmit-adapter.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAA;IACnB,2DAA2D;IAC3D,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,6DAA6D;IAC7D,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,gCAAgC;IAChC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACjC;AAkDD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,0BAA0B,GACjC,0BAA0B,CAuE5B;AAMD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,yBAAyB,GAAG;IAAE,WAAW,EAAE,MAAM,IAAI,CAAA;CAAE,CAkCjG"}