@surfside/ads 3.6.5 → 3.7.0-8cd008d7.0

package/lib/types/components/Creative.d.ts

@@ -24,9 +24,13 @@ export declare const RecommenderTypeInputs: {
 };
 export declare const AttributeValOrThrow: (element: Element, attribute: string, value: string | null) => string;
 export declare const DEBOUNCE_THRESHOLD = 10;
+export interface ICreativeComponentDependencies {
+    initApi: InitApi;
+    getUserId: GetUserIdFn;
+    logger?: ILogger;
+    isDebug: boolean;
+}
 export declare abstract class CreativeComponent extends HTMLElement {
-    private _initApi;
-    private _getUserId;
     protected accountId: string | undefined;
     protected siteId: string | undefined;
     protected locationId: string | undefined;
@@ -43,7 +47,19 @@ export declare abstract class CreativeComponent extends HTMLElement {
     private _instanceId;
     protected get instanceId(): string;
     private readonly _monkeyHistoryReplaceCallback;
-    constructor(_initApi: InitApi, _getUserId: GetUserIdFn, logger?: ILogger);
+    private _reauctionTimer;
+    private _reauctionCallback;
+    private _reauctionRemainingMs;
+    private _reauctionStartedAt;
+    private _windowBlurred;
+    private _initApi;
+    private _getUserId;
+    logger?: ILogger;
+    protected readonly isDebug: boolean;
+    private readonly _blurCallback;
+    private readonly _focusCallback;
+    private readonly _visibilityChangeCallback;
+    constructor({ initApi, getUserId, logger, isDebug }: ICreativeComponentDependencies);
     connectedCallback(): void;
     protected abstract getComponentName(): string;
     protected static get observedBaseAttributes(): string[];
@@ -60,6 +76,17 @@ export declare abstract class CreativeComponent extends HTMLElement {
     protected lazyLoadApi(): Promise<void>;
     protected baseAttributeChangedCallback(key: BaseAttributeNames, oldValue: string | null, newValue: string | null, logger?: IContextLogger): Promise<void>;
     disconnectedCallback(): void;
+    private reauctionPaused;
+    /**
+     * Schedules `callback` to run after `intervalMs`, replacing any pending re-auction.
+     * The countdown is paused while the window is blurred or the document is hidden, and
+     * resumes with the remaining time once the page regains focus.
+     */
+    protected scheduleReauction(callback: () => void, intervalMs: number): void;
+    protected clearReauction(): void;
+    private startReauctionTimer;
+    private pauseReauction;
+    private resumeReauction;
     protected initApi(): Promise<void>;
     protected readBaseAttributes(): asserts this is this & CompletedBaseAttributes;
 }

package/lib/types/components/Debug.d.ts

@@ -0,0 +1,2 @@
+export type CreativeTypes = 'banners' | 'videos' | 'carousels' | 'dynamic';
+export declare const CreateDebugButton: (type: CreativeTypes, args: Record<string, string>) => HTMLAnchorElement;

package/lib/types/components/Dynamic.d.ts

@@ -18,6 +18,7 @@ export declare class SurfsideDynamicZone extends CreativeComponent {
     protected getComponentName(): string;
     static get observedAttributes(): string[];
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): Promise<void>;
+    disconnectedCallback(): void;
     render(this: this & CompletedDynamicAttributes): Promise<void>;
     requestAndRender(this: this & CompletedDynamicAttributes, dynamicZoneRequest: IDynamicZoneRequest): Promise<void>;
 }

package/lib/types/components/SimpleCreative.d.ts

@@ -1,6 +1,5 @@
-import { type BaseAttributeNames, CreativeComponent, type InitApi, type CompletedBaseAttributes } from './Creative';
-import type { GetUserIdFn } from '@surfside/ads-core-web';
-import { type IContextLogger, type ILogger } from '@surfside/ads-core';
+import { type BaseAttributeNames, CreativeComponent, type CompletedBaseAttributes, type ICreativeComponentDependencies } from './Creative';
+import { type IContextLogger } from '@surfside/ads-core';
 export type CompletedSimpleCreativeAttributes = CompletedBaseAttributes & {
     width: number;
     height: number;
@@ -8,12 +7,15 @@ export type CompletedSimpleCreativeAttributes = CompletedBaseAttributes & {
 export type SimpleCreativeAttributeNames = BaseAttributeNames | 'width' | 'height';
 export declare const IntValOrThrow: (element: Element, attribute: string, value: string | null) => number;
 export declare const IntValOr: <T>(element: Element, attribute: string, value: string | null, or: T) => number | T;
+export interface ISimpleCreativeComponentDependencies extends ICreativeComponentDependencies {
+}
 export declare abstract class SimpleCreativeComponent extends CreativeComponent {
     protected width?: number | null;
     protected height?: number | null;
-    constructor(initApi: InitApi, getUserId: GetUserIdFn, logger?: ILogger);
+    constructor(dependencies: ISimpleCreativeComponentDependencies);
     protected attributesLoaded(): boolean;
     protected static get observedSimpleAttributes(): string[];
+    protected handleSimpleAttributeChange(name: string, oldValue: string | null, newValue: string | null, logger?: IContextLogger): Promise<void>;
     simpleAttributeChangedCallback(name: string, oldValue: string | null, newValue: string | null, logger?: IContextLogger): Promise<void>;
     readSimpleAttributes(): asserts this is this & CompletedSimpleCreativeAttributes;
 }

package/lib/types/components/Video.d.ts

@@ -1,22 +1,22 @@
-import { type ILogger } from '@surfside/ads-core';
-import { SimpleCreativeComponent, type CompletedSimpleCreativeAttributes } from './SimpleCreative';
-import { type InitApi } from './Creative';
-import { type GetUserIdFn } from '@surfside/ads-core-web';
+import { type ISimpleCreativeComponentDependencies, SimpleCreativeComponent, type CompletedSimpleCreativeAttributes } from './SimpleCreative';
 export type CompletedVideoAttributes = CompletedSimpleCreativeAttributes & {
     minDuration: number;
     maxDuration: number;
 };
+export interface ISurfsideVideoComponentDependencies extends ISimpleCreativeComponentDependencies {
+}
 export declare class SurfsideVideo extends SimpleCreativeComponent {
     private _cancellationToken;
     protected minDuration?: number | null;
     protected maxDuration?: number | null;
     private _bounce;
     static get observedAttributes(): string[];
-    constructor(initApi: InitApi, getUserId: GetUserIdFn, logger?: ILogger);
+    constructor(dependencies: ISurfsideVideoComponentDependencies);
     protected getComponentName(): string;
     protected attributesLoaded(): boolean;
     attributeChangedCallback(this: this, name: string, oldValue: string | null, newValue: string | null): Promise<void>;
     protected readVideoAttributes(): asserts this is this & CompletedVideoAttributes;
     connectedCallback(): Promise<void>;
+    disconnectedCallback(): void;
     render(this: this & CompletedVideoAttributes): Promise<void>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surfside/ads",
-  "version": "3.6.5",
+  "version": "3.7.0-8cd008d7.0",
   "module": "./lib/esm/index.module.js",
   "main": "./lib/cjs/index.module.js",
   "types": "./lib/types/index.module.d.ts",
@@ -35,8 +35,8 @@
     "typescript": "^5"
   },
   "dependencies": {
-    "@surfside/ads-core": "2.5.0",
-    "@surfside/ads-core-mock": "0.5.0",
-    "@surfside/ads-core-web": "0.5.0"
+    "@surfside/ads-core": "2.7.0-8cd008d7.0",
+    "@surfside/ads-core-mock": "0.8.0-8cd008d7.0",
+    "@surfside/ads-core-web": "0.8.0-8cd008d7.0"
   }
 }