@mks2508/binary-cookies-parser 1.0.0 → 2.0.0

package/dist/cjs/index.js

@@ -1 +1,2 @@
-var D=Object.create;var{getPrototypeOf:O,defineProperty:M,getOwnPropertyNames:Z,getOwnPropertyDescriptor:S}=Object,_=Object.prototype.hasOwnProperty;var B=(E,q,F)=>{F=E!=null?D(O(E)):{};let G=q||!E||!E.__esModule?M(F,"default",{value:E,enumerable:!0}):F;for(let L of Z(E))if(!_.call(G,L))M(G,L,{get:()=>E[L],enumerable:!0});return G},Y=new WeakMap,m=(E)=>{var q=Y.get(E),F;if(q)return q;if(q=M({},"__esModule",{value:!0}),E&&typeof E==="object"||typeof E==="function")Z(E).map((G)=>!_.call(q,G)&&M(q,G,{get:()=>E[G],enumerable:!(F=S(E,G))||F.enumerable}));return Y.set(E,q),q};var C=(E,q)=>{for(var F in q)M(E,F,{get:q[F],enumerable:!0,configurable:!0,set:(G)=>q[F]=()=>G})};var x={};C(x,{parseBinaryCookies:()=>I,BinaryCookiesParser:()=>U});module.exports=m(x);var $=B(require("node:fs/promises")),w=require("node:fs");class U{cookiePath=null;currentBufferPosition=0;data=null;numPages=0;bufferSize=0;pages=[];pageSizes=[];cookies=[];async parse(E){if(this.reset(),this.cookiePath=E,!w.existsSync(E))throw Error(`Cookie file not found: ${E}`);await this.openFile(),this.getNumPages(),this.getPageSizes(),this.getPages();for(let q=0;q<this.pages.length;q++){this.getNumCookies(q),this.getCookieOffsets(q),this.getCookieData(q);for(let F=0;F<this.pages[q].cookies.length;F++){let G=this.parseCookieData(q,F);this.cookies.push(G)}}return this.cookies}reset(){this.cookiePath=null,this.currentBufferPosition=0,this.data=null,this.numPages=0,this.bufferSize=0,this.pages=[],this.pageSizes=[],this.cookies=[]}async openFile(){if(!this.cookiePath)throw Error("Cookie path not set");let E=await $.default.readFile(this.cookiePath);if(this.data=E,this.bufferSize=E.length,this.readSlice(4).toString()!=="cook")throw Error('Invalid binary cookies file format (missing "cook" header)')}readSlice(E){if(!this.data)throw Error("No data loaded");let q=this.data.subarray(this.currentBufferPosition,this.currentBufferPosition+E);return this.currentBufferPosition+=E,q}readIntBE(){if(!this.data)throw Error("No data loaded");let E=this.data.readInt32BE(this.currentBufferPosition);return this.currentBufferPosition+=4,E}readIntLE(){if(!this.data)throw Error("No data loaded");let E=this.data.readInt32LE(this.currentBufferPosition);return this.currentBufferPosition+=4,E}getNumPages(){return this.numPages=this.readIntBE(),this.numPages}getPageSizes(){for(let E=0;E<this.numPages;E++)this.pageSizes.push(this.readIntBE());return this.pageSizes}getPages(){for(let E of this.pageSizes)this.pages.push({buffer:this.readSlice(E),bufferPosition:0,numCookies:0,cookieOffsets:[],cookies:[]});return this.pages}getNumCookies(E){let q=this.pages[E];q.bufferPosition=0;let F=q.buffer.readInt32BE(q.bufferPosition);if(q.bufferPosition+=4,F!==256)throw Error(`Invalid page header: expected 256, got ${F}`);return q.numCookies=q.buffer.readInt32LE(q.bufferPosition),q.bufferPosition+=4,q.numCookies}getCookieOffsets(E){let q=this.pages[E];q.cookieOffsets=[];for(let F=0;F<q.numCookies;F++)q.cookieOffsets.push(q.buffer.readInt32LE(q.bufferPosition)),q.bufferPosition+=4;return q.cookieOffsets}getCookieData(E){let q=this.pages[E];q.cookies=[];for(let F of q.cookieOffsets){let G=q.buffer.readInt32LE(F);try{q.cookies.push({buffer:q.buffer.subarray(F,F+G)})}catch{q.cookies.push({buffer:q.buffer.subarray(F)})}}return q.cookies}parseCookieData(E,q){let L=this.pages[E].cookies[q].buffer,y=978307200,J=0,l=L.readInt32LE(J);J+=4;let K=L.readInt32LE(J);J+=8;let d=L.readUInt32LE(J),V={},z=["url","name","path","value"];for(let N of z)J+=4,V[N]=L.readInt32LE(J);J+=4;let h=L.readUInt32LE(J);J+=8;let A=L.readDoubleLE(J)+978307200,H=new Date(A*1000);J+=8;let T=L.readDoubleLE(J)+978307200,j=new Date(T*1000),W={flags:K,expiration:H,creation:j};for(let[N,v]of Object.entries(V)){let X="",Q=v,R="";do R=L.toString("utf8",Q,Q+1),X+=R,Q++;while(R!=="\x00");W[N]=X.replace(/\u0000/g,"").trim()}return W}}async function I(E){return new U().parse(E)}
+var{defineProperty:V,getOwnPropertyNames:Y,getOwnPropertyDescriptor:Z}=Object,_=Object.prototype.hasOwnProperty;var W=new WeakMap,$=(E)=>{var q=W.get(E),G;if(q)return q;if(q=V({},"__esModule",{value:!0}),E&&typeof E==="object"||typeof E==="function")Y(E).map((K)=>!_.call(q,K)&&V(q,K,{get:()=>E[K],enumerable:!(G=Z(E,K))||G.enumerable}));return W.set(E,q),q};var j=(E,q)=>{for(var G in q)V(E,G,{get:q[G],enumerable:!0,configurable:!0,set:(K)=>q[G]=()=>K})};var J={};j(J,{tryDetectFormat:()=>R.tryDetectFormat,toNetscapeFormat:()=>x,toJSONFormat:()=>H,toCookieHeader:()=>P,parseNetscape:()=>M.parseNetscape,parseJSON:()=>Q.parseJSON,parseCookies:()=>w,parseBinaryToUniversal:()=>I.parseBinaryToUniversal,parseBinaryCookies:()=>I.parseBinaryCookies,isNetscapeFormat:()=>M.isNetscapeFormat,isJSONFormat:()=>Q.isJSONFormat,isBinaryFormat:()=>I.isBinaryFormat,filterExpired:()=>g,filterByDomain:()=>A,detectFormat:()=>R.detectFormat,binaryToUniversal:()=>I.binaryToUniversal,BinaryCookiesParser:()=>I.BinaryCookiesParser});module.exports=$(J);var M=require("./parsers/netscape"),Q=require("./parsers/json"),I=require("./parsers/binary"),R=require("./detector");function w(E){let q=R.detectFormat(E);switch(q){case"netscape":return{format:q,cookies:M.parseNetscape(E)};case"json":return{format:q,cookies:Q.parseJSON(Buffer.isBuffer(E)?E.toString("utf8"):E)};case"binary":return{format:q,cookies:I.parseBinaryToUniversal(Buffer.isBuffer(E)?E:Buffer.from(E))}}}function A(E,q){let G=q.toLowerCase();return E.filter((K)=>{let L=K.domain.toLowerCase();if(L===G)return!0;if(G.startsWith("."))return L===G||L.endsWith(G);return L===G||L===`.${G}`||L.endsWith(`.${G}`)})}function g(E){let q=new Date;return E.filter((G)=>{if(!G.expires)return!0;return G.expires>q})}function x(E){let q=["# Netscape HTTP Cookie File"];for(let G of E){let K=G.domain.startsWith(".")?"TRUE":"FALSE",L=G.secure?"TRUE":"FALSE",X=G.expires?Math.floor(G.expires.getTime()/1000):0;q.push([G.domain,K,G.path,L,X,G.name,G.value].join("\t"))}return q.join(`
+`)}function H(E){return JSON.stringify(E.map((q)=>({name:q.name,value:q.value,domain:q.domain,path:q.path,secure:q.secure,httpOnly:q.httpOnly,...q.expires&&{expirationDate:Math.floor(q.expires.getTime()/1000)},...q.sameSite&&{sameSite:q.sameSite.toLowerCase()}})),null,2)}function P(E){return E.map((q)=>`${q.name}=${q.value}`).join("; ")}

package/dist/detector.d.ts

@@ -0,0 +1,29 @@
+import type { CookieFormat } from './types';
+/**
+ * Auto-detect the format of cookie data
+ *
+ * Detection order:
+ * 1. Binary format: Buffer starting with 'cook' magic bytes
+ * 2. JSON format: String starting with '{' or '['
+ * 3. Netscape format: Tab-separated values with TRUE/FALSE flags
+ *
+ * @example
+ * ```typescript
+ * import { detectFormat } from '@mks2508/binary-cookies-parser';
+ *
+ * const format = detectFormat('.youtube.com\tTRUE\t/\tTRUE\t0\tSID\tabc');
+ * console.log(format); // 'netscape'
+ * ```
+ *
+ * @param content - String or Buffer containing cookie data
+ * @returns Detected format type
+ * @throws {Error} If format cannot be detected
+ */
+export declare function detectFormat(content: string | Buffer): CookieFormat;
+/**
+ * Try to detect the format without throwing
+ *
+ * @param content - String or Buffer containing cookie data
+ * @returns Detected format or null if detection fails
+ */
+export declare function tryDetectFormat(content: string | Buffer): CookieFormat | null;

package/dist/index.d.ts

@@ -1,68 +1,93 @@
-import type { BinaryCookie } from './types';
-export type { BinaryCookie, CookiePage } from './types';
+import { parseNetscape, isNetscapeFormat } from './parsers/netscape';
+import { parseJSON, isJSONFormat } from './parsers/json';
+import { BinaryCookiesParser, parseBinaryCookies, parseBinaryToUniversal, binaryToUniversal, isBinaryFormat } from './parsers/binary';
+import { detectFormat, tryDetectFormat } from './detector';
+import type { UniversalCookie, CookieFormat, ParseResult, BinaryCookie, CookiePage } from './types';
+export type { UniversalCookie, CookieFormat, ParseResult, BinaryCookie, CookiePage };
+export { parseNetscape, isNetscapeFormat, parseJSON, isJSONFormat, BinaryCookiesParser, parseBinaryCookies, parseBinaryToUniversal, binaryToUniversal, isBinaryFormat, detectFormat, tryDetectFormat };
 /**
- * Parser for macOS binary cookies files (.binarycookies)
+ * Parse cookies from any supported format with auto-detection
  *
- * These files are used by Safari and other macOS applications to store cookies
- * in a binary format that's more efficient than plain text.
+ * Supports:
+ * - Netscape/Mozilla cookies.txt format (used by yt-dlp, browsers)
+ * - JSON format (Chrome extensions, various exporters)
+ * - Binary Safari format (.binarycookies files)
  *
  * @example
  * ```typescript
- * import { BinaryCookiesParser } from 'binary-cookies-parser';
+ * import { parseCookies } from '@mks2508/binary-cookies-parser';
  *
- * const parser = new BinaryCookiesParser();
- * const cookies = await parser.parse('/path/to/Cookies.binarycookies');
- * console.log(cookies);
+ * // Auto-detect and parse
+ * const netscape = parseCookies('.youtube.com\tTRUE\t/\tTRUE\t0\tSID\tabc');
+ * const json = parseCookies('[{"name":"SID","value":"abc","domain":".youtube.com"}]');
+ * const binary = parseCookies(binaryBuffer);
  * ```
+ *
+ * @param content - Cookie data as string or Buffer
+ * @returns ParseResult with detected format and array of cookies
+ * @throws {Error} If format cannot be detected or parsing fails
+ */
+export declare function parseCookies(content: string | Buffer): ParseResult;
+/**
+ * Filter cookies by domain
+ *
+ * Matches cookies where:
+ * - Domain exactly equals the filter
+ * - Domain ends with the filter (for subdomain matching)
+ * - Filter starts with '.' and domain ends with filter (e.g., '.youtube.com')
+ *
+ * @example
+ * ```typescript
+ * import { parseCookies, filterByDomain } from '@mks2508/binary-cookies-parser';
+ *
+ * const { cookies } = parseCookies(cookieData);
+ * const ytCookies = filterByDomain(cookies, '.youtube.com');
+ * ```
+ *
+ * @param cookies - Array of cookies to filter
+ * @param domain - Domain to filter by (e.g., '.youtube.com', 'google.com')
+ * @returns Filtered array of cookies matching the domain
  */
-export declare class BinaryCookiesParser {
-    private cookiePath;
-    private currentBufferPosition;
-    private data;
-    private numPages;
-    private bufferSize;
-    private pages;
-    private pageSizes;
-    private cookies;
-    /**
-     * Parse a binary cookies file and return an array of cookies
-     *
-     * @param cookiePath - Absolute path to the .binarycookies file
-     * @returns Array of parsed cookies
-     * @throws {Error} If file doesn't exist or has invalid format
-     *
-     * @example
-     * ```typescript
-     * const parser = new BinaryCookiesParser();
-     * const cookies = await parser.parse('/Users/user/Library/Cookies/Cookies.binarycookies');
-     * ```
-     */
-    parse(cookiePath: string): Promise<BinaryCookie[]>;
-    private reset;
-    private openFile;
-    private readSlice;
-    private readIntBE;
-    private readIntLE;
-    private getNumPages;
-    private getPageSizes;
-    private getPages;
-    private getNumCookies;
-    private getCookieOffsets;
-    private getCookieData;
-    private parseCookieData;
-}
+export declare function filterByDomain(cookies: UniversalCookie[], domain: string): UniversalCookie[];
 /**
- * Convenience function to parse a binary cookies file
+ * Filter out expired cookies
  *
- * @param cookiePath - Absolute path to the .binarycookies file
- * @returns Array of parsed cookies
+ * @param cookies - Array of cookies to filter
+ * @returns Array of non-expired cookies (includes session cookies without expiry)
+ */
+export declare function filterExpired(cookies: UniversalCookie[]): UniversalCookie[];
+/**
+ * Convert cookies to Netscape format string
  *
  * @example
  * ```typescript
- * import { parseBinaryCookies } from 'binary-cookies-parser';
+ * import { parseCookies, toNetscapeFormat } from '@mks2508/binary-cookies-parser';
  *
- * const cookies = await parseBinaryCookies('/path/to/Cookies.binarycookies');
- * console.log(cookies);
+ * const { cookies } = parseCookies(jsonCookies);
+ * const netscapeString = toNetscapeFormat(cookies);
  * ```
+ *
+ * @param cookies - Array of cookies to convert
+ * @returns Netscape format string (cookies.txt compatible)
+ */
+export declare function toNetscapeFormat(cookies: UniversalCookie[]): string;
+/**
+ * Convert cookies to JSON format string
+ *
+ * @param cookies - Array of cookies to convert
+ * @returns JSON string representation of cookies
+ */
+export declare function toJSONFormat(cookies: UniversalCookie[]): string;
+/**
+ * Convert cookies to Cookie header string
+ *
+ * @example
+ * ```typescript
+ * const header = toCookieHeader(cookies);
+ * fetch(url, { headers: { Cookie: header } });
+ * ```
+ *
+ * @param cookies - Array of cookies to convert
+ * @returns String suitable for Cookie HTTP header (name=value; name2=value2)
  */
-export declare function parseBinaryCookies(cookiePath: string): Promise<BinaryCookie[]>;
+export declare function toCookieHeader(cookies: UniversalCookie[]): string;

package/dist/index.js

@@ -1 +1,2 @@
-import z from"node:fs/promises";import{existsSync as A}from"node:fs";class W{cookiePath=null;currentBufferPosition=0;data=null;numPages=0;bufferSize=0;pages=[];pageSizes=[];cookies=[];async parse(E){if(this.reset(),this.cookiePath=E,!A(E))throw Error(`Cookie file not found: ${E}`);await this.openFile(),this.getNumPages(),this.getPageSizes(),this.getPages();for(let q=0;q<this.pages.length;q++){this.getNumCookies(q),this.getCookieOffsets(q),this.getCookieData(q);for(let F=0;F<this.pages[q].cookies.length;F++){let L=this.parseCookieData(q,F);this.cookies.push(L)}}return this.cookies}reset(){this.cookiePath=null,this.currentBufferPosition=0,this.data=null,this.numPages=0,this.bufferSize=0,this.pages=[],this.pageSizes=[],this.cookies=[]}async openFile(){if(!this.cookiePath)throw Error("Cookie path not set");let E=await z.readFile(this.cookiePath);if(this.data=E,this.bufferSize=E.length,this.readSlice(4).toString()!=="cook")throw Error('Invalid binary cookies file format (missing "cook" header)')}readSlice(E){if(!this.data)throw Error("No data loaded");let q=this.data.subarray(this.currentBufferPosition,this.currentBufferPosition+E);return this.currentBufferPosition+=E,q}readIntBE(){if(!this.data)throw Error("No data loaded");let E=this.data.readInt32BE(this.currentBufferPosition);return this.currentBufferPosition+=4,E}readIntLE(){if(!this.data)throw Error("No data loaded");let E=this.data.readInt32LE(this.currentBufferPosition);return this.currentBufferPosition+=4,E}getNumPages(){return this.numPages=this.readIntBE(),this.numPages}getPageSizes(){for(let E=0;E<this.numPages;E++)this.pageSizes.push(this.readIntBE());return this.pageSizes}getPages(){for(let E of this.pageSizes)this.pages.push({buffer:this.readSlice(E),bufferPosition:0,numCookies:0,cookieOffsets:[],cookies:[]});return this.pages}getNumCookies(E){let q=this.pages[E];q.bufferPosition=0;let F=q.buffer.readInt32BE(q.bufferPosition);if(q.bufferPosition+=4,F!==256)throw Error(`Invalid page header: expected 256, got ${F}`);return q.numCookies=q.buffer.readInt32LE(q.bufferPosition),q.bufferPosition+=4,q.numCookies}getCookieOffsets(E){let q=this.pages[E];q.cookieOffsets=[];for(let F=0;F<q.numCookies;F++)q.cookieOffsets.push(q.buffer.readInt32LE(q.bufferPosition)),q.bufferPosition+=4;return q.cookieOffsets}getCookieData(E){let q=this.pages[E];q.cookies=[];for(let F of q.cookieOffsets){let L=q.buffer.readInt32LE(F);try{q.cookies.push({buffer:q.buffer.subarray(F,F+L)})}catch{q.cookies.push({buffer:q.buffer.subarray(F)})}}return q.cookies}parseCookieData(E,q){let J=this.pages[E].cookies[q].buffer,H=978307200,G=0,T=J.readInt32LE(G);G+=4;let X=J.readInt32LE(G);G+=8;let j=J.readUInt32LE(G),R={},Y=["url","name","path","value"];for(let M of Y)G+=4,R[M]=J.readInt32LE(G);G+=4;let v=J.readUInt32LE(G);G+=8;let Z=J.readDoubleLE(G)+978307200,_=new Date(Z*1000);G+=8;let $=J.readDoubleLE(G)+978307200,w=new Date($*1000),U={flags:X,expiration:_,creation:w};for(let[M,K]of Object.entries(R)){let V="",N=K,Q="";do Q=J.toString("utf8",N,N+1),V+=Q,N++;while(Q!=="\x00");U[M]=V.replace(/\u0000/g,"").trim()}return U}}async function S(E){return new W().parse(E)}export{S as parseBinaryCookies,W as BinaryCookiesParser};
+import{parseNetscape as M,isNetscapeFormat as X}from"./parsers/netscape";import{parseJSON as Q,isJSONFormat as Z}from"./parsers/json";import{BinaryCookiesParser as $,parseBinaryCookies as j,parseBinaryToUniversal as R,binaryToUniversal as w,isBinaryFormat as A}from"./parsers/binary";import{detectFormat as V,tryDetectFormat as x}from"./detector";function H(G){let q=V(G);switch(q){case"netscape":return{format:q,cookies:M(G)};case"json":return{format:q,cookies:Q(Buffer.isBuffer(G)?G.toString("utf8"):G)};case"binary":return{format:q,cookies:R(Buffer.isBuffer(G)?G:Buffer.from(G))}}}function P(G,q){let E=q.toLowerCase();return G.filter((K)=>{let I=K.domain.toLowerCase();if(I===E)return!0;if(E.startsWith("."))return I===E||I.endsWith(E);return I===E||I===`.${E}`||I.endsWith(`.${E}`)})}function J(G){let q=new Date;return G.filter((E)=>{if(!E.expires)return!0;return E.expires>q})}function O(G){let q=["# Netscape HTTP Cookie File"];for(let E of G){let K=E.domain.startsWith(".")?"TRUE":"FALSE",I=E.secure?"TRUE":"FALSE",L=E.expires?Math.floor(E.expires.getTime()/1000):0;q.push([E.domain,K,E.path,I,L,E.name,E.value].join("\t"))}return q.join(`
+`)}function U(G){return JSON.stringify(G.map((q)=>({name:q.name,value:q.value,domain:q.domain,path:q.path,secure:q.secure,httpOnly:q.httpOnly,...q.expires&&{expirationDate:Math.floor(q.expires.getTime()/1000)},...q.sameSite&&{sameSite:q.sameSite.toLowerCase()}})),null,2)}function b(G){return G.map((q)=>`${q.name}=${q.value}`).join("; ")}export{x as tryDetectFormat,O as toNetscapeFormat,U as toJSONFormat,b as toCookieHeader,M as parseNetscape,Q as parseJSON,H as parseCookies,R as parseBinaryToUniversal,j as parseBinaryCookies,X as isNetscapeFormat,Z as isJSONFormat,A as isBinaryFormat,J as filterExpired,P as filterByDomain,V as detectFormat,w as binaryToUniversal,$ as BinaryCookiesParser};

package/dist/parsers/binary.d.ts

@@ -0,0 +1,96 @@
+import type { BinaryCookie, UniversalCookie } from '../types';
+/**
+ * Parser for macOS binary cookies files (.binarycookies)
+ *
+ * These files are used by Safari and other macOS applications to store cookies
+ * in a binary format that's more efficient than plain text.
+ *
+ * @example
+ * ```typescript
+ * import { BinaryCookiesParser } from '@mks2508/binary-cookies-parser';
+ *
+ * const parser = new BinaryCookiesParser();
+ * const cookies = await parser.parse('/path/to/Cookies.binarycookies');
+ * console.log(cookies);
+ * ```
+ */
+export declare class BinaryCookiesParser {
+    private cookiePath;
+    private currentBufferPosition;
+    private data;
+    private numPages;
+    private bufferSize;
+    private pages;
+    private pageSizes;
+    private cookies;
+    /**
+     * Parse a binary cookies file and return an array of cookies
+     *
+     * @param cookiePath - Absolute path to the .binarycookies file
+     * @returns Array of parsed cookies
+     * @throws {Error} If file doesn't exist or has invalid format
+     *
+     * @example
+     * ```typescript
+     * const parser = new BinaryCookiesParser();
+     * const cookies = await parser.parse('/Users/user/Library/Cookies/Cookies.binarycookies');
+     * ```
+     */
+    parse(cookiePath: string): Promise<BinaryCookie[]>;
+    /**
+     * Parse a binary cookies buffer directly
+     *
+     * @param buffer - Buffer containing .binarycookies data
+     * @returns Array of parsed cookies
+     * @throws {Error} If buffer has invalid format
+     */
+    parseBuffer(buffer: Buffer): BinaryCookie[];
+    private reset;
+    private openFile;
+    private readSlice;
+    private readIntBE;
+    private readIntLE;
+    private getNumPages;
+    private getPageSizes;
+    private getPages;
+    private getNumCookies;
+    private getCookieOffsets;
+    private getCookieData;
+    private parseCookieData;
+}
+/**
+ * Convert BinaryCookie to UniversalCookie format
+ *
+ * @param cookie - Binary cookie to convert
+ * @returns Universal cookie format
+ */
+export declare function binaryToUniversal(cookie: BinaryCookie): UniversalCookie;
+/**
+ * Parse binary cookies and return UniversalCookie array
+ *
+ * @param buffer - Buffer containing .binarycookies data
+ * @returns Array of universal cookies
+ */
+export declare function parseBinaryToUniversal(buffer: Buffer): UniversalCookie[];
+/**
+ * Check if buffer appears to be binary cookies format
+ *
+ * @param buffer - Buffer to check
+ * @returns true if buffer starts with 'cook' magic bytes
+ */
+export declare function isBinaryFormat(buffer: Buffer): boolean;
+/**
+ * Convenience function to parse a binary cookies file
+ *
+ * @param cookiePath - Absolute path to the .binarycookies file
+ * @returns Array of parsed cookies
+ *
+ * @example
+ * ```typescript
+ * import { parseBinaryCookies } from '@mks2508/binary-cookies-parser';
+ *
+ * const cookies = await parseBinaryCookies('/path/to/Cookies.binarycookies');
+ * console.log(cookies);
+ * ```
+ */
+export declare function parseBinaryCookies(cookiePath: string): Promise<BinaryCookie[]>;

package/dist/parsers/json.d.ts

@@ -0,0 +1,32 @@
+import type { UniversalCookie } from '../types';
+/**
+ * Parse cookies from JSON format
+ *
+ * Supports multiple JSON structures:
+ * - Direct array of cookies: [{ name, value, domain, ... }]
+ * - Object with cookies property: { cookies: [...] }
+ * - Chrome extension export format
+ * - Firefox export format
+ *
+ * @example
+ * ```typescript
+ * import { parseJSON } from '@mks2508/binary-cookies-parser';
+ *
+ * const content = JSON.stringify([
+ *   { name: 'SID', value: 'abc', domain: '.youtube.com', path: '/', secure: true }
+ * ]);
+ * const cookies = parseJSON(content);
+ * ```
+ *
+ * @param content - JSON string containing cookies
+ * @returns Array of parsed cookies
+ * @throws {SyntaxError} If content is not valid JSON
+ */
+export declare function parseJSON(content: string): UniversalCookie[];
+/**
+ * Check if content appears to be JSON format
+ *
+ * @param content - String content to check
+ * @returns true if content starts with { or [
+ */
+export declare function isJSONFormat(content: string): boolean;

package/dist/parsers/netscape.d.ts

@@ -0,0 +1,36 @@
+import type { UniversalCookie } from '../types';
+/**
+ * Parse cookies from Netscape/Mozilla cookies.txt format
+ *
+ * Format specification:
+ * domain\tflag\tpath\tsecure\texpiration\tname\tvalue
+ *
+ * - domain: The domain that created and can read the cookie
+ * - flag: TRUE if subdomains can access, FALSE otherwise (column 2)
+ * - path: The path within the domain for which the cookie is valid
+ * - secure: TRUE if HTTPS only, FALSE otherwise
+ * - expiration: Unix timestamp (seconds since epoch), 0 for session cookies
+ * - name: The cookie name
+ * - value: The cookie value
+ *
+ * Lines starting with # are comments
+ *
+ * @example
+ * ```typescript
+ * import { parseNetscape } from '@mks2508/binary-cookies-parser';
+ *
+ * const content = `.youtube.com\tTRUE\t/\tTRUE\t1735689600\tSID\tabcdef123`;
+ * const cookies = parseNetscape(content);
+ * ```
+ *
+ * @param content - Content of the cookies.txt file
+ * @returns Array of parsed cookies
+ */
+export declare function parseNetscape(content: string): UniversalCookie[];
+/**
+ * Check if content appears to be in Netscape format
+ *
+ * @param content - String content to check
+ * @returns true if content looks like Netscape format
+ */
+export declare function isNetscapeFormat(content: string): boolean;

package/dist/types.d.ts

@@ -1,3 +1,40 @@
+/**
+ * Universal cookie interface that works across all cookie formats
+ * (Netscape, JSON, Binary Safari)
+ */
+export interface UniversalCookie {
+    /** Cookie name */
+    name: string;
+    /** Cookie value */
+    value: string;
+    /** Domain the cookie belongs to (e.g., ".youtube.com") */
+    domain: string;
+    /** Cookie path (e.g., "/") */
+    path: string;
+    /** Whether the cookie is secure (HTTPS only) */
+    secure: boolean;
+    /** Whether the cookie is HTTP-only (not accessible via JavaScript) */
+    httpOnly: boolean;
+    /** Cookie expiration date */
+    expires?: Date;
+    /** Cookie creation date */
+    creation?: Date;
+    /** SameSite attribute for cross-site requests */
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
+/**
+ * Supported cookie file formats
+ */
+export type CookieFormat = 'netscape' | 'json' | 'binary';
+/**
+ * Result from parsing a cookie file
+ */
+export interface ParseResult {
+    /** Detected format of the input */
+    format: CookieFormat;
+    /** Array of parsed cookies */
+    cookies: UniversalCookie[];
+}
 /**
  * Represents a parsed binary cookie from macOS .binarycookies file
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mks2508/binary-cookies-parser",
-  "version": "1.0.0",
-  "description": "Modern TypeScript parser for macOS binary cookies files (.binarycookies). Parse Safari and app cookies with zero dependencies.",
+  "version": "2.0.0",
+  "description": "Universal cookie parser supporting Netscape (cookies.txt), JSON, and macOS binary (.binarycookies) formats with auto-detection.",
   "author": "MKS2508",
   "license": "MIT",
   "type": "module",
@@ -22,17 +22,22 @@
   ],
   "keywords": [
     "cookies",
+    "cookie-parser",
+    "netscape",
+    "cookies-txt",
     "binarycookies",
     "safari",
     "macos",
+    "json-cookies",
     "parser",
     "typescript",
     "playwright",
     "puppeteer",
     "automation",
     "binary",
-    "cookie-parser",
-    "apple"
+    "apple",
+    "youtube",
+    "yt-dlp"
   ],
   "repository": {
     "type": "git",