@ontrails/core 1.0.0-beta.13 → 1.0.0-beta.15

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 (287) hide show
  1. package/.turbo/turbo-lint.log +1 -1
  2. package/CHANGELOG.md +17 -0
  3. package/README.md +19 -14
  4. package/dist/branded.d.ts +1 -1
  5. package/dist/branded.d.ts.map +1 -1
  6. package/dist/branded.js +1 -1
  7. package/dist/branded.js.map +1 -1
  8. package/dist/context.d.ts +13 -1
  9. package/dist/context.d.ts.map +1 -1
  10. package/dist/context.js +19 -3
  11. package/dist/context.js.map +1 -1
  12. package/dist/contour.d.ts +81 -0
  13. package/dist/contour.d.ts.map +1 -0
  14. package/dist/contour.js +176 -0
  15. package/dist/contour.js.map +1 -0
  16. package/dist/cross-schema.d.ts +18 -0
  17. package/dist/cross-schema.d.ts.map +1 -0
  18. package/dist/cross-schema.js +29 -0
  19. package/dist/cross-schema.js.map +1 -0
  20. package/dist/derive.d.ts +6 -0
  21. package/dist/derive.d.ts.map +1 -1
  22. package/dist/derive.js +29 -5
  23. package/dist/derive.js.map +1 -1
  24. package/dist/draft.d.ts +28 -0
  25. package/dist/draft.d.ts.map +1 -0
  26. package/dist/draft.js +157 -0
  27. package/dist/draft.js.map +1 -0
  28. package/dist/errors.d.ts +62 -4
  29. package/dist/errors.d.ts.map +1 -1
  30. package/dist/errors.js +44 -1
  31. package/dist/errors.js.map +1 -1
  32. package/dist/execute.d.ts +26 -9
  33. package/dist/execute.d.ts.map +1 -1
  34. package/dist/execute.js +441 -20
  35. package/dist/execute.js.map +1 -1
  36. package/dist/fire.d.ts +43 -0
  37. package/dist/fire.d.ts.map +1 -0
  38. package/dist/fire.js +185 -0
  39. package/dist/fire.js.map +1 -0
  40. package/dist/index.d.ts +33 -17
  41. package/dist/index.d.ts.map +1 -1
  42. package/dist/index.js +26 -12
  43. package/dist/index.js.map +1 -1
  44. package/dist/internal/cross-batch.d.ts +44 -0
  45. package/dist/internal/cross-batch.d.ts.map +1 -0
  46. package/dist/internal/cross-batch.js +58 -0
  47. package/dist/internal/cross-batch.js.map +1 -0
  48. package/dist/internal/fork-ctx.d.ts +41 -0
  49. package/dist/internal/fork-ctx.d.ts.map +1 -0
  50. package/dist/internal/fork-ctx.js +47 -0
  51. package/dist/internal/fork-ctx.js.map +1 -0
  52. package/dist/internal/signal-ref.d.ts +15 -0
  53. package/dist/internal/signal-ref.d.ts.map +1 -0
  54. package/dist/internal/signal-ref.js +41 -0
  55. package/dist/internal/signal-ref.js.map +1 -0
  56. package/dist/internal/topo-saves.d.ts +53 -0
  57. package/dist/internal/topo-saves.d.ts.map +1 -0
  58. package/dist/internal/topo-saves.js +449 -0
  59. package/dist/internal/topo-saves.js.map +1 -0
  60. package/dist/internal/topo-snapshots.d.ts +57 -0
  61. package/dist/internal/topo-snapshots.d.ts.map +1 -0
  62. package/dist/internal/topo-snapshots.js +372 -0
  63. package/dist/internal/topo-snapshots.js.map +1 -0
  64. package/dist/internal/topo-store-read.d.ts +70 -0
  65. package/dist/internal/topo-store-read.d.ts.map +1 -0
  66. package/dist/internal/topo-store-read.js +221 -0
  67. package/dist/internal/topo-store-read.js.map +1 -0
  68. package/dist/internal/topo-store.d.ts +26 -0
  69. package/dist/internal/topo-store.d.ts.map +1 -0
  70. package/dist/internal/topo-store.js +621 -0
  71. package/dist/internal/topo-store.js.map +1 -0
  72. package/dist/internal/tracing.d.ts +98 -0
  73. package/dist/internal/tracing.d.ts.map +1 -0
  74. package/dist/internal/tracing.js +102 -0
  75. package/dist/internal/tracing.js.map +1 -0
  76. package/dist/internal/trails-db.d.ts +16 -0
  77. package/dist/internal/trails-db.d.ts.map +1 -0
  78. package/dist/internal/trails-db.js +118 -0
  79. package/dist/internal/trails-db.js.map +1 -0
  80. package/dist/internal/zod-wrappers.d.ts +40 -0
  81. package/dist/internal/zod-wrappers.d.ts.map +1 -0
  82. package/dist/internal/zod-wrappers.js +59 -0
  83. package/dist/internal/zod-wrappers.js.map +1 -0
  84. package/dist/layer.d.ts +22 -5
  85. package/dist/layer.d.ts.map +1 -1
  86. package/dist/layer.js +20 -3
  87. package/dist/layer.js.map +1 -1
  88. package/dist/path-security.d.ts +1 -1
  89. package/dist/path-security.d.ts.map +1 -1
  90. package/dist/path-security.js +1 -1
  91. package/dist/path-security.js.map +1 -1
  92. package/dist/resilience.d.ts +1 -1
  93. package/dist/resilience.d.ts.map +1 -1
  94. package/dist/resilience.js +3 -3
  95. package/dist/resilience.js.map +1 -1
  96. package/dist/resource-config.d.ts +22 -0
  97. package/dist/resource-config.d.ts.map +1 -0
  98. package/dist/resource-config.js +210 -0
  99. package/dist/resource-config.js.map +1 -0
  100. package/dist/resource.d.ts +74 -0
  101. package/dist/resource.d.ts.map +1 -0
  102. package/dist/resource.js +61 -0
  103. package/dist/resource.js.map +1 -0
  104. package/dist/run.d.ts +4 -3
  105. package/dist/run.d.ts.map +1 -1
  106. package/dist/run.js +5 -4
  107. package/dist/run.js.map +1 -1
  108. package/dist/serialization.d.ts.map +1 -1
  109. package/dist/serialization.js +2 -1
  110. package/dist/serialization.js.map +1 -1
  111. package/dist/store/accessor-protocol.d.ts +51 -0
  112. package/dist/store/accessor-protocol.d.ts.map +1 -0
  113. package/dist/store/accessor-protocol.js +2 -0
  114. package/dist/store/accessor-protocol.js.map +1 -0
  115. package/dist/store/index.d.ts +2 -0
  116. package/dist/store/index.d.ts.map +1 -0
  117. package/dist/store/index.js +2 -0
  118. package/dist/store/index.js.map +1 -0
  119. package/dist/surface-filter.d.ts +13 -0
  120. package/dist/surface-filter.d.ts.map +1 -0
  121. package/dist/surface-filter.js +76 -0
  122. package/dist/surface-filter.js.map +1 -0
  123. package/dist/topo-store.d.ts +62 -0
  124. package/dist/topo-store.d.ts.map +1 -0
  125. package/dist/topo-store.js +319 -0
  126. package/dist/topo-store.js.map +1 -0
  127. package/dist/topo.d.ts +23 -9
  128. package/dist/topo.d.ts.map +1 -1
  129. package/dist/topo.js +175 -46
  130. package/dist/topo.js.map +1 -1
  131. package/dist/trail.d.ts +86 -19
  132. package/dist/trail.d.ts.map +1 -1
  133. package/dist/trail.js +59 -4
  134. package/dist/trail.js.map +1 -1
  135. package/dist/trails/derive-trail.d.ts +66 -0
  136. package/dist/trails/derive-trail.d.ts.map +1 -0
  137. package/dist/trails/derive-trail.js +378 -0
  138. package/dist/trails/derive-trail.js.map +1 -0
  139. package/dist/trails/index.d.ts +5 -0
  140. package/dist/trails/index.d.ts.map +1 -0
  141. package/dist/trails/index.js +3 -0
  142. package/dist/trails/index.js.map +1 -0
  143. package/dist/trails/ingest.d.ts +24 -0
  144. package/dist/trails/ingest.d.ts.map +1 -0
  145. package/dist/trails/ingest.js +63 -0
  146. package/dist/trails/ingest.js.map +1 -0
  147. package/dist/transport-error-map.d.ts +106 -0
  148. package/dist/transport-error-map.d.ts.map +1 -0
  149. package/dist/transport-error-map.js +24 -0
  150. package/dist/transport-error-map.js.map +1 -0
  151. package/dist/type-checks.test-d.d.ts +71 -0
  152. package/dist/type-checks.test-d.d.ts.map +1 -0
  153. package/dist/type-checks.test-d.js +12 -0
  154. package/dist/type-checks.test-d.js.map +1 -0
  155. package/dist/type-utils.d.ts +11 -2
  156. package/dist/type-utils.d.ts.map +1 -1
  157. package/dist/type-utils.js.map +1 -1
  158. package/dist/types.d.ts +113 -7
  159. package/dist/types.d.ts.map +1 -1
  160. package/dist/types.js.map +1 -1
  161. package/dist/validate-established-topo.d.ts +76 -0
  162. package/dist/validate-established-topo.d.ts.map +1 -0
  163. package/dist/validate-established-topo.js +43 -0
  164. package/dist/validate-established-topo.js.map +1 -0
  165. package/dist/validate-topo.d.ts.map +1 -1
  166. package/dist/validate-topo.js +27 -8
  167. package/dist/validate-topo.js.map +1 -1
  168. package/dist/workspace.d.ts +1 -1
  169. package/dist/workspace.d.ts.map +1 -1
  170. package/dist/workspace.js +1 -1
  171. package/dist/workspace.js.map +1 -1
  172. package/package.json +10 -1
  173. package/src/__tests__/branded.test.ts +5 -5
  174. package/src/__tests__/context.test.ts +3 -3
  175. package/src/__tests__/contour.test.ts +263 -0
  176. package/src/__tests__/derive-trail.test.ts +668 -0
  177. package/src/__tests__/derive.test.ts +58 -1
  178. package/src/__tests__/errors.test.ts +118 -0
  179. package/src/__tests__/execute.test.ts +1179 -141
  180. package/src/__tests__/fire.test.ts +1056 -0
  181. package/src/__tests__/fork-ctx.test.ts +83 -0
  182. package/src/__tests__/ingest.test.ts +191 -0
  183. package/src/__tests__/{gate.test.ts → layer.test.ts} +21 -21
  184. package/src/__tests__/path-security.test.ts +7 -7
  185. package/src/__tests__/resilience.test.ts +8 -8
  186. package/src/__tests__/resource.test.ts +204 -0
  187. package/src/__tests__/run.test.ts +13 -13
  188. package/src/__tests__/service-config.test.ts +28 -32
  189. package/src/__tests__/surface-filter.test.ts +196 -0
  190. package/src/__tests__/topo-store-read.test.ts +256 -0
  191. package/src/__tests__/topo-store.test.ts +869 -0
  192. package/src/__tests__/topo.test.ts +350 -54
  193. package/src/__tests__/trail.test.ts +189 -24
  194. package/src/__tests__/trails-db.test.ts +198 -0
  195. package/src/__tests__/transport-error-map.test.ts +82 -0
  196. package/src/__tests__/type-utils.test.ts +29 -1
  197. package/src/__tests__/validate-topo.test.ts +305 -16
  198. package/src/__tests__/workspace.test.ts +6 -6
  199. package/src/__tests__/zod-wrappers.test.ts +62 -0
  200. package/src/branded.ts +1 -1
  201. package/src/context.ts +24 -4
  202. package/src/contour.ts +344 -0
  203. package/src/cross-schema.ts +36 -0
  204. package/src/derive.ts +39 -8
  205. package/src/draft.ts +338 -0
  206. package/src/errors.ts +62 -18
  207. package/src/execute.ts +840 -29
  208. package/src/fire.ts +295 -0
  209. package/src/index.ts +142 -26
  210. package/src/internal/cross-batch.ts +77 -0
  211. package/src/internal/fork-ctx.ts +69 -0
  212. package/src/internal/signal-ref.ts +87 -0
  213. package/src/internal/topo-snapshots.ts +517 -0
  214. package/src/internal/topo-store-read.ts +481 -0
  215. package/src/internal/topo-store.ts +1192 -0
  216. package/src/internal/tracing.ts +187 -0
  217. package/src/internal/trails-db.ts +187 -0
  218. package/src/internal/zod-wrappers.ts +78 -0
  219. package/src/layer.ts +50 -0
  220. package/src/path-security.ts +1 -1
  221. package/src/resilience.ts +3 -3
  222. package/src/{provision-config.ts → resource-config.ts} +109 -123
  223. package/src/resource.ts +155 -0
  224. package/src/run.ts +5 -4
  225. package/src/serialization.ts +2 -0
  226. package/src/store/accessor-protocol.ts +56 -0
  227. package/src/store/index.ts +4 -0
  228. package/src/surface-filter.ts +182 -0
  229. package/src/topo-store.ts +510 -0
  230. package/src/topo.ts +328 -57
  231. package/src/trail.ts +199 -31
  232. package/src/trails/derive-trail.ts +842 -0
  233. package/src/trails/index.ts +9 -0
  234. package/src/trails/ingest.ts +146 -0
  235. package/src/transport-error-map.ts +56 -0
  236. package/src/type-checks.test-d.ts +106 -0
  237. package/src/type-utils.ts +17 -2
  238. package/src/types.ts +148 -11
  239. package/src/validate-established-topo.ts +63 -0
  240. package/src/validate-topo.ts +37 -9
  241. package/src/workspace.ts +1 -1
  242. package/tsconfig.tests.json +10 -0
  243. package/tsconfig.tsbuildinfo +1 -1
  244. package/dist/adapters.d.ts +0 -39
  245. package/dist/adapters.d.ts.map +0 -1
  246. package/dist/adapters.js +0 -2
  247. package/dist/adapters.js.map +0 -1
  248. package/dist/dispatch.d.ts +0 -27
  249. package/dist/dispatch.d.ts.map +0 -1
  250. package/dist/dispatch.js +0 -34
  251. package/dist/dispatch.js.map +0 -1
  252. package/dist/event.d.ts +0 -8
  253. package/dist/event.d.ts.map +0 -1
  254. package/dist/event.js +0 -7
  255. package/dist/event.js.map +0 -1
  256. package/dist/gate.d.ts +0 -17
  257. package/dist/gate.d.ts.map +0 -1
  258. package/dist/gate.js +0 -21
  259. package/dist/gate.js.map +0 -1
  260. package/dist/health.d.ts +0 -18
  261. package/dist/health.d.ts.map +0 -1
  262. package/dist/health.js +0 -5
  263. package/dist/health.js.map +0 -1
  264. package/dist/job.d.ts +0 -24
  265. package/dist/job.d.ts.map +0 -1
  266. package/dist/job.js +0 -17
  267. package/dist/job.js.map +0 -1
  268. package/dist/provision-config.d.ts +0 -22
  269. package/dist/provision-config.d.ts.map +0 -1
  270. package/dist/provision-config.js +0 -210
  271. package/dist/provision-config.js.map +0 -1
  272. package/dist/provision.d.ts +0 -71
  273. package/dist/provision.d.ts.map +0 -1
  274. package/dist/provision.js +0 -56
  275. package/dist/provision.js.map +0 -1
  276. package/dist/service-config.d.ts +0 -22
  277. package/dist/service-config.d.ts.map +0 -1
  278. package/dist/service-config.js +0 -210
  279. package/dist/service-config.js.map +0 -1
  280. package/dist/service.d.ts +0 -71
  281. package/dist/service.d.ts.map +0 -1
  282. package/dist/service.js +0 -56
  283. package/dist/service.js.map +0 -1
  284. package/src/__tests__/service.test.ts +0 -197
  285. package/src/event.ts +0 -15
  286. package/src/gate.ts +0 -44
  287. package/src/provision.ts +0 -148
@@ -0,0 +1 @@
1
+ {"version":3,"file":"topo-store.js","sourceRoot":"","sources":["../../src/internal/topo-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,98 @@
1
+ /**
2
+ * Intrinsic tracing primitives.
3
+ *
4
+ * This module is the home for the trace record type, the sink interface,
5
+ * the sink registry, and the helpers `executeTrail` uses to create root
6
+ * trace records and child spans. It is intentionally framework-internal —
7
+ * the `@ontrails/tracing` package re-exports the public surface so callers
8
+ * can continue to import from there.
9
+ *
10
+ * Tracing is intrinsic: every `executeTrail` call automatically produces a
11
+ * root `TraceRecord`, and `ctx.trace(label, fn)` creates nested child spans
12
+ * underneath it. A default no-op sink is installed at module load so core
13
+ * never crashes when no real sink has been registered.
14
+ */
15
+ /** Evidence of a single trail execution or manual span. */
16
+ export interface TraceRecord {
17
+ readonly id: string;
18
+ readonly traceId: string;
19
+ readonly rootId: string;
20
+ readonly parentId?: string | undefined;
21
+ readonly kind: 'trail' | 'span';
22
+ readonly name: string;
23
+ readonly trailId?: string | undefined;
24
+ readonly trailhead?: 'cli' | 'mcp' | 'http' | 'ws' | undefined;
25
+ readonly intent?: 'read' | 'write' | 'destroy' | undefined;
26
+ readonly startedAt: number;
27
+ readonly endedAt?: number | undefined;
28
+ readonly status: 'ok' | 'err' | 'cancelled';
29
+ readonly errorCategory?: string | undefined;
30
+ readonly permit?: {
31
+ readonly id: string;
32
+ readonly tenantId?: string;
33
+ } | undefined;
34
+ readonly attrs: Readonly<Record<string, unknown>>;
35
+ }
36
+ /**
37
+ * Minimal shape a tracing sink must satisfy.
38
+ *
39
+ * Kept intentionally tiny so adapters in `@ontrails/tracing`,
40
+ * `@ontrails/observe`, and user code can all satisfy it without
41
+ * additional dependencies.
42
+ */
43
+ export interface TraceSink {
44
+ readonly write: (record: TraceRecord) => void | Promise<void>;
45
+ }
46
+ /** Trace context carried through trail execution via `ctx.extensions`. */
47
+ export interface TraceContext {
48
+ readonly traceId: string;
49
+ readonly spanId: string;
50
+ readonly rootId: string;
51
+ readonly sampled: boolean;
52
+ }
53
+ /** Key used to store trace context in `ctx.extensions`. */
54
+ export declare const TRACE_CONTEXT_KEY = "__trace_context";
55
+ /** Read trace context from trail context extensions. */
56
+ export declare const getTraceContext: (ctx: {
57
+ readonly extensions?: Readonly<Record<string, unknown>> | undefined;
58
+ }) => TraceContext | undefined;
59
+ /** No-op sink installed by default so core never crashes without configuration. */
60
+ export declare const NOOP_SINK: TraceSink;
61
+ /**
62
+ * Register a trace sink globally.
63
+ *
64
+ * All trails executed via `executeTrail` will write their completed trace
65
+ * records to this sink, as will every `ctx.trace(label, fn)` child span.
66
+ * Registering `undefined` or calling {@link clearTraceSink} resets back to
67
+ * the default no-op sink.
68
+ */
69
+ export declare const registerTraceSink: (sink: TraceSink | undefined) => void;
70
+ /** Retrieve the currently registered sink (never undefined). */
71
+ export declare const getTraceSink: () => TraceSink;
72
+ /** True when tracing is effectively disabled and executeTrail should skip allocation. */
73
+ export declare const isTracingDisabled: (sink?: TraceSink) => boolean;
74
+ /** Reset the sink registry back to the default no-op sink. */
75
+ export declare const clearTraceSink: () => void;
76
+ /** Options for creating a trail-scoped {@link TraceRecord}. */
77
+ interface CreateTraceRecordOptions {
78
+ readonly trailId: string;
79
+ readonly traceId?: string | undefined;
80
+ readonly parentId?: string | undefined;
81
+ readonly rootId?: string | undefined;
82
+ readonly trailhead?: TraceRecord['trailhead'];
83
+ readonly intent?: TraceRecord['intent'];
84
+ readonly permit?: {
85
+ readonly id: string;
86
+ readonly tenantId?: string;
87
+ } | undefined;
88
+ }
89
+ /** Create a fresh trail-kind {@link TraceRecord}. */
90
+ export declare const createTraceRecord: (options: CreateTraceRecordOptions) => TraceRecord;
91
+ /** Build a span record from a parent trace context. */
92
+ export declare const createSpanRecord: (parent: TraceContext, label: string) => TraceRecord;
93
+ /** Mark a record as completed with timing and status. */
94
+ export declare const completeRecord: (record: TraceRecord, status: TraceRecord["status"], errorCategory?: string | undefined) => TraceRecord;
95
+ /** Best-effort sink write that never throws. */
96
+ export declare const writeToSink: (sink: TraceSink, record: TraceRecord) => Promise<void>;
97
+ export {};
98
+ //# sourceMappingURL=tracing.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/internal/tracing.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,102 @@
1
+ /**
2
+ * Intrinsic tracing primitives.
3
+ *
4
+ * This module is the home for the trace record type, the sink interface,
5
+ * the sink registry, and the helpers `executeTrail` uses to create root
6
+ * trace records and child spans. It is intentionally framework-internal —
7
+ * the `@ontrails/tracing` package re-exports the public surface so callers
8
+ * can continue to import from there.
9
+ *
10
+ * Tracing is intrinsic: every `executeTrail` call automatically produces a
11
+ * root `TraceRecord`, and `ctx.trace(label, fn)` creates nested child spans
12
+ * underneath it. A default no-op sink is installed at module load so core
13
+ * never crashes when no real sink has been registered.
14
+ */
15
+ /** Key used to store trace context in `ctx.extensions`. */
16
+ export const TRACE_CONTEXT_KEY = '__trace_context';
17
+ /** Read trace context from trail context extensions. */
18
+ export const getTraceContext = (ctx) => ctx.extensions?.[TRACE_CONTEXT_KEY];
19
+ // ---------------------------------------------------------------------------
20
+ // Default no-op sink + sink registry
21
+ // ---------------------------------------------------------------------------
22
+ /** No-op sink installed by default so core never crashes without configuration. */
23
+ export const NOOP_SINK = {
24
+ // oxlint-disable-next-line no-empty-function -- intentional no-op
25
+ write: () => { },
26
+ };
27
+ // oxlint-disable-next-line eslint-plugin-jest/require-hook -- module-level sink registry, not test setup
28
+ let currentSink = NOOP_SINK;
29
+ /**
30
+ * Register a trace sink globally.
31
+ *
32
+ * All trails executed via `executeTrail` will write their completed trace
33
+ * records to this sink, as will every `ctx.trace(label, fn)` child span.
34
+ * Registering `undefined` or calling {@link clearTraceSink} resets back to
35
+ * the default no-op sink.
36
+ */
37
+ export const registerTraceSink = (sink) => {
38
+ currentSink = sink ?? NOOP_SINK;
39
+ };
40
+ /** Retrieve the currently registered sink (never undefined). */
41
+ export const getTraceSink = () => currentSink;
42
+ /** True when tracing is effectively disabled and executeTrail should skip allocation. */
43
+ export const isTracingDisabled = (sink = currentSink) => sink === NOOP_SINK;
44
+ /** Reset the sink registry back to the default no-op sink. */
45
+ export const clearTraceSink = () => {
46
+ currentSink = NOOP_SINK;
47
+ };
48
+ /** Create a fresh trail-kind {@link TraceRecord}. */
49
+ export const createTraceRecord = (options) => {
50
+ const id = Bun.randomUUIDv7();
51
+ const traceId = options.traceId ?? Bun.randomUUIDv7();
52
+ return {
53
+ attrs: {},
54
+ endedAt: undefined,
55
+ id,
56
+ intent: options.intent,
57
+ kind: 'trail',
58
+ name: options.trailId,
59
+ parentId: options.parentId,
60
+ permit: options.permit,
61
+ rootId: options.rootId ?? id,
62
+ startedAt: Date.now(),
63
+ status: 'ok',
64
+ traceId,
65
+ trailId: options.trailId,
66
+ trailhead: options.trailhead,
67
+ };
68
+ };
69
+ /** Build a span record from a parent trace context. */
70
+ export const createSpanRecord = (parent, label) => ({
71
+ attrs: {},
72
+ endedAt: undefined,
73
+ errorCategory: undefined,
74
+ id: Bun.randomUUIDv7(),
75
+ intent: undefined,
76
+ kind: 'span',
77
+ name: label,
78
+ parentId: parent.spanId,
79
+ rootId: parent.rootId,
80
+ startedAt: Date.now(),
81
+ status: 'ok',
82
+ traceId: parent.traceId,
83
+ trailId: undefined,
84
+ trailhead: undefined,
85
+ });
86
+ /** Mark a record as completed with timing and status. */
87
+ export const completeRecord = (record, status, errorCategory) => ({
88
+ ...record,
89
+ endedAt: Date.now(),
90
+ errorCategory,
91
+ status,
92
+ });
93
+ /** Best-effort sink write that never throws. */
94
+ export const writeToSink = async (sink, record) => {
95
+ try {
96
+ await Promise.resolve(sink.write(record));
97
+ }
98
+ catch {
99
+ // Sink failures must never affect trail result delivery.
100
+ }
101
+ };
102
+ //# sourceMappingURL=tracing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/internal/tracing.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import { Database } from 'bun:sqlite';
2
+ export interface TrailsDbLocationOptions {
3
+ readonly path?: string;
4
+ readonly rootDir?: string;
5
+ }
6
+ export interface EnsureSubsystemSchemaOptions {
7
+ readonly migrate: (currentVersion: number) => void;
8
+ readonly subsystem: string;
9
+ readonly version: number;
10
+ }
11
+ export declare const deriveTrailsDir: (options?: TrailsDbLocationOptions) => string;
12
+ export declare const deriveTrailsDbPath: (options?: TrailsDbLocationOptions) => string;
13
+ export declare const openWriteTrailsDb: (options?: TrailsDbLocationOptions) => Database;
14
+ export declare const openReadTrailsDb: (options?: TrailsDbLocationOptions) => Database;
15
+ export declare const ensureSubsystemSchema: (db: Database, options: EnsureSubsystemSchemaOptions) => void;
16
+ //# sourceMappingURL=trails-db.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trails-db.d.ts","sourceRoot":"","sources":["../../src/internal/trails-db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA2BtC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AASD,eAAO,MAAM,eAAe,GAAI,UAAU,uBAAuB,KAAG,MACjB,CAAC;AAEpD,eAAO,MAAM,kBAAkB,GAAI,UAAU,uBAAuB,KAAG,MAGnB,CAAC;AAsFrD,eAAO,MAAM,iBAAiB,GAC5B,UAAU,uBAAuB,KAChC,QAgBF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,uBAAuB,KAChC,QAUF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,IAAI,QAAQ,EACZ,SAAS,4BAA4B,KACpC,IAYF,CAAC"}
@@ -0,0 +1,118 @@
1
+ import { Database } from 'bun:sqlite';
2
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
3
+ import { dirname, join, resolve } from 'node:path';
4
+ import { NotFoundError } from '../errors.js';
5
+ const TRAILS_DIR = '.trails';
6
+ const TRAILS_DB_FILE = 'trails.db';
7
+ const SCHEMA_VERSION_TABLE = 'meta_schema_versions';
8
+ const WORKSPACE_SUBDIRS = ['config', 'dev', 'generated'];
9
+ const REQUIRED_GITIGNORE_LINES = [
10
+ '# Local config overrides',
11
+ 'config/',
12
+ '',
13
+ '# Development state',
14
+ 'dev/',
15
+ '',
16
+ '# Generated artifacts',
17
+ 'generated/',
18
+ '',
19
+ '# Shared Trails database',
20
+ 'trails.db',
21
+ 'trails.db-shm',
22
+ 'trails.db-wal',
23
+ '',
24
+ ];
25
+ const deriveRootDir = (rootDir) => resolve(rootDir ?? process.cwd());
26
+ export const deriveTrailsDir = (options) => join(deriveRootDir(options?.rootDir), TRAILS_DIR);
27
+ export const deriveTrailsDbPath = (options) => options?.path
28
+ ? resolve(options.path)
29
+ : join(deriveTrailsDir(options), TRAILS_DB_FILE);
30
+ const ensureDbParentDir = (dbPath) => {
31
+ mkdirSync(dirname(dbPath), { recursive: true });
32
+ };
33
+ const GITIGNORE_TEMPLATE = `${REQUIRED_GITIGNORE_LINES.join('\n').trimEnd()}\n`;
34
+ const appendMissingGitignoreLines = (gitignorePath, content) => {
35
+ const existingLines = new Set(content.split('\n').map((l) => l.trim()));
36
+ const missing = REQUIRED_GITIGNORE_LINES.filter((line) => line !== '' && !existingLines.has(line));
37
+ if (missing.length === 0) {
38
+ return;
39
+ }
40
+ const next = `${content.trimEnd()}\n\n${missing.join('\n')}`;
41
+ writeFileSync(gitignorePath, `${next.trimEnd()}\n`);
42
+ };
43
+ const ensureWorkspaceGitignore = (trailsDir) => {
44
+ const gitignorePath = join(trailsDir, '.gitignore');
45
+ if (!existsSync(gitignorePath)) {
46
+ writeFileSync(gitignorePath, GITIGNORE_TEMPLATE);
47
+ return;
48
+ }
49
+ appendMissingGitignoreLines(gitignorePath, readFileSync(gitignorePath, 'utf8'));
50
+ };
51
+ const ensureWorkspaceDir = (rootDir) => {
52
+ const trailsDir = deriveTrailsDir({ rootDir });
53
+ mkdirSync(trailsDir, { recursive: true });
54
+ for (const subdir of WORKSPACE_SUBDIRS) {
55
+ mkdirSync(join(trailsDir, subdir), { recursive: true });
56
+ }
57
+ ensureWorkspaceGitignore(trailsDir);
58
+ };
59
+ const initializeWritePragmas = (db) => {
60
+ db.run('PRAGMA journal_mode = WAL');
61
+ db.run('PRAGMA synchronous = NORMAL');
62
+ db.run('PRAGMA foreign_keys = ON');
63
+ };
64
+ const ensureSchemaVersionTable = (db) => {
65
+ db.run(`CREATE TABLE IF NOT EXISTS ${SCHEMA_VERSION_TABLE} (
66
+ subsystem TEXT PRIMARY KEY,
67
+ version INTEGER NOT NULL,
68
+ updated_at TEXT NOT NULL
69
+ )`);
70
+ };
71
+ const readSubsystemVersion = (db, subsystem) => {
72
+ const row = db
73
+ .query(`SELECT version FROM ${SCHEMA_VERSION_TABLE} WHERE subsystem = ?`)
74
+ .get(subsystem);
75
+ return row?.version ?? 0;
76
+ };
77
+ const writeSubsystemVersion = (db, subsystem, version) => {
78
+ db.run(`INSERT INTO ${SCHEMA_VERSION_TABLE} (subsystem, version, updated_at)
79
+ VALUES (?, ?, ?)
80
+ ON CONFLICT(subsystem) DO UPDATE SET
81
+ version = excluded.version,
82
+ updated_at = excluded.updated_at`, [subsystem, version, new Date().toISOString()]);
83
+ };
84
+ export const openWriteTrailsDb = (options) => {
85
+ const rootDir = deriveRootDir(options?.rootDir);
86
+ const dbPath = deriveTrailsDbPath(options?.path ? { path: options.path, rootDir } : { rootDir });
87
+ if (options?.path === undefined) {
88
+ ensureWorkspaceDir(rootDir);
89
+ }
90
+ else {
91
+ ensureDbParentDir(dbPath);
92
+ }
93
+ const db = new Database(dbPath, { create: true });
94
+ initializeWritePragmas(db);
95
+ ensureSchemaVersionTable(db);
96
+ return db;
97
+ };
98
+ export const openReadTrailsDb = (options) => {
99
+ const dbPath = deriveTrailsDbPath(options);
100
+ if (!existsSync(dbPath)) {
101
+ throw new NotFoundError(`Trails database not found at "${dbPath}". Run a write operation first to initialize it.`);
102
+ }
103
+ const db = new Database(dbPath, { readonly: true });
104
+ db.run('PRAGMA foreign_keys = ON');
105
+ return db;
106
+ };
107
+ export const ensureSubsystemSchema = (db, options) => {
108
+ ensureSchemaVersionTable(db);
109
+ db.transaction(() => {
110
+ const currentVersion = readSubsystemVersion(db, options.subsystem);
111
+ if (currentVersion >= options.version) {
112
+ return;
113
+ }
114
+ options.migrate(currentVersion);
115
+ writeSubsystemVersion(db, options.subsystem, options.version);
116
+ })();
117
+ };
118
+ //# sourceMappingURL=trails-db.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trails-db.js","sourceRoot":"","sources":["../../src/internal/trails-db.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Shared Zod wrapper helpers.
3
+ *
4
+ * These helpers walk the wrapper layers of a Zod schema (default, optional,
5
+ * nullable) and rebuild the schema without any default wrappers so that
6
+ * downstream `.partial()` calls do not silently re-materialize defaults during
7
+ * validation. Both `@ontrails/core/trails/derive-trail.ts` and
8
+ * `@ontrails/store/src/store.ts` previously shipped near-identical copies of
9
+ * this walk — extracting them here keeps the wrapper semantics authored in one
10
+ * place so the two call sites cannot drift.
11
+ *
12
+ * Canonical behavior: `optional` wrappers are intentionally dropped. Every
13
+ * current call site applies `.partial()` to the stripped schema, which
14
+ * re-introduces `optional` across the whole shape. Preserving `optional` here
15
+ * would be redundant at best and would produce an `OptionalOptional<T>` shape
16
+ * in edge cases at worst. `nullable` wrappers are preserved because nullability
17
+ * is a semantic constraint that `.partial()` does not reintroduce.
18
+ *
19
+ * @internal
20
+ */
21
+ import type { z } from 'zod';
22
+ /**
23
+ * Strip `default` wrappers from a Zod type so that partial update schemas do
24
+ * not silently re-materialize defaults. Walks through all wrapper layers
25
+ * (`default`, `optional`, `nullable`), drops defaults, drops `optional` (the
26
+ * downstream `.partial()` reintroduces it across the whole shape), and
27
+ * preserves `nullable` so explicit nullability survives.
28
+ *
29
+ * @internal
30
+ */
31
+ export declare const stripDefaultWrappers: (schema: z.ZodType) => z.ZodType;
32
+ /**
33
+ * Apply {@link stripDefaultWrappers} to every field in a Zod object shape and
34
+ * return the resulting shape record. Callers typically feed the result to
35
+ * `.extend()` + `.partial()`.
36
+ *
37
+ * @internal
38
+ */
39
+ export declare const stripDefaultsFromShape: (schema: z.ZodType) => Record<string, z.ZodType>;
40
+ //# sourceMappingURL=zod-wrappers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"zod-wrappers.d.ts","sourceRoot":"","sources":["../../src/internal/zod-wrappers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAU7B;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,CAAC,CAAC,OAY1D,CAAC;AAOF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,CAAC,CAAC,OAAO,KAChB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAS1B,CAAC"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * Shared Zod wrapper helpers.
3
+ *
4
+ * These helpers walk the wrapper layers of a Zod schema (default, optional,
5
+ * nullable) and rebuild the schema without any default wrappers so that
6
+ * downstream `.partial()` calls do not silently re-materialize defaults during
7
+ * validation. Both `@ontrails/core/trails/derive-trail.ts` and
8
+ * `@ontrails/store/src/store.ts` previously shipped near-identical copies of
9
+ * this walk — extracting them here keeps the wrapper semantics authored in one
10
+ * place so the two call sites cannot drift.
11
+ *
12
+ * Canonical behavior: `optional` wrappers are intentionally dropped. Every
13
+ * current call site applies `.partial()` to the stripped schema, which
14
+ * re-introduces `optional` across the whole shape. Preserving `optional` here
15
+ * would be redundant at best and would produce an `OptionalOptional<T>` shape
16
+ * in edge cases at worst. `nullable` wrappers are preserved because nullability
17
+ * is a semantic constraint that `.partial()` does not reintroduce.
18
+ *
19
+ * @internal
20
+ */
21
+ const isWrapperType = (type) => type === 'default' || type === 'nullable' || type === 'optional';
22
+ const readInnerType = (schema) => schema.def.innerType;
23
+ /**
24
+ * Strip `default` wrappers from a Zod type so that partial update schemas do
25
+ * not silently re-materialize defaults. Walks through all wrapper layers
26
+ * (`default`, `optional`, `nullable`), drops defaults, drops `optional` (the
27
+ * downstream `.partial()` reintroduces it across the whole shape), and
28
+ * preserves `nullable` so explicit nullability survives.
29
+ *
30
+ * @internal
31
+ */
32
+ export const stripDefaultWrappers = (schema) => {
33
+ let current = schema;
34
+ let isNullable = false;
35
+ while (isWrapperType(current.def.type)) {
36
+ if (current.def.type === 'nullable') {
37
+ isNullable = true;
38
+ }
39
+ current = readInnerType(current);
40
+ }
41
+ return isNullable ? current.nullable() : current;
42
+ };
43
+ const asObjectSchema = (schema) => schema;
44
+ /**
45
+ * Apply {@link stripDefaultWrappers} to every field in a Zod object shape and
46
+ * return the resulting shape record. Callers typically feed the result to
47
+ * `.extend()` + `.partial()`.
48
+ *
49
+ * @internal
50
+ */
51
+ export const stripDefaultsFromShape = (schema) => {
52
+ const stripped = {};
53
+ const objectSchema = asObjectSchema(schema);
54
+ for (const [field, value] of Object.entries(objectSchema.shape)) {
55
+ stripped[field] = stripDefaultWrappers(value);
56
+ }
57
+ return stripped;
58
+ };
59
+ //# sourceMappingURL=zod-wrappers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"zod-wrappers.js","sourceRoot":"","sources":["../../src/internal/zod-wrappers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,aAAa,GAAG,CACpB,IAAY,EACiC,EAAE,CAC/C,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,CAAC;AAEnE,MAAM,aAAa,GAAG,CAAC,MAAiB,EAAa,EAAE,CACpD,MAAM,CAAC,GAA2C,CAAC,SAAS,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAiB,EAAa,EAAE;IACnE,IAAI,OAAO,GAAG,MAAM,CAAC;IACrB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,OAAO,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACpC,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACnD,CAAC,CAAC;AAIF,MAAM,cAAc,GAAG,CAAC,MAAiB,EAAmB,EAAE,CAC5D,MAAoC,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAAiB,EACU,EAAE;IAC7B,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAC/C,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAE5C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,QAAQ,CAAC,KAAK,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}
package/dist/layer.d.ts CHANGED
@@ -1,6 +1,23 @@
1
- import type { Gate } from './gate.js';
2
- /** Backward-compatible alias while `Layer` migrates to `Gate`. */
3
- export type Layer = Gate;
4
- /** Backward-compatible alias while `composeLayers()` migrates to `composeGates()`. */
5
- export declare const composeLayers: <I, O>(gates: readonly Gate[], trail: import("./trail.js").Trail<I, O>, implementation: import("./types.js").Implementation<I, O>) => import("./types.js").Implementation<I, O>;
1
+ import type { AnyTrail } from './trail.js';
2
+ import type { Implementation } from './types.js';
3
+ /** A composable layer that wraps trail implementations. */
4
+ export interface Layer {
5
+ readonly name: string;
6
+ readonly description?: string | undefined;
7
+ /**
8
+ * Wrap a trail's implementation, returning a new implementation.
9
+ *
10
+ * The trail is passed for metadata inspection (intent, schema, etc.).
11
+ * The implementation and return type are generic over the input/output
12
+ * types so layers remain type-safe when composed.
13
+ */
14
+ wrap<I, O>(trail: AnyTrail, implementation: Implementation<I, O>): Implementation<I, O>;
15
+ }
16
+ /**
17
+ * Apply layers outermost-first: layers[0] wraps layers[1] wraps ... wraps
18
+ * the base implementation.
19
+ *
20
+ * An empty layers array returns the implementation unchanged.
21
+ */
22
+ export declare const composeLayers: <I, O>(layers: readonly Layer[], trail: AnyTrail, implementation: Implementation<I, O>) => Implementation<I, O>;
6
23
  //# sourceMappingURL=layer.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../src/layer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,kEAAkE;AAClE,MAAM,MAAM,KAAK,GAAG,IAAI,CAAC;AAEzB,sFAAsF;AACtF,eAAO,MAAM,aAAa,iLAAe,CAAC"}
1
+ {"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../src/layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,2DAA2D;AAC3D,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1C;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,EAAE,CAAC,EACP,KAAK,EAAE,QAAQ,EACf,cAAc,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GACnC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACzB;AAMD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAChC,QAAQ,SAAS,KAAK,EAAE,EACxB,OAAO,QAAQ,EACf,gBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,KACnC,cAAc,CAAC,CAAC,EAAE,CAAC,CAUrB,CAAC"}
package/dist/layer.js CHANGED
@@ -1,4 +1,21 @@
1
- import { composeGates } from './gate.js';
2
- /** Backward-compatible alias while `composeLayers()` migrates to `composeGates()`. */
3
- export const composeLayers = composeGates;
1
+ // ---------------------------------------------------------------------------
2
+ // Composition
3
+ // ---------------------------------------------------------------------------
4
+ /**
5
+ * Apply layers outermost-first: layers[0] wraps layers[1] wraps ... wraps
6
+ * the base implementation.
7
+ *
8
+ * An empty layers array returns the implementation unchanged.
9
+ */
10
+ export const composeLayers = (layers, trail, implementation) => {
11
+ // Fold right so layers[0] is the outermost wrapper.
12
+ let result = implementation;
13
+ for (let i = layers.length - 1; i >= 0; i -= 1) {
14
+ const layer = layers[i];
15
+ if (layer) {
16
+ result = layer.wrap(trail, result);
17
+ }
18
+ }
19
+ return result;
20
+ };
4
21
  //# sourceMappingURL=layer.js.map
package/dist/layer.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"layer.js","sourceRoot":"","sources":["../src/layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAMzC,sFAAsF;AACtF,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC"}
1
+ {"version":3,"file":"layer.js","sourceRoot":"","sources":["../src/layer.ts"],"names":[],"mappings":"AAyBA,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAwB,EACxB,KAAe,EACf,cAAoC,EACd,EAAE;IACxB,oDAAoD;IACpD,IAAI,MAAM,GAAG,cAAc,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
@@ -24,5 +24,5 @@ export declare const isPathSafe: (basePath: string, userPath: string) => boolean
24
24
  * Joins multiple path segments, resolves them against `basePath`, and
25
25
  * validates the result stays within the base directory.
26
26
  */
27
- export declare const resolveSafePath: (basePath: string, ...segments: string[]) => Result<string, PermissionError>;
27
+ export declare const deriveSafePath: (basePath: string, ...segments: string[]) => Result<string, PermissionError>;
28
28
  //# sourceMappingURL=path-security.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"path-security.d.ts","sourceRoot":"","sources":["../src/path-security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAmBrC;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,EAAE,eAAe,CAgBhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,EAAE,UAAU,MAAM,KAAG,OAI/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,GAAG,UAAU,MAAM,EAAE,KACpB,MAAM,CAAC,MAAM,EAAE,eAAe,CAchC,CAAC"}
1
+ {"version":3,"file":"path-security.d.ts","sourceRoot":"","sources":["../src/path-security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAmBrC;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,EAAE,eAAe,CAgBhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,EAAE,UAAU,MAAM,KAAG,OAI/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,GAAG,UAAU,MAAM,EAAE,KACpB,MAAM,CAAC,MAAM,EAAE,eAAe,CAchC,CAAC"}
@@ -52,7 +52,7 @@ export const isPathSafe = (basePath, userPath) => {
52
52
  * Joins multiple path segments, resolves them against `basePath`, and
53
53
  * validates the result stays within the base directory.
54
54
  */
55
- export const resolveSafePath = (basePath, ...segments) => {
55
+ export const deriveSafePath = (basePath, ...segments) => {
56
56
  const base = resolve(basePath);
57
57
  const joined = resolve(base, ...segments.map((s) => normalize(s)));
58
58
  if (!isWithin(base, joined)) {
@@ -1 +1 @@
1
- {"version":3,"file":"path-security.js","sourceRoot":"","sources":["../src/path-security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,wEAAwE;AACxE,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,MAAc,EAAW,EAAE;IACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,kDAAkD;IAClD,uDAAuD;IACvD,sDAAsD;IACtD,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,QAAgB,EAChB,QAAgB,EACiB,EAAE;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,GAAG,CACf,IAAI,eAAe,CACjB,6BAA6B,QAAQ,cAAc,QAAQ,GAAG,EAC9D;YACE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAChD,CACF,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,QAAgB,EAAW,EAAE;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAAgB,EAChB,GAAG,QAAkB,EACY,EAAE;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,GAAG,CACf,IAAI,eAAe,CACjB,6CAA6C,QAAQ,GAAG,EACxD,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAC5D,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC,CAAC"}
1
+ {"version":3,"file":"path-security.js","sourceRoot":"","sources":["../src/path-security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,wEAAwE;AACxE,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,MAAc,EAAW,EAAE;IACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,kDAAkD;IAClD,uDAAuD;IACvD,sDAAsD;IACtD,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,QAAgB,EAChB,QAAgB,EACiB,EAAE;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,GAAG,CACf,IAAI,eAAe,CACjB,6BAA6B,QAAQ,cAAc,QAAQ,GAAG,EAC9D;YACE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAChD,CACF,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,QAAgB,EAAW,EAAE;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,QAAgB,EAChB,GAAG,QAAkB,EACY,EAAE;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,GAAG,CACf,IAAI,eAAe,CACjB,6CAA6C,QAAQ,GAAG,EACxD,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAC5D,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC,CAAC"}