@stacksjs/dns 0.70.75 → 0.70.76
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.d.ts +3 -0
- package/dist/index.js +4 -3
- package/dist/sync.d.ts +51 -0
- package/package.json +8 -8
package/dist/index.d.ts
CHANGED
package/dist/index.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
// @bun
|
|
2
|
-
import{runAction as
|
|
3
|
-
${
|
|
4
|
-
`)}`))}return
|
|
2
|
+
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):
|
|
3
|
+
${J.join(`
|
|
4
|
+
`)}`))}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(`
|
|
5
|
+
`)}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};
|
package/dist/sync.d.ts
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import type { DnsConfig } from '@stacksjs/types';
|
|
2
|
+
import type { DnsProvider, DnsRecord } from '@stacksjs/ts-cloud';
|
|
3
|
+
/**
|
|
4
|
+
* Flatten a `config/dns.ts` `DnsConfig` into the provider's record shape.
|
|
5
|
+
* `nameservers` are delegation, not zone records, so they are not included.
|
|
6
|
+
*/
|
|
7
|
+
export declare function desiredDnsRecords(domain: string, cfg: DnsConfig): DnsRecord[];
|
|
8
|
+
/**
|
|
9
|
+
* Build the additive reconciliation plan: which declared records are missing
|
|
10
|
+
* (create) and which are already satisfied (keep). Never plans a delete or an
|
|
11
|
+
* overwrite.
|
|
12
|
+
*/
|
|
13
|
+
export declare function planDnsSync(desired: DnsRecord[], current: DnsRecord[]): DnsPlan;
|
|
14
|
+
/**
|
|
15
|
+
* Read a zone's live records over public DNS (no registrar credentials). Used by
|
|
16
|
+
* `pull`, and by `sync`/`diff` as a fallback when no provider is configured.
|
|
17
|
+
*/
|
|
18
|
+
export declare function resolveLiveRecords(domain: string): Promise<DnsRecord[]>;
|
|
19
|
+
/**
|
|
20
|
+
* Resolve a registrar provider for a domain from environment credentials
|
|
21
|
+
* (`PORKBUN_API_KEY`/`PORKBUN_SECRET_KEY`, AWS, GoDaddy, Cloudflare). Returns
|
|
22
|
+
* null when no configured provider can manage the domain.
|
|
23
|
+
*/
|
|
24
|
+
export declare function dnsProviderForDomain(domain: string): Promise<DnsProvider | null>;
|
|
25
|
+
/**
|
|
26
|
+
* Render a set of records as a `config/dns.ts` source block (used by `pull`).
|
|
27
|
+
*/
|
|
28
|
+
export declare function renderDnsConfig(domain: string, records: DnsRecord[]): string;
|
|
29
|
+
/**
|
|
30
|
+
* Additively reconcile a `config/dns.ts` to a domain's registrar. Current state
|
|
31
|
+
* is read from the provider when credentials are available, else from public
|
|
32
|
+
* DNS. With `dryRun` (or no provider) it computes the plan without writing.
|
|
33
|
+
*/
|
|
34
|
+
export declare function syncDnsConfig(domain: string, cfg: DnsConfig, options?: { dryRun?: boolean, provider?: DnsProvider | null }): Promise<DnsSyncResult>;
|
|
35
|
+
export declare interface DnsPlanItem {
|
|
36
|
+
record: DnsRecord
|
|
37
|
+
action: 'create' | 'keep'
|
|
38
|
+
}
|
|
39
|
+
export declare interface DnsPlan {
|
|
40
|
+
items: DnsPlanItem[]
|
|
41
|
+
create: DnsRecord[]
|
|
42
|
+
keep: DnsRecord[]
|
|
43
|
+
}
|
|
44
|
+
export declare interface DnsSyncResult {
|
|
45
|
+
plan: DnsPlan
|
|
46
|
+
created: number
|
|
47
|
+
kept: number
|
|
48
|
+
failed: number
|
|
49
|
+
applied: boolean
|
|
50
|
+
provider: string | null
|
|
51
|
+
}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@stacksjs/dns",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "0.70.
|
|
4
|
+
"version": "0.70.76",
|
|
5
5
|
"description": "Easily manage your DNS.",
|
|
6
6
|
"author": "Chris Breuer",
|
|
7
7
|
"contributors": [
|
|
@@ -56,16 +56,16 @@
|
|
|
56
56
|
},
|
|
57
57
|
"dependencies": {
|
|
58
58
|
"@stacksjs/dnsx": "^0.2.3",
|
|
59
|
-
"@stacksjs/ts-cloud": "^0.7.
|
|
59
|
+
"@stacksjs/ts-cloud": "^0.7.15"
|
|
60
60
|
},
|
|
61
61
|
"devDependencies": {
|
|
62
|
-
"@stacksjs/actions": "0.70.
|
|
62
|
+
"@stacksjs/actions": "0.70.76",
|
|
63
63
|
"better-dx": "^0.2.16",
|
|
64
|
-
"@stacksjs/error-handling": "0.70.
|
|
65
|
-
"@stacksjs/path": "0.70.
|
|
66
|
-
"@stacksjs/storage": "0.70.
|
|
67
|
-
"@stacksjs/strings": "0.70.
|
|
68
|
-
"@stacksjs/whois": "0.70.
|
|
64
|
+
"@stacksjs/error-handling": "0.70.76",
|
|
65
|
+
"@stacksjs/path": "0.70.76",
|
|
66
|
+
"@stacksjs/storage": "0.70.76",
|
|
67
|
+
"@stacksjs/strings": "0.70.76",
|
|
68
|
+
"@stacksjs/whois": "0.70.76"
|
|
69
69
|
},
|
|
70
70
|
"sideEffects": false
|
|
71
71
|
}
|