public/Move-BucketObject.ps1
|
function Move-BucketObject { <# .SYNOPSIS Moves an object within or between buckets. .DESCRIPTION Moves an object file from one bucket to another (or within the same bucket), optionally changing the key. Deletes the source file after successful copy. Preserves the original serialization format (JSON or binary). .PARAMETER Bucket Source bucket name. .PARAMETER DestinationBucket Destination bucket name. Defaults to the same as -Bucket if omitted. .PARAMETER Path Root directory for bucket storage. Default: $HOME/.buckets. .PARAMETER Key Source object key to move. .PARAMETER DestinationKey Destination object key. Defaults to the source key if omitted. .PARAMETER PassThru Return metadata for the moved object. .PARAMETER Quiet Suppress all output. .EXAMPLE Move-BucketObject -Bucket logs -Key "log-004" -DestinationBucket archive .EXAMPLE Move-BucketObject -Bucket orders -Key "ORD-001" -DestinationKey "ORD-legacy-001" #> [CmdletBinding()] param( [Parameter(Mandatory = $true, Position = 0)][string]$Key, [Parameter(Mandatory = $true, Position = 1)][string]$Bucket, [string]$DestinationBucket, [string]$Path, [string]$DestinationKey, [switch]$PassThru, [switch]$Quiet ) if ([string]::IsNullOrWhiteSpace($Path)) { $Path = Get-DefaultPath } $Path = Resolve-SafePath -Path $Path $sourceBucketPath = Get-BucketPath -Name $Bucket -Path $Path if (-not [System.IO.Directory]::Exists($sourceBucketPath)) { throw "Source bucket '$Bucket' not found at '$sourceBucketPath'" } if ([string]::IsNullOrWhiteSpace($DestinationBucket)) { $DestinationBucket = $Bucket } if ([string]::IsNullOrWhiteSpace($DestinationKey)) { $DestinationKey = $Key } $safeDestKey = $DestinationKey -replace '[\\/:\*\?"<>\|\[\]]', '_' if ([string]::IsNullOrWhiteSpace($safeDestKey) -or $safeDestKey -match '^_+$') { throw "Destination key '$DestinationKey' is invalid after sanitization" } $sourceFile = Find-ObjectFile -BucketPath $sourceBucketPath -Key $Key if ($null -eq $sourceFile) { throw "Object with key '$Key' not found in bucket '$Bucket'" } $destBucketPath = Ensure-BucketExists -Name $DestinationBucket -Path $Path $destJsonPath = Join-Path $destBucketPath "${safeDestKey}.json" $destDatPath = Join-Path $destBucketPath "${safeDestKey}.dat" if ([System.IO.File]::Exists($destJsonPath) -or [System.IO.File]::Exists($destDatPath)) { throw "Object with key '$safeDestKey' already exists in bucket '$DestinationBucket'. Use a different key." } $ext = $sourceFile.Extension $destFile = Join-Path $destBucketPath "${safeDestKey}${ext}" [System.IO.File]::Copy($sourceFile, $destFile) try { [System.IO.File]::Delete($sourceFile) } catch { try { [System.IO.File]::Delete($destFile) } catch { } throw "Failed to delete source object after copy; destination was removed to roll back: $_" } Write-Verbose "Moved [$Bucket/$Key] to [$DestinationBucket/$safeDestKey]" if ($PassThru) { [PSCustomObject]@{ SourceBucket = $Bucket; SourceKey = $Key; DestinationBucket = $DestinationBucket DestinationKey = $safeDestKey } } elseif (-not $Quiet) { Write-Host "$Bucket/$Key" -NoNewline -ForegroundColor $script:CPath Write-Host " → " -NoNewline -ForegroundColor $script:CNum Write-Host "$DestinationBucket/$safeDestKey" -NoNewline -ForegroundColor $script:CPath Write-Host " · " -NoNewline -ForegroundColor $script:CMuted Write-Host "moved" -ForegroundColor $script:CMuted } } |