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
@@ -1,124 +1,124 @@
1
- import type { ConnectionId } from './connection_id';
2
- import type { Identity } from './identity';
3
- import type { ScheduleAt } from './schedule_at';
4
- import type { TimeDuration } from './time_duration';
5
- import type { Timestamp } from './timestamp';
6
-
7
- type DoNotPrettify =
8
- | Identity
9
- | ConnectionId
10
- | Timestamp
11
- | TimeDuration
12
- | ScheduleAt;
13
-
14
- /**
15
- * Utility to make TS show cleaner types by flattening intersections.
16
- */
17
- export type Prettify<T> = T extends DoNotPrettify
18
- ? T
19
- : { [K in keyof T]: T[K] } & {};
20
-
21
- /**
22
- * Helper function to sets a field in an object
23
- */
24
- export type SetField<T, F extends string, V> = Prettify<
25
- Omit<T, F> & { [K in F]: V }
26
- >;
27
-
28
- /**
29
- * Sets a field in an object
30
- * @param x The original object
31
- * @param t The object containing the field to set
32
- * @returns A new object with the field set
33
- */
34
- export function set<T, F extends string, V>(
35
- x: T,
36
- t: { [k in F]: V }
37
- ): SetField<T, F, V> {
38
- return { ...x, ...t } as SetField<T, F, V>;
39
- }
40
-
41
- /**
42
- * Helper to extract the value types from an object type
43
- */
44
- export type Values<T> = T[keyof T];
45
-
46
- /**
47
- * A helper type to collapse a tuple into a single type if it has only one element.
48
- */
49
- export type CollapseTuple<A extends any[]> = A extends [infer T] ? T : A;
50
-
51
- type CamelCaseImpl<S extends string> = S extends `${infer Head}_${infer Tail}`
52
- ? `${Head}${Capitalize<CamelCaseImpl<Tail>>}`
53
- : S extends `${infer Head}-${infer Tail}`
54
- ? `${Head}${Capitalize<CamelCaseImpl<Tail>>}`
55
- : S;
56
-
57
- /**
58
- * Convert "Some_identifier-name" -> "someIdentifierName"
59
- * - No spaces; allowed separators: "_" and "-"
60
- * - Normalizes the *first* character to lowercase (e.g. "User_Name" -> "userName")
61
- */
62
- export type CamelCase<S extends string> = Uncapitalize<CamelCaseImpl<S>>;
63
-
64
- /** Type safe conversion from "some_identifier-name" to "some_identifier_name"
65
- * - No spaces; allowed separators: "_" and "-"
66
- * - Normalizes the *first* character to lowercase (e.g. "User_Name" -> "user_name")
67
- */
68
- export type SnakeCase<S extends string> = S extends `${infer Head}${infer Tail}`
69
- ? Tail extends Uncapitalize<Tail>
70
- ? `${Lowercase<Head>}${SnakeCase<Tail>}`
71
- : `${Lowercase<Head>}_${SnakeCase<Tail>}`
72
- : Lowercase<S>;
73
-
74
- type PascalCaseImpl<S extends string> = S extends `${infer Head}_${infer Tail}`
75
- ? `${Capitalize<Head>}${PascalCaseImpl<Tail>}`
76
- : S extends `${infer Head}-${infer Tail}`
77
- ? `${Capitalize<Head>}${PascalCaseImpl<Tail>}`
78
- : Capitalize<S>;
79
-
80
- /**
81
- * Convert "some_identifier-name" -> "SomeIdentifierName"
82
- * - No spaces; allowed separators: "_" and "-"
83
- * - Normalizes the *first* character to uppercase (e.g. "user_name" -> "UserName")
84
- */
85
- export type PascalCase<S extends string> = PascalCaseImpl<S>;
86
-
87
- /**
88
- * Check if a metadata type has fields that are incompatible with default values.
89
- * Default values cannot be combined with isPrimaryKey, isUnique, or isAutoIncrement.
90
- */
91
- export type HasDefaultIncompatibleFields<M> = M extends {
92
- isPrimaryKey: true;
93
- }
94
- ? true
95
- : M extends { isUnique: true }
96
- ? true
97
- : M extends { isAutoIncrement: true }
98
- ? true
99
- : false;
100
-
101
- /**
102
- * Check if a metadata type has a default value set.
103
- */
104
- export type HasDefaultValue<M> = M extends { defaultValue: any } ? true : false;
105
-
106
- /**
107
- * Validate that a column's metadata doesn't have invalid combinations.
108
- * Returns the metadata type if valid, or an error type if invalid.
109
- */
110
- export type ValidateColumnMetadata<M> =
111
- HasDefaultValue<M> extends true
112
- ? HasDefaultIncompatibleFields<M> extends true
113
- ? InvalidColumnMetadata<'default() cannot be combined with primaryKey(), unique(), or autoInc()'>
114
- : M
115
- : M;
116
-
117
- /**
118
- * Error type for invalid column metadata combinations.
119
- * This type is designed to cause a compile-time error with a descriptive message.
120
- */
121
- export type InvalidColumnMetadata<Message extends string> = {
122
- __error: Message;
123
- __brand: 'InvalidColumnMetadata';
124
- };
1
+ import type { ConnectionId } from './connection_id';
2
+ import type { Identity } from './identity';
3
+ import type { ScheduleAt } from './schedule_at';
4
+ import type { TimeDuration } from './time_duration';
5
+ import type { Timestamp } from './timestamp';
6
+
7
+ type DoNotPrettify =
8
+ | Identity
9
+ | ConnectionId
10
+ | Timestamp
11
+ | TimeDuration
12
+ | ScheduleAt;
13
+
14
+ /**
15
+ * Utility to make TS show cleaner types by flattening intersections.
16
+ */
17
+ export type Prettify<T> = T extends DoNotPrettify
18
+ ? T
19
+ : { [K in keyof T]: T[K] } & {};
20
+
21
+ /**
22
+ * Helper function to sets a field in an object
23
+ */
24
+ export type SetField<T, F extends string, V> = Prettify<
25
+ Omit<T, F> & { [K in F]: V }
26
+ >;
27
+
28
+ /**
29
+ * Sets a field in an object
30
+ * @param x The original object
31
+ * @param t The object containing the field to set
32
+ * @returns A new object with the field set
33
+ */
34
+ export function set<T, F extends string, V>(
35
+ x: T,
36
+ t: { [k in F]: V }
37
+ ): SetField<T, F, V> {
38
+ return { ...x, ...t } as SetField<T, F, V>;
39
+ }
40
+
41
+ /**
42
+ * Helper to extract the value types from an object type
43
+ */
44
+ export type Values<T> = T[keyof T];
45
+
46
+ /**
47
+ * A helper type to collapse a tuple into a single type if it has only one element.
48
+ */
49
+ export type CollapseTuple<A extends any[]> = A extends [infer T] ? T : A;
50
+
51
+ type CamelCaseImpl<S extends string> = S extends `${infer Head}_${infer Tail}`
52
+ ? `${Head}${Capitalize<CamelCaseImpl<Tail>>}`
53
+ : S extends `${infer Head}-${infer Tail}`
54
+ ? `${Head}${Capitalize<CamelCaseImpl<Tail>>}`
55
+ : S;
56
+
57
+ /**
58
+ * Convert "Some_identifier-name" -> "someIdentifierName"
59
+ * - No spaces; allowed separators: "_" and "-"
60
+ * - Normalizes the *first* character to lowercase (e.g. "User_Name" -> "userName")
61
+ */
62
+ export type CamelCase<S extends string> = Uncapitalize<CamelCaseImpl<S>>;
63
+
64
+ /** Type safe conversion from "some_identifier-name" to "some_identifier_name"
65
+ * - No spaces; allowed separators: "_" and "-"
66
+ * - Normalizes the *first* character to lowercase (e.g. "User_Name" -> "user_name")
67
+ */
68
+ export type SnakeCase<S extends string> = S extends `${infer Head}${infer Tail}`
69
+ ? Tail extends Uncapitalize<Tail>
70
+ ? `${Lowercase<Head>}${SnakeCase<Tail>}`
71
+ : `${Lowercase<Head>}_${SnakeCase<Tail>}`
72
+ : Lowercase<S>;
73
+
74
+ type PascalCaseImpl<S extends string> = S extends `${infer Head}_${infer Tail}`
75
+ ? `${Capitalize<Head>}${PascalCaseImpl<Tail>}`
76
+ : S extends `${infer Head}-${infer Tail}`
77
+ ? `${Capitalize<Head>}${PascalCaseImpl<Tail>}`
78
+ : Capitalize<S>;
79
+
80
+ /**
81
+ * Convert "some_identifier-name" -> "SomeIdentifierName"
82
+ * - No spaces; allowed separators: "_" and "-"
83
+ * - Normalizes the *first* character to uppercase (e.g. "user_name" -> "UserName")
84
+ */
85
+ export type PascalCase<S extends string> = PascalCaseImpl<S>;
86
+
87
+ /**
88
+ * Check if a metadata type has fields that are incompatible with default values.
89
+ * Default values cannot be combined with isPrimaryKey, isUnique, or isAutoIncrement.
90
+ */
91
+ export type HasDefaultIncompatibleFields<M> = M extends {
92
+ isPrimaryKey: true;
93
+ }
94
+ ? true
95
+ : M extends { isUnique: true }
96
+ ? true
97
+ : M extends { isAutoIncrement: true }
98
+ ? true
99
+ : false;
100
+
101
+ /**
102
+ * Check if a metadata type has a default value set.
103
+ */
104
+ export type HasDefaultValue<M> = M extends { defaultValue: any } ? true : false;
105
+
106
+ /**
107
+ * Validate that a column's metadata doesn't have invalid combinations.
108
+ * Returns the metadata type if valid, or an error type if invalid.
109
+ */
110
+ export type ValidateColumnMetadata<M> =
111
+ HasDefaultValue<M> extends true
112
+ ? HasDefaultIncompatibleFields<M> extends true
113
+ ? InvalidColumnMetadata<'default() cannot be combined with primaryKey(), unique(), or autoInc()'>
114
+ : M
115
+ : M;
116
+
117
+ /**
118
+ * Error type for invalid column metadata combinations.
119
+ * This type is designed to cause a compile-time error with a descriptive message.
120
+ */
121
+ export type InvalidColumnMetadata<Message extends string> = {
122
+ __error: Message;
123
+ __brand: 'InvalidColumnMetadata';
124
+ };
package/src/lib/util.ts CHANGED
@@ -1,196 +1,196 @@
1
- import type { AlgebraicType } from './algebraic_type';
2
- import type { Typespace } from './autogen/types';
3
- import BinaryReader from './binary_reader';
4
- import BinaryWriter from './binary_writer';
5
- import type { ParamsObj } from './reducers';
6
- import type { ColumnBuilder, TypeBuilder } from './type_builders';
7
- import type { CamelCase, SnakeCase } from './type_util';
8
-
9
- export function deepEqual(obj1: any, obj2: any): boolean {
10
- // If both are strictly equal (covers primitives and reference equality), return true
11
- if (obj1 === obj2) return true;
12
-
13
- // If either is a primitive type or one is null, return false since we already checked for strict equality
14
- if (
15
- typeof obj1 !== 'object' ||
16
- obj1 === null ||
17
- typeof obj2 !== 'object' ||
18
- obj2 === null
19
- ) {
20
- return false;
21
- }
22
-
23
- // Get keys of both objects
24
- const keys1 = Object.keys(obj1);
25
- const keys2 = Object.keys(obj2);
26
-
27
- // If number of keys is different, return false
28
- if (keys1.length !== keys2.length) return false;
29
-
30
- // Check all keys and compare values recursively
31
- for (const key of keys1) {
32
- if (!keys2.includes(key) || !deepEqual(obj1[key], obj2[key])) {
33
- return false;
34
- }
35
- }
36
-
37
- return true;
38
- }
39
-
40
- export function uint8ArrayToHexString(array: Uint8Array): string {
41
- return Array.prototype.map
42
- .call(array.reverse(), x => ('00' + x.toString(16)).slice(-2))
43
- .join('');
44
- }
45
-
46
- export function uint8ArrayToU128(array: Uint8Array): bigint {
47
- if (array.length != 16) {
48
- throw new Error(`Uint8Array is not 16 bytes long: ${array}`);
49
- }
50
- return new BinaryReader(array).readU128();
51
- }
52
-
53
- export function uint8ArrayToU256(array: Uint8Array): bigint {
54
- if (array.length != 32) {
55
- throw new Error(`Uint8Array is not 32 bytes long: [${array}]`);
56
- }
57
- return new BinaryReader(array).readU256();
58
- }
59
-
60
- export function hexStringToUint8Array(str: string): Uint8Array {
61
- if (str.startsWith('0x')) {
62
- str = str.slice(2);
63
- }
64
- const matches = str.match(/.{1,2}/g) || [];
65
- const data = Uint8Array.from(
66
- matches.map((byte: string) => parseInt(byte, 16))
67
- );
68
- return data.reverse();
69
- }
70
-
71
- export function hexStringToU128(str: string): bigint {
72
- return uint8ArrayToU128(hexStringToUint8Array(str));
73
- }
74
-
75
- export function hexStringToU256(str: string): bigint {
76
- return uint8ArrayToU256(hexStringToUint8Array(str));
77
- }
78
-
79
- export function u128ToUint8Array(data: bigint): Uint8Array {
80
- const writer = new BinaryWriter(16);
81
- writer.writeU128(data);
82
- return writer.getBuffer();
83
- }
84
-
85
- export function u128ToHexString(data: bigint): string {
86
- return uint8ArrayToHexString(u128ToUint8Array(data));
87
- }
88
-
89
- export function u256ToUint8Array(data: bigint): Uint8Array {
90
- const writer = new BinaryWriter(32);
91
- writer.writeU256(data);
92
- return writer.getBuffer();
93
- }
94
-
95
- export function u256ToHexString(data: bigint): string {
96
- return uint8ArrayToHexString(u256ToUint8Array(data));
97
- }
98
-
99
- /**
100
- * Converts a string to PascalCase (UpperCamelCase).
101
- * @param str The string to convert
102
- * @returns The converted string
103
- */
104
- export function toPascalCase(s: string): string {
105
- const str = toCamelCase(s);
106
- return str.charAt(0).toUpperCase() + str.slice(1);
107
- }
108
-
109
- /**
110
- * Type safe conversion from a string like "some_identifier-name" to "someIdentifierName".
111
- * @param str The string to convert
112
- * @returns The converted string
113
- */
114
- export function toCamelCase<T extends string>(s: T): CamelCase<T> {
115
- const str = s
116
- .replace(/[-_]+/g, '_') // collapse runs to a single separator (no backtracking issue)
117
- .replace(/_([a-zA-Z0-9])/g, (_, c) => c.toUpperCase());
118
- return (str.charAt(0).toLowerCase() + str.slice(1)) as CamelCase<T>;
119
- }
120
-
121
- /** Type safe conversion from a string like "some_Identifier-name" to "some_identifier_name".
122
- * @param str The string to convert
123
- * @returns The converted string
124
- */
125
- export function toSnakeCase<T extends string>(str: T): SnakeCase<T> {
126
- return str
127
- .replace(/([A-Z])/g, '_$1') // insert underscores before capitals
128
- .replace(/[-\s]+/g, '_') // replace spaces and dashes with underscores
129
- .toLowerCase() as SnakeCase<T>;
130
- }
131
-
132
- export function bsatnBaseSize(typespace: Typespace, ty: AlgebraicType): number {
133
- const assumedArrayLength = 4;
134
- while (ty.tag === 'Ref') ty = typespace.types[ty.value];
135
- if (ty.tag === 'Product') {
136
- let sum = 0;
137
- for (const { algebraicType: elem } of ty.value.elements) {
138
- sum += bsatnBaseSize(typespace, elem);
139
- }
140
- return sum;
141
- } else if (ty.tag === 'Sum') {
142
- let min = Infinity;
143
- for (const { algebraicType: vari } of ty.value.variants) {
144
- const vSize = bsatnBaseSize(typespace, vari);
145
- if (vSize < min) min = vSize;
146
- }
147
- if (min === Infinity) min = 0;
148
- return 4 + min;
149
- } else if (ty.tag == 'Array') {
150
- return 4 + assumedArrayLength * bsatnBaseSize(typespace, ty.value);
151
- }
152
- return {
153
- String: 4 + assumedArrayLength,
154
- Sum: 1,
155
- Bool: 1,
156
- I8: 1,
157
- U8: 1,
158
- I16: 2,
159
- U16: 2,
160
- I32: 4,
161
- U32: 4,
162
- F32: 4,
163
- I64: 8,
164
- U64: 8,
165
- F64: 8,
166
- I128: 16,
167
- U128: 16,
168
- I256: 32,
169
- U256: 32,
170
- }[ty.tag];
171
- }
172
-
173
- export type CoerceTypeBuilder<
174
- Col extends TypeBuilder<any, any> | ColumnBuilder<any, any, any>,
175
- > = Col extends ColumnBuilder<any, any> ? Col['typeBuilder'] : Col;
176
-
177
- export type CoerceParams<Params extends ParamsObj> = {
178
- [k in keyof Params & string]: CoerceTypeBuilder<Params[k]>;
179
- };
180
-
181
- export function coerceParams<Params extends ParamsObj>(
182
- params: Params
183
- ): CoerceParams<Params> {
184
- return Object.fromEntries(
185
- Object.entries(params).map(([n, c]) => [
186
- n,
187
- 'typeBuilder' in c ? c.typeBuilder : c,
188
- ])
189
- ) as CoerceParams<Params>;
190
- }
191
-
192
- export const hasOwn: <K extends PropertyKey>(
193
- o: object,
194
- k: K
195
- ) => o is K extends PropertyKey ? { [k in K]: unknown } : never =
196
- Object.hasOwn as any;
1
+ import type { AlgebraicType } from './algebraic_type';
2
+ import type { Typespace } from './autogen/types';
3
+ import BinaryReader from './binary_reader';
4
+ import BinaryWriter from './binary_writer';
5
+ import type { ParamsObj } from './reducers';
6
+ import type { ColumnBuilder, TypeBuilder } from './type_builders';
7
+ import type { CamelCase, SnakeCase } from './type_util';
8
+
9
+ export function deepEqual(obj1: any, obj2: any): boolean {
10
+ // If both are strictly equal (covers primitives and reference equality), return true
11
+ if (obj1 === obj2) return true;
12
+
13
+ // If either is a primitive type or one is null, return false since we already checked for strict equality
14
+ if (
15
+ typeof obj1 !== 'object' ||
16
+ obj1 === null ||
17
+ typeof obj2 !== 'object' ||
18
+ obj2 === null
19
+ ) {
20
+ return false;
21
+ }
22
+
23
+ // Get keys of both objects
24
+ const keys1 = Object.keys(obj1);
25
+ const keys2 = Object.keys(obj2);
26
+
27
+ // If number of keys is different, return false
28
+ if (keys1.length !== keys2.length) return false;
29
+
30
+ // Check all keys and compare values recursively
31
+ for (const key of keys1) {
32
+ if (!keys2.includes(key) || !deepEqual(obj1[key], obj2[key])) {
33
+ return false;
34
+ }
35
+ }
36
+
37
+ return true;
38
+ }
39
+
40
+ export function uint8ArrayToHexString(array: Uint8Array): string {
41
+ return Array.prototype.map
42
+ .call(array.reverse(), x => ('00' + x.toString(16)).slice(-2))
43
+ .join('');
44
+ }
45
+
46
+ export function uint8ArrayToU128(array: Uint8Array): bigint {
47
+ if (array.length != 16) {
48
+ throw new Error(`Uint8Array is not 16 bytes long: ${array}`);
49
+ }
50
+ return new BinaryReader(array).readU128();
51
+ }
52
+
53
+ export function uint8ArrayToU256(array: Uint8Array): bigint {
54
+ if (array.length != 32) {
55
+ throw new Error(`Uint8Array is not 32 bytes long: [${array}]`);
56
+ }
57
+ return new BinaryReader(array).readU256();
58
+ }
59
+
60
+ export function hexStringToUint8Array(str: string): Uint8Array {
61
+ if (str.startsWith('0x')) {
62
+ str = str.slice(2);
63
+ }
64
+ const matches = str.match(/.{1,2}/g) || [];
65
+ const data = Uint8Array.from(
66
+ matches.map((byte: string) => parseInt(byte, 16))
67
+ );
68
+ return data.reverse();
69
+ }
70
+
71
+ export function hexStringToU128(str: string): bigint {
72
+ return uint8ArrayToU128(hexStringToUint8Array(str));
73
+ }
74
+
75
+ export function hexStringToU256(str: string): bigint {
76
+ return uint8ArrayToU256(hexStringToUint8Array(str));
77
+ }
78
+
79
+ export function u128ToUint8Array(data: bigint): Uint8Array {
80
+ const writer = new BinaryWriter(16);
81
+ writer.writeU128(data);
82
+ return writer.getBuffer();
83
+ }
84
+
85
+ export function u128ToHexString(data: bigint): string {
86
+ return uint8ArrayToHexString(u128ToUint8Array(data));
87
+ }
88
+
89
+ export function u256ToUint8Array(data: bigint): Uint8Array {
90
+ const writer = new BinaryWriter(32);
91
+ writer.writeU256(data);
92
+ return writer.getBuffer();
93
+ }
94
+
95
+ export function u256ToHexString(data: bigint): string {
96
+ return uint8ArrayToHexString(u256ToUint8Array(data));
97
+ }
98
+
99
+ /**
100
+ * Converts a string to PascalCase (UpperCamelCase).
101
+ * @param str The string to convert
102
+ * @returns The converted string
103
+ */
104
+ export function toPascalCase(s: string): string {
105
+ const str = toCamelCase(s);
106
+ return str.charAt(0).toUpperCase() + str.slice(1);
107
+ }
108
+
109
+ /**
110
+ * Type safe conversion from a string like "some_identifier-name" to "someIdentifierName".
111
+ * @param str The string to convert
112
+ * @returns The converted string
113
+ */
114
+ export function toCamelCase<T extends string>(s: T): CamelCase<T> {
115
+ const str = s
116
+ .replace(/[-_]+/g, '_') // collapse runs to a single separator (no backtracking issue)
117
+ .replace(/_([a-zA-Z0-9])/g, (_, c) => c.toUpperCase());
118
+ return (str.charAt(0).toLowerCase() + str.slice(1)) as CamelCase<T>;
119
+ }
120
+
121
+ /** Type safe conversion from a string like "some_Identifier-name" to "some_identifier_name".
122
+ * @param str The string to convert
123
+ * @returns The converted string
124
+ */
125
+ export function toSnakeCase<T extends string>(str: T): SnakeCase<T> {
126
+ return str
127
+ .replace(/([A-Z])/g, '_$1') // insert underscores before capitals
128
+ .replace(/[-\s]+/g, '_') // replace spaces and dashes with underscores
129
+ .toLowerCase() as SnakeCase<T>;
130
+ }
131
+
132
+ export function bsatnBaseSize(typespace: Typespace, ty: AlgebraicType): number {
133
+ const assumedArrayLength = 4;
134
+ while (ty.tag === 'Ref') ty = typespace.types[ty.value];
135
+ if (ty.tag === 'Product') {
136
+ let sum = 0;
137
+ for (const { algebraicType: elem } of ty.value.elements) {
138
+ sum += bsatnBaseSize(typespace, elem);
139
+ }
140
+ return sum;
141
+ } else if (ty.tag === 'Sum') {
142
+ let min = Infinity;
143
+ for (const { algebraicType: vari } of ty.value.variants) {
144
+ const vSize = bsatnBaseSize(typespace, vari);
145
+ if (vSize < min) min = vSize;
146
+ }
147
+ if (min === Infinity) min = 0;
148
+ return 4 + min;
149
+ } else if (ty.tag == 'Array') {
150
+ return 4 + assumedArrayLength * bsatnBaseSize(typespace, ty.value);
151
+ }
152
+ return {
153
+ String: 4 + assumedArrayLength,
154
+ Sum: 1,
155
+ Bool: 1,
156
+ I8: 1,
157
+ U8: 1,
158
+ I16: 2,
159
+ U16: 2,
160
+ I32: 4,
161
+ U32: 4,
162
+ F32: 4,
163
+ I64: 8,
164
+ U64: 8,
165
+ F64: 8,
166
+ I128: 16,
167
+ U128: 16,
168
+ I256: 32,
169
+ U256: 32,
170
+ }[ty.tag];
171
+ }
172
+
173
+ export type CoerceTypeBuilder<
174
+ Col extends TypeBuilder<any, any> | ColumnBuilder<any, any, any>,
175
+ > = Col extends ColumnBuilder<any, any> ? Col['typeBuilder'] : Col;
176
+
177
+ export type CoerceParams<Params extends ParamsObj> = {
178
+ [k in keyof Params & string]: CoerceTypeBuilder<Params[k]>;
179
+ };
180
+
181
+ export function coerceParams<Params extends ParamsObj>(
182
+ params: Params
183
+ ): CoerceParams<Params> {
184
+ return Object.fromEntries(
185
+ Object.entries(params).map(([n, c]) => [
186
+ n,
187
+ 'typeBuilder' in c ? c.typeBuilder : c,
188
+ ])
189
+ ) as CoerceParams<Params>;
190
+ }
191
+
192
+ export const hasOwn: <K extends PropertyKey>(
193
+ o: object,
194
+ k: K
195
+ ) => o is K extends PropertyKey ? { [k in K]: unknown } : never =
196
+ Object.hasOwn as any;