@parchar/cross-promo 0.0.0-stage → 0.1.0

package/dist/analytics.d.ts

@@ -0,0 +1,47 @@
+import type { ConsentProvider } from './consent';
+declare global {
+    interface Window {
+        dataLayer?: unknown[];
+        gtag?: (...args: unknown[]) => void;
+    }
+}
+export interface PromoEventPayload {
+    promotionId: string;
+    promotionName: string;
+    creativeName: string;
+    creativeSlot: string;
+    locationId: string;
+    configVersion: number;
+}
+export interface CrossPromoAnalyticsOptions {
+    /** Network GA4 measurement id; null disables measurement (render still works). */
+    measurementId: string | null;
+    consent?: ConsentProvider;
+    excludedPathPrefixes?: string[];
+    /**
+     * Location source, injectable for tests and non-DOM runtimes. Defaults to
+     * window.location when present.
+     */
+    getLocation?: () => {
+        hostname: string;
+        pathname: string;
+    };
+}
+/**
+ * Ensure a gtag runtime exists for the network measurement id. Reuses the
+ * host's dataLayer/gtag when present (gtag.js routes by config id), and only
+ * injects a loader when this id has none — so a host's own analytics setup is
+ * never altered.
+ */
+export declare function ensureNetworkGtag(measurementId: string | null): boolean;
+export declare function isLocalHostname(hostname: string): boolean;
+export declare function shouldSkipPromoAnalytics(options: Pick<CrossPromoAnalyticsOptions, 'excludedPathPrefixes'>, hostname: string, pathname: string): boolean;
+/** GA4 promotion impression (fires at most once per slot per page view). */
+export declare function trackPromoView(options: CrossPromoAnalyticsOptions, payload: PromoEventPayload): boolean;
+/**
+ * GA4 promotion click. Fired synchronously on click; gtag.js delivers queued
+ * events via sendBeacon-class transport that survives the outbound navigation.
+ */
+export declare function trackPromoSelect(options: CrossPromoAnalyticsOptions, payload: PromoEventPayload): boolean;
+export declare function defaultAnalyticsOptions(measurementId: string | null): CrossPromoAnalyticsOptions;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGjD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;KACrC;CACF;AAID,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,kFAAkF;IAClF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAiBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAuBvE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,IAAI,CAAC,0BAA0B,EAAE,sBAAsB,CAAC,EACjE,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAKT;AAgCD,4EAA4E;AAC5E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAET;AAED,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,0BAA0B,CAE5B"}

package/dist/analytics.js

@@ -0,0 +1,93 @@
+import { permissiveConsent } from './consent';
+const NETWORK_GROUP = 'parchar-cross-promo';
+function currentLocation(options) {
+    if (options.getLocation)
+        return options.getLocation();
+    if (typeof window !== 'undefined' && window.location) {
+        return { hostname: window.location.hostname, pathname: window.location.pathname };
+    }
+    return { hostname: '', pathname: '/' };
+}
+function gtagLoaderPresent(measurementId) {
+    if (typeof document === 'undefined')
+        return true;
+    return Boolean(document.querySelector(`script[src*="${measurementId}"]`));
+}
+/**
+ * Ensure a gtag runtime exists for the network measurement id. Reuses the
+ * host's dataLayer/gtag when present (gtag.js routes by config id), and only
+ * injects a loader when this id has none — so a host's own analytics setup is
+ * never altered.
+ */
+export function ensureNetworkGtag(measurementId) {
+    if (typeof window === 'undefined')
+        return false;
+    if (!measurementId)
+        return false;
+    window.dataLayer = window.dataLayer ?? [];
+    window.gtag =
+        window.gtag ??
+            ((...args) => {
+                window.dataLayer?.push(args);
+            });
+    if (!gtagLoaderPresent(measurementId)) {
+        const script = document.createElement('script');
+        script.async = true;
+        script.src = `https://www.googletagmanager.com/gtag/js?id=${measurementId}`;
+        document.head.appendChild(script);
+    }
+    window.gtag('config', measurementId, {
+        send_page_view: false,
+        groups: NETWORK_GROUP,
+    });
+    return true;
+}
+export function isLocalHostname(hostname) {
+    return hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '[::1]';
+}
+export function shouldSkipPromoAnalytics(options, hostname, pathname) {
+    if (isLocalHostname(hostname))
+        return true;
+    return (options.excludedPathPrefixes ?? []).some((prefix) => pathname === prefix || pathname.startsWith(`${prefix}/`));
+}
+function eventParams(payload) {
+    return {
+        promotion_id: payload.promotionId,
+        promotion_name: payload.promotionName,
+        creative_name: payload.creativeName,
+        creative_slot: payload.creativeSlot,
+        location_id: payload.locationId,
+        cp_config_version: payload.configVersion,
+        send_to: NETWORK_GROUP,
+    };
+}
+function emit(options, name, payload) {
+    if (typeof window === 'undefined')
+        return false;
+    if (!options.measurementId)
+        return false;
+    if (options.consent?.() === 'denied')
+        return false;
+    const location = currentLocation(options);
+    if (shouldSkipPromoAnalytics(options, location.hostname, location.pathname)) {
+        return false;
+    }
+    ensureNetworkGtag(options.measurementId);
+    window.gtag?.('event', name, eventParams(payload));
+    return true;
+}
+/** GA4 promotion impression (fires at most once per slot per page view). */
+export function trackPromoView(options, payload) {
+    return emit(options, 'view_promotion', payload);
+}
+/**
+ * GA4 promotion click. Fired synchronously on click; gtag.js delivers queued
+ * events via sendBeacon-class transport that survives the outbound navigation.
+ */
+export function trackPromoSelect(options, payload) {
+    return emit(options, 'select_promotion', payload);
+}
+export function defaultAnalyticsOptions(measurementId) {
+    return { measurementId, consent: permissiveConsent };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAS9C,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAuB5C,SAAS,eAAe,CACtB,OAAmC;IAEnC,IAAI,OAAO,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC;IACtD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACpF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,iBAAiB,CAAC,aAAqB;IAC9C,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,gBAAgB,aAAa,IAAI,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,aAA4B;IAC5D,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IAEjC,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,MAAM,CAAC,IAAI;QACT,MAAM,CAAC,IAAI;YACX,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE;gBACtB,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;IAEL,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,MAAM,CAAC,GAAG,GAAG,+CAA+C,aAAa,EAAE,CAAC;QAC5E,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE;QACnC,cAAc,EAAE,KAAK;QACrB,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,OAAO,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAAiE,EACjE,QAAgB,EAChB,QAAgB;IAEhB,IAAI,eAAe,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,CAAC,OAAO,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,IAAI,CAC9C,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,KAAK,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CACrE,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,OAA0B;IAC7C,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,WAAW;QACjC,cAAc,EAAE,OAAO,CAAC,aAAa;QACrC,aAAa,EAAE,OAAO,CAAC,YAAY;QACnC,aAAa,EAAE,OAAO,CAAC,YAAY;QACnC,WAAW,EAAE,OAAO,CAAC,UAAU;QAC/B,iBAAiB,EAAE,OAAO,CAAC,aAAa;QACxC,OAAO,EAAE,aAAa;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CACX,OAAmC,EACnC,IAA2C,EAC3C,OAA0B;IAE1B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,CAAC,OAAO,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iBAAiB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACzC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAC5B,OAAmC,EACnC,OAA0B;IAE1B,OAAO,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAmC,EACnC,OAA0B;IAE1B,OAAO,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,aAA4B;IAE5B,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AACvD,CAAC"}

package/dist/cap.d.ts

@@ -0,0 +1,28 @@
+import type { NetworkConfig, PromotionSelection } from './types';
+export interface CapDayState {
+    day: string;
+    count: number;
+    lastShown: number;
+}
+export type CapState = Record<string, CapDayState>;
+export declare function readCapState(): CapState;
+export declare function writeCapState(state: CapState): void;
+export declare function isCapped(state: CapState, siteId: string, day: string, capPerDay: number): boolean;
+export declare function recordImpression(state: CapState, siteId: string, day: string, now?: number): CapState;
+export interface PickWithCapInput {
+    config: NetworkConfig;
+    hostSiteId: string;
+    slotId: string;
+    timeBucket: string;
+    locale: string;
+    capState: CapState;
+    seedExtra?: string;
+}
+/**
+ * Client-side cap-aware selection: the deterministic server pick first; when
+ * it is capped for this visitor, pick among uncapped alternatives with the
+ * same weighted mechanism; when everything is capped, fall back to the
+ * least-recently-shown destination so the slot still renders.
+ */
+export declare function pickPromotionWithCap(input: PickWithCapInput): PromotionSelection | null;
+//# sourceMappingURL=cap.d.ts.map

package/dist/cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cap.d.ts","sourceRoot":"","sources":["../src/cap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAWjE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAoBnD,wBAAgB,YAAY,IAAI,QAAQ,CAYvC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAQnD;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAGT;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAmB,GACvB,QAAQ,CASV;AAeD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,IAAI,CAiDvF"}

package/dist/cap.js

@@ -0,0 +1,112 @@
+import { hashString, mulberry32, pickCreativeForLocale, pickPromotion, promotionCandidates, } from './select';
+const STORAGE_KEY = 'parchar-cross-promo-cap-v1';
+function storage() {
+    try {
+        const candidate = globalThis.localStorage;
+        if (!candidate)
+            return null;
+        const probe = '__parchar_cp_probe__';
+        candidate.setItem(probe, probe);
+        candidate.removeItem(probe);
+        return candidate;
+    }
+    catch {
+        return null;
+    }
+}
+export function readCapState() {
+    const store = storage();
+    if (!store)
+        return {};
+    try {
+        const raw = store.getItem(STORAGE_KEY);
+        if (!raw)
+            return {};
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null)
+            return {};
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+export function writeCapState(state) {
+    const store = storage();
+    if (!store)
+        return;
+    try {
+        store.setItem(STORAGE_KEY, JSON.stringify(state));
+    }
+    catch {
+        // Private-mode quota failures must never break rendering.
+    }
+}
+export function isCapped(state, siteId, day, capPerDay) {
+    const entry = state[siteId];
+    return entry?.day === day && entry.count >= capPerDay;
+}
+export function recordImpression(state, siteId, day, now = Date.now()) {
+    const entry = state[siteId];
+    const next = { ...state };
+    if (entry?.day === day) {
+        next[siteId] = { day, count: entry.count + 1, lastShown: now };
+    }
+    else {
+        next[siteId] = { day, count: 1, lastShown: now };
+    }
+    return next;
+}
+function leastRecentlyShown(state, siteIds, day) {
+    const ordered = [...siteIds].sort((a, b) => {
+        const entryA = state[a]?.day === day ? state[a].lastShown : 0;
+        const entryB = state[b]?.day === day ? state[b].lastShown : 0;
+        return entryA - entryB;
+    });
+    return ordered[0] ?? siteIds[0] ?? '';
+}
+/**
+ * Client-side cap-aware selection: the deterministic server pick first; when
+ * it is capped for this visitor, pick among uncapped alternatives with the
+ * same weighted mechanism; when everything is capped, fall back to the
+ * least-recently-shown destination so the slot still renders.
+ */
+export function pickPromotionWithCap(input) {
+    const { config, hostSiteId, slotId, timeBucket, locale, capState, seedExtra } = input;
+    const candidates = promotionCandidates(config, hostSiteId);
+    if (candidates.siteIds.length === 0)
+        return null;
+    // Primary pick mirrors the server exactly (no extra entropy) so hydration
+    // agrees with SSR HTML; seedExtra only feeds the cap-substitution path.
+    const primary = pickPromotion({
+        config,
+        hostSiteId,
+        slotId,
+        timeBucket,
+        locale,
+    });
+    if (primary && !isCapped(capState, primary.siteId, timeBucket, config.capPerDay)) {
+        return primary;
+    }
+    const uncapped = candidates.siteIds.filter((siteId) => !isCapped(capState, siteId, timeBucket, config.capPerDay));
+    if (uncapped.length === 0) {
+        const fallbackSite = leastRecentlyShown(capState, candidates.siteIds, timeBucket);
+        const creativeId = pickCreativeForLocale(candidates.creatives.get(fallbackSite) ?? [], config, locale);
+        return creativeId ? { siteId: fallbackSite, creativeId } : null;
+    }
+    const rng = mulberry32(hashString(`${config.version}|${slotId}|${timeBucket}|cap|${seedExtra ?? ''}`));
+    const weights = new Map(uncapped.map((siteId) => [siteId, candidates.weights.get(siteId) ?? 0]));
+    const total = uncapped.reduce((sum, siteId) => sum + (weights.get(siteId) ?? 0), 0);
+    let cursor = rng() * total;
+    let chosen = uncapped[uncapped.length - 1] ?? uncapped[0] ?? '';
+    for (const siteId of uncapped) {
+        cursor -= weights.get(siteId) ?? 0;
+        if (cursor < 0) {
+            chosen = siteId;
+            break;
+        }
+    }
+    const creativeId = pickCreativeForLocale(candidates.creatives.get(chosen) ?? [], config, locale);
+    return creativeId ? { siteId: chosen, creativeId } : null;
+}
+//# sourceMappingURL=cap.js.map

package/dist/cap.js.map

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

package/dist/config/network.json

@@ -0,0 +1,230 @@
+{
+    "version": 1,
+    "medium": "cross-promo",
+    "campaign": "parchar-network",
+    "defaultLocale": "es",
+    "capPerDay": 3,
+    "sites": [
+        {
+            "id": "becas-parchar-ai",
+            "name": "becas.parchar.ai",
+            "url": "https://becas.parchar.ai/",
+            "roles": ["display", "destination"],
+            "weight": 35,
+            "placements": [
+                { "id": "home-band", "format": "band" },
+                { "id": "explorar-in-feed", "format": "card" },
+                { "id": "beca-detail-mid", "format": "band" },
+                { "id": "pre-footer", "format": "strip" }
+            ],
+            "creatives": ["becas-evergreen-es", "becas-evergreen-en"]
+        },
+        {
+            "id": "parchar-ai",
+            "name": "parchar.ai",
+            "url": "https://parchar.ai/",
+            "roles": ["display", "destination"],
+            "weight": 35,
+            "placements": [
+                { "id": "home-band", "format": "band" },
+                { "id": "explorar-in-feed", "format": "card" },
+                { "id": "event-detail-mid", "format": "band" },
+                { "id": "pre-footer", "format": "strip" }
+            ],
+            "creatives": ["eventos-evergreen-es", "eventos-evergreen-en"]
+        },
+        {
+            "id": "medium-horacio",
+            "name": "Medium @horacioreyesrios",
+            "url": "https://medium.com/@horacioreyesrios",
+            "roles": ["destination"],
+            "weight": 10,
+            "placements": [],
+            "creatives": ["medium-evergreen-es", "medium-evergreen-en"]
+        },
+        {
+            "id": "soypolkadot-com",
+            "name": "soypolkadot.com",
+            "url": "https://soypolkadot.com/",
+            "roles": ["display", "destination"],
+            "weight": 5,
+            "placements": [
+                { "id": "home-band", "format": "band" },
+                { "id": "end-of-guide", "format": "card" }
+            ],
+            "creatives": ["polkadot-evergreen-es", "polkadot-evergreen-en"]
+        },
+        {
+            "id": "artmax-club",
+            "name": "artmax.club",
+            "url": "https://artmax.club/",
+            "roles": ["display", "destination"],
+            "weight": 5,
+            "placements": [
+                { "id": "home-band", "format": "band" },
+                { "id": "end-of-page", "format": "card" }
+            ],
+            "creatives": ["artmax-evergreen-es", "artmax-evergreen-en"]
+        },
+        {
+            "id": "ganima-co",
+            "name": "ganima.co",
+            "url": "https://ganima.co/",
+            "roles": ["destination"],
+            "weight": 5,
+            "placements": [],
+            "creatives": ["ganima-evergreen-es", "ganima-evergreen-en"]
+        },
+        {
+            "id": "instagram-ganima-bug",
+            "name": "Instagram @ganima_bug",
+            "url": "https://www.instagram.com/ganima_bug/",
+            "roles": ["destination"],
+            "weight": 5,
+            "placements": [],
+            "creatives": ["instagram-evergreen-es", "instagram-evergreen-en"]
+        }
+    ],
+    "creatives": [
+        {
+            "id": "becas-evergreen-es",
+            "destination": "becas-parchar-ai",
+            "variant": "becas-evergreen-es",
+            "locale": "es",
+            "headline": "Becas verificadas, sin rumores",
+            "blurb": "Oportunidades con fuente oficial, fechas de cierre y evidencia en cada ficha.",
+            "cta": "Explorar becas",
+            "accent": "#e63a7a"
+        },
+        {
+            "id": "becas-evergreen-en",
+            "destination": "becas-parchar-ai",
+            "variant": "becas-evergreen-en",
+            "locale": "en",
+            "headline": "Verified scholarships, no rumors",
+            "blurb": "Opportunities with official sources, closing dates and evidence on every listing.",
+            "cta": "Browse scholarships",
+            "accent": "#e63a7a"
+        },
+        {
+            "id": "eventos-evergreen-es",
+            "destination": "parchar-ai",
+            "variant": "eventos-evergreen-es",
+            "locale": "es",
+            "headline": "¿Y el parche de este fin de semana?",
+            "blurb": "Conciertos, teatro y expos verificados en tu ciudad, agregados con IA.",
+            "cta": "Ver planes",
+            "accent": "#f6c24a"
+        },
+        {
+            "id": "eventos-evergreen-en",
+            "destination": "parchar-ai",
+            "variant": "eventos-evergreen-en",
+            "locale": "en",
+            "headline": "Weekend plans, already verified",
+            "blurb": "Concerts, theater and exhibitions in your city, aggregated with AI.",
+            "cta": "Browse events",
+            "accent": "#f6c24a"
+        },
+        {
+            "id": "medium-evergreen-es",
+            "destination": "medium-horacio",
+            "variant": "medium-evergreen-es",
+            "locale": "es",
+            "headline": "Cómo se construye Parchar",
+            "blurb": "Ensayos del fundador sobre datos abiertos, IA y descubrimiento cultural.",
+            "cta": "Leer en Medium",
+            "accent": "#10b981"
+        },
+        {
+            "id": "medium-evergreen-en",
+            "destination": "medium-horacio",
+            "variant": "medium-evergreen-en",
+            "locale": "en",
+            "headline": "How Parchar gets built",
+            "blurb": "Founder essays on open data, AI and cultural discovery.",
+            "cta": "Read on Medium",
+            "accent": "#10b981"
+        },
+        {
+            "id": "polkadot-evergreen-es",
+            "destination": "soypolkadot-com",
+            "variant": "polkadot-evergreen-es",
+            "locale": "es",
+            "headline": "Polkadot, en buen español",
+            "blurb": "Guías revisadas con criterios editoriales abiertos, sin humo.",
+            "cta": "Leer las guías",
+            "accent": "#e6007a"
+        },
+        {
+            "id": "polkadot-evergreen-en",
+            "destination": "soypolkadot-com",
+            "variant": "polkadot-evergreen-en",
+            "locale": "en",
+            "headline": "Polkadot, carefully explained",
+            "blurb": "Reviewed guides with open editorial criteria and no hype.",
+            "cta": "Read the guides",
+            "accent": "#e6007a"
+        },
+        {
+            "id": "artmax-evergreen-es",
+            "destination": "artmax-club",
+            "variant": "artmax-evergreen-es",
+            "locale": "es",
+            "headline": "Arte con mensaje",
+            "blurb": "Colecciones NFT que amplifican voces sociales del mundo real.",
+            "cta": "Ver colecciones",
+            "accent": "#8b5cf6"
+        },
+        {
+            "id": "artmax-evergreen-en",
+            "destination": "artmax-club",
+            "variant": "artmax-evergreen-en",
+            "locale": "en",
+            "headline": "Art with a message",
+            "blurb": "NFT collections that amplify real-world social voices.",
+            "cta": "View collections",
+            "accent": "#8b5cf6"
+        },
+        {
+            "id": "ganima-evergreen-es",
+            "destination": "ganima-co",
+            "variant": "ganima-evergreen-es",
+            "locale": "es",
+            "headline": "Cuadro a cuadro",
+            "blurb": "Estudio bogotano de animación 2D y stop-motion en desarrollo.",
+            "cta": "Conocer GANIMA",
+            "accent": "#f97316"
+        },
+        {
+            "id": "ganima-evergreen-en",
+            "destination": "ganima-co",
+            "variant": "ganima-evergreen-en",
+            "locale": "en",
+            "headline": "Frame by frame",
+            "blurb": "A Bogotá-based 2D and stop-motion animation studio in development.",
+            "cta": "Meet GANIMA",
+            "accent": "#f97316"
+        },
+        {
+            "id": "instagram-evergreen-es",
+            "destination": "instagram-ganima-bug",
+            "variant": "instagram-evergreen-es",
+            "locale": "es",
+            "headline": "El proceso, sin filtro",
+            "blurb": "El detrás de cámaras del estudio GANIMA, directo al feed.",
+            "cta": "Seguir a @ganima_bug",
+            "accent": "#ec4899"
+        },
+        {
+            "id": "instagram-evergreen-en",
+            "destination": "instagram-ganima-bug",
+            "variant": "instagram-evergreen-en",
+            "locale": "en",
+            "headline": "The process, unfiltered",
+            "blurb": "GANIMA studio's behind-the-scenes, straight to the feed.",
+            "cta": "Follow @ganima_bug",
+            "accent": "#ec4899"
+        }
+    ]
+}

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+import type { NetworkConfig } from './types';
+export declare const networkConfig: NetworkConfig;
+export type { NetworkConfig };
+export type * from './types';
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C,eAAO,MAAM,aAAa,EAAkB,aAAa,CAAC;AAE1D,YAAY,EAAE,aAAa,EAAE,CAAC;AAC9B,mBAAmB,SAAS,CAAC"}

package/dist/config.js

@@ -0,0 +1,6 @@
+import networkJson from './config/network.json';
+// The shipped config is structurally validated by the package test suite and
+// by consumers at build time (validateNetworkConfig). Casting here keeps the
+// runtime — and the embed bundle — free of the schema dependency.
+export const networkConfig = networkJson;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAGhD,6EAA6E;AAC7E,6EAA6E;AAC7E,kEAAkE;AAClE,MAAM,CAAC,MAAM,aAAa,GAAG,WAA4B,CAAC"}

package/dist/consent.d.ts

@@ -0,0 +1,13 @@
+export type PromoConsent = 'granted' | 'denied';
+export type ConsentProvider = () => PromoConsent;
+/**
+ * First-party portals where GA already loads: promos may measure by default.
+ */
+export declare const permissiveConsent: ConsentProvider;
+/**
+ * Hosts with an analytics consent gate (e.g. soypolkadot's cookie
+ * preferences). `detect` returns the host's analytics-consent state; when it
+ * cannot be read, consent is denied so no measurement request is sent.
+ */
+export declare function gatedConsent(detect: () => boolean | string | undefined): ConsentProvider;
+//# sourceMappingURL=consent.d.ts.map

package/dist/consent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../src/consent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAAiC,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,GACzC,eAAe,CASjB"}

package/dist/consent.js

@@ -0,0 +1,21 @@
+/**
+ * First-party portals where GA already loads: promos may measure by default.
+ */
+export const permissiveConsent = () => 'granted';
+/**
+ * Hosts with an analytics consent gate (e.g. soypolkadot's cookie
+ * preferences). `detect` returns the host's analytics-consent state; when it
+ * cannot be read, consent is denied so no measurement request is sent.
+ */
+export function gatedConsent(detect) {
+    return () => {
+        try {
+            const value = detect();
+            return value === true || value === 'granted' ? 'granted' : 'denied';
+        }
+        catch {
+            return 'denied';
+        }
+    };
+}
+//# sourceMappingURL=consent.js.map

package/dist/consent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../src/consent.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAoB,GAAG,EAAE,CAAC,SAAS,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,MAA0C;IAE1C,OAAO,GAAG,EAAE;QACV,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;YACvB,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/element.d.ts

@@ -0,0 +1,26 @@
+import type { NetworkConfig } from './types';
+import { type CrossPromoAnalyticsOptions } from './analytics';
+import { type ConsentProvider } from './consent';
+export interface DefineParcharPromoOptions {
+    config?: NetworkConfig;
+    /** Network GA4 measurement id; null keeps rendering but skips analytics. */
+    measurementId?: string | null;
+    consent?: ConsentProvider;
+    excludedPathPrefixes?: string[];
+    /** Extra analytics options (tests inject a location provider here). */
+    analyticsOptions?: Partial<CrossPromoAnalyticsOptions>;
+}
+/**
+ * Registers the `<parchar-promo>` element for embed hosts (static sites).
+ * Options also become the live configuration for in-place enhancement.
+ */
+export declare function defineParcharPromo(options?: DefineParcharPromoOptions): void;
+/**
+ * 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 declare function enhanceCrossPromoPlaceholders(root?: ParentNode): void;
+//# sourceMappingURL=element.d.ts.map

package/dist/element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,SAAS,CAAC;AAK/D,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAEpE,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACxD;AAiHD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,IAAI,CAiBhF;AAID;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CA6B/E"}