import assert from 'node:assert/strict' import {X509Certificate} from 'node:crypto' import {checkServerIdentity,TLSSocket} from 'node:tls' import {sha} from './operator-files.mjs' export const roleKeys=Object.freeze(['runtime','operator','capture','publisher','control']) export const STARTUP_OPTIONS='-c statement_timeout=10000 -c lock_timeout=5000 -c client_encoding=UTF8' export function assertJsDriverEnvironment(environment){assert(!Object.hasOwn(environment,'NODE_PG_FORCE_NATIVE'),'Native pg driver selector refused')} const hex=v=>typeof v==='string'&&/^[a-f0-9]{64}$/.test(v) const exact=(v,keys)=>v&&typeof v==='object'&&!Array.isArray(v)&&Object.keys(v).length===keys.length&&keys.every(k=>Object.hasOwn(v,k)) const publicationFormat='application-writer-publication-approval-v1' export const UPGRADE_APPROVAL_FORMAT='application-writer-upgrade44-to56-approval-v1' export const UPGRADE57_APPROVAL_FORMAT='application-writer-upgrade56-to57-approval-v1' export const UPGRADE58_APPROVAL_FORMAT='application-writer-upgrade57-to58-approval-v1' export const REBIND58_APPROVAL_FORMAT='application-writer-rebind58-after-restore-approval-v1' export const isUpgradeApprovalFormat=format=>[UPGRADE_APPROVAL_FORMAT,UPGRADE57_APPROVAL_FORMAT,UPGRADE58_APPROVAL_FORMAT,REBIND58_APPROVAL_FORMAT].includes(format) function parsedApproval(value,format=publicationFormat){ const upgrade=isUpgradeApprovalFormat(format) const keys=['format','manifestSha256','definitionSha256','catalogSha256','expectedHeadSha256','validityMs','expiresAt'] if(upgrade)keys.push('previousCatalogSha256') assert(exact(value,keys)&&value.format===format) assert(['manifestSha256','definitionSha256','catalogSha256'].every(k=>hex(value[k]))) assert(upgrade?hex(value.expectedHeadSha256)&&hex(value.previousCatalogSha256):value.expectedHeadSha256===null||hex(value.expectedHeadSha256)) if(format===REBIND58_APPROVAL_FORMAT)assert(value.catalogSha256!==value.previousCatalogSha256,'Restored catalogue must have a distinct independently approved digest') assert(Number.isSafeInteger(value.validityMs)&&value.validityMs>0&&value.validityMs<=86400000&&Number.isSafeInteger(value.expiresAt)&&value.expiresAt>0) return structuredClone(value) } export function approval(value){ const pinned=parsedApproval(value);assert(pinned.expiresAt>Date.now());return pinned } export function upgradeApproval(value){ assert(isUpgradeApprovalFormat(value?.format)) const pinned=parsedApproval(value,value.format);assert(pinned.expiresAt>Date.now());return pinned } // Pinned historical inspection data only; never publication authorization. export function reconciliationApproval(value){return parsedApproval(value,isUpgradeApprovalFormat(value?.format)?value.format:publicationFormat)} function peerError(pin,host,cert){ const failed=checkServerIdentity(pin.serverName,cert);if(failed)return failed try{if(host!==pin.serverName||sha(new X509Certificate(cert.raw).publicKey.export({format:'der',type:'spki'}))!==pin.spkiSha256)return Error('Publisher TLS SPKI refused')}catch{return Error('Publisher TLS certificate refused')} } // pg replaces connection.stream with the negotiated TLS socket. Hold its // identity on the retained client; handshake callbacks are not session evidence. export function retainPublisherTlsPeer(client,pin){ const socket=client.connection?.stream const assertCurrent=()=>{ assert(socket instanceof TLSSocket&&client.connection?.stream===socket&&socket.encrypted&&socket.authorized&&!socket.destroyed&&socket.writable,'Publisher retained TLS peer unavailable') } assertCurrent() const failed=peerError(pin,socket.servername,socket.getPeerCertificate());if(failed)throw failed socket.disableRenegotiation() return assertCurrent } export function poolOptions(transport,request,ca,role='publisher'){ assert(role==='publisher'||role==='control'||role==='operator') assert(exact(transport,['host','port','user','password','database'])) assert(typeof transport.host==='string'&&transport.host===request.tls.serverName&&Number.isSafeInteger(transport.port)&&transport.port>0&&transport.port<=65535&&transport.user===request.roles[role].name&&typeof transport.password==='string'&&transport.password.length>0&&transport.password.length<=4096&&transport.database===request.source.databaseName) assert(sha(ca)===request.tls.caSha256);new X509Certificate(ca) return {host:transport.host,port:transport.port,user:transport.user,password:transport.password,database:transport.database,max:1,connectionTimeoutMillis:5000,idleTimeoutMillis:5000,statement_timeout:10000,lock_timeout:5000,options:STARTUP_OPTIONS,application_name:role==='control'?'mmapp-writer-registry-enroll':role==='operator'?'mmapp-writer-marker-fence-enroll':'mmapp-writer-publisher',client_encoding:'UTF8', ssl:{ca,servername:request.tls.serverName,rejectUnauthorized:true,checkServerIdentity:(host,cert)=>peerError(request.tls,host,cert)}} } export function assertPublicationApproval(current,catalogue,structure,pinned,manifestSha256){ assert(pinned.expiresAt>Date.now()&&pinned.manifestSha256===manifestSha256&&pinned.definitionSha256===catalogue.definitionSha256) assert(sha(JSON.stringify({base:catalogue.catalogSha256,security:structure.sha256}))===pinned.catalogSha256) assert((current?.headSha256??null)===pinned.expectedHeadSha256) }