@intomind/sdk 0.0.0-stage → 1.4.1

package/LICENSING.md

@@ -0,0 +1,45 @@
+# Licensing
+
+This project is free software under the GNU Affero General Public License,
+version 3. The full text is in `LICENSE`. It covers the code in this
+repository.
+
+A commercial license is also available. The two are alternatives: use
+either one.
+
+## What the Affero license asks of you
+
+You may use, study, change, and share this software. If you share it, or
+a work based on it, you pass on the same freedoms and the source. The
+Affero clause adds one thing to the ordinary General Public License: if
+you run a modified version as a network service, the people using that
+service can ask you for its source.
+
+Building your own product on top of these libraries is what they are for.
+Running them, recording with them, and publishing what you make with them
+are not affected at all. The license is about the software, never about
+the data you record with it.
+
+## When you want the commercial license instead
+
+Take the commercial license when you want to build a closed product on
+this code, or run a modified service without publishing your changes.
+Write to contact@intomind.com.
+
+IntoMind can offer both because IntoMind holds the copyright in the
+code, which is also why contributions are covered by the agreement in
+`CONTRIBUTING.md`.
+
+## Contributions
+
+The first time you contribute, you sign a contributor license agreement.
+It says you wrote what you are contributing and that you give IntoMind
+the rights to use it under both licenses, while you keep the copyright
+in your own work. `CONTRIBUTING.md` has the detail and the process.
+
+## Trademarks
+
+IntoMind is a trademark of IntoMind, Inc. The license covers the code,
+not the name. You may say your product works with an IntoMind device.
+You may not call your product IntoMind or use the mark in a way that
+suggests IntoMind made or endorsed it.

package/README.md

@@ -1,3 +1,148 @@
-# Temporary Holding Version
+# @intomind/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The IntoMind instrument client for JavaScript. One package, every IntoMind
+device, in a browser and in Node.
+
+```ts
+import { requestAndConnect } from "@intomind/sdk";
+
+const device = await requestAndConnect({
+  onEvent(event) {
+    if (event.type === "samples") plot(event.batch);
+    if (event.type === "gap") mark(event.gap);
+  },
+});
+await device.send(device.session.startStream());
+```
+
+It owns the protocol spoken to a device, the session that turns
+notifications into events, the clock that puts those events on the host's
+timeline, and one transport for the browser. It knows nothing about any
+particular device beyond what that device tells it, and nothing about any
+application built on top of it.
+
+## What is in here
+
+| | |
+|---|---|
+| `src/protocol.ts` | the wire, and nothing else |
+| `src/session.ts` | one device as a state machine: bytes in, events out |
+| `src/timebase.ts` | device time onto host time, and what it refuses to believe |
+| `src/web-bluetooth.ts` | the browser transport, and the only file that touches a radio |
+| `src/index.ts` | the public surface |
+
+The protocol, the session, and the timebase do no input and no output.
+They take bytes that arrived and hand back bytes to send, so they run over
+whatever Bluetooth stack you already have, on whatever runtime you already
+use, and they can be tested without either.
+
+```ts
+import { Session, protocol } from "@intomind/sdk";
+
+const session = new Session();
+session.onDeviceInfo(await readDeviceInfoSomehow());
+for (const event of session.onNotification(protocol.FILL.EEG_DATA, notification)) {
+  // ...
+}
+```
+
+## Capabilities are the device's answer, never this package's assumption
+
+A device declares what it is over the protocol, and everything follows
+from that declaration. The channel count, the converter's resolution and
+reference, the rates it offers, whether it can detect lead-off, whether it
+carries a model: all of it is asked and none of it is assumed.
+
+```ts
+session.requireInfo().channels   // what the device said
+session.can("model")             // a capability bit, not a version number
+session.setLeadoff(true)         // throws NotCapable if the device never claimed it
+```
+
+A table of specific hardware in this package is a defect. A capability the
+device does not claim is not asked for, and asking anyway throws rather
+than putting a byte on the wire the device will refuse.
+
+## The timeline is never silently repaired
+
+Every sample carries the device's own index and the device time of its own
+conversion. A forward step in that index is a loss with an exact count. A
+step that is not forward is a break whose extent is not a number, and this
+package says so rather than returning a count that would be a fiction.
+
+```ts
+if (event.type === "gap") {
+  event.gap.samplesLost;   // a number, or null for a break
+}
+```
+
+A gap is emitted before the samples that follow it, so a caller writing
+samples down writes the gap down first. Nothing splices.
+
+## The contract is tested, not assumed
+
+`contract/conformance.json` is emitted by the firmware from the codec the
+device itself runs. Every message this package decodes, it decodes to the
+fields that file states, and every malformed one it refuses for the reason
+that file states: truncated, invalid, or reserved, which are three
+different errors because the contract treats them as three different
+things.
+
+```
+npm test
+```
+
+No device, no network, no build step. That is the command, and there is no
+other. It needs Node 22.18 or newer, which runs the TypeScript as it is
+written. `npm run build` produces the JavaScript that is published, which
+runs on Node 20 and in any current browser.
+
+## Time
+
+A device's clock is a different crystal from the host's. The fit between
+them is a line, and one exchange cannot tell a clock difference from a slow
+answer, so one exchange fixes an offset and claims no rate. A skew beyond a
+thousand parts per million, or a slope whose standard error is worse than a
+hundred parts per million, is refused rather than believed. The offset is
+kept, because the offset is the part that was measured.
+
+```ts
+await device.timeSync();
+device.session.timebase?.fit;            // skewUsed says whether the rate is real
+device.session.hostTime(batch.deviceTime);
+```
+
+## The model
+
+A device can carry an encoder that turns a window of signal into an
+embedding, and a head that turns that embedding into a few outputs. A head
+is weights, never code.
+
+```ts
+import { buildHead, quantizeEmbedding, evaluateHead, decodeHead } from "@intomind/sdk";
+
+const blob = buildHead(weights, bias, scale, { name: "focus" });
+evaluateHead(decodeHead(blob), quantizeEmbedding(embedding));
+```
+
+The embedding is quantized to a fixed scale that is part of the contract,
+so what a head produces on a host is what it produces on the device,
+because the device evaluates exactly those integers.
+
+## The browser
+
+`web-bluetooth.ts` is the only file that reaches `navigator.bluetooth`.
+Web Bluetooth needs a secure context and a user gesture, so
+`requestDevice` has to be called from a click. Everything else in this
+package works with no browser at all, which is how the tests run.
+
+## License
+
+Free software under the GNU Affero General Public License, version 3. A
+commercial license is available for building a closed product on this code
+or running a modified service without publishing the changes. Write to
+contact@intomind.com. See `LICENSING.md`, and `CONTRIBUTING.md` before a
+first pull request.
+
+IntoMind is a trademark of IntoMind, Inc. The license covers the code, not
+the name.

package/dist/digest.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The two digests the contract names, both synchronous.
+ *
+ * The update service reports a CRC-32 over the bytes it has accepted, and a
+ * head blob carries a SHA-256 of everything before it. Both are computed
+ * here rather than through a platform interface because `crypto.subtle` is
+ * asynchronous in a browser and the codec is not, and because a decoder that
+ * has to await a digest cannot refuse a bad blob where it reads it.
+ */
+/** Running CRC-32, for a transfer that arrives in pieces. */
+export declare class Crc32 {
+    private state;
+    /** Fold more bytes into the running checksum, and return this so calls chain. */
+    update(data: Uint8Array): this;
+    /** The checksum over every slice folded in so far. */
+    finish(): number;
+}
+/** CRC-32 of one slice. */
+export declare function crc32(data: Uint8Array): number;
+/** SHA-256 of one slice, as thirty two bytes. */
+export declare function sha256(data: Uint8Array): Uint8Array;
+//# sourceMappingURL=digest.d.ts.map

package/dist/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../src/digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,6DAA6D;AAC7D,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAAc;IAE3B,iFAAiF;IACjF,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAW9B,sDAAsD;IACtD,MAAM,IAAI,MAAM;CAGjB;AAED,2BAA2B;AAC3B,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAE9C;AAaD,iDAAiD;AACjD,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CA+CnD"}

package/dist/digest.js

@@ -0,0 +1,109 @@
+/**
+ * The two digests the contract names, both synchronous.
+ *
+ * The update service reports a CRC-32 over the bytes it has accepted, and a
+ * head blob carries a SHA-256 of everything before it. Both are computed
+ * here rather than through a platform interface because `crypto.subtle` is
+ * asynchronous in a browser and the codec is not, and because a decoder that
+ * has to await a digest cannot refuse a bad blob where it reads it.
+ */
+// CRC-32, IEEE 802.3, the same polynomial zlib uses. Four bits at a time,
+// which keeps the table at sixteen entries.
+const CRC_POLY = 0xedb88320;
+const CRC_TABLE = (() => {
+    const t = new Uint32Array(16);
+    for (let i = 0; i < 16; i++) {
+        let c = i;
+        for (let k = 0; k < 4; k++)
+            c = c & 1 ? (CRC_POLY ^ (c >>> 1)) >>> 0 : c >>> 1;
+        t[i] = c;
+    }
+    return t;
+})();
+/** Running CRC-32, for a transfer that arrives in pieces. */
+export class Crc32 {
+    state = 0xffffffff;
+    /** Fold more bytes into the running checksum, and return this so calls chain. */
+    update(data) {
+        let c = this.state;
+        for (let i = 0; i < data.length; i++) {
+            c = (c ^ data[i]) >>> 0;
+            c = (CRC_TABLE[c & 0xf] ^ (c >>> 4)) >>> 0;
+            c = (CRC_TABLE[c & 0xf] ^ (c >>> 4)) >>> 0;
+        }
+        this.state = c;
+        return this;
+    }
+    /** The checksum over every slice folded in so far. */
+    finish() {
+        return (this.state ^ 0xffffffff) >>> 0;
+    }
+}
+/** CRC-32 of one slice. */
+export function crc32(data) {
+    return new Crc32().update(data).finish();
+}
+const K = new Uint32Array([
+    0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,
+    0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,
+    0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
+    0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,
+    0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,
+    0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
+    0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
+    0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2,
+]);
+/** SHA-256 of one slice, as thirty two bytes. */
+export function sha256(data) {
+    const h = new Uint32Array([
+        0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19,
+    ]);
+    // Message, a one bit, zeros, then the length in bits as a 64 bit count.
+    const bitLength = BigInt(data.length) * 8n;
+    const padded = new Uint8Array(((data.length + 9 + 63) >> 6) << 6);
+    padded.set(data);
+    padded[data.length] = 0x80;
+    new DataView(padded.buffer).setBigUint64(padded.length - 8, bitLength, false);
+    const w = new Uint32Array(64);
+    const block = new DataView(padded.buffer);
+    for (let at = 0; at < padded.length; at += 64) {
+        for (let i = 0; i < 16; i++)
+            w[i] = block.getUint32(at + i * 4, false);
+        for (let i = 16; i < 64; i++) {
+            const a = w[i - 15];
+            const b = w[i - 2];
+            const s0 = (rotr(a, 7) ^ rotr(a, 18) ^ (a >>> 3)) >>> 0;
+            const s1 = (rotr(b, 17) ^ rotr(b, 19) ^ (b >>> 10)) >>> 0;
+            w[i] = (w[i - 16] + s0 + w[i - 7] + s1) >>> 0;
+        }
+        let [a, b, c, d, e, f, g, hh] = h;
+        for (let i = 0; i < 64; i++) {
+            const s1 = (rotr(e, 6) ^ rotr(e, 11) ^ rotr(e, 25)) >>> 0;
+            const ch = ((e & f) ^ (~e & g)) >>> 0;
+            const t1 = (hh + s1 + ch + K[i] + w[i]) >>> 0;
+            const s0 = (rotr(a, 2) ^ rotr(a, 13) ^ rotr(a, 22)) >>> 0;
+            const maj = ((a & b) ^ (a & c) ^ (b & c)) >>> 0;
+            const t2 = (s0 + maj) >>> 0;
+            hh = g;
+            g = f;
+            f = e;
+            e = (d + t1) >>> 0;
+            d = c;
+            c = b;
+            b = a;
+            a = (t1 + t2) >>> 0;
+        }
+        const round = [a, b, c, d, e, f, g, hh];
+        for (let i = 0; i < 8; i++)
+            h[i] = (h[i] + round[i]) >>> 0;
+    }
+    const out = new Uint8Array(32);
+    const view = new DataView(out.buffer);
+    for (let i = 0; i < 8; i++)
+        view.setUint32(i * 4, h[i], false);
+    return out;
+}
+function rotr(x, n) {
+    return ((x >>> n) | (x << (32 - n))) >>> 0;
+}
+//# sourceMappingURL=digest.js.map

package/dist/digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.js","sourceRoot":"","sources":["../src/digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0EAA0E;AAC1E,4CAA4C;AAC5C,MAAM,QAAQ,GAAG,UAAU,CAAC;AAE5B,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE;IACtB,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC,EAAE,CAAC;AAEL,6DAA6D;AAC7D,MAAM,OAAO,KAAK;IACR,KAAK,GAAG,UAAU,CAAC;IAE3B,iFAAiF;IACjF,MAAM,CAAC,IAAgB;QACrB,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,GAAG,CAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC5C,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,GAAG,CAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sDAAsD;IACtD,MAAM;QACJ,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;CACF;AAED,2BAA2B;AAC3B,MAAM,UAAU,KAAK,CAAC,IAAgB;IACpC,OAAO,IAAI,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC;IACxB,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;IAC9F,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;IAC9F,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;IAC9F,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;IAC9F,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;IAC9F,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;IAC9F,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;IAC9F,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;CAC/F,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,UAAU,MAAM,CAAC,IAAgB;IACrC,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC;QACxB,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;KAC/F,CAAC,CAAC;IACH,wEAAwE;IACxE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC3B,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAE9E,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;YAAE,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QACvE,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YACpB,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxD,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAC1D,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAwB,CAAC;QACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAC7D,MAAM,EAAE,GAAG,CAAC,CAAC,CAAE,GAAG,CAAE,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,CAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAC1C,MAAM,EAAE,GAAG,CAAC,EAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC;YACjD,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAC7D,MAAM,GAAG,GAAG,CAAC,CAAC,CAAE,GAAG,CAAE,CAAC,GAAG,CAAC,CAAE,GAAG,CAAE,CAAC,GAAG,CAAC,CAAE,GAAG,CAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YACtD,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;YAC5B,EAAE,GAAG,CAAC,CAAC;YACP,CAAC,GAAG,CAAC,CAAC;YACN,CAAC,GAAG,CAAC,CAAC;YACN,CAAC,GAAG,CAAC,CAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC,GAAG,CAAC,CAAC;YACN,CAAC,GAAG,CAAC,CAAC;YACN,CAAC,GAAG,CAAC,CAAC;YACN,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,CAAE,EAAE,CAAE,EAAE,CAAE,EAAE,CAAE,EAAE,CAAE,EAAE,CAAE,EAAE,CAAE,EAAE,EAAG,CAAC,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,KAAK,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,IAAI,CAAC,CAAS,EAAE,CAAS;IAChC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The IntoMind instrument client, for a browser and for Node.
+ *
+ * The protocol, the session, and the timebase do no input and no output.
+ * They are handed bytes that arrived and they hand back bytes to send,
+ * which means they work over whatever Bluetooth stack you already have and
+ * can be tested without one. `web-bluetooth.ts` is the browser transport,
+ * and it is the only file in this package that touches a radio.
+ *
+ * ```ts
+ * import { requestAndConnect } from "@intomind/sdk";
+ *
+ * const device = await requestAndConnect({
+ *   onEvent(event) {
+ *     if (event.type === "samples") write(event.batch);
+ *     // Written down, never smoothed over.
+ *     if (event.type === "gap") writeGap(event.gap);
+ *   },
+ * });
+ * await device.send(device.session.startStream());
+ * ```
+ *
+ * What a device can do is what the device says it can do. Nothing here
+ * holds a table of hardware, and a capability is a bit the device reports
+ * rather than a version number this package compares against.
+ */
+export * as protocol from "./protocol.ts";
+export { CAPABILITIES, CAPABILITIES_HIGH, DeviceInfo, EMBED_SCALE, FILL, GAIN_BY_CODE, Invalid, MODES, NAME_MAX_COMPOSED, NAME_PREFIX, NO_ENCODER_ID, OPCODES, PRODUCT_NAME, ProtocolError, RATE_BY_CODE, Reserved, SERVICE, Truncated, VERSION, buildHead, composeName, continuity, decodeHead, decodeModelInterval, decodeNameParts, decodePacket, displayNames, evaluateHead, microvolts, nameFits, quantizeEmbedding, uuid, } from "./protocol.ts";
+export type { CapabilityHighName, CapabilityName, Continuity, ModeName, ModelInterval, Envelope, HeadBlob, HeadEntry, OpcodeName, Packet, Prediction, Refusal, Request, Response, Status, UpdateResponse, } from "./protocol.ts";
+export { Batch, NoDeviceInfo, NotCapable, Session, SessionError } from "./session.ts";
+export type { Command, Event, Gap } from "./session.ts";
+export { Exchange, MAX_SKEW_PPM, MAX_SKEW_STDERR_PPM, Timebase } from "./timebase.ts";
+export type { Fit } from "./timebase.ts";
+export { ChecksumMismatch, OffsetMismatch, Refused, Rejected, Transfer, TransferError, Unexpected, activate, } from "./transfer.ts";
+export type { Step } from "./transfer.ts";
+export { Connection, NoBluetooth, connect, hostClock, requestAndConnect, requestDevice } from "./web-bluetooth.ts";
+export type { ConnectOptions, RequestOptions } from "./web-bluetooth.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAE1C,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,IAAI,EACJ,YAAY,EACZ,OAAO,EACP,KAAK,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,OAAO,EACP,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,SAAS,EACT,OAAO,EACP,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,IAAI,GACL,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,MAAM,EACN,UAAU,EACV,OAAO,EACP,OAAO,EACP,QAAQ,EACR,MAAM,EACN,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACtF,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACtF,YAAY,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnH,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,33 @@
+/**
+ * The IntoMind instrument client, for a browser and for Node.
+ *
+ * The protocol, the session, and the timebase do no input and no output.
+ * They are handed bytes that arrived and they hand back bytes to send,
+ * which means they work over whatever Bluetooth stack you already have and
+ * can be tested without one. `web-bluetooth.ts` is the browser transport,
+ * and it is the only file in this package that touches a radio.
+ *
+ * ```ts
+ * import { requestAndConnect } from "@intomind/sdk";
+ *
+ * const device = await requestAndConnect({
+ *   onEvent(event) {
+ *     if (event.type === "samples") write(event.batch);
+ *     // Written down, never smoothed over.
+ *     if (event.type === "gap") writeGap(event.gap);
+ *   },
+ * });
+ * await device.send(device.session.startStream());
+ * ```
+ *
+ * What a device can do is what the device says it can do. Nothing here
+ * holds a table of hardware, and a capability is a bit the device reports
+ * rather than a version number this package compares against.
+ */
+export * as protocol from "./protocol.js";
+export { CAPABILITIES, CAPABILITIES_HIGH, DeviceInfo, EMBED_SCALE, FILL, GAIN_BY_CODE, Invalid, MODES, NAME_MAX_COMPOSED, NAME_PREFIX, NO_ENCODER_ID, OPCODES, PRODUCT_NAME, ProtocolError, RATE_BY_CODE, Reserved, SERVICE, Truncated, VERSION, buildHead, composeName, continuity, decodeHead, decodeModelInterval, decodeNameParts, decodePacket, displayNames, evaluateHead, microvolts, nameFits, quantizeEmbedding, uuid, } from "./protocol.js";
+export { Batch, NoDeviceInfo, NotCapable, Session, SessionError } from "./session.js";
+export { Exchange, MAX_SKEW_PPM, MAX_SKEW_STDERR_PPM, Timebase } from "./timebase.js";
+export { ChecksumMismatch, OffsetMismatch, Refused, Rejected, Transfer, TransferError, Unexpected, activate, } from "./transfer.js";
+export { Connection, NoBluetooth, connect, hostClock, requestAndConnect, requestDevice } from "./web-bluetooth.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAE1C,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,IAAI,EACJ,YAAY,EACZ,OAAO,EACP,KAAK,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,OAAO,EACP,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,SAAS,EACT,OAAO,EACP,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,IAAI,GACL,MAAM,eAAe,CAAC;AAqBvB,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGtF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGtF,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}