spacetimedb 2.5.0 → 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 (180) hide show
  1. package/LICENSE.txt +759 -759
  2. package/README.md +211 -211
  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 +120 -50
  9. package/dist/browser/solid/index.mjs.map +1 -1
  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/index.cjs +120 -50
  44. package/dist/solid/index.cjs.map +1 -1
  45. package/dist/solid/index.mjs +120 -50
  46. package/dist/solid/index.mjs.map +1 -1
  47. package/dist/svelte/index.cjs.map +1 -1
  48. package/dist/svelte/index.mjs.map +1 -1
  49. package/dist/tanstack/index.cjs +120 -50
  50. package/dist/tanstack/index.cjs.map +1 -1
  51. package/dist/tanstack/index.mjs +120 -50
  52. package/dist/tanstack/index.mjs.map +1 -1
  53. package/dist/vue/index.cjs.map +1 -1
  54. package/dist/vue/index.mjs.map +1 -1
  55. package/package.json +1 -1
  56. package/src/angular/connection_state.ts +19 -19
  57. package/src/angular/index.ts +3 -3
  58. package/src/angular/injectors/index.ts +4 -4
  59. package/src/angular/injectors/inject-reducer.ts +62 -62
  60. package/src/angular/injectors/inject-spacetimedb-connected.ts +13 -13
  61. package/src/angular/injectors/inject-spacetimedb.ts +10 -10
  62. package/src/angular/injectors/inject-table.ts +234 -234
  63. package/src/angular/providers/index.ts +1 -1
  64. package/src/angular/providers/provide-spacetimedb.ts +96 -96
  65. package/src/index.ts +16 -16
  66. package/src/lib/algebraic_type.ts +819 -819
  67. package/src/lib/algebraic_type_variants.ts +26 -26
  68. package/src/lib/algebraic_value.ts +10 -10
  69. package/src/lib/autogen/types.ts +746 -746
  70. package/src/lib/binary_reader.ts +188 -188
  71. package/src/lib/binary_writer.ts +213 -213
  72. package/src/lib/connection_id.ts +102 -102
  73. package/src/lib/constraints.ts +48 -48
  74. package/src/lib/errors.ts +26 -26
  75. package/src/lib/filter.ts +195 -195
  76. package/src/lib/identity.ts +83 -83
  77. package/src/lib/indexes.ts +251 -251
  78. package/src/lib/option.ts +34 -34
  79. package/src/lib/query.ts +1019 -1019
  80. package/src/lib/reducer_schema.ts +38 -38
  81. package/src/lib/reducers.ts +116 -116
  82. package/src/lib/result.ts +36 -36
  83. package/src/lib/schedule_at.ts +86 -86
  84. package/src/lib/schema.ts +420 -420
  85. package/src/lib/table.ts +548 -548
  86. package/src/lib/table_schema.ts +64 -64
  87. package/src/lib/time_duration.ts +77 -77
  88. package/src/lib/timestamp.ts +148 -148
  89. package/src/lib/type_builders.test-d.ts +128 -128
  90. package/src/lib/type_builders.ts +4014 -4014
  91. package/src/lib/type_util.ts +124 -124
  92. package/src/lib/util.ts +196 -196
  93. package/src/lib/uuid.ts +337 -337
  94. package/src/react/SpacetimeDBProvider.ts +84 -84
  95. package/src/react/connection_state.ts +6 -6
  96. package/src/react/index.ts +5 -5
  97. package/src/react/useProcedure.ts +60 -60
  98. package/src/react/useReducer.ts +53 -53
  99. package/src/react/useSpacetimeDB.ts +18 -18
  100. package/src/react/useTable.ts +256 -251
  101. package/src/sdk/client_api/index.ts +114 -114
  102. package/src/sdk/client_api/types/procedures.ts +8 -8
  103. package/src/sdk/client_api/types/reducers.ts +8 -8
  104. package/src/sdk/client_api/types.ts +288 -288
  105. package/src/sdk/client_cache.ts +129 -129
  106. package/src/sdk/client_table.ts +179 -179
  107. package/src/sdk/connection_manager.ts +352 -237
  108. package/src/sdk/db_connection_builder.ts +290 -290
  109. package/src/sdk/db_connection_impl.ts +1356 -1347
  110. package/src/sdk/db_context.ts +28 -28
  111. package/src/sdk/db_view.ts +12 -12
  112. package/src/sdk/decompress.ts +51 -51
  113. package/src/sdk/event.ts +18 -18
  114. package/src/sdk/event_context.ts +51 -51
  115. package/src/sdk/event_emitter.ts +32 -32
  116. package/src/sdk/index.ts +14 -14
  117. package/src/sdk/internal.ts +2 -2
  118. package/src/sdk/json_api.ts +46 -46
  119. package/src/sdk/logger.ts +134 -134
  120. package/src/sdk/message_types.ts +46 -46
  121. package/src/sdk/procedures.ts +83 -83
  122. package/src/sdk/reducer_event.ts +20 -20
  123. package/src/sdk/reducer_handle.ts +12 -12
  124. package/src/sdk/reducers.ts +159 -159
  125. package/src/sdk/schema.ts +45 -45
  126. package/src/sdk/spacetime_module.ts +28 -28
  127. package/src/sdk/subscription_builder_impl.ts +275 -275
  128. package/src/sdk/table_cache.ts +581 -581
  129. package/src/sdk/type_utils.ts +19 -19
  130. package/src/sdk/version.ts +133 -133
  131. package/src/sdk/websocket_decompress_adapter.ts +63 -63
  132. package/src/sdk/websocket_protocols.ts +25 -25
  133. package/src/sdk/websocket_test_adapter.ts +107 -100
  134. package/src/sdk/websocket_v3_frames.ts +126 -126
  135. package/src/sdk/ws.ts +105 -105
  136. package/src/server/console.ts +81 -81
  137. package/src/server/db_view.ts +21 -21
  138. package/src/server/errors.ts +138 -138
  139. package/src/server/http.test-d.ts +80 -80
  140. package/src/server/http.ts +14 -14
  141. package/src/server/http_handlers.ts +413 -413
  142. package/src/server/http_internal.ts +79 -79
  143. package/src/server/http_shared.ts +186 -186
  144. package/src/server/index.ts +37 -37
  145. package/src/server/polyfills.ts +4 -4
  146. package/src/server/procedures.ts +239 -239
  147. package/src/server/query.ts +1 -1
  148. package/src/server/range.ts +53 -53
  149. package/src/server/reducers.ts +113 -113
  150. package/src/server/rng.ts +113 -113
  151. package/src/server/runtime.ts +1102 -1102
  152. package/src/server/schema.test-d.ts +99 -99
  153. package/src/server/schema.ts +663 -663
  154. package/src/server/sys.d.ts +125 -125
  155. package/src/server/view.test-d.ts +194 -194
  156. package/src/server/views.ts +340 -340
  157. package/src/solid/SpacetimeDBProvider.ts +97 -97
  158. package/src/solid/connection_state.ts +6 -6
  159. package/src/solid/index.ts +5 -5
  160. package/src/solid/useProcedure.ts +57 -57
  161. package/src/solid/useReducer.ts +50 -50
  162. package/src/solid/useSpacetimeDB.ts +18 -18
  163. package/src/solid/useTable.ts +203 -203
  164. package/src/svelte/SpacetimeDBProvider.ts +101 -101
  165. package/src/svelte/connection_state.ts +16 -16
  166. package/src/svelte/index.ts +4 -4
  167. package/src/svelte/useReducer.ts +61 -61
  168. package/src/svelte/useSpacetimeDB.ts +22 -22
  169. package/src/svelte/useTable.ts +218 -218
  170. package/src/tanstack/SpacetimeDBQueryClient.ts +330 -330
  171. package/src/tanstack/hooks.ts +83 -83
  172. package/src/tanstack/index.ts +16 -16
  173. package/src/util-stub.ts +1 -1
  174. package/src/vue/SpacetimeDBProvider.ts +157 -157
  175. package/src/vue/connection_state.ts +19 -19
  176. package/src/vue/index.ts +5 -5
  177. package/src/vue/useProcedure.ts +62 -62
  178. package/src/vue/useReducer.ts +55 -55
  179. package/src/vue/useSpacetimeDB.ts +18 -18
  180. 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;