@ops-ai/electron-feature-flags-toggly 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0] - 2026-09-11
+
+### Added
+
+- Initial `@ops-ai/electron-feature-flags-toggly` release
+- Main-process client using frontend App Key + `/evaluated-signed`
+- Disk cache under Electron `userData`, signature verification via `@ops-ai/toggly-signed-defs`
+- WebSocket live updates in the main process with renderer fan-out
+- Preload `exposeToggly()` and Flutter-like renderer API (`init` in main; `isFeatureOn` / `Feature` in renderer)
+- Optional React helpers: `Feature`, `useFeatureFlag`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2026 opsAI LLC
+
+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,156 @@
+# @ops-ai/electron-feature-flags-toggly
+
+Feature flags for Electron apps with a Flutter-like DX. The **main process** owns your App Key, fetches `/evaluated-signed` definitions, verifies signatures, caches under `userData`, and keeps a live WebSocket. The renderer uses `window.toggly` (exposed from preload) — no App Key in Chromium.
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+  <a href="https://docs.toggly.io"><img src="https://img.shields.io/badge/docs-docs.toggly.io-blue.svg" alt="Documentation"></a>
+  <a href="https://toggly.io"><img src="https://img.shields.io/badge/website-toggly.io-0A66C2.svg" alt="Website"></a>
+</p>
+
+## Install
+
+```bash
+npm install @ops-ai/electron-feature-flags-toggly
+```
+
+Peer: Electron ≥ 28. React ≥ 18 is optional (only for `@ops-ai/electron-feature-flags-toggly/react`).
+
+## Setup (3 snippets)
+
+### 1. Main process
+
+```js
+import { app, BrowserWindow } from 'electron'
+import {
+  initToggly,
+  registerTogglyIpc,
+  isFeatureOn,
+} from '@ops-ai/electron-feature-flags-toggly/main'
+
+await app.whenReady()
+
+await initToggly({
+  appKey: process.env.TOGGLY_APP_KEY,
+  environment: 'Production',
+  userDataPath: app.getPath('userData'),
+  flagDefaults: {
+    NewDashboard: false,
+    BetaMenu: false,
+  },
+})
+
+registerTogglyIpc(require('electron').ipcMain, () => BrowserWindow.getAllWindows())
+
+// Trusted process can gate menus / windows directly:
+if (isFeatureOn('BetaMenu')) {
+  // …
+}
+```
+
+### 2. Preload
+
+```js
+import { exposeToggly } from '@ops-ai/electron-feature-flags-toggly/preload'
+
+exposeToggly()
+```
+
+Wire this file as `webPreferences.preload` with `contextIsolation: true`.
+
+### 3. Renderer
+
+```js
+import { isFeatureOn, evaluateFeatureGate } from '@ops-ai/electron-feature-flags-toggly'
+
+if (isFeatureOn('NewDashboard')) {
+  showDashboard()
+}
+
+const unlock = evaluateFeatureGate(
+  ['FeatureA', 'FeatureB'],
+  'any',
+  false,
+)
+```
+
+## React (optional)
+
+```tsx
+import { Feature, useFeatureFlag } from '@ops-ai/electron-feature-flags-toggly/react'
+
+export function App() {
+  const { isEnabled } = useFeatureFlag('NewDashboard')
+
+  return (
+    <>
+      <Feature featureKey="NewDashboard">
+        <NewDashboard />
+      </Feature>
+      <Feature featureKey="NewDashboard" negate>
+        <LegacyDashboard />
+      </Feature>
+      {isEnabled && <Badge />}
+    </>
+  )
+}
+```
+
+## API overview
+
+| Surface | Entry |
+|---------|--------|
+| Main | `@ops-ai/electron-feature-flags-toggly/main` |
+| Preload | `@ops-ai/electron-feature-flags-toggly/preload` |
+| Renderer | `@ops-ai/electron-feature-flags-toggly` or `/renderer` |
+| React | `@ops-ai/electron-feature-flags-toggly/react` |
+
+### Main
+
+- `initToggly(config)` → `Promise<flags>`
+- `getToggly()` / `closeToggly()`
+- `isFeatureOn` / `isFeatureOff` / `evaluateFeatureGate`
+- `setContext` / `clearContext` / `addHook`
+- `registerTogglyIpc(ipcMain, getWindows)`
+
+### Renderer (`window.toggly`)
+
+- `isFeatureOn(key, entityContext?, kind?)`
+- `evaluateFeatureGate(keys, requirement?, negate?, entityContext?, kind?)`
+- `getFlags()` / `setContext` / `clearContext`
+- `onFlagsUpdated(callback)` → unsubscribe
+
+## Configuration
+
+| Option | Default | Notes |
+|--------|---------|--------|
+| `appKey` | — | Frontend App Key |
+| `environment` | `Production` | |
+| `baseURI` | `https://definitions.toggly.io` | |
+| `userDataPath` | **required** | `app.getPath('userData')` |
+| `flagDefaults` | `{}` | Offline / no-key fallback |
+| `identity` / `groups` / `claims` | | Targeting context |
+| `verifySignatures` | `false` | ES256 via JWKS |
+| `enableLiveUpdates` | `true` when `appKey` set | WebSocket in main |
+| `connectTimeout` | `5000` | ms |
+| `featureFlagsRefreshInterval` | `180000` | ms |
+
+## Entity context
+
+Entity-gated flags fail closed without a context. Pass an entity on each read:
+
+```js
+isFeatureOn('OrderBadge', order, 'Order')
+```
+
+## Signed definitions
+
+Set `verifySignatures: true` to verify evaluated-signed envelopes in the main process before caching or serving results to the renderer.
+
+## Example
+
+See [`example/`](./example) for a minimal main + preload + HTML app.
+
+## License
+
+MIT © opsAI LLC

package/dist/index.cjs

@@ -0,0 +1,80 @@
+'use strict';
+
+// src/renderer/index.ts
+function tryBridge() {
+  if (typeof window === "undefined" || !window.toggly) {
+    return null;
+  }
+  return window.toggly;
+}
+function isFeatureOn(key, entityContext, kind) {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return false;
+  }
+  return bridge.isFeatureOn(key, entityContext, kind);
+}
+function isFeatureOff(key, entityContext, kind) {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return true;
+  }
+  return bridge.isFeatureOff(key, entityContext, kind);
+}
+function evaluateFeatureGate(keys, requirement, negate, entityContext, kind) {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return negate ?? false;
+  }
+  return bridge.evaluateFeatureGate(keys, requirement, negate, entityContext, kind);
+}
+function getFlags() {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return Promise.reject(
+      new Error(
+        "window.toggly is not available. Call exposeToggly() from your preload script."
+      )
+    );
+  }
+  return bridge.getFlags();
+}
+function setContext(context) {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return Promise.reject(
+      new Error(
+        "window.toggly is not available. Call exposeToggly() from your preload script."
+      )
+    );
+  }
+  return bridge.setContext(context);
+}
+function clearContext() {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return Promise.reject(
+      new Error(
+        "window.toggly is not available. Call exposeToggly() from your preload script."
+      )
+    );
+  }
+  return bridge.clearContext();
+}
+function onFlagsUpdated(callback) {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return () => void 0;
+  }
+  return bridge.onFlagsUpdated(callback);
+}
+
+exports.clearContext = clearContext;
+exports.evaluateFeatureGate = evaluateFeatureGate;
+exports.getFlags = getFlags;
+exports.isFeatureOff = isFeatureOff;
+exports.isFeatureOn = isFeatureOn;
+exports.onFlagsUpdated = onFlagsUpdated;
+exports.setContext = setContext;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/renderer/index.ts"],"names":[],"mappings":";;;AAQA,SAAS,SAAA,GAAiC;AACxC,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,CAAC,OAAO,MAAA,EAAQ;AACnD,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA,CAAO,MAAA;AAChB;AAEO,SAAS,WAAA,CACd,GAAA,EACA,aAAA,EACA,IAAA,EACS;AACT,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA,CAAO,WAAA,CAAY,GAAA,EAAK,aAAA,EAAe,IAAI,CAAA;AACpD;AAEO,SAAS,YAAA,CACd,GAAA,EACA,aAAA,EACA,IAAA,EACS;AACT,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA,CAAO,YAAA,CAAa,GAAA,EAAK,aAAA,EAAe,IAAI,CAAA;AACrD;AAEO,SAAS,mBAAA,CACd,IAAA,EACA,WAAA,EACA,MAAA,EACA,eACA,IAAA,EACS;AACT,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,MAAA,IAAU,KAAA;AAAA,EACnB;AACA,EAAA,OAAO,OAAO,mBAAA,CAAoB,IAAA,EAAM,WAAA,EAAa,MAAA,EAAQ,eAAe,IAAI,CAAA;AAClF;AAEO,SAAS,QAAA,GAA0C;AACxD,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,MACb,IAAI,KAAA;AAAA,QACF;AAAA;AACF,KACF;AAAA,EACF;AACA,EAAA,OAAO,OAAO,QAAA,EAAS;AACzB;AAEO,SAAS,WAAW,OAAA,EAAyD;AAClF,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,MACb,IAAI,KAAA;AAAA,QACF;AAAA;AACF,KACF;AAAA,EACF;AACA,EAAA,OAAO,MAAA,CAAO,WAAW,OAAO,CAAA;AAClC;AAEO,SAAS,YAAA,GAA8C;AAC5D,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,MACb,IAAI,KAAA;AAAA,QACF;AAAA;AACF,KACF;AAAA,EACF;AACA,EAAA,OAAO,OAAO,YAAA,EAAa;AAC7B;AAEO,SAAS,eACd,QAAA,EACY;AACZ,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,MAAM,MAAA;AAAA,EACf;AACA,EAAA,OAAO,MAAA,CAAO,eAAe,QAAQ,CAAA;AACvC","file":"index.cjs","sourcesContent":["import type {\n  EntityContextInput,\n  FeatureFlagsSnapshot,\n  FeatureRequirement,\n  SetContextInput,\n  TogglyBridge,\n} from '../types.js'\n\nfunction tryBridge(): TogglyBridge | null {\n  if (typeof window === 'undefined' || !window.toggly) {\n    return null\n  }\n  return window.toggly\n}\n\nexport function isFeatureOn(\n  key: string,\n  entityContext?: EntityContextInput,\n  kind?: string,\n): boolean {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return false\n  }\n  return bridge.isFeatureOn(key, entityContext, kind)\n}\n\nexport function isFeatureOff(\n  key: string,\n  entityContext?: EntityContextInput,\n  kind?: string,\n): boolean {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return true\n  }\n  return bridge.isFeatureOff(key, entityContext, kind)\n}\n\nexport function evaluateFeatureGate(\n  keys: string[],\n  requirement?: FeatureRequirement | string,\n  negate?: boolean,\n  entityContext?: EntityContextInput,\n  kind?: string,\n): boolean {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return negate ?? false\n  }\n  return bridge.evaluateFeatureGate(keys, requirement, negate, entityContext, kind)\n}\n\nexport function getFlags(): Promise<FeatureFlagsSnapshot> {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return Promise.reject(\n      new Error(\n        'window.toggly is not available. Call exposeToggly() from your preload script.',\n      ),\n    )\n  }\n  return bridge.getFlags()\n}\n\nexport function setContext(context: SetContextInput): Promise<FeatureFlagsSnapshot> {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return Promise.reject(\n      new Error(\n        'window.toggly is not available. Call exposeToggly() from your preload script.',\n      ),\n    )\n  }\n  return bridge.setContext(context)\n}\n\nexport function clearContext(): Promise<FeatureFlagsSnapshot> {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return Promise.reject(\n      new Error(\n        'window.toggly is not available. Call exposeToggly() from your preload script.',\n      ),\n    )\n  }\n  return bridge.clearContext()\n}\n\nexport function onFlagsUpdated(\n  callback: (flags: FeatureFlagsSnapshot) => void,\n): () => void {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return () => undefined\n  }\n  return bridge.onFlagsUpdated(callback)\n}\n\nexport type { TogglyBridge, FeatureFlagsSnapshot, FeatureRequirement, SetContextInput }\n"]}

package/dist/index.d.cts

@@ -0,0 +1,3 @@
+export { clearContext, evaluateFeatureGate, getFlags, isFeatureOff, isFeatureOn, onFlagsUpdated, setContext } from './renderer/index.cjs';
+export { E as EntityContextInput, a as FeatureFlagsSnapshot, F as FeatureRequirement, S as SetContextInput, b as TogglyBridge, T as TogglyElectronConfig } from './types-BbMSwQVV.cjs';
+export { Hook } from '@ops-ai/toggly-hooks-types';

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { clearContext, evaluateFeatureGate, getFlags, isFeatureOff, isFeatureOn, onFlagsUpdated, setContext } from './renderer/index.js';
+export { E as EntityContextInput, a as FeatureFlagsSnapshot, F as FeatureRequirement, S as SetContextInput, b as TogglyBridge, T as TogglyElectronConfig } from './types-BbMSwQVV.js';
+export { Hook } from '@ops-ai/toggly-hooks-types';

package/dist/index.js

@@ -0,0 +1,72 @@
+// src/renderer/index.ts
+function tryBridge() {
+  if (typeof window === "undefined" || !window.toggly) {
+    return null;
+  }
+  return window.toggly;
+}
+function isFeatureOn(key, entityContext, kind) {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return false;
+  }
+  return bridge.isFeatureOn(key, entityContext, kind);
+}
+function isFeatureOff(key, entityContext, kind) {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return true;
+  }
+  return bridge.isFeatureOff(key, entityContext, kind);
+}
+function evaluateFeatureGate(keys, requirement, negate, entityContext, kind) {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return negate ?? false;
+  }
+  return bridge.evaluateFeatureGate(keys, requirement, negate, entityContext, kind);
+}
+function getFlags() {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return Promise.reject(
+      new Error(
+        "window.toggly is not available. Call exposeToggly() from your preload script."
+      )
+    );
+  }
+  return bridge.getFlags();
+}
+function setContext(context) {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return Promise.reject(
+      new Error(
+        "window.toggly is not available. Call exposeToggly() from your preload script."
+      )
+    );
+  }
+  return bridge.setContext(context);
+}
+function clearContext() {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return Promise.reject(
+      new Error(
+        "window.toggly is not available. Call exposeToggly() from your preload script."
+      )
+    );
+  }
+  return bridge.clearContext();
+}
+function onFlagsUpdated(callback) {
+  const bridge = tryBridge();
+  if (!bridge) {
+    return () => void 0;
+  }
+  return bridge.onFlagsUpdated(callback);
+}
+
+export { clearContext, evaluateFeatureGate, getFlags, isFeatureOff, isFeatureOn, onFlagsUpdated, setContext };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/renderer/index.ts"],"names":[],"mappings":";AAQA,SAAS,SAAA,GAAiC;AACxC,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,CAAC,OAAO,MAAA,EAAQ;AACnD,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA,CAAO,MAAA;AAChB;AAEO,SAAS,WAAA,CACd,GAAA,EACA,aAAA,EACA,IAAA,EACS;AACT,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA,CAAO,WAAA,CAAY,GAAA,EAAK,aAAA,EAAe,IAAI,CAAA;AACpD;AAEO,SAAS,YAAA,CACd,GAAA,EACA,aAAA,EACA,IAAA,EACS;AACT,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA,CAAO,YAAA,CAAa,GAAA,EAAK,aAAA,EAAe,IAAI,CAAA;AACrD;AAEO,SAAS,mBAAA,CACd,IAAA,EACA,WAAA,EACA,MAAA,EACA,eACA,IAAA,EACS;AACT,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,MAAA,IAAU,KAAA;AAAA,EACnB;AACA,EAAA,OAAO,OAAO,mBAAA,CAAoB,IAAA,EAAM,WAAA,EAAa,MAAA,EAAQ,eAAe,IAAI,CAAA;AAClF;AAEO,SAAS,QAAA,GAA0C;AACxD,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,MACb,IAAI,KAAA;AAAA,QACF;AAAA;AACF,KACF;AAAA,EACF;AACA,EAAA,OAAO,OAAO,QAAA,EAAS;AACzB;AAEO,SAAS,WAAW,OAAA,EAAyD;AAClF,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,MACb,IAAI,KAAA;AAAA,QACF;AAAA;AACF,KACF;AAAA,EACF;AACA,EAAA,OAAO,MAAA,CAAO,WAAW,OAAO,CAAA;AAClC;AAEO,SAAS,YAAA,GAA8C;AAC5D,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,MACb,IAAI,KAAA;AAAA,QACF;AAAA;AACF,KACF;AAAA,EACF;AACA,EAAA,OAAO,OAAO,YAAA,EAAa;AAC7B;AAEO,SAAS,eACd,QAAA,EACY;AACZ,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,MAAM,MAAA;AAAA,EACf;AACA,EAAA,OAAO,MAAA,CAAO,eAAe,QAAQ,CAAA;AACvC","file":"index.js","sourcesContent":["import type {\n  EntityContextInput,\n  FeatureFlagsSnapshot,\n  FeatureRequirement,\n  SetContextInput,\n  TogglyBridge,\n} from '../types.js'\n\nfunction tryBridge(): TogglyBridge | null {\n  if (typeof window === 'undefined' || !window.toggly) {\n    return null\n  }\n  return window.toggly\n}\n\nexport function isFeatureOn(\n  key: string,\n  entityContext?: EntityContextInput,\n  kind?: string,\n): boolean {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return false\n  }\n  return bridge.isFeatureOn(key, entityContext, kind)\n}\n\nexport function isFeatureOff(\n  key: string,\n  entityContext?: EntityContextInput,\n  kind?: string,\n): boolean {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return true\n  }\n  return bridge.isFeatureOff(key, entityContext, kind)\n}\n\nexport function evaluateFeatureGate(\n  keys: string[],\n  requirement?: FeatureRequirement | string,\n  negate?: boolean,\n  entityContext?: EntityContextInput,\n  kind?: string,\n): boolean {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return negate ?? false\n  }\n  return bridge.evaluateFeatureGate(keys, requirement, negate, entityContext, kind)\n}\n\nexport function getFlags(): Promise<FeatureFlagsSnapshot> {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return Promise.reject(\n      new Error(\n        'window.toggly is not available. Call exposeToggly() from your preload script.',\n      ),\n    )\n  }\n  return bridge.getFlags()\n}\n\nexport function setContext(context: SetContextInput): Promise<FeatureFlagsSnapshot> {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return Promise.reject(\n      new Error(\n        'window.toggly is not available. Call exposeToggly() from your preload script.',\n      ),\n    )\n  }\n  return bridge.setContext(context)\n}\n\nexport function clearContext(): Promise<FeatureFlagsSnapshot> {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return Promise.reject(\n      new Error(\n        'window.toggly is not available. Call exposeToggly() from your preload script.',\n      ),\n    )\n  }\n  return bridge.clearContext()\n}\n\nexport function onFlagsUpdated(\n  callback: (flags: FeatureFlagsSnapshot) => void,\n): () => void {\n  const bridge = tryBridge()\n  if (!bridge) {\n    return () => undefined\n  }\n  return bridge.onFlagsUpdated(callback)\n}\n\nexport type { TogglyBridge, FeatureFlagsSnapshot, FeatureRequirement, SetContextInput }\n"]}