atom.io 0.13.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 +2250 -126
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +272 -25
- package/dist/index.js +1 -215
- package/dist/index.js.map +1 -1
- package/dist/metafile-cjs.json +1 -1
- package/internal/dist/index.cjs +885 -684
- package/internal/dist/index.cjs.map +1 -1
- package/internal/dist/index.d.cts +230 -24
- package/internal/dist/index.js +1 -2171
- package/internal/dist/index.js.map +1 -1
- package/internal/package.json +5 -5
- package/internal/src/atom/create-atom.ts +3 -2
- package/internal/src/mutable/create-mutable-atom.ts +3 -2
- package/internal/src/mutable/tracker.ts +6 -4
- package/internal/src/selector/register-selector.ts +1 -1
- package/internal/src/selector/update-selector-atoms.ts +3 -3
- package/internal/src/subscribe/index.ts +3 -0
- package/internal/src/subscribe/recall-state.ts +0 -6
- package/internal/src/subscribe/subscribe-to-state.ts +47 -0
- package/internal/src/subscribe/subscribe-to-timeline.ts +28 -0
- package/internal/src/subscribe/subscribe-to-transaction.ts +33 -0
- 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 +10 -9
- package/react/dist/index.cjs +1638 -10
- package/react/dist/index.cjs.map +1 -1
- package/react/dist/index.d.cts +383 -5
- package/react/dist/index.js +2 -31
- package/react/dist/index.js.map +1 -1
- package/react/package.json +5 -5
- package/react/src/store-hooks.ts +52 -3
- 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 -34
- package/realtime-client/dist/index.cjs.map +1 -1
- package/realtime-client/dist/index.d.cts +382 -11
- package/realtime-client/dist/index.js +2 -164
- package/realtime-client/dist/index.js.map +1 -1
- package/realtime-client/package.json +5 -5
- package/realtime-client/src/use-push.ts +4 -4
- package/realtime-client/src/use-server-action.ts +4 -4
- 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 +1627 -60
- package/realtime-server/dist/index.cjs.map +1 -1
- package/realtime-server/dist/index.d.cts +391 -11
- package/realtime-server/dist/index.js +59 -32
- package/realtime-server/dist/index.js.map +1 -1
- package/realtime-server/package.json +6 -6
- package/realtime-server/src/hook-composition/expose-family.ts +7 -3
- package/realtime-server/src/hook-composition/expose-mutable-family.ts +13 -5
- package/realtime-server/src/hook-composition/expose-mutable.ts +11 -3
- package/realtime-server/src/hook-composition/expose-single.ts +6 -2
- package/realtime-server/src/hook-composition/receive-transaction.ts +14 -5
- 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/src/subscribe.ts +37 -91
- 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 -414
- 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 -16
- 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 -21
- 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,10 +1,10 @@
|
|
|
1
|
-
import
|
|
2
|
-
import { setState } from 'atom.io';
|
|
3
|
-
import { parseJson } from 'atom.io/json';
|
|
4
|
-
import { getJsonToken, getUpdateToken } from 'atom.io/internal';
|
|
1
|
+
import { IMPLICIT, getJsonToken, getUpdateToken, getState, subscribeToState, parseJson, runTransaction, subscribeToTransaction, setState } from '../../dist/chunk-TE3ZSTQ6.js';
|
|
5
2
|
|
|
6
|
-
// src/hook-composition/expose-single.ts
|
|
7
|
-
var useExposeSingle = ({
|
|
3
|
+
// realtime-server/src/hook-composition/expose-single.ts
|
|
4
|
+
var useExposeSingle = ({
|
|
5
|
+
socket,
|
|
6
|
+
store = IMPLICIT.STORE
|
|
7
|
+
}) => {
|
|
8
8
|
return function exposeSingle(token) {
|
|
9
9
|
let unsubscribeFromStateUpdates = null;
|
|
10
10
|
const fillUnsubRequest = () => {
|
|
@@ -13,8 +13,8 @@ var useExposeSingle = ({ socket, store }) => {
|
|
|
13
13
|
unsubscribeFromStateUpdates = null;
|
|
14
14
|
};
|
|
15
15
|
const fillSubRequest = () => {
|
|
16
|
-
socket.emit(`serve:${token.key}`,
|
|
17
|
-
unsubscribeFromStateUpdates =
|
|
16
|
+
socket.emit(`serve:${token.key}`, getState(token, store));
|
|
17
|
+
unsubscribeFromStateUpdates = subscribeToState(
|
|
18
18
|
token,
|
|
19
19
|
({ newValue }) => {
|
|
20
20
|
socket.emit(`serve:${token.key}`, newValue);
|
|
@@ -31,11 +31,16 @@ var useExposeSingle = ({ socket, store }) => {
|
|
|
31
31
|
};
|
|
32
32
|
};
|
|
33
33
|
};
|
|
34
|
+
|
|
35
|
+
// realtime-server/src/hook-composition/expose-family.ts
|
|
34
36
|
var subscribeToTokenCreation = (family, key, handleTokenCreation) => {
|
|
35
37
|
const unsubscribe = family.type === `atom_family` ? family.subject.subscribe(key, handleTokenCreation) : family.subject.subscribe(key, handleTokenCreation);
|
|
36
38
|
return unsubscribe;
|
|
37
39
|
};
|
|
38
|
-
var useExposeFamily = ({
|
|
40
|
+
var useExposeFamily = ({
|
|
41
|
+
socket,
|
|
42
|
+
store = IMPLICIT.STORE
|
|
43
|
+
}) => {
|
|
39
44
|
return function exposeFamily(family, index) {
|
|
40
45
|
const unsubSingleCallbacksByKey = /* @__PURE__ */ new Map();
|
|
41
46
|
const unsubFamilyCallbacksByKey = /* @__PURE__ */ new Map();
|
|
@@ -57,20 +62,20 @@ var useExposeFamily = ({ socket, store }) => {
|
|
|
57
62
|
const fillSubRequest = (subKey) => {
|
|
58
63
|
var _a;
|
|
59
64
|
if (subKey === void 0) {
|
|
60
|
-
const keys =
|
|
65
|
+
const keys = getState(index, store);
|
|
61
66
|
for (const key of keys) {
|
|
62
67
|
const token = family(key);
|
|
63
68
|
socket.emit(
|
|
64
69
|
`serve:${family.key}`,
|
|
65
70
|
parseJson(((_a = token.family) == null ? void 0 : _a.subKey) || `null`),
|
|
66
|
-
|
|
71
|
+
getState(token, store)
|
|
67
72
|
);
|
|
68
73
|
}
|
|
69
74
|
const unsubscribeFromTokenCreation = subscribeToTokenCreation(
|
|
70
75
|
family,
|
|
71
76
|
`expose-family:${socket.id}`,
|
|
72
77
|
(token) => {
|
|
73
|
-
const unsub =
|
|
78
|
+
const unsub = subscribeToState(
|
|
74
79
|
token,
|
|
75
80
|
({ newValue }) => {
|
|
76
81
|
var _a2;
|
|
@@ -90,8 +95,8 @@ var useExposeFamily = ({ socket, store }) => {
|
|
|
90
95
|
socket.on(`unsub:${family.key}`, fillFamilyUnsubRequest);
|
|
91
96
|
} else {
|
|
92
97
|
const token = family(subKey);
|
|
93
|
-
socket.emit(`serve:${token.key}`,
|
|
94
|
-
const unsubscribe =
|
|
98
|
+
socket.emit(`serve:${token.key}`, getState(token, store));
|
|
99
|
+
const unsubscribe = subscribeToState(
|
|
95
100
|
token,
|
|
96
101
|
({ newValue }) => {
|
|
97
102
|
socket.emit(`serve:${token.key}`, newValue);
|
|
@@ -119,7 +124,12 @@ var useExposeFamily = ({ socket, store }) => {
|
|
|
119
124
|
};
|
|
120
125
|
};
|
|
121
126
|
};
|
|
122
|
-
|
|
127
|
+
|
|
128
|
+
// realtime-server/src/hook-composition/expose-mutable.ts
|
|
129
|
+
var useExposeMutable = ({
|
|
130
|
+
socket,
|
|
131
|
+
store = IMPLICIT.STORE
|
|
132
|
+
}) => {
|
|
123
133
|
return function exposeMutable(token) {
|
|
124
134
|
let unsubscribeFromStateUpdates = null;
|
|
125
135
|
const jsonToken = getJsonToken(token);
|
|
@@ -130,8 +140,8 @@ var useExposeMutable = ({ socket, store }) => {
|
|
|
130
140
|
unsubscribeFromStateUpdates = null;
|
|
131
141
|
};
|
|
132
142
|
const fillSubRequest = () => {
|
|
133
|
-
socket.emit(`init:${token.key}`,
|
|
134
|
-
unsubscribeFromStateUpdates =
|
|
143
|
+
socket.emit(`init:${token.key}`, getState(jsonToken, store));
|
|
144
|
+
unsubscribeFromStateUpdates = subscribeToState(
|
|
135
145
|
trackerToken,
|
|
136
146
|
({ newValue }) => {
|
|
137
147
|
socket.emit(`next:${token.key}`, newValue);
|
|
@@ -148,7 +158,12 @@ var useExposeMutable = ({ socket, store }) => {
|
|
|
148
158
|
};
|
|
149
159
|
};
|
|
150
160
|
};
|
|
151
|
-
|
|
161
|
+
|
|
162
|
+
// realtime-server/src/hook-composition/expose-mutable-family.ts
|
|
163
|
+
var useExposeMutableFamily = ({
|
|
164
|
+
socket,
|
|
165
|
+
store = IMPLICIT.STORE
|
|
166
|
+
}) => {
|
|
152
167
|
return function exposeMutableFamily(family, index) {
|
|
153
168
|
const unsubSingleCallbacksByKey = /* @__PURE__ */ new Map();
|
|
154
169
|
const unsubFamilyCallbacksByKey = /* @__PURE__ */ new Map();
|
|
@@ -170,7 +185,7 @@ var useExposeMutableFamily = ({ socket, store }) => {
|
|
|
170
185
|
const fillSubRequest = (subKey) => {
|
|
171
186
|
var _a;
|
|
172
187
|
if (subKey === void 0) {
|
|
173
|
-
const keys =
|
|
188
|
+
const keys = getState(index, store);
|
|
174
189
|
for (const key of keys) {
|
|
175
190
|
const token = family(key);
|
|
176
191
|
const jsonToken = getJsonToken(token);
|
|
@@ -178,9 +193,9 @@ var useExposeMutableFamily = ({ socket, store }) => {
|
|
|
178
193
|
socket.emit(
|
|
179
194
|
`init:${family.key}`,
|
|
180
195
|
parseJson(((_a = jsonToken.family) == null ? void 0 : _a.subKey) || `null`),
|
|
181
|
-
|
|
196
|
+
getState(jsonToken, store)
|
|
182
197
|
);
|
|
183
|
-
const unsubFromUpdates =
|
|
198
|
+
const unsubFromUpdates = subscribeToState(
|
|
184
199
|
trackerToken,
|
|
185
200
|
({ newValue }) => {
|
|
186
201
|
var _a2;
|
|
@@ -204,9 +219,9 @@ var useExposeMutableFamily = ({ socket, store }) => {
|
|
|
204
219
|
socket.emit(
|
|
205
220
|
`init:${family.key}`,
|
|
206
221
|
parseJson(((_a2 = jsonToken.family) == null ? void 0 : _a2.subKey) || `null`),
|
|
207
|
-
|
|
222
|
+
getState(jsonToken, store)
|
|
208
223
|
);
|
|
209
|
-
const unsubFromUpdates =
|
|
224
|
+
const unsubFromUpdates = subscribeToState(
|
|
210
225
|
trackerToken,
|
|
211
226
|
({ newValue }) => {
|
|
212
227
|
var _a3;
|
|
@@ -228,8 +243,8 @@ var useExposeMutableFamily = ({ socket, store }) => {
|
|
|
228
243
|
const token = family(subKey);
|
|
229
244
|
const jsonToken = getJsonToken(token);
|
|
230
245
|
const updateToken = getUpdateToken(token);
|
|
231
|
-
socket.emit(`init:${token.key}`,
|
|
232
|
-
const unsubscribe =
|
|
246
|
+
socket.emit(`init:${token.key}`, getState(jsonToken, store));
|
|
247
|
+
const unsubscribe = subscribeToState(
|
|
233
248
|
updateToken,
|
|
234
249
|
({ newValue }) => {
|
|
235
250
|
socket.emit(`next:${token.key}`, newValue);
|
|
@@ -257,26 +272,38 @@ var useExposeMutableFamily = ({ socket, store }) => {
|
|
|
257
272
|
};
|
|
258
273
|
};
|
|
259
274
|
};
|
|
275
|
+
|
|
276
|
+
// realtime-server/src/hook-composition/receive-transaction.ts
|
|
260
277
|
var useReceiveTransaction = ({ socket, store }) => {
|
|
261
278
|
return function receiveTransaction(tx) {
|
|
262
|
-
const fillTransactionRequest = (update) =>
|
|
279
|
+
const fillTransactionRequest = (update) => runTransaction(tx, store)(...update.params);
|
|
263
280
|
socket.on(`tx:${tx.key}`, fillTransactionRequest);
|
|
264
281
|
return () => socket.off(`tx:${tx.key}`, fillTransactionRequest);
|
|
265
282
|
};
|
|
266
283
|
};
|
|
267
|
-
function useSyncTransaction({
|
|
284
|
+
function useSyncTransaction({
|
|
285
|
+
socket,
|
|
286
|
+
store = IMPLICIT.STORE
|
|
287
|
+
}) {
|
|
268
288
|
return function receiveTransaction(tx) {
|
|
269
289
|
const fillTransactionRequest = (update, transactionId) => {
|
|
270
|
-
const unsubscribe =
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
290
|
+
const unsubscribe = subscribeToTransaction(
|
|
291
|
+
tx,
|
|
292
|
+
(update2) => {
|
|
293
|
+
unsubscribe();
|
|
294
|
+
socket.emit(`tx:sync:${transactionId}`, update2);
|
|
295
|
+
},
|
|
296
|
+
`sync:${transactionId}`,
|
|
297
|
+
store
|
|
298
|
+
);
|
|
299
|
+
runTransaction(tx, store)(...update.params);
|
|
275
300
|
};
|
|
276
301
|
socket.on(`tx:${tx.key}`, fillTransactionRequest);
|
|
277
302
|
return () => socket.off(`tx:${tx.key}`, fillTransactionRequest);
|
|
278
303
|
};
|
|
279
304
|
}
|
|
305
|
+
|
|
306
|
+
// realtime-server/src/hook-composition/receive-state.ts
|
|
280
307
|
var useReceiveState = ({ socket, store }) => {
|
|
281
308
|
return function receiveState(token) {
|
|
282
309
|
const publish = (newValue) => setState(token, newValue, store);
|