@nestor-home/satellite 0.0.0-stage → 0.2.0

package/dist/i18n.js

@@ -0,0 +1,61 @@
+/**
+ * What a satellite says to people (its device code, a refused enrollment code, why it cannot pair),
+ * in their language. The catalogues are Fluent (`./locales.ts`); English is the fallback.
+ *
+ * The locale comes from the `locale` option, else the platform (`navigator.languages` in browsers
+ * and in Node), else English. Node's CLI reads `LC_ALL`, `LC_MESSAGES` and `LANG` itself.
+ */
+import { FluentBundle, FluentResource } from "@fluent/bundle";
+import { en, fr } from "./locales.js";
+const CATALOGUES = { en, fr };
+export const LOCALES = Object.freeze(Object.keys(CATALOGUES));
+/**
+ * The first supported locale among `requested` (BCP 47 tags such as `fr-FR`, or POSIX ones such as
+ * `fr_FR.UTF-8`), else English.
+ */
+export function negotiateLocale(requested) {
+    for (const tag of requested) {
+        const language = tag
+            ?.trim()
+            .toLowerCase()
+            .split(/[-_.@]/)[0];
+        const found = LOCALES.find((locale) => locale === language);
+        if (found !== undefined)
+            return found;
+    }
+    return "en";
+}
+/** The platform's preferred languages, when it says (browsers, Node 21+). */
+export function platformLanguages() {
+    const navigator = globalThis.navigator;
+    return navigator?.languages ?? (navigator?.language === undefined ? [] : [navigator.language]);
+}
+export class Messages {
+    locale;
+    bundle;
+    fallback;
+    /** `locale`: a tag or a list of preferred tags; by default the platform's languages. */
+    constructor(locale) {
+        const requested = locale === undefined ? platformLanguages() : typeof locale === "string" ? [locale] : locale;
+        this.locale = negotiateLocale(requested);
+        this.bundle = bundle(this.locale);
+        this.fallback = this.locale === "en" ? this.bundle : bundle("en");
+    }
+    /** The sentence `id` with its arguments, in this locale (in English when this locale lacks it). */
+    format(id, args = {}) {
+        for (const source of [this.bundle, this.fallback]) {
+            const message = source.getMessage(id);
+            if (message?.value)
+                return source.formatPattern(message.value, args);
+        }
+        return id;
+    }
+}
+function bundle(locale) {
+    const result = new FluentBundle(locale, { useIsolating: false });
+    const errors = result.addResource(new FluentResource(CATALOGUES[locale]));
+    if (errors.length > 0)
+        throw new Error(`the ${locale} catalogue is broken: ${errors.join("; ")}`);
+    return result;
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Write a Nestor satellite in TypeScript: pair with the core, stream audio over WebRTC, carry out
+ * its intents and report observations, following the `nestor.satellite/1` protocol.
+ *
+ * This entry point runs anywhere (browsers, Node, workers): it touches no platform API until a
+ * `WebRtc` adapter does. Node's adapter, audio and token file live in `@nestor-home/satellite/node`.
+ */
+export type { Body } from "./body.js";
+export { type AudioContextLike, type AudioElementLike, type BrowserWebRtcOptions, browserSpeech, browserWebRtc, type SpeechSynthesisLike, webAudioSpeaker, } from "./browser.js";
+export { DEVICE_CODE, ENROLLMENT_ALPHABET, ENROLLMENT_LENGTH, groupEnrollmentCode, normalizeEnrollmentCode, type PairingUri, parsePairingUri, readEnrollment, } from "./codes.js";
+export { Dispatcher, type Outcome } from "./dispatch.js";
+export { LOCALES, type Locale, type MessageArgs, type MessageId, Messages, negotiateLocale } from "./i18n.js";
+export { type Logger, quietLogger } from "./log.js";
+export { type CodeVoice, type EnrollOutcome, type Fetch, HttpError, type Paired, Pairing, PairingError, type PairingOptions, type PairingOutputs, } from "./pairing.js";
+export { AUDIO_CAPTURE, AUDIO_PLAYBACK, BEHAVIORS, type Behavior, type Capability, capability, Device, type DeviceInit, ENROLLMENT_METHODS, type EnrollmentMethod, EXPRESSION, EXPRESSIONS, type Expression, HEAD_MOTION, IDENTIFY, type JsonValue, MAX_CAPABILITIES, Manifest, type ManifestJson, type ManifestOptions, PAIRING_METHODS, type PairingMethod, PERSON_DETECTION, PROTOCOL, ProtocolError, SDK, type Sdk, SPEECH_ACTIVITY, } from "./protocol.js";
+export { CapabilityNotAllowed, type PairingSetup, pairingMethods, type QrScanner, Satellite, type SatelliteOptions, } from "./satellite.js";
+export { type DeviceState, hashEnrollmentCode, LocalStorageTokenStore, type MaybePromise, MemoryTokenStore, type RefusedCodes, type StorageLike, type TokenStore, } from "./tokens.js";
+export { SDK_NAME, SDK_VERSION } from "./version.js";
+export { AHEAD_MS, announcement, type Clock, clipKey, decodeWav, resample, type Speaker, SpokenCode, type SpokenCodeOptions, type Step, type VoiceIndex, voiceMessages, } from "./voice.js";
+export type { AudioBridge, W3cDataChannel, W3cPeerConnection, W3cPeerConnectionConstructor, W3cTrack, W3cTrackEvent, } from "./w3c.js";
+export { W3cPeer } from "./w3c.js";
+export type { MediaNeeds, Peer, PeerEvents, PeerOptions, SessionDescription, WebRtc } from "./webrtc.js";
+export * as wire from "./wire.js";
+//# 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;;;;;;GAMG;AAEH,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,aAAa,EACb,aAAa,EACb,KAAK,mBAAmB,EACxB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,UAAU,EACf,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC9G,OAAO,EAAE,KAAK,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EACL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,SAAS,EACT,KAAK,MAAM,EACX,OAAO,EACP,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,cAAc,EACd,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,UAAU,EACV,MAAM,EACN,KAAK,UAAU,EACf,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,UAAU,EACV,WAAW,EACX,KAAK,UAAU,EACf,WAAW,EACX,QAAQ,EACR,KAAK,SAAS,EACd,gBAAgB,EAChB,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,eAAe,EACf,KAAK,aAAa,EAClB,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,GAAG,EACH,KAAK,GAAG,EACR,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EACpB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,SAAS,EACd,SAAS,EACT,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,WAAW,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,YAAY,EACjB,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,KAAK,KAAK,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,KAAK,OAAO,EACZ,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,4BAA4B,EAC5B,QAAQ,EACR,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACzG,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * Write a Nestor satellite in TypeScript: pair with the core, stream audio over WebRTC, carry out
+ * its intents and report observations, following the `nestor.satellite/1` protocol.
+ *
+ * This entry point runs anywhere (browsers, Node, workers): it touches no platform API until a
+ * `WebRtc` adapter does. Node's adapter, audio and token file live in `@nestor-home/satellite/node`.
+ */
+export { browserSpeech, browserWebRtc, webAudioSpeaker, } from "./browser.js";
+export { DEVICE_CODE, ENROLLMENT_ALPHABET, ENROLLMENT_LENGTH, groupEnrollmentCode, normalizeEnrollmentCode, parsePairingUri, readEnrollment, } from "./codes.js";
+export { Dispatcher } from "./dispatch.js";
+export { LOCALES, Messages, negotiateLocale } from "./i18n.js";
+export { quietLogger } from "./log.js";
+export { HttpError, Pairing, PairingError, } from "./pairing.js";
+export { AUDIO_CAPTURE, AUDIO_PLAYBACK, BEHAVIORS, capability, Device, ENROLLMENT_METHODS, EXPRESSION, EXPRESSIONS, HEAD_MOTION, IDENTIFY, MAX_CAPABILITIES, Manifest, PAIRING_METHODS, PERSON_DETECTION, PROTOCOL, ProtocolError, SDK, SPEECH_ACTIVITY, } from "./protocol.js";
+export { CapabilityNotAllowed, pairingMethods, Satellite, } from "./satellite.js";
+export { hashEnrollmentCode, LocalStorageTokenStore, MemoryTokenStore, } from "./tokens.js";
+export { SDK_NAME, SDK_VERSION } from "./version.js";
+export { AHEAD_MS, announcement, clipKey, decodeWav, resample, SpokenCode, voiceMessages, } from "./voice.js";
+export { W3cPeer } from "./w3c.js";
+export * as wire from "./wire.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;;;;;;GAMG;AAGH,OAAO,EAIL,aAAa,EACb,aAAa,EAEb,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EAEvB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAgB,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,OAAO,EAAiD,QAAQ,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC9G,OAAO,EAAe,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAIL,SAAS,EAET,OAAO,EACP,YAAY,GAGb,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,cAAc,EACd,SAAS,EAGT,UAAU,EACV,MAAM,EAEN,kBAAkB,EAElB,UAAU,EACV,WAAW,EAEX,WAAW,EACX,QAAQ,EAER,gBAAgB,EAChB,QAAQ,EAGR,eAAe,EAEf,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,GAAG,EAEH,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EAEpB,cAAc,EAEd,SAAS,GAEV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,kBAAkB,EAClB,sBAAsB,EAEtB,gBAAgB,GAIjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACL,QAAQ,EACR,YAAY,EAEZ,OAAO,EACP,SAAS,EACT,QAAQ,EAER,UAAU,EAIV,aAAa,GACd,MAAM,YAAY,CAAC;AASpB,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC"}

package/dist/locales.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The SDK's Fluent catalogues (https://projectfluent.org): every sentence a person may read or hear
+ * from a satellite. Kept as strings so the catalogue ships in every bundle, with no file to load.
+ * `test/i18n.test.ts` checks that every locale has every message.
+ */
+export declare const en = "\ndevice-code-log = Pairing code: { $code }. Type it in Nestor to add this device.\ndevice-code-display = Type this code in Nestor to add this device.\n# The bundled voice has a clip for each piece of text around the digits (nestor-satellite-python's\n# scripts/voice.py records them): record them again after changing this sentence.\ndevice-code-speech = Pairing code: { $digits }. I repeat: { $digits }.\nheadless-hint = This device has no screen and no voice, so the easiest way to pair it is an enrollment code. Add a satellite in Nestor, then set NESTOR_PAIRING_URI.\nenrollment-sent = Sending the enrollment code { $code } to Nestor.\nenrollment-refused = { $reason ->\n    [expired] The enrollment code { $code } has expired.\n    [used] The enrollment code { $code } was already used.\n    [cancelled] The enrollment code { $code } was cancelled.\n   *[unknown] Nestor does not know the enrollment code { $code }.\n}\nenrollment-fallback = Asking for a pairing code instead.\nenrollment-already-refused = The enrollment code { $code } was already refused. Make a new one in Nestor.\nenrollment-invalid = This is not an enrollment code. One has 8 letters and digits, like K7QF-2M9X.\nenrollment-not-pending = This device no longer waits for an enrollment code.\npaired = Paired with Nestor.\npairing-expired = The pairing code expired. Asking for a new one.\nidentify = Nestor asks this device to show itself.\ntoo-many-attempts = Too many wrong codes were tried. Trying again in { $seconds } s.\ntoo-many-pending = Too many devices are waiting to be paired. Trying again in { $seconds } s.\nprotocol-unsupported = This Nestor speaks another version of the satellite protocol. Update this device or Nestor.\ninvalid-request = Nestor refused this device's pairing request. Update this device or Nestor.\ntoken-refused = Nestor no longer knows this device. Pairing it again.\nlink-failed = The link to Nestor failed ({ $error }). Trying again.\ncamera-failed = The camera did not open, so this device cannot scan a QR code ({ $error }).\n";
+export declare const fr = "\ndevice-code-log = Code d'appairage : { $code }. Saisissez-le dans Nestor pour ajouter cet appareil.\ndevice-code-display = Saisissez ce code dans Nestor pour ajouter cet appareil.\n# La voix fournie a un extrait pour chaque texte autour des chiffres (scripts/voice.py de\n# nestor-satellite-python les enregistre) : les r\u00E9enregistrer apr\u00E8s avoir chang\u00E9 cette phrase.\ndevice-code-speech = Code d'appairage : { $digits }. Je r\u00E9p\u00E8te : { $digits }.\nheadless-hint = Cet appareil n'a ni \u00E9cran ni voix : le plus simple est de l'appairer avec un code d'enr\u00F4lement. Ajoutez un satellite dans Nestor, puis renseignez NESTOR_PAIRING_URI.\nenrollment-sent = Envoi du code d'enr\u00F4lement { $code } \u00E0 Nestor.\nenrollment-refused = { $reason ->\n    [expired] Le code d'enr\u00F4lement { $code } a expir\u00E9.\n    [used] Le code d'enr\u00F4lement { $code } a d\u00E9j\u00E0 servi.\n    [cancelled] Le code d'enr\u00F4lement { $code } a \u00E9t\u00E9 annul\u00E9.\n   *[unknown] Nestor ne conna\u00EEt pas le code d'enr\u00F4lement { $code }.\n}\nenrollment-fallback = Je demande un code d'appairage \u00E0 la place.\nenrollment-already-refused = Le code d'enr\u00F4lement { $code } a d\u00E9j\u00E0 \u00E9t\u00E9 refus\u00E9. Cr\u00E9ez-en un nouveau dans Nestor.\nenrollment-invalid = Ce n'est pas un code d'enr\u00F4lement. Il compte 8 lettres et chiffres, comme K7QF-2M9X.\nenrollment-not-pending = Cet appareil n'attend plus de code d'enr\u00F4lement.\npaired = Appair\u00E9 avec Nestor.\npairing-expired = Le code d'appairage a expir\u00E9. J'en demande un nouveau.\nidentify = Nestor demande \u00E0 cet appareil de se signaler.\ntoo-many-attempts = Trop de codes erron\u00E9s ont \u00E9t\u00E9 essay\u00E9s. Nouvel essai dans { $seconds } s.\ntoo-many-pending = Trop d'appareils attendent d'\u00EAtre appair\u00E9s. Nouvel essai dans { $seconds } s.\nprotocol-unsupported = Ce Nestor parle une autre version du protocole des satellites. Mettez \u00E0 jour cet appareil ou Nestor.\ninvalid-request = Nestor a refus\u00E9 la demande d'appairage de cet appareil. Mettez \u00E0 jour cet appareil ou Nestor.\ntoken-refused = Nestor ne conna\u00EEt plus cet appareil. Nouvel appairage.\nlink-failed = La liaison avec Nestor a \u00E9chou\u00E9 ({ $error }). Nouvel essai.\ncamera-failed = La cam\u00E9ra ne s'est pas ouverte : cet appareil ne peut pas lire de QR code ({ $error }).\n";
+/** The messages every catalogue has. */
+export type MessageId = "device-code-log" | "device-code-display" | "device-code-speech" | "headless-hint" | "enrollment-sent" | "enrollment-refused" | "enrollment-fallback" | "enrollment-already-refused" | "enrollment-invalid" | "enrollment-not-pending" | "paired" | "pairing-expired" | "identify" | "too-many-attempts" | "too-many-pending" | "protocol-unsupported" | "invalid-request" | "token-refused" | "link-failed" | "camera-failed";
+//# sourceMappingURL=locales.d.ts.map

package/dist/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../src/locales.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,EAAE,ggEA4Bd,CAAC;AAEF,eAAO,MAAM,EAAE,q3EA4Bd,CAAC;AAEF,wCAAwC;AACxC,MAAM,MAAM,SAAS,GACjB,iBAAiB,GACjB,qBAAqB,GACrB,oBAAoB,GACpB,eAAe,GACf,iBAAiB,GACjB,oBAAoB,GACpB,qBAAqB,GACrB,4BAA4B,GAC5B,oBAAoB,GACpB,wBAAwB,GACxB,QAAQ,GACR,iBAAiB,GACjB,UAAU,GACV,mBAAmB,GACnB,kBAAkB,GAClB,sBAAsB,GACtB,iBAAiB,GACjB,eAAe,GACf,aAAa,GACb,eAAe,CAAC"}

package/dist/locales.js

@@ -0,0 +1,64 @@
+/**
+ * The SDK's Fluent catalogues (https://projectfluent.org): every sentence a person may read or hear
+ * from a satellite. Kept as strings so the catalogue ships in every bundle, with no file to load.
+ * `test/i18n.test.ts` checks that every locale has every message.
+ */
+export const en = `
+device-code-log = Pairing code: { $code }. Type it in Nestor to add this device.
+device-code-display = Type this code in Nestor to add this device.
+# The bundled voice has a clip for each piece of text around the digits (nestor-satellite-python's
+# scripts/voice.py records them): record them again after changing this sentence.
+device-code-speech = Pairing code: { $digits }. I repeat: { $digits }.
+headless-hint = This device has no screen and no voice, so the easiest way to pair it is an enrollment code. Add a satellite in Nestor, then set NESTOR_PAIRING_URI.
+enrollment-sent = Sending the enrollment code { $code } to Nestor.
+enrollment-refused = { $reason ->
+    [expired] The enrollment code { $code } has expired.
+    [used] The enrollment code { $code } was already used.
+    [cancelled] The enrollment code { $code } was cancelled.
+   *[unknown] Nestor does not know the enrollment code { $code }.
+}
+enrollment-fallback = Asking for a pairing code instead.
+enrollment-already-refused = The enrollment code { $code } was already refused. Make a new one in Nestor.
+enrollment-invalid = This is not an enrollment code. One has 8 letters and digits, like K7QF-2M9X.
+enrollment-not-pending = This device no longer waits for an enrollment code.
+paired = Paired with Nestor.
+pairing-expired = The pairing code expired. Asking for a new one.
+identify = Nestor asks this device to show itself.
+too-many-attempts = Too many wrong codes were tried. Trying again in { $seconds } s.
+too-many-pending = Too many devices are waiting to be paired. Trying again in { $seconds } s.
+protocol-unsupported = This Nestor speaks another version of the satellite protocol. Update this device or Nestor.
+invalid-request = Nestor refused this device's pairing request. Update this device or Nestor.
+token-refused = Nestor no longer knows this device. Pairing it again.
+link-failed = The link to Nestor failed ({ $error }). Trying again.
+camera-failed = The camera did not open, so this device cannot scan a QR code ({ $error }).
+`;
+export const fr = `
+device-code-log = Code d'appairage : { $code }. Saisissez-le dans Nestor pour ajouter cet appareil.
+device-code-display = Saisissez ce code dans Nestor pour ajouter cet appareil.
+# La voix fournie a un extrait pour chaque texte autour des chiffres (scripts/voice.py de
+# nestor-satellite-python les enregistre) : les réenregistrer après avoir changé cette phrase.
+device-code-speech = Code d'appairage : { $digits }. Je répète : { $digits }.
+headless-hint = Cet appareil n'a ni écran ni voix : le plus simple est de l'appairer avec un code d'enrôlement. Ajoutez un satellite dans Nestor, puis renseignez NESTOR_PAIRING_URI.
+enrollment-sent = Envoi du code d'enrôlement { $code } à Nestor.
+enrollment-refused = { $reason ->
+    [expired] Le code d'enrôlement { $code } a expiré.
+    [used] Le code d'enrôlement { $code } a déjà servi.
+    [cancelled] Le code d'enrôlement { $code } a été annulé.
+   *[unknown] Nestor ne connaît pas le code d'enrôlement { $code }.
+}
+enrollment-fallback = Je demande un code d'appairage à la place.
+enrollment-already-refused = Le code d'enrôlement { $code } a déjà été refusé. Créez-en un nouveau dans Nestor.
+enrollment-invalid = Ce n'est pas un code d'enrôlement. Il compte 8 lettres et chiffres, comme K7QF-2M9X.
+enrollment-not-pending = Cet appareil n'attend plus de code d'enrôlement.
+paired = Appairé avec Nestor.
+pairing-expired = Le code d'appairage a expiré. J'en demande un nouveau.
+identify = Nestor demande à cet appareil de se signaler.
+too-many-attempts = Trop de codes erronés ont été essayés. Nouvel essai dans { $seconds } s.
+too-many-pending = Trop d'appareils attendent d'être appairés. Nouvel essai dans { $seconds } s.
+protocol-unsupported = Ce Nestor parle une autre version du protocole des satellites. Mettez à jour cet appareil ou Nestor.
+invalid-request = Nestor a refusé la demande d'appairage de cet appareil. Mettez à jour cet appareil ou Nestor.
+token-refused = Nestor ne connaît plus cet appareil. Nouvel appairage.
+link-failed = La liaison avec Nestor a échoué ({ $error }). Nouvel essai.
+camera-failed = La caméra ne s'est pas ouverte : cet appareil ne peut pas lire de QR code ({ $error }).
+`;
+//# sourceMappingURL=locales.js.map

package/dist/locales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.js","sourceRoot":"","sources":["../src/locales.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjB,CAAC;AAEF,MAAM,CAAC,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjB,CAAC"}

package/dist/log.d.ts

@@ -0,0 +1,10 @@
+/** Where the SDK says what happens; `console` fits, and so does any structured logger. */
+export interface Logger {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+}
+/** Warnings only, on the console: what a driver should see by default. */
+export declare const quietLogger: Logger;
+export declare function describe(error: unknown): string;
+//# sourceMappingURL=log.d.ts.map

package/dist/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,0EAA0E;AAC1E,eAAO,MAAM,WAAW,EAAE,MAIzB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C"}

package/dist/log.js

@@ -0,0 +1,10 @@
+/** Warnings only, on the console: what a driver should see by default. */
+export const quietLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: (message) => console.warn(`[nestor-satellite] ${message}`),
+};
+export function describe(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAOA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAW;IACjC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,OAAO,EAAE,CAAC;CACjE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/node/audio.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Audio in and out of a Node satellite: 16-bit mono PCM, whatever the hardware.
+ *
+ * `AudioSource` gives the chunks to send to the core (the microphone); `AudioSink` plays what the
+ * core says (the speaker). Node has no audio API of its own: `CommandSource` and `CommandSink` run
+ * a recorder and a player (`arecord`/`aplay`, SoX, ffmpeg…) and exchange raw PCM through their
+ * pipes; the doubles serve tests and devices without one or the other.
+ */
+export declare const FRAME_MS = 20;
+export interface AudioSource {
+    readonly sampleRate: number;
+    /** Open the device; nothing to open by default. Rejects clearly when it cannot. */
+    start?(): Promise<void>;
+    /** The next chunk of audio (any length, 20 ms is usual); waits for it. */
+    read(): Promise<Int16Array>;
+    close?(): Promise<void>;
+}
+export interface AudioSink {
+    readonly sampleRate: number;
+    start?(): Promise<void>;
+    /** Play audio as it arrives; must not block. */
+    write(pcm: Int16Array): void;
+    close?(): Promise<void>;
+}
+/** A device without a microphone still sends a (silent) stream: the core's turn taking expects one. */
+export declare class SilenceSource implements AudioSource {
+    readonly sampleRate: number;
+    constructor(sampleRate?: number);
+    read(): Promise<Int16Array>;
+}
+/** Keeps what was played, e.g. to check a device received the core's voice. */
+export declare class RecordingSink implements AudioSink {
+    readonly sampleRate: number;
+    readonly chunks: Int16Array[];
+    constructor(sampleRate?: number);
+    get samples(): number;
+    write(pcm: Int16Array): void;
+}
+/** No speaker: the core's audio is received (the link stays healthy) and dropped. */
+export declare class DiscardSink implements AudioSink {
+    readonly sampleRate: number;
+    constructor(sampleRate?: number);
+    write(): void;
+}
+export interface CommandOptions {
+    readonly sampleRate?: number;
+    /** How much audio may wait before it is dropped (default: 1 s for a recorder, 500 ms for a player). */
+    readonly maxBufferMs?: number;
+}
+/**
+ * A recorder whose standard output is raw s16le mono PCM, e.g.
+ * `arecord -q -t raw -f S16_LE -c 1 -r 48000`. Run by `/bin/sh -c`.
+ */
+export declare class CommandSource implements AudioSource {
+    readonly command: string;
+    readonly sampleRate: number;
+    private readonly maxBytes;
+    private process;
+    private buffer;
+    private waiting;
+    private failure;
+    constructor(command: string, options?: CommandOptions);
+    start(): Promise<void>;
+    read(): Promise<Int16Array>;
+    close(): Promise<void>;
+    private wake;
+}
+/**
+ * A player that reads raw s16le mono PCM on its standard input, e.g.
+ * `aplay -q -t raw -f S16_LE -c 1 -r 48000`. Audio the player cannot take in time is dropped
+ * rather than letting the voice lag further and further behind.
+ */
+export declare class CommandSink implements AudioSink {
+    readonly command: string;
+    readonly sampleRate: number;
+    private readonly maxBytes;
+    private process;
+    constructor(command: string, options?: CommandOptions);
+    start(): Promise<void>;
+    write(samples: Int16Array): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=audio.d.ts.map

package/dist/node/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/node/audio.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,QAAQ,KAAK,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,0EAA0E;IAC1E,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,gDAAgD;IAChD,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,uGAAuG;AACvG,qBAAa,aAAc,YAAW,WAAW;IACnC,QAAQ,CAAC,UAAU;gBAAV,UAAU,SAAS;IAElC,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;CAGlC;AAED,+EAA+E;AAC/E,qBAAa,aAAc,YAAW,SAAS;IAGjC,QAAQ,CAAC,UAAU;IAF/B,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAM;gBAEd,UAAU,SAAS;IAExC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;CAG7B;AAED,qFAAqF;AACrF,qBAAa,WAAY,YAAW,SAAS;IAC/B,QAAQ,CAAC,UAAU;gBAAV,UAAU,SAAS;IAExC,KAAK,IAAI,IAAI;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,uGAAuG;IACvG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,WAAW;IAS7C,QAAQ,CAAC,OAAO,EAAE,MAAM;IAR1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAsB;gBAG1B,OAAO,EAAE,MAAM,EACxB,OAAO,GAAE,cAAmB;IAMxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAc3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,OAAO,CAAC,IAAI;CAKb;AAED;;;;GAIG;AACH,qBAAa,WAAY,YAAW,SAAS;IAMzC,QAAQ,CAAC,OAAO,EAAE,MAAM;IAL1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,OAAO,CAA6B;gBAGjC,OAAO,EAAE,MAAM,EACxB,OAAO,GAAE,cAAmB;IAMxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAM1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist/node/audio.js

@@ -0,0 +1,168 @@
+/**
+ * Audio in and out of a Node satellite: 16-bit mono PCM, whatever the hardware.
+ *
+ * `AudioSource` gives the chunks to send to the core (the microphone); `AudioSink` plays what the
+ * core says (the speaker). Node has no audio API of its own: `CommandSource` and `CommandSink` run
+ * a recorder and a player (`arecord`/`aplay`, SoX, ffmpeg…) and exchange raw PCM through their
+ * pipes; the doubles serve tests and devices without one or the other.
+ */
+import { spawn } from "node:child_process";
+export const FRAME_MS = 20;
+/** A device without a microphone still sends a (silent) stream: the core's turn taking expects one. */
+export class SilenceSource {
+    sampleRate;
+    constructor(sampleRate = 48_000) {
+        this.sampleRate = sampleRate;
+    }
+    async read() {
+        return new Int16Array((this.sampleRate * FRAME_MS) / 1000);
+    }
+}
+/** Keeps what was played, e.g. to check a device received the core's voice. */
+export class RecordingSink {
+    sampleRate;
+    chunks = [];
+    constructor(sampleRate = 48_000) {
+        this.sampleRate = sampleRate;
+    }
+    get samples() {
+        return this.chunks.reduce((total, chunk) => total + chunk.length, 0);
+    }
+    write(pcm) {
+        this.chunks.push(pcm);
+    }
+}
+/** No speaker: the core's audio is received (the link stays healthy) and dropped. */
+export class DiscardSink {
+    sampleRate;
+    constructor(sampleRate = 48_000) {
+        this.sampleRate = sampleRate;
+    }
+    write() { }
+}
+/**
+ * A recorder whose standard output is raw s16le mono PCM, e.g.
+ * `arecord -q -t raw -f S16_LE -c 1 -r 48000`. Run by `/bin/sh -c`.
+ */
+export class CommandSource {
+    command;
+    sampleRate;
+    maxBytes;
+    process = null;
+    buffer = Buffer.alloc(0);
+    waiting = null;
+    failure = null;
+    constructor(command, options = {}) {
+        this.command = command;
+        this.sampleRate = options.sampleRate ?? 48_000;
+        this.maxBytes = Math.round((this.sampleRate * (options.maxBufferMs ?? 1000)) / 1000) * 2;
+    }
+    async start() {
+        const child = await launch(this.command, ["ignore", "pipe", "inherit"]);
+        this.process = child;
+        child.stdout?.on("data", (data) => {
+            this.buffer = Buffer.concat([this.buffer, data]);
+            if (this.buffer.length > this.maxBytes)
+                this.buffer = this.buffer.subarray(this.buffer.length - this.maxBytes);
+            this.wake();
+        });
+        child.on("exit", (code, signal) => {
+            if (this.process === child)
+                this.failure = new Error(`the recorder stopped (${signal ?? `status ${code}`})`);
+            this.wake();
+        });
+    }
+    async read() {
+        const frame = ((this.sampleRate * FRAME_MS) / 1000) * 2;
+        while (this.buffer.length < frame) {
+            if (this.failure !== null)
+                throw this.failure;
+            if (this.process === null)
+                throw new Error("the recorder is not started");
+            await new Promise((resolve) => {
+                this.waiting = resolve;
+            });
+        }
+        const chunk = this.buffer.subarray(0, frame);
+        this.buffer = this.buffer.subarray(frame);
+        return pcm(chunk);
+    }
+    async close() {
+        const child = this.process;
+        this.process = null;
+        this.wake();
+        await stop(child);
+    }
+    wake() {
+        const waiting = this.waiting;
+        this.waiting = null;
+        waiting?.();
+    }
+}
+/**
+ * A player that reads raw s16le mono PCM on its standard input, e.g.
+ * `aplay -q -t raw -f S16_LE -c 1 -r 48000`. Audio the player cannot take in time is dropped
+ * rather than letting the voice lag further and further behind.
+ */
+export class CommandSink {
+    command;
+    sampleRate;
+    maxBytes;
+    process = null;
+    constructor(command, options = {}) {
+        this.command = command;
+        this.sampleRate = options.sampleRate ?? 48_000;
+        this.maxBytes = Math.round((this.sampleRate * (options.maxBufferMs ?? 500)) / 1000) * 2;
+    }
+    async start() {
+        this.process = await launch(this.command, ["pipe", "ignore", "inherit"]);
+        this.process.stdin?.on("error", () => { }); // a player that quits is noticed on exit
+    }
+    write(samples) {
+        const stdin = this.process?.stdin;
+        if (!stdin || stdin.destroyed || stdin.writableLength > this.maxBytes)
+            return;
+        stdin.write(Buffer.from(samples.buffer, samples.byteOffset, samples.byteLength));
+    }
+    async close() {
+        const child = this.process;
+        this.process = null;
+        child?.stdin?.end();
+        await stop(child, 1000); // let it play what it has, briefly
+    }
+}
+function pcm(bytes) {
+    const copy = new Uint8Array(bytes.length);
+    copy.set(bytes);
+    return new Int16Array(copy.buffer);
+}
+function launch(command, stdio) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("/bin/sh", ["-c", `exec ${command}`], { stdio });
+        child.once("error", reject);
+        child.once("spawn", () => {
+            // `sh` starts even when the command does not exist: give it a moment to fail.
+            const early = setTimeout(() => {
+                child.off("exit", exited);
+                resolve(child);
+            }, 200);
+            const exited = (code) => {
+                clearTimeout(early);
+                reject(new Error(`\`${command}\` exited at once (status ${code}): is it installed?`));
+            };
+            child.once("exit", exited);
+        });
+    });
+}
+/** Ends a child: after `graceMs` on its own, then SIGTERM, then SIGKILL. */
+async function stop(child, graceMs = 0) {
+    if (child === null || child.exitCode !== null || child.signalCode !== null)
+        return;
+    const exited = new Promise((resolve) => child.once("exit", () => resolve()));
+    const term = setTimeout(() => child.kill("SIGTERM"), graceMs);
+    const kill = setTimeout(() => child.kill("SIGKILL"), graceMs + 2000);
+    await exited;
+    clearTimeout(term);
+    clearTimeout(kill);
+}
+//# sourceMappingURL=audio.js.map

package/dist/node/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../src/node/audio.ts"],"names":[],"mappings":"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"}

package/dist/node/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/node/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/node/bin.ts"],"names":[],"mappings":""}

package/dist/node/bin.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from "./cli.js";
+process.exitCode = await main(process.argv.slice(2));
+//# sourceMappingURL=bin.js.map

package/dist/node/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/node/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/node/cli.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `nestor-satellite run`: this machine's microphone and speaker as a satellite of a Nestor core.
+ *
+ *     nestor-satellite run --core http://nestor.local:7860 --room salon
+ *     NESTOR_PAIRING_URI=nestor+http://nestor.local:7860/?code=K7QF2M9X nestor-satellite run --room salon
+ *
+ * With an enrollment code (`--pairing-uri`, `--pairing-code`, or the same in `NESTOR_PAIRING_URI`,
+ * `NESTOR_PAIRING_CODE`), the first run pairs at once; without one, it says a device code to type in
+ * Nestor on its speaker (the bundled voice) and logs it. The token is then kept in `~/.config/nestor-satellite/<id>.json`. Audio goes through a recorder and a player command
+ * (`arecord`/`aplay` on Linux, SoX's `rec`/`play` on macOS) exchanging raw 48 kHz s16le mono PCM.
+ */
+import type { Logger } from "../log.js";
+import { Satellite } from "../satellite.js";
+import { type Environment } from "./env.js";
+export declare const DEFAULT_INPUT: string;
+export declare const DEFAULT_OUTPUT: string;
+export interface Arguments {
+    readonly core: string;
+    readonly room: string;
+    readonly id: string;
+    readonly model: string;
+    readonly brand: string | undefined;
+    readonly tokenFile: string;
+    readonly input: string;
+    readonly output: string;
+    readonly ice: readonly string[];
+    /** The enrollment code a person configured (canonical form), if any. */
+    readonly enrollment: string | undefined;
+    readonly locale: readonly string[];
+    readonly verbose: boolean;
+}
+export declare function defaultId(): string;
+/** The arguments of `run`, then the environment; throws a usage error when they are wrong. */
+export declare function parse(argv: readonly string[], env?: Environment): Arguments | "help" | "version";
+export declare class UsageError extends Error {
+}
+export declare function build(args: Arguments, logger: Logger): Satellite;
+export declare function main(argv: readonly string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/node/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/node/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,KAAK,WAAW,EAAyE,MAAM,UAAU,CAAC;AAMnH,eAAO,MAAM,aAAa,QACyE,CAAC;AACpG,eAAO,MAAM,cAAc,QACuE,CAAC;AA4BnG,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AAED,8FAA8F;AAC9F,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,GAAE,WAAyB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAoD7G;AAED,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAmBhE;AAOD,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCnE"}