arkenv 1.0.0-alpha.2 → 1.0.0-alpha.21
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +3 -0
- package/README.md +24 -77
- package/dist/bin.d.ts +1 -0
- package/dist/bin.js +178 -0
- package/dist/dist-iC9ZVx-X.js +4 -0
- package/dist/index.d.ts +13 -0
- package/dist/index.js +1 -0
- package/package.json +38 -81
- package/dist/core-7-JO-N-w.d.cts +0 -82
- package/dist/core-7-JO-N-w.d.cts.map +0 -1
- package/dist/core-A65KioHX.mjs +0 -6
- package/dist/core-A65KioHX.mjs.map +0 -1
- package/dist/core-BaGd9k2K.d.mts +0 -76
- package/dist/core-BaGd9k2K.d.mts.map +0 -1
- package/dist/core-CA13n2Iu.cjs +0 -11
- package/dist/core.cjs +0 -8
- package/dist/core.d.cts +0 -9
- package/dist/core.d.mts +0 -2
- package/dist/core.mjs +0 -1
- package/dist/errors-C_uh86xh.mjs +0 -3
- package/dist/errors-C_uh86xh.mjs.map +0 -1
- package/dist/errors-Dn6WQ2pP.cjs +0 -8
- package/dist/index-Do-2CL1V.d.cts +0 -210
- package/dist/index-Do-2CL1V.d.cts.map +0 -1
- package/dist/index-NbQAnciD.d.mts +0 -204
- package/dist/index-NbQAnciD.d.mts.map +0 -1
- package/dist/index.cjs +0 -8
- package/dist/index.d.cts +0 -235
- package/dist/index.d.cts.map +0 -1
- package/dist/index.d.mts +0 -229
- package/dist/index.d.mts.map +0 -1
- package/dist/index.mjs +0 -3
- package/dist/index.mjs.map +0 -1
- package/dist/standard.cjs +0 -8
- package/dist/standard.d.cts +0 -111
- package/dist/standard.d.cts.map +0 -1
- package/dist/standard.d.mts +0 -105
- package/dist/standard.d.mts.map +0 -1
- package/dist/standard.mjs +0 -3
- package/dist/standard.mjs.map +0 -1
package/LICENSE
CHANGED
|
@@ -19,3 +19,6 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
19
19
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
20
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
21
|
SOFTWARE.
|
|
22
|
+
|
|
23
|
+
The `apps/dash` maintainer dashboard is licensed separately under
|
|
24
|
+
AGPL-3.0-or-later. See `apps/dash/LICENSE`.
|
package/README.md
CHANGED
|
@@ -1,104 +1,51 @@
|
|
|
1
|
-
|
|
2
|
-
<a href="https://github.com/yamcodes/arkenv/blob/main/apps/www/public/assets/icon.svg"><img alt="ArkEnv Logo" src="https://arkenv.js.org/assets/icon.svg" width="160px" align="center"/></a>
|
|
3
|
-
<h1 align="center">ArkEnv</h1>
|
|
4
|
-
<div align="center">
|
|
5
|
-
<p align="center">
|
|
6
|
-
Environment variable validation from editor to runtime<br/> for <a href="https://nextjs.org/">Next.js</a>, <a href="https://nuxt.com/">Nuxt</a>, <a href="https://nodejs.org/">Node.js</a>, <a href="https://vite.dev/">Vite</a>, and <a href="https://bun.com/">Bun</a>
|
|
7
|
-
</p>
|
|
8
|
-
<a href="https://github.com/yamcodes/arkenv/actions/workflows/test.yml?query=branch%3Amain"><img alt="Test Status" src="https://github.com/yamcodes/arkenv/actions/workflows/tests-badge.yml/badge.svg?branch=main"></a>
|
|
9
|
-
<a href="https://bundlephobia.com/package/arkenv"><img alt="npm bundle size" src="https://img.shields.io/bundlephobia/minzip/arkenv"></a>
|
|
10
|
-
<a href="https://arktype.io/docs/ecosystem#arkenv"><img alt="ArkType Ecosystem" src="https://custom-icon-badges.demolab.com/badge/ArkType%20Ecosystem-0d1526?logo=arktype2&logoColor=e9eef9"></a>
|
|
11
|
-
<a href="https://pullfrog.com"><img alt="Pullfrog" src="https://custom-icon-badges.demolab.com/badge/Powered%20by%20Pullfrog-2f4032?logo=pullfrog-white"></a>
|
|
12
|
-
</div>
|
|
13
|
-
</p>
|
|
14
|
-
|
|
15
|
-
<div align="center">
|
|
16
|
-
<a href="https://arkenv.js.org/docs/arkenv">Docs</a>
|
|
17
|
-
<span> • </span>
|
|
18
|
-
<a href="https://arkenv.js.org/docs/arkenv/faq">FAQ</a>
|
|
19
|
-
<span> • </span>
|
|
20
|
-
<a href="https://stackblitz.com/github/yamcodes/arkenv/tree/main/examples/stackblitz?file=index.ts">Try on StackBlitz</a>
|
|
21
|
-
<br />
|
|
22
|
-
</div>
|
|
1
|
+
# `arkenv` (CLI)
|
|
23
2
|
|
|
24
|
-
|
|
25
|
-
<br />
|
|
3
|
+
The interactive, zero-dependency scaffolding experience for the [ArkEnv](https://arkenv.js.org) ecosystem.
|
|
26
4
|
|
|
27
|
-
<
|
|
28
|
-
<img alt="ArkEnv Demo" src="https://arkenv.js.org/assets/demo.gif" />
|
|
29
|
-
</p>
|
|
5
|
+
<br />
|
|
30
6
|
|
|
31
7
|
<br />
|
|
32
8
|
|
|
9
|
+
<br />
|
|
33
10
|
|
|
11
|
+
## Quickstart
|
|
34
12
|
|
|
35
|
-
|
|
36
|
-
<summary>npm</summary>
|
|
13
|
+
### Scaffolding (Day 1)
|
|
37
14
|
|
|
38
15
|
```sh
|
|
39
|
-
npx
|
|
16
|
+
npx arkenv init
|
|
40
17
|
```
|
|
41
18
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
<details>
|
|
45
|
-
<summary>pnpm</summary>
|
|
19
|
+
### Local installation (Daily driver & CI)
|
|
46
20
|
|
|
47
21
|
```sh
|
|
48
|
-
|
|
22
|
+
npm install @arkenv/core
|
|
23
|
+
npm install -D arkenv
|
|
49
24
|
```
|
|
50
25
|
|
|
51
|
-
|
|
26
|
+
## Related
|
|
52
27
|
|
|
53
|
-
|
|
54
|
-
|
|
28
|
+
- [ArkEnv](https://arkenv.js.org) - Core library and docs
|
|
29
|
+
- [ArkType](https://arktype.io/) - Underlying validator / type system
|
|
55
30
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
31
|
+
## Architecture & development
|
|
32
|
+
|
|
33
|
+
This CLI is built with a port-and-adapter architecture to remain flexible and testable. See [ARCHITECTURE.md](./ARCHITECTURE.md) for details on the codebase design, architecture rules, and how to use the interactive testing scripts.
|
|
59
34
|
|
|
60
|
-
|
|
35
|
+
### Running the local CLI
|
|
61
36
|
|
|
62
|
-
|
|
63
|
-
<summary>Bun</summary>
|
|
37
|
+
To run your local changes to the CLI from anywhere inside this repository:
|
|
64
38
|
|
|
65
39
|
```sh
|
|
66
|
-
|
|
40
|
+
pnpm arkenv [command]
|
|
67
41
|
```
|
|
68
42
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
<br />
|
|
72
|
-
|
|
73
|
-
### [Read the docs →](https://arkenv.js.org/docs/ArkEnv/quickstart)
|
|
74
|
-
|
|
75
|
-
<br />
|
|
76
|
-
|
|
77
|
-
## Supporting ArkEnv
|
|
78
|
-
|
|
79
|
-
If you love ArkEnv, you can support the project by **starring it on GitHub**!
|
|
80
|
-
|
|
81
|
-
You are also welcome to [contribute to the project](https://github.com/yamcodes/arkenv/blob/main/docs/CONTRIBUTING.md) and join the wonderful people who have contributed:
|
|
43
|
+
This root workspace script will automatically rebuild `arkenv` (CLI) and execute the built bundle via Node.
|
|
82
44
|
|
|
83
|
-
|
|
84
|
-
<!-- prettier-ignore-start -->
|
|
85
|
-
<!-- markdownlint-disable -->
|
|
86
|
-
<table>
|
|
87
|
-
<tbody>
|
|
88
|
-
<tr>
|
|
89
|
-
<td align="center" valign="top" width="14.28%"><a href="https://yam.codes"><img src="https://avatars.githubusercontent.com/u/2014360?v=4?s=100" width="100px;" alt="Yam C Borodetsky"/><br /><sub><b>Yam C Borodetsky</b></sub></a><br /><a href="https://github.com/yamcodes/arkenv/commits?author=yamcodes" title="Code">💻</a> <a href="#question-yamcodes" title="Answering Questions">💬</a> <a href="#ideas-yamcodes" title="Ideas, Planning, & Feedback">🤔</a> <a href="#design-yamcodes" title="Design">🎨</a> <a href="https://github.com/yamcodes/arkenv/commits?author=yamcodes" title="Documentation">📖</a> <a href="https://github.com/yamcodes/arkenv/issues?q=author%3Ayamcodes" title="Bug reports">🐛</a> <a href="#example-yamcodes" title="Examples">💡</a> <a href="#infra-yamcodes" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="https://github.com/yamcodes/arkenv/commits?author=yamcodes" title="Tests">⚠️</a></td>
|
|
90
|
-
<td align="center" valign="top" width="14.28%"><a href="https://github.com/aruaycodes"><img src="https://avatars.githubusercontent.com/u/57131628?v=4?s=100" width="100px;" alt="Aruay Berdikulova"/><br /><sub><b>Aruay Berdikulova</b></sub></a><br /><a href="https://github.com/yamcodes/arkenv/commits?author=aruaycodes" title="Code">💻</a> <a href="#ideas-aruaycodes" title="Ideas, Planning, & Feedback">🤔</a></td>
|
|
91
|
-
<td align="center" valign="top" width="14.28%"><a href="https://arktype.io"><img src="https://avatars.githubusercontent.com/u/10645823?v=4?s=100" width="100px;" alt="David Blass"/><br /><sub><b>David Blass</b></sub></a><br /><a href="#ideas-ssalbdivad" title="Ideas, Planning, & Feedback">🤔</a> <a href="#mentoring-ssalbdivad" title="Mentoring">🧑🏫</a> <a href="#question-ssalbdivad" title="Answering Questions">💬</a></td>
|
|
92
|
-
<td align="center" valign="top" width="14.28%"><a href="https://github.com/danciudev"><img src="https://avatars.githubusercontent.com/u/44430251?v=4?s=100" width="100px;" alt="Andrei Danciu"/><br /><sub><b>Andrei Danciu</b></sub></a><br /><a href="https://github.com/yamcodes/arkenv/commits?author=danciudev" title="Code">💻</a></td>
|
|
93
|
-
<td align="center" valign="top" width="14.28%"><a href="https://joakim.beng.se"><img src="https://avatars.githubusercontent.com/u/1427383?v=4?s=100" width="100px;" alt="Joakim Carlstein"/><br /><sub><b>Joakim Carlstein</b></sub></a><br /><a href="https://github.com/yamcodes/arkenv/commits?author=joakimbeng" title="Code">💻</a> <a href="https://github.com/yamcodes/arkenv/commits?author=joakimbeng" title="Documentation">📖</a></td>
|
|
94
|
-
<td align="center" valign="top" width="14.28%"><a href="https://fresh-accordion-06a.notion.site/Jiayi-Du-1817075e92978076b95cf9d90fb5eceb"><img src="https://avatars.githubusercontent.com/u/166608075?v=4?s=100" width="100px;" alt="RoomWithOutRoof"/><br /><sub><b>RoomWithOutRoof</b></sub></a><br /><a href="https://github.com/yamcodes/arkenv/commits?author=Jah-yee" title="Documentation">📖</a></td>
|
|
95
|
-
</tr>
|
|
96
|
-
</tbody>
|
|
97
|
-
</table>
|
|
45
|
+
### Local environment adapters (`Node*`)
|
|
98
46
|
|
|
99
|
-
|
|
100
|
-
<!-- prettier-ignore-end -->
|
|
47
|
+
Implementations prefixed with `Node` (e.g., `NodeWorkspace`, `NodeProjectScanner`) represent the standard local development environment. They utilize standard `node:*` APIs (like `node:fs` and `node:child_process`) which are universally supported across modern runtimes including Node.js, Bun, and Deno. This naming reflects the API standard used rather than a runtime restriction.
|
|
101
48
|
|
|
102
|
-
|
|
49
|
+
## License
|
|
103
50
|
|
|
104
|
-
|
|
51
|
+
MIT
|
package/dist/bin.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { };
|
package/dist/bin.js
ADDED
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import{a as e,c as t,i as n,l as r,n as i,o as a,s as o,t as s}from"./dist-iC9ZVx-X.js";import{createRequire as c}from"node:module";import{shake as l}from"radashi";import{stripVTControlCharacters as u,styleText as d}from"node:util";import f,{stdin as p,stdout as m}from"node:process";import*as h from"node:readline";import g from"node:readline";import{ReadStream as _}from"node:tty";import"node:fs";import v from"node:path";import{createJiti as y}from"jiti";import{execSync as b,spawn as x}from"node:child_process";import S from"node:fs/promises";import{applyEdits as C,modify as ee,parse as w}from"jsonc-parser";import T from"dedent";import{builders as E,detectCodeFormat as D,generateCode as te,parseModule as O}from"magicast";import{isMap as ne,parseDocument as re}from"yaml";var ie=Object.create,ae=Object.defineProperty,oe=Object.getOwnPropertyDescriptor,se=Object.getOwnPropertyNames,ce=Object.getPrototypeOf,le=Object.prototype.hasOwnProperty,ue=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),de=(e,t)=>{let n={};for(var r in e)ae(n,r,{get:e[r],enumerable:!0});return t||ae(n,Symbol.toStringTag,{value:`Module`}),n},fe=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var i=se(t),a=0,o=i.length,s;a<o;a++)s=i[a],!le.call(e,s)&&s!==n&&ae(e,s,{get:(e=>t[e]).bind(null,s),enumerable:!(r=oe(t,s))||r.enumerable});return e},k=((e,t,n)=>(n=e==null?{}:ie(ce(e)),fe(t||!e||!e.__esModule?ae(n,`default`,{value:e,enumerable:!0}):n,e)))(ue(((e,t)=>{let n=process||{},r=n.argv||[],i=n.env||{},a=!(i.NO_COLOR||r.includes(`--no-color`))&&(!!i.FORCE_COLOR||r.includes(`--color`)||n.platform===`win32`||(n.stdout||{}).isTTY&&i.TERM!==`dumb`||!!i.CI),o=(e,t,n=e)=>r=>{let i=``+r,a=i.indexOf(t,e.length);return~a?e+s(i,t,n,a)+t:e+i+t},s=(e,t,n,r)=>{let i=``,a=0;do i+=e.substring(a,r)+n,a=r+t.length,r=e.indexOf(t,a);while(~r);return i+e.substring(a)},c=(e=a)=>{let t=e?o:()=>String;return{isColorSupported:e,reset:t(`\x1B[0m`,`\x1B[0m`),bold:t(`\x1B[1m`,`\x1B[22m`,`\x1B[22m\x1B[1m`),dim:t(`\x1B[2m`,`\x1B[22m`,`\x1B[22m\x1B[2m`),italic:t(`\x1B[3m`,`\x1B[23m`),underline:t(`\x1B[4m`,`\x1B[24m`),inverse:t(`\x1B[7m`,`\x1B[27m`),hidden:t(`\x1B[8m`,`\x1B[28m`),strikethrough:t(`\x1B[9m`,`\x1B[29m`),black:t(`\x1B[30m`,`\x1B[39m`),red:t(`\x1B[31m`,`\x1B[39m`),green:t(`\x1B[32m`,`\x1B[39m`),yellow:t(`\x1B[33m`,`\x1B[39m`),blue:t(`\x1B[34m`,`\x1B[39m`),magenta:t(`\x1B[35m`,`\x1B[39m`),cyan:t(`\x1B[36m`,`\x1B[39m`),white:t(`\x1B[37m`,`\x1B[39m`),gray:t(`\x1B[90m`,`\x1B[39m`),bgBlack:t(`\x1B[40m`,`\x1B[49m`),bgRed:t(`\x1B[41m`,`\x1B[49m`),bgGreen:t(`\x1B[42m`,`\x1B[49m`),bgYellow:t(`\x1B[43m`,`\x1B[49m`),bgBlue:t(`\x1B[44m`,`\x1B[49m`),bgMagenta:t(`\x1B[45m`,`\x1B[49m`),bgCyan:t(`\x1B[46m`,`\x1B[49m`),bgWhite:t(`\x1B[47m`,`\x1B[49m`),blackBright:t(`\x1B[90m`,`\x1B[39m`),redBright:t(`\x1B[91m`,`\x1B[39m`),greenBright:t(`\x1B[92m`,`\x1B[39m`),yellowBright:t(`\x1B[93m`,`\x1B[39m`),blueBright:t(`\x1B[94m`,`\x1B[39m`),magentaBright:t(`\x1B[95m`,`\x1B[39m`),cyanBright:t(`\x1B[96m`,`\x1B[39m`),whiteBright:t(`\x1B[97m`,`\x1B[39m`),bgBlackBright:t(`\x1B[100m`,`\x1B[49m`),bgRedBright:t(`\x1B[101m`,`\x1B[49m`),bgGreenBright:t(`\x1B[102m`,`\x1B[49m`),bgYellowBright:t(`\x1B[103m`,`\x1B[49m`),bgBlueBright:t(`\x1B[104m`,`\x1B[49m`),bgMagentaBright:t(`\x1B[105m`,`\x1B[49m`),bgCyanBright:t(`\x1B[106m`,`\x1B[49m`),bgWhiteBright:t(`\x1B[107m`,`\x1B[49m`)}};t.exports=c(),t.exports.createColors=c}))(),1);const A={REQUIREMENTS_NOT_MET:`CLI.REQUIREMENTS_NOT_MET`,GIT_TREE_DIRTY:`CLI.GIT_TREE_DIRTY`,NON_EMPTY_DIR:`CLI.NON_EMPTY_DIR`,INTERNAL:`CLI.INTERNAL_ERROR`,SCHEMA_NOT_FOUND:`CLI.SCHEMA_NOT_FOUND`,CANCELLED:`CLI.CANCELLED`,UNKNOWN_COMMAND:`CLI.UNKNOWN_COMMAND`,INVALID_ARGUMENT:`CLI.INVALID_ARGUMENT`,VALIDATION_FAILED:`ENV.VALIDATION_FAILED`,INVALID_VALUE:`ENV.INVALID_VALUE`,MISSING_VARIABLE:`ENV.MISSING_VARIABLE`},j={CLI_INTERNAL_ERROR:`CLI.INTERNAL_ERROR`,CLI_SCHEMA_NOT_FOUND:`CLI.SCHEMA_NOT_FOUND`,CLI_REQUIREMENTS_NOT_MET:`CLI.REQUIREMENTS_NOT_MET`,CLI_GIT_TREE_DIRTY:`CLI.GIT_TREE_DIRTY`,CLI_NON_EMPTY_DIR:`CLI.NON_EMPTY_DIR`,CLI_CANCELLED:`CLI.CANCELLED`,CLI_UNKNOWN_COMMAND:`CLI.UNKNOWN_COMMAND`,CLI_INVALID_ARGUMENT:`CLI.INVALID_ARGUMENT`,ENV_VALIDATION_FAILED:`ENV.VALIDATION_FAILED`,ENV_INVALID_VALUE:`ENV.INVALID_VALUE`,ENV_MISSING_VARIABLE:`ENV.MISSING_VARIABLE`};function pe(){let e=process.env.npm_config_user_agent||``;if(e.includes(`pnpm`))return process.env.npm_command===`dlx`?`pnpm dlx arkenv`:`pnpm arkenv`;if(e.includes(`bun`))return(process.env._||process.argv[1]||``).includes(`bunx`)||process.env.npm_command===`x`?`bunx arkenv`:`bun arkenv`;if(e.includes(`yarn`))return process.env.npm_command===`dlx`?`yarn dlx arkenv`:`yarn arkenv`;if(e.includes(`npm`))return`npx arkenv`;let t=process.env._||process.argv[1]||``;return t.includes(`npx`)?`npx arkenv`:t.includes(`bunx`)?`bunx arkenv`:t.includes(`pnpm`)?`pnpm arkenv`:t.includes(`yarn`)?`yarn arkenv`:t.includes(`bun`)?`bun arkenv`:`arkenv`}function me(e,t=pe()){return e.replace(/\{bin\}/g,t)}function he(e,t=pe()){let n={...e};return n.command&&=me(n.command,t),n.commands&&=n.commands.map(e=>me(e,t)),n}function ge(e){return e.replace(/\x1B\[\d+m/g,``).replace(/\x1B\[[0-9;]*[a-zA-Z]/g,``)}function M(e,t,n){let i=ge(e);return n?.debugSecrets||o(n?.debugSecrets)?i:t&&r(t)?i.replace(/\(was .*\)/g,`(was [REDACTED])`):i}var _e=class{info(e){process.stderr.write(`${k.default.blue(`ℹ ${e}`)}\n`)}warn(e){process.stderr.write(`${k.default.yellow(`⚠ ${e}`)}\n`)}error(e){process.stderr.write(`${k.default.red(`✘ ${e}`)}\n`)}success(e){process.stderr.write(`${k.default.green(`✔ ${e}`)}\n`)}step(e){process.stderr.write(`○ ${e}\n`)}note(e,t){process.stderr.write(`${k.default.dim(`○ ${t?`${t}: `:``}${e}`)}\n`)}log(e){process.stderr.write(`${e}\n`)}spinner(){return{start:e=>process.stderr.write(`${k.default.dim(`○ ${e}...`)}\n`),stop:e=>process.stderr.write(`${k.default.green(`✔ ${e}`)}\n`),message:e=>process.stderr.write(`${k.default.dim(`○ ${e}...`)}\n`)}}json(e){process.stdout.write(`${JSON.stringify(e,null,2)}\n`)}reportCompleted(e){let t=e.diagnostics.map(e=>({...e,nextActions:(e.nextActions??[]).map(e=>he(e))})),n=(e.nextActions??[]).map(e=>he(e));this.json({ok:!0,commandId:e.commandId,result:e.result,exitCode:e.exitCode,diagnostics:t,nextActions:n})}reportErrored(e){let t=(e.error.nextActions??[]).map(e=>he(e)),n=(e.nextActions??t).map(e=>he(e)),r=(e.diagnostics??[]).map(e=>({...e,nextActions:(e.nextActions??[]).map(e=>he(e))}));this.json({ok:!1,commandId:e.commandId,error:{...e.error,nextActions:t},diagnostics:r,nextActions:n})}cancel(e,t=`cli`){this.reportErrored({ok:!1,commandId:t,error:{code:A.CANCELLED,severity:`info`,summary:M(e),nextActions:[]},diagnostics:[],nextActions:[]})}fatal(e,t,n=`cli`){let r=t instanceof Error?t.message:t?String(t):void 0;throw this.reportErrored({ok:!1,commandId:n,error:{code:A.INTERNAL,severity:`error`,summary:M(e),...r===void 0?{}:{why:M(r)},...r===void 0?{}:{meta:{error:r}},nextActions:[]},diagnostics:[],nextActions:[]}),t instanceof Error?t:Error(e)}refuse(e,t=`init`){let n=e.nextActions??(e.retryWith?.includes(`--force`)?[{kind:`run-command`,label:`Re-run with --force to bypass this check`,command:`{bin} ${t} --force`}]:[]);this.reportErrored({ok:!1,commandId:t,error:{code:e.code,severity:`error`,summary:M(e.message),...e.why?{why:M(e.why)}:{},...e.details===void 0?{}:{meta:e.details},nextActions:n},diagnostics:[],nextActions:n})}finish(e,t,n=`init`){this.reportCompleted({ok:!0,commandId:n,result:{message:e,...t??{}},exitCode:0,diagnostics:[],nextActions:[]})}async flush(){return new Promise(e=>{process.stdout.write(``,()=>e())})}},ve=class{stripAnsi(e){return e.replace(/\x1B\[[0-9;]*[JKmsu]/g,``)}info(e){}warn(e){}error(e){}success(e){}step(e){}note(e,t){}log(e){process.stdout.write(`${this.stripAnsi(e)}\n`)}spinner(){return{start:e=>{},stop:e=>{},message:e=>{}}}json(e){process.stdout.write(`${JSON.stringify(e,null,2)}\n`)}cancel(e,t){process.stderr.write(`✘ Cancelled: ${e}\n`)}fatal(e,t,n){throw process.stderr.write(`✘ Fatal: ${e}\n`),t&&process.stderr.write(`${t instanceof Error?t.stack??t.message:String(t)}\n`),t instanceof Error?t:Error(e)}refuse(e,t){}finish(e,t,n){}reportCompleted(e){}reportErrored(e){}async flush(){return new Promise(e=>{process.stderr.write(``,()=>e())})}};const ye=(()=>{let e=/[\uD800-\uDBFF][\uDC00-\uDFFF]/g;return t=>{let n=0;for(e.lastIndex=0;e.test(t);)n+=1;return t.length-n}})(),be=e=>e===12288||e>=65281&&e<=65376||e>=65504&&e<=65510,xe=e=>e===8987||e===9001||e>=12272&&e<=12287||e>=12289&&e<=12350||e>=12441&&e<=12543||e>=12549&&e<=12591||e>=12593&&e<=12686||e>=12688&&e<=12771||e>=12783&&e<=12830||e>=12832&&e<=12871||e>=12880&&e<=19903||e>=65040&&e<=65049||e>=65072&&e<=65106||e>=65108&&e<=65126||e>=65128&&e<=65131||e>=127488&&e<=127490||e>=127504&&e<=127547||e>=127552&&e<=127560||e>=131072&&e<=196605||e>=196608&&e<=262141,Se=/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001b\]8;[^;]*;.*?(?:\u0007|\u001b\u005c)/y,Ce=/[\x00-\x08\x0A-\x1F\x7F-\x9F]{1,1000}/y,we=/(?:(?![\uFF61-\uFF9F\uFF00-\uFFEF])[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Script=Tangut}]){1,1000}/uy,Te=/\t{1,1000}/y,Ee=/[\u{1F1E6}-\u{1F1FF}]{2}|\u{1F3F4}[\u{E0061}-\u{E007A}]{2}[\u{E0030}-\u{E0039}\u{E0061}-\u{E007A}]{1,3}\u{E007F}|(?:\p{Emoji}\uFE0F\u20E3?|\p{Emoji_Modifier_Base}\p{Emoji_Modifier}?|\p{Emoji_Presentation})(?:\u200D(?:\p{Emoji_Modifier_Base}\p{Emoji_Modifier}?|\p{Emoji_Presentation}|\p{Emoji}\uFE0F\u20E3?))*/uy,De=/(?:[\x20-\x7E\xA0-\xFF](?!\uFE0F)){1,1000}/y,Oe=/\p{M}+/gu,ke={limit:1/0,ellipsis:``},Ae=(e,t={},n={})=>{let r=t.limit??1/0,i=t.ellipsis??``,a=t?.ellipsisWidth??(i?Ae(i,ke,n).width:0),o=n.controlWidth??0,s=n.tabWidth??8,c=n.emojiWidth??2,l=n.regularWidth??1,u=n.wideWidth??2,d=[[De,l],[Se,0],[Ce,o],[Te,s],[Ee,c],[we,u]],f=0,p=0,m=e.length,h=0,g=!1,_=m,v=Math.max(0,r-a),y=0,b=0,x=0,S=0;outer:for(;;){if(b>y||p>=m&&p>f){let t=e.slice(y,b)||e.slice(f,p);h=0;for(let e of t.replaceAll(Oe,``)){let t=e.codePointAt(0)||0;if(S=be(t)?2:xe(t)?u:l,x+S>v&&(_=Math.min(_,Math.max(y,f)+h)),x+S>r){g=!0;break outer}h+=e.length,x+=S}y=b=0}if(p>=m)break outer;for(let t=0,n=d.length;t<n;t++){let[n,i]=d[t];if(n.lastIndex=p,n.test(e)){if(h=n===we?ye(e.slice(p,n.lastIndex)):n===Ee?1:n.lastIndex-p,S=h*i,x+S>v&&(_=Math.min(_,p+Math.floor((v-x)/i))),x+S>r){g=!0;break outer}x+=S,y=f,b=p,p=f=n.lastIndex;continue outer}}p+=1}return{width:g?v:x,index:g?_:m,truncated:g,ellipsed:g&&r>=a}},je={limit:1/0,ellipsis:``,ellipsisWidth:0},N=(e,t={})=>Ae(e,je,t).width,Me=`]8;;`,Ne=RegExp(`(?:\\[(?<code>\\d+)m|\\${Me}(?<uri>.*))`,`y`),Pe=e=>{if(e>=30&&e<=37||e>=90&&e<=97)return 39;if(e>=40&&e<=47||e>=100&&e<=107)return 49;if(e===1||e===2)return 22;if(e===3)return 23;if(e===4)return 24;if(e===7)return 27;if(e===8)return 28;if(e===9)return 29;if(e===0)return 0},Fe=e=>`[${e}m`,Ie=e=>`${Me}${e}`,Le=(e,t,n)=>{let r=t[Symbol.iterator](),i=!1,a=!1,o=e.at(-1),s=o===void 0?0:N(o),c=r.next(),l=r.next(),u=0;for(;!c.done;){let o=c.value,d=N(o);s+d<=n?e[e.length-1]+=o:(e.push(o),s=0),(o===`\x1B`||o===``)&&(i=!0,a=t.startsWith(Me,u+1)),i?a?o===`\x07`&&(i=!1,a=!1):o===`m`&&(i=!1):(s+=d,s===n&&!l.done&&(e.push(``),s=0)),c=l,l=r.next(),u+=o.length}o=e.at(-1),!s&&o!==void 0&&o.length&&e.length>1&&(e[e.length-2]+=e.pop())},Re=e=>{let t=e.split(` `),n=t.length;for(;n&&!N(t[n-1]);)n--;return n===t.length?e:t.slice(0,n).join(` `)+t.slice(n).join(``)},ze=(e,t,n={})=>{if(n.trim!==!1&&e.trim()===``)return``;let r=``,i,a,o=e.split(` `),s=[``],c=0;for(let e=0;e<o.length;e++){let r=o[e];if(n.trim!==!1){let e=s.at(-1)??``,t=e.trimStart();e.length!==t.length&&(s[s.length-1]=t,c=N(t))}e!==0&&(c>=t&&(n.wordWrap===!1||n.trim===!1)&&(s.push(``),c=0),(c||n.trim===!1)&&(s[s.length-1]+=` `,c++));let i=N(r);if(n.hard&&i>t){let e=t-c,n=1+Math.floor((i-e-1)/t);Math.floor((i-1)/t)<n&&s.push(``),Le(s,r,t),c=N(s.at(-1)??``);continue}if(c+i>t&&c&&i){if(n.wordWrap===!1&&c<t){Le(s,r,t),c=N(s.at(-1)??``);continue}s.push(``),c=0}if(c+i>t&&n.wordWrap===!1){Le(s,r,t),c=N(s.at(-1)??``);continue}s[s.length-1]+=r,c+=i}n.trim!==!1&&(s=s.map(e=>Re(e)));let l=s.join(`
|
|
3
|
+
`),u=!1;for(let e=0;e<l.length;e++){let t=l[e];if(r+=t,u)u=!1;else if(u=t>=`\ud800`&&t<=`\udbff`,u)continue;if(t===`\x1B`||t===``){Ne.lastIndex=e+1;let t=Ne.exec(l)?.groups;if(t?.code!==void 0){let e=Number.parseFloat(t.code);i=e===39?void 0:e}else t?.uri!==void 0&&(a=t.uri.length===0?void 0:t.uri)}if(l[e+1]===`
|
|
4
|
+
`){a&&(r+=Ie(``));let e=i?Pe(i):void 0;i&&e&&(r+=Fe(e))}else t===`
|
|
5
|
+
`&&(i&&Pe(i)&&(r+=Fe(i)),a&&(r+=Ie(a)))}return r},Be=/\r?\n/;function P(e,t,n){return String(e).normalize().split(Be).map(e=>ze(e,t,n)).join(`
|
|
6
|
+
`)}var F=ue(((e,t)=>{let n={to(e,t){return t?`[${t+1};${e+1}H`:`[${e+1}G`},move(e,t){let n=``;return e<0?n+=`[${-e}D`:e>0&&(n+=`[${e}C`),t<0?n+=`[${-t}A`:t>0&&(n+=`[${t}B`),n},up:(e=1)=>`[${e}A`,down:(e=1)=>`[${e}B`,forward:(e=1)=>`[${e}C`,backward:(e=1)=>`[${e}D`,nextLine:(e=1)=>`\x1B[E`.repeat(e),prevLine:(e=1)=>`\x1B[F`.repeat(e),left:`\x1B[G`,hide:`\x1B[?25l`,show:`\x1B[?25h`,save:`\x1B7`,restore:`\x1B8`};t.exports={cursor:n,scroll:{up:(e=1)=>`\x1B[S`.repeat(e),down:(e=1)=>`\x1B[T`.repeat(e)},erase:{screen:`\x1B[2J`,up:(e=1)=>`\x1B[1J`.repeat(e),down:(e=1)=>`\x1B[J`.repeat(e),line:`\x1B[2K`,lineEnd:`\x1B[K`,lineStart:`\x1B[1K`,lines(e){let t=``;for(let r=0;r<e;r++)t+=this.line+(r<e-1?n.up():``);return e&&(t+=n.left),t}},beep:`\x07`}}))();function Ve(e,t,n){if(!n.some(e=>!e.disabled))return e;let r=e+t,i=Math.max(n.length-1,0),a=r<0?i:r>i?0:r;return n[a].disabled?Ve(a,t<0?-1:1,n):a}const I={actions:new Set([`up`,`down`,`left`,`right`,`space`,`enter`,`cancel`]),aliases:new Map([[`k`,`up`],[`j`,`down`],[`h`,`left`],[`l`,`right`],[``,`cancel`],[`escape`,`cancel`]]),messages:{cancel:`Canceled`,error:`Something went wrong`},withGuide:!0,date:{monthNames:[...[`January`,`February`,`March`,`April`,`May`,`June`,`July`,`August`,`September`,`October`,`November`,`December`]],messages:{required:`Please enter a valid date`,invalidMonth:`There are only 12 months in a year`,invalidDay:(e,t)=>`There are only ${e} days in ${t}`,afterMin:e=>`Date must be on or after ${e.toISOString().slice(0,10)}`,beforeMax:e=>`Date must be on or before ${e.toISOString().slice(0,10)}`}}};function He(e,t){if(typeof e==`string`)return I.aliases.get(e)===t;for(let n of e)if(n!==void 0&&He(n,t))return!0;return!1}function Ue(e,t){if(e===t)return;let n=e.split(`
|
|
7
|
+
`),r=t.split(`
|
|
8
|
+
`),i=Math.max(n.length,r.length),a=[];for(let e=0;e<i;e++)n[e]!==r[e]&&a.push(e);return{lines:a,numLinesBefore:n.length,numLinesAfter:r.length,numLines:i}}const We=globalThis.process.platform.startsWith(`win`),Ge=Symbol(`clack:cancel`);function L(e){return e===Ge}function Ke(e,t){let n=e;n.isTTY&&n.setRawMode(t)}function qe({input:e=p,output:t=m,overwrite:n=!0,hideCursor:r=!0}={}){let i=h.createInterface({input:e,output:t,prompt:``,tabSize:1});h.emitKeypressEvents(e,i),e instanceof _&&e.isTTY&&e.setRawMode(!0);let a=(i,{name:o,sequence:s})=>{if(He([String(i),o,s],`cancel`)){r&&t.write(F.cursor.show),process.exit(0);return}if(!n)return;let c=o===`return`?0:-1,l=o===`return`?-1:0;h.moveCursor(t,c,l,()=>{h.clearLine(t,1,()=>{e.once(`keypress`,a)})})};return r&&t.write(F.cursor.hide),e.once(`keypress`,a),()=>{e.off(`keypress`,a),r&&t.write(F.cursor.show),e instanceof _&&e.isTTY&&!We&&e.setRawMode(!1),i.terminal=!1,i.close()}}const Je=e=>`columns`in e&&typeof e.columns==`number`?e.columns:80,Ye=e=>`rows`in e&&typeof e.rows==`number`?e.rows:20;function Xe(e,t,n,r=n,i){return P(t,Je(e??m)-n.length,{hard:!0,trim:!1}).split(`
|
|
9
|
+
`).map((e,t)=>{let a=i?i(e,t):e;return`${t===0?r:n}${a}`}).join(`
|
|
10
|
+
`)}let Ze=class{input;output;_abortSignal;rl;opts;_render;_track=!1;_prevFrame=``;_subscribers=new Map;_cursor=0;state=`initial`;error=``;value;userInput=``;constructor(e,t=!0){let{input:n=p,output:r=m,render:i,signal:a,...o}=e;this.opts=o,this.onKeypress=this.onKeypress.bind(this),this.close=this.close.bind(this),this.render=this.render.bind(this),this._render=i.bind(this),this._track=t,this._abortSignal=a,this.input=n,this.output=r}unsubscribe(){this._subscribers.clear()}setSubscriber(e,t){let n=this._subscribers.get(e)??[];n.push(t),this._subscribers.set(e,n)}on(e,t){this.setSubscriber(e,{cb:t})}once(e,t){this.setSubscriber(e,{cb:t,once:!0})}emit(e,...t){let n=this._subscribers.get(e)??[],r=[];for(let e of n)e.cb(...t),e.once&&r.push(()=>n.splice(n.indexOf(e),1));for(let e of r)e()}prompt(){return new Promise(e=>{if(this._abortSignal){if(this._abortSignal.aborted)return this.state=`cancel`,this.close(),e(Ge);this._abortSignal.addEventListener(`abort`,()=>{this.state=`cancel`,this.close()},{once:!0})}this.rl=g.createInterface({input:this.input,tabSize:2,prompt:``,escapeCodeTimeout:50,terminal:!0}),this.rl.prompt(),this.opts.initialUserInput!==void 0&&this._setUserInput(this.opts.initialUserInput,!0),this.input.on(`keypress`,this.onKeypress),Ke(this.input,!0),this.output.on(`resize`,this.render),this.render(),this.once(`submit`,()=>{this.output.write(F.cursor.show),this.output.off(`resize`,this.render),Ke(this.input,!1),e(this.value)}),this.once(`cancel`,()=>{this.output.write(F.cursor.show),this.output.off(`resize`,this.render),Ke(this.input,!1),e(Ge)})})}_isActionKey(e,t){return e===` `}_shouldSubmit(e,t){return!0}_setValue(e){this.value=e,this.emit(`value`,this.value)}_setUserInput(e,t){this.userInput=e??``,this.emit(`userInput`,this.userInput),t&&this._track&&this.rl&&(this.rl.write(this.userInput),this._cursor=this.rl.cursor)}_clearUserInput(){this.rl?.write(null,{ctrl:!0,name:`u`}),this._setUserInput(``)}onKeypress(e,t){if(this._track&&t.name!==`return`&&(t.name&&this._isActionKey(e,t)&&this.rl?.write(null,{ctrl:!0,name:`h`}),this._cursor=this.rl?.cursor??0,this._setUserInput(this.rl?.line)),this.state===`error`&&(this.state=`active`),t?.name&&(!this._track&&I.aliases.has(t.name)&&this.emit(`cursor`,I.aliases.get(t.name)),I.actions.has(t.name)&&this.emit(`cursor`,t.name)),e&&(e.toLowerCase()===`y`||e.toLowerCase()===`n`)&&this.emit(`confirm`,e.toLowerCase()===`y`),this.emit(`key`,e?.toLowerCase(),t),t?.name===`return`&&this._shouldSubmit(e,t)){if(this.opts.validate){let e=this.opts.validate(this.value);e&&(this.error=e instanceof Error?e.message:e,this.state=`error`,this.rl?.write(this.userInput))}this.state!==`error`&&(this.state=`submit`)}He([e,t?.name,t?.sequence],`cancel`)&&(this.state=`cancel`),(this.state===`submit`||this.state===`cancel`)&&this.emit(`finalize`),this.render(),(this.state===`submit`||this.state===`cancel`)&&this.close()}close(){this.input.unpipe(),this.input.removeListener(`keypress`,this.onKeypress),this.output.write(`
|
|
11
|
+
`),Ke(this.input,!1),this.rl?.close(),this.rl=void 0,this.emit(`${this.state}`,this.value),this.unsubscribe()}restoreCursor(){let e=P(this._prevFrame,process.stdout.columns,{hard:!0,trim:!1}).split(`
|
|
12
|
+
`).length-1;this.output.write(F.cursor.move(-999,e*-1))}render(){let e=P(this._render(this)??``,process.stdout.columns,{hard:!0,trim:!1});if(e!==this._prevFrame){if(this.state===`initial`)this.output.write(F.cursor.hide);else{let t=Ue(this._prevFrame,e),n=Ye(this.output);if(this.restoreCursor(),t){let r=Math.max(0,t.numLinesAfter-n),i=Math.max(0,t.numLinesBefore-n),a=t.lines.find(e=>e>=r);if(a===void 0){this._prevFrame=e;return}if(t.lines.length===1){this.output.write(F.cursor.move(0,a-i)),this.output.write(F.erase.lines(1));let t=e.split(`
|
|
13
|
+
`);this.output.write(t[a]),this._prevFrame=e,this.output.write(F.cursor.move(0,t.length-a-1));return}else if(t.lines.length>1){if(r<i)a=r;else{let e=a-i;e>0&&this.output.write(F.cursor.move(0,e))}this.output.write(F.erase.down());let t=e.split(`
|
|
14
|
+
`).slice(a);this.output.write(t.join(`
|
|
15
|
+
`)),this._prevFrame=e;return}}this.output.write(F.erase.down())}this.output.write(e),this.state===`initial`&&(this.state=`active`),this._prevFrame=e}}};var Qe=class extends Ze{get cursor(){return+!this.value}get _value(){return this.cursor===0}constructor(e){super(e,!1),this.value=!!e.initialValue,this.on(`userInput`,()=>{this.value=this._value}),this.on(`confirm`,e=>{this.output.write(F.cursor.move(0,-1)),this.value=e,this.state=`submit`,this.close()}),this.on(`cursor`,()=>{this.value=!this.value})}},$e=class extends Ze{options;cursor=0;get _selectedValue(){return this.options[this.cursor]}changeValue(){this.value=this._selectedValue.value}constructor(e){super(e,!1),this.options=e.options;let t=this.options.findIndex(({value:t})=>t===e.initialValue),n=t===-1?0:t;this.cursor=this.options[n].disabled?Ve(n,1,this.options):n,this.changeValue(),this.on(`cursor`,e=>{switch(e){case`left`:case`up`:this.cursor=Ve(this.cursor,-1,this.options);break;case`down`:case`right`:this.cursor=Ve(this.cursor,1,this.options);break}this.changeValue()})}},et=class extends Ze{get userInputWithCursor(){if(this.state===`submit`)return this.userInput;let e=this.userInput;if(this.cursor>=e.length)return`${this.userInput}\u2588`;let t=e.slice(0,this.cursor),[n,...r]=e.slice(this.cursor);return`${t}${d(`inverse`,n)}${r.join(``)}`}get cursor(){return this._cursor}constructor(e){super({...e,initialUserInput:e.initialUserInput??e.initialValue}),this.on(`userInput`,e=>{this._setValue(e)}),this.on(`finalize`,()=>{this.value||=e.defaultValue,this.value===void 0&&(this.value=``)})}};function tt(){return f.platform===`win32`?!!f.env.CI||!!f.env.WT_SESSION||!!f.env.TERMINUS_SUBLIME||f.env.ConEmuTask===`{cmd::Cmder}`||f.env.TERM_PROGRAM===`Terminus-Sublime`||f.env.TERM_PROGRAM===`vscode`||f.env.TERM===`xterm-256color`||f.env.TERM===`alacritty`||f.env.TERMINAL_EMULATOR===`JetBrains-JediTerm`:f.env.TERM!==`linux`}const nt=tt(),rt=()=>process.env.CI===`true`,R=(e,t)=>nt?e:t,it=R(`◆`,`*`),at=R(`■`,`x`),ot=R(`▲`,`x`),z=R(`◇`,`o`),B=R(`│`,`|`),V=R(`└`,`—`),st=R(`●`,`>`),ct=R(`○`,` `),lt=R(`─`,`-`),ut=R(`╮`,`+`),dt=R(`├`,`+`),ft=R(`╯`,`+`),pt=R(`╰`,`+`),mt=R(`●`,`•`),ht=R(`◆`,`*`),gt=R(`▲`,`!`),_t=R(`■`,`x`),vt=e=>{switch(e){case`initial`:case`active`:return d(`cyan`,it);case`cancel`:return d(`red`,at);case`error`:return d(`yellow`,ot);case`submit`:return d(`green`,z)}},yt=e=>{switch(e){case`initial`:case`active`:return d(`cyan`,B);case`cancel`:return d(`red`,B);case`error`:return d(`yellow`,B);case`submit`:return d(`green`,B)}},bt=(e,t,n,r,i)=>{let a=t,o=0;for(let t=n;t<r;t++){let n=e[t];if(a-=n.length,o++,a<=i)break}return{lineCount:a,removals:o}},xt=({cursor:e,options:t,style:n,output:r=process.stdout,maxItems:i=1/0,columnPadding:a=0,rowPadding:o=4})=>{let s=Je(r)-a,c=Ye(r),l=d(`dim`,`...`),u=Math.max(c-o,0),f=Math.max(Math.min(i,u),5),p=0;e>=f-3&&(p=Math.max(Math.min(e-f+3,t.length-f),0));let m=f<t.length&&p>0,h=f<t.length&&p+f<t.length,g=Math.min(p+f,t.length),_=[],v=0;m&&v++,h&&v++;let y=p+ +!!m,b=g-+!!h;for(let r=y;r<b;r++){let i=P(n(t[r],r===e),s,{hard:!0,trim:!1}).split(`
|
|
16
|
+
`);_.push(i),v+=i.length}if(v>u){let t=0,n=0,r=v,i=e-y,a=(e,t)=>bt(_,r,e,t,u);m?({lineCount:r,removals:t}=a(0,i),r>u&&({lineCount:r,removals:n}=a(i+1,_.length))):({lineCount:r,removals:n}=a(i+1,_.length),r>u&&({lineCount:r,removals:t}=a(0,i))),t>0&&(m=!0,_.splice(0,t)),n>0&&(h=!0,_.splice(_.length-n,n))}let x=[];m&&x.push(l);for(let e of _)for(let t of e)x.push(t);return h&&x.push(l),x},H=e=>{let t=e.active??`Yes`,n=e.inactive??`No`;return new Qe({active:t,inactive:n,signal:e.signal,input:e.input,output:e.output,initialValue:e.initialValue??!0,render(){let r=e.withGuide??I.withGuide,i=`${vt(this.state)} `,a=r?`${d(`gray`,B)} `:``,o=Xe(e.output,e.message,a,i),s=`${r?`${d(`gray`,B)}
|
|
17
|
+
`:``}${o}
|
|
18
|
+
`,c=this.value?t:n;switch(this.state){case`submit`:return`${s}${r?`${d(`gray`,B)} `:``}${d(`dim`,c)}`;case`cancel`:return`${s}${r?`${d(`gray`,B)} `:``}${d([`strikethrough`,`dim`],c)}${r?`
|
|
19
|
+
${d(`gray`,B)}`:``}`;default:{let i=r?`${d(`cyan`,B)} `:``,a=r?d(`cyan`,V):``;return`${s}${i}${this.value?`${d(`green`,st)} ${t}`:`${d(`dim`,ct)} ${d(`dim`,t)}`}${e.vertical?r?`
|
|
20
|
+
${d(`cyan`,B)} `:`
|
|
21
|
+
`:` ${d(`dim`,`/`)} `}${this.value?`${d(`dim`,ct)} ${d(`dim`,n)}`:`${d(`green`,st)} ${n}`}
|
|
22
|
+
${a}
|
|
23
|
+
`}}}}).prompt()},U={message:(e=[],{symbol:t=d(`gray`,B),secondarySymbol:n=d(`gray`,B),output:r=process.stdout,spacing:i=1,withGuide:a}={})=>{let o=[],s=a??I.withGuide,c=s?n:``,l=s?`${t} `:``,u=s?`${n} `:``;for(let e=0;e<i;e++)o.push(c);let f=Array.isArray(e)?e:e.split(`
|
|
24
|
+
`);if(f.length>0){let[e,...r]=f;e.length>0?o.push(`${l}${e}`):o.push(s?t:``);for(let e of r)e.length>0?o.push(`${u}${e}`):o.push(s?n:``)}r.write(`${o.join(`
|
|
25
|
+
`)}
|
|
26
|
+
`)},info:(e,t)=>{U.message(e,{...t,symbol:d(`blue`,mt)})},success:(e,t)=>{U.message(e,{...t,symbol:d(`green`,ht)})},step:(e,t)=>{U.message(e,{...t,symbol:d(`green`,z)})},warn:(e,t)=>{U.message(e,{...t,symbol:d(`yellow`,gt)})},warning:(e,t)=>{U.warn(e,t)},error:(e,t)=>{U.message(e,{...t,symbol:d(`red`,_t)})}},St=(e=``,t)=>{let n=t?.output??process.stdout,r=t?.withGuide??I.withGuide?`${d(`gray`,V)} `:``;n.write(`${r}${d(`red`,e)}
|
|
27
|
+
|
|
28
|
+
`)},Ct=(e=``,t)=>{let n=t?.output??process.stdout,r=t?.withGuide??I.withGuide?`${d(`gray`,B)}
|
|
29
|
+
${d(`gray`,V)} `:``;n.write(`${r}${e}
|
|
30
|
+
|
|
31
|
+
`)},wt=e=>d(`dim`,e),Tt=(e,t,n)=>{let r={hard:!0,trim:!1},i=P(e,t,r).split(`
|
|
32
|
+
`),a=i.reduce((e,t)=>Math.max(N(t),e),0);return P(e,t-(i.map(n).reduce((e,t)=>Math.max(N(t),e),0)-a),r)},Et=(e=``,t=``,n)=>{let r=n?.output??f.stdout,i=n?.withGuide??I.withGuide,a=n?.format??wt,o=[``,...Tt(e,Je(r)-6,a).split(`
|
|
33
|
+
`).map(a),``],s=N(t),c=Math.max(o.reduce((e,t)=>{let n=N(t);return n>e?n:e},0),s)+2,l=o.map(e=>`${d(`gray`,B)} ${e}${` `.repeat(c-N(e))}${d(`gray`,B)}`).join(`
|
|
34
|
+
`),u=i?`${d(`gray`,B)}
|
|
35
|
+
`:``,p=i?dt:pt;r.write(`${u}${d(`green`,z)} ${d(`reset`,t)} ${d(`gray`,lt.repeat(Math.max(c-s-1,1))+ut)}
|
|
36
|
+
${l}
|
|
37
|
+
${d(`gray`,p+lt.repeat(c+2)+ft)}
|
|
38
|
+
`)},Dt=e=>d(`magenta`,e),Ot=({indicator:e=`dots`,onCancel:t,output:n=process.stdout,cancelMessage:r,errorMessage:i,frames:a=nt?[`◒`,`◐`,`◓`,`◑`]:[`•`,`o`,`O`,`0`],delay:o=nt?80:120,signal:s,...c}={})=>{let l=rt(),u,f,p=!1,m=!1,h=``,g,_=performance.now(),v=Je(n),y=c?.styleFrame??Dt,b=e=>{let n=e>1?i??I.messages.error:r??I.messages.cancel;m=e===1,p&&(O(n,e),m&&typeof t==`function`&&t())},x=()=>b(2),S=()=>b(1),C=()=>{process.on(`uncaughtExceptionMonitor`,x),process.on(`unhandledRejection`,x),process.on(`SIGINT`,S),process.on(`SIGTERM`,S),process.on(`exit`,b),s&&s.addEventListener(`abort`,S)},ee=()=>{process.removeListener(`uncaughtExceptionMonitor`,x),process.removeListener(`unhandledRejection`,x),process.removeListener(`SIGINT`,S),process.removeListener(`SIGTERM`,S),process.removeListener(`exit`,b),s&&s.removeEventListener(`abort`,S)},w=()=>{if(g===void 0)return;l&&n.write(`
|
|
39
|
+
`);let e=P(g,v,{hard:!0,trim:!1}).split(`
|
|
40
|
+
`);e.length>1&&n.write(F.cursor.up(e.length-1)),n.write(F.cursor.to(0)),n.write(F.erase.down())},T=e=>e.replace(/\.+$/,``),E=e=>{let t=(performance.now()-e)/1e3,n=Math.floor(t/60),r=Math.floor(t%60);return n>0?`[${n}m ${r}s]`:`[${r}s]`},D=c.withGuide??I.withGuide,te=(t=``)=>{p=!0,u=qe({output:n}),h=T(t),_=performance.now(),D&&n.write(`${d(`gray`,B)}
|
|
41
|
+
`);let r=0,i=0;C(),f=setInterval(()=>{if(l&&h===g)return;w(),g=h;let t=y(a[r]),o;if(l)o=`${t} ${h}...`;else if(e===`timer`)o=`${t} ${h} ${E(_)}`;else{let e=`.`.repeat(Math.floor(i)).slice(0,3);o=`${t} ${h}${e}`}let s=P(o,v,{hard:!0,trim:!1});n.write(s),r=r+1<a.length?r+1:0,i=i<4?i+.125:0},o)},O=(t=``,r=0,i=!1)=>{if(!p)return;p=!1,clearInterval(f),w();let a=r===0?d(`green`,z):r===1?d(`red`,at):d(`red`,ot);h=t??h,i||(e===`timer`?n.write(`${a} ${h} ${E(_)}
|
|
42
|
+
`):n.write(`${a} ${h}
|
|
43
|
+
`)),ee(),u()};return{start:te,stop:(e=``)=>O(e,0),message:(e=``)=>{h=T(e??h)},cancel:(e=``)=>O(e,1),error:(e=``)=>O(e,2),clear:()=>O(``,0,!0),get isCancelled(){return m}}},kt=(e,t)=>e.includes(`
|
|
44
|
+
`)?e.split(`
|
|
45
|
+
`).map(e=>t(e)).join(`
|
|
46
|
+
`):t(e),W=e=>{let t=(e,t)=>{let n=e.label??String(e.value);switch(t){case`disabled`:return`${d(`gray`,ct)} ${kt(n,e=>d(`gray`,e))}${e.hint?` ${d(`dim`,`(${e.hint??`disabled`})`)}`:``}`;case`selected`:return`${kt(n,e=>d(`dim`,e))}`;case`active`:return`${d(`green`,st)} ${n}${e.hint?` ${d(`dim`,`(${e.hint})`)}`:``}`;case`cancelled`:return`${kt(n,e=>d([`strikethrough`,`dim`],e))}`;default:return`${d(`dim`,ct)} ${kt(n,e=>d(`dim`,e))}`}};return new $e({options:e.options,signal:e.signal,input:e.input,output:e.output,initialValue:e.initialValue,render(){let n=e.withGuide??I.withGuide,r=`${vt(this.state)} `,i=`${yt(this.state)} `,a=Xe(e.output,e.message,i,r),o=`${n?`${d(`gray`,B)}
|
|
47
|
+
`:``}${a}
|
|
48
|
+
`;switch(this.state){case`submit`:{let r=n?`${d(`gray`,B)} `:``;return`${o}${Xe(e.output,t(this.options[this.cursor],`selected`),r)}`}case`cancel`:{let r=n?`${d(`gray`,B)} `:``;return`${o}${Xe(e.output,t(this.options[this.cursor],`cancelled`),r)}${n?`
|
|
49
|
+
${d(`gray`,B)}`:``}`}default:{let r=n?`${d(`cyan`,B)} `:``,i=n?d(`cyan`,V):``,a=o.split(`
|
|
50
|
+
`).length,s=n?2:1;return`${o}${r}${xt({output:e.output,cursor:this.cursor,options:this.options,maxItems:e.maxItems,columnPadding:r.length,rowPadding:a+s,style:(e,n)=>t(e,e.disabled?`disabled`:n?`active`:`inactive`)}).join(`
|
|
51
|
+
${r}`)}
|
|
52
|
+
${i}
|
|
53
|
+
`}}}}).prompt()},At=`${d(`gray`,B)} `,G={message:async(e,{symbol:t=d(`gray`,B)}={})=>{process.stdout.write(`${d(`gray`,B)}
|
|
54
|
+
${t} `);let n=3;for await(let t of e){t=t.replace(/\n/g,`
|
|
55
|
+
${At}`),t.includes(`
|
|
56
|
+
`)&&(n=3+u(t.slice(t.lastIndexOf(`
|
|
57
|
+
`))).length);let e=u(t).length;n+e<process.stdout.columns?(n+=e,process.stdout.write(t)):(process.stdout.write(`
|
|
58
|
+
${At}${t.trimStart()}`),n=3+u(t.trimStart()).length)}process.stdout.write(`
|
|
59
|
+
`)},info:e=>G.message(e,{symbol:d(`blue`,mt)}),success:e=>G.message(e,{symbol:d(`green`,ht)}),step:e=>G.message(e,{symbol:d(`green`,z)}),warn:e=>G.message(e,{symbol:d(`yellow`,gt)}),warning:e=>G.warn(e),error:e=>G.message(e,{symbol:d(`red`,_t)})},jt=e=>new et({validate:e.validate,placeholder:e.placeholder,defaultValue:e.defaultValue,initialValue:e.initialValue,output:e.output,signal:e.signal,input:e.input,render(){let t=e?.withGuide??I.withGuide,n=`${`${t?`${d(`gray`,B)}
|
|
60
|
+
`:``}${vt(this.state)} `}${e.message}
|
|
61
|
+
`,r=e.placeholder?d(`inverse`,e.placeholder[0])+d(`dim`,e.placeholder.slice(1)):d([`inverse`,`hidden`],`_`),i=this.userInput?this.userInputWithCursor:r,a=this.value??``;switch(this.state){case`error`:{let e=this.error?` ${d(`yellow`,this.error)}`:``,r=t?`${d(`yellow`,B)} `:``,a=t?d(`yellow`,V):``;return`${n.trim()}
|
|
62
|
+
${r}${i}
|
|
63
|
+
${a}${e}
|
|
64
|
+
`}case`submit`:{let e=a?` ${d(`dim`,a)}`:``;return`${n}${t?d(`gray`,B):``}${e}`}case`cancel`:{let e=a?` ${d([`strikethrough`,`dim`],a)}`:``,r=t?d(`gray`,B):``;return`${n}${r}${e}${a.trim()?`
|
|
65
|
+
${r}`:``}`}default:return`${n}${t?`${d(`cyan`,B)} `:``}${i}
|
|
66
|
+
${t?d(`cyan`,V):``}
|
|
67
|
+
`}}}).prompt();var Mt=class{info(e){process.stdout.write(`${k.default.blue(`ℹ ${e}`)}\n`)}warn(e){process.stderr.write(`${k.default.yellow(`⚠ ${e}`)}\n`)}error(e){process.stderr.write(`${k.default.red(`✘ ${e}`)}\n`)}success(e){process.stdout.write(`${k.default.green(`✔ ${e}`)}\n`)}step(e){process.stdout.write(`○ ${e}\n`)}note(e,t){Et(e,t)}log(e){process.stdout.write(`${e}\n`)}spinner(){return Ot()}json(e){process.stdout.write(`${JSON.stringify(e,null,2)}\n`)}cancel(e,t){process.stderr.write(`${k.default.red(`✘ ${e}`)}\n`)}fatal(e,t,n){if(process.stderr.write(`${k.default.red(`✘ ${e}`)}\n`),t){let e=`${k.default.red(t instanceof Error?t.stack??String(t):String(t))}\n`;process.stderr.write(e)}throw t instanceof Error?t:Error(e)}refuse(e,t){}finish(e,t,n){Ct(e)}reportCompleted(e){e.exitCode===0&&this.success(`Environment variables are valid`)}reportErrored(e){this.error(e.error.summary),e.error.why&&this.warn(e.error.why)}async flush(){return new Promise(e=>{process.stderr.write(``,()=>e())})}},Nt=class{constructor(e){this.options=e,this.originalStdoutWrite=process.stdout.write,e.reporter?this.reporter=e.reporter:e.isJson?this.reporter=new _e:e.isQuiet?this.reporter=new ve:this.reporter=new Mt}get isJson(){return this.options.isJson}debug(e){this.reporter.log(e)}info(e){this.reporter.info(e)}warn(e){this.reporter.warn(e)}error(e){this.reporter.error(e)}success(e){this.reporter.success(e)}step(e){this.reporter.step(e)}note(e,t){this.reporter.note(e,t)}log(e){this.reporter.log(e)}spinner(){return this.reporter.spinner()}json(e){this.reporter.json(e)}get stdio(){return this.options.isJson?[process.stdin,process.stderr,process.stderr]:`inherit`}interactiveStdout(e){!this.options.isJson||this.options.isYes||(e?process.stdout.write=process.stderr.write.bind(process.stderr):process.stdout.write=this.originalStdoutWrite)}cancel(e,t=`cli`){this.reporter.cancel(e,t)}fatal(e,t,n=`cli`){this.reporter.fatal(e,t,n)}refuse(e,t=`init`){this.reporter.refuse(e,t)}finish(e,t,n=`init`){this.reporter.finish(e,t,n)}reportCompleted(e){this.reporter.reportCompleted(e)}reportErrored(e){this.reporter.reportErrored(e)}async flush(){await this.reporter.flush()}};function Pt(e,t){return Object.keys(e).includes(t)}function Ft(e){if(typeof e==`string`)return/=\s*\S/.test(e);if(!e||typeof e!=`object`)return!1;let t=e;if(Pt(t,`default`)||Pt(t,`fallback`))return!0;let n=t._def;if(n&&typeof n==`object`){let e=n;if(`defaultValue`in e||e.typeName===`ZodDefault`||e.type===`default`)return!0;if(`innerType`in e)return Ft(e.innerType)}return!1}function It(e){return e.endsWith(`?`)?e.slice(0,-1):e}function Lt(e,t,n){if(e){if(Array.isArray(e)){for(let r of e){if(Array.isArray(r)&&typeof r[0]==`string`){t.push({name:r[0],schema:r[1],hasDefault:!1}),n[r[0]]=r[1];continue}if(r&&typeof r==`object`){let e=r,i=e.key;if(typeof i!=`string`)continue;let a=`value`in e?e.value:void 0;t.push({name:i,schema:a,hasDefault:Pt(e,`default`)}),n[i]=a}}return}if(typeof e==`object`)for(let[r,i]of Object.entries(e)){let e=i&&typeof i==`object`?i:void 0,a=e&&`value`in e?e.value:i;t.push({name:r,schema:a,hasDefault:!!(e&&Pt(e,`default`))}),n[r]=a}}}function Rt(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&Object.keys(e).length===0}function zt(t){let n=[],r={};for(let i of t){if(!i||typeof i!=`object`&&typeof i!=`function`)return{extractable:!1};let t=i,a=t.json,o=typeof a==`function`?a():a,s=n.length;if(o&&typeof o==`object`){let e=o;if((e.domain===`object`||e.required!==void 0||e.optional!==void 0)&&(Lt(e.required,n,r),Lt(e.optional,n,r),n.length>s))continue}let c=o?e(i):[];if(n.length===s&&c.length>0){for(let e of c)n.push({name:e,schema:void 0,hasDefault:!1}),r[e]=void 0;continue}if(!(n.length>s)){if(typeof i==`function`)return{extractable:!1};if(!Rt(i)){if(Object.keys(t).length===0)return{extractable:!1};for(let[e,i]of Object.entries(t)){let t=It(e);n.push({name:t,schema:i,hasDefault:Ft(i)}),r[t]=i}}}}return{extractable:!0,keys:n,schema:r}}async function Bt(e,t,n,r){if(r){let n=v.resolve(e,r);return await t.exists(n)?n:void 0}if(typeof n.readArkenvConfig==`function`){let r=await n.readArkenvConfig(e);if(r){let n=v.resolve(e,r.schema);if(await t.exists(n))return n}}let i=[v.resolve(e,`env.ts`),v.resolve(e,`src/env.ts`),v.resolve(e,`env.js`),v.resolve(e,`src/env.js`),v.resolve(e,`env.mjs`),v.resolve(e,`src/env.mjs`),v.resolve(e,`env/server.ts`),v.resolve(e,`src/env/server.ts`)],a=await n.suggestDefaultEnvPath(e);a&&i.unshift(v.resolve(e,a));for(let e of i)if(await t.exists(e))return e}const K={ERR_INSPECT_NO_CALL:`ERR_INSPECT_NO_CALL`,ERR_INSPECT_UNSUPPORTED:`ERR_INSPECT_UNSUPPORTED`,ERR_INSPECT_UNEXTRACTABLE:`ERR_INSPECT_UNEXTRACTABLE`,ERR_INSPECT_EVAL_THROW:`ERR_INSPECT_EVAL_THROW`};function Vt(e){if(e&&typeof e==`object`&&`name`in e&&e.name===`ArkEnvError`)return!0;let t=e instanceof Error?e.message:String(e);return/validating environment variables/i.test(t)}function Ht(e){if(!(e instanceof Error)&&typeof e!=`object`)return/cannot read propert/i.test(String(e));let t=e instanceof Error?e.message:String(e);return/cannot read propert/i.test(t)||e instanceof TypeError||/is not a function/i.test(t)}function Ut(e){return`No arkenv() schema definition was found in "${e}". No arkenv() definition was found. Ensure arkenv() is called at the top level of the schema module.`}function Wt(e,t){return`Failed to inspect schema module at "${e}": ${t instanceof Error?t.message:String(t)} Upgrade @arkenv/core or @arkenv/standard so the CLI can inspect the schema without validating the environment.`}function Gt(e){return`Failed to inspect schema module at "${e}": Cannot extract keys from the captured definition. Ensure the schema is a supported static map.`}function Kt(e,t){let n=t instanceof Error?t.message:String(t),r=`Failed to load schema module at "${e}": ${n}`;return Ht(t)||/missing [A-Z_][A-Z0-9_]*/.test(n)?`${r} Capture mode does not populate env values. Keep the schema module declarative (\`export const env = arkenv({...})\`) and do not read \`env\` at module scope.`:r}var qt=class{constructor(e={}){this.options=e}async load(e){s();try{this.evaluateModule(e.schemaPath);let t=i();if(t.length===0)return{ok:!1,code:K.ERR_INSPECT_NO_CALL,message:Ut(e.schemaPath)};let n=zt(t);return n.extractable?{ok:!0,keys:n.keys,schema:n.schema}:{ok:!1,code:K.ERR_INSPECT_UNEXTRACTABLE,message:Gt(e.schemaPath)}}catch(t){return i(),Vt(t)?{ok:!1,code:K.ERR_INSPECT_UNSUPPORTED,message:Wt(e.schemaPath,t),cause:t}:{ok:!1,code:K.ERR_INSPECT_EVAL_THROW,message:Kt(e.schemaPath,t),cause:t}}}async validate(e,t){let n={...process.env};for(let e of Object.keys(process.env))(!(e in t)||t[e]===void 0)&&delete process.env[e];for(let[e,n]of Object.entries(t))n!==void 0&&(process.env[e]=n);try{return this.evaluateModule(e.schemaPath),{ok:!0}}catch(t){if(Vt(t)){let e=t&&typeof t==`object`&&`issues`in t?t.issues??[]:[];return{ok:!1,kind:`validation`,message:t instanceof Error?t.message:String(t),issues:e}}return{ok:!1,kind:`load`,code:K.ERR_INSPECT_EVAL_THROW,message:Kt(e.schemaPath,t),cause:t}}finally{for(let e of Object.keys(process.env))e in n||delete process.env[e];for(let[e,t]of Object.entries(n))t!==void 0&&(process.env[e]=t)}}evaluateModule(e){let t={moduleCache:!1,fsCache:!1,tsconfigPaths:!0,...this.options.jitiAliases?{alias:this.options.jitiAliases}:{}};try{y(e,t)(e)}catch(n){let r=n instanceof Error?n.message:String(n);if(!(n instanceof Error&&/tsconfig/i.test(r)&&(/not found/i.test(r)||n.code===`ENOENT`)))throw n;y(e,{...t,tsconfigPaths:!1})(e)}}};async function Jt(e,t){for(let n of t)try{return await S.access(v.join(e,n)),!0}catch{}return!1}async function Yt(e=process.cwd(),t){if(t?.compilerOptions?.types){let e=t.compilerOptions.types;if(e.includes(`vite`)||e.includes(`vite/client`))return`vite`}try{let t=v.join(e,`package.json`),n=await S.readFile(t,`utf-8`),r=JSON.parse(n),i={...r.dependencies,...r.devDependencies};if(i[`@tanstack/react-start`]||i[`@tanstack/start`]||i.vite)return`vite`;if(i.next)return`nextjs`;if(i.nuxt)return`nuxt`}catch{}return await Jt(e,[`vite.config.ts`,`vite.config.js`])?`vite`:await Jt(e,[`next.config.ts`,`next.config.js`,`next.config.mjs`,`next.config.cjs`])?`nextjs`:await Jt(e,[`nuxt.config.ts`,`nuxt.config.js`,`nuxt.config.mts`,`nuxt.config.mjs`,`nuxt.config.cjs`])?`nuxt`:(await Xt(e,t)).length>0?`bun-fullstack`:`vanilla`}async function Xt(e=process.cwd(),t){let n=[];try{let t=v.join(e,`bunfig.toml`),r=await S.readFile(t,`utf-8`);(r.includes(`[serve]`)||r.includes(`[serve.static]`))&&n.push(`serve`),r.includes(`[build]`)&&n.push(`build`)}catch{}if(n.includes(`serve`)&&n.includes(`build`))return n;let{walk:r}=await Promise.resolve().then(()=>$t),i=await r(e),a=n.includes(`serve`),o=n.includes(`build`);for(let e of i)try{let t=await S.readFile(e,`utf-8`);if(!a&&(t.includes(`Bun.serve`)||t.includes(`serve(`))&&(/from\s+['"]bun['"]/.test(t)||t.includes(`Bun.serve`))&&(a=!0,n.push(`serve`)),!o&&(t.includes(`Bun.build`)||t.includes(`build(`))&&(/from\s+['"]bun['"]/.test(t)||t.includes(`Bun.build`))&&(o=!0,n.push(`build`)),a&&o)break}catch{}return n}async function Zt(e=process.cwd(),t){let n=process.env.npm_config_user_agent?.toString()||``;if(n.includes(`pnpm`))return`pnpm`;if(n.includes(`yarn`))return`yarn`;if(n.includes(`bun`))return`bun`;if(n.includes(`npm`))return`npm`;let r=t?.path?v.dirname(t.path):e;for(;r!==v.parse(r).root;){try{let e=v.join(r,`package.json`),t=await S.readFile(e,`utf-8`),n=JSON.parse(t);if(n.packageManager){if(n.packageManager.startsWith(`pnpm`))return`pnpm`;if(n.packageManager.startsWith(`yarn`))return`yarn`;if(n.packageManager.startsWith(`bun`))return`bun`}}catch{}let e=[];try{e=await S.readdir(r)}catch{}if(e.includes(`pnpm-lock.yaml`))return`pnpm`;if(e.includes(`yarn.lock`))return`yarn`;if(e.includes(`bun.lockb`))return`bun`;if(e.includes(`package-lock.json`))return`npm`;r=v.dirname(r)}return`npm`}async function Qt(e=process.cwd(),t){let n=t;if(!n){let{findTsConfig:t,loadTsConfig:r}=await Promise.resolve().then(()=>cn),i=await t(e);i&&(n=await r(i))}if(n?.compilerOptions?.rootDir){let t=n.compilerOptions.rootDir,r=v.relative(e,t);return r&&r!==`.`&&!r.startsWith(`..`)&&!v.isAbsolute(r)?`./${r}/env.ts`:`./env.ts`}try{return await S.access(v.join(e,`src`)),`./src/env.ts`}catch{return`./env.ts`}}var $t=de({getEnvExampleKeys:()=>an,parseEnvExample:()=>tn,resolveImportPaths:()=>nn,scanProjectEnvKeys:()=>rn,walk:()=>en});async function en(e,t=[]){try{let n=await S.readdir(e,{withFileTypes:!0});for(let r of n)if(r.isDirectory()){let n=r.name;if(n===`node_modules`||n===`dist`||n===`build`||n===`.git`||n===`.turbo`||n===`scratch`)continue;await en(v.join(e,n),t)}else r.isFile()&&/\.(ts|tsx|js|jsx)$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(v.join(e,r.name))}catch{}return t}function tn(e){let t=[],n=e.split(/\r?\n/);for(let e of n){let n=e.trim();if(!n||n.startsWith(`#`))continue;let r=n.match(/^([A-Z_][A-Z0-9_]*)\s*=/i);r?.[1]&&t.push(r[1])}return Array.from(new Set(t))}function nn(e,t,n){if(e.startsWith(`.`))return[v.resolve(v.dirname(n),e)];if(v.isAbsolute(e))return[e];let r=t.compilerOptions||{},i=r.baseUrl||v.dirname(t.path),a=r.paths||{},o=[];for(let[e,t]of Object.entries(a)){let n=e.endsWith(`*`),r=e.replace(/\*$/,``);o.push({cleanPattern:r,targets:Array.isArray(t)?t:[t],hadStar:n})}o.sort((e,t)=>t.cleanPattern.length-e.cleanPattern.length);for(let{cleanPattern:t,targets:n,hadStar:r}of o)if(r&&e.startsWith(t)||!r&&e===t){let r=e.slice(t.length);return n.map(e=>{let t=`${e.replace(/\*$/,``)}${r}`;return v.resolve(i,t)})}return r.baseUrl?[v.resolve(i,e)]:[]}async function rn(e,t,n){let r=[],i=await en(e),a=n?n.replace(/\.(ts|js|tsx|jsx)$/,``):null;for(let e of i)try{let n=await S.readFile(e,`utf-8`),i=n.matchAll(/process\.env\.([A-Z_][A-Z0-9_]*)/g);for(let e of i)e[1]&&r.push(e[1]);let o=n.matchAll(/import\.meta\.env\.([A-Z_][A-Z0-9_]*)/g);for(let e of o)e[1]&&r.push(e[1]);if(a){let i=n.matchAll(/import\s+[^;]*from\s+['"]([^'"]+)['"]/g);for(let o of i){let i=o[1],s=[];if(t?s=nn(i,t,e):i.startsWith(`.`)&&(s=[v.resolve(v.dirname(e),i)]),s.some(e=>e.replace(/\.(ts|js|tsx|jsx)$/,``)===a)){let e=n.matchAll(/\benv\.([A-Z_][A-Z0-9_]*)/g);for(let t of e)t[1]&&r.push(t[1])}}}}catch{}return Array.from(new Set(r))}async function an(e=process.cwd(),t,n){let r=v.join(e,`.env.example`);try{let e=tn(await S.readFile(r,`utf-8`));if(e.length>0)return{keys:e,source:`.env.example`}}catch{}let i=await rn(e,t,n);return i.length>0?{keys:i,source:`project`}:null}function on(e){let t=e.trim().replace(/^v/,``),n=t.match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+([0-9A-Za-z.-]+))?$/);if(!n){let e=t.match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-([0-9A-Za-z.-]+))?(?:\+([0-9A-Za-z.-]+))?$/);if(!e)return null;let n=Number.parseInt(e[1],10),r=e[2]===void 0?0:Number.parseInt(e[2],10),i=e[3]===void 0?0:Number.parseInt(e[3],10),a=e[4],o=e[5];return Number.isNaN(n)||Number.isNaN(r)||Number.isNaN(i)?null:{major:n,minor:r,patch:i,prerelease:a?a.split(`.`).map(e=>/^\d+$/.test(e)?Number.parseInt(e,10):e):[],build:o}}let r=Number.parseInt(n[1],10),i=Number.parseInt(n[2],10),a=Number.parseInt(n[3],10),o=n[4],s=n[5];return Number.isNaN(r)||Number.isNaN(i)||Number.isNaN(a)?null:{major:r,minor:i,patch:a,prerelease:o?o.split(`.`).map(e=>/^\d+$/.test(e)?Number.parseInt(e,10):e):[],build:s}}function sn(e,t){let n=on(e),r=on(t);if(!n||!r)return 0;if(n.major!==r.major)return n.major>r.major?1:-1;if(n.minor!==r.minor)return n.minor>r.minor?1:-1;if(n.patch!==r.patch)return n.patch>r.patch?1:-1;let i=n.prerelease.length>0,a=r.prerelease.length>0;if(!i&&a)return 1;if(i&&!a)return-1;if(!i&&!a)return 0;let o=Math.min(n.prerelease.length,r.prerelease.length);for(let e=0;e<o;e++){let t=n.prerelease[e],i=r.prerelease[e];if(t===i)continue;let a=typeof t==`number`,o=typeof i==`number`;return a&&!o?-1:!a&&o?1:a&&o?t>i?1:-1:t<i?-1:1}return n.prerelease.length===r.prerelease.length?0:n.prerelease.length>r.prerelease.length?1:-1}var cn=de({checkTsConfig:()=>fn,findTsConfig:()=>un,loadTsConfig:()=>dn});const ln=c(import.meta.url).resolve;async function un(e=process.cwd()){let t=[`tsconfig.app.json`,`tsconfig.json`,`tsconfig.base.json`,`tsconfig.node.json`],n=e;for(;n!==v.parse(n).root;){for(let e of t){let t=v.join(n,e);try{return await S.access(t),t}catch{}}n=v.dirname(n)}return null}async function dn(e,t=new Set){let n=v.resolve(e);if(t.has(n))throw Error(`Circular extends dependency detected in tsconfig.json: ${n}`);t.add(n);let r=``;try{r=await S.readFile(e,`utf-8`)}catch{return{path:e,compilerOptions:{}}}let i=w(r)||{},a=i.compilerOptions||{},o={};if(i.extends){let n=Array.isArray(i.extends)?i.extends:[i.extends];for(let r of n){let n;if(r.startsWith(`.`)||v.isAbsolute(r))n=v.resolve(v.dirname(e),r);else try{n=ln(r,{paths:[v.dirname(e)]})}catch{n=v.resolve(v.dirname(e),`node_modules`,r)}let i={...(await dn(n,t)).compilerOptions};i.baseUrl&&=v.resolve(v.dirname(n),i.baseUrl),i.rootDir&&=v.resolve(v.dirname(n),i.rootDir),o={...o,...i}}}let s={...a};return s.baseUrl&&=v.resolve(v.dirname(e),s.baseUrl),s.rootDir&&=v.resolve(v.dirname(e),s.rootDir),o={...o,...s},{...i,path:e,compilerOptions:o}}async function fn(e=process.cwd()){let t=await un(e);if(!t)return{status:`not_found`};let n=v.basename(t);try{let e=await dn(t);return e?.compilerOptions?.strict===!0?{status:`strict`,file:n,parsed:e}:{status:`not_strict`,file:n,parsed:e}}catch{return{status:`not_found`}}}function pn(e){let t=e.trim().match(/^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?/);return t?[t[1],t[2]??`0`,t[3]??`0`].join(`.`):null}function mn(e,t){let n=e.trim(),r=n.match(/^[\^~]?\s*(v?\d+(?:\.\d+){0,2})$/);if(r){let e=pn(r[1]);return e!==null&&sn(e,t)>=0}let i=n.match(/(?:>=|>|<=|<|=)\s*v?\d+(?:\.\d+){0,2}/g);return!i||i.join(` `)!==n.replace(/\s+/g,` `)?!1:i.some(e=>{let n=e.match(/^(>=|>|<=|<|=)\s*(v?\d+(?:\.\d+){0,2})$/);if(!n)return!1;let[,r,i]=n,a=pn(i);return a&&(r===`>=`||r===`>`||r===`=`)?sn(a,t)>=0:!1})}async function hn(e=process.cwd()){let t=[],n=process.version,r=`22.0.0`;sn(n,r)===-1?t.push({status:`fail`,requirement:`Node.js Version`,message:`Node.js version must be >= ${r}.`,current:n,expected:`>= ${r}`}):t.push({status:`pass`,requirement:`Node.js Version`,message:`Node.js version is compatible.`});let i=null;try{let n=v.join(e,`package.json`),r=await S.readFile(n,`utf-8`);i=JSON.parse(r),t.push({status:`pass`,requirement:`package.json`,message:`package.json found.`})}catch{t.push({status:`warn`,requirement:`package.json`,message:`package.json not found in the current directory.`})}if(i){let e={...i.dependencies,...i.devDependencies}.typescript,n=`5.1.0`;e?mn(e,n)?t.push({status:`pass`,requirement:`TypeScript Version`,message:`TypeScript version is compatible.`}):t.push({status:`fail`,requirement:`TypeScript Version`,message:`TypeScript version should be >= ${n}.`,current:e,expected:`>= ${n}`}):t.push({status:`warn`,requirement:`TypeScript Version`,message:`TypeScript not found in package.json dependencies.`})}let a=await fn(e);if(a.status===`not_found`)t.push({status:`warn`,requirement:`tsconfig.json`,message:`tsconfig.json not found.`});else{let e=a.parsed.compilerOptions||{};e.strict===!0?t.push({status:`pass`,requirement:`TypeScript Strict Mode`,message:`Strict mode is enabled.`}):t.push({status:`fail`,requirement:`TypeScript Strict Mode`,message:`Strict mode must be enabled.`,current:`false`,expected:`true`});let n=e.moduleResolution?.toLowerCase(),r=e.module?.toLowerCase();[`bundler`,`node16`,`nodenext`].includes(n||``)||!n&&(r===`node16`||r===`nodenext`)?t.push({status:`pass`,requirement:`TypeScript moduleResolution`,message:`moduleResolution is set to ${n||`implicit`}.`}):t.push({status:`fail`,requirement:`TypeScript moduleResolution`,message:`moduleResolution must be set to 'bundler', 'node16', or 'nodenext'.`,current:n||`default`,expected:`bundler, node16, or nodenext`})}return t}var gn=class{constructor(e){this.logger=e}async isEmptyDirectory(e=process.cwd()){try{return(await S.readdir(e)).length===0}catch{return!1}}async hasPackageJson(e=process.cwd()){try{return await S.access(v.join(e,`package.json`)),!0}catch{return!1}}async findTsConfig(e=process.cwd()){return un(e)}async loadTsConfig(e,t=new Set){return dn(e,t)}async getEnvExampleKeys(e=process.cwd(),t,n){return an(e,t,n)}async suggestDefaultEnvPath(e=process.cwd(),t){return Qt(e,t)}async checkTsConfig(e=process.cwd()){return fn(e)}async checkRequirements(e=process.cwd()){return hn(e)}async detectFramework(e=process.cwd(),t){return Yt(e,t)}async detectBunFeatures(e=process.cwd(),t){return Xt(e,t)}async detectPackageManager(e=process.cwd(),t){return Zt(e,t)}async hasSkill(e=process.cwd()){try{let t=v.join(e,`skills-lock.json`),n=await S.readFile(t,`utf-8`),r=JSON.parse(n);if(r&&typeof r==`object`&&r.skills&&typeof r.skills==`object`&&`arkenv`in r.skills)return!0}catch{}for(let t of[`skills/arkenv/SKILL.md`,`.agent/skills/arkenv/SKILL.md`,`.agents/skills/arkenv/SKILL.md`])try{return await S.access(v.join(e,t)),!0}catch{}return!1}async checkGitStatus(e=process.cwd()){try{return b(`git status --porcelain`,{cwd:e,encoding:`utf-8`}).trim().length===0?{status:`clean`}:{status:`dirty`}}catch(e){let t=e;return t.code===`ENOENT`?(this.logger?.log(`Git is not installed on this system. Skipping git status check.`),{status:`not_a_repo`}):typeof t.stderr==`string`&&t.stderr.includes(`not a git repository`)?{status:`not_a_repo`}:{status:`unknown`}}}async findPackageJson(e=process.cwd()){let t=v.resolve(e);for(;;){let e=v.join(t,`package.json`);try{return await S.access(e),e}catch{let e=v.dirname(t);if(e===t)return null;t=e}}}async readArkenvConfig(e=process.cwd()){let t=await this.findPackageJson(e);if(!t)return null;try{let e=await S.readFile(t,`utf-8`),n=JSON.parse(e);return n.arkenv?typeof n.arkenv==`string`?{schema:n.arkenv}:typeof n.arkenv==`object`&&typeof n.arkenv.schema==`string`?{schema:n.arkenv.schema}:null:null}catch{return null}}};const q=e=>k.default.cyan(e),_n=k.default.blue(`⛯`);function vn(e){return e.replace(/import\s*\{([^\n}]*)\}\s*from/g,(e,t)=>`import { ${t.trim()} } from`)}function yn(e,t){return t.endsWith(`
|
|
68
|
+
`)&&!e.endsWith(`
|
|
69
|
+
`)?`${e}\n`:e}function bn(e){try{let t=O(e.code),n=e.code,r=t.exports.default;if(r&&typeof r==`object`&&`$type`in r&&r.$type===`function-call`){let e=r;if((e.$callee||JSON.stringify(r))===`defineConfig`){let t=e.$ast?.arguments?.[0];if(t?.type===`ArrowFunctionExpression`||t?.type===`FunctionExpression`)return{success:!1,updated:!1,error:`The 'defineConfig' callback form is currently not supported for automatic mutation. Please add the plugin manually.`};let n=e.$args?.[0];if(n&&typeof n==`object`&&`$type`in n&&(n.$type===`arrow-function-expression`||n.$type===`function-expression`))return{success:!1,updated:!1,error:`The 'defineConfig' callback form is currently not supported for automatic mutation. Please add the plugin manually.`};r=n}}if(!r||typeof r!=`object`||typeof r==`object`&&`$type`in r)return{success:!1,updated:!1,error:`Could not find default export object in Vite config`};if(r.plugins||=[],Array.isArray(r.plugins))if(!/\barkenv(?:Vite)?Plugin\b/.test(n))t.imports.$add({from:`@arkenv/vite-plugin`,local:`arkenvVitePlugin`,imported:`default`}),r.plugins.push(`__ARK_PLUGIN_PLACEHOLDER__`);else return{success:!0,updated:!1};else return{success:!1,updated:!1,error:`The 'plugins' property in your Vite config is not an array.`};let i=te(t,{format:D(n)}).code;return i=i.replace(/['"]__ARK_PLUGIN_PLACEHOLDER__['"]/g,`arkenvVitePlugin()`),i=vn(i),i=yn(i,n),{success:!0,updated:!0,code:i}}catch(e){return{success:!1,updated:!1,error:`Failed to parse Vite config: ${e instanceof Error?e.message:String(e)}`}}}function xn(e){try{let t=e.code;if(/module\.exports\b/.test(t))return{success:!1,updated:!1,error:"CommonJS is not supported for automatic mutation. Please wrap your config with `withArkEnv` manually."};let n=O(t);if(!n.exports.default)return{success:!1,updated:!1,error:`Could not find default export in Next.js config`};if(typeof n.exports.default==`object`&&`$type`in n.exports.default&&n.exports.default.$type===`function-call`&&n.exports.default.$callee===`withArkEnv`||/\bwithArkEnv\b/.test(t))return{success:!0,updated:!1};n.imports.$add({from:`@arkenv/nextjs/config`,imported:`withArkEnv`}),e.disableCodegen?n.exports.default=E.functionCall(`withArkEnv`,n.exports.default,{codegen:!1}):n.exports.default=E.functionCall(`withArkEnv`,n.exports.default);let r=te(n,{format:D(t)}).code;return r=vn(r),r=yn(r,t),{success:!0,updated:!0,code:r}}catch(e){return{success:!1,updated:!1,error:`Failed to parse Next.js config: ${e instanceof Error?e.message:String(e)}`}}}function Sn(e){try{let t=e.code,n=O(t),r=n.exports.default;if(r&&typeof r==`object`&&`$type`in r&&r.$type===`function-call`){let e=r;(e.$callee||JSON.stringify(r))===`defineNuxtConfig`&&e.$args&&(r=e.$args[0])}if(!r||typeof r!=`object`||typeof r==`object`&&`$type`in r)return{success:!1,updated:!1,error:`Could not find default export object in Nuxt config`};if(r.modules||=[],Array.isArray(r.modules))if(!r.modules.includes(`@arkenv/nuxt/module`))r.modules.push(`@arkenv/nuxt/module`);else return{success:!0,updated:!1};else return{success:!1,updated:!1,error:`The 'modules' property in your Nuxt config is not an array.`};let i=te(n,{format:D(t)}).code;return i=vn(i),i=yn(i,t),{success:!0,updated:!0,code:i}}catch(e){return{success:!1,updated:!1,error:`Failed to parse Nuxt config: ${e instanceof Error?e.message:String(e)}`}}}async function Cn(e=process.cwd()){for(let t of[`vite.config.ts`,`vite.config.js`,`vite.config.mts`,`vite.config.mjs`]){let n=v.resolve(e,t);try{return await S.access(n),n}catch{}}return null}async function wn(e=process.cwd()){for(let t of[`bunfig.toml`,`bun.setup.ts`,`bun.setup.js`]){let n=v.resolve(e,t);try{return await S.access(n),n}catch{}}return null}async function Tn(e=process.cwd()){for(let t of[`next.config.ts`,`next.config.js`,`next.config.mts`,`next.config.mjs`]){let n=v.resolve(e,t);try{return await S.access(n),n}catch{}}return null}async function En(e,t,n){try{let r=xn({code:await e.readFile(t),disableCodegen:n});return r.success&&r.updated&&r.code&&await e.writeFile(t,r.code),r.success?r.updated===void 0?{success:!0}:{success:!0,updated:r.updated}:{success:!1,error:r.error}}catch(e){return{success:!1,error:e instanceof Error?e.message:String(e)}}}async function Dn(e=process.cwd()){for(let t of[`nuxt.config.ts`,`nuxt.config.js`,`nuxt.config.mts`,`nuxt.config.mjs`,`nuxt.config.cjs`]){let n=v.resolve(e,t);try{return await S.access(n),n}catch{}}return null}async function On(e,t){try{let n=Sn({code:await e.readFile(t)});return n.success&&n.updated&&n.code&&await e.writeFile(t,n.code),n.success?n.updated===void 0?{success:!0}:{success:!0,updated:n.updated}:{success:!1,error:n.error}}catch(e){return{success:!1,error:e instanceof Error?e.message:String(e)}}}async function kn(e,t,n){try{let n=bn({code:await e.readFile(t)});return n.success&&n.updated&&n.code&&await e.writeFile(t,n.code),n.success?n.updated===void 0?{success:!0}:{success:!0,updated:n.updated}:{success:!1,error:n.error}}catch(e){return{success:!1,error:e instanceof Error?e.message:String(e)}}}async function An(e,t){if(!t||t.length===0)return{success:!0,instructions:T`
|
|
70
|
+
${k.default.green(`✔`)} Use ${k.default.bold(`Vanilla`)} Bun runtime integration.
|
|
71
|
+
Access validated variables via your ${q(`env`)} object for typesafety.
|
|
72
|
+
Primarily used for ${k.default.cyan(`server-side`)} or runtime-only validation.
|
|
73
|
+
No plugins are required.
|
|
74
|
+
`};let n=t.includes(`serve`),r=t.includes(`build`),i=``;return n&&(i+=T`
|
|
75
|
+
${k.default.bold(`Bun Fullstack (Bun.serve) Integration:`)}
|
|
76
|
+
To inline environment variables (e.g. ${q(`PUBLIC_*`)}) in your ${k.default.cyan(`client-side`)} code, add the plugin to ${q(`bunfig.toml`)}:
|
|
77
|
+
|
|
78
|
+
[serve.static]
|
|
79
|
+
plugins = ["@arkenv/bun-plugin"]
|
|
80
|
+
|
|
81
|
+
`),r&&(i&&(i+=`
|
|
82
|
+
`),i+=T`
|
|
83
|
+
${k.default.bold(`Bun Fullstack programmatic bundling (Bun.build):`)}
|
|
84
|
+
To inline environment variables (e.g. ${q(`PUBLIC_*`)}) in your custom ${k.default.cyan(`client-side`)} build script, add the plugin to your ${q(`Bun.build`)} call:
|
|
85
|
+
|
|
86
|
+
${q(`import arkenvPlugin from "@arkenv/bun-plugin";`)}
|
|
87
|
+
|
|
88
|
+
await Bun.build({
|
|
89
|
+
entrypoints: ["./index.ts"],
|
|
90
|
+
outdir: "./dist",
|
|
91
|
+
${k.default.green(`plugins: [arkenvPlugin]`)}
|
|
92
|
+
});
|
|
93
|
+
`),{success:!0,instructions:i.trim()}}async function jn(e,t){let n=t||await un();if(!n)return{status:`not_found`};let r=v.basename(n);try{let t=await e.readFile(n);if(w(t)?.compilerOptions?.strict===!0)return{status:`already_strict`,file:r};let i=C(t,ee(t,[`compilerOptions`,`strict`],!0,{formattingOptions:{insertSpaces:!0,tabSize:2}}));return await e.writeFile(n,i),{status:`updated`,file:r}}catch{return{status:`error`,file:r}}}const Mn=`@/.arkenv`,Nn=[`./.arkenv/index.ts`],Pn=`.arkenv/**/*.ts`,Fn={insertSpaces:!0,tabSize:2};async function In(e,t){let n=t||await un();if(!n)return{status:`not_found`};let r=v.basename(n);try{let t=await e.readFile(n),i=w(t),a=!1,o=i?.compilerOptions?.paths?.[Mn];if(!o||o[0]!==Nn[0]){let e=ee(t,[`compilerOptions`,`paths`,Mn],Nn,{formattingOptions:Fn});t=C(t,e),a=!0}let s=Array.isArray(i?.include)?i.include:[];if(!s.includes(Pn)){let e=ee(t,[`include`],[...s,Pn],{formattingOptions:Fn});t=C(t,e),a=!0}return a?(await e.writeFile(n,t),{status:`updated`,file:r}):{status:`already_configured`,file:r}}catch{return{status:`error`,file:r}}}var Ln=class{constructor(e,t,n){this.isQuiet=e,this.stdio=t,this.logger=n}async exists(e){try{return await S.access(e),!0}catch{return!1}}async readFile(e){return S.readFile(e,`utf-8`)}async writeFile(e,t){await S.writeFile(e,t,`utf-8`)}async mkdir(e,t){await S.mkdir(e,{recursive:t})}async execute(e,t=[],n){return new Promise((r,i)=>{let a=x(e,t,{cwd:n,stdio:this.isQuiet?`pipe`:this.stdio,shell:!1}),o=``,s=``,c=1e4;this.isQuiet&&(a.stdout?.on(`data`,e=>{o=(o+e.toString()).slice(-c)}),a.stderr?.on(`data`,e=>{s=(s+e.toString()).slice(-c)})),a.on(`close`,(e,t)=>{if(e===0)r();else{let n=e===null?`Command terminated by signal ${t}`:`Command failed with code ${e}`;this.isQuiet&&(o&&(n+=`\n${k.default.dim(`STDOUT:`)}\n${o}`),s&&(n+=`\n${k.default.red(`STDERR:`)}\n${s}`)),i(Error(n))}}),a.on(`error`,i)})}async updateTsConfigToStrict(e){return jn(this,e)}async ensureNextjsArkEnvTsConfig(e){return In(this,e)}async findViteConfig(e){return Cn(e)}async findBunConfig(e){return wn(e)}async findNextjsConfig(e){return Tn(e)}async findNuxtConfig(e){return Dn(e)}async bootstrapViteConfig(e,t){return kn(this,e,t)}async bootstrapBunConfig(e,t){return An(e,t)}async bootstrapNextjsConfig(e,t){return En(this,e,t)}async bootstrapNuxtConfig(e){return On(this,e)}async appendMissingEnvExampleKeys(e,t){let n=v.join(e,`.env.example`);if(!await this.exists(n))return!1;let r=await this.readFile(n),i=new Set;for(let e of r.split(/\r?\n/)){let t=e.match(/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=/);t&&i.add(t[1])}let a=t.filter(e=>!i.has(e));if(a.length===0)return!1;let o=a.map(e=>`${e}=`).join(`
|
|
94
|
+
`)+`
|
|
95
|
+
`,s=r.endsWith(`
|
|
96
|
+
`)||r.length===0?`${r}${o}`:`${r}\n${o}`;return await this.writeFile(n,s),!0}async removeEnvExampleKeys(e,t,n=[]){let r=v.join(e,`.env.example`);if(!await this.exists(r))return!1;let i=new Set(t.filter(e=>!n.includes(e)));if(i.size===0)return!1;let a=await this.readFile(r),o=a.split(/\r?\n/).filter(e=>{let t=e.match(/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=/);return!(t&&i.has(t[1]))}).join(`
|
|
97
|
+
`);return a.endsWith(`
|
|
98
|
+
`)&&!o.endsWith(`
|
|
99
|
+
`)&&(o+=`
|
|
100
|
+
`),o===a?!1:(await this.writeFile(r,o),!0)}};async function Rn(e){let t=e.defaultPath||`./src/env.ts`;if(e.hasEnvSchemaFile){let e=await H({message:k.default.yellow(`An existing ArkEnv configuration was found at ${q(t)}. Do you want to overwrite it?`),initialValue:!1,active:`Yes (override my configuration)`,inactive:`No (abort)`});return L(e)||!e?null:e}return!0}async function zn(e){let t=e.detectedKeys,n=e.keysSource||`.env.example`;if(t&&t.length>0){let e=t.length,r=e===1,i=await H({message:n===`.env.example`?`Detected ${q(`.env.example`)} with ${e} ${r?`key`:`keys`}. Use ${r?`it`:`them`} for your schema?`:`Detected ${e} environment variable${r?``:`s`} used in your project. Use ${r?`it`:`them`} for your schema?`,active:`Yes (Recommended)`,initialValue:!0});return L(i)?null:i}return!1}async function Bn(e){let t=await W({message:`Select an example:`,options:e.examples.map(e=>({value:e.id,label:e.name,...e.description?{hint:e.description}:{}}))});return L(t)?null:t}async function Vn(e){let t=await W({message:`Select your framework or build tool:`,initialValue:e.framework,options:[{value:`vanilla`,label:`Vanilla${e.framework===`vanilla`?` (Detected)`:``}`,hint:`Node.js, Bun, server-side or runtime-only validation`},{value:`vite`,label:`Vite${e.framework===`vite`?` (Detected)`:``}`,hint:`Client-side and static inlining validation`},{value:`bun-fullstack`,label:`Bun fullstack dev server${e.framework===`bun-fullstack`?` (Detected)`:``}`,hint:`Client-side bundling and Bun.serve integration`},{value:`nextjs`,label:`Next.js${e.framework===`nextjs`?` (Detected)`:``}`,hint:`Next.js App or Pages Router with build and runtime validation`},{value:`nuxt`,label:`Nuxt${e.framework===`nuxt`?` (Detected)`:``}`,hint:`Nuxt with build and runtime validation`}]});return L(t)?null:t}async function Hn(e){let t=await H({message:`Optional: Would you also like to bootstrap a custom Bun.build script for programmatic bundling?`,initialValue:e.initialValue??!1});return L(t)?null:t}async function Un(){let e=await W({message:`Select your preferred validator library:`,options:[{value:`arktype`,label:`ArkType (Recommended)`,hint:`TypeScript's 1:1 validator, optimized from editor to runtime`},{value:`zod`,label:`Zod`,hint:`TypeScript-first schema validation with static type inference`},{value:`valibot`,label:`Valibot`,hint:`The modular and type safe schema library`}]});return L(e)?null:e}async function Wn(e){let t=await H({message:`Enable automated ${e.framework===`nuxt`?`Nuxt`:`Next.js`} code generation for environment variables?`,initialValue:e.initialValue??!0,active:`Yes (Recommended)`,inactive:`No`});return L(t)?null:t}const J={vercel:{label:`Vercel`,hint:`Add VERCEL, VERCEL_ENV, VERCEL_URL, etc.`,serverOnlyKeys:[`VERCEL`],clientExposedKeys:[`VERCEL_ENV`,`VERCEL_URL`],fields:{VERCEL:{type:`string`},VERCEL_ENV:{type:`enum`,values:[`production`,`preview`,`development`]},VERCEL_URL:{type:`string`}}},netlify:{label:`Netlify`,hint:`Add NETLIFY, CONTEXT, URL, DEPLOY_URL, etc.`,serverOnlyKeys:[`NETLIFY`,`DEPLOY_URL`],clientExposedKeys:[`CONTEXT`,`URL`],fields:{NETLIFY:{type:`string`},DEPLOY_URL:{type:`string`},CONTEXT:{type:`enum`,values:[`production`,`deploy-preview`,`branch-deploy`]},URL:{type:`string`}}},cloudflare:{label:`Cloudflare Pages/Workers`,hint:`Add CF_PAGES, CF_PAGES_COMMIT_SHA, CF_PAGES_BRANCH, CF_PAGES_URL, etc.`,serverOnlyKeys:[`CF_PAGES`,`CF_PAGES_COMMIT_SHA`],clientExposedKeys:[`CF_PAGES_BRANCH`,`CF_PAGES_URL`],fields:{CF_PAGES:{type:`string`},CF_PAGES_COMMIT_SHA:{type:`string`},CF_PAGES_BRANCH:{type:`string`},CF_PAGES_URL:{type:`string`}}},railway:{label:`Railway`,hint:`Add RAILWAY_ENVIRONMENT_NAME, RAILWAY_PUBLIC_DOMAIN, RAILWAY_GIT_COMMIT_SHA, etc.`,serverOnlyKeys:[`RAILWAY_ENVIRONMENT_NAME`,`RAILWAY_PUBLIC_DOMAIN`,`RAILWAY_SERVICE_NAME`,`RAILWAY_GIT_COMMIT_SHA`],clientExposedKeys:[],fields:{RAILWAY_ENVIRONMENT_NAME:{type:`string`},RAILWAY_PUBLIC_DOMAIN:{type:`string`},RAILWAY_SERVICE_NAME:{type:`string`},RAILWAY_GIT_COMMIT_SHA:{type:`string`}}},render:{label:`Render`,hint:`Add RENDER, RENDER_SERVICE_ID, RENDER_SERVICE_TYPE, RENDER_EXTERNAL_URL, etc.`,serverOnlyKeys:[`RENDER`,`RENDER_SERVICE_ID`,`RENDER_SERVICE_TYPE`,`RENDER_EXTERNAL_URL`],clientExposedKeys:[],fields:{RENDER:{type:`string`},RENDER_SERVICE_ID:{type:`string`},RENDER_SERVICE_TYPE:{type:`string`},RENDER_EXTERNAL_URL:{type:`string`}}},fly:{label:`Fly.io`,hint:`Add FLY_APP_NAME, FLY_REGION, FLY_ALLOC_ID, etc.`,serverOnlyKeys:[`FLY_APP_NAME`,`FLY_REGION`,`FLY_ALLOC_ID`],clientExposedKeys:[],fields:{FLY_APP_NAME:{type:`string`},FLY_REGION:{type:`string`},FLY_ALLOC_ID:{type:`string`}}}};function Gn(e){return e===`none`||Object.keys(J).includes(e)}function Kn(e,t){if(e===`none`)return[];let n=J[e],r=[...n.serverOnlyKeys,...n.clientExposedKeys];if(t)for(let e of n.clientExposedKeys)r.push(`${t}${e}`);return r}function qn(e,t,n){if(!n||n===`none`)return;let r=t&&e.startsWith(t)?e.slice(t.length):e,i=J[n].fields;return r in i?i[r]:void 0}function Jn(e,t,n){let r=Kn(t??`none`,n);if(!(!e?.length&&r.length===0))return Array.from(new Set([...e??[],...r]))}async function Yn(e){let t=[{value:`none`,label:`None`,hint:`Do not add any hosting-specific environment variables`},...Object.entries(J).map(([e,t])=>({value:e,label:t.label,hint:t.hint}))],n=await W({message:`Select a hosting provider preset (optional):`,initialValue:e?.initialValue??`none`,options:t});return L(n)?null:n}async function Xn(e){let t=await H({message:`Use default config path (${q(e.defaultEnvPath||`./src/env.ts`)})?`,initialValue:!0,active:`Yes (Recommended)`,inactive:`No, let me customize it`});return L(t)?null:t}async function Zn(e){let t=e.defaultEnvPath||`./src/env.ts`;if(!e.useDefaultPath){let e=await jt({message:`Where should we create the ArkEnv config?`,placeholder:t,initialValue:t,defaultValue:t});if(L(e))return null;let n=typeof e==`string`?e.trim():``;return n===``?t:n}return t}const Y={example:Bn,overwriteEnvSchemaFile:Rn,framework:Vn,bunBuild:Hn,nextjsCodegen:Wn,useDefaultPath:Xn,path:Zn,validator:Un,hostPreset:Yn,useEnvExample:zn};async function Qn(e,t=!1){return(e?.mode||`existing`)===`new`?$n(e,t):er(e,t)}async function $n(e,t=!1){let n=e?.examples||[],r=`arkenv-project`;try{let i;if(e?.name){let t=e.name.trim();i=t===`.`||t===`./`||v.resolve(process.cwd(),t)===process.cwd()?`.`:t}else if(t)i=r;else{let e=(X(await jt({message:`Project name:`,placeholder:r,defaultValue:r}))||r).trim();i=e===`.`||e===`./`||v.resolve(process.cwd(),e)===process.cwd()?`.`:e}let a=e?.example;!a&&!t?a=X(await Y.example({examples:n})):!a&&t&&(a=`basic`);let o=n.find(e=>e.id===a);if(!o){let e=n.map(e=>e.id).join(`, `);throw Error(`Unknown example ${a}. Available examples: ${e}`)}return{mode:`new`,example:o.id,name:i,path:`./src/env.ts`,validator:`arktype`,framework:o.framework,language:`ts`,installSkill:!1}}catch(e){if(e instanceof tr)return null;throw e}}async function er(e,t=!1){let n=e?.defaultEnvPath||`./src/env.ts`,r=e?.envKeys||null,i=e?.envKeysSource||`.env.example`;if(t){let t=e?.framework||`vanilla`;return l({mode:`existing`,path:n,validator:`arktype`,framework:t,bunFeatures:t===`bun-fullstack`?e?.bunFeatures??[`serve`]:void 0,language:`ts`,overwriteEnvSchemaFile:!0,installSkill:!1,envKeys:r??void 0,disableCodegen:e?.disableCodegen??!1,wrapNextjsConfig:t===`nextjs`?!0:void 0,hostPreset:e?.hostPreset||`none`})}try{let t=X(await Y.overwriteEnvSchemaFile({hasEnvSchemaFile:e?.hasEnvSchemaFile??!1,defaultPath:n})),a=X(await Y.framework({framework:e?.framework})),o;if(a===`bun-fullstack`){let t=!!e?.bunFeatures?.includes(`build`);o=X(await Y.bunBuild({initialValue:t}))}let s=e?.disableCodegen;a===`nuxt`?s=!0:a===`nextjs`&&s===void 0&&(s=!X(await Y.nextjsCodegen({initialValue:!0,framework:a})));let c;if(a===`nextjs`&&!s){let e=await H({message:`Would you like to wrap your Next.js config with ${q(`withArkEnv`)}?`,initialValue:!0,active:`Yes (Recommended)`,inactive:`No`});if(L(e))throw St(`Operation cancelled`),new tr;c=e}let u=X(await Y.useDefaultPath({defaultEnvPath:n})),d=X(await Y.path({useDefaultPath:u,defaultEnvPath:n})),f=X(await Y.validator()),p=e?.hostPreset===void 0?X(await Y.hostPreset({initialValue:e?.hostPreset})):e.hostPreset,m=X(await Y.useEnvExample({detectedKeys:r,keysSource:i}));return l({mode:`existing`,overwriteEnvSchemaFile:t,framework:a,path:d,validator:f,hostPreset:p,bunFeatures:a===`bun-fullstack`?o?[`serve`,`build`]:[`serve`]:void 0,language:`ts`,installSkill:!1,envKeys:m?r??void 0:void 0,disableCodegen:s,wrapNextjsConfig:c})}catch(e){if(e instanceof tr)return null;throw e}}var tr=class extends Error{constructor(){super(`Operation cancelled`)}};function X(e){if(e===null||L(e))throw St(`Operation cancelled`),new tr;return e}var nr=class{async confirm(e,t=!0,n,r){let i=await H(l({message:e,initialValue:t,active:n,inactive:r}));return L(i)?null:i}async runWizard(e,t=!1){return Qn(e,t)}async select(e,t,n){let r=await W({message:e,options:t,initialValue:n});return L(r)?null:r}};const Z={isYes:{long:`--yes`,short:`-y`,kind:`boolean`},isForce:{long:`--force`,short:`-f`,kind:`boolean`},isQuiet:{long:`--quiet`,short:`-q`,kind:`boolean`},isJson:{long:`--json`,short:`-j`,kind:`boolean`},isAgent:{long:`--agent`,short:``,kind:`boolean`},helpRequested:{long:`--help`,short:`-h`,kind:`boolean`},example:{long:`--example`,short:``,kind:`value`},noCodegen:{long:`--no-codegen`,short:``,kind:`boolean`},preset:{long:`--preset`,short:`-P`,kind:`value`},hostPreset:{long:`--host-preset`,short:`-H`,kind:`value`},schema:{long:`--schema`,short:`-s`,kind:`value`},envFile:{long:`--env-file`,short:``,kind:`value`},verifyExample:{long:`--verify-example`,short:``,kind:`optional-value`}},rr=new Set(Object.values(Z).flatMap(e=>[e.long,e.short].filter(Boolean))),ir=new Set(Object.values(Z).filter(e=>e.kind===`value`).flatMap(e=>[e.long,e.short].filter(Boolean)));var ar=class{constructor(e,t={}){let n=e.slice(2),r=[],i=!1;for(let e of n){if(i){r.push(e),i=!1;continue}if(ir.has(e)){r.push(e),i=!0;continue}if(/^-[a-zA-Z]{2,}$/.test(e)){let t=e.slice(1).split(``);for(let e of t)r.push(`-${e}`);ir.has(`-${t[t.length-1]}`)&&(i=!0)}else r.push(e)}this.args=r,this.command=this.args[0];let a=1,o=[];for(this.validationError=void 0;a<this.args.length;){let e=this.args[a];if(e.startsWith(`-`)){if(!rr.has(e)){this.validationError=`Unknown argument: ${e}`;break}if(e===Z.verifyExample.long)a+1<this.args.length&&!this.args[a+1].startsWith(`-`)?(this.verifyExampleValue=this.args[a+1],a+=2):(this.verifyExampleValue=!0,a+=1);else if(ir.has(e))if(a+1<this.args.length&&!this.args[a+1].startsWith(`-`))a+=2;else{this.validationError=`Missing value for option: ${e}`;break}else a+=1}else o.push(e),a+=1}if(!this.validationError){let e=this.getFlagValue(Z.preset.long,Z.preset.short)??this.getFlagValue(Z.hostPreset.long,Z.hostPreset.short);e!==void 0&&!Gn(e)&&(this.validationError=`Invalid host preset: ${e}`)}this.positionalArgs=o,this.validationError||(this.command===`check`?o.length>0&&(this.validationError=`Unknown argument: ${o[0]}`):o.length>1?this.validationError=`Unknown argument: ${o[1]}`:this.name=o[0]),this.logger=t.logger||new Nt({isQuiet:this.isQuiet,isJson:this.isJson,isYes:this.isYes})}get isAgent(){return this.hasFlag(`isAgent`)}get isYes(){return this.isAgent||this.hasFlag(`isYes`)}get isQuiet(){return this.isAgent||this.hasFlag(`isQuiet`)}get isJson(){return this.isAgent||this.hasFlag(`isJson`)}get isForce(){return this.hasFlag(`isForce`)}get helpRequested(){return this.hasFlag(`helpRequested`)}get example(){let e=Z.example;return this.getFlagValue(e.long,e.short)}get noCodegen(){return this.hasFlag(`noCodegen`)}get schema(){let e=Z.schema;return this.getFlagValue(e.long,e.short)}get envFiles(){let e=Z.envFile;return this.getFlagValues(e.long,e.short)}get verifyExample(){return this.verifyExampleValue}get hostPreset(){let e=this.getFlagValue(Z.preset.long,Z.preset.short)??this.getFlagValue(Z.hostPreset.long,Z.hostPreset.short);if(e&&Gn(e))return e}hasFlag(e){let t=Z[e];return this.args.includes(t.long)||!!t.short&&this.args.includes(t.short)}get initInput(){let e={isYes:this.isYes,isForce:this.isForce,isQuiet:this.isQuiet,isAgent:this.isAgent};return this.example!==void 0&&(e.example=this.example),this.name!==void 0&&(e.name=this.name),this.noCodegen&&(e.noCodegen=!0),this.hostPreset!==void 0&&(e.hostPreset=this.hostPreset),e}get checkInput(){return{...this.schema===void 0?{}:{schema:this.schema,file:this.schema},...this.envFiles.length>0?{envFiles:this.envFiles}:{},...this.verifyExample===void 0?{}:{verifyExample:this.verifyExample},isQuiet:this.isQuiet,isJson:this.isJson,isAgent:this.isAgent,isYes:this.isYes,isForce:this.isForce}}getFlagValue(e,t){let n=this.args.findIndex(n=>n===e||n===t);if(n!==-1&&this.args[n+1]&&!this.args[n+1].startsWith(`-`))return this.args[n+1]}getFlagValues(e,t){let n=[];for(let r=0;r<this.args.length-1;r++){let i=this.args[r];(i===e||t&&i===t)&&!this.args[r+1].startsWith(`-`)&&n.push(this.args[r+1])}return n}};function or(e){return e.replace(/\\([nrtbfv0"\\])/g,(e,t)=>{switch(t){case`n`:return`
|
|
101
|
+
`;case`r`:return`\r`;case`t`:return` `;case`b`:return`\b`;case`f`:return`\f`;case`v`:return`\v`;case`0`:return`\0`;case`"`:return`"`;case`\\`:return`\\`;default:return`\\${t}`}})}function sr(e,t){for(let n=0;n<e.length;n++){if(t===`"`&&e[n]===`\\`){n++;continue}if(e[n]===t)return n}return-1}function cr(e){let t={},n=e.split(/\r?\n/),r=null,i=``,a=null;for(let e=0;e<n.length;e++){let o=n[e];if(a!==null){let e=sr(o,a);if(e!==-1){i+=`
|
|
102
|
+
`+o.slice(0,e);let n=a===`"`?or(i):i;r!==null&&(t[r]=n),r=null,i=``,a=null}else i+=`
|
|
103
|
+
`+o;continue}let s=o.trimStart();if(!s||s.startsWith(`#`))continue;s.startsWith(`export `)&&(s=s.slice(7).trimStart());let c=s.indexOf(`=`);if(c===-1)continue;let l=s.slice(0,c).trim();if(!l||!/^[A-Za-z_][A-Za-z0-9_]*$/.test(l))continue;let u=s.slice(c+1).trimStart(),d=u[0];if(d===`"`||d===`'`||d==="`"){let e=u.slice(1),n=sr(e,d);if(n!==-1){let r=e.slice(0,n);t[l]=d===`"`?or(r):r}else r=l,i=e,a=d}else{let e=u.indexOf(` #`);e!==-1&&(u=u.slice(0,e)),t[l]=u.trimEnd()}}return t}var lr=class{constructor(e,t,n,r){this.logger=e,this.workspace=t,this.scanner=n,this.schemaLoader=r}async execute(e){let i=e.cwd??process.cwd(),s=e.schema??e.file,c=!!(this.logger.isJson||e.isJson||e.isAgent),l=`.env`;try{await this.scanner.detectFramework(i)===`nextjs`&&(l=`.env.local`)}catch{}let u=await Bt(i,this.workspace,this.scanner,s);if(!u){let e=s?`Schema file not found at "${v.resolve(i,s)}".`:`Could not locate your schema file. Add an 'arkenv' entry to package.json or specify --schema <path>.`,t=[{kind:`run-command`,label:`Initialize a new ArkEnv schema`,command:`{bin} init`}];return c?this.logger.reportErrored({ok:!1,commandId:`check`,error:{code:j.CLI_SCHEMA_NOT_FOUND,severity:`error`,summary:e,why:`The schema file could not be found in package.json or convention paths.`,docsUrl:`https://arkenv.js.org/docs/reference/check`,nextActions:t},diagnostics:[],nextActions:t}):this.logger.error(e),2}let d=v.relative(i,u)||u,f=await this.schemaLoader.load({schemaPath:u});if(!f.ok){let e=M(f.message);if(f.code===K.ERR_INSPECT_NO_CALL){let t=[{kind:`run-command`,label:`Initialize a new ArkEnv schema`,command:`{bin} init`}];return c?this.logger.reportErrored({ok:!1,commandId:`check`,error:{code:j.CLI_SCHEMA_NOT_FOUND,severity:`error`,summary:e,where:{path:d},nextActions:t},diagnostics:[],nextActions:t}):this.logger.error(e),2}let t=f.cause?M(f.cause instanceof Error?f.cause.stack??f.cause.message:String(f.cause)):void 0,n=[{kind:`edit-file`,label:`Fix errors in ${d}`,where:{path:d}}];return c?this.logger.reportErrored({ok:!1,commandId:`check`,error:{code:j.CLI_SCHEMA_NOT_FOUND,severity:`error`,summary:e,...t?{why:t}:{},where:{path:d},nextActions:n},diagnostics:[],nextActions:n}):(this.logger.error(e),t&&this.logger.warn(t)),2}if(e.verifyExample!==void 0){let t=typeof e.verifyExample==`string`?e.verifyExample:`.env.example`,n=v.resolve(i,t),r=v.relative(i,n)||t,a=``;await this.workspace.exists(n)&&(a=await this.workspace.readFile(n));let o=cr(a),s=f.keys.map(e=>e.name),l=s.filter(e=>!(e in o));if(l.length>0){let e=l.map(e=>{let t=`${e} is declared in schema but missing in ${r}`,n=[{kind:`edit-file`,label:`Add ${e} to ${r}`,where:{path:r},meta:{targetFile:r,key:e}}];return{code:j.ENV_MISSING_VARIABLE,severity:`error`,summary:t,where:{path:r},meta:{key:e,targetFile:r},nextActions:n}}),t=e.flatMap(e=>e.nextActions);if(c)this.logger.reportCompleted({ok:!0,commandId:`check`,result:{schema:{path:d},file:{path:r},keys:{declared:s.length,missing:l.length}},exitCode:4,diagnostics:e,nextActions:t});else{let e=l.length===1?`key`:`keys`,t=l.map(e=>` - ${e}`).join(`
|
|
104
|
+
`);this.logger.error(`Missing ${l.length} ${e} in ${r}:\n${t}\n\nPlease add the missing ${e} to ${r}.`)}return 4}return c?this.logger.reportCompleted({ok:!0,commandId:`check`,result:{schema:{path:d},file:{path:r},keys:{declared:s.length,missing:0}},exitCode:0,diagnostics:[],nextActions:[]}):this.logger.success(`No issues found — ${r} matches the schema`),0}let p={...process.env};if(e.envFiles&&e.envFiles.length>0)for(let t of e.envFiles){let e=v.resolve(i,t);if(!await this.workspace.exists(e)){let n=`Environment file not found at "${e}".`;return c?this.logger.reportErrored({ok:!1,commandId:`check`,error:{code:j.CLI_INVALID_ARGUMENT,severity:`error`,summary:n,where:{path:t},nextActions:[]},diagnostics:[],nextActions:[]}):this.logger.error(n),2}let n=cr(await this.workspace.readFile(e));Object.assign(p,n)}let m=await this.schemaLoader.validate({schemaPath:u},p);if(m.ok)return c?this.logger.reportCompleted({ok:!0,commandId:`check`,result:{schema:{path:d}},exitCode:0,diagnostics:[],nextActions:[]}):this.logger.success(`No issues found — your environment matches the schema`),0;if(m.kind===`validation`){let e=m.issues??[],i=e.map(e=>{let n=e.code===`MISSING_VARIABLE`||e.received===void 0,i=n?j.ENV_MISSING_VARIABLE:j.ENV_INVALID_VALUE,a=r(e.path)&&!o(),s;s=a?n?`missing`:`[REDACTED]`:n||e.received===void 0?`missing`:typeof e.received==`string`?e.received:t(e.received,e.path);let c=M(e.message.startsWith(e.path)?e.message:`${e.path} ${e.message.trimStart()}`,e.path),u=[{kind:`edit-file`,label:`Set ${e.path} in ${l}`,where:{path:l},meta:{targetFile:l,key:e.path,...e.expected===void 0?{}:{expected:e.expected}}}],f={key:e.path,...e.expected===void 0?{}:{expected:e.expected},received:s,issueCode:e.code,...e.meta?e.meta:{}};return{code:i,severity:`error`,summary:c,where:{path:d},meta:f,nextActions:u}}),s=i.flatMap(e=>e.nextActions);return c?this.logger.reportCompleted({ok:!0,commandId:`check`,result:{schema:{path:d}},exitCode:4,diagnostics:i,nextActions:s}):this.logger.error(`Errors found while validating environment variables:\n${a(n(e))}`),4}let h=m.message,g=M(h);return m.cause&&!(m.cause instanceof SyntaxError)&&!/syntax|cannot find module/i.test(h)?(c?this.logger.reportErrored({ok:!1,commandId:`check`,error:{code:j.CLI_INTERNAL_ERROR,severity:`error`,summary:g,where:{path:d},nextActions:[]},diagnostics:[],nextActions:[]}):this.logger.error(`Failed to validate environment: ${g}`),1):(c?this.logger.reportErrored({ok:!1,commandId:`check`,error:{code:j.CLI_SCHEMA_NOT_FOUND,severity:`error`,summary:g,where:{path:d},nextActions:[]},diagnostics:[],nextActions:[]}):this.logger.error(`Failed to load schema file at ${d}: ${g}`),2)}},ur=`arkenv`,dr=`1.0.0-alpha.21`;function fr(e,t=2,n=4){let r=Math.max(...e.map(e=>e.left.length),0),i=` `.repeat(t);return e.map(e=>{let t=` `.repeat(r-e.left.length+n);return`${i}${e.left}${t}${e.right}`})}var pr=class{constructor(e){this.logger=e}async execute(){let e=[{left:`arkenv init [project-name]`,right:`Set up ArkEnv in your project`},{left:`arkenv check`,right:`Validate the environment against the schema`}],t=[{left:`--yes, -y`,right:`Skip prompts and use defaults (also passed to subprocesses)`},{left:`--quiet, -q`,right:`Quiet mode: Suppress output, capture logs on failure`},{left:`--json, -j`,right:`Output structured JSON to stdout`},{left:`--agent`,right:`Enable non-interactive, machine-readable mode for AI agents. Bypasses all prompts and outputs structured JSON. Macro for --yes --quiet --json`},{left:`--help, -h`,right:`Show this help message`}],n=[{left:`--example`,right:`Specify an example name when creating a new project`},{left:`--force, -f`,right:`Bypass technical requirement checks and dirty git working tree check, then force scaffolding`},{left:`--no-codegen`,right:`Disable automatic env.gen.ts code generation for Next.js`},{left:`--preset, -P <preset>`,right:`Specify a hosting provider preset (none, vercel, netlify, cloudflare, railway, render, fly)`}],r=[{left:`--schema, -s <path>`,right:`Path to schema file (overrides package.json or convention discovery)`},{left:`--env-file <file>`,right:`Path to .env file to load (repeatable; merged in order over process.env)`},{left:`--verify-example [file]`,right:`Verify that all declared schema keys are present in .env.example (or custom file)`}];this.logger.log(`ArkEnv CLI v${dr}`),this.logger.log(`\n${k.default.bold(`Usage:`)}`);for(let t of fr(e))this.logger.log(t);this.logger.log(`\n${k.default.bold(`Global options:`)}`);for(let e of fr(t))this.logger.log(e);this.logger.log(`\n${k.default.bold(`init options:`)}`);for(let e of fr(n))this.logger.log(e);this.logger.log(`\n${k.default.bold(`check options:`)}`);for(let e of fr(r))this.logger.log(e)}};async function mr(e,t){let n=t.targetDir??process.cwd(),r=v.join(process.cwd(),`.arkenv-temp`);await e.mkdir(r,!0),t.targetDir&&await e.mkdir(n,!0);try{await e.execute(`git`,[`clone`,`--filter=blob:none`,`--sparse`,t.repository,r]);let i=`examples/${t.example}`;await e.execute(`git`,[`-C`,r,`sparse-checkout`,`set`,i]);let a=v.join(r,i),o=await S.readdir(a),s=[];for(let t of o){let r=v.join(n,t);await e.exists(r)&&s.push(t)}if(s.length>0)throw Error(`Scaffolding into a non-empty directory failed. The following paths already exist: ${s.join(`, `)}`);await hr(a,n);for(let e of[`package-lock.json`,`pnpm-lock.yaml`,`yarn.lock`,`bun.lockb`,`bun.lock`])await S.rm(v.join(n,e),{force:!0});let c=v.join(n,`package.json`);if(await e.exists(c)){let n=await e.readFile(c),r=JSON.parse(n);r.name=t.targetName,delete r.packageManager,await e.writeFile(c,JSON.stringify(r,null,2))}}finally{await S.rm(r,{recursive:!0,force:!0})}}async function hr(e,t){let n=await S.readdir(e);await Promise.all(n.map(n=>S.cp(v.join(e,n),v.join(t,n),{recursive:!0,force:!1})))}function gr(e,t){let n=t.length>0;switch(e){case`pnpm`:return[`pnpm`,[n?`add`:`install`,...t]];case`yarn`:return[`yarn`,[n?`add`:`install`,...t]];case`bun`:return[`bun`,[n?`add`:`install`,...t]];default:return[`npm`,[`install`,...t]]}}function _r(e,t,n){if(t||e.metadata.skillDetected){let t=e.metadata.framework===`nextjs`&&!e.metadata.disableCodegen,r=e.metadata.framework===`nuxt`&&!e.metadata.disableCodegen,i=t&&!n,a=T`
|
|
105
|
+
Inside your AI assistant (e.g. Claude Code), use:
|
|
106
|
+
${q(`/arkenv`)} - automatically refine your schema and configure integrations.
|
|
107
|
+
`;return i?(a+=`
|
|
108
|
+
|
|
109
|
+
`,a+=`Also, wrap your Next.js config with ${q(`withArkEnv`)}:\n`,a+=` ${q(`import { withArkEnv } from "@arkenv/nextjs/config";`)}\n`,a+=` ${q(`export default withArkEnv(nextConfig);`)}\n`,a+=`Import and use: ${q(`import { env } from "${e.metadata.importPath}"`)}\n`):r&&(a+=`
|
|
110
|
+
|
|
111
|
+
`,a+=`Import and use: ${q(`import { env } from "${e.metadata.importPath}"`)}\n`),{message:a,title:`Next steps`}}let r=e.skill?.dlxCommand.join(` `)||`npx`,i=e.skill?.packageName||`yamcodes/arkenv`,a=``,o=1,s=e.metadata.displayPath;a+=`${o++}. Check ${q(s)} and refine your environment schema.\n`;let c=e.metadata.framework===`nextjs`&&!e.metadata.disableCodegen&&!n;return e.metadata.framework===`nextjs`&&(e.metadata.disableCodegen||c&&(a+=`${o++}. Wrap your Next.js config with ${q(`withArkEnv`)} inside ${q(`next.config.ts`)}:\n`,a+=` ${q(`import { withArkEnv } from "@arkenv/nextjs/config";`)}\n`,a+=` ${q(`export default withArkEnv(nextConfig);`)}\n`)),a+=`${o++}. Import and use: ${q(`import { env } from "${e.metadata.importPath}"`)}\n`,a+=`${o++}. (Recommended) Install the AI skill: ${q(`${r} skills add ${i}`)}\n`,a+=` Then run ${q(`/arkenv`)} inside your AI assistant to finish.`,{message:a,title:`Next steps`}}const vr=[`esbuild`];var yr=class{constructor(e,t){this.workspace=e,this.reporter=t}async execute(e){let t=this.reporter.spinner();t.start(`Scaffolding ArkEnv configuration...`);try{e.clone&&(t.stop(`Starting new project scaffolding...`),this.reporter.step(`Cloning example ${q(e.clone.example)}...`),await mr(this.workspace,e.clone),t.start(`Scaffolding complete, finalizing...`));for(let t of e.files)t.action===`create`&&await this.workspace.exists(t.path)||(await this.workspace.mkdir(v.dirname(t.path),!0),await this.workspace.writeFile(t.path,t.content));if(t.stop(`Configuration scaffolded!`),await this.configurePackageJsonArkenv(e.install?.cwd??e.cwd,e.metadata),e.install&&process.env.SKIP_INSTALL!==`true`){e.install.packageManager===`pnpm`&&await this.configurePnpmBuilds(e.install.cwd??e.cwd),this.reporter.step(`Installing dependencies with ${q(e.install.packageManager)}...`);let[t,n]=gr(e.install.packageManager,e.install.dependencies);await this.workspace.execute(t,n,e.install.cwd??e.cwd)}let n=!1;if(e.tsConfig){let t=await this.workspace.updateTsConfigToStrict(e.tsConfig.path);t.status===`updated`?(this.reporter.info(`Enforced strict: true in your ${q(t.file)}`),n=!0):t.status===`error`&&this.reporter.warn(`Could not automatically update ${q(t.file||`tsconfig.json`)}. Please ensure 'strict: true' is set manually.`)}let r=!1;if(e.bootstrap){if(e.bootstrap.framework===`vite`){let t=await this.workspace.findViteConfig(e.cwd);if(t){this.reporter.step(`Bootstrapping Vite plugin...`);let n=await this.workspace.bootstrapViteConfig(t,e.bootstrap.importPath||`./src/env`);n.success?n.updated&&this.reporter.info(`Updated ${q(v.basename(t))}`):(this.reporter.warn(`Could not automatically update ${q(v.basename(t))}: ${n.error}`),this.reporter.info(`Please add ${q(`@arkenv/vite-plugin`)} manually.`))}else this.reporter.info(`No Vite config found - please add ${q(`@arkenv/vite-plugin`)} to your Vite config manually.`)}else if(e.bootstrap.framework===`bun-fullstack`){let t=await this.workspace.findBunConfig(e.cwd),n=await this.workspace.bootstrapBunConfig(t,e.bootstrap.bunFeatures);n.success&&n.instructions?this.reporter.info(n.instructions):n.success||this.reporter.error(n.error||`Bun bootstrap failed`)}else if(e.bootstrap.framework===`nextjs`){if(!e.bootstrap.disableCodegen){this.reporter.step(`Generating Next.js environment bindings...`);let t=`import('@arkenv/nextjs/config').then(({ runCodegen }) => { const path = require('path'); const schemaPath = path.resolve(process.cwd(), '${e.metadata.displayPath}'); const outputPath = path.join(process.cwd(), '.arkenv', 'env.gen.ts'); runCodegen(schemaPath, outputPath); }).catch(err => { console.error(err); process.exit(1); });`;try{await this.workspace.execute(`node`,[`-e`,t],e.cwd),this.reporter.info(`Generated ${q(`.arkenv/env.gen.ts`)} for Next.js`);let n=await this.workspace.ensureNextjsArkEnvTsConfig(e.tsConfig?.path);n.status===`updated`&&this.reporter.info(`Mapped ${q(`@/.arkenv`)} in ${q(n.file||`tsconfig.json`)}`)}catch{this.reporter.warn(`Failed to automatically generate ${q(`.arkenv/env.gen.ts`)}. It will be generated when you start your dev server.`)}}if(e.bootstrap.wrapNextjsConfig!==!1){this.reporter.step(`Bootstrapping Next.js config...`);let t=await this.workspace.findNextjsConfig(e.cwd);if(t){let n=await this.workspace.bootstrapNextjsConfig(t,e.bootstrap.disableCodegen);n.success?n.updated?(this.reporter.info(`Updated ${q(v.basename(t))}`),r=!0):(this.reporter.info(`${q(v.basename(t))} already uses withArkEnv`),r=!0):this.reporter.warn(`Could not automatically update ${q(v.basename(t))}: ${n.error}`)}else this.reporter.info(`No Next.js config found. Please wrap your config with ${q(`withArkEnv`)} manually.`)}}else if(e.bootstrap.framework===`nuxt`){this.reporter.step(`Bootstrapping Nuxt config...`);let t=await this.workspace.findNuxtConfig(e.cwd);if(t){let e=await this.workspace.bootstrapNuxtConfig(t);e.success?(e.updated?this.reporter.info(`Updated ${q(v.basename(t))}`):this.reporter.info(`${q(v.basename(t))} already registers @arkenv/nuxt/module`),r=!0):this.reporter.warn(`Could not automatically update ${q(v.basename(t))}: ${e.error}`)}else this.reporter.info(`No Nuxt config found. Please register ${q(`@arkenv/nuxt/module`)} manually.`)}}let i=!1;if(e.skill&&process.env.SKIP_INSTALL!==`true`){this.reporter.step(`Installing ArkEnv agent skill...`);try{let[t,...n]=e.skill.dlxCommand,r=[...n,`skills`,`add`,e.skill.packageName];e.skill.isYes&&r.push(`--yes`),await this.workspace.execute(t,r,e.cwd),i=!0}catch(e){let t=e instanceof Error?e.message:String(e);this.reporter.warn(`Failed to install ArkEnv AI skill: ${t}`)}}let a=_r(e,i,r);this.reporter.note(a.message,a.title),this.reporter.finish(`${_n} ArkEnv scaffolding complete. Happy coding!`,{path:e.metadata.displayPath,framework:e.metadata.framework,validator:e.metadata.validator,packageManager:e.metadata.packageManager,tsConfigUpdated:n,skillInstalled:i},`init`)}catch(e){throw t.stop(`Scaffolding failed.`),e}}async configurePnpmBuilds(e){let t=v.join(e,`package.json`);if(await this.workspace.exists(t))try{let e=await this.workspace.readFile(t),n=JSON.parse(e);n.pnpm=n.pnpm||{},n.pnpm.onlyBuiltDependencies=n.pnpm.onlyBuiltDependencies||[];for(let e of vr)n.pnpm.onlyBuiltDependencies.includes(e)||n.pnpm.onlyBuiltDependencies.push(e);await this.workspace.writeFile(t,JSON.stringify(n,null,2)+`
|
|
112
|
+
`)}catch(e){this.reporter.warn(`Could not update package.json with pnpm whitelisting: ${e}`)}let n=v.join(e,`pnpm-workspace.yaml`),r=``;if(await this.workspace.exists(n))try{r=await this.workspace.readFile(n)}catch{}let i=this.updatePnpmWorkspaceYaml(r);try{await this.workspace.writeFile(n,i)}catch(e){this.reporter.warn(`Could not write pnpm-workspace.yaml: ${e}`)}}updatePnpmWorkspaceYaml(e){let t=re(e||``);t.has(`allowBuilds`)||t.set(`allowBuilds`,t.createNode({}));let n=t.get(`allowBuilds`);if(ne(n)||(t.set(`allowBuilds`,t.createNode({})),n=t.get(`allowBuilds`)),ne(n))for(let e of vr)n.get(e)!==!0&&n.set(e,!0);return String(t)}async configurePackageJsonArkenv(e,t){let n=v.join(e,`package.json`);if(await this.workspace.exists(n))try{let e=await this.workspace.readFile(n),r=JSON.parse(e);r.arkenv={schema:t.displayPath},await this.workspace.writeFile(n,JSON.stringify(r,null,2)+`
|
|
113
|
+
`)}catch(e){this.reporter.warn(`Could not update package.json with arkenv schema entry: ${e}`)}}};const Q={nextjs:{id:`nextjs`,packageName:`@arkenv/nextjs`,clientPrefix:`NEXT_PUBLIC_`,displayName:`Next.js`,supportsWrapNextjsConfig:!0},nuxt:{id:`nuxt`,packageName:`@arkenv/nuxt`,clientPrefix:`NUXT_PUBLIC_`,displayName:`Nuxt`,supportsWrapNextjsConfig:!1}};function br(e){if(e===`nextjs`||e===`nuxt`)return Q[e]}function xr(e){return e===`nextjs`||e===`nuxt`}const Sr={nextjs:Q.nextjs.clientPrefix,nuxt:Q.nuxt.clientPrefix,vite:`VITE_`,"bun-fullstack":`BUN_PUBLIC_`,vanilla:``};function Cr(e,t){let n=br(e.framework);return{framework:e.framework,clientPrefix:Sr[e.framework],...n?.packageName!==void 0&&{packageName:n.packageName},disableCodegen:e.disableCodegen===!0,...t!==void 0&&{nextjsImportPath:t},...e.hostPreset!==void 0&&{hostPreset:e.hostPreset}}}const wr={NODE_ENV:`development`,PORT:`3000`,DATABASE_URL:`postgres://localhost:5432/mydb`};function Tr(e){let t={};for(let n of e)t[n]=wr[n]??``;return t}function Er(e,t,n){if(!n)return;let r=((n.compilerOptions||{}).paths||{})[`@/*`];if(!r)return;let i=n.path?v.dirname(n.path):e,a=v.relative(i,t).replace(/\\/g,`/`);for(let e of r){let t=e.replace(/^\.\//,``).replace(/\*$/,``);if(t===``||a.startsWith(t)){let e=a;return t!==``&&a.startsWith(t)&&(e=a.substring(t.length)),e=e.replace(/^\/+/,``).replace(/\/+$/,``),`@/${e}/env.gen`.replace(/\/+/g,`/`)}}}function Dr(e,t){if(!(!xr(t.framework)||t.disableCodegen)){if(t.framework===`nextjs`)return`@/.arkenv`;if(e.tsConfig?.parsed)return Er(e.cwd,v.join(e.targetDir,`generated`),e.tsConfig.parsed)}}function Or(e,t,n,r){let i=Cr(t,r),a=e.getSimpleTemplate(t.envKeys??[],i),o=n.existingFiles.includes(n.targetPath);return!o||t.overwriteEnvSchemaFile!==!1?[{path:n.targetPath,content:a,action:o?`overwrite`:`create`,label:`environment schema`}]:[]}const kr={clientPrefix:Sr[`bun-fullstack`],getEnvDefaults(e){return e&&e.length>0?Tr(e):{DATABASE_URL:`postgres://localhost:5432/mydb`,BUN_PUBLIC_API_URL:`https://api.example.com`,NODE_ENV:`development`}},getDependencies(e){return e.bunFeatures?.length?[`@arkenv/bun-plugin`]:[]},requiresArktypePeer(e){return!!e.bunFeatures?.length},bootstrap(e){return l({framework:`bun-fullstack`,bunFeatures:e.bunFeatures})},getSchemaFiles(e,t,n){return Or(e,t,n)}};function Ar(e){let{id:t,packageName:n,clientPrefix:r,supportsWrapNextjsConfig:i}=e,a=`${r}API_URL`;return{clientPrefix:r,getEnvDefaults(e){return e&&e.length>0?Tr(e):{DATABASE_URL:`postgres://localhost:5432/mydb`,[a]:`https://api.example.com`,NODE_ENV:`development`}},getDependencies(){return[n]},requiresArktypePeer(){return!0},bootstrap(e){return l({framework:t,...i&&{wrapNextjsConfig:e.wrapNextjsConfig!==!1},disableCodegen:e.disableCodegen})},getSchemaFiles(e,t,n){return Or(e,t,n,Dr(n,t))}}}const jr=Ar(Q.nextjs),Mr=Ar(Q.nuxt),Nr={clientPrefix:Sr.vanilla,getEnvDefaults(e){return e&&e.length>0?Tr(e):{PORT:`3000`,NODE_ENV:`development`}},getDependencies(){return[]},requiresArktypePeer(){return!1},bootstrap(){},getSchemaFiles(e,t,n){return Or(e,t,n)}},Pr={vite:{clientPrefix:Sr.vite,getEnvDefaults(e){return e&&e.length>0?Tr(e):{DATABASE_URL:`postgres://localhost:5432/mydb`,VITE_API_URL:`https://api.example.com`,NODE_ENV:`development`}},getDependencies(){return[`@arkenv/vite-plugin`]},requiresArktypePeer(){return!0},bootstrap(){return l({framework:`vite`})},getSchemaFiles(e,t,n){return Or(e,t,n)}},"bun-fullstack":kr,nextjs:jr,nuxt:Mr,vanilla:Nr},Fr={basic:{HOST:`localhost`,PORT:`3000`,NODE_ENV:`development`},"basic-js":{HOST:`localhost`,PORT:`3000`,NODE_ENV:`development`},"with-bun":{HOST:`localhost`,PORT:`3000`,NODE_ENV:`development`},"with-nextjs":{DATABASE_URL:`postgres://localhost:5432/mydb`,NEXT_PUBLIC_API_URL:`https://api.example.com`,NODE_ENV:`development`},"with-nextjs-zod":{DATABASE_URL:`postgres://localhost:5432/mydb`,NEXT_PUBLIC_API_URL:`https://api.example.com`,NODE_ENV:`development`},"with-nuxt":{DATABASE_URL:`postgres://localhost:5432/mydb`,NUXT_PUBLIC_API_URL:`https://api.example.com`,NODE_ENV:`development`},"with-vite-react":{PORT:`3000`,VITE_MY_VAR:`hello`,VITE_MY_NUMBER:`42`,VITE_MY_BOOLEAN:`true`},"with-vite-react-zod":{PORT:`3000`,VITE_MY_VAR:`hello`,VITE_MY_NUMBER:`42`,VITE_MY_BOOLEAN:`true`},"with-bun-react":{BUN_PUBLIC_API_URL:`https://api.example.com`,BUN_PUBLIC_DEBUG:`true`,NODE_ENV:`development`},"with-zod":{HOST:`localhost`,PORT:`3000`,NODE_ENV:`development`},"with-valibot":{HOST:`localhost`,PORT:`3000`,NODE_ENV:`development`},"mix-and-match":{DATABASE_URL:`https://postgres.example.com/db`,API_KEY:`12345678901234567890123456789012`,NODE_ENV:`development`,PORT:`3000`,DEBUG:`false`}};function Ir(e,t){return Fr[e]??t()}function Lr(e){switch(e){case`pnpm`:return[`pnpm`,`dlx`];case`yarn`:return[`yarn`,`dlx`];case`bun`:return[`bunx`];default:return[`npx`]}}function Rr(e,t,n,r){if(!r||r===`none`)return;let i=Kn(r,n);for(let a of i)n&&a.startsWith(n)?e.clientFields.push(`\t\t${t.formatCodegenField(a,`client`,n,r)}`):e.serverFields.push(`\t\t${t.formatCodegenField(a,`server`,n,r)}`)}function zr(e){let t=[];for(let n of e){let e=n.trim().match(/^([a-zA-Z0-9_]+)\s*:/);e&&t.push(e[1])}return t}function Br(e,t,n,r=[]){let i=[],a=new Set,o=e=>{a.has(e)||(a.add(e),i.push(`\t\t${e}: process.env.${e},`))};if(e&&e.length>0){for(let n of e)(n.startsWith(t)||n===`NODE_ENV`||r.includes(n))&&o(n);return i}o(`${t}API_URL`),o(`NODE_ENV`);for(let e of zr(n))o(e);for(let e of r)o(e);return i}function Vr(e){let{envKeys:t,dialect:n,config:r,importPath:i,disableCodegen:a,hostPreset:o}=e,{clientPrefix:s}=r,c=[],l=[],u=[];if(t&&t.length>0)for(let e of t)e.startsWith(s)?l.push(`\t\t${n.formatCodegenField(e,`client`,s,o)}`):e===`NODE_ENV`?u.push(`\t\t${n.formatCodegenField(e,`shared`,s,o)}`):c.push(`\t\t${n.formatCodegenField(e,`server`,s,o)}`);else{let e=n.getDefaultCodegenFields(s);c.push(...e.serverFields),l.push(...e.clientFields),u.push(...e.sharedFields),Rr({serverFields:c,clientFields:l},n,s,o)}return Hr({serverFields:c,clientFields:l,sharedFields:u,envKeys:t,dialect:n,config:r,nextjsImportPath:i,disableCodegen:a,hostPreset:o})}function Hr(e){let{serverFields:t,clientFields:n,sharedFields:r,envKeys:i,dialect:a,config:o,nextjsImportPath:s,disableCodegen:c,hostPreset:l}=e,{clientPrefix:u,packageName:d,displayName:f}=o,p=o.id,m=a.extraImport,h=Kn(l??`none`,u),g;if(l&&l!==`none`&&h.length>0){let e=[...t,...n,...r].filter(e=>{let t=e.trim().match(/^([a-zA-Z0-9_]+)\s*:/)?.[1];return t&&!h.includes(t)}).map(e=>e.replace(/^\t\t/,` `)),i=[];for(let e of h){let t=u&&e.startsWith(u)?`client`:e===`NODE_ENV`?`shared`:`server`;i.push(`\t${a.formatCodegenField(e,t,u,l)}`)}let o=J[l]?.label??l;g=[...e,...e.length>0?[``]:[],`\t// ${o} environment variables`,...i]}else g=[...t,...n,...r].map(e=>e.replace(/^\t\t/,` `));let _=[];for(let e of r){let t=e.trim().match(/^([a-zA-Z0-9_]+)\s*:/);if(t){let e=t[1];e!==`NODE_ENV`&&_.push(e)}}let v=[];if(_.length>0&&v.push(`\texposeToClient: [${_.map(e=>`"${e}"`).join(`, `)}]`),c&&p===`nextjs`){let e=Br(i,u,n,_);v.push(`\truntimeEnv: {\n${e.join(`
|
|
114
|
+
`)}\n\t}`)}let y=v.length>0?`, {\n${v.join(`,
|
|
115
|
+
`)}\n}`:``;return`${[`import arkenv from "${p===`nuxt`||c?d:s||`@/.arkenv`}";`,...m?[m]:[]].join(`
|
|
116
|
+
`)}
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* Environment variable schema.
|
|
120
|
+
* ${p===`nuxt`?`In ${f}, use \`${d}\` to validate variables at build-time and runtime.`:`In ${f}, import the generated \`arkenv\` from \`@/.arkenv\` to validate variables.`}
|
|
121
|
+
* Enforces client/server separation and prevents secret leaks.
|
|
122
|
+
*/
|
|
123
|
+
export const env = arkenv({
|
|
124
|
+
${g.join(`
|
|
125
|
+
`)}
|
|
126
|
+
}${y});
|
|
127
|
+
`}function Ur(e,t,n){let r=Kn(n.hostPreset??`none`,n.clientPrefix),i=br(n.framework);if(i){let a=t.length>0?Array.from(new Set([...t,...r])):void 0;return`${Vr({...a===void 0?{}:{envKeys:a},dialect:e,config:i,...n.nextjsImportPath!==void 0&&{importPath:n.nextjsImportPath},disableCodegen:n.disableCodegen,...n.hostPreset!==void 0&&{hostPreset:n.hostPreset}})}\n`}let a;if(n.hostPreset&&n.hostPreset!==`none`&&r.length>0){let i=`\t\t// ${J[n.hostPreset]?.label??n.hostPreset} environment variables`,o=e.formatSimpleSchemaFields(r,n.clientPrefix,n.hostPreset),s=t.filter(e=>!r.includes(e));a=s.length>0?`${e.formatSimpleSchemaFields(s,n.clientPrefix,void 0)}\n\n${i}\n${o}`:`${e.defaultSimpleSchemaFields}\n\n${i}\n${o}`}else a=t.length>0?e.formatSimpleSchemaFields(t,n.clientPrefix,n.hostPreset):e.defaultSimpleSchemaFields;return`${e.assembleVanilla(a)}\n`}function Wr(e,t){return t.type===`string`?e.formatOptionalString():e.formatOptionalEnum(t.values)}function $(e,t,n,r){let i=qn(t,n,r);if(i)return Wr(e,i)}const Gr={formatOptionalString(){return`"string?"`},formatOptionalEnum(e){return`"'${e.join(`' | '`)}'?"`},formatCodegenField(e,t,n=``,r=void 0){if(t===`shared`)return`${e}: "'development' | 'production' | 'test' = 'development'",`;let i=$(Gr,e,n,r);return i?`${e}: ${i},`:`${e}: "string?",`},defaultSimpleSchemaFields:` NODE_ENV: "'development' | 'production' | 'test' = 'development'",
|
|
128
|
+
PORT: "number.port = 3000",`,formatSimpleSchemaFields(e,t=``,n=void 0){return e.map(e=>`\t\t${e}: ${$(Gr,e,t,n)??`"string?"`},`).join(`
|
|
129
|
+
`)},getDefaultCodegenFields(e){return{serverFields:[` DATABASE_URL: "string = 'postgres://localhost:5432/mydb'",`],clientFields:[`\t\t${e}API_URL: "string = 'https://api.example.com'",`],sharedFields:[` NODE_ENV: "'development' | 'production' | 'test' = 'development'",`]}},assembleVanilla(e){return T`
|
|
130
|
+
import arkenv, { type } from "@arkenv/core";
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* Environment variable schema for server-side or runtime-only validation.
|
|
134
|
+
*/
|
|
135
|
+
export const env = arkenv({
|
|
136
|
+
${e}
|
|
137
|
+
});
|
|
138
|
+
`}},Kr={extraImport:`import * as v from "valibot";`,formatOptionalString(){return`v.optional(v.string())`},formatOptionalEnum(e){return`v.optional(v.picklist([${e.map(e=>`"${e}"`).join(`, `)}]))`},formatCodegenField(e,t,n=``,r=void 0){if(t===`shared`)return`${e}: v.optional(v.picklist(["development", "production", "test"]), "development"),`;let i=$(Kr,e,n,r);return i?`${e}: ${i},`:`${e}: v.optional(v.string()),`},defaultSimpleSchemaFields:` NODE_ENV: v.optional(v.picklist(["development", "production", "test"]), "development"),
|
|
139
|
+
PORT: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(65535)), 3000),`,formatSimpleSchemaFields(e,t=``,n=void 0){return e.map(e=>`\t\t${e}: ${$(Kr,e,t,n)??`v.optional(v.string())`},`).join(`
|
|
140
|
+
`)},getDefaultCodegenFields(e){return{serverFields:[` DATABASE_URL: v.optional(v.pipe(v.string(), v.url()), "postgres://localhost:5432/mydb"),`],clientFields:[`\t\t${e}API_URL: v.optional(v.pipe(v.string(), v.url()), "https://api.example.com"),`],sharedFields:[` NODE_ENV: v.optional(v.picklist(["development", "production", "test"]), "development"),`]}},assembleVanilla(e){return T`
|
|
141
|
+
import { arkenv } from "@arkenv/standard/valibot";
|
|
142
|
+
import * as v from "valibot";
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* Environment variable schema for server-side or runtime-only validation.
|
|
146
|
+
*/
|
|
147
|
+
export const env = arkenv({
|
|
148
|
+
${e}
|
|
149
|
+
});
|
|
150
|
+
`}},qr={extraImport:`import * as z from "zod";`,formatOptionalString(){return`z.string().optional()`},formatOptionalEnum(e){return`z.enum([${e.map(e=>`"${e}"`).join(`, `)}]).optional()`},formatCodegenField(e,t,n=``,r=void 0){if(t===`shared`)return`${e}: z.enum(["development", "production", "test"]).default("development"),`;let i=$(qr,e,n,r);return i?`${e}: ${i},`:`${e}: z.string().optional(),`},defaultSimpleSchemaFields:` NODE_ENV: z.enum(["development", "production", "test"]).default("development"),
|
|
151
|
+
PORT: z.int().min(1).max(65535).default(3000),`,formatSimpleSchemaFields(e,t=``,n=void 0){return e.map(e=>`\t\t${e}: ${$(qr,e,t,n)??`z.string().optional()`},`).join(`
|
|
152
|
+
`)},getDefaultCodegenFields(e){return{serverFields:[` DATABASE_URL: z.url().default("postgres://localhost:5432/mydb"),`],clientFields:[`\t\t${e}API_URL: z.url().default("https://api.example.com"),`],sharedFields:[` NODE_ENV: z.enum(["development", "production", "test"]).default("development"),`]}},assembleVanilla(e){return T`
|
|
153
|
+
import arkenv from "@arkenv/standard";
|
|
154
|
+
import * as z from "zod";
|
|
155
|
+
|
|
156
|
+
/**
|
|
157
|
+
* Environment variable schema for server-side or runtime-only validation.
|
|
158
|
+
*/
|
|
159
|
+
export const env = arkenv({
|
|
160
|
+
${e}
|
|
161
|
+
});
|
|
162
|
+
`}},Jr={arktype:Gr,zod:qr,valibot:Kr};function Yr(e){return{getSimpleTemplate(t,n){return Ur(e,t,n)}}}const Xr={arktype:Yr(Jr.arktype),zod:Yr(Jr.zod),valibot:Yr(Jr.valibot)};function Zr(e){return e.mode===`new`?ii(e):ai(e)}function Qr(e,t){return e.some(e=>{let n=e.indexOf(`#`),r=(n===-1?e:e.slice(0,n)).trim();if(!r)return!1;if(r===t||r===`/${t}`)return!0;if(r.includes(`*`)){let e=`^${r.replace(/\./g,`\\.`).replace(/\*/g,`.*`).replace(/^\//,`/?`)}$`;try{let n=new RegExp(e);return n.test(t)||n.test(`/${t}`)}catch{return!1}}return!1})}function $r(e){return Object.entries(e).map(([e,t])=>`${e}=${t}`).join(`
|
|
163
|
+
`)+`
|
|
164
|
+
`}function ei(e,t){let{cwd:n,options:r,existingFiles:i}=e,a=Pr[r.framework],o=v.join(n,`.env`),s=v.join(n,`.env.example`),c=i.includes(o),l=i.includes(s),u=Jn(r.envKeys,r.hostPreset,a.clientPrefix);if(!c){let e=r.envExampleContent===void 0?$r(a.getEnvDefaults(u)):r.envExampleContent;t.files.push({path:o,content:e,action:`create`,label:`local environment variables`})}l||t.files.push({path:s,content:$r(a.getEnvDefaults(u)),action:`create`,label:`environment variables template`})}function ti(e,t){let{cwd:n,options:r,existingFiles:i}=e,a=v.join(n,`.gitignore`),o=i.includes(a),s=r.framework===`nextjs`;if(o&&r.gitignoreContent!==void 0){let e=r.gitignoreContent.split(/\r?\n/),n=Qr(e,`.env`),i=Qr(e,`.env.local`),o=Qr(e,`.arkenv`)||Qr(e,`.arkenv/`);if(!n||!i||s&&!o){let e=``;(!n||!i)&&(e+=`
|
|
165
|
+
# Environment variables
|
|
166
|
+
`,n||(e+=`.env
|
|
167
|
+
`),i||(e+=`.env.local
|
|
168
|
+
`)),s&&!o&&(e+=`
|
|
169
|
+
# ArkEnv generated factory
|
|
170
|
+
.arkenv/
|
|
171
|
+
`);let c=r.gitignoreContent.endsWith(`
|
|
172
|
+
`)?`${r.gitignoreContent}${e.trim()}\n`:`${r.gitignoreContent}\n${e.trim()}\n`;t.files.push({path:a,content:c,action:`overwrite`,label:`.gitignore update`})}}else if(!o){let e=`# Environment variables
|
|
173
|
+
.env
|
|
174
|
+
.env.local
|
|
175
|
+
`;s&&(e+=`
|
|
176
|
+
# ArkEnv generated factory
|
|
177
|
+
.arkenv/
|
|
178
|
+
`),t.files.push({path:a,content:e,action:`create`,label:`.gitignore file`})}}function ni(e){let{mode:t,options:n,packageManager:r}=e,i=n.name&&n.name!==`.`?v.basename(n.name):void 0;return l({displayPath:``,framework:n.framework,validator:n.validator,packageManager:r,importPath:``,mode:t,example:n.example,name:i,skillDetected:n.skillDetected,disableCodegen:n.disableCodegen})}function ri(e,t){e.options.installSkill&&(t.skill={dlxCommand:Lr(e.packageManager),packageName:`yamcodes/arkenv`,isYes:e.isYes})}function ii(e){let{options:t,packageManager:n,cwd:r}=e;if(!t.example)throw Error(`New project scaffolding requires an example.`);let i=t.name&&t.name!==`.`?v.join(r,t.name):void 0,a=t.name&&t.name!==`.`?v.basename(t.name):v.basename(r),o={files:[],cwd:r,metadata:ni(e),clone:{repository:`https://github.com/yamcodes/arkenv.git`,example:t.example,targetName:a,...i!==void 0&&{targetDir:i}},install:{packageManager:n,dependencies:[],...i!==void 0&&{cwd:i}}};ri(e,o);let s=$r(Ir(t.example,()=>Pr[t.framework].getEnvDefaults())),c=i??r;return o.files.push({path:v.join(c,`.env`),content:s,action:`create`,label:`local environment variables`},{path:v.join(c,`.env.example`),content:s,action:`create`,label:`environment variables template`}),o.metadata.displayPath=`./src/env.ts`,o.metadata.importPath=`./src/env`,o}function ai(e){let{options:t,packageManager:n,tsConfig:r,shouldUpdateTsConfig:i,cwd:a,existingFiles:o}=e,s=Pr[t.framework],c=Xr[t.validator],l=v.resolve(a,t.path),u=v.dirname(l),d={files:[],cwd:a,metadata:ni(e)},f={targetPath:l,targetDir:u,cwd:a,existingFiles:o,overwriteEnvSchemaFile:t.overwriteEnvSchemaFile,path:t.path,tsConfig:r};d.files.push(...s.getSchemaFiles(c,t,f)),ei(e,d),ti(e,d);let p=t.framework===`nextjs`||t.framework===`nuxt`?void 0:t.validator===`arktype`?`@arkenv/core`:`@arkenv/standard`,m=[...p?[p]:[],t.validator,...t.validator===`valibot`?[`@valibot/to-json-schema`]:[],...s.getDependencies(t)];s.requiresArktypePeer(t)&&!m.includes(`arktype`)&&m.push(`arktype`),d.install={packageManager:n,dependencies:Array.from(new Set(m))},i&&r.file&&(d.tsConfig={path:v.resolve(a,r.file),action:`strict`});let h=s.bootstrap(t);h&&(d.bootstrap=h),ri(e,d);let g=v.relative(a,l).replace(/\\/g,`/`),_=g.startsWith(`.`)?g:`./${g}`,y=_.replace(/\.(ts|js|tsx|jsx)$/,``);return d.metadata.displayPath=_,d.metadata.importPath=y,d.bootstrap&&(d.bootstrap.importPath=y),d}var oi=class{async fetchRegistry(){try{let e=await fetch(`https://raw.githubusercontent.com/yamcodes/arkenv/main/examples/registry.json`);if(!e.ok)throw Error(`Failed to fetch registry: ${e.statusText}`);return await e.json()}catch{return{examples:[{id:`basic`,name:`Basic`,description:`A minimal ArkEnv setup in Node.js`,framework:`vanilla`},{id:`with-nextjs`,name:`Next.js`,description:`Minimal Next.js project with ArkType`,framework:`nextjs`},{id:`with-nextjs-zod`,name:`Next.js (Zod)`,description:`Next.js with @arkenv/nextjs/standard and Zod`,framework:`nextjs`},{id:`with-vite-react`,name:`React + Vite`,framework:`vite`},{id:`with-vite-react-zod`,name:`React + Vite (Zod)`,description:`React + Vite with @arkenv/vite-plugin/standard and Zod`,framework:`vite`},{id:`with-bun`,name:`Bun (Vanilla)`,description:`Minimal Bun project with ArkType`,framework:`vanilla`},{id:`with-bun-react`,name:`React + Bun fullstack dev server`,framework:`bun-fullstack`},{id:`with-zod`,name:`Zod`,description:`ArkEnv with Zod in Node.js`,framework:`vanilla`},{id:`with-valibot`,name:`Valibot`,description:`ArkEnv with Valibot in Node.js`,framework:`vanilla`},{id:`mix-and-match`,name:`Mix and Match`,description:`ArkEnv with mixed ArkType, Zod, and Valibot in Node.js`,framework:`vanilla`}]}}}},si=class{async checkFreshness(e){let{currentVersion:t,packageName:n=`arkenv`,timeoutMs:r=1e3}=e;try{let i=on(t),a=typeof i?.prerelease[0]==`string`?i.prerelease[0]:`latest`,o=e.distTag||a,s=`https://registry.npmjs.org/${encodeURIComponent(n)}/${encodeURIComponent(o)}`,c=await fetch(s,{signal:AbortSignal.timeout(r),headers:{Accept:`application/json`}});if(!c.ok)return{isOutdated:!1};let l=(await c.json())?.version;return!l||typeof l!=`string`?{isOutdated:!1}:{isOutdated:sn(l,t)>0,latestVersion:l,distTag:o}}catch{return{isOutdated:!1}}}};function ci(e,t,n=process.env.npm_config_user_agent||``,r=`latest`){let i=`${e}@${r}`;return n.includes(`pnpm`)?{command:`pnpm`,dlxArgs:[`dlx`,i,...t]}:n.includes(`bun`)?{command:`bunx`,dlxArgs:[i,...t]}:n.includes(`yarn`)?{command:`yarn`,dlxArgs:[`dlx`,i,...t]}:{command:`npx`,dlxArgs:[i,...t]}}async function li(e){let{command:t,dlxArgs:n}=ci(e.packageName,e.args,e.userAgent,e.tag),r=e.spawnFn??x;return new Promise((e,i)=>{let a=r(t,n,{stdio:`inherit`,shell:process.platform===`win32`}),o=()=>{a.kill(`SIGINT`)},s=()=>{a.kill(`SIGTERM`)};process.on(`SIGINT`,o),process.on(`SIGTERM`,s);let c=()=>{process.off(`SIGINT`,o),process.off(`SIGTERM`,s)};a.on(`error`,e=>{c(),i(e)}),a.on(`close`,(t,n)=>{if(c(),n===`SIGINT`){e(t??130);return}if(n===`SIGTERM`){e(t??143);return}if(n){e(t??1);return}e(t??0)})})}var ui=class{constructor(e,t,n,r,i=new oi,a=new si,o=li,s=e=>process.exit(e)){this.logger=e,this.workspace=t,this.prompt=n,this.scanner=r,this.registry=i,this.versionChecker=a,this.spawner=o,this.exit=s}async execute(e){if(!process.env.CI&&process.stdout.isTTY&&!e.isQuiet&&!e.isAgent&&!e.isYes){let e=await this.versionChecker.checkFreshness({currentVersion:dr,packageName:ur,timeoutMs:1e3});if(e.isOutdated&&e.latestVersion){let t=await this.prompt.confirm(`Version ${e.latestVersion} is available (running ${dr}). Run latest instead?`,!0,`Yes (Recommended)`);if(t===null)return this.logger.cancel(`Operation cancelled.`),!1;if(t){let t=process.argv.slice(2),n=t[0]===`init`?t:[`init`,...t],r=await this.spawner({packageName:ur,args:n,tag:e.distTag});return this.exit(r),!0}}}let t=await this.collect(e);if(!t)return!1;let n=Zr(t),r=new yr(this.workspace,this.logger);try{await r.execute(n)}catch(e){this.logger.fatal(`Scaffolding failed.`,e)}return!0}async collect(e){this.logger.interactiveStdout(!0);try{let t=e.name;t&&v.resolve(process.cwd(),t)===process.cwd()&&(t=`.`);let n={...e,...t!==void 0&&{name:t}},r=t&&t!==`.`?v.resolve(process.cwd(),t):process.cwd(),i=await this.workspace.exists(r),a=i?await this.scanner.hasPackageJson(r):!1,o=i?await this.scanner.isEmptyDirectory(r):!0;return n.example===void 0?a?await this.collectExistingProject(n,r):o||n.isForce?await this.collectNewProject(n,o):(this.logger.error(`Directory is not empty and no ${q(`package.json`)} was found.`),this.logger.info(`To scaffold a new project, run ${q(`arkenv init`)} in an empty directory or use ${q(`--force`)} to proceed anyway.`),this.logger.refuse({code:A.NON_EMPTY_DIR,message:`Directory is not empty and no package.json was found.`,why:`To scaffold a new project, run arkenv init in an empty directory or use --force to proceed anyway.`,retryWith:[`--force`],nextActions:[{kind:`run-command`,label:`Re-run with --force to scaffold into non-empty directory`,command:`{bin} init --force`}]},`init`),null):await this.collectNewProject(n,o)}finally{this.logger.interactiveStdout(!1)}}async collectExistingProject(e,t){let{isYes:n,isForce:r,isQuiet:i,isAgent:a}=e,o=await this.scanner.checkRequirements(t),s=o.filter(e=>e.status===`fail`),c=o.filter(e=>e.status===`warn`);for(let e of c)this.logger.warn(`${e.requirement}: ${e.message}`);if(s.length>0)if(r){this.logger.warn(`Technical requirements not met, but continuing due to --force flag.`);for(let e of s)this.logger.warn(`${e.requirement}: ${e.message}`)}else{this.logger.error(`Technical requirements not met:`);for(let e of s)this.logger.error(`- ${e.requirement}: ${e.message}${e.current?` (Current: ${e.current}, Expected: ${e.expected})`:``}`);return this.logger.info(`Use --force to bypass these checks.`),this.logger.refuse({code:A.REQUIREMENTS_NOT_MET,message:`Technical requirements not met.`,why:`Technical requirements (e.g. Node.js version) were not met.`,retryWith:[`--force`],nextActions:[{kind:`run-command`,label:`Re-run with --force to bypass technical requirements`,command:`{bin} init --force`}],details:{requirements:s.map(e=>l({requirement:e.requirement,message:e.message,current:e.current,expected:e.expected}))}},`init`),null}let u=await this.scanner.checkGitStatus(t);if(u.status===`dirty`)if(r)this.logger.warn(`Git working tree is not clean, but continuing due to --force flag.`);else return this.logger.error(`Git working tree is not clean. Commit or stash your changes (use 'git stash -u' for untracked files) before running arkenv init.`),this.logger.info(`Use --force to bypass this check.`),this.logger.refuse({code:A.GIT_TREE_DIRTY,message:`Git working tree is not clean.`,why:`Commit or stash your changes before running arkenv init.`,retryWith:[`--force`],nextActions:[{kind:`run-command`,label:`Re-run with --force to bypass git working tree check`,command:`{bin} init --force`}]},`init`),null;u.status===`unknown`&&this.logger.warn(`Git working tree status could not be determined. Proceeding with caution.`);let d=!1,f=await this.scanner.checkTsConfig(t);if(f.status===`not_strict`)if(n)d=!0;else{this.logger.warn(`TypeScript strict mode is not enabled in your ${q(f.file)}.`);let e=await this.prompt.confirm(`ArkEnv requires ${q(`strict`)} mode in your ${q(f.file)}. Would you like to enable it now?`,!0,`Yes (Recommended)`);if(e===null)return null;if(!e)return this.logger.cancel(`Operation cancelled.`),null;d=!0}let p=await this.scanner.detectFramework(t,f.parsed),m=p===`bun-fullstack`?await this.scanner.detectBunFeatures(t,f.parsed):void 0,h=await this.scanner.suggestDefaultEnvPath(t,f.parsed),g=v.resolve(t,h),_=await this.scanner.getEnvExampleKeys(t,f.parsed,g),y=await this.workspace.exists(g),b=await this.prompt.runWizard(l({mode:`existing`,framework:p,bunFeatures:m,defaultEnvPath:h,tsConfig:f.parsed??null,envKeys:_?.keys,envKeysSource:_?.source,hasEnvSchemaFile:y,disableCodegen:e.noCodegen,hostPreset:e.hostPreset}),n);if(b===null)return null;let x=await this.scanner.hasSkill(t);if(x&&(b.skillDetected=!0,!i&&!a&&this.logger.info(`ArkEnv agent skill detected.`)),x)b.installSkill=!1;else if(a)b.installSkill=!1;else if(n)b.installSkill=!0;else{let e=await this.prompt.confirm(`Would you like to install the ArkEnv agent skill?`,!0,`Yes (Recommended)`);if(e===null)return null;b.installSkill=e}let S=v.resolve(t,b.path);if(b.overwriteEnvSchemaFile===void 0&&await this.workspace.exists(S)){let e=v.basename(S),t=await this.prompt.confirm(`${e} already exist. Overwrite?`,!1);if(t===null)return null;if(!t)return this.logger.cancel(`Operation cancelled.`),null;b.overwriteEnvSchemaFile=t}let C=await this.scanner.detectPackageManager(t,f.parsed),ee=[S],w=[];for(let e of ee)await this.workspace.exists(e)&&w.push(e);let T=v.join(t,`.env`),E=v.join(t,`.env.example`);await this.workspace.exists(T)&&w.push(T),await this.workspace.exists(E)&&(w.push(E),b.envExampleContent=await this.workspace.readFile(E));let D=v.join(t,`.gitignore`);return await this.workspace.exists(D)&&(w.push(D),b.gitignoreContent=await this.workspace.readFile(D)),l({mode:`existing`,cwd:t,options:b,detectedFramework:p,detectedBunFeatures:m,packageManager:C,tsConfig:f,shouldUpdateTsConfig:d,existingFiles:w,isYes:n})}async collectNewProject(e,t=!0){let{isYes:n,example:r,name:i,isForce:a}=e,o=await this.registry.fetchRegistry(),s=await this.prompt.runWizard(l({mode:`new`,examples:o.examples,example:r,name:i}),n);if(s===null)return null;if(s.name===`.`&&!t&&!a)return this.logger.error(`Cannot scaffold into ${q(`.`)} because the current directory is not empty.`),this.logger.info(`Run ${q(`arkenv init`)} in an empty directory or choose a sub-directory name instead.`),this.logger.refuse({code:A.NON_EMPTY_DIR,message:`Cannot scaffold into the current directory because it is not empty.`,why:`Run arkenv init in an empty directory or choose a sub-directory name instead, or use --force.`,retryWith:[`--force`],nextActions:[{kind:`run-command`,label:`Re-run with --force to scaffold into non-empty directory`,command:`{bin} init --force`}]},`init`),null;let c=this.detectPackageManager();return l({mode:`new`,cwd:process.cwd(),options:s,detectedFramework:s.framework,packageManager:c,tsConfig:{status:`not_found`},shouldUpdateTsConfig:!1,existingFiles:[],isYes:n})}detectPackageManager(){let e=process.env.npm_config_user_agent||``;return e.includes(`pnpm`)?`pnpm`:e.includes(`yarn`)?`yarn`:e.includes(`bun`)?`bun`:`npm`}};function di(e,t={}){let n=new ar(e),r=n.logger,i=new Ln(n.isQuiet,r.stdio,r),a=new nr,o=new gn(r),s=new qt(t.jitiAliases?{jitiAliases:t.jitiAliases}:{});return{cli:n,logger:r,workspace:i,prompt:a,initUseCase:new ui(r,i,a,o),checkUseCase:new lr(r,i,o,s),helpUseCase:new pr(r),schemaLoader:s}}const fi=new Nt({isQuiet:!1,isJson:!1});let pi,mi=!1;async function hi(){if(process.env.INIT_CWD)try{process.chdir(process.env.INIT_CWD)}catch{}let{cli:e,logger:t,initUseCase:n,helpUseCase:r,checkUseCase:i}=di(process.argv);pi=t,gi(t,e.command),e.validationError&&(t.error(e.validationError),await r.execute(),await t.flush(),process.exit(2)),e.helpRequested&&(await r.execute(),await t.flush(),process.exit(0));let a=e.command?{init:()=>n.execute(l(e.initInput)),check:()=>i.execute(e.checkInput)}[e.command]:void 0;a||(e.command?t.error(`Unknown command: ${e.command}`):t.error(`Missing command.`),await r.execute(),await t.flush(),process.exit(2));try{let e=await a();typeof e==`number`&&(await t.flush(),process.exit(e)),e||(await t.flush(),process.exit(2)),await t.flush(),process.exit(0)}catch(n){try{t.fatal(`An unexpected error occurred`,n,e.command||`cli`)}catch{}await t.flush(),process.exit(1)}}function gi(e,t){let n=async n=>{mi&&process.exit(n),mi=!0,setTimeout(()=>{process.exit(n)},2e3).unref(),e.interactiveStdout&&e.interactiveStdout(!1);try{e.cancel(`Operation cancelled.`,t),await e.flush()}catch(t){e.error&&e.error(`Logger failed during shutdown`,t)}finally{process.exit(n===130?3:n)}};process.on(`SIGINT`,()=>n(130)),process.on(`SIGTERM`,()=>n(143))}hi(),process.on(`unhandledRejection`,async e=>{let t=pi??fi;try{t.fatal(`Unhandled rejection`,e)}catch{}await t.flush(),process.exit(1)}),process.on(`uncaughtException`,async e=>{let t=pi??fi;try{t.fatal(`Uncaught exception`,e)}catch{}await t.flush(),process.exit(1)});export{};
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
const e=`ArkEnvError`,t=(e,t=2,{dontDetectNewlines:n=!1}={})=>n?`${` `.repeat(t)}${e}`:e.split(`
|
|
2
|
+
`).map(e=>`${` `.repeat(t)}${e}`).join(`
|
|
3
|
+
`),n={red:`\x1B[31m`,yellow:`\x1B[33m`,cyan:`\x1B[36m`,reset:`\x1B[0m`},r=()=>typeof process<`u`&&process.versions!=null&&process.versions.node!=null,i=()=>!!(!r()||process.env.NO_COLOR!==void 0||process.env.CI!==void 0||process.stdout&&!process.stdout.isTTY),a=(e,t)=>r()&&!i()?`${n[e]}${t}${n.reset}`:t;function o(e){return e.map(e=>`${a(`yellow`,e.path)} ${e.message.trimStart()}`).join(`
|
|
4
|
+
`)}Object.defineProperty(class extends Error{constructor(n,r=`Errors found while validating environment variables`){let i=o(n);super(`${a(`red`,r)}\n${t(i)}\n`),this.name=e,this.issues=n}},`name`,{value:e});const s=/secret|(_|^)key(_|$)|token|(_|^)password(_|$)|(_|^)pass(_|$)|(_|^)auth(_|$)|jwt|cert|credential|database_url|db_url/i;function c(e){if(e!==void 0)return e;if(typeof process>`u`)return!1;let t=process.env.ARKENV_DEBUG_SECRETS;return t===`true`||t===`1`}function l(e){return s.test(e)&&!/public/i.test(e)}function u(e,t,n){let r=c(n?.debugSecrets);if(e===void 0)return`missing`;if(e===null)return`null`;if(!r&&l(t))return`[REDACTED]`;if(typeof e==`string`)return JSON.stringify(e);if(typeof e==`number`||typeof e==`boolean`||typeof e==`bigint`)return String(e);if(typeof e==`symbol`)return e.toString();if(typeof e==`function`)return`[Function]`;if(e&&typeof e==`object`)try{if(Array.isArray(e)){let r=e.slice(0,3).map(e=>u(e,t,n));return e.length>3&&r.push(`...(+${e.length-3} more)`),`[${r.join(`, `)}]`}let r=Object.keys(e),i=r.slice(0,3).map(r=>`${r}: ${u(e[r],t,n)}`);return r.length>3&&i.push(`...(+${r.length-3} more)`),`{ ${i.join(`, `)} }`}catch{return Object.prototype.toString.call(e)}return String(e)}function d(e){if(!e||typeof e!=`object`&&typeof e!=`function`)return[];if(e.json&&typeof e.json==`object`&&e.json.domain===`object`){let t=[];if(Array.isArray(e.json.required))for(let n of e.json.required)n&&typeof n==`object`&&`key`in n&&t.push(n.key);if(Array.isArray(e.json.optional))for(let n of e.json.optional)n&&typeof n==`object`&&`key`in n&&t.push(n.key);return t}let t=e[`~standard`],n=typeof t?.jsonSchema?.input==`function`&&t.jsonSchema.input||typeof e.jsonSchema?.input==`function`&&e.jsonSchema.input;if(n)try{let e=n({target:`draft-07`});if(e&&typeof e==`object`&&e.properties)return Object.keys(e.properties)}catch{}if(typeof e.toJSONSchema==`function`)try{let t=e.toJSONSchema();if(t&&typeof t==`object`&&t.properties)return Object.keys(t.properties)}catch{}if(typeof e.toStandardJSONSchema?.v1==`function`)try{let t=e.toStandardJSONSchema.v1();if(t&&typeof t==`object`&&t.properties)return Object.keys(t.properties)}catch{}return Object.keys(e)}const f=Symbol.for(`arkenv.schemaCapture.v1`);function p(){let e=globalThis;return e[f]||(e[f]={capturing:!1,definitions:[]}),e[f]}function m(){let e=p();e.capturing=!0,e.definitions=[]}function h(){let e=p();e.capturing=!1;let t=e.definitions.slice();return e.definitions=[],t}function g(e){return`[ArkEnv] ${e}`}export{d as a,u as c,o as i,l,h as n,t as o,g as r,c as s,m as t};
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
//#region src/index.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* @deprecated The 'arkenv' package is exclusively an interactive CLI in v1.0.0+.
|
|
4
|
+
* If you want to validate environment variables in your code, please install and import '@arkenv/core' (or '@arkenv/standard') instead, or run `npx arkenv init`.
|
|
5
|
+
*/
|
|
6
|
+
declare const arkenv: never;
|
|
7
|
+
/**
|
|
8
|
+
* @deprecated The 'arkenv' package is exclusively an interactive CLI in v1.0.0+.
|
|
9
|
+
* If you want to validate environment variables in your code, please install and import '@arkenv/core' (or '@arkenv/standard') instead, or run `npx arkenv init`.
|
|
10
|
+
*/
|
|
11
|
+
type Arkenv = never;
|
|
12
|
+
//#endregion
|
|
13
|
+
export { Arkenv, arkenv, arkenv as default };
|
package/dist/index.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{r as e}from"./dist-iC9ZVx-X.js";throw Error(`🚨 ${e("You imported the 'arkenv' package as a library. Starting with v1.0.0, the 'arkenv' package is exclusively the interactive CLI. If you want to validate environment variables in your code, please install and import '@arkenv/core' (or '@arkenv/standard') instead, or run `npx arkenv init` to guide you through setup.")}`);export{};
|