webhanger 1.0.8 → 1.0.9

package/helper/personalization.js

@@ -0,0 +1,138 @@
+/**
+ * WebHanger Personalization Engine
+ * Resolves which component variant to serve based on rules.
+ *
+ * Rules are evaluated top-to-bottom — first match wins.
+ * Falls back to "default" if no rule matches.
+ */
+
+// ─── Context builders ─────────────────────────────────────────────────────────
+
+/**
+ * Build the personalization context from available signals.
+ * Works in both browser and Node.js (edge worker).
+ */
+export function buildContext(options = {}) {
+    const ctx = {};
+
+    // Country — from CF header (edge) or options
+    ctx.country = options.country || (typeof navigator === "undefined" ? null : null);
+
+    // Device — from User-Agent
+    const ua = options.userAgent ||
+        (typeof navigator !== "undefined" ? navigator.userAgent : "");
+    ctx.device = detectDevice(ua);
+
+    // Language — from browser or options
+    ctx.lang = options.lang ||
+        (typeof navigator !== "undefined" ? (navigator.language || "").split("-")[0] : "en");
+
+    // Role — from JWT token (WHAuth) or options
+    ctx.role = options.role || getStoredRole();
+
+    // A/B test bucket — stable per user, stored in localStorage
+    ctx.abTest = options.abTest || getABBucket();
+
+    // Hour of day (0-23) for time-based rules
+    ctx.hour = options.hour !== undefined ? options.hour : new Date().getHours();
+
+    // Subscription plan — from options or localStorage
+    ctx.plan = options.plan ||
+        (typeof localStorage !== "undefined" ? localStorage.getItem("wh_plan") || "free" : "free");
+
+    // Custom context — merge any extra fields
+    if (options.custom) Object.assign(ctx, options.custom);
+
+    return ctx;
+}
+
+function detectDevice(ua) {
+    if (!ua) return "desktop";
+    if (/tablet|ipad/i.test(ua)) return "tablet";
+    if (/mobile|android|iphone|ipod|blackberry|windows phone/i.test(ua)) return "mobile";
+    return "desktop";
+}
+
+function getStoredRole() {
+    if (typeof localStorage === "undefined") return null;
+    try {
+        const token = localStorage.getItem("wh_auth_token");
+        if (!token) return null;
+        const payload = JSON.parse(atob(token.split(".")[1]));
+        return payload.role || null;
+    } catch (_) { return null; }
+}
+
+function getABBucket() {
+    if (typeof localStorage === "undefined") return "variant-a";
+    let bucket = localStorage.getItem("wh_ab_bucket");
+    if (!bucket) {
+        bucket = Math.random() < 0.5 ? "variant-a" : "variant-b";
+        localStorage.setItem("wh_ab_bucket", bucket);
+    }
+    return bucket;
+}
+
+// ─── Rule evaluator ───────────────────────────────────────────────────────────
+
+/**
+ * Evaluate a single rule condition against the context.
+ */
+function matchesCondition(condition, ctx) {
+    for (const [key, value] of Object.entries(condition)) {
+        const ctxVal = ctx[key];
+
+        if (Array.isArray(value)) {
+            // Array = any of these values
+            if (!value.includes(ctxVal)) return false;
+        } else if (typeof value === "object" && value !== null) {
+            // Range: { min: 9, max: 17 }
+            if (value.min !== undefined && ctxVal < value.min) return false;
+            if (value.max !== undefined && ctxVal > value.max) return false;
+        } else {
+            // Exact match (case-insensitive for strings)
+            const a = typeof ctxVal === "string" ? ctxVal.toLowerCase() : ctxVal;
+            const b = typeof value  === "string" ? value.toLowerCase()  : value;
+            if (a !== b) return false;
+        }
+    }
+    return true;
+}
+
+/**
+ * Resolve which component to load for a slot based on rules + context.
+ *
+ * @param {string} slotName       - e.g. "hero"
+ * @param {object} rules          - rules config for this slot
+ * @param {object} ctx            - personalization context
+ * @returns {string}              - resolved component name
+ */
+export function resolveComponent(slotName, rules, ctx) {
+    if (!rules || !rules.rules) return rules?.default || slotName;
+
+    for (const rule of rules.rules) {
+        if (matchesCondition(rule.if || {}, ctx)) {
+            return rule.component;
+        }
+    }
+
+    return rules.default || slotName;
+}
+
+/**
+ * Resolve all slots in a personalization config.
+ *
+ * @param {object} config  - full wh-personalization.json
+ * @param {object} options - context overrides
+ * @returns {object}       - { slotName: resolvedComponentName }
+ */
+export function resolveAll(config, options = {}) {
+    const ctx = buildContext(options);
+    const resolved = {};
+
+    for (const [slot, rules] of Object.entries(config)) {
+        resolved[slot] = resolveComponent(slot, rules, ctx);
+    }
+
+    return { resolved, ctx };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webhanger",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Component-as-a-Service platform — bundle, sign, and deliver UI components via edge CDN",
   "type": "module",
   "main": "index.js",
@@ -35,7 +35,9 @@
     "chalk": "^5.6.2",
     "firebase-admin": "^12.0.0",
     "fs-extra": "^11.3.4",
-    "inquirer": "^13.4.1"
+    "inquirer": "^13.4.1",
+    "webhanger-admin": "^1.0.0",
+    "webhanger-auth": "^1.0.0"
   },
   "devDependencies": {
     "terser": "^5.46.1"