insta 0.0.76 → 0.0.77

package/dist/commands/domain.js

@@ -34,15 +34,8 @@ export async function domainSearch(keyword, opts, deps) {
         info(`buy one: insta domain buy ${buyable.domainName}`);
 }
 export async function domainBuy(name, opts, deps) {
+    const years = whole('--years', opts.years);
     const { api, project: p } = await domainDeps(deps);
-    // JSON.stringify drops undefined but keeps NaN as null, which the platform rejects as a type
-    // error rather than a bad term — so a malformed --years is refused here, with the reason.
-    let years;
-    if (opts.years !== undefined) {
-        years = Number(opts.years);
-        if (!Number.isInteger(years))
-            die(`--years must be a whole number of years, not ${opts.years}`);
-    }
     const res = await api.rawRequest('POST', `/projects/${p.projectId}/domains/orders`, { domainName: name, years });
     if (handleApproval(res, opts.json))
         return;
@@ -138,4 +131,61 @@ export async function domainStatus(name, opts, deps) {
     for (const line of domain ? domainLines(domain) : orderStatusLines(order))
         info(line);
 }
+export function recordLines(records) {
+    const w = (pick) => Math.max(...records.map((r) => pick(r).length));
+    const idW = w((r) => String(r.id)), typeW = w((r) => r.type), nameW = w((r) => r.fqdn), answerW = w((r) => r.answer), ttlW = w((r) => String(r.ttl));
+    return records.map((r) => {
+        const line = `  ${String(r.id).padEnd(idW)}  ${r.type.padEnd(typeW)}  ${r.fqdn.padEnd(nameW)}  ${r.answer.padEnd(answerW)}  ${String(r.ttl).padEnd(ttlW)}  ${r.priority === undefined ? '' : String(r.priority)}`.trimEnd();
+        if (r.managed)
+            return `${line}  (managed${r.hostname ? ` — published for ${r.hostname}` : ' — no hostname claims it; remove drops it'})`;
+        return line;
+    });
+}
+const recordPath = (orgId, domainName) => `/orgs/${orgId}/domains/${encodeURIComponent(domainName)}/records`;
+// Number() reads "" as 0 and "1e3" as 1000, and keeps NaN, which the platform refuses as a type error naming no flag.
+function whole(flag, value) {
+    if (value === undefined)
+        return undefined;
+    const digits = value.trim();
+    if (!/^\d+$/.test(digits))
+        die(`${flag} must be a whole number, not ${JSON.stringify(value)}`);
+    return Number(digits);
+}
+export async function domainRecordsList(domainName, opts, deps) {
+    const { api, orgId } = await orgDeps(opts, deps);
+    const r = await api.request('GET', recordPath(orgId, domainName));
+    if (opts.json)
+        return printJson(r);
+    if (!r.items.length)
+        return info(`no records in ${domainName} — add one: insta domain records add ${domainName} A @ <ip>`);
+    for (const line of recordLines(r.items))
+        info(line);
+}
+export async function domainRecordsAdd(domainName, type, name, content, opts, deps) {
+    const body = { type: type.toUpperCase(), host: name, answer: content, ttl: whole('--ttl', opts.ttl), priority: whole('--priority', opts.priority) };
+    const { api, orgId } = await orgDeps(opts, deps);
+    const r = await api.request('POST', recordPath(orgId, domainName), body);
+    if (opts.json)
+        return printJson(r);
+    for (const line of recordLines([r]))
+        info(line);
+}
+export async function domainRecordsSet(domainName, id, opts, deps) {
+    const body = { type: opts.type?.toUpperCase(), host: opts.name, answer: opts.content, ttl: whole('--ttl', opts.ttl), priority: whole('--priority', opts.priority) };
+    if (Object.values(body).every((v) => v === undefined))
+        die('nothing to change — pass --type, --name, --content, --ttl or --priority');
+    const { api, orgId } = await orgDeps(opts, deps);
+    const r = await api.request('PATCH', `${recordPath(orgId, domainName)}/${encodeURIComponent(id)}`, body);
+    if (opts.json)
+        return printJson(r);
+    for (const line of recordLines([r]))
+        info(line);
+}
+export async function domainRecordsRemove(domainName, id, opts, deps) {
+    const { api, orgId } = await orgDeps(opts, deps);
+    const r = await api.request('DELETE', `${recordPath(orgId, domainName)}/${encodeURIComponent(id)}`);
+    if (opts.json)
+        return printJson(r);
+    info(`removed record ${id} from ${domainName}`);
+}
 //# sourceMappingURL=domain.js.map

package/dist/index.js

@@ -375,6 +375,21 @@ dom.command('list').description("Domains bought through InstaCloud in this org
     .action(guard((o) => domainCmd.domainList(o)));
 dom.command('status <name>').description("A bought domain's order and attach state").option('--json')
     .action(guard((name, o) => domainCmd.domainStatus(name, o)));
+const rec = dom.command('records').description('DNS records of a bought domain — the zone InstaCloud holds at the registrar');
+rec.command('list <domain>').description('Every record in the zone, managed ones marked')
+    .option('--org <id>', "target org (default: linked project's org)").option('--json')
+    .action(guard((domain, o) => domainCmd.domainRecordsList(domain, o)));
+rec.command('add <domain> <type> <name> <content>').description('Add a record — type A|AAAA|CNAME|ANAME|MX|TXT|SRV|NS; name "@" for the domain itself, a label like "www", or the full hostname under it')
+    .option('--ttl <seconds>', 'time to live in seconds (default 300)').option('--priority <n>', 'MX and SRV only')
+    .option('--org <id>', "target org (default: linked project's org)").option('--json')
+    .action(guard((domain, type, name, content, o) => domainCmd.domainRecordsAdd(domain, type, name, content, o)));
+rec.command('set <domain> <id>').description('Change a record by its id (from `records list`); fields you omit keep their value')
+    .option('--type <t>', 'A|AAAA|CNAME|ANAME|MX|TXT|SRV|NS').option('--name <host>', '"@" for the domain itself, a label like "www", or the full hostname under it').option('--content <value>', 'the answer').option('--ttl <seconds>', 'time to live in seconds').option('--priority <n>', 'MX and SRV only')
+    .option('--org <id>', "target org (default: linked project's org)").option('--json')
+    .action(guard((domain, id, o) => domainCmd.domainRecordsSet(domain, id, o)));
+rec.command('remove <domain> <id>').description('Remove a record by its id (a record InstaCloud published for a live hostname is refused)')
+    .option('--org <id>', "target org (default: linked project's org)").option('--json')
+    .action(guard((domain, id, o) => domainCmd.domainRecordsRemove(domain, id, o)));
 const bill = program.command('billing').description('Current billing cycle overview (tier / used / included / overage / credits / forecast + per-dimension & per-project breakdown)')
     .option('--org <id>', 'target org (default: linked project\'s org)').option('--json')
     .action(guard((o) => billing(o)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "insta",
-  "version": "0.0.76",
+  "version": "0.0.77",
   "type": "module",
   "description": "InstaCloud CLI — a thin client of the platform control-plane API.",
   "keywords": [