added my files

I just copy and past all my files into a new folder.

Author: tiagobalabuch

FabricTools/tiago/Private/Get-FileDefinitionParts.ps1

@@ -0,0 +1,57 @@
+function Get-FileDefinitionParts {
+    [CmdletBinding()]
+    param (
+        [Parameter(Mandatory = $true)]
+        [ValidateNotNullOrEmpty()]
+        [string]$sourceDirectory
+    )
+    try {
+        if (-Not (Test-Path $sourceDirectory)) {
+            Write-Message -Message "The specified source directory does not exist: $sourceDirectory" -Level Error 
+            throw
+        }
+
+        # Get all files from the directory recursively
+        Write-Message -Message "Get all files from the directory recursively" -Level Debug
+        $fileList = Get-ChildItem -Path $sourceDirectory -File -Recurse
+
+        # Initialize the output JSON object
+        $jsonObject = @{ parts = @() }
+
+        # Loop through the files to create parts dynamically
+        Write-Message -Message "Loop through the files to create parts dynamically" -Level Debug
+        foreach ($file in $fileList) {
+            
+            $relativePath = $file.FullName.Substring($sourceDirectory.Length + 1) -replace "\\", "/"
+            Write-Message -Message "File found: $relativePath" -Level Debug
+            Write-Message -Message "Starting encode to base64" -Level Debug
+            
+            $base64Content = Convert-ToBase64 -filePath $file.FullName
+            Write-Message -Message "Adding part to json object" -Level Debug
+            
+            $jsonObject.parts += @{ 
+                path        = $relativePath
+                payload     = $base64Content
+                payloadType = "InlineBase64"
+            }
+        }
+        Write-Message -Message "Loop through the files finished" -Level Debug
+        
+        return $jsonObject
+        Write-Message -Message "Parts returned" -Level Debug
+    }
+    
+    catch {
+        # Step 4: Handle and log errors
+        $errorDetails = $_.Exception.Message
+        Write-Message -Message "An error occurred while getting file definition parts: $errorDetails" -Level Error
+        throw "An error occurred while encoding to Base64: $_"
+    }
+}
+
+
+# Example usage
+#$sourceDirectory = "C:\temp\API\Notebook"
+#Get-FileParts -sourceDirectory $sourceDirectory
+#$fileParts = Get-FileParts -sourceDirectory $sourceDirectory
+#$fileParts | ConvertTo-Json -Depth 10

FabricTools/tiago/Private/Test-TokenExpired.ps1

@@ -0,0 +1,57 @@
+<#
+.SYNOPSIS
+Checks if the Fabric token is expired and logs appropriate messages.
+
+.DESCRIPTION
+The `Test-TokenExpired` function checks the expiration status of the Fabric token stored in the `$FabricConfig.TokenExpiresOn` variable. 
+If the token is expired, it logs an error message and provides guidance for refreshing the token. 
+Otherwise, it logs that the token is still valid.
+
+.PARAMETER FabricConfig
+The configuration object containing the token expiration details.
+
+.EXAMPLE
+Test-TokenExpired -FabricConfig $config
+
+Checks the token expiration status using the provided `$config` object.
+
+.NOTES
+- Ensure the `FabricConfig` object includes a valid `TokenExpiresOn` property of type `DateTimeOffset`.
+- Requires the `Write-Message` function for logging.
+
+.AUTHOR
+Tiago Balabuch
+#>
+function Test-TokenExpired {
+    [CmdletBinding()]
+    param ()
+
+    try {
+        # Ensure required properties have valid values
+        if ([string]::IsNullOrWhiteSpace($FabricConfig.TenantIdGlobal) -or 
+            [string]::IsNullOrWhiteSpace($FabricConfig.TokenExpiresOn)) {
+            Write-Message -Message "Token details are missing. Please run 'Set-FabricApiHeaders' to configure them." -Level Error
+            throw "MissingTokenDetailsException: Token details are missing."
+        }
+
+        # Convert the TokenExpiresOn value to a DateTime object
+        $tokenExpiryDate = [datetimeoffset]::Parse($FabricConfig.TokenExpiresOn)
+
+        # Check if the token is expired
+        if ($tokenExpiryDate -le [datetimeoffset]::Now) {
+            Write-Message -Message "Your authentication token has expired. Please sign in again to refresh your session." -Level Warning
+            #throw "TokenExpiredException: Token has expired."
+            #Set-FabricApiHeaders -tenantId $FabricConfig.TenantIdGlobal
+        }
+
+        # Log valid token status
+        Write-Message -Message "Token is still valid. Expiry time: $($tokenExpiryDate.ToString("u"))" -Level Debug
+    } catch [System.FormatException] {
+        Write-Message -Message "Invalid 'TokenExpiresOn' format in the FabricConfig object. Ensure it is a valid datetime string." -Level Error
+        throw "FormatException: Invalid TokenExpiresOn value."
+    } catch {
+        # Log unexpected errors with details
+        Write-Message -Message "An unexpected error occurred: $_" -Level Error
+        throw $_
+    }
+}

FabricTools/tiago/Private/Write-Message.ps1

@@ -0,0 +1,84 @@
+<#
+.SYNOPSIS
+Logs messages with different severity levels to the console and optionally to a file.
+
+.DESCRIPTION
+The `Write-Message` function provides a unified way to log messages with levels such as Info, Error, Alert, Verbose, and Debug.
+It supports logging to the console with color-coded messages and optionally writing logs to a file with timestamps.
+
+.PARAMETER Message
+The message to log. Supports pipeline input.
+
+.PARAMETER Level
+Specifies the log level. Supported values are Info, Error, Alert, Verbose, and Debug.
+
+.PARAMETER LogFile
+(Optional) Specifies a file path to write the log messages to. If not provided, messages are only written to the console.
+
+.EXAMPLE
+Write-Message -Message "This is an info message." -Level Info
+
+Logs an informational message to the console.
+
+.EXAMPLE
+Write-Message -Message "Logging to file." -Level Info -LogFile "C:\Logs\MyLog.txt"
+
+Logs an informational message to the console and writes it to a file.
+
+.EXAMPLE
+"Pipeline message" | Write-Message -Level Alert
+
+Logs a message from the pipeline with an Alert level.
+
+.NOTES
+Author: Tiago Balabuch
+#>
+
+function Write-Message {
+    [CmdletBinding()]
+    param (
+        [Parameter(Mandatory, ValueFromPipeline)]
+        [string]$Message,
+
+        [Parameter()]
+        [ValidateSet("Message","Info", "Error", "Warning","Critical", "Verbose", "Debug", IgnoreCase = $true)]
+        [string]$Level = "Info",
+
+        [Parameter()]
+        [string]$LogFile
+    )
+
+    process {
+        try {
+            # Format timestamp
+            $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+
+            # Construct log message
+            $logMessage = "[$timestamp] [$Level] $Message"
+
+            # Write log message to console with colors
+            switch ($Level) {
+                "Message" { Write-Host $logMessage -ForegroundColor White }
+                "Info" { Write-Host $logMessage -ForegroundColor Green }
+                "Error" { Write-Host $logMessage -ForegroundColor Red }
+                "Warning" { Write-Host $logMessage -ForegroundColor Yellow } 
+                "Critical" { Write-Host $logMessage -ForegroundColor Red }
+                "Verbose" { Write-Verbose $logMessage }
+                "Debug" { Write-Debug $logMessage }
+
+            }
+
+            # Optionally write log message to a file
+            if ($LogFile) {
+                try {
+                    Add-Content -Path $LogFile -Value $logMessage -Encoding UTF8
+                } catch {
+                    # Catch and log any errors when writing to file
+                    Write-Host "[ERROR] Failed to write to log file '$LogFile': $_" -ForegroundColor Red
+                }
+            }
+        } catch {
+            Write-Host "[ERROR] An unexpected error occurred: $_" -ForegroundColor Red
+        }
+    }
+}

FabricTools/tiago/Public/Capacity/Get-FabricCapacity.ps1

@@ -0,0 +1,92 @@
+
+<#
+.SYNOPSIS
+    Retrieves capacity details from a specified Microsoft Fabric workspace.
+
+.DESCRIPTION
+    This function retrieves capacity details from a specified workspace using either the provided capacityId or capacityName.
+    It handles token validation, constructs the API URL, makes the API request, and processes the response.
+
+.PARAMETER capacityId
+    The unique identifier of the capacity to retrieve. This parameter is optional.
+
+.PARAMETER capacityName
+    The name of the capacity to retrieve. This parameter is optional.
+
+.EXAMPLE
+     Get-FabricCapacity -capacityId "capacity-12345"
+    This example retrieves the capacity details for the capacity with ID "capacity-12345".
+
+.EXAMPLE
+     Get-FabricCapacity -capacityName "MyCapacity"
+    This example retrieves the capacity details for the capacity named "MyCapacity".
+
+.NOTES
+    - Requires `$FabricConfig` global configuration, including `BaseUrl` and `FabricHeaders`.
+    - Calls `Test-TokenExpired` to ensure token validity before making the API request.
+
+    Author: Tiago Balabuch
+#>
+function Get-FabricCapacity {
+    [CmdletBinding()]
+    param (
+        [Parameter(Mandatory = $false)]
+        [ValidateNotNullOrEmpty()]
+        [string]$capacityId,
+
+        [Parameter(Mandatory = $false)]
+        [ValidateNotNullOrEmpty()]
+        [string]$capacityName
+    )
+    try {
+        # Handle ambiguous input
+        if ($capacityId -and $capacityName) {
+            Write-Message -Message "Both 'capacityId' and 'capacityName' were provided. Please specify only one." -Level Error
+            return $null
+        }
+
+        # Ensure token validity
+        Write-Message -Message "Validating token..." -Level Debug
+        Test-TokenExpired
+        Write-Message -Message "Token validation completed." -Level Debug
+ 
+        # Construct the API endpoint URL
+        $apiEndpointURI = "{0}/capacities" -f $FabricConfig.BaseUrl
+        
+        # Invoke the Fabric API to retrieve capacity details
+        $capacities = Invoke-FabricAPIRequest `
+            -BaseURI $apiEndpointURI `
+            -Headers $FabricConfig.FabricHeaders `
+            -Method Get
+
+ 
+        # Filter results based on provided parameters
+        $response = if ($capacityId) {
+            $capacities | Where-Object { $_.Id -eq $capacityId }
+        }
+        elseif ($capacityName) {
+            $capacities | Where-Object { $_.DisplayName -eq $capacityName }
+        }
+        else {
+            # No filter, return all capacities
+            Write-Message -Message "No filter specified. Returning all capacities." -Level Debug
+            return $capacities
+        }
+ 
+        # Handle results
+        if ($response) {
+            Write-Message -Message "Capacity found matching the specified criteria." -Level Debug
+            return $response
+        }
+        else {
+            Write-Message -Message "No capacity found matching the specified criteria." -Level Warning
+            return $null
+        }
+    }
+    catch {
+        # Capture and log error details
+        $errorDetails = $_.Exception.Message
+        Write-Message -Message "Failed to retrieve capacity. Error: $errorDetails" -Level Error
+        return $null
+    }
+} 

FabricTools/tiago/Public/Copy Job/Get-FabricCopyJob.ps1

@@ -0,0 +1,100 @@
+<#
+.SYNOPSIS
+    Retrieves CopyJob details from a specified Microsoft Fabric workspace.
+
+.DESCRIPTION
+    This function retrieves CopyJob details from a specified workspace using either the provided CopyJobId or CopyJobName.
+    It handles token validation, constructs the API URL, makes the API request, and processes the response.
+
+.PARAMETER WorkspaceId
+    The unique identifier of the workspace where the CopyJob exists. This parameter is mandatory.
+
+.PARAMETER CopyJobId
+    The unique identifier of the CopyJob to retrieve. This parameter is optional.
+
+.PARAMETER CopyJobName
+    The name of the CopyJob to retrieve. This parameter is optional.
+
+.EXAMPLE
+     FabricCopyJob -WorkspaceId "workspace-12345" -CopyJobId "CopyJob-67890"
+    This example retrieves the CopyJob details for the CopyJob with ID "CopyJob-67890" in the workspace with ID "workspace-12345".
+
+.EXAMPLE
+     FabricCopyJob -WorkspaceId "workspace-12345" -CopyJobName "My CopyJob"
+    This example retrieves the CopyJob details for the CopyJob named "My CopyJob" in the workspace with ID "workspace-12345".
+
+.NOTES
+    - Requires `$FabricConfig` global configuration, including `BaseUrl` and `FabricHeaders`.
+    - Calls `Test-TokenExpired` to ensure token validity before making the API request.
+
+    Author: Tiago Balabuch
+#>
+function FabricCopyJob {
+    [CmdletBinding()]
+    param (
+        [Parameter(Mandatory = $true)]
+        [ValidateNotNullOrEmpty()]
+        [string]$WorkspaceId,
+
+        [Parameter(Mandatory = $false)]
+        [ValidateNotNullOrEmpty()]
+        [string]$CopyJobId,
+
+        [Parameter(Mandatory = $false)]
+        [ValidateNotNullOrEmpty()]
+        [ValidatePattern('^[a-zA-Z0-9_ ]*$')]
+        [string]$CopyJob
+    )
+
+    try {
+        # Handle ambiguous input
+        if ($CopyJobId -and $CopyJobName) {
+            Write-Message -Message "Both 'CopyJobId' and 'CopyJobName' were provided. Please specify only one." -Level Error
+            return $null
+        }
+
+        # Ensure token validity
+        Write-Message -Message "Validating token..." -Level Debug
+        Test-TokenExpired
+        Write-Message -Message "Token validation completed." -Level Debug
+        
+
+        # Construct the API endpoint URL
+        $apiEndpointURI = "{0}/workspaces/{1}/copyJobs" -f $FabricConfig.BaseUrl, $WorkspaceId
+         
+        # Invoke the Fabric API to retrieve capacity details
+        $copyJobs =  Invoke-FabricAPIRequest `
+        -BaseURI $apiEndpointURI `
+        -Headers $FabricConfig.FabricHeaders `
+        -Method Get 
+
+        #  Filter results based on provided parameters
+        $response = if ($CopyJobId) {
+            $copyJobs | Where-Object { $_.Id -eq $CopyJobId }
+        }
+        elseif ($CopyJobName) {
+            $copyJobs | Where-Object { $_.DisplayName -eq $CopyJobName }
+        }
+        else {
+            # Return all CopyJobs if no filter is provided
+            Write-Message -Message "No filter provided. Returning all CopyJobs." -Level Debug
+            $copyJobs
+        }
+
+        # Step 9: Handle results
+        if ($response) {
+            Write-Message -Message "CopyJob found matching the specified criteria." -Level Debug
+            return $response
+        }
+        else {
+            Write-Message -Message "No CopyJob found matching the provided criteria." -Level Warning
+            return $null
+        }
+    }
+    catch {
+        # Step 10: Capture and log error details
+        $errorDetails = $_.Exception.Message
+        Write-Message -Message "Failed to retrieve CopyJob. Error: $errorDetails" -Level Error
+    } 
+ 
+}