@rolloutly/core 0.1.0

package/README.md

@@ -0,0 +1,97 @@
+# @rolloutly/core
+
+Core JavaScript SDK for [Rolloutly](https://rolloutly.com) feature flags.
+
+## Installation
+
+```bash
+npm install @rolloutly/core
+# or
+pnpm add @rolloutly/core
+# or
+yarn add @rolloutly/core
+```
+
+## Usage
+
+```typescript
+import { RolloutlyClient } from '@rolloutly/core';
+
+// Initialize the client
+const client = new RolloutlyClient({
+  token: 'rly_your_project_production_xxx',
+});
+
+// Wait for initialization
+await client.waitForInit();
+
+// Get a flag value
+const showNewFeature = client.isEnabled('new-feature');
+
+// Get a typed flag value
+const rateLimit = client.getFlag<number>('api-rate-limit');
+
+// Get all flags
+const flags = client.getFlags();
+
+// Subscribe to changes
+const unsubscribe = client.subscribe(() => {
+  console.log('Flags updated!');
+});
+
+// Cleanup when done
+client.close();
+```
+
+## Configuration
+
+```typescript
+const client = new RolloutlyClient({
+  // Required: Your SDK token
+  token: 'rly_xxx',
+
+  // Optional: Custom API URL (default: https://rolloutly.com)
+  baseUrl: 'https://your-instance.com',
+
+  // Optional: Enable real-time updates (default: true)
+  realtimeEnabled: true,
+
+  // Optional: Default values before flags load
+  defaultFlags: {
+    'new-feature': false,
+    'api-rate-limit': 100,
+  },
+
+  // Optional: Enable debug logging (default: false)
+  debug: true,
+});
+```
+
+## API Reference
+
+### `RolloutlyClient`
+
+#### Methods
+
+- `waitForInit(): Promise<void>` - Wait for the client to initialize
+- `getFlag<T>(key: string): T | undefined` - Get a single flag value
+- `getFlags(): FlagMap` - Get all flags
+- `isEnabled(key: string): boolean` - Check if a boolean flag is enabled
+- `getStatus(): ClientStatus` - Get client status ('initializing' | 'ready' | 'error')
+- `getError(): Error | null` - Get the last error
+- `subscribe(listener: () => void): () => void` - Subscribe to flag changes
+- `close(): void` - Cleanup and disconnect
+
+## For React
+
+For React applications, use `@rolloutly/react` which provides hooks and a provider:
+
+```bash
+npm install @rolloutly/react
+```
+
+See [@rolloutly/react](../react) for more information.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,239 @@
+'use strict';
+
+var app = require('firebase/app');
+var database = require('firebase/database');
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://rolloutly.com";
+var CACHE_KEY = "rolloutly_flags";
+var RolloutlyClient = class {
+  constructor(config) {
+    this.flags = {};
+    this.status = "initializing";
+    this.error = null;
+    this.listeners = /* @__PURE__ */ new Set();
+    this.firebaseApp = null;
+    this.database = null;
+    this.realtimeUnsubscribe = null;
+    this.config = {
+      token: config.token,
+      baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
+      realtimeEnabled: config.realtimeEnabled ?? true,
+      defaultFlags: config.defaultFlags ?? {},
+      debug: config.debug ?? false
+    };
+    const parsed = this.parseToken(config.token);
+    if (!parsed) {
+      throw new Error("Invalid SDK token format");
+    }
+    this.parsedToken = parsed;
+    this.initPromise = new Promise((resolve, reject) => {
+      this.initResolve = resolve;
+      this.initReject = reject;
+    });
+    this.loadCachedFlags();
+    void this.initialize();
+  }
+  /**
+   * Wait for the client to be initialized
+   */
+  async waitForInit() {
+    return this.initPromise;
+  }
+  /**
+   * Get a single flag value
+   */
+  getFlag(key) {
+    const flag = this.flags[key];
+    if (flag) {
+      return flag.enabled ? flag.value : this.config.defaultFlags[key];
+    }
+    return this.config.defaultFlags[key];
+  }
+  /**
+   * Get all flags
+   */
+  getFlags() {
+    return { ...this.flags };
+  }
+  /**
+   * Check if a boolean flag is enabled
+   */
+  isEnabled(key) {
+    const flag = this.flags[key];
+    if (!flag) {
+      return Boolean(this.config.defaultFlags[key]);
+    }
+    if (!flag.enabled) {
+      return Boolean(this.config.defaultFlags[key]);
+    }
+    return flag.type === "boolean" ? Boolean(flag.value) : true;
+  }
+  /**
+   * Get current client status
+   */
+  getStatus() {
+    return this.status;
+  }
+  /**
+   * Get the last error if any
+   */
+  getError() {
+    return this.error;
+  }
+  /**
+   * Subscribe to flag changes (for React useSyncExternalStore)
+   */
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  /**
+   * Cleanup and disconnect
+   */
+  close() {
+    if (this.realtimeUnsubscribe) {
+      this.realtimeUnsubscribe();
+      this.realtimeUnsubscribe = null;
+    }
+    if (this.database) {
+      const flagsRef = database.ref(
+        this.database,
+        `flags/${this.parsedToken.projectId}/${this.parsedToken.environmentKey}`
+      );
+      database.off(flagsRef);
+    }
+    this.listeners.clear();
+    this.log("Client closed");
+  }
+  // ==================== Private Methods ====================
+  parseToken(token) {
+    const parts = token.split("_");
+    if (parts.length < 4 || parts[0] !== "rly") {
+      return null;
+    }
+    return {
+      projectId: parts[1],
+      environmentKey: parts[2]
+    };
+  }
+  async initialize() {
+    try {
+      await this.fetchFlags();
+      if (this.config.realtimeEnabled) {
+        await this.setupRealtime();
+      }
+      this.status = "ready";
+      this.initResolve();
+      this.log("Client initialized");
+    } catch (err) {
+      this.status = "error";
+      this.error = err instanceof Error ? err : new Error(String(err));
+      this.initReject(this.error);
+      this.log("Initialization failed:", this.error.message);
+    }
+  }
+  async fetchFlags() {
+    const url = `${this.config.baseUrl}/api/sdk/flags`;
+    const response = await fetch(url, {
+      headers: {
+        Authorization: `Bearer ${this.config.token}`
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to fetch flags: ${response.status}`);
+    }
+    const data = await response.json();
+    this.flags = data.flags;
+    this.cacheFlags();
+    this.notifyListeners();
+    this.log("Flags fetched:", Object.keys(this.flags).length);
+  }
+  async setupRealtime() {
+    const databaseURL = await this.getDatabaseUrl();
+    if (!databaseURL) {
+      this.log("Realtime DB URL not available, skipping real-time updates");
+      return;
+    }
+    this.firebaseApp = app.initializeApp(
+      {
+        databaseURL
+      },
+      `rolloutly-${Date.now()}`
+    );
+    this.database = database.getDatabase(this.firebaseApp);
+    const flagsRef = database.ref(
+      this.database,
+      `flags/${this.parsedToken.projectId}/${this.parsedToken.environmentKey}`
+    );
+    this.realtimeUnsubscribe = database.onValue(
+      flagsRef,
+      (snapshot) => {
+        const data = snapshot.val();
+        if (data) {
+          this.flags = Object.entries(data).reduce(
+            (acc, [key, flag]) => {
+              acc[key] = { ...flag, key };
+              return acc;
+            },
+            {}
+          );
+          this.cacheFlags();
+          this.notifyListeners();
+          this.log("Realtime update received");
+        }
+      },
+      (error) => {
+        this.log("Realtime error:", error.message);
+      }
+    );
+  }
+  async getDatabaseUrl() {
+    try {
+      const url = `${this.config.baseUrl}/api/sdk/config`;
+      const response = await fetch(url, {
+        headers: {
+          Authorization: `Bearer ${this.config.token}`
+        }
+      });
+      if (response.ok) {
+        const data = await response.json();
+        return data.databaseUrl ?? null;
+      }
+    } catch {
+    }
+    return null;
+  }
+  loadCachedFlags() {
+    if (typeof window === "undefined") return;
+    try {
+      const cached = localStorage.getItem(CACHE_KEY);
+      if (cached) {
+        this.flags = JSON.parse(cached);
+        this.log("Loaded cached flags");
+      }
+    } catch {
+    }
+  }
+  cacheFlags() {
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.setItem(CACHE_KEY, JSON.stringify(this.flags));
+    } catch {
+    }
+  }
+  notifyListeners() {
+    this.listeners.forEach((listener) => listener());
+  }
+  log(...args) {
+    if (this.config.debug) {
+      console.log("[Rolloutly]", ...args);
+    }
+  }
+};
+
+exports.RolloutlyClient = RolloutlyClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":["ref","off","initializeApp","getDatabase","onValue"],"mappings":"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","file":"index.cjs","sourcesContent":["import { initializeApp, type FirebaseApp } from 'firebase/app';\nimport {\n  getDatabase,\n  ref,\n  onValue,\n  off,\n  type Database,\n  type Unsubscribe,\n} from 'firebase/database';\n\nimport type {\n  ClientStatus,\n  Flag,\n  FlagChangeListener,\n  FlagMap,\n  FlagValue,\n  ParsedToken,\n  RolloutlyConfig,\n} from './types';\n\nconst DEFAULT_BASE_URL = 'https://rolloutly.com';\nconst CACHE_KEY = 'rolloutly_flags';\n\nexport class RolloutlyClient {\n  private config: Required<\n    Omit<RolloutlyConfig, 'defaultFlags'> & {\n      defaultFlags: Record<string, FlagValue>;\n    }\n  >;\n  private flags: FlagMap = {};\n  private status: ClientStatus = 'initializing';\n  private error: Error | null = null;\n  private listeners: Set<FlagChangeListener> = new Set();\n  private parsedToken: ParsedToken;\n  private firebaseApp: FirebaseApp | null = null;\n  private database: Database | null = null;\n  private realtimeUnsubscribe: Unsubscribe | null = null;\n  private initPromise: Promise<void>;\n  private initResolve!: () => void;\n  private initReject!: (error: Error) => void;\n\n  constructor(config: RolloutlyConfig) {\n    this.config = {\n      token: config.token,\n      baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,\n      realtimeEnabled: config.realtimeEnabled ?? true,\n      defaultFlags: config.defaultFlags ?? {},\n      debug: config.debug ?? false,\n    };\n\n    // Parse the token\n    const parsed = this.parseToken(config.token);\n\n    if (!parsed) {\n      throw new Error('Invalid SDK token format');\n    }\n\n    this.parsedToken = parsed;\n\n    // Create init promise\n    this.initPromise = new Promise((resolve, reject) => {\n      this.initResolve = resolve;\n      this.initReject = reject;\n    });\n\n    // Load cached flags first\n    this.loadCachedFlags();\n\n    // Start initialization\n    void this.initialize();\n  }\n\n  /**\n   * Wait for the client to be initialized\n   */\n  async waitForInit(): Promise<void> {\n    return this.initPromise;\n  }\n\n  /**\n   * Get a single flag value\n   */\n  getFlag<T extends FlagValue = FlagValue>(key: string): T | undefined {\n    const flag = this.flags[key];\n\n    if (flag) {\n      return (flag.enabled ? flag.value : this.config.defaultFlags[key]) as T;\n    }\n\n    return this.config.defaultFlags[key] as T;\n  }\n\n  /**\n   * Get all flags\n   */\n  getFlags(): FlagMap {\n    return { ...this.flags };\n  }\n\n  /**\n   * Check if a boolean flag is enabled\n   */\n  isEnabled(key: string): boolean {\n    const flag = this.flags[key];\n\n    if (!flag) {\n      return Boolean(this.config.defaultFlags[key]);\n    }\n\n    if (!flag.enabled) {\n      return Boolean(this.config.defaultFlags[key]);\n    }\n\n    return flag.type === 'boolean' ? Boolean(flag.value) : true;\n  }\n\n  /**\n   * Get current client status\n   */\n  getStatus(): ClientStatus {\n    return this.status;\n  }\n\n  /**\n   * Get the last error if any\n   */\n  getError(): Error | null {\n    return this.error;\n  }\n\n  /**\n   * Subscribe to flag changes (for React useSyncExternalStore)\n   */\n  subscribe(listener: FlagChangeListener): () => void {\n    this.listeners.add(listener);\n\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  /**\n   * Cleanup and disconnect\n   */\n  close(): void {\n    if (this.realtimeUnsubscribe) {\n      this.realtimeUnsubscribe();\n      this.realtimeUnsubscribe = null;\n    }\n\n    if (this.database) {\n      const flagsRef = ref(\n        this.database,\n        `flags/${this.parsedToken.projectId}/${this.parsedToken.environmentKey}`,\n      );\n      off(flagsRef);\n    }\n\n    this.listeners.clear();\n    this.log('Client closed');\n  }\n\n  // ==================== Private Methods ====================\n\n  private parseToken(token: string): ParsedToken | null {\n    const parts = token.split('_');\n\n    // Format: rly_{projectId}_{environmentKey}_{randomString}\n    if (parts.length < 4 || parts[0] !== 'rly') {\n      return null;\n    }\n\n    return {\n      projectId: parts[1],\n      environmentKey: parts[2],\n    };\n  }\n\n  private async initialize(): Promise<void> {\n    try {\n      // Fetch initial flags from API\n      await this.fetchFlags();\n\n      // Set up real-time updates if enabled\n      if (this.config.realtimeEnabled) {\n        await this.setupRealtime();\n      }\n\n      this.status = 'ready';\n      this.initResolve();\n      this.log('Client initialized');\n    } catch (err) {\n      this.status = 'error';\n      this.error = err instanceof Error ? err : new Error(String(err));\n      this.initReject(this.error);\n      this.log('Initialization failed:', this.error.message);\n    }\n  }\n\n  private async fetchFlags(): Promise<void> {\n    const url = `${this.config.baseUrl}/api/sdk/flags`;\n\n    const response = await fetch(url, {\n      headers: {\n        Authorization: `Bearer ${this.config.token}`,\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error(`Failed to fetch flags: ${response.status}`);\n    }\n\n    const data = (await response.json()) as { flags: FlagMap };\n    this.flags = data.flags;\n    this.cacheFlags();\n    this.notifyListeners();\n    this.log('Flags fetched:', Object.keys(this.flags).length);\n  }\n\n  private async setupRealtime(): Promise<void> {\n    // Initialize Firebase with minimal config for Realtime DB\n    // The database URL is derived from the API response or configured\n    const databaseURL = await this.getDatabaseUrl();\n\n    if (!databaseURL) {\n      this.log('Realtime DB URL not available, skipping real-time updates');\n\n      return;\n    }\n\n    this.firebaseApp = initializeApp(\n      {\n        databaseURL,\n      },\n      `rolloutly-${Date.now()}`,\n    );\n\n    this.database = getDatabase(this.firebaseApp);\n\n    const flagsRef = ref(\n      this.database,\n      `flags/${this.parsedToken.projectId}/${this.parsedToken.environmentKey}`,\n    );\n\n    this.realtimeUnsubscribe = onValue(\n      flagsRef,\n      (snapshot) => {\n        const data = snapshot.val() as Record<string, Flag> | null;\n\n        if (data) {\n          // Convert realtime format to our flag format\n          this.flags = Object.entries(data).reduce<FlagMap>(\n            (acc, [key, flag]) => {\n              acc[key] = { ...flag, key };\n\n              return acc;\n            },\n            {},\n          );\n          this.cacheFlags();\n          this.notifyListeners();\n          this.log('Realtime update received');\n        }\n      },\n      (error) => {\n        this.log('Realtime error:', error.message);\n      },\n    );\n  }\n\n  private async getDatabaseUrl(): Promise<string | null> {\n    // Try to get the database URL from the API\n    try {\n      const url = `${this.config.baseUrl}/api/sdk/config`;\n      const response = await fetch(url, {\n        headers: {\n          Authorization: `Bearer ${this.config.token}`,\n        },\n      });\n\n      if (response.ok) {\n        const data = (await response.json()) as { databaseUrl?: string };\n\n        return data.databaseUrl ?? null;\n      }\n    } catch {\n      // Ignore - we'll try without realtime\n    }\n\n    return null;\n  }\n\n  private loadCachedFlags(): void {\n    if (typeof window === 'undefined') return;\n\n    try {\n      const cached = localStorage.getItem(CACHE_KEY);\n\n      if (cached) {\n        this.flags = JSON.parse(cached) as FlagMap;\n        this.log('Loaded cached flags');\n      }\n    } catch {\n      // Ignore cache errors\n    }\n  }\n\n  private cacheFlags(): void {\n    if (typeof window === 'undefined') return;\n\n    try {\n      localStorage.setItem(CACHE_KEY, JSON.stringify(this.flags));\n    } catch {\n      // Ignore cache errors\n    }\n  }\n\n  private notifyListeners(): void {\n    this.listeners.forEach((listener) => listener());\n  }\n\n  private log(...args: unknown[]): void {\n    if (this.config.debug) {\n      console.log('[Rolloutly]', ...args);\n    }\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,99 @@
+/**
+ * Possible flag value types
+ */
+type FlagValue = boolean | string | number | Record<string, unknown>;
+/**
+ * Flag data structure from the API/Realtime DB
+ */
+type Flag = {
+    key: string;
+    enabled: boolean;
+    value: FlagValue;
+    type: 'boolean' | 'string' | 'number' | 'json';
+};
+/**
+ * Map of flag keys to their data
+ */
+type FlagMap = Record<string, Flag>;
+/**
+ * Configuration options for RolloutlyClient
+ */
+type RolloutlyConfig = {
+    /** SDK token (format: rly_projectId_environmentKey_xxx) */
+    token: string;
+    /** Base URL for the API (default: https://rolloutly.com) */
+    baseUrl?: string;
+    /** Enable real-time updates via Firebase (default: true) */
+    realtimeEnabled?: boolean;
+    /** Default flag values to use before flags are loaded */
+    defaultFlags?: Record<string, FlagValue>;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+};
+/**
+ * Client status
+ */
+type ClientStatus = 'initializing' | 'ready' | 'error';
+/**
+ * Listener callback for flag changes
+ */
+type FlagChangeListener = () => void;
+
+declare class RolloutlyClient {
+    private config;
+    private flags;
+    private status;
+    private error;
+    private listeners;
+    private parsedToken;
+    private firebaseApp;
+    private database;
+    private realtimeUnsubscribe;
+    private initPromise;
+    private initResolve;
+    private initReject;
+    constructor(config: RolloutlyConfig);
+    /**
+     * Wait for the client to be initialized
+     */
+    waitForInit(): Promise<void>;
+    /**
+     * Get a single flag value
+     */
+    getFlag<T extends FlagValue = FlagValue>(key: string): T | undefined;
+    /**
+     * Get all flags
+     */
+    getFlags(): FlagMap;
+    /**
+     * Check if a boolean flag is enabled
+     */
+    isEnabled(key: string): boolean;
+    /**
+     * Get current client status
+     */
+    getStatus(): ClientStatus;
+    /**
+     * Get the last error if any
+     */
+    getError(): Error | null;
+    /**
+     * Subscribe to flag changes (for React useSyncExternalStore)
+     */
+    subscribe(listener: FlagChangeListener): () => void;
+    /**
+     * Cleanup and disconnect
+     */
+    close(): void;
+    private parseToken;
+    private initialize;
+    private fetchFlags;
+    private setupRealtime;
+    private getDatabaseUrl;
+    private loadCachedFlags;
+    private cacheFlags;
+    private notifyListeners;
+    private log;
+}
+
+export { type ClientStatus, type Flag, type FlagChangeListener, type FlagMap, type FlagValue, RolloutlyClient, type RolloutlyConfig };

package/dist/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Possible flag value types
+ */
+type FlagValue = boolean | string | number | Record<string, unknown>;
+/**
+ * Flag data structure from the API/Realtime DB
+ */
+type Flag = {
+    key: string;
+    enabled: boolean;
+    value: FlagValue;
+    type: 'boolean' | 'string' | 'number' | 'json';
+};
+/**
+ * Map of flag keys to their data
+ */
+type FlagMap = Record<string, Flag>;
+/**
+ * Configuration options for RolloutlyClient
+ */
+type RolloutlyConfig = {
+    /** SDK token (format: rly_projectId_environmentKey_xxx) */
+    token: string;
+    /** Base URL for the API (default: https://rolloutly.com) */
+    baseUrl?: string;
+    /** Enable real-time updates via Firebase (default: true) */
+    realtimeEnabled?: boolean;
+    /** Default flag values to use before flags are loaded */
+    defaultFlags?: Record<string, FlagValue>;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+};
+/**
+ * Client status
+ */
+type ClientStatus = 'initializing' | 'ready' | 'error';
+/**
+ * Listener callback for flag changes
+ */
+type FlagChangeListener = () => void;
+
+declare class RolloutlyClient {
+    private config;
+    private flags;
+    private status;
+    private error;
+    private listeners;
+    private parsedToken;
+    private firebaseApp;
+    private database;
+    private realtimeUnsubscribe;
+    private initPromise;
+    private initResolve;
+    private initReject;
+    constructor(config: RolloutlyConfig);
+    /**
+     * Wait for the client to be initialized
+     */
+    waitForInit(): Promise<void>;
+    /**
+     * Get a single flag value
+     */
+    getFlag<T extends FlagValue = FlagValue>(key: string): T | undefined;
+    /**
+     * Get all flags
+     */
+    getFlags(): FlagMap;
+    /**
+     * Check if a boolean flag is enabled
+     */
+    isEnabled(key: string): boolean;
+    /**
+     * Get current client status
+     */
+    getStatus(): ClientStatus;
+    /**
+     * Get the last error if any
+     */
+    getError(): Error | null;
+    /**
+     * Subscribe to flag changes (for React useSyncExternalStore)
+     */
+    subscribe(listener: FlagChangeListener): () => void;
+    /**
+     * Cleanup and disconnect
+     */
+    close(): void;
+    private parseToken;
+    private initialize;
+    private fetchFlags;
+    private setupRealtime;
+    private getDatabaseUrl;
+    private loadCachedFlags;
+    private cacheFlags;
+    private notifyListeners;
+    private log;
+}
+
+export { type ClientStatus, type Flag, type FlagChangeListener, type FlagMap, type FlagValue, RolloutlyClient, type RolloutlyConfig };

package/dist/index.js

@@ -0,0 +1,237 @@
+import { initializeApp } from 'firebase/app';
+import { ref, off, getDatabase, onValue } from 'firebase/database';
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://rolloutly.com";
+var CACHE_KEY = "rolloutly_flags";
+var RolloutlyClient = class {
+  constructor(config) {
+    this.flags = {};
+    this.status = "initializing";
+    this.error = null;
+    this.listeners = /* @__PURE__ */ new Set();
+    this.firebaseApp = null;
+    this.database = null;
+    this.realtimeUnsubscribe = null;
+    this.config = {
+      token: config.token,
+      baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
+      realtimeEnabled: config.realtimeEnabled ?? true,
+      defaultFlags: config.defaultFlags ?? {},
+      debug: config.debug ?? false
+    };
+    const parsed = this.parseToken(config.token);
+    if (!parsed) {
+      throw new Error("Invalid SDK token format");
+    }
+    this.parsedToken = parsed;
+    this.initPromise = new Promise((resolve, reject) => {
+      this.initResolve = resolve;
+      this.initReject = reject;
+    });
+    this.loadCachedFlags();
+    void this.initialize();
+  }
+  /**
+   * Wait for the client to be initialized
+   */
+  async waitForInit() {
+    return this.initPromise;
+  }
+  /**
+   * Get a single flag value
+   */
+  getFlag(key) {
+    const flag = this.flags[key];
+    if (flag) {
+      return flag.enabled ? flag.value : this.config.defaultFlags[key];
+    }
+    return this.config.defaultFlags[key];
+  }
+  /**
+   * Get all flags
+   */
+  getFlags() {
+    return { ...this.flags };
+  }
+  /**
+   * Check if a boolean flag is enabled
+   */
+  isEnabled(key) {
+    const flag = this.flags[key];
+    if (!flag) {
+      return Boolean(this.config.defaultFlags[key]);
+    }
+    if (!flag.enabled) {
+      return Boolean(this.config.defaultFlags[key]);
+    }
+    return flag.type === "boolean" ? Boolean(flag.value) : true;
+  }
+  /**
+   * Get current client status
+   */
+  getStatus() {
+    return this.status;
+  }
+  /**
+   * Get the last error if any
+   */
+  getError() {
+    return this.error;
+  }
+  /**
+   * Subscribe to flag changes (for React useSyncExternalStore)
+   */
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  /**
+   * Cleanup and disconnect
+   */
+  close() {
+    if (this.realtimeUnsubscribe) {
+      this.realtimeUnsubscribe();
+      this.realtimeUnsubscribe = null;
+    }
+    if (this.database) {
+      const flagsRef = ref(
+        this.database,
+        `flags/${this.parsedToken.projectId}/${this.parsedToken.environmentKey}`
+      );
+      off(flagsRef);
+    }
+    this.listeners.clear();
+    this.log("Client closed");
+  }
+  // ==================== Private Methods ====================
+  parseToken(token) {
+    const parts = token.split("_");
+    if (parts.length < 4 || parts[0] !== "rly") {
+      return null;
+    }
+    return {
+      projectId: parts[1],
+      environmentKey: parts[2]
+    };
+  }
+  async initialize() {
+    try {
+      await this.fetchFlags();
+      if (this.config.realtimeEnabled) {
+        await this.setupRealtime();
+      }
+      this.status = "ready";
+      this.initResolve();
+      this.log("Client initialized");
+    } catch (err) {
+      this.status = "error";
+      this.error = err instanceof Error ? err : new Error(String(err));
+      this.initReject(this.error);
+      this.log("Initialization failed:", this.error.message);
+    }
+  }
+  async fetchFlags() {
+    const url = `${this.config.baseUrl}/api/sdk/flags`;
+    const response = await fetch(url, {
+      headers: {
+        Authorization: `Bearer ${this.config.token}`
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to fetch flags: ${response.status}`);
+    }
+    const data = await response.json();
+    this.flags = data.flags;
+    this.cacheFlags();
+    this.notifyListeners();
+    this.log("Flags fetched:", Object.keys(this.flags).length);
+  }
+  async setupRealtime() {
+    const databaseURL = await this.getDatabaseUrl();
+    if (!databaseURL) {
+      this.log("Realtime DB URL not available, skipping real-time updates");
+      return;
+    }
+    this.firebaseApp = initializeApp(
+      {
+        databaseURL
+      },
+      `rolloutly-${Date.now()}`
+    );
+    this.database = getDatabase(this.firebaseApp);
+    const flagsRef = ref(
+      this.database,
+      `flags/${this.parsedToken.projectId}/${this.parsedToken.environmentKey}`
+    );
+    this.realtimeUnsubscribe = onValue(
+      flagsRef,
+      (snapshot) => {
+        const data = snapshot.val();
+        if (data) {
+          this.flags = Object.entries(data).reduce(
+            (acc, [key, flag]) => {
+              acc[key] = { ...flag, key };
+              return acc;
+            },
+            {}
+          );
+          this.cacheFlags();
+          this.notifyListeners();
+          this.log("Realtime update received");
+        }
+      },
+      (error) => {
+        this.log("Realtime error:", error.message);
+      }
+    );
+  }
+  async getDatabaseUrl() {
+    try {
+      const url = `${this.config.baseUrl}/api/sdk/config`;
+      const response = await fetch(url, {
+        headers: {
+          Authorization: `Bearer ${this.config.token}`
+        }
+      });
+      if (response.ok) {
+        const data = await response.json();
+        return data.databaseUrl ?? null;
+      }
+    } catch {
+    }
+    return null;
+  }
+  loadCachedFlags() {
+    if (typeof window === "undefined") return;
+    try {
+      const cached = localStorage.getItem(CACHE_KEY);
+      if (cached) {
+        this.flags = JSON.parse(cached);
+        this.log("Loaded cached flags");
+      }
+    } catch {
+    }
+  }
+  cacheFlags() {
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.setItem(CACHE_KEY, JSON.stringify(this.flags));
+    } catch {
+    }
+  }
+  notifyListeners() {
+    this.listeners.forEach((listener) => listener());
+  }
+  log(...args) {
+    if (this.config.debug) {
+      console.log("[Rolloutly]", ...args);
+    }
+  }
+};
+
+export { RolloutlyClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { initializeApp, type FirebaseApp } from 'firebase/app';\nimport {\n  getDatabase,\n  ref,\n  onValue,\n  off,\n  type Database,\n  type Unsubscribe,\n} from 'firebase/database';\n\nimport type {\n  ClientStatus,\n  Flag,\n  FlagChangeListener,\n  FlagMap,\n  FlagValue,\n  ParsedToken,\n  RolloutlyConfig,\n} from './types';\n\nconst DEFAULT_BASE_URL = 'https://rolloutly.com';\nconst CACHE_KEY = 'rolloutly_flags';\n\nexport class RolloutlyClient {\n  private config: Required<\n    Omit<RolloutlyConfig, 'defaultFlags'> & {\n      defaultFlags: Record<string, FlagValue>;\n    }\n  >;\n  private flags: FlagMap = {};\n  private status: ClientStatus = 'initializing';\n  private error: Error | null = null;\n  private listeners: Set<FlagChangeListener> = new Set();\n  private parsedToken: ParsedToken;\n  private firebaseApp: FirebaseApp | null = null;\n  private database: Database | null = null;\n  private realtimeUnsubscribe: Unsubscribe | null = null;\n  private initPromise: Promise<void>;\n  private initResolve!: () => void;\n  private initReject!: (error: Error) => void;\n\n  constructor(config: RolloutlyConfig) {\n    this.config = {\n      token: config.token,\n      baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,\n      realtimeEnabled: config.realtimeEnabled ?? true,\n      defaultFlags: config.defaultFlags ?? {},\n      debug: config.debug ?? false,\n    };\n\n    // Parse the token\n    const parsed = this.parseToken(config.token);\n\n    if (!parsed) {\n      throw new Error('Invalid SDK token format');\n    }\n\n    this.parsedToken = parsed;\n\n    // Create init promise\n    this.initPromise = new Promise((resolve, reject) => {\n      this.initResolve = resolve;\n      this.initReject = reject;\n    });\n\n    // Load cached flags first\n    this.loadCachedFlags();\n\n    // Start initialization\n    void this.initialize();\n  }\n\n  /**\n   * Wait for the client to be initialized\n   */\n  async waitForInit(): Promise<void> {\n    return this.initPromise;\n  }\n\n  /**\n   * Get a single flag value\n   */\n  getFlag<T extends FlagValue = FlagValue>(key: string): T | undefined {\n    const flag = this.flags[key];\n\n    if (flag) {\n      return (flag.enabled ? flag.value : this.config.defaultFlags[key]) as T;\n    }\n\n    return this.config.defaultFlags[key] as T;\n  }\n\n  /**\n   * Get all flags\n   */\n  getFlags(): FlagMap {\n    return { ...this.flags };\n  }\n\n  /**\n   * Check if a boolean flag is enabled\n   */\n  isEnabled(key: string): boolean {\n    const flag = this.flags[key];\n\n    if (!flag) {\n      return Boolean(this.config.defaultFlags[key]);\n    }\n\n    if (!flag.enabled) {\n      return Boolean(this.config.defaultFlags[key]);\n    }\n\n    return flag.type === 'boolean' ? Boolean(flag.value) : true;\n  }\n\n  /**\n   * Get current client status\n   */\n  getStatus(): ClientStatus {\n    return this.status;\n  }\n\n  /**\n   * Get the last error if any\n   */\n  getError(): Error | null {\n    return this.error;\n  }\n\n  /**\n   * Subscribe to flag changes (for React useSyncExternalStore)\n   */\n  subscribe(listener: FlagChangeListener): () => void {\n    this.listeners.add(listener);\n\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  /**\n   * Cleanup and disconnect\n   */\n  close(): void {\n    if (this.realtimeUnsubscribe) {\n      this.realtimeUnsubscribe();\n      this.realtimeUnsubscribe = null;\n    }\n\n    if (this.database) {\n      const flagsRef = ref(\n        this.database,\n        `flags/${this.parsedToken.projectId}/${this.parsedToken.environmentKey}`,\n      );\n      off(flagsRef);\n    }\n\n    this.listeners.clear();\n    this.log('Client closed');\n  }\n\n  // ==================== Private Methods ====================\n\n  private parseToken(token: string): ParsedToken | null {\n    const parts = token.split('_');\n\n    // Format: rly_{projectId}_{environmentKey}_{randomString}\n    if (parts.length < 4 || parts[0] !== 'rly') {\n      return null;\n    }\n\n    return {\n      projectId: parts[1],\n      environmentKey: parts[2],\n    };\n  }\n\n  private async initialize(): Promise<void> {\n    try {\n      // Fetch initial flags from API\n      await this.fetchFlags();\n\n      // Set up real-time updates if enabled\n      if (this.config.realtimeEnabled) {\n        await this.setupRealtime();\n      }\n\n      this.status = 'ready';\n      this.initResolve();\n      this.log('Client initialized');\n    } catch (err) {\n      this.status = 'error';\n      this.error = err instanceof Error ? err : new Error(String(err));\n      this.initReject(this.error);\n      this.log('Initialization failed:', this.error.message);\n    }\n  }\n\n  private async fetchFlags(): Promise<void> {\n    const url = `${this.config.baseUrl}/api/sdk/flags`;\n\n    const response = await fetch(url, {\n      headers: {\n        Authorization: `Bearer ${this.config.token}`,\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error(`Failed to fetch flags: ${response.status}`);\n    }\n\n    const data = (await response.json()) as { flags: FlagMap };\n    this.flags = data.flags;\n    this.cacheFlags();\n    this.notifyListeners();\n    this.log('Flags fetched:', Object.keys(this.flags).length);\n  }\n\n  private async setupRealtime(): Promise<void> {\n    // Initialize Firebase with minimal config for Realtime DB\n    // The database URL is derived from the API response or configured\n    const databaseURL = await this.getDatabaseUrl();\n\n    if (!databaseURL) {\n      this.log('Realtime DB URL not available, skipping real-time updates');\n\n      return;\n    }\n\n    this.firebaseApp = initializeApp(\n      {\n        databaseURL,\n      },\n      `rolloutly-${Date.now()}`,\n    );\n\n    this.database = getDatabase(this.firebaseApp);\n\n    const flagsRef = ref(\n      this.database,\n      `flags/${this.parsedToken.projectId}/${this.parsedToken.environmentKey}`,\n    );\n\n    this.realtimeUnsubscribe = onValue(\n      flagsRef,\n      (snapshot) => {\n        const data = snapshot.val() as Record<string, Flag> | null;\n\n        if (data) {\n          // Convert realtime format to our flag format\n          this.flags = Object.entries(data).reduce<FlagMap>(\n            (acc, [key, flag]) => {\n              acc[key] = { ...flag, key };\n\n              return acc;\n            },\n            {},\n          );\n          this.cacheFlags();\n          this.notifyListeners();\n          this.log('Realtime update received');\n        }\n      },\n      (error) => {\n        this.log('Realtime error:', error.message);\n      },\n    );\n  }\n\n  private async getDatabaseUrl(): Promise<string | null> {\n    // Try to get the database URL from the API\n    try {\n      const url = `${this.config.baseUrl}/api/sdk/config`;\n      const response = await fetch(url, {\n        headers: {\n          Authorization: `Bearer ${this.config.token}`,\n        },\n      });\n\n      if (response.ok) {\n        const data = (await response.json()) as { databaseUrl?: string };\n\n        return data.databaseUrl ?? null;\n      }\n    } catch {\n      // Ignore - we'll try without realtime\n    }\n\n    return null;\n  }\n\n  private loadCachedFlags(): void {\n    if (typeof window === 'undefined') return;\n\n    try {\n      const cached = localStorage.getItem(CACHE_KEY);\n\n      if (cached) {\n        this.flags = JSON.parse(cached) as FlagMap;\n        this.log('Loaded cached flags');\n      }\n    } catch {\n      // Ignore cache errors\n    }\n  }\n\n  private cacheFlags(): void {\n    if (typeof window === 'undefined') return;\n\n    try {\n      localStorage.setItem(CACHE_KEY, JSON.stringify(this.flags));\n    } catch {\n      // Ignore cache errors\n    }\n  }\n\n  private notifyListeners(): void {\n    this.listeners.forEach((listener) => listener());\n  }\n\n  private log(...args: unknown[]): void {\n    if (this.config.debug) {\n      console.log('[Rolloutly]', ...args);\n    }\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@rolloutly/core",
+  "version": "0.1.0",
+  "description": "Rolloutly feature flags SDK - Core JavaScript client",
+  "author": "Kevin Beltrão",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KevBeltrao/rolloutly-sdk.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "feature-flags",
+    "feature-toggles",
+    "rolloutly",
+    "sdk"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "firebase": "^10.7.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  }
+}