@hyphen/sdk 1.2.0 → 1.4.0

package/README.md

@@ -17,6 +17,8 @@ The Hyphen Node.js SDK is a JavaScript library that allows developers to easily
 	- [Toggle API](#toggle-api)
 	- [Toggle Hooks](#toggle-hooks)
 	- [Toggle Error Handling](#toggle-error-handling)
+	- [Toggle Caching](#toggle-caching)
+	- [Toggle Environment Variables](#toggle-environment-variables)
 	- [Toggle Self-Hosted](#toggle-self-hosted)
 - [Contributing](#contributing)
 - [Testing Your Changes](#testing-your-changes)
@@ -167,32 +169,32 @@ console.log('Boolean toggle value:', result); // true
 | *applicationId* | `string` | The application ID for your Hyphen project. You can find this in the Hyphen dashboard. |
 | *environment?* | `string` | The environment for your Hyphen project such as `production`. Default uses `process.env.NODE_ENV`  |
 | *context?* | `ToggleContext` | The context object that contains the user and custom attributes. This is optional. |
-| *cache?* | `{ ttl: number}` | Whether to use the cache or not. |
+| *caching?* | `{ ttl: number, generateCacheKeyFn: (context?: ToggleContext) => string}` | Whether to use the cache or not and a function to set the key. The `ttl` is in seconds |
 
 ## Toggle API
 
 | Method | Parameters | Description |
 |----------------|----------------|----------------|
 | *setContext* | `context: ToggleContext` | Set the context for the toggle. This is optional. |
-| *get<Type>* | `key: string, defaultValue: T, options?: ToggleRequestOptions` | Get the value of a toggle. This is a generic method that can be used to get any type from toggle. |
-| *getBoolean* | `key: string, defaultValue: boolean, options?: ToggleRequestOptions` | Get the value of a boolean toggle. |
-| *getNumber* | `key: string, defaultValue: number, options?: ToggleRequestOptions` | Get the value of a number toggle. |
-| *getString* | `key: string, defaultValue: string, options?: ToggleRequestOptions` | Get the value of a string toggle. |
-| *getObject<Type>* | `key: string, defaultValue: any, options?: ToggleRequestOptions` | Get the value of a object toggle. |
+| *get<Type>* | `key: string, defaultValue: T, options?: ToggleGetOptions` | Get the value of a toggle. This is a generic method that can be used to get any type from toggle. |
+| *getBoolean* | `key: string, defaultValue: boolean, options?: ToggleGetOptions` | Get the value of a boolean toggle. |
+| *getNumber* | `key: string, defaultValue: number, options?: ToggleGetOptions` | Get the value of a number toggle. |
+| *getString* | `key: string, defaultValue: string, options?: ToggleGetOptions` | Get the value of a string toggle. |
+| *getObject<Type>* | `key: string, defaultValue: any, options?: ToggleGetOptions` | Get the value of a object toggle. |
 
 ## Toggle Hooks
 
 The following hooks are available for Toggle:
 | Hook | object | Description |
 |----------------|----------------|----------------|
-| *beforeGetBoolean* | `{ key: string, defaultValue:boolean, options?: ToggleRequestOptions }` | Called before the boolean toggle is fetched. |
-| *afterGetBoolean* | `{ key: string, defaultValue:boolean, options?: ToggleRequestOptions, result: boolean }` | Called after the boolean toggle is fetched. |
-| *beforeGetNumber* | `{ key: string, defaultValue:number, options?: ToggleRequestOptions }` | Called before the number toggle is fetched. |
-| *afterGetNumber* | `{ key: string, defaultValue:number, options?: ToggleRequestOptions, result: number }` | Called after the number toggle is fetched. |
-| *beforeGetString* | `{ key: string, defaultValue:string, options?: ToggleRequestOptions }` | Called before the string toggle is fetched. |
-| *afterGetString* | `{ key: string, defaultValue:string, options?: ToggleRequestOptions, result: string }` | Called after the string toggle is fetched. |
-| *beforeGetObject* | `{ key: string, defaultValue:any, options?: ToggleRequestOptions }` | Called before the object toggle is fetched. |
-| *afterGetObject* | `{ key: string, defaultValue:any, options?: ToggleRequestOptions, result: any }` | Called after the object toggle is fetched. |
+| *beforeGetBoolean* | `{ key: string, defaultValue:boolean, options?: ToggleGetOptions }` | Called before the boolean toggle is fetched. |
+| *afterGetBoolean* | `{ key: string, defaultValue:boolean, options?: ToggleGetOptions, result: boolean }` | Called after the boolean toggle is fetched. |
+| *beforeGetNumber* | `{ key: string, defaultValue:number, options?: ToggleGetOptions }` | Called before the number toggle is fetched. |
+| *afterGetNumber* | `{ key: string, defaultValue:number, options?: ToggleGetOptions, result: number }` | Called after the number toggle is fetched. |
+| *beforeGetString* | `{ key: string, defaultValue:string, options?: ToggleGetOptions }` | Called before the string toggle is fetched. |
+| *afterGetString* | `{ key: string, defaultValue:string, options?: ToggleGetOptions, result: string }` | Called after the string toggle is fetched. |
+| *beforeGetObject* | `{ key: string, defaultValue:any, options?: ToggleGetOptions }` | Called before the object toggle is fetched. |
+| *afterGetObject* | `{ key: string, defaultValue:any, options?: ToggleGetOptions, result: any }` | Called after the object toggle is fetched. |
 
 You can use the hooks to modify the request or the response. For example, you can use the `beforeGetBoolean` hook to log the request before it is sent to the server.
 
@@ -311,6 +313,100 @@ try {
 }
 ```
 
+## Toggle Caching
+The SDK supports caching of toggle values to improve performance and reduce the number of requests made to the server. You can enable caching by providing a `caching` option in the constructor.
+
+```javascript
+import { Toggle, ToggleContext } from '@hyphen/sdk';
+
+const context: ToggleContext = {
+	targetingKey: 'user-123',
+	ipAddress: '203.0.113.42',
+	customAttributes: {
+		subscriptionLevel: 'premium',
+		region: 'us-east',
+	},
+	user: {
+		id: 'user-123',
+		email: 'john.doe@example.com',
+		name: 'John Doe',
+		customAttributes: {
+			role: 'admin',
+		},
+	},
+};
+
+const toggleOptions = {
+  publicApiKey: 'your_public_api_key',
+  applicationId: 'your_application_id',
+  context: context,
+  uris: [
+	'https://your-self-hosted-horizon-url',
+  ],
+  caching: {
+	ttl: 60, // Cache for 60 seconds
+};
+
+const toggle = new Toggle(toggleOptions);
+
+const result = await toggle.getBoolean('hyphen-sdk-boolean', false);
+console.log('Boolean toggle value:', result); // true
+```
+
+If you want to use a custom cache key generation function, you can provide a `generateCacheKeyFn` function in the `caching` option:
+
+```javascript
+import { Toggle, ToggleContext } from '@hyphen/sdk';
+
+const context: ToggleContext = {
+	targetingKey: 'user-123',
+	ipAddress: '203.0.113.42',
+	customAttributes: {
+		subscriptionLevel: 'premium',
+		region: 'us-east',
+	},
+	user: {
+		id: 'user-123',
+		email: 'john.doe@example.com',
+		name: 'John Doe',
+		customAttributes: {
+			role: 'admin',
+		},
+	},
+};
+
+const toggleOptions = {
+  publicApiKey: 'your_public_api_key',
+  applicationId: 'your_application_id',
+  context: context,
+  uris: [
+	'https://your-self-hosted-horizon-url',
+  ],
+  caching: {
+	ttl: 60, // Cache for 60 seconds
+	generateCacheKeyFn: (context) => {
+		return `toggle-${context?.targetingKey || 'default'}-hyphen-sdk-boolean`;
+	},
+  },
+};
+
+const toggle = new Toggle(toggleOptions);
+
+const result = await toggle.getBoolean('hyphen-sdk-boolean', false);
+console.log('Boolean toggle value:', result); // true
+```
+
+# Toggle Environment Variables
+
+You can also use environment variables to set the `publicApiKey` and `applicationId`. This is useful for keeping your API keys secure and not hardcoding them in your code. To do this just set your `.env` file with the following variables:
+
+```bash
+HYPHEN_PUBLIC_API_KEY=your_public_api_key
+HYPHEN_APPLICATION_ID=your_application_id
+```
+
+On initialization of the `Toggle` class, the SDK will automatically check for these environment variables and use them if they are set. If they are not set, you will need to provide them in the constructor.
+
 ## Toggle Self-Hosted
 
 Toggle uses [Horizon](https://hyphen.ai/horizon) to fetch the feature flags. If you are using a self-hosted version of Hyphen you can use the `uris` option in the constructor to set the url of your self-hosted version:

package/dist/index.cjs

@@ -39,8 +39,10 @@ module.exports = __toCommonJS(index_exports);
 // src/toggle.ts
 var import_node_process = __toESM(require("process"), 1);
 var import_hookified = require("hookified");
+var import_dotenv = __toESM(require("dotenv"), 1);
 var import_server_sdk = require("@openfeature/server-sdk");
 var import_openfeature_server_provider = require("@hyphen/openfeature-server-provider");
+import_dotenv.default.config();
 var ToggleHooks = /* @__PURE__ */ function(ToggleHooks2) {
   ToggleHooks2["beforeGetBoolean"] = "beforeGetBoolean";
   ToggleHooks2["afterGetBoolean"] = "afterGetBoolean";
@@ -56,36 +58,40 @@ var Toggle = class extends import_hookified.Hookified {
   static {
     __name(this, "Toggle");
   }
-  _applicationId;
-  _publicApiKey = "";
+  _applicationId = import_node_process.default.env.HYPHEN_APPLICATION_ID;
+  _publicApiKey = import_node_process.default.env.HYPHEN_PUBLIC_API_KEY;
   _environment;
   _client;
   _context;
   _throwErrors = false;
   _uris;
+  _caching;
   /*
    * Create a new Toggle instance. This will create a new client and set the options.
    * @param {ToggleOptions}
   */
   constructor(options) {
     super();
-    this._applicationId = options.applicationId;
-    this.setPublicApiKey(options.publicApiKey);
-    this._environment = options.environment ?? import_node_process.default.env.NODE_ENV ?? "development";
-    this._context = options.context;
-    this._throwErrors = options.throwErrors ?? false;
-    this._uris = options.uris;
+    this._throwErrors = options?.throwErrors ?? false;
+    this._applicationId = options?.applicationId;
+    if (options?.publicApiKey) {
+      this.setPublicApiKey(options.publicApiKey);
+    }
+    this._environment = options?.environment ?? import_node_process.default.env.NODE_ENV ?? "development";
+    this._context = options?.context;
+    this._uris = options?.uris;
+    this._caching = options?.caching;
   }
   /**
   * Get the application ID
-  * @returns {string}
+  * @returns {string | undefined}
   */
   get applicationId() {
     return this._applicationId;
   }
   /**
   * Set the application ID
-  * @param {string} value
+  * @param {string | undefined} value
   */
   set applicationId(value) {
     this._applicationId = value;
@@ -102,6 +108,11 @@ var Toggle = class extends import_hookified.Hookified {
   * @param {string} value
   */
   set publicApiKey(value) {
+    if (!value) {
+      this._publicApiKey = void 0;
+      this._client = void 0;
+      return;
+    }
     this.setPublicApiKey(value);
   }
   /**
@@ -161,11 +172,25 @@ var Toggle = class extends import_hookified.Hookified {
     this._uris = value;
   }
   /**
+  * Get the caching options.
+  * @returns {ToggleCachingOptions | undefined}
+  */
+  get caching() {
+    return this._caching;
+  }
+  /**
+  * Set the caching options.
+  * @param {ToggleCachingOptions | undefined} value
+  */
+  set caching(value) {
+    this._caching = value;
+  }
+  /**
   * This is a helper function to set the public API key. It will check if the key starts with public_ and set it. If it
-  * does set it will also set the client to undefined to force a new one to be created. If it does not, 
+  * does set it will also set the client to undefined to force a new one to be created. If it does not,
   * it will emit an error and console warning and not set the key. Used by the constructor and publicApiKey setter.
-  * @param key 
-  * @returns 
+  * @param key
+  * @returns
   */
   setPublicApiKey(key) {
     if (!key.startsWith("public_")) {
@@ -194,12 +219,28 @@ var Toggle = class extends import_hookified.Hookified {
   */
   async getClient() {
     if (!this._client) {
+      console.log("Application ID:", this._applicationId);
+      if (this._applicationId === void 0 || this._applicationId.length === 0) {
+        const errorMessage = "Application ID is not set. You must set it before using the client or have the HYPHEN_APPLICATION_ID environment variable set.";
+        this.emit("error", new Error(errorMessage));
+        if (this._throwErrors) {
+          throw new Error(errorMessage);
+        }
+      }
       const options = {
         application: this._applicationId,
         environment: this._environment,
-        horizonUrls: this._uris
+        horizonUrls: this._uris,
+        cache: this._caching
       };
-      await import_server_sdk.OpenFeature.setProviderAndWait(new import_openfeature_server_provider.HyphenProvider(this._publicApiKey, options));
+      if (this._publicApiKey && this._publicApiKey.length > 0) {
+        await import_server_sdk.OpenFeature.setProviderAndWait(new import_openfeature_server_provider.HyphenProvider(this._publicApiKey, options));
+      } else {
+        this.emit("error", new Error("Public API key is not set. You must set it before using the client or have the HYPHEN_PUBLIC_API_KEY environment variable set."));
+        if (this._throwErrors) {
+          throw new Error("Public API key is not set");
+        }
+      }
       this._client = import_server_sdk.OpenFeature.getClient(this._context);
     }
     return this._client;

package/dist/index.d.cts

@@ -12,17 +12,21 @@ declare enum ToggleHooks {
     beforeGetObject = "beforeGetObject",
     afterGetObject = "afterGetObject"
 }
+type ToggleCachingOptions = {
+    ttl?: number;
+    generateCacheKeyFn?: (context?: ToggleContext) => string;
+};
 type ToggleOptions = {
     /**
-     * Your application name
+     * Your application name. If this is not set it will look for the HYPHEN_APPLICATION_ID environment variable.
      * @type {string}
      */
-    applicationId: string;
+    applicationId?: string;
     /**
-     * Your Hyphen Public API key
+     * Your Hyphen Public API key. If this is not set it will look for the HYPHEN_PUBLIC_API_KEY environment variable.
      * @type {string}
      */
-    publicApiKey: string;
+    publicApiKey?: string;
     /**
      * Your environment name such as development, production. Default is what is set at NODE_ENV
      * @type {string}
@@ -34,13 +38,11 @@ type ToggleOptions = {
      * @type {ToggleContext}
      */
     context?: ToggleContext;
-    caching?: {
-        /**
-         * The time in seconds to cache the feature flag values
-         * @type {number} - this is in milliseconds
-         */
-        ttl?: number;
-    };
+    /**
+     * Cache options to use for the request
+     * @type {ToggleCachingOptions}
+     */
+    caching?: ToggleCachingOptions;
     /**
      * Throw errors in addition to emitting them
      * @type {boolean}
@@ -55,7 +57,7 @@ type ToggleOptions = {
      */
     uris?: string[];
 };
-type ToggleRequestOptions = {
+type ToggleGetOptions = {
     /**
      * The context to use for evaluating feature flags
      * @type {ToggleContext}
@@ -69,28 +71,29 @@ declare class Toggle extends Hookified {
     private _client;
     private _context;
     private _throwErrors;
-    private _uris?;
-    constructor(options: ToggleOptions);
+    private _uris;
+    private _caching;
+    constructor(options?: ToggleOptions);
     /**
      * Get the application ID
-     * @returns {string}
+     * @returns {string | undefined}
      */
-    get applicationId(): string;
+    get applicationId(): string | undefined;
     /**
      * Set the application ID
-     * @param {string} value
+     * @param {string | undefined} value
      */
-    set applicationId(value: string);
+    set applicationId(value: string | undefined);
     /**
      * Get the public API key
      * @returns {string}
      */
-    get publicApiKey(): string;
+    get publicApiKey(): string | undefined;
     /**
      * Set the public API key
      * @param {string} value
      */
-    set publicApiKey(value: string);
+    set publicApiKey(value: string | undefined);
     /**
      * Get the environment
      * @returns {string}
@@ -131,6 +134,16 @@ declare class Toggle extends Hookified {
      * @param {Array<string>} value
      */
     set uris(value: string[] | undefined);
+    /**
+     * Get the caching options.
+     * @returns {ToggleCachingOptions | undefined}
+     */
+    get caching(): ToggleCachingOptions | undefined;
+    /**
+     * Set the caching options.
+     * @param {ToggleCachingOptions | undefined} value
+     */
+    set caching(value: ToggleCachingOptions | undefined);
     /**
      * This is a helper function to set the public API key. It will check if the key starts with public_ and set it. If it
      * does set it will also set the client to undefined to force a new one to be created. If it does not,
@@ -159,7 +172,7 @@ declare class Toggle extends Hookified {
      * @param {ToggleRequestOptions} options - The options to use for the request. This can be used to override the context.
      * @returns {Promise<T>}
      */
-    get<T>(key: string, defaultValue: T, options?: ToggleRequestOptions): Promise<T>;
+    get<T>(key: string, defaultValue: T, options?: ToggleGetOptions): Promise<T>;
     /**
      * Get a boolean value from the feature flag. This will check the type of the default value and call the
      * appropriate function. It will also set the context if it is not set.
@@ -168,7 +181,7 @@ declare class Toggle extends Hookified {
      * @param {ToggleRequestOptions} options - The options to use for the request. This can be used to override the context.
      * @returns {Promise<boolean>} - The value of the feature flag
      */
-    getBoolean(key: string, defaultValue: boolean, options?: ToggleRequestOptions): Promise<boolean>;
+    getBoolean(key: string, defaultValue: boolean, options?: ToggleGetOptions): Promise<boolean>;
     /**
      * Get a string value from the feature flag.
      * @param {string} key - The key of the feature flag
@@ -176,8 +189,8 @@ declare class Toggle extends Hookified {
      * @param {ToggleRequestOptions} options - The options to use for the request. This can be used to override the context.
      * @returns {Promise<string>} - The value of the feature flag
      */
-    getString(key: string, defaultValue: string, options?: ToggleRequestOptions): Promise<string>;
-    getNumber(key: string, defaultValue: number, options?: ToggleRequestOptions): Promise<number>;
+    getString(key: string, defaultValue: string, options?: ToggleGetOptions): Promise<string>;
+    getNumber(key: string, defaultValue: number, options?: ToggleGetOptions): Promise<number>;
     /**
      * Get an object value from the feature flag. This will check the type of the default value and call the
      * appropriate function. It will also set the context if it is not set.
@@ -186,7 +199,7 @@ declare class Toggle extends Hookified {
      * @param {ToggleRequestOptions} options - The options to use for the request. This can be used to override the context.
      * @returns {Promise<T>} - The value of the feature flag
      */
-    getObject<T>(key: string, defaultValue: T, options?: ToggleRequestOptions): Promise<T>;
+    getObject<T>(key: string, defaultValue: T, options?: ToggleGetOptions): Promise<T>;
 }
 
-export { Toggle, type ToggleContext, ToggleHooks, type ToggleOptions, type ToggleRequestOptions };
+export { Toggle, type ToggleCachingOptions, type ToggleContext, type ToggleGetOptions, ToggleHooks, type ToggleOptions };

package/dist/index.d.ts

@@ -12,17 +12,21 @@ declare enum ToggleHooks {
     beforeGetObject = "beforeGetObject",
     afterGetObject = "afterGetObject"
 }
+type ToggleCachingOptions = {
+    ttl?: number;
+    generateCacheKeyFn?: (context?: ToggleContext) => string;
+};
 type ToggleOptions = {
     /**
-     * Your application name
+     * Your application name. If this is not set it will look for the HYPHEN_APPLICATION_ID environment variable.
      * @type {string}
      */
-    applicationId: string;
+    applicationId?: string;
     /**
-     * Your Hyphen Public API key
+     * Your Hyphen Public API key. If this is not set it will look for the HYPHEN_PUBLIC_API_KEY environment variable.
      * @type {string}
      */
-    publicApiKey: string;
+    publicApiKey?: string;
     /**
      * Your environment name such as development, production. Default is what is set at NODE_ENV
      * @type {string}
@@ -34,13 +38,11 @@ type ToggleOptions = {
      * @type {ToggleContext}
      */
     context?: ToggleContext;
-    caching?: {
-        /**
-         * The time in seconds to cache the feature flag values
-         * @type {number} - this is in milliseconds
-         */
-        ttl?: number;
-    };
+    /**
+     * Cache options to use for the request
+     * @type {ToggleCachingOptions}
+     */
+    caching?: ToggleCachingOptions;
     /**
      * Throw errors in addition to emitting them
      * @type {boolean}
@@ -55,7 +57,7 @@ type ToggleOptions = {
      */
     uris?: string[];
 };
-type ToggleRequestOptions = {
+type ToggleGetOptions = {
     /**
      * The context to use for evaluating feature flags
      * @type {ToggleContext}
@@ -69,28 +71,29 @@ declare class Toggle extends Hookified {
     private _client;
     private _context;
     private _throwErrors;
-    private _uris?;
-    constructor(options: ToggleOptions);
+    private _uris;
+    private _caching;
+    constructor(options?: ToggleOptions);
     /**
      * Get the application ID
-     * @returns {string}
+     * @returns {string | undefined}
      */
-    get applicationId(): string;
+    get applicationId(): string | undefined;
     /**
      * Set the application ID
-     * @param {string} value
+     * @param {string | undefined} value
      */
-    set applicationId(value: string);
+    set applicationId(value: string | undefined);
     /**
      * Get the public API key
      * @returns {string}
      */
-    get publicApiKey(): string;
+    get publicApiKey(): string | undefined;
     /**
      * Set the public API key
      * @param {string} value
      */
-    set publicApiKey(value: string);
+    set publicApiKey(value: string | undefined);
     /**
      * Get the environment
      * @returns {string}
@@ -131,6 +134,16 @@ declare class Toggle extends Hookified {
      * @param {Array<string>} value
      */
     set uris(value: string[] | undefined);
+    /**
+     * Get the caching options.
+     * @returns {ToggleCachingOptions | undefined}
+     */
+    get caching(): ToggleCachingOptions | undefined;
+    /**
+     * Set the caching options.
+     * @param {ToggleCachingOptions | undefined} value
+     */
+    set caching(value: ToggleCachingOptions | undefined);
     /**
      * This is a helper function to set the public API key. It will check if the key starts with public_ and set it. If it
      * does set it will also set the client to undefined to force a new one to be created. If it does not,
@@ -159,7 +172,7 @@ declare class Toggle extends Hookified {
      * @param {ToggleRequestOptions} options - The options to use for the request. This can be used to override the context.
      * @returns {Promise<T>}
      */
-    get<T>(key: string, defaultValue: T, options?: ToggleRequestOptions): Promise<T>;
+    get<T>(key: string, defaultValue: T, options?: ToggleGetOptions): Promise<T>;
     /**
      * Get a boolean value from the feature flag. This will check the type of the default value and call the
      * appropriate function. It will also set the context if it is not set.
@@ -168,7 +181,7 @@ declare class Toggle extends Hookified {
      * @param {ToggleRequestOptions} options - The options to use for the request. This can be used to override the context.
      * @returns {Promise<boolean>} - The value of the feature flag
      */
-    getBoolean(key: string, defaultValue: boolean, options?: ToggleRequestOptions): Promise<boolean>;
+    getBoolean(key: string, defaultValue: boolean, options?: ToggleGetOptions): Promise<boolean>;
     /**
      * Get a string value from the feature flag.
      * @param {string} key - The key of the feature flag
@@ -176,8 +189,8 @@ declare class Toggle extends Hookified {
      * @param {ToggleRequestOptions} options - The options to use for the request. This can be used to override the context.
      * @returns {Promise<string>} - The value of the feature flag
      */
-    getString(key: string, defaultValue: string, options?: ToggleRequestOptions): Promise<string>;
-    getNumber(key: string, defaultValue: number, options?: ToggleRequestOptions): Promise<number>;
+    getString(key: string, defaultValue: string, options?: ToggleGetOptions): Promise<string>;
+    getNumber(key: string, defaultValue: number, options?: ToggleGetOptions): Promise<number>;
     /**
      * Get an object value from the feature flag. This will check the type of the default value and call the
      * appropriate function. It will also set the context if it is not set.
@@ -186,7 +199,7 @@ declare class Toggle extends Hookified {
      * @param {ToggleRequestOptions} options - The options to use for the request. This can be used to override the context.
      * @returns {Promise<T>} - The value of the feature flag
      */
-    getObject<T>(key: string, defaultValue: T, options?: ToggleRequestOptions): Promise<T>;
+    getObject<T>(key: string, defaultValue: T, options?: ToggleGetOptions): Promise<T>;
 }
 
-export { Toggle, type ToggleContext, ToggleHooks, type ToggleOptions, type ToggleRequestOptions };
+export { Toggle, type ToggleCachingOptions, type ToggleContext, type ToggleGetOptions, ToggleHooks, type ToggleOptions };

package/dist/index.js

@@ -4,8 +4,10 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 // src/toggle.ts
 import process from "process";
 import { Hookified } from "hookified";
+import dotenv from "dotenv";
 import { OpenFeature } from "@openfeature/server-sdk";
 import { HyphenProvider } from "@hyphen/openfeature-server-provider";
+dotenv.config();
 var ToggleHooks = /* @__PURE__ */ function(ToggleHooks2) {
   ToggleHooks2["beforeGetBoolean"] = "beforeGetBoolean";
   ToggleHooks2["afterGetBoolean"] = "afterGetBoolean";
@@ -21,36 +23,40 @@ var Toggle = class extends Hookified {
   static {
     __name(this, "Toggle");
   }
-  _applicationId;
-  _publicApiKey = "";
+  _applicationId = process.env.HYPHEN_APPLICATION_ID;
+  _publicApiKey = process.env.HYPHEN_PUBLIC_API_KEY;
   _environment;
   _client;
   _context;
   _throwErrors = false;
   _uris;
+  _caching;
   /*
    * Create a new Toggle instance. This will create a new client and set the options.
    * @param {ToggleOptions}
   */
   constructor(options) {
     super();
-    this._applicationId = options.applicationId;
-    this.setPublicApiKey(options.publicApiKey);
-    this._environment = options.environment ?? process.env.NODE_ENV ?? "development";
-    this._context = options.context;
-    this._throwErrors = options.throwErrors ?? false;
-    this._uris = options.uris;
+    this._throwErrors = options?.throwErrors ?? false;
+    this._applicationId = options?.applicationId;
+    if (options?.publicApiKey) {
+      this.setPublicApiKey(options.publicApiKey);
+    }
+    this._environment = options?.environment ?? process.env.NODE_ENV ?? "development";
+    this._context = options?.context;
+    this._uris = options?.uris;
+    this._caching = options?.caching;
   }
   /**
   * Get the application ID
-  * @returns {string}
+  * @returns {string | undefined}
   */
   get applicationId() {
     return this._applicationId;
   }
   /**
   * Set the application ID
-  * @param {string} value
+  * @param {string | undefined} value
   */
   set applicationId(value) {
     this._applicationId = value;
@@ -67,6 +73,11 @@ var Toggle = class extends Hookified {
   * @param {string} value
   */
   set publicApiKey(value) {
+    if (!value) {
+      this._publicApiKey = void 0;
+      this._client = void 0;
+      return;
+    }
     this.setPublicApiKey(value);
   }
   /**
@@ -126,11 +137,25 @@ var Toggle = class extends Hookified {
     this._uris = value;
   }
   /**
+  * Get the caching options.
+  * @returns {ToggleCachingOptions | undefined}
+  */
+  get caching() {
+    return this._caching;
+  }
+  /**
+  * Set the caching options.
+  * @param {ToggleCachingOptions | undefined} value
+  */
+  set caching(value) {
+    this._caching = value;
+  }
+  /**
   * This is a helper function to set the public API key. It will check if the key starts with public_ and set it. If it
-  * does set it will also set the client to undefined to force a new one to be created. If it does not, 
+  * does set it will also set the client to undefined to force a new one to be created. If it does not,
   * it will emit an error and console warning and not set the key. Used by the constructor and publicApiKey setter.
-  * @param key 
-  * @returns 
+  * @param key
+  * @returns
   */
   setPublicApiKey(key) {
     if (!key.startsWith("public_")) {
@@ -159,12 +184,28 @@ var Toggle = class extends Hookified {
   */
   async getClient() {
     if (!this._client) {
+      console.log("Application ID:", this._applicationId);
+      if (this._applicationId === void 0 || this._applicationId.length === 0) {
+        const errorMessage = "Application ID is not set. You must set it before using the client or have the HYPHEN_APPLICATION_ID environment variable set.";
+        this.emit("error", new Error(errorMessage));
+        if (this._throwErrors) {
+          throw new Error(errorMessage);
+        }
+      }
       const options = {
         application: this._applicationId,
         environment: this._environment,
-        horizonUrls: this._uris
+        horizonUrls: this._uris,
+        cache: this._caching
       };
-      await OpenFeature.setProviderAndWait(new HyphenProvider(this._publicApiKey, options));
+      if (this._publicApiKey && this._publicApiKey.length > 0) {
+        await OpenFeature.setProviderAndWait(new HyphenProvider(this._publicApiKey, options));
+      } else {
+        this.emit("error", new Error("Public API key is not set. You must set it before using the client or have the HYPHEN_PUBLIC_API_KEY environment variable set."));
+        if (this._throwErrors) {
+          throw new Error("Public API key is not set");
+        }
+      }
       this._client = OpenFeature.getClient(this._context);
     }
     return this._client;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyphen/sdk",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Hyphen SDK for Node.js",
   "type": "module",
   "main": "dist/index.cjs",
@@ -11,12 +11,12 @@
       "require": "./dist/index.cjs"
     }
   },
-  "types": "dist/node/index.d.ts",
+  "types": "dist/index.d.ts",
   "scripts": {
     "test": "xo --fix && vitest run --coverage",
     "test:ci": "xo && vitest run --coverage",
     "build": "rimraf ./dist && tsup src/index.ts --format esm,cjs --dts --clean",
-    "clean": "rimraf ./dist",
+    "clean": "rimraf ./dist pnpm-lock.yaml node_modules coverage",
     "prepublishOnly": "rimraf ./dist && tsup src/index.ts --format esm,cjs --dts --clean"
   },
   "keywords": [
@@ -29,15 +29,15 @@
   "author": "Team Hyphen <hello@hyphen.ai>",
   "license": "MIT",
   "devDependencies": {
-    "@swc/core": "^1.11.24",
-    "@types/node": "^22.15.17",
-    "@vitest/coverage-v8": "^3.1.3",
+    "@swc/core": "^1.11.29",
+    "@types/node": "^22.15.21",
+    "@vitest/coverage-v8": "^3.1.4",
     "rimraf": "^6.0.1",
     "tsd": "^0.32.0",
-    "tsup": "^8.4.0",
+    "tsup": "^8.5.0",
     "typescript": "^5.8.3",
-    "vitest": "^3.1.3",
-    "xo": "^0.60.0"
+    "vitest": "^3.1.4",
+    "xo": "^1.0.0"
   },
   "files": [
     "dist",