@agnostack/env 1.4.0-beta.1 → 2.0.0-beta.1

package/LICENSE

@@ -1,3 +1,4 @@
+@license
 MIT License
 
 Copyright (c) 2021-present agnoStack, Inc. and Adam Grohs

package/dist/display.d.ts

@@ -1,3 +1,3 @@
-export function ensureStringOnly(string: any): string;
-export function stringNotEmptyOnly(stringable: any): boolean;
-export function stringEmptyOnly(stringable: any): boolean;
+export function ensureStringOnly(string: unknown): string;
+export function stringNotEmptyOnly(stringable: unknown): boolean;
+export function stringEmptyOnly(stringable: unknown): boolean;

package/dist/display.js

@@ -2,14 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stringEmptyOnly = exports.stringNotEmptyOnly = exports.ensureStringOnly = void 0;
 // HMMM: what if 'string' is an object?
+/** @param {unknown} string @returns {string} */
 const ensureStringOnly = (string) => (
 // eslint-disable-next-line eqeqeq
 (string != undefined) ? `${string}` : '');
 exports.ensureStringOnly = ensureStringOnly;
+/** @param {unknown} stringable @returns {boolean} */
 const stringNotEmptyOnly = (stringable) => {
     const string = (0, exports.ensureStringOnly)(stringable);
     return ((string.length > 0) && !['null', 'undefined'].includes(string));
 };
 exports.stringNotEmptyOnly = stringNotEmptyOnly;
+/** @param {unknown} stringable @returns {boolean} */
 const stringEmptyOnly = (stringable) => (!(0, exports.stringNotEmptyOnly)(stringable));
 exports.stringEmptyOnly = stringEmptyOnly;

package/dist/env.d.ts

@@ -5,36 +5,30 @@ export namespace ENV_PREFIX {
     let DEFAULT: string;
 }
 export const ENV_PREFIXES: string[];
-export function nextKeyValidator(envKey: any): boolean;
-export function lowerKeyValidator(envKey: any): boolean;
-export function publicKeyValidator(envKey: any): boolean;
-export function cleanLowerEnv(_env: any, keyValidator?: (envKey: any) => boolean): {
-    [x: string]: any;
-};
-export function cleanPublicEnv(_env: any, keyValidator?: (envKey: any) => boolean): {
-    [x: string]: any;
-};
+export function nextKeyValidator(envKey: string): boolean;
+export function lowerKeyValidator(envKey: string): boolean;
+export function publicKeyValidator(envKey: string): boolean;
+export function cleanLowerEnv(_env: Record<string, string | undefined> | undefined, keyValidator?: (envKey: string) => boolean): Record<string, string | undefined>;
+export function cleanPublicEnv(_env: Record<string, string | undefined> | undefined, keyValidator?: (envKey: string) => boolean): Record<string, string | undefined>;
 export function parseEnvData(_env?: NodeJS.ProcessEnv): {
     env: Record<string, string> & {
         ENVIRONMENT: string;
     };
-    nextEnv: {
-        [x: string]: any;
-    };
-    publicEnv: {
-        [x: string]: any;
-    };
+    nextEnv: Record<string, string | undefined>;
+    publicEnv: Record<string, string | undefined>;
     stringifiedEnv: Record<string, string>;
-    argParams: Record<string, string>;
+    argParams: {
+        [x: string]: string | undefined;
+    };
     params: {
-        [x: string]: string;
+        [x: string]: string | undefined;
         ENVIRONMENT: string;
     };
     args: string[];
 };
-export function getPublicEnvValue(publicEnv: any, key: any): any;
-export function replaceEnvTemplate(replaceable: any, { env: _env, template, callback, }?: {
-    env?: NodeJS.ProcessEnv;
+export function getPublicEnvValue(publicEnv: Record<string, string | undefined> | undefined, key: string): string | undefined;
+export function replaceEnvTemplate(replaceable: unknown, { env: _env, template, callback, }?: {
+    env?: Record<string, string | undefined>;
     template?: RegExp;
-    callback?: (replacedValue: any, _replaceable: any) => any;
+    callback?: (replacedValue: string, replaceable: string) => string;
 }): string;

package/dist/env.js

@@ -20,38 +20,60 @@ exports.ENV_PREFIX = {
     DEFAULT: 'PUBLIC_',
 };
 exports.ENV_PREFIXES = Object.values(exports.ENV_PREFIX);
+/** @param {string} envKey @returns {boolean} */
 const nextKeyValidator = (envKey) => (
 // NOTE: not allowed by NEXT: https://nextjs.org/docs/messages/env-key-not-allowed
 !(envKey.startsWith('__') || envKey.startsWith('NODE_')));
 exports.nextKeyValidator = nextKeyValidator;
+/** @param {string} envKey @returns {boolean} */
 const lowerKeyValidator = (envKey) => ((0, exports.nextKeyValidator)(envKey) &&
     /^[^A-Z]*$/.test(envKey));
 exports.lowerKeyValidator = lowerKeyValidator;
+/** @param {string} envKey @returns {boolean} */
 const publicKeyValidator = (envKey) => (exports.ENV_PREFIXES.some((envPrefix) => envKey === null || envKey === void 0 ? void 0 : envKey.startsWith(envPrefix)) ||
     ['NODE_ENV', 'PORT', 'ENVIRONMENT', 'DEBUG', 'SCOPES', 'SHOPIFY_API_SCOPES'].includes(envKey));
 exports.publicKeyValidator = publicKeyValidator;
 // TODO: move to processBatch???
+/** @param {Record<string, string | undefined> | undefined} _env @returns {Record<string, string>} */
 const stringifyEnv = (_env) => (Object.entries(_env !== null && _env !== void 0 ? _env : {}).reduce((__env, [key, val]) => (Object.assign(Object.assign({}, __env), { 
     // NOTE: DefinePlugin requires stringified
     [key]: JSON.stringify(val) })), /** @type {Record<string, string>} */ ({})));
 // TODO: move to processBatch???
+/**
+ * @param {Record<string, string | undefined> | undefined} _env
+ * @param {(envKey: string) => boolean} [keyValidator]
+ * @returns {Record<string, string | undefined>}
+ */
 const cleanEnv = (_env, keyValidator = exports.nextKeyValidator) => (Object.entries(_env !== null && _env !== void 0 ? _env : []).reduce((__env, [key, val]) => (Object.assign(Object.assign({}, __env), keyValidator(key) && {
     [key]: val,
-})), /** @type {Record<string, string>} */ ({})));
+})), /** @type {Record<string, string | undefined>} */ ({})));
+/**
+ * @param {Record<string, string | undefined> | undefined} _env
+ * @param {(envKey: string) => boolean} [keyValidator]
+ * @returns {Record<string, string | undefined>}
+ */
 const cleanLowerEnv = (_env, keyValidator = exports.lowerKeyValidator) => (cleanEnv(process.env, keyValidator));
 exports.cleanLowerEnv = cleanLowerEnv;
+/**
+ * @param {Record<string, string | undefined> | undefined} _env
+ * @param {(envKey: string) => boolean} [keyValidator]
+ * @returns {Record<string, string | undefined>}
+ */
 const cleanPublicEnv = (_env, keyValidator = exports.publicKeyValidator) => (cleanEnv(_env, keyValidator));
 exports.cleanPublicEnv = cleanPublicEnv;
 const parseEnvData = (_env = process.env) => {
+    var _a;
     const { ENVIRONMENT, SITE_ENV, BUILD_ENV, NODE_ENV } = _env;
-    const _environment = [SITE_ENV, BUILD_ENV, NODE_ENV, 'development'].find((value) => (0, display_js_1.stringNotEmptyOnly)(value));
+    // NOTE: the trailing ?? mirrors the 'development' already last in the list — find() is always
+    // satisfied by it, but the fallback is what lets this type as string rather than string|undefined.
+    const _environment = (_a = [SITE_ENV, BUILD_ENV, NODE_ENV, 'development'].find((value) => (0, display_js_1.stringNotEmptyOnly)(value))) !== null && _a !== void 0 ? _a : 'development';
     // NOTE: annotated so the index signature survives the spread — without it consumers get
     // a type with only ENVIRONMENT on it and every other `env.SOME_VAR` lookup is an error.
     /** @type {Record<string, string> & { ENVIRONMENT: string }} */
     const mergedEnv = Object.assign(Object.assign({}, _env), { 
         // NOTE: intentionally giving precedence to ENVIRONMENT
         ENVIRONMENT: ENVIRONMENT || _environment });
-    const _a = process.argv.reduce(({ args: _args, argParams: _argParams, }, arg) => {
+    const _b = process.argv.reduce(({ args: _args, argParams: _argParams, }, arg) => {
         var _a, _b, _c, _d, _e;
         // NOTE: split on the FIRST '=' only — everything after it is the value, verbatim.
         // Splitting on every '=' truncated any value that contained one, so `--context=env=prod`
@@ -67,12 +89,13 @@ const parseEnvData = (_env = process.env) => {
                 argParams: _argParams,
             };
         }
+        /** @type {[string, string | undefined]} */
         let entry = [_param, _value];
         // NOTE: this handles serverless args similar to "--param=env=development" — the value is
         // itself a key=value pair, so it splits on its own first '=' for the same reason.
         if (_param === 'param') {
             const valueSeparatorIndex = (_e = (_d = _value === null || _value === void 0 ? void 0 : _value.indexOf) === null || _d === void 0 ? void 0 : _d.call(_value, '=')) !== null && _e !== void 0 ? _e : -1;
-            if (valueSeparatorIndex > 0) {
+            if (_value && (valueSeparatorIndex > 0)) {
                 entry = [_value.slice(0, valueSeparatorIndex), _value.slice(valueSeparatorIndex + 1)];
             }
         }
@@ -89,14 +112,20 @@ const parseEnvData = (_env = process.env) => {
     }, {
         args: /** @type {string[]} */ ([]),
         argParams: /** @type {Record<string, string>} */ ({}),
-    }), { argParams } = _a, output = __rest(_a, ["argParams"]);
+    }), { argParams } = _b, output = __rest(_b, ["argParams"]);
     const nextEnv = cleanEnv(mergedEnv);
     const publicEnv = (0, exports.cleanPublicEnv)(mergedEnv);
     return Object.assign(Object.assign({}, output), { env: mergedEnv, nextEnv,
         publicEnv, stringifiedEnv: stringifyEnv(publicEnv), argParams, params: Object.assign(Object.assign({}, mergedEnv), argParams) });
 };
 exports.parseEnvData = parseEnvData;
+/**
+ * @param {Record<string, string | undefined> | undefined} publicEnv
+ * @param {string} key
+ * @returns {string | undefined}
+ */
 const getPublicEnvValue = (publicEnv, key) => {
+    /** @type {string | undefined} */
     let envValue;
     if ((0, display_js_1.stringEmptyOnly)(key) || !publicEnv) {
         return envValue;
@@ -128,6 +157,15 @@ const getPublicEnvValue = (publicEnv, key) => {
     return envValue;
 };
 exports.getPublicEnvValue = getPublicEnvValue;
+/**
+ * @param {unknown} replaceable
+ * @param {{
+ *   env?: Record<string, string | undefined>,
+ *   template?: RegExp,
+ *   callback?: (replacedValue: string, replaceable: string) => string,
+ * }} [options]
+ * @returns {string}
+ */
 const replaceEnvTemplate = (replaceable, { env: _env = process.env, template = /\{\{process\.env\.(\w+)\}\}/g, 
 // NOTE: the second arg is the matched token — declared so the default's signature matches
 // how it is actually invoked below, even though the default ignores it.
@@ -136,6 +174,6 @@ callback = (replacedValue, _replaceable) => replacedValue, } = {}) => ((0, displ
     if ((0, display_js_1.stringEmptyOnly)(replacedValue)) {
         return replaceable;
     }
-    return callback(replacedValue, replaceable);
+    return callback(/** @type {string} */ (replacedValue), replaceable);
 }));
 exports.replaceEnvTemplate = replaceEnvTemplate;

package/dist/esm/display.js

@@ -1,9 +1,12 @@
 // HMMM: what if 'string' is an object?
+/** @param {unknown} string @returns {string} */
 export const ensureStringOnly = (string) => (
 // eslint-disable-next-line eqeqeq
 (string != undefined) ? `${string}` : '');
+/** @param {unknown} stringable @returns {boolean} */
 export const stringNotEmptyOnly = (stringable) => {
     const string = ensureStringOnly(stringable);
     return ((string.length > 0) && !['null', 'undefined'].includes(string));
 };
+/** @param {unknown} stringable @returns {boolean} */
 export const stringEmptyOnly = (stringable) => (!stringNotEmptyOnly(stringable));

package/dist/esm/env.js

@@ -17,33 +17,55 @@ export const ENV_PREFIX = {
     DEFAULT: 'PUBLIC_',
 };
 export const ENV_PREFIXES = Object.values(ENV_PREFIX);
+/** @param {string} envKey @returns {boolean} */
 export const nextKeyValidator = (envKey) => (
 // NOTE: not allowed by NEXT: https://nextjs.org/docs/messages/env-key-not-allowed
 !(envKey.startsWith('__') || envKey.startsWith('NODE_')));
+/** @param {string} envKey @returns {boolean} */
 export const lowerKeyValidator = (envKey) => (nextKeyValidator(envKey) &&
     /^[^A-Z]*$/.test(envKey));
+/** @param {string} envKey @returns {boolean} */
 export const publicKeyValidator = (envKey) => (ENV_PREFIXES.some((envPrefix) => envKey === null || envKey === void 0 ? void 0 : envKey.startsWith(envPrefix)) ||
     ['NODE_ENV', 'PORT', 'ENVIRONMENT', 'DEBUG', 'SCOPES', 'SHOPIFY_API_SCOPES'].includes(envKey));
 // TODO: move to processBatch???
+/** @param {Record<string, string | undefined> | undefined} _env @returns {Record<string, string>} */
 const stringifyEnv = (_env) => (Object.entries(_env !== null && _env !== void 0 ? _env : {}).reduce((__env, [key, val]) => (Object.assign(Object.assign({}, __env), { 
     // NOTE: DefinePlugin requires stringified
     [key]: JSON.stringify(val) })), /** @type {Record<string, string>} */ ({})));
 // TODO: move to processBatch???
+/**
+ * @param {Record<string, string | undefined> | undefined} _env
+ * @param {(envKey: string) => boolean} [keyValidator]
+ * @returns {Record<string, string | undefined>}
+ */
 const cleanEnv = (_env, keyValidator = nextKeyValidator) => (Object.entries(_env !== null && _env !== void 0 ? _env : []).reduce((__env, [key, val]) => (Object.assign(Object.assign({}, __env), keyValidator(key) && {
     [key]: val,
-})), /** @type {Record<string, string>} */ ({})));
+})), /** @type {Record<string, string | undefined>} */ ({})));
+/**
+ * @param {Record<string, string | undefined> | undefined} _env
+ * @param {(envKey: string) => boolean} [keyValidator]
+ * @returns {Record<string, string | undefined>}
+ */
 export const cleanLowerEnv = (_env, keyValidator = lowerKeyValidator) => (cleanEnv(process.env, keyValidator));
+/**
+ * @param {Record<string, string | undefined> | undefined} _env
+ * @param {(envKey: string) => boolean} [keyValidator]
+ * @returns {Record<string, string | undefined>}
+ */
 export const cleanPublicEnv = (_env, keyValidator = publicKeyValidator) => (cleanEnv(_env, keyValidator));
 export const parseEnvData = (_env = process.env) => {
+    var _a;
     const { ENVIRONMENT, SITE_ENV, BUILD_ENV, NODE_ENV } = _env;
-    const _environment = [SITE_ENV, BUILD_ENV, NODE_ENV, 'development'].find((value) => stringNotEmptyOnly(value));
+    // NOTE: the trailing ?? mirrors the 'development' already last in the list — find() is always
+    // satisfied by it, but the fallback is what lets this type as string rather than string|undefined.
+    const _environment = (_a = [SITE_ENV, BUILD_ENV, NODE_ENV, 'development'].find((value) => stringNotEmptyOnly(value))) !== null && _a !== void 0 ? _a : 'development';
     // NOTE: annotated so the index signature survives the spread — without it consumers get
     // a type with only ENVIRONMENT on it and every other `env.SOME_VAR` lookup is an error.
     /** @type {Record<string, string> & { ENVIRONMENT: string }} */
     const mergedEnv = Object.assign(Object.assign({}, _env), { 
         // NOTE: intentionally giving precedence to ENVIRONMENT
         ENVIRONMENT: ENVIRONMENT || _environment });
-    const _a = process.argv.reduce(({ args: _args, argParams: _argParams, }, arg) => {
+    const _b = process.argv.reduce(({ args: _args, argParams: _argParams, }, arg) => {
         var _a, _b, _c, _d, _e;
         // NOTE: split on the FIRST '=' only — everything after it is the value, verbatim.
         // Splitting on every '=' truncated any value that contained one, so `--context=env=prod`
@@ -59,12 +81,13 @@ export const parseEnvData = (_env = process.env) => {
                 argParams: _argParams,
             };
         }
+        /** @type {[string, string | undefined]} */
         let entry = [_param, _value];
         // NOTE: this handles serverless args similar to "--param=env=development" — the value is
         // itself a key=value pair, so it splits on its own first '=' for the same reason.
         if (_param === 'param') {
             const valueSeparatorIndex = (_e = (_d = _value === null || _value === void 0 ? void 0 : _value.indexOf) === null || _d === void 0 ? void 0 : _d.call(_value, '=')) !== null && _e !== void 0 ? _e : -1;
-            if (valueSeparatorIndex > 0) {
+            if (_value && (valueSeparatorIndex > 0)) {
                 entry = [_value.slice(0, valueSeparatorIndex), _value.slice(valueSeparatorIndex + 1)];
             }
         }
@@ -81,13 +104,19 @@ export const parseEnvData = (_env = process.env) => {
     }, {
         args: /** @type {string[]} */ ([]),
         argParams: /** @type {Record<string, string>} */ ({}),
-    }), { argParams } = _a, output = __rest(_a, ["argParams"]);
+    }), { argParams } = _b, output = __rest(_b, ["argParams"]);
     const nextEnv = cleanEnv(mergedEnv);
     const publicEnv = cleanPublicEnv(mergedEnv);
     return Object.assign(Object.assign({}, output), { env: mergedEnv, nextEnv,
         publicEnv, stringifiedEnv: stringifyEnv(publicEnv), argParams, params: Object.assign(Object.assign({}, mergedEnv), argParams) });
 };
+/**
+ * @param {Record<string, string | undefined> | undefined} publicEnv
+ * @param {string} key
+ * @returns {string | undefined}
+ */
 export const getPublicEnvValue = (publicEnv, key) => {
+    /** @type {string | undefined} */
     let envValue;
     if (stringEmptyOnly(key) || !publicEnv) {
         return envValue;
@@ -118,6 +147,15 @@ export const getPublicEnvValue = (publicEnv, key) => {
     }
     return envValue;
 };
+/**
+ * @param {unknown} replaceable
+ * @param {{
+ *   env?: Record<string, string | undefined>,
+ *   template?: RegExp,
+ *   callback?: (replacedValue: string, replaceable: string) => string,
+ * }} [options]
+ * @returns {string}
+ */
 export const replaceEnvTemplate = (replaceable, { env: _env = process.env, template = /\{\{process\.env\.(\w+)\}\}/g, 
 // NOTE: the second arg is the matched token — declared so the default's signature matches
 // how it is actually invoked below, even though the default ignores it.
@@ -126,5 +164,5 @@ callback = (replacedValue, _replaceable) => replacedValue, } = {}) => (ensureStr
     if (stringEmptyOnly(replacedValue)) {
         return replaceable;
     }
-    return callback(replacedValue, replaceable);
+    return callback(/** @type {string} */ (replacedValue), replaceable);
 }));

package/dist/esm/project.js

@@ -1,4 +1,5 @@
 import { ensureStringOnly } from './display.js';
+/** @param {unknown} _name */
 export const parseProjectName = (_name) => {
     var _a;
     const name = ensureStringOnly(_name);
@@ -11,6 +12,29 @@ export const parseProjectName = (_name) => {
         projectName,
     };
 };
+/**
+ * The subset of a package.json this reads. Everything is optional — callers pass raw
+ * manifests, and the parser is deliberately tolerant of a missing or partial object.
+ *
+ * @typedef {object} PackageInfo
+ * @property {string} [name]
+ * @property {string} [version]
+ * @property {string[]} [keywords]
+ * @property {string} [owner]
+ * @property {string} [appName]
+ * @property {string} [siteName]
+ * @property {string} [shortName]
+ * @property {string} [siteHandle]
+ * @property {string} [siteAuthor]
+ * @property {Record<string, string>} [dependencies]
+ * @property {Record<string, string>} [devDependencies]
+ * @property {Record<string, string>} [peerDependencies]
+ * @property {Record<string, string>} [optionalDependencies]
+ * @property {string[]} [bundleDependencies]
+ * @property {string[]} [bundledDependencies]
+ * @property {string[]} [browserDependencies]
+ */
+/** @param {PackageInfo} [packageInfo] */
 export const parsePackageInfo = (packageInfo) => {
     const { version, keywords, shortName, siteHandle, siteAuthor, devDependencies, peerDependencies, bundleDependencies, bundledDependencies = bundleDependencies, dependencies: runtimeDependencies, optionalDependencies, browserDependencies, name: _name, owner: _appOwner, appName: _appName, siteName: _siteName, } = packageInfo !== null && packageInfo !== void 0 ? packageInfo : {};
     const { name, organization, projectName } = parseProjectName(_name);

package/dist/project.d.ts

@@ -1,24 +1,46 @@
-export function parseProjectName(_name: any): {
+export function parseProjectName(_name: unknown): {
     name: string;
     parts: string[];
     organization: string;
     projectName: string;
 };
-export function parsePackageInfo(packageInfo: any): [{
-    keywords: any;
-    appOwner: any;
-    appName: any;
-    version: any;
-    siteName: any;
-    shortName: any;
-    siteHandle: any;
-    siteAuthor: any;
+export function parsePackageInfo(packageInfo?: PackageInfo): [{
+    keywords: string[] | undefined;
+    appOwner: string;
+    appName: string;
+    version: string | undefined;
+    siteName: string;
+    shortName: string | undefined;
+    siteHandle: string | undefined;
+    siteAuthor: string | undefined;
     companyName: string;
     projectName: string;
-    devDependencies: any;
-    peerDependencies: any;
-    bundledDependencies: any;
-    runtimeDependencies: any;
-    browserDependencies: any;
-    optionalDependencies: any;
-}, string, string];
+    devDependencies: Record<string, string> | undefined;
+    peerDependencies: Record<string, string> | undefined;
+    bundledDependencies: string[] | undefined;
+    runtimeDependencies: Record<string, string> | undefined;
+    browserDependencies: string[] | undefined;
+    optionalDependencies: Record<string, string> | undefined;
+}, string | undefined, string];
+/**
+ * The subset of a package.json this reads. Everything is optional — callers pass raw
+ * manifests, and the parser is deliberately tolerant of a missing or partial object.
+ */
+export type PackageInfo = {
+    name?: string | undefined;
+    version?: string | undefined;
+    keywords?: string[] | undefined;
+    owner?: string | undefined;
+    appName?: string | undefined;
+    siteName?: string | undefined;
+    shortName?: string | undefined;
+    siteHandle?: string | undefined;
+    siteAuthor?: string | undefined;
+    dependencies?: Record<string, string> | undefined;
+    devDependencies?: Record<string, string> | undefined;
+    peerDependencies?: Record<string, string> | undefined;
+    optionalDependencies?: Record<string, string> | undefined;
+    bundleDependencies?: string[] | undefined;
+    bundledDependencies?: string[] | undefined;
+    browserDependencies?: string[] | undefined;
+};

package/dist/project.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parsePackageInfo = exports.parseProjectName = void 0;
 const display_js_1 = require("./display.js");
+/** @param {unknown} _name */
 const parseProjectName = (_name) => {
     var _a;
     const name = (0, display_js_1.ensureStringOnly)(_name);
@@ -15,6 +16,29 @@ const parseProjectName = (_name) => {
     };
 };
 exports.parseProjectName = parseProjectName;
+/**
+ * The subset of a package.json this reads. Everything is optional — callers pass raw
+ * manifests, and the parser is deliberately tolerant of a missing or partial object.
+ *
+ * @typedef {object} PackageInfo
+ * @property {string} [name]
+ * @property {string} [version]
+ * @property {string[]} [keywords]
+ * @property {string} [owner]
+ * @property {string} [appName]
+ * @property {string} [siteName]
+ * @property {string} [shortName]
+ * @property {string} [siteHandle]
+ * @property {string} [siteAuthor]
+ * @property {Record<string, string>} [dependencies]
+ * @property {Record<string, string>} [devDependencies]
+ * @property {Record<string, string>} [peerDependencies]
+ * @property {Record<string, string>} [optionalDependencies]
+ * @property {string[]} [bundleDependencies]
+ * @property {string[]} [bundledDependencies]
+ * @property {string[]} [browserDependencies]
+ */
+/** @param {PackageInfo} [packageInfo] */
 const parsePackageInfo = (packageInfo) => {
     const { version, keywords, shortName, siteHandle, siteAuthor, devDependencies, peerDependencies, bundleDependencies, bundledDependencies = bundleDependencies, dependencies: runtimeDependencies, optionalDependencies, browserDependencies, name: _name, owner: _appOwner, appName: _appName, siteName: _siteName, } = packageInfo !== null && packageInfo !== void 0 ? packageInfo : {};
     const { name, organization, projectName } = (0, exports.parseProjectName)(_name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agnostack/env",
-  "version": "1.4.0-beta.1",
+  "version": "2.0.0-beta.1",
   "author": "agnoStack Dev <developers@agnostack.com> (https://agnostack.com)",
   "owner": "agnoStack",
   "description": "Please contact agnoStack via info@agnostack.com for any questions",
@@ -36,52 +36,52 @@
     "*.md"
   ],
   "engines": {
-    "node": ">=18.x"
+    "node": ">=22.x"
   },
   "scripts": {
     "tsc": "npx -p typescript tsc",
-    "watch": "yarn tsc -w",
-    "prebuild": "yarn tsc --build --clean && npx rimraf@4.4.1 dist _storage",
-    "build": "yarn tsc && yarn tsc -p tsconfig.esm.json && node scripts/write-esm-pkg.mjs",
-    "clean": "npx rimraf@4.4.1 dist node_modules _storage",
+    "watch": "yarn tsc -p tsconfig.build.json -w",
+    "prebuild": "yarn tsc -b tsconfig.build.json --clean && node scripts/clean.mjs dist _storage",
+    "build": "yarn tsc -p tsconfig.build.json && yarn tsc -p tsconfig.esm.json && node scripts/write-esm-pkg.mjs",
+    "clean": "node scripts/clean.mjs dist node_modules _storage",
     "clean:install": "yarn clean && yarn install --force",
-    "lint": "eslint 'src/**' --fix",
-    "typecheck": "yarn tsc -p tsconfig.test.json",
-    "test": "jest",
-    "release": "npx semantic-release@22.0.12",
+    "lint:fix": "eslint . --fix",
+    "lint": "eslint .",
+    "typecheck": "yarn tsc",
+    "verify:dist": "node scripts/verify-dist.mjs",
+    "test:watch": "vitest",
+    "test": "vitest run",
+    "release": "semantic-release",
     "release:debug": "yarn release --debug",
-    "prepare": "husky install"
+    "prepublishOnly": "yarn verify:dist",
+    "prepare": "husky"
   },
   "lint-staged": {
     "{src,test,types}/**/*.{js,ts}": [
       "eslint --fix"
     ]
   },
+  "sideEffects": false,
   "devDependencies": {
-    "@commitlint/cli": "18.6.1",
-    "@commitlint/config-conventional": "18.6.1",
+    "@commitlint/cli": "19.x",
+    "@commitlint/config-conventional": "19.x",
+    "@eslint/js": "9.x",
     "@semantic-release/changelog": "6.0.3",
     "@semantic-release/git": "10.0.1",
-    "@semantic-release/github": "9.2.6",
-    "@semantic-release/npm": "11.0.3",
-    "@semantic-release/release-notes-generator": "12.1.0",
-    "@types/jest": "29.x",
-    "@types/node": "18.x",
-    "@typescript-eslint/eslint-plugin": "6.3.0",
-    "@typescript-eslint/parser": "6.3.0",
-    "eslint": "8.23.0",
-    "eslint-plugin-import": "2.26.0",
-    "husky": "6.0.0",
-    "jest": "29.x",
-    "lint-staged": "11.0.0",
-    "rimraf": "4.4.1",
-    "semantic-release": "22.0.12",
-    "ts-jest": "29.x",
-    "typescript": "5.4.2"
-  },
-  "resolutions": {
-    "**/npm": "10.8.2",
-    "**/rimraf": "4.4.1"
+    "@semantic-release/github": "11.x",
+    "@semantic-release/npm": "12.x",
+    "@semantic-release/release-notes-generator": "14.x",
+    "@types/node": "22.x",
+    "@typescript-eslint/eslint-plugin": "8.x",
+    "@typescript-eslint/parser": "8.x",
+    "eslint": "9.x",
+    "eslint-plugin-import": "2.x",
+    "globals": "16.x",
+    "husky": "9.x",
+    "lint-staged": "15.x",
+    "semantic-release": "25.x",
+    "typescript": "5.9.3",
+    "vitest": "3.x"
   },
   "publishConfig": {
     "access": "public"