playlist-data-engine 1.1.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Centralized logging utility with consistent log levels
+ *
+ * Log Levels (in order of verbosity):
+ * - DEBUG: Detailed debugging information
+ * - INFO: General operational information
+ * - WARN: Warning conditions that should be addressed
+ * - ERROR: Error conditions that need attention
+ *
+ * Usage:
+ * ```typescript
+ * import { Logger, LogLevel } from '../utils/logger.js';
+ *
+ * // Create a named logger
+ * const logger = Logger.for('WeatherAPIClient');
+ *
+ * // Log at different levels
+ * logger.debug('Fetching weather data', { lat: 45.5, lon: -122.6 });
+ * logger.info('Weather data cached');
+ * logger.warn('API rate limit approaching');
+ * logger.error('Failed to fetch weather', error);
+ *
+ * // Control verbosity
+ * Logger.setLevel(LogLevel.WARN);        // Only show WARN and ERROR
+ * Logger.enableVerbose();                // Enable all debug output
+ * Logger.setVerbose(true);               // Same as enableVerbose()
+ * Logger.isVerbose();                    // Check verbose state
+ * Logger.disableVerbose();               // Reset to default (INFO)
+ *
+ * // Diagnostic mode (for troubleshooting)
+ * Logger.enableDiagnosticMode();         // Maximum verbosity for debugging
+ * Logger.isDiagnosticMode();             // Check diagnostic state
+ * Logger.disableDiagnosticMode();        // Reset to default
+ * ```
+ */
+/**
+ * Log level enum - determines which messages are displayed
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+/**
+ * Log entry structure
+ */
+export interface LogEntry {
+    timestamp: Date;
+    level: LogLevel;
+    context: string;
+    message: string;
+    data?: unknown;
+}
+/**
+ * Logger configuration options
+ */
+export interface LoggerConfig {
+    /** Minimum log level to display (default: INFO in production, DEBUG in development) */
+    level?: LogLevel;
+    /** Include timestamp in output (default: true) */
+    includeTimestamp?: boolean;
+    /** Include context prefix [ClassName] (default: true) */
+    includeContext?: boolean;
+    /** Custom log handler for testing or external logging systems */
+    customHandler?: (entry: LogEntry) => void;
+}
+/**
+ * Logger class providing consistent logging across all modules
+ */
+export declare class Logger {
+    private context;
+    /**
+     * Create a logger instance with a specific context (usually the class/module name)
+     * @param context - The context name to prefix log messages (e.g., 'WeatherAPIClient')
+     */
+    private constructor();
+    /**
+     * Create a named logger for a specific class or module
+     * @param context - The context name (e.g., 'WeatherAPIClient', 'EnvironmentalSensors')
+     * @returns A Logger instance configured with the given context
+     */
+    static for(context: string): Logger;
+    /**
+     * Enable diagnostic mode
+     * Sets log level to DEBUG for maximum verbosity
+     */
+    static enableDiagnosticMode(): void;
+    /**
+     * Disable diagnostic mode
+     * Resets log level to INFO
+     */
+    static disableDiagnosticMode(): void;
+    /**
+     * Check if diagnostic mode is enabled
+     * @returns True if diagnostic mode is active
+     */
+    static isDiagnosticMode(): boolean;
+    /**
+     * Enable verbose logging mode
+     * Sets log level to DEBUG for increased output verbosity
+     * This is a convenience method equivalent to Logger.setLevel(LogLevel.DEBUG)
+     * @example
+     * Logger.enableVerbose();
+     * // All debug messages will now be logged
+     */
+    static enableVerbose(): void;
+    /**
+     * Disable verbose logging mode
+     * Resets log level to INFO (default)
+     * @example
+     * Logger.disableVerbose();
+     * // Only INFO and above will be logged
+     */
+    static disableVerbose(): void;
+    /**
+     * Check if verbose mode is enabled
+     * @returns True if verbose mode is active
+     */
+    static isVerbose(): boolean;
+    /**
+     * Set verbose mode on or off
+     * @param enabled - Whether to enable verbose logging
+     * @example
+     * Logger.setVerbose(true);  // Enable verbose logging
+     * Logger.setVerbose(false); // Disable verbose logging
+     */
+    static setVerbose(enabled: boolean): void;
+    /**
+     * Set the global log level
+     * @param level - The minimum log level to display
+     */
+    static setLevel(level: LogLevel): void;
+    /**
+     * Get the current global log level
+     * @returns The current log level
+     */
+    static getLevel(): LogLevel;
+    /**
+     * Configure the logger globally
+     * @param config - Logger configuration options
+     */
+    static configure(config: LoggerConfig): void;
+    /**
+     * Reset logger to default configuration
+     */
+    static reset(): void;
+    /**
+     * Log a debug message (most verbose)
+     * @param message - The log message
+     * @param data - Optional data to include
+     */
+    debug(message: string, data?: unknown): void;
+    /**
+     * Log an info message (general operational info)
+     * @param message - The log message
+     * @param data - Optional data to include
+     */
+    info(message: string, data?: unknown): void;
+    /**
+     * Log a warning message (potential issues)
+     * @param message - The log message
+     * @param data - Optional data to include
+     */
+    warn(message: string, data?: unknown): void;
+    /**
+     * Log an error message (errors that need attention)
+     * @param message - The log message
+     * @param data - Optional error or data to include
+     */
+    error(message: string, data?: unknown): void;
+    /**
+     * Internal logging method
+     */
+    private log;
+    /**
+     * Format a log entry into a string
+     */
+    private formatMessage;
+    /**
+     * Format a timestamp for log output
+     */
+    private formatTimestamp;
+}
+/**
+ * Convenience function to create a logger without calling Logger.for()
+ * @param context - The context name
+ * @returns A Logger instance
+ */
+export declare function createLogger(context: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;CACX;AAaD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,uFAAuF;IACvF,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iEAAiE;IACjE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC7C;AAuBD;;GAEG;AACH,qBAAa,MAAM;IACf,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;IACH,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAInC;;;OAGG;IACH,MAAM,CAAC,oBAAoB,IAAI,IAAI;IAKnC;;;OAGG;IACH,MAAM,CAAC,qBAAqB,IAAI,IAAI;IAKpC;;;OAGG;IACH,MAAM,CAAC,gBAAgB,IAAI,OAAO;IAIlC;;;;;;;OAOG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAK5B;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,IAAI,IAAI;IAK7B;;;OAGG;IACH,MAAM,CAAC,SAAS,IAAI,OAAO;IAI3B;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKzC;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAItC;;;OAGG;IACH,MAAM,CAAC,QAAQ,IAAI,QAAQ;IAI3B;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAe5C;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IASpB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C;;OAEG;IACH,OAAO,CAAC,GAAG;IAwDX;;OAEG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;IACH,OAAO,CAAC,eAAe;CAO1B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/utils/magicItemExamples.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Magic Item Helper Functions
+ *
+ * This file provides helper functions for working with magic items.
+ *
+ * For the magic items collection, import MAGIC_ITEMS from '../constants/MagicItems.js'
+ * For the templates collection, import ITEM_CREATION_TEMPLATES from '../constants/ItemTemplates.js'
+ *
+ * Helper Functions:
+ * - getMagicItem(name) - Get a specific magic item by name
+ * - getMagicItemsByType(type) - Get all items of a specific type (weapon/armor/item)
+ * - getMagicItemsByRarity(rarity) - Get all items of a specific rarity
+ * - getCursedItems() - Get all cursed items
+ * - getItemsWithProperty(propertyType) - Get all items with a specific property type
+ * - applyTemplate(baseEquipment, templateId) - Apply a template to base equipment
+ *
+ * @module utils/magicItemExamples
+ */
+import type { EnhancedEquipment } from '../core/types/Equipment.js';
+import { MAGIC_ITEMS } from '../constants/MagicItems.js';
+/**
+ * Helper function to get magic item by name
+ */
+export declare function getMagicItem(name: string): EnhancedEquipment | undefined;
+/**
+ * Helper function to get all items of a specific type
+ */
+export declare function getMagicItemsByType(type: 'weapon' | 'armor' | 'item'): EnhancedEquipment[];
+/**
+ * Helper function to get all items of a specific rarity
+ */
+export declare function getMagicItemsByRarity(rarity: 'common' | 'uncommon' | 'rare' | 'very_rare' | 'legendary'): EnhancedEquipment[];
+/**
+ * Helper function to get all cursed items
+ */
+export declare function getCursedItems(): EnhancedEquipment[];
+/**
+ * Helper function to get all items with a specific property type
+ */
+export declare function getItemsWithProperty(propertyType: string): EnhancedEquipment[];
+/**
+ * Helper function to apply a template to base equipment
+ */
+export declare function applyTemplate(baseEquipment: EnhancedEquipment, templateId: string): EnhancedEquipment | null;
+export default MAGIC_ITEMS;
+//# sourceMappingURL=magicItemExamples.d.ts.map

package/dist/utils/magicItemExamples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magicItemExamples.d.ts","sourceRoot":"","sources":["../../src/utils/magicItemExamples.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGzD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAExE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,iBAAiB,EAAE,CAE1F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,iBAAiB,EAAE,CAE7H;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAI9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAoB5G;AAED,eAAe,WAAW,CAAC"}

package/dist/utils/playlistUtils.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Simple playlist utility functions for quick data extraction
+ * "No nonsense" functions that return arrays of basic data from playlists
+ */
+import type { ServerlessPlaylist, RawArweavePlaylist } from '../core/types/Playlist.js';
+/** Input type that accepts both parsed and raw playlists */
+export type PlaylistInput = ServerlessPlaylist | RawArweavePlaylist;
+/** Simplified track object for getTracks() */
+export interface SimpleTrack {
+    title: string;
+    artist: string;
+    audio_url: string;
+    audio_url_lossless?: string;
+    image_url: string;
+    image_thumb_url?: string;
+}
+/** Track object with VRM data for getVRMTracks() */
+export interface VRMTrack {
+    title: string;
+    artist: string;
+    audio_url: string;
+    audio_url_lossless?: string;
+    image_url: string;
+    image_thumb_url?: string;
+    vrm: string;
+}
+/**
+ * Get all audio URLs from a playlist
+ * @param playlist - Parsed or raw playlist
+ * @returns Array of audio URLs (excludes null/empty)
+ *
+ * @example
+ * const urls = getAudioUrls(playlist);
+ * // ['https://arweave.net/audio1.mp3', 'https://arweave.net/audio2.mp3']
+ */
+export declare function getAudioUrls(playlist: PlaylistInput): string[];
+/**
+ * Get all image URLs from playlist tracks
+ * @param playlist - Parsed or raw playlist
+ * @returns Array of image URLs (excludes null/empty)
+ *
+ * @example
+ * const images = getImageUrls(playlist);
+ * // ['https://arweave.net/cover1.jpg', 'https://arweave.net/cover2.jpg']
+ */
+export declare function getImageUrls(playlist: PlaylistInput): string[];
+/**
+ * Get all track titles from a playlist
+ * @param playlist - Parsed or raw playlist
+ * @returns Array of track titles
+ *
+ * @example
+ * const titles = getTrackTitles(playlist);
+ * // ['Song One', 'Song Two', 'Song Three']
+ */
+export declare function getTrackTitles(playlist: PlaylistInput): string[];
+/**
+ * Get all artist names from a playlist
+ * @param playlist - Parsed or raw playlist
+ * @returns Array of artist names
+ *
+ * @example
+ * const artists = getArtists(playlist);
+ * // ['Artist A', 'Artist B', 'Artist A']
+ */
+export declare function getArtists(playlist: PlaylistInput): string[];
+/**
+ * Get all genres from playlist tracks (unique, sorted)
+ * @param playlist - Parsed or raw playlist
+ * @returns Array of unique genres (sorted alphabetically)
+ *
+ * @example
+ * const genres = getGenres(playlist);
+ * // ['Electronic', 'Hip-Hop', 'Jazz']
+ */
+export declare function getGenres(playlist: PlaylistInput): string[];
+/**
+ * Get all tags from playlist tracks (unique, sorted, lowercased)
+ * @param playlist - Parsed or raw playlist
+ * @returns Array of unique tags (sorted alphabetically)
+ *
+ * @example
+ * const tags = getTags(playlist);
+ * // ['chill', 'electronic', 'upbeat']
+ */
+export declare function getTags(playlist: PlaylistInput): string[];
+/**
+ * Get total duration of all tracks in seconds
+ * @param playlist - Parsed or raw playlist (requires duration in metadata)
+ * @returns Total duration in seconds (0 if no duration data)
+ *
+ * @example
+ * const duration = getTotalDuration(playlist);
+ * // 1234.56
+ */
+export declare function getTotalDuration(playlist: PlaylistInput): number;
+/**
+ * Get track count from a playlist
+ * @param playlist - Parsed or raw playlist
+ * @returns Number of tracks
+ *
+ * @example
+ * const count = getTrackCount(playlist);
+ * // 10
+ */
+export declare function getTrackCount(playlist: PlaylistInput): number;
+/**
+ * Get track data as simple objects (title + artist + urls)
+ * @param playlist - Parsed or raw playlist
+ * @returns Array of simplified track objects
+ *
+ * @example
+ * const tracks = getTracks(playlist);
+ * // [{ title: 'Song', artist: 'Artist', audio_url: '...', image_url: '...', image_thumb_url: '...' }, ...]
+ */
+export declare function getTracks(playlist: PlaylistInput): SimpleTrack[];
+/**
+ * Get full track data with all available fields
+ * @param playlist - Parsed or raw playlist
+ * @returns Array of track objects with all available data
+ *
+ * @example
+ * const tracks = getFullTracks(playlist);
+ * // [{ id, title, artist, album, duration, genre, tags, audio_url, image_url, ... }, ...]
+ */
+export declare function getFullTracks(playlist: PlaylistInput): Array<Record<string, unknown>>;
+/**
+ * Get all VRM URLs from playlist tracks
+ * VRM is an optional field in track metadata (3D avatar model files)
+ * @param playlist - Parsed or raw playlist
+ * @returns Array of VRM URLs (only from tracks that have a vrm field)
+ *
+ * @example
+ * const vrms = getVRMs(playlist);
+ * // ['https://arweave.net/avatar1.vrm', 'https://arweave.net/avatar2.vrm']
+ */
+export declare function getVRMs(playlist: PlaylistInput): string[];
+/**
+ * Get tracks that have VRM data (3D avatar model files)
+ * Returns simplified track objects with vrm field included
+ * @param playlist - Parsed or raw playlist
+ * @returns Array of track objects that have a vrm field
+ *
+ * @example
+ * const vrmTracks = getVRMTracks(playlist);
+ * // [{ title: 'Song', artist: 'Artist', audio_url: '...', image_url: '...', image_thumb_url: '...', vrm: '...' }, ...]
+ */
+export declare function getVRMTracks(playlist: PlaylistInput): VRMTrack[];
+//# sourceMappingURL=playlistUtils.d.ts.map

package/dist/utils/playlistUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playlistUtils.d.ts","sourceRoot":"","sources":["../../src/utils/playlistUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAiB,MAAM,2BAA2B,CAAC;AAOvG,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAEpE,8CAA8C;AAC9C,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,oDAAoD;AACpD,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;CACf;AAmHD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAW9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAW9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAuBhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAuB5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAoB3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CA4BzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAoBhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAE7D;AAMD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,WAAW,EAAE,CAiDhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8CrF;AAMD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAWzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,QAAQ,EAAE,CA4ChE"}

package/dist/utils/random.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Seeded random number generator for deterministic randomness
+ */
+export declare class SeededRNG {
+    private seed;
+    private counter;
+    constructor(seed: string);
+    /**
+     * Generate a random float between 0.0 and 1.0
+     */
+    random(): number;
+    /**
+     * Generate a random integer between min (inclusive) and max (exclusive)
+     */
+    randomInt(min: number, max: number): number;
+    /**
+     * Pick a random element from an array
+     */
+    randomChoice<T>(array: T[]): T;
+    /**
+     * Pick a random element from an array with weighted probabilities
+     * @param choices - Array of [value, weight] tuples
+     */
+    weightedChoice<T>(choices: [T, number][]): T;
+    /**
+     * Shuffle an array deterministically
+     */
+    shuffle<T>(array: T[]): T[];
+    /**
+     * Reset the counter (useful for testing)
+     */
+    reset(): void;
+}
+//# sourceMappingURL=random.d.ts.map

package/dist/utils/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/utils/random.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,qBAAa,SAAS;IAClB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,MAAM;IAKxB;;OAEG;IACH,MAAM,IAAI,MAAM;IAMhB;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC;IAK9B;;;OAGG;IACH,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC;IAe5C;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAS3B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGhB"}

package/dist/utils/sensorDashboard.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Sensor Dashboard - Visual console output for sensor diagnostics
+ *
+ * Provides formatted console output for sensor status, health, cache statistics,
+ * and recent failures. Designed for debugging and monitoring during development.
+ *
+ * Usage:
+ * ```typescript
+ * import { SensorDashboard } from '../utils/sensorDashboard.js';
+ *
+ * // Display environmental sensors dashboard
+ * SensorDashboard.displayEnvironmentalDiagnostics(sensors.getDiagnostics());
+ *
+ * // Display gaming sensors dashboard
+ * SensorDashboard.displayGamingDiagnostics(gamingSensors.getDiagnostics());
+ *
+ * // Display a combined system dashboard
+ * SensorDashboard.displaySystemDashboard({
+ *     environmental: sensors.getDiagnostics(),
+ *     gaming: gamingSensors.getDiagnostics()
+ * });
+ * ```
+ */
+/**
+ * Dashboard configuration options
+ */
+export interface DashboardConfig {
+    /** Use colors in output (default: true) */
+    useColors?: boolean;
+    /** Compact mode for smaller output (default: false) */
+    compact?: boolean;
+    /** Show timestamp (default: true) */
+    showTimestamp?: boolean;
+    /** Maximum number of recent failures to show (default: 5) */
+    maxFailures?: number;
+}
+/**
+ * Display environmental sensor diagnostics
+ */
+export declare function displayEnvironmentalDiagnostics(diagnostics: ReturnType<typeof import('../core/sensors/EnvironmentalSensors').EnvironmentalSensors.prototype.getDiagnostics>, config?: DashboardConfig): void;
+/**
+ * Display gaming platform sensor diagnostics
+ */
+export declare function displayGamingDiagnostics(diagnostics: ReturnType<typeof import('../core/sensors/GamingPlatformSensors').GamingPlatformSensors.prototype.getDiagnostics>, config?: DashboardConfig): void;
+/**
+ * Display a combined system dashboard
+ */
+export declare function displaySystemDashboard(data: {
+    environmental?: ReturnType<typeof import('../core/sensors/EnvironmentalSensors').EnvironmentalSensors.prototype.getDiagnostics>;
+    gaming?: ReturnType<typeof import('../core/sensors/GamingPlatformSensors').GamingPlatformSensors.prototype.getDiagnostics>;
+}, config?: DashboardConfig): void;
+/**
+ * Export as a named export object for convenient importing
+ */
+export declare const SensorDashboard: {
+    displayEnvironmentalDiagnostics: typeof displayEnvironmentalDiagnostics;
+    displayGamingDiagnostics: typeof displayGamingDiagnostics;
+    displaySystemDashboard: typeof displaySystemDashboard;
+};
+//# sourceMappingURL=sensorDashboard.d.ts.map

package/dist/utils/sensorDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensorDashboard.d.ts","sourceRoot":"","sources":["../../src/utils/sensorDashboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AA0CH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAoID;;GAEG;AACH,wBAAgB,+BAA+B,CAC3C,WAAW,EAAE,UAAU,CAAC,cAAc,sCAAsC,EAAE,oBAAoB,CAAC,SAAS,CAAC,cAAc,CAAC,EAC5H,MAAM,GAAE,eAAoB,GAC7B,IAAI,CAwGN;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACpC,WAAW,EAAE,UAAU,CAAC,cAAc,uCAAuC,EAAE,qBAAqB,CAAC,SAAS,CAAC,cAAc,CAAC,EAC9H,MAAM,GAAE,eAAoB,GAC7B,IAAI,CAiGN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IACzC,aAAa,CAAC,EAAE,UAAU,CAAC,cAAc,sCAAsC,EAAE,oBAAoB,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAChI,MAAM,CAAC,EAAE,UAAU,CAAC,cAAc,uCAAuC,EAAE,qBAAqB,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;CAC9H,EAAE,MAAM,GAAE,eAAoB,GAAG,IAAI,CAwCrC;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;CAI3B,CAAC"}