@hientran0208/ads-sdk 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,256 @@
+import { P as ProviderHandle, E as EngineEvent, a as EventBus, C as ConsentGate, V as VendorConsentId, T as TagInjector, R as RenderProvider, b as TagVendor, A as AdsClient, c as PlacementSource } from './ads-client-BVlLFVQU.js';
+export { d as AdapterSlotRegistry, e as AdsClientConfig, f as AdsEngine, g as AdsEngineDeps, h as AssembledEngine, B as BOOT_SPINE, i as BootStep, j as ConsentSnapshot, k as EngineEventType, I as InjectOptions, L as LazyObserver, l as ProviderLifecycleEvent, m as ProviderRegistry, n as RefreshOptions, o as RequestOptions, p as VendorContext, q as VendorKind, W as WireOptions, r as assembleEngine, s as assembleEngineForPlacement, t as createAdapterSlotRegistry, u as createAdsClient, v as createAdsEngine, w as createAllowAllConsentGate, x as createEventBus, y as createLazyObserver, z as createProviderRegistry, D as createTagInjector } from './ads-client-BVlLFVQU.js';
+import { SlotFormat, PlanSlot, ConsentModeSignals, ConsentConfig, Manifest, PlanContext, DynamicParams } from '@hientran0208/ads-manifest';
+
+/**
+ * Capability lookup table: how each format is requested. Pure routing — it asks the
+ * registry to resolve and classifies the format; it NEVER calls googletag.
+ *
+ * - display/native → div path, eager/lazy, rides the batched request.
+ * - anchor/side-rail/oop → no-div path, no sizes; ride the batch.
+ * - interstitial → no-div, on-demand display, NOT in the eager batch, never refresh.
+ */
+
+interface DispatchTraits {
+    /** Has a div in the DOM (display/native) vs out-of-page. */
+    usesDiv: boolean;
+    /** Eligible for the batched eager request (Single Request Architecture). */
+    ridesEagerBatch: boolean;
+    /** On-demand display only (interstitial). */
+    onDemandOnly: boolean;
+    /** May be refreshed in-page. */
+    refreshable: boolean;
+}
+declare function dispatchTraits(format: SlotFormat): DispatchTraits;
+
+/**
+ * Epoch-keyed slot lifecycle state machine. The epoch key prevents a stale render
+ * callback (fired after an SPA nav) from reporting to the wrong/new slot
+ * (sdk-sample high-risk). Illegal transitions are rejected.
+ *
+ * registered → gated → requested → rendered → (refreshed → requested) | destroyed
+ */
+
+type SlotState = "registered" | "gated" | "requested" | "rendered" | "destroyed";
+interface SlotRecord {
+    slot: PlanSlot;
+    handle: ProviderHandle | null;
+    state: SlotState;
+    /** Monotonic epoch; bumped on new page view. Stale callbacks are ignored. */
+    epoch: number;
+}
+interface SlotLifecycle {
+    register(slot: PlanSlot, epoch: number): SlotRecord;
+    get(uid: string): SlotRecord | undefined;
+    all(): SlotRecord[];
+    /** Attempt a transition; returns false (no-op) if illegal. */
+    transition(uid: string, to: SlotState): boolean;
+    attachHandle(uid: string, handle: ProviderHandle | null): void;
+    /** True if the uid exists AND its epoch matches (callback not stale). */
+    isCurrent(uid: string, epoch: number): boolean;
+    destroyAll(): void;
+}
+declare function createSlotLifecycle(): SlotLifecycle;
+
+/**
+ * Telemetry seam — subscribes to the event bus and forwards normalized events to a
+ * sink. No-op in v1 (the sink does nothing); the seam exists so a reporting backend
+ * (P3) can subscribe without engine changes.
+ */
+
+type TelemetrySink = (ev: EngineEvent) => void;
+/** Wire a sink to the bus. Returns an unsubscribe for all event types. */
+declare function attachTelemetry(bus: EventBus, sink?: TelemetrySink): () => void;
+
+/**
+ * Isolates ALL `gtag('consent', …)` interaction (Google Consent Mode v2). Two jobs:
+ *  1. `setDefaults` — conservative defaults set SYNCHRONOUSLY before any vendor or
+ *     gpt.js load. No CMP read required, so the Approach C fast-path never stalls on
+ *     an async/absent `__tcfapi` (red-team #4).
+ *  2. `update` — called asynchronously once the CMP signal is read.
+ */
+
+type GtagFn = (...args: unknown[]) => void;
+interface GtagHost {
+    dataLayer?: unknown[];
+    gtag?: GtagFn;
+}
+interface ConsentMode {
+    setDefaults(signals: ConsentModeSignals): void;
+    update(signals: ConsentModeSignals): void;
+    defaultsSet(): boolean;
+}
+declare function createConsentMode(host?: GtagHost): ConsentMode;
+
+/**
+ * THE deliverable (red-team #3): the explicit IAB TCF v2.2 purpose →
+ * Consent-Mode-v2 signal mapping. TCF purposes do NOT map 1:1 to the four signals.
+ * This table is spec-driven and CMP-agnostic — built to the standard, smoke-tested
+ * against Cookiebot in P8, with the `__tcfapi` stub authoritative for acceptance.
+ *
+ * TCF v2.2 purposes (subset relevant to Google Consent Mode):
+ *   P1  Store and/or access information on a device   → storage
+ *   P2  Use limited data to select advertising
+ *   P3  Create profiles for personalised advertising  → ad personalization
+ *   P4  Use profiles to select personalised advertising → ad personalization
+ *   P7  Measure advertising performance               → ad user data (measurement)
+ *   P8  Measure content performance                   → analytics
+ *
+ * Google Consent Mode v2 signals:
+ *   ad_storage          ← P1 (device storage for ads)
+ *   analytics_storage   ← P1 (device storage for analytics)
+ *   ad_user_data        ← P1 AND P7 (sending user data for ad measurement)
+ *   ad_personalization  ← P3 AND P4 (personalised advertising)
+ */
+
+/** Per-purpose consent booleans as exposed by `__tcfapi` (`tcData.purpose.consents`). */
+type PurposeConsents = Record<number, boolean>;
+/**
+ * Map TCF purpose consents to the four Consent Mode v2 signals. Conservative:
+ * an absent/false purpose yields `denied`.
+ */
+declare function purposesToSignals(consents: PurposeConsents): ConsentModeSignals;
+
+/**
+ * Isolates ALL `__tcfapi` interaction (IAB TCF). Mockable. Subscribes via
+ * `addEventListener`, surfaces purpose consents, and falls back to conservative
+ * deny if the CMP never responds within the timeout. v1 reads the boolean purpose
+ * signals `__tcfapi` exposes — NO raw TC-string parsing (staged to P3).
+ */
+
+/** Minimal shape of the TCF `tcData` payload we consume. */
+interface TcData {
+    eventStatus?: "tcloaded" | "cmpuishown" | "useractioncomplete" | string;
+    gdprApplies?: boolean;
+    purpose?: {
+        consents?: PurposeConsents;
+    };
+}
+type TcfApi = (command: "addEventListener" | "removeEventListener" | "getTCData", version: number, callback: (tcData: TcData, success: boolean) => void, listenerId?: number) => void;
+interface TcfHost {
+    __tcfapi?: TcfApi;
+}
+interface TcfBridge {
+    /** Subscribe to CMP consent changes. Fires for each `useractioncomplete`/`tcloaded`. */
+    onConsent(cb: (consents: PurposeConsents, applies: boolean) => void): void;
+    /** True if a `__tcfapi` is present on the page. */
+    present(): boolean;
+}
+interface TcfBridgeOptions {
+    /** Ms to wait for the first CMP event before invoking the timeout fallback. */
+    timeoutMs?: number;
+    /** Called if the CMP never responds (keep conservative deny). */
+    onTimeout?: () => void;
+    setTimeoutFn?: typeof setTimeout;
+}
+declare function createTcfBridge(host?: TcfHost, opts?: TcfBridgeOptions): TcfBridge;
+
+/**
+ * The real `ConsentGate` (P2 contract). Orchestrates: synchronous conservative
+ * Consent Mode defaults → async CMP read via the TCF bridge → `gtag consent update`
+ * → per-vendor decision via the matrix → notify subscribers so the engine arms
+ * previously-gated vendors AND re-requests already-defined GPT slots.
+ *
+ * Require client CMP — no bundled banner (locked decision; P3 seam).
+ */
+
+interface ConsentGateDeps {
+    config?: ConsentConfig;
+    bus?: EventBus;
+    consentMode?: ConsentMode;
+    tcfBridge?: TcfBridge;
+}
+declare function createConsentGate(deps?: ConsentGateDeps): ConsentGate;
+
+/**
+ * Pure signals → per-vendor allow/deny decision. Unit-tested without any globals.
+ * One snapshot gates BOTH paths: GPT (render) and GA4/Pixel (tag) all derive from
+ * the same Consent Mode signals.
+ */
+
+/**
+ * v1 decision rules (conservative):
+ * - gpt          → needs `ad_storage` (serve personalised/standard ads).
+ * - ga4          → needs `analytics_storage`.
+ * - meta-pixel   → needs `ad_storage` (sets ad cookies / user data).
+ *
+ * Restricted/limited-ads mode (serving non-personalised under denied storage) is a
+ * P3 refinement; v1 gates the request outright when storage is denied.
+ */
+declare function vendorAllowed(vendor: VendorConsentId, signals: ConsentModeSignals): boolean;
+/** Build a per-vendor decision map for the known v1 vendors. */
+declare function vendorDecisionMap(signals: ConsentModeSignals): Record<"gpt" | "ga4" | "meta-pixel", boolean>;
+
+/**
+ * GPT render-path provider — implements the neutral `RenderProvider` contract. Every
+ * googletag call goes through `cmd.push` (gpt.js may not be loaded yet). Slots are
+ * null-guarded. PPID is set before the request; targeting/privacy via the Config API.
+ * gpt.js itself loads through the single TagInjector (allowlisted host).
+ */
+
+interface GptProviderDeps {
+    bus: EventBus;
+    injector?: TagInjector;
+    /** Allowlisted hosts (from plan.allowedTagHosts) used to load gpt.js. */
+    allowedHosts?: string[];
+    win?: Window;
+}
+declare function createGptProvider(deps: GptProviderDeps): RenderProvider;
+
+/**
+ * GA4 tag-path vendor (`kind:'analytics'`). Injects gtag.js via the single
+ * TagInjector (allowlisted host) and calls `gtag('config', id)`. Consent Mode
+ * defaults are set by Phase 4 BEFORE this loads (post-boot timing) — GA4 honors
+ * them; we never fire before defaults exist.
+ *
+ * (Dir named `tag-path/` rather than `vendor/` per the repo's scout-ignore filter;
+ * role is identical — the tag-path vendors from phase-03.)
+ */
+
+declare function createGa4Vendor(win?: Window): TagVendor;
+
+/**
+ * Meta Pixel tag-path vendor (`kind:'analytics'`). Injects fbevents.js via the
+ * single TagInjector (allowlisted host), `fbq('init', pixelId)` + `fbq('track', …)`.
+ * Each track emits a NORMALIZED event on the engine bus so a future CAPI forwarder
+ * can subscribe (brainstorm §5 seam) — client-side Pixel only captures ~50-60%
+ * under ATT; CAPI is P3-scope, no rework needed here.
+ *
+ * (Dir named `tag-path/` rather than `vendor/` per the repo's scout-ignore filter.)
+ */
+
+declare function createMetaPixelVendor(win?: Window): TagVendor;
+
+/**
+ * Script-tag (IIFE) surface. Exposes `window.AdsSDK` with a `cmd.push(...)`
+ * stub-queue: calls made before boot are queued, then drained in order once the
+ * client initializes. Auto-boot reads an inlined manifest + `data-*` intent markup.
+ */
+
+interface AdsSdkInitConfig {
+    /** Static fast-path: inlined manifest. */
+    manifest?: Manifest;
+    /** Approach-C path: fetch the plan from the public `/placement` endpoint. */
+    placement?: PlacementSource;
+    consent?: ConsentConfig;
+    context?: Partial<PlanContext>;
+}
+interface AdsSdkGlobal {
+    cmd: {
+        push: (fn: (client: AdsClient) => void) => void;
+    };
+    init(config: AdsSdkInitConfig): Promise<void>;
+    client?: AdsClient;
+}
+/** Parse `data-*` intent attributes from the booting <script> element. */
+declare function parseDataIntent(el: Element | null): {
+    dynamic: DynamicParams;
+    pageUrl?: string;
+};
+/**
+ * Install `window.AdsSDK`. Idempotent — a second install reuses the existing global
+ * (the engine's own page guard still prevents a second boot).
+ */
+declare function installAdsSdk(win?: Window): AdsSdkGlobal;
+
+export { AdsClient, type AdsSdkGlobal, type AdsSdkInitConfig, ConsentGate, type ConsentGateDeps, type ConsentMode, type DispatchTraits, EngineEvent, EventBus, type GptProviderDeps, PlacementSource, ProviderHandle, type PurposeConsents, RenderProvider, type SlotLifecycle, type SlotRecord, type SlotState, TagInjector, TagVendor, type TcData, type TcfApi, type TcfBridge, type TelemetrySink, VendorConsentId, attachTelemetry, createConsentGate, createConsentMode, createGa4Vendor, createGptProvider, createMetaPixelVendor, createSlotLifecycle, createTcfBridge, dispatchTraits, installAdsSdk, parseDataIntent, purposesToSignals, vendorAllowed, vendorDecisionMap };

package/dist/index.js

@@ -0,0 +1,88 @@
+import { createAdsClient } from './chunk-GA4VEFSM.js';
+export { BOOT_SPINE, assembleEngine, assembleEngineForPlacement, createAdapterSlotRegistry, createAdsClient, createAdsEngine, createAllowAllConsentGate, createConsentGate, createConsentMode, createEventBus, createGa4Vendor, createGptProvider, createLazyObserver, createMetaPixelVendor, createProviderRegistry, createSlotLifecycle, createTagInjector, createTcfBridge, dispatchTraits, purposesToSignals, vendorAllowed, vendorDecisionMap } from './chunk-GA4VEFSM.js';
+
+// src/core/telemetry-sink.ts
+var noopSink = () => {
+};
+function attachTelemetry(bus, sink = noopSink) {
+  const types = [
+    "slot:registered",
+    "slot:requested",
+    "slot:rendered",
+    "slot:empty",
+    "slot:destroyed",
+    "consent:changed",
+    "tag:injected",
+    "vendor:event",
+    "error",
+    "warning"
+  ];
+  const unsubs = types.map((t) => bus.on(t, (ev) => sink(ev)));
+  return () => unsubs.forEach((u) => u());
+}
+
+// src/wrappers/iife-boot.ts
+function parseDataIntent(el) {
+  const dynamic = {};
+  if (!el) return { dynamic };
+  const get = (name) => el.getAttribute(name);
+  const targeting = get("data-targeting");
+  if (targeting) {
+    try {
+      dynamic.targeting = JSON.parse(targeting);
+    } catch {
+    }
+  }
+  const ppid = get("data-ppid");
+  if (ppid) dynamic.ppid = ppid;
+  const pageUrl = get("data-page-url");
+  if (pageUrl) dynamic.pageUrl = pageUrl;
+  const privacy = get("data-privacy");
+  if (privacy) {
+    try {
+      dynamic.privacy = JSON.parse(privacy);
+    } catch {
+    }
+  }
+  const cc = get("data-change-correlator");
+  if (cc != null) dynamic.changeCorrelator = cc === "true";
+  return { dynamic, ...pageUrl ? { pageUrl } : {} };
+}
+function installAdsSdk(win = window) {
+  const existing = win.AdsSDK;
+  if (existing && existing.client) return existing;
+  const preStubbed = existing?.cmd;
+  const queued = Array.isArray(preStubbed) ? [...preStubbed] : [];
+  const api = {
+    cmd: {
+      push(fn) {
+        if (api.client) fn(api.client);
+        else queued.push(fn);
+      }
+    },
+    async init(config) {
+      const scriptEl = win.document?.currentScript ?? win.document?.querySelector("script[data-ads-sdk]");
+      const intent = parseDataIntent(scriptEl);
+      const context = {
+        ...config.context ?? {},
+        dynamic: { ...config.context?.dynamic ?? {}, ...intent.dynamic }
+      };
+      const client = createAdsClient({
+        ...config.manifest !== void 0 ? { manifest: config.manifest } : {},
+        ...config.placement ? { placement: config.placement } : {},
+        ...config.consent ? { consent: config.consent } : {},
+        context,
+        wire: { win }
+      });
+      await client.init();
+      api.client = client;
+      for (const fn of queued.splice(0)) fn(client);
+    }
+  };
+  win.AdsSDK = api;
+  return api;
+}
+
+export { attachTelemetry, installAdsSdk, parseDataIntent };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/telemetry-sink.ts","../src/wrappers/iife-boot.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Telemetry seam — subscribes to the event bus and forwards normalized events to a\n * sink. No-op in v1 (the sink does nothing); the seam exists so a reporting backend\n * (P3) can subscribe without engine changes.\n */\n\nimport type { EngineEvent, EventBus } from \"./event-bus.js\";\n\nexport type TelemetrySink = (ev: EngineEvent) => void;\n\nconst noopSink: TelemetrySink = () => {};\n\n/** Wire a sink to the bus. Returns an unsubscribe for all event types. */\nexport function attachTelemetry(bus: EventBus, sink: TelemetrySink = noopSink): () => void {\n  const types: EngineEvent[\"type\"][] = [\n    \"slot:registered\",\n    \"slot:requested\",\n    \"slot:rendered\",\n    \"slot:empty\",\n    \"slot:destroyed\",\n    \"consent:changed\",\n    \"tag:injected\",\n    \"vendor:event\",\n    \"error\",\n    \"warning\",\n  ];\n  const unsubs = types.map((t) => bus.on(t, (ev) => sink(ev as EngineEvent)));\n  return () => unsubs.forEach((u) => u());\n}\n","/**\n * Script-tag (IIFE) surface. Exposes `window.AdsSDK` with a `cmd.push(...)`\n * stub-queue: calls made before boot are queued, then drained in order once the\n * client initializes. Auto-boot reads an inlined manifest + `data-*` intent markup.\n */\n\nimport type { ConsentConfig, DynamicParams, Manifest, PlanContext } from \"@hientran0208/ads-manifest\";\nimport { createAdsClient, type AdsClient, type PlacementSource } from \"./ads-client.js\";\n\nexport interface AdsSdkInitConfig {\n  /** Static fast-path: inlined manifest. */\n  manifest?: Manifest;\n  /** Approach-C path: fetch the plan from the public `/placement` endpoint. */\n  placement?: PlacementSource;\n  consent?: ConsentConfig;\n  context?: Partial<PlanContext>;\n}\n\nexport interface AdsSdkGlobal {\n  cmd: { push: (fn: (client: AdsClient) => void) => void };\n  init(config: AdsSdkInitConfig): Promise<void>;\n  client?: AdsClient;\n}\n\n/** Parse `data-*` intent attributes from the booting <script> element. */\nexport function parseDataIntent(el: Element | null): { dynamic: DynamicParams; pageUrl?: string } {\n  const dynamic: DynamicParams = {};\n  if (!el) return { dynamic };\n  const get = (name: string) => el.getAttribute(name);\n\n  const targeting = get(\"data-targeting\");\n  if (targeting) {\n    try {\n      dynamic.targeting = JSON.parse(targeting);\n    } catch {\n      /* loose: ignore malformed targeting */\n    }\n  }\n  const ppid = get(\"data-ppid\");\n  if (ppid) dynamic.ppid = ppid;\n  const pageUrl = get(\"data-page-url\");\n  if (pageUrl) dynamic.pageUrl = pageUrl;\n  const privacy = get(\"data-privacy\");\n  if (privacy) {\n    try {\n      dynamic.privacy = JSON.parse(privacy);\n    } catch {\n      /* ignore */\n    }\n  }\n  const cc = get(\"data-change-correlator\");\n  if (cc != null) dynamic.changeCorrelator = cc === \"true\";\n\n  return { dynamic, ...(pageUrl ? { pageUrl } : {}) };\n}\n\n/**\n * Install `window.AdsSDK`. Idempotent — a second install reuses the existing global\n * (the engine's own page guard still prevents a second boot).\n */\nexport function installAdsSdk(win: Window = window): AdsSdkGlobal {\n  const existing = (win as unknown as { AdsSDK?: AdsSdkGlobal | { cmd?: unknown } }).AdsSDK;\n  if (existing && (existing as AdsSdkGlobal).client) return existing as AdsSdkGlobal;\n\n  // A page may pre-stub `window.AdsSDK = { cmd: [] }` (array) and push commands\n  // before this IIFE loads; capture them to drain after init, in order.\n  const preStubbed = existing?.cmd;\n  const queued: Array<(client: AdsClient) => void> = Array.isArray(preStubbed)\n    ? [...(preStubbed as Array<(c: AdsClient) => void>)]\n    : [];\n\n  const api: AdsSdkGlobal = {\n    cmd: {\n      push(fn) {\n        if (api.client) fn(api.client);\n        else queued.push(fn);\n      },\n    },\n    async init(config) {\n      const scriptEl = win.document?.currentScript ?? win.document?.querySelector(\"script[data-ads-sdk]\");\n      const intent = parseDataIntent(scriptEl);\n      const context: Partial<PlanContext> = {\n        ...(config.context ?? {}),\n        dynamic: { ...(config.context?.dynamic ?? {}), ...intent.dynamic },\n      };\n      const client = createAdsClient({\n        ...(config.manifest !== undefined ? { manifest: config.manifest } : {}),\n        ...(config.placement ? { placement: config.placement } : {}),\n        ...(config.consent ? { consent: config.consent } : {}),\n        context,\n        wire: { win },\n      });\n      await client.init();\n      api.client = client;\n      // Drain any pre-init queued commands in order.\n      for (const fn of queued.splice(0)) fn(client);\n    },\n  };\n\n  (win as unknown as { AdsSDK?: AdsSdkGlobal }).AdsSDK = api;\n  return api;\n}\n"]}