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,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;