@lat-murmeldjur/weeb_3 0.0.352001 → 0.0.353001

package/README.md

@@ -33,6 +33,8 @@ The higher-level `Weeb3No103` interface provides the main methods used by the em
 - `uploadWithRedundancy(file, encryption, redundancy_level, index_string, add_to_feed, feed_topic)`
 - `postUploadBytesWithRedundancy(bytes, mime, filename, encryption, redundancy_level, add_to_feed, feed_topic)`
 - `attachStream(media, owner, topic, start)`
+- `streamQuality(media)` and `setStreamQuality(media, level)`
+- `connectionCount()`
 - `renderInterface(container)`
 - `resetStamp()`
 - `postPushChunk(data, soc, chunk_address, stamp)`
@@ -95,6 +97,25 @@ await node.attachStream(video, owner, topic, "live");
 
 Public HLS feeds use mainnet. The embedding page must be below the `/weeb-3/` scope and serve the packaged worker at `/weeb-3/service.js`, or already be controlled by a worker implementing the same forwarding protocol.
 
+`streamQuality(video)` returns the available `levels` (`level`, `width`, `height`, and `bitrate`), the requested `selectedLevel`, and the playing `currentLevel`. Levels become available after the master playlist loads. A selected level of `-1` means Auto; a current level of `-1` means no rendition is playing yet. The highest available resolution is the initial selection. Quality controls require an attached hls.js stream; native HLS is unsupported, and switching during a history seek is temporarily unavailable.
+
+For example, your application's periodic monitor can lower resolution when too few peers are connected:
+
+```js
+async function reduceResolutionBelow(minimumConnections) {
+  if (await node.connectionCount() >= minimumConnections) return;
+  const { levels, selectedLevel, currentLevel } = node.streamQuality(video);
+  if (selectedLevel >= 0 && selectedLevel !== currentLevel) return;
+  const current = levels.find(({ level }) => level === currentLevel);
+  if (!current) return;
+  const lower = levels.filter(({ height }) => height > 0 && height < current.height)
+    .sort((a, b) => b.height - a.height || b.bitrate - a.bitrate)[0];
+  if (lower) node.setStreamQuality(video, lower.level);
+}
+```
+
+The host chooses the threshold and monitoring interval; the library adds no poller. `setStreamQuality` accepts a request synchronously through the built-in selector's switching path; `currentLevel` reports when the switch takes effect. Pass `-1` to restore Auto. `connectionCount()` reads the shared worker's connected peer count without requesting logs or progress; worker communication failures reject its promise.
+
 ## Example corresponding to `example.html`
 
 This is a compact npm-import form of the same usage pattern shown in the project's `example.html`:

package/package.json

@@ -2,7 +2,7 @@
   "name": "@lat-murmeldjur/weeb_3",
   "type": "module",
   "description": "A Swarm client for browsers",
-  "version": "0.0.352001",
+  "version": "0.0.353001",
   "license": "MIT",
   "repository": {
     "type": "git",

package/service.js

@@ -621,9 +621,9 @@ function createRustRangeStream(
   };
 
   const drainScheduledRanges = () => {
-    return Promise.allSettled(Array.from(scheduled.values())).then(() => {
-      scheduled.clear();
-    });
+    const pending = Array.from(scheduled.values(), request => request.then(() => {}));
+    scheduled.clear();
+    return Promise.allSettled(pending);
   };
 
   const failStream = async (controller, error) => {

package/weeb_3.d.ts

@@ -4,6 +4,11 @@
 /** Bee-compatible erasure-coding level used for uploads. */
 export type UploadRedundancyLevel = 0 | 1 | 2 | 3 | 4;
 export type HlsStart = "beginning" | "live";
+export interface StreamQuality {
+    levels: { level: number; width: number; height: number; bitrate: number }[];
+    selectedLevel: number;
+    currentLevel: number;
+}
 
 
 
@@ -25,6 +30,7 @@ export class Weeb3No103 {
     attachStream(media: HTMLMediaElement, owner: string, topic: string, start: HlsStart): Promise<void>;
     batchState(depth: number, validity_days: number): Promise<object>;
     buyBatch(depth: number, validity_days: number): Promise<object>;
+    connectionCount(): Promise<number>;
     deployChequebook(): Promise<object>;
     depositChequebook(amount: string): Promise<object>;
     logs(): Promise<Array<any>>;
@@ -48,7 +54,9 @@ export class Weeb3No103 {
     retrieve(address: string): Promise<Array<any>>;
     retrieveBytes(address: string): Promise<Uint8Array>;
     retrieveChunk(address: string): Promise<Uint8Array>;
+    setStreamQuality(media: HTMLMediaElement, level: number): void;
     start(options?: any | null): void;
+    streamQuality(media: HTMLMediaElement): StreamQuality;
     switchNetwork(mode: string): Promise<object>;
     upload(file: File, encryption: boolean, index_string: string, add_to_feed: boolean, feed_topic: string): Promise<object>;
     uploadWithRedundancy(file: File, encryption: boolean, redundancy_level: UploadRedundancyLevel, index_string: string, add_to_feed: boolean, feed_topic: string, wallet_owner?: string | null): Promise<object>;
@@ -75,6 +83,7 @@ export interface InitOutput {
     readonly weeb3no103_attachStream: (a: number, b: any, c: number, d: number, e: number, f: number, g: number, h: number) => any;
     readonly weeb3no103_batchState: (a: number, b: number, c: number) => any;
     readonly weeb3no103_buyBatch: (a: number, b: number, c: number) => any;
+    readonly weeb3no103_connectionCount: (a: number) => any;
     readonly weeb3no103_deployChequebook: (a: number) => any;
     readonly weeb3no103_depositChequebook: (a: number, b: number, c: number) => any;
     readonly weeb3no103_logs: (a: number) => any;
@@ -92,7 +101,9 @@ export interface InitOutput {
     readonly weeb3no103_retrieve: (a: number, b: number, c: number) => any;
     readonly weeb3no103_retrieveBytes: (a: number, b: number, c: number) => any;
     readonly weeb3no103_retrieveChunk: (a: number, b: number, c: number) => any;
+    readonly weeb3no103_setStreamQuality: (a: number, b: any, c: number) => [number, number];
     readonly weeb3no103_start: (a: number, b: number) => void;
+    readonly weeb3no103_streamQuality: (a: number, b: any) => [number, number, number];
     readonly weeb3no103_switchNetwork: (a: number, b: number, c: number) => any;
     readonly weeb3no103_upload: (a: number, b: any, c: number, d: number, e: number, f: number, g: number, h: number) => any;
     readonly weeb3no103_uploadWithRedundancy: (a: number, b: any, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => any;

package/weeb_3.js

@@ -104,6 +104,13 @@ export class Weeb3No103 {
         const ret = wasm.weeb3no103_buyBatch(this.__wbg_ptr, depth, validity_days);
         return ret;
     }
+    /**
+     * @returns {Promise<number>}
+     */
+    connectionCount() {
+        const ret = wasm.weeb3no103_connectionCount(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * @returns {Promise<object>}
      */
@@ -290,12 +297,33 @@ export class Weeb3No103 {
         const ret = wasm.weeb3no103_retrieveChunk(this.__wbg_ptr, ptr0, len0);
         return ret;
     }
+    /**
+     * @param {HTMLMediaElement} media
+     * @param {number} level
+     */
+    setStreamQuality(media, level) {
+        const ret = wasm.weeb3no103_setStreamQuality(this.__wbg_ptr, media, level);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * @param {any | null} [options]
      */
     start(options) {
         wasm.weeb3no103_start(this.__wbg_ptr, isLikeNone(options) ? 0 : addToExternrefTable0(options));
     }
+    /**
+     * @param {HTMLMediaElement} media
+     * @returns {StreamQuality}
+     */
+    streamQuality(media) {
+        const ret = wasm.weeb3no103_streamQuality(this.__wbg_ptr, media);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * @param {string} mode
      * @returns {Promise<object>}
@@ -523,7 +551,7 @@ function __wbg_get_imports() {
             const ret = Object.assign(arg0, arg1);
             return ret;
         },
-        __wbg_attachMedia_82d779df2fa8e98f: function() { return handleError(function (arg0, arg1) {
+        __wbg_attachMedia_ff18e7736d1de028: function() { return handleError(function (arg0, arg1) {
             arg0.attachMedia(arg1);
         }, arguments); },
         __wbg_autoplay_f8612a2035bfaa92: function(arg0) {
@@ -663,6 +691,10 @@ function __wbg_get_imports() {
         __wbg_detachMedia_2925e924ea346816: function() { return handleError(function (arg0) {
             arg0.detachMedia();
         }, arguments); },
+        __wbg_disabled_462f1ecf16417bb3: function(arg0) {
+            const ret = arg0.disabled;
+            return ret;
+        },
         __wbg_document_ee35a3d3ae34ef6c: function(arg0) {
             const ret = arg0.document;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
@@ -1713,6 +1745,10 @@ function __wbg_get_imports() {
             const ret = arg0.transaction;
             return ret;
         },
+        __wbg_transferMedia_1de6dcda4eba6934: function() { return handleError(function (arg0) {
+            const ret = arg0.transferMedia();
+            return ret;
+        }, arguments); },
         __wbg_type_4edffca24c42b74d: function(arg0, arg1) {
             const ret = arg1.type;
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -1757,37 +1793,37 @@ function __wbg_get_imports() {
             console.warn(arg0);
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 3, function: Function { arguments: [Externref, Externref], shim_idx: 4, ret: Unit, inner_ret: Some(Unit) }, mutable: false }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 2, function: Function { arguments: [Externref, Externref], shim_idx: 3, ret: Unit, inner_ret: Some(Unit) }, mutable: false }) -> Externref`.
             const ret = makeClosure(arg0, arg1, wasm.wasm_bindgen_2fc1ddd1063c2c6b___closure__destroy___dyn_core_ed718c3d60ebd546___ops__function__Fn__wasm_bindgen_2fc1ddd1063c2c6b___JsValue__wasm_bindgen_2fc1ddd1063c2c6b___JsValue___Output_______, wasm_bindgen_2fc1ddd1063c2c6b___convert__closures_____invoke___wasm_bindgen_2fc1ddd1063c2c6b___JsValue__wasm_bindgen_2fc1ddd1063c2c6b___JsValue_____);
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 3, function: Function { arguments: [Externref, String], shim_idx: 34, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: false }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 2, function: Function { arguments: [Externref, String], shim_idx: 34, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: false }) -> Externref`.
             const ret = makeClosure(arg0, arg1, wasm.wasm_bindgen_2fc1ddd1063c2c6b___closure__destroy___dyn_core_ed718c3d60ebd546___ops__function__Fn__wasm_bindgen_2fc1ddd1063c2c6b___JsValue__wasm_bindgen_2fc1ddd1063c2c6b___JsValue___Output_______, wasm_bindgen_2fc1ddd1063c2c6b___convert__closures_____invoke___wasm_bindgen_2fc1ddd1063c2c6b___JsValue__alloc_508e33bd5656020b___string__String__core_ed718c3d60ebd546___result__Result_____wasm_bindgen_2fc1ddd1063c2c6b___JsValue__);
             return ret;
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 3, function: Function { arguments: [NamedExternref("IDBVersionChangeEvent")], shim_idx: 38, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 2, function: Function { arguments: [NamedExternref("IDBVersionChangeEvent")], shim_idx: 38, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_2fc1ddd1063c2c6b___closure__destroy___dyn_core_ed718c3d60ebd546___ops__function__Fn__wasm_bindgen_2fc1ddd1063c2c6b___JsValue__wasm_bindgen_2fc1ddd1063c2c6b___JsValue___Output_______, wasm_bindgen_2fc1ddd1063c2c6b___convert__closures_____invoke___web_sys_672975c58fd3dbc7___features__gen_IdbVersionChangeEvent__IdbVersionChangeEvent__core_ed718c3d60ebd546___result__Result_____wasm_bindgen_2fc1ddd1063c2c6b___JsValue__);
             return ret;
         },
         __wbindgen_cast_0000000000000004: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 3, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 36, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 2, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 36, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_2fc1ddd1063c2c6b___closure__destroy___dyn_core_ed718c3d60ebd546___ops__function__Fn__wasm_bindgen_2fc1ddd1063c2c6b___JsValue__wasm_bindgen_2fc1ddd1063c2c6b___JsValue___Output_______, wasm_bindgen_2fc1ddd1063c2c6b___convert__closures_____invoke___web_sys_672975c58fd3dbc7___features__gen_MessageEvent__MessageEvent_____);
             return ret;
         },
         __wbindgen_cast_0000000000000005: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 6, function: Function { arguments: [Externref], shim_idx: 7, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 5, function: Function { arguments: [Externref], shim_idx: 6, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_2fc1ddd1063c2c6b___closure__destroy___dyn_core_ed718c3d60ebd546___ops__function__FnMut__wasm_bindgen_2fc1ddd1063c2c6b___JsValue____Output_______, wasm_bindgen_2fc1ddd1063c2c6b___convert__closures_____invoke___wasm_bindgen_2fc1ddd1063c2c6b___JsValue_____);
             return ret;
         },
         __wbindgen_cast_0000000000000006: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 6, function: Function { arguments: [NamedExternref("Event")], shim_idx: 7, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 5, function: Function { arguments: [NamedExternref("Event")], shim_idx: 6, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_2fc1ddd1063c2c6b___closure__destroy___dyn_core_ed718c3d60ebd546___ops__function__FnMut__wasm_bindgen_2fc1ddd1063c2c6b___JsValue____Output_______, wasm_bindgen_2fc1ddd1063c2c6b___convert__closures_____invoke___wasm_bindgen_2fc1ddd1063c2c6b___JsValue_____);
             return ret;
         },
         __wbindgen_cast_0000000000000007: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 6, function: Function { arguments: [], shim_idx: 97, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 5, function: Function { arguments: [], shim_idx: 97, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_2fc1ddd1063c2c6b___closure__destroy___dyn_core_ed718c3d60ebd546___ops__function__FnMut__wasm_bindgen_2fc1ddd1063c2c6b___JsValue____Output_______, wasm_bindgen_2fc1ddd1063c2c6b___convert__closures_____invoke______);
             return ret;
         },

package/weeb_3_bg.wasm.d.ts

@@ -8,6 +8,7 @@ export const weeb3no103_acquireFeedBytes: (a: number, b: number, c: number, d: n
 export const weeb3no103_attachStream: (a: number, b: any, c: number, d: number, e: number, f: number, g: number, h: number) => any;
 export const weeb3no103_batchState: (a: number, b: number, c: number) => any;
 export const weeb3no103_buyBatch: (a: number, b: number, c: number) => any;
+export const weeb3no103_connectionCount: (a: number) => any;
 export const weeb3no103_deployChequebook: (a: number) => any;
 export const weeb3no103_depositChequebook: (a: number, b: number, c: number) => any;
 export const weeb3no103_logs: (a: number) => any;
@@ -25,7 +26,9 @@ export const weeb3no103_resetStamp: (a: number) => any;
 export const weeb3no103_retrieve: (a: number, b: number, c: number) => any;
 export const weeb3no103_retrieveBytes: (a: number, b: number, c: number) => any;
 export const weeb3no103_retrieveChunk: (a: number, b: number, c: number) => any;
+export const weeb3no103_setStreamQuality: (a: number, b: any, c: number) => [number, number];
 export const weeb3no103_start: (a: number, b: number) => void;
+export const weeb3no103_streamQuality: (a: number, b: any) => [number, number, number];
 export const weeb3no103_switchNetwork: (a: number, b: number, c: number) => any;
 export const weeb3no103_upload: (a: number, b: any, c: number, d: number, e: number, f: number, g: number, h: number) => any;
 export const weeb3no103_uploadWithRedundancy: (a: number, b: any, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => any;