@clix-so/react-native-sdk 0.0.1

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License with Custom Restrictions
+
+Copyright (c) 2025 Clix
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+1. The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+2. All copies of substantial portions of the Software may only be used in connection
+with services provided by Clix, similar to restrictions in modified MIT licenses.
+
+3. The original and/or modified Software must be used exclusively to work with Clix
+services, ensuring it is not repurposed for unrelated platforms without explicit permission.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,345 @@
+# Clix React Native SDK
+
+Clix React Native SDK is a powerful tool for managing push notifications and user events in your React Native application. It provides a simple and intuitive interface for user engagement and analytics.
+
+## Installation
+
+### 1. Install the SDK
+
+```bash
+npm install @clix-so/react-native-sdk
+```
+
+Or using Yarn:
+```bash
+yarn add @clix-so/react-native-sdk
+```
+
+### 2. Install Required Dependencies
+
+You must install all required peer dependencies:
+
+```bash
+npm install @notifee/react-native @react-native-firebase/app @react-native-firebase/messaging react-native-device-info react-native-get-random-values react-native-mmkv uuid
+```
+
+Or using Yarn:
+```bash
+yarn add @notifee/react-native @react-native-firebase/app @react-native-firebase/messaging react-native-device-info react-native-get-random-values react-native-mmkv uuid
+```
+
+Or using Expo:
+```bash
+npx expo install @notifee/react-native @react-native-firebase/app @react-native-firebase/messaging react-native-device-info react-native-get-random-values react-native-mmkv uuid
+```
+
+### 3. Version Compatibility
+
+**react-native-mmkv Version Selection (Critical)**
+
+| React Native Version | Architecture | react-native-mmkv Version |
+|---------------------|-------------|---------------------------|
+| **0.70-0.73** | Old Architecture | `^2.12.2` |
+| **0.74+** | New Architecture | `^3.0.1+` |
+
+⚠️ **New Architecture Requirement**: react-native-mmkv v3.x requires React Native's New Architecture (TurboModules) to be enabled.
+
+**Important Setup Note**: uuid requires react-native-get-random-values polyfill:
+```javascript
+import 'react-native-get-random-values'; // Must be imported first
+import { v4 as uuidv4 } from 'uuid';
+```
+
+## Requirements
+
+- React Native 0.60.0 or later
+- iOS 14.0+ / Android API 21+
+- TypeScript 4.0+ (optional but recommended)
+
+## Usage
+
+### Initialization
+
+Initialize the SDK with a ClixConfig. The config is required and contains your project settings.
+
+```typescript
+import Clix, { ClixLogLevel } from '@clix-so/react-native-sdk';
+
+// Initialize Clix SDK
+await Clix.initialize({
+  projectId: 'YOUR_PROJECT_ID',
+  apiKey: 'YOUR_API_KEY',
+  logLevel: ClixLogLevel.DEBUG, // Optional: set log level
+});
+```
+
+### User Management
+
+```typescript
+// Set user ID
+await Clix.setUserId('user123');
+
+// Set user properties
+await Clix.setUserProperty('name', 'John Doe');
+await Clix.setUserProperties({
+  age: 25,
+  premium: true,
+  subscription_plan: 'pro',
+});
+
+// Remove user properties
+await Clix.removeUserProperty('name');
+await Clix.removeUserProperties(['age', 'premium']);
+
+// Remove user ID
+await Clix.removeUserId();
+```
+
+### Logging
+
+```typescript
+Clix.setLogLevel(ClixLogLevel.DEBUG);
+// Available log levels:
+// - 'none': No logs
+// - 'error': Error logs only
+// - 'warning': Warning logs
+// - 'info': Info logs
+// - 'debug': Debug logs
+// - 'verbose': All logs
+```
+
+### Push Notification Integration
+
+The Clix React Native SDK automatically handles push notification integration through Firebase Cloud Messaging.
+
+#### Setup Firebase
+
+**Complete Firebase Setup**: Follow the comprehensive setup guide at [React Native Firebase](https://rnfirebase.io/), which includes:
+
+- Creating a Firebase project
+- Adding your app to Firebase
+- Installing configuration files (`google-services.json` for Android, `GoogleService-Info.plist` for iOS)
+- Platform-specific setup for push notifications
+- Enabling Firebase Cloud Messaging in your Firebase console
+
+For push notifications specifically, ensure you complete the [Messaging setup guide](https://rnfirebase.io/messaging/usage).
+
+#### Background Message Handler Setup
+
+**Important**: The background message handler must be set up outside of your application lifecycle, typically in your `index.js` file:
+
+```typescript
+// index.js
+import { AppRegistry } from 'react-native';
+import { name as appName } from './app.json';
+import App from './src/App';
+import { NotificationService } from '@clix-so/react-native-sdk';
+
+// Setup background message handler outside of application lifecycle
+NotificationService.setupBackgroundMessageHandler();
+
+AppRegistry.registerComponent(appName, () => App);
+```
+
+#### Handling Notifications
+
+The SDK automatically handles notification registration and token management. Notifications are processed internally for analytics and tracking.
+
+```typescript
+// Notification handling is automatic - no additional code required
+// The SDK will track notification delivery and engagement automatically
+```
+
+## Firebase Setup
+
+### iOS Setup
+
+1. Add your `GoogleService-Info.plist` to the iOS project in Xcode
+2. Enable Push Notifications capability in your iOS project
+3. Add Background Modes capability and check "Remote notifications"
+4. Update your `ios/Podfile`:
+
+```ruby
+platform :ios, '14.0'
+```
+
+5. Run `cd ios && pod install`
+
+### Android Setup
+
+1. Add your `google-services.json` to `android/app/`
+2. Add the Google Services plugin to your `android/build.gradle`:
+
+```gradle
+buildscript {
+    dependencies {
+        classpath 'com.google.gms:google-services:4.3.15'
+    }
+}
+```
+
+3. Apply the plugin in `android/app/build.gradle`:
+
+```gradle
+apply plugin: 'com.google.gms.google-services'
+```
+
+## Configuration Options
+
+### ClixConfig
+
+- `projectId` (required): Your Clix project ID
+- `apiKey` (required): Your Clix API key  
+- `endpoint`: API endpoint (default: 'https://api.clix.so')
+- `logLevel`: Logging level (default: 'error')
+- `extraHeaders`: Additional HTTP headers for API requests
+
+### Log Levels
+
+- `verbose`: All logs including detailed debugging
+- `debug`: Debug information and above
+- `info`: General information and above
+- `warning`: Warning messages and above
+- `error`: Error messages only
+- `none`: No logging
+
+## Sample App
+
+A comprehensive sample app is provided in the `samples/BasicApp` directory. The sample demonstrates:
+
+- Basic Clix SDK integration
+- Push notification handling with Firebase
+- User property management
+- Device information display
+
+To run the sample:
+
+1. Navigate to `samples/BasicApp`
+2. Install dependencies: `npm install` or `yarn install`
+3. Setup Firebase (add your config files)
+4. Update `src/ClixInfo.ts` with your project details
+5. Run the app:
+   - iOS: `cd ios && pod install && cd .. && npx react-native run-ios`
+   - Android: `npx react-native run-android`
+
+## Error Handling
+
+All SDK operations can throw `ClixError`. Always handle potential errors:
+
+```typescript
+try {
+  await Clix.setUserId('user123');
+} catch (error) {
+  console.error('Failed to set user ID:', error);
+}
+```
+
+## Thread Safety
+
+The SDK is thread-safe and all operations can be called from any thread. Async operations will automatically wait for SDK initialization to complete.
+
+## Advanced Features
+
+### Notification Service Features
+
+The `NotificationService` is split into two parts:
+
+- **Static Background Handler**: Handles messages when the app is in background or terminated
+- **Instance Foreground Handler**: Handles messages when the app is in foreground
+
+Key features:
+- Automatic permission handling
+- Token refresh management
+- Local notification display
+- Event tracking for analytics
+- Background notification storage
+
+### Custom Properties
+
+User properties support various data types:
+
+```typescript
+await Clix.setUserProperties({
+  name: 'John Doe',           // String
+  age: 25,                    // Number
+  premium: true,              // Boolean
+  tags: ['react-native', 'mobile'], // Array
+  metadata: {                 // Object
+    source: 'mobile_app',
+    version: '1.0.0',
+  },
+});
+```
+
+## Platform-Specific Considerations
+
+### iOS
+
+- Requires iOS 14.0 or later
+- Push notifications require user permission
+- Background processing is automatically handled
+- Ensure proper entitlements are configured
+
+### Android
+
+- Requires Android API level 21 or later
+- Notification channels are automatically managed
+- Background processing follows Android guidelines
+- FCM token refresh is handled automatically
+
+## Performance
+
+- Lightweight initialization
+- Efficient background processing
+- Minimal memory footprint
+- Optimized network requests
+- Batched event processing
+
+## Privacy
+
+The SDK respects user privacy:
+- Only collects necessary device information
+- User data is handled according to your privacy policy
+- Push tokens are managed securely
+- No personal data is collected without consent
+
+## TypeScript Support
+
+The SDK is written in TypeScript and provides full type definitions:
+
+```typescript
+import { Clix, ClixConfig, ClixUserProperty } from '@clix-so/react-native-sdk';
+
+const config: ClixConfig = {
+  projectId: 'YOUR_PROJECT_ID',
+  apiKey: 'YOUR_API_KEY',
+};
+
+const properties: Record<string, ClixUserProperty> = {
+  name: 'John Doe',
+  age: 25,
+};
+```
+
+## License
+
+This project is licensed under the MIT License with Custom Restrictions. See the [LICENSE](LICENSE) file for details.
+
+## Changelog
+
+See the full release history and changes in the [CHANGELOG.md](CHANGELOG.md) file.
+
+## Contributing
+
+We welcome contributions! Please read the [CONTRIBUTING.md](CONTRIBUTING.md) guide before submitting issues or pull requests.
+
+## Support
+
+For support and questions:
+- Check the sample app for implementation examples
+- Review the API documentation
+- Contact support through your Clix dashboard
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/lib/module/core/Clix.js

@@ -0,0 +1,217 @@
+"use strict";
+
+import { ClixAPIClient } from "../services/ClixAPIClient.js";
+import { DeviceAPIService } from "../services/DeviceAPIService.js";
+import { DeviceService } from "../services/DeviceService.js";
+import { EventAPIService } from "../services/EventAPIService.js";
+import { EventService } from "../services/EventService.js";
+import { NotificationService } from "../services/NotificationService.js";
+import { StorageService } from "../services/StorageService.js";
+import { TokenService } from "../services/TokenService.js";
+import { ClixError } from "../utils/ClixError.js";
+import { ClixLogger, ClixLogLevel } from "../utils/logging/ClixLogger.js";
+import { ClixInitCoordinator } from "./ClixInitCoordinator.js";
+export class Clix {
+  static initCoordinator = new ClixInitCoordinator();
+  constructor() {}
+
+  /**
+   * Initialize Clix SDK
+   */
+  static async initialize(config) {
+    try {
+      if (this.initCoordinator.isInitializationFailed()) {
+        this.initCoordinator.reset();
+      }
+      ClixLogger.setLogLevel(config.logLevel || ClixLogLevel.ERROR);
+      ClixLogger.debug('Initializing Clix SDK');
+      this.shared = new Clix();
+      await this.shared.setConfig(config);
+      ClixLogger.debug('Clix SDK initialized successfully');
+      this.initCoordinator.completeInitialization();
+    } catch (error) {
+      const errorInstance = error instanceof Error ? error : new Error(String(error));
+      this.initCoordinator.failInitialization(errorInstance);
+      throw ClixError.notInitialized({
+        cause: errorInstance
+      });
+    }
+  }
+
+  /**
+   * Set user ID
+   */
+  static async setUserId(userId) {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      if (this.shared?.deviceService) {
+        await this.shared.deviceService.setProjectUserId(userId);
+      }
+    } catch (error) {
+      ClixLogger.error(`Failed to set user ID: ${error}`);
+    }
+  }
+
+  /**
+   * Remove user ID
+   */
+  static async removeUserId() {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      if (this.shared?.deviceService) {
+        await this.shared.deviceService.removeProjectUserId();
+      }
+    } catch (error) {
+      ClixLogger.error(`Failed to remove user ID: ${error}`);
+    }
+  }
+
+  /**
+   * Set user property
+   */
+  static async setUserProperty(key, value) {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      if (this.shared?.deviceService) {
+        await this.shared.deviceService.updateUserProperties({
+          [key]: value
+        });
+      }
+    } catch (error) {
+      ClixLogger.error(`Failed to set user property: ${error}`);
+    }
+  }
+
+  /**
+   * Set user properties
+   */
+  static async setUserProperties(userProperties) {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      if (this.shared?.deviceService) {
+        await this.shared.deviceService.updateUserProperties(userProperties);
+      }
+    } catch (error) {
+      ClixLogger.error(`Failed to set user properties: ${error}`);
+    }
+  }
+
+  /**
+   * Remove user property
+   */
+  static async removeUserProperty(key) {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      if (this.shared?.deviceService) {
+        await this.shared.deviceService.removeUserProperties([key]);
+      }
+    } catch (error) {
+      ClixLogger.error(`Failed to remove user property: ${error}`);
+    }
+  }
+
+  /**
+   * Remove user properties
+   */
+  static async removeUserProperties(keys) {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      if (this.shared?.deviceService) {
+        await this.shared.deviceService.removeUserProperties(keys);
+      }
+    } catch (error) {
+      ClixLogger.error(`Failed to remove user properties: ${error}`);
+    }
+  }
+
+  /**
+   * Get device ID
+   */
+  static async getDeviceId() {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      if (this.shared?.deviceService) {
+        const deviceId = await this.shared.deviceService.getCurrentDeviceId();
+        return deviceId;
+      }
+      return undefined;
+    } catch (error) {
+      ClixLogger.error(`Failed to get device ID: ${error}`);
+      return undefined;
+    }
+  }
+
+  /**
+   * Get push token
+   */
+  static async getPushToken() {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      if (this.shared?.notificationService) {
+        const token = await this.shared.notificationService.getCurrentToken();
+        return token || undefined;
+      }
+      return undefined;
+    } catch (error) {
+      ClixLogger.error(`Failed to get push token: ${error}`);
+      return undefined;
+    }
+  }
+
+  /**
+   * Set log level
+   */
+  static setLogLevel(level) {
+    ClixLogger.setLogLevel(level);
+  }
+
+  /**
+   * Track event
+   */
+  static async trackEvent(name, options) {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      if (this.shared?.eventService) {
+        await this.shared.eventService.trackEvent(name, options?.properties, options?.messageId);
+      }
+    } catch (error) {
+      ClixLogger.error(`Failed to track event: ${error}`);
+    }
+  }
+
+  /**
+   * Set configuration
+   */
+  async setConfig(config) {
+    this.storageService = new StorageService();
+    try {
+      await this.storageService.set('project_id', config.projectId);
+      await this.storageService.set('api_key', config.apiKey);
+      await this.storageService.set('clix_config', {
+        projectId: config.projectId,
+        apiKey: config.apiKey,
+        endpoint: config.endpoint,
+        logLevel: config.logLevel,
+        extraHeaders: config.extraHeaders
+      });
+    } catch (error) {
+      ClixLogger.warn('Failed to store configuration in storage, continuing with in-memory config', error);
+    }
+    const apiClient = new ClixAPIClient({
+      ...config,
+      endpoint: config.endpoint || 'https://api.clix.so',
+      logLevel: config.logLevel || ClixLogLevel.ERROR
+    });
+    const deviceAPIService = new DeviceAPIService(apiClient);
+    const eventAPIService = new EventAPIService(apiClient);
+    const tokenService = new TokenService(this.storageService);
+    this.deviceService = new DeviceService(this.storageService, tokenService, deviceAPIService);
+    this.eventService = new EventService(eventAPIService, this.deviceService);
+    try {
+      this.notificationService = await NotificationService.getInstance().initialize(this.eventService, this.storageService, this.deviceService, tokenService);
+    } catch (error) {
+      ClixLogger.warn('Failed to fully initialize notification service, some features may be limited', error);
+    }
+  }
+}
+//# sourceMappingURL=Clix.js.map

package/lib/module/core/Clix.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ClixAPIClient","DeviceAPIService","DeviceService","EventAPIService","EventService","NotificationService","StorageService","TokenService","ClixError","ClixLogger","ClixLogLevel","ClixInitCoordinator","Clix","initCoordinator","constructor","initialize","config","isInitializationFailed","reset","setLogLevel","logLevel","ERROR","debug","shared","setConfig","completeInitialization","error","errorInstance","Error","String","failInitialization","notInitialized","cause","setUserId","userId","waitForInitialization","deviceService","setProjectUserId","removeUserId","removeProjectUserId","setUserProperty","key","value","updateUserProperties","setUserProperties","userProperties","removeUserProperty","removeUserProperties","keys","getDeviceId","deviceId","getCurrentDeviceId","undefined","getPushToken","notificationService","token","getCurrentToken","level","trackEvent","name","options","eventService","properties","messageId","storageService","set","projectId","apiKey","endpoint","extraHeaders","warn","apiClient","deviceAPIService","eventAPIService","tokenService","getInstance"],"sourceRoot":"../../../src","sources":["core/Clix.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/ClixConfig.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=ClixConfig.js.map

package/lib/module/core/ClixConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["core/ClixConfig.ts"],"mappings":"","ignoreList":[]}

package/lib/module/core/ClixInitCoordinator.js

@@ -0,0 +1,58 @@
+"use strict";
+
+import { ClixLogger } from "../utils/logging/ClixLogger.js";
+export class ClixInitCoordinator {
+  resolve = null;
+  reject = null;
+  isCompleted = false;
+  isFailed = false;
+  constructor() {
+    this.promise = new Promise((resolve, reject) => {
+      this.resolve = resolve;
+      this.reject = reject;
+    });
+  }
+  async waitForInitialization() {
+    if (this.isCompleted) {
+      return Promise.resolve();
+    }
+    return this.promise;
+  }
+  isInitializationFailed() {
+    return this.isFailed;
+  }
+  isInitializationCompleted() {
+    return this.isCompleted;
+  }
+  completeInitialization() {
+    if (this.isAlreadyFinalized()) {
+      return;
+    }
+    this.isCompleted = true;
+    this.resolve?.();
+  }
+  failInitialization(error) {
+    if (this.isAlreadyFinalized()) {
+      return;
+    }
+    this.isFailed = true;
+    ClixLogger.warn('Clix initialization failed:', error);
+    this.reject?.(error);
+  }
+  reset() {
+    this.isCompleted = false;
+    this.isFailed = false;
+    this.promise = new Promise((resolve, reject) => {
+      this.resolve = resolve;
+      this.reject = reject;
+    });
+  }
+  isAlreadyFinalized() {
+    if (this.isCompleted || this.isFailed) {
+      ClixLogger.warn('Initialization already completed or failed');
+      return true;
+    }
+    return false;
+  }
+}
+//# sourceMappingURL=ClixInitCoordinator.js.map

package/lib/module/core/ClixInitCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ClixLogger","ClixInitCoordinator","resolve","reject","isCompleted","isFailed","constructor","promise","Promise","waitForInitialization","isInitializationFailed","isInitializationCompleted","completeInitialization","isAlreadyFinalized","failInitialization","error","warn","reset"],"sourceRoot":"../../../src","sources":["core/ClixInitCoordinator.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,gCAA6B;AAExD,OAAO,MAAMC,mBAAmB,CAAC;EAEvBC,OAAO,GAAwB,IAAI;EACnCC,MAAM,GAAoC,IAAI;EAC9CC,WAAW,GAAG,KAAK;EACnBC,QAAQ,GAAG,KAAK;EAExBC,WAAWA,CAAA,EAAG;IACZ,IAAI,CAACC,OAAO,GAAG,IAAIC,OAAO,CAAO,CAACN,OAAO,EAAEC,MAAM,KAAK;MACpD,IAAI,CAACD,OAAO,GAAGA,OAAO;MACtB,IAAI,CAACC,MAAM,GAAGA,MAAM;IACtB,CAAC,CAAC;EACJ;EAEA,MAAMM,qBAAqBA,CAAA,EAAkB;IAC3C,IAAI,IAAI,CAACL,WAAW,EAAE;MACpB,OAAOI,OAAO,CAACN,OAAO,CAAC,CAAC;IAC1B;IACA,OAAO,IAAI,CAACK,OAAO;EACrB;EAEAG,sBAAsBA,CAAA,EAAY;IAChC,OAAO,IAAI,CAACL,QAAQ;EACtB;EAEAM,yBAAyBA,CAAA,EAAY;IACnC,OAAO,IAAI,CAACP,WAAW;EACzB;EAEAQ,sBAAsBA,CAAA,EAAS;IAC7B,IAAI,IAAI,CAACC,kBAAkB,CAAC,CAAC,EAAE;MAC7B;IACF;IACA,IAAI,CAACT,WAAW,GAAG,IAAI;IACvB,IAAI,CAACF,OAAO,GAAG,CAAC;EAClB;EAEAY,kBAAkBA,CAACC,KAAY,EAAQ;IACrC,IAAI,IAAI,CAACF,kBAAkB,CAAC,CAAC,EAAE;MAC7B;IACF;IACA,IAAI,CAACR,QAAQ,GAAG,IAAI;IACpBL,UAAU,CAACgB,IAAI,CAAC,6BAA6B,EAAED,KAAK,CAAC;IACrD,IAAI,CAACZ,MAAM,GAAGY,KAAK,CAAC;EACtB;EAEAE,KAAKA,CAAA,EAAS;IACZ,IAAI,CAACb,WAAW,GAAG,KAAK;IACxB,IAAI,CAACC,QAAQ,GAAG,KAAK;IACrB,IAAI,CAACE,OAAO,GAAG,IAAIC,OAAO,CAAO,CAACN,OAAO,EAAEC,MAAM,KAAK;MACpD,IAAI,CAACD,OAAO,GAAGA,OAAO;MACtB,IAAI,CAACC,MAAM,GAAGA,MAAM;IACtB,CAAC,CAAC;EACJ;EAEQU,kBAAkBA,CAAA,EAAY;IACpC,IAAI,IAAI,CAACT,WAAW,IAAI,IAAI,CAACC,QAAQ,EAAE;MACrCL,UAAU,CAACgB,IAAI,CAAC,4CAA4C,CAAC;MAC7D,OAAO,IAAI;IACb;IACA,OAAO,KAAK;EACd;AACF","ignoreList":[]}

package/lib/module/core/ClixVersion.js

@@ -0,0 +1,17 @@
+"use strict";
+
+export class ClixVersion {
+  static fallBackVersion = '0.0.0';
+  static async getVersion() {
+    if (this.cachedVersion) {
+      return this.cachedVersion;
+    }
+    try {
+      this.cachedVersion = require('../../../package.json').version || this.fallBackVersion;
+      return this.cachedVersion;
+    } catch (error) {
+      return '0.0.0';
+    }
+  }
+}
+//# sourceMappingURL=ClixVersion.js.map