@mherod/get-cookie 4.0.4 → 4.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/dist/{chunk-IRERRCUF.js → chunk-3FVH4L25.js} +2 -2
  2. package/dist/{chunk-UPNW543B.js → chunk-7XZ7PCDJ.js} +2 -2
  3. package/dist/chunk-DVWQBWUF.js +4 -0
  4. package/dist/chunk-DVWQBWUF.js.map +1 -0
  5. package/dist/{chunk-VMBA4NVU.js → chunk-I6AYGFSQ.js} +2 -2
  6. package/dist/chunk-U27I5BLR.js +2 -0
  7. package/dist/chunk-U27I5BLR.js.map +1 -0
  8. package/dist/chunk-YOZOS2YM.js +2 -0
  9. package/dist/chunk-YOZOS2YM.js.map +1 -0
  10. package/dist/cli.cjs +3 -3
  11. package/dist/cli.cjs.map +1 -1
  12. package/dist/getChromeCookie-2ROVM47V.js +2 -0
  13. package/dist/{getChromePassword-GTIXL733.js → getChromePassword-O452VQWI.js} +2 -2
  14. package/dist/getCookie-CRE6M3GI.js +2 -0
  15. package/dist/getFirefoxCookie-5P74VDC7.js +2 -0
  16. package/dist/getGroupedRenderedCookies-DFEJTTC6.js +2 -0
  17. package/dist/getMergedRenderedCookies-W5GSSHQQ.js +2 -0
  18. package/dist/index.cjs +3 -3
  19. package/dist/index.cjs.map +1 -1
  20. package/dist/index.d.cts +12 -12
  21. package/dist/index.d.ts +12 -12
  22. package/dist/index.js +1 -1
  23. package/package.json +1 -4
  24. package/dist/chunk-5FUMK7M3.js +0 -4
  25. package/dist/chunk-5FUMK7M3.js.map +0 -1
  26. package/dist/chunk-A6MIB6FP.js +0 -2
  27. package/dist/chunk-A6MIB6FP.js.map +0 -1
  28. package/dist/chunk-CFMK2YSL.js +0 -2
  29. package/dist/chunk-CFMK2YSL.js.map +0 -1
  30. package/dist/getChromeCookie-CL3SRRWX.js +0 -2
  31. package/dist/getCookie-WV5KDZN7.js +0 -2
  32. package/dist/getFirefoxCookie-BXQ2GXAW.js +0 -2
  33. package/dist/getGroupedRenderedCookies-FNJ6FQVQ.js +0 -2
  34. package/dist/getMergedRenderedCookies-PNC2LHSD.js +0 -2
  35. /package/dist/{chunk-IRERRCUF.js.map → chunk-3FVH4L25.js.map} +0 -0
  36. /package/dist/{chunk-UPNW543B.js.map → chunk-7XZ7PCDJ.js.map} +0 -0
  37. /package/dist/{chunk-VMBA4NVU.js.map → chunk-I6AYGFSQ.js.map} +0 -0
  38. /package/dist/{getChromeCookie-CL3SRRWX.js.map → getChromeCookie-2ROVM47V.js.map} +0 -0
  39. /package/dist/{getChromePassword-GTIXL733.js.map → getChromePassword-O452VQWI.js.map} +0 -0
  40. /package/dist/{getCookie-WV5KDZN7.js.map → getCookie-CRE6M3GI.js.map} +0 -0
  41. /package/dist/{getFirefoxCookie-BXQ2GXAW.js.map → getFirefoxCookie-5P74VDC7.js.map} +0 -0
  42. /package/dist/{getGroupedRenderedCookies-FNJ6FQVQ.js.map → getGroupedRenderedCookies-DFEJTTC6.js.map} +0 -0
  43. /package/dist/{getMergedRenderedCookies-PNC2LHSD.js.map → getMergedRenderedCookies-W5GSSHQQ.js.map} +0 -0
@@ -1,2 +0,0 @@
1
- import{z as e}from"zod";var k=e.object({name:e.string().trim().min(1,"Cookie name cannot be empty"),domain:e.string().trim().min(1,"Domain cannot be empty")}).strict(),y=e.object({file:e.string().trim().min(1,"File path cannot be empty").optional(),browser:e.string().trim().optional(),decrypted:e.boolean().optional(),secure:e.boolean().optional(),httpOnly:e.boolean().optional(),path:e.string().optional()}).catchall(e.unknown()).strict(),l=e.object({domain:e.string().trim().min(1,"Domain cannot be empty"),name:e.string().trim().min(1,"Cookie name cannot be empty"),value:e.string(),expiry:e.union([e.literal("Infinity"),e.date(),e.number().int().positive("Expiry must be a positive number")]).optional(),meta:y.optional()}).strict(),C=e.object({expiry:e.number().int().optional(),domain:e.string().trim().min(1,"Domain cannot be empty"),name:e.string().trim().min(1,"Cookie name cannot be empty"),value:e.union([e.string(),e.instanceof(Buffer)])}).strict(),x=e.object({format:e.enum(["merged","grouped"]).optional(),separator:e.string().optional(),showFilePaths:e.boolean().optional()}).strict(),u=e.enum(["Chrome","Firefox","Safari","internal","unknown"]),b=e.object({browserName:u,queryCookies:e.function().args(e.string(),e.string()).returns(e.promise(e.array(l)))}).strict();import{groupBy as f}from"lodash-es";function d(r,p={}){let{format:i="merged",showFilePaths:m=!0,separator:a="; "}=p;if(r.length===0)return i==="merged"?"":[];if(i==="merged")return r.map(o=>o.value).join(a);let s=f(r,o=>{var n,t;return(t=(n=o.meta)==null?void 0:n.file)!=null?t:"unknown"});return Object.entries(s).map(([o,n])=>{let t=n.map(c=>c.value).join(a);return m?`${o}: ${t}`:t})}export{l as a,d as b};
2
- //# sourceMappingURL=chunk-A6MIB6FP.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/types/schemas.ts","../src/core/cookies/renderCookies.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Schema for cookie specification parameters\n * Defines the required fields for identifying a cookie\n * @example\n * ```typescript\n * // Validate a cookie specification\n * const spec = {\n * name: 'session',\n * domain: 'example.com'\n * };\n * const result = CookieSpecSchema.safeParse(spec);\n * if (result.success) {\n * console.log('Valid cookie spec:', result.data);\n * } else {\n * console.error('Invalid cookie spec:', result.error);\n * }\n *\n * // Invalid spec (empty name)\n * const invalidSpec = {\n * name: '',\n * domain: 'example.com'\n * };\n * // Throws: \"Cookie name cannot be empty\"\n * CookieSpecSchema.parse(invalidSpec);\n * ```\n */\nexport const CookieSpecSchema = z\n .object({\n name: z.string().trim().min(1, \"Cookie name cannot be empty\"),\n domain: z.string().trim().min(1, \"Domain cannot be empty\"),\n })\n .strict();\n\n/**\n * Type definition for cookie specification\n * Used for specifying which cookie to query\n * @example\n * ```typescript\n * // Basic cookie spec\n * const spec: CookieSpec = {\n * name: 'auth',\n * domain: 'api.example.com'\n * };\n *\n * // Use in function parameters\n * function queryCookie(spec: CookieSpec): Promise<ExportedCookie[]> {\n * return getCookie(spec);\n * }\n *\n * // Array of specs\n * const specs: CookieSpec[] = [\n * { name: 'session', domain: 'app.example.com' },\n * { name: 'theme', domain: 'example.com' }\n * ];\n * ```\n */\nexport type CookieSpec = z.infer<typeof CookieSpecSchema>;\n\n/**\n * Schema for metadata about a cookie\n */\nexport const CookieMetaSchema = z\n .object({\n file: z.string().trim().min(1, \"File path cannot be empty\").optional(),\n browser: z.string().trim().optional(),\n decrypted: z.boolean().optional(),\n secure: z.boolean().optional(),\n httpOnly: z.boolean().optional(),\n path: z.string().optional(),\n })\n .catchall(z.unknown())\n .strict();\n\n/**\n * Type definition for cookie metadata\n */\nexport type CookieMeta = z.infer<typeof CookieMetaSchema>;\n\n/**\n * Schema for exported cookie data\n * Represents a cookie with all its properties and metadata\n * @example\n * ```typescript\n * // Validate an exported cookie\n * const cookie = {\n * domain: 'example.com',\n * name: 'session',\n * value: 'abc123',\n * expiry: new Date('2024-12-31'),\n * meta: {\n * file: '/path/to/cookies.db'\n * }\n * };\n * const result = ExportedCookieSchema.safeParse(cookie);\n * if (result.success) {\n * console.log('Valid cookie:', result.data);\n * } else {\n * console.error('Invalid cookie:', result.error);\n * }\n *\n * // Cookie with infinite expiry\n * const infiniteCookie = {\n * ...cookie,\n * expiry: \"Infinity\"\n * };\n * ExportedCookieSchema.parse(infiniteCookie); // OK\n * ```\n */\nexport const ExportedCookieSchema = z\n .object({\n domain: z.string().trim().min(1, \"Domain cannot be empty\"),\n name: z.string().trim().min(1, \"Cookie name cannot be empty\"),\n value: z.string(),\n expiry: z\n .union([\n z.literal(\"Infinity\"),\n z.date(),\n z.number().int().positive(\"Expiry must be a positive number\"),\n ])\n .optional(),\n meta: CookieMetaSchema.optional(),\n })\n .strict();\n\n/**\n * Type definition for exported cookie data\n * Represents the structure of a cookie after it has been retrieved\n * @example\n * ```typescript\n * // Basic exported cookie\n * const cookie: ExportedCookie = {\n * domain: 'example.com',\n * name: 'session',\n * value: 'abc123',\n * expiry: new Date('2024-12-31'),\n * meta: {\n * file: '/path/to/cookies.db'\n * }\n * };\n *\n * // Process exported cookies\n * function processCookies(cookies: ExportedCookie[]): string[] {\n * return cookies.map(cookie => `${cookie.name}=${cookie.value}`);\n * }\n *\n * // Filter expired cookies\n * function filterExpired(cookies: ExportedCookie[]): ExportedCookie[] {\n * const now = new Date();\n * return cookies.filter(cookie =>\n * cookie.expiry === \"Infinity\" ||\n * (cookie.expiry instanceof Date && cookie.expiry > now)\n * );\n * }\n * ```\n */\nexport type ExportedCookie = z.infer<typeof ExportedCookieSchema>;\n\n/**\n * Schema for raw cookie data from browser stores\n */\nexport const CookieRowSchema = z\n .object({\n expiry: z.number().int().optional(),\n domain: z.string().trim().min(1, \"Domain cannot be empty\"),\n name: z.string().trim().min(1, \"Cookie name cannot be empty\"),\n value: z.union([z.string(), z.instanceof(Buffer)]),\n })\n .strict();\n\n/**\n * Type definition for raw cookie data\n */\nexport type CookieRow = z.infer<typeof CookieRowSchema>;\n\n/**\n * Schema for cookie render options\n */\nexport const RenderOptionsSchema = z\n .object({\n format: z.enum([\"merged\", \"grouped\"]).optional(),\n separator: z.string().optional(),\n showFilePaths: z.boolean().optional(),\n })\n .strict();\n\n/**\n * Type definition for render options\n */\nexport type RenderOptions = z.infer<typeof RenderOptionsSchema>;\n\n/**\n * Schema for browser names\n */\nexport const BrowserNameSchema = z.enum([\n \"Chrome\",\n \"Firefox\",\n \"Safari\",\n \"internal\",\n \"unknown\",\n]);\n\n/**\n * Type definition for browser names\n */\nexport type BrowserName = z.infer<typeof BrowserNameSchema>;\n\n/**\n * Schema for cookie query strategy\n */\nexport const CookieQueryStrategySchema = z\n .object({\n browserName: BrowserNameSchema,\n queryCookies: z\n .function()\n .args(z.string(), z.string())\n .returns(z.promise(z.array(ExportedCookieSchema))),\n })\n .strict();\n\n/**\n * Type definition for cookie query strategy\n */\nexport type CookieQueryStrategy = z.infer<typeof CookieQueryStrategySchema>;\n\n/**\n * Type representing either a single cookie specification or an array of specifications.\n * Useful when you need to query multiple cookies in a single operation.\n * @example\n * ```typescript\n * // Single cookie spec\n * const single: MultiCookieSpec = {\n * domain: \"example.com\",\n * name: \"sessionId\"\n * };\n *\n * // Multiple cookie specs\n * const multiple: MultiCookieSpec = [\n * { domain: \"example.com\", name: \"sessionId\" },\n * { domain: \"api.example.com\", name: \"authToken\" }\n * ];\n * ```\n */\nexport type MultiCookieSpec = CookieSpec | CookieSpec[];\n","import { groupBy } from \"lodash-es\";\n\nimport { ExportedCookie, RenderOptions } from \"../../types/schemas\";\n\n/**\n * Renders cookies as a string or array of strings based on the provided format option.\n * Supports merged format for single string output or grouped format for file-based grouping.\n * @param cookies - The cookies to render\n * @param options - Options for rendering\n * @param options.format - The output format ('merged' or 'grouped')\n * @param options.showFilePaths - Whether to include file paths in grouped output\n * @param options.separator - Custom separator for cookie values\n * @returns A string for merged format, or array of strings for grouped format\n * @example\n * ```typescript\n * // Merged format (default)\n * const cookies = [\n * { value: 'sessionId=abc123' },\n * { value: 'theme=dark' }\n * ];\n * renderCookies(cookies);\n * // Returns: \"sessionId=abc123; theme=dark\"\n *\n * // Grouped format with file paths\n * const groupedCookies = [\n * { value: 'sessionId=abc123', meta: { file: 'auth.ts' } },\n * { value: 'theme=dark', meta: { file: 'preferences.ts' } }\n * ];\n * renderCookies(groupedCookies, { format: 'grouped', showFilePaths: true });\n * // Returns: [\"auth.ts: sessionId=abc123\", \"preferences.ts: theme=dark\"]\n * ```\n */\nexport function renderCookies(\n cookies: ExportedCookie[],\n options: RenderOptions = {},\n): string | string[] {\n const { format = \"merged\", showFilePaths = true, separator = \"; \" } = options;\n\n if (cookies.length === 0) {\n return format === \"merged\" ? \"\" : [];\n }\n\n if (format === \"merged\") {\n return cookies.map((c) => c.value).join(separator);\n }\n\n const groupedByFile = groupBy(cookies, (c) => c.meta?.file ?? \"unknown\");\n return Object.entries(groupedByFile).map(([file, fileCookies]) => {\n const values = fileCookies.map((c) => c.value).join(separator);\n return showFilePaths ? `${file}: ${values}` : values;\n });\n}\n"],"mappings":"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","names":["z","CookieSpecSchema","CookieMetaSchema","ExportedCookieSchema","CookieRowSchema","RenderOptionsSchema","BrowserNameSchema","CookieQueryStrategySchema","groupBy","renderCookies","cookies","options","format","showFilePaths","separator","c","groupedByFile","_a","_b","file","fileCookies","values"]}
@@ -1,2 +0,0 @@
1
- import{a as g}from"./chunk-UPNW543B.js";import{a as l}from"./chunk-IRERRCUF.js";import{a as f,c as m}from"./chunk-56Z35D5R.js";import{join as B}from"path";import{readFileSync as S}from"fs";import{homedir as L}from"os";import{join as Q}from"path";var w=1706047360;function p(o,e){let t=e;for(;t<o.length&&o[t]!==0;)t++;return[o.toString("utf8",e,t),t+1]}function b(o,e){let t=o.readUInt32LE(e),n=e+43,r=o.readUInt32LE(n)-w,i=e+56,[a,c]=p(o,i);i=c;let[d,C]=p(o,i);i=C;let[h,x]=p(o,i);i=x;let[E,P]=p(o,i);return[{name:d,value:E,domain:a.startsWith(".")?a.slice(1):a,path:h||"/",expiry:r,creation:r},t]}function v(o,e,t){let n=e+5,s=o.readUInt32BE(n),r=e+s,i=[],a=e+t;for(;r<a-8;)try{let[c,d]=b(o,r);i.push(c),r+=d}catch(c){console.warn(`Error decoding cookie at offset ${r}:`,c);break}return i}function y(o){let e=S(o),t=e.readUInt32BE(4),n=[];for(let i=0;i<t;i++)n.push(e.readUInt32BE(8+i*4));let s=8+t*4,r=[];for(let i=0;i<t;i++)try{let a=v(e,s,n[i]);r.push(...a),s+=n[i]}catch(a){console.warn(`Error decoding page ${i}:`,a),s+=n[i]}return r}var u=class{constructor(){this.browserName="Safari"}getHomeDir(){let e=process.env.HOME;return typeof e!="string"||e.trim().length===0?(m("SafariCookieQueryStrategy","HOME environment variable not set"),""):e}getCookieDbPath(e){return B(e,"Library","Containers","com.apple.Safari","Data","Library","Cookies","Cookies.binarycookies")}decodeCookies(e,t,n){try{return y(e).filter(r=>r.name===t&&r.domain.includes(n)).map(r=>({domain:r.domain,name:r.name,value:r.value.toString(),expiry:typeof r.expiry=="number"&&r.expiry>0?new Date(r.expiry*1e3):"Infinity",meta:{file:e,browser:"Safari",decrypted:!1}}))}catch(s){return s instanceof Error?m("SafariCookieQueryStrategy",`Error decoding ${e}`,{error:s,name:t,domain:n}):m("SafariCookieQueryStrategy",`Error decoding ${e}`,{error:"Unknown error",name:t,domain:n}),[]}}async queryCookies(e,t){let n=this.getHomeDir();if(typeof n!="string"||n.length===0)return Promise.resolve([]);let s=this.getCookieDbPath(n);return Promise.resolve(this.decodeCookies(s,e,t))}};async function k(o){if(!o.name||!o.domain)return[];let{name:e,domain:t}=o;if(typeof e!="string"||typeof t!="string")return[];let n=[new g,new l,new u];return(await Promise.allSettled(n.map(r=>r.queryCookies(e,t)))).filter(r=>r.status==="fulfilled").flatMap(r=>r.value)}async function O(o){try{return await k(o)}catch(e){return f.warn("Error querying cookies:",e instanceof Error?e.message:String(e)),[]}}var j=O;export{O as a,j as b};
2
- //# sourceMappingURL=chunk-CFMK2YSL.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/core/browsers/safari/SafariCookieQueryStrategy.ts","../src/core/browsers/decodeBinaryCookies.ts","../src/core/cookies/queryCookies.ts","../src/core/cookies/getCookie.ts"],"sourcesContent":["import { join } from \"path\";\n\nimport { logError } from \"@utils/logHelpers\";\n\nimport type {\n BrowserName,\n CookieQueryStrategy,\n ExportedCookie,\n} from \"../../../types/schemas\";\nimport { decodeBinaryCookies } from \"../decodeBinaryCookies\";\n\n/**\n * Strategy for querying cookies from Safari browser\n */\nexport class SafariCookieQueryStrategy implements CookieQueryStrategy {\n /**\n * The browser name for this strategy\n */\n public readonly browserName: BrowserName = \"Safari\";\n\n /**\n * Gets the user's home directory\n * @returns The home directory path or empty string if not found\n */\n private getHomeDir(): string {\n const homeDir = process.env.HOME;\n if (typeof homeDir !== \"string\" || homeDir.trim().length === 0) {\n logError(\n \"SafariCookieQueryStrategy\",\n \"HOME environment variable not set\",\n );\n return \"\";\n }\n return homeDir;\n }\n\n /**\n * Gets the path to Safari's cookie database\n * @param homeDir - The user's home directory\n * @returns Path to the cookie database\n */\n private getCookieDbPath(homeDir: string): string {\n return join(\n homeDir,\n \"Library\",\n \"Containers\",\n \"com.apple.Safari\",\n \"Data\",\n \"Library\",\n \"Cookies\",\n \"Cookies.binarycookies\",\n );\n }\n\n /**\n * Decodes cookies from Safari's binary cookie file\n * @param cookieDbPath - Path to the cookie database\n * @param name - Name of the cookie to find\n * @param domain - Domain to filter cookies by\n * @returns Array of exported cookies\n */\n private decodeCookies(\n cookieDbPath: string,\n name: string,\n domain: string,\n ): ExportedCookie[] {\n try {\n const cookies = decodeBinaryCookies(cookieDbPath);\n return cookies\n .filter(\n (cookie) => cookie.name === name && cookie.domain.includes(domain),\n )\n .map((cookie) => ({\n domain: cookie.domain,\n name: cookie.name,\n value: cookie.value.toString(),\n expiry:\n typeof cookie.expiry === \"number\" && cookie.expiry > 0\n ? new Date(cookie.expiry * 1000)\n : \"Infinity\",\n meta: {\n file: cookieDbPath,\n browser: \"Safari\" as const,\n decrypted: false,\n },\n }));\n } catch (error) {\n if (error instanceof Error) {\n logError(\n \"SafariCookieQueryStrategy\",\n `Error decoding ${cookieDbPath}`,\n { error, name, domain },\n );\n } else {\n logError(\n \"SafariCookieQueryStrategy\",\n `Error decoding ${cookieDbPath}`,\n { error: \"Unknown error\", name, domain },\n );\n }\n return [];\n }\n }\n\n /**\n * Query Safari's cookie storage for cookies matching the given criteria\n * @param name - Name of the cookie to find\n * @param domain - Domain to filter cookies by\n * @returns Array of matching cookies, or empty array if none found\n */\n public async queryCookies(\n name: string,\n domain: string,\n ): Promise<ExportedCookie[]> {\n const homeDir = this.getHomeDir();\n if (typeof homeDir !== \"string\" || homeDir.length === 0) {\n return Promise.resolve([]);\n }\n\n const cookieDbPath = this.getCookieDbPath(homeDir);\n return Promise.resolve(this.decodeCookies(cookieDbPath, name, domain));\n }\n}\n","import { readFileSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { join } from \"path\";\n\ninterface CookieRow {\n name: string;\n value: string;\n domain: string;\n path: string;\n expiry: number;\n creation: number;\n flags?: number;\n}\n\n// The date offset for Safari cookies (until 2017)\nconst SAFARI_DATE_OFFSET = 1706047360;\n\nfunction readNullTerminatedString(\n buffer: Buffer,\n offset: number,\n): [string, number] {\n let end = offset;\n while (end < buffer.length && buffer[end] !== 0) {\n end++;\n }\n return [buffer.toString(\"utf8\", offset, end), end + 1];\n}\n\nfunction decodeCookieHeader(\n buffer: Buffer,\n offset: number,\n): [CookieRow, number] {\n // First 4 bytes are the cookie size in little-endian\n const size = buffer.readUInt32LE(offset);\n\n // Read the date at offset 0x2B (43 bytes from start)\n const dateOffset = offset + 0x2b;\n const date = buffer.readUInt32LE(dateOffset);\n const timestamp = date - SAFARI_DATE_OFFSET;\n\n // Dynamic fields start at offset 0x38 (56 bytes from start)\n let currentOffset = offset + 0x38;\n const [domain, nextOffset] = readNullTerminatedString(buffer, currentOffset);\n currentOffset = nextOffset;\n\n const [name, nextOffset2] = readNullTerminatedString(buffer, currentOffset);\n currentOffset = nextOffset2;\n\n // The fields are path, then value\n const [path, nextOffset3] = readNullTerminatedString(buffer, currentOffset);\n currentOffset = nextOffset3;\n\n const [value, _] = readNullTerminatedString(buffer, currentOffset);\n\n return [\n {\n name,\n value,\n domain: domain.startsWith(\".\") ? domain.slice(1) : domain,\n path: path || \"/\", // Default to root path if empty\n expiry: timestamp,\n creation: timestamp, // We don't have creation time in this format\n },\n size,\n ];\n}\n\nfunction decodePage(\n buffer: Buffer,\n offset: number,\n pageSize: number,\n): CookieRow[] {\n // Skip first 5 bytes\n const headerLengthOffset = offset + 5;\n // Next 4 bytes contain header length\n const headerLength = buffer.readUInt32BE(headerLengthOffset);\n\n let currentOffset = offset + headerLength;\n const cookies: CookieRow[] = [];\n const pageEnd = offset + pageSize;\n\n // Read cookies until we reach the page end\n while (currentOffset < pageEnd - 8) {\n try {\n const [cookie, size] = decodeCookieHeader(buffer, currentOffset);\n cookies.push(cookie);\n currentOffset += size;\n } catch (error) {\n console.warn(`Error decoding cookie at offset ${currentOffset}:`, error);\n break;\n }\n }\n\n return cookies;\n}\n\n/**\n * Decodes a Safari binary cookie file into an array of cookie objects.\n * @param cookieDbPath - Path to the Safari Cookies.binarycookies file\n * @returns Array of decoded cookie objects\n * @throws {Error} If the file cannot be read or has invalid format\n */\nexport function decodeBinaryCookies(cookieDbPath: string): CookieRow[] {\n const buffer = readFileSync(cookieDbPath);\n\n // Skip first 4 bytes (header)\n const numPages = buffer.readUInt32BE(4);\n\n // Read the page sizes array (4 bytes per page)\n const pageSizes: number[] = [];\n for (let i = 0; i < numPages; i++) {\n pageSizes.push(buffer.readUInt32BE(8 + i * 4));\n }\n\n // Skip the page sizes array\n let offset = 8 + numPages * 4;\n const cookies: CookieRow[] = [];\n\n // Process each page\n for (let i = 0; i < numPages; i++) {\n try {\n const pageCookies = decodePage(buffer, offset, pageSizes[i]);\n cookies.push(...pageCookies);\n offset += pageSizes[i];\n } catch (error) {\n console.warn(`Error decoding page ${i}:`, error);\n offset += pageSizes[i];\n }\n }\n\n return cookies;\n}\n\n/**\n * Retrieves cookies from Safari's binary cookie store.\n * @returns Array of decoded Safari cookies\n */\nexport function getSafariCookies(): CookieRow[] {\n const cookieDbPath = join(\n homedir(),\n \"Library/Containers/com.apple.Safari/Data/Library/Cookies/Cookies.binarycookies\",\n );\n return decodeBinaryCookies(cookieDbPath);\n}\n","import type { CookieSpec, ExportedCookie } from \"../../types/schemas\";\nimport { ChromeCookieQueryStrategy } from \"../browsers/chrome/ChromeCookieQueryStrategy\";\nimport { FirefoxCookieQueryStrategy } from \"../browsers/firefox/FirefoxCookieQueryStrategy\";\nimport { SafariCookieQueryStrategy } from \"../browsers/safari/SafariCookieQueryStrategy\";\n\n/**\n * Queries cookies from all available browser strategies (Chrome, Firefox, Safari).\n * This function acts as a unified interface to retrieve cookies across different browsers.\n * @param cookieSpec - The cookie specification to query\n * @param cookieSpec.name - The name pattern to match cookies against (can include '%' as wildcard)\n * @param cookieSpec.domain - The domain to match cookies against\n * @returns Promise resolving to array of exported cookies from all available browsers\n * @remarks\n * - Returns empty array if cookieSpec is invalid or missing required fields\n * - Aggregates results from all available browser strategies\n * - Failed browser queries are gracefully handled and excluded from results\n * - Both name and domain fields are required and must be strings\n * @example\n * ```typescript\n * const cookies = await queryCookies({\n * name: 'sessionId',\n * domain: 'example.com'\n * });\n * console.log(cookies); // Array of matching cookies from all browsers\n * ```\n */\nexport async function queryCookies(\n cookieSpec: CookieSpec,\n): Promise<ExportedCookie[]> {\n if (!cookieSpec.name || !cookieSpec.domain) {\n return [];\n }\n\n const { name, domain } = cookieSpec;\n if (typeof name !== \"string\" || typeof domain !== \"string\") {\n return [];\n }\n\n /**\n * Initialize all available browser-specific strategies\n * The order of strategies can affect performance but not functionality\n * Each strategy is responsible for its own error handling\n */\n const strategies = [\n new ChromeCookieQueryStrategy(),\n new FirefoxCookieQueryStrategy(),\n new SafariCookieQueryStrategy(),\n ];\n\n /**\n * Query all strategies in parallel and handle failures gracefully\n * Using Promise.allSettled ensures that failures in one strategy\n * don't prevent results from other strategies\n */\n const results = await Promise.allSettled(\n strategies.map((strategy) => strategy.queryCookies(name, domain)),\n );\n\n /**\n * Filter out failed promises and flatten successful results\n * Using PromiseFulfilledResult<ExportedCookie[]> ensures that only successful results are included\n */\n return results\n .filter(\n (result): result is PromiseFulfilledResult<ExportedCookie[]> =>\n result.status === \"fulfilled\",\n )\n .flatMap((result) => result.value);\n}\n\n/**\n * Default export of the queryCookies function.\n * This is the recommended way to import the function for most use cases.\n * @example\n * ```typescript\n * import queryCookies from './queryCookies';\n *\n * // Query cookies with specific name\n * const sessionCookies = await queryCookies({\n * name: 'sessionId',\n * domain: 'example.com'\n * });\n *\n * // Query all cookies for a domain using wildcard\n * const allCookies = await queryCookies({\n * name: '%',\n * domain: 'example.com'\n * });\n * ```\n */\nexport default queryCookies;\n","import type { CookieSpec, ExportedCookie } from \"../../types/schemas\";\nimport logger from \"../../utils/logger\";\n\nimport { queryCookies } from \"./queryCookies\";\n\n/**\n * Retrieves browser cookies that match the specified cookie name and domain criteria.\n * This function provides a way to search and filter cookies based on given specifications.\n * @param cookieSpec - The cookie specification containing search criteria\n * @param cookieSpec.name - The name of the cookie to search for\n * @param cookieSpec.domain - (optional) The domain to filter cookies by\n * @returns An array of ExportedCookie objects that match the specification\n * @throws Will catch and handle any errors during cookie querying, logging a warning\n * to the console without throwing to the caller\n * @example\n * ```typescript\n * // Get all cookies named \"sessionId\"\n * const cookies = await getCookie({ name: \"sessionId\" });\n * // Returns: [{ name: \"sessionId\", value: \"abc123\", domain: \".example.com\", ... }]\n *\n * // Get cookies named \"userPref\" from specific domain\n * const domainCookies = await getCookie({\n * name: \"userPref\",\n * domain: \"example.com\"\n * });\n * // Returns: [{ name: \"userPref\", value: \"darkMode\", domain: \"example.com\", ... }]\n * ```\n */\nexport async function getCookie(\n cookieSpec: CookieSpec,\n): Promise<ExportedCookie[]> {\n try {\n const cookies = await queryCookies(cookieSpec);\n return cookies;\n } catch (error: unknown) {\n logger.warn(\n \"Error querying cookies:\",\n error instanceof Error ? error.message : String(error),\n );\n return [];\n }\n}\n\n/**\n * Default export of the getCookie function.\n * @example\n * ```typescript\n * import getCookie from './getCookie';\n * const authCookies = await getCookie({\n * name: \"auth-token\",\n * domain: \"api.example.com\"\n * });\n * ```\n */\nexport default getCookie;\n"],"mappings":"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","names":["join","readFileSync","homedir","join","SAFARI_DATE_OFFSET","readNullTerminatedString","buffer","offset","end","decodeCookieHeader","size","dateOffset","timestamp","currentOffset","domain","nextOffset","name","nextOffset2","path","nextOffset3","value","_","decodePage","pageSize","headerLengthOffset","headerLength","cookies","pageEnd","cookie","error","decodeBinaryCookies","cookieDbPath","numPages","pageSizes","pageCookies","SafariCookieQueryStrategy","homeDir","logError","join","cookieDbPath","name","domain","decodeBinaryCookies","cookie","error","queryCookies","cookieSpec","name","domain","strategies","ChromeCookieQueryStrategy","FirefoxCookieQueryStrategy","SafariCookieQueryStrategy","strategy","result","getCookie","cookieSpec","queryCookies","error","logger_default","getCookie_default"]}
@@ -1,2 +0,0 @@
1
- import{a as t}from"./chunk-UPNW543B.js";import"./chunk-5FUMK7M3.js";import{a as r}from"./chunk-56Z35D5R.js";import"./chunk-VMBA4NVU.js";async function i(o){try{return await new t().queryCookies(o.name,o.domain)}catch(e){return r.warn("Error querying Chrome cookies:",e),[]}}var a=i;export{a as default,i as getChromeCookie};
2
- //# sourceMappingURL=getChromeCookie-CL3SRRWX.js.map
@@ -1,2 +0,0 @@
1
- import{a,b}from"./chunk-CFMK2YSL.js";import"./chunk-UPNW543B.js";import"./chunk-IRERRCUF.js";import"./chunk-5FUMK7M3.js";import"./chunk-56Z35D5R.js";import"./chunk-VMBA4NVU.js";export{b as default,a as getCookie};
2
- //# sourceMappingURL=getCookie-WV5KDZN7.js.map
@@ -1,2 +0,0 @@
1
- import{a as t}from"./chunk-IRERRCUF.js";import"./chunk-5FUMK7M3.js";import{a as r}from"./chunk-56Z35D5R.js";import"./chunk-VMBA4NVU.js";async function i(e){try{return await new t().queryCookies(e.name,e.domain)}catch(o){return r.warn("Error querying Firefox cookies:",o instanceof Error?o.message:String(o)),[]}}var c=i;export{c as default,i as getFirefoxCookie};
2
- //# sourceMappingURL=getFirefoxCookie-BXQ2GXAW.js.map
@@ -1,2 +0,0 @@
1
- import{a as i,b as n}from"./chunk-A6MIB6FP.js";import{a as t}from"./chunk-CFMK2YSL.js";import"./chunk-UPNW543B.js";import"./chunk-IRERRCUF.js";import"./chunk-5FUMK7M3.js";import{a as e}from"./chunk-56Z35D5R.js";import"./chunk-VMBA4NVU.js";async function c(s,a={}){try{let r=await t(s);if(!Array.isArray(r))return[];let m=r.filter(p=>{let o=i.safeParse(p);return o.success?!0:(e.warn("Invalid cookie format:",o.error.format()),!1)});return n(m,{...a,format:"grouped"})}catch(r){return e.warn("Error getting grouped rendered cookies:",r instanceof Error?r.message:String(r)),[]}}var g=c;export{g as default,c as getGroupedRenderedCookies};
2
- //# sourceMappingURL=getGroupedRenderedCookies-FNJ6FQVQ.js.map
@@ -1,2 +0,0 @@
1
- import{a as n,b as s}from"./chunk-A6MIB6FP.js";import{a as i}from"./chunk-CFMK2YSL.js";import"./chunk-UPNW543B.js";import"./chunk-IRERRCUF.js";import"./chunk-5FUMK7M3.js";import{a as r}from"./chunk-56Z35D5R.js";import"./chunk-VMBA4NVU.js";async function d(a,m){try{let e=await i(a);if(!Array.isArray(e))return"";let c=e.filter(f=>{let t=n.safeParse(f);return t.success?!0:(r.warn("Invalid cookie format:",t.error.format()),!1)}),o=s(c,{...m,format:"merged"});return typeof o=="string"?o:""}catch(e){return r.warn("Error getting merged rendered cookies:",e instanceof Error?e.message:String(e)),""}}var C=d;export{C as default,d as getMergedRenderedCookies};
2
- //# sourceMappingURL=getMergedRenderedCookies-PNC2LHSD.js.map