@stacksjs/dns 0.72.54 → 0.72.56

package/dist/index.js

@@ -1,5 +1,5 @@
 // @bun
-import{runAction as H}from"@stacksjs/actions";import{config as E}from"@stacksjs/config";import{Action as z}from"@stacksjs/enums";import{err as V,handleError as U,ok as A}from"@stacksjs/error-handling";import{log as G}from"@stacksjs/logging";import{path as k}from"@stacksjs/path";import{fs as C}from"@stacksjs/storage";import{Route53Client as L,Route53DomainsClient as R}from"@stacksjs/ts-cloud";function x(B){if(!B)return;return B.replace(/^https?:\/\//,"").replace(/\/$/,"")}async function T(B,M){let Q=await B.listHostedZonesByName({DNSName:M});if(!Q||!Q.HostedZones||Q.HostedZones.length===0)return V(U(`No hosted zones found for domain: ${M}`));let K=Q.HostedZones.find(($)=>$.Name===`${M}.`);if(!K)return V(U(`Hosted Zone not found for domain: ${M}`));let X=await B.listResourceRecordSets({HostedZoneId:K.Id});if(!X||!X.ResourceRecordSets)return V(U(`No DNS records found for domain: ${M}`));let Y=X.ResourceRecordSets.filter(($)=>$.Type!=="NS"&&$.Type!=="SOA").map(($)=>({Action:"DELETE",ResourceRecordSet:$}));if(Y.length>0)try{await B.changeResourceRecordSets({HostedZoneId:K.Id,ChangeBatch:{Changes:Y}})}catch($){G.warn(`Batch delete failed (${Y.length} records), falling back to individual deletion`);let J=[];for(let I of Y)try{await B.changeResourceRecordSets({HostedZoneId:K.Id,ChangeBatch:{Changes:[I]}})}catch(W){J.push(`${I.ResourceRecordSet.Name} (${I.ResourceRecordSet.Type}): ${W.message}`)}if(J.length>0)return V(U(`Failed to delete ${J.length} DNS record(s):
+import{runAction as H}from"@stacksjs/actions";import{config as E}from"@stacksjs/config";import{Action as k}from"@stacksjs/enums";import{err as L,handleError as _,ok as P}from"@stacksjs/error-handling";import{log as I}from"@stacksjs/logging";import{path as b}from"@stacksjs/path";import{fs as C}from"@stacksjs/storage";import{Route53Client as A,Route53DomainsClient as T}from"@stacksjs/ts-cloud";function x(B){if(!B)return;return B.replace(/^https?:\/\//,"").replace(/\/$/,"")}async function R(B,K){let W=await B.listHostedZonesByName({DNSName:K});if(!W||!W.HostedZones||W.HostedZones.length===0)return L(_(`No hosted zones found for domain: ${K}`));let Q=W.HostedZones.find(($)=>$.Name===`${K}.`);if(!Q)return L(_(`Hosted Zone not found for domain: ${K}`));let M=await B.listResourceRecordSets({HostedZoneId:Q.Id});if(!M||!M.ResourceRecordSets)return L(_(`No DNS records found for domain: ${K}`));let Y=M.ResourceRecordSets.filter(($)=>$.Type!=="NS"&&$.Type!=="SOA").map(($)=>({Action:"DELETE",ResourceRecordSet:$}));if(Y.length>0)try{await B.changeResourceRecordSets({HostedZoneId:Q.Id,ChangeBatch:{Changes:Y}})}catch($){I.warn(`Batch delete failed (${Y.length} records), falling back to individual deletion`);let J=[];for(let G of Y)try{await B.changeResourceRecordSets({HostedZoneId:Q.Id,ChangeBatch:{Changes:[G]}})}catch(X){J.push(`${G.ResourceRecordSet.Name} (${G.ResourceRecordSet.Type}): ${X.message}`)}if(J.length>0)return L(_(`Failed to delete ${J.length} DNS record(s):
 ${J.join(`
-`)}`))}return A(K)}async function r(B){let M=new L,Q=await T(M,B);if(Q.isErr)return V(U(`Failed to delete records for zone: ${B}`));let K=Q.unwrap();return await M.deleteHostedZone({Id:K.Id}),G.info(`Deleted Hosted Zone for domain: ${B}`),A("success")}async function a(B){let M=new L;if((await T(M,B)).isErr)return V(U(`Failed to delete records for zone: ${B}`));return G.info(`Deleted DNS records for domain: ${B}`),A("success")}async function n(B){let M=new L,K=(await M.listHostedZonesByName({DNSName:B})).HostedZones?.find((Y)=>Y.Name===`${B}.`);if(K)return A(K);let X=await M.createHostedZone({Name:B,CallerReference:`${Date.now()}`});if(!X.HostedZone)return V(U("Failed to create hosted zone"));return A(X)}function b(B){if(!/^[a-zA-Z0-9.-]+$/.test(B))throw Error(`Invalid nameserver value: ${B}`);return B}function S(B){try{let M=k.projectConfigPath("dns.ts"),K=C.readFileSync(M,"utf-8").replace(/nameservers: \[.*?\]/s,`nameservers: [${B.map((X)=>`'${b(X)}'`).join(", ")}]`);C.writeFileSync(M,K,"utf-8"),G.info("Nameservers have been set.")}catch(M){G.error("Error updating nameservers:",M)}}async function o(B){try{let M=new L,{HostedZones:Q}=await M.listHostedZonesByName({DNSName:B});if(!Q||Q.length===0)return V(U(`No hosted zones found for domain ${B}`));let K=Q[0];if(K&&K.Name===`${B}.`)return A(K.Id);return A(null)}catch(M){return V(U(`Failed to find hosted zone for domain ${B}`,M))}}async function w(B){if(G.debug("Getting nameservers for domain:",B),!B)return[];try{return(await new R().getDomainDetail({DomainName:B}))?.Nameservers?.map((K)=>K.Name)||[]}catch(M){return G.debug("Domain not registered via Route53 Domains:",M),[]}}async function e(B){G.debug("Getting hosted zone nameservers for domain:",B);try{let M=new L,K=(await M.listHostedZonesByName({DNSName:B})).HostedZones?.find((Y)=>Y.Name===`${B}.`);if(!K)return G.debug("No hosted zone found for domain:",B),[];return(await M.getHostedZone({Id:K.Id})).DelegationSet?.NameServers||[]}catch(M){return U("Error getting hosted zone nameservers",M),[]}}async function y(B,M){if(!M)M=E.app.url;let Q=await w(M);if(!Q||Q.length===0)return G.debug("Domain is not registered via Route53 Domains - skipping automatic nameserver update"),S(B),!1;if(JSON.stringify(Q.sort())!==JSON.stringify(B.sort())){G.info("Updating your domain nameservers to match the ones in your hosted zone..."),G.debug("Hosted zone nameservers:",B),G.debug("Domain nameservers:",Q);try{return await new R().updateDomainNameservers({DomainName:M,Nameservers:B.map((X)=>({Name:X}))}),S(B),G.info("Nameservers updated."),!0}catch(K){return G.debug("Failed to update nameservers via Route53 Domains:",K),S(B),!1}}return G.success("Your nameservers are up to date."),!0}async function BB(B){if(G.debug("Checking if domain has been added to cloud..."),!B)B=E.app.url;if(B=x(B),!B)return!1;G.debug("domainName:",B);let M=new L,Q=await M.listHostedZonesByName({DNSName:B});if(G.debug("Existing hosted zones:",Q),!Q||!Q.HostedZones||Q.HostedZones.length===0)return!1;let K=Q.HostedZones.find((X)=>X.Name===`${B}.`);if(K){G.debug("Hosted zone found:",K);let Y=(await M.getHostedZone({Id:K.Id})).DelegationSet?.NameServers||[];return await y(Y,B),!0}return!1}async function KB(B){return await H(z.DomainsAdd,B)}import{promises as P}from"dns";import{DnsProviderFactory as f}from"@stacksjs/ts-cloud";var Z=new Set(["A","AAAA","CNAME"]);function j(B){let M=B==="auto"||B==null?600:B;return Math.max(600,M)}function D(B,M){return M==="@"||M===""?B:`${M}.${B}`}function O(B){return B.replace(/\.$/,"").toLowerCase()}function q(B){return B.replace(/^"(.*)"$/s,"$1")}function v(B){if(B.type==="A")return!/^(?:0\.|10\.|127\.|169\.254\.|192\.168\.|172\.(?:1[6-9]|2\d|3[01])\.)/.test(B.content);if(B.type==="AAAA")return!/^(?:::1$|fe80:|f[cd])/i.test(B.content);return!0}function p(B,M){let Q=[];for(let K of M.txt??[])Q.push({name:D(B,K.name),type:"TXT",content:K.content,ttl:j(K.ttl)});for(let K of M.a??[])Q.push({name:D(B,K.name),type:"A",content:K.address,ttl:j(K.ttl)});for(let K of M.aaaa??[])Q.push({name:D(B,K.name),type:"AAAA",content:K.address,ttl:j(K.ttl)});for(let K of M.cname??[])Q.push({name:D(B,K.name),type:"CNAME",content:K.target,ttl:j(K.ttl)});for(let K of M.mx??[])Q.push({name:D(B,K.name),type:"MX",content:K.mailServer,ttl:j(K.ttl),priority:K.priority});return Q}function h(B,M){let Q=B.map((K)=>{let X=O(K.name),Y=M.filter((J)=>J.type===K.type&&O(J.name)===X),$=Z.has(K.type)?Y.length>0:Y.some((J)=>q(J.content)===q(K.content));return{record:K,action:!$&&v(K)?"create":"keep"}});return{items:Q,create:Q.filter((K)=>K.action==="create").map((K)=>K.record),keep:Q.filter((K)=>K.action==="keep").map((K)=>K.record)}}async function g(B){let M=async(W)=>W.catch(()=>[]),[Q,K,X,Y,$,J]=await Promise.all([M(P.resolve4(B)),M(P.resolve4(`www.${B}`)),M(P.resolve6(B)),M(P.resolveTxt(B)),M(P.resolveMx(B)),M(P.resolveNs(B))]),I=[];for(let W of Q)I.push({name:B,type:"A",content:W,ttl:600});for(let W of K)I.push({name:`www.${B}`,type:"A",content:W,ttl:600});for(let W of X)I.push({name:B,type:"AAAA",content:W,ttl:600});for(let W of Y)I.push({name:B,type:"TXT",content:W.join(""),ttl:600});for(let W of $)I.push({name:B,type:"MX",content:W.exchange,ttl:600,priority:W.priority});for(let W of J)I.push({name:B,type:"NS",content:W,ttl:600});return I}async function c(B){try{return await new f().loadFromEnv().getProviderForDomain(B)}catch{return null}}function F(B,M){let Q=O(M);if(Q===O(B))return"@";return Q.endsWith(`.${O(B)}`)?Q.slice(0,-(B.length+1)):Q}function XB(B,M){let Q=(W)=>M.filter((_)=>_.type===W),K=["import type { DnsConfig } from '@stacksjs/types'","",`// Records for ${B}, pulled from live DNS via \`buddy dns:pull\`.`,"const dns: DnsConfig = {"];if([...Q("A"),...Q("AAAA")].length){K.push("  a: [");for(let _ of Q("A"))K.push(`    { name: '${F(B,_.name)}', address: '${_.content}', ttl: 600 },`);K.push("  ],");let W=Q("AAAA");if(W.length){K.push("  aaaa: [");for(let _ of W)K.push(`    { name: '${F(B,_.name)}', address: '${_.content}', ttl: 600 },`);K.push("  ],")}}let Y=Q("CNAME");if(Y.length){K.push("  cname: [");for(let W of Y)K.push(`    { name: '${F(B,W.name)}', target: '${W.content}', ttl: 'auto' },`);K.push("  ],")}let $=Q("TXT");if($.length){K.push("  txt: [");for(let W of $)K.push(`    { name: '${F(B,W.name)}', ttl: 'auto', content: ${JSON.stringify(q(W.content))} },`);K.push("  ],")}let J=Q("MX");if(J.length){K.push("  mx: [");for(let W of J)K.push(`    { name: '${F(B,W.name)}', mailServer: '${W.content}', ttl: 'auto', priority: ${W.priority??10} },`);K.push("  ],")}let I=Q("NS");if(I.length)K.push(`  nameservers: [${I.map((W)=>`'${O(W.content)}'`).join(", ")}],`);return K.push("}","","export default dns",""),K.join(`
-`)}async function YB(B,M,Q={}){let K=p(B,M),X=Q.dryRun?null:Q.provider??await c(B),Y=X?(await X.listRecords(B)).records??[]:await g(B),$=h(K,Y);if(Q.dryRun||!X)return{plan:$,created:0,kept:$.keep.length,failed:0,applied:!1,provider:X?.name??null};let J=0,I=0;for(let W of $.create)try{if((await X.createRecord(B,W)).success)J+=1;else I+=1}catch{I+=1}return{plan:$,created:J,kept:$.keep.length,failed:I,applied:!0,provider:X.name}}export{S as writeNameserversToConfig,y as updateNameservers,YB as syncDnsConfig,g as resolveLiveRecords,XB as renderDnsConfig,h as planDnsSync,BB as hasUserDomainBeenAddedToCloud,w as getNameservers,e as getHostedZoneNameservers,o as findHostedZone,c as dnsProviderForDomain,p as desiredDnsRecords,a as deleteHostedZoneRecords,r as deleteHostedZone,n as createHostedZone,KB as addDomain};
+`)}`))}return P(Q)}async function n(B){let K=new A,W=await R(K,B);if(W.isErr)return L(_(`Failed to delete records for zone: ${B}`));let Q=W.unwrap();return await K.deleteHostedZone({Id:Q.Id}),I.info(`Deleted Hosted Zone for domain: ${B}`),P("success")}async function o(B){let K=new A;if((await R(K,B)).isErr)return L(_(`Failed to delete records for zone: ${B}`));return I.info(`Deleted DNS records for domain: ${B}`),P("success")}async function e(B){let K=new A,Q=(await K.listHostedZonesByName({DNSName:B})).HostedZones?.find((Y)=>Y.Name===`${B}.`);if(Q)return P(Q);let M=await K.createHostedZone({Name:B,CallerReference:`${Date.now()}`});if(!M.HostedZone)return L(_("Failed to create hosted zone"));return P(M)}function w(B){if(!/^[a-zA-Z0-9.-]+$/.test(B))throw Error(`Invalid nameserver value: ${B}`);return B}function F(B){try{let K=b.projectConfigPath("dns.ts"),Q=C.readFileSync(K,"utf-8").replace(/nameservers: \[.*?\]/s,`nameservers: [${B.map((M)=>`'${w(M)}'`).join(", ")}]`);C.writeFileSync(K,Q,"utf-8"),I.info("Nameservers have been set.")}catch(K){I.error("Error updating nameservers:",K)}}async function BB(B){try{let K=new A,{HostedZones:W}=await K.listHostedZonesByName({DNSName:B});if(!W||W.length===0)return L(_(`No hosted zones found for domain ${B}`));let Q=W[0];if(Q&&Q.Name===`${B}.`)return P(Q.Id);return P(null)}catch(K){return L(_(`Failed to find hosted zone for domain ${B}`,K))}}async function y(B){if(I.debug("Getting nameservers for domain:",B),!B)return[];try{return(await new T().getDomainDetail({DomainName:B}))?.Nameservers?.map((Q)=>Q.Name)||[]}catch(K){return I.debug("Domain not registered via Route53 Domains:",K),[]}}async function KB(B){I.debug("Getting hosted zone nameservers for domain:",B);try{let K=new A,Q=(await K.listHostedZonesByName({DNSName:B})).HostedZones?.find((Y)=>Y.Name===`${B}.`);if(!Q)return I.debug("No hosted zone found for domain:",B),[];return(await K.getHostedZone({Id:Q.Id})).DelegationSet?.NameServers||[]}catch(K){return _("Error getting hosted zone nameservers",K),[]}}async function z(B,K){if(!K)K=E.app.url;let W=await y(K);if(!W||W.length===0)return I.debug("Domain is not registered via Route53 Domains - skipping automatic nameserver update"),F(B),!1;if(JSON.stringify(W.sort())!==JSON.stringify(B.sort())){I.info("Updating your domain nameservers to match the ones in your hosted zone..."),I.debug("Hosted zone nameservers:",B),I.debug("Domain nameservers:",W);try{return await new T().updateDomainNameservers({DomainName:K,Nameservers:B.map((M)=>({Name:M}))}),F(B),I.info("Nameservers updated."),!0}catch(Q){return I.debug("Failed to update nameservers via Route53 Domains:",Q),F(B),!1}}return I.success("Your nameservers are up to date."),!0}async function MB(B){if(I.debug("Checking if domain has been added to cloud..."),!B)B=E.app.url;if(B=x(B),!B)return!1;I.debug("domainName:",B);let K=new A,W=await K.listHostedZonesByName({DNSName:B});if(I.debug("Existing hosted zones:",W),!W||!W.HostedZones||W.HostedZones.length===0)return!1;let Q=W.HostedZones.find((M)=>M.Name===`${B}.`);if(Q){I.debug("Hosted zone found:",Q);let Y=(await K.getHostedZone({Id:Q.Id})).DelegationSet?.NameServers||[];return await z(Y,B),!0}return!1}async function QB(B){return await H(k.DomainsAdd,B)}import{promises as O}from"dns";import{DnsProviderFactory as f}from"@stacksjs/ts-cloud";var Z=new Set(["A","AAAA","CNAME"]);function S(B){let K=B==="auto"||B==null?600:B;return Math.max(600,K)}function D(B,K){let W=V(B);if(K==="@"||K==="")return B;if(K.endsWith("."))return V(K);let Q=V(K);if(Q===W||Q.endsWith(`.${W}`))return Q;return`${K}.${B}`}function V(B){return B.replace(/\.$/,"").toLowerCase()}function q(B){return B.replace(/^"(.*)"$/s,"$1")}function v(B){if(B.type==="A")return!/^(?:0\.|10\.|127\.|169\.254\.|192\.168\.|172\.(?:1[6-9]|2\d|3[01])\.)/.test(B.content);if(B.type==="AAAA")return!/^(?:::1$|fe80:|f[cd])/i.test(B.content);return!0}function p(B,K,W){let Q=(W==="A"?K.a:K.aaaa)??[];for(let M of Q){if(D(B,M.name)!==V(B))continue;if(!M.address||M.address==="@")continue;return M.address}return null}function h(B,K){let W=[],Q=(M,Y)=>M==="@"?p(B,K,Y)??"@":M;for(let M of K.txt??[])W.push({name:D(B,M.name),type:"TXT",content:M.content,ttl:S(M.ttl)});for(let M of K.a??[])W.push({name:D(B,M.name),type:"A",content:Q(M.address,"A"),ttl:S(M.ttl)});for(let M of K.aaaa??[])W.push({name:D(B,M.name),type:"AAAA",content:Q(M.address,"AAAA"),ttl:S(M.ttl)});for(let M of K.cname??[])W.push({name:D(B,M.name),type:"CNAME",content:M.target==="@"?B:M.target,ttl:S(M.ttl)});for(let M of K.mx??[])W.push({name:D(B,M.name),type:"MX",content:M.mailServer,ttl:S(M.ttl),priority:M.priority});return W}function g(B,K){if((B.type==="A"||B.type==="AAAA")&&B.content==="@")return`address "@" copies the apex ${B.type} record, and config/dns.ts declares none`;if(!v(B))return`${B.content} is a private, loopback or placeholder address and is never published`;if(K){let W=V(B.name),Q=V(K);if(W!==Q&&!W.endsWith(`.${Q}`))return`${B.name} is outside the ${K} zone`}return null}function u(B,K,W={}){let Q=B.map((M)=>{let Y=g(M,W.zone);if(Y)return{record:M,action:"skip",reason:Y};let $=V(M.name),J=K.filter((X)=>X.type===M.type&&V(X.name)===$),G=Z.has(M.type)?J.length>0:J.some((X)=>q(X.content)===q(M.content));return{record:M,action:G?"keep":"create"}});return{items:Q,create:Q.filter((M)=>M.action==="create").map((M)=>M.record),keep:Q.filter((M)=>M.action==="keep").map((M)=>M.record),skip:Q.filter((M)=>M.action==="skip").map((M)=>({record:M.record,reason:M.reason??"not publishable"}))}}async function c(B){let K=async(X)=>X.catch(()=>[]),[W,Q,M,Y,$,J]=await Promise.all([K(O.resolve4(B)),K(O.resolve4(`www.${B}`)),K(O.resolve6(B)),K(O.resolveTxt(B)),K(O.resolveMx(B)),K(O.resolveNs(B))]),G=[];for(let X of W)G.push({name:B,type:"A",content:X,ttl:600});for(let X of Q)G.push({name:`www.${B}`,type:"A",content:X,ttl:600});for(let X of M)G.push({name:B,type:"AAAA",content:X,ttl:600});for(let X of Y)G.push({name:B,type:"TXT",content:X.join(""),ttl:600});for(let X of $)G.push({name:B,type:"MX",content:X.exchange,ttl:600,priority:X.priority});for(let X of J)G.push({name:B,type:"NS",content:X,ttl:600});return G}async function N(B){try{return await new f().loadFromEnv().getProviderForDomain(B)}catch{return null}}function j(B,K){let W=V(K);if(W===V(B))return"@";return W.endsWith(`.${V(B)}`)?W.slice(0,-(B.length+1)):W}function $B(B,K){let W=(X)=>K.filter((U)=>U.type===X),Q=["import type { DnsConfig } from '@stacksjs/types'","",`// Records for ${B}, pulled from live DNS via \`buddy dns:pull\`.`,"const dns: DnsConfig = {"];if([...W("A"),...W("AAAA")].length){Q.push("  a: [");for(let U of W("A"))Q.push(`    { name: '${j(B,U.name)}', address: '${U.content}', ttl: 600 },`);Q.push("  ],");let X=W("AAAA");if(X.length){Q.push("  aaaa: [");for(let U of X)Q.push(`    { name: '${j(B,U.name)}', address: '${U.content}', ttl: 600 },`);Q.push("  ],")}}let Y=W("CNAME");if(Y.length){Q.push("  cname: [");for(let X of Y)Q.push(`    { name: '${j(B,X.name)}', target: '${X.content}', ttl: 'auto' },`);Q.push("  ],")}let $=W("TXT");if($.length){Q.push("  txt: [");for(let X of $)Q.push(`    { name: '${j(B,X.name)}', ttl: 'auto', content: ${JSON.stringify(q(X.content))} },`);Q.push("  ],")}let J=W("MX");if(J.length){Q.push("  mx: [");for(let X of J)Q.push(`    { name: '${j(B,X.name)}', mailServer: '${X.content}', ttl: 'auto', priority: ${X.priority??10} },`);Q.push("  ],")}let G=W("NS");if(G.length)Q.push(`  nameservers: [${G.map((X)=>`'${V(X.content)}'`).join(", ")}],`);return Q.push("}","","export default dns",""),Q.join(`
+`)}async function GB(B,K,W={}){let Q=h(B,K),M=W.dryRun?null:W.provider??await N(B),Y=M?(await M.listRecords(B)).records??[]:await c(B),$=u(Q,Y,{zone:B});if(W.dryRun||!M)return{plan:$,created:0,kept:$.keep.length,failed:0,failures:[],skipped:$.skip,applied:!1,provider:M?.name??null};let J=0,G=[];for(let X of $.create)try{let U=await M.createRecord(B,X);if(U.success)J+=1;else G.push({record:X,reason:U.message?.trim()||`${M.name} rejected the record without a message`})}catch(U){G.push({record:X,reason:U instanceof Error?U.message:String(U)})}return{plan:$,created:J,kept:$.keep.length,failed:G.length,failures:G,skipped:$.skip,applied:!0,provider:M.name}}export{F as writeNameserversToConfig,z as updateNameservers,GB as syncDnsConfig,c as resolveLiveRecords,$B as renderDnsConfig,u as planDnsSync,MB as hasUserDomainBeenAddedToCloud,y as getNameservers,KB as getHostedZoneNameservers,BB as findHostedZone,N as dnsProviderForDomain,h as desiredDnsRecords,o as deleteHostedZoneRecords,n as deleteHostedZone,e as createHostedZone,QB as addDomain};

package/dist/sync.d.ts

@@ -7,10 +7,10 @@ import type { DnsProvider, DnsRecord } from '@stacksjs/ts-cloud';
 export declare function desiredDnsRecords(domain: string, cfg: DnsConfig): DnsRecord[];
 /**
  * Build the additive reconciliation plan: which declared records are missing
- * (create) and which are already satisfied (keep). Never plans a delete or an
- * overwrite.
+ * (create), which are already satisfied (keep), and which cannot be published
+ * at all (skip). Never plans a delete or an overwrite.
  */
-export declare function planDnsSync(desired: DnsRecord[], current: DnsRecord[]): DnsPlan;
+export declare function planDnsSync(desired: DnsRecord[], current: DnsRecord[], options?: { zone?: string }): DnsPlan;
 /**
  * Read a zone's live records over public DNS (no registrar credentials). Used by
  * `pull`, and by `sync`/`diff` as a fallback when no provider is configured.
@@ -34,18 +34,30 @@ export declare function renderDnsConfig(domain: string, records: DnsRecord[]): s
 export declare function syncDnsConfig(domain: string, cfg: DnsConfig, options?: { dryRun?: boolean, provider?: DnsProvider | null }): Promise<DnsSyncResult>;
 export declare interface DnsPlanItem {
   record: DnsRecord
-  action: 'create' | 'keep'
+  action: 'create' | 'keep' | 'skip'
+  reason?: string
+}
+export declare interface DnsSkippedRecord {
+  record: DnsRecord
+  reason: string
 }
 export declare interface DnsPlan {
   items: DnsPlanItem[]
   create: DnsRecord[]
   keep: DnsRecord[]
+  skip: DnsSkippedRecord[]
+}
+export declare interface DnsSyncFailure {
+  record: DnsRecord
+  reason: string
 }
 export declare interface DnsSyncResult {
   plan: DnsPlan
   created: number
   kept: number
   failed: number
+  failures: DnsSyncFailure[]
+  skipped: DnsSkippedRecord[]
   applied: boolean
   provider: string | null
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/dns",
   "type": "module",
-  "version": "0.72.54",
+  "version": "0.72.56",
   "description": "Easily manage your DNS.",
   "author": "Chris Breuer",
   "contributors": [
@@ -64,13 +64,13 @@
     "@stacksjs/ts-cloud": "^0.11.4"
   },
   "devDependencies": {
-    "@stacksjs/actions": "0.72.54",
+    "@stacksjs/actions": "0.72.56",
     "better-dx": "^0.2.24",
-    "@stacksjs/error-handling": "0.72.54",
-    "@stacksjs/path": "0.72.54",
-    "@stacksjs/storage": "0.72.54",
-    "@stacksjs/strings": "0.72.54",
-    "@stacksjs/whois": "0.72.54"
+    "@stacksjs/error-handling": "0.72.56",
+    "@stacksjs/path": "0.72.56",
+    "@stacksjs/storage": "0.72.56",
+    "@stacksjs/strings": "0.72.56",
+    "@stacksjs/whois": "0.72.56"
   },
   "sideEffects": false
 }