@js-utils-kit/env 1.3.0 → 1.4.0

package/dist/index.cjs

@@ -1 +1 @@
-let e=require(`@js-utils-kit/types`),t=require(`node:process`);function n(){switch(process.env.NODE_ENV){case e.Environment.PROD:return e.Environment.PROD;case e.Environment.DEV:return e.Environment.DEV;case e.Environment.TEST:return e.Environment.TEST;default:return e.Environment.UNKNOWN}}const r=`AC_APPCIRCLE.AGOLA_GIT_REF.APPCENTER_BUILD_ID.APPVEYOR.bamboo_planKey.BITBUCKET_COMMIT.BITRISE_IO.BUDDY_WORKSPACE_ID.BUILD_ID.BUILD_NUMBER.BUILDER_OUTPUT.BUILDKITE.CF_BUILD_ID.CF_PAGES.CI.CI_XCODE_PROJECT.CIRCLECI.CIRRUS_CI.CM_BUILD_ID.CODEBUILD_BUILD_ARN.CONTINUOUS_INTEGRATION.DRONE.DSARI.EARTHLY_CI.EAS_BUILD.GERRIT_PROJECT.GITEA_ACTIONS.GITHUB_ACTIONS.GITLAB_CI.GO_PIPELINE_LABEL.HARNESS_BUILD_ID.HUDSON_URL.JENKINS_URL.LAYERCI.MAGNUM.NETLIFY.NEVERCODE.NODE.NOW_BUILDER.PROW_JOB_ID.RELEASE_BUILD_ID.RENDER.RUN_ID.SAILCI.SCREWDRIVER.SEMAPHORE.STRIDER.TASK_ID.TEAMCITY_VERSION.TF_BUILD.TRAVIS.VELA.VERCEL.WORKERS_CI.XCS`.split(`.`).some(e=>e in t.env&&t.env[e]!=null&&t.env[e]!==`0`&&t.env[e].toLowerCase()!==`false`)||typeof t.env.CI_NAME==`string`&&[`codeship`,`sourcehut`,`woodpecker`].includes(t.env.CI_NAME.toLowerCase());exports.getRunTimeEnvironment=n,exports.isCI=r;
+let e=require(`@js-utils-kit/types`),t=require(`node:process`);function n(){switch(process.env.NODE_ENV){case e.Environment.PROD:return e.Environment.PROD;case e.Environment.DEV:return e.Environment.DEV;case e.Environment.TEST:return e.Environment.TEST;default:return e.Environment.UNKNOWN}}const r=`AC_APPCIRCLE.AGOLA_GIT_REF.APPCENTER_BUILD_ID.APPVEYOR.bamboo_planKey.BITBUCKET_COMMIT.BITRISE_IO.BUDDY_WORKSPACE_ID.BUILD_ID.BUILD_NUMBER.BUILDER_OUTPUT.BUILDKITE.CF_BUILD_ID.CF_PAGES.CI_XCODE_PROJECT.CIRCLECI.CIRRUS_CI.CM_BUILD_ID.CODEBUILD_BUILD_ARN.DRONE.DSARI.EARTHLY_CI.EAS_BUILD.GERRIT_PROJECT.GITEA_ACTIONS.GITHUB_ACTIONS.GITLAB_CI.GO_PIPELINE_LABEL.HARNESS_BUILD_ID.HUDSON_URL.JENKINS_URL.LAYERCI.MAGNUM.NETLIFY.NEVERCODE.NOW_BUILDER.PROW_JOB_ID.RELEASE_BUILD_ID.RENDER.RUN_ID.SAILCI.SCREWDRIVER.SEMAPHORE.STRIDER.TASK_ID.TEAMCITY_VERSION.TF_BUILD.TRAVIS.VELA.VERCEL.WORKERS_CI.XCS`.split(`.`),i=[`CI`,`CONTINUOUS_INTEGRATION`],a=[`codeship`,`sourcehut`,`woodpecker`],o=e=>{let n=t.env[e]??t.env[e.toUpperCase()]??t.env[e.toLowerCase()];return n!=null&&n!==`0`&&n.toLowerCase()!==`false`},s=r.some(o),c=s||i.some(o)&&(s||typeof t.env.CI_NAME==`string`&&a.includes(t.env.CI_NAME.toLowerCase()));exports.getRunTimeEnvironment=n,exports.isCI=c;

package/dist/index.d.cts

@@ -20,9 +20,16 @@ declare function getRunTimeEnvironment(): Environment;
 /**
  * Determines whether the current runtime environment is a Continuous Integration (CI) environment.
  *
- * Detection is performed by:
- * 1. Checking for known CI-specific environment variables
- * 2. Checking value-based CI identifiers via `CI_NAME`
+ * Detection is conservative to avoid false positives in local development.
+ * It works as follows:
+ *
+ * 1. Immediately returns `true` if a known CI provider environment variable is present
+ *    (e.g. GitHub Actions, GitLab CI, CircleCI, etc.).
+ * 2. If only generic CI flags (such as `CI` or `CONTINUOUS_INTEGRATION`) are present,
+ *    they are considered valid **only when** backed by a real CI provider signal
+ *    or a known `CI_NAME` identifier.
+ *
+ * This prevents tools like `npx`, npm, or local shells from incorrectly causing CI detection while preserving correct behavior in real CI environments.
  *
  * @example
  * ```ts
@@ -31,7 +38,7 @@ declare function getRunTimeEnvironment(): Environment;
  * }
  * ```
  *
- * @returns `true` if running inside a CI environment
+ * @returns `true` if running inside a CI environment, otherwise `false`.
  */
 declare const isCI: boolean;
 //#endregion

package/dist/index.d.mts

@@ -20,9 +20,16 @@ declare function getRunTimeEnvironment(): Environment;
 /**
  * Determines whether the current runtime environment is a Continuous Integration (CI) environment.
  *
- * Detection is performed by:
- * 1. Checking for known CI-specific environment variables
- * 2. Checking value-based CI identifiers via `CI_NAME`
+ * Detection is conservative to avoid false positives in local development.
+ * It works as follows:
+ *
+ * 1. Immediately returns `true` if a known CI provider environment variable is present
+ *    (e.g. GitHub Actions, GitLab CI, CircleCI, etc.).
+ * 2. If only generic CI flags (such as `CI` or `CONTINUOUS_INTEGRATION`) are present,
+ *    they are considered valid **only when** backed by a real CI provider signal
+ *    or a known `CI_NAME` identifier.
+ *
+ * This prevents tools like `npx`, npm, or local shells from incorrectly causing CI detection while preserving correct behavior in real CI environments.
  *
  * @example
  * ```ts
@@ -31,7 +38,7 @@ declare function getRunTimeEnvironment(): Environment;
  * }
  * ```
  *
- * @returns `true` if running inside a CI environment
+ * @returns `true` if running inside a CI environment, otherwise `false`.
  */
 declare const isCI: boolean;
 //#endregion

package/dist/index.mjs

@@ -1 +1 @@
-import{Environment as e}from"@js-utils-kit/types";import{env as t}from"node:process";function n(){switch(process.env.NODE_ENV){case e.PROD:return e.PROD;case e.DEV:return e.DEV;case e.TEST:return e.TEST;default:return e.UNKNOWN}}const r=`AC_APPCIRCLE.AGOLA_GIT_REF.APPCENTER_BUILD_ID.APPVEYOR.bamboo_planKey.BITBUCKET_COMMIT.BITRISE_IO.BUDDY_WORKSPACE_ID.BUILD_ID.BUILD_NUMBER.BUILDER_OUTPUT.BUILDKITE.CF_BUILD_ID.CF_PAGES.CI.CI_XCODE_PROJECT.CIRCLECI.CIRRUS_CI.CM_BUILD_ID.CODEBUILD_BUILD_ARN.CONTINUOUS_INTEGRATION.DRONE.DSARI.EARTHLY_CI.EAS_BUILD.GERRIT_PROJECT.GITEA_ACTIONS.GITHUB_ACTIONS.GITLAB_CI.GO_PIPELINE_LABEL.HARNESS_BUILD_ID.HUDSON_URL.JENKINS_URL.LAYERCI.MAGNUM.NETLIFY.NEVERCODE.NODE.NOW_BUILDER.PROW_JOB_ID.RELEASE_BUILD_ID.RENDER.RUN_ID.SAILCI.SCREWDRIVER.SEMAPHORE.STRIDER.TASK_ID.TEAMCITY_VERSION.TF_BUILD.TRAVIS.VELA.VERCEL.WORKERS_CI.XCS`.split(`.`).some(e=>e in t&&t[e]!=null&&t[e]!==`0`&&t[e].toLowerCase()!==`false`)||typeof t.CI_NAME==`string`&&[`codeship`,`sourcehut`,`woodpecker`].includes(t.CI_NAME.toLowerCase());export{n as getRunTimeEnvironment,r as isCI};
+import{Environment as e}from"@js-utils-kit/types";import{env as t}from"node:process";function n(){switch(process.env.NODE_ENV){case e.PROD:return e.PROD;case e.DEV:return e.DEV;case e.TEST:return e.TEST;default:return e.UNKNOWN}}const r=`AC_APPCIRCLE.AGOLA_GIT_REF.APPCENTER_BUILD_ID.APPVEYOR.bamboo_planKey.BITBUCKET_COMMIT.BITRISE_IO.BUDDY_WORKSPACE_ID.BUILD_ID.BUILD_NUMBER.BUILDER_OUTPUT.BUILDKITE.CF_BUILD_ID.CF_PAGES.CI_XCODE_PROJECT.CIRCLECI.CIRRUS_CI.CM_BUILD_ID.CODEBUILD_BUILD_ARN.DRONE.DSARI.EARTHLY_CI.EAS_BUILD.GERRIT_PROJECT.GITEA_ACTIONS.GITHUB_ACTIONS.GITLAB_CI.GO_PIPELINE_LABEL.HARNESS_BUILD_ID.HUDSON_URL.JENKINS_URL.LAYERCI.MAGNUM.NETLIFY.NEVERCODE.NOW_BUILDER.PROW_JOB_ID.RELEASE_BUILD_ID.RENDER.RUN_ID.SAILCI.SCREWDRIVER.SEMAPHORE.STRIDER.TASK_ID.TEAMCITY_VERSION.TF_BUILD.TRAVIS.VELA.VERCEL.WORKERS_CI.XCS`.split(`.`),i=[`CI`,`CONTINUOUS_INTEGRATION`],a=[`codeship`,`sourcehut`,`woodpecker`],o=e=>{let n=t[e]??t[e.toUpperCase()]??t[e.toLowerCase()];return n!=null&&n!==`0`&&n.toLowerCase()!==`false`},s=r.some(o),c=s||i.some(o)&&(s||typeof t.CI_NAME==`string`&&a.includes(t.CI_NAME.toLowerCase()));export{n as getRunTimeEnvironment,c as isCI};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@js-utils-kit/env",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Environment utilities",
   "private": false,
   "license": "MIT",
@@ -35,7 +35,7 @@
     }
   },
   "dependencies": {
-    "@js-utils-kit/types": "1.2.0"
+    "@js-utils-kit/types": "1.3.0"
   },
   "scripts": {
     "build": "tsdown",