@quonfig/node 0.0.2 → 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;
@@ -202,6 +204,7 @@ declare class BoundQuonfig {
         defaultLevel?: string;
         contexts?: Contexts;
     }): boolean;
+    flush(): Promise<void>;
     keys(): string[];
     inContext(contexts: Contexts): BoundQuonfig;
 }
@@ -228,6 +231,7 @@ declare class Quonfig {
     private readonly initTimeout;
     private readonly datadir?;
     private readonly datafile?;
+    private readonly requestedEnvironment;
     private store;
     private evaluator;
     private resolver;
@@ -303,6 +307,18 @@ declare class Quonfig {
      * Create a BoundQuonfig with the given context baked in.
      */
     inContext(contexts: Contexts): BoundQuonfig;
+    /**
+     * Flush pending telemetry data immediately. Useful in serverless environments
+     * (Vercel, Lambda) where the process may be frozen before the background
+     * timer fires.
+     *
+     * ```typescript
+     * const value = quonfig.get("my-flag", contexts);
+     * await quonfig.flush();
+     * return NextResponse.json({ value });
+     * ```
+     */
+    flush(): Promise<void>;
     /**
      * Close the SDK. Stops SSE, polling, and telemetry.
      */
@@ -674,7 +690,7 @@ declare class TelemetryReporter {
      */
     stop(): void;
     private scheduleNext;
-    private sync;
+    sync(): Promise<void>;
 }
 
 /**

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;
@@ -202,6 +204,7 @@ declare class BoundQuonfig {
         defaultLevel?: string;
         contexts?: Contexts;
     }): boolean;
+    flush(): Promise<void>;
     keys(): string[];
     inContext(contexts: Contexts): BoundQuonfig;
 }
@@ -228,6 +231,7 @@ declare class Quonfig {
     private readonly initTimeout;
     private readonly datadir?;
     private readonly datafile?;
+    private readonly requestedEnvironment;
     private store;
     private evaluator;
     private resolver;
@@ -303,6 +307,18 @@ declare class Quonfig {
      * Create a BoundQuonfig with the given context baked in.
      */
     inContext(contexts: Contexts): BoundQuonfig;
+    /**
+     * Flush pending telemetry data immediately. Useful in serverless environments
+     * (Vercel, Lambda) where the process may be frozen before the background
+     * timer fires.
+     *
+     * ```typescript
+     * const value = quonfig.get("my-flag", contexts);
+     * await quonfig.flush();
+     * return NextResponse.json({ value });
+     * ```
+     */
+    flush(): Promise<void>;
     /**
      * Close the SDK. Stops SSE, polling, and telemetry.
      */
@@ -674,7 +690,7 @@ declare class TelemetryReporter {
      */
     stop(): void;
     private scheduleNext;
-    private sync;
+    sync(): Promise<void>;
 }
 
 /**

package/dist/index.js

@@ -1022,7 +1022,10 @@ function shouldLog(args) {
   while (loggerNameWithPrefix.includes(".")) {
     const resolvedLevel = getConfig(loggerNameWithPrefix);
     if (resolvedLevel !== void 0) {
-      return Number(resolvedLevel) <= desiredLevel;
+      const resolvedLevelNum = parseLevel(resolvedLevel);
+      if (resolvedLevelNum !== void 0) {
+        return resolvedLevelNum <= desiredLevel;
+      }
     }
     loggerNameWithPrefix = loggerNameWithPrefix.slice(
       0,
@@ -1036,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);
@@ -1058,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}`);
   }
@@ -1066,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(
@@ -1426,6 +1436,9 @@ var BoundQuonfig = class _BoundQuonfig {
       contexts: mergeContexts(this.boundContexts, args.contexts)
     });
   }
+  async flush() {
+    return this.client.flush();
+  }
   keys() {
     return this.client.keys();
   }
@@ -1446,6 +1459,7 @@ var Quonfig = class {
   initTimeout;
   datadir;
   datafile;
+  requestedEnvironment;
   store;
   evaluator;
   resolver;
@@ -1476,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);
@@ -1664,6 +1679,22 @@ var Quonfig = class {
   inContext(contexts) {
     return new BoundQuonfig(this, mergeContexts(this.globalContext, contexts));
   }
+  /**
+   * Flush pending telemetry data immediately. Useful in serverless environments
+   * (Vercel, Lambda) where the process may be frozen before the background
+   * timer fires.
+   *
+   * ```typescript
+   * const value = quonfig.get("my-flag", contexts);
+   * await quonfig.flush();
+   * return NextResponse.json({ value });
+   * ```
+   */
+  async flush() {
+    if (this.telemetryReporter) {
+      await this.telemetryReporter.sync();
+    }
+  }
   /**
    * Close the SDK. Stops SSE, polling, and telemetry.
    */
@@ -1708,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");