diff --git a/src/DataStreamSuite/Bts.DataStream.Websocket/Bts.DataStream.Websocket.csproj b/src/DataStreamSuite/Bts.DataStream.Websocket/Bts.DataStream.Websocket.csproj
new file mode 100644
index 000000000..0b510dd4e
--- /dev/null
+++ b/src/DataStreamSuite/Bts.DataStream.Websocket/Bts.DataStream.Websocket.csproj
@@ -0,0 +1,15 @@
+
+
+
+ net7.0
+ enable
+ enable
+
+
+
+
+
+
+
+
+
diff --git a/src/DataStreamSuite/Bts.DataStream.Websocket/ClientSubscription.cs b/src/DataStreamSuite/Bts.DataStream.Websocket/ClientSubscription.cs
new file mode 100644
index 000000000..53213b07a
--- /dev/null
+++ b/src/DataStreamSuite/Bts.DataStream.Websocket/ClientSubscription.cs
@@ -0,0 +1,9 @@
+namespace Bts.DataStream.Websocket;
+
+class ClientSubscription(WebsocketClientID id, SubscriptionParams @params, IDisposable dispose) : IDisposable {
+ public SubscriptionParams Params => @params;
+ public WebsocketClientID Id => id;
+
+ public void Dispose() =>
+ dispose.Dispose();
+}
diff --git a/src/DataStreamSuite/Bts.DataStream.Websocket/DataSync.cs b/src/DataStreamSuite/Bts.DataStream.Websocket/DataSync.cs
new file mode 100644
index 000000000..8b712fe4a
--- /dev/null
+++ b/src/DataStreamSuite/Bts.DataStream.Websocket/DataSync.cs
@@ -0,0 +1,301 @@
+namespace Bts.DataStream.Websocket;
+
+using BCG;
+
+using bts;
+using bts.api.core;
+using bts.collections;
+
+using Bts.DataStreamExpressions;
+using Bts.Websocket;
+
+using mbts.utils;
+
+using Spark.Core.Disposables;
+using Spark.Core.Json;
+
+using System.Buffers;
+using System.Reactive.Subjects;
+using System.Text;
+using System.Text.Json;
+using System.Text.Json.Nodes;
+
+///
+/// Represents an I/O model (), that accepts websocket
+/// requests (from clients) as input, and emits data/notifications (to clients) as output.
+/// This class's chief role is managing data subscriptions to sparkd on the clients' behalf.
+///
+public class DataSync(JsonSerializerOptions? serializerOpts = null) :
+ ISubject> {
+ protected readonly object lockObj = new();
+ readonly JsonSerializerOptions serializerOpts = serializerOpts ?? JsonSerializerOptions.Default;
+ readonly Dictionary> clients = [];
+
+ event Action>? requestSend;
+
+ public void OnCompleted() =>
+ Log.Api.info("DataSync incoming request stream has completed.");
+
+ public void OnError(Exception error) =>
+ Log.Api.error($"DataSync error: {error}");
+
+ public void OnNext(WebsocketConnectionUpdate value) {
+ switch (value.Type) {
+ case WebsocketConnectionUpdateType.IncomingMessage:
+ onIncomingMessage(value.IncomingMessage);
+ break;
+ case WebsocketConnectionUpdateType.Connect:
+ onConnect(value.Connect);
+ break;
+ case WebsocketConnectionUpdateType.Disconnect:
+ onDisconnect(value.Disconnect);
+ break;
+ default:
+ Log.assert(false, $"Unexpected WebsocketConnectionUpdate type: {value.Type}");
+ break;
+ }
+ }
+
+ public IDisposable Subscribe(IObserver> observer) {
+ lock (lockObj) {
+ requestSend += observer.OnNext;
+ return Disposable.Create(Dispose);
+ }
+ void Dispose() {
+ lock (lockObj) {
+ requestSend -= observer.OnNext;
+ }
+ }
+ }
+
+ static JsonRpcId? extractRpcId(string messageBody) {
+ try {
+ return JsonNode.Parse(messageBody)
+ ?.AsObject()
+ ?.GetValueOrDefault("id")
+ ?.Deserialize();
+ } catch {
+ return null;
+ }
+ }
+
+ static string getRpcNotification(DataPacket dp) {
+ using (var buffer = new MemoryStream())
+ using (var writer = new Utf8JsonWriter(buffer))
+ using (writer.WriteObject()) {
+ writer.WriteString("method", "subscription");
+ using (writer.WriteObject("params")) {
+ writer.Write("tableName", dp.schema.tableName);
+ writer.Write("columns", dp.schema.columnInfo);
+ var cellJsonFactories = dp.schema.columnInfo.Select(getCellJsonFactory).ToList();
+ using (writer.WriteArray("added")) {
+ foreach (IBlueRow row in (dp.addedRows?.Cast()).empty_if_null()) {
+ using (writer.WriteObject()) {
+ for (int i = 0; i < cellJsonFactories.Count; i++) {
+ writer.Write(dp.schema.columnInfo[i].colName, cellJsonFactories[i](row));
+ }
+ }
+ }
+ }
+ using (writer.WriteArray("deleted")) {
+ foreach (IBlueRow row in (dp.deletedRows?.Cast()).empty_if_null()) {
+ using (writer.WriteObject()) {
+ for (int i = 0; i < cellJsonFactories.Count; i++) {
+ writer.Write(dp.schema.columnInfo[i].colName, cellJsonFactories[i](row));
+ }
+ }
+ }
+ }
+ }
+ writer.WriteString("jsonrpc", "2.0");
+ writer.Flush();
+ return Encoding.UTF8.GetString(buffer.ToArray());
+ }
+ }
+
+ static Func getCellJsonFactory(ColumnInfo colInfo) {
+ var t = colInfo.colType;
+ if (t == typeof(int)) {
+ return NullCheckWrapper(v => (int)v);
+ }
+ if (t == typeof(uint)) {
+ return NullCheckWrapper(v => (uint)v);
+ }
+ if (t == typeof(long)) {
+ return NullCheckWrapper(v => (long)v);
+ }
+ if (t == typeof(ulong)) {
+ return NullCheckWrapper(v => (ulong)v);
+ }
+ if (t == typeof(short)) {
+ return NullCheckWrapper(v => (short)v);
+ }
+ if (t == typeof(ushort)) {
+ return NullCheckWrapper(v => (ushort)v);
+ }
+ if (t == typeof(double)) {
+ return NullCheckWrapper(v => (double)v);
+ }
+ if (t == typeof(float)) {
+ return NullCheckWrapper(v => (float)v);
+ }
+ if (t == typeof(bool)) {
+ return NullCheckWrapper(v => (bool)v);
+ }
+ return NullCheckWrapper(v => (string)v);
+
+ Func NullCheckWrapper(Func