@stryke/env 0.1.2

package/LICENSE

@@ -0,0 +1,201 @@
+                                 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,62 @@
+<!-- START header -->
+<!-- END header -->
+
+# env
+
+A package containing utility functions to handle environment specific processes
+
+<!-- START doctoc -->
+<!-- END doctoc -->
+
+## Installing
+
+Using [pnpm](http://pnpm.io):
+
+```bash
+pnpm add -D stryke/env
+```
+
+<details>
+  <summary>Using npm</summary>
+
+```bash
+npm install -D stryke/env
+```
+
+</details>
+
+<details>
+  <summary>Using yarn</summary>
+
+```bash
+yarn add -D stryke/env
+```
+
+</details>
+
+## Reduced Package Size
+
+This project uses [tsup](https://tsup.egoist.dev/) to package the source code
+due to its ability to remove unused code and ship smaller javascript files
+thanks to code splitting. This helps to greatly reduce the size of the package
+and to make it easier to use in other projects.
+
+## Development
+
+This project is built using [Nx](https://nx.dev). As a result, many of the usual
+commands are available to assist in development.
+
+### Building
+
+Run `nx build env` to build the library.
+
+### Running unit tests
+
+Run `nx test env` to execute the unit tests via [Jest](https://jestjs.io).
+
+### Linting
+
+Run `nx lint env` to run [ESLint](https://eslint.org/) on the package.
+
+<!-- START footer -->
+<!-- END footer -->

package/dist/ci-checks.cjs

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isInteractive = exports.isCI = void 0;
+var _providers = require("./providers.cjs");
+const isCI = (I = process.env) => !!(I.STORM_CI || I.CI || I.CONTINUOUS_INTEGRATION || I.BUILD_NUMBER || I.RUN_ID || I.AGOLA_GIT_REF || I.AC_APPCIRCLE || I.APPVEYOR || I.CODEBUILD || I.TF_BUILD || I.bamboo_planKey || I.BITBUCKET_COMMIT || I.BITRISE_IO || I.BUDDY_WORKSPACE_ID || I.BUILDKITE || I.CIRCLECI || I.CIRRUS_CI || I.CF_BUILD_ID || I.CM_BUILD_ID || I.CI_NAME || I.DRONE || I.DSARI || I.EARTHLY_CI || I.EAS_BUILD || I.GERRIT_PROJECT || I.GITEA_ACTIONS || I.GITHUB_ACTIONS || I.GITLAB_CI || I.GOCD || I.BUILDER_OUTPUT || I.HARNESS_BUILD_ID || I.JENKINS_URL || I.BUILD_ID || I.LAYERCI || I.MAGNUM || I.NETLIFY || I.NEVERCODE || I.PROW_JOB_ID || I.RELEASE_BUILD_ID || I.RENDER || I.SAILCI || I.HUDSON || I.JENKINS_URL || I.BUILD_ID || I.SCREWDRIVER || I.SEMAPHORE || I.SOURCEHUT || I.STRIDER || I.TASK_ID || I.RUN_ID || I.TEAMCITY_VERSION || I.TRAVIS || I.VELA || I.NOW_BUILDER || I.APPCENTER_BUILD_ID || I.CI_XCODE_PROJECT || I.XCS || _providers.providerInfo.ci !== !1),
+  isInteractive = (I = process.stdin) => !!(I?.isTTY && process.env.TERM !== "dumb");
+exports.isInteractive = isInteractive;
+exports.isCI = isCI;

package/dist/ci-checks.d.ts

@@ -0,0 +1,15 @@
+/**
+ *  Returns true if the current environment is a CI environment.
+ *
+ * @returns True if the current environment is a CI environment.
+ */
+export declare const isCI: (env?: Record<string, string | undefined>) => boolean;
+/**
+ * Check if the current process is interactive
+ *
+ * @param stream - The stream to check
+ * @returns True if the current process is interactive
+ */
+export declare const isInteractive: (stream?: NodeJS.ReadStream & {
+    fd: 0;
+}) => boolean;

package/dist/ci-checks.mjs

@@ -0,0 +1 @@
+import{providerInfo as E}from"./providers";export const isCI=(I=process.env)=>!!(I.STORM_CI||I.CI||I.CONTINUOUS_INTEGRATION||I.BUILD_NUMBER||I.RUN_ID||I.AGOLA_GIT_REF||I.AC_APPCIRCLE||I.APPVEYOR||I.CODEBUILD||I.TF_BUILD||I.bamboo_planKey||I.BITBUCKET_COMMIT||I.BITRISE_IO||I.BUDDY_WORKSPACE_ID||I.BUILDKITE||I.CIRCLECI||I.CIRRUS_CI||I.CF_BUILD_ID||I.CM_BUILD_ID||I.CI_NAME||I.DRONE||I.DSARI||I.EARTHLY_CI||I.EAS_BUILD||I.GERRIT_PROJECT||I.GITEA_ACTIONS||I.GITHUB_ACTIONS||I.GITLAB_CI||I.GOCD||I.BUILDER_OUTPUT||I.HARNESS_BUILD_ID||I.JENKINS_URL||I.BUILD_ID||I.LAYERCI||I.MAGNUM||I.NETLIFY||I.NEVERCODE||I.PROW_JOB_ID||I.RELEASE_BUILD_ID||I.RENDER||I.SAILCI||I.HUDSON||I.JENKINS_URL||I.BUILD_ID||I.SCREWDRIVER||I.SEMAPHORE||I.SOURCEHUT||I.STRIDER||I.TASK_ID||I.RUN_ID||I.TEAMCITY_VERSION||I.TRAVIS||I.VELA||I.NOW_BUILDER||I.APPCENTER_BUILD_ID||I.CI_XCODE_PROJECT||I.XCS||E.ci!==!1),isInteractive=(I=process.stdin)=>!!(I?.isTTY&&process.env.TERM!=="dumb");

package/dist/environment-checks.cjs

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.platform = exports.nodeVersion = exports.nodeMajorVersion = exports.isWindows = exports.isTest = exports.isProduction = exports.isMinimal = exports.isMacOS = exports.isLinux = exports.isDevelopment = exports.isDebug = exports.isColorSupported = exports.hasTTY = void 0;
+var _ciChecks = require("./ci-checks.cjs");
+const platform = exports.platform = globalThis.process?.platform || "",
+  hasTTY = exports.hasTTY = !!(globalThis.process?.stdout && globalThis.process?.stdout.isTTY),
+  isDebug = exports.isDebug = !!process.env.DEBUG,
+  isTest = exports.isTest = process.env.NODE_ENV === "test" || !!process.env.TEST,
+  isProduction = exports.isProduction = process.env.NODE_ENV === "production",
+  isDevelopment = exports.isDevelopment = process.env.NODE_ENV === "dev" || process.env.NODE_ENV === "development",
+  isMinimal = exports.isMinimal = !!process.env.MINIMAL || _ciChecks.isCI || isTest || !hasTTY,
+  isWindows = exports.isWindows = /^win/i.test(platform),
+  isLinux = exports.isLinux = /^linux/i.test(platform),
+  isMacOS = exports.isMacOS = /^darwin/i.test(platform),
+  isColorSupported = exports.isColorSupported = !process.env.NO_COLOR && (!!process.env.FORCE_COLOR || (hasTTY || isWindows) && process.env.TERM !== "dumb" || (0, _ciChecks.isCI)()),
+  nodeVersion = exports.nodeVersion = (globalThis.process?.versions?.node || "").replace(/^v/, "") || null,
+  nodeMajorVersion = exports.nodeMajorVersion = Number(nodeVersion?.split(".")[0]) || null;

package/dist/environment-checks.d.ts

@@ -0,0 +1,25 @@
+/** Value of process.platform */
+export declare const platform: NodeJS.Platform;
+/** Detect if stdout.TTY is available */
+export declare const hasTTY: boolean;
+/** Detect if `DEBUG` environment variable is set */
+export declare const isDebug: boolean;
+/** Detect if `NODE_ENV` environment variable is `test` */
+export declare const isTest: boolean;
+/** Detect if `NODE_ENV` environment variable is `production` */
+export declare const isProduction: boolean;
+/** Detect if `NODE_ENV` environment variable is `dev` or `development` */
+export declare const isDevelopment: boolean;
+/** Detect if MINIMAL environment variable is set, running in CI or test or TTY is unavailable */
+export declare const isMinimal: true | ((env?: Record<string, string | undefined>) => boolean);
+/** Detect if process.platform is Windows */
+export declare const isWindows: boolean;
+/** Detect if process.platform is Linux */
+export declare const isLinux: boolean;
+/** Detect if process.platform is macOS (darwin kernel) */
+export declare const isMacOS: boolean;
+/** Color Support */
+export declare const isColorSupported: boolean;
+/** Node.js versions */
+export declare const nodeVersion: string | null;
+export declare const nodeMajorVersion: number | null;

package/dist/environment-checks.mjs

@@ -0,0 +1 @@
+import{isCI as o}from"./ci-checks";export const platform=globalThis.process?.platform||"",hasTTY=!!(globalThis.process?.stdout&&globalThis.process?.stdout.isTTY),isDebug=!!process.env.DEBUG,isTest=process.env.NODE_ENV==="test"||!!process.env.TEST,isProduction=process.env.NODE_ENV==="production",isDevelopment=process.env.NODE_ENV==="dev"||process.env.NODE_ENV==="development",isMinimal=!!process.env.MINIMAL||o||isTest||!hasTTY,isWindows=/^win/i.test(platform),isLinux=/^linux/i.test(platform),isMacOS=/^darwin/i.test(platform),isColorSupported=!process.env.NO_COLOR&&(!!process.env.FORCE_COLOR||(hasTTY||isWindows)&&process.env.TERM!=="dumb"||o()),nodeVersion=(globalThis.process?.versions?.node||"").replace(/^v/,"")||null,nodeMajorVersion=Number(nodeVersion?.split(".")[0])||null;

package/dist/get-env-paths.cjs

@@ -0,0 +1,59 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getEnvPaths = getEnvPaths;
+var _joinPaths = require("@stryke/path/utilities/join-paths");
+var _titleCase = require("@stryke/string-format/title-case");
+var _isString = require("@stryke/types/type-checks/is-string");
+var _nodeOs = _interopRequireDefault(require("node:os"));
+var _nodePath = _interopRequireDefault(require("node:path"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const n = _nodeOs.default.homedir(),
+  o = _nodeOs.default.tmpdir(),
+  l = e => {
+    const r = (0, _joinPaths.joinPaths)(n, "Library");
+    return {
+      data: (0, _joinPaths.joinPaths)(r, "Application Support", e),
+      config: (0, _joinPaths.joinPaths)(r, "Preferences", e),
+      cache: (0, _joinPaths.joinPaths)(r, "Caches", e),
+      log: (0, _joinPaths.joinPaths)(r, "Logs", e),
+      temp: (0, _joinPaths.joinPaths)(o, e)
+    };
+  },
+  E = e => {
+    const r = process.env.APPDATA || (0, _joinPaths.joinPaths)(n, "AppData", "Roaming"),
+      t = process.env.LOCALAPPDATA || (0, _joinPaths.joinPaths)(n, "AppData", "Local"),
+      a = (0, _titleCase.titleCase)(e).trim().replace(/\s+/g, "");
+    return {
+      data: (0, _joinPaths.joinPaths)(t, a, "Data"),
+      config: (0, _joinPaths.joinPaths)(r, a, "Config"),
+      cache: (0, _joinPaths.joinPaths)(t, "Cache", e),
+      log: (0, _joinPaths.joinPaths)(t, a, "Log"),
+      temp: (0, _joinPaths.joinPaths)(o, e)
+    };
+  },
+  O = e => {
+    const r = _nodePath.default.basename(n);
+    return {
+      data: (0, _joinPaths.joinPaths)(process.env.XDG_DATA_HOME || (0, _joinPaths.joinPaths)(n, ".local", "share"), e),
+      config: (0, _joinPaths.joinPaths)(process.env.XDG_CONFIG_HOME || (0, _joinPaths.joinPaths)(n, ".config"), e),
+      cache: (0, _joinPaths.joinPaths)(process.env.XDG_CACHE_HOME || (0, _joinPaths.joinPaths)(n, ".cache"), e),
+      log: (0, _joinPaths.joinPaths)(process.env.XDG_STATE_HOME || (0, _joinPaths.joinPaths)(n, ".local", "state"), e),
+      temp: (0, _joinPaths.joinPaths)(o, r, e)
+    };
+  };
+function getEnvPaths(e = {}) {
+  let r = e.orgId || "storm-software";
+  if (!r) throw new Error("You need to provide an orgId to the `getEnvPaths` function");
+  e.suffix && (r += `-${(0, _isString.isString)(e.suffix) ? e.suffix : "nodejs"}`);
+  let t = {};
+  return process.platform === "darwin" ? t = l(r) : process.platform === "win32" ? t = E(r) : t = O(r), process.env.STORM_DATA_DIRECTORY ? t.data = process.env.STORM_DATA_DIRECTORY : process.env.STORM_CONFIG_DIRECTORY ? t.config = process.env.STORM_CONFIG_DIRECTORY : process.env.STORM_CACHE_DIRECTORY ? t.cache = process.env.STORM_CACHE_DIRECTORY : process.env.STORM_LOG_DIRECTORY ? t.log = process.env.STORM_LOG_DIRECTORY : process.env.STORM_TEMP_DIRECTORY && (t.temp = process.env.STORM_TEMP_DIRECTORY), e.workspaceRoot && (t.cache ??= (0, _joinPaths.joinPaths)(e.workspaceRoot, "node_modules", ".cache", r), t.temp ??= (0, _joinPaths.joinPaths)(e.workspaceRoot, "tmp", r), t.log ??= (0, _joinPaths.joinPaths)(t.temp, "logs"), t.config ??= (0, _joinPaths.joinPaths)(e.workspaceRoot, ".config", r)), Object.keys(t).reduce((a, c) => {
+    if (t[c]) {
+      const i = t[c];
+      a[c] = e.appId && e.appId !== e.orgId && e.appId !== e.nestedDir ? (0, _joinPaths.joinPaths)(i, e.appId) : i, e.nestedDir && e.nestedDir !== e.orgId && e.nestedDir !== e.appId && (a[c] = (0, _joinPaths.joinPaths)(a[c], e.nestedDir));
+    }
+    return a;
+  }, {});
+}

package/dist/get-env-paths.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Options for the `getEnvPaths` function.
+ */
+export type GetEnvPathsOptions = {
+    /**
+     * The name of the organization
+     *
+     * @defaultValue "storm-software"
+     */
+    orgId?: string;
+    /**
+     * The name of the specific application to use as a nested folder inside the organization's folder
+     *
+     * For example: `~/ ... /storm-software/Log/<appId>`
+     */
+    appId?: string;
+    /**
+     * The name of the specific application to use as a nested folder inside the organization's folder
+     *
+     * When a value is provided, it will use `~/ ... /storm-software/Log/<appId>/<nestedDir>`
+     *
+     * @remarks
+     * If no child is provided, it will use `~/ ... /storm-software/Log/<appId>`
+     */
+    nestedDir?: string;
+    /**
+     * The suffix to append to the project name.
+     *
+     * @remarks
+     * If `suffix` is `true`, the project name will be suffixed with `"nodejs"`.
+     *
+     * @defaultValue false
+     */
+    suffix?: string | boolean | null;
+    /**
+     * The root directory of the workspace that is used for determining the `cache` and `tmp` paths if they were not already set by other means.
+     */
+    workspaceRoot?: string;
+};
+export type EnvPaths = {
+    data: string;
+    config: string;
+    cache: string;
+    log: string;
+    temp: string;
+};
+/**
+ * Get paths for storing things like data, config, logs, and cache in the current runtime environment.
+ *
+ * @remarks
+ * On macOS, directories are generally created in `~/Library/Application Support/<name>`.
+ * On Windows, directories are generally created in `%AppData%/<name>`.
+ * On Linux, directories are generally created in `~/.config/<name>` - this is determined via the [XDG Base Directory spec](https://specifications.freedesktop.org/basedir-spec/latest/).
+ *
+ * If the `STORM_DATA_DIRECTORY`, `STORM_CONFIG_DIRECTORY`, `STORM_CACHE_DIRECTORY`, `STORM_LOG_DIRECTORY`, or `STORM_TEMP_DIRECTORY` environment variables are set, they will be used instead of the default paths.
+ *
+ * @param options - Parameters used to determine the specific paths for the current project/runtime environment
+ * @returns An object containing the various paths for the runtime environment
+ */
+export declare function getEnvPaths(options?: GetEnvPathsOptions): EnvPaths;

package/dist/get-env-paths.mjs

@@ -0,0 +1 @@
+import{joinPaths as s}from"@stryke/path/utilities/join-paths";import{titleCase as f}from"@stryke/string-format/title-case";import{isString as R}from"@stryke/types/type-checks/is-string";import p from"node:os";import g from"node:path";const n=p.homedir(),o=p.tmpdir(),l=e=>{const r=s(n,"Library");return{data:s(r,"Application Support",e),config:s(r,"Preferences",e),cache:s(r,"Caches",e),log:s(r,"Logs",e),temp:s(o,e)}},E=e=>{const r=process.env.APPDATA||s(n,"AppData","Roaming"),t=process.env.LOCALAPPDATA||s(n,"AppData","Local"),a=f(e).trim().replace(/\s+/g,"");return{data:s(t,a,"Data"),config:s(r,a,"Config"),cache:s(t,"Cache",e),log:s(t,a,"Log"),temp:s(o,e)}},O=e=>{const r=g.basename(n);return{data:s(process.env.XDG_DATA_HOME||s(n,".local","share"),e),config:s(process.env.XDG_CONFIG_HOME||s(n,".config"),e),cache:s(process.env.XDG_CACHE_HOME||s(n,".cache"),e),log:s(process.env.XDG_STATE_HOME||s(n,".local","state"),e),temp:s(o,r,e)}};export function getEnvPaths(e={}){let r=e.orgId||"storm-software";if(!r)throw new Error("You need to provide an orgId to the `getEnvPaths` function");e.suffix&&(r+=`-${R(e.suffix)?e.suffix:"nodejs"}`);let t={};return process.platform==="darwin"?t=l(r):process.platform==="win32"?t=E(r):t=O(r),process.env.STORM_DATA_DIRECTORY?t.data=process.env.STORM_DATA_DIRECTORY:process.env.STORM_CONFIG_DIRECTORY?t.config=process.env.STORM_CONFIG_DIRECTORY:process.env.STORM_CACHE_DIRECTORY?t.cache=process.env.STORM_CACHE_DIRECTORY:process.env.STORM_LOG_DIRECTORY?t.log=process.env.STORM_LOG_DIRECTORY:process.env.STORM_TEMP_DIRECTORY&&(t.temp=process.env.STORM_TEMP_DIRECTORY),e.workspaceRoot&&(t.cache??=s(e.workspaceRoot,"node_modules",".cache",r),t.temp??=s(e.workspaceRoot,"tmp",r),t.log??=s(t.temp,"logs"),t.config??=s(e.workspaceRoot,".config",r)),Object.keys(t).reduce((a,c)=>{if(t[c]){const i=t[c];a[c]=e.appId&&e.appId!==e.orgId&&e.appId!==e.nestedDir?s(i,e.appId):i,e.nestedDir&&e.nestedDir!==e.orgId&&e.nestedDir!==e.appId&&(a[c]=s(a[c],e.nestedDir))}return a},{})}

package/dist/index.cjs

@@ -0,0 +1,71 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _ciChecks = require("./ci-checks.cjs");
+Object.keys(_ciChecks).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _ciChecks[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _ciChecks[key];
+    }
+  });
+});
+var _getEnvPaths = require("./get-env-paths.cjs");
+Object.keys(_getEnvPaths).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _getEnvPaths[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _getEnvPaths[key];
+    }
+  });
+});
+var _loadEnv = require("./load-env.cjs");
+Object.keys(_loadEnv).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _loadEnv[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _loadEnv[key];
+    }
+  });
+});
+var _providers = require("./providers.cjs");
+Object.keys(_providers).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _providers[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _providers[key];
+    }
+  });
+});
+var _runtimeChecks = require("./runtime-checks.cjs");
+Object.keys(_runtimeChecks).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _runtimeChecks[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _runtimeChecks[key];
+    }
+  });
+});
+var _types = require("./types.cjs");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The env library used by Storm Software for building NodeJS applications.
+ *
+ * @remarks
+ * A package containing utility functions to handle environment specific processes
+ *
+ * @packageDocumentation
+ */
+export * from "./ci-checks";
+export * from "./get-env-paths";
+export * from "./load-env";
+export * from "./providers";
+export * from "./runtime-checks";
+export * from "./types";

package/dist/index.mjs

@@ -0,0 +1 @@
+export*from"./ci-checks";export*from"./get-env-paths";export*from"./load-env";export*from"./providers";export*from"./runtime-checks";export*from"./types";

package/dist/load-env.cjs

@@ -0,0 +1,55 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getEnvFilesForMode = getEnvFilesForMode;
+exports.loadClientEnv = loadClientEnv;
+exports.loadEnv = loadEnv;
+exports.loadEnvFile = loadEnvFile;
+exports.loadServerEnv = loadServerEnv;
+var _dotenvx = require("@dotenvx/dotenvx");
+var _readFile = require("@stryke/fs/files/read-file");
+var _json = require("@stryke/json");
+var _path = require("@stryke/path");
+var _defu = _interopRequireDefault(require("defu"));
+var _types = require("./types.cjs");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function getEnvFilesForMode(n, r = "production") {
+  return [".env", ".env.local", `.env.${r}`, `.env.${r}.local`, `.env.local.${r}`].map(s => (0, _path.joinPaths)(n, s));
+}
+async function loadEnvFile(n, r = []) {
+  const s = Array.isArray(r) ? r : [r];
+  return (await Promise.all((r.length > 0 ? s.map(t => (0, _path.joinPaths)(t, n)) : [n]).map(t => {
+    if ((0, _path.existsSync)(t)) return (0, _readFile.readFile)(t);
+  }))).reduce((t, u) => {
+    if (!u) return t;
+    const a = (0, _dotenvx.parse)(u, {
+      processEnv: {
+        ...process.env
+      },
+      privateKey: process.env.DOTENV_PRIVATE_KEY || process.env.STORM_PRIVATE_KEY
+    });
+    return (0, _defu.default)(a, t);
+  }, {});
+}
+async function loadEnv(n, r, s) {
+  if (r === "local") throw new Error('"local" cannot be used as a mode name because it conflicts with the .local postfix for .env files.');
+  const t = s ? Array.isArray(s) ? s : [s] : [],
+    u = Array.isArray(n) ? n : [n],
+    a = {},
+    l = u.reduce((e, i) => (e.push(...getEnvFilesForMode(i, r).filter(c => !e.includes(c))), e), []);
+  let o = (await Promise.all(l.map(e => loadEnvFile(e)))).reduce((e, i) => (0, _defu.default)(i, e), {});
+  if (o.NODE_ENV && process.env.VITE_USER_NODE_ENV === void 0 && (process.env.VITE_USER_NODE_ENV = _json.StormJSON.stringify(o.NODE_ENV)), o.BROWSER && process.env.BROWSER === void 0 && (process.env.BROWSER = _json.StormJSON.stringify(o.BROWSER)), o.BROWSER_ARGS && process.env.BROWSER_ARGS === void 0 && (process.env.BROWSER_ARGS = _json.StormJSON.stringify(o.BROWSER_ARGS)), o = (0, _defu.default)({
+    ...process.env
+  }, o), t.length === 0) return o;
+  for (const [e, i] of Object.entries(o)) t.some(c => e.startsWith(c)) && (a[e] = String(i));
+  for (const e in process.env) t.some(i => e.startsWith(i)) && (a[e] = process.env[e]);
+  return a;
+}
+async function loadClientEnv(n, r, s = _types.ENV_PREFIXES) {
+  return loadEnv(n, r, s);
+}
+async function loadServerEnv(n, r) {
+  return loadEnv(n, r);
+}

package/dist/load-env.d.ts

@@ -0,0 +1,56 @@
+import { type DotenvParseOutput } from "./types";
+export declare function getEnvFilesForMode(envDir: string, mode?: string): string[];
+/**
+ * Load environment variables from a .env file.
+ *
+ * @param envFile - The path to the .env file.
+ * @returns The environment variables.
+ */
+export declare function loadEnvFile(envFile: string, envDir?: string | string[]): Promise<DotenvParseOutput>;
+/**
+ * Load environment variables from .env files.
+ *
+ * @remarks
+ * This function loads environment variables from .env files based on the mode. For the `production` mode, it will load:
+ * - `.env`
+ * - `.env.local`
+ * - `.env.production`
+ * - `.env.production.local`
+ *
+ * @param mode - The mode to load the environment variables for.
+ * @param envDir - The directory/directories to load the environment variables from.
+ * @param prefix - The prefix or prefixes to use for the environment variables.
+ * @returns The environment variables.
+ */
+export declare function loadEnv(envDir: string | string[], mode?: string, prefix?: string | string[]): Promise<DotenvParseOutput>;
+/**
+ * Load environment variables from .env files for a client-side environment.
+ *
+ * @remarks
+ * This function loads environment variables from .env files based on the mode. For the `production` mode, it will load:
+ * - `.env`
+ * - `.env.local`
+ * - `.env.production`
+ * - `.env.production.local`
+ *
+ * @param mode - The mode to load the environment variables for.
+ * @param envDir - The directory/directories to load the environment variables from.
+ * @param prefix - The prefix or prefixes to use for the environment variables.
+ * @returns The environment variables.
+ */
+export declare function loadClientEnv(envDir: string | string[], mode?: string, prefix?: string | string[]): Promise<DotenvParseOutput>;
+/**
+ * Load environment variables from .env files for a server-side environment.
+ *
+ * @remarks
+ * This function loads environment variables from .env files based on the mode. For the `production` mode, it will load:
+ * - `.env`
+ * - `.env.local`
+ * - `.env.production`
+ * - `.env.production.local`
+ *
+ * @param mode - The mode to load the environment variables for.
+ * @param envDir - The directory/directories to load the environment variables from.
+ * @returns The environment variables.
+ */
+export declare function loadServerEnv(envDir: string | string[], mode: string): Promise<DotenvParseOutput>;

package/dist/load-env.mjs

@@ -0,0 +1 @@
+import{parse as v}from"@dotenvx/dotenvx";import{readFile as g}from"@stryke/fs/files/read-file";import{StormJSON as p}from"@stryke/json";import{existsSync as R,joinPaths as f}from"@stryke/path";import E from"defu";import{ENV_PREFIXES as m}from"./types";export function getEnvFilesForMode(n,r="production"){return[".env",".env.local",`.env.${r}`,`.env.${r}.local`,`.env.local.${r}`].map(s=>f(n,s))}export async function loadEnvFile(n,r=[]){const s=Array.isArray(r)?r:[r];return(await Promise.all((r.length>0?s.map(t=>f(t,n)):[n]).map(t=>{if(R(t))return g(t)}))).reduce((t,u)=>{if(!u)return t;const a=v(u,{processEnv:{...process.env},privateKey:process.env.DOTENV_PRIVATE_KEY||process.env.STORM_PRIVATE_KEY});return E(a,t)},{})}export async function loadEnv(n,r,s){if(r==="local")throw new Error('"local" cannot be used as a mode name because it conflicts with the .local postfix for .env files.');const t=s?Array.isArray(s)?s:[s]:[],u=Array.isArray(n)?n:[n],a={},l=u.reduce((e,i)=>(e.push(...getEnvFilesForMode(i,r).filter(c=>!e.includes(c))),e),[]);let o=(await Promise.all(l.map(e=>loadEnvFile(e)))).reduce((e,i)=>E(i,e),{});if(o.NODE_ENV&&process.env.VITE_USER_NODE_ENV===void 0&&(process.env.VITE_USER_NODE_ENV=p.stringify(o.NODE_ENV)),o.BROWSER&&process.env.BROWSER===void 0&&(process.env.BROWSER=p.stringify(o.BROWSER)),o.BROWSER_ARGS&&process.env.BROWSER_ARGS===void 0&&(process.env.BROWSER_ARGS=p.stringify(o.BROWSER_ARGS)),o=E({...process.env},o),t.length===0)return o;for(const[e,i]of Object.entries(o))t.some(c=>e.startsWith(c))&&(a[e]=String(i));for(const e in process.env)t.some(i=>e.startsWith(i))&&(a[e]=process.env[e]);return a}export async function loadClientEnv(n,r,s=m){return loadEnv(n,r,s)}export async function loadServerEnv(n,r){return loadEnv(n,r)}

package/dist/providers.cjs

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.providerInfo = exports.provider = void 0;
+const r = [["APPVEYOR"], ["AWS_AMPLIFY", "AWS_APP_ID", {
+  ci: !0
+}], ["AZURE_PIPELINES", "SYSTEM_TEAMFOUNDATIONCOLLECTIONURI"], ["AZURE_STATIC", "INPUT_AZURE_STATIC_WEB_APPS_API_TOKEN"], ["APPCIRCLE", "AC_APPCIRCLE"], ["BAMBOO", "bamboo_planKey"], ["BITBUCKET", "BITBUCKET_COMMIT"], ["BITRISE", "BITRISE_IO"], ["BUDDY", "BUDDY_WORKSPACE_ID"], ["BUILDKITE"], ["CIRCLE", "CIRCLECI"], ["CIRRUS", "CIRRUS_CI"], ["CLOUDFLARE_PAGES", "CF_PAGES", {
+  ci: !0
+}], ["CODEBUILD", "CODEBUILD_BUILD_ARN"], ["CODEFRESH", "CF_BUILD_ID"], ["DRONE"], ["DRONE", "DRONE_BUILD_EVENT"], ["DSARI"], ["GITHUB_ACTIONS"], ["GITLAB", "GITLAB_CI"], ["GITLAB", "CI_MERGE_REQUEST_ID"], ["GOCD", "GO_PIPELINE_LABEL"], ["LAYERCI"], ["HUDSON", "HUDSON_URL"], ["JENKINS", "JENKINS_URL"], ["MAGNUM"], ["NETLIFY"], ["NETLIFY", "NETLIFY_LOCAL", {
+  ci: !1
+}], ["NEVERCODE"], ["RENDER"], ["SAIL", "SAILCI"], ["SEMAPHORE"], ["SCREWDRIVER"], ["SHIPPABLE"], ["SOLANO", "TDDIUM"], ["STRIDER"], ["TEAMCITY", "TEAMCITY_VERSION"], ["TRAVIS"], ["VERCEL", "NOW_BUILDER"], ["VERCEL", "VERCEL", {
+  ci: !1
+}], ["VERCEL", "VERCEL_ENV", {
+  ci: !1
+}], ["APPCENTER", "APPCENTER_BUILD_ID"], ["CODESANDBOX", "CODESANDBOX_SSE", {
+  ci: !1
+}], ["STACKBLITZ"], ["STORMKIT"], ["CLEAVR"], ["ZEABUR"], ["CODESPHERE", "CODESPHERE_APP_ID", {
+  ci: !0
+}], ["RAILWAY", "RAILWAY_PROJECT_ID"], ["RAILWAY", "RAILWAY_SERVICE_ID"], ["DENO-DEPLOY", "DENO_DEPLOYMENT_ID"], ["FIREBASE_APP_HOSTING", "FIREBASE_APP_HOSTING", {
+  ci: !0
+}]];
+function I() {
+  if (globalThis.process?.env) for (const e of r) {
+    const E = e[1] || e[0];
+    if (globalThis.process?.env[E]) return {
+      name: e[0].toLowerCase(),
+      ...e[2]
+    };
+  }
+  return globalThis.process?.env?.SHELL === "/bin/jsh" && globalThis.process?.versions?.webcontainer ? {
+    name: "stackblitz",
+    ci: !1
+  } : {
+    name: "",
+    ci: !1
+  };
+}
+const providerInfo = exports.providerInfo = I(),
+  provider = exports.provider = providerInfo.name;

package/dist/providers.d.ts

@@ -0,0 +1,9 @@
+export type ProviderName = "" | "appveyor" | "aws_amplify" | "azure_pipelines" | "azure_static" | "appcircle" | "bamboo" | "bitbucket" | "bitrise" | "buddy" | "buildkite" | "circle" | "cirrus" | "cloudflare_pages" | "codebuild" | "codefresh" | "drone" | "drone" | "dsari" | "github_actions" | "gitlab" | "gocd" | "layerci" | "hudson" | "jenkins" | "magnum" | "netlify" | "nevercode" | "render" | "sail" | "semaphore" | "screwdriver" | "shippable" | "solano" | "strider" | "teamcity" | "travis" | "vercel" | "appcenter" | "codesandbox" | "stackblitz" | "stormkit" | "cleavr" | "zeabur" | "codesphere" | "railway" | "deno-deploy" | "firebase_app_hosting";
+export type ProviderInfo = {
+    name: ProviderName;
+    ci?: boolean;
+    [meta: string]: any;
+};
+/** Current provider info */
+export declare const providerInfo: ProviderInfo;
+export declare const provider: ProviderName;

package/dist/providers.mjs

@@ -0,0 +1 @@
+const r=[["APPVEYOR"],["AWS_AMPLIFY","AWS_APP_ID",{ci:!0}],["AZURE_PIPELINES","SYSTEM_TEAMFOUNDATIONCOLLECTIONURI"],["AZURE_STATIC","INPUT_AZURE_STATIC_WEB_APPS_API_TOKEN"],["APPCIRCLE","AC_APPCIRCLE"],["BAMBOO","bamboo_planKey"],["BITBUCKET","BITBUCKET_COMMIT"],["BITRISE","BITRISE_IO"],["BUDDY","BUDDY_WORKSPACE_ID"],["BUILDKITE"],["CIRCLE","CIRCLECI"],["CIRRUS","CIRRUS_CI"],["CLOUDFLARE_PAGES","CF_PAGES",{ci:!0}],["CODEBUILD","CODEBUILD_BUILD_ARN"],["CODEFRESH","CF_BUILD_ID"],["DRONE"],["DRONE","DRONE_BUILD_EVENT"],["DSARI"],["GITHUB_ACTIONS"],["GITLAB","GITLAB_CI"],["GITLAB","CI_MERGE_REQUEST_ID"],["GOCD","GO_PIPELINE_LABEL"],["LAYERCI"],["HUDSON","HUDSON_URL"],["JENKINS","JENKINS_URL"],["MAGNUM"],["NETLIFY"],["NETLIFY","NETLIFY_LOCAL",{ci:!1}],["NEVERCODE"],["RENDER"],["SAIL","SAILCI"],["SEMAPHORE"],["SCREWDRIVER"],["SHIPPABLE"],["SOLANO","TDDIUM"],["STRIDER"],["TEAMCITY","TEAMCITY_VERSION"],["TRAVIS"],["VERCEL","NOW_BUILDER"],["VERCEL","VERCEL",{ci:!1}],["VERCEL","VERCEL_ENV",{ci:!1}],["APPCENTER","APPCENTER_BUILD_ID"],["CODESANDBOX","CODESANDBOX_SSE",{ci:!1}],["STACKBLITZ"],["STORMKIT"],["CLEAVR"],["ZEABUR"],["CODESPHERE","CODESPHERE_APP_ID",{ci:!0}],["RAILWAY","RAILWAY_PROJECT_ID"],["RAILWAY","RAILWAY_SERVICE_ID"],["DENO-DEPLOY","DENO_DEPLOYMENT_ID"],["FIREBASE_APP_HOSTING","FIREBASE_APP_HOSTING",{ci:!0}]];function I(){if(globalThis.process?.env)for(const e of r){const E=e[1]||e[0];if(globalThis.process?.env[E])return{name:e[0].toLowerCase(),...e[2]}}return globalThis.process?.env?.SHELL==="/bin/jsh"&&globalThis.process?.versions?.webcontainer?{name:"stackblitz",ci:!1}:{name:"",ci:!1}}export const providerInfo=I(),provider=providerInfo.name;

package/dist/runtime-checks.cjs

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.runtimeInfo = exports.runtime = exports.isWorkerd = exports.isNode = exports.isNetlify = exports.isFastly = exports.isEdgeLight = exports.isDeno = exports.isBun = void 0;
+const isNode = exports.isNode = globalThis.process?.release?.name === "node",
+  isBun = exports.isBun = !!globalThis.Bun || !!globalThis.process?.versions?.bun,
+  isDeno = exports.isDeno = !!globalThis.Deno,
+  isFastly = exports.isFastly = !!globalThis.fastly,
+  isNetlify = exports.isNetlify = !!globalThis.Netlify,
+  isEdgeLight = exports.isEdgeLight = !!globalThis.EdgeRuntime,
+  isWorkerd = exports.isWorkerd = globalThis.navigator?.userAgent === "Cloudflare-Workers";
+const n = [[isNetlify, "netlify"], [isEdgeLight, "edge-light"], [isWorkerd, "workerd"], [isFastly, "fastly"], [isDeno, "deno"], [isBun, "bun"], [isNode, "node"]];
+function t() {
+  const e = n.find(o => o[0]);
+  if (e) return {
+    name: e[1]
+  };
+}
+const runtimeInfo = exports.runtimeInfo = t(),
+  runtime = exports.runtime = runtimeInfo?.name || "";

package/dist/runtime-checks.d.ts

@@ -0,0 +1,39 @@
+export type RuntimeName = "workerd" | "deno" | "netlify" | "node" | "bun" | "edge-light" | "fastly" | "";
+export type RuntimeInfo = {
+    name: RuntimeName;
+};
+/**
+ * Indicates if running in Node.js or a Node.js compatible runtime.
+ *
+ * **Note:** When running code in Bun and Deno with Node.js compatibility mode, `isNode` flag will be also `true`, indicating running in a Node.js compatible runtime.
+ *
+ * Use `runtime === "node"` if you need strict check for Node.js runtime.
+ */
+export declare const isNode: boolean;
+/**
+ * Indicates if running in Bun runtime.
+ */
+export declare const isBun: boolean;
+/**
+ * Indicates if running in Deno runtime.
+ */
+export declare const isDeno: boolean;
+/**
+ * Indicates if running in Fastly runtime.
+ */
+export declare const isFastly: boolean;
+/**
+ * Indicates if running in Netlify runtime.
+ */
+export declare const isNetlify: boolean;
+/**
+ *
+ * Indicates if running in EdgeLight (Vercel Edge) runtime.
+ */
+export declare const isEdgeLight: boolean;
+/**
+ * Indicates if running in Cloudflare Workers runtime.
+ */
+export declare const isWorkerd: boolean;
+export declare const runtimeInfo: RuntimeInfo | undefined;
+export declare const runtime: RuntimeName;

package/dist/runtime-checks.mjs

@@ -0,0 +1 @@
+export const isNode=globalThis.process?.release?.name==="node",isBun=!!globalThis.Bun||!!globalThis.process?.versions?.bun,isDeno=!!globalThis.Deno,isFastly=!!globalThis.fastly,isNetlify=!!globalThis.Netlify,isEdgeLight=!!globalThis.EdgeRuntime,isWorkerd=globalThis.navigator?.userAgent==="Cloudflare-Workers";const n=[[isNetlify,"netlify"],[isEdgeLight,"edge-light"],[isWorkerd,"workerd"],[isFastly,"fastly"],[isDeno,"deno"],[isBun,"bun"],[isNode,"node"]];function t(){const e=n.find(o=>o[0]);if(e)return{name:e[1]}}export const runtimeInfo=t(),runtime=runtimeInfo?.name||"";

package/dist/types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ENV_PREFIXES = void 0;
+const ENV_PREFIXES = exports.ENV_PREFIXES = ["VITE_", "ONE_", "STORM_PUBLIC_", "STORM_", "NEXT_PUBLIC_"];

package/dist/types.d.ts

@@ -0,0 +1,4 @@
+export declare const ENV_PREFIXES: string[];
+export interface DotenvParseOutput {
+    [name: string]: string | undefined;
+}

package/dist/types.mjs

@@ -0,0 +1 @@
+export const ENV_PREFIXES=["VITE_","ONE_","STORM_PUBLIC_","STORM_","NEXT_PUBLIC_"];

package/package.json

@@ -0,0 +1,180 @@
+{
+  "name": "@stryke/env",
+  "version": "0.1.2",
+  "type": "module",
+  "description": "A package containing utility functions to handle environment specific processes",
+  "repository": {
+    "type": "github",
+    "url": "https://github.com/storm-software/stryke.git",
+    "directory": "packages/env"
+  },
+  "private": false,
+  "dependencies": {
+    "@dotenvx/dotenvx": "1.35.0",
+    "defu": "^6.1.4",
+    "@stryke/fs": ">=0.1.4",
+    "@stryke/json": ">=0.1.1",
+    "@stryke/path": ">=0.1.1",
+    "@stryke/string-format": ">=0.1.3",
+    "@stryke/types": ">=0.1.1"
+  },
+  "devDependencies": { "@types/node": "^22.13.1" },
+  "publishConfig": { "access": "public" },
+  "sideEffects": false,
+  "files": ["dist/**/*"],
+  "homepage": "https://stormsoftware.com",
+  "bugs": {
+    "url": "https://stormsoftware.com/support",
+    "email": "support@stormsoftware.com"
+  },
+  "license": "Apache-2.0",
+  "keywords": [
+    "stryke",
+    "typescript",
+    "utilities",
+    "storm-stack",
+    "storm-software",
+    "storm",
+    "storm-ops",
+    "cyclone-ui",
+    "sullivanpj",
+    "monorepo"
+  ],
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/storm-software"
+  },
+  "author": {
+    "name": "Storm Software",
+    "email": "contact@stormsoftware.com",
+    "url": "https://stormsoftware.com"
+  },
+  "maintainers": [
+    {
+      "name": "Storm Software",
+      "email": "contact@stormsoftware.com",
+      "url": "https://stormsoftware.com"
+    }
+  ],
+  "contributors": [
+    {
+      "name": "Storm Software",
+      "email": "contact@stormsoftware.com",
+      "url": "https://stormsoftware.com"
+    }
+  ],
+  "exports": {
+    "./types": {
+      "import": { "types": "./dist/types.d.ts", "default": "./dist/types.mjs" },
+      "require": {
+        "types": "./dist/types.d.ts",
+        "default": "./dist/types.cjs"
+      },
+      "default": { "types": "./dist/types.d.ts", "default": "./dist/types.mjs" }
+    },
+    "./runtime-checks": {
+      "import": {
+        "types": "./dist/runtime-checks.d.ts",
+        "default": "./dist/runtime-checks.mjs"
+      },
+      "require": {
+        "types": "./dist/runtime-checks.d.ts",
+        "default": "./dist/runtime-checks.cjs"
+      },
+      "default": {
+        "types": "./dist/runtime-checks.d.ts",
+        "default": "./dist/runtime-checks.mjs"
+      }
+    },
+    "./providers": {
+      "import": {
+        "types": "./dist/providers.d.ts",
+        "default": "./dist/providers.mjs"
+      },
+      "require": {
+        "types": "./dist/providers.d.ts",
+        "default": "./dist/providers.cjs"
+      },
+      "default": {
+        "types": "./dist/providers.d.ts",
+        "default": "./dist/providers.mjs"
+      }
+    },
+    "./load-env": {
+      "import": {
+        "types": "./dist/load-env.d.ts",
+        "default": "./dist/load-env.mjs"
+      },
+      "require": {
+        "types": "./dist/load-env.d.ts",
+        "default": "./dist/load-env.cjs"
+      },
+      "default": {
+        "types": "./dist/load-env.d.ts",
+        "default": "./dist/load-env.mjs"
+      }
+    },
+    "./index": {
+      "import": { "types": "./dist/index.d.ts", "default": "./dist/index.mjs" },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      },
+      "default": { "types": "./dist/index.d.ts", "default": "./dist/index.mjs" }
+    },
+    "./get-env-paths": {
+      "import": {
+        "types": "./dist/get-env-paths.d.ts",
+        "default": "./dist/get-env-paths.mjs"
+      },
+      "require": {
+        "types": "./dist/get-env-paths.d.ts",
+        "default": "./dist/get-env-paths.cjs"
+      },
+      "default": {
+        "types": "./dist/get-env-paths.d.ts",
+        "default": "./dist/get-env-paths.mjs"
+      }
+    },
+    "./environment-checks": {
+      "import": {
+        "types": "./dist/environment-checks.d.ts",
+        "default": "./dist/environment-checks.mjs"
+      },
+      "require": {
+        "types": "./dist/environment-checks.d.ts",
+        "default": "./dist/environment-checks.cjs"
+      },
+      "default": {
+        "types": "./dist/environment-checks.d.ts",
+        "default": "./dist/environment-checks.mjs"
+      }
+    },
+    "./ci-checks": {
+      "import": {
+        "types": "./dist/ci-checks.d.ts",
+        "default": "./dist/ci-checks.mjs"
+      },
+      "require": {
+        "types": "./dist/ci-checks.d.ts",
+        "default": "./dist/ci-checks.cjs"
+      },
+      "default": {
+        "types": "./dist/ci-checks.d.ts",
+        "default": "./dist/ci-checks.mjs"
+      }
+    },
+    ".": {
+      "import": { "types": "./dist/index.d.ts", "default": "./dist/index.mjs" },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      },
+      "default": { "types": "./dist/index.d.ts", "default": "./dist/index.mjs" }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts"
+}