@tigrisdata/cli 2.14.0-beta.1 → 2.14.0-beta.3

package/dist/specs.yaml

@@ -86,6 +86,19 @@ definitions:
 
   access_options: &access_options [public, private]
 
+  global_arguments: &global_arguments
+    - name: format
+      description: Output format
+      options: [json, table]
+      default: table
+    - name: json
+      description: Output as JSON
+      type: flag
+    - name: yes
+      description: Skip confirmation prompts
+      type: flag
+      alias: "y"
+
 commands:
   #########################
   # Authentication
@@ -101,6 +114,11 @@ commands:
       onStart: 'Saving credentials...'
       onSuccess: 'Credentials saved to ~/.tigris/config.json. You can now use all tigris commands.'
       onFailure: 'Failed to save credentials'
+      nextActions:
+        - command: 'tigris credentials test'
+          description: 'Verify your credentials are working'
+        - command: 'tigris ls'
+          description: 'List your buckets'
     arguments:
       - name: access-key
         description: Your Tigris access key ID
@@ -156,6 +174,11 @@ commands:
           onFailure: 'Authentication failed'
           onAlreadyDone: "Already logged in.\nRun \"tigris logout\" first to switch accounts."
           hint: "You have {{count}} organizations.\nRun \"tigris orgs list\" to switch."
+          nextActions:
+            - command: 'tigris orgs list'
+              description: 'List and switch organizations'
+            - command: 'tigris ls'
+              description: 'List your buckets'
       # credentials
       - name: credentials
         description: Login with an access key and secret. Creates a temporary session that is cleared on logout
@@ -167,6 +190,9 @@ commands:
           onStart: 'Authenticating...'
           onSuccess: 'Logged in with credentials'
           onFailure: 'Authentication failed'
+          nextActions:
+            - command: 'tigris ls'
+              description: 'List your buckets'
         arguments:
           - name: access-key
             description: Your access key ID (will prompt if not provided)
@@ -189,15 +215,16 @@ commands:
       onSuccess: ''
       onFailure: 'Failed to get user information'
       onAlreadyDone: "Not authenticated\nRun \"tigris login\" to authenticate"
-    arguments:
-      - name: format
-        description: Output format
-        alias: f
-        options: [json, table]
-        default: table
-      - name: json
-        description: Output as JSON
-        type: flag
+  # update
+  - name: update
+    description: Update the CLI to the latest version
+    examples:
+      - "tigris update"
+    messages:
+      onStart: 'Checking for updates...'
+      onSuccess: 'Updated to {{latestVersion}}'
+      onFailure: 'Failed to update'
+      onAlreadyDone: 'Already on the latest version ({{currentVersion}})'
 
   # logout
   - name: logout
@@ -232,14 +259,6 @@ commands:
             description: Bucket name to test access against (optional)
             alias: b
             required: false
-          - name: format
-            description: Output format
-            alias: f
-            options: [json, table]
-            default: table
-          - name: json
-            description: Output as JSON
-            type: flag
 
 
   #########################
@@ -271,12 +290,8 @@ commands:
         alias: snapshot
       - name: format
         description: Output format
-        alias: f
         options: [json, table, xml]
         default: table
-      - name: json
-        description: Output as JSON
-        type: flag
 
   # mk
   - name: mk
@@ -340,14 +355,6 @@ commands:
       - name: source-snapshot
         description: Fork from a specific snapshot of the source bucket. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464). Requires --fork-of
         alias: source-snap
-      - name: format
-        description: Output format
-        alias: f
-        options: [json, table]
-        default: table
-      - name: json
-        description: Output as JSON
-        type: flag
 
   # touch
   - name: touch
@@ -365,14 +372,6 @@ commands:
         examples:
           - my-bucket/my-file.txt
           - t3://my-bucket/my-file.txt
-      - name: format
-        description: Output format
-        alias: f
-        options: [json, table]
-        default: table
-      - name: json
-        description: Output as JSON
-        type: flag
 
   # stat
   - name: stat
@@ -396,12 +395,8 @@ commands:
           - t3://my-bucket/my-object.json
       - name: format
         description: Output format
-        alias: f
         options: [json, table, xml]
         default: table
-      - name: json
-        description: Output as JSON
-        type: flag
       - name: snapshot-version
         description: Read from a specific bucket snapshot. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464)
         alias: snapshot
@@ -439,12 +434,8 @@ commands:
         description: Access key ID to use for signing. If not provided, resolved from credentials or prompted interactively
       - name: format
         description: Output format
-        alias: f
         options: [url, json]
         default: url
-      - name: json
-        description: Output as JSON
-        type: flag
 
   # cp
   - name: cp
@@ -481,14 +472,6 @@ commands:
         type: flag
         alias: r
         description: Copy directories recursively
-      - name: format
-        description: Output format
-        alias: f
-        options: [json, table]
-        default: table
-      - name: json
-        description: Output as JSON
-        type: flag
 
   # mv
   - name: mv
@@ -523,14 +506,7 @@ commands:
       - name: force
         type: flag
         alias: f
-        description: Skip confirmation prompt
-      - name: format
-        description: Output format
-        options: [json, table]
-        default: table
-      - name: json
-        description: Output as JSON
-        type: flag
+        description: Skip confirmation prompts (alias for --yes)
 
   # rm
   - name: rm
@@ -560,14 +536,7 @@ commands:
       - name: force
         type: flag
         alias: f
-        description: Skip confirmation prompt
-      - name: format
-        description: Output format
-        options: [json, table]
-        default: table
-      - name: json
-        description: Output as JSON
-        type: flag
+        description: Skip confirmation prompts (alias for --yes)
 
   #########################
   # Manage organizations
@@ -595,12 +564,8 @@ commands:
         arguments:
           - name: format
             description: Output format
-            alias: f
             options: [json, table, xml, select]
             default: select
-          - name: json
-            description: Output as JSON
-            type: flag
           - name: select
             description: Interactive selection mode
             alias: i
@@ -615,6 +580,9 @@ commands:
           onSuccess: "Organization '{{name}}' created successfully\nOrganization ID: {{id}}"
           onFailure: 'Failed to create organization'
           hint: "Next steps:\n   - Select this organization: tigris orgs select {{name}}"
+          nextActions:
+            - command: 'tigris orgs select {{name}}'
+              description: 'Select this organization as active'
         arguments:
           - name: name
             type: positional
@@ -631,6 +599,11 @@ commands:
           onStart: ''
           onSuccess: "Organization '{{name}}' selected"
           onFailure: 'Failed to select organization'
+          nextActions:
+            - command: 'tigris ls'
+              description: 'List your buckets'
+            - command: 'tigris buckets create <name>'
+              description: 'Create a new bucket'
         arguments:
           - name: name
             type: positional
@@ -667,12 +640,8 @@ commands:
         arguments:
           - name: format
             description: Output format
-            alias: f
             options: [json, table, xml]
             default: table
-          - name: json
-            description: Output as JSON
-            type: flag
           - name: forks-of
             description: Only list buckets that are forks of the named source bucket
       # create
@@ -689,6 +658,11 @@ commands:
           onStart: 'Creating bucket...'
           onSuccess: "Bucket '{{name}}' created successfully"
           onFailure: 'Failed to create bucket'
+          nextActions:
+            - command: 'tigris access-keys create <name>'
+              description: 'Create an access key for programmatic access'
+            - command: 'tigris cp ./file t3://{{name}}/'
+              description: 'Upload files to the new bucket'
         arguments:
           - name: name
             description: Name of the bucket
@@ -735,14 +709,6 @@ commands:
           - name: source-snapshot
             description: Fork from a specific snapshot of the source bucket. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464). Requires --fork-of
             alias: source-snap
-          - name: format
-            description: Output format
-            alias: f
-            options: [json, table]
-            default: table
-          - name: json
-            description: Output as JSON
-            type: flag
       # get
       - name: get
         description: Show details for a bucket including access level, region, tier, and custom domain
@@ -762,23 +728,22 @@ commands:
               - my-bucket
           - name: format
             description: Output format
-            alias: f
             options: [json, table, xml]
             default: table
-          - name: json
-            description: Output as JSON
-            type: flag
       # delete
       - name: delete
         description: Delete one or more buckets by name. The bucket must be empty or delete-protection must be off
         alias: d
         examples:
-          - "tigris buckets delete my-bucket --force"
-          - "tigris buckets delete bucket-a,bucket-b --force"
+          - "tigris buckets delete my-bucket --yes"
+          - "tigris buckets delete bucket-a,bucket-b --yes"
         messages:
           onStart: 'Deleting bucket...'
           onSuccess: "Bucket '{{name}}' deleted successfully"
           onFailure: "Failed to delete bucket '{{name}}'"
+          nextActions:
+            - command: 'tigris ls'
+              description: 'List remaining buckets'
         arguments:
           - name: name
             description: Name of the bucket or comma separated list of buckets
@@ -789,15 +754,7 @@ commands:
               - my-bucket
           - name: force
             type: flag
-            description: Skip confirmation prompt
-          - name: format
-            description: Output format
-            alias: f
-            options: [json, table]
-            default: table
-          - name: json
-            description: Output as JSON
-            type: flag
+            description: Skip confirmation prompts (alias for --yes)
       # set
       - name: set
         description: Update settings on an existing bucket such as access level, location, caching, or custom domain
@@ -845,13 +802,6 @@ commands:
           - name: enable-additional-headers
             description: Enable additional HTTP headers (X-Content-Type-Options nosniff)
             type: boolean
-          - name: format
-            description: Output format
-            options: [json, table]
-            default: table
-          - name: json
-            description: Output as JSON
-            type: flag
       # set-ttl
       - name: set-ttl
         description: Configure object expiration (TTL) on a bucket. Objects expire after a number of days or on a specific date
@@ -1092,12 +1042,8 @@ commands:
               - my-bucket
           - name: format
             description: Output format
-            alias: f
             options: [json, table, xml]
             default: table
-          - name: json
-            description: Output as JSON
-            type: flag
       # create
       - name: create
         description: (Deprecated, use "buckets create --fork-of") Create a new fork (copy-on-write clone) of the source bucket
@@ -1159,12 +1105,8 @@ commands:
               - my-bucket
           - name: format
             description: Output format
-            alias: f
             options: [json, table, xml]
             default: table
-          - name: json
-            description: Output as JSON
-            type: flag
       # take
       - name: take
         description: Take a new snapshot of the bucket's current state. Optionally provide a name for the snapshot
@@ -1227,12 +1169,8 @@ commands:
             alias: p
           - name: format
             description: Output format
-            alias: f
             options: [json, table, xml]
             default: table
-          - name: json
-            description: Output as JSON
-            type: flag
           - name: snapshot-version
             description: Read from a specific bucket snapshot. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464)
             alias: snapshot
@@ -1270,14 +1208,6 @@ commands:
           - name: snapshot-version
             description: Read from a specific bucket snapshot. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464)
             alias: snapshot
-          - name: format
-            description: Output format
-            alias: f
-            options: [json, table]
-            default: table
-          - name: json
-            description: Output as JSON
-            type: flag
       # put
       - name: put
         description: Upload a local file as an object. Content-type is auto-detected from extension unless overridden
@@ -1289,6 +1219,9 @@ commands:
           onStart: 'Uploading object...'
           onSuccess: "Object '{{key}}' uploaded successfully"
           onFailure: 'Failed to upload object'
+          nextActions:
+            - command: 'tigris presign {{bucket}}/{{key}}'
+              description: 'Generate a presigned URL for the uploaded object'
         arguments:
           - name: bucket
             description: Name of the bucket
@@ -1317,23 +1250,22 @@ commands:
             alias: t
           - name: format
             description: Output format
-            alias: f
             options: [json, table, xml]
             default: table
-          - name: json
-            description: Output as JSON
-            type: flag
       # delete
       - name: delete
         description: Delete one or more objects by key from the given bucket
         alias: d
         examples:
-          - "tigris objects delete my-bucket old-file.txt --force"
-          - "tigris objects delete my-bucket file-a.txt,file-b.txt --force"
+          - "tigris objects delete my-bucket old-file.txt --yes"
+          - "tigris objects delete my-bucket file-a.txt,file-b.txt --yes"
         messages:
           onStart: 'Deleting object...'
           onSuccess: "Object '{{key}}' deleted successfully"
           onFailure: 'Failed to delete object'
+          nextActions:
+            - command: 'tigris ls {{bucket}}'
+              description: 'List remaining objects in the bucket'
         arguments:
           - name: bucket
             description: Name of the bucket
@@ -1350,15 +1282,7 @@ commands:
               - my-file.txt
           - name: force
             type: flag
-            description: Skip confirmation prompt
-          - name: format
-            description: Output format
-            alias: f
-            options: [json, table]
-            default: table
-          - name: json
-            description: Output as JSON
-            type: flag
+            description: Skip confirmation prompts (alias for --yes)
       # set
       - name: set
         description: Update settings on an existing object such as access level
@@ -1387,14 +1311,6 @@ commands:
           - name: new-key
             description: Rename the object to a new key
             alias: n
-          - name: format
-            description: Output format
-            alias: f
-            options: [json, table]
-            default: table
-          - name: json
-            description: Output as JSON
-            type: flag
 
   #########################
   # Manage access keys
@@ -1420,12 +1336,8 @@ commands:
         arguments:
           - name: format
             description: Output format
-            alias: f
             options: [json, table, xml]
             default: table
-          - name: json
-            description: Output as JSON
-            type: flag
       - name: create
         description: Create a new access key with the given name. Returns the key ID and secret (shown only once)
         alias: c
@@ -1435,6 +1347,9 @@ commands:
           onStart: 'Creating access key...'
           onSuccess: 'Access key created'
           onFailure: 'Failed to create access key'
+          nextActions:
+            - command: 'tigris access-keys assign {{id}} --bucket <bucket> --role Editor'
+              description: 'Assign bucket roles to the new access key'
         arguments:
           - name: name
             description: Name for the access key
@@ -1442,19 +1357,11 @@ commands:
             required: true
             examples:
               - my-key
-          - name: format
-            description: Output format
-            alias: f
-            options: [json, table]
-            default: table
-          - name: json
-            description: Output as JSON
-            type: flag
       - name: delete
         description: Permanently delete an access key by its ID. This revokes all access immediately
         alias: d
         examples:
-          - "tigris access-keys delete tid_AaBbCcDdEeFf --force"
+          - "tigris access-keys delete tid_AaBbCcDdEeFf --yes"
         messages:
           onStart: 'Deleting access key...'
           onSuccess: 'Access key deleted'
@@ -1468,15 +1375,7 @@ commands:
               - tid_AaBbCcDdEeFf
           - name: force
             type: flag
-            description: Skip confirmation prompt
-          - name: format
-            description: Output format
-            alias: f
-            options: [json, table]
-            default: table
-          - name: json
-            description: Output as JSON
-            type: flag
+            description: Skip confirmation prompts (alias for --yes)
       - name: get
         description: Show details for an access key including its name, creation date, and assigned bucket roles
         alias: g
@@ -1493,14 +1392,6 @@ commands:
             required: true
             examples:
               - tid_AaBbCcDdEeFf
-          - name: format
-            description: Output format
-            alias: f
-            options: [json, table]
-            default: table
-          - name: json
-            description: Output as JSON
-            type: flag
       - name: assign
         description: Assign per-bucket roles to an access key. Pair each --bucket with a --role (Editor or ReadOnly), or use --admin for org-wide access
         alias: a
@@ -1513,6 +1404,9 @@ commands:
           onStart: 'Assigning bucket roles...'
           onSuccess: 'Bucket roles assigned'
           onFailure: 'Failed to assign bucket roles'
+          nextActions:
+            - command: 'tigris cp ./file t3://<bucket>/'
+              description: 'Upload files using the assigned access key'
         arguments:
           - name: id
             description: Access key ID
@@ -1537,14 +1431,6 @@ commands:
           - name: revoke-roles
             description: Revoke all bucket roles from the access key
             type: flag
-          - name: format
-            description: Output format
-            alias: f
-            options: [json, table]
-            default: table
-          - name: json
-            description: Output as JSON
-            type: flag
 
   #########################
   # IAM - Identity and Access Management
@@ -1577,12 +1463,8 @@ commands:
             arguments:
               - name: format
                 description: Output format
-                alias: f
                 options: [json, table, xml]
                 default: table
-              - name: json
-                description: Output as JSON
-                type: flag
           - name: get
             description: Show details for a policy including its document and attached users. If no ARN provided, shows interactive selection
             alias: g
@@ -1603,12 +1485,8 @@ commands:
                   - arn:aws:iam::org_id:policy/my-policy
               - name: format
                 description: Output format
-                alias: f
                 options: [json, table, xml]
                 default: table
-              - name: json
-                description: Output as JSON
-                type: flag
           - name: create
             description: Create a new policy with the given name and policy document. Document can be provided via file, inline JSON, or stdin
             alias: c
@@ -1664,7 +1542,7 @@ commands:
             alias: d
             examples:
               - "tigris iam policies delete"
-              - "tigris iam policies delete arn:aws:iam::org_id:policy/my-policy --force"
+              - "tigris iam policies delete arn:aws:iam::org_id:policy/my-policy --yes"
             messages:
               onStart: 'Deleting policy...'
               onSuccess: "Policy '{{resource}}' deleted"
@@ -1679,7 +1557,7 @@ commands:
                   - arn:aws:iam::org_id:policy/my-policy
               - name: force
                 type: flag
-                description: Skip confirmation prompt
+                description: Skip confirmation prompts (alias for --yes)
 
       - name: users
         description: Manage organization users and invitations
@@ -1703,12 +1581,8 @@ commands:
             arguments:
               - name: format
                 description: Output format
-                alias: f
                 options: [json, table, xml]
                 default: table
-              - name: json
-                description: Output as JSON
-                type: flag
           - name: invite
             description: Invite users to the organization by email
             alias: i
@@ -1739,8 +1613,8 @@ commands:
             alias: ri
             examples:
               - "tigris iam users revoke-invitation"
-              - "tigris iam users revoke-invitation invitation_id --force"
-              - "tigris iam users revoke-invitation id1,id2,id3 --force"
+              - "tigris iam users revoke-invitation invitation_id --yes"
+              - "tigris iam users revoke-invitation id1,id2,id3 --yes"
             messages:
               onStart: 'Revoking invitation...'
               onSuccess: "Invitation(s) revoked"
@@ -1754,7 +1628,7 @@ commands:
                 multiple: true
               - name: force
                 type: flag
-                description: Skip confirmation prompt
+                description: Skip confirmation prompts (alias for --yes)
           - name: update-role
             description: Update user roles in the organization. If no user ID provided, shows interactive selection
             alias: ur
@@ -1785,8 +1659,8 @@ commands:
             alias: rm
             examples:
               - "tigris iam users remove"
-              - "tigris iam users remove user@example.com --force"
-              - "tigris iam users remove user@example.com,user@example.net --force"
+              - "tigris iam users remove user@example.com --yes"
+              - "tigris iam users remove user@example.com,user@example.net --yes"
             messages:
               onStart: 'Removing user...'
               onSuccess: "User(s) removed"
@@ -1800,4 +1674,4 @@ commands:
                 multiple: true
               - name: force
                 type: flag
-                description: Skip confirmation prompt
+                description: Skip confirmation prompts (alias for --yes)

package/dist/utils/errors.js

@@ -0,0 +1 @@
+import{a,b}from"../chunk-DV3LCXRH.js";export{a as ExitCode,b as classifyError};

package/dist/utils/exit.js

@@ -0,0 +1 @@
+import{a,b,c,d}from"../chunk-3FMWZQ3C.js";import"../chunk-DV3LCXRH.js";import"../chunk-5VDFQRGP.js";import"../chunk-PPNBQWSR.js";export{a as exitWithError,b as failWithError,c as getSuccessNextActions,d as printNextActions};

package/dist/utils/messages.js

@@ -1 +1 @@
-import{a,b,c,d,e,f,g,h}from"../chunk-CQDWZKYG.js";import"../chunk-BETAO4PB.js";export{h as msg,e as printAlreadyDone,g as printDeprecated,d as printEmpty,c as printFailure,f as printHint,a as printStart,b as printSuccess};
+import{a,b,c,d,e,f,g,h,i}from"../chunk-5VDFQRGP.js";import"../chunk-PPNBQWSR.js";export{a as interpolate,i as msg,f as printAlreadyDone,h as printDeprecated,e as printEmpty,d as printFailure,g as printHint,b as printStart,c as printSuccess};

package/dist/utils/options.js

@@ -1 +1 @@
-import{a,b}from"../chunk-JRALYIRA.js";export{a as getOption,b as parseBoolean};
+import{a,b,c}from"../chunk-AHGPPFCQ.js";export{b as getFormat,a as getOption,c as parseBoolean};

package/dist/utils/path.js

@@ -1 +1 @@
-import{a,b,c,d,e,f,g,h,i}from"../chunk-LCWHZUZZ.js";export{g as globToRegex,d as isPathFolder,a as isRemotePath,i as listAllItems,f as parseAnyPath,c as parsePath,e as parsePaths,b as parseRemotePath,h as wildcardPrefix};
+import{a,b,c,d,e,f,g,h,i}from"../chunk-NDNMIXDC.js";export{g as globToRegex,d as isPathFolder,a as isRemotePath,i as listAllItems,f as parseAnyPath,c as parsePath,e as parsePaths,b as parseRemotePath,h as wildcardPrefix};

package/dist/utils/specs.js

@@ -1 +1 @@
-import{a,b,c,d,e}from"../chunk-BETAO4PB.js";export{e as buildPromptChoices,d as getArgumentSpec,c as getCommandSpec,b as loadSpecs,a as setSpecs};
+import{a,b,c,d,e}from"../chunk-PPNBQWSR.js";export{e as buildPromptChoices,d as getArgumentSpec,c as getCommandSpec,b as loadSpecs,a as setSpecs};

package/dist/utils/update-check.js

@@ -1 +1 @@
-import{b as a,c as b}from"../chunk-2HWTMFLS.js";import"../chunk-2XAO2OYD.js";export{b as checkForUpdates,a as isNewerVersion};
+import{b as a,c as b,d as c,e as d,f as e}from"../chunk-DZUJWPQ3.js";import"../chunk-ATBINUDP.js";export{e as checkForUpdates,d as fetchLatestVersion,c as getUpdateCommand,b as isNewerVersion,a as readUpdateCache};