@tigrisdata/cli 3.9.1 → 3.11.0

package/dist/specs.yaml

@@ -516,6 +516,7 @@ commands:
     examples:
       - "tigris cp ./file.txt t3://my-bucket/file.txt"
       - "tigris cp ./logo.png t3://my-bucket/logo.png --access public"
+      - "tigris cp ./dist/ t3://my-bucket/assets/ -r --cache-control 'public, max-age=31536000, immutable'"
       - "tigris cp t3://my-bucket/file.txt ./local-copy.txt"
       - "tigris cp t3://my-bucket/src/ t3://my-bucket/dest/ -r"
       - "tigris cp ./images/ t3://my-bucket/images/ -r"
@@ -549,6 +550,8 @@ commands:
         description: Access level for uploaded objects (only applies to local-to-remote uploads)
         alias: a
         options: *access_options
+      - name: cache-control
+        description: Cache-Control header stored with uploaded objects (only applies to local-to-remote uploads)
 
   # mv
   - name: mv
@@ -1330,6 +1333,54 @@ commands:
             description: Clear all CORS rules on the bucket
             type: flag
 
+      # share
+      - name: share
+        description: Share a bucket with your whole organization, specific teams, or specific users. Existing shares are kept unless --override or --reset is used
+        examples:
+          - "tigris buckets share my-bucket --organization --role ReadOnly"
+          - "tigris buckets share my-bucket --team tmid_MQQUhV --role Editor"
+          - "tigris buckets share my-bucket --user uid_MQQUhV --role ReadOnly"
+          - "tigris buckets share my-bucket --team tmid_A,tmid_B --role Editor,ReadOnly"
+          - "tigris buckets share my-bucket --team tmid_MQQUhV --role Editor --override"
+          - "tigris buckets share my-bucket --reset"
+        messages:
+          onStart: 'Updating bucket shares...'
+          onSuccess: 'Shares updated for bucket {{name}}'
+          onFailure: 'Failed to update bucket shares'
+        arguments:
+          - name: name
+            description: Name of the bucket
+            type: positional
+            required: true
+            examples:
+              - my-bucket
+          - name: organization
+            alias: org
+            description: Give access to everyone in your organization. Takes exactly one --role and cannot be combined with --team or --user
+            type: flag
+          - name: team
+            alias: t
+            description: Team ID to share with (can specify multiple, comma-separated). Each team is paired positionally with a --role value
+            multiple: true
+          - name: user
+            alias: u
+            description: User ID to share with (can specify multiple, comma-separated). Each user is paired positionally with a --role value
+            multiple: true
+          - name: role
+            alias: r
+            description: Role to grant (can specify multiple, comma-separated). A single role applies to every target; otherwise each role pairs with the corresponding --team or --user value
+            multiple: true
+            options:
+              - ReadOnly
+              - ReadWrite
+              - Editor
+          - name: override
+            description: Replace all existing shares instead of merging with them
+            type: flag
+          - name: reset
+            description: Remove all shares from the bucket
+            type: flag
+
   #########################
   # Manage forks (removed)
   #########################
@@ -1458,6 +1509,7 @@ commands:
           - "tigris objects list t3://my-bucket/images/"
           - "tigris objects list my-bucket --prefix images/"
           - "tigris objects list my-bucket --format json"
+          - "tigris objects list my-bucket --deleted"
         messages:
           onStart: 'Listing objects...'
           onSuccess: 'Found {{count}} object(s)'
@@ -1490,15 +1542,19 @@ commands:
           - name: source
             description: List objects from a specific storage source on buckets with shadow migration enabled
             options: [tigris, shadow]
+          - name: deleted
+            description: List soft-deleted objects instead of live ones. Requires soft delete on the bucket. On a snapshot bucket a plain delete records a delete marker instead, so use "tigris objects list-versions" for those
+            type: flag
       # list-versions
       - name: list-versions
-        description: List object versions and delete markers in a bucket (requires bucket versioning). Returns both arrays separately to match the S3 ListObjectVersions response
+        description: List object versions and delete markers in a bucket (requires bucket versioning), or with --deleted the recoverable versions of soft-deleted objects. Returns both arrays separately to match the S3 ListObjectVersions response
         alias: lv
         examples:
           - "tigris objects list-versions my-bucket"
           - "tigris objects list-versions t3://my-bucket/logs/"
           - "tigris objects list-versions my-bucket --prefix images/"
           - "tigris objects list-versions my-bucket --format json"
+          - "tigris objects list-versions my-bucket --prefix report.pdf --deleted"
         messages:
           onStart: 'Listing object versions...'
           onSuccess: 'Found {{versions}} version(s) and {{deleteMarkers}} delete marker(s)'
@@ -1528,6 +1584,9 @@ commands:
             description: Pagination marker — the key to start listing from (from a prior nextKeyMarker)
           - name: version-id-marker
             description: Pagination marker — the version id to start listing from (from a prior nextVersionIdMarker)
+          - name: deleted
+            description: List the recoverable versions of soft-deleted objects. Use the version id with "tigris objects restore-deleted" or "tigris objects purge"
+            type: flag
       # get
       - name: get
         description: Download an object by key. Prints to stdout by default, or saves to a file with --output
@@ -1573,6 +1632,7 @@ commands:
           - "tigris objects put my-bucket report.pdf ./report.pdf"
           - "tigris objects put t3://my-bucket/report.pdf ./report.pdf"
           - "tigris objects put my-bucket logo.png ./logo.png --access public --content-type image/png"
+          - "tigris objects put my-bucket app.js ./app.js --cache-control 'public, max-age=31536000, immutable'"
           - "echo 'hello' | tigris objects put t3://my-bucket/hello.txt"
           - "cat report.pdf | tigris objects put my-bucket report.pdf --content-type application/pdf"
         messages:
@@ -1608,6 +1668,8 @@ commands:
           - name: content-type
             description: Content type (auto-detected from extension if omitted)
             alias: t
+          - name: cache-control
+            description: Cache-Control header stored with the object and returned on every read (e.g. "public, max-age=31536000, immutable")
           - name: format
             description: Output format
             options: [json, table, xml]
@@ -1644,7 +1706,7 @@ commands:
             examples:
               - my-file.txt
           - name: version-id
-            description: Hard-delete a specific object version (requires bucket versioning). Targets a single key
+            description: Hard-delete a specific object version (requires bucket versioning). Targets a single key. To destroy a soft-deleted version, use "tigris objects purge"
           - name: all-versions
             description: Hard-delete every version and delete marker for the given key(s). Mutually exclusive with --version-id
             type: flag
@@ -1802,6 +1864,74 @@ commands:
             description: Output format
             options: [json, table, xml]
             default: table
+      # restore-deleted
+      - name: restore-deleted
+        description: Restore a soft-deleted object within its retention window. List recoverable objects with "tigris objects list --deleted", then pick a version with "tigris objects list-versions --deleted"
+        alias: rd
+        examples:
+          - "tigris objects restore-deleted my-bucket report.pdf --version-id 1787749774802410496"
+          - "tigris objects restore-deleted t3://my-bucket/report.pdf --version-id 1787749774802410496"
+        messages:
+          onStart: 'Restoring deleted object...'
+          onSuccess: "Object '{{key}}' restored successfully"
+          onFailure: 'Failed to restore deleted object'
+          nextActions:
+            - command: 'tigris ls {{bucket}}'
+              description: 'List objects in the bucket'
+        arguments:
+          - name: bucket
+            type: positional
+            required: true
+            description: Name of the bucket, or a full path (t3://bucket/key)
+            examples:
+              - my-bucket
+              - t3://my-bucket/report.pdf
+          - name: key
+            type: positional
+            description: Key of the object (omit if bucket contains the full path)
+            examples:
+              - report.pdf
+          - name: version-id
+            required: true
+            description: The soft-deleted version to bring back, from "tigris objects list-versions --deleted"
+          - name: format
+            description: Output format
+            options: [json, table, xml]
+            default: table
+      # purge
+      - name: purge
+        description: Permanently destroy a soft-deleted object version before its retention period expires. This cannot be undone — the version can no longer be restored with "tigris objects restore-deleted"
+        alias: pg
+        examples:
+          - "tigris objects purge my-bucket report.pdf --version-id 1787749774802410496 --yes"
+          - "tigris objects purge t3://my-bucket/report.pdf --version-id 1787749774802410496 --yes"
+        messages:
+          onStart: 'Purging deleted object...'
+          onSuccess: "Purged version '{{versionId}}' of '{{key}}'"
+          onFailure: 'Failed to purge deleted object'
+        arguments:
+          - name: bucket
+            type: positional
+            required: true
+            description: Name of the bucket, or a full path (t3://bucket/key)
+            examples:
+              - my-bucket
+              - t3://my-bucket/report.pdf
+          - name: key
+            type: positional
+            description: Key of the object (omit if bucket contains the full path)
+            examples:
+              - report.pdf
+          - name: version-id
+            required: true
+            description: The soft-deleted version to destroy, from "tigris objects list-versions --deleted"
+          - name: force
+            type: flag
+            description: Skip confirmation prompts (alias for --yes)
+          - name: format
+            description: Output format
+            options: [json, table, xml]
+            default: table
 
   #########################
   # Manage access keys
@@ -1889,7 +2019,7 @@ commands:
             examples:
               - tid_AaBbCcDdEeFf
       - 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
+        description: Assign per-bucket roles to an access key. Pair each --bucket with a --role (Editor, ReadWrite, or ReadOnly), or use --admin for org-wide access
         alias: a
         examples:
           - "tigris access-keys assign tid_AaBb --bucket my-bucket --role Editor"
@@ -1920,6 +2050,7 @@ commands:
             multiple: true
             options:
               - Editor
+              - ReadWrite
               - ReadOnly
           - name: admin
             description: Grant admin access to all buckets in the organization

package/dist/utils/analytics.js

@@ -1 +1 @@
-import{a,b,c,d,e,f}from"../chunk-L3733IUI.js";import"../chunk-G4OJTPSI.js";import"../chunk-L6RBXP7Z.js";import"../chunk-BMWWPXMU.js";import"../chunk-APJUJ6TW.js";import"../chunk-V6JZFDRE.js";export{d as captureCommand,c as decodeTokenEmail,f as identifyOnLogin,a as isCI,e as trackCommand,b as usedFlags};
+import{a,b,c,d,e,f}from"../chunk-7BUC7A7V.js";import"../chunk-G4OJTPSI.js";import"../chunk-Z54TMLIH.js";import"../chunk-BMWWPXMU.js";import"../chunk-APJUJ6TW.js";import"../chunk-QPUL2AAI.js";export{d as captureCommand,c as decodeTokenEmail,f as identifyOnLogin,a as isCI,e as trackCommand,b as usedFlags};

package/dist/utils/bucket-info.js

@@ -1 +1 @@
-import{a,b,c}from"../chunk-JNSFDQGG.js";import"../chunk-AFM3TY2D.js";import"../chunk-N3Y6RFSK.js";import"../chunk-S77OAN6Y.js";export{c as buildBucketInfo,b as describeExpiration,a as describeTransition};
+import{a,b,c}from"../chunk-IUIKP2LU.js";import"../chunk-AFM3TY2D.js";import"../chunk-N3Y6RFSK.js";import"../chunk-S77OAN6Y.js";export{c as buildBucketInfo,b as describeExpiration,a as describeTransition};

package/dist/utils/exit.js

@@ -1 +1 @@
-import{a,b,c,d}from"../chunk-R5SYFHP5.js";import"../chunk-D7WXNA2O.js";import"../chunk-NI4EYBQH.js";import"../chunk-AJOTB3MR.js";import"../chunk-DV3LCXRH.js";import"../chunk-L6RBXP7Z.js";import"../chunk-BMWWPXMU.js";import"../chunk-APJUJ6TW.js";import"../chunk-V6JZFDRE.js";export{a as exitWithError,b as failWithError,c as getSuccessNextActions,d as printNextActions};
+import{a,b,c,d}from"../chunk-6TTEDYLD.js";import"../chunk-D7WXNA2O.js";import"../chunk-NI4EYBQH.js";import"../chunk-7Q44GQ2Y.js";import"../chunk-DV3LCXRH.js";import"../chunk-Z54TMLIH.js";import"../chunk-BMWWPXMU.js";import"../chunk-APJUJ6TW.js";import"../chunk-QPUL2AAI.js";export{a as exitWithError,b as failWithError,c as getSuccessNextActions,d as printNextActions};

package/dist/utils/telemetry.js

@@ -1 +1 @@
-import{a as c,b as d,c as e,d as f,e as g}from"../chunk-AJOTB3MR.js";import"../chunk-L6RBXP7Z.js";import{a,b}from"../chunk-BMWWPXMU.js";import"../chunk-APJUJ6TW.js";import"../chunk-V6JZFDRE.js";export{d as beforeSend,f as captureError,g as flushTelemetry,e as initTelemetry,c as invocationCommand,a as redactSecrets,b as scrubArgv};
+import{a as c,b as d,c as e,d as f,e as g}from"../chunk-7Q44GQ2Y.js";import"../chunk-Z54TMLIH.js";import{a,b}from"../chunk-BMWWPXMU.js";import"../chunk-APJUJ6TW.js";import"../chunk-QPUL2AAI.js";export{d as beforeSend,f as captureError,g as flushTelemetry,e as initTelemetry,c as invocationCommand,a as redactSecrets,b as scrubArgv};

package/dist/utils/update-check.js

@@ -1 +1 @@
-import{a,b,c,d,e}from"../chunk-UPKISX4L.js";import"../chunk-G4OJTPSI.js";import"../chunk-L6RBXP7Z.js";import"../chunk-V6JZFDRE.js";export{e as checkForUpdates,d as fetchLatestVersion,c as getUpdateCommand,b as isNewerVersion,a as readUpdateCache};
+import{a,b,c,d,e}from"../chunk-KJXUEGXY.js";import"../chunk-G4OJTPSI.js";import"../chunk-Z54TMLIH.js";import"../chunk-QPUL2AAI.js";export{e as checkForUpdates,d as fetchLatestVersion,c as getUpdateCommand,b as isNewerVersion,a as readUpdateCache};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tigrisdata/cli",
-  "version": "3.9.1",
+  "version": "3.11.0",
   "description": "Command line interface for Tigris object storage",
   "type": "module",
   "exports": {
@@ -46,8 +46,8 @@
     "jsonc-parser": "^3.3.1",
     "open": "^11.0.0",
     "yaml": "^2.8.3",
-    "@tigrisdata/iam": "^2.3.0",
-    "@tigrisdata/storage": "^3.18.0"
+    "@tigrisdata/iam": "^2.5.0",
+    "@tigrisdata/storage": "^3.21.0"
   },
   "devDependencies": {
     "tsx": "^4.21.0"

package/dist/chunk-JNSFDQGG.js

@@ -1 +0,0 @@
-import{a as l}from"./chunk-AFM3TY2D.js";import{b as r}from"./chunk-N3Y6RFSK.js";function a(e){if(e.storageClass)return e.days!==void 0?`${e.storageClass} after ${e.days}d`:e.date!==void 0?`${e.storageClass} on ${e.date}`:e.storageClass}function f(e){if(e.expiration){if(e.expiration.days!==void 0)return`${e.expiration.days}d`;if(e.expiration.date!==void 0)return e.expiration.date}}function u(e){let n=[],i=a(e);i&&n.push(i);let t=f(e);t&&n.push(e.expiration?.days!==void 0?`expire after ${t}`:`expire on ${t}`);let s=[];e.filter?.prefix&&s.push(`prefix=${e.filter.prefix}`),e.enabled===!1&&s.push("disabled");let o=n.join(", ");return s.length>0?`${o} (${s.join(", ")})`:o}function p(e){let n=[{label:"Number of Objects",value:e.sizeInfo.numberOfObjects?.toString()??"N/A"},{label:"Total Size",value:e.sizeInfo.size!==void 0?l(e.sizeInfo.size):"N/A"},{label:"All Versions Count",value:e.sizeInfo.numberOfObjectsAllVersions?.toString()??"N/A"},{label:"Default Tier",value:e.settings.defaultTier},{label:"Locations",value:r(e.locations)},{label:"Snapshots Enabled",value:e.isSnapshotEnabled?"Yes":"No"},{label:"Delete Protection",value:e.settings.deleteProtection?"Yes":"No"},{label:"Soft Delete",value:e.settings.softDelete.enabled?`Enabled (${e.settings.softDelete.retentionDays} day retention)`:"Disabled"},{label:"Allow Object ACL",value:e.settings.allowObjectAcl?"Yes":"No"},{label:"Custom Domain",value:e.settings.customDomain??"None"},{label:"Has Forks",value:e.forkInfo?.hasChildren?"Yes":"No"}];return e.forkInfo?.parents?.length&&(n.push({label:"Forked From",value:e.forkInfo.parents[0].bucketName}),n.push({label:"Fork Snapshot",value:e.forkInfo.parents[0].snapshot})),e.settings.lifecycleRules?.length&&n.push({label:"Lifecycle Rules",value:e.settings.lifecycleRules.map(i=>u(i)).join(", ")}),e.settings.additionalHeaders&&n.push({label:"Additional Headers",value:Object.entries(e.settings.additionalHeaders).map(([i,t])=>`${i}: ${t}`).join(", ")}),e.settings.corsRules.length&&n.push({label:"CORS Rules",value:`${e.settings.corsRules.length} rule(s)`}),e.settings.notifications&&n.push({label:"Notifications",value:e.settings.notifications.enabled!==!1?"Enabled":"Disabled"}),e.settings.dataMigration&&n.push({label:"Data Migration",value:e.settings.dataMigration.endpoint?`${e.settings.dataMigration.name??"N/A"} (${e.settings.dataMigration.endpoint})`:e.settings.dataMigration.name??"Configured"}),n}export{a,f as b,p as c};

package/dist/chunk-L6RBXP7Z.js

@@ -1 +0,0 @@
-var e="3.9.1";export{e as a};

package/dist/chunk-UPKISX4L.js

@@ -1,8 +0,0 @@
-import{b as h}from"./chunk-G4OJTPSI.js";import{a as p}from"./chunk-L6RBXP7Z.js";import{d as f,e as m,f as d}from"./chunk-V6JZFDRE.js";import{mkdirSync as w,readFileSync as E,writeFileSync as T}from"fs";import I from"https";import{homedir as g}from"os";import{join as C}from"path";var N=C(g(),".tigris","update-check.json");function _(){try{let r=E(N,"utf-8"),i=JSON.parse(r);return typeof i.latestVersion=="string"&&typeof i.lastChecked=="number"?i:null}catch{return null}}function b(r){try{w(C(g(),".tigris"),{recursive:!0}),T(N,JSON.stringify(r),"utf-8")}catch{}}function U(r,i){let o=s=>{let n=s.startsWith("v")?s.slice(1):s,c=null,a=n.indexOf("-");a!==-1&&(c=n.slice(a+1),n=n.slice(0,a));let l=n.split(".");if(l.length!==3)return null;let u=l.map(Number);return u.some(Number.isNaN)?null:{major:u[0],minor:u[1],patch:u[2],prerelease:c}},t=o(r),e=o(i);return!t||!e?!1:e.major>t.major?!0:e.major<t.major?!1:e.minor>t.minor?!0:e.minor<t.minor?!1:e.patch>t.patch?!0:e.patch<t.patch?!1:t.prerelease&&!e.prerelease?!0:(!t.prerelease&&e.prerelease,!1)}function D(){switch(h()){case"npm":return"npm install -g @tigrisdata/cli";case"homebrew":return"brew upgrade tigris";default:return process.platform==="win32"?"irm https://raw.githubusercontent.com/tigrisdata/storage/main/packages/cli/scripts/install.ps1 | iex":"curl -fsSL https://raw.githubusercontent.com/tigrisdata/storage/main/packages/cli/scripts/install.sh | sh"}}function k(r={}){return new Promise((i,o)=>{let t=I.get(f,{timeout:1e4},e=>{let s="";e.on("data",n=>{s+=n}),e.on("end",()=>{try{let n=JSON.parse(s);typeof n.version=="string"?(b({..._(),latestVersion:n.version,lastChecked:Date.now()}),i(n.version)):o(new Error("Unexpected registry response"))}catch{o(new Error("Failed to parse registry response"))}})});t.on("error",e=>{o(e)}),t.on("timeout",()=>{t.destroy(),o(new Error("Request timed out"))}),r.unref&&t.on("socket",e=>{e.unref()}),t.end()})}function S(){k({unref:!0}).catch(()=>{})}function M(){if(process.env.TIGRIS_NO_UPDATE_CHECK==="1"||!process.stdout.isTTY)return;let r=_(),i=Number(process.env.TIGRIS_UPDATE_NOTIFY_INTERVAL_MS)||36e5;if(r&&U(p,r.latestVersion)&&(!r.lastNotified||Date.now()-r.lastNotified>i)){let t=`Update available: ${p} \u2192 ${r.latestVersion}`,e='Run "tigris update" to upgrade.',s=Math.max(t.length,e.length)+4,n=`\u250C${"\u2500".repeat(s-2)}\u2510`,c=`\u2514${"\u2500".repeat(s-2)}\u2518`,a=l=>`\u2502 ${l.padEnd(s-4)} \u2502`;console.log(`
-${n}
-${a("")}
-${a(t)}
-${a(e)}
-${a("")}
-${c}
-`),b({...r,lastNotified:Date.now()})}let o=Number(process.env.TIGRIS_UPDATE_CHECK_INTERVAL_MS)||216e5;(!r||Date.now()-r.lastChecked>o)&&S()}export{_ as a,U as b,D as c,k as d,M as e};

package/dist/chunk-V6JZFDRE.js

@@ -1 +0,0 @@
-var t="https://t3.storage.dev",o="https://iam.storageapi.dev",s="https://mgmt.storageapi.dev",p="https://registry.npmjs.org/@tigrisdata/cli/latest",_=216e5,e=36e5,T="TIGRIS_NO_BANNER",r="https://c3a84c6a2811c557d70e42412cda4ffa@o4507410155896832.ingest.us.sentry.io/4511767771545600",E="phc_6a2zd9w9hGzIqYl527bL4dXk3Wz8J9pEHyXTwP1hHq4",N="https://ph.tigrisdata.com";export{t as a,o as b,s as c,p as d,_ as e,e as f,T as g,r as h,E as i,N as j};