Add Domeneshop context auth flow

Store Domeneshop API credentials with Context and add a first authenticated domains command with a shared request helper.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: MariusStorhaug

src/functions/private/Auth/Get-DomeneshopConfig.ps1

@@ -0,0 +1,19 @@
+function Get-DomeneshopConfig {
+    [CmdletBinding()]
+    param()
+
+    $vault = 'Domeneshop'
+    $id = '__Domeneshop.Config'
+    $config = Get-Context -ID $id -Vault $vault -ErrorAction SilentlyContinue
+
+    if (-not $config) {
+        $config = [ordered]@{
+            DefaultContext = $null
+            ApiBaseUri     = 'https://api.domeneshop.no/v0'
+        }
+        Set-Context -ID $id -Vault $vault -Context $config
+        $config = Get-Context -ID $id -Vault $vault
+    }
+
+    $config
+}

src/functions/private/Auth/Resolve-DomeneshopContext.ps1

@@ -0,0 +1,23 @@
+function Resolve-DomeneshopContext {
+    [CmdletBinding()]
+    param(
+        [Parameter()]
+        [string] $Context
+    )
+
+    $resolvedContext = if ($Context) {
+        Get-DomeneshopContext -Context $Context
+    } else {
+        Get-DomeneshopContext
+    }
+
+    if (-not $resolvedContext) {
+        throw "No Domeneshop context found. Run 'Connect-DomeneshopAccount' first."
+    }
+
+    if ([string]::IsNullOrEmpty($resolvedContext.Token) -or -not ($resolvedContext.Secret -is [securestring])) {
+        throw "The Domeneshop context [$($resolvedContext.ID)] is missing valid credentials."
+    }
+
+    $resolvedContext
+}

src/functions/private/Auth/Set-DomeneshopDefaultContext.ps1

@@ -0,0 +1,11 @@
+function Set-DomeneshopDefaultContext {
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory)]
+        [string] $Context
+    )
+
+    $config = Get-DomeneshopConfig
+    $config.DefaultContext = $Context
+    Set-Context -ID '__Domeneshop.Config' -Vault 'Domeneshop' -Context $config
+}

src/functions/private/Invoke-DomeneshopApiRequest.ps1

@@ -0,0 +1,37 @@
+function Invoke-DomeneshopApiRequest {
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory)]
+        [ValidateSet('Get', 'Post', 'Put', 'Delete')]
+        [string] $Method,
+
+        [Parameter(Mandatory)]
+        [string] $Uri,
+
+        [Parameter(Mandatory)]
+        [object] $Context,
+
+        [Parameter()]
+        [AllowNull()]
+        [object] $Body
+    )
+
+    $credential = [pscredential]::new(
+        [string] $Context.Token,
+        [securestring] $Context.Secret
+    )
+
+    $params = @{
+        Method         = $Method
+        Uri            = $Uri
+        Authentication = 'Basic'
+        Credential     = $credential
+    }
+
+    if ($PSBoundParameters.ContainsKey('Body')) {
+        $params['ContentType'] = 'application/json'
+        $params['Body'] = ($Body | ConvertTo-Json -Depth 100)
+    }
+
+    Invoke-RestMethod @params
+}

src/functions/public/Auth/Connect-DomeneshopAccount.ps1

@@ -0,0 +1,56 @@
+function Connect-DomeneshopAccount {
+    <#
+        .SYNOPSIS
+        Stores Domeneshop API credentials in a secure context.
+
+        .DESCRIPTION
+        Stores Domeneshop API credentials using the Context module and optionally sets the context as default.
+
+        .EXAMPLE
+        Connect-DomeneshopAccount -Token 'my-token' -Secret (Read-Host -AsSecureString)
+    #>
+    [OutputType([object])]
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory)]
+        [string] $Token,
+
+        [Parameter(Mandatory)]
+        [object] $Secret,
+
+        [Parameter()]
+        [string] $Context = 'default',
+
+        [Parameter()]
+        [switch] $Default,
+
+        [Parameter()]
+        [switch] $PassThru
+    )
+
+    $secureSecret = switch ($Secret) {
+        { $_ -is [securestring] } { $_; break }
+        { $_ -is [string] } { ConvertTo-SecureString -AsPlainText $Secret -Force; break }
+        default { throw 'Secret must be a SecureString or String value.' }
+    }
+
+    $contextObject = [ordered]@{
+        Name        = $Context
+        Token       = $Token
+        Secret      = $secureSecret
+        AuthType    = 'BasicAuth'
+        ApiBaseUri  = 'https://api.domeneshop.no/v0'
+        ConnectedAt = Get-Date
+    }
+
+    Set-Context -ID $Context -Vault 'Domeneshop' -Context $contextObject
+
+    $config = Get-DomeneshopConfig
+    if ($Default -or [string]::IsNullOrEmpty($config.DefaultContext)) {
+        Set-DomeneshopDefaultContext -Context $Context
+    }
+
+    if ($PassThru) {
+        Get-DomeneshopContext -Context $Context
+    }
+}

src/functions/public/Auth/Get-DomeneshopContext.ps1

@@ -0,0 +1,35 @@
+function Get-DomeneshopContext {
+    <#
+        .SYNOPSIS
+        Gets stored Domeneshop contexts.
+
+        .DESCRIPTION
+        Returns one or more contexts stored in the Domeneshop context vault.
+
+        .EXAMPLE
+        Get-DomeneshopContext
+    #>
+    [OutputType([object])]
+    [CmdletBinding(DefaultParameterSetName = 'GetDefault')]
+    param(
+        [Parameter(Mandatory, ParameterSetName = 'GetNamed')]
+        [string] $Context,
+
+        [Parameter(Mandatory, ParameterSetName = 'ListAvailable')]
+        [switch] $ListAvailable
+    )
+
+    $id = switch ($PSCmdlet.ParameterSetName) {
+        'GetNamed' { $Context; break }
+        'ListAvailable' { '*'; break }
+        default {
+            $config = Get-DomeneshopConfig
+            if ([string]::IsNullOrEmpty($config.DefaultContext)) {
+                throw "No default Domeneshop context found. Run 'Connect-DomeneshopAccount' first."
+            }
+            $config.DefaultContext
+        }
+    }
+
+    Get-Context -ID $id -Vault 'Domeneshop' | Where-Object { $_.ID -ne '__Domeneshop.Config' } | Sort-Object -Property ID
+}

src/functions/public/Domains/Get-DomeneshopDomain.ps1

@@ -0,0 +1,38 @@
+function Get-DomeneshopDomain {
+    <#
+        .SYNOPSIS
+        Lists Domeneshop domains.
+
+        .DESCRIPTION
+        Uses the stored Domeneshop context credentials and calls the /domains endpoint.
+
+        .EXAMPLE
+        Get-DomeneshopDomain
+
+        .EXAMPLE
+        Get-DomeneshopDomain -Domain '.no'
+    #>
+    [OutputType([object[]])]
+    [CmdletBinding()]
+    param(
+        [Parameter()]
+        [string] $Domain,
+
+        [Parameter()]
+        [string] $Context
+    )
+
+    $resolvedContext = Resolve-DomeneshopContext -Context $Context
+    $apiBaseUri = [string] $resolvedContext.ApiBaseUri
+    if ([string]::IsNullOrEmpty($apiBaseUri)) {
+        $apiBaseUri = 'https://api.domeneshop.no/v0'
+    }
+
+    $uri = "$apiBaseUri/domains"
+    if ($Domain) {
+        $encodedDomain = [uri]::EscapeDataString($Domain)
+        $uri = "${uri}?domain=$encodedDomain"
+    }
+
+    Invoke-DomeneshopApiRequest -Method Get -Uri $uri -Context $resolvedContext
+}