sovads-sdk 1.0.2 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1,8 +1,15 @@
1
1
  export interface SovAdsConfig {
2
2
  siteId?: string;
3
3
  apiUrl?: string;
4
+ apiKey?: string;
5
+ apiSecret?: string;
4
6
  debug?: boolean;
5
7
  consumerId?: string;
8
+ refreshInterval?: number;
9
+ lazyLoad?: boolean;
10
+ rotationEnabled?: boolean;
11
+ popupMinIntervalMinutes?: number;
12
+ popupSessionMax?: number;
6
13
  }
7
14
  export interface AdComponent {
8
15
  id: string;
@@ -18,6 +25,18 @@ export interface AdComponent {
18
25
  startDate?: string | null;
19
26
  endDate?: string | null;
20
27
  mediaType?: 'image' | 'video';
28
+ trackingToken?: string;
29
+ placement?: string;
30
+ size?: string;
31
+ }
32
+ interface AdLoadOptions {
33
+ consumerId?: string;
34
+ placement?: string;
35
+ size?: string;
36
+ }
37
+ interface SlotConfig {
38
+ placementId?: string;
39
+ size?: string;
21
40
  }
22
41
  declare class SovAds {
23
42
  protected config: SovAdsConfig;
@@ -26,6 +45,7 @@ declare class SovAds {
26
45
  private siteId;
27
46
  private renderObservers;
28
47
  private debugLoggingEnabled;
48
+ private adTrackingTokens;
29
49
  constructor(config?: SovAdsConfig);
30
50
  private generateFingerprint;
31
51
  private detectSiteId;
@@ -39,15 +59,23 @@ declare class SovAds {
39
59
  * Get client metadata for tracking
40
60
  */
41
61
  private getClientMetadata;
62
+ /**
63
+ * Normalize URL - add protocol if missing for localhost
64
+ */
65
+ normalizeUrl(url: string): string;
42
66
  /**
43
67
  * Validate URL format
44
68
  */
45
69
  private isValidUrl;
70
+ private inferMediaTypeFromUrl;
46
71
  /**
47
72
  * Fetch with retry logic
48
73
  */
49
74
  private fetchWithRetry;
50
- loadAd(consumerId?: string): Promise<AdComponent | null>;
75
+ loadAd(options?: AdLoadOptions): Promise<AdComponent | null>;
76
+ private toBase64;
77
+ private signTrackingPayload;
78
+ private sendTrackingEnvelope;
51
79
  /**
52
80
  * Track event with retry logic (internal helper)
53
81
  */
@@ -89,15 +117,30 @@ export declare class Banner {
89
117
  private renderStartTime;
90
118
  private hasTrackedImpression;
91
119
  private isRendering;
92
- constructor(sovads: SovAds, containerId: string);
93
- render(consumerId?: string): Promise<void>;
120
+ private refreshTimer;
121
+ private lastAdId;
122
+ private retryCount;
123
+ private maxRetries;
124
+ private slotConfig;
125
+ constructor(sovads: SovAds, containerId: string, slotConfig?: SlotConfig);
126
+ render(consumerId?: string, forceRefresh?: boolean): Promise<void>;
127
+ private checkViewport;
128
+ private setupLazyLoadObserver;
129
+ private setupAutoRefresh;
130
+ destroy(): void;
94
131
  }
95
132
  export declare class Popup {
96
133
  private sovads;
97
134
  private currentAd;
98
135
  private popupElement;
99
136
  private isShowing;
137
+ private retryCount;
138
+ private maxRetries;
139
+ private storageKeyLastShown;
140
+ private storageKeySessionCount;
100
141
  constructor(sovads: SovAds);
142
+ private canShowByFrequencyCap;
143
+ private markShown;
101
144
  show(consumerId?: string, delay?: number): Promise<void>;
102
145
  private renderPopup;
103
146
  hide(): void;
@@ -109,8 +152,17 @@ export declare class Sidebar {
109
152
  private renderStartTime;
110
153
  private hasTrackedImpression;
111
154
  private isRendering;
112
- constructor(sovads: SovAds, containerId: string);
113
- render(consumerId?: string): Promise<void>;
155
+ private refreshTimer;
156
+ private lastAdId;
157
+ private retryCount;
158
+ private maxRetries;
159
+ private slotConfig;
160
+ constructor(sovads: SovAds, containerId: string, slotConfig?: SlotConfig);
161
+ render(consumerId?: string, forceRefresh?: boolean): Promise<void>;
162
+ private checkViewport;
163
+ private setupLazyLoadObserver;
164
+ private setupAutoRefresh;
165
+ destroy(): void;
114
166
  }
115
167
  export { SovAds };
116
168
  export default SovAds;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}