@flipflag/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 FlipFlag
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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,155 @@
+# FlipFlag SDK
+
+A lightweight client-side SDK for working with **FlipFlag**.  
+It allows you to:
+
+- Declare features programmatically  
+- Auto-create features on the server  
+- Check whether a feature is enabled  
+- Periodically sync feature states  
+- Manage feature definitions (options + metadata)
+
+The SDK includes full TypeScript types and a Jest test suite.
+
+---
+
+## Installation
+
+```sh
+npm install @flipflag/sdk
+# or
+yarn add @flipflag/sdk
+```
+
+---
+
+## Usage
+
+### Initialize the manager
+
+```ts
+import { FlipFlag } from '@flipflag/sdk';
+
+const manager = new FlipFlag({
+  publicKey: 'YOUR_PUBLIC_KEY',
+  privateKey: 'YOUR_PRIVATE_KEY', // optional for read-only mode
+});
+
+await manager.init();
+```
+
+### Declare a feature
+
+```ts
+manager.declareFeature('newFeature', {
+  times: [
+    {
+      start: new Date(),
+    },
+  ],
+});
+```
+
+If the feature does not exist on the server and you provided a `privateKey`,  
+the SDK will automatically create it.
+
+### Check if a feature is enabled
+
+```ts
+if (manager.isEnabled('newFeature')) {
+  console.log('Feature is enabled!');
+}
+```
+
+If the feature has not been declared yet, a placeholder is created automatically  
+and `false` is returned.
+
+---
+
+## Automatic Syncing
+
+After calling `init()`, the manager:
+
+- Loads all features using your `publicKey`
+- Starts a **10-second interval** that refreshes feature states
+- Keeps local cache in `declaredFeatures`
+
+To stop syncing:
+
+```ts
+manager.destroy();
+```
+
+This clears the interval and resets the cache.
+
+---
+
+## TypeScript Types
+
+```ts
+export interface IManagerOptions {
+  apiUrl?: string;
+  publicKey: string;
+  privateKey?: string;
+}
+
+export interface IDeclareFeatureTime {
+  start: Date;
+  end?: Date;
+}
+
+export interface IDeclareFeatureOptions {
+  times: IDeclareFeatureTime[];
+}
+
+export interface IFeatureFlag {
+  enabled: boolean;
+}
+```
+
+---
+
+## Running Tests
+
+This SDK comes with full Jest test coverage, including:
+
+- Mocked `fetch` requests
+- Interval polling behavior
+- Feature creation
+- Error handling
+- Local cache logic
+
+---
+
+## Example: Full Integration
+
+```ts
+import { FlipFlag } from '@flipflag/sdk';
+
+async function main() {
+  const manager = new FlipFlag({
+    publicKey: 'pk_live_123',
+    privateKey: 'sk_live_123',
+  });
+
+  await manager.init();
+
+  manager.declareFeature('demoFeature', {
+    times: [
+      { start: new Date() },
+    ],
+  });
+
+  if (manager.isEnabled('demoFeature')) {
+    console.log('Demo feature is active!');
+  }
+}
+
+main();
+```
+
+---
+
+## License
+
+MIT License.

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { FlipFlag } from './provider.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+import{FlipFlag as p}from"./provider.js";export{p as FlipFlag};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/index.min.js

@@ -0,0 +1 @@
+class r{constructor(e){this.opts=e,this.inited=!1,this.interval=null,this.featuresTimes={},this.featuresFlags={},this.featuresUsage=[],this.options={apiUrl:"https://api.flipflag.dev",...e},this.interval=null}async init(){await this.getFeaturesFlags(),this.interval=setInterval(()=>{this.getFeaturesFlags(),this.syncFeaturesTimes(),this.syncFeaturesUsage()},1e4),this.inited=!0}destroy(){this.inited=!1,this.interval&&clearInterval(this.interval),this.featuresTimes={},this.featuresFlags={},this.featuresUsage=[]}declareFeature(e,t){this.featuresTimes[e]=t}isEnabled(e){const t=this.getLocalFeatureFlag(e);return t?(this.upsertFeaturesUsage(e),t.enabled):(this.createFeature(e,{times:[]}),!1)}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})}async createFeature(e,t){if(!this.options.privateKey)return null;const s=this.getBaseUrl(),i=new URL("/v1/sdk/feature",s);fetch(i.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)})}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 getFeaturesFlags(){if(!this.options.publicKey)throw new Error("Public key is missing. Please provide a valid publicKey in the SDK configuration.");try{const e=this.getBaseUrl(),t=new URL("/v1/sdk/feature/flags",e);t.searchParams.append("publicKey",this.options.publicKey);const s=await fetch(t.toString(),{method:"GET",headers:{"Content-Type":"application/json"}});if(!s.ok&&!this.inited){const i=await s.text();throw new Error(`Failed to get features: ${s.status} - ${i}`)}this.featuresFlags=await s.json()}catch(e){console.error("Get list features flag:",e)}}async syncFeaturesTimes(){if(!this.options.privateKey)return null;Object.entries(this.featuresTimes).forEach(([t,s])=>{this.createFeature(t,s)})}async syncFeaturesUsage(){if(!this.options.publicKey)throw new Error("Public key is missing. Please provide a valid publicKey in the SDK configuration.");const e=this.getBaseUrl(),t=new URL("/v1/sdk/feature/usages",e);fetch(t.toString(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({publicKey:this.options.publicKey,usages:this.featuresUsage})}).catch(s=>{console.error("Feature Usage Sync:",s)})}getLocalFeatureFlag(e){return this.featuresFlags[e]}}export{r as FlipFlag};

package/dist/provider.d.ts

@@ -0,0 +1,116 @@
+import { IManagerOptions, IDeclareFeatureOptions } from './types/provider.js';
+
+/**
+ * Manager for interacting with FlipFlag.
+ * Handles feature declaration, loading remote states, and periodic syncing.
+ */
+declare class FlipFlag {
+    protected readonly opts: IManagerOptions;
+    /** Indicates whether initialization has completed */
+    private inited;
+    /** Interval handler for periodic feature refreshing */
+    private interval;
+    /** Options passed to the manager (merged with defaults) */
+    private options;
+    /**
+     * Local cache of declared features times.
+     * Keyed by feature name.
+     */
+    private featuresTimes;
+    /**
+     * Local cache of declared features flags and their metadata.
+     * Keyed by feature name.
+     */
+    private featuresFlags;
+    /**
+     * Local cache of feature-flag usage events.
+     * Each entry represents an interaction with a specific feature flag
+     * (read, update, check) along with related metadata.
+     */
+    private featuresUsage;
+    /**
+     * @param opts Manager configuration (publicKey, privateKey, apiUrl, etc.)
+     */
+    constructor(opts: IManagerOptions);
+    /**
+     * Initializes the manager:
+     * - Loads the initial feature flags from the server
+     * - Starts a 10-second polling loop to:
+     *    • refresh feature flags
+     *    • synchronize feature activation times
+     */
+    init(): Promise<void>;
+    /**
+     * Destroys the manager:
+     * - Stops the periodic sync
+     * - Clears all locally declared features
+     */
+    destroy(): void;
+    /**
+     * Declares a feature locally.
+     * If the feature has not been loaded or created yet, it triggers creation.
+     *
+     * @param featureName Name of the feature
+     * @param options Declaration settings (e.g., times)
+     */
+    declareFeature(featureName: string, options: IDeclareFeatureOptions): void;
+    /**
+     * Checks whether a feature is enabled.
+     * If the feature does not exist locally, it will be created with empty options.
+     *
+     * @param featureName Name of the feature
+     * @returns `true` if enabled, otherwise `false`
+     */
+    isEnabled(featureName: string): boolean;
+    /**
+     * Updates or inserts a feature usage record.
+     * If the feature was already used before, its timestamp is updated.
+     * Otherwise, a new usage entry is created.
+     *
+     * @param featureName - Name of the feature that was checked/used
+     */
+    private upsertFeaturesUsage;
+    /**
+     * Creates a new feature on the server.
+     * Requires a privateKey; otherwise the request is ignored.
+     *
+     * @param featureName Name of the feature
+     * @param options Feature declaration options
+     * @returns Created feature data or null if privateKey is missing
+     */
+    private createFeature;
+    private getBaseUrl;
+    /**
+     * Fetches all features associated with the publicKey.
+     * Populates the local `featuresTimes` cache.
+     *
+     * Throws an error only during initial initialization;
+     * later polling failures are ignored.
+     */
+    private getFeaturesFlags;
+    /**
+     * Fetches all features associated with the publicKey.
+     * Populates the local `featuresTimes` cache.
+     *
+     * Throws an error only during initial initialization;
+     * later polling failures are ignored.
+     */
+    private syncFeaturesTimes;
+    /**
+     * Sends the collected feature usage data to the server.
+     * Requires a valid `publicKey` provided in the SDK configuration.
+     *
+     * Throws an error if the `publicKey` is missing;
+     * network or server errors during sync are not awaited or propagated.
+     */
+    private syncFeaturesUsage;
+    /**
+     * Returns a locally cached feature flag by name.
+     *
+     * @param featureName Name of the feature
+     * @returns The feature or undefined if it does not exist
+     */
+    private getLocalFeatureFlag;
+}
+
+export { FlipFlag };

package/dist/provider.js

@@ -0,0 +1,2 @@
+class r{constructor(e){this.opts=e,this.inited=!1,this.interval=null,this.featuresTimes={},this.featuresFlags={},this.featuresUsage=[],this.options={apiUrl:"https://api.flipflag.dev",...e},this.interval=null}async init(){await this.getFeaturesFlags(),this.interval=setInterval(()=>{this.getFeaturesFlags(),this.syncFeaturesTimes(),this.syncFeaturesUsage()},1e4),this.inited=!0}destroy(){this.inited=!1,this.interval&&clearInterval(this.interval),this.featuresTimes={},this.featuresFlags={},this.featuresUsage=[]}declareFeature(e,t){this.featuresTimes[e]=t}isEnabled(e){const t=this.getLocalFeatureFlag(e);return t?(this.upsertFeaturesUsage(e),t.enabled):(this.createFeature(e,{times:[]}),!1)}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})}async createFeature(e,t){if(!this.options.privateKey)return null;const s=this.getBaseUrl(),i=new URL("/v1/sdk/feature",s);fetch(i.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)})}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 getFeaturesFlags(){if(!this.options.publicKey)throw new Error("Public key is missing. Please provide a valid publicKey in the SDK configuration.");try{const e=this.getBaseUrl(),t=new URL("/v1/sdk/feature/flags",e);t.searchParams.append("publicKey",this.options.publicKey);const s=await fetch(t.toString(),{method:"GET",headers:{"Content-Type":"application/json"}});if(!s.ok&&!this.inited){const i=await s.text();throw new Error(`Failed to get features: ${s.status} - ${i}`)}this.featuresFlags=await s.json()}catch(e){console.error("Get list features flag:",e)}}async syncFeaturesTimes(){if(!this.options.privateKey)return null;Object.entries(this.featuresTimes).forEach(([e,t])=>{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=this.getBaseUrl(),t=new URL("/v1/sdk/feature/usages",e);fetch(t.toString(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({publicKey:this.options.publicKey,usages:this.featuresUsage})}).catch(s=>{console.error("Feature Usage Sync:",s)})}getLocalFeatureFlag(e){return this.featuresFlags[e]}}export{r as FlipFlag};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sources":["../src/provider.ts"],"sourcesContent":["import {\n  IDeclareFeatureOptions,\n  IFeatureFlag,\n  IFeatureFlagUsage,\n  IManagerOptions,\n} from './types/provider';\n\n/**\n * Manager for interacting with FlipFlag.\n * Handles feature declaration, loading remote states, and periodic syncing.\n */\nexport class FlipFlag {\n  /** Indicates whether initialization has completed */\n  private inited = false;\n  /** Interval handler for periodic feature refreshing */\n  private interval: NodeJS.Timeout | null = null;\n  /** Options passed to the manager (merged with defaults) */\n  private options: Partial<IManagerOptions>;\n  /**\n   * Local cache of declared features times.\n   * Keyed by feature name.\n   */\n  private featuresTimes: Record<string, IDeclareFeatureOptions> = {};\n  /**\n   * Local cache of declared features flags and their metadata.\n   * Keyed by feature name.\n   */\n  private featuresFlags: Record<string, IFeatureFlag> = {};\n  /**\n   * Local cache of feature-flag usage events.\n   * Each entry represents an interaction with a specific feature flag\n   * (read, update, check) along with related metadata.\n   */\n  private featuresUsage: IFeatureFlagUsage[] = [];\n\n  /**\n   * @param opts Manager configuration (publicKey, privateKey, apiUrl, etc.)\n   */\n  constructor(protected readonly opts: IManagerOptions) {\n    this.options = { apiUrl: 'https://api.flipflag.dev', ...opts };\n    this.interval = null;\n  }\n\n  /**\n   * Initializes the manager:\n   * - Loads the initial feature flags from the server\n   * - Starts a 10-second polling loop to:\n   *    • refresh feature flags\n   *    • synchronize feature activation times\n   */\n  public async init() {\n    await this.getFeaturesFlags();\n\n    this.interval = setInterval(() => {\n      this.getFeaturesFlags();\n      this.syncFeaturesTimes();\n      this.syncFeaturesUsage();\n    }, 10_000);\n\n    this.inited = true;\n  }\n\n  /**\n   * Destroys the manager:\n   * - Stops the periodic sync\n   * - Clears all locally declared features\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  /**\n   * Declares a feature locally.\n   * If the feature has not been loaded or created yet, it triggers creation.\n   *\n   * @param featureName Name of the feature\n   * @param options Declaration settings (e.g., times)\n   */\n  declareFeature(featureName: string, options: IDeclareFeatureOptions) {\n    this.featuresTimes[featureName] = options;\n  }\n\n  /**\n   * Checks whether a feature is enabled.\n   * If the feature does not exist locally, it will be created with empty options.\n   *\n   * @param featureName Name of the feature\n   * @returns `true` if enabled, otherwise `false`\n   */\n  isEnabled(featureName: string) {\n    const feature = this.getLocalFeatureFlag(featureName);\n\n    if (!feature) {\n      this.createFeature(featureName, { times: [] });\n\n      return false;\n    }\n\n    this.upsertFeaturesUsage(featureName);\n\n    return feature.enabled;\n  }\n\n  /**\n   * Updates or inserts a feature usage record.\n   * If the feature was already used before, its timestamp is updated.\n   * Otherwise, a new usage entry is created.\n   *\n   * @param featureName - Name of the feature that was checked/used\n   */\n  private upsertFeaturesUsage(featureName: string) {\n    const existing = this.featuresUsage.find(\n      (u) => u.featureName === featureName\n    );\n\n    if (existing) {\n      existing.usedAt = new Date();\n      return;\n    }\n\n    this.featuresUsage.push({\n      featureName,\n      usedAt: new Date(),\n    });\n  }\n\n  /**\n   * Creates a new feature on the server.\n   * Requires a privateKey; otherwise the request is ignored.\n   *\n   * @param featureName Name of the feature\n   * @param options Feature declaration options\n   * @returns Created feature data or null if privateKey is missing\n   */\n  private async createFeature(\n    featureName: string,\n    options: IDeclareFeatureOptions\n  ) {\n    if (!this.options.privateKey) {\n      return null;\n    }\n\n    const baseUrl = this.getBaseUrl();\n    const url = new URL('/v1/sdk/feature', baseUrl);\n\n    fetch(url.toString(), {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        featureName,\n        privateKey: this.options.privateKey,\n        ...options,\n      }),\n    }).catch((error) => {\n      console.error('Create Feature:', error);\n    });\n  }\n\n  private getBaseUrl() {\n    if (this.options.apiUrl) {\n      return this.options.apiUrl.replace(/\\/+$/, '');\n    }\n\n    throw new Error(\n      'Base API URL is not configured. Please provide apiUrl in the SDK options.'\n    );\n  }\n\n  /**\n   * Fetches all features associated with the publicKey.\n   * Populates the local `featuresTimes` cache.\n   *\n   * Throws an error only during initial initialization;\n   * later polling failures are ignored.\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 baseUrl = this.getBaseUrl();\n      const url = new URL('/v1/sdk/feature/flags', baseUrl);\n      url.searchParams.append('publicKey', this.options.publicKey);\n\n      const response = await fetch(url.toString(), {\n        method: 'GET',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n      });\n\n      if (!response.ok && !this.inited) {\n        const errorText = await response.text();\n        throw new Error(\n          `Failed to get features: ${response.status} - ${errorText}`\n        );\n      }\n\n      this.featuresFlags = await response.json();\n    } catch (error) {\n      console.error('Get list features flag:', error);\n    }\n  }\n\n  /**\n   * Fetches all features associated with the publicKey.\n   * Populates the local `featuresTimes` cache.\n   *\n   * Throws an error only during initial initialization;\n   * later polling failures are ignored.\n   */\n  private async syncFeaturesTimes() {\n    if (!this.options.privateKey) {\n      return null;\n    }\n\n    const list = Object.entries(this.featuresTimes);\n    list.forEach(([featureName, options]: [string, IDeclareFeatureOptions]) => {\n      this.createFeature(featureName, options);\n    });\n  }\n\n  /**\n   * Sends the collected feature usage data to the server.\n   * Requires a valid `publicKey` provided in the SDK configuration.\n   *\n   * Throws an error if the `publicKey` is missing;\n   * network or server errors during sync are not awaited or propagated.\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\n    const baseUrl = this.getBaseUrl();\n    const url = new URL('/v1/sdk/feature/usages', baseUrl);\n\n    fetch(url.toString(), {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        publicKey: this.options.publicKey,\n        usages: this.featuresUsage,\n      }),\n    }).catch((error) => {\n      console.error('Feature Usage Sync:', error);\n    });\n  }\n\n  /**\n   * Returns a locally cached feature flag by name.\n   *\n   * @param featureName Name of the feature\n   * @returns The feature or undefined if it does not exist\n   */\n  private getLocalFeatureFlag(featureName: string) {\n    return this.featuresFlags[featureName];\n  }\n}\n"],"names":["FlipFlag","opts","featureName","options","feature","existing","u","baseUrl","url","error","response","errorText"],"mappings":"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"}

package/dist/types/provider.d.ts

@@ -0,0 +1,15 @@
+interface IManagerOptions {
+    apiUrl?: string;
+    publicKey: string;
+    privateKey?: string;
+}
+interface IDeclareFeatureTime {
+    email: string;
+    start: Date;
+    end?: Date;
+}
+interface IDeclareFeatureOptions {
+    times: IDeclareFeatureTime[];
+}
+
+export type { IDeclareFeatureOptions, IDeclareFeatureTime, IManagerOptions };

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@flipflag/sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "description": "A lightweight client-side SDK for working with FlipFlag",
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "FlipFlag",
+    "Feature Flags",
+    "Feature Toggle",
+    "Client SDK",
+    "Flag Management",
+    "Remote Config",
+    "Cloud",
+    "Integration",
+    "JavaScript",
+    "TypeScript",
+    "SDK"
+  ],
+  "scripts": {
+    "build": "rimraf dist && rollup -c rollup.config.js",
+    "typecheck": "tsc --noEmit",
+    "prettier:formatting": "npx prettier --write ./src",
+    "test": "jest"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/flipflag-dev/sdk.git"
+  },
+  "author": "Polevov Evgenii <epolevov@emd.one>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/flipflag-dev/sdk/issues"
+  },
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "repositoryUrl": "https://github.com/flipflag-dev/sdk.git",
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/npm",
+      [
+        "@semantic-release/git",
+        {
+          "message": "chore(release): ${nextRelease.version} \n\n${nextRelease.notes}"
+        }
+      ],
+      "@semantic-release/github"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "overrides": {
+    "@semantic-release/npm": {
+      "npm": "11.6.2"
+    }
+  },
+  "homepage": "https://github.com/flipflag-dev/sdk.git#readme",
+  "devDependencies": {
+    "@jest/globals": "^30.2.0",
+    "@rollup/plugin-alias": "^6.0.0",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.2",
+    "@semantic-release/npm": "^13.1.2",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "rimraf": "^6.1.2",
+    "rollup": "^4.53.3",
+    "rollup-plugin-dts": "^6.2.3",
+    "rollup-plugin-esbuild": "^6.2.1",
+    "ts-jest": "^29.4.5"
+  }
+}