safe-env-getter 0.1.0

package/.devcontainer/devcontainer.json

@@ -0,0 +1,26 @@
+{
+  "name": "dev-safe-env-getter",
+  "image": "mcr.microsoft.com/devcontainers/base:bookworm",
+  "features": {
+    "ghcr.io/devcontainers/features/common-utils:2": {
+      "username": "developer",
+      "upgradePackages": true
+    },
+    "ghcr.io/devcontainers/features/git:1": {},
+    "ghcr.io/devcontainers/features/node:1": {
+      "version": "24"
+    }
+  },
+  "workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind",
+  "workspaceFolder": "/workspace",
+  "mounts": [
+    "target=/workspace/node_modules"
+  ],
+  "remoteUser": "developer",
+  "remoteEnv": {
+    "npm_config_loglevel": "error"
+  },
+  "postCreateCommand": {
+    "fixVolumePerms": "sudo chown -R $(whoami): /workspace"
+  }
+}

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,85 @@
+# Safe Env Getter
+
+[![npm version](https://img.shields.io/npm/v/safe-env-getter.svg)](https://www.npmjs.com/package/safe-env-getter)
+[![npm downloads](https://img.shields.io/npm/dm/safe-env-getter.svg)](https://www.npmjs.com/package/safe-env-getter)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+Type-safe environment variable getter for Node.js. Reads and parses `process.env` with a spec (string, number, boolean, enum), optional defaults, and clear errors when required variables are missing or invalid.
+
+## Features
+
+- **Typed specs**: `string`, `number`, `boolean`, and `enum` with TypeScript inference
+- **Optional defaults**: Fallback values when the variable is unset or empty
+- **Strict validation**: Throws with clear messages for missing or invalid values
+- **Boolean parsing**: Accepts `1`, `true`, `yes`, `on` (case-insensitive) as `true`
+- **Enum constraint**: Restricts values to a fixed set of choices
+
+## Installation
+
+**npm**
+
+```bash
+npm install safe-env-getter
+```
+
+**yarn**
+
+```bash
+yarn add safe-env-getter
+```
+
+## Usage
+
+```ts
+import { SafeEnvGetter, SafeEnvType } from 'safe-env-getter';
+
+// String (spec omitted → defaults to SafeEnvType.String; throws if missing)
+const nodeEnv = SafeEnvGetter.getEnv('NODE_ENV');
+
+// String with default (3rd arg: options)
+const logLevel = SafeEnvGetter.getEnv('LOG_LEVEL', SafeEnvType.String, { default: 'info' });
+
+// Number with default
+const port = SafeEnvGetter.getEnv('PORT', SafeEnvType.Number, { default: 3000 });
+
+// Boolean (parses 1/true/yes/on as true)
+const debug = SafeEnvGetter.getEnv('DEBUG', SafeEnvType.Boolean, { default: false });
+
+// Enum (required)
+const mode = SafeEnvGetter.getEnv('MODE', SafeEnvType.Enum(['read', 'write']));
+// Enum with default
+const modeWithDefault = SafeEnvGetter.getEnv('MODE', SafeEnvType.Enum(['read', 'write']), { default: 'read' });
+```
+
+## Options
+
+`SafeEnvGetter.getEnv(key, spec?, options?)` takes:
+
+| Argument | Required | Description |
+|----------|----------|-------------|
+| **key**  | Yes      | Environment variable name (e.g. `"PORT"`, `"NODE_ENV"`). |
+| **spec** | No       | Type spec; defaults to `SafeEnvType.String` when omitted. Use `SafeEnvType.String`, `SafeEnvType.Number`, `SafeEnvType.Boolean`, or `SafeEnvType.Enum(choices)`. |
+| **options** | No    | Optional object. Use `{ default: value }` to provide a fallback when the variable is missing or empty. |
+
+**Spec types:**
+
+| Spec | Shape | Description |
+|------|--------|-------------|
+| `string`  | `{ type: 'string' }` | Raw string value. |
+| `number`  | `{ type: 'number' }` | Parsed with `Number()`; throws if NaN. |
+| `boolean` | `{ type: 'boolean' }` | `1`/`true`/`yes`/`on` (case-insensitive) → `true`, else `false`. |
+| `enum`    | `{ type: 'enum', choices: readonly T[] }` | Value must be in `choices`; throws otherwise. |
+
+**Errors:**
+
+- If the variable is missing or empty and `options.default` is not set: `Missing required environment variable: <key>`.
+- For `number`, invalid values: `Env <key>: expected number, got "<raw>"`.
+- For `enum`, invalid values: `Env <key>: must be one of [choice1, choice2, ...]`.
+
+## Requirements
+
+- **Node.js** >= 20.0.0
+
+## License
+
+This project is licensed under the Apache-2.0 License.

package/lib/index.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Spec for a string environment variable.
+ * The default value is passed via the third argument of `getEnv`, not in the spec.
+ */
+export type SafeEnvTypeString = {
+    type: 'string';
+    default?: string;
+};
+/**
+ * Spec for a numeric environment variable.
+ * Values are parsed with `Number()`; invalid values throw.
+ * The default value is passed via the third argument of `getEnv`, not in the spec.
+ */
+export type SafeEnvTypeNumber = {
+    type: 'number';
+    default?: number;
+};
+/**
+ * Spec for a boolean environment variable.
+ * Parses `1`, `true`, `yes`, `on` (case-insensitive) as `true`; anything else as `false`.
+ * The default value is passed via the third argument of `getEnv`, not in the spec.
+ */
+export type SafeEnvTypeBoolean = {
+    type: 'boolean';
+    default?: boolean;
+};
+/**
+ * Spec for an enum environment variable with a fixed set of choices.
+ * The value must be one of `choices`; otherwise an error is thrown.
+ * The default value is passed via the third argument of `getEnv`, not in the spec.
+ *
+ * @template T - Literal string union of allowed values.
+ */
+export type SafeEnvTypeEnum<T extends string = string> = {
+    type: 'enum';
+    choices: readonly T[];
+    default?: T;
+};
+/** Union of all environment variable spec types. */
+export type SafeEnvSpec = SafeEnvTypeString | SafeEnvTypeNumber | SafeEnvTypeBoolean | SafeEnvTypeEnum;
+/**
+ * Predefined spec constants for use as the second argument to `getEnv`.
+ * Use the third argument `options: { default: value }` to provide a fallback when the variable is missing.
+ */
+export declare const SafeEnvType: {
+    /** Spec for a string value. */
+    readonly String: {
+        readonly type: "string";
+    };
+    /** Spec for a numeric value. */
+    readonly Number: {
+        readonly type: "number";
+    };
+    /** Spec for a boolean value (1/true/yes/on → true). */
+    readonly Boolean: {
+        readonly type: "boolean";
+    };
+    /**
+     * Returns a spec that restricts the value to one of the given choices.
+     * @param choices - Allowed string literals.
+     * @returns Enum spec for use with `getEnv`.
+     */
+    readonly Enum: <T extends string>(choices: readonly T[]) => SafeEnvTypeEnum<T>;
+};
+/**
+ * Infers the return type from the given spec.
+ * @template S - A `SafeEnvSpec` variant.
+ */
+export type SafeEnvSpecToType<S> = S extends SafeEnvTypeString ? string : S extends SafeEnvTypeNumber ? number : S extends SafeEnvTypeBoolean ? boolean : S extends SafeEnvTypeEnum<infer T> ? T : never;
+/**
+ * Reads and parses an environment variable according to the given spec.
+ * If the variable is missing or empty and no default is provided in `options`, throws an error.
+ *
+ * @param key - Environment variable name (e.g. `"PORT"`, `"NODE_ENV"`).
+ * @param spec - Type spec; defaults to `SafeEnvType.String` when omitted.
+ * @param options - Optional. Use `{ default: value }` to provide a fallback when the variable is missing.
+ * @returns Parsed value with type inferred from `spec`.
+ * @throws {Error} When the variable is missing and `options.default` is not set.
+ * @throws {Error} When `spec.type` is `"number"` and the value is not a valid number.
+ * @throws {Error} When `spec.type` is `"enum"` and the value is not in `spec.choices`.
+ */
+declare function getEnv<K extends string, S extends SafeEnvSpec = SafeEnvTypeString>(key: K, spec?: S, options?: {
+    default?: SafeEnvSpecToType<S>;
+}): SafeEnvSpecToType<S>;
+/**
+ * Safe environment variable getter.
+ * Use `SafeEnvGetter.getEnv(key, spec?, options?)` to read and parse environment variables with type safety.
+ */
+export declare const SafeEnvGetter: {
+    readonly getEnv: typeof getEnv;
+};
+export {};

package/lib/index.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafeEnvGetter = exports.SafeEnvType = void 0;
+/**
+ * Predefined spec constants for use as the second argument to `getEnv`.
+ * Use the third argument `options: { default: value }` to provide a fallback when the variable is missing.
+ */
+exports.SafeEnvType = {
+    /** Spec for a string value. */
+    String: { type: 'string' },
+    /** Spec for a numeric value. */
+    Number: { type: 'number' },
+    /** Spec for a boolean value (1/true/yes/on → true). */
+    Boolean: { type: 'boolean' },
+    /**
+     * Returns a spec that restricts the value to one of the given choices.
+     * @param choices - Allowed string literals.
+     * @returns Enum spec for use with `getEnv`.
+     */
+    Enum: (choices) => ({ type: 'enum', choices }),
+};
+/**
+ * Reads and parses an environment variable according to the given spec.
+ * If the variable is missing or empty and no default is provided in `options`, throws an error.
+ *
+ * @param key - Environment variable name (e.g. `"PORT"`, `"NODE_ENV"`).
+ * @param spec - Type spec; defaults to `SafeEnvType.String` when omitted.
+ * @param options - Optional. Use `{ default: value }` to provide a fallback when the variable is missing.
+ * @returns Parsed value with type inferred from `spec`.
+ * @throws {Error} When the variable is missing and `options.default` is not set.
+ * @throws {Error} When `spec.type` is `"number"` and the value is not a valid number.
+ * @throws {Error} When `spec.type` is `"enum"` and the value is not in `spec.choices`.
+ */
+function getEnv(key, spec = exports.SafeEnvType.String, options) {
+    const raw = process.env[key];
+    const defaultValue = options?.default;
+    const hasDefault = defaultValue !== undefined;
+    if (raw == null || raw === '') {
+        if (!hasDefault)
+            throw new Error(`Missing required environment variable: ${key}`);
+        return defaultValue;
+    }
+    switch (spec.type) {
+        case 'number': {
+            const n = Number(raw);
+            if (Number.isNaN(n))
+                throw new Error(`Env ${key}: expected number, got "${raw}"`);
+            return n;
+        }
+        case 'boolean':
+            return (/^(1|true|yes|on)$/i.test(raw) ? true : false);
+        case 'enum':
+            if (!spec.choices.includes(raw))
+                throw new Error(`Env ${key}: must be one of [${spec.choices.join(', ')}]`);
+            return raw;
+        default:
+            return raw;
+    }
+}
+/**
+ * Safe environment variable getter.
+ * Use `SafeEnvGetter.getEnv(key, spec?, options?)` to read and parse environment variables with type safety.
+ */
+exports.SafeEnvGetter = {
+    getEnv,
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBb0NBOzs7R0FHRztBQUNVLFFBQUEsV0FBVyxHQUFHO0lBQ3pCLCtCQUErQjtJQUMvQixNQUFNLEVBQUUsRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUF1QztJQUMvRCxnQ0FBZ0M7SUFDaEMsTUFBTSxFQUFFLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBdUM7SUFDL0QsdURBQXVEO0lBQ3ZELE9BQU8sRUFBRSxFQUFFLElBQUksRUFBRSxTQUFTLEVBQXdDO0lBQ2xFOzs7O09BSUc7SUFDSCxJQUFJLEVBQUUsQ0FBbUIsT0FBcUIsRUFBRSxFQUFFLENBQUMsQ0FBQyxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUUsT0FBTyxFQUFFLENBQXVCO0NBQzVGLENBQUM7QUFhWDs7Ozs7Ozs7Ozs7R0FXRztBQUNILFNBQVMsTUFBTSxDQUNiLEdBQU0sRUFDTixPQUFVLG1CQUFXLENBQUMsTUFBVyxFQUNqQyxPQUE0QztJQUU1QyxNQUFNLEdBQUcsR0FBRyxPQUFPLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQzdCLE1BQU0sWUFBWSxHQUFHLE9BQU8sRUFBRSxPQUFPLENBQUM7SUFDdEMsTUFBTSxVQUFVLEdBQUcsWUFBWSxLQUFLLFNBQVMsQ0FBQztJQUU5QyxJQUFJLEdBQUcsSUFBSSxJQUFJLElBQUksR0FBRyxLQUFLLEVBQUUsRUFBRSxDQUFDO1FBQzlCLElBQUksQ0FBQyxVQUFVO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQywwQ0FBMEMsR0FBRyxFQUFFLENBQUMsQ0FBQztRQUNsRixPQUFPLFlBQW9DLENBQUM7SUFDOUMsQ0FBQztJQUVELFFBQVEsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO1FBQ2xCLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQztZQUNkLE1BQU0sQ0FBQyxHQUFHLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQztZQUN0QixJQUFJLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO2dCQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsT0FBTyxHQUFHLDJCQUEyQixHQUFHLEdBQUcsQ0FBQyxDQUFDO1lBQ2xGLE9BQU8sQ0FBeUIsQ0FBQztRQUNuQyxDQUFDO1FBQ0QsS0FBSyxTQUFTO1lBQ1osT0FBTyxDQUFDLG9CQUFvQixDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQXlCLENBQUM7UUFDakYsS0FBSyxNQUFNO1lBQ1QsSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQztnQkFBRSxNQUFNLElBQUksS0FBSyxDQUFDLE9BQU8sR0FBRyxxQkFBcUIsSUFBSSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1lBQzVHLE9BQU8sR0FBMkIsQ0FBQztRQUNyQztZQUNFLE9BQU8sR0FBMkIsQ0FBQztJQUN2QyxDQUFDO0FBQ0gsQ0FBQztBQUVEOzs7R0FHRztBQUNVLFFBQUEsYUFBYSxHQUFHO0lBQzNCLE1BQU07Q0FDRSxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBTcGVjIGZvciBhIHN0cmluZyBlbnZpcm9ubWVudCB2YXJpYWJsZS5cbiAqIFRoZSBkZWZhdWx0IHZhbHVlIGlzIHBhc3NlZCB2aWEgdGhlIHRoaXJkIGFyZ3VtZW50IG9mIGBnZXRFbnZgLCBub3QgaW4gdGhlIHNwZWMuXG4gKi9cbmV4cG9ydCB0eXBlIFNhZmVFbnZUeXBlU3RyaW5nID0geyB0eXBlOiAnc3RyaW5nJzsgZGVmYXVsdD86IHN0cmluZyB9O1xuXG4vKipcbiAqIFNwZWMgZm9yIGEgbnVtZXJpYyBlbnZpcm9ubWVudCB2YXJpYWJsZS5cbiAqIFZhbHVlcyBhcmUgcGFyc2VkIHdpdGggYE51bWJlcigpYDsgaW52YWxpZCB2YWx1ZXMgdGhyb3cuXG4gKiBUaGUgZGVmYXVsdCB2YWx1ZSBpcyBwYXNzZWQgdmlhIHRoZSB0aGlyZCBhcmd1bWVudCBvZiBgZ2V0RW52YCwgbm90IGluIHRoZSBzcGVjLlxuICovXG5leHBvcnQgdHlwZSBTYWZlRW52VHlwZU51bWJlciA9IHsgdHlwZTogJ251bWJlcic7IGRlZmF1bHQ/OiBudW1iZXIgfTtcblxuLyoqXG4gKiBTcGVjIGZvciBhIGJvb2xlYW4gZW52aXJvbm1lbnQgdmFyaWFibGUuXG4gKiBQYXJzZXMgYDFgLCBgdHJ1ZWAsIGB5ZXNgLCBgb25gIChjYXNlLWluc2Vuc2l0aXZlKSBhcyBgdHJ1ZWA7IGFueXRoaW5nIGVsc2UgYXMgYGZhbHNlYC5cbiAqIFRoZSBkZWZhdWx0IHZhbHVlIGlzIHBhc3NlZCB2aWEgdGhlIHRoaXJkIGFyZ3VtZW50IG9mIGBnZXRFbnZgLCBub3QgaW4gdGhlIHNwZWMuXG4gKi9cbmV4cG9ydCB0eXBlIFNhZmVFbnZUeXBlQm9vbGVhbiA9IHsgdHlwZTogJ2Jvb2xlYW4nOyBkZWZhdWx0PzogYm9vbGVhbiB9O1xuXG4vKipcbiAqIFNwZWMgZm9yIGFuIGVudW0gZW52aXJvbm1lbnQgdmFyaWFibGUgd2l0aCBhIGZpeGVkIHNldCBvZiBjaG9pY2VzLlxuICogVGhlIHZhbHVlIG11c3QgYmUgb25lIG9mIGBjaG9pY2VzYDsgb3RoZXJ3aXNlIGFuIGVycm9yIGlzIHRocm93bi5cbiAqIFRoZSBkZWZhdWx0IHZhbHVlIGlzIHBhc3NlZCB2aWEgdGhlIHRoaXJkIGFyZ3VtZW50IG9mIGBnZXRFbnZgLCBub3QgaW4gdGhlIHNwZWMuXG4gKlxuICogQHRlbXBsYXRlIFQgLSBMaXRlcmFsIHN0cmluZyB1bmlvbiBvZiBhbGxvd2VkIHZhbHVlcy5cbiAqL1xuZXhwb3J0IHR5cGUgU2FmZUVudlR5cGVFbnVtPFQgZXh0ZW5kcyBzdHJpbmcgPSBzdHJpbmc+ID0geyB0eXBlOiAnZW51bSc7IGNob2ljZXM6IHJlYWRvbmx5IFRbXTsgZGVmYXVsdD86IFQgfTtcblxuLyoqIFVuaW9uIG9mIGFsbCBlbnZpcm9ubWVudCB2YXJpYWJsZSBzcGVjIHR5cGVzLiAqL1xuZXhwb3J0IHR5cGUgU2FmZUVudlNwZWMgPVxuICB8IFNhZmVFbnZUeXBlU3RyaW5nXG4gIHwgU2FmZUVudlR5cGVOdW1iZXJcbiAgfCBTYWZlRW52VHlwZUJvb2xlYW5cbiAgfCBTYWZlRW52VHlwZUVudW07XG5cbi8qKlxuICogUHJlZGVmaW5lZCBzcGVjIGNvbnN0YW50cyBmb3IgdXNlIGFzIHRoZSBzZWNvbmQgYXJndW1lbnQgdG8gYGdldEVudmAuXG4gKiBVc2UgdGhlIHRoaXJkIGFyZ3VtZW50IGBvcHRpb25zOiB7IGRlZmF1bHQ6IHZhbHVlIH1gIHRvIHByb3ZpZGUgYSBmYWxsYmFjayB3aGVuIHRoZSB2YXJpYWJsZSBpcyBtaXNzaW5nLlxuICovXG5leHBvcnQgY29uc3QgU2FmZUVudlR5cGUgPSB7XG4gIC8qKiBTcGVjIGZvciBhIHN0cmluZyB2YWx1ZS4gKi9cbiAgU3RyaW5nOiB7IHR5cGU6ICdzdHJpbmcnIH0gYXMgY29uc3Qgc2F0aXNmaWVzIFNhZmVFbnZUeXBlU3RyaW5nLFxuICAvKiogU3BlYyBmb3IgYSBudW1lcmljIHZhbHVlLiAqL1xuICBOdW1iZXI6IHsgdHlwZTogJ251bWJlcicgfSBhcyBjb25zdCBzYXRpc2ZpZXMgU2FmZUVudlR5cGVOdW1iZXIsXG4gIC8qKiBTcGVjIGZvciBhIGJvb2xlYW4gdmFsdWUgKDEvdHJ1ZS95ZXMvb24g4oaSIHRydWUpLiAqL1xuICBCb29sZWFuOiB7IHR5cGU6ICdib29sZWFuJyB9IGFzIGNvbnN0IHNhdGlzZmllcyBTYWZlRW52VHlwZUJvb2xlYW4sXG4gIC8qKlxuICAgKiBSZXR1cm5zIGEgc3BlYyB0aGF0IHJlc3RyaWN0cyB0aGUgdmFsdWUgdG8gb25lIG9mIHRoZSBnaXZlbiBjaG9pY2VzLlxuICAgKiBAcGFyYW0gY2hvaWNlcyAtIEFsbG93ZWQgc3RyaW5nIGxpdGVyYWxzLlxuICAgKiBAcmV0dXJucyBFbnVtIHNwZWMgZm9yIHVzZSB3aXRoIGBnZXRFbnZgLlxuICAgKi9cbiAgRW51bTogPFQgZXh0ZW5kcyBzdHJpbmc+KGNob2ljZXM6IHJlYWRvbmx5IFRbXSkgPT4gKHsgdHlwZTogJ2VudW0nLCBjaG9pY2VzIH0pIGFzIFNhZmVFbnZUeXBlRW51bTxUPixcbn0gYXMgY29uc3Q7XG5cbi8qKlxuICogSW5mZXJzIHRoZSByZXR1cm4gdHlwZSBmcm9tIHRoZSBnaXZlbiBzcGVjLlxuICogQHRlbXBsYXRlIFMgLSBBIGBTYWZlRW52U3BlY2AgdmFyaWFudC5cbiAqL1xuZXhwb3J0IHR5cGUgU2FmZUVudlNwZWNUb1R5cGU8Uz4gPVxuICBTIGV4dGVuZHMgU2FmZUVudlR5cGVTdHJpbmcgPyBzdHJpbmdcbiAgICA6IFMgZXh0ZW5kcyBTYWZlRW52VHlwZU51bWJlciA/IG51bWJlclxuICAgICAgOiBTIGV4dGVuZHMgU2FmZUVudlR5cGVCb29sZWFuID8gYm9vbGVhblxuICAgICAgICA6IFMgZXh0ZW5kcyBTYWZlRW52VHlwZUVudW08aW5mZXIgVD4gPyBUXG4gICAgICAgICAgOiBuZXZlcjtcblxuLyoqXG4gKiBSZWFkcyBhbmQgcGFyc2VzIGFuIGVudmlyb25tZW50IHZhcmlhYmxlIGFjY29yZGluZyB0byB0aGUgZ2l2ZW4gc3BlYy5cbiAqIElmIHRoZSB2YXJpYWJsZSBpcyBtaXNzaW5nIG9yIGVtcHR5IGFuZCBubyBkZWZhdWx0IGlzIHByb3ZpZGVkIGluIGBvcHRpb25zYCwgdGhyb3dzIGFuIGVycm9yLlxuICpcbiAqIEBwYXJhbSBrZXkgLSBFbnZpcm9ubWVudCB2YXJpYWJsZSBuYW1lIChlLmcuIGBcIlBPUlRcImAsIGBcIk5PREVfRU5WXCJgKS5cbiAqIEBwYXJhbSBzcGVjIC0gVHlwZSBzcGVjOyBkZWZhdWx0cyB0byBgU2FmZUVudlR5cGUuU3RyaW5nYCB3aGVuIG9taXR0ZWQuXG4gKiBAcGFyYW0gb3B0aW9ucyAtIE9wdGlvbmFsLiBVc2UgYHsgZGVmYXVsdDogdmFsdWUgfWAgdG8gcHJvdmlkZSBhIGZhbGxiYWNrIHdoZW4gdGhlIHZhcmlhYmxlIGlzIG1pc3NpbmcuXG4gKiBAcmV0dXJucyBQYXJzZWQgdmFsdWUgd2l0aCB0eXBlIGluZmVycmVkIGZyb20gYHNwZWNgLlxuICogQHRocm93cyB7RXJyb3J9IFdoZW4gdGhlIHZhcmlhYmxlIGlzIG1pc3NpbmcgYW5kIGBvcHRpb25zLmRlZmF1bHRgIGlzIG5vdCBzZXQuXG4gKiBAdGhyb3dzIHtFcnJvcn0gV2hlbiBgc3BlYy50eXBlYCBpcyBgXCJudW1iZXJcImAgYW5kIHRoZSB2YWx1ZSBpcyBub3QgYSB2YWxpZCBudW1iZXIuXG4gKiBAdGhyb3dzIHtFcnJvcn0gV2hlbiBgc3BlYy50eXBlYCBpcyBgXCJlbnVtXCJgIGFuZCB0aGUgdmFsdWUgaXMgbm90IGluIGBzcGVjLmNob2ljZXNgLlxuICovXG5mdW5jdGlvbiBnZXRFbnY8SyBleHRlbmRzIHN0cmluZywgUyBleHRlbmRzIFNhZmVFbnZTcGVjID0gU2FmZUVudlR5cGVTdHJpbmc+KFxuICBrZXk6IEssXG4gIHNwZWM6IFMgPSBTYWZlRW52VHlwZS5TdHJpbmcgYXMgUyxcbiAgb3B0aW9ucz86IHsgZGVmYXVsdD86IFNhZmVFbnZTcGVjVG9UeXBlPFM+IH0sXG4pOiBTYWZlRW52U3BlY1RvVHlwZTxTPiB7XG4gIGNvbnN0IHJhdyA9IHByb2Nlc3MuZW52W2tleV07XG4gIGNvbnN0IGRlZmF1bHRWYWx1ZSA9IG9wdGlvbnM/LmRlZmF1bHQ7XG4gIGNvbnN0IGhhc0RlZmF1bHQgPSBkZWZhdWx0VmFsdWUgIT09IHVuZGVmaW5lZDtcblxuICBpZiAocmF3ID09IG51bGwgfHwgcmF3ID09PSAnJykge1xuICAgIGlmICghaGFzRGVmYXVsdCkgdGhyb3cgbmV3IEVycm9yKGBNaXNzaW5nIHJlcXVpcmVkIGVudmlyb25tZW50IHZhcmlhYmxlOiAke2tleX1gKTtcbiAgICByZXR1cm4gZGVmYXVsdFZhbHVlIGFzIFNhZmVFbnZTcGVjVG9UeXBlPFM+O1xuICB9XG5cbiAgc3dpdGNoIChzcGVjLnR5cGUpIHtcbiAgICBjYXNlICdudW1iZXInOiB7XG4gICAgICBjb25zdCBuID0gTnVtYmVyKHJhdyk7XG4gICAgICBpZiAoTnVtYmVyLmlzTmFOKG4pKSB0aHJvdyBuZXcgRXJyb3IoYEVudiAke2tleX06IGV4cGVjdGVkIG51bWJlciwgZ290IFwiJHtyYXd9XCJgKTtcbiAgICAgIHJldHVybiBuIGFzIFNhZmVFbnZTcGVjVG9UeXBlPFM+O1xuICAgIH1cbiAgICBjYXNlICdib29sZWFuJzpcbiAgICAgIHJldHVybiAoL14oMXx0cnVlfHllc3xvbikkL2kudGVzdChyYXcpID8gdHJ1ZSA6IGZhbHNlKSBhcyBTYWZlRW52U3BlY1RvVHlwZTxTPjtcbiAgICBjYXNlICdlbnVtJzpcbiAgICAgIGlmICghc3BlYy5jaG9pY2VzLmluY2x1ZGVzKHJhdykpIHRocm93IG5ldyBFcnJvcihgRW52ICR7a2V5fTogbXVzdCBiZSBvbmUgb2YgWyR7c3BlYy5jaG9pY2VzLmpvaW4oJywgJyl9XWApO1xuICAgICAgcmV0dXJuIHJhdyBhcyBTYWZlRW52U3BlY1RvVHlwZTxTPjtcbiAgICBkZWZhdWx0OlxuICAgICAgcmV0dXJuIHJhdyBhcyBTYWZlRW52U3BlY1RvVHlwZTxTPjtcbiAgfVxufVxuXG4vKipcbiAqIFNhZmUgZW52aXJvbm1lbnQgdmFyaWFibGUgZ2V0dGVyLlxuICogVXNlIGBTYWZlRW52R2V0dGVyLmdldEVudihrZXksIHNwZWM/LCBvcHRpb25zPylgIHRvIHJlYWQgYW5kIHBhcnNlIGVudmlyb25tZW50IHZhcmlhYmxlcyB3aXRoIHR5cGUgc2FmZXR5LlxuICovXG5leHBvcnQgY29uc3QgU2FmZUVudkdldHRlciA9IHtcbiAgZ2V0RW52LFxufSBhcyBjb25zdDsiXX0=

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "safe-env-getter",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gammarers-labs/safe-env-getter.git"
+  },
+  "scripts": {
+    "build": "npx projen build",
+    "bump": "npx projen bump",
+    "clobber": "npx projen clobber",
+    "compile": "npx projen compile",
+    "default": "npx projen default",
+    "eject": "npx projen eject",
+    "eslint": "npx projen eslint",
+    "package": "npx projen package",
+    "post-compile": "npx projen post-compile",
+    "post-upgrade": "npx projen post-upgrade",
+    "pre-compile": "npx projen pre-compile",
+    "release": "npx projen release",
+    "test": "npx projen test",
+    "test:watch": "npx projen test:watch",
+    "unbump": "npx projen unbump",
+    "upgrade": "npx projen upgrade",
+    "watch": "npx projen watch",
+    "projen": "npx projen"
+  },
+  "author": {
+    "name": "yicr",
+    "email": "yicr@users.noreply.github.com",
+    "organization": false
+  },
+  "devDependencies": {
+    "@stylistic/eslint-plugin": "^2",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20",
+    "@typescript-eslint/eslint-plugin": "^8",
+    "@typescript-eslint/parser": "^8",
+    "commit-and-tag-version": "^12",
+    "constructs": "^10.0.0",
+    "eslint": "^9",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "jest": "^30.2.0",
+    "jest-junit": "^16",
+    "projen": "^0.99.15",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript": "5.9.x"
+  },
+  "engines": {
+    "node": ">= 20.0.0"
+  },
+  "main": "lib/index.js",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.1.0",
+  "jest": {
+    "coverageProvider": "v8",
+    "testMatch": [
+      "<rootDir>/@(src|test)/**/*(*.)@(spec|test).ts?(x)",
+      "<rootDir>/@(src|test)/**/__tests__/**/*.ts?(x)",
+      "<rootDir>/@(projenrc)/**/*(*.)@(spec|test).ts?(x)",
+      "<rootDir>/@(projenrc)/**/__tests__/**/*.ts?(x)"
+    ],
+    "clearMocks": true,
+    "collectCoverage": true,
+    "coverageReporters": [
+      "json",
+      "lcov",
+      "clover",
+      "cobertura",
+      "text"
+    ],
+    "coverageDirectory": "coverage",
+    "coveragePathIgnorePatterns": [
+      "/node_modules/"
+    ],
+    "testPathIgnorePatterns": [
+      "/node_modules/"
+    ],
+    "watchPathIgnorePatterns": [
+      "/node_modules/"
+    ],
+    "reporters": [
+      "default",
+      [
+        "jest-junit",
+        {
+          "outputDirectory": "test-reports"
+        }
+      ]
+    ],
+    "transform": {
+      "^.+\\.[t]sx?$": [
+        "ts-jest",
+        {
+          "tsconfig": "tsconfig.dev.json"
+        }
+      ]
+    }
+  },
+  "types": "lib/index.d.ts",
+  "//": "~~ Generated by projen. To modify, edit .projenrc.ts and run \"npx projen\"."
+}