Add Format-RaindropError function for improved error handling and update module version to 1.0.0

Author: alan-null

Raindrop.API/Private/Format-RaindropError.ps1

@@ -0,0 +1,63 @@
+function Format-RaindropError {
+    <#
+    .SYNOPSIS
+    Formats detailed error information from a Raindrop API call.
+
+    .DESCRIPTION
+    Extracts HTTP status code, status description, and exception message from an error object
+    to provide comprehensive error details for Raindrop API failures.
+
+    .PARAMETER ErrorRecord
+    The error record from a catch block.
+
+    .PARAMETER Url
+    The URL that was being accessed when the error occurred.
+
+    .PARAMETER Operation
+    A description of the operation being performed (e.g., "export", "backup").
+    If not provided, uses the name of the calling cmdlet.
+
+    .EXAMPLE
+    try {
+        Invoke-RestMethod -Uri $url -Headers $headers -Method Get
+    }
+    catch {
+        Format-RaindropError -ErrorRecord $_ -Url $url
+    }
+    #>
+    param (
+        [Parameter(Mandatory)]
+        $ErrorRecord,
+
+        [Parameter(Mandatory)]
+        [string] $Url,
+
+        [Parameter(Mandatory = $false)]
+        [string] $Operation
+    )
+
+    # If Operation not provided, use the calling cmdlet's name
+    if ([string]::IsNullOrEmpty($Operation)) {
+        $Operation = (Get-PSCallStack)[1].Command
+    }
+
+    $errorMessage = $ErrorRecord.Exception.Message
+    $statusCode = $ErrorRecord.Exception.Response.StatusCode.value__
+    $statusDescription = $ErrorRecord.Exception.Response.StatusDescription
+
+    $errorDetails = @()
+    $errorDetails += "Failed to run '$Operation'"
+    $errorDetails += "(URL: $Url)"
+
+    if ($statusCode) {
+        $httpStatus = "HTTP $statusCode"
+        if ($statusDescription) {
+            $httpStatus += " ($statusDescription)"
+        }
+        $errorDetails += $httpStatus
+    }
+
+    $errorDetails += "Message: $errorMessage"
+
+    return $errorDetails -join " | "
+}

Raindrop.API/Public/Backup/Get-RaindropBackup.ps1

@@ -12,6 +12,7 @@ function Get-RaindropBackup {
         return $response.items
     }
     catch {
-        Write-Error "Failed to retrieve projects: $_"
+        $errorMsg = Format-RaindropError -ErrorRecord $_ -Url $url
+        Write-Error $errorMsg
     }
 }

Raindrop.API/Public/Backup/New-RaindropBackup.ps1

@@ -13,6 +13,7 @@ function New-RaindropBackup {
         return $response.result
     }
     catch {
-        Write-Error "Failed to retrieve projects: $_"
+        $errorMsg = Format-RaindropError -ErrorRecord $_ -Url $url
+        Write-Error $errorMsg
     }
 }

Raindrop.API/Public/Backup/Save-RaindropBackup.ps1

@@ -27,6 +27,7 @@ function Save-RaindropBackup {
         }
     }
     catch {
-        Write-Error "Failed to retrieve projects: $_"
+        $errorMsg = Format-RaindropError -ErrorRecord $_ -Url $url
+        Write-Error $errorMsg
     }
 }

Raindrop.API/Public/Export/Export-Raindrop.ps1

@@ -40,6 +40,7 @@ function Export-Raindrop {
         }
     }
     catch {
-        Write-Error "Failed to retrieve projects: $_"
+        $errorMsg = Format-RaindropError -ErrorRecord $_ -Url $url
+        Write-Error $errorMsg
     }
 }

Raindrop.API/Public/User/Get-RaindropUser.ps1

@@ -12,6 +12,7 @@ function Get-RaindropUser {
         return $response.user
     }
     catch {
-        Write-Error "Failed to retrieve projects: $_"
+        $errorMsg = Format-RaindropError -ErrorRecord $_ -Url $url
+        Write-Error $errorMsg
     }
 }

Raindrop.API/Raindrop.API.psd1

@@ -1,11 +1,11 @@
 
 @{
     RootModule        = 'Raindrop.API.psm1'
-    ModuleVersion     = '0.1.0'
+    ModuleVersion     = '1.0.0'
     GUID              = '051beb040c1c4869a116f1d524b04afc'
     Author            = 'Alan Plocieniak'
     CompanyName       = 'Alan Plocieniak'
-    Copyright         = '(c) 2025 Alan Plocieniak. All rights reserved.'
+    Copyright         = '(c) 2026 Alan Plocieniak. All rights reserved.'
     Description       = 'PowerShell module to interact with the Raindrop.io API'
     PowerShellVersion = '5.0'
     FunctionsToExport = '*'