nekostream 2026.2.11 → 2026.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NekoTech LLC.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -47,6 +47,7 @@ const player_1 = require("./player");
 const ui_1 = require("./ui");
 const storage_1 = require("./storage");
 const discord_1 = require("./discord");
+const logger_1 = require("./logger");
 const auth_service_1 = require("./scrapers/auth-service");
 const NPM_PACKAGE_NAME = 'nekostream';
 async function sleep(ms) {
@@ -77,11 +78,13 @@ async function showSettingsMenu() {
                 { title: `Chất lượng mặc định: ${chalk_1.default.green(settings.defaultQuality)}`, value: 'quality' },
                 { title: `Tự phát tập tiếp theo: ${formatToggle(settings.autoPlayNext)}`, value: 'autoplay' },
                 { title: `Discord RPC: ${formatToggle(settings.discordRpcEnabled)}`, value: 'discord' },
+                { title: `Debug mode: ${formatToggle(settings.debugMode || settings.developerMode)}`, value: 'debug' },
                 { title: 'Cấu hình domain provider', value: 'domains' },
                 { separator: 'TRỞ VỀ' },
                 { title: chalk_1.default.gray('Quay lại Home'), value: 'back' }
             ]
         });
+        (0, logger_1.debugTrace)('settings action selected', action);
         if (!action || action === 'back')
             break;
         if (action === 'provider') {
@@ -112,6 +115,15 @@ async function showSettingsMenu() {
             (0, storage_1.saveSettings)({ discordRpcEnabled: nextVal });
             (0, discord_1.toggleDiscordPresence)(nextVal);
         }
+        if (action === 'debug') {
+            const nextVal = !(settings.debugMode || settings.developerMode);
+            (0, storage_1.saveSettings)({ debugMode: nextVal, developerMode: nextVal });
+            (0, logger_1.debugLog)('debug mode changed', nextVal ? 'enabled' : 'disabled');
+            (0, ui_1.printSuccess)(nextVal
+                ? 'Debug mode đã bật: log debug/trace sẽ hiển thị và CLI sẽ không tự dọn màn hình.'
+                : 'Debug mode đã tắt: CLI sẽ dọn màn hình như bình thường.');
+            await sleep(1000);
+        }
         if (action === 'domains') {
             while (true) {
                 (0, ui_1.clearScreen)();
@@ -608,6 +620,7 @@ async function checkUpdate() {
 async function main() {
     await checkUpdate();
     await (0, discord_1.initDiscord)();
+    (0, logger_1.debugLog)('NekoStream CLI started');
     let settings = (0, storage_1.loadSettings)();
     let currentProviderName = settings.defaultProvider;
     while (true) {
@@ -622,6 +635,7 @@ async function main() {
             { label: 'Tài khoản', value: usernameDisplay },
             { label: 'Provider', value: chalk_1.default.green(currentProviderName) }
         ]);
+        (0, logger_1.debugTrace)('home rendered', { provider: currentProviderName, loggedIn: authStatus.loggedIn });
         const dynamicChoices = [
             { separator: 'KHÁM PHÁ' },
             { title: 'Tìm anime', value: 'search', description: 'Tìm theo tên phim' },

package/dist/logger.js

@@ -1,23 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDebugModeEnabled = isDebugModeEnabled;
 exports.isDeveloperLoggingEnabled = isDeveloperLoggingEnabled;
 exports.debugLog = debugLog;
 exports.debugWarn = debugWarn;
 exports.debugError = debugError;
-function isDeveloperLoggingEnabled() {
+exports.debugTrace = debugTrace;
+const storage_1 = require("./storage");
+function isDebugModeEnabled() {
     if (process.env.NEKOSTREAM_DEBUG === '1')
         return true;
-    return process.env.NEKOSTREAM_PRESERVE_LOGS === '1';
+    if (process.env.NEKOSTREAM_PRESERVE_LOGS === '1')
+        return true;
+    try {
+        const settings = (0, storage_1.loadSettings)();
+        return Boolean(settings.debugMode || settings.developerMode);
+    }
+    catch {
+        return false;
+    }
+}
+function isDeveloperLoggingEnabled() {
+    return isDebugModeEnabled();
 }
 function debugLog(...args) {
-    if (isDeveloperLoggingEnabled())
-        console.log(...args);
+    if (isDebugModeEnabled())
+        console.log('[debug]', ...args);
 }
 function debugWarn(...args) {
-    if (isDeveloperLoggingEnabled())
-        console.warn(...args);
+    if (isDebugModeEnabled())
+        console.warn('[debug]', ...args);
 }
 function debugError(...args) {
-    if (isDeveloperLoggingEnabled())
-        console.error(...args);
+    if (isDebugModeEnabled())
+        console.error('[debug]', ...args);
+}
+function debugTrace(...args) {
+    if (isDebugModeEnabled())
+        console.trace('[debug:trace]', ...args);
 }

package/dist/prompts-wrapper.js

@@ -11,6 +11,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const readline_1 = __importDefault(require("readline"));
 const theme_1 = require("./cli/theme");
 const text_1 = require("./cli/text");
+const logger_1 = require("./logger");
 function shouldOfferBack(message) {
     return /esc|back|quay lại|thoát/i.test(message);
 }
@@ -32,6 +33,14 @@ function formatSeparator(label, leadingBreak = true) {
 function promptMessage(message) {
     return `${theme_1.uiText.title(message)} ${theme_1.uiText.subtle('(Esc quay lại)')}`;
 }
+function clearPromptLines(renderedLines) {
+    if (renderedLines <= 0 || (0, logger_1.isDebugModeEnabled)())
+        return false;
+    readline_1.default.moveCursor(process.stdout, 0, -renderedLines);
+    readline_1.default.cursorTo(process.stdout, 0);
+    readline_1.default.clearScreenDown(process.stdout);
+    return true;
+}
 function mapChoices(choices, includeBack) {
     const hasBackChoice = choices.some((choice) => {
         const value = String(choice.value ?? '').toLowerCase();
@@ -111,11 +120,7 @@ async function selectGrid(options, signal) {
     let renderedLines = 0;
     const message = normalizeMessage(options.message || 'Chọn');
     const render = () => {
-        if (renderedLines > 0) {
-            readline_1.default.moveCursor(process.stdout, 0, -renderedLines);
-            readline_1.default.cursorTo(process.stdout, 0);
-            readline_1.default.clearScreenDown(process.stdout);
-        }
+        clearPromptLines(renderedLines);
         const filtered = filterGridChoices(choices, query);
         const { columnWidth, columns, rows, pageSize } = gridLayout(filtered);
         const pageCount = Math.max(1, Math.ceil(filtered.length / pageSize));
@@ -155,11 +160,7 @@ async function selectGrid(options, signal) {
         };
         const done = (value) => {
             cleanup();
-            if (renderedLines > 0) {
-                readline_1.default.moveCursor(process.stdout, 0, -renderedLines);
-                readline_1.default.cursorTo(process.stdout, 0);
-                readline_1.default.clearScreenDown(process.stdout);
-            }
+            clearPromptLines(renderedLines);
             resolve(value);
         };
         const onAbort = () => {

package/dist/storage.js

@@ -38,6 +38,7 @@ const DEFAULT_SETTINGS = {
     defaultProvider: 'animevietsub',
     defaultQuality: '1080p',
     autoPlayNext: false,
+    debugMode: false,
     developerMode: false,
     providerDomains: {},
     discordRpcEnabled: true

package/dist/ui.js

@@ -49,18 +49,12 @@ exports.printError = printError;
 const chalk_1 = __importDefault(require("chalk"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const storage_1 = require("./storage");
+const logger_1 = require("./logger");
 const theme_1 = require("./cli/theme");
 const text_1 = require("./cli/text");
 function clearScreen() {
-    try {
-        const settings = (0, storage_1.loadSettings)();
-        if (settings.developerMode && process.env.NEKOSTREAM_PRESERVE_LOGS === '1')
-            return;
-    }
-    catch {
-        // Storage may not be initialized during early startup.
-    }
+    if ((0, logger_1.isDebugModeEnabled)())
+        return;
     process.stdout.write('\x1B[2J\x1B[3J\x1B[H');
     if (process.stdin.isTTY) {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nekostream",
-  "version": "2026.2.11",
+  "version": "2026.3.1",
   "description": "Bettter version of NekoStream ",
   "keywords": [
     "anime",