@absmartly/sdk-plugins 1.1.2 → 1.2.1

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/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;