@ops-ai/astro-feature-flags-toggly 1.2.1 → 1.3.0

package/README.md

@@ -504,4 +504,105 @@ MIT
 - [@ops-ai/react-feature-flags-toggly](https://www.npmjs.com/package/@ops-ai/react-feature-flags-toggly) - React SDK
 - [@ops-ai/feature-flags-toggly](https://www.npmjs.com/package/@ops-ai/feature-flags-toggly) - Vanilla JavaScript SDK
 
+## Extensibility with Hooks
+
+Toggly provides a powerful hooks system that allows you to extend SDK functionality by hooking into feature flag lifecycle events. This is perfect for integrating with analytics, monitoring tools, or implementing custom behaviors.
+
+### What are Hooks?
+
+Hooks let you execute custom code at specific points in the feature flag evaluation lifecycle:
+
+- **beforeEvaluation**: Called before a feature flag is evaluated
+- **afterEvaluation**: Called after a feature flag is evaluated (with the result)
+- **beforeIdentify**: Called before user identity is set or cleared
+- **afterIdentify**: Called after user identity is set or cleared
+- **afterRefresh**: Called after feature definitions are refreshed from Toggly
+
+### Creating a Hook
+
+```typescript
+import type { Hook } from '@ops-ai/toggly-hooks-types';
+
+const myAnalyticsHook: Hook = {
+  getMetadata: () => ({
+    name: 'MyAnalyticsHook',
+    version: '1.0.0'
+  }),
+  
+  afterEvaluation: async (data) => {
+    // Send to analytics
+    analytics.track('Feature Flag Evaluated', {
+      feature: data.featureKey,
+      enabled: data.result
+    });
+  }
+};
+```
+
+### Registering Hooks
+
+**During initialization in astro.config:**
+
+```typescript
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import toggly from '@ops-ai/astro-feature-flags-toggly';
+
+export default defineConfig({
+  integrations: [
+    toggly({
+      appKey: 'your-app-key',
+      environment: 'your-environment-name',
+      hooks: [myAnalyticsHook]
+    })
+  ]
+});
+```
+
+**At runtime (client-side):**
+
+```typescript
+import { togglyStore } from '@ops-ai/astro-feature-flags-toggly/client';
+import { get } from 'svelte/store';
+
+const store = get(togglyStore);
+
+// Add a hook
+store.hookExecutor.addHook(myAnalyticsHook);
+
+// Remove a hook
+store.hookExecutor.removeHook(myAnalyticsHook);
+```
+
+### Common Use Cases
+
+**Analytics Integration:**
+```typescript
+const clarityHook: Hook = {
+  getMetadata: () => ({ name: 'Microsoft Clarity', version: '1.0.0' }),
+  afterEvaluation: async (data) => {
+    if (typeof clarity !== 'undefined') {
+      clarity('event', `FeatureFlag:${data.featureKey}`);
+    }
+  }
+};
+```
+
+**Debug Logging:**
+```typescript
+const debugHook: Hook = {
+  getMetadata: () => ({ name: 'DebugLogger', version: '1.0.0' }),
+  afterEvaluation: async (data) => {
+    if (import.meta.env.DEV) {
+      console.debug('[Toggly]', data.featureKey, '=', data.result);
+    }
+  }
+};
+```
+
+## Related SDKs
+
+- [@ops-ai/react-feature-flags-toggly](https://www.npmjs.com/package/@ops-ai/react-feature-flags-toggly) - React SDK
+- [@ops-ai/feature-flags-toggly](https://www.npmjs.com/package/@ops-ai/feature-flags-toggly) - Vanilla JavaScript SDK
+
 

package/dist/{chunk-MKHBDBTR.js → chunk-GW5NHZA2.js}

@@ -1,7 +1,7 @@
 import {
   $flags,
   $isReady
-} from "./chunk-Z3WWTK42.js";
+} from "./chunk-ILEHRLEW.js";
 
 // src/frameworks/react/Feature.tsx
 import { useStore } from "@nanostores/react";
@@ -71,4 +71,4 @@ export {
   useFeatureGate,
   Feature_default
 };
-//# sourceMappingURL=chunk-MKHBDBTR.js.map
+//# sourceMappingURL=chunk-GW5NHZA2.js.map

package/dist/{chunk-Z3WWTK42.js → chunk-ILEHRLEW.js}

@@ -1,5 +1,133 @@
 // src/client/store.ts
 import { atom, computed } from "nanostores";
+
+// src/client/hooks.ts
+var HookExecutor = class {
+  hooks = [];
+  /**
+   * Register a new hook
+   */
+  addHook(hook) {
+    const metadata = hook.getMetadata();
+    const existingHook = this.hooks.find((h) => h.getMetadata().name === metadata.name);
+    if (existingHook) {
+      console.warn(`[Toggly] Hook with name "${metadata.name}" already registered. Skipping.`);
+      return;
+    }
+    this.hooks.push(hook);
+  }
+  /**
+   * Remove a hook by name
+   * @returns true if hook was found and removed, false otherwise
+   */
+  removeHook(name) {
+    const index = this.hooks.findIndex((h) => h.getMetadata().name === name);
+    if (index > -1) {
+      this.hooks.splice(index, 1);
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Execute beforeEvaluation hooks in registration order (FIFO)
+   * Collects data from each hook to pass to afterEvaluation
+   */
+  executeBeforeEvaluation(flagKey, defaultValue) {
+    const dataMap = /* @__PURE__ */ new Map();
+    for (const hook of this.hooks) {
+      if (hook.beforeEvaluation) {
+        try {
+          const data = hook.beforeEvaluation(flagKey, defaultValue);
+          dataMap.set(hook.getMetadata().name, data);
+        } catch (error) {
+          console.error(
+            `[Toggly] Error in hook "${hook.getMetadata().name}.beforeEvaluation":`,
+            error
+          );
+        }
+      }
+    }
+    return dataMap;
+  }
+  /**
+   * Execute afterEvaluation hooks in reverse order (LIFO)
+   * Passes data from corresponding beforeEvaluation
+   */
+  executeAfterEvaluation(flagKey, dataMap, result) {
+    for (let i = this.hooks.length - 1; i >= 0; i--) {
+      const hook = this.hooks[i];
+      if (hook.afterEvaluation) {
+        try {
+          const data = dataMap.get(hook.getMetadata().name);
+          hook.afterEvaluation(flagKey, data, result);
+        } catch (error) {
+          console.error(
+            `[Toggly] Error in hook "${hook.getMetadata().name}.afterEvaluation":`,
+            error
+          );
+        }
+      }
+    }
+  }
+  /**
+   * Execute beforeIdentify hooks in registration order (FIFO)
+   */
+  executeBeforeIdentify(identity) {
+    const dataMap = /* @__PURE__ */ new Map();
+    for (const hook of this.hooks) {
+      if (hook.beforeIdentify) {
+        try {
+          const data = hook.beforeIdentify(identity);
+          dataMap.set(hook.getMetadata().name, data);
+        } catch (error) {
+          console.error(
+            `[Toggly] Error in hook "${hook.getMetadata().name}.beforeIdentify":`,
+            error
+          );
+        }
+      }
+    }
+    return dataMap;
+  }
+  /**
+   * Execute afterIdentify hooks in reverse order (LIFO)
+   */
+  executeAfterIdentify(identity, dataMap) {
+    for (let i = this.hooks.length - 1; i >= 0; i--) {
+      const hook = this.hooks[i];
+      if (hook.afterIdentify) {
+        try {
+          const data = dataMap.get(hook.getMetadata().name);
+          hook.afterIdentify(identity, data);
+        } catch (error) {
+          console.error(
+            `[Toggly] Error in hook "${hook.getMetadata().name}.afterIdentify":`,
+            error
+          );
+        }
+      }
+    }
+  }
+  /**
+   * Execute afterRefresh hooks in registration order (FIFO)
+   */
+  executeAfterRefresh(flags) {
+    for (const hook of this.hooks) {
+      if (hook.afterRefresh) {
+        try {
+          hook.afterRefresh(flags);
+        } catch (error) {
+          console.error(
+            `[Toggly] Error in hook "${hook.getMetadata().name}.afterRefresh":`,
+            error
+          );
+        }
+      }
+    }
+  }
+};
+
+// src/client/store.ts
 var $flags = atom({});
 var $isReady = atom(false);
 var $error = atom(null);
@@ -8,6 +136,7 @@ var TogglyClientInstance = class {
   config;
   cache = null;
   refreshInterval = null;
+  hookExecutor = new HookExecutor();
   constructor(config) {
     this.config = {
       baseURI: "https://client.toggly.io",
@@ -16,8 +145,12 @@ var TogglyClientInstance = class {
       featureFlagsRefreshInterval: 3 * 60 * 1e3,
       isDebug: false,
       connectTimeout: 5 * 1e3,
+      hooks: [],
       ...config
     };
+    if (this.config.hooks) {
+      this.config.hooks.forEach((hook) => this.hookExecutor.addHook(hook));
+    }
   }
   getApiUrl() {
     const { baseURI, appKey, environment, identity } = this.config;
@@ -82,6 +215,7 @@ var TogglyClientInstance = class {
       $flags.set(flags);
       $isReady.set(true);
       $error.set(null);
+      this.hookExecutor.executeAfterRefresh(flags);
       if (this.config.featureFlagsRefreshInterval && this.config.featureFlagsRefreshInterval > 0) {
         this.startRefreshInterval();
       }
@@ -96,6 +230,7 @@ var TogglyClientInstance = class {
       const flags = await this.fetchFlags();
       this.cache = flags;
       $flags.set(flags);
+      this.hookExecutor.executeAfterRefresh(flags);
       if (this.config.isDebug) {
         console.log("[Toggly Client] Flags refreshed");
       }
@@ -185,6 +320,20 @@ function $gate(keys, requirement = "all", negate = false) {
     return negate ? !isEnabled : isEnabled;
   });
 }
+function addHook(hook) {
+  if (!clientInstance) {
+    console.error("[Toggly Client] Client not initialized");
+    return;
+  }
+  clientInstance.hookExecutor.addHook(hook);
+}
+function removeHook(name) {
+  if (!clientInstance) {
+    console.error("[Toggly Client] Client not initialized");
+    return false;
+  }
+  return clientInstance.hookExecutor.removeHook(name);
+}
 
 export {
   $flags,
@@ -196,6 +345,8 @@ export {
   clearIdentity,
   stopRefreshInterval,
   $flag,
-  $gate
+  $gate,
+  addHook,
+  removeHook
 };
-//# sourceMappingURL=chunk-Z3WWTK42.js.map
+//# sourceMappingURL=chunk-ILEHRLEW.js.map

package/dist/chunk-ILEHRLEW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client/store.ts","../src/client/hooks.ts"],"sourcesContent":["/**\n * Toggly Client-Side Store using Nanostores\n * \n * Provides reactive state management for feature flags on the client side.\n * This module includes its own embedded Toggly client implementation.\n */\n\nimport { atom, computed, type ReadableAtom } from 'nanostores';\nimport type { TogglyConfig, Flags } from '../types/index.js';\nimport type { Hook } from '@ops-ai/toggly-hooks-types';\nimport { HookExecutor } from './hooks.js';\n\n/**\n * Atom containing all feature flags\n */\nexport const $flags = atom<Flags>({});\n\n/**\n * Atom indicating if flags are loaded and ready\n */\nexport const $isReady = atom<boolean>(false);\n\n/**\n * Atom containing any error that occurred during initialization\n */\nexport const $error = atom<Error | null>(null);\n\n/**\n * Internal client instance storage\n */\nlet clientInstance: TogglyClientInstance | null = null;\n\n/**\n * Internal client implementation\n */\nclass TogglyClientInstance {\n  private config: TogglyConfig;\n  private cache: Flags | null = null;\n  private refreshInterval: NodeJS.Timeout | null = null;\n  public hookExecutor = new HookExecutor();\n\n  constructor(config: TogglyConfig) {\n    this.config = {\n      baseURI: 'https://client.toggly.io',\n      environment: 'Production',\n      flagDefaults: {},\n      featureFlagsRefreshInterval: 3 * 60 * 1000,\n      isDebug: false,\n      connectTimeout: 5 * 1000,\n      hooks: [],\n      ...config,\n    };\n    \n    // Register initial hooks\n    if (this.config.hooks) {\n      this.config.hooks.forEach(hook => this.hookExecutor.addHook(hook));\n    }\n  }\n\n  private getApiUrl(): string {\n    const { baseURI, appKey, environment, identity } = this.config;\n\n    if (!appKey) {\n      return '';\n    }\n\n    const baseUrl = baseURI!.replace(/\\/$/, '');\n    let url = `${baseUrl}/${appKey}-${environment}/defs`;\n\n    if (identity) {\n      url += `?u=${encodeURIComponent(identity)}`;\n    }\n\n    return url;\n  }\n\n  async fetchFlags(): Promise<Flags> {\n    const url = this.getApiUrl();\n\n    if (!url || !this.config.appKey) {\n      if (this.config.isDebug) {\n        console.log('[Toggly Client] Using flag defaults (no appKey):', this.config.flagDefaults);\n      }\n      return { ...this.config.flagDefaults! };\n    }\n\n    try {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), this.config.connectTimeout);\n\n      const response = await fetch(url, {\n        method: 'GET',\n        headers: {\n          Accept: 'application/json',\n        },\n        cache: 'no-store',\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        throw new Error(`Failed to fetch flags: ${response.status} ${response.statusText}`);\n      }\n\n      const flags = (await response.json()) as Flags;\n\n      if (this.config.isDebug) {\n        console.log('[Toggly Client] Fetched flags:', flags);\n      }\n\n      return flags;\n    } catch (error) {\n      if (this.config.isDebug) {\n        console.error('[Toggly Client] Error fetching flags:', error);\n      }\n\n      // Fall back to cached flags or defaults\n      if (this.cache) {\n        if (this.config.isDebug) {\n          console.log('[Toggly Client] Using cached flags');\n        }\n        return { ...this.cache };\n      }\n\n      if (this.config.isDebug) {\n        console.log('[Toggly Client] Using flag defaults');\n      }\n\n      return { ...this.config.flagDefaults! };\n    }\n  }\n\n  async init(): Promise<void> {\n    try {\n      const flags = await this.fetchFlags();\n      this.cache = flags;\n      $flags.set(flags);\n      $isReady.set(true);\n      $error.set(null);\n      \n      // Trigger afterRefresh hooks\n      this.hookExecutor.executeAfterRefresh(flags);\n\n      // Start refresh interval if configured\n      if (\n        this.config.featureFlagsRefreshInterval &&\n        this.config.featureFlagsRefreshInterval > 0\n      ) {\n        this.startRefreshInterval();\n      }\n    } catch (error) {\n      $error.set(error as Error);\n      $isReady.set(true); // Still mark as ready even on error\n      console.error('[Toggly Client] Initialization error:', error);\n    }\n  }\n\n  async refresh(): Promise<void> {\n    try {\n      const flags = await this.fetchFlags();\n      this.cache = flags;\n      $flags.set(flags);\n      \n      // Trigger afterRefresh hooks\n      this.hookExecutor.executeAfterRefresh(flags);\n\n      if (this.config.isDebug) {\n        console.log('[Toggly Client] Flags refreshed');\n      }\n    } catch (error) {\n      console.error('[Toggly Client] Refresh error:', error);\n    }\n  }\n\n  private startRefreshInterval(): void {\n    if (this.refreshInterval) {\n      return;\n    }\n\n    this.refreshInterval = setInterval(() => {\n      this.refresh();\n    }, this.config.featureFlagsRefreshInterval!);\n\n    if (this.config.isDebug) {\n      console.log(\n        `[Toggly Client] Started refresh interval: ${this.config.featureFlagsRefreshInterval}ms`\n      );\n    }\n  }\n\n  stopRefreshInterval(): void {\n    if (this.refreshInterval) {\n      clearInterval(this.refreshInterval);\n      this.refreshInterval = null;\n\n      if (this.config.isDebug) {\n        console.log('[Toggly Client] Stopped refresh interval');\n      }\n    }\n  }\n\n  setIdentity(identity: string): void {\n    this.config.identity = identity;\n    this.refresh(); // Refresh with new identity\n  }\n\n  clearIdentity(): void {\n    this.config.identity = undefined;\n    this.refresh(); // Refresh without identity\n  }\n}\n\n/**\n * Initialize Toggly client with configuration\n * \n * @param config - Toggly configuration\n */\nexport async function initTogglyClient(config: TogglyConfig): Promise<void> {\n  if (clientInstance) {\n    console.warn('[Toggly Client] Client already initialized');\n    return;\n  }\n\n  clientInstance = new TogglyClientInstance(config);\n  await clientInstance.init();\n}\n\n/**\n * Manually refresh feature flags\n */\nexport async function refreshFlags(): Promise<void> {\n  if (!clientInstance) {\n    console.error('[Toggly Client] Client not initialized');\n    return;\n  }\n\n  await clientInstance.refresh();\n}\n\n/**\n * Set user identity for targeting\n * \n * @param identity - User identifier\n */\nexport function setIdentity(identity: string): void {\n  if (!clientInstance) {\n    console.error('[Toggly Client] Client not initialized');\n    return;\n  }\n\n  clientInstance.setIdentity(identity);\n}\n\n/**\n * Clear user identity\n */\nexport function clearIdentity(): void {\n  if (!clientInstance) {\n    console.error('[Toggly Client] Client not initialized');\n    return;\n  }\n\n  clientInstance.clearIdentity();\n}\n\n/**\n * Stop automatic refresh interval\n */\nexport function stopRefreshInterval(): void {\n  if (clientInstance) {\n    clientInstance.stopRefreshInterval();\n  }\n}\n\n/**\n * Create a computed atom for a specific feature flag\n * \n * @param key - Feature flag key\n * @param defaultValue - Default value if flag not found\n * @returns Readable atom with the flag value\n */\nexport function $flag(key: string, defaultValue: boolean = false): ReadableAtom<boolean> {\n  return computed($flags, (flags) => flags[key] ?? defaultValue);\n}\n\n/**\n * Create a computed atom that evaluates multiple feature flags\n * \n * @param keys - Array of feature flag keys\n * @param requirement - 'all' or 'any'\n * @param negate - Whether to negate the result\n * @returns Readable atom with the evaluation result\n */\nexport function $gate(\n  keys: string[],\n  requirement: 'all' | 'any' = 'all',\n  negate: boolean = false\n): ReadableAtom<boolean> {\n  return computed($flags, (flags) => {\n    if (keys.length === 0) {\n      return !negate;\n    }\n\n    let isEnabled: boolean;\n\n    if (requirement === 'any') {\n      isEnabled = keys.some((key) => flags[key] === true);\n    } else {\n      isEnabled = keys.every((key) => flags[key] === true);\n    }\n\n    return negate ? !isEnabled : isEnabled;\n  });\n}\n\n/**\n * Add a hook dynamically\n */\nexport function addHook(hook: Hook): void {\n  if (!clientInstance) {\n    console.error('[Toggly Client] Client not initialized');\n    return;\n  }\n  clientInstance.hookExecutor.addHook(hook);\n}\n\n/**\n * Remove a hook by name\n * @returns true if hook was found and removed, false otherwise\n */\nexport function removeHook(name: string): boolean {\n  if (!clientInstance) {\n    console.error('[Toggly Client] Client not initialized');\n    return false;\n  }\n  return clientInstance.hookExecutor.removeHook(name);\n}\n\n","import type { Hook, EvaluationSeriesData, IdentitySeriesData } from '@ops-ai/toggly-hooks-types';\n\n/**\n * Internal class that manages hook registration and execution\n */\nexport class HookExecutor {\n  private hooks: Hook[] = [];\n\n  /**\n   * Register a new hook\n   */\n  addHook(hook: Hook): void {\n    const metadata = hook.getMetadata();\n    \n    // Check for duplicate hook names\n    const existingHook = this.hooks.find(h => h.getMetadata().name === metadata.name);\n    if (existingHook) {\n      console.warn(`[Toggly] Hook with name \"${metadata.name}\" already registered. Skipping.`);\n      return;\n    }\n    \n    this.hooks.push(hook);\n  }\n\n  /**\n   * Remove a hook by name\n   * @returns true if hook was found and removed, false otherwise\n   */\n  removeHook(name: string): boolean {\n    const index = this.hooks.findIndex(h => h.getMetadata().name === name);\n    if (index > -1) {\n      this.hooks.splice(index, 1);\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Execute beforeEvaluation hooks in registration order (FIFO)\n   * Collects data from each hook to pass to afterEvaluation\n   */\n  executeBeforeEvaluation(\n    flagKey: string,\n    defaultValue?: boolean\n  ): Map<string, EvaluationSeriesData | void> {\n    const dataMap = new Map<string, EvaluationSeriesData | void>();\n    \n    for (const hook of this.hooks) {\n      if (hook.beforeEvaluation) {\n        try {\n          const data = hook.beforeEvaluation(flagKey, defaultValue);\n          dataMap.set(hook.getMetadata().name, data);\n        } catch (error) {\n          console.error(\n            `[Toggly] Error in hook \"${hook.getMetadata().name}.beforeEvaluation\":`,\n            error\n          );\n        }\n      }\n    }\n    \n    return dataMap;\n  }\n\n  /**\n   * Execute afterEvaluation hooks in reverse order (LIFO)\n   * Passes data from corresponding beforeEvaluation\n   */\n  executeAfterEvaluation(\n    flagKey: string,\n    dataMap: Map<string, EvaluationSeriesData | void>,\n    result: boolean\n  ): void {\n    // Execute in reverse order\n    for (let i = this.hooks.length - 1; i >= 0; i--) {\n      const hook = this.hooks[i];\n      if (hook.afterEvaluation) {\n        try {\n          const data = dataMap.get(hook.getMetadata().name);\n          hook.afterEvaluation(flagKey, data, result);\n        } catch (error) {\n          console.error(\n            `[Toggly] Error in hook \"${hook.getMetadata().name}.afterEvaluation\":`,\n            error\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Execute beforeIdentify hooks in registration order (FIFO)\n   */\n  executeBeforeIdentify(identity: string): Map<string, IdentitySeriesData | void> {\n    const dataMap = new Map<string, IdentitySeriesData | void>();\n    \n    for (const hook of this.hooks) {\n      if (hook.beforeIdentify) {\n        try {\n          const data = hook.beforeIdentify(identity);\n          dataMap.set(hook.getMetadata().name, data);\n        } catch (error) {\n          console.error(\n            `[Toggly] Error in hook \"${hook.getMetadata().name}.beforeIdentify\":`,\n            error\n          );\n        }\n      }\n    }\n    \n    return dataMap;\n  }\n\n  /**\n   * Execute afterIdentify hooks in reverse order (LIFO)\n   */\n  executeAfterIdentify(\n    identity: string,\n    dataMap: Map<string, IdentitySeriesData | void>\n  ): void {\n    for (let i = this.hooks.length - 1; i >= 0; i--) {\n      const hook = this.hooks[i];\n      if (hook.afterIdentify) {\n        try {\n          const data = dataMap.get(hook.getMetadata().name);\n          hook.afterIdentify(identity, data);\n        } catch (error) {\n          console.error(\n            `[Toggly] Error in hook \"${hook.getMetadata().name}.afterIdentify\":`,\n            error\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Execute afterRefresh hooks in registration order (FIFO)\n   */\n  executeAfterRefresh(flags: { [key: string]: boolean }): void {\n    for (const hook of this.hooks) {\n      if (hook.afterRefresh) {\n        try {\n          hook.afterRefresh(flags);\n        } catch (error) {\n          console.error(\n            `[Toggly] Error in hook \"${hook.getMetadata().name}.afterRefresh\":`,\n            error\n          );\n        }\n      }\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/client/setup.d.ts

@@ -1,3 +1,4 @@
 export { initTogglyClient } from './store.js';
 import 'nanostores';
-import '../index-CNGi0JrL.js';
+import '../index-Cjy13d0b.js';
+import '@ops-ai/toggly-hooks-types';

package/dist/client/setup.js

@@ -1,6 +1,6 @@
 import {
   initTogglyClient
-} from "../chunk-Z3WWTK42.js";
+} from "../chunk-ILEHRLEW.js";
 
 // src/client/setup.ts
 if (typeof globalThis !== "undefined" && typeof globalThis.window !== "undefined") {

package/dist/client/store.d.ts

@@ -1,6 +1,7 @@
 import * as nanostores from 'nanostores';
 import { ReadableAtom } from 'nanostores';
-import { T as TogglyConfig, F as Flags } from '../index-CNGi0JrL.js';
+import { T as TogglyConfig, F as Flags } from '../index-Cjy13d0b.js';
+import { Hook } from '@ops-ai/toggly-hooks-types';
 
 /**
  * Atom containing all feature flags
@@ -55,5 +56,14 @@ declare function $flag(key: string, defaultValue?: boolean): ReadableAtom<boolea
  * @returns Readable atom with the evaluation result
  */
 declare function $gate(keys: string[], requirement?: 'all' | 'any', negate?: boolean): ReadableAtom<boolean>;
+/**
+ * Add a hook dynamically
+ */
+declare function addHook(hook: Hook): void;
+/**
+ * Remove a hook by name
+ * @returns true if hook was found and removed, false otherwise
+ */
+declare function removeHook(name: string): boolean;
 
-export { $error, $flag, $flags, $gate, $isReady, clearIdentity, initTogglyClient, refreshFlags, setIdentity, stopRefreshInterval };
+export { $error, $flag, $flags, $gate, $isReady, addHook, clearIdentity, initTogglyClient, refreshFlags, removeHook, setIdentity, stopRefreshInterval };

package/dist/client/store.js

@@ -4,21 +4,25 @@ import {
   $flags,
   $gate,
   $isReady,
+  addHook,
   clearIdentity,
   initTogglyClient,
   refreshFlags,
+  removeHook,
   setIdentity,
   stopRefreshInterval
-} from "../chunk-Z3WWTK42.js";
+} from "../chunk-ILEHRLEW.js";
 export {
   $error,
   $flag,
   $flags,
   $gate,
   $isReady,
+  addHook,
   clearIdentity,
   initTogglyClient,
   refreshFlags,
+  removeHook,
   setIdentity,
   stopRefreshInterval
 };

package/dist/frameworks/react/Feature.js

@@ -3,8 +3,8 @@ import {
   Feature_default,
   useFeatureFlag,
   useFeatureGate
-} from "../../chunk-MKHBDBTR.js";
-import "../../chunk-Z3WWTK42.js";
+} from "../../chunk-GW5NHZA2.js";
+import "../../chunk-ILEHRLEW.js";
 export {
   Feature,
   Feature_default as default,

package/dist/frameworks/react/index.js

@@ -2,8 +2,8 @@ import {
   Feature,
   useFeatureFlag,
   useFeatureGate
-} from "../../chunk-MKHBDBTR.js";
-import "../../chunk-Z3WWTK42.js";
+} from "../../chunk-GW5NHZA2.js";
+import "../../chunk-ILEHRLEW.js";
 export {
   Feature,
   useFeatureFlag,

package/dist/frameworks/svelte/stores.d.ts

@@ -1,7 +1,8 @@
 import * as svelte_store from 'svelte/store';
 export { $flags as flags, $isReady as isReady } from '../../client/store.js';
 import 'nanostores';
-import '../../index-CNGi0JrL.js';
+import '../../index-Cjy13d0b.js';
+import '@ops-ai/toggly-hooks-types';
 
 /**
  * Create a derived store for a specific feature flag

package/dist/frameworks/svelte/stores.js

@@ -1,7 +1,7 @@
 import {
   $flags,
   $isReady
-} from "../../chunk-Z3WWTK42.js";
+} from "../../chunk-ILEHRLEW.js";
 
 // src/frameworks/svelte/stores.ts
 import { derived } from "svelte/store";

package/dist/frameworks/vue/composables.js

@@ -1,7 +1,7 @@
 import {
   $flags,
   $isReady
-} from "../../chunk-Z3WWTK42.js";
+} from "../../chunk-ILEHRLEW.js";
 
 // src/frameworks/vue/composables.ts
 import { computed } from "vue";

package/dist/{index-CNGi0JrL.d.ts → index-Cjy13d0b.d.ts}

@@ -1,6 +1,9 @@
+import { Hook } from '@ops-ai/toggly-hooks-types';
+
 /**
  * Toggly Astro SDK - Type Definitions
  */
+
 /**
  * Configuration options for Toggly integration
  */
@@ -29,6 +32,8 @@ interface TogglyConfig {
      * (default: false)
      */
     allFeaturesEnabledDuringBuild?: boolean;
+    /** Hooks to extend SDK behavior at key lifecycle points */
+    hooks?: Hook[];
 }
 /**
  * Map of feature flag keys to their boolean values

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { TogglyIntegrationOptions, createTogglyMiddleware, default as togglyInte
 export { TogglyServer, createTogglyServerClient } from './server/toggly-server.js';
 export { allFeaturesEnabled, anyFeatureEnabled, getTogglyFromAstroGlobal, withFeatureFlag } from './server/utils.js';
 export { $error, $flag, $flags, $gate, $isReady, clearIdentity, initTogglyClient, refreshFlags, setIdentity, stopRefreshInterval } from './client/store.js';
-export { c as FeatureClientProps, b as FeatureProps, F as Flags, P as PageFeatureMapping, a as TogglyClient, T as TogglyConfig } from './index-CNGi0JrL.js';
+export { c as FeatureClientProps, b as FeatureProps, F as Flags, P as PageFeatureMapping, a as TogglyClient, T as TogglyConfig } from './index-Cjy13d0b.js';
 import 'astro';
 import 'nanostores';
+import '@ops-ai/toggly-hooks-types';

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   refreshFlags,
   setIdentity,
   stopRefreshInterval
-} from "./chunk-Z3WWTK42.js";
+} from "./chunk-ILEHRLEW.js";
 export {
   $error,
   $flag,

package/dist/integration/index.d.ts

@@ -1,5 +1,6 @@
 import { AstroIntegration } from 'astro';
-import { T as TogglyConfig } from '../index-CNGi0JrL.js';
+import { T as TogglyConfig } from '../index-Cjy13d0b.js';
+import '@ops-ai/toggly-hooks-types';
 
 /**
  * Toggly Astro Integration

package/dist/server/toggly-server.d.ts

@@ -1,4 +1,5 @@
-import { T as TogglyConfig, a as TogglyClient, F as Flags } from '../index-CNGi0JrL.js';
+import { T as TogglyConfig, a as TogglyClient, F as Flags } from '../index-Cjy13d0b.js';
+import '@ops-ai/toggly-hooks-types';
 
 /**
  * Toggly Server-Side Client for Astro SSR/SSG

package/dist/server/utils.d.ts

@@ -1,5 +1,6 @@
 import { AstroGlobal } from 'astro';
-import { a as TogglyClient } from '../index-CNGi0JrL.js';
+import { a as TogglyClient } from '../index-Cjy13d0b.js';
+import '@ops-ai/toggly-hooks-types';
 
 /**
  * Toggly Server Utilities for Astro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ops-ai/astro-feature-flags-toggly",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Toggly feature flags SDK for Astro with SSR, SSG, and framework support",
   "type": "module",
   "main": "./dist/index.js",
@@ -68,6 +68,7 @@
     "url": "https://github.com/ops-ai/Toggly.FeatureManagement"
   },
   "dependencies": {
+    "@ops-ai/toggly-hooks-types": "^1.0.0",
     "glob": "^10.3.10"
   },
   "devDependencies": {

package/dist/chunk-Z3WWTK42.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/client/store.ts"],"sourcesContent":["/**\n * Toggly Client-Side Store using Nanostores\n * \n * Provides reactive state management for feature flags on the client side.\n * This module includes its own embedded Toggly client implementation.\n */\n\nimport { atom, computed, type ReadableAtom } from 'nanostores';\nimport type { TogglyConfig, Flags } from '../types/index.js';\n\n/**\n * Atom containing all feature flags\n */\nexport const $flags = atom<Flags>({});\n\n/**\n * Atom indicating if flags are loaded and ready\n */\nexport const $isReady = atom<boolean>(false);\n\n/**\n * Atom containing any error that occurred during initialization\n */\nexport const $error = atom<Error | null>(null);\n\n/**\n * Internal client instance storage\n */\nlet clientInstance: TogglyClientInstance | null = null;\n\n/**\n * Internal client implementation\n */\nclass TogglyClientInstance {\n  private config: TogglyConfig;\n  private cache: Flags | null = null;\n  private refreshInterval: NodeJS.Timeout | null = null;\n\n  constructor(config: TogglyConfig) {\n    this.config = {\n      baseURI: 'https://client.toggly.io',\n      environment: 'Production',\n      flagDefaults: {},\n      featureFlagsRefreshInterval: 3 * 60 * 1000,\n      isDebug: false,\n      connectTimeout: 5 * 1000,\n      ...config,\n    };\n  }\n\n  private getApiUrl(): string {\n    const { baseURI, appKey, environment, identity } = this.config;\n\n    if (!appKey) {\n      return '';\n    }\n\n    const baseUrl = baseURI!.replace(/\\/$/, '');\n    let url = `${baseUrl}/${appKey}-${environment}/defs`;\n\n    if (identity) {\n      url += `?u=${encodeURIComponent(identity)}`;\n    }\n\n    return url;\n  }\n\n  async fetchFlags(): Promise<Flags> {\n    const url = this.getApiUrl();\n\n    if (!url || !this.config.appKey) {\n      if (this.config.isDebug) {\n        console.log('[Toggly Client] Using flag defaults (no appKey):', this.config.flagDefaults);\n      }\n      return { ...this.config.flagDefaults! };\n    }\n\n    try {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), this.config.connectTimeout);\n\n      const response = await fetch(url, {\n        method: 'GET',\n        headers: {\n          Accept: 'application/json',\n        },\n        cache: 'no-store',\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        throw new Error(`Failed to fetch flags: ${response.status} ${response.statusText}`);\n      }\n\n      const flags = (await response.json()) as Flags;\n\n      if (this.config.isDebug) {\n        console.log('[Toggly Client] Fetched flags:', flags);\n      }\n\n      return flags;\n    } catch (error) {\n      if (this.config.isDebug) {\n        console.error('[Toggly Client] Error fetching flags:', error);\n      }\n\n      // Fall back to cached flags or defaults\n      if (this.cache) {\n        if (this.config.isDebug) {\n          console.log('[Toggly Client] Using cached flags');\n        }\n        return { ...this.cache };\n      }\n\n      if (this.config.isDebug) {\n        console.log('[Toggly Client] Using flag defaults');\n      }\n\n      return { ...this.config.flagDefaults! };\n    }\n  }\n\n  async init(): Promise<void> {\n    try {\n      const flags = await this.fetchFlags();\n      this.cache = flags;\n      $flags.set(flags);\n      $isReady.set(true);\n      $error.set(null);\n\n      // Start refresh interval if configured\n      if (\n        this.config.featureFlagsRefreshInterval &&\n        this.config.featureFlagsRefreshInterval > 0\n      ) {\n        this.startRefreshInterval();\n      }\n    } catch (error) {\n      $error.set(error as Error);\n      $isReady.set(true); // Still mark as ready even on error\n      console.error('[Toggly Client] Initialization error:', error);\n    }\n  }\n\n  async refresh(): Promise<void> {\n    try {\n      const flags = await this.fetchFlags();\n      this.cache = flags;\n      $flags.set(flags);\n\n      if (this.config.isDebug) {\n        console.log('[Toggly Client] Flags refreshed');\n      }\n    } catch (error) {\n      console.error('[Toggly Client] Refresh error:', error);\n    }\n  }\n\n  private startRefreshInterval(): void {\n    if (this.refreshInterval) {\n      return;\n    }\n\n    this.refreshInterval = setInterval(() => {\n      this.refresh();\n    }, this.config.featureFlagsRefreshInterval!);\n\n    if (this.config.isDebug) {\n      console.log(\n        `[Toggly Client] Started refresh interval: ${this.config.featureFlagsRefreshInterval}ms`\n      );\n    }\n  }\n\n  stopRefreshInterval(): void {\n    if (this.refreshInterval) {\n      clearInterval(this.refreshInterval);\n      this.refreshInterval = null;\n\n      if (this.config.isDebug) {\n        console.log('[Toggly Client] Stopped refresh interval');\n      }\n    }\n  }\n\n  setIdentity(identity: string): void {\n    this.config.identity = identity;\n    this.refresh(); // Refresh with new identity\n  }\n\n  clearIdentity(): void {\n    this.config.identity = undefined;\n    this.refresh(); // Refresh without identity\n  }\n}\n\n/**\n * Initialize Toggly client with configuration\n * \n * @param config - Toggly configuration\n */\nexport async function initTogglyClient(config: TogglyConfig): Promise<void> {\n  if (clientInstance) {\n    console.warn('[Toggly Client] Client already initialized');\n    return;\n  }\n\n  clientInstance = new TogglyClientInstance(config);\n  await clientInstance.init();\n}\n\n/**\n * Manually refresh feature flags\n */\nexport async function refreshFlags(): Promise<void> {\n  if (!clientInstance) {\n    console.error('[Toggly Client] Client not initialized');\n    return;\n  }\n\n  await clientInstance.refresh();\n}\n\n/**\n * Set user identity for targeting\n * \n * @param identity - User identifier\n */\nexport function setIdentity(identity: string): void {\n  if (!clientInstance) {\n    console.error('[Toggly Client] Client not initialized');\n    return;\n  }\n\n  clientInstance.setIdentity(identity);\n}\n\n/**\n * Clear user identity\n */\nexport function clearIdentity(): void {\n  if (!clientInstance) {\n    console.error('[Toggly Client] Client not initialized');\n    return;\n  }\n\n  clientInstance.clearIdentity();\n}\n\n/**\n * Stop automatic refresh interval\n */\nexport function stopRefreshInterval(): void {\n  if (clientInstance) {\n    clientInstance.stopRefreshInterval();\n  }\n}\n\n/**\n * Create a computed atom for a specific feature flag\n * \n * @param key - Feature flag key\n * @param defaultValue - Default value if flag not found\n * @returns Readable atom with the flag value\n */\nexport function $flag(key: string, defaultValue: boolean = false): ReadableAtom<boolean> {\n  return computed($flags, (flags) => flags[key] ?? defaultValue);\n}\n\n/**\n * Create a computed atom that evaluates multiple feature flags\n * \n * @param keys - Array of feature flag keys\n * @param requirement - 'all' or 'any'\n * @param negate - Whether to negate the result\n * @returns Readable atom with the evaluation result\n */\nexport function $gate(\n  keys: string[],\n  requirement: 'all' | 'any' = 'all',\n  negate: boolean = false\n): ReadableAtom<boolean> {\n  return computed($flags, (flags) => {\n    if (keys.length === 0) {\n      return !negate;\n    }\n\n    let isEnabled: boolean;\n\n    if (requirement === 'any') {\n      isEnabled = keys.some((key) => flags[key] === true);\n    } else {\n      isEnabled = keys.every((key) => flags[key] === true);\n    }\n\n    return negate ? !isEnabled : isEnabled;\n  });\n}\n\n\n"],"mappings":"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","names":[]}