docs: improve JSDoc documentation for Chrome password retrieval

- Restore detailed JSDoc for Chrome Safe Storage password retrieval

- Add context about password usage and platform support

- Document error conditions in throws clause

src/core/browsers/chrome/getChromePassword.ts

@@ -3,7 +3,9 @@ import { platform } from "os";
 import { getChromePassword as getMacOSPassword } from "./macos/getChromePassword";
 
 /**
- * Gets the Chrome Safe Storage password for the current platform
+ * Gets the Chrome Safe Storage password for the current platform.
+ * This password is used to decrypt cookies stored in Chrome's cookie database.
+ * Currently only supports macOS, where the password is stored in the system keychain.
  * @returns A promise that resolves to the Chrome Safe Storage password
  * @throws {Error} If the password cannot be retrieved or the platform is not supported
  */

src/core/browsers/chrome/macos/getChromePassword.ts

@@ -1,8 +1,9 @@
 import { execSimple } from "../../../../utils/execSimple";
 
 /**
- * Gets the Chrome password from the keychain
- * @returns The password
+ * Retrieves the Chrome Safe Storage password from the macOS keychain
+ * @returns A promise that resolves to the Chrome Safe Storage password
+ * @throws {Error} If the password cannot be retrieved from the keychain
  */
 export async function getChromePassword(): Promise<string> {
   const command = 'security find-generic-password -w -s "Chrome Safe Storage"';