@eveshipfit/zkillboard 1.0.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2023 EVEShipFit Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,28 @@
+# @eveshipfit/zkillboard
+
+A small client for [zKillboard](https://zkillboard.com)'s API.
+
+Part of [EVEShip.fit](https://eveship.fit).
+
+## Install
+
+```sh
+npm install @eveshipfit/zkillboard
+```
+
+## Usage
+
+```ts
+import { ZKillboard } from "@eveshipfit/zkillboard";
+
+const zkillboard = new ZKillboard();
+
+await zkillboard.price(35834); // a Keepstar, in ISK
+```
+
+zKillboard prices what ESI has no market price for, like capital modules and Keepstars. Requests go one at a time, a
+second apart, and each type is asked for once.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,8 @@
+//#region src/zkillboard.d.ts
+/** A zKillboard client. */
+export declare class ZKillboard {
+  #private;
+  /** zKillboard's current price of a type in ISK; undefined when it has none. */
+  price(typeId: number): Promise<number | undefined>;
+}
+//#endregion

package/dist/index.mjs

@@ -0,0 +1,32 @@
+//#region src/zkillboard.ts
+const baseUrl = "https://zkillboard.com/api";
+const timeout = 1e4;
+const spacing = 1e3;
+/** A zKillboard client. */
+var ZKillboard = class {
+	#prices = /* @__PURE__ */ new Map();
+	#queue = Promise.resolve();
+	/** zKillboard's current price of a type in ISK; undefined when it has none. */
+	price(typeId) {
+		let price = this.#prices.get(typeId);
+		if (price === void 0) {
+			price = this.#queued(() => fetchPrice(typeId));
+			this.#prices.set(typeId, price);
+		}
+		return price;
+	}
+	#queued(request) {
+		const result = this.#queue.then(request);
+		this.#queue = result.catch(() => {}).then(() => new Promise((resolve) => setTimeout(resolve, spacing)));
+		return result;
+	}
+};
+async function fetchPrice(typeId) {
+	const response = await fetch(`${baseUrl}/prices/${typeId}/`, { signal: AbortSignal.timeout(timeout) });
+	if (!response.ok) throw new Error(`zKillboard /prices/${typeId}/: HTTP ${response.status}`);
+	const { currentPrice } = await response.json();
+	const price = Number(currentPrice);
+	return price > .01 ? price : void 0;
+}
+//#endregion
+export { ZKillboard };

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@eveshipfit/zkillboard",
+  "version": "1.0.0",
+  "description": "A small client for zKillboard",
+  "license": "MIT",
+  "author": "EVEShipFit Team <info@eveship.fit>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EVEShipFit/eveship.fit.git",
+    "directory": "packages/zkillboard"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsdown": "^0.23.0"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
+}