atom.io 0.14.0 → 0.14.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.
- package/data/dist/index.cjs +1473 -52
- package/data/dist/index.cjs.map +1 -1
- package/data/dist/index.d.cts +315 -16
- package/data/dist/index.js +10 -267
- package/data/dist/index.js.map +1 -1
- package/data/package.json +5 -5
- package/data/src/join.ts +3 -3
- package/dist/chunk-5VJ77LZE.js +176 -0
- package/dist/chunk-5VJ77LZE.js.map +1 -0
- package/dist/chunk-CK7GNCU5.js +309 -0
- package/dist/chunk-CK7GNCU5.js.map +1 -0
- package/dist/chunk-KW7RA7IM.js +67 -0
- package/dist/chunk-KW7RA7IM.js.map +1 -0
- package/dist/chunk-LFXB7Y6M.js +68 -0
- package/dist/chunk-LFXB7Y6M.js.map +1 -0
- package/dist/chunk-NYCVSXQB.js +181 -0
- package/dist/chunk-NYCVSXQB.js.map +1 -0
- package/dist/chunk-TE3ZSTQ6.js +2516 -0
- package/dist/chunk-TE3ZSTQ6.js.map +1 -0
- package/dist/index.cjs +2244 -55
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +268 -21
- package/dist/index.js +1 -152
- package/dist/index.js.map +1 -1
- package/dist/metafile-cjs.json +1 -1
- package/internal/dist/index.cjs +208 -79
- package/internal/dist/index.cjs.map +1 -1
- package/internal/dist/index.d.cts +226 -27
- package/internal/dist/index.js +1 -2240
- package/internal/dist/index.js.map +1 -1
- package/internal/package.json +5 -5
- package/introspection/dist/index.cjs +1618 -46
- package/introspection/dist/index.cjs.map +1 -1
- package/introspection/dist/index.d.cts +374 -4
- package/introspection/dist/index.js +2 -316
- package/introspection/dist/index.js.map +1 -1
- package/introspection/package.json +5 -5
- package/json/dist/index.cjs +1560 -8
- package/json/dist/index.cjs.map +1 -1
- package/json/dist/index.d.cts +371 -7
- package/json/dist/index.js +1 -76
- package/json/dist/index.js.map +1 -1
- package/json/package.json +5 -5
- package/package.json +5 -4
- package/react/dist/index.cjs +1604 -14
- package/react/dist/index.cjs.map +1 -1
- package/react/dist/index.d.cts +375 -4
- package/react/dist/index.js +2 -68
- package/react/dist/index.js.map +1 -1
- package/react/package.json +5 -5
- package/react-devtools/dist/index.cjs +2268 -198
- package/react-devtools/dist/index.cjs.map +1 -1
- package/react-devtools/dist/index.css +2 -2
- package/react-devtools/dist/index.d.cts +148 -24
- package/react-devtools/dist/index.js +57 -297
- package/react-devtools/dist/index.js.map +1 -1
- package/react-devtools/package.json +5 -5
- package/realtime-client/dist/index.cjs +1585 -35
- package/realtime-client/dist/index.cjs.map +1 -1
- package/realtime-client/dist/index.d.cts +382 -12
- package/realtime-client/dist/index.js +2 -165
- package/realtime-client/dist/index.js.map +1 -1
- package/realtime-client/package.json +5 -5
- package/realtime-react/dist/index.cjs +1782 -35
- package/realtime-react/dist/index.cjs.map +1 -1
- package/realtime-react/dist/index.d.cts +49 -9
- package/realtime-react/dist/index.js +4 -66
- package/realtime-react/dist/index.js.map +1 -1
- package/realtime-react/package.json +5 -5
- package/realtime-server/dist/index.cjs +1604 -58
- package/realtime-server/dist/index.cjs.map +1 -1
- package/realtime-server/dist/index.d.cts +391 -11
- package/realtime-server/dist/index.js +27 -21
- package/realtime-server/dist/index.js.map +1 -1
- package/realtime-server/package.json +6 -6
- package/realtime-testing/dist/index.cjs +2352 -16
- package/realtime-testing/dist/index.cjs.map +1 -1
- package/realtime-testing/dist/index.d.cts +486 -3
- package/realtime-testing/dist/index.js +10 -31
- package/realtime-testing/dist/index.js.map +1 -1
- package/realtime-testing/package.json +5 -5
- package/transceivers/set-rtx/dist/index.cjs +31 -10
- package/transceivers/set-rtx/dist/index.cjs.map +1 -1
- package/transceivers/set-rtx/dist/index.d.cts +29 -3
- package/transceivers/set-rtx/dist/index.js +2 -3
- package/transceivers/set-rtx/dist/index.js.map +1 -1
- package/transceivers/set-rtx/package.json +6 -6
- package/data/dist/index.d.ts +0 -158
- package/data/dist/metafile-cjs.json +0 -1
- package/data/dist/metafile-esm.json +0 -1
- package/dist/index.d.ts +0 -243
- package/dist/metafile-esm.json +0 -1
- package/internal/dist/index.d.ts +0 -421
- package/internal/dist/metafile-cjs.json +0 -1
- package/internal/dist/metafile-esm.json +0 -1
- package/introspection/dist/index.d.ts +0 -24
- package/introspection/dist/metafile-cjs.json +0 -1
- package/introspection/dist/metafile-esm.json +0 -1
- package/json/dist/index.d.ts +0 -51
- package/json/dist/metafile-cjs.json +0 -1
- package/json/dist/metafile-esm.json +0 -1
- package/react/dist/index.d.ts +0 -23
- package/react/dist/metafile-cjs.json +0 -1
- package/react/dist/metafile-esm.json +0 -1
- package/react-devtools/dist/index.d.ts +0 -341
- package/react-devtools/dist/metafile-cjs.json +0 -1
- package/react-devtools/dist/metafile-esm.json +0 -1
- package/realtime-client/dist/index.d.ts +0 -22
- package/realtime-client/dist/metafile-cjs.json +0 -1
- package/realtime-client/dist/metafile-esm.json +0 -1
- package/realtime-react/dist/index.d.ts +0 -27
- package/realtime-react/dist/metafile-cjs.json +0 -1
- package/realtime-react/dist/metafile-esm.json +0 -1
- package/realtime-server/dist/index.d.ts +0 -25
- package/realtime-server/dist/metafile-cjs.json +0 -1
- package/realtime-server/dist/metafile-esm.json +0 -1
- package/realtime-testing/dist/index.d.ts +0 -49
- package/realtime-testing/dist/metafile-cjs.json +0 -1
- package/realtime-testing/dist/metafile-esm.json +0 -1
- package/transceivers/set-rtx/dist/index.d.ts +0 -40
- package/transceivers/set-rtx/dist/metafile-cjs.json +0 -1
- package/transceivers/set-rtx/dist/metafile-esm.json +0 -1
|
@@ -1,21 +1,401 @@
|
|
|
1
|
-
import { Transceiver, Store } from 'atom.io/internal';
|
|
2
1
|
import * as SocketIO from 'socket.io';
|
|
3
|
-
import * as AtomIO from 'atom.io';
|
|
4
|
-
import { StateToken } from 'atom.io';
|
|
5
|
-
import { Json } from 'atom.io/json';
|
|
6
2
|
|
|
7
|
-
|
|
3
|
+
type JsonInterface<T, J extends Serializable = Serializable> = {
|
|
4
|
+
toJson: (t: T) => J;
|
|
5
|
+
fromJson: (json: J) => T;
|
|
6
|
+
};
|
|
7
|
+
|
|
8
|
+
type primitive = boolean | number | string | null;
|
|
9
|
+
|
|
10
|
+
type Serializable = primitive | Readonly<{
|
|
11
|
+
[key: string]: Serializable;
|
|
12
|
+
}> | ReadonlyArray<Serializable>;
|
|
13
|
+
type Object$1<Key extends string = string, Value extends Serializable = Serializable> = Record<Key, Value>;
|
|
14
|
+
|
|
15
|
+
type AtomFamily<T, K extends Serializable = Serializable> = ((key: K) => AtomToken<T>) & {
|
|
16
|
+
key: string;
|
|
17
|
+
type: `atom_family`;
|
|
18
|
+
subject: Subject<AtomToken<T>>;
|
|
19
|
+
};
|
|
20
|
+
type MutableAtomFamily<Core extends Transceiver<any>, SerializableCore extends Serializable, Key extends Serializable> = JsonInterface<Core, SerializableCore> & ((key: Key) => MutableAtomToken<Core, SerializableCore>) & {
|
|
21
|
+
key: `${string}::mutable`;
|
|
22
|
+
type: `atom_family`;
|
|
23
|
+
subject: Subject<MutableAtomToken<Core, SerializableCore>>;
|
|
24
|
+
};
|
|
25
|
+
|
|
26
|
+
declare const LoggerIconDictionary: {
|
|
27
|
+
readonly "\u231B": "Timeline event fully captured";
|
|
28
|
+
readonly "\u23E9": "Timeline redo";
|
|
29
|
+
readonly "\u23EA": "Timeline undo";
|
|
30
|
+
readonly "\u23ED\uFE0F": "Transaction redo";
|
|
31
|
+
readonly "\u23EE\uFE0F": "Transaction undo";
|
|
32
|
+
readonly "\u23F3": "Timeline event partially captured";
|
|
33
|
+
readonly "\u23F9\uFE0F": "Time-travel complete";
|
|
34
|
+
readonly "\uD83D\uDC81": "Notice";
|
|
35
|
+
readonly "\uD83D\uDD04": "Realtime transaction synchronized";
|
|
36
|
+
readonly "\u2705": "Realtime transaction success";
|
|
37
|
+
readonly "\u2728": "Computation complete";
|
|
38
|
+
readonly "\u274C": "Conflict prevents attempted action";
|
|
39
|
+
readonly "\u2B55": "Operation start";
|
|
40
|
+
readonly "\uD83D\uDC1E": "Possible bug in AtomIO";
|
|
41
|
+
readonly "\uD83D\uDC40": "Subscription added";
|
|
42
|
+
readonly "\uD83D\uDC6A": "Family member added";
|
|
43
|
+
readonly "\uD83D\uDCC1": "Stow update";
|
|
44
|
+
readonly "\uD83D\uDCC3": "Copy mutable";
|
|
45
|
+
readonly "\uD83D\uDCD6": "Read state";
|
|
46
|
+
readonly "\uD83D\uDCDD": "Write state";
|
|
47
|
+
readonly "\uD83D\uDCE2": "Notify subscribers";
|
|
48
|
+
readonly "\uD83D\uDD0C": "Register dependency";
|
|
49
|
+
readonly "\uD83D\uDD0D": "Discover root";
|
|
50
|
+
readonly "\uD83D\uDD25": "Delete state";
|
|
51
|
+
readonly "\uD83D\uDD27": "Create mutable atom";
|
|
52
|
+
readonly "\uD83D\uDD28": "Create immutable atom";
|
|
53
|
+
readonly "\uD83D\uDD34": "Operation complete";
|
|
54
|
+
readonly "\uD83D\uDDD1": "Evict cached value";
|
|
55
|
+
readonly "\uD83D\uDCA5": "Caught";
|
|
56
|
+
readonly "\uD83D\uDE48": "Subscription canceled";
|
|
57
|
+
readonly "\uD83D\uDEC4": "Apply transaction";
|
|
58
|
+
readonly "\uD83D\uDEE0\uFE0F": "Install atom into store";
|
|
59
|
+
readonly "\uD83D\uDEEB": "Begin transaction";
|
|
60
|
+
readonly "\uD83D\uDEEC": "Complete transaction";
|
|
61
|
+
readonly "\uD83E\uDDEE": "Computing selector";
|
|
62
|
+
readonly "\uD83E\uDDF9": "Prepare to evict";
|
|
63
|
+
readonly "\uD83E\uDE82": "Abort transaction";
|
|
64
|
+
};
|
|
65
|
+
type LoggerIcon = keyof typeof LoggerIconDictionary;
|
|
66
|
+
declare const LOG_LEVELS: readonly ["info", "warn", "error"];
|
|
67
|
+
type LogLevel = (typeof LOG_LEVELS)[number];
|
|
68
|
+
type LogFn = (icon: LoggerIcon, tokenType: `atom` | `readonly_selector` | `selector` | `state` | `timeline` | `transaction` | `unknown`, tokenKey: string, message: string, ...rest: unknown[]) => void;
|
|
69
|
+
type LogFilter = (...params: Parameters<LogFn>) => boolean;
|
|
70
|
+
type Logger = Record<LogLevel, LogFn>;
|
|
71
|
+
declare class AtomIOLogger implements Logger {
|
|
72
|
+
logLevel: `error` | `info` | `warn` | null;
|
|
73
|
+
private readonly filter?;
|
|
74
|
+
private readonly logger;
|
|
75
|
+
constructor(logLevel: `error` | `info` | `warn` | null, filter?: LogFilter | undefined, logger?: Logger);
|
|
76
|
+
error: LogFn;
|
|
77
|
+
info: LogFn;
|
|
78
|
+
warn: LogFn;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
type TransactionToken<_> = {
|
|
82
|
+
key: string;
|
|
83
|
+
type: `transaction`;
|
|
84
|
+
__brand?: _;
|
|
85
|
+
};
|
|
86
|
+
type TransactionUpdate<ƒ extends ƒn> = {
|
|
87
|
+
key: string;
|
|
88
|
+
updates: (KeyedStateUpdate<unknown> | TransactionUpdate<ƒn>)[];
|
|
89
|
+
params: Parameters<ƒ>;
|
|
90
|
+
output: ReturnType<ƒ>;
|
|
91
|
+
};
|
|
92
|
+
|
|
93
|
+
type SelectorFamily<T, K extends Serializable = Serializable> = ((key: K) => SelectorToken<T>) & {
|
|
94
|
+
key: string;
|
|
95
|
+
type: `selector_family`;
|
|
96
|
+
subject: Subject<SelectorToken<T>>;
|
|
97
|
+
};
|
|
98
|
+
type ReadonlySelectorFamily<T, K extends Serializable = Serializable> = ((key: K) => ReadonlySelectorToken<T>) & {
|
|
99
|
+
key: string;
|
|
100
|
+
type: `readonly_selector_family`;
|
|
101
|
+
subject: Subject<ReadonlySelectorToken<T>>;
|
|
102
|
+
};
|
|
103
|
+
|
|
104
|
+
type StateUpdate<T> = {
|
|
105
|
+
newValue: T;
|
|
106
|
+
oldValue: T;
|
|
107
|
+
};
|
|
108
|
+
type KeyedStateUpdate<T> = StateUpdate<T> & {
|
|
109
|
+
key: string;
|
|
110
|
+
family?: FamilyMetadata;
|
|
111
|
+
};
|
|
112
|
+
|
|
113
|
+
type TimelineToken = {
|
|
114
|
+
key: string;
|
|
115
|
+
type: `timeline`;
|
|
116
|
+
};
|
|
117
|
+
type TimelineUpdate = TimelineAtomUpdate | TimelineSelectorUpdate | TimelineTransactionUpdate;
|
|
118
|
+
|
|
119
|
+
type ƒn = (...parameters: any[]) => any;
|
|
120
|
+
type AtomToken<_> = {
|
|
121
|
+
key: string;
|
|
122
|
+
type: `atom`;
|
|
123
|
+
family?: FamilyMetadata;
|
|
124
|
+
__brand?: _;
|
|
125
|
+
};
|
|
126
|
+
interface MutableAtomToken<T extends Transceiver<any>, J extends Serializable> extends AtomToken<T> {
|
|
127
|
+
__asJSON?: J;
|
|
128
|
+
__update?: T extends Transceiver<infer Update> ? Update : never;
|
|
129
|
+
}
|
|
130
|
+
type SelectorToken<_> = {
|
|
131
|
+
key: string;
|
|
132
|
+
type: `selector`;
|
|
133
|
+
family?: FamilyMetadata;
|
|
134
|
+
__brand?: _;
|
|
135
|
+
};
|
|
136
|
+
type StateToken<T> = AtomToken<T> | SelectorToken<T>;
|
|
137
|
+
type ReadonlySelectorToken<_> = {
|
|
138
|
+
key: string;
|
|
139
|
+
type: `readonly_selector`;
|
|
140
|
+
family?: FamilyMetadata;
|
|
141
|
+
__brand?: _;
|
|
142
|
+
};
|
|
143
|
+
type FamilyMetadata = {
|
|
144
|
+
key: string;
|
|
145
|
+
subKey: string;
|
|
146
|
+
};
|
|
147
|
+
|
|
148
|
+
declare class Subject<T> {
|
|
149
|
+
Subscriber: (value: T) => void;
|
|
150
|
+
subscribers: Map<string, this[`Subscriber`]>;
|
|
151
|
+
subscribe(key: string, subscriber: this[`Subscriber`]): () => void;
|
|
152
|
+
private unsubscribe;
|
|
153
|
+
next(value: T): void;
|
|
154
|
+
}
|
|
155
|
+
declare class StatefulSubject<T> extends Subject<T> {
|
|
156
|
+
state: T;
|
|
157
|
+
constructor(initialState: T);
|
|
158
|
+
next(value: T): void;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
type Selector<T> = {
|
|
162
|
+
key: string;
|
|
163
|
+
type: `selector`;
|
|
164
|
+
family?: FamilyMetadata;
|
|
165
|
+
install: (store: Store) => void;
|
|
166
|
+
subject: Subject<{
|
|
167
|
+
newValue: T;
|
|
168
|
+
oldValue: T;
|
|
169
|
+
}>;
|
|
170
|
+
get: () => T;
|
|
171
|
+
set: (newValue: T | ((oldValue: T) => T)) => void;
|
|
172
|
+
};
|
|
173
|
+
type ReadonlySelector<T> = {
|
|
174
|
+
key: string;
|
|
175
|
+
type: `readonly_selector`;
|
|
176
|
+
family?: FamilyMetadata;
|
|
177
|
+
install: (store: Store) => void;
|
|
178
|
+
subject: Subject<{
|
|
179
|
+
newValue: T;
|
|
180
|
+
oldValue: T;
|
|
181
|
+
}>;
|
|
182
|
+
get: () => T;
|
|
183
|
+
};
|
|
184
|
+
|
|
185
|
+
type Transaction<ƒ extends ƒn> = {
|
|
186
|
+
key: string;
|
|
187
|
+
type: `transaction`;
|
|
188
|
+
install: (store: Store) => void;
|
|
189
|
+
subject: Subject<TransactionUpdate<ƒ>>;
|
|
190
|
+
run: (...parameters: Parameters<ƒ>) => ReturnType<ƒ>;
|
|
191
|
+
};
|
|
192
|
+
|
|
193
|
+
type TransactionMeta<ƒ extends ƒn> = {
|
|
194
|
+
phase: `applying` | `building`;
|
|
195
|
+
time: number;
|
|
196
|
+
update: TransactionUpdate<ƒ>;
|
|
197
|
+
};
|
|
198
|
+
|
|
199
|
+
type Refinement<Unrefined, Refined extends Unrefined> = (value: Unrefined) => value is Refined;
|
|
200
|
+
type Cardinality = `1:1` | `1:n` | `n:n`;
|
|
201
|
+
|
|
202
|
+
interface JunctionEntries<Content extends Object$1 | null> extends Object$1 {
|
|
203
|
+
readonly relations: [string, string[]][];
|
|
204
|
+
readonly contents: [string, Content][];
|
|
205
|
+
}
|
|
206
|
+
interface JunctionSchema<ASide extends string, BSide extends string> extends Object$1 {
|
|
207
|
+
readonly between: [a: ASide, b: BSide];
|
|
208
|
+
readonly cardinality: Cardinality;
|
|
209
|
+
}
|
|
210
|
+
type BaseExternalStoreConfiguration = {
|
|
211
|
+
addRelation: (a: string, b: string) => void;
|
|
212
|
+
deleteRelation: (a: string, b: string) => void;
|
|
213
|
+
replaceRelationsSafely: (a: string, bs: string[]) => void;
|
|
214
|
+
replaceRelationsUnsafely: (a: string, bs: string[]) => void;
|
|
215
|
+
getRelatedKeys: (key: string) => Set<string> | undefined;
|
|
216
|
+
has: (a: string, b?: string) => boolean;
|
|
217
|
+
};
|
|
218
|
+
type ExternalStoreWithContentConfiguration<Content extends Object$1> = {
|
|
219
|
+
getContent: (contentKey: string) => Content | undefined;
|
|
220
|
+
setContent: (contentKey: string, content: Content) => void;
|
|
221
|
+
deleteContent: (contentKey: string) => void;
|
|
222
|
+
};
|
|
223
|
+
type Empty<Obj extends object> = {
|
|
224
|
+
[Key in keyof Obj]?: undefined;
|
|
225
|
+
};
|
|
226
|
+
type ExternalStoreConfiguration<Content extends Object$1 | null> = Content extends Object$1 ? BaseExternalStoreConfiguration & ExternalStoreWithContentConfiguration<Content> : BaseExternalStoreConfiguration & Empty<ExternalStoreWithContentConfiguration<Object$1>>;
|
|
227
|
+
type JunctionAdvancedConfiguration<Content extends Object$1 | null> = {
|
|
228
|
+
externalStore?: ExternalStoreConfiguration<Content>;
|
|
229
|
+
isContent?: Refinement<unknown, Content>;
|
|
230
|
+
makeContentKey?: (a: string, b: string) => string;
|
|
231
|
+
};
|
|
232
|
+
type JunctionJSON<ASide extends string, BSide extends string, Content extends Object$1 | null> = JunctionEntries<Content> & JunctionSchema<ASide, BSide>;
|
|
233
|
+
declare class Junction<const ASide extends string, const BSide extends string, const Content extends Object$1 | null = null> {
|
|
234
|
+
readonly a: ASide;
|
|
235
|
+
readonly b: BSide;
|
|
236
|
+
readonly cardinality: Cardinality;
|
|
237
|
+
readonly relations: Map<string, Set<string>>;
|
|
238
|
+
readonly contents: Map<string, Content>;
|
|
239
|
+
isContent: Refinement<unknown, Content> | null;
|
|
240
|
+
makeContentKey: (a: string, b: string) => string;
|
|
241
|
+
getRelatedKeys(key: string): Set<string> | undefined;
|
|
242
|
+
protected addRelation(a: string, b: string): void;
|
|
243
|
+
protected deleteRelation(a: string, b: string): void;
|
|
244
|
+
protected replaceRelationsUnsafely(a: string, bs: string[]): void;
|
|
245
|
+
protected replaceRelationsSafely(a: string, bs: string[]): void;
|
|
246
|
+
protected getContentInternal(contentKey: string): Content | undefined;
|
|
247
|
+
protected setContent(contentKey: string, content: Content): void;
|
|
248
|
+
protected deleteContent(contentKey: string): void;
|
|
249
|
+
constructor(data: JunctionSchema<ASide, BSide> & Partial<JunctionEntries<Content>>, config?: JunctionAdvancedConfiguration<Content>);
|
|
250
|
+
toJSON(): JunctionJSON<ASide, BSide, Content>;
|
|
251
|
+
set(a: string, ...rest: Content extends null ? [b: string] : [b: string, content: Content]): this;
|
|
252
|
+
set(relation: {
|
|
253
|
+
[Key in ASide | BSide]: string;
|
|
254
|
+
}, ...rest: Content extends null ? [] | [b?: undefined] : [content: Content]): this;
|
|
255
|
+
delete(a: string, b?: string): this;
|
|
256
|
+
delete(relation: Record<ASide | BSide, string> | Record<ASide, string> | Record<BSide, string>, b?: undefined): this;
|
|
257
|
+
getRelatedKey(key: string): string | undefined;
|
|
258
|
+
replaceRelations(a: string, relations: Content extends null ? string[] : Record<string, Content>, config?: {
|
|
259
|
+
reckless: boolean;
|
|
260
|
+
}): this;
|
|
261
|
+
getContent(a: string, b: string): Content | undefined;
|
|
262
|
+
getRelationEntries(input: Record<ASide, string> | Record<BSide, string>): [string, Content][];
|
|
263
|
+
has(a: string, b?: string): boolean;
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
interface Lineage {
|
|
267
|
+
parent: typeof this | null;
|
|
268
|
+
child: typeof this | null;
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
interface Transceiver<Signal extends Serializable> {
|
|
272
|
+
do: (update: Signal) => void;
|
|
273
|
+
undo: (update: Signal) => void;
|
|
274
|
+
subscribe: (key: string, fn: (update: Signal) => void) => () => void;
|
|
275
|
+
cacheUpdateNumber: number;
|
|
276
|
+
getUpdateNumber: (update: Signal) => number;
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
/**
|
|
280
|
+
* @internal Give the tracker a transceiver state and a store, and it will
|
|
281
|
+
* subscribe to the transceiver's inner value. When the inner value changes,
|
|
282
|
+
* the tracker will update its own state to reflect the change.
|
|
283
|
+
*/
|
|
284
|
+
declare class Tracker<Mutable extends Transceiver<any>> {
|
|
285
|
+
private Update;
|
|
286
|
+
private initializeState;
|
|
287
|
+
private unsubscribeFromInnerValue;
|
|
288
|
+
private observeCore;
|
|
289
|
+
private updateCore;
|
|
290
|
+
mutableState: MutableAtomToken<Mutable, Serializable>;
|
|
291
|
+
latestUpdateState: AtomToken<typeof this.Update | null>;
|
|
292
|
+
constructor(mutableState: MutableAtomToken<Mutable, Serializable>, store: Store);
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
interface MutableAtom<T> extends Atom<T> {
|
|
296
|
+
mutable: true;
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
type OperationProgress = {
|
|
300
|
+
open: false;
|
|
301
|
+
} | {
|
|
302
|
+
open: true;
|
|
303
|
+
done: Set<string>;
|
|
304
|
+
prev: Map<string, any>;
|
|
305
|
+
time: number;
|
|
306
|
+
token: StateToken<any>;
|
|
307
|
+
};
|
|
308
|
+
|
|
309
|
+
type TimelineAtomUpdate = StateUpdate<unknown> & {
|
|
310
|
+
key: string;
|
|
311
|
+
type: `atom_update`;
|
|
312
|
+
timestamp: number;
|
|
313
|
+
family?: FamilyMetadata;
|
|
314
|
+
};
|
|
315
|
+
type TimelineSelectorUpdate = {
|
|
316
|
+
key: string;
|
|
317
|
+
type: `selector_update`;
|
|
318
|
+
timestamp: number;
|
|
319
|
+
atomUpdates: Omit<TimelineAtomUpdate, `timestamp`>[];
|
|
320
|
+
};
|
|
321
|
+
type TimelineTransactionUpdate = TransactionUpdate<ƒn> & {
|
|
322
|
+
key: string;
|
|
323
|
+
type: `transaction_update`;
|
|
324
|
+
timestamp: number;
|
|
325
|
+
};
|
|
326
|
+
type Timeline = {
|
|
327
|
+
type: `timeline`;
|
|
328
|
+
key: string;
|
|
329
|
+
at: number;
|
|
330
|
+
shouldCapture?: (update: TimelineUpdate, timeline: Timeline) => boolean;
|
|
331
|
+
timeTraveling: `into_future` | `into_past` | null;
|
|
332
|
+
history: TimelineUpdate[];
|
|
333
|
+
selectorTime: number | null;
|
|
334
|
+
transactionKey: string | null;
|
|
335
|
+
install: (store: Store) => void;
|
|
336
|
+
subject: Subject<TimelineAtomUpdate | TimelineSelectorUpdate | TimelineTransactionUpdate | `redo` | `undo`>;
|
|
337
|
+
};
|
|
338
|
+
|
|
339
|
+
declare class Store implements Lineage {
|
|
340
|
+
parent: Store | null;
|
|
341
|
+
child: Store | null;
|
|
342
|
+
valueMap: Map<string, any>;
|
|
343
|
+
atoms: Map<string, Atom<any> | MutableAtom<any>>;
|
|
344
|
+
selectors: Map<string, Selector<any>>;
|
|
345
|
+
readonlySelectors: Map<string, ReadonlySelector<any>>;
|
|
346
|
+
trackers: Map<string, Tracker<Transceiver<any>>>;
|
|
347
|
+
families: Map<string, AtomFamily<any, any> | ReadonlySelectorFamily<any, any> | SelectorFamily<any, any>>;
|
|
348
|
+
timelines: Map<string, Timeline>;
|
|
349
|
+
transactions: Map<string, Transaction<ƒn>>;
|
|
350
|
+
atomsThatAreDefault: Set<string>;
|
|
351
|
+
timelineAtoms: Junction<"timelineKey", "atomKey", null>;
|
|
352
|
+
selectorAtoms: Junction<"selectorKey", "atomKey", null>;
|
|
353
|
+
selectorGraph: Junction<"upstreamSelectorKey", "downstreamSelectorKey", {
|
|
354
|
+
source: string;
|
|
355
|
+
}>;
|
|
356
|
+
subject: {
|
|
357
|
+
atomCreation: Subject<AtomToken<unknown>>;
|
|
358
|
+
selectorCreation: Subject<ReadonlySelectorToken<unknown> | SelectorToken<unknown>>;
|
|
359
|
+
transactionCreation: Subject<TransactionToken<ƒn>>;
|
|
360
|
+
timelineCreation: Subject<TimelineToken>;
|
|
361
|
+
transactionApplying: StatefulSubject<TransactionMeta<ƒn> | null>;
|
|
362
|
+
operationStatus: Subject<OperationProgress>;
|
|
363
|
+
};
|
|
364
|
+
operation: OperationProgress;
|
|
365
|
+
transactionMeta: TransactionMeta<ƒn> | null;
|
|
366
|
+
config: {
|
|
367
|
+
name: string;
|
|
368
|
+
};
|
|
369
|
+
loggers: AtomIOLogger[];
|
|
370
|
+
logger: Logger;
|
|
371
|
+
constructor(name: string, store?: Store | null);
|
|
372
|
+
}
|
|
373
|
+
|
|
374
|
+
type Atom<T> = {
|
|
375
|
+
key: string;
|
|
376
|
+
type: `atom`;
|
|
377
|
+
family?: FamilyMetadata;
|
|
378
|
+
install: (store: Store) => void;
|
|
379
|
+
subject: Subject<{
|
|
380
|
+
newValue: T;
|
|
381
|
+
oldValue: T;
|
|
382
|
+
}>;
|
|
383
|
+
default: T | (() => T);
|
|
384
|
+
cleanup?: () => void;
|
|
385
|
+
};
|
|
386
|
+
|
|
387
|
+
declare const useExposeSingle: ({ socket, store, }: ServerConfig) => <J extends Serializable>(token: StateToken<J>) => () => void;
|
|
8
388
|
|
|
9
|
-
declare const useExposeFamily: ({ socket, store, }: ServerConfig) => <J extends
|
|
389
|
+
declare const useExposeFamily: ({ socket, store, }: ServerConfig) => <J extends Serializable>(family: AtomFamily<J, Serializable> | SelectorFamily<J, Serializable>, index: StateToken<Set<string>>) => () => void;
|
|
10
390
|
|
|
11
|
-
declare const useExposeMutable: ({ socket, store, }: ServerConfig) => <Core extends Transceiver<
|
|
391
|
+
declare const useExposeMutable: ({ socket, store, }: ServerConfig) => <Core extends Transceiver<Serializable>, SerializableCore extends Serializable>(token: MutableAtomToken<Core, SerializableCore>) => () => void;
|
|
12
392
|
|
|
13
|
-
declare const useExposeMutableFamily: ({ socket, store, }: ServerConfig) => <Family extends
|
|
393
|
+
declare const useExposeMutableFamily: ({ socket, store, }: ServerConfig) => <Family extends MutableAtomFamily<Transceiver<Serializable>, Serializable, Serializable>>(family: Family, index: StateToken<Set<string>>) => () => void;
|
|
14
394
|
|
|
15
|
-
declare const useReceiveTransaction: ({ socket, store }: ServerConfig) => <ƒ extends
|
|
16
|
-
declare function useSyncTransaction({ socket, store, }: ServerConfig): <ƒ extends
|
|
395
|
+
declare const useReceiveTransaction: ({ socket, store }: ServerConfig) => <ƒ extends ƒn>(tx: TransactionToken<ƒ>) => () => void;
|
|
396
|
+
declare function useSyncTransaction({ socket, store, }: ServerConfig): <ƒ extends ƒn>(tx: TransactionToken<ƒ>) => () => void;
|
|
17
397
|
|
|
18
|
-
declare const useReceiveState: ({ socket, store }: ServerConfig) => <J extends
|
|
398
|
+
declare const useReceiveState: ({ socket, store }: ServerConfig) => <J extends Serializable>(token: StateToken<J>) => () => void;
|
|
19
399
|
|
|
20
400
|
type ServerConfig = {
|
|
21
401
|
socket: SocketIO.Socket;
|
|
@@ -1,13 +1,9 @@
|
|
|
1
|
-
import
|
|
2
|
-
import { setState } from 'atom.io';
|
|
3
|
-
import * as Internal from 'atom.io/internal';
|
|
4
|
-
import { IMPLICIT, getJsonToken, getUpdateToken, subscribeToState } from 'atom.io/internal';
|
|
5
|
-
import { parseJson } from 'atom.io/json';
|
|
1
|
+
import { IMPLICIT, getJsonToken, getUpdateToken, getState, subscribeToState, parseJson, runTransaction, subscribeToTransaction, setState } from '../../dist/chunk-TE3ZSTQ6.js';
|
|
6
2
|
|
|
7
|
-
// src/hook-composition/expose-single.ts
|
|
3
|
+
// realtime-server/src/hook-composition/expose-single.ts
|
|
8
4
|
var useExposeSingle = ({
|
|
9
5
|
socket,
|
|
10
|
-
store =
|
|
6
|
+
store = IMPLICIT.STORE
|
|
11
7
|
}) => {
|
|
12
8
|
return function exposeSingle(token) {
|
|
13
9
|
let unsubscribeFromStateUpdates = null;
|
|
@@ -17,8 +13,8 @@ var useExposeSingle = ({
|
|
|
17
13
|
unsubscribeFromStateUpdates = null;
|
|
18
14
|
};
|
|
19
15
|
const fillSubRequest = () => {
|
|
20
|
-
socket.emit(`serve:${token.key}`,
|
|
21
|
-
unsubscribeFromStateUpdates =
|
|
16
|
+
socket.emit(`serve:${token.key}`, getState(token, store));
|
|
17
|
+
unsubscribeFromStateUpdates = subscribeToState(
|
|
22
18
|
token,
|
|
23
19
|
({ newValue }) => {
|
|
24
20
|
socket.emit(`serve:${token.key}`, newValue);
|
|
@@ -35,6 +31,8 @@ var useExposeSingle = ({
|
|
|
35
31
|
};
|
|
36
32
|
};
|
|
37
33
|
};
|
|
34
|
+
|
|
35
|
+
// realtime-server/src/hook-composition/expose-family.ts
|
|
38
36
|
var subscribeToTokenCreation = (family, key, handleTokenCreation) => {
|
|
39
37
|
const unsubscribe = family.type === `atom_family` ? family.subject.subscribe(key, handleTokenCreation) : family.subject.subscribe(key, handleTokenCreation);
|
|
40
38
|
return unsubscribe;
|
|
@@ -64,13 +62,13 @@ var useExposeFamily = ({
|
|
|
64
62
|
const fillSubRequest = (subKey) => {
|
|
65
63
|
var _a;
|
|
66
64
|
if (subKey === void 0) {
|
|
67
|
-
const keys =
|
|
65
|
+
const keys = getState(index, store);
|
|
68
66
|
for (const key of keys) {
|
|
69
67
|
const token = family(key);
|
|
70
68
|
socket.emit(
|
|
71
69
|
`serve:${family.key}`,
|
|
72
70
|
parseJson(((_a = token.family) == null ? void 0 : _a.subKey) || `null`),
|
|
73
|
-
|
|
71
|
+
getState(token, store)
|
|
74
72
|
);
|
|
75
73
|
}
|
|
76
74
|
const unsubscribeFromTokenCreation = subscribeToTokenCreation(
|
|
@@ -97,7 +95,7 @@ var useExposeFamily = ({
|
|
|
97
95
|
socket.on(`unsub:${family.key}`, fillFamilyUnsubRequest);
|
|
98
96
|
} else {
|
|
99
97
|
const token = family(subKey);
|
|
100
|
-
socket.emit(`serve:${token.key}`,
|
|
98
|
+
socket.emit(`serve:${token.key}`, getState(token, store));
|
|
101
99
|
const unsubscribe = subscribeToState(
|
|
102
100
|
token,
|
|
103
101
|
({ newValue }) => {
|
|
@@ -126,6 +124,8 @@ var useExposeFamily = ({
|
|
|
126
124
|
};
|
|
127
125
|
};
|
|
128
126
|
};
|
|
127
|
+
|
|
128
|
+
// realtime-server/src/hook-composition/expose-mutable.ts
|
|
129
129
|
var useExposeMutable = ({
|
|
130
130
|
socket,
|
|
131
131
|
store = IMPLICIT.STORE
|
|
@@ -140,7 +140,7 @@ var useExposeMutable = ({
|
|
|
140
140
|
unsubscribeFromStateUpdates = null;
|
|
141
141
|
};
|
|
142
142
|
const fillSubRequest = () => {
|
|
143
|
-
socket.emit(`init:${token.key}`,
|
|
143
|
+
socket.emit(`init:${token.key}`, getState(jsonToken, store));
|
|
144
144
|
unsubscribeFromStateUpdates = subscribeToState(
|
|
145
145
|
trackerToken,
|
|
146
146
|
({ newValue }) => {
|
|
@@ -158,6 +158,8 @@ var useExposeMutable = ({
|
|
|
158
158
|
};
|
|
159
159
|
};
|
|
160
160
|
};
|
|
161
|
+
|
|
162
|
+
// realtime-server/src/hook-composition/expose-mutable-family.ts
|
|
161
163
|
var useExposeMutableFamily = ({
|
|
162
164
|
socket,
|
|
163
165
|
store = IMPLICIT.STORE
|
|
@@ -183,7 +185,7 @@ var useExposeMutableFamily = ({
|
|
|
183
185
|
const fillSubRequest = (subKey) => {
|
|
184
186
|
var _a;
|
|
185
187
|
if (subKey === void 0) {
|
|
186
|
-
const keys =
|
|
188
|
+
const keys = getState(index, store);
|
|
187
189
|
for (const key of keys) {
|
|
188
190
|
const token = family(key);
|
|
189
191
|
const jsonToken = getJsonToken(token);
|
|
@@ -191,7 +193,7 @@ var useExposeMutableFamily = ({
|
|
|
191
193
|
socket.emit(
|
|
192
194
|
`init:${family.key}`,
|
|
193
195
|
parseJson(((_a = jsonToken.family) == null ? void 0 : _a.subKey) || `null`),
|
|
194
|
-
|
|
196
|
+
getState(jsonToken, store)
|
|
195
197
|
);
|
|
196
198
|
const unsubFromUpdates = subscribeToState(
|
|
197
199
|
trackerToken,
|
|
@@ -217,7 +219,7 @@ var useExposeMutableFamily = ({
|
|
|
217
219
|
socket.emit(
|
|
218
220
|
`init:${family.key}`,
|
|
219
221
|
parseJson(((_a2 = jsonToken.family) == null ? void 0 : _a2.subKey) || `null`),
|
|
220
|
-
|
|
222
|
+
getState(jsonToken, store)
|
|
221
223
|
);
|
|
222
224
|
const unsubFromUpdates = subscribeToState(
|
|
223
225
|
trackerToken,
|
|
@@ -241,7 +243,7 @@ var useExposeMutableFamily = ({
|
|
|
241
243
|
const token = family(subKey);
|
|
242
244
|
const jsonToken = getJsonToken(token);
|
|
243
245
|
const updateToken = getUpdateToken(token);
|
|
244
|
-
socket.emit(`init:${token.key}`,
|
|
246
|
+
socket.emit(`init:${token.key}`, getState(jsonToken, store));
|
|
245
247
|
const unsubscribe = subscribeToState(
|
|
246
248
|
updateToken,
|
|
247
249
|
({ newValue }) => {
|
|
@@ -270,20 +272,22 @@ var useExposeMutableFamily = ({
|
|
|
270
272
|
};
|
|
271
273
|
};
|
|
272
274
|
};
|
|
275
|
+
|
|
276
|
+
// realtime-server/src/hook-composition/receive-transaction.ts
|
|
273
277
|
var useReceiveTransaction = ({ socket, store }) => {
|
|
274
278
|
return function receiveTransaction(tx) {
|
|
275
|
-
const fillTransactionRequest = (update) =>
|
|
279
|
+
const fillTransactionRequest = (update) => runTransaction(tx, store)(...update.params);
|
|
276
280
|
socket.on(`tx:${tx.key}`, fillTransactionRequest);
|
|
277
281
|
return () => socket.off(`tx:${tx.key}`, fillTransactionRequest);
|
|
278
282
|
};
|
|
279
283
|
};
|
|
280
284
|
function useSyncTransaction({
|
|
281
285
|
socket,
|
|
282
|
-
store =
|
|
286
|
+
store = IMPLICIT.STORE
|
|
283
287
|
}) {
|
|
284
288
|
return function receiveTransaction(tx) {
|
|
285
289
|
const fillTransactionRequest = (update, transactionId) => {
|
|
286
|
-
const unsubscribe =
|
|
290
|
+
const unsubscribe = subscribeToTransaction(
|
|
287
291
|
tx,
|
|
288
292
|
(update2) => {
|
|
289
293
|
unsubscribe();
|
|
@@ -292,12 +296,14 @@ function useSyncTransaction({
|
|
|
292
296
|
`sync:${transactionId}`,
|
|
293
297
|
store
|
|
294
298
|
);
|
|
295
|
-
|
|
299
|
+
runTransaction(tx, store)(...update.params);
|
|
296
300
|
};
|
|
297
301
|
socket.on(`tx:${tx.key}`, fillTransactionRequest);
|
|
298
302
|
return () => socket.off(`tx:${tx.key}`, fillTransactionRequest);
|
|
299
303
|
};
|
|
300
304
|
}
|
|
305
|
+
|
|
306
|
+
// realtime-server/src/hook-composition/receive-state.ts
|
|
301
307
|
var useReceiveState = ({ socket, store }) => {
|
|
302
308
|
return function receiveState(token) {
|
|
303
309
|
const publish = (newValue) => setState(token, newValue, store);
|