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.
- package/LICENSE.txt +759 -759
- package/README.md +211 -211
- package/dist/angular/index.cjs.map +1 -1
- package/dist/angular/index.mjs.map +1 -1
- package/dist/browser/angular/index.mjs.map +1 -1
- package/dist/browser/react/index.mjs +129 -57
- package/dist/browser/react/index.mjs.map +1 -1
- package/dist/browser/solid/index.mjs +120 -50
- package/dist/browser/solid/index.mjs.map +1 -1
- package/dist/browser/svelte/index.mjs.map +1 -1
- package/dist/browser/vue/index.mjs.map +1 -1
- package/dist/index.browser.mjs +10 -2
- package/dist/index.browser.mjs.map +1 -1
- package/dist/index.cjs +10 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.mjs +10 -2
- package/dist/index.mjs.map +1 -1
- package/dist/min/index.browser.mjs +1 -1
- package/dist/min/index.browser.mjs.map +1 -1
- package/dist/min/react/index.mjs +1 -1
- package/dist/min/react/index.mjs.map +1 -1
- package/dist/min/sdk/index.browser.mjs +1 -1
- package/dist/min/sdk/index.browser.mjs.map +1 -1
- package/dist/react/index.cjs +129 -57
- package/dist/react/index.cjs.map +1 -1
- package/dist/react/index.mjs +129 -57
- package/dist/react/index.mjs.map +1 -1
- package/dist/react/useTable.d.ts.map +1 -1
- package/dist/sdk/connection_manager.d.ts +8 -0
- package/dist/sdk/connection_manager.d.ts.map +1 -1
- package/dist/sdk/db_connection_impl.d.ts +7 -0
- package/dist/sdk/db_connection_impl.d.ts.map +1 -1
- package/dist/sdk/index.browser.mjs +10 -2
- package/dist/sdk/index.browser.mjs.map +1 -1
- package/dist/sdk/index.cjs +10 -2
- package/dist/sdk/index.cjs.map +1 -1
- package/dist/sdk/index.mjs +10 -2
- package/dist/sdk/index.mjs.map +1 -1
- package/dist/sdk/websocket_test_adapter.d.ts +2 -1
- package/dist/sdk/websocket_test_adapter.d.ts.map +1 -1
- package/dist/server/index.mjs.map +1 -1
- package/dist/server/runtime.d.ts.map +1 -1
- package/dist/solid/index.cjs +120 -50
- package/dist/solid/index.cjs.map +1 -1
- package/dist/solid/index.mjs +120 -50
- package/dist/solid/index.mjs.map +1 -1
- package/dist/svelte/index.cjs.map +1 -1
- package/dist/svelte/index.mjs.map +1 -1
- package/dist/tanstack/index.cjs +120 -50
- package/dist/tanstack/index.cjs.map +1 -1
- package/dist/tanstack/index.mjs +120 -50
- package/dist/tanstack/index.mjs.map +1 -1
- package/dist/vue/index.cjs.map +1 -1
- package/dist/vue/index.mjs.map +1 -1
- package/package.json +1 -1
- package/src/angular/connection_state.ts +19 -19
- package/src/angular/index.ts +3 -3
- package/src/angular/injectors/index.ts +4 -4
- package/src/angular/injectors/inject-reducer.ts +62 -62
- package/src/angular/injectors/inject-spacetimedb-connected.ts +13 -13
- package/src/angular/injectors/inject-spacetimedb.ts +10 -10
- package/src/angular/injectors/inject-table.ts +234 -234
- package/src/angular/providers/index.ts +1 -1
- package/src/angular/providers/provide-spacetimedb.ts +96 -96
- package/src/index.ts +16 -16
- package/src/lib/algebraic_type.ts +819 -819
- package/src/lib/algebraic_type_variants.ts +26 -26
- package/src/lib/algebraic_value.ts +10 -10
- package/src/lib/autogen/types.ts +746 -746
- package/src/lib/binary_reader.ts +188 -188
- package/src/lib/binary_writer.ts +213 -213
- package/src/lib/connection_id.ts +102 -102
- package/src/lib/constraints.ts +48 -48
- package/src/lib/errors.ts +26 -26
- package/src/lib/filter.ts +195 -195
- package/src/lib/identity.ts +83 -83
- package/src/lib/indexes.ts +251 -251
- package/src/lib/option.ts +34 -34
- package/src/lib/query.ts +1019 -1019
- package/src/lib/reducer_schema.ts +38 -38
- package/src/lib/reducers.ts +116 -116
- package/src/lib/result.ts +36 -36
- package/src/lib/schedule_at.ts +86 -86
- package/src/lib/schema.ts +420 -420
- package/src/lib/table.ts +548 -548
- package/src/lib/table_schema.ts +64 -64
- package/src/lib/time_duration.ts +77 -77
- package/src/lib/timestamp.ts +148 -148
- package/src/lib/type_builders.test-d.ts +128 -128
- package/src/lib/type_builders.ts +4014 -4014
- package/src/lib/type_util.ts +124 -124
- package/src/lib/util.ts +196 -196
- package/src/lib/uuid.ts +337 -337
- package/src/react/SpacetimeDBProvider.ts +84 -84
- package/src/react/connection_state.ts +6 -6
- package/src/react/index.ts +5 -5
- package/src/react/useProcedure.ts +60 -60
- package/src/react/useReducer.ts +53 -53
- package/src/react/useSpacetimeDB.ts +18 -18
- package/src/react/useTable.ts +256 -251
- package/src/sdk/client_api/index.ts +114 -114
- package/src/sdk/client_api/types/procedures.ts +8 -8
- package/src/sdk/client_api/types/reducers.ts +8 -8
- package/src/sdk/client_api/types.ts +288 -288
- package/src/sdk/client_cache.ts +129 -129
- package/src/sdk/client_table.ts +179 -179
- package/src/sdk/connection_manager.ts +352 -237
- package/src/sdk/db_connection_builder.ts +290 -290
- package/src/sdk/db_connection_impl.ts +1356 -1347
- package/src/sdk/db_context.ts +28 -28
- package/src/sdk/db_view.ts +12 -12
- package/src/sdk/decompress.ts +51 -51
- package/src/sdk/event.ts +18 -18
- package/src/sdk/event_context.ts +51 -51
- package/src/sdk/event_emitter.ts +32 -32
- package/src/sdk/index.ts +14 -14
- package/src/sdk/internal.ts +2 -2
- package/src/sdk/json_api.ts +46 -46
- package/src/sdk/logger.ts +134 -134
- package/src/sdk/message_types.ts +46 -46
- package/src/sdk/procedures.ts +83 -83
- package/src/sdk/reducer_event.ts +20 -20
- package/src/sdk/reducer_handle.ts +12 -12
- package/src/sdk/reducers.ts +159 -159
- package/src/sdk/schema.ts +45 -45
- package/src/sdk/spacetime_module.ts +28 -28
- package/src/sdk/subscription_builder_impl.ts +275 -275
- package/src/sdk/table_cache.ts +581 -581
- package/src/sdk/type_utils.ts +19 -19
- package/src/sdk/version.ts +133 -133
- package/src/sdk/websocket_decompress_adapter.ts +63 -63
- package/src/sdk/websocket_protocols.ts +25 -25
- package/src/sdk/websocket_test_adapter.ts +107 -100
- package/src/sdk/websocket_v3_frames.ts +126 -126
- package/src/sdk/ws.ts +105 -105
- package/src/server/console.ts +81 -81
- package/src/server/db_view.ts +21 -21
- package/src/server/errors.ts +138 -138
- package/src/server/http.test-d.ts +80 -80
- package/src/server/http.ts +14 -14
- package/src/server/http_handlers.ts +413 -413
- package/src/server/http_internal.ts +79 -79
- package/src/server/http_shared.ts +186 -186
- package/src/server/index.ts +37 -37
- package/src/server/polyfills.ts +4 -4
- package/src/server/procedures.ts +239 -239
- package/src/server/query.ts +1 -1
- package/src/server/range.ts +53 -53
- package/src/server/reducers.ts +113 -113
- package/src/server/rng.ts +113 -113
- package/src/server/runtime.ts +1102 -1102
- package/src/server/schema.test-d.ts +99 -99
- package/src/server/schema.ts +663 -663
- package/src/server/sys.d.ts +125 -125
- package/src/server/view.test-d.ts +194 -194
- package/src/server/views.ts +340 -340
- package/src/solid/SpacetimeDBProvider.ts +97 -97
- package/src/solid/connection_state.ts +6 -6
- package/src/solid/index.ts +5 -5
- package/src/solid/useProcedure.ts +57 -57
- package/src/solid/useReducer.ts +50 -50
- package/src/solid/useSpacetimeDB.ts +18 -18
- package/src/solid/useTable.ts +203 -203
- package/src/svelte/SpacetimeDBProvider.ts +101 -101
- package/src/svelte/connection_state.ts +16 -16
- package/src/svelte/index.ts +4 -4
- package/src/svelte/useReducer.ts +61 -61
- package/src/svelte/useSpacetimeDB.ts +22 -22
- package/src/svelte/useTable.ts +218 -218
- package/src/tanstack/SpacetimeDBQueryClient.ts +330 -330
- package/src/tanstack/hooks.ts +83 -83
- package/src/tanstack/index.ts +16 -16
- package/src/util-stub.ts +1 -1
- package/src/vue/SpacetimeDBProvider.ts +157 -157
- package/src/vue/connection_state.ts +19 -19
- package/src/vue/index.ts +5 -5
- package/src/vue/useProcedure.ts +62 -62
- package/src/vue/useReducer.ts +55 -55
- package/src/vue/useSpacetimeDB.ts +18 -18
- package/src/vue/useTable.ts +229 -229
package/src/lib/type_util.ts
CHANGED
|
@@ -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;
|