sqlite-cookie-parser 1.0.0

package/dist/operaLinuxCookie.js

@@ -0,0 +1,12 @@
+import {
+  getCookiesFromOperaLinuxSqlite
+} from "./chunk-TWA6YYS5.js";
+import "./chunk-EPL3V4O3.js";
+import "./chunk-UR6BPQ2T.js";
+import "./chunk-TYLH6G3Z.js";
+import "./chunk-LTLRZZW3.js";
+import "./chunk-JTBFDYPY.js";
+export {
+  getCookiesFromOperaLinuxSqlite
+};
+//# sourceMappingURL=operaLinuxCookie.js.map

package/dist/operaLinuxCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/operaMacCookie.d.ts

@@ -0,0 +1,5 @@
+import { GetCookiesOptions, GetCookiesResult } from './types.js';
+
+declare function getCookiesFromOperaMacSqlite(options: GetCookiesOptions, origins: string[], cookieNames: Set<string> | null): Promise<GetCookiesResult>;
+
+export { getCookiesFromOperaMacSqlite };

package/dist/operaMacCookie.js

@@ -0,0 +1,12 @@
+import {
+  getCookiesFromOperaMacSqlite
+} from "./chunk-2ILP4UJD.js";
+import "./chunk-Q2LDNBEA.js";
+import "./chunk-UR6BPQ2T.js";
+import "./chunk-TYLH6G3Z.js";
+import "./chunk-LTLRZZW3.js";
+import "./chunk-JTBFDYPY.js";
+export {
+  getCookiesFromOperaMacSqlite
+};
+//# sourceMappingURL=operaMacCookie.js.map

package/dist/operaMacCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/operaWindowsCookie.d.ts

@@ -0,0 +1,5 @@
+import { GetCookiesOptions, GetCookiesResult } from './types.js';
+
+declare function getCookiesFromOperaWindowsSqlite(options: GetCookiesOptions, origins: string[], cookieNames: Set<string> | null): Promise<GetCookiesResult>;
+
+export { getCookiesFromOperaWindowsSqlite };

package/dist/operaWindowsCookie.js

@@ -0,0 +1,12 @@
+import {
+  getCookiesFromOperaWindowsSqlite
+} from "./chunk-5AJFPLWB.js";
+import "./chunk-AR5Q6KM4.js";
+import "./chunk-UR6BPQ2T.js";
+import "./chunk-TYLH6G3Z.js";
+import "./chunk-LTLRZZW3.js";
+import "./chunk-JTBFDYPY.js";
+export {
+  getCookiesFromOperaWindowsSqlite
+};
+//# sourceMappingURL=operaWindowsCookie.js.map

package/dist/operaWindowsCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/publicApi.d.ts

@@ -0,0 +1,20 @@
+import { GetCookiesFromBrowserParams, GetCookiesResult, Cookie, CookieHeaderOption } from './types.js';
+
+/**
+ * Convert an array of Cookie objects into a Cookie header string (e.g. "name1=value1; name2=value2")
+ * @param cookies - The cookies to serialize
+ * @param options - Options for formatting the header
+ *   - removeDuplicates: keep only the first occurrence of each cookie name
+ *   - sortByName: sort cookies alphabetically by name
+ * @returns A formatted Cookie header string
+ */
+declare function toCookieHeader(cookies: Cookie[], options: CookieHeaderOption): string;
+/**
+ * Extract cookies from a specified browser's local storage.
+ * Supports Chrome, Edge, Firefox, Safari, Opera, Brave and Vivaldi.
+ * @param params - Browser and filtering options
+ * @returns Extracted cookies and any warnings encountered during parsing
+ */
+declare function getCookiesFromBrowser(params: GetCookiesFromBrowserParams): Promise<GetCookiesResult>;
+
+export { getCookiesFromBrowser, toCookieHeader };

package/dist/publicApi.js

@@ -0,0 +1,38 @@
+import {
+  getCookiesFromBrowser,
+  toCookieHeader
+} from "./chunk-5AEUDMIX.js";
+import "./chunk-A3YGBITD.js";
+import "./chunk-IXZPT56H.js";
+import "./chunk-GRIZYEBN.js";
+import "./chunk-J2UYSXFG.js";
+import "./chunk-4G6NLIPV.js";
+import "./chunk-XDL34EPI.js";
+import "./chunk-NGBAATI3.js";
+import "./chunk-D23AYBOE.js";
+import "./chunk-YD3PNZMV.js";
+import "./chunk-HOGGS6QP.js";
+import "./chunk-SRZIPU62.js";
+import "./chunk-E6CQFEXM.js";
+import "./chunk-TWA6YYS5.js";
+import "./chunk-2ILP4UJD.js";
+import "./chunk-5AJFPLWB.js";
+import "./chunk-EZBYP7NP.js";
+import "./chunk-SSXWHBKV.js";
+import "./chunk-PT5JK5UI.js";
+import "./chunk-6OYYWSIJ.js";
+import "./chunk-U4G74MHA.js";
+import "./chunk-Q2LDNBEA.js";
+import "./chunk-MLKERL3L.js";
+import "./chunk-AR5Q6KM4.js";
+import "./chunk-QCW7AUP6.js";
+import "./chunk-EPL3V4O3.js";
+import "./chunk-UR6BPQ2T.js";
+import "./chunk-TYLH6G3Z.js";
+import "./chunk-LTLRZZW3.js";
+import "./chunk-JTBFDYPY.js";
+export {
+  getCookiesFromBrowser,
+  toCookieHeader
+};
+//# sourceMappingURL=publicApi.js.map

package/dist/publicApi.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Cookie object interface
+ */
+interface Cookie {
+    /** Cookie name */
+    name: string;
+    /** Cookie value (null if encrypted and decryption failed) */
+    value: string | null;
+    /** Cookie domain */
+    domain: string;
+    /** Cookie path */
+    path: string;
+    /** Expiration date (undefined if session cookie) */
+    expires?: number;
+    /** Whether cookie requires HTTPS */
+    secure: boolean;
+    /** Whether cookie is HTTP-only */
+    httpOnly: boolean;
+    /** SameSite attribute */
+    sameSite?: SameSiteValue;
+    /** Partition key (CHIPS) - the top-level site that partitions this cookie, empty for unpartitioned cookies */
+    partitionKey?: string;
+    source: {
+        browser: BrowserName;
+        cookieFilePath: string;
+    };
+}
+type SameSiteValue = 'none' | 'lax' | 'strict';
+type BrowserName = 'chrome' | 'edge' | 'firefox' | 'safari' | 'opera' | 'brave' | 'vivaldi';
+type BrowserType = 'chromium' | 'firefox' | 'safari';
+/**
+ * Options for getCookiesFromBrowser
+ */
+interface GetCookiesOptions {
+    /** Browser profile name (default: 'Default') */
+    profile?: string;
+    /** Whether to include expired cookies (default: false) */
+    includeExpired?: boolean;
+    /** Whether to include partitioned cookies (CHIPS) (default: false) */
+    includePartitioned?: boolean;
+}
+type GetCookiesFromFileOptions = GetCookiesOptions & {
+    cookieFilePath: string;
+};
+interface GetCookiesResult {
+    cookies: Cookie[];
+    warnings: string[];
+}
+/**
+ * Parameters for getCookiesFromBrowser
+ */
+interface GetCookiesFromBrowserParams {
+    /** Origins to extract cookies for (e.g. ['https://example.com']) */
+    origins: string[];
+    /** Filter by cookie names. If omitted, all cookies are returned */
+    cookieNames?: string[];
+    /** Browser to extract cookies from */
+    browserName: BrowserName;
+    /** Browser profile name (default: 'Default') */
+    profile?: string;
+    /** Whether to include expired cookies (default: false) */
+    includeExpired?: boolean;
+    /** Whether to include partitioned cookies (CHIPS) (default: false) */
+    includePartitioned?: boolean;
+}
+/**
+ * Raw cookie row from Chrome/Edge database
+ */
+interface ChromeCookieRow {
+    name: string;
+    value: string;
+    encrypted_value: Buffer | null;
+    host: string;
+    path: string;
+    expires_utc: number;
+    is_secure: number;
+    is_httponly: number;
+    samesite: number;
+}
+/**
+ * Raw cookie row from Firefox database
+ */
+interface FirefoxCookieRow {
+    name: string;
+    value: string;
+    host: string;
+    path: string;
+    expiry: number;
+    isSecure: number;
+    isHttpOnly: number;
+}
+type DecryptFunction = (encryptedValue: Buffer) => string;
+interface CookieHeaderOption {
+    removeDuplicates?: boolean;
+    sortByName?: boolean;
+}
+
+export type { BrowserName, BrowserType, ChromeCookieRow, Cookie, CookieHeaderOption, DecryptFunction, FirefoxCookieRow, GetCookiesFromBrowserParams, GetCookiesFromFileOptions, GetCookiesOptions, GetCookiesResult, SameSiteValue };

package/dist/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/util/crypto.d.ts

@@ -0,0 +1,9 @@
+declare function getAES128CBCKey(password: string, iterations: number): Buffer;
+declare function decryptChomiumAES128CBCCookieValue(encryptedValue: Uint8Array, keyCandidates: Buffer[]): string | null;
+/**
+ * Decrypt a Windows Chromium cookie value encrypted with AES-256-GCM.
+ * Format: v10/v20 prefix (3 bytes) + nonce (12 bytes) + ciphertext + auth tag (16 bytes)
+ */
+declare function decryptChromiumAES256GCMCookieValue(encryptedValue: Uint8Array, key: Buffer): string | null;
+
+export { decryptChomiumAES128CBCCookieValue, decryptChromiumAES256GCMCookieValue, getAES128CBCKey };

package/dist/util/crypto.js

@@ -0,0 +1,11 @@
+import {
+  decryptChomiumAES128CBCCookieValue,
+  decryptChromiumAES256GCMCookieValue,
+  getAES128CBCKey
+} from "../chunk-UR6BPQ2T.js";
+export {
+  decryptChomiumAES128CBCCookieValue,
+  decryptChromiumAES256GCMCookieValue,
+  getAES128CBCKey
+};
+//# sourceMappingURL=crypto.js.map

package/dist/util/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/util/fileHelper.d.ts

@@ -0,0 +1,4 @@
+declare function normalizePath(pathStr: string): string;
+declare function resolveBrowserDefaultorSpecificDBPath(roots: string[], profile?: string): string | null;
+
+export { normalizePath, resolveBrowserDefaultorSpecificDBPath };

package/dist/util/fileHelper.js

@@ -0,0 +1,9 @@
+import {
+  normalizePath,
+  resolveBrowserDefaultorSpecificDBPath
+} from "../chunk-TYLH6G3Z.js";
+export {
+  normalizePath,
+  resolveBrowserDefaultorSpecificDBPath
+};
+//# sourceMappingURL=fileHelper.js.map

package/dist/util/fileHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/util/linuxKeyring.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Attempt to retrieve the Chromium encryption password from the Linux keyring.
+ * Tries secret-tool (GNOME Keyring / KDE Wallet) with v2 and v1 schemas.
+ * Falls back to the hardcoded default password "peanuts" if keyring is unavailable.
+ */
+declare function findLinuxChromiumPassword(application: string, label: string, timeoutMs: number): Promise<{
+    password: string;
+    warnings: string[];
+}>;
+
+export { findLinuxChromiumPassword };

package/dist/util/linuxKeyring.js

@@ -0,0 +1,8 @@
+import {
+  findLinuxChromiumPassword
+} from "../chunk-EPL3V4O3.js";
+import "../chunk-LTLRZZW3.js";
+export {
+  findLinuxChromiumPassword
+};
+//# sourceMappingURL=linuxKeyring.js.map

package/dist/util/linuxKeyring.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/util/macKeyChain.d.ts

@@ -0,0 +1,16 @@
+declare function findMacKeyChainPassword(service: string, account: string, timeoutMs: number): Promise<{
+    success: true;
+    password: string;
+} | {
+    success: false;
+    error: string;
+}>;
+declare function findFirstMacKeyChainPassword(services: string[], account: string, timeoutMs: number, label: string): Promise<{
+    success: true;
+    password: string;
+} | {
+    success: false;
+    error: string;
+}>;
+
+export { findFirstMacKeyChainPassword, findMacKeyChainPassword };

package/dist/util/macKeyChain.js

@@ -0,0 +1,10 @@
+import {
+  findFirstMacKeyChainPassword,
+  findMacKeyChainPassword
+} from "../chunk-Q2LDNBEA.js";
+import "../chunk-LTLRZZW3.js";
+export {
+  findFirstMacKeyChainPassword,
+  findMacKeyChainPassword
+};
+//# sourceMappingURL=macKeyChain.js.map

package/dist/util/macKeyChain.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/util/processExecutor.d.ts

@@ -0,0 +1,7 @@
+declare function executeProcess(file: string, args: string[], timeoutMs: number): Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;
+
+export { executeProcess };

package/dist/util/processExecutor.js

@@ -0,0 +1,7 @@
+import {
+  executeProcess
+} from "../chunk-LTLRZZW3.js";
+export {
+  executeProcess
+};
+//# sourceMappingURL=processExecutor.js.map

package/dist/util/processExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/util/windowsDpapi.d.ts

@@ -0,0 +1,9 @@
+declare function decryptWindowsDpapi(encryptedBytes: Buffer, timeoutMs?: number): Promise<{
+    success: true;
+    decrypted: Buffer;
+} | {
+    success: false;
+    error: string;
+}>;
+
+export { decryptWindowsDpapi };

package/dist/util/windowsDpapi.js

@@ -0,0 +1,8 @@
+import {
+  decryptWindowsDpapi
+} from "../chunk-AR5Q6KM4.js";
+import "../chunk-LTLRZZW3.js";
+export {
+  decryptWindowsDpapi
+};
+//# sourceMappingURL=windowsDpapi.js.map

package/dist/util/windowsDpapi.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/vivaldiLinuxCookie.d.ts

@@ -0,0 +1,5 @@
+import { GetCookiesOptions, GetCookiesResult } from './types.js';
+
+declare function getCookiesFromVivaldiLinuxSqlite(options: GetCookiesOptions, origins: string[], cookieNames: Set<string> | null): Promise<GetCookiesResult>;
+
+export { getCookiesFromVivaldiLinuxSqlite };

package/dist/vivaldiLinuxCookie.js

@@ -0,0 +1,12 @@
+import {
+  getCookiesFromVivaldiLinuxSqlite
+} from "./chunk-GRIZYEBN.js";
+import "./chunk-EPL3V4O3.js";
+import "./chunk-UR6BPQ2T.js";
+import "./chunk-TYLH6G3Z.js";
+import "./chunk-LTLRZZW3.js";
+import "./chunk-JTBFDYPY.js";
+export {
+  getCookiesFromVivaldiLinuxSqlite
+};
+//# sourceMappingURL=vivaldiLinuxCookie.js.map

package/dist/vivaldiLinuxCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/vivaldiMacCookie.d.ts

@@ -0,0 +1,5 @@
+import { GetCookiesOptions, GetCookiesResult } from './types.js';
+
+declare function getCookiesFromVivaldiMacSqlite(options: GetCookiesOptions, origins: string[], cookieNames: Set<string> | null): Promise<GetCookiesResult>;
+
+export { getCookiesFromVivaldiMacSqlite };

package/dist/vivaldiMacCookie.js

@@ -0,0 +1,12 @@
+import {
+  getCookiesFromVivaldiMacSqlite
+} from "./chunk-J2UYSXFG.js";
+import "./chunk-Q2LDNBEA.js";
+import "./chunk-UR6BPQ2T.js";
+import "./chunk-TYLH6G3Z.js";
+import "./chunk-LTLRZZW3.js";
+import "./chunk-JTBFDYPY.js";
+export {
+  getCookiesFromVivaldiMacSqlite
+};
+//# sourceMappingURL=vivaldiMacCookie.js.map

package/dist/vivaldiMacCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/vivaldiWindowsCookie.d.ts

@@ -0,0 +1,5 @@
+import { GetCookiesOptions, GetCookiesResult } from './types.js';
+
+declare function getCookiesFromVivaldiWindowsSqlite(options: GetCookiesOptions, origins: string[], cookieNames: Set<string> | null): Promise<GetCookiesResult>;
+
+export { getCookiesFromVivaldiWindowsSqlite };

package/dist/vivaldiWindowsCookie.js

@@ -0,0 +1,12 @@
+import {
+  getCookiesFromVivaldiWindowsSqlite
+} from "./chunk-4G6NLIPV.js";
+import "./chunk-AR5Q6KM4.js";
+import "./chunk-UR6BPQ2T.js";
+import "./chunk-TYLH6G3Z.js";
+import "./chunk-LTLRZZW3.js";
+import "./chunk-JTBFDYPY.js";
+export {
+  getCookiesFromVivaldiWindowsSqlite
+};
+//# sourceMappingURL=vivaldiWindowsCookie.js.map

package/dist/vivaldiWindowsCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "sqlite-cookie-parser",
+  "version": "1.0.0",
+  "description": "Extract cookies from browser profiles and convert to request headers",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "example": "tsup && node dist/example.js",
+    "prepublishOnly": "npm run build",
+    "format": "prettier --write \"src/**/*.{ts,js,json}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,js,json}\""
+  },
+  "keywords": [
+    "cookie",
+    "browser",
+    "chrome",
+    "edge",
+    "firefox",
+    "sqlite",
+    "typescript"
+  ],
+  "tsup": {
+    "entry": ["src/**/*.ts", "!src/**/*.test.ts"],
+    "format": ["esm"],
+    "dts": true,
+    "sourcemap": true,
+    "clean": true
+  },
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "better-sqlite3": "^11.7.0",
+    "lz4": "^0.6.5"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/lz4": "^0.6.4",
+    "@types/node": "^22.0.0",
+    "prettier": "^3.8.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  }
+}