jizy-obfuscator 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020-present Joffrey Demetz
+
+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/README.md

@@ -0,0 +1,49 @@
+# jizy-obfuscator
+
+Un-obfuscate email addresses (and other sensitive strings) in the DOM at runtime, keeping them hidden from most scrapers.
+
+Content is stored ROT13-encoded inside placeholder elements and decoded client-side on page load.
+
+## Install
+
+```bash
+npm install jizy-obfuscator
+```
+
+## How it works
+
+1. Server-side, encode each email with ROT13 and emit a placeholder with a matching id:
+
+    ```html
+    Contact: <span id="obfuscated-0"></span>
+    Support: <span id="obfuscated-1"></span>
+    ```
+
+2. Client-side, pass the ROT13-encoded strings (in the same order as the ids) to `Obfuscator.decode`:
+
+    ```js
+    import { Obfuscator } from 'jizy-obfuscator';
+
+    Obfuscator.decode([
+        '<n uers="znvygb:wbr@rknzcyr.pbz">wbr@rknzcyr.pbz</n>', // -> <a href="mailto:joe@example.com">joe@example.com</a>
+        '<n uers="znvygb:fhccbeg@rknzcyr.pbz">fhccbeg@rknzcyr.pbz</n>'
+    ]);
+    ```
+
+   Each entry replaces `#obfuscated-<index>` via `outerHTML`, so the decoded HTML can include links or any markup.
+
+## API
+
+### `Obfuscator.decode(obfuscated)`
+
+- `obfuscated` — `string[]` of ROT13-encoded HTML fragments. Index `i` replaces the element `#obfuscated-i`.
+
+ROT13 is its own inverse: encode and decode use the same transform. Non-letter characters (digits, `@`, `.`, tags, attributes) pass through unchanged.
+
+## Browser build
+
+A prebuilt bundle is available at `dist/js/jizy-obfuscator.min.js` for direct `<script>` inclusion.
+
+## License
+
+MIT © Joffrey Demetz

package/dist/js/jizy-obfuscator.min.js

@@ -0,0 +1,2 @@
+/*! Obfuscator v1.0.0 | MIT | 2026-04-15T09:11Z | [default] */
+!function(t){"use strict";if("object"!=typeof t||!t||!t.document)throw new Error("Obfuscator requires a window with a document");if(void 0!==t.Obfuscator)throw new Error("Obfuscator is already defined");var e=function(){const t={map:null,convert:function(t){this.init();let e="";for(let r=0;r<t.length;r++){const o=t.charAt(r);e+=o>="A"&&o<="Z"||o>="a"&&o<="z"?this.map[o]:o}return e},init:function(){if(null!=this.map)return;const t=[],e="abcdefghijklmnopqrstuvwxyz";for(let r=0;r<26;r++)t[e.charAt(r)]=e.charAt((r+13)%26);for(let r=0;r<26;r++)t[e.charAt(r).toUpperCase()]=e.charAt((r+13)%26).toUpperCase();this.map=t}};return{decode:function(e){if(e&&e.length)for(let r=0,o=e.length;r<o;r++)document.querySelector("#obfuscated-"+r).outerHTML=t.convert(e[r])}}}();t.Obfuscator=e}("undefined"!=typeof window?window:this);

package/lib/index.js

@@ -0,0 +1,5 @@
+import Obfuscator from './js/Obfuscator.js';
+
+export {
+    Obfuscator,
+};

package/lib/js/Obfuscator.js

@@ -0,0 +1,15 @@
+import Rot13 from './Rot13.js';
+
+const Obfuscator = {
+    decode: function (obfuscated) {
+        if (!obfuscated || !obfuscated.length) {
+            return;
+        }
+
+        for (let i = 0, n = obfuscated.length; i < n; i++) {
+            document.querySelector("#obfuscated-" + i).outerHTML = Rot13.convert(obfuscated[i]);
+        }
+    }
+};
+
+export default Obfuscator;

package/lib/js/Rot13.js

@@ -0,0 +1,35 @@
+const Rot13 = {
+    map: null,
+
+    convert: function (a) {
+        this.init();
+
+        let s = "";
+        for (let i = 0; i < a.length; i++) {
+            const b = a.charAt(i);
+            s += ((b >= 'A' && b <= 'Z') || (b >= 'a' && b <= 'z') ? this.map[b] : b);
+        }
+        return s;
+    },
+
+    init: function () {
+        if (this.map != null) {
+            return;
+        }
+
+        const map = [];
+        const s = "abcdefghijklmnopqrstuvwxyz";
+
+        for (let i = 0; i < s.length; i++) {
+            map[s.charAt(i)] = s.charAt((i + 13) % 26);
+        }
+
+        for (let i = 0; i < s.length; i++) {
+            map[s.charAt(i).toUpperCase()] = s.charAt((i + 13) % 26).toUpperCase();
+        }
+
+        this.map = map;
+    }
+};
+
+export default Rot13;

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "jizy-obfuscator",
+  "version": "1.0.1",
+  "browser": "dist/js/jizy-obfuscator.min.js",
+  "main": "lib/index.js",
+  "type": "module",
+  "jizy": "dist/",
+  "licence": "MIT",
+  "homepage": "https://jdz.joffreydemetz.com/jizy-obfuscator",
+  "description": "UnObfuscate email addresses from the DOM",
+  "keywords": [
+    "jdz",
+    "jizy",
+    "joffreydemetz",
+    "obfuscator"
+  ],
+  "files": [
+    "dist/*",
+    "lib/*"
+  ],
+  "scripts": {
+    "jpack:dist": "node ./cli/jpack.js"
+  },
+  "dependencies": {
+    "jizy-packer": "^2.1.44",
+    "less": "^4.4.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joffreydemetz/jizy-obfuscator.git"
+  },
+  "author": "Joffrey Demetz <joffrey.demetz@gmail.com> (https://joffreydemetz.com)"
+}