# mindless-route53 > low-mental-load API/CLI for AWS Route 53 Latest version **2.0.5** (published 2026-03-25) · MIT license · 0 weekly downloads ## Install ```sh npm install mindless-route53 pnpm add mindless-route53 yarn add mindless-route53 bun add mindless-route53 ``` Provides the commands `mroute53`, `mindless-route53`. ## Health **Score 55/100 (C)** — status: stable. Positive: has types; esm support; no vulnerabilities. Warnings: low downloads. ## Facts | | | |---|---| | Version | 2.0.5 | | Published | 2026-03-25 | | First published | 2019-07-25 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Node | >=16 | | Dependencies | 7 | | Unpacked size | 70.4 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 0 | | Author | Andy Edwards | | Maintainers | jedwards1211 | | Keywords | aws, route53, dns | ## Links - npm: https://www.npmjs.com/package/mindless-route53 - Repository: https://github.com/jcoreio/mindless-route53 - Homepage: https://github.com/jcoreio/mindless-route53#readme - Issues: https://github.com/jcoreio/mindless-route53/issues - npm.io page: https://npm.io/package/mindless-route53 ## Dependencies (7) - [is-ip](https://npm.io/package/is-ip.md) ^3.1.0 - [yargs](https://npm.io/package/yargs.md) ^17.7.2 - [deep-equal](https://npm.io/package/deep-equal.md) ^2.0.3 - [@types/node](https://npm.io/package/@types/node.md) ^17.0.14 - [@babel/runtime](https://npm.io/package/@babel/runtime.md) ^7.26.0 - [typed-validators](https://npm.io/package/typed-validators.md) ^4.4.0 - [@aws-sdk/client-route-53](https://npm.io/package/@aws-sdk/client-route-53.md) ^3.988.0 ## Alternatives - [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads - [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads - [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads - [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads - [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads ## Recent versions - 2.0.5 (latest) — 2026-03-25 - 2.0.4 — 2026-03-04 - 2.0.3 — 2026-02-25 - 2.0.2 — 2026-02-25 - 2.0.1 — 2024-06-10 - 2.0.0 — 2024-05-21 - 1.4.0 — 2022-02-04 - 1.3.0 — 2021-07-20 - 1.2.4 — 2020-07-16 - 1.2.3 — 2020-07-16 - 1.2.2 — 2020-07-16 - 1.2.1 — 2020-07-16 - 1.2.0 — 2020-07-13 - 1.1.0 — 2019-09-10 - 1.0.1 — 2019-07-25 - … 1 more at https://npm.io/package/mindless-route53/versions ## README # mindless-route53 [![CircleCI](https://circleci.com/gh/jcoreio/mindless-route53.svg?style=svg)](https://circleci.com/gh/jcoreio/mindless-route53) [![Coverage Status](https://codecov.io/gh/jcoreio/mindless-route53/branch/master/graph/badge.svg)](https://codecov.io/gh/jcoreio/mindless-route53) [![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release) [![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/) [![npm version](https://badge.fury.io/js/mindless-route53.svg)](https://badge.fury.io/js/mindless-route53) low-mental-load API/CLI for AWS Route 53 For our purposes at least, looking up the hosted zone id when upserting a DNS record via script or CLI is a useless waste of time...it can be determined automatically from the DNS name for the record being upserted. - [Node.js API](#nodejs-api) - [`findHostedZone(options)`](#findhostedzoneoptions) - [`findHostedZoneId(options)`](#findhostedzoneidoptions) - [`upsertRecordSet(options)`](#upsertrecordsetoptions) - [CLI](#cli) - [`mroute53 upsert`](#mroute53-upsert) # Node.js API ## `findHostedZones(options)` Finds the properties of the private and public hosted zones whose names are the deepest superdomain of a given `DNSName`. ### `options` #### `awsConfig` (`AWS.ConfigurationOptions`, _optional_) The general configuration options for AWS services, like `credentials` and `region` #### `DNSName` (`string`, _required_) the DNSName to search for, which can be either the exact name of the hosted zone or a subdomain. #### `Route53` (`AWS.Route53`, _optional_) a Route53 client with your desired settings. ### Returns #### `PrivateHostedZone`, `?Zone`: The properties of the private hosted zone whose name is the deepest superdomain of the given `DNSName`, or `null` if no matching private hosted zone was found. #### `PublicHostedZone`, `?Zone`: The properties of the public hosted zone whose name is the deepest superdomain of the given `DNSName`, or `null` if no matching public hosted zone was found. ## `findHostedZone(options)` Finds the properties of the hosted zone whose name is the deepest superdomain of a given `DNSName`. ### `options` #### `DNSName` (`string`, _required_) the DNSName to search for, which can be either the exact name of the hosted zone or a subdomain. #### `PrivateZone` (`boolean`, _optional_) whether to find a private zone #### `Route53` (`AWS.Route53`, _optional_) a Route53 client with your desired settings. ### Returns The properties of the hosted zone whose name is the deepest superdomain of the given `DNSName`. ## `findHostedZoneId(options)` Like [`findHostedZoneId(options)`](#findhostedzoneidoptions), but just returns the zone id. ## `upsertRecordSet(options)` Upserts a single DNS record set. ### `options` #### `awsConfig` (`AWS.ConfigurationOptions`, _optional_) The general configuration options for AWS services, like `credentials` and `region` #### `ResourceRecordSet` (`ResourceRecordSet`, _optional_) a `ResourceRecordSet` as accepted by the AWS SDK for upsert (you may provide this or `Name`/`Target`/`TTL`) #### `Name` (`string`, _optional_) the name of the record (required if `ResourceRecordSet` isn't given) #### `Target` (`string | Array`, _optional_) the IP address value(s) for an A record or DNS name value(s) for a CNAME record (required if `ResourceRecordSet` isn't given) #### `TTL` (`number`, _optional_) the time to live (required if `ResourceRecordSet` isn't given) #### `PrivateZone` (`boolean`, _optional_) whether to use the private hosted zone #### `HostedZone` (`Zone`, _optional_) information about the target hosted zone, as returned from `findHostedZone` or `findHostedZones`. You can speed up multiple calls to the same hosted zone by pre-fetching the zone info and providing it here. #### `Comment` (`string`, _optional_) a comment for the upsert #### `Route53` (`AWS.Route53`, _optional_) a Route53 client with your desired #### `waitForChanges` (`boolean`, _optional_) defaults to `true`. If `false`, `upsertRecordSet` will return without waiting for confirmation that the Route53 record changes were successfully executed. ### Returns The result of the `AWS.Route53.changeResourceRecordSets` call. ## `upsertPublicAndPrivateRecords(options)` Upserts public and private DNS records for a single hostname. ### `options` #### `awsConfig` (`AWS.ConfigurationOptions`, _optional_) The general configuration options for AWS services, like `credentials` and `region` #### `Name` (`string`, _required_) the name of the record #### `TTL` (`number`, _required_) the time to live #### `PrivateTarget` (`string | Array`, _required_) the IP address value(s) for an A record or DNS name value(s) for a CNAME record in the private zone. #### `PublicTarget` (`string | Array`, _required_) the IP address value(s) for an A record or DNS name value(s) for a CNAME record in the public zone. #### `PrivateHostedZone` (`Zone`, _optional_) information about the private hosted zone, as returned from `findHostedZones`. You can speed up multiple calls to the same hosted zones by pre-fetching the zone info and providing it here. #### `PublicHostedZone` (`Zone`, _optional_) information about the public hosted zone, as returned from `findHostedZones`. You can speed up multiple calls to the same hosted zones by pre-fetching the zone info and providing it here. #### `Route53` (`AWS.Route53`, _optional_) a Route53 client with your desired #### `waitForChanges` (`boolean`, _optional_) defaults to `true`. If `false`, `upsertPublicAndPrivateRecords` will return without waiting for confirmation that the Route53 record changes were successfully executed. ### Returns The result of the `AWS.Route53.changeResourceRecordSets` call. # CLI You can use the `mindless-route53` or `mroute53` CLI command. ## `mroute53 upsert` upsert a resource record set ### Usage ``` mroute53 upsert --name --target --ttl