@cloudflare/flagship 0.0.3 → 0.2.0

package/README.md

@@ -1,5 +1,165 @@
 # @cloudflare/flagship
 
-OpenFeature provider SDK for Flagship, Cloudflare's feature flag platform.
+[![npm version](https://img.shields.io/npm/v/@cloudflare/flagship.svg)](https://www.npmjs.com/package/@cloudflare/flagship)
+[![npm downloads](https://img.shields.io/npm/dm/@cloudflare/flagship.svg)](https://www.npmjs.com/package/@cloudflare/flagship)
+[![license](https://img.shields.io/npm/l/@cloudflare/flagship.svg)](https://github.com/cloudflare/flagship/blob/main/LICENSE)
 
-This is a technical preview.
+[OpenFeature](https://openfeature.dev)-compliant provider SDK for [Flagship](https://github.com/cloudflare/flagship), Cloudflare's globally distributed, low-latency feature flag platform.
+
+Server-side (Node.js, Cloudflare Workers) and client-side (browser) support via isolated sub-path exports. Tree-shakeable — importing `@cloudflare/flagship/server` never loads `@openfeature/web-sdk` and vice versa.
+
+## Install
+
+**Server-side** (Node.js, Cloudflare Workers):
+
+```bash
+npm install @cloudflare/flagship @openfeature/server-sdk
+```
+
+**Client-side** (browser):
+
+```bash
+npm install @cloudflare/flagship @openfeature/web-sdk
+```
+
+## Quick start — server
+
+```typescript
+import { OpenFeature } from '@openfeature/server-sdk';
+import { FlagshipServerProvider } from '@cloudflare/flagship/server';
+
+await OpenFeature.setProviderAndWait(
+  new FlagshipServerProvider({ appId: 'your-app-id', accountId: 'your-account-id', authToken: 'your-token' }),
+);
+
+const client = OpenFeature.getClient();
+const enabled = await client.getBooleanValue('dark-mode', false, { userId: 'user-123' });
+```
+
+## Quick start — Cloudflare Workers
+
+The recommended approach for Cloudflare Workers. Uses a wrangler binding — no HTTP overhead, no auth tokens needed.
+
+Configure in `wrangler.json`:
+
+```jsonc
+{
+  "flagship": [{ "binding": "FLAGS", "app_id": "<your-app-id>" }]
+}
+```
+
+```typescript
+import { OpenFeature } from '@openfeature/server-sdk';
+import { FlagshipServerProvider } from '@cloudflare/flagship/server';
+import type { FlagshipBinding } from '@cloudflare/flagship/server';
+
+export default {
+  async fetch(request: Request, env: { FLAGS: FlagshipBinding }): Promise<Response> {
+    await OpenFeature.setProviderAndWait(new FlagshipServerProvider({ binding: env.FLAGS }));
+
+    const client = OpenFeature.getClient();
+    const darkMode = await client.getBooleanValue('dark-mode', false, {
+      targetingKey: new URL(request.url).searchParams.get('userId') ?? 'anonymous',
+    });
+
+    return Response.json({ darkMode });
+  },
+};
+```
+
+## Quick start — HTTP
+
+For Workers without a Flagship binding, or non-Workers server environments:
+
+```typescript
+import { OpenFeature } from '@openfeature/server-sdk';
+import { FlagshipServerProvider } from '@cloudflare/flagship/server';
+
+let initialized = false;
+
+export default {
+  async fetch(request: Request): Promise<Response> {
+    if (!initialized) {
+      await OpenFeature.setProviderAndWait(
+        new FlagshipServerProvider({ appId: 'your-app-id', accountId: 'your-account-id', authToken: 'your-token' }),
+      );
+      initialized = true;
+    }
+
+    const client = OpenFeature.getClient();
+    const darkMode = await client.getBooleanValue('dark-mode', false, {
+      userId: new URL(request.url).searchParams.get('userId') ?? 'anonymous',
+    });
+
+    return Response.json({ darkMode });
+  },
+};
+```
+
+## Quick start — browser
+
+```typescript
+import { OpenFeature } from '@openfeature/web-sdk';
+import { FlagshipClientProvider } from '@cloudflare/flagship/web';
+
+await OpenFeature.setProviderAndWait(
+  new FlagshipClientProvider({
+    appId: 'your-app-id',
+    accountId: 'your-account-id',
+    authToken: 'your-token',
+    prefetchFlags: ['dark-mode', 'welcome-message'],
+  }),
+);
+
+await OpenFeature.setContext({ userId: 'user-123', plan: 'premium' });
+
+const client = OpenFeature.getClient();
+const darkMode = client.getBooleanValue('dark-mode', false);
+```
+
+## Features
+
+| Feature               | Description                                                                  |
+| --------------------- | ---------------------------------------------------------------------------- |
+| OpenFeature compliant | Implements the CNCF OpenFeature specification                                |
+| Workers binding       | Native wrangler binding support — zero HTTP overhead, no auth tokens         |
+| Server + client       | Async per-request (server) and sync cache-based (browser) providers          |
+| Server providers      | `FlagshipServerProvider` works via HTTP or wrangler binding                  |
+| All flag types        | Boolean, string, number, and object (JSON)                                   |
+| Authentication        | `authToken` option adds `Authorization: Bearer` to every request (HTTP only) |
+| Logging               | `logging` option surfaces fetch errors and cache misses (off by default)     |
+| Retries + timeouts    | Configurable retry logic with `AbortController`-based timeouts (HTTP only)   |
+| Hooks                 | Built-in `LoggingHook` and `TelemetryHook`                                   |
+| Tree-shakeable        | Server and client bundles are fully isolated                                 |
+| TypeScript            | Strict types throughout                                                      |
+
+## Packages
+
+| Export                        | Description                      | Peer dependency           |
+| ----------------------------- | -------------------------------- | ------------------------- |
+| `@cloudflare/flagship`        | Core client, types, errors       | None                      |
+| `@cloudflare/flagship/server` | `FlagshipServerProvider` + hooks | `@openfeature/server-sdk` |
+| `@cloudflare/flagship/web`    | `FlagshipClientProvider`         | `@openfeature/web-sdk`    |
+
+## Documentation
+
+- [API reference](../../docs/API.md)
+- [OpenFeature specification](https://openfeature.dev/specification/)
+- [Examples](./examples/)
+
+## Development
+
+```bash
+pnpm install         # install dependencies
+pnpm run dev         # watch mode
+pnpm run test        # run tests
+pnpm run build       # build for distribution
+```
+
+## Contributing
+
+Contributions are welcome. Please open an issue first to discuss what you'd like to change. See the [repository](https://github.com/cloudflare/flagship) for more details.
+
+## License
+
+[Apache-2.0](../../LICENSE)

package/dist/{index-C_sW3e_7.d.mts → index-BMGtqsWU.d.mts}

@@ -33,8 +33,10 @@ interface FlagshipProviderOptions {
    */
   accountId?: string;
   /**
-   * Full evaluation endpoint URL. Mutually exclusive with `appId`.
-   * Use this for local development or custom deployments.
+   * Evaluation endpoint. Mutually exclusive with `appId`.
+   * Accepts an absolute URL or a root-relative path. Relative paths are
+   * only supported by `FlagshipClientProvider` and are resolved against
+   * `window.location.origin`.
    */
   endpoint?: string;
   /**
@@ -130,6 +132,64 @@ interface FlagshipEvaluationResponse {
    */
   reason: 'TARGETING_MATCH' | 'DEFAULT' | 'DISABLED' | 'SPLIT';
 }
+/**
+ * Shape of the Flagship wrangler binding exposed on `env` in Cloudflare Workers.
+ *
+ * This is an alias for the `Flagship` class from `@cloudflare/workers-types`.
+ * The binding communicates directly with the Flagship service via workerd RPC —
+ * no HTTP overhead, no auth tokens required. Configure it in `wrangler.json`:
+ *
+ * ```jsonc
+ * {
+ *   "flagship": [
+ *     { "binding": "FLAGS", "app_id": "<your-app-id>" }
+ *   ]
+ * }
+ * ```
+ */
+type FlagshipBinding = Flagship;
+/**
+ * Evaluation details returned by the Flagship binding's `*Details` methods.
+ * Contains the resolved value along with metadata about why that value was
+ * chosen.
+ *
+ * This is an alias for the `FlagshipEvaluationDetails` interface from
+ * `@cloudflare/workers-types`.
+ */
+type FlagshipBindingEvaluationDetails<T> = FlagshipEvaluationDetails<T>;
+/**
+ * Configuration for `FlagshipServerProvider` when using a wrangler binding.
+ *
+ * In this mode the provider delegates all evaluations to the Flagship binding
+ * on `env`, bypassing HTTP entirely. No `appId`, `accountId`, or `authToken`
+ * is required — the binding handles authentication and routing.
+ *
+ * @example
+ * ```typescript
+ * new FlagshipServerProvider({ binding: env.FLAGS })
+ * ```
+ */
+interface FlagshipBindingProviderOptions {
+  /** The Flagship binding from the Worker's `env` object. */
+  binding: FlagshipBinding;
+  /**
+   * Enable SDK-level logging.
+   * @default false
+   */
+  logging?: boolean;
+}
+/**
+ * Options accepted by `FlagshipServerProvider`.
+ *
+ * Provide **either** HTTP configuration (`appId`/`endpoint` + credentials) **or**
+ * a wrangler `binding` — never both. The provider detects which mode to use
+ * based on the presence of the `binding` field.
+ */
+type FlagshipServerProviderOptions = FlagshipProviderOptions | FlagshipBindingProviderOptions;
+/**
+ * Type guard: returns `true` when the options use binding mode.
+ */
+declare function isBindingOptions(options: FlagshipServerProviderOptions): options is FlagshipBindingProviderOptions;
 /**
  * Internal error codes produced by `FlagshipClient`.
  * These are mapped to OpenFeature `ErrorCode` values by the providers.
@@ -230,4 +290,4 @@ declare class FlagshipClient {
   private fetchWithTimeout;
 }
 //#endregion
-export { FlagshipClientProviderOptions as a, FlagshipEvaluationResponse as c, FLAGSHIP_DEFAULT_BASE_URL as i, FlagshipProviderOptions as l, ContextTransformer as n, FlagshipError as o, CachedFlag as r, FlagshipErrorCode as s, FlagshipClient as t };
+export { FlagshipBinding as a, FlagshipClientProviderOptions as c, FlagshipEvaluationResponse as d, FlagshipProviderOptions as f, FLAGSHIP_DEFAULT_BASE_URL as i, FlagshipError as l, isBindingOptions as m, ContextTransformer as n, FlagshipBindingEvaluationDetails as o, FlagshipServerProviderOptions as p, CachedFlag as r, FlagshipBindingProviderOptions as s, FlagshipClient as t, FlagshipErrorCode as u };

package/dist/{index-D8YLMfBG.d.cts → index-BsvVosek.d.cts}

@@ -33,8 +33,10 @@ interface FlagshipProviderOptions {
    */
   accountId?: string;
   /**
-   * Full evaluation endpoint URL. Mutually exclusive with `appId`.
-   * Use this for local development or custom deployments.
+   * Evaluation endpoint. Mutually exclusive with `appId`.
+   * Accepts an absolute URL or a root-relative path. Relative paths are
+   * only supported by `FlagshipClientProvider` and are resolved against
+   * `window.location.origin`.
    */
   endpoint?: string;
   /**
@@ -130,6 +132,64 @@ interface FlagshipEvaluationResponse {
    */
   reason: 'TARGETING_MATCH' | 'DEFAULT' | 'DISABLED' | 'SPLIT';
 }
+/**
+ * Shape of the Flagship wrangler binding exposed on `env` in Cloudflare Workers.
+ *
+ * This is an alias for the `Flagship` class from `@cloudflare/workers-types`.
+ * The binding communicates directly with the Flagship service via workerd RPC —
+ * no HTTP overhead, no auth tokens required. Configure it in `wrangler.json`:
+ *
+ * ```jsonc
+ * {
+ *   "flagship": [
+ *     { "binding": "FLAGS", "app_id": "<your-app-id>" }
+ *   ]
+ * }
+ * ```
+ */
+type FlagshipBinding = Flagship;
+/**
+ * Evaluation details returned by the Flagship binding's `*Details` methods.
+ * Contains the resolved value along with metadata about why that value was
+ * chosen.
+ *
+ * This is an alias for the `FlagshipEvaluationDetails` interface from
+ * `@cloudflare/workers-types`.
+ */
+type FlagshipBindingEvaluationDetails<T> = FlagshipEvaluationDetails<T>;
+/**
+ * Configuration for `FlagshipServerProvider` when using a wrangler binding.
+ *
+ * In this mode the provider delegates all evaluations to the Flagship binding
+ * on `env`, bypassing HTTP entirely. No `appId`, `accountId`, or `authToken`
+ * is required — the binding handles authentication and routing.
+ *
+ * @example
+ * ```typescript
+ * new FlagshipServerProvider({ binding: env.FLAGS })
+ * ```
+ */
+interface FlagshipBindingProviderOptions {
+  /** The Flagship binding from the Worker's `env` object. */
+  binding: FlagshipBinding;
+  /**
+   * Enable SDK-level logging.
+   * @default false
+   */
+  logging?: boolean;
+}
+/**
+ * Options accepted by `FlagshipServerProvider`.
+ *
+ * Provide **either** HTTP configuration (`appId`/`endpoint` + credentials) **or**
+ * a wrangler `binding` — never both. The provider detects which mode to use
+ * based on the presence of the `binding` field.
+ */
+type FlagshipServerProviderOptions = FlagshipProviderOptions | FlagshipBindingProviderOptions;
+/**
+ * Type guard: returns `true` when the options use binding mode.
+ */
+declare function isBindingOptions(options: FlagshipServerProviderOptions): options is FlagshipBindingProviderOptions;
 /**
  * Internal error codes produced by `FlagshipClient`.
  * These are mapped to OpenFeature `ErrorCode` values by the providers.
@@ -230,4 +290,4 @@ declare class FlagshipClient {
   private fetchWithTimeout;
 }
 //#endregion
-export { FlagshipClientProviderOptions as a, FlagshipEvaluationResponse as c, FLAGSHIP_DEFAULT_BASE_URL as i, FlagshipProviderOptions as l, ContextTransformer as n, FlagshipError as o, CachedFlag as r, FlagshipErrorCode as s, FlagshipClient as t };
+export { FlagshipBinding as a, FlagshipClientProviderOptions as c, FlagshipEvaluationResponse as d, FlagshipProviderOptions as f, FLAGSHIP_DEFAULT_BASE_URL as i, FlagshipError as l, isBindingOptions as m, ContextTransformer as n, FlagshipBindingEvaluationDetails as o, FlagshipServerProviderOptions as p, CachedFlag as r, FlagshipBindingProviderOptions as s, FlagshipClient as t, FlagshipErrorCode as u };

package/dist/index.cjs

@@ -1,7 +1 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("./src-De-abNIr.cjs");
-exports.ContextTransformer = require_src.ContextTransformer;
-exports.FLAGSHIP_DEFAULT_BASE_URL = require_src.FLAGSHIP_DEFAULT_BASE_URL;
-exports.FlagshipClient = require_src.FlagshipClient;
-exports.FlagshipError = require_src.FlagshipError;
-exports.FlagshipErrorCode = require_src.FlagshipErrorCode;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./src-QEIBSid3.cjs`);exports.ContextTransformer=e.n,exports.FLAGSHIP_DEFAULT_BASE_URL=e.r,exports.FlagshipClient=e.t,exports.FlagshipError=e.i,exports.FlagshipErrorCode=e.a,exports.isBindingOptions=e.o;

package/dist/index.d.cts

@@ -1,2 +1,2 @@
-import { a as FlagshipClientProviderOptions, c as FlagshipEvaluationResponse, i as FLAGSHIP_DEFAULT_BASE_URL, l as FlagshipProviderOptions, n as ContextTransformer, o as FlagshipError, r as CachedFlag, s as FlagshipErrorCode, t as FlagshipClient } from "./index-D8YLMfBG.cjs";
-export { CachedFlag, ContextTransformer, FLAGSHIP_DEFAULT_BASE_URL, FlagshipClient, FlagshipClientProviderOptions, FlagshipError, FlagshipErrorCode, FlagshipEvaluationResponse, FlagshipProviderOptions };
+import { a as FlagshipBinding, c as FlagshipClientProviderOptions, d as FlagshipEvaluationResponse, f as FlagshipProviderOptions, i as FLAGSHIP_DEFAULT_BASE_URL, l as FlagshipError, m as isBindingOptions, n as ContextTransformer, o as FlagshipBindingEvaluationDetails, p as FlagshipServerProviderOptions, r as CachedFlag, s as FlagshipBindingProviderOptions, t as FlagshipClient, u as FlagshipErrorCode } from "./index-BsvVosek.cjs";
+export { CachedFlag, ContextTransformer, FLAGSHIP_DEFAULT_BASE_URL, FlagshipBinding, FlagshipBindingEvaluationDetails, FlagshipBindingProviderOptions, FlagshipClient, FlagshipClientProviderOptions, FlagshipError, FlagshipErrorCode, FlagshipEvaluationResponse, FlagshipProviderOptions, FlagshipServerProviderOptions, isBindingOptions };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { a as FlagshipClientProviderOptions, c as FlagshipEvaluationResponse, i as FLAGSHIP_DEFAULT_BASE_URL, l as FlagshipProviderOptions, n as ContextTransformer, o as FlagshipError, r as CachedFlag, s as FlagshipErrorCode, t as FlagshipClient } from "./index-C_sW3e_7.mjs";
-export { CachedFlag, ContextTransformer, FLAGSHIP_DEFAULT_BASE_URL, FlagshipClient, FlagshipClientProviderOptions, FlagshipError, FlagshipErrorCode, FlagshipEvaluationResponse, FlagshipProviderOptions };
+import { a as FlagshipBinding, c as FlagshipClientProviderOptions, d as FlagshipEvaluationResponse, f as FlagshipProviderOptions, i as FLAGSHIP_DEFAULT_BASE_URL, l as FlagshipError, m as isBindingOptions, n as ContextTransformer, o as FlagshipBindingEvaluationDetails, p as FlagshipServerProviderOptions, r as CachedFlag, s as FlagshipBindingProviderOptions, t as FlagshipClient, u as FlagshipErrorCode } from "./index-BMGtqsWU.mjs";
+export { CachedFlag, ContextTransformer, FLAGSHIP_DEFAULT_BASE_URL, FlagshipBinding, FlagshipBindingEvaluationDetails, FlagshipBindingProviderOptions, FlagshipClient, FlagshipClientProviderOptions, FlagshipError, FlagshipErrorCode, FlagshipEvaluationResponse, FlagshipProviderOptions, FlagshipServerProviderOptions, isBindingOptions };

package/dist/index.mjs

@@ -1,2 +1 @@
-import { a as FlagshipErrorCode, i as FlagshipError, n as ContextTransformer, r as FLAGSHIP_DEFAULT_BASE_URL, t as FlagshipClient } from "./src-CiVDWmng.mjs";
-export { ContextTransformer, FLAGSHIP_DEFAULT_BASE_URL, FlagshipClient, FlagshipError, FlagshipErrorCode };
+import{a as e,i as t,n,o as r,r as i,t as a}from"./src-DW2QohY9.mjs";export{n as ContextTransformer,i as FLAGSHIP_DEFAULT_BASE_URL,a as FlagshipClient,t as FlagshipError,e as FlagshipErrorCode,r as isBindingOptions};

package/dist/server.cjs

@@ -1,298 +1 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("./src-De-abNIr.cjs");
-let _openfeature_server_sdk = require("@openfeature/server-sdk");
-//#region src/server-provider.ts
-const _noop = () => {};
-/**
-* OpenFeature provider for Flagship (server-side / dynamic context).
-*
-* Use this provider with `@openfeature/server-sdk` for Node.js,
-* Cloudflare Workers, and other server-side JavaScript environments.
-*
-* @example
-* ```typescript
-* import { OpenFeature } from '@openfeature/server-sdk';
-* import { FlagshipServerProvider } from '@cloudflare/flagship/server';
-*
-* await OpenFeature.setProviderAndWait(
-*   new FlagshipServerProvider({
-*     appId: 'app-abc123',
-*     accountId: 'your-account-id',
-*     authToken: 'your-token',
-*   })
-* );
-*
-* const client = OpenFeature.getClient();
-* const value = await client.getBooleanValue('my-flag', false, {
-*   targetingKey: 'user-123',
-*   email: 'user@example.com',
-* });
-* ```
-*/
-var FlagshipServerProvider = class {
-	constructor(options) {
-		this.runsOn = "server";
-		this.events = new _openfeature_server_sdk.OpenFeatureEventEmitter();
-		this.currentStatus = _openfeature_server_sdk.ProviderStatus.NOT_READY;
-		this.metadata = { name: "Flagship Server Provider" };
-		this.client = new require_src.FlagshipClient(options);
-		this.logging = options.logging ?? false;
-	}
-	/**
-	* Returns the provided logger when logging is enabled, or a no-op logger
-	* when `logging` is `false`. Using this in every resolve method ensures
-	* the SDK produces no console output unless the caller opts in.
-	*/
-	logger(logger) {
-		if (this.logging) return logger;
-		return {
-			debug: _noop,
-			info: _noop,
-			warn: _noop,
-			error: _noop
-		};
-	}
-	/**
-	* Probes the evaluation endpoint with a health-check request. A 404 response
-	* is treated as success — it means the endpoint is reachable but the
-	* health-check flag simply doesn't exist, which is expected. Any network
-	* failure or timeout sets the status to ERROR.
-	*/
-	async initialize(_context) {
-		try {
-			await this.client.evaluate("_flagship_health_check", {});
-			this.currentStatus = _openfeature_server_sdk.ProviderStatus.READY;
-			this.events.emit(_openfeature_server_sdk.ProviderEvents.Ready);
-		} catch (error) {
-			if (error instanceof require_src.FlagshipError && error.cause instanceof Response && error.cause.status === 404) {
-				this.currentStatus = _openfeature_server_sdk.ProviderStatus.READY;
-				this.events.emit(_openfeature_server_sdk.ProviderEvents.Ready);
-				return;
-			}
-			this.currentStatus = _openfeature_server_sdk.ProviderStatus.ERROR;
-			this.events.emit(_openfeature_server_sdk.ProviderEvents.Error, { message: error instanceof Error ? error.message : String(error) });
-		}
-	}
-	async onClose() {
-		this.currentStatus = _openfeature_server_sdk.ProviderStatus.NOT_READY;
-	}
-	get status() {
-		return this.currentStatus;
-	}
-	async resolveBooleanEvaluation(flagKey, defaultValue, context, logger) {
-		return this.resolve(flagKey, defaultValue, context, "boolean", logger);
-	}
-	async resolveStringEvaluation(flagKey, defaultValue, context, logger) {
-		return this.resolve(flagKey, defaultValue, context, "string", logger);
-	}
-	async resolveNumberEvaluation(flagKey, defaultValue, context, logger) {
-		return this.resolve(flagKey, defaultValue, context, "number", logger);
-	}
-	async resolveObjectEvaluation(flagKey, defaultValue, context, logger) {
-		return this.resolve(flagKey, defaultValue, context, "object", logger);
-	}
-	async resolve(flagKey, defaultValue, context, expectedType, logger) {
-		const log = this.logger(logger);
-		try {
-			log.debug(`[Flagship] Evaluating flag "${flagKey}" (expected: ${expectedType})`);
-			const result = await this.client.evaluate(flagKey, context);
-			const actualType = this.getValueType(result.value);
-			if (actualType !== expectedType) {
-				const msg = `Flag "${flagKey}" type mismatch: expected ${expectedType}, got ${actualType}`;
-				log.warn(`[Flagship] ${msg}`);
-				return {
-					value: defaultValue,
-					errorCode: _openfeature_server_sdk.ErrorCode.TYPE_MISMATCH,
-					errorMessage: msg,
-					reason: "ERROR"
-				};
-			}
-			log.debug(`[Flagship] Flag "${flagKey}" resolved: value=${String(result.value)} reason=${result.reason} variant=${result.variant}`);
-			return {
-				value: result.value,
-				variant: result.variant,
-				reason: result.reason,
-				flagMetadata: {}
-			};
-		} catch (error) {
-			return this.handleError(flagKey, defaultValue, error, log);
-		}
-	}
-	/**
-	* Maps a runtime value to one of the four OpenFeature flag types.
-	* `null` maps to `'object'` (typeof null === 'object'), treating it as a
-	* JSON null which belongs to the object/structure category.
-	*/
-	getValueType(value) {
-		if (typeof value === "boolean") return "boolean";
-		if (typeof value === "string") return "string";
-		if (typeof value === "number") return "number";
-		return "object";
-	}
-	handleError(flagKey, defaultValue, error, logger) {
-		if (error instanceof require_src.FlagshipError) {
-			let errorCode;
-			switch (error.code) {
-				case require_src.FlagshipErrorCode.NETWORK_ERROR:
-					errorCode = error.cause instanceof Response && error.cause.status === 404 ? _openfeature_server_sdk.ErrorCode.FLAG_NOT_FOUND : _openfeature_server_sdk.ErrorCode.GENERAL;
-					break;
-				case require_src.FlagshipErrorCode.TIMEOUT_ERROR:
-					errorCode = _openfeature_server_sdk.ErrorCode.GENERAL;
-					break;
-				case require_src.FlagshipErrorCode.PARSE_ERROR:
-					errorCode = _openfeature_server_sdk.ErrorCode.PARSE_ERROR;
-					break;
-				case require_src.FlagshipErrorCode.INVALID_CONTEXT:
-					errorCode = _openfeature_server_sdk.ErrorCode.INVALID_CONTEXT;
-					break;
-				default: errorCode = _openfeature_server_sdk.ErrorCode.GENERAL;
-			}
-			logger.error(`[Flagship] Flag "${flagKey}" evaluation failed (${errorCode}): ${error.message}`);
-			return {
-				value: defaultValue,
-				errorCode,
-				errorMessage: error.message,
-				reason: "ERROR"
-			};
-		}
-		const errorMessage = String(error);
-		logger.error(`[Flagship] Flag "${flagKey}" evaluation failed (GENERAL): ${errorMessage}`);
-		return {
-			value: defaultValue,
-			errorCode: _openfeature_server_sdk.ErrorCode.GENERAL,
-			errorMessage,
-			reason: "ERROR"
-		};
-	}
-};
-//#endregion
-//#region src/hooks/logging-hook.ts
-/**
-* Logging hook for debugging flag evaluations
-*
-* @example
-* ```typescript
-* import { OpenFeature } from '@openfeature/server-sdk';
-* import { FlagshipServerProvider, LoggingHook } from '@cloudflare/flagship/server';
-*
-* const provider = new FlagshipServerProvider({ appId: 'your-app-id', accountId: 'your-account-id' });
-* await OpenFeature.setProviderAndWait(provider);
-*
-* // Add logging hook
-* OpenFeature.addHooks(new LoggingHook());
-* ```
-*/
-var LoggingHook = class {
-	constructor(logger = console.log) {
-		this.logger = logger;
-	}
-	before(hookContext, _hookHints) {
-		this.logger(`[Flagship] Evaluating flag: ${hookContext.flagKey}`, {
-			defaultValue: hookContext.defaultValue,
-			context: hookContext.context
-		});
-	}
-	after(hookContext, evaluationDetails, _hookHints) {
-		this.logger(`[Flagship] Flag ${hookContext.flagKey} evaluated`, {
-			value: evaluationDetails.value,
-			reason: evaluationDetails.reason,
-			variant: evaluationDetails.variant,
-			errorCode: evaluationDetails.errorCode
-		});
-	}
-	error(hookContext, error, _hookHints) {
-		const message = error instanceof Error ? error.message : String(error);
-		this.logger(`[Flagship] Error evaluating flag ${hookContext.flagKey}:`, message);
-	}
-	finally(_hookContext, _evaluationDetails, _hookHints) {}
-};
-//#endregion
-//#region src/hooks/telemetry-hook.ts
-/**
-* Telemetry hook for tracking flag evaluations
-*
-* @example
-* ```typescript
-* import { OpenFeature } from '@openfeature/server-sdk';
-* import { FlagshipServerProvider, TelemetryHook } from '@cloudflare/flagship/server';
-*
-* const telemetryHook = new TelemetryHook((event) => {
-*   // Send to your analytics service
-*   analytics.track('flag_evaluated', event);
-* });
-*
-* OpenFeature.addHooks(telemetryHook);
-* ```
-*/
-var TelemetryHook = class {
-	constructor(onEvent) {
-		this.startTimes = /* @__PURE__ */ new Map();
-		this.contextKeys = /* @__PURE__ */ new WeakMap();
-		this.hints = /* @__PURE__ */ new WeakMap();
-		this.onEvent = onEvent;
-	}
-	before(hookContext, hookHints) {
-		const now = Date.now();
-		const key = `${hookContext.flagKey}-${now}-${Math.random()}`;
-		this.startTimes.set(key, now);
-		this.contextKeys.set(hookContext, key);
-		if (hookHints !== void 0) this.hints.set(hookContext, hookHints);
-	}
-	after(hookContext, evaluationDetails, _hookHints) {
-		const telemetryKey = this.contextKeys.get(hookContext);
-		const startTime = telemetryKey ? this.startTimes.get(telemetryKey) : void 0;
-		const duration = startTime !== void 0 ? Date.now() - startTime : void 0;
-		if (telemetryKey !== void 0) {
-			this.startTimes.delete(telemetryKey);
-			this.contextKeys.delete(hookContext);
-		}
-		this.onEvent({
-			type: "evaluation",
-			flagKey: hookContext.flagKey,
-			timestamp: Date.now(),
-			duration,
-			value: evaluationDetails.value,
-			reason: evaluationDetails.reason,
-			variant: evaluationDetails.variant,
-			errorCode: evaluationDetails.errorCode,
-			context: hookContext.context,
-			hints: this.hints.get(hookContext)
-		});
-	}
-	error(hookContext, error, _hookHints) {
-		const telemetryKey = this.contextKeys.get(hookContext);
-		const startTime = telemetryKey ? this.startTimes.get(telemetryKey) : void 0;
-		const duration = startTime !== void 0 ? Date.now() - startTime : void 0;
-		if (telemetryKey !== void 0) {
-			this.startTimes.delete(telemetryKey);
-			this.contextKeys.delete(hookContext);
-		}
-		const errorMessage = error instanceof Error ? error.message : String(error);
-		this.onEvent({
-			type: "error",
-			flagKey: hookContext.flagKey,
-			timestamp: Date.now(),
-			duration,
-			errorMessage,
-			context: hookContext.context,
-			hints: this.hints.get(hookContext)
-		});
-	}
-	finally(hookContext, _evaluationDetails, _hookHints) {
-		const telemetryKey = this.contextKeys.get(hookContext);
-		if (telemetryKey !== void 0) {
-			this.startTimes.delete(telemetryKey);
-			this.contextKeys.delete(hookContext);
-		}
-		this.hints.delete(hookContext);
-	}
-};
-//#endregion
-exports.ContextTransformer = require_src.ContextTransformer;
-exports.FLAGSHIP_DEFAULT_BASE_URL = require_src.FLAGSHIP_DEFAULT_BASE_URL;
-exports.FlagshipClient = require_src.FlagshipClient;
-exports.FlagshipError = require_src.FlagshipError;
-exports.FlagshipErrorCode = require_src.FlagshipErrorCode;
-exports.FlagshipServerProvider = FlagshipServerProvider;
-exports.LoggingHook = LoggingHook;
-exports.TelemetryHook = TelemetryHook;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./src-QEIBSid3.cjs`);let t=require(`@openfeature/server-sdk`);const n=()=>{},r=[`appId`,`endpoint`,`accountId`,`authToken`,`baseUrl`,`fetchOptions`,`timeout`,`retries`,`retryDelay`];var i=class{constructor(n){if(this.runsOn=`server`,this.events=new t.OpenFeatureEventEmitter,this.currentStatus=t.ProviderStatus.NOT_READY,this.metadata={name:`Flagship Server Provider`},this.logging=n.logging??!1,e.o(n)){let e=r.filter(e=>e in n);if(e.length>0)throw Error(`Flagship: when using a binding, the following HTTP-specific options must not be provided: ${e.join(`, `)}. Provide either a binding or HTTP configuration, not both.`);this.binding=n.binding,this.client=void 0,this.resolve=this.resolveViaBinding.bind(this)}else this.client=new e.t(n),this.binding=void 0,this.resolve=this.resolveViaHttp.bind(this)}logger(e){return this.logging?e:{debug:n,info:n,warn:n,error:n}}async initialize(n){if(this.binding){this.currentStatus=t.ProviderStatus.READY,this.events.emit(t.ProviderEvents.Ready);return}try{await this.client.evaluate(`_flagship_health_check`,{}),this.currentStatus=t.ProviderStatus.READY,this.events.emit(t.ProviderEvents.Ready)}catch(n){if(n instanceof e.i&&n.cause instanceof Response&&n.cause.status===404){this.currentStatus=t.ProviderStatus.READY,this.events.emit(t.ProviderEvents.Ready);return}this.currentStatus=t.ProviderStatus.ERROR,this.events.emit(t.ProviderEvents.Error,{message:n instanceof Error?n.message:String(n)})}}async onClose(){this.currentStatus=t.ProviderStatus.NOT_READY}get status(){return this.currentStatus}async resolveBooleanEvaluation(e,t,n,r){return this.resolve(e,t,n,`boolean`,r)}async resolveStringEvaluation(e,t,n,r){return this.resolve(e,t,n,`string`,r)}async resolveNumberEvaluation(e,t,n,r){return this.resolve(e,t,n,`number`,r)}async resolveObjectEvaluation(e,t,n,r){return this.resolve(e,t,n,`object`,r)}async resolveViaHttp(e,n,r,i,o){let s=this.logger(o);try{s.debug(`[Flagship] Evaluating flag "${e}" (expected: ${i})`);let o=await this.client.evaluate(e,r),c=a(o.value);if(c!==i){let r=`Flag "${e}" type mismatch: expected ${i}, got ${c}`;return s.warn(`[Flagship] ${r}`),{value:n,errorCode:t.ErrorCode.TYPE_MISMATCH,errorMessage:r,reason:`ERROR`}}return s.debug(`[Flagship] Flag "${e}" resolved: value=${String(o.value)} reason=${o.reason} variant=${o.variant}`),{value:o.value,variant:o.variant,reason:o.reason,flagMetadata:{}}}catch(t){return this.handleHttpError(e,n,t,s)}}handleHttpError(n,r,i,a){if(i instanceof e.i){let o;switch(i.code){case e.a.NETWORK_ERROR:o=i.cause instanceof Response&&i.cause.status===404?t.ErrorCode.FLAG_NOT_FOUND:t.ErrorCode.GENERAL;break;case e.a.TIMEOUT_ERROR:o=t.ErrorCode.GENERAL;break;case e.a.PARSE_ERROR:o=t.ErrorCode.PARSE_ERROR;break;case e.a.INVALID_CONTEXT:o=t.ErrorCode.INVALID_CONTEXT;break;default:o=t.ErrorCode.GENERAL}return a.error(`[Flagship] Flag "${n}" evaluation failed (${o}): ${i.message}`),{value:r,errorCode:o,errorMessage:i.message,reason:`ERROR`}}let o=String(i);return a.error(`[Flagship] Flag "${n}" evaluation failed (GENERAL): ${o}`),{value:r,errorCode:t.ErrorCode.GENERAL,errorMessage:o,reason:`ERROR`}}async resolveViaBinding(e,n,r,i,c){let l=this.logger(c);try{l.debug(`[Flagship] Evaluating flag "${e}" via binding (expected: ${i})`);let c=o(r,l),u=await this.evaluateBinding(e,n,i,c);if(u.errorCode){let t=s(u.errorCode),r=u.errorMessage??`Binding error: ${u.errorCode}`;return l.error(`[Flagship] Flag "${e}" evaluation failed (${t}): ${r}`),{value:n,errorCode:t,errorMessage:r,reason:u.reason??`ERROR`}}let d=a(u.value);if(d!==i){let r=`Flag "${e}" type mismatch: expected ${i}, got ${d}`;return l.warn(`[Flagship] ${r}`),{value:n,errorCode:t.ErrorCode.TYPE_MISMATCH,errorMessage:r,reason:`ERROR`}}return l.debug(`[Flagship] Flag "${e}" resolved via binding: value=${String(u.value)} reason=${u.reason} variant=${u.variant}`),{value:u.value,variant:u.variant,reason:u.reason,flagMetadata:{}}}catch(r){let i=r instanceof Error?r.message:String(r);return l.error(`[Flagship] Flag "${e}" binding evaluation failed (GENERAL): ${i}`),{value:n,errorCode:t.ErrorCode.GENERAL,errorMessage:i,reason:`ERROR`}}}async evaluateBinding(e,t,n,r){let i=this.binding;switch(n){case`boolean`:return i.getBooleanDetails(e,t,r);case`string`:return i.getStringDetails(e,t,r);case`number`:return i.getNumberDetails(e,t,r);case`object`:return i.getObjectDetails(e,t,r)}}};function a(e){return typeof e==`boolean`?`boolean`:typeof e==`string`?`string`:typeof e==`number`?`number`:`object`}function o(e,t){let n={};for(let[r,i]of Object.entries(e))if(i!=null){if(i instanceof Date){n[r]=i.toISOString();continue}if(typeof i==`string`||typeof i==`number`||typeof i==`boolean`){n[r]=i;continue}if(typeof i==`object`){t.warn(`[Flagship] Context key "${r}" is a complex object/array and cannot be passed to the binding. This value will be ignored.`);continue}}return n}function s(e){switch(e){case`FLAG_NOT_FOUND`:return t.ErrorCode.FLAG_NOT_FOUND;case`PARSE_ERROR`:return t.ErrorCode.PARSE_ERROR;case`TYPE_MISMATCH`:return t.ErrorCode.TYPE_MISMATCH;case`INVALID_CONTEXT`:return t.ErrorCode.INVALID_CONTEXT;default:return t.ErrorCode.GENERAL}}var c=class{constructor(e=console.log){this.logger=e}before(e,t){this.logger(`[Flagship] Evaluating flag: ${e.flagKey}`,{defaultValue:e.defaultValue,context:e.context})}after(e,t,n){this.logger(`[Flagship] Flag ${e.flagKey} evaluated`,{value:t.value,reason:t.reason,variant:t.variant,errorCode:t.errorCode})}error(e,t,n){let r=t instanceof Error?t.message:String(t);this.logger(`[Flagship] Error evaluating flag ${e.flagKey}:`,r)}finally(e,t,n){}},l=class{constructor(e){this.startTimes=new Map,this.contextKeys=new WeakMap,this.hints=new WeakMap,this.onEvent=e}before(e,t){let n=Date.now(),r=`${e.flagKey}-${n}-${Math.random()}`;this.startTimes.set(r,n),this.contextKeys.set(e,r),t!==void 0&&this.hints.set(e,t)}after(e,t,n){let r=this.contextKeys.get(e),i=r?this.startTimes.get(r):void 0,a=i===void 0?void 0:Date.now()-i;r!==void 0&&(this.startTimes.delete(r),this.contextKeys.delete(e)),this.onEvent({type:`evaluation`,flagKey:e.flagKey,timestamp:Date.now(),duration:a,value:t.value,reason:t.reason,variant:t.variant,errorCode:t.errorCode,context:e.context,hints:this.hints.get(e)})}error(e,t,n){let r=this.contextKeys.get(e),i=r?this.startTimes.get(r):void 0,a=i===void 0?void 0:Date.now()-i;r!==void 0&&(this.startTimes.delete(r),this.contextKeys.delete(e));let o=t instanceof Error?t.message:String(t);this.onEvent({type:`error`,flagKey:e.flagKey,timestamp:Date.now(),duration:a,errorMessage:o,context:e.context,hints:this.hints.get(e)})}finally(e,t,n){let r=this.contextKeys.get(e);r!==void 0&&(this.startTimes.delete(r),this.contextKeys.delete(e)),this.hints.delete(e)}};exports.ContextTransformer=e.n,exports.FLAGSHIP_DEFAULT_BASE_URL=e.r,exports.FlagshipClient=e.t,exports.FlagshipError=e.i,exports.FlagshipErrorCode=e.a,exports.FlagshipServerProvider=i,exports.LoggingHook=c,exports.TelemetryHook=l,exports.isBindingOptions=e.o;