@quonfig/node 0.0.3 → 0.0.4

package/dist/index.d.cts

@@ -102,6 +102,8 @@ interface QuonfigOptions {
     initTimeout?: number;
     datadir?: string;
     datafile?: string | object;
+    /** Environment name to use in datadir mode. Supersedes the QUONFIG_ENVIRONMENT env var. */
+    environment?: string;
 }
 interface EvalMatch {
     isMatch: boolean;
@@ -229,6 +231,7 @@ declare class Quonfig {
     private readonly initTimeout;
     private readonly datadir?;
     private readonly datafile?;
+    private readonly requestedEnvironment;
     private store;
     private evaluator;
     private resolver;

package/dist/index.d.ts

@@ -102,6 +102,8 @@ interface QuonfigOptions {
     initTimeout?: number;
     datadir?: string;
     datafile?: string | object;
+    /** Environment name to use in datadir mode. Supersedes the QUONFIG_ENVIRONMENT env var. */
+    environment?: string;
 }
 interface EvalMatch {
     isMatch: boolean;
@@ -229,6 +231,7 @@ declare class Quonfig {
     private readonly initTimeout;
     private readonly datadir?;
     private readonly datafile?;
+    private readonly requestedEnvironment;
     private store;
     private evaluator;
     private resolver;

package/dist/index.js

@@ -1039,8 +1039,8 @@ function shouldLog(args) {
 import { existsSync, readdirSync, readFileSync } from "fs";
 import { join } from "path";
 var CONFIG_SUBDIRS = ["configs", "feature-flags", "segments", "schemas", "log-levels"];
-function loadEnvelopeFromDatadir(datadir) {
-  const environmentId = loadEnvironmentId(join(datadir, "environments.json"));
+function loadEnvelopeFromDatadir(datadir, environment) {
+  const environmentId = resolveEnvironment(join(datadir, "environments.json"), environment);
   const configs = [];
   for (const subdir of CONFIG_SUBDIRS) {
     const dir = join(datadir, subdir);
@@ -1061,7 +1061,12 @@ function loadEnvelopeFromDatadir(datadir) {
     }
   };
 }
-function loadEnvironmentId(environmentsPath) {
+function resolveEnvironment(environmentsPath, environment) {
+  if (!environment) {
+    throw new Error(
+      "[quonfig] Environment required for datadir mode; set the `environment` option or QUONFIG_ENVIRONMENT env var"
+    );
+  }
   if (!existsSync(environmentsPath)) {
     throw new Error(`[quonfig] Datadir is missing environments.json: ${environmentsPath}`);
   }
@@ -1069,10 +1074,12 @@ function loadEnvironmentId(environmentsPath) {
   const candidates = normalizeEnvironmentCandidates(
     isWrappedEnvironmentList(environments) ? environments.environments : environments
   );
-  if (candidates.length === 0) {
-    return "";
+  if (candidates.length > 0 && !candidates.includes(environment)) {
+    throw new Error(
+      `[quonfig] Environment "${environment}" not found in workspace; available environments: ${candidates.join(", ")}`
+    );
   }
-  return candidates[0];
+  return environment;
 }
 function isWrappedEnvironmentList(value) {
   return Boolean(
@@ -1452,6 +1459,7 @@ var Quonfig = class {
   initTimeout;
   datadir;
   datafile;
+  requestedEnvironment;
   store;
   evaluator;
   resolver;
@@ -1482,6 +1490,7 @@ var Quonfig = class {
     this.initTimeout = options.initTimeout ?? DEFAULT_INIT_TIMEOUT;
     this.datadir = options.datadir;
     this.datafile = options.datafile;
+    this.requestedEnvironment = options.environment || process.env.QUONFIG_ENVIRONMENT || "";
     this.instanceHash = randomUUID();
     this.store = new ConfigStore();
     this.evaluator = new Evaluator(this.store);
@@ -1730,7 +1739,7 @@ var Quonfig = class {
   }
   loadLocalEnvelope() {
     if (this.datadir) {
-      return loadEnvelopeFromDatadir(this.datadir);
+      return loadEnvelopeFromDatadir(this.datadir, this.requestedEnvironment);
     }
     if (typeof this.datafile === "string") {
       const raw = readFileSync2(this.datafile, "utf-8");