@enodo/butterfly-tracker 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Enodo
+
+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

@@ -1,3 +1,77 @@
-# Temporary Holding Version
+# butterfly-tracker
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Cookieless first-party audience tracker for **Enodo Butterfly** sites. One tiny
+`POST {tracker}/h` per page view; the Butterfly CMS turns them into realtime stats,
+trending / rising / top posts (`sort=trending` on the public API) and Performances.
+
+- No cookie, no localStorage, no identifier, credentials omitted: built for the CNIL
+  audience-measurement exemption, so it does **not** wait for consent.
+- `navigator.sendBeacon` (text/plain, no CORS preflight), `fetch` keepalive fallback.
+- Never throws, never blocks, no-op on the server. ~1.3 kB gzipped.
+
+## Install
+
+```bash
+npm install @enodo/butterfly-tracker
+```
+
+## Usage
+
+```ts
+import { createTracker } from '@enodo/butterfly-tracker';
+
+// Tracker URL derived from the API URL: {id}.pubbtf.eno.do -> {id}.tbtf.eno.do,
+// api{x}.example.com -> t{x}.example.com. Or pass `url` explicitly ('off' disables).
+const tracker = createTracker({ apiUrl: 'https://api.example.com', enabled: !dev });
+
+tracker.pageview({ 'content.type': 'post', 'content.id': 123 });
+
+// Or a raw hit
+tracker.hit({ t: 'category', id: '4' });
+```
+
+`toHit(layer, { typeKeys, postTypes })` adapts site-specific layers: e.g.
+`{ typeKeys: ['page.type', 'content.type'], postTypes: ['post', 'recipe'] }` sends recipe
+pages (whose `content.id` is a Butterfly post) as `post` so they rank in trending.
+
+Pagination / infinite scroll (`page.index > 1`) and the same hit twice in a row for the
+same URL are not sent.
+
+## Without a bundler
+
+```html
+<script defer src="https://cdn.jsdelivr.net/npm/@enodo/butterfly-tracker/dist/butterfly-tracker.min.js"
+  data-url="https://t.example.com" data-type="post" data-id="123"></script>
+```
+
+Sends one hit on load (`data-type` defaults to `page`, `data-auto="false"` to skip) and
+exposes `window.ButterflyTracker`.
+
+## Without JavaScript
+
+Visitors without JavaScript can be counted with a 1×1 pixel, the same hit keys as a
+query string on `GET /h.gif`:
+
+```html
+<noscript>
+  <img src="https://t.example.com/h.gif?t=post&id=123" alt="" width="1" height="1"
+    style="position:absolute">
+</noscript>
+```
+
+`<noscript>` only renders when JavaScript is off, so it never doubles the script's hit.
+It counts the view and the visitor, but not the traffic source: without JavaScript the
+page cannot read `document.referrer`, so no `e` / `r` is sent.
+
+## Hit
+
+| key | meaning |
+| --- | --- |
+| `t` | page type: post, page, category, tag, author, home, search, or any site type |
+| `id` | id of the content in the Butterfly API (post, category, term, author) |
+| `tx` | taxonomy id of a term page |
+| `pi` | page index |
+| `q`, `n` | search query, number of results |
+| `p` | property id, only on a shared tracker host |
+| `e` | entry: `1` on the first hit after a page load (set by the tracker) |
+| `r` | referrer hostname of the entry hit, never the full URL (set by the tracker) |

package/dist/butterfly-tracker.min.js

@@ -0,0 +1,2 @@
+"use strict";(()=>{var I=Object.defineProperty,v=Object.defineProperties;var B=Object.getOwnPropertyDescriptors;var l=Object.getOwnPropertySymbols;var w=Object.prototype.hasOwnProperty,U=Object.prototype.propertyIsEnumerable;var H=(t,e,n)=>e in t?I(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n,y=(t,e)=>{for(var n in e||(e={}))w.call(e,n)&&H(t,n,e[n]);if(l)for(var n of l(e))U.call(e,n)&&H(t,n,e[n]);return t},L=(t,e)=>v(t,B(e));var O=(t,e)=>{var n={};for(var r in t)w.call(t,r)&&e.indexOf(r)<0&&(n[r]=t[r]);if(t!=null&&l)for(var r of l(t))e.indexOf(r)<0&&U.call(t,r)&&(n[r]=t[r]);return n};function g(t){if(!t)return null;let e;try{e=new URL(t).hostname.toLowerCase()}catch(a){return null}let n=/^(\d+)\.pubbtf\.eno\.do$/.exec(e);if(n)return`https://${n[1]}.tbtf.eno.do`;let r=/^api([a-z0-9-]*)\.(.+\..+)$/.exec(e);return r?`https://t${r[1]}.${r[2]}`:null}function q(t,e){return t==="off"||t==="false"?null:t?t.replace(/\/+$/,""):g(e)}function m(t,e={}){var d,c;let n=(d=e.typeKeys)!=null?d:["content.type"],r=(c=e.postTypes)!=null?c:["post"],a=n.map(p=>t[p]).find(p=>typeof p=="string"&&p);if(typeof a!="string")return null;let o=t["content.id"],s=typeof o=="string"&&o||typeof o=="number"?String(o):void 0,u={t:r.includes(a)&&s!==void 0&&s!=="0"?"post":a};return s!==void 0&&(u.id=s),typeof t["content.taxonomy"]=="string"&&(u.tx=t["content.taxonomy"]),typeof t["page.index"]=="number"&&(u.pi=t["page.index"]),typeof t["page.query"]=="string"&&(u.q=t["page.query"]),typeof t["page.results"]=="number"&&(u.n=t["page.results"]),u}function A(t){let e=t!=null?t:typeof document=="undefined"?"":String(document.referrer||"");if(e)try{return new URL(e).hostname.toLowerCase()||void 0}catch(n){return}}function F(t,e){let n=typeof navigator=="undefined"?void 0:navigator;if(typeof(n==null?void 0:n.sendBeacon)=="function")try{if(n.sendBeacon(t,new Blob([e],{type:"text/plain"})))return!0}catch(r){}return typeof fetch=="function"?(fetch(t,{method:"POST",body:e,keepalive:!0,credentials:"omit",headers:{"Content-Type":"text/plain"}}).catch(()=>{}),!0):!1}function h(t={}){let e=t.enabled===!1?null:q(t.url,t.apiUrl),n,r=!1;function a(o){var s;try{if(!e||typeof window=="undefined"||((s=o.pi)!=null?s:1)>1)return!1;let f=o,{e:u,r:d}=f,c=O(f,["e","r"]),p=t.propertyId?L(y({},c),{p:t.propertyId}):y({},c),T=`${window.location.href}
+${JSON.stringify(p)}`;if(T===n)return!1;if(n=T,!r){p.e=1;let b=A();b&&(p.r=b)}let k=F(`${e}/h`,JSON.stringify(p));return k&&(r=!0),k}catch(u){return!1}}return{url:e,hit:a,pageview(o,s){let f=m(o,s);return f?a(f):!1}}}var x=document.currentScript,$,i=($=x==null?void 0:x.dataset)!=null?$:{},S=h({url:i.url,apiUrl:i.apiUrl,propertyId:i.property?parseInt(i.property,10):void 0});window.ButterflyTracker={tracker:S,createTracker:h,toHit:m,trackerUrlFromApiUrl:g};if(i.auto!=="false"){let t={t:i.type||"page"};i.id&&(t.id=i.id),i.taxonomy&&(t.tx=i.taxonomy),S.hit(t)}})();

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @enodo/butterfly-tracker — cookieless first-party audience tracker for Butterfly sites.
+ *
+ * Sends one small `POST {trackerUrl}/h` per page view (text/plain JSON via
+ * `navigator.sendBeacon`, `fetch` keepalive fallback). No cookie, no storage, no
+ * identifier, credentials omitted: designed for the CNIL audience-measurement
+ * exemption, so it does not wait for consent. Never throws, never blocks.
+ */
+/** Body of a hit. Keys are short on purpose. */
+export type Hit = {
+    /** Page type: post | page | category | tag | author | home | search | any site-specific type */
+    t: string;
+    /** Id of the content in the Butterfly API (post, category, term, author) */
+    id?: string;
+    /** Taxonomy id of a term page */
+    tx?: string;
+    /** Page index: > 1 (pagination, infinite scroll) is not a view and is not sent */
+    pi?: number;
+    /** Search query */
+    q?: string;
+    /** Number of search results (0 marks a zero-result search) */
+    n?: number;
+    /** Property id, only needed on a shared tracker host */
+    p?: number;
+    /**
+     * Entry: set on the first hit after a full page load (a visit landing on the
+     * site, or a full navigation). Set by the tracker, not by callers.
+     */
+    e?: 1;
+    /**
+     * Referrer HOSTNAME of the entry hit (never the full URL). Absent for a direct
+     * visit. The tracker maps it to a source (Google, Facebook...) and drops it
+     * when it is the site itself.
+     */
+    r?: string;
+};
+export type Layer = Record<string, unknown>;
+export type ToHitOptions = {
+    /** Layer keys read for the page type, first match wins. Default `['content.type']`. */
+    typeKeys?: string[];
+    /**
+     * Page types whose `content.id` is a Butterfly post id, sent as `post` so they
+     * rank in trending (e.g. `['post', 'recipe']`). Default `['post']`.
+     */
+    postTypes?: string[];
+};
+export type TrackerOptions = {
+    /** Tracker base URL. `off` / `false` disables. When empty, derived from `apiUrl`. */
+    url?: string | null;
+    /** Butterfly public API URL, used to derive the tracker URL. */
+    apiUrl?: string | null;
+    /** Property id, only for a shared tracker host. */
+    propertyId?: number;
+    /** Master switch (e.g. `!dev`). Default true. */
+    enabled?: boolean;
+};
+export type Tracker = {
+    /** Resolved tracker base URL, `null` when disabled. */
+    readonly url: string | null;
+    /** Sends a hit. Returns true when it was handed to the browser. */
+    hit(hit: Hit): boolean;
+    /** Maps a data layer (`content.type`, `content.id`…) to a hit and sends it. */
+    pageview(layer: Layer, options?: ToHitOptions): boolean;
+};
+/**
+ * Tracker URL derived from the Butterfly API URL, following the domain convention:
+ *   https://{id}.pubbtf.eno.do   -> https://{id}.tbtf.eno.do
+ *   https://api{x}.example.com   -> https://t{x}.example.com  (api. -> t., apibe. -> tbe.)
+ * `null` when the API URL follows neither pattern.
+ */
+export declare function trackerUrlFromApiUrl(apiUrl: string | null | undefined): string | null;
+/** Explicit URL when set (`off` / `false` disables), otherwise derived from the API URL. */
+export declare function resolveTrackerUrl(url: string | null | undefined, apiUrl?: string | null): string | null;
+/**
+ * Maps a data layer to a hit, `null` when there is nothing to count.
+ * Reads `content.type` (or `typeKeys`), `content.id`, `content.taxonomy`,
+ * `page.index`, `page.query` and `page.results`.
+ */
+export declare function toHit(layer: Layer, options?: ToHitOptions): Hit | null;
+/** Hostname of `document.referrer`, lowercase, `undefined` when empty or unparseable. */
+export declare function referrerHost(referrer?: string): string | undefined;
+export declare function createTracker(options?: TrackerOptions): Tracker;

package/dist/index.js

@@ -0,0 +1,166 @@
+/**
+ * @enodo/butterfly-tracker — cookieless first-party audience tracker for Butterfly sites.
+ *
+ * Sends one small `POST {trackerUrl}/h` per page view (text/plain JSON via
+ * `navigator.sendBeacon`, `fetch` keepalive fallback). No cookie, no storage, no
+ * identifier, credentials omitted: designed for the CNIL audience-measurement
+ * exemption, so it does not wait for consent. Never throws, never blocks.
+ */
+/**
+ * Tracker URL derived from the Butterfly API URL, following the domain convention:
+ *   https://{id}.pubbtf.eno.do   -> https://{id}.tbtf.eno.do
+ *   https://api{x}.example.com   -> https://t{x}.example.com  (api. -> t., apibe. -> tbe.)
+ * `null` when the API URL follows neither pattern.
+ */
+export function trackerUrlFromApiUrl(apiUrl) {
+    if (!apiUrl) {
+        return null;
+    }
+    let host;
+    try {
+        host = new URL(apiUrl).hostname.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+    const own = /^(\d+)\.pubbtf\.eno\.do$/.exec(host);
+    if (own) {
+        return `https://${own[1]}.tbtf.eno.do`;
+    }
+    const custom = /^api([a-z0-9-]*)\.(.+\..+)$/.exec(host);
+    if (custom) {
+        return `https://t${custom[1]}.${custom[2]}`;
+    }
+    return null;
+}
+/** Explicit URL when set (`off` / `false` disables), otherwise derived from the API URL. */
+export function resolveTrackerUrl(url, apiUrl) {
+    if (url === 'off' || url === 'false') {
+        return null;
+    }
+    if (url) {
+        return url.replace(/\/+$/, '');
+    }
+    return trackerUrlFromApiUrl(apiUrl);
+}
+/**
+ * Maps a data layer to a hit, `null` when there is nothing to count.
+ * Reads `content.type` (or `typeKeys`), `content.id`, `content.taxonomy`,
+ * `page.index`, `page.query` and `page.results`.
+ */
+export function toHit(layer, options = {}) {
+    const typeKeys = options.typeKeys ?? ['content.type'];
+    const postTypes = options.postTypes ?? ['post'];
+    const type = typeKeys.map((k) => layer[k]).find((v) => typeof v === 'string' && v);
+    if (typeof type !== 'string') {
+        return null;
+    }
+    const rawId = layer['content.id'];
+    const id = (typeof rawId === 'string' && rawId) || typeof rawId === 'number' ? String(rawId) : undefined;
+    const isPost = postTypes.includes(type) && id !== undefined && id !== '0';
+    const hit = { t: isPost ? 'post' : type };
+    if (id !== undefined) {
+        hit.id = id;
+    }
+    if (typeof layer['content.taxonomy'] === 'string') {
+        hit.tx = layer['content.taxonomy'];
+    }
+    if (typeof layer['page.index'] === 'number') {
+        hit.pi = layer['page.index'];
+    }
+    if (typeof layer['page.query'] === 'string') {
+        hit.q = layer['page.query'];
+    }
+    if (typeof layer['page.results'] === 'number') {
+        hit.n = layer['page.results'];
+    }
+    return hit;
+}
+/** Hostname of `document.referrer`, lowercase, `undefined` when empty or unparseable. */
+export function referrerHost(referrer) {
+    const value = referrer ?? (typeof document === 'undefined' ? '' : String(document.referrer || ''));
+    if (!value) {
+        return undefined;
+    }
+    try {
+        return new URL(value).hostname.toLowerCase() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function send(url, body) {
+    const nav = typeof navigator === 'undefined' ? undefined : navigator;
+    if (typeof nav?.sendBeacon === 'function') {
+        try {
+            if (nav.sendBeacon(url, new Blob([body], { type: 'text/plain' }))) {
+                return true;
+            }
+        }
+        catch {
+            // fall through to fetch
+        }
+    }
+    if (typeof fetch === 'function') {
+        fetch(url, {
+            method: 'POST',
+            body,
+            keepalive: true,
+            credentials: 'omit',
+            headers: { 'Content-Type': 'text/plain' },
+        }).catch(() => undefined);
+        return true;
+    }
+    return false;
+}
+export function createTracker(options = {}) {
+    const url = options.enabled === false ? null : resolveTrackerUrl(options.url, options.apiUrl);
+    let last;
+    // The first hit sent after the page load is the entry (one per tracker instance)
+    let entrySent = false;
+    function hit(input) {
+        try {
+            if (!url || typeof window === 'undefined') {
+                return false;
+            }
+            // Pagination / infinite scroll are not new views
+            if ((input.pi ?? 1) > 1) {
+                return false;
+            }
+            const { e: _e, r: _r, ...hitInput } = input;
+            const payload = options.propertyId
+                ? { ...hitInput, p: options.propertyId }
+                : { ...hitInput };
+            // Same hit for the same URL twice in a row (effect re-run, data reload): once
+            const key = `${window.location.href}\n${JSON.stringify(payload)}`;
+            if (key === last) {
+                return false;
+            }
+            last = key;
+            if (!entrySent) {
+                payload.e = 1;
+                const r = referrerHost();
+                if (r) {
+                    payload.r = r;
+                }
+            }
+            const sent = send(`${url}/h`, JSON.stringify(payload));
+            if (sent) {
+                entrySent = true;
+            }
+            return sent;
+        }
+        catch {
+            return false; // analytics must never break the page
+        }
+    }
+    return {
+        url,
+        hit,
+        pageview(layer, toHitOptions) {
+            const h = toHit(layer, toHitOptions);
+            return h ? hit(h) : false;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@enodo/butterfly-tracker",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Cookieless first-party audience tracker for Enodo Butterfly sites (pageview hits, no cookie, no storage)",
+  "author": "Jerome Musialak <jerome@eno.do>",
+  "license": "MIT",
+  "homepage": "https://github.com/enodo-io/butterfly-tracker",
+  "bugs": {
+    "url": "https://github.com/enodo-io/butterfly-tracker/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/enodo-io/butterfly-tracker.git"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./script": "./dist/butterfly-tracker.min.js"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json && esbuild src/script.ts --bundle --minify --format=iife --target=es2017 --outfile=dist/butterfly-tracker.min.js",
+    "lint": "eslint --config eslint.config.mjs --max-warnings=0 .",
+    "lint:tsc": "tsc --noEmit",
+    "format": "prettier --write .",
+    "test": "vitest",
+    "prepublishOnly": "npm run lint && npm run lint:tsc && npm test && npm run build"
+  },
+  "keywords": [
+    "butterfly",
+    "analytics",
+    "tracker",
+    "cookieless",
+    "pageview"
+  ],
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "@types/node": "^24.19.2",
+    "esbuild": "^0.25.12",
+    "eslint": "^9.39.5",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-import-x": "^4.18.0",
+    "eslint-plugin-prettier": "^5.5.7",
+    "eslint-plugin-unused-imports": "^4.4.1",
+    "prettier": "^3.9.10",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.72.1",
+    "vitest": "^3.2.7"
+  }
+}