@parchar/cross-promo 0.0.0-stage → 0.1.0

package/dist/element.js

@@ -0,0 +1,159 @@
+import { networkConfig } from './config';
+import { pickPromotionWithCap, readCapState, recordImpression, writeCapState } from './cap';
+import { promoMarkup, resolvePromo } from './render';
+import { utcDayBucket } from './select';
+import { trackPromoSelect, trackPromoView, } from './analytics';
+import { permissiveConsent } from './consent';
+const ELEMENT_NAME = 'parchar-promo';
+/**
+ * Live options: read at connect time so a host page can re-configure the
+ * network (and tests can swap consent) after the element is defined —
+ * custom elements cannot be redefined.
+ */
+let activeOptions = {
+    config: networkConfig,
+    analytics: { measurementId: null, consent: permissiveConsent },
+};
+function resolveOptions(options) {
+    return {
+        config: options.config ?? networkConfig,
+        analytics: {
+            measurementId: options.measurementId ?? null,
+            consent: options.consent ?? permissiveConsent,
+            excludedPathPrefixes: options.excludedPathPrefixes ?? [],
+            ...(options.analyticsOptions ?? {}),
+        },
+    };
+}
+function readLinkDataset(link) {
+    if (!link)
+        return null;
+    const version = Number(link.getAttribute('data-cp-config-version'));
+    if (!Number.isFinite(version))
+        return null;
+    return {
+        promotionId: link.getAttribute('data-cp-promotion-id') ?? '',
+        promotionName: link.getAttribute('data-cp-promotion-name') ?? '',
+        creativeName: link.getAttribute('data-cp-creative-name') ?? '',
+        creativeSlot: link.getAttribute('data-cp-creative-slot') ?? '',
+        locationId: link.getAttribute('data-cp-location-id') ?? '',
+        configVersion: version,
+    };
+}
+/** Renders the cap-aware pick into a container that already holds SSR markup. */
+function renderInto(container, host, slotId, format, locale) {
+    const { config } = activeOptions;
+    const day = utcDayBucket();
+    const selection = pickPromotionWithCap({
+        config,
+        hostSiteId: host,
+        slotId,
+        timeBucket: day,
+        locale,
+        capState: readCapState(),
+        seedExtra: String(Date.now()),
+    });
+    const promo = selection ? resolvePromo(config, selection, host, slotId) : null;
+    if (!promo)
+        return;
+    container.innerHTML = promoMarkup(promo, format);
+    wirePromoContainer(container);
+}
+/** Wires click + impression tracking to a container holding promo markup. */
+function wirePromoContainer(container) {
+    const link = container.querySelector('.cp-link');
+    if (!link)
+        return;
+    link.addEventListener('click', () => {
+        const payload = readLinkDataset(container.querySelector('.cp-link'));
+        if (payload)
+            trackPromoSelect(activeOptions.analytics, payload);
+    });
+    if (typeof IntersectionObserver === 'undefined')
+        return;
+    let viewTracked = false;
+    const observer = new IntersectionObserver((entries) => {
+        for (const entry of entries) {
+            if (!entry.isIntersecting || viewTracked)
+                continue;
+            if (entry.intersectionRatio < 0.5)
+                continue;
+            window.setTimeout(() => {
+                if (viewTracked)
+                    return;
+                const payload = readLinkDataset(container.querySelector('.cp-link'));
+                if (!payload)
+                    return;
+                if (!trackPromoView(activeOptions.analytics, payload))
+                    return;
+                viewTracked = true;
+                writeCapState(recordImpression(readCapState(), payload.promotionId, utcDayBucket()));
+            }, 1000);
+        }
+    }, { threshold: [0.5] });
+    observer.observe(container);
+}
+/**
+ * Registers the `<parchar-promo>` element for embed hosts (static sites).
+ * Options also become the live configuration for in-place enhancement.
+ */
+export function defineParcharPromo(options = {}) {
+    activeOptions = resolveOptions(options);
+    if (typeof window === 'undefined' || typeof customElements === 'undefined')
+        return;
+    if (customElements.get(ELEMENT_NAME))
+        return;
+    class ParcharPromoElement extends HTMLElement {
+        connectedCallback() {
+            const host = this.getAttribute('host') ?? '';
+            const slotId = this.getAttribute('slot-id') ?? '';
+            const format = (this.getAttribute('format') ?? 'band');
+            const locale = this.getAttribute('locale') ?? activeOptions.config.defaultLocale;
+            if (!host || !slotId)
+                return;
+            renderInto(this, host, slotId, format, locale);
+        }
+    }
+    customElements.define(ELEMENT_NAME, ParcharPromoElement);
+}
+const ENHANCED_FLAG = 'data-cp-enhanced';
+/**
+ * In-place enhancement for server-rendered slots: the SvelteKit apps render a
+ * placeholder div with deterministic SSR markup; this applies the visitor's
+ * cap state (substituting the creative when the server pick is capped) and
+ * wires GA4 view/click events without disturbing Svelte's ownership of the
+ * surrounding tree. Idempotent; safe to call after every client navigation.
+ */
+export function enhanceCrossPromoPlaceholders(root = document) {
+    if (typeof window === 'undefined')
+        return;
+    for (const placeholder of Array.from(root.querySelectorAll(`[data-parchar-promo]:not([${ENHANCED_FLAG}])`))) {
+        const container = placeholder;
+        container.setAttribute(ENHANCED_FLAG, 'true');
+        const host = container.getAttribute('data-cp-host') ?? '';
+        const slotId = container.getAttribute('data-cp-slot') ?? '';
+        const format = (container.getAttribute('data-cp-format') ?? 'band');
+        const locale = container.getAttribute('data-cp-locale') ?? activeOptions.config.defaultLocale;
+        if (!host || !slotId)
+            continue;
+        const { config } = activeOptions;
+        const day = utcDayBucket();
+        const current = container.querySelector('.cp-link')?.getAttribute('data-cp-promotion-id');
+        const selection = pickPromotionWithCap({
+            config,
+            hostSiteId: host,
+            slotId,
+            timeBucket: day,
+            locale,
+            capState: readCapState(),
+            seedExtra: String(Date.now()),
+        });
+        if (selection && selection.siteId !== current) {
+            const promo = resolvePromo(config, selection, host, slotId);
+            if (promo)
+                container.innerHTML = promoMarkup(promo, format);
+        }
+        wirePromoContainer(container);
+    }
+}
+//# sourceMappingURL=element.js.map

package/dist/element.js.map

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

package/dist/embed-entry.d.ts

@@ -0,0 +1,7 @@
+declare global {
+    interface Window {
+        __parcharCpConsent?: () => 'granted' | 'denied' | boolean | undefined;
+    }
+}
+export {};
+//# sourceMappingURL=embed-entry.d.ts.map

package/dist/embed-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-entry.d.ts","sourceRoot":"","sources":["../src/embed-entry.ts"],"names":[],"mappings":"AA4BA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,kBAAkB,CAAC,EAAE,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;KACvE;CACF"}

package/dist/embed-entry.js

@@ -0,0 +1,31 @@
+import { defineParcharPromo } from './element';
+import { gatedConsent } from './consent';
+/**
+ * Standalone embed entry for static sites (soypolkadot.com, artmax.club).
+ * Configure via attributes on the script tag:
+ *
+ *   <script
+ *     src="https://cdn.jsdelivr.net/npm/@parchar/cross-promo@X/embed/iife.js"
+ *     data-cp-ga-id="G-XXXXXXXXXX"
+ *     data-cp-consent="gate"
+ *     crossorigin="anonymous"
+ *     integrity="sha384-..."
+ *     defer></script>
+ *
+ * data-cp-consent: omit for permissive first-party behavior; "gate" defers to
+ * window.__parcharCpConsent() (return 'granted' | 'denied'), which hosts with
+ * a cookie-preference banner provide.
+ */
+function currentScript() {
+    if (typeof document === 'undefined')
+        return null;
+    return document.currentScript instanceof HTMLElement ? document.currentScript : null;
+}
+const script = currentScript();
+const gaId = script?.getAttribute('data-cp-ga-id') ?? null;
+const consentMode = script?.getAttribute('data-cp-consent');
+const consent = consentMode === 'gate'
+    ? gatedConsent(() => window.__parcharCpConsent?.())
+    : undefined;
+defineParcharPromo({ measurementId: gaId, consent });
+//# sourceMappingURL=embed-entry.js.map

package/dist/embed-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-entry.js","sourceRoot":"","sources":["../src/embed-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;;;;;;GAeG;AACH,SAAS,aAAa;IACpB,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,QAAQ,CAAC,aAAa,YAAY,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;AACvF,CAAC;AAED,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;AAC/B,MAAM,IAAI,GAAG,MAAM,EAAE,YAAY,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC;AAC3D,MAAM,WAAW,GAAG,MAAM,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAQ5D,MAAM,OAAO,GACX,WAAW,KAAK,MAAM;IACpB,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,CAAC;IACnD,CAAC,CAAC,SAAS,CAAC;AAEhB,kBAAkB,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { networkConfig } from './config';
+export { parseNetworkConfig, validateNetworkConfig } from './validate';
+export type { CrossPromoCreative, CrossPromoFormat, CrossPromoLocale, CrossPromoPlacement, CrossPromoSite, CrossPromoSiteRole, NetworkConfig, PromotionSelection, ResolvedPromo, } from './types';
+export { configuredShares, hashString, mulberry32, pickCreativeForLocale, pickPromotion, promotionCandidates, totalWeight, utcDayBucket, } from './select';
+export { isCapped, pickPromotionWithCap, readCapState, recordImpression, writeCapState, type CapState, } from './cap';
+export { buildPromoUrl, promoMarkup, resolvePromo, resolveServerPromo, type ServerPromoInput, } from './render';
+export { defaultAnalyticsOptions, ensureNetworkGtag, isLocalHostname, shouldSkipPromoAnalytics, trackPromoSelect, trackPromoView, type CrossPromoAnalyticsOptions, type PromoEventPayload, } from './analytics';
+export { gatedConsent, permissiveConsent, type ConsentProvider, type PromoConsent } from './consent';
+export { defineParcharPromo, enhanceCrossPromoPlaceholders, type DefineParcharPromoOptions, } from './element';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,KAAK,QAAQ,GACd,MAAM,OAAO,CAAC;AACf,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACrG,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { networkConfig } from './config';
+export { parseNetworkConfig, validateNetworkConfig } from './validate';
+export { configuredShares, hashString, mulberry32, pickCreativeForLocale, pickPromotion, promotionCandidates, totalWeight, utcDayBucket, } from './select';
+export { isCapped, pickPromotionWithCap, readCapState, recordImpression, writeCapState, } from './cap';
+export { buildPromoUrl, promoMarkup, resolvePromo, resolveServerPromo, } from './render';
+export { defaultAnalyticsOptions, ensureNetworkGtag, isLocalHostname, shouldSkipPromoAnalytics, trackPromoSelect, trackPromoView, } from './analytics';
+export { gatedConsent, permissiveConsent } from './consent';
+export { defineParcharPromo, enhanceCrossPromoPlaceholders, } from './element';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAYvE,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,aAAa,GAEd,MAAM,OAAO,CAAC;AACf,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,kBAAkB,GAEnB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,GAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAA2C,MAAM,WAAW,CAAC;AACrG,OAAO,EACL,kBAAkB,EAClB,6BAA6B,GAE9B,MAAM,WAAW,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,33 @@
+import type { CrossPromoFormat, NetworkConfig, PromotionSelection, ResolvedPromo } from './types';
+export interface BuildPromoUrlInput {
+    baseUrl: string;
+    hostSiteId: string;
+    variant: string;
+    slotId: string;
+    medium: string;
+    campaign: string;
+}
+/** Outbound URL with full UTM attribution; hosts that drop params keep the click-side event. */
+export declare function buildPromoUrl(input: BuildPromoUrlInput): string;
+export declare function resolvePromo(config: NetworkConfig, selection: PromotionSelection, hostSiteId: string, slotId: string): ResolvedPromo | null;
+export interface ServerPromoInput {
+    config: NetworkConfig;
+    hostSiteId: string;
+    slotId: string;
+    format: CrossPromoFormat;
+    locale: string;
+    date?: Date;
+}
+export interface ServerPromoResult {
+    promo: ResolvedPromo;
+    markup: string;
+}
+/** Deterministic server-side resolve + markup for one slot (SSR / no-JS path). */
+export declare function resolveServerPromo(input: ServerPromoInput): ServerPromoResult | null;
+/**
+ * Single source of promo markup, shared by the Svelte SSR path and the custom
+ * element. All config-sourced strings are HTML-escaped; only this builder may
+ * produce promo markup.
+ */
+export declare function promoMarkup(promo: ResolvedPromo, format: CrossPromoFormat): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAiBlG,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAO/D;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,IAAI,CA2BtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,IAAI,CAYpF;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAwClF"}

package/dist/render.js

@@ -0,0 +1,112 @@
+import { pickPromotion, utcDayBucket } from './select';
+const NETWORK_LABELS = {
+    es: 'Recomendado',
+    en: 'Recommended',
+};
+function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}
+/** Outbound URL with full UTM attribution; hosts that drop params keep the click-side event. */
+export function buildPromoUrl(input) {
+    const url = new URL(input.baseUrl);
+    url.searchParams.set('utm_source', input.hostSiteId);
+    url.searchParams.set('utm_medium', input.medium);
+    url.searchParams.set('utm_campaign', input.campaign);
+    url.searchParams.set('utm_content', `${input.variant}:${input.slotId}`);
+    return url.toString();
+}
+export function resolvePromo(config, selection, hostSiteId, slotId) {
+    const site = config.sites.find((entry) => entry.id === selection.siteId);
+    const creative = config.creatives.find((entry) => entry.id === selection.creativeId);
+    if (!site || !creative)
+        return null;
+    return {
+        siteId: site.id,
+        siteName: site.name,
+        creativeId: creative.id,
+        variant: creative.variant,
+        creativeSlot: `${hostSiteId}/${slotId}`,
+        locationId: hostSiteId,
+        configVersion: config.version,
+        headline: creative.headline,
+        blurb: creative.blurb,
+        cta: creative.cta,
+        accent: creative.accent,
+        locale: creative.locale,
+        url: buildPromoUrl({
+            baseUrl: site.url,
+            hostSiteId,
+            variant: creative.variant,
+            slotId,
+            medium: config.medium,
+            campaign: config.campaign,
+        }),
+    };
+}
+/** Deterministic server-side resolve + markup for one slot (SSR / no-JS path). */
+export function resolveServerPromo(input) {
+    const selection = pickPromotion({
+        config: input.config,
+        hostSiteId: input.hostSiteId,
+        slotId: input.slotId,
+        timeBucket: utcDayBucket(input.date),
+        locale: input.locale,
+    });
+    if (!selection)
+        return null;
+    const promo = resolvePromo(input.config, selection, input.hostSiteId, input.slotId);
+    if (!promo)
+        return null;
+    return { promo, markup: promoMarkup(promo, input.format) };
+}
+function labelFor(locale, fallback) {
+    return NETWORK_LABELS[locale] ?? NETWORK_LABELS[fallback] ?? 'Recomendado';
+}
+/**
+ * Single source of promo markup, shared by the Svelte SSR path and the custom
+ * element. All config-sourced strings are HTML-escaped; only this builder may
+ * produce promo markup.
+ */
+export function promoMarkup(promo, format) {
+    const label = labelFor(promo.locale, 'es');
+    const attrs = [
+        `class="cp-link"`,
+        `href="${escapeHtml(promo.url)}"`,
+        `data-cp-promotion-id="${escapeHtml(promo.siteId)}"`,
+        `data-cp-promotion-name="${escapeHtml(promo.siteName)}"`,
+        `data-cp-creative-name="${escapeHtml(promo.variant)}"`,
+        `data-cp-creative-slot="${escapeHtml(promo.creativeSlot)}"`,
+        `data-cp-location-id="${escapeHtml(promo.locationId)}"`,
+        `data-cp-config-version="${promo.configVersion}"`,
+    ].join(' ');
+    const accent = escapeHtml(promo.accent);
+    if (format === 'strip') {
+        return `<div class="cp cp--strip" style="--cp-accent:${accent}">
+  <span class="cp-label">${escapeHtml(label)}</span>
+  <a ${attrs} rel="noopener">${escapeHtml(promo.headline)}</a>
+  <span class="cp-cta" aria-hidden="true">${escapeHtml(promo.cta)} →</span>
+</div>`;
+    }
+    if (format === 'card') {
+        return `<div class="cp cp--card" style="--cp-accent:${accent}">
+  <p class="cp-label">${escapeHtml(label)}</p>
+  <p class="cp-headline">${escapeHtml(promo.headline)}</p>
+  <p class="cp-blurb">${escapeHtml(promo.blurb)}</p>
+  <a ${attrs} rel="noopener"><span class="cp-cta">${escapeHtml(promo.cta)} →</span></a>
+</div>`;
+    }
+    return `<div class="cp cp--band" style="--cp-accent:${accent}">
+  <div class="cp-copy">
+    <p class="cp-label">${escapeHtml(label)}</p>
+    <p class="cp-headline">${escapeHtml(promo.headline)}</p>
+    <p class="cp-blurb">${escapeHtml(promo.blurb)}</p>
+  </div>
+  <a ${attrs} rel="noopener"><span class="cp-cta">${escapeHtml(promo.cta)} →</span></a>
+</div>`;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/select.d.ts

@@ -0,0 +1,43 @@
+import type { NetworkConfig, PromotionSelection } from './types';
+/** FNV-1a 32-bit hash: stable across runtimes, good enough to seed a PRNG. */
+export declare function hashString(value: string): number;
+/** Deterministic PRNG (mulberry32) so SSR picks are reproducible per bucket. */
+export declare function mulberry32(seed: number): () => number;
+/** UTC day bucket so cached SSR HTML stays coherent within a day. */
+export declare function utcDayBucket(date?: Date): string;
+export interface PromotionCandidates {
+    siteIds: string[];
+    weights: Map<string, number>;
+    creatives: Map<string, string[]>;
+}
+/**
+ * Destination candidates for a render: sites with the destination role,
+ * excluding the host itself, renormalizing the remaining weights
+ * proportionally among the rest.
+ */
+export declare function promotionCandidates(config: NetworkConfig, hostSiteId: string): PromotionCandidates;
+export declare function totalWeight(candidates: PromotionCandidates): number;
+export interface PickPromotionInput {
+    config: NetworkConfig;
+    hostSiteId: string;
+    slotId: string;
+    timeBucket: string;
+    /** Extra entropy for client-side substitutions; keep undefined for SSR. */
+    seedExtra?: string;
+    locale: string;
+}
+/**
+ * Pure weighted selection of a destination + creative for one slot render.
+ * Deterministic given (config.version, slotId, timeBucket, seedExtra): the
+ * same cached SSR HTML therefore serves the same creative within a bucket.
+ * The creative follows the locale with Spanish fallback.
+ */
+export declare function pickPromotion(input: PickPromotionInput): PromotionSelection | null;
+/** Locale-aware creative choice with default-locale fallback. */
+export declare function pickCreativeForLocale(creativeIds: string[], config: NetworkConfig, locale: string): string | undefined;
+/**
+ * Expected impression share of each destination across the whole network
+ * (before self-exclusion), for share-vs-target observability and tests.
+ */
+export declare function configuredShares(config: NetworkConfig): Map<string, number>;
+//# sourceMappingURL=select.d.ts.map

package/dist/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../src/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEjE,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CASrD;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAE5D;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,GACjB,mBAAmB,CAerB;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAKnE;AAgBD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI,CAelF;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAU3E"}

package/dist/select.js

@@ -0,0 +1,106 @@
+/** FNV-1a 32-bit hash: stable across runtimes, good enough to seed a PRNG. */
+export function hashString(value) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return hash >>> 0;
+}
+/** Deterministic PRNG (mulberry32) so SSR picks are reproducible per bucket. */
+export function mulberry32(seed) {
+    let state = seed >>> 0;
+    return () => {
+        state = (state + 0x6d2b79f5) >>> 0;
+        let t = state;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/** UTC day bucket so cached SSR HTML stays coherent within a day. */
+export function utcDayBucket(date = new Date()) {
+    return date.toISOString().slice(0, 10);
+}
+/**
+ * Destination candidates for a render: sites with the destination role,
+ * excluding the host itself, renormalizing the remaining weights
+ * proportionally among the rest.
+ */
+export function promotionCandidates(config, hostSiteId) {
+    const weights = new Map();
+    const creatives = new Map();
+    const siteIds = [];
+    for (const site of config.sites) {
+        if (!site.roles.includes('destination'))
+            continue;
+        if (site.id === hostSiteId)
+            continue;
+        if (site.weight <= 0 || site.creatives.length === 0)
+            continue;
+        siteIds.push(site.id);
+        weights.set(site.id, site.weight);
+        creatives.set(site.id, site.creatives);
+    }
+    return { siteIds, weights, creatives };
+}
+export function totalWeight(candidates) {
+    return candidates.siteIds.reduce((sum, siteId) => sum + (candidates.weights.get(siteId) ?? 0), 0);
+}
+function weightedPick(siteIds, weights, roll) {
+    const total = siteIds.reduce((sum, siteId) => sum + (weights.get(siteId) ?? 0), 0);
+    let cursor = roll * total;
+    for (const siteId of siteIds) {
+        cursor -= weights.get(siteId) ?? 0;
+        if (cursor < 0)
+            return siteId;
+    }
+    return siteIds[siteIds.length - 1] ?? siteIds[0] ?? '';
+}
+/**
+ * Pure weighted selection of a destination + creative for one slot render.
+ * Deterministic given (config.version, slotId, timeBucket, seedExtra): the
+ * same cached SSR HTML therefore serves the same creative within a bucket.
+ * The creative follows the locale with Spanish fallback.
+ */
+export function pickPromotion(input) {
+    const { config, hostSiteId, slotId, timeBucket, seedExtra, locale } = input;
+    const candidates = promotionCandidates(config, hostSiteId);
+    if (candidates.siteIds.length === 0)
+        return null;
+    const seedSource = seedExtra
+        ? `${config.version}|${slotId}|${timeBucket}|${seedExtra}`
+        : `${config.version}|${slotId}|${timeBucket}`;
+    const rng = mulberry32(hashString(seedSource));
+    const siteId = weightedPick(candidates.siteIds, candidates.weights, rng());
+    const creativeIds = candidates.creatives.get(siteId) ?? [];
+    const creativeId = pickCreativeForLocale(creativeIds, config, locale);
+    if (!creativeId)
+        return null;
+    return { siteId, creativeId };
+}
+/** Locale-aware creative choice with default-locale fallback. */
+export function pickCreativeForLocale(creativeIds, config, locale) {
+    const byId = new Map(config.creatives.map((creative) => [creative.id, creative]));
+    const exact = creativeIds.find((id) => byId.get(id)?.locale === locale);
+    if (exact)
+        return exact;
+    return creativeIds.find((id) => byId.get(id)?.locale === config.defaultLocale);
+}
+/**
+ * Expected impression share of each destination across the whole network
+ * (before self-exclusion), for share-vs-target observability and tests.
+ */
+export function configuredShares(config) {
+    const total = config.sites
+        .filter((site) => site.roles.includes('destination'))
+        .reduce((sum, site) => sum + site.weight, 0);
+    const shares = new Map();
+    for (const site of config.sites) {
+        if (!site.roles.includes('destination'))
+            continue;
+        shares.set(site.id, site.weight / total);
+    }
+    return shares;
+}
+//# sourceMappingURL=select.js.map

package/dist/select.js.map

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