/**
 * @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