@eik/common 5.0.4 → 5.1.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [5.1.0](https://github.com/eik-lib/common/compare/v5.0.4...v5.1.0) (2025-05-08)
+
+
+### Features
+
+* new helper function fetchImportMaps ([#358](https://github.com/eik-lib/common/issues/358)) ([0f89645](https://github.com/eik-lib/common/commit/0f89645937a5c786ea54cd4ff873c37de3efee01))
+
 ## [5.0.4](https://github.com/eik-lib/common/compare/v5.0.3...v5.0.4) (2025-04-23)
 
 

package/README.md

@@ -9,12 +9,12 @@ can be found here in this repo. Here is how you can use it in your `eik.json`.
 
 ```json
 {
-    "$schema": "https://raw.githubusercontent.com/eik-lib/common/main/lib/schemas/eikjson.schema.json",
-    "name": "my-app",
-    "version": "1.0.0",
-    "server": "https://eik.store.com",
-    "files": "./public",
-    "import-map": ["https://eik.store.com/map/store/v1"]
+	"$schema": "https://raw.githubusercontent.com/eik-lib/common/main/lib/schemas/eikjson.schema.json",
+	"name": "my-app",
+	"version": "1.0.0",
+	"server": "https://eik.store.com",
+	"files": "./public",
+	"import-map": ["https://eik.store.com/map/store/v1"]
 }
 ```
 
@@ -27,7 +27,7 @@ can be found here in this repo. Here is how you can use it in your `eik.json`.
 `helpers` has utility functions used by several other Eik modules.
 
 ```js
-import { helpers } from '@eik/common';
+import { helpers } from "@eik/common";
 
 let config = helpers.getDefaults();
 ```
@@ -46,6 +46,7 @@ These are the available functions on `helpers`.
 | `removeLeadingSlash`  |                                                                                                                                                                                                  |
 | `resolveFiles`        | Uses an Eik JSON "files" definition to resolve files on disk into a data structure. Returns a list of [ResolvedFile](https://github.com/eik-lib/common/blob/main/lib/classes/resolved-files.js). |
 | `configStore`         | Collection of helper methods for reading and writing Eik configuration files.                                                                                                                    |
+| `fetchImportMaps`     | Helper to get import maps (array of URLs) with some common error handling.                                                                                                                       |
 
 #### localAssets
 
@@ -54,8 +55,8 @@ Sets up asset routes for local development. Mounted paths match those on Eik ser
 Given this server and `eik.json`, the following routes would be added to your app.
 
 ```js
-import { helpers } from '@eik/common';
-import express from 'express';
+import { helpers } from "@eik/common";
+import express from "express";
 
 let app = express();
 
@@ -64,14 +65,14 @@ await helpers.localAssets(app);
 
 ```json
 {
-    "name": "my-app",
-    "version": "1.0.0",
-    "server": "https://eik.store.com",
-    "files": {
-        "esm.js": "./assets/esm.js",
-        "esm.css": "./assets/esm.css",
-        "/": "./assets/**/*.map"
-    }
+	"name": "my-app",
+	"version": "1.0.0",
+	"server": "https://eik.store.com",
+	"files": {
+		"esm.js": "./assets/esm.js",
+		"esm.css": "./assets/esm.css",
+		"/": "./assets/**/*.map"
+	}
 }
 ```
 
@@ -89,23 +90,23 @@ You can check a value against the schema for `eik.json` as a whole, or for indiv
 values in the schema.
 
 ```js
-import { schemas } from '@eik/common';
+import { schemas } from "@eik/common";
 
 let { error, value } = schemas.validate.eikJSON(eikConfig);
 if (error) {
-    // fallback
+	// fallback
 }
 ```
 
 If you prefer, you can use the `assert` API which throws on error.
 
 ```js
-import { schemas } from '@eik/common';
+import { schemas } from "@eik/common";
 
 try {
-    schemas.assert.eikJSON(eikConfig);
+	schemas.assert.eikJSON(eikConfig);
 } catch {
-    // fallback
+	// fallback
 }
 ```
 
@@ -127,14 +128,14 @@ These are the available functions on `schemas.validate` and `schemas.assert`.
 `stream` has functions to check that a value is a Stream.
 
 ```js
-import { stream } from '@eik/common';
+import { stream } from "@eik/common";
 
 if (stream.isStream(maybeStream)) {
-    // yup, it's a Stream
+	// yup, it's a Stream
 }
 
 if (stream.isReadableStream(maybeReadableStream)) {
-    // yup, it's a ReadableStream
+	// yup, it's a ReadableStream
 }
 ```
 
@@ -144,9 +145,9 @@ if (stream.isReadableStream(maybeReadableStream)) {
 Where possible, prefer using the [`schemas` API](#schemas).
 
 ```js
-import { validators } from '@eik/common';
+import { validators } from "@eik/common";
 
-let alias = validators.alias('1');
+let alias = validators.alias("1");
 ```
 
 These are the available functions on `validators`.

package/lib/helpers/fetch-import-maps.js

@@ -0,0 +1,45 @@
+/**
+ * @typedef {object} ImportMap
+ * @property {Record<string, string>} imports
+ */
+
+/**
+ * @param {string[]} urls
+ * @returns {Promise<ImportMap[]>}
+ */
+export async function fetchImportMaps(urls = []) {
+	try {
+		const maps = urls.map(async (map) => {
+			const response = await fetch(map);
+
+			if (response.status === 404) {
+				throw new Error("Import map could not be found on server");
+			} else if (response.status >= 400 && response.status < 500) {
+				throw new Error("Server rejected client request");
+			} else if (response.status >= 500) {
+				throw new Error("Server error");
+			}
+
+			let contentType = response.headers.get("content-type");
+			if (!contentType.startsWith("application/json")) {
+				const content = await response.text();
+				if (content.length === 0) {
+					throw new Error(
+						`${map} did not return JSON, got an empty response. HTTP status: ${response.status}`,
+					);
+				}
+				throw new Error(
+					`${map} did not return JSON, got: ${content}. HTTP status: ${response.status}`,
+				);
+			}
+
+			const json = await response.json();
+			return /** @type {ImportMap}*/ (json);
+		});
+		return await Promise.all(maps);
+	} catch (err) {
+		throw new Error(
+			`Unable to load import map file from server: ${err.message}`,
+		);
+	}
+}

package/lib/helpers/index.js

@@ -1,6 +1,7 @@
 import localAssets from "./local-assets.js";
 import getDefaults from "./get-defaults.js";
 import configStore from "./config-store.js";
+import { fetchImportMaps } from "./fetch-import-maps.js";
 import typeSlug from "./type-slug.js";
 import typeTitle from "./type-title.js";
 import resolveFiles from "./resolve-files.js";
@@ -15,6 +16,7 @@ export default {
 	localAssets,
 	getDefaults,
 	configStore,
+	fetchImportMaps,
 	typeSlug,
 	typeTitle,
 	addTrailingSlash,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eik/common",
-  "version": "5.0.4",
+  "version": "5.1.0",
   "description": "Common utilities for Eik modules",
   "main": "lib/index.js",
   "types": "types/index.d.ts",
@@ -44,10 +44,10 @@
     "validate-npm-package-name": "6.0.0"
   },
   "devDependencies": {
-    "@babel/plugin-syntax-import-assertions": "7.26.0",
-    "@eik/eslint-config": "1.0.10",
+    "@babel/plugin-syntax-import-assertions": "7.27.1",
+    "@eik/eslint-config": "1.0.13",
     "@eik/prettier-config": "1.0.1",
-    "@eik/semantic-release-config": "1.0.0",
+    "@eik/semantic-release-config": "1.0.2",
     "@eik/typescript-config": "1.0.0",
     "@hapi/hapi": "21.3.12",
     "@semantic-release/changelog": "6.0.3",

package/types/helpers/fetch-import-maps.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @typedef {object} ImportMap
+ * @property {Record<string, string>} imports
+ */
+/**
+ * @param {string[]} urls
+ * @returns {Promise<ImportMap[]>}
+ */
+export function fetchImportMaps(urls?: string[]): Promise<ImportMap[]>;
+export type ImportMap = {
+    imports: Record<string, string>;
+};

package/types/helpers/index.d.ts

@@ -2,6 +2,7 @@ declare namespace _default {
     export { localAssets };
     export { getDefaults };
     export { configStore };
+    export { fetchImportMaps };
     export { typeSlug };
     export { typeTitle };
     export { addTrailingSlash };
@@ -14,6 +15,7 @@ export default _default;
 import localAssets from "./local-assets.js";
 import getDefaults from "./get-defaults.js";
 import configStore from "./config-store.js";
+import { fetchImportMaps } from "./fetch-import-maps.js";
 import typeSlug from "./type-slug.js";
 import typeTitle from "./type-title.js";
 import { addTrailingSlash } from "./path-slashes.js";