🌟[Major]: Domeneshop API capabilities now available (#16)

Domeneshop users gain authenticated access to the module's domain, DNS,
forwarding, DDNS, and invoice capabilities through a consolidated
pre-1.0 release candidate.

## New: Domeneshop API capabilities

The module adds Context-based credential handling and commands for
querying domains, managing DNS records and forwards, updating DDNS, and
retrieving invoices. Command safety, validation, focused tests, and
command-group documentation are included in the release candidate.

## New: Guided credential setup

Running `Connect-DomeneshopAccount` without `-Secret` or its `-Key`
alias opens the Domeneshop API settings page and securely prompts for
the secret. If a browser is unavailable, the command warns and continues
to the secure prompt. Explicit string and SecureString inputs remain
supported, and `-WhatIf` does not open the browser, prompt, or change
stored contexts.

## Changed: Release tooling and documentation

The release candidate adopts Process-PSModule v6.1.13, enforces Pester
6.x across every test file, consolidates public command tests into
root-level group suites, migrates the generated documentation site to
Zensical, replaces README placeholders with the standard module landing
page, and links each public command's help to its canonical generated
documentation.

---

<details>
<summary>Technical details</summary>

- Integrated PR #11, PR #13, the preserved pull ref for PR #12, PR #14,
and stacked PR #15 in the requested order; each exact source head is
verified as an ancestor of this branch. All five source PRs are now
closed and their remote branches deleted.
- Resolved the PR #11/PR #13 workflow overlap in favor of PR #13's
Process-PSModule v6.1.4 baseline, then updated the consolidated release
to latest Process-PSModule v6.1.13 at immutable commit
`fb1bdb8fefd243292f779d2a856a38db6fe6daf4`.
- Migrated `.github/mkdocs.yml` to `.github/zensical.toml`, satisfying
v6.1.13's Zensical-only documentation pipeline.
- PR #14 was merged explicitly before PR #15; PR #15's existing ancestry
was retained, so only its four standards-hardening commits were
introduced by the later merge.
- Added an integration commit applying PR #13's exact Pester 6.x
requirement to the command tests introduced by PR #15.
- Uses the Standard test-layout profile: grouped public commands are
covered by root-level `tests/<Group>.Tests.ps1` suites (`Auth`, `Ddns`,
`Dns`, `Domains`, `Forwards`, and `Invoices`), while ungrouped and
cross-cutting suites remain separate at the root. Deterministic layout
coverage verifies every public command has a matching `Describe` block
in its expected suite.
- Added interactive credential setup as a separate micro-commit,
including the exact `https://domene.shop/admin?view=api` launch,
`Read-Host -AsSecureString`, `Key` alias, side-effect-free `-WhatIf`
behavior, and a warning-only browser fallback that preserves secure
prompting.
- Added group-aware canonical links first in all 14 public function help
blocks: `https://psmodule.io/Domeneshop/Functions/<FunctionName>/` for
ungrouped commands and
`https://psmodule.io/Domeneshop/Functions/<Group>/<FunctionName>/` for
grouped commands. Deterministic tests require the exact trailing-slash
route and reject missing, incorrect, or secondary-first links.
- Linked clearly owned private Auth helpers to the published public
commands they support while retaining useful secondary Context links.
- Requires PowerShell 7.6, the latest LTS. The generated module manifest
declares `PowerShellVersion = 7.6` and `CompatiblePSEditions = Core`;
legacy Windows PowerShell compatibility branches are intentionally
excluded.
- Rejects whitespace-only API tokens, DDNS values, DNS filters, domain
filters, forward hosts, and smoke-test names before state changes or URI
construction.
- Addressed generated-document lint, reserved context names, empty
secrets, missing context diagnostics, strict WhatIf mutation boundaries,
portable test paths, output contracts, and automated-review findings
discovered during integration.
- Local validation: 83 Pester tests pass, PSScriptAnalyzer reports zero
findings across `src` and `tests`, and `git diff --check` passes.
- Exact-head Process-PSModule v6.1.13 CI succeeds on `9834688` (run
`30180761797`), including Build-Site and all module-local suites across
Linux, macOS, and Windows.
- PSModule/docs PR #86 and Process-PSModule PR #419 are merged, making
latest-LTS support and ternary allowance effective on their default
branches.

</details>

<details>
<summary>Relevant issues (or links)</summary>

- Fixes #2
- #11
- #12
- #13
- #14
- #15
- PSModule/docs#86
- PSModule/Process-PSModule#419

</details>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: 3 people

.github/mkdocs.yml

@@ -27,6 +27,6 @@ permissions:
 
 jobs:
   Process-PSModule:
-    uses: PSModule/Process-PSModule/.github/workflows/workflow.yml@205d193f34cbbaf9992955c21d842bcf98a1859f # v5.4.6
+    uses: PSModule/Process-PSModule/.github/workflows/workflow.yml@fb1bdb8fefd243292f779d2a856a38db6fe6daf4 # v6.1.13
     secrets:
       APIKEY: ${{ secrets.APIKEY }}

.github/workflows/Process-PSModule.yml

@@ -0,0 +1,69 @@
+[project]
+site_name = "-{{ REPO_NAME }}-"
+repo_name = "-{{ REPO_OWNER }}-/-{{ REPO_NAME }}-"
+repo_url = "https://github.com/-{{ REPO_OWNER }}-/-{{ REPO_NAME }}-"
+
+[project.theme]
+variant = "classic"
+language = "en"
+logo = "Assets/icon.png"
+favicon = "Assets/icon.png"
+features = [
+    "navigation.instant",
+    "navigation.instant.progress",
+    "navigation.indexes",
+    "navigation.top",
+    "navigation.tracking",
+    "navigation.expand",
+    "search.suggest",
+    "search.highlight",
+    "content.code.copy"
+]
+
+[[project.theme.palette]]
+media = "(prefers-color-scheme)"
+toggle.icon = "lucide/sun-moon"
+toggle.name = "Switch to dark mode"
+
+[[project.theme.palette]]
+media = "(prefers-color-scheme: dark)"
+scheme = "slate"
+primary = "black"
+accent = "green"
+toggle.icon = "lucide/moon"
+toggle.name = "Switch to light mode"
+
+[[project.theme.palette]]
+media = "(prefers-color-scheme: light)"
+scheme = "default"
+primary = "indigo"
+accent = "green"
+toggle.icon = "lucide/sun"
+toggle.name = "Switch to system preference"
+
+[project.theme.icon]
+repo = "fontawesome/brands/github"
+
+[project.markdown_extensions.toc]
+permalink = true
+
+[project.markdown_extensions.attr_list]
+[project.markdown_extensions.admonition]
+[project.markdown_extensions.md_in_html]
+[project.markdown_extensions.pymdownx.details]
+[project.markdown_extensions.pymdownx.superfences]
+
+[[project.extra.social]]
+icon = "fontawesome/brands/discord"
+link = "https://discord.gg/jedJWCPAhD"
+name = "-{{ REPO_OWNER }}- on Discord"
+
+[[project.extra.social]]
+icon = "fontawesome/brands/github"
+link = "https://github.com/-{{ REPO_OWNER }}-/"
+name = "-{{ REPO_OWNER }}- on GitHub"
+
+[project.extra.consent]
+title = "Cookie consent"
+description = "We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better."
+actions = ["accept", "reject"]

.github/zensical.toml

@@ -1,69 +1,27 @@
-# {{ NAME }}
+# Domeneshop
 
-{{ DESCRIPTION }}
+Domeneshop is a PowerShell module for interacting with the Domeneshop API.
 
-## Prerequisites
+## Status
 
-This uses the following external resources:
-- The [PSModule framework](https://github.com/PSModule/Process-PSModule) for building, testing and publishing the module.
+The module provides a pre-1.0 API for storing Domeneshop credentials and working with domains, DNS records, HTTP forwards, dynamic DNS, and invoices. Command names and parameters may change before v1.0.0.
 
 ## Installation
 
-To install the module from the PowerShell Gallery, you can use the following command:
-
-```powershell
-Install-PSResource -Name {{ NAME }}
-Import-Module -Name {{ NAME }}
-```
-
-## Usage
-
-Here is a list of example that are typical use cases for the module.
-
-### Example 1: Greet an entity
-
-Provide examples for typical commands that a user would like to do with the module.
-
-```powershell
-Greet-Entity -Name 'World'
-Hello, World!
-```
-
-### Example 2
-
-Provide examples for typical commands that a user would like to do with the module.
-
 ```powershell
-Import-Module -Name PSModuleTemplate
+Install-PSResource -Name Domeneshop
+Import-Module -Name Domeneshop
 ```
 
-### Find more examples
-
-To find more examples of how to use the module, please refer to the [examples](examples) folder.
+## Commands
 
-Alternatively, you can use the Get-Command -Module 'This module' to find more commands that are available in the module.
-To find examples of each of the commands you can use Get-Help -Examples 'CommandName'.
+- [Authentication](src/functions/public/Auth/Auth.md): Store credentials and select a default context.
+- [Domains](src/functions/public/Domains/Domains.md): List domains or retrieve one by ID.
+- [DNS](src/functions/public/Dns/Dns.md): List, add, update, and remove DNS records.
+- [HTTP forwards](src/functions/public/Forwards/Forwards.md): List, add, update, and remove forwards.
+- [Dynamic DNS](src/functions/public/Ddns/Ddns.md): Update a hostname with a supplied or detected address.
+- [Invoices](src/functions/public/Invoices/Invoices.md): List invoices or retrieve one by ID.
 
 ## Documentation
 
-Link to further documentation if available, or describe where in the repository users can find more detailed documentation about
-the module's functions and features.
-
-## Contributing
-
-Coder or not, you can contribute to the project! We welcome all contributions.
-
-### For Users
-
-If you don't code, you still sit on valuable information that can make this project even better. If you experience that the
-product does unexpected things, throw errors or is missing functionality, you can help by submitting bugs and feature requests.
-Please see the issues tab on this project and submit a new issue that matches your needs.
-
-### For Developers
-
-If you do code, we'd love to have your contributions. Please read the [Contribution guidelines](CONTRIBUTING.md) for more information.
-You can either help by picking up an existing issue or submit a new one if you have an idea for a new feature or improvement.
-
-## Acknowledgements
-
-Here is a list of people and projects that helped this project in some way.
+Each public command includes PowerShell help. After importing the module, run `Get-Help <CommandName> -Full` for parameter details and examples.

README.md

@@ -0,0 +1,51 @@
+#Requires -Modules @{ ModuleName = 'Context'; ModuleVersion = '8.1.6' }
+
+function Get-DomeneshopConfig {
+    <#
+        .SYNOPSIS
+        Get the Domeneshop module configuration.
+
+        .DESCRIPTION
+        Read the module configuration from the Context vault or return an in-memory default when no configuration has been stored.
+
+        .EXAMPLE
+        Get-DomeneshopConfig
+
+        Get the current Domeneshop module configuration.
+
+        .INPUTS
+        None
+
+        You can't pipe objects to Get-DomeneshopConfig.
+
+        .OUTPUTS
+        System.Object
+
+        The stored or default Domeneshop module configuration.
+
+        .NOTES
+        This read helper does not create or update Context vault entries.
+
+        .LINK
+        https://psmodule.io/Domeneshop/Functions/Auth/Get-DomeneshopContext
+
+        .LINK
+        https://psmodule.io/Context/
+    #>
+    [OutputType([object])]
+    [CmdletBinding()]
+    param()
+
+    $vault = 'Domeneshop'
+    $id = '__Domeneshop.Config'
+    $config = Get-Context -ID $id -Vault $vault
+
+    if (-not $config) {
+        $config = [pscustomobject][ordered]@{
+            DefaultContext = $null
+            ApiBaseUri     = 'https://api.domeneshop.no/v0'
+        }
+    }
+
+    $config
+}

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

@@ -0,0 +1,55 @@
+function Resolve-DomeneshopContext {
+    <#
+        .SYNOPSIS
+        Validate a resolved Domeneshop context.
+
+        .DESCRIPTION
+        Verify that a context resolved by a public command contains the credentials and API endpoint required by private helpers.
+
+        .EXAMPLE
+        Resolve-DomeneshopContext -Context $storedContext
+
+        Validate and emit a stored Domeneshop context.
+
+        .INPUTS
+        None
+
+        You can't pipe objects to Resolve-DomeneshopContext.
+
+        .OUTPUTS
+        System.Object
+
+        The validated Domeneshop context.
+
+        .NOTES
+        This helper never selects or defaults a context. Public commands own that behavior.
+
+        .LINK
+        https://psmodule.io/Domeneshop/Functions/Auth/Get-DomeneshopContext
+
+        .LINK
+        https://psmodule.io/Context/
+    #>
+    [OutputType([object])]
+    [CmdletBinding()]
+    param(
+        # The context object selected by a public command.
+        [Parameter(Mandatory)]
+        [AllowNull()]
+        [object] $Context
+    )
+
+    if ($null -eq $Context) {
+        throw "No Domeneshop context found. Run 'Connect-DomeneshopAccount' first."
+    }
+
+    if ([string]::IsNullOrWhiteSpace([string] $Context.Token) -or -not ($Context.Secret -is [securestring])) {
+        throw "The Domeneshop context [$($Context.ID)] is missing valid credentials."
+    }
+
+    if ([string]::IsNullOrWhiteSpace([string] $Context.ApiBaseUri)) {
+        throw "The Domeneshop context [$($Context.ID)] is missing an API base URI."
+    }
+
+    $Context
+}