tci-client-node 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 boybook
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,133 @@
+# tci-client-node
+
+A pure TypeScript client for the Expert Electronics TCI (Transceiver Control Interface) protocol used by SunSDR and ExpertSDR.
+
+TCI is a WebSocket protocol: text commands are used for CAT-style radio control, and binary WebSocket frames carry audio/IQ stream blocks. This package therefore does not require a native Node.js addon.
+
+## Status
+
+`0.1.x` focuses on the subset needed by application integrations:
+
+- WebSocket lifecycle and READY/startup state handling
+- Frequency, mode, PTT, tune, drive, split, and CW text/macros
+- RX and TX sensor state parsing
+- RX audio, TX audio, TX_CHRONO, and line-out stream frame parsing/building
+- Serial command queue with timeout, cancellation, and interleaved broadcast handling
+- Mock TCI server and fake WebSocket transport for integration tests
+
+Panadapter, IQ UI, skimmer, and spots APIs are intentionally out of scope for the first release, but the protocol layer is designed to be extended.
+
+## Install
+
+```bash
+npm install tci-client-node
+```
+
+## Basic Usage
+
+```ts
+import { TciClient } from 'tci-client-node';
+
+const client = new TciClient({
+  url: 'ws://127.0.0.1:40001',
+  receiver: 0,
+  trx: 0,
+  vfo: 0,
+  connectTimeoutMs: 5000,
+  commandTimeoutMs: 1000,
+});
+
+client.on('state', (state) => {
+  console.log(state.connected, state.ready, state.frequencies);
+});
+
+client.on('rxAudioFrame', (frame) => {
+  console.log(frame.sampleRate, frame.channels, frame.sampleCount);
+});
+
+client.on('txChrono', (request) => {
+  // The host application decides what to transmit.
+  // Send silence if no TX audio is ready.
+  client.sendTxAudio({
+    receiver: request.receiver,
+    sampleRate: request.sampleRate,
+    sampleType: request.sampleType,
+    channels: request.channels,
+    samples: new Float32Array(request.sampleCount * request.channels),
+  });
+});
+
+await client.connect();
+await client.setFrequency(14_074_000);
+await client.setMode('digu');
+await client.configureAudio({
+  sampleRate: 12_000,
+  sampleType: 'float32',
+  channels: 1,
+  samplesPerFrame: 512,
+});
+await client.startAudio();
+await client.setPtt(true, { source: 'tci' });
+```
+
+## Subpath Exports
+
+- `tci-client-node`: `TciClient`, `createTciClient`, high-level radio/audio API, errors, and core types.
+- `tci-client-node/protocol`: text command parser/formatter, escaping helpers, and command queue.
+- `tci-client-node/audio`: stream frame parser/builder and sample conversion helpers.
+- `tci-client-node/testing`: `MockTciServer` and `FakeWebSocket` helpers for tests.
+
+## Audio Frames
+
+The official TCI `Stream` header is 16 little-endian `uint32` fields. In this package:
+
+- `sampleCount` maps to the official `Stream.length` field, meaning samples per channel.
+- `payloadLength` is the derived byte length after applying sample type and channel count.
+- `channels` is read from the TCI 1.9+ header. If a legacy 1.8-style frame has no channel field, the parser infers it from payload size.
+
+Supported sample types are `int16`, `int24`, `int32`, and `float32`.
+
+## Testing Utilities
+
+```ts
+import { MockTciServer } from 'tci-client-node/testing';
+
+const server = new MockTciServer();
+await server.start();
+
+const client = new TciClient({ url: server.url() });
+await client.connect();
+
+server.sendRxAudioFrame({ samples: new Float32Array([0, 0.5, -0.5]) });
+```
+
+## Development
+
+```bash
+npm install
+npm test
+npm run typecheck
+npm run build
+```
+
+The package is built with `tsup` and publishes ESM, CommonJS, and declaration files.
+
+## Releases
+
+Releases are published by GitHub Actions when a `v*` tag is pushed. The tag must
+match `package.json` exactly, for example `v0.1.0` for version `0.1.0`.
+
+The workflow mirrors the `icom-wlan-node` release shape: install with `npm ci`,
+typecheck, build, test, verify the package contents, and publish to npm using
+the `NPM_TOKEN` repository secret. Provenance is enabled through npm's
+`publishConfig`.
+
+## References
+
+- [ExpertSDR3 TCI protocol](https://github.com/ExpertSDR3/TCI)
+- [ftl/tci](https://github.com/ftl/tci)
+- [ftl/tciadapter](https://github.com/ftl/tciadapter)
+
+## License
+
+MIT

package/dist/audio/index.cjs

@@ -0,0 +1,343 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/audio/index.ts
+var audio_exports = {};
+__export(audio_exports, {
+  TCI_STREAM_HEADER_BYTES: () => TCI_STREAM_HEADER_BYTES,
+  TciSampleType: () => TciSampleType,
+  TciStreamType: () => TciStreamType,
+  buildStreamFrame: () => buildStreamFrame,
+  buildTxAudioFrame: () => buildTxAudioFrame,
+  deinterleaveChannels: () => deinterleaveChannels,
+  float32ToPcm16: () => float32ToPcm16,
+  mixToMono: () => mixToMono,
+  normalizeSampleType: () => normalizeSampleType,
+  normalizeStreamType: () => normalizeStreamType,
+  parseStreamFrame: () => parseStreamFrame,
+  payloadToFloat32: () => payloadToFloat32,
+  pcm16ToFloat32: () => pcm16ToFloat32,
+  sampleTypeBytes: () => sampleTypeBytes,
+  sampleTypeName: () => sampleTypeName,
+  samplesToPayload: () => samplesToPayload
+});
+module.exports = __toCommonJS(audio_exports);
+
+// src/errors.ts
+var TciError = class extends Error {
+  code;
+  details;
+  constructor(code, message, details) {
+    super(message);
+    this.name = "TciError";
+    this.code = code;
+    this.details = details;
+  }
+};
+
+// src/audio/streamFrame.ts
+var TCI_STREAM_HEADER_BYTES = 16 * 4;
+var TciStreamType = /* @__PURE__ */ ((TciStreamType2) => {
+  TciStreamType2[TciStreamType2["IQ_STREAM"] = 0] = "IQ_STREAM";
+  TciStreamType2[TciStreamType2["RX_AUDIO_STREAM"] = 1] = "RX_AUDIO_STREAM";
+  TciStreamType2[TciStreamType2["TX_AUDIO_STREAM"] = 2] = "TX_AUDIO_STREAM";
+  TciStreamType2[TciStreamType2["TX_CHRONO"] = 3] = "TX_CHRONO";
+  TciStreamType2[TciStreamType2["LINEOUT_STREAM"] = 4] = "LINEOUT_STREAM";
+  return TciStreamType2;
+})(TciStreamType || {});
+var TciSampleType = /* @__PURE__ */ ((TciSampleType2) => {
+  TciSampleType2[TciSampleType2["INT16"] = 0] = "INT16";
+  TciSampleType2[TciSampleType2["INT24"] = 1] = "INT24";
+  TciSampleType2[TciSampleType2["INT32"] = 2] = "INT32";
+  TciSampleType2[TciSampleType2["FLOAT32"] = 3] = "FLOAT32";
+  return TciSampleType2;
+})(TciSampleType || {});
+function parseStreamFrame(input) {
+  const buffer = toBuffer(input);
+  if (buffer.byteLength < TCI_STREAM_HEADER_BYTES) {
+    throw new TciError("invalid-frame", `TCI stream frame is shorter than ${TCI_STREAM_HEADER_BYTES} bytes`);
+  }
+  const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+  const header = Array.from({ length: 16 }, (_, index) => view.getUint32(index * 4, true));
+  const sampleType = normalizeSampleType(header[2]);
+  let channels = header[7];
+  const bytesPerSample = sampleTypeBytes(sampleType);
+  const sampleCount = header[5];
+  const actualPayloadLength = buffer.byteLength - TCI_STREAM_HEADER_BYTES;
+  if (channels <= 0) {
+    const inferredChannels = sampleCount > 0 ? actualPayloadLength / sampleCount / bytesPerSample : 1;
+    if (!Number.isInteger(inferredChannels) || inferredChannels <= 0) {
+      throw new TciError("invalid-frame", `Invalid TCI channel count: ${channels}`);
+    }
+    channels = inferredChannels;
+  }
+  const payloadLength = sampleCount * bytesPerSample * channels;
+  const expectedLength = TCI_STREAM_HEADER_BYTES + payloadLength;
+  if (buffer.byteLength !== expectedLength) {
+    throw new TciError(
+      "invalid-frame",
+      `TCI stream frame length mismatch: header says ${sampleCount} samples (${payloadLength} payload bytes), got ${buffer.byteLength - TCI_STREAM_HEADER_BYTES}`
+    );
+  }
+  if (payloadLength % (bytesPerSample * channels) !== 0) {
+    throw new TciError("invalid-frame", "TCI payload length is not aligned to sample type and channel count");
+  }
+  return {
+    receiver: header[0],
+    sampleRate: header[1],
+    sampleType,
+    codec: header[3],
+    crc: header[4],
+    payloadLength,
+    streamType: normalizeStreamType(header[6]),
+    channels,
+    reserved: header.slice(8),
+    payload: buffer.subarray(TCI_STREAM_HEADER_BYTES),
+    sampleCount
+  };
+}
+function buildStreamFrame(options) {
+  const sampleType = normalizeSampleType(options.sampleType);
+  const payload = options.payload ? toBuffer(options.payload) : samplesToPayload(options.samples ?? [], sampleType);
+  const channels = options.channels;
+  if (channels <= 0) {
+    throw new TciError("invalid-frame", `Invalid TCI channel count: ${channels}`);
+  }
+  const bytesPerSample = sampleTypeBytes(sampleType);
+  if (payload.byteLength % (bytesPerSample * channels) !== 0) {
+    throw new TciError("invalid-frame", "TCI payload length is not aligned to sample type and channel count");
+  }
+  const sampleCount = payload.byteLength / bytesPerSample / channels;
+  const frame = Buffer.alloc(TCI_STREAM_HEADER_BYTES + payload.byteLength);
+  const view = new DataView(frame.buffer, frame.byteOffset, frame.byteLength);
+  const reserved = options.reserved ?? [];
+  const header = [
+    options.receiver ?? 0,
+    options.sampleRate,
+    sampleType,
+    options.codec ?? 0,
+    options.crc ?? 0,
+    sampleCount,
+    options.streamType,
+    channels,
+    ...Array.from({ length: 8 }, (_, index) => reserved[index] ?? 0)
+  ];
+  header.forEach((value, index) => view.setUint32(index * 4, value >>> 0, true));
+  payload.copy(frame, TCI_STREAM_HEADER_BYTES);
+  return frame;
+}
+function buildTxAudioFrame(options) {
+  return buildStreamFrame({ ...options, streamType: 2 /* TX_AUDIO_STREAM */ });
+}
+function sampleTypeBytes(sampleType) {
+  switch (normalizeSampleType(sampleType)) {
+    case 0 /* INT16 */:
+      return 2;
+    case 1 /* INT24 */:
+      return 3;
+    case 2 /* INT32 */:
+    case 3 /* FLOAT32 */:
+      return 4;
+    default:
+      throw new TciError("invalid-frame", `Unsupported TCI sample type: ${sampleType}`);
+  }
+}
+function sampleTypeName(sampleType) {
+  switch (sampleType) {
+    case 0 /* INT16 */:
+      return "int16";
+    case 1 /* INT24 */:
+      return "int24";
+    case 2 /* INT32 */:
+      return "int32";
+    case 3 /* FLOAT32 */:
+      return "float32";
+    default:
+      throw new TciError("invalid-frame", `Unsupported TCI sample type: ${sampleType}`);
+  }
+}
+function normalizeSampleType(sampleType) {
+  if (typeof sampleType === "string") {
+    switch (sampleType.toLowerCase()) {
+      case "int16":
+        return 0 /* INT16 */;
+      case "int24":
+        return 1 /* INT24 */;
+      case "int32":
+        return 2 /* INT32 */;
+      case "float32":
+        return 3 /* FLOAT32 */;
+      default:
+        throw new TciError("invalid-frame", `Unsupported TCI sample type: ${sampleType}`);
+    }
+  }
+  if (sampleType >= 0 /* INT16 */ && sampleType <= 3 /* FLOAT32 */) {
+    return sampleType;
+  }
+  throw new TciError("invalid-frame", `Unsupported TCI sample type: ${sampleType}`);
+}
+function normalizeStreamType(streamType) {
+  if (streamType >= 0 /* IQ_STREAM */ && streamType <= 4 /* LINEOUT_STREAM */) {
+    return streamType;
+  }
+  throw new TciError("invalid-frame", `Unsupported TCI stream type: ${streamType}`);
+}
+function payloadToFloat32(frameOrPayload, sampleType) {
+  const payload = isFrame(frameOrPayload) ? frameOrPayload.payload : toBuffer(frameOrPayload);
+  const type = isFrame(frameOrPayload) ? frameOrPayload.sampleType : normalizeSampleType(sampleType ?? 3 /* FLOAT32 */);
+  const bytes = sampleTypeBytes(type);
+  if (payload.byteLength % bytes !== 0) {
+    throw new TciError("invalid-frame", "Payload length is not aligned to sample type");
+  }
+  const output = new Float32Array(payload.byteLength / bytes);
+  const view = new DataView(payload.buffer, payload.byteOffset, payload.byteLength);
+  for (let i = 0; i < output.length; i += 1) {
+    const offset = i * bytes;
+    switch (type) {
+      case 0 /* INT16 */:
+        output[i] = view.getInt16(offset, true) / 32768;
+        break;
+      case 1 /* INT24 */:
+        output[i] = readInt24(view, offset) / 8388608;
+        break;
+      case 2 /* INT32 */:
+        output[i] = view.getInt32(offset, true) / 2147483648;
+        break;
+      case 3 /* FLOAT32 */:
+        output[i] = view.getFloat32(offset, true);
+        break;
+    }
+  }
+  return output;
+}
+function samplesToPayload(samples, sampleType) {
+  const type = normalizeSampleType(sampleType);
+  const bytes = sampleTypeBytes(type);
+  const payload = Buffer.alloc(samples.length * bytes);
+  const view = new DataView(payload.buffer, payload.byteOffset, payload.byteLength);
+  for (let i = 0; i < samples.length; i += 1) {
+    const value = clampSample(samples[i] ?? 0);
+    const offset = i * bytes;
+    switch (type) {
+      case 0 /* INT16 */:
+        view.setInt16(offset, Math.round(value * 32767), true);
+        break;
+      case 1 /* INT24 */:
+        writeInt24(view, offset, Math.round(value * 8388607));
+        break;
+      case 2 /* INT32 */:
+        view.setInt32(offset, Math.round(value * 2147483647), true);
+        break;
+      case 3 /* FLOAT32 */:
+        view.setFloat32(offset, value, true);
+        break;
+    }
+  }
+  return payload;
+}
+function pcm16ToFloat32(input) {
+  if (input instanceof Int16Array) {
+    const output = new Float32Array(input.length);
+    for (let i = 0; i < input.length; i += 1) {
+      output[i] = input[i] / 32768;
+    }
+    return output;
+  }
+  return payloadToFloat32(toBuffer(input), 0 /* INT16 */);
+}
+function float32ToPcm16(samples) {
+  return samplesToPayload(samples, 0 /* INT16 */);
+}
+function deinterleaveChannels(samples, channels) {
+  if (channels <= 0 || samples.length % channels !== 0) {
+    throw new TciError("invalid-frame", "Cannot deinterleave samples with invalid channel count");
+  }
+  const frames = samples.length / channels;
+  const outputs = Array.from({ length: channels }, () => new Float32Array(frames));
+  for (let frame = 0; frame < frames; frame += 1) {
+    for (let channel = 0; channel < channels; channel += 1) {
+      outputs[channel][frame] = samples[frame * channels + channel];
+    }
+  }
+  return outputs;
+}
+function mixToMono(samples, channels) {
+  if (channels === 1) {
+    return samples;
+  }
+  const separated = deinterleaveChannels(samples, channels);
+  const mono = new Float32Array(separated[0]?.length ?? 0);
+  for (const channel of separated) {
+    for (let i = 0; i < mono.length; i += 1) {
+      mono[i] += channel[i] / channels;
+    }
+  }
+  return mono;
+}
+function toBuffer(input) {
+  if (Buffer.isBuffer(input)) {
+    return input;
+  }
+  if (input instanceof ArrayBuffer) {
+    return Buffer.from(input);
+  }
+  if (ArrayBuffer.isView(input)) {
+    return Buffer.from(input.buffer, input.byteOffset, input.byteLength);
+  }
+  return Buffer.from(input);
+}
+function isFrame(value) {
+  return Boolean(value && typeof value === "object" && "payload" in value && "sampleType" in value);
+}
+function clampSample(value) {
+  if (!Number.isFinite(value)) {
+    return 0;
+  }
+  return Math.max(-1, Math.min(1, value));
+}
+function readInt24(view, offset) {
+  const value = view.getUint8(offset) | view.getUint8(offset + 1) << 8 | view.getUint8(offset + 2) << 16;
+  return value & 8388608 ? value | 4278190080 : value;
+}
+function writeInt24(view, offset, value) {
+  const clamped = Math.max(-8388608, Math.min(8388607, value));
+  view.setUint8(offset, clamped & 255);
+  view.setUint8(offset + 1, clamped >> 8 & 255);
+  view.setUint8(offset + 2, clamped >> 16 & 255);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TCI_STREAM_HEADER_BYTES,
+  TciSampleType,
+  TciStreamType,
+  buildStreamFrame,
+  buildTxAudioFrame,
+  deinterleaveChannels,
+  float32ToPcm16,
+  mixToMono,
+  normalizeSampleType,
+  normalizeStreamType,
+  parseStreamFrame,
+  payloadToFloat32,
+  pcm16ToFloat32,
+  sampleTypeBytes,
+  sampleTypeName,
+  samplesToPayload
+});
+//# sourceMappingURL=index.cjs.map

package/dist/audio/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/audio/index.ts","../../src/errors.ts","../../src/audio/streamFrame.ts"],"sourcesContent":["export * from './streamFrame.js';\n","export type TciErrorCode =\n  | 'connect-timeout'\n  | 'command-timeout'\n  | 'not-connected'\n  | 'disconnected'\n  | 'protocol-error'\n  | 'invalid-frame'\n  | 'cancelled';\n\nexport class TciError extends Error {\n  readonly code: TciErrorCode;\n  readonly details?: unknown;\n\n  constructor(code: TciErrorCode, message: string, details?: unknown) {\n    super(message);\n    this.name = 'TciError';\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport function toTciError(error: unknown, fallbackCode: TciErrorCode = 'protocol-error'): TciError {\n  if (error instanceof TciError) {\n    return error;\n  }\n  if (error instanceof Error) {\n    return new TciError(fallbackCode, error.message, error);\n  }\n  return new TciError(fallbackCode, String(error), error);\n}\n","import { TciError } from '../errors.js';\n\nexport const TCI_STREAM_HEADER_BYTES = 16 * 4;\n\nexport enum TciStreamType {\n  IQ_STREAM = 0,\n  RX_AUDIO_STREAM = 1,\n  TX_AUDIO_STREAM = 2,\n  TX_CHRONO = 3,\n  LINEOUT_STREAM = 4,\n}\n\nexport enum TciSampleType {\n  INT16 = 0,\n  INT24 = 1,\n  INT32 = 2,\n  FLOAT32 = 3,\n}\n\nexport type TciSampleTypeName = 'int16' | 'int24' | 'int32' | 'float32';\n\nexport interface TciStreamFrame {\n  receiver: number;\n  sampleRate: number;\n  sampleType: TciSampleType;\n  codec: number;\n  crc: number;\n  /** Byte length of the payload following the 64-byte TCI stream header. */\n  payloadLength: number;\n  streamType: TciStreamType;\n  channels: number;\n  reserved: number[];\n  payload: Buffer;\n  /** Official Stream.length value: number of samples per channel in the payload. */\n  sampleCount: number;\n}\n\nexport interface BuildStreamFrameOptions {\n  receiver?: number;\n  sampleRate: number;\n  sampleType: TciSampleType | TciSampleTypeName;\n  streamType: TciStreamType;\n  channels: number;\n  payload?: Buffer | Uint8Array | ArrayBuffer | ArrayBufferView;\n  samples?: Float32Array | readonly number[];\n  codec?: number;\n  crc?: number;\n  reserved?: readonly number[];\n}\n\nexport interface BuildTxAudioFrameOptions extends Omit<BuildStreamFrameOptions, 'streamType'> {\n  receiver?: number;\n}\n\nexport function parseStreamFrame(input: Buffer | ArrayBuffer | ArrayBufferView): TciStreamFrame {\n  const buffer = toBuffer(input);\n  if (buffer.byteLength < TCI_STREAM_HEADER_BYTES) {\n    throw new TciError('invalid-frame', `TCI stream frame is shorter than ${TCI_STREAM_HEADER_BYTES} bytes`);\n  }\n\n  const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);\n  const header = Array.from({ length: 16 }, (_, index) => view.getUint32(index * 4, true));\n  const sampleType = normalizeSampleType(header[2]);\n  let channels = header[7];\n  const bytesPerSample = sampleTypeBytes(sampleType);\n  const sampleCount = header[5];\n  const actualPayloadLength = buffer.byteLength - TCI_STREAM_HEADER_BYTES;\n  if (channels <= 0) {\n    const inferredChannels = sampleCount > 0 ? actualPayloadLength / sampleCount / bytesPerSample : 1;\n    if (!Number.isInteger(inferredChannels) || inferredChannels <= 0) {\n      throw new TciError('invalid-frame', `Invalid TCI channel count: ${channels}`);\n    }\n    channels = inferredChannels;\n  }\n  const payloadLength = sampleCount * bytesPerSample * channels;\n  const expectedLength = TCI_STREAM_HEADER_BYTES + payloadLength;\n  if (buffer.byteLength !== expectedLength) {\n    throw new TciError(\n      'invalid-frame',\n      `TCI stream frame length mismatch: header says ${sampleCount} samples (${payloadLength} payload bytes), got ${buffer.byteLength - TCI_STREAM_HEADER_BYTES}`,\n    );\n  }\n  if (payloadLength % (bytesPerSample * channels) !== 0) {\n    throw new TciError('invalid-frame', 'TCI payload length is not aligned to sample type and channel count');\n  }\n\n  return {\n    receiver: header[0],\n    sampleRate: header[1],\n    sampleType,\n    codec: header[3],\n    crc: header[4],\n    payloadLength,\n    streamType: normalizeStreamType(header[6]),\n    channels,\n    reserved: header.slice(8),\n    payload: buffer.subarray(TCI_STREAM_HEADER_BYTES),\n    sampleCount,\n  };\n}\n\nexport function buildStreamFrame(options: BuildStreamFrameOptions): Buffer {\n  const sampleType = normalizeSampleType(options.sampleType);\n  const payload = options.payload ? toBuffer(options.payload) : samplesToPayload(options.samples ?? [], sampleType);\n  const channels = options.channels;\n  if (channels <= 0) {\n    throw new TciError('invalid-frame', `Invalid TCI channel count: ${channels}`);\n  }\n  const bytesPerSample = sampleTypeBytes(sampleType);\n  if (payload.byteLength % (bytesPerSample * channels) !== 0) {\n    throw new TciError('invalid-frame', 'TCI payload length is not aligned to sample type and channel count');\n  }\n  const sampleCount = payload.byteLength / bytesPerSample / channels;\n\n  const frame = Buffer.alloc(TCI_STREAM_HEADER_BYTES + payload.byteLength);\n  const view = new DataView(frame.buffer, frame.byteOffset, frame.byteLength);\n  const reserved = options.reserved ?? [];\n  const header = [\n    options.receiver ?? 0,\n    options.sampleRate,\n    sampleType,\n    options.codec ?? 0,\n    options.crc ?? 0,\n    sampleCount,\n    options.streamType,\n    channels,\n    ...Array.from({ length: 8 }, (_, index) => reserved[index] ?? 0),\n  ];\n  header.forEach((value, index) => view.setUint32(index * 4, value >>> 0, true));\n  payload.copy(frame, TCI_STREAM_HEADER_BYTES);\n  return frame;\n}\n\nexport function buildTxAudioFrame(options: BuildTxAudioFrameOptions): Buffer {\n  return buildStreamFrame({ ...options, streamType: TciStreamType.TX_AUDIO_STREAM });\n}\n\nexport function sampleTypeBytes(sampleType: TciSampleType | TciSampleTypeName): number {\n  switch (normalizeSampleType(sampleType)) {\n    case TciSampleType.INT16:\n      return 2;\n    case TciSampleType.INT24:\n      return 3;\n    case TciSampleType.INT32:\n    case TciSampleType.FLOAT32:\n      return 4;\n    default:\n      throw new TciError('invalid-frame', `Unsupported TCI sample type: ${sampleType}`);\n  }\n}\n\nexport function sampleTypeName(sampleType: TciSampleType): TciSampleTypeName {\n  switch (sampleType) {\n    case TciSampleType.INT16:\n      return 'int16';\n    case TciSampleType.INT24:\n      return 'int24';\n    case TciSampleType.INT32:\n      return 'int32';\n    case TciSampleType.FLOAT32:\n      return 'float32';\n    default:\n      throw new TciError('invalid-frame', `Unsupported TCI sample type: ${sampleType}`);\n  }\n}\n\nexport function normalizeSampleType(sampleType: TciSampleType | TciSampleTypeName | number): TciSampleType {\n  if (typeof sampleType === 'string') {\n    switch (sampleType.toLowerCase()) {\n      case 'int16':\n        return TciSampleType.INT16;\n      case 'int24':\n        return TciSampleType.INT24;\n      case 'int32':\n        return TciSampleType.INT32;\n      case 'float32':\n        return TciSampleType.FLOAT32;\n      default:\n        throw new TciError('invalid-frame', `Unsupported TCI sample type: ${sampleType}`);\n    }\n  }\n  if (sampleType >= TciSampleType.INT16 && sampleType <= TciSampleType.FLOAT32) {\n    return sampleType as TciSampleType;\n  }\n  throw new TciError('invalid-frame', `Unsupported TCI sample type: ${sampleType}`);\n}\n\nexport function normalizeStreamType(streamType: TciStreamType | number): TciStreamType {\n  if (streamType >= TciStreamType.IQ_STREAM && streamType <= TciStreamType.LINEOUT_STREAM) {\n    return streamType as TciStreamType;\n  }\n  throw new TciError('invalid-frame', `Unsupported TCI stream type: ${streamType}`);\n}\n\nexport function payloadToFloat32(frameOrPayload: TciStreamFrame | Buffer | Uint8Array, sampleType?: TciSampleType | TciSampleTypeName): Float32Array {\n  const payload = isFrame(frameOrPayload) ? frameOrPayload.payload : toBuffer(frameOrPayload);\n  const type = isFrame(frameOrPayload) ? frameOrPayload.sampleType : normalizeSampleType(sampleType ?? TciSampleType.FLOAT32);\n  const bytes = sampleTypeBytes(type);\n  if (payload.byteLength % bytes !== 0) {\n    throw new TciError('invalid-frame', 'Payload length is not aligned to sample type');\n  }\n\n  const output = new Float32Array(payload.byteLength / bytes);\n  const view = new DataView(payload.buffer, payload.byteOffset, payload.byteLength);\n  for (let i = 0; i < output.length; i += 1) {\n    const offset = i * bytes;\n    switch (type) {\n      case TciSampleType.INT16:\n        output[i] = view.getInt16(offset, true) / 32768;\n        break;\n      case TciSampleType.INT24:\n        output[i] = readInt24(view, offset) / 8388608;\n        break;\n      case TciSampleType.INT32:\n        output[i] = view.getInt32(offset, true) / 2147483648;\n        break;\n      case TciSampleType.FLOAT32:\n        output[i] = view.getFloat32(offset, true);\n        break;\n    }\n  }\n  return output;\n}\n\nexport function samplesToPayload(samples: Float32Array | readonly number[], sampleType: TciSampleType | TciSampleTypeName): Buffer {\n  const type = normalizeSampleType(sampleType);\n  const bytes = sampleTypeBytes(type);\n  const payload = Buffer.alloc(samples.length * bytes);\n  const view = new DataView(payload.buffer, payload.byteOffset, payload.byteLength);\n  for (let i = 0; i < samples.length; i += 1) {\n    const value = clampSample(samples[i] ?? 0);\n    const offset = i * bytes;\n    switch (type) {\n      case TciSampleType.INT16:\n        view.setInt16(offset, Math.round(value * 32767), true);\n        break;\n      case TciSampleType.INT24:\n        writeInt24(view, offset, Math.round(value * 8388607));\n        break;\n      case TciSampleType.INT32:\n        view.setInt32(offset, Math.round(value * 2147483647), true);\n        break;\n      case TciSampleType.FLOAT32:\n        view.setFloat32(offset, value, true);\n        break;\n    }\n  }\n  return payload;\n}\n\nexport function pcm16ToFloat32(input: Buffer | Uint8Array | Int16Array): Float32Array {\n  if (input instanceof Int16Array) {\n    const output = new Float32Array(input.length);\n    for (let i = 0; i < input.length; i += 1) {\n      output[i] = input[i] / 32768;\n    }\n    return output;\n  }\n  return payloadToFloat32(toBuffer(input), TciSampleType.INT16);\n}\n\nexport function float32ToPcm16(samples: Float32Array | readonly number[]): Buffer {\n  return samplesToPayload(samples, TciSampleType.INT16);\n}\n\nexport function deinterleaveChannels(samples: Float32Array, channels: number): Float32Array[] {\n  if (channels <= 0 || samples.length % channels !== 0) {\n    throw new TciError('invalid-frame', 'Cannot deinterleave samples with invalid channel count');\n  }\n  const frames = samples.length / channels;\n  const outputs = Array.from({ length: channels }, () => new Float32Array(frames));\n  for (let frame = 0; frame < frames; frame += 1) {\n    for (let channel = 0; channel < channels; channel += 1) {\n      outputs[channel][frame] = samples[frame * channels + channel];\n    }\n  }\n  return outputs;\n}\n\nexport function mixToMono(samples: Float32Array, channels: number): Float32Array {\n  if (channels === 1) {\n    return samples;\n  }\n  const separated = deinterleaveChannels(samples, channels);\n  const mono = new Float32Array(separated[0]?.length ?? 0);\n  for (const channel of separated) {\n    for (let i = 0; i < mono.length; i += 1) {\n      mono[i] += channel[i] / channels;\n    }\n  }\n  return mono;\n}\n\nfunction toBuffer(input: Buffer | Uint8Array | ArrayBuffer | ArrayBufferView): Buffer {\n  if (Buffer.isBuffer(input)) {\n    return input;\n  }\n  if (input instanceof ArrayBuffer) {\n    return Buffer.from(input);\n  }\n  if (ArrayBuffer.isView(input)) {\n    return Buffer.from(input.buffer, input.byteOffset, input.byteLength);\n  }\n  return Buffer.from(input);\n}\n\nfunction isFrame(value: unknown): value is TciStreamFrame {\n  return Boolean(value && typeof value === 'object' && 'payload' in value && 'sampleType' in value);\n}\n\nfunction clampSample(value: number): number {\n  if (!Number.isFinite(value)) {\n    return 0;\n  }\n  return Math.max(-1, Math.min(1, value));\n}\n\nfunction readInt24(view: DataView, offset: number): number {\n  const value = view.getUint8(offset) | (view.getUint8(offset + 1) << 8) | (view.getUint8(offset + 2) << 16);\n  return value & 0x800000 ? value | 0xff000000 : value;\n}\n\nfunction writeInt24(view: DataView, offset: number, value: number): void {\n  const clamped = Math.max(-8388608, Math.min(8388607, value));\n  view.setUint8(offset, clamped & 0xff);\n  view.setUint8(offset + 1, (clamped >> 8) & 0xff);\n  view.setUint8(offset + 2, (clamped >> 16) & 0xff);\n}\n"],"mappings":"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","names":["TciStreamType","TciSampleType"]}

package/dist/audio/index.d.cts

@@ -0,0 +1,60 @@
+declare const TCI_STREAM_HEADER_BYTES: number;
+declare enum TciStreamType {
+    IQ_STREAM = 0,
+    RX_AUDIO_STREAM = 1,
+    TX_AUDIO_STREAM = 2,
+    TX_CHRONO = 3,
+    LINEOUT_STREAM = 4
+}
+declare enum TciSampleType {
+    INT16 = 0,
+    INT24 = 1,
+    INT32 = 2,
+    FLOAT32 = 3
+}
+type TciSampleTypeName = 'int16' | 'int24' | 'int32' | 'float32';
+interface TciStreamFrame {
+    receiver: number;
+    sampleRate: number;
+    sampleType: TciSampleType;
+    codec: number;
+    crc: number;
+    /** Byte length of the payload following the 64-byte TCI stream header. */
+    payloadLength: number;
+    streamType: TciStreamType;
+    channels: number;
+    reserved: number[];
+    payload: Buffer;
+    /** Official Stream.length value: number of samples per channel in the payload. */
+    sampleCount: number;
+}
+interface BuildStreamFrameOptions {
+    receiver?: number;
+    sampleRate: number;
+    sampleType: TciSampleType | TciSampleTypeName;
+    streamType: TciStreamType;
+    channels: number;
+    payload?: Buffer | Uint8Array | ArrayBuffer | ArrayBufferView;
+    samples?: Float32Array | readonly number[];
+    codec?: number;
+    crc?: number;
+    reserved?: readonly number[];
+}
+interface BuildTxAudioFrameOptions extends Omit<BuildStreamFrameOptions, 'streamType'> {
+    receiver?: number;
+}
+declare function parseStreamFrame(input: Buffer | ArrayBuffer | ArrayBufferView): TciStreamFrame;
+declare function buildStreamFrame(options: BuildStreamFrameOptions): Buffer;
+declare function buildTxAudioFrame(options: BuildTxAudioFrameOptions): Buffer;
+declare function sampleTypeBytes(sampleType: TciSampleType | TciSampleTypeName): number;
+declare function sampleTypeName(sampleType: TciSampleType): TciSampleTypeName;
+declare function normalizeSampleType(sampleType: TciSampleType | TciSampleTypeName | number): TciSampleType;
+declare function normalizeStreamType(streamType: TciStreamType | number): TciStreamType;
+declare function payloadToFloat32(frameOrPayload: TciStreamFrame | Buffer | Uint8Array, sampleType?: TciSampleType | TciSampleTypeName): Float32Array;
+declare function samplesToPayload(samples: Float32Array | readonly number[], sampleType: TciSampleType | TciSampleTypeName): Buffer;
+declare function pcm16ToFloat32(input: Buffer | Uint8Array | Int16Array): Float32Array;
+declare function float32ToPcm16(samples: Float32Array | readonly number[]): Buffer;
+declare function deinterleaveChannels(samples: Float32Array, channels: number): Float32Array[];
+declare function mixToMono(samples: Float32Array, channels: number): Float32Array;
+
+export { type BuildStreamFrameOptions, type BuildTxAudioFrameOptions, TCI_STREAM_HEADER_BYTES, TciSampleType, type TciSampleTypeName, type TciStreamFrame, TciStreamType, buildStreamFrame, buildTxAudioFrame, deinterleaveChannels, float32ToPcm16, mixToMono, normalizeSampleType, normalizeStreamType, parseStreamFrame, payloadToFloat32, pcm16ToFloat32, sampleTypeBytes, sampleTypeName, samplesToPayload };

package/dist/audio/index.d.ts

@@ -0,0 +1,60 @@
+declare const TCI_STREAM_HEADER_BYTES: number;
+declare enum TciStreamType {
+    IQ_STREAM = 0,
+    RX_AUDIO_STREAM = 1,
+    TX_AUDIO_STREAM = 2,
+    TX_CHRONO = 3,
+    LINEOUT_STREAM = 4
+}
+declare enum TciSampleType {
+    INT16 = 0,
+    INT24 = 1,
+    INT32 = 2,
+    FLOAT32 = 3
+}
+type TciSampleTypeName = 'int16' | 'int24' | 'int32' | 'float32';
+interface TciStreamFrame {
+    receiver: number;
+    sampleRate: number;
+    sampleType: TciSampleType;
+    codec: number;
+    crc: number;
+    /** Byte length of the payload following the 64-byte TCI stream header. */
+    payloadLength: number;
+    streamType: TciStreamType;
+    channels: number;
+    reserved: number[];
+    payload: Buffer;
+    /** Official Stream.length value: number of samples per channel in the payload. */
+    sampleCount: number;
+}
+interface BuildStreamFrameOptions {
+    receiver?: number;
+    sampleRate: number;
+    sampleType: TciSampleType | TciSampleTypeName;
+    streamType: TciStreamType;
+    channels: number;
+    payload?: Buffer | Uint8Array | ArrayBuffer | ArrayBufferView;
+    samples?: Float32Array | readonly number[];
+    codec?: number;
+    crc?: number;
+    reserved?: readonly number[];
+}
+interface BuildTxAudioFrameOptions extends Omit<BuildStreamFrameOptions, 'streamType'> {
+    receiver?: number;
+}
+declare function parseStreamFrame(input: Buffer | ArrayBuffer | ArrayBufferView): TciStreamFrame;
+declare function buildStreamFrame(options: BuildStreamFrameOptions): Buffer;
+declare function buildTxAudioFrame(options: BuildTxAudioFrameOptions): Buffer;
+declare function sampleTypeBytes(sampleType: TciSampleType | TciSampleTypeName): number;
+declare function sampleTypeName(sampleType: TciSampleType): TciSampleTypeName;
+declare function normalizeSampleType(sampleType: TciSampleType | TciSampleTypeName | number): TciSampleType;
+declare function normalizeStreamType(streamType: TciStreamType | number): TciStreamType;
+declare function payloadToFloat32(frameOrPayload: TciStreamFrame | Buffer | Uint8Array, sampleType?: TciSampleType | TciSampleTypeName): Float32Array;
+declare function samplesToPayload(samples: Float32Array | readonly number[], sampleType: TciSampleType | TciSampleTypeName): Buffer;
+declare function pcm16ToFloat32(input: Buffer | Uint8Array | Int16Array): Float32Array;
+declare function float32ToPcm16(samples: Float32Array | readonly number[]): Buffer;
+declare function deinterleaveChannels(samples: Float32Array, channels: number): Float32Array[];
+declare function mixToMono(samples: Float32Array, channels: number): Float32Array;
+
+export { type BuildStreamFrameOptions, type BuildTxAudioFrameOptions, TCI_STREAM_HEADER_BYTES, TciSampleType, type TciSampleTypeName, type TciStreamFrame, TciStreamType, buildStreamFrame, buildTxAudioFrame, deinterleaveChannels, float32ToPcm16, mixToMono, normalizeSampleType, normalizeStreamType, parseStreamFrame, payloadToFloat32, pcm16ToFloat32, sampleTypeBytes, sampleTypeName, samplesToPayload };