@quonfig/node 0.0.1 → 0.0.3

package/dist/index.d.cts

@@ -56,6 +56,23 @@ interface ConfigEnvelope {
     configs: ConfigResponse[];
     meta: Meta;
 }
+interface WorkspaceEnvironment {
+    id: string;
+    rules: Rule[];
+}
+interface WorkspaceConfigDocument {
+    id?: string;
+    key: string;
+    type: ConfigTypeString;
+    valueType: ValueType;
+    sendToClientSdk?: boolean;
+    default?: RuleSet;
+    environments?: WorkspaceEnvironment[];
+}
+type QuonfigDatadirEnvironments = Record<string, string> | Array<string | {
+    id?: string;
+    name?: string;
+}>;
 type ContextValue = string | number | boolean | string[] | null | undefined;
 type Contexts = {
     [contextName: string]: {
@@ -67,7 +84,10 @@ type OnNoDefault = "error" | "warn" | "ignore";
 type ContextUploadMode = "none" | "shapes_only" | "periodic_example";
 interface QuonfigOptions {
     sdkKey: string;
+    /** @deprecated Use apiUrls instead. If provided, used as a single-element URL list. */
     apiUrl?: string;
+    /** Ordered list of API base URLs to try. Defaults to ["https://primary.quonfig.com", "https://secondary.quonfig.com"]. */
+    apiUrls?: string[];
     /** Base URL for the dedicated telemetry service. Defaults to https://telemetry.quonfig.com. Overridden by QUONFIG_TELEMETRY_URL env var. */
     telemetryUrl?: string;
     enableSSE?: boolean;
@@ -80,6 +100,7 @@ interface QuonfigOptions {
     collectLoggerCounts?: boolean;
     contextUploadMode?: ContextUploadMode;
     initTimeout?: number;
+    datadir?: string;
     datafile?: string | object;
 }
 interface EvalMatch {
@@ -181,6 +202,7 @@ declare class BoundQuonfig {
         defaultLevel?: string;
         contexts?: Contexts;
     }): boolean;
+    flush(): Promise<void>;
     keys(): string[];
     inContext(contexts: Contexts): BoundQuonfig;
 }
@@ -196,7 +218,7 @@ declare class BoundQuonfig {
  */
 declare class Quonfig {
     private readonly sdkKey;
-    private readonly apiUrl;
+    private readonly apiUrls;
     private readonly telemetryUrl?;
     private readonly enableSSE;
     private readonly enablePolling;
@@ -205,6 +227,7 @@ declare class Quonfig {
     private readonly onNoDefault;
     private readonly globalContext?;
     private readonly initTimeout;
+    private readonly datadir?;
     private readonly datafile?;
     private store;
     private evaluator;
@@ -221,7 +244,7 @@ declare class Quonfig {
     private exampleContexts;
     constructor(options: QuonfigOptions);
     /**
-     * Initialize the SDK. Downloads configs from the API (or loads from datafile)
+     * Initialize the SDK. Downloads configs from the API (or loads from datadir/datafile)
      * and starts background update mechanisms (SSE/polling).
      *
      * Must be called before using any get* methods.
@@ -281,13 +304,26 @@ 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.
      */
     close(): void;
     private requireInitialized;
     private handleNoDefault;
-    private loadDatafile;
+    private loadLocalData;
+    private loadLocalEnvelope;
     private fetchAndInstall;
     private startSSE;
     private startPolling;
@@ -466,11 +502,12 @@ interface FetchResult {
     notChanged: boolean;
 }
 declare class Transport {
-    private baseUrl;
+    private baseUrls;
+    private activeBaseUrl;
     private telemetryBaseUrl;
     private sdkKey;
     private etag;
-    constructor(baseUrl: string, sdkKey: string, telemetryBaseUrl?: string);
+    constructor(baseUrls: string[], sdkKey: string, telemetryBaseUrl?: string);
     /**
      * Build the Basic auth header value.
      * Uses username "1" like the Go SDK: base64("1:{sdkKey}")
@@ -483,6 +520,7 @@ declare class Transport {
     /**
      * Fetch configs from GET /api/v2/configs with ETag caching.
      *
+     * Tries each base URL in order. Returns the first successful result.
      * Returns `{ notChanged: true }` if the server responds with 304.
      */
     fetchConfigs(): Promise<FetchResult>;
@@ -492,6 +530,7 @@ declare class Transport {
     postTelemetry(data: any): Promise<void>;
     /**
      * Get the SSE URL for config streaming.
+     * Uses whichever base URL last succeeded for fetchConfigs.
      */
     getSSEUrl(): string;
     /**
@@ -648,7 +687,7 @@ declare class TelemetryReporter {
      */
     stop(): void;
     private scheduleNext;
-    private sync;
+    sync(): Promise<void>;
 }
 
 /**
@@ -752,4 +791,4 @@ declare const encryption: {
     generateNewHexKey: typeof generateNewHexKey;
 };
 
-export { BoundQuonfig, Client, type ClientOptions, type ConfigEnvelope, type ConfigResponse, ConfigStore, ConfigType, type ConfigTypeString, type ConfigValue, ConfigValueType, ContextShapeCollector, type ContextUploadMode, type ContextValue, type Contexts, type Criterion, type Environment, type EvalMatch, type Evaluation, EvaluationSummaryCollector, Evaluator, ExampleContextCollector, type GetValue, LOG_LEVEL_PREFIX, type LogLevelName, type LogLevelNumber, type Meta, type NodeServerConfigurationAccessor, type NodeServerConfigurationRaw, OP_ALWAYS_TRUE, OP_HIERARCHICAL_MATCH, OP_IN_INT_RANGE, OP_IN_SEG, OP_NOT_IN_SEG, OP_NOT_SET, OP_PROP_AFTER, OP_PROP_BEFORE, OP_PROP_CONTAINS_ONE_OF, OP_PROP_DOES_NOT_CONTAIN_ONE_OF, OP_PROP_DOES_NOT_END_WITH_ONE_OF, OP_PROP_DOES_NOT_MATCH, OP_PROP_DOES_NOT_START_WITH_ONE_OF, OP_PROP_ENDS_WITH_ONE_OF, OP_PROP_GREATER_THAN, OP_PROP_GREATER_THAN_OR_EQUAL, OP_PROP_IS_NOT_ONE_OF, OP_PROP_IS_ONE_OF, OP_PROP_LESS_THAN, OP_PROP_LESS_THAN_OR_EQUAL, OP_PROP_MATCHES, OP_PROP_SEMVER_EQUAL, OP_PROP_SEMVER_GREATER_THAN, OP_PROP_SEMVER_LESS_THAN, OP_PROP_STARTS_WITH_ONE_OF, type OnNoDefault, type ProjectEnvId, type ProvidedData, ProvidedSource, Quonfig, type QuonfigOptions, Resolver, type Rule, type RuleSet, type SchemaData, type SegmentResolver, type SemanticVersion, TelemetryReporter, Transport, type TypedNodeServerConfigurationAccessor, type TypedNodeServerConfigurationRaw, type Value, type ValueType, type WeightedValue, WeightedValueResolver, type WeightedValuesData, compareSemver, contextLookup, decrypt, durationToMilliseconds, encrypt, encryption, evaluateCriterion, generateNewHexKey, getContextValue, getProjectEnvFromSdkKey, hashZeroToOne, mergeContexts, parseLevel, parseSemver, shouldLog, valueTypeStringForConfig, wordLevelToNumber };
+export { BoundQuonfig, Client, type ClientOptions, type ConfigEnvelope, type ConfigResponse, ConfigStore, ConfigType, type ConfigTypeString, type ConfigValue, ConfigValueType, ContextShapeCollector, type ContextUploadMode, type ContextValue, type Contexts, type Criterion, type Environment, type EvalMatch, type Evaluation, EvaluationSummaryCollector, Evaluator, ExampleContextCollector, type GetValue, LOG_LEVEL_PREFIX, type LogLevelName, type LogLevelNumber, type Meta, type NodeServerConfigurationAccessor, type NodeServerConfigurationRaw, OP_ALWAYS_TRUE, OP_HIERARCHICAL_MATCH, OP_IN_INT_RANGE, OP_IN_SEG, OP_NOT_IN_SEG, OP_NOT_SET, OP_PROP_AFTER, OP_PROP_BEFORE, OP_PROP_CONTAINS_ONE_OF, OP_PROP_DOES_NOT_CONTAIN_ONE_OF, OP_PROP_DOES_NOT_END_WITH_ONE_OF, OP_PROP_DOES_NOT_MATCH, OP_PROP_DOES_NOT_START_WITH_ONE_OF, OP_PROP_ENDS_WITH_ONE_OF, OP_PROP_GREATER_THAN, OP_PROP_GREATER_THAN_OR_EQUAL, OP_PROP_IS_NOT_ONE_OF, OP_PROP_IS_ONE_OF, OP_PROP_LESS_THAN, OP_PROP_LESS_THAN_OR_EQUAL, OP_PROP_MATCHES, OP_PROP_SEMVER_EQUAL, OP_PROP_SEMVER_GREATER_THAN, OP_PROP_SEMVER_LESS_THAN, OP_PROP_STARTS_WITH_ONE_OF, type OnNoDefault, type ProjectEnvId, type ProvidedData, ProvidedSource, Quonfig, type QuonfigDatadirEnvironments, type QuonfigOptions, Resolver, type Rule, type RuleSet, type SchemaData, type SegmentResolver, type SemanticVersion, TelemetryReporter, Transport, type TypedNodeServerConfigurationAccessor, type TypedNodeServerConfigurationRaw, type Value, type ValueType, type WeightedValue, WeightedValueResolver, type WeightedValuesData, type WorkspaceConfigDocument, type WorkspaceEnvironment, compareSemver, contextLookup, decrypt, durationToMilliseconds, encrypt, encryption, evaluateCriterion, generateNewHexKey, getContextValue, getProjectEnvFromSdkKey, hashZeroToOne, mergeContexts, parseLevel, parseSemver, shouldLog, valueTypeStringForConfig, wordLevelToNumber };

package/dist/index.d.ts

@@ -56,6 +56,23 @@ interface ConfigEnvelope {
     configs: ConfigResponse[];
     meta: Meta;
 }
+interface WorkspaceEnvironment {
+    id: string;
+    rules: Rule[];
+}
+interface WorkspaceConfigDocument {
+    id?: string;
+    key: string;
+    type: ConfigTypeString;
+    valueType: ValueType;
+    sendToClientSdk?: boolean;
+    default?: RuleSet;
+    environments?: WorkspaceEnvironment[];
+}
+type QuonfigDatadirEnvironments = Record<string, string> | Array<string | {
+    id?: string;
+    name?: string;
+}>;
 type ContextValue = string | number | boolean | string[] | null | undefined;
 type Contexts = {
     [contextName: string]: {
@@ -67,7 +84,10 @@ type OnNoDefault = "error" | "warn" | "ignore";
 type ContextUploadMode = "none" | "shapes_only" | "periodic_example";
 interface QuonfigOptions {
     sdkKey: string;
+    /** @deprecated Use apiUrls instead. If provided, used as a single-element URL list. */
     apiUrl?: string;
+    /** Ordered list of API base URLs to try. Defaults to ["https://primary.quonfig.com", "https://secondary.quonfig.com"]. */
+    apiUrls?: string[];
     /** Base URL for the dedicated telemetry service. Defaults to https://telemetry.quonfig.com. Overridden by QUONFIG_TELEMETRY_URL env var. */
     telemetryUrl?: string;
     enableSSE?: boolean;
@@ -80,6 +100,7 @@ interface QuonfigOptions {
     collectLoggerCounts?: boolean;
     contextUploadMode?: ContextUploadMode;
     initTimeout?: number;
+    datadir?: string;
     datafile?: string | object;
 }
 interface EvalMatch {
@@ -181,6 +202,7 @@ declare class BoundQuonfig {
         defaultLevel?: string;
         contexts?: Contexts;
     }): boolean;
+    flush(): Promise<void>;
     keys(): string[];
     inContext(contexts: Contexts): BoundQuonfig;
 }
@@ -196,7 +218,7 @@ declare class BoundQuonfig {
  */
 declare class Quonfig {
     private readonly sdkKey;
-    private readonly apiUrl;
+    private readonly apiUrls;
     private readonly telemetryUrl?;
     private readonly enableSSE;
     private readonly enablePolling;
@@ -205,6 +227,7 @@ declare class Quonfig {
     private readonly onNoDefault;
     private readonly globalContext?;
     private readonly initTimeout;
+    private readonly datadir?;
     private readonly datafile?;
     private store;
     private evaluator;
@@ -221,7 +244,7 @@ declare class Quonfig {
     private exampleContexts;
     constructor(options: QuonfigOptions);
     /**
-     * Initialize the SDK. Downloads configs from the API (or loads from datafile)
+     * Initialize the SDK. Downloads configs from the API (or loads from datadir/datafile)
      * and starts background update mechanisms (SSE/polling).
      *
      * Must be called before using any get* methods.
@@ -281,13 +304,26 @@ 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.
      */
     close(): void;
     private requireInitialized;
     private handleNoDefault;
-    private loadDatafile;
+    private loadLocalData;
+    private loadLocalEnvelope;
     private fetchAndInstall;
     private startSSE;
     private startPolling;
@@ -466,11 +502,12 @@ interface FetchResult {
     notChanged: boolean;
 }
 declare class Transport {
-    private baseUrl;
+    private baseUrls;
+    private activeBaseUrl;
     private telemetryBaseUrl;
     private sdkKey;
     private etag;
-    constructor(baseUrl: string, sdkKey: string, telemetryBaseUrl?: string);
+    constructor(baseUrls: string[], sdkKey: string, telemetryBaseUrl?: string);
     /**
      * Build the Basic auth header value.
      * Uses username "1" like the Go SDK: base64("1:{sdkKey}")
@@ -483,6 +520,7 @@ declare class Transport {
     /**
      * Fetch configs from GET /api/v2/configs with ETag caching.
      *
+     * Tries each base URL in order. Returns the first successful result.
      * Returns `{ notChanged: true }` if the server responds with 304.
      */
     fetchConfigs(): Promise<FetchResult>;
@@ -492,6 +530,7 @@ declare class Transport {
     postTelemetry(data: any): Promise<void>;
     /**
      * Get the SSE URL for config streaming.
+     * Uses whichever base URL last succeeded for fetchConfigs.
      */
     getSSEUrl(): string;
     /**
@@ -648,7 +687,7 @@ declare class TelemetryReporter {
      */
     stop(): void;
     private scheduleNext;
-    private sync;
+    sync(): Promise<void>;
 }
 
 /**
@@ -752,4 +791,4 @@ declare const encryption: {
     generateNewHexKey: typeof generateNewHexKey;
 };
 
-export { BoundQuonfig, Client, type ClientOptions, type ConfigEnvelope, type ConfigResponse, ConfigStore, ConfigType, type ConfigTypeString, type ConfigValue, ConfigValueType, ContextShapeCollector, type ContextUploadMode, type ContextValue, type Contexts, type Criterion, type Environment, type EvalMatch, type Evaluation, EvaluationSummaryCollector, Evaluator, ExampleContextCollector, type GetValue, LOG_LEVEL_PREFIX, type LogLevelName, type LogLevelNumber, type Meta, type NodeServerConfigurationAccessor, type NodeServerConfigurationRaw, OP_ALWAYS_TRUE, OP_HIERARCHICAL_MATCH, OP_IN_INT_RANGE, OP_IN_SEG, OP_NOT_IN_SEG, OP_NOT_SET, OP_PROP_AFTER, OP_PROP_BEFORE, OP_PROP_CONTAINS_ONE_OF, OP_PROP_DOES_NOT_CONTAIN_ONE_OF, OP_PROP_DOES_NOT_END_WITH_ONE_OF, OP_PROP_DOES_NOT_MATCH, OP_PROP_DOES_NOT_START_WITH_ONE_OF, OP_PROP_ENDS_WITH_ONE_OF, OP_PROP_GREATER_THAN, OP_PROP_GREATER_THAN_OR_EQUAL, OP_PROP_IS_NOT_ONE_OF, OP_PROP_IS_ONE_OF, OP_PROP_LESS_THAN, OP_PROP_LESS_THAN_OR_EQUAL, OP_PROP_MATCHES, OP_PROP_SEMVER_EQUAL, OP_PROP_SEMVER_GREATER_THAN, OP_PROP_SEMVER_LESS_THAN, OP_PROP_STARTS_WITH_ONE_OF, type OnNoDefault, type ProjectEnvId, type ProvidedData, ProvidedSource, Quonfig, type QuonfigOptions, Resolver, type Rule, type RuleSet, type SchemaData, type SegmentResolver, type SemanticVersion, TelemetryReporter, Transport, type TypedNodeServerConfigurationAccessor, type TypedNodeServerConfigurationRaw, type Value, type ValueType, type WeightedValue, WeightedValueResolver, type WeightedValuesData, compareSemver, contextLookup, decrypt, durationToMilliseconds, encrypt, encryption, evaluateCriterion, generateNewHexKey, getContextValue, getProjectEnvFromSdkKey, hashZeroToOne, mergeContexts, parseLevel, parseSemver, shouldLog, valueTypeStringForConfig, wordLevelToNumber };
+export { BoundQuonfig, Client, type ClientOptions, type ConfigEnvelope, type ConfigResponse, ConfigStore, ConfigType, type ConfigTypeString, type ConfigValue, ConfigValueType, ContextShapeCollector, type ContextUploadMode, type ContextValue, type Contexts, type Criterion, type Environment, type EvalMatch, type Evaluation, EvaluationSummaryCollector, Evaluator, ExampleContextCollector, type GetValue, LOG_LEVEL_PREFIX, type LogLevelName, type LogLevelNumber, type Meta, type NodeServerConfigurationAccessor, type NodeServerConfigurationRaw, OP_ALWAYS_TRUE, OP_HIERARCHICAL_MATCH, OP_IN_INT_RANGE, OP_IN_SEG, OP_NOT_IN_SEG, OP_NOT_SET, OP_PROP_AFTER, OP_PROP_BEFORE, OP_PROP_CONTAINS_ONE_OF, OP_PROP_DOES_NOT_CONTAIN_ONE_OF, OP_PROP_DOES_NOT_END_WITH_ONE_OF, OP_PROP_DOES_NOT_MATCH, OP_PROP_DOES_NOT_START_WITH_ONE_OF, OP_PROP_ENDS_WITH_ONE_OF, OP_PROP_GREATER_THAN, OP_PROP_GREATER_THAN_OR_EQUAL, OP_PROP_IS_NOT_ONE_OF, OP_PROP_IS_ONE_OF, OP_PROP_LESS_THAN, OP_PROP_LESS_THAN_OR_EQUAL, OP_PROP_MATCHES, OP_PROP_SEMVER_EQUAL, OP_PROP_SEMVER_GREATER_THAN, OP_PROP_SEMVER_LESS_THAN, OP_PROP_STARTS_WITH_ONE_OF, type OnNoDefault, type ProjectEnvId, type ProvidedData, ProvidedSource, Quonfig, type QuonfigDatadirEnvironments, type QuonfigOptions, Resolver, type Rule, type RuleSet, type SchemaData, type SegmentResolver, type SemanticVersion, TelemetryReporter, Transport, type TypedNodeServerConfigurationAccessor, type TypedNodeServerConfigurationRaw, type Value, type ValueType, type WeightedValue, WeightedValueResolver, type WeightedValuesData, type WorkspaceConfigDocument, type WorkspaceEnvironment, compareSemver, contextLookup, decrypt, durationToMilliseconds, encrypt, encryption, evaluateCriterion, generateNewHexKey, getContextValue, getProjectEnvFromSdkKey, hashZeroToOne, mergeContexts, parseLevel, parseSemver, shouldLog, valueTypeStringForConfig, wordLevelToNumber };

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/quonfig.ts
 import { randomUUID } from "crypto";
-import { readFileSync } from "fs";
+import { readFileSync as readFileSync2 } from "fs";
 
 // src/store.ts
 var ConfigStore = class {
@@ -825,12 +825,14 @@ function valueTypeForCoerced(valueType) {
 var SDK_VERSION = "0.1.0";
 var DEFAULT_TELEMETRY_URL = "https://telemetry.quonfig.com";
 var Transport = class {
-  baseUrl;
+  baseUrls;
+  activeBaseUrl;
   telemetryBaseUrl;
   sdkKey;
   etag = "";
-  constructor(baseUrl, sdkKey, telemetryBaseUrl) {
-    this.baseUrl = baseUrl.replace(/\/$/, "");
+  constructor(baseUrls, sdkKey, telemetryBaseUrl) {
+    this.baseUrls = baseUrls.map((u) => u.replace(/\/$/, ""));
+    this.activeBaseUrl = this.baseUrls[0];
     const envUrl = process.env.QUONFIG_TELEMETRY_URL;
     const url = envUrl || telemetryBaseUrl || DEFAULT_TELEMETRY_URL;
     this.telemetryBaseUrl = url.replace(/\/$/, "");
@@ -857,30 +859,41 @@ var Transport = class {
   /**
    * Fetch configs from GET /api/v2/configs with ETag caching.
    *
+   * Tries each base URL in order. Returns the first successful result.
    * Returns `{ notChanged: true }` if the server responds with 304.
    */
   async fetchConfigs() {
-    const headers = this.getHeaders();
-    if (this.etag) {
-      headers["If-None-Match"] = this.etag;
-    }
-    const response = await fetch(`${this.baseUrl}/api/v2/configs`, {
-      method: "GET",
-      headers
-    });
-    if (response.status === 304) {
-      return { notChanged: true };
-    }
-    if (!response.ok) {
-      const body = await response.text().catch(() => "");
-      throw new Error(`Unexpected status ${response.status}: ${body}`);
-    }
-    const etag = response.headers.get("ETag");
-    if (etag) {
-      this.etag = etag;
+    let lastError;
+    for (const baseUrl of this.baseUrls) {
+      try {
+        const headers = this.getHeaders();
+        if (this.etag) {
+          headers["If-None-Match"] = this.etag;
+        }
+        const response = await fetch(`${baseUrl}/api/v2/configs`, {
+          method: "GET",
+          headers
+        });
+        if (response.status === 304) {
+          this.activeBaseUrl = baseUrl;
+          return { notChanged: true };
+        }
+        if (!response.ok) {
+          const body = await response.text().catch(() => "");
+          throw new Error(`Unexpected status ${response.status} from ${baseUrl}: ${body}`);
+        }
+        const etag = response.headers.get("ETag");
+        if (etag) {
+          this.etag = etag;
+        }
+        this.activeBaseUrl = baseUrl;
+        const envelope = await response.json();
+        return { envelope, notChanged: false };
+      } catch (err) {
+        lastError = err instanceof Error ? err : new Error(String(err));
+      }
     }
-    const envelope = await response.json();
-    return { envelope, notChanged: false };
+    throw lastError ?? new Error("All API URLs failed");
   }
   /**
    * Post telemetry data to the telemetry endpoint.
@@ -901,9 +914,10 @@ var Transport = class {
   }
   /**
    * Get the SSE URL for config streaming.
+   * Uses whichever base URL last succeeded for fetchConfigs.
    */
   getSSEUrl() {
-    return `${this.baseUrl}/api/v2/sse/config`;
+    return `${this.activeBaseUrl}/api/v2/sse/config`;
   }
   /**
    * Get auth headers for SSE connection.
@@ -1008,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,
@@ -1018,6 +1035,87 @@ function shouldLog(args) {
   return defaultLevel <= desiredLevel;
 }
 
+// src/datadir.ts
+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"));
+  const configs = [];
+  for (const subdir of CONFIG_SUBDIRS) {
+    const dir = join(datadir, subdir);
+    if (!existsSync(dir)) {
+      continue;
+    }
+    const filenames = readdirSync(dir).filter((filename) => filename.endsWith(".json")).sort((a, b) => a.localeCompare(b));
+    for (const filename of filenames) {
+      const raw = JSON.parse(readFileSync(join(dir, filename), "utf-8"));
+      configs.push(toConfigResponse(raw, environmentId));
+    }
+  }
+  return {
+    configs,
+    meta: {
+      version: `datadir:${datadir}`,
+      environment: environmentId
+    }
+  };
+}
+function loadEnvironmentId(environmentsPath) {
+  if (!existsSync(environmentsPath)) {
+    throw new Error(`[quonfig] Datadir is missing environments.json: ${environmentsPath}`);
+  }
+  const environments = JSON.parse(readFileSync(environmentsPath, "utf-8"));
+  const candidates = normalizeEnvironmentCandidates(
+    isWrappedEnvironmentList(environments) ? environments.environments : environments
+  );
+  if (candidates.length === 0) {
+    return "";
+  }
+  return candidates[0];
+}
+function isWrappedEnvironmentList(value) {
+  return Boolean(
+    value && typeof value === "object" && !Array.isArray(value) && "environments" in value
+  );
+}
+function normalizeEnvironmentCandidates(environments) {
+  if (!environments) {
+    return [];
+  }
+  if (Array.isArray(environments)) {
+    return environments.map((entry) => {
+      if (typeof entry === "string") {
+        return entry;
+      }
+      if (entry && typeof entry === "object") {
+        return entry.id ?? entry.name;
+      }
+      return void 0;
+    }).filter((entry) => typeof entry === "string" && entry.length > 0);
+  }
+  if (environments && typeof environments === "object") {
+    const values = Object.values(environments).map((value) => typeof value === "string" && value.length > 0 ? value : void 0).filter((value) => typeof value === "string");
+    if (values.length > 0) {
+      return values;
+    }
+    return Object.keys(environments).filter((key) => key.length > 0);
+  }
+  return [];
+}
+function toConfigResponse(raw, environmentId) {
+  const environment = raw.environments?.find((candidate) => candidate.id === environmentId);
+  return {
+    id: raw.id ?? "",
+    key: raw.key,
+    type: raw.type,
+    valueType: raw.valueType,
+    sendToClientSdk: raw.sendToClientSdk ?? false,
+    default: raw.default ?? { rules: [] },
+    environment
+  };
+}
+
 // src/telemetry/evaluationSummaries.ts
 var EvaluationSummaryCollector = class {
   enabled;
@@ -1287,7 +1385,10 @@ var TelemetryReporter = class {
 };
 
 // src/quonfig.ts
-var DEFAULT_API_URL = "https://api.quonfig.com";
+var DEFAULT_API_URLS = [
+  "https://primary.quonfig.com",
+  "https://secondary.quonfig.com"
+];
 var DEFAULT_POLL_INTERVAL = 6e4;
 var DEFAULT_INIT_TIMEOUT = 1e4;
 var DEFAULT_LOG_LEVEL = 5;
@@ -1328,6 +1429,9 @@ var BoundQuonfig = class _BoundQuonfig {
       contexts: mergeContexts(this.boundContexts, args.contexts)
     });
   }
+  async flush() {
+    return this.client.flush();
+  }
   keys() {
     return this.client.keys();
   }
@@ -1337,7 +1441,7 @@ var BoundQuonfig = class _BoundQuonfig {
 };
 var Quonfig = class {
   sdkKey;
-  apiUrl;
+  apiUrls;
   telemetryUrl;
   enableSSE;
   enablePolling;
@@ -1346,6 +1450,7 @@ var Quonfig = class {
   onNoDefault;
   globalContext;
   initTimeout;
+  datadir;
   datafile;
   store;
   evaluator;
@@ -1363,7 +1468,10 @@ var Quonfig = class {
   exampleContexts;
   constructor(options) {
     this.sdkKey = options.sdkKey;
-    this.apiUrl = (options.apiUrl ?? DEFAULT_API_URL).replace(/\/$/, "");
+    this.apiUrls = options.apiUrls ?? (options.apiUrl ? [options.apiUrl] : DEFAULT_API_URLS);
+    if (this.apiUrls.length === 0) {
+      throw new Error("[quonfig] apiUrls must not be empty");
+    }
     this.telemetryUrl = options.telemetryUrl;
     this.enableSSE = options.enableSSE ?? true;
     this.enablePolling = options.enablePolling ?? false;
@@ -1372,12 +1480,13 @@ var Quonfig = class {
     this.onNoDefault = options.onNoDefault ?? "error";
     this.globalContext = options.globalContext;
     this.initTimeout = options.initTimeout ?? DEFAULT_INIT_TIMEOUT;
+    this.datadir = options.datadir;
     this.datafile = options.datafile;
     this.instanceHash = randomUUID();
     this.store = new ConfigStore();
     this.evaluator = new Evaluator(this.store);
     this.resolver = new Resolver(this.store, this.evaluator);
-    this.transport = new Transport(this.apiUrl, this.sdkKey, this.telemetryUrl);
+    this.transport = new Transport(this.apiUrls, this.sdkKey, this.telemetryUrl);
     const contextUploadMode = options.contextUploadMode ?? "periodic_example";
     this.evaluationSummaries = new EvaluationSummaryCollector(
       options.collectEvaluationSummaries ?? true
@@ -1386,14 +1495,14 @@ var Quonfig = class {
     this.exampleContexts = new ExampleContextCollector(contextUploadMode);
   }
   /**
-   * Initialize the SDK. Downloads configs from the API (or loads from datafile)
+   * Initialize the SDK. Downloads configs from the API (or loads from datadir/datafile)
    * and starts background update mechanisms (SSE/polling).
    *
    * Must be called before using any get* methods.
    */
   async init() {
-    if (this.datafile) {
-      this.loadDatafile();
+    if (this.datadir || this.datafile) {
+      this.loadLocalData();
       this.initialized = true;
       return;
     }
@@ -1561,6 +1670,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.
    */
@@ -1598,19 +1723,24 @@ var Quonfig = class {
         return void 0;
     }
   }
-  loadDatafile() {
-    let data;
-    if (typeof this.datafile === "string") {
-      const raw = readFileSync(this.datafile, "utf-8");
-      data = JSON.parse(raw);
-    } else if (typeof this.datafile === "object") {
-      data = this.datafile;
-    } else {
-      throw new Error("Invalid datafile option");
-    }
+  loadLocalData() {
+    const data = this.loadLocalEnvelope();
     this.store.update(data);
     this.environmentId = data.meta.environment;
   }
+  loadLocalEnvelope() {
+    if (this.datadir) {
+      return loadEnvelopeFromDatadir(this.datadir);
+    }
+    if (typeof this.datafile === "string") {
+      const raw = readFileSync2(this.datafile, "utf-8");
+      return JSON.parse(raw);
+    }
+    if (typeof this.datafile === "object") {
+      return this.datafile;
+    }
+    throw new Error("Invalid local configuration: expected datadir or datafile");
+  }
   async fetchAndInstall() {
     const result = await this.transport.fetchConfigs();
     if (result.notChanged) {
@@ -1704,11 +1834,28 @@ var Client = class {
   }
   async post(path, payload) {
     const url = `${this.apiUrl}${path}`;
+    const isORPC = path.startsWith("/api/v1/");
     this.log("ApiClient", `POST ${url}`);
-    return fetch(url, {
+    const body = isORPC ? JSON.stringify({ json: payload }) : JSON.stringify(payload);
+    const raw = await fetch(url, {
       method: "POST",
       headers: this.headers(),
-      body: JSON.stringify(payload)
+      body
+    });
+    if (!isORPC) return raw;
+    const text = await raw.text();
+    let unwrapped = text;
+    try {
+      const parsed = JSON.parse(text);
+      if (parsed && typeof parsed === "object" && "json" in parsed) {
+        unwrapped = JSON.stringify(parsed.json);
+      }
+    } catch {
+    }
+    return new Response(unwrapped, {
+      status: raw.status,
+      statusText: raw.statusText,
+      headers: raw.headers
     });
   }
   async put(path, payload) {