@hyphen/react-sdk 1.0.2 → 1.0.4

package/dist/index.cjs

@@ -0,0 +1,597 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Toggle: () => Toggle,
+  ToggleContext: () => ToggleContext,
+  ToggleProvider: () => ToggleProvider,
+  useToggle: () => useToggle,
+  withToggleProvider: () => withToggleProvider
+});
+module.exports = __toCommonJS(index_exports);
+
+// node_modules/.pnpm/@hyphen+browser-sdk@1.0.6/node_modules/@hyphen/browser-sdk/dist/index.js
+var import_hookified = require("hookified");
+var __defProp2 = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp2(target, "name", { value, configurable: true });
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var ToggleEvents = /* @__PURE__ */ (function(ToggleEvents2) {
+  ToggleEvents2["Error"] = "error";
+  return ToggleEvents2;
+})({});
+var _Toggle = class _Toggle2 extends import_hookified.Hookified {
+  constructor(options) {
+    super();
+    __publicField(this, "_publicApiKey");
+    __publicField(this, "_organizationId");
+    __publicField(this, "_applicationId");
+    __publicField(this, "_environment");
+    __publicField(this, "_horizonUrls", []);
+    __publicField(this, "_defaultContext");
+    __publicField(this, "_defaultTargetingKey", `${Math.random().toString(36).substring(7)}`);
+    if (options == null ? void 0 : options.applicationId) {
+      this._applicationId = options.applicationId;
+    }
+    if (options == null ? void 0 : options.environment) {
+      this._environment = options.environment;
+    } else {
+      this._environment = "development";
+    }
+    if (options == null ? void 0 : options.defaultContext) {
+      this._defaultContext = options.defaultContext;
+    }
+    if (options == null ? void 0 : options.publicApiKey) {
+      this._publicApiKey = options.publicApiKey;
+      this._organizationId = this.getOrgIdFromPublicKey(this._publicApiKey);
+    }
+    if (options == null ? void 0 : options.horizonUrls) {
+      this._horizonUrls = options.horizonUrls;
+    } else {
+      this._horizonUrls = this.getDefaultHorizonUrls(this._publicApiKey);
+    }
+    if (options == null ? void 0 : options.defaultTargetKey) {
+      this._defaultTargetingKey = options == null ? void 0 : options.defaultTargetKey;
+    } else {
+      if (this._defaultContext) {
+        this._defaultTargetingKey = this.getTargetingKey(this._defaultContext);
+      } else {
+        this._defaultTargetingKey = this.generateTargetKey();
+      }
+    }
+  }
+  /**
+  * Gets the public API key used for authentication.
+  *
+  * @returns The current public API key or undefined if not set
+  */
+  get publicApiKey() {
+    return this._publicApiKey;
+  }
+  /**
+  * Sets the public API key used for authentication.
+  *
+  * @param value - The public API key string or undefined to clear
+  * @throws {Error} If the key doesn't start with "public_"
+  */
+  set publicApiKey(value) {
+    this.setPublicKey(value);
+  }
+  /**
+  * Gets the default context used for toggle evaluations.
+  *
+  * @returns The current default ToggleContext
+  */
+  get defaultContext() {
+    return this._defaultContext;
+  }
+  /**
+  * Sets the default context used for toggle evaluations.
+  *
+  * @param value - The ToggleContext to use as default
+  */
+  set defaultContext(value) {
+    this._defaultContext = value;
+  }
+  /**
+  * Gets the organization ID extracted from the public API key.
+  *
+  * @returns The organization ID string or undefined if not available
+  */
+  get organizationId() {
+    return this._organizationId;
+  }
+  /**
+  * Gets the Horizon endpoint URLs used for load balancing.
+  *
+  * These URLs are used to distribute requests across multiple Horizon endpoints.
+  * If endpoints fail, the system will attempt to use the default horizon endpoint service.
+  *
+  * @returns Array of Horizon endpoint URLs
+  * @see {@link https://hyphen.ai/horizon} for more information
+  */
+  get horizonUrls() {
+    return this._horizonUrls;
+  }
+  /**
+  * Sets the Horizon endpoint URLs for load balancing.
+  *
+  * Configures multiple Horizon endpoints that will be used for load balancing.
+  * When endpoints fail, the system will fall back to the default horizon endpoint service.
+  *
+  * @param value - Array of Horizon endpoint URLs or empty array to clear
+  * @see {@link https://hyphen.ai/horizon} for more information
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle();
+  * toggle.horizonUrls = [
+  *   'https://org1.toggle.hyphen.cloud',
+  *   'https://org2.toggle.hyphen.cloud'
+  * ];
+  * ```
+  */
+  set horizonUrls(value) {
+    this._horizonUrls = value;
+  }
+  /**
+  * Gets the application ID used for toggle context.
+  *
+  * @returns The current application ID or undefined if not set
+  */
+  get applicationId() {
+    return this._applicationId;
+  }
+  /**
+  * Sets the application ID used for toggle context.
+  *
+  * @param value - The application ID string or undefined to clear
+  */
+  set applicationId(value) {
+    this._applicationId = value;
+  }
+  /**
+  * Gets the environment used for toggle context.
+  *
+  * @returns The current environment (defaults to 'development')
+  */
+  get environment() {
+    return this._environment;
+  }
+  /**
+  * Sets the environment used for toggle context.
+  *
+  * @param value - The environment string or undefined to clear
+  */
+  set environment(value) {
+    this._environment = value;
+  }
+  /**
+  * Gets the default targeting key used for toggle evaluations.
+  *
+  * @returns The current default targeting key or undefined if not set
+  */
+  get defaultTargetingKey() {
+    return this._defaultTargetingKey;
+  }
+  /**
+  * Sets the default targeting key used for toggle evaluations.
+  *
+  * @param value - The targeting key string or undefined to clear
+  */
+  set defaultTargetingKey(value) {
+    this._defaultTargetingKey = value;
+  }
+  async get(toggleKey, defaultValue, options) {
+    var _a, _b, _c, _d, _e, _f;
+    try {
+      const context = {
+        application: (_a = this._applicationId) != null ? _a : "",
+        environment: (_b = this._environment) != null ? _b : "development"
+      };
+      if (options == null ? void 0 : options.context) {
+        context.targetingKey = options == null ? void 0 : options.context.targetingKey;
+        context.ipAddress = options == null ? void 0 : options.context.ipAddress;
+        context.user = options == null ? void 0 : options.context.user;
+        context.customAttributes = options == null ? void 0 : options.context.customAttributes;
+      } else {
+        context.targetingKey = (_c = this._defaultContext) == null ? void 0 : _c.targetingKey;
+        context.ipAddress = (_d = this._defaultContext) == null ? void 0 : _d.ipAddress;
+        context.user = (_e = this._defaultContext) == null ? void 0 : _e.user;
+        context.customAttributes = (_f = this._defaultContext) == null ? void 0 : _f.customAttributes;
+      }
+      const fetchOptions = {
+        headers: {}
+      };
+      if (!context.targetingKey) {
+        context.targetingKey = this.getTargetingKey(context);
+      }
+      if (this._publicApiKey) {
+        fetchOptions.headers["x-api-key"] = this._publicApiKey;
+      } else {
+        throw new Error("You must set the publicApiKey");
+      }
+      if (context.application === "") {
+        throw new Error("You must set the applicationId");
+      }
+      const result = await this.fetch("/toggle/evaluate", context, fetchOptions);
+      if (result == null ? void 0 : result.toggles) {
+        return result.toggles[toggleKey].value;
+      }
+    } catch (error) {
+      this.emit(ToggleEvents.Error, error);
+    }
+    return defaultValue;
+  }
+  /**
+  * Retrieves a boolean toggle value.
+  *
+  * This is a convenience method that wraps the generic get() method with boolean type safety.
+  *
+  * @param toggleKey - The key of the toggle to retrieve
+  * @param defaultValue - The boolean value to return if the toggle is not found or an error occurs
+  * @param options - Optional configuration including context for toggle evaluation
+  * @returns Promise resolving to the boolean toggle value or defaultValue
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle({ publicApiKey: 'public_key', applicationId: 'app-id' });
+  * const isFeatureEnabled = await toggle.getBoolean('feature-flag', false);
+  * console.log(isFeatureEnabled); // true or false
+  * ```
+  */
+  async getBoolean(toggleKey, defaultValue, options) {
+    return this.get(toggleKey, defaultValue, options);
+  }
+  /**
+  * Retrieves a string toggle value.
+  *
+  * This is a convenience method that wraps the generic get() method with string type safety.
+  *
+  * @param toggleKey - The key of the toggle to retrieve
+  * @param defaultValue - The string value to return if the toggle is not found or an error occurs
+  * @param options - Optional configuration including context for toggle evaluation
+  * @returns Promise resolving to the string toggle value or defaultValue
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle({ publicApiKey: 'public_key', applicationId: 'app-id' });
+  * const message = await toggle.getString('welcome-message', 'Hello World');
+  * console.log(message); // 'Welcome to our app!' or 'Hello World'
+  * ```
+  */
+  async getString(toggleKey, defaultValue, options) {
+    return this.get(toggleKey, defaultValue, options);
+  }
+  /**
+  * Retrieves an object toggle value.
+  *
+  * This is a convenience method that wraps the generic get() method with object type safety.
+  * Note that the toggle service may return JSON as a string, which should be parsed if needed.
+  *
+  * @template T - The expected object type
+  * @param toggleKey - The key of the toggle to retrieve
+  * @param defaultValue - The object value to return if the toggle is not found or an error occurs
+  * @param options - Optional configuration including context for toggle evaluation
+  * @returns Promise resolving to the object toggle value or defaultValue
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle({ publicApiKey: 'public_key', applicationId: 'app-id' });
+  * const config = await toggle.getObject('app-config', { theme: 'light' });
+  * console.log(config); // { theme: 'dark', features: ['a', 'b'] } or { theme: 'light' }
+  * ```
+  */
+  async getObject(toggleKey, defaultValue, options) {
+    return this.get(toggleKey, defaultValue, options);
+  }
+  /**
+  * Retrieves a number toggle value.
+  *
+  * This is a convenience method that wraps the generic get() method with number type safety.
+  *
+  * @param toggleKey - The key of the toggle to retrieve
+  * @param defaultValue - The number value to return if the toggle is not found or an error occurs
+  * @param options - Optional configuration including context for toggle evaluation
+  * @returns Promise resolving to the number toggle value or defaultValue
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle({ publicApiKey: 'public_key', applicationId: 'app-id' });
+  * const maxRetries = await toggle.getNumber('max-retries', 3);
+  * console.log(maxRetries); // 5 or 3
+  * ```
+  */
+  async getNumber(toggleKey, defaultValue, options) {
+    return this.get(toggleKey, defaultValue, options);
+  }
+  /**
+  * Makes an HTTP POST request to the specified URL with automatic authentication.
+  *
+  * This method uses browser-compatible fetch and automatically includes the
+  * public API key in the x-api-key header if available. It supports load
+  * balancing across multiple horizon URLs with fallback behavior.
+  *
+  * @template T - The expected response type
+  * @param path - The API path to request (e.g., '/api/toggles')
+  * @param payload - The JSON payload to send in the request body
+  * @param options - Optional fetch configuration
+  * @returns Promise resolving to the parsed JSON response
+  * @throws {Error} If no horizon URLs are configured or all requests fail
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle({
+  *   publicApiKey: 'public_your-key-here',
+  *   horizonUrls: ['https://api.hyphen.cloud']
+  * });
+  *
+  * interface ToggleResponse {
+  *   enabled: boolean;
+  *   value: string;
+  * }
+  *
+  * const result = await toggle.fetch<ToggleResponse>('/api/toggle/feature-flag', {
+  *   context: { targetingKey: 'user-123' }
+  * });
+  * console.log(result.enabled); // true/false
+  * ```
+  */
+  async fetch(path, payload, options) {
+    if (this._horizonUrls.length === 0) {
+      throw new Error("No horizon URLs configured. Set horizonUrls or provide a valid publicApiKey.");
+    }
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (options == null ? void 0 : options.headers) {
+      if (options.headers instanceof Headers) {
+        options.headers.forEach((value, key) => {
+          headers[key] = value;
+        });
+      } else if (Array.isArray(options.headers)) {
+        options.headers.forEach(([key, value]) => {
+          headers[key] = value;
+        });
+      } else {
+        Object.assign(headers, options.headers);
+      }
+    }
+    if (this._publicApiKey) {
+      headers["x-api-key"] = this._publicApiKey;
+    }
+    const fetchOptions = {
+      method: "POST",
+      ...options,
+      headers,
+      body: payload ? JSON.stringify(payload) : options == null ? void 0 : options.body
+    };
+    const errors = [];
+    for (const baseUrl of this._horizonUrls) {
+      try {
+        const url = `${baseUrl.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
+        const response = await fetch(url, fetchOptions);
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data;
+      } catch (error) {
+        const fetchError = error instanceof Error ? error : new Error("Unknown fetch error");
+        errors.push(fetchError);
+      }
+    }
+    throw new Error(`All horizon URLs failed. Last errors: ${errors.map((e) => e.message).join(", ")}`);
+  }
+  /**
+  * Validates and sets the public API key. This is used internally
+  *
+  * @param key - The public API key string or undefined to clear
+  * @throws {Error} If the key doesn't start with "public_"
+  */
+  setPublicKey(key) {
+    if (key !== void 0 && !key.startsWith("public_")) {
+      throw new Error("Public API key must start with 'public_'");
+    }
+    this._publicApiKey = key;
+  }
+  /**
+  * Extracts the organization ID from a public API key.
+  *
+  * The public key format is: `public_<base64-encoded-data>`
+  * The base64 data contains: `orgId:secretData`
+  * Only alphanumeric characters, underscores, and hyphens are considered valid in org IDs.
+  *
+  * @param publicKey - The public API key to extract the organization ID from
+  * @returns The organization ID if valid and extractable, undefined otherwise
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle();
+  * const orgId = toggle.getOrgIdFromPublicKey('public_dGVzdC1vcmc6c2VjcmV0');
+  * console.log(orgId); // 'test-org'
+  * ```
+  */
+  getOrgIdFromPublicKey(publicKey) {
+    try {
+      const keyWithoutPrefix = publicKey.replace(/^public_/, "");
+      const decoded = globalThis.atob ? globalThis.atob(keyWithoutPrefix) : Buffer.from(keyWithoutPrefix, "base64").toString();
+      const [orgId] = decoded.split(":");
+      const isValidOrgId = /^[a-zA-Z0-9_-]+$/.test(orgId);
+      return isValidOrgId ? orgId : void 0;
+    } catch (e) {
+      return void 0;
+    }
+  }
+  /**
+  * Builds the default Horizon API URL for the given public key.
+  *
+  * If a valid organization ID can be extracted from the public key, returns an
+  * organization-specific URL. Otherwise, returns the default fallback URL.
+  *
+  * @param publicKey - The public API key to build the URL for
+  * @returns Organization-specific URL or default fallback URL
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle();
+  *
+  * // With valid org ID
+  * const orgUrl = toggle.buildDefaultHorizonUrl('public_dGVzdC1vcmc6c2VjcmV0');
+  * console.log(orgUrl); // 'https://test-org.toggle.hyphen.cloud'
+  *
+  * // With invalid key
+  * const defaultUrl = toggle.buildDefaultHorizonUrl('invalid-key');
+  * console.log(defaultUrl); // 'https://toggle.hyphen.cloud'
+  * ```
+  */
+  getDefaultHorizonUrl(publicKey) {
+    if (publicKey) {
+      const orgId = this.getOrgIdFromPublicKey(publicKey);
+      return orgId ? `https://${orgId}.toggle.hyphen.cloud` : "https://toggle.hyphen.cloud";
+    }
+    return "https://toggle.hyphen.cloud";
+  }
+  /**
+  * Will get the urls. If you pass in the public key it will provide two urls.
+  * @param publicKey
+  * @returns
+  */
+  getDefaultHorizonUrls(publicKey) {
+    let result = [
+      this.getDefaultHorizonUrl()
+    ];
+    if (publicKey) {
+      const defaultUrl = result[0];
+      const orgUrl = this.getDefaultHorizonUrl(publicKey);
+      result = [];
+      if (orgUrl !== defaultUrl) {
+        result.push(orgUrl);
+      }
+      result.push(defaultUrl);
+    }
+    return result;
+  }
+  /**
+  * Generates a unique targeting key based on available context.
+  *
+  * @returns A targeting key in the format: `[app]-[env]-[random]` or simplified versions
+  */
+  generateTargetKey() {
+    const randomSuffix = Math.random().toString(36).substring(7);
+    const app = this._applicationId || "";
+    const env = this._environment || "";
+    const components = [
+      app,
+      env,
+      randomSuffix
+    ].filter(Boolean);
+    return components.join("-");
+  }
+  /**
+  * Extracts targeting key from a toggle context with fallback logic.
+  *
+  * @param context - The toggle context to extract targeting key from
+  * @returns The targeting key string
+  */
+  getTargetingKey(context) {
+    if (context.targetingKey) {
+      return context.targetingKey;
+    }
+    if (context.user) {
+      return context.user.id;
+    }
+    return this._defaultTargetingKey;
+  }
+};
+__name(_Toggle, "Toggle");
+var Toggle = _Toggle;
+
+// src/toggle-provider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var ToggleContext = (0, import_react.createContext)(null);
+function ToggleProvider({
+  children,
+  publicApiKey,
+  applicationId,
+  environment,
+  defaultContext,
+  horizonUrls,
+  defaultTargetKey
+}) {
+  const toggle = (0, import_react.useMemo)(() => {
+    return new Toggle({
+      publicApiKey,
+      applicationId,
+      environment,
+      defaultContext,
+      horizonUrls,
+      defaultTargetKey
+    });
+  }, [
+    publicApiKey,
+    applicationId,
+    environment,
+    defaultContext,
+    horizonUrls,
+    defaultTargetKey
+  ]);
+  (0, import_react.useEffect)(() => {
+    return () => {
+    };
+  }, [toggle]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ToggleContext.Provider, { value: toggle, children });
+}
+
+// src/use-toggle.tsx
+var import_react2 = require("react");
+function useToggle() {
+  const toggle = (0, import_react2.useContext)(ToggleContext);
+  if (!toggle) {
+    throw new Error(
+      "useToggle must be used within a ToggleProvider. Wrap your component tree with <ToggleProvider> or use withToggleProvider()."
+    );
+  }
+  return toggle;
+}
+
+// src/with-toggle-provider.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function withToggleProvider(options) {
+  return function(Component) {
+    const WrappedComponent = (props) => {
+      return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(ToggleProvider, { ...options, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Component, { ...props }) });
+    };
+    const componentName = Component.displayName || Component.name || "Component";
+    WrappedComponent.displayName = `withToggleProvider(${componentName})`;
+    return WrappedComponent;
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Toggle,
+  ToggleContext,
+  ToggleProvider,
+  useToggle,
+  withToggleProvider
+});
+/* v8 ignore next -- @preserve */

package/dist/index.d.cts

@@ -0,0 +1,71 @@
+import { ToggleOptions, Toggle } from '@hyphen/browser-sdk';
+export { Toggle, ToggleOptions } from '@hyphen/browser-sdk';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, Context, ComponentType } from 'react';
+
+/**
+ * Props for the ToggleProvider component
+ * Extends ToggleOptions from @hyphen/browser-sdk
+ */
+interface ToggleProviderProps extends ToggleOptions {
+    /**
+     * React children to be wrapped by the provider
+     */
+    children: ReactNode;
+}
+
+/**
+ * React Context for the Toggle instance
+ */
+declare const ToggleContext: Context<Toggle | null>;
+/**
+ * Provider component that creates and provides a Toggle instance to the React tree
+ *
+ * @example
+ * ```tsx
+ * <ToggleProvider publicApiKey="public_..." applicationId="my-app">
+ *   <App />
+ * </ToggleProvider>
+ * ```
+ */
+declare function ToggleProvider({ children, publicApiKey, applicationId, environment, defaultContext, horizonUrls, defaultTargetKey, }: ToggleProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Hook to access the Toggle instance from the ToggleProvider
+ *
+ * @throws {Error} If used outside of a ToggleProvider
+ * @returns {Toggle} The Toggle instance from the provider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const toggle = useToggle();
+ *   const isEnabled = toggle.getBoolean('my-feature', false);
+ *
+ *   return <div>{isEnabled ? 'Feature enabled' : 'Feature disabled'}</div>;
+ * }
+ * ```
+ */
+declare function useToggle(): Toggle;
+
+/**
+ * Higher-order component that wraps a component with ToggleProvider
+ *
+ * @param options - Configuration options for the Toggle instance
+ * @returns A function that wraps a component with ToggleProvider
+ *
+ * @example
+ * ```tsx
+ * export default withToggleProvider({
+ *   publicApiKey: "public_...",
+ *   applicationId: "my-app",
+ *   environment: "production",
+ *   defaultContext: {
+ *     user: { id: "user-123" }
+ *   }
+ * })(App);
+ * ```
+ */
+declare function withToggleProvider(options: ToggleOptions): <P extends object>(Component: ComponentType<P>) => ComponentType<P>;
+
+export { ToggleContext, ToggleProvider, type ToggleProviderProps, useToggle, withToggleProvider };

package/dist/index.js

@@ -1,5 +1,499 @@
-// src/index.ts
-import { Toggle as Toggle2 } from "@hyphen/browser-sdk";
+// node_modules/.pnpm/@hyphen+browser-sdk@1.0.6/node_modules/@hyphen/browser-sdk/dist/index.js
+import { Hookified } from "hookified";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var ToggleEvents = /* @__PURE__ */ (function(ToggleEvents2) {
+  ToggleEvents2["Error"] = "error";
+  return ToggleEvents2;
+})({});
+var _Toggle = class _Toggle2 extends Hookified {
+  constructor(options) {
+    super();
+    __publicField(this, "_publicApiKey");
+    __publicField(this, "_organizationId");
+    __publicField(this, "_applicationId");
+    __publicField(this, "_environment");
+    __publicField(this, "_horizonUrls", []);
+    __publicField(this, "_defaultContext");
+    __publicField(this, "_defaultTargetingKey", `${Math.random().toString(36).substring(7)}`);
+    if (options == null ? void 0 : options.applicationId) {
+      this._applicationId = options.applicationId;
+    }
+    if (options == null ? void 0 : options.environment) {
+      this._environment = options.environment;
+    } else {
+      this._environment = "development";
+    }
+    if (options == null ? void 0 : options.defaultContext) {
+      this._defaultContext = options.defaultContext;
+    }
+    if (options == null ? void 0 : options.publicApiKey) {
+      this._publicApiKey = options.publicApiKey;
+      this._organizationId = this.getOrgIdFromPublicKey(this._publicApiKey);
+    }
+    if (options == null ? void 0 : options.horizonUrls) {
+      this._horizonUrls = options.horizonUrls;
+    } else {
+      this._horizonUrls = this.getDefaultHorizonUrls(this._publicApiKey);
+    }
+    if (options == null ? void 0 : options.defaultTargetKey) {
+      this._defaultTargetingKey = options == null ? void 0 : options.defaultTargetKey;
+    } else {
+      if (this._defaultContext) {
+        this._defaultTargetingKey = this.getTargetingKey(this._defaultContext);
+      } else {
+        this._defaultTargetingKey = this.generateTargetKey();
+      }
+    }
+  }
+  /**
+  * Gets the public API key used for authentication.
+  *
+  * @returns The current public API key or undefined if not set
+  */
+  get publicApiKey() {
+    return this._publicApiKey;
+  }
+  /**
+  * Sets the public API key used for authentication.
+  *
+  * @param value - The public API key string or undefined to clear
+  * @throws {Error} If the key doesn't start with "public_"
+  */
+  set publicApiKey(value) {
+    this.setPublicKey(value);
+  }
+  /**
+  * Gets the default context used for toggle evaluations.
+  *
+  * @returns The current default ToggleContext
+  */
+  get defaultContext() {
+    return this._defaultContext;
+  }
+  /**
+  * Sets the default context used for toggle evaluations.
+  *
+  * @param value - The ToggleContext to use as default
+  */
+  set defaultContext(value) {
+    this._defaultContext = value;
+  }
+  /**
+  * Gets the organization ID extracted from the public API key.
+  *
+  * @returns The organization ID string or undefined if not available
+  */
+  get organizationId() {
+    return this._organizationId;
+  }
+  /**
+  * Gets the Horizon endpoint URLs used for load balancing.
+  *
+  * These URLs are used to distribute requests across multiple Horizon endpoints.
+  * If endpoints fail, the system will attempt to use the default horizon endpoint service.
+  *
+  * @returns Array of Horizon endpoint URLs
+  * @see {@link https://hyphen.ai/horizon} for more information
+  */
+  get horizonUrls() {
+    return this._horizonUrls;
+  }
+  /**
+  * Sets the Horizon endpoint URLs for load balancing.
+  *
+  * Configures multiple Horizon endpoints that will be used for load balancing.
+  * When endpoints fail, the system will fall back to the default horizon endpoint service.
+  *
+  * @param value - Array of Horizon endpoint URLs or empty array to clear
+  * @see {@link https://hyphen.ai/horizon} for more information
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle();
+  * toggle.horizonUrls = [
+  *   'https://org1.toggle.hyphen.cloud',
+  *   'https://org2.toggle.hyphen.cloud'
+  * ];
+  * ```
+  */
+  set horizonUrls(value) {
+    this._horizonUrls = value;
+  }
+  /**
+  * Gets the application ID used for toggle context.
+  *
+  * @returns The current application ID or undefined if not set
+  */
+  get applicationId() {
+    return this._applicationId;
+  }
+  /**
+  * Sets the application ID used for toggle context.
+  *
+  * @param value - The application ID string or undefined to clear
+  */
+  set applicationId(value) {
+    this._applicationId = value;
+  }
+  /**
+  * Gets the environment used for toggle context.
+  *
+  * @returns The current environment (defaults to 'development')
+  */
+  get environment() {
+    return this._environment;
+  }
+  /**
+  * Sets the environment used for toggle context.
+  *
+  * @param value - The environment string or undefined to clear
+  */
+  set environment(value) {
+    this._environment = value;
+  }
+  /**
+  * Gets the default targeting key used for toggle evaluations.
+  *
+  * @returns The current default targeting key or undefined if not set
+  */
+  get defaultTargetingKey() {
+    return this._defaultTargetingKey;
+  }
+  /**
+  * Sets the default targeting key used for toggle evaluations.
+  *
+  * @param value - The targeting key string or undefined to clear
+  */
+  set defaultTargetingKey(value) {
+    this._defaultTargetingKey = value;
+  }
+  async get(toggleKey, defaultValue, options) {
+    var _a, _b, _c, _d, _e, _f;
+    try {
+      const context = {
+        application: (_a = this._applicationId) != null ? _a : "",
+        environment: (_b = this._environment) != null ? _b : "development"
+      };
+      if (options == null ? void 0 : options.context) {
+        context.targetingKey = options == null ? void 0 : options.context.targetingKey;
+        context.ipAddress = options == null ? void 0 : options.context.ipAddress;
+        context.user = options == null ? void 0 : options.context.user;
+        context.customAttributes = options == null ? void 0 : options.context.customAttributes;
+      } else {
+        context.targetingKey = (_c = this._defaultContext) == null ? void 0 : _c.targetingKey;
+        context.ipAddress = (_d = this._defaultContext) == null ? void 0 : _d.ipAddress;
+        context.user = (_e = this._defaultContext) == null ? void 0 : _e.user;
+        context.customAttributes = (_f = this._defaultContext) == null ? void 0 : _f.customAttributes;
+      }
+      const fetchOptions = {
+        headers: {}
+      };
+      if (!context.targetingKey) {
+        context.targetingKey = this.getTargetingKey(context);
+      }
+      if (this._publicApiKey) {
+        fetchOptions.headers["x-api-key"] = this._publicApiKey;
+      } else {
+        throw new Error("You must set the publicApiKey");
+      }
+      if (context.application === "") {
+        throw new Error("You must set the applicationId");
+      }
+      const result = await this.fetch("/toggle/evaluate", context, fetchOptions);
+      if (result == null ? void 0 : result.toggles) {
+        return result.toggles[toggleKey].value;
+      }
+    } catch (error) {
+      this.emit(ToggleEvents.Error, error);
+    }
+    return defaultValue;
+  }
+  /**
+  * Retrieves a boolean toggle value.
+  *
+  * This is a convenience method that wraps the generic get() method with boolean type safety.
+  *
+  * @param toggleKey - The key of the toggle to retrieve
+  * @param defaultValue - The boolean value to return if the toggle is not found or an error occurs
+  * @param options - Optional configuration including context for toggle evaluation
+  * @returns Promise resolving to the boolean toggle value or defaultValue
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle({ publicApiKey: 'public_key', applicationId: 'app-id' });
+  * const isFeatureEnabled = await toggle.getBoolean('feature-flag', false);
+  * console.log(isFeatureEnabled); // true or false
+  * ```
+  */
+  async getBoolean(toggleKey, defaultValue, options) {
+    return this.get(toggleKey, defaultValue, options);
+  }
+  /**
+  * Retrieves a string toggle value.
+  *
+  * This is a convenience method that wraps the generic get() method with string type safety.
+  *
+  * @param toggleKey - The key of the toggle to retrieve
+  * @param defaultValue - The string value to return if the toggle is not found or an error occurs
+  * @param options - Optional configuration including context for toggle evaluation
+  * @returns Promise resolving to the string toggle value or defaultValue
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle({ publicApiKey: 'public_key', applicationId: 'app-id' });
+  * const message = await toggle.getString('welcome-message', 'Hello World');
+  * console.log(message); // 'Welcome to our app!' or 'Hello World'
+  * ```
+  */
+  async getString(toggleKey, defaultValue, options) {
+    return this.get(toggleKey, defaultValue, options);
+  }
+  /**
+  * Retrieves an object toggle value.
+  *
+  * This is a convenience method that wraps the generic get() method with object type safety.
+  * Note that the toggle service may return JSON as a string, which should be parsed if needed.
+  *
+  * @template T - The expected object type
+  * @param toggleKey - The key of the toggle to retrieve
+  * @param defaultValue - The object value to return if the toggle is not found or an error occurs
+  * @param options - Optional configuration including context for toggle evaluation
+  * @returns Promise resolving to the object toggle value or defaultValue
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle({ publicApiKey: 'public_key', applicationId: 'app-id' });
+  * const config = await toggle.getObject('app-config', { theme: 'light' });
+  * console.log(config); // { theme: 'dark', features: ['a', 'b'] } or { theme: 'light' }
+  * ```
+  */
+  async getObject(toggleKey, defaultValue, options) {
+    return this.get(toggleKey, defaultValue, options);
+  }
+  /**
+  * Retrieves a number toggle value.
+  *
+  * This is a convenience method that wraps the generic get() method with number type safety.
+  *
+  * @param toggleKey - The key of the toggle to retrieve
+  * @param defaultValue - The number value to return if the toggle is not found or an error occurs
+  * @param options - Optional configuration including context for toggle evaluation
+  * @returns Promise resolving to the number toggle value or defaultValue
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle({ publicApiKey: 'public_key', applicationId: 'app-id' });
+  * const maxRetries = await toggle.getNumber('max-retries', 3);
+  * console.log(maxRetries); // 5 or 3
+  * ```
+  */
+  async getNumber(toggleKey, defaultValue, options) {
+    return this.get(toggleKey, defaultValue, options);
+  }
+  /**
+  * Makes an HTTP POST request to the specified URL with automatic authentication.
+  *
+  * This method uses browser-compatible fetch and automatically includes the
+  * public API key in the x-api-key header if available. It supports load
+  * balancing across multiple horizon URLs with fallback behavior.
+  *
+  * @template T - The expected response type
+  * @param path - The API path to request (e.g., '/api/toggles')
+  * @param payload - The JSON payload to send in the request body
+  * @param options - Optional fetch configuration
+  * @returns Promise resolving to the parsed JSON response
+  * @throws {Error} If no horizon URLs are configured or all requests fail
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle({
+  *   publicApiKey: 'public_your-key-here',
+  *   horizonUrls: ['https://api.hyphen.cloud']
+  * });
+  *
+  * interface ToggleResponse {
+  *   enabled: boolean;
+  *   value: string;
+  * }
+  *
+  * const result = await toggle.fetch<ToggleResponse>('/api/toggle/feature-flag', {
+  *   context: { targetingKey: 'user-123' }
+  * });
+  * console.log(result.enabled); // true/false
+  * ```
+  */
+  async fetch(path, payload, options) {
+    if (this._horizonUrls.length === 0) {
+      throw new Error("No horizon URLs configured. Set horizonUrls or provide a valid publicApiKey.");
+    }
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (options == null ? void 0 : options.headers) {
+      if (options.headers instanceof Headers) {
+        options.headers.forEach((value, key) => {
+          headers[key] = value;
+        });
+      } else if (Array.isArray(options.headers)) {
+        options.headers.forEach(([key, value]) => {
+          headers[key] = value;
+        });
+      } else {
+        Object.assign(headers, options.headers);
+      }
+    }
+    if (this._publicApiKey) {
+      headers["x-api-key"] = this._publicApiKey;
+    }
+    const fetchOptions = {
+      method: "POST",
+      ...options,
+      headers,
+      body: payload ? JSON.stringify(payload) : options == null ? void 0 : options.body
+    };
+    const errors = [];
+    for (const baseUrl of this._horizonUrls) {
+      try {
+        const url = `${baseUrl.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
+        const response = await fetch(url, fetchOptions);
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data;
+      } catch (error) {
+        const fetchError = error instanceof Error ? error : new Error("Unknown fetch error");
+        errors.push(fetchError);
+      }
+    }
+    throw new Error(`All horizon URLs failed. Last errors: ${errors.map((e) => e.message).join(", ")}`);
+  }
+  /**
+  * Validates and sets the public API key. This is used internally
+  *
+  * @param key - The public API key string or undefined to clear
+  * @throws {Error} If the key doesn't start with "public_"
+  */
+  setPublicKey(key) {
+    if (key !== void 0 && !key.startsWith("public_")) {
+      throw new Error("Public API key must start with 'public_'");
+    }
+    this._publicApiKey = key;
+  }
+  /**
+  * Extracts the organization ID from a public API key.
+  *
+  * The public key format is: `public_<base64-encoded-data>`
+  * The base64 data contains: `orgId:secretData`
+  * Only alphanumeric characters, underscores, and hyphens are considered valid in org IDs.
+  *
+  * @param publicKey - The public API key to extract the organization ID from
+  * @returns The organization ID if valid and extractable, undefined otherwise
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle();
+  * const orgId = toggle.getOrgIdFromPublicKey('public_dGVzdC1vcmc6c2VjcmV0');
+  * console.log(orgId); // 'test-org'
+  * ```
+  */
+  getOrgIdFromPublicKey(publicKey) {
+    try {
+      const keyWithoutPrefix = publicKey.replace(/^public_/, "");
+      const decoded = globalThis.atob ? globalThis.atob(keyWithoutPrefix) : Buffer.from(keyWithoutPrefix, "base64").toString();
+      const [orgId] = decoded.split(":");
+      const isValidOrgId = /^[a-zA-Z0-9_-]+$/.test(orgId);
+      return isValidOrgId ? orgId : void 0;
+    } catch (e) {
+      return void 0;
+    }
+  }
+  /**
+  * Builds the default Horizon API URL for the given public key.
+  *
+  * If a valid organization ID can be extracted from the public key, returns an
+  * organization-specific URL. Otherwise, returns the default fallback URL.
+  *
+  * @param publicKey - The public API key to build the URL for
+  * @returns Organization-specific URL or default fallback URL
+  *
+  * @example
+  * ```typescript
+  * const toggle = new Toggle();
+  *
+  * // With valid org ID
+  * const orgUrl = toggle.buildDefaultHorizonUrl('public_dGVzdC1vcmc6c2VjcmV0');
+  * console.log(orgUrl); // 'https://test-org.toggle.hyphen.cloud'
+  *
+  * // With invalid key
+  * const defaultUrl = toggle.buildDefaultHorizonUrl('invalid-key');
+  * console.log(defaultUrl); // 'https://toggle.hyphen.cloud'
+  * ```
+  */
+  getDefaultHorizonUrl(publicKey) {
+    if (publicKey) {
+      const orgId = this.getOrgIdFromPublicKey(publicKey);
+      return orgId ? `https://${orgId}.toggle.hyphen.cloud` : "https://toggle.hyphen.cloud";
+    }
+    return "https://toggle.hyphen.cloud";
+  }
+  /**
+  * Will get the urls. If you pass in the public key it will provide two urls.
+  * @param publicKey
+  * @returns
+  */
+  getDefaultHorizonUrls(publicKey) {
+    let result = [
+      this.getDefaultHorizonUrl()
+    ];
+    if (publicKey) {
+      const defaultUrl = result[0];
+      const orgUrl = this.getDefaultHorizonUrl(publicKey);
+      result = [];
+      if (orgUrl !== defaultUrl) {
+        result.push(orgUrl);
+      }
+      result.push(defaultUrl);
+    }
+    return result;
+  }
+  /**
+  * Generates a unique targeting key based on available context.
+  *
+  * @returns A targeting key in the format: `[app]-[env]-[random]` or simplified versions
+  */
+  generateTargetKey() {
+    const randomSuffix = Math.random().toString(36).substring(7);
+    const app = this._applicationId || "";
+    const env = this._environment || "";
+    const components = [
+      app,
+      env,
+      randomSuffix
+    ].filter(Boolean);
+    return components.join("-");
+  }
+  /**
+  * Extracts targeting key from a toggle context with fallback logic.
+  *
+  * @param context - The toggle context to extract targeting key from
+  * @returns The targeting key string
+  */
+  getTargetingKey(context) {
+    if (context.targetingKey) {
+      return context.targetingKey;
+    }
+    if (context.user) {
+      return context.user.id;
+    }
+    return this._defaultTargetingKey;
+  }
+};
+__name(_Toggle, "Toggle");
+var Toggle = _Toggle;
 
 // src/toggle-provider.tsx
 import {
@@ -7,7 +501,6 @@ import {
   useMemo,
   useEffect
 } from "react";
-import { Toggle } from "@hyphen/browser-sdk";
 import { jsx } from "react/jsx-runtime";
 var ToggleContext = createContext(null);
 function ToggleProvider({
@@ -68,7 +561,7 @@ function withToggleProvider(options) {
   };
 }
 export {
-  Toggle2 as Toggle,
+  Toggle,
   ToggleContext,
   ToggleProvider,
   useToggle,

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@hyphen/react-sdk",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Hyphen SDK for React",
   "type": "module",
+  "main": "dist/index.js",
   "module": "dist/index.js",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.cjs"
     }
   },
   "types": "dist/index.d.ts",
@@ -22,30 +24,30 @@
   "author": "Team Hyphen <hello@hyphen.ai>",
   "license": "MIT",
   "devDependencies": {
-    "@biomejs/biome": "2.3.10",
-    "@faker-js/faker": "10.1.0",
-    "@swc/core": "1.15.7",
+    "@biomejs/biome": "2.3.11",
+    "@faker-js/faker": "10.2.0",
+    "@swc/core": "1.15.8",
     "@testing-library/react": "16.3.1",
-    "@types/node": "25.0.3",
-    "@types/react": "19.2.7",
-    "@vitest/coverage-v8": "4.0.16",
+    "@types/node": "25.0.9",
+    "@types/react": "19.2.8",
+    "@vitest/coverage-v8": "4.0.17",
     "dotenv": "17.2.3",
-    "happy-dom": "20.0.11",
+    "happy-dom": "20.3.1",
     "react": "19.2.3",
     "react-dom": "19.2.3",
     "rimraf": "6.1.2",
     "tsd": "0.33.0",
     "tsup": "8.5.1",
     "typescript": "5.9.3",
-    "vitest": "4.0.16"
+    "vitest": "4.0.17"
   },
   "files": [
     "dist",
     "LICENSE"
   ],
   "dependencies": {
-    "@hyphen/browser-sdk": "1.0.5",
-    "hookified": "1.14.0"
+    "@hyphen/browser-sdk": "1.0.6",
+    "hookified": "1.15.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"