@adhese/sdk 0.21.0 → 0.22.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @adhese/sdk
 
+## 0.22.0
+
+### Minor Changes
+
+- 3ba6fd6: Add isVissible property to slots
+
+## 0.21.1
+
+### Patch Changes
+
+- 1feb9ff: Fix types not being published
+
 ## 0.21.0
 
 ### Minor Changes

package/dist/cjs/package.json.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const name = "@adhese/sdk";
-const version = "0.21.0";
+const version = "0.22.0";
 exports.name = name;
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.map

package/dist/cjs/slot/slot.cjs

@@ -201,6 +201,7 @@ function createSlot(slotOptions) {
       isDisposed,
       id,
       pluginOptions,
+      isVisible: isInViewport,
       render,
       request,
       dispose,

package/dist/cjs/slot/slot.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"slot.cjs","sources":["../../../src/slot/slot.ts"],"sourcesContent":["import {\n  type Ref,\n  type UnwrapRef,\n  addTrackingPixel,\n  computed,\n  doNothing,\n  effectScope,\n  generateName,\n  isDeepEqual,\n  omit,\n  reactive,\n  ref,\n  uniqueId,\n  waitForDomLoad,\n  watch,\n} from '@adhese/sdk-shared';\nimport type { AdheseAd } from '@adhese/sdk';\nimport { requestAd as extRequestAd } from '../requestAds/requestAds';\nimport { logger } from '../logger/logger';\nimport { useQueryDetector } from '../queryDetector/queryDetector';\nimport type { AdheseSlot, AdheseSlotContext, AdheseSlotOptions, RenderMode } from './slot.types';\nimport { renderIframe, renderInline } from './slot.utils';\nimport {\n  useDomLoaded,\n  useRenderIntersectionObserver,\n  useSlotHooks,\n  useViewabilityObserver,\n} from './slot.composables';\n\nconst renderFunctions: Record<RenderMode, (ad: AdheseAd, element: HTMLElement) => void> = {\n  iframe: renderIframe,\n  inline: renderInline,\n  none: doNothing,\n};\n\nconst defaultOptions = {\n  renderMode: 'iframe',\n  type: 'normal',\n} satisfies Partial<AdheseSlotOptions>;\n\n/**\n * Create a new slot instance. This slot instance can be used to request and render ads.\n *\n * @param slotOptions {AdheseSlotOptions} The options to create the slot with.\n *\n * @return AdheseSlot The created slot instance.\n */\nexport function createSlot(slotOptions: AdheseSlotOptions): AdheseSlot {\n  const scope = effectScope();\n\n  return scope.run(() => {\n    const slotContext = ref<AdheseSlotContext | null>(null);\n    const options = slotOptions.context.hooks.runOnSlotCreate({\n      ...defaultOptions,\n      ...slotOptions,\n    });\n\n    const {\n      containingElement,\n      slot,\n      context,\n      pluginOptions,\n      renderMode = 'iframe',\n      type = 'normal',\n    } = options;\n\n    const id = uniqueId();\n    const {\n      runOnBeforeRender,\n      runOnRender,\n      runOnBeforeRequest,\n      runOnRequest,\n      runOnInit,\n      runOnDispose,\n      ...hooks\n    } = useSlotHooks(options, slotContext);\n\n    const isDisposed = ref(false);\n    const parameters = reactive(new Map(Object.entries(options.parameters ?? {})));\n\n    const [device, disposeQueryDetector] = useQueryDetector(context, typeof options.format === 'string'\n      ? {\n          [options.format]: '(min-width: 0px)',\n        }\n      : Object.fromEntries(options.format.map(item => [item.format, item.query])));\n\n    const format = computed(() => typeof options.format === 'string' ? options.format : device.value);\n\n    const data = ref<AdheseAd | null>(null) as Ref<AdheseAd | null>;\n    const originalData = ref(data.value) as Ref<AdheseAd | null>;\n    const name = computed(() => generateName(options.context.location, format.value, options.slot));\n\n    watch(name, async (newName, oldName) => {\n      if (newName === oldName)\n        return;\n\n      const newAd = await slotContext.value?.request();\n\n      if (!newAd)\n        return;\n\n      slotContext.value?.cleanElement();\n\n      data.value = newAd;\n      originalData.value = newAd;\n    });\n\n    const isDomLoaded = useDomLoaded(context);\n\n    const element = computed(() => {\n      if (!(typeof options.containingElement === 'string' || !options.containingElement))\n        return options.containingElement;\n\n      if (!isDomLoaded.value || slotContext.value?.isDisposed)\n        return null;\n\n      return document.querySelector<HTMLElement>(`.adunit[data-format=\"${format.value}\"]#${options.containingElement}${options.slot ? `[data-slot=\"${options.slot}\"]` : ''}`);\n    },\n    );\n\n    const isInViewport = useRenderIntersectionObserver({\n      options,\n      element,\n      hooks,\n    });\n\n    const status = ref<UnwrapRef<AdheseSlot>['status']>('initializing');\n\n    watch([data, isInViewport], async ([newData, newIsInViewport], [oldData]) => {\n      if ((!newData || (oldData && isDeepEqual(newData, oldData))) && status.value === 'rendered')\n        return;\n\n      if (newIsInViewport)\n        await slotContext.value?.render(newData ?? undefined);\n    });\n\n    hooks.onDispose(() => {\n      disposeQueryDetector();\n    });\n\n    const isViewabilityTracked = useViewabilityObserver({\n      context,\n      slotContext,\n      hooks,\n      onTracked(trackingPixel) {\n        if (slotContext.value?.data?.viewableImpressionCounter) {\n          trackingPixel.value = addTrackingPixel(slotContext.value?.data?.viewableImpressionCounter);\n\n          context.logger.debug(`Viewability tracking pixel fired for ${slotContext.value?.name}`);\n        }\n      },\n    });\n\n    const impressionTrackingPixelElement = ref<HTMLImageElement | null>(null);\n    const isImpressionTracked = ref(false);\n    hooks.onDispose(() => {\n      if (impressionTrackingPixelElement.value)\n        impressionTrackingPixelElement.value.remove();\n    });\n\n    async function request(): Promise<AdheseAd | null> {\n      if (options.lazyLoading && !isInViewport.value)\n        return null;\n\n      status.value = 'loading';\n\n      let response = await runOnBeforeRequest(null);\n\n      if (!response) {\n        response = await extRequestAd({\n          slot: {\n            name: name.value,\n            parameters,\n          },\n          context,\n        });\n      }\n\n      if (response)\n        response = await runOnRequest(response);\n\n      data.value = response;\n\n      if (!originalData.value)\n        originalData.value = response;\n\n      status.value = response ? 'loaded' : 'empty';\n\n      if (!response)\n        cleanElement();\n\n      return response;\n    }\n\n    async function render(adToRender?: AdheseAd): Promise<HTMLElement | null> {\n      status.value = 'rendering';\n\n      await waitForDomLoad();\n\n      let renderAd = adToRender ?? data.value ?? originalData.value ?? await request();\n\n      renderAd = renderAd && await runOnBeforeRender(renderAd);\n\n      if (!renderAd) {\n        status.value = 'empty';\n        logger.debug(`No ad to render for slot ${name.value}`);\n\n        return null;\n      }\n\n      if (!element.value) {\n        const error = `Could not create slot for format ${format.value}. No element found.`;\n        logger.error(error, options);\n        throw new Error(error);\n      }\n\n      if (context.debug)\n        element.value.style.position = 'relative';\n\n      if (typeof renderAd?.tag !== 'string') {\n        const error = `Could not render slot for slot ${name.value}. A valid tag doesn't exist or is not HTML string.`;\n        logger.error(error, options);\n\n        status.value = 'error';\n        throw new Error(error);\n      }\n\n      renderFunctions[renderMode](renderAd, element.value);\n\n      if (renderAd.impressionCounter && !impressionTrackingPixelElement.value)\n        impressionTrackingPixelElement.value = addTrackingPixel(renderAd.impressionCounter);\n\n      isImpressionTracked.value = true;\n\n      logger.debug(`Slot rendered ${name.value}`, {\n        renderedElement: element,\n        location: context.location,\n        format,\n        containingElement,\n      });\n\n      // eslint-disable-next-line require-atomic-updates\n      data.value = renderAd;\n\n      status.value = 'rendered';\n\n      runOnRender(renderAd);\n\n      return element.value;\n    }\n\n    function cleanElement(): void {\n      if (!element.value)\n        return;\n\n      element.value.innerHTML = '';\n      element.value.style.position = '';\n      element.value.style.width = '';\n      element.value.style.height = '';\n\n      data.value = null;\n      originalData.value = null;\n    }\n\n    function dispose(): void {\n      cleanElement();\n\n      data.value = null;\n\n      runOnDispose();\n\n      isDisposed.value = true;\n\n      scope.stop();\n    }\n\n    const state = reactive({\n      location: context.location ?? '',\n      lazyLoading: options.lazyLoading ?? false,\n      type,\n      slot,\n      parameters,\n      format,\n      name,\n      data,\n      isViewabilityTracked,\n      isImpressionTracked,\n      status,\n      element,\n      isDisposed,\n      id,\n      pluginOptions,\n      render,\n      request,\n      dispose,\n      cleanElement,\n      options: omit(options, ['context']),\n      ...hooks,\n    });\n\n    watch(state, (newState) => {\n      slotContext.value = newState;\n    }, {\n      deep: true,\n      immediate: true,\n    });\n\n    context.hooks.onInit(async () => {\n      status.value = 'initialized';\n\n      runOnInit();\n\n      if (options.lazyLoading)\n        return;\n\n      data.value = await slotContext.value?.request() ?? null;\n    });\n\n    return state;\n  })!;\n}\n"],"names":["renderIframe","renderInline","doNothing","effectScope","ref","uniqueId","useSlotHooks","reactive","useQueryDetector","computed","generateName","watch","useDomLoaded","useRenderIntersectionObserver","isDeepEqual","useViewabilityObserver","addTrackingPixel","extRequestAd","waitForDomLoad","logger","omit"],"mappings":"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"}
+{"version":3,"file":"slot.cjs","sources":["../../../src/slot/slot.ts"],"sourcesContent":["import {\n  type Ref,\n  type UnwrapRef,\n  addTrackingPixel,\n  computed,\n  doNothing,\n  effectScope,\n  generateName,\n  isDeepEqual,\n  omit,\n  reactive,\n  ref,\n  uniqueId,\n  waitForDomLoad,\n  watch,\n} from '@adhese/sdk-shared';\nimport type { AdheseAd } from '@adhese/sdk';\nimport { requestAd as extRequestAd } from '../requestAds/requestAds';\nimport { logger } from '../logger/logger';\nimport { useQueryDetector } from '../queryDetector/queryDetector';\nimport type { AdheseSlot, AdheseSlotContext, AdheseSlotOptions, RenderMode } from './slot.types';\nimport { renderIframe, renderInline } from './slot.utils';\nimport {\n  useDomLoaded,\n  useRenderIntersectionObserver,\n  useSlotHooks,\n  useViewabilityObserver,\n} from './slot.composables';\n\nconst renderFunctions: Record<RenderMode, (ad: AdheseAd, element: HTMLElement) => void> = {\n  iframe: renderIframe,\n  inline: renderInline,\n  none: doNothing,\n};\n\nconst defaultOptions = {\n  renderMode: 'iframe',\n  type: 'normal',\n} satisfies Partial<AdheseSlotOptions>;\n\n/**\n * Create a new slot instance. This slot instance can be used to request and render ads.\n *\n * @param slotOptions {AdheseSlotOptions} The options to create the slot with.\n *\n * @return AdheseSlot The created slot instance.\n */\nexport function createSlot(slotOptions: AdheseSlotOptions): AdheseSlot {\n  const scope = effectScope();\n\n  return scope.run(() => {\n    const slotContext = ref<AdheseSlotContext | null>(null);\n    const options = slotOptions.context.hooks.runOnSlotCreate({\n      ...defaultOptions,\n      ...slotOptions,\n    });\n\n    const {\n      containingElement,\n      slot,\n      context,\n      pluginOptions,\n      renderMode = 'iframe',\n      type = 'normal',\n    } = options;\n\n    const id = uniqueId();\n    const {\n      runOnBeforeRender,\n      runOnRender,\n      runOnBeforeRequest,\n      runOnRequest,\n      runOnInit,\n      runOnDispose,\n      ...hooks\n    } = useSlotHooks(options, slotContext);\n\n    const isDisposed = ref(false);\n    const parameters = reactive(new Map(Object.entries(options.parameters ?? {})));\n\n    const [device, disposeQueryDetector] = useQueryDetector(context, typeof options.format === 'string'\n      ? {\n          [options.format]: '(min-width: 0px)',\n        }\n      : Object.fromEntries(options.format.map(item => [item.format, item.query])));\n\n    const format = computed(() => typeof options.format === 'string' ? options.format : device.value);\n\n    const data = ref<AdheseAd | null>(null) as Ref<AdheseAd | null>;\n    const originalData = ref(data.value) as Ref<AdheseAd | null>;\n    const name = computed(() => generateName(options.context.location, format.value, options.slot));\n\n    watch(name, async (newName, oldName) => {\n      if (newName === oldName)\n        return;\n\n      const newAd = await slotContext.value?.request();\n\n      if (!newAd)\n        return;\n\n      slotContext.value?.cleanElement();\n\n      data.value = newAd;\n      originalData.value = newAd;\n    });\n\n    const isDomLoaded = useDomLoaded(context);\n\n    const element = computed(() => {\n      if (!(typeof options.containingElement === 'string' || !options.containingElement))\n        return options.containingElement;\n\n      if (!isDomLoaded.value || slotContext.value?.isDisposed)\n        return null;\n\n      return document.querySelector<HTMLElement>(`.adunit[data-format=\"${format.value}\"]#${options.containingElement}${options.slot ? `[data-slot=\"${options.slot}\"]` : ''}`);\n    },\n    );\n\n    const isInViewport = useRenderIntersectionObserver({\n      options,\n      element,\n      hooks,\n    });\n\n    const status = ref<UnwrapRef<AdheseSlot>['status']>('initializing');\n\n    watch([data, isInViewport], async ([newData, newIsInViewport], [oldData]) => {\n      if ((!newData || (oldData && isDeepEqual(newData, oldData))) && status.value === 'rendered')\n        return;\n\n      if (newIsInViewport)\n        await slotContext.value?.render(newData ?? undefined);\n    });\n\n    hooks.onDispose(() => {\n      disposeQueryDetector();\n    });\n\n    const isViewabilityTracked = useViewabilityObserver({\n      context,\n      slotContext,\n      hooks,\n      onTracked(trackingPixel) {\n        if (slotContext.value?.data?.viewableImpressionCounter) {\n          trackingPixel.value = addTrackingPixel(slotContext.value?.data?.viewableImpressionCounter);\n\n          context.logger.debug(`Viewability tracking pixel fired for ${slotContext.value?.name}`);\n        }\n      },\n    });\n\n    const impressionTrackingPixelElement = ref<HTMLImageElement | null>(null);\n    const isImpressionTracked = ref(false);\n    hooks.onDispose(() => {\n      if (impressionTrackingPixelElement.value)\n        impressionTrackingPixelElement.value.remove();\n    });\n\n    async function request(): Promise<AdheseAd | null> {\n      if (options.lazyLoading && !isInViewport.value)\n        return null;\n\n      status.value = 'loading';\n\n      let response = await runOnBeforeRequest(null);\n\n      if (!response) {\n        response = await extRequestAd({\n          slot: {\n            name: name.value,\n            parameters,\n          },\n          context,\n        });\n      }\n\n      if (response)\n        response = await runOnRequest(response);\n\n      data.value = response;\n\n      if (!originalData.value)\n        originalData.value = response;\n\n      status.value = response ? 'loaded' : 'empty';\n\n      if (!response)\n        cleanElement();\n\n      return response;\n    }\n\n    async function render(adToRender?: AdheseAd): Promise<HTMLElement | null> {\n      status.value = 'rendering';\n\n      await waitForDomLoad();\n\n      let renderAd = adToRender ?? data.value ?? originalData.value ?? await request();\n\n      renderAd = renderAd && await runOnBeforeRender(renderAd);\n\n      if (!renderAd) {\n        status.value = 'empty';\n        logger.debug(`No ad to render for slot ${name.value}`);\n\n        return null;\n      }\n\n      if (!element.value) {\n        const error = `Could not create slot for format ${format.value}. No element found.`;\n        logger.error(error, options);\n        throw new Error(error);\n      }\n\n      if (context.debug)\n        element.value.style.position = 'relative';\n\n      if (typeof renderAd?.tag !== 'string') {\n        const error = `Could not render slot for slot ${name.value}. A valid tag doesn't exist or is not HTML string.`;\n        logger.error(error, options);\n\n        status.value = 'error';\n        throw new Error(error);\n      }\n\n      renderFunctions[renderMode](renderAd, element.value);\n\n      if (renderAd.impressionCounter && !impressionTrackingPixelElement.value)\n        impressionTrackingPixelElement.value = addTrackingPixel(renderAd.impressionCounter);\n\n      isImpressionTracked.value = true;\n\n      logger.debug(`Slot rendered ${name.value}`, {\n        renderedElement: element,\n        location: context.location,\n        format,\n        containingElement,\n      });\n\n      // eslint-disable-next-line require-atomic-updates\n      data.value = renderAd;\n\n      status.value = 'rendered';\n\n      runOnRender(renderAd);\n\n      return element.value;\n    }\n\n    function cleanElement(): void {\n      if (!element.value)\n        return;\n\n      element.value.innerHTML = '';\n      element.value.style.position = '';\n      element.value.style.width = '';\n      element.value.style.height = '';\n\n      data.value = null;\n      originalData.value = null;\n    }\n\n    function dispose(): void {\n      cleanElement();\n\n      data.value = null;\n\n      runOnDispose();\n\n      isDisposed.value = true;\n\n      scope.stop();\n    }\n\n    const state = reactive({\n      location: context.location ?? '',\n      lazyLoading: options.lazyLoading ?? false,\n      type,\n      slot,\n      parameters,\n      format,\n      name,\n      data,\n      isViewabilityTracked,\n      isImpressionTracked,\n      status,\n      element,\n      isDisposed,\n      id,\n      pluginOptions,\n      isVisible: isInViewport,\n      render,\n      request,\n      dispose,\n      cleanElement,\n      options: omit(options, ['context']),\n      ...hooks,\n    });\n\n    watch(state, (newState) => {\n      slotContext.value = newState;\n    }, {\n      deep: true,\n      immediate: true,\n    });\n\n    context.hooks.onInit(async () => {\n      status.value = 'initialized';\n\n      runOnInit();\n\n      if (options.lazyLoading)\n        return;\n\n      data.value = await slotContext.value?.request() ?? null;\n    });\n\n    return state;\n  })!;\n}\n"],"names":["renderIframe","renderInline","doNothing","effectScope","ref","uniqueId","useSlotHooks","reactive","useQueryDetector","computed","generateName","watch","useDomLoaded","useRenderIntersectionObserver","isDeepEqual","useViewabilityObserver","addTrackingPixel","extRequestAd","waitForDomLoad","logger","omit"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,666 @@
+import * as _adhese_sdk_shared from '@adhese/sdk-shared';
+import { createAsyncHook, createPassiveHook, Ref, Merge, MaybeRef, UrlString, EventManager } from '@adhese/sdk-shared';
+import * as _adhese_sdk_shared_validators from '@adhese/sdk-shared/validators';
+import { TypeOf, ZodType } from '@adhese/sdk-shared/validators';
+
+type RenderMode = 'iframe' | 'inline' | 'none';
+type AdheseSlotHooks = {
+    /**
+     * Hook that is called when the format of the slot changes.
+     */
+    onBeforeRender: ReturnType<typeof createAsyncHook<AdheseAd>>[1];
+    /**
+     * Hook that is called when the slot is rendered.
+     */
+    onRender: ReturnType<typeof createPassiveHook<AdheseAd>>[1];
+    /**
+     * Hook that is called before the slot is requested from the server.
+     */
+    onBeforeRequest: ReturnType<typeof createAsyncHook<AdheseAd | null>>[1];
+    /**
+     * Hook that is called when the slot is requested from the server.
+     */
+    onRequest: ReturnType<typeof createAsyncHook<AdheseAd>>[1];
+    /**
+     * Hook that is called when the slot is initialized.
+     */
+    onInit: ReturnType<typeof createPassiveHook>[1];
+    /**
+     * Hook that is called when the slot is disposed.
+     */
+    onDispose: ReturnType<typeof createPassiveHook>[1];
+};
+type AdheseSlotOptions = {
+    /**
+     * The format code of the slot. Used to find the correct element on the page to render the ad in. If the format is a
+     * string, it is used as the format code. If the format is an array, the format code is determined by the query
+     * detector.
+     */
+    format: string | ReadonlyArray<{
+        format: string;
+        query: string;
+    }>;
+    /**
+     * Type of the slot. On its own has no effect, but can be used by plugins to create different behavior for different
+     * types of slots.
+     */
+    type?: string;
+    /**
+     * If we have multiple slots with the same format, we can use this to differentiate between them.
+     */
+    slot?: string;
+    /**
+     * The element that contains the slot. Used to find the correct element on the page to render the ad in.
+     */
+    containingElement?: string | HTMLElement;
+    /**
+     * The parameters that are used to render the ad.
+     */
+    parameters?: Record<string, ReadonlyArray<string> | string>;
+    /**
+     * The Adhese context
+     */
+    context: AdheseContext;
+    /**
+     * The render mode of the slot.
+     *
+     * - `iframe`: The ad will be rendered in an iframe.
+     * - `inline`: The ad will be rendered in the containing element.
+     *
+     * @default 'iframe'
+     */
+    renderMode?: RenderMode;
+    /**
+     * Specific options for the slot that may be used my plugins
+     */
+    pluginOptions?: Record<string, unknown>;
+    /**
+     * Special callback that is run when the slot is initialized. It passes the slot context ref object and a special
+     * plugin object that contains a set of hooks you can use to hook into different moments of the slots lifecycle.
+     */
+    setup?(context: Ref<AdheseSlotContext | null>, hooks: AdheseSlotHooks): void;
+} & ({
+    /**
+     * If the slot should be lazy loaded. This means that the ad will only be requested when the slot is in the viewport.
+     * If `true`, the slot will handle the request itself and render the ad.
+     */
+    lazyLoading: true;
+    lazyLoadingOptions?: {
+        /**
+         * The root margin of the intersection observer. This is used to determine when the slot is in the viewport.
+         */
+        rootMargin?: string;
+    };
+} | {
+    lazyLoading?: false;
+    lazyLoadingOptions?: never;
+});
+type BaseAdheseSlot = Merge<Omit<AdheseSlotOptions, 'onDispose' | 'context' | 'onFormatChange' | 'format'>, AdheseSlotHooks & {
+    /**
+     * Type of the slot. On its own has no effect, but can be used by plugins to create different behavior for different
+     * types of slots.
+     */
+    type?: string;
+    /**
+     * The name of the slot. This is used to identify the slot in the Adhese instance.
+     *
+     * The name is generated based on the location, format, and slot of the slot.
+     */
+    name: string;
+    /**
+     * The format code of the slot. Used to find the correct element on the page to render the ad in.
+     *
+     * If the format is a string, it is used as the format code. If the format is an array, the format code is determined
+     * by the query detector.
+     *
+     * When you change the format, the slot will request a new ad from the API automatically.
+     */
+    format: string;
+    /**
+     * The location of the slot. This is the location that is used to determine the current page URL.
+     */
+    location: string;
+    /**
+     * The parameters that are used to render the ad.
+     */
+    parameters: Map<string, ReadonlyArray<string> | string>;
+    /**
+     * Whether the viewability tracking pixel has been fired.
+     */
+    readonly isViewabilityTracked: boolean;
+    /**
+     * Whether the impression tracking pixel has been fired.
+     */
+    readonly isImpressionTracked: boolean;
+    /**
+     * The state of the slot is currently in.
+     *
+     * - `initializing`: The slot is initializing.
+     * - `initialized`: The slot is initialized.
+     * - `loading`: The slot is loading data from the API
+     * - `loaded`: The slot has loaded data from the API and is ready to render
+     * - `empty`: The slot has loaded data from the API but the response was empty
+     * - `rendering`: The slot is rendering the ad
+     * - `rendered`: The slot has rendered the ad
+     * - `error`: The slot has encountered an error
+     */
+    status: 'initializing' | 'initialized' | 'loading' | 'loaded' | 'empty' | 'rendering' | 'rendered' | 'error';
+    /**
+     * Is the slot disposed.
+     */
+    isDisposed: boolean;
+    /**
+     * The element that contains the slot.
+     */
+    element: HTMLElement | null;
+    /**
+     * Unique identifier of the slot. ID is generated on initialization and will never change.
+     */
+    id: string;
+    /**
+     * Slot related data fetched from the API.
+     */
+    data: AdheseAd | null;
+    /**
+     * Options slot was created with
+     */
+    options: Omit<AdheseSlotOptions, 'context'>;
+    /**
+     * Is the slot visible in the viewport.
+     */
+    isVisible: boolean;
+    /**
+     * Renders the slot in the containing element. If no data is provided, new data will be requested from the API.
+     */
+    render(data?: AdheseAd): Promise<HTMLElement | null>;
+    /**
+     * Requests a new ad from the API and returns the ad object.
+     */
+    request(): Promise<AdheseAd | null>;
+    /**
+     * Remove the HTML element contents from the dom.
+     */
+    cleanElement(): void;
+    /**
+     * Removes the slot from the DOM and cleans up the slot instance.
+     */
+    dispose(): void;
+}>;
+type AdheseSlotContext = BaseAdheseSlot;
+type ReadonlyProps$1 = 'type' | 'name' | 'format' | 'location' | 'status' | 'isDisposed' | 'element' | 'id';
+type AdheseSlot = Omit<BaseAdheseSlot, ReadonlyProps$1> & Readonly<Pick<BaseAdheseSlot, ReadonlyProps$1>>;
+
+type AdheseSlotManager = {
+    /**
+     * Returns all slots that are currently registered and rendered.
+     */
+    getAll(): ReadonlyArray<AdheseSlot>;
+    /**
+     * Adds a new slot to the Adhese instance and renders it.
+     */
+    add(slot: Omit<AdheseSlotOptions, 'context'>): Readonly<AdheseSlot>;
+    /**
+     * Finds all slots in the DOM and adds them to the Adhese instance.
+     */
+    findDomSlots(): Promise<ReadonlyArray<AdheseSlot>>;
+    /**
+     * Returns the slot with the given name.
+     */
+    get(name: string): AdheseSlot | undefined;
+    /**
+     * Removes all slots from the Adhese instance and cleans up the slot manager.
+     */
+    dispose(): void;
+};
+type SlotManagerOptions = {
+    /**
+     * List of initial slots to add to the slot manager.
+     */
+    initialSlots?: ReadonlyArray<Merge<Omit<AdheseSlotOptions, 'containingElement' | 'context' | 'lazy'>, {
+        containingElement: string;
+    }>>;
+    context: AdheseContext;
+};
+
+declare const baseSchema: _adhese_sdk_shared_validators.ZodObject<{
+    adDuration: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, number | undefined, string>>;
+    adFormat: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    adType: _adhese_sdk_shared_validators.ZodString;
+    additionalCreativeTracker: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    additionalViewableTracker: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    adspaceEnd: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, Date | undefined, string>>;
+    adspaceId: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    adspaceKey: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    adspaceStart: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, Date | undefined, string>>;
+    advertiserId: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    altText: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    auctionable: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodBoolean, _adhese_sdk_shared_validators.ZodLiteral<"">]>>;
+    body: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodString, Record<string, unknown> | readonly unknown[], string>, _adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodString, string, string>]>]>, string | Record<string, unknown> | readonly unknown[] | undefined, string>>;
+    clickTag: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    comment: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    creativeName: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    deliveryGroupId: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    deliveryMultiples: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    ext: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    extension: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodObject<{
+        mediaType: _adhese_sdk_shared_validators.ZodString;
+        prebid: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodUnknown>;
+    }, "strip", _adhese_sdk_shared_validators.ZodTypeAny, {
+        mediaType: string;
+        prebid?: unknown;
+    }, {
+        mediaType: string;
+        prebid?: unknown;
+    }>>;
+    height: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, number | undefined, string>>;
+    id: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    impressionCounter: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    libId: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    orderId: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    orderName: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    orderProperty: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    origin: _adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodLiteral<"JERLICIA">, _adhese_sdk_shared_validators.ZodLiteral<"DALE">]>;
+    originData: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodUnknown>;
+    originInstance: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    poolPath: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    preview: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodBoolean, _adhese_sdk_shared_validators.ZodLiteral<"">]>>;
+    priority: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, number | undefined, string>>;
+    sfSrc: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    share: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodString>;
+    slotID: _adhese_sdk_shared_validators.ZodString;
+    slotName: _adhese_sdk_shared_validators.ZodString;
+    swfSrc: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    tag: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodString, Record<string, unknown> | readonly unknown[], string>, _adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodString, string, string>]>]>, string | Record<string, unknown> | readonly unknown[] | undefined, string>>;
+    tagUrl: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    timeStamp: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, Date | undefined, string>>;
+    trackedImpressionCounter: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    tracker: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    trackingUrl: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    url: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    viewableImpressionCounter: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, URL | undefined, string>>;
+    width: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">]>, number | undefined, string>>;
+    widthLarge: _adhese_sdk_shared_validators.ZodOptional<_adhese_sdk_shared_validators.ZodEffects<_adhese_sdk_shared_validators.ZodUnion<[_adhese_sdk_shared_validators.ZodString, _adhese_sdk_shared_validators.ZodLiteral<"">, _adhese_sdk_shared_validators.ZodNumber]>, string | undefined, string | number>>;
+}, "strip", _adhese_sdk_shared_validators.ZodTypeAny, {
+    adType: string;
+    origin: "JERLICIA" | "DALE";
+    slotID: string;
+    slotName: string;
+    adDuration?: number | undefined;
+    adFormat?: string | undefined;
+    additionalCreativeTracker?: URL | undefined;
+    additionalViewableTracker?: string | undefined;
+    adspaceEnd?: Date | undefined;
+    adspaceId?: string | undefined;
+    adspaceKey?: string | undefined;
+    adspaceStart?: Date | undefined;
+    advertiserId?: string | undefined;
+    altText?: string | undefined;
+    auctionable?: boolean | "" | undefined;
+    body?: string | Record<string, unknown> | readonly unknown[] | undefined;
+    clickTag?: URL | undefined;
+    comment?: string | undefined;
+    creativeName?: string | undefined;
+    deliveryGroupId?: string | undefined;
+    deliveryMultiples?: string | undefined;
+    ext?: string | undefined;
+    extension?: {
+        mediaType: string;
+        prebid?: unknown;
+    } | undefined;
+    height?: number | undefined;
+    id?: string | undefined;
+    impressionCounter?: URL | undefined;
+    libId?: string | undefined;
+    orderId?: string | undefined;
+    orderName?: string | undefined;
+    orderProperty?: string | undefined;
+    originData?: unknown;
+    originInstance?: string | undefined;
+    poolPath?: URL | undefined;
+    preview?: boolean | "" | undefined;
+    priority?: number | undefined;
+    sfSrc?: URL | undefined;
+    share?: string | undefined;
+    swfSrc?: URL | undefined;
+    tag?: string | Record<string, unknown> | readonly unknown[] | undefined;
+    tagUrl?: URL | undefined;
+    timeStamp?: Date | undefined;
+    trackedImpressionCounter?: URL | undefined;
+    tracker?: URL | undefined;
+    trackingUrl?: URL | undefined;
+    url?: URL | undefined;
+    viewableImpressionCounter?: URL | undefined;
+    width?: number | undefined;
+    widthLarge?: string | undefined;
+}, {
+    adType: string;
+    origin: "JERLICIA" | "DALE";
+    slotID: string;
+    slotName: string;
+    adDuration?: string | undefined;
+    adFormat?: string | undefined;
+    additionalCreativeTracker?: string | undefined;
+    additionalViewableTracker?: string | undefined;
+    adspaceEnd?: string | undefined;
+    adspaceId?: string | undefined;
+    adspaceKey?: string | undefined;
+    adspaceStart?: string | undefined;
+    advertiserId?: string | undefined;
+    altText?: string | undefined;
+    auctionable?: boolean | "" | undefined;
+    body?: string | undefined;
+    clickTag?: string | undefined;
+    comment?: string | undefined;
+    creativeName?: string | undefined;
+    deliveryGroupId?: string | undefined;
+    deliveryMultiples?: string | undefined;
+    ext?: string | undefined;
+    extension?: {
+        mediaType: string;
+        prebid?: unknown;
+    } | undefined;
+    height?: string | undefined;
+    id?: string | undefined;
+    impressionCounter?: string | undefined;
+    libId?: string | undefined;
+    orderId?: string | undefined;
+    orderName?: string | undefined;
+    orderProperty?: string | undefined;
+    originData?: unknown;
+    originInstance?: string | undefined;
+    poolPath?: string | undefined;
+    preview?: boolean | "" | undefined;
+    priority?: string | undefined;
+    sfSrc?: string | undefined;
+    share?: string | undefined;
+    swfSrc?: string | undefined;
+    tag?: string | undefined;
+    tagUrl?: string | undefined;
+    timeStamp?: string | undefined;
+    trackedImpressionCounter?: string | undefined;
+    tracker?: string | undefined;
+    trackingUrl?: string | undefined;
+    url?: string | undefined;
+    viewableImpressionCounter?: string | undefined;
+    width?: string | undefined;
+    widthLarge?: string | number | undefined;
+}>;
+type AdResponse = (TypeOf<typeof baseSchema> & {
+    additionalCreatives?: ReadonlyArray<AdResponse> | string;
+});
+declare const adResponseSchema: ZodType<AdResponse>;
+type PreParsedAd = TypeOf<typeof adResponseSchema> & {
+    additionalCreatives?: ReadonlyArray<PreParsedAd> | string;
+};
+type AdheseAd<T = string | Record<string, unknown> | ReadonlyArray<unknown>> = Omit<PreParsedAd, 'tag'> & {
+    tag: T | string;
+};
+
+type AdRequestOptions = {
+    /**
+     * Slot you want to fetch the ad for
+     */
+    slot: {
+        name: MaybeRef<string>;
+        parameters: Map<string, ReadonlyArray<string> | string>;
+    };
+    context: AdheseContext;
+};
+type AdMultiRequestOptions = Omit<AdRequestOptions, 'slot'> & {
+    slots: ReadonlyArray<AdRequestOptions['slot']>;
+};
+
+declare const logger: _adhese_sdk_shared.Logger<"error" | "trace" | "debug" | "info" | "warn">;
+
+declare function createGlobalHooks(): {
+    runOnInit: (arg: void) => void;
+    onInit: (callback: (arg: void) => void | Promise<void>) => () => void;
+    runOnDispose: (arg: void) => void;
+    onDispose: (callback: (arg: void) => void | Promise<void>) => () => void;
+    runOnRequest: (arg: AdMultiRequestOptions) => Promise<AdMultiRequestOptions>;
+    onRequest: (callback: (arg: AdMultiRequestOptions) => void | AdMultiRequestOptions | Promise<void | AdMultiRequestOptions>) => () => void;
+    runOnResponse: (arg: readonly AdheseAd[]) => Promise<readonly AdheseAd[]>;
+    onResponse: (callback: (arg: readonly AdheseAd[]) => void | readonly AdheseAd[] | Promise<void | readonly AdheseAd[]>) => () => void;
+    runOnSlotCreate: (arg: AdheseSlotOptions) => AdheseSlotOptions;
+    onSlotCreate: (callback: (arg: AdheseSlotOptions) => void | Promise<void> | AdheseSlotOptions) => () => void;
+    clearAll: () => void;
+};
+
+type AdhesePluginInformation = {
+    index: number;
+    version: string;
+    hooks: ReturnType<typeof createGlobalHooks>;
+};
+type AdhesePlugin<T extends {
+    name: string;
+} & Record<string, unknown> = {
+    name: string;
+} & Record<string, unknown>> = (context: AdheseContext, plugin: AdhesePluginInformation) => T;
+type BaseOptions = {
+    /**
+     * The Adhese account name.
+     */
+    account: string;
+    /**
+     * The url that is used to connect to the Adhese ad server. Pass a custom URL if you want to use your own domain for
+     * the connection.
+     *
+     * @default 'https://ads-{{account}}.adhese.com'
+     */
+    host?: UrlString;
+    /**
+     * The url that is used to connect to the Adhese pool server. Pass a custom URL if you want to use your own domain for
+     * the connection.
+     *
+     * @default 'https://pool-{{account}}.adhese.com'
+     */
+    poolHost?: UrlString;
+    /**
+     * The page location. This is used to determine the current page location identifier.
+     */
+    location?: string;
+    /**
+     * The requestAds type to use for the Adhese API requests. This can be either `GET` or `POST`. `POST` is the default
+     * and offers the most options. `GET` is more limited as it needs pass its data as search parameters but can be used
+     * in environments where `POST` requests are not allowed.
+     *
+     * @default 'POST'
+     */
+    requestType?: 'GET' | 'POST';
+    /**
+     * Enable debug logging.
+     *
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Find all slots in the DOM and add them to the Adhese instance during initialization.
+     *
+     * @default false
+     */
+    findDomSlotsOnLoad?: boolean;
+    /**
+     * Additional parameters to send with each request. Make sure that the keys of a parameter only contain `2` characters.
+     */
+    parameters?: Record<string, ReadonlyArray<string> | string>;
+    /**
+     * The consent type to use for the Adhese API requests. This can be either `true` or `false`. `false` is the default and
+     * will send all consent data to the Adhese API. `false` will send no consent data to the Adhese API.
+     *
+     * @default false
+     */
+    consent?: boolean;
+    /**
+     * Will log the `document.referrer` to the Adhese API in a BASE64 string with the `re` parameter.
+     *
+     * @default true
+     */
+    logReferrer?: boolean;
+    /**
+     * Will log the `window.location.href` to the Adhese API in a BASE64 string with the `ur` parameter.
+     *
+     * @default true
+     */
+    logUrl?: boolean;
+    /**
+     * If `true`, ads will be rendered immediately after they are fetched from the API. If `false`, ads will only be
+     * rendered when the slot is in the viewport.
+     *
+     * @default false
+     */
+    eagerRendering?: boolean;
+    /**
+     * The query detector options for the Adhese instance.
+     */
+    queries?: Record<string, string>;
+} & ({
+    viewabilityTracking?: true;
+    /**
+     * Options for the viewability tracking of the ads. If `true` or `undefined`, the default viewability tracking options will be used.
+     *
+     * @default true
+     */
+    viewabilityTrackingOptions?: {
+        /**
+         * Fraction of the ad that needs to be in the viewport for the ad to be considered viewable.
+         *
+         * @default 0.2
+         */
+        threshold?: number;
+        /**
+         * The duration the ad needs to be in the viewport for the ad to be considered viewable in milliseconds.
+         *
+         * @default 1000
+         */
+        duration?: number;
+        /**
+         * The margin around the viewport where the ad is considered viewable.
+         *
+         * @default '0px'
+         */
+        rootMargin?: string;
+    };
+} | {
+    viewabilityTracking?: false;
+    viewabilityTrackingOptions?: never;
+}) & Pick<SlotManagerOptions, 'initialSlots'>;
+type AdheseOptions<T extends ReadonlyArray<AdhesePlugin> = []> = BaseOptions & {
+    /**
+     * The plugins that are used for the Adhese instance.
+     */
+    plugins?: T['length'] extends 0 ? ReadonlyArray<AdhesePlugin> : T;
+};
+type MergedOptions = Merge<BaseOptions, Required<Pick<BaseOptions, 'host' | 'poolHost' | 'location' | 'requestType' | 'debug' | 'initialSlots' | 'findDomSlotsOnLoad' | 'consent' | 'logUrl' | 'logReferrer' | 'eagerRendering' | 'viewabilityTracking'>>>;
+type AdheseEvents = {
+    locationChange: string;
+    consentChange: boolean;
+    addSlot: AdheseSlot;
+    removeSlot: AdheseSlot;
+    responseReceived: ReadonlyArray<AdheseAd>;
+    requestAd: AdMultiRequestOptions;
+    requestError: Error;
+    previewReceived: ReadonlyArray<AdheseAd>;
+    parametersChange: Map<string, ReadonlyArray<string> | string>;
+    debugChange: boolean;
+};
+type BaseAdhese = {
+    /**
+     * The slots that are in the Adhese instance.
+     */
+    slots: Map<string, AdheseSlot>;
+    /**
+     * The page location. This is used to determine the current page location identifier.
+     */
+    location: string;
+    /**
+     * The consent type to use for the Adhese API requests. This can be either `true` or `false`. `false` is the default and
+     * will send all consent data to the Adhese API. `false` will send no consent data to the Adhese API.
+     */
+    consent: boolean;
+    /**
+     * String that is generated by either the binary consent passed with `consent` property or the value passed by the TCF
+     * API. If consent is `true` the string will be `all` otherwise it will be `none`. If the consent is coming from TCF
+     * the string will be the TCF string.
+     */
+    consentString?: string;
+    /**
+     * The logger instance that is used for multi level console logging
+     */
+    logger: typeof logger;
+    /**
+     * Debug mode of the Adhese instance. When set to true will log verbose logs to the console and will load the Devtools.
+     */
+    debug: boolean;
+    /**
+     * The parameters that are used for all ads.
+     */
+    parameters: Map<string, ReadonlyArray<string> | string>;
+    /**
+     * The event manager for the Adhese instance.
+     */
+    events: EventManager<AdheseEvents>;
+    /**
+     * Options passed to the Adhese instance.
+     */
+    options: Readonly<MergedOptions>;
+    /**
+     * Is the instance disposed
+     */
+    isDisposed: boolean;
+    /**
+     * Active media query device
+     */
+    device: string;
+    /**
+     * Get a slot by name.
+     * @param name The name of the slot.
+     */
+    get(name: string): AdheseSlot | undefined;
+    /**
+     * Get all slots in the Adhese instance.
+     */
+    getAll(): ReadonlyArray<AdheseSlot>;
+    /**
+     * Adds a new slot to the Adhese instance and renders it.
+     */
+    addSlot(slot: Omit<AdheseSlotOptions, 'location' | 'context'>): Readonly<AdheseSlot>;
+    /**
+     * Finds all slots in the DOM and adds them to the Adhese instance.
+     */
+    findDomSlots(): Promise<ReadonlyArray<AdheseSlot>>;
+    /**
+     * Removes all slots from the Adhese instance and cleans up the Adhese instance.
+     *
+     * After calling this method, the Adhese instance is no longer usable.
+     */
+    dispose(): void;
+};
+type ExtractFromTupleWithNameKey<T extends string, U extends Record<string, unknown>> = U extends {
+    name: T;
+} ? U : never;
+type Plugins<T extends ReadonlyArray<AdhesePlugin> = [], U extends {
+    name: string;
+} = ReturnType<Required<AdheseOptions<T>>['plugins'][number]>> = {
+    [K in U['name']]: Omit<ExtractFromTupleWithNameKey<K, U>, 'name'>;
+};
+type ReadonlyProps = 'options' | 'isDisposed' | 'logger' | 'events' | 'get' | 'getAll' | 'addSlot' | 'findDomSlots' | 'dispose' | 'slots' | 'device' | 'consentString';
+type Adhese<T extends ReadonlyArray<AdhesePlugin> = []> = Omit<BaseAdhese, ReadonlyProps> & Readonly<Pick<BaseAdhese, ReadonlyProps>> & {
+    plugins: Plugins<T>;
+};
+type AdheseContextState = Omit<BaseAdhese, 'options'> & {
+    readonly options: MergedOptions;
+    hooks: ReturnType<typeof createGlobalHooks>;
+};
+type NonPartialProps = 'options' | 'logger' | 'events' | 'isDisposed' | 'location' | 'consent' | 'debug' | 'parameters' | 'slots' | 'hooks';
+type AdheseContext = Omit<Partial<AdheseContextState>, NonPartialProps> & Pick<AdheseContextState, NonPartialProps>;
+
+/**
+ * Creates an Adhese instance. This instance is your main entry point to the Adhese API.
+ *
+ * @param options {AdheseOptions} The options to create the Adhese instance with. See the {@link AdheseOptions} type for more information.
+ *
+ * @return Adhese The Adhese instance.
+ */
+declare function createAdhese<T extends ReadonlyArray<AdhesePlugin>>(options: AdheseOptions<T>): Adhese<T>;
+
+export { type AdRequestOptions, type Adhese, type AdheseAd, type AdheseContext, type AdheseOptions, type AdhesePlugin, type AdhesePluginInformation, type AdheseSlot, type AdheseSlotContext, type AdheseSlotHooks, type AdheseSlotManager, type AdheseSlotOptions, createAdhese };

package/dist/package.json.js

@@ -1,5 +1,5 @@
 const name = "@adhese/sdk";
-const version = "0.21.0";
+const version = "0.22.0";
 export {
   name,
   version

package/dist/slot/slot.js

@@ -199,6 +199,7 @@ function createSlot(slotOptions) {
       isDisposed,
       id,
       pluginOptions,
+      isVisible: isInViewport,
       render,
       request,
       dispose,

package/dist/slot/slot.js.map

@@ -1 +1 @@
-{"version":3,"file":"slot.js","sources":["../../src/slot/slot.ts"],"sourcesContent":["import {\n  type Ref,\n  type UnwrapRef,\n  addTrackingPixel,\n  computed,\n  doNothing,\n  effectScope,\n  generateName,\n  isDeepEqual,\n  omit,\n  reactive,\n  ref,\n  uniqueId,\n  waitForDomLoad,\n  watch,\n} from '@adhese/sdk-shared';\nimport type { AdheseAd } from '@adhese/sdk';\nimport { requestAd as extRequestAd } from '../requestAds/requestAds';\nimport { logger } from '../logger/logger';\nimport { useQueryDetector } from '../queryDetector/queryDetector';\nimport type { AdheseSlot, AdheseSlotContext, AdheseSlotOptions, RenderMode } from './slot.types';\nimport { renderIframe, renderInline } from './slot.utils';\nimport {\n  useDomLoaded,\n  useRenderIntersectionObserver,\n  useSlotHooks,\n  useViewabilityObserver,\n} from './slot.composables';\n\nconst renderFunctions: Record<RenderMode, (ad: AdheseAd, element: HTMLElement) => void> = {\n  iframe: renderIframe,\n  inline: renderInline,\n  none: doNothing,\n};\n\nconst defaultOptions = {\n  renderMode: 'iframe',\n  type: 'normal',\n} satisfies Partial<AdheseSlotOptions>;\n\n/**\n * Create a new slot instance. This slot instance can be used to request and render ads.\n *\n * @param slotOptions {AdheseSlotOptions} The options to create the slot with.\n *\n * @return AdheseSlot The created slot instance.\n */\nexport function createSlot(slotOptions: AdheseSlotOptions): AdheseSlot {\n  const scope = effectScope();\n\n  return scope.run(() => {\n    const slotContext = ref<AdheseSlotContext | null>(null);\n    const options = slotOptions.context.hooks.runOnSlotCreate({\n      ...defaultOptions,\n      ...slotOptions,\n    });\n\n    const {\n      containingElement,\n      slot,\n      context,\n      pluginOptions,\n      renderMode = 'iframe',\n      type = 'normal',\n    } = options;\n\n    const id = uniqueId();\n    const {\n      runOnBeforeRender,\n      runOnRender,\n      runOnBeforeRequest,\n      runOnRequest,\n      runOnInit,\n      runOnDispose,\n      ...hooks\n    } = useSlotHooks(options, slotContext);\n\n    const isDisposed = ref(false);\n    const parameters = reactive(new Map(Object.entries(options.parameters ?? {})));\n\n    const [device, disposeQueryDetector] = useQueryDetector(context, typeof options.format === 'string'\n      ? {\n          [options.format]: '(min-width: 0px)',\n        }\n      : Object.fromEntries(options.format.map(item => [item.format, item.query])));\n\n    const format = computed(() => typeof options.format === 'string' ? options.format : device.value);\n\n    const data = ref<AdheseAd | null>(null) as Ref<AdheseAd | null>;\n    const originalData = ref(data.value) as Ref<AdheseAd | null>;\n    const name = computed(() => generateName(options.context.location, format.value, options.slot));\n\n    watch(name, async (newName, oldName) => {\n      if (newName === oldName)\n        return;\n\n      const newAd = await slotContext.value?.request();\n\n      if (!newAd)\n        return;\n\n      slotContext.value?.cleanElement();\n\n      data.value = newAd;\n      originalData.value = newAd;\n    });\n\n    const isDomLoaded = useDomLoaded(context);\n\n    const element = computed(() => {\n      if (!(typeof options.containingElement === 'string' || !options.containingElement))\n        return options.containingElement;\n\n      if (!isDomLoaded.value || slotContext.value?.isDisposed)\n        return null;\n\n      return document.querySelector<HTMLElement>(`.adunit[data-format=\"${format.value}\"]#${options.containingElement}${options.slot ? `[data-slot=\"${options.slot}\"]` : ''}`);\n    },\n    );\n\n    const isInViewport = useRenderIntersectionObserver({\n      options,\n      element,\n      hooks,\n    });\n\n    const status = ref<UnwrapRef<AdheseSlot>['status']>('initializing');\n\n    watch([data, isInViewport], async ([newData, newIsInViewport], [oldData]) => {\n      if ((!newData || (oldData && isDeepEqual(newData, oldData))) && status.value === 'rendered')\n        return;\n\n      if (newIsInViewport)\n        await slotContext.value?.render(newData ?? undefined);\n    });\n\n    hooks.onDispose(() => {\n      disposeQueryDetector();\n    });\n\n    const isViewabilityTracked = useViewabilityObserver({\n      context,\n      slotContext,\n      hooks,\n      onTracked(trackingPixel) {\n        if (slotContext.value?.data?.viewableImpressionCounter) {\n          trackingPixel.value = addTrackingPixel(slotContext.value?.data?.viewableImpressionCounter);\n\n          context.logger.debug(`Viewability tracking pixel fired for ${slotContext.value?.name}`);\n        }\n      },\n    });\n\n    const impressionTrackingPixelElement = ref<HTMLImageElement | null>(null);\n    const isImpressionTracked = ref(false);\n    hooks.onDispose(() => {\n      if (impressionTrackingPixelElement.value)\n        impressionTrackingPixelElement.value.remove();\n    });\n\n    async function request(): Promise<AdheseAd | null> {\n      if (options.lazyLoading && !isInViewport.value)\n        return null;\n\n      status.value = 'loading';\n\n      let response = await runOnBeforeRequest(null);\n\n      if (!response) {\n        response = await extRequestAd({\n          slot: {\n            name: name.value,\n            parameters,\n          },\n          context,\n        });\n      }\n\n      if (response)\n        response = await runOnRequest(response);\n\n      data.value = response;\n\n      if (!originalData.value)\n        originalData.value = response;\n\n      status.value = response ? 'loaded' : 'empty';\n\n      if (!response)\n        cleanElement();\n\n      return response;\n    }\n\n    async function render(adToRender?: AdheseAd): Promise<HTMLElement | null> {\n      status.value = 'rendering';\n\n      await waitForDomLoad();\n\n      let renderAd = adToRender ?? data.value ?? originalData.value ?? await request();\n\n      renderAd = renderAd && await runOnBeforeRender(renderAd);\n\n      if (!renderAd) {\n        status.value = 'empty';\n        logger.debug(`No ad to render for slot ${name.value}`);\n\n        return null;\n      }\n\n      if (!element.value) {\n        const error = `Could not create slot for format ${format.value}. No element found.`;\n        logger.error(error, options);\n        throw new Error(error);\n      }\n\n      if (context.debug)\n        element.value.style.position = 'relative';\n\n      if (typeof renderAd?.tag !== 'string') {\n        const error = `Could not render slot for slot ${name.value}. A valid tag doesn't exist or is not HTML string.`;\n        logger.error(error, options);\n\n        status.value = 'error';\n        throw new Error(error);\n      }\n\n      renderFunctions[renderMode](renderAd, element.value);\n\n      if (renderAd.impressionCounter && !impressionTrackingPixelElement.value)\n        impressionTrackingPixelElement.value = addTrackingPixel(renderAd.impressionCounter);\n\n      isImpressionTracked.value = true;\n\n      logger.debug(`Slot rendered ${name.value}`, {\n        renderedElement: element,\n        location: context.location,\n        format,\n        containingElement,\n      });\n\n      // eslint-disable-next-line require-atomic-updates\n      data.value = renderAd;\n\n      status.value = 'rendered';\n\n      runOnRender(renderAd);\n\n      return element.value;\n    }\n\n    function cleanElement(): void {\n      if (!element.value)\n        return;\n\n      element.value.innerHTML = '';\n      element.value.style.position = '';\n      element.value.style.width = '';\n      element.value.style.height = '';\n\n      data.value = null;\n      originalData.value = null;\n    }\n\n    function dispose(): void {\n      cleanElement();\n\n      data.value = null;\n\n      runOnDispose();\n\n      isDisposed.value = true;\n\n      scope.stop();\n    }\n\n    const state = reactive({\n      location: context.location ?? '',\n      lazyLoading: options.lazyLoading ?? false,\n      type,\n      slot,\n      parameters,\n      format,\n      name,\n      data,\n      isViewabilityTracked,\n      isImpressionTracked,\n      status,\n      element,\n      isDisposed,\n      id,\n      pluginOptions,\n      render,\n      request,\n      dispose,\n      cleanElement,\n      options: omit(options, ['context']),\n      ...hooks,\n    });\n\n    watch(state, (newState) => {\n      slotContext.value = newState;\n    }, {\n      deep: true,\n      immediate: true,\n    });\n\n    context.hooks.onInit(async () => {\n      status.value = 'initialized';\n\n      runOnInit();\n\n      if (options.lazyLoading)\n        return;\n\n      data.value = await slotContext.value?.request() ?? null;\n    });\n\n    return state;\n  })!;\n}\n"],"names":["extRequestAd"],"mappings":"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"}
+{"version":3,"file":"slot.js","sources":["../../src/slot/slot.ts"],"sourcesContent":["import {\n  type Ref,\n  type UnwrapRef,\n  addTrackingPixel,\n  computed,\n  doNothing,\n  effectScope,\n  generateName,\n  isDeepEqual,\n  omit,\n  reactive,\n  ref,\n  uniqueId,\n  waitForDomLoad,\n  watch,\n} from '@adhese/sdk-shared';\nimport type { AdheseAd } from '@adhese/sdk';\nimport { requestAd as extRequestAd } from '../requestAds/requestAds';\nimport { logger } from '../logger/logger';\nimport { useQueryDetector } from '../queryDetector/queryDetector';\nimport type { AdheseSlot, AdheseSlotContext, AdheseSlotOptions, RenderMode } from './slot.types';\nimport { renderIframe, renderInline } from './slot.utils';\nimport {\n  useDomLoaded,\n  useRenderIntersectionObserver,\n  useSlotHooks,\n  useViewabilityObserver,\n} from './slot.composables';\n\nconst renderFunctions: Record<RenderMode, (ad: AdheseAd, element: HTMLElement) => void> = {\n  iframe: renderIframe,\n  inline: renderInline,\n  none: doNothing,\n};\n\nconst defaultOptions = {\n  renderMode: 'iframe',\n  type: 'normal',\n} satisfies Partial<AdheseSlotOptions>;\n\n/**\n * Create a new slot instance. This slot instance can be used to request and render ads.\n *\n * @param slotOptions {AdheseSlotOptions} The options to create the slot with.\n *\n * @return AdheseSlot The created slot instance.\n */\nexport function createSlot(slotOptions: AdheseSlotOptions): AdheseSlot {\n  const scope = effectScope();\n\n  return scope.run(() => {\n    const slotContext = ref<AdheseSlotContext | null>(null);\n    const options = slotOptions.context.hooks.runOnSlotCreate({\n      ...defaultOptions,\n      ...slotOptions,\n    });\n\n    const {\n      containingElement,\n      slot,\n      context,\n      pluginOptions,\n      renderMode = 'iframe',\n      type = 'normal',\n    } = options;\n\n    const id = uniqueId();\n    const {\n      runOnBeforeRender,\n      runOnRender,\n      runOnBeforeRequest,\n      runOnRequest,\n      runOnInit,\n      runOnDispose,\n      ...hooks\n    } = useSlotHooks(options, slotContext);\n\n    const isDisposed = ref(false);\n    const parameters = reactive(new Map(Object.entries(options.parameters ?? {})));\n\n    const [device, disposeQueryDetector] = useQueryDetector(context, typeof options.format === 'string'\n      ? {\n          [options.format]: '(min-width: 0px)',\n        }\n      : Object.fromEntries(options.format.map(item => [item.format, item.query])));\n\n    const format = computed(() => typeof options.format === 'string' ? options.format : device.value);\n\n    const data = ref<AdheseAd | null>(null) as Ref<AdheseAd | null>;\n    const originalData = ref(data.value) as Ref<AdheseAd | null>;\n    const name = computed(() => generateName(options.context.location, format.value, options.slot));\n\n    watch(name, async (newName, oldName) => {\n      if (newName === oldName)\n        return;\n\n      const newAd = await slotContext.value?.request();\n\n      if (!newAd)\n        return;\n\n      slotContext.value?.cleanElement();\n\n      data.value = newAd;\n      originalData.value = newAd;\n    });\n\n    const isDomLoaded = useDomLoaded(context);\n\n    const element = computed(() => {\n      if (!(typeof options.containingElement === 'string' || !options.containingElement))\n        return options.containingElement;\n\n      if (!isDomLoaded.value || slotContext.value?.isDisposed)\n        return null;\n\n      return document.querySelector<HTMLElement>(`.adunit[data-format=\"${format.value}\"]#${options.containingElement}${options.slot ? `[data-slot=\"${options.slot}\"]` : ''}`);\n    },\n    );\n\n    const isInViewport = useRenderIntersectionObserver({\n      options,\n      element,\n      hooks,\n    });\n\n    const status = ref<UnwrapRef<AdheseSlot>['status']>('initializing');\n\n    watch([data, isInViewport], async ([newData, newIsInViewport], [oldData]) => {\n      if ((!newData || (oldData && isDeepEqual(newData, oldData))) && status.value === 'rendered')\n        return;\n\n      if (newIsInViewport)\n        await slotContext.value?.render(newData ?? undefined);\n    });\n\n    hooks.onDispose(() => {\n      disposeQueryDetector();\n    });\n\n    const isViewabilityTracked = useViewabilityObserver({\n      context,\n      slotContext,\n      hooks,\n      onTracked(trackingPixel) {\n        if (slotContext.value?.data?.viewableImpressionCounter) {\n          trackingPixel.value = addTrackingPixel(slotContext.value?.data?.viewableImpressionCounter);\n\n          context.logger.debug(`Viewability tracking pixel fired for ${slotContext.value?.name}`);\n        }\n      },\n    });\n\n    const impressionTrackingPixelElement = ref<HTMLImageElement | null>(null);\n    const isImpressionTracked = ref(false);\n    hooks.onDispose(() => {\n      if (impressionTrackingPixelElement.value)\n        impressionTrackingPixelElement.value.remove();\n    });\n\n    async function request(): Promise<AdheseAd | null> {\n      if (options.lazyLoading && !isInViewport.value)\n        return null;\n\n      status.value = 'loading';\n\n      let response = await runOnBeforeRequest(null);\n\n      if (!response) {\n        response = await extRequestAd({\n          slot: {\n            name: name.value,\n            parameters,\n          },\n          context,\n        });\n      }\n\n      if (response)\n        response = await runOnRequest(response);\n\n      data.value = response;\n\n      if (!originalData.value)\n        originalData.value = response;\n\n      status.value = response ? 'loaded' : 'empty';\n\n      if (!response)\n        cleanElement();\n\n      return response;\n    }\n\n    async function render(adToRender?: AdheseAd): Promise<HTMLElement | null> {\n      status.value = 'rendering';\n\n      await waitForDomLoad();\n\n      let renderAd = adToRender ?? data.value ?? originalData.value ?? await request();\n\n      renderAd = renderAd && await runOnBeforeRender(renderAd);\n\n      if (!renderAd) {\n        status.value = 'empty';\n        logger.debug(`No ad to render for slot ${name.value}`);\n\n        return null;\n      }\n\n      if (!element.value) {\n        const error = `Could not create slot for format ${format.value}. No element found.`;\n        logger.error(error, options);\n        throw new Error(error);\n      }\n\n      if (context.debug)\n        element.value.style.position = 'relative';\n\n      if (typeof renderAd?.tag !== 'string') {\n        const error = `Could not render slot for slot ${name.value}. A valid tag doesn't exist or is not HTML string.`;\n        logger.error(error, options);\n\n        status.value = 'error';\n        throw new Error(error);\n      }\n\n      renderFunctions[renderMode](renderAd, element.value);\n\n      if (renderAd.impressionCounter && !impressionTrackingPixelElement.value)\n        impressionTrackingPixelElement.value = addTrackingPixel(renderAd.impressionCounter);\n\n      isImpressionTracked.value = true;\n\n      logger.debug(`Slot rendered ${name.value}`, {\n        renderedElement: element,\n        location: context.location,\n        format,\n        containingElement,\n      });\n\n      // eslint-disable-next-line require-atomic-updates\n      data.value = renderAd;\n\n      status.value = 'rendered';\n\n      runOnRender(renderAd);\n\n      return element.value;\n    }\n\n    function cleanElement(): void {\n      if (!element.value)\n        return;\n\n      element.value.innerHTML = '';\n      element.value.style.position = '';\n      element.value.style.width = '';\n      element.value.style.height = '';\n\n      data.value = null;\n      originalData.value = null;\n    }\n\n    function dispose(): void {\n      cleanElement();\n\n      data.value = null;\n\n      runOnDispose();\n\n      isDisposed.value = true;\n\n      scope.stop();\n    }\n\n    const state = reactive({\n      location: context.location ?? '',\n      lazyLoading: options.lazyLoading ?? false,\n      type,\n      slot,\n      parameters,\n      format,\n      name,\n      data,\n      isViewabilityTracked,\n      isImpressionTracked,\n      status,\n      element,\n      isDisposed,\n      id,\n      pluginOptions,\n      isVisible: isInViewport,\n      render,\n      request,\n      dispose,\n      cleanElement,\n      options: omit(options, ['context']),\n      ...hooks,\n    });\n\n    watch(state, (newState) => {\n      slotContext.value = newState;\n    }, {\n      deep: true,\n      immediate: true,\n    });\n\n    context.hooks.onInit(async () => {\n      status.value = 'initialized';\n\n      runOnInit();\n\n      if (options.lazyLoading)\n        return;\n\n      data.value = await slotContext.value?.request() ?? null;\n    });\n\n    return state;\n  })!;\n}\n"],"names":["extRequestAd"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adhese/sdk",
   "type": "module",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Adhese SDK",
   "license": "GPL-3.0",
   "repository": {