refc: extract some functions into a utilities.ts file

Author: gamemaker1

source/ratelimit-header-parser.ts

@@ -7,6 +7,7 @@ import type {
 	RateLimitInfo,
 	ParserOptions,
 } from './types'
+import { secondsToDate, toInt } from './utilities.js'
 
 /**
  * Parses the passed response/headers object and returns rate limit information.
@@ -136,17 +137,6 @@ export function parseCombinedRateLimitHeader(header: string): RateLimitInfo {
 	}
 }
 
-function secondsToDate(seconds: number): Date {
-	const d = new Date()
-	d.setSeconds(d.getSeconds() + seconds)
-	return d
-}
-
-function toInt(input: string | number | undefined): number {
-	if (typeof input === 'number') return input
-	return Number.parseInt(input ?? '', 10)
-}
-
 function getHeader(headers: HeadersObject, name: string): string | undefined {
 	if ('get' in headers && typeof headers.get === 'function') {
 		return headers.get(name) ?? undefined // Returns null if missing, but everything else is undefined for missing values

source/utilities.ts

@@ -0,0 +1,28 @@
+// source/utilities.ts
+// The utility functions for the library
+
+/**
+ * Adds the given number of seconds to the current time and returns a `Date`.
+ *
+ * @param seconds {number} - The number of seconds to add to the current time.
+ *
+ * @return {Date} - The date, with a timestamp n seconds from now.
+ */
+export const secondsToDate = (seconds: number): Date => {
+	const date = new Date()
+	date.setSeconds(date.getSeconds() + seconds)
+	return date
+}
+
+/**
+ * Converts a string/number to a number.
+ *
+ * @param input {string | number | undefined} - The input to convert to a number.
+ *
+ * @return {number} - The parsed integer.
+ * @throws {Error} - Thrown if the string does not contain a valid number.
+ */
+export const toInt = (input: string | number | undefined): number => {
+	if (typeof input === 'number') return input
+	return Number.parseInt(input ?? '', 10)
+}