From fae0cfd6912c9ac504dbd059f0aeedf60396c716 Mon Sep 17 00:00:00 2001
From: Patrick Russell <parussel@adobe.com>
Date: Sat, 22 Nov 2025 21:54:57 -0800
Subject: [PATCH] Add support for AUS (Australia) region in CLI state commands

This commit adds support for the new Australia (AUS) region to the
CLI plugin for state management, enabling users to specify 'aus' as
a valid region for all state commands.

Changes:
- Add 'aus' to region flag options in BaseCommand
- Update all command tests to include 'aus' in expected region options
- Regenerate README with updated region documentation

Commands updated:
- aio app state get
- aio app state put
- aio app state delete
- aio app state list
- aio app state stats

All commands now accept --region flag with options: amer, emea, apac, aus

The new AUS region connects to:
https://storage-state-aus.app-builder.adp.adobe.io

All 72 tests passing with full coverage.

Related: ACNA-4170 - Australia region deployment
Requires: @adobe/aio-lib-state >= 5.1.0 (with AUS support)
---
 README.md                              | 26 +++++++++++++-------------
 src/BaseCommand.js                     |  2 +-
 test/BaseCommand.test.js               |  2 +-
 test/commands/app/state/delete.test.js |  2 +-
 test/commands/app/state/get.test.js    |  2 +-
 test/commands/app/state/list.test.js   |  2 +-
 test/commands/app/state/put.test.js    |  2 +-
 test/commands/app/state/stats.test.js  |  2 +-
 8 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/README.md b/README.md
index 80597cd..c217698 100644
--- a/README.md
+++ b/README.md
@@ -36,16 +36,16 @@ Delete key-values
 
 ```
 USAGE
-  $ aio app state delete [KEYS...] [--json] [--region amer|emea|apac] [--match <value>] [--force]
+  $ aio app state delete [KEYS...] [--json] [--region amer|emea|apac|aus] [--match <value>] [--force]
 
 ARGUMENTS
-  KEYS...  keys to delete. Above 5 keys, you will be prompted for confirmation
+  [KEYS...]  keys to delete. Above 5 keys, you will be prompted for confirmation
 
 FLAGS
   --force            [use with caution!] force delete, no safety prompt
   --match=<value>    [use with caution!] deletes ALL key-values matching the provided glob-like pattern
   --region=<option>  State region. Defaults to 'AIO_STATE_REGION' env or 'amer' if neither is set.
-                     <options: amer|emea|apac>
+                     <options: amer|emea|apac|aus>
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -76,14 +76,14 @@ Get a key-value
 
 ```
 USAGE
-  $ aio app state get KEY [--json] [--region amer|emea|apac]
+  $ aio app state get KEY [--json] [--region amer|emea|apac|aus]
 
 ARGUMENTS
   KEY  State key
 
 FLAGS
   --region=<option>  State region. Defaults to 'AIO_STATE_REGION' env or 'amer' if neither is set.
-                     <options: amer|emea|apac>
+                     <options: amer|emea|apac|aus>
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -105,12 +105,12 @@ List key-values
 
 ```
 USAGE
-  $ aio app state list [--json] [--region amer|emea|apac] [-m <value>]
+  $ aio app state list [--json] [--region amer|emea|apac|aus] [-m <value>]
 
 FLAGS
   -m, --match=<value>    [default: *] Glob-like pattern to filter keys
       --region=<option>  State region. Defaults to 'AIO_STATE_REGION' env or 'amer' if neither is set.
-                         <options: amer|emea|apac>
+                         <options: amer|emea|apac|aus>
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -139,7 +139,7 @@ Put a key-value
 
 ```
 USAGE
-  $ aio app state put KEY VALUE [--json] [--region amer|emea|apac] [-t <value>]
+  $ aio app state put KEY VALUE [--json] [--region amer|emea|apac|aus] [-t <value>]
 
 ARGUMENTS
   KEY    State key
@@ -148,7 +148,7 @@ ARGUMENTS
 FLAGS
   -t, --ttl=<value>      Time to live in seconds. Default is 86400 (24 hours), max is 31536000 (1 year).
       --region=<option>  State region. Defaults to 'AIO_STATE_REGION' env or 'amer' if neither is set.
-                         <options: amer|emea|apac>
+                         <options: amer|emea|apac|aus>
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -172,11 +172,11 @@ Display stats
 
 ```
 USAGE
-  $ aio app state stats [--json] [--region amer|emea|apac]
+  $ aio app state stats [--json] [--region amer|emea|apac|aus]
 
 FLAGS
   --region=<option>  State region. Defaults to 'AIO_STATE_REGION' env or 'amer' if neither is set.
-                     <options: amer|emea|apac>
+                     <options: amer|emea|apac|aus>
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -199,7 +199,7 @@ USAGE
   $ aio help [COMMAND...] [-n]
 
 ARGUMENTS
-  COMMAND...  Command to show help for.
+  [COMMAND...]  Command to show help for.
 
 FLAGS
   -n, --nested-commands  Include all nested commands in the output.
@@ -208,7 +208,7 @@ DESCRIPTION
   Display help for aio.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.16/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.36/src/commands/help.ts)_
 <!-- commandsstop -->
 
 ## Contributing
diff --git a/src/BaseCommand.js b/src/BaseCommand.js
index cfee6a9..d524f0e 100644
--- a/src/BaseCommand.js
+++ b/src/BaseCommand.js
@@ -109,7 +109,7 @@ BaseCommand.flags = {
   region: Flags.string({
     description: 'State region. Defaults to \'AIO_STATE_REGION\' env or \'amer\' if neither is set.',
     required: false,
-    options: ['amer', 'emea', 'apac']
+    options: ['amer', 'emea', 'apac', 'aus']
   })
 }
 
diff --git a/test/BaseCommand.test.js b/test/BaseCommand.test.js
index a2c56b4..578a73c 100644
--- a/test/BaseCommand.test.js
+++ b/test/BaseCommand.test.js
@@ -20,7 +20,7 @@ describe('prototype', () => {
   })
   test('flags', () => {
     expect(Object.keys(BaseCommand.flags).sort()).toEqual(['region'])
-    expect(BaseCommand.flags.region.options).toEqual(['amer', 'emea', 'apac'])
+    expect(BaseCommand.flags.region.options).toEqual(['amer', 'emea', 'apac', 'aus'])
     expect(BaseCommand.enableJsonFlag).toEqual(true)
   })
 })
diff --git a/test/commands/app/state/delete.test.js b/test/commands/app/state/delete.test.js
index ffb3221..771f318 100644
--- a/test/commands/app/state/delete.test.js
+++ b/test/commands/app/state/delete.test.js
@@ -35,7 +35,7 @@ describe('prototype', () => {
   })
   test('flags', () => {
     expect(Object.keys(Delete.flags).sort()).toEqual(['force', 'match', 'region'])
-    expect(Delete.flags.region.options).toEqual(['amer', 'emea', 'apac'])
+    expect(Delete.flags.region.options).toEqual(['amer', 'emea', 'apac', 'aus'])
     expect(Delete.enableJsonFlag).toEqual(true)
   })
 })
diff --git a/test/commands/app/state/get.test.js b/test/commands/app/state/get.test.js
index 27e9bbc..0bb163e 100644
--- a/test/commands/app/state/get.test.js
+++ b/test/commands/app/state/get.test.js
@@ -27,7 +27,7 @@ describe('prototype', () => {
   })
   test('flags', () => {
     expect(Object.keys(Get.flags).sort()).toEqual(['region'])
-    expect(Get.flags.region.options).toEqual(['amer', 'emea', 'apac'])
+    expect(Get.flags.region.options).toEqual(['amer', 'emea', 'apac', 'aus'])
     expect(Get.enableJsonFlag).toEqual(true)
   })
 })
diff --git a/test/commands/app/state/list.test.js b/test/commands/app/state/list.test.js
index 37960d5..5cdf3b7 100644
--- a/test/commands/app/state/list.test.js
+++ b/test/commands/app/state/list.test.js
@@ -46,7 +46,7 @@ describe('prototype', () => {
   })
   test('flags', () => {
     expect(Object.keys(List.flags).sort()).toEqual(['match', 'region'])
-    expect(List.flags.region.options).toEqual(['amer', 'emea', 'apac'])
+    expect(List.flags.region.options).toEqual(['amer', 'emea', 'apac', 'aus'])
     expect(List.enableJsonFlag).toEqual(true)
   })
 })
diff --git a/test/commands/app/state/put.test.js b/test/commands/app/state/put.test.js
index 69cbc3f..49022f7 100644
--- a/test/commands/app/state/put.test.js
+++ b/test/commands/app/state/put.test.js
@@ -29,7 +29,7 @@ describe('prototype', () => {
   })
   test('flags', () => {
     expect(Object.keys(Put.flags).sort()).toEqual(['region', 'ttl'])
-    expect(Put.flags.region.options).toEqual(['amer', 'emea', 'apac'])
+    expect(Put.flags.region.options).toEqual(['amer', 'emea', 'apac', 'aus'])
     expect(Put.enableJsonFlag).toEqual(true)
   })
 })
diff --git a/test/commands/app/state/stats.test.js b/test/commands/app/state/stats.test.js
index 3db1a13..ba1edce 100644
--- a/test/commands/app/state/stats.test.js
+++ b/test/commands/app/state/stats.test.js
@@ -27,7 +27,7 @@ describe('prototype', () => {
   })
   test('flags', () => {
     expect(Object.keys(Stats.flags).sort()).toEqual(['region'])
-    expect(Stats.flags.region.options).toEqual(['amer', 'emea', 'apac'])
+    expect(Stats.flags.region.options).toEqual(['amer', 'emea', 'apac', 'aus'])
     expect(Stats.enableJsonFlag).toEqual(true)
   })
 })