@bouko/ts 0.2.1 → 0.2.3

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import type { JsonMap, JsonValue } from "./types/generic";
 export * from "./types/generic";
 export * from "./types/work";
 export * from "./utils/checkers";
+export * from "./utils/env";
 export * from "./utils/formatters";
 export * from "./utils/parsers";
 export declare const safely: <T>(action: () => T) => T | undefined;

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from "./types/generic";
 export * from "./types/work";
 export * from "./utils/checkers";
+export * from "./utils/env";
 export * from "./utils/formatters";
 export * from "./utils/parsers";
 export const safely = (action) => {

package/dist/types/generic.d.ts

@@ -6,7 +6,7 @@
  * - `JsonValue`: Union type representing a valid JSON value.
  *
  * They are intended to facilitate type-safe handling
- * of generic objects (ex. forms)
+ * of generic objects (ex. forms).
 **/
 export declare type StringMap = Record<string, string>;
 export declare type JsonMap = {

package/dist/types/generic.js

@@ -6,7 +6,7 @@
  * - `JsonValue`: Union type representing a valid JSON value.
  *
  * They are intended to facilitate type-safe handling
- * of generic objects (ex. forms)
+ * of generic objects (ex. forms).
 **/
 export {};
 // clean

package/dist/utils/env.d.ts

@@ -0,0 +1,5 @@
+export declare function getEnv(key: string): string;
+export declare function getEnv(key: string, fallback: string): string;
+export declare function getEnv(key: string, fallback: number): number;
+export declare function getEnv(key: string, fallback: boolean): boolean;
+export declare function getEnv<T>(key: string): T;

package/dist/utils/env.js

@@ -0,0 +1,23 @@
+import { parseStr } from "./parsers";
+/**
+ * Retrieves and parses an environment variable.
+ *
+ * @param key - The variable name
+ * @param fallback - Backup if no value is found (optional)
+ *
+ * @returns {JsonValue} The value parsed based on whichever
+ * primitive type the string matches.
+ *
+ * @throws {Error} If the variable is not found in the
+ * environment and there is no fallback set.
+**/
+export function getEnv(key, fallback) {
+    const raw = process.env[key];
+    if (!raw || raw === "") {
+        if (fallback !== undefined)
+            return fallback;
+        throw new Error(`ENV Missing: '${key}'`);
+    }
+    return parseStr(raw);
+}
+// clean

package/package.json

@@ -1,7 +1,7 @@
 {
 
   "name": "@bouko/ts",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "license": "MIT",