@shivaedev/contract 0.52.0 → 0.53.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 (55) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/README.md +13 -0
  3. package/dist/QueryStorage.d.ts +18 -0
  4. package/dist/QueryStorage.d.ts.map +1 -0
  5. package/dist/QueryStorage.js +4 -0
  6. package/dist/QueryStorage.js.map +1 -0
  7. package/dist/adapters/browserQueryStorage.d.ts +4 -0
  8. package/dist/adapters/browserQueryStorage.d.ts.map +1 -0
  9. package/dist/adapters/browserQueryStorage.js +12 -0
  10. package/dist/adapters/browserQueryStorage.js.map +1 -0
  11. package/dist/adapters/indexedQueryRows.d.ts +13 -0
  12. package/dist/adapters/indexedQueryRows.d.ts.map +1 -0
  13. package/dist/adapters/indexedQueryRows.js +53 -0
  14. package/dist/adapters/indexedQueryRows.js.map +1 -0
  15. package/dist/adapters/queryPersistence.d.ts +11 -0
  16. package/dist/adapters/queryPersistence.d.ts.map +1 -0
  17. package/dist/adapters/queryPersistence.js +124 -0
  18. package/dist/adapters/queryPersistence.js.map +1 -0
  19. package/dist/adapters/storedQueryAccess.d.ts +16 -0
  20. package/dist/adapters/storedQueryAccess.d.ts.map +1 -0
  21. package/dist/adapters/storedQueryAccess.js +30 -0
  22. package/dist/adapters/storedQueryAccess.js.map +1 -0
  23. package/dist/clientActivities.d.ts.map +1 -1
  24. package/dist/clientActivities.js +2 -0
  25. package/dist/clientActivities.js.map +1 -1
  26. package/dist/clientOperations.d.ts.map +1 -1
  27. package/dist/clientOperations.js +5 -4
  28. package/dist/clientOperations.js.map +1 -1
  29. package/dist/queryRetention.d.ts +1 -0
  30. package/dist/queryRetention.d.ts.map +1 -1
  31. package/dist/queryRetention.js.map +1 -1
  32. package/dist/retainQuery.d.ts +2 -1
  33. package/dist/retainQuery.d.ts.map +1 -1
  34. package/dist/retainQuery.js +20 -2
  35. package/dist/retainQuery.js.map +1 -1
  36. package/dist/storedQueries.d.ts +17 -0
  37. package/dist/storedQueries.d.ts.map +1 -0
  38. package/dist/storedQueries.js +17 -0
  39. package/dist/storedQueries.js.map +1 -0
  40. package/dist/subjectHeader.d.ts +1 -0
  41. package/dist/subjectHeader.d.ts.map +1 -1
  42. package/dist/subjectHeader.js +4 -1
  43. package/dist/subjectHeader.js.map +1 -1
  44. package/package.json +10 -9
  45. package/src/QueryStorage.ts +18 -0
  46. package/src/adapters/browserQueryStorage.ts +14 -0
  47. package/src/adapters/indexedQueryRows.ts +66 -0
  48. package/src/adapters/queryPersistence.ts +134 -0
  49. package/src/adapters/storedQueryAccess.ts +37 -0
  50. package/src/clientActivities.ts +2 -0
  51. package/src/clientOperations.ts +5 -4
  52. package/src/queryRetention.ts +1 -0
  53. package/src/retainQuery.ts +25 -2
  54. package/src/storedQueries.ts +34 -0
  55. package/src/subjectHeader.ts +5 -1
@@ -1,6 +1,7 @@
1
- import { Option } from "effect";
1
+ import { Cause, Option, Predicate } from "effect";
2
2
  import * as AsyncResult from "effect/reactivity/AsyncResult";
3
3
  import * as Atom from "effect/reactivity/Atom";
4
+ import { queryPersistence } from "#adapters/queryPersistence.ts";
4
5
  import { retainedQueries } from "#adapters/retainedQueries.ts";
5
6
  import { querySignals, shareQuerySignals } from "#querySignals.ts";
6
7
  import { wrapAtom } from "#wrapAtom.ts";
@@ -8,22 +9,39 @@ const runtimes = new WeakMap();
8
9
  export function queryRuntime(query) {
9
10
  return runtimes.get(query);
10
11
  }
11
- export function retainQuery(runtime, atom) {
12
+ const gone = Predicate.or(Predicate.isTagged("QueryReadDenied"), Predicate.isTagged("NotFound"));
13
+ export function retainQuery(runtime, atom, stored) {
12
14
  const snapshot = Atom.make(Option.none()).pipe(Atom.setIdleTTL(0));
13
15
  const signals = querySignals(atom);
14
16
  const retained = wrapAtom(atom, (get) => {
15
17
  get.mount(snapshot);
16
18
  const owner = get.once(retainedQueries);
19
+ const persistence = stored === undefined ? undefined : get.once(queryPersistence);
17
20
  owner.take(retained);
18
21
  get.addFinalizer(() => {
19
22
  if (get.registry.getNodes().has(snapshot) && Option.isSome(get.registry.get(snapshot))) {
20
23
  owner.keep(retained, snapshot, runtime);
21
24
  }
22
25
  });
26
+ if (stored !== undefined && persistence !== undefined && Option.isNone(get.once(snapshot))) {
27
+ Option.map(persistence.restore(stored, runtime), (value) => get.set(snapshot, Option.some(AsyncResult.success(value))));
28
+ }
29
+ function persist(result) {
30
+ if (stored === undefined || persistence === undefined || result.waiting) {
31
+ return;
32
+ }
33
+ if (AsyncResult.isSuccess(result)) {
34
+ persistence.save(stored, result.value, runtime);
35
+ }
36
+ else if (AsyncResult.isFailure(result) && Option.exists(Cause.findErrorOption(result.cause), gone)) {
37
+ persistence.drop(stored, runtime);
38
+ }
39
+ }
23
40
  function display(result) {
24
41
  if (AsyncResult.isSuccess(result) && !result.waiting) {
25
42
  get.set(snapshot, Option.some(result));
26
43
  }
44
+ persist(result);
27
45
  const kept = AsyncResult.isInitial(result) ? get.once(snapshot) : Option.none();
28
46
  get.set(signals, { ...get.once(signals), retained: Option.isSome(kept) });
29
47
  return Option.match(kept, { onNone: () => result, onSome: AsyncResult.waiting });
@@ -1 +1 @@
1
- {"version":3,"file":"retainQuery.js","sourceRoot":"","sources":["../src/retainQuery.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"retainQuery.js","sourceRoot":"","sources":["../src/retainQuery.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import { Effect, Schema } from "effect";
2
+ import * as Atom from "effect/reactivity/Atom";
3
+ import type { QueryShape } from "#operation.ts";
4
+ import type { QueryStorage, StoredQuery } from "#QueryStorage.ts";
5
+ export interface OpenedQueryStorage {
6
+ readonly entries: readonly StoredQuery[];
7
+ readonly storage: QueryStorage;
8
+ readonly user: string;
9
+ }
10
+ export interface StoredForm<A> {
11
+ readonly decode: (raw: string) => Effect.Effect<A, Schema.SchemaError, unknown>;
12
+ readonly encode: (value: A) => Effect.Effect<string, Schema.SchemaError, unknown>;
13
+ readonly key: Effect.Effect<string, Schema.SchemaError, unknown>;
14
+ }
15
+ export declare const storedQueries: Atom.Writable<OpenedQueryStorage | undefined, OpenedQueryStorage | undefined>;
16
+ export declare function storedForm(tag: string, query: QueryShape): (value: unknown, subject: string | undefined) => StoredForm<unknown>;
17
+ //# sourceMappingURL=storedQueries.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"storedQueries.d.ts","sourceRoot":"","sources":["../src/storedQueries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAElE,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAChF,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;CACjE;AAED,eAAO,MAAM,aAAa,+EAAuE,CAAC;AAMlG,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,WAIzC,OAAO,WAAW,MAAM,GAAG,SAAS,KAAG,UAAU,CAAC,OAAO,CAAC,CAKzE"}
@@ -0,0 +1,17 @@
1
+ import { Effect, Schema } from "effect";
2
+ import * as Atom from "effect/reactivity/Atom";
3
+ export const storedQueries = Atom.keepAlive(Atom.make(undefined));
4
+ function jsonText(schema) {
5
+ return Schema.fromJsonString(Schema.toCodecJson(schema));
6
+ }
7
+ export function storedForm(tag, query) {
8
+ const payload = Schema.encodeUnknownEffect(jsonText(query.payload));
9
+ const decode = Schema.decodeUnknownEffect(jsonText(query.success));
10
+ const encode = Schema.encodeUnknownEffect(jsonText(query.success));
11
+ return (value, subject) => ({
12
+ decode,
13
+ encode,
14
+ key: Effect.map(payload(value), (encoded) => JSON.stringify([tag, encoded, subject ?? null])),
15
+ });
16
+ }
17
+ //# sourceMappingURL=storedQueries.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"storedQueries.js","sourceRoot":"","sources":["../src/storedQueries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAiB/C,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAiC,SAAS,CAAC,CAAC,CAAC;AAElG,SAAS,QAAQ,CAA6B,MAAe;IAC5D,OAAO,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,KAAiB;IACxD,MAAM,OAAO,GAAG,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,KAAc,EAAE,OAA2B,EAAuB,EAAE,CAAC,CAAC;QAC7E,MAAM;QACN,MAAM;QACN,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC;KAC7F,CAAC,CAAC;AACJ,CAAC"}
@@ -1,5 +1,6 @@
1
1
  import { Headers } from "effect/http";
2
2
  export declare function subjectHeader(headers: Headers.Headers): string | undefined;
3
3
  export declare function withSubject(headers: Headers.Input | undefined, subject: string | undefined): Headers.Input | undefined;
4
+ export declare function inputSubject(headers: Headers.Input | undefined): string | undefined;
4
5
  export declare function subjectSerializationKey(key: string | undefined, headers: Headers.Input | undefined): string | undefined;
5
6
  //# sourceMappingURL=subjectHeader.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"subjectHeader.d.ts","sourceRoot":"","sources":["../src/subjectHeader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAItC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAEtH;AAGD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGvH"}
1
+ {"version":3,"file":"subjectHeader.d.ts","sourceRoot":"","sources":["../src/subjectHeader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAItC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAEtH;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEnF;AAGD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGvH"}
@@ -6,9 +6,12 @@ export function subjectHeader(headers) {
6
6
  export function withSubject(headers, subject) {
7
7
  return subject === undefined ? headers : Headers.set(Headers.fromInput(headers), HEADER, subject);
8
8
  }
9
+ export function inputSubject(headers) {
10
+ return headers === undefined ? undefined : subjectHeader(Headers.fromInput(headers));
11
+ }
9
12
  // Effect keys a serialized query by its tag and this key alone, so a subject that the key leaves out would hydrate into another subject's query.
10
13
  export function subjectSerializationKey(key, headers) {
11
- const subject = headers === undefined ? undefined : subjectHeader(Headers.fromInput(headers));
14
+ const subject = inputSubject(headers);
12
15
  return key === undefined || subject === undefined ? key : `${key}:subject:${subject}`;
13
16
  }
14
17
  //# sourceMappingURL=subjectHeader.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"subjectHeader.js","sourceRoot":"","sources":["../src/subjectHeader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,MAAM,GAAG,oBAAoB,CAAC;AAEpC,MAAM,UAAU,aAAa,CAAC,OAAwB;IACrD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAkC,EAAE,OAA2B;IAC1F,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACnG,CAAC;AAED,iJAAiJ;AACjJ,MAAM,UAAU,uBAAuB,CAAC,GAAuB,EAAE,OAAkC;IAClG,MAAM,OAAO,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9F,OAAO,GAAG,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,YAAY,OAAO,EAAE,CAAC;AACvF,CAAC"}
1
+ {"version":3,"file":"subjectHeader.js","sourceRoot":"","sources":["../src/subjectHeader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,MAAM,GAAG,oBAAoB,CAAC;AAEpC,MAAM,UAAU,aAAa,CAAC,OAAwB;IACrD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAkC,EAAE,OAA2B;IAC1F,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAkC;IAC9D,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,iJAAiJ;AACjJ,MAAM,UAAU,uBAAuB,CAAC,GAAuB,EAAE,OAAkC;IAClG,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,GAAG,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,YAAY,OAAO,EAAE,CAAC;AACvF,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shivaedev/contract",
3
- "version": "0.52.0",
3
+ "version": "0.53.0",
4
4
  "description": "Typed query and command contracts over native Effect RPC and reactivity",
5
5
  "keywords": [
6
6
  "effect"
@@ -44,22 +44,23 @@
44
44
  ],
45
45
  "dependencies": {
46
46
  "@shivaedev/changes": "0.14.1",
47
- "@shivaedev/errors": "0.14.0",
47
+ "@shivaedev/errors": "0.14.1",
48
48
  "@shivaedev/service": "0.9.2",
49
49
  "@shivaedev/types": "0.4.0"
50
50
  },
51
51
  "devDependencies": {
52
52
  "@effect/platform-node": "4.1.4",
53
53
  "@effect/vitest": "4.1.4",
54
- "@shivaedev/identity": "0.35.0",
55
- "@shivaedev/quality": "0.80.0",
56
- "@shivaedev/server": "0.38.2",
57
- "@shivaedev/sql": "0.52.0",
58
- "@shivaedev/test-kits": "0.13.7",
59
- "@shivaedev/test-sql": "0.25.5",
60
- "@shivaedev/test-story": "0.50.1",
54
+ "@shivaedev/identity": "0.36.0",
55
+ "@shivaedev/quality": "0.81.1",
56
+ "@shivaedev/server": "0.38.3",
57
+ "@shivaedev/sql": "0.53.0",
58
+ "@shivaedev/test-kits": "0.14.0",
59
+ "@shivaedev/test-sql": "0.25.6",
60
+ "@shivaedev/test-story": "0.50.2",
61
61
  "@types/node": "24.19.2",
62
62
  "effect": "4.1.4",
63
+ "fake-indexeddb": "6.2.8",
63
64
  "happy-dom": "21.0.4",
64
65
  "typescript": "7.0.2",
65
66
  "vitest": "5.1.0"
@@ -0,0 +1,18 @@
1
+ import { Context, type Effect } from "effect";
2
+
3
+ export type QueryStorageOperation<A> = A | Effect.Effect<A, unknown>;
4
+
5
+ export interface StoredQuery {
6
+ readonly key: string;
7
+ readonly used: number;
8
+ readonly value: string;
9
+ }
10
+
11
+ export interface QueryStorage {
12
+ readonly clear: (user?: string) => QueryStorageOperation<void>;
13
+ readonly getAll: (user: string) => QueryStorageOperation<readonly StoredQuery[]>;
14
+ readonly removeItems: (user: string, keys: readonly string[]) => QueryStorageOperation<void>;
15
+ readonly setItems: (user: string, entries: readonly StoredQuery[]) => QueryStorageOperation<void>;
16
+ }
17
+
18
+ export class QueryStorageProvider extends Context.Service<QueryStorageProvider, () => QueryStorage>()("@shivaedev/contract/QueryStorageProvider") {}
@@ -0,0 +1,14 @@
1
+ import { Effect, Layer } from "effect";
2
+ import { indexedQueryRows } from "#adapters/indexedQueryRows.ts";
3
+ import { type QueryStorage, QueryStorageProvider } from "#QueryStorage.ts";
4
+
5
+ const rows = indexedQueryRows(() => ({ factory: globalThis.indexedDB, keyRange: globalThis.IDBKeyRange }));
6
+
7
+ const storage: QueryStorage = {
8
+ clear: (user) => Effect.tryPromise(() => rows.clear(user)),
9
+ getAll: (user) => Effect.tryPromise(() => rows.getAll(user)),
10
+ removeItems: (user, keys) => Effect.tryPromise(() => rows.removeItems(user, keys)),
11
+ setItems: (user, entries) => Effect.tryPromise(() => rows.setItems(user, entries)),
12
+ };
13
+
14
+ export const browserQueryStorage = Layer.succeed(QueryStorageProvider, () => storage);
@@ -0,0 +1,66 @@
1
+ import type { StoredQuery } from "#QueryStorage.ts";
2
+
3
+ const DATABASE = "@shivaedev/contract/queries";
4
+ const RESULTS = "results";
5
+
6
+ interface StoredRow extends StoredQuery {
7
+ readonly user: string;
8
+ }
9
+
10
+ interface IndexedHost {
11
+ readonly factory: IDBFactory;
12
+ readonly keyRange: typeof IDBKeyRange;
13
+ }
14
+
15
+ export function indexedQueryRows(host: () => IndexedHost) {
16
+ let opened: Promise<IDBDatabase> | undefined;
17
+ function database(): Promise<IDBDatabase> {
18
+ opened ??= new Promise<IDBDatabase>((resolve, reject) => {
19
+ const request = host().factory.open(DATABASE, 1);
20
+ request.onupgradeneeded = () => {
21
+ request.result.createObjectStore(RESULTS, { keyPath: ["user", "key"] });
22
+ };
23
+ request.onsuccess = () => resolve(request.result);
24
+ request.onerror = () => reject(request.error);
25
+ }).catch((error: unknown) => {
26
+ opened = undefined;
27
+ throw error;
28
+ });
29
+ return opened;
30
+ }
31
+ async function results<A>(mode: IDBTransactionMode, run: (store: IDBObjectStore) => IDBRequest<A> | undefined) {
32
+ const db = await database();
33
+ return new Promise<A | undefined>((resolve, reject) => {
34
+ const transaction = db.transaction(RESULTS, mode);
35
+ const request = run(transaction.objectStore(RESULTS));
36
+ transaction.oncomplete = () => resolve(request?.result);
37
+ transaction.onerror = () => reject(transaction.error);
38
+ transaction.onabort = () => reject(transaction.error);
39
+ });
40
+ }
41
+ // Rows are keyed [user, key]; an array sorts after every string, so [user, []] closes the range of one user's rows.
42
+ function userRows(user: string) {
43
+ return host().keyRange.bound([user], [user, []]);
44
+ }
45
+ return {
46
+ clear: (user?: string) => results("readwrite", (store) => (user === undefined ? store.clear() : store.delete(userRows(user)))),
47
+ getAll: async (user: string): Promise<StoredQuery[]> => {
48
+ const rows = await results<StoredRow[]>("readonly", (store) => store.getAll(userRows(user)));
49
+ return (rows ?? []).map(({ key, used, value }) => ({ key, used, value }));
50
+ },
51
+ removeItems: (user: string, keys: readonly string[]) =>
52
+ results("readwrite", (store) => {
53
+ for (const key of keys) {
54
+ store.delete([user, key]);
55
+ }
56
+ return undefined;
57
+ }),
58
+ setItems: (user: string, entries: readonly StoredQuery[]) =>
59
+ results("readwrite", (store) => {
60
+ for (const entry of entries) {
61
+ store.put({ ...entry, user });
62
+ }
63
+ return undefined;
64
+ }),
65
+ };
66
+ }
@@ -0,0 +1,134 @@
1
+ import { Effect, Exit, Option } from "effect";
2
+ import * as AsyncResult from "effect/reactivity/AsyncResult";
3
+ import * as Atom from "effect/reactivity/Atom";
4
+ import { storageOperation, storageQueue } from "#adapters/storedQueryAccess.ts";
5
+ import type { StoredQuery } from "#QueryStorage.ts";
6
+ import { queryRetention } from "#queryRetention.ts";
7
+ import { type StoredForm, storedQueries } from "#storedQueries.ts";
8
+
9
+ export const STORED_WRITE_WINDOW = "1 second";
10
+ const STORED_BYTES = 5_000_000;
11
+ const utf8 = new TextEncoder();
12
+
13
+ function storedBytes(key: string, value: string) {
14
+ return utf8.encode(key).byteLength + utf8.encode(value).byteLength;
15
+ }
16
+
17
+ export const queryPersistence = Atom.keepAlive(
18
+ Atom.make((get) => {
19
+ const opened = get(storedQueries);
20
+ if (opened === undefined) {
21
+ return undefined;
22
+ }
23
+ const { storage, user } = opened;
24
+ const registry = get.registry;
25
+ const seeds = new Map(opened.entries.map((entry) => [entry.key, entry.value]));
26
+ const kept = new Map<string, number>();
27
+ let used = 0;
28
+ for (const entry of [...opened.entries].sort((left, right) => left.used - right.used)) {
29
+ kept.set(entry.key, storedBytes(entry.key, entry.value));
30
+ used = Math.max(used, entry.used);
31
+ }
32
+ const written = new Map<string, StoredQuery>();
33
+ const removed = new Set<string>();
34
+ let active = true;
35
+ let stop: (() => void) | undefined;
36
+ get.addFinalizer(() => {
37
+ active = false;
38
+ stop?.();
39
+ });
40
+ function flush() {
41
+ stop?.();
42
+ stop = undefined;
43
+ const entries = [...written.values()];
44
+ const keys = [...removed];
45
+ written.clear();
46
+ removed.clear();
47
+ if (!active || (entries.length === 0 && keys.length === 0)) {
48
+ return;
49
+ }
50
+ Effect.runFork(
51
+ storageQueue(storage)(
52
+ Effect.all([
53
+ entries.length === 0 ? Effect.void : storageOperation(() => storage.setItems(user, entries)),
54
+ keys.length === 0 ? Effect.void : storageOperation(() => storage.removeItems(user, keys)),
55
+ ]),
56
+ ).pipe(Effect.catchTag("QueryStorageUnavailable", () => Effect.void)),
57
+ );
58
+ }
59
+ function forget(key: string) {
60
+ kept.delete(key);
61
+ written.delete(key);
62
+ removed.add(key);
63
+ }
64
+ function schedule(runtime: Atom.AtomRuntime<unknown, unknown>) {
65
+ if (stop !== undefined) {
66
+ return;
67
+ }
68
+ const timer = Atom.make((context) => {
69
+ const services = context(runtime);
70
+ if (AsyncResult.isSuccess(services)) {
71
+ context.addFinalizer(Effect.runCallbackWith(services.value)(Effect.sleep(STORED_WRITE_WINDOW).pipe(Effect.andThen(Effect.sync(flush)))));
72
+ }
73
+ }).pipe(Atom.setIdleTTL(0));
74
+ stop = registry.mount(timer);
75
+ }
76
+ function evict() {
77
+ const { capacity = 100, storedBytes: byteCap = STORED_BYTES } = registry.get(queryRetention);
78
+ let bytes = [...kept.values()].reduce((total, size) => total + size, 0);
79
+ for (const [key, size] of kept) {
80
+ if (kept.size <= capacity && bytes <= byteCap) {
81
+ break;
82
+ }
83
+ bytes -= size;
84
+ forget(key);
85
+ }
86
+ }
87
+ function run<A>(runtime: Atom.AtomRuntime<unknown, unknown>, effect: Effect.Effect<A, unknown, unknown>): Option.Option<A> {
88
+ const services = registry.get(runtime);
89
+ if (!AsyncResult.isSuccess(services)) {
90
+ return Option.none();
91
+ }
92
+ const exit = Effect.runSyncExitWith(services.value)(effect);
93
+ return Exit.isSuccess(exit) ? Option.some(exit.value) : Option.none();
94
+ }
95
+ function drop(key: string, runtime: Atom.AtomRuntime<unknown, unknown>) {
96
+ seeds.delete(key);
97
+ if (kept.has(key) || written.has(key)) {
98
+ forget(key);
99
+ schedule(runtime);
100
+ }
101
+ }
102
+ return {
103
+ drop: <A>(form: StoredForm<A>, runtime: Atom.AtomRuntime<unknown, unknown>) => {
104
+ Option.map(run(runtime, form.key), (key) => drop(key, runtime));
105
+ },
106
+ flush,
107
+ restore: <A>(form: StoredForm<A>, runtime: Atom.AtomRuntime<unknown, unknown>): Option.Option<A> =>
108
+ Option.flatMap(run(runtime, form.key), (key) => {
109
+ const raw = seeds.get(key);
110
+ seeds.delete(key);
111
+ if (raw === undefined) {
112
+ return Option.none();
113
+ }
114
+ const decoded = run(runtime, form.decode(raw));
115
+ if (Option.isNone(decoded)) {
116
+ drop(key, runtime);
117
+ }
118
+ return decoded;
119
+ }),
120
+ save: <A>(form: StoredForm<A>, value: A, runtime: Atom.AtomRuntime<unknown, unknown>) => {
121
+ const stored = Option.all({ encoded: run(runtime, form.encode(value)), key: run(runtime, form.key) });
122
+ Option.map(stored, ({ encoded, key }) => {
123
+ used += 1;
124
+ kept.delete(key);
125
+ kept.set(key, storedBytes(key, encoded));
126
+ written.set(key, { key, used, value: encoded });
127
+ removed.delete(key);
128
+ evict();
129
+ schedule(runtime);
130
+ });
131
+ },
132
+ };
133
+ }),
134
+ );
@@ -0,0 +1,37 @@
1
+ import { Data, Effect, Semaphore } from "effect";
2
+ import { type QueryStorage, type QueryStorageOperation, QueryStorageProvider } from "#QueryStorage.ts";
3
+ import type { OpenedQueryStorage } from "#storedQueries.ts";
4
+
5
+ export class QueryStorageUnavailable extends Data.TaggedError("QueryStorageUnavailable")<{ readonly cause: unknown }> {}
6
+
7
+ export function storageOperation<A>(run: () => QueryStorageOperation<A>): Effect.Effect<A, QueryStorageUnavailable> {
8
+ return Effect.suspend(() => {
9
+ const value = run();
10
+ return Effect.isEffect(value) ? value : Effect.succeed(value);
11
+ }).pipe(Effect.catchCause((cause) => Effect.fail(new QueryStorageUnavailable({ cause }))));
12
+ }
13
+
14
+ // Writes from one generation, the next generation's read and a wipe reach the same storage, so they run in the order they were asked for.
15
+ const queues = new WeakMap<QueryStorage, Semaphore.Semaphore>();
16
+ export function storageQueue(storage: QueryStorage) {
17
+ let queue = queues.get(storage);
18
+ if (queue === undefined) {
19
+ queue = Semaphore.makeUnsafe(1);
20
+ queues.set(storage, queue);
21
+ }
22
+ return queue.withPermit;
23
+ }
24
+
25
+ // Storage the browser refuses leaves this generation without stored results rather than failing it.
26
+ export const openStoredQueries = Effect.fn("Contract.openStoredQueries")(function* (user: string) {
27
+ const storage = (yield* QueryStorageProvider)();
28
+ return yield* storageQueue(storage)(storageOperation(() => storage.getAll(user))).pipe(
29
+ Effect.map((entries): OpenedQueryStorage | undefined => ({ entries, storage, user })),
30
+ Effect.catchTag("QueryStorageUnavailable", () => Effect.succeed(undefined)),
31
+ );
32
+ });
33
+
34
+ export const clearStoredQueries = Effect.fn("Contract.clearStoredQueries")(function* (user?: string) {
35
+ const storage = (yield* QueryStorageProvider)();
36
+ yield* storageQueue(storage)(storageOperation(() => storage.clear(user))).pipe(Effect.catchTag("QueryStorageUnavailable", () => Effect.void));
37
+ });
@@ -3,6 +3,7 @@ import * as AsyncResult from "effect/reactivity/AsyncResult";
3
3
  import type * as Atom from "effect/reactivity/Atom";
4
4
  import { activityState } from "#adapters/activityState.ts";
5
5
  import { clientConnection } from "#adapters/clientConnection.ts";
6
+ import { shareQuerySignals } from "#querySignals.ts";
6
7
  import { wrapAtom } from "#wrapAtom.ts";
7
8
 
8
9
  type ActivityTracker = ReturnType<typeof makeActivity>;
@@ -80,6 +81,7 @@ export function makeActivity(factory: Atom.RuntimeFactory) {
80
81
  }
81
82
  return value;
82
83
  });
84
+ shareQuerySignals(watched, atom);
83
85
  return watched;
84
86
  }
85
87
  return {
@@ -17,10 +17,10 @@ import { CommandSignal, untilReflected } from "#commandSignal.ts";
17
17
  import { waitForConnection } from "#connectionReadiness.ts";
18
18
  import { LIVE_SYNC } from "#liveSyncRpc.ts";
19
19
  import type { CommandShape, QueryShape } from "#operation.ts";
20
- import { shareQuerySignals } from "#querySignals.ts";
21
20
  import { type CommandObserver, reflectCommand } from "#reflectCommand.ts";
22
21
  import { retainQuery } from "#retainQuery.ts";
23
- import { subjectSerializationKey, withSubject } from "#subjectHeader.ts";
22
+ import { storedForm } from "#storedQueries.ts";
23
+ import { inputSubject, subjectSerializationKey, withSubject } from "#subjectHeader.ts";
24
24
  import { warmQueries } from "#warmQueries.ts";
25
25
 
26
26
  // `runtime.fn(api.save.run)` passes its function context as the second argument, so only an options object selects a subject.
@@ -46,6 +46,7 @@ export function clientOperations(
46
46
 
47
47
  function boundQuery(tag: string, query: QueryShape) {
48
48
  const cached = new WeakMap<ReturnType<typeof ordinaryClient.query>, ReturnType<typeof ordinaryClient.query>>();
49
+ const stored = storedForm(tag, query);
49
50
  return {
50
51
  query: (payload: unknown, { headers: given, serializationKey, subject }: QueryOptions = {}) => {
51
52
  const headers = withSubject(given, subject);
@@ -75,8 +76,8 @@ export function clientOperations(
75
76
  function warm(get: Atom.AtomContext): boolean {
76
77
  return get.once(warmQueries).has(tracked);
77
78
  }
78
- const tracked = retainQuery(ordinaryClient.runtime, clientActivities.get(ordinaryClient)?.watch(result, warm) ?? result);
79
- shareQuerySignals(tracked, result);
79
+ const watched = clientActivities.get(ordinaryClient)?.watch(result, warm) ?? result;
80
+ const tracked = retainQuery(ordinaryClient.runtime, watched, stored(payload, inputSubject(headers)));
80
81
  cached.set(atom, tracked);
81
82
  return tracked;
82
83
  },
@@ -3,6 +3,7 @@ import * as Atom from "effect/reactivity/Atom";
3
3
 
4
4
  export interface QueryRetentionOptions {
5
5
  readonly capacity?: number;
6
+ readonly storedBytes?: number;
6
7
  readonly timeToLive?: Duration.Input;
7
8
  }
8
9
 
@@ -1,8 +1,10 @@
1
- import { Option } from "effect";
1
+ import { Cause, Option, Predicate } from "effect";
2
2
  import * as AsyncResult from "effect/reactivity/AsyncResult";
3
3
  import * as Atom from "effect/reactivity/Atom";
4
+ import { queryPersistence } from "#adapters/queryPersistence.ts";
4
5
  import { retainedQueries } from "#adapters/retainedQueries.ts";
5
6
  import { querySignals, shareQuerySignals } from "#querySignals.ts";
7
+ import type { StoredForm } from "#storedQueries.ts";
6
8
  import { wrapAtom } from "#wrapAtom.ts";
7
9
 
8
10
  const runtimes = new WeakMap<Atom.Atom<unknown>, Atom.AtomRuntime<unknown, unknown>>();
@@ -11,22 +13,43 @@ export function queryRuntime(query: Atom.Atom<unknown>): Atom.AtomRuntime<unknow
11
13
  return runtimes.get(query);
12
14
  }
13
15
 
14
- export function retainQuery<A, E>(runtime: Atom.AtomRuntime<unknown, unknown>, atom: Atom.Atom<AsyncResult.AsyncResult<A, E>>) {
16
+ const gone = Predicate.or(Predicate.isTagged("QueryReadDenied"), Predicate.isTagged("NotFound"));
17
+
18
+ export function retainQuery<A, E>(
19
+ runtime: Atom.AtomRuntime<unknown, unknown>,
20
+ atom: Atom.Atom<AsyncResult.AsyncResult<A, E>>,
21
+ stored?: StoredForm<A>,
22
+ ) {
15
23
  const snapshot = Atom.make<Option.Option<AsyncResult.Success<A, E>>>(Option.none()).pipe(Atom.setIdleTTL(0));
16
24
  const signals = querySignals(atom);
17
25
  const retained = wrapAtom(atom, (get) => {
18
26
  get.mount(snapshot);
19
27
  const owner = get.once(retainedQueries);
28
+ const persistence = stored === undefined ? undefined : get.once(queryPersistence);
20
29
  owner.take(retained);
21
30
  get.addFinalizer(() => {
22
31
  if (get.registry.getNodes().has(snapshot) && Option.isSome(get.registry.get(snapshot))) {
23
32
  owner.keep(retained, snapshot, runtime);
24
33
  }
25
34
  });
35
+ if (stored !== undefined && persistence !== undefined && Option.isNone(get.once(snapshot))) {
36
+ Option.map(persistence.restore(stored, runtime), (value) => get.set(snapshot, Option.some(AsyncResult.success<A, E>(value))));
37
+ }
38
+ function persist(result: AsyncResult.AsyncResult<A, E>) {
39
+ if (stored === undefined || persistence === undefined || result.waiting) {
40
+ return;
41
+ }
42
+ if (AsyncResult.isSuccess(result)) {
43
+ persistence.save(stored, result.value, runtime);
44
+ } else if (AsyncResult.isFailure(result) && Option.exists(Cause.findErrorOption(result.cause), gone)) {
45
+ persistence.drop(stored, runtime);
46
+ }
47
+ }
26
48
  function display(result: AsyncResult.AsyncResult<A, E>) {
27
49
  if (AsyncResult.isSuccess(result) && !result.waiting) {
28
50
  get.set(snapshot, Option.some(result));
29
51
  }
52
+ persist(result);
30
53
  const kept = AsyncResult.isInitial(result) ? get.once(snapshot) : Option.none<AsyncResult.Success<A, E>>();
31
54
  get.set(signals, { ...get.once(signals), retained: Option.isSome(kept) });
32
55
  return Option.match(kept, { onNone: () => result, onSome: AsyncResult.waiting });
@@ -0,0 +1,34 @@
1
+ import { Effect, Schema } from "effect";
2
+ import * as Atom from "effect/reactivity/Atom";
3
+ import type { QueryShape } from "#operation.ts";
4
+ import type { QueryStorage, StoredQuery } from "#QueryStorage.ts";
5
+
6
+ export interface OpenedQueryStorage {
7
+ readonly entries: readonly StoredQuery[];
8
+ readonly storage: QueryStorage;
9
+ readonly user: string;
10
+ }
11
+
12
+ // An operation's schemas may need services, so each step is an Effect that the query runtime's services run.
13
+ export interface StoredForm<A> {
14
+ readonly decode: (raw: string) => Effect.Effect<A, Schema.SchemaError, unknown>;
15
+ readonly encode: (value: A) => Effect.Effect<string, Schema.SchemaError, unknown>;
16
+ readonly key: Effect.Effect<string, Schema.SchemaError, unknown>;
17
+ }
18
+
19
+ export const storedQueries = Atom.keepAlive(Atom.make<OpenedQueryStorage | undefined>(undefined));
20
+
21
+ function jsonText<TSchema extends Schema.Top>(schema: TSchema) {
22
+ return Schema.fromJsonString(Schema.toCodecJson(schema));
23
+ }
24
+
25
+ export function storedForm(tag: string, query: QueryShape) {
26
+ const payload = Schema.encodeUnknownEffect(jsonText(query.payload));
27
+ const decode = Schema.decodeUnknownEffect(jsonText(query.success));
28
+ const encode = Schema.encodeUnknownEffect(jsonText(query.success));
29
+ return (value: unknown, subject: string | undefined): StoredForm<unknown> => ({
30
+ decode,
31
+ encode,
32
+ key: Effect.map(payload(value), (encoded) => JSON.stringify([tag, encoded, subject ?? null])),
33
+ });
34
+ }
@@ -10,8 +10,12 @@ export function withSubject(headers: Headers.Input | undefined, subject: string
10
10
  return subject === undefined ? headers : Headers.set(Headers.fromInput(headers), HEADER, subject);
11
11
  }
12
12
 
13
+ export function inputSubject(headers: Headers.Input | undefined): string | undefined {
14
+ return headers === undefined ? undefined : subjectHeader(Headers.fromInput(headers));
15
+ }
16
+
13
17
  // Effect keys a serialized query by its tag and this key alone, so a subject that the key leaves out would hydrate into another subject's query.
14
18
  export function subjectSerializationKey(key: string | undefined, headers: Headers.Input | undefined): string | undefined {
15
- const subject = headers === undefined ? undefined : subjectHeader(Headers.fromInput(headers));
19
+ const subject = inputSubject(headers);
16
20
  return key === undefined || subject === undefined ? key : `${key}:subject:${subject}`;
17
21
  }