spacetimedb 2.4.1 → 2.6.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 (194) hide show
  1. package/LICENSE.txt +759 -759
  2. package/README.md +211 -120
  3. package/dist/angular/index.cjs.map +1 -1
  4. package/dist/angular/index.mjs.map +1 -1
  5. package/dist/browser/angular/index.mjs.map +1 -1
  6. package/dist/browser/react/index.mjs +129 -57
  7. package/dist/browser/react/index.mjs.map +1 -1
  8. package/dist/browser/solid/index.mjs +1933 -0
  9. package/dist/browser/solid/index.mjs.map +1 -0
  10. package/dist/browser/svelte/index.mjs.map +1 -1
  11. package/dist/browser/vue/index.mjs.map +1 -1
  12. package/dist/index.browser.mjs +10 -2
  13. package/dist/index.browser.mjs.map +1 -1
  14. package/dist/index.cjs +10 -2
  15. package/dist/index.cjs.map +1 -1
  16. package/dist/index.mjs +10 -2
  17. package/dist/index.mjs.map +1 -1
  18. package/dist/min/index.browser.mjs +1 -1
  19. package/dist/min/index.browser.mjs.map +1 -1
  20. package/dist/min/react/index.mjs +1 -1
  21. package/dist/min/react/index.mjs.map +1 -1
  22. package/dist/min/sdk/index.browser.mjs +1 -1
  23. package/dist/min/sdk/index.browser.mjs.map +1 -1
  24. package/dist/react/index.cjs +129 -57
  25. package/dist/react/index.cjs.map +1 -1
  26. package/dist/react/index.mjs +129 -57
  27. package/dist/react/index.mjs.map +1 -1
  28. package/dist/react/useTable.d.ts.map +1 -1
  29. package/dist/sdk/connection_manager.d.ts +8 -0
  30. package/dist/sdk/connection_manager.d.ts.map +1 -1
  31. package/dist/sdk/db_connection_impl.d.ts +7 -0
  32. package/dist/sdk/db_connection_impl.d.ts.map +1 -1
  33. package/dist/sdk/index.browser.mjs +10 -2
  34. package/dist/sdk/index.browser.mjs.map +1 -1
  35. package/dist/sdk/index.cjs +10 -2
  36. package/dist/sdk/index.cjs.map +1 -1
  37. package/dist/sdk/index.mjs +10 -2
  38. package/dist/sdk/index.mjs.map +1 -1
  39. package/dist/sdk/websocket_test_adapter.d.ts +2 -1
  40. package/dist/sdk/websocket_test_adapter.d.ts.map +1 -1
  41. package/dist/server/index.mjs.map +1 -1
  42. package/dist/server/runtime.d.ts.map +1 -1
  43. package/dist/solid/SpacetimeDBProvider.d.ts +7 -0
  44. package/dist/solid/SpacetimeDBProvider.d.ts.map +1 -0
  45. package/dist/solid/connection_state.d.ts +6 -0
  46. package/dist/solid/connection_state.d.ts.map +1 -0
  47. package/dist/solid/index.cjs +1939 -0
  48. package/dist/solid/index.cjs.map +1 -0
  49. package/dist/solid/index.d.ts +6 -0
  50. package/dist/solid/index.d.ts.map +1 -0
  51. package/dist/solid/index.mjs +1933 -0
  52. package/dist/solid/index.mjs.map +1 -0
  53. package/dist/solid/useProcedure.d.ts +4 -0
  54. package/dist/solid/useProcedure.d.ts.map +1 -0
  55. package/dist/solid/useReducer.d.ts +4 -0
  56. package/dist/solid/useReducer.d.ts.map +1 -0
  57. package/dist/solid/useSpacetimeDB.d.ts +4 -0
  58. package/dist/solid/useSpacetimeDB.d.ts.map +1 -0
  59. package/dist/solid/useTable.d.ts +32 -0
  60. package/dist/solid/useTable.d.ts.map +1 -0
  61. package/dist/svelte/index.cjs.map +1 -1
  62. package/dist/svelte/index.mjs.map +1 -1
  63. package/dist/tanstack/index.cjs +120 -50
  64. package/dist/tanstack/index.cjs.map +1 -1
  65. package/dist/tanstack/index.mjs +120 -50
  66. package/dist/tanstack/index.mjs.map +1 -1
  67. package/dist/vue/index.cjs.map +1 -1
  68. package/dist/vue/index.mjs.map +1 -1
  69. package/package.json +13 -3
  70. package/src/angular/connection_state.ts +19 -19
  71. package/src/angular/index.ts +3 -3
  72. package/src/angular/injectors/index.ts +4 -4
  73. package/src/angular/injectors/inject-reducer.ts +62 -62
  74. package/src/angular/injectors/inject-spacetimedb-connected.ts +13 -13
  75. package/src/angular/injectors/inject-spacetimedb.ts +10 -10
  76. package/src/angular/injectors/inject-table.ts +234 -234
  77. package/src/angular/providers/index.ts +1 -1
  78. package/src/angular/providers/provide-spacetimedb.ts +96 -96
  79. package/src/index.ts +16 -16
  80. package/src/lib/algebraic_type.ts +819 -819
  81. package/src/lib/algebraic_type_variants.ts +26 -26
  82. package/src/lib/algebraic_value.ts +10 -10
  83. package/src/lib/autogen/types.ts +746 -746
  84. package/src/lib/binary_reader.ts +188 -188
  85. package/src/lib/binary_writer.ts +213 -213
  86. package/src/lib/connection_id.ts +102 -102
  87. package/src/lib/constraints.ts +48 -48
  88. package/src/lib/errors.ts +26 -26
  89. package/src/lib/filter.ts +195 -195
  90. package/src/lib/identity.ts +83 -83
  91. package/src/lib/indexes.ts +251 -251
  92. package/src/lib/option.ts +34 -34
  93. package/src/lib/query.ts +1019 -1019
  94. package/src/lib/reducer_schema.ts +38 -38
  95. package/src/lib/reducers.ts +116 -116
  96. package/src/lib/result.ts +36 -36
  97. package/src/lib/schedule_at.ts +86 -86
  98. package/src/lib/schema.ts +420 -420
  99. package/src/lib/table.ts +548 -548
  100. package/src/lib/table_schema.ts +64 -64
  101. package/src/lib/time_duration.ts +77 -77
  102. package/src/lib/timestamp.ts +148 -148
  103. package/src/lib/type_builders.test-d.ts +128 -128
  104. package/src/lib/type_builders.ts +4014 -4014
  105. package/src/lib/type_util.ts +124 -124
  106. package/src/lib/util.ts +196 -196
  107. package/src/lib/uuid.ts +337 -337
  108. package/src/react/SpacetimeDBProvider.ts +84 -84
  109. package/src/react/connection_state.ts +6 -6
  110. package/src/react/index.ts +5 -5
  111. package/src/react/useProcedure.ts +60 -60
  112. package/src/react/useReducer.ts +53 -53
  113. package/src/react/useSpacetimeDB.ts +18 -18
  114. package/src/react/useTable.ts +256 -251
  115. package/src/sdk/client_api/index.ts +114 -114
  116. package/src/sdk/client_api/types/procedures.ts +8 -8
  117. package/src/sdk/client_api/types/reducers.ts +8 -8
  118. package/src/sdk/client_api/types.ts +288 -288
  119. package/src/sdk/client_cache.ts +129 -129
  120. package/src/sdk/client_table.ts +179 -179
  121. package/src/sdk/connection_manager.ts +352 -237
  122. package/src/sdk/db_connection_builder.ts +290 -290
  123. package/src/sdk/db_connection_impl.ts +1356 -1347
  124. package/src/sdk/db_context.ts +28 -28
  125. package/src/sdk/db_view.ts +12 -12
  126. package/src/sdk/decompress.ts +51 -51
  127. package/src/sdk/event.ts +18 -18
  128. package/src/sdk/event_context.ts +51 -51
  129. package/src/sdk/event_emitter.ts +32 -32
  130. package/src/sdk/index.ts +14 -14
  131. package/src/sdk/internal.ts +2 -2
  132. package/src/sdk/json_api.ts +46 -46
  133. package/src/sdk/logger.ts +134 -134
  134. package/src/sdk/message_types.ts +46 -46
  135. package/src/sdk/procedures.ts +83 -83
  136. package/src/sdk/reducer_event.ts +20 -20
  137. package/src/sdk/reducer_handle.ts +12 -12
  138. package/src/sdk/reducers.ts +159 -159
  139. package/src/sdk/schema.ts +45 -45
  140. package/src/sdk/spacetime_module.ts +28 -28
  141. package/src/sdk/subscription_builder_impl.ts +275 -275
  142. package/src/sdk/table_cache.ts +581 -581
  143. package/src/sdk/type_utils.ts +19 -19
  144. package/src/sdk/version.ts +133 -133
  145. package/src/sdk/websocket_decompress_adapter.ts +63 -63
  146. package/src/sdk/websocket_protocols.ts +25 -25
  147. package/src/sdk/websocket_test_adapter.ts +107 -100
  148. package/src/sdk/websocket_v3_frames.ts +126 -126
  149. package/src/sdk/ws.ts +105 -105
  150. package/src/server/console.ts +81 -81
  151. package/src/server/db_view.ts +21 -21
  152. package/src/server/errors.ts +138 -138
  153. package/src/server/http.test-d.ts +80 -80
  154. package/src/server/http.ts +14 -14
  155. package/src/server/http_handlers.ts +413 -413
  156. package/src/server/http_internal.ts +79 -79
  157. package/src/server/http_shared.ts +186 -186
  158. package/src/server/index.ts +37 -37
  159. package/src/server/polyfills.ts +4 -4
  160. package/src/server/procedures.ts +239 -239
  161. package/src/server/query.ts +1 -1
  162. package/src/server/range.ts +53 -53
  163. package/src/server/reducers.ts +113 -113
  164. package/src/server/rng.ts +113 -113
  165. package/src/server/runtime.ts +1102 -1102
  166. package/src/server/schema.test-d.ts +99 -99
  167. package/src/server/schema.ts +663 -663
  168. package/src/server/sys.d.ts +125 -125
  169. package/src/server/view.test-d.ts +194 -194
  170. package/src/server/views.ts +340 -340
  171. package/src/solid/SpacetimeDBProvider.ts +97 -0
  172. package/src/solid/connection_state.ts +6 -0
  173. package/src/solid/index.ts +5 -0
  174. package/src/solid/useProcedure.ts +57 -0
  175. package/src/solid/useReducer.ts +50 -0
  176. package/src/solid/useSpacetimeDB.ts +18 -0
  177. package/src/solid/useTable.ts +203 -0
  178. package/src/svelte/SpacetimeDBProvider.ts +101 -101
  179. package/src/svelte/connection_state.ts +16 -16
  180. package/src/svelte/index.ts +4 -4
  181. package/src/svelte/useReducer.ts +61 -61
  182. package/src/svelte/useSpacetimeDB.ts +22 -22
  183. package/src/svelte/useTable.ts +218 -218
  184. package/src/tanstack/SpacetimeDBQueryClient.ts +330 -330
  185. package/src/tanstack/hooks.ts +83 -83
  186. package/src/tanstack/index.ts +16 -16
  187. package/src/util-stub.ts +1 -1
  188. package/src/vue/SpacetimeDBProvider.ts +157 -157
  189. package/src/vue/connection_state.ts +19 -19
  190. package/src/vue/index.ts +5 -5
  191. package/src/vue/useProcedure.ts +62 -62
  192. package/src/vue/useReducer.ts +55 -55
  193. package/src/vue/useSpacetimeDB.ts +18 -18
  194. package/src/vue/useTable.ts +229 -229
@@ -1732,6 +1732,14 @@ function useSpacetimeDB() {
1732
1732
  }
1733
1733
 
1734
1734
  // src/sdk/connection_manager.ts
1735
+ var CONNECTION_MANAGER_RECONNECT_BASE_DELAY_MS = 1e3;
1736
+ var CONNECTION_MANAGER_RECONNECT_MAX_DELAY_MS = 3e4;
1737
+ function connectionManagerReconnectDelayMs(attempt) {
1738
+ return Math.min(
1739
+ CONNECTION_MANAGER_RECONNECT_BASE_DELAY_MS * 2 ** attempt,
1740
+ CONNECTION_MANAGER_RECONNECT_MAX_DELAY_MS
1741
+ );
1742
+ }
1735
1743
  function defaultState() {
1736
1744
  return {
1737
1745
  isActive: false,
@@ -1758,10 +1766,13 @@ var ConnectionManagerImpl = class _ConnectionManagerImpl {
1758
1766
  }
1759
1767
  const managed = {
1760
1768
  connection: void 0,
1769
+ builder: void 0,
1761
1770
  refCount: 0,
1762
1771
  state: defaultState(),
1763
1772
  listeners: /* @__PURE__ */ new Set(),
1764
- pendingRelease: null
1773
+ pendingRelease: null,
1774
+ reconnectTimer: null,
1775
+ reconnectAttempt: 0
1765
1776
  };
1766
1777
  this.#connections.set(key, managed);
1767
1778
  return managed;
@@ -1771,40 +1782,20 @@ var ConnectionManagerImpl = class _ConnectionManagerImpl {
1771
1782
  listener();
1772
1783
  }
1773
1784
  }
1774
- /**
1775
- * Retains a connection, incrementing its reference count.
1776
- * Creates the connection on first call; returns existing connection on subsequent calls.
1777
- * Cancels any pending release if the connection was about to be cleaned up.
1778
- *
1779
- * @param key - Unique identifier for the connection (use getKey to generate)
1780
- * @param builder - Connection builder to create the connection if needed
1781
- * @returns The managed connection instance
1782
- */
1783
- retain(key, builder) {
1784
- const managed = this.#ensureEntry(key);
1785
- if (managed.pendingRelease) {
1786
- clearTimeout(managed.pendingRelease);
1787
- managed.pendingRelease = null;
1788
- }
1789
- managed.refCount += 1;
1790
- if (managed.connection) {
1791
- return managed.connection;
1785
+ #updateState(managed, updates) {
1786
+ managed.state = { ...managed.state, ...updates };
1787
+ this.#notify(managed);
1788
+ }
1789
+ #ensureCallbacks(managed) {
1790
+ if (managed.onConnect) {
1791
+ return;
1792
1792
  }
1793
- const connection = builder.build();
1794
- managed.connection = connection;
1795
- const updateState = (updates) => {
1796
- managed.state = { ...managed.state, ...updates };
1797
- this.#notify(managed);
1798
- };
1799
- updateState({
1800
- isActive: connection.isActive,
1801
- identity: connection.identity,
1802
- token: connection.token,
1803
- connectionId: connection.connectionId,
1804
- connectionError: void 0
1805
- });
1806
1793
  managed.onConnect = (conn) => {
1807
- updateState({
1794
+ if (conn !== managed.connection) {
1795
+ return;
1796
+ }
1797
+ managed.reconnectAttempt = 0;
1798
+ this.#updateState(managed, {
1808
1799
  isActive: conn.isActive,
1809
1800
  identity: conn.identity,
1810
1801
  token: conn.token,
@@ -1813,22 +1804,105 @@ var ConnectionManagerImpl = class _ConnectionManagerImpl {
1813
1804
  });
1814
1805
  };
1815
1806
  managed.onDisconnect = (ctx, error) => {
1816
- updateState({
1817
- isActive: ctx.isActive,
1807
+ if (ctx !== managed.connection) {
1808
+ return;
1809
+ }
1810
+ this.#updateState(managed, {
1811
+ isActive: false,
1818
1812
  connectionError: error ?? void 0
1819
1813
  });
1814
+ this.#scheduleReconnect(managed);
1820
1815
  };
1821
1816
  managed.onConnectError = (ctx, error) => {
1822
- updateState({
1823
- isActive: ctx.isActive,
1817
+ if (ctx !== managed.connection) {
1818
+ return;
1819
+ }
1820
+ this.#updateState(managed, {
1821
+ isActive: false,
1824
1822
  connectionError: error
1825
1823
  });
1824
+ this.#scheduleReconnect(managed);
1826
1825
  };
1826
+ }
1827
+ #attachCallbacks(managed, builder) {
1828
+ this.#ensureCallbacks(managed);
1827
1829
  builder.onConnect(managed.onConnect);
1828
1830
  builder.onDisconnect(managed.onDisconnect);
1829
1831
  builder.onConnectError(managed.onConnectError);
1832
+ }
1833
+ #detachCallbacks(managed, connection) {
1834
+ if (managed.onConnect) {
1835
+ connection.removeOnConnect(managed.onConnect);
1836
+ }
1837
+ if (managed.onDisconnect) {
1838
+ connection.removeOnDisconnect(managed.onDisconnect);
1839
+ }
1840
+ if (managed.onConnectError) {
1841
+ connection.removeOnConnectError(managed.onConnectError);
1842
+ }
1843
+ }
1844
+ #buildManagedConnection(managed, builder) {
1845
+ managed.builder = builder;
1846
+ const connection = builder.build();
1847
+ managed.connection = connection;
1848
+ this.#attachCallbacks(managed, builder);
1849
+ this.#updateState(managed, {
1850
+ isActive: connection.isActive,
1851
+ identity: connection.identity,
1852
+ token: connection.token,
1853
+ connectionId: connection.connectionId,
1854
+ connectionError: void 0
1855
+ });
1830
1856
  return connection;
1831
1857
  }
1858
+ #scheduleReconnect(managed) {
1859
+ if (managed.refCount <= 0 || managed.pendingRelease || managed.reconnectTimer || !managed.builder) {
1860
+ return;
1861
+ }
1862
+ const connection = managed.connection;
1863
+ if (connection) {
1864
+ this.#detachCallbacks(managed, connection);
1865
+ }
1866
+ managed.connection = void 0;
1867
+ if (connection?.isDisconnectRequested) {
1868
+ return;
1869
+ }
1870
+ const delay = connectionManagerReconnectDelayMs(managed.reconnectAttempt);
1871
+ managed.reconnectAttempt += 1;
1872
+ managed.reconnectTimer = setTimeout(() => {
1873
+ managed.reconnectTimer = null;
1874
+ if (managed.refCount <= 0 || managed.pendingRelease || managed.connection || !managed.builder) {
1875
+ return;
1876
+ }
1877
+ this.#buildManagedConnection(managed, managed.builder);
1878
+ }, delay);
1879
+ }
1880
+ /**
1881
+ * Retains a connection, incrementing its reference count.
1882
+ * Creates the connection on first call; returns existing connection on subsequent calls.
1883
+ * Cancels any pending release if the connection was about to be cleaned up.
1884
+ *
1885
+ * @param key - Unique identifier for the connection (use getKey to generate)
1886
+ * @param builder - Connection builder to create the connection if needed
1887
+ * @returns The managed connection instance
1888
+ */
1889
+ retain(key, builder) {
1890
+ const managed = this.#ensureEntry(key);
1891
+ if (managed.pendingRelease) {
1892
+ clearTimeout(managed.pendingRelease);
1893
+ managed.pendingRelease = null;
1894
+ }
1895
+ if (managed.reconnectTimer) {
1896
+ clearTimeout(managed.reconnectTimer);
1897
+ managed.reconnectTimer = null;
1898
+ }
1899
+ managed.refCount += 1;
1900
+ managed.builder = builder;
1901
+ if (managed.connection) {
1902
+ return managed.connection;
1903
+ }
1904
+ return this.#buildManagedConnection(managed, builder);
1905
+ }
1832
1906
  release(key) {
1833
1907
  const managed = this.#connections.get(key);
1834
1908
  if (!managed) {
@@ -1838,24 +1912,20 @@ var ConnectionManagerImpl = class _ConnectionManagerImpl {
1838
1912
  if (managed.refCount > 0 || managed.pendingRelease) {
1839
1913
  return;
1840
1914
  }
1915
+ if (managed.reconnectTimer) {
1916
+ clearTimeout(managed.reconnectTimer);
1917
+ managed.reconnectTimer = null;
1918
+ }
1841
1919
  managed.pendingRelease = setTimeout(() => {
1842
1920
  managed.pendingRelease = null;
1843
1921
  if (managed.refCount > 0) {
1844
1922
  return;
1845
1923
  }
1846
- if (managed.connection) {
1847
- if (managed.onConnect) {
1848
- managed.connection.removeOnConnect(managed.onConnect);
1849
- }
1850
- if (managed.onDisconnect) {
1851
- managed.connection.removeOnDisconnect(managed.onDisconnect);
1852
- }
1853
- if (managed.onConnectError) {
1854
- managed.connection.removeOnConnectError(
1855
- managed.onConnectError
1856
- );
1857
- }
1858
- managed.connection.disconnect();
1924
+ const connection = managed.connection;
1925
+ managed.connection = void 0;
1926
+ if (connection) {
1927
+ this.#detachCallbacks(managed, connection);
1928
+ connection.disconnect();
1859
1929
  }
1860
1930
  this.#connections.delete(key);
1861
1931
  }, 0);