@temporalio/envconfig 1.13.2

package/LICENSE.md

@@ -0,0 +1,23 @@
+Temporal TypeScript SDK
+
+MIT License
+
+Copyright (c) 2021 Temporal Technologies Inc. All Rights Reserved
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# `@temporalio/envconfig`
+
+[![NPM](https://img.shields.io/npm/v/@temporalio/envconfig?style=for-the-badge)](https://www.npmjs.com/package/@temporalio/envconfig)
+
+Part of [Temporal](https://temporal.io)'s [TypeScript SDK](https://docs.temporal.io/typescript/introduction/).

package/lib/envconfig-toml.d.ts

@@ -0,0 +1,57 @@
+import { LoadClientConfigOptions, LoadClientProfileOptions } from './types';
+export declare function normalizeGrpcMetaKey(key: string): string;
+/**
+ * Raw TOML structure representing the client configuration file.
+ *
+ * @internal
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export interface TomlClientConfig {
+    profile: Record<string, TomlClientConfigProfile>;
+}
+/**
+ * Raw TOML structure for a client configuration profile.
+ * Note: field names use snake_case to match TOML file fields for correct parser deserialization.
+ *
+ * @internal
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export interface TomlClientConfigProfile {
+    address?: string;
+    namespace?: string;
+    api_key?: string;
+    tls?: TomlClientConfigTLS;
+    codec?: TomlClientConfigCodec;
+    grpc_meta?: Record<string, string>;
+}
+/**
+ * Raw TOML structure for client configuration TLS.
+ *
+ * @internal
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export interface TomlClientConfigTLS {
+    disabled?: boolean;
+    client_cert_path?: string;
+    client_cert_data?: string;
+    client_key_path?: string;
+    client_key_data?: string;
+    server_ca_cert_path?: string;
+    server_ca_cert_data?: string;
+    server_name?: string;
+    disable_host_verification?: boolean;
+}
+/**
+ * Raw TOML structure for client configuration codec.
+ *
+ * @internal
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export interface TomlClientConfigCodec {
+    endpoint?: string;
+    auth?: string;
+}
+export declare function tomlLoadClientConfig(options: LoadClientConfigOptions): TomlClientConfig;
+export declare function loadFromTomlData(tomlData: string, isStrict: boolean): TomlClientConfig;
+export declare function configToTomlData(config: TomlClientConfig): Uint8Array;
+export declare function tomlLoadClientConfigProfile(options: LoadClientProfileOptions): TomlClientConfigProfile;

package/lib/envconfig-toml.js

@@ -0,0 +1,279 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeGrpcMetaKey = normalizeGrpcMetaKey;
+exports.tomlLoadClientConfig = tomlLoadClientConfig;
+exports.loadFromTomlData = loadFromTomlData;
+exports.configToTomlData = configToTomlData;
+exports.tomlLoadClientConfigProfile = tomlLoadClientConfigProfile;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const smol_toml_1 = require("smol-toml");
+const objects_helpers_1 = require("@temporalio/common/lib/internal-workflow/objects-helpers");
+const encoding_1 = require("@temporalio/common/lib/encoding");
+function normalizeGrpcMetaKey(key) {
+    return key.toLocaleLowerCase().replace('_', '-');
+}
+function sourceToStringData(source) {
+    if (source === undefined) {
+        return undefined;
+    }
+    if ('path' in source) {
+        return (0, fs_1.readFileSync)(source.path, { encoding: 'utf-8' });
+    }
+    if (typeof source.data === 'string') {
+        return source.data;
+    }
+    return (0, encoding_1.decode)(source.data);
+}
+function tomlLoadClientConfig(options) {
+    const envProvider = options.overrideEnvVars ?? process.env;
+    let configData = undefined;
+    try {
+        configData = sourceToStringData(options.configSource) ?? getFallbackConfigData(envProvider);
+    }
+    catch (error) {
+        const isFileNotFound = error?.code === 'ENOENT';
+        if (!isFileNotFound) {
+            throw error;
+        }
+        // File not found is ok
+    }
+    if (configData !== undefined) {
+        return loadFromTomlData(configData, options.configFileStrict ?? false);
+    }
+    return { profile: {} }; // default ClientConfig
+}
+function loadFromTomlData(tomlData, isStrict) {
+    const parsed = (0, smol_toml_1.parse)(tomlData);
+    if (isStrict) {
+        strictValidateTomlStructure(parsed);
+    }
+    return parsed;
+}
+function configToTomlData(config) {
+    return (0, encoding_1.encode)((0, smol_toml_1.stringify)(config));
+}
+function strictValidateTomlStructure(parsed) {
+    const allowedTopLevel = new Set(['profile']);
+    const allowedProfile = new Set(['address', 'namespace', 'api_key', 'tls', 'codec', 'grpc_meta']);
+    const allowedTLS = new Set([
+        'disabled',
+        'client_cert_path',
+        'client_key_path',
+        'client_cert_data',
+        'client_key_data',
+        'server_ca_cert_path',
+        'server_ca_cert_data',
+        'server_name',
+    ]);
+    const allowedCodec = new Set(['endpoint', 'auth']);
+    // Check top-level keys
+    const unknownTopLevel = Object.keys(parsed).filter((k) => !allowedTopLevel.has(k));
+    if (unknownTopLevel.length > 0) {
+        throw new Error(`Validation error: key(s) unrecognized: ${unknownTopLevel.join(', ')}`);
+    }
+    const profiles = parsed.profile;
+    if (profiles === undefined)
+        return;
+    // Ensure it's a TomlTable (not a primitive or array)
+    if (typeof profiles !== 'object' || Array.isArray(profiles)) {
+        throw new Error('Validation error: profile must be a table');
+    }
+    for (const [profileName, profileData] of Object.entries(profiles)) {
+        // Ensure profile is a table
+        if (typeof profileData !== 'object' || Array.isArray(profileData)) {
+            throw new Error(`Validation error: profile.${profileName} must be a table`);
+        }
+        const unknownProfile = Object.keys(profileData).filter((k) => !allowedProfile.has(k));
+        if (unknownProfile.length > 0) {
+            throw new Error(`Validation error: key(s) unrecognized in profile.${profileName}: ${unknownProfile.join(', ')}`);
+        }
+        // Validate TLS
+        const tls = profileData.tls;
+        if (tls !== undefined) {
+            if (typeof tls !== 'object' || Array.isArray(tls)) {
+                throw new Error(`Validation error: profile.${profileName}.tls must be a table`);
+            }
+            const unknownTLS = Object.keys(tls).filter((k) => !allowedTLS.has(k));
+            if (unknownTLS.length > 0) {
+                throw new Error(`Validation error: key(s) unrecognized in profile.${profileName}.tls: ${unknownTLS.join(', ')}`);
+            }
+        }
+        // Validate codec
+        const codec = profileData.codec;
+        if (codec !== undefined) {
+            if (typeof codec !== 'object' || Array.isArray(codec)) {
+                throw new Error(`Validation error: profile.${profileName}.codec must be a table`);
+            }
+            const unknownCodec = Object.keys(codec).filter((k) => !allowedCodec.has(k));
+            if (unknownCodec.length > 0) {
+                throw new Error(`Validation error: key(s) unrecognized in profile.${profileName}.codec: ${unknownCodec.join(', ')}`);
+            }
+        }
+    }
+}
+function getFallbackConfigData(envProvider) {
+    // configSource was not set - fallback to TEMPORAL_CONFIG_FILE, then the default file path
+    let filePath = envProvider['TEMPORAL_CONFIG_FILE'];
+    if (filePath === undefined) {
+        filePath = getDefaultConfigFilePath();
+    }
+    return (0, fs_1.readFileSync)(filePath, { encoding: 'utf-8' });
+}
+function tomlLoadClientConfigProfile(options) {
+    if (options.disableEnv && options.disableFile) {
+        throw new Error('Cannot disable both file and environment loading');
+    }
+    const envProvider = options.overrideEnvVars ?? process.env;
+    let profile = {};
+    if (!options.disableFile) {
+        const tomlClientConfig = tomlLoadClientConfig({
+            configSource: options.configSource,
+            configFileStrict: options.configFileStrict,
+            overrideEnvVars: options.overrideEnvVars,
+        });
+        // If profile name not provided, fallback to env variable.
+        const profileName = options.profile ?? envProvider['TEMPORAL_PROFILE'];
+        // If env var also not provided, fallback to default profile name.
+        const tomlProfile = tomlClientConfig.profile[profileName ?? DEFAULT_CONFIG_FILE_PROFILE];
+        // If toml profile does not exist and an explicit profile was requested, error.
+        if (tomlProfile === undefined && profileName) {
+            throw new Error(`Profile '${profileName}' not found in config data`);
+        }
+        // Use loaded profile if exists, otherwise fallback to default profile.
+        profile = tomlProfile ?? {};
+    }
+    if (!options.disableEnv) {
+        applyProfileEnvVars(profile, envProvider);
+    }
+    return profile;
+}
+function applyProfileEnvVars(profile, envProvider) {
+    profile.address = envProvider['TEMPORAL_ADDRESS'] ?? profile.address;
+    profile.namespace = envProvider['TEMPORAL_NAMESPACE'] ?? profile.namespace;
+    profile.api_key = envProvider['TEMPORAL_API_KEY'] ?? profile.api_key;
+    const tlsFromEnv = getTLSFromEnvVars(envProvider);
+    profile.tls = profile.tls || tlsFromEnv ? { ...profile.tls, ...tlsFromEnv } : undefined;
+    const codecFromEnv = getCodecFromEnvVars(envProvider);
+    profile.codec = profile.codec || codecFromEnv ? { ...profile.codec, ...codecFromEnv } : undefined;
+    applyGrpcMetaFromEnvVars(profile, envProvider);
+}
+function getTLSFromEnvVars(envProvider) {
+    const tlsConfig = (0, objects_helpers_1.filterNullAndUndefined)({
+        disabled: envVarToBool(envProvider['TEMPORAL_TLS']),
+        client_cert_path: envProvider['TEMPORAL_TLS_CLIENT_CERT_PATH'],
+        client_cert_data: envProvider['TEMPORAL_TLS_CLIENT_CERT_DATA'],
+        client_key_path: envProvider['TEMPORAL_TLS_CLIENT_KEY_PATH'],
+        client_key_data: envProvider['TEMPORAL_TLS_CLIENT_KEY_DATA'],
+        server_ca_cert_path: envProvider['TEMPORAL_TLS_SERVER_CA_CERT_PATH'],
+        server_ca_cert_data: envProvider['TEMPORAL_TLS_SERVER_CA_CERT_DATA'],
+        server_name: envProvider['TEMPORAL_TLS_SERVER_NAME'],
+        disable_host_verification: envVarToBool(envProvider['TEMPORAL_TLS_DISABLE_HOST_VERIFICATION']),
+    });
+    // If no properties were added, return undefined
+    return Object.keys(tlsConfig).length > 0 ? tlsConfig : undefined;
+}
+function getCodecFromEnvVars(envProvider) {
+    const codec = {};
+    const endpoint = envProvider['TEMPORAL_CODEC_ENDPOINT'];
+    if (endpoint !== undefined) {
+        codec.endpoint = endpoint;
+    }
+    const auth = envProvider['TEMPORAL_CODEC_AUTH'];
+    if (auth !== undefined) {
+        codec.auth = auth;
+    }
+    // If no properties were added, return undefined
+    return Object.keys(codec).length > 0 ? codec : undefined;
+}
+function applyGrpcMetaFromEnvVars(profile, envProvider) {
+    const PREFIX = 'TEMPORAL_GRPC_META_';
+    for (const [key, value] of Object.entries(envProvider)) {
+        if (key.startsWith(PREFIX)) {
+            const headerName = key.slice(PREFIX.length);
+            const normalizedKey = normalizeGrpcMetaKey(headerName);
+            if (profile.grpc_meta === undefined) {
+                profile.grpc_meta = {};
+            }
+            // Empty values remove the key, non-empty values set it
+            if (value === '' || value == null) {
+                delete profile.grpc_meta[normalizedKey];
+            }
+            else {
+                profile.grpc_meta[normalizedKey] = value;
+            }
+        }
+    }
+}
+function envVarToBool(envVar) {
+    if (envVar === undefined) {
+        return undefined;
+    }
+    return envVar === '1' || envVar === 'true';
+}
+const DEFAULT_CONFIG_FILE_PROFILE = 'default';
+const DEFAULT_CONFIG_FILE = 'config.toml';
+function getDefaultConfigFilePath() {
+    const configDir = getUserConfigDir();
+    const configPath = path.join(configDir, 'temporalio', DEFAULT_CONFIG_FILE);
+    return configPath;
+}
+function getUserConfigDir() {
+    const platform = os.platform();
+    switch (platform) {
+        case 'win32': {
+            const dir = process.env.APPDATA;
+            if (!dir) {
+                throw new Error('%AppData% is not defined');
+            }
+            return dir;
+        }
+        case 'darwin': {
+            const dir = process.env.HOME;
+            if (!dir) {
+                throw new Error('$HOME is not defined');
+            }
+            return path.join(dir, 'Library', 'Application Support');
+        }
+        default: {
+            // Unix/Linux
+            let dir = process.env.XDG_CONFIG_HOME;
+            if (!dir) {
+                const home = process.env.HOME;
+                if (!home) {
+                    throw new Error('neither $XDG_CONFIG_HOME nor $HOME are defined');
+                }
+                dir = path.join(home, '.config');
+            }
+            else if (!path.isAbsolute(dir)) {
+                throw new Error('path in $XDG_CONFIG_HOME is relative');
+            }
+            return dir;
+        }
+    }
+}
+//# sourceMappingURL=envconfig-toml.js.map

package/lib/envconfig-toml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envconfig-toml.js","sourceRoot":"","sources":["../src/envconfig-toml.ts"],"names":[],"mappings":"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"}

package/lib/envconfig.d.ts

@@ -0,0 +1,9 @@
+import type { TLSConfig } from '@temporalio/common/lib/internal-non-workflow';
+import { ClientConfig, ClientConfigFromTomlOptions, ClientConfigProfile, ClientConfigTLS, ClientConnectConfig, LoadClientConfigOptions, LoadClientProfileOptions } from './types';
+export declare function loadClientConfig(options: LoadClientConfigOptions): ClientConfig;
+export declare function loadClientConfigFromToml(tomlData: Uint8Array, options: ClientConfigFromTomlOptions): ClientConfig;
+export declare function clientConfigToToml(config: ClientConfig): Uint8Array;
+export declare function loadClientConfigProfile(options?: LoadClientProfileOptions): ClientConfigProfile;
+export declare function loadClientConnectConfig(options?: LoadClientProfileOptions): ClientConnectConfig;
+export declare function toClientOptions(profile: ClientConfigProfile): ClientConnectConfig;
+export declare function toTLSConfig(config?: ClientConfigTLS): TLSConfig | boolean | undefined;

package/lib/envconfig.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadClientConfig = loadClientConfig;
+exports.loadClientConfigFromToml = loadClientConfigFromToml;
+exports.clientConfigToToml = clientConfigToToml;
+exports.loadClientConfigProfile = loadClientConfigProfile;
+exports.loadClientConnectConfig = loadClientConnectConfig;
+exports.toClientOptions = toClientOptions;
+exports.toTLSConfig = toTLSConfig;
+const encoding_1 = require("@temporalio/common/lib/encoding");
+const envconfig_toml_1 = require("./envconfig-toml");
+const utils_1 = require("./utils");
+function loadClientConfig(options) {
+    return (0, utils_1.fromTomlConfig)((0, envconfig_toml_1.tomlLoadClientConfig)(options));
+}
+function loadClientConfigFromToml(tomlData, options) {
+    return (0, utils_1.fromTomlConfig)((0, envconfig_toml_1.loadFromTomlData)((0, encoding_1.decode)(tomlData), options.strict));
+}
+function clientConfigToToml(config) {
+    return (0, envconfig_toml_1.configToTomlData)((0, utils_1.toTomlConfig)(config));
+}
+function loadClientConfigProfile(options = {}) {
+    return (0, utils_1.fromTomlProfile)((0, envconfig_toml_1.tomlLoadClientConfigProfile)(options));
+}
+function loadClientConnectConfig(options = {}) {
+    return toClientOptions(loadClientConfigProfile(options));
+}
+function toClientOptions(profile) {
+    // TLS is enabled if we have an explicit TLS config, or if an api key is provided.
+    const tls = toTLSConfig(profile.tls) ?? (profile.apiKey !== undefined ? true : undefined);
+    return {
+        namespace: profile.namespace,
+        connectionOptions: {
+            address: profile.address,
+            apiKey: profile.apiKey,
+            tls,
+            metadata: profile.grpcMeta,
+        },
+    };
+}
+function toTLSConfig(config) {
+    if (config === undefined) {
+        return undefined;
+    }
+    if (config.disabled === true) {
+        return false;
+    }
+    const serverRootCACert = (0, utils_1.loadConfigData)(config.serverCACert);
+    const crtBuffer = (0, utils_1.loadConfigData)(config.clientCert);
+    const keyBuffer = (0, utils_1.loadConfigData)(config.clientKey);
+    const tlsConfig = {
+        serverNameOverride: config.serverName,
+        serverRootCACertificate: serverRootCACert,
+        clientCertPair: crtBuffer && keyBuffer
+            ? {
+                crt: crtBuffer,
+                key: keyBuffer,
+            }
+            : undefined,
+    };
+    return tlsConfig;
+}
+//# sourceMappingURL=envconfig.js.map

package/lib/envconfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envconfig.js","sourceRoot":"","sources":["../src/envconfig.ts"],"names":[],"mappings":";;AAmBA,4CAEC;AAED,4DAEC;AAED,gDAEC;AAED,0DAEC;AAED,0DAEC;AAED,0CAYC;AAED,kCAwBC;AA5ED,8DAAyD;AACzD,qDAK0B;AAU1B,mCAAwF;AAExF,SAAgB,gBAAgB,CAAC,OAAgC;IAC/D,OAAO,IAAA,sBAAc,EAAC,IAAA,qCAAoB,EAAC,OAAO,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,SAAgB,wBAAwB,CAAC,QAAoB,EAAE,OAAoC;IACjG,OAAO,IAAA,sBAAc,EAAC,IAAA,iCAAgB,EAAC,IAAA,iBAAM,EAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAAoB;IACrD,OAAO,IAAA,iCAAgB,EAAC,IAAA,oBAAY,EAAC,MAAM,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAgB,uBAAuB,CAAC,UAAoC,EAAE;IAC5E,OAAO,IAAA,uBAAe,EAAC,IAAA,4CAA2B,EAAC,OAAO,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAgB,uBAAuB,CAAC,UAAoC,EAAE;IAC5E,OAAO,eAAe,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAgB,eAAe,CAAC,OAA4B;IAC1D,kFAAkF;IAClF,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1F,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,iBAAiB,EAAE;YACjB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG;YACH,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,WAAW,CAAC,MAAwB;IAClD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAA,sBAAc,EAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAA,sBAAc,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,IAAA,sBAAc,EAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEnD,MAAM,SAAS,GAAc;QAC3B,kBAAkB,EAAE,MAAM,CAAC,UAAU;QACrC,uBAAuB,EAAE,gBAAgB;QACzC,cAAc,EACZ,SAAS,IAAI,SAAS;YACpB,CAAC,CAAC;gBACE,GAAG,EAAE,SAAS;gBACd,GAAG,EAAE,SAAS;aACf;YACH,CAAC,CAAC,SAAS;KAChB,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { loadClientConfig, loadClientConfigProfile, loadClientConnectConfig, loadClientConfigFromToml, clientConfigToToml, toClientOptions, } from './envconfig';
+export { ClientConfig, ClientConfigProfile, ClientConfigTLS, LoadClientConfigOptions, LoadClientProfileOptions, ClientConfigFromTomlOptions, ConfigDataSource, } from './types';
+export { fromTomlConfig, fromTomlProfile, toTomlConfig, toTomlProfile, loadConfigData } from './utils';

package/lib/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfigData = exports.toTomlProfile = exports.toTomlConfig = exports.fromTomlProfile = exports.fromTomlConfig = exports.toClientOptions = exports.clientConfigToToml = exports.loadClientConfigFromToml = exports.loadClientConnectConfig = exports.loadClientConfigProfile = exports.loadClientConfig = void 0;
+var envconfig_1 = require("./envconfig");
+Object.defineProperty(exports, "loadClientConfig", { enumerable: true, get: function () { return envconfig_1.loadClientConfig; } });
+Object.defineProperty(exports, "loadClientConfigProfile", { enumerable: true, get: function () { return envconfig_1.loadClientConfigProfile; } });
+Object.defineProperty(exports, "loadClientConnectConfig", { enumerable: true, get: function () { return envconfig_1.loadClientConnectConfig; } });
+Object.defineProperty(exports, "loadClientConfigFromToml", { enumerable: true, get: function () { return envconfig_1.loadClientConfigFromToml; } });
+Object.defineProperty(exports, "clientConfigToToml", { enumerable: true, get: function () { return envconfig_1.clientConfigToToml; } });
+Object.defineProperty(exports, "toClientOptions", { enumerable: true, get: function () { return envconfig_1.toClientOptions; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "fromTomlConfig", { enumerable: true, get: function () { return utils_1.fromTomlConfig; } });
+Object.defineProperty(exports, "fromTomlProfile", { enumerable: true, get: function () { return utils_1.fromTomlProfile; } });
+Object.defineProperty(exports, "toTomlConfig", { enumerable: true, get: function () { return utils_1.toTomlConfig; } });
+Object.defineProperty(exports, "toTomlProfile", { enumerable: true, get: function () { return utils_1.toTomlProfile; } });
+Object.defineProperty(exports, "loadConfigData", { enumerable: true, get: function () { return utils_1.loadConfigData; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAOqB;AANnB,6GAAA,gBAAgB,OAAA;AAChB,oHAAA,uBAAuB,OAAA;AACvB,oHAAA,uBAAuB,OAAA;AACvB,qHAAA,wBAAwB,OAAA;AACxB,+GAAA,kBAAkB,OAAA;AAClB,4GAAA,eAAe,OAAA;AAajB,iCAAuG;AAA9F,uGAAA,cAAc,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,qGAAA,YAAY,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,uGAAA,cAAc,OAAA"}

package/lib/types.d.ts

@@ -0,0 +1,111 @@
+import type { NativeConnectionOptions } from '@temporalio/worker';
+/**
+ * A data source for configuration, which can be a path to a file,
+ * the string contents of a file, or raw bytes.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export type ConfigDataSource = {
+    path: string;
+} | {
+    data: string | Uint8Array;
+};
+/**
+ * TLS configuration as specified as part of client configuration.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export interface ClientConfigTLS {
+    disabled?: boolean;
+    serverName?: string;
+    clientCert?: ConfigDataSource;
+    clientKey?: ConfigDataSource;
+    serverCACert?: ConfigDataSource;
+}
+/**
+ * Configuration for connecting to a Temporal client, including connection options and namespace.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export interface ClientConnectConfig {
+    connectionOptions: NativeConnectionOptions;
+    namespace?: string;
+}
+/**
+ * Options for loading a client configuration profile.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export interface LoadClientProfileOptions {
+    /** The name of the profile to load from the config. Defaults to "default". */
+    profile?: string;
+    /**
+     * If present, this is used as the configuration source instead of default
+     * file locations. This can be a path to the file or the string/byte
+     * contents of the file.
+     */
+    configSource?: ConfigDataSource;
+    /**
+     * If true, file loading is disabled. This is only used when `configSource`
+     * is not present.
+     */
+    disableFile?: boolean;
+    /** If true, environment variable loading and overriding is disabled. */
+    disableEnv?: boolean;
+    /** If true, will error on unrecognized keys in the TOML file. */
+    configFileStrict?: boolean;
+    /**
+     * A dictionary of environment variables to use for loading and overrides.
+     * If not provided, the current process's environment is used.
+     */
+    overrideEnvVars?: Record<string, string>;
+}
+/**
+ * A client configuration profile with connection settings for a Temporal client.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export interface ClientConfigProfile {
+    address?: string;
+    namespace?: string;
+    apiKey?: string;
+    tls?: ClientConfigTLS;
+    grpcMeta?: Record<string, string>;
+}
+/**
+ * Options for loading client configuration.
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export interface LoadClientConfigOptions {
+    /**
+     * If present, this is used as the configuration source instead of default
+     * file locations. This can be a path or the string/byte contents of the
+     * configuration file.
+     */
+    configSource?: ConfigDataSource;
+    /** If true, will error on unrecognized keys in the TOML file. */
+    configFileStrict?: boolean;
+    /**
+     * The environment variables to use for locating the
+     * default config file. If not provided, the current process's
+     * environment is used to check for `TEMPORAL_CONFIG_FILE`.
+     */
+    overrideEnvVars?: Record<string, string>;
+}
+/**
+ * Client configuration represents a client config file.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export interface ClientConfig {
+    /** Map of profile name to its corresponding ClientConfigProfile. */
+    profiles: Record<string, ClientConfigProfile>;
+}
+/**
+ * Options for parsing client configuration from TOML format.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export interface ClientConfigFromTomlOptions {
+    strict: boolean;
+}

package/lib/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib/utils.d.ts

@@ -0,0 +1,48 @@
+import { ClientConfigProfile, ClientConfigTLS, ClientConfig, ConfigDataSource } from './types';
+import { TomlClientConfig, TomlClientConfigProfile, TomlClientConfigTLS } from './envconfig-toml';
+/**
+ * Loads configuration data from a {@link ConfigDataSource} and returns it as a Uint8Array.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export declare function loadConfigData(source?: ConfigDataSource): Uint8Array | undefined;
+/**
+ * Converts a TOML profile structure to a {@link ClientConfigProfile}.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export declare function fromTomlProfile(tomlProfile: TomlClientConfigProfile): ClientConfigProfile;
+/**
+ * Converts a {@link ClientConfigProfile} to a TOML profile structure.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export declare function toTomlProfile(profile: ClientConfigProfile): TomlClientConfigProfile;
+/**
+ * Converts a TOML TLS configuration structure to a {@link ClientConfigTLS}.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export declare function fromTomlTLS(tomlTLS?: TomlClientConfigTLS): ClientConfigTLS | undefined;
+/**
+ * Converts a {@link ClientConfigTLS} to a TOML TLS configuration structure.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export declare function toTomlTLS(tlsConfig?: ClientConfigTLS): TomlClientConfigTLS | undefined;
+/**
+ * Converts a TOML client configuration structure to a {@link ClientConfig}.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export declare function fromTomlConfig(tomlConfig: TomlClientConfig): ClientConfig;
+/**
+ * Converts a {@link ClientConfig} to a TOML client configuration structure.
+ *
+ * @experimental Environment configuration is new feature and subject to change.
+ */
+export declare function toTomlConfig(config: ClientConfig): TomlClientConfig;
+export declare function toPathAndData(source?: ConfigDataSource): {
+    path?: string;
+    data?: Uint8Array;
+} | undefined;