@madewithremy/admin 0.1.38 → 0.1.40

package/dist/prod.js

@@ -274,20 +274,20 @@ function seg(value) {
   return encodeURIComponent(String(value));
 }
 function qs(params) {
-  const search2 = new URLSearchParams();
+  const search3 = new URLSearchParams();
   for (const [key, value] of Object.entries(params)) {
     if (value === void 0 || value === null) {
       continue;
     }
     if (Array.isArray(value)) {
       for (const entry of value) {
-        search2.append(key, String(entry));
+        search3.append(key, String(entry));
       }
       continue;
     }
-    search2.set(key, String(value));
+    search3.set(key, String(value));
   }
-  const text = search2.toString();
+  const text = search3.toString();
   return text ? `?${text}` : "";
 }
 function authHeaders(ctx) {
@@ -1510,8 +1510,113 @@ async function customRetry(ctx, hostname) {
     `/_internal/v2/apps/${ctx.appId}/settings/custom-domains/${seg(id)}/retry`
   );
 }
+var REGISTERED = (ctx) => `/_internal/v2/apps/${ctx.appId}/settings/registered-domains`;
+function search(ctx, query3) {
+  return call(
+    ctx,
+    "POST",
+    `${REGISTERED(ctx)}/search`,
+    { query: query3 }
+  );
+}
+function quote(ctx, name) {
+  return call(
+    ctx,
+    "POST",
+    `${REGISTERED(ctx)}/quote`,
+    { name }
+  );
+}
+function buy(ctx, params) {
+  return call(
+    ctx,
+    "POST",
+    `${REGISTERED(ctx)}/purchase`,
+    { name: params.name, expectedPrice: params.price, acceptTerms: true }
+  );
+}
+function owned(ctx) {
+  return call(ctx, "GET", REGISTERED(ctx));
+}
+async function findOwned(ctx, name) {
+  const wanted = name.toLowerCase();
+  const { domains } = await owned(ctx);
+  const domain = domains.find(
+    (d) => d.name === wanted && (d.status === "active" || d.status === "expired" || d.status === "pending")
+  );
+  if (!domain) {
+    throw new Error(`No domain "${name}" in this workspace`);
+  }
+  return domain;
+}
+function contactGet(ctx) {
+  return call(
+    ctx,
+    "GET",
+    `${REGISTERED(ctx)}/contact`
+  );
+}
+function contactSet(ctx, contact) {
+  return call(
+    ctx,
+    "POST",
+    `${REGISTERED(ctx)}/contact`,
+    { ...contact }
+  );
+}
+async function zone(ctx, name) {
+  const domain = await findOwned(ctx, name);
+  return call(
+    ctx,
+    "GET",
+    `${REGISTERED(ctx)}/${seg(domain.id)}/records`
+  );
+}
+async function zoneAdd(ctx, name, record) {
+  const domain = await findOwned(ctx, name);
+  return call(
+    ctx,
+    "POST",
+    `${REGISTERED(ctx)}/${seg(domain.id)}/records`,
+    { ...record }
+  );
+}
+async function zoneUpdate(ctx, name, recordId, record) {
+  const domain = await findOwned(ctx, name);
+  return call(
+    ctx,
+    "POST",
+    `${REGISTERED(ctx)}/${seg(domain.id)}/records/${seg(recordId)}`,
+    { ...record }
+  );
+}
+async function zoneDelete(ctx, name, recordId) {
+  const domain = await findOwned(ctx, name);
+  return call(
+    ctx,
+    "POST",
+    `${REGISTERED(ctx)}/${seg(domain.id)}/records/${seg(recordId)}/delete`
+  );
+}
 
 // src/commands/domains.ts
+var RECORD_TYPES = [
+  "A",
+  "AAAA",
+  "ANAME",
+  "CNAME",
+  "MX",
+  "NS",
+  "SRV",
+  "TXT"
+];
+var ZONE_RECORD_FLAGS = {
+  type: { type: "string", choices: RECORD_TYPES },
+  host: { type: "string" },
+  answer: { type: "string" },
+  ttl: { type: "number", min: 300 },
+  priority: { type: "number", min: 0 }
+};
 var domainsSpecs = {
   "domains get": {
     usage: "Usage: remy-admin domains get"
@@ -1550,6 +1655,79 @@ var domainsSpecs = {
   "domains custom retry": {
     usage: "Usage: remy-admin domains custom retry <hostname>",
     positionals: [{ name: "hostname", required: true }]
+  },
+  "domains search": {
+    usage: "Usage: remy-admin domains search <keyword or name>",
+    positionals: [{ name: "query", required: true, variadic: true }]
+  },
+  "domains quote": {
+    usage: "Usage: remy-admin domains quote <name>",
+    positionals: [{ name: "name", required: true }]
+  },
+  "domains buy": {
+    usage: "Usage: remy-admin domains buy <name> --price <dollars>\nBuys the domain for the workspace at once: the price isn't refundable, and it renews yearly at its renewal price. Only run this after the user has explicitly confirmed the name, the price and the renewal price. --price is the quote's price.",
+    positionals: [{ name: "name", required: true }],
+    flags: {
+      price: { type: "string" }
+    },
+    requireAnyOf: {
+      flags: ["price"],
+      message: "Pass --price with the quote's price the user confirmed (remy-admin domains quote <name>)."
+    }
+  },
+  "domains owned": {
+    usage: "Usage: remy-admin domains owned"
+  },
+  "domains contact get": {
+    usage: "Usage: remy-admin domains contact get"
+  },
+  "domains contact set": {
+    usage: "Usage: remy-admin domains contact set --first-name <n> --last-name <n> [--company <org>] --address1 <line> [--address2 <line>] --city <c> --state <s> --zip <z> --country <XX> --email <e> --phone <+E.164>\nThe registrant: the legal owner of every domain the workspace buys (the organization when --company is set). ICANN emails that address to verify it.",
+    flags: {
+      "first-name": { type: "string" },
+      "last-name": { type: "string" },
+      company: { type: "string" },
+      address1: { type: "string" },
+      address2: { type: "string" },
+      city: { type: "string" },
+      state: { type: "string" },
+      zip: { type: "string" },
+      country: { type: "string" },
+      email: { type: "string" },
+      phone: { type: "string" }
+    }
+  },
+  "domains zone list": {
+    usage: "Usage: remy-admin domains zone list <name>",
+    positionals: [{ name: "name", required: true }]
+  },
+  "domains zone add": {
+    usage: "Usage: remy-admin domains zone add <name> --type <type> --answer <value> [--host <host>] [--ttl <seconds>] [--priority <n>]",
+    positionals: [{ name: "name", required: true }],
+    flags: ZONE_RECORD_FLAGS,
+    requireAnyOf: {
+      flags: ["answer"],
+      message: "Pass --type and --answer."
+    }
+  },
+  "domains zone update": {
+    usage: "Usage: remy-admin domains zone update <name> <recordId> --type <type> --answer <value> [--host <host>] [--ttl <seconds>] [--priority <n>]",
+    positionals: [
+      { name: "name", required: true },
+      { name: "recordId", required: true }
+    ],
+    flags: ZONE_RECORD_FLAGS,
+    requireAnyOf: {
+      flags: ["answer"],
+      message: "Pass --type and --answer."
+    }
+  },
+  "domains zone delete": {
+    usage: "Usage: remy-admin domains zone delete <name> <recordId>",
+    positionals: [
+      { name: "name", required: true },
+      { name: "recordId", required: true }
+    ]
   }
 };
 async function domainsGet(ctx) {
@@ -1594,6 +1772,72 @@ async function customDomainsRemove(ctx, a) {
 async function customDomainsRetry(ctx, a) {
   out(await customRetry(ctx, a.req("hostname")));
 }
+async function domainsSearch(ctx, a) {
+  out(await search(ctx, a.rest("query").join(" ")));
+}
+async function domainsQuote(ctx, a) {
+  out(await quote(ctx, a.req("name")));
+}
+async function domainsBuy(ctx, a) {
+  out(
+    await buy(ctx, {
+      name: a.req("name"),
+      price: Number(a.str("price"))
+    })
+  );
+}
+async function domainsOwned(ctx) {
+  out(await owned(ctx));
+}
+async function domainsContactGet(ctx) {
+  out(await contactGet(ctx));
+}
+async function domainsContactSet(ctx, a) {
+  out(
+    await contactSet(ctx, {
+      firstName: a.str("first-name") ?? "",
+      lastName: a.str("last-name") ?? "",
+      companyName: a.str("company"),
+      address1: a.str("address1") ?? "",
+      address2: a.str("address2"),
+      city: a.str("city") ?? "",
+      state: a.str("state") ?? "",
+      zip: a.str("zip") ?? "",
+      country: a.str("country") ?? "",
+      email: a.str("email") ?? "",
+      phone: a.str("phone") ?? ""
+    })
+  );
+}
+function zoneRecord(a) {
+  const host = a.str("host") ?? "";
+  return {
+    host: host === "@" ? "" : host,
+    type: a.str("type") ?? "",
+    answer: a.str("answer") ?? "",
+    ttl: a.num("ttl"),
+    priority: a.num("priority")
+  };
+}
+async function domainsZoneList(ctx, a) {
+  out(await zone(ctx, a.req("name")));
+}
+async function domainsZoneAdd(ctx, a) {
+  out(await zoneAdd(ctx, a.req("name"), zoneRecord(a)));
+}
+async function domainsZoneUpdate(ctx, a) {
+  out(
+    await zoneUpdate(
+      ctx,
+      a.req("name"),
+      Number(a.req("recordId")),
+      zoneRecord(a)
+    )
+  );
+}
+async function domainsZoneDelete(ctx, a) {
+  out(await zoneDelete(ctx, a.req("name"), Number(a.req("recordId"))));
+}
 var domainsHandlers = {
   "domains get": domainsGet,
   "domains set": domainsSet,
@@ -1604,9 +1848,19 @@ var domainsHandlers = {
   "domains custom records": customDomainsRecords,
   "domains custom status": customDomainsStatus,
   "domains custom remove": customDomainsRemove,
-  "domains custom retry": customDomainsRetry
+  "domains custom retry": customDomainsRetry,
+  "domains search": domainsSearch,
+  "domains quote": domainsQuote,
+  "domains buy": domainsBuy,
+  "domains owned": domainsOwned,
+  "domains contact get": domainsContactGet,
+  "domains contact set": domainsContactSet,
+  "domains zone list": domainsZoneList,
+  "domains zone add": domainsZoneAdd,
+  "domains zone update": domainsZoneUpdate,
+  "domains zone delete": domainsZoneDelete
 };
-var domainsHelp = `remy-admin domains \u2014 Manage your app's domains.
+var domainsHelp = `remy-admin domains \u2014 Manage your app's domains, and buy one.
 
 Platform subdomain (e.g. my-app.madewithremy.com):
   get             Get current custom subdomain
@@ -1622,6 +1876,18 @@ Custom domains (customer-owned hostnames, CNAME/A records):
   custom remove <hostname>     Remove a hostname (apex also removes paired www)
   custom retry <hostname>      Re-trigger validation (after customer fixes DNS)
 
+Buying a domain (the workspace owns it; Remy hosts its DNS):
+  search <keyword or name>     Names for sale, with price and renewal price
+  quote <name>                 The definitive price for one name
+  buy <name> --price <dollars> Buy it (not refundable: confirm with the user first)
+  owned                        The workspace's domains: status, expiry, auto-renew, apps
+  contact get                  The registrant contact every domain is registered to
+  contact set --first-name ... Set it (needed before the first purchase)
+  zone list <name>             The domain's DNS records (ours marked managed)
+  zone add <name> ...          Add a record (--type, --answer, --host, --ttl, --priority)
+  zone update <name> <id> ...  Replace one of the owner's records
+  zone delete <name> <id>      Delete one of the owner's records
+
 Usage:
   remy-admin domains get
   remy-admin domains set my-app
@@ -1634,14 +1900,44 @@ Usage:
   remy-admin domains custom status app.acme.com
   remy-admin domains custom retry app.acme.com
   remy-admin domains custom remove app.acme.com
+  remy-admin domains search acme bakery
+  remy-admin domains quote acmebakery.com
+  remy-admin domains buy acmebakery.com --price 11.99
+  remy-admin domains owned
+  remy-admin domains contact set --first-name Ada --last-name Lovelace --address1 "1 Main St" --city Austin --state TX --zip 78701 --country US --email ada@acme.com --phone +15125550123
+  remy-admin domains zone list acmebakery.com
+  remy-admin domains zone add acmebakery.com --type TXT --host @ --answer "google-site-verification=abc"
 
 Notes:
   - 'add' with an apex (e.g. acme.com) auto-creates the www.apex pair and
     returns both. 'remove' on an apex also removes its paired www.
   - 'list'/'records'/'status' read a CF-synced cache that can be up to ~5
     minutes stale. After the customer adds DNS, use 'retry' to force a
-    synchronous re-check.
-  - 'uiStatus' values: waiting_for_dns | issuing_ssl | live | action_needed | reconnecting.`;
+    synchronous re-check. On a domain bought through Remy there are no records
+    to add, so there's nothing to retry while it waits on the registry.
+  - 'uiStatus' values: waiting_for_dns | issuing_ssl | live | action_needed | reconnecting.
+  - 'buy' charges the workspace the price at once, and it isn't refundable; the
+    domain renews yearly at its renewal price while auto-renew is on (the owner
+    turns it off, renews early or transfers out in Workspace Settings > Domains).
+    Never run 'buy' without the user's explicit confirmation of the name, the
+    price and the renewal price. --price is the quote's; if the price has moved,
+    'buy' is refused with price_changed and the new price, to confirm again.
+  - The first purchase needs the registrant contact ('contact set'): the
+    domain's legal owner. ICANN emails that address to verify it within 15
+    days, or the domain stops resolving; tell the user to watch for it.
+  - Other refusals: registrant_contact_required, insufficient_credits/*,
+    entitlement_required:registered_domains (the plan holds no more domains:
+    a paid plan holds 20), domain_registration_rate (3 in any 30 days),
+    domain_unavailable, tld_not_supported,
+    trademark_claim, registrar_busy (try again), registrar_payment (temporarily
+    unavailable), namecom_not_configured (this deployment doesn't sell domains).
+  - A bought domain is usually active when 'buy' returns; 'owned' shows a
+    pending one settle. It connects to nothing by itself: 'custom add',
+    'email domains add' and 'email inbound-domains add' on it write their DNS
+    records automatically (the response's registeredDomain says what was
+    written), so there's nothing to hand the user.
+  - Records the platform wrote for a connection are 'managed' in 'zone list' and
+    can't be changed; they go when the connection is removed.`;
 
 // src/ops/users.ts
 function list4(ctx, params = {}) {
@@ -3375,7 +3671,7 @@ async function allDocuments(ctx, params) {
 function list8(ctx) {
   return call(ctx, "GET", base(ctx.appId));
 }
-function search(ctx, params) {
+function search2(ctx, params) {
   const {
     slug,
     query: query3,
@@ -6211,7 +6507,7 @@ async function dataSourcesSearch(ctx, a) {
   const filter = filterFromFlags(a);
   const maxPerDocument = a.num("max-per-document");
   out(
-    await search(ctx, {
+    await search2(ctx, {
       slug: sourceOf(a),
       query: a.req("query"),
       ...topK ? { topK } : {},
@@ -8619,11 +8915,11 @@ function logs(ctx, params) {
   if (params.limit) {
     query3.set("limit", String(params.limit));
   }
-  const search2 = query3.toString();
+  const search3 = query3.toString();
   return call(
     ctx,
     "GET",
-    `${base7(ctx.appId)}/${encodeURIComponent(params.id)}/logs${search2 ? `?${search2}` : ""}`
+    `${base7(ctx.appId)}/${encodeURIComponent(params.id)}/logs${search3 ? `?${search3}` : ""}`
   );
 }
 function provision(ctx, params) {
@@ -9371,7 +9667,7 @@ Commands:
   analytics     View traffic, top-N, geo, and AI-referral insights
   releases      View and monitor releases
   diagnostics   View the post-deploy Lighthouse audit (scores, issues, raw report)
-  domains       Manage custom subdomain
+  domains       Subdomain, custom domains, and buying a domain
   users         Manage app users and roles
   db            Query the production database
   secrets       Manage app secrets (env vars)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madewithremy/admin",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "description": "Admin SDK + CLI for managing production Remy apps",
   "type": "module",
   "main": "./dist/index.js",