v2.12.1

.github/dependabot.yml

@@ -3,4 +3,13 @@ updates:
   - package-ecosystem: "github-actions"
     directory: "/"
     schedule:
-      interval: "daily"
+      interval: "daily"
+    labels:
+      - "packaging :package:"
+
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    labels:
+      - "packaging :package:"

.github/workflows/VirusTotal.yml

@@ -19,7 +19,7 @@ on:
     - cron: '0 12 * * *'
 
 env:
-  INVOKE_BUILD_VERSION: '5.12.0'
+  INVOKE_BUILD_VERSION: '5.12.2'
   POWERSHELL_VERSION: 'lts'
 
 jobs:

.github/workflows/ci-coverage.yml

@@ -20,7 +20,7 @@ on:
     - '.github/workflows/ci-coverage.yml'
 
 env:
-  INVOKE_BUILD_VERSION: '5.12.0'
+  INVOKE_BUILD_VERSION: '5.12.2'
 
 jobs:
   build:

.github/workflows/ci-docs.yml

@@ -24,7 +24,7 @@ on:
     - 'src/Pode.psd1'
 
 env:
-  INVOKE_BUILD_VERSION: '5.12.0'
+  INVOKE_BUILD_VERSION: '5.12.2'
 
 jobs:
   build:

.github/workflows/ci-powershell.yml

@@ -20,7 +20,7 @@ on:
     - '.github/workflows/ci-powershell.yml'
 
 env:
-  INVOKE_BUILD_VERSION: '5.12.0'
+  INVOKE_BUILD_VERSION: '5.12.2'
 
 jobs:
   build:

.github/workflows/ci-pwsh7_5.yml

@@ -24,9 +24,8 @@ on:
     - '*.dockerfile'
 
 env:
-  INVOKE_BUILD_VERSION: '5.12.0'
-  POWERSHELL_VERSION: '7.5.0'
-
+  INVOKE_BUILD_VERSION: '5.12.2'
+  POWERSHELL_VERSION: '7.5.1'
 
 jobs:
   build:

.github/workflows/ci-pwsh_lts.yml

@@ -24,7 +24,7 @@ on:
     - '*.dockerfile'
 
 env:
-  INVOKE_BUILD_VERSION: '5.12.0'
+  INVOKE_BUILD_VERSION: '5.12.2'
   POWERSHELL_VERSION: 'lts'
 
 jobs:

.github/workflows/ci-pwsh_preview.yml

@@ -24,7 +24,7 @@ on:
     - '*.dockerfile'
 
 env:
-  INVOKE_BUILD_VERSION: '5.12.0'
+  INVOKE_BUILD_VERSION: '5.12.2'
   POWERSHELL_VERSION: 'Preview'
 
 jobs:

.gitignore

@@ -4,13 +4,15 @@
 # Pode files and directories
 pode_modules/
 ps_modules/
+src/Misc/third_party/
 docs/[Ff]unctions/
 examples/state.json
 examples/issue-*
 examples/issues/
 pkg/
 deliverable/
 .vs/
+yarn.lock
 
 # Code Runner
 tempCodeRunnerFile.ps1

docs/Getting-Started/build.md

@@ -7,13 +7,13 @@ If you have Pode's source code checked out locally on your machine, you can foll
 
 1. Install InvokeBuild Module
 
-    ### Using Powershell Gallery
+   ### Using Powershell Gallery
 
     ```powershell
     Install-Module InvokeBuild -Scope CurrentUser
     ```
 
-    ### Using Chocolatey
+   ### Using Chocolatey
 
     ```powershell
     choco install invoke-build
@@ -52,11 +52,11 @@ If you have Pode's source code checked out locally on your machine, you can foll
     ```
 
     To uninstall, use:
+
     ```powershell
     Invoke-Build Remove-Module
     ```
 
-
 6. CleanUp
 
     To clean up after a build or a pack, run the following:
@@ -65,38 +65,39 @@ If you have Pode's source code checked out locally on your machine, you can foll
     Invoke-Build clean
     ```
 
-## Linux
+### Linux
 
 1. Register the Microsoft Repository
 
     #### CentOS
+
     ```shell
     sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
     sudo curl -o /etc/yum.repos.d/microsoft.repo https://packages.microsoft.com/config/centos/8/prod.repo
     ```
 
     #### RedHat
+
     ```shell
     sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
     sudo curl -o /etc/yum.repos.d/microsoft.repo https://packages.microsoft.com/config/rhel/9/prod.repo
     ```
 
     #### Debian / Ubuntu
+
     ```shell
     sudo apt-get update
     sudo apt-get install -y wget apt-transport-https software-properties-common
     wget https://packages.microsoft.com/config/debian/$(lsb_release -rs)/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
     sudo apt-get update;
     ```
 
-
 2. Install InvokeBuild Module
 
     ```powershell
     Install-Module InvokeBuild -Scope CurrentUser
     ```
 
-
 3. Test
 
     To run the unit tests, run the following command from the root of the repository (this will build Pode and, if needed, auto-install Pester/.NET):
@@ -135,7 +136,6 @@ If you have Pode's source code checked out locally on your machine, you can foll
     Invoke-Build Remove-Module
     ```
 
-
 ## MacOS
 
 An easy way to install the required components is to use [brew](https://brew.sh/):

docs/Tutorials/Authentication/Overview.md

@@ -16,7 +16,7 @@ The [`New-PodeAuthScheme`](../../../Functions/Authentication/New-PodeAuthScheme)
 The following schemes are supported:
 
 * [API Key](../Methods/ApiKey)
-* [Azure AD](../Methods/AzureAD)
+* [Azure AD](../Inbuilt/AzureAD)
 * [Basic](../Methods/Basic)
 * [Bearer](../Methods/Bearer)
 * [Client Certificate](../Methods/ClientCertificate)

docs/Tutorials/Endpoints/Favicon.md

@@ -0,0 +1,100 @@
+# Favicons
+
+Pode allows you to customize favicons served from HTTP/HTTPS endpoints using a set of dedicated commands. By default, Pode does not serve any favicon until one is explicitly configured using the provided favicon commands.
+
+## Overview
+
+Favicons are the small icons displayed in browser tabs, bookmarks, and other UI elements. Pode supports using favicons in the standard ICO format, as well as other common web image formats such as PNG or SVG (depending on browser support).
+
+## Managing Favicons
+
+Pode provides the following functions to manage favicons:
+
+- `Add-PodeFavicon`: Adds a favicon to one or more endpoints.
+- `Remove-PodeFavicon`: Removes the favicon from one or more endpoints.
+- `Get-PodeFavicon`: Retrieves the current favicons assigned to endpoints.
+- `Test-PodeFavicon`: Checks whether a favicon is configured on one or more endpoints.
+
+These functions support targeting specific endpoints by name, or applying changes globally to all endpoints. You can also limit operations to only endpoints marked as default using the `-DefaultEndpoint` switch.
+
+## Supported Formats
+
+Favicons are typically stored in `.ico` format but Pode also supports:
+
+- `.ico`: Multi-resolution raster format. Preferred for compatibility.
+- `.png`: Lossless compressed raster format. Supported in modern browsers.
+- `.svg`: Vector-based, resolution-independent. Supported in modern browsers with limitations.
+
+Other formats like `.jpg` or `.gif` may work but are not recommended due to lack of transparency or limited quality.
+
+For further details on favicon formats and specifications, refer to the [Favicon specification]([https://en.wikipedia.org/wiki/Favicon](https://en.wikipedia.org/wiki/Favicon)) and [RFC 5988]([https://datatracker.ietf.org/doc/html/rfc5988](https://datatracker.ietf.org/doc/html/rfc5988)).
+
+## Recommended Sizes
+
+Favicons should include multiple resolutions for optimal display across different devices. Recommended sizes include:
+
+- **16x16** : Used in browser tabs, bookmarks, and address bars.
+- **32x32** : Used in browser tabs on higher-resolution displays.
+- **48x48** : Used by some older browsers and web applications.
+- **64x64** : Generally not used by browsers but can be helpful for scalability in web apps.
+- **256x256** : Mainly for **Windows app icons** (not typically used as a favicon in browsers).
+
+## Usage Examples
+
+### Add default Pode favicon to all HTTP/S endpoints
+
+```powershell
+Add-PodeFavicon -Default
+```
+
+### Add a custom favicon from file to all endpoints
+
+```powershell
+Add-PodeFavicon -Path './assets/favicon.ico'
+```
+
+### Add a favicon to a specific endpoint using binary data
+
+```powershell
+$icon = [System.IO.File]::ReadAllBytes('C:\icons\custom.ico')
+Add-PodeFavicon -Binary $icon -EndpointName 'api'
+```
+
+### Add a favicon only to endpoints marked as default
+
+```powershell
+Add-PodeEndpoint -Address localhost -Port 8080 -Protocol Http
+$iconBytes = [System.IO.File]::ReadAllBytes("C:\path\to\custom.ico")
+Add-PodeFavicon -Binary $iconBytes -DefaultEndpoint
+```
+
+### Remove all favicons from all endpoints
+
+```powershell
+Remove-PodeFavicon
+```
+
+### Remove favicon from a specific endpoint
+
+```powershell
+Remove-PodeFavicon -EndpointName 'admin'
+```
+
+### Get all currently assigned favicons
+
+```powershell
+Get-PodeFavicon
+```
+
+### Test if a favicon exists on all default endpoints
+
+```powershell
+Test-PodeFavicon -DefaultEndpoint
+```
+
+## Notes
+
+- Only HTTP and HTTPS endpoints support favicons.
+- You can assign favicons only after endpoints are created.
+- Favicons are stored in-memory as part of the endpoint object.
+- Use `-DefaultEndpoint` with any command to target only default endpoints.

docs/Tutorials/WebSockets/Endpoints.md

@@ -2,6 +2,14 @@
 
 Pode has support for creating WebSocket endpoints, for server-to-client and/or client-to-server communications. WebSockets allow you to broadcast messages directly from your server to connected clients. This allows you to get real-time continuous updates on the frontend without having to constantly refresh the page, or by using async javascript.
 
+!!! note
+    The maximum size for WebSocket payloads in Pode depends on the version of PowerShell being used:
+
+    - For **PowerShell ≤ 6.0**, the maximum payload size is **32KB**.
+    - For **PowerShell ≥ 7.0**, the maximum payload size is **16KB**.
+
+    If a message exceeds these limits, the connection may be closed or the message may not be delivered correctly.
+
 ## Server Side
 
 ### Listening