@shivaedev/contract 0.41.0 → 0.43.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 (169) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +28 -178
  3. package/dist/AutomaticQueryOptions.d.ts +0 -5
  4. package/dist/AutomaticQueryOptions.d.ts.map +1 -1
  5. package/dist/HostVersion.d.ts +1 -19
  6. package/dist/HostVersion.d.ts.map +1 -1
  7. package/dist/adapters/activityState.d.ts.map +1 -1
  8. package/dist/adapters/activityState.js +0 -1
  9. package/dist/adapters/activityState.js.map +1 -1
  10. package/dist/adapters/liveHintStream.d.ts +0 -1
  11. package/dist/adapters/liveHintStream.d.ts.map +1 -1
  12. package/dist/adapters/openLiveHints.d.ts +0 -1
  13. package/dist/adapters/openLiveHints.d.ts.map +1 -1
  14. package/dist/adapters/retainedQueries.d.ts +7 -0
  15. package/dist/adapters/retainedQueries.d.ts.map +1 -0
  16. package/dist/adapters/retainedQueries.js +45 -0
  17. package/dist/adapters/retainedQueries.js.map +1 -0
  18. package/dist/adapters/standaloneLiveServer.d.ts +1 -7
  19. package/dist/adapters/standaloneLiveServer.d.ts.map +1 -1
  20. package/dist/adapters/standaloneLiveServer.js.map +1 -1
  21. package/dist/automaticLive.d.ts +2 -4
  22. package/dist/automaticLive.d.ts.map +1 -1
  23. package/dist/automaticLive.js +5 -14
  24. package/dist/automaticLive.js.map +1 -1
  25. package/dist/automaticQuery.d.ts +1 -1
  26. package/dist/automaticQuery.d.ts.map +1 -1
  27. package/dist/automaticQuery.js +20 -26
  28. package/dist/automaticQuery.js.map +1 -1
  29. package/dist/bind.d.ts +1 -2
  30. package/dist/bind.d.ts.map +1 -1
  31. package/dist/bind.js +8 -12
  32. package/dist/bind.js.map +1 -1
  33. package/dist/bindOperations.d.ts +6 -0
  34. package/dist/bindOperations.d.ts.map +1 -0
  35. package/dist/bindOperations.js +10 -0
  36. package/dist/bindOperations.js.map +1 -0
  37. package/dist/changesSuccess.d.ts +2 -3
  38. package/dist/changesSuccess.d.ts.map +1 -1
  39. package/dist/changesSuccess.js +1 -3
  40. package/dist/changesSuccess.js.map +1 -1
  41. package/dist/clientActivities.d.ts +0 -2
  42. package/dist/clientActivities.d.ts.map +1 -1
  43. package/dist/clientActivities.js +0 -4
  44. package/dist/clientActivities.js.map +1 -1
  45. package/dist/clientActivity.d.ts +0 -1
  46. package/dist/clientActivity.d.ts.map +1 -1
  47. package/dist/clientActivity.js +1 -1
  48. package/dist/clientActivity.js.map +1 -1
  49. package/dist/clientOperations.d.ts +1 -1
  50. package/dist/clientOperations.d.ts.map +1 -1
  51. package/dist/clientOperations.js +53 -52
  52. package/dist/clientOperations.js.map +1 -1
  53. package/dist/compareQueries.d.ts +2 -19
  54. package/dist/compareQueries.d.ts.map +1 -1
  55. package/dist/compareQueries.js +6 -33
  56. package/dist/compareQueries.js.map +1 -1
  57. package/dist/live-server/register.d.ts +0 -1
  58. package/dist/live-server/register.d.ts.map +1 -1
  59. package/dist/live-server/service.d.ts +0 -2
  60. package/dist/live-server/service.d.ts.map +1 -1
  61. package/dist/live-server/stream.d.ts +0 -1
  62. package/dist/live-server/stream.d.ts.map +1 -1
  63. package/dist/live-server/subscribe.d.ts +2 -2
  64. package/dist/live-server/subscribe.d.ts.map +1 -1
  65. package/dist/live-server/subscribe.js.map +1 -1
  66. package/dist/live.d.ts +5 -12
  67. package/dist/live.d.ts.map +1 -1
  68. package/dist/live.js +15 -85
  69. package/dist/live.js.map +1 -1
  70. package/dist/liveAttempt.d.ts +3 -6
  71. package/dist/liveAttempt.d.ts.map +1 -1
  72. package/dist/liveAttempt.js +11 -30
  73. package/dist/liveAttempt.js.map +1 -1
  74. package/dist/liveHintQueue.d.ts +0 -1
  75. package/dist/liveHintQueue.d.ts.map +1 -1
  76. package/dist/liveHintQueue.js +9 -12
  77. package/dist/liveHintQueue.js.map +1 -1
  78. package/dist/makeLiveServer.d.ts +1 -5
  79. package/dist/makeLiveServer.d.ts.map +1 -1
  80. package/dist/operation.d.ts +2 -4
  81. package/dist/operation.d.ts.map +1 -1
  82. package/dist/operation.js +0 -1
  83. package/dist/operation.js.map +1 -1
  84. package/dist/operationDeclaration.d.ts +1 -2
  85. package/dist/operationDeclaration.d.ts.map +1 -1
  86. package/dist/operationDeclaration.js.map +1 -1
  87. package/dist/publicConfig.d.ts +6 -21
  88. package/dist/publicConfig.d.ts.map +1 -1
  89. package/dist/queryDelivery.d.ts +4 -5
  90. package/dist/queryDelivery.d.ts.map +1 -1
  91. package/dist/queryDelivery.js +4 -15
  92. package/dist/queryDelivery.js.map +1 -1
  93. package/dist/queryProgress.d.ts.map +1 -1
  94. package/dist/queryProgress.js +0 -3
  95. package/dist/queryProgress.js.map +1 -1
  96. package/dist/queryRetention.d.ts +8 -0
  97. package/dist/queryRetention.d.ts.map +1 -0
  98. package/dist/queryRetention.js +3 -0
  99. package/dist/queryRetention.js.map +1 -0
  100. package/dist/querySignals.d.ts +1 -0
  101. package/dist/querySignals.d.ts.map +1 -1
  102. package/dist/querySignals.js.map +1 -1
  103. package/dist/querySubscription.d.ts +1 -1
  104. package/dist/querySubscription.d.ts.map +1 -1
  105. package/dist/queryUpdate.d.ts +15 -4
  106. package/dist/queryUpdate.d.ts.map +1 -1
  107. package/dist/queryUpdate.js +7 -1
  108. package/dist/queryUpdate.js.map +1 -1
  109. package/dist/retainQuery.d.ts +4 -0
  110. package/dist/retainQuery.d.ts.map +1 -0
  111. package/dist/retainQuery.js +35 -0
  112. package/dist/retainQuery.js.map +1 -0
  113. package/package.json +8 -8
  114. package/src/AutomaticQueryOptions.ts +0 -5
  115. package/src/adapters/activityState.ts +0 -1
  116. package/src/adapters/retainedQueries.ts +47 -0
  117. package/src/adapters/standaloneLiveServer.ts +1 -5
  118. package/src/automaticLive.ts +4 -16
  119. package/src/automaticQuery.ts +28 -42
  120. package/src/bind.ts +16 -22
  121. package/src/bindOperations.ts +20 -0
  122. package/src/changesSuccess.ts +3 -5
  123. package/src/clientActivities.ts +1 -5
  124. package/src/clientActivity.ts +1 -2
  125. package/src/clientOperations.ts +77 -85
  126. package/src/compareQueries.ts +12 -38
  127. package/src/live-server/subscribe.ts +5 -9
  128. package/src/live.ts +19 -97
  129. package/src/liveAttempt.ts +17 -41
  130. package/src/liveHintQueue.ts +9 -12
  131. package/src/operation.ts +3 -17
  132. package/src/operationDeclaration.ts +0 -2
  133. package/src/queryDelivery.ts +6 -26
  134. package/src/queryProgress.ts +0 -3
  135. package/src/queryRetention.ts +9 -0
  136. package/src/querySignals.ts +1 -0
  137. package/src/querySubscription.ts +1 -1
  138. package/src/queryUpdate.ts +10 -4
  139. package/src/retainQuery.ts +36 -0
  140. package/dist/liveInvalidation.d.ts +0 -12
  141. package/dist/liveInvalidation.d.ts.map +0 -1
  142. package/dist/liveInvalidation.js +0 -14
  143. package/dist/liveInvalidation.js.map +0 -1
  144. package/dist/livePending.d.ts +0 -7
  145. package/dist/livePending.d.ts.map +0 -1
  146. package/dist/livePending.js +0 -27
  147. package/dist/livePending.js.map +0 -1
  148. package/dist/queryCoalesceWindow.d.ts +0 -4
  149. package/dist/queryCoalesceWindow.d.ts.map +0 -1
  150. package/dist/queryCoalesceWindow.js +0 -11
  151. package/dist/queryCoalesceWindow.js.map +0 -1
  152. package/dist/queryFailure.d.ts +0 -4
  153. package/dist/queryFailure.d.ts.map +0 -1
  154. package/dist/queryFailure.js +0 -12
  155. package/dist/queryFailure.js.map +0 -1
  156. package/dist/queryHints.d.ts +0 -9
  157. package/dist/queryHints.d.ts.map +0 -1
  158. package/dist/queryHints.js +0 -34
  159. package/dist/queryHints.js.map +0 -1
  160. package/dist/queryReactivity.d.ts +0 -5
  161. package/dist/queryReactivity.d.ts.map +0 -1
  162. package/dist/queryReactivity.js +0 -109
  163. package/dist/queryReactivity.js.map +0 -1
  164. package/src/liveInvalidation.ts +0 -21
  165. package/src/livePending.ts +0 -28
  166. package/src/queryCoalesceWindow.ts +0 -13
  167. package/src/queryFailure.ts +0 -13
  168. package/src/queryHints.ts +0 -39
  169. package/src/queryReactivity.ts +0 -127
@@ -1,127 +0,0 @@
1
- import { Cause, Duration, Effect, Option, Predicate } from "effect";
2
- import * as AsyncResult from "effect/reactivity/AsyncResult";
3
- import * as Atom from "effect/reactivity/Atom";
4
- import type * as AtomRegistry from "effect/reactivity/AtomRegistry";
5
- import * as Reactivity from "effect/reactivity/Reactivity";
6
- import { queryCoalesceWindow } from "#queryCoalesceWindow.ts";
7
- import { liveBatches, liveKeys } from "./liveInvalidation.ts";
8
- import { wrapAtom } from "./wrapAtom.ts";
9
-
10
- export function queryReactivity<R, E>(runtime: Atom.AtomRuntime<R, E>, queue?: () => () => void) {
11
- const service = runtime.atom(Effect.service(Reactivity.Reactivity));
12
- type Query = Atom.Atom<AsyncResult.AsyncResult<unknown, unknown>>;
13
- const cached = new WeakMap<Query, Query>();
14
- return (atom: Query, keys: readonly string[], owner?: AtomRegistry.AtomRegistry): Query => {
15
- const existing = cached.get(atom);
16
- if (existing !== undefined) {
17
- return existing;
18
- }
19
- const source = Atom.setIdleTTL(
20
- Atom.readable((get) => atom.read(get), atom.refresh),
21
- 0,
22
- );
23
- const wrapped = wrapAtom(
24
- atom,
25
- (get) => {
26
- if (owner !== undefined && owner !== get.registry) {
27
- throw new Error("A session-scoped query belongs to its binding registry");
28
- }
29
- const context = get(service);
30
- if (!AsyncResult.isSuccess(context)) {
31
- return get(source);
32
- }
33
- const reactivity = context.value;
34
- let pending: (() => boolean) | undefined;
35
- let queued: (() => void) | undefined;
36
- function dequeue() {
37
- if (!scheduled && pending === undefined) {
38
- queued?.();
39
- queued = undefined;
40
- }
41
- }
42
- let scheduled = false;
43
- const timer = runtime.fn(({ delay, active }: { readonly delay: number; readonly active: () => boolean }) =>
44
- Effect.andThen(
45
- Effect.sleep(delay),
46
- Effect.sync(() => {
47
- scheduled = false;
48
- refresh(active);
49
- }),
50
- ),
51
- );
52
- get.mount(timer);
53
- function clear() {
54
- get.set(timer, Atom.Interrupt);
55
- scheduled = false;
56
- pending = undefined;
57
- dequeue();
58
- }
59
- function reread() {
60
- if (
61
- !Option.exists(AsyncResult.cause(get.once(source)), (cause) =>
62
- Option.exists(Cause.findErrorOption(cause), Predicate.isTagged("QueryReadDenied")),
63
- )
64
- ) {
65
- get.refresh(source);
66
- }
67
- }
68
- function refresh(active: () => boolean) {
69
- if (!active()) {
70
- dequeue();
71
- return;
72
- }
73
- if (get.once(source).waiting) {
74
- pending = active;
75
- } else {
76
- pending = undefined;
77
- reread();
78
- dequeue();
79
- }
80
- }
81
- function changed() {
82
- const batch = liveBatches.get(reactivity);
83
- if (batch === undefined || batch.seen.has(changed)) {
84
- return;
85
- }
86
- batch.seen.add(changed);
87
- const delay = Duration.toMillis(Duration.fromInputUnsafe(get.once(queryCoalesceWindow(wrapped)) ?? batch.window ?? 0));
88
- if (delay === 0) {
89
- clear();
90
- reread();
91
- } else if (!scheduled) {
92
- queued ??= queue?.();
93
- scheduled = true;
94
- get.set(timer, { active: batch.active, delay });
95
- }
96
- }
97
- get.addFinalizer(clear);
98
- get.addFinalizer(reactivity.registerUnsafe(liveKeys(keys), changed));
99
- get.addFinalizer(
100
- reactivity.registerUnsafe(keys, () => {
101
- if (!liveBatches.has(reactivity)) {
102
- clear();
103
- reread();
104
- }
105
- }),
106
- );
107
- get.subscribe(source, (value) => {
108
- get.setSelf(value);
109
- if (pending !== undefined && !value.waiting) {
110
- const active = pending;
111
- pending = undefined;
112
- if (active()) {
113
- get.set(timer, Atom.Interrupt);
114
- scheduled = false;
115
- reread();
116
- }
117
- dequeue();
118
- }
119
- });
120
- return get.once(source);
121
- },
122
- source,
123
- );
124
- cached.set(atom, wrapped);
125
- return wrapped;
126
- };
127
- }