@quonfig/openfeature-node 0.0.2 → 0.0.3

package/dist/index.cjs

@@ -27,7 +27,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/provider.ts
-var import_server_sdk2 = require("@openfeature/server-sdk");
+var import_server_sdk = require("@openfeature/server-sdk");
 var import_node = require("@quonfig/node");
 
 // src/context.ts
@@ -58,33 +58,17 @@ function mapContext(ofContext, targetingKeyMapping = "user.id") {
   return result;
 }
 
-// src/errors.ts
-var import_server_sdk = require("@openfeature/server-sdk");
-function toErrorCode(err) {
-  const msg = err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();
-  if (msg.includes("not found") || msg.includes("flag not found") || msg.includes("no value found") || msg.includes("value found for key")) {
-    return import_server_sdk.ErrorCode.FLAG_NOT_FOUND;
-  }
-  if (msg.includes("type mismatch")) {
-    return import_server_sdk.ErrorCode.TYPE_MISMATCH;
-  }
-  if (msg.includes("not initialized") || msg.includes("provider not ready")) {
-    return import_server_sdk.ErrorCode.PROVIDER_NOT_READY;
-  }
-  return import_server_sdk.ErrorCode.GENERAL;
-}
-
 // src/provider.ts
 var QuonfigProvider = class {
   constructor(options) {
     this.metadata = { name: "quonfig" };
-    this.events = new import_server_sdk2.OpenFeatureEventEmitter();
+    this.events = new import_server_sdk.OpenFeatureEventEmitter();
     this.hooks = [];
     this.targetingKeyMapping = options.targetingKeyMapping ?? "user.id";
     this.client = new import_node.Quonfig({
       ...options,
       onConfigUpdate: () => {
-        this.events.emit(import_server_sdk2.ProviderEvents.ConfigurationChanged, { flagsChanged: [] });
+        this.events.emit(import_server_sdk.ProviderEvents.ConfigurationChanged, { flagsChanged: [] });
       }
     });
   }
@@ -96,78 +80,30 @@ var QuonfigProvider = class {
   }
   async resolveBooleanEvaluation(flagKey, defaultValue, context, _logger) {
     const mappedCtx = mapContext(context, this.targetingKeyMapping);
-    try {
-      const value = this.client.getBool(flagKey, mappedCtx);
-      if (value === void 0) {
-        return { value: defaultValue, reason: import_server_sdk2.StandardResolutionReasons.DEFAULT };
-      }
-      return { value, reason: import_server_sdk2.StandardResolutionReasons.TARGETING_MATCH };
-    } catch (err) {
-      return {
-        value: defaultValue,
-        reason: import_server_sdk2.StandardResolutionReasons.ERROR,
-        errorCode: toErrorCode(err),
-        errorMessage: err instanceof Error ? err.message : String(err)
-      };
-    }
+    const details = this.client.getBoolDetails(flagKey, mappedCtx);
+    return toResolutionDetails(details, defaultValue);
   }
   async resolveStringEvaluation(flagKey, defaultValue, context, _logger) {
     const mappedCtx = mapContext(context, this.targetingKeyMapping);
-    try {
-      const value = this.client.getString(flagKey, mappedCtx);
-      if (value === void 0) {
-        return { value: defaultValue, reason: import_server_sdk2.StandardResolutionReasons.DEFAULT };
-      }
-      return { value, reason: import_server_sdk2.StandardResolutionReasons.TARGETING_MATCH };
-    } catch (err) {
-      return {
-        value: defaultValue,
-        reason: import_server_sdk2.StandardResolutionReasons.ERROR,
-        errorCode: toErrorCode(err),
-        errorMessage: err instanceof Error ? err.message : String(err)
-      };
-    }
+    const details = this.client.getStringDetails(flagKey, mappedCtx);
+    return toResolutionDetails(details, defaultValue);
   }
   async resolveNumberEvaluation(flagKey, defaultValue, context, _logger) {
     const mappedCtx = mapContext(context, this.targetingKeyMapping);
-    try {
-      const value = this.client.getNumber(flagKey, mappedCtx);
-      if (value === void 0) {
-        return { value: defaultValue, reason: import_server_sdk2.StandardResolutionReasons.DEFAULT };
-      }
-      return { value, reason: import_server_sdk2.StandardResolutionReasons.TARGETING_MATCH };
-    } catch (err) {
-      return {
-        value: defaultValue,
-        reason: import_server_sdk2.StandardResolutionReasons.ERROR,
-        errorCode: toErrorCode(err),
-        errorMessage: err instanceof Error ? err.message : String(err)
-      };
-    }
+    const details = this.client.getNumberDetails(flagKey, mappedCtx);
+    return toResolutionDetails(details, defaultValue);
   }
   async resolveObjectEvaluation(flagKey, defaultValue, context, _logger) {
     const mappedCtx = mapContext(context, this.targetingKeyMapping);
-    try {
-      const listVal = this.client.getStringList(flagKey, mappedCtx);
-      if (listVal !== void 0) {
-        return {
-          value: listVal,
-          reason: import_server_sdk2.StandardResolutionReasons.TARGETING_MATCH
-        };
-      }
-      const jsonVal = this.client.getJSON(flagKey, mappedCtx);
-      if (jsonVal !== void 0) {
-        return { value: jsonVal, reason: import_server_sdk2.StandardResolutionReasons.TARGETING_MATCH };
-      }
-      return { value: defaultValue, reason: import_server_sdk2.StandardResolutionReasons.DEFAULT };
-    } catch (err) {
-      return {
-        value: defaultValue,
-        reason: import_server_sdk2.StandardResolutionReasons.ERROR,
-        errorCode: toErrorCode(err),
-        errorMessage: err instanceof Error ? err.message : String(err)
-      };
+    const listDetails = this.client.getStringListDetails(flagKey, mappedCtx);
+    if (listDetails.reason === "STATIC" || listDetails.reason === "TARGETING_MATCH" || listDetails.reason === "SPLIT") {
+      return toResolutionDetails(
+        listDetails,
+        defaultValue
+      );
     }
+    const jsonDetails = this.client.getJSONDetails(flagKey, mappedCtx);
+    return toResolutionDetails(jsonDetails, defaultValue);
   }
   /**
    * Escape hatch: access the underlying @quonfig/node client for native-only features
@@ -177,6 +113,54 @@ var QuonfigProvider = class {
     return this.client;
   }
 };
+function toResolutionDetails(details, defaultValue) {
+  switch (details.reason) {
+    case "STATIC":
+      return { value: details.value, reason: import_server_sdk.StandardResolutionReasons.STATIC };
+    case "TARGETING_MATCH":
+      return {
+        value: details.value,
+        reason: import_server_sdk.StandardResolutionReasons.TARGETING_MATCH
+      };
+    case "SPLIT":
+      return { value: details.value, reason: import_server_sdk.StandardResolutionReasons.SPLIT };
+    case "DEFAULT":
+      return { value: defaultValue, reason: import_server_sdk.StandardResolutionReasons.DEFAULT };
+    case "ERROR":
+      return {
+        value: defaultValue,
+        reason: import_server_sdk.StandardResolutionReasons.ERROR,
+        errorCode: toOFErrorCode(details.errorCode)
+      };
+  }
+}
+function toOFErrorCode(code) {
+  switch (code) {
+    case "FLAG_NOT_FOUND":
+      return import_server_sdk.ErrorCode.FLAG_NOT_FOUND;
+    case "TYPE_MISMATCH":
+      return import_server_sdk.ErrorCode.TYPE_MISMATCH;
+    case "GENERAL":
+    default:
+      return import_server_sdk.ErrorCode.GENERAL;
+  }
+}
+
+// src/errors.ts
+var import_server_sdk2 = require("@openfeature/server-sdk");
+function toErrorCode(err) {
+  const msg = err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();
+  if (msg.includes("not found") || msg.includes("flag not found") || msg.includes("no value found") || msg.includes("value found for key")) {
+    return import_server_sdk2.ErrorCode.FLAG_NOT_FOUND;
+  }
+  if (msg.includes("type mismatch")) {
+    return import_server_sdk2.ErrorCode.TYPE_MISMATCH;
+  }
+  if (msg.includes("not initialized") || msg.includes("provider not ready")) {
+    return import_server_sdk2.ErrorCode.PROVIDER_NOT_READY;
+  }
+  return import_server_sdk2.ErrorCode.GENERAL;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   QuonfigProvider,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/provider.ts","../src/context.ts","../src/errors.ts"],"sourcesContent":["export { QuonfigProvider } from \"./provider.js\";\nexport type { QuonfigProviderOptions } from \"./provider.js\";\nexport { mapContext } from \"./context.js\";\nexport { toErrorCode } from \"./errors.js\";\n","import {\n  EvaluationContext,\n  JsonValue,\n  Logger,\n  OpenFeatureEventEmitter,\n  Provider,\n  ProviderEvents,\n  ResolutionDetails,\n  StandardResolutionReasons,\n} from \"@openfeature/server-sdk\";\nimport { Quonfig, QuonfigOptions } from \"@quonfig/node\";\nimport { mapContext } from \"./context.js\";\nimport { toErrorCode } from \"./errors.js\";\n\nexport interface QuonfigProviderOptions extends Omit<QuonfigOptions, \"onConfigUpdate\"> {\n  /**\n   * Dot-notation path to map OpenFeature's `targetingKey` into Quonfig's nested context.\n   * Defaults to \"user.id\".\n   */\n  targetingKeyMapping?: string;\n}\n\n/**\n * QuonfigProvider wraps the @quonfig/node native SDK and implements the\n * OpenFeature server-side Provider interface.\n *\n * Usage:\n * ```typescript\n * import { QuonfigProvider } from \"@quonfig/openfeature-node\";\n * import { OpenFeature } from \"@openfeature/server-sdk\";\n *\n * const provider = new QuonfigProvider({ sdkKey: \"qf_sk_...\" });\n * await OpenFeature.setProviderAndWait(provider);\n * const client = OpenFeature.getClient();\n * const enabled = await client.getBooleanValue(\"my-flag\", false);\n * ```\n */\nexport class QuonfigProvider implements Provider {\n  readonly metadata = { name: \"quonfig\" } as const;\n  readonly events = new OpenFeatureEventEmitter();\n  readonly hooks = [];\n\n  private readonly client: Quonfig;\n  private readonly targetingKeyMapping: string;\n\n  constructor(options: QuonfigProviderOptions) {\n    this.targetingKeyMapping = options.targetingKeyMapping ?? \"user.id\";\n    // onConfigUpdate is not yet in the published @quonfig/node types; cast until sdk-node ships it\n    this.client = new Quonfig({\n      ...options,\n      onConfigUpdate: () => {\n        this.events.emit(ProviderEvents.ConfigurationChanged, { flagsChanged: [] });\n      },\n    } as ConstructorParameters<typeof Quonfig>[0]);\n  }\n\n  async initialize(_context?: EvaluationContext): Promise<void> {\n    await this.client.init();\n  }\n\n  async shutdown(): Promise<void> {\n    this.client.close();\n  }\n\n  async resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<boolean>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    try {\n      const value = this.client.getBool(flagKey, mappedCtx);\n      if (value === undefined) {\n        return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };\n      }\n      return { value, reason: StandardResolutionReasons.TARGETING_MATCH };\n    } catch (err) {\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toErrorCode(err),\n        errorMessage: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n\n  async resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<string>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    try {\n      const value = this.client.getString(flagKey, mappedCtx);\n      if (value === undefined) {\n        return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };\n      }\n      return { value, reason: StandardResolutionReasons.TARGETING_MATCH };\n    } catch (err) {\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toErrorCode(err),\n        errorMessage: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n\n  async resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<number>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    try {\n      const value = this.client.getNumber(flagKey, mappedCtx);\n      if (value === undefined) {\n        return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };\n      }\n      return { value, reason: StandardResolutionReasons.TARGETING_MATCH };\n    } catch (err) {\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toErrorCode(err),\n        errorMessage: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n\n  async resolveObjectEvaluation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    try {\n      // Try string_list first (returns string[])\n      const listVal = this.client.getStringList(flagKey, mappedCtx);\n      if (listVal !== undefined) {\n        return {\n          value: listVal as unknown as T,\n          reason: StandardResolutionReasons.TARGETING_MATCH,\n        };\n      }\n      // Fall back to JSON\n      const jsonVal = this.client.getJSON(flagKey, mappedCtx);\n      if (jsonVal !== undefined) {\n        return { value: jsonVal as T, reason: StandardResolutionReasons.TARGETING_MATCH };\n      }\n      return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };\n    } catch (err) {\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toErrorCode(err),\n        errorMessage: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n\n  /**\n   * Escape hatch: access the underlying @quonfig/node client for native-only features\n   * (shouldLog, keys, rawConfig, etc.)\n   */\n  getClient(): Quonfig {\n    return this.client;\n  }\n}\n","import type { EvaluationContext } from \"@openfeature/server-sdk\";\nimport type { Contexts, ContextValue } from \"@quonfig/node\";\n\n/**\n * Maps an OpenFeature flat EvaluationContext to Quonfig's nested Contexts format.\n *\n * Rules:\n * - `targetingKey` maps to the namespace+property specified by `targetingKeyMapping` (default: \"user.id\")\n * - Keys with a dot are split on the first dot: \"user.email\" -> namespace \"user\", key \"email\"\n * - Keys without a dot go to the default (empty-string) namespace: \"country\" -> { \"\": { country: ... } }\n * - Multi-dot keys split on first dot only: \"user.ip.address\" -> { user: { \"ip.address\": ... } }\n */\nexport function mapContext(\n  ofContext: EvaluationContext,\n  targetingKeyMapping = \"user.id\",\n): Contexts {\n  const result: Record<string, Record<string, ContextValue>> = {};\n\n  for (const [key, value] of Object.entries(ofContext)) {\n    if (value === undefined) continue;\n\n    // Cast to ContextValue -- OpenFeature allows arbitrary nesting but Quonfig\n    // contexts accept primitives and string arrays. Callers should pass only\n    // primitive or string[] values for keys they want evaluated.\n    const ctxValue = value as ContextValue;\n\n    if (key === \"targetingKey\") {\n      const dotIdx = targetingKeyMapping.indexOf(\".\");\n      const ns = dotIdx === -1 ? \"\" : targetingKeyMapping.slice(0, dotIdx);\n      const prop = dotIdx === -1 ? targetingKeyMapping : targetingKeyMapping.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = ctxValue;\n      continue;\n    }\n\n    const dotIdx = key.indexOf(\".\");\n    if (dotIdx === -1) {\n      result[\"\"] ??= {};\n      result[\"\"][key] = ctxValue;\n    } else {\n      const ns = key.slice(0, dotIdx);\n      const prop = key.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = ctxValue;\n    }\n  }\n\n  return result;\n}\n","import { ErrorCode } from \"@openfeature/server-sdk\";\n\n/**\n * Maps a native SDK error to an OpenFeature ErrorCode.\n *\n * The native SDK throws Error instances with message strings. We map by inspecting\n * the lowercased message.\n */\nexport function toErrorCode(err: unknown): ErrorCode {\n  const msg =\n    err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();\n\n  if (\n    msg.includes(\"not found\") ||\n    msg.includes(\"flag not found\") ||\n    msg.includes(\"no value found\") ||\n    msg.includes(\"value found for key\")\n  ) {\n    return ErrorCode.FLAG_NOT_FOUND;\n  }\n  if (msg.includes(\"type mismatch\")) {\n    return ErrorCode.TYPE_MISMATCH;\n  }\n  if (msg.includes(\"not initialized\") || msg.includes(\"provider not ready\")) {\n    return ErrorCode.PROVIDER_NOT_READY;\n  }\n  return ErrorCode.GENERAL;\n}\n"],"mappings":"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","names":["import_server_sdk","dotIdx"]}
+{"version":3,"sources":["../src/index.ts","../src/provider.ts","../src/context.ts","../src/errors.ts"],"sourcesContent":["export { QuonfigProvider } from \"./provider.js\";\nexport type { QuonfigProviderOptions } from \"./provider.js\";\nexport { mapContext } from \"./context.js\";\nexport { toErrorCode } from \"./errors.js\";\n","import {\n  ErrorCode,\n  EvaluationContext,\n  JsonValue,\n  Logger,\n  OpenFeatureEventEmitter,\n  Provider,\n  ProviderEvents,\n  ResolutionDetails,\n  StandardResolutionReasons,\n} from \"@openfeature/server-sdk\";\nimport { EvaluationDetails, Quonfig, QuonfigOptions } from \"@quonfig/node\";\nimport { mapContext } from \"./context.js\";\n\nexport interface QuonfigProviderOptions extends Omit<QuonfigOptions, \"onConfigUpdate\"> {\n  /**\n   * Dot-notation path to map OpenFeature's `targetingKey` into Quonfig's nested context.\n   * Defaults to \"user.id\".\n   */\n  targetingKeyMapping?: string;\n}\n\n/**\n * QuonfigProvider wraps the @quonfig/node native SDK and implements the\n * OpenFeature server-side Provider interface.\n *\n * Usage:\n * ```typescript\n * import { QuonfigProvider } from \"@quonfig/openfeature-node\";\n * import { OpenFeature } from \"@openfeature/server-sdk\";\n *\n * const provider = new QuonfigProvider({ sdkKey: \"qf_sk_...\" });\n * await OpenFeature.setProviderAndWait(provider);\n * const client = OpenFeature.getClient();\n * const enabled = await client.getBooleanValue(\"my-flag\", false);\n * ```\n */\nexport class QuonfigProvider implements Provider {\n  readonly metadata = { name: \"quonfig\" } as const;\n  readonly events = new OpenFeatureEventEmitter();\n  readonly hooks = [];\n\n  private readonly client: Quonfig;\n  private readonly targetingKeyMapping: string;\n\n  constructor(options: QuonfigProviderOptions) {\n    this.targetingKeyMapping = options.targetingKeyMapping ?? \"user.id\";\n    this.client = new Quonfig({\n      ...options,\n      onConfigUpdate: () => {\n        this.events.emit(ProviderEvents.ConfigurationChanged, { flagsChanged: [] });\n      },\n    });\n  }\n\n  async initialize(_context?: EvaluationContext): Promise<void> {\n    await this.client.init();\n  }\n\n  async shutdown(): Promise<void> {\n    this.client.close();\n  }\n\n  async resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<boolean>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    const details = this.client.getBoolDetails(flagKey, mappedCtx);\n    return toResolutionDetails(details, defaultValue);\n  }\n\n  async resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<string>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    const details = this.client.getStringDetails(flagKey, mappedCtx);\n    return toResolutionDetails(details, defaultValue);\n  }\n\n  async resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<number>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    const details = this.client.getNumberDetails(flagKey, mappedCtx);\n    return toResolutionDetails(details, defaultValue);\n  }\n\n  async resolveObjectEvaluation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    // Try string_list first (returns string[]), fall back to JSON.\n    const listDetails = this.client.getStringListDetails(flagKey, mappedCtx);\n    if (\n      listDetails.reason === \"STATIC\" ||\n      listDetails.reason === \"TARGETING_MATCH\" ||\n      listDetails.reason === \"SPLIT\"\n    ) {\n      return toResolutionDetails(\n        listDetails as EvaluationDetails<unknown> as EvaluationDetails<T>,\n        defaultValue,\n      );\n    }\n    const jsonDetails = this.client.getJSONDetails(flagKey, mappedCtx);\n    return toResolutionDetails(jsonDetails as EvaluationDetails<T>, defaultValue);\n  }\n\n  /**\n   * Escape hatch: access the underlying @quonfig/node client for native-only features\n   * (shouldLog, keys, rawConfig, etc.)\n   */\n  getClient(): Quonfig {\n    return this.client;\n  }\n}\n\n/**\n * Translate a Quonfig EvaluationDetails<T> into an OpenFeature ResolutionDetails<T>.\n *\n * Reason mapping (from the brief):\n *   STATIC           → StandardResolutionReasons.STATIC\n *   TARGETING_MATCH  → StandardResolutionReasons.TARGETING_MATCH\n *   SPLIT            → StandardResolutionReasons.SPLIT\n *   DEFAULT          → defaultValue + StandardResolutionReasons.DEFAULT\n *   ERROR            → defaultValue + ERROR + errorCode (FLAG_NOT_FOUND / TYPE_MISMATCH / GENERAL)\n */\nfunction toResolutionDetails<T>(\n  details: EvaluationDetails<T>,\n  defaultValue: T,\n): ResolutionDetails<T> {\n  switch (details.reason) {\n    case \"STATIC\":\n      return { value: details.value as T, reason: StandardResolutionReasons.STATIC };\n    case \"TARGETING_MATCH\":\n      return {\n        value: details.value as T,\n        reason: StandardResolutionReasons.TARGETING_MATCH,\n      };\n    case \"SPLIT\":\n      return { value: details.value as T, reason: StandardResolutionReasons.SPLIT };\n    case \"DEFAULT\":\n      return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };\n    case \"ERROR\":\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toOFErrorCode(details.errorCode),\n      };\n  }\n}\n\nfunction toOFErrorCode(code: EvaluationDetails<unknown>[\"errorCode\"]): ErrorCode {\n  switch (code) {\n    case \"FLAG_NOT_FOUND\":\n      return ErrorCode.FLAG_NOT_FOUND;\n    case \"TYPE_MISMATCH\":\n      return ErrorCode.TYPE_MISMATCH;\n    case \"GENERAL\":\n    default:\n      return ErrorCode.GENERAL;\n  }\n}\n","import type { EvaluationContext } from \"@openfeature/server-sdk\";\nimport type { Contexts, ContextValue } from \"@quonfig/node\";\n\n/**\n * Maps an OpenFeature flat EvaluationContext to Quonfig's nested Contexts format.\n *\n * Rules:\n * - `targetingKey` maps to the namespace+property specified by `targetingKeyMapping` (default: \"user.id\")\n * - Keys with a dot are split on the first dot: \"user.email\" -> namespace \"user\", key \"email\"\n * - Keys without a dot go to the default (empty-string) namespace: \"country\" -> { \"\": { country: ... } }\n * - Multi-dot keys split on first dot only: \"user.ip.address\" -> { user: { \"ip.address\": ... } }\n */\nexport function mapContext(\n  ofContext: EvaluationContext,\n  targetingKeyMapping = \"user.id\",\n): Contexts {\n  const result: Record<string, Record<string, ContextValue>> = {};\n\n  for (const [key, value] of Object.entries(ofContext)) {\n    if (value === undefined) continue;\n\n    // Cast to ContextValue -- OpenFeature allows arbitrary nesting but Quonfig\n    // contexts accept primitives and string arrays. Callers should pass only\n    // primitive or string[] values for keys they want evaluated.\n    const ctxValue = value as ContextValue;\n\n    if (key === \"targetingKey\") {\n      const dotIdx = targetingKeyMapping.indexOf(\".\");\n      const ns = dotIdx === -1 ? \"\" : targetingKeyMapping.slice(0, dotIdx);\n      const prop = dotIdx === -1 ? targetingKeyMapping : targetingKeyMapping.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = ctxValue;\n      continue;\n    }\n\n    const dotIdx = key.indexOf(\".\");\n    if (dotIdx === -1) {\n      result[\"\"] ??= {};\n      result[\"\"][key] = ctxValue;\n    } else {\n      const ns = key.slice(0, dotIdx);\n      const prop = key.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = ctxValue;\n    }\n  }\n\n  return result;\n}\n","import { ErrorCode } from \"@openfeature/server-sdk\";\n\n/**\n * Maps a native SDK error to an OpenFeature ErrorCode.\n *\n * The native SDK throws Error instances with message strings. We map by inspecting\n * the lowercased message.\n */\nexport function toErrorCode(err: unknown): ErrorCode {\n  const msg =\n    err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();\n\n  if (\n    msg.includes(\"not found\") ||\n    msg.includes(\"flag not found\") ||\n    msg.includes(\"no value found\") ||\n    msg.includes(\"value found for key\")\n  ) {\n    return ErrorCode.FLAG_NOT_FOUND;\n  }\n  if (msg.includes(\"type mismatch\")) {\n    return ErrorCode.TYPE_MISMATCH;\n  }\n  if (msg.includes(\"not initialized\") || msg.includes(\"provider not ready\")) {\n    return ErrorCode.PROVIDER_NOT_READY;\n  }\n  return ErrorCode.GENERAL;\n}\n"],"mappings":"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","names":["dotIdx","import_server_sdk"]}

package/dist/index.js

@@ -1,5 +1,6 @@
 // src/provider.ts
 import {
+  ErrorCode,
   OpenFeatureEventEmitter,
   ProviderEvents,
   StandardResolutionReasons
@@ -34,22 +35,6 @@ function mapContext(ofContext, targetingKeyMapping = "user.id") {
   return result;
 }
 
-// src/errors.ts
-import { ErrorCode } from "@openfeature/server-sdk";
-function toErrorCode(err) {
-  const msg = err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();
-  if (msg.includes("not found") || msg.includes("flag not found") || msg.includes("no value found") || msg.includes("value found for key")) {
-    return ErrorCode.FLAG_NOT_FOUND;
-  }
-  if (msg.includes("type mismatch")) {
-    return ErrorCode.TYPE_MISMATCH;
-  }
-  if (msg.includes("not initialized") || msg.includes("provider not ready")) {
-    return ErrorCode.PROVIDER_NOT_READY;
-  }
-  return ErrorCode.GENERAL;
-}
-
 // src/provider.ts
 var QuonfigProvider = class {
   constructor(options) {
@@ -72,78 +57,30 @@ var QuonfigProvider = class {
   }
   async resolveBooleanEvaluation(flagKey, defaultValue, context, _logger) {
     const mappedCtx = mapContext(context, this.targetingKeyMapping);
-    try {
-      const value = this.client.getBool(flagKey, mappedCtx);
-      if (value === void 0) {
-        return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };
-      }
-      return { value, reason: StandardResolutionReasons.TARGETING_MATCH };
-    } catch (err) {
-      return {
-        value: defaultValue,
-        reason: StandardResolutionReasons.ERROR,
-        errorCode: toErrorCode(err),
-        errorMessage: err instanceof Error ? err.message : String(err)
-      };
-    }
+    const details = this.client.getBoolDetails(flagKey, mappedCtx);
+    return toResolutionDetails(details, defaultValue);
   }
   async resolveStringEvaluation(flagKey, defaultValue, context, _logger) {
     const mappedCtx = mapContext(context, this.targetingKeyMapping);
-    try {
-      const value = this.client.getString(flagKey, mappedCtx);
-      if (value === void 0) {
-        return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };
-      }
-      return { value, reason: StandardResolutionReasons.TARGETING_MATCH };
-    } catch (err) {
-      return {
-        value: defaultValue,
-        reason: StandardResolutionReasons.ERROR,
-        errorCode: toErrorCode(err),
-        errorMessage: err instanceof Error ? err.message : String(err)
-      };
-    }
+    const details = this.client.getStringDetails(flagKey, mappedCtx);
+    return toResolutionDetails(details, defaultValue);
   }
   async resolveNumberEvaluation(flagKey, defaultValue, context, _logger) {
     const mappedCtx = mapContext(context, this.targetingKeyMapping);
-    try {
-      const value = this.client.getNumber(flagKey, mappedCtx);
-      if (value === void 0) {
-        return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };
-      }
-      return { value, reason: StandardResolutionReasons.TARGETING_MATCH };
-    } catch (err) {
-      return {
-        value: defaultValue,
-        reason: StandardResolutionReasons.ERROR,
-        errorCode: toErrorCode(err),
-        errorMessage: err instanceof Error ? err.message : String(err)
-      };
-    }
+    const details = this.client.getNumberDetails(flagKey, mappedCtx);
+    return toResolutionDetails(details, defaultValue);
   }
   async resolveObjectEvaluation(flagKey, defaultValue, context, _logger) {
     const mappedCtx = mapContext(context, this.targetingKeyMapping);
-    try {
-      const listVal = this.client.getStringList(flagKey, mappedCtx);
-      if (listVal !== void 0) {
-        return {
-          value: listVal,
-          reason: StandardResolutionReasons.TARGETING_MATCH
-        };
-      }
-      const jsonVal = this.client.getJSON(flagKey, mappedCtx);
-      if (jsonVal !== void 0) {
-        return { value: jsonVal, reason: StandardResolutionReasons.TARGETING_MATCH };
-      }
-      return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };
-    } catch (err) {
-      return {
-        value: defaultValue,
-        reason: StandardResolutionReasons.ERROR,
-        errorCode: toErrorCode(err),
-        errorMessage: err instanceof Error ? err.message : String(err)
-      };
+    const listDetails = this.client.getStringListDetails(flagKey, mappedCtx);
+    if (listDetails.reason === "STATIC" || listDetails.reason === "TARGETING_MATCH" || listDetails.reason === "SPLIT") {
+      return toResolutionDetails(
+        listDetails,
+        defaultValue
+      );
     }
+    const jsonDetails = this.client.getJSONDetails(flagKey, mappedCtx);
+    return toResolutionDetails(jsonDetails, defaultValue);
   }
   /**
    * Escape hatch: access the underlying @quonfig/node client for native-only features
@@ -153,6 +90,54 @@ var QuonfigProvider = class {
     return this.client;
   }
 };
+function toResolutionDetails(details, defaultValue) {
+  switch (details.reason) {
+    case "STATIC":
+      return { value: details.value, reason: StandardResolutionReasons.STATIC };
+    case "TARGETING_MATCH":
+      return {
+        value: details.value,
+        reason: StandardResolutionReasons.TARGETING_MATCH
+      };
+    case "SPLIT":
+      return { value: details.value, reason: StandardResolutionReasons.SPLIT };
+    case "DEFAULT":
+      return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };
+    case "ERROR":
+      return {
+        value: defaultValue,
+        reason: StandardResolutionReasons.ERROR,
+        errorCode: toOFErrorCode(details.errorCode)
+      };
+  }
+}
+function toOFErrorCode(code) {
+  switch (code) {
+    case "FLAG_NOT_FOUND":
+      return ErrorCode.FLAG_NOT_FOUND;
+    case "TYPE_MISMATCH":
+      return ErrorCode.TYPE_MISMATCH;
+    case "GENERAL":
+    default:
+      return ErrorCode.GENERAL;
+  }
+}
+
+// src/errors.ts
+import { ErrorCode as ErrorCode2 } from "@openfeature/server-sdk";
+function toErrorCode(err) {
+  const msg = err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();
+  if (msg.includes("not found") || msg.includes("flag not found") || msg.includes("no value found") || msg.includes("value found for key")) {
+    return ErrorCode2.FLAG_NOT_FOUND;
+  }
+  if (msg.includes("type mismatch")) {
+    return ErrorCode2.TYPE_MISMATCH;
+  }
+  if (msg.includes("not initialized") || msg.includes("provider not ready")) {
+    return ErrorCode2.PROVIDER_NOT_READY;
+  }
+  return ErrorCode2.GENERAL;
+}
 export {
   QuonfigProvider,
   mapContext,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/provider.ts","../src/context.ts","../src/errors.ts"],"sourcesContent":["import {\n  EvaluationContext,\n  JsonValue,\n  Logger,\n  OpenFeatureEventEmitter,\n  Provider,\n  ProviderEvents,\n  ResolutionDetails,\n  StandardResolutionReasons,\n} from \"@openfeature/server-sdk\";\nimport { Quonfig, QuonfigOptions } from \"@quonfig/node\";\nimport { mapContext } from \"./context.js\";\nimport { toErrorCode } from \"./errors.js\";\n\nexport interface QuonfigProviderOptions extends Omit<QuonfigOptions, \"onConfigUpdate\"> {\n  /**\n   * Dot-notation path to map OpenFeature's `targetingKey` into Quonfig's nested context.\n   * Defaults to \"user.id\".\n   */\n  targetingKeyMapping?: string;\n}\n\n/**\n * QuonfigProvider wraps the @quonfig/node native SDK and implements the\n * OpenFeature server-side Provider interface.\n *\n * Usage:\n * ```typescript\n * import { QuonfigProvider } from \"@quonfig/openfeature-node\";\n * import { OpenFeature } from \"@openfeature/server-sdk\";\n *\n * const provider = new QuonfigProvider({ sdkKey: \"qf_sk_...\" });\n * await OpenFeature.setProviderAndWait(provider);\n * const client = OpenFeature.getClient();\n * const enabled = await client.getBooleanValue(\"my-flag\", false);\n * ```\n */\nexport class QuonfigProvider implements Provider {\n  readonly metadata = { name: \"quonfig\" } as const;\n  readonly events = new OpenFeatureEventEmitter();\n  readonly hooks = [];\n\n  private readonly client: Quonfig;\n  private readonly targetingKeyMapping: string;\n\n  constructor(options: QuonfigProviderOptions) {\n    this.targetingKeyMapping = options.targetingKeyMapping ?? \"user.id\";\n    // onConfigUpdate is not yet in the published @quonfig/node types; cast until sdk-node ships it\n    this.client = new Quonfig({\n      ...options,\n      onConfigUpdate: () => {\n        this.events.emit(ProviderEvents.ConfigurationChanged, { flagsChanged: [] });\n      },\n    } as ConstructorParameters<typeof Quonfig>[0]);\n  }\n\n  async initialize(_context?: EvaluationContext): Promise<void> {\n    await this.client.init();\n  }\n\n  async shutdown(): Promise<void> {\n    this.client.close();\n  }\n\n  async resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<boolean>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    try {\n      const value = this.client.getBool(flagKey, mappedCtx);\n      if (value === undefined) {\n        return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };\n      }\n      return { value, reason: StandardResolutionReasons.TARGETING_MATCH };\n    } catch (err) {\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toErrorCode(err),\n        errorMessage: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n\n  async resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<string>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    try {\n      const value = this.client.getString(flagKey, mappedCtx);\n      if (value === undefined) {\n        return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };\n      }\n      return { value, reason: StandardResolutionReasons.TARGETING_MATCH };\n    } catch (err) {\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toErrorCode(err),\n        errorMessage: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n\n  async resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<number>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    try {\n      const value = this.client.getNumber(flagKey, mappedCtx);\n      if (value === undefined) {\n        return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };\n      }\n      return { value, reason: StandardResolutionReasons.TARGETING_MATCH };\n    } catch (err) {\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toErrorCode(err),\n        errorMessage: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n\n  async resolveObjectEvaluation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    try {\n      // Try string_list first (returns string[])\n      const listVal = this.client.getStringList(flagKey, mappedCtx);\n      if (listVal !== undefined) {\n        return {\n          value: listVal as unknown as T,\n          reason: StandardResolutionReasons.TARGETING_MATCH,\n        };\n      }\n      // Fall back to JSON\n      const jsonVal = this.client.getJSON(flagKey, mappedCtx);\n      if (jsonVal !== undefined) {\n        return { value: jsonVal as T, reason: StandardResolutionReasons.TARGETING_MATCH };\n      }\n      return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };\n    } catch (err) {\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toErrorCode(err),\n        errorMessage: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n\n  /**\n   * Escape hatch: access the underlying @quonfig/node client for native-only features\n   * (shouldLog, keys, rawConfig, etc.)\n   */\n  getClient(): Quonfig {\n    return this.client;\n  }\n}\n","import type { EvaluationContext } from \"@openfeature/server-sdk\";\nimport type { Contexts, ContextValue } from \"@quonfig/node\";\n\n/**\n * Maps an OpenFeature flat EvaluationContext to Quonfig's nested Contexts format.\n *\n * Rules:\n * - `targetingKey` maps to the namespace+property specified by `targetingKeyMapping` (default: \"user.id\")\n * - Keys with a dot are split on the first dot: \"user.email\" -> namespace \"user\", key \"email\"\n * - Keys without a dot go to the default (empty-string) namespace: \"country\" -> { \"\": { country: ... } }\n * - Multi-dot keys split on first dot only: \"user.ip.address\" -> { user: { \"ip.address\": ... } }\n */\nexport function mapContext(\n  ofContext: EvaluationContext,\n  targetingKeyMapping = \"user.id\",\n): Contexts {\n  const result: Record<string, Record<string, ContextValue>> = {};\n\n  for (const [key, value] of Object.entries(ofContext)) {\n    if (value === undefined) continue;\n\n    // Cast to ContextValue -- OpenFeature allows arbitrary nesting but Quonfig\n    // contexts accept primitives and string arrays. Callers should pass only\n    // primitive or string[] values for keys they want evaluated.\n    const ctxValue = value as ContextValue;\n\n    if (key === \"targetingKey\") {\n      const dotIdx = targetingKeyMapping.indexOf(\".\");\n      const ns = dotIdx === -1 ? \"\" : targetingKeyMapping.slice(0, dotIdx);\n      const prop = dotIdx === -1 ? targetingKeyMapping : targetingKeyMapping.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = ctxValue;\n      continue;\n    }\n\n    const dotIdx = key.indexOf(\".\");\n    if (dotIdx === -1) {\n      result[\"\"] ??= {};\n      result[\"\"][key] = ctxValue;\n    } else {\n      const ns = key.slice(0, dotIdx);\n      const prop = key.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = ctxValue;\n    }\n  }\n\n  return result;\n}\n","import { ErrorCode } from \"@openfeature/server-sdk\";\n\n/**\n * Maps a native SDK error to an OpenFeature ErrorCode.\n *\n * The native SDK throws Error instances with message strings. We map by inspecting\n * the lowercased message.\n */\nexport function toErrorCode(err: unknown): ErrorCode {\n  const msg =\n    err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();\n\n  if (\n    msg.includes(\"not found\") ||\n    msg.includes(\"flag not found\") ||\n    msg.includes(\"no value found\") ||\n    msg.includes(\"value found for key\")\n  ) {\n    return ErrorCode.FLAG_NOT_FOUND;\n  }\n  if (msg.includes(\"type mismatch\")) {\n    return ErrorCode.TYPE_MISMATCH;\n  }\n  if (msg.includes(\"not initialized\") || msg.includes(\"provider not ready\")) {\n    return ErrorCode.PROVIDER_NOT_READY;\n  }\n  return ErrorCode.GENERAL;\n}\n"],"mappings":"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","names":["dotIdx"]}
+{"version":3,"sources":["../src/provider.ts","../src/context.ts","../src/errors.ts"],"sourcesContent":["import {\n  ErrorCode,\n  EvaluationContext,\n  JsonValue,\n  Logger,\n  OpenFeatureEventEmitter,\n  Provider,\n  ProviderEvents,\n  ResolutionDetails,\n  StandardResolutionReasons,\n} from \"@openfeature/server-sdk\";\nimport { EvaluationDetails, Quonfig, QuonfigOptions } from \"@quonfig/node\";\nimport { mapContext } from \"./context.js\";\n\nexport interface QuonfigProviderOptions extends Omit<QuonfigOptions, \"onConfigUpdate\"> {\n  /**\n   * Dot-notation path to map OpenFeature's `targetingKey` into Quonfig's nested context.\n   * Defaults to \"user.id\".\n   */\n  targetingKeyMapping?: string;\n}\n\n/**\n * QuonfigProvider wraps the @quonfig/node native SDK and implements the\n * OpenFeature server-side Provider interface.\n *\n * Usage:\n * ```typescript\n * import { QuonfigProvider } from \"@quonfig/openfeature-node\";\n * import { OpenFeature } from \"@openfeature/server-sdk\";\n *\n * const provider = new QuonfigProvider({ sdkKey: \"qf_sk_...\" });\n * await OpenFeature.setProviderAndWait(provider);\n * const client = OpenFeature.getClient();\n * const enabled = await client.getBooleanValue(\"my-flag\", false);\n * ```\n */\nexport class QuonfigProvider implements Provider {\n  readonly metadata = { name: \"quonfig\" } as const;\n  readonly events = new OpenFeatureEventEmitter();\n  readonly hooks = [];\n\n  private readonly client: Quonfig;\n  private readonly targetingKeyMapping: string;\n\n  constructor(options: QuonfigProviderOptions) {\n    this.targetingKeyMapping = options.targetingKeyMapping ?? \"user.id\";\n    this.client = new Quonfig({\n      ...options,\n      onConfigUpdate: () => {\n        this.events.emit(ProviderEvents.ConfigurationChanged, { flagsChanged: [] });\n      },\n    });\n  }\n\n  async initialize(_context?: EvaluationContext): Promise<void> {\n    await this.client.init();\n  }\n\n  async shutdown(): Promise<void> {\n    this.client.close();\n  }\n\n  async resolveBooleanEvaluation(\n    flagKey: string,\n    defaultValue: boolean,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<boolean>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    const details = this.client.getBoolDetails(flagKey, mappedCtx);\n    return toResolutionDetails(details, defaultValue);\n  }\n\n  async resolveStringEvaluation(\n    flagKey: string,\n    defaultValue: string,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<string>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    const details = this.client.getStringDetails(flagKey, mappedCtx);\n    return toResolutionDetails(details, defaultValue);\n  }\n\n  async resolveNumberEvaluation(\n    flagKey: string,\n    defaultValue: number,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<number>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    const details = this.client.getNumberDetails(flagKey, mappedCtx);\n    return toResolutionDetails(details, defaultValue);\n  }\n\n  async resolveObjectEvaluation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context: EvaluationContext,\n    _logger: Logger,\n  ): Promise<ResolutionDetails<T>> {\n    const mappedCtx = mapContext(context, this.targetingKeyMapping);\n    // Try string_list first (returns string[]), fall back to JSON.\n    const listDetails = this.client.getStringListDetails(flagKey, mappedCtx);\n    if (\n      listDetails.reason === \"STATIC\" ||\n      listDetails.reason === \"TARGETING_MATCH\" ||\n      listDetails.reason === \"SPLIT\"\n    ) {\n      return toResolutionDetails(\n        listDetails as EvaluationDetails<unknown> as EvaluationDetails<T>,\n        defaultValue,\n      );\n    }\n    const jsonDetails = this.client.getJSONDetails(flagKey, mappedCtx);\n    return toResolutionDetails(jsonDetails as EvaluationDetails<T>, defaultValue);\n  }\n\n  /**\n   * Escape hatch: access the underlying @quonfig/node client for native-only features\n   * (shouldLog, keys, rawConfig, etc.)\n   */\n  getClient(): Quonfig {\n    return this.client;\n  }\n}\n\n/**\n * Translate a Quonfig EvaluationDetails<T> into an OpenFeature ResolutionDetails<T>.\n *\n * Reason mapping (from the brief):\n *   STATIC           → StandardResolutionReasons.STATIC\n *   TARGETING_MATCH  → StandardResolutionReasons.TARGETING_MATCH\n *   SPLIT            → StandardResolutionReasons.SPLIT\n *   DEFAULT          → defaultValue + StandardResolutionReasons.DEFAULT\n *   ERROR            → defaultValue + ERROR + errorCode (FLAG_NOT_FOUND / TYPE_MISMATCH / GENERAL)\n */\nfunction toResolutionDetails<T>(\n  details: EvaluationDetails<T>,\n  defaultValue: T,\n): ResolutionDetails<T> {\n  switch (details.reason) {\n    case \"STATIC\":\n      return { value: details.value as T, reason: StandardResolutionReasons.STATIC };\n    case \"TARGETING_MATCH\":\n      return {\n        value: details.value as T,\n        reason: StandardResolutionReasons.TARGETING_MATCH,\n      };\n    case \"SPLIT\":\n      return { value: details.value as T, reason: StandardResolutionReasons.SPLIT };\n    case \"DEFAULT\":\n      return { value: defaultValue, reason: StandardResolutionReasons.DEFAULT };\n    case \"ERROR\":\n      return {\n        value: defaultValue,\n        reason: StandardResolutionReasons.ERROR,\n        errorCode: toOFErrorCode(details.errorCode),\n      };\n  }\n}\n\nfunction toOFErrorCode(code: EvaluationDetails<unknown>[\"errorCode\"]): ErrorCode {\n  switch (code) {\n    case \"FLAG_NOT_FOUND\":\n      return ErrorCode.FLAG_NOT_FOUND;\n    case \"TYPE_MISMATCH\":\n      return ErrorCode.TYPE_MISMATCH;\n    case \"GENERAL\":\n    default:\n      return ErrorCode.GENERAL;\n  }\n}\n","import type { EvaluationContext } from \"@openfeature/server-sdk\";\nimport type { Contexts, ContextValue } from \"@quonfig/node\";\n\n/**\n * Maps an OpenFeature flat EvaluationContext to Quonfig's nested Contexts format.\n *\n * Rules:\n * - `targetingKey` maps to the namespace+property specified by `targetingKeyMapping` (default: \"user.id\")\n * - Keys with a dot are split on the first dot: \"user.email\" -> namespace \"user\", key \"email\"\n * - Keys without a dot go to the default (empty-string) namespace: \"country\" -> { \"\": { country: ... } }\n * - Multi-dot keys split on first dot only: \"user.ip.address\" -> { user: { \"ip.address\": ... } }\n */\nexport function mapContext(\n  ofContext: EvaluationContext,\n  targetingKeyMapping = \"user.id\",\n): Contexts {\n  const result: Record<string, Record<string, ContextValue>> = {};\n\n  for (const [key, value] of Object.entries(ofContext)) {\n    if (value === undefined) continue;\n\n    // Cast to ContextValue -- OpenFeature allows arbitrary nesting but Quonfig\n    // contexts accept primitives and string arrays. Callers should pass only\n    // primitive or string[] values for keys they want evaluated.\n    const ctxValue = value as ContextValue;\n\n    if (key === \"targetingKey\") {\n      const dotIdx = targetingKeyMapping.indexOf(\".\");\n      const ns = dotIdx === -1 ? \"\" : targetingKeyMapping.slice(0, dotIdx);\n      const prop = dotIdx === -1 ? targetingKeyMapping : targetingKeyMapping.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = ctxValue;\n      continue;\n    }\n\n    const dotIdx = key.indexOf(\".\");\n    if (dotIdx === -1) {\n      result[\"\"] ??= {};\n      result[\"\"][key] = ctxValue;\n    } else {\n      const ns = key.slice(0, dotIdx);\n      const prop = key.slice(dotIdx + 1);\n      result[ns] ??= {};\n      result[ns][prop] = ctxValue;\n    }\n  }\n\n  return result;\n}\n","import { ErrorCode } from \"@openfeature/server-sdk\";\n\n/**\n * Maps a native SDK error to an OpenFeature ErrorCode.\n *\n * The native SDK throws Error instances with message strings. We map by inspecting\n * the lowercased message.\n */\nexport function toErrorCode(err: unknown): ErrorCode {\n  const msg =\n    err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();\n\n  if (\n    msg.includes(\"not found\") ||\n    msg.includes(\"flag not found\") ||\n    msg.includes(\"no value found\") ||\n    msg.includes(\"value found for key\")\n  ) {\n    return ErrorCode.FLAG_NOT_FOUND;\n  }\n  if (msg.includes(\"type mismatch\")) {\n    return ErrorCode.TYPE_MISMATCH;\n  }\n  if (msg.includes(\"not initialized\") || msg.includes(\"provider not ready\")) {\n    return ErrorCode.PROVIDER_NOT_READY;\n  }\n  return ErrorCode.GENERAL;\n}\n"],"mappings":"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","names":["dotIdx","ErrorCode"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quonfig/openfeature-node",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "OpenFeature provider for Quonfig -- Node.js",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -22,11 +22,11 @@
     "prepublishOnly": "npm run build"
   },
   "peerDependencies": {
-    "@quonfig/node": ">=0.0.6",
+    "@quonfig/node": ">=0.0.18",
     "@openfeature/server-sdk": ">=1.0.0"
   },
   "devDependencies": {
-    "@quonfig/node": "^0.0.6",
+    "@quonfig/node": "^0.0.18",
     "@openfeature/server-sdk": "^1.7.0",
     "@types/node": "^20.11.0",
     "tsup": "^8.0.0",