@reachy/audience-module 1.0.13 → 1.0.14

package/dist/engine/V2AudienceEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"V2AudienceEngine.d.ts","sourceRoot":"","sources":["../../src/engine/V2AudienceEngine.ts"],"names":[],"mappings":"AAGA,KAAK,MAAM,GAAG;IACZ,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC7B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC9B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAChC,CAAA;AAkHD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAQ;gBAEV,MAAM,EAAE;QAAE,cAAc,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAMvE,iCAAiC,CACrC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAgoBjB,kCAAkC,CACtC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC;IAwenB,OAAO,CAAC,IAAI;CAIb"}
+{"version":3,"file":"V2AudienceEngine.d.ts","sourceRoot":"","sources":["../../src/engine/V2AudienceEngine.ts"],"names":[],"mappings":"AAGA,KAAK,MAAM,GAAG;IACZ,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC7B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC9B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAChC,CAAA;AAyPD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAQ;gBAEV,MAAM,EAAE;QAAE,cAAc,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAMvE,iCAAiC,CACrC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IA+zBjB,kCAAkC,CACtC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC;IA2mBnB,OAAO,CAAC,IAAI;CAIb"}

package/dist/engine/V2AudienceEngine.js

@@ -31,6 +31,100 @@ const getEventPropertyValue = (eventData, keyRaw) => {
         return getByPath(ed?.session_data, key.replace(/^session_data\./, ''));
     return getByPath(ed, key) ?? getByPath(ed?.custom_data, key);
 };
+const isValidIanaTimezone = (tzRaw) => {
+    const tz = String(tzRaw || '').trim();
+    if (!tz)
+        return false;
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: tz });
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const parseTimeToMinutes = (raw) => {
+    const s = String(raw || '').trim();
+    if (!s)
+        return null;
+    const m = s.match(/^(\d{1,2}):(\d{2})\s*(AM|PM)?$/i);
+    if (!m)
+        return null;
+    let hh = Number(m[1]);
+    const mm = Number(m[2]);
+    const ampm = m[3] ? String(m[3]).toUpperCase() : null;
+    if (!Number.isFinite(hh) || !Number.isFinite(mm))
+        return null;
+    if (mm < 0 || mm > 59)
+        return null;
+    if (ampm) {
+        if (hh < 1 || hh > 12)
+            return null;
+        if (ampm === 'AM')
+            hh = hh === 12 ? 0 : hh;
+        if (ampm === 'PM')
+            hh = hh === 12 ? 12 : hh + 12;
+    }
+    else {
+        if (hh < 0 || hh > 23)
+            return null;
+    }
+    return hh * 60 + mm;
+};
+const getLocalTimeParts = (iso, tz) => {
+    const d = new Date(String(iso || ''));
+    if (Number.isNaN(d.getTime()))
+        return null;
+    const dtf = new Intl.DateTimeFormat('en-US', {
+        timeZone: tz,
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+        weekday: 'short',
+        day: '2-digit',
+    });
+    const parts = dtf.formatToParts(d);
+    let hourStr = '';
+    let minStr = '';
+    let weekdayStr = '';
+    let dayStr = '';
+    for (const p of parts) {
+        if (p.type === 'hour')
+            hourStr = p.value;
+        if (p.type === 'minute')
+            minStr = p.value;
+        if (p.type === 'weekday')
+            weekdayStr = p.value;
+        if (p.type === 'day')
+            dayStr = p.value;
+    }
+    const hour = Number(hourStr);
+    const minute = Number(minStr);
+    const dayOfMonth = Number(dayStr);
+    if (!Number.isFinite(hour) || !Number.isFinite(minute) || !Number.isFinite(dayOfMonth))
+        return null;
+    const minutes = hour * 60 + minute;
+    const weekdayMap = { Sun: 0, Mon: 1, Tue: 2, Wed: 3, Thu: 4, Fri: 5, Sat: 6 };
+    const weekday = weekdayMap[weekdayStr] ?? -1;
+    if (weekday < 0)
+        return null;
+    return { minutes, weekday, dayOfMonth };
+};
+const parseWeekdayToIndex = (raw) => {
+    const s = String(raw || '').trim().toLowerCase();
+    if (!s)
+        return null;
+    const map = {
+        sunday: 0, sun: 0,
+        monday: 1, mon: 1,
+        tuesday: 2, tue: 2, tues: 2,
+        wednesday: 3, wed: 3,
+        thursday: 4, thu: 4, thurs: 4,
+        friday: 5, fri: 5,
+        saturday: 6, sat: 6,
+    };
+    return map[s] ?? null;
+};
 const matchesInterest = (raw, op, expected) => {
     if (raw === null || raw === undefined)
         return false;
@@ -118,8 +212,9 @@ const matchesEventPropertyFilter = (raw, opRaw, expected) => {
     }
     return false;
 };
-const applyEventRuleFilters = (rows, filters) => {
+const applyEventRuleFilters = (rows, filters, opts) => {
     let out = rows;
+    const tz = String(opts?.timezone || '').trim();
     for (const f of filters) {
         const type = String(f?.type || '').trim();
         if (type === 'event_property') {
@@ -130,6 +225,62 @@ const applyEventRuleFilters = (rows, filters) => {
             const value = f?.value;
             out = out.filter((row) => matchesEventPropertyFilter(getEventPropertyValue(row?.event_data, key), op, value));
         }
+        else if (type === 'time_of_day') {
+            if (!tz)
+                continue;
+            const startMin = parseTimeToMinutes(f?.timeStart);
+            const endMin = parseTimeToMinutes(f?.timeEnd);
+            if (startMin == null || endMin == null)
+                continue;
+            if (startMin > endMin) {
+                out = [];
+                continue;
+            }
+            out = out.filter((row) => {
+                const parts = getLocalTimeParts(row?.event_timestamp, tz);
+                if (!parts)
+                    return false;
+                return parts.minutes >= startMin && parts.minutes <= endMin;
+            });
+        }
+        else if (type === 'day_of_week') {
+            if (!tz)
+                continue;
+            const days = Array.isArray(f?.days) ? f.days : [];
+            const allowed = new Set();
+            for (const d of days) {
+                const idx = parseWeekdayToIndex(d);
+                if (idx != null)
+                    allowed.add(idx);
+            }
+            if (allowed.size === 0)
+                continue;
+            out = out.filter((row) => {
+                const parts = getLocalTimeParts(row?.event_timestamp, tz);
+                if (!parts)
+                    return false;
+                return allowed.has(parts.weekday);
+            });
+        }
+        else if (type === 'day_of_month') {
+            if (!tz)
+                continue;
+            const days = Array.isArray(f?.days) ? f.days : [];
+            const allowed = new Set();
+            for (const d of days) {
+                const n = Number(d);
+                if (Number.isFinite(n) && n >= 1 && n <= 31)
+                    allowed.add(Math.floor(n));
+            }
+            if (allowed.size === 0)
+                continue;
+            out = out.filter((row) => {
+                const parts = getLocalTimeParts(row?.event_timestamp, tz);
+                if (!parts)
+                    return false;
+                return allowed.has(parts.dayOfMonth);
+            });
+        }
     }
     return out;
 };
@@ -141,6 +292,21 @@ class V2AudienceEngine {
     }
     async getContactIdsByAudienceCriteriaV2(organizationId, projectId, criteriaRaw) {
         let criteria = CriteriaParser_1.CriteriaParser.parse(criteriaRaw);
+        let projectTimezone = 'UTC';
+        try {
+            const { data } = await this.supabase
+                .from('projects')
+                .select('settings')
+                .eq('organization_id', organizationId)
+                .eq('id', projectId)
+                .single();
+            const tzCandidate = data?.settings?.timezone;
+            if (typeof tzCandidate === 'string' && isValidIanaTimezone(tzCandidate)) {
+                projectTimezone = tzCandidate.trim();
+            }
+        }
+        catch {
+        }
         if ((!Array.isArray(criteria.groups) || criteria.groups.length === 0) &&
             (Array.isArray(criteria.filters) || Array.isArray(criteria.conditions))) {
             criteria = coerceCriteriaToGroups(criteria);
@@ -163,12 +329,15 @@ class V2AudienceEngine {
             .eq('project_id', projectId);
         const allContactIds = new Set((allContacts || []).map((c) => c.id));
         const reachyIdToContactId = new Map();
+        const contactIdToReachyId = new Map();
         const emailToContactId = new Map();
         for (const c of allContacts || []) {
             const rid = c?.reachy_id ? String(c.reachy_id).trim() : '';
             const cid = c?.id ? String(c.id).trim() : '';
-            if (rid && cid)
+            if (rid && cid) {
                 reachyIdToContactId.set(rid, cid);
+                contactIdToReachyId.set(cid, rid);
+            }
             const email = c?.email ? String(c.email).trim().toLowerCase() : '';
             if (email && cid)
                 emailToContactId.set(email, cid);
@@ -412,9 +581,172 @@ class V2AudienceEngine {
             if (error)
                 return new Set();
             let rows = (data || []);
-            const ruleFilters = Array.isArray(rule.filters) ? rule.filters : [];
+            const ruleFiltersAll = Array.isArray(rule.filters) ? rule.filters : [];
+            const hasFirstTime = ruleFiltersAll.some((f) => String(f?.type || '').trim() === 'first_time');
+            const hasLastTime = ruleFiltersAll.some((f) => String(f?.type || '').trim() === 'last_time');
+            const ruleFilters = ruleFiltersAll.filter((f) => {
+                const t = String(f?.type || '').trim();
+                return t && t !== 'first_time' && t !== 'last_time';
+            });
             if (ruleFilters.length > 0) {
-                rows = applyEventRuleFilters(rows, ruleFilters);
+                rows = applyEventRuleFilters(rows, ruleFilters, { timezone: projectTimezone });
+            }
+            if ((hasFirstTime || hasLastTime) && rows.length > 0) {
+                const now = new Date();
+                let windowStartIso;
+                let windowEndIso;
+                if (rule.time) {
+                    if (rule.time.unit && rule.time.value != null) {
+                        const unit = String(rule.time.unit);
+                        const valueNum = Number(rule.time.value);
+                        const units = {
+                            minutes: 60 * 1000,
+                            hours: 60 * 60 * 1000,
+                            days: 24 * 60 * 60 * 1000,
+                            weeks: 7 * 24 * 60 * 60 * 1000,
+                            months: 30 * 24 * 60 * 60 * 1000,
+                        };
+                        const ms = units[unit] ?? units['days'];
+                        if (Number.isFinite(valueNum) && valueNum >= 0) {
+                            windowStartIso = new Date(now.getTime() - valueNum * ms).toISOString();
+                            windowEndIso = now.toISOString();
+                        }
+                    }
+                    else {
+                        if (rule.time.from)
+                            windowStartIso = String(rule.time.from);
+                        if (rule.time.to)
+                            windowEndIso = String(rule.time.to);
+                    }
+                }
+                else if (cfg && cfg.timeFrame) {
+                    const tf = String(cfg.timeFrame).trim();
+                    let unit = 'days';
+                    let value = 7;
+                    if (/^\d+$/.test(tf)) {
+                        value = Number(tf);
+                        unit = 'days';
+                    }
+                    else if (/^\d+\s*m$/.test(tf)) {
+                        value = Number(tf.replace(/m$/, ''));
+                        unit = 'minutes';
+                    }
+                    else if (/^\d+\s*h$/.test(tf)) {
+                        value = Number(tf.replace(/h$/, ''));
+                        unit = 'hours';
+                    }
+                    else if (/^\d+\s*d$/.test(tf)) {
+                        value = Number(tf.replace(/d$/, ''));
+                        unit = 'days';
+                    }
+                    else if (/^\d+\s*w$/.test(tf)) {
+                        value = Number(tf.replace(/w$/, ''));
+                        unit = 'weeks';
+                    }
+                    else if (/^\d+\s*mo$/.test(tf)) {
+                        value = Number(tf.replace(/mo$/, ''));
+                        unit = 'months';
+                    }
+                    const units = {
+                        minutes: 60 * 1000,
+                        hours: 60 * 60 * 1000,
+                        days: 24 * 60 * 60 * 1000,
+                        weeks: 7 * 24 * 60 * 60 * 1000,
+                        months: 30 * 24 * 60 * 60 * 1000,
+                    };
+                    if (Number.isFinite(value) && value >= 0) {
+                        const from = new Date(now.getTime() - value * units[unit]);
+                        windowStartIso = from.toISOString();
+                        windowEndIso = now.toISOString();
+                    }
+                }
+                if (!windowEndIso)
+                    windowEndIso = now.toISOString();
+                const candidateIds = new Set();
+                for (const row of rows) {
+                    const id = resolveEventContactId(row);
+                    if (id)
+                        candidateIds.add(id);
+                }
+                if (candidateIds.size === 0) {
+                    return new Set();
+                }
+                const candidateArr = Array.from(candidateIds);
+                const CHUNK = 500;
+                const PAGE = 1000;
+                const fetchOutside = async (dir, boundaryIso) => {
+                    const outIds = new Set();
+                    for (let i = 0; i < candidateArr.length; i += CHUNK) {
+                        const chunkIds = candidateArr.slice(i, i + CHUNK);
+                        const chunkReachyIds = chunkIds.map((cid) => contactIdToReachyId.get(cid)).filter(Boolean);
+                        const runPaged = async (queryBuilderFactory) => {
+                            let offset = 0;
+                            while (true) {
+                                const query = queryBuilderFactory(offset, offset + PAGE - 1);
+                                const { data: rowsPage, error: pageError } = await query;
+                                if (pageError || !rowsPage || rowsPage.length === 0)
+                                    break;
+                                for (const r of rowsPage) {
+                                    const cid = resolveEventContactId(r);
+                                    if (cid)
+                                        outIds.add(cid);
+                                }
+                                if (outIds.size >= candidateIds.size)
+                                    return;
+                                if (rowsPage.length < PAGE)
+                                    break;
+                                offset += PAGE;
+                                if (offset > 50000)
+                                    break;
+                            }
+                        };
+                        await runPaged((from, to) => {
+                            let q = this.supabase
+                                .from('contact_events')
+                                .select('contact_id, reachy_id, event_timestamp')
+                                .eq('organization_id', organizationId)
+                                .eq('project_id', projectId)
+                                .eq('event_name', effectiveEventName);
+                            q = dir === 'before' ? q.lt('event_timestamp', boundaryIso) : q.gt('event_timestamp', boundaryIso);
+                            q = q.in('contact_id', chunkIds);
+                            return q.range(from, to);
+                        });
+                        if (outIds.size >= candidateIds.size)
+                            break;
+                        if (chunkReachyIds.length > 0) {
+                            await runPaged((from, to) => {
+                                let q = this.supabase
+                                    .from('contact_events')
+                                    .select('contact_id, reachy_id, event_timestamp')
+                                    .eq('organization_id', organizationId)
+                                    .eq('project_id', projectId)
+                                    .eq('event_name', effectiveEventName);
+                                q = dir === 'before' ? q.lt('event_timestamp', boundaryIso) : q.gt('event_timestamp', boundaryIso);
+                                q = q.in('reachy_id', chunkReachyIds);
+                                return q.range(from, to);
+                            });
+                        }
+                        if (outIds.size >= candidateIds.size)
+                            break;
+                    }
+                    return outIds;
+                };
+                let allowed = new Set(candidateIds);
+                if (hasFirstTime && windowStartIso) {
+                    const hadBefore = await fetchOutside('before', windowStartIso);
+                    allowed = diff(allowed, hadBefore);
+                }
+                if (hasLastTime && windowEndIso) {
+                    const hadAfter = await fetchOutside('after', windowEndIso);
+                    allowed = diff(allowed, hadAfter);
+                }
+                if (allowed.size === 0) {
+                    return new Set();
+                }
+                rows = rows.filter((row) => {
+                    const id = resolveEventContactId(row);
+                    return id ? allowed.has(id) : false;
+                });
             }
             if (interest && interest.key) {
                 const key = String(interest.key || '').trim();
@@ -467,8 +799,9 @@ class V2AudienceEngine {
                 return res;
             }
             if (rule.frequency && rule.frequency.value != null) {
-                const { op, value, type = 'count', field = 'value' } = rule.frequency;
+                const { op, value, value2, type = 'count', field = 'value' } = rule.frequency;
                 const counts = new Map();
+                const denoms = new Map();
                 for (const row of rows) {
                     const id = resolveEventContactId(row);
                     if (!id)
@@ -477,16 +810,16 @@ class V2AudienceEngine {
                         counts.set(id, (counts.get(id) || 0) + 1);
                     }
                     else if (type === 'sum' || type === 'avg') {
-                        let numVal = 0;
                         const eventData = row.event_data || {};
-                        if (eventData[field] !== undefined)
-                            numVal = Number(eventData[field]);
-                        else if (eventData['value'] !== undefined)
-                            numVal = Number(eventData['value']);
-                        else if (eventData['amount'] !== undefined)
-                            numVal = Number(eventData['amount']);
-                        if (!Number.isNaN(numVal)) {
+                        const raw = getEventPropertyValue(eventData, field) ??
+                            (eventData?.[field] !== undefined ? eventData[field] : undefined) ??
+                            eventData?.value ??
+                            eventData?.amount;
+                        const numVal = Number(raw);
+                        if (Number.isFinite(numVal)) {
                             counts.set(id, (counts.get(id) || 0) + numVal);
+                            if (type === 'avg')
+                                denoms.set(id, (denoms.get(id) || 0) + 1);
                         }
                     }
                 }
@@ -494,20 +827,27 @@ class V2AudienceEngine {
                 counts.forEach((aggregatedValue, id) => {
                     let finalValue = aggregatedValue;
                     if (type === 'avg') {
-                        let eventCount = 0;
-                        for (const row of rows) {
-                            const rid = resolveEventContactId(row);
-                            if (rid === id)
-                                eventCount++;
-                        }
-                        finalValue = eventCount > 0 ? aggregatedValue / eventCount : 0;
+                        const denom = denoms.get(id) || 0;
+                        finalValue = denom > 0 ? aggregatedValue / denom : 0;
                     }
+                    const betweenOk = (() => {
+                        if (op !== 'between')
+                            return false;
+                        const a = Number(value);
+                        const b = Number(value2);
+                        if (!Number.isFinite(a) || !Number.isFinite(b))
+                            return false;
+                        if (a > b)
+                            return false;
+                        return finalValue >= a && finalValue <= b;
+                    })();
                     if ((op === '>=' && finalValue >= value) ||
                         (op === '>' && finalValue > value) ||
                         (op === '=' && finalValue === value) ||
                         (op === '!=' && finalValue !== value) ||
                         (op === '<=' && finalValue <= value) ||
-                        (op === '<' && finalValue < value)) {
+                        (op === '<' && finalValue < value) ||
+                        betweenOk) {
                         res.add(id);
                     }
                 });
@@ -797,6 +1137,21 @@ class V2AudienceEngine {
             return false;
         }
         const typeId = String(criteria?.type || '');
+        let projectTimezone = 'UTC';
+        try {
+            const { data } = await this.supabase
+                .from('projects')
+                .select('settings')
+                .eq('organization_id', organizationId)
+                .eq('id', projectId)
+                .single();
+            const tzCandidate = data?.settings?.timezone;
+            if (typeof tzCandidate === 'string' && isValidIanaTimezone(tzCandidate)) {
+                projectTimezone = tzCandidate.trim();
+            }
+        }
+        catch {
+        }
         const { data: contactRow } = await this.supabase
             .from('contacts')
             .select('id, reachy_id, email')
@@ -1011,9 +1366,127 @@ class V2AudienceEngine {
             if (error)
                 return false;
             let rows = (data || []);
-            const ruleFilters = Array.isArray(rule.filters) ? rule.filters : [];
+            const ruleFiltersAll = Array.isArray(rule.filters) ? rule.filters : [];
+            const hasFirstTime = ruleFiltersAll.some((f) => String(f?.type || '').trim() === 'first_time');
+            const hasLastTime = ruleFiltersAll.some((f) => String(f?.type || '').trim() === 'last_time');
+            const ruleFilters = ruleFiltersAll.filter((f) => {
+                const t = String(f?.type || '').trim();
+                return t && t !== 'first_time' && t !== 'last_time';
+            });
             if (ruleFilters.length > 0) {
-                rows = applyEventRuleFilters(rows, ruleFilters);
+                rows = applyEventRuleFilters(rows, ruleFilters, { timezone: projectTimezone });
+            }
+            if ((hasFirstTime || hasLastTime) && rows.length > 0) {
+                const now = new Date();
+                let windowStartIso;
+                let windowEndIso;
+                if (rule.time) {
+                    if (rule.time.unit && rule.time.value != null) {
+                        const unit = String(rule.time.unit);
+                        const valueNum = Number(rule.time.value);
+                        const units = {
+                            minutes: 60 * 1000,
+                            hours: 60 * 60 * 1000,
+                            days: 24 * 60 * 60 * 1000,
+                            weeks: 7 * 24 * 60 * 60 * 1000,
+                            months: 30 * 24 * 60 * 60 * 1000,
+                        };
+                        const ms = units[unit] ?? units['days'];
+                        if (Number.isFinite(valueNum) && valueNum >= 0) {
+                            windowStartIso = new Date(now.getTime() - valueNum * ms).toISOString();
+                            windowEndIso = now.toISOString();
+                        }
+                    }
+                    else {
+                        if (rule.time.from)
+                            windowStartIso = String(rule.time.from);
+                        if (rule.time.to)
+                            windowEndIso = String(rule.time.to);
+                    }
+                }
+                else if (cfg && cfg.timeFrame) {
+                    const tf = String(cfg.timeFrame).trim();
+                    let unit = 'days';
+                    let value = 7;
+                    if (/^\d+$/.test(tf)) {
+                        value = Number(tf);
+                        unit = 'days';
+                    }
+                    else if (/^\d+\s*m$/.test(tf)) {
+                        value = Number(tf.replace(/m$/, ''));
+                        unit = 'minutes';
+                    }
+                    else if (/^\d+\s*h$/.test(tf)) {
+                        value = Number(tf.replace(/h$/, ''));
+                        unit = 'hours';
+                    }
+                    else if (/^\d+\s*d$/.test(tf)) {
+                        value = Number(tf.replace(/d$/, ''));
+                        unit = 'days';
+                    }
+                    else if (/^\d+\s*w$/.test(tf)) {
+                        value = Number(tf.replace(/w$/, ''));
+                        unit = 'weeks';
+                    }
+                    else if (/^\d+\s*mo$/.test(tf)) {
+                        value = Number(tf.replace(/mo$/, ''));
+                        unit = 'months';
+                    }
+                    const units = {
+                        minutes: 60 * 1000,
+                        hours: 60 * 60 * 1000,
+                        days: 24 * 60 * 60 * 1000,
+                        weeks: 7 * 24 * 60 * 60 * 1000,
+                        months: 30 * 24 * 60 * 60 * 1000,
+                    };
+                    if (Number.isFinite(value) && value >= 0) {
+                        const from = new Date(now.getTime() - value * units[unit]);
+                        windowStartIso = from.toISOString();
+                        windowEndIso = now.toISOString();
+                    }
+                }
+                if (!windowEndIso)
+                    windowEndIso = now.toISOString();
+                if (hasFirstTime && windowStartIso) {
+                    let q = this.supabase
+                        .from('contact_events')
+                        .select('id')
+                        .eq('organization_id', organizationId)
+                        .eq('project_id', projectId)
+                        .eq('event_name', effectiveEventName)
+                        .lt('event_timestamp', windowStartIso)
+                        .limit(1);
+                    const ors2 = [];
+                    if (contactId)
+                        ors2.push(`contact_id.eq.${contactId}`);
+                    if (reachyId)
+                        ors2.push(`reachy_id.eq.${reachyId}`);
+                    if (ors2.length > 0)
+                        q = q.or(ors2.join(','));
+                    const { data: beforeRows } = await q;
+                    if (Array.isArray(beforeRows) && beforeRows.length > 0)
+                        return false;
+                }
+                if (hasLastTime && windowEndIso) {
+                    let q = this.supabase
+                        .from('contact_events')
+                        .select('id')
+                        .eq('organization_id', organizationId)
+                        .eq('project_id', projectId)
+                        .eq('event_name', effectiveEventName)
+                        .gt('event_timestamp', windowEndIso)
+                        .limit(1);
+                    const ors2 = [];
+                    if (contactId)
+                        ors2.push(`contact_id.eq.${contactId}`);
+                    if (reachyId)
+                        ors2.push(`reachy_id.eq.${reachyId}`);
+                    if (ors2.length > 0)
+                        q = q.or(ors2.join(','));
+                    const { data: afterRows } = await q;
+                    if (Array.isArray(afterRows) && afterRows.length > 0)
+                        return false;
+                }
             }
             if (interest && interest.key) {
                 const key = String(interest.key || '').trim();
@@ -1048,26 +1521,36 @@ class V2AudienceEngine {
                 return match > 0 && match >= maxOther;
             }
             if (rule.frequency && rule.frequency.value != null) {
-                const { op, value, type = 'count', field = 'value' } = rule.frequency;
+                const { op, value, value2, type = 'count', field = 'value' } = rule.frequency;
                 let aggregatedValue = 0;
+                let denom = 0;
                 if (type === 'count') {
                     aggregatedValue = rows.length;
                 }
                 else {
                     for (const row of rows) {
                         const eventData = row.event_data || {};
-                        let numVal = 0;
-                        if (eventData[field] !== undefined)
-                            numVal = Number(eventData[field]);
-                        else if (eventData['value'] !== undefined)
-                            numVal = Number(eventData['value']);
-                        else if (eventData['amount'] !== undefined)
-                            numVal = Number(eventData['amount']);
-                        if (!Number.isNaN(numVal))
+                        const raw = getEventPropertyValue(eventData, field) ??
+                            (eventData?.[field] !== undefined ? eventData[field] : undefined) ??
+                            eventData?.value ??
+                            eventData?.amount;
+                        const numVal = Number(raw);
+                        if (Number.isFinite(numVal)) {
                             aggregatedValue += numVal;
+                            denom += 1;
+                        }
                     }
                     if (type === 'avg')
-                        aggregatedValue = rows.length > 0 ? aggregatedValue / rows.length : 0;
+                        aggregatedValue = denom > 0 ? aggregatedValue / denom : 0;
+                }
+                if (op === 'between') {
+                    const a = Number(value);
+                    const b = Number(value2);
+                    if (!Number.isFinite(a) || !Number.isFinite(b))
+                        return false;
+                    if (a > b)
+                        return false;
+                    return aggregatedValue >= a && aggregatedValue <= b;
                 }
                 return ((op === '>=' && aggregatedValue >= value) ||
                     (op === '>' && aggregatedValue > value) ||