@cloudflare/flagship 0.0.3 → 0.2.0

package/dist/server.d.cts

@@ -1,14 +1,20 @@
-import { c as FlagshipEvaluationResponse, i as FLAGSHIP_DEFAULT_BASE_URL, l as FlagshipProviderOptions, n as ContextTransformer, o as FlagshipError, s as FlagshipErrorCode, t as FlagshipClient } from "./index-D8YLMfBG.cjs";
+import { a as FlagshipBinding, 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, s as FlagshipBindingProviderOptions, t as FlagshipClient, u as FlagshipErrorCode } from "./index-BsvVosek.cjs";
 import { BeforeHookContext, ErrorCode, EvaluationContext, EvaluationDetails, FlagValue, Hook, HookContext, HookHints, JsonValue, Logger, OpenFeatureEventEmitter, Provider, ProviderMetadata, ProviderStatus, ResolutionDetails } from "@openfeature/server-sdk";
 
 //#region src/server-provider.d.ts
 /**
  * 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.
+ * Supports two modes of operation:
  *
- * @example
+ * **HTTP mode** — evaluates flags via HTTP requests to the Flagship API.
+ * Requires `appId`/`endpoint`, `accountId`, and optionally `authToken`.
+ *
+ * **Binding mode** — evaluates flags via a Cloudflare Workers wrangler binding.
+ * Only requires the `binding` field (the `Flagship` object from `env`). No HTTP
+ * overhead, no auth tokens. This is the recommended approach for Workers.
+ *
+ * @example HTTP mode
  * ```typescript
  * import { OpenFeature } from '@openfeature/server-sdk';
  * import { FlagshipServerProvider } from '@cloudflare/flagship/server';
@@ -20,22 +26,37 @@ import { BeforeHookContext, ErrorCode, EvaluationContext, EvaluationDetails, Fla
  *     authToken: 'your-token',
  *   })
  * );
+ * ```
  *
- * const client = OpenFeature.getClient();
- * const value = await client.getBooleanValue('my-flag', false, {
- *   targetingKey: 'user-123',
- *   email: 'user@example.com',
- * });
+ * @example Binding mode (Cloudflare Workers)
+ * ```typescript
+ * import { OpenFeature } from '@openfeature/server-sdk';
+ * import { FlagshipServerProvider } from '@cloudflare/flagship/server';
+ *
+ * export default {
+ *   async fetch(request: Request, env: { FLAGS: FlagshipBinding }) {
+ *     await OpenFeature.setProviderAndWait(
+ *       new FlagshipServerProvider({ binding: env.FLAGS })
+ *     );
+ *     const client = OpenFeature.getClient();
+ *     const value = await client.getBooleanValue('my-flag', false);
+ *     return new Response(JSON.stringify({ value }));
+ *   },
+ * };
  * ```
  */
 declare class FlagshipServerProvider implements Provider {
   readonly metadata: ProviderMetadata;
   readonly runsOn: "server";
   readonly events: OpenFeatureEventEmitter;
+  /** Set when operating in HTTP mode; `undefined` in binding mode. */
   private readonly client;
+  /** Set when operating in binding mode; `undefined` in HTTP mode. */
+  private readonly binding;
   private readonly logging;
   private currentStatus;
-  constructor(options: FlagshipProviderOptions);
+  private readonly resolve;
+  constructor(options: FlagshipServerProviderOptions);
   /**
    * Returns the provided logger when logging is enabled, or a no-op logger
    * when `logging` is `false`. Using this in every resolve method ensures
@@ -43,10 +64,14 @@ declare class FlagshipServerProvider implements Provider {
    */
   private logger;
   /**
-   * 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.
+   * Initializes the provider.
+   *
+   * **HTTP mode**: 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.
+   *
+   * **Binding mode**: sets READY immediately — the binding is guaranteed to
+   * be available by the Workers runtime.
    */
   initialize(_context?: EvaluationContext): Promise<void>;
   onClose(): Promise<void>;
@@ -55,14 +80,14 @@ declare class FlagshipServerProvider implements Provider {
   resolveStringEvaluation(flagKey: string, defaultValue: string, context: EvaluationContext, logger: Logger): Promise<ResolutionDetails<string>>;
   resolveNumberEvaluation(flagKey: string, defaultValue: number, context: EvaluationContext, logger: Logger): Promise<ResolutionDetails<number>>;
   resolveObjectEvaluation<T extends JsonValue>(flagKey: string, defaultValue: T, context: EvaluationContext, logger: Logger): Promise<ResolutionDetails<T>>;
-  private resolve;
+  private resolveViaHttp;
+  private handleHttpError;
+  private resolveViaBinding;
   /**
-   * 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.
+   * Calls the appropriate `*Details` method on the binding based on the
+   * expected type. Falls back to `get` + synthetic details for unknown types.
    */
-  private getValueType;
-  private handleError;
+  private evaluateBinding;
 }
 //#endregion
 //#region src/hooks/logging-hook.d.ts
@@ -141,4 +166,4 @@ declare class TelemetryHook implements Hook {
   finally(hookContext: Readonly<HookContext>, _evaluationDetails: EvaluationDetails<FlagValue>, _hookHints?: HookHints): void;
 }
 //#endregion
-export { ContextTransformer, FLAGSHIP_DEFAULT_BASE_URL, FlagshipClient, FlagshipError, FlagshipErrorCode, type FlagshipEvaluationResponse, type FlagshipProviderOptions, FlagshipServerProvider, LoggingHook, type TelemetryEvent, TelemetryHook };
+export { ContextTransformer, FLAGSHIP_DEFAULT_BASE_URL, type FlagshipBinding, type FlagshipBindingEvaluationDetails, type FlagshipBindingProviderOptions, FlagshipClient, FlagshipError, FlagshipErrorCode, type FlagshipEvaluationResponse, type FlagshipProviderOptions, FlagshipServerProvider, type FlagshipServerProviderOptions, LoggingHook, type TelemetryEvent, TelemetryHook, isBindingOptions };

package/dist/server.d.mts

@@ -1,14 +1,20 @@
-import { c as FlagshipEvaluationResponse, i as FLAGSHIP_DEFAULT_BASE_URL, l as FlagshipProviderOptions, n as ContextTransformer, o as FlagshipError, s as FlagshipErrorCode, t as FlagshipClient } from "./index-C_sW3e_7.mjs";
+import { a as FlagshipBinding, 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, s as FlagshipBindingProviderOptions, t as FlagshipClient, u as FlagshipErrorCode } from "./index-BMGtqsWU.mjs";
 import { BeforeHookContext, ErrorCode, EvaluationContext, EvaluationDetails, FlagValue, Hook, HookContext, HookHints, JsonValue, Logger, OpenFeatureEventEmitter, Provider, ProviderMetadata, ProviderStatus, ResolutionDetails } from "@openfeature/server-sdk";
 
 //#region src/server-provider.d.ts
 /**
  * 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.
+ * Supports two modes of operation:
  *
- * @example
+ * **HTTP mode** — evaluates flags via HTTP requests to the Flagship API.
+ * Requires `appId`/`endpoint`, `accountId`, and optionally `authToken`.
+ *
+ * **Binding mode** — evaluates flags via a Cloudflare Workers wrangler binding.
+ * Only requires the `binding` field (the `Flagship` object from `env`). No HTTP
+ * overhead, no auth tokens. This is the recommended approach for Workers.
+ *
+ * @example HTTP mode
  * ```typescript
  * import { OpenFeature } from '@openfeature/server-sdk';
  * import { FlagshipServerProvider } from '@cloudflare/flagship/server';
@@ -20,22 +26,37 @@ import { BeforeHookContext, ErrorCode, EvaluationContext, EvaluationDetails, Fla
  *     authToken: 'your-token',
  *   })
  * );
+ * ```
  *
- * const client = OpenFeature.getClient();
- * const value = await client.getBooleanValue('my-flag', false, {
- *   targetingKey: 'user-123',
- *   email: 'user@example.com',
- * });
+ * @example Binding mode (Cloudflare Workers)
+ * ```typescript
+ * import { OpenFeature } from '@openfeature/server-sdk';
+ * import { FlagshipServerProvider } from '@cloudflare/flagship/server';
+ *
+ * export default {
+ *   async fetch(request: Request, env: { FLAGS: FlagshipBinding }) {
+ *     await OpenFeature.setProviderAndWait(
+ *       new FlagshipServerProvider({ binding: env.FLAGS })
+ *     );
+ *     const client = OpenFeature.getClient();
+ *     const value = await client.getBooleanValue('my-flag', false);
+ *     return new Response(JSON.stringify({ value }));
+ *   },
+ * };
  * ```
  */
 declare class FlagshipServerProvider implements Provider {
   readonly metadata: ProviderMetadata;
   readonly runsOn: "server";
   readonly events: OpenFeatureEventEmitter;
+  /** Set when operating in HTTP mode; `undefined` in binding mode. */
   private readonly client;
+  /** Set when operating in binding mode; `undefined` in HTTP mode. */
+  private readonly binding;
   private readonly logging;
   private currentStatus;
-  constructor(options: FlagshipProviderOptions);
+  private readonly resolve;
+  constructor(options: FlagshipServerProviderOptions);
   /**
    * Returns the provided logger when logging is enabled, or a no-op logger
    * when `logging` is `false`. Using this in every resolve method ensures
@@ -43,10 +64,14 @@ declare class FlagshipServerProvider implements Provider {
    */
   private logger;
   /**
-   * 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.
+   * Initializes the provider.
+   *
+   * **HTTP mode**: 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.
+   *
+   * **Binding mode**: sets READY immediately — the binding is guaranteed to
+   * be available by the Workers runtime.
    */
   initialize(_context?: EvaluationContext): Promise<void>;
   onClose(): Promise<void>;
@@ -55,14 +80,14 @@ declare class FlagshipServerProvider implements Provider {
   resolveStringEvaluation(flagKey: string, defaultValue: string, context: EvaluationContext, logger: Logger): Promise<ResolutionDetails<string>>;
   resolveNumberEvaluation(flagKey: string, defaultValue: number, context: EvaluationContext, logger: Logger): Promise<ResolutionDetails<number>>;
   resolveObjectEvaluation<T extends JsonValue>(flagKey: string, defaultValue: T, context: EvaluationContext, logger: Logger): Promise<ResolutionDetails<T>>;
-  private resolve;
+  private resolveViaHttp;
+  private handleHttpError;
+  private resolveViaBinding;
   /**
-   * 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.
+   * Calls the appropriate `*Details` method on the binding based on the
+   * expected type. Falls back to `get` + synthetic details for unknown types.
    */
-  private getValueType;
-  private handleError;
+  private evaluateBinding;
 }
 //#endregion
 //#region src/hooks/logging-hook.d.ts
@@ -141,4 +166,4 @@ declare class TelemetryHook implements Hook {
   finally(hookContext: Readonly<HookContext>, _evaluationDetails: EvaluationDetails<FlagValue>, _hookHints?: HookHints): void;
 }
 //#endregion
-export { ContextTransformer, FLAGSHIP_DEFAULT_BASE_URL, FlagshipClient, FlagshipError, FlagshipErrorCode, type FlagshipEvaluationResponse, type FlagshipProviderOptions, FlagshipServerProvider, LoggingHook, type TelemetryEvent, TelemetryHook };
+export { ContextTransformer, FLAGSHIP_DEFAULT_BASE_URL, type FlagshipBinding, type FlagshipBindingEvaluationDetails, type FlagshipBindingProviderOptions, FlagshipClient, FlagshipError, FlagshipErrorCode, type FlagshipEvaluationResponse, type FlagshipProviderOptions, FlagshipServerProvider, type FlagshipServerProviderOptions, LoggingHook, type TelemetryEvent, TelemetryHook, isBindingOptions };

package/dist/server.mjs

@@ -1,290 +1 @@
-import { a as FlagshipErrorCode, i as FlagshipError, n as ContextTransformer, r as FLAGSHIP_DEFAULT_BASE_URL, t as FlagshipClient } from "./src-CiVDWmng.mjs";
-import { ErrorCode, OpenFeatureEventEmitter, ProviderEvents, ProviderStatus } from "@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 OpenFeatureEventEmitter();
-		this.currentStatus = ProviderStatus.NOT_READY;
-		this.metadata = { name: "Flagship Server Provider" };
-		this.client = new 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 = ProviderStatus.READY;
-			this.events.emit(ProviderEvents.Ready);
-		} catch (error) {
-			if (error instanceof FlagshipError && error.cause instanceof Response && error.cause.status === 404) {
-				this.currentStatus = ProviderStatus.READY;
-				this.events.emit(ProviderEvents.Ready);
-				return;
-			}
-			this.currentStatus = ProviderStatus.ERROR;
-			this.events.emit(ProviderEvents.Error, { message: error instanceof Error ? error.message : String(error) });
-		}
-	}
-	async onClose() {
-		this.currentStatus = 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: 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 FlagshipError) {
-			let errorCode;
-			switch (error.code) {
-				case FlagshipErrorCode.NETWORK_ERROR:
-					errorCode = error.cause instanceof Response && error.cause.status === 404 ? ErrorCode.FLAG_NOT_FOUND : ErrorCode.GENERAL;
-					break;
-				case FlagshipErrorCode.TIMEOUT_ERROR:
-					errorCode = ErrorCode.GENERAL;
-					break;
-				case FlagshipErrorCode.PARSE_ERROR:
-					errorCode = ErrorCode.PARSE_ERROR;
-					break;
-				case FlagshipErrorCode.INVALID_CONTEXT:
-					errorCode = ErrorCode.INVALID_CONTEXT;
-					break;
-				default: errorCode = 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: 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
-export { ContextTransformer, FLAGSHIP_DEFAULT_BASE_URL, FlagshipClient, FlagshipError, FlagshipErrorCode, FlagshipServerProvider, LoggingHook, TelemetryHook };
+import{a as e,i as t,n,o as r,r as i,t as a}from"./src-DW2QohY9.mjs";import{ErrorCode as o,OpenFeatureEventEmitter as s,ProviderEvents as c,ProviderStatus as l}from"@openfeature/server-sdk";const u=()=>{},d=[`appId`,`endpoint`,`accountId`,`authToken`,`baseUrl`,`fetchOptions`,`timeout`,`retries`,`retryDelay`];var f=class{constructor(e){if(this.runsOn=`server`,this.events=new s,this.currentStatus=l.NOT_READY,this.metadata={name:`Flagship Server Provider`},this.logging=e.logging??!1,r(e)){let t=d.filter(t=>t in e);if(t.length>0)throw Error(`Flagship: when using a binding, the following HTTP-specific options must not be provided: ${t.join(`, `)}. Provide either a binding or HTTP configuration, not both.`);this.binding=e.binding,this.client=void 0,this.resolve=this.resolveViaBinding.bind(this)}else this.client=new a(e),this.binding=void 0,this.resolve=this.resolveViaHttp.bind(this)}logger(e){return this.logging?e:{debug:u,info:u,warn:u,error:u}}async initialize(e){if(this.binding){this.currentStatus=l.READY,this.events.emit(c.Ready);return}try{await this.client.evaluate(`_flagship_health_check`,{}),this.currentStatus=l.READY,this.events.emit(c.Ready)}catch(e){if(e instanceof t&&e.cause instanceof Response&&e.cause.status===404){this.currentStatus=l.READY,this.events.emit(c.Ready);return}this.currentStatus=l.ERROR,this.events.emit(c.Error,{message:e instanceof Error?e.message:String(e)})}}async onClose(){this.currentStatus=l.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,t,n,r,i){let a=this.logger(i);try{a.debug(`[Flagship] Evaluating flag "${e}" (expected: ${r})`);let i=await this.client.evaluate(e,n),s=p(i.value);if(s!==r){let n=`Flag "${e}" type mismatch: expected ${r}, got ${s}`;return a.warn(`[Flagship] ${n}`),{value:t,errorCode:o.TYPE_MISMATCH,errorMessage:n,reason:`ERROR`}}return a.debug(`[Flagship] Flag "${e}" resolved: value=${String(i.value)} reason=${i.reason} variant=${i.variant}`),{value:i.value,variant:i.variant,reason:i.reason,flagMetadata:{}}}catch(n){return this.handleHttpError(e,t,n,a)}}handleHttpError(n,r,i,a){if(i instanceof t){let t;switch(i.code){case e.NETWORK_ERROR:t=i.cause instanceof Response&&i.cause.status===404?o.FLAG_NOT_FOUND:o.GENERAL;break;case e.TIMEOUT_ERROR:t=o.GENERAL;break;case e.PARSE_ERROR:t=o.PARSE_ERROR;break;case e.INVALID_CONTEXT:t=o.INVALID_CONTEXT;break;default:t=o.GENERAL}return a.error(`[Flagship] Flag "${n}" evaluation failed (${t}): ${i.message}`),{value:r,errorCode:t,errorMessage:i.message,reason:`ERROR`}}let s=String(i);return a.error(`[Flagship] Flag "${n}" evaluation failed (GENERAL): ${s}`),{value:r,errorCode:o.GENERAL,errorMessage:s,reason:`ERROR`}}async resolveViaBinding(e,t,n,r,i){let a=this.logger(i);try{a.debug(`[Flagship] Evaluating flag "${e}" via binding (expected: ${r})`);let i=m(n,a),s=await this.evaluateBinding(e,t,r,i);if(s.errorCode){let n=h(s.errorCode),r=s.errorMessage??`Binding error: ${s.errorCode}`;return a.error(`[Flagship] Flag "${e}" evaluation failed (${n}): ${r}`),{value:t,errorCode:n,errorMessage:r,reason:s.reason??`ERROR`}}let c=p(s.value);if(c!==r){let n=`Flag "${e}" type mismatch: expected ${r}, got ${c}`;return a.warn(`[Flagship] ${n}`),{value:t,errorCode:o.TYPE_MISMATCH,errorMessage:n,reason:`ERROR`}}return a.debug(`[Flagship] Flag "${e}" resolved via binding: value=${String(s.value)} reason=${s.reason} variant=${s.variant}`),{value:s.value,variant:s.variant,reason:s.reason,flagMetadata:{}}}catch(n){let r=n instanceof Error?n.message:String(n);return a.error(`[Flagship] Flag "${e}" binding evaluation failed (GENERAL): ${r}`),{value:t,errorCode:o.GENERAL,errorMessage:r,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 p(e){return typeof e==`boolean`?`boolean`:typeof e==`string`?`string`:typeof e==`number`?`number`:`object`}function m(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 h(e){switch(e){case`FLAG_NOT_FOUND`:return o.FLAG_NOT_FOUND;case`PARSE_ERROR`:return o.PARSE_ERROR;case`TYPE_MISMATCH`:return o.TYPE_MISMATCH;case`INVALID_CONTEXT`:return o.INVALID_CONTEXT;default:return o.GENERAL}}var g=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){}},_=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)}};export{n as ContextTransformer,i as FLAGSHIP_DEFAULT_BASE_URL,a as FlagshipClient,t as FlagshipError,e as FlagshipErrorCode,f as FlagshipServerProvider,g as LoggingHook,_ as TelemetryHook,r as isBindingOptions};

package/dist/src-DW2QohY9.mjs

@@ -0,0 +1 @@
+const e=`https://api.cloudflare.com`;function t(e){return`binding`in e&&e.binding!==null&&e.binding!==void 0}let n=function(e){return e.NETWORK_ERROR=`NETWORK_ERROR`,e.TIMEOUT_ERROR=`TIMEOUT_ERROR`,e.PARSE_ERROR=`PARSE_ERROR`,e.INVALID_CONTEXT=`INVALID_CONTEXT`,e}({});var r=class extends Error{constructor(e,t,n){super(e),this.code=t,this.cause=n,this.name=`FlagshipError`,Object.setPrototypeOf(this,new.target.prototype)}},i=class{static toQueryParams(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]=String(i);continue}if(typeof i==`object`){t?t.push(r):console.warn(`[Flagship] Context key "${r}" is a complex object/array and cannot be serialized to a query parameter. This value will be ignored during flag evaluation.`);continue}}return n}static buildUrl(e,t,n,r){let i=new URL(e);i.searchParams.set(`flagKey`,t);let a=this.toQueryParams(n,r);for(let[e,t]of Object.entries(a))i.searchParams.set(e,t);return i.toString()}},a=class{constructor(e){this.options={endpoint:s(e),fetchOptions:o(e),timeout:e.timeout||5e3,retries:Math.min(e.retries===void 0?1:e.retries,10),retryDelay:Math.min(e.retryDelay===void 0?1e3:e.retryDelay,3e4)}}async evaluate(e,t){let a=[],o=i.buildUrl(this.options.endpoint,e,t,a);if(a.length>0)throw new r(`Evaluation context contains complex values that cannot be serialized for flag "${e}". Unsupported keys: ${a.join(`, `)}. Use primitive values (string, number, boolean) or Date objects.`,n.INVALID_CONTEXT);return this.fetchWithRetry(o,this.options.retries)}async fetchWithRetry(e,t){try{return await this.fetchWithTimeout(e,this.options.timeout)}catch(n){if(n instanceof r&&n.cause instanceof Response){let e=n.cause.status;if(e===404||e===400)throw n}if(t>0)return await new Promise(e=>setTimeout(e,this.options.retryDelay)),this.fetchWithRetry(e,t-1);throw n}}async fetchWithTimeout(e,t){let i=new AbortController,a=setTimeout(()=>i.abort(),t);try{let t=await fetch(e,{...this.options.fetchOptions,signal:i.signal});if(clearTimeout(a),!t.ok)throw new r(`HTTP ${t.status}: ${t.statusText}`,n.NETWORK_ERROR,t);let o=await t.json();if(!o||typeof o!=`object`||!(`flagKey`in o)||!(`value`in o))throw new r(`Invalid response format from Flagship API`,n.PARSE_ERROR);return o}catch(e){throw clearTimeout(a),e instanceof Error&&e.name===`AbortError`?new r(`Request timeout after ${t}ms`,n.TIMEOUT_ERROR,e):e instanceof r?e:new r(`Network error: ${e}`,n.NETWORK_ERROR,e)}}};function o(e){let{authToken:t,fetchOptions:n={}}=e;if(!t)return n;let r=new Headers(n.headers);return r.has(`Authorization`)||r.set(`Authorization`,`Bearer ${t}`),{...n,headers:r}}function s(e){let{appId:t,endpoint:n,baseUrl:r,accountId:i}=e;if(t&&n)throw Error(`Flagship: provide either "appId" or "endpoint", not both`);if(!t&&!n)throw Error(`Flagship: either "appId" or "endpoint" is required`);if(n){try{new URL(n)}catch{throw Error(`Flagship: invalid endpoint URL: ${n}`)}return n}if(!i)throw Error(`Flagship: "accountId" is required when using "appId"`);let a=`${(r||`https://api.cloudflare.com`).replace(/\/+$/,``)}/client/v4/accounts/${encodeURIComponent(i)}/flagship/apps/${encodeURIComponent(t)}/evaluate`;try{new URL(a)}catch{throw Error(`Flagship: resolved endpoint is not a valid URL: ${a}`)}return a}export{n as a,r as i,i as n,t as o,e as r,a as t};

package/dist/src-QEIBSid3.cjs

@@ -0,0 +1 @@
+function e(e){return`binding`in e&&e.binding!==null&&e.binding!==void 0}let t=function(e){return e.NETWORK_ERROR=`NETWORK_ERROR`,e.TIMEOUT_ERROR=`TIMEOUT_ERROR`,e.PARSE_ERROR=`PARSE_ERROR`,e.INVALID_CONTEXT=`INVALID_CONTEXT`,e}({});var n=class extends Error{constructor(e,t,n){super(e),this.code=t,this.cause=n,this.name=`FlagshipError`,Object.setPrototypeOf(this,new.target.prototype)}},r=class{static toQueryParams(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]=String(i);continue}if(typeof i==`object`){t?t.push(r):console.warn(`[Flagship] Context key "${r}" is a complex object/array and cannot be serialized to a query parameter. This value will be ignored during flag evaluation.`);continue}}return n}static buildUrl(e,t,n,r){let i=new URL(e);i.searchParams.set(`flagKey`,t);let a=this.toQueryParams(n,r);for(let[e,t]of Object.entries(a))i.searchParams.set(e,t);return i.toString()}},i=class{constructor(e){this.options={endpoint:o(e),fetchOptions:a(e),timeout:e.timeout||5e3,retries:Math.min(e.retries===void 0?1:e.retries,10),retryDelay:Math.min(e.retryDelay===void 0?1e3:e.retryDelay,3e4)}}async evaluate(e,i){let a=[],o=r.buildUrl(this.options.endpoint,e,i,a);if(a.length>0)throw new n(`Evaluation context contains complex values that cannot be serialized for flag "${e}". Unsupported keys: ${a.join(`, `)}. Use primitive values (string, number, boolean) or Date objects.`,t.INVALID_CONTEXT);return this.fetchWithRetry(o,this.options.retries)}async fetchWithRetry(e,t){try{return await this.fetchWithTimeout(e,this.options.timeout)}catch(r){if(r instanceof n&&r.cause instanceof Response){let e=r.cause.status;if(e===404||e===400)throw r}if(t>0)return await new Promise(e=>setTimeout(e,this.options.retryDelay)),this.fetchWithRetry(e,t-1);throw r}}async fetchWithTimeout(e,r){let i=new AbortController,a=setTimeout(()=>i.abort(),r);try{let r=await fetch(e,{...this.options.fetchOptions,signal:i.signal});if(clearTimeout(a),!r.ok)throw new n(`HTTP ${r.status}: ${r.statusText}`,t.NETWORK_ERROR,r);let o=await r.json();if(!o||typeof o!=`object`||!(`flagKey`in o)||!(`value`in o))throw new n(`Invalid response format from Flagship API`,t.PARSE_ERROR);return o}catch(e){throw clearTimeout(a),e instanceof Error&&e.name===`AbortError`?new n(`Request timeout after ${r}ms`,t.TIMEOUT_ERROR,e):e instanceof n?e:new n(`Network error: ${e}`,t.NETWORK_ERROR,e)}}};function a(e){let{authToken:t,fetchOptions:n={}}=e;if(!t)return n;let r=new Headers(n.headers);return r.has(`Authorization`)||r.set(`Authorization`,`Bearer ${t}`),{...n,headers:r}}function o(e){let{appId:t,endpoint:n,baseUrl:r,accountId:i}=e;if(t&&n)throw Error(`Flagship: provide either "appId" or "endpoint", not both`);if(!t&&!n)throw Error(`Flagship: either "appId" or "endpoint" is required`);if(n){try{new URL(n)}catch{throw Error(`Flagship: invalid endpoint URL: ${n}`)}return n}if(!i)throw Error(`Flagship: "accountId" is required when using "appId"`);let a=`${(r||`https://api.cloudflare.com`).replace(/\/+$/,``)}/client/v4/accounts/${encodeURIComponent(i)}/flagship/apps/${encodeURIComponent(t)}/evaluate`;try{new URL(a)}catch{throw Error(`Flagship: resolved endpoint is not a valid URL: ${a}`)}return a}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return`https://api.cloudflare.com`}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return i}});