raiutils 8.7.11 → 9.0.0

package/src/uuid.ts

@@ -0,0 +1,102 @@
+//Chu ID v1.5.1, Pecacheu 2026. GNU GPL v3
+
+import os from 'os';
+import fs from 'fs/promises';
+import crypto from 'crypto';
+import { promisify } from 'util';
+import utils from 'raiutils';
+
+const ID_FN = import.meta.dirname+'/uuid';
+let Cnt: number, CLT: number, LT: number,
+LD: number, UT: NodeJS.Timeout | boolean;
+
+let mdb: any;
+//@ts-ignore
+try {mdb=await import('mongodb')} catch(e) {}
+
+namespace mdb {export interface Long {
+	unsigned: boolean; toString(r: number): string;
+}}
+
+//64-bit UUID Format
+//<U8 Uptime><U8 Magic><U8 CryptoRand><U8 Counter><U32 Date>
+
+function swapHex(h: string) {return h.match(/.{2}/g)!.reverse().join('')}
+
+async function loadId() {
+	//Prevent race condition
+	if(UT === true) {
+		while(UT === true) await utils.delay(10);
+		return;
+	}
+	UT=true;
+	try {Cnt = Number(await fs.readFile(ID_FN, {encoding:'utf8'}))} catch(e) {}
+	if(!(Cnt >= 0 && Cnt <= 255)) console.error("[ChuID] IDCount error, resetting"), Cnt=0;
+	UT=false;
+}
+
+export default class UUID {
+	static readonly LEN = 11;
+	static readonly BYTES = 8;
+	/** Delay before writing ID file to disk */
+	static ID_Delay = 10000;
+	id: Buffer;
+
+	constructor(id: string | Buffer | mdb.Long) {
+		if(id instanceof Buffer && id.length === UUID.BYTES) {}
+		else if(typeof id === 'string' && id.length === UUID.LEN) id=Buffer.from(id,'base64');
+		else if(mdb && id instanceof mdb.Long) {
+			(id as mdb.Long).unsigned=true;
+			id=Buffer.from((id as mdb.Long).toString(16),'hex');
+		} else throw `Unknown UUID format ${id}`;
+		this.id = id;
+	}
+	toString(f?: BufferEncoding) {return this.id.toString(f||'base64url')}
+	toHexLE() {return swapHex(this.id.toString('hex'))}
+	toLong() {return mdb.Long.fromString(this.id.toString('hex'),16)}
+	getMagic() {return this.id.readUInt8(1)}
+	getDate() {
+		let d=this.id.readUInt32LE(4)*10000;
+		return new Date(d<1621543800000?0:d);
+	}
+
+	/** Convenience method for async `crypto.randomBytes` */
+	static randBytes = promisify(crypto.randomBytes);
+
+	/** Generate new random UUID
+	@param date Optional Date or Unix ms timestamp; default is current time
+	@param magic User-defined 8-bit value that can be retrieved later; default is random
+	*/
+	static genUUID = async (date?: Date | number, magic?: number) => {
+		let ts = (os.uptime()*10)&255;
+		const ds = (date instanceof Date?
+			date.getTime() : date||Date.now())/10000,
+		rb = await UUID.randBytes(magic!=null?1:2),
+		u = Buffer.allocUnsafe(8);
+
+		if(Cnt == null) await loadId();
+		const ct = Cnt;
+		if(++Cnt > 255) Cnt=0;
+
+		//Prevent collision
+		if(LT === ts && LD === ds) {
+			if(CLT === ct) {
+				await utils.delay(50);
+				LT = ts = (ts+1)&255;
+			}
+		} else LT=ts, LD=ds, CLT=ct;
+
+		u.writeUInt8(ts);
+		if(magic != null) {
+			u.writeUInt8(magic&255, 1);
+			u.writeUInt8(rb.readUInt8(), 2);
+		} else u.writeUInt16LE(rb.readUInt16LE(), 1);
+		u.writeUInt8(ct, 3);
+		u.writeUInt32LE(ds, 4);
+
+		if(!UT) UT = setTimeout(() => {
+			UT=false, fs.writeFile(ID_FN, Cnt.toString());
+		}, UUID.ID_Delay);
+		return new UUID(u);
+	}
+}

package/router.js

@@ -1,109 +0,0 @@
-//Node Webserver v3.4.2, Pecacheu 2025. GNU GPL v3
-
-import path from 'path';
-import fs from 'fs/promises';
-import crypto from 'crypto';
-import chalk from 'chalk';
-let debug;
-
-const types = {
-	'.html': "text/html",
-	'.php':  "text/html",
-	'.css':  "text/css",
-	'.png':  "image/png",
-	'.svg':  "image/svg+xml",
-	'.js':   "application/javascript",
-	'.pdf':  "application/pdf",
-	'.mp4':  "video/mp4",
-	'.ogg':  "video/ogg",
-	'.webm': "video/webm"
-};
-
-//etag: If number, max file size to calc hash, else if true, use fast etag mode (modified date)
-async function handle(dir, req, res, virtualDirs, etag=true) {
-	let f;
-	try {
-		let fn=await resolve(dir, new URL(req.url,'http://a').pathname, virtualDirs),
-			hdr={}, stat=200, ext=path.extname(fn), ct=types[ext], rng=req.headers.range, str;
-		if(ct) hdr["content-type"] = ct;
-		f=await fs.open(fn);
-		let st=await f.stat(), dl=st.size;
-		if(rng) { //Range
-			if(!rng.startsWith('bytes=') || (rng=rng.slice(6).split('-'))
-				.length !== 2 || !rng[0]) return await rngErr(f,dl,rng,res);
-			let rs=Number(rng[0]), re=Number(rng[1]);
-			if(!re) re=dl-1;
-			if(rs>=dl || re>=dl || rs>=re) return await rngErr(f,dl,rng,res);
-			str=f.createReadStream({start:rs, end:re});
-			hdr["accept-ranges"] = 'bytes';
-			hdr["content-range"] = `bytes ${rs}-${re}/${dl}`;
-			stat=206;
-		} else if(typeof etag==='number') {if(dl <= MAX_ETAG) {
-			str=await f.readFile();
-			let h=crypto.createHash('sha1');
-			h.update(str);
-			hdr.etag=h.digest('base64url');
-		}} else if(etag) hdr.etag=st.mtime.toISOString();
-
-		if(hdr.etag && hdr.etag === req.headers['if-none-match'])
-			return res.writeHead(304,''),res.end(),f.close();
-		if(!str) str=f.createReadStream();
-
-		res.writeHead(stat,'',hdr);
-		if(str instanceof Buffer) res.write(str),res.end(); else str.pipe(res);
-		res.on('close', () => f.close());
-		if(debug) log(fn.startsWith(dir)?fn.slice(dir.length):fn, ct);
-	} catch(e) {
-		let nf=e.code==='ENOENT';
-		if(debug||!nf) nf?err("-- Not found"):err("-- Read",e);
-		sendCode(res, nf?404:500, nf?"Resource Not Found":e);
-		if(f) f.close();
-	}
-}
-
-async function serve(fn, req, res, etag=true) {
-	let u=req.url; req.url='/';
-	return handle(fn, req, res, null, etag).finally(() => req.url=u);
-}
-
-async function rngErr(f,fl,rng,res) {
-	if(debug) err("-- Bad Range",rng);
-	let h={"content-range": 'bytes */'+fl};
-	res.writeHead(416,'',h); res.end();
-	f.close();
-}
-
-function sendCode(res, code, msg) {
-	res.writeHead(code,''), res.write(`<pre style='font-size:16pt'>${msg}</pre>`), res.end();
-}
-
-function err(m,e) {console.error(chalk.red(m,e))}
-function log(name, ct) {console.log(chalk.dim("-- Served "+name+(ct?" with type "+ct:'')))}
-
-async function resolve(dir, uri, vDir) {
-	if(uri.indexOf('..') !== -1) throw "Bad path";
-	let fn = parseUri(dir, uri, vDir);
-	if(fn.endsWith('/')) fn=fn.slice(0,-1);
-	try {
-		let stat = await fs.stat(fn);
-		if(stat.isDirectory()) return path.join(fn,'/index.html'); //Try index
-		return fn;
-	} catch(e) {
-		if(!path.extname(fn)) return fn+'.html'; //Try with ext
-		throw e;
-	}
-}
-
-function parseUri(root, uri, vDir) {
-	if(vDir) {
-		let v,vs; for(v in vDir) {
-			vs=v.startsWith('/')?v:'/'+v;
-			if(uri.startsWith(vs)) return path.join(vDir[v], uri.slice(vs.length));
-		}
-	}
-	return root+uri;
-}
-
-const ex={handle, serve, types};
-Object.defineProperty(ex, 'debug', {set:d => debug=d});
-export default ex;

package/schema.js

@@ -1,148 +0,0 @@
-//ChuSchema v1.3.1, Pecacheu 2025. GNU GPL v3
-
-class SubError extends Error {}
-
-function errAt(k,e,l) {
-	let s=e instanceof SubError, es=e.message||e;
-	k=(l?`[${k}]`:k)+(s ? es.startsWith('[')?'':'.' : ': ');
-	if(s) e.message=k+es;
-	else e=new SubError(k+es, e instanceof Error?{cause:e}:null);
-	return e;
-}
-
-function isDictOrArr(d) {return typeof d==='object' && d!==null}
-function isDict(d) {return isDictOrArr(d) && !Array.isArray(d)}
-function oobStr(s) {return ` out-of-bounds (${s.min==null?'*':s.min}-${s.max==null?'*':s.max})`}
-function dictFmt(s) {
-	if(typeof s.c==='string') s.c={t:s.c};
-	let dt=isDictOrArr(s.f)?2:isDictOrArr(s.c)?1:0;
-	if(!dt) throw "Schema lacks format or childType";
-	if(dt===2 && s.c) throw "Cannot require both format and childType";
-	return dt===2;
-}
-function tryAll(a,fn) {
-	if(Array.isArray(a)) {
-		let el=[];
-		a.forEach(s => {try {fn(s)} catch(e) {el.push(e)}});
-		if(el.length >= a.length) throw "[Failed all cases] "+el.map(e => e.message||e).join(', ');
-	} else fn(a);
-}
-
-function checkType(d,sr) {
-	let tt,el,sl,s,l,k,n,ds,dt,
-	run=(t,i) => {
-		//Get prop cache
-		if(!(s=sl[k='$'+i])) {
-			s=sl[k]={};
-			for(k in sl) s[k]=Array.isArray(sl[k])?sl[k][i]:sl[k];
-		}
-		//Check type
-		try {switch(t) {
-		case 'str':
-			if(typeof d!=='string') throw -1;
-			l=d.length;
-			if(l<s.min || l>s.max) throw "Str len "+l+oobStr(s);
-			if(s.len!=null && l!==s.len) throw "Str len must be "+s.len;
-			if(typeof s.f==='string') s.f=new RegExp(`^(?:${s.f})$`);
-			if(s.f instanceof RegExp && !s.f.test(d)) throw `Str '${d}' does not match format ${s.f}`;
-		break; case 'int': case 'float':
-			if(typeof d!=='number' || !(t==='int'?Number.isSafeInteger(d):Number.isFinite(d))) throw -1;
-			if(s.val!=null && d!==s.val) throw "Num != "+s.val;
-			if(d<s.min || d>s.max) throw "Num "+d+oobStr(s);
-		break; case 'bool':
-			if(typeof d!=='boolean') throw -1;
-		break; case 'list':
-			if(!Array.isArray(d)) throw -1;
-			l=d.length; if(!l && s.min!==0) throw "Empty list";
-			if(s.len!=null && l!==s.len) throw "Array size must be "+s.len;
-			if(l<s.min || l>s.max) throw "Array size "+l+oobStr(s);
-			n=0, ds=tt.length>1?s:sl, dt=dictFmt(ds);
-			for(; n<l; ++n) try {dt?checkSchema(d[n],ds.f):checkType(d[n],ds.c)}
-				catch(e) {throw errAt(n,e,1)}
-		break; case 'dict':
-			if(!isDict(d)) throw -1;
-			k=Object.keys(d);
-			if(!k.length && s.min!==0) throw "Empty dict";
-			if(typeof s.kf==='string') s.kf=new RegExp(`^(?:${s.kf})$`);
-			ds=tt.length>1?s:sl, dt=dictFmt(ds);
-			for(n of k) try {
-				if(n.startsWith('$')) throw "Key cannot start with $";
-				if(s.kf instanceof RegExp && !s.kf.test(n)) throw `Key '${n}' does not match format ${s.kf}`;
-				dt?checkSchema(d[n],ds.f):checkType(d[n],ds.c);
-			} catch(e) {throw errAt(n,e,1)}
-		break; case 'obj':
-			if(typeof s.c !== 'function') throw "Obj schema requires class";
-			if(!(d instanceof s.c)) throw `Obj must be of type ${s.c.name}`;
-		break; default:
-			throw `Unknown type ${s.t} in schema`;
-		}} catch(e) {el.push(e)}
-	}
-	tryAll(sr, s => {
-		if(typeof s.t!=='string') throw "Missing type";
-		sl=s, el=[], tt=s.t.split('|'), tt.forEach(run);
-		if(el.length >= tt.length) {
-			let e,m;
-			for(e of el) if(e!==-1) m=e;
-			if(!m) m="Must be of type "+sr.t;
-			throw m;
-		}
-	});
-}
-
-const R_FN=/\W+|(\w+)/g;
-
-function checkSchema(data, schema, ignoreReq) {
-	if(!isDict(data)) throw "Data must be dict";
-	if(!isDictOrArr(schema)) throw "Schema must be dict|list[dict]";
-	let k,d,s,r,n,m;
-	tryAll(schema, sch => {
-		for(k in data) try {
-			d=data[k], s=sch[k];
-			if(!s) throw "Not in schema";
-			if(k.startsWith('$')) throw "Key cannot start with $";
-			checkType(d,s);
-		} catch(e) {throw errAt(k,e)}
-		if(ignoreReq) return;
-		//Check missing
-		for(k in sch) if((s=sch[k]).req != null) {
-			d=s.req, r=typeof d==='string';
-			if(r) { //Conditional req
-				n='';
-				while(m=R_FN.exec(d)) n+=m[1] ? m[1] in data : m[0];
-				d=eval(n);
-			}
-			if(d) {
-				n=k in data;
-				if(d===-1 ? n : !n) throw k+": Required"+(r?" if "+s.req:'');
-			}
-		}
-	});
-}
-
-function isNumArr(a) {
-	for(let v of a) if(typeof v!=='number') return;
-	return 1;
-}
-
-//Custom JSON implementation w/ better line-breaks
-function prettyJSON(val, d=0) {
-	let t=typeof val;
-	if(t==='number' || t==='string' || t==='boolean') return JSON.stringify(val);
-	else if(Array.isArray(val)) {
-		if(isNumArr(val)) return JSON.stringify(val);
-		let s='[',d1=d+1,i=0,l=val.length;
-		for(; i<l; ++i) s += (i?',\n':'\n')+('\t'.repeat(d1))+prettyJSON(val[i],d1);
-		return s+'\n'+'\t'.repeat(d)+']';
-	} else if(t==='object') {
-		let k,s='{',ln=!d,f,d1=d+1;
-		for(k in val) {
-			if(Array.isArray(val[k]) && !isNumArr(val[k])) ln=1;
-			s += (ln?f?',\n':'\n':f?', ':'')+'\t'.repeat(ln?d1:0)+JSON.stringify(k)+":"+prettyJSON(val[k],d1);
-			f=1,ln=0;
-		}
-		if(!d) s+='\n';
-		return s+'}';
-	} else throw "Unknown type "+t;
-}
-
-export default {checkSchema, checkType, prettyJSON, errAt};