diff --git a/.github/workflows/publish.yaml b/.github/workflows/publish.yaml index d1a4ca6..2374685 100644 --- a/.github/workflows/publish.yaml +++ b/.github/workflows/publish.yaml @@ -4,7 +4,7 @@ name: Publish to NPM on: push: tags: - - 'v[0-9]+.[0-9]+.[0-9]+' + - "v[0-9]+.[0-9]+.[0-9]+" permissions: contents: read @@ -20,7 +20,7 @@ jobs: - name: checkout uses: actions/checkout@v6 with: - fetch-depth: 0 # Fetch full history for branch verification + fetch-depth: 0 # Fetch full history for branch verification - name: verify tag is on main branch run: | @@ -33,8 +33,8 @@ jobs: - name: setup node uses: actions/setup-node@v6 with: - node-version: '20' - registry-url: 'https://registry.npmjs.org' + node-version: 22.x + registry-url: "https://registry.npmjs.org" - name: build and publish run: | diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml new file mode 100644 index 0000000..b1cfe32 --- /dev/null +++ b/.github/workflows/release.yaml @@ -0,0 +1,80 @@ +name: Release + +on: + push: + branches: [main, next, next-setup] +permissions: + id-token: write + contents: write + +jobs: + test: + runs-on: ubuntu-latest + strategy: + fail-fast: false + matrix: + node-version: ["22.x", "24.x", "26.x"] + + name: Test on Node ${{ matrix.node-version }} + steps: + - name: Checkout + uses: actions/checkout@v7 + + - name: Set up Docker + uses: docker/setup-buildx-action@v4 + + - name: Setup Node.js ${{ matrix.node-version }} + uses: actions/setup-node@v6 + with: + node-version: ${{ matrix.node-version }} + + - name: Install dependencies + run: npm ci + + - name: Build + run: npm run build + + - name: Run integration tests + env: + SKIP_TEARDOWN: false + REUSE_CONTAINER: false + NODE_ENV: test + FUSIONAUTH_TELEMETRY: false + run: npm test + timeout-minutes: 15 + + release: + name: Release + needs: test + runs-on: ubuntu-latest + defaults: + run: + shell: /usr/bin/bash -l -e -o pipefail {0} + steps: + - name: Checkout + uses: actions/checkout@v7 + with: + fetch-depth: 0 + + - name: Setup Node.js + uses: actions/setup-node@v6 + with: + node-version: 22.x + registry-url: "https://registry.npmjs.org" + + - name: Install dependencies + run: npm ci + + - name: Install semantic-release extra plugins + run: npm install --save-dev @semantic-release/changelog @semantic-release/git + + # - name: Lint + # run: npm run lint-fix + + - name: Build + run: npm run build + + - name: Release + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + run: npx semantic-release diff --git a/.github/workflows/integration-tests.yml b/.github/workflows/test.yaml similarity index 57% rename from .github/workflows/integration-tests.yml rename to .github/workflows/test.yaml index 3f98774..480be95 100644 --- a/.github/workflows/integration-tests.yml +++ b/.github/workflows/test.yaml @@ -1,37 +1,44 @@ -name: Integration Tests +name: Tests on: + push: workflow_dispatch: pull_request: branches: - main jobs: - integration-tests: + test: runs-on: ubuntu-latest - + strategy: + fail-fast: false + matrix: + node-version: ["22.x", "24.x", "26.x"] + + name: Test on Node ${{ matrix.node-version }} steps: - - uses: actions/checkout@v6 - + - name: Checkout + uses: actions/checkout@v7 + - name: Set up Docker uses: docker/setup-buildx-action@v4 - - - name: Setup Node.js + + - name: Setup Node.js ${{ matrix.node-version }} uses: actions/setup-node@v6 with: - node-version: '22' - + node-version: ${{ matrix.node-version }} + - name: Install dependencies - run: npm install - + run: npm ci + - name: Build run: npm run build - + - name: Run integration tests env: SKIP_TEARDOWN: false REUSE_CONTAINER: false NODE_ENV: test FUSIONAUTH_TELEMETRY: false - run: npm run test + run: npm test timeout-minutes: 15 diff --git a/.husky/commit-msg b/.husky/commit-msg new file mode 100644 index 0000000..70bd3dd --- /dev/null +++ b/.husky/commit-msg @@ -0,0 +1 @@ +npx --no-install commitlint --edit "$1" diff --git a/.husky/pre-commit b/.husky/pre-commit new file mode 100644 index 0000000..e69de29 diff --git a/.npmrc b/.npmrc index 7e26447..9555e17 100644 --- a/.npmrc +++ b/.npmrc @@ -1,2 +1 @@ tag-version-prefix="" -min-release-age=7 \ No newline at end of file diff --git a/AGENTS.md b/AGENTS.md index 1e9e6f5..3b6b715 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,9 +1,12 @@ -# FusionAuth CLI - Agent Guidelines +# FusionAuth CLI +FusionAuth CLI is a command-line tool for working with the FusionAuth CIAM platform. + +# Guidelines ## Build Commands - Build: `npm run build` (compiles TypeScript to `./dist/`) - No lint command configured -- No test framework - tests not implemented +- Tests use Node's built-in test runner (`node:test`); run `npm run test:unit` for fast unit tests or `npm test` for the full suite, including Docker-based integration tests under `__tests__/integration/`. ## Code Style Guidelines @@ -27,8 +30,14 @@ - Custom error reporting via `utils.reportError()` and `utils.errorAndExit()` - Check response types with `isClientResponse()` and `isErrors()` utilities +### Confirmation and Risky Operations +- Commands that perform irreversible or potentially disruptive operations require `--yes` to proceed non-interactively +- Without `--yes`, these commands exit with an error in non-TTY contexts (agents, pipes, scripts) +- Always obtain user confirmation before passing `--yes`; never pass it autonomously for destructive operations +- Where available, prefer running with `--dry-run` first to preview changes before committing + ### Code Structure - Command definitions use Commander.js with fluent API - JSDoc comments for function documentation - Async/await for asynchronous operations -- Template literals for string interpolation \ No newline at end of file +- Template literals for string interpolation diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..c3250d1 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,95 @@ +# [1.10.0-next.2](https://github.com/FusionAuth/fusionauth-node-cli/compare/v1.10.0-next.1...v1.10.0-next.2) (2026-11-19) + + +### Bug Fixes + +* **application:** removes extraneous testing file ([825e1a1](https://github.com/FusionAuth/fusionauth-node-cli/commit/825e1a16734757e2bd64b69bece1a5dad9a5b41e)) +* **application:** removes merge issue on testing workflow ([39c99db](https://github.com/FusionAuth/fusionauth-node-cli/commit/39c99dbafa0ec4c05f58292dcd9712628ae4ddff)) + +# [1.10.0-next.1](https://github.com/FusionAuth/fusionauth-node-cli/compare/v1.9.1-next.1...v1.10.0-next.1) (2026-11-16) + + +### Features + +* **noapp:** creates --barebones flag for kickstart:install ([#61](https://github.com/FusionAuth/fusionauth-node-cli/issues/61)) ([3d0e1e3](https://github.com/FusionAuth/fusionauth-node-cli/commit/3d0e1e35650125e4fe334c286baa46dfd95cc270)) + +# [1.10.0-next-setup.1](https://github.com/FusionAuth/fusionauth-node-cli/compare/v1.9.1-next-setup.3...v1.10.0-next-setup.1) (2026-10-14) + + +### Bug Fixes + +* **release:** adds new release workflows ([9350a16](https://github.com/FusionAuth/fusionauth-node-cli/commit/9350a169050d2385c4b4f0cfd76473894ee396d0)) +* **update:** fixes issue with ClientResponse in utils ([58760d7](https://github.com/FusionAuth/fusionauth-node-cli/commit/58760d74fd3aa9f60bfd1e5aa644516754855f79)) +* **update:** modifies path.join for testing errors ([aa6089b](https://github.com/FusionAuth/fusionauth-node-cli/commit/aa6089b9cc3b70e1a4efd325f8f5795ba99353a0)) +* **update:** tests datifying tmp file ([66b30c4](https://github.com/FusionAuth/fusionauth-node-cli/commit/66b30c46eed0ed68f99beb46982e6dc93140189a)) + + +### Features + +* **update:** adds application:update ([68e8e77](https://github.com/FusionAuth/fusionauth-node-cli/commit/68e8e77d79920231835c8a23d341ead05ea1c66d)), closes [#55](https://github.com/FusionAuth/fusionauth-node-cli/issues/55) + +## [1.9.1-next.1](https://github.com/FusionAuth/fusionauth-node-cli/compare/v1.9.0...v1.9.1-next.1) (2026-07-09) + + +### Bug Fixes + +* **release:** adds back github token ([cd34c52](https://github.com/FusionAuth/fusionauth-node-cli/commit/cd34c52382950ebea18dc6a6e07f68fb8b5e0697)) +* **release:** adds defaults ([fdac965](https://github.com/FusionAuth/fusionauth-node-cli/commit/fdac965d591b21a657fb105285b6c0898322c387)) +* **release:** adds dependency of test job ([3cd41cf](https://github.com/FusionAuth/fusionauth-node-cli/commit/3cd41cf2465965658abb6d07ce5e116da402fedd)) +* **release:** adds new release workflows ([9350a16](https://github.com/FusionAuth/fusionauth-node-cli/commit/9350a169050d2385c4b4f0cfd76473894ee396d0)) +* **release:** adds permissions to action ([d66921b](https://github.com/FusionAuth/fusionauth-node-cli/commit/d66921ba6c2289bdeacb9388c2d1b48ec474845d)) +* **release:** brings testing job into release action ([94551bd](https://github.com/FusionAuth/fusionauth-node-cli/commit/94551bdce7c7baafaae59c615b8e375329b122f5)) +* **release:** fixes commitlint issues ([ac51e58](https://github.com/FusionAuth/fusionauth-node-cli/commit/ac51e588f5c879c2580f1fa0ade6c7ccfed20884)) +* **release:** fixes typo in workflow ([53d1443](https://github.com/FusionAuth/fusionauth-node-cli/commit/53d1443b34cd24e177f9fd8964741519a6352de8)) +* **release:** makes release config common js ([ccefcad](https://github.com/FusionAuth/fusionauth-node-cli/commit/ccefcad70568436994732baedbb21d4c4fabeb5d)) +* **release:** removes extraneous test that was causing failure in build not local ([687bbd6](https://github.com/FusionAuth/fusionauth-node-cli/commit/687bbd6e766909aae65f5f50a550449c514f0c58)) +* **release:** removes PR action and corrects branch for testing push ([5a1059a](https://github.com/FusionAuth/fusionauth-node-cli/commit/5a1059a0c36313b2ba5c713288735f89973faee6)) +* **release:** replaces inline testing with test workflow chaining ([d5b77b7](https://github.com/FusionAuth/fusionauth-node-cli/commit/d5b77b7326925295e50ac3606194033c27e70e76)) +* **release:** stop committing build output and drop unused deps ([d64ac2c](https://github.com/FusionAuth/fusionauth-node-cli/commit/d64ac2c3b37c3a260e3f9e5f31464a2b873a8bfd)), closes [#45](https://github.com/FusionAuth/fusionauth-node-cli/issues/45) +* **release:** updates branches for workflow for main and next ([725d29c](https://github.com/FusionAuth/fusionauth-node-cli/commit/725d29c4216a3729c0d010cdcebf3b73aae508b9)) +* **release:** updates workflow away from quotations as per the github docs ([c6dbd1a](https://github.com/FusionAuth/fusionauth-node-cli/commit/c6dbd1a53ac9ad1d22cd11256446c9893a8ea132)) + +## [1.9.1-next-setup.2](https://github.com/FusionAuth/fusionauth-node-cli/compare/v1.9.1-next-setup.1...v1.9.1-next-setup.2) (2026-07-09) + + +### Bug Fixes + +* **release:** adds dependency of test job ([3cd41cf](https://github.com/FusionAuth/fusionauth-node-cli/commit/3cd41cf2465965658abb6d07ce5e116da402fedd)) + +## [1.9.1-next-setup.1](https://github.com/FusionAuth/fusionauth-node-cli/compare/v1.9.0...v1.9.1-next-setup.1) (2026-07-09) + + +### Bug Fixes + +* **release:** adds back github token ([cd34c52](https://github.com/FusionAuth/fusionauth-node-cli/commit/cd34c52382950ebea18dc6a6e07f68fb8b5e0697)) +* **release:** adds defaults ([fdac965](https://github.com/FusionAuth/fusionauth-node-cli/commit/fdac965d591b21a657fb105285b6c0898322c387)) +* **release:** adds permissions to action ([d66921b](https://github.com/FusionAuth/fusionauth-node-cli/commit/d66921ba6c2289bdeacb9388c2d1b48ec474845d)) +* **release:** brings testing job into release action ([94551bd](https://github.com/FusionAuth/fusionauth-node-cli/commit/94551bdce7c7baafaae59c615b8e375329b122f5)) +* **release:** fixes commitlint issues ([ac51e58](https://github.com/FusionAuth/fusionauth-node-cli/commit/ac51e588f5c879c2580f1fa0ade6c7ccfed20884)) +* **release:** fixes typo in workflow ([53d1443](https://github.com/FusionAuth/fusionauth-node-cli/commit/53d1443b34cd24e177f9fd8964741519a6352de8)) +* **release:** makes release config common js ([ccefcad](https://github.com/FusionAuth/fusionauth-node-cli/commit/ccefcad70568436994732baedbb21d4c4fabeb5d)) +* **release:** removes extraneous test that was causing failure in build not local ([687bbd6](https://github.com/FusionAuth/fusionauth-node-cli/commit/687bbd6e766909aae65f5f50a550449c514f0c58)) +* **release:** removes PR action and corrects branch for testing push ([5a1059a](https://github.com/FusionAuth/fusionauth-node-cli/commit/5a1059a0c36313b2ba5c713288735f89973faee6)) +* **release:** replaces inline testing with test workflow chaining ([d5b77b7](https://github.com/FusionAuth/fusionauth-node-cli/commit/d5b77b7326925295e50ac3606194033c27e70e76)) +* **release:** stop committing build output and drop unused deps ([d64ac2c](https://github.com/FusionAuth/fusionauth-node-cli/commit/d64ac2c3b37c3a260e3f9e5f31464a2b873a8bfd)), closes [#45](https://github.com/FusionAuth/fusionauth-node-cli/issues/45) +* **release:** updates branches for workflow for main and next ([725d29c](https://github.com/FusionAuth/fusionauth-node-cli/commit/725d29c4216a3729c0d010cdcebf3b73aae508b9)) +* **release:** updates workflow away from quotations as per the github docs ([c6dbd1a](https://github.com/FusionAuth/fusionauth-node-cli/commit/c6dbd1a53ac9ad1d22cd11256446c9893a8ea132)) + +## [1.8.3-next-setup.2](https://github.com/FusionAuth/fusionauth-node-cli/compare/v1.8.3-next-setup.1...v1.8.3-next-setup.2) (2026-07-08) + + +### Bug Fixes + +* **release:** stop committing build output and drop unused deps ([d64ac2c](https://github.com/FusionAuth/fusionauth-node-cli/commit/d64ac2c3b37c3a260e3f9e5f31464a2b873a8bfd)), closes [#45](https://github.com/FusionAuth/fusionauth-node-cli/issues/45) + +## [1.8.3-next-setup.1](https://github.com/FusionAuth/fusionauth-node-cli/compare/v1.8.2...v1.8.3-next-setup.1) (2026-07-08) + + +### Bug Fixes + +* **release:** adds back github token ([cd34c52](https://github.com/FusionAuth/fusionauth-node-cli/commit/cd34c52382950ebea18dc6a6e07f68fb8b5e0697)) +* **release:** adds defaults ([fdac965](https://github.com/FusionAuth/fusionauth-node-cli/commit/fdac965d591b21a657fb105285b6c0898322c387)) +* **release:** adds permissions to action ([d66921b](https://github.com/FusionAuth/fusionauth-node-cli/commit/d66921ba6c2289bdeacb9388c2d1b48ec474845d)) +* **release:** fixes commitlint issues ([ac51e58](https://github.com/FusionAuth/fusionauth-node-cli/commit/ac51e588f5c879c2580f1fa0ade6c7ccfed20884)) +* **release:** makes release config common js ([ccefcad](https://github.com/FusionAuth/fusionauth-node-cli/commit/ccefcad70568436994732baedbb21d4c4fabeb5d)) +* **release:** removes PR action and corrects branch for testing push ([5a1059a](https://github.com/FusionAuth/fusionauth-node-cli/commit/5a1059a0c36313b2ba5c713288735f89973faee6)) diff --git a/README.md b/README.md index 884cffe..42c5e82 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ The FusionAuth CLI is a command line tool for interacting with FusionAuth. It is ## Requirements -* A modern version of node (tested on 19, 20 and 22) +* A supported LTS version of Node.js — 22.22.0 or newer (tested in CI on 22, 24 and 26) * A FusionAuth instance (download it here: https://fusionauth.io/download) ## Installation & usage @@ -22,8 +22,25 @@ fusionauth --help; ``` Currently, the CLI supports the following commands: +- Application management + - `fusionauth application:create --name --profile --redirect-uri [--authorized-origin-url ]` - Create an application in one of a few pre-defined, standard security profiles (spa, native, or webapp), automatically configuring the associated OAuth/JWT settings (and CORS headers, for spa — native apps don't go through a browser's CORS enforcement, so this is skipped for native). `--authorized-origin-url` is required if the app will make cross-origin requests from the browser, since enabling CORS alone doesn't allow any origin through — the origin still needs to be added to the system's CORS allowlist. + - `fusionauth application:create [--name ] --data ` - Create an application from a full custom JSON configuration, for cases the standard profiles don't cover. The JSON's own `name` field is used unless `--name` is explicitly passed, in which case it overrides the JSON. + - `fusionauth application:update ` - Updates an application with provided data + - `--host` - Required. Provide a FusionAuth host URL or add it via an environment variable (`FUSIONAUTH_HOST`) + - `--key` - Required. Provide an API key with permissions for updating the given application or add via an environment variable( `FUSIONAUTH_API_KEY`) + - `-d, --data ` - Provide a data file containing all the properties you wish to update constructed like the body of an application update + - `-p, --prop ` - Update a single property in the application + - `fusionauth application:get ` - Get a JSON representation of an application's settings + - `--host` - Required. Provide a FusionAuth host URL or add it via an environment variable (`FUSIONAUTH_HOST`) + - `--key` - Required. Provide an API key with permissions for updating the given application or add via an environment variable( `FUSIONAUTH_API_KEY`) + - `-o, --output` - Optional. Writes the JSON object to the indicated file - Common config check - `fusionauth check:common-config` - Checks to make sure common configuration settings are set. +- OAuth 2.1 compliance check + - `fusionauth check:oauth-2-1` - Checks FusionAuth configuration for OAuth 2.1 compliance. +- Applications (beta) + - `fusionauth application:create --name --profile --redirect-uri [--authorized-origin-url ]` - Create an application in one of a few pre-defined, standard security profiles (spa, native, or webapp), automatically configuring the associated OAuth/JWT settings (and CORS headers, for spa — native apps don't go through a browser's CORS enforcement, so this is skipped for native). `--authorized-origin-url` is required if the app will make cross-origin requests from the browser, since enabling CORS alone doesn't allow any origin through — the origin still needs to be added to the system's CORS allowlist. + - `fusionauth application:create [--name ] --data ` - Create an application from a full custom JSON configuration, for cases the standard profiles don't cover. The JSON's own `name` field is used unless `--name` is explicitly passed, in which case it overrides the JSON. - Emails - `fusionauth email:download` - Download a specific template or all email templates from a FusionAuth server. - `fusionauth email:duplicate` - Duplicate an email template locally. @@ -123,12 +140,71 @@ npm run build; npx fusionauth -h; ``` +To run commands directly from source during development (without installing globally): +```bash +npm run build && node dist/index.js [options] + +# Example: +node dist/index.js check:oauth-2-1 --key --host http://localhost:9011 +``` + To see examples of use: https://fusionauth.io/docs/extend/code/lambdas/testing ## Troubleshooting If you run this multiple times in a row against a local instance, the number of admin users may be incorrect until you re-index. See [this issue for more](https://github.com/FusionAuth/fusionauth-issues/issues/3271). -## License +## OAuth 2.1 Compliance + +The `check:oauth-2-1` command validates your FusionAuth instance against OAuth 2.1 specification requirements ([draft-ietf-oauth-v2-1-15](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-v2-1-15)). + +### Usage + +```bash +# Check all applications across all tenants +fusionauth check:oauth-2-1 --key --host + +# Check a specific application +fusionauth check:oauth-2-1 --key --host --application-id + +# Check all applications in a specific tenant +fusionauth check:oauth-2-1 --key --host --tenant-id + +# Enforce strict mode (fail on deprecated grants) +fusionauth check:oauth-2-1 --key --host --strict + +# Output as JSON +fusionauth check:oauth-2-1 --key --host --json + +# Show verbose per-application breakdown +fusionauth check:oauth-2-1 --key --host --verbose +``` + +### What It Checks + +Only applications with both the `authorization_code` and `refresh_token` grants enabled are checked. + +**REQUIRED (causes exit 1 if failed):** +- PKCE enforcement set to "Required" on all applications (§7.5) +- Redirect URI validation set to "ExactMatch" — no wildcards (§4.1.3) +- HTTPS enforcement for all redirect URIs except localhost (§1.5) +- Refresh token rotation enabled via "OneTimeUse" usage policy (§4.3) +- Refresh token revocation on one-time token reuse enabled at the tenant level (§4.3) +- Tenant issuer properly configured — not default "acme.com" + +**WARNINGS (informational, does not cause exit 1):** +- DPoP (sender-constrained tokens) available for applications (§1.4.3) +- Authorization code lifetime ≤ 600 seconds (§7.5) +- No deprecated grants enabled — Implicit, Password (§10); use `--strict` to make this a failure + +### Known FusionAuth OAuth 2.1 Limitations + +FusionAuth does not fully implement all OAuth 2.1 security requirements. The following gaps exist: + +1. **Missing `iss` authorization response parameter** ([§7.14](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-v2-1-15#section-7.14)) + The `iss` authorization response parameter for mix-up mitigation doesn't appear to be supported — use distinct redirect URIs per authorization server as a workaround (§7.14.2). See [fusionauth-issues#1383](https://github.com/FusionAuth/fusionauth-issues/issues/1383). -This code is available as open source under the terms of the [Apache v2.0 License](https://opensource.org/licenses/Apache-2.0). +For more information: +- [OAuth 2.1 Specification (draft-ietf-oauth-v2-1-15)](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-v2-1-15) +- [FusionAuth OAuth Configuration](https://fusionauth.io/docs/apis/applications) +- [FusionAuth Tenant Configuration](https://fusionauth.io/docs/apis/tenants) diff --git a/__tests__/commands/application-create.test.js b/__tests__/commands/application-create.test.js new file mode 100644 index 0000000..52ae641 --- /dev/null +++ b/__tests__/commands/application-create.test.js @@ -0,0 +1,933 @@ +import { describe, test, beforeEach, afterEach } from 'node:test' +import assert from 'node:assert/strict' +import nock from 'nock' +import * as fs from 'node:fs' +import * as os from 'node:os' +import * as path from 'node:path' +import { executeApplicationCreate } from '../../src/commands/application-create.js' + +const FA_HOST = 'http://localhost:9011' +const API_KEY = 'test-api-key' +const TENANT_ID = '886a57e0-f2ac-440a-9a9d-d10c17b6f1a1' +const APP_ID = '3c219e58-ed0e-4b18-ad48-f4f92793ae32' +const REDIRECT_URI = 'https://example.com/callback' + +const BASE_OPTIONS = { + name: 'Test App', + key: API_KEY, + host: FA_HOST, +} + +function spaOptions(overrides = {}) { + return { ...BASE_OPTIONS, profile: 'spa', redirectUri: [REDIRECT_URI], ...overrides } +} + +function webappOptions(overrides = {}) { + return { ...BASE_OPTIONS, profile: 'webapp', redirectUri: [REDIRECT_URI], ...overrides } +} + +// Minimal successful createApplication response +const APP_RESPONSE = { + application: { + id: APP_ID, + name: 'Test App', + oauthConfiguration: { + clientId: APP_ID, + }, + }, +} + +// Minimal successful createApplication response with client secret (webapp) +const APP_RESPONSE_WITH_SECRET = { + application: { + id: APP_ID, + name: 'Test App', + oauthConfiguration: { + clientId: APP_ID, + clientSecret: 'super-secret', + }, + }, +} + +// Minimal successful system-configuration response (CORS already correct) +function systemConfigResponse(overrides = {}) { + return { + systemConfiguration: { + corsConfiguration: { + enabled: true, + allowedHeaders: ['dpop', 'Authorization', 'Accept', 'Content-Type'], + ...overrides, + }, + }, + } +} + +// Registers a GET /api/system-configuration mock reporting CORS as already +// compliant — used by every test where no CORS mutation should occur. +function mockCompliantSystemConfig() { + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse()) +} + +beforeEach(() => { + process.env.NODE_ENV = 'test' + nock.cleanAll() +}) + +afterEach(() => { + // Fail if any registered nock interceptors were not consumed + assert(nock.isDone(), `Unused nock interceptors: ${JSON.stringify(nock.pendingMocks())}`) +}) + +// --------------------------------------------------------------------------- +// Mode validation +// --------------------------------------------------------------------------- + +describe('mode validation', () => { + test('both --profile and --data provided returns error without making API calls', async () => { + const result = await executeApplicationCreate({ + ...spaOptions(), + data: '{"name":"x"}', + }) + assert.equal(result.success, false) + assert.match(result.error, /mutually exclusive/) + }) + + test('neither --profile nor --data provided returns error without making API calls', async () => { + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + }) + assert.equal(result.success, false) + assert.match(result.error, /required/) + }) + + test('--profile without --redirect-uri returns error without making API calls', async () => { + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + profile: 'spa', + }) + assert.equal(result.success, false) + assert.match(result.error, /--redirect-uri is required/) + }) + + test('--profile without --name returns error without making API calls', async () => { + const { name, ...optionsWithoutName } = spaOptions() + const result = await executeApplicationCreate(optionsWithoutName) + assert.equal(result.success, false) + assert.match(result.error, /--name is required/) + }) + + test('an invalid --profile value returns a clear error without making API calls', async () => { + // Direct library callers bypass Commander's .choices() validation, so + // executeApplicationCreate() must validate this itself rather than + // silently spreading `undefined` into an empty application object. + const result = await executeApplicationCreate(spaOptions({ profile: 'not-a-real-profile' })) + assert.equal(result.success, false) + assert.match(result.error, /--profile must be one of/) + assert.match(result.error, /spa/) + assert.match(result.error, /native/) + assert.match(result.error, /webapp/) + }) + + test('a --profile value that is an inherited Object property is rejected', async () => { + // `profile in profileDefaults` would incorrectly accept values like + // 'toString' or 'constructor', since `in` checks the prototype chain, + // not just own properties. profileDefaults['toString'] then resolves + // to the inherited Function, and {...profileDefaults['toString']} + // silently produces {} — reaching the exact "empty defaults, no + // security profile applied" bug this validation exists to prevent. + const result = await executeApplicationCreate(spaOptions({ profile: 'toString' })) + assert.equal(result.success, false) + assert.match(result.error, /--profile must be one of/) + }) +}) + +// --------------------------------------------------------------------------- +// --data parsing +// --------------------------------------------------------------------------- + +describe('--data parsing', () => { + test('inline JSON is parsed and sent', async () => { + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: JSON.stringify({ oauthConfiguration: { enabledGrants: ['authorization_code'] } }), + }) + assert.equal(result.success, true) + }) + + test('@file.json is read and parsed', async () => { + const tmp = path.join(os.tmpdir(), `test-app-${Date.now()}.json`) + fs.writeFileSync(tmp, JSON.stringify({ oauthConfiguration: {} })) + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + try { + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: `@${tmp}`, + }) + assert.equal(result.success, true) + } finally { + fs.unlinkSync(tmp) + } + }) + + test('malformed inline JSON returns error without making API calls', async () => { + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: '{not valid json', + }) + assert.equal(result.success, false) + assert.match(result.error, /JSON/) + }) + + test('--data "null" returns a clear validation error without making API calls', async () => { + // JSON.parse('null') succeeds (it's valid JSON), so this isn't caught + // by the malformed-JSON case above. Without a shape check, this would + // otherwise surface as a confusing downstream TypeError instead. + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: 'null', + }) + assert.equal(result.success, false) + assert.match(result.error, /--data JSON must be a non-null, non-array object/) + }) + + test('--data as a JSON array returns a clear validation error without making API calls', async () => { + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: '[1,2,3]', + }) + assert.equal(result.success, false) + assert.match(result.error, /--data JSON must be a non-null, non-array object/) + }) + + test('--data as a JSON primitive returns a clear validation error without making API calls', async () => { + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: '42', + }) + assert.equal(result.success, false) + assert.match(result.error, /--data JSON must be a non-null, non-array object/) + }) + + test('missing @file returns error without making API calls', async () => { + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: '@/does/not/exist.json', + }) + assert.equal(result.success, false) + assert.match(result.error, /Error reading --data file/) + }) + + test('--data mode preserves the JSON name when --name is omitted (full custom control)', async () => { + const { name, ...optionsWithoutName } = BASE_OPTIONS + + nock(FA_HOST) + .post('/api/application/', (body) => { + assert.equal(body.application.name, 'Name From JSON') + return true + }) + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate({ + ...optionsWithoutName, + data: JSON.stringify({ name: 'Name From JSON', oauthConfiguration: {} }), + }) + assert.equal(result.success, true) + }) + + test('--data mode overrides the JSON name when --name is explicitly provided', async () => { + nock(FA_HOST) + .post('/api/application/', (body) => { + assert.equal(body.application.name, 'Test App') // BASE_OPTIONS.name + return true + }) + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: JSON.stringify({ name: 'Name From JSON', oauthConfiguration: {} }), + }) + assert.equal(result.success, true) + }) + + test('--data mode preserves the JSON oauthConfiguration when the override flags are omitted', async () => { + nock(FA_HOST) + .post('/api/application/', (body) => { + const oauth = body.application.oauthConfiguration + assert.deepEqual(oauth.authorizedRedirectURLs, ['https://from-json.example.com/cb']) + assert.equal(oauth.logoutURL, 'https://from-json.example.com/logout') + assert.deepEqual(oauth.authorizedOriginURLs, ['https://from-json.example.com']) + return true + }) + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: JSON.stringify({ + oauthConfiguration: { + authorizedRedirectURLs: ['https://from-json.example.com/cb'], + logoutURL: 'https://from-json.example.com/logout', + authorizedOriginURLs: ['https://from-json.example.com'], + }, + }), + }) + assert.equal(result.success, true) + }) + + test('--redirect-uri overrides the JSON authorizedRedirectURLs when explicitly provided', async () => { + nock(FA_HOST) + .post('/api/application/', (body) => { + assert.deepEqual(body.application.oauthConfiguration.authorizedRedirectURLs, [REDIRECT_URI]) + return true + }) + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + redirectUri: [REDIRECT_URI], + data: JSON.stringify({ oauthConfiguration: { authorizedRedirectURLs: ['https://from-json.example.com/cb'] } }), + }) + assert.equal(result.success, true) + }) + + test('--logout-url overrides the JSON logoutURL when explicitly provided', async () => { + nock(FA_HOST) + .post('/api/application/', (body) => { + assert.equal(body.application.oauthConfiguration.logoutURL, 'https://override.example.com/logout') + return true + }) + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + logoutUrl: 'https://override.example.com/logout', + data: JSON.stringify({ oauthConfiguration: { logoutURL: 'https://from-json.example.com/logout' } }), + }) + assert.equal(result.success, true) + }) + + test('--authorized-origin-url overrides the JSON authorizedOriginURLs when explicitly provided', async () => { + nock(FA_HOST) + .post('/api/application/', (body) => { + assert.deepEqual(body.application.oauthConfiguration.authorizedOriginURLs, ['https://override.example.com']) + return true + }) + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + authorizedOriginUrl: ['https://override.example.com'], + data: JSON.stringify({ oauthConfiguration: { authorizedOriginURLs: ['https://from-json.example.com'] } }), + }) + assert.equal(result.success, true) + }) + + test('--data mode does not mutate system CORS configuration (unlike --profile spa)', async () => { + // Only register /api/application — if system-configuration is called, + // nock will throw and the afterEach isDone() check will also fail. + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + authorizedOriginUrl: ['https://override.example.com'], + data: JSON.stringify({ oauthConfiguration: {} }), + }) + assert.equal(result.success, true) + }) +}) + +// --------------------------------------------------------------------------- +// Profile defaults — request body assertions +// --------------------------------------------------------------------------- + +describe('profile defaults', () => { + test('spa profile sends correct oauthConfiguration and jwtConfiguration', async () => { + mockCompliantSystemConfig() + + nock(FA_HOST) + .post('/api/application/', (body) => { + const oauth = body.application.oauthConfiguration + const jwt = body.application.jwtConfiguration + assert.deepEqual(oauth.enabledGrants, ['authorization_code', 'refresh_token']) + assert.equal(oauth.proofKeyForCodeExchangePolicy, 'Required') + assert.equal(oauth.clientAuthenticationPolicy, 'NotRequired') + assert.equal(oauth.requireClientAuthentication, false) + assert.equal(oauth.generateRefreshTokens, true) + assert.equal(oauth.requireRegistration, true) + assert.deepEqual(oauth.authorizedRedirectURLs, [REDIRECT_URI]) + assert.equal(jwt.enabled, true) + assert.equal(jwt.timeToLiveInSeconds, 300) + assert.equal(jwt.refreshTokenUsagePolicy, 'OneTimeUse') + assert.equal(jwt.refreshTokenExpirationPolicy, 'SlidingWindow') + return true + }) + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions()) + assert.equal(result.success, true) + }) + + test('native profile sends same oauth defaults as spa', async () => { + nock(FA_HOST) + .post('/api/application/', (body) => { + const oauth = body.application.oauthConfiguration + assert.equal(oauth.proofKeyForCodeExchangePolicy, 'Required') + assert.equal(oauth.clientAuthenticationPolicy, 'NotRequired') + assert.equal(oauth.requireRegistration, true) + return true + }) + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + profile: 'native', + redirectUri: ['myapp://callback'], + }) + assert.equal(result.success, true) + }) + + test('native profile does not call system-configuration', async () => { + // Native apps don't go through a browser's CORS enforcement, so + // --profile native should not touch CORS at all, unlike spa. Only + // register /api/application — if system-configuration is called, + // nock will throw and the afterEach isDone() check will also fail. + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + profile: 'native', + redirectUri: ['myapp://callback'], + }) + assert.equal(result.success, true) + }) + + test('webapp profile sends confidential client settings', async () => { + nock(FA_HOST) + .post('/api/application/', (body) => { + const oauth = body.application.oauthConfiguration + const jwt = body.application.jwtConfiguration + assert.equal(oauth.proofKeyForCodeExchangePolicy, 'NotRequiredWhenUsingClientAuthentication') + assert.equal(oauth.clientAuthenticationPolicy, 'Required') + assert.equal(oauth.requireClientAuthentication, true) + assert.equal(oauth.requireRegistration, true) + assert.deepEqual(oauth.enabledGrants, ['authorization_code', 'refresh_token']) + assert.equal(jwt.timeToLiveInSeconds, 3600) + assert.equal(jwt.refreshTokenUsagePolicy, 'OneTimeUse') + assert.equal(jwt.refreshTokenExpirationPolicy, 'SlidingWindow') + return true + }) + .reply(200, APP_RESPONSE_WITH_SECRET) + + const result = await executeApplicationCreate(webappOptions()) + assert.equal(result.success, true) + assert.equal(result.clientSecret, 'super-secret') + }) + + test('webapp profile does not call system-configuration', async () => { + // Only register /api/application — if system-configuration is called, + // nock will throw and the afterEach isDone() check will also fail. + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(webappOptions()) + assert.equal(result.success, true) + }) + + test('optional profile options are included when provided', async () => { + // allowedOrigins already includes the origin below so this test can + // focus on the oauthConfiguration fields without also triggering the + // CORS-origin confirmation gate (covered separately). + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse({ allowedOrigins: ['https://example.com'] })) + + nock(FA_HOST) + .post('/api/application/', (body) => { + const oauth = body.application.oauthConfiguration + assert.deepEqual(oauth.authorizedOriginURLs, ['https://example.com']) + assert.equal(oauth.logoutURL, 'https://example.com/logout') + return true + }) + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions({ + authorizedOriginUrl: ['https://example.com'], + logoutUrl: 'https://example.com/logout', + })) + assert.equal(result.success, true) + }) +}) + +// --------------------------------------------------------------------------- +// ID overrides +// --------------------------------------------------------------------------- + +describe('ID overrides', () => { + test('--application-id is sent in the request URL and body', async () => { + mockCompliantSystemConfig() + + nock(FA_HOST) + .post(`/api/application/${APP_ID}`, (body) => { + assert.equal(body.application.id, APP_ID) + return true + }) + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions({ applicationId: APP_ID })) + assert.equal(result.success, true) + assert.equal(result.applicationId, APP_ID) + }) + + test('--application-id overrides id in --data', async () => { + const overrideId = 'aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee' + + nock(FA_HOST) + .post(`/api/application/${overrideId}`, (body) => { + assert.equal(body.application.id, overrideId) + return true + }) + .reply(200, { application: { id: overrideId, name: 'Test App', oauthConfiguration: { clientId: overrideId } } }) + + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: JSON.stringify({ id: 'original-id', name: 'Test App' }), + applicationId: overrideId, + }) + assert.equal(result.success, true) + assert.equal(result.applicationId, overrideId) + }) + + test('--tenant-id overrides tenantId in --data', async () => { + nock(FA_HOST) + .post('/api/application/', (body) => { + assert.equal(body.application.tenantId, TENANT_ID) + return true + }) + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: JSON.stringify({ tenantId: 'original-tenant' }), + tenantId: TENANT_ID, + }) + assert.equal(result.success, true) + }) +}) + +// --------------------------------------------------------------------------- +// Regression: tenant header scoping +// The X-FusionAuth-TenantId header must be absent on /api/system-configuration +// but present on /api/application when --tenant-id is supplied. +// --------------------------------------------------------------------------- + +describe('regression: tenant header scoping', () => { + test('X-FusionAuth-TenantId is absent on system-configuration call', async () => { + nock(FA_HOST, { + badheaders: ['X-FusionAuth-TenantId'], // fails if header IS present + }) + .get('/api/system-configuration') + .reply(200, systemConfigResponse()) + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions({ tenantId: TENANT_ID })) + assert.equal(result.success, true) + }) + + test('X-FusionAuth-TenantId is present on createApplication call when --tenant-id supplied', async () => { + mockCompliantSystemConfig() + + nock(FA_HOST, { + reqheaders: { 'x-fusionauth-tenantid': TENANT_ID }, + }) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions({ tenantId: TENANT_ID })) + assert.equal(result.success, true) + }) +}) + +// --------------------------------------------------------------------------- +// Regression: error attribution +// A failure in ensureCorsHeaders must not be reported as "Error creating application". +// --------------------------------------------------------------------------- + +describe('regression: error attribution', () => { + test('system-configuration 401 returns error before createApplication is called', async () => { + // Register system-config to return 401 + nock(FA_HOST) + .get('/api/system-configuration') + .reply(401) + + // Do NOT register /api/application — if it were called, afterEach isDone() would pass + // incorrectly. We rely on the nock.pendingMocks() check being empty as the success signal, + // but more importantly we assert result.success is false here. + const result = await executeApplicationCreate(spaOptions()) + assert.equal(result.success, false) + // createApplication was never called, so the message must not be misattributed + // to it — it should describe the actual (CORS retrieval) failure. + assert.match(result.error, /Error retrieving system configuration/) + assert.doesNotMatch(result.error, /Error creating application/) + }) + + test('CORS patch failure returns error before createApplication is called', async () => { + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse({ allowedHeaders: [] })) // missing headers → triggers patch + + nock(FA_HOST) + .patch('/api/system-configuration') + .reply(403) + + const result = await executeApplicationCreate(spaOptions({ yes: true })) + assert.equal(result.success, false) + assert.match(result.error, /Error updating CORS configuration/) + assert.doesNotMatch(result.error, /Error creating application/) + }) + + test('createApplication failure is correctly attributed to application creation', async () => { + // No CORS-related calls for webapp — createApplication is the only call made. + nock(FA_HOST) + .post('/api/application/') + .reply(500, {}) + + const result = await executeApplicationCreate(webappOptions()) + assert.equal(result.success, false) + assert.match(result.error, /Error creating application/) + }) + + test('rawError preserves the original structured FusionAuth error rather than a generic wrapper', async () => { + nock(FA_HOST) + .post('/api/application/') + .reply(400, { fieldErrors: { name: [{ message: 'is required' }] } }) + + const result = await executeApplicationCreate(webappOptions()) + assert.equal(result.success, false) + // rawError must be the original FusionAuth ClientResponse-shaped rejection + // (so errorAndExit/reportError can format fieldErrors/generalErrors), + // not the generic Error used for the human-readable `error` message. + assert.equal(result.rawError instanceof Error, false) + assert.equal(result.rawError.statusCode, 400) + assert.deepEqual(result.rawError.exception, { fieldErrors: { name: [{ message: 'is required' }] } }) + }) + + test('error message describes a duplicate-name failure instead of showing "[object Object]"', async () => { + // Real-world repro: creating an application with a name that already + // exists. FusionAuth's SDK rejects with a ClientResponse instance, + // which does NOT extend Error, so the old `e instanceof Error + // ? e.message : String(e)` always fell to String(e) — producing the + // literal, unhelpful "Error creating application: [object Object]". + nock(FA_HOST) + .post('/api/application/') + .reply(400, { generalErrors: [{ code: '[duplicate]', message: 'An Application with id or name [MyApp] already exists.' }] }) + + const result = await executeApplicationCreate(webappOptions()) + assert.equal(result.success, false) + assert.doesNotMatch(result.error, /\[object Object\]/) + // The detailed FusionAuth error lives in rawError (structured), not + // flattened into `error` — formatting that for display is a + // presentation-layer concern (see reportError()), not something baked + // into the result data itself. + assert.deepEqual(result.rawError.exception, { + generalErrors: [{ code: '[duplicate]', message: 'An Application with id or name [MyApp] already exists.' }], + }) + }) + + test('rawError is undefined for a direct, never-wrapped validation error', async () => { + // parseData() throws a plain Error directly (not via wrapError()), so + // it has no distinct .cause. Its message is already captured in + // `error` — if rawError also returned the same Error object, + // errorAndExit()/reportError() would print that message a second time. + const result = await executeApplicationCreate({ + ...BASE_OPTIONS, + data: '{not valid json', + }) + assert.equal(result.success, false) + assert.equal(result.rawError, undefined) + }) +}) + +// --------------------------------------------------------------------------- +// CORS header management +// --------------------------------------------------------------------------- + +describe('CORS header management', () => { + test('no PATCH when all required headers already present (any casing)', async () => { + // Only GET is registered — a PATCH would cause nock to throw + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse({ + allowedHeaders: ['DPoP', 'authorization', 'ACCEPT', 'Content-Type'], + })) + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions()) + assert.equal(result.success, true) + }) + + test('PATCH adds only missing headers, preserving existing ones', async () => { + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse({ + enabled: true, + allowedHeaders: ['Authorization', 'Content-Type'], // dpop and Accept missing + })) + + nock(FA_HOST) + .patch('/api/system-configuration', (body) => { + const headers = body.systemConfiguration.corsConfiguration.allowedHeaders + assert(headers.includes('Authorization'), 'should preserve existing Authorization') + assert(headers.includes('Content-Type'), 'should preserve existing Content-Type') + assert(headers.some(h => h.toLowerCase() === 'dpop'), 'should add dpop') + assert(headers.some(h => h.toLowerCase() === 'accept'), 'should add Accept') + return true + }) + .reply(200, {}) + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions({ yes: true })) + assert.equal(result.success, true) + }) + + test('PATCH sets enabled:true when CORS is disabled', async () => { + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse({ + enabled: false, + allowedHeaders: ['dpop', 'Authorization', 'Accept', 'Content-Type'], + })) + + nock(FA_HOST) + .patch('/api/system-configuration', (body) => { + assert.equal(body.systemConfiguration.corsConfiguration.enabled, true) + return true + }) + .reply(200, {}) + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions({ yes: true })) + assert.equal(result.success, true) + }) + + test('PATCH adds --authorized-origin-url to the system CORS allowlist', async () => { + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse({ allowedOrigins: ['https://existing.example.com'] })) + + nock(FA_HOST) + .patch('/api/system-configuration', (body) => { + const origins = body.systemConfiguration.corsConfiguration.allowedOrigins + assert(origins.includes('https://existing.example.com'), 'should preserve existing origin') + assert(origins.includes('https://myapp.example.com'), 'should add the new origin') + return true + }) + .reply(200, {}) + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions({ + yes: true, + authorizedOriginUrl: ['https://myapp.example.com'], + })) + assert.equal(result.success, true) + }) + + test('duplicate --authorized-origin-url values are not duplicated in the system CORS allowlist', async () => { + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse({ allowedOrigins: [] })) + + nock(FA_HOST) + .patch('/api/system-configuration', (body) => { + const origins = body.systemConfiguration.corsConfiguration.allowedOrigins + const count = origins.filter(o => o === 'https://myapp.example.com').length + assert.equal(count, 1, `'https://myapp.example.com' should appear exactly once, got ${count}`) + return true + }) + .reply(200, {}) + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions({ + yes: true, + // Same origin supplied twice via --authorized-origin-url. + authorizedOriginUrl: ['https://myapp.example.com', 'https://myapp.example.com'], + })) + assert.equal(result.success, true) + }) + + test('no PATCH when --authorized-origin-url is already in the system CORS allowlist', async () => { + // Headers/enabled already compliant too — only origins differ from the + // baseline, so this also exercises the "would otherwise early-return" + // path now correctly checking origins as well. + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse({ allowedOrigins: ['https://myapp.example.com'] })) + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions({ + authorizedOriginUrl: ['https://myapp.example.com'], + })) + assert.equal(result.success, true) + }) + + test('no PATCH for origins when allowedOrigins already contains "*"', async () => { + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse({ allowedOrigins: ['*'] })) + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions({ + authorizedOriginUrl: ['https://myapp.example.com'], + })) + assert.equal(result.success, true) + }) + + test('--authorized-origin-url is not required — no origin changes attempted when omitted', async () => { + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse()) + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions()) + assert.equal(result.success, true) + }) +}) + +// --------------------------------------------------------------------------- +// Confirmation gate (--yes) for CORS mutation +// Mutating system-wide CORS configuration must be gated behind +// confirmOrExit()/--yes. +// --------------------------------------------------------------------------- + +describe('confirmation gate for CORS mutation', () => { + test('non-interactive without --yes aborts before patching CORS or creating the application', async (t) => { + // process.exit is mocked so confirmOrExit() throws instead of actually + // exiting (see utils.ts docstring) — the throw is caught by + // executeApplicationCreate's try/catch and returned as a normal result. + // In production (unmocked), confirmOrExit() can still exit the process + // directly for a non-interactive caller without yes=true — see the + // documented exception to the "always returns a result" contract on + // executeApplicationCreate's JSDoc. It's only this test's mock that + // turns that exit into a returned result instead. + const exitMock = t.mock.method(process, 'exit', () => {}) + + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse({ allowedHeaders: [] })) // missing headers → would trigger patch + + // Deliberately no PATCH or POST /api/application interceptors registered — + // if either were called, afterEach's nock.isDone() check would fail. + + const result = await executeApplicationCreate(spaOptions()) + + assert.equal(result.success, false) + assert.equal(exitMock.mock.calls.length, 1, 'process.exit should be called once') + assert.equal(exitMock.mock.calls[0].arguments[0], 1) + }) + + test('--yes bypasses the confirmation prompt and proceeds with the CORS patch', async () => { + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse({ allowedHeaders: [] })) + + nock(FA_HOST) + .patch('/api/system-configuration') + .reply(200, {}) + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) + + const result = await executeApplicationCreate(spaOptions({ yes: true })) + + assert.equal(result.success, true) + }) + + test('a missing authorized origin alone (headers/enabled already compliant) still requires confirmation', async (t) => { + const exitMock = t.mock.method(process, 'exit', () => {}) + + nock(FA_HOST) + .get('/api/system-configuration') + .reply(200, systemConfigResponse()) // headers/enabled compliant; no allowedOrigins at all + + // Deliberately no PATCH or POST /api/application interceptors registered. + + const result = await executeApplicationCreate(spaOptions({ + authorizedOriginUrl: ['https://myapp.example.com'], + })) + + assert.equal(result.success, false) + assert.equal(exitMock.mock.calls.length, 1, 'process.exit should be called once') + }) +}) + +// --------------------------------------------------------------------------- +// Output — clientSecret presence/absence +// --------------------------------------------------------------------------- + +describe('output', () => { + test('clientSecret is returned for webapp profile', async () => { + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE_WITH_SECRET) + + const result = await executeApplicationCreate(webappOptions()) + assert.equal(result.success, true) + assert.equal(result.clientSecret, 'super-secret') + }) + + test('spa profile result includes name/applicationId/clientId and omits clientSecret', async () => { + mockCompliantSystemConfig() + + nock(FA_HOST) + .post('/api/application/') + .reply(200, APP_RESPONSE) // no clientSecret in response + + const result = await executeApplicationCreate(spaOptions()) + assert.equal(result.success, true) + assert.equal(result.clientSecret, undefined) + assert.equal(result.name, 'Test App') + assert.equal(result.applicationId, APP_ID) + assert.equal(result.clientId, APP_ID) + }) +}) diff --git a/__tests__/commands/application-get.test.js b/__tests__/commands/application-get.test.js new file mode 100644 index 0000000..93b28cb --- /dev/null +++ b/__tests__/commands/application-get.test.js @@ -0,0 +1,73 @@ +import { describe, test, beforeEach, afterEach, run } from 'node:test' +import assert, { throws } from 'node:assert/strict' +import nock from 'nock' +import * as fs from 'node:fs' +import * as os from 'node:os' +import * as path from 'node:path' +import { executeGet } from '../../src/commands/application/get.js' +import { chdir, cwd } from 'node:process' + + +beforeEach(() => { + process.env.NODE_ENV = 'test' + nock.cleanAll() +}) + +afterEach(() => { + // Fail if any registered nock interceptors were not consumed + assert(nock.isDone(), `Unused nock interceptors: ${JSON.stringify(nock.pendingMocks())}`) +}) + +const FA_HOST = 'http://localhost:9011' +const API_KEY = 'test-api-key' +const APP_ID = '3c219e58-ed0e-4b18-ad48-f4f92793ae32' + +const APP_RESPONSE = { + application: { + id: APP_ID, + name: 'Test App', + oauthConfiguration: { + clientId: APP_ID, + }, + }, +} + + + +const BASE_OPTIONS = { + key: API_KEY, + host: FA_HOST, +} + + +describe('application:get options checks', () => { + + test('returns data when no output is specified', async () => { + nock(FA_HOST) + .get(`/api/application/${APP_ID}`) + .reply(200, APP_RESPONSE) + + const result = await executeGet(APP_ID, BASE_OPTIONS) + assert.equal(result.success, true) + assert.deepEqual(result.data, APP_RESPONSE) + + }) + test('writes to specified file when provided', async () => { + nock(FA_HOST) + .get(`/api/application/${APP_ID}`) + .reply(200, APP_RESPONSE) + + const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), `/test-app-${Date.now()}`)) + try { + await executeGet(APP_ID, {...BASE_OPTIONS, output: tmpRoot + "/myFile.json"}) + const fileExists = fs.existsSync(tmpRoot + '/myFile.json') + assert.equal(fileExists, true, "Response file not created") + } catch(e) { + console.log(e) + } finally { + fs.rmSync(tmpRoot, {recursive: true}) + } + + }) + +}) \ No newline at end of file diff --git a/__tests__/commands/application-update.test.js b/__tests__/commands/application-update.test.js new file mode 100644 index 0000000..1cfae3c --- /dev/null +++ b/__tests__/commands/application-update.test.js @@ -0,0 +1,155 @@ +import { describe, test, beforeEach, afterEach, run } from 'node:test' +import assert from 'node:assert/strict' +import nock from 'nock' +import * as fs from 'node:fs' +import * as os from 'node:os' +import * as path from 'node:path' +import { executeUpdateAction, setNestedProps, splitProp } from '../../src/commands/application/update.js' + + +beforeEach(() => { + process.env.NODE_ENV = 'test' + nock.cleanAll() +}) + +afterEach(() => { + // Fail if any registered nock interceptors were not consumed + assert(nock.isDone(), `Unused nock interceptors: ${JSON.stringify(nock.pendingMocks())}`) +}) + +const FA_HOST = 'http://localhost:9011' +const API_KEY = 'test-api-key' +const APP_ID = '3c219e58-ed0e-4b18-ad48-f4f92793ae32' + +const APP_RESPONSE = { + application: { + id: APP_ID, + name: 'Test App', + oauthConfiguration: { + clientId: APP_ID, + }, + }, +} + + + +const BASE_OPTIONS = { + key: API_KEY, + host: FA_HOST, +} + +describe("test action function", () => { + + test("no data or props should error", async () => { + const result = await executeUpdateAction(APP_ID, {...BASE_OPTIONS}) + await assert.equal(result.success, false) + }) + + test("Prop option errors with improper syntax", async () => { + const result = await executeUpdateAction(APP_ID, {...BASE_OPTIONS, prop: ["something"]}) + await assert.equal(result.success, false) + }) + + test("errors when response isn't 200", async () => { + const tmp = path.join(os.tmpdir(), `test--${Date.now()}.json`) + const testJSON = { + application: { + authenticationTokenConfiguration: { + enabled: false + }, + baseURL: "http://myurl.com3" + } + } + fs.writeFileSync(tmp, JSON.stringify(testJSON, null, 2)) + + nock(FA_HOST) + .patch(`/api/application/${APP_ID}`) + .reply(400, APP_RESPONSE) + + const propResult = await executeUpdateAction((APP_ID), {...BASE_OPTIONS, prop: ["something=somethingelse"]}) + const dataResult = await executeUpdateAction((APP_ID), {...BASE_OPTIONS, data: tmp}) + await assert.equal(propResult.success, false) + await assert.equal(dataResult.success, false) + + }) + test("success when response is 200 for prop", async () => { + const tmp = path.join(os.tmpdir(), `test-${Date.now()}.json`) + const testJSON = { + application: { + authenticationTokenConfiguration: { + enabled: false + }, + baseURL: "http://myurl.com3" + } + } + fs.writeFileSync(tmp, JSON.stringify(testJSON, null, 2)) + + nock(FA_HOST) + .patch(`/api/application/${APP_ID}`) + .reply(200, APP_RESPONSE) + + const dataResult = await executeUpdateAction((APP_ID), {...BASE_OPTIONS, prop: ["something2=somethingelse"]}) + await assert.equal(dataResult.success, true) + + }) + test("success when response is 200 for prop", async () => { + nock(FA_HOST) + .patch(`/api/application/${APP_ID}`) + .reply(200, APP_RESPONSE) + + const propResult = await executeUpdateAction((APP_ID), {...BASE_OPTIONS, prop: ["something=somethingelse"]}) + await assert.equal(propResult.success, true) + + }) + + +}) + +describe("test utiltiy functions for update", () => { + test("setNestedProps functions properly", () => { + let obj = {} + const propString = "prop.propString" + const propStringValue = "test" + const propBool = "prop.propBool" + const propBoolValue = false + const propObject = "prop.propObject" + const propObjValue = { name: "value" } + const propArray = "prop.propArray" + const propArrayValue = [1,2,3] + + const expectedObject = { + prop: { + propString: "test", + propBool: false, + propObject: { name: "value" }, + propArray: [1,2,3], + deep: { + deeper: { + deepest: "string" + } + } + } + } + + setNestedProps(obj, propString, propStringValue) + setNestedProps(obj, propBool, propBoolValue) + setNestedProps(obj, propObject, propObjValue) + setNestedProps(obj, propArray, propArrayValue) + setNestedProps(obj, "prop.deep.deeper.deepest", "string") + assert.deepEqual(obj, expectedObject) + }), + test("splitProp works", () => { + const simpleString = 'myVar=myValue' + const actualObj = splitProp(simpleString) + const expectedObj = { key: "myVar", value: "myValue"} + assert.deepEqual(actualObj, expectedObj) + const arrayString = 'myArray=["string", "string2", 1]' + const actualArrayObj = splitProp(arrayString) + const expectedArrayObj = { key: "myArray", value: ["string", "string2", 1]} + assert.deepEqual(actualArrayObj, expectedArrayObj) + const objString = 'myObj={"name": "hi"}' + const actualObjObj = splitProp(objString) + const expectedObjObj = { key: "myObj", value: {name: "hi"}} + assert.deepEqual(actualObjObj, expectedObjObj) + }) +}) diff --git a/__tests__/commands/import-generate.test.js b/__tests__/commands/import-generate.test.js new file mode 100644 index 0000000..c64fc1f --- /dev/null +++ b/__tests__/commands/import-generate.test.js @@ -0,0 +1,64 @@ +import { describe, test } from "node:test" +import assert from "node:assert/strict" +import { getDeprecatedFlagUsage, importGenerate } from "../../src/commands/import-generate.js" + +describe('getDeprecatedFlagUsage()', () => { + test('returns empty array when no deprecated flags are used', () => { + const usage = getDeprecatedFlagUsage(['node', 'script', '--number-of-files', '5']) + assert.deepEqual(usage, []) + }) + + test('detects a bare deprecated flag (--flag value form)', () => { + const usage = getDeprecatedFlagUsage(['node', 'script', '--numberOfFiles', '5']) + assert.equal(usage.length, 1) + assert.deepEqual(usage[0], ['--numberOfFiles', '--number-of-files']) + }) + + test('detects a deprecated flag in --flag=value form', () => { + const usage = getDeprecatedFlagUsage(['node', 'script', '--numberOfFiles=5']) + assert.equal(usage.length, 1) + assert.deepEqual(usage[0], ['--numberOfFiles', '--number-of-files']) + }) + + test('detects multiple deprecated flags used together', () => { + const usage = getDeprecatedFlagUsage(['node', 'script', '--numberOfFiles', '5', '--groupId=abc']) + const oldFlags = usage.map(([old]) => old) + assert.ok(oldFlags.includes('--numberOfFiles')) + assert.ok(oldFlags.includes('--groupId')) + assert.equal(usage.length, 2) + }) + + test('does not flag the new kebab-case form as deprecated', () => { + const usage = getDeprecatedFlagUsage(['node', 'script', '--group-id', 'abc']) + assert.deepEqual(usage, []) + }) +}) + +describe('import:generate option parsing', () => { + test('deprecated --numberOfFiles populates the same option as --number-of-files', async () => { + let capturedOptions + importGenerate.action((options) => { capturedOptions = options }) + + await importGenerate.parseAsync(['--numberOfFiles', '5'], { from: 'user' }) + + assert.equal(capturedOptions.numberOfFiles, '5') + }) + + test('--number-of-files populates the same numberOfFiles property', async () => { + let capturedOptions + importGenerate.action((options) => { capturedOptions = options }) + + await importGenerate.parseAsync(['--number-of-files', '7'], { from: 'user' }) + + assert.equal(capturedOptions.numberOfFiles, '7') + }) + + test('deprecated --groupId populates the same option as --group-id', async () => { + let capturedOptions + importGenerate.action((options) => { capturedOptions = options }) + + await importGenerate.parseAsync(['--groupId', 'abc-123'], { from: 'user' }) + + assert.equal(capturedOptions.groupId, 'abc-123') + }) +}) diff --git a/__tests__/commands/kickstart-install.test.js b/__tests__/commands/kickstart-install.test.js new file mode 100644 index 0000000..ea24a7f --- /dev/null +++ b/__tests__/commands/kickstart-install.test.js @@ -0,0 +1,452 @@ +import { describe, test, beforeEach, afterEach } from 'node:test' +import assert from 'node:assert/strict' +import fs from 'node:fs' +import os from 'node:os' +import path from 'node:path' +import { fileURLToPath } from 'node:url' +import { + validateEmail, + validatePassword, + resolveInstallAnswers, + resolveResourcesDir, +} from '../../src/commands/kickstart-install.js' + +// --------------------------------------------------------------------------- +// validateEmail +// --------------------------------------------------------------------------- + +describe('validateEmail()', () => { + test('accepts a standard email address', () => { + assert.equal(validateEmail('admin@example.com'), true) + }) + + test('accepts an email with subdomain', () => { + assert.equal(validateEmail('user@mail.example.co.uk'), true) + }) + + test('rejects an address with no @', () => { + const result = validateEmail('notanemail') + assert.notEqual(result, true) + assert.match(result, /valid email/) + }) + + test('rejects an address with no domain', () => { + const result = validateEmail('user@') + assert.notEqual(result, true) + }) + + test('rejects an empty string', () => { + const result = validateEmail('') + assert.notEqual(result, true) + }) +}) + +// --------------------------------------------------------------------------- +// validatePassword +// --------------------------------------------------------------------------- + +describe('validatePassword()', () => { + test('accepts a password of exactly 8 characters', () => { + assert.equal(validatePassword('abcdefgh'), true) + }) + + test('accepts a long password', () => { + assert.equal(validatePassword('supersecretpassword123'), true) + }) + + test('rejects an empty password', () => { + const result = validatePassword('') + assert.notEqual(result, true) + assert.match(result, /required/) + }) + + test('rejects a password one character short of the minimum', () => { + const result = validatePassword('1234567') + assert.notEqual(result, true) + assert.match(result, /8 characters/) + }) +}) + +// --------------------------------------------------------------------------- +// resolveInstallAnswers — CLI options only (no prompts) +// --------------------------------------------------------------------------- + +describe('resolveInstallAnswers() — all options provided', () => { + let savedEnv + + beforeEach(() => { + savedEnv = process.env.TEST_ADMIN_PASS + process.env.TEST_ADMIN_PASS = 'supersecret' + }) + + afterEach(() => { + if (savedEnv === undefined) { + delete process.env.TEST_ADMIN_PASS + } else { + process.env.TEST_ADMIN_PASS = savedEnv + } + }) + + test('returns answers from CLI options without calling promptFn', async () => { + const neverCallMe = () => { + throw new Error('promptFn should not have been called') + } + + const answers = await resolveInstallAnswers( + { + adminEmail: 'agent@example.com', + adminPasswordEnv: 'TEST_ADMIN_PASS', + applicationName: 'My App', + }, + neverCallMe + ) + + assert.equal(answers.email, 'agent@example.com') + assert.equal(answers.password, 'supersecret') + assert.equal(answers.appName, 'My App') + }) +}) + +// --------------------------------------------------------------------------- +// resolveInstallAnswers — no CLI options (all prompts) +// --------------------------------------------------------------------------- + +describe('resolveInstallAnswers() — no options provided', () => { + test('calls promptFn with questions for all three fields', async () => { + let capturedQuestions + + const mockPrompt = async (questions) => { + capturedQuestions = questions + return { email: 'prompted@example.com', password: 'promptedpass', appName: 'Prompted App' } + } + + const answers = await resolveInstallAnswers({}, mockPrompt) + + assert.equal(answers.email, 'prompted@example.com') + assert.equal(answers.password, 'promptedpass') + assert.equal(answers.appName, 'Prompted App') + + const names = capturedQuestions.map((q) => q.name) + assert.ok(names.includes('email'), 'should ask for email') + assert.ok(names.includes('password'), 'should ask for password') + assert.ok(names.includes('appName'), 'should ask for appName') + }) +}) + +// --------------------------------------------------------------------------- +// resolveInstallAnswers — partial CLI options +// --------------------------------------------------------------------------- + +describe('resolveInstallAnswers() — only adminEmail provided', () => { + test('does not include email in prompt questions', async () => { + let capturedQuestions + + const mockPrompt = async (questions) => { + capturedQuestions = questions + return { password: 'promptedpass', appName: 'Prompted App' } + } + + const answers = await resolveInstallAnswers( + { adminEmail: 'cli@example.com' }, + mockPrompt + ) + + assert.equal(answers.email, 'cli@example.com') + assert.equal(answers.password, 'promptedpass') + assert.equal(answers.appName, 'Prompted App') + + const names = capturedQuestions.map((q) => q.name) + assert.ok(!names.includes('email'), 'should not ask for email') + assert.ok(names.includes('password'), 'should ask for password') + assert.ok(names.includes('appName'), 'should ask for appName') + }) +}) + +describe('resolveInstallAnswers() — only applicationName provided', () => { + test('does not include appName in prompt questions', async () => { + let capturedQuestions + + const mockPrompt = async (questions) => { + capturedQuestions = questions + return { email: 'prompted@example.com', password: 'promptedpass' } + } + + const answers = await resolveInstallAnswers( + { applicationName: 'CLI App' }, + mockPrompt + ) + + assert.equal(answers.appName, 'CLI App') + + const names = capturedQuestions.map((q) => q.name) + assert.ok(!names.includes('appName'), 'should not ask for appName') + assert.ok(names.includes('email'), 'should ask for email') + assert.ok(names.includes('password'), 'should ask for password') + }) +}) + +// --------------------------------------------------------------------------- +// resolveInstallAnswers — adminPasswordEnv resolution +// --------------------------------------------------------------------------- + +describe('resolveInstallAnswers() — admin-password-env', () => { + let savedEnv + + beforeEach(() => { + savedEnv = process.env.MY_ADMIN_PASS + }) + + afterEach(() => { + if (savedEnv === undefined) { + delete process.env.MY_ADMIN_PASS + } else { + process.env.MY_ADMIN_PASS = savedEnv + } + }) + + test('reads the password from the named environment variable', async () => { + process.env.MY_ADMIN_PASS = 'envpassword' + + const neverCallMe = () => { throw new Error('promptFn should not have been called') } + + const answers = await resolveInstallAnswers( + { + adminEmail: 'agent@example.com', + adminPasswordEnv: 'MY_ADMIN_PASS', + applicationName: 'Test App', + }, + neverCallMe + ) + + assert.equal(answers.password, 'envpassword') + }) + + test('throws when the named environment variable is not set', async () => { + delete process.env.MY_ADMIN_PASS + + await assert.rejects( + () => + resolveInstallAnswers( + { adminEmail: 'agent@example.com', adminPasswordEnv: 'MY_ADMIN_PASS', applicationName: 'App' }, + () => { throw new Error('should not prompt') } + ), + (err) => { + assert.match(err.message, /MY_ADMIN_PASS/) + assert.match(err.message, /not set/) + return true + } + ) + }) +}) + +// --------------------------------------------------------------------------- +// resolveInstallAnswers — CLI validation errors +// --------------------------------------------------------------------------- + +describe('resolveInstallAnswers() — CLI validation errors', () => { + test('throws on invalid --admin-email', async () => { + await assert.rejects( + () => + resolveInstallAnswers( + { adminEmail: 'not-an-email', adminPasswordEnv: undefined, applicationName: undefined }, + () => { throw new Error('should not prompt') } + ), + (err) => { + assert.match(err.message, /admin-email/) + assert.match(err.message, /valid email/) + return true + } + ) + }) + + test('throws when env var password is too short', async () => { + process.env.MY_ADMIN_PASS = 'short' + + try { + await assert.rejects( + () => + resolveInstallAnswers( + { + adminEmail: 'agent@example.com', + adminPasswordEnv: 'MY_ADMIN_PASS', + applicationName: 'App', + }, + () => { throw new Error('should not prompt') } + ), + (err) => { + assert.match(err.message, /admin-password-env/) + assert.match(err.message, /8 characters/) + return true + } + ) + } finally { + delete process.env.MY_ADMIN_PASS + } + }) + + test('throws when env var password is empty', async () => { + process.env.MY_ADMIN_PASS = '' + + try { + await assert.rejects( + () => + resolveInstallAnswers( + { + adminEmail: 'agent@example.com', + adminPasswordEnv: 'MY_ADMIN_PASS', + applicationName: 'App', + }, + () => { throw new Error('should not prompt') } + ), + (err) => { + assert.match(err.message, /admin-password-env/) + assert.match(err.message, /required/) + return true + } + ) + } finally { + delete process.env.MY_ADMIN_PASS + } + }) +}) + +// --------------------------------------------------------------------------- +// resolveInstallAnswers — inquirer validate functions are wired correctly +// --------------------------------------------------------------------------- + +describe('resolveInstallAnswers() — inquirer validate functions', () => { + test('email question uses validateEmail directly', async () => { + let capturedQuestions + + const mockPrompt = async (questions) => { + capturedQuestions = questions + return { email: 'good@example.com', password: 'goodpassword', appName: 'App' } + } + + await resolveInstallAnswers({}, mockPrompt) + + const emailQuestion = capturedQuestions.find((q) => q.name === 'email') + assert.ok(emailQuestion, 'email question should exist') + assert.equal(emailQuestion.validate, validateEmail) + }) + + test('password question uses validatePassword directly', async () => { + let capturedQuestions + + const mockPrompt = async (questions) => { + capturedQuestions = questions + return { email: 'good@example.com', password: 'goodpassword', appName: 'App' } + } + + await resolveInstallAnswers({}, mockPrompt) + + const passwordQuestion = capturedQuestions.find((q) => q.name === 'password') + assert.ok(passwordQuestion, 'password question should exist') + assert.equal(passwordQuestion.validate, validatePassword) + }) +}) + +// --------------------------------------------------------------------------- +// resolveResourcesDir() +// --------------------------------------------------------------------------- +// +// These use synthetic temp directories (via the injectable baseDir param) +// rather than the real repo layout, so all three logic branches are +// deterministically exercised regardless of whether a build has run — +// including the dist-layout branch, which this test file could never reach +// otherwise, since it always imports src/commands/kickstart-install.js via +// tsx, fixing __dirname to .../src/commands for the whole test run. + +describe('resolveResourcesDir()', () => { + const createdDirs = [] + + function mkTempDir(prefix) { + const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix)) + createdDirs.push(dir) + return dir + } + + afterEach(() => { + for (const dir of createdDirs.splice(0)) { + fs.rmSync(dir, { recursive: true, force: true }) + } + }) + + test('returns baseDir/resources when it exists (dist layout)', () => { + const baseDir = mkTempDir('resolve-resources-dist-') + const expected = path.join(baseDir, 'resources') + fs.mkdirSync(expected) + + assert.equal(resolveResourcesDir(baseDir), expected) + }) + + test('falls back to baseDir/../resources when baseDir/resources is missing (src layout)', () => { + const parent = mkTempDir('resolve-resources-src-') + const baseDir = path.join(parent, 'commands') + fs.mkdirSync(baseDir) + const expected = path.join(parent, 'resources') + fs.mkdirSync(expected) + // Deliberately no baseDir/resources — only the parent-level fallback exists. + + assert.equal(resolveResourcesDir(baseDir), expected) + }) + + test('prefers the dist layout when both exist', () => { + const parent = mkTempDir('resolve-resources-both-') + const baseDir = path.join(parent, 'commands') + fs.mkdirSync(baseDir) + fs.mkdirSync(path.join(parent, 'resources')) + const expected = path.join(baseDir, 'resources') + fs.mkdirSync(expected) + + assert.equal(resolveResourcesDir(baseDir), expected) + }) + + test('throws a clear error when neither layout exists', () => { + const baseDir = mkTempDir('resolve-resources-none-') + + assert.throws( + () => resolveResourcesDir(baseDir), + /Could not locate kickstart resources directory/ + ) + }) +}) + +// --------------------------------------------------------------------------- +// resolveResourcesDir() against the real built artifact (dist/) +// --------------------------------------------------------------------------- +// +// The tests above verify the function's logic in isolation; this verifies +// the actual distributable: that `npm run build`'s copy-files step really +// produces a dist/commands/resources directory the compiled command can +// find at its real __dirname, with the files kickstart:install needs. +// Skipped (not failed) when dist/ hasn't been built yet, so `test:unit` +// still works without requiring a build first — this is CI-meaningful +// since CI always runs `npm run build` before `npm test`. + +describe('resolveResourcesDir() against dist/ (built artifact)', () => { + const __dirname = path.dirname(fileURLToPath(import.meta.url)) + const distModulePath = '../../dist/commands/kickstart-install.js' + const distModuleFile = path.join(__dirname, distModulePath) + + test('resolves dist/commands/resources from the compiled module', async (t) => { + if (!fs.existsSync(distModuleFile)) { + t.skip('dist/ has not been built — run `npm run build` first to exercise this test') + return + } + + const dist = await import(distModulePath) + const resourcesDir = dist.resolveResourcesDir() + + assert.equal(resourcesDir, path.join(path.dirname(distModuleFile), 'resources')) + assert.ok(fs.existsSync(resourcesDir), `${resourcesDir} should exist`) + assert.ok( + fs.existsSync(path.join(resourcesDir, 'kickstart', 'fusionauth')), + `${resourcesDir}/kickstart/fusionauth should exist` + ) + assert.ok( + fs.existsSync(path.join(resourcesDir, 'kickstart', 'kickstart.json')), + `${resourcesDir}/kickstart/kickstart.json should exist` + ) + }) +}) diff --git a/__tests__/commands/kickstart-kill.test.js b/__tests__/commands/kickstart-kill.test.js new file mode 100644 index 0000000..37bcf08 --- /dev/null +++ b/__tests__/commands/kickstart-kill.test.js @@ -0,0 +1,128 @@ +import { describe, test, beforeEach, afterEach } from "node:test" +import assert from "node:assert/strict" +import { action } from "../../src/commands/kickstart-kill.js" + +/** + * Fake child-process-like object returned by mocked spawn — supports the + * minimal surface kickstart-kill's action() touches (.on, .stdout) without + * running any real process. + */ +function fakeChildProcess() { + return { + on: () => {}, + stdout: undefined, + } +} + +describe('kickstart:kill action()', () => { + // action() calls logEvent() internally (unmocked). Disable telemetry so it + // short-circuits before touching the real filesystem or network. + beforeEach(() => { + process.env.FUSIONAUTH_TELEMETRY = 'false' + }) + + afterEach(() => { + delete process.env.FUSIONAUTH_TELEMETRY + }) + + test('does not call confirmOrExit or spawn when Docker is not installed', async () => { + const confirmCalls = [] + const spawnCalls = [] + + await action( + { yes: false }, + { + isDockerInstalled: () => false, + confirmOrExit: async (...args) => { confirmCalls.push(args) }, + spawn: (...args) => { spawnCalls.push(args); return fakeChildProcess() }, + } + ) + + assert.equal(confirmCalls.length, 0, 'confirmOrExit should not be called') + assert.equal(spawnCalls.length, 0, 'spawn should not be called') + }) + + test('does not call confirmOrExit or spawn when CLI_DIR does not match cwd', async () => { + const originalCliDir = process.env.CLI_DIR + process.env.CLI_DIR = '/not/the/current/directory' + + const confirmCalls = [] + const spawnCalls = [] + + try { + await action( + { yes: false }, + { + isDockerInstalled: () => true, + confirmOrExit: async (...args) => { confirmCalls.push(args) }, + spawn: (...args) => { spawnCalls.push(args); return fakeChildProcess() }, + } + ) + } finally { + if (originalCliDir === undefined) { + delete process.env.CLI_DIR + } else { + process.env.CLI_DIR = originalCliDir + } + } + + assert.equal(confirmCalls.length, 0, 'confirmOrExit should not be called') + assert.equal(spawnCalls.length, 0, 'spawn should not be called') + }) + + test('yes=true calls confirmOrExit (which resolves immediately) then spawn', async () => { + const originalCliDir = process.env.CLI_DIR + process.env.CLI_DIR = process.cwd() + + const confirmCalls = [] + const spawnCalls = [] + + try { + await action( + { yes: true }, + { + isDockerInstalled: () => true, + confirmOrExit: async (...args) => { confirmCalls.push(args) }, + spawn: (...args) => { spawnCalls.push(args); return fakeChildProcess() }, + } + ) + } finally { + if (originalCliDir === undefined) { + delete process.env.CLI_DIR + } else { + process.env.CLI_DIR = originalCliDir + } + } + + assert.equal(confirmCalls.length, 1, 'confirmOrExit should be called once') + assert.equal(confirmCalls[0][1], true, 'confirmOrExit should receive yes=true') + assert.equal(spawnCalls.length, 1, 'spawn should be called once') + assert.equal(spawnCalls[0][0], 'docker compose down -v') + }) + + test('when confirmOrExit rejects (declined/non-interactive), spawn is never called', async () => { + const originalCliDir = process.env.CLI_DIR + process.env.CLI_DIR = process.cwd() + + const spawnCalls = [] + + try { + await action( + { yes: false }, + { + isDockerInstalled: () => true, + confirmOrExit: async () => { throw new Error('declined') }, + spawn: (...args) => { spawnCalls.push(args); return fakeChildProcess() }, + } + ) + } finally { + if (originalCliDir === undefined) { + delete process.env.CLI_DIR + } else { + process.env.CLI_DIR = originalCliDir + } + } + + assert.equal(spawnCalls.length, 0, 'spawn should not be called') + }) +}) diff --git a/__tests__/helpers/temp-dir.js b/__tests__/helpers/temp-dir.js new file mode 100644 index 0000000..6eb841c --- /dev/null +++ b/__tests__/helpers/temp-dir.js @@ -0,0 +1,26 @@ +import fs from 'node:fs' +import os from 'node:os' +import path from 'node:path' + +/** + * Creates a real, unique temporary directory outside the repo (under the OS + * temp dir) for tests that need to exercise real filesystem behavior instead + * of mocking it. Prefer this over mock-fs, which has had shaky support for + * newer Node versions. + * + * @param prefix Prefix for the generated directory name. + * @returns The absolute path to the newly created temp directory. + */ +export function createTempDir(prefix = 'fa-cli-') { + return fs.mkdtempSync(path.join(os.tmpdir(), prefix)) +} + +/** + * Recursively removes a temp directory created by createTempDir(). Safe to + * call even if the directory doesn't exist. + * + * @param dir The directory to remove. + */ +export function removeTempDir(dir) { + fs.rmSync(dir, { recursive: true, force: true }) +} diff --git a/__tests__/integration/application-create/application-create.integration.test.js b/__tests__/integration/application-create/application-create.integration.test.js new file mode 100644 index 0000000..8527a64 --- /dev/null +++ b/__tests__/integration/application-create/application-create.integration.test.js @@ -0,0 +1,263 @@ +import { describe, test, before, after, afterEach } from 'node:test' +import assert from 'node:assert/strict' +import { + startFusionAuthContainer, + stopFusionAuthContainer, + getApplication, + deleteApplication, + captureSystemConfigurationBaseline, + resetSystemConfiguration, + makeApiRequest, +} from '../setup.js' +import { executeApplicationCreate } from '../../../src/commands/application-create.js' + +const TENANT_ID = '886a57e0-f2ac-440a-9a9d-d10c17b6f1a1' +const REQUIRED_CORS_HEADERS = ['dpop', 'authorization', 'accept', 'content-type'] +const REDIRECT_URI = 'https://example.com/callback' + +describe('application:create integration tests', () => { + let fusionAuthUrl + let apiKey + let systemConfigBaseline + const createdApplicationIds = [] + + before(async () => { + const container = await startFusionAuthContainer() + fusionAuthUrl = container.url + apiKey = container.apiKey + systemConfigBaseline = await captureSystemConfigurationBaseline(apiKey) + }) + + after(async () => { + await stopFusionAuthContainer() + }) + + afterEach(async () => { + // Delete any applications created during the test + for (const id of createdApplicationIds.splice(0)) { + try { await deleteApplication(id, apiKey) } catch (_) {} + } + // Restore CORS to the captured baseline + await resetSystemConfiguration(apiKey) + }) + + function baseOptions(overrides = {}) { + return { + name: `Integration Test App ${Date.now()}`, + key: apiKey, + host: fusionAuthUrl, + tenantId: TENANT_ID, + // Bypasses the CORS-change confirmation prompt (spa profile). + // The confirmation gate itself is covered by unit tests; these + // integration tests are focused on real API behavior. + yes: true, + ...overrides, + } + } + + function spaOptions(overrides = {}) { + return baseOptions({ profile: 'spa', redirectUri: [REDIRECT_URI], ...overrides }) + } + + function webappOptions(overrides = {}) { + return baseOptions({ profile: 'webapp', redirectUri: [REDIRECT_URI], ...overrides }) + } + + // Verifies the required CORS headers (see REQUIRED_CORS_HEADERS) for the + // spa profile were added to system configuration, and that CORS is enabled. + async function assertCorsHeadersConfigured(apiKey) { + const sysConfig = await makeApiRequest('GET', '/api/system-configuration', null, apiKey) + const corsHeaders = (sysConfig.systemConfiguration.corsConfiguration?.allowedHeaders ?? []) + .map(h => h.toLowerCase()) + for (const required of REQUIRED_CORS_HEADERS) { + assert(corsHeaders.includes(required), `CORS allowedHeaders should contain '${required}'`) + } + assert.equal(sysConfig.systemConfiguration.corsConfiguration?.enabled, true) + } + + // --------------------------------------------------------------------------- + // Happy paths — one per profile + // --------------------------------------------------------------------------- + + test('--profile spa creates application with correct settings and configures CORS', async () => { + const result = await executeApplicationCreate(spaOptions()) + + assert.equal(result.success, true, `Expected success but got: ${result.error}`) + assert.ok(result.applicationId, 'applicationId should be set') + assert.ok(result.clientId, 'clientId should be set') + // Note: some FA versions generate a client secret even for public clients; + // what matters is that authentication is not REQUIRED (enforced below). + + createdApplicationIds.push(result.applicationId) + + // Verify application settings were persisted correctly + const app = await getApplication(result.applicationId, apiKey) + assert.ok(app, 'application should exist in FusionAuth') + assert.equal(app.oauthConfiguration.proofKeyForCodeExchangePolicy, 'Required') + assert.equal(app.oauthConfiguration.clientAuthenticationPolicy, 'NotRequired') + assert.equal(app.oauthConfiguration.requireClientAuthentication, false) + assert.equal(app.oauthConfiguration.generateRefreshTokens, true) + assert.equal(app.oauthConfiguration.requireRegistration, true) + assert.deepEqual(app.oauthConfiguration.enabledGrants, ['authorization_code', 'refresh_token']) + assert.deepEqual(app.oauthConfiguration.authorizedRedirectURLs, [REDIRECT_URI]) + assert.equal(app.jwtConfiguration.timeToLiveInSeconds, 300) + assert.equal(app.jwtConfiguration.refreshTokenUsagePolicy, 'OneTimeUse') + assert.equal(app.jwtConfiguration.refreshTokenExpirationPolicy, 'SlidingWindow') + + // Verify CORS headers were added to system configuration + await assertCorsHeadersConfigured(apiKey) + }) + + test('--authorized-origin-url is added to the system CORS allowlist, not just the application', async () => { + const origin = 'https://myapp.example.com' + const result = await executeApplicationCreate(spaOptions({ authorizedOriginUrl: [origin] })) + + assert.equal(result.success, true, `Expected success but got: ${result.error}`) + createdApplicationIds.push(result.applicationId) + + // The application-level setting (iframe/X-Frame-Options allowlist for + // hosted pages) is a separate concern from the system CORS allowlist + // below, but --authorized-origin-url should still populate it as before. + const app = await getApplication(result.applicationId, apiKey) + assert.deepEqual(app.oauthConfiguration.authorizedOriginURLs, [origin]) + + // The system-wide CORS allowlist must also include it, or the browser + // will block the spa's actual cross-origin requests to the API despite + // CORS being "configured" (headers/enabled only, per the bug this + // guards against). + const sysConfig = await makeApiRequest('GET', '/api/system-configuration', null, apiKey) + const allowedOrigins = sysConfig.systemConfiguration.corsConfiguration?.allowedOrigins ?? [] + assert(allowedOrigins.includes(origin), `system CORS allowedOrigins should contain '${origin}'`) + }) + + test('--profile native creates application without touching system CORS configuration', async () => { + const result = await executeApplicationCreate(baseOptions({ + profile: 'native', + redirectUri: ['myapp://callback'], + })) + + assert.equal(result.success, true, `Expected success but got: ${result.error}`) + // Note: some FA versions generate a client secret even for public clients; + // what matters is that authentication is not REQUIRED (enforced below). + + createdApplicationIds.push(result.applicationId) + + const app = await getApplication(result.applicationId, apiKey) + assert.equal(app.oauthConfiguration.proofKeyForCodeExchangePolicy, 'Required') + assert.equal(app.oauthConfiguration.clientAuthenticationPolicy, 'NotRequired') + assert.equal(app.oauthConfiguration.requireRegistration, true) + assert.deepEqual(app.oauthConfiguration.authorizedRedirectURLs, ['myapp://callback']) + assert.equal(app.jwtConfiguration.timeToLiveInSeconds, 300) + + // Native apps don't go through a browser's CORS enforcement, so + // --profile native should leave system CORS configuration untouched, + // unlike spa. + const sysConfig = await makeApiRequest('GET', '/api/system-configuration', null, apiKey) + assert.deepEqual(sysConfig.systemConfiguration.corsConfiguration, systemConfigBaseline.corsConfiguration) + }) + + test('--profile webapp creates confidential client and returns clientSecret', async () => { + const result = await executeApplicationCreate(webappOptions()) + + assert.equal(result.success, true, `Expected success but got: ${result.error}`) + assert.ok(result.clientSecret, 'webapp should have a client secret') + + createdApplicationIds.push(result.applicationId) + + const app = await getApplication(result.applicationId, apiKey) + assert.equal(app.oauthConfiguration.proofKeyForCodeExchangePolicy, 'NotRequiredWhenUsingClientAuthentication') + assert.equal(app.oauthConfiguration.clientAuthenticationPolicy, 'Required') + assert.equal(app.oauthConfiguration.requireClientAuthentication, true) + assert.equal(app.oauthConfiguration.requireRegistration, true) + assert.equal(app.jwtConfiguration.timeToLiveInSeconds, 3600) + assert.equal(app.jwtConfiguration.refreshTokenUsagePolicy, 'OneTimeUse') + assert.equal(app.jwtConfiguration.refreshTokenExpirationPolicy, 'SlidingWindow') + }) + + test('--data custom mode creates application with provided configuration', async () => { + const customApp = { + oauthConfiguration: { + enabledGrants: ['authorization_code', 'refresh_token'], + authorizedRedirectURLs: ['https://custom.example.com/cb'], + generateRefreshTokens: true, + }, + } + + const result = await executeApplicationCreate(baseOptions({ + data: JSON.stringify(customApp), + })) + + assert.equal(result.success, true, `Expected success but got: ${result.error}`) + + createdApplicationIds.push(result.applicationId) + + const app = await getApplication(result.applicationId, apiKey) + assert.deepEqual( + app.oauthConfiguration.authorizedRedirectURLs, + ['https://custom.example.com/cb'] + ) + assert( + app.oauthConfiguration.enabledGrants.includes('authorization_code'), + 'should include authorization_code grant' + ) + }) + + // --------------------------------------------------------------------------- + // CORS idempotency + // --------------------------------------------------------------------------- + + test('running spa create twice does not duplicate CORS headers', async () => { + // First create + const result1 = await executeApplicationCreate(spaOptions()) + assert.equal(result1.success, true) + createdApplicationIds.push(result1.applicationId) + + // Second create without resetting CORS + const result2 = await executeApplicationCreate(spaOptions({ redirectUri: ['https://example.com/callback2'] })) + assert.equal(result2.success, true) + createdApplicationIds.push(result2.applicationId) + + const sysConfig = await makeApiRequest('GET', '/api/system-configuration', null, apiKey) + const corsHeaders = sysConfig.systemConfiguration.corsConfiguration?.allowedHeaders ?? [] + const corsHeadersLower = corsHeaders.map(h => h.toLowerCase()) + + // Each required header should appear exactly once + for (const required of REQUIRED_CORS_HEADERS) { + const count = corsHeadersLower.filter(h => h === required).length + assert.equal(count, 1, `'${required}' should appear exactly once in CORS allowedHeaders, got ${count}`) + } + }) + + // --------------------------------------------------------------------------- + // Regression: tenant header scoping (live server) + // Confirms /api/system-configuration actually accepts the request without + // the X-FusionAuth-TenantId header, which was the root cause of the 401. + // --------------------------------------------------------------------------- + + test('system-configuration is reachable without tenant header when --tenant-id is provided', async () => { + // If the tenant header were incorrectly sent to /api/system-configuration, + // this would fail with 401 — exactly the bug we fixed. + // (--tenant-id is already the default in baseOptions()/spaOptions().) + const result = await executeApplicationCreate(spaOptions()) + assert.equal(result.success, true, `Expected success but got: ${result.error}`) + createdApplicationIds.push(result.applicationId) + }) + + // --------------------------------------------------------------------------- + // --application-id override + // --------------------------------------------------------------------------- + + test('--application-id is respected and application is created with that ID', async () => { + const customId = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890' + const result = await executeApplicationCreate(webappOptions({ applicationId: customId })) + + assert.equal(result.success, true, `Expected success but got: ${result.error}`) + assert.equal(result.applicationId, customId) + + createdApplicationIds.push(customId) + + const app = await getApplication(customId, apiKey) + assert.ok(app, 'application should exist with the specified ID') + assert.equal(app.id, customId) + }) +}) diff --git a/__tests__/integration/fixtures/kickstarts/fusionauth-integration-test-base/docker-compose.yml b/__tests__/integration/fixtures/kickstarts/fusionauth-integration-test-base/docker-compose.yml index 6ac70fb..7b96011 100644 --- a/__tests__/integration/fixtures/kickstarts/fusionauth-integration-test-base/docker-compose.yml +++ b/__tests__/integration/fixtures/kickstarts/fusionauth-integration-test-base/docker-compose.yml @@ -12,7 +12,6 @@ services: retries: 5 networks: - db_net - restart: unless-stopped volumes: - db_data:/var/lib/postgresql/data @@ -29,7 +28,6 @@ services: interval: 10s retries: 80 test: curl --write-out 'HTTP %{http_code}' --fail --silent --output /dev/null http://localhost:9200/ - restart: unless-stopped ulimits: memlock: soft: -1 @@ -46,7 +44,7 @@ services: - search_net fusionauth: - image: fusionauth/fusionauth-app:latest + image: fusionauth/fusionauth-app:1.69.2 depends_on: db: condition: service_healthy @@ -68,7 +66,6 @@ services: networks: - db_net - search_net - restart: unless-stopped ports: - 9011:9011 volumes: diff --git a/__tests__/integration/setup.js b/__tests__/integration/setup.js index f27ae2e..7059e6b 100644 --- a/__tests__/integration/setup.js +++ b/__tests__/integration/setup.js @@ -2,6 +2,7 @@ import * as fs from 'node:fs' import * as path from 'node:path' import { exec } from 'node:child_process' import { promisify } from 'node:util' +import { fileURLToPath } from 'node:url' /** * Async version of exec used in place of execSync to avoid blocking the @@ -16,13 +17,138 @@ const execAsync = promisify(exec) * Handles docker compose lifecycle and FusionAuth readiness checks */ -const FUSIONAUTH_URL = 'http://localhost:9011' +const DEFAULT_FUSIONAUTH_URL = 'http://localhost:9011' const DEFAULT_API_KEY = '90dd6b25-d1ef-4175-9656-159dd994932e' -const HEALTH_CHECK_TIMEOUT = 120000 // 2 minutes +const HEALTH_CHECK_TIMEOUT = 240000 // 4 minutes const HEALTH_CHECK_INTERVAL = 5000 // 5 seconds const REQUEST_TIMEOUT = 10000 // 10 seconds +// fileURLToPath() (not .pathname) is required here: .pathname leaves +// characters like spaces percent-encoded (e.g. '%20'), which is not a +// valid path component on disk and would break both writeFileSync(envFile) +// and every docker compose invocation below for a checkout under a path +// containing a space. +const COMPOSE_DIR = fileURLToPath(new URL('./fixtures/kickstarts/fusionauth-integration-test-base', import.meta.url)) let isContainerRunning = false +let resolvedFusionAuthUrl = DEFAULT_FUSIONAUTH_URL + +/** + * Best-effort teardown used by the SIGINT/SIGTERM handlers below. Unlike + * stopFusionAuthContainer(), this does not check isContainerRunning — a + * termination signal can arrive before that flag is set (e.g. while still + * waiting on docker compose up -d or the health check loop), by which point + * containers may already exist and still need cleaning up. + * @param {string} reason - what triggered the teardown, for logging + */ +async function forceTeardown(reason) { + if (process.env.SKIP_TEARDOWN === 'true') { + console.log(`ℹ Skipping container teardown on ${reason} (SKIP_TEARDOWN=true)`) + return + } + try { + await execAsync('docker compose --env-file .env.test down -v', { cwd: COMPOSE_DIR }) + isContainerRunning = false + } catch (err) { + console.error(`Warning: Failed to stop container during ${reason} cleanup: ${err.message}`) + } +} + +let handlingTerminationSignal = false + +/** + * Ensures a Ctrl+C (or kill) during a test run doesn't leak the FusionAuth + * container — without this, after()/t.after() hooks never run on an + * interrupted process, leaving containers running (or stopped-but-not- + * removed, which can then collide with the next run's `docker compose up`). + * @param {string} signal + */ +async function handleTerminationSignal(signal) { + if (handlingTerminationSignal) { + // Second signal while teardown is still in flight (e.g. docker compose + // down -v hung) — the user wants out now. Exit immediately rather than + // silently no-op'ing: once a SIGINT/SIGTERM listener is registered, + // Node no longer applies its default "second Ctrl+C just kills the + // process" behavior on its own, so we have to implement that ourselves. + console.log(`\n⚠ Received ${signal} again — forcing immediate exit (teardown may be incomplete).`) + process.exit(signal === 'SIGINT' ? 130 : 143) + } + handlingTerminationSignal = true + console.log(`\n⚠ Received ${signal}, cleaning up FusionAuth container before exiting...`) + await forceTeardown(signal) + process.exit(signal === 'SIGINT' ? 130 : 143) +} + +process.on('SIGINT', () => { void handleTerminationSignal('SIGINT') }) +process.on('SIGTERM', () => { void handleTerminationSignal('SIGTERM') }) + +/** + * Resolves the FusionAuth service container's ID via Docker Compose, + * rather than assuming Compose's default generated container name + * ('{project}-{service}-{index}'). That default only holds when + * COMPOSE_PROJECT_NAME is unset; if it's set (e.g. by a contributor's + * shell profile or CI wrapper), the real container name differs and a + * hard-coded guess would silently fail to match anything. + * @returns {Promise} The container ID, or '' if it can't be found + * (e.g. the compose project doesn't exist yet) — callers should treat + * that the same as a failed `docker inspect` and fall back gracefully. + */ +async function resolveContainerId() { + try { + const { stdout } = await execAsync('docker compose --env-file .env.test ps -q fusionauth', { cwd: COMPOSE_DIR }) + return stdout.trim() + } catch (_) { + return '' + } +} + +/** + * Resolves the FusionAuth URL. On environments where localhost port-mapping + * behaves differently (e.g. macOS Docker Desktop), falls back to the + * container's direct bridge IP to ensure authenticated requests succeed. + * @returns {Promise} + */ +async function resolveFusionAuthUrl() { + // First try localhost — if an authenticated request succeeds, use it. + try { + const controller = new AbortController() + const timeoutId = setTimeout(() => controller.abort(), 3000) + const response = await fetch(`${DEFAULT_FUSIONAUTH_URL}/api/tenant`, { + headers: { Authorization: DEFAULT_API_KEY }, + signal: controller.signal, + }) + clearTimeout(timeoutId) + if (response.ok) return DEFAULT_FUSIONAUTH_URL + } catch (_) {} + + // Fall back to the container's direct bridge IP (works on macOS Docker Desktop + // where localhost port-mapping doesn't forward API-key auth correctly). + try { + const containerId = await resolveContainerId() + if (!containerId) throw new Error('FusionAuth container not found') + const { stdout } = await execAsync( + `docker inspect ${containerId} --format '{{range .NetworkSettings.Networks}}{{.IPAddress}} {{end}}'` + ) + const ips = stdout.trim().split(/\s+/).filter(Boolean) + for (const ip of ips) { + try { + const controller = new AbortController() + const timeoutId = setTimeout(() => controller.abort(), 3000) + const response = await fetch(`http://${ip}:9011/api/tenant`, { + headers: { Authorization: DEFAULT_API_KEY }, + signal: controller.signal, + }) + clearTimeout(timeoutId) + if (response.ok) { + console.log(`ℹ Using container IP ${ip}:9011 (localhost port-mapping not compatible)`) + return `http://${ip}:9011` + } + } catch (_) {} + } + } catch (_) {} + + // Return localhost as a last resort — health check will catch startup failures. + return DEFAULT_FUSIONAUTH_URL +} /** * Start FusionAuth via docker compose @@ -31,14 +157,14 @@ let isContainerRunning = false export async function startFusionAuthContainer() { if (isContainerRunning || process.env.REUSE_CONTAINER === 'true') { console.log('ℹ Using existing FusionAuth container') - return { url: FUSIONAUTH_URL, apiKey: DEFAULT_API_KEY } + resolvedFusionAuthUrl = await resolveFusionAuthUrl() + return { url: resolvedFusionAuthUrl, apiKey: DEFAULT_API_KEY } } console.log('↻ Starting FusionAuth container via docker compose...') - const composeDir = new URL('./fixtures/kickstarts/fusionauth-integration-test-base', import.meta.url).pathname - const envFile = path.join(composeDir, '.env.test') - const kickstartFilePath = path.join(composeDir, 'kickstart.json') + const envFile = path.join(COMPOSE_DIR, '.env.test') + const kickstartFilePath = path.join(COMPOSE_DIR, 'kickstart.json') // Create .env.test file with test configuration const envContent = ` @@ -57,28 +183,44 @@ OPENSEARCH_JAVA_OPTS=-Xms256m -Xmx256m fs.writeFileSync(envFile, envContent) try { - // Check for and tear down any existing containers first + // Check for and tear down any existing containers first. Use -a/--all — + // without it, docker compose ps only lists running/restarting + // containers, so a stopped-but-not-removed container from a prior + // interrupted run would be invisible here, this cleanup would be + // skipped entirely, and the `up -d` below would fail with + // "Conflict: container name already in use". + let psOutput = '' try { - const { stdout: psOutput } = await execAsync(`cd ${composeDir} && docker compose ps -q`) - if (psOutput.trim()) { - console.log('⚠ Found existing FusionAuth containers, tearing them down...') - await execAsync(`cd ${composeDir} && docker compose down -v`) - console.log('✓ Existing containers removed') - } + const result = await execAsync('docker compose --env-file .env.test ps -aq', { cwd: COMPOSE_DIR }) + psOutput = result.stdout } catch (e) { - // Container may not exist, that's fine + // `docker compose ps` itself failing (e.g. project has never existed) + // is fine — there's nothing to tear down. + } + + if (psOutput.trim()) { + console.log('⚠ Found existing FusionAuth containers, tearing them down...') + // Unlike the ps check above, a failure here means stale containers + // genuinely remain. Let it propagate (via the outer catch) instead of + // silently continuing into `up -d`, which would just hit the same + // naming conflict with a far more confusing error message. + await execAsync('docker compose --env-file .env.test down -v', { cwd: COMPOSE_DIR }) + console.log('✓ Existing containers removed') } // Start containers - await execAsync(`cd ${composeDir} && docker compose --env-file .env.test up -d`) + await execAsync('docker compose --env-file .env.test up -d', { cwd: COMPOSE_DIR }) // Wait for FusionAuth to be healthy await waitForFusionAuthReady() + // Resolve the URL that actually works for authenticated requests + resolvedFusionAuthUrl = await resolveFusionAuthUrl() + isContainerRunning = true console.log('✓ FusionAuth container started and ready') - return { url: FUSIONAUTH_URL, apiKey: DEFAULT_API_KEY } + return { url: resolvedFusionAuthUrl, apiKey: DEFAULT_API_KEY } } catch (err) { throw new Error(`Failed to start FusionAuth container: ${err.message}`) } @@ -101,10 +243,8 @@ export async function stopFusionAuthContainer() { console.log('↻ Stopping FusionAuth container...') - const composeDir = new URL('./fixtures/kickstarts/fusionauth-integration-test-base', import.meta.url).pathname - try { - await execAsync(`cd ${composeDir} && docker compose down -v`) + await execAsync('docker compose --env-file .env.test down -v', { cwd: COMPOSE_DIR }) isContainerRunning = false console.log('✓ FusionAuth container stopped') } catch (err) { @@ -124,36 +264,61 @@ async function waitForFusionAuthReady() { const controller = new AbortController() const timeoutId = setTimeout(() => controller.abort(), 5000) - const response = await fetch(`${FUSIONAUTH_URL}/api/status`, { + const response = await fetch(`${DEFAULT_FUSIONAUTH_URL}/api/status`, { signal: controller.signal }) clearTimeout(timeoutId) if (response.ok) { - // Verify authenticated API requests work by fetching tenants, there was a problem with the status returning OK but the Key did not work + // Verify the kickstart has run and the container is fully initialized + // by checking authenticated API access. Tries localhost first, then + // falls back to the container's direct bridge IP. let authReady = false const authStartTime = Date.now() while (Date.now() - authStartTime < 30000) { // 30 second timeout for auth readiness + // Try localhost first, only falling back to the container's direct + // bridge IP (via docker inspect) if localhost doesn't respond ok. + // Mirrors resolveFusionAuthUrl()'s ordering — on Docker Desktop the + // bridge IP generally isn't routable from the host, so localhost + // must be attempted first rather than being unconditionally + // overridden. + const urlsToTry = [DEFAULT_FUSIONAUTH_URL] try { - const authController = new AbortController() - const authTimeoutId = setTimeout(() => authController.abort(), 5000) - - const tenantsResponse = await fetch(`${FUSIONAUTH_URL}/api/tenant`, { - method: 'GET', - headers: { Authorization: DEFAULT_API_KEY }, - signal: authController.signal - }) - clearTimeout(authTimeoutId) - - if (tenantsResponse.ok) { - authReady = true - break + const containerId = await resolveContainerId() + if (!containerId) throw new Error('FusionAuth container not found') + const { stdout } = await execAsync( + `docker inspect ${containerId} --format '{{range .NetworkSettings.Networks}}{{.IPAddress}} {{end}}'` + ) + const ip = stdout.trim().split(/\s+/).filter(Boolean)[0] + if (ip) urlsToTry.push(`http://${ip}:9011`) + } catch (_) {} + + for (const checkUrl of urlsToTry) { + try { + const authController = new AbortController() + const authTimeoutId = setTimeout(() => authController.abort(), 5000) + + const tenantsResponse = await fetch(`${checkUrl}/api/tenant`, { + method: 'GET', + headers: { Authorization: DEFAULT_API_KEY }, + signal: authController.signal + }) + clearTimeout(authTimeoutId) + + if (tenantsResponse.ok) { + authReady = true + break + } + } catch (err) { + // Not reachable via this URL yet, try the next one } - } catch (err) { - // Auth not ready yet, retry } - + + if (authReady) { + break + } + await sleep(HEALTH_CHECK_INTERVAL) } @@ -182,7 +347,7 @@ async function waitForFusionAuthReady() { * @returns {Promise} */ export async function makeApiRequest(method, path, data = null, apiKey = DEFAULT_API_KEY) { - const url = `${FUSIONAUTH_URL}${path}` + const url = `${resolvedFusionAuthUrl}${path}` const headers = { Authorization: apiKey, 'Content-Type': 'application/json' @@ -212,7 +377,15 @@ export async function makeApiRequest(method, path, data = null, apiKey = DEFAULT ) } - return await response.json() + // Some successful responses (e.g. DELETE /api/application) have an + // empty body — calling response.json() directly throws in that case + // ("Unexpected end of JSON input"), so read as text first and only + // parse when there's actually something to parse. + const responseText = await response.text() + if (!responseText) { + return null + } + return JSON.parse(responseText) } catch (err) { if (err.name === 'AbortError') { throw new Error(`API request timeout: ${method} ${path}`) @@ -269,6 +442,57 @@ export async function getMessageTemplateByName(name, apiKey = DEFAULT_API_KEY) { return templates.find(t => t.name === name) } +/** + * Get application by ID from FusionAuth + * @param {string} applicationId - Application ID + * @param {string} apiKey - API key + * @returns {Promise} + */ +export async function getApplication(applicationId, apiKey = DEFAULT_API_KEY) { + const data = await makeApiRequest('GET', `/api/application/${applicationId}`, null, apiKey) + return data.application +} + +/** + * Delete application by ID from FusionAuth + * @param {string} applicationId - Application ID + * @param {string} apiKey - API key + * @returns {Promise} + */ +export async function deleteApplication(applicationId, apiKey = DEFAULT_API_KEY) { + // First deactivate, then hard-delete + await makeApiRequest('DELETE', `/api/application/${applicationId}`, null, apiKey) + await makeApiRequest('DELETE', `/api/application/${applicationId}?hardDelete=true`, null, apiKey) +} + +let baselineSystemConfiguration = null + +/** + * Captures the current system configuration as the baseline to restore to + * after CORS-mutating tests. Must be called once before any test that + * modifies system configuration (e.g. application:create --profile spa). + * @param {string} apiKey - API key + * @returns {Promise} + */ +export async function captureSystemConfigurationBaseline(apiKey = DEFAULT_API_KEY) { + const data = await makeApiRequest('GET', '/api/system-configuration', null, apiKey) + baselineSystemConfiguration = data.systemConfiguration + return baselineSystemConfiguration +} + +/** + * Restores system configuration to the captured baseline. Uses PUT (full + * overwrite) rather than PATCH so the restore is exact, not merged. + * @param {string} apiKey - API key + * @returns {Promise} + */ +export async function resetSystemConfiguration(apiKey = DEFAULT_API_KEY) { + if (!baselineSystemConfiguration) { + throw new Error('captureSystemConfigurationBaseline() must be called before resetSystemConfiguration()') + } + await makeApiRequest('PUT', '/api/system-configuration', { systemConfiguration: baselineSystemConfiguration }, apiKey) +} + /** * Sleep for specified milliseconds * @param {number} ms - Milliseconds to sleep diff --git a/__tests__/postInstall/postinstall.test.js b/__tests__/postInstall/postinstall.test.js index cfcd096..3315af0 100644 --- a/__tests__/postInstall/postinstall.test.js +++ b/__tests__/postInstall/postinstall.test.js @@ -1,96 +1,73 @@ -import { describe, test } from "node:test" +import { describe, test, beforeEach, afterEach } from "node:test" import assert from "node:assert/strict" +import path from "node:path" import { createConfig } from '../../src/utils.js' +import { createTempDir, removeTempDir } from '../helpers/temp-dir.js' -import mock from 'mock-fs' -import fs, { readdirSync, readFileSync } from 'node:fs' +import fs from 'node:fs' describe('postInstall runs properly', () => { + let tempDir + let configDir + + beforeEach(() => { + tempDir = createTempDir() + configDir = path.join(tempDir, 'dist', '.fa') + }) + + afterEach(() => { + removeTempDir(tempDir) + }) + test('No config creates dir', () => { - mock({ - 'dist': {}, - }) - try { - const configFileExists = createConfig('dist/.fa') - assert.equal(configFileExists, true, 'Config not created at dist/.fa/config.json') - } finally { - mock.restore() - } + const configFileExists = createConfig(configDir) + assert.equal(configFileExists, true, 'Config not created at dist/.fa/config.json') }) + test('No dist directory, still create the directory and file', () => { - mock({ - "./": {} - }) - try { - const configFileExists = createConfig('dist/.fa') - assert.equal(configFileExists, true, 'Config not created at dist/.fa/config.json') - } finally { - mock.restore() - } + // tempDir exists but the nested dist/.fa path does not yet. + const configFileExists = createConfig(configDir) + assert.equal(configFileExists, true, 'Config not created at dist/.fa/config.json') }) + test('No config creates full config file with expected types', () => { - mock({ - 'dist': {}, - }) - try { - const configFileExists = createConfig('dist/.fa') - const configObject = JSON.parse(readFileSync('dist/.fa/config.json')) - assert(configObject.telemetry, true, 'Default telemetry not set to true') - assert(typeof configObject.id, 'string', "ID doesn't exist or isn't a string") - } finally { - mock.restore() - } + createConfig(configDir) + const configObject = JSON.parse(fs.readFileSync(path.join(configDir, 'config.json'))) + assert(configObject.telemetry, true, 'Default telemetry not set to true') + assert(typeof configObject.id, 'string', "ID doesn't exist or isn't a string") }) test('Complete config returns false', () => { - mock({ - dist: { - '.fa': { - 'config.json': JSON.stringify({id: '8c0a77f2-27e4-4284-b5d3-5618ec2a56eb', telemetry: true}) - } - } - }) - try { - assert.equal(createConfig('dist/.fa'), false, 'Postinstall did not return false properly') - } finally { - mock.restore() - } + fs.mkdirSync(configDir, { recursive: true }) + fs.writeFileSync( + path.join(configDir, 'config.json'), + JSON.stringify({ id: '8c0a77f2-27e4-4284-b5d3-5618ec2a56eb', telemetry: true }) + ) + + assert.equal(createConfig(configDir), false, 'Postinstall did not return false properly') }) + test('No ID in config, but telemetry false', () => { - mock({ - dist: { - '.fa': { - 'config.json': JSON.stringify({telemetry: false}) - } - } - }) - try { - createConfig('dist/.fa') - const configObject = JSON.parse(fs.readFileSync('dist/.fa/config.json')) - assert.equal(typeof configObject.id, 'string', 'No ID after run') - assert.equal(configObject.telemetry, false, 'Telemetry got reset') - } finally { - mock.restore() - } - }) - test('No telemetry in config, but ID', () => { - mock({ - dist: { - '.fa': { - 'config.json': JSON.stringify({id: '8c0a77f2-27e4-4284-b5d3-5618ec2a56eb'}) - } - } - }) - try { - createConfig('dist/.fa') - const configObject = JSON.parse(fs.readFileSync('dist/.fa/config.json')) - assert.equal(configObject.id, '8c0a77f2-27e4-4284-b5d3-5618ec2a56eb', 'ID got reset') - assert.equal(configObject.telemetry, true, 'Telemetry did not get set') - } finally { - mock.restore() - } + fs.mkdirSync(configDir, { recursive: true }) + fs.writeFileSync(path.join(configDir, 'config.json'), JSON.stringify({ telemetry: false })) + + createConfig(configDir) + const configObject = JSON.parse(fs.readFileSync(path.join(configDir, 'config.json'))) + assert.equal(typeof configObject.id, 'string', 'No ID after run') + assert.equal(configObject.telemetry, false, 'Telemetry got reset') }) + test('No telemetry in config, but ID', () => { + fs.mkdirSync(configDir, { recursive: true }) + fs.writeFileSync( + path.join(configDir, 'config.json'), + JSON.stringify({ id: '8c0a77f2-27e4-4284-b5d3-5618ec2a56eb' }) + ) + createConfig(configDir) + const configObject = JSON.parse(fs.readFileSync(path.join(configDir, 'config.json'))) + assert.equal(configObject.id, '8c0a77f2-27e4-4284-b5d3-5618ec2a56eb', 'ID got reset') + assert.equal(configObject.telemetry, true, 'Telemetry did not get set') + }) }) diff --git a/__tests__/telemetry/index.js b/__tests__/telemetry/index.js deleted file mode 100644 index 82e4942..0000000 --- a/__tests__/telemetry/index.js +++ /dev/null @@ -1,148 +0,0 @@ -import test, { describe, after, before, beforeEach, afterEach } from "node:test" -import assert from "node:assert" -import fs, { readFileSync } from "node:fs" -import mock from "mock-fs" -import { telemetryUpdate } from "../../dist/commands/telemetry/telemetry-utils.js" -import { telemetryDisable } from "../../dist/commands/telemetry/telemetry-disable.js" -import { telemetryEnable } from "../../dist/commands/telemetry/telemetry-enable.js" -import path from "node:path" -import { loadConfig, logEvent } from "../../dist/utils.js" -import nock from 'nock' - -export function telemetry() { - const mockedTrueConfig = { - id: '8c0a77f2-27e4-4284-b5d3-5618ec2a56eb', - telemetry: true, - version: '1.0' - } - const mockedFalseConfig = { - id: '8c0a77f2-27e4-4284-b5d3-5618ec2a56eb', - telemetry: false, - version: '1.0' - } - describe('telemetry runs properly', () => { - test("Creates config if no config exists", (t) => { - before(() => { - mock({ - "dist": {} - }) - }) - - const updatedConfig = telemetryUpdate(true) - assert(fs.existsSync('dist/.fa/config.json'), "File wasn't created") - }) - test("Only changes telemetry value", () => { - before(() => { - mock({ - "dist/.fa/config.json": JSON.stringify(mockedFalseConfig) - }) - }) - - const updatedConfig = telemetryUpdate(true) - assert.deepEqual(updatedConfig.globalConfig, mockedTrueConfig) - }) - - test("Enable works", (t) => { - before(() => { - mock({ - "dist/.fa/config.json": JSON.stringify(mockedFalseConfig) - }) - }) - const actualConfig = telemetryUpdate(true) - assert.equal(actualConfig.globalConfig.telemetry, true, "Telemetry not set to true") - }) - test("Disable works", (t) => { - before(() => { - mock({ - "dist/.fa/config.json": JSON.stringify(mockedTrueConfig) - }) - }) - const actualConfig = telemetryUpdate(true) - assert.equal(actualConfig.globalConfig.telemetry, true, "Telemetry not set to true") - }) - test("Disable full command runs properly", (t) => { - before(() => { - mock({ - "dist/.fa/config.json": JSON.stringify(mockedTrueConfig) - }) - }) - - // TODO: Add quiet flag to remove outputs - telemetryDisable.parse() - const actualConfig = JSON.parse(fs.readFileSync('dist/.fa/config.json').toString()) - assert.equal(actualConfig.telemetry, false) - }) - test("Enable full command runs properly", (t) => { - before(() => { - mock({ - "dist/.fa/config.json": JSON.stringify(mockedFalseConfig) - }) - }) - - // TODO: Add quiet flag to remove outputs - telemetryEnable.parse() - const actualConfig = JSON.parse(fs.readFileSync('dist/.fa/config.json').toString()) - assert.equal(actualConfig.telemetry, true) - }) - }) - describe('tests for logEvent', () => { - test("If FUSIONAUTH_TELEMETRY === false don't run", async (t) => { - before(() => { - process.env.FUSIONAUTH_TELEMETRY = false - }) - after(() => { - delete process.env.FUSIONAUTH_TELEMETRY - }) - - const response = await logEvent('test event') - assert.equal(response, false, "logEvent still fired") - }) - - test("If FUSIONAUTH_TELEMETRY === true DO run", async (t) => { - before(() => { - process.env.FUSIONAUTH_TELEMETRY = true - nock('https://us.i.posthog.com') - .post('/batch/') - .reply(200) - }) - after(() => { - nock.cleanAll(); - delete process.env.FUSIONAUTH_TELEMETRY - }) - - const response = await logEvent('test event') - assert.equal(response, true, "logEvent didn't fire") - }) - test("If no .env, event submits", async (t) => { - before(() => { - nock('https://us.i.posthog.com') - .post('/batch/') - .reply(200) - }) - after(() => { - nock.cleanAll(); - }) - - assert.equal(process.env.FUSIONAUTH_TELEMETRY, undefined, 'Env variable FUSIONAUTH_TELEMETRY is defined') - const response = await logEvent('test event') - assert.equal(response, true, "logEvent didn't fire") - }) - - test("Disables warning after first log", async (t) => { - before(() => { - process.env.FUSIONAUTH_TELEMETRY = true - mock({ - "dist/.fa/config.json": JSON.stringify(mockedTrueConfig) - }) - }) - after(() => { - delete process.env.FUSIONAUTH_TELEMETRY - mock.restore() - }) - await logEvent('cli test') - const newConfig = await loadConfig() - assert.equal(newConfig.globalConfig.telemetryNoWarn, true) - }) - - }) -} diff --git a/__tests__/telemetry/telemetry.test.js b/__tests__/telemetry/telemetry.test.js index 479f218..798c9b8 100644 --- a/__tests__/telemetry/telemetry.test.js +++ b/__tests__/telemetry/telemetry.test.js @@ -1,13 +1,13 @@ -import { describe, test } from "node:test" +import { describe, test, beforeEach, afterEach } from "node:test" import assert from "node:assert/strict" -import fs, { readFileSync } from "node:fs" -import mock from "mock-fs" +import fs from "node:fs" +import path from "node:path" import { telemetryUpdate } from "../../src/commands/telemetry/telemetry-utils.js" import { telemetryDisable } from "../../src/commands/telemetry/telemetry-disable.js" import { telemetryEnable } from "../../src/commands/telemetry/telemetry-enable.js" -import path from "node:path" -import { logEvent } from "../../src/utils.js" +import { logEvent, loadConfig } from "../../src/utils.js" import nock from 'nock' +import { createTempDir, removeTempDir } from '../helpers/temp-dir.js' const mockedTrueConfig = { id: '8c0a77f2-27e4-4284-b5d3-5618ec2a56eb', @@ -20,111 +20,134 @@ const mockedFalseConfig = { version: '1.0' } +// All telemetry helpers read/write a global config file at +// `${FUSIONAUTH_CONFIG_DIR}/.fa/config.json`. Point that at a fresh real +// temp directory per test rather than mocking the filesystem, and rather +// than letting these tests write to the real repo's src/.fa/ directory. describe('telemetry runs properly', () => { + let tempDir + let configPath + + beforeEach(() => { + tempDir = createTempDir() + process.env.FUSIONAUTH_CONFIG_DIR = tempDir + configPath = path.join(tempDir, '.fa', 'config.json') + }) + + afterEach(() => { + delete process.env.FUSIONAUTH_CONFIG_DIR + removeTempDir(tempDir) + }) + + function writeConfig(config) { + fs.mkdirSync(path.dirname(configPath), { recursive: true }) + fs.writeFileSync(configPath, JSON.stringify(config)) + } + test("Creates config if no config exists", () => { - mock({ - "src": {} - }) - try { - const updatedConfig = telemetryUpdate(true) - assert(fs.existsSync('src/.fa/config.json'), "File wasn't created") - } finally { - mock.restore() - } + const updatedConfig = telemetryUpdate(true) + assert(fs.existsSync(configPath), "File wasn't created") }) test("Only changes telemetry value", () => { - mock({ - "src/.fa/config.json": JSON.stringify(mockedFalseConfig) - }) - try { - const updatedConfig = telemetryUpdate(true) - assert.deepEqual(updatedConfig.globalConfig, mockedTrueConfig) - } finally { - mock.restore() - } + writeConfig(mockedFalseConfig) + const updatedConfig = telemetryUpdate(true) + assert.deepEqual(updatedConfig.globalConfig, mockedTrueConfig) }) test("Enable works", () => { - mock({ - "src/.fa/config.json": JSON.stringify(mockedFalseConfig) - }) - try { - const actualConfig = telemetryUpdate(true) - assert.equal(actualConfig.globalConfig.telemetry, true, "Telemetry not set to true") - } finally { - mock.restore() - } + writeConfig(mockedFalseConfig) + const actualConfig = telemetryUpdate(true) + assert.equal(actualConfig.globalConfig.telemetry, true, "Telemetry not set to true") }) test("Disable works", () => { - mock({ - "src/.fa/config.json": JSON.stringify(mockedTrueConfig) - }) - try { - const actualConfig = telemetryUpdate(false) - assert.equal(actualConfig.globalConfig.telemetry, false, "Telemetry not set to false") - } finally { - mock.restore() - } + writeConfig(mockedTrueConfig) + const actualConfig = telemetryUpdate(false) + assert.equal(actualConfig.globalConfig.telemetry, false, "Telemetry not set to false") }) test("Disable full command runs properly", () => { - mock({ - "src/.fa/config.json": JSON.stringify(mockedTrueConfig) - }) + nock('https://us.i.posthog.com') + .persist() + .post('/batch/') + .reply(200) + writeConfig(mockedTrueConfig) try { telemetryDisable.parse() - const actualConfig = JSON.parse(fs.readFileSync('src/.fa/config.json').toString()) + const actualConfig = JSON.parse(fs.readFileSync(configPath).toString()) assert.equal(actualConfig.telemetry, false) } finally { - mock.restore() + nock.cleanAll() } }) test("Enable full command runs properly", () => { - mock({ - "src/.fa/config.json": JSON.stringify(mockedFalseConfig) - }) + nock('https://us.i.posthog.com') + .persist() + .post('/batch/') + .reply(200) + writeConfig(mockedFalseConfig) try { telemetryEnable.parse() - const actualConfig = JSON.parse(fs.readFileSync('src/.fa/config.json').toString()) + const actualConfig = JSON.parse(fs.readFileSync(configPath).toString()) assert.equal(actualConfig.telemetry, true) } finally { - mock.restore() + nock.cleanAll() } }) - }) - describe('tests for logEvent', () => { +}) + +describe('tests for logEvent', () => { + let tempDir + + beforeEach(() => { + tempDir = createTempDir() + process.env.FUSIONAUTH_CONFIG_DIR = tempDir + // This block's tests assert on the presence/absence of + // FUSIONAUTH_TELEMETRY, including a test that requires it to be + // completely unset. Running the suite with FUSIONAUTH_TELEMETRY=false + // (as npm run test:unit does, to keep logEvent() from making real + // network/filesystem calls in *other* test files) would otherwise + // leak into these tests depending on execution order. Start every + // test here from a known, unset baseline instead of relying on that. + delete process.env.FUSIONAUTH_TELEMETRY + }) + + afterEach(() => { + delete process.env.FUSIONAUTH_CONFIG_DIR + delete process.env.FUSIONAUTH_TELEMETRY + removeTempDir(tempDir) + }) + test("If FUSIONAUTH_TELEMETRY === false don't run", async () => { process.env.FUSIONAUTH_TELEMETRY = 'false' - try { - const response = await logEvent('test event') - assert.equal(response, false, "logEvent still fired") - } finally { - delete process.env.FUSIONAUTH_TELEMETRY - } + const response = await logEvent('test event') + assert.equal(response, false, "logEvent still fired") }) - - test("If FUSIONAUTH_TELEMETRY === true DO run", async () => { - process.env.FUSIONAUTH_TELEMETRY = 'true' + test("If no .env, event submits", async () => { nock('https://us.i.posthog.com') + .persist() .post('/batch/') .reply(200) try { + assert.equal(process.env.FUSIONAUTH_TELEMETRY, undefined, 'Env variable FUSIONAUTH_TELEMETRY is defined') const response = await logEvent('test event') assert.equal(response, true, "logEvent didn't fire") } finally { nock.cleanAll() - delete process.env.FUSIONAUTH_TELEMETRY } }) - test("If no .env, event submits", async () => { + // Ported forward from the now-removed __tests__/telemetry/index.js — this + // is the one test there that covered behavior not exercised anywhere + // else: that the "we collect anonymous data" warning only prints once. + test("Disables warning after first log", async () => { nock('https://us.i.posthog.com') + .persist() .post('/batch/') .reply(200) try { - assert.equal(process.env.FUSIONAUTH_TELEMETRY, undefined, 'Env variable FUSIONAUTH_TELEMETRY is defined') - const response = await logEvent('test event') + const response = await logEvent('cli test') assert.equal(response, true, "logEvent didn't fire") + const newConfig = loadConfig() + assert.equal(newConfig.globalConfig.telemetryNoWarn, true) } finally { nock.cleanAll() } }) - - }) +}) diff --git a/__tests__/utilities/kickstart/validator.test.js b/__tests__/utilities/kickstart/validator.test.js index 2e9196a..b71b0cf 100644 --- a/__tests__/utilities/kickstart/validator.test.js +++ b/__tests__/utilities/kickstart/validator.test.js @@ -1,7 +1,9 @@ -import { describe, test } from "node:test" +import { describe, test, beforeEach, afterEach } from "node:test" import assert from "node:assert/strict" -import mock from "mock-fs" +import fs from "node:fs" +import path from "node:path" import { KickstartValidator } from "../../../src/utilities/kickstart/validator.js" +import { createTempDir, removeTempDir } from "../../helpers/temp-dir.js" describe('KickstartValidator', () => { @@ -304,6 +306,16 @@ describe('KickstartValidator', () => { }) describe('validateFileExists()', () => { + let tempDir + + beforeEach(() => { + tempDir = createTempDir() + }) + + afterEach(() => { + removeTempDir(tempDir) + }) + test('should report error for missing file', () => { const validator = new KickstartValidator() const result = validator.validateFileExists('/nonexistent/file.json') @@ -313,37 +325,36 @@ describe('KickstartValidator', () => { }) test('should accept existing file', () => { - mock({ - '/test/kickstart.json': '{"requests": []}' - }) - try { - const validator = new KickstartValidator() - const result = validator.validateFileExists('/test/kickstart.json') - - assert.equal(result.valid, true) - assert.equal(result.errors.length, 0) - } finally { - mock.restore() - } + const filePath = path.join(tempDir, 'kickstart.json') + fs.writeFileSync(filePath, '{"requests": []}') + + const validator = new KickstartValidator() + const result = validator.validateFileExists(filePath) + + assert.equal(result.valid, true) + assert.equal(result.errors.length, 0) }) test('should report error if path is directory', () => { - mock({ - '/test/': {} - }) - try { - const validator = new KickstartValidator() - const result = validator.validateFileExists('/test') - - assert.equal(result.valid, false) - assert(result.errors.some(e => e.message.includes('not a file'))) - } finally { - mock.restore() - } + const validator = new KickstartValidator() + const result = validator.validateFileExists(tempDir) + + assert.equal(result.valid, false) + assert(result.errors.some(e => e.message.includes('not a file'))) }) }) describe('loadAndValidateJSON()', () => { + let tempDir + + beforeEach(() => { + tempDir = createTempDir() + }) + + afterEach(() => { + removeTempDir(tempDir) + }) + test('should return error if file not found', () => { const validator = new KickstartValidator() const result = validator.loadAndValidateJSON('/nonexistent.json') @@ -353,18 +364,14 @@ describe('KickstartValidator', () => { }) test('should return error if JSON is invalid', () => { - mock({ - '/test/bad.json': '{ invalid json }' - }) - try { - const validator = new KickstartValidator() - const result = validator.loadAndValidateJSON('/test/bad.json') - - assert.equal(result.valid, false) - assert(result.errors.some(e => e.category === 'schema_invalid')) - } finally { - mock.restore() - } + const filePath = path.join(tempDir, 'bad.json') + fs.writeFileSync(filePath, '{ invalid json }') + + const validator = new KickstartValidator() + const result = validator.loadAndValidateJSON(filePath) + + assert.equal(result.valid, false) + assert(result.errors.some(e => e.category === 'schema_invalid')) }) test('should load and parse valid JSON', () => { @@ -373,19 +380,15 @@ describe('KickstartValidator', () => { { method: 'POST', url: '/api/app' } ] } - mock({ - '/test/valid.json': JSON.stringify(config) - }) - try { - const validator = new KickstartValidator() - const result = validator.loadAndValidateJSON('/test/valid.json') - - assert('config' in result) - assert.equal(result.config.requests.length, 1) - assert('lineNumbers' in result) - } finally { - mock.restore() - } + const filePath = path.join(tempDir, 'valid.json') + fs.writeFileSync(filePath, JSON.stringify(config)) + + const validator = new KickstartValidator() + const result = validator.loadAndValidateJSON(filePath) + + assert('config' in result) + assert.equal(result.config.requests.length, 1) + assert('lineNumbers' in result) }) test('should include line numbers in result', () => { @@ -395,17 +398,13 @@ describe('KickstartValidator', () => { { method: 'POST', url: '/api/app2' } ] } - mock({ - '/test/valid.json': JSON.stringify(config) - }) - try { - const validator = new KickstartValidator() - const result = validator.loadAndValidateJSON('/test/valid.json') - - assert('lineNumbers' in result) - } finally { - mock.restore() - } + const filePath = path.join(tempDir, 'valid.json') + fs.writeFileSync(filePath, JSON.stringify(config)) + + const validator = new KickstartValidator() + const result = validator.loadAndValidateJSON(filePath) + + assert('lineNumbers' in result) }) }) }) diff --git a/__tests__/utilities/kickstart/variable-substitution.test.js b/__tests__/utilities/kickstart/variable-substitution.test.js index 62826d3..c593664 100644 --- a/__tests__/utilities/kickstart/variable-substitution.test.js +++ b/__tests__/utilities/kickstart/variable-substitution.test.js @@ -1,7 +1,6 @@ import { describe, test, afterEach } from "node:test" import assert from "node:assert/strict" import nock from "nock" -import mock from 'mock-fs' import { VariableSubstitutor } from "../../../src/utilities/kickstart/variable-substitution.js" describe('VariableSubstitutor', () => { diff --git a/__tests__/utils.test.js b/__tests__/utils.test.js new file mode 100644 index 0000000..ecb754c --- /dev/null +++ b/__tests__/utils.test.js @@ -0,0 +1,158 @@ +import { describe, test } from "node:test" +import assert from "node:assert/strict" +import { isConfirmationAccepted, handleConfirmationAnswer, confirmOrExit, reportError } from "../src/utils.js" + +describe('isConfirmationAccepted()', () => { + test('accepts "y"', () => { + assert.equal(isConfirmationAccepted('y'), true) + }) + + test('accepts "yes"', () => { + assert.equal(isConfirmationAccepted('yes'), true) + }) + + test('accepts case-insensitive variants', () => { + assert.equal(isConfirmationAccepted('Y'), true) + assert.equal(isConfirmationAccepted('YES'), true) + assert.equal(isConfirmationAccepted('Yes'), true) + }) + + test('accepts whitespace-padded variants', () => { + assert.equal(isConfirmationAccepted(' y '), true) + assert.equal(isConfirmationAccepted(' yes '), true) + }) + + test('rejects "n"', () => { + assert.equal(isConfirmationAccepted('n'), false) + }) + + test('rejects empty string', () => { + assert.equal(isConfirmationAccepted(''), false) + }) + + test('rejects unrelated text', () => { + assert.equal(isConfirmationAccepted('nope'), false) + assert.equal(isConfirmationAccepted('ye'), false) + assert.equal(isConfirmationAccepted('sure'), false) + }) +}) + +describe('handleConfirmationAnswer()', () => { + test('accepted answer calls resolve, not reject or process.exit', (t) => { + const exitMock = t.mock.method(process, 'exit', () => {}) + let resolved = false + let rejected = false + + handleConfirmationAnswer('y', () => { resolved = true }, () => { rejected = true }) + + assert.equal(resolved, true) + assert.equal(rejected, false) + assert.equal(exitMock.mock.calls.length, 0) + }) + + test('declined answer calls process.exit(0)', (t) => { + const exitMock = t.mock.method(process, 'exit', () => {}) + + handleConfirmationAnswer('n', () => {}, () => {}) + + assert.equal(exitMock.mock.calls.length, 1) + assert.equal(exitMock.mock.calls[0].arguments[0], 0) + }) + + test('declined answer rejects rather than resolving when process.exit is mocked (does not actually exit)', (t) => { + t.mock.method(process, 'exit', () => {}) + let resolved = false + let rejectedWith + + handleConfirmationAnswer('n', () => { resolved = true }, (err) => { rejectedWith = err }) + + assert.equal(resolved, false, 'resolve should never be called on decline') + assert.ok(rejectedWith instanceof Error, 'reject should be called with an Error') + }) +}) + +describe('confirmOrExit()', () => { + test('yes=true resolves immediately without touching stdin/stdout', async (t) => { + const exitMock = t.mock.method(process, 'exit', () => {}) + + await confirmOrExit('This is risky', true) + + assert.equal(exitMock.mock.calls.length, 0, 'process.exit should not be called') + }) + + test('non-interactive (stdin not a TTY) exits with code 1 and rejects (does not let caller proceed) when exit is mocked', async (t) => { + const exitMock = t.mock.method(process, 'exit', () => {}) + const originalStdinTTY = process.stdin.isTTY + const originalStdoutTTY = process.stdout.isTTY + + process.stdin.isTTY = false + process.stdout.isTTY = true + + try { + await assert.rejects(() => confirmOrExit('This is risky', false)) + } finally { + process.stdin.isTTY = originalStdinTTY + process.stdout.isTTY = originalStdoutTTY + } + + assert.equal(exitMock.mock.calls.length, 1, 'process.exit should be called once') + assert.equal(exitMock.mock.calls[0].arguments[0], 1) + }) + + test('non-interactive (stdout not a TTY) exits with code 1 and rejects (does not let caller proceed) when exit is mocked', async (t) => { + const exitMock = t.mock.method(process, 'exit', () => {}) + const originalStdinTTY = process.stdin.isTTY + const originalStdoutTTY = process.stdout.isTTY + + process.stdin.isTTY = true + process.stdout.isTTY = false + + try { + await assert.rejects(() => confirmOrExit('This is risky', false)) + } finally { + process.stdin.isTTY = originalStdinTTY + process.stdout.isTTY = originalStdoutTTY + } + + assert.equal(exitMock.mock.calls.length, 1, 'process.exit should be called once') + assert.equal(exitMock.mock.calls[0].arguments[0], 1) + }) + + test('non-interactive (both not TTYs) exits with code 1 and rejects (does not let caller proceed) when exit is mocked', async (t) => { + const exitMock = t.mock.method(process, 'exit', () => {}) + const originalStdinTTY = process.stdin.isTTY + const originalStdoutTTY = process.stdout.isTTY + + process.stdin.isTTY = false + process.stdout.isTTY = false + + try { + await assert.rejects(() => confirmOrExit('This is risky', false)) + } finally { + process.stdin.isTTY = originalStdinTTY + process.stdout.isTTY = originalStdoutTTY + } + + assert.equal(exitMock.mock.calls.length, 1, 'process.exit should be called once') + assert.equal(exitMock.mock.calls[0].arguments[0], 1) + }) +}) + +// --------------------------------------------------------------------------- +// reportError() — unknown-shape fallback +// --------------------------------------------------------------------------- + +describe('reportError() fallback for unknown error shapes', () => { + test('does not throw and still prints something useful for a circular-reference object', (t) => { + // JSON.stringify (the old implementation, toJson) throws on circular + // references. util.inspect handles this gracefully instead. + const errorMock = t.mock.method(console, 'error', () => {}) + const circular = { statusCode: 500 } + circular.self = circular + + assert.doesNotThrow(() => reportError('Something went wrong', circular)) + + const printedLines = errorMock.mock.calls.map((call) => call.arguments[0]) + assert.ok(printedLines.some((line) => line.includes('statusCode')), 'should print the object contents') + }) +}) diff --git a/package-lock.json b/package-lock.json index 5f6ec05..b0cbbbb 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,77 +1,379 @@ { "name": "@fusionauth/cli", - "version": "1.8.4", + "version": "1.9.1", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@fusionauth/cli", - "version": "1.8.4", + "version": "1.9.1", "hasInstallScript": true, "license": "Apache-2.0", "dependencies": { - "@comandeer/cli-spinner": "^1.0.2", - "@commander-js/extra-typings": "11.0.0", - "@faker-js/faker": "^8.4.1", - "@fusionauth/typescript-client": "1.47.0", + "@commander-js/extra-typings": "15.0.0", + "@faker-js/faker": "^10.5.0", + "@fusionauth/typescript-client": "1.68.0", "bcryptjs": "^3.0.3", "boxen": "^8.0.1", - "chalk": "5.3.0", - "chokidar": "3.5.3", - "command-exists": "^1.2.9", - "commander": "11.0.0", + "chalk": "5.6.2", + "chokidar": "5.0.0", + "commander": "15.0.0", "dotenv": "^17.4.2", - "figlet": "1.6.0", - "fs-extra": "11.1.1", - "html-to-text": "9.0.5", - "inquirer": "^13.3.0", - "log-symbols": "5.1.0", - "log-update": "5.0.1", + "figlet": "1.11.0", + "fs-extra": "11.3.6", + "html-to-text": "10.0.0", + "inquirer": "^14.0.2", + "log-symbols": "7.0.1", + "log-update": "8.0.0", "merge": "2.1.1", - "posthog-node": "^5.21.2", + "posthog-node": "^5.40.0", "queue": "7.0.0", - "remove-undefined-objects": "3.0.0", - "uuid": "9.0.0", - "yocto-spinner": "^1.1.0" + "remove-undefined-objects": "9.0.0", + "uuid": "14.0.1", + "validator": "^13.15.35", + "yocto-spinner": "^1.2.1" }, "bin": { "fusionauth": "dist/index.js" }, "devDependencies": { - "@types/figlet": "1.5.6", - "@types/fs-extra": "11.0.1", - "@types/html-to-text": "9.0.1", - "@types/mock-fs": "^4.13.4", - "@types/node": "20.4.5", - "@types/uuid": "9.0.2", - "mock-fs": "^5.5.0", - "nock": "^14.0.15", - "tsx": "^4.19.4", - "type-fest": "3.13.0", - "typescript": "5.1.6" + "@commitlint/cli": "21.2.1", + "@commitlint/config-conventional": "21.2.0", + "@types/figlet": "1.7.0", + "@types/fs-extra": "11.0.4", + "@types/html-to-text": "9.0.4", + "@types/node": "26.1.1", + "@types/validator": "^13.15.10", + "husky": "^9.1.7", + "nock": "^14.0.16", + "tsx": "^4.23.0", + "type-fest": "5.8.0", + "typescript": "7.0.2" + }, + "engines": { + "node": ">=22.22.0" + } + }, + "node_modules/@babel/code-frame": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.7.tgz", + "integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-validator-identifier": "^7.29.7", + "js-tokens": "^4.0.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz", + "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@commander-js/extra-typings": { + "version": "15.0.0", + "resolved": "https://registry.npmjs.org/@commander-js/extra-typings/-/extra-typings-15.0.0.tgz", + "integrity": "sha512-yeJlba62xqmkgELUsn7356MEnzLLu/fw2x4lofFqGnXh6YysRdEs2BaLeLtg1+KU0AXvMeqQvTTp+3hBEBK+EA==", + "license": "MIT", + "peerDependencies": { + "commander": "~15.0.0" + } + }, + "node_modules/@commitlint/cli": { + "version": "21.2.1", + "resolved": "https://registry.npmjs.org/@commitlint/cli/-/cli-21.2.1.tgz", + "integrity": "sha512-blsZGe29hJ72VGEFVl72IVYX+1vsfINpjA9yWQA6i7OKD/McGEOXg08sKIRKjFk4JvzhV/9n0l3i6NooPLTNfg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@commitlint/config-conventional": "^21.2.0", + "@commitlint/format": "^21.2.0", + "@commitlint/lint": "^21.2.0", + "@commitlint/load": "^21.2.0", + "@commitlint/read": "^21.2.1", + "@commitlint/types": "^21.2.0", + "tinyexec": "^1.0.0", + "yargs": "^18.0.0" + }, + "bin": { + "commitlint": "cli.js" + }, + "engines": { + "node": ">=22.12.0" } }, - "node_modules/@comandeer/cli-spinner": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/@comandeer/cli-spinner/-/cli-spinner-1.0.2.tgz", - "integrity": "sha512-rdUXcb/Vu3cSwdciv2wYHYP322nM7tAOgSVJmEvtQknKy6eysCy8PiFUyvBWW/CXV20PIkPD9hTVPXIFhfEwew==", + "node_modules/@commitlint/config-conventional": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/config-conventional/-/config-conventional-21.2.0.tgz", + "integrity": "sha512-Qf8WRDVcyVd14if6VTWenebxFbKnVnbzPUJjlzjkyJGeHK2xCGd63Dr1XZzj0plXKQb9P0BfOxoc1HVeCo2BWQ==", + "dev": true, "license": "MIT", "dependencies": { - "ansi-escapes": "^6.2.0", - "is-interactive": "^2.0.0", - "tslib": "^2.6.1" + "@commitlint/types": "^21.2.0", + "conventional-changelog-conventionalcommits": "^10.0.0" }, "engines": { - "node": ">=16.0.0" + "node": ">=22.12.0" } }, - "node_modules/@commander-js/extra-typings": { - "version": "11.0.0", - "resolved": "https://registry.npmjs.org/@commander-js/extra-typings/-/extra-typings-11.0.0.tgz", - "integrity": "sha512-06ol6Kn5gPjFY6v0vWOZ84nQwyqhZdaeZCHYH3vhwewjpOEjniF1KHZxh18887G3poWiJ8qyq5pb6ANuiddfPQ==", + "node_modules/@commitlint/config-validator": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/config-validator/-/config-validator-21.2.0.tgz", + "integrity": "sha512-t7AzNHAKeIdo/3NRGwzpufKHsKkPHmFs/56N2Fnsh0/r0rGtnQzTxk6vnFgjaGr4hdSQKNB50/KAhR9Yk4LJKA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@commitlint/types": "^21.2.0", + "ajv": "^8.11.0" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/ensure": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/ensure/-/ensure-21.2.0.tgz", + "integrity": "sha512-76IF9vDNS13lAzEEik9eKwzt8f9hYhWiwVXZ2AnyLCz5/f511FsEQ3pw1X3/zSQpdRLQU7i5qDMVKyXi1GWjSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@commitlint/types": "^21.2.0", + "es-toolkit": "^1.46.0" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/execute-rule": { + "version": "21.0.1", + "resolved": "https://registry.npmjs.org/@commitlint/execute-rule/-/execute-rule-21.0.1.tgz", + "integrity": "sha512-RifH+FmImozKBE6mozhF4K3r2RRKP7SMi/Q/zLCmExtp5e05lhHOUYqGBlFBAGNHaZxU/WYw1XuugYK9jQzqnA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/format": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/format/-/format-21.2.0.tgz", + "integrity": "sha512-c4q64xaav2U83t7k7RyzJerBZurPer7FxUOY0RL5L/6CZijZ7K+s6HIBGIghj0ey1P2+seRX0J9XQYtDued6tg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@commitlint/types": "^21.2.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/is-ignored": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/is-ignored/-/is-ignored-21.2.0.tgz", + "integrity": "sha512-4/eB0vBN7L88O/oC4ajAEqi7j2ZfNgxl/+11RfAV9YosejZgDXhY2C9VcHnHJhOzPLoSy5P3Mg/46kqeyJfXKw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@commitlint/types": "^21.2.0", + "semver": "^7.6.0" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/lint": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/lint/-/lint-21.2.0.tgz", + "integrity": "sha512-ceO5dp9pLjEZ6y6qbq/uXWXDPykqqlTsyzoQ0NzecpisSJhK3kTy9qzQoPeJuWG/IMNdV1lO0RgmzqoAlSi1uw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@commitlint/is-ignored": "^21.2.0", + "@commitlint/parse": "^21.2.0", + "@commitlint/rules": "^21.2.0", + "@commitlint/types": "^21.2.0" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/load": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/load/-/load-21.2.0.tgz", + "integrity": "sha512-RjlzWQqruRwIenJEfZtq7kG97co97nKoHpflE5YnF61tDLXxHPrdWImgzw6VL6MlFyaOcVlk74eBV8ZQmc3oIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@commitlint/config-validator": "^21.2.0", + "@commitlint/execute-rule": "^21.0.1", + "@commitlint/resolve-extends": "^21.2.0", + "@commitlint/types": "^21.2.0", + "cosmiconfig": "^9.0.1", + "cosmiconfig-typescript-loader": "^6.1.0", + "es-toolkit": "^1.46.0", + "is-plain-obj": "^4.1.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/message": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/message/-/message-21.2.0.tgz", + "integrity": "sha512-YxGoiXD/HXNXLJPrQwE5poXa+XH0CBEm+mdvbHQP0g6MV/dmJyUFCzPNzZbxL93GvZ70TmtTK0Z0/IBpAqHv8g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/parse": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/parse/-/parse-21.2.0.tgz", + "integrity": "sha512-QHWxG4d0PLTF634/AdyZ0MQS+CLn5YOuJlCFhMMlSGKFxzYGUetkHBj18xgBD+6fVzUrA2lrCdi/vlS2f/oYXg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@commitlint/types": "^21.2.0", + "conventional-changelog-angular": "^9.0.0", + "conventional-commits-parser": "^7.0.0" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/read": { + "version": "21.2.1", + "resolved": "https://registry.npmjs.org/@commitlint/read/-/read-21.2.1.tgz", + "integrity": "sha512-hUW7EJQnNTL0vPOmVMNK4CrnrNBN0nN+JJHReFkdHO5y4iyHeEmTBwuC15OCqUTjxWo7idnH1LftfpWVIaPWIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@commitlint/top-level": "^21.2.0", + "@commitlint/types": "^21.2.0", + "@conventional-changelog/git-client": "^3.0.0", + "tinyexec": "^1.0.0" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/resolve-extends": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/resolve-extends/-/resolve-extends-21.2.0.tgz", + "integrity": "sha512-4O/1j51+79Wth9s/MGxt/5gs0XYLDgNlYpltQfhAvLE0itusLKs9zruxbiNg1oOkmkb9L9L4USYGjEj7n87NxA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@commitlint/config-validator": "^21.2.0", + "@commitlint/types": "^21.2.0", + "es-toolkit": "^1.46.0", + "global-directory": "^5.0.0", + "resolve-from": "^5.0.0" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/rules": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/rules/-/rules-21.2.0.tgz", + "integrity": "sha512-C2yXMNpiB8ETZKfx5JD8+ExgF8vTU1VQMKPSUUYwqKpw9oJWQBrlXBpdU038mj2WPjof7o9UzFpmTyBeGMZwZg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@commitlint/ensure": "^21.2.0", + "@commitlint/message": "^21.2.0", + "@commitlint/to-lines": "^21.0.1", + "@commitlint/types": "^21.2.0" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/to-lines": { + "version": "21.0.1", + "resolved": "https://registry.npmjs.org/@commitlint/to-lines/-/to-lines-21.0.1.tgz", + "integrity": "sha512-bd1BFII7p1EQZre9Kaj+kKaMFP3cFCdt21K7DItVux9XP5WjLgJ0/Uy1pJJh9aPwVJ6SKg62PxqlZaHI8hQAXw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/top-level": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/top-level/-/top-level-21.2.0.tgz", + "integrity": "sha512-Y5gmQ+KxzqCrBFJfLvFEPvvwD3LDiNZoTT2yeFBm96M8qhmqSzQc5DvX3rheAaAMjyIvMXOCLS/mWfdpONsjyQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "escalade": "^3.2.0" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@commitlint/types": { + "version": "21.2.0", + "resolved": "https://registry.npmjs.org/@commitlint/types/-/types-21.2.0.tgz", + "integrity": "sha512-7zVFCDB2reMvJH5dmbKnOQPjZEvjdJTH8jc0U/PIPU1r3/+vf5pD1HlfitV2MWsWXrvu7u39iY1lyLUPOaN0Gw==", + "dev": true, "license": "MIT", + "dependencies": { + "conventional-commits-parser": "^7.0.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@conventional-changelog/git-client": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/@conventional-changelog/git-client/-/git-client-3.1.0.tgz", + "integrity": "sha512-Tqa/gHco2WJWa740NRjOrfKVvzIqxkZpecb8bemaQ8sKM5PXb1UK4uTyTb/1wIqNuOVaDOFxyBdhTIQZn6gdjQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@simple-libs/child-process-utils": "^2.0.0", + "@simple-libs/stream-utils": "^2.0.0", + "semver": "^7.5.2" + }, + "engines": { + "node": ">=22" + }, "peerDependencies": { - "commander": "11.0.x" + "conventional-commits-filter": "^6.0.1", + "conventional-commits-parser": "^7.0.1" + }, + "peerDependenciesMeta": { + "conventional-commits-filter": { + "optional": true + }, + "conventional-commits-parser": { + "optional": true + } + } + }, + "node_modules/@conventional-changelog/template": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/@conventional-changelog/template/-/template-1.2.1.tgz", + "integrity": "sha512-TzlTVpKPjaqW6qOYjQcYUDuGsLCNsvFHVBXkYGTAnf5V37jCWrE5haKNXzz0WZUtVHjrpV76L1buANjwXMfT8w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22" } }, "node_modules/@esbuild/aix-ppc64": { @@ -517,9 +819,9 @@ } }, "node_modules/@faker-js/faker": { - "version": "8.4.1", - "resolved": "https://registry.npmjs.org/@faker-js/faker/-/faker-8.4.1.tgz", - "integrity": "sha512-XQ3cU+Q8Uqmrbf2e0cIC/QN43sTBSC8KF12u29Mb47tWrt2hAgBXSgpZMj4Ao8Uk0iJcU99QsOCaIL8934obCg==", + "version": "10.5.0", + "resolved": "https://registry.npmjs.org/@faker-js/faker/-/faker-10.5.0.tgz", + "integrity": "sha512-bsxD8WLS5lIj7aaoCx1YJkktqYj5vlBUE6HWzu2Q51ksrGJ0H737ECCKlFU7Yf8Br45z9t99frBp/J7kzbMPAg==", "funding": [ { "type": "opencollective", @@ -528,14 +830,14 @@ ], "license": "MIT", "engines": { - "node": "^14.17.0 || ^16.13.0 || >=18.0.0", - "npm": ">=6.14.13" + "node": "^20.19.0 || ^22.13.0 || ^23.5.0 || >=24.0.0", + "npm": ">=10" } }, "node_modules/@fusionauth/typescript-client": { - "version": "1.47.0", - "resolved": "https://registry.npmjs.org/@fusionauth/typescript-client/-/typescript-client-1.47.0.tgz", - "integrity": "sha512-XXBy5BnoTED5HScxtxgbHEO3neIkTocEo9AUVDprk3JER49BbZbaNoMHrbMioJNAM5LWs3AN8AHIot18oq96nA==", + "version": "1.68.0", + "resolved": "https://registry.npmjs.org/@fusionauth/typescript-client/-/typescript-client-1.68.0.tgz", + "integrity": "sha512-sologxFpdf8CzRj5xSwhaAoKQUdL8fflBSkqA+vskmyZQ5l1a52cSkeZq+wD3YQWZsAM61tNG9WR8zNihMbFeQ==", "license": "Apache-2.0", "dependencies": { "node-fetch": "^2.6.1" @@ -913,38 +1215,76 @@ "license": "MIT" }, "node_modules/@posthog/core": { - "version": "1.10.0", - "resolved": "https://registry.npmjs.org/@posthog/core/-/core-1.10.0.tgz", - "integrity": "sha512-Xk3JQ+cdychsvftrV3G9ZrN9W329lbyFW0pGJXFGKFQf8qr4upw2SgNg9BVorjSrfhoXZRnJGt/uNF4nGFBL5A==", + "version": "1.39.6", + "resolved": "https://registry.npmjs.org/@posthog/core/-/core-1.39.6.tgz", + "integrity": "sha512-o6ajIwN5zXoNP0D4H/QPmOyibNTUkSyOR6ya7AG5U2ywXx4awo72L2KnCoiZPQM5x/bXv6jPBdimH8M18Ax0aw==", "license": "MIT", "dependencies": { - "cross-spawn": "^7.0.6" + "@posthog/types": "^1.392.0" } }, + "node_modules/@posthog/types": { + "version": "1.392.1", + "resolved": "https://registry.npmjs.org/@posthog/types/-/types-1.392.1.tgz", + "integrity": "sha512-Qg6Gl7/1vlr8+gPtBi5gwnLgAgiyFoKOVmTvTtDcvya9cpTwZfna7rQmkGQ4B63CunUYNNbOlqcwiUwUDyTK6w==", + "license": "MIT" + }, "node_modules/@selderee/plugin-htmlparser2": { - "version": "0.11.0", - "resolved": "https://registry.npmjs.org/@selderee/plugin-htmlparser2/-/plugin-htmlparser2-0.11.0.tgz", - "integrity": "sha512-P33hHGdldxGabLFjPPpaTxVolMrzrcegejx+0GxjrIb9Zv48D8yAIA/QTDR2dFl7Uz7urX8aX6+5bCZslr+gWQ==", + "version": "0.12.0", + "resolved": "https://registry.npmjs.org/@selderee/plugin-htmlparser2/-/plugin-htmlparser2-0.12.0.tgz", + "integrity": "sha512-oELmoyA6ML9jDRMV3kgcMQFKxUfBU0yFVn6yTctVaLT5ygXnxH52I3TZEgV9EhXJC68/uFvE5Daj1/25c0Xa/A==", "license": "MIT", "dependencies": { - "domhandler": "^5.0.3", - "selderee": "^0.11.0" + "domelementtype": "~2.3.0", + "domhandler": "~5.0.3" + }, + "funding": { + "url": "https://github.com/sponsors/KillyMXI" + }, + "peerDependencies": { + "selderee": "~0.12.0" + } + }, + "node_modules/@simple-libs/child-process-utils": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/@simple-libs/child-process-utils/-/child-process-utils-2.0.0.tgz", + "integrity": "sha512-dvNoRKLijXnD0XoJAz94pbNuB5GQgDr55UhpSPhffDkTT0Cmcqh9jSCOtwfT2d4H6MI9E7c4SgtMuJXZ6F3c6A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@simple-libs/stream-utils": "^2.0.0" + }, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://ko-fi.com/dangreen" + } + }, + "node_modules/@simple-libs/stream-utils": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/@simple-libs/stream-utils/-/stream-utils-2.0.0.tgz", + "integrity": "sha512-fCTuZK4QBa+39Oz9l4OGfJfz+GpwCp3AqO7Zch3to99xHPgstVsRFpeQ8LNd2o1Gv8raL2mCFwiaHh7bFSp5DQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22" }, "funding": { - "url": "https://ko-fi.com/killymxi" + "url": "https://ko-fi.com/dangreen" } }, "node_modules/@types/figlet": { - "version": "1.5.6", - "resolved": "https://registry.npmjs.org/@types/figlet/-/figlet-1.5.6.tgz", - "integrity": "sha512-AOdn9cKJGXpqfHeif16xeGMwWefB4nsOyxkdRMpc+PEP3nUxzu3psJfIqhjrCNW4Sejt5i6rISWmEwK0sw03mA==", + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/@types/figlet/-/figlet-1.7.0.tgz", + "integrity": "sha512-KwrT7p/8Eo3Op/HBSIwGXOsTZKYiM9NpWRBJ5sVjWP/SmlS+oxxRvJht/FNAtliJvja44N3ul1yATgohnVBV0Q==", "dev": true, "license": "MIT" }, "node_modules/@types/fs-extra": { - "version": "11.0.1", - "resolved": "https://registry.npmjs.org/@types/fs-extra/-/fs-extra-11.0.1.tgz", - "integrity": "sha512-MxObHvNl4A69ofaTRU8DFqvgzzv8s9yRtaPPm5gud9HDNvpB3GPQFvNuTWAI59B9huVGV5jXYJwbCsmBsOGYWA==", + "version": "11.0.4", + "resolved": "https://registry.npmjs.org/@types/fs-extra/-/fs-extra-11.0.4.tgz", + "integrity": "sha512-yTbItCNreRooED33qjunPthRcSjERP1r4MqCZc7wv0u2sUkzTFp45tgUfS5+r7FrZPdmCCNflLhVSP/o+SemsQ==", "dev": true, "license": "MIT", "dependencies": { @@ -953,9 +1293,9 @@ } }, "node_modules/@types/html-to-text": { - "version": "9.0.1", - "resolved": "https://registry.npmjs.org/@types/html-to-text/-/html-to-text-9.0.1.tgz", - "integrity": "sha512-sHu702QGb0SP2F0Zt+CxdCmGZIZ0gEaaCjqOh/V4iba1wTxPVntEPOM/vHm5bel08TILhB3+OxUTkDJWnr/zHQ==", + "version": "9.0.4", + "resolved": "https://registry.npmjs.org/@types/html-to-text/-/html-to-text-9.0.4.tgz", + "integrity": "sha512-pUY3cKH/Nm2yYrEmDlPR1mR7yszjGx4DrwPjQ702C4/D5CwHuZTgZdIdwPkRbcuhs7BAh2L5rg3CL5cbRiGTCQ==", "dev": true, "license": "MIT" }, @@ -969,96 +1309,449 @@ "@types/node": "*" } }, - "node_modules/@types/mock-fs": { - "version": "4.13.4", - "resolved": "https://registry.npmjs.org/@types/mock-fs/-/mock-fs-4.13.4.tgz", - "integrity": "sha512-mXmM0o6lULPI8z3XNnQCpL0BGxPwx1Ul1wXYEPBGl4efShyxW2Rln0JOPEWGyZaYZMM6OVXM/15zUuFMY52ljg==", - "dev": true, + "node_modules/@types/node": { + "version": "26.1.1", + "resolved": "https://registry.npmjs.org/@types/node/-/node-26.1.1.tgz", + "integrity": "sha512-nxAkRSVkN1Y0JC1W8ky/fTfkGsMmcrRsbx+3XoZE+rMOX71kLYTV7fLXpqud1GpbpP5TuffXFqfX7fH2GgZREw==", + "devOptional": true, "license": "MIT", "dependencies": { - "@types/node": "*" + "undici-types": "~8.3.0" } }, - "node_modules/@types/node": { - "version": "20.4.5", - "resolved": "https://registry.npmjs.org/@types/node/-/node-20.4.5.tgz", - "integrity": "sha512-rt40Nk13II9JwQBdeYqmbn2Q6IVTA5uPhvSO+JVqdXw/6/4glI6oR9ezty/A9Hg5u7JH4OmYmuQ+XvjKm0Datg==", - "devOptional": true, - "license": "MIT" - }, - "node_modules/@types/uuid": { - "version": "9.0.2", - "resolved": "https://registry.npmjs.org/@types/uuid/-/uuid-9.0.2.tgz", - "integrity": "sha512-kNnC1GFBLuhImSnV7w4njQkUiJi0ZXUycu1rUaouPqiKlXkh77JKgdRnTAp1x5eBwcIwbtI+3otwzuIDEuDoxQ==", + "node_modules/@types/validator": { + "version": "13.15.10", + "resolved": "https://registry.npmjs.org/@types/validator/-/validator-13.15.10.tgz", + "integrity": "sha512-T8L6i7wCuyoK8A/ZeLYt1+q0ty3Zb9+qbSSvrIVitzT3YjZqkTZ40IbRsPanlB4h1QB3JVL1SYCdR6ngtFYcuA==", "dev": true, "license": "MIT" }, - "node_modules/ansi-align": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/ansi-align/-/ansi-align-3.0.1.tgz", - "integrity": "sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w==", - "license": "ISC", - "dependencies": { - "string-width": "^4.1.0" + "node_modules/@typescript/typescript-aix-ppc64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-aix-ppc64/-/typescript-aix-ppc64-7.0.2.tgz", + "integrity": "sha512-MTKKkWB7p/0E9xi1d1tHtZ5PiLkGEMIq88pK2CubZjOsLtYTLqhgIgi6zepFa+9GHZ6h05NMCkQxGKiPXMxXtQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=16.20.0" } }, - "node_modules/ansi-align/node_modules/ansi-regex": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", - "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", - "license": "MIT", + "node_modules/@typescript/typescript-darwin-arm64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-darwin-arm64/-/typescript-darwin-arm64-7.0.2.tgz", + "integrity": "sha512-gowzar9MwS/aRWp6f3a4KUqzRjAZjOsmGNCM6LcTgXum+dBfgsBVMN+AgvOCCbguXyick6LJhpBszxMebJ8syA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], "engines": { - "node": ">=8" + "node": ">=16.20.0" } }, - "node_modules/ansi-align/node_modules/emoji-regex": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", - "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", - "license": "MIT" - }, - "node_modules/ansi-align/node_modules/is-fullwidth-code-point": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", - "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", - "license": "MIT", + "node_modules/@typescript/typescript-darwin-x64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-darwin-x64/-/typescript-darwin-x64-7.0.2.tgz", + "integrity": "sha512-SZ9xZInqApNlNGc9s0W1VSsktYSOe9cFqNOIqmN1Gs8SmkjKZYFt017G4VwPxASInODuAdbTW7sXiFUf893RgA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], "engines": { - "node": ">=8" + "node": ">=16.20.0" } }, - "node_modules/ansi-align/node_modules/string-width": { - "version": "4.2.3", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", - "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", - "license": "MIT", - "dependencies": { - "emoji-regex": "^8.0.0", - "is-fullwidth-code-point": "^3.0.0", - "strip-ansi": "^6.0.1" - }, + "node_modules/@typescript/typescript-freebsd-arm64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-freebsd-arm64/-/typescript-freebsd-arm64-7.0.2.tgz", + "integrity": "sha512-W5NH4y/J0plIIS5b2xvTEkU7JFxyqdMAOgf+Ilhl0vHQXKO5dZoxd+C/jEtq56c4F3wk71RB4BMRQ2XdI+bwYQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "freebsd" + ], "engines": { - "node": ">=8" + "node": ">=16.20.0" } }, - "node_modules/ansi-align/node_modules/strip-ansi": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", - "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "license": "MIT", - "dependencies": { - "ansi-regex": "^5.0.1" - }, + "node_modules/@typescript/typescript-freebsd-x64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-freebsd-x64/-/typescript-freebsd-x64-7.0.2.tgz", + "integrity": "sha512-UMGDx5sTpzNw3WiPebH7l90IWfJggEd+egHt/q6p7/Cm3zqoV7VxkGXt+3DxPIw8CcmvAB0j3sVVfbhX+M4Tpw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-linux-arm": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-arm/-/typescript-linux-arm-7.0.2.tgz", + "integrity": "sha512-gffT3xPz9sR7j/YJExkyPntrI0P2EP9XbOyWzth2/Gs0RstK+90RBcO0ncXoXy/beYll1SXw846Nf2zdnEz0QQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-linux-arm64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-arm64/-/typescript-linux-arm64-7.0.2.tgz", + "integrity": "sha512-Qh4eU4/y3yDjnfjjyPYihMj5/ODIlmt+Bzu17OI+fiSRDW57QmU5SiN63exPRNJPKUzcc1INa1NXdrJ+MqHjUQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-linux-loong64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-loong64/-/typescript-linux-loong64-7.0.2.tgz", + "integrity": "sha512-uEHck9i8hoAzXPiYRib1O7miOnz23SxIeVl6F4LXox+qov1K35jHcEW6VHKvZI+pyvl7fZEP4MCU5LYvIq1GuQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-linux-mips64el": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-mips64el/-/typescript-linux-mips64el-7.0.2.tgz", + "integrity": "sha512-R4KvAMnE43W5Qeqb0Ly56O3mWMWIAgsMyz36DCaycd5nbg/9kzm0liw3JocfRqyJY0KPmzFjbswozXyW0DnIYA==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-linux-ppc64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-ppc64/-/typescript-linux-ppc64-7.0.2.tgz", + "integrity": "sha512-DORx5b3sd/4S7eayxm4FQv+A7CrkUIGRaHiwI8oiHTAI1fAPWhF4J0vAlkC8biAlHSVVwxMQ3tjZ2/DVbnQiiA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-linux-riscv64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-riscv64/-/typescript-linux-riscv64-7.0.2.tgz", + "integrity": "sha512-wf0jqEDOjrPRnKwYRyyJDRo11KMbvMFrU+q4zqKyChODBzvlkbhNQfKvLxQCcwTpdDaXSHZTVuh0JoCrKCUMHQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-linux-s390x": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-s390x/-/typescript-linux-s390x-7.0.2.tgz", + "integrity": "sha512-IkwJc3L7yhytWd/ewjyxNDfOmswCm9GWMJT/ue/dU4aZNbwZeYAetq42VyLmsmSjvoX7z74X6ZaYCtzAr0EuGw==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-linux-x64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-x64/-/typescript-linux-x64-7.0.2.tgz", + "integrity": "sha512-EYdf2cNg7rgCWJnxCdJ+F3V39O8ihb37eHAu1LK8oAFizgTQbPOK7zHHXbPt8rX24COqODXeI3sIf0fCXG7H/A==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-netbsd-arm64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-netbsd-arm64/-/typescript-netbsd-arm64-7.0.2.tgz", + "integrity": "sha512-+polYF4MF04aPpO5FTkHran9yUQDSXqy5GiSDKpsll5jy3l3+g9QLhpf39T+ePtefhXLOGrLl0QIjkQP6VnelA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-netbsd-x64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-netbsd-x64/-/typescript-netbsd-x64-7.0.2.tgz", + "integrity": "sha512-8YIT0EHM/3dq10ZOVF/A7pc/YSMtbcecct4rWtexrnSCHOPcpC2KTLXfTCR6vDpnSiY12heNb1GiN/wu+T/FyA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-openbsd-arm64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-openbsd-arm64/-/typescript-openbsd-arm64-7.0.2.tgz", + "integrity": "sha512-APT8+ClYnuYm1u9+kgGXoMj2VzWzcymwh2gNSQVySHfkRDGOTVkoWLjCmOQSaO+PoqQ57B0flRp9SA+7GnnkzQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-openbsd-x64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-openbsd-x64/-/typescript-openbsd-x64-7.0.2.tgz", + "integrity": "sha512-yX7s+Q0Dln0Dt9tEzZsAjXXR/+ytBM7AlglaqyeMPxQszJ1JhlJdZ6jLA+IzldHtflX81em7lDao1xXu+aRRkg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-sunos-x64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-sunos-x64/-/typescript-sunos-x64-7.0.2.tgz", + "integrity": "sha512-dLJDGaLZ1D4HPQn62u1n8mBDkJREwMsAkCdkwd4Ieqw+x3TUyTsqY0YiBCtE6H6OzzgGk3iuZ3vFWRS+E8/d1g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-win32-arm64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-win32-arm64/-/typescript-win32-arm64-7.0.2.tgz", + "integrity": "sha512-Gyl1Vy6OsWesLzmq+EP0Fb7b4Nid5232AvcA2SFcdYreldpNtYFFofPjnt62y9hQy7VTaZp65ICJjuAQRaVcIQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/@typescript/typescript-win32-x64": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/@typescript/typescript-win32-x64/-/typescript-win32-x64-7.0.2.tgz", + "integrity": "sha512-0BQ3HkAHHlKLSp1qRvf3SUhGpGsDuhB/jgFw75guyqbxJqEaS0Cw/VFO8i2nHglJUzQCRtMMR/IBAKE3ETMC4g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=16.20.0" + } + }, + "node_modules/ajv": { + "version": "8.20.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz", + "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3", + "fast-uri": "^3.0.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ansi-align": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/ansi-align/-/ansi-align-3.0.1.tgz", + "integrity": "sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w==", + "license": "ISC", + "dependencies": { + "string-width": "^4.1.0" + } + }, + "node_modules/ansi-align/node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-align/node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "license": "MIT" + }, + "node_modules/ansi-align/node_modules/is-fullwidth-code-point": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", + "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-align/node_modules/string-width": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-align/node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, "engines": { "node": ">=8" } }, "node_modules/ansi-escapes": { - "version": "6.2.1", - "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-6.2.1.tgz", - "integrity": "sha512-4nJ3yixlEthEJ9Rk4vPcdBRkZvQZlYyu8j4/Mqz5sgIkddmEnH2Yj2ZrnP9S3tQOvSNRUIgVNF/1yPpRAGNRig==", + "version": "7.3.0", + "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-7.3.0.tgz", + "integrity": "sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==", "license": "MIT", + "dependencies": { + "environment": "^1.0.0" + }, "engines": { - "node": ">=14.16" + "node": ">=18" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" @@ -1088,18 +1781,12 @@ "url": "https://github.com/chalk/ansi-styles?sponsor=1" } }, - "node_modules/anymatch": { - "version": "3.1.3", - "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", - "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", - "license": "ISC", - "dependencies": { - "normalize-path": "^3.0.0", - "picomatch": "^2.0.4" - }, - "engines": { - "node": ">= 8" - } + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "dev": true, + "license": "Python-2.0" }, "node_modules/bcryptjs": { "version": "3.0.3", @@ -1110,18 +1797,6 @@ "bcrypt": "bin/bcrypt" } }, - "node_modules/binary-extensions": { - "version": "2.3.0", - "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz", - "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==", - "license": "MIT", - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, "node_modules/boxen": { "version": "8.0.1", "resolved": "https://registry.npmjs.org/boxen/-/boxen-8.0.1.tgz", @@ -1156,16 +1831,14 @@ "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/braces": { - "version": "3.0.3", - "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", - "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "node_modules/callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", + "dev": true, "license": "MIT", - "dependencies": { - "fill-range": "^7.1.1" - }, "engines": { - "node": ">=8" + "node": ">=6" } }, "node_modules/camelcase": { @@ -1181,9 +1854,9 @@ } }, "node_modules/chalk": { - "version": "5.3.0", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.3.0.tgz", - "integrity": "sha512-dLitG79d+GV1Nb/VYcCDFivJeK1hiukt9QjRNVOsUtTy1rR1YJsmpGGTZ3qJos+uw7WmWF4wUwBd9jxjocFC2w==", + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz", + "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==", "license": "MIT", "engines": { "node": "^12.17.0 || ^14.13 || >=16.0.0" @@ -1199,30 +1872,18 @@ "license": "MIT" }, "node_modules/chokidar": { - "version": "3.5.3", - "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.5.3.tgz", - "integrity": "sha512-Dr3sfKRP6oTcjf2JmUmFJfeVMvXBdegxB0iVQ5eb2V10uFJUCAS8OByZdVAyVb8xXNz3GjjTgj9kLWsZTqE6kw==", - "funding": [ - { - "type": "individual", - "url": "https://paulmillr.com/funding/" - } - ], + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-5.0.0.tgz", + "integrity": "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==", "license": "MIT", "dependencies": { - "anymatch": "~3.1.2", - "braces": "~3.0.2", - "glob-parent": "~5.1.2", - "is-binary-path": "~2.1.0", - "is-glob": "~4.0.1", - "normalize-path": "~3.0.0", - "readdirp": "~3.6.0" + "readdirp": "^5.0.0" }, "engines": { - "node": ">= 8.10.0" + "node": ">= 20.19.0" }, - "optionalDependencies": { - "fsevents": "~2.3.2" + "funding": { + "url": "https://paulmillr.com/funding/" } }, "node_modules/cli-boxes": { @@ -1238,15 +1899,15 @@ } }, "node_modules/cli-cursor": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-4.0.0.tgz", - "integrity": "sha512-VGtlMu3x/4DOtIUwEkRezxUZ2lBacNJCHash0N0WeZDBS+7Ux1dm3XWAgWYxLJFMMdOeXMHXorshEFhbMSGelg==", + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-5.0.0.tgz", + "integrity": "sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==", "license": "MIT", "dependencies": { - "restore-cursor": "^4.0.0" + "restore-cursor": "^5.0.0" }, "engines": { - "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + "node": ">=18" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" @@ -1261,42 +1922,125 @@ "node": ">= 12" } }, - "node_modules/command-exists": { - "version": "1.2.9", - "resolved": "https://registry.npmjs.org/command-exists/-/command-exists-1.2.9.tgz", - "integrity": "sha512-LTQ/SGc+s0Xc0Fu5WaKnR0YiygZkm9eKFvyS+fRsU7/ZWFF8ykFM6Pc9aCVf1+xasOOZpO3BAVgVrKvsqKHV7w==", - "license": "MIT" + "node_modules/cliui": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-9.0.1.tgz", + "integrity": "sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==", + "dev": true, + "license": "ISC", + "dependencies": { + "string-width": "^7.2.0", + "strip-ansi": "^7.1.0", + "wrap-ansi": "^9.0.0" + }, + "engines": { + "node": ">=20" + } }, "node_modules/commander": { - "version": "11.0.0", - "resolved": "https://registry.npmjs.org/commander/-/commander-11.0.0.tgz", - "integrity": "sha512-9HMlXtt/BNoYr8ooyjjNRdIilOTkVJXB+GhxMTtOKwk0R4j4lS4NpjuqmRxroBfnfTSHQIHQB7wryHhXarNjmQ==", + "version": "15.0.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-15.0.0.tgz", + "integrity": "sha512-z67u4ZhzCL/Tydu1lJARtEZYWbWaN7oYLHbsuzocr6y4N6WZAagG3RQ4FW61V1/0+jImpj293XfrcYnd1qxtPg==", "license": "MIT", "engines": { - "node": ">=16" + "node": ">=22.12.0" + } + }, + "node_modules/conventional-changelog-angular": { + "version": "9.2.1", + "resolved": "https://registry.npmjs.org/conventional-changelog-angular/-/conventional-changelog-angular-9.2.1.tgz", + "integrity": "sha512-oWSL6ZhnXbYraOFTK3PgRAQJ8fADDAEv5K6AdeyQPLvjFmhG8+ejL0jZZp/R7vTmGJaBvZEE+sE7dB4bCv7sAw==", + "dev": true, + "license": "ISC", + "dependencies": { + "@conventional-changelog/template": "^1.2.1" + }, + "engines": { + "node": ">=22" + } + }, + "node_modules/conventional-changelog-conventionalcommits": { + "version": "10.2.1", + "resolved": "https://registry.npmjs.org/conventional-changelog-conventionalcommits/-/conventional-changelog-conventionalcommits-10.2.1.tgz", + "integrity": "sha512-n4Kr1HFMTf3iMbES0TMxKIcYtUUv4rKqyQQp2JwfOEfFCOfGT3Tq4mCyJ8S9/YPyWhydjfKrrvnyl+gCjA+mJQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "@conventional-changelog/template": "^1.2.1" + }, + "engines": { + "node": ">=22" } }, - "node_modules/cross-spawn": { - "version": "7.0.6", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", - "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "node_modules/conventional-commits-parser": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/conventional-commits-parser/-/conventional-commits-parser-7.0.1.tgz", + "integrity": "sha512-6VtskFpPsNkGVk/TY2RnV/MEdKfvCPBtQZN9x8jh9+k5RWBQ+tiaWn5UFCzTr0Dd88iKx7xghxbjBRp5uIzp3g==", + "dev": true, "license": "MIT", "dependencies": { - "path-key": "^3.1.0", - "shebang-command": "^2.0.0", - "which": "^2.0.1" + "@simple-libs/stream-utils": "^2.0.0", + "meow": "^14.0.0" + }, + "bin": { + "conventional-commits-parser": "dist/cli/index.js" }, "engines": { - "node": ">= 8" + "node": ">=22" } }, - "node_modules/deepmerge": { - "version": "4.3.1", - "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz", - "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==", + "node_modules/cosmiconfig": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-9.0.2.tgz", + "integrity": "sha512-gtTZxTDau1wL7Y7zifc2dd8jHSK/k6BTx/2Xp/BpdlAdnlYWFVt7qhJqgwi7637yRwRQ3qL4ZidbB4I8tA5VOg==", + "dev": true, "license": "MIT", + "dependencies": { + "env-paths": "^2.2.1", + "import-fresh": "^3.3.0", + "js-yaml": "^4.1.0", + "parse-json": "^5.2.0" + }, "engines": { - "node": ">=0.10.0" + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/d-fischer" + }, + "peerDependencies": { + "typescript": ">=4.9.5" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/cosmiconfig-typescript-loader": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/cosmiconfig-typescript-loader/-/cosmiconfig-typescript-loader-6.3.0.tgz", + "integrity": "sha512-Akr82WH1Wfqatyiqpj8HDkO2o2KmJRu1FhKfSNJP3K4IdXwHfEyL7MOb62i1AGQVLtIQM+iCE9CGOtrfhR+mmA==", + "dev": true, + "license": "MIT", + "dependencies": { + "jiti": "2.6.1" + }, + "engines": { + "node": ">=v18" + }, + "peerDependencies": { + "@types/node": "*", + "cosmiconfig": ">=9", + "typescript": ">=5" + } + }, + "node_modules/deepmerge-ts": { + "version": "7.1.5", + "resolved": "https://registry.npmjs.org/deepmerge-ts/-/deepmerge-ts-7.1.5.tgz", + "integrity": "sha512-HOJkrhaYsweh+W+e74Yn7YStZOilkoPb6fycpwNLKzSPtruFs48nYis0zy5yJz1+ktUhHxoRDJ27RQAWLIJVJw==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=16.0.0" } }, "node_modules/dom-serializer": { @@ -1366,12 +2110,6 @@ "url": "https://dotenvx.com" } }, - "node_modules/eastasianwidth": { - "version": "0.2.0", - "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz", - "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==", - "license": "MIT" - }, "node_modules/emoji-regex": { "version": "10.6.0", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz", @@ -1390,6 +2128,49 @@ "url": "https://github.com/fb55/entities?sponsor=1" } }, + "node_modules/env-paths": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz", + "integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/environment": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/environment/-/environment-1.1.0.tgz", + "integrity": "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/error-ex": { + "version": "1.3.4", + "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.4.tgz", + "integrity": "sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-arrayish": "^0.2.1" + } + }, + "node_modules/es-toolkit": { + "version": "1.49.0", + "resolved": "https://registry.npmjs.org/es-toolkit/-/es-toolkit-1.49.0.tgz", + "integrity": "sha512-G5iZ6Pc/FNRY/soKZHC+TxGDD83rHUDXxzaWhGCX44vAv/tMs56WMusnm/KMNK+luUPsgA9U28cGr4RDlSzL2g==", + "dev": true, + "license": "MIT", + "workspaces": [ + "docs", + "benchmarks" + ] + }, "node_modules/esbuild": { "version": "0.28.1", "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.1.tgz", @@ -1432,6 +2213,23 @@ "@esbuild/win32-x64": "0.28.1" } }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "dev": true, + "license": "MIT" + }, "node_modules/fast-string-truncated-width": { "version": "3.0.3", "resolved": "https://registry.npmjs.org/fast-string-truncated-width/-/fast-string-truncated-width-3.0.3.tgz", @@ -1447,6 +2245,23 @@ "fast-string-truncated-width": "^3.0.2" } }, + "node_modules/fast-uri": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.3.tgz", + "integrity": "sha512-i70LwGWUduXqzicKXWshooq+sWL1K3WUU5rKZNG/0i3a1OSoX3HqhH5WbWwTmqWfor4urUakGPiRQcleRZTwOg==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, "node_modules/fast-wrap-ansi": { "version": "0.2.2", "resolved": "https://registry.npmjs.org/fast-wrap-ansi/-/fast-wrap-ansi-0.2.2.tgz", @@ -1457,33 +2272,33 @@ } }, "node_modules/figlet": { - "version": "1.6.0", - "resolved": "https://registry.npmjs.org/figlet/-/figlet-1.6.0.tgz", - "integrity": "sha512-31EQGhCEITv6+hi2ORRPyn3bulaV9Fl4xOdR169cBzH/n1UqcxsiSB/noo6SJdD7Kfb1Ljit+IgR1USvF/XbdA==", + "version": "1.11.0", + "resolved": "https://registry.npmjs.org/figlet/-/figlet-1.11.0.tgz", + "integrity": "sha512-EEx3OS/l2bFqcUNN2NM9FPJp8vAMrgbCxsbl2hbcJNNxOEwVe3mEzrhan7TbJQViZa8mMqhihlbCaqD+LyYKTQ==", "license": "MIT", + "dependencies": { + "commander": "^14.0.0" + }, "bin": { "figlet": "bin/index.js" }, "engines": { - "node": ">= 0.4.0" + "node": ">= 17.0.0" } }, - "node_modules/fill-range": { - "version": "7.1.1", - "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", - "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "node_modules/figlet/node_modules/commander": { + "version": "14.0.3", + "resolved": "https://registry.npmjs.org/commander/-/commander-14.0.3.tgz", + "integrity": "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw==", "license": "MIT", - "dependencies": { - "to-regex-range": "^5.0.1" - }, "engines": { - "node": ">=8" + "node": ">=20" } }, "node_modules/fs-extra": { - "version": "11.1.1", - "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.1.1.tgz", - "integrity": "sha512-MGIE4HOvQCeUCzmlHs0vXpih4ysz4wg9qiSAu6cd42lVwPbTM1TjV7RusoyQqMmk/95gdQZX72u+YW+c3eEpFQ==", + "version": "11.3.6", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.3.6.tgz", + "integrity": "sha512-w8ZNZr2mKIc7qeNaQ9AVPT1+iFaI+Avd4xudVOvdDJ8VytREi1Ft5Ih7hd9jjehod8vAM5GMsfQ/TpPf4EyoEA==", "license": "MIT", "dependencies": { "graceful-fs": "^4.2.0", @@ -1498,6 +2313,7 @@ "version": "2.3.3", "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, "hasInstallScript": true, "license": "MIT", "optional": true, @@ -1508,6 +2324,16 @@ "node": "^8.16.0 || ^10.6.0 || >=11.0.0" } }, + "node_modules/get-caller-file": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", + "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", + "dev": true, + "license": "ISC", + "engines": { + "node": "6.* || 8.* || >= 10.*" + } + }, "node_modules/get-east-asian-width": { "version": "1.6.0", "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.6.0.tgz", @@ -1520,16 +2346,20 @@ "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/glob-parent": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", - "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", - "license": "ISC", + "node_modules/global-directory": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/global-directory/-/global-directory-5.0.0.tgz", + "integrity": "sha512-1pgFdhK3J2LeM+dVf2Pd424yHx2ou338lC0ErNP2hPx4j8eW1Sp0XqSjNxtk6Tc4Kr5wlWtSvz8cn2yb7/SG/w==", + "dev": true, + "license": "MIT", "dependencies": { - "is-glob": "^4.0.1" + "ini": "6.0.0" }, "engines": { - "node": ">= 6" + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/graceful-fs": { @@ -1539,25 +2369,28 @@ "license": "ISC" }, "node_modules/html-to-text": { - "version": "9.0.5", - "resolved": "https://registry.npmjs.org/html-to-text/-/html-to-text-9.0.5.tgz", - "integrity": "sha512-qY60FjREgVZL03vJU6IfMV4GDjGBIoOyvuFdpBDIX9yTlDw0TjxVBQp+P8NvpdIXNJvfWBTNul7fsAQJq2FNpg==", + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/html-to-text/-/html-to-text-10.0.0.tgz", + "integrity": "sha512-2OH59Gtprdczel+7Rxgpz9hGVJREaf8Lt1H4kZwWHpEn70VQKRuMNGsb2eDbwaTzrYzb0hheiOG1P7Dim0B4dQ==", "license": "MIT", "dependencies": { - "@selderee/plugin-htmlparser2": "^0.11.0", - "deepmerge": "^4.3.1", + "@selderee/plugin-htmlparser2": "~0.12.0", + "deepmerge-ts": "^7.1.5", "dom-serializer": "^2.0.0", - "htmlparser2": "^8.0.2", - "selderee": "^0.11.0" + "htmlparser2": "^10.1.0", + "selderee": "~0.12.0" }, "engines": { - "node": ">=14" + "node": ">=20.19.0" + }, + "funding": { + "url": "https://github.com/sponsors/KillyMXI" } }, "node_modules/htmlparser2": { - "version": "8.0.2", - "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-8.0.2.tgz", - "integrity": "sha512-GYdjWKDkbRLkZ5geuHs5NY1puJ+PXwP7+fHPRz06Eirsb9ugf6d8kkXav6ADhcODhFFPMIXyxkxSuMf3D6NCFA==", + "version": "10.1.0", + "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-10.1.0.tgz", + "integrity": "sha512-VTZkM9GWRAtEpveh7MSF6SjjrpNVNNVJfFup7xTY3UpFtm67foy9HDVXneLtFVt4pMz5kZtgNcvCniNFb1hlEQ==", "funding": [ "https://github.com/fb55/htmlparser2?sponsor=1", { @@ -1569,8 +2402,36 @@ "dependencies": { "domelementtype": "^2.3.0", "domhandler": "^5.0.3", - "domutils": "^3.0.1", - "entities": "^4.4.0" + "domutils": "^3.2.2", + "entities": "^7.0.1" + } + }, + "node_modules/htmlparser2/node_modules/entities": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz", + "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/husky": { + "version": "9.1.7", + "resolved": "https://registry.npmjs.org/husky/-/husky-9.1.7.tgz", + "integrity": "sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA==", + "dev": true, + "license": "MIT", + "bin": { + "husky": "bin.js" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/typicode" } }, "node_modules/iconv-lite": { @@ -1589,84 +2450,85 @@ "url": "https://opencollective.com/express" } }, - "node_modules/inquirer": { - "version": "13.4.3", - "resolved": "https://registry.npmjs.org/inquirer/-/inquirer-13.4.3.tgz", - "integrity": "sha512-EPd3IqieHSavSOXh+LZhrIkdQcOELWeRblLT6kslQr+cF9XTh/HxZdSt1YkHH1iq4dvqBnV42uwg2YlorgOy6g==", + "node_modules/import-fresh": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", + "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", + "dev": true, "license": "MIT", "dependencies": { - "@inquirer/ansi": "^2.0.5", - "@inquirer/core": "^11.1.10", - "@inquirer/prompts": "^8.4.3", - "@inquirer/type": "^4.0.5", - "mute-stream": "^3.0.0", - "run-async": "^4.0.6", - "rxjs": "^7.8.2" + "parent-module": "^1.0.0", + "resolve-from": "^4.0.0" }, "engines": { - "node": ">=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0" - }, - "peerDependencies": { - "@types/node": ">=18" + "node": ">=6" }, - "peerDependenciesMeta": { - "@types/node": { - "optional": true - } + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/is-binary-path": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz", - "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==", + "node_modules/import-fresh/node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true, "license": "MIT", - "dependencies": { - "binary-extensions": "^2.0.0" - }, "engines": { - "node": ">=8" + "node": ">=4" } }, - "node_modules/is-extglob": { - "version": "2.1.1", - "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", - "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", - "license": "MIT", + "node_modules/ini": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/ini/-/ini-6.0.0.tgz", + "integrity": "sha512-IBTdIkzZNOpqm7q3dRqJvMaldXjDHWkEDfrwGEQTs5eaQMWV+djAhR+wahyNNMAa+qpbDUhBMVt4ZKNwpPm7xQ==", + "dev": true, + "license": "ISC", "engines": { - "node": ">=0.10.0" + "node": "^20.17.0 || >=22.9.0" } }, - "node_modules/is-fullwidth-code-point": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-4.0.0.tgz", - "integrity": "sha512-O4L094N2/dZ7xqVdrXhh9r1KODPJpFms8B5sGdJLPy664AgvXsreZUyCQQNItZRDlYug4xStLjNp/sz3HvBowQ==", + "node_modules/inquirer": { + "version": "14.0.2", + "resolved": "https://registry.npmjs.org/inquirer/-/inquirer-14.0.2.tgz", + "integrity": "sha512-VsSx1JneSNp3ld1veMTLe+UDcUD8Tw2/jjOthhkX3/IX2q+xHhVELifeb/hsb1fBw31pabEPNUf/xUOyb+KZjA==", "license": "MIT", + "dependencies": { + "@inquirer/ansi": "^2.0.7", + "@inquirer/core": "^11.2.1", + "@inquirer/prompts": "^8.5.2", + "@inquirer/type": "^4.0.7", + "mute-stream": "^3.0.0", + "run-async": "^4.0.6" + }, "engines": { - "node": ">=12" + "node": ">=23.5.0 || ^22.13.0 || ^20.17.0" + }, + "peerDependencies": { + "@types/node": ">=18" }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } } }, - "node_modules/is-glob": { - "version": "4.0.3", - "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", - "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "node_modules/is-arrayish": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz", + "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==", + "dev": true, + "license": "MIT" + }, + "node_modules/is-fullwidth-code-point": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-5.1.0.tgz", + "integrity": "sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ==", "license": "MIT", "dependencies": { - "is-extglob": "^2.1.1" + "get-east-asian-width": "^1.3.1" }, "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/is-interactive": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/is-interactive/-/is-interactive-2.0.0.tgz", - "integrity": "sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ==", - "license": "MIT", - "engines": { - "node": ">=12" + "node": ">=18" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" @@ -1679,32 +2541,84 @@ "dev": true, "license": "MIT" }, - "node_modules/is-number": { - "version": "7.0.0", - "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", - "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "node_modules/is-plain-obj": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz", + "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==", + "dev": true, "license": "MIT", "engines": { - "node": ">=0.12.0" + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/is-unicode-supported": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-1.3.0.tgz", - "integrity": "sha512-43r2mRvz+8JRIKnWJ+3j8JtjRKZ6GmjzfaE/qiBJnikNnYv/6bagRJ1kUhNk8R5EX/GkobD+r+sfxCPJsiKBLQ==", + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-2.1.0.tgz", + "integrity": "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==", "license": "MIT", "engines": { - "node": ">=12" + "node": ">=18" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/isexe": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", - "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", - "license": "ISC" + "node_modules/jiti": { + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.6.1.tgz", + "integrity": "sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ==", + "dev": true, + "license": "MIT", + "bin": { + "jiti": "lib/jiti-cli.mjs" + } + }, + "node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/js-yaml": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.0.tgz", + "integrity": "sha512-1td788aAnnZ5qs7V2QIRl1owjtYpbKt749Y3xauqQgwIIGF/xXWz1wMTEBx5O3LK3lXLVuqXPdPxj2BoFHaW9Q==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/puzrin" + }, + { + "type": "github", + "url": "https://github.com/sponsors/nodeca" + } + ], + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/json-parse-even-better-errors": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", + "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "dev": true, + "license": "MIT" }, "node_modules/json-stringify-safe": { "version": "5.0.1", @@ -1726,114 +2640,101 @@ } }, "node_modules/leac": { - "version": "0.6.0", - "resolved": "https://registry.npmjs.org/leac/-/leac-0.6.0.tgz", - "integrity": "sha512-y+SqErxb8h7nE/fiEX07jsbuhrpO9lL8eca7/Y1nuWV2moNlXhyd59iDGcRf6moVyDMbmTNzL40SUyrFU/yDpg==", + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/leac/-/leac-0.7.0.tgz", + "integrity": "sha512-qMrZeyEekgdRQ9o6a4NAB2EQZrv827GJdn1vnapwSJ90hWRB4TzUSunvacPkxQ2TnNqHNI1/zSt0hlo0crG8Jw==", "license": "MIT", "funding": { - "url": "https://ko-fi.com/killymxi" + "url": "https://github.com/sponsors/KillyMXI" } }, + "node_modules/lines-and-columns": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz", + "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==", + "dev": true, + "license": "MIT" + }, "node_modules/log-symbols": { - "version": "5.1.0", - "resolved": "https://registry.npmjs.org/log-symbols/-/log-symbols-5.1.0.tgz", - "integrity": "sha512-l0x2DvrW294C9uDCoQe1VSU4gf529FkSZ6leBl4TiqZH/e+0R7hSfHQBNut2mNygDgHwvYHfFLn6Oxb3VWj2rA==", + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/log-symbols/-/log-symbols-7.0.1.tgz", + "integrity": "sha512-ja1E3yCr9i/0hmBVaM0bfwDjnGy8I/s6PP4DFp+yP+a+mrHO4Rm7DtmnqROTUkHIkqffC84YY7AeqX6oFk0WFg==", "license": "MIT", "dependencies": { - "chalk": "^5.0.0", - "is-unicode-supported": "^1.1.0" + "is-unicode-supported": "^2.0.0", + "yoctocolors": "^2.1.1" }, "engines": { - "node": ">=12" + "node": ">=18" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/log-update": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/log-update/-/log-update-5.0.1.tgz", - "integrity": "sha512-5UtUDQ/6edw4ofyljDNcOVJQ4c7OjDro4h3y8e1GQL5iYElYclVHJ3zeWchylvMaKnDbDilC8irOVyexnA/Slw==", + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/log-update/-/log-update-8.0.0.tgz", + "integrity": "sha512-lddSgOt3bPASrylL54ZSpy8nBHns+vBVSoILlVOx+dei300pnLRN958rj/EdlVLKuWlSESU3qdnDZdAI7FXYGg==", "license": "MIT", "dependencies": { - "ansi-escapes": "^5.0.0", - "cli-cursor": "^4.0.0", - "slice-ansi": "^5.0.0", - "strip-ansi": "^7.0.1", - "wrap-ansi": "^8.0.1" + "ansi-escapes": "^7.3.0", + "cli-cursor": "^5.0.0", + "slice-ansi": "^9.0.0", + "string-width": "^8.2.0", + "strip-ansi": "^7.2.0", + "wrap-ansi": "^10.0.0" }, "engines": { - "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + "node": ">=22" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/log-update/node_modules/ansi-escapes": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-5.0.0.tgz", - "integrity": "sha512-5GFMVX8HqE/TB+FuBJGuO5XG0WrsA6ptUqoODaT/n9mmUaZFkqnBueB4leqGBCmrUHnCnC4PCZTCd0E7QQ83bA==", + "node_modules/log-update/node_modules/string-width": { + "version": "8.2.2", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-8.2.2.tgz", + "integrity": "sha512-GaPUh5gfdrYzqeVNZvUfT23vYYxXzKYidUcnMtJg/3rxRV63EFZy3k6xfKlmfeJD0176lnUV/Usr3XcwSvFzpg==", "license": "MIT", "dependencies": { - "type-fest": "^1.0.2" + "get-east-asian-width": "^1.5.0", + "strip-ansi": "^7.1.2" }, "engines": { - "node": ">=12" + "node": ">=20" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/log-update/node_modules/emoji-regex": { - "version": "9.2.2", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", - "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==", - "license": "MIT" - }, - "node_modules/log-update/node_modules/string-width": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz", - "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==", + "node_modules/log-update/node_modules/wrap-ansi": { + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-10.0.0.tgz", + "integrity": "sha512-SGcvg80f0wUy2/fXES19feHMz8E0JoXv2uNgHOu4Dgi2OrCy1lqwFYEJz1BLbDI0exjPMe/ZdzZ/YpGECBG/aQ==", "license": "MIT", "dependencies": { - "eastasianwidth": "^0.2.0", - "emoji-regex": "^9.2.2", - "strip-ansi": "^7.0.1" + "ansi-styles": "^6.2.3", + "string-width": "^8.2.0", + "strip-ansi": "^7.1.2" }, "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/log-update/node_modules/type-fest": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-1.4.0.tgz", - "integrity": "sha512-yGSza74xk0UG8k+pLh5oeoYirvIiWo5t0/o3zHHAO2tRDiZcxWP7fywNlXhqb6/r6sWvwi+RsyQMWhVLe4BVuA==", - "license": "(MIT OR CC0-1.0)", - "engines": { - "node": ">=10" + "node": ">=20" }, "funding": { - "url": "https://github.com/sponsors/sindresorhus" + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" } }, - "node_modules/log-update/node_modules/wrap-ansi": { - "version": "8.1.0", - "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz", - "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==", + "node_modules/meow": { + "version": "14.1.0", + "resolved": "https://registry.npmjs.org/meow/-/meow-14.1.0.tgz", + "integrity": "sha512-EDYo6VlmtnumlcBCbh1gLJ//9jvM/ndXHfVXIFrZVr6fGcwTUyCTFNTLCKuY3ffbK8L/+3Mzqnd58RojiZqHVw==", + "dev": true, "license": "MIT", - "dependencies": { - "ansi-styles": "^6.1.0", - "string-width": "^5.0.1", - "strip-ansi": "^7.0.1" - }, "engines": { - "node": ">=12" + "node": ">=20" }, "funding": { - "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/merge": { @@ -1842,23 +2743,16 @@ "integrity": "sha512-jz+Cfrg9GWOZbQAnDQ4hlVnQky+341Yk5ru8bZSe6sIDTCIg8n9i/u7hSQGSVOF3C7lH6mGtqjkiT9G4wFLL0w==", "license": "MIT" }, - "node_modules/mimic-fn": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz", - "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==", - "license": "MIT", - "engines": { - "node": ">=6" - } - }, - "node_modules/mock-fs": { - "version": "5.5.0", - "resolved": "https://registry.npmjs.org/mock-fs/-/mock-fs-5.5.0.tgz", - "integrity": "sha512-d/P1M/RacgM3dB0sJ8rjeRNXxtapkPCUnMGmIN0ixJ16F/E4GUZCvWcSGfWGz8eaXYvn1s9baUwNjI4LOPEjiA==", - "dev": true, + "node_modules/mimic-function": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/mimic-function/-/mimic-function-5.0.1.tgz", + "integrity": "sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==", "license": "MIT", "engines": { - "node": ">=12.0.0" + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/mute-stream": { @@ -1905,25 +2799,16 @@ } } }, - "node_modules/normalize-path": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", - "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", - "license": "MIT", - "engines": { - "node": ">=0.10.0" - } - }, "node_modules/onetime": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz", - "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==", + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/onetime/-/onetime-7.0.0.tgz", + "integrity": "sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==", "license": "MIT", "dependencies": { - "mimic-fn": "^2.1.0" + "mimic-function": "^5.0.0" }, "engines": { - "node": ">=6" + "node": ">=18" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" @@ -1936,59 +2821,85 @@ "dev": true, "license": "MIT" }, - "node_modules/parseley": { - "version": "0.12.1", - "resolved": "https://registry.npmjs.org/parseley/-/parseley-0.12.1.tgz", - "integrity": "sha512-e6qHKe3a9HWr0oMRVDTRhKce+bRO8VGQR3NyVwcjwrbhMmFCX9KszEV35+rn4AdilFAq9VPxP/Fe1wC9Qjd2lw==", + "node_modules/parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", + "dev": true, "license": "MIT", "dependencies": { - "leac": "^0.6.0", - "peberminta": "^0.9.0" + "callsites": "^3.0.0" }, - "funding": { - "url": "https://ko-fi.com/killymxi" + "engines": { + "node": ">=6" } }, - "node_modules/path-key": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", - "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "node_modules/parse-json": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz", + "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==", + "dev": true, "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.0.0", + "error-ex": "^1.3.1", + "json-parse-even-better-errors": "^2.3.0", + "lines-and-columns": "^1.1.6" + }, "engines": { "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/peberminta": { - "version": "0.9.0", - "resolved": "https://registry.npmjs.org/peberminta/-/peberminta-0.9.0.tgz", - "integrity": "sha512-XIxfHpEuSJbITd1H3EeQwpcZbTLHc+VVr8ANI9t5sit565tsI4/xK3KWTUFE2e6QiangUkh3B0jihzmGnNrRsQ==", + "node_modules/parseley": { + "version": "0.13.1", + "resolved": "https://registry.npmjs.org/parseley/-/parseley-0.13.1.tgz", + "integrity": "sha512-uNBJZzmb60l6p6VWLTmevizNAGnE0xoSf1n0B4q3ntegDNzcS68NRCcBDZTcyXHxt2XhBChsCuqj4M+nChvE/A==", "license": "MIT", + "dependencies": { + "leac": "^0.7.0", + "peberminta": "^0.10.0" + }, "funding": { - "url": "https://ko-fi.com/killymxi" + "url": "https://github.com/sponsors/KillyMXI" } }, - "node_modules/picomatch": { - "version": "2.3.2", - "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", - "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "node_modules/peberminta": { + "version": "0.10.0", + "resolved": "https://registry.npmjs.org/peberminta/-/peberminta-0.10.0.tgz", + "integrity": "sha512-80B2AsU+I4Qdb0ZAPSfe9UwvGzwkM37IKIFEvdS3D/3Ndgv2bsuJ0bfG1+iEYO+l7Gfd4EUJmuRyq7efLgRMzQ==", "license": "MIT", - "engines": { - "node": ">=8.6" - }, "funding": { - "url": "https://github.com/sponsors/jonschlinkert" + "url": "https://github.com/sponsors/KillyMXI" } }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, "node_modules/posthog-node": { - "version": "5.21.2", - "resolved": "https://registry.npmjs.org/posthog-node/-/posthog-node-5.21.2.tgz", - "integrity": "sha512-Jehlu0KguL1LLyUczCt86OtA5INmeStK3zcgbv1BSyMcNxs0HP3GQogBrYhwhqHsk6JopiFFVpJyZEoXOUMhGw==", + "version": "5.40.0", + "resolved": "https://registry.npmjs.org/posthog-node/-/posthog-node-5.40.0.tgz", + "integrity": "sha512-DrLfHuauO0W6qruF80iqr5JdmLysef74XzOB4eh36oRLRhxCySLraTqsi2Pj161LZnp9/JNdRDxwT8ei8VK2YA==", "license": "MIT", "dependencies": { - "@posthog/core": "1.10.0" + "@posthog/core": "^1.39.6" }, "engines": { - "node": ">=20" + "node": "^20.20.0 || >=22.22.0" + }, + "peerDependencies": { + "rxjs": "^7.0.0" + }, + "peerDependenciesMeta": { + "rxjs": { + "optional": true + } } }, "node_modules/propagate": { @@ -2008,48 +2919,63 @@ "license": "MIT" }, "node_modules/readdirp": { - "version": "3.6.0", - "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz", - "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==", + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-5.0.0.tgz", + "integrity": "sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ==", "license": "MIT", - "dependencies": { - "picomatch": "^2.2.1" - }, "engines": { - "node": ">=8.10.0" + "node": ">= 20.19.0" + }, + "funding": { + "type": "individual", + "url": "https://paulmillr.com/funding/" } }, "node_modules/remove-undefined-objects": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/remove-undefined-objects/-/remove-undefined-objects-3.0.0.tgz", - "integrity": "sha512-nxG1yYfc/Jxi+bNCBiqKhxVJPE+QvziIOKbD+Dxc93Uisz92v/ZYpo4WR0TJuf+dk2xE8lW2WPJsA3mDFzXy8w==", + "version": "9.0.0", + "resolved": "https://registry.npmjs.org/remove-undefined-objects/-/remove-undefined-objects-9.0.0.tgz", + "integrity": "sha512-oTxi32KwkldmtDNo5IshRJBrCs8Pq6mB4F3Cc+Ehqh0kMExH3lONr8SoTkAD5An7ZGlu6ljus89gz2qp9bfzXQ==", "license": "MIT", "engines": { - "node": ">=16" + "node": ">=22" + } + }, + "node_modules/require-from-string": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz", + "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/resolve-from": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", + "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" } }, "node_modules/restore-cursor": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-4.0.0.tgz", - "integrity": "sha512-I9fPXU9geO9bHOt9pHHOhOkYerIMsmVaWB0rA2AI9ERh/+x/i7MV5HKBNrg+ljO5eoPVgCcnFuRjJ9uH6I/3eg==", + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-5.1.0.tgz", + "integrity": "sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==", "license": "MIT", "dependencies": { - "onetime": "^5.1.0", - "signal-exit": "^3.0.2" + "onetime": "^7.0.0", + "signal-exit": "^4.1.0" }, "engines": { - "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + "node": ">=18" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/restore-cursor/node_modules/signal-exit": { - "version": "3.0.7", - "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz", - "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", - "license": "ISC" - }, "node_modules/run-async": { "version": "4.0.6", "resolved": "https://registry.npmjs.org/run-async/-/run-async-4.0.6.tgz", @@ -2059,15 +2985,6 @@ "node": ">=0.12.0" } }, - "node_modules/rxjs": { - "version": "7.8.2", - "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-7.8.2.tgz", - "integrity": "sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==", - "license": "Apache-2.0", - "dependencies": { - "tslib": "^2.1.0" - } - }, "node_modules/safer-buffer": { "version": "2.1.2", "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", @@ -2075,36 +2992,28 @@ "license": "MIT" }, "node_modules/selderee": { - "version": "0.11.0", - "resolved": "https://registry.npmjs.org/selderee/-/selderee-0.11.0.tgz", - "integrity": "sha512-5TF+l7p4+OsnP8BCCvSyZiSPc4x4//p5uPwK8TCnVPJYRmU2aYKMpOXvw8zM5a5JvuuCGN1jmsMwuU2W02ukfA==", + "version": "0.12.0", + "resolved": "https://registry.npmjs.org/selderee/-/selderee-0.12.0.tgz", + "integrity": "sha512-b1YMh3+DHZp59DLna3qVwQ5iOla/nrI6mLBNW02XxU77M3046Df6VLkoaJyFz20VsGIG5kkp+FK0kg4K4HnUFw==", "license": "MIT", "dependencies": { - "parseley": "^0.12.0" + "parseley": "~0.13.1" }, "funding": { - "url": "https://ko-fi.com/killymxi" + "url": "https://github.com/sponsors/KillyMXI" } }, - "node_modules/shebang-command": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", - "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", - "license": "MIT", - "dependencies": { - "shebang-regex": "^3.0.0" + "node_modules/semver": { + "version": "7.8.5", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz", + "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" }, "engines": { - "node": ">=8" - } - }, - "node_modules/shebang-regex": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", - "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", - "license": "MIT", - "engines": { - "node": ">=8" + "node": ">=10" } }, "node_modules/signal-exit": { @@ -2120,16 +3029,16 @@ } }, "node_modules/slice-ansi": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-5.0.0.tgz", - "integrity": "sha512-FC+lgizVPfie0kkhqUScwRu1O/lF6NOgJmlCgK+/LYxDCTk8sGelYaHDhFcDN+Sn3Cv+3VSa4Byeo+IMCzpMgQ==", + "version": "9.0.0", + "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-9.0.0.tgz", + "integrity": "sha512-SO/3iYL5S3W57LLEniscOGPZgOqZUPCx6d3dB+52B80yJ0XstzsC/eV8gnA4tM3MHDrKz+OCFSLNjswdSC+/bA==", "license": "MIT", "dependencies": { - "ansi-styles": "^6.0.0", - "is-fullwidth-code-point": "^4.0.0" + "ansi-styles": "^6.2.3", + "is-fullwidth-code-point": "^5.1.0" }, "engines": { - "node": ">=12" + "node": ">=22" }, "funding": { "url": "https://github.com/chalk/slice-ansi?sponsor=1" @@ -2174,16 +3083,27 @@ "url": "https://github.com/chalk/strip-ansi?sponsor=1" } }, - "node_modules/to-regex-range": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", - "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "node_modules/tagged-tag": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/tagged-tag/-/tagged-tag-1.0.0.tgz", + "integrity": "sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng==", + "dev": true, "license": "MIT", - "dependencies": { - "is-number": "^7.0.0" + "engines": { + "node": ">=20" }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/tinyexec": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.2.4.tgz", + "integrity": "sha512-SHf/r48b7vOrjve9PxJo3MN5v5yuyjHvdUcrQffT3WXMUfnGmHDVbC4k3sHJaJTgZCwpUplIaAo5ANtMyp3YHg==", + "dev": true, + "license": "MIT", "engines": { - "node": ">=8.0" + "node": ">=18" } }, "node_modules/tr46": { @@ -2192,12 +3112,6 @@ "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==", "license": "MIT" }, - "node_modules/tslib": { - "version": "2.8.1", - "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", - "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", - "license": "0BSD" - }, "node_modules/tsx": { "version": "4.23.0", "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.23.0.tgz", @@ -2218,31 +3132,62 @@ } }, "node_modules/type-fest": { - "version": "3.13.0", - "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-3.13.0.tgz", - "integrity": "sha512-Gur3yQGM9qiLNs0KPP7LPgeRbio2QTt4xXouobMCarR0/wyW3F+F/+OWwshg3NG0Adon7uQfSZBpB46NfhoF1A==", + "version": "5.8.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-5.8.0.tgz", + "integrity": "sha512-YGYEVz3Fm5iy/AybuA0oyNFq7H4CgQNfRp/qfe8nurE1kuCeNm3/vfm9X4Mtl+qLyaKJUh5xrFZwogr41SMjYA==", "dev": true, "license": "(MIT OR CC0-1.0)", + "dependencies": { + "tagged-tag": "^1.0.0" + }, "engines": { - "node": ">=14.16" + "node": ">=20" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/typescript": { - "version": "5.1.6", - "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.1.6.tgz", - "integrity": "sha512-zaWCozRZ6DLEWAWFrVDz1H6FVXzUSfTy5FUMWsQlU8Ym5JP9eO4xkTIROFCQvhQf61z6O/G6ugw3SgAnvvm+HA==", + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-7.0.2.tgz", + "integrity": "sha512-8FYau96o3NKOhbjKi/qNvG/W5jhzxkbdm5sj9AbZ/5T5sWqn3hJgLfGx27sRKZWTvyzCP8dLRBTf5tBTSRVUNA==", "dev": true, "license": "Apache-2.0", "bin": { - "tsc": "bin/tsc", - "tsserver": "bin/tsserver" + "tsc": "bin/tsc" }, "engines": { - "node": ">=14.17" - } + "node": ">=16.20.0" + }, + "optionalDependencies": { + "@typescript/typescript-aix-ppc64": "7.0.2", + "@typescript/typescript-darwin-arm64": "7.0.2", + "@typescript/typescript-darwin-x64": "7.0.2", + "@typescript/typescript-freebsd-arm64": "7.0.2", + "@typescript/typescript-freebsd-x64": "7.0.2", + "@typescript/typescript-linux-arm": "7.0.2", + "@typescript/typescript-linux-arm64": "7.0.2", + "@typescript/typescript-linux-loong64": "7.0.2", + "@typescript/typescript-linux-mips64el": "7.0.2", + "@typescript/typescript-linux-ppc64": "7.0.2", + "@typescript/typescript-linux-riscv64": "7.0.2", + "@typescript/typescript-linux-s390x": "7.0.2", + "@typescript/typescript-linux-x64": "7.0.2", + "@typescript/typescript-netbsd-arm64": "7.0.2", + "@typescript/typescript-netbsd-x64": "7.0.2", + "@typescript/typescript-openbsd-arm64": "7.0.2", + "@typescript/typescript-openbsd-x64": "7.0.2", + "@typescript/typescript-sunos-x64": "7.0.2", + "@typescript/typescript-win32-arm64": "7.0.2", + "@typescript/typescript-win32-x64": "7.0.2" + } + }, + "node_modules/undici-types": { + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-8.3.0.tgz", + "integrity": "sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ==", + "devOptional": true, + "license": "MIT" }, "node_modules/universalify": { "version": "2.0.1", @@ -2254,13 +3199,25 @@ } }, "node_modules/uuid": { - "version": "9.0.0", - "resolved": "https://registry.npmjs.org/uuid/-/uuid-9.0.0.tgz", - "integrity": "sha512-MXcSTerfPa4uqyzStbRoTgt5XIe3x5+42+q1sDuy3R5MDk66URdLMOZe5aPX/SQd+kuYAh0FdP/pO28IkQyTeg==", - "deprecated": "uuid@10 and below is no longer supported. For ESM codebases, update to uuid@latest. For CommonJS codebases, use uuid@11 (but be aware this version will likely be deprecated in 2028).", + "version": "14.0.1", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-14.0.1.tgz", + "integrity": "sha512-6ZxzVpzDXDa3bJWaHilVayA+BH/1zmxCJoVgvmqJnid/gPoKHxUrS/aC/T6LGQtNHT+XHG9fXPJB4d+IrU30Ew==", + "funding": [ + "https://github.com/sponsors/broofa", + "https://github.com/sponsors/ctavan" + ], "license": "MIT", "bin": { - "uuid": "dist/bin/uuid" + "uuid": "dist-node/bin/uuid" + } + }, + "node_modules/validator": { + "version": "13.15.35", + "resolved": "https://registry.npmjs.org/validator/-/validator-13.15.35.tgz", + "integrity": "sha512-TQ5pAGhd5whStmqWvYF4OjQROlmv9SMFVt37qoCBdqRffuuklWYQlCNnEs2ZaIBD1kZRNnikiZOS1eqgkar0iw==", + "license": "MIT", + "engines": { + "node": ">= 0.10" } }, "node_modules/webidl-conversions": { @@ -2279,21 +3236,6 @@ "webidl-conversions": "^3.0.0" } }, - "node_modules/which": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", - "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", - "license": "ISC", - "dependencies": { - "isexe": "^2.0.0" - }, - "bin": { - "node-which": "bin/node-which" - }, - "engines": { - "node": ">= 8" - } - }, "node_modules/widest-line": { "version": "5.0.0", "resolved": "https://registry.npmjs.org/widest-line/-/widest-line-5.0.0.tgz", @@ -2326,6 +3268,44 @@ "url": "https://github.com/chalk/wrap-ansi?sponsor=1" } }, + "node_modules/y18n": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", + "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yargs": { + "version": "18.0.0", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-18.0.0.tgz", + "integrity": "sha512-4UEqdc2RYGHZc7Doyqkrqiln3p9X2DZVxaGbwhn2pi7MrRagKaOcIKe8L3OxYcbhXLgLFUS3zAYuQjKBQgmuNg==", + "dev": true, + "license": "MIT", + "dependencies": { + "cliui": "^9.0.1", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "string-width": "^7.2.0", + "y18n": "^5.0.5", + "yargs-parser": "^22.0.0" + }, + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=23" + } + }, + "node_modules/yargs-parser": { + "version": "22.0.0", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-22.0.0.tgz", + "integrity": "sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==", + "dev": true, + "license": "ISC", + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=23" + } + }, "node_modules/yocto-spinner": { "version": "1.2.1", "resolved": "https://registry.npmjs.org/yocto-spinner/-/yocto-spinner-1.2.1.tgz", diff --git a/package.json b/package.json index dab5caf..4b3dbad 100644 --- a/package.json +++ b/package.json @@ -1,8 +1,11 @@ { "name": "@fusionauth/cli", - "version": "1.9.0", + "version": "1.9.1", "description": "FusionAuth CLI", "main": "dist/index.js", + "engines": { + "node": ">=22.22.0" + }, "files": [ "dist", "resources/*" @@ -12,10 +15,11 @@ "copy-files": "cp -r ./src/resources/ ./dist/commands/resources/", "prepublishOnly": "npm run build", "postinstall": "test -f dist/postinstall.js && node dist/postinstall.js || true", - "start": "node --import=tsx src/index.ts", - "test": "NODE_ENV=test node --import=tsx --test __tests__/postInstall/postinstall.test.js __tests__/telemetry/telemetry.test.js __tests__/utilities/kickstart/validator.test.js __tests__/utilities/kickstart/variable-substitution.test.js __tests__/integration/apply/apply.integration.test.js", - "test:integration": "NODE_ENV=test node --import=tsx --test __tests__/integration/apply/apply.integration.test.js", - "test:unit": "NODE_ENV=test node --import=tsx --test __tests__/postInstall/postinstall.test.js __tests__/telemetry/telemetry.test.js __tests__/utilities/kickstart/validator.test.js __tests__/utilities/kickstart/variable-substitution.test.js" + "start": "npm run build && node dist/index.js", + "test": "npm run test:unit && npm run test:integration", + "test:integration": "NODE_ENV=test FUSIONAUTH_TELEMETRY=false node --import=tsx --test --test-concurrency=1 '__tests__/integration/**/*.test.js'", + "test:unit": "NODE_ENV=test FUSIONAUTH_TELEMETRY=false node --import=tsx --test __tests__/utils.test.js '__tests__/postInstall/*.test.js' '__tests__/telemetry/*.test.js' '__tests__/utilities/**/*.test.js' '__tests__/commands/*.test.js'", + "prepare": "husky" }, "keywords": [ "fusionauth", @@ -34,45 +38,50 @@ }, "homepage": "https://github.com/FusionAuth/fusionauth-node-cli#readme", "dependencies": { - "@comandeer/cli-spinner": "^1.0.2", - "@commander-js/extra-typings": "11.0.0", - "@faker-js/faker": "^8.4.1", - "@fusionauth/typescript-client": "1.47.0", + "@commander-js/extra-typings": "15.0.0", + "@faker-js/faker": "^10.5.0", + "@fusionauth/typescript-client": "1.68.0", "bcryptjs": "^3.0.3", "boxen": "^8.0.1", - "chalk": "5.3.0", - "chokidar": "3.5.3", - "command-exists": "^1.2.9", - "commander": "11.0.0", + "chalk": "5.6.2", + "chokidar": "5.0.0", + "commander": "15.0.0", "dotenv": "^17.4.2", - "figlet": "1.6.0", - "fs-extra": "11.1.1", - "html-to-text": "9.0.5", - "inquirer": "^13.3.0", - "log-symbols": "5.1.0", - "log-update": "5.0.1", + "figlet": "1.11.0", + "fs-extra": "11.3.6", + "html-to-text": "10.0.0", + "inquirer": "^14.0.2", + "log-symbols": "7.0.1", + "log-update": "8.0.0", "merge": "2.1.1", - "posthog-node": "^5.21.2", + "posthog-node": "^5.40.0", "queue": "7.0.0", - "remove-undefined-objects": "3.0.0", - "uuid": "9.0.0", - "yocto-spinner": "^1.1.0" + "remove-undefined-objects": "9.0.0", + "uuid": "14.0.1", + "validator": "^13.15.35", + "yocto-spinner": "^1.2.1" }, "devDependencies": { - "@types/figlet": "1.5.6", - "@types/fs-extra": "11.0.1", - "@types/html-to-text": "9.0.1", - "@types/mock-fs": "^4.13.4", - "@types/node": "20.4.5", - "@types/uuid": "9.0.2", - "tsx": "^4.19.4", - "mock-fs": "^5.5.0", - "nock": "^14.0.15", - "type-fest": "3.13.0", - "typescript": "5.1.6" + "@commitlint/cli": "21.2.1", + "@commitlint/config-conventional": "21.2.0", + "@types/figlet": "1.7.0", + "@types/fs-extra": "11.0.4", + "@types/html-to-text": "9.0.4", + "@types/node": "26.1.1", + "@types/validator": "^13.15.10", + "husky": "^9.1.7", + "nock": "^14.0.16", + "tsx": "^4.23.0", + "type-fest": "5.8.0", + "typescript": "7.0.2" }, "bin": { "fusionauth": "dist/index.js" }, + "commitlint": { + "extends": [ + "@commitlint/config-conventional" + ] + }, "type": "module" } diff --git a/release.config.cjs b/release.config.cjs new file mode 100644 index 0000000..477c946 --- /dev/null +++ b/release.config.cjs @@ -0,0 +1,32 @@ +module.exports = { + branches: [ + 'main', + { + name: 'next', + prerelease: true + }, + { + name: 'next-setup', + prerelease: true + } + ], + plugins: [ + '@semantic-release/commit-analyzer', + '@semantic-release/release-notes-generator', + [ + '@semantic-release/changelog', + { + changelogFile: 'CHANGELOG.md' + } + ], + '@semantic-release/npm', + '@semantic-release/github', + [ + '@semantic-release/git', + { + assets: ['CHANGELOG.md'], + message: 'chore(release): set `package.json` to ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}' + } + ] + ] +} \ No newline at end of file diff --git a/src/commands/application-create.ts b/src/commands/application-create.ts new file mode 100644 index 0000000..d5afbd4 --- /dev/null +++ b/src/commands/application-create.ts @@ -0,0 +1,502 @@ +import * as fs from 'node:fs'; +import {Command, Option} from '@commander-js/extra-typings'; +import boxen from 'boxen'; +import { + Application, + ClientAuthenticationPolicy, + CORSConfiguration, + FusionAuthClient, + GrantType, + ProofKeyForCodeExchangePolicy, + RefreshTokenExpirationPolicy, + RefreshTokenUsagePolicy, +} from '@fusionauth/typescript-client'; +import chalk from 'chalk'; +import {confirmOrExit, logEvent} from '../utils.js'; +import {apiKeyOption, hostOption} from '../options.js'; +import * as utils from '../utils.js'; + +type Profile = 'spa' | 'native' | 'webapp'; + +export interface ApplicationCreateOptions { + name?: string; + profile?: string; + redirectUri?: string[]; + logoutUrl?: string; + authorizedOriginUrl?: string[]; + applicationId?: string; + tenantId?: string; + data?: string; + yes?: boolean; + key: string; + host: string; +} + +export interface ApplicationCreateResult { + success: boolean; + error?: string; + rawError?: unknown; + applicationId?: string; + clientId?: string; + clientSecret?: string; + name?: string; +} + +// Shared refresh token policy (usage + expiration) across all profiles. A +// sliding window of one-time-use refresh tokens is the recommended default +// for spa/native/webapp. This does not include timeToLiveInSeconds — that's +// the access token (JWT) lifetime, set separately per profile below in +// jwtConfiguration, not part of the refresh token policy itself. +const defaultRefreshTokenPolicy = { + refreshTokenUsagePolicy: RefreshTokenUsagePolicy.OneTimeUse, + refreshTokenExpirationPolicy: RefreshTokenExpirationPolicy.SlidingWindow, +}; + +// requireRegistration: true means a user must have a registration for this +// application before they can complete the authorization_code/implicit grant. +// registrationConfiguration.enabled is intentionally left false (self-service +// registration is off), so registrations must be created out-of-band — e.g. +// via the Registration API — before a user can log in. See the "Create users" +// Next Steps link printed after a successful create. +function buildPublicClientDefaults(): Application { + return { + oauthConfiguration: { + enabledGrants: [GrantType.authorization_code, GrantType.refresh_token], + generateRefreshTokens: true, + proofKeyForCodeExchangePolicy: ProofKeyForCodeExchangePolicy.Required, + clientAuthenticationPolicy: ClientAuthenticationPolicy.NotRequired, + requireClientAuthentication: false, + requireRegistration: true, + }, + jwtConfiguration: { + enabled: true, + timeToLiveInSeconds: 300, + ...defaultRefreshTokenPolicy, + }, + }; +} + +const profileDefaults: Record = { + spa: buildPublicClientDefaults(), + native: buildPublicClientDefaults(), + webapp: { + oauthConfiguration: { + enabledGrants: [GrantType.authorization_code, GrantType.refresh_token], + generateRefreshTokens: true, + proofKeyForCodeExchangePolicy: ProofKeyForCodeExchangePolicy.NotRequiredWhenUsingClientAuthentication, + clientAuthenticationPolicy: ClientAuthenticationPolicy.Required, + requireClientAuthentication: true, + // See comment on buildPublicClientDefaults() above re: requireRegistration. + requireRegistration: true, + }, + jwtConfiguration: { + enabled: true, + timeToLiveInSeconds: 3600, + ...defaultRefreshTokenPolicy, + }, + }, +}; + +// Headers a spa app needs the browser to allow through CORS: 'dpop' and +// 'Authorization' for DPoP-bound bearer tokens, and 'Accept'/'Content-Type' +// because JSON request/response bodies are not CORS-safelisted by default +// (unlike e.g. application/x-www-form-urlencoded) — without 'Content-Type' +// here, a SPA sending `Content-Type: application/json` would still fail +// preflight even after this command reports CORS as configured. +const REQUIRED_CORS_HEADERS = ['dpop', 'Authorization', 'Accept', 'Content-Type']; + +/** + * Wraps an unknown error with additional context while preserving the + * original value (e.g. a FusionAuth `ClientResponse` rejection, which + * carries structured `fieldErrors`/`generalErrors`) as `.cause`, so callers + * further up the stack can still access it for rich reporting instead of + * only the flattened message string. + */ +function wrapError(message: string, cause: unknown): Error { + const error = new Error(message); + (error as Error & {cause?: unknown}).cause = cause; + return error; +} + +/** + * Unwraps an error produced by wrapError() back to its original cause, for + * use as ApplicationCreateResult.rawError — which exists specifically to + * carry structured detail (e.g. FusionAuth's fieldErrors/generalErrors) + * beyond the plain message already captured in ApplicationCreateResult.error. + * + * Returns undefined for a direct, never-wrapped Error (e.g. parseData()'s + * validation errors) — its message is already the `error` string, so + * returning the same Error object again as rawError would make + * errorAndExit()/reportError() print that message a second time. Only a + * genuinely-wrapped error's distinct .cause, or a rejection that was never + * an Error at all (e.g. a raw ClientResponse-shaped object thrown without + * wrapError()), is preserved — both can carry detail worth reporting. + */ +function unwrapError(e: unknown): unknown { + if (e instanceof Error) { + return 'cause' in e && e.cause !== undefined ? e.cause : undefined; + } + return e; +} + +/** + * Ensures that the required CORS headers (see REQUIRED_CORS_HEADERS) — and, + * when authorizedOrigins is non-empty, those origins — are present in the + * FusionAuth system configuration. Also enables CORS if it is currently + * disabled. Should be called for the spa profile before creating the + * application. + * + * Enabling CORS and allowing the right headers is not sufficient on its + * own: FusionAuth's CORS allowlist (corsConfiguration.allowedOrigins) is a + * separate, independent setting, and browsers will still block cross-origin + * requests from the spa app's own origin unless it's present there (or + * allowedOrigins is "*"). --authorized-origin-url is the only source of + * that origin available to this command, so it's reused here in addition + * to populating application.oauthConfiguration.authorizedOriginURLs. + * + * CORS only applies to browser-based requests, so this is only relevant + * for the spa profile — native apps don't go through a browser's CORS + * enforcement at all, so this should not be called for native. If this + * call fails the entire command is aborted — no application will be + * created. + * + * This mutates system-wide configuration, so it is gated behind + * confirmOrExit()/--yes and only prompts when a change is actually needed. + * + * Note: /api/system-configuration does not accept a tenant ID. The tenant + * header is cleared for these calls and restored afterward. + */ +async function ensureCorsHeaders(client: FusionAuthClient, yes: boolean, authorizedOrigins: string[]): Promise { + const originalTenantId = client.tenantId ?? null; + client.setTenantId(null); + + try { + let retrieveResponse; + try { + retrieveResponse = await client.retrieveSystemConfiguration(); + } catch (e: unknown) { + throw wrapError('Error retrieving system configuration', e); + } + + const systemConfig = retrieveResponse.response.systemConfiguration!; + const cors: CORSConfiguration = systemConfig.corsConfiguration ?? {}; + const existing: string[] = cors.allowedHeaders ?? []; + const existingLower = existing.map((h) => h.toLowerCase()); + + const missing = REQUIRED_CORS_HEADERS.filter( + (h) => !existingLower.includes(h.toLowerCase()) + ); + + // Origins are case-sensitive, unlike header names, and "*" already + // permits every origin — nothing to add in that case. Dedupe the + // supplied origins first — authorizedOrigins is only ever compared + // against the pre-existing allowlist below, so a duplicate within + // authorizedOrigins itself (e.g. --authorized-origin-url passed the + // same URL twice) would otherwise pass that filter twice and write + // a duplicate entry into the system-wide CORS configuration. + const existingOrigins: string[] = cors.allowedOrigins ?? []; + const dedupedAuthorizedOrigins = [...new Set(authorizedOrigins)]; + const missingOrigins = existingOrigins.includes('*') + ? [] + : dedupedAuthorizedOrigins.filter((o) => !existingOrigins.includes(o)); + + const needsEnable = cors.enabled !== true; + + if (missing.length === 0 && missingOrigins.length === 0 && !needsEnable) { + return; + } + + const changes = [ + ...(needsEnable ? ['enable CORS'] : []), + ...(missing.length > 0 ? [`add CORS header(s): ${missing.join(', ')}`] : []), + ...(missingOrigins.length > 0 ? [`add CORS allowed origin(s): ${missingOrigins.join(', ')}`] : []), + ].join(' and '); + + await confirmOrExit( + `This will modify your FusionAuth system configuration to ${changes}. ` + + 'This may allow cross-domain requests that were previously blocked.', + yes + ); + + try { + await client.patchSystemConfiguration({ + systemConfiguration: { + corsConfiguration: { + ...cors, + enabled: true, + allowedHeaders: [...existing, ...missing], + ...(missingOrigins.length > 0 + ? {allowedOrigins: [...existingOrigins, ...missingOrigins]} + : {}), + }, + }, + }); + + if (missing.length > 0) { + console.log(` CORS headers added: ${missing.join(', ')}`); + } + if (missingOrigins.length > 0) { + console.log(` CORS allowed origins added: ${missingOrigins.join(', ')}`); + } + } catch (e: unknown) { + throw wrapError('Error updating CORS configuration', e); + } + } finally { + client.setTenantId(originalTenantId); + } +} + +/** + * Parses the --data value. If it begins with '@', reads the referenced file. + * Otherwise parses the value as inline JSON. + * Throws an Error on parse, file-read, or shape failure (caught by + * executeApplicationCreate). "Shape failure" means the parsed JSON is valid + * but isn't a non-null, non-array object — e.g. `--data 'null'` or + * `--data '[1,2,3]'` would otherwise be cast to Application unchecked, + * surfacing as a confusing downstream TypeError (null) or a nonsensical + * API payload (array/primitive) instead of a clear validation error here. + */ +function parseData(data: string): Application { + let json: string; + if (data.startsWith('@')) { + const filePath = data.slice(1); + try { + json = fs.readFileSync(filePath, 'utf-8'); + } catch (e: unknown) { + const message = e instanceof Error ? e.message : String(e); + throw new Error(`Error reading --data file "${filePath}": ${message}`); + } + } else { + json = data; + } + let parsed: unknown; + try { + parsed = JSON.parse(json); + } catch (e: unknown) { + const message = e instanceof Error ? e.message : String(e); + throw new Error(`Error parsing --data JSON: ${message}`); + } + if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) { + throw new Error( + `--data JSON must be a non-null, non-array object, got ${Array.isArray(parsed) ? 'an array' : parsed === null ? 'null' : typeof parsed}.` + ); + } + return parsed as Application; +} + +/** + * Core logic for application:create. Returns a result object on every + * validation/API failure it detects itself, rather than calling + * process.exit() directly — this is what allows tests to import and invoke + * it, and non-CLI callers to handle failures programmatically. + * + * One exception: for the spa profile, this calls ensureCorsHeaders(), + * which calls confirmOrExit() to gate a system-wide CORS mutation per this + * project's Risky Operations convention (see kickstart-kill.ts for the + * same pattern elsewhere). confirmOrExit() does call process.exit() for a + * non-interactive caller without yes=true, or an interactive caller who + * declines — so a direct (non-CLI) caller in that situation will still see + * the process terminate rather than a returned result. Pass yes: true to + * avoid this when calling programmatically in a non-interactive context. + */ +export async function executeApplicationCreate(options: ApplicationCreateOptions): Promise { + const { + name, + profile, + redirectUri, + logoutUrl, + authorizedOriginUrl, + applicationId, + tenantId, + data, + yes, + key: apiKey, + host, + } = options; + + try { + await logEvent('cli command application:create'); + + // --- Mode validation --- + if (profile && data) { + return { success: false, error: '--profile and --data are mutually exclusive. Provide one or the other.' }; + } + if (!profile && !data) { + return { success: false, error: 'Either --profile or --data is required.' }; + } + + let application: Application; + + if (profile) { + // --- Profile mode --- + if (redirectUri === undefined || redirectUri.length === 0) { + return { success: false, error: '--redirect-uri is required when using --profile.' }; + } + if (!name) { + return { success: false, error: '--name is required when using --profile.' }; + } + if (!Object.keys(profileDefaults).includes(profile)) { + return { success: false, error: `--profile must be one of: ${Object.keys(profileDefaults).join(', ')}.` }; + } + + const defaults = profileDefaults[profile as Profile]; + application = {...defaults}; + application.name = name; + application.oauthConfiguration = { + ...application.oauthConfiguration, + authorizedRedirectURLs: redirectUri, + ...(logoutUrl ? {logoutURL: logoutUrl} : {}), + ...(authorizedOriginUrl && authorizedOriginUrl.length > 0 + ? {authorizedOriginURLs: authorizedOriginUrl} + : {}), + }; + } else { + // --- Custom mode --- + // --data provides "full custom control": the JSON is the source of + // truth, and --name/--redirect-uri/--logout-url/--authorized-origin-url + // are all optional overrides that only take effect if explicitly + // passed, leaving the JSON's own values untouched otherwise. This + // mirrors the --application-id/--tenant-id override pattern below, + // which applies unconditionally in both modes. + application = parseData(data!); + if (name) { + application.name = name; + } + if (redirectUri && redirectUri.length > 0) { + application.oauthConfiguration = { + ...application.oauthConfiguration, + authorizedRedirectURLs: redirectUri, + }; + } + if (logoutUrl) { + application.oauthConfiguration = { + ...application.oauthConfiguration, + logoutURL: logoutUrl, + }; + } + if (authorizedOriginUrl && authorizedOriginUrl.length > 0) { + application.oauthConfiguration = { + ...application.oauthConfiguration, + authorizedOriginURLs: authorizedOriginUrl, + }; + } + // Note: unlike --profile mode, this does not call ensureCorsHeaders() + // — --data mode never mutates system-wide CORS configuration, since + // "full custom control" means the caller owns their own + // infrastructure config, not just the application body. + } + + // --- ID overrides (applied last in both modes) --- + if (applicationId) { + application.id = applicationId; + } + if (tenantId) { + application.tenantId = tenantId; + } + + const fusionAuthClient = new FusionAuthClient(apiKey, host, tenantId); + + // For the spa profile, enforce DPoP-required CORS headers (and + // allowed origins, when provided) first. If this fails (or the user + // declines the confirmation prompt), the command aborts — + // createApplication is never called. Native apps don't go through + // a browser's CORS enforcement, so this is intentionally skipped + // for --profile native. + if (profile === 'spa') { + await ensureCorsHeaders(fusionAuthClient, yes ?? false, authorizedOriginUrl ?? []); + } + + let clientResponse; + try { + clientResponse = await fusionAuthClient.createApplication( + application.id ?? '', + {application} + ); + } catch (e: unknown) { + throw wrapError('Error creating application', e); + } + + const created = clientResponse.response.application!; + // clientId intentionally mirrors applicationId here: FusionAuth does not + // allow oauthConfiguration.clientId to be set via the API (it's only + // ever returned, never accepted as input), so for applications created + // by this command the two values are always identical. + const clientId = created.oauthConfiguration?.clientId ?? created.id ?? ''; + const clientSecret = created.oauthConfiguration?.clientSecret; + + return { + success: true, + applicationId: created.id, + clientId, + clientSecret, + name: created.name, + }; + + } catch (e: unknown) { + const message = e instanceof Error ? e.message : String(e); + return { success: false, error: message, rawError: unwrapError(e) }; + } +} + +/** + * CLI action wrapper — calls executeApplicationCreate and handles output/exit. + */ +const action = async function (options: ApplicationCreateOptions) { + utils.betaWarning(); + + const result = await executeApplicationCreate(options); + + if (!result.success) { + utils.errorAndExit(result.error ?? 'Error creating application.', result.rawError); + return; + } + + console.log(); + console.log(chalk.green('Application created.')); + console.log(` Name: ${result.name}`); + console.log(` Application ID / client_id: ${result.clientId}`); + if (result.clientSecret) { + console.log(` Client Secret: ${result.clientSecret}`); + } + + console.log(); + console.log(boxen( + [ + `Customize FusionAuth with a ${chalk.cyan('simple theme')}:`, + ' https://fusionauth.io/docs/customize/look-and-feel/simple-theme-editor', + '', + `Create ${chalk.cyan('users')}:`, + ' https://fusionauth.io/docs/lifecycle/register-users/', + '', + `Configure an ${chalk.cyan('SMTP server')}:`, + ' https://fusionauth.io/docs/customize/email-and-messages/configure-email', + '', + `Set up ${chalk.cyan('email templates')}:`, + ' https://fusionauth.io/docs/customize/email-and-messages/email-templates', + '', + `${chalk.cyan('Add login')} to your application:`, + ' https://fusionauth.io/docs/get-started/start-here/step-1', + '', + ].join('\n'), + {padding: 1, title: 'Next Steps', borderColor: 'green', borderStyle: 'bold'} + )); +}; + +// noinspection JSUnusedGlobalSymbols +export const applicationCreate = new Command('application:create') + .description('Create an application in FusionAuth') + .option('--name ', 'The name of the application (required with --profile; overrides the name in --data if provided)') + .addOption( + new Option('--profile ', 'Security profile to apply (mutually exclusive with --data)') + .choices(['spa', 'native', 'webapp'] as const) + ) + .option('--redirect-uri ', 'Authorized redirect URIs (required with --profile)') + .option('--logout-url ', 'Post-logout redirect URL') + .option('--authorized-origin-url ', 'Authorized origin URLs for the application; also added to the system CORS allowlist for --profile spa') + .option('--data ', 'Full application config as inline JSON or @file.json (mutually exclusive with --profile)') + .option('--application-id ', 'Application UUID (auto-generated if omitted; overrides --data)') + .option('--tenant-id ', 'Tenant UUID (overrides --data)') + .option('--yes', 'Skip confirmation prompt for automatic CORS configuration changes (spa profile)', false) + .addOption(apiKeyOption) + .addOption(hostOption) + .action(action); diff --git a/src/commands/application/get.ts b/src/commands/application/get.ts new file mode 100644 index 0000000..2334824 --- /dev/null +++ b/src/commands/application/get.ts @@ -0,0 +1,79 @@ +import { Command } from "@commander-js/extra-typings"; +import { __dirname, logEvent, errorAndExit, betaWarning } from '../../utils.js' +import { apiKeyOption, hostOption } from '../../options.js'; +import path from "node:path"; +import { writeFileSync } from "node:fs"; +import chalk from "chalk"; +import { FusionAuthClient } from '@fusionauth/typescript-client'; + + +export async function executeGet(id: string, options: Record) { + logEvent("cli application:get") + const { + host = 'http://localhost:9011', + key, + output + } = options + + if (!host || !key) throw new Error("You must provide a FusionAuth host and an API key") + try { + const fusionAuthClient = new FusionAuthClient(key, host); + const res = await fusionAuthClient.retrieveApplication(id) + if (output) { + const fullPath = path.resolve(output); + await writeFileSync(fullPath, JSON.stringify(res.response, null, 2)) + return { + success: true, + fullPath + } + } else { + return { + success: true, + data: res.response + } + } + + } catch (e: any) { + if (e.statusCode === 404) return { + success: false, + error: "Application does not exist", + rawError: e + } + + return { + success: false, + error: `The server responded with an error: ${e.statusCode}`, + rawError: e + } + } +} + + +const action = async function (id: string, options: Record): Promise { + betaWarning(); + logEvent('cli application:get') + + const result = await executeGet(id, options) + + if (!result?.success) { + errorAndExit(result?.error ?? "An error ocurred while fetching the response."); + return; + } + if (result.fullPath) { + console.log(chalk.green(`Response written to `) + result.fullPath) + return + } + if (result.data) { + console.log(result.data) + } + +} + +export const appGet = new Command() + .command('application:get') + .argument('', "The FusionAuth Application ID to retrieve") + .option('-o, --output ', "Path where the data should be stored") + .addOption(hostOption) + .addOption(apiKeyOption) + .description('Retrieves an application by id, writing its data to a local file') + .action(action) diff --git a/src/commands/application/index.ts b/src/commands/application/index.ts new file mode 100644 index 0000000..e2004a3 --- /dev/null +++ b/src/commands/application/index.ts @@ -0,0 +1,2 @@ +export * from "./update.js"; +export * from "./get.js" \ No newline at end of file diff --git a/src/commands/application/update.ts b/src/commands/application/update.ts new file mode 100644 index 0000000..458c88e --- /dev/null +++ b/src/commands/application/update.ts @@ -0,0 +1,153 @@ +import { Command } from "@commander-js/extra-typings"; +import { __dirname, betaWarning, errorAndExit, logEvent } from '../../utils.js' +import { apiKeyOption, hostOption } from '../../options.js'; +import path from "node:path"; +import { readFileSync } from "node:fs"; +import chalk from "chalk"; +import { FusionAuthClient } from '@fusionauth/typescript-client'; +import fs from "node:fs" + +function parseData(data: string) { + let json: string; + if (data.startsWith('@')) { + const filePath = data.slice(1); + try { + json = fs.readFileSync(filePath, 'utf-8'); + } catch (e: unknown) { + const message = e instanceof Error ? e.message : String(e); + throw new Error(`Error reading --data file "${filePath}": ${message}`); + } + } else { + json = data; + } + let parsed: unknown; + try { + parsed = JSON.parse(json); + } catch (e: unknown) { + const message = e instanceof Error ? e.message : String(e); + throw new Error(`Error parsing --data JSON: ${message}`); + } + if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) { + throw new Error( + `--data JSON must be a non-null, non-array object, got ${Array.isArray(parsed) ? 'an array' : parsed === null ? 'null' : typeof parsed}.` + ); + } + return parsed; +} + + + +export function setNestedProps(obj: any, path: string, value: any) { + /* Takes object and dynamically applies a property at any depth + myprop.somedepth.key = "value" coverts to {myprop: {somedepth: {key: value}}} + */ + let schema = obj; + const pList = path.split('.'); + const len = pList.length; + for (var i = 0; i < len - 1; i++) { + var elem = pList[i]; + if (!schema[elem]) schema[elem] = {} + schema = schema[elem]; + } + + schema[pList[len - 1]] = value; + + return schema +} + + +function displaySuccess(message: string = "Successfully submitted Application update") { + console.log(chalk.green(message)) +} + +export function isJSON(string: string) { + try { + JSON.parse(string) + return true + } catch (e) { + return false + } +} + +export function splitProp(prop: string) { + try { + const [key, ...value] = prop.split("=") + const joinedValue = value.join("=") + if (isJSON(joinedValue)) { + return { key, value: JSON.parse(joinedValue) } + } + return { key, value: joinedValue } + } catch (e: any) { + throw new Error(e) + } +} + +export const executeUpdateAction = async function (id: string, options: Record) { + const { + host = 'http://localhost:9011', + key + } = options + const fusionAuthClient = new FusionAuthClient(key, host); + + try { + logEvent('cli application:update') + + if (!options.data && !options.prop) throw new Error("No --prop or --data was specified") + if (options?.data) { + + const data = await parseData(options.data) + const { response } = await fusionAuthClient.patchApplication(id, data) + return { + success: true, + patchData: data, + response + } + } + if (options?.prop) { + let data = { application: {} } + const splitprops = options.prop.map((prop: string) => { + if (!prop.includes('=')) throw new Error("Property string must be in the syntax =") + return splitProp(prop) + }) + splitprops.forEach((prop: any) => setNestedProps(data.application, prop.key, prop.value)) + const { response } = await fusionAuthClient.patchApplication(id, data) + return { + success: true, + patchData: data, + response + } + } + + } catch (e: any) { + if (e.statusCode === 404) throw new Error(`Application with ID ${id} does not exist`) + + const message = e instanceof Error ? e.message : String(e); + return { success: false, error: message, rawError: e }; + } +} + +const action = async (id: string, options: Record) => { + betaWarning() + const result = await executeUpdateAction(id, options) + if (!result?.success) { + errorAndExit(result?.error ?? 'Error updating application.', result?.rawError); + return; + } + displaySuccess(`Applied the following patch\n${JSON.stringify(result.patchData, null, 2)}`) + +} + +function customArrayParser(value:string, previous:any=[]) { + return previous.concat(value); + +} + +export const appUpdate = new Command() + .command('application:update') + .argument('', "The FusionAuth Application ID to update") + .option('--data ', "Full application config as inline JSON or @file.json") + .option('-p, --prop ', 'Updates a single property from the application --prop name="My New Name" or --prop oauthConfiguration.authorizedOriginURLs="http://localhost:9011" ', customArrayParser) + .addOption(hostOption) + .addOption(apiKeyOption) + .description('Updates an application with data provided via a file, a property, or a command flag.') + .action(action) diff --git a/src/commands/check-oauth-2-1.ts b/src/commands/check-oauth-2-1.ts new file mode 100644 index 0000000..6565931 --- /dev/null +++ b/src/commands/check-oauth-2-1.ts @@ -0,0 +1,826 @@ +import {Command, Option} from "@commander-js/extra-typings"; +import { + Application, + FusionAuthClient, + GrantType, + Oauth2AuthorizedURLValidationPolicy, + ProofKeyForCodeExchangePolicy, + ReactorFeatureStatus, + RefreshTokenUsagePolicy, + Tenant, +} from '@fusionauth/typescript-client'; +import chalk from "chalk"; +import {errorAndExit, logEvent} from '../utils.js'; +import {apiKeyOption, hostOption} from "../options.js"; + +// -- Types ------------------------------------------------------------------- + +type CheckSeverity = 'required' | 'warning'; + +interface CheckResult { + name: string; + passed: boolean; + severity: CheckSeverity; + message: string; + details?: string[]; + specSection?: string; + specUrl?: string; +} + +interface AppCheckContext { + app: Application; + appName: string; + appId: string; +} + +interface JsonOutput { + compliant: boolean; + tenantsChecked: number; + applicationsChecked: number; + applicationsSkipped: number; + filters: { + tenantId: string | null; + applicationId: string | null; + }; + checks: Record; + criticalIssues: string[]; + warnings: string[]; + educationalLinks: Record; +} + +// -- Options ----------------------------------------------------------------- + +const applicationIdOption = new Option( + '--application-id ', + 'Check a specific application only' +); + +const tenantIdOption = new Option( + '--tenant-id ', + 'Check all applications in a specific tenant' +); + +const strictOption = new Option( + '--strict', + 'Fail if deprecated grants (Implicit or Password) are enabled' +).default(false); + +const jsonOption = new Option( + '--json', + 'Output results as JSON' +).default(false); + +const verboseOption = new Option( + '--verbose', + 'Show detailed per-application breakdown' +).default(false); + +// -- Helpers ----------------------------------------------------------------- + +const SPEC_BASE = 'https://datatracker.ietf.org/doc/html/draft-ietf-oauth-v2-1-15'; + +/** Well-known fixed ID of the FusionAuth admin UI application. */ +const FUSIONAUTH_APP_ID = '3c219e58-ed0e-4b18-ad48-f4f92793ae32'; + +/** Immutable role ID for the Tenant Manager 'admin' role. */ +const TENANT_MANAGER_ADMIN_ROLE_ID = '631ecd9d-8d40-4c13-8277-80cedb823714'; + +function specUrl(section: string): string { + return `${SPEC_BASE}#section-${section}`; +} + +function isLocalhostUri(uri: string): boolean { + try { + const url = new URL(uri); + return url.hostname === 'localhost' || url.hostname === '127.0.0.1' || url.hostname === '::1'; + } catch { + return false; + } +} + +/** + * Detect built-in FusionAuth applications that are not under the developer's + * control and should be excluded from all OAuth 2.1 checks. + * + * - FusionAuth admin UI: identified by its fixed well-known application ID. + * - Tenant Manager: identified by the combination of being a universal + * application, having a single redirect of "/tenant-manager", and containing + * a role with the immutable ID 631ecd9d-8d40-4c13-8277-80cedb823714 named + * "admin". + */ +function isBuiltInApplication(app: Application): boolean { + // FusionAuth admin UI + if (app.id === FUSIONAUTH_APP_ID) { + return true; + } + + // Tenant Manager — universal application with specific redirect and role + if (app.universalConfiguration?.universal !== true) { + return false; + } + + const redirects = app.oauthConfiguration?.authorizedRedirectURLs || []; + if (redirects.length !== 1 || redirects[0] !== '/tenant-manager') { + return false; + } + + const hasAdminRole = app.roles?.some( + r => r.id === TENANT_MANAGER_ADMIN_ROLE_ID && r.name === 'admin' + ) ?? false; + + return hasAdminRole; +} + +function shouldCheckApplication(app: Application): boolean { + if (isBuiltInApplication(app)) { + return false; + } + const grants = app.oauthConfiguration?.enabledGrants || []; + return grants.includes(GrantType.authorization_code) && grants.includes(GrantType.refresh_token); +} + +function getAppName(app: Application): string { + return app.name || 'Unnamed Application'; +} + +function getAppId(app: Application): string { + return app.id || 'unknown'; +} + +// -- Individual Checks ------------------------------------------------------- + +function checkPkce(ctx: AppCheckContext): CheckResult | null { + const policy = ctx.app.oauthConfiguration?.proofKeyForCodeExchangePolicy; + if (policy === ProofKeyForCodeExchangePolicy.Required) { + return null; // pass + } + return { + name: 'pkce', + passed: false, + severity: 'required', + message: `Application "${ctx.appName}" (${ctx.appId}): PKCE policy is "${policy || 'not set'}" (must be "Required")`, + specSection: '7.5', + specUrl: specUrl('7.5'), + }; +} + +function checkRedirectUriValidation(ctx: AppCheckContext): CheckResult | null { + const policy = ctx.app.oauthConfiguration?.authorizedURLValidationPolicy; + if (policy === Oauth2AuthorizedURLValidationPolicy.ExactMatch) { + return null; // pass + } + return { + name: 'redirectUriValidation', + passed: false, + severity: 'required', + message: `Application "${ctx.appName}" (${ctx.appId}): Redirect URI validation is "${policy || 'not set'}" (must be "ExactMatch")`, + specSection: '4.1.3', + specUrl: specUrl('4.1.3'), + }; +} + +function checkHttpsEnforcement(ctx: AppCheckContext): CheckResult[] { + const redirectUris = ctx.app.oauthConfiguration?.authorizedRedirectURLs || []; + const failures: CheckResult[] = []; + + for (const uri of redirectUris) { + if (uri.startsWith('https://')) { + continue; + } + if (isLocalhostUri(uri)) { + continue; + } + failures.push({ + name: 'httpsEnforcement', + passed: false, + severity: 'required', + message: `Application "${ctx.appName}" (${ctx.appId}): Non-HTTPS redirect URI: ${uri}`, + specSection: '1.5', + specUrl: specUrl('1.5'), + }); + } + return failures; +} + +function checkRefreshTokenRotation(ctx: AppCheckContext): CheckResult | null { + const policy = ctx.app.jwtConfiguration?.refreshTokenUsagePolicy; + if (policy === RefreshTokenUsagePolicy.OneTimeUse) { + return null; // pass + } + return { + name: 'refreshTokenRotation', + passed: false, + severity: 'required', + message: `Application "${ctx.appName}" (${ctx.appId}): Refresh token usage policy is "${policy || 'not set'}" (must be "OneTimeUse")`, + specSection: '4.3', + specUrl: specUrl('4.3'), + }; +} + +function checkDeprecatedGrants(ctx: AppCheckContext, strict: boolean): CheckResult[] { + const grants = ctx.app.oauthConfiguration?.enabledGrants || []; + const failures: CheckResult[] = []; + const severity: CheckSeverity = strict ? 'required' : 'warning'; + + if (grants.includes(GrantType.implicit)) { + failures.push({ + name: 'deprecatedGrants', + passed: false, + severity, + message: `Application "${ctx.appName}" (${ctx.appId}): Implicit grant is enabled (removed in OAuth 2.1)`, + specSection: '10.1', + specUrl: specUrl('10.1'), + }); + } + if (grants.includes(GrantType.password)) { + failures.push({ + name: 'deprecatedGrants', + passed: false, + severity, + message: `Application "${ctx.appName}" (${ctx.appId}): Password grant is enabled (removed in OAuth 2.1)`, + specSection: '10', + specUrl: specUrl('10'), + }); + } + return failures; +} + +/** + * DPoP is an instance-level capability, not a per-application setting. + * FusionAuth automatically handles DPoP when the client initiates a DPoP flow + * — there is no server-side toggle to enable it. The only prerequisite is an + * Enterprise license. + * + * See: https://fusionauth.io/docs/lifecycle/authenticate-users/oauth/dpop + */ +function checkDpop(dpopFeatureActive: boolean): CheckResult | null { + if (!dpopFeatureActive) { + return { + name: 'dpop', + passed: false, + severity: 'warning', + message: 'DPoP unavailable: Enterprise license required. DPoP sender-constrains tokens to the client that requested them (§1.4.3).', + details: [ + 'DPoP requires no server-side configuration — FusionAuth handles it automatically when the client initiates a DPoP flow.', + 'However, an Enterprise license is required for this feature.', + 'See: https://fusionauth.io/docs/lifecycle/authenticate-users/oauth/dpop', + ], + specSection: '1.4.3', + specUrl: specUrl('1.4.3'), + }; + } + return null; // pass — DPoP is available, clients can use it at will +} + +function checkTenantIssuer(tenant: Tenant): CheckResult | null { + const issuer = tenant.issuer || ''; + const tenantName = tenant.name || 'Unnamed Tenant'; + const tenantId = tenant.id || 'unknown'; + + if (issuer && issuer !== 'acme.com') { + return null; // pass + } + + const reason = issuer === 'acme.com' + ? 'still set to default "acme.com"' + : 'not configured'; + + return { + name: 'tenantIssuer', + passed: false, + severity: 'required', + message: `Tenant "${tenantName}" (${tenantId}): Issuer ${reason} (must be set to your domain)`, + }; +} + +function checkRefreshTokenRevocationOnReuse(tenant: Tenant): CheckResult | null { + const tenantName = tenant.name || 'Unnamed Tenant'; + const tenantId = tenant.id || 'unknown'; + + // onOneTimeTokenReuse is now properly typed in the v1.64.0 client. + const onReuse = tenant.jwtConfiguration?.refreshTokenRevocationPolicy?.onOneTimeTokenReuse === true; + + if (onReuse) { + return null; // pass + } + + return { + name: 'refreshTokenRevocationOnReuse', + passed: false, + severity: 'required', + message: `Tenant "${tenantName}" (${tenantId}): Refresh token revocation on one-time token reuse is not enabled`, + details: [ + 'Set tenant.jwtConfiguration.refreshTokenRevocationPolicy.onOneTimeTokenReuse = true', + 'This detects token theft when a one-time use refresh token is replayed.', + ], + specSection: '4.3', + specUrl: specUrl('4.3'), + }; +} + +function checkAuthCodeLifetime(tenant: Tenant): CheckResult | null { + const tenantName = tenant.name || 'Unnamed Tenant'; + const tenantId = tenant.id || 'unknown'; + const ttl = tenant.externalIdentifierConfiguration?.authorizationGrantIdTimeToLiveInSeconds; + + if (ttl === undefined || ttl === null) { + return null; // can't check, skip + } + + if (ttl <= 600) { + return null; // pass + } + + return { + name: 'authCodeLifetime', + passed: false, + severity: 'warning', + message: `Tenant "${tenantName}" (${tenantId}): Authorization code lifetime is ${ttl} seconds (recommend <= 600)`, + specSection: '7.5', + specUrl: specUrl('7.5'), + }; +} + +// -- Main Action ------------------------------------------------------------- + +const action = async function (options: { + key: string; + host: string; + applicationId?: string; + tenantId?: string; + strict: boolean; + json: boolean; + verbose: boolean; +}) { + logEvent('cli command check:oauth-2-1') + const {key: apiKey, host, applicationId, tenantId, strict, json: jsonOutput, verbose} = options; + + if (!jsonOutput) { + console.log(chalk.blue(`Checking OAuth 2.1 compliance on ${host}...`)); + console.log(chalk.blue(`Reference: draft-ietf-oauth-v2-1-15\n`)); + } + + const results: CheckResult[] = []; + + try { + const client = new FusionAuthClient(apiKey, host); + + // -- Fetch data ------------------------------------------------------ + + // Reactor status (for DPoP check — DPoP requires Enterprise license) + let dpopFeatureActive: boolean | undefined; + let dpopStatusError: unknown; + try { + const reactorResponse = await client.retrieveReactorStatus(); + if (reactorResponse.wasSuccessful()) { + dpopFeatureActive = reactorResponse.response.status?.dPoP === ReactorFeatureStatus.ACTIVE; + } else { + dpopFeatureActive = undefined; + } + } catch (e: unknown) { + dpopFeatureActive = undefined; + dpopStatusError = e; + } + + if (dpopFeatureActive === undefined && verbose && !jsonOutput) { + const errorDetail = dpopStatusError instanceof Error + ? `: ${dpopStatusError.message}` + : dpopStatusError + ? `: ${String(dpopStatusError)}` + : ''; + console.warn(chalk.yellow(`Warning: Unable to determine DPoP Reactor status${errorDetail}. DPoP availability is unknown.`)); + } + // Tenants + const tenantResponse = await client.retrieveTenants(); + if (!tenantResponse.wasSuccessful() || !tenantResponse.response.tenants) { + errorAndExit('Failed to retrieve tenants.'); + return; + } + + let tenants = tenantResponse.response.tenants; + if (tenantId) { + tenants = tenants.filter(t => t.id === tenantId); + if (tenants.length === 0) { + errorAndExit(`Tenant with ID "${tenantId}" not found.`); + return; + } + } + + // Applications + let allApps: Application[] = []; + if (applicationId) { + const appResponse = await client.retrieveApplication(applicationId); + if (!appResponse.wasSuccessful() || !appResponse.response.application) { + errorAndExit(`Application with ID "${applicationId}" not found.`); + return; + } + allApps = [appResponse.response.application]; + + // Validate the application belongs to the specified tenant + if (tenantId && allApps[0].tenantId !== tenantId) { + errorAndExit(`Application "${allApps[0].name || applicationId}" belongs to tenant "${allApps[0].tenantId}", not the specified tenant "${tenantId}".`); + return; + } + + // Narrow tenant-level checks to just this application's tenant + if (!tenantId) { + tenants = tenants.filter(t => t.id === allApps[0].tenantId); + } + } else { + const appsResponse = await client.retrieveApplications(); + if (!appsResponse.wasSuccessful() || !appsResponse.response.applications) { + errorAndExit('Failed to retrieve applications.'); + return; + } + allApps = appsResponse.response.applications; + } + + // Filter applications by tenant if needed + if (tenantId && !applicationId) { + allApps = allApps.filter(app => app.tenantId === tenantId); + } + + // Separate into checked and skipped in a single pass + const appsToCheck: Application[] = []; + const skippedApps: Application[] = []; + for (const app of allApps) { + if (shouldCheckApplication(app)) { + appsToCheck.push(app); + } else { + skippedApps.push(app); + } + } + + if (!jsonOutput) { + console.log(chalk.cyan(`Tenants checked: ${tenants.length}`)); + console.log(chalk.cyan(`Applications checked: ${appsToCheck.length}${tenantId ? ' (in selected tenant)' : applicationId ? '' : ' (across all tenants)'}`)); + console.log(chalk.cyan(`Applications skipped: ${skippedApps.length} (built-in FusionAuth apps or not using authorization_code + refresh_token grants)\n`)); + } + + if (appsToCheck.length === 0) { + if (applicationId) { + // The user explicitly requested this app but it was filtered out + const app = allApps[0]; + if (app && isBuiltInApplication(app)) { + if (!jsonOutput) { + console.log(chalk.yellow(`Application "${app.name || applicationId}" is a built-in FusionAuth application and is excluded from OAuth 2.1 checks.`)); + } + } else { + const grants = app?.oauthConfiguration?.enabledGrants || []; + if (!jsonOutput) { + console.log(chalk.yellow(`Application "${app?.name || applicationId}" does not use both authorization_code and refresh_token grants.`)); + console.log(chalk.yellow(`Enabled grants: ${grants.length > 0 ? grants.join(', ') : 'none'}`)); + } + } + } else { + if (!jsonOutput) { + console.log(chalk.yellow('No applications found using both authorization_code and refresh_token grants.')); + console.log(chalk.yellow('Nothing to check for OAuth 2.1 compliance.')); + } + } + } + + // -- Tenant-level checks --------------------------------------------- + + for (const tenant of tenants) { + const issuerResult = checkTenantIssuer(tenant); + if (issuerResult) results.push(issuerResult); + + const revocationResult = checkRefreshTokenRevocationOnReuse(tenant); + if (revocationResult) results.push(revocationResult); + + const authCodeResult = checkAuthCodeLifetime(tenant); + if (authCodeResult) results.push(authCodeResult); + } + + // -- Instance-level checks ------------------------------------------- + + const dpopResult = checkDpop(dpopFeatureActive ?? false); + if (dpopResult) results.push(dpopResult); + + // -- Application-level checks ---------------------------------------- + + for (const app of appsToCheck) { + const ctx: AppCheckContext = { + app, + appName: getAppName(app), + appId: getAppId(app), + }; + + if (verbose && !jsonOutput) { + console.log(chalk.cyan(`\nApplication: "${ctx.appName}" (${ctx.appId})`)); + } + + // Required checks + const pkceResult = checkPkce(ctx); + if (pkceResult) results.push(pkceResult); + if (verbose && !jsonOutput) { + console.log(pkceResult + ? chalk.red(` ✗ PKCE: ${ctx.app.oauthConfiguration?.proofKeyForCodeExchangePolicy || 'not set'}`) + : chalk.green(` ✓ PKCE: Required`)); + } + + const redirectResult = checkRedirectUriValidation(ctx); + if (redirectResult) results.push(redirectResult); + if (verbose && !jsonOutput) { + console.log(redirectResult + ? chalk.red(` ✗ Redirect URI validation: ${ctx.app.oauthConfiguration?.authorizedURLValidationPolicy || 'not set'}`) + : chalk.green(` ✓ Redirect URI validation: ExactMatch`)); + } + + const httpsResults = checkHttpsEnforcement(ctx); + results.push(...httpsResults); + if (verbose && !jsonOutput) { + if (httpsResults.length > 0) { + for (const r of httpsResults) { + console.log(chalk.red(` ✗ ${r.message}`)); + } + } else { + console.log(chalk.green(` ✓ HTTPS enforcement: All redirect URIs valid`)); + } + } + + const rotationResult = checkRefreshTokenRotation(ctx); + if (rotationResult) results.push(rotationResult); + if (verbose && !jsonOutput) { + console.log(rotationResult + ? chalk.red(` ✗ Refresh token rotation: ${ctx.app.jwtConfiguration?.refreshTokenUsagePolicy || 'not set'}`) + : chalk.green(` ✓ Refresh token rotation: OneTimeUse`)); + } + + // Warning checks + const deprecatedResults = checkDeprecatedGrants(ctx, strict); + results.push(...deprecatedResults); + if (verbose && !jsonOutput) { + if (deprecatedResults.length > 0) { + for (const r of deprecatedResults) { + const icon = strict ? '✗' : '⚠'; + const color = strict ? chalk.red : chalk.yellow; + console.log(color(` ${icon} ${r.message}`)); + } + } else { + console.log(chalk.green(` ✓ No deprecated grants enabled`)); + } + } + } + + // -- Aggregate results ----------------------------------------------- + + const criticalFailures = results.filter(r => r.severity === 'required' && !r.passed); + const warnings = results.filter(r => r.severity === 'warning' && !r.passed); + const allRequiredPassed = criticalFailures.length === 0; + + // -- Summary by check name ------------------------------------------- + + const pkceTotal = appsToCheck.length; + const pkcePass = pkceTotal - results.filter(r => r.name === 'pkce').length; + + const redirectTotal = appsToCheck.length; + const redirectPass = redirectTotal - results.filter(r => r.name === 'redirectUriValidation').length; + + const httpsFailCount = results.filter(r => r.name === 'httpsEnforcement').length; + + const rotationTotal = appsToCheck.length; + const rotationPass = rotationTotal - results.filter(r => r.name === 'refreshTokenRotation').length; + + const revocationFailCount = results.filter(r => r.name === 'refreshTokenRevocationOnReuse').length; + + const issuerFailCount = results.filter(r => r.name === 'tenantIssuer').length; + + const dpopAvailable = dpopResult === null; + + const authCodeFailCount = results.filter(r => r.name === 'authCodeLifetime').length; + + const deprecatedFailCount = results.filter(r => r.name === 'deprecatedGrants').length; + + // -- Output ---------------------------------------------------------- + + if (jsonOutput) { + const output: JsonOutput = { + compliant: allRequiredPassed, + tenantsChecked: tenants.length, + applicationsChecked: appsToCheck.length, + applicationsSkipped: skippedApps.length, + filters: { + tenantId: tenantId || null, + applicationId: applicationId || null, + }, + checks: {}, + criticalIssues: criticalFailures.map(r => r.message), + warnings: warnings.map(r => r.message), + educationalLinks: { + 'oauth21Spec': SPEC_BASE, + 'pkce': specUrl('7.5'), + 'redirectUri': specUrl('4.1.3'), + 'https': specUrl('1.5'), + 'senderConstrainedTokens': specUrl('1.4.3'), + 'refreshTokenSecurity': specUrl('4.3'), + 'deprecatedGrants': specUrl('10'), + 'fusionAuthOAuthConfig': 'https://fusionauth.io/docs/apis/applications', + 'fusionAuthTenantConfig': 'https://fusionauth.io/docs/apis/tenants', + 'fusionAuthDPoP': 'https://fusionauth.io/docs/lifecycle/authenticate-users/oauth/dpop', + }, + }; + + // Add individual check results + output.checks['pkce'] = { + severity: 'required', + passed: pkcePass === pkceTotal, + message: pkcePass === pkceTotal + ? `All applications require PKCE (${pkcePass}/${pkceTotal})` + : `${pkceTotal - pkcePass} application(s) do not require PKCE (${pkcePass}/${pkceTotal} compliant)`, + specSection: '7.5', + specUrl: specUrl('7.5'), + }; + output.checks['redirectUriValidation'] = { + severity: 'required', + passed: redirectPass === redirectTotal, + message: redirectPass === redirectTotal + ? `All applications use exact match redirect URI validation (${redirectPass}/${redirectTotal})` + : `${redirectTotal - redirectPass} application(s) allow wildcard redirect URIs (${redirectPass}/${redirectTotal} compliant)`, + specSection: '4.1.3', + specUrl: specUrl('4.1.3'), + }; + output.checks['httpsEnforcement'] = { + severity: 'required', + passed: httpsFailCount === 0, + message: httpsFailCount === 0 + ? 'All redirect URIs use HTTPS (or localhost)' + : `${httpsFailCount} non-HTTPS redirect URI(s) found`, + details: results.filter(r => r.name === 'httpsEnforcement').map(r => r.message), + specSection: '1.5', + specUrl: specUrl('1.5'), + }; + output.checks['refreshTokenRotation'] = { + severity: 'required', + passed: rotationPass === rotationTotal, + message: rotationPass === rotationTotal + ? `All applications use one-time use refresh tokens (${rotationPass}/${rotationTotal})` + : `${rotationTotal - rotationPass} application(s) do not use one-time use refresh tokens (${rotationPass}/${rotationTotal} compliant)`, + specSection: '4.3', + specUrl: specUrl('4.3'), + }; + output.checks['refreshTokenRevocationOnReuse'] = { + severity: 'required', + passed: revocationFailCount === 0, + message: revocationFailCount === 0 + ? 'All tenants have refresh token revocation on reuse enabled' + : `${revocationFailCount} tenant(s) do not have refresh token revocation on reuse enabled`, + specSection: '4.3', + specUrl: specUrl('4.3'), + }; + output.checks['tenantIssuer'] = { + severity: 'required', + passed: issuerFailCount === 0, + message: issuerFailCount === 0 + ? `All tenant issuers properly configured (${tenants.length}/${tenants.length})` + : `${issuerFailCount} tenant(s) have improperly configured issuers`, + }; + output.checks['dpop'] = { + severity: 'warning', + passed: dpopAvailable, + message: dpopAvailable + ? 'DPoP available (Enterprise license active). Clients can initiate DPoP flows — no server-side configuration needed.' + : 'DPoP unavailable (Enterprise license required). Sender-constrained tokens are recommended by OAuth 2.1 §1.4.3.', + specSection: '1.4.3', + specUrl: specUrl('1.4.3'), + }; + output.checks['authCodeLifetime'] = { + severity: 'warning', + passed: authCodeFailCount === 0, + message: authCodeFailCount === 0 + ? 'Authorization code lifetime within recommended range' + : `${authCodeFailCount} tenant(s) have authorization code lifetime exceeding 600 seconds`, + specSection: '7.5', + specUrl: specUrl('7.5'), + }; + output.checks['deprecatedGrants'] = { + severity: strict ? 'required' : 'warning', + passed: deprecatedFailCount === 0, + message: deprecatedFailCount === 0 + ? 'No deprecated grants enabled' + : `${deprecatedFailCount} deprecated grant(s) found`, + details: results.filter(r => r.name === 'deprecatedGrants').map(r => r.message), + specSection: '10', + specUrl: specUrl('10'), + }; + + console.log(JSON.stringify(output, null, 2)); + } else { + // Human-readable output + if (!verbose) { + // Summary lines + console.log(pkcePass === pkceTotal + ? chalk.green(`✓ PKCE enforcement: Required (${pkcePass}/${pkceTotal} applications)`) + : chalk.red(`✗ PKCE enforcement: ${pkceTotal - pkcePass}/${pkceTotal} applications not compliant`)); + + console.log(redirectPass === redirectTotal + ? chalk.green(`✓ Redirect URI validation: ExactMatch (${redirectPass}/${redirectTotal} applications)`) + : chalk.red(`✗ Redirect URI validation: ${redirectTotal - redirectPass}/${redirectTotal} applications using wildcards`)); + + console.log(httpsFailCount === 0 + ? chalk.green(`✓ HTTPS enforcement: All redirect URIs valid`) + : chalk.red(`✗ HTTPS enforcement: ${httpsFailCount} non-HTTPS redirect URI(s) found`)); + + console.log(rotationPass === rotationTotal + ? chalk.green(`✓ Refresh token rotation: OneTimeUse (${rotationPass}/${rotationTotal} applications)`) + : chalk.red(`✗ Refresh token rotation: ${rotationTotal - rotationPass}/${rotationTotal} applications not using OneTimeUse`)); + + console.log(revocationFailCount === 0 + ? chalk.green(`✓ Refresh token revocation on reuse: Enabled (${tenants.length}/${tenants.length} tenants)`) + : chalk.red(`✗ Refresh token revocation on reuse: Disabled on ${revocationFailCount} tenant(s)`)); + + console.log(issuerFailCount === 0 + ? chalk.green(`✓ Tenant issuer: Properly configured (${tenants.length}/${tenants.length} tenants)`) + : chalk.red(`✗ Tenant issuer: ${issuerFailCount} tenant(s) not properly configured`)); + + console.log(dpopAvailable + ? chalk.green(`✓ DPoP (sender-constrained tokens): Available (Enterprise license active)`) + : chalk.yellow(`⚠ DPoP (sender-constrained tokens): Unavailable (Enterprise license required)`)); + + console.log(authCodeFailCount === 0 + ? chalk.green(`✓ Authorization code lifetime: Within recommended range`) + : chalk.yellow(`⚠ Authorization code lifetime: ${authCodeFailCount} tenant(s) exceed 600 seconds`)); + + const deprecatedIcon = strict ? '✗' : '⚠'; + const deprecatedColor = strict ? chalk.red : chalk.yellow; + console.log(deprecatedFailCount === 0 + ? chalk.green(`✓ Deprecated grants: None enabled`) + : deprecatedColor(`${deprecatedIcon} Deprecated grants: ${deprecatedFailCount} deprecated grant(s) found${strict ? '' : ' (use --strict to fail)'}`)); + } + + // Final summary + console.log(chalk.blue('\n=== OAuth 2.1 Compliance Summary ===\n')); + + if (allRequiredPassed) { + console.log(chalk.green.bold('SUCCESS: Your FusionAuth instance meets OAuth 2.1 requirements.')); + if (warnings.length > 0) { + console.log(chalk.yellow(`\nWarnings (RECOMMENDED):`)); + for (const w of warnings) { + console.log(chalk.yellow(` - ${w.message}`)); + } + } + } else { + console.log(chalk.red.bold('FAILED: Your FusionAuth instance is NOT OAuth 2.1 compliant.\n')); + + console.log(chalk.red('Critical issues (MUST FIX):')); + for (const f of criticalFailures) { + console.log(chalk.red(` - ${f.message}`)); + if (f.details) { + for (const d of f.details) { + console.log(chalk.red(` ${d}`)); + } + } + } + + if (warnings.length > 0) { + console.log(chalk.yellow('\nWarnings (RECOMMENDED):')); + for (const w of warnings) { + console.log(chalk.yellow(` - ${w.message}`)); + } + } + } + + // Educational links + console.log(chalk.blue('\nFor more information:')); + console.log(chalk.cyan(` - OAuth 2.1 Specification: ${SPEC_BASE}`)); + console.log(chalk.cyan(` - PKCE (Section 7.5): ${specUrl('7.5')}`)); + console.log(chalk.cyan(` - Redirect URI (Section 4.1.3): ${specUrl('4.1.3')}`)); + console.log(chalk.cyan(` - HTTPS (Section 1.5): ${specUrl('1.5')}`)); + console.log(chalk.cyan(` - Sender-Constrained Tokens (Section 1.4.3): ${specUrl('1.4.3')}`)); + console.log(chalk.cyan(` - Refresh Token Security (Section 4.3): ${specUrl('4.3')}`)); + console.log(chalk.cyan(` - Deprecated Grants (Section 10): ${specUrl('10')}`)); + console.log(chalk.cyan(` - FusionAuth OAuth Configuration: https://fusionauth.io/docs/apis/applications`)); + console.log(chalk.cyan(` - FusionAuth Tenant Configuration: https://fusionauth.io/docs/apis/tenants`)); + console.log(chalk.cyan(` - FusionAuth DPoP: https://fusionauth.io/docs/lifecycle/authenticate-users/oauth/dpop`)); + } + + if (!allRequiredPassed) { + process.exit(1); + } + + } catch (e: unknown) { + errorAndExit('OAuth 2.1 compliance check error:', e); + } +} + +// -- Command ----------------------------------------------------------------- + +// noinspection JSUnusedGlobalSymbols +export const checkOAuth21 = new Command('check:oauth-2-1') + .description('Checks FusionAuth configuration for OAuth 2.1 compliance (draft-ietf-oauth-v2-1-15)') + .addOption(apiKeyOption) + .addOption(hostOption) + .addOption(applicationIdOption) + .addOption(tenantIdOption) + .addOption(strictOption) + .addOption(jsonOption) + .addOption(verboseOption) + .action(action); diff --git a/src/commands/email-upload.ts b/src/commands/email-upload.ts index c745107..9aefd48 100644 --- a/src/commands/email-upload.ts +++ b/src/commands/email-upload.ts @@ -94,7 +94,7 @@ export const emailUpload = new Command('email:upload') } try { - const request: EmailTemplateRequest = {emailTemplate: removeUndefinedObjects.default(emailTemplate)}; + const request: EmailTemplateRequest = {emailTemplate: removeUndefinedObjects(emailTemplate)}; if (!templateExists) { await client.createEmailTemplate(templateId, request); } else if (overwrite) { diff --git a/src/commands/import-generate.ts b/src/commands/import-generate.ts index ab79e76..6c741d7 100644 --- a/src/commands/import-generate.ts +++ b/src/commands/import-generate.ts @@ -1,4 +1,4 @@ -import {Command} from '@commander-js/extra-typings'; +import {Command, Option} from '@commander-js/extra-typings'; import {FusionAuthClient} from '@fusionauth/typescript-client'; import {readFile} from 'fs/promises'; import chalk from 'chalk'; @@ -7,6 +7,31 @@ import {errorAndExit, logEvent} from '../utils.js'; import { faker } from '@faker-js/faker'; import * as fs from 'fs'; +export const DEPRECATED_FLAGS: Record = { + '--numberOfFiles': '--number-of-files', + '--countPerFile': '--count-per-file', + '--applicationId': '--application-id', + '--groupId': '--group-id', + '--tmpDir': '--tmp-dir', + '--filePrefix': '--file-prefix', +}; + +// Exported for testability — pure function, no I/O; returns [oldFlag, replacement] pairs found in argv. +export function getDeprecatedFlagUsage(argv: string[]): Array<[string, string]> { + return Object.entries(DEPRECATED_FLAGS).filter(([old]) => + argv.some((arg) => arg === old || arg.startsWith(`${old}=`)) + ); +} + +function warnDeprecatedFlags(argv: string[] = process.argv): void { + for (const [old, replacement] of getDeprecatedFlagUsage(argv)) { + console.warn(chalk.yellow( + `DEPRECATION WARNING: please use ${replacement} going forward. ` + + `${old} will be removed in a future release.` + )); + } +} + const action = async function ({numberOfFiles, countPerFile, applicationId, groupId, tmpDir, filePrefix} : { numberOfFiles?: string | undefined; @@ -17,6 +42,8 @@ const action = async function ({numberOfFiles, countPerFile, applicationId, grou filePrefix?: string | undefined; } ): Promise { + warnDeprecatedFlags(); + logEvent('cli command import:generate') console.log(`Generating users`); @@ -54,12 +81,19 @@ const action = async function ({numberOfFiles, countPerFile, applicationId, grou // noinspection JSUnusedGlobalSymbols export const importGenerate = new Command('import:generate') .description('Generate sample import data') - .option('-n, --numberOfFiles ', 'The number of files.') - .option('-c, --countPerFile ', 'The count of records per file.') - .option('-a, --applicationId ', 'The application to register users to.') - .option('-g, --groupId ', 'The group id to add users to.') - .option('-d, --tmpDir ', 'The directory to write files to.', 'tmp') - .option('-f, --filePrefix ', 'The file prefix for output files.', 'output') + .option('-n, --number-of-files ', 'The number of files.') + .option('-c, --count-per-file ', 'The count of records per file.') + .option('-a, --application-id ', 'The application to register users to.') + .option('-g, --group-id ', 'The group id to add users to.') + .option('-d, --tmp-dir ', 'The directory to write files to.', 'tmp') + .option('-f, --file-prefix ', 'The file prefix for output files.', 'output') + // Deprecated camelCase aliases — hidden from help, kept for backward compatibility + .addOption(new Option('--numberOfFiles ', 'Deprecated: use --number-of-files').hideHelp()) + .addOption(new Option('--countPerFile ', 'Deprecated: use --count-per-file').hideHelp()) + .addOption(new Option('--applicationId ', 'Deprecated: use --application-id').hideHelp()) + .addOption(new Option('--groupId ', 'Deprecated: use --group-id').hideHelp()) + .addOption(new Option('--tmpDir ', 'Deprecated: use --tmp-dir').hideHelp()) + .addOption(new Option('--filePrefix ', 'Deprecated: use --file-prefix').hideHelp()) .action(action); @@ -71,7 +105,7 @@ function generateData(numObjects: number, appId: string, groupId: string, startN birthDate: faker.date.past().toISOString().split('T')[0], data: { displayName: faker.person.firstName() + ' ' + faker.person.lastName(), - favoriteColors: [faker.internet.color(), faker.internet.color()] + favoriteColors: [faker.color.rgb(), faker.color.rgb()] }, email: `example${i + 1 + startNumber}@example.com`, encryptionScheme: 'salted-pbkdf2-hmac-sha256', @@ -103,7 +137,7 @@ function generateData(numObjects: number, appId: string, groupId: string, startN }, insertInstant: faker.date.past().getTime(), preferredLanguages: ['en_US'], - username: faker.internet.userName(), + username: faker.internet.username(), verified: faker.datatype.boolean() } ], diff --git a/src/commands/index.ts b/src/commands/index.ts index 07f0f21..3b9cc59 100644 --- a/src/commands/index.ts +++ b/src/commands/index.ts @@ -1,4 +1,7 @@ +export * from './application/index.js' +export * from './application-create.js'; export * from './check-common-config.js'; +export * from './check-oauth-2-1.js'; export * from './email-create.js'; export * from './email-download.js'; export * from './email-duplicate.js'; diff --git a/src/commands/kickstart-install.ts b/src/commands/kickstart-install.ts index 206797a..fa07ad9 100644 --- a/src/commands/kickstart-install.ts +++ b/src/commands/kickstart-install.ts @@ -8,32 +8,244 @@ import fs from 'node:fs' import path from "node:path"; import { dirname } from 'node:path'; import { fileURLToPath } from 'node:url'; -import { betaWarning, isDirEmpty, isDockerInstalled, logEvent } from "../utils.js"; +import { randomUUID } from 'node:crypto'; +import validator from 'validator'; +import { betaWarning, errorAndExit, isDirEmpty, isDockerInstalled, logEvent } from "../utils.js"; const __dirname = dirname(fileURLToPath(import.meta.url)); -async function createKickstart(kickstartPath: string, answers: any, newDir: string) { + +const BASIC_APP_KICKSTART_OBJ = { + "method": "POST", + "url": "/api/application/#{applicationId}", + "tenantId": "#{defaultTenantId}", + "body": { + "application": { + "name": "#{applicationName}", + "oauthConfiguration": { + "authorizedRedirectURLs": [ + "https://fusionauth.io" + ], + "logoutURL": "https://fusionauth.io", + "clientSecret": "#{clientSecret}", + "enabledGrants": [ + "authorization_code", + "refresh_token" + ], + "generateRefreshTokens": true, + "requireRegistration": true + }, + "jwtConfiguration": { + "enabled": true, + "accessTokenKeyId": "#{asymmetricKeyId}", + "idTokenKeyId": "#{asymmetricKeyId}" + } + } + } + } + + +/** + * Resolves the directory containing the kickstart resource files + * (fusionauth-config files, kickstart.json, etc.), supporting both layouts + * this file can run from: + * - Built (dist/): resources live beside the compiled command, at + * dist/commands/resources, via the build's copy-files step. + * - Source (src/, e.g. running this file directly via tsx during local + * development, independent of the npm start script): resources live one + * level up, at src/resources — they are not copied anywhere until a + * build runs. + * Throws if neither layout is found, rather than silently proceeding with + * a path that doesn't exist. + * + * @param baseDir Directory to resolve relative to. Defaults to this + * module's own directory (dist/commands or src/commands, depending on + * which was imported); overridable so tests can exercise all three + * outcomes (dist found / src fallback found / neither found) against + * controlled, synthetic directories instead of depending on the real + * repo's build state. + */ +export function resolveResourcesDir(baseDir: string = __dirname): string { + const distLayout = path.join(baseDir, 'resources'); + if (fs.existsSync(distLayout)) { + return distLayout; + } + const srcLayout = path.join(baseDir, '..', 'resources'); + if (fs.existsSync(srcLayout)) { + return srcLayout; + } + throw new Error(`Could not locate kickstart resources directory (checked ${distLayout} and ${srcLayout}).`); +} + +// --------------------------------------------------------------------------- +// Validation helpers (exported for testing) +// --------------------------------------------------------------------------- + +/** + * Validates an email address. + * @returns `true` if valid, otherwise an error message string. + */ +export function validateEmail(email: string): true | string { + return validator.isEmail(email) ? true : 'Not a valid email address'; +} + +/** + * Validates the admin password. + * @returns `true` if valid, otherwise an error message string. + */ +export function validatePassword(password: string): true | string { + if (password.length === 0) { + return 'Custom password is required'; + } + if (password.length < 8) { + return 'Password must be at least 8 characters (You can change this requirement later in your tenant password settings)'; + } + return true; +} + +// --------------------------------------------------------------------------- +// Answer resolution (exported for testing) +// --------------------------------------------------------------------------- + +export interface InstallOptions { + adminEmail?: string; + adminPasswordEnv?: string; + applicationName?: string; + barebones?: boolean +} + +export interface InstallAnswers { + email: string; + password: string; + appName?: string; + barebones?: boolean +} + +/** + * We need the initial admin's credentials (email and password) and a name for a + * starter app. This will take values from command line params if present, then + * fall back to prompting the user. + * + * If all values are supplied then no prompts are shown. This is useful for + * unattended or agent-driven installs. + * + * Note that the password param names an environment variable to get the password + * from. This is to protect the password from showing up in process lists or being + * written to command line history files. + * + * @param options CLI option values (any subset may be provided). + * @param promptFn Injected prompt function; defaults to `inquirer.prompt`. + * Pass a mock in tests to avoid real TTY interaction. + */ +export async function resolveInstallAnswers( + options: InstallOptions, + promptFn: typeof inquirer.prompt = inquirer.prompt +): Promise { + // --- Resolve email --- + let email: string | undefined; + if (options.adminEmail !== undefined) { + const result = validateEmail(options.adminEmail); + if (result !== true) { + throw new Error(`--admin-email: ${result}`); + } + email = options.adminEmail; + } + + // --- Resolve password --- + let password: string | undefined; + if (options.adminPasswordEnv !== undefined) { + const envValue = process.env[options.adminPasswordEnv]; + if (envValue === undefined) { + throw new Error( + `--admin-password-env: environment variable "${options.adminPasswordEnv}" is not set` + ); + } + const result = validatePassword(envValue); + if (result !== true) { + throw new Error(`--admin-password-env: ${result}`); + } + password = envValue; + } + + // --- Resolve appName --- + let appName: string | undefined = options.applicationName; + let barebones: boolean | undefined = options.barebones || false; + // --- Prompt for any fields not yet resolved --- + const questions: import('inquirer').DistinctQuestion[] = []; + + if (email === undefined) { + questions.push({ + type: 'input', + name: 'email', + message: 'Admin Email Address', + default: 'admin@example.com', + validate: validateEmail, + }); + } + + if (password === undefined) { + questions.push({ + type: 'password', + name: 'password', + message: 'Admin user password', + mask: true, + validate: validatePassword, + }); + } + + if (barebones == false && appName === undefined) { + questions.push({ + type: 'input', + name: 'appName', + message: 'Name your application', + default: 'Example App', + }); + } + + if (questions.length > 0) { + const prompted = await promptFn(questions); + if (email === undefined) email = prompted.email as string; + if (password === undefined) password = prompted.password as string; + if (appName === undefined) appName = prompted.appName as string || undefined; + } + + return { email: email!, password: password!, appName: appName!, barebones: barebones! }; +} + +// --------------------------------------------------------------------------- +// Kickstart file generation +// --------------------------------------------------------------------------- + +async function createKickstart(kickstartPath: string, answers: InstallAnswers, newDir: string) { const salt = bcrypt.genSaltSync(10) const saltBase = salt.split('$10$')[1]; const fullHash = bcrypt.hashSync(answers.password, salt) const hashedPassword = fullHash.split(salt)[1] const kickstartContent = fs.readFileSync(kickstartPath) - var kickstartObject = JSON.parse(kickstartContent.toString('utf-8')) + let kickstartObject = JSON.parse(kickstartContent.toString('utf-8')) kickstartObject.variables.adminEmail = answers.email; kickstartObject.variables.adminPassword = hashedPassword; kickstartObject.variables.applicationName = answers.appName; kickstartObject.variables.saltPassword = saltBase + if (!answers.barebones) { + kickstartObject.requests[1].body.users[0].registrations.push({"applicationId": "#{applicationId}"}) + kickstartObject.requests.splice(1, 0, BASIC_APP_KICKSTART_OBJ) + } fs.mkdirSync(`${newDir}/kickstart`) fs.writeFileSync(`${newDir}/kickstart/kickstart.json`, JSON.stringify(kickstartObject, null, 2)) } -const action = async function (dir: string) { +// --------------------------------------------------------------------------- +// Command action +// --------------------------------------------------------------------------- + +const action = async function (dir: string, options: InstallOptions) { const dockerInstalled = isDockerInstalled(); const directory = path.resolve(dir) logEvent('cli command kickstart:install') - + betaWarning() try { @@ -53,81 +265,59 @@ const action = async function (dir: string) { console.error(chalk.red(`Can't write to ${parentDir}. Please check permissions on the directory`)) } - inquirer.prompt([ - { - type: 'input', - name: 'email', - message: "Admin Email Address", - default: 'admin@example.com', - validate: function (email) { - return /(([^<>()[\]\\.,;:\s@\"]+(\.[^<>()[\]\\.,;:\s@\"]+)*)|(\".+\"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))/.test(email) ? true : 'Not a valid email address'; - } - }, - { - type: 'password', - name: 'password', - message: "Admin user password", - mask: true, - validate: (text) => { - if (text.length == 0) { - return 'Custom password is required' - } else if (text.length < 8) { - return 'Password must be at least 8 characters (You can change this requirement later in your tenant password settings)' - } else { - return true - } - } - }, - { - type: 'input', - name: 'appName', - message: 'Name your application', - default: "Example App" - } - ]) - .then((answers) => { - const spinner = yoctoSpinner({ text: "Building..." }).start() - setTimeout(() => { - // move fusionauth folder to user's project - console.log(chalk.green(`\nTransferring files to ${dir}`)) - fs.cpSync(`${__dirname}/resources/kickstart/fusionauth`, directory, { recursive: true }) - }, 500) - setTimeout(() => { - console.log(chalk.green(`Creating Kickstart file`)) - if (!fs.existsSync(directory)) throw (chalk.red(`Something went wrong. ${directory} does not exists.`)) - createKickstart(__dirname + '/resources/kickstart/kickstart.json', answers, directory) - }, 1500) - - setTimeout(() => { - const postgresPass = crypto.randomUUID() - const dbPass = crypto.randomUUID() - - console.log(chalk.green(`Transferring environment variables`)) - fs.renameSync(`${directory}/.env.defaults`, `${directory}/.env`) - fs.appendFileSync(`${directory}/.env`, `\nPOSTGRES_PASSWORD=${postgresPass}\nDATABASE_PASSWORD=${dbPass}\nCLI_DIR=${directory}`) - }, 2500) + let answers: InstallAnswers; + try { + answers = await resolveInstallAnswers(options); + } catch (e: any) { + errorAndExit(e.message ?? String(e)); + return; + } - setTimeout(() => { - spinner.success("Done building!\n") + const spinner = yoctoSpinner({ text: "Building..." }).start() - console.log(boxen(`You're ready to start your Docker container\n${chalk.magenta(`Step 1:`)} cd ${dir}\n${chalk.magenta("Step 2: ")}npx fusionauth kickstart:start`, { padding: 1, title: "Next Steps", borderColor: "green", borderStyle: 'bold' })) + try { + // Sequential, awaited steps (rather than setTimeout-chained callbacks) so that: + // - exceptions propagate through the surrounding try/catch + // - step ordering is deterministic regardless of machine speed + const resourcesDir = resolveResourcesDir(); + console.log(chalk.green(`\nTransferring files to ${dir}`)) + fs.cpSync(`${resourcesDir}/kickstart/fusionauth`, directory, { recursive: true }) - }, 3500) + console.log(chalk.green(`Creating Kickstart file`)) + if (!fs.existsSync(directory)) throw (chalk.red(`Something went wrong. ${directory} does not exist.`)) + await createKickstart(resourcesDir + '/kickstart/kickstart.json', answers, directory) - }).catch((err) => { - console.error(chalk.yellow('Cancelling kickstart installation...')) - }) + const postgresPass = randomUUID() + const dbPass = randomUUID() + console.log(chalk.green(`Transferring environment variables`)) + fs.renameSync(`${directory}/.env.defaults`, `${directory}/.env`) + fs.appendFileSync(`${directory}/.env`, `\nPOSTGRES_PASSWORD=${postgresPass}\nDATABASE_PASSWORD=${dbPass}\nCLI_DIR=${directory}`) + spinner.success("Done building!\n") + console.log(boxen(`You're ready to start your Docker container\n${chalk.magenta(`Step 1:`)} cd ${dir}\n${chalk.magenta("Step 2: ")}npx fusionauth kickstart:start`, { padding: 1, title: "Next Steps", borderColor: "green", borderStyle: 'bold' })) + } catch (e) { + // Ensure the spinner's animation interval is stopped on every failure + // path — otherwise it keeps rendering (and can keep the process alive) + // even though the outer catch below has already taken over reporting. + spinner.error("Build failed.") + throw e + } } catch (e) { console.error(e) + // Ensure a failed install (copy, kickstart write, rename, env update, etc.) + // is reflected in the process exit code rather than silently exiting 0. + process.exitCode = 1 } - } export const kickstartInstall = new Command() .command('kickstart:install') .description('Adds a directory with a FusionAuth Docker + Kickstart') .argument('[dir]', 'Optional directory to install FusionAuth', 'fusionauth') - .action((dir) => action(dir)) \ No newline at end of file + .option('--admin-email ', 'Admin user email address (skips prompt)') + .option('--admin-password-env ', 'Name of environment variable containing the admin password (skips prompt)') + .option('--application-name ', 'Application name (skips prompt)') + .option('--barebones', 'Skips the creation of an application in the FusionAuth instance') + .action((dir, options) => action(dir, options)) diff --git a/src/commands/kickstart-kill.ts b/src/commands/kickstart-kill.ts index 11e4863..4474ba6 100644 --- a/src/commands/kickstart-kill.ts +++ b/src/commands/kickstart-kill.ts @@ -2,57 +2,53 @@ import { Command } from "@commander-js/extra-typings"; import chalk from "chalk"; import { spawn } from 'node:child_process'; -import { betaWarning, isDockerInstalled, logEvent } from "../utils.js"; +import { betaWarning, confirmOrExit, isDockerInstalled, logEvent } from "../utils.js"; import boxen from "boxen"; -import inquirer from "inquirer"; +// Dependencies below are injectable for testing — avoids real docker/confirm/exit calls +export interface KillDeps { + isDockerInstalled?: typeof isDockerInstalled; + confirmOrExit?: typeof confirmOrExit; + spawn?: typeof spawn; +} + +export const action = async function ({ yes }: { yes: boolean }, deps: KillDeps = {}) { + const checkDocker = deps.isDockerInstalled ?? isDockerInstalled; + const confirm = deps.confirmOrExit ?? confirmOrExit; + const spawnFn = deps.spawn ?? spawn; -const action = async function () { betaWarning(); try { - if (!isDockerInstalled()) throw (chalk.red('Error: You need Docker to run.')) - + if (!checkDocker()) throw (chalk.red('Error: You need Docker to run.')) + if (process.cwd() != process.env.CLI_DIR) throw(chalk.red('Error: Current directory was not kickstarted.')) logEvent('cli command kickstart:kill') - inquirer.prompt([ - { - type: 'confirm', - name: 'confirmation', - message: 'This is a destructive action. Are you sure you want to kill this container?' + await confirm( + "This will run 'docker compose down -v', destroying the container and all database data. This cannot be undone.", + yes + ); + console.log(chalk.yellow('Killing FusionAuth...\n')) + try { + const starting = spawnFn('docker compose down -v', { shell: true, stdio: 'inherit' }) + starting.on('error', e => { + console.error(e) + }) + if (starting?.stdout) { + for await (const data of starting.stdout) { + console.log(`${chalk.green(`FusionAuth:`)} ${data}`); + }; } - ]) - .then(async (answers) => { - if (!answers.confirmation) { - console.log(chalk.yellow('Cancelling the shutdown. The container is still running')) - process.exit() - } - - console.log(chalk.yellow('Killing FusionAuth...\n')) - try { - const starting = spawn('docker compose down -v', { shell: true, stdio: 'inherit' }) - starting.on('error', e => { - console.error(e) - }) - if (starting?.stdout) { - for await (const data of starting.stdout) { - console.log(`${chalk.green(`FusionAuth:`)} ${data}`); - }; - } - - starting.on('close', code => { - console.log(boxen(`The Docker container is shut down and the database has been destroyed.\nTo start it up, run ${chalk.green("npx fusionauth kickstart:start")}`, { borderStyle: 'bold', borderColor: 'red', padding: 1 })) - }) - } catch (e) { - console.error(e) - } - }).catch(e => { - console.log(chalk.red("The process exited. Please try again.")) + starting.on('close', code => { + console.log(boxen(`The Docker container is shut down and the database has been destroyed.\nTo start it up, run ${chalk.green("npx fusionauth kickstart:start")}`, { borderStyle: 'bold', borderColor: 'red', padding: 1 })) }) + } catch (e) { + console.error(e) + } } catch (err) { console.log(err) @@ -63,4 +59,5 @@ const action = async function () { export const kickstartKill = new Command() .command('kickstart:kill') .description('Runs docker compose down in current directory') - .action(action) + .option('--yes', 'Skip confirmation prompt', false) + .action((options) => action(options)) diff --git a/src/commands/message-upload.ts b/src/commands/message-upload.ts index 5654934..dbc4cdb 100644 --- a/src/commands/message-upload.ts +++ b/src/commands/message-upload.ts @@ -94,7 +94,7 @@ export const messageUpload = new Command('message:upload') } try { - const request: MessageTemplateRequest = {messageTemplate: removeUndefinedObjects.default(messageTemplate)}; + const request: MessageTemplateRequest = {messageTemplate: removeUndefinedObjects(messageTemplate)}; if (!templateExists) { await client.createMessageTemplate(templateId, request); } else if (overwrite) { diff --git a/src/commands/telemetry/telemetry-utils.ts b/src/commands/telemetry/telemetry-utils.ts index d6515ae..76c4291 100644 --- a/src/commands/telemetry/telemetry-utils.ts +++ b/src/commands/telemetry/telemetry-utils.ts @@ -1,12 +1,10 @@ import fs from "node:fs" -import { __dirname } from '../../utils.js' - -import { loadConfig } from "../../utils.js" +import { getConfigDir, loadConfig } from "../../utils.js" export function telemetryUpdate(value: boolean) { let config = loadConfig() config.globalConfig.telemetry = value - fs.writeFileSync(__dirname + '/.fa/config.json', JSON.stringify(config.globalConfig, null, 2)) + fs.writeFileSync(getConfigDir() + '/.fa/config.json', JSON.stringify(config.globalConfig, null, 2)) return config } \ No newline at end of file diff --git a/src/index.ts b/src/index.ts index 7b0210f..54096a6 100644 --- a/src/index.ts +++ b/src/index.ts @@ -21,6 +21,7 @@ const authString = figlet.textSync('Auth').split('\n'); fusionString.forEach((line, i) => { console.log(chalk.white(line) + chalk.hex('#F58320')(authString[i])); }); + const program = new Command(); program.name('@fusionauth/cli').description('CLI for FusionAuth'); Object.values(commands).forEach((command) => { diff --git a/src/resources/kickstart/kickstart.json b/src/resources/kickstart/kickstart.json index cf403e1..ee01a44 100644 --- a/src/resources/kickstart/kickstart.json +++ b/src/resources/kickstart/kickstart.json @@ -25,34 +25,6 @@ } } }, - { - "method": "POST", - "url": "/api/application/#{applicationId}", - "tenantId": "#{defaultTenantId}", - "body": { - "application": { - "name": "#{applicationName}", - "oauthConfiguration": { - "authorizedRedirectURLs": [ - "https://fusionauth.io" - ], - "logoutURL": "https://fusionauth.io", - "clientSecret": "#{clientSecret}", - "enabledGrants": [ - "authorization_code", - "refresh_token" - ], - "generateRefreshTokens": true, - "requireRegistration": true - }, - "jwtConfiguration": { - "enabled": true, - "accessTokenKeyId": "#{asymmetricKeyId}", - "idTokenKeyId": "#{asymmetricKeyId}" - } - } - } - }, { "method": "POST", "url": "/api/user/import", @@ -71,9 +43,6 @@ "admin" ], "registrations": [ - { - "applicationId": "#{applicationId}" - }, { "applicationId": "#{FUSIONAUTH_APPLICATION_ID}", "roles": [ diff --git a/src/utilities/apply/types.ts b/src/utilities/apply/types.ts index d1d29e2..640cc7e 100644 --- a/src/utilities/apply/types.ts +++ b/src/utilities/apply/types.ts @@ -6,38 +6,41 @@ /** * HTTP methods supported by the apply system */ -export enum HTTPMethod { - PATCH = 'PATCH', - POST = 'POST', - PUT = 'PUT', -} +export const HTTPMethod = { + PATCH: 'PATCH', + POST: 'POST', + PUT: 'PUT', +} as const; +export type HTTPMethod = typeof HTTPMethod[keyof typeof HTTPMethod]; /** * Status of a apply step execution */ -export enum StepStatus { - FAILED = 'failed', - PENDING = 'pending', - SKIPPED = 'skipped', - SUCCESS = 'success', - WARNING = 'warning', -} +export const StepStatus = { + FAILED: 'failed', + PENDING: 'pending', + SKIPPED: 'skipped', + SUCCESS: 'success', + WARNING: 'warning', +} as const; +export type StepStatus = typeof StepStatus[keyof typeof StepStatus]; /** * Categories of errors that can occur during apply execution */ -export enum ErrorCategory { - SCHEMA_INVALID = 'schema_invalid', - VARIABLE_NOT_DEFINED = 'variable_not_defined', - AUTHENTICATION_FAILED = 'authentication_failed', - NETWORK_ERROR = 'network_error', - RESOURCE_CONFLICT = 'resource_conflict', - SERVER_ERROR = 'server_error', - INVALID_PAYLOAD = 'invalid_payload', - FILE_NOT_FOUND = 'file_not_found', - UNKNOWN = 'unknown', -} +export const ErrorCategory = { + SCHEMA_INVALID: 'schema_invalid', + VARIABLE_NOT_DEFINED: 'variable_not_defined', + AUTHENTICATION_FAILED: 'authentication_failed', + NETWORK_ERROR: 'network_error', + RESOURCE_CONFLICT: 'resource_conflict', + SERVER_ERROR: 'server_error', + INVALID_PAYLOAD: 'invalid_payload', + FILE_NOT_FOUND: 'file_not_found', + UNKNOWN: 'unknown', +} as const; +export type ErrorCategory = typeof ErrorCategory[keyof typeof ErrorCategory]; /** * Variable definitions that can be referenced in kickstart requests diff --git a/src/utils.ts b/src/utils.ts index ec2da2b..5685dc7 100644 --- a/src/utils.ts +++ b/src/utils.ts @@ -4,24 +4,29 @@ import fs, { readFileSync } from 'node:fs' import { dirname } from 'node:path'; import { fileURLToPath } from 'node:url'; import { randomUUID } from 'node:crypto'; +import { inspect } from 'node:util'; import chalk from 'chalk'; import boxen from 'boxen'; import { execSync } from 'node:child_process'; - import { PostHog } from 'posthog-node' import * as dotenv from 'dotenv' -dotenv.config() +dotenv.config({ quiet: true }); + +/** Shape of a FusionAuth ClientResponse — used for duck-type checking without importing internals. */ +interface ClientResponseLike { + wasSuccessful: () => boolean; + response: unknown; + exception?: Error; +} export const posthogClient = new PostHog( 'phc_nB6C2uZX2LA6ce6VAaWZxBYPtq1wYH5x8A3n36DaLzQ', { host: 'https://us.i.posthog.com' } ) - - export const __dirname = dirname(fileURLToPath(import.meta.url)); /** @@ -29,7 +34,7 @@ export const __dirname = dirname(fileURLToPath(import.meta.url)); * @param response */ export const isClientResponse = (response: any): response is ClientResponse.default => { - return response.wasSuccessful !== undefined; + return response != null && response.wasSuccessful !== undefined; } /** @@ -37,7 +42,7 @@ export const isClientResponse = (response: any): response is ClientResponse.defa * @param response */ export const isErrors = (response: any): response is Errors => { - return response.fieldErrors !== undefined || response.generalErrors !== undefined; + return response != null && (response.fieldErrors !== undefined || response.generalErrors !== undefined); } /** @@ -85,7 +90,14 @@ export const reportError = (msg: string, error?: any): void => { return; } - console.error(chalk.red(toJson(error))); + // Last resort for a shape that matched none of the above (e.g. a plain + // object with no message/fieldErrors/generalErrors). util.inspect, not + // JSON.stringify (toJson), is used here deliberately: it handles + // circular references and non-JSON-serializable values (functions, + // undefined, symbols) gracefully instead of throwing or silently + // dropping them, which matters since `error` here is of truly unknown + // shape by this point. + console.error(chalk.red(inspect(error, { depth: null }))); } /** @@ -175,6 +187,67 @@ export function errorAndExit(message: string, error?: any) { process.exit(1); } +// Exported for testability — pure logic, no I/O, easy to unit test directly. +export function isConfirmationAccepted(answer: string): boolean { + const normalized = answer.trim().toLowerCase(); + return normalized === 'y' || normalized === 'yes'; +} + +// Exported for testability — settles the prompt's Promise without needing a real TTY/readline round-trip. +export function handleConfirmationAnswer( + answer: string, + resolve: () => void, + reject: (reason?: any) => void +): void { + if (isConfirmationAccepted(answer)) { + resolve(); + return; + } + console.log('Aborted.'); + process.exit(0); + // Only reached if process.exit was mocked/deferred (e.g. in tests) — reject rather + // than falling through to resolve(), which would incorrectly treat a decline as + // confirmation. + reject(new Error('Aborted by user.')); +} + +/** + * Prompts the user for confirmation before proceeding with a risky operation. + * + * - If `yes` is true, returns immediately (caller has pre-confirmed). + * - If running interactively (both stdin and stdout are TTYs), prints the message + * and prompts [y/N]. Accepts "y" or "yes" (case-insensitive, whitespace trimmed) + * as confirmation; anything else aborts. + * - If not running interactively (agent/script/pipe — e.g. stdin is piped even if + * stdout is a TTY), prints the message and exits with an error instructing the + * caller to pass --yes. + * + * @param message A description of what will happen and why it is risky. + * @param yes The value of the --yes flag from the command options. + */ +export async function confirmOrExit(message: string, yes: boolean): Promise { + if (yes) return; + + console.warn(chalk.yellow(message)); + + if (!process.stdin.isTTY || !process.stdout.isTTY) { + errorAndExit('Pass --yes to confirm this operation non-interactively.'); + // Only reached if process.exit was mocked/deferred (e.g. in tests) — throw rather + // than returning normally, which would incorrectly let the caller proceed. + throw new Error('Confirmation required: pass --yes to confirm this operation non-interactively.'); + } + + const { createInterface } = await import('node:readline'); + const rl = createInterface({ input: process.stdin, output: process.stdout }); + + await new Promise((resolve, reject) => { + rl.question('Proceed? [y/N] ', (answer) => { + rl.close(); + handleConfirmationAnswer(answer, resolve, reject); + }); + }); +} + /** * Returns a console log that can be added to a beta feature to warn the user */ @@ -209,6 +282,16 @@ export function isDirEmpty(path: string) { } } +/** + * Returns the base directory used for the global `.fa/config.json` file. + * Defaults to the directory containing this module, but can be overridden + * via FUSIONAUTH_CONFIG_DIR — primarily so tests can point at a real + * temporary directory instead of mocking the filesystem. + */ +export function getConfigDir(): string { + return process.env.FUSIONAUTH_CONFIG_DIR ?? __dirname +} + export function loadConfig() { const defaultConfig = { telemetry: true, @@ -216,10 +299,11 @@ export function loadConfig() { version: "1.0" } - const configPath = __dirname + '/.fa/config.json' + const configDir = getConfigDir() + const configPath = configDir + '/.fa/config.json' try { if (!fs.existsSync(configPath)) { - createConfig(__dirname + '/.fa', defaultConfig) + createConfig(configDir + '/.fa', defaultConfig) } const globalConfig = JSON.parse(fs.readFileSync(configPath).toString()) // TODO: Combine this with a local-project config @@ -304,7 +388,7 @@ export function createConfig(dir: string, configObject: ConfigObject = { id: ran type PropertyToAdd = {[key:string]: any} async function updateGlobalConfig(propertiesToAdd: PropertyToAdd | PropertyToAdd[]) { const config = loadConfig() - const configPath = __dirname + '/.fa/config.json' + const configPath = getConfigDir() + '/.fa/config.json' let newConfig: any; if (Array.isArray(propertiesToAdd)) { @@ -324,4 +408,4 @@ async function updateGlobalConfig(propertiesToAdd: PropertyToAdd | PropertyToAdd } fs.writeFileSync(configPath, JSON.stringify(newConfig, null, 2)) -} \ No newline at end of file +}