spooder 5.1.0 → 5.1.1

package/README.md

@@ -531,7 +531,7 @@ Replacements = Record<string, string | Array<string> | object | object[]> | Repl
 parse_template(template: string, replacements: Replacements, drop_missing?: boolean): Promise<string>;
 
 // cache busting
-cache_bust(string: path, format: string): string
+cache_bust(string|string[]: path, format: string): string|string[]
 cache_bust_set_hash_length(length: number): void;
 cache_bust_set_format(format: string): void;
 cache_bust_get_hash_table(): Record<string, string>;
@@ -2048,7 +2048,7 @@ await parse_template(..., {
 <a id="api-cache-busting"></a>
 ## API > Cache Busting
 
-### 🔧 ``cache_bust(string: path, format: string): string``
+### 🔧 ``cache_bust(string|string[]: path, format: string): string|string[]``
 
 Appends a hash-suffix to the provided string, formatted by default as a query parameter, for cache-busting purposes.
 
@@ -2056,6 +2056,20 @@ Appends a hash-suffix to the provided string, formatted by default as a query pa
 cache_bust('static/my_image.png'); // > static/my_image.png?v=123fea
 ```
 
+This works on an array of paths as well.
+
+```ts
+cache_bust([
+	'static/js/script1.js',
+	'static/js/script2.js'
+]);
+
+// [
+//    'static/js/script1.js?v=fffffff',
+//    'static/js/script2.js?v=fffffff'
+// ]
+```
+
 > ![NOTE]
 > Internally `cache_bust()` uses `git_get_hashes()` to hash paths, requiring the input `path` to be a valid git path. If the path cannot be resolved in git, an empty hash is substituted.
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "spooder",
 	"type": "module",
-	"version": "5.1.0",
+	"version": "5.1.1",
 	"module": "./src/api.ts",
 	"bin": {
 		"spooder": "./src/cli.ts"

package/src/api.ts

@@ -570,9 +570,25 @@ export function cache_bust_get_hash_table(): Record<string, string> {
 	return cache_bust_map;
 }
 
-export function cache_bust(path: string, format = cache_bust_global_format): string {
-	const hash = cache_bust_get_hash_table()[path] || '';
-	return format.replace('$file', path).replace('$hash', hash);
+export function cache_bust(paths: string|string[], format = cache_bust_global_format): string|string[] {
+	const hash_table = cache_bust_get_hash_table();
+
+	if (Array.isArray(paths)) {
+		const n_paths = paths.length;
+		const result = Array<string>(n_paths);
+
+		for (let i = 0; i < n_paths; i++) {
+			const path = paths[i];
+			const hash = hash_table[path] ?? '';
+
+			result[i] = format.replace('$file', path).replace('$hash', hash);
+		}
+
+		return result;
+	} else {
+		const hash = cache_bust_get_hash_table()[paths] ?? '';
+		return format.replace('$file', paths).replace('$hash', hash);
+	}
 }
 
 export function cache_bust_set_hash_length(length: number): void {