@shivaedev/contract 0.31.0 → 0.33.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +85 -17
  3. package/dist/CommandGuard.d.ts +10 -0
  4. package/dist/CommandGuard.d.ts.map +1 -0
  5. package/dist/CommandGuard.js +20 -0
  6. package/dist/CommandGuard.js.map +1 -0
  7. package/dist/LiveServer.d.ts +6 -4
  8. package/dist/LiveServer.d.ts.map +1 -1
  9. package/dist/LiveServer.js +10 -5
  10. package/dist/LiveServer.js.map +1 -1
  11. package/dist/ReadPolicyGuard.d.ts +19 -0
  12. package/dist/ReadPolicyGuard.d.ts.map +1 -0
  13. package/dist/ReadPolicyGuard.js +23 -0
  14. package/dist/ReadPolicyGuard.js.map +1 -0
  15. package/dist/adapters/activityState.d.ts +9 -0
  16. package/dist/adapters/activityState.d.ts.map +1 -0
  17. package/dist/adapters/activityState.js +11 -0
  18. package/dist/adapters/activityState.js.map +1 -0
  19. package/dist/{internal → adapters}/bindingOwner.d.ts +1 -1
  20. package/dist/{internal → adapters}/bindingOwner.d.ts.map +1 -1
  21. package/dist/{internal → adapters}/bindingOwner.js +2 -1
  22. package/dist/adapters/bindingOwner.js.map +1 -0
  23. package/dist/adapters/clientId.d.ts +2 -0
  24. package/dist/adapters/clientId.d.ts.map +1 -0
  25. package/dist/adapters/clientId.js +4 -0
  26. package/dist/adapters/clientId.js.map +1 -0
  27. package/dist/automaticLive.d.ts +1 -1
  28. package/dist/automaticLive.d.ts.map +1 -1
  29. package/dist/automaticLive.js +7 -2
  30. package/dist/automaticLive.js.map +1 -1
  31. package/dist/bind.d.ts.map +1 -1
  32. package/dist/bind.js +1 -1
  33. package/dist/bind.js.map +1 -1
  34. package/dist/changesHandlerLayer.d.ts +19 -0
  35. package/dist/changesHandlerLayer.d.ts.map +1 -0
  36. package/dist/changesHandlerLayer.js +15 -0
  37. package/dist/changesHandlerLayer.js.map +1 -0
  38. package/dist/clientActivity.d.ts +10 -1
  39. package/dist/clientActivity.d.ts.map +1 -1
  40. package/dist/clientActivity.js +7 -0
  41. package/dist/clientActivity.js.map +1 -1
  42. package/dist/clientKeys.d.ts +7 -0
  43. package/dist/clientKeys.d.ts.map +1 -0
  44. package/dist/clientKeys.js +11 -0
  45. package/dist/clientKeys.js.map +1 -0
  46. package/dist/composeBindings.d.ts +8 -0
  47. package/dist/composeBindings.d.ts.map +1 -0
  48. package/dist/composeBindings.js +18 -0
  49. package/dist/composeBindings.js.map +1 -0
  50. package/dist/contract.d.ts +5 -8
  51. package/dist/contract.d.ts.map +1 -1
  52. package/dist/contract.js +11 -7
  53. package/dist/contract.js.map +1 -1
  54. package/dist/internal/automaticQuery.d.ts +3 -1
  55. package/dist/internal/automaticQuery.d.ts.map +1 -1
  56. package/dist/internal/automaticQuery.js +9 -2
  57. package/dist/internal/automaticQuery.js.map +1 -1
  58. package/dist/internal/changesSuccess.d.ts +5 -1
  59. package/dist/internal/changesSuccess.d.ts.map +1 -1
  60. package/dist/internal/changesSuccess.js +10 -6
  61. package/dist/internal/changesSuccess.js.map +1 -1
  62. package/dist/internal/clientActivity.d.ts +5 -6
  63. package/dist/internal/clientActivity.d.ts.map +1 -1
  64. package/dist/internal/clientActivity.js +6 -18
  65. package/dist/internal/clientActivity.js.map +1 -1
  66. package/dist/internal/clientOperations.d.ts +1 -1
  67. package/dist/internal/clientOperations.d.ts.map +1 -1
  68. package/dist/internal/clientOperations.js +7 -4
  69. package/dist/internal/clientOperations.js.map +1 -1
  70. package/dist/internal/compareQueries.d.ts +2 -1
  71. package/dist/internal/compareQueries.d.ts.map +1 -1
  72. package/dist/internal/compareQueries.js +5 -7
  73. package/dist/internal/compareQueries.js.map +1 -1
  74. package/dist/internal/declarationError.d.ts +7 -1
  75. package/dist/internal/declarationError.d.ts.map +1 -1
  76. package/dist/internal/declarationError.js.map +1 -1
  77. package/dist/internal/prependMiddleware.d.ts +10 -0
  78. package/dist/internal/prependMiddleware.d.ts.map +1 -0
  79. package/dist/internal/prependMiddleware.js +12 -0
  80. package/dist/internal/prependMiddleware.js.map +1 -0
  81. package/dist/internal/queryDelivery.d.ts +2 -1
  82. package/dist/internal/queryDelivery.d.ts.map +1 -1
  83. package/dist/internal/queryDelivery.js +8 -1
  84. package/dist/internal/queryDelivery.js.map +1 -1
  85. package/dist/internal/queryReactivity.d.ts.map +1 -1
  86. package/dist/internal/queryReactivity.js +3 -11
  87. package/dist/internal/queryReactivity.js.map +1 -1
  88. package/dist/internal/querySignals.d.ts +8 -0
  89. package/dist/internal/querySignals.d.ts.map +1 -0
  90. package/dist/internal/querySignals.js +42 -0
  91. package/dist/internal/querySignals.js.map +1 -0
  92. package/dist/internal/wrapAtom.d.ts +3 -0
  93. package/dist/internal/wrapAtom.d.ts.map +1 -0
  94. package/dist/internal/wrapAtom.js +15 -0
  95. package/dist/internal/wrapAtom.js.map +1 -0
  96. package/dist/live.d.ts +2 -1
  97. package/dist/live.d.ts.map +1 -1
  98. package/dist/live.js +5 -4
  99. package/dist/live.js.map +1 -1
  100. package/dist/makeLiveServer.d.ts +22 -5
  101. package/dist/makeLiveServer.d.ts.map +1 -1
  102. package/dist/makeLiveServer.js +39 -24
  103. package/dist/makeLiveServer.js.map +1 -1
  104. package/dist/publicConfig.d.ts +19 -3
  105. package/dist/publicConfig.d.ts.map +1 -1
  106. package/dist/querySignals.d.ts +9 -0
  107. package/dist/querySignals.d.ts.map +1 -0
  108. package/dist/querySignals.js +14 -0
  109. package/dist/querySignals.js.map +1 -0
  110. package/dist/querySubscription.d.ts +1 -1
  111. package/dist/querySubscription.d.ts.map +1 -1
  112. package/dist/querySubscription.js +7 -4
  113. package/dist/querySubscription.js.map +1 -1
  114. package/dist/queryUpdate.d.ts +5 -1
  115. package/dist/queryUpdate.d.ts.map +1 -1
  116. package/package.json +11 -10
  117. package/src/CommandGuard.ts +25 -0
  118. package/src/LiveServer.ts +18 -9
  119. package/src/ReadPolicyGuard.ts +31 -0
  120. package/src/adapters/activityState.ts +12 -0
  121. package/src/{internal → adapters}/bindingOwner.ts +3 -2
  122. package/src/adapters/clientId.ts +3 -0
  123. package/src/automaticLive.ts +8 -3
  124. package/src/bind.ts +1 -1
  125. package/src/changesHandlerLayer.ts +51 -0
  126. package/src/clientActivity.ts +8 -1
  127. package/src/clientKeys.ts +17 -0
  128. package/src/composeBindings.ts +27 -0
  129. package/src/contract.ts +14 -20
  130. package/src/internal/automaticQuery.ts +11 -1
  131. package/src/internal/changesSuccess.ts +13 -8
  132. package/src/internal/clientActivity.ts +37 -52
  133. package/src/internal/clientOperations.ts +9 -5
  134. package/src/internal/compareQueries.ts +6 -8
  135. package/src/internal/declarationError.ts +12 -1
  136. package/src/internal/prependMiddleware.ts +15 -0
  137. package/src/internal/queryDelivery.ts +9 -0
  138. package/src/internal/queryReactivity.ts +4 -11
  139. package/src/internal/querySignals.ts +46 -0
  140. package/src/internal/wrapAtom.ts +14 -0
  141. package/src/live.ts +5 -4
  142. package/src/makeLiveServer.ts +64 -57
  143. package/src/querySignals.ts +22 -0
  144. package/src/querySubscription.ts +8 -7
  145. package/src/queryUpdate.ts +5 -1
  146. package/dist/internal/bindingOwner.js.map +0 -1
  147. package/dist/testing.d.ts +0 -17
  148. package/dist/testing.d.ts.map +0 -1
  149. package/dist/testing.js +0 -51
  150. package/dist/testing.js.map +0 -1
  151. package/src/testing.ts +0 -81
@@ -0,0 +1,14 @@
1
+ import * as Atom from "effect/reactivity/Atom";
2
+
3
+ export function wrapAtom<A>(atom: Atom.Atom<A>, read: (get: Atom.AtomContext) => A, source: Atom.Atom<A> = atom): Atom.Atom<A> {
4
+ let wrapped = Atom.transform(source, read, { initialValueTarget: source });
5
+ if (atom.keepAlive) {
6
+ wrapped = Atom.keepAlive(wrapped);
7
+ } else if (atom.idleTTL !== undefined) {
8
+ wrapped = Atom.setIdleTTL(wrapped, atom.idleTTL);
9
+ }
10
+ if (Atom.isSerializable(atom)) {
11
+ Object.assign(wrapped, { [Atom.SerializableTypeId]: atom[Atom.SerializableTypeId] });
12
+ }
13
+ return wrapped;
14
+ }
package/src/live.ts CHANGED
@@ -2,7 +2,8 @@ import { Cause, Duration, Effect, Option, Schema, type Stream } from "effect";
2
2
  import * as Atom from "effect/reactivity/Atom";
3
3
  import type * as AtomRegistry from "effect/reactivity/AtomRegistry";
4
4
  import * as Reactivity from "effect/reactivity/Reactivity";
5
- import { invalidationKeys, Key, type KeyContext, readKeys } from "@shivaedev/changes/keys.ts";
5
+ import { Key } from "@shivaedev/changes/keys.ts";
6
+ import { clientInvalidationKeys, clientReadKeys, type KeyContext } from "#clientKeys.ts";
6
7
  import { liveAttempt } from "#internal/liveAttempt.ts";
7
8
  import { invalidateLive } from "#internal/liveInvalidation.ts";
8
9
  import { livePending } from "#internal/livePending.ts";
@@ -45,7 +46,7 @@ export function live<R, E, TRuntimeError>(runtime: Atom.AtomRuntime<R, TRuntimeE
45
46
  get.mount(status);
46
47
  const reactivity = yield* Reactivity.Reactivity;
47
48
  const retryKeys = options.retryKeys ?? (typeof options.resyncKeys === "function" ? options.resyncKeys(get.registry) : options.resyncKeys);
48
- yield* retryOnChange(status, readKeys(retryKeys, options.keyContext), () => get.refreshSelf());
49
+ yield* retryOnChange(status, clientReadKeys(retryKeys, options.keyContext), () => get.refreshSelf());
49
50
  function update(value: Partial<LiveStatus<E>>) {
50
51
  get.set(status, { ...get.once(status), ...value });
51
52
  }
@@ -71,7 +72,7 @@ export function live<R, E, TRuntimeError>(runtime: Atom.AtomRuntime<R, TRuntimeE
71
72
  });
72
73
  function changed(changedKeys: readonly Key[]) {
73
74
  const window = get.once(coalesceWindow);
74
- const keys = invalidationKeys(changedKeys, options.keyContext);
75
+ const keys = clientInvalidationKeys(changedKeys, options.keyContext);
75
76
  invalidateLive(reactivity, keys, () => active && !get.once(paused), window);
76
77
  const delay = Duration.toMillis(Duration.fromInputUnsafe(window));
77
78
  if (delay === 0) {
@@ -90,7 +91,7 @@ export function live<R, E, TRuntimeError>(runtime: Atom.AtomRuntime<R, TRuntimeE
90
91
  return;
91
92
  }
92
93
  const keys = typeof options.resyncKeys === "function" ? options.resyncKeys(get.registry) : options.resyncKeys;
93
- reactivity.invalidateUnsafe(keys.map((key) => readKeys([key], options.keyContext)[0] ?? ""));
94
+ reactivity.invalidateUnsafe(keys.map((key) => clientReadKeys([key], options.keyContext)[0] ?? ""));
94
95
  update({ needsResync: false, pending: 0 });
95
96
  }
96
97
  // A subscription alone does not build the flag, so its first read would otherwise announce a change.
@@ -1,6 +1,6 @@
1
- import { Effect, Queue, Random, Stream } from "effect";
1
+ import { Effect, Queue, Random, Scheduler, Stream } from "effect";
2
2
  import * as Reactivity from "effect/reactivity/Reactivity";
3
- import { type Key, type KeyContext, readKeys } from "@shivaedev/changes/keys.ts";
3
+ import { type Key, readKeys } from "@shivaedev/changes/keys.ts";
4
4
  import { compareQueries } from "#internal/compareQueries.ts";
5
5
  import { liveHintQueue } from "#internal/liveHintQueue.ts";
6
6
  import type { LiveHint } from "#live.ts";
@@ -10,82 +10,89 @@ import { QueryReadDenied } from "#readPolicyErrors.ts";
10
10
 
11
11
  export const makeLiveServer = Effect.gen(function* () {
12
12
  const reactivity = yield* Reactivity.Reactivity;
13
+ const dispatcher = (yield* Scheduler.Scheduler).makeDispatcher();
13
14
  let openStreams = 0;
14
15
  const resyncKey = `@shivaedev/contract/resync/${yield* Random.nextInt}`;
15
- function open(keys: readonly Key[], context?: KeyContext, globalKeys: readonly Key[] = []): Stream.Stream<LiveHint> {
16
- return Stream.unwrap(
17
- Effect.gen(function* () {
18
- const { offer, queue } = yield* liveHintQueue;
19
- const pending = new Map<string, Key>();
20
- let scheduled = false;
21
- let resync = false;
22
- let active = true;
23
- const global = new Set(readKeys(globalKeys));
24
- function flush() {
25
- if (scheduled) {
26
- return;
16
+ function open(keys: readonly Key[]) {
17
+ return Effect.gen(function* () {
18
+ const { offer, queue } = yield* liveHintQueue;
19
+ const pending = new Map<string, Key>();
20
+ let scheduled = false;
21
+ let resync = false;
22
+ let active = true;
23
+ function flush() {
24
+ if (scheduled) {
25
+ return;
26
+ }
27
+ scheduled = true;
28
+ dispatcher.scheduleTask(() => {
29
+ scheduled = false;
30
+ if (active) {
31
+ offer(resync ? { _tag: "Resync" } : { _tag: "Changed", keys: [...pending.values()] });
27
32
  }
28
- scheduled = true;
29
- queueMicrotask(() => {
30
- scheduled = false;
31
- if (active) {
32
- offer(resync ? { _tag: "Resync" } : { _tag: "Changed", keys: [...pending.values()] });
33
- }
34
- pending.clear();
35
- resync = false;
36
- });
33
+ pending.clear();
34
+ resync = false;
35
+ }, 0);
36
+ }
37
+ let cancelKeys: (() => void)[] = [];
38
+ function replaceKeys(current: readonly Key[]) {
39
+ for (const stop of cancelKeys) {
40
+ stop();
37
41
  }
38
- const cancel = keys.map((key) => {
39
- const bare = readKeys([key]);
40
- const own = global.has(bare[0] ?? "") ? bare : readKeys([key], context);
42
+ cancelKeys = current.map((key) => {
43
+ const own = readKeys([key]);
41
44
  return reactivity.registerUnsafe(own, () => {
42
45
  pending.set(own[0] ?? "", key);
43
46
  flush();
44
47
  });
45
48
  });
46
- cancel.push(
47
- reactivity.registerUnsafe([resyncKey], () => {
48
- resync = true;
49
- flush();
50
- }),
51
- );
52
- openStreams += 1;
53
- yield* Effect.addFinalizer(() =>
54
- Effect.sync(() => {
55
- active = false;
56
- openStreams -= 1;
57
- for (const stop of cancel) {
58
- stop();
59
- }
60
- }),
61
- );
62
- yield* Queue.offer(queue, { _tag: "Resync" });
63
- return Stream.fromQueue(queue);
64
- }),
65
- );
49
+ }
50
+ replaceKeys(keys);
51
+ const cancel = [
52
+ reactivity.registerUnsafe([resyncKey], () => {
53
+ resync = true;
54
+ flush();
55
+ }),
56
+ ];
57
+ openStreams += 1;
58
+ yield* Effect.addFinalizer(() =>
59
+ Effect.sync(() => {
60
+ active = false;
61
+ openStreams -= 1;
62
+ for (const stop of [...cancelKeys, ...cancel]) {
63
+ stop();
64
+ }
65
+ }),
66
+ );
67
+ yield* Queue.offer(queue, { _tag: "Resync" });
68
+ return { replaceKeys, stream: Stream.fromQueue(queue) };
69
+ });
66
70
  }
67
71
  const resync = Effect.sync(() => {
68
72
  reactivity.invalidateUnsafe([resyncKey]);
69
73
  return openStreams;
70
74
  });
71
- function subscribe<E, R>(subscription: QuerySubscription<E, R>, context?: KeyContext): Stream.Stream<SubscriptionHint, E | QueryReadDenied, R>;
72
- function subscribe<E, R>(
73
- subscription: QuerySubscription<E, R>,
74
- context: KeyContext | undefined,
75
- read: QueryRerun<E, R>,
76
- ): Stream.Stream<QueryUpdate, E | QueryReadDenied, R>;
77
- function subscribe<E, R>(subscription: QuerySubscription<E, R>, context?: KeyContext, read?: QueryRerun<E, R>) {
75
+ function subscribe<E, R>(subscription: QuerySubscription<E, R>): Stream.Stream<SubscriptionHint, E | QueryReadDenied, R>;
76
+ function subscribe<E, R>(subscription: QuerySubscription<E, R>, read: QueryRerun<E, R>): Stream.Stream<QueryUpdate, E | QueryReadDenied, R>;
77
+ function subscribe<E, R>(subscription: QuerySubscription<E, R>, read?: QueryRerun<E, R>) {
78
78
  return Stream.unwrap(
79
- Effect.sync(() => {
79
+ Effect.gen(function* () {
80
+ const registration = yield* open(subscription.keys);
81
+ let scopes = subscription.scopes;
80
82
  let compare = compareQueries(subscription, read);
81
83
  const next = Effect.fnUntraced(function* (hint: LiveHint) {
82
84
  if (!(yield* subscription.authorized)) {
83
85
  compare = compareQueries(subscription, read);
84
86
  return [new QueryReadDenied({ message: "Read no longer allowed for subscribed queries" })];
85
87
  }
86
- return yield* compare(hint);
88
+ const updates = yield* compare(hint, scopes);
89
+ if (subscription.readScopes !== undefined) {
90
+ scopes = yield* subscription.readScopes;
91
+ registration.replaceKeys(scopes.flat());
92
+ }
93
+ return updates;
87
94
  });
88
- return open(subscription.keys, context, subscription.globalKeys).pipe(
95
+ return registration.stream.pipe(
89
96
  Stream.mapEffect((hint) =>
90
97
  Effect.flatMap(subscription.refresh ?? Effect.context<never>(), (current) => Effect.provideContext(next(hint), current)),
91
98
  ),
@@ -94,5 +101,5 @@ export const makeLiveServer = Effect.gen(function* () {
94
101
  }),
95
102
  );
96
103
  }
97
- return { resync, stream: open, subscribe };
104
+ return { resync, stream: (keys: readonly Key[]) => Stream.unwrap(Effect.map(open(keys), ({ stream }) => stream)), subscribe };
98
105
  });
@@ -0,0 +1,22 @@
1
+ import * as Atom from "effect/reactivity/Atom";
2
+
3
+ export interface QuerySignals {
4
+ readonly completed: number;
5
+ readonly pending: boolean;
6
+ readonly subscription: "disabled" | "opening" | "open" | "refused";
7
+ }
8
+
9
+ const states = new WeakMap<Atom.Atom<unknown>, Atom.Writable<QuerySignals>>();
10
+
11
+ export function querySignals(query: Atom.Atom<unknown>): Atom.Writable<QuerySignals> {
12
+ let state = states.get(query);
13
+ if (state === undefined) {
14
+ state = Atom.make<QuerySignals>({ completed: 0, pending: true, subscription: "disabled" });
15
+ states.set(query, state);
16
+ }
17
+ return state;
18
+ }
19
+
20
+ export function shareQuerySignals(query: Atom.Atom<unknown>, source: Atom.Atom<unknown>) {
21
+ states.set(query, querySignals(source));
22
+ }
@@ -11,9 +11,9 @@ export type QueryRerun<E = unknown, R = never> = (request: QueryRequest) => Effe
11
11
 
12
12
  export interface QuerySubscription<E = never, R = never> {
13
13
  readonly authorized: Effect.Effect<boolean, E, R>;
14
- readonly globalKeys?: readonly Key[];
15
14
  readonly keys: readonly Key[];
16
15
  readonly queries?: readonly QueryRequest[];
16
+ readonly readScopes?: Effect.Effect<readonly (readonly Key[])[], E, R>;
17
17
  readonly refresh?: Effect.Effect<Context.Context<never>, E, R>;
18
18
  readonly scopes: readonly (readonly Key[])[];
19
19
  }
@@ -37,7 +37,10 @@ export function querySubscription(rpc: Rpc.Any, references: readonly QueryRefere
37
37
  const context = yield* policyContext(Rpc.make(`${prefix}${query.name}`));
38
38
  return {
39
39
  check: Effect.provideContext(checkQuery(query, payload, viewer), context),
40
- keys: queryReadKeys(query, payload, viewer).pipe(Effect.provideContext(context)),
40
+ keys: Effect.gen(function* () {
41
+ const current = yield* policyContext(Rpc.make(`${prefix}${query.name}`));
42
+ return yield* queryReadKeys(query, payload, viewer).pipe(Effect.provideContext(current));
43
+ }),
41
44
  permitted: Effect.gen(function* () {
42
45
  const current = yield* policyContext(Rpc.make(`${prefix}${query.name}`));
43
46
  return yield* Effect.suspend(() => query.readPolicy?.(payload, viewer) ?? Effect.succeed(false)).pipe(Effect.provideContext(current));
@@ -46,14 +49,12 @@ export function querySubscription(rpc: Rpc.Any, references: readonly QueryRefere
46
49
  }),
47
50
  );
48
51
  yield* Effect.forEach(policies, ({ check }) => check);
49
- const scopes = yield* Effect.forEach(policies, ({ keys }) => keys);
52
+ const readScopes = Effect.forEach(policies, ({ keys }) => keys);
53
+ const scopes = yield* readScopes;
50
54
  const authorized = Effect.map(
51
55
  Effect.forEach(policies, ({ permitted }) => permitted),
52
56
  (permissions) => permissions.every(Boolean),
53
57
  );
54
- const globalKeys = queries.flatMap(
55
- ({ query }) => query.readsCollections?.map((collection) => ({ _tag: "List" as const, collection: collection.name })) ?? [],
56
- );
57
- return { authorized, globalKeys, keys: scopes.flat(), queries, scopes } satisfies QuerySubscription<unknown, unknown>;
58
+ return { authorized, keys: scopes.flat(), queries, readScopes, scopes } satisfies QuerySubscription<unknown, unknown>;
58
59
  })();
59
60
  }
@@ -7,5 +7,9 @@ export interface QueryResult {
7
7
  readonly queryIndex: number;
8
8
  readonly value: unknown;
9
9
  }
10
+ export interface QueryUnchanged {
11
+ readonly _tag: "Unchanged";
12
+ readonly queryIndex: number;
13
+ }
10
14
  export type SubscriptionHint = LiveHint | QueryReadDenied;
11
- export type QueryUpdate = SubscriptionHint | QueryResult;
15
+ export type QueryUpdate = SubscriptionHint | QueryResult | QueryUnchanged;
@@ -1 +0,0 @@
1
- {"version":3,"file":"bindingOwner.js","sourceRoot":"","sources":["../../src/internal/bindingOwner.ts"],"names":[],"mappings":"AAQA,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAyC,CAAC;AAEtE,MAAM,UAAU,YAAY,CAAC,KAA4B,EAAE,QAAoC;IAC9F,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;QACzC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}
package/dist/testing.d.ts DELETED
@@ -1,17 +0,0 @@
1
- import { type Duration, Effect, Layer, Stream, SubscriptionRef } from "effect";
2
- import { type Rpc, RpcClient, type RpcGroup, RpcSerialization, RpcServer } from "effect/rpc";
3
- import type { Key } from "@shivaedev/changes/keys.ts";
4
- import type { SubscriptionHint } from "#queryUpdate.ts";
5
- export interface HintViewer<E> {
6
- readonly finished: Effect.Effect<void, E>;
7
- readonly hints: SubscriptionRef.SubscriptionRef<readonly SubscriptionHint[]>;
8
- }
9
- export declare const watchHints: <E, R>(stream: Stream.Stream<SubscriptionHint, E, R>) => Effect.Effect<{
10
- finished: Effect.Effect<void, E, never>;
11
- hints: SubscriptionRef.SubscriptionRef<readonly SubscriptionHint[]>;
12
- }, E, R | import("effect/Scope").Scope>;
13
- export declare const heard: <E>(viewer: HintViewer<E>, keys: readonly Key[], options?: {
14
- readonly within?: Duration.Input;
15
- } | undefined) => Effect.Effect<boolean, E, never>;
16
- export declare function layerMemoryProtocol<TRpcs extends Rpc.Any>(group: RpcGroup.RpcGroup<TRpcs>): Layer.Layer<RpcClient.Protocol, never, Exclude<Exclude<Exclude<Rpc.ServicesServer<TRpcs>, RpcServer.Protocol>, import("effect/Scope").Scope>, RpcSerialization.RpcSerialization> | Exclude<Exclude<Exclude<Rpc.ToHandler<TRpcs>, RpcServer.Protocol>, import("effect/Scope").Scope>, RpcSerialization.RpcSerialization>>;
17
- //# sourceMappingURL=testing.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,EAAS,KAAK,EAAS,MAAM,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACvG,OAAO,EAAE,KAAK,GAAG,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAmB,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC9G,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,eAAe,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAC;CAC7E;AAED,eAAO,MAAM,UAAU,GAA2C,CAAC,EAAE,CAAC;;;uCAYpE,CAAC;AAEH,eAAO,MAAM,KAAK,GAAsC,CAAC;sBAG3B,QAAQ,CAAC,KAAK;kDAU1C,CAAC;AAMH,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,4TAqCzF"}
package/dist/testing.js DELETED
@@ -1,51 +0,0 @@
1
- import { Deferred, Effect, Fiber, Layer, Queue, Stream, SubscriptionRef } from "effect";
2
- import { RpcClient, RpcSerialization, RpcServer } from "effect/rpc";
3
- export const watchHints = Effect.fn("Live.watchHints")(function* (stream) {
4
- const hints = yield* SubscriptionRef.make([]);
5
- const ready = yield* Deferred.make();
6
- const fiber = yield* stream.pipe(Stream.runForEach((hint) => SubscriptionRef.update(hints, (received) => [...received, hint]).pipe(Effect.andThen(Deferred.succeed(ready, undefined)))), Effect.forkScoped);
7
- const finished = Fiber.join(fiber);
8
- yield* Effect.raceFirst(Deferred.await(ready), finished);
9
- return { finished, hints };
10
- });
11
- export const heard = Effect.fn("Live.heard")(function* (viewer, keys, options = {}) {
12
- const matching = SubscriptionRef.changes(viewer.hints).pipe(Stream.filter((hints) => hints.some((hint) => namesKeys(hint, keys))), Stream.runHead, Effect.as(true));
13
- return yield* Effect.raceFirst(matching, Effect.as(viewer.finished, false)).pipe(Effect.timeoutOrElse({ duration: options.within ?? "1 second", orElse: () => Effect.succeed(false) }));
14
- });
15
- function namesKeys(hint, keys) {
16
- return hint._tag === "Changed" && keys.every((key) => hint.keys.some((actual) => JSON.stringify(actual) === JSON.stringify(key)));
17
- }
18
- export function layerMemoryProtocol(group) {
19
- return Layer.effect(RpcClient.Protocol, Effect.gen(function* () {
20
- const requests = yield* Queue.unbounded();
21
- const disconnects = yield* Queue.unbounded();
22
- const { codecFor } = yield* RpcSerialization.RpcSerialization;
23
- const protocol = yield* RpcClient.Protocol.make((send, clientIds) => Effect.gen(function* () {
24
- const server = RpcServer.Protocol.of({
25
- clientIds: Effect.sync(() => clientIds),
26
- codecFor,
27
- disconnects,
28
- end: () => Effect.void,
29
- initialMessage: Effect.succeedNone,
30
- run: (receive) => Effect.forever(Effect.flatMap(Queue.take(requests), ([id, message]) => receive(id, message))),
31
- send,
32
- supportsAck: true,
33
- supportsNotifications: true,
34
- supportsSpanPropagation: true,
35
- supportsTransferables: false,
36
- });
37
- yield* RpcServer.make(group).pipe(Effect.provideService(RpcServer.Protocol, server), Effect.forkScoped);
38
- return {
39
- codecFor,
40
- send: (clientId, request) => Queue.offer(requests, [clientId, request]).pipe(Effect.asVoid),
41
- supportsAck: true,
42
- supportsTransferables: false,
43
- };
44
- }));
45
- return {
46
- ...protocol,
47
- run: (clientId, receive) => protocol.run(clientId, receive).pipe(Effect.ensuring(Queue.offer(disconnects, clientId))),
48
- };
49
- })).pipe(Layer.provide(RpcSerialization.layerNdjson));
50
- }
51
- //# sourceMappingURL=testing.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACvG,OAAO,EAAY,SAAS,EAAkC,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAS9G,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,EAAQ,MAA6C;IACpH,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC,IAAI,CAA8B,EAAE,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAQ,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAC/B,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1B,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CACzH,EACD,MAAM,CAAC,UAAU,CACjB,CAAC;IACF,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,KAAK,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;IACzD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAA0B,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,EACrD,MAAqB,EACrB,IAAoB,EACpB,OAAO,GAAyC,EAAE;IAElD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAC1D,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACrE,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CACf,CAAC;IACF,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAC/E,MAAM,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CACrG,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,SAAS,SAAS,CAAC,IAAsB,EAAE,IAAoB;IAC9D,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACnI,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAwB,KAA+B;IACzF,OAAO,KAAK,CAAC,MAAM,CAClB,SAAS,CAAC,QAAQ,EAClB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAmD,CAAC;QAC3F,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAU,CAAC;QACrD,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC,gBAAgB,CAAC;QAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CACnE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACnB,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;gBACvC,QAAQ;gBACR,WAAW;gBACX,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI;gBACtB,cAAc,EAAE,MAAM,CAAC,WAAW;gBAClC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC/G,IAAI;gBACJ,WAAW,EAAE,IAAI;gBACjB,qBAAqB,EAAE,IAAI;gBAC3B,uBAAuB,EAAE,IAAI;gBAC7B,qBAAqB,EAAE,KAAK;aAC5B,CAAC,CAAC;YACH,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;YACxG,OAAO;gBACN,QAAQ;gBACR,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC3F,WAAW,EAAE,IAAI;gBACjB,qBAAqB,EAAE,KAAK;aAC5B,CAAC;QACH,CAAC,CAAC,CACF,CAAC;QACF,OAAO;YACN,GAAG,QAAQ;YACX,GAAG,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;SAC7E,CAAC;IAC3C,CAAC,CAAC,CACF,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;AACrD,CAAC"}
package/src/testing.ts DELETED
@@ -1,81 +0,0 @@
1
- import { Deferred, type Duration, Effect, Fiber, Layer, Queue, Stream, SubscriptionRef } from "effect";
2
- import { type Rpc, RpcClient, type RpcGroup, type RpcMessage, RpcSerialization, RpcServer } from "effect/rpc";
3
- import type { Key } from "@shivaedev/changes/keys.ts";
4
- import type { SubscriptionHint } from "#queryUpdate.ts";
5
-
6
- export interface HintViewer<E> {
7
- readonly finished: Effect.Effect<void, E>;
8
- readonly hints: SubscriptionRef.SubscriptionRef<readonly SubscriptionHint[]>;
9
- }
10
-
11
- export const watchHints = Effect.fn("Live.watchHints")(function* <E, R>(stream: Stream.Stream<SubscriptionHint, E, R>) {
12
- const hints = yield* SubscriptionRef.make<readonly SubscriptionHint[]>([]);
13
- const ready = yield* Deferred.make<void>();
14
- const fiber = yield* stream.pipe(
15
- Stream.runForEach((hint) =>
16
- SubscriptionRef.update(hints, (received) => [...received, hint]).pipe(Effect.andThen(Deferred.succeed(ready, undefined))),
17
- ),
18
- Effect.forkScoped,
19
- );
20
- const finished = Fiber.join(fiber);
21
- yield* Effect.raceFirst(Deferred.await(ready), finished);
22
- return { finished, hints } satisfies HintViewer<E>;
23
- });
24
-
25
- export const heard = Effect.fn("Live.heard")(function* <E>(
26
- viewer: HintViewer<E>,
27
- keys: readonly Key[],
28
- options: { readonly within?: Duration.Input } = {},
29
- ) {
30
- const matching = SubscriptionRef.changes(viewer.hints).pipe(
31
- Stream.filter((hints) => hints.some((hint) => namesKeys(hint, keys))),
32
- Stream.runHead,
33
- Effect.as(true),
34
- );
35
- return yield* Effect.raceFirst(matching, Effect.as(viewer.finished, false)).pipe(
36
- Effect.timeoutOrElse({ duration: options.within ?? "1 second", orElse: () => Effect.succeed(false) }),
37
- );
38
- });
39
-
40
- function namesKeys(hint: SubscriptionHint, keys: readonly Key[]): boolean {
41
- return hint._tag === "Changed" && keys.every((key) => hint.keys.some((actual) => JSON.stringify(actual) === JSON.stringify(key)));
42
- }
43
-
44
- export function layerMemoryProtocol<TRpcs extends Rpc.Any>(group: RpcGroup.RpcGroup<TRpcs>) {
45
- return Layer.effect(
46
- RpcClient.Protocol,
47
- Effect.gen(function* () {
48
- const requests = yield* Queue.unbounded<readonly [number, RpcMessage.FromClientEncoded]>();
49
- const disconnects = yield* Queue.unbounded<number>();
50
- const { codecFor } = yield* RpcSerialization.RpcSerialization;
51
- const protocol = yield* RpcClient.Protocol.make((send, clientIds) =>
52
- Effect.gen(function* () {
53
- const server = RpcServer.Protocol.of({
54
- clientIds: Effect.sync(() => clientIds),
55
- codecFor,
56
- disconnects,
57
- end: () => Effect.void,
58
- initialMessage: Effect.succeedNone,
59
- run: (receive) => Effect.forever(Effect.flatMap(Queue.take(requests), ([id, message]) => receive(id, message))),
60
- send,
61
- supportsAck: true,
62
- supportsNotifications: true,
63
- supportsSpanPropagation: true,
64
- supportsTransferables: false,
65
- });
66
- yield* RpcServer.make(group).pipe(Effect.provideService(RpcServer.Protocol, server), Effect.forkScoped);
67
- return {
68
- codecFor,
69
- send: (clientId, request) => Queue.offer(requests, [clientId, request]).pipe(Effect.asVoid),
70
- supportsAck: true,
71
- supportsTransferables: false,
72
- };
73
- }),
74
- );
75
- return {
76
- ...protocol,
77
- run: (clientId, receive) => protocol.run(clientId, receive).pipe(Effect.ensuring(Queue.offer(disconnects, clientId))),
78
- } satisfies RpcClient.Protocol["Service"];
79
- }),
80
- ).pipe(Layer.provide(RpcSerialization.layerNdjson));
81
- }