feat: expose dotenv API

.size-limit.json

@@ -9,7 +9,7 @@
   {
     "name": "zx/index",
     "path": "build/*.{js,cjs}",
-    "limit": "805.5 kB",
+    "limit": "806 kB",
     "brotli": false,
     "gzip": false
   },
@@ -23,14 +23,14 @@
   {
     "name": "vendor",
     "path": "build/vendor-*",
-    "limit": "761 kB",
+    "limit": "762 kB",
     "brotli": false,
     "gzip": false
   },
   {
     "name": "all",
     "path": "build/*",
-    "limit": "842.5 kB",
+    "limit": "843 kB",
     "brotli": false,
     "gzip": false
   }

package.json

@@ -108,6 +108,7 @@
     "create-require": "^1.1.1",
     "depseek": "^0.4.1",
     "dts-bundle-generator": "^9.5.1",
+    "envapi": "^0.0.0",
     "esbuild": "^0.24.2",
     "esbuild-node-externals": "^1.16.0",
     "esbuild-plugin-entry-chunks": "^0.1.15",

scripts/build-dts.mjs

@@ -60,6 +60,7 @@ const entries = [
         '@webpod/ingrid',
         'chalk',
         'zurk',
+        'envapi'
       ], // args['external-inlines'],
     },
     output,

src/util.ts

@@ -15,10 +15,10 @@
 import os from 'node:os'
 import path from 'node:path'
 import fs from 'node:fs'
-import { chalk, type RequestInfo, type RequestInit } from './vendor-core.js'
+import { chalk, type RequestInfo, type RequestInit, parseDotenv } from './vendor-core.js'
 import { inspect } from 'node:util'
 
-export { isStringLiteral } from './vendor-core.js'
+export { isStringLiteral, parseDotenv } from './vendor-core.js'
 
 export function tempdir(prefix: string = `zx-${randomId()}`): string {
   const dirpath = path.join(os.tmpdir(), prefix)
@@ -358,61 +358,6 @@ export const toCamelCase = (str: string) =>
 export const parseBool = (v: string): boolean | string =>
   ({ true: true, false: false })[v] ?? v
 
-// prettier-ignore
-export const parseDotenv = (content: string): NodeJS.ProcessEnv => {
-  const kr = /^[a-zA-Z_]+\w*$/
-  const sr = /\s/
-  const e: Record<string, string> = {}
-  let k = ''
-  let b = ''
-  let q = ''
-  let i = 0
-  const cap = () => { if (b && k) {
-    if (!kr.test(k)) throw new Error(`Invalid identifier: ${k}`)
-    e[k] = b; b = k = ''
-  }}
-
-  for (const c of content.replace(/\r\n?/mg, '\n')) {
-    if (i) {
-      if (c === '\n') i = 0
-      continue
-    }
-    if (!q) {
-      if (c === '#') {
-        i = 1
-        continue
-      }
-      if (c === '\n') {
-        cap()
-        continue
-      }
-      if (sr.test(c)) {
-        if (!k && b === 'export') b = ''
-        continue
-      }
-      if (c === '=') {
-        if (!k) { k = b; b = ''; continue }
-      }
-    }
-
-    if (c === '"' || c === "'" || c === '`') {
-      if (!q) {
-        q = c
-        continue
-      }
-      if (q === c) {
-        q = ''
-        cap()
-        continue
-      }
-    }
-    b += c
-  }
-  cap()
-
-  return e
-}
-
 export const readEnvFromFile = (
   filepath: string,
   env: NodeJS.ProcessEnv = process.env

src/vendor-core.ts

@@ -26,3 +26,4 @@ export type RequestInit = Parameters<typeof globalThis.fetch>[1]
 export { default as chalk, type ChalkInstance } from 'chalk'
 export { default as which } from 'which'
 export { default as ps } from '@webpod/ps'
+export { parse as parseDotenv }  from 'envapi'

test/util.test.js

@@ -156,7 +156,7 @@ ENV5=v5 # comment
     assert.deepEqual(parseDotenv(multiline), {
       SIMPLE: 'xyz123',
       NON_INTERPOLATED: 'raw text without variable interpolation',
-      MULTILINE: '\nlong text here, # not-comment\ne.g. a private SSH key\n',
+      MULTILINE: 'long text here, # not-comment\ne.g. a private SSH key',
       ENV: 'v1',
       ENV2: 'v2',
       ENV3: 'v3',