@hyphen/sdk 2.0.1 → 2.2.0

package/README.md

@@ -24,6 +24,7 @@ The Hyphen Node.js SDK is a JavaScript library that allows developers to easily
 - [ENV - Secret Management Service](#env---secret-management-service)
 	- [Loading Environment Variables](#loading-environment-variables)
 - [Net Info - Geo Information Service](#net-info---geo-information-service)
+- [Execution Context - API Key Validation](#execution-context---api-key-validation)
 - [Link - Short Code Service](#link---short-code-service)
 	- [Creating a Short Code](#creating-a-short-code)
 	- [Updating a Short Code](#updating-a-short-code)
@@ -673,6 +674,75 @@ console.log('IP Infos:', ipInfos);
 
 You can also set the API key using the `HYPHEN_API_KEY` environment variable. This is useful for keeping your API key secure and not hardcoding it in your code.
 
+# Execution Context - API Key Validation
+
+The `getExecutionContext` function validates an API key and returns information about the authenticated user, organization, and request context. This is useful for verifying API keys and getting user/organization details.
+
+## Basic Usage
+
+```javascript
+import { getExecutionContext } from '@hyphen/sdk';
+
+const context = await getExecutionContext('your-api-key');
+
+console.log('User:', context.user?.name);
+console.log('Organization:', context.member?.organization?.name);
+console.log('IP Address:', context.ipAddress);
+console.log('Location:', context.location?.city, context.location?.country);
+```
+
+## Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `organizationId` | `string` | Optional organization ID to scope the context request |
+| `baseUri` | `string` | Custom API base URI (defaults to `https://api.hyphen.ai`) |
+| `cache` | `Cacheable` | Cacheable instance for caching requests |
+
+## With Organization ID
+
+If you need to get context for a specific organization:
+
+```javascript
+import { getExecutionContext } from '@hyphen/sdk';
+
+const context = await getExecutionContext('your-api-key', {
+  organizationId: 'org_123456789',
+});
+
+console.log('Organization:', context.organization?.name);
+```
+
+## With Caching
+
+To enable caching of execution context requests:
+
+```javascript
+import { Cacheable } from 'cacheable';
+import { getExecutionContext } from '@hyphen/sdk';
+
+const cache = new Cacheable({ ttl: 60000 }); // Cache for 60 seconds
+
+const context = await getExecutionContext('your-api-key', {
+  cache,
+});
+
+console.log('User:', context.user?.name);
+```
+
+## Return Type
+
+The function returns an `ExecutionContext` object with the following properties:
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `request` | `object` | Request metadata (`id`, `causationId`, `correlationId`) |
+| `user` | `object` | User info (`id`, `name`, `rules`, `type`) |
+| `member` | `object` | Member info with nested `organization` |
+| `organization` | `object` | Organization info (`id`, `name`) |
+| `ipAddress` | `string` | The IP address of the request |
+| `location` | `object` | Geo location (`country`, `region`, `city`, `lat`, `lng`, `postalCode`, `timezone`) |
+
 # Link - Short Code Service
 
 The Hyphen Node.js SDK also provides a `Link` class that allows you to create and manage short codes. This can be useful for generating short links for your application.

package/dist/index.cjs

@@ -34,6 +34,7 @@ __export(index_exports, {
   Hyphen: () => Hyphen,
   Toggle: () => Toggle,
   env: () => env,
+  getExecutionContext: () => getExecutionContext,
   loadEnv: () => loadEnv
 });
 module.exports = __toCommonJS(index_exports);
@@ -42,56 +43,72 @@ module.exports = __toCommonJS(index_exports);
 var import_node_fs = __toESM(require("fs"), 1);
 var import_node_path = __toESM(require("path"), 1);
 var import_node_process = __toESM(require("process"), 1);
-var import_dotenv = require("dotenv");
+var import_node_util = require("util");
+function loadEnvFile(filePath, override) {
+  try {
+    const content = import_node_fs.default.readFileSync(filePath, "utf8");
+    const parsed = (0, import_node_util.parseEnv)(content);
+    for (const [key, value] of Object.entries(parsed)) {
+      if (override || import_node_process.default.env[key] === void 0) {
+        import_node_process.default.env[key] = value;
+      }
+    }
+  } catch {
+  }
+}
+__name(loadEnvFile, "loadEnvFile");
 function env(options) {
   const local = options?.local ?? true;
   const currentWorkingDirectory = options?.path ?? import_node_process.default.cwd();
   const envPath = import_node_path.default.resolve(currentWorkingDirectory, ".env");
-  if (import_node_fs.default.existsSync(envPath)) {
-    (0, import_dotenv.config)({
-      path: envPath,
-      quiet: true,
-      debug: false
-    });
-  }
+  loadEnvFile(envPath, false);
   if (local) {
     const localEnvPath = import_node_path.default.resolve(currentWorkingDirectory, ".env.local");
-    if (import_node_fs.default.existsSync(localEnvPath)) {
-      (0, import_dotenv.config)({
-        path: localEnvPath,
-        override: true,
-        quiet: true,
-        debug: false
-      });
-    }
+    loadEnvFile(localEnvPath, true);
   }
   const environment = options?.environment ?? import_node_process.default.env.NODE_ENV;
   if (environment) {
     const envSpecificPath = import_node_path.default.resolve(currentWorkingDirectory, `.env.${environment}`);
-    if (import_node_fs.default.existsSync(envSpecificPath)) {
-      (0, import_dotenv.config)({
-        path: envSpecificPath,
-        override: true,
-        quiet: true,
-        debug: false
-      });
-    }
+    loadEnvFile(envSpecificPath, true);
     if (local) {
       const envLocalPath = import_node_path.default.resolve(currentWorkingDirectory, `.env.${environment}.local`);
-      if (import_node_fs.default.existsSync(envLocalPath)) {
-        (0, import_dotenv.config)({
-          path: envLocalPath,
-          override: true,
-          quiet: true,
-          debug: false
-        });
-      }
+      loadEnvFile(envLocalPath, true);
     }
   }
 }
 __name(env, "env");
 var loadEnv = env;
 
+// src/execution-context.ts
+var import_net = require("@cacheable/net");
+async function getExecutionContext(apiKey, options) {
+  if (!apiKey) {
+    throw new Error("API key is required");
+  }
+  const baseUri = options?.baseUri ?? "https://api.hyphen.ai";
+  let url = `${baseUri}/api/execution-context`;
+  if (options?.organizationId) {
+    url += `?organizationId=${encodeURIComponent(options.organizationId)}`;
+  }
+  const net = options?.cache ? new import_net.CacheableNet({
+    cache: options.cache
+  }) : new import_net.CacheableNet();
+  const caching = options?.cache !== void 0;
+  const response = await net.get(url, {
+    headers: {
+      "x-api-key": apiKey,
+      "content-type": "application/json",
+      accept: "application/json"
+    },
+    caching
+  });
+  if (response.response.status !== 200) {
+    throw new Error(`Failed to get execution context: ${response.response.statusText}`);
+  }
+  return response.data;
+}
+__name(getExecutionContext, "getExecutionContext");
+
 // src/hyphen.ts
 var import_hookified3 = require("hookified");
 
@@ -100,7 +117,7 @@ var import_node_buffer = require("buffer");
 var import_node_process2 = __toESM(require("process"), 1);
 
 // src/base-service.ts
-var import_net = require("@cacheable/net");
+var import_net2 = require("@cacheable/net");
 var import_cacheable = require("cacheable");
 var import_hookified = require("hookified");
 var import_pino = __toESM(require("pino"), 1);
@@ -122,7 +139,7 @@ var BaseService = class extends import_hookified.Hookified {
     if (options && options.throwErrors !== void 0) {
       this._throwErrors = options.throwErrors;
     }
-    this._net = new import_net.CacheableNet({
+    this._net = new import_net2.CacheableNet({
       cache: this._cache
     });
   }
@@ -160,59 +177,56 @@ var BaseService = class extends import_hookified.Hookified {
     this._log.info(message, ...args);
     this.emit("info", message, ...args);
   }
-  async get(url, config2) {
+  async get(url, config) {
     let finalUrl = url;
-    if (config2?.params) {
-      const params = new URLSearchParams(config2.params);
+    if (config?.params) {
+      const params = new URLSearchParams(config.params);
       finalUrl = `${url}?${params.toString()}`;
     }
-    const { params: _, ...fetchConfig } = config2 || {};
+    const { params: _, ...fetchConfig } = config || {};
     const response = await this._net.get(finalUrl, fetchConfig);
     return {
       data: response.data,
       status: response.response.status,
       statusText: response.response.statusText,
       headers: response.response.headers,
-      config: config2,
+      config,
       request: void 0
     };
   }
-  async post(url, data, config2) {
-    const response = await this._net.post(url, data, config2);
+  async post(url, data, config) {
+    const response = await this._net.post(url, data, config);
     return {
       data: response.data,
       status: response.response.status,
       statusText: response.response.statusText,
       headers: response.response.headers,
-      config: config2,
+      config,
       request: void 0
     };
   }
-  async put(url, data, config2) {
-    const response = await this._net.put(url, data, config2);
+  async put(url, data, config) {
+    const response = await this._net.put(url, data, config);
     return {
       data: response.data,
       status: response.response.status,
       statusText: response.response.statusText,
       headers: response.response.headers,
-      config: config2,
+      config,
       request: void 0
     };
   }
-  async delete(url, config2) {
+  async delete(url, config) {
     const headers = {
-      ...config2?.headers
+      ...config?.headers
     };
     if (headers) {
       delete headers["content-type"];
     }
-    const { data: configData, ...restConfig } = config2 || {};
+    const { data: configData, ...restConfig } = config || {};
     let body;
     if (configData) {
-      body = typeof configData === "string" ? (
-        /* c8 ignore next */
-        configData
-      ) : JSON.stringify(configData);
+      body = typeof configData === "string" ? configData : JSON.stringify(configData);
       if (!headers["content-type"] && !headers["Content-Type"]) {
         headers["content-type"] = "application/json";
       }
@@ -237,18 +251,18 @@ var BaseService = class extends import_hookified.Hookified {
       status: response.status,
       statusText: response.statusText,
       headers: response.headers,
-      config: config2,
+      config,
       request: void 0
     };
   }
-  async patch(url, data, config2) {
-    const response = await this._net.patch(url, data, config2);
+  async patch(url, data, config) {
+    const response = await this._net.patch(url, data, config);
     return {
       data: response.data,
       status: response.response.status,
       statusText: response.response.statusText,
       headers: response.response.headers,
-      config: config2,
+      config,
       request: void 0
     };
   }
@@ -725,6 +739,7 @@ var NetInfo = class extends BaseService {
       const errorResult = {
         ip,
         type: "error",
+        /* v8 ignore next -- @preserve */
         errorMessage: error instanceof Error ? error.message : "Unknown error"
       };
       return errorResult;
@@ -768,7 +783,7 @@ var NetInfo = class extends BaseService {
 };
 
 // src/toggle.ts
-var import_net2 = require("@cacheable/net");
+var import_net3 = require("@cacheable/net");
 var import_hookified2 = require("hookified");
 var Toggle = class extends import_hookified2.Hookified {
   static {
@@ -779,7 +794,7 @@ var Toggle = class extends import_hookified2.Hookified {
   _applicationId;
   _environment;
   _horizonUrls = [];
-  _net = new import_net2.CacheableNet();
+  _net = new import_net3.CacheableNet();
   _defaultContext;
   _defaultTargetingKey = `${Math.random().toString(36).substring(7)}`;
   /**
@@ -1011,6 +1026,7 @@ var Toggle = class extends import_hookified2.Hookified {
     try {
       const context = {
         application: this._applicationId ?? "",
+        /* v8 ignore next -- @preserve */
         environment: this._environment ?? "development"
       };
       if (options?.context) {
@@ -1201,7 +1217,10 @@ var Toggle = class extends import_hookified2.Hookified {
         const data = await response.json();
         return data;
       } catch (error) {
-        const fetchError = error instanceof Error ? error : new Error("Unknown fetch error");
+        const fetchError = (
+          /* v8 ignore next -- @preserve */
+          error instanceof Error ? error : new Error("Unknown fetch error")
+        );
         const statusMatch = fetchError.message.match(/status (\d{3})/);
         if (statusMatch) {
           const status = statusMatch[1];
@@ -1470,5 +1489,7 @@ var Hyphen = class extends import_hookified3.Hookified {
   Hyphen,
   Toggle,
   env,
+  getExecutionContext,
   loadEnv
 });
+/* v8 ignore next -- @preserve */

package/dist/index.d.cts

@@ -1,6 +1,6 @@
+import { Cacheable } from 'cacheable';
 import { HookifiedOptions, Hookified } from 'hookified';
 import { FetchRequestInit, FetchOptions } from '@cacheable/net';
-import { Cacheable } from 'cacheable';
 import pino from 'pino';
 
 type EnvOptions = {
@@ -21,6 +21,84 @@ declare function env(options?: EnvOptions): void;
 declare const loadEnv: typeof env;
 type LoadEnvOptions = EnvOptions;
 
+type ExecutionContextOptions = {
+    /**
+     * The organization ID for the Hyphen API.
+     */
+    organizationId?: string;
+    /**
+     * The base URI for the Hyphen API.
+     * @default "https://api.hyphen.ai"
+     */
+    baseUri?: string;
+    /**
+     * The Cacheable instance to use for caching requests.
+     */
+    cache?: Cacheable;
+};
+type ExecutionContextRequest = {
+    id?: string;
+    causationId?: string;
+    correlationId?: string;
+};
+type ExecutionContextUser = {
+    id?: string;
+    name?: string;
+    rules?: Record<string, unknown>[];
+    type?: string;
+};
+type ExecutionContextMember = {
+    id?: string;
+    name?: string;
+    organization?: {
+        id?: string;
+        name?: string;
+    };
+    rules?: Record<string, unknown>[];
+};
+type ExecutionContextOrganization = {
+    id?: string;
+    name?: string;
+};
+type ExecutionContextLocation = {
+    country?: string;
+    region?: string;
+    city?: string;
+    lat?: number;
+    lng?: number;
+    postalCode?: string;
+    timezone?: string;
+};
+type ExecutionContext = {
+    request?: ExecutionContextRequest;
+    user?: ExecutionContextUser;
+    member?: ExecutionContextMember;
+    organization?: ExecutionContextOrganization;
+    ipAddress?: string;
+    location?: ExecutionContextLocation;
+};
+/**
+ * Get the execution context for the provided API key.
+ * This validates the API key and returns information about the organization, user, and request context.
+ *
+ * @param apiKey - The API key for the Hyphen API.
+ * @param options - Additional options for the request.
+ * @returns The execution context.
+ * @throws Error if the API key is not provided or if the request fails.
+ *
+ * @example
+ * ```typescript
+ * import { getExecutionContext } from '@hyphen/sdk';
+ *
+ * const context = await getExecutionContext('your-api-key', {
+ *   organizationId: 'optional-org-id',
+ * });
+ *
+ * console.log(context.organization?.name);
+ * ```
+ */
+declare function getExecutionContext(apiKey: string, options?: ExecutionContextOptions): Promise<ExecutionContext>;
+
 interface HttpResponse<T = any> {
     data: T;
     status: number;
@@ -1049,4 +1127,4 @@ declare class Hyphen extends Hookified {
     set apiKey(value: string | undefined);
 }
 
-export { type EnvOptions, Hyphen, type HyphenOptions, type LoadEnvOptions, Toggle, type ToggleContext, type ToggleEvaluation, ToggleEvents, type ToggleOptions, type ToggleUser, env, loadEnv };
+export { type EnvOptions, type ExecutionContext, type ExecutionContextLocation, type ExecutionContextMember, type ExecutionContextOptions, type ExecutionContextOrganization, type ExecutionContextRequest, type ExecutionContextUser, Hyphen, type HyphenOptions, type LoadEnvOptions, Toggle, type ToggleContext, type ToggleEvaluation, ToggleEvents, type ToggleOptions, type ToggleUser, env, getExecutionContext, loadEnv };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
+import { Cacheable } from 'cacheable';
 import { HookifiedOptions, Hookified } from 'hookified';
 import { FetchRequestInit, FetchOptions } from '@cacheable/net';
-import { Cacheable } from 'cacheable';
 import pino from 'pino';
 
 type EnvOptions = {
@@ -21,6 +21,84 @@ declare function env(options?: EnvOptions): void;
 declare const loadEnv: typeof env;
 type LoadEnvOptions = EnvOptions;
 
+type ExecutionContextOptions = {
+    /**
+     * The organization ID for the Hyphen API.
+     */
+    organizationId?: string;
+    /**
+     * The base URI for the Hyphen API.
+     * @default "https://api.hyphen.ai"
+     */
+    baseUri?: string;
+    /**
+     * The Cacheable instance to use for caching requests.
+     */
+    cache?: Cacheable;
+};
+type ExecutionContextRequest = {
+    id?: string;
+    causationId?: string;
+    correlationId?: string;
+};
+type ExecutionContextUser = {
+    id?: string;
+    name?: string;
+    rules?: Record<string, unknown>[];
+    type?: string;
+};
+type ExecutionContextMember = {
+    id?: string;
+    name?: string;
+    organization?: {
+        id?: string;
+        name?: string;
+    };
+    rules?: Record<string, unknown>[];
+};
+type ExecutionContextOrganization = {
+    id?: string;
+    name?: string;
+};
+type ExecutionContextLocation = {
+    country?: string;
+    region?: string;
+    city?: string;
+    lat?: number;
+    lng?: number;
+    postalCode?: string;
+    timezone?: string;
+};
+type ExecutionContext = {
+    request?: ExecutionContextRequest;
+    user?: ExecutionContextUser;
+    member?: ExecutionContextMember;
+    organization?: ExecutionContextOrganization;
+    ipAddress?: string;
+    location?: ExecutionContextLocation;
+};
+/**
+ * Get the execution context for the provided API key.
+ * This validates the API key and returns information about the organization, user, and request context.
+ *
+ * @param apiKey - The API key for the Hyphen API.
+ * @param options - Additional options for the request.
+ * @returns The execution context.
+ * @throws Error if the API key is not provided or if the request fails.
+ *
+ * @example
+ * ```typescript
+ * import { getExecutionContext } from '@hyphen/sdk';
+ *
+ * const context = await getExecutionContext('your-api-key', {
+ *   organizationId: 'optional-org-id',
+ * });
+ *
+ * console.log(context.organization?.name);
+ * ```
+ */
+declare function getExecutionContext(apiKey: string, options?: ExecutionContextOptions): Promise<ExecutionContext>;
+
 interface HttpResponse<T = any> {
     data: T;
     status: number;
@@ -1049,4 +1127,4 @@ declare class Hyphen extends Hookified {
     set apiKey(value: string | undefined);
 }
 
-export { type EnvOptions, Hyphen, type HyphenOptions, type LoadEnvOptions, Toggle, type ToggleContext, type ToggleEvaluation, ToggleEvents, type ToggleOptions, type ToggleUser, env, loadEnv };
+export { type EnvOptions, type ExecutionContext, type ExecutionContextLocation, type ExecutionContextMember, type ExecutionContextOptions, type ExecutionContextOrganization, type ExecutionContextRequest, type ExecutionContextUser, Hyphen, type HyphenOptions, type LoadEnvOptions, Toggle, type ToggleContext, type ToggleEvaluation, ToggleEvents, type ToggleOptions, type ToggleUser, env, getExecutionContext, loadEnv };

package/dist/index.js

@@ -5,56 +5,72 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 import fs from "fs";
 import path from "path";
 import process from "process";
-import { config } from "dotenv";
+import { parseEnv } from "util";
+function loadEnvFile(filePath, override) {
+  try {
+    const content = fs.readFileSync(filePath, "utf8");
+    const parsed = parseEnv(content);
+    for (const [key, value] of Object.entries(parsed)) {
+      if (override || process.env[key] === void 0) {
+        process.env[key] = value;
+      }
+    }
+  } catch {
+  }
+}
+__name(loadEnvFile, "loadEnvFile");
 function env(options) {
   const local = options?.local ?? true;
   const currentWorkingDirectory = options?.path ?? process.cwd();
   const envPath = path.resolve(currentWorkingDirectory, ".env");
-  if (fs.existsSync(envPath)) {
-    config({
-      path: envPath,
-      quiet: true,
-      debug: false
-    });
-  }
+  loadEnvFile(envPath, false);
   if (local) {
     const localEnvPath = path.resolve(currentWorkingDirectory, ".env.local");
-    if (fs.existsSync(localEnvPath)) {
-      config({
-        path: localEnvPath,
-        override: true,
-        quiet: true,
-        debug: false
-      });
-    }
+    loadEnvFile(localEnvPath, true);
   }
   const environment = options?.environment ?? process.env.NODE_ENV;
   if (environment) {
     const envSpecificPath = path.resolve(currentWorkingDirectory, `.env.${environment}`);
-    if (fs.existsSync(envSpecificPath)) {
-      config({
-        path: envSpecificPath,
-        override: true,
-        quiet: true,
-        debug: false
-      });
-    }
+    loadEnvFile(envSpecificPath, true);
     if (local) {
       const envLocalPath = path.resolve(currentWorkingDirectory, `.env.${environment}.local`);
-      if (fs.existsSync(envLocalPath)) {
-        config({
-          path: envLocalPath,
-          override: true,
-          quiet: true,
-          debug: false
-        });
-      }
+      loadEnvFile(envLocalPath, true);
     }
   }
 }
 __name(env, "env");
 var loadEnv = env;
 
+// src/execution-context.ts
+import { CacheableNet } from "@cacheable/net";
+async function getExecutionContext(apiKey, options) {
+  if (!apiKey) {
+    throw new Error("API key is required");
+  }
+  const baseUri = options?.baseUri ?? "https://api.hyphen.ai";
+  let url = `${baseUri}/api/execution-context`;
+  if (options?.organizationId) {
+    url += `?organizationId=${encodeURIComponent(options.organizationId)}`;
+  }
+  const net = options?.cache ? new CacheableNet({
+    cache: options.cache
+  }) : new CacheableNet();
+  const caching = options?.cache !== void 0;
+  const response = await net.get(url, {
+    headers: {
+      "x-api-key": apiKey,
+      "content-type": "application/json",
+      accept: "application/json"
+    },
+    caching
+  });
+  if (response.response.status !== 200) {
+    throw new Error(`Failed to get execution context: ${response.response.statusText}`);
+  }
+  return response.data;
+}
+__name(getExecutionContext, "getExecutionContext");
+
 // src/hyphen.ts
 import { Hookified as Hookified3 } from "hookified";
 
@@ -63,7 +79,7 @@ import { Buffer as Buffer2 } from "buffer";
 import process2 from "process";
 
 // src/base-service.ts
-import { CacheableNet } from "@cacheable/net";
+import { CacheableNet as CacheableNet2 } from "@cacheable/net";
 import { Cacheable } from "cacheable";
 import { Hookified } from "hookified";
 import pino from "pino";
@@ -85,7 +101,7 @@ var BaseService = class extends Hookified {
     if (options && options.throwErrors !== void 0) {
       this._throwErrors = options.throwErrors;
     }
-    this._net = new CacheableNet({
+    this._net = new CacheableNet2({
       cache: this._cache
     });
   }
@@ -123,59 +139,56 @@ var BaseService = class extends Hookified {
     this._log.info(message, ...args);
     this.emit("info", message, ...args);
   }
-  async get(url, config2) {
+  async get(url, config) {
     let finalUrl = url;
-    if (config2?.params) {
-      const params = new URLSearchParams(config2.params);
+    if (config?.params) {
+      const params = new URLSearchParams(config.params);
       finalUrl = `${url}?${params.toString()}`;
     }
-    const { params: _, ...fetchConfig } = config2 || {};
+    const { params: _, ...fetchConfig } = config || {};
     const response = await this._net.get(finalUrl, fetchConfig);
     return {
       data: response.data,
       status: response.response.status,
       statusText: response.response.statusText,
       headers: response.response.headers,
-      config: config2,
+      config,
       request: void 0
     };
   }
-  async post(url, data, config2) {
-    const response = await this._net.post(url, data, config2);
+  async post(url, data, config) {
+    const response = await this._net.post(url, data, config);
     return {
       data: response.data,
       status: response.response.status,
       statusText: response.response.statusText,
       headers: response.response.headers,
-      config: config2,
+      config,
       request: void 0
     };
   }
-  async put(url, data, config2) {
-    const response = await this._net.put(url, data, config2);
+  async put(url, data, config) {
+    const response = await this._net.put(url, data, config);
     return {
       data: response.data,
       status: response.response.status,
       statusText: response.response.statusText,
       headers: response.response.headers,
-      config: config2,
+      config,
       request: void 0
     };
   }
-  async delete(url, config2) {
+  async delete(url, config) {
     const headers = {
-      ...config2?.headers
+      ...config?.headers
     };
     if (headers) {
       delete headers["content-type"];
     }
-    const { data: configData, ...restConfig } = config2 || {};
+    const { data: configData, ...restConfig } = config || {};
     let body;
     if (configData) {
-      body = typeof configData === "string" ? (
-        /* c8 ignore next */
-        configData
-      ) : JSON.stringify(configData);
+      body = typeof configData === "string" ? configData : JSON.stringify(configData);
       if (!headers["content-type"] && !headers["Content-Type"]) {
         headers["content-type"] = "application/json";
       }
@@ -200,18 +213,18 @@ var BaseService = class extends Hookified {
       status: response.status,
       statusText: response.statusText,
       headers: response.headers,
-      config: config2,
+      config,
       request: void 0
     };
   }
-  async patch(url, data, config2) {
-    const response = await this._net.patch(url, data, config2);
+  async patch(url, data, config) {
+    const response = await this._net.patch(url, data, config);
     return {
       data: response.data,
       status: response.response.status,
       statusText: response.response.statusText,
       headers: response.response.headers,
-      config: config2,
+      config,
       request: void 0
     };
   }
@@ -688,6 +701,7 @@ var NetInfo = class extends BaseService {
       const errorResult = {
         ip,
         type: "error",
+        /* v8 ignore next -- @preserve */
         errorMessage: error instanceof Error ? error.message : "Unknown error"
       };
       return errorResult;
@@ -731,7 +745,7 @@ var NetInfo = class extends BaseService {
 };
 
 // src/toggle.ts
-import { CacheableNet as CacheableNet2 } from "@cacheable/net";
+import { CacheableNet as CacheableNet3 } from "@cacheable/net";
 import { Hookified as Hookified2 } from "hookified";
 var Toggle = class extends Hookified2 {
   static {
@@ -742,7 +756,7 @@ var Toggle = class extends Hookified2 {
   _applicationId;
   _environment;
   _horizonUrls = [];
-  _net = new CacheableNet2();
+  _net = new CacheableNet3();
   _defaultContext;
   _defaultTargetingKey = `${Math.random().toString(36).substring(7)}`;
   /**
@@ -974,6 +988,7 @@ var Toggle = class extends Hookified2 {
     try {
       const context = {
         application: this._applicationId ?? "",
+        /* v8 ignore next -- @preserve */
         environment: this._environment ?? "development"
       };
       if (options?.context) {
@@ -1164,7 +1179,10 @@ var Toggle = class extends Hookified2 {
         const data = await response.json();
         return data;
       } catch (error) {
-        const fetchError = error instanceof Error ? error : new Error("Unknown fetch error");
+        const fetchError = (
+          /* v8 ignore next -- @preserve */
+          error instanceof Error ? error : new Error("Unknown fetch error")
+        );
         const statusMatch = fetchError.message.match(/status (\d{3})/);
         if (statusMatch) {
           const status = statusMatch[1];
@@ -1432,5 +1450,7 @@ export {
   Hyphen,
   Toggle,
   env,
+  getExecutionContext,
   loadEnv
 };
+/* v8 ignore next -- @preserve */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyphen/sdk",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "description": "Hyphen SDK for Node.js",
   "type": "module",
   "main": "dist/index.cjs",
@@ -29,27 +29,29 @@
   ],
   "author": "Team Hyphen <hello@hyphen.ai>",
   "license": "MIT",
+  "engines": {
+    "node": ">=20.12.0"
+  },
   "devDependencies": {
-    "@biomejs/biome": "^2.2.5",
-    "@swc/core": "^1.13.20",
-    "@types/node": "^24.7.2",
-    "@vitest/coverage-v8": "^3.2.4",
-    "rimraf": "^6.0.1",
+    "@biomejs/biome": "^2.3.8",
+    "@swc/core": "^1.15.3",
+    "@types/node": "^25.0.0",
+    "@vitest/coverage-v8": "^4.0.15",
+    "rimraf": "^6.1.2",
     "tsd": "^0.33.0",
-    "tsup": "^8.5.0",
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.15"
   },
   "files": [
     "dist",
     "LICENSE"
   ],
   "dependencies": {
-    "@cacheable/net": "^2.0.1",
-    "@faker-js/faker": "^10.0.0",
-    "cacheable": "^2.1.0",
-    "dotenv": "^17.2.3",
-    "hookified": "^1.12.1",
-    "pino": "^10.0.0"
+    "@cacheable/net": "^2.0.4",
+    "@faker-js/faker": "^10.2.0",
+    "cacheable": "^2.3.0",
+    "hookified": "^1.14.0",
+    "pino": "^10.1.1"
   }
 }