fck-honey 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cooper Reid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/honey-detect.d.ts

@@ -0,0 +1,22 @@
+declare namespace fckHoney {
+    type MatchCallback = (el: HTMLDivElement) => void;
+    interface ObserverOptions {
+        onMatch?: MatchCallback;
+        uuidGate?: boolean;
+        zNearMax?: number;
+    }
+    interface ObserverHandle {
+        stop: () => void;
+    }
+    interface ListenHandle {
+        stop: () => void;
+    }
+    function startHoneyOverlayObserver(options?: ObserverOptions): ObserverHandle;
+    function listen(onMatch: MatchCallback, options?: Omit<ObserverOptions, "onMatch">): ListenHandle;
+}
+interface Window {
+    fckHoney?: {
+        startHoneyOverlayObserver?: typeof fckHoney.startHoneyOverlayObserver;
+        listen?: typeof fckHoney.listen;
+    };
+}

package/dist/honey-detect.js

@@ -0,0 +1,109 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var fckHoney;
+(function (fckHoney) {
+    var DEFAULT_Z_NEAR_MAX = 2147480000;
+    var UUIDISH_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    function parseZIndex(cs) {
+        var z = parseInt(cs.zIndex, 10);
+        return isFinite(z) ? z : null;
+    }
+    function looksLikeTargetDiv(el, zNearMax, uuidGate) {
+        if (!el.id)
+            return false;
+        if (uuidGate && !UUIDISH_RE.test(el.id))
+            return false;
+        var cs = getComputedStyle(el);
+        var z = parseZIndex(cs);
+        if (z === null || z < zNearMax)
+            return false;
+        if (cs.display === "none")
+            return false;
+        if (el.shadowRoot)
+            return false;
+        return true;
+    }
+    function checkNode(node, seen, zNearMax, uuidGate, onMatch) {
+        var _a;
+        if (!(node instanceof Element))
+            return;
+        if (node instanceof HTMLDivElement &&
+            seen.indexOf(node) === -1 &&
+            looksLikeTargetDiv(node, zNearMax, uuidGate)) {
+            seen.push(node);
+            onMatch(node);
+        }
+        var divs = (_a = node.querySelectorAll) === null || _a === void 0 ? void 0 : _a.call(node, "div[id]");
+        if (!divs)
+            return;
+        for (var i = 0; i < divs.length; i += 1) {
+            var d = divs[i];
+            if (seen.indexOf(d) === -1 && looksLikeTargetDiv(d, zNearMax, uuidGate)) {
+                seen.push(d);
+                onMatch(d);
+            }
+        }
+    }
+    function startHoneyOverlayObserver(options) {
+        var _a, _b, _c;
+        if (options === void 0) { options = {}; }
+        var seen = [];
+        var zNearMax = (_a = options.zNearMax) !== null && _a !== void 0 ? _a : DEFAULT_Z_NEAR_MAX;
+        var uuidGate = (_b = options.uuidGate) !== null && _b !== void 0 ? _b : true;
+        var onMatch = (_c = options.onMatch) !== null && _c !== void 0 ? _c : (function (el) {
+            // Default: warn only, leaving response up to caller.
+            console.warn("[honey-detect] matched near-max z-index div:", el);
+        });
+        var mo = new MutationObserver(function (mutations) {
+            for (var _i = 0, mutations_1 = mutations; _i < mutations_1.length; _i++) {
+                var m = mutations_1[_i];
+                if (m.type === "childList") {
+                    for (var i = 0; i < m.addedNodes.length; i += 1) {
+                        checkNode(m.addedNodes[i], seen, zNearMax, uuidGate, onMatch);
+                    }
+                }
+                else if (m.type === "attributes") {
+                    var el = m.target;
+                    if (el instanceof HTMLDivElement &&
+                        el.id &&
+                        seen.indexOf(el) === -1 &&
+                        looksLikeTargetDiv(el, zNearMax, uuidGate)) {
+                        seen.push(el);
+                        onMatch(el);
+                    }
+                }
+            }
+        });
+        mo.observe(document.documentElement, {
+            subtree: true,
+            childList: true,
+            attributes: true,
+            attributeFilter: ["style", "class", "id"]
+        });
+        checkNode(document.documentElement, seen, zNearMax, uuidGate, onMatch);
+        return {
+            stop: function () { return mo.disconnect(); }
+        };
+    }
+    fckHoney.startHoneyOverlayObserver = startHoneyOverlayObserver;
+    function listen(onMatch, options) {
+        if (options === void 0) { options = {}; }
+        return startHoneyOverlayObserver(__assign(__assign({}, options), { onMatch: onMatch }));
+    }
+    fckHoney.listen = listen;
+})(fckHoney || (fckHoney = {}));
+if (typeof window !== "undefined") {
+    window.fckHoney = window.fckHoney || {};
+    window.fckHoney.startHoneyOverlayObserver = fckHoney.startHoneyOverlayObserver;
+    window.fckHoney.listen = fckHoney.listen;
+}

package/dist/index.js

@@ -0,0 +1,115 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.startHoneyOverlayObserver = startHoneyOverlayObserver;
+    exports.listen = listen;
+    var DEFAULT_Z_NEAR_MAX = 2147480000;
+    var UUIDISH_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    function parseZIndex(cs) {
+        var z = parseInt(cs.zIndex, 10);
+        return isFinite(z) ? z : null;
+    }
+    function looksLikeTargetDiv(el, zNearMax, uuidGate) {
+        if (!el.id)
+            return false;
+        if (uuidGate && !UUIDISH_RE.test(el.id))
+            return false;
+        var cs = getComputedStyle(el);
+        var z = parseZIndex(cs);
+        if (z === null || z < zNearMax)
+            return false;
+        if (cs.display === "none")
+            return false;
+        if (el.shadowRoot)
+            return false;
+        return true;
+    }
+    function checkNode(node, seen, zNearMax, uuidGate, onMatch) {
+        var _a;
+        if (!(node instanceof Element))
+            return;
+        if (node instanceof HTMLDivElement && seen.indexOf(node) === -1 && looksLikeTargetDiv(node, zNearMax, uuidGate)) {
+            seen.push(node);
+            onMatch(node);
+        }
+        var divs = (_a = node.querySelectorAll) === null || _a === void 0 ? void 0 : _a.call(node, "div[id]");
+        if (!divs)
+            return;
+        for (var i = 0; i < divs.length; i += 1) {
+            var d = divs[i];
+            if (seen.indexOf(d) === -1 && looksLikeTargetDiv(d, zNearMax, uuidGate)) {
+                seen.push(d);
+                onMatch(d);
+            }
+        }
+    }
+    function startHoneyOverlayObserver(options) {
+        var _a, _b, _c;
+        if (options === void 0) { options = {}; }
+        var seen = [];
+        var zNearMax = (_a = options.zNearMax) !== null && _a !== void 0 ? _a : DEFAULT_Z_NEAR_MAX;
+        var uuidGate = (_b = options.uuidGate) !== null && _b !== void 0 ? _b : true;
+        var onMatch = (_c = options.onMatch) !== null && _c !== void 0 ? _c : (function (el) {
+            // Default: warn only, leaving response up to caller.
+            console.warn("[honey-detect] matched near-max z-index div:", el);
+        });
+        var mo = new MutationObserver(function (mutations) {
+            for (var _i = 0, mutations_1 = mutations; _i < mutations_1.length; _i++) {
+                var m = mutations_1[_i];
+                if (m.type === "childList") {
+                    for (var i = 0; i < m.addedNodes.length; i += 1) {
+                        checkNode(m.addedNodes[i], seen, zNearMax, uuidGate, onMatch);
+                    }
+                }
+                else if (m.type === "attributes") {
+                    var el = m.target;
+                    if (el instanceof HTMLDivElement &&
+                        el.id &&
+                        seen.indexOf(el) === -1 &&
+                        looksLikeTargetDiv(el, zNearMax, uuidGate)) {
+                        seen.push(el);
+                        onMatch(el);
+                    }
+                }
+            }
+        });
+        mo.observe(document.documentElement, {
+            subtree: true,
+            childList: true,
+            attributes: true,
+            attributeFilter: ["style", "class", "id"]
+        });
+        checkNode(document.documentElement, seen, zNearMax, uuidGate, onMatch);
+        return {
+            stop: function () { return mo.disconnect(); }
+        };
+    }
+    function listen(onMatch, options) {
+        if (options === void 0) { options = {}; }
+        return startHoneyOverlayObserver(__assign(__assign({}, options), { onMatch: onMatch }));
+    }
+    if (typeof window !== "undefined") {
+        window.fckHoney = window.fckHoney || {};
+        window.fckHoney.startHoneyOverlayObserver = startHoneyOverlayObserver;
+        window.fckHoney.listen = listen;
+    }
+});

package/dist/types/index.d.ts

@@ -0,0 +1,22 @@
+export type MatchCallback = (el: HTMLDivElement) => void;
+export interface ObserverOptions {
+    onMatch?: MatchCallback;
+    uuidGate?: boolean;
+    zNearMax?: number;
+}
+export interface ObserverHandle {
+    stop: () => void;
+}
+export interface ListenHandle {
+    stop: () => void;
+}
+export declare function startHoneyOverlayObserver(options?: ObserverOptions): ObserverHandle;
+export declare function listen(onMatch: MatchCallback, options?: Omit<ObserverOptions, "onMatch">): ListenHandle;
+declare global {
+    interface Window {
+        fckHoney?: {
+            startHoneyOverlayObserver?: typeof startHoneyOverlayObserver;
+            listen?: typeof listen;
+        };
+    }
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "fck-honey",
+  "version": "0.1.0",
+  "description": "Detects Honey browser extension overlays for merchants.",
+  "license": "MIT",
+  "main": "dist/honey-detect.js",
+  "types": "dist/honey-detect.d.ts",
+  "jsdelivr": "dist/honey-detect.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}