adonisjs-server-stats 1.2.2 → 1.3.1

package/dist/src/dashboard/integrations/cache_inspector.d.ts

@@ -0,0 +1,88 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+export interface CacheStats {
+    /** Whether the Redis connection is alive. */
+    connected: boolean;
+    /** Total keyspace hits. */
+    hits: number;
+    /** Total keyspace misses. */
+    misses: number;
+    /** Hit rate as a percentage (0-100). */
+    hitRate: number;
+    /** Redis memory usage in bytes. */
+    memoryUsedBytes: number;
+    /** Human-readable memory usage (e.g. "12.34 MB"). */
+    memoryUsedHuman: string;
+    /** Number of connected clients. */
+    connectedClients: number;
+    /** Total number of keys across all databases. */
+    totalKeys: number;
+}
+export interface CacheKeyEntry {
+    /** The full key name. */
+    key: string;
+    /** Redis data type (string, list, set, hash, zset, stream). */
+    type: string;
+    /** TTL in seconds, or -1 if no expiry, or -2 if key does not exist. */
+    ttl: number;
+}
+export interface CacheKeyListResult {
+    /** Keys matching the scan pattern. */
+    keys: CacheKeyEntry[];
+    /** Cursor for the next SCAN iteration, or '0' when complete. */
+    cursor: string;
+}
+export interface CacheKeyDetail {
+    /** The full key name. */
+    key: string;
+    /** The stored value (stringified). */
+    value: string;
+    /** Redis data type. */
+    type: string;
+    /** TTL in seconds, or -1 if no expiry. */
+    ttl: number;
+    /** Approximate size in bytes (from MEMORY USAGE, if available). */
+    sizeBytes: number | null;
+}
+/**
+ * Inspects Redis cache keys, values, and statistics.
+ *
+ * Designed for the full-page dashboard's Cache section.
+ * All methods are safe to call even when Redis is unavailable --
+ * they catch errors and return sensible defaults.
+ */
+export declare class CacheInspector {
+    private redis;
+    constructor(redis: any);
+    /**
+     * Detect whether `@adonisjs/cache` or `@adonisjs/redis` is available
+     * in the application container.
+     */
+    static isAvailable(app: ApplicationService): Promise<boolean>;
+    /**
+     * Get high-level cache / Redis statistics.
+     */
+    getStats(): Promise<CacheStats>;
+    /**
+     * List keys using Redis SCAN (cursor-based, non-blocking).
+     *
+     * @param pattern  Glob pattern for key matching (default `'*'`).
+     * @param cursor   SCAN cursor from a previous call (default `'0'`).
+     * @param count    Hint for how many keys to return per call (default `100`).
+     */
+    listKeys(pattern?: string, cursor?: string, count?: number): Promise<CacheKeyListResult>;
+    /**
+     * Get full details for a single cache key.
+     */
+    getKey(key: string): Promise<CacheKeyDetail | null>;
+    /**
+     * Delete a cache key.
+     *
+     * @returns `true` if the key was deleted, `false` otherwise.
+     */
+    deleteKey(key: string): Promise<boolean>;
+    /**
+     * Read a key's value using the appropriate Redis command for its type.
+     */
+    private getValueByType;
+}
+//# sourceMappingURL=cache_inspector.d.ts.map

package/dist/src/dashboard/integrations/cache_inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache_inspector.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/integrations/cache_inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAM9D,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAA;IAElB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IAEZ,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;IAEd,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAA;IAEf,mCAAmC;IACnC,eAAe,EAAE,MAAM,CAAA;IAEvB,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAA;IAEvB,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAA;IAExB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAA;IAEX,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;IAEZ,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,aAAa,EAAE,CAAA;IAErB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAA;IAEX,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IAEb,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IAEZ,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAA;IAEX,mEAAmE;IACnE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAMD;;;;;;GAMG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,GAAG;IAE9B;;;OAGG;WACU,WAAW,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IASnE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAoDrC;;;;;;OAMG;IACG,QAAQ,CAAC,OAAO,SAAM,EAAE,MAAM,SAAM,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0BrF;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAqBzD;;;;OAIG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa9C;;OAEG;YACW,cAAc;CAkC7B"}

package/dist/src/dashboard/integrations/cache_inspector.js

@@ -0,0 +1,215 @@
+// ---------------------------------------------------------------------------
+// CacheInspector
+// ---------------------------------------------------------------------------
+/**
+ * Inspects Redis cache keys, values, and statistics.
+ *
+ * Designed for the full-page dashboard's Cache section.
+ * All methods are safe to call even when Redis is unavailable --
+ * they catch errors and return sensible defaults.
+ */
+export class CacheInspector {
+    redis;
+    constructor(redis) {
+        this.redis = redis;
+    }
+    /**
+     * Detect whether `@adonisjs/cache` or `@adonisjs/redis` is available
+     * in the application container.
+     */
+    static async isAvailable(app) {
+        try {
+            await app.container.make('redis');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get high-level cache / Redis statistics.
+     */
+    async getStats() {
+        const defaults = {
+            connected: false,
+            hits: 0,
+            misses: 0,
+            hitRate: 0,
+            memoryUsedBytes: 0,
+            memoryUsedHuman: '0 B',
+            connectedClients: 0,
+            totalKeys: 0,
+        };
+        try {
+            const pong = await this.redis.ping();
+            if (pong !== 'PONG')
+                return defaults;
+            const [memoryInfo, statsInfo, serverInfo, dbSize] = await Promise.all([
+                this.redis.info('memory'),
+                this.redis.info('stats'),
+                this.redis.info('clients'),
+                this.redis.dbsize(),
+            ]);
+            const memParsed = parseRedisInfo(memoryInfo);
+            const statsParsed = parseRedisInfo(statsInfo);
+            const clientsParsed = parseRedisInfo(serverInfo);
+            const memoryUsedBytes = safeInt(memParsed['used_memory']);
+            const memoryUsedHuman = memParsed['used_memory_human'] ?? formatBytes(memoryUsedBytes);
+            const connectedClients = safeInt(clientsParsed['connected_clients'] ?? memParsed['connected_clients'] ?? '0');
+            const hits = safeInt(statsParsed['keyspace_hits']);
+            const misses = safeInt(statsParsed['keyspace_misses']);
+            const total = hits + misses;
+            const hitRate = total > 0 ? (hits / total) * 100 : 0;
+            return {
+                connected: true,
+                hits,
+                misses,
+                hitRate,
+                memoryUsedBytes,
+                memoryUsedHuman,
+                connectedClients,
+                totalKeys: typeof dbSize === 'number' ? dbSize : 0,
+            };
+        }
+        catch {
+            return defaults;
+        }
+    }
+    /**
+     * List keys using Redis SCAN (cursor-based, non-blocking).
+     *
+     * @param pattern  Glob pattern for key matching (default `'*'`).
+     * @param cursor   SCAN cursor from a previous call (default `'0'`).
+     * @param count    Hint for how many keys to return per call (default `100`).
+     */
+    async listKeys(pattern = '*', cursor = '0', count = 100) {
+        try {
+            const [nextCursor, rawKeys] = await this.redis.scan(cursor, 'MATCH', pattern, 'COUNT', count);
+            const keys = await Promise.all(rawKeys.map(async (key) => {
+                const [type, ttl] = await Promise.all([
+                    this.redis.type(key),
+                    this.redis.ttl(key),
+                ]);
+                return { key, type, ttl };
+            }));
+            return { keys, cursor: String(nextCursor) };
+        }
+        catch {
+            return { keys: [], cursor: '0' };
+        }
+    }
+    /**
+     * Get full details for a single cache key.
+     */
+    async getKey(key) {
+        try {
+            const type = (await this.redis.type(key));
+            if (type === 'none')
+                return null;
+            const ttl = (await this.redis.ttl(key));
+            const value = await this.getValueByType(key, type);
+            let sizeBytes = null;
+            try {
+                sizeBytes = (await this.redis.call('MEMORY', 'USAGE', key));
+            }
+            catch {
+                // MEMORY USAGE may not be available on older Redis versions
+            }
+            return { key, value, type, ttl, sizeBytes };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Delete a cache key.
+     *
+     * @returns `true` if the key was deleted, `false` otherwise.
+     */
+    async deleteKey(key) {
+        try {
+            const count = (await this.redis.del(key));
+            return count > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Read a key's value using the appropriate Redis command for its type.
+     */
+    async getValueByType(key, type) {
+        try {
+            switch (type) {
+                case 'string': {
+                    const val = await this.redis.get(key);
+                    return val ?? '';
+                }
+                case 'list': {
+                    const items = await this.redis.lrange(key, 0, 99);
+                    return JSON.stringify(items);
+                }
+                case 'set': {
+                    const members = await this.redis.smembers(key);
+                    return JSON.stringify(members);
+                }
+                case 'zset': {
+                    const entries = await this.redis.zrange(key, 0, 99, 'WITHSCORES');
+                    return JSON.stringify(entries);
+                }
+                case 'hash': {
+                    const hash = await this.redis.hgetall(key);
+                    return JSON.stringify(hash);
+                }
+                case 'stream': {
+                    const messages = await this.redis.xrange(key, '-', '+', 'COUNT', 100);
+                    return JSON.stringify(messages);
+                }
+                default:
+                    return `(unsupported type: ${type})`;
+            }
+        }
+        catch {
+            return '(error reading value)';
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Utility functions
+// ---------------------------------------------------------------------------
+/**
+ * Parse a Redis INFO response string into a key-value record.
+ */
+function parseRedisInfo(info) {
+    const result = {};
+    for (const line of info.split('\r\n')) {
+        const idx = line.indexOf(':');
+        if (idx > 0) {
+            result[line.slice(0, idx)] = line.slice(idx + 1);
+        }
+    }
+    return result;
+}
+/**
+ * Safely parse a string to an integer, returning 0 on failure.
+ */
+function safeInt(value) {
+    if (!value)
+        return 0;
+    const n = Number.parseInt(value, 10);
+    return Number.isNaN(n) ? 0 : n;
+}
+/**
+ * Format bytes into a human-readable string.
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    const value = bytes / Math.pow(1024, i);
+    return `${value.toFixed(2)} ${units[i]}`;
+}

package/dist/src/dashboard/integrations/config_inspector.d.ts

@@ -0,0 +1,33 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+export interface RedactedValue {
+    __redacted: true;
+    display: string;
+    value: string;
+}
+export interface SanitizedConfig {
+    /** App configuration from `app.config.all()` with secrets redacted. */
+    config: Record<string, any>;
+}
+export interface SanitizedEnvVars {
+    /** Environment variables from `process.env` with secrets redacted. */
+    env: Record<string, string | RedactedValue>;
+}
+/**
+ * Reads and sanitizes application configuration and environment variables.
+ *
+ * Designed for the full-page dashboard's Config section.
+ * Automatically redacts values whose keys match sensitive patterns.
+ */
+export declare class ConfigInspector {
+    private app;
+    constructor(app: ApplicationService);
+    /**
+     * Get the full application config with sensitive values redacted.
+     */
+    getConfig(): SanitizedConfig;
+    /**
+     * Get environment variables with sensitive values redacted.
+     */
+    getEnvVars(): SanitizedEnvVars;
+}
+//# sourceMappingURL=config_inspector.d.ts.map

package/dist/src/dashboard/integrations/config_inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_inspector.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/integrations/config_inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAM9D,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,IAAI,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,CAAA;CAC5C;AA4DD;;;;;GAKG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,kBAAkB;IAE3C;;OAEG;IACH,SAAS,IAAI,eAAe;IAS5B;;OAEG;IACH,UAAU,IAAI,gBAAgB;CAmB/B"}

package/dist/src/dashboard/integrations/config_inspector.js

@@ -0,0 +1,155 @@
+// ---------------------------------------------------------------------------
+// Sensitive key patterns
+// ---------------------------------------------------------------------------
+/**
+ * Patterns matched against key names (case-insensitive) to detect secrets.
+ *
+ * Uses `(?:^|[_.-])` and `(?:$|[_.-])` as boundaries instead of `\b`
+ * because env vars use `_` as separators and `_` is a word character
+ * in regex, so `\b` won't match between `CLIENT` and `SECRET` in
+ * `GOOGLE_CLIENT_SECRET`.
+ */
+const B = '(?:^|[_.\\-])'; // boundary before
+const A = '(?:$|[_.\\-])'; // boundary after
+const SENSITIVE_PATTERNS = [
+    new RegExp(`${B}password${A}`, 'i'),
+    new RegExp(`${B}secret${A}`, 'i'),
+    new RegExp(`${B}token${A}`, 'i'),
+    new RegExp(`${B}credential${A}`, 'i'),
+    new RegExp(`${B}private${A}`, 'i'),
+    new RegExp(`${B}auth${A}`, 'i'),
+    // API keys: `api_key`, `apiKey`, `API_KEY`
+    /api[_-]?key/i,
+    // `_KEY` at end or `_KEY_` in middle (AWS_ACCESS_KEY_ID, ENCRYPTION_KEY, etc.)
+    /[_-]key([_-]|$)/i,
+    // ACCESS_KEY pattern (AWS credentials)
+    /access[_-]?key/i,
+    // Exact match for just "key" (standalone)
+    /^key$/i,
+    // Connection strings and DSNs
+    new RegExp(`${B}dsn${A}`, 'i'),
+    /connection[_-]?string/i,
+    // Email addresses in env var names
+    new RegExp(`${B}email${A}`, 'i'),
+    new RegExp(`${B}smtp${A}`, 'i'),
+    // Database/service URLs (often contain embedded credentials)
+    /database[_-]?url/i,
+    /redis[_-]?url/i,
+    // Webhook secrets
+    /webhook[_-]?secret/i,
+    // Signing / encryption
+    new RegExp(`${B}signing${A}`, 'i'),
+    new RegExp(`${B}encryption${A}`, 'i'),
+    // App key / app secret
+    /app[_-]key/i,
+];
+const REDACTED_DISPLAY = '••••••••';
+function redact(value) {
+    return { __redacted: true, display: REDACTED_DISPLAY, value };
+}
+// ---------------------------------------------------------------------------
+// ConfigInspector
+// ---------------------------------------------------------------------------
+/**
+ * Reads and sanitizes application configuration and environment variables.
+ *
+ * Designed for the full-page dashboard's Config section.
+ * Automatically redacts values whose keys match sensitive patterns.
+ */
+export class ConfigInspector {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    /**
+     * Get the full application config with sensitive values redacted.
+     */
+    getConfig() {
+        try {
+            const raw = this.app.config?.all?.() ?? {};
+            return { config: sanitizeObject(raw) };
+        }
+        catch {
+            return { config: {} };
+        }
+    }
+    /**
+     * Get environment variables with sensitive values redacted.
+     */
+    getEnvVars() {
+        try {
+            const env = {};
+            const sorted = Object.keys(process.env).sort();
+            for (const key of sorted) {
+                const value = process.env[key];
+                if (value === undefined)
+                    continue;
+                if (isSensitiveKey(key) || isSensitiveValue(value)) {
+                    env[key] = redact(value);
+                }
+                else {
+                    env[key] = value;
+                }
+            }
+            return { env };
+        }
+        catch {
+            return { env: {} };
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Sanitization helpers
+// ---------------------------------------------------------------------------
+/**
+ * Check if a key name matches any sensitive pattern.
+ */
+function isSensitiveKey(key) {
+    return SENSITIVE_PATTERNS.some((pattern) => pattern.test(key));
+}
+/**
+ * Check if a value looks sensitive based on its content.
+ * Catches email addresses and URLs with embedded credentials.
+ */
+function isSensitiveValue(value) {
+    // Email addresses
+    if (/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value))
+        return true;
+    // URLs with userinfo (credentials embedded in URL)
+    if (/^[a-z][a-z0-9+.-]*:\/\/[^/]*:[^/]*@/i.test(value))
+        return true;
+    return false;
+}
+/**
+ * Recursively sanitize an object, redacting string values whose keys
+ * match sensitive patterns. Booleans and numbers are never redacted.
+ */
+function sanitizeObject(obj, seen = new WeakSet()) {
+    if (obj === null || obj === undefined)
+        return obj;
+    // Primitive types pass through
+    if (typeof obj !== 'object')
+        return obj;
+    // Avoid circular references
+    if (seen.has(obj))
+        return '[Circular]';
+    seen.add(obj);
+    if (Array.isArray(obj)) {
+        return obj.map((item) => sanitizeObject(item, seen));
+    }
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        const value = obj[key];
+        if (typeof value === 'string' && (isSensitiveKey(key) || isSensitiveValue(value))) {
+            result[key] = redact(value);
+        }
+        else if (typeof value === 'object' && value !== null) {
+            result[key] = sanitizeObject(value, seen);
+        }
+        else {
+            // Booleans, numbers, and non-sensitive strings pass through
+            result[key] = value;
+        }
+    }
+    return result;
+}

package/dist/src/dashboard/integrations/index.d.ts

@@ -0,0 +1,7 @@
+export { CacheInspector } from './cache_inspector.js';
+export type { CacheStats, CacheKeyEntry, CacheKeyListResult, CacheKeyDetail, } from './cache_inspector.js';
+export { QueueInspector } from './queue_inspector.js';
+export type { QueueOverview, QueueJobSummary, QueueJobDetail, QueueJobListResult, } from './queue_inspector.js';
+export { ConfigInspector } from './config_inspector.js';
+export type { SanitizedConfig, SanitizedEnvVars } from './config_inspector.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/dashboard/integrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/integrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,YAAY,EACV,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,YAAY,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/src/dashboard/integrations/index.js

@@ -0,0 +1,3 @@
+export { CacheInspector } from './cache_inspector.js';
+export { QueueInspector } from './queue_inspector.js';
+export { ConfigInspector } from './config_inspector.js';

package/dist/src/dashboard/integrations/queue_inspector.d.ts

@@ -0,0 +1,106 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+export interface QueueOverview {
+    /** Total jobs currently being processed. */
+    active: number;
+    /** Jobs waiting to be picked up by a worker. */
+    waiting: number;
+    /** Jobs scheduled for future execution. */
+    delayed: number;
+    /** Jobs that completed successfully. */
+    completed: number;
+    /** Jobs that permanently failed. */
+    failed: number;
+    /** Jobs paused in the queue. */
+    paused: number;
+}
+export interface QueueJobSummary {
+    /** Bull job ID. */
+    id: string;
+    /** Job name / type. */
+    name: string;
+    /** Current job status. */
+    status: 'active' | 'waiting' | 'delayed' | 'completed' | 'failed' | 'paused';
+    /** Job payload (data). */
+    data: any;
+    /** Number of attempts so far. */
+    attempts: number;
+    /** Maximum allowed attempts. */
+    maxAttempts: number;
+    /** Job progress (0-100 or custom). */
+    progress: number | object;
+    /** Error message if the job failed, or null. */
+    failedReason: string | null;
+    /** When the job was added (Unix timestamp ms). */
+    createdAt: number;
+    /** When processing started (Unix timestamp ms), or null. */
+    processedAt: number | null;
+    /** When the job finished (Unix timestamp ms), or null. */
+    finishedAt: number | null;
+    /** Processing duration in ms, or null if not finished. */
+    duration: number | null;
+}
+export interface QueueJobDetail extends QueueJobSummary {
+    /** Full stack trace if the job failed. */
+    stackTrace: string[];
+    /** Return value from the job handler, if any. */
+    returnValue: any;
+    /** Job options (delay, priority, repeat, etc.). */
+    opts: Record<string, any>;
+}
+export interface QueueJobListResult {
+    /** Jobs for the requested page. */
+    jobs: QueueJobSummary[];
+    /** Total number of jobs matching the status filter. */
+    total: number;
+}
+type JobStatus = 'active' | 'waiting' | 'delayed' | 'completed' | 'failed' | 'paused';
+/**
+ * Inspects Bull Queue jobs, counts, and allows retrying failed jobs.
+ *
+ * Designed for the full-page dashboard's Jobs section.
+ * Only functional when `@rlanz/bull-queue` is installed.
+ * All methods catch errors and return safe defaults.
+ */
+export declare class QueueInspector {
+    private queueManager;
+    constructor(queueManager: any);
+    /**
+     * Detect whether `@rlanz/bull-queue` is available in the application container.
+     */
+    static isAvailable(app: ApplicationService): Promise<boolean>;
+    /**
+     * Get an overview of job counts by status across all queues.
+     */
+    getOverview(): Promise<QueueOverview>;
+    /**
+     * List jobs filtered by status with pagination.
+     *
+     * @param status   Job status to filter by.
+     * @param page     Page number (1-based).
+     * @param perPage  Jobs per page.
+     */
+    listJobs(status?: JobStatus, page?: number, perPage?: number): Promise<QueueJobListResult>;
+    /**
+     * Get full detail for a single job by ID.
+     */
+    getJob(id: string): Promise<QueueJobDetail | null>;
+    /**
+     * Retry a failed job.
+     *
+     * @returns `true` if the job was successfully requeued.
+     */
+    retryJob(id: string): Promise<boolean>;
+    /**
+     * Get the underlying Bull Queue instance from the queue manager.
+     *
+     * `@rlanz/bull-queue` exposes the BullMQ Queue via `.queue` on the manager
+     * or via `.useQueue()`. We try both patterns for compatibility.
+     */
+    private getQueue;
+    /**
+     * Format a Bull job into our summary shape.
+     */
+    private formatJobSummary;
+}
+export {};
+//# sourceMappingURL=queue_inspector.d.ts.map

package/dist/src/dashboard/integrations/queue_inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue_inspector.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/integrations/queue_inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAM9D,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IAEd,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAA;IAEf,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IAEf,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAA;IAEjB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IAEd,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAA;IAEV,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IAEZ,0BAA0B;IAC1B,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAE5E,0BAA0B;IAC1B,IAAI,EAAE,GAAG,CAAA;IAET,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAA;IAEhB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAA;IAEnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IAEzB,gDAAgD;IAChD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAA;IAEjB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAE1B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAEzB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,0CAA0C;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAA;IAEpB,iDAAiD;IACjD,WAAW,EAAE,GAAG,CAAA;IAEhB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,IAAI,EAAE,eAAe,EAAE,CAAA;IAEvB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAA;CACd;AAMD,KAAK,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAErF;;;;;;GAMG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,YAAY;gBAAZ,YAAY,EAAE,GAAG;IAErC;;OAEG;WACU,WAAW,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IASnE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;IAoC3C;;;;;;OAMG;IACG,QAAQ,CACZ,MAAM,GAAE,SAAoB,EAC5B,IAAI,SAAI,EACR,OAAO,SAAK,GACX,OAAO,CAAC,kBAAkB,CAAC;IA0B9B;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAqBxD;;;;OAIG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB5C;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAuBhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqBzB"}