@flipflag/sdk 1.3.0 → 1.5.0

package/README.md

@@ -1,37 +1,26 @@
 # FlipFlag SDK
 
-A lightweight client-side SDK for working with **FlipFlag** (https://flipflag.dev).
+A lightweight, feature-rich client-side SDK for **FlipFlag** (https://flipflag.dev) — a powerful feature flag management platform.
 
-The SDK is designed to be simple, declarative, and safe by default.  
-It supports read-only usage as well as full feature management when a private key is provided.
+The SDK is designed to be simple, declarative, and safe by default. It supports both browser and Node.js environments with automatic feature flag synchronization and usage tracking.
 
 ---
 
-## Features
-
-- Load feature flags (`enabled`) using a **public key**
-- Declare feature activation windows via `.flipflag.yml`
-- Automatically create features on the server (requires `privateKey`)
-- Periodically sync:
-  - feature flags
-  - feature timing declarations
-  - feature usage events
-- Local in-memory cache for flags, declarations, and usage
-- Full TypeScript support
-
----
-
-## Installation
+## 📦 Installation
 
 ```sh
 npm install @flipflag/sdk
 # or
 yarn add @flipflag/sdk
+# or
+pnpm add @flipflag/sdk
 ```
 
 ---
 
-## Quick Start
+## 🚀 Quick Start
+
+### Node.js (with YAML config)
 
 ```ts
 import { FlipFlag } from "@flipflag/sdk";
@@ -48,16 +37,234 @@ if (manager.isEnabled("newFeature")) {
 }
 ```
 
+### Browser (with inline config)
+
+```ts
+import { FlipFlag } from "@flipflag/sdk";
+
+const manager = new FlipFlag(
+  {
+    publicKey: "YOUR_PUBLIC_KEY",
+    privateKey: "YOUR_PRIVATE_KEY",
+  },
+  {
+    // Initial configuration
+    newFeature: {
+      contributor: "dev@example.com",
+      times: [
+        {
+          started: "2025-12-01T00:00:00.000Z",
+          finished: "2025-12-31T23:59:59.000Z",
+        },
+      ],
+    },
+  }
+);
+
+await manager.init();
+```
+
+---
+
+## 🎯 Features
+
+- ✅ **Dual environment support**: Node.js and Browser
+- ✅ **Read-only mode**: Use only `publicKey` to fetch flags
+- ✅ **Full management**: Use `privateKey` to declare features and track usage
+- ✅ **YAML configuration**: Declarative feature definitions (Node.js)
+- ✅ **Programmatic API**: Declare features via code (Browser)
+- ✅ **Auto-sync**: Periodic polling for flags and statistics
+- ✅ **Usage tracking**: Automatic feature usage analytics
+- ✅ **Time windows**: Define feature activation periods
+- ✅ **TypeScript**: Full type safety out of the box
+- ✅ **Lightweight**: Minimal dependencies
+
+---
+
+## 📚 Configuration Options
+
+### `IManagerOptions`
+
+```ts
+interface IManagerOptions {
+  /**
+   * FlipFlag API base URL.
+   * @default "https://api.flipflag.dev"
+   */
+  apiUrl?: string;
+
+  /**
+   * Public key for fetching feature flags (required).
+   * Get it from your FlipFlag project settings.
+   */
+  publicKey: string;
+
+  /**
+   * Private key for declaring features and syncing usage (optional).
+   * Without it, SDK works in read-only mode.
+   */
+  privateKey?: string;
+
+  /**
+   * Path to .flipflag.yml config file (Node.js only).
+   * @default "<process.cwd()>/.flipflag.yml"
+   */
+  configPath?: string;
+
+  /**
+   * If true, missing config file won't throw an error.
+   * @default true
+   */
+  ignoreMissingConfig?: boolean;
+
+  /**
+   * Polling interval for fetching feature flags (milliseconds).
+   * @default 30000 (30 seconds)
+   */
+  pollingInterval?: number;
+
+  /**
+   * Sync interval for sending declarations and usage stats (milliseconds).
+   * @default 90000 (90 seconds)
+   */
+  syncInterval?: number;
+}
+```
+
 ---
 
-## Configuration via `.flipflag.yml`
+## 📖 Usage Examples
+
+### Read-Only Mode (Public Key Only)
+
+Perfect for client-side applications where you only need to check feature states:
+
+```ts
+const manager = new FlipFlag({
+  publicKey: "pub_xxxxxxxxxxxxx",
+});
+
+await manager.init();
 
-By default, the SDK looks for a `.flipflag.yml` file in the project root  
-(`process.cwd()`), which is loaded during `init()`.
+// Check feature state
+if (manager.isEnabled("darkMode")) {
+  enableDarkMode();
+}
 
-### Example `.flipflag.yml`
+// Cleanup when done
+manager.destroy();
+```
 
-```yml
+### Full Mode (with Private Key)
+
+For applications that manage features and track usage:
+
+```ts
+const manager = new FlipFlag({
+  publicKey: "pub_xxxxxxxxxxxxx",
+  privateKey: "priv_xxxxxxxxxxxxx",
+});
+
+await manager.init();
+
+// Features will be automatically declared from .flipflag.yml
+// and usage will be tracked
+```
+
+### Custom Intervals
+
+```ts
+const manager = new FlipFlag({
+  publicKey: "pub_xxxxxxxxxxxxx",
+  pollingInterval: 10_000,  // Check flags every 10 seconds
+  syncInterval: 60_000,     // Sync usage every 60 seconds
+});
+```
+
+### Manual Sync
+
+Force immediate synchronization without waiting for intervals:
+
+```ts
+await manager.init();
+
+// ... some time later
+await manager.sync(); // Syncs declarations and usage immediately
+```
+
+### Browser Usage with Programmatic Configuration
+
+```ts
+import { FlipFlag } from "@flipflag/sdk";
+
+const manager = new FlipFlag(
+  {
+    publicKey: "pub_xxxxxxxxxxxxx",
+    privateKey: "priv_xxxxxxxxxxxxx",
+  },
+  {
+    newPaymentFlow: {
+      description: "New Stripe integration",
+      contributor: "payments-team@example.com",
+      type: "feature",
+      times: [
+        {
+          started: "2025-01-15T00:00:00.000Z",
+          finished: null, // No end date
+        },
+      ],
+    },
+    legacyCheckout: {
+      contributor: "payments-team@example.com",
+      times: [
+        {
+          started: "2024-01-01T00:00:00.000Z",
+          finished: "2025-03-01T00:00:00.000Z", // Will be disabled after this date
+        },
+      ],
+    },
+  }
+);
+
+await manager.init();
+```
+
+### Dynamic Feature Declaration
+
+```ts
+const manager = new FlipFlag({
+  publicKey: "pub_xxxxxxxxxxxxx",
+  privateKey: "priv_xxxxxxxxxxxxx",
+});
+
+await manager.init();
+
+// Add features programmatically
+manager.declareFromObject({
+  experimentalUI: {
+    contributor: "ui-team@example.com",
+    times: [
+      {
+        started: new Date().toISOString(),
+        finished: null,
+      },
+    ],
+  },
+});
+
+// Sync immediately
+await manager.sync();
+```
+
+---
+
+## 📝 YAML Configuration (Node.js)
+
+The SDK automatically loads `.flipflag.yml` from your project root during `init()`.
+
+### Basic Example
+
+```yaml
 newFeature:
   contributor: epolevov@emd.one
   times:
@@ -68,23 +275,113 @@ anotherFeature:
   contributor: dev@company.com
   times:
     - started: "2026-01-01T00:00:00.000Z"
+      finished: null
 ```
 
----
+### Advanced Example with Multiple Time Windows
+
+```yaml
+seasonalFeature:
+  description: "Holiday sale banner"
+  contributor: marketing@example.com
+  type: "feature"
+  times:
+    # Black Friday 2025
+    - started: "2025-11-24T00:00:00.000Z"
+      finished: "2025-11-30T23:59:59.000Z"
+    # Christmas 2025
+    - started: "2025-12-20T00:00:00.000Z"
+      finished: "2025-12-26T23:59:59.000Z"
+
+betaFeature:
+  description: "New analytics dashboard"
+  contributor: analytics-team@example.com
+  type: "experiment"
+  times:
+    - started: "2025-01-01T00:00:00.000Z"
+      finished: null # No end date - always active
+```
 
-## Checking Feature State
+### Custom Config Path
 
 ```ts
-manager.isEnabled("newFeature");
+const manager = new FlipFlag({
+  publicKey: "pub_xxxxxxxxxxxxx",
+  configPath: "./config/features.yml",
+});
 ```
 
 ---
 
-## Automatic Syncing
+## 🔌 API Reference
+
+### `FlipFlag` Class
+
+#### Constructor
+
+```ts
+// Node.js
+new FlipFlag(options: IManagerOptions)
+
+// Browser
+new FlipFlag(options: IManagerOptions, initialConfig?: FlipFlagYaml)
+```
+
+#### Methods
+
+##### `init(): Promise<void>`
+
+Initializes the SDK:
+- Loads YAML config (Node.js only)
+- Fetches current feature flags from server
+- Syncs declared features
+- Starts automatic polling and sync intervals
+
+```ts
+await manager.init();
+```
+
+##### `isEnabled(featureName: string): boolean`
+
+Checks if a feature is enabled. Also:
+- Tracks usage automatically
+- Creates feature on server if it doesn't exist (requires `privateKey`)
+
+```ts
+if (manager.isEnabled("darkMode")) {
+  // Feature is enabled
+}
+```
+
+##### `declareFromObject(config: FlipFlagYaml): void`
+
+Programmatically declares features without YAML file.
+
+```ts
+manager.declareFromObject({
+  myFeature: {
+    contributor: "dev@example.com",
+    times: [{ started: "2025-01-01T00:00:00.000Z", finished: null }],
+  },
+});
+```
+
+##### `sync(): Promise<void>`
+
+Manually triggers synchronization:
+- Syncs feature declarations
+- Sends usage statistics
+
+```ts
+await manager.sync();
+```
 
-After calling `init()`, the SDK starts a **10-second polling loop**.
+##### `destroy(): void`
 
-To stop syncing and clear all local state:
+Stops all timers and clears local state:
+- Stops polling interval
+- Stops sync interval
+- Clears cached flags and usage data
 
 ```ts
 manager.destroy();
@@ -92,20 +389,220 @@ manager.destroy();
 
 ---
 
-## Manager Options
+## 🎨 TypeScript Types
+
+### `FlipFlagYaml`
 
 ```ts
-export interface IManagerOptions {
-  apiUrl?: string;
-  publicKey: string;
-  privateKey?: string;
-  configPath?: string;
-  ignoreMissingConfig?: boolean;
+type FlipFlagYaml = Record<string, YamlFeature>;
+
+interface YamlFeature {
+  description?: string;
+  contributor?: string;
+  type?: string;
+  times?: YamlTime[];
+}
+
+interface YamlTime {
+  started: string; // ISO 8601 date string
+  finished: string | null; // ISO 8601 date string or null for no end
+}
+```
+
+### `IDeclareFeatureTime`
+
+```ts
+interface IDeclareFeatureTime {
+  email: string;
+  start: string; // ISO 8601 date string
+  end?: string; // ISO 8601 date string
+}
+```
+
+### `IFeatureFlag`
+
+```ts
+interface IFeatureFlag {
+  enabled: boolean;
 }
 ```
 
 ---
 
-## License
+## 💡 Best Practices
+
+### 1. Use Environment Variables
+
+```ts
+const manager = new FlipFlag({
+  publicKey: process.env.FLIPFLAG_PUBLIC_KEY!,
+  privateKey: process.env.FLIPFLAG_PRIVATE_KEY,
+});
+```
+
+### 2. Initialize Early
+
+```ts
+// app.ts
+const manager = new FlipFlag({ /* ... */ });
+await manager.init();
+
+// Now use throughout your app
+export { manager };
+```
+
+### 3. Cleanup on Shutdown
+
+```ts
+process.on("SIGTERM", () => {
+  manager.destroy();
+  process.exit(0);
+});
+```
+
+### 4. Use Read-Only Mode in Production Frontend
+
+For security, only use `publicKey` in client-side production code:
+
+```ts
+// ✅ Good - read-only
+const manager = new FlipFlag({
+  publicKey: import.meta.env.VITE_FLIPFLAG_PUBLIC_KEY,
+});
+
+// ❌ Bad - exposes private key
+const manager = new FlipFlag({
+  publicKey: import.meta.env.VITE_FLIPFLAG_PUBLIC_KEY,
+  privateKey: import.meta.env.VITE_FLIPFLAG_PRIVATE_KEY, // Don't do this!
+});
+```
+
+### 5. Handle Initialization Errors
+
+```ts
+try {
+  await manager.init();
+} catch (error) {
+  console.error("Failed to initialize FlipFlag:", error);
+  // Fallback to default behavior
+}
+```
+
+### 6. Use Feature Flags Defensively
+
+```ts
+// Default to false if something goes wrong
+const isEnabled = manager?.isEnabled("newFeature") ?? false;
+```
+
+---
+
+## 🔧 Troubleshooting
+
+### Config file not found
+
+```
+Error: FlipFlag: cannot read config at /path/to/.flipflag.yml: ENOENT
+```
+
+**Solution**: Set `ignoreMissingConfig: true` or create the config file:
+
+```ts
+const manager = new FlipFlag({
+  publicKey: "pub_xxxxxxxxxxxxx",
+  ignoreMissingConfig: true,
+});
+```
+
+### Invalid date format
+
+```
+Error: FlipFlag: invalid "started" date in myFeature: not-a-date
+```
+
+**Solution**: Use ISO 8601 format for dates:
+
+```yaml
+myFeature:
+  times:
+    - started: "2025-01-01T00:00:00.000Z"  # ✅ Correct
+    # - started: "2025-01-01"              # ❌ Wrong
+```
+
+### Public key missing
+
+```
+Error: Public key is missing. Please provide a valid publicKey in the SDK configuration.
+```
+
+**Solution**: Always provide a `publicKey`:
+
+```ts
+const manager = new FlipFlag({
+  publicKey: "pub_xxxxxxxxxxxxx", // Required!
+});
+```
+
+### Features not syncing
+
+If features declared in YAML aren't appearing on the server:
+
+1. Check that you provided `privateKey` (read-only mode can't create features)
+2. Check network connectivity to FlipFlag API
+3. Verify your API keys are correct
+4. Check browser/server console for errors
+
+---
+
+## 🌐 Platform Compatibility
+
+- **Node.js**: v16+ (ESM and CommonJS)
+- **Browsers**: Modern browsers with `fetch` API support
+- **TypeScript**: 4.5+
+
+---
+
+## 📦 Package Exports
+
+The package provides optimized builds for different environments:
+
+```json
+{
+  "exports": {
+    ".": {
+      "types": "./dist/browser.d.ts",
+      "browser": "./dist/browser.js",
+      "node": "./dist/node.js",
+      "default": "./dist/browser.js"
+    }
+  }
+}
+```
+
+Node.js automatically uses the Node-specific build with filesystem support, while browsers get the lightweight browser build.
+
+---
+
+## 🔗 Links
+
+- **Website**: https://flipflag.dev
+- **Documentation**: https://docs.flipflag.dev
+- **GitHub**: https://github.com/flipflag-dev/sdk
+- **NPM**: https://www.npmjs.com/package/@flipflag/sdk
+- **Issues**: https://github.com/flipflag-dev/sdk/issues
+
+---
+
+## 📄 License
+
+MIT License - see [LICENSE](./LICENSE) file for details.
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+---
 
-MIT License
+**Made with ❤️ by the FlipFlag team**

package/dist/browser.d.ts

@@ -1,4 +1,4 @@
-import { F as FlipFlagCore, I as IManagerOptions, a as FlipFlagYaml } from './flipflag-core-v7AUprKd.js';
+import { F as FlipFlagCore, I as IManagerOptions, a as FlipFlagYaml } from './flipflag-core-3rbGd7Gt.js';
 
 declare class FlipFlag extends FlipFlagCore {
     constructor(opts: IManagerOptions, initialConfig?: FlipFlagYaml);

package/dist/browser.js

@@ -1,4 +1,4 @@
-import { F as FlipFlagCore } from './flipflag-core-BNqlFhCW.js';
+import { F as FlipFlagCore } from './flipflag-core-DzEU3Qfu.js';
 
 class FlipFlag extends FlipFlagCore {
   constructor(opts, initialConfig) {

package/dist/browser.min.js

@@ -1,2 +1,2 @@
-import{F as s}from"./flipflag-core-DHCsP2TB.js";class o extends s{constructor(e,r){super(e),r&&this.declareFromObject(r)}}export{o as FlipFlag};
+import{F as s}from"./flipflag-core-D9bYmvZd.js";class o extends s{constructor(e,r){super(e),r&&this.declareFromObject(r)}}export{o as FlipFlag};
 //# sourceMappingURL=browser.min.js.map

package/dist/{flipflag-core-v7AUprKd.d.ts → flipflag-core-3rbGd7Gt.d.ts}

@@ -17,6 +17,11 @@ interface IManagerOptions {
      * Default: 30000 (30 seconds)
      */
     pollingInterval?: number;
+    /**
+     * Sync interval in milliseconds (for syncing times and usage).
+     * Default: 90000 (90 seconds)
+     */
+    syncInterval?: number;
 }
 type YamlTime = {
     started: string;
@@ -38,7 +43,8 @@ declare class FlipFlagCore {
     protected readonly opts: IManagerOptions;
     private readonly loader?;
     private inited;
-    private interval;
+    private pollingIntervalTimer;
+    private syncIntervalTimer;
     protected options: Partial<IManagerOptions>;
     private featuresTimes;
     private featuresFlags;
@@ -48,6 +54,7 @@ declare class FlipFlagCore {
     destroy(): void;
     isEnabled(featureName: string): boolean;
     declareFromObject(doc: FlipFlagYaml): void;
+    sync(): Promise<void>;
     private applyYamlConfig;
     private upsertFeaturesUsage;
     private getBaseUrl;

package/dist/flipflag-core-D9bYmvZd.js

@@ -0,0 +1,2 @@
+class l{constructor(e,t){this.opts=e,this.loader=t,this.inited=!1,this.pollingIntervalTimer=null,this.syncIntervalTimer=null,this.featuresTimes={},this.featuresFlags={},this.featuresUsage=[],this.options={apiUrl:"https://api.flipflag.dev",pollingInterval:3e4,syncInterval:9e4,...e}}async init(){if(this.loader){const e=await this.loader.load();e&&this.applyYamlConfig(e)}await this.getFeaturesFlags(),await this.syncFeaturesTimes(),this.pollingIntervalTimer=setInterval(()=>{this.getFeaturesFlags()},this.options.pollingInterval),this.syncIntervalTimer=setInterval(()=>{this.syncFeaturesTimes(),this.syncFeaturesUsage()},this.options.syncInterval),this.inited=!0}destroy(){this.inited=!1,this.pollingIntervalTimer&&clearInterval(this.pollingIntervalTimer),this.syncIntervalTimer&&clearInterval(this.syncIntervalTimer),this.featuresTimes={},this.featuresFlags={},this.featuresUsage=[]}isEnabled(e){const t=this.featuresFlags[e];return t?(this.upsertFeaturesUsage(e),t.enabled):(this.createFeature(e,{times:[]}),!1)}declareFromObject(e){this.applyYamlConfig(e)}async sync(){await this.syncFeaturesTimes(),await this.syncFeaturesUsage()}applyYamlConfig(e){var t;for(const[s,i]of Object.entries(e)){const r=((t=i?.times)!=null?t:[]).map(a=>{var n;return{email:e[s].contributor,start:a.started,end:(n=a.finished)!=null?n:null}});for(const a of r){if(Number.isNaN(Date.parse(a.start)))throw new Error(`FlipFlag: invalid "started" date in ${s}: ${a.start}`);if(a.end!==null&&Number.isNaN(Date.parse(String(a.end))))throw new Error(`FlipFlag: invalid "finished" date in ${s}: ${a.end}`)}this.featuresTimes[s]={times:r,type:i?.type,description:i?.description}}}upsertFeaturesUsage(e){const t=this.featuresUsage.find(s=>s.featureName===e);if(t){t.usedAt=new Date;return}this.featuresUsage.push({featureName:e,usedAt:new Date})}getBaseUrl(){if(this.options.apiUrl)return this.options.apiUrl.replace(/\/+$/,"");throw new Error("Base API URL is not configured. Please provide apiUrl in the SDK options.")}async createFeature(e,t){if(!this.options.privateKey)return null;const s=new URL("/v1/sdk/feature",this.getBaseUrl());fetch(s.toString(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({featureName:e,privateKey:this.options.privateKey,...t})}).catch(i=>console.error("Create Feature:",i))}async getFeaturesFlags(){if(!this.options.publicKey)throw new Error("Public key is missing. Please provide a valid publicKey in the SDK configuration.");try{const e=new URL("/v1/sdk/feature/flags",this.getBaseUrl());e.searchParams.append("publicKey",this.options.publicKey);const t=await fetch(e.toString(),{method:"GET",headers:{"Content-Type":"application/json"}});if(!t.ok&&!this.inited){const s=await t.text();throw new Error(`Failed to get features: ${t.status} - ${s}`)}this.featuresFlags=await t.json()}catch(e){console.error("Get list features flag:",e)}}async syncFeaturesTimes(){if(!this.options.privateKey)return null;for(const[e,t]of Object.entries(this.featuresTimes))this.createFeature(e,t)}async syncFeaturesUsage(){if(!this.options.publicKey)throw new Error("Public key is missing. Please provide a valid publicKey in the SDK configuration.");const e=new URL("/v1/sdk/feature/usages",this.getBaseUrl());fetch(e.toString(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({publicKey:this.options.publicKey,privateKey:this.options.privateKey,usages:this.featuresUsage})}).catch(t=>console.error("Feature Usage Sync:",t))}}export{l as F};
+//# sourceMappingURL=flipflag-core-D9bYmvZd.js.map

package/dist/flipflag-core-D9bYmvZd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flipflag-core-D9bYmvZd.js","sources":["../src/core/flipflag-core.ts"],"sourcesContent":["import {\n  FlipFlagYaml,\n  IDeclareFeatureOptions,\n  IDeclareFeatureTime,\n  IFeatureFlag,\n  IFeatureFlagUsage,\n  IManagerOptions,\n} from \"../types/provider\";\nimport { ConfigLoader } from \"../platform/config-loader\";\n\nexport class FlipFlagCore {\n  private inited = false;\n  private pollingIntervalTimer: any = null;\n  private syncIntervalTimer: any = null;\n\n  protected options: Partial<IManagerOptions>;\n  private featuresTimes: Record<string, IDeclareFeatureOptions> = {};\n  private featuresFlags: Record<string, IFeatureFlag> = {};\n  private featuresUsage: IFeatureFlagUsage[] = [];\n\n  constructor(\n    protected readonly opts: IManagerOptions,\n    private readonly loader?: ConfigLoader,\n  ) {\n    this.options = {\n      apiUrl: \"https://api.flipflag.dev\",\n      pollingInterval: 30_000,\n      syncInterval: 90_000,\n      ...opts,\n    };\n  }\n\n  public async init() {\n    if (this.loader) {\n      const yamlDoc = await this.loader.load();\n      if (yamlDoc) this.applyYamlConfig(yamlDoc);\n    }\n\n    await this.getFeaturesFlags();\n    await this.syncFeaturesTimes();\n\n    this.pollingIntervalTimer = setInterval(() => {\n      this.getFeaturesFlags();\n    }, this.options.pollingInterval);\n\n    this.syncIntervalTimer = setInterval(() => {\n      this.syncFeaturesTimes();\n      this.syncFeaturesUsage();\n    }, this.options.syncInterval);\n\n    this.inited = true;\n  }\n\n  public destroy() {\n    this.inited = false;\n    if (this.pollingIntervalTimer) clearInterval(this.pollingIntervalTimer);\n    if (this.syncIntervalTimer) clearInterval(this.syncIntervalTimer);\n    this.featuresTimes = {};\n    this.featuresFlags = {};\n    this.featuresUsage = [];\n  }\n\n  public isEnabled(featureName: string) {\n    const feature = this.featuresFlags[featureName];\n    if (!feature) {\n      this.createFeature(featureName, { times: [] });\n      return false;\n    }\n    this.upsertFeaturesUsage(featureName);\n    return feature.enabled;\n  }\n\n  public declareFromObject(doc: FlipFlagYaml) {\n    this.applyYamlConfig(doc);\n  }\n\n  public async sync() {\n    await this.syncFeaturesTimes();\n    await this.syncFeaturesUsage();\n  }\n\n  private applyYamlConfig(doc: FlipFlagYaml) {\n    for (const [featureName, cfg] of Object.entries(doc)) {\n      const times = (cfg?.times ?? []).map((t) => ({\n        email: doc[featureName].contributor,\n        start: t.started,\n        end: t.finished ?? null,\n      })) as IDeclareFeatureTime[];\n\n      for (const t of times) {\n        if (Number.isNaN(Date.parse(t.start))) {\n          throw new Error(\n            `FlipFlag: invalid \"started\" date in ${featureName}: ${t.start}`,\n          );\n        }\n        if (t.end !== null && Number.isNaN(Date.parse(String(t.end)))) {\n          throw new Error(\n            `FlipFlag: invalid \"finished\" date in ${featureName}: ${t.end}`,\n          );\n        }\n      }\n\n      this.featuresTimes[featureName] = {\n        times,\n        type: cfg?.type,\n        description: cfg?.description,\n      };\n    }\n  }\n\n  private upsertFeaturesUsage(featureName: string) {\n    const existing = this.featuresUsage.find(\n      (u) => u.featureName === featureName,\n    );\n    if (existing) {\n      existing.usedAt = new Date();\n      return;\n    }\n    this.featuresUsage.push({ featureName, usedAt: new Date() });\n  }\n\n  private getBaseUrl() {\n    if (this.options.apiUrl) return this.options.apiUrl.replace(/\\/+$/, \"\");\n    throw new Error(\n      \"Base API URL is not configured. Please provide apiUrl in the SDK options.\",\n    );\n  }\n\n  private async createFeature(\n    featureName: string,\n    options: IDeclareFeatureOptions,\n  ) {\n    if (!this.options.privateKey) return null;\n\n    const url = new URL(\"/v1/sdk/feature\", this.getBaseUrl());\n    fetch(url.toString(), {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        featureName,\n        privateKey: this.options.privateKey,\n        ...options,\n      }),\n    }).catch((e) => console.error(\"Create Feature:\", e));\n  }\n\n  private async getFeaturesFlags() {\n    if (!this.options.publicKey) {\n      throw new Error(\n        \"Public key is missing. Please provide a valid publicKey in the SDK configuration.\",\n      );\n    }\n\n    try {\n      const url = new URL(\"/v1/sdk/feature/flags\", this.getBaseUrl());\n      url.searchParams.append(\"publicKey\", this.options.publicKey);\n\n      const res = await fetch(url.toString(), {\n        method: \"GET\",\n        headers: { \"Content-Type\": \"application/json\" },\n      });\n      if (!res.ok && !this.inited) {\n        const errorText = await res.text();\n        throw new Error(`Failed to get features: ${res.status} - ${errorText}`);\n      }\n\n      this.featuresFlags = await res.json();\n    } catch (e) {\n      console.error(\"Get list features flag:\", e);\n    }\n  }\n\n  private async syncFeaturesTimes() {\n    if (!this.options.privateKey) return null;\n    for (const [featureName, options] of Object.entries(this.featuresTimes)) {\n      this.createFeature(featureName, options);\n    }\n  }\n\n  private async syncFeaturesUsage() {\n    if (!this.options.publicKey) {\n      throw new Error(\n        \"Public key is missing. Please provide a valid publicKey in the SDK configuration.\",\n      );\n    }\n    const url = new URL(\"/v1/sdk/feature/usages\", this.getBaseUrl());\n\n    fetch(url.toString(), {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        publicKey: this.options.publicKey,\n        privateKey: this.options.privateKey,\n        usages: this.featuresUsage,\n      }),\n    }).catch((e) => console.error(\"Feature Usage Sync:\", e));\n  }\n}\n"],"names":["FlipFlagCore","opts","loader","yamlDoc","featureName","feature","doc","_a","cfg","times","t","existing","u","options","url","e","res","errorText"],"mappings":"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"}

package/dist/{flipflag-core-BNqlFhCW.js → flipflag-core-DzEU3Qfu.js}

@@ -3,13 +3,15 @@ class FlipFlagCore {
     this.opts = opts;
     this.loader = loader;
     this.inited = false;
-    this.interval = null;
+    this.pollingIntervalTimer = null;
+    this.syncIntervalTimer = null;
     this.featuresTimes = {};
     this.featuresFlags = {};
     this.featuresUsage = [];
     this.options = {
       apiUrl: "https://api.flipflag.dev",
       pollingInterval: 3e4,
+      syncInterval: 9e4,
       ...opts
     };
   }
@@ -20,16 +22,19 @@ class FlipFlagCore {
     }
     await this.getFeaturesFlags();
     await this.syncFeaturesTimes();
-    this.interval = setInterval(() => {
+    this.pollingIntervalTimer = setInterval(() => {
       this.getFeaturesFlags();
+    }, this.options.pollingInterval);
+    this.syncIntervalTimer = setInterval(() => {
       this.syncFeaturesTimes();
       this.syncFeaturesUsage();
-    }, this.options.pollingInterval);
+    }, this.options.syncInterval);
     this.inited = true;
   }
   destroy() {
     this.inited = false;
-    if (this.interval) clearInterval(this.interval);
+    if (this.pollingIntervalTimer) clearInterval(this.pollingIntervalTimer);
+    if (this.syncIntervalTimer) clearInterval(this.syncIntervalTimer);
     this.featuresTimes = {};
     this.featuresFlags = {};
     this.featuresUsage = [];
@@ -46,6 +51,10 @@ class FlipFlagCore {
   declareFromObject(doc) {
     this.applyYamlConfig(doc);
   }
+  async sync() {
+    await this.syncFeaturesTimes();
+    await this.syncFeaturesUsage();
+  }
   applyYamlConfig(doc) {
     var _a;
     for (const [featureName, cfg] of Object.entries(doc)) {
@@ -69,7 +78,11 @@ class FlipFlagCore {
           );
         }
       }
-      this.featuresTimes[featureName] = { times };
+      this.featuresTimes[featureName] = {
+        times,
+        type: cfg == null ? void 0 : cfg.type,
+        description: cfg == null ? void 0 : cfg.description
+      };
     }
   }
   upsertFeaturesUsage(featureName) {
@@ -149,4 +162,4 @@ class FlipFlagCore {
 }
 
 export { FlipFlagCore as F };
-//# sourceMappingURL=flipflag-core-BNqlFhCW.js.map
+//# sourceMappingURL=flipflag-core-DzEU3Qfu.js.map

package/dist/flipflag-core-DzEU3Qfu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flipflag-core-DzEU3Qfu.js","sources":["../src/core/flipflag-core.ts"],"sourcesContent":["import {\n  FlipFlagYaml,\n  IDeclareFeatureOptions,\n  IDeclareFeatureTime,\n  IFeatureFlag,\n  IFeatureFlagUsage,\n  IManagerOptions,\n} from \"../types/provider\";\nimport { ConfigLoader } from \"../platform/config-loader\";\n\nexport class FlipFlagCore {\n  private inited = false;\n  private pollingIntervalTimer: any = null;\n  private syncIntervalTimer: any = null;\n\n  protected options: Partial<IManagerOptions>;\n  private featuresTimes: Record<string, IDeclareFeatureOptions> = {};\n  private featuresFlags: Record<string, IFeatureFlag> = {};\n  private featuresUsage: IFeatureFlagUsage[] = [];\n\n  constructor(\n    protected readonly opts: IManagerOptions,\n    private readonly loader?: ConfigLoader,\n  ) {\n    this.options = {\n      apiUrl: \"https://api.flipflag.dev\",\n      pollingInterval: 30_000,\n      syncInterval: 90_000,\n      ...opts,\n    };\n  }\n\n  public async init() {\n    if (this.loader) {\n      const yamlDoc = await this.loader.load();\n      if (yamlDoc) this.applyYamlConfig(yamlDoc);\n    }\n\n    await this.getFeaturesFlags();\n    await this.syncFeaturesTimes();\n\n    this.pollingIntervalTimer = setInterval(() => {\n      this.getFeaturesFlags();\n    }, this.options.pollingInterval);\n\n    this.syncIntervalTimer = setInterval(() => {\n      this.syncFeaturesTimes();\n      this.syncFeaturesUsage();\n    }, this.options.syncInterval);\n\n    this.inited = true;\n  }\n\n  public destroy() {\n    this.inited = false;\n    if (this.pollingIntervalTimer) clearInterval(this.pollingIntervalTimer);\n    if (this.syncIntervalTimer) clearInterval(this.syncIntervalTimer);\n    this.featuresTimes = {};\n    this.featuresFlags = {};\n    this.featuresUsage = [];\n  }\n\n  public isEnabled(featureName: string) {\n    const feature = this.featuresFlags[featureName];\n    if (!feature) {\n      this.createFeature(featureName, { times: [] });\n      return false;\n    }\n    this.upsertFeaturesUsage(featureName);\n    return feature.enabled;\n  }\n\n  public declareFromObject(doc: FlipFlagYaml) {\n    this.applyYamlConfig(doc);\n  }\n\n  public async sync() {\n    await this.syncFeaturesTimes();\n    await this.syncFeaturesUsage();\n  }\n\n  private applyYamlConfig(doc: FlipFlagYaml) {\n    for (const [featureName, cfg] of Object.entries(doc)) {\n      const times = (cfg?.times ?? []).map((t) => ({\n        email: doc[featureName].contributor,\n        start: t.started,\n        end: t.finished ?? null,\n      })) as IDeclareFeatureTime[];\n\n      for (const t of times) {\n        if (Number.isNaN(Date.parse(t.start))) {\n          throw new Error(\n            `FlipFlag: invalid \"started\" date in ${featureName}: ${t.start}`,\n          );\n        }\n        if (t.end !== null && Number.isNaN(Date.parse(String(t.end)))) {\n          throw new Error(\n            `FlipFlag: invalid \"finished\" date in ${featureName}: ${t.end}`,\n          );\n        }\n      }\n\n      this.featuresTimes[featureName] = {\n        times,\n        type: cfg?.type,\n        description: cfg?.description,\n      };\n    }\n  }\n\n  private upsertFeaturesUsage(featureName: string) {\n    const existing = this.featuresUsage.find(\n      (u) => u.featureName === featureName,\n    );\n    if (existing) {\n      existing.usedAt = new Date();\n      return;\n    }\n    this.featuresUsage.push({ featureName, usedAt: new Date() });\n  }\n\n  private getBaseUrl() {\n    if (this.options.apiUrl) return this.options.apiUrl.replace(/\\/+$/, \"\");\n    throw new Error(\n      \"Base API URL is not configured. Please provide apiUrl in the SDK options.\",\n    );\n  }\n\n  private async createFeature(\n    featureName: string,\n    options: IDeclareFeatureOptions,\n  ) {\n    if (!this.options.privateKey) return null;\n\n    const url = new URL(\"/v1/sdk/feature\", this.getBaseUrl());\n    fetch(url.toString(), {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        featureName,\n        privateKey: this.options.privateKey,\n        ...options,\n      }),\n    }).catch((e) => console.error(\"Create Feature:\", e));\n  }\n\n  private async getFeaturesFlags() {\n    if (!this.options.publicKey) {\n      throw new Error(\n        \"Public key is missing. Please provide a valid publicKey in the SDK configuration.\",\n      );\n    }\n\n    try {\n      const url = new URL(\"/v1/sdk/feature/flags\", this.getBaseUrl());\n      url.searchParams.append(\"publicKey\", this.options.publicKey);\n\n      const res = await fetch(url.toString(), {\n        method: \"GET\",\n        headers: { \"Content-Type\": \"application/json\" },\n      });\n      if (!res.ok && !this.inited) {\n        const errorText = await res.text();\n        throw new Error(`Failed to get features: ${res.status} - ${errorText}`);\n      }\n\n      this.featuresFlags = await res.json();\n    } catch (e) {\n      console.error(\"Get list features flag:\", e);\n    }\n  }\n\n  private async syncFeaturesTimes() {\n    if (!this.options.privateKey) return null;\n    for (const [featureName, options] of Object.entries(this.featuresTimes)) {\n      this.createFeature(featureName, options);\n    }\n  }\n\n  private async syncFeaturesUsage() {\n    if (!this.options.publicKey) {\n      throw new Error(\n        \"Public key is missing. Please provide a valid publicKey in the SDK configuration.\",\n      );\n    }\n    const url = new URL(\"/v1/sdk/feature/usages\", this.getBaseUrl());\n\n    fetch(url.toString(), {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        publicKey: this.options.publicKey,\n        privateKey: this.options.privateKey,\n        usages: this.featuresUsage,\n      }),\n    }).catch((e) => console.error(\"Feature Usage Sync:\", e));\n  }\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/node.d.ts

@@ -1,4 +1,4 @@
-import { F as FlipFlagCore, I as IManagerOptions } from './flipflag-core-v7AUprKd.js';
+import { F as FlipFlagCore, I as IManagerOptions } from './flipflag-core-3rbGd7Gt.js';
 
 declare class FlipFlag extends FlipFlagCore {
     constructor(opts: IManagerOptions);

package/dist/node.js

@@ -1,4 +1,4 @@
-import { F as FlipFlagCore } from './flipflag-core-BNqlFhCW.js';
+import { F as FlipFlagCore } from './flipflag-core-DzEU3Qfu.js';
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import * as yaml from 'js-yaml';

package/dist/node.min.js

@@ -1,2 +1,2 @@
-import{F as s}from"./flipflag-core-DHCsP2TB.js";import*as c from"node:fs/promises";import*as p from"node:path";import*as f from"js-yaml";class g{constructor(r){this.options=r}async load(){var r,t,e;const l=(r=this.options.configPath)!=null?r:p.resolve(process.cwd(),".flipflag.yml");let n;try{n=await c.readFile(l,"utf8")}catch(o){if(o?.code==="ENOENT"&&this.options.ignoreMissingConfig)return null;throw new Error(`FlipFlag: cannot read config at ${l}: ${(t=o?.message)!=null?t:o}`)}let a;try{a=f.load(n)}catch(o){throw new Error(`FlipFlag: invalid YAML in ${l}: ${(e=o?.message)!=null?e:o}`)}return!a||typeof a!="object"||Array.isArray(a)?(console.warn("FlipFlag: YAML root must be an object (mapping featureName -> config)"),null):a}}class u extends s{constructor(r){super(r,new g(r))}}export{u as FlipFlag};
+import{F as s}from"./flipflag-core-D9bYmvZd.js";import*as c from"node:fs/promises";import*as p from"node:path";import*as f from"js-yaml";class g{constructor(r){this.options=r}async load(){var r,t,e;const l=(r=this.options.configPath)!=null?r:p.resolve(process.cwd(),".flipflag.yml");let n;try{n=await c.readFile(l,"utf8")}catch(o){if(o?.code==="ENOENT"&&this.options.ignoreMissingConfig)return null;throw new Error(`FlipFlag: cannot read config at ${l}: ${(t=o?.message)!=null?t:o}`)}let a;try{a=f.load(n)}catch(o){throw new Error(`FlipFlag: invalid YAML in ${l}: ${(e=o?.message)!=null?e:o}`)}return!a||typeof a!="object"||Array.isArray(a)?(console.warn("FlipFlag: YAML root must be an object (mapping featureName -> config)"),null):a}}class u extends s{constructor(r){super(r,new g(r))}}export{u as FlipFlag};
 //# sourceMappingURL=node.min.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flipflag/sdk",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "type": "module",
   "description": "A lightweight client-side SDK for working with FlipFlag",
   "exports": {

package/dist/flipflag-core-BNqlFhCW.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flipflag-core-BNqlFhCW.js","sources":["../src/core/flipflag-core.ts"],"sourcesContent":["import {\n  FlipFlagYaml,\n  IDeclareFeatureOptions,\n  IDeclareFeatureTime,\n  IFeatureFlag,\n  IFeatureFlagUsage,\n  IManagerOptions,\n} from \"../types/provider\";\nimport { ConfigLoader } from \"../platform/config-loader\";\n\nexport class FlipFlagCore {\n  private inited = false;\n  private interval: any = null;\n\n  protected options: Partial<IManagerOptions>;\n  private featuresTimes: Record<string, IDeclareFeatureOptions> = {};\n  private featuresFlags: Record<string, IFeatureFlag> = {};\n  private featuresUsage: IFeatureFlagUsage[] = [];\n\n  constructor(\n    protected readonly opts: IManagerOptions,\n    private readonly loader?: ConfigLoader,\n  ) {\n    this.options = {\n      apiUrl: \"https://api.flipflag.dev\",\n      pollingInterval: 30_000,\n      ...opts,\n    };\n  }\n\n  public async init() {\n    if (this.loader) {\n      const yamlDoc = await this.loader.load();\n      if (yamlDoc) this.applyYamlConfig(yamlDoc);\n    }\n\n    await this.getFeaturesFlags();\n    await this.syncFeaturesTimes();\n\n    this.interval = setInterval(() => {\n      this.getFeaturesFlags();\n      this.syncFeaturesTimes();\n      this.syncFeaturesUsage();\n    }, this.options.pollingInterval);\n\n    this.inited = true;\n  }\n\n  public destroy() {\n    this.inited = false;\n    if (this.interval) clearInterval(this.interval);\n    this.featuresTimes = {};\n    this.featuresFlags = {};\n    this.featuresUsage = [];\n  }\n\n  public isEnabled(featureName: string) {\n    const feature = this.featuresFlags[featureName];\n    if (!feature) {\n      this.createFeature(featureName, { times: [] });\n      return false;\n    }\n    this.upsertFeaturesUsage(featureName);\n    return feature.enabled;\n  }\n\n  public declareFromObject(doc: FlipFlagYaml) {\n    this.applyYamlConfig(doc);\n  }\n\n  private applyYamlConfig(doc: FlipFlagYaml) {\n    for (const [featureName, cfg] of Object.entries(doc)) {\n      const times = (cfg?.times ?? []).map((t) => ({\n        email: doc[featureName].contributor,\n        start: t.started,\n        end: t.finished ?? null,\n      })) as IDeclareFeatureTime[];\n\n      for (const t of times) {\n        if (Number.isNaN(Date.parse(t.start))) {\n          throw new Error(\n            `FlipFlag: invalid \"started\" date in ${featureName}: ${t.start}`,\n          );\n        }\n        if (t.end !== null && Number.isNaN(Date.parse(String(t.end)))) {\n          throw new Error(\n            `FlipFlag: invalid \"finished\" date in ${featureName}: ${t.end}`,\n          );\n        }\n      }\n\n      this.featuresTimes[featureName] = { times };\n    }\n  }\n\n  private upsertFeaturesUsage(featureName: string) {\n    const existing = this.featuresUsage.find(\n      (u) => u.featureName === featureName,\n    );\n    if (existing) {\n      existing.usedAt = new Date();\n      return;\n    }\n    this.featuresUsage.push({ featureName, usedAt: new Date() });\n  }\n\n  private getBaseUrl() {\n    if (this.options.apiUrl) return this.options.apiUrl.replace(/\\/+$/, \"\");\n    throw new Error(\n      \"Base API URL is not configured. Please provide apiUrl in the SDK options.\",\n    );\n  }\n\n  private async createFeature(\n    featureName: string,\n    options: IDeclareFeatureOptions,\n  ) {\n    if (!this.options.privateKey) return null;\n\n    const url = new URL(\"/v1/sdk/feature\", this.getBaseUrl());\n    fetch(url.toString(), {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        featureName,\n        privateKey: this.options.privateKey,\n        ...options,\n      }),\n    }).catch((e) => console.error(\"Create Feature:\", e));\n  }\n\n  private async getFeaturesFlags() {\n    if (!this.options.publicKey) {\n      throw new Error(\n        \"Public key is missing. Please provide a valid publicKey in the SDK configuration.\",\n      );\n    }\n\n    try {\n      const url = new URL(\"/v1/sdk/feature/flags\", this.getBaseUrl());\n      url.searchParams.append(\"publicKey\", this.options.publicKey);\n\n      const res = await fetch(url.toString(), {\n        method: \"GET\",\n        headers: { \"Content-Type\": \"application/json\" },\n      });\n      if (!res.ok && !this.inited) {\n        const errorText = await res.text();\n        throw new Error(`Failed to get features: ${res.status} - ${errorText}`);\n      }\n\n      this.featuresFlags = await res.json();\n    } catch (e) {\n      console.error(\"Get list features flag:\", e);\n    }\n  }\n\n  private async syncFeaturesTimes() {\n    if (!this.options.privateKey) return null;\n    for (const [featureName, options] of Object.entries(this.featuresTimes)) {\n      this.createFeature(featureName, options);\n    }\n  }\n\n  private async syncFeaturesUsage() {\n    if (!this.options.publicKey) {\n      throw new Error(\n        \"Public key is missing. Please provide a valid publicKey in the SDK configuration.\",\n      );\n    }\n    const url = new URL(\"/v1/sdk/feature/usages\", this.getBaseUrl());\n\n    fetch(url.toString(), {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        publicKey: this.options.publicKey,\n        privateKey: this.options.privateKey,\n        usages: this.featuresUsage,\n      }),\n    }).catch((e) => console.error(\"Feature Usage Sync:\", e));\n  }\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/flipflag-core-DHCsP2TB.js

@@ -1,2 +0,0 @@
-class o{constructor(e,t){this.opts=e,this.loader=t,this.inited=!1,this.interval=null,this.featuresTimes={},this.featuresFlags={},this.featuresUsage=[],this.options={apiUrl:"https://api.flipflag.dev",pollingInterval:3e4,...e}}async init(){if(this.loader){const e=await this.loader.load();e&&this.applyYamlConfig(e)}await this.getFeaturesFlags(),await this.syncFeaturesTimes(),this.interval=setInterval(()=>{this.getFeaturesFlags(),this.syncFeaturesTimes(),this.syncFeaturesUsage()},this.options.pollingInterval),this.inited=!0}destroy(){this.inited=!1,this.interval&&clearInterval(this.interval),this.featuresTimes={},this.featuresFlags={},this.featuresUsage=[]}isEnabled(e){const t=this.featuresFlags[e];return t?(this.upsertFeaturesUsage(e),t.enabled):(this.createFeature(e,{times:[]}),!1)}declareFromObject(e){this.applyYamlConfig(e)}applyYamlConfig(e){var t;for(const[s,a]of Object.entries(e)){const r=((t=a?.times)!=null?t:[]).map(i=>{var n;return{email:e[s].contributor,start:i.started,end:(n=i.finished)!=null?n:null}});for(const i of r){if(Number.isNaN(Date.parse(i.start)))throw new Error(`FlipFlag: invalid "started" date in ${s}: ${i.start}`);if(i.end!==null&&Number.isNaN(Date.parse(String(i.end))))throw new Error(`FlipFlag: invalid "finished" date in ${s}: ${i.end}`)}this.featuresTimes[s]={times:r}}}upsertFeaturesUsage(e){const t=this.featuresUsage.find(s=>s.featureName===e);if(t){t.usedAt=new Date;return}this.featuresUsage.push({featureName:e,usedAt:new Date})}getBaseUrl(){if(this.options.apiUrl)return this.options.apiUrl.replace(/\/+$/,"");throw new Error("Base API URL is not configured. Please provide apiUrl in the SDK options.")}async createFeature(e,t){if(!this.options.privateKey)return null;const s=new URL("/v1/sdk/feature",this.getBaseUrl());fetch(s.toString(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({featureName:e,privateKey:this.options.privateKey,...t})}).catch(a=>console.error("Create Feature:",a))}async getFeaturesFlags(){if(!this.options.publicKey)throw new Error("Public key is missing. Please provide a valid publicKey in the SDK configuration.");try{const e=new URL("/v1/sdk/feature/flags",this.getBaseUrl());e.searchParams.append("publicKey",this.options.publicKey);const t=await fetch(e.toString(),{method:"GET",headers:{"Content-Type":"application/json"}});if(!t.ok&&!this.inited){const s=await t.text();throw new Error(`Failed to get features: ${t.status} - ${s}`)}this.featuresFlags=await t.json()}catch(e){console.error("Get list features flag:",e)}}async syncFeaturesTimes(){if(!this.options.privateKey)return null;for(const[e,t]of Object.entries(this.featuresTimes))this.createFeature(e,t)}async syncFeaturesUsage(){if(!this.options.publicKey)throw new Error("Public key is missing. Please provide a valid publicKey in the SDK configuration.");const e=new URL("/v1/sdk/feature/usages",this.getBaseUrl());fetch(e.toString(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({publicKey:this.options.publicKey,privateKey:this.options.privateKey,usages:this.featuresUsage})}).catch(t=>console.error("Feature Usage Sync:",t))}}export{o as F};
-//# sourceMappingURL=flipflag-core-DHCsP2TB.js.map

package/dist/flipflag-core-DHCsP2TB.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flipflag-core-DHCsP2TB.js","sources":["../src/core/flipflag-core.ts"],"sourcesContent":["import {\n  FlipFlagYaml,\n  IDeclareFeatureOptions,\n  IDeclareFeatureTime,\n  IFeatureFlag,\n  IFeatureFlagUsage,\n  IManagerOptions,\n} from \"../types/provider\";\nimport { ConfigLoader } from \"../platform/config-loader\";\n\nexport class FlipFlagCore {\n  private inited = false;\n  private interval: any = null;\n\n  protected options: Partial<IManagerOptions>;\n  private featuresTimes: Record<string, IDeclareFeatureOptions> = {};\n  private featuresFlags: Record<string, IFeatureFlag> = {};\n  private featuresUsage: IFeatureFlagUsage[] = [];\n\n  constructor(\n    protected readonly opts: IManagerOptions,\n    private readonly loader?: ConfigLoader,\n  ) {\n    this.options = {\n      apiUrl: \"https://api.flipflag.dev\",\n      pollingInterval: 30_000,\n      ...opts,\n    };\n  }\n\n  public async init() {\n    if (this.loader) {\n      const yamlDoc = await this.loader.load();\n      if (yamlDoc) this.applyYamlConfig(yamlDoc);\n    }\n\n    await this.getFeaturesFlags();\n    await this.syncFeaturesTimes();\n\n    this.interval = setInterval(() => {\n      this.getFeaturesFlags();\n      this.syncFeaturesTimes();\n      this.syncFeaturesUsage();\n    }, this.options.pollingInterval);\n\n    this.inited = true;\n  }\n\n  public destroy() {\n    this.inited = false;\n    if (this.interval) clearInterval(this.interval);\n    this.featuresTimes = {};\n    this.featuresFlags = {};\n    this.featuresUsage = [];\n  }\n\n  public isEnabled(featureName: string) {\n    const feature = this.featuresFlags[featureName];\n    if (!feature) {\n      this.createFeature(featureName, { times: [] });\n      return false;\n    }\n    this.upsertFeaturesUsage(featureName);\n    return feature.enabled;\n  }\n\n  public declareFromObject(doc: FlipFlagYaml) {\n    this.applyYamlConfig(doc);\n  }\n\n  private applyYamlConfig(doc: FlipFlagYaml) {\n    for (const [featureName, cfg] of Object.entries(doc)) {\n      const times = (cfg?.times ?? []).map((t) => ({\n        email: doc[featureName].contributor,\n        start: t.started,\n        end: t.finished ?? null,\n      })) as IDeclareFeatureTime[];\n\n      for (const t of times) {\n        if (Number.isNaN(Date.parse(t.start))) {\n          throw new Error(\n            `FlipFlag: invalid \"started\" date in ${featureName}: ${t.start}`,\n          );\n        }\n        if (t.end !== null && Number.isNaN(Date.parse(String(t.end)))) {\n          throw new Error(\n            `FlipFlag: invalid \"finished\" date in ${featureName}: ${t.end}`,\n          );\n        }\n      }\n\n      this.featuresTimes[featureName] = { times };\n    }\n  }\n\n  private upsertFeaturesUsage(featureName: string) {\n    const existing = this.featuresUsage.find(\n      (u) => u.featureName === featureName,\n    );\n    if (existing) {\n      existing.usedAt = new Date();\n      return;\n    }\n    this.featuresUsage.push({ featureName, usedAt: new Date() });\n  }\n\n  private getBaseUrl() {\n    if (this.options.apiUrl) return this.options.apiUrl.replace(/\\/+$/, \"\");\n    throw new Error(\n      \"Base API URL is not configured. Please provide apiUrl in the SDK options.\",\n    );\n  }\n\n  private async createFeature(\n    featureName: string,\n    options: IDeclareFeatureOptions,\n  ) {\n    if (!this.options.privateKey) return null;\n\n    const url = new URL(\"/v1/sdk/feature\", this.getBaseUrl());\n    fetch(url.toString(), {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        featureName,\n        privateKey: this.options.privateKey,\n        ...options,\n      }),\n    }).catch((e) => console.error(\"Create Feature:\", e));\n  }\n\n  private async getFeaturesFlags() {\n    if (!this.options.publicKey) {\n      throw new Error(\n        \"Public key is missing. Please provide a valid publicKey in the SDK configuration.\",\n      );\n    }\n\n    try {\n      const url = new URL(\"/v1/sdk/feature/flags\", this.getBaseUrl());\n      url.searchParams.append(\"publicKey\", this.options.publicKey);\n\n      const res = await fetch(url.toString(), {\n        method: \"GET\",\n        headers: { \"Content-Type\": \"application/json\" },\n      });\n      if (!res.ok && !this.inited) {\n        const errorText = await res.text();\n        throw new Error(`Failed to get features: ${res.status} - ${errorText}`);\n      }\n\n      this.featuresFlags = await res.json();\n    } catch (e) {\n      console.error(\"Get list features flag:\", e);\n    }\n  }\n\n  private async syncFeaturesTimes() {\n    if (!this.options.privateKey) return null;\n    for (const [featureName, options] of Object.entries(this.featuresTimes)) {\n      this.createFeature(featureName, options);\n    }\n  }\n\n  private async syncFeaturesUsage() {\n    if (!this.options.publicKey) {\n      throw new Error(\n        \"Public key is missing. Please provide a valid publicKey in the SDK configuration.\",\n      );\n    }\n    const url = new URL(\"/v1/sdk/feature/usages\", this.getBaseUrl());\n\n    fetch(url.toString(), {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        publicKey: this.options.publicKey,\n        privateKey: this.options.privateKey,\n        usages: this.featuresUsage,\n      }),\n    }).catch((e) => console.error(\"Feature Usage Sync:\", e));\n  }\n}\n"],"names":["FlipFlagCore","opts","loader","yamlDoc","featureName","feature","doc","_a","cfg","times","t","existing","u","options","url","e","res","errorText"],"mappings":"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"}