twenty 0.2.0 → 2.46.0

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.
Files changed (183) hide show
  1. package/CONTRIBUTING.md +166 -0
  2. package/LICENSE +21 -0
  3. package/README.md +64 -57
  4. package/dist/app-template/.nvmrc +1 -0
  5. package/dist/app-template/.oxlintrc.json +37 -0
  6. package/dist/app-template/AGENTS.md +70 -0
  7. package/dist/app-template/CHANGELOG.md +7 -0
  8. package/dist/app-template/README.md +34 -0
  9. package/dist/app-template/SETUP.md +47 -0
  10. package/dist/app-template/github/workflows/cd.yml +42 -0
  11. package/dist/app-template/github/workflows/ci.yml +60 -0
  12. package/dist/app-template/github/workflows/publish.yml +52 -0
  13. package/dist/app-template/gitignore +43 -0
  14. package/dist/app-template/locales/en.json +1 -0
  15. package/dist/app-template/package.json +36 -0
  16. package/dist/app-template/public/logo.svg +7 -0
  17. package/dist/app-template/src/__tests__/application-config.test.ts +14 -0
  18. package/dist/app-template/src/__tests__/global-setup.ts +56 -0
  19. package/dist/app-template/src/__tests__/run-twenty.ts +66 -0
  20. package/dist/app-template/src/__tests__/schema.integration-test.ts +46 -0
  21. package/dist/app-template/src/application-config.ts +13 -0
  22. package/dist/app-template/src/constants/universal-identifiers.ts +12 -0
  23. package/dist/app-template/src/default-role.ts +16 -0
  24. package/dist/app-template/src/front-components/main-page.tsx +287 -0
  25. package/dist/app-template/src/logic-functions/health-check.ts +11 -0
  26. package/dist/app-template/src/navigation-menu-items/main-page.navigation-menu-item.ts +19 -0
  27. package/dist/app-template/src/page-layouts/main-page.page-layout.ts +42 -0
  28. package/dist/app-template/tsconfig.json +37 -0
  29. package/dist/app-template/tsconfig.spec.json +9 -0
  30. package/dist/app-template/vitest.config.ts +31 -0
  31. package/dist/app-template/vitest.unit.config.ts +14 -0
  32. package/dist/app-template/yarn.lock +3374 -0
  33. package/dist/app-template/yarnrc.yml +1 -0
  34. package/dist/app-worker.cjs +1 -0
  35. package/dist/chunks/application-DuIJE2qG.cjs +5 -0
  36. package/dist/chunks/assert-pull-paths-BuQ1ZRvQ.cjs +1 -0
  37. package/dist/chunks/build-CX6FBrbu.cjs +1 -0
  38. package/dist/chunks/build-pull-entities-zwArrVMk.cjs +5 -0
  39. package/dist/chunks/build-source-manifest-CLKH5vzc.cjs +2 -0
  40. package/dist/chunks/build-source-snapshot-CbGsy1-v.cjs +206 -0
  41. package/dist/chunks/check-node-requirement-mqwNPktb.cjs +1 -0
  42. package/dist/chunks/cli-error-CSsayo0u.cjs +1 -0
  43. package/dist/chunks/cli-version.constant-aSp8WZDh.cjs +1 -0
  44. package/dist/chunks/collect-watch-inputs-B9jWG4W0.cjs +1 -0
  45. package/dist/chunks/compile-application-translations-B59jYVWc.cjs +1 -0
  46. package/dist/chunks/config-file-mode.constant-DLBzKKUl.cjs +1 -0
  47. package/dist/chunks/confirm-in-terminal-BxEM5lxE.cjs +1 -0
  48. package/dist/chunks/constants-CL6mrTMT-B748cNNG.cjs +23 -0
  49. package/dist/chunks/constants-Cf5-CwMu.cjs +1 -0
  50. package/dist/chunks/convert-to-label-BPBLtc_O.cjs +1 -0
  51. package/dist/chunks/create-app-not-installed-error-Cc8YZqI7.cjs +1 -0
  52. package/dist/chunks/create-cancelled-error-DgrNfOv2.cjs +1 -0
  53. package/dist/chunks/create-http-status-error-D3gy3DzB.cjs +1 -0
  54. package/dist/chunks/create-metadata-client-ChjDalSi.cjs +6 -0
  55. package/dist/chunks/create-pull-base-write-rxjcKtD-.cjs +1 -0
  56. package/dist/chunks/create-rest-client-eAfOFfDA.cjs +58 -0
  57. package/dist/chunks/create-tooling-failure-DLI5FlQP.cjs +1 -0
  58. package/dist/chunks/credential-kind-labels.constant-CKdoQF8o.cjs +1 -0
  59. package/dist/chunks/extract-manifest-from-file-j-Y9wNas.cjs +1 -0
  60. package/dist/chunks/fetch-metadata-inspection-Dp034TpK.cjs +1 -0
  61. package/dist/chunks/fetch-signed-in-identity-BhvaL3zp.cjs +1 -0
  62. package/dist/chunks/fetch-workspace-id-DJStmf_V.cjs +1 -0
  63. package/dist/chunks/find-remote-D48r20g0.cjs +1 -0
  64. package/dist/chunks/format-app-duration-gu2oRLB4.cjs +1 -0
  65. package/dist/chunks/format-body-VcKL4WXt.cjs +1 -0
  66. package/dist/chunks/format-data-value-B6rIbpJv.cjs +1 -0
  67. package/dist/chunks/format-details-COEwKz_M.cjs +2 -0
  68. package/dist/chunks/format-metadata-fields-DJnTg1R9.cjs +2 -0
  69. package/dist/chunks/format-metadata-owner-yUeocnwY.cjs +1 -0
  70. package/dist/chunks/format-table-4drtI5sP.cjs +2 -0
  71. package/dist/chunks/fs-utils-Bl1fQcaJ.cjs +2 -0
  72. package/dist/chunks/generate-application-client-CCVLjxTj.cjs +1 -0
  73. package/dist/chunks/get-app-plan-summary-B0uwHXbO.cjs +8 -0
  74. package/dist/chunks/get-config-path-C-D-QHuX.cjs +1 -0
  75. package/dist/chunks/get-credential-kind-JI9heHe2.cjs +1 -0
  76. package/dist/chunks/get-function-input-schema-GNk3NRLJ-Bfph1o9z.cjs +1 -0
  77. package/dist/chunks/get-tooling-error-context-C69TBSej.cjs +1 -0
  78. package/dist/chunks/global-flags.constant-8GfW0sNU.cjs +1 -0
  79. package/dist/chunks/has-yarn-plug-and-play-X3ay5Xl0.cjs +1 -0
  80. package/dist/chunks/is-access-token-expiring-gICPXsbO.cjs +1 -0
  81. package/dist/chunks/is-application-not-found-error-mNeGbxmT.cjs +1 -0
  82. package/dist/chunks/is-exported-manifest-CriNOWvx.cjs +1 -0
  83. package/dist/chunks/is-inside-directory-t3ixLQDr.cjs +1 -0
  84. package/dist/chunks/is-interaction-allowed-ycbAFMIj.cjs +1 -0
  85. package/dist/chunks/is-same-universal-identifier-BCBib3RP.cjs +1 -0
  86. package/dist/chunks/is-supported-locale-BAjnKnKj.cjs +20 -0
  87. package/dist/chunks/kebab-case-D0usAzG-.cjs +1 -0
  88. package/dist/chunks/list-application-source-files-jEau5Rie.cjs +1 -0
  89. package/dist/chunks/metadata-D9sQOTRK.cjs +1 -0
  90. package/dist/chunks/metadata-page.constant-BkG4ndrO.cjs +1 -0
  91. package/dist/chunks/oauth-timing.constant-BClMQcKn.cjs +1 -0
  92. package/dist/chunks/open-browser-LPuVspT7.cjs +1 -0
  93. package/dist/chunks/package-CdYv4LEx.cjs +1 -0
  94. package/dist/chunks/parse-api-url-BllxRdpE.cjs +1 -0
  95. package/dist/chunks/parse-app-export-BkfflyUY.cjs +1 -0
  96. package/dist/chunks/parse-graphql-response-CtP9KTS2.cjs +1 -0
  97. package/dist/chunks/parse-json-input-CvMTKAWw.cjs +1 -0
  98. package/dist/chunks/print-typescript-value-DhElcFzI.cjs +3 -0
  99. package/dist/chunks/pull-source-eoiJwFb9.cjs +1 -0
  100. package/dist/chunks/read-app-identity-SeleQ_D6.cjs +1 -0
  101. package/dist/chunks/read-application-identity-BFg_p84F.cjs +1 -0
  102. package/dist/chunks/read-command-values-uSJqBG_E.cjs +1 -0
  103. package/dist/chunks/read-config-DUJ27809.cjs +1 -0
  104. package/dist/chunks/read-input-value-Cxgh_r2g.cjs +1 -0
  105. package/dist/chunks/read-source-identity-C8LG1v6U.cjs +1 -0
  106. package/dist/chunks/read-watch-input-stamp-BxeOb0vI.cjs +1 -0
  107. package/dist/chunks/record-pull-base-BbxvlnU8.cjs +1 -0
  108. package/dist/chunks/record-typecheck-config-inputs-BDqkKCrj.cjs +1 -0
  109. package/dist/chunks/request-oauth-tokens-C4KKlTQT.cjs +1 -0
  110. package/dist/chunks/request-timeout-milliseconds.constant-DtyQHrll.cjs +1 -0
  111. package/dist/chunks/require-approval-fhegB1ap.cjs +1 -0
  112. package/dist/chunks/resolve-app-project-D5ZXIpsG.cjs +1 -0
  113. package/dist/chunks/resolve-inside-sdk-p-16gKb4.cjs +1 -0
  114. package/dist/chunks/resolve-metadata-object-QoDi-Aik.cjs +1 -0
  115. package/dist/chunks/resolve-project-typescript-CDY8BbmP.cjs +1 -0
  116. package/dist/chunks/resolve-request-url-jC5kYwkn.cjs +1 -0
  117. package/dist/chunks/resolve-source-sdk-mK-f4q55.cjs +1 -0
  118. package/dist/chunks/result-item-limit.constant-CDrOhiWD.cjs +1 -0
  119. package/dist/chunks/run-api-graphql-command-Biy0WqXa.cjs +1 -0
  120. package/dist/chunks/run-api-rest-command-D9kdQceV.cjs +1 -0
  121. package/dist/chunks/run-app-add-command-DcTQg7Si.cjs +163 -0
  122. package/dist/chunks/run-app-apply-command-DwLPPJ-Y.cjs +2 -0
  123. package/dist/chunks/run-app-build-command-BRYb0one.cjs +2 -0
  124. package/dist/chunks/run-app-dev-command-CVeh9Gab.cjs +2 -0
  125. package/dist/chunks/run-app-exec-command-DKLNLbL5.cjs +3 -0
  126. package/dist/chunks/run-app-init-command-CJj8_spC.cjs +2 -0
  127. package/dist/chunks/run-app-logs-command-Dusb8K-W.cjs +9 -0
  128. package/dist/chunks/run-app-operation-BWrY9YZK.cjs +1 -0
  129. package/dist/chunks/run-app-plan-command-C0_3e332.cjs +1 -0
  130. package/dist/chunks/run-app-pull-command-DcZqs8gR.cjs +3 -0
  131. package/dist/chunks/run-app-typecheck-command-C8LqpOej.cjs +1 -0
  132. package/dist/chunks/run-app-uninstall-command-ncWS_k-p.cjs +2 -0
  133. package/dist/chunks/run-auth-login-command-_zDgRcth.cjs +1 -0
  134. package/dist/chunks/run-auth-logout-command-BO6O7GVi.cjs +2 -0
  135. package/dist/chunks/run-auth-status-command-Cj-vqoHg.cjs +1 -0
  136. package/dist/chunks/run-auth-token-command-D4geJ-rx.cjs +1 -0
  137. package/dist/chunks/run-cli-c9TOR0zj.cjs +23 -0
  138. package/dist/chunks/run-commands-command-C6gvMpQ_.cjs +2 -0
  139. package/dist/chunks/run-data-get-command-jDEU4EG1.cjs +1 -0
  140. package/dist/chunks/run-data-list-command-EnCdbuzc.cjs +1 -0
  141. package/dist/chunks/run-doctor-command-DnJ6io-m.cjs +2 -0
  142. package/dist/chunks/run-metadata-field-describe-command-vJngpw2S.cjs +3 -0
  143. package/dist/chunks/run-metadata-field-list-command-CR4w7fI6.cjs +3 -0
  144. package/dist/chunks/run-metadata-object-describe-command-CHP8K-W2.cjs +3 -0
  145. package/dist/chunks/run-metadata-object-list-command-BqXMcAp6.cjs +2 -0
  146. package/dist/chunks/run-open-command-DKl8acw0.cjs +1 -0
  147. package/dist/chunks/run-remote-list-command-DeAzr5Mn.cjs +1 -0
  148. package/dist/chunks/run-remote-remove-command-D0C5sWjP.cjs +2 -0
  149. package/dist/chunks/run-remote-rename-command-Byq9WRHd.cjs +1 -0
  150. package/dist/chunks/run-remote-use-command-B6VVDlMG.cjs +1 -0
  151. package/dist/chunks/run-version-command-BmSk8PUV.cjs +1 -0
  152. package/dist/chunks/select-target-C1VZjf-A.cjs +1 -0
  153. package/dist/chunks/sign-in-to-remote-again-CW8HPSTP.cjs +1 -0
  154. package/dist/chunks/sign-in-with-browser-C3kC6uP2.cjs +1 -0
  155. package/dist/chunks/style-BR52fK4V.cjs +1 -0
  156. package/dist/chunks/target-environment-variable.constant-D7z8AihP.cjs +1 -0
  157. package/dist/chunks/to-cli-error-BBYf_wqo.cjs +1 -0
  158. package/dist/chunks/to-public-target-CIAwoOKL.cjs +1 -0
  159. package/dist/chunks/to-worker-output-diagnostics-lprh9b0l.cjs +2 -0
  160. package/dist/chunks/typecheck-application-DGrovgX9.cjs +2 -0
  161. package/dist/chunks/undici-D3mKdfwl.cjs +95 -0
  162. package/dist/chunks/update-config-BkKBEfAp.cjs +1 -0
  163. package/dist/chunks/utils-B8EXJeaX-DK3gCslL.cjs +33 -0
  164. package/dist/chunks/validate-app-path-Dau-PC0a.cjs +1 -0
  165. package/dist/chunks/validate-remote-name-w-qnr43w.cjs +1 -0
  166. package/dist/chunks/write-config-atomically-DRWTukU-.cjs +1 -0
  167. package/dist/cli.cjs +2 -0
  168. package/docs/commands.md +564 -0
  169. package/package.json +41 -18
  170. package/src/app/README.md +43 -0
  171. package/src/app/add/README.md +69 -0
  172. package/src/app/bundles/README.md +85 -0
  173. package/src/app/client/README.md +62 -0
  174. package/src/app/dev/README.md +35 -0
  175. package/src/app/exec/README.md +48 -0
  176. package/src/app/function-logs/README.md +44 -0
  177. package/src/app/manifest/README.md +74 -0
  178. package/src/app/pull/README.md +28 -0
  179. package/src/app/source/README.md +33 -0
  180. package/src/app/typecheck/README.md +67 -0
  181. package/.npmignore +0 -2
  182. package/bin/twenty +0 -2
  183. package/index.js +0 -118
@@ -0,0 +1 @@
1
+ const e=require("./constants-CL6mrTMT-B748cNNG.cjs"),t=require("./cli-error-CSsayo0u.cjs"),n=require("./parse-api-url-BllxRdpE.cjs"),r=require("./read-command-values-uSJqBG_E.cjs"),i=require("./read-input-value-Cxgh_r2g.cjs"),a=require("./is-interaction-allowed-ycbAFMIj.cjs"),o=require("./style-BR52fK4V.cjs"),s=require("./get-config-path-C-D-QHuX.cjs"),c=require("./read-config-DUJ27809.cjs"),l=require("./sign-in-with-browser-C3kC6uP2.cjs"),u=require("./update-config-BkKBEfAp.cjs"),d=require("./validate-remote-name-w-qnr43w.cjs"),f=require("./fetch-signed-in-identity-BhvaL3zp.cjs");var p=`Pipe it in, for example: printf '%s' "$TWENTY_API_KEY" | twenty auth login --with-token --url <url>`,m=async e=>{if(process.stdin.isTTY===!0)throw new t.t({code:`USAGE`,exitCode:t.n.USAGE,message:`The API key must come from standard input.`,hint:p});let n=(await i.t({value:`-`,optionName:`the API key`,signal:e})).trim();if(n===``||/\s/.test(n))throw new t.t({code:`USAGE`,exitCode:t.n.USAGE,message:n===``?`Standard input is empty.`:`Standard input must contain only the API key.`,hint:p});return n},h=(e,t)=>Object.hasOwn(e.remotes,t)?e.remotes[t]:void 0,g=({existingRemote:r,remoteName:i,apiUrl:a,replace:o})=>{if(!(!e.zt(r)||o||n.t({rawUrl:r.apiUrl,sourceName:i})===a))throw new t.t({code:`CONFIRMATION_REQUIRED`,exitCode:t.n.USAGE,message:`Remote ${i} points to ${r.apiUrl}.`,hint:`Pass --replace to point it at ${a}.`})},_=async({options:e,apiUrl:n,output:i,outputMode:o,signal:s})=>{if(r.t(e,`withToken`))return{kind:`apiKey`,apiKey:await m(s)};if(!a.t({options:e,outputMode:o}))throw new t.t({code:`USAGE`,exitCode:t.n.USAGE,message:`Browser sign-in only runs in an interactive terminal, not with --no-input, JSON output, redirected stdin or in CI.`,hint:`In scripts and CI, retry this command with --with-token and pipe an API key on standard input.`});return{kind:`oauth`,...await l.t({apiUrl:n,output:i,signal:s})}},v=({remoteName:t,apiUrl:n,credentials:r,identity:i})=>{let a=e.zt(i.workspaceName)?` · workspace ${i.workspaceName}`:``;return r.kind===`apiKey`?`Saved remote "${t}" ${o.i(`(${n}) · API key${a}`)}`:`Signed in to "${t}"${e.zt(i.email)?` as ${i.email}`:``}${o.i(a)}`},y=async({options:i,output:a,outputMode:p,signal:m})=>{let y=r.r(i,`name`)??r.r(i,`remote`),b=d.t(y??`default`),x=r.t(i,`replace`),S=s.t(),C=await c.t(S),w=h(C,b),T=r.r(i,`url`);if(!e.zt(T)&&!e.zt(w))throw new t.t({code:`USAGE`,exitCode:t.n.USAGE,message:Object.keys(C.remotes).length===0?`No saved connections yet.`:`There is no remote named "${b}" yet.`,hint:e.zt(y)?`Pass --url to create it.`:`Run twenty auth login --url <url> to save a connection.`});let E=e.zt(T)?n.t({rawUrl:T,sourceName:`--url`}):n.t({rawUrl:w?.apiUrl??``,sourceName:`The URL of remote ${b}`});g({existingRemote:w,remoteName:b,apiUrl:E,replace:x});let D=await _({options:i,apiUrl:E,output:a,outputMode:p,signal:m}),O=await f.t({target:{apiUrl:E,bearerToken:D.kind===`apiKey`?D.apiKey:D.accessToken,credentialKind:D.kind,source:`remote`,remoteName:b},signal:m}).catch(e=>{throw e instanceof t.t&&e.code===`AUTH_REQUIRED`?new t.t({code:`AUTH_REQUIRED`,exitCode:t.n.AUTHENTICATION,message:`${E} rejected ${D.kind===`apiKey`?`this API key`:`the new session`}. Nothing was saved.`,hint:D.kind===`apiKey`?`Check the key and that it belongs to a workspace on this server.`:`Run twenty auth login again.`,details:e.details}):e}),k=await u.t({configPath:S,signal:m,update:t=>{let n=h(t,b);g({existingRemote:n,remoteName:b,apiUrl:E,replace:x});let a=e.zt(t.defaultRemote)&&Object.hasOwn(t.remotes,t.defaultRemote),o=r.t(i,`use`)||!a?b:t.defaultRemote;return{result:o===b,config:{...t,defaultRemote:o,remotes:{...t.remotes,[b]:{...l.n({remote:n??{apiUrl:E},credentials:D}),apiUrl:E,...e.zt(O.workspaceName)?{workspaceName:O.workspaceName}:{}}}}}}});return{data:{remote:b,apiUrl:E,credentials:D.kind,workspaceName:O.workspaceName,email:O.email,isDefault:k},human:o.o(v({remoteName:b,apiUrl:E,credentials:D,identity:O}))}};exports.runAuthLoginCommand=y;
@@ -0,0 +1,2 @@
1
+ const e=require("./cli-error-CSsayo0u.cjs"),t=require("./read-command-values-uSJqBG_E.cjs"),n=require("./target-environment-variable.constant-D7z8AihP.cjs"),r=require("./style-BR52fK4V.cjs"),i=require("./select-target-C1VZjf-A.cjs"),a=require("./get-config-path-C-D-QHuX.cjs"),o=require("./read-config-DUJ27809.cjs"),s=require("./find-remote-D48r20g0.cjs"),c=require("./update-config-BkKBEfAp.cjs"),l=require("./get-credential-kind-JI9heHe2.cjs");var u=async({options:u,output:d,signal:f})=>{let p=a.t(),m=await i.t({environment:process.env,remoteFlag:t.r(u,`remote`),loadConfig:()=>o.t(p),warn:d.warn});if(m.source===`environment`)throw new e.t({code:`USAGE`,exitCode:e.n.USAGE,message:`${n.t.API_URL} and ${n.t.API_KEY} are not saved, so there is nothing to sign out of.`,hint:`Unset them in your shell, or pick a saved remote with --remote.`});let{remoteName:h}=m,g=await c.t({configPath:p,signal:f,update:e=>{let t=s.t(e,h),{apiKey:n,twentyCLIAccessToken:r,twentyCLIRefreshToken:i,...a}=t;return{result:l.t(t)!==`none`,config:{...e,remotes:{...e.remotes,[h]:a}}}}});return{data:{remote:h,wasSignedIn:g},human:g?[r.o(`Signed out of ${h}.`),`${r.i(` The remote stays; sign in with `)}${r.r(`twenty auth login --remote ${h} --with-token`)}`].join(`
2
+ `):`${h} was already signed out.`}};exports.runAuthLogoutCommand=u;
@@ -0,0 +1 @@
1
+ const e=require("./constants-CL6mrTMT-B748cNNG.cjs"),t=require("./target-environment-variable.constant-D7z8AihP.cjs"),n=require("./style-BR52fK4V.cjs"),r=require("./format-details-COEwKz_M.cjs"),i=require("./get-config-path-C-D-QHuX.cjs"),a=require("./read-config-DUJ27809.cjs"),o=require("./fetch-signed-in-identity-BhvaL3zp.cjs"),s=require("./credential-kind-labels.constant-CKdoQF8o.cjs"),c=require("./is-access-token-expiring-gICPXsbO.cjs");var l=6e4,u=e=>{let t=Math.max(0,Math.round((e-Date.now())/l));return t<120?`${t} minutes`:`${Math.round(t/60)} hours`},d=async({target:l,signal:d})=>{let f=await o.t({target:l,signal:d}),p=e.zt(l.remoteName)&&(await a.t(i.t())).defaultRemote===l.remoteName,m=l.credentialKind===`oauth`?c.t(l.bearerToken):void 0,h=e.zt(l.remoteName)?`${l.remoteName}${p?n.i(` (default)`):``}`:n.i(`none, using ${t.t.API_URL} and ${t.t.API_KEY}`),g=e.zt(f.email)?`${f.email} ${n.i(`via ${s.t[l.credentialKind]}`)}`:s.t[l.credentialKind],_=n.n(`green`,`valid`);return{data:{remote:l.remoteName??null,isDefaultRemote:p,apiUrl:l.apiUrl,source:l.source,credentials:l.credentialKind,email:f.email,workspaceName:f.workspaceName,sessionExpiresAt:e.zt(m)?new Date(m).toISOString():null},human:r.t([[`Remote`,h],[`Server`,l.apiUrl],[`Workspace`,f.workspaceName??n.i(`unnamed`)],[`Signed in`,g],[`Status`,e.zt(m)?`${_} ${n.i(`· renews itself, current token expires in ${u(m)}`)}`:_]])}};exports.runAuthStatusCommand=d;
@@ -0,0 +1 @@
1
+ var e=async({target:e})=>({data:{token:e.bearerToken,credentials:e.credentialKind},human:e.bearerToken});exports.runAuthTokenCommand=e;
@@ -0,0 +1,23 @@
1
+ const e=require("./build-CX6FBrbu.cjs"),t=require("./constants-CL6mrTMT-B748cNNG.cjs"),n=require("./utils-B8EXJeaX-DK3gCslL.cjs"),r=require("./cli-error-CSsayo0u.cjs"),i=require("./parse-api-url-BllxRdpE.cjs"),a=require("./read-command-values-uSJqBG_E.cjs"),o=require("./target-environment-variable.constant-D7z8AihP.cjs"),s=require("./is-interaction-allowed-ycbAFMIj.cjs"),c=require("./style-BR52fK4V.cjs"),l=require("./to-cli-error-BBYf_wqo.cjs"),u=require("./cli-version.constant-aSp8WZDh.cjs"),d=require("./to-public-target-CIAwoOKL.cjs"),f=require("./select-target-C1VZjf-A.cjs"),p=require("./get-config-path-C-D-QHuX.cjs"),m=require("./read-config-DUJ27809.cjs"),h=require("./write-config-atomically-DRWTukU-.cjs"),g=require("./request-oauth-tokens-C4KKlTQT.cjs"),ee=require("./get-credential-kind-JI9heHe2.cjs"),_=require("./is-access-token-expiring-gICPXsbO.cjs"),v=require("./global-flags.constant-8GfW0sNU.cjs");let y=require("node:events");var b=e.t(),x=async(e,t)=>{t.throwIfAborted(),process.stdout.write(`${JSON.stringify(e)}\n`)||await(0,y.once)(process.stdout,`drain`,{signal:t}),t.throwIfAborted()},S=(e,t)=>{e.write(t.endsWith(`
2
+ `)?t:`${t}\n`)},C=e=>{S(process.stdout,JSON.stringify(e))},w=e=>e.split(`
3
+ `).map(e=>(0,b.isNonEmptyString)(e)?` ${e}`:e).join(`
4
+ `),T=e=>t.zt(e)?{target:e}:{},E=({mode:e,command:n})=>{let r=[],i=0,a=(e,t)=>{i+=1,C({schemaVersion:1,command:n,type:e,sequence:i,data:t})},o=()=>{for(let e of r)S(process.stderr,c.s(e.message))};return{event:async(t,r,a)=>{e===`ndjson`&&(i+=1,await x({schemaVersion:1,command:n,type:t,sequence:i,data:r},a))},progress:t=>{if(e===`ndjson`){a(`progress`,{message:t});return}S(process.stderr,t)},warn:t=>{if(e===`ndjson`){a(`warning`,t);return}r.push(t)},succeed:({data:t,human:i},s)=>{if(e===`json`){C({schemaVersion:1,ok:!0,command:n,...T(s),data:t,warnings:r});return}if(e===`ndjson`){a(`result`,t);return}let c=i??JSON.stringify(t,null,2);(0,b.isNonEmptyString)(c)&&S(process.stdout,c),o()},fail:(i,s)=>{process.exitCode=i.exitCode;let l={code:i.code,message:i.message,...t.zt(i.hint)?{hint:i.hint}:{},...t.zt(i.details)?{details:i.details}:{}};if(e===`json`){C({schemaVersion:1,ok:!1,command:n,...T(s),error:l,warnings:r});return}if(e===`ndjson`){a(`error`,l);return}S(process.stderr,c.a(i.message)),t.zt(i.hint)&&S(process.stderr,w(i.hint)),o()}}},D=`--format`,te=e=>e.reduce((t,n,r)=>n.startsWith(`${D}=`)?n.slice(9):n===D?e[r+1]:t,void 0),ne=e=>{let t=e.indexOf(`--`),n=t===-1?e:e.slice(0,t),r=te(n);return n.includes(`--json`)||r===`json`?`json`:r===`ndjson`?`ndjson`:`human`},O=class extends Error{commanderError;commandName;operands;constructor({commanderError:e,commandName:t,operands:n}){super(e.message),this.name=`CommandParseError`,this.commanderError=e,this.commandName=t,this.operands=n}},k=`twenty`,A=()=>{let e={standardOutput:``,standardError:``};return{captured:e,configuration:{writeOut:t=>{e.standardOutput+=t},writeErr:t=>{e.standardError+=t},outputError:t=>{e.standardError+=t}}}},j=e.n((e=>{var t=class extends Error{constructor(e,t,n){super(n),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name,this.code=t,this.exitCode=e,this.nestedError=void 0}},n=class extends t{constructor(e){super(1,`commander.invalidArgument`,e),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name}};e.CommanderError=t,e.InvalidArgumentError=n})),M=e.n((e=>{var{InvalidArgumentError:t}=j(),n=class{constructor(e,t){switch(this.description=t||``,this.variadic=!1,this.parseArg=void 0,this.defaultValue=void 0,this.defaultValueDescription=void 0,this.argChoices=void 0,e[0]){case`<`:this.required=!0,this._name=e.slice(1,-1);break;case`[`:this.required=!1,this._name=e.slice(1,-1);break;default:this.required=!0,this._name=e;break}this._name.endsWith(`...`)&&(this.variadic=!0,this._name=this._name.slice(0,-3))}name(){return this._name}_collectValue(e,t){return t===this.defaultValue||!Array.isArray(t)?[e]:(t.push(e),t)}default(e,t){return this.defaultValue=e,this.defaultValueDescription=t,this}argParser(e){return this.parseArg=e,this}choices(e){return this.argChoices=e.slice(),this.parseArg=(e,n)=>{if(!this.argChoices.includes(e))throw new t(`Allowed choices are ${this.argChoices.join(`, `)}.`);return this.variadic?this._collectValue(e,n):e},this}argRequired(){return this.required=!0,this}argOptional(){return this.required=!1,this}};function r(e){let t=e.name()+(e.variadic===!0?`...`:``);return e.required?`<`+t+`>`:`[`+t+`]`}e.Argument=n,e.humanReadableArgName=r})),N=e.n((e=>{var{humanReadableArgName:t}=M(),n=class{constructor(){this.helpWidth=void 0,this.minWidthToWrap=40,this.sortSubcommands=!1,this.sortOptions=!1,this.showGlobalOptions=!1}prepareContext(e){this.helpWidth=this.helpWidth??e.helpWidth??80}visibleCommands(e){let t=e.commands.filter(e=>!e._hidden),n=e._getHelpCommand();return n&&!n._hidden&&t.push(n),this.sortSubcommands&&t.sort((e,t)=>e.name().localeCompare(t.name())),t}compareOptions(e,t){let n=e=>e.short?e.short.replace(/^-/,``):e.long.replace(/^--/,``);return n(e).localeCompare(n(t))}visibleOptions(e){let t=e.options.filter(e=>!e.hidden),n=e._getHelpOption();if(n&&!n.hidden){let r=n.short&&e._findOption(n.short),i=n.long&&e._findOption(n.long);!r&&!i?t.push(n):n.long&&!i?t.push(e.createOption(n.long,n.description)):n.short&&!r&&t.push(e.createOption(n.short,n.description))}return this.sortOptions&&t.sort(this.compareOptions),t}visibleGlobalOptions(e){if(!this.showGlobalOptions)return[];let t=[];for(let n=e.parent;n;n=n.parent){let e=n.options.filter(e=>!e.hidden);t.push(...e)}return this.sortOptions&&t.sort(this.compareOptions),t}visibleArguments(e){return e._argsDescription&&e.registeredArguments.forEach(t=>{t.description=t.description||e._argsDescription[t.name()]||``}),e.registeredArguments.find(e=>e.description)?e.registeredArguments:[]}subcommandTerm(e){let n=e.registeredArguments.map(e=>t(e)).join(` `);return e._name+(e._aliases[0]?`|`+e._aliases[0]:``)+(e.options.length?` [options]`:``)+(n?` `+n:``)}optionTerm(e){return e.flags}argumentTerm(e){return e.name()}longestSubcommandTermLength(e,t){return t.visibleCommands(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleSubcommandTerm(t.subcommandTerm(n)))),0)}longestOptionTermLength(e,t){return t.visibleOptions(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleOptionTerm(t.optionTerm(n)))),0)}longestGlobalOptionTermLength(e,t){return t.visibleGlobalOptions(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleOptionTerm(t.optionTerm(n)))),0)}longestArgumentTermLength(e,t){return t.visibleArguments(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleArgumentTerm(t.argumentTerm(n)))),0)}commandUsage(e){let t=e._name;e._aliases[0]&&(t=t+`|`+e._aliases[0]);let n=``;for(let t=e.parent;t;t=t.parent)n=t.name()+` `+n;return n+t+` `+e.usage()}commandDescription(e){return e.description()}subcommandDescription(e){return e.summary()||e.description()}optionDescription(e){let t=[];if(e.argChoices&&t.push(`choices: ${e.argChoices.map(e=>JSON.stringify(e)).join(`, `)}`),e.defaultValue!==void 0&&(e.required||e.optional||e.isBoolean()&&typeof e.defaultValue==`boolean`)&&t.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),e.presetArg!==void 0&&e.optional&&t.push(`preset: ${JSON.stringify(e.presetArg)}`),e.envVar!==void 0&&t.push(`env: ${e.envVar}`),t.length>0){let n=`(${t.join(`, `)})`;return e.description?`${e.description} ${n}`:n}return e.description}argumentDescription(e){let t=[];if(e.argChoices&&t.push(`choices: ${e.argChoices.map(e=>JSON.stringify(e)).join(`, `)}`),e.defaultValue!==void 0&&t.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),t.length>0){let n=`(${t.join(`, `)})`;return e.description?`${e.description} ${n}`:n}return e.description}formatItemList(e,t,n){return t.length===0?[]:[n.styleTitle(e),...t,``]}groupItems(e,t,n){let r=new Map;return e.forEach(e=>{let t=n(e);r.has(t)||r.set(t,[])}),t.forEach(e=>{let t=n(e);r.has(t)||r.set(t,[]),r.get(t).push(e)}),r}formatHelp(e,t){let n=t.padWidth(e,t),r=t.helpWidth??80;function i(e,r){return t.formatItem(e,n,r,t)}let a=[`${t.styleTitle(`Usage:`)} ${t.styleUsage(t.commandUsage(e))}`,``],o=t.commandDescription(e);o.length>0&&(a=a.concat([t.boxWrap(t.styleCommandDescription(o),r),``]));let s=t.visibleArguments(e).map(e=>i(t.styleArgumentTerm(t.argumentTerm(e)),t.styleArgumentDescription(t.argumentDescription(e))));if(a=a.concat(this.formatItemList(`Arguments:`,s,t)),this.groupItems(e.options,t.visibleOptions(e),e=>e.helpGroupHeading??`Options:`).forEach((e,n)=>{let r=e.map(e=>i(t.styleOptionTerm(t.optionTerm(e)),t.styleOptionDescription(t.optionDescription(e))));a=a.concat(this.formatItemList(n,r,t))}),t.showGlobalOptions){let n=t.visibleGlobalOptions(e).map(e=>i(t.styleOptionTerm(t.optionTerm(e)),t.styleOptionDescription(t.optionDescription(e))));a=a.concat(this.formatItemList(`Global Options:`,n,t))}return this.groupItems(e.commands,t.visibleCommands(e),e=>e.helpGroup()||`Commands:`).forEach((e,n)=>{let r=e.map(e=>i(t.styleSubcommandTerm(t.subcommandTerm(e)),t.styleSubcommandDescription(t.subcommandDescription(e))));a=a.concat(this.formatItemList(n,r,t))}),a.join(`
5
+ `)}displayWidth(e){return r(e).length}styleTitle(e){return e}styleUsage(e){return e.split(` `).map(e=>e===`[options]`?this.styleOptionText(e):e===`[command]`?this.styleSubcommandText(e):e[0]===`[`||e[0]===`<`?this.styleArgumentText(e):this.styleCommandText(e)).join(` `)}styleCommandDescription(e){return this.styleDescriptionText(e)}styleOptionDescription(e){return this.styleDescriptionText(e)}styleSubcommandDescription(e){return this.styleDescriptionText(e)}styleArgumentDescription(e){return this.styleDescriptionText(e)}styleDescriptionText(e){return e}styleOptionTerm(e){return this.styleOptionText(e)}styleSubcommandTerm(e){return e.split(` `).map(e=>e===`[options]`?this.styleOptionText(e):e[0]===`[`||e[0]===`<`?this.styleArgumentText(e):this.styleSubcommandText(e)).join(` `)}styleArgumentTerm(e){return this.styleArgumentText(e)}styleOptionText(e){return e}styleArgumentText(e){return e}styleSubcommandText(e){return e}styleCommandText(e){return e}padWidth(e,t){return Math.max(t.longestOptionTermLength(e,t),t.longestGlobalOptionTermLength(e,t),t.longestSubcommandTermLength(e,t),t.longestArgumentTermLength(e,t))}preformatted(e){return/\n[^\S\r\n]/.test(e)}formatItem(e,t,n,r){let i=` `.repeat(2);if(!n)return i+e;let a=e.padEnd(t+e.length-r.displayWidth(e)),o=(this.helpWidth??80)-t-2-2,s;return s=o<this.minWidthToWrap||r.preformatted(n)?n:r.boxWrap(n,o).replace(/\n/g,`
6
+ `+` `.repeat(t+2)),i+a+` `.repeat(2)+s.replace(/\n/g,`\n${i}`)}boxWrap(e,t){if(t<this.minWidthToWrap)return e;let n=e.split(/\r\n|\n/),r=/[\s]*[^\s]+/g,i=[];return n.forEach(e=>{let n=e.match(r);if(n===null){i.push(``);return}let a=[n.shift()],o=this.displayWidth(a[0]);n.forEach(e=>{let n=this.displayWidth(e);if(o+n<=t){a.push(e),o+=n;return}i.push(a.join(``));let r=e.trimStart();a=[r],o=this.displayWidth(r)}),i.push(a.join(``))}),i.join(`
7
+ `)}};function r(e){return e.replace(/\x1b\[\d*(;\d*)*m/g,``)}e.Help=n,e.stripColor=r})),P=e.n((e=>{var{InvalidArgumentError:t}=j(),n=class{constructor(e,t){this.flags=e,this.description=t||``,this.required=e.includes(`<`),this.optional=e.includes(`[`),this.variadic=/\w\.\.\.[>\]]$/.test(e),this.mandatory=!1;let n=a(e);this.short=n.shortFlag,this.long=n.longFlag,this.negate=!1,this.long&&(this.negate=this.long.startsWith(`--no-`)),this.defaultValue=void 0,this.defaultValueDescription=void 0,this.presetArg=void 0,this.envVar=void 0,this.parseArg=void 0,this.hidden=!1,this.argChoices=void 0,this.conflictsWith=[],this.implied=void 0,this.helpGroupHeading=void 0}default(e,t){return this.defaultValue=e,this.defaultValueDescription=t,this}preset(e){return this.presetArg=e,this}conflicts(e){return this.conflictsWith=this.conflictsWith.concat(e),this}implies(e){let t=e;return typeof e==`string`&&(t={[e]:!0}),this.implied=Object.assign(this.implied||{},t),this}env(e){return this.envVar=e,this}argParser(e){return this.parseArg=e,this}makeOptionMandatory(e=!0){return this.mandatory=!!e,this}hideHelp(e=!0){return this.hidden=!!e,this}_collectValue(e,t){return t===this.defaultValue||!Array.isArray(t)?[e]:(t.push(e),t)}choices(e){return this.argChoices=e.slice(),this.parseArg=(e,n)=>{if(!this.argChoices.includes(e))throw new t(`Allowed choices are ${this.argChoices.join(`, `)}.`);return this.variadic?this._collectValue(e,n):e},this}name(){return this.long?this.long.replace(/^--/,``):this.short.replace(/^-/,``)}attributeName(){return this.negate?i(this.name().replace(/^no-/,``)):i(this.name())}helpGroup(e){return this.helpGroupHeading=e,this}is(e){return this.short===e||this.long===e}isBoolean(){return!this.required&&!this.optional&&!this.negate}},r=class{constructor(e){this.positiveOptions=new Map,this.negativeOptions=new Map,this.dualOptions=new Set,e.forEach(e=>{e.negate?this.negativeOptions.set(e.attributeName(),e):this.positiveOptions.set(e.attributeName(),e)}),this.negativeOptions.forEach((e,t)=>{this.positiveOptions.has(t)&&this.dualOptions.add(t)})}valueFromOption(e,t){let n=t.attributeName();if(!this.dualOptions.has(n))return!0;let r=this.negativeOptions.get(n).presetArg,i=r===void 0?!1:r;return t.negate===(i===e)}};function i(e){return e.split(`-`).reduce((e,t)=>e+t[0].toUpperCase()+t.slice(1))}function a(e){let t,n,r=/^-[^-]$/,i=/^--[^-]/,a=e.split(/[ |,]+/).concat(`guard`);if(r.test(a[0])&&(t=a.shift()),i.test(a[0])&&(n=a.shift()),!t&&r.test(a[0])&&(t=a.shift()),!t&&i.test(a[0])&&(t=n,n=a.shift()),a[0].startsWith(`-`)){let t=a[0],n=`option creation failed due to '${t}' in option flags '${e}'`;throw/^-[^-][^-]/.test(t)?Error(`${n}
8
+ - a short flag is a single dash and a single character
9
+ - either use a single dash and a single character (for a short flag)
10
+ - or use a double dash for a long option (and can have two, like '--ws, --workspace')`):r.test(t)?Error(`${n}
11
+ - too many short flags`):i.test(t)?Error(`${n}
12
+ - too many long flags`):Error(`${n}
13
+ - unrecognised flag format`)}if(t===void 0&&n===void 0)throw Error(`option creation failed due to no flags found in '${e}'.`);return{shortFlag:t,longFlag:n}}e.Option=n,e.DualOptions=r})),re=e.n((e=>{var t=3;function n(e,n){if(Math.abs(e.length-n.length)>t)return Math.max(e.length,n.length);let r=[];for(let t=0;t<=e.length;t++)r[t]=[t];for(let e=0;e<=n.length;e++)r[0][e]=e;for(let t=1;t<=n.length;t++)for(let i=1;i<=e.length;i++){let a=1;a=e[i-1]===n[t-1]?0:1,r[i][t]=Math.min(r[i-1][t]+1,r[i][t-1]+1,r[i-1][t-1]+a),i>1&&t>1&&e[i-1]===n[t-2]&&e[i-2]===n[t-1]&&(r[i][t]=Math.min(r[i][t],r[i-2][t-2]+1))}return r[e.length][n.length]}function r(e,r){if(!r||r.length===0)return``;r=Array.from(new Set(r));let i=e.startsWith(`--`);i&&(e=e.slice(2),r=r.map(e=>e.slice(2)));let a=[],o=t;return r.forEach(t=>{if(t.length<=1)return;let r=n(e,t),i=Math.max(e.length,t.length);(i-r)/i>.4&&(r<o?(o=r,a=[t]):r===o&&a.push(t))}),a.sort((e,t)=>e.localeCompare(t)),i&&(a=a.map(e=>`--${e}`)),a.length>1?`\n(Did you mean one of ${a.join(`, `)}?)`:a.length===1?`\n(Did you mean ${a[0]}?)`:``}e.suggestSimilar=r})),F=e.n((e=>{var t=require("node:events").EventEmitter,n=require("node:child_process"),r=require("node:path"),i=require("node:fs"),a=require("node:process"),{Argument:o,humanReadableArgName:s}=M(),{CommanderError:c}=j(),{Help:l,stripColor:u}=N(),{Option:d,DualOptions:f}=P(),{suggestSimilar:p}=re(),m=class e extends t{constructor(e){super(),this.commands=[],this.options=[],this.parent=null,this._allowUnknownOption=!1,this._allowExcessArguments=!1,this.registeredArguments=[],this._args=this.registeredArguments,this.args=[],this.rawArgs=[],this.processedArgs=[],this._scriptPath=null,this._name=e||``,this._optionValues={},this._optionValueSources={},this._storeOptionsAsProperties=!1,this._actionHandler=null,this._executableHandler=!1,this._executableFile=null,this._executableDir=null,this._defaultCommandName=null,this._exitCallback=null,this._aliases=[],this._combineFlagAndOptionalValue=!0,this._description=``,this._summary=``,this._argsDescription=void 0,this._enablePositionalOptions=!1,this._passThroughOptions=!1,this._lifeCycleHooks={},this._showHelpAfterError=!1,this._showSuggestionAfterError=!0,this._savedState=null,this._outputConfiguration={writeOut:e=>a.stdout.write(e),writeErr:e=>a.stderr.write(e),outputError:(e,t)=>t(e),getOutHelpWidth:()=>a.stdout.isTTY?a.stdout.columns:void 0,getErrHelpWidth:()=>a.stderr.isTTY?a.stderr.columns:void 0,getOutHasColors:()=>g()??(a.stdout.isTTY&&a.stdout.hasColors?.()),getErrHasColors:()=>g()??(a.stderr.isTTY&&a.stderr.hasColors?.()),stripColor:e=>u(e)},this._hidden=!1,this._helpOption=void 0,this._addImplicitHelpCommand=void 0,this._helpCommand=void 0,this._helpConfiguration={},this._helpGroupHeading=void 0,this._defaultCommandGroup=void 0,this._defaultOptionGroup=void 0}copyInheritedSettings(e){return this._outputConfiguration=e._outputConfiguration,this._helpOption=e._helpOption,this._helpCommand=e._helpCommand,this._helpConfiguration=e._helpConfiguration,this._exitCallback=e._exitCallback,this._storeOptionsAsProperties=e._storeOptionsAsProperties,this._combineFlagAndOptionalValue=e._combineFlagAndOptionalValue,this._allowExcessArguments=e._allowExcessArguments,this._enablePositionalOptions=e._enablePositionalOptions,this._showHelpAfterError=e._showHelpAfterError,this._showSuggestionAfterError=e._showSuggestionAfterError,this}_getCommandAndAncestors(){let e=[];for(let t=this;t;t=t.parent)e.push(t);return e}command(e,t,n){let r=t,i=n;typeof r==`object`&&r&&(i=r,r=null),i||={};let[,a,o]=e.match(/([^ ]+) *(.*)/),s=this.createCommand(a);return r&&(s.description(r),s._executableHandler=!0),i.isDefault&&(this._defaultCommandName=s._name),s._hidden=!!(i.noHelp||i.hidden),s._executableFile=i.executableFile||null,o&&s.arguments(o),this._registerCommand(s),s.parent=this,s.copyInheritedSettings(this),r?this:s}createCommand(t){return new e(t)}createHelp(){return Object.assign(new l,this.configureHelp())}configureHelp(e){return e===void 0?this._helpConfiguration:(this._helpConfiguration=e,this)}configureOutput(e){return e===void 0?this._outputConfiguration:(this._outputConfiguration={...this._outputConfiguration,...e},this)}showHelpAfterError(e=!0){return typeof e!=`string`&&(e=!!e),this._showHelpAfterError=e,this}showSuggestionAfterError(e=!0){return this._showSuggestionAfterError=!!e,this}addCommand(e,t){if(!e._name)throw Error(`Command passed to .addCommand() must have a name
14
+ - specify the name in Command constructor or using .name()`);return t||={},t.isDefault&&(this._defaultCommandName=e._name),(t.noHelp||t.hidden)&&(e._hidden=!0),this._registerCommand(e),e.parent=this,e._checkForBrokenPassThrough(),this}createArgument(e,t){return new o(e,t)}argument(e,t,n,r){let i=this.createArgument(e,t);return typeof n==`function`?i.default(r).argParser(n):i.default(n),this.addArgument(i),this}arguments(e){return e.trim().split(/ +/).forEach(e=>{this.argument(e)}),this}addArgument(e){let t=this.registeredArguments.slice(-1)[0];if(t?.variadic)throw Error(`only the last argument can be variadic '${t.name()}'`);if(e.required&&e.defaultValue!==void 0&&e.parseArg===void 0)throw Error(`a default value for a required argument is never used: '${e.name()}'`);return this.registeredArguments.push(e),this}helpCommand(e,t){if(typeof e==`boolean`)return this._addImplicitHelpCommand=e,e&&this._defaultCommandGroup&&this._initCommandGroup(this._getHelpCommand()),this;let[,n,r]=(e??`help [command]`).match(/([^ ]+) *(.*)/),i=t??`display help for command`,a=this.createCommand(n);return a.helpOption(!1),r&&a.arguments(r),i&&a.description(i),this._addImplicitHelpCommand=!0,this._helpCommand=a,(e||t)&&this._initCommandGroup(a),this}addHelpCommand(e,t){return typeof e==`object`?(this._addImplicitHelpCommand=!0,this._helpCommand=e,this._initCommandGroup(e),this):(this.helpCommand(e,t),this)}_getHelpCommand(){return this._addImplicitHelpCommand??(this.commands.length&&!this._actionHandler&&!this._findCommand(`help`))?(this._helpCommand===void 0&&this.helpCommand(void 0,void 0),this._helpCommand):null}hook(e,t){let n=[`preSubcommand`,`preAction`,`postAction`];if(!n.includes(e))throw Error(`Unexpected value for event passed to hook : '${e}'.
15
+ Expecting one of '${n.join(`', '`)}'`);return this._lifeCycleHooks[e]?this._lifeCycleHooks[e].push(t):this._lifeCycleHooks[e]=[t],this}exitOverride(e){return e?this._exitCallback=e:this._exitCallback=e=>{if(e.code!==`commander.executeSubCommandAsync`)throw e},this}_exit(e,t,n){this._exitCallback&&this._exitCallback(new c(e,t,n)),a.exit(e)}action(e){let t=t=>{let n=this.registeredArguments.length,r=t.slice(0,n);return this._storeOptionsAsProperties?r[n]=this:r[n]=this.opts(),r.push(this),e.apply(this,r)};return this._actionHandler=t,this}createOption(e,t){return new d(e,t)}_callParseArg(e,t,n,r){try{return e.parseArg(t,n)}catch(e){if(e.code===`commander.invalidArgument`){let t=`${r} ${e.message}`;this.error(t,{exitCode:e.exitCode,code:e.code})}throw e}}_registerOption(e){let t=e.short&&this._findOption(e.short)||e.long&&this._findOption(e.long);if(t){let n=e.long&&this._findOption(e.long)?e.long:e.short;throw Error(`Cannot add option '${e.flags}'${this._name&&` to command '${this._name}'`} due to conflicting flag '${n}'
16
+ - already used by option '${t.flags}'`)}this._initOptionGroup(e),this.options.push(e)}_registerCommand(e){let t=e=>[e.name()].concat(e.aliases()),n=t(e).find(e=>this._findCommand(e));if(n){let r=t(this._findCommand(n)).join(`|`),i=t(e).join(`|`);throw Error(`cannot add command '${i}' as already have command '${r}'`)}this._initCommandGroup(e),this.commands.push(e)}addOption(e){this._registerOption(e);let t=e.name(),n=e.attributeName();if(e.negate){let t=e.long.replace(/^--no-/,`--`);this._findOption(t)||this.setOptionValueWithSource(n,e.defaultValue===void 0?!0:e.defaultValue,`default`)}else e.defaultValue!==void 0&&this.setOptionValueWithSource(n,e.defaultValue,`default`);let r=(t,r,i)=>{t==null&&e.presetArg!==void 0&&(t=e.presetArg);let a=this.getOptionValue(n);t!==null&&e.parseArg?t=this._callParseArg(e,t,a,r):t!==null&&e.variadic&&(t=e._collectValue(t,a)),t??=e.negate?!1:e.isBoolean()||e.optional?!0:``,this.setOptionValueWithSource(n,t,i)};return this.on(`option:`+t,t=>{r(t,`error: option '${e.flags}' argument '${t}' is invalid.`,`cli`)}),e.envVar&&this.on(`optionEnv:`+t,t=>{r(t,`error: option '${e.flags}' value '${t}' from env '${e.envVar}' is invalid.`,`env`)}),this}_optionEx(e,t,n,r,i){if(typeof t==`object`&&t instanceof d)throw Error(`To add an Option object use addOption() instead of option() or requiredOption()`);let a=this.createOption(t,n);if(a.makeOptionMandatory(!!e.mandatory),typeof r==`function`)a.default(i).argParser(r);else if(r instanceof RegExp){let e=r;r=(t,n)=>{let r=e.exec(t);return r?r[0]:n},a.default(i).argParser(r)}else a.default(r);return this.addOption(a)}option(e,t,n,r){return this._optionEx({},e,t,n,r)}requiredOption(e,t,n,r){return this._optionEx({mandatory:!0},e,t,n,r)}combineFlagAndOptionalValue(e=!0){return this._combineFlagAndOptionalValue=!!e,this}allowUnknownOption(e=!0){return this._allowUnknownOption=!!e,this}allowExcessArguments(e=!0){return this._allowExcessArguments=!!e,this}enablePositionalOptions(e=!0){return this._enablePositionalOptions=!!e,this}passThroughOptions(e=!0){return this._passThroughOptions=!!e,this._checkForBrokenPassThrough(),this}_checkForBrokenPassThrough(){if(this.parent&&this._passThroughOptions&&!this.parent._enablePositionalOptions)throw Error(`passThroughOptions cannot be used for '${this._name}' without turning on enablePositionalOptions for parent command(s)`)}storeOptionsAsProperties(e=!0){if(this.options.length)throw Error(`call .storeOptionsAsProperties() before adding options`);if(Object.keys(this._optionValues).length)throw Error(`call .storeOptionsAsProperties() before setting option values`);return this._storeOptionsAsProperties=!!e,this}getOptionValue(e){return this._storeOptionsAsProperties?this[e]:this._optionValues[e]}setOptionValue(e,t){return this.setOptionValueWithSource(e,t,void 0)}setOptionValueWithSource(e,t,n){return this._storeOptionsAsProperties?this[e]=t:this._optionValues[e]=t,this._optionValueSources[e]=n,this}getOptionValueSource(e){return this._optionValueSources[e]}getOptionValueSourceWithGlobals(e){let t;return this._getCommandAndAncestors().forEach(n=>{n.getOptionValueSource(e)!==void 0&&(t=n.getOptionValueSource(e))}),t}_prepareUserArgs(e,t){if(e!==void 0&&!Array.isArray(e))throw Error(`first parameter to parse must be array or undefined`);if(t||={},e===void 0&&t.from===void 0){a.versions?.electron&&(t.from=`electron`);let e=a.execArgv??[];(e.includes(`-e`)||e.includes(`--eval`)||e.includes(`-p`)||e.includes(`--print`))&&(t.from=`eval`)}e===void 0&&(e=a.argv),this.rawArgs=e.slice();let n;switch(t.from){case void 0:case`node`:this._scriptPath=e[1],n=e.slice(2);break;case`electron`:a.defaultApp?(this._scriptPath=e[1],n=e.slice(2)):n=e.slice(1);break;case`user`:n=e.slice(0);break;case`eval`:n=e.slice(1);break;default:throw Error(`unexpected parse option { from: '${t.from}' }`)}return!this._name&&this._scriptPath&&this.nameFromFilename(this._scriptPath),this._name=this._name||`program`,n}parse(e,t){this._prepareForParse();let n=this._prepareUserArgs(e,t);return this._parseCommand([],n),this}async parseAsync(e,t){this._prepareForParse();let n=this._prepareUserArgs(e,t);return await this._parseCommand([],n),this}_prepareForParse(){this._savedState===null?this.saveStateBeforeParse():this.restoreStateBeforeParse()}saveStateBeforeParse(){this._savedState={_name:this._name,_optionValues:{...this._optionValues},_optionValueSources:{...this._optionValueSources}}}restoreStateBeforeParse(){if(this._storeOptionsAsProperties)throw Error(`Can not call parse again when storeOptionsAsProperties is true.
17
+ - either make a new Command for each call to parse, or stop storing options as properties`);this._name=this._savedState._name,this._scriptPath=null,this.rawArgs=[],this._optionValues={...this._savedState._optionValues},this._optionValueSources={...this._savedState._optionValueSources},this.args=[],this.processedArgs=[]}_checkForMissingExecutable(e,t,n){if(i.existsSync(e))return;let r=`'${e}' does not exist
18
+ - if '${n}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
19
+ - if the default executable name is not suitable, use the executableFile option to supply a custom name or path
20
+ - ${t?`searched for local subcommand relative to directory '${t}'`:`no directory for search for local subcommand, use .executableDir() to supply a custom directory`}`;throw Error(r)}_executeSubCommand(e,t){t=t.slice();let o=!1,s=[`.js`,`.ts`,`.tsx`,`.mjs`,`.cjs`];function l(e,t){let n=r.resolve(e,t);if(i.existsSync(n))return n;if(s.includes(r.extname(t)))return;let a=s.find(e=>i.existsSync(`${n}${e}`));if(a)return`${n}${a}`}this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let u=e._executableFile||`${this._name}-${e._name}`,d=this._executableDir||``;if(this._scriptPath){let e;try{e=i.realpathSync(this._scriptPath)}catch{e=this._scriptPath}d=r.resolve(r.dirname(e),d)}if(d){let t=l(d,u);if(!t&&!e._executableFile&&this._scriptPath){let n=r.basename(this._scriptPath,r.extname(this._scriptPath));n!==this._name&&(t=l(d,`${n}-${e._name}`))}u=t||u}o=s.includes(r.extname(u));let f;a.platform===`win32`?(this._checkForMissingExecutable(u,d,e._name),t.unshift(u),t=h(a.execArgv).concat(t),f=n.spawn(a.execPath,t,{stdio:`inherit`})):o?(t.unshift(u),t=h(a.execArgv).concat(t),f=n.spawn(a.argv[0],t,{stdio:`inherit`})):f=n.spawn(u,t,{stdio:`inherit`}),f.killed||[`SIGUSR1`,`SIGUSR2`,`SIGTERM`,`SIGINT`,`SIGHUP`].forEach(e=>{a.on(e,()=>{f.killed===!1&&f.exitCode===null&&f.kill(e)})});let p=this._exitCallback;f.on(`close`,e=>{e??=1,p?p(new c(e,`commander.executeSubCommandAsync`,`(close)`)):a.exit(e)}),f.on(`error`,t=>{if(t.code===`ENOENT`)this._checkForMissingExecutable(u,d,e._name);else if(t.code===`EACCES`)throw Error(`'${u}' not executable`);if(!p)a.exit(1);else{let e=new c(1,`commander.executeSubCommandAsync`,`(error)`);e.nestedError=t,p(e)}}),this.runningCommand=f}_dispatchSubcommand(e,t,n){let r=this._findCommand(e);r||this.help({error:!0}),r._prepareForParse();let i;return i=this._chainOrCallSubCommandHook(i,r,`preSubcommand`),i=this._chainOrCall(i,()=>{if(r._executableHandler)this._executeSubCommand(r,t.concat(n));else return r._parseCommand(t,n)}),i}_dispatchHelpCommand(e){e||this.help();let t=this._findCommand(e);return t&&!t._executableHandler&&t.help(),this._dispatchSubcommand(e,[],[this._getHelpOption()?.long??this._getHelpOption()?.short??`--help`])}_checkNumberOfArguments(){this.registeredArguments.forEach((e,t)=>{e.required&&this.args[t]==null&&this.missingArgument(e.name())}),!(this.registeredArguments.length>0&&this.registeredArguments[this.registeredArguments.length-1].variadic)&&this.args.length>this.registeredArguments.length&&this._excessArguments(this.args)}_processArguments(){let e=(e,t,n)=>{let r=t;if(t!==null&&e.parseArg){let i=`error: command-argument value '${t}' is invalid for argument '${e.name()}'.`;r=this._callParseArg(e,t,n,i)}return r};this._checkNumberOfArguments();let t=[];this.registeredArguments.forEach((n,r)=>{let i=n.defaultValue;n.variadic?r<this.args.length?(i=this.args.slice(r),n.parseArg&&(i=i.reduce((t,r)=>e(n,r,t),n.defaultValue))):i===void 0&&(i=[]):r<this.args.length&&(i=this.args[r],n.parseArg&&(i=e(n,i,n.defaultValue))),t[r]=i}),this.processedArgs=t}_chainOrCall(e,t){return e?.then&&typeof e.then==`function`?e.then(()=>t()):t()}_chainOrCallHooks(e,t){let n=e,r=[];return this._getCommandAndAncestors().reverse().filter(e=>e._lifeCycleHooks[t]!==void 0).forEach(e=>{e._lifeCycleHooks[t].forEach(t=>{r.push({hookedCommand:e,callback:t})})}),t===`postAction`&&r.reverse(),r.forEach(e=>{n=this._chainOrCall(n,()=>e.callback(e.hookedCommand,this))}),n}_chainOrCallSubCommandHook(e,t,n){let r=e;return this._lifeCycleHooks[n]!==void 0&&this._lifeCycleHooks[n].forEach(e=>{r=this._chainOrCall(r,()=>e(this,t))}),r}_parseCommand(e,t){let n=this.parseOptions(t);if(this._parseOptionsEnv(),this._parseOptionsImplied(),e=e.concat(n.operands),t=n.unknown,this.args=e.concat(t),e&&this._findCommand(e[0]))return this._dispatchSubcommand(e[0],e.slice(1),t);if(this._getHelpCommand()&&e[0]===this._getHelpCommand().name())return this._dispatchHelpCommand(e[1]);if(this._defaultCommandName)return this._outputHelpIfRequested(t),this._dispatchSubcommand(this._defaultCommandName,e,t);this.commands.length&&this.args.length===0&&!this._actionHandler&&!this._defaultCommandName&&this.help({error:!0}),this._outputHelpIfRequested(n.unknown),this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let r=()=>{n.unknown.length>0&&this.unknownOption(n.unknown[0])},i=`command:${this.name()}`;if(this._actionHandler){r(),this._processArguments();let n;return n=this._chainOrCallHooks(n,`preAction`),n=this._chainOrCall(n,()=>this._actionHandler(this.processedArgs)),this.parent&&(n=this._chainOrCall(n,()=>{this.parent.emit(i,e,t)})),n=this._chainOrCallHooks(n,`postAction`),n}if(this.parent?.listenerCount(i))r(),this._processArguments(),this.parent.emit(i,e,t);else if(e.length){if(this._findCommand(`*`))return this._dispatchSubcommand(`*`,e,t);this.listenerCount(`command:*`)?this.emit(`command:*`,e,t):this.commands.length?this.unknownCommand():(r(),this._processArguments())}else this.commands.length?(r(),this.help({error:!0})):(r(),this._processArguments())}_findCommand(e){if(e)return this.commands.find(t=>t._name===e||t._aliases.includes(e))}_findOption(e){return this.options.find(t=>t.is(e))}_checkForMissingMandatoryOptions(){this._getCommandAndAncestors().forEach(e=>{e.options.forEach(t=>{t.mandatory&&e.getOptionValue(t.attributeName())===void 0&&e.missingMandatoryOptionValue(t)})})}_checkForConflictingLocalOptions(){let e=this.options.filter(e=>{let t=e.attributeName();return this.getOptionValue(t)===void 0?!1:this.getOptionValueSource(t)!=="default"});e.filter(e=>e.conflictsWith.length>0).forEach(t=>{let n=e.find(e=>t.conflictsWith.includes(e.attributeName()));n&&this._conflictingOption(t,n)})}_checkForConflictingOptions(){this._getCommandAndAncestors().forEach(e=>{e._checkForConflictingLocalOptions()})}parseOptions(e){let t=[],n=[],r=t;function i(e){return e.length>1&&e[0]===`-`}let a=e=>/^-(\d+|\d*\.\d+)(e[+-]?\d+)?$/.test(e)?!this._getCommandAndAncestors().some(e=>e.options.map(e=>e.short).some(e=>/^-\d$/.test(e))):!1,o=null,s=null,c=0;for(;c<e.length||s;){let l=s??e[c++];if(s=null,l===`--`){r===n&&r.push(l),r.push(...e.slice(c));break}if(o&&(!i(l)||a(l))){this.emit(`option:${o.name()}`,l);continue}if(o=null,i(l)){let t=this._findOption(l);if(t){if(t.required){let n=e[c++];n===void 0&&this.optionMissingArgument(t),this.emit(`option:${t.name()}`,n)}else if(t.optional){let n=null;c<e.length&&(!i(e[c])||a(e[c]))&&(n=e[c++]),this.emit(`option:${t.name()}`,n)}else this.emit(`option:${t.name()}`);o=t.variadic?t:null;continue}}if(l.length>2&&l[0]===`-`&&l[1]!==`-`){let e=this._findOption(`-${l[1]}`);if(e){e.required||e.optional&&this._combineFlagAndOptionalValue?this.emit(`option:${e.name()}`,l.slice(2)):(this.emit(`option:${e.name()}`),s=`-${l.slice(2)}`);continue}}if(/^--[^=]+=/.test(l)){let e=l.indexOf(`=`),t=this._findOption(l.slice(0,e));if(t&&(t.required||t.optional)){this.emit(`option:${t.name()}`,l.slice(e+1));continue}}if(r===t&&i(l)&&!(this.commands.length===0&&a(l))&&(r=n),(this._enablePositionalOptions||this._passThroughOptions)&&t.length===0&&n.length===0){if(this._findCommand(l)){t.push(l),n.push(...e.slice(c));break}else if(this._getHelpCommand()&&l===this._getHelpCommand().name()){t.push(l,...e.slice(c));break}else if(this._defaultCommandName){n.push(l,...e.slice(c));break}}if(this._passThroughOptions){r.push(l,...e.slice(c));break}r.push(l)}return{operands:t,unknown:n}}opts(){if(this._storeOptionsAsProperties){let e={},t=this.options.length;for(let n=0;n<t;n++){let t=this.options[n].attributeName();e[t]=t===this._versionOptionName?this._version:this[t]}return e}return this._optionValues}optsWithGlobals(){return this._getCommandAndAncestors().reduce((e,t)=>Object.assign(e,t.opts()),{})}error(e,t){this._outputConfiguration.outputError(`${e}\n`,this._outputConfiguration.writeErr),typeof this._showHelpAfterError==`string`?this._outputConfiguration.writeErr(`${this._showHelpAfterError}\n`):this._showHelpAfterError&&(this._outputConfiguration.writeErr(`
21
+ `),this.outputHelp({error:!0}));let n=t||{},r=n.exitCode||1,i=n.code||`commander.error`;this._exit(r,i,e)}_parseOptionsEnv(){this.options.forEach(e=>{if(e.envVar&&e.envVar in a.env){let t=e.attributeName();(this.getOptionValue(t)===void 0||[`default`,`config`,`env`].includes(this.getOptionValueSource(t)))&&(e.required||e.optional?this.emit(`optionEnv:${e.name()}`,a.env[e.envVar]):this.emit(`optionEnv:${e.name()}`))}})}_parseOptionsImplied(){let e=new f(this.options),t=e=>this.getOptionValue(e)!==void 0&&![`default`,`implied`].includes(this.getOptionValueSource(e));this.options.filter(n=>n.implied!==void 0&&t(n.attributeName())&&e.valueFromOption(this.getOptionValue(n.attributeName()),n)).forEach(e=>{Object.keys(e.implied).filter(e=>!t(e)).forEach(t=>{this.setOptionValueWithSource(t,e.implied[t],`implied`)})})}missingArgument(e){let t=`error: missing required argument '${e}'`;this.error(t,{code:`commander.missingArgument`})}optionMissingArgument(e){let t=`error: option '${e.flags}' argument missing`;this.error(t,{code:`commander.optionMissingArgument`})}missingMandatoryOptionValue(e){let t=`error: required option '${e.flags}' not specified`;this.error(t,{code:`commander.missingMandatoryOptionValue`})}_conflictingOption(e,t){let n=e=>{let t=e.attributeName(),n=this.getOptionValue(t),r=this.options.find(e=>e.negate&&t===e.attributeName()),i=this.options.find(e=>!e.negate&&t===e.attributeName());return r&&(r.presetArg===void 0&&n===!1||r.presetArg!==void 0&&n===r.presetArg)?r:i||e},r=e=>{let t=n(e),r=t.attributeName();return this.getOptionValueSource(r)===`env`?`environment variable '${t.envVar}'`:`option '${t.flags}'`},i=`error: ${r(e)} cannot be used with ${r(t)}`;this.error(i,{code:`commander.conflictingOption`})}unknownOption(e){if(this._allowUnknownOption)return;let t=``;if(e.startsWith(`--`)&&this._showSuggestionAfterError){let n=[],r=this;do{let e=r.createHelp().visibleOptions(r).filter(e=>e.long).map(e=>e.long);n=n.concat(e),r=r.parent}while(r&&!r._enablePositionalOptions);t=p(e,n)}let n=`error: unknown option '${e}'${t}`;this.error(n,{code:`commander.unknownOption`})}_excessArguments(e){if(this._allowExcessArguments)return;let t=this.registeredArguments.length,n=t===1?``:`s`,r=`error: too many arguments${this.parent?` for '${this.name()}'`:``}. Expected ${t} argument${n} but got ${e.length}.`;this.error(r,{code:`commander.excessArguments`})}unknownCommand(){let e=this.args[0],t=``;if(this._showSuggestionAfterError){let n=[];this.createHelp().visibleCommands(this).forEach(e=>{n.push(e.name()),e.alias()&&n.push(e.alias())}),t=p(e,n)}let n=`error: unknown command '${e}'${t}`;this.error(n,{code:`commander.unknownCommand`})}version(e,t,n){if(e===void 0)return this._version;this._version=e,t||=`-V, --version`,n||=`output the version number`;let r=this.createOption(t,n);return this._versionOptionName=r.attributeName(),this._registerOption(r),this.on(`option:`+r.name(),()=>{this._outputConfiguration.writeOut(`${e}\n`),this._exit(0,`commander.version`,e)}),this}description(e,t){return e===void 0&&t===void 0?this._description:(this._description=e,t&&(this._argsDescription=t),this)}summary(e){return e===void 0?this._summary:(this._summary=e,this)}alias(e){if(e===void 0)return this._aliases[0];let t=this;if(this.commands.length!==0&&this.commands[this.commands.length-1]._executableHandler&&(t=this.commands[this.commands.length-1]),e===t._name)throw Error(`Command alias can't be the same as its name`);let n=this.parent?._findCommand(e);if(n){let t=[n.name()].concat(n.aliases()).join(`|`);throw Error(`cannot add alias '${e}' to command '${this.name()}' as already have command '${t}'`)}return t._aliases.push(e),this}aliases(e){return e===void 0?this._aliases:(e.forEach(e=>this.alias(e)),this)}usage(e){if(e===void 0){if(this._usage)return this._usage;let e=this.registeredArguments.map(e=>s(e));return[].concat(this.options.length||this._helpOption!==null?`[options]`:[],this.commands.length?`[command]`:[],this.registeredArguments.length?e:[]).join(` `)}return this._usage=e,this}name(e){return e===void 0?this._name:(this._name=e,this)}helpGroup(e){return e===void 0?this._helpGroupHeading??``:(this._helpGroupHeading=e,this)}commandsGroup(e){return e===void 0?this._defaultCommandGroup??``:(this._defaultCommandGroup=e,this)}optionsGroup(e){return e===void 0?this._defaultOptionGroup??``:(this._defaultOptionGroup=e,this)}_initOptionGroup(e){this._defaultOptionGroup&&!e.helpGroupHeading&&e.helpGroup(this._defaultOptionGroup)}_initCommandGroup(e){this._defaultCommandGroup&&!e.helpGroup()&&e.helpGroup(this._defaultCommandGroup)}nameFromFilename(e){return this._name=r.basename(e,r.extname(e)),this}executableDir(e){return e===void 0?this._executableDir:(this._executableDir=e,this)}helpInformation(e){let t=this.createHelp(),n=this._getOutputContext(e);t.prepareContext({error:n.error,helpWidth:n.helpWidth,outputHasColors:n.hasColors});let r=t.formatHelp(this,t);return n.hasColors?r:this._outputConfiguration.stripColor(r)}_getOutputContext(e){e||={};let t=!!e.error,n,r,i;return t?(n=e=>this._outputConfiguration.writeErr(e),r=this._outputConfiguration.getErrHasColors(),i=this._outputConfiguration.getErrHelpWidth()):(n=e=>this._outputConfiguration.writeOut(e),r=this._outputConfiguration.getOutHasColors(),i=this._outputConfiguration.getOutHelpWidth()),{error:t,write:e=>(r||(e=this._outputConfiguration.stripColor(e)),n(e)),hasColors:r,helpWidth:i}}outputHelp(e){let t;typeof e==`function`&&(t=e,e=void 0);let n=this._getOutputContext(e),r={error:n.error,write:n.write,command:this};this._getCommandAndAncestors().reverse().forEach(e=>e.emit(`beforeAllHelp`,r)),this.emit(`beforeHelp`,r);let i=this.helpInformation({error:n.error});if(t&&(i=t(i),typeof i!=`string`&&!Buffer.isBuffer(i)))throw Error(`outputHelp callback must return a string or a Buffer`);n.write(i),this._getHelpOption()?.long&&this.emit(this._getHelpOption().long),this.emit(`afterHelp`,r),this._getCommandAndAncestors().forEach(e=>e.emit(`afterAllHelp`,r))}helpOption(e,t){return typeof e==`boolean`?(e?(this._helpOption===null&&(this._helpOption=void 0),this._defaultOptionGroup&&this._initOptionGroup(this._getHelpOption())):this._helpOption=null,this):(this._helpOption=this.createOption(e??`-h, --help`,t??`display help for command`),(e||t)&&this._initOptionGroup(this._helpOption),this)}_getHelpOption(){return this._helpOption===void 0&&this.helpOption(void 0,void 0),this._helpOption}addHelpOption(e){return this._helpOption=e,this._initOptionGroup(e),this}help(e){this.outputHelp(e);let t=Number(a.exitCode??0);t===0&&e&&typeof e!=`function`&&e.error&&(t=1),this._exit(t,`commander.help`,`(outputHelp)`)}addHelpText(e,t){let n=[`beforeAll`,`before`,`after`,`afterAll`];if(!n.includes(e))throw Error(`Unexpected value for position to addHelpText.
22
+ Expecting one of '${n.join(`', '`)}'`);let r=`${e}Help`;return this.on(r,e=>{let n;n=typeof t==`function`?t({error:e.error,command:e.command}):t,n&&e.write(`${n}\n`)}),this}_outputHelpIfRequested(e){let t=this._getHelpOption();t&&e.find(e=>t.is(e))&&(this.outputHelp(),this._exit(0,`commander.helpDisplayed`,`(outputHelp)`))}};function h(e){return e.map(e=>{if(!e.startsWith(`--inspect`))return e;let t,n=`127.0.0.1`,r=`9229`,i;return(i=e.match(/^(--inspect(-brk)?)$/))===null?(i=e.match(/^(--inspect(-brk|-port)?)=([^:]+)$/))===null?(i=e.match(/^(--inspect(-brk|-port)?)=([^:]+):(\d+)$/))!==null&&(t=i[1],n=i[3],r=i[4]):(t=i[1],/^\d+$/.test(i[3])?r=i[3]:n=i[3]):t=i[1],t&&r!==`0`?`${t}=${n}:${parseInt(r)+1}`:e})}function g(){if(a.env.NO_COLOR||a.env.FORCE_COLOR===`0`||a.env.FORCE_COLOR===`false`)return!1;if(a.env.FORCE_COLOR||a.env.CLICOLOR_FORCE!==void 0)return!0}e.Command=m,e.useColor=g})),I=e.n((e=>{var{Argument:t}=M(),{Command:n}=F(),{CommanderError:r,InvalidArgumentError:i}=j(),{Help:a}=N(),{Option:o}=P();e.program=new n,e.createCommand=e=>new n(e),e.createOption=(e,t)=>new o(e,t),e.createArgument=(e,n)=>new t(e,n),e.Command=n,e.Option=o,e.Argument=t,e.Help=a,e.CommanderError=r,e.InvalidArgumentError=i,e.InvalidOptionArgumentError=i})),{program:ie,createCommand:ae,createArgument:oe,createOption:se,CommanderError:ce,InvalidArgumentError:le,InvalidOptionArgumentError:ue,Command:L,Argument:de,Option:R,Help:fe}=e.i(I(),1).default,z=[{path:[`app`],description:`Create, develop and manage applications`,helpGroup:v.a.APP},{path:[`data`],description:`Read workspace records`,helpGroup:v.a.WORKSPACE},{path:[`auth`],description:`Sign in and manage credentials`,helpGroup:v.a.WORKSPACE},{path:[`remote`],description:`Manage saved workspace connections`,helpGroup:v.a.WORKSPACE},{path:[`metadata`],description:`Inspect the data model`,helpGroup:v.a.WORKSPACE},{path:[`metadata`,`object`],description:`Objects`},{path:[`metadata`,`field`],description:`Fields`},{path:[`api`],description:`Send raw REST and GraphQL requests`,helpGroup:v.a.WORKSPACE}],B=[`human`,`json`,`ndjson`],V=(e,t)=>t.reduce((e,t)=>e?.commands.find(e=>e.name()===t),e),H=(e,n)=>{let r=V(e,n);if(!t.zt(r))throw Error(`Topic "${n.join(` `)}" is not registered.`);return r},U=(e,t)=>new r.t({code:`AUTH_REQUIRED`,exitCode:r.n.AUTHENTICATION,message:`Your session on ${e} expired and could not be refreshed.`,hint:`Sign in again: twenty auth login --remote ${e}`,details:{remote:e,refresh:t??null}}),W=(e,t)=>new r.t({code:`CONFLICT`,exitCode:r.n.CONFLICT,message:`Remote ${e} ${t} while this command was waiting to refresh its session. Nothing was sent.`,hint:`Run the command again.`,details:{remote:e}}),G=({config:e,remoteName:t,apiUrl:n})=>{if(!Object.hasOwn(e.remotes,t))throw W(t,`was renamed or removed`);let a=e.remotes[t];if(i.t({rawUrl:a.apiUrl,sourceName:t})!==n)throw W(t,`was pointed at another server`);let o=ee.t(a);if(o===`apiKey`)throw W(t,`switched to an API key`);if(o===`none`)throw new r.t({code:`AUTH_REQUIRED`,exitCode:r.n.AUTHENTICATION,message:`Remote ${t} was signed out while this command was waiting.`,hint:`Sign in again: twenty auth login --remote ${t}`,details:{remote:t}});return a},pe=({configPath:e,remoteName:t,apiUrl:n,signal:i})=>h.n({configPath:e,signal:i,operation:async()=>{let a=await m.t(e),o=G({config:a,remoteName:t,apiUrl:n}),{twentyCLIAccessToken:s,twentyCLIRefreshToken:c,twentyCLIRegistrationClientId:l}=o;if((0,b.isNonEmptyString)(s)&&!_.n(s))return s;if(!(0,b.isNonEmptyString)(c)||!(0,b.isNonEmptyString)(l))throw U(t);let{tokenEndpoint:u}=await g.n({apiUrl:n,signal:i}),d=await g.t({apiUrl:n,tokenEndpoint:u,parameters:{grant_type:`refresh_token`,refresh_token:c,client_id:l},signal:i}).catch(e=>{throw e instanceof r.t&&e.code===`OAUTH_FAILED`?U(t,e.details):e});return i.throwIfAborted(),await h.t(e,{...a,remotes:{...a.remotes,[t]:{...o,twentyCLIAccessToken:d.accessToken,...(0,b.isNonEmptyString)(d.refreshToken)?{twentyCLIRefreshToken:d.refreshToken}:{}}}}),d.accessToken}}),K=async({remoteName:e,remote:t,configPath:n,signal:a,onAuthenticationRequired:o})=>{let s=t.twentyCLIAccessToken,c=i.t({rawUrl:t.apiUrl,sourceName:`The URL of remote ${e}`});if((0,b.isNonEmptyString)(s)){let t={apiUrl:c,bearerToken:s,credentialKind:`oauth`,source:`remote`,remoteName:e};if(!_.n(s))return t;try{return{...t,bearerToken:await pe({configPath:n,remoteName:e,apiUrl:c,signal:a})}}catch(e){if(o)return o({target:t,error:e});throw e}}let l=t.apiKey;if(!(0,b.isNonEmptyString)(l))throw new r.t({code:`AUTH_REQUIRED`,exitCode:r.n.AUTHENTICATION,message:`Remote ${e} has no saved credentials.`,hint:`Sign in: twenty auth login --remote ${e}`,details:{remote:e}});return{apiUrl:c,bearerToken:l,credentialKind:`apiKey`,source:`remote`,remoteName:e}},q=async({environment:e,remoteFlag:t,configPath:n,signal:r,warn:a,onAuthenticationRequired:s})=>{let c=await f.t({environment:e,remoteFlag:t,loadConfig:()=>m.t(n),warn:a});return c.source===`remote`?K({remoteName:c.remoteName,remote:c.remote,configPath:n,signal:r,onAuthenticationRequired:s}):{apiUrl:i.t({rawUrl:c.apiUrl,sourceName:o.t.API_URL}),bearerToken:c.apiKey,credentialKind:`apiKey`,source:`environment`}},J=async({options:e,outputMode:n,output:i,signal:o})=>{let c=p.t(),l=s.t({options:e,outputMode:n}),u=!1,d=async({target:e,error:n})=>{let a=n instanceof r.t?n.details?.refresh:void 0;if(!l||u||o.aborted||e.source!==`remote`||e.credentialKind!==`oauth`||!t.zt(e.remoteName)||!(n instanceof r.t)||n.code!==`AUTH_REQUIRED`||t.d(a)&&a.status!==400&&a.status!==401)throw n;u=!0;let{signInToRemoteAgain:s}=await Promise.resolve().then(()=>require("./sign-in-to-remote-again-CW8HPSTP.cjs"));return s({target:e,remoteName:e.remoteName,error:n,configPath:c,output:i,signal:o})},f=await q({environment:process.env,remoteFlag:a.r(e,`remote`),configPath:c,signal:o,warn:i.warn,onAuthenticationRequired:d});if(!l||f.credentialKind!==`oauth`||u)return f;let{fetchSignedInIdentity:m}=await Promise.resolve().then(()=>require("./fetch-signed-in-identity-BhvaL3zp.cjs")).then(e=>e.n);try{return await m({target:f,signal:o}),f}catch(e){return d({target:f,error:e})}},Y=(e,t)=>{if(!e.outputModes.includes(t))throw new r.t({code:`USAGE`,exitCode:r.n.USAGE,message:`twenty ${v.n(e)} does not support ${t} output.`,hint:`Supported: ${e.outputModes.join(`, `)}`})},X=async({definition:e,outputMode:n,commandArguments:r,options:i})=>{let a=v.n(e),o=E({mode:n,command:a}),s=new AbortController,c=()=>s.abort(),u;process.once(`SIGINT`,c);try{Y(e,n);let t={command:a,arguments:r,options:i,output:o,outputMode:n,signal:s.signal};if(!e.needsTarget){let n=await e.load();o.succeed(await n(t));return}let c=await J({options:i,outputMode:n,output:o,signal:s.signal});u=c;let l=await e.load();o.succeed(await l({...t,target:c}),d.t(c))}catch(e){o.fail(l.t(e,s.signal),t.zt(u)?d.t(u):void 0)}finally{process.off(`SIGINT`,c),s.abort()}},Z=(e,t)=>e.exitOverride(n=>{throw new O({commanderError:n,commandName:t,operands:e.args})}),me=({flags:e,description:n,choices:r,required:i,hidden:a})=>{let o=new R(e,n);return a===!0&&o.hideHelp(),t.zt(r)&&o.choices(r),i===!0&&o.makeOptionMandatory(),o},Q=e=>`\nExamples:\n${e.map(e=>` ${e}`).join(`
23
+ `)}\n`,he=({program:e,definition:r,outputMode:i})=>{let a=H(e,r.path.slice(0,-1)).command(r.path[r.path.length-1]).description(r.description);t.zt(r.helpGroup)&&a.helpGroup(r.helpGroup);for(let e of r.arguments??[])a.argument(e.required?`<${e.name}>`:`[${e.name}]`,e.description);for(let e of r.options??[])a.addOption(me(e));n.r(r.examples)&&a.addHelpText(`after`,Q(r.examples)),Z(a,v.n(r)),a.action(()=>X({definition:r,outputMode:i,commandArguments:a.processedArgs,options:a.optsWithGlobals()}))},ge=({program:e,topic:n})=>{let r=H(e,n.path.slice(0,-1)).command(n.path[n.path.length-1]).description(n.description);t.zt(n.helpGroup)&&r.helpGroup(n.helpGroup),Z(r,n.path.join(` `))},_e=({outputMode:e,outputConfiguration:t})=>{let n=new L(k).description(`The Twenty command line`).version(u.t,v.t.VERSION,`Print the version`).addOption(new R(v.t.JSON,`Print one JSON document on stdout`).conflicts(`format`)).addOption(new R(v.t.FORMAT,`Output format`).choices(B)).option(v.t.REMOTE,`Saved remote to use for this command`).option(v.t.NO_INPUT,`Never prompt or open a browser`).helpOption(v.t.HELP,`Show help`).commandsGroup(v.a.TOOLS).helpCommand(`help [command]`,`Show help for a command`).configureHelp({showGlobalOptions:!0}).configureOutput(t);Z(n,k);for(let e of z)ge({program:n,topic:e});for(let t of v.r)he({program:n,definition:t,outputMode:e});return n},ve=`help`,ye=e=>n.u(e.replace(/^error: /,``).replace(/\s*\n\s*/g,` `).trim()),be=e=>e===`twenty`?k:`${k} ${e}`,$=({message:e,commandName:t})=>new r.t({code:`USAGE`,exitCode:r.n.USAGE,message:e,hint:`See: ${be(t)} --help`}),xe=(e,t)=>e.code===`commander.helpDisplayed`||e.code===`commander.help`&&(e.exitCode===0||!n.r(t)),Se=e=>(e[0]===ve?e.slice(1):e).join(` `),Ce=async({error:e,outputMode:t,capturedOutput:n})=>{let{commanderError:r,commandName:i,operands:a}=e;if(r.code===`commander.version`){await X({definition:v.i,outputMode:t,commandArguments:[],options:{}});return}let o=E({mode:t,command:i});if(xe(r,a)){let e=(0,b.isNonEmptyString)(n.standardOutput)?n.standardOutput:n.standardError;o.succeed({data:{help:e},human:e});return}if(r.code===`commander.help`){o.fail($({message:`Unknown command '${Se(a)}'`,commandName:i}));return}o.fail($({message:ye(r.message),commandName:i}))},we=async e=>{let t=ne(e),n=A(),r=_e({outputMode:t,outputConfiguration:n.configuration});try{await r.parseAsync(e,{from:`user`})}catch(e){if(e instanceof O){await Ce({error:e,outputMode:t,capturedOutput:n.captured});return}E({mode:t,command:k}).fail(l.t(e))}};exports.runCli=we;
@@ -0,0 +1,2 @@
1
+ const e=require("./constants-CL6mrTMT-B748cNNG.cjs"),t=require("./style-BR52fK4V.cjs"),n=require("./global-flags.constant-8GfW0sNU.cjs"),r=require("./format-table-4drtI5sP.cjs");var i=async()=>{let i=n.r.map(t=>({name:n.n(t),description:t.description,arguments:(t.arguments??[]).map(({name:e,required:t})=>({name:e,required:t})),flags:(t.options??[]).filter(({hidden:e})=>e!==!0).map(({flags:e})=>e),outputs:t.outputModes,writes:t.writes,needsProject:t.needsProject,needsTarget:t.needsTarget,...e.zt(t.requiredPermissions)?{requiredPermissions:t.requiredPermissions}:{}})).sort((e,t)=>e.name.localeCompare(t.name));return{data:{commands:i,globalFlags:Object.values(n.t)},human:[r.t({rows:i,columns:[{header:`COMMAND`,value:e=>e.name},{header:`DESCRIPTION`,value:e=>e.description}]}),`${t.i(`${i.length} commands · details: `)}${t.r(`twenty <command> --help`)}`].join(`
2
+ `)}};exports.runCommandsCommand=i;
@@ -0,0 +1 @@
1
+ const e=require("./cli-error-CSsayo0u.cjs"),t=require("./read-command-values-uSJqBG_E.cjs"),n=require("./create-metadata-client-ChjDalSi.cjs"),r=require("./format-data-value-B6rIbpJv.cjs"),i=require("./format-details-COEwKz_M.cjs"),a=require("./create-rest-client-eAfOFfDA.cjs"),o=require("./resolve-metadata-object-QoDi-Aik.cjs");var s=async({arguments:s,target:c,signal:l,outputMode:u})=>{let d=t.n(s,1)??``;if(d.length===0||d===`.`||d===`..`)throw new e.t({code:`USAGE`,exitCode:e.n.USAGE,message:`A record id is required.`});let f=await o.t({client:n.t({target:c,signal:l}),name:t.n(s,0)??``}),p=a.r(await a.t({target:c,signal:l}).get(`/rest/${encodeURIComponent(f.namePlural)}/${encodeURIComponent(d)}`,{query:{depth:1}}),f.nameSingular);return{data:p,...u===`human`?{human:i.t(Object.entries(p).map(([e,t])=>[r.t(e),r.n(t)]))}:{}}};exports.runDataGetCommand=s;
@@ -0,0 +1 @@
1
+ const e=require("./constants-CL6mrTMT-B748cNNG.cjs"),t=require("./cli-error-CSsayo0u.cjs"),n=require("./read-command-values-uSJqBG_E.cjs");require("./resolve-request-url-jC5kYwkn.cjs");const r=require("./style-BR52fK4V.cjs"),i=require("./to-cli-error-BBYf_wqo.cjs");require("./result-item-limit.constant-CDrOhiWD.cjs");const a=require("./create-metadata-client-ChjDalSi.cjs"),o=require("./format-data-value-B6rIbpJv.cjs"),s=require("./to-public-target-CIAwoOKL.cjs"),c=require("./format-table-4drtI5sP.cjs"),l=require("./create-rest-client-eAfOFfDA.cjs"),u=require("./resolve-metadata-object-QoDi-Aik.cjs");var d=({recordCount:e,bytes:n})=>{if(e>1e4||n>16777216)throw new t.t({code:`RESULT_LIMIT_EXCEEDED`,exitCode:t.n.USAGE,message:`Records exceed the 10,000-item or 16 MiB result limit.`,hint:`Use data list <object> --all --format ndjson to stream records, or request fewer records.`,details:{recordCount:e,bytes:n}})},f=[`id`,`name`],p=new Set([`deletedAt`]),m=(e,t)=>o.t(Object.hasOwn(e,t)?e[t]:void 0),h=({page:e,options:t})=>{let n=Object.keys(e.records[0]??{}),i=t.fields??[...f.filter(e=>n.includes(e)),...n.filter(e=>!f.includes(e)&&!p.has(e))].slice(0,5),a=c.n.ROW_INDENT.length,s=0;for(let t of i){let n=o.t(t),r=n.length;s+=Buffer.byteLength(n,`utf8`)-n.length;for(let n of e.records){let e=m(n,t);r=Math.max(r,e.length),s+=Buffer.byteLength(e,`utf8`)-e.length}a+=r+c.n.COLUMN_GAP.length}d({recordCount:e.records.length,bytes:a*(e.records.length+1)+s});let l=e.records.length===0?`No records.`:c.t({rows:e.records,columns:i.map(e=>({header:o.t(e),value:t=>m(t,e)}))}),u=`${e.records.length} of ${e.totalCount} records`;return`${l}\n${r.i(e.pageInfo.hasNextPage?`${u} · --all for every page · --json for the next cursor`:u)}`};async function*g({fetchPage:e,cursor:n,signal:r}){let i=n,a=n,o=1,s=0,c=!0;for(;c;){r.throwIfAborted();let n=await e(i);r.throwIfAborted();let l=n.pageInfo.endCursor??void 0;if(n.records.length>0&&(l===i||l===a))throw new t.t({code:`INVALID_RESPONSE`,message:`The server returned a repeated pagination cursor.`});c=n.pageInfo.hasNextPage,c&&(s+=1,s===o&&(a=l,o*=2,s=0)),yield n,i=l}}var _=r=>{let i=n.r(r,`limit`)??`50`,a=Number(i),o=n.r(r,`fields`)?.split(`,`).map(e=>e.trim()),s=n.r(r,`cursor`);if(!/^\d+$/.test(i)||!Number.isInteger(a)||a<1||a>200)throw new t.t({code:`USAGE`,exitCode:t.n.USAGE,message:`--limit must be an integer between 1 and 200.`});if(o?.some(e=>e.length===0)||e.zt(s)&&s.length===0)throw new t.t({code:`USAGE`,exitCode:t.n.USAGE,message:`--fields and --cursor cannot contain empty values.`});return{limit:a,fields:e.zt(o)?[...new Set(o)]:void 0,cursor:s,filter:n.r(r,`filter`),orderBy:n.r(r,`orderBy`),all:n.t(r,`all`)}},v=async({arguments:e,options:r,target:o,signal:c,output:f,outputMode:p})=>{let m=_(r),v=await u.t({client:a.t({target:o,signal:c}),name:n.n(e,0)??``}),y=l.t({target:o,signal:c}),b=p===`ndjson`,x=[],S=0,C=0,w=0,T=m.cursor??null,E={hasNextPage:!1,startCursor:null,endCursor:null},D=0;try{b&&await f.event(`start`,{object:v.namePlural,target:s.t(o)},c);for await(let e of g({cursor:m.cursor,signal:c,fetchPage:async e=>l.n(await y.get(`/rest/${encodeURIComponent(v.namePlural)}`,{query:{limit:m.limit,starting_after:e,filter:m.filter,order_by:m.orderBy}}),v.namePlural,m.limit)})){for(let t of e.records)b?await f.event(`record`,t,c):(w+=Buffer.byteLength(JSON.stringify(t),`utf8`),d({recordCount:S+1,bytes:w+S+Buffer.byteLength(JSON.stringify({records:[],pageInfo:e.pageInfo,totalCount:e.totalCount}),`utf8`)}),x.push(t)),S+=1;if(C+=1,E=e.pageInfo,D=e.totalCount,T=E.endCursor??T,b&&await f.event(`progress`,{recordCount:S,pages:C,resumeCursor:T,pageInfo:E,totalCount:D},c),!m.all)break}}catch(e){let n=i.t(e,c);throw b?new t.t({code:n.code,exitCode:n.exitCode,message:n.message,hint:n.hint,details:{...n.details,recordCount:S,pages:C,resumeCursor:T}}):n}if(b)return{data:{recordCount:S,pages:C,resumeCursor:T,pageInfo:E,totalCount:D}};let O={records:x,pageInfo:E,totalCount:D},k=p===`human`&&x.length>0?(m.fields??[]).filter(e=>!x.some(t=>Object.hasOwn(t,e))):[];return k.length>0&&f.warn({code:`FIELDS_NOT_RETURNED`,message:`No returned record has ${k.join(`, `)}; see twenty metadata field list ${v.namePlural}.`}),{data:O,...p===`human`?{human:h({page:O,options:m})}:{}}};exports.runDataListCommand=v;
@@ -0,0 +1,2 @@
1
+ const e=require("./build-CX6FBrbu.cjs"),t=require("./package-CdYv4LEx.cjs"),n=require("./check-node-requirement-mqwNPktb.cjs"),r=require("./constants-CL6mrTMT-B748cNNG.cjs"),i=require("./utils-B8EXJeaX-DK3gCslL.cjs"),a=require("./is-inside-directory-t3ixLQDr.cjs"),o=require("./has-yarn-plug-and-play-X3ay5Xl0.cjs"),s=require("./cli-error-CSsayo0u.cjs"),c=require("./resolve-source-sdk-mK-f4q55.cjs"),l=require("./parse-api-url-BllxRdpE.cjs"),u=require("./read-command-values-uSJqBG_E.cjs"),d=require("./target-environment-variable.constant-D7z8AihP.cjs"),f=require("./style-BR52fK4V.cjs"),p=require("./resolve-app-project-D5ZXIpsG.cjs"),m=require("./cli-version.constant-aSp8WZDh.cjs"),h=require("./to-public-target-CIAwoOKL.cjs"),g=require("./select-target-C1VZjf-A.cjs"),_=require("./get-config-path-C-D-QHuX.cjs"),v=require("./read-config-DUJ27809.cjs"),y=require("./config-file-mode.constant-DLBzKKUl.cjs"),b=require("./fetch-signed-in-identity-BhvaL3zp.cjs"),x=require("./is-access-token-expiring-gICPXsbO.cjs");let S=require("node:fs/promises"),C=require("node:path"),w=require("node:fs");var T={pass:`green`,warning:`yellow`,fail:`red`,skipped:`yellow`},E=(e,t=process.stdout)=>e.map(e=>{let n=r.zt(e.hint)?`\n ${e.hint}`:``;return`${f.n(T[e.status],`[${e.status.toUpperCase()}]`,t)} ${e.id}: ${e.message}${n}`}).join(`
2
+ `),D=e.t(),O={AUTH_REQUIRED:{message:`The metadata endpoint rejected these credentials.`,hint:`Check the configured credentials, or sign in again.`},PERMISSION_DENIED:{message:`The metadata endpoint denied access to the workspace identity.`,hint:`Check the selected remote and the permissions granted to its credentials.`},INVALID_RESPONSE:{message:`The server did not return a valid metadata API response.`,hint:`Check the API URL and base path, and whether a proxy returned another page.`},UNSUPPORTED_RESPONSE_TYPE:{message:`The metadata endpoint returned an unsupported response type.`,hint:`Check the API URL and base path, and whether a proxy returned another page.`},REDIRECT_NOT_FOLLOWED:{message:`The metadata endpoint redirected the request. No redirect was followed.`,hint:`Configure the final Twenty API URL, including the correct protocol and base path.`},TIMEOUT:{message:`The metadata endpoint did not respond before the request timed out.`,hint:`Check server availability and the network connection.`},NETWORK_ERROR:{message:`Could not connect to the metadata endpoint.`,hint:`Check the API URL, network connection, server availability and TLS configuration.`}},k={ENOTFOUND:`DNS could not resolve the metadata endpoint hostname.`,EAI_AGAIN:`DNS resolution of the metadata endpoint temporarily failed.`,ECONNREFUSED:`The metadata endpoint refused the connection.`,ECONNRESET:`The connection to the metadata endpoint was reset.`,EHOSTUNREACH:`The metadata endpoint host is unreachable.`,ENETUNREACH:`The network containing the metadata endpoint is unreachable.`,ETIMEDOUT:`The connection to the metadata endpoint timed out.`,UND_ERR_CONNECT_TIMEOUT:`The connection to the metadata endpoint timed out.`,CERT_HAS_EXPIRED:`The metadata endpoint TLS certificate has expired.`,ERR_TLS_CERT_ALTNAME_INVALID:`The metadata endpoint TLS certificate does not match its hostname.`,DEPTH_ZERO_SELF_SIGNED_CERT:`The metadata endpoint uses an untrusted self-signed TLS certificate.`,SELF_SIGNED_CERT_IN_CHAIN:`The metadata endpoint TLS certificate chain contains an untrusted self-signed certificate.`,UNABLE_TO_VERIFY_LEAF_SIGNATURE:`The metadata endpoint TLS certificate chain could not be verified.`,UNABLE_TO_GET_ISSUER_CERT_LOCALLY:`The metadata endpoint TLS certificate issuer is not trusted locally.`},A=e=>{let t=e instanceof s.t?e.code:`INTERNAL_ERROR`,n=O[t]??{message:`The metadata endpoint could not be verified (${t}).`,hint:`Check the API URL and server availability.`},i=e instanceof s.t&&t===`NETWORK_ERROR`?e.details?.networkCode:void 0,a=(0,D.isString)(i)&&Object.hasOwn(k,i)?k[i]:void 0;return{id:`metadata-api`,status:`fail`,code:t,message:a??n.message,hint:e instanceof s.t&&t===`AUTH_REQUIRED`&&r.zt(e.hint)?e.hint:n.hint,...r.zt(a)?{details:{networkCode:i}}:{}}},j=async({configPath:e,environment:t,remoteFlag:n,offline:i,signal:a})=>{let o=[],c,u;a.throwIfAborted();try{if(c=await v.t(e),o.push({id:`configuration`,status:`pass`,message:`CLI configuration checked at ${e}.`,details:{path:e,remoteCount:Object.keys(c.remotes).length,defaultRemote:c.defaultRemote??null}}),process.platform!==`win32`){let t=await(0,S.stat)(e).catch(()=>void 0);r.zt(t)&&t.mode&63&&o.push({id:`configuration-permissions`,status:`warning`,message:`Other users may access the CLI configuration file.`,hint:`Review its permissions; ${y.t.PRIVATE_FILE.toString(8)} is the expected mode. Doctor does not change them.`})}}catch(t){u=t,o.push({id:`configuration`,status:`fail`,code:t instanceof s.t?t.code:`INVALID_CONFIG`,message:t instanceof s.t?t.message:`The CLI configuration is unreadable or invalid.`,hint:t instanceof s.t?t.hint:`Check ${e}. Doctor does not overwrite it.`})}let f;try{let e=await g.t({environment:t,remoteFlag:n,loadConfig:async()=>{if(!r.zt(c))throw u;return c},warn:e=>o.push({id:`target-precedence`,status:`warning`,code:e.code,message:e.message})}),i=l.t({rawUrl:e.source===`remote`?e.remote.apiUrl:e.apiUrl,sourceName:e.source===`remote`?`The URL of remote ${e.remoteName}`:d.t.API_URL}),a={apiUrl:i,source:e.source,remote:e.source===`remote`?e.remoteName:null};o.push({id:`target`,status:`pass`,message:`Selected ${i} from ${e.source}.`,details:a});let s=e.source===`remote`?e.remote.twentyCLIAccessToken:void 0,p=(0,D.isNonEmptyString)(s)?`oauth`:`apiKey`,m=e.source===`remote`?e.remote.apiKey:e.apiKey,h=(0,D.isNonEmptyString)(s)?s:m;if(!(0,D.isNonEmptyString)(h))return o.push({id:`credentials`,status:`fail`,code:`AUTH_REQUIRED`,message:`The selected remote has no saved credentials.`,hint:`Sign in with twenty auth login, then rerun doctor.`}),[...o,{id:`metadata-api`,status:`skipped`,message:`No credentials are available.`}];let _=p===`oauth`?x.t(h):void 0;if(r.zt(_)&&_<=Date.now()){let t=e.source===`remote`&&(0,D.isNonEmptyString)(e.remote.twentyCLIRefreshToken);return o.push({id:`credentials`,status:t?`warning`:`fail`,code:`AUTH_REQUIRED`,message:t?`The OAuth access token has expired. A refresh token is saved, but renewal has not been verified.`:`The saved OAuth access token has expired and no refresh token is available.`,hint:`Run twenty auth status with the same remote to refresh the session, or sign in again. Doctor does not refresh credentials.`}),[...o,{id:`metadata-api`,status:`skipped`,message:`The access token has expired.`}]}f={apiUrl:i,source:e.source,...e.source===`remote`?{remoteName:e.remoteName}:{},credentialKind:p,bearerToken:h},o.push({id:`credentials`,status:`pass`,message:`${p===`oauth`?`OAuth token`:`API key`} configured; acceptance is checked separately.`,details:{kind:p}})}catch(e){a.throwIfAborted();let t=e instanceof s.t?e.code:`INTERNAL_ERROR`;return o.push({id:`target`,status:t===`TARGET_REQUIRED`?`skipped`:`fail`,code:t,message:e instanceof s.t?e.message:`Could not select a workspace.`,hint:e instanceof s.t?e.hint:void 0}),[...o,{id:`credentials`,status:`skipped`,message:`No workspace was selected.`},{id:`metadata-api`,status:`skipped`,message:`No workspace was selected.`}]}if(i)return[...o,{id:`metadata-api`,status:`skipped`,message:`Network checks disabled by --offline.`}];try{a.throwIfAborted(),await b.t({target:f,signal:a}),o.push({id:`metadata-api`,status:`pass`,message:`The metadata endpoint accepted the configured credentials.`,details:{...h.t(f)}})}catch(e){a.throwIfAborted(),o.push(A(e))}return o},M=async e=>{for(let t of o.n((0,C.dirname)(e))){let n=await a.n((0,C.join)(t,`package.json`));if(!r.zt(n))continue;let i=n.bin,o=(0,D.isString)(i)&&n.name===`twenty`?i:void 0,s=r.d(i)&&(0,D.isString)(i.twenty)?i.twenty:o;if(r.zt(s)&&await(0,S.realpath)((0,C.resolve)(t,s)).catch(()=>void 0)===e)return{name:(0,D.isString)(n.name)?n.name:`unknown`,version:(0,D.isString)(n.version)?n.version:`unknown`}}return null},N=async({environment:e,workingDirectory:t,signal:n})=>{let a=[],o=process.platform===`win32`?[`twenty.exe`,`twenty.cmd`,`twenty.bat`,`twenty`]:[`twenty`],s=r.zt(e.PATH)?e.PATH.split(C.delimiter):[];for(let e of new Set(s))for(let r of o){n.throwIfAborted();let i=(0,C.resolve)(t,e,r);if(!await(0,S.access)(i,w.constants.X_OK).then(()=>(0,S.stat)(i).then(e=>e.isFile()),()=>!1))continue;let o=await(0,S.realpath)(i);a.push({path:i,resolvedPath:o,owner:await M(o)})}let c=a[0],l=process.argv[1],u=r.zt(l)?await(0,S.realpath)((0,C.resolve)(t,l)).catch(()=>void 0):void 0,d=a.filter(e=>e.owner?.name===`twenty-sdk`);return i.r(d)?{id:`path`,status:`warning`,message:`PATH contains legacy twenty-sdk executable(s) named twenty: ${d.map(e=>e.path).join(`, `)}.`,hint:`If this is a global twenty-sdk installation, remove it before installing the twenty CLI so the CLI owns the twenty name. Removing the SDK afterward can remove that executable link. Keep app-local SDK dependencies; use the intended CLI by its full path when needed. Doctor does not change installations.`,details:{candidates:a}}:r.zt(c)?r.zt(u)&&c.resolvedPath!==u?{id:`path`,status:`warning`,message:`${c.path} is first on PATH and differs from the running CLI.`,hint:`Use the intended executable by its full path, or review PATH order. Shell aliases, functions and command caches are not inspected.`,details:{candidates:a,runningPath:u}}:{id:`path`,status:c.owner?.name===`twenty`?`pass`:`warning`,message:r.zt(c.owner)?`First twenty executable on PATH: ${c.path} (${c.owner.name} ${c.owner.version}).`:`First twenty executable on PATH: ${c.path}. Its package owner could not be determined.`,hint:`Shell aliases, functions and command caches are not inspected.`,details:{candidates:a}}:{id:`path`,status:`warning`,message:`No executable named twenty was found on PATH.`,hint:`Use the CLI entry point shown above, or your package manager to invoke the installed CLI.`,details:{candidates:a}}},P=async({explicitPath:e,workingDirectory:t,signal:n})=>{let i;n.throwIfAborted();try{i=await p.t({explicitPath:e,workingDirectory:t})}catch(t){return n.throwIfAborted(),[{id:`project`,status:!r.zt(e)&&t instanceof s.t&&(t.code===`APP_NOT_FOUND`||t.code===`APP_PATH_REQUIRED`)?`skipped`:`fail`,message:t instanceof s.t?t.message:`Could not inspect the app directory.`,hint:`Use --path <app directory> to check a specific app.`},{id:`sdk`,status:`skipped`,message:`No app was selected.`}]}let a={id:`project`,status:`pass`,message:`${i.name} at ${i.path}.`,details:{name:i.name,path:i.path}};try{n.throwIfAborted();let e=await c.t({appPath:i.path});return[a,{id:`sdk`,status:`pass`,message:`twenty-sdk ${e.version} provides the authoring exports required by the CLI.`,details:{version:e.version,path:e.packagePath}}]}catch(e){return n.throwIfAborted(),[a,{id:`sdk`,status:`fail`,code:e instanceof s.t?e.code:`INTERNAL_ERROR`,message:e instanceof s.t?e.message:`Could not inspect the app SDK installation.`,hint:e instanceof s.t?e.hint:`Check that the app dependencies are installed and readable.`}]}},F=()=>{let e=n.t({version:process.versions.node,range:t.t.node})===`satisfied`;return[{id:`node`,status:e?`pass`:`fail`,message:`Node ${process.versions.node}, required ${t.t.node}.`,...e?{}:{hint:`Switch to a supported Node version and rerun doctor.`},details:{version:process.versions.node,required:t.t.node}},{id:`cli`,status:`pass`,message:`twenty ${m.t}, entry point ${process.argv[1]??`unknown`}.`,details:{version:m.t,nodeExecutable:process.execPath,entryPoint:process.argv[1]??null,platform:process.platform,arch:process.arch}}]},I=async({options:e,signal:t,outputMode:n})=>{let r=F(),a=process.cwd();try{r.push(await N({environment:process.env,workingDirectory:a,signal:t}))}catch{t.throwIfAborted(),r.push({id:`path`,status:`fail`,message:`Could not inspect executables on PATH.`})}r.push(...await P({explicitPath:u.r(e,`path`),workingDirectory:a,signal:t})),r.push(...await j({environment:process.env,configPath:_.t(),remoteFlag:u.r(e,`remote`),offline:u.t(e,`offline`),signal:t})),t.throwIfAborted();let o=r.filter(e=>e.status===`fail`),c=E(r,i.r(o)?process.stderr:process.stdout);if(i.r(o))throw new s.t({code:`DOCTOR_FAILED`,message:`${o.length} doctor ${o.length===1?`check`:`checks`} failed.`,hint:n===`human`?c:`Read error.details.checks for the failures and recovery hints.`,details:{checks:r}});return{data:{checks:r},human:c}};exports.runDoctorCommand=I;
@@ -0,0 +1,3 @@
1
+ const e=require("./build-CX6FBrbu.cjs"),t=require("./constants-CL6mrTMT-B748cNNG.cjs"),n=require("./utils-B8EXJeaX-DK3gCslL.cjs"),r=require("./cli-error-CSsayo0u.cjs"),i=require("./read-command-values-uSJqBG_E.cjs"),a=require("./format-details-COEwKz_M.cjs"),o=require("./format-table-4drtI5sP.cjs"),s=require("./format-metadata-owner-yUeocnwY.cjs"),c=require("./fetch-metadata-inspection-Dp034TpK.cjs"),l=require("./format-metadata-fields-DJnTg1R9.cjs");var u=e.t(),d=e=>t.zt(e)?String(e):`unknown`,f=async({arguments:e,target:f,signal:p,output:m})=>{let h=i.n(e,1)??``,{object:g,fields:_}=await c.t({objectName:i.n(e,0)??``,target:f,signal:p,output:m}),v=_.filter(e=>e.name===h);if(v.length>1)throw new r.t({code:`AMBIGUOUS_RESOURCE`,exitCode:r.n.USAGE,message:`More than one field has the API name ${h} on ${g.namePlural}.`});let y=v[0];if(!t.zt(y))throw new r.t({code:`NOT_FOUND`,exitCode:r.n.NOT_FOUND,message:`No field has the API name ${h} on ${g.namePlural}.`,hint:`Use an exact API name from twenty metadata field list ${g.namePlural} --all.`});let b=l.r(y);return{data:{object:g,field:y},human:[`${y.label} (${y.name}) on ${g.namePlural}`,a.t([[`ID`,y.id],[`Type`,y.type],[`Owner`,s.t(y.owner)],[`Active`,d(y.isActive)],[`System`,d(y.isSystem)],[`Nullable`,d(y.isNullable)],[`Unique`,d(y.isUnique)],[`Default`,JSON.stringify(y.defaultValue??null)]]),y.description??``,l.n(y),n.r(b)?o.t({rows:b,columns:[{header:`OPTION`,value:e=>String(e.label??``)},{header:`VALUE`,value:e=>String(e.value??``)},{header:`COLOR`,value:e=>String(e.color??``)}]}):``].filter(u.isNonEmptyString).join(`
2
+
3
+ `)}};exports.runMetadataFieldDescribeCommand=f;
@@ -0,0 +1,3 @@
1
+ const e=require("./read-command-values-uSJqBG_E.cjs"),t=require("./fetch-metadata-inspection-Dp034TpK.cjs"),n=require("./format-metadata-fields-DJnTg1R9.cjs");var r=({fields:e,includeSystemFields:t})=>{let n=e.filter(e=>t||e.isSystem!==!0);return{fields:n,hiddenSystemFieldCount:e.length-n.length}},i=async({arguments:i,options:a,target:o,signal:s,output:c})=>{let l=await t.t({objectName:e.n(i,0)??``,target:o,signal:s,output:c}),{object:u}=l,{fields:d,hiddenSystemFieldCount:f}=r({fields:l.fields,includeSystemFields:e.t(a,`all`)});return{data:{object:u,fields:d,hiddenSystemFieldCount:f},human:[`${u.labelPlural} (${u.namePlural})`,n.t({fields:d,hiddenSystemFieldCount:f,labelIdentifierFieldMetadataId:u.labelIdentifierFieldMetadataId})].join(`
2
+
3
+ `)}};exports.runMetadataFieldListCommand=i;
@@ -0,0 +1,3 @@
1
+ const e=require("./build-CX6FBrbu.cjs"),t=require("./read-command-values-uSJqBG_E.cjs"),n=require("./style-BR52fK4V.cjs"),r=require("./format-data-value-B6rIbpJv.cjs"),i=require("./format-details-COEwKz_M.cjs"),a=require("./format-metadata-owner-yUeocnwY.cjs"),o=require("./fetch-metadata-inspection-Dp034TpK.cjs");var s=e.t(),c=async({arguments:e,target:c,signal:l,output:u})=>{let{object:d}=await o.t({objectName:t.n(e,0)??``,target:c,signal:l,output:u});return{data:{object:d},human:[`${d.labelPlural} (${d.namePlural})`,i.t([[`ID`,d.id],[`API names`,`${d.nameSingular} / ${d.namePlural}`],...(0,s.isNonEmptyString)(d.description)?[[`Description`,r.r(d.description)]]:[],[`Owner`,a.t(d.owner)],[`Active`,String(d.isActive)],[`System`,String(d.isSystem)],[`Searchable`,String(d.isSearchable)]]),`Fields: ${n.r(`twenty metadata field list ${d.namePlural}`)}`].join(`
2
+
3
+ `)}};exports.runMetadataObjectDescribeCommand=c;
@@ -0,0 +1,2 @@
1
+ const e=require("./read-command-values-uSJqBG_E.cjs"),t=require("./style-BR52fK4V.cjs"),n=require("./create-metadata-client-ChjDalSi.cjs"),r=require("./format-table-4drtI5sP.cjs"),i=require("./metadata-page.constant-BkG4ndrO.cjs"),a=require("./format-metadata-owner-yUeocnwY.cjs");var o=[`standard`,`application`,`custom`,`unknown`],s=(e,t)=>e.query({objects:{__args:{paging:{first:i.t,after:t},filter:{}},pageInfo:{hasNextPage:!0,endCursor:!0},edges:{node:{nameSingular:!0,namePlural:!0,labelSingular:!0,labelPlural:!0,isSystem:!0,isActive:!0,applicationId:!0}}},currentWorkspace:{workspaceCustomApplicationId:!0}}),c=async({options:c,output:l,target:u,signal:d})=>{let f=e.t(c,`all`),p=n.t({target:u,signal:d}),[{objects:m,currentWorkspace:h},{applications:g,areOwnersNamed:_}]=await Promise.all([s(p),a.r(p)]),v=await i.n(async e=>e===void 0?m:(await s(p,e)).objects);_||l.warn({code:`OWNERS_UNAVAILABLE`,message:`Owners other than Custom show as unknown: listing apps needs the Applications permission.`});let y=a.n({applications:g,workspaceCustomApplicationId:h.workspaceCustomApplicationId}),b=v.map(({applicationId:e,...t})=>({...t,owner:y(e)})),x=b.filter(e=>f||!e.isSystem).sort((e,t)=>{let n=o.indexOf(e.owner.kind)-o.indexOf(t.owner.kind);return n===0?e.namePlural.localeCompare(t.namePlural):n}),S=b.length-x.length;return{data:{objects:x,hiddenSystemObjectCount:S},human:[r.t({rows:x,columns:[{header:`API NAME`,value:e=>e.namePlural},{header:`LABEL`,value:e=>e.isActive?e.labelPlural:`${e.labelPlural} ${t.i(`(inactive)`)}`},{header:`OWNER`,value:e=>a.t(e.owner)}]}),t.i(S>0?`${x.length} objects · ${S} system objects hidden, show them with --all`:`${x.length} objects`)].join(`
2
+ `)}};exports.runMetadataObjectListCommand=c;
@@ -0,0 +1 @@
1
+ const e=require("./build-CX6FBrbu.cjs"),t=require("./constants-CL6mrTMT-B748cNNG.cjs"),n=require("./cli-error-CSsayo0u.cjs"),r=require("./parse-api-url-BllxRdpE.cjs"),i=require("./read-command-values-uSJqBG_E.cjs"),a=require("./resolve-request-url-jC5kYwkn.cjs"),o=require("./is-interaction-allowed-ycbAFMIj.cjs"),s=require("./create-metadata-client-ChjDalSi.cjs"),c=require("./open-browser-LPuVspT7.cjs");var l=({workspaceUrl:e,page:r})=>{if(!t.zt(r))return e.href;let i=URL.parse(r,e);if(!t.zt(i)||i.origin!==e.origin||i.pathname.startsWith(`//`))throw new n.t({code:`USAGE`,exitCode:n.n.USAGE,message:`${r} is not a page of the workspace.`,hint:`Pass a path inside the workspace, for example settings/applications.`});return i.href},u=e.t(),d=(e,i)=>{let a=(0,u.isNonEmptyString)(e)?URL.parse(e):null;if(!t.zt(a)||!r.r.includes(a.protocol))throw new n.t({code:`INVALID_RESPONSE`,message:`${i} did not return a web address for this workspace.`});return a},f=async({target:e,signal:n})=>{let{currentWorkspace:r}=await s.t({target:e,signal:n}).query({currentWorkspace:{workspaceUrls:{customUrl:!0,subdomainUrl:!0}}}),i=r?.workspaceUrls,o=(0,u.isNonEmptyString)(i?.customUrl)?i.customUrl:i?.subdomainUrl;if((0,u.isNonEmptyString)(o))return d(o,e.apiUrl);let c=await a.r({apiUrl:e.apiUrl,signal:n})(a.t({apiUrl:e.apiUrl,path:`/.well-known/oauth-authorization-server`}),{headers:{Accept:`application/json`}}),l=await a.n(c),f=d(c.ok&&t.d(l)?l.authorization_endpoint:void 0,e.apiUrl);return new URL(f.origin)},p=async({arguments:e,options:t,outputMode:r,target:a,signal:s})=>{let u=i.t(t,`urlOnly`);if(!u&&!o.t({options:t,outputMode:r}))throw new n.t({code:`USAGE`,exitCode:n.n.USAGE,message:`twenty open only opens a browser in an interactive terminal, not with --no-input, JSON output, redirected stdin or in CI.`,hint:`Add --url-only to print the address instead.`});let d=l({workspaceUrl:await f({target:a,signal:s}),page:i.n(e,0)});return u?{data:{url:d},human:d}:(c.t(d),{data:{url:d},human:`Opening ${d} in your browser.`})};exports.runOpenCommand=p;
@@ -0,0 +1 @@
1
+ const e=require("./build-CX6FBrbu.cjs"),t=require("./style-BR52fK4V.cjs"),n=require("./get-config-path-C-D-QHuX.cjs"),r=require("./read-config-DUJ27809.cjs"),i=require("./get-credential-kind-JI9heHe2.cjs"),a=require("./credential-kind-labels.constant-CKdoQF8o.cjs"),o=require("./format-table-4drtI5sP.cjs");var s=e.t(),c=async()=>{let e=await r.t(n.t()),c=Object.entries(e.remotes).map(([t,n])=>({name:t,apiUrl:n.apiUrl,credentials:i.t(n),workspaceName:(0,s.isString)(n.workspaceName)?n.workspaceName:null,isDefault:t===e.defaultRemote})).sort((e,t)=>e.name.localeCompare(t.name));return c.length===0?{data:{remotes:c,defaultRemote:null},human:`No saved remotes. ${t.i(`Sign in with: `)}${t.r(`twenty auth login --url <url>`)}`}:{data:{remotes:c,defaultRemote:e.defaultRemote??null},human:o.t({rows:c,columns:[{header:` `,value:e=>e.isDefault?t.n(`green`,`●`):``},{header:`NAME`,value:e=>e.name},{header:`URL`,value:e=>e.apiUrl},{header:`AUTH`,value:e=>a.t[e.credentials]},{header:`WORKSPACE`,value:e=>e.workspaceName??``}]})}};exports.runRemoteListCommand=c;
@@ -0,0 +1,2 @@
1
+ const e=require("./read-command-values-uSJqBG_E.cjs"),t=require("./style-BR52fK4V.cjs"),n=require("./get-config-path-C-D-QHuX.cjs"),r=require("./find-remote-D48r20g0.cjs"),i=require("./update-config-BkKBEfAp.cjs");var a=async({arguments:a,signal:o})=>{let s=e.n(a,0)??``,c=await i.t({configPath:n.t(),signal:o,update:e=>{r.t(e,s);let{[s]:t,...n}=e.remotes,{defaultRemote:i,...a}=e,o=i===s;return{result:o,config:{...o?a:e,remotes:n}}}});return{data:{removed:s,wasDefault:c},human:[t.o(`Removed ${s}.`),...c?[t.i(` There is no default remote now. Pick one with: twenty remote use <name>`)]:[]].join(`
2
+ `)}};exports.runRemoteRemoveCommand=a;
@@ -0,0 +1 @@
1
+ const e=require("./cli-error-CSsayo0u.cjs"),t=require("./read-command-values-uSJqBG_E.cjs"),n=require("./style-BR52fK4V.cjs"),r=require("./get-config-path-C-D-QHuX.cjs"),i=require("./find-remote-D48r20g0.cjs"),a=require("./update-config-BkKBEfAp.cjs"),o=require("./validate-remote-name-w-qnr43w.cjs");var s=async({arguments:s,signal:c})=>{let l=t.n(s,0)??``,u=o.t(t.n(s,1)??``);return{data:{previousName:l,name:u,isDefault:await a.t({configPath:r.t(),signal:c,update:t=>{let n=i.t(t,l);if(Object.hasOwn(t.remotes,u))throw new e.t({code:`REMOTE_EXISTS`,exitCode:e.n.USAGE,message:`A remote named ${u} already exists.`,hint:`Pick another name, or remove it first: twenty remote remove ${u}`});let{[l]:r,...a}=t.remotes,o=t.defaultRemote===l;return{result:o,config:{...t,remotes:{...a,[u]:n},...o?{defaultRemote:u}:{}}}}})},human:n.o(`Renamed ${l} to ${u}.`)}};exports.runRemoteRenameCommand=s;
@@ -0,0 +1 @@
1
+ const e=require("./read-command-values-uSJqBG_E.cjs"),t=require("./style-BR52fK4V.cjs"),n=require("./get-config-path-C-D-QHuX.cjs"),r=require("./find-remote-D48r20g0.cjs"),i=require("./update-config-BkKBEfAp.cjs");var a=async({arguments:a,signal:o})=>{let s=e.n(a,0)??``,c=await i.t({configPath:n.t(),signal:o,update:e=>({result:r.t(e,s),config:{...e,defaultRemote:s}})});return{data:{defaultRemote:s,apiUrl:c.apiUrl},human:t.o(`Default remote is now ${s} ${t.i(`(${c.apiUrl})`)}`)}};exports.runRemoteUseCommand=a;
@@ -0,0 +1 @@
1
+ const e=require("./style-BR52fK4V.cjs"),t=require("./cli-version.constant-aSp8WZDh.cjs");var n=async()=>{let n={version:t.t,node:process.versions.node,platform:process.platform,arch:process.arch};return{data:n,human:`twenty ${n.version} ${e.i(`(node ${n.node}, ${n.platform}-${n.arch})`)}`}};exports.runVersionCommand=n;
@@ -0,0 +1 @@
1
+ const e=require("./build-CX6FBrbu.cjs"),t=require("./constants-CL6mrTMT-B748cNNG.cjs"),n=require("./utils-B8EXJeaX-DK3gCslL.cjs"),r=require("./cli-error-CSsayo0u.cjs"),i=require("./target-environment-variable.constant-D7z8AihP.cjs"),a=require("./find-remote-D48r20g0.cjs");var o=e.t(),s=e=>e.length<=1?e.join(``):`${e.slice(0,-1).join(`, `)} and ${e[e.length-1]}`,c=(e,t)=>{let n=e[t]?.trim();return(0,o.isNonEmptyString)(n)?n:void 0},l=(e,t)=>({source:`remote`,remoteName:t,remote:a.t(e,t)}),u=async({environment:e,remoteFlag:a,loadConfig:o,warn:u})=>{let d=c(e,i.t.REMOTE),f=c(e,i.t.API_URL),p=c(e,i.t.API_KEY);if(t.zt(a)){let r=Object.values(i.t).filter(n=>t.zt(c(e,n)));return n.r(r)&&u({code:`ENVIRONMENT_TARGET_IGNORED`,message:`Using remote ${a}. Ignoring ${s(r)}.`}),l(await o(),a)}if(t.zt(d)){if(t.zt(f)||t.zt(p))throw new r.t({code:`CONFLICTING_TARGET`,exitCode:r.n.USAGE,message:`${i.t.REMOTE} cannot be combined with ${i.t.API_URL} or ${i.t.API_KEY}.`,hint:`Unset one of them, or choose with --remote.`});return l(await o(),d)}if(t.zt(f)!==t.zt(p)){let e=t.zt(f)?i.t.API_KEY:i.t.API_URL;throw new r.t({code:`INCOMPLETE_TARGET`,exitCode:r.n.USAGE,message:`${e} is not set.`,hint:`Set both ${i.t.API_URL} and ${i.t.API_KEY}, or neither.`})}if(t.zt(f)&&t.zt(p))return{source:`environment`,apiUrl:f,apiKey:p};let m=await o();if(t.zt(m.defaultRemote))return l(m,m.defaultRemote);throw new r.t({code:`TARGET_REQUIRED`,exitCode:r.n.USAGE,message:`No workspace selected.`,hint:`Sign in with: twenty auth login --url <url>. Or set ${i.t.API_URL} and ${i.t.API_KEY}.`})};Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return u}});
@@ -0,0 +1 @@
1
+ const e=require("./constants-CL6mrTMT-B748cNNG.cjs"),t=require("./cli-error-CSsayo0u.cjs"),n=require("./parse-api-url-BllxRdpE.cjs"),r=require("./confirm-in-terminal-BxEM5lxE.cjs"),i=require("./read-config-DUJ27809.cjs"),a=require("./sign-in-with-browser-C3kC6uP2.cjs"),o=require("./update-config-BkKBEfAp.cjs"),s=require("./fetch-signed-in-identity-BhvaL3zp.cjs"),c=require("./get-credential-kind-JI9heHe2.cjs");var l=(r,i,a)=>{let o=Object.hasOwn(r.remotes,a)?r.remotes[a]:void 0;if(!e.zt(o)||c.t(o)!==`oauth`||o.twentyCLIAccessToken!==i.bearerToken||n.t({rawUrl:o.apiUrl,sourceName:a})!==i.apiUrl)throw new t.t({code:`CONFLICT`,exitCode:t.n.CONFLICT,message:`Remote ${a} changed while signing in again. No credentials were saved.`,hint:`Run the command again.`});return o},u=async({target:e,remoteName:t,error:n,configPath:c,output:u,signal:d})=>{if(l(await i.t(c),e,t),!await r.t({question:`Your session on ${t} is no longer valid. Sign in again now?`,signal:d}))throw n;let f=await a.t({apiUrl:e.apiUrl,output:u,signal:d}),p={...e,bearerToken:f.accessToken};return await s.t({target:p,signal:d}),await o.t({configPath:c,signal:d,update:n=>{let r=l(n,e,t);return{result:void 0,config:{...n,remotes:{...n.remotes,[t]:a.n({remote:r,credentials:{kind:`oauth`,...f}})}}}}}),p};exports.signInToRemoteAgain=u;
@@ -0,0 +1 @@
1
+ const e=require("./build-CX6FBrbu.cjs"),t=require("./constants-CL6mrTMT-B748cNNG.cjs"),n=require("./cli-error-CSsayo0u.cjs"),r=require("./request-oauth-tokens-C4KKlTQT.cjs"),i=require("./open-browser-LPuVspT7.cjs"),a=require("./oauth-timing.constant-BClMQcKn.cjs");let o=require("node:http"),s=require("node:crypto");var c=({remote:e,credentials:n})=>{let{apiKey:r,twentyCLIAccessToken:i,twentyCLIRefreshToken:a,twentyCLIRegistrationClientId:o,...s}=e;return{...s,...n.kind===`apiKey`?{apiKey:n.apiKey}:{twentyCLIAccessToken:n.accessToken,twentyCLIRegistrationClientId:n.clientId,...t.zt(n.refreshToken)?{twentyCLIRefreshToken:n.refreshToken}:{}}}},l=()=>{let e=(0,s.randomBytes)(32).toString(`base64url`);return{codeVerifier:e,codeChallenge:(0,s.createHash)(`sha256`).update(e).digest(`base64url`)}},u=e.t(),d=e=>{let n=e.address();if(!t.zt(n)||(0,u.isString)(n))throw Error(`The server is not listening on a TCP port.`);return n.port},f=`/callback`,p=e=>`<!doctype html><meta charset="utf-8"><title>Twenty CLI</title><body style="margin:0;display:grid;place-items:center;min-height:100vh;font-family:system-ui,sans-serif"><p>${e}</p></body>`,m=e=>new n.t({code:`OAUTH_FAILED`,message:e,hint:`Run twenty auth login again.`}),h=({url:e,state:n,issuer:r,isIssuerInResponse:i})=>{let a=e.searchParams.get(`iss`);if(i&&!t.zt(a))throw m(`The sign-in response does not say which server sent it.`);if(t.zt(a)&&a!==r)throw m(`The sign-in response came from ${a} instead of ${r}.`);if(e.searchParams.get(`state`)!==n)throw m(`The sign-in response does not match this login attempt.`);let o=e.searchParams.get(`error`);if((0,u.isNonEmptyString)(o))throw m(o===`access_denied`?`Sign-in was declined in the browser.`:`Sign-in failed: ${e.searchParams.get(`error_description`)??o}`);let s=e.searchParams.get(`code`);if(!(0,u.isNonEmptyString)(s))throw m(`The sign-in response has no authorization code.`);return s},g=async({state:e,issuer:t,isIssuerInResponse:r,signal:i})=>{let{promise:s,resolve:c,reject:l}=Promise.withResolvers();s.catch(()=>void 0);let u=(0,o.createServer)((n,i)=>{let a=new URL(n.url??`/`,`http://127.0.0.1`);if(a.pathname!==f){i.writeHead(404,{Connection:`close`}).end();return}try{let n=h({url:a,state:e,issuer:t,isIssuerInResponse:r});i.writeHead(200,{"Content-Type":`text/html; charset=utf-8`,Connection:`close`}).end(p(`Signed in. You can close this tab and go back to the terminal.`)),c(n)}catch(e){i.writeHead(400,{"Content-Type":`text/html; charset=utf-8`,Connection:`close`}).end(p(`Sign-in did not complete. Go back to the terminal for details.`)),l(e)}});await new Promise((e,t)=>{u.once(`error`,t),u.listen(0,`127.0.0.1`,()=>e())});let m=d(u),g=setTimeout(()=>l(new n.t({code:`TIMEOUT`,message:`Sign-in was not completed within ${a.t.SIGN_IN_TIMEOUT_MILLISECONDS/6e4} minutes.`,hint:`Run twenty auth login again.`})),a.t.SIGN_IN_TIMEOUT_MILLISECONDS),_=()=>l(i.reason),v=()=>{clearTimeout(g),i.removeEventListener(`abort`,_),u.closeAllConnections(),u.close()};return i.aborted&&(v(),i.throwIfAborted()),i.addEventListener(`abort`,_,{once:!0}),{redirectUri:`http://127.0.0.1:${m}${f}`,waitForCode:()=>s,close:v}},_=async({apiUrl:e,output:t,signal:n})=>{let a=await r.n({apiUrl:e,signal:n}),{codeVerifier:o,codeChallenge:c}=l(),u=(0,s.randomBytes)(16).toString(`base64url`),d=await g({state:u,issuer:a.issuer,isIssuerInResponse:a.isIssuerInResponse,signal:n});try{let s=new URL(a.authorizationEndpoint);s.searchParams.set(`response_type`,`code`),s.searchParams.set(`client_id`,a.clientId),s.searchParams.set(`code_challenge`,c),s.searchParams.set(`code_challenge_method`,`S256`),s.searchParams.set(`redirect_uri`,d.redirectUri),s.searchParams.set(`state`,u),t.progress(`Opening your browser to sign in to ${new URL(e).host}…`),i.t(s.href),t.progress(`If nothing opens, visit: ${s.href}`),t.progress(`Waiting for you to approve in the browser. Press Ctrl+C to cancel.`);let l=await d.waitForCode();return{...await r.t({apiUrl:e,tokenEndpoint:a.tokenEndpoint,parameters:{grant_type:`authorization_code`,code:l,code_verifier:o,redirect_uri:d.redirectUri,client_id:a.clientId},signal:n}),clientId:a.clientId}}finally{d.close()}};Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return _}});
@@ -0,0 +1 @@
1
+ let e=require("node:util");var t=(t,n=process.stdout)=>(0,e.styleText)(`dim`,t,{stream:n}),n=(t,n,r=process.stdout)=>(0,e.styleText)(t,n,{stream:r}),r=e=>n(`cyan`,e),i=(t,n=process.stdout)=>(0,e.styleText)(`bold`,t,{stream:n}),a=t=>`${(0,e.styleText)(`green`,`✓`,{stream:process.stdout})} ${t}`,o=t=>`${(0,e.styleText)(`red`,`✗`,{stream:process.stderr})} ${t}`,s=t=>`${(0,e.styleText)(`yellow`,`!`,{stream:process.stderr})} ${t}`;Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return i}});
@@ -0,0 +1 @@
1
+ var e={API_URL:`TWENTY_API_URL`,API_KEY:`TWENTY_API_KEY`,REMOTE:`TWENTY_REMOTE`};Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return e}});
@@ -0,0 +1 @@
1
+ const e=require("./cli-error-CSsayo0u.cjs"),t=require("./create-cancelled-error-DgrNfOv2.cjs");var n=(n,r)=>n instanceof e.t?n:r?.aborted===!0?t.t():new e.t({code:`INTERNAL_ERROR`,message:n instanceof Error?n.message:String(n)});Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return n}});
@@ -0,0 +1 @@
1
+ const e=require("./constants-CL6mrTMT-B748cNNG.cjs");var t=({apiUrl:t,source:n,remoteName:r})=>({...e.zt(r)?{remote:r}:{},apiUrl:t,source:n});Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return t}});
@@ -0,0 +1,2 @@
1
+ const e=require("./build-CX6FBrbu.cjs"),t=require("./constants-CL6mrTMT-B748cNNG.cjs"),n=require("./cli-error-CSsayo0u.cjs"),r=require("./target-environment-variable.constant-D7z8AihP.cjs"),i=require("./create-cancelled-error-DgrNfOv2.cjs"),a=require("./style-BR52fK4V.cjs");let o=require("node:path"),s=require("node:fs"),c=require("node:child_process");var l=({severity:e,code:n,message:r,file:i,line:o,column:s})=>{let c=[t.zt(i)?[i,o,s].filter(t.zt).join(`:`):void 0,a.i(n,process.stderr),r].filter(t.zt).join(` `);return e===`error`?a.a(c):a.s(c)},u=e.t(),d=e=>!t.zt(e)||(0,u.isString)(e),f=e=>!t.zt(e)||(0,u.isNumber)(e),p=e=>t.d(e)&&(e.severity===`error`||e.severity===`warning`)&&(0,u.isString)(e.code)&&(0,u.isString)(e.message)&&d(e.file)&&f(e.line)&&f(e.column),m=e=>t.d(e)&&(0,u.isString)(e.path)&&(0,u.isString)(e.role)&&(0,u.isString)(e.sourcePath)&&(0,u.isNumber)(e.size)&&(0,u.isString)(e.sha256),h=()=>new n.t({code:`WORKER_FAILED`,message:`The app worker returned a result this CLI cannot read.`,hint:`Check that the app and the CLI use compatible versions.`}),g=e=>{if(!(!t.d(e)||!(0,u.isString)(e.buildId)||!d(e.directory)||!(0,u.isString)(e.contentHash)||!t.d(e.application)||!(0,u.isString)(e.application.universalIdentifier)||!(0,u.isString)(e.application.name)||!(0,u.isString)(e.application.displayName)||!(0,u.isString)(e.manifestFormat)||!t.d(e.manifest)||!(0,u.isArray)(e.files)||!e.files.every(m)))return{data:{buildId:e.buildId,...(0,u.isString)(e.directory)?{directory:e.directory}:{},contentHash:e.contentHash,application:{universalIdentifier:e.application.universalIdentifier,name:e.application.name,displayName:e.application.displayName},manifestFormat:e.manifestFormat,manifest:e.manifest,files:e.files}}},_=e=>(0,u.isNull)(e)?{data:null}:void 0,v=({value:e,parseData:n})=>{if(!t.d(e)||!(0,u.isArray)(e.diagnostics)||!e.diagnostics.every(p))throw h();let r=e.diagnostics;if(e.success===!0){let i=n(e.data);if(!t.zt(i))throw h();return{success:!0,data:i.data,diagnostics:r}}if(e.success===!1&&t.d(e.error)&&(0,u.isString)(e.error.code)&&(0,u.isString)(e.error.message))return{success:!1,error:{code:e.error.code,message:e.error.message,...(0,u.isString)(e.error.hint)?{hint:e.error.hint}:{},...t.d(e.error.details)?{details:e.error.details}:{}},diagnostics:r};throw h()},y={CANCEL_GRACE_MILLISECONDS:3e3,OUTPUT_LIMIT_BYTES:64*1024},b=new Set([...Object.values(r.t),`TWENTY_APP_ACCESS_TOKEN`,`TWENTY_APP_APPLICATION_ACCESS_TOKEN`]),x=/^TWENTY_.*(TOKEN|KEY|SECRET|PASSWORD)$/,S=e=>Object.fromEntries(Object.entries(e).filter(([e])=>!b.has(e)&&!x.test(e))),C=e=>{let t=Buffer.alloc(e),n=0,r=!1;return{add:i=>{let a=i.copy(t,n,0,e-n);n+=a,r||=a<i.length},read:()=>({text:t.toString(`utf8`,0,n),isTruncated:r})}},w=()=>({modulePath:(0,o.join)((0,o.dirname)((0,s.realpathSync)(process.argv[1]??``)),`app-worker.cjs`),execArgv:[]}),T=e=>t.d(e)&&(e.type===`result`&&`result`in e&&(e.isSnapshotHeld===!0||e.isSnapshotHeld===!1)||e.type===`released`&&`release`in e||e.type===`failure`&&(0,u.isString)(e.message)&&(!t.zt(e.code)||(0,u.isString)(e.code))&&(!t.zt(e.hint)||(0,u.isString)(e.hint))&&(!t.zt(e.details)||t.d(e.details))),E=async({request:e,signal:r,useHeldSnapshot:a})=>{r.throwIfAborted();let{modulePath:o,execArgv:s}=w(),l=(0,c.fork)(o,[],{cwd:e.appPath,env:S(process.env),execArgv:s,serialization:`json`,stdio:[`ignore`,`pipe`,`pipe`,`ipc`]}),u=C(y.OUTPUT_LIMIT_BYTES),d=C(y.OUTPUT_LIMIT_BYTES);return l.stdout?.on(`data`,u.add),l.stderr?.on(`data`,d.add),new Promise((o,s)=>{let c,f,p,m,h,g=!1,_=()=>{let e=u.read(),t=d.read();return{stdout:e.text,stderr:t.text,isTruncated:e.isTruncated||t.isTruncated}},v=e=>{l.connected&&l.send(e),h=setTimeout(()=>l.kill(`SIGKILL`),y.CANCEL_GRACE_MILLISECONDS)},b=()=>v({type:`cancel`}),x=e=>{g||(g=!0,r.removeEventListener(`abort`,b),clearTimeout(h),e())},S=e=>{r.removeEventListener(`abort`,b),clearTimeout(h),m=(t.zt(a)?a({result:e.result,watchInputs:e.watchInputs,output:_()}):Promise.resolve()).then(()=>({isSuccessful:!0}),e=>({isSuccessful:!1,error:e})).finally(()=>v({type:`release`}))},C=({exitCode:e,exitSignal:a,heldOutcome:l})=>x(()=>{let u=_();if(t.zt(l)&&!l.isSuccessful){s(l.error);return}if(t.zt(c)){o({result:c.result,watchInputs:c.watchInputs,release:c.isSnapshotHeld?p?.release:c.release,isSnapshotHeld:c.isSnapshotHeld,output:u});return}if(r.aborted){s(i.t());return}let d=t.zt(a)?`signal ${a}`:`exit code ${e}`;s(new n.t({code:`WORKER_FAILED`,message:t.zt(f)?`The app worker failed: ${f.message}`:`The app worker stopped before finishing (${d}). App code or a dependency may have exited the process.`,hint:f?.hint,details:{...f?.details,workerErrorCode:f?.code,exitCode:e,signal:a,output:u}}))});r.addEventListener(`abort`,b,{once:!0}),l.on(`message`,e=>{if(T(e)){if(e.type===`released`){p=e;return}if(e.type===`failure`){f=e;return}c=e,e.isSnapshotHeld&&S(e)}}),l.on(`error`,e=>x(()=>s(new n.t({code:`WORKER_FAILED`,message:`The app worker could not run: ${e.message}`})))),l.on(`close`,(e,n)=>{if(!t.zt(m)){C({exitCode:e,exitSignal:n});return}m.then(t=>C({exitCode:e,exitSignal:n,heldOutcome:t})).catch(e=>x(()=>s(e)))}),l.send(e)})},D=e=>[[`stdout`,e.stdout],[`stderr`,e.stderr]].filter(([,e])=>(0,u.isNonEmptyString)(e.trim())).map(([t,n])=>({severity:`warning`,code:`PROJECT_OUTPUT`,message:`The app or twenty-sdk wrote to ${t}:\n${n.trimEnd()}${e.isTruncated?`
2
+ (output truncated)`:``}`}));Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return D}});
@@ -0,0 +1,2 @@
1
+ const e=require("./build-CX6FBrbu.cjs"),t=require("./constants-CL6mrTMT-B748cNNG.cjs"),n=require("./validate-app-path-Dau-PC0a.cjs"),r=require("./collect-watch-inputs-B9jWG4W0.cjs"),i=require("./resolve-project-typescript-CDY8BbmP.cjs"),a=require("./cli-error-CSsayo0u.cjs"),o=require("./get-tooling-error-context-C69TBSej.cjs");let s=require("node:path");var c=e.r({typecheckApplication:()=>d}),l=({diagnostic:e,appPath:n,typescript:r})=>{let i=t.zt(e.file)&&t.zt(e.start)?e.file.getLineAndCharacterOfPosition(e.start):void 0;return{severity:e.category===r.DiagnosticCategory.Warning?`warning`:`error`,code:`TS${e.code}`,message:r.flattenDiagnosticMessageText(e.messageText,`
2
+ `),...t.zt(e.file)?{file:(0,s.relative)(n,e.file.fileName)}:{},...t.zt(i)?{line:i.line+1,column:i.character+1}:{}}},u=({appPath:e,typescript:n})=>{let i=(0,s.join)(e,`tsconfig.json`),a=(e,t)=>(r.r(e),n.sys.readFile(e,t)),o=n.readConfigFile(i,a);if(t.zt(o.error))return[o.error];let c=n.parseJsonConfigFileContent(o.config,{...n.sys,readFile:a},e,{noEmit:!0},i);if(c.errors.length>0)return c.errors;let l=n.createCompilerHost(c.options),u=l.readFile;l.readFile=e=>(r.r(e),u(e));let d=l.fileExists;l.fileExists=e=>{let t=d(e);return t||r.i(e),t};let f=n.createProgram({host:l,rootNames:c.fileNames,options:c.options,projectReferences:c.projectReferences});return n.getPreEmitDiagnostics(f)},d=async({appPath:e,signal:t})=>{let r=await n.t(e);if(!r.success)return r;try{t?.throwIfAborted();let n=await i.t(e);t?.throwIfAborted();let r=u({appPath:e,typescript:n});t?.throwIfAborted();let a=r.map(t=>l({diagnostic:t,appPath:e,typescript:n}));return a.some(e=>e.severity===`error`)?{success:!1,error:{code:`TYPECHECK_FAILED`,message:`Typecheck failed.`},diagnostics:a}:{success:!0,data:null,diagnostics:a}}catch(e){return{success:!1,error:{code:t?.aborted?`CANCELLED`:e instanceof a.t?e.code:`TYPECHECK_FAILED`,message:e instanceof Error?e.message:String(e),...o.t(e)},diagnostics:[]}}};Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return d}});