@mherod/get-cookie 4.2.0 → 4.3.0

package/.claude/settings.local.json

@@ -0,0 +1,11 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh pr list:*)",
+      "Bash(gh repo view:*)",
+      "Bash(gh pr checkout:*)",
+      "Bash(gh pr view:*)"
+    ],
+    "deny": []
+  }
+}

package/.husky/commit-msg

@@ -1,3 +1,17 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+# Load nvm and use the project's Node.js version
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+
+# Use the version specified in .nvmrc or fallback to default nvm version
+if [ -f .nvmrc ]; then
+  nvm use
+else
+  nvm use default
+fi
+
 # Try pnpm first, fallback to npx if pnpm not found
 if command -v pnpm >/dev/null 2>&1; then
   pnpm exec commitlint --edit ${1}

package/.husky/pre-commit

@@ -1,3 +1,17 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+# Load nvm and use the project's Node.js version
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+
+# Use the version specified in .nvmrc or fallback to default nvm version
+if [ -f .nvmrc ]; then
+  nvm use
+else
+  nvm use default
+fi
+
 # Try pnpm first, fallback to npx if pnpm not found
 if command -v pnpm >/dev/null 2>&1; then
   pnpm lint-staged

package/.idea/git_toolbox_prj.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="GitToolBoxProjectSettings">
+    <option name="commitMessageIssueKeyValidationOverride">
+      <BoolValueOverride>
+        <option name="enabled" value="true" />
+      </BoolValueOverride>
+    </option>
+    <option name="commitMessageValidationEnabledOverride">
+      <BoolValueOverride>
+        <option name="enabled" value="true" />
+      </BoolValueOverride>
+    </option>
+  </component>
+</project>

package/.nvmrc

@@ -0,0 +1 @@
+22.0.0

package/README.md

@@ -1,178 +1,119 @@
 # get-cookie 🍪
 
-## What is it? 🤔
+Extract browser cookies programmatically. A command-line tool and library that handles Chrome's encryption, Safari's binary formats, and Firefox's data - all through one command. Perfect for testing, automation, and debugging.
 
-get-cookie is a powerful command-line utility and Node.js module that allows you to securely retrieve browser cookies from your locally installed browsers. Perfect for:
+## Quick Start 🚀
 
-- 🔐 Testing authenticated web applications
-- 🔍 Debugging cookie-related issues
-- 🤖 Automating browser cookie extraction
-- 🧪 Integration testing with real browser cookies
+```bash
+pnpm add -g @mherod/get-cookie
+get-cookie auth example.com     # Get specific cookie
+get-cookie % example.com        # Get all cookies
+```
 
-## Documentation 📚
+```typescript
+import { getCookie } from "@mherod/get-cookie";
+
+const cookies = await getCookie({
+  name: "auth",
+  domain: "example.com",
+});
+```
 
-Visit our [comprehensive documentation](https://mherod.github.io/get-cookie/) for:
+## Perfect For 🎯
 
-- Detailed API reference
-- Getting started guides
-- Advanced usage examples
-- TypeScript type definitions
+- 🔑 **API Testing**: Grab auth cookies directly from your browser for API calls
+- 🐞 **Debugging**: Inspect cookies across browsers to track down session issues
+- 🤖 **Test Automation**: Use real browser cookies in your integration tests
+- 🔄 **CI/CD**: Automate cookie extraction in your testing pipelines
+- 🧪 **Local Development**: Test your apps with production-like authentication
 
-## Features ✨
+## Why get-cookie? ✨
 
-- 🌐 **Multi-Browser Support**: Works with Chrome, Firefox, and Safari
-- 🔒 **Secure**: Safe cookie extraction with proper encryption handling
-- 📝 **TypeScript Ready**: Built with TypeScript for excellent type safety
-- 🎯 **Flexible Querying**: Search by name, domain, or URL pattern
-- 🔄 **Multiple Output Formats**: JSON, rendered, or grouped results
-- 👥 **Profile Support**: Query cookies from different browser profiles
+- 🔐 **Battle-tested Security**: Handles complex browser encryption with ease
+- 🎯 **Universal Browser Support**: Chrome (all platforms), Firefox, Safari - we've got you covered
+- 🚀 **Developer Experience**: Rich CLI options and type-safe Node.js API
+- ⚡ **Lightning Fast**: Optimised binary parsing and decryption
+- 🛠️ **Production Ready**: Used in critical testing pipelines worldwide
 
 ## Installation 📦
 
-Install from npm registry using your preferred package manager:
-
 ```bash
-# Using pnpm (recommended)
-pnpm add @mherod/get-cookie
-
-# Using npm
-npm install @mherod/get-cookie
-
-# Using yarn
-yarn add @mherod/get-cookie
+pnpm add @mherod/get-cookie    # recommended
+npm install @mherod/get-cookie # or npm
+yarn add @mherod/get-cookie    # or yarn
 ```
 
-For global installation:
+### Node.js Version Requirements 🔧
 
-```bash
-# Using pnpm (recommended)
-pnpm add -g @mherod/get-cookie
+This project requires Node.js v20.0.0 or v22.0.0. We recommend using [nvm](https://github.com/nvm-sh/nvm) to manage your Node.js versions.
 
-# Using npm
-npm install -g @mherod/get-cookie
+```bash
+# Install the correct Node.js version using nvm
+nvm install 22.0.0
+nvm use 22.0.0
 
-# Using yarn
-yarn global add @mherod/get-cookie
+# Or simply run this in the project directory (we've included an .nvmrc file)
+nvm use
 ```
 
-**Note: Currently only macOS is supported. Windows support is planned for a future release.** 🚧
-
-## How do I use it? 🚀
+The project includes an `.nvmrc` file that specifies the required Node.js version, so `nvm use` will automatically switch to the correct version when you're in the project directory.
 
-### CLI Usage 💻
+## Usage Examples 💡
 
-Basic cookie retrieval:
+### Command Line
 
 ```bash
-# Get a specific cookie
-get-cookie auth example.com
-
-# Get all cookies for a domain
-get-cookie % example.com
-
-# Get cookies with output formatting
-get-cookie auth example.com --render
-get-cookie auth example.com --dump-grouped
-
-# Get cookies from a specific URL
-get-cookie --url https://example.com/path
+get-cookie auth example.com            # Basic extraction
+get-cookie auth example.com --render   # Pretty print
+get-cookie --url https://example.com   # URL-based extraction
 ```
 
-### Node.js Module Usage 📚
-
-Basic usage:
+### Node.js API
 
 ```typescript
 import { getCookie } from "@mherod/get-cookie";
 
-// Get a specific cookie
-const authCookies = await getCookie({
+// Specific cookie
+const authCookie = await getCookie({
   name: "auth",
   domain: "example.com",
 });
 
-// Get all cookies for a domain
-const allCookies = await getCookie({
+// All cookies
+const cookies = await getCookie({
   name: "%",
   domain: "example.com",
 });
-
-// Get cookies from multiple specifications
-import { comboQueryCookieSpec } from "@mherod/get-cookie";
-
-const cookies = await comboQueryCookieSpec(
-  [
-    { name: "session", domain: "api.example.com" },
-    { name: "auth", domain: "auth.example.com" },
-  ],
-  {
-    removeExpired: true,
-    limit: 10,
-  },
-);
-```
-
-### Advanced Usage 🔧
-
-Using browser-specific strategies:
-
-```typescript
-import {
-  ChromeCookieQueryStrategy,
-  FirefoxCookieQueryStrategy,
-} from "@mherod/get-cookie";
-
-// Query Chrome cookies
-const chromeStrategy = new ChromeCookieQueryStrategy();
-const chromeCookies = await chromeStrategy.queryCookies(
-  "sessionId",
-  "example.com",
-);
-
-// Query Firefox cookies
-const firefoxStrategy = new FirefoxCookieQueryStrategy();
-const firefoxCookies = await firefoxStrategy.queryCookies(
-  "auth",
-  "example.com",
-);
 ```
 
-Using URL-based cookie extraction:
+## Core Features 🎯
 
-```typescript
-import { cookieSpecsFromUrl } from "@mherod/get-cookie";
+- 🌐 **Cross-Platform**: Chrome (macOS/Linux/Windows), Firefox (macOS/Linux), Safari (macOS)
+- 🔒 **Enterprise Security**: Browser-native encryption handling
+- 📝 **TypeScript First**: Complete type safety and IntelliSense
+- 🎨 **Flexible Output**: JSON, rendered, or grouped results
+- 👥 **Multi-Profile**: Full support for browser profiles
 
-// Get all cookies needed for a specific URL
-const specs = cookieSpecsFromUrl("https://example.com/dashboard");
-const cookies = await comboQueryCookieSpec(specs);
-```
+## Documentation 📚
 
-## Output Formats 📊
+Explore our comprehensive docs at [mherod.github.io/get-cookie](https://mherod.github.io/get-cookie/)
 
-The CLI supports various output formats:
+## CI/CD Pipeline 🔄
 
-```bash
-# Default output (just values)
-get-cookie auth example.com
+Our GitHub Actions workflows ensure quality and reliability:
 
-# JSON output
-get-cookie auth example.com --output json
+- **🚀 CI Pipeline**: Automated testing across Node.js 20.x & 22.x on macOS
+- **📖 Documentation**: Auto-generated docs with TypeScript APIs
+- **🧪 Comprehensive Testing**: Swift CookieCreator, binary cookies, and validation scripts
+- **📦 Automated Releases**: NPM publishing with GitHub release creation
+- **✅ Quality Gates**: TypeScript checking, ESLint, Prettier, and link validation
 
-# Rendered output (human-readable)
-get-cookie auth example.com --render
-
-# Grouped by browser/profile
-get-cookie auth example.com --dump-grouped
-```
+Workflows run across macOS, Linux, and Windows to ensure cross-platform compatibility and proper cookie encryption testing.
 
 ## Contributing 🤝
 
-Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
+We welcome contributions! Open an issue or submit a PR to get started.
 
 ## License 📄
 
-This project is licensed under the MIT License - see the LICENSE file for details.
-
-## Security 🛡️
-
-This tool handles sensitive data (cookies). Always be careful when extracting and storing cookie information. Never share your cookies or use this tool on untrusted machines.
+MIT Licensed. Build something amazing.

package/biome.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true,
+    "defaultBranch": "main"
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "ignore": [
+      "dist/**",
+      "node_modules/**",
+      "coverage/**",
+      "docs/.vitepress/cache/**",
+      "**/*.log",
+      ".parcel-cache/**"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "useEditorconfig": true,
+    "formatWithErrors": false,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineEnding": "lf",
+    "lineWidth": 80,
+    "attributePosition": "auto",
+    "bracketSpacing": true
+  },
+  "organizeImports": { "enabled": true },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "correctness": {
+        "noUnusedImports": "error",
+        "noUnusedVariables": "error",
+        "useArrayLiterals": "off"
+      },
+      "style": {
+        "useImportType": "error",
+        "noNamespace": "error",
+        "noNonNullAssertion": "error",
+        "noVar": "error",
+        "useAsConstAssertion": "error",
+        "useBlockStatements": "error",
+        "useConst": "error",
+        "useLiteralEnumMembers": "error"
+      },
+      "complexity": {
+        "noStaticOnlyClass": "error",
+        "noUselessCatch": "error",
+        "noUselessConstructor": "error",
+        "noUselessTypeConstraint": "error",
+        "useOptionalChain": "error"
+      },
+      "suspicious": {
+        "noConfusingVoidType": "error",
+        "noDoubleEquals": "error",
+        "noExplicitAny": "error",
+        "noExtraNonNullAssertion": "error",
+        "noMisleadingInstantiator": "error",
+        "noPrototypeBuiltins": "error",
+        "noUnsafeDeclarationMerging": "error",
+        "useAwait": "error",
+        "useNamespaceKeyword": "error"
+      },
+      "nursery": {
+        "useSortedClasses": "off"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "asNeeded",
+      "trailingCommas": "all",
+      "semicolons": "always",
+      "arrowParentheses": "always",
+      "bracketSameLine": false,
+      "quoteStyle": "double",
+      "attributePosition": "auto",
+      "bracketSpacing": true
+    },
+    "globals": ["exports"]
+  },
+  "overrides": [
+    {
+      "include": [".prettierrc", ".parcelrc"],
+      "formatter": { "indentWidth": 2 }
+    }
+  ]
+}