@absmartly/sdk-plugins 1.0.1 → 1.1.0

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;