strict-env-resolver 0.5.1

package/.devcontainer/devcontainer.json

@@ -0,0 +1,26 @@
+{
+  "name": "dev-strict-env-resolver",
+  "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,188 @@
+# Strict Env Resolver
+
+[![npm version](https://img.shields.io/npm/v/strict-env-resolver.svg)](https://www.npmjs.com/package/strict-env-resolver)
+[![npm downloads](https://img.shields.io/npm/dm/strict-env-resolver.svg)](https://www.npmjs.com/package/strict-env-resolver)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+Type-safe environment variable resolver for Node.js. Reads and parses `process.env` with specs (`string`, `number`, `boolean`, `enum`), optional defaults, configurable trimming, and structured validation errors when values are missing or invalid.
+
+## Features
+
+- **Typed specs**: `string`, `number`, `boolean`, and `enum` with TypeScript inference
+- **Finite numbers**: `StrictEnvType.Number` parses any finite numeric value (`Number()`); rejects `NaN` and `Infinity`
+- **Optional defaults**: Fallback when a variable is unset, empty (`""`), or whitespace-only (when trimming is enabled)
+- **Configurable trim**: `trim` defaults to `true` for parsed types and `false` for strings; override per variable
+- **Batch parsing**: `resolveAll()` evaluates every key and throws once with all validation errors
+- **Structured errors**: `StrictEnvValidationError` exposes `errors` (`key`, `message`, `raw`, `kind`) and `keys`
+- **Boolean parsing**: `1`, `true`, `yes`, `on` (case-insensitive, after trim) → `true`; any other non-empty value → `false`
+- **Enum constraint**: Values must match one of the allowed choices (compared after trim)
+
+## Installation
+
+**npm**
+
+```bash
+npm install strict-env-resolver
+```
+
+**yarn**
+
+```bash
+yarn add strict-env-resolver
+```
+
+## Usage
+
+```ts
+import {
+  StrictEnvResolver,
+  StrictEnvError,
+  StrictEnvValidationError,
+  StrictEnvType,
+} from 'strict-env-resolver';
+
+// String (spec omitted → StrictEnvType.String; throws if missing)
+const nodeEnv = StrictEnvResolver.resolve('NODE_ENV');
+
+// String with default (used when unset or empty)
+const logLevel = StrictEnvResolver.resolve('LOG_LEVEL', StrictEnvType.String, { default: 'info' });
+
+// Trim strings and treat whitespace-only as missing
+const trimmedLogLevel = StrictEnvResolver.resolve('LOG_LEVEL', StrictEnvType.String, {
+  trim: true,
+  default: 'info',
+});
+
+// Number (e.g. port, ratio, timeout)
+const port = StrictEnvResolver.resolve('PORT', StrictEnvType.Number, { default: 3000 });
+// Valid: "42", "-1", "3.14", "1e5", "+42", "0x10", "  42  " (trimmed)
+// Missing: "", "   " (whitespace-only, trim default true)
+// Invalid: "Infinity", "NaN", "not-a-number"
+
+// Boolean (1/true/yes/on → true after trim; other non-empty values → false)
+const debug = StrictEnvResolver.resolve('DEBUG', StrictEnvType.Boolean, { default: false });
+// " true " → true
+
+// Enum (value must be in choices, compared after trim)
+const mode = StrictEnvResolver.resolve('MODE', StrictEnvType.Enum(['read', 'write'] as const));
+const modeWithDefault = StrictEnvResolver.resolve(
+  'MODE',
+  StrictEnvType.Enum(['read', 'write'] as const),
+  { default: 'read' },
+);
+
+// Read multiple env vars at once (collects all errors, then throws once)
+const envs = StrictEnvResolver.resolveAll({
+  PORT: [StrictEnvType.Number, { default: 3000 }],
+  DEBUG: [StrictEnvType.Boolean, { default: false }],
+  MODE: StrictEnvType.Enum(['read', 'write'] as const),
+  LOG_LEVEL: [StrictEnvType.String, { trim: true, default: 'info' }],
+});
+
+// Handle structured validation errors
+try {
+  StrictEnvResolver.resolveAll({
+    PORT: StrictEnvType.Number,
+    MODE: StrictEnvType.Enum(['read', 'write'] as const),
+  });
+} catch (e) {
+  if (e instanceof StrictEnvValidationError) {
+    // e.errors: [{ key, message, raw?, kind }, ...]
+    // e.keys:  ['PORT', 'MODE', ...]
+    // kind: 'missing' | 'invalid_number' | 'invalid_enum'
+    console.error(e.errors);
+  } else if (e instanceof StrictEnvError) {
+    // Other package errors
+  }
+  throw e;
+}
+```
+
+## Options
+
+### `StrictEnvResolver.resolve(key, spec?, options?)`
+
+| Argument | Required | Description |
+|----------|----------|-------------|
+| **key** | Yes | Environment variable name (e.g. `"PORT"`, `"NODE_ENV"`). |
+| **spec** | No | Type spec; defaults to `StrictEnvType.String`. Use `StrictEnvType.String`, `StrictEnvType.Number`, `StrictEnvType.Boolean`, or `StrictEnvType.Enum(choices)`. |
+| **options** | No | See [`StrictEnvOptions`](#strictenvoptions) below. |
+
+### `StrictEnvResolver.resolveAll(schema)`
+
+`schema` is an object where each key is an env var name and each value is either:
+
+- A spec (e.g. `StrictEnvType.Number`)
+- A tuple `[spec, options]` (e.g. `[StrictEnvType.Number, { default: 3000, trim: true }]`)
+
+Evaluates every entry in `schema`. If any value is missing, empty without a default, whitespace-only without a default (when trimming is enabled), or invalid, throws a single `StrictEnvValidationError` containing all issues.
+
+### `StrictEnvOptions`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| **default** | Spec-dependent | Fallback when the variable is unset, empty (`""`), or whitespace-only (when `trim` is enabled). |
+| **trim** | `boolean` | Trims leading/trailing whitespace before validation. Defaults to `true` for `number`, `boolean`, and `enum`; `false` for `string`. |
+
+### Spec types
+
+| Spec | Constant | Description |
+|------|----------|-------------|
+| `string` | `StrictEnvType.String` | Raw string value. Not trimmed by default; set `trim: true` to trim and treat whitespace-only as missing. |
+| `number` | `StrictEnvType.Number` | Finite numeric value (see below). Trimmed by default. |
+| `boolean` | `StrictEnvType.Boolean` | `1` / `true` / `yes` / `on` (case-insensitive, trimmed) → `true`; otherwise → `false`. Trimmed by default. |
+| `enum` | `StrictEnvType.Enum(choices)` | Value must be in `choices` (compared after trim). Trimmed by default. |
+
+#### `StrictEnvType.Number`
+
+- Trims leading/trailing whitespace before validation (default `trim: true`).
+- Parsed with `Number()`; the result must be finite (`NaN` and `Infinity` are rejected).
+- **Accepted examples**: `"3000"`, `"3.14"`, `"1e5"`, `"+42"`, `"0x10"`, `"  42  "`, `"-1"`
+- **Missing examples**: `""`, `"   "` (whitespace-only; `kind: 'missing'` unless a default is set)
+- **Rejected examples**: `"Infinity"`, `"NaN"`, `"not-a-number"`
+
+### Whitespace and trim
+
+| Spec | `trim` default | `""` | `"   "` (whitespace-only) | `" true "` |
+|------|----------------|------|---------------------------|------------|
+| `string` | `false` | missing (or default) | returned as-is (`"   "`) | returned as-is |
+| `number` | `true` | missing (or default) | missing (or default) | `invalid_number` |
+| `boolean` | `true` | missing (or default) | missing (or default) | `true` |
+| `enum` | `true` | missing (or default) | missing (or default) | `invalid_enum` (unless a choice matches after trim) |
+
+Override with `trim: true` or `trim: false` in options:
+
+```ts
+// Trim strings and treat whitespace-only as missing
+StrictEnvResolver.resolve('LOG_LEVEL', StrictEnvType.String, { trim: true, default: 'info' });
+
+// Preserve exact whitespace in a string value
+StrictEnvResolver.resolve('PADDING', StrictEnvType.String, { trim: false });
+```
+
+### Validation errors
+
+| `kind` | When |
+|--------|------|
+| `missing` | Variable unset, empty (`""`), or whitespace-only when trimming is enabled, without a default. |
+| `invalid_number` | Value is not a finite number. |
+| `invalid_enum` | Value is not in `choices`. |
+
+**Message formats:**
+
+- Missing: `Missing required environment variable: <key>`
+- Number: `Env <key>: expected number, got "<raw>"`
+- Enum: `Env <key>: must be one of [choice1, choice2, ...]`
+
+`StrictEnvValidationError` fields:
+
+- `errors`: `[{ key, message, raw?, kind }, ...]`
+- `keys`: `['KEY1', 'KEY2', ...]`
+
+## 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,211 @@
+/**
+ * Spec for a string environment variable.
+ * Returned as-is by default (`trim` defaults to `false`). Set `trim: true` in options to trim
+ * whitespace and treat whitespace-only values as missing.
+ * The default value is passed via the third argument of `resolve` or a `[spec, options]` tuple in `resolveAll`, not in the spec.
+ */
+export type StrictEnvTypeString = {
+    type: 'string';
+    default?: string;
+};
+/**
+ * Spec for a numeric environment variable.
+ * Values are parsed with `Number()`; `NaN`, `Infinity`, and `-Infinity` are rejected.
+ * The default value is passed via the third argument of `resolve` or a `[spec, options]` tuple in `resolveAll`, not in the spec.
+ */
+export type StrictEnvTypeNumber = {
+    type: 'number';
+    default?: number;
+};
+/**
+ * Spec for a boolean environment variable.
+ * Parses `1`, `true`, `yes`, `on` (case-insensitive, after trim) as `true`; any other non-empty value as `false`.
+ * Trims leading/trailing whitespace by default (see `StrictEnvOptions.trim`).
+ * The default value is passed via the third argument of `resolve` or a `[spec, options]` tuple in `resolveAll`, not in the spec.
+ */
+export type StrictEnvTypeBoolean = {
+    type: 'boolean';
+    default?: boolean;
+};
+/**
+ * Spec for an enum environment variable with a fixed set of choices.
+ * The value must be one of `choices` (compared after trim); otherwise validation fails.
+ * Trims leading/trailing whitespace by default (see `StrictEnvOptions.trim`).
+ * The default value is passed via the third argument of `resolve` or a `[spec, options]` tuple in `resolveAll`, not in the spec.
+ *
+ * @template T - Literal string union of allowed values.
+ */
+export type StrictEnvTypeEnum<T extends string = string> = {
+    type: 'enum';
+    choices: readonly T[];
+    default?: T;
+};
+/** Union of all environment variable spec types. */
+export type StrictEnvSpec = StrictEnvTypeString | StrictEnvTypeNumber | StrictEnvTypeBoolean | StrictEnvTypeEnum;
+/**
+ * Discriminated union of error kinds emitted during environment variable parsing.
+ *
+ * - `missing` — Variable unset, empty string, or whitespace-only (when trim is enabled) without a default.
+ * - `invalid_number` — Value is not a finite number (see `StrictEnvTypeNumber`).
+ * - `invalid_enum` — Value is not one of the allowed enum choices.
+ */
+export type StrictEnvErrorKind = 'missing' | 'invalid_number' | 'invalid_enum';
+/**
+ * A structured validation error entry for a single environment variable.
+ *
+ * @template K - Environment variable key type.
+ */
+export type StrictEnvValidationEntry<K extends string = string> = {
+    /** Environment variable name. */
+    key: K;
+    /** Human-readable error message. */
+    message: string;
+    /** Raw value from `process.env`, if present. */
+    raw?: string;
+    /** Error category for programmatic handling. */
+    kind: StrictEnvErrorKind;
+};
+/**
+ * Base error class for this package.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   StrictEnvResolver.resolve('PORT', StrictEnvType.Number);
+ * } catch (e) {
+ *   if (e instanceof StrictEnvError) {
+ *     // Handle all strict-env-resolver errors
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class StrictEnvError extends Error {
+    /**
+     * @param message - Error message.
+     */
+    protected constructor(message: string);
+}
+/**
+ * Validation error that carries one or more environment variable issues.
+ *
+ * Thrown by `StrictEnvResolver.resolve()` (single-entry `errors`) and
+ * `StrictEnvResolver.resolveAll()` (multi-entry `errors`).
+ * Individual entries are produced by the internal `parseEnvValue` helper.
+ *
+ * @template K - Union of environment variable keys included in `errors`.
+ */
+export declare class StrictEnvValidationError<K extends string = string> extends StrictEnvError {
+    /**
+     * Formats validation errors into a human-readable error message.
+     *
+     * @template K - Environment variable key type.
+     * @param errors - Validation error entries to format.
+     * @returns Multi-line summary listing each key and message.
+     */
+    static format<K extends string>(errors: readonly StrictEnvValidationEntry<K>[]): string;
+    /**
+     * Structured list of validation errors.
+     */
+    readonly errors: readonly StrictEnvValidationEntry<K>[];
+    /**
+     * Convenience list of keys included in `errors`.
+     */
+    readonly keys: readonly K[];
+    /**
+     * Creates a new validation error from one or more `StrictEnvValidationEntry` entries.
+     *
+     * @param errors - One or more structured validation errors.
+     */
+    constructor(errors: readonly StrictEnvValidationEntry<K>[]);
+}
+/**
+ * Predefined spec constants for use with `resolve` or as schema values in `resolveAll`.
+ * Provide defaults via the third argument of `resolve` or a `[spec, { default }]` tuple in `resolveAll`.
+ */
+export declare const StrictEnvType: {
+    /** Spec for a string value (returned as-is unless `trim: true` is set in options). */
+    readonly String: {
+        readonly type: "string";
+    };
+    /**
+     * Spec for a finite numeric value (`Number()` parsing; rejects `NaN` and `Infinity`).
+     */
+    readonly Number: {
+        readonly type: "number";
+    };
+    /** Spec for a boolean value (`1`/`true`/`yes`/`on` → `true`; other non-empty values → `false`). */
+    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 `resolve` or `resolveAll`.
+     */
+    readonly Enum: <T extends string>(choices: readonly T[]) => StrictEnvTypeEnum<T>;
+};
+/**
+ * Infers the return type from the given spec.
+ * @template S - A `StrictEnvSpec` variant.
+ */
+export type StrictEnvSpecToType<S> = S extends StrictEnvTypeString ? string : S extends StrictEnvTypeNumber ? number : S extends StrictEnvTypeBoolean ? boolean : S extends StrictEnvTypeEnum<infer T> ? T : never;
+/**
+ * Options for reading an environment variable with an optional default.
+ * Used as the third argument to `resolve` or as the second element of a `[spec, options]` tuple in `resolveAll`.
+ *
+ * `trim` defaults to `true` for `number`, `boolean`, and `enum` specs (whitespace-only values are
+ * treated as missing). For `string` specs it defaults to `false` (values are returned as-is).
+ *
+ * @template S - Environment variable spec type.
+ */
+export type StrictEnvOptions<S extends StrictEnvSpec> = {
+    default?: StrictEnvSpecToType<S>;
+    /** When `true`, trims leading/trailing whitespace before validation. */
+    trim?: boolean;
+};
+/**
+ * Schema entry for a single env var.
+ *
+ * Either provide a spec directly, or a tuple of `[spec, options]` to attach a default.
+ */
+export type StrictEnvSchemaEntry<S extends StrictEnvSpec = StrictEnvSpec> = S | readonly [S, StrictEnvOptions<S>];
+/**
+ * Schema object used by `resolveAll()`.
+ *
+ * Keys are env var names, values are specs (optionally with defaults).
+ */
+export type StrictEnvSchema = Record<string, StrictEnvSchemaEntry>;
+/**
+ * Extracts the spec type from a schema entry or `[spec, options]` tuple.
+ *
+ * @template E - Schema entry type.
+ */
+type StrictEnvSchemaEntryToSpec<E> = E extends readonly [infer S, unknown] ? S : E;
+/**
+ * Maps a schema object to the resulting parsed environment object type.
+ *
+ * @template TSchema - Schema object type passed to `resolveAll`.
+ */
+export type StrictEnvSchemaToType<TSchema extends StrictEnvSchema> = {
+    [K in keyof TSchema]: StrictEnvSpecToType<StrictEnvSchemaEntryToSpec<TSchema[K]> & StrictEnvSpec>;
+};
+/**
+ * Type-safe environment variable resolver for Node.js `process.env`.
+ *
+ * @example
+ * ```ts
+ * const port = StrictEnvResolver.resolve('PORT', StrictEnvType.Number);
+ * const envs = StrictEnvResolver.resolveAll({
+ *   PORT: StrictEnvType.Number,
+ *   DEBUG: [StrictEnvType.Boolean, { default: false }],
+ * });
+ * ```
+ */
+export declare const StrictEnvResolver: {
+    /** Reads and parses a single environment variable. See {@link resolve}. */
+    readonly resolve: <K extends string, S extends StrictEnvSpec = StrictEnvTypeString>(key: K, spec?: S, options?: StrictEnvOptions<S>) => StrictEnvSpecToType<S>;
+    /** Reads and parses multiple environment variables in one pass. See {@link resolveAll}. */
+    readonly resolveAll: <TSchema extends StrictEnvSchema>(schema: TSchema) => StrictEnvSchemaToType<TSchema>;
+};
+export {};

package/lib/index.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StrictEnvResolver = exports.StrictEnvType = exports.StrictEnvValidationError = exports.StrictEnvError = void 0;
+/**
+ * Pattern for boolean env values that parse as `true`.
+ * Matches `1`, `true`, `yes`, and `on` (case-insensitive) on the full trimmed string.
+ */
+const TRUE_BOOLEAN_PATTERN = /^(1|true|yes|on)$/i;
+/**
+ * Parses a string as a finite number for environment variables.
+ *
+ * @param raw - Trimmed environment variable value.
+ * @returns Parsed number, or `undefined` when the value is not a finite number.
+ */
+const parseNumber = (raw) => {
+    const n = Number(raw);
+    if (!Number.isFinite(n)) {
+        return undefined;
+    }
+    return n;
+};
+/**
+ * Parses a trimmed string as a boolean environment variable value.
+ *
+ * @param normalizedRaw - Trimmed raw environment variable value.
+ * @returns `true` for `1`/`true`/`yes`/`on` (case-insensitive); otherwise `false`.
+ */
+const parseBooleanEnvValue = (normalizedRaw) => TRUE_BOOLEAN_PATTERN.test(normalizedRaw);
+/**
+ * Base error class for this package.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   StrictEnvResolver.resolve('PORT', StrictEnvType.Number);
+ * } catch (e) {
+ *   if (e instanceof StrictEnvError) {
+ *     // Handle all strict-env-resolver errors
+ *   }
+ * }
+ * ```
+ */
+class StrictEnvError extends Error {
+    /**
+     * @param message - Error message.
+     */
+    constructor(message) {
+        super(message);
+        this.name = 'StrictEnvError';
+    }
+}
+exports.StrictEnvError = StrictEnvError;
+/**
+ * Validation error that carries one or more environment variable issues.
+ *
+ * Thrown by `StrictEnvResolver.resolve()` (single-entry `errors`) and
+ * `StrictEnvResolver.resolveAll()` (multi-entry `errors`).
+ * Individual entries are produced by the internal `parseEnvValue` helper.
+ *
+ * @template K - Union of environment variable keys included in `errors`.
+ */
+class StrictEnvValidationError extends StrictEnvError {
+    /**
+     * Formats validation errors into a human-readable error message.
+     *
+     * @template K - Environment variable key type.
+     * @param errors - Validation error entries to format.
+     * @returns Multi-line summary listing each key and message.
+     */
+    static format(errors) {
+        const lines = errors.map((e) => `- ${e.key}: ${e.message}${e.raw == null ? '' : ` (raw="${e.raw}")`}`);
+        return `Invalid environment variables (${errors.length}):\n${lines.join('\n')}`;
+    }
+    /**
+     * Creates a new validation error from one or more `StrictEnvValidationEntry` entries.
+     *
+     * @param errors - One or more structured validation errors.
+     */
+    constructor(errors) {
+        const msg = StrictEnvValidationError.format(errors);
+        super(msg);
+        this.name = 'StrictEnvValidationError';
+        this.errors = errors;
+        this.keys = errors.map((e) => e.key);
+    }
+}
+exports.StrictEnvValidationError = StrictEnvValidationError;
+/**
+ * Predefined spec constants for use with `resolve` or as schema values in `resolveAll`.
+ * Provide defaults via the third argument of `resolve` or a `[spec, { default }]` tuple in `resolveAll`.
+ */
+exports.StrictEnvType = {
+    /** Spec for a string value (returned as-is unless `trim: true` is set in options). */
+    String: { type: 'string' },
+    /**
+     * Spec for a finite numeric value (`Number()` parsing; rejects `NaN` and `Infinity`).
+     */
+    Number: { type: 'number' },
+    /** Spec for a boolean value (`1`/`true`/`yes`/`on` → `true`; other non-empty values → `false`). */
+    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 `resolve` or `resolveAll`.
+     */
+    Enum: (choices) => ({ type: 'enum', choices }),
+};
+/**
+ * Default trim behavior per spec type.
+ * Parsed types trim by default; strings preserve the raw value unless opted in.
+ *
+ * @param spec - Environment variable spec.
+ * @returns Whether leading/trailing whitespace should be trimmed before validation.
+ */
+const defaultTrimForSpec = (spec) => spec.type !== 'string';
+/**
+ * Normalizes a raw environment variable value before validation.
+ *
+ * @param raw - Raw value from `process.env`, if present.
+ * @param trim - Whether to trim leading/trailing whitespace.
+ * @returns Normalized value, or `undefined` when unset.
+ */
+const normalizeEnvRaw = (raw, trim) => {
+    if (raw == null) {
+        return undefined;
+    }
+    if (!trim) {
+        return raw;
+    }
+    return raw.trim();
+};
+/**
+ * Resolves a schema entry into its spec and optional per-key options.
+ *
+ * @param entry - Schema entry or `[spec, options]` tuple.
+ * @returns Parsed spec and options for `resolveAll`.
+ */
+const resolveSchemaEntry = (entry) => ({
+    spec: (Array.isArray(entry) ? entry[0] : entry),
+    options: (Array.isArray(entry) ? entry[1] : undefined),
+});
+/**
+ * Parses a single environment variable according to the given spec.
+ *
+ * Central validation helper shared by `resolve` and `resolveAll`. Does not throw;
+ * callers decide whether to throw immediately or collect errors.
+ *
+ * Missing or empty (`""`) values use `defaultValue` when provided. When `trim` is enabled,
+ * whitespace-only values are treated as empty. Number specs delegate to `parseNumber`.
+ * Boolean specs treat `1`/`true`/`yes`/`on` (case-insensitive, after trim) as `true`.
+ * Enum specs require an exact match in `choices` (after trim).
+ *
+ * @template K - Environment variable key type.
+ * @template S - Environment variable spec type.
+ * @param key - Environment variable name.
+ * @param spec - Type spec for the value.
+ * @param raw - Raw value from `process.env`, if present.
+ * @param defaultValue - Fallback when `raw` is missing or empty.
+ * @param options - Optional trim override (`trim` defaults per spec type).
+ * @returns Parsed value or a structured validation error.
+ */
+const parseEnvValue = (key, spec, raw, defaultValue, options) => {
+    const trim = options?.trim ?? defaultTrimForSpec(spec);
+    const normalizedRaw = normalizeEnvRaw(raw, trim);
+    const hasDefault = defaultValue !== undefined;
+    if (normalizedRaw == null || normalizedRaw === '') {
+        if (hasDefault) {
+            return { ok: true, value: defaultValue };
+        }
+        return {
+            ok: false,
+            error: { key, message: `Missing required environment variable: ${key}`, raw, kind: 'missing' },
+        };
+    }
+    switch (spec.type) {
+        case 'number': {
+            const n = parseNumber(normalizedRaw);
+            if (n === undefined) {
+                return {
+                    ok: false,
+                    error: { key, message: `Env ${key}: expected number, got "${raw}"`, raw, kind: 'invalid_number' },
+                };
+            }
+            return { ok: true, value: n };
+        }
+        case 'boolean':
+            return { ok: true, value: parseBooleanEnvValue(normalizedRaw) };
+        case 'enum':
+            if (!spec.choices.includes(normalizedRaw)) {
+                return {
+                    ok: false,
+                    error: {
+                        key,
+                        message: `Env ${key}: must be one of [${spec.choices.join(', ')}]`,
+                        raw,
+                        kind: 'invalid_enum',
+                    },
+                };
+            }
+            return { ok: true, value: normalizedRaw };
+        default:
+            return { ok: true, value: normalizedRaw };
+    }
+};
+/**
+ * Reads and parses an environment variable according to the given spec.
+ *
+ * Delegates validation to `parseEnvValue`. Missing or empty (`""`) values use
+ * `options.default` when provided; otherwise a `StrictEnvValidationError` is thrown.
+ * For `StrictEnvType.Number`, values are parsed as finite numbers (see `StrictEnvTypeNumber`).
+ *
+ * @template K - Environment variable key type.
+ * @template S - Environment variable spec type.
+ * @param key - Environment variable name (e.g. `"PORT"`, `"NODE_ENV"`).
+ * @param spec - Type spec; defaults to `StrictEnvType.String` when omitted.
+ * @param options - Optional `{ default, trim }`; see {@link StrictEnvOptions}.
+ * @returns Parsed value with type inferred from `spec`.
+ * @throws {StrictEnvValidationError} When the variable is missing, empty without a default, or invalid for the spec.
+ */
+const resolve = (key, spec = exports.StrictEnvType.String, options) => {
+    const result = parseEnvValue(key, spec, process.env[key], options?.default, options);
+    if (!result.ok) {
+        throw new StrictEnvValidationError([result.error]);
+    }
+    return result.value;
+};
+/**
+ * Reads and parses multiple environment variables according to the given schema.
+ *
+ * Always evaluates every key in `schema`. Each entry is validated via `parseEnvValue`;
+ * all errors are collected and thrown once in a single `StrictEnvValidationError`.
+ * Number specs use the same finite-number rules as `resolve`.
+ *
+ * @template TSchema - Schema object type.
+ * @param schema - Map of environment variable names to specs, optionally with per-key defaults via `[spec, { default }]`.
+ * @returns Parsed environment object with types inferred from the schema.
+ * @throws {StrictEnvValidationError} When one or more variables are missing, empty without a default, or invalid.
+ */
+const resolveAll = (schema) => {
+    const envs = {};
+    const errors = [];
+    for (const key of Object.keys(schema)) {
+        const { spec, options } = resolveSchemaEntry(schema[key]);
+        const result = parseEnvValue(key, spec, process.env[key], options?.default, options);
+        if (!result.ok) {
+            errors.push(result.error);
+            continue;
+        }
+        envs[key] = result.value;
+    }
+    if (errors.length > 0)
+        throw new StrictEnvValidationError(errors);
+    return envs;
+};
+/**
+ * Type-safe environment variable resolver for Node.js `process.env`.
+ *
+ * @example
+ * ```ts
+ * const port = StrictEnvResolver.resolve('PORT', StrictEnvType.Number);
+ * const envs = StrictEnvResolver.resolveAll({
+ *   PORT: StrictEnvType.Number,
+ *   DEBUG: [StrictEnvType.Boolean, { default: false }],
+ * });
+ * ```
+ */
+exports.StrictEnvResolver = {
+    /** Reads and parses a single environment variable. See {@link resolve}. */
+    resolve,
+    /** Reads and parses multiple environment variables in one pass. See {@link resolveAll}. */
+    resolveAll,
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBZUE7OztHQUdHO0FBQ0gsTUFBTSxvQkFBb0IsR0FBRyxvQkFBb0IsQ0FBQztBQUVsRDs7Ozs7R0FLRztBQUNILE1BQU0sV0FBVyxHQUFHLENBQUMsR0FBVyxFQUFzQixFQUFFO0lBQ3RELE1BQU0sQ0FBQyxHQUFHLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUN0QixJQUFJLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ3hCLE9BQU8sU0FBUyxDQUFDO0lBQ25CLENBQUM7SUFDRCxPQUFPLENBQUMsQ0FBQztBQUNYLENBQUMsQ0FBQztBQUVGOzs7OztHQUtHO0FBQ0gsTUFBTSxvQkFBb0IsR0FBRyxDQUFDLGFBQXFCLEVBQVcsRUFBRSxDQUFDLG9CQUFvQixDQUFDLElBQUksQ0FBQyxhQUFhLENBQUMsQ0FBQztBQW9EMUc7Ozs7Ozs7Ozs7Ozs7R0FhRztBQUNILE1BQXNCLGNBQWUsU0FBUSxLQUFLO0lBQ2hEOztPQUVHO0lBQ0gsWUFBc0IsT0FBZTtRQUNuQyxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDZixJQUFJLENBQUMsSUFBSSxHQUFHLGdCQUFnQixDQUFDO0lBQy9CLENBQUM7Q0FDRjtBQVJELHdDQVFDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFhLHdCQUFvRCxTQUFRLGNBQWM7SUFDckY7Ozs7OztPQU1HO0lBQ0ksTUFBTSxDQUFDLE1BQU0sQ0FBbUIsTUFBOEM7UUFDbkYsTUFBTSxLQUFLLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsS0FBSyxDQUFDLENBQUMsR0FBRyxLQUFLLENBQUMsQ0FBQyxPQUFPLEdBQUcsQ0FBQyxDQUFDLEdBQUcsSUFBSSxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxD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LEVBQUUsT0FBTyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQ3JGLElBQUksQ0FBQyxNQUFNLENBQUMsRUFBRSxFQUFFLENBQUM7WUFDZixNQUFNLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQztZQUMxQixTQUFTO1FBQ1gsQ0FBQztRQUNELElBQUksQ0FBQyxHQUFHLENBQUMsR0FBRyxNQUFNLENBQUMsS0FBbUQsQ0FBQztJQUN6RSxDQUFDO0lBRUQsSUFBSSxNQUFNLENBQUMsTUFBTSxHQUFHLENBQUM7UUFBRSxNQUFNLElBQUksd0JBQXdCLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDbEUsT0FBTyxJQUFzQyxDQUFDO0FBQ2hELENBQUMsQ0FBQztBQUVGOzs7Ozs7Ozs7OztHQVdHO0FBQ1UsUUFBQSxpQkFBaUIsR0FBRztJQUMvQiwyRUFBMkU7SUFDM0UsT0FBTztJQUNQLDJGQUEyRjtJQUMzRixVQUFVO0NBQ0YsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogU3BlYyBmb3IgYSBzdHJpbmcgZW52aXJvbm1lbnQgdmFyaWFibGUuXG4gKiBSZXR1cm5lZCBhcy1pcyBieSBkZWZhdWx0IChgdHJpbWAgZGVmYXVsdHMgdG8gYGZhbHNlYCkuIFNldCBgdHJpbTogdHJ1ZWAgaW4gb3B0aW9ucyB0byB0cmltXG4gKiB3aGl0ZXNwYWNlIGFuZCB0cmVhdCB3aGl0ZXNwYWNlLW9ubHkgdmFsdWVzIGFzIG1pc3NpbmcuXG4gKiBUaGUgZGVmYXVsdCB2YWx1ZSBpcyBwYXNzZWQgdmlhIHRoZSB0aGlyZCBhcmd1bWVudCBvZiBgcmVzb2x2ZWAgb3IgYSBgW3NwZWMsIG9wdGlvbnNdYCB0dXBsZSBpbiBgcmVzb2x2ZUFsbGAsIG5vdCBpbiB0aGUgc3BlYy5cbiAqL1xuZXhwb3J0IHR5cGUgU3RyaWN0RW52VHlwZVN0cmluZyA9IHsgdHlwZTogJ3N0cmluZyc7IGRlZmF1bHQ/OiBzdHJpbmcgfTtcblxuLyoqXG4gKiBTcGVjIGZvciBhIG51bWVyaWMgZW52aXJvbm1lbnQgdmFyaWFibGUuXG4gKiBWYWx1ZXMgYXJlIHBhcnNlZCB3aXRoIGBOdW1iZXIoKWA7IGBOYU5gLCBgSW5maW5pdHlgLCBhbmQgYC1JbmZpbml0eWAgYXJlIHJlamVjdGVkLlxuICogVGhlIGRlZmF1bHQgdmFsdWUgaXMgcGFzc2VkIHZpYSB0aGUgdGhpcmQgYXJndW1lbnQgb2YgYHJlc29sdmVgIG9yIGEgYFtzcGVjLCBvcHRpb25zXWAgdHVwbGUgaW4gYHJlc29sdmVBbGxgLCBub3QgaW4gdGhlIHNwZWMuXG4gKi9cbmV4cG9ydCB0eXBlIFN0cmljdEVudlR5cGVOdW1iZXIgPSB7IHR5cGU6ICdudW1iZXInOyBkZWZhdWx0PzogbnVtYmVyIH07XG5cbi8qKlxuICogUGF0dGVybiBmb3IgYm9vbGVhbiBlbnYgdmFsdWVzIHRoYXQgcGFyc2UgYXMgYHRydWVgLlxuICogTWF0Y2hlcyBgMWAsIGB0cnVlYCwgYHllc2AsIGFuZCBgb25gIChjYXNlLWluc2Vuc2l0aXZlKSBvbiB0aGUgZnVsbCB0cmltbWVkIHN0cmluZy5cbiAqL1xuY29uc3QgVFJVRV9CT09MRUFOX1BBVFRFUk4gPSAvXigxfHRydWV8eWVzfG9uKSQvaTtcblxuLyoqXG4gKiBQYXJzZXMgYSBzdHJpbmcgYXMgYSBmaW5pdGUgbnVtYmVyIGZvciBlbnZpcm9ubWVudCB2YXJpYWJsZXMuXG4gKlxuICogQHBhcmFtIHJhdyAtIFRyaW1tZWQgZW52aXJvbm1lbnQgdmFyaWFibGUgdmFsdWUuXG4gKiBAcmV0dXJucyBQYXJzZWQgbnVtYmVyLCBvciBgdW5kZWZpbmVkYCB3aGVuIHRoZSB2YWx1ZSBpcyBub3QgYSBmaW5pdGUgbnVtYmVyLlxuICovXG5jb25zdCBwYXJzZU51bWJlciA9IChyYXc6IHN0cmluZyk6IG51bWJlciB8IHVuZGVmaW5lZCA9PiB7XG4gIGNvbnN0IG4gPSBOdW1iZXIocmF3KTtcbiAgaWYgKCFOdW1iZXIuaXNGaW5pdGUobikpIHtcbiAgICByZXR1cm4gdW5kZWZpbmVkO1xuICB9XG4gIHJldHVybiBuO1xufTtcblxuLyoqXG4gKiBQYXJzZXMgYSB0cmltbWVkIHN0cmluZyBhcyBhIGJvb2xlYW4gZW52aXJvbm1lbnQgdmFyaWFibGUgdmFsdWUuXG4gKlxuICogQHBhcmFtIG5vcm1hbGl6ZWRSYXcgLSBUcmltbWVkIHJhdyBlbnZpcm9ubWVudCB2YXJpYWJsZSB2YWx1ZS5cbiAqIEByZXR1cm5zIGB0cnVlYCBmb3IgYDFgL2B0cnVlYC9geWVzYC9gb25gIChjYXNlLWluc2Vuc2l0aXZlKTsgb3RoZXJ3aXNlIGBmYWxzZWAuXG4gKi9cbmNvbnN0IHBhcnNlQm9vbGVhbkVudlZhbHVlID0gKG5vcm1hbGl6ZWRSYXc6IHN0cmluZyk6IGJvb2xlYW4gPT4gVFJVRV9CT09MRUFOX1BBVFRFUk4udGVzdChub3JtYWxpemVkUmF3KTtcblxuLyoqXG4gKiBTcGVjIGZvciBhIGJvb2xlYW4gZW52aXJvbm1lbnQgdmFyaWFibGUuXG4gKiBQYXJzZXMgYDFgLCBgdHJ1ZWAsIGB5ZXNgLCBgb25gIChjYXNlLWluc2Vuc2l0aXZlLCBhZnRlciB0cmltKSBhcyBgdHJ1ZWA7IGFueSBvdGhlciBub24tZW1wdHkgdmFsdWUgYXMgYGZhbHNlYC5cbiAqIFRyaW1zIGxlYWRpbmcvdHJhaWxpbmcgd2hpdGVzcGFjZSBieSBkZWZhdWx0IChzZWUgYFN0cmljdEVudk9wdGlvbnMudHJpbWApLlxuICogVGhlIGRlZmF1bHQgdmFsdWUgaXMgcGFzc2VkIHZpYSB0aGUgdGhpcmQgYXJndW1lbnQgb2YgYHJlc29sdmVgIG9yIGEgYFtzcGVjLCBvcHRpb25zXWAgdHVwbGUgaW4gYHJlc29sdmVBbGxgLCBub3QgaW4gdGhlIHNwZWMuXG4gKi9cbmV4cG9ydCB0eXBlIFN0cmljdEVudlR5cGVCb29sZWFuID0geyB0eXBlOiAnYm9vbGVhbic7IGRlZmF1bHQ/OiBib29sZWFuIH07XG5cbi8qKlxuICogU3BlYyBmb3IgYW4gZW51bSBlbnZpcm9ubWVudCB2YXJpYWJsZSB3aXRoIGEgZml4ZWQgc2V0IG9mIGNob2ljZXMuXG4gKiBUaGUgdmFsdWUgbXVzdCBiZSBvbmUgb2YgYGNob2ljZXNgIChjb21wYXJlZCBhZnRlciB0cmltKTsgb3RoZXJ3aXNlIHZhbGlkYXRpb24gZmFpbHMuXG4gKiBUcmltcyBsZWFkaW5nL3RyYWlsaW5nIHdoaXRlc3BhY2UgYnkgZGVmYXVsdCAoc2VlIGBTdHJpY3RFbnZPcHRpb25zLnRyaW1gKS5cbiAqIFRoZSBkZWZhdWx0IHZhbHVlIGlzIHBhc3NlZCB2aWEgdGhlIHRoaXJkIGFyZ3VtZW50IG9mIGByZXNvbHZlYCBvciBhIGBbc3BlYywgb3B0aW9uc11gIHR1cGxlIGluIGByZXNvbHZlQWxsYCwgbm90IGluIHRoZSBzcGVjLlxuICpcbiAqIEB0ZW1wbGF0ZSBUIC0gTGl0ZXJhbCBzdHJpbmcgdW5pb24gb2YgYWxsb3dlZCB2YWx1ZXMuXG4gKi9cbmV4cG9ydCB0eXBlIFN0cmljdEVudlR5cGVFbnVtPFQgZXh0ZW5kcyBzdHJpbmcgPSBzdHJpbmc+ID0geyB0eXBlOiAnZW51bSc7IGNob2ljZXM6IHJlYWRvbmx5IFRbXTsgZGVmYXVsdD86IFQgfTtcblxuLyoqIFVuaW9uIG9mIGFsbCBlbnZpcm9ubWVudCB2YXJpYWJsZSBzcGVjIHR5cGVzLiAqL1xuZXhwb3J0IHR5cGUgU3RyaWN0RW52U3BlYyA9XG4gIHwgU3RyaWN0RW52VHlwZVN0cmluZ1xuICB8IFN0cmljdEVudlR5cGVOdW1iZXJcbiAgfCBTdHJpY3RFbnZUeXBlQm9vbGVhblxuICB8IFN0cmljdEVudlR5cGVFbnVtO1xuXG4vKipcbiAqIERpc2NyaW1pbmF0ZWQgdW5pb24gb2YgZXJyb3Iga2luZHMgZW1pdHRlZCBkdXJpbmcgZW52aXJvbm1lbnQgdmFyaWFibGUgcGFyc2luZy5cbiAqXG4gKiAtIGBtaXNzaW5nYCDigJQgVmFyaWFibGUgdW5zZXQsIGVtcHR5IHN0cmluZywgb3Igd2hpdGVzcGFjZS1vbmx5ICh3aGVuIHRyaW0gaXMgZW5hYmxlZCkgd2l0aG91dCBhIGRlZmF1bHQuXG4gKiAtIGBpbnZhbGlkX251bWJlcmAg4oCUIFZhbHVlIGlzIG5vdCBhIGZpbml0ZSBudW1iZXIgKHNlZSBgU3RyaWN0RW52VHlwZU51bWJlcmApLlxuICogLSBgaW52YWxpZF9lbnVtYCDigJQgVmFsdWUgaXMgbm90IG9uZSBvZiB0aGUgYWxsb3dlZCBlbnVtIGNob2ljZXMuXG4gKi9cbmV4cG9ydCB0eXBlIFN0cmljdEVudkVycm9yS2luZCA9ICdtaXNzaW5nJyB8ICdpbnZhbGlkX251bWJlcicgfCAnaW52YWxpZF9lbnVtJztcblxuLyoqXG4gKiBBIHN0cnVjdHVyZWQgdmFsaWRhdGlvbiBlcnJvciBlbnRyeSBmb3IgYSBzaW5nbGUgZW52aXJvbm1lbnQgdmFyaWFibGUuXG4gKlxuICogQHRlbXBsYXRlIEsgLSBFbnZpcm9ubWVudCB2YXJpYWJsZSBrZXkgdHlwZS5cbiAqL1xuZXhwb3J0IHR5cGUgU3RyaWN0RW52VmFsaWRhdGlvbkVudHJ5PEsgZXh0ZW5kcyBzdHJpbmcgPSBzdHJpbmc+ID0ge1xuICAvKiogRW52aXJvbm1lbnQgdmFyaWFibGUgbmFtZS4gKi9cbiAga2V5OiBLO1xuICAvKiogSHVtYW4tcmVhZGFibGUgZXJyb3IgbWVzc2FnZS4gKi9cbiAgbWVzc2FnZTogc3RyaW5nO1xuICAvKiogUmF3IHZhbHVlIGZyb20gYHByb2Nlc3MuZW52YCwgaWYgcHJlc2VudC4gKi9cbiAgcmF3Pzogc3RyaW5nO1xuICAvKiogRXJyb3IgY2F0ZWdvcnkgZm9yIHByb2dyYW1tYXRpYyBoYW5kbGluZy4gKi9cbiAga2luZDogU3RyaWN0RW52RXJyb3JLaW5kO1xufTtcblxuLyoqXG4gKiBCYXNlIGVycm9yIGNsYXNzIGZvciB0aGlzIHBhY2thZ2UuXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHRzXG4gKiB0cnkge1xuICogICBTdHJpY3RFbnZSZXNvbHZlci5yZXNvbHZlKCdQT1JUJywgU3RyaWN0RW52VHlwZS5OdW1iZXIpO1xuICogfSBjYXRjaCAoZSkge1xuICogICBpZiAoZSBpbnN0YW5jZW9mIFN0cmljdEVudkVycm9yKSB7XG4gKiAgICAgLy8gSGFuZGxlIGFsbCBzdHJpY3QtZW52LXJlc29sdmVyIGVycm9yc1xuICogICB9XG4gKiB9XG4gKiBgYGBcbiAqL1xuZXhwb3J0IGFic3RyYWN0IGNsYXNzIFN0cmljdEVudkVycm9yIGV4dGVuZHMgRXJyb3Ige1xuICAvKipcbiAgICogQHBhcmFtIG1lc3NhZ2UgLSBFcnJvciBtZXNzYWdlLlxuICAgKi9cbiAgcHJvdGVjdGVkIGNvbnN0cnVjdG9yKG1lc3NhZ2U6IHN0cmluZykge1xuICAgIHN1cGVyKG1lc3NhZ2UpO1xuICAgIHRoaXMubmFtZSA9ICdTdHJpY3RFbnZFcnJvcic7XG4gIH1cbn1cblxuLyoqXG4gKiBWYWxpZGF0aW9uIGVycm9yIHRoYXQgY2FycmllcyBvbmUgb3IgbW9yZSBlbnZpcm9ubWVudCB2YXJpYWJsZSBpc3N1ZXMuXG4gKlxuICogVGhyb3duIGJ5IGBTdHJpY3RFbnZSZXNvbHZlci5yZXNvbHZlKClgIChzaW5nbGUtZW50cnkgYGVycm9yc2ApIGFuZFxuICogYFN0cmljdEVudlJlc29sdmVyLnJlc29sdmVBbGwoKWAgKG11bHRpLWVudHJ5IGBlcnJvcnNgKS5cbiAqIEluZGl2aWR1YWwgZW50cmllcyBhcmUgcHJvZHVjZWQgYnkgdGhlIGludGVybmFsIGBwYXJzZUVudlZhbHVlYCBoZWxwZXIuXG4gKlxuICogQHRlbXBsYXRlIEsgLSBVbmlvbiBvZiBlbnZpcm9ubWVudCB2YXJpYWJsZSBrZXlzIGluY2x1ZGVkIGluIGBlcnJvcnNgLlxuICovXG5leHBvcnQgY2xhc3MgU3RyaWN0RW52VmFsaWRhdGlvbkVycm9yPEsgZXh0ZW5kcyBzdHJpbmcgPSBzdHJpbmc+IGV4dGVuZHMgU3RyaWN0RW52RXJyb3Ige1xuICAvKipcbiAgICogRm9ybWF0cyB2YWxpZGF0aW9uIGVycm9ycyBpbnRvIGEgaHVtYW4tcmVhZGFibGUgZXJyb3IgbWVzc2FnZS5cbiAgICpcbiAgICogQHRlbXBsYXRlIEsgLSBFbnZpcm9ubWVudCB2YXJpYWJsZSBrZXkgdHlwZS5cbiAgICogQHBhcmFtIGVycm9ycyAtIFZhbGlkYXRpb24gZXJyb3IgZW50cmllcyB0byBmb3JtYXQuXG4gICAqIEByZXR1cm5zIE11bHRpLWxpbmUgc3VtbWFyeSBsaXN0aW5nIGVhY2gga2V5IGFuZCBtZXNzYWdlLlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBmb3JtYXQ8SyBleHRlbmRzIHN0cmluZz4oZXJyb3JzOiByZWFkb25seSBTdHJpY3RFbnZWYWxpZGF0aW9uRW50cnk8Sz5bXSk6IHN0cmluZyB7XG4gICAgY29uc3QgbGluZXMgPSBlcnJvcnMubWFwKChlKSA9PiBgLSAke2Uua2V5fTogJHtlLm1lc3NhZ2V9JHtlLnJhdyA9PSBudWxsID8gJycgOiBgIChyYXc9XCIke2UucmF3fVwiKWB9YCk7XG4gICAgcmV0dXJuIGBJbnZhbGlkIGVudmlyb25tZW50IHZhcmlhYmxlcyAoJHtlcnJvcnMubGVuZ3RofSk6XFxuJHtsaW5lcy5qb2luKCdcXG4nKX1gO1xuICB9XG5cbiAgLyoqXG4gICAqIFN0cnVjdHVyZWQgbGlzdCBvZiB2YWxpZGF0aW9uIGVycm9ycy5cbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBlcnJvcnM6IHJlYWRvbmx5IFN0cmljdEVudlZhbGlkYXRpb25FbnRyeTxLPltdO1xuICAvKipcbiAgICogQ29udmVuaWVuY2UgbGlzdCBvZiBrZXlzIGluY2x1ZGVkIGluIGBlcnJvcnNgLlxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IGtleXM6IHJlYWRvbmx5IEtbXTtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyB2YWxpZGF0aW9uIGVycm9yIGZyb20gb25lIG9yIG1vcmUgYFN0cmljdEVudlZhbGlkYXRpb25FbnRyeWAgZW50cmllcy5cbiAgICpcbiAgICogQHBhcmFtIGVycm9ycyAtIE9uZSBvciBtb3JlIHN0cnVjdHVyZWQgdmFsaWRhdGlvbiBlcnJvcnMuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IoZXJyb3JzOiByZWFkb25seSBTdHJpY3RFbnZWYWxpZGF0aW9uRW50cnk8Sz5bXSkge1xuICAgIGNvbnN0IG1zZyA9IFN0cmljdEVudlZhbGlkYXRpb25FcnJvci5mb3JtYXQoZXJyb3JzKTtcbiAgICBzdXBlcihtc2cpO1xuICAgIHRoaXMubmFtZSA9ICdTdHJpY3RFbnZWYWxpZGF0aW9uRXJyb3InO1xuICAgIHRoaXMuZXJyb3JzID0gZXJyb3JzO1xuICAgIHRoaXMua2V5cyA9IGVycm9ycy5tYXAoKGUpID0+IGUua2V5KTtcbiAgfVxufVxuXG4vKipcbiAqIFByZWRlZmluZWQgc3BlYyBjb25zdGFudHMgZm9yIHVzZSB3aXRoIGByZXNvbHZlYCBvciBhcyBzY2hlbWEgdmFsdWVzIGluIGByZXNvbHZlQWxsYC5cbiAqIFByb3ZpZGUgZGVmYXVsdHMgdmlhIHRoZSB0aGlyZCBhcmd1bWVudCBvZiBgcmVzb2x2ZWAgb3IgYSBgW3NwZWMsIHsgZGVmYXVsdCB9XWAgdHVwbGUgaW4gYHJlc29sdmVBbGxgLlxuICovXG5leHBvcnQgY29uc3QgU3RyaWN0RW52VHlwZSA9IHtcbiAgLyoqIFNwZWMgZm9yIGEgc3RyaW5nIHZhbHVlIChyZXR1cm5lZCBhcy1pcyB1bmxlc3MgYHRyaW06IHRydWVgIGlzIHNldCBpbiBvcHRpb25zKS4gKi9cbiAgU3RyaW5nOiB7IHR5cGU6ICdzdHJpbmcnIH0gYXMgY29uc3Qgc2F0aXNmaWVzIFN0cmljdEVudlR5cGVTdHJpbmcsXG4gIC8qKlxuICAgKiBTcGVjIGZvciBhIGZpbml0ZSBudW1lcmljIHZhbHVlIChgTnVtYmVyKClgIHBhcnNpbmc7IHJlamVjdHMgYE5hTmAgYW5kIGBJbmZpbml0eWApLlxuICAgKi9cbiAgTnVtYmVyOiB7IHR5cGU6ICdudW1iZXInIH0gYXMgY29uc3Qgc2F0aXNmaWVzIFN0cmljdEVudlR5cGVOdW1iZXIsXG4gIC8qKiBTcGVjIGZvciBhIGJvb2xlYW4gdmFsdWUgKGAxYC9gdHJ1ZWAvYHllc2AvYG9uYCDihpIgYHRydWVgOyBvdGhlciBub24tZW1wdHkgdmFsdWVzIOKGkiBgZmFsc2VgKS4gKi9cbiAgQm9vbGVhbjogeyB0eXBlOiAnYm9vbGVhbicgfSBhcyBjb25zdCBzYXRpc2ZpZXMgU3RyaWN0RW52VHlwZUJvb2xlYW4sXG4gIC8qKlxuICAgKiBSZXR1cm5zIGEgc3BlYyB0aGF0IHJlc3RyaWN0cyB0aGUgdmFsdWUgdG8gb25lIG9mIHRoZSBnaXZlbiBjaG9pY2VzLlxuICAgKlxuICAgKiBAcGFyYW0gY2hvaWNlcyAtIEFsbG93ZWQgc3RyaW5nIGxpdGVyYWxzLlxuICAgKiBAcmV0dXJucyBFbnVtIHNwZWMgZm9yIHVzZSB3aXRoIGByZXNvbHZlYCBvciBgcmVzb2x2ZUFsbGAuXG4gICAqL1xuICBFbnVtOiA8VCBleHRlbmRzIHN0cmluZz4oY2hvaWNlczogcmVhZG9ubHkgVFtdKSA9PiAoeyB0eXBlOiAnZW51bScsIGNob2ljZXMgfSkgYXMgU3RyaWN0RW52VHlwZUVudW08VD4sXG59IGFzIGNvbnN0O1xuXG4vKipcbiAqIEluZmVycyB0aGUgcmV0dXJuIHR5cGUgZnJvbSB0aGUgZ2l2ZW4gc3BlYy5cbiAqIEB0ZW1wbGF0ZSBTIC0gQSBgU3RyaWN0RW52U3BlY2AgdmFyaWFudC5cbiAqL1xuZXhwb3J0IHR5cGUgU3RyaWN0RW52U3BlY1RvVHlwZTxTPiA9XG4gIFMgZXh0ZW5kcyBTdHJpY3RFbnZUeXBlU3RyaW5nID8gc3RyaW5nXG4gICAgOiBTIGV4dGVuZHMgU3RyaWN0RW52VHlwZU51bWJlciA/IG51bWJlclxuICAgICAgOiBTIGV4dGVuZHMgU3RyaWN0RW52VHlwZUJvb2xlYW4gPyBib29sZWFuXG4gICAgICAgIDogUyBleHRlbmRzIFN0cmljdEVudlR5cGVFbnVtPGluZmVyIFQ+ID8gVFxuICAgICAgICAgIDogbmV2ZXI7XG5cbi8qKlxuICogT3B0aW9ucyBmb3IgcmVhZGluZyBhbiBlbnZpcm9ubWVudCB2YXJpYWJsZSB3aXRoIGFuIG9wdGlvbmFsIGRlZmF1bHQuXG4gKiBVc2VkIGFzIHRoZSB0aGlyZCBhcmd1bWVudCB0byBgcmVzb2x2ZWAgb3IgYXMgdGhlIHNlY29uZCBlbGVtZW50IG9mIGEgYFtzcGVjLCBvcHRpb25zXWAgdHVwbGUgaW4gYHJlc29sdmVBbGxgLlxuICpcbiAqIGB0cmltYCBkZWZhdWx0cyB0byBgdHJ1ZWAgZm9yIGBudW1iZXJgLCBgYm9vbGVhbmAsIGFuZCBgZW51bWAgc3BlY3MgKHdoaXRlc3BhY2Utb25seSB2YWx1ZXMgYXJlXG4gKiB0cmVhdGVkIGFzIG1pc3NpbmcpLiBGb3IgYHN0cmluZ2Agc3BlY3MgaXQgZGVmYXVsdHMgdG8gYGZhbHNlYCAodmFsdWVzIGFyZSByZXR1cm5lZCBhcy1pcykuXG4gKlxuICogQHRlbXBsYXRlIFMgLSBFbnZpcm9ubWVudCB2YXJpYWJsZSBzcGVjIHR5cGUuXG4gKi9cbmV4cG9ydCB0eXBlIFN0cmljdEVudk9wdGlvbnM8UyBleHRlbmRzIFN0cmljdEVudlNwZWM+ID0ge1xuICBkZWZhdWx0PzogU3RyaWN0RW52U3BlY1RvVHlwZTxTPjtcbiAgLyoqIFdoZW4gYHRydWVgLCB0cmltcyBsZWFkaW5nL3RyYWlsaW5nIHdoaXRlc3BhY2UgYmVmb3JlIHZhbGlkYXRpb24uICovXG4gIHRyaW0/OiBib29sZWFuO1xufTtcblxuLyoqXG4gKiBTY2hlbWEgZW50cnkgZm9yIGEgc2luZ2xlIGVudiB2YXIuXG4gKlxuICogRWl0aGVyIHByb3ZpZGUgYSBzcGVjIGRpcmVjdGx5LCBvciBhIHR1cGxlIG9mIGBbc3BlYywgb3B0aW9uc11gIHRvIGF0dGFjaCBhIGRlZmF1bHQuXG4gKi9cbmV4cG9ydCB0eXBlIFN0cmljdEVudlNjaGVtYUVudHJ5PFMgZXh0ZW5kcyBTdHJpY3RFbnZTcGVjID0gU3RyaWN0RW52U3BlYz4gPSBTIHwgcmVhZG9ubHkgW1MsIFN0cmljdEVudk9wdGlvbnM8Uz5dO1xuXG4vKipcbiAqIFNjaGVtYSBvYmplY3QgdXNlZCBieSBgcmVzb2x2ZUFsbCgpYC5cbiAqXG4gKiBLZXlzIGFyZSBlbnYgdmFyIG5hbWVzLCB2YWx1ZXMgYXJlIHNwZWNzIChvcHRpb25hbGx5IHdpdGggZGVmYXVsdHMpLlxuICovXG5leHBvcnQgdHlwZSBTdHJpY3RFbnZTY2hlbWEgPSBSZWNvcmQ8c3RyaW5nLCBTdHJpY3RFbnZTY2hlbWFFbnRyeT47XG5cbi8qKlxuICogRXh0cmFjdHMgdGhlIHNwZWMgdHlwZSBmcm9tIGEgc2NoZW1hIGVudHJ5IG9yIGBbc3BlYywgb3B0aW9uc11gIHR1cGxlLlxuICpcbiAqIEB0ZW1wbGF0ZSBFIC0gU2NoZW1hIGVudHJ5IHR5cGUuXG4gKi9cbnR5cGUgU3RyaWN0RW52U2NoZW1hRW50cnlUb1NwZWM8RT4gPSBFIGV4dGVuZHMgcmVhZG9ubHkgW2luZmVyIFMsIHVua25vd25dID8gUyA6IEU7XG5cbi8qKlxuICogTWFwcyBhIHNjaGVtYSBvYmplY3QgdG8gdGhlIHJlc3VsdGluZyBwYXJzZWQgZW52aXJvbm1lbnQgb2JqZWN0IHR5cGUuXG4gKlxuICogQHRlbXBsYXRlIFRTY2hlbWEgLSBTY2hlbWEgb2JqZWN0IHR5cGUgcGFzc2VkIHRvIGByZXNvbHZlQWxsYC5cbiAqL1xuZXhwb3J0IHR5cGUgU3RyaWN0RW52U2NoZW1hVG9UeXBlPFRTY2hlbWEgZXh0ZW5kcyBTdHJpY3RFbnZTY2hlbWE+ID0ge1xuICBbSyBpbiBrZXlvZiBUU2NoZW1hXTogU3RyaWN0RW52U3BlY1RvVHlwZTxTdHJpY3RFbnZTY2hlbWFFbnRyeVRvU3BlYzxUU2NoZW1hW0tdPiAmIFN0cmljdEVudlNwZWM+O1xufTtcblxuLyoqXG4gKiBEaXNjcmltaW5hdGVkIHJlc3VsdCBvZiBwYXJzaW5nIGEgc2luZ2xlIGVudmlyb25tZW50IHZhcmlhYmxlLlxuICpcbiAqIE9uIHN1Y2Nlc3MsIGB2YWx1ZWAgaG9sZHMgdGhlIHBhcnNlZCByZXN1bHQuIE9uIGZhaWx1cmUsIGBlcnJvcmAgaG9sZHMgYSBzdHJ1Y3R1cmVkXG4gKiBgU3RyaWN0RW52VmFsaWRhdGlvbkVudHJ5YCBlbnRyeSAobmV2ZXIgdGhyb3dzKS5cbiAqXG4gKiBAdGVtcGxhdGUgSyAtIEVudmlyb25tZW50IHZhcmlhYmxlIGtleSB0eXBlLlxuICogQHRlbXBsYXRlIFMgLSBFbnZpcm9ubWVudCB2YXJpYWJsZSBzcGVjIHR5cGUuXG4gKi9cbnR5cGUgUGFyc2VFbnZWYWx1ZVJlc3VsdDxLIGV4dGVuZHMgc3RyaW5nLCBTIGV4dGVuZHMgU3RyaWN0RW52U3BlYz4gPVxuICB8IHsgb2s6IHRydWU7IHZhbHVlOiBTdHJpY3RFbnZTcGVjVG9UeXBlPFM+IH1cbiAgfCB7IG9rOiBmYWxzZTsgZXJyb3I6IFN0cmljdEVudlZhbGlkYXRpb25FbnRyeTxLPiB9O1xuXG4vKipcbiAqIERlZmF1bHQgdHJpbSBiZWhhdmlvciBwZXIgc3BlYyB0eXBlLlxuICogUGFyc2VkIHR5cGVzIHRyaW0gYnkgZGVmYXVsdDsgc3RyaW5ncyBwcmVzZXJ2ZSB0aGUgcmF3IHZhbHVlIHVubGVzcyBvcHRlZCBpbi5cbiAqXG4gKiBAcGFyYW0gc3BlYyAtIEVudmlyb25tZW50IHZhcmlhYmxlIHNwZWMuXG4gKiBAcmV0dXJucyBXaGV0aGVyIGxlYWRpbmcvdHJhaWxpbmcgd2hpdGVzcGFjZSBzaG91bGQgYmUgdHJpbW1lZCBiZWZvcmUgdmFsaWRhdGlvbi5cbiAqL1xuY29uc3QgZGVmYXVsdFRyaW1Gb3JTcGVjID0gKHNwZWM6IFN0cmljdEVudlNwZWMpOiBib29sZWFuID0+IHNwZWMudHlwZSAhPT0gJ3N0cmluZyc7XG5cbi8qKlxuICogTm9ybWFsaXplcyBhIHJhdyBlbnZpcm9ubWVudCB2YXJpYWJsZSB2YWx1ZSBiZWZvcmUgdmFsaWRhdGlvbi5cbiAqXG4gKiBAcGFyYW0gcmF3IC0gUmF3IHZhbHVlIGZyb20gYHByb2Nlc3MuZW52YCwgaWYgcHJlc2VudC5cbiAqIEBwYXJhbSB0cmltIC0gV2hldGhlciB0byB0cmltIGxlYWRpbmcvdHJhaWxpbmcgd2hpdGVzcGFjZS5cbiAqIEByZXR1cm5zIE5vcm1hbGl6ZWQgdmFsdWUsIG9yIGB1bmRlZmluZWRgIHdoZW4gdW5zZXQuXG4gKi9cbmNvbnN0IG5vcm1hbGl6ZUVudlJhdyA9IChyYXc6IHN0cmluZyB8IHVuZGVmaW5lZCwgdHJpbTogYm9vbGVhbik6IHN0cmluZyB8IHVuZGVmaW5lZCA9PiB7XG4gIGlmIChyYXcgPT0gbnVsbCkge1xuICAgIHJldHVybiB1bmRlZmluZWQ7XG4gIH1cbiAgaWYgKCF0cmltKSB7XG4gICAgcmV0dXJuIHJhdztcbiAgfVxuICByZXR1cm4gcmF3LnRyaW0oKTtcbn07XG5cbi8qKiBPcHRpb25zIGFjY2VwdGVkIGJ5IGBwYXJzZUVudlZhbHVlYCAoc3Vic2V0IG9mIGBTdHJpY3RFbnZPcHRpb25zYCkuICovXG50eXBlIFBhcnNlRW52VmFsdWVPcHRpb25zPFMgZXh0ZW5kcyBTdHJpY3RFbnZTcGVjPiA9IFBpY2s8U3RyaWN0RW52T3B0aW9uczxTPiwgJ3RyaW0nPjtcblxuLyoqXG4gKiBSZXNvbHZlcyBhIHNjaGVtYSBlbnRyeSBpbnRvIGl0cyBzcGVjIGFuZCBvcHRpb25hbCBwZXIta2V5IG9wdGlvbnMuXG4gKlxuICogQHBhcmFtIGVudHJ5IC0gU2NoZW1hIGVudHJ5IG9yIGBbc3BlYywgb3B0aW9uc11gIHR1cGxlLlxuICogQHJldHVybnMgUGFyc2VkIHNwZWMgYW5kIG9wdGlvbnMgZm9yIGByZXNvbHZlQWxsYC5cbiAqL1xuY29uc3QgcmVzb2x2ZVNjaGVtYUVudHJ5ID0gKFxuICBlbnRyeTogU3RyaWN0RW52U2NoZW1hRW50cnksXG4pOiB7IHNwZWM6IFN0cmljdEVudlNwZWM7IG9wdGlvbnM6IFN0cmljdEVudk9wdGlvbnM8U3RyaWN0RW52U3BlYz4gfCB1bmRlZmluZWQgfSA9PiAoe1xuICBzcGVjOiAoQXJyYXkuaXNBcnJheShlbnRyeSkgPyBlbnRyeVswXSA6IGVudHJ5KSBhcyBTdHJpY3RFbnZTcGVjLFxuICBvcHRpb25zOiAoQXJyYXkuaXNBcnJheShlbnRyeSkgPyBlbnRyeVsxXSA6IHVuZGVmaW5lZCkgYXMgU3RyaWN0RW52T3B0aW9uczxTdHJpY3RFbnZTcGVjPiB8IHVuZGVmaW5lZCxcbn0pO1xuXG4vKipcbiAqIFBhcnNlcyBhIHNpbmdsZSBlbnZpcm9ubWVudCB2YXJpYWJsZSBhY2NvcmRpbmcgdG8gdGhlIGdpdmVuIHNwZWMuXG4gKlxuICogQ2VudHJhbCB2YWxpZGF0aW9uIGhlbHBlciBzaGFyZWQgYnkgYHJlc29sdmVgIGFuZCBgcmVzb2x2ZUFsbGAuIERvZXMgbm90IHRocm93O1xuICogY2FsbGVycyBkZWNpZGUgd2hldGhlciB0byB0aHJvdyBpbW1lZGlhdGVseSBvciBjb2xsZWN0IGVycm9ycy5cbiAqXG4gKiBNaXNzaW5nIG9yIGVtcHR5IChgXCJcImApIHZhbHVlcyB1c2UgYGRlZmF1bHRWYWx1ZWAgd2hlbiBwcm92aWRlZC4gV2hlbiBgdHJpbWAgaXMgZW5hYmxlZCxcbiAqIHdoaXRlc3BhY2Utb25seSB2YWx1ZXMgYXJlIHRyZWF0ZWQgYXMgZW1wdHkuIE51bWJlciBzcGVjcyBkZWxlZ2F0ZSB0byBgcGFyc2VOdW1iZXJgLlxuICogQm9vbGVhbiBzcGVjcyB0cmVhdCBgMWAvYHRydWVgL2B5ZXNgL2BvbmAgKGNhc2UtaW5zZW5zaXRpdmUsIGFmdGVyIHRyaW0pIGFzIGB0cnVlYC5cbiAqIEVudW0gc3BlY3MgcmVxdWlyZSBhbiBleGFjdCBtYXRjaCBpbiBgY2hvaWNlc2AgKGFmdGVyIHRyaW0pLlxuICpcbiAqIEB0ZW1wbGF0ZSBLIC0gRW52aXJvbm1lbnQgdmFyaWFibGUga2V5IHR5cGUuXG4gKiBAdGVtcGxhdGUgUyAtIEVudmlyb25tZW50IHZhcmlhYmxlIHNwZWMgdHlwZS5cbiAqIEBwYXJhbSBrZXkgLSBFbnZpcm9ubWVudCB2YXJpYWJsZSBuYW1lLlxuICogQHBhcmFtIHNwZWMgLSBUeXBlIHNwZWMgZm9yIHRoZSB2YWx1ZS5cbiAqIEBwYXJhbSByYXcgLSBSYXcgdmFsdWUgZnJvbSBgcHJvY2Vzcy5lbnZgLCBpZiBwcmVzZW50LlxuICogQHBhcmFtIGRlZmF1bHRWYWx1ZSAtIEZhbGxiYWNrIHdoZW4gYHJhd2AgaXMgbWlzc2luZyBvciBlbXB0eS5cbiAqIEBwYXJhbSBvcHRpb25zIC0gT3B0aW9uYWwgdHJpbSBvdmVycmlkZSAoYHRyaW1gIGRlZmF1bHRzIHBlciBzcGVjIHR5cGUpLlxuICogQHJldHVybnMgUGFyc2VkIHZhbHVlIG9yIGEgc3RydWN0dXJlZCB2YWxpZGF0aW9uIGVycm9yLlxuICovXG5jb25zdCBwYXJzZUVudlZhbHVlID0gPEsgZXh0ZW5kcyBzdHJpbmcsIFMgZXh0ZW5kcyBTdHJpY3RFbnZTcGVjPihcbiAga2V5OiBLLFxuICBzcGVjOiBTLFxuICByYXc6IHN0cmluZyB8IHVuZGVmaW5lZCxcbiAgZGVmYXVsdFZhbHVlOiBTdHJpY3RFbnZTcGVjVG9UeXBlPFM+IHwgdW5kZWZpbmVkLFxuICBvcHRpb25zPzogUGFyc2VFbnZWYWx1ZU9wdGlvbnM8Uz4sXG4pOiBQYXJzZUVudlZhbHVlUmVzdWx0PEssIFM+ID0+IHtcbiAgY29uc3QgdHJpbSA9IG9wdGlvbnM/LnRyaW0gPz8gZGVmYXVsdFRyaW1Gb3JTcGVjKHNwZWMpO1xuICBjb25zdCBub3JtYWxpemVkUmF3ID0gbm9ybWFsaXplRW52UmF3KHJhdywgdHJpbSk7XG4gIGNvbnN0IGhhc0RlZmF1bHQgPSBkZWZhdWx0VmFsdWUgIT09IHVuZGVmaW5lZDtcblxuICBpZiAobm9ybWFsaXplZFJhdyA9PSBudWxsIHx8IG5vcm1hbGl6ZWRSYXcgPT09ICcnKSB7XG4gICAgaWYgKGhhc0RlZmF1bHQpIHtcbiAgICAgIHJldHVybiB7IG9rOiB0cnVlLCB2YWx1ZTogZGVmYXVsdFZhbHVlIGFzIFN0cmljdEVudlNwZWNUb1R5cGU8Uz4gfTtcbiAgICB9XG4gICAgcmV0dXJuIHtcbiAgICAgIG9rOiBmYWxzZSxcbiAgICAgIGVycm9yOiB7IGtleSwgbWVzc2FnZTogYE1pc3NpbmcgcmVxdWlyZWQgZW52aXJvbm1lbnQgdmFyaWFibGU6ICR7a2V5fWAsIHJhdywga2luZDogJ21pc3NpbmcnIH0sXG4gICAgfTtcbiAgfVxuXG4gIHN3aXRjaCAoc3BlYy50eXBlKSB7XG4gICAgY2FzZSAnbnVtYmVyJzoge1xuICAgICAgY29uc3QgbiA9IHBhcnNlTnVtYmVyKG5vcm1hbGl6ZWRSYXcpO1xuICAgICAgaWYgKG4gPT09IHVuZGVmaW5lZCkge1xuICAgICAgICByZXR1cm4ge1xuICAgICAgICAgIG9rOiBmYWxzZSxcbiAgICAgICAgICBlcnJvcjogeyBrZXksIG1lc3NhZ2U6IGBFbnYgJHtrZXl9OiBleHBlY3RlZCBudW1iZXIsIGdvdCBcIiR7cmF3fVwiYCwgcmF3LCBraW5kOiAnaW52YWxpZF9udW1iZXInIH0sXG4gICAgICAgIH07XG4gICAgICB9XG4gICAgICByZXR1cm4geyBvazogdHJ1ZSwgdmFsdWU6IG4gYXMgU3RyaWN0RW52U3BlY1RvVHlwZTxTPiB9O1xuICAgIH1cbiAgICBjYXNlICdib29sZWFuJzpcbiAgICAgIHJldHVybiB7IG9rOiB0cnVlLCB2YWx1ZTogcGFyc2VCb29sZWFuRW52VmFsdWUobm9ybWFsaXplZFJhdykgYXMgU3RyaWN0RW52U3BlY1RvVHlwZTxTPiB9O1xuICAgIGNhc2UgJ2VudW0nOlxuICAgICAgaWYgKCFzcGVjLmNob2ljZXMuaW5jbHVkZXMobm9ybWFsaXplZFJhdykpIHtcbiAgICAgICAgcmV0dXJuIHtcbiAgICAgICAgICBvazogZmFsc2UsXG4gICAgICAgICAgZXJyb3I6IHtcbiAgICAgICAgICAgIGtleSxcbiAgICAgICAgICAgIG1lc3NhZ2U6IGBFbnYgJHtrZXl9OiBtdXN0IGJlIG9uZSBvZiBbJHtzcGVjLmNob2ljZXMuam9pbignLCAnKX1dYCxcbiAgICAgICAgICAgIHJhdyxcbiAgICAgICAgICAgIGtpbmQ6ICdpbnZhbGlkX2VudW0nLFxuICAgICAgICAgIH0sXG4gICAgICAgIH07XG4gICAgICB9XG4gICAgICByZXR1cm4geyBvazogdHJ1ZSwgdmFsdWU6IG5vcm1hbGl6ZWRSYXcgYXMgU3RyaWN0RW52U3BlY1RvVHlwZTxTPiB9O1xuICAgIGRlZmF1bHQ6XG4gICAgICByZXR1cm4geyBvazogdHJ1ZSwgdmFsdWU6IG5vcm1hbGl6ZWRSYXcgYXMgU3RyaWN0RW52U3BlY1RvVHlwZTxTPiB9O1xuICB9XG59O1xuXG4vKipcbiAqIFJlYWRzIGFuZCBwYXJzZXMgYW4gZW52aXJvbm1lbnQgdmFyaWFibGUgYWNjb3JkaW5nIHRvIHRoZSBnaXZlbiBzcGVjLlxuICpcbiAqIERlbGVnYXRlcyB2YWxpZGF0aW9uIHRvIGBwYXJzZUVudlZhbHVlYC4gTWlzc2luZyBvciBlbXB0eSAoYFwiXCJgKSB2YWx1ZXMgdXNlXG4gKiBgb3B0aW9ucy5kZWZhdWx0YCB3aGVuIHByb3ZpZGVkOyBvdGhlcndpc2UgYSBgU3RyaWN0RW52VmFsaWRhdGlvbkVycm9yYCBpcyB0aHJvd24uXG4gKiBGb3IgYFN0cmljdEVudlR5cGUuTnVtYmVyYCwgdmFsdWVzIGFyZSBwYXJzZWQgYXMgZmluaXRlIG51bWJlcnMgKHNlZSBgU3RyaWN0RW52VHlwZU51bWJlcmApLlxuICpcbiAqIEB0ZW1wbGF0ZSBLIC0gRW52aXJvbm1lbnQgdmFyaWFibGUga2V5IHR5cGUuXG4gKiBAdGVtcGxhdGUgUyAtIEVudmlyb25tZW50IHZhcmlhYmxlIHNwZWMgdHlwZS5cbiAqIEBwYXJhbSBrZXkgLSBFbnZpcm9ubWVudCB2YXJpYWJsZSBuYW1lIChlLmcuIGBcIlBPUlRcImAsIGBcIk5PREVfRU5WXCJgKS5cbiAqIEBwYXJhbSBzcGVjIC0gVHlwZSBzcGVjOyBkZWZhdWx0cyB0byBgU3RyaWN0RW52VHlwZS5TdHJpbmdgIHdoZW4gb21pdHRlZC5cbiAqIEBwYXJhbSBvcHRpb25zIC0gT3B0aW9uYWwgYHsgZGVmYXVsdCwgdHJpbSB9YDsgc2VlIHtAbGluayBTdHJpY3RFbnZPcHRpb25zfS5cbiAqIEByZXR1cm5zIFBhcnNlZCB2YWx1ZSB3aXRoIHR5cGUgaW5mZXJyZWQgZnJvbSBgc3BlY2AuXG4gKiBAdGhyb3dzIHtTdHJpY3RFbnZWYWxpZGF0aW9uRXJyb3J9IFdoZW4gdGhlIHZhcmlhYmxlIGlzIG1pc3NpbmcsIGVtcHR5IHdpdGhvdXQgYSBkZWZhdWx0LCBvciBpbnZhbGlkIGZvciB0aGUgc3BlYy5cbiAqL1xuY29uc3QgcmVzb2x2ZSA9IDxLIGV4dGVuZHMgc3RyaW5nLCBTIGV4dGVuZHMgU3RyaWN0RW52U3BlYyA9IFN0cmljdEVudlR5cGVTdHJpbmc+KFxuICBrZXk6IEssXG4gIHNwZWM6IFMgPSBTdHJpY3RFbnZUeXBlLlN0cmluZyBhcyBTLFxuICBvcHRpb25zPzogU3RyaWN0RW52T3B0aW9uczxTPixcbik6IFN0cmljdEVudlNwZWNUb1R5cGU8Uz4gPT4ge1xuICBjb25zdCByZXN1bHQgPSBwYXJzZUVudlZhbHVlKGtleSwgc3BlYywgcHJvY2Vzcy5lbnZba2V5XSwgb3B0aW9ucz8uZGVmYXVsdCwgb3B0aW9ucyk7XG4gIGlmICghcmVzdWx0Lm9rKSB7XG4gICAgdGhyb3cgbmV3IFN0cmljdEVudlZhbGlkYXRpb25FcnJvcihbcmVzdWx0LmVycm9yXSk7XG4gIH1cbiAgcmV0dXJuIHJlc3VsdC52YWx1ZTtcbn07XG5cbi8qKlxuICogUmVhZHMgYW5kIHBhcnNlcyBtdWx0aXBsZSBlbnZpcm9ubWVudCB2YXJpYWJsZXMgYWNjb3JkaW5nIHRvIHRoZSBnaXZlbiBzY2hlbWEuXG4gKlxuICogQWx3YXlzIGV2YWx1YXRlcyBldmVyeSBrZXkgaW4gYHNjaGVtYWAuIEVhY2ggZW50cnkgaXMgdmFsaWRhdGVkIHZpYSBgcGFyc2VFbnZWYWx1ZWA7XG4gKiBhbGwgZXJyb3JzIGFyZSBjb2xsZWN0ZWQgYW5kIHRocm93biBvbmNlIGluIGEgc2luZ2xlIGBTdHJpY3RFbnZWYWxpZGF0aW9uRXJyb3JgLlxuICogTnVtYmVyIHNwZWNzIHVzZSB0aGUgc2FtZSBmaW5pdGUtbnVtYmVyIHJ1bGVzIGFzIGByZXNvbHZlYC5cbiAqXG4gKiBAdGVtcGxhdGUgVFNjaGVtYSAtIFNjaGVtYSBvYmplY3QgdHlwZS5cbiAqIEBwYXJhbSBzY2hlbWEgLSBNYXAgb2YgZW52aXJvbm1lbnQgdmFyaWFibGUgbmFtZXMgdG8gc3BlY3MsIG9wdGlvbmFsbHkgd2l0aCBwZXIta2V5IGRlZmF1bHRzIHZpYSBgW3NwZWMsIHsgZGVmYXVsdCB9XWAuXG4gKiBAcmV0dXJucyBQYXJzZWQgZW52aXJvbm1lbnQgb2JqZWN0IHdpdGggdHlwZXMgaW5mZXJyZWQgZnJvbSB0aGUgc2NoZW1hLlxuICogQHRocm93cyB7U3RyaWN0RW52VmFsaWRhdGlvbkVycm9yfSBXaGVuIG9uZSBvciBtb3JlIHZhcmlhYmxlcyBhcmUgbWlzc2luZywgZW1wdHkgd2l0aG91dCBhIGRlZmF1bHQsIG9yIGludmFsaWQuXG4gKi9cbmNvbnN0IHJlc29sdmVBbGwgPSA8VFNjaGVtYSBleHRlbmRzIFN0cmljdEVudlNjaGVtYT4oc2NoZW1hOiBUU2NoZW1hKTogU3RyaWN0RW52U2NoZW1hVG9UeXBlPFRTY2hlbWE+ID0+IHtcbiAgY29uc3QgZW52czogUGFydGlhbDxTdHJpY3RFbnZTY2hlbWFUb1R5cGU8VFNjaGVtYT4+ID0ge307XG4gIGNvbnN0IGVycm9yczogU3RyaWN0RW52VmFsaWRhdGlvbkVudHJ5PEV4dHJhY3Q8a2V5b2YgVFNjaGVtYSwgc3RyaW5nPj5bXSA9IFtdO1xuXG4gIGZvciAoY29uc3Qga2V5IG9mIE9iamVjdC5rZXlzKHNjaGVtYSkgYXMgQXJyYXk8RXh0cmFjdDxrZXlvZiBUU2NoZW1hLCBzdHJpbmc+Pikge1xuICAgIGNvbnN0IHsgc3BlYywgb3B0aW9ucyB9ID0gcmVzb2x2ZVNjaGVtYUVudHJ5KHNjaGVtYVtrZXldKTtcblxuICAgIGNvbnN0IHJlc3VsdCA9IHBhcnNlRW52VmFsdWUoa2V5LCBzcGVjLCBwcm9jZXNzLmVudltrZXldLCBvcHRpb25zPy5kZWZhdWx0LCBvcHRpb25zKTtcbiAgICBpZiAoIXJlc3VsdC5vaykge1xuICAgICAgZXJyb3JzLnB1c2gocmVzdWx0LmVycm9yKTtcbiAgICAgIGNvbnRpbnVlO1xuICAgIH1cbiAgICBlbnZzW2tleV0gPSByZXN1bHQudmFsdWUgYXMgU3RyaWN0RW52U2NoZW1hVG9UeXBlPFRTY2hlbWE+W3R5cGVvZiBrZXldO1xuICB9XG5cbiAgaWYgKGVycm9ycy5sZW5ndGggPiAwKSB0aHJvdyBuZXcgU3RyaWN0RW52VmFsaWRhdGlvbkVycm9yKGVycm9ycyk7XG4gIHJldHVybiBlbnZzIGFzIFN0cmljdEVudlNjaGVtYVRvVHlwZTxUU2NoZW1hPjtcbn07XG5cbi8qKlxuICogVHlwZS1zYWZlIGVudmlyb25tZW50IHZhcmlhYmxlIHJlc29sdmVyIGZvciBOb2RlLmpzIGBwcm9jZXNzLmVudmAuXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHRzXG4gKiBjb25zdCBwb3J0ID0gU3RyaWN0RW52UmVzb2x2ZXIucmVzb2x2ZSgnUE9SVCcsIFN0cmljdEVudlR5cGUuTnVtYmVyKTtcbiAqIGNvbnN0IGVudnMgPSBTdHJpY3RFbnZSZXNvbHZlci5yZXNvbHZlQWxsKHtcbiAqICAgUE9SVDogU3RyaWN0RW52VHlwZS5OdW1iZXIsXG4gKiAgIERFQlVHOiBbU3RyaWN0RW52VHlwZS5Cb29sZWFuLCB7IGRlZmF1bHQ6IGZhbHNlIH1dLFxuICogfSk7XG4gKiBgYGBcbiAqL1xuZXhwb3J0IGNvbnN0IFN0cmljdEVudlJlc29sdmVyID0ge1xuICAvKiogUmVhZHMgYW5kIHBhcnNlcyBhIHNpbmdsZSBlbnZpcm9ubWVudCB2YXJpYWJsZS4gU2VlIHtAbGluayByZXNvbHZlfS4gKi9cbiAgcmVzb2x2ZSxcbiAgLyoqIFJlYWRzIGFuZCBwYXJzZXMgbXVsdGlwbGUgZW52aXJvbm1lbnQgdmFyaWFibGVzIGluIG9uZSBwYXNzLiBTZWUge0BsaW5rIHJlc29sdmVBbGx9LiAqL1xuICByZXNvbHZlQWxsLFxufSBhcyBjb25zdDtcbiJdfQ==

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "strict-env-resolver",
+  "description": "Type-safe environment variable getter for Node.js. Reads and parses process.env with specs (string, number, boolean, enum), optional defaults, and structured validation errors when values are missing or invalid.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gammarers-labs/strict-env-resolver.git"
+  },
+  "scripts": {
+    "build": "projen build",
+    "bump": "projen bump",
+    "clobber": "projen clobber",
+    "compile": "projen compile",
+    "default": "projen default",
+    "eject": "projen eject",
+    "eslint": "projen eslint",
+    "package": "projen package",
+    "post-compile": "projen post-compile",
+    "post-upgrade": "projen post-upgrade",
+    "pre-compile": "projen pre-compile",
+    "release": "projen release",
+    "test": "projen test",
+    "test:watch": "projen test:watch",
+    "unbump": "projen unbump",
+    "upgrade": "projen upgrade",
+    "watch": "projen watch",
+    "projen": "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.5",
+    "eslint-plugin-import": "^2.32.0",
+    "jest": "^30.4.2",
+    "jest-junit": "^17",
+    "projen": "^0.100.2",
+    "ts-jest": "^29.4.11",
+    "ts-node": "^10.9.2",
+    "typescript": "5.9.x"
+  },
+  "keywords": [
+    "env",
+    "environment",
+    "getter",
+    "safe",
+    "variables"
+  ],
+  "engines": {
+    "node": ">= 20.0.0"
+  },
+  "main": "lib/index.js",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.5.1",
+  "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\"."
+}