@students-dev/audify-js 1.0.0

package/dist/types/queue/Queue.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Audio queue management
+ */
+export class Queue {
+    tracks: any[];
+    currentIndex: number;
+    eventBus: EventBus;
+    /**
+     * Add track(s) to queue
+     * @param {Track|Track[]|string|string[]} tracks - Track(s) to add
+     * @param {number} position - Position to insert (optional)
+     */
+    add(tracks: Track | Track[] | string | string[], position: number): void;
+    /**
+     * Remove track from queue
+     * @param {number|string} identifier - Track index or ID
+     * @returns {Track|null} Removed track
+     */
+    remove(identifier: number | string): Track | null;
+    /**
+     * Shuffle the queue
+     */
+    shuffle(): void;
+    /**
+     * Clear the queue
+     */
+    clear(): void;
+    /**
+     * Jump to specific track
+     * @param {number} index - Track index
+     * @returns {Track|null} Track at index
+     */
+    jump(index: number): Track | null;
+    /**
+     * Get current track
+     * @returns {Track|null} Current track
+     */
+    getCurrent(): Track | null;
+    /**
+     * Get next track
+     * @returns {Track|null} Next track
+     */
+    getNext(): Track | null;
+    /**
+     * Get previous track
+     * @returns {Track|null} Previous track
+     */
+    getPrevious(): Track | null;
+    /**
+     * Get all tracks
+     * @returns {Track[]} Array of tracks
+     */
+    getTracks(): Track[];
+    /**
+     * Get queue size
+     * @returns {number} Number of tracks
+     */
+    size(): number;
+    /**
+     * Check if queue is empty
+     * @returns {boolean} Is empty
+     */
+    isEmpty(): boolean;
+    /**
+     * Get track at index
+     * @param {number} index - Track index
+     * @returns {Track|null} Track at index
+     */
+    getTrack(index: number): Track | null;
+}
+import { EventBus } from '../events/EventBus.js';
+import { Track } from './Track.js';

package/dist/types/queue/Track.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Represents an audio track
+ */
+export class Track {
+    /**
+     * @param {string} url - Track URL or file path
+     * @param {Object} options - Additional options
+     */
+    constructor(url: string, options?: any);
+    url: string;
+    title: any;
+    artist: any;
+    duration: any;
+    thumbnail: any;
+    metadata: any;
+    id: any;
+    /**
+     * Get track info
+     * @returns {Object} Track information
+     */
+    getInfo(): any;
+    /**
+     * Update track metadata
+     * @param {Object} metadata - New metadata
+     */
+    updateMetadata(metadata: any): void;
+    /**
+     * Check if track is valid
+     * @returns {boolean} Is valid
+     */
+    isValid(): boolean;
+}

package/dist/types/utils/Logger.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Logger utility with different levels
+ */
+export class Logger {
+    constructor(level?: string);
+    levels: {
+        debug: number;
+        info: number;
+        warn: number;
+        error: number;
+    };
+    currentLevel: any;
+    /**
+     * Set log level
+     * @param {string} level - Log level (debug, info, warn, error)
+     */
+    setLevel(level: string): void;
+    /**
+     * Debug log
+     * @param {...*} args - Arguments to log
+     */
+    debug(...args: any[]): void;
+    /**
+     * Info log
+     * @param {...*} args - Arguments to log
+     */
+    info(...args: any[]): void;
+    /**
+     * Warning log
+     * @param {...*} args - Arguments to log
+     */
+    warn(...args: any[]): void;
+    /**
+     * Error log
+     * @param {...*} args - Arguments to log
+     */
+    error(...args: any[]): void;
+}
+export const logger: Logger;

package/dist/types/utils/Metadata.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Metadata parsing utilities
+ */
+export class MetadataUtils {
+    /**
+     * Extract basic metadata from URL or file path
+     * @param {string} source - URL or file path
+     * @returns {Object} Metadata object
+     */
+    static extract(source: string): any;
+    /**
+     * Extract title from source
+     * @param {string} source - Source string
+     * @returns {string} Extracted title
+     */
+    static extractTitle(source: string): string;
+    /**
+     * Extract YouTube metadata (basic)
+     * @param {string} url - YouTube URL
+     * @returns {Object} Metadata
+     */
+    static extractYouTubeMetadata(url: string): any;
+    /**
+     * Extract SoundCloud metadata (basic)
+     * @param {string} url - SoundCloud URL
+     * @returns {Object} Metadata
+     */
+    static extractSoundCloudMetadata(url: string): any;
+    /**
+     * Extract file metadata (basic)
+     * @param {string} path - File path
+     * @returns {Object} Metadata
+     */
+    static extractFileMetadata(path: string): any;
+}

package/dist/types/utils/Probe.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Audio probing utilities
+ */
+export class ProbeUtils {
+    /**
+     * Probe audio file/stream for basic info
+     * @param {string|Buffer|ReadableStream} source - Audio source
+     * @returns {Promise<Object>} Probe result
+     */
+    static probe(source: string | Buffer | ReadableStream): Promise<any>;
+    /**
+     * Check if source is a valid audio URL
+     * @param {string} url - URL to check
+     * @returns {boolean} Is valid audio URL
+     */
+    static isValidAudioUrl(url: string): boolean;
+    /**
+     * Get audio format from URL or buffer
+     * @param {string|Buffer} source - Audio source
+     * @returns {string|null} Audio format
+     */
+    static getFormat(source: string | Buffer): string | null;
+}

package/dist/types/utils/Time.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Time formatting utilities
+ */
+export class TimeUtils {
+    /**
+     * Format seconds to MM:SS or HH:MM:SS
+     * @param {number} seconds - Time in seconds
+     * @returns {string} Formatted time string
+     */
+    static format(seconds: number): string;
+    /**
+     * Parse time string to seconds
+     * @param {string} timeStr - Time string like "1:23" or "01:23:45"
+     * @returns {number} Time in seconds
+     */
+    static parse(timeStr: string): number;
+    /**
+     * Get current timestamp in milliseconds
+     * @returns {number} Current time
+     */
+    static now(): number;
+    /**
+     * Calculate duration between two timestamps
+     * @param {number} start - Start time
+     * @param {number} end - End time
+     * @returns {number} Duration in milliseconds
+     */
+    static duration(start: number, end: number): number;
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@students-dev/audify-js",
+  "version": "1.0.0",
+  "description": "Modern modular audio engine with queue, filters, plugin API, and event-driven design.",
+  "type": "module",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc && rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest",
+    "lint": "eslint src/**/*.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "audio",
+    "engine",
+    "playback",
+    "queue",
+    "filters",
+    "plugins",
+    "javascript",
+    "nodejs",
+    "browser"
+  ],
+  "author": "Students Dev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/students-dev/audify-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/students-dev/audify-js/issues"
+  },
+  "homepage": "https://github.com/students-dev/audify-js#readme",
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "rollup": "^4.0.0",
+    "rollup-plugin-dts": "^6.0.0",
+    "typescript": "^5.0.0",
+    "jest": "^29.0.0",
+    "eslint": "^8.0.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}