easier-http-request 0.1.0

package/src/utilities/Utilities.ts

@@ -0,0 +1,127 @@
+import { Timer } from './Timer.js'
+
+export function writeToStderr(message: any) {
+	process.stderr.write(message)
+}
+
+export function logToStderr(message: any) {
+	writeToStderr(message)
+	writeToStderr('\n')
+}
+
+export function formatIntegerWithLeadingZeros(num: number, minDigitCount: number) {
+	num = Math.floor(num)
+
+	let numAsString = `${num}`
+
+	while (numAsString.length < minDigitCount) {
+		numAsString = `0${numAsString}`
+	}
+
+	return numAsString
+}
+
+export function roundToDigits(val: number, digits = 3) {
+	const multiplier = 10 ** digits
+
+	return Math.round(val * multiplier) / multiplier
+}
+
+export function sleep(timeMs: number) {
+	const timer = new Timer()
+
+	return new Promise<void>((resolve) => {
+		const tickCallback = () => {
+			if (timer.elapsedTime < timeMs) {
+				//setImmediate(tickCallback)
+				setTimeout(tickCallback, 0)
+			} else {
+				resolve()
+			}
+		}
+
+		//setImmediate(tickCallback)
+		setTimeout(tickCallback, 0)
+	})
+}
+
+export function parseUrlOrPath(inputString: string, baseUrl = 'https://dummy.com') {
+	try {
+		// Attempt 1: Try parsing as an absolute URL
+		const url = new URL(inputString)
+
+		return url
+	} catch (error) {
+		// If it failed, it's likely a relative URL.
+		// Attempt 2: Try parsing with a base URL.
+		// The base URL can be a real one (e.g., your server's origin)
+		// or a dummy one if you only care about path/query/hash.
+		try {
+			const url = new URL(inputString, baseUrl)
+
+			return url
+		} catch (relativeError: any) {
+			// If it fails even with a base, it's truly malformed or unparseable.
+			throw new Error(`Failed to parse URL '${inputString}' even with base '${baseUrl}': ${relativeError.message}`)
+		}
+	}
+}
+
+export function getDomainName(url: string) {
+	try {
+		const hostname = (new URL(url)).hostname
+		const parts = hostname.split('.')
+
+		if (parts.length < 2) {
+			return url
+		}
+
+		return parts.slice(parts.length - 2).join('.')
+	} catch {
+		return ''
+	}
+}
+
+export function yieldToEventLoop() {
+	return new Promise((resolve) => {
+		setImmediate(resolve)
+	})
+}
+
+export function isValidHttpUrl(urlString: string): boolean {
+	// 1. Basic type check and trim: Ensure the input is actually a non-empty string.
+	//    While TypeScript handles type at compile time, this adds runtime robustness.
+	if (typeof urlString !== 'string' || urlString.trim() === '') {
+		return false;
+	}
+
+	try {
+		// 2. Attempt to construct a URL object.
+		//    The URL constructor throws a TypeError if the URL is not valid
+		//    (e.g., malformed, relative without a base, etc.).
+		const url = new URL(urlString);
+
+		// 3. Additional robustness: Restrict allowed protocols.
+		//    The URL constructor accepts many protocols (e.g., 'ftp:', 'file:', 'data:', 'javascript:').
+		//    For typical web applications, we usually only want 'http:' or 'https:'.
+		//    The `protocol` property includes the trailing colon.
+		const allowedProtocols = ['http:', 'https:'];
+		if (!allowedProtocols.includes(url.protocol)) {
+			return false;
+		}
+
+		// 4. Optional but often desired: Ensure a non-empty hostname.
+		//    URLs like "http://" or "https://" are technically valid URL objects
+		//    but have an empty hostname, which might not be desired for a "valid" URL.
+		if (!url.hostname) {
+			return false;
+		}
+
+		// All checks passed
+		return true;
+	} catch (error) {
+		// If the URL constructor throws an error, it's not a valid URL.
+		// console.error("URL validation error:", error); // Uncomment for debugging if needed
+		return false;
+	}
+}

package/tsconfig.json

@@ -0,0 +1,55 @@
+{
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+	// File Layout
+	"rootDir": "./src",
+	"outDir": "./dist",
+
+	// Environment Settings
+	// See also https://aka.ms/tsconfig/module
+	"module": "nodenext",
+	"target": "esnext",
+	"types": ["node"],
+	// For nodejs:
+	// "lib": ["esnext"],
+	// "types": ["node"],
+	// and npm install -D @types/node
+
+	// Other Outputs
+	"sourceMap": true,
+	"declaration": true,
+	"declarationMap": true,
+
+	// Stricter Typechecking Options
+	// "noUncheckedIndexedAccess": true,
+	// "exactOptionalPropertyTypes": true,
+
+	// Style Options
+	"noImplicitReturns": true,
+	// "noImplicitOverride": true,
+	// "noUnusedLocals": true,
+	// "noUnusedParameters": true,
+	// "noFallthroughCasesInSwitch": true,
+	// "noPropertyAccessFromIndexSignature": true,
+
+	// Recommended Options
+	"strict": true,
+	"jsx": "react-jsx",
+	// "verbatimModuleSyntax": true,
+	"isolatedModules": true,
+	"noUncheckedSideEffectImports": true,
+	"moduleDetection": "force",
+	"skipLibCheck": true,
+
+	// Extended options not in generated tsconfig.json
+	"newLine": "lf",
+	"forceConsistentCasingInFileNames": true,
+	"alwaysStrict": true,
+
+	"noImplicitThis": true,
+	"strictBindCallApply": true,
+	"strictFunctionTypes": true,
+
+	"noErrorTruncation": true,
+  }
+}