@absmartly/sdk-plugins 1.0.1 → 1.1.1

package/types/cookies/cookieUtils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Cookie utility functions extracted from CookiePlugin
+ * These can be used independently for lightweight cookie operations
+ */
+export interface CookieOptions {
+    domain?: string;
+    path?: string;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+    secure?: boolean;
+}
+/**
+ * Get a cookie value by name
+ */
+export declare function getCookie(name: string): string | null;
+/**
+ * Set a cookie with expiry and options
+ */
+export declare function setCookie(name: string, value: string, days: number, options?: CookieOptions): boolean;
+/**
+ * Delete a cookie by name
+ */
+export declare function deleteCookie(name: string, options?: CookieOptions): void;
+/**
+ * Generate a fast unique ID (timestamp + random)
+ */
+export declare function generateUniqueId(): string;
+/**
+ * Generate a UUID v4
+ */
+export declare function generateUUID(): string;
+/**
+ * Check if localStorage is available
+ */
+export declare function isLocalStorageAvailable(): boolean;

package/types/cookies/index.d.ts

@@ -1,2 +1,4 @@
 export { CookiePlugin } from './CookiePlugin';
 export type { CookiePluginOptions } from './CookiePlugin';
+export { getCookie, setCookie, deleteCookie, generateUniqueId, generateUUID, isLocalStorageAvailable, } from './cookieUtils';
+export type { CookieOptions } from './cookieUtils';

package/types/core/DOMChangesPluginLite.d.ts

@@ -20,7 +20,7 @@ export declare class DOMChangesPluginLite {
     protected persistenceObserver: MutationObserver | null;
     protected reapplyingElements: Set<Element>;
     protected reapplyLogThrottle: Map<string, number>;
-    protected appliedStyleChanges: Map<string, DOMChange[]>;
+    protected appliedChanges: Map<string, DOMChange[]>;
     protected antiFlickerTimeout: number | null;
     protected antiFlickerStyleId: string;
     constructor(config: PluginConfig);

package/types/core/ExposureTracker.d.ts

@@ -10,8 +10,11 @@ export declare class ExposureTracker {
     constructor(context: ABsmartlyContext, debug?: boolean);
     /**
      * Register an experiment with all its variants' changes for comprehensive tracking
+     *
+     * @param hasImmediateTrigger - Whether ANY variant matching URL filter has immediate trigger
+     * @param hasViewportTrigger - Whether ANY variant matching URL filter has viewport trigger
      */
-    registerExperiment(experimentName: string, currentVariant: number, currentChanges: DOMChange[], allVariantsChanges: DOMChange[][]): void;
+    registerExperiment(experimentName: string, currentVariant: number, currentChanges: DOMChange[], allVariantsChanges: DOMChange[][], hasImmediateTrigger: boolean, hasViewportTrigger: boolean): void;
     /**
      * Create a container-based placeholder at the hypothetical position
      * Uses inline-block with minimal dimensions to be observable but not affect layout

package/types/entries/dom-with-overrides-lite.d.ts

@@ -4,8 +4,14 @@
  */
 import { DOMChangesPluginLite } from '../core/DOMChangesPluginLite';
 import { OverridesPluginLite } from '../overrides/OverridesPluginLite';
+import { CookiePlugin } from '../cookies/CookiePlugin';
 export * from '../types';
 export * from '../overrides/types';
-export { DOMChangesPluginLite, OverridesPluginLite };
+export type { CookiePluginOptions } from '../cookies/CookiePlugin';
+export type { CookieOptions } from '../cookies/cookieUtils';
+export { DOMChangesPluginLite, OverridesPluginLite, CookiePlugin };
 export { DOMChangesPluginLite as DOMChangesPlugin };
+export { getCookie, setCookie, deleteCookie, generateUniqueId, generateUUID, isLocalStorageAvailable, } from '../cookies/cookieUtils';
+export { getQueryStringOverrides, parseOverrideCookie, getCookieOverrides as getOverrideCookie, serializeOverrides, persistOverridesToCookie, getOverrides, } from '../overrides/overridesUtils';
+export type { SimpleOverride, OverrideOptions } from '../overrides/overridesUtils';
 export default DOMChangesPluginLite;

package/types/index.d.ts

@@ -6,8 +6,12 @@ import { WebVitalsPlugin } from './vitals/WebVitalsPlugin';
 export * from './types';
 export * from './overrides/types';
 export type { CookiePluginOptions } from './cookies/CookiePlugin';
+export type { CookieOptions } from './cookies/cookieUtils';
 export type { WebVitalsPluginOptions, Metric } from './vitals/WebVitalsPlugin';
 export { DOMChangesPluginLite, DOMChangesPluginLite as DOMChangesPlugin, // Alias for backward compatibility
 OverridesPlugin, // Legacy export - this is the original full-featured version
 BrowserCookieAdapter, CookiePlugin, WebVitalsPlugin, };
+export { getCookie, setCookie, deleteCookie, generateUniqueId, generateUUID, isLocalStorageAvailable, } from './cookies/cookieUtils';
+export { getQueryStringOverrides, parseOverrideCookie, getCookieOverrides, serializeOverrides, persistOverridesToCookie, getOverrides, } from './overrides/overridesUtils';
+export type { SimpleOverride, OverrideOptions } from './overrides/overridesUtils';
 export default DOMChangesPluginLite;

package/types/overrides/index.d.ts

@@ -1,3 +1,5 @@
 export { OverridesPlugin } from './OverridesPlugin';
 export { BrowserCookieAdapter } from './BrowserCookieAdapter';
 export * from './types';
+export { getQueryStringOverrides, parseOverrideCookie, getCookieOverrides, serializeOverrides, persistOverridesToCookie, getOverrides, } from './overridesUtils';
+export type { SimpleOverride, OverrideOptions } from './overridesUtils';

package/types/overrides/overridesUtils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Override utility functions extracted for reusability
+ * These can be used independently for lightweight override operations
+ * without requiring the full OverridesPlugin class
+ */
+export interface SimpleOverride {
+    variant: number;
+    env?: number;
+    id?: number;
+}
+export interface OverrideOptions {
+    cookieName?: string;
+    queryPrefix?: string;
+    maxAge?: number;
+}
+/**
+ * Parse query string parameters for experiment overrides
+ * @param queryPrefix - Prefix for experiment parameters (e.g., '_exp_')
+ * @param searchParams - Optional URLSearchParams instance (defaults to window.location.search)
+ */
+export declare function getQueryStringOverrides(queryPrefix?: string, searchParams?: URLSearchParams): Record<string, number | SimpleOverride>;
+/**
+ * Parse cookie value for experiment overrides
+ * Format: name:variant.env.id,name2:variant2
+ */
+export declare function parseOverrideCookie(value: string): Record<string, number | SimpleOverride>;
+/**
+ * Get experiment overrides from cookie
+ */
+export declare function getCookieOverrides(cookieName?: string): Record<string, number | SimpleOverride>;
+/**
+ * Serialize overrides to cookie value format
+ */
+export declare function serializeOverrides(overrides: Record<string, number | SimpleOverride>): string;
+/**
+ * Persist experiment overrides to cookie
+ */
+export declare function persistOverridesToCookie(overrides: Record<string, number | SimpleOverride>, options?: OverrideOptions): void;
+/**
+ * Get experiment overrides from query string or cookie
+ * Returns normalized Record<string, number> for use with SDK createContext
+ *
+ * @param cookieName - Name of the cookie to read/write (default: 'absmartly_overrides')
+ * @param queryPrefix - Prefix for query string parameters (default: '_exp_')
+ * @param searchParams - Optional URLSearchParams instance (defaults to window.location.search)
+ * @returns Normalized overrides as Record<string, number>
+ */
+export declare function getOverrides(cookieName?: string, queryPrefix?: string, searchParams?: URLSearchParams): Record<string, number>;

package/types/vitals/WebVitalsPlugin.d.ts

@@ -4,7 +4,6 @@ export interface WebVitalsPluginOptions {
     debug?: boolean;
     trackWebVitals?: boolean;
     trackPageMetrics?: boolean;
-    webVitalsUrl?: string;
     autoTrack?: boolean;
 }
 export interface Metric {
@@ -20,10 +19,10 @@ export declare class WebVitalsPlugin {
     private debug;
     private trackWebVitals;
     private trackPageMetrics;
-    private webVitalsUrl;
     private autoTrack;
     private webVitalsLoaded;
     private metricsTracked;
+    private webVitalsPromise?;
     constructor(options?: WebVitalsPluginOptions);
     private debugLog;
     setContext(context: Context): void;