@eik/core 2.1.45 → 2.1.47

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [2.1.47](https://github.com/eik-lib/core/compare/v2.1.46...v2.1.47) (2026-05-27)
+
+
+### Bug Fixes
+
+* Bump dependencies ([#587](https://github.com/eik-lib/core/issues/587)) ([c81b101](https://github.com/eik-lib/core/commit/c81b10179c6e6fc8d4f4a2ee82b95f1c0e1533e7))
+
+## [2.1.46](https://github.com/eik-lib/core/compare/v2.1.45...v2.1.46) (2026-05-22)
+
+
+### Bug Fixes
+
+* **deps:** update dependency @eik/sink-file-system to v2.0.32 ([#586](https://github.com/eik-lib/core/issues/586)) ([6e9ec23](https://github.com/eik-lib/core/commit/6e9ec2350596336e8931b2f340def7761deab81d))
+
 ## [2.1.45](https://github.com/eik-lib/core/compare/v2.1.44...v2.1.45) (2026-05-22)
 
 

package/lib/classes/http-incoming.js

@@ -4,6 +4,10 @@
  * @class HttpIncoming
  */
 const HttpIncoming = class HttpIncoming {
+	/**
+	 * @param {any} [request]
+	 * @param {{ version?: string, extras?: string, author?: object, alias?: string, type?: string, name?: string, org?: string }} [options]
+	 */
 	constructor(
 		request,
 		{

package/lib/classes/http-outgoing.js

@@ -14,7 +14,9 @@ const HttpOutgoing = class HttpOutgoing {
 		this._statusCode = 200;
 		this._mimeType = "text/plain";
 		this._location = "";
+		/** @type {import("node:stream").Readable | undefined} */
 		this._stream = undefined;
+		/** @type {any} */
 		this._body = undefined;
 		this._etag = "";
 	}
@@ -63,6 +65,7 @@ const HttpOutgoing = class HttpOutgoing {
 		this._stream = value;
 	}
 
+	/** @returns {import("node:stream").Readable | undefined} */
 	get stream() {
 		return this._stream;
 	}
@@ -71,6 +74,7 @@ const HttpOutgoing = class HttpOutgoing {
 		this._body = value;
 	}
 
+	/** @returns {any} */
 	get body() {
 		return this._body;
 	}

package/lib/classes/package.js

@@ -17,7 +17,9 @@ const Package = class Package {
 		this._type = type;
 		this._name = name;
 		this._org = org;
+		/** @type {import("./asset.js").default[]} */
 		this._files = [];
+		/** @type {import("./meta.js").default[]} */
 		this._meta = [];
 	}
 
@@ -56,12 +58,18 @@ const Package = class Package {
 		return this._org;
 	}
 
+	/**
+	 * @param {import("./asset.js").default} asset
+	 */
 	setAsset(asset) {
 		if (!(asset instanceof Asset))
 			throw new TypeError('Argument "asset" must be an instance of Asset');
 		this._files.push(asset);
 	}
 
+	/**
+	 * @param {import("./meta.js").default} meta
+	 */
 	setMeta(meta) {
 		if (!(meta instanceof Meta))
 			throw new TypeError('Argument "meta" must be an instance of Meta');

package/lib/classes/versions.js

@@ -1,6 +1,9 @@
 import semver from "semver";
 
 const Versions = class Versions {
+	/**
+	 * @param {{ versions?: [any, any][], type?: string, name?: string, org?: string }} [options]
+	 */
 	constructor({ versions = [], type = "", name = "", org = "" } = {}) {
 		this._versions = new Map(versions);
 		this._type = type;
@@ -9,8 +12,9 @@ const Versions = class Versions {
 	}
 
 	get versions() {
-		return Array.from(this._versions.entries()).sort((a, b) =>
-			a[0] > b[0] ? -1 : 1,
+		return [...this._versions.entries()].toSorted(
+			(/** @type {[any, any]} */ a, /** @type {[any, any]} */ b) =>
+				a[0] > b[0] ? -1 : 1,
 		);
 	}
 
@@ -26,6 +30,10 @@ const Versions = class Versions {
 		return this._org;
 	}
 
+	/**
+	 * @param {string} version
+	 * @param {string} integrity
+	 */
 	setVersion(version, integrity) {
 		const major = semver.major(version);
 		this._versions.set(major, {
@@ -34,10 +42,16 @@ const Versions = class Versions {
 		});
 	}
 
+	/**
+	 * @param {number} major
+	 */
 	getVersion(major) {
 		return this._versions.get(major);
 	}
 
+	/**
+	 * @param {string} version
+	 */
 	check(version) {
 		const major = semver.major(version);
 		const previous = this.getVersion(major);

package/lib/handlers/alias.delete.js

@@ -46,7 +46,7 @@ const AliasDel = class AliasDel {
 
 	async _exist(path = "") {
 		try {
-			await this._sink.exist(path);
+			if (this._sink) await this._sink.exist(path);
 			return true;
 			// eslint-disable-next-line no-unused-vars
 		} catch (error) {
@@ -54,6 +54,13 @@ const AliasDel = class AliasDel {
 		}
 	}
 
+	/**
+	 * @param {any} req
+	 * @param {any} user
+	 * @param {string} type
+	 * @param {string} name
+	 * @param {string} alias
+	 */
 	async handler(req, user, type, name, alias) {
 		const end = this._histogram.timer();
 
@@ -65,7 +72,9 @@ const AliasDel = class AliasDel {
 			validators.name(pName);
 			validators.type(type);
 		} catch (error) {
-			this._log.info(`alias:del - Validation failed - ${error.message}`);
+			this._log.info(
+				`alias:del - Validation failed - ${error instanceof Error ? error.message : String(error)}`,
+			);
 			const e = new HttpError.NotFound();
 			end({ labels: { success: false, status: e.status } });
 			throw e;
@@ -103,7 +112,7 @@ const AliasDel = class AliasDel {
 			this._log.info(
 				`alias:del - Start deleting alias from sink - Pathname: ${path}`,
 			);
-			await this._sink.delete(path);
+			if (this._sink) await this._sink.delete(path);
 		} catch (error) {
 			this._log.error(
 				`alias:del - Failed deleting alias from sink - Pathname: ${path}`,
@@ -119,7 +128,7 @@ const AliasDel = class AliasDel {
 		);
 
 		const outgoing = new HttpOutgoing();
-		outgoing.cacheControl = this._cacheControl;
+		outgoing.cacheControl = this._cacheControl || "";
 		outgoing.statusCode = 204;
 
 		end({ labels: { status: outgoing.statusCode, type } });

package/lib/handlers/alias.get-v2.js

@@ -52,6 +52,13 @@ const AliasGet = class AliasGet {
 		return this._metrics;
 	}
 
+	/**
+	 * @param {any} req
+	 * @param {string} type
+	 * @param {string} name
+	 * @param {string} alias
+	 * @param {string} extra
+	 */
 	async handler(req, type, name, alias, extra) {
 		const end = this._histogram.timer();
 
@@ -65,7 +72,9 @@ const AliasGet = class AliasGet {
 			validators.name(pName);
 			validators.type(type);
 		} catch (error) {
-			this._log.debug(`alias:get - Validation failed - ${error.message}`);
+			this._log.debug(
+				`alias:get - Validation failed - ${error instanceof Error ? error.message : String(error)}`,
+			);
 			const e = new HttpError.NotFound();
 			end({ labels: { success: false, status: e.status } });
 			throw e;
@@ -103,7 +112,7 @@ const AliasGet = class AliasGet {
 
 			const assetPath = createFilePathToAsset(asset);
 
-			const file = await this._sink.read(assetPath);
+			const file = await (this._sink && this._sink.read(assetPath));
 			const outgoing = new HttpOutgoing();
 			outgoing.cacheControl = this._cacheControl;
 			outgoing.mimeType = asset.mimeType;
@@ -119,14 +128,17 @@ const AliasGet = class AliasGet {
 				outgoing.statusCode = 200;
 				outgoing.stream = file.stream;
 
-				outgoing.stream.on("error", (err) => {
-					this._log.info(`alias:get - File stream error - ${err}`);
-					end({ labels: { success: false, status: 503, type } });
-				});
-
-				outgoing.stream.on("end", () => {
-					end({ labels: { status: outgoing.statusCode, type } });
-				});
+				const outgoingStream = outgoing.stream;
+				if (outgoingStream) {
+					outgoingStream.on("error", (err) => {
+						this._log.info(`alias:get - File stream error - ${err}`);
+						end({ labels: { success: false, status: 503, type } });
+					});
+
+					outgoingStream.on("end", () => {
+						end({ labels: { status: outgoing.statusCode, type } });
+					});
+				}
 			}
 
 			this._log.debug(`alias:get - Alias found - Pathname: ${path}`);

package/lib/handlers/alias.get.js

@@ -45,6 +45,13 @@ const AliasGet = class AliasGet {
 		return this._metrics;
 	}
 
+	/**
+	 * @param {any} req
+	 * @param {string} type
+	 * @param {string} name
+	 * @param {string} alias
+	 * @param {string} extra
+	 */
 	async handler(req, type, name, alias, extra) {
 		const end = this._histogram.timer();
 
@@ -58,7 +65,9 @@ const AliasGet = class AliasGet {
 			validators.name(pName);
 			validators.type(type);
 		} catch (error) {
-			this._log.debug(`alias:get - Validation failed - ${error.message}`);
+			this._log.debug(
+				`alias:get - Validation failed - ${error instanceof Error ? error.message : String(error)}`,
+			);
 			const e = new HttpError.NotFound();
 			end({ labels: { success: false, status: e.status } });
 			throw e;

package/lib/handlers/alias.post.js

@@ -57,6 +57,9 @@ const AliasPost = class AliasPost {
 		return this._metrics;
 	}
 
+	/**
+	 * @param {any} incoming
+	 */
 	_parser(incoming) {
 		return new Promise((resolve, reject) => {
 			this._multipart
@@ -88,7 +91,7 @@ const AliasPost = class AliasPost {
 							name: alias.name,
 							version: alias.version,
 						});
-						await this._sink.read(path);
+						if (this._sink) await this._sink.read(path);
 					} catch (error) {
 						this._log.error(
 							`alias:post - Unable to locate requested published package version - Version ${alias.name}@${alias.version}`,
@@ -127,10 +130,13 @@ const AliasPost = class AliasPost {
 		});
 	}
 
+	/**
+	 * @param {any} incoming
+	 */
 	async _exist(incoming) {
 		try {
 			const path = createFilePathToAlias(incoming);
-			await this._sink.exist(path);
+			if (this._sink) await this._sink.exist(path);
 			return true;
 			// eslint-disable-next-line no-unused-vars
 		} catch (error) {
@@ -138,6 +144,13 @@ const AliasPost = class AliasPost {
 		}
 	}
 
+	/**
+	 * @param {any} req
+	 * @param {any} user
+	 * @param {string} type
+	 * @param {string} name
+	 * @param {string} alias
+	 */
 	async handler(req, user, type, name, alias) {
 		const end = this._histogram.timer();
 
@@ -149,7 +162,9 @@ const AliasPost = class AliasPost {
 			validators.name(pName);
 			validators.type(type);
 		} catch (error) {
-			this._log.info(`alias:post - Validation failed - ${error.message}`);
+			this._log.info(
+				`alias:post - Validation failed - ${error instanceof Error ? error.message : String(error)}`,
+			);
 			const e = new HttpError.NotFound();
 			end({ labels: { success: false, status: e.status } });
 			throw e;
@@ -190,7 +205,7 @@ const AliasPost = class AliasPost {
 		await this._parser(incoming);
 
 		const outgoing = new HttpOutgoing();
-		outgoing.cacheControl = this._cacheControl;
+		outgoing.cacheControl = this._cacheControl || "";
 		outgoing.statusCode = 303;
 		outgoing.location = createURIToAlias(incoming);
 

package/lib/handlers/alias.put.js

@@ -57,6 +57,9 @@ const AliasPut = class AliasPut {
 		return this._metrics;
 	}
 
+	/**
+	 * @param {any} incoming
+	 */
 	_parser(incoming) {
 		return new Promise((resolve, reject) => {
 			this._multipart
@@ -88,7 +91,7 @@ const AliasPut = class AliasPut {
 							name: alias.name,
 							version: alias.version,
 						});
-						await this._sink.read(path);
+						if (this._sink) await this._sink.read(path);
 					} catch (error) {
 						this._log.error(
 							`alias:post - Unable to locate requested published package version - Version ${alias.name}@${alias.version}`,
@@ -127,10 +130,13 @@ const AliasPut = class AliasPut {
 		});
 	}
 
+	/**
+	 * @param {any} incoming
+	 */
 	async _exist(incoming) {
 		try {
 			const path = createFilePathToAlias(incoming);
-			await this._sink.exist(path);
+			if (this._sink) await this._sink.exist(path);
 			return true;
 			// eslint-disable-next-line no-unused-vars
 		} catch (error) {
@@ -138,6 +144,13 @@ const AliasPut = class AliasPut {
 		}
 	}
 
+	/**
+	 * @param {any} req
+	 * @param {any} user
+	 * @param {string} type
+	 * @param {string} name
+	 * @param {string} alias
+	 */
 	async handler(req, user, type, name, alias) {
 		const end = this._histogram.timer();
 
@@ -149,7 +162,9 @@ const AliasPut = class AliasPut {
 			validators.name(pName);
 			validators.type(type);
 		} catch (error) {
-			this._log.info(`alias:put - Validation failed - ${error.message}`);
+			this._log.info(
+				`alias:put - Validation failed - ${error instanceof Error ? error.message : String(error)}`,
+			);
 			const e = new HttpError.BadRequest();
 			end({ labels: { success: false, status: e.status } });
 			throw e;
@@ -190,7 +205,7 @@ const AliasPut = class AliasPut {
 		await this._parser(incoming);
 
 		const outgoing = new HttpOutgoing();
-		outgoing.cacheControl = this._cacheControl;
+		outgoing.cacheControl = this._cacheControl || "";
 		outgoing.statusCode = 303;
 		outgoing.location = createURIToAlias(incoming);
 

package/lib/handlers/auth.post.js

@@ -48,6 +48,9 @@ const AuthPost = class AuthPost {
 		return this._metrics;
 	}
 
+	/**
+	 * @param {any} incoming
+	 */
 	_parser(incoming) {
 		return new Promise((resolve, reject) => {
 			this._multipart
@@ -76,6 +79,9 @@ const AuthPost = class AuthPost {
 		});
 	}
 
+	/**
+	 * @param {any} req
+	 */
 	async handler(req) {
 		const end = this._histogram.timer();
 
@@ -98,7 +104,7 @@ const AuthPost = class AuthPost {
 		const obj = await this._parser(incoming);
 
 		const outgoing = new HttpOutgoing();
-		outgoing.cacheControl = this._cacheControl;
+		outgoing.cacheControl = this._cacheControl || "";
 		outgoing.statusCode = 200;
 		outgoing.mimeType = "application/json";
 		outgoing.body = obj;

package/lib/handlers/map.get.js

@@ -46,6 +46,11 @@ const MapGet = class MapGet {
 		return this._metrics;
 	}
 
+	/**
+	 * @param {any} req
+	 * @param {string} name
+	 * @param {string} version
+	 */
 	async handler(req, name, version) {
 		const end = this._histogram.timer();
 
@@ -56,7 +61,9 @@ const MapGet = class MapGet {
 			validators.version(pVersion);
 			validators.name(pName);
 		} catch (error) {
-			this._log.debug(`map:get - Validation failed - ${error.message}`);
+			this._log.debug(
+				`map:get - Validation failed - ${error instanceof Error ? error.message : String(error)}`,
+			);
 			const e = new HttpError.NotFound();
 			end({ labels: { success: false, status: e.status } });
 			throw e;
@@ -81,7 +88,7 @@ const MapGet = class MapGet {
 		});
 
 		try {
-			const file = await this._sink.read(path);
+			const file = await (this._sink && this._sink.read(path));
 			const outgoing = new HttpOutgoing();
 			outgoing.cacheControl = this._cacheControl;
 			outgoing.mimeType = "application/json";
@@ -97,14 +104,17 @@ const MapGet = class MapGet {
 				outgoing.statusCode = 200;
 				outgoing.stream = file.stream;
 
-				outgoing.stream.on("error", (err) => {
-					this._log.info(`map:get - File stream error - ${err}`);
-					end({ labels: { success: false, status: 503, type: "map" } });
-				});
-
-				outgoing.stream.on("end", () => {
-					end({ labels: { status: outgoing.statusCode, type: "map" } });
-				});
+				const outgoingStream = outgoing.stream;
+				if (outgoingStream) {
+					outgoingStream.on("error", (err) => {
+						this._log.info(`map:get - File stream error - ${err}`);
+						end({ labels: { success: false, status: 503, type: "map" } });
+					});
+
+					outgoingStream.on("end", () => {
+						end({ labels: { status: outgoing.statusCode, type: "map" } });
+					});
+				}
 			}
 
 			this._log.debug(`map:get - Import map found - Pathname: ${path}`);

package/lib/handlers/map.put.js

@@ -67,9 +67,13 @@ const MapPut = class MapPut {
 		return this._metrics;
 	}
 
+	/**
+	 * @param {any} incoming
+	 */
 	_parser(incoming) {
 		return new Promise((resolve, reject) => {
 			const path = createFilePathToImportMap(incoming);
+			/** @type {Promise<any>[]} */
 			const queue = [];
 
 			const busboy = Busboy({
@@ -81,15 +85,18 @@ const MapPut = class MapPut {
 				},
 			});
 
-			busboy.on("file", (fieldname, file) => {
-				queue.push(
-					this._handleFile({
-						fieldname,
-						file,
-						path,
-					}),
-				);
-			});
+			busboy.on(
+				"file",
+				(/** @type {any} */ fieldname, /** @type {any} */ file) => {
+					queue.push(
+						this._handleFile({
+							fieldname,
+							file,
+							path,
+						}),
+					);
+				},
+			);
 
 			busboy.on("close", () => {
 				Promise.all(queue)
@@ -103,7 +110,7 @@ const MapPut = class MapPut {
 					});
 			});
 
-			busboy.on("error", (error) => {
+			busboy.on("error", (/** @type {any} */ error) => {
 				reject(error);
 			});
 
@@ -114,6 +121,9 @@ const MapPut = class MapPut {
 		});
 	}
 
+	/**
+	 * @param {{ fieldname: any, file: any, path: any }} options
+	 */
 	async _handleFile({ fieldname, file, path }) {
 		// We accept only one file on this given fieldname.
 		// Throw if any other files is posted.
@@ -128,7 +138,7 @@ const MapPut = class MapPut {
 
 		// Buffer up the incoming file and check if we can
 		// parse it as JSON or not.
-		let obj = {};
+		let obj;
 		try {
 			const str = await streamCollector(file);
 			hasher.update(str);
@@ -160,6 +170,9 @@ const MapPut = class MapPut {
 		return `sha512-${hasher.digest("base64")}`;
 	}
 
+	/**
+	 * @param {any} incoming
+	 */
 	async _readVersions(incoming) {
 		const path = createFilePathToVersion(incoming);
 		let versions;
@@ -180,6 +193,10 @@ const MapPut = class MapPut {
 		return versions;
 	}
 
+	/**
+	 * @param {any} incoming
+	 * @param {any} versions
+	 */
 	async _writeVersions(incoming, versions) {
 		const path = createFilePathToVersion(incoming);
 		await writeJSON(this._sink, path, versions, "application/json");
@@ -188,6 +205,12 @@ const MapPut = class MapPut {
 		);
 	}
 
+	/**
+	 * @param {any} req
+	 * @param {any} user
+	 * @param {string} name
+	 * @param {string} version
+	 */
 	async handler(req, user, name, version) {
 		const end = this._histogram.timer();
 
@@ -198,7 +221,9 @@ const MapPut = class MapPut {
 			validators.version(pVersion);
 			validators.name(pName);
 		} catch (error) {
-			this._log.info(`map:put - Validation failed - ${error.message}`);
+			this._log.info(
+				`map:put - Validation failed - ${error instanceof Error ? error.message : String(error)}`,
+			);
 			const e = new HttpError.BadRequest();
 			end({ labels: { success: false, status: e.status } });
 			throw e;
@@ -250,7 +275,7 @@ const MapPut = class MapPut {
 		}
 
 		const outgoing = new HttpOutgoing();
-		outgoing.cacheControl = this._cacheControl;
+		outgoing.cacheControl = this._cacheControl || "";
 		outgoing.statusCode = 303;
 		outgoing.location = createURIPathToImportMap(incoming);
 

package/lib/handlers/pkg.get.js

@@ -48,6 +48,13 @@ const PkgGet = class PkgGet {
 		return this._metrics;
 	}
 
+	/**
+	 * @param {any} req
+	 * @param {string} type
+	 * @param {string} name
+	 * @param {string} version
+	 * @param {string} extra
+	 */
 	async handler(req, type, name, version, extra) {
 		const end = this._histogram.timer();
 
@@ -61,7 +68,9 @@ const PkgGet = class PkgGet {
 			validators.name(pName);
 			validators.type(type);
 		} catch (error) {
-			this._log.debug(`pkg:get - Validation failed - ${error.message}`);
+			this._log.debug(
+				`pkg:get - Validation failed - ${error instanceof Error ? error.message : String(error)}`,
+			);
 			const e = new HttpError.NotFound();
 			end({ labels: { success: false, status: e.status } });
 			throw e;
@@ -90,7 +99,7 @@ const PkgGet = class PkgGet {
 		const path = createFilePathToAsset(asset);
 
 		try {
-			const file = await this._sink.read(path);
+			const file = await (this._sink && this._sink.read(path));
 			const outgoing = new HttpOutgoing();
 			outgoing.cacheControl = this._cacheControl;
 			outgoing.mimeType = asset.mimeType;
@@ -106,14 +115,17 @@ const PkgGet = class PkgGet {
 				outgoing.statusCode = 200;
 				outgoing.stream = file.stream;
 
-				outgoing.stream.on("error", (err) => {
-					this._log.info(`pkg:get - File stream error - ${err}`);
-					end({ labels: { success: false, status: 503, type } });
-				});
-
-				outgoing.stream.on("end", () => {
-					end({ labels: { status: outgoing.statusCode, type } });
-				});
+				const outgoingStream = outgoing.stream;
+				if (outgoingStream) {
+					outgoingStream.on("error", (err) => {
+						this._log.info(`pkg:get - File stream error - ${err}`);
+						end({ labels: { success: false, status: 503, type } });
+					});
+
+					outgoingStream.on("end", () => {
+						end({ labels: { status: outgoing.statusCode, type } });
+					});
+				}
 			}
 
 			this._log.debug(`pkg:get - Asset found - Pathname: ${path}`);