@stacksjs/dns 0.75.452 → 0.75.458

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // @bun
2
- import{runNamedAction as k}from"@stacksjs/action-runner";import{config as S}from"@stacksjs/config";import{Action as b}from"@stacksjs/enums";import{err as g,handleError as f,ok as m}from"@stacksjs/error-handling";import{log as u}from"@stacksjs/logging";import{path as C}from"@stacksjs/path";import{fs as w}from"@stacksjs/storage";import{Route53Client as h,Route53DomainsClient as x}from"@stacksjs/ts-cloud";function N(e){if(!e)return;return e.replace(/^https?:\/\//,"").replace(/\/$/,"")}async function H(e,t){let s=await e.listHostedZonesByName({DNSName:t});if(!s||!s.HostedZones||s.HostedZones.length===0)return g(f(`No hosted zones found for domain: ${t}`));let r=s.HostedZones.find((a)=>a.Name===`${t}.`);if(!r)return g(f(`Hosted Zone not found for domain: ${t}`));let n=await e.listResourceRecordSets({HostedZoneId:r.Id});if(!n||!n.ResourceRecordSets)return g(f(`No DNS records found for domain: ${t}`));let i=n.ResourceRecordSets.filter((a)=>a.Type!=="NS"&&a.Type!=="SOA").map((a)=>({Action:"DELETE",ResourceRecordSet:a}));if(i.length>0)try{await e.changeResourceRecordSets({HostedZoneId:r.Id,ChangeBatch:{Changes:i}})}catch(a){u.warn(`Batch delete failed (${i.length} records), falling back to individual deletion`);let d=[];for(let c of i)try{await e.changeResourceRecordSets({HostedZoneId:r.Id,ChangeBatch:{Changes:[c]}})}catch(o){d.push(`${c.ResourceRecordSet.Name} (${c.ResourceRecordSet.Type}): ${o.message}`)}if(d.length>0)return g(f(`Failed to delete ${d.length} DNS record(s):
3
- ${d.join(`
4
- `)}`))}return m(r)}async function K(e){let t=new h,s=await H(t,e);if(s.isErr)return g(f(`Failed to delete records for zone: ${e}`));let r=s.unwrap();return await t.deleteHostedZone({Id:r.Id}),u.info(`Deleted Hosted Zone for domain: ${e}`),m("success")}async function Q(e){let t=new h;if((await H(t,e)).isErr)return g(f(`Failed to delete records for zone: ${e}`));return u.info(`Deleted DNS records for domain: ${e}`),m("success")}async function ee(e){let t=new h,r=(await t.listHostedZonesByName({DNSName:e})).HostedZones?.find((i)=>i.Name===`${e}.`);if(r)return m(r);let n=await t.createHostedZone({Name:e,CallerReference:`${Date.now()}`});if(!n.HostedZone)return g(f("Failed to create hosted zone"));return m(n)}function P(e){if(!/^[a-zA-Z0-9.-]+$/.test(e))throw Error(`Invalid nameserver value: ${e}`);return e}function v(e){try{let t=C.projectConfigPath("dns.ts"),r=w.readFileSync(t,"utf-8").replace(/nameservers: \[.*?\]/s,`nameservers: [${e.map((n)=>`'${P(n)}'`).join(", ")}]`);w.writeFileSync(t,r,"utf-8"),u.info("Nameservers have been set.")}catch(t){u.error("Error updating nameservers:",t)}}async function te(e){try{let t=new h,{HostedZones:s}=await t.listHostedZonesByName({DNSName:e});if(!s||s.length===0)return g(f(`No hosted zones found for domain ${e}`));let r=s[0];if(r&&r.Name===`${e}.`)return m(r.Id);return m(null)}catch(t){return g(f(`Failed to find hosted zone for domain ${e}`,t))}}async function E(e){if(u.debug("Getting nameservers for domain:",e),!e)return[];try{return(await new x().getDomainDetail({DomainName:e}))?.Nameservers?.map((r)=>r.Name)||[]}catch(t){return u.debug("Domain not registered via Route53 Domains:",t),[]}}async function ne(e){u.debug("Getting hosted zone nameservers for domain:",e);try{let t=new h,r=(await t.listHostedZonesByName({DNSName:e})).HostedZones?.find((i)=>i.Name===`${e}.`);if(!r)return u.debug("No hosted zone found for domain:",e),[];return(await t.getHostedZone({Id:r.Id})).DelegationSet?.NameServers||[]}catch(t){return f("Error getting hosted zone nameservers",t),[]}}async function z(e,t){if(!t)t=S.app.url;let s=await E(t);if(!s||s.length===0)return u.debug("Domain is not registered via Route53 Domains - skipping automatic nameserver update"),v(e),!1;if(JSON.stringify(s.sort())!==JSON.stringify(e.sort())){u.info("Updating your domain nameservers to match the ones in your hosted zone..."),u.debug("Hosted zone nameservers:",e),u.debug("Domain nameservers:",s);try{return await new x().updateDomainNameservers({DomainName:t,Nameservers:e.map((n)=>({Name:n}))}),v(e),u.info("Nameservers updated."),!0}catch(r){return u.debug("Failed to update nameservers via Route53 Domains:",r),v(e),!1}}return u.success("Your nameservers are up to date."),!0}async function re(e){if(u.debug("Checking if domain has been added to cloud..."),!e)e=S.app.url;if(e=N(e),!e)return!1;u.debug("domainName:",e);let t=new h,s=await t.listHostedZonesByName({DNSName:e});if(u.debug("Existing hosted zones:",s),!s||!s.HostedZones||s.HostedZones.length===0)return!1;let r=s.HostedZones.find((n)=>n.Name===`${e}.`);if(r){u.debug("Hosted zone found:",r);let i=(await t.getHostedZone({Id:r.Id})).DelegationSet?.NameServers||[];return await z(i,e),!0}return!1}async function se(e){return await k(b.DomainsAdd,e)}import{promises as y}from"dns";import{DnsProviderFactory as T}from"@stacksjs/ts-cloud";var I=new Set(["A","AAAA","CNAME"]);function R(e){let t=e==="auto"||e==null?600:e;return Math.max(600,t)}function D(e,t){let s=p(e);if(t==="@"||t==="")return e;if(t.endsWith("."))return p(t);let r=p(t);if(r===s||r.endsWith(`.${s}`))return r;return`${t}.${e}`}function p(e){return e.replace(/\.$/,"").toLowerCase()}function Z(e){return e.replace(/^"(.*)"$/s,"$1")}function F(e){if(e.type==="A")return!/^(?:0\.|10\.|127\.|169\.254\.|192\.168\.|172\.(?:1[6-9]|2\d|3[01])\.)/.test(e.content);if(e.type==="AAAA")return!/^(?:::1$|fe80:|f[cd])/i.test(e.content);return!0}function j(e,t,s){let r=(s==="A"?t.a:t.aaaa)??[];for(let n of r){if(D(e,n.name)!==p(e))continue;if(!n.address||n.address==="@")continue;return n.address}return null}function B(e,t){let s=[],r=(n,i)=>n==="@"?j(e,t,i)??"@":n;for(let n of t.txt??[])s.push({name:D(e,n.name),type:"TXT",content:n.content,ttl:R(n.ttl)});for(let n of t.a??[])s.push({name:D(e,n.name),type:"A",content:r(n.address,"A"),ttl:R(n.ttl)});for(let n of t.aaaa??[])s.push({name:D(e,n.name),type:"AAAA",content:r(n.address,"AAAA"),ttl:R(n.ttl)});for(let n of t.cname??[])s.push({name:D(e,n.name),type:"CNAME",content:n.target==="@"?e:n.target,ttl:R(n.ttl)});for(let n of t.mx??[])s.push({name:D(e,n.name),type:"MX",content:n.mailServer,ttl:R(n.ttl),priority:n.priority});return s}function M(e,t){if((e.type==="A"||e.type==="AAAA")&&e.content==="@")return`address "@" copies the apex ${e.type} record, and config/dns.ts declares none`;if(!F(e))return`${e.content} is a private, loopback or placeholder address and is never published`;if(t){let s=p(e.name),r=p(t);if(s!==r&&!s.endsWith(`.${r}`))return`${e.name} is outside the ${t} zone`}return null}function O(e,t,s={}){let r=e.map((n)=>{let i=M(n,s.zone);if(i)return{record:n,action:"skip",reason:i};let a=p(n.name),d=t.filter((o)=>o.type===n.type&&p(o.name)===a),c=I.has(n.type)?d.length>0:d.some((o)=>Z(o.content)===Z(n.content));return{record:n,action:c?"keep":"create"}});return{items:r,create:r.filter((n)=>n.action==="create").map((n)=>n.record),keep:r.filter((n)=>n.action==="keep").map((n)=>n.record),skip:r.filter((n)=>n.action==="skip").map((n)=>({record:n.record,reason:n.reason??"not publishable"}))}}async function X(e){let t=async(o)=>o.catch(()=>[]),[s,r,n,i,a,d]=await Promise.all([t(y.resolve4(e)),t(y.resolve4(`www.${e}`)),t(y.resolve6(e)),t(y.resolveTxt(e)),t(y.resolveMx(e)),t(y.resolveNs(e))]),c=[];for(let o of s)c.push({name:e,type:"A",content:o,ttl:600});for(let o of r)c.push({name:`www.${e}`,type:"A",content:o,ttl:600});for(let o of n)c.push({name:e,type:"AAAA",content:o,ttl:600});for(let o of i)c.push({name:e,type:"TXT",content:o.join(""),ttl:600});for(let o of a)c.push({name:e,type:"MX",content:o.exchange,ttl:600,priority:o.priority});for(let o of d)c.push({name:e,type:"NS",content:o,ttl:600});return c}async function L(e){try{return await new T().loadFromEnv().getProviderForDomain(e)}catch{return null}}function A(e,t){let s=p(t);if(s===p(e))return"@";return s.endsWith(`.${p(e)}`)?s.slice(0,-(e.length+1)):s}function ce(e,t){let s=(o)=>t.filter((l)=>l.type===o),r=["import type { DnsConfig } from '@stacksjs/types'","",`// Records for ${e}, pulled from live DNS via \`buddy dns:pull\`.`,"const dns: DnsConfig = {"];if([...s("A"),...s("AAAA")].length){r.push(" a: [");for(let l of s("A"))r.push(` { name: '${A(e,l.name)}', address: '${l.content}', ttl: 600 },`);r.push(" ],");let o=s("AAAA");if(o.length){r.push(" aaaa: [");for(let l of o)r.push(` { name: '${A(e,l.name)}', address: '${l.content}', ttl: 600 },`);r.push(" ],")}}let i=s("CNAME");if(i.length){r.push(" cname: [");for(let o of i)r.push(` { name: '${A(e,o.name)}', target: '${o.content}', ttl: 'auto' },`);r.push(" ],")}let a=s("TXT");if(a.length){r.push(" txt: [");for(let o of a)r.push(` { name: '${A(e,o.name)}', ttl: 'auto', content: ${JSON.stringify(Z(o.content))} },`);r.push(" ],")}let d=s("MX");if(d.length){r.push(" mx: [");for(let o of d)r.push(` { name: '${A(e,o.name)}', mailServer: '${o.content}', ttl: 'auto', priority: ${o.priority??10} },`);r.push(" ],")}let c=s("NS");if(c.length)r.push(` nameservers: [${c.map((o)=>`'${p(o.content)}'`).join(", ")}],`);return r.push("}","","export default dns",""),r.join(`
5
- `)}async function ue(e,t,s={}){let r=B(e,t),n=s.dryRun?null:s.provider??await L(e),i=n?(await n.listRecords(e)).records??[]:await X(e),a=O(r,i,{zone:e});if(s.dryRun||!n)return{plan:a,created:0,kept:a.keep.length,failed:0,failures:[],skipped:a.skip,applied:!1,provider:n?.name??null};let d=0,c=[];for(let o of a.create)try{let l=await n.createRecord(e,o);if(l.success)d+=1;else c.push({record:o,reason:l.message?.trim()||`${n.name} rejected the record without a message`})}catch(l){c.push({record:o,reason:l instanceof Error?l.message:String(l)})}return{plan:a,created:d,kept:a.keep.length,failed:c.length,failures:c,skipped:a.skip,applied:!0,provider:n.name}}export{se as addDomain,ee as createHostedZone,K as deleteHostedZone,Q as deleteHostedZoneRecords,B as desiredDnsRecords,L as dnsProviderForDomain,te as findHostedZone,ne as getHostedZoneNameservers,E as getNameservers,re as hasUserDomainBeenAddedToCloud,O as planDnsSync,ce as renderDnsConfig,X as resolveLiveRecords,ue as syncDnsConfig,z as updateNameservers,v as writeNameserversToConfig};
2
+ import{runNamedAction as k}from"@stacksjs/action-runner";import{config as w}from"@stacksjs/config";import{Action as E}from"@stacksjs/enums";import{err as m,handleError as g,ok as h}from"@stacksjs/error-handling";import{log as c}from"@stacksjs/logging";import{path as z}from"@stacksjs/path";import{fs as S}from"@stacksjs/storage";import{Route53Client as y,Route53DomainsClient as x}from"@stacksjs/ts-cloud";function I(e){if(!e)return;return e.replace(/^https?:\/\//,"").replace(/\/$/,"")}async function H(e,r){let s=await e.listHostedZonesByName({DNSName:r});if(!s||!s.HostedZones||s.HostedZones.length===0)return m(g(`No hosted zones found for domain: ${r}`));let n=s.HostedZones.find((a)=>a.Name===`${r}.`);if(!n)return m(g(`Hosted Zone not found for domain: ${r}`));let t=await e.listResourceRecordSets({HostedZoneId:n.Id});if(!t||!t.ResourceRecordSets)return m(g(`No DNS records found for domain: ${r}`));let i=t.ResourceRecordSets.filter((a)=>a.Type!=="NS"&&a.Type!=="SOA").map((a)=>({Action:"DELETE",ResourceRecordSet:a}));if(i.length>0)try{await e.changeResourceRecordSets({HostedZoneId:n.Id,ChangeBatch:{Changes:i}})}catch(a){c.warn(`Batch delete failed (${i.length} records), falling back to individual deletion`);let u=[];for(let l of i)try{await e.changeResourceRecordSets({HostedZoneId:n.Id,ChangeBatch:{Changes:[l]}})}catch(o){u.push(`${l.ResourceRecordSet.Name} (${l.ResourceRecordSet.Type}): ${o.message}`)}if(u.length>0)return m(g(`Failed to delete ${u.length} DNS record(s):
3
+ ${u.join(`
4
+ `)}`))}return h(n)}async function re(e){let r=new y,s=await H(r,e);if(s.isErr)return m(g(`Failed to delete records for zone: ${e}`));let n=s.unwrap();return await r.deleteHostedZone({Id:n.Id}),c.info(`Deleted Hosted Zone for domain: ${e}`),h("success")}async function se(e){let r=new y;if((await H(r,e)).isErr)return m(g(`Failed to delete records for zone: ${e}`));return c.info(`Deleted DNS records for domain: ${e}`),h("success")}async function oe(e){let r=new y,n=(await r.listHostedZonesByName({DNSName:e})).HostedZones?.find((i)=>i.Name===`${e}.`);if(n)return h(n);let t=await r.createHostedZone({Name:e,CallerReference:`${Date.now()}`});if(!t.HostedZone)return m(g("Failed to create hosted zone"));return h(t)}function T(e){if(!/^[a-zA-Z0-9.-]+$/.test(e))throw Error(`Invalid nameserver value: ${e}`);return e}function A(e){try{let r=z.projectConfigPath("dns.ts"),n=S.readFileSync(r,"utf-8").replace(/nameservers: \[.*?\]/s,`nameservers: [${e.map((t)=>`'${T(t)}'`).join(", ")}]`);S.writeFileSync(r,n,"utf-8"),c.info("Nameservers have been set.")}catch(r){c.error("Error updating nameservers:",r)}}async function ie(e){try{let r=new y,{HostedZones:s}=await r.listHostedZonesByName({DNSName:e});if(!s||s.length===0)return m(g(`No hosted zones found for domain ${e}`));let n=s[0];if(n&&n.Name===`${e}.`)return h(n.Id);return h(null)}catch(r){return m(g(`Failed to find hosted zone for domain ${e}`,r))}}async function F(e){if(c.debug("Getting nameservers for domain:",e),!e)return[];try{return(await new x().getDomainDetail({DomainName:e}))?.Nameservers?.map((n)=>n.Name)||[]}catch(r){return c.debug("Domain not registered via Route53 Domains:",r),[]}}async function ae(e){c.debug("Getting hosted zone nameservers for domain:",e);try{let r=new y,n=(await r.listHostedZonesByName({DNSName:e})).HostedZones?.find((i)=>i.Name===`${e}.`);if(!n)return c.debug("No hosted zone found for domain:",e),[];return(await r.getHostedZone({Id:n.Id})).DelegationSet?.NameServers||[]}catch(r){return g("Error getting hosted zone nameservers",r),[]}}async function j(e,r){if(!r)r=w.app.url;let s=await F(r);if(!s||s.length===0)return c.debug("Domain is not registered via Route53 Domains - skipping automatic nameserver update"),A(e),!1;if(JSON.stringify(s.sort())!==JSON.stringify(e.sort())){c.info("Updating your domain nameservers to match the ones in your hosted zone..."),c.debug("Hosted zone nameservers:",e),c.debug("Domain nameservers:",s);try{return await new x().updateDomainNameservers({DomainName:r,Nameservers:e.map((t)=>({Name:t}))}),A(e),c.info("Nameservers updated."),!0}catch(n){return c.debug("Failed to update nameservers via Route53 Domains:",n),A(e),!1}}return c.success("Your nameservers are up to date."),!0}async function ce(e){if(c.debug("Checking if domain has been added to cloud..."),!e)e=w.app.url;if(e=I(e),!e)return!1;c.debug("domainName:",e);let r=new y,s=await r.listHostedZonesByName({DNSName:e});if(c.debug("Existing hosted zones:",s),!s||!s.HostedZones||s.HostedZones.length===0)return!1;let n=s.HostedZones.find((t)=>t.Name===`${e}.`);if(n){c.debug("Hosted zone found:",n);let i=(await r.getHostedZone({Id:n.Id})).DelegationSet?.NameServers||[];return await j(i,e),!0}return!1}async function de(e){return await k(E.DomainsAdd,e)}import{promises as M}from"dns";import{DnsProviderFactory as B}from"@stacksjs/ts-cloud";var O=new Set(["A","AAAA","CNAME"]);function R(e){let r=e==="auto"||e==null?600:e;return Math.max(600,r)}function D(e,r){let s=p(e);if(r==="@"||r==="")return e;if(r.endsWith("."))return p(r);let n=p(r);if(n===s||n.endsWith(`.${s}`))return n;return`${r}.${e}`}function p(e){return e.replace(/\.$/,"").toLowerCase()}function Z(e){return e.replace(/^"(.*)"$/s,"$1")}function X(e){if(e.type==="A")return!/^(?:0\.|10\.|127\.|169\.254\.|192\.168\.|172\.(?:1[6-9]|2\d|3[01])\.)/.test(e.content);if(e.type==="AAAA")return!/^(?:::1$|fe80:|f[cd])/i.test(e.content);return!0}function L(e,r,s){let n=(s==="A"?r.a:r.aaaa)??[];for(let t of n){if(D(e,t.name)!==p(e))continue;if(!t.address||t.address==="@")continue;return t.address}return null}function W(e,r){let s=[],n=(t,i)=>t==="@"?L(e,r,i)??"@":t;for(let t of r.txt??[])s.push({name:D(e,t.name),type:"TXT",content:t.content,ttl:R(t.ttl)});for(let t of r.a??[])s.push({name:D(e,t.name),type:"A",content:n(t.address,"A"),ttl:R(t.ttl)});for(let t of r.aaaa??[])s.push({name:D(e,t.name),type:"AAAA",content:n(t.address,"AAAA"),ttl:R(t.ttl)});for(let t of r.cname??[])s.push({name:D(e,t.name),type:"CNAME",content:t.target==="@"?e:t.target,ttl:R(t.ttl)});for(let t of r.mx??[])s.push({name:D(e,t.name),type:"MX",content:t.mailServer,ttl:R(t.ttl),priority:t.priority});return s}function G(e,r){if((e.type==="A"||e.type==="AAAA")&&e.content==="@")return`address "@" copies the apex ${e.type} record, and config/dns.ts declares none`;if(!X(e))return`${e.content} is a private, loopback or placeholder address and is never published`;if(r){let s=p(e.name),n=p(r);if(s!==n&&!s.endsWith(`.${n}`))return`${e.name} is outside the ${r} zone`}return null}function J(e,r,s={}){let n=e.map((t)=>{let i=G(t,s.zone);if(i)return{record:t,action:"skip",reason:i};let a=p(t.name),u=r.filter((o)=>o.type===t.type&&p(o.name)===a),l=O.has(t.type)?u.length>0:u.some((o)=>Z(o.content)===Z(t.content));return{record:t,action:l?"keep":"create"}});return{items:n,create:n.filter((t)=>t.action==="create").map((t)=>t.record),keep:n.filter((t)=>t.action==="keep").map((t)=>t.record),skip:n.filter((t)=>t.action==="skip").map((t)=>({record:t.record,reason:t.reason??"not publishable"}))}}async function U(e,r=[],s=M){let n=(o)=>o.catch(()=>[]),t=p(e),i=[...r].map(p).filter((o)=>o===t||o.endsWith(`.${t}`)),a=[...new Set([t,`www.${t}`,...i])],u=await Promise.all(a.map(async(o)=>{let d=o===t?[]:await n(s.resolveCname(o));if(d.length)return d.map((f)=>({name:o,type:"CNAME",content:p(f),ttl:600}));let[b,P,C,N]=await Promise.all([n(s.resolve4(o)),n(s.resolve6(o)),n(s.resolveTxt(o)),n(s.resolveMx(o))]);return[...b.map((f)=>({name:o,type:"A",content:f,ttl:600})),...P.map((f)=>({name:o,type:"AAAA",content:f,ttl:600})),...C.map((f)=>({name:o,type:"TXT",content:f.join(""),ttl:600})),...N.map((f)=>({name:o,type:"MX",content:f.exchange,ttl:600,priority:f.priority}))]})),l=await n(s.resolveNs(t));return[...u.flat(),...l.map((o)=>({name:t,type:"NS",content:o,ttl:600}))]}async function q(e){try{return await new B().loadFromEnv().getProviderForDomain(e)}catch{return null}}function v(e,r){let s=p(r);if(s===p(e))return"@";return s.endsWith(`.${p(e)}`)?s.slice(0,-(e.length+1)):s}function fe(e,r){let s=(o)=>r.filter((d)=>d.type===o),n=["import type { DnsConfig } from '@stacksjs/types'","",`// Records for ${e}, pulled from live DNS via \`buddy dns:pull\`.`,"const dns: DnsConfig = {"];if([...s("A"),...s("AAAA")].length){n.push(" a: [");for(let d of s("A"))n.push(` { name: '${v(e,d.name)}', address: '${d.content}', ttl: 600 },`);n.push(" ],");let o=s("AAAA");if(o.length){n.push(" aaaa: [");for(let d of o)n.push(` { name: '${v(e,d.name)}', address: '${d.content}', ttl: 600 },`);n.push(" ],")}}let i=s("CNAME");if(i.length){n.push(" cname: [");for(let o of i)n.push(` { name: '${v(e,o.name)}', target: '${o.content}', ttl: 'auto' },`);n.push(" ],")}let a=s("TXT");if(a.length){n.push(" txt: [");for(let o of a)n.push(` { name: '${v(e,o.name)}', ttl: 'auto', content: ${JSON.stringify(Z(o.content))} },`);n.push(" ],")}let u=s("MX");if(u.length){n.push(" mx: [");for(let o of u)n.push(` { name: '${v(e,o.name)}', mailServer: '${o.content}', ttl: 'auto', priority: ${o.priority??10} },`);n.push(" ],")}let l=s("NS");if(l.length)n.push(` nameservers: [${l.map((o)=>`'${p(o.content)}'`).join(", ")}],`);return n.push("}","","export default dns",""),n.join(`
5
+ `)}async function ge(e,r,s={}){let n=W(e,r),t=s.dryRun?null:s.provider??await q(e),i=t?(await t.listRecords(e)).records??[]:await U(e,n.map((o)=>o.name),s.resolver),a=J(n,i,{zone:e});if(s.dryRun||!t)return{plan:a,created:0,kept:a.keep.length,failed:0,failures:[],skipped:a.skip,applied:!1,provider:t?.name??null};let u=0,l=[];for(let o of a.create)try{let d=await t.createRecord(e,o);if(d.success)u+=1;else l.push({record:o,reason:d.message?.trim()||`${t.name} rejected the record without a message`})}catch(d){l.push({record:o,reason:d instanceof Error?d.message:String(d)})}return{plan:a,created:u,kept:a.keep.length,failed:l.length,failures:l,skipped:a.skip,applied:!0,provider:t.name}}export{de as addDomain,oe as createHostedZone,re as deleteHostedZone,se as deleteHostedZoneRecords,W as desiredDnsRecords,q as dnsProviderForDomain,ie as findHostedZone,ae as getHostedZoneNameservers,F as getNameservers,ce as hasUserDomainBeenAddedToCloud,J as planDnsSync,fe as renderDnsConfig,U as resolveLiveRecords,ge as syncDnsConfig,j as updateNameservers,A as writeNameserversToConfig};
package/dist/sync.d.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { promises as resolver } from 'node:dns';
1
2
  import type { DnsConfig } from '@stacksjs/types';
2
3
  import type { DnsProvider, DnsRecord } from '@stacksjs/ts-cloud';
3
4
  /**
@@ -14,8 +15,13 @@ export declare function planDnsSync(desired: DnsRecord[], current: DnsRecord[],
14
15
  /**
15
16
  * Read a zone's live records over public DNS (no registrar credentials). Used by
16
17
  * `pull`, and by `sync`/`diff` as a fallback when no provider is configured.
18
+ *
19
+ * The apex and `www` are always read, and so is every name in `names`. Only
20
+ * those two used to be, so a declared `_dmarc` TXT, a DKIM key or a `www` CNAME
21
+ * was never looked up and `dns:diff` listed it as missing however long it had
22
+ * been live (stacksjs/stacks#3153).
17
23
  */
18
- export declare function resolveLiveRecords(domain: string): Promise<DnsRecord[]>;
24
+ export declare function resolveLiveRecords(domain: string, names?: Iterable<string>, lookup?: DnsResolver): Promise<DnsRecord[]>;
19
25
  /**
20
26
  * Resolve a registrar provider for a domain from environment credentials
21
27
  * (`PORKBUN_API_KEY`/`PORKBUN_SECRET_KEY`, AWS, GoDaddy, Cloudflare). Returns
@@ -31,7 +37,7 @@ export declare function renderDnsConfig(domain: string, records: DnsRecord[]): s
31
37
  * is read from the provider when credentials are available, else from public
32
38
  * DNS. With `dryRun` (or no provider) it computes the plan without writing.
33
39
  */
34
- export declare function syncDnsConfig(domain: string, cfg: DnsConfig, options?: { dryRun?: boolean, provider?: DnsProvider | null }): Promise<DnsSyncResult>;
40
+ export declare function syncDnsConfig(domain: string, cfg: DnsConfig, options?: { dryRun?: boolean, provider?: DnsProvider | null, resolver?: DnsResolver }): Promise<DnsSyncResult>;
35
41
  export declare interface DnsPlanItem {
36
42
  record: DnsRecord
37
43
  action: 'create' | 'keep' | 'skip'
@@ -47,6 +53,15 @@ export declare interface DnsPlan {
47
53
  keep: DnsRecord[]
48
54
  skip: DnsSkippedRecord[]
49
55
  }
56
+ /** The `node:dns` lookups `resolveLiveRecords()` makes. A test passes its own. */
57
+ export declare interface DnsResolver {
58
+ resolve4: (name: string) => Promise<string[]>
59
+ resolve6: (name: string) => Promise<string[]>
60
+ resolveCname: (name: string) => Promise<string[]>
61
+ resolveTxt: (name: string) => Promise<string[][]>
62
+ resolveMx: (name: string) => Promise<{ priority: number, exchange: string }[]>
63
+ resolveNs: (name: string) => Promise<string[]>
64
+ }
50
65
  export declare interface DnsSyncFailure {
51
66
  record: DnsRecord
52
67
  reason: string
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@stacksjs/dns",
3
3
  "type": "module",
4
- "version": "0.75.452",
4
+ "version": "0.75.458",
5
5
  "description": "Easily manage your DNS.",
6
6
  "author": "Chris Breuer",
7
7
  "contributors": [
@@ -60,19 +60,19 @@
60
60
  "prepublishOnly": "bun run build"
61
61
  },
62
62
  "dependencies": {
63
- "@stacksjs/action-runner": "0.75.452",
64
- "@stacksjs/config": "0.75.452",
63
+ "@stacksjs/action-runner": "0.75.458",
64
+ "@stacksjs/config": "0.75.458",
65
65
  "@stacksjs/dnsx": "^0.2.3",
66
- "@stacksjs/enums": "0.75.452",
67
- "@stacksjs/error-handling": "0.75.452",
68
- "@stacksjs/logging": "0.75.452",
69
- "@stacksjs/path": "0.75.452",
70
- "@stacksjs/storage": "0.75.452",
66
+ "@stacksjs/enums": "0.75.458",
67
+ "@stacksjs/error-handling": "0.75.458",
68
+ "@stacksjs/logging": "0.75.458",
69
+ "@stacksjs/path": "0.75.458",
70
+ "@stacksjs/storage": "0.75.458",
71
71
  "@stacksjs/ts-cloud": "^0.16.91"
72
72
  },
73
73
  "devDependencies": {
74
- "@stacksjs/strings": "0.75.452",
75
- "@stacksjs/whois": "0.75.452",
74
+ "@stacksjs/strings": "0.75.458",
75
+ "@stacksjs/whois": "0.75.458",
76
76
  "better-dx": "^0.2.24"
77
77
  },
78
78
  "sideEffects": false