@kywi-software/core 0.1.0

package/dist/audiences/cookies.js

@@ -0,0 +1,75 @@
+import { SignJWT, jwtVerify } from 'jose';
+export const COOKIE_NAMES = {
+    SIGNALS: 'kywi_signals',
+    VISITOR: 'kywi_visitor',
+    UTM: 'kywi_utm',
+    AUDIENCE: 'kywi_audience',
+    OPTOUT: 'kywi_optout',
+    KNOWN: 'kywi_known',
+    PREVIEW_INIT: 'kywi_preview_init',
+};
+export const COOKIE_MAX_AGE = {
+    SIGNALS: 60,
+    VISITOR: 2 * 365 * 24 * 3600,
+    UTM: 30 * 24 * 3600,
+    OPTOUT: 365 * 24 * 3600,
+    KNOWN: 24 * 3600,
+    PREVIEW_INIT: 30,
+};
+export async function signSignals(payload, secret) {
+    const key = new TextEncoder().encode(secret);
+    return new SignJWT({ data: payload })
+        .setProtectedHeader({ alg: 'HS256' })
+        .setExpirationTime('60s')
+        .sign(key);
+}
+export async function verifySignals(token, secret) {
+    try {
+        const key = new TextEncoder().encode(secret);
+        const { payload } = await jwtVerify(token, key, { algorithms: ['HS256'] });
+        return payload.data ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function parseCookies(cookieHeader) {
+    const map = new Map();
+    if (!cookieHeader)
+        return map;
+    for (const pair of cookieHeader.split(';')) {
+        const trimmed = pair.trim();
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx < 0)
+            continue;
+        // Decode percent-encoding so this is symmetric with buildSetCookieHeader
+        // (and the platform, e.g. Next.js) which URL-encode the value on write.
+        // Encode-safe values (uuids, "1") pass through unchanged; a value with a
+        // stray "%" that is not a valid escape falls back to its raw form. Without
+        // this, a JSON cookie value like kywi_utm (`{"source":"google"}` → written
+        // as `%7B%22source%22...`) can never be JSON.parsed back on read.
+        const key = trimmed.slice(0, eqIdx);
+        const rawValue = trimmed.slice(eqIdx + 1);
+        let value = rawValue;
+        try {
+            value = decodeURIComponent(rawValue);
+        }
+        catch {
+            /* malformed escape — keep the raw value */
+        }
+        map.set(key, value);
+    }
+    return map;
+}
+export function buildSetCookieHeader(name, value, maxAge, options) {
+    const parts = [`${name}=${encodeURIComponent(value)}`];
+    if (maxAge >= 0)
+        parts.push(`Max-Age=${maxAge}`);
+    // maxAge < 0 means session cookie (no Max-Age directive)
+    parts.push('Path=/');
+    if (options?.httpOnly !== false)
+        parts.push('HttpOnly');
+    parts.push(`SameSite=${options?.sameSite ?? 'Lax'}`);
+    return parts.join('; ');
+}
+//# sourceMappingURL=cookies.js.map

package/dist/audiences/cookies.js.map

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

package/dist/audiences/deletion-guard.d.ts

@@ -0,0 +1,26 @@
+/**
+ * deletion-guard.ts
+ * Pure layout scanners backing the audience deletion reference-integrity check.
+ *
+ * An audience may be referenced by a content layout in several ways:
+ *   1. A page-level variant (`layout.pageVariants[].audienceId`).
+ *   2. A structural (region-level) variantContainer variant
+ *      (`…regions[region][].variants[].audienceId`) — a RegionNode.
+ *   3. A module-level variantContainer — a ModuleNode with `type: 'variantContainer'`
+ *      inside a section column, storing audience refs in `props.variants[].audienceId`
+ *      (the shape authored by the layout-editor palette / VariantContainerConfig).
+ *
+ * The walk visits every sections array in the document — base regions, page-variant
+ * regions, A/B experiment-variant regions, and the inner sections of structural
+ * variantContainers (default + variants) — and descends into each section's columns
+ * so module-level containers are never missed. Kept DB-agnostic so the logic is
+ * unit-testable without a database.
+ */
+import type { LayoutDocument } from '../layout/types.js';
+/**
+ * Walk a whole LayoutDocument and return a description for every reference to
+ * `audienceId` — page variants plus structural and module-level variantContainers
+ * at any nesting depth.
+ */
+export declare function scanLayoutForAudience(layout: LayoutDocument, audienceId: string): string[];
+//# sourceMappingURL=deletion-guard.d.ts.map

package/dist/audiences/deletion-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deletion-guard.d.ts","sourceRoot":"","sources":["../../src/audiences/deletion-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,cAAc,EAA6B,MAAM,oBAAoB,CAAA;AAwFnF;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CA6BV"}

package/dist/audiences/deletion-guard.js

@@ -0,0 +1,99 @@
+import { isLayoutSection } from '../layout/types.js';
+/**
+ * Parse a module's `variants` prop the same way VariantContainerModule does:
+ * an already-materialised array, or a JSON-encoded array string. Anything else
+ * (or malformed JSON) yields an empty list.
+ */
+function parseArmVariants(raw) {
+    let list = raw;
+    if (typeof raw === 'string') {
+        try {
+            list = JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+    }
+    if (!Array.isArray(list))
+        return [];
+    return list.filter((v) => typeof v === 'object' && v !== null);
+}
+/**
+ * Scan a section's columns for module-level variantContainer nodes whose
+ * `props.variants` reference `audienceId`.
+ */
+function scanSectionModules(section, audienceId, context) {
+    const refs = [];
+    for (const column of section.columns) {
+        for (const node of column.nodes) {
+            if (node.type !== 'variantContainer')
+                continue;
+            const arms = parseArmVariants(node.props?.['variants']);
+            if (arms.some(a => a['audienceId'] === audienceId)) {
+                refs.push(`variant container module "${node.id}" in section "${section.id}"${context}`);
+            }
+        }
+    }
+    return refs;
+}
+/** Scan an array of LayoutSections (descending into their columns). */
+function scanSections(sections, audienceId, context) {
+    const refs = [];
+    for (const section of sections) {
+        refs.push(...scanSectionModules(section, audienceId, context));
+    }
+    return refs;
+}
+/**
+ * Scan a regions map for references: structural variantContainer variants, the
+ * module-level containers inside plain sections, and the module-level containers
+ * nested inside a structural container's default + variant sections.
+ */
+function scanRegions(regions, audienceId, context) {
+    const refs = [];
+    for (const [regionName, nodes] of Object.entries(regions)) {
+        for (const node of nodes) {
+            if (isLayoutSection(node)) {
+                // A plain section — descend into its columns for module-level containers.
+                refs.push(...scanSectionModules(node, audienceId, ` in region "${regionName}"${context}`));
+                continue;
+            }
+            // A structural (region-level) variantContainer.
+            if (node.variants.some(v => v.audienceId === audienceId)) {
+                refs.push(`variant container "${node.id}" in region "${regionName}"${context}`);
+            }
+            // Its inner sections (default + each variant) may nest module-level containers.
+            refs.push(...scanSections(node.defaultSections, audienceId, ` in region "${regionName}" (variant container "${node.id}" default)${context}`));
+            for (const v of node.variants) {
+                refs.push(...scanSections(v.sections, audienceId, ` in region "${regionName}" (variant container "${node.id}" variant "${v.id}")${context}`));
+            }
+        }
+    }
+    return refs;
+}
+/**
+ * Walk a whole LayoutDocument and return a description for every reference to
+ * `audienceId` — page variants plus structural and module-level variantContainers
+ * at any nesting depth.
+ */
+export function scanLayoutForAudience(layout, audienceId) {
+    const refs = [];
+    // Base regions.
+    refs.push(...scanRegions(layout.regions, audienceId, ''));
+    // Page variants: the variant itself may target the audience, and its regions
+    // may nest variantContainers (structural or module-level) that reference it.
+    for (const pv of layout.pageVariants ?? []) {
+        if (pv.audienceId === audienceId) {
+            refs.push(`page variant "${pv.id}"`);
+        }
+        refs.push(...scanRegions(pv.regions, audienceId, ` (page variant "${pv.id}")`));
+    }
+    // A/B experiment variants: their regions may nest variantContainers.
+    for (const exp of layout.abExperiments ?? []) {
+        for (const variant of exp.variants) {
+            refs.push(...scanRegions(variant.regions, audienceId, ` (experiment "${exp.id}" variant "${variant.id}")`));
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=deletion-guard.js.map

package/dist/audiences/deletion-guard.js.map

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

package/dist/audiences/engine.d.ts

@@ -0,0 +1,9 @@
+import type { VisitorContext, AudienceResult, Audience } from './types.js';
+export interface AudienceEngineConfig {
+    audiences: Audience[];
+}
+export interface AudienceEngine {
+    evaluate(context: VisitorContext): Promise<AudienceResult>;
+}
+export declare function createAudienceEngine(config: AudienceEngineConfig): AudienceEngine;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/audiences/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAK1F,MAAM,WAAW,oBAAoB;IAAG,SAAS,EAAE,QAAQ,EAAE,CAAA;CAAE;AAC/D,MAAM,WAAW,cAAc;IAAG,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CAAE;AAe9F,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAkBjF"}

package/dist/audiences/engine.js

@@ -0,0 +1,35 @@
+import { createEmptySignals } from './types.js';
+import { runServerCollectors } from './collectors/index.js';
+import { resolveAudiences } from './evaluator/resolver.js';
+function mergeSignals(base, partial) {
+    return {
+        utm: partial.utm ?? base.utm,
+        referrer: partial.referrer ?? base.referrer,
+        session: partial.session ?? base.session,
+        behavioral: partial.behavioral ?? base.behavioral,
+        selfId: { ...base.selfId, ...partial.selfId },
+        identity: partial.identity ?? base.identity,
+        adapters: { ...base.adapters, ...partial.adapters },
+        meta: { ...base.meta, ...partial.meta },
+    };
+}
+export function createAudienceEngine(config) {
+    return {
+        async evaluate(context) {
+            const serverSignals = runServerCollectors(context.request);
+            let signals = mergeSignals(createEmptySignals(), serverSignals);
+            if (context.partialSignals) {
+                signals = mergeSignals(signals, context.partialSignals);
+            }
+            const isOptedOut = signals.meta.isOptedOut;
+            const { winningAudienceId, allMatchedIds } = resolveAudiences(config.audiences, signals);
+            return {
+                winningAudienceId: isOptedOut ? null : winningAudienceId,
+                allMatchedIds,
+                signals,
+                isOptedOut,
+            };
+        },
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/audiences/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/audiences/engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAK1D,SAAS,YAAY,CAAC,IAAoB,EAAE,OAAgC;IAC1E,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ;QAC3C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;QACxC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU;QACjD,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE;QAC7C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ;QAC3C,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE;QACnD,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE;KACxC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAA4B;IAC/D,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,OAAuB;YACpC,MAAM,aAAa,GAAG,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YAC1D,IAAI,OAAO,GAAG,YAAY,CAAC,kBAAkB,EAAE,EAAE,aAAa,CAAC,CAAA;YAC/D,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC3B,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;YACzD,CAAC;YACD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAA;YAC1C,MAAM,EAAE,iBAAiB,EAAE,aAAa,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YACxF,OAAO;gBACL,iBAAiB,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB;gBACxD,aAAa;gBACb,OAAO;gBACP,UAAU;aACX,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/audiences/evaluator/condition-registry.d.ts

@@ -0,0 +1,31 @@
+import type { Condition, VisitorSignals } from '../types.js';
+type ConditionEvaluator = (condition: Condition, signals: VisitorSignals) => boolean;
+/**
+ * Register a custom condition type evaluator.
+ *
+ * @param name    - The condition `type` string this evaluator handles.
+ * @param evaluate - Pure function that returns `true` when the condition matches.
+ *
+ * Calling this with an already-registered name overwrites the previous evaluator.
+ */
+export declare function registerConditionType(name: string, evaluate: ConditionEvaluator): void;
+/**
+ * Remove a previously registered condition type evaluator.
+ * No-op if the name was never registered.
+ */
+export declare function unregisterConditionType(name: string): void;
+/**
+ * Evaluate a condition using a registered custom evaluator.
+ * Returns `false` if no evaluator is registered for the condition's type.
+ */
+export declare function evaluateCustomCondition(condition: Condition, signals: VisitorSignals): boolean;
+/**
+ * Returns true if a custom evaluator is registered for the given condition type name.
+ */
+export declare function hasConditionType(name: string): boolean;
+/**
+ * Returns the names of all registered custom condition types.
+ */
+export declare function listConditionTypes(): string[];
+export {};
+//# sourceMappingURL=condition-registry.d.ts.map

package/dist/audiences/evaluator/condition-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-registry.d.ts","sourceRoot":"","sources":["../../../src/audiences/evaluator/condition-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAe5D,KAAK,kBAAkB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAA;AAIpF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAEtF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAI9F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/dist/audiences/evaluator/condition-registry.js

@@ -0,0 +1,42 @@
+const registry = new Map();
+/**
+ * Register a custom condition type evaluator.
+ *
+ * @param name    - The condition `type` string this evaluator handles.
+ * @param evaluate - Pure function that returns `true` when the condition matches.
+ *
+ * Calling this with an already-registered name overwrites the previous evaluator.
+ */
+export function registerConditionType(name, evaluate) {
+    registry.set(name, evaluate);
+}
+/**
+ * Remove a previously registered condition type evaluator.
+ * No-op if the name was never registered.
+ */
+export function unregisterConditionType(name) {
+    registry.delete(name);
+}
+/**
+ * Evaluate a condition using a registered custom evaluator.
+ * Returns `false` if no evaluator is registered for the condition's type.
+ */
+export function evaluateCustomCondition(condition, signals) {
+    const evaluator = registry.get(condition.type);
+    if (!evaluator)
+        return false;
+    return evaluator(condition, signals);
+}
+/**
+ * Returns true if a custom evaluator is registered for the given condition type name.
+ */
+export function hasConditionType(name) {
+    return registry.has(name);
+}
+/**
+ * Returns the names of all registered custom condition types.
+ */
+export function listConditionTypes() {
+    return [...registry.keys()];
+}
+//# sourceMappingURL=condition-registry.js.map

package/dist/audiences/evaluator/condition-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-registry.js","sourceRoot":"","sources":["../../../src/audiences/evaluator/condition-registry.ts"],"names":[],"mappings":"AAiBA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAA;AAEtD;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,QAA4B;IAC9E,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB,EAAE,OAAuB;IACnF,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAC9C,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAA;IAC5B,OAAO,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;AAC7B,CAAC"}

package/dist/audiences/evaluator/glob.d.ts

@@ -0,0 +1,2 @@
+export declare function matchGlob(pattern: string, value: string): boolean;
+//# sourceMappingURL=glob.d.ts.map

package/dist/audiences/evaluator/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../src/audiences/evaluator/glob.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAsBjE"}

package/dist/audiences/evaluator/glob.js

@@ -0,0 +1,30 @@
+export function matchGlob(pattern, value) {
+    const parts = pattern.split('*');
+    if (parts.length === 1)
+        return pattern === value;
+    let pos = 0;
+    const first = parts[0];
+    if (first !== '') {
+        if (!value.startsWith(first))
+            return false;
+        pos = first.length;
+    }
+    for (let i = 1; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (part === '')
+            continue;
+        const idx = value.indexOf(part, pos);
+        if (idx < 0)
+            return false;
+        pos = idx + part.length;
+    }
+    const last = parts[parts.length - 1];
+    if (last !== '') {
+        if (!value.endsWith(last))
+            return false;
+        if (value.length - last.length < pos)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=glob.js.map

package/dist/audiences/evaluator/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../../src/audiences/evaluator/glob.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAa;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,KAAK,KAAK,CAAA;IAChD,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;IACvB,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACjB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAA;QAC1C,GAAG,GAAG,KAAK,CAAC,MAAM,CAAA;IACpB,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;QACtB,IAAI,IAAI,KAAK,EAAE;YAAE,SAAQ;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QACpC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,KAAK,CAAA;QACzB,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAA;IACzB,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAA;IACrC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAA;QACvC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG;YAAE,OAAO,KAAK,CAAA;IACpD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/audiences/evaluator/index.d.ts

@@ -0,0 +1,6 @@
+export { matchGlob } from './glob.js';
+export { evaluateInstantCondition, resolveSignalValue } from './instant-match.js';
+export { evaluateScoreConditions } from './score.js';
+export { resolveAudiences, type EvaluationTrace, type ConditionTrace, type ResolveResult } from './resolver.js';
+export { resolveAudienceTiebreaker } from './tiebreaker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/audiences/evaluator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/audiences/evaluator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAC/G,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/audiences/evaluator/index.js

@@ -0,0 +1,6 @@
+export { matchGlob } from './glob.js';
+export { evaluateInstantCondition, resolveSignalValue } from './instant-match.js';
+export { evaluateScoreConditions } from './score.js';
+export { resolveAudiences } from './resolver.js';
+export { resolveAudienceTiebreaker } from './tiebreaker.js';
+//# sourceMappingURL=index.js.map

package/dist/audiences/evaluator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/audiences/evaluator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAiE,MAAM,eAAe,CAAA;AAC/G,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/audiences/evaluator/instant-match.d.ts

@@ -0,0 +1,4 @@
+import type { VisitorSignals, InstantMatchCondition, InstantSignalRef } from '../types.js';
+export declare function resolveSignalValue(signals: VisitorSignals, ref: InstantSignalRef): string | null;
+export declare function evaluateInstantCondition(condition: InstantMatchCondition, signals: VisitorSignals): boolean;
+//# sourceMappingURL=instant-match.d.ts.map

package/dist/audiences/evaluator/instant-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant-match.d.ts","sourceRoot":"","sources":["../../../src/audiences/evaluator/instant-match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG1F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAqBhG;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,qBAAqB,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAgB3G"}

package/dist/audiences/evaluator/instant-match.js

@@ -0,0 +1,51 @@
+import { matchGlob } from './glob.js';
+export function resolveSignalValue(signals, ref) {
+    if (ref === 'utm.source')
+        return signals.utm.source;
+    if (ref === 'utm.medium')
+        return signals.utm.medium;
+    if (ref === 'utm.campaign')
+        return signals.utm.campaign;
+    if (ref === 'utm.term')
+        return signals.utm.term;
+    if (ref === 'utm.content')
+        return signals.utm.content;
+    if (ref === 'referrer.domain')
+        return signals.referrer.domain;
+    if (ref === 'referrer.sourceType')
+        return signals.referrer.sourceType;
+    if (ref === 'identity.isKnown')
+        return signals.identity.isKnown ? 'true' : 'false';
+    if (ref === 'session.entryPage')
+        return signals.session.entryPage;
+    if (ref === 'session.pagesVisited')
+        return signals.session.pagesVisited.join(',');
+    if (ref.startsWith('selfId.')) {
+        const key = ref.slice(7);
+        return signals.selfId[key] ?? null;
+    }
+    if (ref.startsWith('adapter.')) {
+        const key = ref.slice(8);
+        const val = signals.adapters[key];
+        return val !== undefined && val !== null ? String(val) : null;
+    }
+    return null;
+}
+export function evaluateInstantCondition(condition, signals) {
+    const actual = resolveSignalValue(signals, condition.signal);
+    const expected = condition.value;
+    switch (condition.operator) {
+        case 'equals': return actual === expected;
+        case 'not_equals': return actual !== expected;
+        case 'contains': return actual !== null && typeof expected === 'string' && actual.includes(expected);
+        case 'starts_with': return actual !== null && typeof expected === 'string' && actual.startsWith(expected);
+        case 'matches_glob': return actual !== null && typeof expected === 'string' && matchGlob(expected, actual);
+        case 'is_one_of': return actual !== null && Array.isArray(condition.value) && condition.value.includes(actual);
+        case 'is_true': return actual === 'true';
+        case 'is_false': return actual === 'false';
+        case 'gte': return actual !== null && typeof expected === 'string' && Number(actual) >= Number(expected);
+        case 'lte': return actual !== null && typeof expected === 'string' && Number(actual) <= Number(expected);
+        default: return false;
+    }
+}
+//# sourceMappingURL=instant-match.js.map

package/dist/audiences/evaluator/instant-match.js.map

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

package/dist/audiences/evaluator/resolver.d.ts

@@ -0,0 +1,24 @@
+import type { Audience, VisitorSignals } from '../types.js';
+export interface ConditionTrace {
+    conditionId: string;
+    type: 'instant' | 'score';
+    passed: boolean;
+    scoreContributed?: number;
+}
+export interface EvaluationTrace {
+    audienceId: string;
+    matched: boolean;
+    groupTraces: Array<{
+        groupId: string;
+        matched: boolean;
+        conditionTraces: ConditionTrace[];
+    }>;
+    totalScore?: number;
+}
+export interface ResolveResult {
+    winningAudienceId: string | null;
+    allMatchedIds: string[];
+    traces: EvaluationTrace[];
+}
+export declare function resolveAudiences(audiences: Audience[], signals: VisitorSignals): ResolveResult;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/audiences/evaluator/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/audiences/evaluator/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAqE,MAAM,aAAa,CAAA;AAK9H,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,SAAS,GAAG,OAAO,CAAA;IACzB,MAAM,EAAE,OAAO,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAA;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B;AA4CD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAoC9F"}

package/dist/audiences/evaluator/resolver.js

@@ -0,0 +1,79 @@
+import { evaluateInstantCondition } from './instant-match.js';
+import { evaluateScoreConditions } from './score.js';
+import { hasConditionType, evaluateCustomCondition } from './condition-registry.js';
+// Evaluate one group: AND all instant + custom conditions, accumulate score conditions
+function evaluateGroup(group, signals) {
+    const conditionTraces = [];
+    const instants = [];
+    const scores = [];
+    const customs = [];
+    for (const c of group.conditions) {
+        // The Condition union only models 'instant'/'score', but the registry
+        // dispatches custom condition kinds by their `type` string at runtime.
+        // Capture it as a string so the custom branch stays reachable.
+        const conditionType = c.type;
+        if (c.type === 'instant')
+            instants.push(c);
+        else if (c.type === 'score')
+            scores.push(c);
+        else if (hasConditionType(conditionType))
+            customs.push(c);
+        // Unknown types with no registered evaluator are silently skipped
+    }
+    let allInstantsPassed = true;
+    for (const ic of instants) {
+        const passed = evaluateInstantCondition(ic, signals);
+        conditionTraces.push({ conditionId: ic.id, type: 'instant', passed });
+        if (!passed)
+            allInstantsPassed = false;
+    }
+    // Custom conditions are ANDed with instant conditions
+    for (const cc of customs) {
+        const passed = evaluateCustomCondition(cc, signals);
+        conditionTraces.push({ conditionId: cc.id, type: cc.type, passed });
+        if (!passed)
+            allInstantsPassed = false;
+    }
+    const totalScore = evaluateScoreConditions(scores, signals);
+    for (const sc of scores) {
+        const contributed = evaluateScoreConditions([sc], signals);
+        conditionTraces.push({ conditionId: sc.id, type: 'score', passed: contributed > 0, scoreContributed: contributed });
+    }
+    return { matched: allInstantsPassed, conditionTraces, totalScore };
+}
+export function resolveAudiences(audiences, signals) {
+    const allMatchedIds = [];
+    const traces = [];
+    for (const audience of audiences) {
+        const groupTraces = [];
+        let audienceMatched = false;
+        let accumulatedScore = 0;
+        for (const group of audience.conditionGroups) {
+            const { matched, conditionTraces, totalScore } = evaluateGroup(group, signals);
+            accumulatedScore += totalScore;
+            groupTraces.push({ groupId: group.id, matched, conditionTraces });
+            if (matched)
+                audienceMatched = true;
+        }
+        if (audience.scoreThreshold !== null) {
+            const scoreThresholdMet = accumulatedScore >= audience.scoreThreshold;
+            const hasInstantConditions = audience.conditionGroups.some(g => g.conditions.some(c => c.type === 'instant'));
+            if (hasInstantConditions) {
+                audienceMatched = audienceMatched && scoreThresholdMet;
+            }
+            else {
+                audienceMatched = scoreThresholdMet;
+            }
+        }
+        traces.push({
+            audienceId: audience.id,
+            matched: audienceMatched,
+            groupTraces,
+            ...(accumulatedScore > 0 ? { totalScore: accumulatedScore } : {}),
+        });
+        if (audienceMatched)
+            allMatchedIds.push(audience.id);
+    }
+    return { winningAudienceId: allMatchedIds[0] ?? null, allMatchedIds, traces };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/audiences/evaluator/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/audiences/evaluator/resolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAsBnF,uFAAuF;AACvF,SAAS,aAAa,CAAC,KAAqB,EAAE,OAAuB;IACnE,MAAM,eAAe,GAAqB,EAAE,CAAA;IAC5C,MAAM,QAAQ,GAA4B,EAAE,CAAA;IAC5C,MAAM,MAAM,GAAiC,EAAE,CAAA;IAC/C,MAAM,OAAO,GAA4B,EAAE,CAAA;IAE3C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACjC,sEAAsE;QACtE,uEAAuE;QACvE,+DAA+D;QAC/D,MAAM,aAAa,GAAW,CAAC,CAAC,IAAI,CAAA;QACpC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;aACrC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;aACtC,IAAI,gBAAgB,CAAC,aAAa,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACzD,kEAAkE;IACpE,CAAC;IAED,IAAI,iBAAiB,GAAG,IAAI,CAAA;IAE5B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,wBAAwB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACpD,eAAe,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAA;QACrE,IAAI,CAAC,MAAM;YAAE,iBAAiB,GAAG,KAAK,CAAA;IACxC,CAAC;IAED,sDAAsD;IACtD,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,uBAAuB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACnD,eAAe,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAiB,EAAE,MAAM,EAAE,CAAC,CAAA;QAChF,IAAI,CAAC,MAAM;YAAE,iBAAiB,GAAG,KAAK,CAAA;IACxC,CAAC;IAED,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3D,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;QAC1D,eAAe,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAA;IACrH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,CAAA;AACpE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAqB,EAAE,OAAuB;IAC7E,MAAM,aAAa,GAAa,EAAE,CAAA;IAClC,MAAM,MAAM,GAAsB,EAAE,CAAA;IAEpC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,WAAW,GAAmC,EAAE,CAAA;QACtD,IAAI,eAAe,GAAG,KAAK,CAAA;QAC3B,IAAI,gBAAgB,GAAG,CAAC,CAAA;QAExB,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC7C,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAC9E,gBAAgB,IAAI,UAAU,CAAA;YAC9B,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAA;YACjE,IAAI,OAAO;gBAAE,eAAe,GAAG,IAAI,CAAA;QACrC,CAAC;QAED,IAAI,QAAQ,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,iBAAiB,GAAG,gBAAgB,IAAI,QAAQ,CAAC,cAAc,CAAA;YACrE,MAAM,oBAAoB,GAAG,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAA;YAC7G,IAAI,oBAAoB,EAAE,CAAC;gBACzB,eAAe,GAAG,eAAe,IAAI,iBAAiB,CAAA;YACxD,CAAC;iBAAM,CAAC;gBACN,eAAe,GAAG,iBAAiB,CAAA;YACrC,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,UAAU,EAAE,QAAQ,CAAC,EAAE;YACvB,OAAO,EAAE,eAAe;YACxB,WAAW;YACX,GAAG,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC,CAAA;QACF,IAAI,eAAe;YAAE,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,OAAO,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAA;AAC/E,CAAC"}

package/dist/audiences/evaluator/score.d.ts

@@ -0,0 +1,3 @@
+import type { VisitorSignals, ScoreContributionCondition } from '../types.js';
+export declare function evaluateScoreConditions(conditions: ScoreContributionCondition[], signals: VisitorSignals): number;
+//# sourceMappingURL=score.d.ts.map

package/dist/audiences/evaluator/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../../src/audiences/evaluator/score.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAyC7E,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,0BAA0B,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAIjH"}