feat(cli): support default-tier updates and snapshot-scoped object restore

- buckets set: add `--default-tier` to change an existing bucket's default
  storage tier
- objects restore / restore-info: add `--snapshot-version` (alias
  `--snapshot`) to target a point-in-time bucket snapshot

Assisted-by: Claude Opus 4.8 (1M context) via Claude Code

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: designcode

.changeset/cli-default-tier-and-snapshot-restore.md

@@ -0,0 +1,5 @@
+---
+"@tigrisdata/cli": minor
+---
+
+Add `--default-tier` to `tigris buckets set` and `--snapshot-version` (alias `--snapshot`) to `tigris objects restore` / `tigris objects restore-info`.

packages/cli/src/lib/buckets/set.ts

@@ -1,5 +1,9 @@
 import { getStorageConfigWithOrg } from '@auth/provider.js';
-import { type UpdateBucketOptions, updateBucket } from '@tigrisdata/storage';
+import {
+  type StorageClass,
+  type UpdateBucketOptions,
+  updateBucket,
+} from '@tigrisdata/storage';
 import { failWithError } from '@utils/exit.js';
 import { parseLocations } from '@utils/locations.js';
 import { msg, printStart, printSuccess } from '@utils/messages.js';
@@ -14,6 +18,10 @@ export default async function set(options: Record<string, unknown>) {
 
   const name = getOption<string>(options, ['name']);
   const access = getOption<string>(options, ['access']);
+  const defaultTier = getOption<string>(options, [
+    'default-tier',
+    'defaultTier',
+  ]);
   const locations = getOption<string | string[]>(options, ['locations']);
   const allowObjectAcl = getOption<string | boolean>(options, [
     'allow-object-acl',
@@ -52,6 +60,7 @@ export default async function set(options: Record<string, unknown>) {
   // Check if at least one setting is provided
   if (
     access === undefined &&
+    defaultTier === undefined &&
     locations === undefined &&
     allowObjectAcl === undefined &&
     disableDirectoryListing === undefined &&
@@ -71,6 +80,10 @@ export default async function set(options: Record<string, unknown>) {
     updateOptions.access = access as 'public' | 'private';
   }
 
+  if (defaultTier !== undefined) {
+    updateOptions.defaultTier = defaultTier as StorageClass;
+  }
+
   if (locations !== undefined) {
     updateOptions.locations = parseLocations(locations);
   }

packages/cli/src/lib/objects/restore-info.ts

@@ -15,6 +15,11 @@ export default async function restoreInfo(options: Record<string, unknown>) {
   const bucketArg = getOption<string>(options, ['bucket']);
   const keyArg = getOption<string>(options, ['key']);
   const versionId = getOption<string>(options, ['version-id', 'versionId']);
+  const snapshotVersion = getOption<string>(options, [
+    'snapshot-version',
+    'snapshotVersion',
+    'snapshot',
+  ]);
 
   if (!bucketArg) {
     failWithError(context, 'Bucket name or path is required');
@@ -30,6 +35,7 @@ export default async function restoreInfo(options: Record<string, unknown>) {
 
   const { data, error } = await getRestoreInfo(key, {
     ...(versionId ? { versionId } : {}),
+    ...(snapshotVersion ? { snapshotVersion } : {}),
     config: {
       ...config,
       bucket,

packages/cli/src/lib/objects/restore.ts

@@ -14,6 +14,11 @@ export default async function restore(options: Record<string, unknown>) {
   const bucketArg = getOption<string>(options, ['bucket']);
   const keyArg = getOption<string>(options, ['key']);
   const versionId = getOption<string>(options, ['version-id', 'versionId']);
+  const snapshotVersion = getOption<string>(options, [
+    'snapshot-version',
+    'snapshotVersion',
+    'snapshot',
+  ]);
   const daysArg = getOption<string | number>(options, ['days', 'd']);
 
   if (!bucketArg) {
@@ -39,6 +44,7 @@ export default async function restore(options: Record<string, unknown>) {
   const { error } = await restoreObject(key, {
     ...(days !== undefined ? { days } : {}),
     ...(versionId ? { versionId } : {}),
+    ...(snapshotVersion ? { snapshotVersion } : {}),
     config: {
       ...config,
       bucket,

packages/cli/src/specs.yaml

@@ -914,10 +914,11 @@ commands:
               - my-bucket
       # set
       - name: set
-        description: Update settings on an existing bucket such as access level, location, caching, or custom domain
+        description: Update settings on an existing bucket such as access level, default tier, location, caching, or custom domain
         alias: s
         examples:
           - "tigris buckets set my-bucket --access public"
+          - "tigris buckets set my-bucket --default-tier GLACIER"
           - "tigris buckets set my-bucket --locations iad,fra --cache-control 'max-age=3600'"
           - "tigris buckets set my-bucket --custom-domain assets.example.com"
           - "tigris buckets set my-bucket --soft-delete enable --retention-days 30"
@@ -936,6 +937,9 @@ commands:
           - name: access
             description: Bucket access level
             options: *access_options
+          - name: default-tier
+            description: Change the default storage tier for objects uploaded to the bucket
+            options: *tier_options
           - name: region
             removed: true
             replaced_by: --locations
@@ -1666,6 +1670,7 @@ commands:
           - "tigris objects restore my-bucket archived.bin"
           - "tigris objects restore my-bucket archived.bin --days 3"
           - "tigris objects restore t3://my-bucket/archived.bin --days 7"
+          - "tigris objects restore my-bucket archived.bin --snapshot-version 1765889000501544464"
         messages:
           onStart: 'Requesting restore...'
           onSuccess: "Restore requested for '{{key}}'"
@@ -1684,6 +1689,9 @@ commands:
             default: 1
           - name: version-id
             description: Restore a specific object version (requires bucket versioning). Omit to restore the current version
+          - name: snapshot-version
+            description: Restore the object as of 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
             options: [json, table, xml]
@@ -1695,6 +1703,7 @@ commands:
         examples:
           - "tigris objects restore-info my-bucket archived.bin"
           - "tigris objects restore-info t3://my-bucket/archived.bin --format json"
+          - "tigris objects restore-info my-bucket archived.bin --snapshot-version 1765889000501544464"
         messages:
           onStart: ''
           onSuccess: ''
@@ -1710,6 +1719,9 @@ commands:
             description: Key of the object (omit if bucket contains the full path)
           - name: version-id
             description: Inspect a specific object version (requires bucket versioning). Omit to read the current version
+          - name: snapshot-version
+            description: Inspect the object as of 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
             options: [json, table, xml]