domeneshop-mcp 1.0.2 → 1.0.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # domeneshop-mcp
 
+## 1.0.4
+
+### Patch Changes
+
+- Update dependencies, including `@modelcontextprotocol/sdk` 1.31.0 and zod 4.6, and resolve npm audit advisories in transitive dependencies.
+
+## 1.0.3
+
+### Patch Changes
+
+- [#11](https://github.com/martinzachariassen/domeneshop-mcp/pull/11) [`fe54cb3`](https://github.com/martinzachariassen/domeneshop-mcp/commit/fe54cb30944801983814540dc4489372308d9a90) Thanks [@martinzachariassen](https://github.com/martinzachariassen)! - Refresh README structure and trim non-essential comments across the codebase.
+
 ## 1.0.2
 
 ### Patch Changes

package/README.md

@@ -1,92 +1,38 @@
-# domeneshop-mcp
+<h1 align="center">domeneshop-mcp</h1>
 
-[![CI](https://github.com/martinzachariassen/domeneshop-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/martinzachariassen/domeneshop-mcp/actions/workflows/ci.yml)
-[![npm version](https://img.shields.io/npm/v/domeneshop-mcp)](https://www.npmjs.com/package/domeneshop-mcp)
+<p align="center">
+  Manage your Domeneshop domains, DNS records, HTTP forwards and invoices from any AI assistant.
+</p>
 
-An [MCP](https://modelcontextprotocol.io) server that exposes the
-[Domeneshop API](https://api.domeneshop.no/docs/) as tools, so an AI assistant can
-manage your domains, DNS records, HTTP forwards and invoices.
+<p align="center">
+  <a href="https://github.com/martinzachariassen/domeneshop-mcp/actions/workflows/ci.yml"><img src="https://github.com/martinzachariassen/domeneshop-mcp/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/domeneshop-mcp"><img src="https://img.shields.io/npm/v/domeneshop-mcp" alt="npm version"></a>
+</p>
 
-Every operation the Domeneshop API offers is available as a tool — 15 of them,
-covering domains, DNS, HTTP forwarding, dynamic DNS and invoices.
+<p align="center">
+  <a href="https://www.npmjs.com/package/domeneshop-mcp"><b>npm package</b></a>
+  &nbsp;·&nbsp;
+  <a href="https://api.domeneshop.no/docs/"><b>Domeneshop API</b></a>
+  &nbsp;·&nbsp;
+  <a href="https://www.domeneshop.no/admin?view=api"><b>Get API credentials</b></a>
+</p>
 
-This is a standard MCP server communicating over stdio, so it works with
-**any MCP-compatible client**. That includes Claude Code,
-Claude Desktop, Cursor, VS Code (with GitHub Copilot), Codex, Windsurf, Cline,
-and anything else that speaks MCP. See [Configuration](#configuration) for
-setup in each of those, and [Tools](#tools) for everything the server can do.
+An [MCP](https://modelcontextprotocol.io) server that turns the
+[Domeneshop API](https://api.domeneshop.no/docs/) into tools an assistant can call.
+Every operation the API offers is covered — 15 tools across domains, DNS, HTTP
+forwarding, dynamic DNS and invoices.
 
-## Quick start
-
-1. Get an API token and secret from
-   [domeneshop.no/admin?view=api](https://www.domeneshop.no/admin?view=api).
-2. Register the server with your MCP client. For Claude Code:
-
-   ```sh
-   claude mcp add domeneshop \
-     --env DOMENESHOP_API_TOKEN=your-token \
-     --env DOMENESHOP_API_SECRET=your-secret \
-     -- npx -y domeneshop-mcp
-   ```
-
-That's it — ask your assistant to list your domains and it will pick up the
-new tools. This registers the server for the current project only; add
-`--scope user` to make it available everywhere. If you're using a different
-client, jump to [Configuration](#configuration) for the equivalent setup.
-
-## Contents
-
-- [Quick start](#quick-start)
-- [Requirements](#requirements)
-- [Installation](#installation)
-- [Configuration](#configuration)
-- [Tools](#tools)
-- [Notes on the Domeneshop API](#notes-on-the-domeneshop-api)
-- [Development](#development)
-- [Contributing](#contributing)
-- [Security](#security)
-- [License](#license)
-
-## Requirements
-
-- A Domeneshop account with API credentials, created at
-  [domeneshop.no/admin?view=api](https://www.domeneshop.no/admin?view=api).
-- Node.js 20 or newer.
-
-## Installation
-
-```sh
-npm install -g domeneshop-mcp
-```
-
-Or run it directly without installing, via `npx`:
-
-```sh
-npx domeneshop-mcp
-```
+It talks MCP over stdio, so it works with **any MCP-compatible client**: Claude
+Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf, Cline and others.
 
-## Configuration
-
-The server reads its credentials from two environment variables and refuses to
-start without them:
-
-| Variable | Description |
-| --- | --- |
-| `DOMENESHOP_API_TOKEN` | API token from the Domeneshop control panel |
-| `DOMENESHOP_API_SECRET` | The matching API secret |
+## Quick start
 
-It speaks MCP over stdio, so it is launched by your MCP client rather than run
-directly — `npx -y domeneshop-mcp` is the command every client below runs to
-start it. Swap in your real token and secret wherever you see the placeholders.
+You need Node.js 20 or newer and a Domeneshop account.
 
-Most clients also let you scope a server to just the current project (private,
-or shared with your team via a file checked into version control) or make it
-available everywhere on your machine — usually by picking which config file
-you write to. Each client below notes this where it applies; Claude Desktop
-and Codex only have a single, machine-wide config file.
+**1. Create an API token and secret** at
+[domeneshop.no/admin?view=api](https://www.domeneshop.no/admin?view=api).
 
-<details>
-<summary><strong>Claude Code</strong></summary>
+**2. Register the server.** In Claude Code:
 
 ```sh
 claude mcp add domeneshop \
@@ -95,29 +41,22 @@ claude mcp add domeneshop \
   -- npx -y domeneshop-mcp
 ```
 
-This defaults to `--scope local` (private to you, only in this project). Use
-`--scope project` to write it to `<your-project>/.mcp.json` instead (shared via
-version control — see the block below), or `--scope user` for every project on
-your account.
+**3. Ask for something.** "List my domains" is enough to confirm the tools loaded.
 
-If you'd rather not resolve the package via `npx` on every launch, install it
-once and point Claude Code at the binary directly:
+Using a different client? See [Client setup](#client-setup) below.
 
-```sh
-npm install -g domeneshop-mcp
-claude mcp add domeneshop \
-  --env DOMENESHOP_API_TOKEN=your-token \
-  --env DOMENESHOP_API_SECRET=your-secret \
-  -- domeneshop-mcp
-```
+## Client setup
 
-You can also add it from raw JSON:
+The server is launched by your client rather than run by hand, and reads its
+credentials from two environment variables:
 
-```sh
-claude mcp add-json domeneshop '{"command":"npx","args":["-y","domeneshop-mcp"],"env":{"DOMENESHOP_API_TOKEN":"your-token","DOMENESHOP_API_SECRET":"your-secret"}}'
-```
+| Variable | Description |
+| --- | --- |
+| `DOMENESHOP_API_TOKEN` | API token from the Domeneshop control panel |
+| `DOMENESHOP_API_SECRET` | The matching API secret |
 
-Or, for `--scope project`, edit `<your-project>/.mcp.json` directly:
+Most clients take the same **standard config**. Swap in your real token and
+secret wherever you see the placeholders.
 
 ```json
 {
@@ -134,12 +73,33 @@ Or, for `--scope project`, edit `<your-project>/.mcp.json` directly:
 }
 ```
 
+Most clients can also scope a server to the current project or make it
+available everywhere, usually by choosing which config file you write to. The
+blocks below note this where it applies.
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+Use the CLI command from [Quick start](#quick-start). It defaults to
+`--scope local`, private to you and this project. Use `--scope project` to
+write `<your-project>/.mcp.json` instead, shared via version control, or
+`--scope user` for every project on your account.
+
+You can also pass the standard config as raw JSON:
+
+```sh
+claude mcp add-json domeneshop '{"command":"npx","args":["-y","domeneshop-mcp"],"env":{"DOMENESHOP_API_TOKEN":"your-token","DOMENESHOP_API_SECRET":"your-secret"}}'
+```
+
+Or write the standard config straight into `<your-project>/.mcp.json`.
+
 </details>
 
 <details>
 <summary><strong>Claude Desktop</strong></summary>
 
-Edit `claude_desktop_config.json` (Settings → Developer → Edit Config), found at:
+Add the standard config to `claude_desktop_config.json`, reachable from
+Settings → Developer → Edit Config:
 
 | Platform | Full path |
 | --- | --- |
@@ -147,27 +107,12 @@ Edit `claude_desktop_config.json` (Settings → Developer → Edit Config), foun
 | Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
 | Linux (unofficial builds) | `~/.config/Claude/claude_desktop_config.json` |
 
-```json
-{
-  "mcpServers": {
-    "domeneshop": {
-      "command": "npx",
-      "args": ["-y", "domeneshop-mcp"],
-      "env": {
-        "DOMENESHOP_API_TOKEN": "your-token",
-        "DOMENESHOP_API_SECRET": "your-secret"
-      }
-    }
-  }
-}
-```
-
 </details>
 
 <details>
 <summary><strong>Cursor</strong></summary>
 
-Add the same `mcpServers` block to a `mcp.json` file, found at:
+Add the standard config to an `mcp.json` file:
 
 | Scope | Full path |
 | --- | --- |
@@ -175,28 +120,13 @@ Add the same `mcpServers` block to a `mcp.json` file, found at:
 | Every project (macOS/Linux) | `~/.cursor/mcp.json` |
 | Every project (Windows) | `%USERPROFILE%\.cursor\mcp.json` |
 
-```json
-{
-  "mcpServers": {
-    "domeneshop": {
-      "command": "npx",
-      "args": ["-y", "domeneshop-mcp"],
-      "env": {
-        "DOMENESHOP_API_TOKEN": "your-token",
-        "DOMENESHOP_API_SECRET": "your-secret"
-      }
-    }
-  }
-}
-```
-
 </details>
 
 <details>
 <summary><strong>VS Code (GitHub Copilot)</strong></summary>
 
-VS Code uses a `servers` key instead of `mcpServers`. For this project only,
-add it to `<your-project>/.vscode/mcp.json`:
+VS Code uses a `servers` key instead of `mcpServers`, and wants an explicit
+`type`. For this project only, add it to `<your-project>/.vscode/mcp.json`:
 
 ```json
 {
@@ -215,8 +145,7 @@ add it to `<your-project>/.vscode/mcp.json`:
 ```
 
 For every project, run the command palette action **MCP: Open User
-Configuration** and add the same block there — or register it in one line
-from a terminal:
+Configuration** and add the same block there, or register it in one line:
 
 ```sh
 code --add-mcp '{"name":"domeneshop","command":"npx","args":["-y","domeneshop-mcp"],"env":{"DOMENESHOP_API_TOKEN":"your-token","DOMENESHOP_API_SECRET":"your-secret"}}'
@@ -227,7 +156,7 @@ code --add-mcp '{"name":"domeneshop","command":"npx","args":["-y","domeneshop-mc
 <details>
 <summary><strong>Codex</strong></summary>
 
-Codex CLI reads MCP servers from `mcp_servers` in its config file, found at:
+Codex CLI reads MCP servers from `mcp_servers` in its config file:
 
 | Platform | Full path |
 | --- | --- |
@@ -241,58 +170,105 @@ args = ["-y", "domeneshop-mcp"]
 env = { DOMENESHOP_API_TOKEN = "your-token", DOMENESHOP_API_SECRET = "your-secret" }
 ```
 
-Or register it from the command line:
-
-```sh
-codex mcp add domeneshop -- npx -y domeneshop-mcp
-```
-
-Then set the two env vars in the `[mcp_servers.domeneshop]` block it creates,
-since `codex mcp add` doesn't take them as flags.
+`codex mcp add domeneshop -- npx -y domeneshop-mcp` registers it from the
+command line, but takes no env flags, so set the two variables in the
+`[mcp_servers.domeneshop]` block it creates.
 
 </details>
 
 <details>
 <summary><strong>Any other MCP client</strong></summary>
 
-Any client that supports MCP servers over stdio can run this server — Windsurf,
-Cline, Continue, LM Studio, or a client you've built yourself with the MCP SDK.
-Most follow the same `mcpServers`-with-`command`/`args`/`env` shape used above
-for Claude Desktop and Cursor; check your client's documentation for the exact
-config file and key name, then point it at:
+Windsurf, Cline, Continue, LM Studio and anything else that runs MCP servers
+over stdio will work. Most use the same shape as the standard config above;
+check your client's documentation for the config file and key name, then point
+it at:
 
 - **command**: `npx`
 - **args**: `["-y", "domeneshop-mcp"]`
 - **env**: `DOMENESHOP_API_TOKEN` and `DOMENESHOP_API_SECRET`
 
-If your client can't run `npx` directly, install the package globally with
-`npm install -g domeneshop-mcp` and use `domeneshop-mcp` as the command with no
-args instead.
+</details>
+
+<details>
+<summary><strong>Skipping npx</strong></summary>
+
+To avoid resolving the package on every launch, install it once and use
+`domeneshop-mcp` as the command with no args:
+
+```sh
+npm install -g domeneshop-mcp
+```
 
 </details>
 
+## What you can ask for
+
+| Area | Example prompt |
+| --- | --- |
+| Domains | "Which domains are on my account, and when do they renew?" |
+| DNS | "Show every DNS record for example.no" |
+| DNS | "Point blog.example.no at 203.0.113.10" |
+| DNS | "Add the TXT record Google gave me for domain verification" |
+| DNS | "Set up Fastmail's MX records on example.no" |
+| Forwarding | "Forward old.example.no to https://example.no" |
+| Dynamic DNS | "Update home.example.no to my current IP" |
+| Invoices | "List my unpaid Domeneshop invoices" |
+
 ## Tools
 
-Read-only tools are annotated as such, and the tools that overwrite or delete
-state are marked destructive, so clients can decide what to run without asking
-you first.
+Every tool declares MCP annotations, so clients know which ones are safe to run
+without asking you first. The Access column below mirrors those annotations.
 
 ### Domains
 
-| Tool | Description |
-| --- | --- |
-| `list_domains` | List all domains on the account, optionally filtered by name |
-| `get_domain` | Get a single domain by its Domeneshop domain ID |
+| Tool | Access | Description |
+| --- | --- | --- |
+| `list_domains` | Read-only | List all domains on the account, optionally filtered by name |
+| `get_domain` | Read-only | Get a single domain by its Domeneshop domain ID |
 
 ### DNS
 
-| Tool | Description |
-| --- | --- |
-| `list_dns_records` | List a domain's records, optionally filtered by host and type |
-| `get_dns_record` | Get a single record by ID |
-| `create_dns_record` | Create a record |
-| `update_dns_record` | Replace a record (destructive — see the note below) |
-| `delete_dns_record` | Delete a record |
+| Tool | Access | Description |
+| --- | --- | --- |
+| `list_dns_records` | Read-only | List a domain's records, optionally filtered by host and type |
+| `get_dns_record` | Read-only | Get a single record by ID |
+| `create_dns_record` | Adds | Create a record |
+| `update_dns_record` | Overwrites | Replace a record — see the warning below |
+| `delete_dns_record` | Deletes | Delete a record |
+
+> **Heads up:** `update_dns_record` replaces the whole record rather than
+> patching it. Any field left out is dropped, and omitting `ttl` resets it to
+> the default 3600 seconds. Read the record first if you are only changing part
+> of it.
+
+### HTTP forwarding
+
+| Tool | Access | Description |
+| --- | --- | --- |
+| `list_forwards` | Read-only | List a domain's HTTP forwards |
+| `get_forward` | Read-only | Get the forward for one host |
+| `create_forward` | Adds | Create a forward |
+| `update_forward` | Overwrites | Update a forward |
+| `delete_forward` | Deletes | Delete a forward |
+
+### Dynamic DNS
+
+| Tool | Access | Description |
+| --- | --- | --- |
+| `update_dyndns` | Overwrites | Point a hostname at a given IP, or at the caller's apparent IP |
+
+### Invoices
+
+| Tool | Access | Description |
+| --- | --- | --- |
+| `list_invoices` | Read-only | List invoices from the past three years, optionally filtered by status |
+| `get_invoice` | Read-only | Get a single invoice |
+
+## Reference
+
+<details>
+<summary><strong>Supported DNS record types</strong></summary>
 
 All eleven record types Domeneshop accepts are supported, with their
 type-specific fields:
@@ -306,34 +282,13 @@ type-specific fields:
 | `DS` | `tag`, `alg`, `digest` |
 | `CAA` | `flags`, `tag` |
 
-`update_dns_record` replaces the whole record rather than patching it: any field
-left out is dropped, and omitting `ttl` resets it to the default 3600 seconds.
-Read the record first if you are only changing part of it.
-
-### HTTP forwarding
-
-| Tool | Description |
-| --- | --- |
-| `list_forwards` | List a domain's HTTP forwards |
-| `get_forward` | Get the forward for one host |
-| `create_forward` | Create a forward |
-| `update_forward` | Update a forward |
-| `delete_forward` | Delete a forward |
-
-### Dynamic DNS
-
-| Tool | Description |
-| --- | --- |
-| `update_dyndns` | Point a hostname at a given IP, or at the caller's apparent IP |
-
-### Invoices
+The `tag` field is deliberately untyped: it is a numeric key tag for `DS` and a
+property tag such as `issue` for `CAA`, and Domeneshop documents neither.
 
-| Tool | Description |
-| --- | --- |
-| `list_invoices` | List invoices from the past three years, optionally filtered by status |
-| `get_invoice` | Get a single invoice |
+</details>
 
-## Notes on the Domeneshop API
+<details>
+<summary><strong>Undocumented Domeneshop API behaviour</strong></summary>
 
 A few things this server relies on are not in Domeneshop's published OpenAPI
 spec, but are supported and used by their own client libraries:
@@ -347,8 +302,7 @@ spec, but are supported and used by their own client libraries:
   only in the `Location` header.
 - `GET /dyndns/update` answers with a plain-text status line, not JSON.
 
-The `tag` field is deliberately untyped: it is a numeric key tag for `DS` and a
-property tag such as `issue` for `CAA`, and Domeneshop documents neither.
+</details>
 
 ## Development
 
@@ -366,7 +320,8 @@ The tests stub the Domeneshop API with a local `node:http` server and drive the
 MCP server over an in-memory transport, so they need no credentials and make no
 network calls.
 
-### Project layout
+<details>
+<summary><strong>Project layout</strong></summary>
 
 ```
 src/
@@ -378,6 +333,8 @@ test/
   mcp/              End-to-end tool tests, against an in-memory MCP transport
 ```
 
+</details>
+
 ## Contributing
 
 Issues and pull requests are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md)

package/dist/domeneshop/assert.d.ts

@@ -1,9 +1,2 @@
-/**
- * Asserts that a value is defined, narrowing it and throwing otherwise.
- *
- * Used after requests that the Domeneshop API guarantees a body for on
- * success (single-resource GETs, creates and updates), so callers get a
- * concrete type instead of threading `| undefined` through the client.
- */
 export declare function assertDefined<T>(value: T | undefined, message: string): T;
 //# sourceMappingURL=assert.d.ts.map

package/dist/domeneshop/assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/domeneshop/assert.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAKzE"}
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/domeneshop/assert.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAKzE"}

package/dist/domeneshop/assert.js

@@ -1,10 +1,3 @@
-/**
- * Asserts that a value is defined, narrowing it and throwing otherwise.
- *
- * Used after requests that the Domeneshop API guarantees a body for on
- * success (single-resource GETs, creates and updates), so callers get a
- * concrete type instead of threading `| undefined` through the client.
- */
 export function assertDefined(value, message) {
     if (value === undefined) {
         throw new Error(message);

package/dist/domeneshop/assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/domeneshop/assert.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAI,KAAoB,EAAE,OAAe;IACpE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/domeneshop/assert.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAI,KAAoB,EAAE,OAAe;IACpE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/domeneshop/client.d.ts

@@ -4,14 +4,9 @@ import { DynDnsResource } from "./resources/dyndns.js";
 import { ForwardsResource } from "./resources/forwards.js";
 import { InvoicesResource } from "./resources/invoices.js";
 export interface DomeneshopClientOptions {
-    /** Overrides the API base URL. Intended for tests. */
     baseUrl?: string;
 }
-/**
- * A Domeneshop API client (https://api.domeneshop.no/docs/), authenticated
- * via HTTP Basic Auth using an API token and secret from
- * https://www.domeneshop.no/admin?view=api.
- */
+/** Authenticate with a token/secret pair from https://www.domeneshop.no/admin?view=api. */
 export declare class DomeneshopClient {
     readonly domains: DomainsResource;
     readonly dns: DnsResource;

package/dist/domeneshop/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/domeneshop/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;gBAExB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B;CAQjF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/domeneshop/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2FAA2F;AAC3F,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;gBAExB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B;CAQjF"}

package/dist/domeneshop/client.js

@@ -4,11 +4,7 @@ import { DomainsResource } from "./resources/domains.js";
 import { DynDnsResource } from "./resources/dyndns.js";
 import { ForwardsResource } from "./resources/forwards.js";
 import { InvoicesResource } from "./resources/invoices.js";
-/**
- * A Domeneshop API client (https://api.domeneshop.no/docs/), authenticated
- * via HTTP Basic Auth using an API token and secret from
- * https://www.domeneshop.no/admin?view=api.
- */
+/** Authenticate with a token/secret pair from https://www.domeneshop.no/admin?view=api. */
 export class DomeneshopClient {
     domains;
     dns;

package/dist/domeneshop/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/domeneshop/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAO3D;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IAClB,OAAO,CAAkB;IACzB,GAAG,CAAc;IACjB,QAAQ,CAAmB;IAC3B,MAAM,CAAiB;IACvB,QAAQ,CAAmB;IAEpC,YAAY,KAAa,EAAE,MAAc,EAAE,UAAmC,EAAE;QAC9E,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACpE,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG,GAAG,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/domeneshop/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAM3D,2FAA2F;AAC3F,MAAM,OAAO,gBAAgB;IAClB,OAAO,CAAkB;IACzB,GAAG,CAAc;IACjB,QAAQ,CAAmB;IAC3B,MAAM,CAAiB;IACvB,QAAQ,CAAmB;IAEpC,YAAY,KAAa,EAAE,MAAc,EAAE,UAAmC,EAAE;QAC9E,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACpE,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG,GAAG,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/domeneshop/http.d.ts

@@ -1,40 +1,19 @@
-/**
- * Minimal HTTP transport for the Domeneshop API
- * (https://api.domeneshop.no/docs/), authenticated via HTTP Basic Auth using
- * an API token and secret from https://www.domeneshop.no/admin?view=api.
- */
-/** Thrown for non-2xx responses from the Domeneshop API. */
 export declare class DomeneshopApiError extends Error {
     readonly statusCode: number;
     readonly body: string;
     constructor(statusCode: number, body: string);
 }
 export interface RequestOptions {
-    /** Query parameters. Undefined and empty-string values are omitted. */
     query?: Record<string, string | undefined>;
-    /** Request body, marshalled as JSON. */
     body?: unknown;
-    /**
-     * Whether to parse the response body as JSON. Defaults to true; set to
-     * false for endpoints that return a non-JSON (or irrelevant) body, such
-     * as the dynamic DNS update protocol's plain-text response.
-     */
+    /** Set false for endpoints with a non-JSON body, e.g. the dynamic DNS update protocol. */
     decodeJson?: boolean;
 }
 export interface ApiResponse<T> {
-    /** The parsed JSON response body, or undefined if the response was empty. */
     data: T | undefined;
-    /**
-     * The raw response headers. Some endpoints report their result there
-     * rather than in the body — see ForwardsResource.create.
-     */
+    /** Some endpoints report their result here rather than in the body — see ForwardsResource.create. */
     headers: Headers;
 }
-/**
- * HttpTransport performs authenticated HTTP requests against the Domeneshop
- * API and decodes JSON responses. It has no knowledge of individual
- * endpoints; that lives in the resource classes built on top of it.
- */
 export declare class HttpTransport {
     private readonly baseUrl;
     private readonly authorization;

package/dist/domeneshop/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/domeneshop/http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,4DAA4D;AAC5D,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAU7C;AAED,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3C,wCAAwC;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,6EAA6E;IAC7E,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAyB;IAKvE,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CA8B3B"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/domeneshop/http.ts"],"names":[],"mappings":"AAEA,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAU7C;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0FAA0F;IAC1F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,qGAAqG;IACrG,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAyB;IAKvE,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CA8B3B"}

package/dist/domeneshop/http.js

@@ -1,10 +1,4 @@
-/**
- * Minimal HTTP transport for the Domeneshop API
- * (https://api.domeneshop.no/docs/), authenticated via HTTP Basic Auth using
- * an API token and secret from https://www.domeneshop.no/admin?view=api.
- */
 const DEFAULT_BASE_URL = "https://api.domeneshop.no/v0";
-/** Thrown for non-2xx responses from the Domeneshop API. */
 export class DomeneshopApiError extends Error {
     statusCode;
     body;
@@ -17,11 +11,6 @@ export class DomeneshopApiError extends Error {
         this.body = body;
     }
 }
-/**
- * HttpTransport performs authenticated HTTP requests against the Domeneshop
- * API and decodes JSON responses. It has no knowledge of individual
- * endpoints; that lives in the resource classes built on top of it.
- */
 export class HttpTransport {
     baseUrl;
     authorization;