@quonfig/openfeature-web 0.0.1

package/README.md

@@ -0,0 +1,119 @@
+# @quonfig/openfeature-web
+
+OpenFeature provider for [Quonfig](https://quonfig.com) — Web/Browser.
+
+Works with both vanilla JS (`@openfeature/web-sdk`) and React (`@openfeature/react-sdk`).
+The React SDK re-exports the web SDK and adds hooks (`useFlag`, `useBooleanFlagValue`, etc.) —
+any web provider works with React hooks automatically.
+
+## Installation
+
+```bash
+# Vanilla web
+npm install @quonfig/openfeature-web @quonfig/javascript @openfeature/web-sdk
+
+# React
+npm install @quonfig/openfeature-web @quonfig/javascript @openfeature/react-sdk
+```
+
+## Quick start
+
+### Vanilla JS
+
+```typescript
+import { OpenFeature } from "@openfeature/web-sdk";
+import { QuonfigWebProvider } from "@quonfig/openfeature-web";
+
+const provider = new QuonfigWebProvider({
+  sdkKey: "qf_sk_...",
+});
+
+await OpenFeature.setContext({
+  targetingKey: "user-123",
+  "user.email": "alice@example.com",
+  "org.tier": "enterprise",
+});
+
+await OpenFeature.setProviderAndWait(provider);
+
+const client = OpenFeature.getClient();
+const isEnabled = client.getBooleanValue("my-flag", false);
+```
+
+### React
+
+```typescript
+import { OpenFeatureProvider, useBooleanFlagValue } from "@openfeature/react-sdk";
+import { OpenFeature } from "@openfeature/web-sdk";
+import { QuonfigWebProvider } from "@quonfig/openfeature-web";
+
+const provider = new QuonfigWebProvider({ sdkKey: "qf_sk_..." });
+await OpenFeature.setProviderAndWait(provider);
+
+function MyComponent() {
+  const enabled = useBooleanFlagValue("my-flag", false);
+  return <div>{enabled ? "Feature on" : "Feature off"}</div>;
+}
+
+function App() {
+  return (
+    <OpenFeatureProvider>
+      <MyComponent />
+    </OpenFeatureProvider>
+  );
+}
+```
+
+## Configuration
+
+```typescript
+const provider = new QuonfigWebProvider({
+  sdkKey: "qf_sk_...",               // required
+  targetingKeyMapping: "user.id",    // default; maps OpenFeature targetingKey
+  apiUrl: "https://custom.api.com",  // optional — override API base URL
+  timeout: 5000,                     // optional — request timeout in ms
+});
+```
+
+## Context mapping
+
+OpenFeature uses a flat context; Quonfig uses a namespace-nested context.
+The provider maps between them using dot-notation:
+
+| OpenFeature key         | Quonfig context             |
+|-------------------------|-----------------------------|
+| `targetingKey: "u-123"` | `{ user: { id: "u-123" } }` |
+| `"user.email": "a@b.c"` | `{ user: { email: "a@b.c" } }` |
+| `"org.tier": "pro"`     | `{ org: { tier: "pro" } }`  |
+| `"country": "US"`       | `{ "": { country: "US" } }` |
+
+Keys without a dot go into the default (empty-string) namespace.
+
+To use a different property for `targetingKey`:
+
+```typescript
+new QuonfigWebProvider({ sdkKey: "...", targetingKeyMapping: "account.id" });
+```
+
+## What you lose vs. the native SDK
+
+The OpenFeature interface covers boolean, string, number, and object types.
+Some Quonfig-native features require `provider.getClient()` (the escape hatch):
+
+1. **Log levels** (`shouldLog`, `logger`) — native SDK only
+2. **`string_list` configs** — access via `getObjectValue` and cast to `string[]`
+3. **`duration` configs** — `getStringValue` returns an ISO 8601 string; parse client-side
+4. **`bytes` configs** — not accessible via OpenFeature
+5. **`keys()` and `raw()`** — native SDK only
+6. **Context keys** must use dot-notation (`"user.email"`), not nested objects
+7. **`targetingKey`** maps to `user.id` by default — configure `targetingKeyMapping` if different
+
+```typescript
+// Escape hatch for Quonfig-native features
+const native = provider.getClient();
+native.shouldLog({ loggerName: "auth", desiredLevel: "DEBUG", defaultLevel: "WARN" });
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,60 @@
+import { Provider, OpenFeatureEventEmitter, EvaluationContext, ResolutionDetails, JsonValue, ErrorCode } from '@openfeature/web-sdk';
+import { Quonfig, Contexts } from '@quonfig/javascript';
+
+interface QuonfigWebProviderOptions {
+    sdkKey: string;
+    /** Which Quonfig context property the OpenFeature targetingKey maps to. Default: "user.id" */
+    targetingKeyMapping?: string;
+    /** Override the Quonfig API base URL. */
+    apiUrl?: string;
+    /** Request timeout in ms. */
+    timeout?: number;
+}
+declare class QuonfigWebProvider implements Provider {
+    readonly metadata: {
+        readonly name: "quonfig-web";
+    };
+    readonly runsOn: "client";
+    hooks: never[];
+    readonly events: OpenFeatureEventEmitter;
+    private client;
+    private readonly targetingKeyMapping;
+    private readonly sdkKey;
+    private readonly apiUrl;
+    private readonly timeout;
+    constructor(options: QuonfigWebProviderOptions);
+    initialize(context?: EvaluationContext): Promise<void>;
+    onContextChanged(_oldCtx: EvaluationContext, newCtx: EvaluationContext): Promise<void>;
+    shutdown(): Promise<void>;
+    resolveBooleanEvaluation(flagKey: string, defaultValue: boolean, _context?: EvaluationContext): ResolutionDetails<boolean>;
+    resolveStringEvaluation(flagKey: string, defaultValue: string, _context?: EvaluationContext): ResolutionDetails<string>;
+    resolveNumberEvaluation(flagKey: string, defaultValue: number, _context?: EvaluationContext): ResolutionDetails<number>;
+    resolveObjectEvaluation<T extends JsonValue = JsonValue>(flagKey: string, defaultValue: T, _context?: EvaluationContext): ResolutionDetails<T>;
+    /** Escape hatch: access the underlying Quonfig client directly. */
+    getClient(): Quonfig;
+    private _resolve;
+    /**
+     * Coerce a raw ConfigValue to the expected OF type.
+     * Returns null if the type does not match (signals TYPE_MISMATCH).
+     */
+    private _coerce;
+    /** Convert a Quonfig Duration to an ISO 8601 duration string (e.g. "PT1H30M"). */
+    private _durationToISO;
+}
+
+/**
+ * Map an OpenFeature EvaluationContext to Quonfig's nested Contexts format.
+ *
+ * Rules:
+ * - `targetingKey` maps to the property specified by `targetingKeyMapping` (default: "user.id")
+ * - Keys with a dot are split on the FIRST dot: namespace = left side, key = right side
+ * - Keys without a dot go into the default ("") namespace
+ */
+declare function mapContext(ofContext: EvaluationContext, targetingKeyMapping?: string): Contexts;
+
+/**
+ * Map a native SDK error (or unknown throw) to an OpenFeature ErrorCode.
+ */
+declare function toErrorCode(err: unknown): ErrorCode;
+
+export { QuonfigWebProvider, type QuonfigWebProviderOptions, mapContext, toErrorCode };

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+import { Provider, OpenFeatureEventEmitter, EvaluationContext, ResolutionDetails, JsonValue, ErrorCode } from '@openfeature/web-sdk';
+import { Quonfig, Contexts } from '@quonfig/javascript';
+
+interface QuonfigWebProviderOptions {
+    sdkKey: string;
+    /** Which Quonfig context property the OpenFeature targetingKey maps to. Default: "user.id" */
+    targetingKeyMapping?: string;
+    /** Override the Quonfig API base URL. */
+    apiUrl?: string;
+    /** Request timeout in ms. */
+    timeout?: number;
+}
+declare class QuonfigWebProvider implements Provider {
+    readonly metadata: {
+        readonly name: "quonfig-web";
+    };
+    readonly runsOn: "client";
+    hooks: never[];
+    readonly events: OpenFeatureEventEmitter;
+    private client;
+    private readonly targetingKeyMapping;
+    private readonly sdkKey;
+    private readonly apiUrl;
+    private readonly timeout;
+    constructor(options: QuonfigWebProviderOptions);
+    initialize(context?: EvaluationContext): Promise<void>;
+    onContextChanged(_oldCtx: EvaluationContext, newCtx: EvaluationContext): Promise<void>;
+    shutdown(): Promise<void>;
+    resolveBooleanEvaluation(flagKey: string, defaultValue: boolean, _context?: EvaluationContext): ResolutionDetails<boolean>;
+    resolveStringEvaluation(flagKey: string, defaultValue: string, _context?: EvaluationContext): ResolutionDetails<string>;
+    resolveNumberEvaluation(flagKey: string, defaultValue: number, _context?: EvaluationContext): ResolutionDetails<number>;
+    resolveObjectEvaluation<T extends JsonValue = JsonValue>(flagKey: string, defaultValue: T, _context?: EvaluationContext): ResolutionDetails<T>;
+    /** Escape hatch: access the underlying Quonfig client directly. */
+    getClient(): Quonfig;
+    private _resolve;
+    /**
+     * Coerce a raw ConfigValue to the expected OF type.
+     * Returns null if the type does not match (signals TYPE_MISMATCH).
+     */
+    private _coerce;
+    /** Convert a Quonfig Duration to an ISO 8601 duration string (e.g. "PT1H30M"). */
+    private _durationToISO;
+}
+
+/**
+ * Map an OpenFeature EvaluationContext to Quonfig's nested Contexts format.
+ *
+ * Rules:
+ * - `targetingKey` maps to the property specified by `targetingKeyMapping` (default: "user.id")
+ * - Keys with a dot are split on the FIRST dot: namespace = left side, key = right side
+ * - Keys without a dot go into the default ("") namespace
+ */
+declare function mapContext(ofContext: EvaluationContext, targetingKeyMapping?: string): Contexts;
+
+/**
+ * Map a native SDK error (or unknown throw) to an OpenFeature ErrorCode.
+ */
+declare function toErrorCode(err: unknown): ErrorCode;
+
+export { QuonfigWebProvider, type QuonfigWebProviderOptions, mapContext, toErrorCode };

package/dist/index.js

@@ -0,0 +1,199 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  QuonfigWebProvider: () => QuonfigWebProvider,
+  mapContext: () => mapContext,
+  toErrorCode: () => toErrorCode
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/provider.ts
+var import_web_sdk2 = require("@openfeature/web-sdk");
+var import_javascript = require("@quonfig/javascript");
+
+// src/context.ts
+function mapContext(ofContext, targetingKeyMapping = "user.id") {
+  const result = {};
+  for (const [key, value] of Object.entries(ofContext)) {
+    if (value === void 0) continue;
+    if (key === "targetingKey") {
+      const dotIdx2 = targetingKeyMapping.indexOf(".");
+      const ns = dotIdx2 === -1 ? "" : targetingKeyMapping.slice(0, dotIdx2);
+      const prop = dotIdx2 === -1 ? targetingKeyMapping : targetingKeyMapping.slice(dotIdx2 + 1);
+      result[ns] ?? (result[ns] = {});
+      result[ns][prop] = value;
+      continue;
+    }
+    const dotIdx = key.indexOf(".");
+    if (dotIdx === -1) {
+      result[""] ?? (result[""] = {});
+      result[""][key] = value;
+    } else {
+      const ns = key.slice(0, dotIdx);
+      const prop = key.slice(dotIdx + 1);
+      result[ns] ?? (result[ns] = {});
+      result[ns][prop] = value;
+    }
+  }
+  return result;
+}
+
+// src/errors.ts
+var import_web_sdk = require("@openfeature/web-sdk");
+function toErrorCode(err) {
+  const msg = err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();
+  if (msg.includes("flag not found") || msg.includes("not found")) {
+    return import_web_sdk.ErrorCode.FLAG_NOT_FOUND;
+  }
+  if (msg.includes("type mismatch") || msg.includes("type_mismatch")) {
+    return import_web_sdk.ErrorCode.TYPE_MISMATCH;
+  }
+  if (msg.includes("not initialized") || msg.includes("provider_not_ready") || msg.includes("call init()") || msg.includes("not ready")) {
+    return import_web_sdk.ErrorCode.PROVIDER_NOT_READY;
+  }
+  return import_web_sdk.ErrorCode.GENERAL;
+}
+
+// src/provider.ts
+var QuonfigWebProvider = class {
+  constructor(options) {
+    this.metadata = { name: "quonfig-web" };
+    this.runsOn = "client";
+    this.hooks = [];
+    this.events = new import_web_sdk2.OpenFeatureEventEmitter();
+    this.sdkKey = options.sdkKey;
+    this.targetingKeyMapping = options.targetingKeyMapping ?? "user.id";
+    this.apiUrl = options.apiUrl;
+    this.timeout = options.timeout;
+    this.client = new import_javascript.Quonfig();
+  }
+  async initialize(context) {
+    const nativeCtx = context ? mapContext(context, this.targetingKeyMapping) : { "": {} };
+    await this.client.init({
+      sdkKey: this.sdkKey,
+      context: nativeCtx,
+      ...this.apiUrl !== void 0 && { apiUrl: this.apiUrl },
+      ...this.timeout !== void 0 && { timeout: this.timeout }
+    });
+  }
+  async onContextChanged(_oldCtx, newCtx) {
+    const nativeCtx = mapContext(newCtx, this.targetingKeyMapping);
+    await this.client.updateContext(nativeCtx);
+  }
+  async shutdown() {
+    this.client.close();
+  }
+  resolveBooleanEvaluation(flagKey, defaultValue, _context) {
+    return this._resolve(flagKey, defaultValue, "boolean");
+  }
+  resolveStringEvaluation(flagKey, defaultValue, _context) {
+    return this._resolve(flagKey, defaultValue, "string");
+  }
+  resolveNumberEvaluation(flagKey, defaultValue, _context) {
+    return this._resolve(flagKey, defaultValue, "number");
+  }
+  resolveObjectEvaluation(flagKey, defaultValue, _context) {
+    return this._resolve(flagKey, defaultValue, "object");
+  }
+  /** Escape hatch: access the underlying Quonfig client directly. */
+  getClient() {
+    return this.client;
+  }
+  // ---------------------------------------------------------------------------
+  // Private helpers
+  // ---------------------------------------------------------------------------
+  _resolve(flagKey, defaultValue, expectedType) {
+    try {
+      const raw = this.client.get(flagKey);
+      if (raw === void 0 || raw === null) {
+        return {
+          value: defaultValue,
+          reason: import_web_sdk2.StandardResolutionReasons.DEFAULT,
+          errorCode: import_web_sdk2.ErrorCode.FLAG_NOT_FOUND
+        };
+      }
+      const coerced = this._coerce(raw, expectedType, defaultValue);
+      if (coerced === null) {
+        return {
+          value: defaultValue,
+          reason: import_web_sdk2.StandardResolutionReasons.ERROR,
+          errorCode: import_web_sdk2.ErrorCode.TYPE_MISMATCH
+        };
+      }
+      return {
+        value: coerced,
+        reason: import_web_sdk2.StandardResolutionReasons.STATIC
+      };
+    } catch (err) {
+      return {
+        value: defaultValue,
+        reason: import_web_sdk2.StandardResolutionReasons.ERROR,
+        errorCode: toErrorCode(err)
+      };
+    }
+  }
+  /**
+   * Coerce a raw ConfigValue to the expected OF type.
+   * Returns null if the type does not match (signals TYPE_MISMATCH).
+   */
+  _coerce(raw, expectedType, defaultValue) {
+    switch (expectedType) {
+      case "boolean":
+        if (typeof raw === "boolean") return raw;
+        return null;
+      case "string":
+        if (typeof raw === "string") return raw;
+        if (raw !== null && typeof raw === "object" && "seconds" in raw && "ms" in raw) {
+          return this._durationToISO(raw);
+        }
+        return null;
+      case "number":
+        if (typeof raw === "number") return raw;
+        return null;
+      case "object":
+        if (Array.isArray(raw)) return raw;
+        if (raw !== null && typeof raw === "object") return raw;
+        return null;
+      default:
+        return null;
+    }
+  }
+  /** Convert a Quonfig Duration to an ISO 8601 duration string (e.g. "PT1H30M"). */
+  _durationToISO(duration) {
+    const totalSeconds = duration.seconds;
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor(totalSeconds % 3600 / 60);
+    const secs = totalSeconds % 60;
+    let iso = "PT";
+    if (hours > 0) iso += `${hours}H`;
+    if (minutes > 0) iso += `${minutes}M`;
+    if (secs > 0 || iso === "PT") iso += `${secs}S`;
+    return iso;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  QuonfigWebProvider,
+  mapContext,
+  toErrorCode
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/provider.ts","../src/context.ts","../src/errors.ts"],"sourcesContent":["export { QuonfigWebProvider } from \"./provider\";\nexport type { QuonfigWebProviderOptions } from \"./provider\";\nexport { mapContext } from \"./context\";\nexport { toErrorCode } from \"./errors\";\n","import {\n  ErrorCode,\n  OpenFeatureEventEmitter,\n  Provider,\n  ResolutionDetails,\n  StandardResolutionReasons,\n} from \"@openfeature/web-sdk\";\nimport type { EvaluationContext, JsonValue } from \"@openfeature/web-sdk\";\nimport { Quonfig } from \"@quonfig/javascript\";\n\nimport { mapContext } from \"./context\";\nimport { toErrorCode } from \"./errors\";\n\nexport interface QuonfigWebProviderOptions {\n  sdkKey: string;\n  /** Which Quonfig context property the OpenFeature targetingKey maps to. Default: \"user.id\" */\n  targetingKeyMapping?: string;\n  /** Override the Quonfig API base URL. */\n  apiUrl?: string;\n  /** Request timeout in ms. */\n  timeout?: number;\n}\n\nexport class QuonfigWebProvider implements Provider {\n  readonly metadata = { name: \"quonfig-web\" } as const;\n  readonly runsOn = \"client\" as const;\n  hooks = [];\n  readonly events = new OpenFeatureEventEmitter();\n\n  private client: Quonfig;\n  private readonly targetingKeyMapping: string;\n  private readonly sdkKey: string;\n  private readonly apiUrl: string | undefined;\n  private readonly timeout: number | undefined;\n\n  constructor(options: QuonfigWebProviderOptions) {\n    this.sdkKey = options.sdkKey;\n    this.targetingKeyMapping = options.targetingKeyMapping ?? \"user.id\";\n    this.apiUrl = options.apiUrl;\n    this.timeout = options.timeout;\n    this.client = new Quonfig();\n  }\n\n  async initialize(context?: EvaluationContext): Promise<void> {\n    const nativeCtx = context\n      ? mapContext(context, this.targetingKeyMapping)\n      : { \"\": {} };\n\n    await this.client.init({\n      sdkKey: this.sdkKey,\n      context: nativeCtx,\n      ...(this.apiUrl !== undefined && { apiUrl: this.apiUrl }),\n      ...(this.timeout !== undefined && { timeout: this.timeout }),\n    });\n  }\n\n  async onContextChanged(\n    _oldCtx: EvaluationContext,\n    newCtx: EvaluationContext\n  ): Promise<void> {\n    const nativeCtx = mapContext(newCtx, this.targetingKeyMapping);\n    await this.client.updateContext(nativeCtx);\n  }\n\n  async shutdown(): Promise<void> {\n    this.client.close();\n  }\n\n  resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    _context?: EvaluationContext\n  ): ResolutionDetails<boolean> {\n    return this._resolve(flagKey, defaultValue, \"boolean\");\n  }\n\n  resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    _context?: EvaluationContext\n  ): ResolutionDetails<string> {\n    return this._resolve(flagKey, defaultValue, \"string\");\n  }\n\n  resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    _context?: EvaluationContext\n  ): ResolutionDetails<number> {\n    return this._resolve(flagKey, defaultValue, \"number\");\n  }\n\n  resolveObjectEvaluation<T extends JsonValue = JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    _context?: EvaluationContext\n  ): ResolutionDetails<T> {\n    return this._resolve(flagKey, defaultValue, \"object\");\n  }\n\n  /** Escape hatch: access the underlying Quonfig client directly. */\n  getClient(): Quonfig {\n    return this.client;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private helpers\n  // ---------------------------------------------------------------------------\n\n  private _resolve<T>(\n    flagKey: string,\n    defaultValue: T,\n    expectedType: \"boolean\" | \"string\" | \"number\" | \"object\"\n  ): ResolutionDetails<T> {\n    try {\n      const raw = this.client.get(flagKey);\n\n      if (raw === undefined || raw === null) {\n        // Flag not found — return OF default\n        return {\n          value: defaultValue,\n          reason: StandardResolutionReasons.DEFAULT,\n          errorCode: ErrorCode.FLAG_NOT_FOUND,\n        };\n      }\n\n      // Type coercion / validation\n      const coerced = this._coerce<T>(raw, expectedType, defaultValue);\n      if (coerced === null) {\n        return {\n          value: defaultValue,\n          reason: StandardResolutionReasons.ERROR,\n          errorCode: ErrorCode.TYPE_MISMATCH,\n        };\n      }\n\n      return {\n        value: coerced,\n        reason: StandardResolutionReasons.STATIC,\n      };\n    } catch (err) {\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toErrorCode(err),\n      };\n    }\n  }\n\n  /**\n   * Coerce a raw ConfigValue to the expected OF type.\n   * Returns null if the type does not match (signals TYPE_MISMATCH).\n   */\n  private _coerce<T>(\n    raw: unknown,\n    expectedType: \"boolean\" | \"string\" | \"number\" | \"object\",\n    defaultValue: T\n  ): T | null {\n    switch (expectedType) {\n      case \"boolean\":\n        if (typeof raw === \"boolean\") return raw as unknown as T;\n        return null;\n\n      case \"string\":\n        if (typeof raw === \"string\") return raw as unknown as T;\n        // Duration objects: return ISO 8601 string representation\n        if (\n          raw !== null &&\n          typeof raw === \"object\" &&\n          \"seconds\" in raw &&\n          \"ms\" in raw\n        ) {\n          return this._durationToISO(raw as { seconds: number; ms: number }) as unknown as T;\n        }\n        return null;\n\n      case \"number\":\n        if (typeof raw === \"number\") return raw as unknown as T;\n        return null;\n\n      case \"object\":\n        // Arrays (string_list) and plain objects both satisfy \"object\"\n        if (Array.isArray(raw)) return raw as unknown as T;\n        if (raw !== null && typeof raw === \"object\") return raw as unknown as T;\n        return null;\n\n      default:\n        return null;\n    }\n  }\n\n  /** Convert a Quonfig Duration to an ISO 8601 duration string (e.g. \"PT1H30M\"). */\n  private _durationToISO(duration: { seconds: number; ms: number }): string {\n    const totalSeconds = duration.seconds;\n    const hours = Math.floor(totalSeconds / 3600);\n    const minutes = Math.floor((totalSeconds % 3600) / 60);\n    const secs = totalSeconds % 60;\n\n    let iso = \"PT\";\n    if (hours > 0) iso += `${hours}H`;\n    if (minutes > 0) iso += `${minutes}M`;\n    if (secs > 0 || iso === \"PT\") iso += `${secs}S`;\n    return iso;\n  }\n}\n","import type { EvaluationContext } from \"@openfeature/web-sdk\";\nimport type { Contexts } from \"@quonfig/javascript\";\n\n/**\n * Map an OpenFeature EvaluationContext to Quonfig's nested Contexts format.\n *\n * Rules:\n * - `targetingKey` maps to the property specified by `targetingKeyMapping` (default: \"user.id\")\n * - Keys with a dot are split on the FIRST dot: namespace = left side, key = right side\n * - Keys without a dot go into the default (\"\") namespace\n */\nexport function mapContext(\n  ofContext: EvaluationContext,\n  targetingKeyMapping = \"user.id\"\n): Contexts {\n  const result: Record<string, Record<string, unknown>> = {};\n\n  for (const [key, value] of Object.entries(ofContext)) {\n    if (value === undefined) continue;\n\n    if (key === \"targetingKey\") {\n      const dotIdx = targetingKeyMapping.indexOf(\".\");\n      const ns = dotIdx === -1 ? \"\" : targetingKeyMapping.slice(0, dotIdx);\n      const prop =\n        dotIdx === -1 ? targetingKeyMapping : targetingKeyMapping.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = value;\n      continue;\n    }\n\n    const dotIdx = key.indexOf(\".\");\n    if (dotIdx === -1) {\n      result[\"\"] ??= {};\n      result[\"\"][key] = value;\n    } else {\n      const ns = key.slice(0, dotIdx);\n      const prop = key.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = value;\n    }\n  }\n\n  return result as Contexts;\n}\n","import { ErrorCode } from \"@openfeature/web-sdk\";\n\n/**\n * Map a native SDK error (or unknown throw) to an OpenFeature ErrorCode.\n */\nexport function toErrorCode(err: unknown): ErrorCode {\n  const msg =\n    err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();\n\n  if (msg.includes(\"flag not found\") || msg.includes(\"not found\")) {\n    return ErrorCode.FLAG_NOT_FOUND;\n  }\n  if (msg.includes(\"type mismatch\") || msg.includes(\"type_mismatch\")) {\n    return ErrorCode.TYPE_MISMATCH;\n  }\n  if (\n    msg.includes(\"not initialized\") ||\n    msg.includes(\"provider_not_ready\") ||\n    msg.includes(\"call init()\") ||\n    msg.includes(\"not ready\")\n  ) {\n    return ErrorCode.PROVIDER_NOT_READY;\n  }\n  return ErrorCode.GENERAL;\n}\n"],"mappings":"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","names":["import_web_sdk","dotIdx"]}

package/dist/index.mjs

@@ -0,0 +1,174 @@
+// src/provider.ts
+import {
+  ErrorCode as ErrorCode2,
+  OpenFeatureEventEmitter,
+  StandardResolutionReasons
+} from "@openfeature/web-sdk";
+import { Quonfig } from "@quonfig/javascript";
+
+// src/context.ts
+function mapContext(ofContext, targetingKeyMapping = "user.id") {
+  const result = {};
+  for (const [key, value] of Object.entries(ofContext)) {
+    if (value === void 0) continue;
+    if (key === "targetingKey") {
+      const dotIdx2 = targetingKeyMapping.indexOf(".");
+      const ns = dotIdx2 === -1 ? "" : targetingKeyMapping.slice(0, dotIdx2);
+      const prop = dotIdx2 === -1 ? targetingKeyMapping : targetingKeyMapping.slice(dotIdx2 + 1);
+      result[ns] ?? (result[ns] = {});
+      result[ns][prop] = value;
+      continue;
+    }
+    const dotIdx = key.indexOf(".");
+    if (dotIdx === -1) {
+      result[""] ?? (result[""] = {});
+      result[""][key] = value;
+    } else {
+      const ns = key.slice(0, dotIdx);
+      const prop = key.slice(dotIdx + 1);
+      result[ns] ?? (result[ns] = {});
+      result[ns][prop] = value;
+    }
+  }
+  return result;
+}
+
+// src/errors.ts
+import { ErrorCode } from "@openfeature/web-sdk";
+function toErrorCode(err) {
+  const msg = err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();
+  if (msg.includes("flag not found") || msg.includes("not found")) {
+    return ErrorCode.FLAG_NOT_FOUND;
+  }
+  if (msg.includes("type mismatch") || msg.includes("type_mismatch")) {
+    return ErrorCode.TYPE_MISMATCH;
+  }
+  if (msg.includes("not initialized") || msg.includes("provider_not_ready") || msg.includes("call init()") || msg.includes("not ready")) {
+    return ErrorCode.PROVIDER_NOT_READY;
+  }
+  return ErrorCode.GENERAL;
+}
+
+// src/provider.ts
+var QuonfigWebProvider = class {
+  constructor(options) {
+    this.metadata = { name: "quonfig-web" };
+    this.runsOn = "client";
+    this.hooks = [];
+    this.events = new OpenFeatureEventEmitter();
+    this.sdkKey = options.sdkKey;
+    this.targetingKeyMapping = options.targetingKeyMapping ?? "user.id";
+    this.apiUrl = options.apiUrl;
+    this.timeout = options.timeout;
+    this.client = new Quonfig();
+  }
+  async initialize(context) {
+    const nativeCtx = context ? mapContext(context, this.targetingKeyMapping) : { "": {} };
+    await this.client.init({
+      sdkKey: this.sdkKey,
+      context: nativeCtx,
+      ...this.apiUrl !== void 0 && { apiUrl: this.apiUrl },
+      ...this.timeout !== void 0 && { timeout: this.timeout }
+    });
+  }
+  async onContextChanged(_oldCtx, newCtx) {
+    const nativeCtx = mapContext(newCtx, this.targetingKeyMapping);
+    await this.client.updateContext(nativeCtx);
+  }
+  async shutdown() {
+    this.client.close();
+  }
+  resolveBooleanEvaluation(flagKey, defaultValue, _context) {
+    return this._resolve(flagKey, defaultValue, "boolean");
+  }
+  resolveStringEvaluation(flagKey, defaultValue, _context) {
+    return this._resolve(flagKey, defaultValue, "string");
+  }
+  resolveNumberEvaluation(flagKey, defaultValue, _context) {
+    return this._resolve(flagKey, defaultValue, "number");
+  }
+  resolveObjectEvaluation(flagKey, defaultValue, _context) {
+    return this._resolve(flagKey, defaultValue, "object");
+  }
+  /** Escape hatch: access the underlying Quonfig client directly. */
+  getClient() {
+    return this.client;
+  }
+  // ---------------------------------------------------------------------------
+  // Private helpers
+  // ---------------------------------------------------------------------------
+  _resolve(flagKey, defaultValue, expectedType) {
+    try {
+      const raw = this.client.get(flagKey);
+      if (raw === void 0 || raw === null) {
+        return {
+          value: defaultValue,
+          reason: StandardResolutionReasons.DEFAULT,
+          errorCode: ErrorCode2.FLAG_NOT_FOUND
+        };
+      }
+      const coerced = this._coerce(raw, expectedType, defaultValue);
+      if (coerced === null) {
+        return {
+          value: defaultValue,
+          reason: StandardResolutionReasons.ERROR,
+          errorCode: ErrorCode2.TYPE_MISMATCH
+        };
+      }
+      return {
+        value: coerced,
+        reason: StandardResolutionReasons.STATIC
+      };
+    } catch (err) {
+      return {
+        value: defaultValue,
+        reason: StandardResolutionReasons.ERROR,
+        errorCode: toErrorCode(err)
+      };
+    }
+  }
+  /**
+   * Coerce a raw ConfigValue to the expected OF type.
+   * Returns null if the type does not match (signals TYPE_MISMATCH).
+   */
+  _coerce(raw, expectedType, defaultValue) {
+    switch (expectedType) {
+      case "boolean":
+        if (typeof raw === "boolean") return raw;
+        return null;
+      case "string":
+        if (typeof raw === "string") return raw;
+        if (raw !== null && typeof raw === "object" && "seconds" in raw && "ms" in raw) {
+          return this._durationToISO(raw);
+        }
+        return null;
+      case "number":
+        if (typeof raw === "number") return raw;
+        return null;
+      case "object":
+        if (Array.isArray(raw)) return raw;
+        if (raw !== null && typeof raw === "object") return raw;
+        return null;
+      default:
+        return null;
+    }
+  }
+  /** Convert a Quonfig Duration to an ISO 8601 duration string (e.g. "PT1H30M"). */
+  _durationToISO(duration) {
+    const totalSeconds = duration.seconds;
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor(totalSeconds % 3600 / 60);
+    const secs = totalSeconds % 60;
+    let iso = "PT";
+    if (hours > 0) iso += `${hours}H`;
+    if (minutes > 0) iso += `${minutes}M`;
+    if (secs > 0 || iso === "PT") iso += `${secs}S`;
+    return iso;
+  }
+};
+export {
+  QuonfigWebProvider,
+  mapContext,
+  toErrorCode
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider.ts","../src/context.ts","../src/errors.ts"],"sourcesContent":["import {\n  ErrorCode,\n  OpenFeatureEventEmitter,\n  Provider,\n  ResolutionDetails,\n  StandardResolutionReasons,\n} from \"@openfeature/web-sdk\";\nimport type { EvaluationContext, JsonValue } from \"@openfeature/web-sdk\";\nimport { Quonfig } from \"@quonfig/javascript\";\n\nimport { mapContext } from \"./context\";\nimport { toErrorCode } from \"./errors\";\n\nexport interface QuonfigWebProviderOptions {\n  sdkKey: string;\n  /** Which Quonfig context property the OpenFeature targetingKey maps to. Default: \"user.id\" */\n  targetingKeyMapping?: string;\n  /** Override the Quonfig API base URL. */\n  apiUrl?: string;\n  /** Request timeout in ms. */\n  timeout?: number;\n}\n\nexport class QuonfigWebProvider implements Provider {\n  readonly metadata = { name: \"quonfig-web\" } as const;\n  readonly runsOn = \"client\" as const;\n  hooks = [];\n  readonly events = new OpenFeatureEventEmitter();\n\n  private client: Quonfig;\n  private readonly targetingKeyMapping: string;\n  private readonly sdkKey: string;\n  private readonly apiUrl: string | undefined;\n  private readonly timeout: number | undefined;\n\n  constructor(options: QuonfigWebProviderOptions) {\n    this.sdkKey = options.sdkKey;\n    this.targetingKeyMapping = options.targetingKeyMapping ?? \"user.id\";\n    this.apiUrl = options.apiUrl;\n    this.timeout = options.timeout;\n    this.client = new Quonfig();\n  }\n\n  async initialize(context?: EvaluationContext): Promise<void> {\n    const nativeCtx = context\n      ? mapContext(context, this.targetingKeyMapping)\n      : { \"\": {} };\n\n    await this.client.init({\n      sdkKey: this.sdkKey,\n      context: nativeCtx,\n      ...(this.apiUrl !== undefined && { apiUrl: this.apiUrl }),\n      ...(this.timeout !== undefined && { timeout: this.timeout }),\n    });\n  }\n\n  async onContextChanged(\n    _oldCtx: EvaluationContext,\n    newCtx: EvaluationContext\n  ): Promise<void> {\n    const nativeCtx = mapContext(newCtx, this.targetingKeyMapping);\n    await this.client.updateContext(nativeCtx);\n  }\n\n  async shutdown(): Promise<void> {\n    this.client.close();\n  }\n\n  resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    _context?: EvaluationContext\n  ): ResolutionDetails<boolean> {\n    return this._resolve(flagKey, defaultValue, \"boolean\");\n  }\n\n  resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    _context?: EvaluationContext\n  ): ResolutionDetails<string> {\n    return this._resolve(flagKey, defaultValue, \"string\");\n  }\n\n  resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    _context?: EvaluationContext\n  ): ResolutionDetails<number> {\n    return this._resolve(flagKey, defaultValue, \"number\");\n  }\n\n  resolveObjectEvaluation<T extends JsonValue = JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    _context?: EvaluationContext\n  ): ResolutionDetails<T> {\n    return this._resolve(flagKey, defaultValue, \"object\");\n  }\n\n  /** Escape hatch: access the underlying Quonfig client directly. */\n  getClient(): Quonfig {\n    return this.client;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private helpers\n  // ---------------------------------------------------------------------------\n\n  private _resolve<T>(\n    flagKey: string,\n    defaultValue: T,\n    expectedType: \"boolean\" | \"string\" | \"number\" | \"object\"\n  ): ResolutionDetails<T> {\n    try {\n      const raw = this.client.get(flagKey);\n\n      if (raw === undefined || raw === null) {\n        // Flag not found — return OF default\n        return {\n          value: defaultValue,\n          reason: StandardResolutionReasons.DEFAULT,\n          errorCode: ErrorCode.FLAG_NOT_FOUND,\n        };\n      }\n\n      // Type coercion / validation\n      const coerced = this._coerce<T>(raw, expectedType, defaultValue);\n      if (coerced === null) {\n        return {\n          value: defaultValue,\n          reason: StandardResolutionReasons.ERROR,\n          errorCode: ErrorCode.TYPE_MISMATCH,\n        };\n      }\n\n      return {\n        value: coerced,\n        reason: StandardResolutionReasons.STATIC,\n      };\n    } catch (err) {\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toErrorCode(err),\n      };\n    }\n  }\n\n  /**\n   * Coerce a raw ConfigValue to the expected OF type.\n   * Returns null if the type does not match (signals TYPE_MISMATCH).\n   */\n  private _coerce<T>(\n    raw: unknown,\n    expectedType: \"boolean\" | \"string\" | \"number\" | \"object\",\n    defaultValue: T\n  ): T | null {\n    switch (expectedType) {\n      case \"boolean\":\n        if (typeof raw === \"boolean\") return raw as unknown as T;\n        return null;\n\n      case \"string\":\n        if (typeof raw === \"string\") return raw as unknown as T;\n        // Duration objects: return ISO 8601 string representation\n        if (\n          raw !== null &&\n          typeof raw === \"object\" &&\n          \"seconds\" in raw &&\n          \"ms\" in raw\n        ) {\n          return this._durationToISO(raw as { seconds: number; ms: number }) as unknown as T;\n        }\n        return null;\n\n      case \"number\":\n        if (typeof raw === \"number\") return raw as unknown as T;\n        return null;\n\n      case \"object\":\n        // Arrays (string_list) and plain objects both satisfy \"object\"\n        if (Array.isArray(raw)) return raw as unknown as T;\n        if (raw !== null && typeof raw === \"object\") return raw as unknown as T;\n        return null;\n\n      default:\n        return null;\n    }\n  }\n\n  /** Convert a Quonfig Duration to an ISO 8601 duration string (e.g. \"PT1H30M\"). */\n  private _durationToISO(duration: { seconds: number; ms: number }): string {\n    const totalSeconds = duration.seconds;\n    const hours = Math.floor(totalSeconds / 3600);\n    const minutes = Math.floor((totalSeconds % 3600) / 60);\n    const secs = totalSeconds % 60;\n\n    let iso = \"PT\";\n    if (hours > 0) iso += `${hours}H`;\n    if (minutes > 0) iso += `${minutes}M`;\n    if (secs > 0 || iso === \"PT\") iso += `${secs}S`;\n    return iso;\n  }\n}\n","import type { EvaluationContext } from \"@openfeature/web-sdk\";\nimport type { Contexts } from \"@quonfig/javascript\";\n\n/**\n * Map an OpenFeature EvaluationContext to Quonfig's nested Contexts format.\n *\n * Rules:\n * - `targetingKey` maps to the property specified by `targetingKeyMapping` (default: \"user.id\")\n * - Keys with a dot are split on the FIRST dot: namespace = left side, key = right side\n * - Keys without a dot go into the default (\"\") namespace\n */\nexport function mapContext(\n  ofContext: EvaluationContext,\n  targetingKeyMapping = \"user.id\"\n): Contexts {\n  const result: Record<string, Record<string, unknown>> = {};\n\n  for (const [key, value] of Object.entries(ofContext)) {\n    if (value === undefined) continue;\n\n    if (key === \"targetingKey\") {\n      const dotIdx = targetingKeyMapping.indexOf(\".\");\n      const ns = dotIdx === -1 ? \"\" : targetingKeyMapping.slice(0, dotIdx);\n      const prop =\n        dotIdx === -1 ? targetingKeyMapping : targetingKeyMapping.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = value;\n      continue;\n    }\n\n    const dotIdx = key.indexOf(\".\");\n    if (dotIdx === -1) {\n      result[\"\"] ??= {};\n      result[\"\"][key] = value;\n    } else {\n      const ns = key.slice(0, dotIdx);\n      const prop = key.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = value;\n    }\n  }\n\n  return result as Contexts;\n}\n","import { ErrorCode } from \"@openfeature/web-sdk\";\n\n/**\n * Map a native SDK error (or unknown throw) to an OpenFeature ErrorCode.\n */\nexport function toErrorCode(err: unknown): ErrorCode {\n  const msg =\n    err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();\n\n  if (msg.includes(\"flag not found\") || msg.includes(\"not found\")) {\n    return ErrorCode.FLAG_NOT_FOUND;\n  }\n  if (msg.includes(\"type mismatch\") || msg.includes(\"type_mismatch\")) {\n    return ErrorCode.TYPE_MISMATCH;\n  }\n  if (\n    msg.includes(\"not initialized\") ||\n    msg.includes(\"provider_not_ready\") ||\n    msg.includes(\"call init()\") ||\n    msg.includes(\"not ready\")\n  ) {\n    return ErrorCode.PROVIDER_NOT_READY;\n  }\n  return ErrorCode.GENERAL;\n}\n"],"mappings":"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","names":["ErrorCode","dotIdx","ErrorCode"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@quonfig/openfeature-web",
+  "version": "0.0.1",
+  "description": "OpenFeature provider for Quonfig — Web/Browser (also works with @openfeature/react-sdk)",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist/ && npx tsup",
+    "test": "vitest run --exclude test/conformance/**",
+    "test:conformance": "vitest run test/conformance",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@quonfig/javascript": ">=0.0.3",
+    "@openfeature/web-sdk": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@quonfig/javascript": "^0.0.3",
+    "@openfeature/web-sdk": "^1.0.0",
+    "@types/node": "^20.11.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Quonfig",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/quonfig/openfeature-web.git"
+  }
+}