@genesislcap/foundation-comms 15.79.2 → 15.80.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/asconfig.json +15 -0
  2. package/assembly/scdb/README.md +74 -0
  3. package/assembly/scdb/bench.mjs +32 -0
  4. package/assembly/scdb/decoder.ts +217 -0
  5. package/assembly/scdb/decoder.wasm +0 -0
  6. package/assembly/scdb/inline-wasm-base64.mjs +24 -0
  7. package/dist/dts/connect/connect.d.ts +2 -0
  8. package/dist/dts/connect/connect.d.ts.map +1 -1
  9. package/dist/dts/connect/http.connect.d.ts +10 -0
  10. package/dist/dts/connect/http.connect.d.ts.map +1 -1
  11. package/dist/dts/connect/message.d.ts +18 -0
  12. package/dist/dts/connect/message.d.ts.map +1 -1
  13. package/dist/dts/connect/scdbStreamDecoder.d.ts +66 -0
  14. package/dist/dts/connect/scdbStreamDecoder.d.ts.map +1 -0
  15. package/dist/dts/connect/socket.d.ts +23 -0
  16. package/dist/dts/connect/socket.d.ts.map +1 -1
  17. package/dist/dts/connect/socket.types.d.ts +14 -0
  18. package/dist/dts/connect/socket.types.d.ts.map +1 -1
  19. package/dist/dts/datasource/datasource.d.ts.map +1 -1
  20. package/dist/dts/datasource/datasource.types.d.ts +8 -0
  21. package/dist/dts/datasource/datasource.types.d.ts.map +1 -1
  22. package/dist/dts/datasource/index.d.ts +1 -0
  23. package/dist/dts/datasource/index.d.ts.map +1 -1
  24. package/dist/dts/datasource/scdb/base64.d.ts +6 -0
  25. package/dist/dts/datasource/scdb/base64.d.ts.map +1 -0
  26. package/dist/dts/datasource/scdb/dictionaryHash.d.ts +40 -0
  27. package/dist/dts/datasource/scdb/dictionaryHash.d.ts.map +1 -0
  28. package/dist/dts/datasource/scdb/index.d.ts +6 -0
  29. package/dist/dts/datasource/scdb/index.d.ts.map +1 -0
  30. package/dist/dts/datasource/scdb/scdb-js-bench.d.mts +2 -0
  31. package/dist/dts/datasource/scdb/scdb-js-bench.d.mts.map +1 -0
  32. package/dist/dts/datasource/scdb/scdbDecode.d.ts +24 -0
  33. package/dist/dts/datasource/scdb/scdbDecode.d.ts.map +1 -0
  34. package/dist/dts/datasource/scdb/scdbDecoder.d.ts +42 -0
  35. package/dist/dts/datasource/scdb/scdbDecoder.d.ts.map +1 -0
  36. package/dist/dts/datasource/scdb/scdbWasmDecoder.d.ts +27 -0
  37. package/dist/dts/datasource/scdb/scdbWasmDecoder.d.ts.map +1 -0
  38. package/dist/dts/datasource/scdb/scdbjDecoder.d.ts +35 -0
  39. package/dist/dts/datasource/scdb/scdbjDecoder.d.ts.map +1 -0
  40. package/dist/dts/datasource/scdb/wasm/decoder.wasm.base64.d.ts +7 -0
  41. package/dist/dts/datasource/scdb/wasm/decoder.wasm.base64.d.ts.map +1 -0
  42. package/dist/dts/testing/mocks/connect/socket.d.ts +1 -0
  43. package/dist/dts/testing/mocks/connect/socket.d.ts.map +1 -1
  44. package/dist/esm/connect/connect.js +22 -3
  45. package/dist/esm/connect/http.connect.js +33 -1
  46. package/dist/esm/connect/message.js +3 -1
  47. package/dist/esm/connect/scdbStreamDecoder.js +160 -0
  48. package/dist/esm/connect/socket.js +72 -2
  49. package/dist/esm/datasource/datasource.js +3 -0
  50. package/dist/esm/datasource/index.js +1 -0
  51. package/dist/esm/datasource/scdb/base64.js +17 -0
  52. package/dist/esm/datasource/scdb/dictionaryHash.js +45 -0
  53. package/dist/esm/datasource/scdb/index.js +5 -0
  54. package/dist/esm/datasource/scdb/scdb-golden-v1.json +15 -0
  55. package/dist/esm/datasource/scdb/scdb-js-bench.mjs +461 -0
  56. package/dist/esm/datasource/scdb/scdbDecode.js +67 -0
  57. package/dist/esm/datasource/scdb/scdbDecoder.js +279 -0
  58. package/dist/esm/datasource/scdb/scdbWasmDecoder.js +213 -0
  59. package/dist/esm/datasource/scdb/scdbjDecoder.js +60 -0
  60. package/dist/esm/datasource/scdb/wasm/decoder.wasm.base64.js +6 -0
  61. package/dist/esm/testing/mocks/connect/socket.js +3 -0
  62. package/dist/foundation-comms.api.json +1453 -8
  63. package/dist/foundation-comms.d.ts +251 -0
  64. package/package.json +14 -12
@@ -95,6 +95,11 @@ export interface Socket extends Omit<SocketStatus, 'serialize' | 'onClose' | 're
95
95
  */
96
96
  sendForStreamWithoutTeardown<T>(message: Message<T | any>, onMessage: Function, onError: Function): Observable<Message>;
97
97
  socketMessages(): SocketSubject<Message>;
98
+ /**
99
+ * Wires a metadata-refresh hook for the SCDB columnar decoder, used to fetch a resource's missing
100
+ * or stale metadata (e.g. `getMetadata(r, false)`).
101
+ */
102
+ setScdbMetadataRefresher?(refresher: (resourceName: string) => void | Promise<unknown>): void;
98
103
  host: string;
99
104
  }
100
105
  /**
@@ -118,7 +123,10 @@ export declare class DefaultSocket implements Socket {
118
123
  private websocket;
119
124
  private wsMessages;
120
125
  private wsMessageHandlers;
126
+ private _scdbDecoder;
127
+ private scdbWasmRequested;
121
128
  http: Http;
129
+ private metaCache;
122
130
  get isConfigured(): boolean;
123
131
  get isConnecting(): boolean;
124
132
  get isConnected(): boolean;
@@ -144,6 +152,8 @@ export declare class DefaultSocket implements Socket {
144
152
  * Temp putting the user in place to bridge the hasValidSession logic.
145
153
  */
146
154
  user: User, config: ConnectConfig);
155
+ /** Makes SCDB columnar payloads transparent (no-op unless an encoding was negotiated). */
156
+ private get scdbDecoder();
147
157
  private get heartbeatLoggingIsEnabled();
148
158
  private get messageLoggingIsEnabled();
149
159
  connect(host?: string, connectOptions?: SocketConnectOptions, reconnectOptions?: SocketReconnectOptions): Promise<boolean>;
@@ -176,6 +186,19 @@ export declare class DefaultSocket implements Socket {
176
186
  private setMessageHandler;
177
187
  private sendDataLogoff;
178
188
  private removeMessageHandler;
189
+ /**
190
+ * Wires the SCDB decoder's metadata-refresh hook, used to fetch a resource's missing or stale
191
+ * metadata. The host passes a force-refresh, e.g. `Connect.getMetadata(resource, false)`.
192
+ */
193
+ setScdbMetadataRefresher(refresher: (resourceName: string) => void | Promise<unknown>): void;
194
+ /**
195
+ * Loads the bundled WASM decoder for the `SCDB_V1` binary encoding once (lazy, idempotent). Called
196
+ * eagerly when the app-wide `dataserverEncoding` is binary, and on demand the first time a binary
197
+ * payload is seen (so a per-datasource/grid `encoding: 'SCDB_V1'` also gets the fast-path, not just
198
+ * the app-wide opt-in). On any failure (no WebAssembly, CSP, SSR) we silently keep the pure-JS
199
+ * decoder — output is identical.
200
+ */
201
+ private ensureScdbWasm;
179
202
  private getMessageHandler;
180
203
  private logMessageTypeFlow;
181
204
  }
@@ -1 +1 @@
1
- {"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/connect/socket.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/connect/socket.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,5 @@
1
1
  import type { Observer } from 'rxjs';
2
+ import type { ScdbEncoding } from '../datasource/scdb';
2
3
  import type { Message, PingMessage, PongMessage } from './message';
3
4
  /**
4
5
  * The Socket connection options definition.
@@ -54,5 +55,18 @@ export type SocketConnectOptions = {
54
55
  * The path to a proxy server to use for the connection.
55
56
  */
56
57
  proxyPath?: string;
58
+ /**
59
+ * Opt in to a columnar dataserver payload encoding for all DATA_LOGON subscriptions, negotiated
60
+ * transparently — every consumer (grids, React wrappers, FAST components, custom datasources)
61
+ * benefits with no code change, since request + decode happen in this comms layer.
62
+ *
63
+ * - `'SCDBJ_V1'` — JSON-columnar: ~2x smaller, decoded with native JSON.parse + transpose. No
64
+ * extra runtime; works in every bundler and SSR. Recommended default.
65
+ * - `'SCDB_V1'` — binary blob: ~3x smaller and ~1.5–2.5x faster to decode via the bundled WASM
66
+ * decoder (falls back to a pure-JS decoder if WebAssembly is unavailable).
67
+ *
68
+ * Undefined (default) keeps the legacy row encoding. Old servers ignore it and send rows.
69
+ */
70
+ dataserverEncoding?: ScdbEncoding;
57
71
  };
58
72
  //# sourceMappingURL=socket.types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"socket.types.d.ts","sourceRoot":"","sources":["../../../src/connect/socket.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEpC;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACvD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACvD;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}
1
+ {"version":3,"file":"socket.types.d.ts","sourceRoot":"","sources":["../../../src/connect/socket.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEpC;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACvD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACvD;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,YAAY,CAAC;CACnC,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"datasource.d.ts","sourceRoot":"","sources":["../../../src/datasource/datasource.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"datasource.d.ts","sourceRoot":"","sources":["../../../src/datasource/datasource.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EACL,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,aAAa,EACb,wBAAwB,EACxB,WAAW,EACX,cAAc,EAEd,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAA2B,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,aAAa,EAAE,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,cAAc,EAAE,CAAC;IACzC,QAAQ,CAAC,mBAAmB,EAAE,cAAc,EAAE,CAAC;IAC/C,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAW,SAAQ,kBAAkB;IACpD;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAElC;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,YAAY,EAAE,YAAY,CAAC;IAE3B;;;OAGG;IACH,MAAM,EAAE,gBAAgB,CAAC,wBAAwB,GAAG,mBAAmB,CAAC,CAAC;IAEzE;;;;OAIG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjD;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/F;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;;;;OAKG;IACH,WAAW,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IAElE;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,UAAU,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;;;OAKG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAE3C;;;;OAIG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAEhC;;;;;;;OAOG;IACH,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;;;OAKG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;OAKG;IACH,UAAU,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExC;;;;;OAKG;IACH,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;;OAGG;IACH,oBAAoB,EAAE,gBAAgB,CAAC;IAEvC;;;OAGG;IACH,iBAAiB,EAAE,aAAa,CAAC;IAEjC;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,UAAU;IAuDvC,SAAS,CAAC,OAAO,EAAE,OAAO;IAC7B,SAAS,CAAC,IAAI,EAAE,IAAI;IACR,SAAS,CAAC,SAAS,EAAE,gBAAgB;IACrC,SAAS,CAAC,MAAM,EAAE,gBAAgB;IACrC,SAAS,CAAC,aAAa,EAAE,aAAa;IA1DvD;;OAEG;IACS,MAAM,EAAE,gBAAgB,CAAC;IAErC,6DAA6D;IACjD,qBAAqB,UAAQ;IAEzC,2DAA2D;IAC/C,mBAAmB,UAAQ;IAEvC,wDAAwD;IAC5C,gBAAgB,EAAE,cAAc,EAAE,CAAM;IAEpD,qDAAqD;IACzC,aAAa,EAAE,aAAa,EAAE,CAAM;IAEhD,qDAAqD;IACzC,aAAa,EAAE,cAAc,EAAE,CAAM;IAEjD,2DAA2D;IAC/C,mBAAmB,EAAE,cAAc,EAAE,CAAM;IAEvD,wDAAwD;IAC5C,gBAAgB,EAAE,WAAW,EAAE,CAAM;IAEjD,+DAA+D;IACnD,uBAAuB,EAAE,MAAM,EAAE,CAAM;IAEnD,+DAA+D;IACnD,uBAAuB,EAAE,MAAM,EAAE,CAAM;IAEnD,2DAA2D;IAC/C,mBAAmB,EAAE,OAAO,CAAS;IAEjD,6EAA6E;IACjE,aAAa,EAAE,MAAM,CAAK;IAEtC,2CAA2C;IAC3C,IAAI,WAAW,YAEd;IAGM,QAAQ,UAAQ;IAEvB,SAAS,CAAC,OAAO,EAAE,iBAAiB,CAAC;IAC9B,YAAY,EAAE,YAAY,CAAC;IAEtB,MAAM,EAAE,gBAAgB,CAAC,wBAAwB,GAAG,mBAAmB,CAAC,CAAC;IAErF,OAAO,CAAC,UAAU,CAAoB;gBAGjB,OAAO,EAAE,OAAO,EACnB,IAAI,EAAE,IAAI,EACE,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,gBAAgB,EAC3B,aAAa,EAAE,aAAa;IAGvD,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,yBAAyB,CAAC,CAAa;IAE/C,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAW1C,IAAI,CACR,OAAO,EAAE,iBAAiB,EAC1B,SAAS,GAAE,OAAoC,EAC/C,WAAW,GAAE,OAAkC,GAC9C,OAAO,CAAC,OAAO,CAAC;IA2Db,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,uCAAuC;IACvC,OAAO;IAyBP;;OAEG;IACH,IAAI,iBAAiB,IAAI,gBAAgB,GAAG,aAAa,CA6CxD;IAED;;OAEG;IACH,IAAI,oBAAoB,IAAI,gBAAgB,CAY3C;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,aAAa,CAerC;IAED;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlC,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBhD,gBAAgB,CAAC,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAYnD,YAAY;YAeZ,sBAAsB;IAapC,OAAO,CAAC,kBAAkB;cA8CV,qBAAqB,CAAC,YAAY,EAAE,MAAM;IA8B1D;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAa7D;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB;IAa9E,OAAO,CAAC,eAAe;CAGxB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,kEAAwE,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAE1C"}
@@ -1,4 +1,5 @@
1
1
  import type { FieldMetadata } from '../metadata/metadata.types';
2
+ import type { ScdbEncoding } from './scdb';
2
3
  /**
3
4
  * Types of Genesis resources.
4
5
  * @public
@@ -93,6 +94,13 @@ export interface DatasourceOptions {
93
94
  * @remarks Only works with DATASERVER resources.
94
95
  */
95
96
  reverse?: boolean;
97
+ /**
98
+ * Per-datasource columnar payload encoding, overriding the app-wide
99
+ * `ConnectConfig.connect.dataserverEncoding`. `'SCDBJ_V1'` (JSON-columnar) or `'SCDB_V1'` (binary).
100
+ * Negotiated + decoded transparently. Undefined => use the app-wide setting (or row mode).
101
+ * @remarks Only works with DATASERVER resources.
102
+ */
103
+ encoding?: ScdbEncoding;
96
104
  /**
97
105
  * Whether to disable polling when using request/reply
98
106
  * @remarks Only works with REQUEST_SERVER resources, which have no stream and so poll for
@@ -1 +1 @@
1
- {"version":3,"file":"datasource.types.d.ts","sourceRoot":"","sources":["../../../src/datasource/datasource.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;GAGG;AACH,oBAAY,YAAY;IACtB,UAAU,eAAe;IACzB,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C;;OAEG;IACH,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ;;OAEG;IACH,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAGhC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAIpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAIlB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,GAAG,CAAC;IACd;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC"}
1
+ {"version":3,"file":"datasource.types.d.ts","sourceRoot":"","sources":["../../../src/datasource/datasource.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C;;;GAGG;AACH,oBAAY,YAAY;IACtB,UAAU,eAAe;IACzB,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C;;OAEG;IACH,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ;;OAEG;IACH,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAGhC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAIpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IAIxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,GAAG,CAAC;IACd;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC"}
@@ -7,4 +7,5 @@ export * from './datasource';
7
7
  export * from './datasource.types';
8
8
  export * from './entityDatasource';
9
9
  export * from './normaliseCriteria';
10
+ export * from './scdb';
10
11
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/datasource/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/datasource/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,QAAQ,CAAC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Decodes a base64 string to bytes in both browser (`atob`) and Node/SSR (`Buffer`) runtimes.
3
+ * The SCDB `RBUF` payload (over JSON transports) and the inlined wasm module both arrive as base64.
4
+ */
5
+ export declare function base64ToBytes(b64: string): Uint8Array<ArrayBuffer>;
6
+ //# sourceMappingURL=base64.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../../../src/datasource/scdb/base64.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAUlE"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Dictionary derivation + fingerprinting for the metadata-driven dictionary mechanism.
3
+ *
4
+ * The server no longer ships the column dictionary; instead the client derives it from the resource
5
+ * metadata it already holds (`id = index` into the ordered field list) and validates it against a
6
+ * small hash the server sends with the columnar payload. A columnar message that fails validation
7
+ * is not decoded.
8
+ */
9
+ /**
10
+ * FNV-1a 32-bit hash of the field names joined by '\n', as lowercase 8-char hex. MUST match the
11
+ * Kotlin `ColumnDictionary.contentHash` in genesis-columnar (cross-language vector:
12
+ * ['QUANTITY','PRICE','SYMBOL'] -> '40e6db4f').
13
+ *
14
+ * Hashes UTF-16 code units (`charCodeAt`), matching Kotlin's `Char.code` — NOT the UTF-8 bytes used for
15
+ * on-wire strings. Field names are ASCII in practice so the two coincide; keep both ends on UTF-16 units
16
+ * (do not switch to UTF-8 bytes) or a non-ASCII field name would hash differently across languages.
17
+ */
18
+ export declare function dictionaryHash(fieldNames: readonly string[]): string;
19
+ /** Minimal shape of the cached resource metadata fields we need. */
20
+ interface FieldLike {
21
+ NAME: string;
22
+ }
23
+ /**
24
+ * Ordered field-name list (the SCDB dictionary) for a resource, from its metadata. The order MUST
25
+ * match the server's, which derives the dictionary per resource type: a DATASERVER hashes its `FIELD`
26
+ * list, a REQUEST_SERVER its `REPLY_FIELD` (⇒ `REPLY.FIELD`) list. Selecting by `TYPE` — rather than
27
+ * "first non-null" — matters because a metadata object can legitimately carry BOTH `FIELD` and
28
+ * `REPLY_FIELD`; picking the wrong one yields a hash that never matches the server's `DICT_HASH`, so
29
+ * no columnar message for that resource can be decoded. Falls back to a lenient scan for unknown types.
30
+ */
31
+ export declare function dictionaryFromMetadata(metadata: {
32
+ TYPE?: string;
33
+ FIELD?: FieldLike[];
34
+ REPLY_FIELD?: FieldLike[];
35
+ REPLY?: {
36
+ FIELD?: FieldLike[];
37
+ };
38
+ }): string[];
39
+ export {};
40
+ //# sourceMappingURL=dictionaryHash.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dictionaryHash.d.ts","sourceRoot":"","sources":["../../../../src/datasource/scdb/dictionaryHash.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAQpE;AAED,oEAAoE;AACpE,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;CACjC,GAAG,MAAM,EAAE,CASX"}
@@ -0,0 +1,6 @@
1
+ export * from './dictionaryHash';
2
+ export * from './scdbDecoder';
3
+ export * from './scdbjDecoder';
4
+ export * from './scdbWasmDecoder';
5
+ export * from './scdbDecode';
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/datasource/scdb/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=scdb-js-bench.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scdb-js-bench.d.mts","sourceRoot":"","sources":["../../../../src/datasource/scdb/scdb-js-bench.mjs"],"names":[],"mappings":""}
@@ -0,0 +1,24 @@
1
+ import { ScdbjPayload } from './scdbjDecoder';
2
+ import type { ScdbWasm } from './scdbWasmDecoder';
3
+ /** The columnar wire encodings a client can negotiate via `DETAILS.ENCODING` (absent = legacy row mode). */
4
+ export type ScdbEncoding = 'SCDB_V1' | 'SCDBJ_V1';
5
+ export interface ColumnarQueryUpdate {
6
+ ENCODING?: string;
7
+ ROW?: Array<Record<string, unknown>>;
8
+ RBUF?: Uint8Array | string | number[];
9
+ SCDBJ?: ScdbjPayload;
10
+ }
11
+ /**
12
+ * Decodes a QUERY_UPDATE to row objects. Chooses by `ENCODING`:
13
+ * - `SCDB_V1` -> binary blob: WASM decoder when provided (fastest), else pure-JS.
14
+ * - `SCDBJ_V1` -> JSON-columnar transpose.
15
+ * - otherwise -> the message's existing `ROW` array (legacy).
16
+ */
17
+ export declare function decodeColumnarQueryUpdate(msg: ColumnarQueryUpdate, dictionary: readonly string[], wasm?: ScdbWasm): Array<Record<string, unknown>>;
18
+ /**
19
+ * Decodes a self-describing columnar req/rep reply (dictionary inline) into plain result rows
20
+ * (cells only, no synthetic `DETAILS`). req/rep replies are full result sets, so unlike a dataserver
21
+ * `QUERY_UPDATE` they carry no per-row operation / rowRef.
22
+ */
23
+ export declare function decodeColumnarReply(msg: ColumnarQueryUpdate, dictionary: readonly string[]): Array<Record<string, unknown>>;
24
+ //# sourceMappingURL=scdbDecode.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scdbDecode.d.ts","sourceRoot":"","sources":["../../../../src/datasource/scdb/scdbDecode.ts"],"names":[],"mappings":"AAcA,OAAO,EAAyC,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,4GAA4G;AAC5G,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;IACtC,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,mBAAmB,EACxB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,IAAI,CAAC,EAAE,QAAQ,GACd,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAWhC;AAUD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,mBAAmB,EACxB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAYhC"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * SCDB v1 (Sparse Columnar Delta Block) decoder.
3
+ *
4
+ * Decodes the binary `RBUF` payload that a Genesis dataserver sends when a client negotiates
5
+ * `DETAILS.ENCODING = SCDB_V1`. The wire format is defined, language-neutrally, in the server repo
6
+ * at `genesis-columnar/docs/scdb-v1.md` and is pinned by the shared golden vectors in
7
+ * `scdb-golden-v1.json` (this directory). The Kotlin `ScdbReader` is the reference implementation;
8
+ * this decoder must stay byte-for-byte compatible with it.
9
+ *
10
+ * Performance notes (see scdb-js-bench.mjs):
11
+ * - single pass straight into the output objects — no per-column intermediate arrays;
12
+ * - dense columns (flagged by the encoder) skip the presence bitmap and the per-row presence test;
13
+ * - varints decode in Number space (exact for |v| < 2^53), using BigInt only past 49 bits;
14
+ * - strings take a manual ASCII fast-path (TextDecoder has a fixed per-call overhead).
15
+ *
16
+ * Browser contract:
17
+ * - operates over the `Uint8Array` the existing msgpack envelope decoder already produces for `RBUF`;
18
+ * - `ROW_REF` decodes to a `string` (sent as decimal text) — matches the existing contract, no BigInt;
19
+ * - 64-bit LONG *values* decode to `number` when safe, else `bigint` (the customNumberParser rule).
20
+ */
21
+ export type ScdbOperation = 'INSERT' | 'MODIFY' | 'DELETE';
22
+ /** A decoded delta row. `cells` contains only changed fields; an explicit `null` is change-to-null. */
23
+ export interface ScdbRecord {
24
+ rowRef: string;
25
+ operation: ScdbOperation;
26
+ cells: Record<string, unknown>;
27
+ }
28
+ /**
29
+ * Decodes an SCDB `RBUF` blob into delta records, using the column dictionary (ordered field-name
30
+ * list) the client derives from the resource's metadata and validates against the server's
31
+ * `DICT_HASH`. Each record's `cells` is a fresh target object passed to [decodeColumns].
32
+ */
33
+ export declare function decodeScdb(bytes: Uint8Array, dictionary: readonly string[]): ScdbRecord[];
34
+ /**
35
+ * Reconstructs the legacy `ROW` array shape directly (the hot path used in the live socket flow):
36
+ * `[{ ...cells, DETAILS: { OPERATION, ROW_REF } }]`. Builds straight into the row objects with no
37
+ * intermediate record/cells allocation.
38
+ */
39
+ export declare function decodeScdbToRows(bytes: Uint8Array, dictionary: readonly string[]): Array<Record<string, unknown>>;
40
+ /** @internal */
41
+ export declare function assertScdbMagic(bytes: Uint8Array): void;
42
+ //# sourceMappingURL=scdbDecoder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scdbDecoder.d.ts","sourceRoot":"","sources":["../../../../src/datasource/scdb/scdbDecoder.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D,uGAAuG;AACvG,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAqHD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,EAAE,CAezF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAYhC;AAED,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAIvD"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * WASM fast-path decoder for the binary SCDB (`SCDB_V1`) payload.
3
+ *
4
+ * Instantiates the AssemblyScript decoder (`wasm/decoder.wasm`), which parses the binary blob at
5
+ * near-native speed into a columnar result in linear memory; this module then assembles the legacy
6
+ * `ROW` array of objects that ag-Grid consumes. Measured ~1.5x faster than native `JSON.parse` on a
7
+ * full snapshot and ~2.5x on deltas, while the payload stays ~3x smaller on the wire. See
8
+ * `wasm/README.md` and the benchmark for numbers.
9
+ *
10
+ * If wasm is unavailable (or instantiation fails), callers fall back to the pure-JS `decodeScdbToRows`
11
+ * from `scdbDecoder.ts` — same output, no toolchain.
12
+ */
13
+ export interface ScdbWasm {
14
+ decodeToRows(blob: Uint8Array, dictionary: readonly string[]): Array<Record<string, unknown>>;
15
+ }
16
+ /**
17
+ * Lazily instantiates (once) the bundled decoder from inlined base64 — no asset/fetch config, works
18
+ * in any bundler and SSR. This is what the socket layer uses for the `SCDB_V1` fast-path. Rejects if
19
+ * WebAssembly is unavailable; callers fall back to the pure-JS decoder.
20
+ */
21
+ export declare function getDefaultScdbWasm(): Promise<ScdbWasm>;
22
+ /**
23
+ * Instantiates the decoder. Defaults to the inlined `decoder.wasm`; pass your own bytes (bundler
24
+ * import / fetch / fs.readFile) to override. Returns an object whose `decodeToRows` is synchronous.
25
+ */
26
+ export declare function initScdbWasm(wasmBytes?: BufferSource): Promise<ScdbWasm>;
27
+ //# sourceMappingURL=scdbWasmDecoder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scdbWasmDecoder.d.ts","sourceRoot":"","sources":["../../../../src/datasource/scdb/scdbWasmDecoder.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAgBH,MAAM,WAAW,QAAQ;IACvB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC/F;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAGtD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,SAAS,GAAE,YAAsD,GAChE,OAAO,CAAC,QAAQ,CAAC,CA8CnB"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * SCDBJ (JSON-columnar) decoder.
3
+ *
4
+ * The no-WASM peer of the binary `scdbDecoder`. The server sends a `QUERY_UPDATE` whose payload is a
5
+ * plain JSON object (decoded for free by the existing envelope `JSON.parse`); this transposes it back
6
+ * into the legacy `ROW` array of row objects that ag-Grid consumes. Because native `JSON.parse` does
7
+ * the bulk work and only the transpose is JS, this is at parity with row-JSON on a full snapshot and
8
+ * faster on deltas, while being ~2x smaller on the wire (no repeated field-name keys).
9
+ *
10
+ * Wire shape (short keys; see genesis-columnar/docs/scdb-v1.md):
11
+ * { n, r:[rowRef strings], o: opCode | [opCodes], c:[ { i:colId, x?:[presentIdx], v:[values] } ] }
12
+ * `x` omitted => dense column. Values are aligned to the present cells; a `null` entry is an explicit
13
+ * change-to-null. Column ids index the metadata-derived dictionary.
14
+ */
15
+ export interface ScdbjPayload {
16
+ n: number;
17
+ r: string[];
18
+ o: number | number[];
19
+ c: Array<{
20
+ i: number;
21
+ x?: number[];
22
+ v: unknown[];
23
+ }>;
24
+ }
25
+ /**
26
+ * Transposes a parsed SCDBJ payload into the legacy dataserver ROW shape:
27
+ * `[{ ...cells, DETAILS: { OPERATION, ROW_REF } }]`, using the column dictionary.
28
+ */
29
+ export declare function decodeScdbjToRows(payload: ScdbjPayload, dictionary: readonly string[]): Array<Record<string, unknown>>;
30
+ /**
31
+ * Transposes a parsed SCDBJ payload into plain result rows (cells only, no `DETAILS`). Used for
32
+ * req/rep replies, which are full result sets without per-row operation / rowRef semantics.
33
+ */
34
+ export declare function decodeScdbjToCells(payload: ScdbjPayload, dictionary: readonly string[]): Array<Record<string, unknown>>;
35
+ //# sourceMappingURL=scdbjDecoder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scdbjDecoder.d.ts","sourceRoot":"","sources":["../../../../src/datasource/scdb/scdbjDecoder.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAMH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACrB,CAAC,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;CACrD;AAsBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAahC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAIhC"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * The SCDB decoder `decoder.wasm` inlined as base64 so it loads in any bundler/runtime
3
+ * (webpack, Vite, Next, esbuild, SSR) with no asset-resolution or fetch config.
4
+ * Generated from assembly/scdb/decoder.ts — do not edit by hand; run `npm run build:wasm`.
5
+ */
6
+ export declare const SCDB_DECODER_WASM_BASE64 = "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";
7
+ //# sourceMappingURL=decoder.wasm.base64.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decoder.wasm.base64.d.ts","sourceRoot":"","sources":["../../../../../src/datasource/scdb/wasm/decoder.wasm.base64.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,yrGACmpG,CAAC"}
@@ -22,6 +22,7 @@ export declare class SocketMock implements Socket {
22
22
  sendForStream<T>(message: Message<any>, onMessage: Function, onError: Function, onComplete?: Function): Observable<Message>;
23
23
  sendForStreamWithoutTeardown<T>(message: Message<any>, onMessage: Function, onError: Function): Observable<Message>;
24
24
  socketMessages(): SocketSubject<Message>;
25
+ setScdbMetadataRefresher(): void;
25
26
  reset(): void;
26
27
  }
27
28
  //# sourceMappingURL=socket.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../../../src/testing/mocks/connect/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAQ,UAAU,EAAE,MAAM,MAAM,CAAC;AACzD,OAAO,KAAK,EACV,OAAO,EACP,MAAM,EACN,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;GAEG;AACH,qBAAa,UAAW,YAAW,MAAM;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,eAAe,CAAC,OAAO,CAAC,CAA6B;IACzE,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,MAAM,CAAe;IAE3B,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB,yBAAgC;IAErD,OAAO,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,oBAAoB,EAC9B,gBAAgB,CAAC,EAAE,sBAAsB,GACxC,OAAO,CAAC,OAAO,CAAC;IAKZ,UAAU,IAAI,IAAI;IAElB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;IAItD,aAAa,CAAC,CAAC,EACpB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,EACjB,UAAU,CAAC,EAAE,QAAQ,GACpB,UAAU,CAAC,OAAO,CAAC;IAItB,4BAA4B,CAAC,CAAC,EAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,GAChB,UAAU,CAAC,OAAO,CAAC;IAIf,cAAc,IAAI,aAAa,CAAC,OAAO,CAAC;IAI/C,KAAK,IAAI,IAAI;CAGd"}
1
+ {"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../../../src/testing/mocks/connect/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAQ,UAAU,EAAE,MAAM,MAAM,CAAC;AACzD,OAAO,KAAK,EACV,OAAO,EACP,MAAM,EACN,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;GAEG;AACH,qBAAa,UAAW,YAAW,MAAM;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,eAAe,CAAC,OAAO,CAAC,CAA6B;IACzE,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,MAAM,CAAe;IAE3B,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB,yBAAgC;IAErD,OAAO,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,oBAAoB,EAC9B,gBAAgB,CAAC,EAAE,sBAAsB,GACxC,OAAO,CAAC,OAAO,CAAC;IAKZ,UAAU,IAAI,IAAI;IAElB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;IAItD,aAAa,CAAC,CAAC,EACpB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,EACjB,UAAU,CAAC,EAAE,QAAQ,GACpB,UAAU,CAAC,OAAO,CAAC;IAItB,4BAA4B,CAAC,CAAC,EAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,GAChB,UAAU,CAAC,OAAO,CAAC;IAIf,cAAc,IAAI,aAAa,CAAC,OAAO,CAAC;IAIxC,wBAAwB,IAAI,IAAI;IAIvC,KAAK,IAAI,IAAI;CAGd"}
@@ -11,6 +11,7 @@ import { ConnectConfig } from './connect.types';
11
11
  import { HttpConnect } from './http.connect';
12
12
  import { HttpTransport } from './httpTransport';
13
13
  import { buildRequestCacheKey, EventMessageType, MessageBuilder, } from './message';
14
+ import { resourceNameOf, ScdbStreamDecoder } from './scdbStreamDecoder';
14
15
  import { Socket } from './socket';
15
16
  import { updateState } from './updateState';
16
17
  /**
@@ -32,6 +33,7 @@ let DefaultConnect = class DefaultConnect {
32
33
  return this.socket.host;
33
34
  }
34
35
  constructor(socket, messageBuilder, metaCache, events, config, transport) {
36
+ var _a, _b, _c;
35
37
  this.socket = socket;
36
38
  this.messageBuilder = messageBuilder;
37
39
  this.metaCache = metaCache;
@@ -40,6 +42,16 @@ let DefaultConnect = class DefaultConnect {
40
42
  this.transport = transport;
41
43
  this.isWorking = false;
42
44
  this.inFlightRequests = new Map();
45
+ // One app-level flag opts every dataserver subscription into a columnar encoding, negotiated
46
+ // transparently. Request side here; the decode side is handled in the socket.
47
+ const encoding = (_a = this.config.connect) === null || _a === void 0 ? void 0 : _a.dataserverEncoding;
48
+ if (encoding) {
49
+ this.messageBuilder.scdbEncoding = encoding;
50
+ }
51
+ this.httpScdbDecoder = new ScdbStreamDecoder(this.metaCache);
52
+ const refresh = (resourceName) => this.getMetadata(resourceName, false);
53
+ (_c = (_b = this.socket).setScdbMetadataRefresher) === null || _c === void 0 ? void 0 : _c.call(_b, refresh);
54
+ this.httpScdbDecoder.setMetadataRefresher(refresh);
43
55
  }
44
56
  httpMode() {
45
57
  return false;
@@ -61,6 +73,15 @@ let DefaultConnect = class DefaultConnect {
61
73
  get httpHost() {
62
74
  return this.transport.toHttpHost(this.socket.host);
63
75
  }
76
+ requestOverHttp(requestMessage) {
77
+ return __awaiter(this, void 0, void 0, function* () {
78
+ const resourceName = resourceNameOf(requestMessage);
79
+ this.httpScdbDecoder.prepareRequest(requestMessage);
80
+ const response = yield this.transport.requestServer(this.httpHost, requestMessage);
81
+ this.httpScdbDecoder.onMessage(response, resourceName);
82
+ return response;
83
+ });
84
+ }
64
85
  /**
65
86
  * Sends an event/commit or metadata-style message, routing it over HTTP (POST) when
66
87
  * `useHttpReqRep` is active and falling back to the WebSocket otherwise.
@@ -233,9 +254,7 @@ let DefaultConnect = class DefaultConnect {
233
254
  logger.debug(`${requestMessage.MESSAGE_TYPE} (request server) message created -> `, requestMessage);
234
255
  // REQUEST_SERVER messages go out as a GET (query-string encoded) over HTTP, mirroring the
235
256
  // HTTP-only Connect, otherwise they travel over the socket.
236
- const promise = (this.useHttpReqRep
237
- ? this.transport.requestServer(this.httpHost, requestMessage)
238
- : this.socket.send(requestMessage)).finally(() => {
257
+ const promise = (this.useHttpReqRep ? this.requestOverHttp(requestMessage) : this.socket.send(requestMessage)).finally(() => {
239
258
  this.inFlightRequests.delete(cacheKey);
240
259
  });
241
260
  this.inFlightRequests.set(cacheKey, promise);
@@ -12,6 +12,7 @@ import { Http } from './http';
12
12
  import { HttpConnectConfig } from './http.connect.types';
13
13
  import { HttpTransport } from './httpTransport';
14
14
  import { buildRequestCacheKey, EventMessageType, MessageBuilder, MessageType, } from './message';
15
+ import { resourceNameOf, ScdbStreamDecoder } from './scdbStreamDecoder';
15
16
  import { SessionRefreshResult, tryRefreshSession } from './sessionRefresh';
16
17
  import { updateState } from './updateState';
17
18
  /**
@@ -50,11 +51,15 @@ let DefaultHttpConnect = DefaultHttpConnect_1 = class DefaultHttpConnect {
50
51
  */
51
52
  this.streams = new Map();
52
53
  this.inFlightRequests = new Map();
54
+ /** Guards the one-time warning when a columnar encoding is stripped from a dataserver HTTP call. */
55
+ this.dataserverEncodingStrippedWarned = false;
53
56
  /**
54
57
  * Promise that tracks an ongoing session refresh to prevent concurrent refreshes from the same instance.
55
58
  * @internal
56
59
  */
57
60
  this.ongoingRefresh = null;
61
+ this.scdbDecoder = new ScdbStreamDecoder(this.metaCache);
62
+ this.scdbDecoder.setMetadataRefresher((resourceName) => this.getMetadata(resourceName, false));
58
63
  }
59
64
  /**
60
65
  * Attempts to refresh the session when a 401 Unauthorized error is received.
@@ -157,6 +162,7 @@ let DefaultHttpConnect = DefaultHttpConnect_1 = class DefaultHttpConnect {
157
162
  snapshot(resourceName, params) {
158
163
  return __awaiter(this, void 0, void 0, function* () {
159
164
  const snapshotMessage = this.messageBuilder.createDataLogonMessage(resourceName, params);
165
+ this.stripDataserverColumnarEncoding(snapshotMessage);
160
166
  logger.debug(`HTTP MODE - ${snapshotMessage.MESSAGE_TYPE} (snapshot) message created -> `, snapshotMessage);
161
167
  return this.send(snapshotMessage).then((message) => {
162
168
  // snapshot = we only care about the initial payload but since it's a DATASERVER resource (not REQUEST_REPLY) we need to terminate the stream on the server
@@ -168,6 +174,7 @@ let DefaultHttpConnect = DefaultHttpConnect_1 = class DefaultHttpConnect {
168
174
  stream(resourceName, onMessage, onError, params) {
169
175
  var _a, _b;
170
176
  const streamMessage = this.messageBuilder.createDataLogonMessage(resourceName, params);
177
+ this.stripDataserverColumnarEncoding(streamMessage);
171
178
  logger.debug(`HTTP MODE - ${streamMessage.MESSAGE_TYPE} (stream) message created -> `, streamMessage);
172
179
  const SOURCE_REF = streamMessage.SOURCE_REF;
173
180
  const POLLING_FREQUENCY = ((_b = (_a = this.config.polling) === null || _a === void 0 ? void 0 : _a.POLLING_INTERVAL_MAP) === null || _b === void 0 ? void 0 : _b[resourceName]) ||
@@ -299,10 +306,18 @@ let DefaultHttpConnect = DefaultHttpConnect_1 = class DefaultHttpConnect {
299
306
  return inFlight;
300
307
  }
301
308
  const requestMessage = this.messageBuilder.createRequestMessage(resourceName, params);
309
+ const scdbResourceName = resourceNameOf(requestMessage);
310
+ this.scdbDecoder.prepareRequest(requestMessage);
302
311
  logger.debug(`HTTP MODE! - ${requestMessage.MESSAGE_TYPE} (request server) message created -> `, requestMessage);
303
312
  // REQUEST_SERVER messages use the GET method in HTTP mode; the transport encodes the
304
313
  // REQUEST/DETAILS params as a query string since GET requests cannot carry a body.
305
- const promise = this.transport.requestServer(this.host, requestMessage).finally(() => {
314
+ const promise = this.transport
315
+ .requestServer(this.host, requestMessage)
316
+ .then((response) => {
317
+ this.scdbDecoder.onMessage(response, scdbResourceName);
318
+ return response;
319
+ })
320
+ .finally(() => {
306
321
  this.inFlightRequests.delete(cacheKey);
307
322
  });
308
323
  this.inFlightRequests.set(cacheKey, promise);
@@ -313,6 +328,23 @@ let DefaultHttpConnect = DefaultHttpConnect_1 = class DefaultHttpConnect {
313
328
  return response;
314
329
  });
315
330
  }
331
+ /**
332
+ * Removes a negotiated columnar `ENCODING` from a dataserver HTTP message. Dataserver columnar
333
+ * encodings batch updates across a streamed connection in a way the HTTP poll/snapshot model
334
+ * cannot reconstruct, so dataserver-over-HTTP always uses row mode (req/rep-over-HTTP is fine and
335
+ * is handled separately). Warns once if anything was stripped so misconfiguration is visible.
336
+ */
337
+ stripDataserverColumnarEncoding(message) {
338
+ const details = message === null || message === void 0 ? void 0 : message.DETAILS;
339
+ if (!(details === null || details === void 0 ? void 0 : details.ENCODING))
340
+ return;
341
+ if (!this.dataserverEncodingStrippedWarned) {
342
+ this.dataserverEncodingStrippedWarned = true;
343
+ logger.warn(`Columnar encoding '${details.ENCODING}' is not supported for dataserver requests over HTTP; ` +
344
+ `using row mode. Use a WebSocket connection for columnar dataserver streams.`);
345
+ }
346
+ delete details.ENCODING;
347
+ }
316
348
  getAvailableResources(params_1) {
317
349
  return __awaiter(this, arguments, void 0, function* (params, useCache = true) {
318
350
  if (useCache) {
@@ -162,10 +162,12 @@ let DefaultMessageBuilder = class DefaultMessageBuilder {
162
162
  };
163
163
  }
164
164
  createDataLogonMessage(resourceName, params) {
165
+ var _a;
166
+ const encoding = (_a = params === null || params === void 0 ? void 0 : params.ENCODING) !== null && _a !== void 0 ? _a : this.scdbEncoding;
165
167
  return {
166
168
  SOURCE_REF: this.uuid.createId(),
167
169
  MESSAGE_TYPE: EventMessageType.DATA_LOGON,
168
- DETAILS: Object.assign({ DATASOURCE_NAME: resourceName }, params),
170
+ DETAILS: Object.assign(Object.assign({ DATASOURCE_NAME: resourceName }, params), (encoding ? { ENCODING: encoding } : {})),
169
171
  SESSION_AUTH_TOKEN: this.session.getSessionStorageItem('authToken'),
170
172
  };
171
173
  }