@absmartly/sdk-plugins 1.1.2 → 1.2.2

package/types/overrides/overridesUtils.d.ts

@@ -3,6 +3,8 @@
  * These can be used independently for lightweight override operations
  * without requiring the full OverridesPlugin class
  */
+export declare const DEFAULT_OVERRIDE_COOKIE_NAME = "absmartly_overrides";
+export declare const DEFAULT_OVERRIDE_QUERY_PREFIX = "exp_";
 export interface SimpleOverride {
     variant: number;
     env?: number;
@@ -15,7 +17,7 @@ export interface OverrideOptions {
 }
 /**
  * Parse query string parameters for experiment overrides
- * @param queryPrefix - Prefix for experiment parameters (e.g., '_exp_')
+ * @param queryPrefix - Prefix for experiment parameters (default: DEFAULT_OVERRIDE_QUERY_PREFIX)
  * @param searchParams - Optional URLSearchParams instance (defaults to window.location.search)
  */
 export declare function getQueryStringOverrides(queryPrefix?: string, searchParams?: URLSearchParams): Record<string, number | SimpleOverride>;
@@ -26,8 +28,10 @@ export declare function getQueryStringOverrides(queryPrefix?: string, searchPara
 export declare function parseOverrideCookie(value: string): Record<string, number | SimpleOverride>;
 /**
  * Get experiment overrides from cookie
+ * @param cookieName - Name of the cookie to read (default: DEFAULT_OVERRIDE_COOKIE_NAME)
+ * @param cookieHeader - Optional cookie header string (for server-side use). If not provided, uses document.cookie
  */
-export declare function getCookieOverrides(cookieName?: string): Record<string, number | SimpleOverride>;
+export declare function getCookieOverrides(cookieName?: string, cookieHeader?: string): Record<string, number | SimpleOverride>;
 /**
  * Serialize overrides to cookie value format
  */
@@ -40,9 +44,10 @@ export declare function persistOverridesToCookie(overrides: Record<string, numbe
  * 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 cookieName - Name of the cookie to read/write (default: DEFAULT_OVERRIDE_COOKIE_NAME)
+ * @param queryPrefix - Prefix for query string parameters (default: DEFAULT_OVERRIDE_QUERY_PREFIX)
  * @param searchParams - Optional URLSearchParams instance (defaults to window.location.search)
+ * @param cookieHeader - Optional cookie header string (for server-side use). If not provided, uses document.cookie
  * @returns Normalized overrides as Record<string, number>
  */
-export declare function getOverrides(cookieName?: string, queryPrefix?: string, searchParams?: URLSearchParams): Record<string, number>;
+export declare function getOverrides(cookieName?: string, queryPrefix?: string, searchParams?: URLSearchParams, cookieHeader?: string): Record<string, number>;

package/types/types/index.d.ts

@@ -28,6 +28,7 @@ export interface DOMChange {
     observerRoot?: string;
     waitForElement?: boolean;
     persistStyle?: boolean;
+    persistAttribute?: boolean;
     trigger_on_view?: boolean;
 }
 export interface DOMChangesConfig {

package/types/url-redirect/URLRedirectExtractor.d.ts

@@ -0,0 +1,16 @@
+import { ABsmartlyContext } from '../types';
+import { URLRedirectConfig } from './types';
+export declare class URLRedirectExtractor {
+    private context;
+    private variableName;
+    private debug;
+    private cachedConfigs;
+    constructor(context: ABsmartlyContext, variableName?: string, debug?: boolean);
+    clearCache(): void;
+    extractAllConfigs(): Map<string, Map<number, URLRedirectConfig>>;
+    private extractConfigsForExperiment;
+    private parseConfig;
+    private isValidRedirect;
+    getConfigForExperiment(experimentName: string): URLRedirectConfig | null;
+    getAllVariantConfigs(experimentName: string): Map<number, URLRedirectConfig>;
+}

package/types/url-redirect/URLRedirectMatcher.d.ts

@@ -0,0 +1,8 @@
+import { URLRedirect, RedirectMatch } from './types';
+export declare class URLRedirectMatcher {
+    static findMatch(currentUrl: string, redirects: URLRedirect[], experimentName: string, variant: number): RedirectMatch | null;
+    private static matchRedirect;
+    private static matchDomainRedirect;
+    private static matchPageRedirect;
+    static buildTargetUrl(currentUrl: string, redirect: URLRedirect): string;
+}

package/types/url-redirect/URLRedirectPlugin.d.ts

@@ -0,0 +1,21 @@
+import { URLRedirectPluginConfig, RedirectMatch } from './types';
+import { URLRedirectExtractor } from './URLRedirectExtractor';
+export declare class URLRedirectPlugin {
+    static readonly VERSION: string;
+    private config;
+    private extractor;
+    private initialized;
+    private readyPromise;
+    constructor(config: URLRedirectPluginConfig);
+    ready(): Promise<RedirectMatch | null>;
+    private initialize;
+    findRedirectMatch(url?: string): RedirectMatch | null;
+    private getAnyConfig;
+    executeRedirect(match: RedirectMatch): Promise<void>;
+    private publishViaBeacon;
+    getExtractor(): URLRedirectExtractor;
+    refreshExperiments(): void;
+    destroy(): void;
+    private registerWithContext;
+    private unregisterFromContext;
+}

package/types/url-redirect/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export { URLRedirectPlugin } from './URLRedirectPlugin';
+export { URLRedirectExtractor } from './URLRedirectExtractor';
+export { URLRedirectMatcher } from './URLRedirectMatcher';

package/types/url-redirect/types.d.ts

@@ -0,0 +1,29 @@
+import type { URLFilter } from '../types';
+export type RedirectType = 'domain' | 'page';
+export type ControlBehavior = 'redirect-same' | 'no-redirect';
+export interface URLRedirect {
+    from: string;
+    to: string;
+    preservePath?: boolean;
+    type: RedirectType;
+}
+export interface URLRedirectConfig {
+    redirects: URLRedirect[];
+    urlFilter?: URLFilter;
+    controlBehavior?: ControlBehavior;
+}
+export interface RedirectMatch {
+    redirect: URLRedirect;
+    targetUrl: string;
+    experimentName: string;
+    variant: number;
+    isControl: boolean;
+}
+export interface URLRedirectPluginConfig {
+    context: import('../types').ABsmartlyContext;
+    variableName?: string;
+    debug?: boolean;
+    autoApply?: boolean;
+    useBeacon?: boolean;
+    onBeforeRedirect?: (match: RedirectMatch) => void | Promise<void>;
+}

package/types/utils/debug.d.ts

@@ -1,4 +1,4 @@
-export declare const DEBUG: boolean;
+export declare const DEBUG = false;
 export interface LogContext {
     experimentName?: string;
     selector?: string;

package/types/utils/persistence.d.ts

@@ -0,0 +1,23 @@
+import type { DOMChange } from '../types';
+export interface PersistenceConfig {
+    debug?: boolean;
+    onReapply: (change: DOMChange, experimentName: string) => void;
+}
+export declare class DOMPersistenceManager {
+    private watchedElements;
+    private persistenceObserver;
+    private reapplyingElements;
+    private reapplyLogThrottle;
+    private appliedChanges;
+    private config;
+    constructor(config: PersistenceConfig);
+    watchElement(element: Element, experimentName: string, change: DOMChange): void;
+    unwatchElement(element: Element, experimentName: string): void;
+    unwatchExperiment(experimentName: string): void;
+    getAppliedChanges(): Map<string, DOMChange[]>;
+    clearAll(): void;
+    destroy(): void;
+    private setupPersistenceObserver;
+    private checkStyleOverwritten;
+    private checkAttributeOverwritten;
+}

package/types/utils/plugin-registry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Global plugin registry for ABsmartly plugins
+ * Allows detection and inspection of loaded plugins
+ */
+export interface PluginRegistryEntry {
+    name: string;
+    version: string;
+    initialized: boolean;
+    timestamp: number;
+    capabilities?: string[];
+    instance?: any;
+}
+export interface PluginRegistry {
+    dom?: PluginRegistryEntry;
+    overrides?: PluginRegistryEntry;
+    cookie?: PluginRegistryEntry;
+    vitals?: PluginRegistryEntry;
+    urlRedirect?: PluginRegistryEntry;
+}
+declare global {
+    interface Window {
+        __ABSMARTLY_PLUGINS__?: PluginRegistry;
+    }
+}
+/**
+ * Register a plugin in the global registry
+ */
+export declare function registerPlugin(pluginType: keyof PluginRegistry, entry: PluginRegistryEntry): void;
+/**
+ * Unregister a plugin from the global registry
+ */
+export declare function unregisterPlugin(pluginType: keyof PluginRegistry): void;
+/**
+ * Check if a plugin is registered
+ */
+export declare function isPluginRegistered(pluginType: keyof PluginRegistry): boolean;
+/**
+ * Get all registered plugins
+ */
+export declare function getRegisteredPlugins(): PluginRegistry;