Port the source code to JS

cedx · Apr 27, 2024 · e14100b · e14100b
1 parent cb6d529
commit e14100b
Show file tree

Hide file tree

Showing 5 changed files with 153 additions and 151 deletions.
diff --git a/res/releases.json b/res/releases.json
@@ -0,0 +1,96 @@
+[
+	{
+		"version": "1.14.0",
+		"assets": [
+			{"platform": "win32", "file": "hashlink-1.14.0-win.zip"}
+		]
+	},
+	{
+		"version": "1.13.0",
+		"assets": [
+			{"platform": "win32", "file": "hashlink-1.13.0-win.zip"}
+		]
+	},
+	{
+		"version": "1.12.0",
+		"assets": [
+			{"platform": "win32", "file": "hl-1.12.0-win.zip"}
+		]
+	},
+	{
+		"version": "1.11.0",
+		"assets": [
+			{"platform": "win32", "file": "hl-1.11.0-win.zip"}
+		]
+	},
+	{
+		"version": "1.10.0",
+		"assets": [
+			{"platform": "win32", "file": "hl-1.10.0-win.zip"}
+		]
+	},
+	{
+		"version": "1.9.0",
+		"assets": [
+			{"platform": "win32", "file": "hl-1.9.0-win.zip"}
+		]
+	},
+	{
+		"version": "1.8.0",
+		"assets": [
+			{"platform": "win32", "file": "hl-1.8.0-win.zip"}
+		]
+	},
+	{
+		"version": "1.7.0",
+		"assets": [
+			{"platform": "win32", "file": "hl-1.7.0-win.zip"}
+		]
+	},
+	{
+		"version": "1.6.0",
+		"assets": [
+			{"platform": "linux", "file": "hl-1.6.0-linux.tgz"},
+			{"platform": "win32", "file": "hl-1.6.0-win.zip"}
+		]
+	},
+	{
+		"version": "1.5.0",
+		"assets": [
+			{"platform": "linux", "file": "hl-1.5.0-linux.tgz"},
+			{"platform": "win32", "file": "hl-1.5.0-win.zip"}
+		]
+	},
+	{
+		"version": "1.4.0",
+		"assets": [
+			{"platform": "win32", "file": "hl-1.4-win.zip"}
+		]
+	},
+	{
+		"version": "1.3.0",
+		"assets": [
+			{"platform": "darwin", "file": "hl-1.3-osx32.zip"},
+			{"platform": "win32", "file": "hl-1.3-win32.zip"}
+		]
+	},
+	{
+		"version": "1.2.0",
+		"assets": [
+			{"platform": "darwin", "file": "hl-1.2-osx.zip"},
+			{"platform": "win32", "file": "hl-1.2-win32.zip"}
+		]
+	},
+	{
+		"version": "1.1.0",
+		"assets": [
+			{"platform": "win32", "file": "hl-1.1-win32.zip"}
+		]
+	},
+	{
+		"version": "1.0.0",
+		"assets": [
+			{"platform": "win32", "file": "hl-1.0-win32.zip"}
+		]
+	}
+]
diff --git a/src/data.ts b/src/data.ts
diff --git a/src/index.ts → src/index.js b/src/index.ts → src/index.js
diff --git a/src/release.ts → src/release.js b/src/release.ts → src/release.js
@@ -1,6 +1,6 @@
 import process from "node:process";
 import semver, {SemVer} from "semver";
-import data from "./data.js";
+import releases from "../res/releases.json" with {type: "json"};
 
 /**
  * Represents a GitHub release.
@@ -9,111 +9,115 @@ export class Release {
 
 	/**
 	 * The base URL of the releases.
+	 * @type {URL}
+	 * @readonly
 	 */
-	static readonly #baseUrl = new URL("https://github.com/HaxeFoundation/hashlink/");
+	static #baseUrl = new URL("https://github.com/HaxeFoundation/hashlink/");
 
 	/**
 	 * The list of all releases.
+	 * @type {Release[]}
+	 * @readonly
 	 */
-	static readonly #data = data.map(release => new this(release.version, release.assets));
+	static #data = releases.map(release => new this(release.version, release.assets));
 
 	/**
 	 * The associated assets.
+	 * @type {ReleaseAsset[]}
+	 * @readonly
 	 */
-	readonly assets: ReleaseAsset[];
+	assets;
 
 	/**
 	 * The version number.
+	 * @type {string}
+	 * @readonly
 	 */
-	readonly version: string;
+	version;
 
 	/**
 	 * Creates a new release.
-	 * @param version The version number.
-	 * @param assets The associated assets.
+	 * @param {string} version The version number.
+	 * @param {ReleaseAsset[]} assets The associated assets.
 	 */
-	constructor(version: string, assets: ReleaseAsset[] = []) {
+	constructor(version, assets = []) {
 		this.assets = assets;
 		this.version = version;
 	}
 
 	/**
 	 * The latest release.
+	 * @type {Release}
 	 */
-	static get latest(): Release {
+	static get latest() {
 		return this.#data[0];
 	}
 
 	/**
 	 * Value indicating whether this release exists.
+	 * @type {boolean}
 	 */
-	get exists(): boolean {
+	get exists() {
 		return Release.#data.some(release => release.version == this.version);
 	}
 
 	/**
 	 * Value indicating whether this release is provided as source code.
+	 * @type {boolean}
 	 */
-	get isSource(): boolean {
+	get isSource() {
 		return !this.getAsset(process.platform);
 	}
 
 	/**
 	 * The associated Git tag.
+	 * @type {string}
 	 */
-	get tag(): string {
+	get tag() {
 		const {major, minor, patch} = new SemVer(this.version);
 		return patch > 0 ? `${major}.${minor}.${patch}` : `${major}.${minor}`;
 	}
 
 	/**
 	 * The download URL.
+	 * @type {URL}
 	 */
-	get url(): URL {
+	get url() {
 		const asset = this.getAsset(process.platform);
 		return new URL(asset ? `releases/download/${this.tag}/${asset.file}` : `archive/refs/tags/${this.tag}.zip`, Release.#baseUrl);
 	}
 
 	/**
 	 * Finds a release that matches the specified version constraint.
-	 * @param constraint The version constraint.
-	 * @returns The release corresponding to the specified constraint.
+	 * @param {string} constraint The version constraint.
+	 * @returns {Release|null} The release corresponding to the specified constraint.
 	 */
-	static find(constraint: string): Release|null {
+	static find(constraint) {
 		return this.#data.find(release => semver.satisfies(release.version, constraint)) ?? null;
 	}
 
 	/**
 	 * Gets the release corresponding to the specified version.
-	 * @param version The version number of a release.
-	 * @returns The release corresponding to the specified version.
+	 * @param {string} version The version number of a release.
+	 * @returns {Release|null} The release corresponding to the specified version.
 	 */
-	static get(version: string): Release|null {
+	static get(version) {
 		return this.#data.find(release => release.version == version) ?? null;
 	}
 
 	/**
 	 * Gets the asset corresponding to the specified platform.
-	 * @param platform The target platform.
-	 * @returns The asset corresponding to the specified platform.
+	 * @param {NodeJS.Platform} platform The target platform.
+	 * @returns {ReleaseAsset|null} The asset corresponding to the specified platform.
 	 */
-	getAsset(platform: NodeJS.Platform): ReleaseAsset|null {
+	getAsset(platform) {
 		return this.assets.find(asset => asset.platform == platform) ?? null;
 	}
 }
 
 /**
  * Represents an asset of a GitHub release.
+ * @typedef {object} ReleaseAsset
+ * @property {string} file The target file.
+ * @property {string} platform The target platform.
  */
-export interface ReleaseAsset {
-
-	/**
-	 * The target file.
-	 */
-	readonly file: string;
-
-	/**
-	 * The target platform.
-	 */
-	readonly platform: string;
-}