@bridgething/browser 0.11.0 → 0.12.0

package/README.md

@@ -1,50 +1,40 @@
 # @bridgething/browser
 
-Drive a [bridgething](https://github.com/JoeyEamigh/bridgething) Spotify Car Thing
-from a web page: install and switch webapps, push daemon and image updates, rename
-the device.
+Drive a [bridgething](https://github.com/JoeyEamigh/bridgething) Spotify Car
+Thing from a web page: install and switch webapps, push updates, rename the
+device.
 
 ```sh
 bun add @bridgething/browser
 ```
 
-## Connecting
-
 ```ts
 import { Device } from '@bridgething/browser';
 
-// over the usb-c cable, via the daemon's network gateway
+// the daemon's network gateway, over usb or the local network
 const device = await Device.overNetwork('bridgething.local');
 
-// or over an already-paired bluetooth peer, via Web Serial
+// a paired bluetooth peer, over Web Serial
 const device = await Device.overSerial();
 ```
 
-`overSerial()` resolves null when the user dismisses the chooser. Use
-`serialAvailable()` to decide whether to offer it at all; iOS Safari and Firefox
-have no Web Serial.
-
-## Driving a device
+`overSerial` resolves null when the user dismisses the port chooser. Web Serial
+is Chromium-only; check `serialAvailable()` before offering it.
 
 ```ts
-const meta = await device.meta();
 const webapps = await device.webapps();
-
 await device.switchWebapp(webapps[0].id);
-await device.installWebapp(
-  new Uint8Array(await bundle.arrayBuffer()),
-  catalogUrl,
-);
+await device.installWebapp(bytes, 'https://apps.example.com/weather.zip');
 await device.setNickname('the dashboard');
-```
 
-Updates are a push plus a feed:
-
-```ts
 const phase = await device.push('daemon', binary);
 if (phase.kind === 'failed') console.error(phase.reason);
 ```
 
-Manifest helpers - `fetchManifest`, `compositeVersion`, `otaArtifactUrls` - read
-the same discover manifest the device does, so a page can work out what a device
-should be running.
+`installWebapp` records the second argument as the install's source.
+`nextEvent` reads the progress feed during a push. `fetchManifest`,
+`compositeVersion`, and `otaArtifactUrls` read the release manifest the device
+reads.
+
+- Docs: <https://bridgething.com/docs>
+- Source: <https://github.com/JoeyEamigh/bridgething>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridgething/browser",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Drive a Spotify Car Thing from the browser: the bridgething delivery core compiled to wasm, plus the Web Serial and network transports.",
   "license": "MIT",
   "author": "Joey Eamigh <55670930+JoeyEamigh@users.noreply.github.com> (https://github.com/JoeyEamigh)",
@@ -46,7 +46,7 @@
     "lint": "eslint ."
   },
   "dependencies": {
-    "@bridgething/lib": "0.11.0"
+    "@bridgething/lib": "0.12.0"
   },
   "peerDependencies": {
     "typescript": "^6.0.3"

package/wasm/core-wasm.d.ts

@@ -185,13 +185,13 @@ export interface InitOutput {
     readonly discoverManifest: (a: number, b: number) => number;
     readonly init: () => void;
     readonly parseCompositeVersion: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_6457: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_6459: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_4191: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_4191_2: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_4191_3: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_4673: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_5178: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_6600: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_6602: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_3582: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_3582_2: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_3582_3: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_4798: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_5319: (a: number, b: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;

package/wasm/core-wasm.js

@@ -541,7 +541,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_6459(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_6602(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -597,7 +597,7 @@ function __wbg_get_imports() {
         __wbg_send_a321b376d40ec867: function() { return handleError(function (arg0, arg1, arg2) {
             getObject(arg0).send(getArrayU8FromWasm0(arg1, arg2));
         }, arguments); },
-        __wbg_setTimeout_3dfd69fc65d92241: function(arg0, arg1) {
+        __wbg_setTimeout_e568cd0fc257b420: function(arg0, arg1) {
             setTimeout(getObject(arg0), arg1);
         },
         __wbg_set_0de9c62c23d04ad5: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
@@ -684,33 +684,33 @@ function __wbg_get_imports() {
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 989, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_6457);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 1006, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_6600);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("CloseEvent")], shim_idx: 808, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_4191);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("CloseEvent")], shim_idx: 789, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3582);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("Event")], shim_idx: 808, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_4191_2);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("Event")], shim_idx: 789, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3582_2);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000004: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 808, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_4191_3);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 789, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3582_3);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000005: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 818, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_4673);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 830, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_4798);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000006: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 906, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_5178);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 923, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_5319);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000007: function(arg0) {
@@ -742,30 +742,30 @@ function __wbg_get_imports() {
     };
 }
 
-function __wasm_bindgen_func_elem_4673(arg0, arg1) {
-    wasm.__wasm_bindgen_func_elem_4673(arg0, arg1);
+function __wasm_bindgen_func_elem_4798(arg0, arg1) {
+    wasm.__wasm_bindgen_func_elem_4798(arg0, arg1);
 }
 
-function __wasm_bindgen_func_elem_5178(arg0, arg1) {
-    wasm.__wasm_bindgen_func_elem_5178(arg0, arg1);
+function __wasm_bindgen_func_elem_5319(arg0, arg1) {
+    wasm.__wasm_bindgen_func_elem_5319(arg0, arg1);
 }
 
-function __wasm_bindgen_func_elem_4191(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_4191(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_3582(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_3582(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_4191_2(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_4191_2(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_3582_2(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_3582_2(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_4191_3(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_4191_3(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_3582_3(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_3582_3(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_6457(arg0, arg1, arg2) {
+function __wasm_bindgen_func_elem_6600(arg0, arg1, arg2) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.__wasm_bindgen_func_elem_6457(retptr, arg0, arg1, addHeapObject(arg2));
+        wasm.__wasm_bindgen_func_elem_6600(retptr, arg0, arg1, addHeapObject(arg2));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         if (r1) {
@@ -776,8 +776,8 @@ function __wasm_bindgen_func_elem_6457(arg0, arg1, arg2) {
     }
 }
 
-function __wasm_bindgen_func_elem_6459(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_6459(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_6602(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_6602(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 
 

package/wasm/core-wasm_bg.wasm.d.ts

@@ -26,13 +26,13 @@ export const deliverysession_webapps: (a: number) => number;
 export const discoverManifest: (a: number, b: number) => number;
 export const init: () => void;
 export const parseCompositeVersion: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_6457: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_6459: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_4191: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_4191_2: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_4191_3: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_4673: (a: number, b: number) => void;
-export const __wasm_bindgen_func_elem_5178: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_6600: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_6602: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_3582: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_3582_2: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_3582_3: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_4798: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_5319: (a: number, b: number) => void;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_export3: (a: number) => void;