featurely-site-manager 1.0.8 → 1.1.1

package/CHANGELOG.md

@@ -5,6 +5,43 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2026-03-15
+
+### Added
+
+- **Version Management**: Complete app version checking and update notification system
+  - Automatic version checking with configurable intervals (default: 1 hour)
+  - Force update support for critical releases (minimum version)
+  - Recommended update notifications
+  - `checkVersion(currentVersion?)` - Manual version checking
+  - `getLastVersionCheck()` - Get cached version check result
+  - `onUpdateAvailable` callback for optional updates
+  - `onUpdateRequired` callback for forced updates
+  - Release notes and download URL support
+  - Beta version flagging
+- **Feature Flags**: Complete feature flag support
+  - `isFeatureEnabled(flagKey)` - Check if flag is enabled
+  - `getFeatureVariant(flagKey)` - Get A/B test variant
+  - `getAllFeatureFlags()` - Get all flags
+  - `getEnabledFeatures()` - Get enabled flags for current user
+  - Email-based targeting
+  - Percentage-based rollouts with consistent bucketing
+  - A/B testing with weighted variants
+  - `onFeatureFlagsUpdated` callback
+- **Analytics**: Custom event tracking
+  - `trackEvent(eventName, properties)` - Track custom events
+  - Automatic feature flag usage tracking
+  - Session management
+  - Configurable flush intervals
+  - User identification support
+
+### Changed
+
+- Updated package description to reflect full feature set
+- Added comprehensive README documentation for all features
+- Enhanced TypeScript types for version management
+- Improved configuration options with granular control
+
 ## [1.0.8] - 2026-03-15
 
 ### Fixed

package/README.md

@@ -43,6 +43,31 @@ siteManager.init();
 - Call-to-action buttons
 - Auto-expire functionality
 
+### 🚀 Version Management
+
+- Automatic version checking
+- Force updates for critical releases (minimum version)
+- Recommended version notifications
+- Configurable check intervals (default: 1 hour)
+- Release notes and download URLs
+- Beta version support
+- Update callbacks for custom UI
+
+### 🔐 Feature Flags
+
+- Enable/disable features remotely
+- Percentage-based rollouts
+- User targeting by email
+- A/B testing with variants
+- Consistent user bucketing
+
+### 📊 Analytics
+
+- Track custom events
+- Automatic feature flag usage tracking
+- Session management
+- User identification
+
 ## 📖 Usage
 
 ### Basic Setup
@@ -115,6 +140,318 @@ const manager = new SiteManager({
 manager.init();
 ```
 
+### Version Checking
+
+```typescript
+const manager = new SiteManager({
+  apiKey: "ft_live_your_api_key",
+  projectId: "proj_your_project_id",
+  appVersion: "1.2.3", // Your current app version
+  enableVersionCheck: true,
+  versionCheckInterval: 3600000, // Check every hour (default)
+
+  onUpdateAvailable: (versionInfo) => {
+    console.log("Update available:", versionInfo.latestVersion);
+    // Show optional update notification to user
+  },
+
+  onUpdateRequired: (versionInfo) => {
+    console.log("Update required:", versionInfo.latestVersion);
+    // Force user to update (breaking changes)
+    if (confirm(`Update required: ${versionInfo.latestVersion.title}\n\n${versionInfo.latestVersion.releaseNotes}`)) {
+      window.location.href = versionInfo.latestVersion.downloadUrl || '/update';
+    }
+  },
+});
+
+manager.init();
+
+// Manual version check
+const versionStatus = await manager.checkVersion();
+if (versionStatus?.updateAvailable) {
+  console.log("New version:", versionStatus.latestVersion);
+}
+```
+
+### Feature Flags
+
+```typescript
+const manager = new SiteManager({
+  apiKey: "ft_live_your_api_key",
+  projectId: "proj_your_project_id",
+  userEmail: "user@example.com",
+
+  onFeatureFlagsUpdated: (flags) => {
+    console.log("Feature flags updated:", flags);
+  },
+});
+
+manager.init();
+
+// Check if a feature is enabled
+if (manager.isFeatureEnabled("new-checkout")) {
+  // Show new checkout UI
+}
+
+// Get A/B test variant
+const variant = manager.getFeatureVariant("homepage-design");
+if (variant === "variant-a") {
+  // Show design A
+}
+
+// Get all enabled features
+const enabledFeatures = manager.getEnabledFeatures();
+console.log("Enabled features:", enabledFeatures);
+```
+
+### Analytics
+
+```typescript
+const manager = new SiteManager({
+  apiKey: "ft_live_your_api_key",
+  projectId: "proj_your_project_id",
+  userId: "user_123",
+  enableAnalytics: true,
+  analyticsFlushInterval: 60000, // Flush every minute
+});
+
+manager.init();
+
+// Track custom events
+manager.trackEvent("button_clicked", {
+  button: "signup",
+  page: "/home",
+});
+
+manager.trackEvent("feature_used", {
+  feature: "dark_mode",
+  enabled: true,
+});
+```
+
+### Custom Poll Interval
+
+```typescript
+const manager = new SiteManager({
+  apiKey: "ft_live_your_api_key",
+  projectId: "proj_your_project_id",
+  pollInterval: 30000, // Check every 30 seconds instead of default 60s
+});
+
+manager.init();
+```
+
+## 🔧 Configuration
+
+### SiteManagerConfig
+
+| Option                   | Type            | Required | Default                   | Description                               |
+| ------------------------ | --------------- | -------- | ------------------------- | ----------------------------------------- |
+| `apiKey`                 | `string`        | ✅       | -                         | Your Featurely API key                    |
+| `projectId`              | `string`        | ✅       | -                         | Your Featurely project ID                 |
+| `apiUrl`                 | `string`        | ❌       | `'https://featurely.no'` | Custom API endpoint                       |
+| `pollInterval`           | `number`        | ❌       | `60000`                   | Config polling interval in ms             |
+| `userEmail`              | `string`        | ❌       | -                         | User email for whitelist & targeting      |
+| `userId`                 | `string`        | ❌       | -                         | User ID for analytics & feature flags     |
+| `bypassCheck`            | `() => boolean` | ❌       | -                         | Custom maintenance bypass function        |
+| `onMaintenanceEnabled`   | `function`      | ❌       | -                         | Maintenance enabled callback              |
+| `onMaintenanceDisabled`  | `function`      | ❌       | -                         | Maintenance disabled callback             |
+| `onMessageReceived`      | `function`      | ❌       | -                         | Message received callback                 |
+| `onMessageDismissed`     | `function`      | ❌       | -                         | Message dismissed callback                |
+| `onFeatureFlagsUpdated`  | `function`      | ❌       | -                         | Feature flags updated callback            |
+| `enableAnalytics`        | `boolean`       | ❌       | `true`                    | Enable analytics tracking                 |
+| `analyticsFlushInterval` | `number`        | ❌       | `60000`                   | Analytics flush interval in ms            |
+| `appVersion`             | `string`        | ❌       | -                         | Current app version for version checking  |
+| `enableVersionCheck`     | `boolean`       | ❌       | `false`                   | Enable automatic version checking         |
+| `versionCheckInterval`   | `number`        | ❌       | `3600000`                 | Version check interval in ms (1 hour)     |
+| `onUpdateAvailable`      | `function`      | ❌       | -                         | Callback when update is available         |
+| `onUpdateRequired`       | `function`      | ❌       | -                         | Callback when update is required (forced) |
+| `onError`                | `function`      | ❌       | -                         | Error callback                            |
+
+## 🎯 API Methods
+
+### Core Methods
+
+#### `init()`
+
+Initialize and start the site manager.
+
+```typescript
+await manager.init();
+```
+
+#### `setUser(email: string, userId?: string)`
+
+Update user email and ID for whitelist and targeting.
+
+```typescript
+manager.setUser("user@example.com", "user_123");
+```
+
+#### `refresh()`
+
+Manually refresh configuration from server.
+
+```typescript
+await manager.refresh();
+```
+
+#### `destroy()`
+
+Stop the manager and clean up.
+
+```typescript
+manager.destroy();
+```
+
+### Version Management Methods
+
+#### `checkVersion(currentVersion?: string)`
+
+Manually check if an update is available.
+
+```typescript
+const versionInfo = await manager.checkVersion();
+if (versionInfo?.updateAvailable) {
+  console.log("Update available:", versionInfo.latestVersion);
+  console.log("Is required?", versionInfo.updateRequired);
+  console.log("Is recommended?", versionInfo.updateRecommended);
+}
+
+// Check a specific version
+const customCheck = await manager.checkVersion("1.0.0");
+```
+
+#### `getLastVersionCheck()`
+
+Get the last cached version check result.
+
+```typescript
+const lastCheck = manager.getLastVersionCheck();
+if (lastCheck?.updateAvailable) {
+  // Show update notification
+}
+```
+
+### Feature Flag Methods
+
+#### `isFeatureEnabled(flagKey: string)`
+
+Check if a feature flag is enabled for the current user.
+
+```typescript
+if (manager.isFeatureEnabled("new-dashboard")) {
+  // Show new dashboard
+}
+```
+
+#### `getFeatureVariant(flagKey: string)`
+
+Get the assigned variant for A/B testing.
+
+```typescript
+const variant = manager.getFeatureVariant("homepage-redesign");
+// Returns: 'control', 'variant-a', 'variant-b', etc.
+```
+
+#### `getAllFeatureFlags()`
+
+Get all feature flags.
+
+```typescript
+const flags = manager.getAllFeatureFlags();
+console.log("All flags:", flags);
+```
+
+#### `getEnabledFeatures()`
+
+Get all enabled feature flag keys for the current user.
+
+```typescript
+const enabledFeatures = manager.getEnabledFeatures();
+// Returns: ['feature-1', 'feature-2', ...]
+```
+
+### Analytics Methods
+
+#### `trackEvent(eventName: string, properties?: object)`
+
+Track a custom analytics event.
+
+```typescript
+manager.trackEvent("button_clicked", {
+  button: "signup",
+  page: "/pricing",
+});
+
+manager.trackEvent("purchase_completed", {
+  amount: 99.99,
+  currency: "USD",
+  plan: "pro",
+});
+```
+
+## 💼 Use Cases
+
+### Update Notifications
+
+```typescript
+const manager = new SiteManager({
+  apiKey: "ft_live_...",
+  projectId: "proj_...",
+  appVersion: "1.2.3",
+  enableVersionCheck: true,
+
+  onUpdateRequired: (versionInfo) => {
+    // Block app usage until updated
+    document.body.innerHTML = `
+      <div style="text-align: center; padding: 60px;">
+        <h1>Critical Update Required</h1>
+        <p>${versionInfo.latestVersion.title}</p>
+        <p>${versionInfo.latestVersion.releaseNotes}</p>
+        <a href="${versionInfo.latestVersion.downloadUrl}">
+          <button>Download Update</button>
+        </a>
+      </div>
+    `;
+  },
+
+  onUpdateAvailable: (versionInfo) => {
+    // Show non-blocking notification
+    if (!versionInfo.latestVersion.isBeta) {
+      showToast(`Update available: ${versionInfo.latestVersion.version}`);
+    }
+  },
+});
+```
+
+### Feature Rollouts
+
+```typescript
+// Dashboard configuration
+manager.init();
+
+// Gradually enable new checkout for 20% of users
+if (manager.isFeatureEnabled("new-checkout-v2")) {
+  loadNewCheckout();
+} else {
+  loadLegacyCheckout();
+}
+
+// A/B test with variants
+const buttonColor = manager.getFeatureVariant("cta-button-color");
+switch (buttonColor) {
+  case "green":
+    setButtonColor("#00CC66");
+    break;
+  case "blue":
+    setButtonColor("#0066CC");
+    break;
+  default:
+    setButtonColor("#FF6600"); // control
+}
+```
+
 ### Custom Poll Interval
 
 ```typescript

package/dist/index.d.mts

@@ -49,6 +49,20 @@ interface MaintenanceConfig {
         ips?: string[];
     };
 }
+interface AppVersion {
+    version: string;
+    title: string;
+    releaseNotes: string;
+    downloadUrl?: string;
+    releaseDate: string;
+    isBeta?: boolean;
+}
+interface VersionCheckResponse {
+    updateAvailable: boolean;
+    updateRequired: boolean;
+    updateRecommended: boolean;
+    latestVersion?: AppVersion;
+}
 interface SiteConfig {
     maintenance: MaintenanceConfig;
     messages: StatusMessage[];
@@ -70,12 +84,18 @@ interface SiteManagerConfig {
     userId?: string;
     enableAnalytics?: boolean;
     analyticsFlushInterval?: number;
+    appVersion?: string;
+    enableVersionCheck?: boolean;
+    versionCheckInterval?: number;
+    onUpdateAvailable?: (versionInfo: VersionCheckResponse) => void;
+    onUpdateRequired?: (versionInfo: VersionCheckResponse) => void;
     onError?: (error: Error) => void;
 }
 declare class SiteManager {
     private config;
     private siteConfig;
     private pollIntervalId;
+    private versionCheckIntervalId;
     private messageContainers;
     private dismissedMessages;
     private featureFlagBuckets;
@@ -84,6 +104,7 @@ declare class SiteManager {
     private sessionId;
     private consecutiveFetchFailures;
     private static readonly MAX_CONSECUTIVE_FAILURES;
+    private lastVersionCheck;
     constructor(config: SiteManagerConfig);
     init(): Promise<void>;
     destroy(): void;
@@ -101,6 +122,10 @@ declare class SiteManager {
     private stopAnalyticsFlushing;
     private flushAnalytics;
     private generateSessionId;
+    checkVersion(currentVersion?: string): Promise<VersionCheckResponse | null>;
+    getLastVersionCheck(): VersionCheckResponse | null;
+    private startVersionChecking;
+    private stopVersionChecking;
     private evaluateFeatureFlag;
     private getUserBucket;
     private simpleHash;
@@ -123,4 +148,4 @@ declare class SiteManager {
     private injectStyles;
 }
 
-export { type FeatureFlag, type MaintenanceConfig, type MessagePosition, type MessageStyle, type MessageType, type SiteConfig, SiteManager, type SiteManagerConfig, type StatusMessage, SiteManager as default };
+export { type AppVersion, type FeatureFlag, type MaintenanceConfig, type MessagePosition, type MessageStyle, type MessageType, type SiteConfig, SiteManager, type SiteManagerConfig, type StatusMessage, type VersionCheckResponse, SiteManager as default };

package/dist/index.d.ts

@@ -49,6 +49,20 @@ interface MaintenanceConfig {
         ips?: string[];
     };
 }
+interface AppVersion {
+    version: string;
+    title: string;
+    releaseNotes: string;
+    downloadUrl?: string;
+    releaseDate: string;
+    isBeta?: boolean;
+}
+interface VersionCheckResponse {
+    updateAvailable: boolean;
+    updateRequired: boolean;
+    updateRecommended: boolean;
+    latestVersion?: AppVersion;
+}
 interface SiteConfig {
     maintenance: MaintenanceConfig;
     messages: StatusMessage[];
@@ -70,12 +84,18 @@ interface SiteManagerConfig {
     userId?: string;
     enableAnalytics?: boolean;
     analyticsFlushInterval?: number;
+    appVersion?: string;
+    enableVersionCheck?: boolean;
+    versionCheckInterval?: number;
+    onUpdateAvailable?: (versionInfo: VersionCheckResponse) => void;
+    onUpdateRequired?: (versionInfo: VersionCheckResponse) => void;
     onError?: (error: Error) => void;
 }
 declare class SiteManager {
     private config;
     private siteConfig;
     private pollIntervalId;
+    private versionCheckIntervalId;
     private messageContainers;
     private dismissedMessages;
     private featureFlagBuckets;
@@ -84,6 +104,7 @@ declare class SiteManager {
     private sessionId;
     private consecutiveFetchFailures;
     private static readonly MAX_CONSECUTIVE_FAILURES;
+    private lastVersionCheck;
     constructor(config: SiteManagerConfig);
     init(): Promise<void>;
     destroy(): void;
@@ -101,6 +122,10 @@ declare class SiteManager {
     private stopAnalyticsFlushing;
     private flushAnalytics;
     private generateSessionId;
+    checkVersion(currentVersion?: string): Promise<VersionCheckResponse | null>;
+    getLastVersionCheck(): VersionCheckResponse | null;
+    private startVersionChecking;
+    private stopVersionChecking;
     private evaluateFeatureFlag;
     private getUserBucket;
     private simpleHash;
@@ -123,4 +148,4 @@ declare class SiteManager {
     private injectStyles;
 }
 
-export { type FeatureFlag, type MaintenanceConfig, type MessagePosition, type MessageStyle, type MessageType, type SiteConfig, SiteManager, type SiteManagerConfig, type StatusMessage, SiteManager as default };
+export { type AppVersion, type FeatureFlag, type MaintenanceConfig, type MessagePosition, type MessageStyle, type MessageType, type SiteConfig, SiteManager, type SiteManagerConfig, type StatusMessage, type VersionCheckResponse, SiteManager as default };

package/dist/index.js

@@ -42,7 +42,7 @@ var internalErrorTracker = (() => {
       apiKey: "ft_live_R4nAn9dDWxk6X3oMzB-tcQh0NrYvA04IhSfwPMUmyaU",
       apiUrl: "https://www.featurely.no",
       environment: "production",
-      appVersion: "1.0.7",
+      appVersion: "1.1.1",
       maxBreadcrumbs: 30,
       enabled: true
     });
@@ -57,6 +57,7 @@ var _SiteManager = class _SiteManager {
   constructor(config) {
     this.siteConfig = null;
     this.pollIntervalId = null;
+    this.versionCheckIntervalId = null;
     this.messageContainers = /* @__PURE__ */ new Map();
     this.dismissedMessages = /* @__PURE__ */ new Set();
     this.featureFlagBuckets = /* @__PURE__ */ new Map();
@@ -65,7 +66,8 @@ var _SiteManager = class _SiteManager {
     this.analyticsFlushIntervalId = null;
     this.sessionId = this.generateSessionId();
     this.consecutiveFetchFailures = 0;
-    var _a, _b, _c;
+    this.lastVersionCheck = null;
+    var _a, _b, _c, _d, _e;
     if (!config.apiKey) {
       throw new Error("Featurely Site Manager: apiKey is required");
     }
@@ -87,7 +89,13 @@ var _SiteManager = class _SiteManager {
       onFeatureFlagsUpdated: config.onFeatureFlagsUpdated,
       onError: config.onError,
       enableAnalytics: (_b = config.enableAnalytics) != null ? _b : true,
-      analyticsFlushInterval: (_c = config.analyticsFlushInterval) != null ? _c : 6e4
+      analyticsFlushInterval: (_c = config.analyticsFlushInterval) != null ? _c : 6e4,
+      appVersion: config.appVersion,
+      enableVersionCheck: (_d = config.enableVersionCheck) != null ? _d : false,
+      versionCheckInterval: (_e = config.versionCheckInterval) != null ? _e : 36e5,
+      // 1 hour
+      onUpdateAvailable: config.onUpdateAvailable,
+      onUpdateRequired: config.onUpdateRequired
     };
     this.loadDismissedMessages();
   }
@@ -106,6 +114,10 @@ var _SiteManager = class _SiteManager {
     if (this.config.enableAnalytics) {
       this.startAnalyticsFlushing();
     }
+    if (this.config.enableVersionCheck && this.config.appVersion) {
+      await this.checkVersion();
+      this.startVersionChecking();
+    }
     this.injectStyles();
   }
   /**
@@ -113,6 +125,7 @@ var _SiteManager = class _SiteManager {
    */
   destroy() {
     this.stopPolling();
+    this.stopVersionChecking();
     this.stopAnalyticsFlushing();
     this.flushAnalytics();
     this.clearMessages();
@@ -355,6 +368,76 @@ var _SiteManager = class _SiteManager {
     return `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
   }
   // ============================================================================
+  // Version Checking
+  // ============================================================================
+  /**
+   * Check if an app update is available
+   * @param currentVersion - Optional version to check (defaults to config.appVersion)
+   * @returns Version check response with update status
+   */
+  async checkVersion(currentVersion) {
+    const versionToCheck = currentVersion || this.config.appVersion;
+    if (!versionToCheck) {
+      console.warn(
+        "Featurely Site Manager: appVersion not provided for version check"
+      );
+      return null;
+    }
+    try {
+      const response = await fetch(
+        `${this.config.apiUrl}/api/public/v1/version-check?projectId=${this.config.projectId}&currentVersion=${versionToCheck}`,
+        {
+          headers: {
+            "X-API-Key": this.config.apiKey
+          }
+        }
+      );
+      if (!response.ok) {
+        throw new Error(`Version check failed: ${response.statusText}`);
+      }
+      const versionInfo = await response.json();
+      this.lastVersionCheck = versionInfo;
+      this.trackEvent("version_checked", {
+        currentVersion: versionToCheck,
+        updateAvailable: versionInfo.updateAvailable,
+        updateRequired: versionInfo.updateRequired,
+        updateRecommended: versionInfo.updateRecommended
+      });
+      if (versionInfo.updateRequired && this.config.onUpdateRequired) {
+        this.config.onUpdateRequired(versionInfo);
+      } else if (versionInfo.updateAvailable && this.config.onUpdateAvailable) {
+        this.config.onUpdateAvailable(versionInfo);
+      }
+      return versionInfo;
+    } catch (error) {
+      console.error("Error checking version:", error);
+      if (this.config.onError) {
+        this.config.onError(
+          error instanceof Error ? error : new Error("Failed to check version")
+        );
+      }
+      return null;
+    }
+  }
+  /**
+   * Get the last version check result (cached)
+   */
+  getLastVersionCheck() {
+    return this.lastVersionCheck;
+  }
+  startVersionChecking() {
+    if (this.versionCheckIntervalId) return;
+    this.versionCheckIntervalId = setInterval(() => {
+      this.checkVersion();
+    }, this.config.versionCheckInterval);
+  }
+  stopVersionChecking() {
+    if (this.versionCheckIntervalId) {
+      clearInterval(this.versionCheckIntervalId);
+      this.versionCheckIntervalId = null;
+    }
+  }
+  // ============================================================================
   // Feature Flags
   // ============================================================================
   /**

package/dist/index.mjs

@@ -7,7 +7,7 @@ var internalErrorTracker = (() => {
       apiKey: "ft_live_R4nAn9dDWxk6X3oMzB-tcQh0NrYvA04IhSfwPMUmyaU",
       apiUrl: "https://www.featurely.no",
       environment: "production",
-      appVersion: "1.0.7",
+      appVersion: "1.1.1",
       maxBreadcrumbs: 30,
       enabled: true
     });
@@ -22,6 +22,7 @@ var _SiteManager = class _SiteManager {
   constructor(config) {
     this.siteConfig = null;
     this.pollIntervalId = null;
+    this.versionCheckIntervalId = null;
     this.messageContainers = /* @__PURE__ */ new Map();
     this.dismissedMessages = /* @__PURE__ */ new Set();
     this.featureFlagBuckets = /* @__PURE__ */ new Map();
@@ -30,7 +31,8 @@ var _SiteManager = class _SiteManager {
     this.analyticsFlushIntervalId = null;
     this.sessionId = this.generateSessionId();
     this.consecutiveFetchFailures = 0;
-    var _a, _b, _c;
+    this.lastVersionCheck = null;
+    var _a, _b, _c, _d, _e;
     if (!config.apiKey) {
       throw new Error("Featurely Site Manager: apiKey is required");
     }
@@ -52,7 +54,13 @@ var _SiteManager = class _SiteManager {
       onFeatureFlagsUpdated: config.onFeatureFlagsUpdated,
       onError: config.onError,
       enableAnalytics: (_b = config.enableAnalytics) != null ? _b : true,
-      analyticsFlushInterval: (_c = config.analyticsFlushInterval) != null ? _c : 6e4
+      analyticsFlushInterval: (_c = config.analyticsFlushInterval) != null ? _c : 6e4,
+      appVersion: config.appVersion,
+      enableVersionCheck: (_d = config.enableVersionCheck) != null ? _d : false,
+      versionCheckInterval: (_e = config.versionCheckInterval) != null ? _e : 36e5,
+      // 1 hour
+      onUpdateAvailable: config.onUpdateAvailable,
+      onUpdateRequired: config.onUpdateRequired
     };
     this.loadDismissedMessages();
   }
@@ -71,6 +79,10 @@ var _SiteManager = class _SiteManager {
     if (this.config.enableAnalytics) {
       this.startAnalyticsFlushing();
     }
+    if (this.config.enableVersionCheck && this.config.appVersion) {
+      await this.checkVersion();
+      this.startVersionChecking();
+    }
     this.injectStyles();
   }
   /**
@@ -78,6 +90,7 @@ var _SiteManager = class _SiteManager {
    */
   destroy() {
     this.stopPolling();
+    this.stopVersionChecking();
     this.stopAnalyticsFlushing();
     this.flushAnalytics();
     this.clearMessages();
@@ -320,6 +333,76 @@ var _SiteManager = class _SiteManager {
     return `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
   }
   // ============================================================================
+  // Version Checking
+  // ============================================================================
+  /**
+   * Check if an app update is available
+   * @param currentVersion - Optional version to check (defaults to config.appVersion)
+   * @returns Version check response with update status
+   */
+  async checkVersion(currentVersion) {
+    const versionToCheck = currentVersion || this.config.appVersion;
+    if (!versionToCheck) {
+      console.warn(
+        "Featurely Site Manager: appVersion not provided for version check"
+      );
+      return null;
+    }
+    try {
+      const response = await fetch(
+        `${this.config.apiUrl}/api/public/v1/version-check?projectId=${this.config.projectId}&currentVersion=${versionToCheck}`,
+        {
+          headers: {
+            "X-API-Key": this.config.apiKey
+          }
+        }
+      );
+      if (!response.ok) {
+        throw new Error(`Version check failed: ${response.statusText}`);
+      }
+      const versionInfo = await response.json();
+      this.lastVersionCheck = versionInfo;
+      this.trackEvent("version_checked", {
+        currentVersion: versionToCheck,
+        updateAvailable: versionInfo.updateAvailable,
+        updateRequired: versionInfo.updateRequired,
+        updateRecommended: versionInfo.updateRecommended
+      });
+      if (versionInfo.updateRequired && this.config.onUpdateRequired) {
+        this.config.onUpdateRequired(versionInfo);
+      } else if (versionInfo.updateAvailable && this.config.onUpdateAvailable) {
+        this.config.onUpdateAvailable(versionInfo);
+      }
+      return versionInfo;
+    } catch (error) {
+      console.error("Error checking version:", error);
+      if (this.config.onError) {
+        this.config.onError(
+          error instanceof Error ? error : new Error("Failed to check version")
+        );
+      }
+      return null;
+    }
+  }
+  /**
+   * Get the last version check result (cached)
+   */
+  getLastVersionCheck() {
+    return this.lastVersionCheck;
+  }
+  startVersionChecking() {
+    if (this.versionCheckIntervalId) return;
+    this.versionCheckIntervalId = setInterval(() => {
+      this.checkVersion();
+    }, this.config.versionCheckInterval);
+  }
+  stopVersionChecking() {
+    if (this.versionCheckIntervalId) {
+      clearInterval(this.versionCheckIntervalId);
+      this.versionCheckIntervalId = null;
+    }
+  }
+  // ============================================================================
   // Feature Flags
   // ============================================================================
   /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "featurely-site-manager",
-  "version": "1.0.8",
-  "description": "Site management SDK for maintenance mode, status messages, and feature flags",
+  "version": "1.1.1",
+  "description": "Complete site management SDK for maintenance mode, status messages, feature flags, version checking, and analytics",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -29,8 +29,13 @@
     "maintenance-mode",
     "status-messages",
     "feature-flags",
+    "version-checking",
+    "update-notifications",
+    "analytics",
     "downtime",
-    "banners"
+    "banners",
+    "a/b-testing",
+    "feature-toggles"
   ],
   "author": "Featurely",
   "license": "MIT",