domeneshop-mcp 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# domeneshop-mcp
+
+## 1.0.0
+
+Initial public release: an MCP server exposing the Domeneshop API (domains,
+DNS records, HTTP forwards, dynamic DNS and invoices) as 15 tools.
+
+Future releases are documented here automatically by
+[Changesets](https://github.com/changesets/changesets) — see
+`.changeset/README.md` for the workflow.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Martin Zachariassen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,223 @@
+# domeneshop-mcp
+
+[![CI](https://github.com/martinzachariassen/domeneshop-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/martinzachariassen/domeneshop-mcp/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/github/license/martinzachariassen/domeneshop-mcp)](LICENSE)
+
+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.
+
+Every operation the Domeneshop API offers is available as a tool — 15 of them,
+covering 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 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 Claude to list your domains and it will pick up the new
+tools. This registers the server for the current project only; add `-s user`
+to make it available everywhere. See [Configuration](#configuration) for
+Claude Desktop and other MCP clients, and [Tools](#tools) for everything the
+server can do.
+
+## 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
+```
+
+## 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 |
+
+It speaks MCP over stdio, so it is launched by your MCP client rather than run
+directly.
+
+### Claude Code
+
+```sh
+claude mcp add domeneshop \
+  --env DOMENESHOP_API_TOKEN=your-token \
+  --env DOMENESHOP_API_SECRET=your-secret \
+  -- npx -y domeneshop-mcp
+```
+
+### Claude Desktop and other clients
+
+Add the server to your client's MCP configuration — for Claude Desktop that is
+`claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "domeneshop": {
+      "command": "npx",
+      "args": ["-y", "domeneshop-mcp"],
+      "env": {
+        "DOMENESHOP_API_TOKEN": "your-token",
+        "DOMENESHOP_API_SECRET": "your-secret"
+      }
+    }
+  }
+}
+```
+
+## 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.
+
+### 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 |
+
+### 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 |
+
+All eleven record types Domeneshop accepts are supported, with their
+type-specific fields:
+
+| Type | Fields beyond `host`, `data` and `ttl` |
+| --- | --- |
+| `A`, `AAAA`, `ANAME`, `CNAME`, `NS`, `TXT` | — |
+| `MX` | `priority` |
+| `SRV` | `priority`, `weight`, `port` |
+| `TLSA` | `usage`, `selector`, `dtype` |
+| `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
+
+| Tool | Description |
+| --- | --- |
+| `list_invoices` | List invoices from the past three years, optionally filtered by status |
+| `get_invoice` | Get a single invoice |
+
+## Notes on the Domeneshop API
+
+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:
+
+- The spec documents seven record types; `ANAME`, `CAA`, `DS` and `NS` work too,
+  as the record validation in
+  [domeneshop.js](https://github.com/domeneshop/domeneshop.js) and
+  [python-domeneshop](https://github.com/domeneshop/python-domeneshop) shows.
+- `GET /invoices` accepts a `status` filter, which domeneshop.js uses.
+- `POST /forwards/` answers `201` with an empty body and names the new forward
+  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.
+
+## Development
+
+```sh
+npm install          # install dependencies
+npm run dev          # run the server from source with tsx
+npm run build        # compile to ./dist
+npm run typecheck    # type-check without emitting
+npm run lint         # lint with Biome
+npm run format       # format with Biome
+npm test             # run the test suite (vitest)
+```
+
+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
+
+```
+src/
+  domeneshop/       Domeneshop API client (HTTP transport + one resource per endpoint group)
+  mcp/              MCP server: tool registration, schemas, result/error helpers
+  index.ts          CLI entry point
+test/
+  domeneshop/       Client tests, against a local HTTP server
+  mcp/              End-to-end tool tests, against an in-memory MCP transport
+```
+
+## Contributing
+
+Issues and pull requests are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md)
+for the development workflow and changelog conventions.
+
+## Security
+
+See [SECURITY.md](SECURITY.md) for how to report a vulnerability.
+
+## License
+
+[MIT](LICENSE)

package/dist/domeneshop/assert.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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

@@ -0,0 +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"}

package/dist/domeneshop/assert.js

@@ -0,0 +1,14 @@
+/**
+ * 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);
+    }
+    return value;
+}
+//# sourceMappingURL=assert.js.map

package/dist/domeneshop/assert.js.map

@@ -0,0 +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"}

package/dist/domeneshop/client.d.ts

@@ -0,0 +1,23 @@
+import { DnsResource } from "./resources/dns.js";
+import { DomainsResource } from "./resources/domains.js";
+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.
+ */
+export declare class DomeneshopClient {
+    readonly domains: DomainsResource;
+    readonly dns: DnsResource;
+    readonly forwards: ForwardsResource;
+    readonly dynDns: DynDnsResource;
+    readonly invoices: InvoicesResource;
+    constructor(token: string, secret: string, options?: DomeneshopClientOptions);
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +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"}

package/dist/domeneshop/client.js

@@ -0,0 +1,27 @@
+import { HttpTransport } from "./http.js";
+import { DnsResource } from "./resources/dns.js";
+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.
+ */
+export class DomeneshopClient {
+    domains;
+    dns;
+    forwards;
+    dynDns;
+    invoices;
+    constructor(token, secret, options = {}) {
+        const transport = new HttpTransport(token, secret, options.baseUrl);
+        this.domains = new DomainsResource(transport);
+        this.dns = new DnsResource(transport);
+        this.forwards = new ForwardsResource(transport);
+        this.dynDns = new DynDnsResource(transport);
+        this.invoices = new InvoicesResource(transport);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/domeneshop/client.js.map

@@ -0,0 +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"}

package/dist/domeneshop/http.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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.
+     */
+    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.
+     */
+    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;
+    constructor(token: string, secret: string, baseUrl?: string);
+    request<T>(method: string, path: string, options?: RequestOptions): Promise<ApiResponse<T>>;
+}
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +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"}

package/dist/domeneshop/http.js

@@ -0,0 +1,58 @@
+/**
+ * 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;
+    constructor(statusCode, body) {
+        super(body
+            ? `domeneshop: unexpected status ${String(statusCode)}: ${body}`
+            : `domeneshop: unexpected status ${String(statusCode)}`);
+        this.name = "DomeneshopApiError";
+        this.statusCode = statusCode;
+        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;
+    constructor(token, secret, baseUrl = DEFAULT_BASE_URL) {
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.authorization = `Basic ${Buffer.from(`${token}:${secret}`).toString("base64")}`;
+    }
+    async request(method, path, options = {}) {
+        const url = new URL(this.baseUrl + path);
+        for (const [key, value] of Object.entries(options.query ?? {})) {
+            if (value !== undefined && value !== "") {
+                url.searchParams.set(key, value);
+            }
+        }
+        const headers = new Headers({
+            Accept: "application/json",
+            Authorization: this.authorization,
+        });
+        const init = { method, headers };
+        if (options.body !== undefined) {
+            init.body = JSON.stringify(options.body);
+            headers.set("Content-Type", "application/json");
+        }
+        const response = await fetch(url, init);
+        const text = await response.text();
+        if (!response.ok) {
+            throw new DomeneshopApiError(response.status, text);
+        }
+        const decodeJson = options.decodeJson ?? true;
+        const data = decodeJson && text.length > 0 ? JSON.parse(text) : undefined;
+        return { data, headers: response.headers };
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/domeneshop/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/domeneshop/http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAExD,4DAA4D;AAC5D,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,UAAU,CAAS;IACnB,IAAI,CAAS;IAEtB,YAAY,UAAkB,EAAE,IAAY;QAC1C,KAAK,CACH,IAAI;YACF,CAAC,CAAC,iCAAiC,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE;YAChE,CAAC,CAAC,iCAAiC,MAAM,CAAC,UAAU,CAAC,EAAE,CAC1D,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAyBD;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACP,OAAO,CAAS;IAChB,aAAa,CAAS;IAEvC,YAAY,KAAa,EAAE,MAAc,EAAE,UAAkB,gBAAgB;QAC3E,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAAc,EACd,IAAY,EACZ,UAA0B,EAAE;QAE5B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBACxC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC;YAC1B,MAAM,EAAE,kBAAkB;YAC1B,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC9C,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;QAC9C,MAAM,IAAI,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACjF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC7C,CAAC;CACF"}

package/dist/domeneshop/index.d.ts

@@ -0,0 +1,14 @@
+export type { DomeneshopClientOptions } from "./client.js";
+export { DomeneshopClient } from "./client.js";
+export type { ApiResponse, RequestOptions } from "./http.js";
+export { DomeneshopApiError } from "./http.js";
+export type { DNSRecord, RecordType } from "./resources/dns.js";
+export { DnsResource, RECORD_TYPES } from "./resources/dns.js";
+export type { Domain, DomainServices } from "./resources/domains.js";
+export { DomainsResource } from "./resources/domains.js";
+export { DynDnsResource } from "./resources/dyndns.js";
+export type { Forward } from "./resources/forwards.js";
+export { ForwardsResource } from "./resources/forwards.js";
+export type { Invoice, InvoiceStatus } from "./resources/invoices.js";
+export { INVOICE_STATUSES, InvoicesResource } from "./resources/invoices.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domeneshop/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/domeneshop/index.js

@@ -0,0 +1,8 @@
+export { DomeneshopClient } from "./client.js";
+export { DomeneshopApiError } from "./http.js";
+export { DnsResource, RECORD_TYPES } from "./resources/dns.js";
+export { DomainsResource } from "./resources/domains.js";
+export { DynDnsResource } from "./resources/dyndns.js";
+export { ForwardsResource } from "./resources/forwards.js";
+export { INVOICE_STATUSES, InvoicesResource } from "./resources/invoices.js";
+//# sourceMappingURL=index.js.map

package/dist/domeneshop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domeneshop/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/domeneshop/resources/dns.d.ts

@@ -0,0 +1,68 @@
+import type { HttpTransport } from "../http.js";
+/**
+ * Every DNS record type the Domeneshop API accepts.
+ *
+ * The published OpenAPI spec only documents A, AAAA, CNAME, MX, SRV, TLSA
+ * and TXT, but ANAME, CAA, DS and NS are equally supported — see the record
+ * validation in Domeneshop's own client libraries:
+ * https://github.com/domeneshop/domeneshop.js (src/lib/interfaces/dnsrecord.ts)
+ * and https://github.com/domeneshop/python-domeneshop (domeneshop/client.py).
+ */
+export declare const RECORD_TYPES: readonly ["A", "AAAA", "ANAME", "CAA", "CNAME", "DS", "MX", "NS", "SRV", "TLSA", "TXT"];
+export type RecordType = (typeof RECORD_TYPES)[number];
+/**
+ * A DNS record.
+ *
+ * `host`, `type` and `data` apply to every record type; the remaining
+ * fields are type-specific and are omitted when unset. `data` always
+ * carries the record's main value — the address, hostname, text or hash —
+ * while the numeric parameters below carry the rest.
+ */
+export interface DNSRecord {
+    id?: number | undefined;
+    host: string;
+    ttl?: number | undefined;
+    type: string;
+    data: string;
+    /** MX and SRV: preference, lower is tried first. */
+    priority?: number | undefined;
+    /** SRV only. */
+    weight?: number | undefined;
+    port?: number | undefined;
+    /** TLSA only. */
+    usage?: number | undefined;
+    selector?: number | undefined;
+    dtype?: number | undefined;
+    /** DS only: alg is the signing algorithm, digest the digest type. */
+    alg?: number | undefined;
+    digest?: number | undefined;
+    /** CAA only. */
+    flags?: number | undefined;
+    /**
+     * The key tag for DS and the property tag for CAA. Domeneshop documents
+     * neither precisely, so this is kept loosely typed rather than forced
+     * into one shape.
+     */
+    tag?: number | string | undefined;
+}
+export declare class DnsResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    /** Lists DNS records for a domain, optionally filtered by host and/or record type. */
+    list(domainId: number, options?: {
+        host?: string | undefined;
+        type?: string | undefined;
+    }): Promise<DNSRecord[]>;
+    /** Retrieves a single DNS record. */
+    get(domainId: number, recordId: number): Promise<DNSRecord>;
+    /** Creates a new DNS record and returns its ID. */
+    create(domainId: number, record: DNSRecord): Promise<number>;
+    /**
+     * Replaces an existing DNS record. Fields left unset on `record` are
+     * dropped from the stored record, so callers should send it in full.
+     */
+    update(domainId: number, recordId: number, record: DNSRecord): Promise<void>;
+    /** Deletes a DNS record. */
+    delete(domainId: number, recordId: number): Promise<void>;
+}
+//# sourceMappingURL=dns.d.ts.map

package/dist/domeneshop/resources/dns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns.d.ts","sourceRoot":"","sources":["../../../src/domeneshop/resources/dns.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,yFAYf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IAEb,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gBAAgB;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAErD,sFAAsF;IAChF,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAO,GACrE,OAAO,CAAC,SAAS,EAAE,CAAC;IAWvB,qCAAqC;IAC/B,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAQjE,mDAAmD;IAC7C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IASlE;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlF,4BAA4B;IACtB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhE"}

package/dist/domeneshop/resources/dns.js

@@ -0,0 +1,60 @@
+import { assertDefined } from "../assert.js";
+/**
+ * Every DNS record type the Domeneshop API accepts.
+ *
+ * The published OpenAPI spec only documents A, AAAA, CNAME, MX, SRV, TLSA
+ * and TXT, but ANAME, CAA, DS and NS are equally supported — see the record
+ * validation in Domeneshop's own client libraries:
+ * https://github.com/domeneshop/domeneshop.js (src/lib/interfaces/dnsrecord.ts)
+ * and https://github.com/domeneshop/python-domeneshop (domeneshop/client.py).
+ */
+export const RECORD_TYPES = [
+    "A",
+    "AAAA",
+    "ANAME",
+    "CAA",
+    "CNAME",
+    "DS",
+    "MX",
+    "NS",
+    "SRV",
+    "TLSA",
+    "TXT",
+];
+export class DnsResource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    /** Lists DNS records for a domain, optionally filtered by host and/or record type. */
+    async list(domainId, options = {}) {
+        const { data } = await this.transport.request("GET", `/domains/${String(domainId)}/dns`, {
+            query: { host: options.host, type: options.type },
+        });
+        return data ?? [];
+    }
+    /** Retrieves a single DNS record. */
+    async get(domainId, recordId) {
+        const { data } = await this.transport.request("GET", `/domains/${String(domainId)}/dns/${String(recordId)}`);
+        return assertDefined(data, "domeneshop: empty response for DNS record");
+    }
+    /** Creates a new DNS record and returns its ID. */
+    async create(domainId, record) {
+        const { data } = await this.transport.request("POST", `/domains/${String(domainId)}/dns`, { body: record });
+        return assertDefined(data, "domeneshop: empty response for created DNS record").id;
+    }
+    /**
+     * Replaces an existing DNS record. Fields left unset on `record` are
+     * dropped from the stored record, so callers should send it in full.
+     */
+    async update(domainId, recordId, record) {
+        await this.transport.request("PUT", `/domains/${String(domainId)}/dns/${String(recordId)}`, {
+            body: record,
+        });
+    }
+    /** Deletes a DNS record. */
+    async delete(domainId, recordId) {
+        await this.transport.request("DELETE", `/domains/${String(domainId)}/dns/${String(recordId)}`);
+    }
+}
+//# sourceMappingURL=dns.js.map

package/dist/domeneshop/resources/dns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns.js","sourceRoot":"","sources":["../../../src/domeneshop/resources/dns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,GAAG;IACH,MAAM;IACN,OAAO;IACP,KAAK;IACL,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,MAAM;IACN,KAAK;CACG,CAAC;AAyCX,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,SAAwB;QAAxB,cAAS,GAAT,SAAS,CAAe;IAAG,CAAC;IAEzD,sFAAsF;IACtF,KAAK,CAAC,IAAI,CACR,QAAgB,EAChB,UAAoE,EAAE;QAEtE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAC3C,KAAK,EACL,YAAY,MAAM,CAAC,QAAQ,CAAC,MAAM,EAClC;YACE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;SAClD,CACF,CAAC;QACF,OAAO,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,QAAgB;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAC3C,KAAK,EACL,YAAY,MAAM,CAAC,QAAQ,CAAC,QAAQ,MAAM,CAAC,QAAQ,CAAC,EAAE,CACvD,CAAC;QACF,OAAO,aAAa,CAAC,IAAI,EAAE,2CAA2C,CAAC,CAAC;IAC1E,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,MAAiB;QAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAC3C,MAAM,EACN,YAAY,MAAM,CAAC,QAAQ,CAAC,MAAM,EAClC,EAAE,IAAI,EAAE,MAAM,EAAE,CACjB,CAAC;QACF,OAAO,aAAa,CAAC,IAAI,EAAE,mDAAmD,CAAC,CAAC,EAAE,CAAC;IACrF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,QAAgB,EAAE,MAAiB;QAChE,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,MAAM,CAAC,QAAQ,CAAC,QAAQ,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE;YAC1F,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,QAAgB;QAC7C,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,MAAM,CAAC,QAAQ,CAAC,QAAQ,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;CACF"}