blossom-client-sdk 0.7.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/lib/image.d.ts +12 -2
- package/lib/image.js +66 -11
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
package/lib/image.d.ts
CHANGED
|
@@ -1,7 +1,17 @@
|
|
|
1
|
+
type GetServersMethod = (pubkey?: string) => Promise<(string | URL)[] | undefined> | undefined;
|
|
1
2
|
/**
|
|
2
3
|
* attaches an "error" event listener to a HTMLImageElement element to handle server fallbacks
|
|
3
4
|
* @param image The image element
|
|
4
5
|
* @param getServers A async method to get an ordered list of servers for a pubkey
|
|
5
|
-
* @param
|
|
6
|
+
* @param overridePubkey An optional pubkey to set the `data-pubkey` attr on the image
|
|
7
|
+
* @returns returns a method to remove the "error" event listener
|
|
6
8
|
*/
|
|
7
|
-
export declare function handleImageFallbacks(image: HTMLImageElement, getServers:
|
|
9
|
+
export declare function handleImageFallbacks(image: HTMLImageElement, getServers: GetServersMethod, overridePubkey?: string): () => void;
|
|
10
|
+
/**
|
|
11
|
+
* Watch for any broken <img> elements in the tree and attempt to fix them
|
|
12
|
+
* @param root The root element to observe
|
|
13
|
+
* @param getServers A method used to get a list of servers for a specific pubkey
|
|
14
|
+
* @returns A MutationObserver that is observing the root element
|
|
15
|
+
*/
|
|
16
|
+
export declare function handleBrokenImages(root: HTMLElement, getServers: GetServersMethod): MutationObserver;
|
|
17
|
+
export {};
|
package/lib/image.js
CHANGED
|
@@ -3,22 +3,34 @@ import { getHashFromURL } from "./helpers.js";
|
|
|
3
3
|
* attaches an "error" event listener to a HTMLImageElement element to handle server fallbacks
|
|
4
4
|
* @param image The image element
|
|
5
5
|
* @param getServers A async method to get an ordered list of servers for a pubkey
|
|
6
|
-
* @param
|
|
6
|
+
* @param overridePubkey An optional pubkey to set the `data-pubkey` attr on the image
|
|
7
|
+
* @returns returns a method to remove the "error" event listener
|
|
7
8
|
*/
|
|
8
|
-
export function handleImageFallbacks(image, getServers,
|
|
9
|
-
|
|
10
|
-
const hash = getHashFromURL(original);
|
|
11
|
-
if (!hash)
|
|
12
|
-
return;
|
|
13
|
-
if (pubkey)
|
|
14
|
-
image.dataset.pubkey = pubkey;
|
|
15
|
-
let tried = [original.hostname];
|
|
9
|
+
export function handleImageFallbacks(image, getServers, overridePubkey) {
|
|
10
|
+
let tried = [];
|
|
16
11
|
let servers = undefined;
|
|
17
12
|
const onError = async () => {
|
|
13
|
+
const hash = getHashFromURL(image.src);
|
|
14
|
+
if (!hash)
|
|
15
|
+
return;
|
|
18
16
|
const url = new URL(image.src);
|
|
19
17
|
const ext = url.pathname.match(/\.\w+$/i);
|
|
18
|
+
tried.push(url.hostname);
|
|
19
|
+
let pubkey = overridePubkey;
|
|
20
|
+
// walk up the tree looking for pubkey
|
|
21
|
+
let el = image;
|
|
22
|
+
while (!pubkey && el.parentElement) {
|
|
23
|
+
if (el.dataset.pubkey)
|
|
24
|
+
pubkey = el.dataset.pubkey;
|
|
25
|
+
else
|
|
26
|
+
el = el.parentElement;
|
|
27
|
+
}
|
|
28
|
+
if (!pubkey) {
|
|
29
|
+
console.warn("Failed to find pubkey for broken image", image);
|
|
30
|
+
return;
|
|
31
|
+
}
|
|
20
32
|
if (!servers)
|
|
21
|
-
servers = (await getServers(
|
|
33
|
+
servers = (await getServers(pubkey))?.map((s) => (s instanceof URL ? s : new URL(s)));
|
|
22
34
|
if (servers) {
|
|
23
35
|
const server = servers.find((s) => !tried.includes(s.hostname));
|
|
24
36
|
if (server) {
|
|
@@ -26,7 +38,6 @@ export function handleImageFallbacks(image, getServers, pubkey) {
|
|
|
26
38
|
url.pathname = "/" + hash + ext;
|
|
27
39
|
url.protocol = server.protocol;
|
|
28
40
|
image.src = url.toString();
|
|
29
|
-
tried.push(url.hostname);
|
|
30
41
|
}
|
|
31
42
|
else {
|
|
32
43
|
// ran out of servers, stop listening for errors
|
|
@@ -35,4 +46,48 @@ export function handleImageFallbacks(image, getServers, pubkey) {
|
|
|
35
46
|
}
|
|
36
47
|
};
|
|
37
48
|
image.addEventListener("error", onError);
|
|
49
|
+
return () => image.removeEventListener("error", onError);
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Watch for any broken <img> elements in the tree and attempt to fix them
|
|
53
|
+
* @param root The root element to observe
|
|
54
|
+
* @param getServers A method used to get a list of servers for a specific pubkey
|
|
55
|
+
* @returns A MutationObserver that is observing the root element
|
|
56
|
+
*/
|
|
57
|
+
export function handleBrokenImages(root, getServers) {
|
|
58
|
+
const listeners = new WeakMap();
|
|
59
|
+
const observer = new MutationObserver((changes) => {
|
|
60
|
+
for (const change of changes) {
|
|
61
|
+
if (change.type === "childList") {
|
|
62
|
+
// add "error" event handles to any new <img/> elements
|
|
63
|
+
change.addedNodes.forEach((el) => {
|
|
64
|
+
if (el instanceof HTMLImageElement && !listeners.has(el)) {
|
|
65
|
+
const listener = handleImageFallbacks(el, getServers);
|
|
66
|
+
listeners.set(el, listener);
|
|
67
|
+
}
|
|
68
|
+
});
|
|
69
|
+
// cleanup removed nodes
|
|
70
|
+
change.removedNodes.forEach((el) => {
|
|
71
|
+
if (el instanceof HTMLImageElement) {
|
|
72
|
+
const listener = listeners.get(el);
|
|
73
|
+
if (listener) {
|
|
74
|
+
listener();
|
|
75
|
+
listeners.delete(el);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
});
|
|
82
|
+
// start watching root
|
|
83
|
+
observer.observe(root, { subtree: true, childList: true });
|
|
84
|
+
// find all existing images and attach error handler
|
|
85
|
+
const images = root.querySelectorAll("img[src]");
|
|
86
|
+
images.forEach((image) => {
|
|
87
|
+
if (image instanceof HTMLImageElement) {
|
|
88
|
+
const listener = handleImageFallbacks(image, getServers);
|
|
89
|
+
listeners.set(image, listener);
|
|
90
|
+
}
|
|
91
|
+
});
|
|
92
|
+
return observer;
|
|
38
93
|
}
|