@rotorsoft/act 1.37.7 → 1.37.8

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 (35) hide show
  1. package/dist/.tsbuildinfo +1 -1
  2. package/dist/@types/adapters/in-memory-store.d.ts.map +1 -1
  3. package/dist/@types/internal/autoclose-reaction.d.ts +8 -0
  4. package/dist/@types/internal/autoclose-reaction.d.ts.map +1 -1
  5. package/dist/@types/internal/close-cycle.d.ts.map +1 -1
  6. package/dist/@types/internal/date-reviver.d.ts +6 -3
  7. package/dist/@types/internal/date-reviver.d.ts.map +1 -1
  8. package/dist/@types/internal/drain-ops.d.ts.map +1 -1
  9. package/dist/@types/internal/reaction-dispatch.d.ts +6 -0
  10. package/dist/@types/internal/reaction-dispatch.d.ts.map +1 -1
  11. package/dist/@types/types/ports.d.ts +5 -6
  12. package/dist/@types/types/ports.d.ts.map +1 -1
  13. package/dist/@types/utils.d.ts +18 -1
  14. package/dist/@types/utils.d.ts.map +1 -1
  15. package/dist/{chunk-PRDX3HP6.cjs → chunk-4UWU5FAN.cjs} +25 -24
  16. package/dist/chunk-4UWU5FAN.cjs.map +1 -0
  17. package/dist/{chunk-H6KVPVP4.cjs → chunk-BCA423WP.cjs} +1 -1
  18. package/dist/chunk-BCA423WP.cjs.map +1 -0
  19. package/dist/{chunk-V5ZB54DC.js → chunk-I5RF2NFR.js} +1 -1
  20. package/dist/chunk-I5RF2NFR.js.map +1 -0
  21. package/dist/{chunk-HXW3TPP6.js → chunk-TSDQDT4S.js} +13 -12
  22. package/dist/chunk-TSDQDT4S.js.map +1 -0
  23. package/dist/index.cjs +1654 -1608
  24. package/dist/index.cjs.map +1 -1
  25. package/dist/index.js +1261 -1215
  26. package/dist/index.js.map +1 -1
  27. package/dist/test/index.cjs +4 -4
  28. package/dist/test/index.js +2 -2
  29. package/dist/types/index.cjs +2 -2
  30. package/dist/types/index.js +1 -1
  31. package/package.json +1 -1
  32. package/dist/chunk-H6KVPVP4.cjs.map +0 -1
  33. package/dist/chunk-HXW3TPP6.js.map +0 -1
  34. package/dist/chunk-PRDX3HP6.cjs.map +0 -1
  35. package/dist/chunk-V5ZB54DC.js.map +0 -1
package/dist/index.js CHANGED
@@ -5,6 +5,7 @@ import {
5
5
  DEFAULT_EVENT_LIMIT,
6
6
  DEFAULT_LEASE_MILLIS,
7
7
  DEFAULT_MAX_RETRIES,
8
+ DEFAULT_QUERY_STREAMS_LIMIT,
8
9
  DEFAULT_STREAM_LIMIT,
9
10
  InMemoryCache,
10
11
  InMemoryStore,
@@ -20,6 +21,7 @@ import {
20
21
  dispose,
21
22
  disposeAndExit,
22
23
  extend,
24
+ fair_slots,
23
25
  is_literal_source,
24
26
  log,
25
27
  make_reaction_scope,
@@ -40,7 +42,7 @@ import {
40
42
  sleep,
41
43
  store,
42
44
  validate
43
- } from "./chunk-HXW3TPP6.js";
45
+ } from "./chunk-TSDQDT4S.js";
44
46
  import {
45
47
  ActorSchema,
46
48
  CausationEventSchema,
@@ -74,7 +76,7 @@ import {
74
76
  pii_fields,
75
77
  pii_schemas,
76
78
  sensitive
77
- } from "./chunk-V5ZB54DC.js";
79
+ } from "./chunk-I5RF2NFR.js";
78
80
 
79
81
  // src/signals.ts
80
82
  process.once("SIGINT", async (arg) => {
@@ -797,674 +799,303 @@ function classify_registry(registry, states) {
797
799
  };
798
800
  }
799
801
 
800
- // src/internal/close-cycle.ts
801
- var CLOSE_CATCH_UP_LIMIT = 1e3;
802
- var CLOSE_CATCH_UP_PASSES = 20;
803
- async function catch_up_correlation(cursor, correlate, until) {
804
- for (let pass = 0; pass < CLOSE_CATCH_UP_PASSES && cursor.checkpoint < until; pass++) {
805
- const before = cursor.checkpoint;
806
- cursor.arm();
807
- await correlate(CLOSE_CATCH_UP_LIMIT);
808
- if (cursor.checkpoint <= before) break;
809
- }
810
- return cursor.checkpoint;
802
+ // src/internal/autoclose-policy.ts
803
+ import { z } from "zod";
804
+ var DAY_MS = 864e5;
805
+ var MIN_AFTER_DAYS = 1 / 1440;
806
+ var MIN_KEEP_DAYS = 1;
807
+ function days_after(date, days) {
808
+ return new Date(date.getTime() + days * DAY_MS);
811
809
  }
812
- var CloseLock = class {
813
- _tails = /* @__PURE__ */ new Map();
814
- /** Run `work` after every earlier close of `stream` has settled. */
815
- run(stream, work) {
816
- const prev = this._tails.get(stream) ?? Promise.resolve();
817
- const next = prev.then(work, work);
818
- this._tails.set(stream, next);
819
- const cleanup = () => {
820
- if (this._tails.get(stream) === next) this._tails.delete(stream);
821
- };
822
- next.then(cleanup, cleanup);
823
- return next;
810
+ function days_before_now(days) {
811
+ return new Date(Date.now() - days * DAY_MS);
812
+ }
813
+ var window_schema = (field, min_days, floor) => z.object({
814
+ days: z.number({ message: `autocloses: ${field}.days must be a number` }).positive(`autocloses: ${field}.days must be > 0`)
815
+ }).refine((o) => o.days >= min_days, {
816
+ message: `autocloses: ${field} resolves to < ${floor}, which is too short to be a meaningful retention window`
817
+ });
818
+ var AfterSchema = window_schema("after", MIN_AFTER_DAYS, "one minute");
819
+ var KeepSchema = window_schema("keep", MIN_KEEP_DAYS, "one day");
820
+ var IsSchema = z.union([
821
+ z.string().min(1, "autocloses: is must be a non-empty event name"),
822
+ z.array(
823
+ z.string().min(1, "autocloses: is entries must be non-empty event names")
824
+ ).min(1, "autocloses: is must include at least one event name").readonly()
825
+ ]);
826
+ var ReachesSchema = z.number({ message: "autocloses: reaches must be a number" }).int("autocloses: reaches must be an integer").min(1, "autocloses: reaches must be >= 1");
827
+ var OrBlockSchema = z.object({
828
+ after: AfterSchema.optional(),
829
+ is: IsSchema.optional(),
830
+ reaches: ReachesSchema.optional()
831
+ }).strict().refine(
832
+ (o) => o.after !== void 0 || o.is !== void 0 || o.reaches !== void 0,
833
+ {
834
+ message: "autocloses: `or` block must include at least one of after / is / reaches"
824
835
  }
825
- };
826
- var SAFETY_PROBE_PAGE_SIZE = 1e3;
827
- async function run_close_cycle(targets, deps) {
828
- const target_map = new Map(targets.map((t) => [t.stream, t]));
829
- for (const t of target_map.values()) {
830
- if (t.before !== void 0 && t.restart)
831
- throw new Error(
832
- `close: \`before\` and \`restart\` are mutually exclusive (stream "${t.stream}") \u2014 a windowed close keeps the stream live behind a real snapshot; restart reseeds it`
833
- );
836
+ );
837
+ var AutoclosePolicySchema = z.object({
838
+ after: AfterSchema.optional(),
839
+ is: IsSchema.optional(),
840
+ reaches: ReachesSchema.optional(),
841
+ or: OrBlockSchema.optional(),
842
+ keep: KeepSchema.optional()
843
+ }).strict().refine(
844
+ (o) => o.after !== void 0 || o.is !== void 0 || o.reaches !== void 0 || o.or !== void 0 || o.keep !== void 0,
845
+ {
846
+ message: "autocloses: at least one of after / is / reaches / or / keep must be specified \u2014 empty `{}` is a misconfiguration"
834
847
  }
835
- const windowed = [...target_map.values()].filter(
836
- (t) => t.before !== void 0
837
- );
838
- const full = [...target_map.values()].filter((t) => t.before === void 0);
839
- const skipped = [];
840
- const windowed_result = windowed.length ? await run_windowed_closes(windowed, deps, skipped) : /* @__PURE__ */ new Map();
841
- if (!full.length) return { truncated: windowed_result, skipped };
842
- const truncated = await with_stream_locks(
843
- full.map((t) => t.stream),
844
- deps,
845
- () => run_full_closes(full, target_map, deps, skipped)
846
- );
847
- const retired = [...truncated.entries()].filter(([, r]) => r.committed.name === TOMBSTONE_EVENT).map(([stream]) => stream);
848
- if (retired.length) deps.forget_subscribed?.(retired);
849
- for (const [stream, entry] of windowed_result) truncated.set(stream, entry);
850
- return { truncated, skipped };
848
+ );
849
+ function compile_after(after) {
850
+ return (_stream, head) => days_after(head.created, after.days) <= /* @__PURE__ */ new Date();
851
851
  }
852
- function with_stream_locks(streams, deps, work) {
853
- const with_lock = deps.with_stream_lock ?? ((_stream, w) => w());
854
- return [...streams].sort().reduceRight(
855
- (inner, stream) => () => with_lock(stream, inner),
856
- work
857
- )();
852
+ function compile_is(is) {
853
+ const set = new Set(typeof is === "string" ? [is] : is);
854
+ return (_stream, head) => set.has(head.name);
858
855
  }
859
- async function run_full_closes(full, target_map, deps, skipped) {
860
- const none = /* @__PURE__ */ new Map();
861
- const streams = full.map((t) => t.stream);
862
- const stream_info = await scan_stream_heads(streams);
863
- for (const target of full) {
864
- if (!target.restart) continue;
865
- const info = stream_info.get(target.stream);
866
- if (!info) continue;
867
- const owner = deps.event_to_state.get(info.last_event_name);
868
- if (owner?.pii_aware) {
869
- deps.logger.error(
870
- `Refusing to close "${target.stream}" with restart: state "${owner.name}" carries sensitive fields, so a restart seed would persist redacted values while deleting the originals. Close it without restart to retire the stream, or leave it open.`
871
- );
872
- skipped.push(target.stream);
873
- stream_info.delete(target.stream);
874
- }
875
- }
876
- const safe = await partition_by_safety(
877
- stream_info,
878
- deps.reactive,
879
- skipped,
880
- deps.probe_page_size ?? SAFETY_PROBE_PAGE_SIZE,
881
- deps.catch_up_correlation
882
- );
883
- if (!safe.length) return none;
884
- const { guarded, guard_events } = await guard_with_tombstones(
885
- safe,
886
- stream_info,
887
- deps.correlation,
888
- deps.tombstone,
889
- skipped
890
- );
891
- if (!guarded.length) return none;
892
- const seed_states = await load_restart_seeds(
893
- guarded,
894
- target_map,
895
- stream_info,
896
- deps.event_to_state,
897
- deps.load,
898
- deps.logger
899
- );
900
- await run_archive_callbacks(guarded, target_map);
901
- const still_guarded = await heads_still_guarded(
902
- guarded,
903
- guard_events,
904
- skipped
905
- );
906
- if (!still_guarded.length) return none;
907
- return truncate_and_warm_cache(
908
- still_guarded,
909
- seed_states,
910
- guard_events,
911
- deps.correlation
912
- );
856
+ function compile_reaches(reaches) {
857
+ return (_stream, _head, count) => count >= reaches;
913
858
  }
914
- async function run_windowed_closes(windowed, deps, skipped) {
915
- const checkpoint = deps.reactive ? await deps.catch_up_correlation(Number.MAX_SAFE_INTEGER) : -1;
916
- const min_at = deps.reactive ? await probe_min_watermarks(
917
- windowed.map((t) => t.stream),
918
- deps.probe_page_size ?? SAFETY_PROBE_PAGE_SIZE,
919
- checkpoint
920
- ) : /* @__PURE__ */ new Map();
921
- const with_lock = deps.with_stream_lock ?? ((_stream, work) => work());
922
- const truncated = /* @__PURE__ */ new Map();
923
- for (const t of windowed) {
924
- const entry = await with_lock(t.stream, async () => {
925
- const max_id = min_at.get(t.stream);
926
- if (!await windowed_prune_pending(t.stream, t.before, max_id))
927
- return void 0;
928
- if (t.archive) await t.archive();
929
- const result = await store().truncate([
930
- { stream: t.stream, before: t.before, max_id }
931
- ]);
932
- return result.get(t.stream);
933
- });
934
- if (entry) truncated.set(t.stream, entry);
935
- else skipped.push(t.stream);
936
- }
937
- return truncated;
859
+ function policy_min_after_days(options) {
860
+ const parsed = AutoclosePolicySchema.parse(options);
861
+ const windows = [];
862
+ if (parsed.after) windows.push(parsed.after.days);
863
+ if (parsed.or?.after) windows.push(parsed.or.after.days);
864
+ return windows.length ? Math.min(...windows) : void 0;
938
865
  }
939
- async function windowed_prune_pending(stream, before, max_id) {
940
- let boundary_id;
941
- let min_id;
942
- await store().query(
943
- (event) => {
944
- if (min_id === void 0 || event.id < min_id) min_id = event.id;
945
- if (event.name === SNAP_EVENT && event.created < before && (max_id === void 0 || event.id <= max_id) && (boundary_id === void 0 || event.id > boundary_id))
946
- boundary_id = event.id;
947
- },
948
- { stream, stream_exact: true, with_snaps: true, after: -1 }
949
- );
950
- return boundary_id !== void 0 && min_id < boundary_id;
866
+ function policy_after_windows(options) {
867
+ const parsed = AutoclosePolicySchema.parse(options);
868
+ return [parsed.after, parsed.or?.after].flatMap((w) => w ? [w.days] : []);
951
869
  }
952
- async function probe_min_watermarks(streams, page_size, checkpoint) {
953
- const min_at = /* @__PURE__ */ new Map();
954
- const matches = source_matcher();
955
- await walk_streams(
956
- store(),
957
- (position) => {
958
- const pending = position.correlated_at === void 0 || position.at < position.correlated_at;
959
- const cap = pending ? position.at : Math.max(position.at, checkpoint);
960
- for (const stream of streams) {
961
- if (matches(position.source, stream)) {
962
- const prev = min_at.get(stream);
963
- if (prev === void 0 || cap < prev) min_at.set(stream, cap);
964
- }
965
- }
966
- },
967
- { limit: page_size, source_matches: streams }
968
- );
969
- return min_at;
870
+ function policy_keep_days(options) {
871
+ const parsed = AutoclosePolicySchema.parse(options);
872
+ return parsed.keep?.days;
970
873
  }
971
- function source_matcher() {
972
- const compiled = /* @__PURE__ */ new Map();
973
- return (source, stream) => {
974
- if (!source) return true;
975
- let re = compiled.get(source);
976
- if (!re) {
977
- re = new RegExp(source);
978
- compiled.set(source, re);
874
+ function compile_autoclose_policy(options) {
875
+ const parsed = AutoclosePolicySchema.parse(options);
876
+ const and_preds = [];
877
+ if (parsed.after) and_preds.push(compile_after(parsed.after));
878
+ if (parsed.is) and_preds.push(compile_is(parsed.is));
879
+ if (parsed.reaches) and_preds.push(compile_reaches(parsed.reaches));
880
+ const or_preds = [];
881
+ if (parsed.or) {
882
+ if (parsed.or.after) or_preds.push(compile_after(parsed.or.after));
883
+ if (parsed.or.is) or_preds.push(compile_is(parsed.or.is));
884
+ if (parsed.or.reaches) or_preds.push(compile_reaches(parsed.or.reaches));
885
+ }
886
+ return (stream, head, count) => {
887
+ if (and_preds.length > 0 && and_preds.every((p) => p(stream, head, count))) {
888
+ return true;
979
889
  }
980
- return re.test(stream);
890
+ if (or_preds.some((p) => p(stream, head, count))) {
891
+ return true;
892
+ }
893
+ return false;
981
894
  };
982
895
  }
983
- async function scan_stream_heads(streams) {
984
- const stats = await store().query_stats(streams, {
985
- exclude: [SNAP_EVENT]
986
- });
987
- const domain_heads = await store().query_stats(streams, {
988
- exclude: [SNAP_EVENT, TOMBSTONE_EVENT]
989
- });
990
- const true_heads = await store().query_stats(streams, {});
991
- const out = /* @__PURE__ */ new Map();
992
- for (const [stream, { head }] of domain_heads) {
993
- const marker_head = stats.get(stream)?.head;
994
- const interrupted = marker_head?.name === TOMBSTONE_EVENT;
995
- out.set(stream, {
996
- max_id: head.id,
997
- version: true_heads.get(stream).head.version,
998
- last_event_name: head.name,
999
- ...interrupted ? { resumed_guard: { id: marker_head.id } } : {}
1000
- });
1001
- }
1002
- return out;
896
+
897
+ // src/internal/autoclose-window.ts
898
+ function hour_in_zone(now, timeZone) {
899
+ const parts = new Intl.DateTimeFormat("en-US", {
900
+ timeZone,
901
+ hour: "2-digit",
902
+ hourCycle: "h23"
903
+ }).formatToParts(now);
904
+ return Number(parts.find((p) => p.type === "hour")?.value);
1003
905
  }
1004
- async function partition_by_safety(stream_info, reactive, skipped, page_size, catch_up_correlation2) {
1005
- if (!reactive) return [...stream_info.keys()];
1006
- let needed = -1;
1007
- for (const info of stream_info.values())
1008
- needed = Math.max(needed, info.max_id);
1009
- const checkpoint = await catch_up_correlation2(needed);
1010
- const uncorrelated = /* @__PURE__ */ new Set();
1011
- for (const [stream, info] of stream_info) {
1012
- if (checkpoint < info.max_id) uncorrelated.add(stream);
1013
- }
1014
- const pending_set = /* @__PURE__ */ new Set();
1015
- const matches = source_matcher();
1016
- const targets = [...stream_info.keys()];
1017
- await walk_streams(
1018
- store(),
1019
- (position) => {
1020
- const has_work = position.correlated_at !== void 0 && position.at < position.correlated_at;
1021
- if (!has_work) return;
1022
- for (const [stream, info] of stream_info) {
1023
- if (matches(position.source, stream) && position.at < info.max_id)
1024
- pending_set.add(stream);
1025
- }
1026
- },
1027
- { limit: page_size, source_matches: targets }
1028
- );
1029
- const safe = [];
1030
- for (const [stream] of stream_info) {
1031
- if (pending_set.has(stream) || uncorrelated.has(stream))
1032
- skipped.push(stream);
1033
- else safe.push(stream);
1034
- }
1035
- return safe;
906
+ function hour_in_range(hour, start, end) {
907
+ return start < end ? hour >= start && hour < end : hour >= start || hour < end;
1036
908
  }
1037
- async function guard_with_tombstones(safe, stream_info, correlation, tombstone2, skipped) {
1038
- const guarded = [];
1039
- const guard_events = /* @__PURE__ */ new Map();
1040
- await Promise.all(
1041
- safe.map(async (stream) => {
1042
- const info = stream_info.get(stream);
1043
- if (info.resumed_guard) {
1044
- guarded.push(stream);
1045
- guard_events.set(stream, { id: info.resumed_guard.id, stream });
1046
- return;
1047
- }
1048
- const committed = await tombstone2(stream, info.version, correlation);
1049
- if (committed) {
1050
- guarded.push(stream);
1051
- guard_events.set(stream, { id: committed.id, stream });
1052
- } else {
1053
- skipped.push(stream);
1054
- }
1055
- })
1056
- );
1057
- return { guarded, guard_events };
909
+ function is_dst_gap_open(now, timeZone, start) {
910
+ const hour = hour_in_zone(now, timeZone);
911
+ if (hour <= start) return false;
912
+ const prev = hour_in_zone(new Date(now.getTime() - 36e5), timeZone);
913
+ return prev === start - 1 && hour === start + 1;
1058
914
  }
1059
- async function load_restart_seeds(guarded, target_map, stream_info, event_to_state, load2, logger) {
1060
- const seed_states = /* @__PURE__ */ new Map();
1061
- await Promise.all(
1062
- guarded.filter((s) => target_map.get(s)?.restart).map(async (stream) => {
1063
- const last_event_name = stream_info.get(stream).last_event_name;
1064
- const owner_state = event_to_state.get(last_event_name);
1065
- if (!owner_state) {
1066
- logger.error(
1067
- `Cannot seed restart for "${stream}": no registered state owns event "${last_event_name}". Stream will be tombstoned instead.`
1068
- );
1069
- return;
1070
- }
1071
- const snap2 = await load2(owner_state, { stream });
1072
- seed_states.set(stream, snap2.state);
1073
- })
1074
- );
1075
- return seed_states;
915
+ function in_autoclose_window(window, now) {
916
+ if (!window) return true;
917
+ const hour = hour_in_zone(now, window.timeZone);
918
+ return hour_in_range(hour, window.start, window.end) || is_dst_gap_open(now, window.timeZone, window.start);
1076
919
  }
1077
- async function run_archive_callbacks(guarded, target_map) {
1078
- for (const stream of guarded) {
1079
- const archive_fn = target_map.get(stream)?.archive;
1080
- if (archive_fn) await archive_fn();
920
+ function next_window_open(window, now) {
921
+ const start_ms = now.getTime();
922
+ for (let h = 0; h <= 48; h++) {
923
+ const candidate = new Date(start_ms + h * 36e5);
924
+ if (hour_in_zone(candidate, window.timeZone) === window.start)
925
+ return candidate;
926
+ const boundary = new Date(
927
+ candidate.getTime() - candidate.getTime() % 36e5
928
+ );
929
+ if (boundary.getTime() >= start_ms && is_dst_gap_open(boundary, window.timeZone, window.start))
930
+ return boundary;
1081
931
  }
932
+ return new Date(start_ms + 864e5);
1082
933
  }
1083
- async function heads_still_guarded(guarded, guard_events, skipped) {
1084
- const heads = await store().query_stats(guarded, {});
1085
- return guarded.filter((stream) => {
1086
- if (heads.get(stream)?.head.id === guard_events.get(stream).id)
1087
- return true;
1088
- skipped.push(stream);
1089
- return false;
1090
- });
934
+
935
+ // src/internal/defer-config.ts
936
+ import { z as z2 } from "zod";
937
+ var DeferDurationSchema = z2.object({
938
+ days: z2.number().positive().optional(),
939
+ hours: z2.number().positive().optional(),
940
+ minutes: z2.number().positive().optional()
941
+ }).strict().refine((d) => d.days != null || d.hours != null || d.minutes != null, {
942
+ message: "defer: a duration needs at least one of days, hours, or minutes"
943
+ });
944
+ var DeferWhenSchema = z2.object({
945
+ after: DeferDurationSchema.optional(),
946
+ at: z2.date().optional()
947
+ }).strict().refine((w) => w.after === void 0 !== (w.at === void 0), {
948
+ message: "defer: specify exactly one of `after` or `at`"
949
+ });
950
+ function duration_ms(d) {
951
+ return (d.days ?? 0) * 864e5 + (d.hours ?? 0) * 36e5 + (d.minutes ?? 0) * 6e4;
1091
952
  }
1092
- async function truncate_and_warm_cache(guarded, seed_states, guard_events, correlation) {
1093
- const trunc_targets = guarded.map((stream) => {
1094
- const snapshot = seed_states.get(stream);
1095
- const guard = guard_events.get(stream);
1096
- return {
1097
- stream,
1098
- snapshot,
1099
- meta: {
1100
- correlation,
1101
- causation: {
1102
- event: { id: guard.id, name: TOMBSTONE_EVENT, stream: guard.stream }
1103
- }
1104
- }
1105
- };
1106
- });
1107
- const truncated = await store().truncate(trunc_targets);
1108
- await Promise.all(
1109
- guarded.map(async (stream) => {
1110
- const entry = truncated.get(stream);
1111
- const state2 = seed_states.get(stream);
1112
- if (state2 && entry) {
1113
- await cache().set(stream, {
1114
- stream,
1115
- state: state2,
1116
- version: entry.committed.version,
1117
- event_id: entry.committed.id,
1118
- patches: 0,
1119
- snaps: 1
1120
- });
1121
- } else {
1122
- await cache().invalidate(stream);
1123
- }
1124
- })
1125
- );
1126
- return truncated;
953
+ function resolve_defer_at(when, event) {
954
+ const parsed = DeferWhenSchema.parse(when);
955
+ if (parsed.after) return event.created.getTime() + duration_ms(parsed.after);
956
+ return parsed.at.getTime();
957
+ }
958
+ function assert_defer_when(when) {
959
+ DeferWhenSchema.parse(when);
960
+ }
961
+ function make_deferred(handler, schedule) {
962
+ const call = handler;
963
+ const deferred = async (event, stream, app) => {
964
+ const when = typeof schedule === "function" ? schedule(event) : schedule;
965
+ if (Date.now() < resolve_defer_at(when, event)) throw new DeferSignal(when);
966
+ return call(event, stream, app);
967
+ };
968
+ Object.defineProperty(deferred, "name", { value: handler.name });
969
+ return deferred;
1127
970
  }
1128
971
 
1129
- // src/internal/correlate-cycle.ts
1130
- import { createHash, randomUUID } from "crypto";
972
+ // src/internal/drain-cycle.ts
973
+ import { randomUUID } from "crypto";
1131
974
 
1132
- // src/internal/report-once.ts
1133
- function report_once(seen, key, message) {
1134
- if (seen.has(key)) return;
1135
- seen.add(key);
1136
- log().error(new Error(message));
975
+ // src/internal/backoff.ts
976
+ function compute_backoff_delay(retry, opts) {
977
+ if (!opts || opts.baseMs <= 0) return 0;
978
+ const r = Math.max(0, retry);
979
+ let delay;
980
+ switch (opts.strategy) {
981
+ case "fixed":
982
+ delay = opts.baseMs;
983
+ break;
984
+ case "linear":
985
+ delay = opts.baseMs * (r + 1);
986
+ break;
987
+ case "exponential":
988
+ delay = opts.baseMs * 2 ** r;
989
+ if (opts.maxMs !== void 0) delay = Math.min(delay, opts.maxMs);
990
+ break;
991
+ default: {
992
+ const _never = opts.strategy;
993
+ throw new Error(`unknown backoff strategy: ${String(_never)}`);
994
+ }
995
+ }
996
+ if (opts.jitter) delay = delay * (0.5 + Math.random());
997
+ return Math.max(0, Math.floor(delay));
1137
998
  }
1138
999
 
1139
- // src/internal/correlate-cycle.ts
1140
- var COLD_START_BACK_SCAN = 1e4;
1141
- var CORRELATION_LEASE_MS = 5e3;
1142
- var registry_key = (events) => {
1143
- const shape = Object.keys(events).filter((name) => events[name].reactions.size > 0).sort().map((name) => [name, [...events[name].reactions.keys()].sort()]);
1144
- return createHash("sha256").update(JSON.stringify(shape)).digest("hex").slice(0, 32);
1145
- };
1146
- var PATTERN_CACHE_SIZE = 32;
1147
- function report_undeclared_lane(seen, handler, target, lane, declared) {
1148
- report_once(
1149
- seen,
1150
- `lane|${handler}|${lane}`,
1151
- `Reaction "${handler}" resolved onto undeclared lane "${lane}" \u2014 for example target "${target}". Declared lanes: ${[...declared].map((l) => `"${l}"`).join(", ")}. No controller claims it, so the stream would never drain \u2014 running it on "default" instead. The equivalent static \`.to({ lane })\` is rejected at build; a dynamic resolver's lane is only knowable here.`
1152
- );
1153
- }
1154
- function report_lane_conflict(seen, handler, target, kept, dropped) {
1155
- report_once(
1156
- seen,
1157
- `conflict|${handler}|${kept}|${dropped}`,
1158
- `Reaction "${handler}" resolved lane "${dropped}" for a stream already on "${kept}" \u2014 for example "${target}". These are conflicting lane assignments from two dynamic resolutions at equal priority. Keeping "${kept}", the lane it was first discovered on \u2014 re-laning a live stream would move it out from under a worker holding its lease. The reaction resolving "${dropped}" runs inside the "${kept}" lane's budget, and a process restricted to "${dropped}" via onlyLanes never runs it. The equivalent static declaration is rejected at build; align the resolvers, or split the target.`
1159
- );
1160
- }
1161
- var CorrelateCycle = class {
1162
- _checkpoint = -1;
1163
- // Lease holder id; per instance, so a restart never inherits a stale claim.
1164
- _by = randomUUID();
1165
- _key;
1166
- // Local expiry of the held lease (0 = none); stale only costs a duplicate scan.
1167
- _lease_until = 0;
1168
- // Armed while `_raised` (bumped by a commit or notification) is ahead of
1169
- // `_lowered` (the raise count the last short page saw). Starts armed.
1170
- _raised = 1;
1171
- _lowered = 0;
1172
- // Bumped by a release (shutdown), so a scan or lease reply that was out
1173
- // across one writes nothing.
1174
- _epoch = 0;
1175
- // Passes in flight: a restore waits for them, and refuses new ones.
1176
- _passes = /* @__PURE__ */ new Set();
1177
- _restoring = false;
1178
- _init_promise;
1179
- // Bounded by `maxSubscribedStreams`; static records live apart so eviction
1180
- // never lets a resolution re-lane them.
1181
- _dynamic_subscriptions;
1182
- _static_subscriptions = /* @__PURE__ */ new Map();
1183
- _patterns = new LruMap(PATTERN_CACHE_SIZE);
1184
- _registry;
1185
- _static_targets;
1186
- _cd;
1187
- _on_init;
1188
- _declared_lanes;
1189
- // Report-once keys; per instance because `internal/` holds no module state.
1190
- _reported = /* @__PURE__ */ new Set();
1191
- constructor({
1192
- registry,
1193
- static_targets,
1194
- cd,
1195
- max_subscribed_streams,
1196
- declared_lanes,
1197
- shard,
1198
- on_init
1199
- }) {
1200
- this._key = shard ? `${registry_key(registry.events)}:${[...shard].sort().join(",")}` : registry_key(registry.events);
1201
- this._dynamic_subscriptions = new LruMap(max_subscribed_streams);
1202
- this._registry = registry;
1203
- this._declared_lanes = declared_lanes;
1204
- this._static_targets = static_targets;
1205
- this._cd = cd;
1206
- this._on_init = on_init;
1000
+ // src/internal/defer-timer.ts
1001
+ var MAX_TIMER_DELAY_MS = 2147483647;
1002
+ var DeferTimer = class {
1003
+ _due = /* @__PURE__ */ new Map();
1004
+ _timer;
1005
+ _on_wake;
1006
+ /**
1007
+ * @param on_wake - invoked once each time the earliest due-time elapses.
1008
+ * The consumer re-schedules for whatever is still parked.
1009
+ */
1010
+ constructor(on_wake) {
1011
+ this._on_wake = on_wake;
1207
1012
  }
1208
- get checkpoint() {
1209
- return this._checkpoint;
1013
+ /** Number of currently parked streams. */
1014
+ get size() {
1015
+ return this._due.size;
1210
1016
  }
1211
- /** A commit (local or remote) may have produced uncorrelated events. */
1212
- arm() {
1213
- this._raised++;
1017
+ /**
1018
+ * Park `stream` for a re-visit at `at` (ms since epoch). A plain
1019
+ * overwrite: the caller computes the authoritative next-visit for the
1020
+ * stream (the drain's `handle` already reconciles a stream's reactions
1021
+ * into one result per cycle), so there is no stale value to merge against.
1022
+ */
1023
+ set(stream, at) {
1024
+ this._due.set(stream, at);
1214
1025
  }
1215
- async _init() {
1216
- this._init_promise ??= this._run_init().catch((error) => {
1217
- this._init_promise = void 0;
1218
- throw error;
1219
- });
1220
- await this._init_promise;
1026
+ /** Drop `stream` from the parked set (e.g. on a successful ack or block). */
1027
+ delete(stream) {
1028
+ this._due.delete(stream);
1221
1029
  }
1222
- async _run_init() {
1223
- const { watermark, correlated_at } = await this._cd.subscribe([
1224
- ...this._static_targets
1225
- ]);
1226
- this._checkpoint = correlated_at >= 0 ? correlated_at : Math.max(-1, watermark - COLD_START_BACK_SCAN);
1227
- for (const { stream, priority = 0, lane } of this._static_targets) {
1228
- this._static_subscriptions.set(stream, {
1229
- priority,
1230
- lane
1231
- });
1232
- }
1233
- await this._on_init?.();
1030
+ /**
1031
+ * Drop every entry due at or before `before`. The drain calls it when a
1032
+ * pass that started at `before` claimed nothing: whatever was due by then
1033
+ * was handled elsewhere (another worker) or has no work left, so waking
1034
+ * for it again would spin.
1035
+ */
1036
+ prune(before) {
1037
+ for (const [stream, at] of this._due)
1038
+ if (at <= before) this._due.delete(stream);
1234
1039
  }
1235
1040
  /**
1236
- * Replace the log with no pass in flight, then cold-start: a pass that
1237
- * read the old log writes before the restore, never into the new one.
1041
+ * (Re)schedule the wake timer at the earliest pending due-time. Idempotent
1042
+ * — collapses many parked streams into a single timer. A no-op clears any
1043
+ * pending timer when the map is empty.
1044
+ *
1045
+ * The timer is `unref()`-ed so pending re-visits never keep the process
1046
+ * alive on their own.
1238
1047
  */
1239
- async restart(restore) {
1240
- this._restoring = true;
1241
- try {
1242
- await Promise.allSettled(this._passes);
1243
- await restore();
1244
- } finally {
1245
- this._restoring = false;
1048
+ schedule() {
1049
+ if (this._timer) clearTimeout(this._timer);
1050
+ if (this._due.size === 0) {
1051
+ this._timer = void 0;
1052
+ return;
1246
1053
  }
1247
- this._init_promise = void 0;
1248
- this._checkpoint = -1;
1249
- this._dynamic_subscriptions.clear();
1250
- this._static_subscriptions.clear();
1251
- }
1252
- /** Forget dynamic targets whose rows a full close deleted, so they re-subscribe. */
1253
- forget_subscribed(streams) {
1254
- for (const stream of streams) this._dynamic_subscriptions.delete(stream);
1054
+ let earliest = Number.POSITIVE_INFINITY;
1055
+ for (const t of this._due.values()) if (t < earliest) earliest = t;
1056
+ const delay = Math.min(
1057
+ Math.max(0, earliest - Date.now()),
1058
+ MAX_TIMER_DELAY_MS
1059
+ );
1060
+ this._timer = setTimeout(() => {
1061
+ this._timer = void 0;
1062
+ this._on_wake();
1063
+ }, delay);
1064
+ this._timer.unref();
1255
1065
  }
1256
- // Would the target's own `fetch` (filtered by `source`) return this event?
1257
- _in_fetch_window(source, stream) {
1258
- if (source === void 0 || source === stream) return true;
1259
- if (is_literal_source(source)) return false;
1260
- let pattern = this._patterns.get(source);
1261
- if (!pattern) {
1262
- pattern = new RegExp(source);
1263
- this._patterns.set(source, pattern);
1066
+ /** Cancel any pending wake timer. Idempotent. Leaves the parked set intact. */
1067
+ stop() {
1068
+ if (this._timer) {
1069
+ clearTimeout(this._timer);
1070
+ this._timer = void 0;
1264
1071
  }
1265
- return pattern.test(stream);
1266
1072
  }
1267
- /** Scan past the checkpoint, subscribe new targets and raise their work marks. */
1268
- async correlate(limit, lease = false) {
1269
- if (this._restoring) return { kind: "idle", last_id: this._checkpoint };
1270
- const pass = this._scan(limit, lease);
1271
- this._passes.add(pass);
1272
- try {
1273
- return await pass;
1274
- } finally {
1275
- this._passes.delete(pass);
1276
- }
1073
+ };
1074
+
1075
+ // src/internal/drain-ratio.ts
1076
+ var RATIO_MIN = 0.2;
1077
+ var RATIO_MAX = 0.8;
1078
+ var RATIO_DEFAULT = 0.5;
1079
+ function compute_lag_lead_ratio(handled, lagging, leading) {
1080
+ let lagging_handled = 0;
1081
+ let leading_handled = 0;
1082
+ for (const { lease, handled: count } of handled) {
1083
+ if (lease.lagging) lagging_handled += count;
1084
+ else leading_handled += count;
1277
1085
  }
1278
- async _scan(limit, lease) {
1279
- await this._init();
1280
- const epoch = this._epoch;
1281
- const idle = () => ({
1282
- kind: "idle",
1283
- last_id: this._checkpoint
1284
- });
1285
- if (this._raised === this._lowered) return idle();
1286
- const raised = this._raised;
1287
- const now = Date.now();
1288
- if (lease && now >= this._lease_until - CORRELATION_LEASE_MS / 2) {
1289
- const { correlating } = await this._cd.subscribe([], void 0, {
1290
- key: this._key,
1291
- by: this._by,
1292
- millis: CORRELATION_LEASE_MS
1293
- });
1294
- if (this._epoch !== epoch) return idle();
1295
- this._lease_until = correlating ? now + CORRELATION_LEASE_MS : 0;
1296
- if (correlating === false) return idle();
1297
- }
1298
- const after = this._checkpoint;
1299
- const correlated = /* @__PURE__ */ new Map();
1300
- let last_id = after;
1301
- let stopped = false;
1302
- const found = await store().query(
1303
- (event) => {
1304
- if (stopped) return;
1305
- const register = this._registry.events[event.name];
1306
- if (register) {
1307
- for (const reaction of register.reactions.values()) {
1308
- let resolved;
1309
- try {
1310
- resolved = typeof reaction.resolver === "function" ? reaction.resolver(event) : reaction.resolver;
1311
- } catch (error) {
1312
- stopped = true;
1313
- report_once(
1314
- this._reported,
1315
- `resolver|${reaction.handler.name}|${event.id}`,
1316
- `Resolver of reaction "${reaction.handler.name}" threw on ${String(event.name)} #${event.id} (stream "${event.stream}"): ${String(error)}. Correlation stops before this event until the resolver stops throwing; work already found keeps draining.`
1317
- );
1318
- return;
1319
- }
1320
- if (!resolved) continue;
1321
- let lane = resolved.lane;
1322
- if (lane !== void 0 && !this._declared_lanes.has(lane)) {
1323
- report_undeclared_lane(
1324
- this._reported,
1325
- reaction.handler.name,
1326
- resolved.target,
1327
- lane,
1328
- this._declared_lanes
1329
- );
1330
- lane = void 0;
1331
- }
1332
- const fixed = this._static_subscriptions.get(resolved.target);
1333
- const recorded = fixed ?? this._dynamic_subscriptions.get(resolved.target);
1334
- const priority = resolved.priority ?? 0;
1335
- const upgraded = !recorded || !fixed && priority > recorded.priority;
1336
- const carried = upgraded ? { priority, lane } : { priority: recorded.priority, lane: recorded.lane };
1337
- const entry = correlated.get(resolved.target) || {
1338
- source: resolved.source,
1339
- priority: carried.priority,
1340
- lane: carried.lane,
1341
- upgraded,
1342
- missed: !recorded,
1343
- handler: reaction.handler.name,
1344
- correlated_at: void 0
1345
- };
1346
- const seen_in_scan = correlated.has(resolved.target);
1347
- const held_lane = (seen_in_scan ? entry.lane : recorded?.lane) ?? DEFAULT_LANE;
1348
- const held_priority = seen_in_scan ? entry.priority : recorded?.priority;
1349
- const resolved_lane = lane ?? DEFAULT_LANE;
1350
- if (held_priority === priority && held_lane !== resolved_lane)
1351
- report_lane_conflict(
1352
- this._reported,
1353
- reaction.handler.name,
1354
- resolved.target,
1355
- held_lane,
1356
- resolved_lane
1357
- );
1358
- if (carried.priority > entry.priority) {
1359
- entry.priority = carried.priority;
1360
- entry.lane = carried.lane;
1361
- entry.upgraded = upgraded;
1362
- entry.handler = reaction.handler.name;
1363
- }
1364
- if (this._in_fetch_window(resolved.source, event.stream))
1365
- entry.correlated_at = event.id;
1366
- correlated.set(resolved.target, entry);
1367
- }
1368
- }
1369
- last_id = event.id;
1370
- },
1371
- // Resolvers see `pii: null`: correlate runs actor-less, and one
1372
- // undecryptable row would otherwise stop every stream's reactions.
1373
- { after, limit, with_pii: false }
1374
- );
1375
- if (this._declared_lanes.size > 1) await this._recall(correlated);
1376
- const read = last_id > after;
1377
- if (this._epoch !== epoch) return idle();
1378
- const streams = [];
1379
- for (const [stream, entry] of correlated) {
1380
- if (entry.upgraded || entry.correlated_at !== void 0)
1381
- streams.push({
1382
- stream,
1383
- source: entry.source,
1384
- priority: entry.priority,
1385
- lane: entry.lane,
1386
- correlated_at: entry.correlated_at
1387
- });
1388
- }
1389
- if (streams.length) {
1390
- const renewed_at = Date.now();
1391
- const { subscribed, correlating } = await this._cd.subscribe(
1392
- streams,
1393
- last_id,
1394
- lease ? { key: this._key, by: this._by, millis: CORRELATION_LEASE_MS } : void 0
1395
- );
1396
- if (lease && correlating !== false)
1397
- this._lease_until = renewed_at + CORRELATION_LEASE_MS;
1398
- const marked = streams.filter(
1399
- (entry) => entry.correlated_at !== void 0
1400
- ).length;
1401
- this._checkpoint = last_id;
1402
- for (const { stream, priority, lane } of streams) {
1403
- if (correlated.get(stream)?.upgraded)
1404
- this._dynamic_subscriptions.set(stream, {
1405
- priority,
1406
- lane
1407
- });
1408
- }
1409
- return { kind: "scanned", last_id, subscribed, marked, read };
1410
- }
1411
- this._checkpoint = last_id;
1412
- if (!stopped && found !== limit) this._lowered = raised;
1413
- return { kind: "scanned", last_id, subscribed: 0, marked: 0, read };
1414
- }
1415
- // Read the row of each target this scan had no record of (new or evicted),
1416
- // so a resolution that doesn't beat its priority keeps the row's lane.
1417
- // Only called with more than one lane declared.
1418
- async _recall(correlated) {
1419
- const missed = [...correlated].filter(([, entry]) => entry.missed);
1420
- await Promise.all(
1421
- missed.map(async ([stream, entry]) => {
1422
- let row;
1423
- await store().query_streams(
1424
- (position) => {
1425
- row = position;
1426
- },
1427
- { stream, stream_exact: true, limit: 1 }
1428
- );
1429
- if (!row) return;
1430
- this._dynamic_subscriptions.set(stream, {
1431
- priority: row.priority,
1432
- lane: row.lane
1433
- });
1434
- if (entry.priority > row.priority) return;
1435
- const held_lane = row.lane ?? DEFAULT_LANE;
1436
- const resolved_lane = entry.lane ?? DEFAULT_LANE;
1437
- if (entry.priority === row.priority && held_lane !== resolved_lane)
1438
- report_lane_conflict(
1439
- this._reported,
1440
- entry.handler,
1441
- stream,
1442
- held_lane,
1443
- resolved_lane
1444
- );
1445
- entry.priority = row.priority;
1446
- entry.lane = row.lane;
1447
- entry.upgraded = false;
1448
- })
1449
- );
1450
- }
1451
- /** Release the lease early by re-acquiring it for zero ms. Best-effort. */
1452
- async release_correlation() {
1453
- try {
1454
- this._lease_until = 0;
1455
- this._epoch++;
1456
- await this._cd.subscribe([], void 0, {
1457
- key: this._key,
1458
- by: this._by,
1459
- millis: 0
1460
- });
1461
- } catch (error) {
1462
- log().warn(
1463
- `Could not hand back the correlation lease during shutdown; it expires on its own within ${CORRELATION_LEASE_MS}ms and correlation resumes normally after that. On a single-writer store this usually means another connection holds the database. Cause: ${String(error.cause ?? error)}`
1464
- );
1465
- }
1466
- }
1467
- };
1086
+ const lagging_avg = lagging > 0 ? lagging_handled / lagging : 0;
1087
+ const leading_avg = leading > 0 ? leading_handled / leading : 0;
1088
+ const total = lagging_avg + leading_avg;
1089
+ if (total === 0) return RATIO_DEFAULT;
1090
+ return Math.max(RATIO_MIN, Math.min(RATIO_MAX, lagging_avg / total));
1091
+ }
1092
+
1093
+ // src/internal/report-once.ts
1094
+ function report_once(seen, key, message) {
1095
+ if (seen.has(key)) return;
1096
+ seen.add(key);
1097
+ log().error(new Error(message));
1098
+ }
1468
1099
 
1469
1100
  // src/internal/correlation-id.ts
1470
1101
  import { randomInt } from "crypto";
@@ -1490,134 +1121,13 @@ function close_correlation(correlator, actor) {
1490
1121
  });
1491
1122
  }
1492
1123
 
1493
- // src/internal/drain-cycle.ts
1494
- import { randomUUID as randomUUID2 } from "crypto";
1495
-
1496
- // src/internal/backoff.ts
1497
- function compute_backoff_delay(retry, opts) {
1498
- if (!opts || opts.baseMs <= 0) return 0;
1499
- const r = Math.max(0, retry);
1500
- let delay;
1501
- switch (opts.strategy) {
1502
- case "fixed":
1503
- delay = opts.baseMs;
1504
- break;
1505
- case "linear":
1506
- delay = opts.baseMs * (r + 1);
1507
- break;
1508
- case "exponential":
1509
- delay = opts.baseMs * 2 ** r;
1510
- if (opts.maxMs !== void 0) delay = Math.min(delay, opts.maxMs);
1511
- break;
1512
- default: {
1513
- const _never = opts.strategy;
1514
- throw new Error(`unknown backoff strategy: ${String(_never)}`);
1515
- }
1516
- }
1517
- if (opts.jitter) delay = delay * (0.5 + Math.random());
1518
- return Math.max(0, Math.floor(delay));
1519
- }
1520
-
1521
- // src/internal/defer-timer.ts
1522
- var MAX_TIMER_DELAY_MS = 2147483647;
1523
- var DeferTimer = class {
1524
- _due = /* @__PURE__ */ new Map();
1525
- _timer;
1526
- _on_wake;
1527
- /**
1528
- * @param on_wake - invoked once each time the earliest due-time elapses.
1529
- * The consumer re-schedules for whatever is still parked.
1530
- */
1531
- constructor(on_wake) {
1532
- this._on_wake = on_wake;
1533
- }
1534
- /** Number of currently parked streams. */
1535
- get size() {
1536
- return this._due.size;
1537
- }
1538
- /**
1539
- * Park `stream` for a re-visit at `at` (ms since epoch). A plain
1540
- * overwrite: the caller computes the authoritative next-visit for the
1541
- * stream (the drain's `handle` already reconciles a stream's reactions
1542
- * into one result per cycle), so there is no stale value to merge against.
1543
- */
1544
- set(stream, at) {
1545
- this._due.set(stream, at);
1546
- }
1547
- /** Drop `stream` from the parked set (e.g. on a successful ack or block). */
1548
- delete(stream) {
1549
- this._due.delete(stream);
1550
- }
1551
- /**
1552
- * Drop every entry due at or before `before`. The drain calls it when a
1553
- * pass that started at `before` claimed nothing: whatever was due by then
1554
- * was handled elsewhere (another worker) or has no work left, so waking
1555
- * for it again would spin.
1556
- */
1557
- prune(before) {
1558
- for (const [stream, at] of this._due)
1559
- if (at <= before) this._due.delete(stream);
1560
- }
1561
- /**
1562
- * (Re)schedule the wake timer at the earliest pending due-time. Idempotent
1563
- * — collapses many parked streams into a single timer. A no-op clears any
1564
- * pending timer when the map is empty.
1565
- *
1566
- * The timer is `unref()`-ed so pending re-visits never keep the process
1567
- * alive on their own.
1568
- */
1569
- schedule() {
1570
- if (this._timer) clearTimeout(this._timer);
1571
- if (this._due.size === 0) {
1572
- this._timer = void 0;
1573
- return;
1574
- }
1575
- let earliest = Number.POSITIVE_INFINITY;
1576
- for (const t of this._due.values()) if (t < earliest) earliest = t;
1577
- const delay = Math.min(
1578
- Math.max(0, earliest - Date.now()),
1579
- MAX_TIMER_DELAY_MS
1580
- );
1581
- this._timer = setTimeout(() => {
1582
- this._timer = void 0;
1583
- this._on_wake();
1584
- }, delay);
1585
- this._timer.unref();
1586
- }
1587
- /** Cancel any pending wake timer. Idempotent. Leaves the parked set intact. */
1588
- stop() {
1589
- if (this._timer) {
1590
- clearTimeout(this._timer);
1591
- this._timer = void 0;
1592
- }
1593
- }
1594
- };
1595
-
1596
- // src/internal/drain-ratio.ts
1597
- var RATIO_MIN = 0.2;
1598
- var RATIO_MAX = 0.8;
1599
- var RATIO_DEFAULT = 0.5;
1600
- function compute_lag_lead_ratio(handled, lagging, leading) {
1601
- let lagging_handled = 0;
1602
- let leading_handled = 0;
1603
- for (const { lease, handled: count } of handled) {
1604
- if (lease.lagging) lagging_handled += count;
1605
- else leading_handled += count;
1606
- }
1607
- const lagging_avg = lagging > 0 ? lagging_handled / lagging : 0;
1608
- const leading_avg = leading > 0 ? leading_handled / leading : 0;
1609
- const total = lagging_avg + leading_avg;
1610
- if (total === 0) return RATIO_DEFAULT;
1611
- return Math.max(RATIO_MIN, Math.min(RATIO_MAX, lagging_avg / total));
1612
- }
1613
-
1614
1124
  // src/internal/drain-ops.ts
1615
1125
  var claim = (lagging, leading, by, millis, lane) => store().claim(lagging, leading, by, millis, lane);
1616
1126
  async function fetch(leased, eventLimit) {
1617
1127
  return Promise.all(
1618
1128
  leased.map(async ({ stream, source, at, lagging }) => {
1619
1129
  const events = [];
1620
- const stream_exact = source !== void 0 && is_literal_source(source) ? true : void 0;
1130
+ const stream_exact = source !== void 0 && is_literal_source(source, stream) ? true : void 0;
1621
1131
  try {
1622
1132
  await store().query((e) => events.push(e), {
1623
1133
  stream: source,
@@ -2280,7 +1790,7 @@ async function run_drain_cycle(deps, cycle) {
2280
1790
  const leased = await ops.claim(
2281
1791
  lagging,
2282
1792
  leading,
2283
- randomUUID2(),
1793
+ randomUUID(),
2284
1794
  leaseMillis,
2285
1795
  lane
2286
1796
  );
@@ -2483,52 +1993,942 @@ var DrainController = class {
2483
1993
  this._inflight = void 0;
2484
1994
  }
2485
1995
  );
2486
- this._inflight = pass;
2487
- return pass;
1996
+ this._inflight = pass;
1997
+ return pass;
1998
+ }
1999
+ // One claim → fetch → handle → ack pass. Never throws.
2000
+ async _pass(streamLimit, eventLimit, leaseMillis) {
2001
+ try {
2002
+ const lagging = Math.ceil(streamLimit * this._ratio);
2003
+ const leading = streamLimit - lagging;
2004
+ const started = Date.now();
2005
+ const raised = this._raised;
2006
+ const cycle = await run_drain_cycle(this._deps, {
2007
+ lagging,
2008
+ leading,
2009
+ eventLimit,
2010
+ leaseMillis,
2011
+ misrouted: this._misrouted,
2012
+ store_failing: this._deps.breaker.failing
2013
+ });
2014
+ if (!cycle) {
2015
+ this._defer.prune(started);
2016
+ this._deps.breaker.passed();
2017
+ this._lowered = raised;
2018
+ return EMPTY_DRAIN;
2019
+ }
2020
+ const { leased, fetched, handled, acked, blocked, closeable } = cycle;
2021
+ trace_cycle(this._deps.logger, leased, fetched, handled, acked, blocked);
2022
+ this._ratio = compute_lag_lead_ratio(handled, lagging, leading);
2023
+ for (const lease of acked) this._defer.delete(lease.stream);
2024
+ for (const lease of blocked) this._defer.delete(lease.stream);
2025
+ for (const h of handled) {
2026
+ const next = h.defer ?? h.next_attempt_at;
2027
+ if (next !== void 0) this._defer.set(h.lease.stream, next);
2028
+ }
2029
+ if (acked.length) this._deps.on_acked(acked);
2030
+ if (closeable.length) await this._deps.on_close(closeable);
2031
+ this._deps.breaker.passed();
2032
+ return { fetched, leased, acked, blocked };
2033
+ } catch (error) {
2034
+ this._defer.set(
2035
+ RETRY,
2036
+ Date.now() + Math.max(leaseMillis, this._deps.breaker.cooldown_ms)
2037
+ );
2038
+ this._deps.breaker.failed(Date.now(), error);
2039
+ return EMPTY_DRAIN;
2040
+ } finally {
2041
+ if (!this._stopped) this._defer.schedule();
2042
+ }
2043
+ }
2044
+ };
2045
+
2046
+ // src/internal/reaction-dispatch.ts
2047
+ var CloseSignal = class extends Error {
2048
+ /**
2049
+ * Stream to close. Omitted → the reaction's own lease stream (a self-close).
2050
+ * The synthesized autoclose reaction sets it to the aggregate stream, since
2051
+ * its lease runs on a synthetic `__autoclose__` target.
2052
+ */
2053
+ stream;
2054
+ /** Optional archive callback to run while the stream is guarded. */
2055
+ archive;
2056
+ /**
2057
+ * Watermark to ack the requesting reaction to before the close runs. The
2058
+ * close-cycle safety guard skips a stream whose subscriptions (matched by
2059
+ * source) lag the head; the autoclose reaction's `source` is the aggregate,
2060
+ * so it must advance its own watermark to the live head id it evaluated
2061
+ * against — otherwise it blocks its own close. Defaults to the triggering
2062
+ * event id when omitted.
2063
+ */
2064
+ at;
2065
+ /**
2066
+ * Windowed close: prune events older than this cutoff behind
2067
+ * the closest safe snapshot instead of retiring the stream. Thrown by
2068
+ * the autoclose reaction of a `.autocloses({ keep })` state; flows
2069
+ * into {@link CloseTarget.before}. Omitted → a full close.
2070
+ */
2071
+ before;
2072
+ /**
2073
+ * Revisit the requesting reaction at this time. Only useful with an `at`
2074
+ * below the head: a reaction runs only when an event is waiting for it.
2075
+ */
2076
+ defer;
2077
+ constructor(opts) {
2078
+ super("reaction requested close");
2079
+ this.name = "CloseSignal";
2080
+ this.stream = opts?.stream;
2081
+ this.archive = opts?.archive;
2082
+ this.at = opts?.at;
2083
+ this.before = opts?.before;
2084
+ this.defer = opts?.defer;
2085
+ }
2086
+ };
2087
+ function build_handle(deps) {
2088
+ const { logger, reaction_scope } = deps;
2089
+ return async (lease, payloads) => {
2090
+ if (payloads.length === 0) return { lease, handled: 0, acked_at: lease.at };
2091
+ const stream = lease.stream;
2092
+ const last_index_of = /* @__PURE__ */ new Map();
2093
+ for (let i = 0; i < payloads.length; i++)
2094
+ last_index_of.set(payloads[i].event.id, i);
2095
+ let at = lease.at;
2096
+ let handled = 0;
2097
+ if (lease.retry > 0)
2098
+ logger.warn(
2099
+ `Retrying ${stream}@${payloads.at(0).event.id} (${lease.retry}).`
2100
+ );
2101
+ for (let i = 0; i < payloads.length; i++) {
2102
+ const payload = payloads[i];
2103
+ const { event, handler } = payload;
2104
+ try {
2105
+ await reaction_scope.run(
2106
+ event,
2107
+ () => handler(event, stream, reaction_scope.app)
2108
+ );
2109
+ if (last_index_of.get(event.id) === i) {
2110
+ at = event.id;
2111
+ handled++;
2112
+ }
2113
+ } catch (error) {
2114
+ if (error instanceof DeferSignal) {
2115
+ let defer;
2116
+ try {
2117
+ defer = resolve_defer_at(error.when, event);
2118
+ } catch (invalid) {
2119
+ return finalize(
2120
+ lease,
2121
+ handled,
2122
+ at,
2123
+ invalid,
2124
+ payload.options,
2125
+ logger,
2126
+ event.id
2127
+ );
2128
+ }
2129
+ return { lease, handled, acked_at: at, defer };
2130
+ }
2131
+ if (error instanceof CloseSignal)
2132
+ return {
2133
+ lease,
2134
+ handled: handled + 1,
2135
+ // Advance to the live head the handler evaluated against (when
2136
+ // provided) so the close-cycle guard sees this reaction caught up.
2137
+ acked_at: error.at ?? event.id,
2138
+ defer: error.defer?.getTime(),
2139
+ // Close the signalled stream (the autoclose reaction's aggregate,
2140
+ // which differs from its synthetic lease stream); a self-closing
2141
+ // user reaction omits it and closes its own lease stream. A
2142
+ // carried `before` makes it a windowed close (prune, not retire).
2143
+ close: {
2144
+ stream: error.stream ?? stream,
2145
+ archive: error.archive,
2146
+ before: error.before
2147
+ }
2148
+ };
2149
+ return finalize(
2150
+ lease,
2151
+ handled,
2152
+ at,
2153
+ error,
2154
+ payload.options,
2155
+ logger,
2156
+ event.id
2157
+ );
2158
+ }
2159
+ }
2160
+ return finalize(lease, handled, at, void 0, payloads[0].options, logger);
2161
+ };
2162
+ }
2163
+ function build_handle_batch(logger) {
2164
+ return async (lease, payloads, batchHandler) => {
2165
+ const stream = lease.stream;
2166
+ const events = [];
2167
+ const seen = /* @__PURE__ */ new Set();
2168
+ for (const p of payloads) {
2169
+ if (seen.has(p.event.id)) continue;
2170
+ seen.add(p.event.id);
2171
+ events.push(p.event);
2172
+ }
2173
+ const options = payloads[0].options;
2174
+ if (lease.retry > 0)
2175
+ logger.warn(`Retrying batch ${stream}@${events[0].id} (${lease.retry}).`);
2176
+ try {
2177
+ await batchHandler(events, stream);
2178
+ return finalize(
2179
+ lease,
2180
+ events.length,
2181
+ events.at(-1).id,
2182
+ void 0,
2183
+ options,
2184
+ logger
2185
+ );
2186
+ } catch (error) {
2187
+ return finalize(lease, 0, lease.at, error, options, logger);
2188
+ }
2189
+ };
2190
+ }
2191
+
2192
+ // src/internal/autoclose-reaction.ts
2193
+ var AUTOCLOSE_TARGET_PREFIX = "__autoclose__:";
2194
+ function synthesize_autoclose_reactions(registry, states, read_window) {
2195
+ for (const st of states.values()) {
2196
+ const predicate = st.autoclose;
2197
+ if (!predicate) continue;
2198
+ const after_windows = st.autoclose_after_windows;
2199
+ const keep_days = st.autoclose_keep_days;
2200
+ const archiver = st.archive;
2201
+ const reaction = {
2202
+ // Run on a SYNTHETIC stream — `source` is the aggregate, `target` is a
2203
+ // per-aggregate `__autoclose__` key — so the autoclose reaction never
2204
+ // shares a watermark with the aggregate's own reactions. A shared
2205
+ // watermark would let autoclose's defer short-circuit the aggregate's
2206
+ // other reactions (the "a defer affects all reactions on a stream"
2207
+ // hazard). The close still targets the aggregate (`source`).
2208
+ // A stream name with a regex metacharacter would read as a pattern, and a
2209
+ // store may refuse it at subscribe, stopping every reaction. Such a stream
2210
+ // has no autoclose: `app.close` still closes it.
2211
+ resolver: (e) => is_literal_source(e.stream) ? {
2212
+ target: `${AUTOCLOSE_TARGET_PREFIX}${e.stream}`,
2213
+ source: e.stream
2214
+ } : void 0,
2215
+ // Never block on autoclose: a transient query/store error should retry,
2216
+ // not quarantine the synthetic stream.
2217
+ options: { blockOnError: false, maxRetries: DEFAULT_MAX_RETRIES },
2218
+ handler: async (event) => {
2219
+ const aggregate = event.stream;
2220
+ const window = read_window();
2221
+ if (!in_autoclose_window(window, /* @__PURE__ */ new Date()))
2222
+ throw new DeferSignal({ at: next_window_open(window, /* @__PURE__ */ new Date()) });
2223
+ const stats = await store().query_stats([aggregate], {
2224
+ count: true,
2225
+ tail: keep_days !== void 0 ? true : void 0,
2226
+ exclude: [TOMBSTONE_EVENT, SNAP_EVENT]
2227
+ });
2228
+ const entry = stats.get(aggregate);
2229
+ if (!entry) return;
2230
+ const head = entry.head;
2231
+ if (predicate(aggregate, head, entry.count))
2232
+ throw new CloseSignal({
2233
+ stream: aggregate,
2234
+ archive: archiver ? () => archiver(aggregate, head) : void 0,
2235
+ // Ack this reaction's own watermark to the live head so the
2236
+ // close-cycle guard (which matches subscriptions by source =
2237
+ // aggregate) sees it caught up instead of blocking its own close.
2238
+ at: head.id
2239
+ });
2240
+ if (keep_days !== void 0) {
2241
+ const cutoff = days_before_now(keep_days);
2242
+ if (entry.tail.created < cutoff) {
2243
+ const waiting = after_windows.some(
2244
+ (days) => days_after(head.created, days).getTime() > Date.now()
2245
+ );
2246
+ throw new CloseSignal({
2247
+ stream: aggregate,
2248
+ before: cutoff,
2249
+ archive: archiver ? () => archiver(aggregate, head, cutoff) : void 0,
2250
+ at: waiting ? head.id - 1 : head.id,
2251
+ defer: waiting ? days_after(/* @__PURE__ */ new Date(), 1) : void 0
2252
+ });
2253
+ }
2254
+ }
2255
+ const dues = [];
2256
+ for (const days of after_windows)
2257
+ dues.push(days_after(head.created, days));
2258
+ if (keep_days !== void 0)
2259
+ dues.push(days_after(entry.tail.created, keep_days));
2260
+ const future = dues.map((d) => d.getTime()).filter((t) => t > Date.now());
2261
+ if (future.length)
2262
+ throw new DeferSignal({ at: new Date(Math.min(...future)) });
2263
+ }
2264
+ };
2265
+ const key = `__autoclose_${st.name}`;
2266
+ for (const event_name of Object.keys(st.events)) {
2267
+ registry.events[event_name]?.reactions.set(
2268
+ key,
2269
+ reaction
2270
+ );
2271
+ }
2272
+ }
2273
+ }
2274
+
2275
+ // src/internal/close-cycle.ts
2276
+ var CLOSE_CATCH_UP_LIMIT = 1e3;
2277
+ var CLOSE_CATCH_UP_PASSES = 20;
2278
+ async function catch_up_correlation(cursor, correlate, until) {
2279
+ for (let pass = 0; pass < CLOSE_CATCH_UP_PASSES && cursor.checkpoint < until; pass++) {
2280
+ const before = cursor.checkpoint;
2281
+ cursor.arm();
2282
+ await correlate(CLOSE_CATCH_UP_LIMIT);
2283
+ if (cursor.checkpoint <= before) break;
2284
+ }
2285
+ return cursor.checkpoint;
2286
+ }
2287
+ var CloseLock = class {
2288
+ _tails = /* @__PURE__ */ new Map();
2289
+ /** Run `work` after every earlier close of `stream` has settled. */
2290
+ run(stream, work) {
2291
+ const prev = this._tails.get(stream) ?? Promise.resolve();
2292
+ const next = prev.then(work, work);
2293
+ this._tails.set(stream, next);
2294
+ const cleanup = () => {
2295
+ if (this._tails.get(stream) === next) this._tails.delete(stream);
2296
+ };
2297
+ next.then(cleanup, cleanup);
2298
+ return next;
2299
+ }
2300
+ };
2301
+ var SAFETY_PROBE_PAGE_SIZE = 1e3;
2302
+ async function run_close_cycle(targets, deps) {
2303
+ const target_map = new Map(targets.map((t) => [t.stream, t]));
2304
+ for (const t of target_map.values()) {
2305
+ if (t.before !== void 0 && t.restart)
2306
+ throw new Error(
2307
+ `close: \`before\` and \`restart\` are mutually exclusive (stream "${t.stream}") \u2014 a windowed close keeps the stream live behind a real snapshot; restart reseeds it`
2308
+ );
2309
+ }
2310
+ const windowed = [...target_map.values()].filter(
2311
+ (t) => t.before !== void 0
2312
+ );
2313
+ const full = [...target_map.values()].filter((t) => t.before === void 0);
2314
+ const skipped = [];
2315
+ const windowed_result = windowed.length ? await run_windowed_closes(windowed, deps, skipped) : /* @__PURE__ */ new Map();
2316
+ if (!full.length) return { truncated: windowed_result, skipped };
2317
+ const truncated = await with_stream_locks(
2318
+ full.map((t) => t.stream),
2319
+ deps,
2320
+ () => run_full_closes(full, target_map, deps, skipped)
2321
+ );
2322
+ const retired = [...truncated.entries()].filter(([, r]) => r.committed.name === TOMBSTONE_EVENT).map(([stream]) => stream);
2323
+ if (retired.length) deps.forget_subscribed?.(retired);
2324
+ for (const [stream, entry] of windowed_result) truncated.set(stream, entry);
2325
+ return { truncated, skipped };
2326
+ }
2327
+ function with_stream_locks(streams, deps, work) {
2328
+ const with_lock = deps.with_stream_lock ?? ((_stream, w) => w());
2329
+ return [...streams].sort().reduceRight(
2330
+ (inner, stream) => () => with_lock(stream, inner),
2331
+ work
2332
+ )();
2333
+ }
2334
+ async function run_full_closes(full, target_map, deps, skipped) {
2335
+ const none = /* @__PURE__ */ new Map();
2336
+ const streams = full.map((t) => t.stream);
2337
+ const stream_info = await scan_stream_heads(streams);
2338
+ for (const target of full) {
2339
+ if (!target.restart) continue;
2340
+ const info = stream_info.get(target.stream);
2341
+ if (!info) continue;
2342
+ const owner = deps.event_to_state.get(info.last_event_name);
2343
+ if (owner?.pii_aware) {
2344
+ deps.logger.error(
2345
+ `Refusing to close "${target.stream}" with restart: state "${owner.name}" carries sensitive fields, so a restart seed would persist redacted values while deleting the originals. Close it without restart to retire the stream, or leave it open.`
2346
+ );
2347
+ skipped.push(target.stream);
2348
+ stream_info.delete(target.stream);
2349
+ }
2350
+ }
2351
+ const safe = await partition_by_safety(
2352
+ stream_info,
2353
+ deps.reactive,
2354
+ skipped,
2355
+ deps.probe_page_size ?? SAFETY_PROBE_PAGE_SIZE,
2356
+ deps.catch_up_correlation
2357
+ );
2358
+ if (!safe.length) return none;
2359
+ const { guarded, guard_events } = await guard_with_tombstones(
2360
+ safe,
2361
+ stream_info,
2362
+ deps.correlation,
2363
+ deps.tombstone,
2364
+ skipped
2365
+ );
2366
+ if (!guarded.length) return none;
2367
+ const seed_states = await load_restart_seeds(
2368
+ guarded,
2369
+ target_map,
2370
+ stream_info,
2371
+ deps.event_to_state,
2372
+ deps.load,
2373
+ deps.logger
2374
+ );
2375
+ await run_archive_callbacks(guarded, target_map);
2376
+ const still_guarded = await heads_still_guarded(
2377
+ guarded,
2378
+ guard_events,
2379
+ skipped
2380
+ );
2381
+ if (!still_guarded.length) return none;
2382
+ return truncate_and_warm_cache(
2383
+ still_guarded,
2384
+ seed_states,
2385
+ guard_events,
2386
+ deps.correlation
2387
+ );
2388
+ }
2389
+ async function run_windowed_closes(windowed, deps, skipped) {
2390
+ const checkpoint = deps.reactive ? await deps.catch_up_correlation(Number.MAX_SAFE_INTEGER) : -1;
2391
+ const min_at = deps.reactive ? await probe_min_watermarks(
2392
+ windowed.map((t) => t.stream),
2393
+ deps.probe_page_size ?? SAFETY_PROBE_PAGE_SIZE,
2394
+ checkpoint
2395
+ ) : /* @__PURE__ */ new Map();
2396
+ const with_lock = deps.with_stream_lock ?? ((_stream, work) => work());
2397
+ const truncated = /* @__PURE__ */ new Map();
2398
+ for (const t of windowed) {
2399
+ const entry = await with_lock(t.stream, async () => {
2400
+ const max_id = min_at.get(t.stream);
2401
+ if (!await windowed_prune_pending(t.stream, t.before, max_id))
2402
+ return void 0;
2403
+ if (t.archive) await t.archive();
2404
+ const result = await store().truncate([
2405
+ { stream: t.stream, before: t.before, max_id }
2406
+ ]);
2407
+ return result.get(t.stream);
2408
+ });
2409
+ if (entry) truncated.set(t.stream, entry);
2410
+ else skipped.push(t.stream);
2411
+ }
2412
+ return truncated;
2413
+ }
2414
+ async function windowed_prune_pending(stream, before, max_id) {
2415
+ let boundary_id;
2416
+ let min_id;
2417
+ await store().query(
2418
+ (event) => {
2419
+ if (min_id === void 0 || event.id < min_id) min_id = event.id;
2420
+ if (event.name === SNAP_EVENT && event.created < before && (max_id === void 0 || event.id <= max_id) && (boundary_id === void 0 || event.id > boundary_id))
2421
+ boundary_id = event.id;
2422
+ },
2423
+ { stream, stream_exact: true, with_snaps: true, after: -1 }
2424
+ );
2425
+ return boundary_id !== void 0 && min_id < boundary_id;
2426
+ }
2427
+ async function probe_min_watermarks(streams, page_size, checkpoint) {
2428
+ const min_at = /* @__PURE__ */ new Map();
2429
+ const matches = source_matcher();
2430
+ await walk_streams(
2431
+ store(),
2432
+ (position) => {
2433
+ const pending = position.correlated_at === void 0 || position.at < position.correlated_at;
2434
+ const cap = pending ? position.at : Math.max(position.at, checkpoint);
2435
+ for (const stream of streams) {
2436
+ if (matches(position.source, position.stream, stream)) {
2437
+ const prev = min_at.get(stream);
2438
+ if (prev === void 0 || cap < prev) min_at.set(stream, cap);
2439
+ }
2440
+ }
2441
+ },
2442
+ { limit: page_size }
2443
+ );
2444
+ return min_at;
2445
+ }
2446
+ function source_matcher() {
2447
+ const compiled = /* @__PURE__ */ new Map();
2448
+ return (source, target, stream) => {
2449
+ if (!source) return true;
2450
+ if (is_literal_source(source, target)) return source === stream;
2451
+ let re = compiled.get(source);
2452
+ if (!re) {
2453
+ re = new RegExp(source);
2454
+ compiled.set(source, re);
2455
+ }
2456
+ return re.test(stream);
2457
+ };
2458
+ }
2459
+ async function scan_stream_heads(streams) {
2460
+ const stats = await store().query_stats(streams, {
2461
+ exclude: [SNAP_EVENT]
2462
+ });
2463
+ const domain_heads = await store().query_stats(streams, {
2464
+ exclude: [SNAP_EVENT, TOMBSTONE_EVENT]
2465
+ });
2466
+ const true_heads = await store().query_stats(streams, {});
2467
+ const out = /* @__PURE__ */ new Map();
2468
+ for (const [stream, { head }] of domain_heads) {
2469
+ const marker_head = stats.get(stream)?.head;
2470
+ const interrupted = marker_head?.name === TOMBSTONE_EVENT;
2471
+ out.set(stream, {
2472
+ max_id: head.id,
2473
+ version: true_heads.get(stream).head.version,
2474
+ last_event_name: head.name,
2475
+ ...interrupted ? { resumed_guard: { id: marker_head.id } } : {}
2476
+ });
2477
+ }
2478
+ return out;
2479
+ }
2480
+ async function partition_by_safety(stream_info, reactive, skipped, page_size, catch_up_correlation2) {
2481
+ if (!reactive) return [...stream_info.keys()];
2482
+ let needed = -1;
2483
+ for (const info of stream_info.values())
2484
+ needed = Math.max(needed, info.max_id);
2485
+ const checkpoint = await catch_up_correlation2(needed);
2486
+ const uncorrelated = /* @__PURE__ */ new Set();
2487
+ for (const [stream, info] of stream_info) {
2488
+ if (checkpoint < info.max_id) uncorrelated.add(stream);
2489
+ }
2490
+ const pending_set = /* @__PURE__ */ new Set();
2491
+ const matches = source_matcher();
2492
+ await walk_streams(
2493
+ store(),
2494
+ (position) => {
2495
+ const has_work = position.correlated_at !== void 0 && position.at < position.correlated_at;
2496
+ if (!has_work) return;
2497
+ if (position.stream.startsWith(AUTOCLOSE_TARGET_PREFIX)) return;
2498
+ for (const [stream, info] of stream_info) {
2499
+ if (matches(position.source, position.stream, stream) && position.at < info.max_id)
2500
+ pending_set.add(stream);
2501
+ }
2502
+ },
2503
+ { limit: page_size }
2504
+ );
2505
+ const safe = [];
2506
+ for (const [stream] of stream_info) {
2507
+ if (pending_set.has(stream) || uncorrelated.has(stream))
2508
+ skipped.push(stream);
2509
+ else safe.push(stream);
2510
+ }
2511
+ return safe;
2512
+ }
2513
+ async function guard_with_tombstones(safe, stream_info, correlation, tombstone2, skipped) {
2514
+ const guarded = [];
2515
+ const guard_events = /* @__PURE__ */ new Map();
2516
+ await Promise.all(
2517
+ safe.map(async (stream) => {
2518
+ const info = stream_info.get(stream);
2519
+ if (info.resumed_guard) {
2520
+ guarded.push(stream);
2521
+ guard_events.set(stream, { id: info.resumed_guard.id, stream });
2522
+ return;
2523
+ }
2524
+ const committed = await tombstone2(stream, info.version, correlation);
2525
+ if (committed) {
2526
+ guarded.push(stream);
2527
+ guard_events.set(stream, { id: committed.id, stream });
2528
+ } else {
2529
+ skipped.push(stream);
2530
+ }
2531
+ })
2532
+ );
2533
+ return { guarded, guard_events };
2534
+ }
2535
+ async function load_restart_seeds(guarded, target_map, stream_info, event_to_state, load2, logger) {
2536
+ const seed_states = /* @__PURE__ */ new Map();
2537
+ await Promise.all(
2538
+ guarded.filter((s) => target_map.get(s)?.restart).map(async (stream) => {
2539
+ const last_event_name = stream_info.get(stream).last_event_name;
2540
+ const owner_state = event_to_state.get(last_event_name);
2541
+ if (!owner_state) {
2542
+ logger.error(
2543
+ `Cannot seed restart for "${stream}": no registered state owns event "${last_event_name}". Stream will be tombstoned instead.`
2544
+ );
2545
+ return;
2546
+ }
2547
+ const snap2 = await load2(owner_state, { stream });
2548
+ seed_states.set(stream, snap2.state);
2549
+ })
2550
+ );
2551
+ return seed_states;
2552
+ }
2553
+ async function run_archive_callbacks(guarded, target_map) {
2554
+ for (const stream of guarded) {
2555
+ const archive_fn = target_map.get(stream)?.archive;
2556
+ if (archive_fn) await archive_fn();
2557
+ }
2558
+ }
2559
+ async function heads_still_guarded(guarded, guard_events, skipped) {
2560
+ const heads = await store().query_stats(guarded, {});
2561
+ return guarded.filter((stream) => {
2562
+ if (heads.get(stream)?.head.id === guard_events.get(stream).id)
2563
+ return true;
2564
+ skipped.push(stream);
2565
+ return false;
2566
+ });
2567
+ }
2568
+ async function truncate_and_warm_cache(guarded, seed_states, guard_events, correlation) {
2569
+ const trunc_targets = guarded.map((stream) => {
2570
+ const snapshot = seed_states.get(stream);
2571
+ const guard = guard_events.get(stream);
2572
+ return {
2573
+ stream,
2574
+ snapshot,
2575
+ meta: {
2576
+ correlation,
2577
+ causation: {
2578
+ event: { id: guard.id, name: TOMBSTONE_EVENT, stream: guard.stream }
2579
+ }
2580
+ }
2581
+ };
2582
+ });
2583
+ const truncated = await store().truncate(trunc_targets);
2584
+ await Promise.all(
2585
+ guarded.map(async (stream) => {
2586
+ const entry = truncated.get(stream);
2587
+ const state2 = seed_states.get(stream);
2588
+ if (state2 && entry) {
2589
+ await cache().set(stream, {
2590
+ stream,
2591
+ state: state2,
2592
+ version: entry.committed.version,
2593
+ event_id: entry.committed.id,
2594
+ patches: 0,
2595
+ snaps: 1
2596
+ });
2597
+ } else {
2598
+ await cache().invalidate(stream);
2599
+ }
2600
+ })
2601
+ );
2602
+ return truncated;
2603
+ }
2604
+
2605
+ // src/internal/correlate-cycle.ts
2606
+ import { createHash, randomUUID as randomUUID2 } from "crypto";
2607
+ var COLD_START_BACK_SCAN = 1e4;
2608
+ var CORRELATION_LEASE_MS = 5e3;
2609
+ var registry_key = (events) => {
2610
+ const shape = Object.keys(events).filter((name) => events[name].reactions.size > 0).sort().map((name) => [name, [...events[name].reactions.keys()].sort()]);
2611
+ return createHash("sha256").update(JSON.stringify(shape)).digest("hex").slice(0, 32);
2612
+ };
2613
+ var PATTERN_CACHE_SIZE = 32;
2614
+ function report_undeclared_lane(seen, handler, target, lane, declared) {
2615
+ report_once(
2616
+ seen,
2617
+ `lane|${handler}|${lane}`,
2618
+ `Reaction "${handler}" resolved onto undeclared lane "${lane}" \u2014 for example target "${target}". Declared lanes: ${[...declared].map((l) => `"${l}"`).join(", ")}. No controller claims it, so the stream would never drain \u2014 running it on "default" instead. The equivalent static \`.to({ lane })\` is rejected at build; a dynamic resolver's lane is only knowable here.`
2619
+ );
2620
+ }
2621
+ function report_lane_conflict(seen, handler, target, kept, dropped) {
2622
+ report_once(
2623
+ seen,
2624
+ `conflict|${handler}|${kept}|${dropped}`,
2625
+ `Reaction "${handler}" resolved lane "${dropped}" for a stream already on "${kept}" \u2014 for example "${target}". These are conflicting lane assignments from two dynamic resolutions at equal priority. Keeping "${kept}", the lane it was first discovered on \u2014 re-laning a live stream would move it out from under a worker holding its lease. The reaction resolving "${dropped}" runs inside the "${kept}" lane's budget, and a process restricted to "${dropped}" via onlyLanes never runs it. The equivalent static declaration is rejected at build; align the resolvers, or split the target.`
2626
+ );
2627
+ }
2628
+ var CorrelateCycle = class {
2629
+ _checkpoint = -1;
2630
+ // Lease holder id; per instance, so a restart never inherits a stale claim.
2631
+ _by = randomUUID2();
2632
+ _key;
2633
+ // Local expiry of the held lease (0 = none); stale only costs a duplicate scan.
2634
+ _lease_until = 0;
2635
+ // Armed while `_raised` (bumped by a commit or notification) is ahead of
2636
+ // `_lowered` (the raise count the last short page saw). Starts armed.
2637
+ _raised = 1;
2638
+ _lowered = 0;
2639
+ // Bumped by a release (shutdown), so a scan or lease reply that was out
2640
+ // across one writes nothing.
2641
+ _epoch = 0;
2642
+ // Passes in flight: a restore waits for them, and refuses new ones.
2643
+ _passes = /* @__PURE__ */ new Set();
2644
+ _restoring = false;
2645
+ _init_promise;
2646
+ // Bounded by `maxSubscribedStreams`; static records live apart so eviction
2647
+ // never lets a resolution re-lane them.
2648
+ _dynamic_subscriptions;
2649
+ _static_subscriptions = /* @__PURE__ */ new Map();
2650
+ _patterns = new LruMap(PATTERN_CACHE_SIZE);
2651
+ _registry;
2652
+ _static_targets;
2653
+ _cd;
2654
+ _on_init;
2655
+ _declared_lanes;
2656
+ // Report-once keys; per instance because `internal/` holds no module state.
2657
+ _reported = /* @__PURE__ */ new Set();
2658
+ constructor({
2659
+ registry,
2660
+ static_targets,
2661
+ cd,
2662
+ max_subscribed_streams,
2663
+ declared_lanes,
2664
+ shard,
2665
+ on_init
2666
+ }) {
2667
+ this._key = shard ? `${registry_key(registry.events)}:${[...shard].sort().join(",")}` : registry_key(registry.events);
2668
+ this._dynamic_subscriptions = new LruMap(max_subscribed_streams);
2669
+ this._registry = registry;
2670
+ this._declared_lanes = declared_lanes;
2671
+ this._static_targets = static_targets;
2672
+ this._cd = cd;
2673
+ this._on_init = on_init;
2674
+ }
2675
+ get checkpoint() {
2676
+ return this._checkpoint;
2677
+ }
2678
+ /** A commit (local or remote) may have produced uncorrelated events. */
2679
+ arm() {
2680
+ this._raised++;
2681
+ }
2682
+ async _init() {
2683
+ this._init_promise ??= this._run_init().catch((error) => {
2684
+ this._init_promise = void 0;
2685
+ throw error;
2686
+ });
2687
+ await this._init_promise;
2688
+ }
2689
+ async _run_init() {
2690
+ const { watermark, correlated_at } = await this._cd.subscribe([
2691
+ ...this._static_targets
2692
+ ]);
2693
+ this._checkpoint = correlated_at >= 0 ? correlated_at : Math.max(-1, watermark - COLD_START_BACK_SCAN);
2694
+ for (const { stream, priority = 0, lane } of this._static_targets) {
2695
+ this._static_subscriptions.set(stream, {
2696
+ priority,
2697
+ lane
2698
+ });
2699
+ }
2700
+ await this._on_init?.();
2701
+ }
2702
+ /**
2703
+ * Replace the log with no pass in flight, then cold-start: a pass that
2704
+ * read the old log writes before the restore, never into the new one.
2705
+ */
2706
+ async restart(restore) {
2707
+ this._restoring = true;
2708
+ try {
2709
+ await Promise.allSettled(this._passes);
2710
+ await restore();
2711
+ } finally {
2712
+ this._restoring = false;
2713
+ }
2714
+ this._init_promise = void 0;
2715
+ this._checkpoint = -1;
2716
+ this._dynamic_subscriptions.clear();
2717
+ this._static_subscriptions.clear();
2718
+ }
2719
+ /** Forget dynamic targets whose rows a full close deleted, so they re-subscribe. */
2720
+ forget_subscribed(streams) {
2721
+ for (const stream of streams) this._dynamic_subscriptions.delete(stream);
2722
+ }
2723
+ // Would the target's own `fetch` (filtered by `source`) return this event?
2724
+ _in_fetch_window(source, stream) {
2725
+ if (source === void 0 || source === stream) return true;
2726
+ if (is_literal_source(source)) return false;
2727
+ let pattern = this._patterns.get(source);
2728
+ if (!pattern) {
2729
+ pattern = new RegExp(source);
2730
+ this._patterns.set(source, pattern);
2731
+ }
2732
+ return pattern.test(stream);
2733
+ }
2734
+ /** Scan past the checkpoint, subscribe new targets and raise their work marks. */
2735
+ async correlate(limit, lease = false) {
2736
+ if (this._restoring) return { kind: "idle", last_id: this._checkpoint };
2737
+ const pass = this._scan(limit, lease);
2738
+ this._passes.add(pass);
2739
+ try {
2740
+ return await pass;
2741
+ } finally {
2742
+ this._passes.delete(pass);
2743
+ }
2744
+ }
2745
+ async _scan(limit, lease) {
2746
+ await this._init();
2747
+ const epoch = this._epoch;
2748
+ const idle = () => ({
2749
+ kind: "idle",
2750
+ last_id: this._checkpoint
2751
+ });
2752
+ if (this._raised === this._lowered) return idle();
2753
+ const raised = this._raised;
2754
+ const now = Date.now();
2755
+ if (lease && now >= this._lease_until - CORRELATION_LEASE_MS / 2) {
2756
+ const { correlating } = await this._cd.subscribe([], void 0, {
2757
+ key: this._key,
2758
+ by: this._by,
2759
+ millis: CORRELATION_LEASE_MS
2760
+ });
2761
+ if (this._epoch !== epoch) return idle();
2762
+ this._lease_until = correlating ? now + CORRELATION_LEASE_MS : 0;
2763
+ if (correlating === false) return idle();
2764
+ }
2765
+ const after = this._checkpoint;
2766
+ const correlated = /* @__PURE__ */ new Map();
2767
+ let last_id = after;
2768
+ let stopped = false;
2769
+ const found = await store().query(
2770
+ (event) => {
2771
+ if (stopped) return;
2772
+ const register = this._registry.events[event.name];
2773
+ if (register) {
2774
+ for (const reaction of register.reactions.values()) {
2775
+ let resolved;
2776
+ try {
2777
+ resolved = typeof reaction.resolver === "function" ? reaction.resolver(event) : reaction.resolver;
2778
+ } catch (error) {
2779
+ stopped = true;
2780
+ report_once(
2781
+ this._reported,
2782
+ `resolver|${reaction.handler.name}|${event.id}`,
2783
+ `Resolver of reaction "${reaction.handler.name}" threw on ${String(event.name)} #${event.id} (stream "${event.stream}"): ${String(error)}. Correlation stops before this event until the resolver stops throwing; work already found keeps draining.`
2784
+ );
2785
+ return;
2786
+ }
2787
+ if (!resolved) continue;
2788
+ let lane = resolved.lane;
2789
+ if (lane !== void 0 && !this._declared_lanes.has(lane)) {
2790
+ report_undeclared_lane(
2791
+ this._reported,
2792
+ reaction.handler.name,
2793
+ resolved.target,
2794
+ lane,
2795
+ this._declared_lanes
2796
+ );
2797
+ lane = void 0;
2798
+ }
2799
+ const fixed = this._static_subscriptions.get(resolved.target);
2800
+ const recorded = fixed ?? this._dynamic_subscriptions.get(resolved.target);
2801
+ const priority = resolved.priority ?? 0;
2802
+ const upgraded = !recorded || !fixed && priority > recorded.priority;
2803
+ const carried = upgraded ? { priority, lane } : { priority: recorded.priority, lane: recorded.lane };
2804
+ const entry = correlated.get(resolved.target) || {
2805
+ source: resolved.source,
2806
+ priority: carried.priority,
2807
+ lane: carried.lane,
2808
+ upgraded,
2809
+ missed: !recorded,
2810
+ handler: reaction.handler.name,
2811
+ correlated_at: void 0
2812
+ };
2813
+ const seen_in_scan = correlated.has(resolved.target);
2814
+ const held_lane = (seen_in_scan ? entry.lane : recorded?.lane) ?? DEFAULT_LANE;
2815
+ const held_priority = seen_in_scan ? entry.priority : recorded?.priority;
2816
+ const resolved_lane = lane ?? DEFAULT_LANE;
2817
+ if (held_priority === priority && held_lane !== resolved_lane)
2818
+ report_lane_conflict(
2819
+ this._reported,
2820
+ reaction.handler.name,
2821
+ resolved.target,
2822
+ held_lane,
2823
+ resolved_lane
2824
+ );
2825
+ if (carried.priority > entry.priority) {
2826
+ entry.priority = carried.priority;
2827
+ entry.lane = carried.lane;
2828
+ entry.upgraded = upgraded;
2829
+ entry.handler = reaction.handler.name;
2830
+ }
2831
+ if (this._in_fetch_window(resolved.source, event.stream))
2832
+ entry.correlated_at = event.id;
2833
+ correlated.set(resolved.target, entry);
2834
+ }
2835
+ }
2836
+ last_id = event.id;
2837
+ },
2838
+ // Resolvers see `pii: null`: correlate runs actor-less, and one
2839
+ // undecryptable row would otherwise stop every stream's reactions.
2840
+ { after, limit, with_pii: false }
2841
+ );
2842
+ if (this._declared_lanes.size > 1) await this._recall(correlated);
2843
+ const read = last_id > after;
2844
+ if (this._epoch !== epoch) return idle();
2845
+ const streams = [];
2846
+ for (const [stream, entry] of correlated) {
2847
+ if (entry.upgraded || entry.correlated_at !== void 0)
2848
+ streams.push({
2849
+ stream,
2850
+ source: entry.source,
2851
+ priority: entry.priority,
2852
+ lane: entry.lane,
2853
+ correlated_at: entry.correlated_at
2854
+ });
2855
+ }
2856
+ if (streams.length) {
2857
+ const renewed_at = Date.now();
2858
+ const { subscribed, correlating } = await this._cd.subscribe(
2859
+ streams,
2860
+ last_id,
2861
+ lease ? { key: this._key, by: this._by, millis: CORRELATION_LEASE_MS } : void 0
2862
+ );
2863
+ if (lease && correlating !== false)
2864
+ this._lease_until = renewed_at + CORRELATION_LEASE_MS;
2865
+ const marked = streams.filter(
2866
+ (entry) => entry.correlated_at !== void 0
2867
+ ).length;
2868
+ this._checkpoint = last_id;
2869
+ for (const { stream, priority, lane } of streams) {
2870
+ if (correlated.get(stream)?.upgraded)
2871
+ this._dynamic_subscriptions.set(stream, {
2872
+ priority,
2873
+ lane
2874
+ });
2875
+ }
2876
+ return { kind: "scanned", last_id, subscribed, marked, read };
2877
+ }
2878
+ this._checkpoint = last_id;
2879
+ if (!stopped && found !== limit) this._lowered = raised;
2880
+ return { kind: "scanned", last_id, subscribed: 0, marked: 0, read };
2881
+ }
2882
+ // Read the row of each target this scan had no record of (new or evicted),
2883
+ // so a resolution that doesn't beat its priority keeps the row's lane.
2884
+ // Only called with more than one lane declared.
2885
+ async _recall(correlated) {
2886
+ const missed = [...correlated].filter(([, entry]) => entry.missed);
2887
+ await Promise.all(
2888
+ missed.map(async ([stream, entry]) => {
2889
+ let row;
2890
+ await store().query_streams(
2891
+ (position) => {
2892
+ row = position;
2893
+ },
2894
+ { stream, stream_exact: true, limit: 1 }
2895
+ );
2896
+ if (!row) return;
2897
+ this._dynamic_subscriptions.set(stream, {
2898
+ priority: row.priority,
2899
+ lane: row.lane
2900
+ });
2901
+ if (entry.priority > row.priority) return;
2902
+ const held_lane = row.lane ?? DEFAULT_LANE;
2903
+ const resolved_lane = entry.lane ?? DEFAULT_LANE;
2904
+ if (entry.priority === row.priority && held_lane !== resolved_lane)
2905
+ report_lane_conflict(
2906
+ this._reported,
2907
+ entry.handler,
2908
+ stream,
2909
+ held_lane,
2910
+ resolved_lane
2911
+ );
2912
+ entry.priority = row.priority;
2913
+ entry.lane = row.lane;
2914
+ entry.upgraded = false;
2915
+ })
2916
+ );
2488
2917
  }
2489
- // One claim → fetch → handle → ack pass. Never throws.
2490
- async _pass(streamLimit, eventLimit, leaseMillis) {
2918
+ /** Release the lease early by re-acquiring it for zero ms. Best-effort. */
2919
+ async release_correlation() {
2491
2920
  try {
2492
- const lagging = Math.ceil(streamLimit * this._ratio);
2493
- const leading = streamLimit - lagging;
2494
- const started = Date.now();
2495
- const raised = this._raised;
2496
- const cycle = await run_drain_cycle(this._deps, {
2497
- lagging,
2498
- leading,
2499
- eventLimit,
2500
- leaseMillis,
2501
- misrouted: this._misrouted,
2502
- store_failing: this._deps.breaker.failing
2921
+ this._lease_until = 0;
2922
+ this._epoch++;
2923
+ await this._cd.subscribe([], void 0, {
2924
+ key: this._key,
2925
+ by: this._by,
2926
+ millis: 0
2503
2927
  });
2504
- if (!cycle) {
2505
- this._defer.prune(started);
2506
- this._deps.breaker.passed();
2507
- this._lowered = raised;
2508
- return EMPTY_DRAIN;
2509
- }
2510
- const { leased, fetched, handled, acked, blocked, closeable } = cycle;
2511
- trace_cycle(this._deps.logger, leased, fetched, handled, acked, blocked);
2512
- this._ratio = compute_lag_lead_ratio(handled, lagging, leading);
2513
- for (const lease of acked) this._defer.delete(lease.stream);
2514
- for (const lease of blocked) this._defer.delete(lease.stream);
2515
- for (const h of handled) {
2516
- const next = h.defer ?? h.next_attempt_at;
2517
- if (next !== void 0) this._defer.set(h.lease.stream, next);
2518
- }
2519
- if (acked.length) this._deps.on_acked(acked);
2520
- if (closeable.length) await this._deps.on_close(closeable);
2521
- this._deps.breaker.passed();
2522
- return { fetched, leased, acked, blocked };
2523
2928
  } catch (error) {
2524
- this._defer.set(
2525
- RETRY,
2526
- Date.now() + Math.max(leaseMillis, this._deps.breaker.cooldown_ms)
2929
+ log().warn(
2930
+ `Could not hand back the correlation lease during shutdown; it expires on its own within ${CORRELATION_LEASE_MS}ms and correlation resumes normally after that. On a single-writer store this usually means another connection holds the database. Cause: ${String(error.cause ?? error)}`
2527
2931
  );
2528
- this._deps.breaker.failed(Date.now(), error);
2529
- return EMPTY_DRAIN;
2530
- } finally {
2531
- if (!this._stopped) this._defer.schedule();
2532
2932
  }
2533
2933
  }
2534
2934
  };
@@ -2642,206 +3042,30 @@ function make_fold_handler(me, flush, config2, sensitive_fields) {
2642
3042
  cache2.delete(stream);
2643
3043
  fold = await first_sight(stream);
2644
3044
  }
2645
- if (event.id > fold.event_id) {
2646
- const reducer = me.patch[event.name];
2647
- fold.state = bare_patch(
2648
- me,
2649
- fold.state,
2650
- reducer(event, fold.state),
2651
- event
2652
- );
2653
- fold.version = event.version;
2654
- fold.event_id = event.id;
2655
- fold.patches++;
2656
- fold.dirty = true;
2657
- } else {
2658
- fold.dirty = true;
2659
- }
2660
- if (++folded_since_flush >= config2.flushEvery) {
2661
- await flush_dirty();
2662
- folded_since_flush = 0;
2663
- }
2664
- }
2665
- await flush_dirty();
2666
- };
2667
- Object.defineProperty(handler, FOLD_RESET, { value: () => cache2.clear() });
2668
- return handler;
2669
- }
2670
-
2671
- // src/internal/defer-config.ts
2672
- import { z } from "zod";
2673
- var DeferDurationSchema = z.object({
2674
- days: z.number().positive().optional(),
2675
- hours: z.number().positive().optional(),
2676
- minutes: z.number().positive().optional()
2677
- }).strict().refine((d) => d.days != null || d.hours != null || d.minutes != null, {
2678
- message: "defer: a duration needs at least one of days, hours, or minutes"
2679
- });
2680
- var DeferWhenSchema = z.object({
2681
- after: DeferDurationSchema.optional(),
2682
- at: z.date().optional()
2683
- }).strict().refine((w) => w.after === void 0 !== (w.at === void 0), {
2684
- message: "defer: specify exactly one of `after` or `at`"
2685
- });
2686
- function duration_ms(d) {
2687
- return (d.days ?? 0) * 864e5 + (d.hours ?? 0) * 36e5 + (d.minutes ?? 0) * 6e4;
2688
- }
2689
- function resolve_defer_at(when, event) {
2690
- const parsed = DeferWhenSchema.parse(when);
2691
- if (parsed.after) return event.created.getTime() + duration_ms(parsed.after);
2692
- return parsed.at.getTime();
2693
- }
2694
- function assert_defer_when(when) {
2695
- DeferWhenSchema.parse(when);
2696
- }
2697
- function make_deferred(handler, schedule) {
2698
- const call = handler;
2699
- const deferred = async (event, stream, app) => {
2700
- const when = typeof schedule === "function" ? schedule(event) : schedule;
2701
- if (Date.now() < resolve_defer_at(when, event)) throw new DeferSignal(when);
2702
- return call(event, stream, app);
2703
- };
2704
- Object.defineProperty(deferred, "name", { value: handler.name });
2705
- return deferred;
2706
- }
2707
-
2708
- // src/internal/reaction-dispatch.ts
2709
- var CloseSignal = class extends Error {
2710
- /**
2711
- * Stream to close. Omitted → the reaction's own lease stream (a self-close).
2712
- * The synthesized autoclose reaction sets it to the aggregate stream, since
2713
- * its lease runs on a synthetic `__autoclose__` target.
2714
- */
2715
- stream;
2716
- /** Optional archive callback to run while the stream is guarded. */
2717
- archive;
2718
- /**
2719
- * Watermark to ack the requesting reaction to before the close runs. The
2720
- * close-cycle safety guard skips a stream whose subscriptions (matched by
2721
- * source) lag the head; the autoclose reaction's `source` is the aggregate,
2722
- * so it must advance its own watermark to the live head id it evaluated
2723
- * against — otherwise it blocks its own close. Defaults to the triggering
2724
- * event id when omitted.
2725
- */
2726
- at;
2727
- /**
2728
- * Windowed close: prune events older than this cutoff behind
2729
- * the closest safe snapshot instead of retiring the stream. Thrown by
2730
- * the autoclose reaction of a `.autocloses({ keep })` state; flows
2731
- * into {@link CloseTarget.before}. Omitted → a full close.
2732
- */
2733
- before;
2734
- constructor(opts) {
2735
- super("reaction requested close");
2736
- this.name = "CloseSignal";
2737
- this.stream = opts?.stream;
2738
- this.archive = opts?.archive;
2739
- this.at = opts?.at;
2740
- this.before = opts?.before;
2741
- }
2742
- };
2743
- function build_handle(deps) {
2744
- const { logger, reaction_scope } = deps;
2745
- return async (lease, payloads) => {
2746
- if (payloads.length === 0) return { lease, handled: 0, acked_at: lease.at };
2747
- const stream = lease.stream;
2748
- const last_index_of = /* @__PURE__ */ new Map();
2749
- for (let i = 0; i < payloads.length; i++)
2750
- last_index_of.set(payloads[i].event.id, i);
2751
- let at = lease.at;
2752
- let handled = 0;
2753
- if (lease.retry > 0)
2754
- logger.warn(
2755
- `Retrying ${stream}@${payloads.at(0).event.id} (${lease.retry}).`
2756
- );
2757
- for (let i = 0; i < payloads.length; i++) {
2758
- const payload = payloads[i];
2759
- const { event, handler } = payload;
2760
- try {
2761
- await reaction_scope.run(
2762
- event,
2763
- () => handler(event, stream, reaction_scope.app)
2764
- );
2765
- if (last_index_of.get(event.id) === i) {
2766
- at = event.id;
2767
- handled++;
2768
- }
2769
- } catch (error) {
2770
- if (error instanceof DeferSignal) {
2771
- let defer;
2772
- try {
2773
- defer = resolve_defer_at(error.when, event);
2774
- } catch (invalid) {
2775
- return finalize(
2776
- lease,
2777
- handled,
2778
- at,
2779
- invalid,
2780
- payload.options,
2781
- logger,
2782
- event.id
2783
- );
2784
- }
2785
- return { lease, handled, acked_at: at, defer };
2786
- }
2787
- if (error instanceof CloseSignal)
2788
- return {
2789
- lease,
2790
- handled: handled + 1,
2791
- // Advance to the live head the handler evaluated against (when
2792
- // provided) so the close-cycle guard sees this reaction caught up.
2793
- acked_at: error.at ?? event.id,
2794
- // Close the signalled stream (the autoclose reaction's aggregate,
2795
- // which differs from its synthetic lease stream); a self-closing
2796
- // user reaction omits it and closes its own lease stream. A
2797
- // carried `before` makes it a windowed close (prune, not retire).
2798
- close: {
2799
- stream: error.stream ?? stream,
2800
- archive: error.archive,
2801
- before: error.before
2802
- }
2803
- };
2804
- return finalize(
2805
- lease,
2806
- handled,
2807
- at,
2808
- error,
2809
- payload.options,
2810
- logger,
2811
- event.id
3045
+ if (event.id > fold.event_id) {
3046
+ const reducer = me.patch[event.name];
3047
+ fold.state = bare_patch(
3048
+ me,
3049
+ fold.state,
3050
+ reducer(event, fold.state),
3051
+ event
2812
3052
  );
3053
+ fold.version = event.version;
3054
+ fold.event_id = event.id;
3055
+ fold.patches++;
3056
+ fold.dirty = true;
3057
+ } else {
3058
+ fold.dirty = true;
3059
+ }
3060
+ if (++folded_since_flush >= config2.flushEvery) {
3061
+ await flush_dirty();
3062
+ folded_since_flush = 0;
2813
3063
  }
2814
3064
  }
2815
- return finalize(lease, handled, at, void 0, payloads[0].options, logger);
2816
- };
2817
- }
2818
- function build_handle_batch(logger) {
2819
- return async (lease, payloads, batchHandler) => {
2820
- const stream = lease.stream;
2821
- const events = [];
2822
- const seen = /* @__PURE__ */ new Set();
2823
- for (const p of payloads) {
2824
- if (seen.has(p.event.id)) continue;
2825
- seen.add(p.event.id);
2826
- events.push(p.event);
2827
- }
2828
- const options = payloads[0].options;
2829
- if (lease.retry > 0)
2830
- logger.warn(`Retrying batch ${stream}@${events[0].id} (${lease.retry}).`);
2831
- try {
2832
- await batchHandler(events, stream);
2833
- return finalize(
2834
- lease,
2835
- events.length,
2836
- events.at(-1).id,
2837
- void 0,
2838
- options,
2839
- logger
2840
- );
2841
- } catch (error) {
2842
- return finalize(lease, 0, lease.at, error, options, logger);
2843
- }
3065
+ await flush_dirty();
2844
3066
  };
3067
+ Object.defineProperty(handler, FOLD_RESET, { value: () => cache2.clear() });
3068
+ return handler;
2845
3069
  }
2846
3070
 
2847
3071
  // src/internal/settle.ts
@@ -3963,217 +4187,6 @@ var Act = class {
3963
4187
  }
3964
4188
  };
3965
4189
 
3966
- // src/internal/autoclose-policy.ts
3967
- import { z as z2 } from "zod";
3968
- var DAY_MS = 864e5;
3969
- var MIN_AFTER_DAYS = 1 / 1440;
3970
- var MIN_KEEP_DAYS = 1;
3971
- function days_after(date, days) {
3972
- return new Date(date.getTime() + days * DAY_MS);
3973
- }
3974
- function days_before_now(days) {
3975
- return new Date(Date.now() - days * DAY_MS);
3976
- }
3977
- var window_schema = (field, min_days, floor) => z2.object({
3978
- days: z2.number({ message: `autocloses: ${field}.days must be a number` }).positive(`autocloses: ${field}.days must be > 0`)
3979
- }).refine((o) => o.days >= min_days, {
3980
- message: `autocloses: ${field} resolves to < ${floor}, which is too short to be a meaningful retention window`
3981
- });
3982
- var AfterSchema = window_schema("after", MIN_AFTER_DAYS, "one minute");
3983
- var KeepSchema = window_schema("keep", MIN_KEEP_DAYS, "one day");
3984
- var IsSchema = z2.union([
3985
- z2.string().min(1, "autocloses: is must be a non-empty event name"),
3986
- z2.array(
3987
- z2.string().min(1, "autocloses: is entries must be non-empty event names")
3988
- ).min(1, "autocloses: is must include at least one event name").readonly()
3989
- ]);
3990
- var ReachesSchema = z2.number({ message: "autocloses: reaches must be a number" }).int("autocloses: reaches must be an integer").min(1, "autocloses: reaches must be >= 1");
3991
- var OrBlockSchema = z2.object({
3992
- after: AfterSchema.optional(),
3993
- is: IsSchema.optional(),
3994
- reaches: ReachesSchema.optional()
3995
- }).strict().refine(
3996
- (o) => o.after !== void 0 || o.is !== void 0 || o.reaches !== void 0,
3997
- {
3998
- message: "autocloses: `or` block must include at least one of after / is / reaches"
3999
- }
4000
- );
4001
- var AutoclosePolicySchema = z2.object({
4002
- after: AfterSchema.optional(),
4003
- is: IsSchema.optional(),
4004
- reaches: ReachesSchema.optional(),
4005
- or: OrBlockSchema.optional(),
4006
- keep: KeepSchema.optional()
4007
- }).strict().refine(
4008
- (o) => o.after !== void 0 || o.is !== void 0 || o.reaches !== void 0 || o.or !== void 0 || o.keep !== void 0,
4009
- {
4010
- message: "autocloses: at least one of after / is / reaches / or / keep must be specified \u2014 empty `{}` is a misconfiguration"
4011
- }
4012
- );
4013
- function compile_after(after) {
4014
- return (_stream, head) => days_after(head.created, after.days) <= /* @__PURE__ */ new Date();
4015
- }
4016
- function compile_is(is) {
4017
- const set = new Set(typeof is === "string" ? [is] : is);
4018
- return (_stream, head) => set.has(head.name);
4019
- }
4020
- function compile_reaches(reaches) {
4021
- return (_stream, _head, count) => count >= reaches;
4022
- }
4023
- function policy_min_after_days(options) {
4024
- const parsed = AutoclosePolicySchema.parse(options);
4025
- const windows = [];
4026
- if (parsed.after) windows.push(parsed.after.days);
4027
- if (parsed.or?.after) windows.push(parsed.or.after.days);
4028
- return windows.length ? Math.min(...windows) : void 0;
4029
- }
4030
- function policy_after_windows(options) {
4031
- const parsed = AutoclosePolicySchema.parse(options);
4032
- return [parsed.after, parsed.or?.after].flatMap((w) => w ? [w.days] : []);
4033
- }
4034
- function policy_keep_days(options) {
4035
- const parsed = AutoclosePolicySchema.parse(options);
4036
- return parsed.keep?.days;
4037
- }
4038
- function compile_autoclose_policy(options) {
4039
- const parsed = AutoclosePolicySchema.parse(options);
4040
- const and_preds = [];
4041
- if (parsed.after) and_preds.push(compile_after(parsed.after));
4042
- if (parsed.is) and_preds.push(compile_is(parsed.is));
4043
- if (parsed.reaches) and_preds.push(compile_reaches(parsed.reaches));
4044
- const or_preds = [];
4045
- if (parsed.or) {
4046
- if (parsed.or.after) or_preds.push(compile_after(parsed.or.after));
4047
- if (parsed.or.is) or_preds.push(compile_is(parsed.or.is));
4048
- if (parsed.or.reaches) or_preds.push(compile_reaches(parsed.or.reaches));
4049
- }
4050
- return (stream, head, count) => {
4051
- if (and_preds.length > 0 && and_preds.every((p) => p(stream, head, count))) {
4052
- return true;
4053
- }
4054
- if (or_preds.some((p) => p(stream, head, count))) {
4055
- return true;
4056
- }
4057
- return false;
4058
- };
4059
- }
4060
-
4061
- // src/internal/autoclose-window.ts
4062
- function hour_in_zone(now, timeZone) {
4063
- const parts = new Intl.DateTimeFormat("en-US", {
4064
- timeZone,
4065
- hour: "2-digit",
4066
- hourCycle: "h23"
4067
- }).formatToParts(now);
4068
- return Number(parts.find((p) => p.type === "hour")?.value);
4069
- }
4070
- function hour_in_range(hour, start, end) {
4071
- return start < end ? hour >= start && hour < end : hour >= start || hour < end;
4072
- }
4073
- function is_dst_gap_open(now, timeZone, start) {
4074
- const hour = hour_in_zone(now, timeZone);
4075
- if (hour <= start) return false;
4076
- const prev = hour_in_zone(new Date(now.getTime() - 36e5), timeZone);
4077
- return prev === start - 1 && hour === start + 1;
4078
- }
4079
- function in_autoclose_window(window, now) {
4080
- if (!window) return true;
4081
- const hour = hour_in_zone(now, window.timeZone);
4082
- return hour_in_range(hour, window.start, window.end) || is_dst_gap_open(now, window.timeZone, window.start);
4083
- }
4084
- function next_window_open(window, now) {
4085
- const start_ms = now.getTime();
4086
- for (let h = 0; h <= 48; h++) {
4087
- const candidate = new Date(start_ms + h * 36e5);
4088
- if (hour_in_zone(candidate, window.timeZone) === window.start)
4089
- return candidate;
4090
- const boundary = new Date(
4091
- candidate.getTime() - candidate.getTime() % 36e5
4092
- );
4093
- if (boundary.getTime() >= start_ms && is_dst_gap_open(boundary, window.timeZone, window.start))
4094
- return boundary;
4095
- }
4096
- return new Date(start_ms + 864e5);
4097
- }
4098
-
4099
- // src/internal/autoclose-reaction.ts
4100
- var AUTOCLOSE_TARGET_PREFIX = "__autoclose__:";
4101
- function synthesize_autoclose_reactions(registry, states, read_window) {
4102
- for (const st of states.values()) {
4103
- const predicate = st.autoclose;
4104
- if (!predicate) continue;
4105
- const after_windows = st.autoclose_after_windows;
4106
- const keep_days = st.autoclose_keep_days;
4107
- const archiver = st.archive;
4108
- const reaction = {
4109
- // Run on a SYNTHETIC stream — `source` is the aggregate, `target` is a
4110
- // per-aggregate `__autoclose__` key — so the autoclose reaction never
4111
- // shares a watermark with the aggregate's own reactions. A shared
4112
- // watermark would let autoclose's defer short-circuit the aggregate's
4113
- // other reactions (the "a defer affects all reactions on a stream"
4114
- // hazard). The close still targets the aggregate (`source`).
4115
- // A stream name with a regex metacharacter would read as a pattern, and a
4116
- // store may refuse it at subscribe, stopping every reaction. Such a stream
4117
- // has no autoclose: `app.close` still closes it.
4118
- resolver: (e) => is_literal_source(e.stream) ? {
4119
- target: `${AUTOCLOSE_TARGET_PREFIX}${e.stream}`,
4120
- source: e.stream
4121
- } : void 0,
4122
- // Never block on autoclose: a transient query/store error should retry,
4123
- // not quarantine the synthetic stream.
4124
- options: { blockOnError: false, maxRetries: DEFAULT_MAX_RETRIES },
4125
- handler: async (event) => {
4126
- const aggregate = event.stream;
4127
- const window = read_window();
4128
- if (!in_autoclose_window(window, /* @__PURE__ */ new Date()))
4129
- throw new DeferSignal({ at: next_window_open(window, /* @__PURE__ */ new Date()) });
4130
- const stats = await store().query_stats([aggregate], {
4131
- count: true,
4132
- tail: keep_days !== void 0 ? true : void 0,
4133
- exclude: [TOMBSTONE_EVENT, SNAP_EVENT]
4134
- });
4135
- const entry = stats.get(aggregate);
4136
- if (!entry) return;
4137
- const head = entry.head;
4138
- if (predicate(aggregate, head, entry.count))
4139
- throw new CloseSignal({
4140
- stream: aggregate,
4141
- archive: archiver ? () => archiver(aggregate, head) : void 0,
4142
- // Ack this reaction's own watermark to the live head so the
4143
- // close-cycle guard (which matches subscriptions by source =
4144
- // aggregate) sees it caught up instead of blocking its own close.
4145
- at: head.id
4146
- });
4147
- if (keep_days !== void 0) {
4148
- const cutoff = days_before_now(keep_days);
4149
- if (entry.tail.created < cutoff)
4150
- throw new CloseSignal({
4151
- stream: aggregate,
4152
- before: cutoff,
4153
- archive: archiver ? () => archiver(aggregate, head, cutoff) : void 0,
4154
- at: head.id
4155
- });
4156
- }
4157
- const dues = [];
4158
- for (const days of after_windows)
4159
- dues.push(days_after(head.created, days));
4160
- if (keep_days !== void 0)
4161
- dues.push(days_after(entry.tail.created, keep_days));
4162
- const future = dues.map((d) => d.getTime()).filter((t) => t > Date.now());
4163
- if (future.length)
4164
- throw new DeferSignal({ at: new Date(Math.min(...future)) });
4165
- }
4166
- };
4167
- const key = `__autoclose_${st.name}`;
4168
- for (const event_name of Object.keys(st.events)) {
4169
- registry.events[event_name]?.reactions.set(
4170
- key,
4171
- reaction
4172
- );
4173
- }
4174
- }
4175
- }
4176
-
4177
4190
  // src/builders/merge.ts
4178
4191
  import { ZodObject } from "zod";
4179
4192
  function base_type_name(zodType) {
@@ -4433,25 +4446,47 @@ import { z as z4 } from "zod";
4433
4446
 
4434
4447
  // src/internal/date-reviver.ts
4435
4448
  import { z as z3 } from "zod";
4436
- function variant_schema(schema) {
4449
+ function variant_schema(schema, walk) {
4437
4450
  const shape = def_of(schema)?.shape;
4438
4451
  if (!shape) {
4439
- const dates = date_reviver_schema(schema);
4452
+ const dates = walk(schema);
4440
4453
  return { schema: dates ?? schema, dated: !!dates };
4441
4454
  }
4442
4455
  const next = {};
4443
4456
  let dated = false;
4444
4457
  for (const [key, field] of Object.entries(shape)) {
4445
- const dates = date_reviver_schema(field);
4458
+ const dates = walk(field);
4446
4459
  if (dates) dated = true;
4447
4460
  next[key] = (dates ?? field).optional();
4448
4461
  }
4449
4462
  return { schema: z3.looseObject(next), dated };
4450
4463
  }
4451
4464
  function date_reviver_schema(schema) {
4465
+ let recursive = false;
4466
+ const pass = (tie) => {
4467
+ const done = /* @__PURE__ */ new Map();
4468
+ const active = /* @__PURE__ */ new Set();
4469
+ const walk = (node) => {
4470
+ if (done.has(node)) return done.get(node);
4471
+ if (active.has(node)) {
4472
+ recursive = true;
4473
+ return tie ? z3.lazy(() => done.get(node)) : void 0;
4474
+ }
4475
+ active.add(node);
4476
+ const result = build(node, walk);
4477
+ active.delete(node);
4478
+ done.set(node, result);
4479
+ return result;
4480
+ };
4481
+ return walk(schema);
4482
+ };
4483
+ const first = pass(false);
4484
+ return first && recursive ? pass(true) : first;
4485
+ }
4486
+ function build(schema, walk) {
4452
4487
  const def = def_of(schema);
4453
4488
  if (!def) return void 0;
4454
- const inner = () => date_reviver_schema(def.innerType);
4489
+ const inner = () => walk(def.innerType);
4455
4490
  switch (def.type) {
4456
4491
  case "date":
4457
4492
  return z3.coerce.date();
@@ -4460,31 +4495,40 @@ function date_reviver_schema(schema) {
4460
4495
  if (!shape) return void 0;
4461
4496
  const dated = {};
4462
4497
  for (const [key, field] of Object.entries(shape)) {
4463
- const dates = date_reviver_schema(field);
4498
+ const dates = walk(field);
4464
4499
  if (dates) dated[key] = dates.optional();
4465
4500
  }
4466
4501
  return Object.keys(dated).length ? z3.looseObject(dated) : void 0;
4467
4502
  }
4468
4503
  case "array": {
4469
- const element = date_reviver_schema(def.element);
4504
+ const element = walk(def.element);
4470
4505
  return element && z3.array(element);
4471
4506
  }
4472
4507
  case "tuple": {
4473
- const items = def.items.map((i) => date_reviver_schema(i));
4508
+ const items = def.items.map((i) => walk(i));
4474
4509
  return items.some(Boolean) ? z3.tuple(items.map((i) => i ?? z3.unknown())) : void 0;
4475
4510
  }
4476
4511
  case "record": {
4477
- const value = date_reviver_schema(def.valueType);
4512
+ const value = walk(def.valueType);
4478
4513
  return value && z3.record(z3.string(), value);
4479
4514
  }
4480
4515
  case "union": {
4481
- const variants = def.options.map(variant_schema);
4516
+ const variants = def.options.map(
4517
+ (o) => variant_schema(o, walk)
4518
+ );
4482
4519
  return variants.some((v) => v.dated) ? z3.union(variants.map((v) => v.schema)) : void 0;
4483
4520
  }
4484
4521
  case "nullable":
4485
4522
  return inner()?.nullable();
4486
4523
  case "pipe":
4487
- return date_reviver_schema(def.out);
4524
+ return walk(def.out);
4525
+ case "lazy":
4526
+ return walk(def.getter());
4527
+ case "intersection": {
4528
+ const left = walk(def.left);
4529
+ const right = walk(def.right);
4530
+ return left && right ? left.pipe(right) : left ?? right;
4531
+ }
4488
4532
  default:
4489
4533
  return inner_of(def) ? inner() : void 0;
4490
4534
  }
@@ -5295,6 +5339,7 @@ export {
5295
5339
  CsvFile,
5296
5340
  DEFAULT_LANE,
5297
5341
  DEFAULT_MAX_SUBSCRIBED_STREAMS,
5342
+ DEFAULT_QUERY_STREAMS_LIMIT,
5298
5343
  DEFAULT_SETTLE_DEBOUNCE_MS,
5299
5344
  DeferSignal,
5300
5345
  Environments,
@@ -5326,6 +5371,7 @@ export {
5326
5371
  dispose,
5327
5372
  disposeAndExit,
5328
5373
  extend,
5374
+ fair_slots,
5329
5375
  is_literal_source,
5330
5376
  log,
5331
5377
  pii_fields,