@jesusacd/mediafire 1.0.0

package/README.md

@@ -0,0 +1,183 @@
+# @jesusacd/mediafire
+
+SDK para Node.js que permite interactuar con la API de MediaFire de forma programática.
+
+## Instalación
+
+```bash
+npm install @jesusacd/mediafire
+```
+
+## Quick Start
+
+```typescript
+import { MediaFireClient } from "@jesusacd/mediafire";
+
+const client = new MediaFireClient();
+
+// Login
+await client.login("email@example.com", "password");
+
+// Obtener información del usuario
+const user = await client.user.getInfo();
+console.log(`¡Hola, ${user.displayName}!`);
+
+// Obtener cuota de almacenamiento
+const storage = await client.user.getStorage();
+console.log(`Usado: ${storage.usedFormatted} / ${storage.totalFormatted}`);
+
+// Listar archivos en la carpeta raíz
+const content = await client.folders.getContent();
+content.items.forEach((item) => {
+  console.log(`${item.isFolder ? "📁" : "📄"} ${item.name}`);
+});
+```
+
+## API Reference
+
+### MediaFireClient
+
+```typescript
+const client = new MediaFireClient();
+```
+
+#### Métodos de Autenticación
+
+```typescript
+// Login
+const session = await client.login(email, password);
+
+// Verificar si está autenticado
+client.isAuthenticated(); // boolean
+
+// Cerrar sesión
+client.logout();
+
+// Obtener/restaurar sesión
+const session = client.getSession();
+client.setSession(session);
+```
+
+### Módulo User
+
+```typescript
+// Información del usuario
+const user = await client.user.getInfo();
+// { email, displayName, firstName, lastName, premium, validated, createdAt }
+
+// Cuota de almacenamiento
+const storage = await client.user.getStorage();
+// { usedBytes, totalBytes, usedFormatted, totalFormatted, percentUsed }
+```
+
+### Módulo Files
+
+```typescript
+// Información de un archivo
+const file = await client.files.getInfo("quickkey");
+// { quickKey, name, size, sizeFormatted, mimeType, downloads, privacy }
+
+// Enlaces de descarga
+const links = await client.files.getLinks("quickkey");
+// { directDownload, normalDownload, viewLink }
+
+// Buscar archivos
+const results = await client.files.search("documento.pdf");
+// { query, items, total }
+```
+
+### Módulo Folders
+
+```typescript
+// Listar contenido de carpeta (raíz por defecto)
+const content = await client.folders.getContent();
+const content = await client.folders.getContent("folderkey");
+const content = await client.folders.getContent("folderkey", {
+  contentType: "files", // 'files' | 'folders' | 'all'
+  chunk: 1,
+  chunkSize: 100,
+});
+// { folderKey, items, hasMore, chunk }
+
+// Solo archivos
+const files = await client.folders.getFiles("folderkey");
+
+// Solo carpetas
+const folders = await client.folders.getFolders("folderkey");
+```
+
+## Manejo de Errores
+
+```typescript
+import { MediaFireClient, MediaFireError } from "@jesusacd/mediafire";
+
+try {
+  await client.login("email", "wrong-password");
+} catch (error) {
+  if (error instanceof MediaFireError) {
+    console.log(`Error: ${error.message}`);
+    console.log(`Code: ${error.code}`);
+  }
+}
+```
+
+## Ejemplo Completo
+
+```typescript
+import { MediaFireClient, MediaFireError } from "@JesusACD/mediafire";
+
+async function main() {
+  const client = new MediaFireClient();
+
+  try {
+    // Login
+    console.log("Iniciando sesión...");
+    await client.login(process.env.MF_EMAIL!, process.env.MF_PASSWORD!);
+    console.log("✅ Sesión iniciada");
+
+    // Usuario
+    const user = await client.user.getInfo();
+    console.log(`\n👤 Usuario: ${user.displayName}`);
+    console.log(`   Email: ${user.email}`);
+    console.log(`   Premium: ${user.premium ? "Sí" : "No"}`);
+
+    // Storage
+    const storage = await client.user.getStorage();
+    console.log(`\n💾 Almacenamiento:`);
+    console.log(
+      `   Usado: ${storage.usedFormatted} / ${storage.totalFormatted}`,
+    );
+    console.log(`   ${storage.percentUsed}% usado`);
+
+    // Archivos raíz
+    console.log(`\n📂 Carpeta raíz:`);
+    const content = await client.folders.getContent();
+    content.items.forEach((item) => {
+      const icon = item.isFolder ? "📁" : "📄";
+      const size = item.isFolder ? "" : ` (${(item as any).sizeFormatted})`;
+      console.log(`   ${icon} ${item.name}${size}`);
+    });
+
+    // Búsqueda
+    console.log(`\n🔍 Buscando archivos...`);
+    const results = await client.files.search("test");
+    console.log(`   Encontrados: ${results.total} archivos`);
+  } catch (error) {
+    if (error instanceof MediaFireError) {
+      console.error(`❌ Error de MediaFire: ${error.message}`);
+    } else {
+      throw error;
+    }
+  }
+}
+
+main();
+```
+
+## Requisitos
+
+- Node.js >= 16.0.0
+
+## Licencia
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Internal session state
+ */
+export interface InternalSession {
+    sessionToken: string;
+    secretKey: string;
+    time: string;
+    email: string;
+}
+/**
+ * API call options
+ */
+export interface ApiCallOptions {
+    /** API version to use */
+    apiVersion?: string;
+    /** Request timeout in ms */
+    timeout?: number;
+}
+/**
+ * Make an API call to MediaFire
+ *
+ * @param endpoint - API endpoint (e.g., 'user/get_info')
+ * @param params - Request parameters
+ * @param session - Session data for authenticated calls
+ * @param options - Additional options
+ * @returns Parsed API response
+ */
+export declare function apiCall<T = unknown>(endpoint: string, params?: Record<string, string | number | boolean | undefined>, session?: InternalSession | null, options?: ApiCallOptions): Promise<T>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,CAAC,GAAG,OAAO,EACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAM,EAClE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,EAChC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAiFZ"}

package/dist/api.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiCall = apiCall;
+/**
+ * MediaFire API Client - Low-level HTTP client
+ */
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const auth_1 = require("./auth");
+const utils_1 = require("./utils");
+const types_1 = require("./types");
+const API_BASE = 'https://www.mediafire.com/api';
+const DEFAULT_API_VERSION = '1.3';
+/**
+ * Make an API call to MediaFire
+ *
+ * @param endpoint - API endpoint (e.g., 'user/get_info')
+ * @param params - Request parameters
+ * @param session - Session data for authenticated calls
+ * @param options - Additional options
+ * @returns Parsed API response
+ */
+async function apiCall(endpoint, params = {}, session, options = {}) {
+    const apiVersion = options.apiVersion || DEFAULT_API_VERSION;
+    // Clean endpoint (remove .php if present)
+    const cleanEndpoint = endpoint.endsWith('.php') ? endpoint.slice(0, -4) : endpoint;
+    const url = `${API_BASE}/${apiVersion}/${cleanEndpoint}.php`;
+    // Build query params
+    const queryParams = new URLSearchParams();
+    queryParams.append('response_format', 'json');
+    // Add session token if available
+    if (session?.sessionToken) {
+        queryParams.append('session_token', session.sessionToken);
+    }
+    // Add all other params
+    Object.entries(params).forEach(([key, value]) => {
+        if (value !== undefined && value !== null) {
+            queryParams.append(key, String(value));
+        }
+    });
+    // Sort params alphabetically (required for signature)
+    const sortedParams = (0, utils_1.sortParams)(queryParams);
+    // Add signature for authenticated calls
+    if (session?.secretKey && session?.time) {
+        const uri = `/api/${apiVersion}/${cleanEndpoint}.php`;
+        const query = sortedParams.toString();
+        const signature = (0, auth_1.generateRequestSignature)(session.secretKey, session.time, uri, query);
+        sortedParams.append('signature', signature);
+    }
+    // Make request
+    const response = await (0, node_fetch_1.default)(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/x-www-form-urlencoded',
+            'User-Agent': 'MediaFire-SDK/1.0 (Node.js)'
+        },
+        body: sortedParams.toString()
+    });
+    const responseText = await response.text();
+    if (!response.ok) {
+        throw new types_1.MediaFireError(`API request failed: ${response.status}`, response.status, responseText);
+    }
+    let data;
+    try {
+        data = JSON.parse(responseText);
+    }
+    catch {
+        throw new types_1.MediaFireError(`Invalid JSON response: ${responseText}`);
+    }
+    // Check for API-level errors
+    if (data.response?.result === 'Error') {
+        throw new types_1.MediaFireError(data.response?.message || 'Unknown MediaFire API error', data.response?.error, data);
+    }
+    // Handle secret key regeneration
+    if (data.response?.new_key === 'yes' && session) {
+        session.secretKey = (0, auth_1.regenerateSecretKey)(session.secretKey);
+    }
+    return data.response;
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/auth.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generate SHA1 signature for authentication
+ * Signature is: SHA1(email + password + application_id)
+ *
+ * @param email - User email
+ * @param password - User password
+ * @param appId - Application ID
+ * @returns Hex-encoded SHA1 signature
+ */
+export declare function generateSignature(email: string, password: string, appId: string): string;
+/**
+ * Regenerate secret key using MediaFire's algorithm
+ * New key = (old_key * 16807) % 2147483647
+ *
+ * @param currentKey - Current secret key
+ * @returns New secret key
+ */
+export declare function regenerateSecretKey(currentKey: string): string;
+/**
+ * Generate request signature for authenticated API calls
+ *
+ * @param secretKey - Current secret key
+ * @param time - Server time from login
+ * @param uri - API endpoint URI
+ * @param query - Query string (sorted)
+ * @returns MD5 signature
+ */
+export declare function generateRequestSignature(secretKey: string, time: string, uri: string, query: string): string;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMxF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR"}

package/dist/auth.js

@@ -0,0 +1,85 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSignature = generateSignature;
+exports.regenerateSecretKey = regenerateSecretKey;
+exports.generateRequestSignature = generateRequestSignature;
+/**
+ * Authentication utilities for MediaFire API
+ */
+const crypto = __importStar(require("crypto"));
+/**
+ * Generate SHA1 signature for authentication
+ * Signature is: SHA1(email + password + application_id)
+ *
+ * @param email - User email
+ * @param password - User password
+ * @param appId - Application ID
+ * @returns Hex-encoded SHA1 signature
+ */
+function generateSignature(email, password, appId) {
+    const sha1 = crypto.createHash('sha1');
+    sha1.update(email);
+    sha1.update(password);
+    sha1.update(appId);
+    return sha1.digest('hex');
+}
+/**
+ * Regenerate secret key using MediaFire's algorithm
+ * New key = (old_key * 16807) % 2147483647
+ *
+ * @param currentKey - Current secret key
+ * @returns New secret key
+ */
+function regenerateSecretKey(currentKey) {
+    const oldKey = parseInt(currentKey, 10);
+    const newKey = (oldKey * 16807) % 2147483647;
+    return String(newKey);
+}
+/**
+ * Generate request signature for authenticated API calls
+ *
+ * @param secretKey - Current secret key
+ * @param time - Server time from login
+ * @param uri - API endpoint URI
+ * @param query - Query string (sorted)
+ * @returns MD5 signature
+ */
+function generateRequestSignature(secretKey, time, uri, query) {
+    const secretKeyMod = parseInt(secretKey, 10) % 256;
+    const signatureBase = `${secretKeyMod}${time}${uri}?${query}`;
+    return crypto.createHash('md5').update(signatureBase).digest('hex');
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,8CAMC;AASD,kDAIC;AAWD,4DASC;AArDD;;GAEG;AACH,+CAAiC;AAEjC;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAAC,KAAa,EAAE,QAAgB,EAAE,KAAa;IAC9E,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,UAAkB;IACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,UAAU,CAAC;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,wBAAwB,CACtC,SAAiB,EACjB,IAAY,EACZ,GAAW,EACX,KAAa;IAEb,MAAM,YAAY,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IACnD,MAAM,aAAa,GAAG,GAAG,YAAY,GAAG,IAAI,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;IAC9D,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,110 @@
+import { UserModule } from './modules/user';
+import { FilesModule } from './modules/files';
+import { FoldersModule } from './modules/folders';
+import { MediaFireConfig, SessionData } from './types';
+/**
+ * MediaFire SDK Client
+ *
+ * Main entry point for interacting with MediaFire API.
+ *
+ * @example
+ * ```typescript
+ * import { MediaFireClient } from '@JesusACD/mediafire';
+ *
+ * const client = new MediaFireClient();
+ *
+ * // Login
+ * await client.login('email@example.com', 'password');
+ *
+ * // Use modules
+ * const user = await client.user.getInfo();
+ * const files = await client.folders.getContent();
+ * ```
+ */
+export declare class MediaFireClient {
+    private config;
+    private session;
+    private _user?;
+    private _files?;
+    private _folders?;
+    /**
+     * Create a new MediaFire client
+     *
+     * @param config - Optional configuration
+     */
+    constructor(config?: MediaFireConfig);
+    /**
+     * Authenticate with MediaFire
+     *
+     * @param email - User email
+     * @param password - User password
+     * @returns Session data
+     * @throws MediaFireError if authentication fails
+     *
+     * @example
+     * ```typescript
+     * const session = await client.login('email@example.com', 'password');
+     * console.log(`Logged in as ${session.email}`);
+     * ```
+     */
+    login(email: string, password: string): Promise<SessionData>;
+    /**
+     * Log out and clear session
+     */
+    logout(): void;
+    /**
+     * Check if client is authenticated
+     *
+     * @returns True if logged in
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get current session data
+     *
+     * @returns Session data or null if not authenticated
+     */
+    getSession(): SessionData | null;
+    /**
+     * Set session data (for restoring a previous session)
+     *
+     * @param session - Session data to restore
+     */
+    setSession(session: SessionData): void;
+    /**
+     * Get internal session (for modules)
+     */
+    private getInternalSession;
+    /**
+     * User operations module
+     *
+     * @example
+     * ```typescript
+     * const user = await client.user.getInfo();
+     * const storage = await client.user.getStorage();
+     * ```
+     */
+    get user(): UserModule;
+    /**
+     * Files operations module
+     *
+     * @example
+     * ```typescript
+     * const fileInfo = await client.files.getInfo('quickkey');
+     * const links = await client.files.getLinks('quickkey');
+     * const results = await client.files.search('query');
+     * ```
+     */
+    get files(): FilesModule;
+    /**
+     * Folders operations module
+     *
+     * @example
+     * ```typescript
+     * const content = await client.folders.getContent();
+     * const files = await client.folders.getFiles('folderkey');
+     * const folders = await client.folders.getFolders('folderkey');
+     * ```
+     */
+    get folders(): FoldersModule;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAkB,MAAM,SAAS,CAAC;AAMvE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAAgC;IAG/C,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAC,CAAgB;IAEjC;;;;OAIG;gBACS,MAAM,GAAE,eAAoB;IAQxC;;;;;;;;;;;;;OAaG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAoElE;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;;;OAIG;IACH,eAAe,IAAI,OAAO;IAI1B;;;;OAIG;IACH,UAAU,IAAI,WAAW,GAAG,IAAI;IAUhC;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAStC;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAExB;IAEF;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,UAAU,CAKrB;IAED;;;;;;;;;OASG;IACH,IAAI,KAAK,IAAI,WAAW,CAKvB;IAED;;;;;;;;;OASG;IACH,IAAI,OAAO,IAAI,aAAa,CAK3B;CACF"}