featurely-site-manager 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,124 @@
+type MessageType = "info" | "warning" | "error" | "success";
+type MessagePosition = "top" | "bottom";
+type MessageStyle = "banner" | "toast";
+interface StatusMessage {
+    id: string;
+    type: MessageType;
+    title: string;
+    message: string;
+    icon?: string;
+    dismissible: boolean;
+    position: MessagePosition;
+    style: MessageStyle;
+    expiresAt?: string;
+    startsAt?: string;
+    targetPages?: string[];
+    cta?: {
+        text: string;
+        url: string;
+        action?: string;
+    };
+    priority?: number;
+}
+interface FeatureFlag {
+    id: string;
+    key: string;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    rolloutPercentage?: number;
+    targetEmails?: string[];
+    excludeEmails?: string[];
+    variants?: {
+        key: string;
+        name: string;
+        weight: number;
+    }[];
+    defaultVariant?: string;
+}
+interface MaintenanceConfig {
+    enabled: boolean;
+    type: "default" | "custom";
+    customHtml?: string;
+    expectedRestoration?: string;
+    showStatusLink: boolean;
+    statusPageUrl?: string;
+    whitelist: {
+        localStorageKeys?: string[];
+        emails?: string[];
+        ips?: string[];
+    };
+}
+interface SiteConfig {
+    maintenance: MaintenanceConfig;
+    messages: StatusMessage[];
+    featureFlags: FeatureFlag[];
+    lastUpdated: string;
+}
+interface SiteManagerConfig {
+    apiKey: string;
+    projectId: string;
+    apiUrl?: string;
+    pollInterval?: number;
+    userEmail?: string;
+    bypassCheck?: () => boolean;
+    onMaintenanceEnabled?: (config: MaintenanceConfig) => void;
+    onMaintenanceDisabled?: () => void;
+    onMessageReceived?: (message: StatusMessage) => void;
+    onMessageDismissed?: (messageId: string) => void;
+    onFeatureFlagsUpdated?: (flags: FeatureFlag[]) => void;
+    userId?: string;
+    enableAnalytics?: boolean;
+    analyticsFlushInterval?: number;
+    onError?: (error: Error) => void;
+}
+declare class SiteManager {
+    private config;
+    private siteConfig;
+    private pollIntervalId;
+    private messageContainers;
+    private dismissedMessages;
+    private featureFlagBuckets;
+    private analyticsQueue;
+    private analyticsFlushIntervalId;
+    private sessionId;
+    constructor(config: SiteManagerConfig);
+    init(): Promise<void>;
+    destroy(): void;
+    setUser(email: string, userId?: string): void;
+    isFeatureEnabled(flagKey: string): boolean;
+    getFeatureVariant(flagKey: string): string | null;
+    getAllFeatureFlags(): FeatureFlag[];
+    getEnabledFeatures(): string[];
+    refresh(): Promise<void>;
+    trackEvent(eventName: string, properties?: Record<string, string | number | boolean>): void;
+    private fetchConfig;
+    private startPolling;
+    private stopPolling;
+    private startAnalyticsFlushing;
+    private stopAnalyticsFlushing;
+    private flushAnalytics;
+    private generateSessionId;
+    private evaluateFeatureFlag;
+    private getUserBucket;
+    private simpleHash;
+    private getAnonymousId;
+    private checkMaintenanceMode;
+    private enableMaintenanceMode;
+    private disableMaintenanceMode;
+    private shouldBypassMaintenance;
+    private showMaintenancePage;
+    private hideMaintenancePage;
+    private getDefaultMaintenanceHtml;
+    private updateMessages;
+    private showMessage;
+    private dismissMessage;
+    private clearMessages;
+    private handleMessageAction;
+    private getDefaultIcon;
+    private loadDismissedMessages;
+    private saveDismissedMessages;
+    private injectStyles;
+}
+
+export { type FeatureFlag, type MaintenanceConfig, type MessagePosition, type MessageStyle, type MessageType, type SiteConfig, SiteManager, type SiteManagerConfig, type StatusMessage, SiteManager as default };