🌟[Major]: Domeneshop API capabilities now available

[Marius Storhaug (MariusStorhaug)]

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.

---

Technical details

• Integrated PR Bump PSModule/Process-PSModule/.github/workflows/workflow.yml from 5.4.6 to 5.5.7 #11, PR ⚙️ [Maintenance]: Adopt Process-PSModule v6.1.4 and require Pester 6.x in tests #13, the preserved pull ref for PR 📖 [Docs]: README pages now use the standard module landing-page format #12, PR Add Domeneshop Context-based credential flow and initial domains command #14, and stacked PR 🩹 [Patch]: Domeneshop commands now follow module safety standards #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 Bump PSModule/Process-PSModule/.github/workflows/workflow.yml from 5.4.6 to 5.5.7 #11/PR ⚙️ [Maintenance]: Adopt Process-PSModule v6.1.4 and require Pester 6.x in tests #13 workflow overlap in favor of PR ⚙️ [Maintenance]: Adopt Process-PSModule v6.1.4 and require Pester 6.x in tests #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 Add Domeneshop Context-based credential flow and initial domains command #14 was merged explicitly before PR 🩹 [Patch]: Domeneshop commands now follow module safety standards #15; PR 🩹 [Patch]: Domeneshop commands now follow module safety standards #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 ⚙️ [Maintenance]: Adopt Process-PSModule v6.1.4 and require Pester 6.x in tests #13's exact Pester 6.x requirement to the command tests introduced by PR 🩹 [Patch]: Domeneshop commands now follow module safety standards #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.

Relevant issues (or links)

• Fixes Deliver Domeneshop API capabilities across domains, DNS, forwarding, DDNS, and invoices #2
• Bump PSModule/Process-PSModule/.github/workflows/workflow.yml from 5.4.6 to 5.5.7 #11
• 📖 [Docs]: README pages now use the standard module landing-page format #12
• ⚙️ [Maintenance]: Adopt Process-PSModule v6.1.4 and require Pester 6.x in tests #13
• Add Domeneshop Context-based credential flow and initial domains command #14
• 🩹 [Patch]: Domeneshop commands now follow module safety standards #15
• 📖 [Docs]: PowerShell module support aligned to latest LTS docs#86
• ⚙️ [Maintenance]: Module source tests align with latest PowerShell LTS Process-PSModule#419

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[Copilot]

Pull request overview

This pull request consolidates a pre-1.0 release candidate that adds authenticated Domeneshop API functionality (Context-based credentials + domain/DNS/forward/DDNS/invoice operations) and aligns CI/testing/release tooling with the Process-PSModule v6.1.4 + Pester 6.x expectations.

Changes:

• Adds Context-backed authentication flow plus private HTTP transport helpers for Domeneshop API requests.
• Introduces public commands and command-group docs for Domains, DNS, Forwards, DDNS, and Invoices.
• Reworks and expands Pester coverage (per-command tests + Pester 6.x requirement) and updates the Process-PSModule workflow pin.

Reviewed changes

Copilot reviewed 44 out of 44 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
.github/workflows/Process-PSModule.yml	Bumps reusable workflow pin to Process-PSModule v6.1.4 SHA.
README.md	Replaces template README content with a module landing/status section.
src/functions/private/Invoke-DomeneshopApiRequest.ps1	Adds authenticated REST transport helper using Basic auth from resolved context.
src/functions/private/Get-DomeneshopApiBaseUri.ps1	Validates and normalizes the API base URI from context.
src/functions/private/Auth/Get-DomeneshopConfig.ps1	Adds config retrieval with a default fallback config object.
src/functions/private/Auth/Resolve-DomeneshopContext.ps1	Adds context validation for credentials and base URI presence.
src/functions/private/Auth/Set-DomeneshopDefaultContext.ps1	Persists default context selection in the Context vault.
src/functions/public/Get-PSModuleTest.ps1	Refines the smoke-test command help/validation and output behavior.
src/functions/public/Auth/Auth.md	Adds Auth command-group documentation page.
src/functions/public/Auth/Connect-DomeneshopAccount.ps1	Adds credential storage command with optional default selection and PassThru.
src/functions/public/Auth/Get-DomeneshopContext.ps1	Adds retrieval/listing of stored contexts from the Context vault.
src/functions/public/Domains/Domains.md	Adds Domains command-group documentation page.
src/functions/public/Domains/Get-DomeneshopDomain.ps1	Adds domain listing and domain-by-ID retrieval with query escaping.
src/functions/public/Dns/Dns.md	Adds DNS command-group documentation page.
src/functions/public/Dns/Add-DomeneshopDnsRecord.ps1	Adds DNS record create (POST) command with ShouldProcess.
src/functions/public/Dns/Get-DomeneshopDnsRecord.ps1	Adds DNS record list/query and record-by-ID retrieval.
src/functions/public/Dns/Remove-DomeneshopDnsRecord.ps1	Adds DNS record delete command with ShouldProcess/ConfirmImpact.
src/functions/public/Dns/Set-DomeneshopDnsRecord.ps1	Adds DNS record replace (PUT) command with ShouldProcess.
src/functions/public/Forwards/Forwards.md	Adds Forwards command-group documentation page.
src/functions/public/Forwards/Add-DomeneshopForward.ps1	Adds HTTP forward create (POST) command with ShouldProcess.
src/functions/public/Forwards/Get-DomeneshopForward.ps1	Adds forward listing and forward-by-host retrieval with host escaping.
src/functions/public/Forwards/Remove-DomeneshopForward.ps1	Adds forward delete command with ShouldProcess/ConfirmImpact.
src/functions/public/Forwards/Set-DomeneshopForward.ps1	Adds forward replace (PUT) command with ShouldProcess and host escaping.
src/functions/public/Ddns/Ddns.md	Adds Dynamic DNS command-group documentation page.
src/functions/public/Ddns/Update-DomeneshopDdns.ps1	Adds DDNS update command building escaped query parameters and honoring WhatIf.
src/functions/public/Invoices/Invoices.md	Adds Invoices command-group documentation page.
src/functions/public/Invoices/Get-DomeneshopInvoice.ps1	Adds invoice list + invoice-by-ID retrieval.
tests/Domeneshop.TestSetup.ps1	Adds shared test setup that dot-sources functions and provides a test context.
tests/Domeneshop.Private.Tests.ps1	Adds tests for private helpers (context validation/base URI/transport auth).
tests/Connect-DomeneshopAccount.Tests.ps1	Adds Connect-DomeneshopAccount behavior tests (storage, defaulting, WhatIf, validation).
tests/Get-DomeneshopContext.Tests.ps1	Adds Get-DomeneshopContext tests (default, missing default error, listing behavior).
tests/Get-DomeneshopDomain.Tests.ps1	Adds Get-DomeneshopDomain tests (escaping, by-ID path, validation).
tests/Get-DomeneshopDnsRecord.Tests.ps1	Adds Get-DomeneshopDnsRecord tests (query escaping, by-ID path).
tests/Add-DomeneshopDnsRecord.Tests.ps1	Adds Add-DomeneshopDnsRecord tests (POST + WhatIf).
tests/Set-DomeneshopDnsRecord.Tests.ps1	Adds Set-DomeneshopDnsRecord tests (PUT + WhatIf).
tests/Remove-DomeneshopDnsRecord.Tests.ps1	Adds Remove-DomeneshopDnsRecord tests (DELETE + WhatIf).
tests/Get-DomeneshopForward.Tests.ps1	Adds Get-DomeneshopForward tests (list, escaped host).
tests/Add-DomeneshopForward.Tests.ps1	Adds Add-DomeneshopForward tests (POST + WhatIf).
tests/Set-DomeneshopForward.Tests.ps1	Adds Set-DomeneshopForward tests (PUT + WhatIf).
tests/Remove-DomeneshopForward.Tests.ps1	Adds Remove-DomeneshopForward tests (DELETE + WhatIf).
tests/Update-DomeneshopDdns.Tests.ps1	Adds Update-DomeneshopDdns tests (query escaping + WhatIf).
tests/Get-DomeneshopInvoice.Tests.ps1	Adds Get-DomeneshopInvoice tests (list and by-ID path).
tests/PSModuleTest.Tests.ps1	Removes the earlier single-file scaffold test.
tests/Get-PSModuleTest.Tests.ps1	Adds a Pester 6.x-required smoke test that dot-sources functions before invocation.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 48 out of 48 changed files in this pull request and generated 1 comment.

[github-actions]

✅ New release: PowerShell Gallery - Domeneshop 1.0.0

[github-actions]

✅ New release: GitHub - Domeneshop 1.0.0