66 lines
1.7 KiB
JavaScript
66 lines
1.7 KiB
JavaScript
/**
|
|
* @file Utility functions for working with environment variables.
|
|
*/
|
|
/// <reference types="./types/global.js" />
|
|
|
|
//#region Constants
|
|
|
|
/**
|
|
* The current Node.js environment, defaulting to "development" when not set.
|
|
*
|
|
* Note, this should only be used during the build process.
|
|
*
|
|
* If you need to check the environment at runtime, use `process.env.NODE_ENV` to
|
|
* ensure that module tree-shaking works correctly.
|
|
*
|
|
*/
|
|
export const NodeEnvironment = process.env.NODE_ENV || "development";
|
|
|
|
/**
|
|
* A source environment variable, which can be a string, number, boolean, null, or undefined.
|
|
* @typedef {string | number | boolean | null | undefined} EnvironmentVariable
|
|
*/
|
|
|
|
/**
|
|
* A type helper for serializing environment variables.
|
|
*
|
|
* @template {EnvironmentVariable} T
|
|
* @typedef {T extends string ? `"${T}"` : T} JSONify
|
|
*/
|
|
|
|
//#endregion
|
|
|
|
//#region Utilities
|
|
|
|
/**
|
|
* Given an object of environment variables, returns a new object with the same keys and values, but
|
|
* with the values serialized as strings.
|
|
*
|
|
* @template {Record<string, EnvironmentVariable>} EnvRecord
|
|
* @template {string} [Prefix='import.meta.env.']
|
|
*
|
|
* @param {EnvRecord} input
|
|
* @param {Prefix} [prefix='import.meta.env.']
|
|
*
|
|
* @returns {{[K in keyof EnvRecord as `${Prefix}${K}`]: JSONify<EnvRecord[K]>}}
|
|
*/
|
|
export function serializeEnvironmentVars(
|
|
input,
|
|
prefix = /** @type {Prefix} */ ("import.meta.env."),
|
|
) {
|
|
/**
|
|
* @type {Record<string, string>}
|
|
*/
|
|
const env = {};
|
|
|
|
for (const [key, value] of Object.entries(input)) {
|
|
const namespaceKey = prefix + key;
|
|
|
|
env[namespaceKey] = JSON.stringify(value || "");
|
|
}
|
|
|
|
return /** @type {any} */ (env);
|
|
}
|
|
|
|
//#endregion
|