@stinkycomputing/sesame-api-client 1.5.0-alpha.1 → 1.5.0-alpha.2

package/dist/sesame-wire-protocol.d.ts

@@ -6,6 +6,7 @@
  */
 import { sesame } from './proto/api';
 export declare const FrameType: typeof sesame.v1.wire.FrameType;
+export declare const DataType: typeof sesame.v1.wire.DataType;
 export type IFrameHeader = sesame.v1.wire.IFrameHeader;
 export declare const FrameHeader: typeof sesame.v1.wire.FrameHeader;
 export type IMediaCodecData = sesame.v1.wire.IMediaCodecData;
@@ -16,6 +17,75 @@ export interface ParsedFrame {
     header: sesame.v1.wire.FrameHeader | null;
     payload: Uint8Array | null;
 }
+/** Strongly-typed discriminated union for decoded FRAME_TYPE_DATA payloads. */
+export type ParsedDataFrame = {
+    dataType: 'json';
+    trackName: string;
+    json: unknown;
+} | {
+    dataType: 'transport-status';
+    trackName: string;
+    event: sesame.v1.status.TransportEvent;
+} | {
+    dataType: 'audio-state';
+    trackName: string;
+    status: sesame.v1.audio.AudioMixerStatus;
+} | {
+    dataType: 'transport-control';
+    trackName: string;
+    request: sesame.v1.sources.TransportControlRequest;
+} | {
+    dataType: 'audio-control';
+    trackName: string;
+    request: sesame.v1.audio.AudioControlRequest;
+};
+/**
+ * Decode a DATA frame into its typed payload.
+ *
+ * Returns `null` if the frame is not a valid `FRAME_TYPE_DATA` frame or if
+ * the payload cannot be decoded.
+ *
+ * @example
+ * ```ts
+ * const frame = WireProtocol.parse(bytes);
+ * const data = parseDataFrame(frame);
+ * if (data?.dataType === 'audio-state') {
+ *   console.log(data.status.vu);
+ * }
+ * ```
+ */
+export declare function parseDataFrame(frame: ParsedFrame): ParsedDataFrame | null;
+/**
+ * Build a ready-to-send wire frame carrying an `AudioControlRequest`.
+ *
+ * Send this over a WebSocket source connection to adjust mixer levels/pan/plugins
+ * on the server. The target mixer is resolved from the server's routing table —
+ * the payload contains no mixer ID.
+ *
+ * @example
+ * ```ts
+ * const bytes = buildAudioControlFrame('my-control-track', {
+ *   channels: [{ channelId: 'ch1', level: 0.8 }]
+ * });
+ * ws.send(bytes);
+ * ```
+ */
+export declare function buildAudioControlFrame(trackName: string, request: sesame.v1.audio.IAudioControlRequest): Uint8Array;
+/**
+ * Build a ready-to-send wire frame carrying a `TransportControlRequest`.
+ *
+ * Send this over a WebSocket source connection to queue a playback command
+ * on the server. The target source is resolved from the server's routing table.
+ *
+ * @example
+ * ```ts
+ * const bytes = buildTransportControlFrame('my-control-track', {
+ *   cmdType: sesame.v1.sources.SourceTransportCommandType.SOURCE_TRANSPORT_COMMAND_PLAY,
+ * });
+ * ws.send(bytes);
+ * ```
+ */
+export declare function buildTransportControlFrame(trackName: string, request: sesame.v1.sources.ITransportControlRequest): Uint8Array;
 export declare class WireProtocol {
     /**
      * Serialize a wire frame: 4-byte LE header_size + protobuf FrameHeader + payload.

package/dist/sesame-wire-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sesame-wire-protocol.d.ts","sourceRoot":"","sources":["../src/sesame-wire-protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,eAAO,MAAM,SAAS,iCAA2B,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;AACvD,eAAO,MAAM,WAAW,mCAA6B,CAAC;AACtD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC;AAC7D,eAAO,MAAM,cAAc,sCAAgC,CAAC;AAC5D,eAAO,MAAM,SAAS,mCAA6B,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5B;AAID,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,UAAU;IAqB9F;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW;CAqB5C"}
+{"version":3,"file":"sesame-wire-protocol.d.ts","sourceRoot":"","sources":["../src/sesame-wire-protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,eAAO,MAAM,SAAS,iCAA2B,CAAC;AAClD,eAAO,MAAM,QAAQ,gCAA0B,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;AACvD,eAAO,MAAM,WAAW,mCAA6B,CAAC;AACtD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC;AAC7D,eAAO,MAAM,cAAc,sCAAgC,CAAC;AAC5D,eAAO,MAAM,SAAS,mCAA6B,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5B;AAMD,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAe,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACpE;IAAE,QAAQ,EAAE,kBAAkB,CAAC;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,cAAc,CAAA;CAAE,GAC7F;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAQ,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAA;CAAE,GAC/F;IAAE,QAAQ,EAAE,mBAAmB,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAA;CAAE,GACzG;IAAE,QAAQ,EAAE,eAAe,CAAC;IAAM,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAA;CAAE,CAAC;AAExG;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,CAkCzE;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,oBAAoB,GAC5C,UAAU,CAOZ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,wBAAwB,GAClD,UAAU,CAOZ;AAID,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,UAAU;IAqB9F;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW;CAqB5C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stinkycomputing/sesame-api-client",
-  "version": "1.5.0-alpha.1",
+  "version": "1.5.0-alpha.2",
   "description": "Sesame API client library with protobuf definitions and command list helpers",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",