# Coupon Shield 🛡️
Tool for eComm merchants to detect, warn and prevent a customer from shopping using a shady coupon browser extension
* Detects Honey, Capital One Shopping & Rakuten 🕵🏼♀️
* Tiny! 3kb minified & gzipped 🐁
* Does not collect any user data 🥦
* [Demo video here 🎥](https://youtu.be/Em9Fjil8Xds)
* [Inspired by MegaLag's YouTube 🎥](https://www.youtube.com/watch?v=wwB3FmbcC88)
## Easy install (no-JS)
This will automatically detect a coupon extension and show a default warning to the user to disable the extension as shown above). Install this at the very top of the `` in your webpage to ensure it runs prior to the extension.
[jsDelivr package page](https://www.jsdelivr.com/package/npm/coupon-shield).
```html
```
## Custom Usage (Browser Global)
```html
```
## Custom Usage (ESM)
```sh
npm install coupon-shield
```
```js
import { listen } from "coupon-shield";
listen((warn, vendor) => {
// Decide how you want to handle this. Native warn function allows you to tell the user to disable the extension.
// vendor is "honey", "Capital One Shopping", "Rakuten", or "Klarna"
warn("You must disable the Honey extension to continue.");
});
```
## Advanced Options
```js
window.couponShield.listen((warn, vendor, el) => {
// removePageElement defaults to true (extension element loaded onto the page is auto-removed).
// Set removePageElement to false if you want to keep the extension element for some reason.
// el is only defined when removePageElement is false.
// vendor is "honey", "Capital One Shopping", "Rakuten", or "Klarna"
}, { removePageElement: false });
```
```js
window.couponShield.listen((warn, vendor) => {
// Stop observing if nothing is detected within 10 seconds.
}, { unbindAfterSeconds: 10 });
```