@ontrails/core 1.0.0-beta.4 → 1.0.0-beta.42

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 (247) hide show
  1. package/CHANGELOG.md +414 -12
  2. package/README.md +112 -28
  3. package/package.json +11 -1
  4. package/src/activation-provenance.ts +116 -0
  5. package/src/activation-source-compatibility.ts +430 -0
  6. package/src/activation-source-projection.ts +227 -0
  7. package/src/activation-source.ts +93 -0
  8. package/src/blob-ref.ts +51 -0
  9. package/src/branded.ts +1 -1
  10. package/src/compose-batch.ts +69 -0
  11. package/src/compose-schema.ts +36 -0
  12. package/src/context.ts +59 -11
  13. package/src/derive.ts +271 -19
  14. package/src/detours.ts +8 -0
  15. package/src/diagnostics.ts +21 -0
  16. package/src/draft.ts +350 -0
  17. package/src/entity.ts +346 -0
  18. package/src/error-projection.ts +51 -0
  19. package/src/errors.ts +335 -48
  20. package/src/execute.ts +1577 -0
  21. package/src/fire.ts +1172 -0
  22. package/src/glob.ts +81 -0
  23. package/src/index.ts +568 -32
  24. package/src/internal/fork-ctx.ts +69 -0
  25. package/src/layer-projection.ts +193 -0
  26. package/src/layer.ts +43 -6
  27. package/src/observe.ts +361 -0
  28. package/src/path-scope.ts +66 -0
  29. package/src/path-security.ts +11 -3
  30. package/src/permits.ts +12 -0
  31. package/src/queue.ts +163 -0
  32. package/src/redaction/patterns.ts +6 -3
  33. package/src/resilience.ts +11 -11
  34. package/src/resource-config.ts +804 -0
  35. package/src/resource.ts +194 -0
  36. package/src/result.ts +18 -0
  37. package/src/run.ts +76 -0
  38. package/src/runtime-builtins.ts +69 -0
  39. package/src/schedule-runtime.ts +689 -0
  40. package/src/schedule.ts +326 -0
  41. package/src/serialization.ts +92 -55
  42. package/src/sha256.ts +136 -0
  43. package/src/signal-diagnostics.ts +633 -0
  44. package/src/signal-ref.ts +111 -0
  45. package/src/signal.ts +104 -0
  46. package/src/store/accessor-protocol.ts +56 -0
  47. package/src/store/index.ts +4 -0
  48. package/src/structured-examples.ts +248 -0
  49. package/src/surface-derivation.ts +91 -0
  50. package/src/surface-filter.ts +101 -0
  51. package/src/surface-overlay.ts +694 -0
  52. package/src/surface-versioning.ts +42 -0
  53. package/src/topo.ts +762 -38
  54. package/src/tracing.ts +346 -0
  55. package/src/trail-id-glob.ts +15 -0
  56. package/src/trail.ts +1244 -34
  57. package/src/trails/derive-trail.ts +835 -0
  58. package/src/trails/index.ts +9 -0
  59. package/src/trails/ingest.ts +152 -0
  60. package/src/trails-db.ts +212 -0
  61. package/src/transport-error-map.ts +174 -0
  62. package/src/type-utils.ts +87 -0
  63. package/src/types.ts +254 -12
  64. package/src/validate-established-topo.ts +73 -0
  65. package/src/validate-topo.ts +569 -55
  66. package/src/validation.ts +152 -4
  67. package/src/version-marker.ts +716 -0
  68. package/src/version-resolution.ts +308 -0
  69. package/src/version-runtime.ts +120 -0
  70. package/src/webhook.ts +461 -0
  71. package/src/workspace.ts +183 -16
  72. package/src/zod-wrappers.ts +72 -0
  73. package/.turbo/turbo-build.log +0 -1
  74. package/.turbo/turbo-lint.log +0 -3
  75. package/.turbo/turbo-typecheck.log +0 -1
  76. package/dist/adapters.d.ts +0 -39
  77. package/dist/adapters.d.ts.map +0 -1
  78. package/dist/adapters.js +0 -2
  79. package/dist/adapters.js.map +0 -1
  80. package/dist/blob-ref.d.ts +0 -20
  81. package/dist/blob-ref.d.ts.map +0 -1
  82. package/dist/blob-ref.js +0 -22
  83. package/dist/blob-ref.js.map +0 -1
  84. package/dist/branded.d.ts +0 -36
  85. package/dist/branded.d.ts.map +0 -1
  86. package/dist/branded.js +0 -89
  87. package/dist/branded.js.map +0 -1
  88. package/dist/collections.d.ts +0 -31
  89. package/dist/collections.d.ts.map +0 -1
  90. package/dist/collections.js +0 -60
  91. package/dist/collections.js.map +0 -1
  92. package/dist/context.d.ts +0 -10
  93. package/dist/context.d.ts.map +0 -1
  94. package/dist/context.js +0 -15
  95. package/dist/context.js.map +0 -1
  96. package/dist/derive.d.ts +0 -33
  97. package/dist/derive.d.ts.map +0 -1
  98. package/dist/derive.js +0 -125
  99. package/dist/derive.js.map +0 -1
  100. package/dist/errors.d.ts +0 -83
  101. package/dist/errors.d.ts.map +0 -1
  102. package/dist/errors.js +0 -142
  103. package/dist/errors.js.map +0 -1
  104. package/dist/event.d.ts +0 -45
  105. package/dist/event.d.ts.map +0 -1
  106. package/dist/event.js +0 -17
  107. package/dist/event.js.map +0 -1
  108. package/dist/fetch.d.ts +0 -15
  109. package/dist/fetch.d.ts.map +0 -1
  110. package/dist/fetch.js +0 -102
  111. package/dist/fetch.js.map +0 -1
  112. package/dist/guards.d.ts +0 -17
  113. package/dist/guards.d.ts.map +0 -1
  114. package/dist/guards.js +0 -25
  115. package/dist/guards.js.map +0 -1
  116. package/dist/health.d.ts +0 -18
  117. package/dist/health.d.ts.map +0 -1
  118. package/dist/health.js +0 -5
  119. package/dist/health.js.map +0 -1
  120. package/dist/index.d.ts +0 -34
  121. package/dist/index.d.ts.map +0 -1
  122. package/dist/index.js +0 -38
  123. package/dist/index.js.map +0 -1
  124. package/dist/job.d.ts +0 -24
  125. package/dist/job.d.ts.map +0 -1
  126. package/dist/job.js +0 -17
  127. package/dist/job.js.map +0 -1
  128. package/dist/layer.d.ts +0 -17
  129. package/dist/layer.d.ts.map +0 -1
  130. package/dist/layer.js +0 -21
  131. package/dist/layer.js.map +0 -1
  132. package/dist/path-security.d.ts +0 -28
  133. package/dist/path-security.d.ts.map +0 -1
  134. package/dist/path-security.js +0 -63
  135. package/dist/path-security.js.map +0 -1
  136. package/dist/patterns/bulk.d.ts +0 -15
  137. package/dist/patterns/bulk.d.ts.map +0 -1
  138. package/dist/patterns/bulk.js +0 -14
  139. package/dist/patterns/bulk.js.map +0 -1
  140. package/dist/patterns/change.d.ts +0 -10
  141. package/dist/patterns/change.d.ts.map +0 -1
  142. package/dist/patterns/change.js +0 -10
  143. package/dist/patterns/change.js.map +0 -1
  144. package/dist/patterns/date-range.d.ts +0 -10
  145. package/dist/patterns/date-range.d.ts.map +0 -1
  146. package/dist/patterns/date-range.js +0 -10
  147. package/dist/patterns/date-range.js.map +0 -1
  148. package/dist/patterns/index.d.ts +0 -9
  149. package/dist/patterns/index.d.ts.map +0 -1
  150. package/dist/patterns/index.js +0 -9
  151. package/dist/patterns/index.js.map +0 -1
  152. package/dist/patterns/pagination.d.ts +0 -18
  153. package/dist/patterns/pagination.d.ts.map +0 -1
  154. package/dist/patterns/pagination.js +0 -18
  155. package/dist/patterns/pagination.js.map +0 -1
  156. package/dist/patterns/progress.d.ts +0 -11
  157. package/dist/patterns/progress.d.ts.map +0 -1
  158. package/dist/patterns/progress.js +0 -11
  159. package/dist/patterns/progress.js.map +0 -1
  160. package/dist/patterns/sorting.d.ts +0 -13
  161. package/dist/patterns/sorting.d.ts.map +0 -1
  162. package/dist/patterns/sorting.js +0 -10
  163. package/dist/patterns/sorting.js.map +0 -1
  164. package/dist/patterns/status.d.ts +0 -15
  165. package/dist/patterns/status.d.ts.map +0 -1
  166. package/dist/patterns/status.js +0 -9
  167. package/dist/patterns/status.js.map +0 -1
  168. package/dist/patterns/timestamps.d.ts +0 -10
  169. package/dist/patterns/timestamps.d.ts.map +0 -1
  170. package/dist/patterns/timestamps.js +0 -10
  171. package/dist/patterns/timestamps.js.map +0 -1
  172. package/dist/redaction/index.d.ts +0 -4
  173. package/dist/redaction/index.d.ts.map +0 -1
  174. package/dist/redaction/index.js +0 -3
  175. package/dist/redaction/index.js.map +0 -1
  176. package/dist/redaction/patterns.d.ts +0 -9
  177. package/dist/redaction/patterns.d.ts.map +0 -1
  178. package/dist/redaction/patterns.js +0 -39
  179. package/dist/redaction/patterns.js.map +0 -1
  180. package/dist/redaction/redactor.d.ts +0 -27
  181. package/dist/redaction/redactor.d.ts.map +0 -1
  182. package/dist/redaction/redactor.js +0 -89
  183. package/dist/redaction/redactor.js.map +0 -1
  184. package/dist/resilience.d.ts +0 -34
  185. package/dist/resilience.d.ts.map +0 -1
  186. package/dist/resilience.js +0 -164
  187. package/dist/resilience.js.map +0 -1
  188. package/dist/result.d.ts +0 -57
  189. package/dist/result.d.ts.map +0 -1
  190. package/dist/result.js +0 -156
  191. package/dist/result.js.map +0 -1
  192. package/dist/serialization.d.ts +0 -27
  193. package/dist/serialization.d.ts.map +0 -1
  194. package/dist/serialization.js +0 -153
  195. package/dist/serialization.js.map +0 -1
  196. package/dist/topo.d.ts +0 -16
  197. package/dist/topo.d.ts.map +0 -1
  198. package/dist/topo.js +0 -66
  199. package/dist/topo.js.map +0 -1
  200. package/dist/trail.d.ts +0 -89
  201. package/dist/trail.d.ts.map +0 -1
  202. package/dist/trail.js +0 -18
  203. package/dist/trail.js.map +0 -1
  204. package/dist/types.d.ts +0 -46
  205. package/dist/types.d.ts.map +0 -1
  206. package/dist/types.js +0 -2
  207. package/dist/types.js.map +0 -1
  208. package/dist/validate-topo.d.ts +0 -24
  209. package/dist/validate-topo.d.ts.map +0 -1
  210. package/dist/validate-topo.js +0 -158
  211. package/dist/validate-topo.js.map +0 -1
  212. package/dist/validation.d.ts +0 -27
  213. package/dist/validation.d.ts.map +0 -1
  214. package/dist/validation.js +0 -134
  215. package/dist/validation.js.map +0 -1
  216. package/dist/workspace.d.ts +0 -25
  217. package/dist/workspace.d.ts.map +0 -1
  218. package/dist/workspace.js +0 -57
  219. package/dist/workspace.js.map +0 -1
  220. package/src/__tests__/blob-ref.test.ts +0 -103
  221. package/src/__tests__/branded.test.ts +0 -148
  222. package/src/__tests__/collections.test.ts +0 -126
  223. package/src/__tests__/context.test.ts +0 -66
  224. package/src/__tests__/derive.test.ts +0 -203
  225. package/src/__tests__/errors.test.ts +0 -309
  226. package/src/__tests__/event.test.ts +0 -82
  227. package/src/__tests__/fetch.test.ts +0 -217
  228. package/src/__tests__/guards.test.ts +0 -102
  229. package/src/__tests__/job.test.ts +0 -98
  230. package/src/__tests__/layer.test.ts +0 -212
  231. package/src/__tests__/path-security.test.ts +0 -114
  232. package/src/__tests__/patterns.test.ts +0 -273
  233. package/src/__tests__/redaction.test.ts +0 -244
  234. package/src/__tests__/resilience.test.ts +0 -246
  235. package/src/__tests__/result.test.ts +0 -155
  236. package/src/__tests__/serialization.test.ts +0 -401
  237. package/src/__tests__/topo.test.ts +0 -181
  238. package/src/__tests__/trail.test.ts +0 -217
  239. package/src/__tests__/validate-topo.test.ts +0 -278
  240. package/src/__tests__/validation.test.ts +0 -283
  241. package/src/__tests__/workspace.test.ts +0 -183
  242. package/src/adapters.ts +0 -68
  243. package/src/event.ts +0 -77
  244. package/src/health.ts +0 -23
  245. package/src/job.ts +0 -20
  246. package/tsconfig.json +0 -9
  247. package/tsconfig.tsbuildinfo +0 -1
@@ -1,89 +0,0 @@
1
- /**
2
- * Redactor — strips sensitive data from strings and objects.
3
- *
4
- * @example
5
- * ```ts
6
- * const r = createRedactor();
7
- * r.redact("token: Bearer abc123"); // "token: [REDACTED]"
8
- * r.redactObject({ password: "s3cret" }); // { password: "[REDACTED]" }
9
- * ```
10
- */
11
- import { DEFAULT_PATTERNS, DEFAULT_SENSITIVE_KEYS } from './patterns.js';
12
- // ---------------------------------------------------------------------------
13
- // Helpers
14
- // ---------------------------------------------------------------------------
15
- const resetPatterns = (patterns) => {
16
- for (const p of patterns) {
17
- p.lastIndex = 0;
18
- }
19
- };
20
- const applyPatterns = (value, patterns, replacement) => {
21
- let result = value;
22
- for (const pattern of patterns) {
23
- // Reset in case the regex is stateful (global flag)
24
- pattern.lastIndex = 0;
25
- result = result.replace(pattern, replacement);
26
- }
27
- return result;
28
- };
29
- const isSensitiveKey = (key, sensitiveKeysLower) => key !== undefined && sensitiveKeysLower.has(key.toLowerCase());
30
- const mapObjectValues = (value, visit) => {
31
- const result = {};
32
- for (const [key, item] of Object.entries(value)) {
33
- result[key] = visit(item, key);
34
- }
35
- return result;
36
- };
37
- /** Track and guard against circular references in object graphs. */
38
- const trackOrCircular = (value, seen) => {
39
- if (seen.has(value)) {
40
- return '[Circular]';
41
- }
42
- seen.add(value);
43
- return null;
44
- };
45
- /* oxlint-disable no-use-before-define -- mutual recursion between redactCompound and deepRedact */
46
- /** Redact a compound value (array or object), delegating scalars back to deepRedact. */
47
- const redactCompound = (value, sensitiveKeysLower, patterns, replacement, seen) => {
48
- const circular = trackOrCircular(value, seen);
49
- if (circular) {
50
- return circular;
51
- }
52
- if (Array.isArray(value)) {
53
- return value.map((item) => deepRedact(item, sensitiveKeysLower, patterns, replacement, undefined, seen));
54
- }
55
- return mapObjectValues(value, (item, key) => deepRedact(item, sensitiveKeysLower, patterns, replacement, key, seen));
56
- };
57
- const deepRedact = (value, sensitiveKeysLower, patterns, replacement, currentKey, seen = new WeakSet()) => {
58
- if (isSensitiveKey(currentKey, sensitiveKeysLower)) {
59
- return replacement;
60
- }
61
- if (typeof value === 'string') {
62
- return applyPatterns(value, patterns, replacement);
63
- }
64
- if (value !== null && typeof value === 'object') {
65
- return redactCompound(value, sensitiveKeysLower, patterns, replacement, seen);
66
- }
67
- return value;
68
- };
69
- /* oxlint-enable no-use-before-define */
70
- // ---------------------------------------------------------------------------
71
- // Factory
72
- // ---------------------------------------------------------------------------
73
- export const createRedactor = (config) => {
74
- const patterns = config?.patterns ?? DEFAULT_PATTERNS;
75
- const sensitiveKeys = config?.sensitiveKeys ?? DEFAULT_SENSITIVE_KEYS;
76
- const replacement = config?.replacement ?? '[REDACTED]';
77
- const sensitiveKeysLower = new Set(sensitiveKeys.map((k) => k.toLowerCase()));
78
- return {
79
- redact(value) {
80
- resetPatterns(patterns);
81
- return applyPatterns(value, patterns, replacement);
82
- },
83
- redactObject(obj) {
84
- resetPatterns(patterns);
85
- return deepRedact(obj, sensitiveKeysLower, patterns, replacement);
86
- },
87
- };
88
- };
89
- //# sourceMappingURL=redactor.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"redactor.js","sourceRoot":"","sources":["../../src/redaction/redactor.ts"],"names":[],"mappings":"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"}
@@ -1,34 +0,0 @@
1
- /**
2
- * Resilience utilities for @ontrails/core
3
- *
4
- * Retry with exponential backoff and timeout wrappers,
5
- * all returning Result types.
6
- */
7
- import { Result } from './result.js';
8
- export interface RetryOptions {
9
- /** Maximum number of attempts (default: 3) */
10
- readonly maxAttempts?: number | undefined;
11
- /** Base delay in ms before first retry (default: 1000) */
12
- readonly baseDelay?: number | undefined;
13
- /** Maximum delay in ms (default: 30000) */
14
- readonly maxDelay?: number | undefined;
15
- /** Exponential backoff factor (default: 2) */
16
- readonly backoffFactor?: number | undefined;
17
- /** Custom predicate — defaults to isRetryable from error taxonomy */
18
- readonly shouldRetry?: ((error: Error) => boolean) | undefined;
19
- /** AbortSignal for cancellation */
20
- readonly signal?: AbortSignal | undefined;
21
- }
22
- /** Default retry predicate using the error taxonomy. */
23
- export declare const shouldRetry: (error: Error) => boolean;
24
- /** Compute exponential backoff delay with full jitter. */
25
- export declare const getBackoffDelay: (attempt: number, options?: Pick<RetryOptions, "baseDelay" | "maxDelay" | "backoffFactor">) => number;
26
- export declare const retry: <T>(fn: () => Promise<Result<T, Error>>, options?: RetryOptions) => Promise<Result<T, Error>>;
27
- /**
28
- * Run an async Result-returning function with a timeout.
29
- *
30
- * If the timeout fires first, returns a TimeoutError result.
31
- * Also respects an external AbortSignal.
32
- */
33
- export declare const withTimeout: <T>(fn: () => Promise<Result<T, Error>>, ms: number, signal?: AbortSignal) => Promise<Result<T, Error>>;
34
- //# sourceMappingURL=resilience.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"resilience.d.ts","sourceRoot":"","sources":["../src/resilience.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAMrC,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,8CAA8C;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,qEAAqE;IACrE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/D,mCAAmC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAgCD,wDAAwD;AACxD,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,KAAG,OAA6B,CAAC;AAMzE,0DAA0D;AAC1D,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,EACf,UAAU,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,UAAU,GAAG,eAAe,CAAC,KACvE,MAQF,CAAC;AA8CF,eAAO,MAAM,KAAK,GAAU,CAAC,EAC3B,IAAI,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EACnC,UAAU,YAAY,KACrB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAsB1B,CAAC;AAMF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAC3B,IAAI,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EACnC,IAAI,MAAM,EACV,SAAS,WAAW,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAoE1B,CAAC"}
@@ -1,164 +0,0 @@
1
- /**
2
- * Resilience utilities for @ontrails/core
3
- *
4
- * Retry with exponential backoff and timeout wrappers,
5
- * all returning Result types.
6
- */
7
- import { CancelledError, TimeoutError, isRetryable } from './errors.js';
8
- import { Result } from './result.js';
9
- // ---------------------------------------------------------------------------
10
- // Helpers (defined before usage)
11
- // ---------------------------------------------------------------------------
12
- const sleep = (ms, signal) =>
13
- // oxlint-disable-next-line avoid-new -- Promise constructor needed for setTimeout-based sleep
14
- new Promise((resolve) => {
15
- if (signal?.aborted) {
16
- resolve();
17
- return;
18
- }
19
- let settled = false;
20
- const done = () => {
21
- if (!settled) {
22
- settled = true;
23
- resolve();
24
- }
25
- };
26
- const timer = setTimeout(done, ms);
27
- const onAbort = () => {
28
- clearTimeout(timer);
29
- done();
30
- };
31
- signal?.addEventListener('abort', onAbort, { once: true });
32
- });
33
- // ---------------------------------------------------------------------------
34
- // shouldRetry (default)
35
- // ---------------------------------------------------------------------------
36
- /** Default retry predicate using the error taxonomy. */
37
- export const shouldRetry = (error) => isRetryable(error);
38
- // ---------------------------------------------------------------------------
39
- // getBackoffDelay
40
- // ---------------------------------------------------------------------------
41
- /** Compute exponential backoff delay with full jitter. */
42
- export const getBackoffDelay = (attempt, options) => {
43
- const base = options?.baseDelay ?? 1000;
44
- const max = options?.maxDelay ?? 30_000;
45
- const factor = options?.backoffFactor ?? 2;
46
- const exponential = base * factor ** attempt;
47
- const capped = Math.min(exponential, max);
48
- // Full jitter: random value in [0, capped]
49
- return Math.floor(Math.random() * capped);
50
- };
51
- // ---------------------------------------------------------------------------
52
- // retry
53
- // ---------------------------------------------------------------------------
54
- /**
55
- * Retry an async function that returns a Result.
56
- *
57
- * On each failure, checks whether the error is retryable and whether the
58
- * attempt budget remains. Applies exponential backoff with jitter between
59
- * retries.
60
- */
61
- /** Attempt a single retry iteration. Returns the result to stop, or undefined to continue. */
62
- const tryAttempt = async (fn, attempt, maxAttempts, retryPredicate, options) => {
63
- const result = await fn();
64
- if (result.isOk()) {
65
- return { done: true, result };
66
- }
67
- const isLast = attempt === maxAttempts - 1;
68
- if (isLast || !retryPredicate(result.error)) {
69
- return { done: true, result };
70
- }
71
- const delay = getBackoffDelay(attempt, options);
72
- if (delay > 0) {
73
- await sleep(delay, options?.signal);
74
- }
75
- return { done: false, result };
76
- };
77
- /** Resolve retry options to concrete values. */
78
- const resolveRetryOptions = (options) => ({
79
- maxAttempts: options?.maxAttempts ?? 3,
80
- retryPredicate: options?.shouldRetry ?? shouldRetry,
81
- signal: options?.signal,
82
- });
83
- export const retry = async (fn, options) => {
84
- const { maxAttempts, retryPredicate, signal } = resolveRetryOptions(options);
85
- let lastResult;
86
- for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
87
- if (signal?.aborted) {
88
- return Result.err(new CancelledError('Retry cancelled'));
89
- }
90
- const outcome = await tryAttempt(fn, attempt, maxAttempts, retryPredicate, options);
91
- lastResult = outcome.result;
92
- if (outcome.done) {
93
- return outcome.result;
94
- }
95
- }
96
- return lastResult ?? Result.err(new CancelledError('Retry exhausted'));
97
- };
98
- // ---------------------------------------------------------------------------
99
- // withTimeout
100
- // ---------------------------------------------------------------------------
101
- /**
102
- * Run an async Result-returning function with a timeout.
103
- *
104
- * If the timeout fires first, returns a TimeoutError result.
105
- * Also respects an external AbortSignal.
106
- */
107
- export const withTimeout = (fn, ms, signal) => {
108
- if (signal?.aborted) {
109
- return Promise.resolve(Result.err(new CancelledError('Already cancelled')));
110
- }
111
- // oxlint-disable-next-line avoid-new, promise/no-multiple-resolved -- Promise constructor needed for timeout race; settled guard ensures single resolution
112
- return new Promise((resolve) => {
113
- let settled = false;
114
- // oxlint-disable-next-line prefer-const -- assigned after declaration
115
- let timer;
116
- const onAbort = () => {
117
- if (settled) {
118
- return;
119
- }
120
- settled = true;
121
- clearTimeout(timer);
122
- signal?.removeEventListener('abort', onAbort);
123
- // oxlint-disable-next-line promise/no-multiple-resolved -- settled guard ensures single resolution
124
- resolve(Result.err(new CancelledError('Operation cancelled')));
125
- };
126
- signal?.addEventListener('abort', onAbort, { once: true });
127
- timer = setTimeout(() => {
128
- if (settled) {
129
- return;
130
- }
131
- settled = true;
132
- signal?.removeEventListener('abort', onAbort);
133
- // oxlint-disable-next-line promise/no-multiple-resolved -- settled guard ensures single resolution
134
- resolve(Result.err(new TimeoutError(`Operation timed out after ${ms}ms`, {
135
- context: { timeoutMs: ms },
136
- })));
137
- }, ms);
138
- // oxlint-disable-next-line prefer-await-to-then, no-void -- .then() needed inside Promise constructor; void discards unhandled rejection
139
- void fn().then(
140
- // oxlint-disable-next-line prefer-await-to-callbacks -- callback required inside .then()
141
- (result) => {
142
- if (settled) {
143
- return;
144
- }
145
- settled = true;
146
- clearTimeout(timer);
147
- signal?.removeEventListener('abort', onAbort);
148
- // oxlint-disable-next-line promise/no-multiple-resolved -- settled guard ensures single resolution
149
- resolve(result);
150
- },
151
- // oxlint-disable-next-line prefer-await-to-callbacks -- rejection handler required inside .then()
152
- (error) => {
153
- if (settled) {
154
- return;
155
- }
156
- settled = true;
157
- clearTimeout(timer);
158
- signal?.removeEventListener('abort', onAbort);
159
- // oxlint-disable-next-line promise/no-multiple-resolved -- settled guard ensures single resolution
160
- resolve(Result.err(error instanceof Error ? error : new Error(String(error))));
161
- });
162
- });
163
- };
164
- //# sourceMappingURL=resilience.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"resilience.js","sourceRoot":"","sources":["../src/resilience.ts"],"names":[],"mappings":"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"}
package/dist/result.d.ts DELETED
@@ -1,57 +0,0 @@
1
- /**
2
- * A type-safe Result monad for representing success/failure without exceptions.
3
- */
4
- import { InternalError, ValidationError } from './errors.js';
5
- declare class Ok<T, E> {
6
- readonly value: T;
7
- constructor(value: T);
8
- isOk(): this is Ok<T, E>;
9
- isErr(): this is Err<E>;
10
- map<U>(fn: (value: T) => U): Result<U, E>;
11
- flatMap<U, F = E>(fn: (value: T) => Result<U, F>): Result<U, E | F>;
12
- mapErr<F>(_fn: (error: E) => F): Result<T, F>;
13
- match<U>(handlers: {
14
- ok: (value: T) => U;
15
- err: (error: E) => U;
16
- }): U;
17
- unwrap(): T;
18
- unwrapOr(_fallback: T): T;
19
- }
20
- declare class Err<E> {
21
- readonly error: E;
22
- constructor(error: E);
23
- isOk(): this is Ok<never, E>;
24
- isErr(): this is Err<E>;
25
- map<U>(_fn: (value: never) => U): Result<U, E>;
26
- flatMap<U, F = E>(_fn: (value: never) => Result<U, F>): Result<U, E | F>;
27
- mapErr<F>(fn: (error: E) => F): Result<never, F>;
28
- match<U>(handlers: {
29
- ok: (value: never) => U;
30
- err: (error: E) => U;
31
- }): U;
32
- unwrap(): never;
33
- unwrapOr<T>(fallback: T): T;
34
- }
35
- export type Result<T, E = Error> = Ok<T, E> | Err<E>;
36
- export declare const Result: {
37
- readonly combine: <T, E>(results: readonly Result<T, E>[]) => Result<T[], E>;
38
- readonly err: <E>(error: E) => Err<E>;
39
- /**
40
- * Wrap a fetch call in a Result, mapping failures to TrailsError subclasses.
41
- *
42
- * Network errors become NetworkError. Abort signals become CancelledError.
43
- * HTTP error status codes map to the appropriate error category.
44
- */
45
- readonly fromFetch: (input: string | URL | Request, init?: RequestInit) => Promise<Result<Response, Error>>;
46
- /**
47
- * Parse a JSON string, returning a Result instead of throwing.
48
- */
49
- readonly fromJson: (json: string) => Result<unknown, ValidationError>;
50
- readonly ok: <T = void>(value?: T) => Result<T, never>;
51
- /**
52
- * Stringify a value to JSON, returning a Result. Handles circular references.
53
- */
54
- readonly toJson: (value: unknown) => Result<string, InternalError>;
55
- };
56
- export {};
57
- //# sourceMappingURL=result.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,cAAM,EAAE,CAAC,CAAC,EAAE,CAAC;IACX,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBAEN,KAAK,EAAE,CAAC;IAKpB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAKxB,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IAIvB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAIzC,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAInE,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAI7C,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE;QAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAA;KAAE,GAAG,CAAC;IAIpE,MAAM,IAAI,CAAC;IAIX,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC;CAG1B;AAGD,cAAM,GAAG,CAAC,CAAC;IACT,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBAEN,KAAK,EAAE,CAAC;IAKpB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAK5B,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IAIvB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAI9C,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAIxE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAIhD,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE;QAAE,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAA;KAAE,GAAG,CAAC;IAIxE,MAAM,IAAI,KAAK;IAOf,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;CAG5B;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAGrD,eAAO,MAAM,MAAM;uBACT,CAAC,EAAE,CAAC,WAAW,SAAS,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAG,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;mBAW3D,CAAC,SAAS,CAAC,KAAG,GAAG,CAAC,CAAC,CAAC;IAIxB;;;;;OAKG;gCAEM,MAAM,GAAG,GAAG,GAAG,OAAO,SACtB,WAAW,KACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAMnC;;OAEG;8BACY,MAAM,KAAG,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC;kBAarD,CAAC,iBAAiB,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC;IAIzC;;OAEG;6BACW,OAAO,KAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;CA0C7C,CAAC"}
package/dist/result.js DELETED
@@ -1,156 +0,0 @@
1
- /**
2
- * A type-safe Result monad for representing success/failure without exceptions.
3
- */
4
- import { InternalError, ValidationError } from './errors.js';
5
- class Ok {
6
- value;
7
- constructor(value) {
8
- this.value = value;
9
- }
10
- // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
11
- isOk() {
12
- return true;
13
- }
14
- // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
15
- isErr() {
16
- return false;
17
- }
18
- map(fn) {
19
- return new Ok(fn(this.value));
20
- }
21
- flatMap(fn) {
22
- return fn(this.value);
23
- }
24
- mapErr(_fn) {
25
- return new Ok(this.value);
26
- }
27
- match(handlers) {
28
- return handlers.ok(this.value);
29
- }
30
- unwrap() {
31
- return this.value;
32
- }
33
- unwrapOr(_fallback) {
34
- return this.value;
35
- }
36
- }
37
- // oxlint-disable-next-line max-classes-per-file -- Result monad requires paired Ok/Err classes
38
- class Err {
39
- error;
40
- constructor(error) {
41
- this.error = error;
42
- }
43
- // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
44
- isOk() {
45
- return false;
46
- }
47
- // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
48
- isErr() {
49
- return true;
50
- }
51
- map(_fn) {
52
- return new Err(this.error);
53
- }
54
- flatMap(_fn) {
55
- return new Err(this.error);
56
- }
57
- mapErr(fn) {
58
- return new Err(fn(this.error));
59
- }
60
- match(handlers) {
61
- return handlers.err(this.error);
62
- }
63
- unwrap() {
64
- throw this.error instanceof Error
65
- ? this.error
66
- : new Error(String(this.error));
67
- }
68
- // oxlint-disable-next-line class-methods-use-this -- symmetric API with Ok.unwrapOr
69
- unwrapOr(fallback) {
70
- return fallback;
71
- }
72
- }
73
- // eslint-disable-next-line @typescript-eslint/no-namespace
74
- export const Result = {
75
- combine(results) {
76
- const values = [];
77
- for (const result of results) {
78
- if (result.isErr()) {
79
- return new Err(result.error);
80
- }
81
- values.push(result.value);
82
- }
83
- return new Ok(values);
84
- },
85
- err(error) {
86
- return new Err(error);
87
- },
88
- /**
89
- * Wrap a fetch call in a Result, mapping failures to TrailsError subclasses.
90
- *
91
- * Network errors become NetworkError. Abort signals become CancelledError.
92
- * HTTP error status codes map to the appropriate error category.
93
- */
94
- async fromFetch(input, init) {
95
- // Lazy import avoids a circular dependency (fetch.ts imports Result)
96
- const { fromFetch: fetchImpl } = await import('./fetch.js');
97
- return fetchImpl(input, init);
98
- },
99
- /**
100
- * Parse a JSON string, returning a Result instead of throwing.
101
- */
102
- fromJson(json) {
103
- try {
104
- return new Ok(JSON.parse(json));
105
- }
106
- catch (error) {
107
- return new Err(new ValidationError('Invalid JSON', {
108
- cause: error instanceof Error ? error : new Error(String(error)),
109
- context: { input: json.slice(0, 200) },
110
- }));
111
- }
112
- },
113
- ok(value) {
114
- return new Ok(value);
115
- },
116
- /**
117
- * Stringify a value to JSON, returning a Result. Handles circular references.
118
- */
119
- toJson(value) {
120
- try {
121
- // Track the current ancestor chain, not every object ever visited.
122
- // This allows shared references in a DAG while still detecting cycles.
123
- const stack = [];
124
- const keys = [];
125
- const json = JSON.stringify(value, function json(key, val) {
126
- if (stack.length > 0) {
127
- // `this` is the object that contains `key`. Trim the stack back
128
- // to `this` so we only track the current ancestor path.
129
- const thisIndex = stack.lastIndexOf(this);
130
- stack.splice(thisIndex + 1);
131
- keys.splice(thisIndex);
132
- }
133
- if (typeof val === 'object' && val !== null) {
134
- if (stack.includes(val)) {
135
- return '[Circular]';
136
- }
137
- stack.push(val);
138
- keys.push(key);
139
- }
140
- return val;
141
- });
142
- if (json === undefined) {
143
- return new Err(new InternalError('Value is not JSON-serializable', {
144
- context: { type: typeof value },
145
- }));
146
- }
147
- return new Ok(json);
148
- }
149
- catch (error) {
150
- return new Err(new InternalError('Failed to stringify value', {
151
- cause: error instanceof Error ? error : new Error(String(error)),
152
- }));
153
- }
154
- },
155
- };
156
- //# sourceMappingURL=result.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"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"}
@@ -1,27 +0,0 @@
1
- /**
2
- * Serialization utilities for @ontrails/core
3
- *
4
- * Safe JSON parsing/stringifying and error serialization/deserialization
5
- * for transport across process boundaries.
6
- */
7
- import type { ErrorCategory, TrailsError } from './errors.js';
8
- import { ValidationError, InternalError } from './errors.js';
9
- import { Result } from './result.js';
10
- export interface SerializedError {
11
- readonly name: string;
12
- readonly message: string;
13
- readonly category?: ErrorCategory | undefined;
14
- readonly retryable?: boolean | undefined;
15
- readonly retryAfter?: number | undefined;
16
- readonly context?: Record<string, unknown> | undefined;
17
- readonly stack?: string | undefined;
18
- }
19
- /** Extract structured data from an Error for transport. */
20
- export declare const serializeError: (error: Error) => SerializedError;
21
- /** Reconstruct a TrailsError from serialized data. */
22
- export declare const deserializeError: (data: SerializedError) => TrailsError;
23
- /** Parse a JSON string, returning a Result instead of throwing. */
24
- export declare const safeParse: (json: string) => Result<unknown, ValidationError>;
25
- /** Stringify a value, returning a Result. Handles circular references. */
26
- export declare const safeStringify: (value: unknown) => Result<string, InternalError>;
27
- //# sourceMappingURL=serialization.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,eAAe,EAUf,aAAa,EAId,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAMrC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAqFD,2DAA2D;AAC3D,eAAO,MAAM,cAAc,GAAI,OAAO,KAAK,KAAG,eAmB7C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,GAAI,MAAM,eAAe,KAAG,WAkBxD,CAAC;AAMF,mEAAmE;AACnE,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,OAAO,EAAE,eAAe,CAWvE,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,aAAa,GACxB,OAAO,OAAO,KACb,MAAM,CAAC,MAAM,EAAE,aAAa,CAwC9B,CAAC"}