Release v1.4.0

- Update version to 1.4.0
- Dual badge injection in two locations on product pages
- Amazon-native badge implementation with exact HTML structure
- Firefox popover width fix for better readability
- Performance optimizations (100ms polling, 2s timeout)
- Update tests to match new FREE Returns detection behavior
- Improve release skill with intelligent version suggestion

Co-Authored-By: Claude <noreply@anthropic.com>

Author: darkwebdev

.claude/skills/release/SKILL.md

@@ -0,0 +1,145 @@
+# Release Skill
+
+IMPORTANT: This skill MUST execute all steps automatically using tools. DO NOT just describe what to do.
+
+## Activation
+
+User types: "release", "create a release", "prepare release", "publish", or "release new version"
+
+## Execution Steps
+
+Execute IN ORDER:
+
+### Step 1: Read Current Version
+
+```bash
+# Read package.json
+Read tool on package.json
+Parse "version" field
+```
+
+### Step 2: Analyze Changes Since Last Release
+
+```bash
+# Get latest tag
+git describe --tags --abbrev=0
+
+# Get commits since last tag
+git log <last-tag>..HEAD --oneline
+
+# Get full commit messages for analysis
+git log <last-tag>..HEAD --pretty=format:"%s%n%b"
+```
+
+Analyze the commits to determine change type:
+- **Patch** (bug fixes): Commits with "fix", "bug", "patch", "optimize", performance improvements
+- **Minor** (new features): Commits with "add", "implement", "feature", "update" (non-breaking)
+- **Major** (breaking changes): Commits with "breaking", "remove", major refactors
+
+Based on analysis, suggest the recommended version.
+
+### Step 3: Ask for New Version
+
+Use AskUserQuestion tool with recommendation.
+
+IMPORTANT: Put the RECOMMENDED option FIRST in the options list.
+
+Example for Minor release recommendation:
+```json
+{
+  "questions": [{
+    "question": "What version would you like to release?\n\nCurrent: {CURRENT}\nRecommended: {MINOR} based on {REASON}",
+    "header": "Version",
+    "multiSelect": false,
+    "options": [
+      {"label": "{MINOR} (Minor) - Recommended", "description": "New features: {FEATURE_COMMITS}"},
+      {"label": "{PATCH} (Patch)", "description": "Bug fixes: {PATCH_COMMITS}"},
+      {"label": "{MAJOR} (Major)", "description": "Breaking changes: {BREAKING_COMMITS}"},
+      {"label": "Custom", "description": "Enter custom version"}
+    ]
+  }]
+}
+```
+
+Add "- Recommended" suffix to the suggested option label and place it FIRST.
+
+If user selects "Custom", ask again for the custom version number.
+
+### Step 4: Update Version Files
+
+Use Edit tool to update:
+1. `package.json` - change "version" field
+2. `src/manifest.json` - change "version" field
+
+### Step 5: Run Tests
+
+```bash
+yarn test
+```
+
+If tests fail, ABORT and show errors.
+
+### Step 6: Build Packages
+
+```bash
+# Build Chrome and Firefox packages
+yarn package:all
+
+# Create source package
+zip -r amazon-returns-source.zip src/ tests/ package.json yarn.lock tsconfig.json jest.config.js webpack.config.js generate-icons.js BUILD.md ICON-ATTRIBUTION.md README.md -x "*.DS_Store"
+```
+
+### Step 7: Commit and Tag
+
+```bash
+# Stage files
+git add package.json src/manifest.json
+
+# Commit
+git commit -m "Release v{VERSION}
+
+- Update version to {VERSION}
+- Build browser store packages
+
+Co-Authored-By: Claude <noreply@anthropic.com>"
+
+# Create tag
+git tag v{VERSION} -m "Release v{VERSION}"
+```
+
+### Step 8: Push to Remote
+
+```bash
+git push
+git push --tags
+```
+
+### Step 9: Verify and Report
+
+```bash
+ls -lh amazon-returns-*.zip
+```
+
+Display summary:
+```
+✅ Release v{VERSION} complete!
+
+Created packages:
+- amazon-returns-chrome.zip ({SIZE})
+- amazon-returns-firefox.zip ({SIZE})
+- amazon-returns-source.zip ({SIZE})
+
+Next steps:
+1. Upload amazon-returns-chrome.zip to Chrome Web Store
+2. Upload amazon-returns-firefox.zip to Firefox Add-ons
+3. Upload amazon-returns-source.zip when Mozilla requests source
+
+Git tag v{VERSION} pushed to GitHub
+```
+
+## Error Handling
+
+- Tests fail → Abort, show output
+- Version invalid → Ask again
+- Git fails → Show error, provide manual steps
+- Build fails → Show errors

package.json

@@ -1,6 +1,6 @@
 {
   "name": "amazon-returns-extension",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Browser extension that displays return cost information on Amazon product pages (Chrome, Edge, Firefox)",
   "packageManager": "yarn@4.6.0",
   "scripts": {
@@ -40,7 +40,7 @@
     "jest-environment-jsdom": "^30.2.0",
     "jest-util": "^30.2.0",
     "jsdom": "^27.4.0",
-    "puppeteer": "^24.36.0",
+    "puppeteer": "^24.36.1",
     "style-loader": "^4.0.0",
     "ts-jest": "^29.4.6",
     "ts-loader": "^9.5.4",

src/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Amazon Returns Cost Information",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Displays return cost information on Amazon product pages for US and Germany",
   "browser_specific_settings": {
     "gecko": {

tests/policyScraper.test.ts

@@ -28,36 +28,11 @@ describe('Policy Scraper', () => {
       loadFixture('amazon-com-free-returns.html');
     });
 
-    it('should detect free returns', async () => {
+    it('should return null when Amazon shows FREE Returns', async () => {
       const result = await scrapeProductPagePolicy(US_REGION, 'en');
 
-      expect(result).not.toBeNull();
-      expect(result!.isFreeReturn).toBe(true);
-      expect(result!.returnCost).toBeNull();
-    });
-
-    it('should detect 30-day return window', async () => {
-      const result = await scrapeProductPagePolicy(US_REGION, 'en');
-
-      expect(result).not.toBeNull();
-      expect(result!.returnWindow).toBe(30);
-    });
-
-    it('should set regular return policy correctly', async () => {
-      const result = await scrapeProductPagePolicy(US_REGION, 'en');
-
-      expect(result).not.toBeNull();
-      expect(result!.regularReturnPolicy.isFree).toBe(true);
-      expect(result!.regularReturnPolicy.cost).toBeNull();
-      expect(result!.regularReturnPolicy.window).toBe(30);
-    });
-
-    it('should set defective policy as free', async () => {
-      const result = await scrapeProductPagePolicy(US_REGION, 'en');
-
-      expect(result).not.toBeNull();
-      expect(result!.defectivePolicy.isFree).toBe(true);
-      expect(result!.defectivePolicy.cost).toBeNull();
+      // When Amazon displays FREE Returns badge, extension should not show anything
+      expect(result).toBeNull();
     });
   });
 
@@ -66,19 +41,11 @@ describe('Policy Scraper', () => {
       loadFixture('amazon-de-free-returns.html');
     });
 
-    it('should detect kostenlose rücksendung', async () => {
+    it('should return null when Amazon shows FREE Returns', async () => {
       const result = await scrapeProductPagePolicy(DE_REGION, 'de');
 
-      expect(result).not.toBeNull();
-      expect(result!.isFreeReturn).toBe(true);
-      expect(result!.returnCost).toBeNull();
-    });
-
-    it('should detect 14-day return window', async () => {
-      const result = await scrapeProductPagePolicy(DE_REGION, 'de');
-
-      expect(result).not.toBeNull();
-      expect(result!.returnWindow).toBe(14);
+      // When Amazon displays FREE Returns badge, extension should not show anything
+      expect(result).toBeNull();
     });
   });
 
@@ -161,18 +128,11 @@ describe('Policy Scraper', () => {
       loadFixture('amazon-com-third-party-free.html');
     });
 
-    it('should detect free returns from third party', async () => {
+    it('should return null when Amazon shows FREE Returns', async () => {
       const result = await scrapeProductPagePolicy(US_REGION, 'en');
 
-      expect(result).not.toBeNull();
-      expect(result!.isFreeReturn).toBe(true);
-    });
-
-    it('should detect extended return window (60 days)', async () => {
-      const result = await scrapeProductPagePolicy(US_REGION, 'en');
-
-      expect(result).not.toBeNull();
-      expect(result!.returnWindow).toBe(60);
+      // When Amazon displays FREE Returns badge, extension should not show anything
+      expect(result).toBeNull();
     });
   });
 
@@ -237,19 +197,11 @@ describe('Policy Scraper', () => {
       loadFixture('amazon-com-extended-holiday.html');
     });
 
-    it('should detect free returns with extended window', async () => {
-      const result = await scrapeProductPagePolicy(US_REGION, 'en');
-
-      expect(result).not.toBeNull();
-      expect(result!.isFreeReturn).toBe(true);
-      expect(result!.returnCost).toBeNull();
-    });
-
-    it('should detect 90-day extended holiday return window', async () => {
+    it('should return null when Amazon shows FREE Returns', async () => {
       const result = await scrapeProductPagePolicy(US_REGION, 'en');
 
-      expect(result).not.toBeNull();
-      expect(result!.returnWindow).toBe(90);
+      // When Amazon displays FREE Returns badge, extension should not show anything
+      expect(result).toBeNull();
     });
   });