// Node 24+. One private directory per business event; no wallet or auto-purchase. import {mkdir,open,readFile,rename,unlink} from 'node:fs/promises'; import {resolve,join} from 'node:path'; import {pathToFileURL} from 'node:url'; import {createHash} from 'node:crypto'; const origins=new Set(['https://datoka-hooks.bhazarstudio.workers.dev','https://datoka-hooks-test.bhazarstudio.workers.dev']); const eventPattern=/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/; const states=new Set(['accepting','queued','sending','recording','delivered','failed']); const digest=b=>createHash('sha256').update(b).digest('hex'); function accessCheck(a){if(!origins.has(a.origin)||!/^pub-[a-f0-9]{32}$/.test(a.hookId??'')||!/^[a-f0-9]{64}$/.test(a.token??''))throw Error('invalid_access');} async function save(path,data,exclusive=false){const f=await open(path,exclusive?'wx':'w',0o600);try{await f.writeFile(JSON.stringify(data)+'\n');await f.sync();}finally{await f.close();}} async function syncDirectory(dir){if(process.platform==='win32')return;const f=await open(dir,'r');try{await f.sync();}finally{await f.close();}} export async function prepare(directory,access,eventId,body){ accessCheck(access);body=Buffer.from(body); if(!eventPattern.test(eventId??'')||body.length>65536)throw Error('invalid_event'); JSON.parse(new TextDecoder('utf-8',{fatal:true}).decode(body)); const dir=resolve(directory);await mkdir(dir,{mode:0o700}); // If interrupted, leave this directory for inspection. Never recreate an uncertain event. const state={schema:'datoka.hooks.outbox.v1',origin:access.origin,hookId:access.hookId,eventId,contentType:'application/json',bodyBase64:body.toString('base64'),bodySha256:digest(body),attempts:0,retryAt:0,delivery:null}; await save(join(dir,'state.json'),state,true);await syncDirectory(dir);return {prepared:true,submitted:false}; } function checkedState(s){ if(s.schema!=='datoka.hooks.outbox.v1'||!origins.has(s.origin)||!/^pub-[a-f0-9]{32}$/.test(s.hookId??'')||!eventPattern.test(s.eventId??'')||s.contentType!=='application/json'||typeof s.bodyBase64!=='string'||s.bodyBase64.length>87384)throw Error('invalid_state'); const body=Buffer.from(s.bodyBase64,'base64');if(body.toString('base64')!==s.bodyBase64||body.length>65536||digest(body)!==s.bodySha256||!Number.isSafeInteger(s.attempts)||s.attempts<0||!Number.isSafeInteger(s.retryAt)||s.retryAt<0)throw Error('invalid_state'); JSON.parse(new TextDecoder('utf-8',{fatal:true}).decode(body)); if(s.delivery!==null)deliveryCheck(s.delivery); return body; } function deliveryCheck(d){if(!d||typeof d.deliveryId!=='string'||!/^[A-Za-z0-9._:-]{1,160}$/.test(d.deliveryId)||!states.has(d.state)||!Number.isSafeInteger(d.attempts)||d.attempts<0)throw Error('invalid_response');return {deliveryId:d.deliveryId,state:d.state,attempts:d.attempts};} function retryAt(value,now){ const delay=/^\d+$/.test(value??'')?Number(value)*1000:Date.parse(value??'')-now; // Respect long Retry-After too. No busy loop; caller retries later. return now+(Number.isFinite(delay)&&delay>0?Math.min(delay,30*86400000):5000); } export async function resume(directory,access,{submit=false,request=fetch,now=Date.now()}={}){ accessCheck(access);const dir=resolve(directory),lock=await open(join(dir,'send.lock'),'wx',0o600); try{ const s=JSON.parse(await readFile(join(dir,'state.json'),'utf8')),body=checkedState(s); if(s.origin!==access.origin||s.hookId!==access.hookId)throw Error('access_scope_mismatch'); if(s.delivery&&['delivered','failed'].includes(s.delivery.state))return {...s.delivery,cached:true}; if(now=500?'uncertain':'rejected',httpStatus:r.status,retryAt:new Date(s.retryAt).toISOString(),reuseOriginal:true}; } // A malformed/lost response cannot authorize a new event. Preserve original bytes. let d;try{d=deliveryCheck(await r.json());if(s.delivery&&d.deliveryId!==s.delivery.deliveryId)throw Error();}catch{return {state:'uncertain',reuseOriginal:true,retryAt:new Date(s.retryAt).toISOString()};} s.delivery=d;await persist();return {...d,cached:false}; }finally{await lock.close();await unlink(join(dir,'send.lock'));} } async function main(){ const [command,dir,file,id,payload,...extra]=process.argv.slice(2); const a=JSON.parse(await readFile(file,'utf8'));a.origin??='https://datoka-hooks-test.bhazarstudio.workers.dev'; let out; if(command==='prepare'&&id&&payload&&!extra.length)out=await prepare(dir,a,id,await readFile(payload)); else if(command==='resume'&&(!id||id==='--submit')&&!payload)out=await resume(dir,a,{submit:id==='--submit'}); else throw Error('usage'); console.log(JSON.stringify(out,null,2)); if(['failed','conflict','access_denied','rejected'].includes(out.state))process.exitCode=2; else if(['waiting','uncertain','quota_wait','prepared_or_uncertain'].includes(out.state))process.exitCode=3; } if(process.argv[1]&&import.meta.url===pathToFileURL(resolve(process.argv[1])).href)main().catch(()=>{console.error('Stopped: inspect access, saved event and send.lock. Keep the original directory; never create a new event to bypass an uncertain result.');process.exitCode=1;});