spacetimedb 2.6.0 → 2.6.1

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 (172) hide show
  1. package/README.md +211 -211
  2. package/dist/angular/index.cjs.map +1 -1
  3. package/dist/angular/index.mjs.map +1 -1
  4. package/dist/browser/angular/index.mjs.map +1 -1
  5. package/dist/browser/react/index.mjs.map +1 -1
  6. package/dist/browser/solid/index.mjs.map +1 -1
  7. package/dist/browser/svelte/index.mjs.map +1 -1
  8. package/dist/browser/vue/index.mjs.map +1 -1
  9. package/dist/index.browser.mjs.map +1 -1
  10. package/dist/index.cjs.map +1 -1
  11. package/dist/index.mjs.map +1 -1
  12. package/dist/lib/type_builders.d.ts +18 -3
  13. package/dist/lib/type_builders.d.ts.map +1 -1
  14. package/dist/min/index.browser.mjs.map +1 -1
  15. package/dist/min/react/index.mjs.map +1 -1
  16. package/dist/min/sdk/index.browser.mjs.map +1 -1
  17. package/dist/react/index.cjs.map +1 -1
  18. package/dist/react/index.mjs.map +1 -1
  19. package/dist/sdk/db_connection_impl.d.ts.map +1 -1
  20. package/dist/sdk/event_context.d.ts +3 -3
  21. package/dist/sdk/event_context.d.ts.map +1 -1
  22. package/dist/sdk/index.browser.mjs.map +1 -1
  23. package/dist/sdk/index.cjs.map +1 -1
  24. package/dist/sdk/index.mjs.map +1 -1
  25. package/dist/sdk/procedures.d.ts +2 -2
  26. package/dist/sdk/procedures.d.ts.map +1 -1
  27. package/dist/sdk/reducers.d.ts +3 -4
  28. package/dist/sdk/reducers.d.ts.map +1 -1
  29. package/dist/sdk/table_cache.d.ts.map +1 -1
  30. package/dist/sdk/type_utils.d.ts +3 -3
  31. package/dist/sdk/type_utils.d.ts.map +1 -1
  32. package/dist/server/index.mjs.map +1 -1
  33. package/dist/server/runtime.d.ts.map +1 -1
  34. package/dist/server/views.d.ts +4 -2
  35. package/dist/server/views.d.ts.map +1 -1
  36. package/dist/solid/index.cjs.map +1 -1
  37. package/dist/solid/index.mjs.map +1 -1
  38. package/dist/svelte/index.cjs.map +1 -1
  39. package/dist/svelte/index.mjs.map +1 -1
  40. package/dist/svelte/useReducer.d.ts +2 -2
  41. package/dist/svelte/useReducer.d.ts.map +1 -1
  42. package/dist/tanstack/index.cjs.map +1 -1
  43. package/dist/tanstack/index.mjs.map +1 -1
  44. package/dist/vue/index.cjs.map +1 -1
  45. package/dist/vue/index.mjs.map +1 -1
  46. package/package.json +22 -21
  47. package/src/angular/connection_state.ts +19 -19
  48. package/src/angular/index.ts +3 -3
  49. package/src/angular/injectors/index.ts +4 -4
  50. package/src/angular/injectors/inject-reducer.ts +62 -62
  51. package/src/angular/injectors/inject-spacetimedb-connected.ts +13 -13
  52. package/src/angular/injectors/inject-spacetimedb.ts +10 -10
  53. package/src/angular/injectors/inject-table.ts +234 -234
  54. package/src/angular/providers/index.ts +1 -1
  55. package/src/angular/providers/provide-spacetimedb.ts +96 -96
  56. package/src/index.ts +16 -16
  57. package/src/lib/algebraic_type.ts +819 -819
  58. package/src/lib/algebraic_type_variants.ts +26 -26
  59. package/src/lib/algebraic_value.ts +10 -10
  60. package/src/lib/autogen/types.ts +746 -746
  61. package/src/lib/binary_reader.ts +188 -188
  62. package/src/lib/binary_writer.ts +213 -213
  63. package/src/lib/connection_id.ts +102 -102
  64. package/src/lib/constraints.ts +48 -48
  65. package/src/lib/errors.ts +26 -26
  66. package/src/lib/filter.ts +195 -195
  67. package/src/lib/identity.ts +83 -83
  68. package/src/lib/indexes.ts +251 -251
  69. package/src/lib/option.ts +34 -34
  70. package/src/lib/query.ts +1019 -1019
  71. package/src/lib/reducer_schema.ts +38 -38
  72. package/src/lib/reducers.ts +116 -116
  73. package/src/lib/result.ts +36 -36
  74. package/src/lib/schedule_at.ts +86 -86
  75. package/src/lib/schema.ts +420 -420
  76. package/src/lib/table.ts +548 -548
  77. package/src/lib/table_schema.ts +64 -64
  78. package/src/lib/time_duration.ts +77 -77
  79. package/src/lib/timestamp.ts +148 -148
  80. package/src/lib/type_builders.test-d.ts +130 -128
  81. package/src/lib/type_builders.ts +4050 -4014
  82. package/src/lib/type_util.ts +124 -124
  83. package/src/lib/util.ts +196 -196
  84. package/src/lib/uuid.ts +337 -337
  85. package/src/react/SpacetimeDBProvider.ts +84 -84
  86. package/src/react/connection_state.ts +6 -6
  87. package/src/react/index.ts +5 -5
  88. package/src/react/useProcedure.ts +60 -60
  89. package/src/react/useReducer.ts +53 -53
  90. package/src/react/useSpacetimeDB.ts +18 -18
  91. package/src/react/useTable.ts +256 -256
  92. package/src/sdk/client_api/index.ts +114 -114
  93. package/src/sdk/client_api/types/procedures.ts +8 -8
  94. package/src/sdk/client_api/types/reducers.ts +8 -8
  95. package/src/sdk/client_api/types.ts +288 -288
  96. package/src/sdk/client_cache.ts +129 -129
  97. package/src/sdk/client_table.ts +179 -179
  98. package/src/sdk/connection_manager.ts +352 -352
  99. package/src/sdk/db_connection_builder.ts +290 -290
  100. package/src/sdk/db_connection_impl.ts +1363 -1356
  101. package/src/sdk/db_context.ts +28 -28
  102. package/src/sdk/db_view.ts +12 -12
  103. package/src/sdk/decompress.ts +51 -51
  104. package/src/sdk/event.ts +18 -18
  105. package/src/sdk/event_context.ts +51 -51
  106. package/src/sdk/event_emitter.ts +32 -32
  107. package/src/sdk/index.ts +14 -14
  108. package/src/sdk/internal.ts +2 -2
  109. package/src/sdk/json_api.ts +46 -46
  110. package/src/sdk/logger.ts +134 -134
  111. package/src/sdk/message_types.ts +46 -46
  112. package/src/sdk/procedures.ts +87 -83
  113. package/src/sdk/reducer_event.ts +20 -20
  114. package/src/sdk/reducer_handle.ts +12 -12
  115. package/src/sdk/reducers.ts +158 -159
  116. package/src/sdk/schema.ts +45 -45
  117. package/src/sdk/spacetime_module.ts +28 -28
  118. package/src/sdk/subscription_builder_impl.ts +275 -275
  119. package/src/sdk/table_cache.ts +582 -581
  120. package/src/sdk/type_utils.ts +19 -19
  121. package/src/sdk/version.ts +133 -133
  122. package/src/sdk/websocket_decompress_adapter.ts +63 -63
  123. package/src/sdk/websocket_protocols.ts +25 -25
  124. package/src/sdk/websocket_test_adapter.ts +107 -107
  125. package/src/sdk/websocket_v3_frames.ts +126 -126
  126. package/src/sdk/ws.ts +105 -105
  127. package/src/server/console.ts +81 -81
  128. package/src/server/db_view.ts +21 -21
  129. package/src/server/errors.ts +138 -138
  130. package/src/server/http.test-d.ts +80 -80
  131. package/src/server/http.ts +14 -14
  132. package/src/server/http_handlers.ts +413 -413
  133. package/src/server/http_internal.ts +79 -79
  134. package/src/server/http_shared.ts +186 -186
  135. package/src/server/index.ts +37 -37
  136. package/src/server/polyfills.ts +4 -4
  137. package/src/server/procedures.ts +239 -239
  138. package/src/server/query.ts +1 -1
  139. package/src/server/range.ts +53 -53
  140. package/src/server/reducers.ts +113 -113
  141. package/src/server/rng.ts +113 -113
  142. package/src/server/runtime.ts +1102 -1102
  143. package/src/server/schema.test-d.ts +99 -99
  144. package/src/server/schema.ts +663 -663
  145. package/src/server/sys.d.ts +125 -125
  146. package/src/server/view.test-d.ts +194 -194
  147. package/src/server/views.ts +343 -340
  148. package/src/solid/SpacetimeDBProvider.ts +97 -97
  149. package/src/solid/connection_state.ts +6 -6
  150. package/src/solid/index.ts +5 -5
  151. package/src/solid/useProcedure.ts +57 -57
  152. package/src/solid/useReducer.ts +50 -50
  153. package/src/solid/useSpacetimeDB.ts +18 -18
  154. package/src/solid/useTable.ts +203 -203
  155. package/src/svelte/SpacetimeDBProvider.ts +101 -101
  156. package/src/svelte/connection_state.ts +16 -16
  157. package/src/svelte/index.ts +4 -4
  158. package/src/svelte/useReducer.ts +61 -61
  159. package/src/svelte/useSpacetimeDB.ts +22 -22
  160. package/src/svelte/useTable.ts +218 -218
  161. package/src/tanstack/SpacetimeDBQueryClient.ts +330 -330
  162. package/src/tanstack/hooks.ts +83 -83
  163. package/src/tanstack/index.ts +16 -16
  164. package/src/util-stub.ts +1 -1
  165. package/src/vue/SpacetimeDBProvider.ts +157 -157
  166. package/src/vue/connection_state.ts +19 -19
  167. package/src/vue/index.ts +5 -5
  168. package/src/vue/useProcedure.ts +62 -62
  169. package/src/vue/useReducer.ts +55 -55
  170. package/src/vue/useSpacetimeDB.ts +18 -18
  171. package/src/vue/useTable.ts +229 -229
  172. package/LICENSE.txt +0 -759
@@ -1,83 +1,83 @@
1
- import { useQuery, useSuspenseQuery } from '@tanstack/react-query';
2
- import type {
3
- UseQueryOptions,
4
- UseQueryResult,
5
- UseSuspenseQueryOptions,
6
- UseSuspenseQueryResult,
7
- } from '@tanstack/react-query';
8
- import type { UntypedTableDef, RowType } from '../lib/table';
9
- import type { Query } from '../lib/query';
10
- import { spacetimeDBQuery } from './SpacetimeDBQueryClient';
11
-
12
- export type UseSpacetimeDBQueryResult<T> = [
13
- T[],
14
- boolean,
15
- UseQueryResult<T[], Error>,
16
- ];
17
-
18
- export type UseSpacetimeDBSuspenseQueryResult<T> = [
19
- T[],
20
- false,
21
- UseSuspenseQueryResult<T[], Error>,
22
- ];
23
-
24
- // Wraps TanStack Query useQuery and returns [data, loading, query]
25
- // pass 'skip' as the second argument to set enabled: false, disabling the query
26
- // until a condition is met
27
- //
28
- // Usage:
29
- // useSpacetimeDBQuery(tables.person)
30
- // useSpacetimeDBQuery(tables.user.where(r => r.online.eq(true)))
31
- // useSpacetimeDBQuery(condition ? tables.user : 'skip')
32
- export function useSpacetimeDBQuery<TableDef extends UntypedTableDef>(
33
- queryOrSkip: Query<TableDef> | 'skip',
34
- // any useQuery option (e.g. enabled, refetchInterval, select, placeholderData),
35
- // except queryKey, queryFn, and meta (managed internally)
36
- options?: Omit<
37
- UseQueryOptions<
38
- RowType<TableDef>[],
39
- Error,
40
- RowType<TableDef>[],
41
- readonly ['spacetimedb', string, string]
42
- >,
43
- 'queryKey' | 'queryFn' | 'meta'
44
- >
45
- ): UseSpacetimeDBQueryResult<RowType<TableDef>> {
46
- const queryOptions =
47
- queryOrSkip === 'skip'
48
- ? spacetimeDBQuery('skip')
49
- : spacetimeDBQuery(queryOrSkip);
50
-
51
- const query = useQuery({
52
- ...queryOptions,
53
- ...options,
54
- } as UseQueryOptions<RowType<TableDef>[], Error>);
55
-
56
- return [query.data ?? [], query.isPending, query];
57
- }
58
-
59
- // Suspense version of useSpacetimeDBQuery, returns [data, false, query] tuple (loading = false)
60
- // Instead of returning a loading boolean, this hook suspends the component
61
- // until data is ready, a parent <Suspense fallback={…}> handles the loading UI.
62
- // does not support 'skip' because useSuspenseQuery must always resolve
63
- export function useSpacetimeDBSuspenseQuery<TableDef extends UntypedTableDef>(
64
- query: Query<TableDef>,
65
- options?: Omit<
66
- UseSuspenseQueryOptions<
67
- RowType<TableDef>[],
68
- Error,
69
- RowType<TableDef>[],
70
- readonly ['spacetimedb', string, string]
71
- >,
72
- 'queryKey' | 'queryFn' | 'meta'
73
- >
74
- ): UseSpacetimeDBSuspenseQueryResult<RowType<TableDef>> {
75
- const queryOptions = spacetimeDBQuery(query);
76
-
77
- const q = useSuspenseQuery({
78
- ...queryOptions,
79
- ...options,
80
- } as UseSuspenseQueryOptions<RowType<TableDef>[], Error>);
81
-
82
- return [q.data, false, q];
83
- }
1
+ import { useQuery, useSuspenseQuery } from '@tanstack/react-query';
2
+ import type {
3
+ UseQueryOptions,
4
+ UseQueryResult,
5
+ UseSuspenseQueryOptions,
6
+ UseSuspenseQueryResult,
7
+ } from '@tanstack/react-query';
8
+ import type { UntypedTableDef, RowType } from '../lib/table';
9
+ import type { Query } from '../lib/query';
10
+ import { spacetimeDBQuery } from './SpacetimeDBQueryClient';
11
+
12
+ export type UseSpacetimeDBQueryResult<T> = [
13
+ T[],
14
+ boolean,
15
+ UseQueryResult<T[], Error>,
16
+ ];
17
+
18
+ export type UseSpacetimeDBSuspenseQueryResult<T> = [
19
+ T[],
20
+ false,
21
+ UseSuspenseQueryResult<T[], Error>,
22
+ ];
23
+
24
+ // Wraps TanStack Query useQuery and returns [data, loading, query]
25
+ // pass 'skip' as the second argument to set enabled: false, disabling the query
26
+ // until a condition is met
27
+ //
28
+ // Usage:
29
+ // useSpacetimeDBQuery(tables.person)
30
+ // useSpacetimeDBQuery(tables.user.where(r => r.online.eq(true)))
31
+ // useSpacetimeDBQuery(condition ? tables.user : 'skip')
32
+ export function useSpacetimeDBQuery<TableDef extends UntypedTableDef>(
33
+ queryOrSkip: Query<TableDef> | 'skip',
34
+ // any useQuery option (e.g. enabled, refetchInterval, select, placeholderData),
35
+ // except queryKey, queryFn, and meta (managed internally)
36
+ options?: Omit<
37
+ UseQueryOptions<
38
+ RowType<TableDef>[],
39
+ Error,
40
+ RowType<TableDef>[],
41
+ readonly ['spacetimedb', string, string]
42
+ >,
43
+ 'queryKey' | 'queryFn' | 'meta'
44
+ >
45
+ ): UseSpacetimeDBQueryResult<RowType<TableDef>> {
46
+ const queryOptions =
47
+ queryOrSkip === 'skip'
48
+ ? spacetimeDBQuery('skip')
49
+ : spacetimeDBQuery(queryOrSkip);
50
+
51
+ const query = useQuery({
52
+ ...queryOptions,
53
+ ...options,
54
+ } as UseQueryOptions<RowType<TableDef>[], Error>);
55
+
56
+ return [query.data ?? [], query.isPending, query];
57
+ }
58
+
59
+ // Suspense version of useSpacetimeDBQuery, returns [data, false, query] tuple (loading = false)
60
+ // Instead of returning a loading boolean, this hook suspends the component
61
+ // until data is ready, a parent <Suspense fallback={…}> handles the loading UI.
62
+ // does not support 'skip' because useSuspenseQuery must always resolve
63
+ export function useSpacetimeDBSuspenseQuery<TableDef extends UntypedTableDef>(
64
+ query: Query<TableDef>,
65
+ options?: Omit<
66
+ UseSuspenseQueryOptions<
67
+ RowType<TableDef>[],
68
+ Error,
69
+ RowType<TableDef>[],
70
+ readonly ['spacetimedb', string, string]
71
+ >,
72
+ 'queryKey' | 'queryFn' | 'meta'
73
+ >
74
+ ): UseSpacetimeDBSuspenseQueryResult<RowType<TableDef>> {
75
+ const queryOptions = spacetimeDBQuery(query);
76
+
77
+ const q = useSuspenseQuery({
78
+ ...queryOptions,
79
+ ...options,
80
+ } as UseSuspenseQueryOptions<RowType<TableDef>[], Error>);
81
+
82
+ return [q.data, false, q];
83
+ }
@@ -1,16 +1,16 @@
1
- export {
2
- SpacetimeDBQueryClient,
3
- spacetimeDBQuery,
4
- type SpacetimeDBQueryOptions,
5
- type SpacetimeDBQueryOptionsSkipped,
6
- } from './SpacetimeDBQueryClient';
7
- export {
8
- useSpacetimeDBQuery,
9
- useSpacetimeDBSuspenseQuery,
10
- type UseSpacetimeDBQueryResult,
11
- type UseSpacetimeDBSuspenseQueryResult,
12
- } from './hooks';
13
- export * from '../react/SpacetimeDBProvider';
14
- export { useSpacetimeDB } from '../react/useSpacetimeDB';
15
- export { useReducer } from '../react/useReducer';
16
- export { useProcedure } from '../react/useProcedure';
1
+ export {
2
+ SpacetimeDBQueryClient,
3
+ spacetimeDBQuery,
4
+ type SpacetimeDBQueryOptions,
5
+ type SpacetimeDBQueryOptionsSkipped,
6
+ } from './SpacetimeDBQueryClient';
7
+ export {
8
+ useSpacetimeDBQuery,
9
+ useSpacetimeDBSuspenseQuery,
10
+ type UseSpacetimeDBQueryResult,
11
+ type UseSpacetimeDBSuspenseQueryResult,
12
+ } from './hooks';
13
+ export * from '../react/SpacetimeDBProvider';
14
+ export { useSpacetimeDB } from '../react/useSpacetimeDB';
15
+ export { useReducer } from '../react/useReducer';
16
+ export { useProcedure } from '../react/useProcedure';
package/src/util-stub.ts CHANGED
@@ -1 +1 @@
1
- export const inspect = {};
1
+ export const inspect = {};
@@ -1,157 +1,157 @@
1
- import {
2
- defineComponent,
3
- onMounted,
4
- onUnmounted,
5
- provide,
6
- reactive,
7
- type PropType,
8
- type Slot,
9
- } from 'vue';
10
- import {
11
- DbConnectionBuilder,
12
- type DbConnectionImpl,
13
- type ErrorContextInterface,
14
- type RemoteModuleOf,
15
- } from '../sdk/db_connection_impl';
16
- import { ConnectionId } from '../lib/connection_id';
17
- import {
18
- SPACETIMEDB_INJECTION_KEY,
19
- type ConnectionState,
20
- } from './connection_state';
21
-
22
- export interface SpacetimeDBProviderProps<
23
- DbConnection extends DbConnectionImpl<any>,
24
- > {
25
- connectionBuilder: DbConnectionBuilder<DbConnection>;
26
- }
27
-
28
- let connRef: DbConnectionImpl<any> | null = null;
29
- let cleanupTimeoutId: ReturnType<typeof setTimeout> | null = null;
30
-
31
- function setupConnection<DbConnection extends DbConnectionImpl<any>>(
32
- connectionBuilder: DbConnectionBuilder<DbConnection>
33
- ): {
34
- state: ConnectionState;
35
- cleanup: () => void;
36
- } {
37
- const getConnection = <T extends DbConnectionImpl<any>>() =>
38
- connRef as T | null;
39
-
40
- const state = reactive<ConnectionState>({
41
- isActive: false,
42
- identity: undefined,
43
- token: undefined,
44
- connectionId: ConnectionId.random(),
45
- connectionError: undefined,
46
- getConnection,
47
- });
48
-
49
- provide(SPACETIMEDB_INJECTION_KEY, state);
50
-
51
- let onConnectCallback: ((conn: DbConnection) => void) | null = null;
52
- let onDisconnectCallback:
53
- | ((ctx: ErrorContextInterface<RemoteModuleOf<DbConnection>>) => void)
54
- | null = null;
55
- let onConnectErrorCallback:
56
- | ((
57
- ctx: ErrorContextInterface<RemoteModuleOf<DbConnection>>,
58
- err: Error
59
- ) => void)
60
- | null = null;
61
-
62
- onMounted(() => {
63
- if (cleanupTimeoutId) {
64
- clearTimeout(cleanupTimeoutId);
65
- cleanupTimeoutId = null;
66
- }
67
-
68
- if (!connRef) {
69
- connRef = connectionBuilder.build();
70
- }
71
-
72
- onConnectCallback = (conn: DbConnection) => {
73
- state.isActive = conn.isActive;
74
- state.identity = conn.identity;
75
- state.token = conn.token;
76
- state.connectionId = conn.connectionId;
77
- state.connectionError = undefined;
78
- };
79
-
80
- onDisconnectCallback = (
81
- ctx: ErrorContextInterface<RemoteModuleOf<DbConnection>>
82
- ) => {
83
- state.isActive = ctx.isActive;
84
- };
85
-
86
- onConnectErrorCallback = (
87
- ctx: ErrorContextInterface<RemoteModuleOf<DbConnection>>,
88
- err: Error
89
- ) => {
90
- state.isActive = ctx.isActive;
91
- state.connectionError = err;
92
- };
93
-
94
- connectionBuilder.onConnect(onConnectCallback);
95
- connectionBuilder.onDisconnect(onDisconnectCallback);
96
- connectionBuilder.onConnectError(onConnectErrorCallback);
97
-
98
- const conn = connRef;
99
- if (conn) {
100
- state.isActive = conn.isActive;
101
- state.identity = conn.identity;
102
- state.token = conn.token;
103
- state.connectionId = conn.connectionId;
104
- }
105
- });
106
-
107
- const cleanup = () => {
108
- if (connRef) {
109
- if (onConnectCallback) {
110
- connRef.removeOnConnect?.(onConnectCallback as any);
111
- }
112
- if (onDisconnectCallback) {
113
- connRef.removeOnDisconnect?.(onDisconnectCallback as any);
114
- }
115
- if (onConnectErrorCallback) {
116
- connRef.removeOnConnectError?.(onConnectErrorCallback as any);
117
- }
118
-
119
- cleanupTimeoutId = setTimeout(() => {
120
- connRef?.disconnect();
121
- connRef = null;
122
- cleanupTimeoutId = null;
123
- }, 0);
124
- }
125
- };
126
-
127
- onUnmounted(cleanup);
128
-
129
- return { state, cleanup };
130
- }
131
-
132
- export const SpacetimeDBProvider = defineComponent({
133
- name: 'SpacetimeDBProvider',
134
-
135
- props: {
136
- connectionBuilder: {
137
- type: Object as PropType<DbConnectionBuilder<any>>,
138
- required: true,
139
- },
140
- },
141
-
142
- setup(props, { slots }) {
143
- setupConnection(props.connectionBuilder);
144
-
145
- return () => {
146
- const defaultSlot = slots.default as Slot | undefined;
147
- return defaultSlot ? defaultSlot() : null;
148
- };
149
- },
150
- });
151
-
152
- export function useSpacetimeDBProvider<
153
- DbConnection extends DbConnectionImpl<any>,
154
- >(connectionBuilder: DbConnectionBuilder<DbConnection>): ConnectionState {
155
- const { state } = setupConnection(connectionBuilder);
156
- return state;
157
- }
1
+ import {
2
+ defineComponent,
3
+ onMounted,
4
+ onUnmounted,
5
+ provide,
6
+ reactive,
7
+ type PropType,
8
+ type Slot,
9
+ } from 'vue';
10
+ import {
11
+ DbConnectionBuilder,
12
+ type DbConnectionImpl,
13
+ type ErrorContextInterface,
14
+ type RemoteModuleOf,
15
+ } from '../sdk/db_connection_impl';
16
+ import { ConnectionId } from '../lib/connection_id';
17
+ import {
18
+ SPACETIMEDB_INJECTION_KEY,
19
+ type ConnectionState,
20
+ } from './connection_state';
21
+
22
+ export interface SpacetimeDBProviderProps<
23
+ DbConnection extends DbConnectionImpl<any>,
24
+ > {
25
+ connectionBuilder: DbConnectionBuilder<DbConnection>;
26
+ }
27
+
28
+ let connRef: DbConnectionImpl<any> | null = null;
29
+ let cleanupTimeoutId: ReturnType<typeof setTimeout> | null = null;
30
+
31
+ function setupConnection<DbConnection extends DbConnectionImpl<any>>(
32
+ connectionBuilder: DbConnectionBuilder<DbConnection>
33
+ ): {
34
+ state: ConnectionState;
35
+ cleanup: () => void;
36
+ } {
37
+ const getConnection = <T extends DbConnectionImpl<any>>() =>
38
+ connRef as T | null;
39
+
40
+ const state = reactive<ConnectionState>({
41
+ isActive: false,
42
+ identity: undefined,
43
+ token: undefined,
44
+ connectionId: ConnectionId.random(),
45
+ connectionError: undefined,
46
+ getConnection,
47
+ });
48
+
49
+ provide(SPACETIMEDB_INJECTION_KEY, state);
50
+
51
+ let onConnectCallback: ((conn: DbConnection) => void) | null = null;
52
+ let onDisconnectCallback:
53
+ | ((ctx: ErrorContextInterface<RemoteModuleOf<DbConnection>>) => void)
54
+ | null = null;
55
+ let onConnectErrorCallback:
56
+ | ((
57
+ ctx: ErrorContextInterface<RemoteModuleOf<DbConnection>>,
58
+ err: Error
59
+ ) => void)
60
+ | null = null;
61
+
62
+ onMounted(() => {
63
+ if (cleanupTimeoutId) {
64
+ clearTimeout(cleanupTimeoutId);
65
+ cleanupTimeoutId = null;
66
+ }
67
+
68
+ if (!connRef) {
69
+ connRef = connectionBuilder.build();
70
+ }
71
+
72
+ onConnectCallback = (conn: DbConnection) => {
73
+ state.isActive = conn.isActive;
74
+ state.identity = conn.identity;
75
+ state.token = conn.token;
76
+ state.connectionId = conn.connectionId;
77
+ state.connectionError = undefined;
78
+ };
79
+
80
+ onDisconnectCallback = (
81
+ ctx: ErrorContextInterface<RemoteModuleOf<DbConnection>>
82
+ ) => {
83
+ state.isActive = ctx.isActive;
84
+ };
85
+
86
+ onConnectErrorCallback = (
87
+ ctx: ErrorContextInterface<RemoteModuleOf<DbConnection>>,
88
+ err: Error
89
+ ) => {
90
+ state.isActive = ctx.isActive;
91
+ state.connectionError = err;
92
+ };
93
+
94
+ connectionBuilder.onConnect(onConnectCallback);
95
+ connectionBuilder.onDisconnect(onDisconnectCallback);
96
+ connectionBuilder.onConnectError(onConnectErrorCallback);
97
+
98
+ const conn = connRef;
99
+ if (conn) {
100
+ state.isActive = conn.isActive;
101
+ state.identity = conn.identity;
102
+ state.token = conn.token;
103
+ state.connectionId = conn.connectionId;
104
+ }
105
+ });
106
+
107
+ const cleanup = () => {
108
+ if (connRef) {
109
+ if (onConnectCallback) {
110
+ connRef.removeOnConnect?.(onConnectCallback as any);
111
+ }
112
+ if (onDisconnectCallback) {
113
+ connRef.removeOnDisconnect?.(onDisconnectCallback as any);
114
+ }
115
+ if (onConnectErrorCallback) {
116
+ connRef.removeOnConnectError?.(onConnectErrorCallback as any);
117
+ }
118
+
119
+ cleanupTimeoutId = setTimeout(() => {
120
+ connRef?.disconnect();
121
+ connRef = null;
122
+ cleanupTimeoutId = null;
123
+ }, 0);
124
+ }
125
+ };
126
+
127
+ onUnmounted(cleanup);
128
+
129
+ return { state, cleanup };
130
+ }
131
+
132
+ export const SpacetimeDBProvider = defineComponent({
133
+ name: 'SpacetimeDBProvider',
134
+
135
+ props: {
136
+ connectionBuilder: {
137
+ type: Object as PropType<DbConnectionBuilder<any>>,
138
+ required: true,
139
+ },
140
+ },
141
+
142
+ setup(props, { slots }) {
143
+ setupConnection(props.connectionBuilder);
144
+
145
+ return () => {
146
+ const defaultSlot = slots.default as Slot | undefined;
147
+ return defaultSlot ? defaultSlot() : null;
148
+ };
149
+ },
150
+ });
151
+
152
+ export function useSpacetimeDBProvider<
153
+ DbConnection extends DbConnectionImpl<any>,
154
+ >(connectionBuilder: DbConnectionBuilder<DbConnection>): ConnectionState {
155
+ const { state } = setupConnection(connectionBuilder);
156
+ return state;
157
+ }
@@ -1,19 +1,19 @@
1
- import type { InjectionKey } from 'vue';
2
- import type { ConnectionId } from '../lib/connection_id';
3
- import type { Identity } from '../lib/identity';
4
- import type { DbConnectionImpl } from '../sdk/db_connection_impl';
5
-
6
- export interface ConnectionState {
7
- isActive: boolean;
8
- identity?: Identity;
9
- token?: string;
10
- connectionId: ConnectionId;
11
- connectionError?: Error;
12
- getConnection<
13
- DbConnection extends DbConnectionImpl<any>,
14
- >(): DbConnection | null;
15
- }
16
-
17
- export const SPACETIMEDB_INJECTION_KEY = Symbol(
18
- 'spacetimedb'
19
- ) as InjectionKey<ConnectionState>;
1
+ import type { InjectionKey } from 'vue';
2
+ import type { ConnectionId } from '../lib/connection_id';
3
+ import type { Identity } from '../lib/identity';
4
+ import type { DbConnectionImpl } from '../sdk/db_connection_impl';
5
+
6
+ export interface ConnectionState {
7
+ isActive: boolean;
8
+ identity?: Identity;
9
+ token?: string;
10
+ connectionId: ConnectionId;
11
+ connectionError?: Error;
12
+ getConnection<
13
+ DbConnection extends DbConnectionImpl<any>,
14
+ >(): DbConnection | null;
15
+ }
16
+
17
+ export const SPACETIMEDB_INJECTION_KEY = Symbol(
18
+ 'spacetimedb'
19
+ ) as InjectionKey<ConnectionState>;
package/src/vue/index.ts CHANGED
@@ -1,5 +1,5 @@
1
- export * from './SpacetimeDBProvider.ts';
2
- export { useSpacetimeDB } from './useSpacetimeDB.ts';
3
- export { useTable } from './useTable.ts';
4
- export { useReducer } from './useReducer.ts';
5
- export { useProcedure } from './useProcedure.ts';
1
+ export * from './SpacetimeDBProvider.ts';
2
+ export { useSpacetimeDB } from './useSpacetimeDB.ts';
3
+ export { useTable } from './useTable.ts';
4
+ export { useReducer } from './useReducer.ts';
5
+ export { useProcedure } from './useProcedure.ts';