@lobehub/lobehub 2.0.0-next.294 → 2.0.0-next.295

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog
 
+## [Version 2.0.0-next.295](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.294...v2.0.0-next.295)
+
+<sup>Released on **2026-01-15**</sup>
+
+#### ♻ Code Refactoring
+
+- **misc**: Migrate Next.js navigation APIs to React Router for SPA.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### Code refactoring
+
+- **misc**: Migrate Next.js navigation APIs to React Router for SPA, closes [#11394](https://github.com/lobehub/lobe-chat/issues/11394) ([2253d46](https://github.com/lobehub/lobe-chat/commit/2253d46))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.294](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.293...v2.0.0-next.294)
 
 <sup>Released on **2026-01-15**</sup>

package/apps/desktop/src/main/__mocks__/node-mac-permissions.ts

@@ -2,7 +2,6 @@
  * Mock for node-mac-permissions native module
  * Used in tests since the native module only works on macOS
  */
-
 import { vi } from 'vitest';
 
 export const askForAccessibilityAccess = vi.fn(() => undefined);

package/apps/desktop/src/main/__mocks__/setup.ts

@@ -1,7 +1,6 @@
 /**
  * Vitest setup file for mocking native modules
  */
-
 import { vi } from 'vitest';
 
 // Mock node-mac-permissions before any imports

package/apps/desktop/src/main/controllers/__tests__/SystemCtr.test.ts

@@ -4,10 +4,7 @@ import { beforeEach, describe, expect, it, vi } from 'vitest';
 import type { App } from '@/core/App';
 import type { IpcContext } from '@/utils/ipc';
 import { IpcHandler } from '@/utils/ipc/base';
-import {
-  __resetMacPermissionsModuleCache,
-  __setMacPermissionsModule,
-} from '@/utils/permissions';
+import { __resetMacPermissionsModuleCache, __setMacPermissionsModule } from '@/utils/permissions';
 
 import SystemController from '../SystemCtr';
 

package/apps/desktop/tsconfig.json

@@ -15,15 +15,9 @@
     "moduleResolution": "bundler",
     "resolveJsonModule": true,
     "paths": {
-      "@/*": [
-        "./src/main/*"
-      ],
-      "~common/*": [
-        "./src/common/*"
-      ],
-      "*": [
-        "./*"
-      ]
+      "@/*": ["./src/main/*"],
+      "~common/*": ["./src/common/*"],
+      "*": ["./*"]
     }
   },
   "include": [
@@ -33,4 +27,4 @@
     "electron-builder.js",
     "native-deps.config.js"
   ]
-}
+}

package/changelog/v1.json

@@ -1,4 +1,13 @@
 [
+  {
+    "children": {
+      "improvements": [
+        "Migrate Next.js navigation APIs to React Router for SPA."
+      ]
+    },
+    "date": "2026-01-15",
+    "version": "2.0.0-next.295"
+  },
   {
     "children": {},
     "date": "2026-01-15",

package/e2e/scripts/setup.ts

@@ -16,9 +16,7 @@
  *   --port <port>  Server port (default: 3006)
  *   --help         Show help message
  */
-
-import { type ChildProcess, spawn, spawnSync } from 'node:child_process';
-import { existsSync, unlinkSync, writeFileSync } from 'node:fs';
+import { spawn, spawnSync } from 'node:child_process';
 import { resolve } from 'node:path';
 
 // ============================================================================
@@ -33,21 +31,27 @@ const CONFIG = {
   defaultPort: 3006,
   dockerImage: 'paradedb/paradedb:latest',
   projectRoot: resolve(__dirname, '../..'),
-  serverTimeout: 120_000, // 2 minutes
-
-  // Secrets (for e2e testing only)
-  secrets: {
-    betterAuthSecret: 'e2e-test-secret-key-for-better-auth-32chars!',
-    keyVaultsSecret: 'LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s=',
-  },
+  
 
-  // S3 Mock (required even if not testing file uploads)
-  s3Mock: {
+// S3 Mock (required even if not testing file uploads)
+s3Mock: {
     accessKeyId: 'e2e-mock-access-key',
     bucket: 'e2e-mock-bucket',
     endpoint: 'https://e2e-mock-s3.localhost',
     secretAccessKey: 'e2e-mock-secret-key',
+  }, 
+
+  
+  
+// 2 minutes
+// Secrets (for e2e testing only)
+secrets: {
+    betterAuthSecret: 'e2e-test-secret-key-for-better-auth-32chars!',
+    keyVaultsSecret: 'LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s=',
   },
+
+  
+  serverTimeout: 120_000,
 };
 
 // ============================================================================
@@ -55,11 +59,11 @@ const CONFIG = {
 // ============================================================================
 
 const colors = {
-  cyan: (s: string) => `\x1b[36m${s}\x1b[0m`,
-  dim: (s: string) => `\x1b[2m${s}\x1b[0m`,
-  green: (s: string) => `\x1b[32m${s}\x1b[0m`,
-  red: (s: string) => `\x1b[31m${s}\x1b[0m`,
-  yellow: (s: string) => `\x1b[33m${s}\x1b[0m`,
+  cyan: (s: string) => `\u001B[36m${s}\u001B[0m`,
+  dim: (s: string) => `\u001B[2m${s}\u001B[0m`,
+  green: (s: string) => `\u001B[32m${s}\u001B[0m`,
+  red: (s: string) => `\u001B[31m${s}\u001B[0m`,
+  yellow: (s: string) => `\u001B[33m${s}\u001B[0m`,
 };
 
 function log(emoji: string, message: string) {
@@ -73,12 +77,12 @@ function logStep(step: number, total: number, message: string) {
 function exec(
   command: string,
   args: string[] = [],
-  options: { cwd?: string; silent?: boolean } = {}
+  options: { cwd?: string; silent?: boolean } = {},
 ) {
   const { cwd = CONFIG.projectRoot, silent = false } = options;
   const result = spawnSync(command, args, {
     cwd,
-    encoding: 'utf-8',
+    encoding: 'utf8',
     shell: true,
     stdio: silent ? 'pipe' : 'inherit',
   });
@@ -88,7 +92,7 @@ function exec(
 function execAsync(
   command: string,
   args: string[] = [],
-  env: Record<string, string> = {}
+  env: Record<string, string> = {},
 ): Promise<void> {
   return new Promise((resolve, reject) => {
     const child = spawn(command, args, {
@@ -111,14 +115,16 @@ function execAsync(
 }
 
 async function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
 }
 
 async function waitForCondition(
   check: () => Promise<boolean>,
   timeout: number,
   interval: number = 1000,
-  onWait?: () => void
+  onWait?: () => void,
 ): Promise<boolean> {
   const startTime = Date.now();
   while (Date.now() - startTime < timeout) {
@@ -204,7 +210,7 @@ async function startPostgres(): Promise<void> {
     },
     30_000,
     2000,
-    () => process.stdout.write('.')
+    () => process.stdout.write('.'),
   );
 
   console.log();
@@ -327,7 +333,7 @@ async function startServer(port: number): Promise<void> {
     () => isServerRunning(port),
     CONFIG.serverTimeout,
     2000,
-    () => process.stdout.write('.')
+    () => process.stdout.write('.'),
   );
 
   console.log();
@@ -412,27 +418,34 @@ function parseArgs(): Options {
   for (let i = 0; i < args.length; i++) {
     switch (args[i]) {
       case '--help':
-      case '-h':
+      case '-h': {
         options.help = true;
         break;
-      case '--clean':
+      }
+      case '--clean': {
         options.clean = true;
         break;
-      case '--skip-db':
+      }
+      case '--skip-db': {
         options.skipDb = true;
         break;
-      case '--skip-migrate':
+      }
+      case '--skip-migrate': {
         options.skipMigrate = true;
         break;
-      case '--build':
+      }
+      case '--build': {
         options.build = true;
         break;
-      case '--start':
+      }
+      case '--start': {
         options.start = true;
         break;
-      case '--port':
+      }
+      case '--port': {
         options.port = parseInt(args[++i], 10) || CONFIG.defaultPort;
         break;
+      }
     }
   }
 
@@ -526,4 +539,4 @@ ${colors.green('✅ E2E environment setup completed!')}
   }
 }
 
-main();
+await main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.294",
+  "version": "2.0.0-next.295",
   "description": "LobeHub - an open-source,comprehensive AI Agent framework that supports speech synthesis, multimodal, and extensible Function Call plugin system. Supports one-click free deployment of your private ChatGPT/LLM web application.",
   "keywords": [
     "framework",

package/packages/database/src/models/__tests__/knowledgeBase.test.ts

@@ -4,6 +4,7 @@ import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 
 import { sleep } from '@/utils/sleep';
 
+import { getTestDB } from '../../core/getTestDB';
 import {
   NewKnowledgeBase,
   documents,
@@ -15,7 +16,6 @@ import {
 } from '../../schemas';
 import { LobeChatDatabase } from '../../type';
 import { KnowledgeBaseModel } from '../knowledgeBase';
-import { getTestDB } from '../../core/getTestDB';
 
 const serverDB: LobeChatDatabase = await getTestDB();
 

package/packages/database/src/repositories/knowledge/index.ts

@@ -556,10 +556,7 @@ export class KnowledgeRepo {
       // When in a knowledge base, return standalone documents (folders and notes without fileId)
       // that have the knowledgeBaseId column set. Documents with fileId are already
       // returned by the file query via their linked file records.
-      kbWhereConditions.push(
-        sql`d.file_id IS NULL`,
-        sql`d.knowledge_base_id = ${knowledgeBaseId}`,
-      );
+      kbWhereConditions.push(sql`d.file_id IS NULL`, sql`d.knowledge_base_id = ${knowledgeBaseId}`);
 
       return sql`
         SELECT

package/packages/types/src/discover/assistants.ts

@@ -18,7 +18,7 @@ export enum AssistantCategory {
   Marketing = 'marketing',
   Office = 'office',
   Programming = 'programming',
-  Translation = 'translation'
+  Translation = 'translation',
 }
 
 export enum AssistantSorts {
@@ -29,7 +29,7 @@ export enum AssistantSorts {
   PluginCount = 'pluginCount',
   Recommended = 'recommended',
   Title = 'title',
-  TokenUsage = 'tokenUsage'
+  TokenUsage = 'tokenUsage',
 }
 
 export enum AssistantNavKey {

package/scripts/migrate-spa-navigation.ts

@@ -0,0 +1,129 @@
+#!/usr/bin/env bun
+/**
+ * Script to migrate SPA internal components from @/libs/next/navigation
+ * to React Router version hooks.
+ *
+ * For files in (main) directory:
+ * - usePathname -> @/app/[variants]/(main)/hooks/usePathname
+ * - useSearchParams -> @/app/[variants]/(main)/hooks/useSearchParams
+ * - useRouter -> @/app/[variants]/(main)/hooks/useRouter
+ *
+ * @see RFC 147: LOBE-2850 - Phase 3
+ */
+
+import { readFile, writeFile } from 'node:fs/promises';
+import { dirname, join, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// Files that should be migrated to React Router version
+const SPA_FILES = [
+  // (main) directory files using @/libs/next/navigation
+  'src/app/[variants]/(main)/community/_layout/Sidebar/Header/Nav.tsx',
+  'src/app/[variants]/(main)/group/_layout/Sidebar/Header/Nav.tsx',
+  'src/app/[variants]/(main)/group/_layout/Sidebar/Topic/hooks/useTopicNavigation.ts',
+  'src/app/[variants]/(main)/group/_layout/Sidebar/Topic/hooks/useThreadNavigation.ts',
+  'src/app/[variants]/(main)/chat/_layout/Sidebar/Header/AddTopicButon.tsx',
+  'src/app/[variants]/(main)/chat/_layout/Sidebar/Header/Nav.tsx',
+  'src/app/[variants]/(main)/chat/_layout/Sidebar/Topic/hooks/useTopicNavigation.ts',
+  'src/app/[variants]/(main)/chat/_layout/Sidebar/Topic/hooks/useThreadNavigation.ts',
+  'src/app/[variants]/(main)/memory/_layout/Sidebar/Header/Nav.tsx',
+];
+
+interface MigrationResult {
+  changes: string[];
+  filePath: string;
+}
+
+async function migrateFile(relativePath: string): Promise<MigrationResult | null> {
+  const fullPath = join(__dirname, '..', relativePath);
+  const content = await readFile(fullPath, 'utf8');
+  let newContent = content;
+  const changes: string[] = [];
+
+  // Check what hooks are being imported from @/libs/next/navigation
+  const importMatch = content.match(
+    /import\s*\{([^}]+)\}\s*from\s*['"]@\/libs\/next\/navigation['"]/
+  );
+
+  if (!importMatch) {
+    console.log(`⏭️  ${relativePath} - No @/libs/next/navigation import found`);
+    return null;
+  }
+
+  const importedHooks = importMatch[1]
+    .split(',')
+    .map((s) => s.trim())
+    .filter(Boolean);
+
+  console.log(`📝 ${relativePath}`);
+  console.log(`   Imported hooks: ${importedHooks.join(', ')}`);
+
+  // Build new imports
+  const newImports: string[] = [];
+
+  for (const hook of importedHooks) {
+    if (hook === 'usePathname') {
+      newImports.push(`import { usePathname } from '@/app/[variants]/(main)/hooks/usePathname';`);
+      changes.push('usePathname -> React Router version');
+    } else if (hook === 'useSearchParams') {
+      newImports.push(
+        `import { useSearchParams } from '@/app/[variants]/(main)/hooks/useSearchParams';`
+      );
+      changes.push('useSearchParams -> React Router version');
+    } else if (hook === 'useRouter') {
+      newImports.push(`import { useRouter } from '@/app/[variants]/(main)/hooks/useRouter';`);
+      changes.push('useRouter -> React Router version');
+    } else {
+      // Keep other imports (like notFound, redirect) from next/navigation
+      console.log(`   ⚠️  Unknown hook "${hook}" - keeping original import`);
+    }
+  }
+
+  if (newImports.length === 0) {
+    console.log(`   ⏭️  No hooks to migrate`);
+    return null;
+  }
+
+  // Replace the old import with new imports
+  newContent = newContent.replace(
+    /import\s*\{[^}]+\}\s*from\s*['"]@\/libs\/next\/navigation['"];?\n?/,
+    newImports.join('\n') + '\n'
+  );
+
+  if (newContent !== content) {
+    await writeFile(fullPath, newContent, 'utf8');
+    for (const change of changes) {
+      console.log(`   ✅ ${change}`);
+    }
+    return { changes, filePath: relativePath };
+  }
+
+  return null;
+}
+
+async function main() {
+  console.log('🚀 Starting SPA navigation migration...\n');
+
+  const results: MigrationResult[] = [];
+
+  for (const file of SPA_FILES) {
+    try {
+      const result = await migrateFile(file);
+      if (result) {
+        results.push(result);
+      }
+    } catch (error) {
+      console.error(`❌ Error processing ${file}:`, error);
+    }
+  }
+
+  console.log('\n' + '='.repeat(60));
+  console.log(`📊 Migration Summary:`);
+  console.log(`   - Files processed: ${SPA_FILES.length}`);
+  console.log(`   - Files modified: ${results.length}`);
+  console.log('\n✨ SPA navigation migration complete!');
+}
+
+await main();