@hyphen/sdk 1.0.0 → 1.0.2

package/README.md

@@ -9,6 +9,19 @@
 
 The Hyphen Node.js SDK is a JavaScript library that allows developers to easily integrate Hyphen's feature flagging and experimentation capabilities into their Node.js applications. With this SDK, you can manage feature flags more effectively, enabling you to control the rollout of new features and conduct A/B testing with ease.
 
+# Table of Contents
+- [Hyphen Node.js SDK](#hyphen-nodejs-sdk)
+- [Installation](#installation)
+- [Basic Usage](#basic-usage)
+- [Toggle](#toggle)
+	- [Toggle Options](#toggle-options)
+	- [Toggle API](#toggle-api)
+	- [Toggle Hooks](#toggle-hooks)
+	- [Toggle Error Handling](#toggle-error-handling)
+- [Contributing](#contributing)
+	- [Testing Your Changes](#testing-your-changes)
+- [License and Copyright](#license-and-copyright)
+
 # Installation
 
 To install the Hyphen Node.js SDK, you can use npm or yarn. Run the following command in your terminal:
@@ -17,7 +30,7 @@ To install the Hyphen Node.js SDK, you can use npm or yarn. Run the following co
 npm install @hyphen/sdk
 ```
 
-# Usage
+# Basic Usage
 
 There are many ways to use the Hyphen Node.js SDK. Because of this we have created examples for each of the different ways in each secton of the documentation.
 
@@ -26,9 +39,9 @@ There are many ways to use the Hyphen Node.js SDK. Because of this we have creat
 [Toggle](https://hyphen.ai/toggle) is our feature flag service that allows you to control the rollout of new features to your users. You can access your feature flags using the `Toggle` class.
 
 ```javascript
-import { Toggle, Context } from '@hyphen/sdk';
+import { Toggle, ToggleContext } from '@hyphen/sdk';
 
-const context: Context = {
+const context: ToggleContext = {
 	targetingKey: 'user-123',
 	ipAddress: '203.0.113.42',
 	customAttributes: {
@@ -61,9 +74,9 @@ console.log('Boolean toggle value:', result); // true
 if you want to set the context you can do it like this:
 
 ```javascript
-import { Toggle, Context } from '@hyphen/sdk';
+import { Toggle, ToggleContext } from '@hyphen/sdk';
 
-const context: Context = {
+const context: ToggleContext = {
 	targetingKey: 'user-123',
 	ipAddress: '203.0.113.42',
 	customAttributes: {
@@ -97,9 +110,9 @@ console.log('Boolean toggle value:', result); // true
 if you would like to override the context for a single request you can do it like this:
 
 ```javascript
-import { Toggle, Context } from '@hyphen/sdk';
+import { Toggle, ToggleContext } from '@hyphen/sdk';
 
-const context: Context = {
+const context: ToggleContext = {
 	targetingKey: 'user-123',
 	ipAddress: '203.0.113.42',
 	customAttributes: {
@@ -122,7 +135,7 @@ const toggleOptions = {
   context: context,
 };
 
-const overrideContext: Context = {
+const overrideContext: ToggleContext = {
 	targetingKey: 'user-123',
 	ipAddress: '203.0.113.42',
 	customAttributes: {
@@ -153,19 +166,19 @@ console.log('Boolean toggle value:', result); // true
 | *publicApiKey* | ` string` | The public API key for your Hyphen project. You can find this in the Hyphen dashboard. |
 | *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?* | `Context` | The context object that contains the user and custom attributes. This is optional. |
+| *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. |
 
 ## Toggle API
 
 | Method | Parameters | Description |
 |----------------|----------------|----------------|
-| *setContext* | `context: Context` | Set the context for the toggle. This is optional. |
-| *get<Type>* | `key: string, defaultValue: T, options?: { context?: Context }` | 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?: { context?: Context }` | Get the value of a boolean toggle. |
-| *getNumber* | `key: string, defaultValue: number, options?: { context?: Context }` | Get the value of a number toggle. |
-| *getString* | `key: string, defaultValue: string, options?: { context?: Context }` | Get the value of a string toggle. |
-| *getObject<Type>* | `key: string, defaultValue: any, options?: { context?: Context }` | Get the value of a object toggle. |
+| *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. |
 
 ## Toggle Hooks
 
@@ -184,9 +197,9 @@ The following hooks are available for Toggle:
 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.
 
 ```javascript
-import { Toggle, ToggleHooks, Context } from '@hyphen/sdk';
+import { Toggle, ToggleHooks, ToggleContext } from '@hyphen/sdk';
 
-const context: Context = {
+const context: ToggleContext = {
 	targetingKey: 'user-123',
 	ipAddress: '203.0.113.42',
 	customAttributes: {
@@ -220,6 +233,84 @@ const result = await toggle.getBoolean('hyphen-sdk-boolean', false);
 console.log('Boolean toggle value:', result); // true
 ```
 
+## Toggle Error Handling
+
+The SDK provides a way to handle errors that occur during the toggle request. You can use the `.on` method to handle errors globally.
+
+```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,
+};
+
+const toggle = new Toggle(toggleOptions);
+toggle.on('error', (error) => {
+  console.error('Error fetching toggle:', error);
+});
+
+const result = await toggle.getBoolean('hyphen-sdk-boolean', false);
+console.log('Boolean toggle value:', result); // true
+```
+
+If you would like to have the errors thrown you can use the `throwErrors` 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,
+  throwErrors: true,
+};
+
+const toggle = new Toggle(toggleOptions);
+
+try {
+  const result = await toggle.getBoolean('hyphen-sdk-boolean', false);
+  console.log('Boolean toggle value:', result); // true
+} catch (error) {
+  console.error('Error fetching toggle:', error);
+}
+```
+
 # Contributing
 
 We welcome contributions to the Hyphen Node.js SDK! If you have an idea for a new feature, bug fix, or improvement, please follow these steps:

package/dist/index.cjs

@@ -0,0 +1,243 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Toggle: () => Toggle,
+  ToggleHooks: () => ToggleHooks
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/toggle.ts
+var import_node_process = __toESM(require("process"), 1);
+var import_hookified = require("hookified");
+var import_server_sdk = require("@openfeature/server-sdk");
+var import_openfeature_server_provider = require("@hyphen/openfeature-server-provider");
+var ToggleHooks = /* @__PURE__ */ function(ToggleHooks2) {
+  ToggleHooks2["beforeGetBoolean"] = "beforeGetBoolean";
+  ToggleHooks2["afterGetBoolean"] = "afterGetBoolean";
+  ToggleHooks2["beforeGetString"] = "beforeGetString";
+  ToggleHooks2["afterGetString"] = "afterGetString";
+  ToggleHooks2["beforeGetNumber"] = "beforeGetNumber";
+  ToggleHooks2["afterGetNumber"] = "afterGetNumber";
+  ToggleHooks2["beforeGetObject"] = "beforeGetObject";
+  ToggleHooks2["afterGetObject"] = "afterGetObject";
+  return ToggleHooks2;
+}({});
+var Toggle = class extends import_hookified.Hookified {
+  static {
+    __name(this, "Toggle");
+  }
+  _applicationId;
+  _publicKey;
+  _environment;
+  _client;
+  _context;
+  _throwErrors = false;
+  constructor(options) {
+    super();
+    this._applicationId = options.applicationId;
+    this._publicKey = options.publicKey;
+    this._environment = options.environment ?? import_node_process.default.env.NODE_ENV ?? "development";
+    this._context = options.context;
+    this._throwErrors = options.throwErrors ?? false;
+  }
+  get applicationId() {
+    return this._applicationId;
+  }
+  set applicationId(value) {
+    this._applicationId = value;
+  }
+  get publicKey() {
+    return this._publicKey;
+  }
+  set publicKey(value) {
+    this._publicKey = value;
+  }
+  get environment() {
+    return this._environment;
+  }
+  set environment(value) {
+    this._environment = value;
+  }
+  get throwErrors() {
+    return this._throwErrors;
+  }
+  set throwErrors(value) {
+    this._throwErrors = value;
+  }
+  get context() {
+    return this._context;
+  }
+  set context(value) {
+    this._context = value;
+  }
+  setContext(context) {
+    this._context = context;
+    this._client = void 0;
+  }
+  async getClient() {
+    if (!this._client) {
+      const options = {
+        application: this._applicationId,
+        environment: this._environment
+      };
+      await import_server_sdk.OpenFeature.setProviderAndWait(new import_openfeature_server_provider.HyphenProvider(this._publicKey, options));
+      this._client = import_server_sdk.OpenFeature.getClient(this._context);
+    }
+    return this._client;
+  }
+  async get(key, defaultValue, options) {
+    switch (typeof defaultValue) {
+      case "boolean": {
+        return this.getBoolean(key, defaultValue, options);
+      }
+      case "string": {
+        return this.getString(key, defaultValue, options);
+      }
+      case "number": {
+        return this.getNumber(key, defaultValue, options);
+      }
+      default: {
+        return this.getObject(key, defaultValue, options);
+      }
+    }
+  }
+  async getBoolean(key, defaultValue, options) {
+    try {
+      const data = {
+        key,
+        defaultValue,
+        options
+      };
+      await this.hook("beforeGetBoolean", data);
+      const client = await this.getClient();
+      const result = await client.getBooleanValue(data.key, data.defaultValue, data.options?.context);
+      const resultData = {
+        key,
+        defaultValue,
+        options,
+        result
+      };
+      await this.hook("afterGetBoolean", resultData);
+      return resultData.result;
+    } catch (error) {
+      this.emit("error", error);
+      if (this._throwErrors) {
+        throw error;
+      }
+    }
+    return defaultValue;
+  }
+  async getString(key, defaultValue, options) {
+    try {
+      const data = {
+        key,
+        defaultValue,
+        options
+      };
+      await this.hook("beforeGetString", data);
+      const client = await this.getClient();
+      const result = await client.getStringValue(data.key, data.defaultValue, data.options?.context);
+      const resultData = {
+        key,
+        defaultValue,
+        options,
+        result
+      };
+      await this.hook("afterGetString", resultData);
+      return resultData.result;
+    } catch (error) {
+      this.emit("error", error);
+      if (this._throwErrors) {
+        throw error;
+      }
+    }
+    return defaultValue;
+  }
+  async getNumber(key, defaultValue, options) {
+    try {
+      const data = {
+        key,
+        defaultValue,
+        options
+      };
+      await this.hook("beforeGetNumber", data);
+      const client = await this.getClient();
+      const result = await client.getNumberValue(data.key, data.defaultValue, data.options?.context);
+      const resultData = {
+        key,
+        defaultValue,
+        options,
+        result
+      };
+      await this.hook("afterGetNumber", resultData);
+      return resultData.result;
+    } catch (error) {
+      this.emit("error", error);
+      if (this._throwErrors) {
+        throw error;
+      }
+    }
+    return defaultValue;
+  }
+  async getObject(key, defaultValue, options) {
+    try {
+      const data = {
+        key,
+        defaultValue,
+        options
+      };
+      await this.hook("beforeGetObject", data);
+      const client = await this.getClient();
+      const result = await client.getObjectValue(key, defaultValue, data.options?.context);
+      const resultData = {
+        key,
+        defaultValue,
+        options,
+        result
+      };
+      await this.hook("afterGetObject", resultData);
+      return resultData.result;
+    } catch (error) {
+      this.emit("error", error);
+      if (this._throwErrors) {
+        throw error;
+      }
+    }
+    return defaultValue;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Toggle,
+  ToggleHooks
+});

package/dist/index.d.cts

@@ -0,0 +1,81 @@
+import { Hookified } from 'hookified';
+import { EvaluationContext, Client } from '@openfeature/server-sdk';
+
+type ToggleContext = EvaluationContext;
+declare enum ToggleHooks {
+    beforeGetBoolean = "beforeGetBoolean",
+    afterGetBoolean = "afterGetBoolean",
+    beforeGetString = "beforeGetString",
+    afterGetString = "afterGetString",
+    beforeGetNumber = "beforeGetNumber",
+    afterGetNumber = "afterGetNumber",
+    beforeGetObject = "beforeGetObject",
+    afterGetObject = "afterGetObject"
+}
+type ToggleOptions = {
+    /**
+     * Your application name
+     * @type {string}
+     */
+    applicationId: string;
+    /**
+     * Your Hyphen API key
+     * @type {string}
+     */
+    publicKey: string;
+    /**
+     * Your environment name such as development, production. Default is what is set at NODE_ENV
+     * @type {string}
+     * @example production
+     */
+    environment?: string;
+    /**
+     * The context to use for evaluating feature flags
+     * @type {ToggleContext}
+     */
+    context?: ToggleContext;
+    caching?: {
+        /**
+         * The time in seconds to cache the feature flag values
+         * @type {number} - this is in milliseconds
+         */
+        ttl?: number;
+    };
+    /**
+     * Throw errors in addition to emitting them
+     * @type {boolean}
+     * @default false
+     */
+    throwErrors?: boolean;
+};
+type ToggleRequestOptions = {
+    context?: ToggleContext;
+};
+declare class Toggle extends Hookified {
+    private _applicationId;
+    private _publicKey;
+    private _environment;
+    private _client;
+    private _context;
+    private _throwErrors;
+    constructor(options: ToggleOptions);
+    get applicationId(): string;
+    set applicationId(value: string);
+    get publicKey(): string;
+    set publicKey(value: string);
+    get environment(): string;
+    set environment(value: string);
+    get throwErrors(): boolean;
+    set throwErrors(value: boolean);
+    get context(): ToggleContext | undefined;
+    set context(value: ToggleContext | undefined);
+    setContext(context: ToggleContext): void;
+    getClient(): Promise<Client>;
+    get<T>(key: string, defaultValue: T, options?: ToggleRequestOptions): Promise<T>;
+    getBoolean(key: string, defaultValue: boolean, options?: ToggleRequestOptions): Promise<boolean>;
+    getString(key: string, defaultValue: string, options?: ToggleRequestOptions): Promise<string>;
+    getNumber(key: string, defaultValue: number, options?: ToggleRequestOptions): Promise<number>;
+    getObject<T>(key: string, defaultValue: T, options?: ToggleRequestOptions): Promise<T>;
+}
+
+export { Toggle, type ToggleContext, ToggleHooks, type ToggleOptions, type ToggleRequestOptions };

package/dist/index.d.ts

@@ -1,7 +1,17 @@
 import { Hookified } from 'hookified';
 import { EvaluationContext, Client } from '@openfeature/server-sdk';
 
-type Context = EvaluationContext;
+type ToggleContext = EvaluationContext;
+declare enum ToggleHooks {
+    beforeGetBoolean = "beforeGetBoolean",
+    afterGetBoolean = "afterGetBoolean",
+    beforeGetString = "beforeGetString",
+    afterGetString = "afterGetString",
+    beforeGetNumber = "beforeGetNumber",
+    afterGetNumber = "afterGetNumber",
+    beforeGetObject = "beforeGetObject",
+    afterGetObject = "afterGetObject"
+}
 type ToggleOptions = {
     /**
      * Your application name
@@ -21,9 +31,9 @@ type ToggleOptions = {
     environment?: string;
     /**
      * The context to use for evaluating feature flags
-     * @type {Context}
+     * @type {ToggleContext}
      */
-    context?: Context;
+    context?: ToggleContext;
     caching?: {
         /**
          * The time in seconds to cache the feature flag values
@@ -31,9 +41,15 @@ type ToggleOptions = {
          */
         ttl?: number;
     };
+    /**
+     * Throw errors in addition to emitting them
+     * @type {boolean}
+     * @default false
+     */
+    throwErrors?: boolean;
 };
 type ToggleRequestOptions = {
-    context?: Context;
+    context?: ToggleContext;
 };
 declare class Toggle extends Hookified {
     private _applicationId;
@@ -41,6 +57,7 @@ declare class Toggle extends Hookified {
     private _environment;
     private _client;
     private _context;
+    private _throwErrors;
     constructor(options: ToggleOptions);
     get applicationId(): string;
     set applicationId(value: string);
@@ -48,7 +65,11 @@ declare class Toggle extends Hookified {
     set publicKey(value: string);
     get environment(): string;
     set environment(value: string);
-    setContext(context: Context): void;
+    get throwErrors(): boolean;
+    set throwErrors(value: boolean);
+    get context(): ToggleContext | undefined;
+    set context(value: ToggleContext | undefined);
+    setContext(context: ToggleContext): void;
     getClient(): Promise<Client>;
     get<T>(key: string, defaultValue: T, options?: ToggleRequestOptions): Promise<T>;
     getBoolean(key: string, defaultValue: boolean, options?: ToggleRequestOptions): Promise<boolean>;
@@ -57,4 +78,4 @@ declare class Toggle extends Hookified {
     getObject<T>(key: string, defaultValue: T, options?: ToggleRequestOptions): Promise<T>;
 }
 
-export { Toggle };
+export { Toggle, type ToggleContext, ToggleHooks, type ToggleOptions, type ToggleRequestOptions };

package/dist/index.js

@@ -6,6 +6,17 @@ import process from "node:process";
 import { Hookified } from "hookified";
 import { OpenFeature } from "@openfeature/server-sdk";
 import { HyphenProvider } from "@hyphen/openfeature-server-provider";
+var ToggleHooks = /* @__PURE__ */ function(ToggleHooks2) {
+  ToggleHooks2["beforeGetBoolean"] = "beforeGetBoolean";
+  ToggleHooks2["afterGetBoolean"] = "afterGetBoolean";
+  ToggleHooks2["beforeGetString"] = "beforeGetString";
+  ToggleHooks2["afterGetString"] = "afterGetString";
+  ToggleHooks2["beforeGetNumber"] = "beforeGetNumber";
+  ToggleHooks2["afterGetNumber"] = "afterGetNumber";
+  ToggleHooks2["beforeGetObject"] = "beforeGetObject";
+  ToggleHooks2["afterGetObject"] = "afterGetObject";
+  return ToggleHooks2;
+}({});
 var Toggle = class extends Hookified {
   static {
     __name(this, "Toggle");
@@ -15,12 +26,14 @@ var Toggle = class extends Hookified {
   _environment;
   _client;
   _context;
+  _throwErrors = false;
   constructor(options) {
     super();
     this._applicationId = options.applicationId;
     this._publicKey = options.publicKey;
     this._environment = options.environment ?? process.env.NODE_ENV ?? "development";
     this._context = options.context;
+    this._throwErrors = options.throwErrors ?? false;
   }
   get applicationId() {
     return this._applicationId;
@@ -40,6 +53,18 @@ var Toggle = class extends Hookified {
   set environment(value) {
     this._environment = value;
   }
+  get throwErrors() {
+    return this._throwErrors;
+  }
+  set throwErrors(value) {
+    this._throwErrors = value;
+  }
+  get context() {
+    return this._context;
+  }
+  set context(value) {
+    this._context = value;
+  }
   setContext(context) {
     this._context = context;
     this._client = void 0;
@@ -72,78 +97,111 @@ var Toggle = class extends Hookified {
     }
   }
   async getBoolean(key, defaultValue, options) {
-    const data = {
-      key,
-      defaultValue,
-      options
-    };
-    await this.hook("beforeGetBoolean", data);
-    const client = await this.getClient();
-    const result = await client.getBooleanValue(data.key, data.defaultValue, data.options?.context);
-    const resultData = {
-      key,
-      defaultValue,
-      options,
-      result
-    };
-    await this.hook("afterGetBoolean", resultData);
-    return resultData.result;
+    try {
+      const data = {
+        key,
+        defaultValue,
+        options
+      };
+      await this.hook("beforeGetBoolean", data);
+      const client = await this.getClient();
+      const result = await client.getBooleanValue(data.key, data.defaultValue, data.options?.context);
+      const resultData = {
+        key,
+        defaultValue,
+        options,
+        result
+      };
+      await this.hook("afterGetBoolean", resultData);
+      return resultData.result;
+    } catch (error) {
+      this.emit("error", error);
+      if (this._throwErrors) {
+        throw error;
+      }
+    }
+    return defaultValue;
   }
   async getString(key, defaultValue, options) {
-    const data = {
-      key,
-      defaultValue,
-      options
-    };
-    await this.hook("beforeGetString", data);
-    const client = await this.getClient();
-    const result = await client.getStringValue(data.key, data.defaultValue, data.options?.context);
-    const resultData = {
-      key,
-      defaultValue,
-      options,
-      result
-    };
-    await this.hook("afterGetString", resultData);
-    return resultData.result;
+    try {
+      const data = {
+        key,
+        defaultValue,
+        options
+      };
+      await this.hook("beforeGetString", data);
+      const client = await this.getClient();
+      const result = await client.getStringValue(data.key, data.defaultValue, data.options?.context);
+      const resultData = {
+        key,
+        defaultValue,
+        options,
+        result
+      };
+      await this.hook("afterGetString", resultData);
+      return resultData.result;
+    } catch (error) {
+      this.emit("error", error);
+      if (this._throwErrors) {
+        throw error;
+      }
+    }
+    return defaultValue;
   }
   async getNumber(key, defaultValue, options) {
-    const data = {
-      key,
-      defaultValue,
-      options
-    };
-    await this.hook("beforeGetNumber", data);
-    const client = await this.getClient();
-    const result = await client.getNumberValue(data.key, data.defaultValue, data.options?.context);
-    const resultData = {
-      key,
-      defaultValue,
-      options,
-      result
-    };
-    await this.hook("afterGetNumber", resultData);
-    return resultData.result;
+    try {
+      const data = {
+        key,
+        defaultValue,
+        options
+      };
+      await this.hook("beforeGetNumber", data);
+      const client = await this.getClient();
+      const result = await client.getNumberValue(data.key, data.defaultValue, data.options?.context);
+      const resultData = {
+        key,
+        defaultValue,
+        options,
+        result
+      };
+      await this.hook("afterGetNumber", resultData);
+      return resultData.result;
+    } catch (error) {
+      this.emit("error", error);
+      if (this._throwErrors) {
+        throw error;
+      }
+    }
+    return defaultValue;
   }
   async getObject(key, defaultValue, options) {
-    const data = {
-      key,
-      defaultValue,
-      options
-    };
-    await this.hook("beforeGetObject", data);
-    const client = await this.getClient();
-    const result = await client.getObjectValue(key, defaultValue, data.options?.context);
-    const resultData = {
-      key,
-      defaultValue,
-      options,
-      result
-    };
-    await this.hook("afterGetObject", resultData);
-    return resultData.result;
+    try {
+      const data = {
+        key,
+        defaultValue,
+        options
+      };
+      await this.hook("beforeGetObject", data);
+      const client = await this.getClient();
+      const result = await client.getObjectValue(key, defaultValue, data.options?.context);
+      const resultData = {
+        key,
+        defaultValue,
+        options,
+        result
+      };
+      await this.hook("afterGetObject", resultData);
+      return resultData.result;
+    } catch (error) {
+      this.emit("error", error);
+      if (this._throwErrors) {
+        throw error;
+      }
+    }
+    return defaultValue;
   }
 };
 export {
-  Toggle
+  Toggle,
+  ToggleHooks
 };

package/logo.svg

@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" viewBox="0 0 500 500">
+  <!-- Generator: Adobe Illustrator 29.5.0, SVG Export Plug-In . SVG Version: 2.1.0 Build 137)  -->
+  <defs>
+    <style>
+      .st0 {
+        fill: url(#linear-gradient2);
+      }
+
+      .st1 {
+        fill: url(#linear-gradient1);
+      }
+
+      .st2 {
+        fill: url(#linear-gradient3);
+      }
+
+      .st3 {
+        fill: url(#linear-gradient);
+      }
+    </style>
+    <linearGradient id="linear-gradient" x1="144.47" y1="67.13" x2="648.76" y2="358.29" gradientTransform="translate(0 502) scale(1 -1)" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#fa0a64"/>
+      <stop offset=".11" stop-color="#fa135f"/>
+      <stop offset=".28" stop-color="#fb2b52"/>
+      <stop offset=".49" stop-color="#fc533e"/>
+      <stop offset=".75" stop-color="#fd8a21"/>
+      <stop offset="1" stop-color="#ffc800"/>
+    </linearGradient>
+    <linearGradient id="linear-gradient1" x1="-8270.41" y1="3296.5" x2="-8270.41" y2="2915.75" gradientTransform="translate(-8012.49 -2856.7) rotate(-180) scale(1 -1)" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#ffc800"/>
+      <stop offset=".11" stop-color="#ffbf05"/>
+      <stop offset=".28" stop-color="#fea712"/>
+      <stop offset=".49" stop-color="#fd7f26"/>
+      <stop offset=".75" stop-color="#fc4843"/>
+      <stop offset="1" stop-color="#fa0a64"/>
+    </linearGradient>
+    <linearGradient id="linear-gradient2" x1="-6709.98" y1="2836.03" x2="-6205.33" y2="3127.38" gradientTransform="translate(-6354.31 -2771.03) rotate(-180) scale(1 -1)" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#fa0a64"/>
+      <stop offset=".11" stop-color="#fa135f"/>
+      <stop offset=".28" stop-color="#fb2b52"/>
+      <stop offset=".49" stop-color="#fc533e"/>
+      <stop offset=".75" stop-color="#fd8a21"/>
+      <stop offset="1" stop-color="#ffc800"/>
+    </linearGradient>
+    <linearGradient id="linear-gradient3" x1="-1416.15" y1="527.47" x2="-1416.15" y2="146.72" gradientTransform="translate(1658.18 587.67) scale(1 -1)" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#ffc800"/>
+      <stop offset=".11" stop-color="#ffbf05"/>
+      <stop offset=".28" stop-color="#fea712"/>
+      <stop offset=".49" stop-color="#fd7f26"/>
+      <stop offset=".75" stop-color="#fc4843"/>
+      <stop offset="1" stop-color="#fa0a64"/>
+    </linearGradient>
+  </defs>
+  <path class="st3" d="M391.88,172.03c-7.88,11.76-154.27,267.33-154.27,267.33l93.12,1.76c20.49,0,34.78-8.82,43.05-23.16l96.72-167.55s-37.23-65.68-45.41-78.39c-8.18-12.72-24.94-12.38-33.21,0Z"/>
+  <path class="st1" d="M330.64,441.18c20.49,0,34.78-8.82,43.05-23.16l2.57-4.46c-6.38,10.58-16.83,22.93-31.15,1.27-10.44-15.87-95.24-164.85-95.24-164.85l-110.32,191.2h191.07Z"/>
+  <path class="st0" d="M108.04,327.97c7.88-11.8,154.48-267.53,154.48-267.53l-93.24-1.62c-20.49,0-34.78,8.82-43.05,23.16L29.5,249.47s37.14,65.84,45.33,78.5,24.94,12.38,33.21,0Z"/>
+  <path class="st2" d="M169.27,58.82c-20.49,0-34.78,8.82-43.05,23.16l-2.57,4.46c6.38-10.58,16.83-22.93,31.15-1.27,10.44,15.87,95.24,164.85,95.24,164.85l110.39-191.18-191.14-.02Z"/>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyphen/sdk",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Hyphen SDK for Node.js",
   "type": "module",
   "main": "dist/index.cjs",
@@ -12,6 +12,13 @@
     }
   },
   "types": "dist/node/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",
+    "prepublishOnly": "rimraf ./dist && tsup src/index.ts --format esm,cjs --dts --clean"
+  },
   "keywords": [
     "hyphen",
     "sdk",
@@ -34,18 +41,13 @@
   },
   "files": [
     "dist",
-    "LICENSE"
+    "LICENSE",
+    "logo.svg"
   ],
   "dependencies": {
     "@hyphen/openfeature-server-provider": "^1.0.7",
     "@openfeature/server-sdk": "^1.18.0",
     "dotenv": "^16.5.0",
     "hookified": "^1.9.0"
-  },
-  "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"
   }
-}
+}