@barekey/sdk 0.2.0 → 0.3.0

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { BarekeyEnvHandle } from "./handle.js";
-import type { BarekeyClientOptions, BarekeyGeneratedTypeMap, BarekeyGetOptions, BarekeyJsonConfig, BarekeyKey, BarekeyKnownKey, BarekeyTypegenResult } from "./types.js";
+import { BarekeyEnvBatchHandle, BarekeyEnvHandle } from "./handle.js";
+import type { BarekeyClientOptions, BarekeyGeneratedValueForKey, BarekeyGeneratedValuesForKeys, BarekeyGetOptions, BarekeyJsonConfig, BarekeyKey, BarekeyTypegenResult } from "./types.js";
 export declare class BarekeyClient {
     private readonly options;
     private readonly fetchFn;
@@ -21,7 +21,8 @@ export declare class BarekeyClient {
         requirements?: BarekeyClientOptions["requirements"];
         typegen?: BarekeyClientOptions["typegen"];
     });
-    get<TKey extends BarekeyKey>(name: TKey, options?: BarekeyGetOptions): BarekeyEnvHandle<TKey extends BarekeyKnownKey ? BarekeyGeneratedTypeMap[TKey] : unknown>;
+    get<TKey extends BarekeyKey>(name: TKey, options?: BarekeyGetOptions): BarekeyEnvHandle<BarekeyGeneratedValueForKey<TKey>>;
+    get<const TKeys extends readonly BarekeyKey[]>(names: TKeys, options?: BarekeyGetOptions): BarekeyEnvBatchHandle<BarekeyGeneratedValuesForKeys<TKeys>>;
     typegen(): Promise<BarekeyTypegenResult>;
     private getRuntimeContext;
     private fetchTypegenManifest;
@@ -32,9 +33,14 @@ export declare class BarekeyClient {
     private buildEvaluationCacheKey;
     private fetchDefinitions;
     private ensureRequirementsValidated;
+    private getStaticDefinitions;
     private getStaticDefinition;
     private resolveStaticValue;
+    private resolveStaticValues;
+    private fetchDynamicValues;
     private resolveDynamicValue;
+    private resolveDynamicValues;
     private resolveEvaluatedValue;
+    private resolveEvaluatedValues;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAkB/C,OAAO,KAAK,EACV,oBAAoB,EAEpB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAiDpB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgD;IAChF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;IAC5E,OAAO,CAAC,qBAAqB,CAA+C;IAC5E,OAAO,CAAC,mBAAmB,CAA8B;IACzD,OAAO,CAAC,qBAAqB,CAAS;;gBAG1B,OAAO,EAAE;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAC;QACpD,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;KAC3C;gBACW,OAAO,EAAE;QACnB,IAAI,EAAE,iBAAiB,CAAC;QACxB,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAC;QACpD,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;KAC3C;IAMD,GAAG,CAAC,IAAI,SAAS,UAAU,EACzB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,iBAAiB,GAC1B,gBAAgB,CAAC,IAAI,SAAS,eAAe,GAAG,uBAAuB,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IAOrF,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;YAkBhC,iBAAiB;YAajB,oBAAoB;IAclC,OAAO,CAAC,oBAAoB;YAWd,mBAAmB;IA6EjC,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,uBAAuB;YAejB,gBAAgB;YAsBhB,2BAA2B;YA4B3B,mBAAmB;YAiBnB,kBAAkB;YAQlB,mBAAmB;YAkEnB,qBAAqB;CAYpC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAmBtE,OAAO,KAAK,EACV,oBAAoB,EAEpB,2BAA2B,EAC3B,6BAA6B,EAC7B,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAqFpB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgD;IAChF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;IAC5E,OAAO,CAAC,qBAAqB,CAA+C;IAC5E,OAAO,CAAC,mBAAmB,CAA8B;IACzD,OAAO,CAAC,qBAAqB,CAAS;;gBAG1B,OAAO,EAAE;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAC;QACpD,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;KAC3C;gBACW,OAAO,EAAE;QACnB,IAAI,EAAE,iBAAiB,CAAC;QACxB,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAC;QACpD,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;KAC3C;IAaD,GAAG,CAAC,IAAI,SAAS,UAAU,EACzB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,iBAAiB,GAC1B,gBAAgB,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;IACtD,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,SAAS,UAAU,EAAE,EAC3C,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,iBAAiB,GAC1B,qBAAqB,CAAC,6BAA6B,CAAC,KAAK,CAAC,CAAC;IAgBxD,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;YAkBhC,iBAAiB;YAajB,oBAAoB;IAclC,OAAO,CAAC,oBAAoB;YAWd,mBAAmB;IA6EjC,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,uBAAuB;YAejB,gBAAgB;YA0BhB,2BAA2B;YA4B3B,oBAAoB;YAkCpB,mBAAmB;YASnB,kBAAkB;YAQlB,mBAAmB;YAUnB,kBAAkB;YAwDlB,mBAAmB;YAkCnB,oBAAoB;YAuCpB,qBAAqB;YAarB,sBAAsB;CAsBrC"}

package/dist/client.js

@@ -1,13 +1,15 @@
 import { BillingUnavailableError, FsNotAvailableError, NetworkError, VariableNotFoundError, } from "./errors.js";
-import { BarekeyEnvHandle } from "./handle.js";
+import { BarekeyEnvBatchHandle, BarekeyEnvHandle } from "./handle.js";
 import { evaluateDefinition, inferSelectedArmFromDecision, parseDeclaredValue, validateDynamicOptions, } from "./internal/evaluate.js";
 import { getJson, postJson } from "./internal/http.js";
 import { validateRequirements } from "./internal/requirements.js";
 import { resolveRuntimeContext } from "./internal/runtime.js";
+import { createBarekeyClientSingletonKey } from "./internal/singleton.js";
 import { MemoryCache } from "./internal/cache.js";
 import { DEFAULT_TYPEGEN_TTL_MS, resolveTtlMilliseconds } from "./internal/ttl.js";
 import { hasFreshInstalledSdkTypegen, resolveInstalledSdkGeneratedTypesPath, writeInstalledSdkGeneratedTypes, } from "./internal/typegen.js";
 const sharedTypegenWatchers = new Map();
+const sharedClients = new Map();
 function createDefaultFetch() {
     if (typeof globalThis.fetch === "function") {
         return globalThis.fetch.bind(globalThis);
@@ -29,6 +31,30 @@ function warnAutomaticTypegenFailure(error) {
     const message = error instanceof Error ? error.message : "Barekey automatic typegen refresh failed.";
     console.warn(`[barekey] Automatic typegen refresh failed.\n${message}`);
 }
+function uniqueNames(names) {
+    return [...new Set(names)];
+}
+function mapValuesToRequestedOrder(names, values) {
+    const byName = new Map(values.map((value) => [value.name, value]));
+    return names.map((name) => {
+        const resolved = byName.get(name);
+        if (resolved === undefined) {
+            throw new VariableNotFoundError();
+        }
+        return resolved;
+    });
+}
+function resolveEvaluatedResponse(evaluated) {
+    return {
+        name: evaluated.name,
+        kind: evaluated.kind,
+        declaredType: evaluated.declaredType,
+        visibility: evaluated.visibility,
+        value: evaluated.value,
+        decision: evaluated.decision,
+        selectedArm: inferSelectedArmFromDecision(evaluated.decision),
+    };
+}
 export class BarekeyClient {
     options;
     fetchFn;
@@ -38,11 +64,20 @@ export class BarekeyClient {
     requirementsPromise = null;
     typegenWatcherStarted = false;
     constructor(options = {}) {
+        const singletonKey = createBarekeyClientSingletonKey(options);
+        const existing = sharedClients.get(singletonKey);
+        if (existing !== undefined) {
+            return existing;
+        }
         this.options = options;
         this.fetchFn = createDefaultFetch();
+        sharedClients.set(singletonKey, this);
     }
-    get(name, options) {
-        return new BarekeyEnvHandle(async () => await this.resolveEvaluatedValue(name, options));
+    get(nameOrNames, options) {
+        if (Array.isArray(nameOrNames)) {
+            return new BarekeyEnvBatchHandle(async () => await this.resolveEvaluatedValues(nameOrNames, options));
+        }
+        return new BarekeyEnvHandle(async () => await this.resolveEvaluatedValue(nameOrNames, options));
     }
     async typegen() {
         const context = await this.getRuntimeContext();
@@ -183,6 +218,9 @@ export class BarekeyClient {
         ].join("|");
     }
     async fetchDefinitions(names) {
+        if (names !== undefined && names.length === 0) {
+            return [];
+        }
         const context = await this.getRuntimeContext();
         const response = await postJson({
             fetchFn: this.fetchFn,
@@ -226,15 +264,35 @@ export class BarekeyClient {
         }
         await this.requirementsPromise;
     }
-    async getStaticDefinition(name) {
+    async getStaticDefinitions(names) {
         await this.ensureRequirementsValidated();
         const context = await this.getRuntimeContext();
-        const cacheKey = this.buildDefinitionCacheKey(context, name);
-        const cached = this.definitionCache.get(cacheKey);
-        if (cached !== null) {
-            return cached;
+        const cachedDefinitions = new Map();
+        const missingNames = [];
+        for (const name of uniqueNames(names)) {
+            const cacheKey = this.buildDefinitionCacheKey(context, name);
+            const cached = this.definitionCache.get(cacheKey);
+            if (cached !== null) {
+                cachedDefinitions.set(name, cached);
+                continue;
+            }
+            missingNames.push(name);
+        }
+        if (missingNames.length > 0) {
+            for (const definition of await this.fetchDefinitions(missingNames)) {
+                cachedDefinitions.set(definition.name, definition);
+            }
         }
-        const definitions = await this.fetchDefinitions([name]);
+        return names.map((name) => {
+            const resolved = cachedDefinitions.get(name);
+            if (resolved === undefined) {
+                throw new VariableNotFoundError();
+            }
+            return resolved;
+        });
+    }
+    async getStaticDefinition(name) {
+        const definitions = await this.getStaticDefinitions([name]);
         const resolved = definitions[0];
         if (resolved === undefined) {
             throw new VariableNotFoundError();
@@ -245,55 +303,71 @@ export class BarekeyClient {
         const definition = await this.getStaticDefinition(name);
         return await evaluateDefinition(definition, options);
     }
-    async resolveDynamicValue(name, options) {
-        await this.ensureRequirementsValidated();
-        const context = await this.getRuntimeContext();
-        const cacheKey = this.buildEvaluationCacheKey(context, name, options);
-        const dynamic = options?.dynamic;
-        const dynamicTtlMs = dynamic !== undefined && dynamic !== true
-            ? resolveTtlMilliseconds(dynamic.ttl, "dynamic.ttl")
-            : null;
-        if (dynamic !== true) {
-            const cached = this.evaluationCache.getRecord(cacheKey);
-            if (cached !== null && dynamicTtlMs !== null && Date.now() - cached.storedAtMs <= dynamicTtlMs) {
-                return cached.value;
-            }
-        }
-        let resolved;
+    async resolveStaticValues(names, options) {
+        const definitions = await this.getStaticDefinitions(names);
+        return await Promise.all(definitions.map(async (definition) => await evaluateDefinition(definition, options)));
+    }
+    async fetchDynamicValues(names, context, options) {
         try {
+            if (names.length === 1) {
+                const evaluated = await postJson({
+                    fetchFn: this.fetchFn,
+                    baseUrl: context.baseUrl,
+                    path: "/v1/env/evaluate",
+                    payload: {
+                        orgSlug: context.organization,
+                        projectSlug: context.project,
+                        stageSlug: context.environment,
+                        name: names[0],
+                        seed: options?.seed,
+                        key: options?.key,
+                    },
+                    auth: context.auth,
+                });
+                return [resolveEvaluatedResponse(evaluated)];
+            }
             const evaluated = await postJson({
                 fetchFn: this.fetchFn,
                 baseUrl: context.baseUrl,
-                path: "/v1/env/evaluate",
+                path: "/v1/env/evaluate-batch",
                 payload: {
                     orgSlug: context.organization,
                     projectSlug: context.project,
                     stageSlug: context.environment,
-                    name,
+                    names,
                     seed: options?.seed,
                     key: options?.key,
                 },
                 auth: context.auth,
             });
-            resolved = {
-                name: evaluated.name,
-                kind: evaluated.kind,
-                declaredType: evaluated.declaredType,
-                value: evaluated.value,
-                decision: evaluated.decision,
-                selectedArm: inferSelectedArmFromDecision(evaluated.decision),
-            };
+            return mapValuesToRequestedOrder(names, evaluated.values.map((value) => resolveEvaluatedResponse(value)));
         }
         catch (error) {
             if (!(error instanceof BillingUnavailableError)) {
                 throw error;
             }
-            const freshDefinitions = await this.fetchDefinitions([name]);
-            const freshDefinition = freshDefinitions[0];
-            if (freshDefinition === undefined) {
-                throw new VariableNotFoundError();
+            const definitions = await this.getStaticDefinitions(names);
+            return await Promise.all(definitions.map(async (definition) => await evaluateDefinition(definition, options)));
+        }
+    }
+    async resolveDynamicValue(name, options) {
+        await this.ensureRequirementsValidated();
+        const context = await this.getRuntimeContext();
+        const cacheKey = this.buildEvaluationCacheKey(context, name, options);
+        const dynamic = options?.dynamic;
+        const dynamicTtlMs = dynamic !== undefined && dynamic !== true
+            ? resolveTtlMilliseconds(dynamic.ttl, "dynamic.ttl")
+            : null;
+        if (dynamic !== true) {
+            const cached = this.evaluationCache.getRecord(cacheKey);
+            if (cached !== null && dynamicTtlMs !== null && Date.now() - cached.storedAtMs <= dynamicTtlMs) {
+                return cached.value;
             }
-            resolved = await evaluateDefinition(freshDefinition, options);
+        }
+        const resolvedValues = await this.fetchDynamicValues([name], context, options);
+        const resolved = resolvedValues[0];
+        if (resolved === undefined) {
+            throw new VariableNotFoundError();
         }
         if (dynamicTtlMs !== null) {
             // dynamic.ttl is evaluated per read, so keep the cached fetch time and let
@@ -302,6 +376,36 @@ export class BarekeyClient {
         }
         return resolved;
     }
+    async resolveDynamicValues(names, options) {
+        await this.ensureRequirementsValidated();
+        const context = await this.getRuntimeContext();
+        const dynamic = options?.dynamic;
+        const dynamicTtlMs = dynamic !== undefined && dynamic !== true
+            ? resolveTtlMilliseconds(dynamic.ttl, "dynamic.ttl")
+            : null;
+        const resolvedValues = new Map();
+        const missingNames = [];
+        for (const name of uniqueNames(names)) {
+            const cacheKey = this.buildEvaluationCacheKey(context, name, options);
+            if (dynamic !== true) {
+                const cached = this.evaluationCache.getRecord(cacheKey);
+                if (cached !== null && dynamicTtlMs !== null && Date.now() - cached.storedAtMs <= dynamicTtlMs) {
+                    resolvedValues.set(name, cached.value);
+                    continue;
+                }
+            }
+            missingNames.push(name);
+        }
+        if (missingNames.length > 0) {
+            for (const resolved of await this.fetchDynamicValues(missingNames, context, options)) {
+                resolvedValues.set(resolved.name, resolved);
+                if (dynamicTtlMs !== null) {
+                    this.evaluationCache.set(this.buildEvaluationCacheKey(context, resolved.name, options), resolved);
+                }
+            }
+        }
+        return mapValuesToRequestedOrder(names, [...resolvedValues.values()]);
+    }
     async resolveEvaluatedValue(name, options) {
         const context = await this.getRuntimeContext();
         this.ensureTypegenWatcher(context);
@@ -311,4 +415,20 @@ export class BarekeyClient {
         }
         return await this.resolveDynamicValue(name, options);
     }
+    async resolveEvaluatedValues(names, options) {
+        if (names.length === 0) {
+            return [];
+        }
+        if (uniqueNames(names).length === 1) {
+            const resolved = await this.resolveEvaluatedValue(names[0] ?? "", options);
+            return names.map(() => resolved);
+        }
+        const context = await this.getRuntimeContext();
+        this.ensureTypegenWatcher(context);
+        validateDynamicOptions(options);
+        if (options?.dynamic === undefined) {
+            return await this.resolveStaticValues(names, options);
+        }
+        return await this.resolveDynamicValues(names, options);
+    }
 }

package/dist/handle.d.ts

@@ -1,4 +1,4 @@
-import type { BarekeyCoerceTarget, BarekeyEvaluatedValue } from "./types.js";
+import type { BarekeyCoerceTarget, BarekeyEvaluatedValue, BarekeyResolvedRecord, BarekeyResolvedRecords } from "./types.js";
 type BarekeyCoercibleEnvMarker = {
     readonly __barekey?: {
         readonly mode: "ab";
@@ -8,13 +8,27 @@ export declare class BarekeyEnvHandle<TValue = unknown> implements PromiseLike<T
     private readonly resolveEvaluatedValue;
     private readonly transform;
     private evaluatedValuePromise;
+    private resolvedRecordPromise;
     constructor(resolveEvaluatedValue: () => Promise<BarekeyEvaluatedValue>, transform?: (resolved: BarekeyEvaluatedValue) => Promise<TValue>);
     private resolveValue;
     private getEvaluatedValue;
+    inspect(): Promise<BarekeyResolvedRecord<TValue>>;
     coerce<TCoerced = unknown>(this: [TValue] extends [BarekeyCoercibleEnvMarker] ? BarekeyEnvHandle<TValue> : never, target: BarekeyCoerceTarget): BarekeyEnvHandle<TCoerced>;
     then<TResult1 = TValue, TResult2 = never>(onfulfilled?: ((value: TValue) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
     catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<TValue | TResult>;
     finally(onfinally?: (() => void) | null): Promise<TValue>;
 }
+export declare class BarekeyEnvBatchHandle<TValues extends ReadonlyArray<unknown> = Array<unknown>> implements PromiseLike<TValues> {
+    private readonly resolveEvaluatedValues;
+    private evaluatedValuesPromise;
+    private resolvedRecordsPromise;
+    constructor(resolveEvaluatedValues: () => Promise<ReadonlyArray<BarekeyEvaluatedValue>>);
+    private getEvaluatedValues;
+    inspect(): Promise<BarekeyResolvedRecords<TValues>>;
+    private resolveValues;
+    then<TResult1 = TValues, TResult2 = never>(onfulfilled?: ((value: TValues) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<TValues | TResult>;
+    finally(onfinally?: (() => void) | null): Promise<TValues>;
+}
 export {};
 //# sourceMappingURL=handle.d.ts.map

package/dist/handle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../src/handle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE7E,KAAK,yBAAyB,GAAG;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;KACrB,CAAC;CACH,CAAC;AAEF,qBAAa,gBAAgB,CAAC,MAAM,GAAG,OAAO,CAAE,YAAW,WAAW,CAAC,MAAM,CAAC;IAC5E,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAuC;IAC7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuD;IACjF,OAAO,CAAC,qBAAqB,CAA+C;gBAG1E,qBAAqB,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,EAC3D,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,OAAO,CAAC,MAAM,CAAC;YAQpD,YAAY;YAIZ,iBAAiB;IAO/B,MAAM,CAAC,QAAQ,GAAG,OAAO,EACvB,IAAI,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,yBAAyB,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,GAAG,KAAK,EACrF,MAAM,EAAE,mBAAmB,GAC1B,gBAAgB,CAAC,QAAQ,CAAC;IAS7B,IAAI,CAAC,QAAQ,GAAG,MAAM,EAAE,QAAQ,GAAG,KAAK,EACtC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EAC1E,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAC1E,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAI/B,KAAK,CAAC,OAAO,GAAG,KAAK,EACnB,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GACxE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;IAI5B,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CAG1D"}
+{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../src/handle.ts"],"names":[],"mappings":"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"}

package/dist/handle.js

@@ -1,8 +1,16 @@
 import { coerceEvaluatedValue, parseDeclaredValue, } from "./internal/evaluate.js";
+function buildResolvedRecord(resolved, value) {
+    return {
+        ...resolved,
+        rawValue: resolved.value,
+        value,
+    };
+}
 export class BarekeyEnvHandle {
     resolveEvaluatedValue;
     transform;
     evaluatedValuePromise = null;
+    resolvedRecordPromise = null;
     constructor(resolveEvaluatedValue, transform) {
         this.resolveEvaluatedValue = resolveEvaluatedValue;
         this.transform =
@@ -10,7 +18,7 @@ export class BarekeyEnvHandle {
                 (async (resolved) => parseDeclaredValue(resolved.value, resolved.declaredType));
     }
     async resolveValue() {
-        return await this.transform(await this.getEvaluatedValue());
+        return (await this.inspect()).value;
     }
     async getEvaluatedValue() {
         if (this.evaluatedValuePromise === null) {
@@ -18,6 +26,16 @@ export class BarekeyEnvHandle {
         }
         return await this.evaluatedValuePromise;
     }
+    async inspect() {
+        if (this.resolvedRecordPromise === null) {
+            this.resolvedRecordPromise = (async () => {
+                const resolved = await this.getEvaluatedValue();
+                const value = await this.transform(resolved);
+                return buildResolvedRecord(resolved, value);
+            })();
+        }
+        return await this.resolvedRecordPromise;
+    }
     coerce(target) {
         return new BarekeyEnvHandle(async () => await this.getEvaluatedValue(), async (resolved) => {
             return coerceEvaluatedValue(resolved, target);
@@ -33,3 +51,43 @@ export class BarekeyEnvHandle {
         return this.resolveValue().finally(onfinally ?? undefined);
     }
 }
+export class BarekeyEnvBatchHandle {
+    resolveEvaluatedValues;
+    evaluatedValuesPromise = null;
+    resolvedRecordsPromise = null;
+    constructor(resolveEvaluatedValues) {
+        this.resolveEvaluatedValues = resolveEvaluatedValues;
+    }
+    async getEvaluatedValues() {
+        if (this.evaluatedValuesPromise === null) {
+            this.evaluatedValuesPromise = this.resolveEvaluatedValues();
+        }
+        return await this.evaluatedValuesPromise;
+    }
+    async inspect() {
+        if (this.resolvedRecordsPromise === null) {
+            this.resolvedRecordsPromise = (async () => {
+                const resolvedValues = await this.getEvaluatedValues();
+                const records = await Promise.all(resolvedValues.map(async (resolved) => {
+                    const value = parseDeclaredValue(resolved.value, resolved.declaredType);
+                    return buildResolvedRecord(resolved, value);
+                }));
+                return records;
+            })();
+        }
+        return await this.resolvedRecordsPromise;
+    }
+    async resolveValues() {
+        const resolvedRecords = await this.inspect();
+        return resolvedRecords.map((resolved) => resolved.value);
+    }
+    then(onfulfilled, onrejected) {
+        return this.resolveValues().then(onfulfilled ?? undefined, onrejected ?? undefined);
+    }
+    catch(onrejected) {
+        return this.resolveValues().catch(onrejected ?? undefined);
+    }
+    finally(onfinally) {
+        return this.resolveValues().finally(onfinally ?? undefined);
+    }
+}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { BarekeyClient } from "./client.js";
 export { PublicBarekeyClient } from "./public-client.js";
-export { BarekeyEnvHandle } from "./handle.js";
+export { BarekeyEnvBatchHandle, BarekeyEnvHandle } from "./handle.js";
 export { BarekeyError, BillingUnavailableError, CoerceFailedError, DeviceCodeExpiredError, DeviceCodeNotFoundError, EvaluationFailedError, FsNotAvailableError, InvalidConfigurationProvidedError, InvalidCredentialsProvidedError, InvalidDynamicOptionsError, InvalidJsonError, InvalidOrgScopeError, InvalidRefreshTokenError, InvalidRequestError, NetworkError, NoConfigurationProvidedError, NoCredentialsProvidedError, OrgScopeInvalidError, RequirementsValidationFailedError, SdkModuleNotFoundError, TemporalNotAvailableError, TypegenReadFailedError, TypegenUnsupportedSdkError, TypegenWriteFailedError, UnauthorizedError, UnknownError, UsageLimitExceededError, UserCodeInvalidError, VariableNotFoundError, createBarekeyErrorFromCode, docsUrlForErrorCode, formatBarekeyErrorMessage, isBarekeyErrorCode, normalizeErrorCode, } from "./errors.js";
-export type { AB, BarekeyClientOptions, BarekeyCoerceTarget, BarekeyDeclaredType, BarekeyErrorCode, BarekeyGeneratedTypeMap, BarekeyGetOptions, BarekeyJsonConfig, BarekeyKey, BarekeyLiteralString, BarekeyKnownKey, BarekeyResolvedKind, BarekeyRolloutMilestone, BarekeyStandardSchemaV1, BarekeyTemporalInstant, BarekeyTemporalInstantLike, BarekeyTtlInput, BarekeyTypegenResult, Env, Linear, Secret, } from "./types.js";
-export type { BarekeyPublicGeneratedTypeMap, BarekeyPublicKey, BarekeyPublicKnownKey, PublicBarekeyClientOptions, } from "./public-types.js";
+export type { AB, BarekeyClientOptions, BarekeyCoerceTarget, BarekeyDeclaredType, BarekeyErrorCode, BarekeyEvaluatedValue, BarekeyGeneratedTypeMap, BarekeyGeneratedValueForKey, BarekeyGeneratedValuesForKeys, BarekeyGetOptions, BarekeyJsonConfig, BarekeyKey, BarekeyLiteralString, BarekeyKnownKey, BarekeyResolvedRecord, BarekeyResolvedRecords, BarekeyResolvedKind, BarekeyRolloutMilestone, BarekeyStandardSchemaV1, BarekeyTemporalInstant, BarekeyTemporalInstantLike, BarekeyTtlInput, BarekeyTypegenResult, BarekeyValueForGeneratedMap, BarekeyValuesForGeneratedMap, Env, Linear, Secret, BarekeyVisibility, } from "./types.js";
+export type { BarekeyPublicGeneratedTypeMap, BarekeyPublicKey, BarekeyPublicKnownKey, BarekeyPublicValueForKey, BarekeyPublicValuesForKeys, PublicBarekeyClientOptions, } from "./public-types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,iCAAiC,EACjC,+BAA+B,EAC/B,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,4BAA4B,EAC5B,0BAA0B,EAC1B,oBAAoB,EACpB,iCAAiC,EACjC,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,EAAE,EACF,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,GAAG,EACH,MAAM,EACN,MAAM,GACP,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,iCAAiC,EACjC,+BAA+B,EAC/B,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,4BAA4B,EAC5B,0BAA0B,EAC1B,oBAAoB,EACpB,iCAAiC,EACjC,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,EAAE,EACF,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,6BAA6B,EAC7B,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,2BAA2B,EAC3B,4BAA4B,EAC5B,GAAG,EACH,MAAM,EACN,MAAM,EACN,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
 export { BarekeyClient } from "./client.js";
 export { PublicBarekeyClient } from "./public-client.js";
-export { BarekeyEnvHandle } from "./handle.js";
+export { BarekeyEnvBatchHandle, BarekeyEnvHandle } from "./handle.js";
 export { BarekeyError, BillingUnavailableError, CoerceFailedError, DeviceCodeExpiredError, DeviceCodeNotFoundError, EvaluationFailedError, FsNotAvailableError, InvalidConfigurationProvidedError, InvalidCredentialsProvidedError, InvalidDynamicOptionsError, InvalidJsonError, InvalidOrgScopeError, InvalidRefreshTokenError, InvalidRequestError, NetworkError, NoConfigurationProvidedError, NoCredentialsProvidedError, OrgScopeInvalidError, RequirementsValidationFailedError, SdkModuleNotFoundError, TemporalNotAvailableError, TypegenReadFailedError, TypegenUnsupportedSdkError, TypegenWriteFailedError, UnauthorizedError, UnknownError, UsageLimitExceededError, UserCodeInvalidError, VariableNotFoundError, createBarekeyErrorFromCode, docsUrlForErrorCode, formatBarekeyErrorMessage, isBarekeyErrorCode, normalizeErrorCode, } from "./errors.js";

package/dist/internal/evaluate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/internal/evaluate.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EAIjB,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAgDrB,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAKxE;AAqHD,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,yBAAyB,EACrC,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,KAAK,CAAC,GAChD,OAAO,CAAC,qBAAqB,CAAC,CAuDhC;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,GAAG,GAAG,GAAG,GAAG,SAAS,CAQ9F;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,mBAAmB,GAAG,OAAO,CAiB5F;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CA0BT"}
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/internal/evaluate.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EAIjB,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAgDrB,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAKxE;AAqHD,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,yBAAyB,EACrC,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,KAAK,CAAC,GAChD,OAAO,CAAC,qBAAqB,CAAC,CA0DhC;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,GAAG,GAAG,GAAG,GAAG,SAAS,CAQ9F;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,mBAAmB,GAAG,OAAO,CAiB5F;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CA0BT"}

package/dist/internal/evaluate.js

@@ -130,6 +130,7 @@ export async function evaluateDefinition(definition, options) {
             name: definition.name,
             kind: definition.kind,
             declaredType: definition.declaredType,
+            visibility: definition.visibility,
             value: definition.value,
         };
     }
@@ -144,6 +145,7 @@ export async function evaluateDefinition(definition, options) {
             name: definition.name,
             kind: definition.kind,
             declaredType: definition.declaredType,
+            visibility: definition.visibility,
             value: selectedArm === "A" ? definition.valueA : definition.valueB,
             selectedArm,
             decision: {
@@ -165,6 +167,7 @@ export async function evaluateDefinition(definition, options) {
         name: definition.name,
         kind: definition.kind,
         declaredType: definition.declaredType,
+        visibility: definition.visibility,
         value: selectedArm === "A" ? definition.valueA : definition.valueB,
         selectedArm,
         decision: {

package/dist/internal/singleton.d.ts

@@ -0,0 +1,5 @@
+import type { PublicBarekeyClientOptions } from "../public-types.js";
+import type { BarekeyClientOptions } from "../types.js";
+export declare function createBarekeyClientSingletonKey(options: BarekeyClientOptions): string;
+export declare function createPublicBarekeyClientSingletonKey(options: PublicBarekeyClientOptions): string;
+//# sourceMappingURL=singleton.d.ts.map

package/dist/internal/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../src/internal/singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EACV,oBAAoB,EAIrB,MAAM,aAAa,CAAC;AAyJrB,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAYrF;AAED,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,0BAA0B,GAClC,MAAM,CAOR"}