@adzenai/core 0.0.1

package/dist/index.cjs

@@ -0,0 +1,141 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ensureTid: () => ensureTid,
+  observeViewability: () => observeViewability,
+  readTid: () => readTid,
+  registerErrorSink: () => registerErrorSink,
+  reportError: () => reportError,
+  safeRun: () => safeRun,
+  safeRunAsync: () => safeRunAsync,
+  uuidv4: () => uuidv4
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var sinks = /* @__PURE__ */ new Set();
+function registerErrorSink(sink) {
+  sinks.add(sink);
+  return () => sinks.delete(sink);
+}
+function reportError(err, label) {
+  const adzenErr = {
+    label,
+    message: err instanceof Error ? err.message : String(err),
+    stack: err instanceof Error ? err.stack : void 0,
+    ts: Date.now()
+  };
+  for (const sink of sinks) {
+    try {
+      sink(adzenErr);
+    } catch {
+    }
+  }
+}
+function safeRun(fn, label, fallback) {
+  try {
+    return fn();
+  } catch (err) {
+    reportError(err, label);
+    return fallback;
+  }
+}
+async function safeRunAsync(fn, label, fallback) {
+  try {
+    return await fn();
+  } catch (err) {
+    reportError(err, label);
+    return fallback;
+  }
+}
+
+// src/session.ts
+var TID_KEY = "adzen_tid";
+function uuidv4() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function readTid() {
+  if (typeof localStorage === "undefined") return null;
+  try {
+    return localStorage.getItem(TID_KEY);
+  } catch {
+    return null;
+  }
+}
+function ensureTid() {
+  const existing = readTid();
+  if (existing) return existing;
+  const id = uuidv4();
+  try {
+    localStorage.setItem(TID_KEY, id);
+  } catch {
+  }
+  return id;
+}
+
+// src/viewability.ts
+function observeViewability(options) {
+  const { element, thresholdMs, onViewed, intersectionThreshold = 1 } = options;
+  let timer = null;
+  let fired = false;
+  const observer = new IntersectionObserver(
+    (entries) => {
+      for (const entry of entries) {
+        if (entry.isIntersecting && !fired) {
+          timer = setTimeout(() => {
+            fired = true;
+            onViewed();
+            observer.disconnect();
+          }, thresholdMs);
+        } else if (!entry.isIntersecting && timer !== null) {
+          clearTimeout(timer);
+          timer = null;
+        }
+      }
+    },
+    { threshold: intersectionThreshold }
+  );
+  observer.observe(element);
+  return () => {
+    if (timer !== null) clearTimeout(timer);
+    observer.disconnect();
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ensureTid,
+  observeViewability,
+  readTid,
+  registerErrorSink,
+  reportError,
+  safeRun,
+  safeRunAsync,
+  uuidv4
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/session.ts","../src/viewability.ts"],"sourcesContent":["export * from \"./types.js\";\nexport { registerErrorSink, reportError, safeRun, safeRunAsync } from \"./errors.js\";\nexport { uuidv4, readTid, ensureTid } from \"./session.js\";\nexport { observeViewability } from \"./viewability.js\";\nexport type { ViewabilityOptions } from \"./viewability.js\";\n","import type { AdzenError } from \"./types.js\";\n\ntype ErrorSink = (err: AdzenError) => void;\n\nconst sinks = new Set<ErrorSink>();\n\nexport function registerErrorSink(sink: ErrorSink): () => void {\n  sinks.add(sink);\n  return () => sinks.delete(sink);\n}\n\nexport function reportError(err: unknown, label: string): void {\n  const adzenErr: AdzenError = {\n    label,\n    message: err instanceof Error ? err.message : String(err),\n    stack: err instanceof Error ? err.stack : undefined,\n    ts: Date.now(),\n  };\n  for (const sink of sinks) {\n    try {\n      sink(adzenErr);\n    } catch {\n      // never let a sink crash the caller\n    }\n  }\n}\n\nexport function safeRun<T>(fn: () => T, label: string): T | undefined;\nexport function safeRun<T>(fn: () => T, label: string, fallback: T): T;\nexport function safeRun<T>(fn: () => T, label: string, fallback?: T): T | undefined {\n  try {\n    return fn();\n  } catch (err) {\n    reportError(err, label);\n    return fallback;\n  }\n}\n\nexport async function safeRunAsync<T>(fn: () => Promise<T>, label: string): Promise<T | undefined>;\nexport async function safeRunAsync<T>(fn: () => Promise<T>, label: string, fallback: T): Promise<T>;\nexport async function safeRunAsync<T>(\n  fn: () => Promise<T>,\n  label: string,\n  fallback?: T,\n): Promise<T | undefined> {\n  try {\n    return await fn();\n  } catch (err) {\n    reportError(err, label);\n    return fallback;\n  }\n}\n","const TID_KEY = \"adzen_tid\";\n\nexport function uuidv4(): string {\n  if (typeof crypto !== \"undefined\" && crypto.randomUUID) {\n    return crypto.randomUUID();\n  }\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\nexport function readTid(): string | null {\n  if (typeof localStorage === \"undefined\") return null;\n  try {\n    return localStorage.getItem(TID_KEY);\n  } catch {\n    return null;\n  }\n}\n\nexport function ensureTid(): string {\n  const existing = readTid();\n  if (existing) return existing;\n  const id = uuidv4();\n  try {\n    localStorage.setItem(TID_KEY, id);\n  } catch {\n    // storage unavailable — return ephemeral id\n  }\n  return id;\n}\n","export interface ViewabilityOptions {\n  element: Element;\n  thresholdMs: number;\n  onViewed: () => void;\n  intersectionThreshold?: number;\n}\n\nexport function observeViewability(options: ViewabilityOptions): () => void {\n  const { element, thresholdMs, onViewed, intersectionThreshold = 1.0 } = options;\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  let fired = false;\n\n  const observer = new IntersectionObserver(\n    (entries) => {\n      for (const entry of entries) {\n        if (entry.isIntersecting && !fired) {\n          timer = setTimeout(() => {\n            fired = true;\n            onViewed();\n            observer.disconnect();\n          }, thresholdMs);\n        } else if (!entry.isIntersecting && timer !== null) {\n          clearTimeout(timer);\n          timer = null;\n        }\n      }\n    },\n    { threshold: intersectionThreshold },\n  );\n\n  observer.observe(element);\n\n  return () => {\n    if (timer !== null) clearTimeout(timer);\n    observer.disconnect();\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIA,IAAM,QAAQ,oBAAI,IAAe;AAE1B,SAAS,kBAAkB,MAA6B;AAC7D,QAAM,IAAI,IAAI;AACd,SAAO,MAAM,MAAM,OAAO,IAAI;AAChC;AAEO,SAAS,YAAY,KAAc,OAAqB;AAC7D,QAAM,WAAuB;AAAA,IAC3B;AAAA,IACA,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,IACxD,OAAO,eAAe,QAAQ,IAAI,QAAQ;AAAA,IAC1C,IAAI,KAAK,IAAI;AAAA,EACf;AACA,aAAW,QAAQ,OAAO;AACxB,QAAI;AACF,WAAK,QAAQ;AAAA,IACf,QAAQ;AAAA,IAER;AAAA,EACF;AACF;AAIO,SAAS,QAAW,IAAa,OAAe,UAA6B;AAClF,MAAI;AACF,WAAO,GAAG;AAAA,EACZ,SAAS,KAAK;AACZ,gBAAY,KAAK,KAAK;AACtB,WAAO;AAAA,EACT;AACF;AAIA,eAAsB,aACpB,IACA,OACA,UACwB;AACxB,MAAI;AACF,WAAO,MAAM,GAAG;AAAA,EAClB,SAAS,KAAK;AACZ,gBAAY,KAAK,KAAK;AACtB,WAAO;AAAA,EACT;AACF;;;ACnDA,IAAM,UAAU;AAET,SAAS,SAAiB;AAC/B,MAAI,OAAO,WAAW,eAAe,OAAO,YAAY;AACtD,WAAO,OAAO,WAAW;AAAA,EAC3B;AACA,SAAO,uCAAuC,QAAQ,SAAS,CAAC,MAAM;AACpE,UAAM,IAAK,KAAK,OAAO,IAAI,KAAM;AACjC,UAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC,WAAO,EAAE,SAAS,EAAE;AAAA,EACtB,CAAC;AACH;AAEO,SAAS,UAAyB;AACvC,MAAI,OAAO,iBAAiB,YAAa,QAAO;AAChD,MAAI;AACF,WAAO,aAAa,QAAQ,OAAO;AAAA,EACrC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,YAAoB;AAClC,QAAM,WAAW,QAAQ;AACzB,MAAI,SAAU,QAAO;AACrB,QAAM,KAAK,OAAO;AAClB,MAAI;AACF,iBAAa,QAAQ,SAAS,EAAE;AAAA,EAClC,QAAQ;AAAA,EAER;AACA,SAAO;AACT;;;ACzBO,SAAS,mBAAmB,SAAyC;AAC1E,QAAM,EAAE,SAAS,aAAa,UAAU,wBAAwB,EAAI,IAAI;AACxE,MAAI,QAA8C;AAClD,MAAI,QAAQ;AAEZ,QAAM,WAAW,IAAI;AAAA,IACnB,CAAC,YAAY;AACX,iBAAW,SAAS,SAAS;AAC3B,YAAI,MAAM,kBAAkB,CAAC,OAAO;AAClC,kBAAQ,WAAW,MAAM;AACvB,oBAAQ;AACR,qBAAS;AACT,qBAAS,WAAW;AAAA,UACtB,GAAG,WAAW;AAAA,QAChB,WAAW,CAAC,MAAM,kBAAkB,UAAU,MAAM;AAClD,uBAAa,KAAK;AAClB,kBAAQ;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAAA,IACA,EAAE,WAAW,sBAAsB;AAAA,EACrC;AAEA,WAAS,QAAQ,OAAO;AAExB,SAAO,MAAM;AACX,QAAI,UAAU,KAAM,cAAa,KAAK;AACtC,aAAS,WAAW;AAAA,EACtB;AACF;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,185 @@
+interface AdzenPlacement {
+    ad_id: string;
+    campaign_id: string;
+    advertiser_name: string;
+    advertiser_image_url?: string;
+    headline: string;
+    description?: string;
+    cta_text: string;
+    destination_url: string;
+    creative_url?: string;
+    adUnitPosition: string;
+    tracking: TrackingInfo;
+}
+interface TrackingInfo {
+    render_url: string;
+    view_url: string;
+    click_slug: string;
+}
+interface AdzenDecision {
+    decision: "serve" | "no_match";
+    ad?: AdzenPlacement;
+    reason?: string;
+}
+type AdzenEnv = "prod" | "stg" | "dev";
+type AdzenFormat = "banner" | "native" | "sticky" | "in-feed";
+type SlotPosition = "atf" | "btf";
+interface AdzenConsent {
+    gdpr?: boolean;
+    tcString?: string;
+    usp?: string;
+}
+interface AbContext {
+    testId?: string;
+    variantId?: string;
+    chunkId?: string;
+    adId?: string;
+}
+interface AdzenDefaults {
+    lazyRootMargin: string;
+    impressionMinMs: number;
+    viewabilityThreshold: number;
+}
+interface AdzenStaticConfig {
+    publisherId: string;
+    endpoint?: string;
+    env?: AdzenEnv;
+    debug?: boolean;
+    mockMode?: boolean;
+    defaults?: Partial<AdzenDefaults>;
+    consent?: AdzenConsent;
+    abContext?: AbContext;
+    onError?: (err: AdzenError) => void;
+}
+interface ResolvedAdzenStaticConfig extends AdzenStaticConfig {
+    endpoint: string;
+    env: AdzenEnv;
+    debug: boolean;
+    mockMode: boolean;
+    defaults: AdzenDefaults;
+}
+interface SlotSpec {
+    id: string;
+    format: AdzenFormat;
+    sizes?: string[];
+    position?: SlotPosition;
+}
+interface PageContext {
+    url: string;
+    referrer: string | null;
+    title: string;
+}
+interface ViewportContext {
+    w: number;
+    h: number;
+    dpr: number;
+}
+interface UserContext {
+    tid: string | null;
+    consent: AdzenConsent;
+}
+interface DecisionRequest {
+    publisherId: string;
+    requestId: string;
+    slots: SlotSpec[];
+    page: PageContext;
+    viewport: ViewportContext;
+    user: UserContext;
+    abContext?: AbContext;
+    sdk: {
+        version: string;
+        ts: number;
+    };
+}
+interface BannerCreative {
+    format: "banner";
+    type: "image" | "html";
+    assets: {
+        imageUrl?: string;
+        html?: string;
+    };
+    dimensions: {
+        w: number;
+        h: number;
+    };
+}
+interface NativeCreative {
+    format: "native";
+    assets: {
+        headline: string;
+        body?: string;
+        cta: string;
+        imageUrl?: string;
+        advertiser: string;
+        sponsorLabel?: string;
+    };
+}
+interface StickyCreative {
+    format: "sticky";
+    type: "image" | "html";
+    assets: {
+        imageUrl?: string;
+        html?: string;
+    };
+    dimensions: {
+        w: number;
+        h: number;
+    };
+}
+type Creative = BannerCreative | NativeCreative | StickyCreative;
+interface Beacons {
+    impression: string[];
+    view: string[];
+    click: string[];
+}
+interface Decision {
+    slotId: string;
+    creative: Creative;
+    clickUrl: string;
+    beacons: Beacons;
+    abContext?: AbContext;
+    debug?: Record<string, unknown>;
+}
+interface DecisionResponse {
+    requestId: string;
+    decisions: Decision[];
+}
+interface AdzenError {
+    label: string;
+    message: string;
+    stack?: string;
+    ts: number;
+}
+type AdzenQueueItem = IArguments | unknown[];
+interface AdzenApi {
+    (command: unknown, ...args: unknown[]): void;
+    q?: AdzenQueueItem[];
+    init?: (config: AdzenStaticConfig) => void;
+}
+interface AdzenBaseConfig {
+    endpointUrl?: string;
+    apiKey: string;
+    timeoutMs?: number;
+}
+
+type ErrorSink = (err: AdzenError) => void;
+declare function registerErrorSink(sink: ErrorSink): () => void;
+declare function reportError(err: unknown, label: string): void;
+declare function safeRun<T>(fn: () => T, label: string): T | undefined;
+declare function safeRun<T>(fn: () => T, label: string, fallback: T): T;
+declare function safeRunAsync<T>(fn: () => Promise<T>, label: string): Promise<T | undefined>;
+declare function safeRunAsync<T>(fn: () => Promise<T>, label: string, fallback: T): Promise<T>;
+
+declare function uuidv4(): string;
+declare function readTid(): string | null;
+declare function ensureTid(): string;
+
+interface ViewabilityOptions {
+    element: Element;
+    thresholdMs: number;
+    onViewed: () => void;
+    intersectionThreshold?: number;
+}
+declare function observeViewability(options: ViewabilityOptions): () => void;
+
+export { type AbContext, type AdzenApi, type AdzenBaseConfig, type AdzenConsent, type AdzenDecision, type AdzenDefaults, type AdzenEnv, type AdzenError, type AdzenFormat, type AdzenPlacement, type AdzenQueueItem, type AdzenStaticConfig, type BannerCreative, type Beacons, type Creative, type Decision, type DecisionRequest, type DecisionResponse, type NativeCreative, type PageContext, type ResolvedAdzenStaticConfig, type SlotPosition, type SlotSpec, type StickyCreative, type TrackingInfo, type UserContext, type ViewabilityOptions, type ViewportContext, ensureTid, observeViewability, readTid, registerErrorSink, reportError, safeRun, safeRunAsync, uuidv4 };

package/dist/index.d.ts

@@ -0,0 +1,185 @@
+interface AdzenPlacement {
+    ad_id: string;
+    campaign_id: string;
+    advertiser_name: string;
+    advertiser_image_url?: string;
+    headline: string;
+    description?: string;
+    cta_text: string;
+    destination_url: string;
+    creative_url?: string;
+    adUnitPosition: string;
+    tracking: TrackingInfo;
+}
+interface TrackingInfo {
+    render_url: string;
+    view_url: string;
+    click_slug: string;
+}
+interface AdzenDecision {
+    decision: "serve" | "no_match";
+    ad?: AdzenPlacement;
+    reason?: string;
+}
+type AdzenEnv = "prod" | "stg" | "dev";
+type AdzenFormat = "banner" | "native" | "sticky" | "in-feed";
+type SlotPosition = "atf" | "btf";
+interface AdzenConsent {
+    gdpr?: boolean;
+    tcString?: string;
+    usp?: string;
+}
+interface AbContext {
+    testId?: string;
+    variantId?: string;
+    chunkId?: string;
+    adId?: string;
+}
+interface AdzenDefaults {
+    lazyRootMargin: string;
+    impressionMinMs: number;
+    viewabilityThreshold: number;
+}
+interface AdzenStaticConfig {
+    publisherId: string;
+    endpoint?: string;
+    env?: AdzenEnv;
+    debug?: boolean;
+    mockMode?: boolean;
+    defaults?: Partial<AdzenDefaults>;
+    consent?: AdzenConsent;
+    abContext?: AbContext;
+    onError?: (err: AdzenError) => void;
+}
+interface ResolvedAdzenStaticConfig extends AdzenStaticConfig {
+    endpoint: string;
+    env: AdzenEnv;
+    debug: boolean;
+    mockMode: boolean;
+    defaults: AdzenDefaults;
+}
+interface SlotSpec {
+    id: string;
+    format: AdzenFormat;
+    sizes?: string[];
+    position?: SlotPosition;
+}
+interface PageContext {
+    url: string;
+    referrer: string | null;
+    title: string;
+}
+interface ViewportContext {
+    w: number;
+    h: number;
+    dpr: number;
+}
+interface UserContext {
+    tid: string | null;
+    consent: AdzenConsent;
+}
+interface DecisionRequest {
+    publisherId: string;
+    requestId: string;
+    slots: SlotSpec[];
+    page: PageContext;
+    viewport: ViewportContext;
+    user: UserContext;
+    abContext?: AbContext;
+    sdk: {
+        version: string;
+        ts: number;
+    };
+}
+interface BannerCreative {
+    format: "banner";
+    type: "image" | "html";
+    assets: {
+        imageUrl?: string;
+        html?: string;
+    };
+    dimensions: {
+        w: number;
+        h: number;
+    };
+}
+interface NativeCreative {
+    format: "native";
+    assets: {
+        headline: string;
+        body?: string;
+        cta: string;
+        imageUrl?: string;
+        advertiser: string;
+        sponsorLabel?: string;
+    };
+}
+interface StickyCreative {
+    format: "sticky";
+    type: "image" | "html";
+    assets: {
+        imageUrl?: string;
+        html?: string;
+    };
+    dimensions: {
+        w: number;
+        h: number;
+    };
+}
+type Creative = BannerCreative | NativeCreative | StickyCreative;
+interface Beacons {
+    impression: string[];
+    view: string[];
+    click: string[];
+}
+interface Decision {
+    slotId: string;
+    creative: Creative;
+    clickUrl: string;
+    beacons: Beacons;
+    abContext?: AbContext;
+    debug?: Record<string, unknown>;
+}
+interface DecisionResponse {
+    requestId: string;
+    decisions: Decision[];
+}
+interface AdzenError {
+    label: string;
+    message: string;
+    stack?: string;
+    ts: number;
+}
+type AdzenQueueItem = IArguments | unknown[];
+interface AdzenApi {
+    (command: unknown, ...args: unknown[]): void;
+    q?: AdzenQueueItem[];
+    init?: (config: AdzenStaticConfig) => void;
+}
+interface AdzenBaseConfig {
+    endpointUrl?: string;
+    apiKey: string;
+    timeoutMs?: number;
+}
+
+type ErrorSink = (err: AdzenError) => void;
+declare function registerErrorSink(sink: ErrorSink): () => void;
+declare function reportError(err: unknown, label: string): void;
+declare function safeRun<T>(fn: () => T, label: string): T | undefined;
+declare function safeRun<T>(fn: () => T, label: string, fallback: T): T;
+declare function safeRunAsync<T>(fn: () => Promise<T>, label: string): Promise<T | undefined>;
+declare function safeRunAsync<T>(fn: () => Promise<T>, label: string, fallback: T): Promise<T>;
+
+declare function uuidv4(): string;
+declare function readTid(): string | null;
+declare function ensureTid(): string;
+
+interface ViewabilityOptions {
+    element: Element;
+    thresholdMs: number;
+    onViewed: () => void;
+    intersectionThreshold?: number;
+}
+declare function observeViewability(options: ViewabilityOptions): () => void;
+
+export { type AbContext, type AdzenApi, type AdzenBaseConfig, type AdzenConsent, type AdzenDecision, type AdzenDefaults, type AdzenEnv, type AdzenError, type AdzenFormat, type AdzenPlacement, type AdzenQueueItem, type AdzenStaticConfig, type BannerCreative, type Beacons, type Creative, type Decision, type DecisionRequest, type DecisionResponse, type NativeCreative, type PageContext, type ResolvedAdzenStaticConfig, type SlotPosition, type SlotSpec, type StickyCreative, type TrackingInfo, type UserContext, type ViewabilityOptions, type ViewportContext, ensureTid, observeViewability, readTid, registerErrorSink, reportError, safeRun, safeRunAsync, uuidv4 };

package/dist/index.js

@@ -0,0 +1,107 @@
+// src/errors.ts
+var sinks = /* @__PURE__ */ new Set();
+function registerErrorSink(sink) {
+  sinks.add(sink);
+  return () => sinks.delete(sink);
+}
+function reportError(err, label) {
+  const adzenErr = {
+    label,
+    message: err instanceof Error ? err.message : String(err),
+    stack: err instanceof Error ? err.stack : void 0,
+    ts: Date.now()
+  };
+  for (const sink of sinks) {
+    try {
+      sink(adzenErr);
+    } catch {
+    }
+  }
+}
+function safeRun(fn, label, fallback) {
+  try {
+    return fn();
+  } catch (err) {
+    reportError(err, label);
+    return fallback;
+  }
+}
+async function safeRunAsync(fn, label, fallback) {
+  try {
+    return await fn();
+  } catch (err) {
+    reportError(err, label);
+    return fallback;
+  }
+}
+
+// src/session.ts
+var TID_KEY = "adzen_tid";
+function uuidv4() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function readTid() {
+  if (typeof localStorage === "undefined") return null;
+  try {
+    return localStorage.getItem(TID_KEY);
+  } catch {
+    return null;
+  }
+}
+function ensureTid() {
+  const existing = readTid();
+  if (existing) return existing;
+  const id = uuidv4();
+  try {
+    localStorage.setItem(TID_KEY, id);
+  } catch {
+  }
+  return id;
+}
+
+// src/viewability.ts
+function observeViewability(options) {
+  const { element, thresholdMs, onViewed, intersectionThreshold = 1 } = options;
+  let timer = null;
+  let fired = false;
+  const observer = new IntersectionObserver(
+    (entries) => {
+      for (const entry of entries) {
+        if (entry.isIntersecting && !fired) {
+          timer = setTimeout(() => {
+            fired = true;
+            onViewed();
+            observer.disconnect();
+          }, thresholdMs);
+        } else if (!entry.isIntersecting && timer !== null) {
+          clearTimeout(timer);
+          timer = null;
+        }
+      }
+    },
+    { threshold: intersectionThreshold }
+  );
+  observer.observe(element);
+  return () => {
+    if (timer !== null) clearTimeout(timer);
+    observer.disconnect();
+  };
+}
+export {
+  ensureTid,
+  observeViewability,
+  readTid,
+  registerErrorSink,
+  reportError,
+  safeRun,
+  safeRunAsync,
+  uuidv4
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/session.ts","../src/viewability.ts"],"sourcesContent":["import type { AdzenError } from \"./types.js\";\n\ntype ErrorSink = (err: AdzenError) => void;\n\nconst sinks = new Set<ErrorSink>();\n\nexport function registerErrorSink(sink: ErrorSink): () => void {\n  sinks.add(sink);\n  return () => sinks.delete(sink);\n}\n\nexport function reportError(err: unknown, label: string): void {\n  const adzenErr: AdzenError = {\n    label,\n    message: err instanceof Error ? err.message : String(err),\n    stack: err instanceof Error ? err.stack : undefined,\n    ts: Date.now(),\n  };\n  for (const sink of sinks) {\n    try {\n      sink(adzenErr);\n    } catch {\n      // never let a sink crash the caller\n    }\n  }\n}\n\nexport function safeRun<T>(fn: () => T, label: string): T | undefined;\nexport function safeRun<T>(fn: () => T, label: string, fallback: T): T;\nexport function safeRun<T>(fn: () => T, label: string, fallback?: T): T | undefined {\n  try {\n    return fn();\n  } catch (err) {\n    reportError(err, label);\n    return fallback;\n  }\n}\n\nexport async function safeRunAsync<T>(fn: () => Promise<T>, label: string): Promise<T | undefined>;\nexport async function safeRunAsync<T>(fn: () => Promise<T>, label: string, fallback: T): Promise<T>;\nexport async function safeRunAsync<T>(\n  fn: () => Promise<T>,\n  label: string,\n  fallback?: T,\n): Promise<T | undefined> {\n  try {\n    return await fn();\n  } catch (err) {\n    reportError(err, label);\n    return fallback;\n  }\n}\n","const TID_KEY = \"adzen_tid\";\n\nexport function uuidv4(): string {\n  if (typeof crypto !== \"undefined\" && crypto.randomUUID) {\n    return crypto.randomUUID();\n  }\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\nexport function readTid(): string | null {\n  if (typeof localStorage === \"undefined\") return null;\n  try {\n    return localStorage.getItem(TID_KEY);\n  } catch {\n    return null;\n  }\n}\n\nexport function ensureTid(): string {\n  const existing = readTid();\n  if (existing) return existing;\n  const id = uuidv4();\n  try {\n    localStorage.setItem(TID_KEY, id);\n  } catch {\n    // storage unavailable — return ephemeral id\n  }\n  return id;\n}\n","export interface ViewabilityOptions {\n  element: Element;\n  thresholdMs: number;\n  onViewed: () => void;\n  intersectionThreshold?: number;\n}\n\nexport function observeViewability(options: ViewabilityOptions): () => void {\n  const { element, thresholdMs, onViewed, intersectionThreshold = 1.0 } = options;\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  let fired = false;\n\n  const observer = new IntersectionObserver(\n    (entries) => {\n      for (const entry of entries) {\n        if (entry.isIntersecting && !fired) {\n          timer = setTimeout(() => {\n            fired = true;\n            onViewed();\n            observer.disconnect();\n          }, thresholdMs);\n        } else if (!entry.isIntersecting && timer !== null) {\n          clearTimeout(timer);\n          timer = null;\n        }\n      }\n    },\n    { threshold: intersectionThreshold },\n  );\n\n  observer.observe(element);\n\n  return () => {\n    if (timer !== null) clearTimeout(timer);\n    observer.disconnect();\n  };\n}\n"],"mappings":";AAIA,IAAM,QAAQ,oBAAI,IAAe;AAE1B,SAAS,kBAAkB,MAA6B;AAC7D,QAAM,IAAI,IAAI;AACd,SAAO,MAAM,MAAM,OAAO,IAAI;AAChC;AAEO,SAAS,YAAY,KAAc,OAAqB;AAC7D,QAAM,WAAuB;AAAA,IAC3B;AAAA,IACA,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,IACxD,OAAO,eAAe,QAAQ,IAAI,QAAQ;AAAA,IAC1C,IAAI,KAAK,IAAI;AAAA,EACf;AACA,aAAW,QAAQ,OAAO;AACxB,QAAI;AACF,WAAK,QAAQ;AAAA,IACf,QAAQ;AAAA,IAER;AAAA,EACF;AACF;AAIO,SAAS,QAAW,IAAa,OAAe,UAA6B;AAClF,MAAI;AACF,WAAO,GAAG;AAAA,EACZ,SAAS,KAAK;AACZ,gBAAY,KAAK,KAAK;AACtB,WAAO;AAAA,EACT;AACF;AAIA,eAAsB,aACpB,IACA,OACA,UACwB;AACxB,MAAI;AACF,WAAO,MAAM,GAAG;AAAA,EAClB,SAAS,KAAK;AACZ,gBAAY,KAAK,KAAK;AACtB,WAAO;AAAA,EACT;AACF;;;ACnDA,IAAM,UAAU;AAET,SAAS,SAAiB;AAC/B,MAAI,OAAO,WAAW,eAAe,OAAO,YAAY;AACtD,WAAO,OAAO,WAAW;AAAA,EAC3B;AACA,SAAO,uCAAuC,QAAQ,SAAS,CAAC,MAAM;AACpE,UAAM,IAAK,KAAK,OAAO,IAAI,KAAM;AACjC,UAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC,WAAO,EAAE,SAAS,EAAE;AAAA,EACtB,CAAC;AACH;AAEO,SAAS,UAAyB;AACvC,MAAI,OAAO,iBAAiB,YAAa,QAAO;AAChD,MAAI;AACF,WAAO,aAAa,QAAQ,OAAO;AAAA,EACrC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,YAAoB;AAClC,QAAM,WAAW,QAAQ;AACzB,MAAI,SAAU,QAAO;AACrB,QAAM,KAAK,OAAO;AAClB,MAAI;AACF,iBAAa,QAAQ,SAAS,EAAE;AAAA,EAClC,QAAQ;AAAA,EAER;AACA,SAAO;AACT;;;ACzBO,SAAS,mBAAmB,SAAyC;AAC1E,QAAM,EAAE,SAAS,aAAa,UAAU,wBAAwB,EAAI,IAAI;AACxE,MAAI,QAA8C;AAClD,MAAI,QAAQ;AAEZ,QAAM,WAAW,IAAI;AAAA,IACnB,CAAC,YAAY;AACX,iBAAW,SAAS,SAAS;AAC3B,YAAI,MAAM,kBAAkB,CAAC,OAAO;AAClC,kBAAQ,WAAW,MAAM;AACvB,oBAAQ;AACR,qBAAS;AACT,qBAAS,WAAW;AAAA,UACtB,GAAG,WAAW;AAAA,QAChB,WAAW,CAAC,MAAM,kBAAkB,UAAU,MAAM;AAClD,uBAAa,KAAK;AAClB,kBAAQ;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAAA,IACA,EAAE,WAAW,sBAAsB;AAAA,EACrC;AAEA,WAAS,QAAQ,OAAO;AAExB,SAAO,MAAM;AACX,QAAI,UAAU,KAAM,cAAa,KAAK;AACtC,aAAS,WAAW;AAAA,EACtB;AACF;","names":[]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@adzenai/core",
+  "version": "0.0.1",
+  "description": "Core types and utilities for the Adzen AI ad SDK",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.1.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0"
+  }
+}