Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
9350a16
fix(release): adds new release workflows
brob Jul 9, 2026
48abc9f
chore(release): set `package.json` to 1.9.1-next.1 [skip ci]
semantic-release-bot Jul 9, 2026
1c08606
adding workflow test on pull-request
mark-robustelli Jul 24, 2026
3a4b5b2
updating with only main branch for test
mark-robustelli Jul 24, 2026
4852199
Merge pull request #54 from FusionAuth/mcr/add-test-to-commit
mark-robustelli Jul 29, 2026
6558d43
Working state
brob Sep 15, 2026
82d2f8c
Feedback version
brob Sep 16, 2026
aabc3cb
Adds readme
brob Sep 16, 2026
e4abced
feat: update application with cli
brob Sep 16, 2026
1de5c54
fix(update): adjust id argument into named required option
brob Sep 17, 2026
c00a2fe
fix(update): allow for multiple --prop variables
brob Sep 17, 2026
0921180
fix(update): file structure change and success messages
brob Sep 18, 2026
a646aa8
Andrewpai/yes flag (#55)
andrewpai Sep 18, 2026
bd1be90
fix(update): logs and outputs error for :get
brob Sep 22, 2026
7282c2e
feat(update): adds more error handling
brob Sep 23, 2026
a46bb02
feat(update): adds logging for :get
brob Sep 23, 2026
2d79a13
fix(update): updates language for --data success
brob Sep 23, 2026
37cb7df
fix(update): updates language for prop patch success
brob Sep 23, 2026
adbfef4
fix(update): adds error handling and testing for errors
brob Oct 2, 2026
8dc2f57
fix(update): adds better success message to :get
brob Oct 2, 2026
73430b7
Andrewpai/application create (#57)
andrewpai Oct 7, 2026
69f133a
Fixes readme typo
brob Oct 8, 2026
1c90138
Help text change on :get to "retrieve" instead of "update"
brob Oct 8, 2026
5af4420
Help text change on :get to consistently match the get instead of update
brob Oct 8, 2026
0bdd96c
fix(update): removes old options from update command
brob Oct 8, 2026
fc07744
fix(update): changes output variable name to match what comes from co…
brob Oct 8, 2026
13131aa
fix(update): fixes test for output file
brob Oct 8, 2026
4578c05
fix(update): refactors update for errorAndExit
brob Oct 8, 2026
d53beda
fix(update): refactors to result-based return
brob Oct 8, 2026
0d9731a
fix(update): updates splitProp to allow for multiple
brob Oct 8, 2026
547f23d
fix(update): removes response.body in favor of simpler error
brob Oct 8, 2026
aef8092
fix(update): converts default of get to console output
brob Oct 8, 2026
8448a1c
fix(update): removes ... from prop option
brob Oct 8, 2026
2c13c59
fix(update): repaces HTTPClient in get
brob Oct 8, 2026
0d10213
fix(update): converts update to FA client and away from HTTPClient
brob Oct 8, 2026
8d63b77
fix(update): converts getData to parseData from application:create
brob Oct 8, 2026
0e488c7
Merge branch 'next' into brob/app-update-nextmerge
brob Oct 9, 2026
c172bf3
Merge branch 'next-setup' into brob/app-update
brob Oct 9, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/workflows/test.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,9 @@ on:
push:
pull_request:
workflow_dispatch:
pull_request:
branches:
- main

jobs:
test:
Expand Down
9 changes: 9 additions & 0 deletions 3c219e58-ed0e-4b18-ad48-f4f92793ae32.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"application": {
"id": "3c219e58-ed0e-4b18-ad48-f4f92793ae32",
"name": "Test App",
"oauthConfiguration": {
"clientId": "3c219e58-ed0e-4b18-ad48-f4f92793ae32"
}
}
}
15 changes: 12 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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
- Template literals for string interpolation
18 changes: 16 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,23 @@
## [1.9.1-next-setup.3](https://github.com/FusionAuth/fusionauth-node-cli/compare/v1.9.1-next-setup.2...v1.9.1-next-setup.3) (2026-07-13)
## [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

* merges current into old branch ([58fd424](https://github.com/FusionAuth/fusionauth-node-cli/commit/58fd42463995387711e3838e7722fca1443996da))
* **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)

Expand Down
12 changes: 12 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,18 @@ fusionauth --help;
```

Currently, the CLI supports the following commands:
- Application management
- `fusionauth application:create --name <name> --profile <spa|native|webapp> --redirect-uri <uri...> [--authorized-origin-url <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 <name>] --data <json|@file.json>` - 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 <application-id>` - 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 <path-to-json-file>` - Provide a data file containing all the properties you wish to update constructed like the body of an application update
- `-p, --prop <property.to.change=value>` - Update a single property in the application
- `fusionauth application:get <application-id>` - 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
Expand Down
Loading