@overkill-dev/engine 0.0.80 → 0.0.82

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 (202) hide show
  1. package/assertion-protocol/partial-matching.js +52 -2
  2. package/assertion-protocol/partial-matching.js.map +1 -1
  3. package/assertion-protocol/source-location.js +1 -1
  4. package/assertion-protocol/source-location.js.map +1 -1
  5. package/canonical-identity.d.ts +1 -0
  6. package/canonical-identity.d.ts.map +1 -1
  7. package/canonical-identity.js +27 -11
  8. package/canonical-identity.js.map +1 -1
  9. package/engine/assertion-result-schema.d.ts +323 -0
  10. package/engine/assertion-result-schema.d.ts.map +1 -1
  11. package/engine/assertion-result-schema.js +39 -1
  12. package/engine/assertion-result-schema.js.map +1 -1
  13. package/engine/benchmark-attempt.d.ts.map +1 -1
  14. package/engine/benchmark-attempt.js +3 -2
  15. package/engine/benchmark-attempt.js.map +1 -1
  16. package/engine/benchmark-node.d.ts +9 -8
  17. package/engine/benchmark-node.d.ts.map +1 -1
  18. package/engine/benchmark-node.js.map +1 -1
  19. package/engine/body-reference-participants.js +72 -0
  20. package/engine/body-reference-participants.js.map +1 -0
  21. package/engine/body-reference-plan.d.ts +15 -0
  22. package/engine/body-reference-plan.d.ts.map +1 -0
  23. package/engine/body-reference-plan.js +242 -0
  24. package/engine/body-reference-plan.js.map +1 -0
  25. package/engine/body-reference.d.ts +16 -0
  26. package/engine/body-reference.d.ts.map +1 -0
  27. package/engine/body-reference.js +30 -0
  28. package/engine/body-reference.js.map +1 -0
  29. package/engine/case-attempt-execution.js +4 -37
  30. package/engine/case-attempt-execution.js.map +1 -1
  31. package/engine/case-attempt-result.js +74 -0
  32. package/engine/case-attempt-result.js.map +1 -0
  33. package/engine/case-body-execution.js +6 -1
  34. package/engine/case-body-execution.js.map +1 -1
  35. package/engine/case-body.js +11 -5
  36. package/engine/case-body.js.map +1 -1
  37. package/engine/case-execution-context.d.ts +2 -0
  38. package/engine/case-execution-context.d.ts.map +1 -1
  39. package/engine/case-execution.d.ts +1 -1
  40. package/engine/case-execution.d.ts.map +1 -1
  41. package/engine/case-execution.js +8 -2
  42. package/engine/case-execution.js.map +1 -1
  43. package/engine/case-interruption.js.map +1 -1
  44. package/engine/case-policy.js +6 -0
  45. package/engine/case-policy.js.map +1 -1
  46. package/engine/debug-checkpoints.js +43 -0
  47. package/engine/debug-checkpoints.js.map +1 -0
  48. package/engine/execution-global-error-observer.d.ts.map +1 -1
  49. package/engine/execution-global-error-observer.js +2 -1
  50. package/engine/execution-global-error-observer.js.map +1 -1
  51. package/engine/execution-observation.d.ts +0 -4
  52. package/engine/execution-observation.d.ts.map +1 -1
  53. package/engine/execution-observation.js +10 -46
  54. package/engine/execution-observation.js.map +1 -1
  55. package/engine/execution-result.d.ts.map +1 -1
  56. package/engine/execution-result.js +1 -0
  57. package/engine/execution-result.js.map +1 -1
  58. package/engine/execution-supervision-state.d.ts +1 -1
  59. package/engine/execution-supervision-state.d.ts.map +1 -1
  60. package/engine/execution-supervision-state.js +2 -1
  61. package/engine/execution-supervision-state.js.map +1 -1
  62. package/engine/execution-test-plan-cases.js.map +1 -1
  63. package/engine/execution.d.ts.map +1 -1
  64. package/engine/execution.js +16 -5
  65. package/engine/execution.js.map +1 -1
  66. package/engine/family-run.d.ts.map +1 -1
  67. package/engine/family-run.js +14 -9
  68. package/engine/family-run.js.map +1 -1
  69. package/engine/native-resource-observation.js +1 -1
  70. package/engine/native-resource-observation.js.map +1 -1
  71. package/engine/reporter-dispatcher.js +1 -1
  72. package/engine/reporter-dispatcher.js.map +1 -1
  73. package/engine/reporter-managed-output.js +3 -3
  74. package/engine/reporter-managed-output.js.map +1 -1
  75. package/engine/reporter-output-scope.js +1 -1
  76. package/engine/reporter-output-scope.js.map +1 -1
  77. package/engine/reporter.d.ts +4 -0
  78. package/engine/reporter.d.ts.map +1 -1
  79. package/engine/reporter.js.map +1 -1
  80. package/engine/reporting-context.js +4 -4
  81. package/engine/reporting-context.js.map +1 -1
  82. package/engine/resource-check-outcome.js +34 -0
  83. package/engine/resource-check-outcome.js.map +1 -0
  84. package/engine/resource-check-reporting.js +96 -0
  85. package/engine/resource-check-reporting.js.map +1 -0
  86. package/engine/resource-owner-observation.js +1 -1
  87. package/engine/resource-owner-observation.js.map +1 -1
  88. package/engine/run-result.d.ts +18 -15
  89. package/engine/run-result.d.ts.map +1 -1
  90. package/engine/run-result.js +1 -4
  91. package/engine/run-result.js.map +1 -1
  92. package/engine/test-body-resource-attachment.d.ts +3 -1
  93. package/engine/test-body-resource-attachment.d.ts.map +1 -1
  94. package/engine/test-body-resource-attachment.js +10 -2
  95. package/engine/test-body-resource-attachment.js.map +1 -1
  96. package/engine/test-body.d.ts +12 -2
  97. package/engine/test-body.d.ts.map +1 -1
  98. package/engine/test-body.js +37 -8
  99. package/engine/test-body.js.map +1 -1
  100. package/engine/test-data.js +5 -5
  101. package/engine/test-data.js.map +1 -1
  102. package/engine/test-debug-context.js +11 -30
  103. package/engine/test-debug-context.js.map +1 -1
  104. package/engine/test-debug.d.ts +3 -3
  105. package/engine/test-family.d.ts +4 -10
  106. package/engine/test-family.d.ts.map +1 -1
  107. package/engine/test-family.js +2 -46
  108. package/engine/test-family.js.map +1 -1
  109. package/engine/test-node.d.ts +16 -14
  110. package/engine/test-node.d.ts.map +1 -1
  111. package/engine/test-node.js +9 -5
  112. package/engine/test-node.js.map +1 -1
  113. package/engine/test-plan.d.ts.map +1 -1
  114. package/engine/test-plan.js +6 -6
  115. package/engine/test-plan.js.map +1 -1
  116. package/engine/workload-input.js +1 -1
  117. package/engine/workload-input.js.map +1 -1
  118. package/engine/workload-test-case.js +4 -4
  119. package/engine/workload-test-case.js.map +1 -1
  120. package/execution-ownership.d.ts +33 -0
  121. package/execution-ownership.d.ts.map +1 -0
  122. package/execution-ownership.js +45 -0
  123. package/execution-ownership.js.map +1 -0
  124. package/implementation-assignment.d.ts +11 -0
  125. package/implementation-assignment.d.ts.map +1 -0
  126. package/implementation-assignment.js +97 -0
  127. package/implementation-assignment.js.map +1 -0
  128. package/implementation-build-preparation.js +19 -0
  129. package/implementation-build-preparation.js.map +1 -0
  130. package/implementation-build.d.ts +41 -0
  131. package/implementation-build.d.ts.map +1 -0
  132. package/implementation-build.js +22 -0
  133. package/implementation-build.js.map +1 -0
  134. package/implementation-catalog.d.ts +39 -0
  135. package/implementation-catalog.d.ts.map +1 -0
  136. package/implementation-catalog.js +183 -0
  137. package/implementation-catalog.js.map +1 -0
  138. package/implementation-fingerprint.js +6 -0
  139. package/implementation-fingerprint.js.map +1 -0
  140. package/implementation-graph.d.ts +4 -0
  141. package/implementation-graph.d.ts.map +1 -0
  142. package/implementation-graph.js +135 -0
  143. package/implementation-graph.js.map +1 -0
  144. package/implementation-load-error.js +12 -0
  145. package/implementation-load-error.js.map +1 -0
  146. package/implementation-participant.d.ts +18 -0
  147. package/implementation-participant.d.ts.map +1 -0
  148. package/implementation-participant.js +30 -0
  149. package/implementation-participant.js.map +1 -0
  150. package/implementation-preload.js +16 -0
  151. package/implementation-preload.js.map +1 -0
  152. package/implementation-preparation.d.ts +19 -0
  153. package/implementation-preparation.d.ts.map +1 -0
  154. package/implementation-preparation.js +37 -0
  155. package/implementation-preparation.js.map +1 -0
  156. package/implementation-reference.d.ts +39 -0
  157. package/implementation-reference.d.ts.map +1 -0
  158. package/implementation-reference.js +57 -0
  159. package/implementation-reference.js.map +1 -0
  160. package/implementation-source-map.d.ts +6 -0
  161. package/implementation-source-map.d.ts.map +1 -0
  162. package/implementation-source-map.js +72 -0
  163. package/implementation-source-map.js.map +1 -0
  164. package/implementation-source.d.ts +5 -0
  165. package/implementation-source.d.ts.map +1 -0
  166. package/implementation-source.js +93 -0
  167. package/implementation-source.js.map +1 -0
  168. package/module-loading-scope.d.ts +22 -0
  169. package/module-loading-scope.d.ts.map +1 -1
  170. package/module-loading-scope.js +278 -0
  171. package/module-loading-scope.js.map +1 -1
  172. package/package.json +64 -2
  173. package/packages/engine/engine.entry-point.d.ts +13 -16
  174. package/packages/engine/engine.entry-point.d.ts.map +1 -1
  175. package/packages/engine/engine.entry-point.js +5 -34
  176. package/packages/engine/engine.entry-point.js.map +1 -1
  177. package/portable-value.d.ts +6 -0
  178. package/portable-value.d.ts.map +1 -0
  179. package/portable-value.js +56 -0
  180. package/portable-value.js.map +1 -0
  181. package/readme.md +69 -0
  182. package/resource-check-cancellation.d.ts +6 -0
  183. package/resource-check-cancellation.d.ts.map +1 -0
  184. package/resource-check-cancellation.js +66 -0
  185. package/resource-check-cancellation.js.map +1 -0
  186. package/resource-check-delivery.d.ts +19 -0
  187. package/resource-check-delivery.d.ts.map +1 -0
  188. package/resource-check-delivery.js +62 -0
  189. package/resource-check-delivery.js.map +1 -0
  190. package/resource-check-protocol.d.ts +74 -0
  191. package/resource-check-protocol.d.ts.map +1 -0
  192. package/resource-check-snapshot.d.ts +4 -0
  193. package/resource-check-snapshot.d.ts.map +1 -0
  194. package/resource-check-snapshot.js +20 -0
  195. package/resource-check-snapshot.js.map +1 -0
  196. package/software-bill-of-materials.cyclonedx.json +55 -4
  197. package/source-map-data.d.ts +26 -0
  198. package/source-map-data.d.ts.map +1 -0
  199. package/source-map-data.js +62 -0
  200. package/source-map-data.js.map +1 -0
  201. package/engine/case-interruption.d.ts +0 -8
  202. package/engine/case-interruption.d.ts.map +0 -1
@@ -0,0 +1,39 @@
1
+ import { z } from 'zod/v4';
2
+ import { type PortableValue } from './portable-value.ts';
3
+ import type { ImplementationAssignment, PreparedImplementationAssignments } from './implementation-assignment.ts';
4
+ import { type GraphIdentity } from './implementation-build.ts';
5
+ export type ImplementationBuild = {
6
+ readonly assignments: readonly ImplementationAssignment[];
7
+ readonly graph: GraphIdentity;
8
+ };
9
+ export type ImplementationCatalog = {
10
+ readonly projectRoot: string;
11
+ readonly builds: readonly ImplementationBuild[];
12
+ };
13
+ export type ImplementationAdmission = 'all' | 'consumer' | {
14
+ readonly body: boolean;
15
+ readonly ownerKeys: readonly string[];
16
+ };
17
+ export type ImplementationPlanState = {
18
+ readonly catalog: ImplementationCatalog | null;
19
+ readonly admission: ImplementationAdmission;
20
+ };
21
+ export declare const implementationCatalogSchema: z.ZodType<ImplementationCatalog>;
22
+ export declare function implementationBuildIdentity(prepared: PreparedImplementationAssignments): ImplementationBuild;
23
+ export declare function selectedImplementationAssignments(catalog: ImplementationCatalog, work: readonly string[]): readonly ImplementationAssignment[];
24
+ export declare function assertImplementationAssignments(expected: readonly ImplementationAssignment[], actual: readonly ImplementationAssignment[]): void;
25
+ export declare function mergeImplementationCatalogs(catalogs: readonly (ImplementationCatalog | null)[]): ImplementationCatalog | null;
26
+ export type ImplementationDeclaration = {
27
+ readonly kind: 'invalid';
28
+ readonly failure: {
29
+ readonly name: string;
30
+ readonly message: string;
31
+ readonly detail: PortableValue;
32
+ };
33
+ } | {
34
+ readonly kind: 'prepared';
35
+ readonly build: ImplementationBuild;
36
+ };
37
+ export declare const implementationDeclarationSchema: z.ZodType<ImplementationDeclaration>;
38
+ export declare function combineImplementationBuilds(builds: readonly ImplementationBuild[]): ImplementationBuild;
39
+ //# sourceMappingURL=implementation-catalog.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-catalog.d.ts","sourceRoot":"","sources":["../../../source/implementation-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,KAAK,EAAE,wBAAwB,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAClH,OAAO,EAA+B,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE5F,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CACjC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAAE,CAAC;AACvH,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,UAAU,GAAG;IACvD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;CAC/C,CAAC;AA0CF,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAKb,CAAC;AAC7D,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,iCAAiC,GAAG,mBAAmB,CAK5G;AAED,wBAAgB,iCAAiC,CAC7C,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE,SAAS,MAAM,EAAE,GACxB,SAAS,wBAAwB,EAAE,CAQrC;AACD,wBAAgB,+BAA+B,CAC3C,QAAQ,EAAE,SAAS,wBAAwB,EAAE,EAC7C,MAAM,EAAE,SAAS,wBAAwB,EAAE,GAC5C,IAAI,CAaN;AA2DD,wBAAgB,2BAA2B,CACvC,QAAQ,EAAE,SAAS,CAAC,qBAAqB,GAAG,IAAI,CAAC,EAAE,GACpD,qBAAqB,GAAG,IAAI,CAkB9B;AAED,MAAM,MAAM,yBAAyB,GAAG;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;KAClC,CAAC;CACL,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;CAAE,CAAC;AACxE,eAAO,MAAM,+BAA+B,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAM/E,CAAC;AAcH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,GAAG,mBAAmB,CAyBvG"}
@@ -0,0 +1,183 @@
1
+ import { isAbsolute } from 'node:path';
2
+ import { isDeepStrictEqual } from 'node:util';
3
+ import { z } from 'zod/v4';
4
+ import { moduleReferenceSchema } from "./implementation-reference.js";
5
+ import { snapshotPortableValue } from "./portable-value.js";
6
+ import { implementationFingerprint } from "./implementation-fingerprint.js";
7
+ import { implementationGraphIdentity } from "./implementation-build.js";
8
+ const portable = z.unknown().transform(snapshotPortableValue);
9
+ const fingerprint = z.string().regex(/^[a-f0-9]{64}$/u);
10
+ const source = z.strictObject({ url: z.url(), fingerprint });
11
+ const facts = z.strictObject({
12
+ module: moduleReferenceSchema,
13
+ realm: z.enum(['browser', 'host']),
14
+ version: z.string(),
15
+ input: portable,
16
+ dynamicModules: z.array(moduleReferenceSchema)
17
+ });
18
+ const assignment = z.strictObject({
19
+ key: z.string(),
20
+ role: z.enum(['body', 'observer', 'resource-consumer', 'resource-owner']),
21
+ scope: z.string().nullable(),
22
+ binding: portable,
23
+ facts
24
+ });
25
+ const graphData = z.strictObject({
26
+ build: z.string().regex(/^[a-f0-9]{64}$/u),
27
+ runtime: z.strictObject({
28
+ node: z.string(),
29
+ architecture: z.string(),
30
+ platform: z.string(),
31
+ typescript: z.union([z.literal('strip'), z.literal('transform'), z.literal(false)])
32
+ }),
33
+ modules: z.array(z.strictObject({
34
+ url: z.string(),
35
+ format: z.enum(['json', 'module', 'module-typescript']),
36
+ dependencies: z.record(z.string(), z.string()),
37
+ packages: z.array(source),
38
+ sourceMap: source.extend({ kind: z.enum(['external', 'inline']) }).nullable(),
39
+ deliveredFingerprint: fingerprint,
40
+ sourceFingerprint: fingerprint
41
+ })),
42
+ builtins: z.array(z.string()),
43
+ entries: z.record(z.string(), z.string())
44
+ });
45
+ const graph = graphData.refine(function validIdentity(value) {
46
+ const { build, ...identity } = value;
47
+ return implementationFingerprint(identity) === build;
48
+ }, 'Invalid implementation graph identity.');
49
+ export const implementationCatalogSchema = z
50
+ .strictObject({
51
+ projectRoot: z.string().refine(isAbsolute),
52
+ builds: z.array(z.strictObject({ assignments: z.array(assignment), graph })).min(1)
53
+ })
54
+ .transform(snapshotPortableValue);
55
+ export function implementationBuildIdentity(prepared) {
56
+ return {
57
+ assignments: prepared.assignments,
58
+ graph: { build: prepared.graph.build, ...implementationGraphIdentity(prepared.graph) }
59
+ };
60
+ }
61
+ export function selectedImplementationAssignments(catalog, work) {
62
+ return catalog.builds.flatMap(function assignments(build) {
63
+ return build.assignments.filter(function selected(entry) {
64
+ return work.some(function owned(key) {
65
+ return entry.key.startsWith(`${key}:`);
66
+ });
67
+ });
68
+ });
69
+ }
70
+ export function assertImplementationAssignments(expected, actual) {
71
+ if (expected.length !== actual.length || !isDeepStrictEqual(new Map(expected.map(function pair(entry) {
72
+ return [entry.key, entry];
73
+ })), new Map(actual.map(function pair(entry) {
74
+ return [entry.key, entry];
75
+ })))) {
76
+ throw new TypeError('Frozen implementation assignments changed; prepare and collect a new run.');
77
+ }
78
+ }
79
+ function mergedEvidence(entries, message) {
80
+ const evidence = new Map();
81
+ for (const [key, value] of entries) {
82
+ if (evidence.has(key) && !isDeepStrictEqual(evidence.get(key), value)) {
83
+ throw new TypeError(message);
84
+ }
85
+ evidence.set(key, value);
86
+ }
87
+ return evidence;
88
+ }
89
+ function assignmentEntries(builds) {
90
+ return builds.flatMap(function assigned(build) {
91
+ return build.assignments.map(function pair(entry) {
92
+ return [entry.key, entry];
93
+ });
94
+ });
95
+ }
96
+ function validateBuilds(builds) {
97
+ const [first] = builds;
98
+ for (const build of builds) {
99
+ if (!isDeepStrictEqual(build.graph.runtime, first?.graph.runtime)) {
100
+ throw new TypeError('Implementation runtimes differ.');
101
+ }
102
+ }
103
+ mergedEvidence(builds.flatMap(function entries(build) {
104
+ return build.graph.modules.map(function pair(module) {
105
+ return [module.url, module];
106
+ });
107
+ }), 'Implementation module builds differ.');
108
+ mergedEvidence(assignmentEntries(builds), 'Implementation assignments differ.');
109
+ mergedEvidence(builds.flatMap(function entries(build) {
110
+ return Object.entries(build.graph.entries);
111
+ }), 'Implementation entry resolutions differ.');
112
+ }
113
+ function groupedBuilds(builds) {
114
+ const grouped = new Map();
115
+ for (const build of builds) {
116
+ const previous = grouped.get(build.graph.build);
117
+ const assignments = mergedEvidence(assignmentEntries(previous === undefined ? [build] : [previous, build]), 'Implementation assignments differ.');
118
+ grouped.set(build.graph.build, { graph: build.graph, assignments: Array.from(assignments.values()) });
119
+ }
120
+ return Array.from(grouped.values());
121
+ }
122
+ export function mergeImplementationCatalogs(catalogs) {
123
+ const present = catalogs.filter(function available(catalog) {
124
+ return catalog !== null;
125
+ });
126
+ const [first] = present;
127
+ if (first === undefined) {
128
+ return null;
129
+ }
130
+ for (const catalog of present) {
131
+ if (catalog.projectRoot !== first.projectRoot) {
132
+ throw new TypeError('Implementation project roots differ.');
133
+ }
134
+ }
135
+ const builds = present.flatMap(function declared(catalog) {
136
+ return catalog.builds;
137
+ });
138
+ validateBuilds(builds);
139
+ return implementationCatalogSchema.parse({ projectRoot: first.projectRoot, builds: groupedBuilds(builds) });
140
+ }
141
+ export const implementationDeclarationSchema = z.discriminatedUnion('kind', [
142
+ z.strictObject({ kind: z.literal('prepared'), build: z.strictObject({ assignments: z.array(assignment), graph }) }),
143
+ z.strictObject({
144
+ kind: z.literal('invalid'),
145
+ failure: z.strictObject({ name: z.string(), message: z.string(), detail: portable })
146
+ })
147
+ ]);
148
+ function combinedModules(builds) {
149
+ const moduleEntries = builds.flatMap(function entries(build) {
150
+ return build.graph.modules.map(function pair(module) {
151
+ return [module.url, module];
152
+ });
153
+ });
154
+ const moduleMap = new Map(moduleEntries);
155
+ const modules = Array
156
+ .from(moduleMap.values());
157
+ return modules.toSorted(function byUrl(left, right) {
158
+ return left.url.localeCompare(right.url, 'en');
159
+ });
160
+ }
161
+ export function combineImplementationBuilds(builds) {
162
+ const [first] = builds;
163
+ if (first === undefined) {
164
+ throw new TypeError('Expected implementation builds.');
165
+ }
166
+ validateBuilds(builds);
167
+ const builtins = Array
168
+ .from(new Set(builds.flatMap(function names(build) {
169
+ return build.graph.builtins;
170
+ })))
171
+ .toSorted(function byUrl(left, right) {
172
+ return left.localeCompare(right, 'en');
173
+ });
174
+ const entries = Object.fromEntries(builds.flatMap(function mappings(build) {
175
+ return Object.entries(build.graph.entries);
176
+ }));
177
+ const identity = { modules: combinedModules(builds), builtins, entries, runtime: first.graph.runtime };
178
+ return {
179
+ assignments: Array.from(mergedEvidence(assignmentEntries(builds), 'Implementation assignments differ.').values()),
180
+ graph: { ...identity, build: implementationFingerprint(identity) }
181
+ };
182
+ }
183
+ //# sourceMappingURL=implementation-catalog.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-catalog.js","sourceRoot":"","sources":["../../../source/implementation-catalog.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { canonicalJson } from "./canonical-identity.js";
3
+ export function implementationFingerprint(value) {
4
+ return createHash('sha256').update(canonicalJson(value)).digest('hex');
5
+ }
6
+ //# sourceMappingURL=implementation-fingerprint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-fingerprint.js","sourceRoot":"","sources":["../../../source/implementation-fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACpD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { type ImplementationGraph as GraphDefinition } from './implementation-build.ts';
2
+ export type ImplementationGraph = GraphDefinition;
3
+ export {};
4
+ //# sourceMappingURL=implementation-graph.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-graph.d.ts","sourceRoot":"","sources":["../../../source/implementation-graph.ts"],"names":[],"mappings":"AAKA,OAAO,EAEH,KAAK,mBAAmB,IAAI,iBAE/B,MAAM,2BAA2B,CAAC;MAU7B,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAClD,MAAM,CAsFkB,EAA8F,CAAC"}
@@ -0,0 +1,135 @@
1
+ import { readFile, realpath } from 'node:fs/promises';
2
+ import { isBuiltin } from 'node:module';
3
+ import { fileURLToPath, pathToFileURL } from 'node:url';
4
+ import { isDeepStrictEqual } from 'node:util';
5
+ import { implementationFingerprint } from "./implementation-fingerprint.js";
6
+ import { implementationGraphIdentity } from "./implementation-build.js";
7
+ import { deliverImplementationSource } from "./implementation-source-map.js";
8
+ import { resolveModuleUrl, withModuleDelivery } from "./module-loading-scope.js";
9
+ import { implementationFormat, implementationImports, implementationPackages } from "./implementation-source.js";
10
+ async function canonicalModuleUrl(url) {
11
+ if (isBuiltin(url)) {
12
+ return url.startsWith('node:') ? url : `node:${url}`;
13
+ }
14
+ const parsed = new URL(url);
15
+ if (parsed.protocol !== 'file:' || parsed.search !== '' || parsed.hash !== '') {
16
+ throw new TypeError(`Unsupported native implementation URL: ${url}`);
17
+ }
18
+ return pathToFileURL(await realpath(fileURLToPath(url))).href;
19
+ }
20
+ async function readImplementationModule(url) {
21
+ const packages = await implementationPackages(url);
22
+ const format = implementationFormat(url, packages);
23
+ const source = await readFile(fileURLToPath(url), 'utf8');
24
+ const specifiers = format === 'json' ? [] : implementationImports(source, url);
25
+ const dependencies = Object.fromEntries(specifiers.map(function resolve(specifier) {
26
+ return [specifier, resolveModuleUrl(specifier, url)];
27
+ }));
28
+ return Object.freeze({
29
+ url,
30
+ format,
31
+ ...await deliverImplementationSource(source, url),
32
+ sourceFingerprint: implementationFingerprint(source),
33
+ dependencies: Object.freeze(dependencies),
34
+ packages: Object.freeze(packages)
35
+ });
36
+ }
37
+ function graphRoots(facts) {
38
+ if (facts.some(function unsupportedRealm(fact) {
39
+ return fact.realm !== 'host';
40
+ })) {
41
+ throw new TypeError('The native implementation loader supports the host realm only.');
42
+ }
43
+ return facts.flatMap(function modules(fact) {
44
+ return [
45
+ fact.module.moduleUrl,
46
+ ...fact.dynamicModules.map(function moduleUrl(module) {
47
+ return module.moduleUrl;
48
+ })
49
+ ];
50
+ });
51
+ }
52
+ async function collectGraph(roots, readModule) {
53
+ const modules = new Map();
54
+ const builtins = new Set();
55
+ async function visit(url) {
56
+ if (isBuiltin(url)) {
57
+ builtins.add(url.startsWith('node:') ? url : `node:${url}`);
58
+ return;
59
+ }
60
+ if (modules.has(url)) {
61
+ return;
62
+ }
63
+ const module = await readModule(url);
64
+ modules.set(url, module);
65
+ for (const dependency of Object.values(module.dependencies)) {
66
+ await visit(dependency);
67
+ }
68
+ }
69
+ for (const url of roots) {
70
+ await visit(url);
71
+ }
72
+ return {
73
+ modules: Object.freeze(Array.from(modules.values()).toSorted(function byUrl(left, right) {
74
+ return left.url.localeCompare(right.url, 'en');
75
+ })),
76
+ builtins: Object.freeze(Array.from(builtins).toSorted(function byUrl(left, right) {
77
+ return left.localeCompare(right, 'en');
78
+ }))
79
+ };
80
+ }
81
+ export function createImplementationGraphPreparation() {
82
+ const sources = new Map();
83
+ async function readModule(url) {
84
+ const existing = sources.get(url);
85
+ if (existing !== undefined) {
86
+ return existing;
87
+ }
88
+ const source = readImplementationModule(url);
89
+ sources.set(url, source);
90
+ return source;
91
+ }
92
+ return {
93
+ async prepare(facts) {
94
+ const entries = Object.freeze(Object.fromEntries(await Promise.all(graphRoots(facts).map(async function canonicalEntry(url) {
95
+ return [url, await canonicalModuleUrl(url)];
96
+ }))));
97
+ const graph = { ...await collectGraph(Object.values(entries), readModule), entries };
98
+ const runtime = Object.freeze({
99
+ node: process.version,
100
+ platform: process.platform,
101
+ architecture: process.arch,
102
+ typescript: process.features.typescript
103
+ });
104
+ return Object.freeze({
105
+ ...graph,
106
+ runtime,
107
+ build: implementationFingerprint(implementationGraphIdentity({ ...graph, runtime }))
108
+ });
109
+ }
110
+ };
111
+ }
112
+ export async function prepareImplementationGraph(facts) {
113
+ return await createImplementationGraphPreparation().prepare(facts);
114
+ }
115
+ export async function verifyImplementationGraph(graph, facts) {
116
+ if (!isDeepStrictEqual(await prepareImplementationGraph(facts), graph)) {
117
+ throw new TypeError('Implementation graph changed; prepare and collect a new run.');
118
+ }
119
+ }
120
+ export async function withImplementationGraph(graph, operation) {
121
+ const { build, ...identity } = graph;
122
+ if (build !== implementationFingerprint(implementationGraphIdentity(identity))) {
123
+ throw new TypeError('Invalid implementation graph identity.');
124
+ }
125
+ return await withModuleDelivery(graph, async function resolveEntries(load) {
126
+ return await operation(async function loadEntry(url) {
127
+ const target = graph.entries[url];
128
+ if (target === undefined) {
129
+ throw new TypeError('Implementation entry is outside the frozen graph.');
130
+ }
131
+ return await load(target);
132
+ });
133
+ });
134
+ }
135
+ //# sourceMappingURL=implementation-graph.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-graph.js","sourceRoot":"","sources":["../../../source/implementation-graph.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ const loadErrorBrand = Symbol.for('@overkill-dev/ImplementationLoadError');
2
+ export class ImplementationLoadError extends Error {
3
+ constructor(message, options) {
4
+ super(message, options);
5
+ this.name = 'ImplementationLoadError';
6
+ Object.defineProperty(this, loadErrorBrand, { value: true });
7
+ }
8
+ }
9
+ export function isImplementationLoadError(value) {
10
+ return value instanceof Error && Reflect.get(value, loadErrorBrand) === true;
11
+ }
12
+ //# sourceMappingURL=implementation-load-error.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-load-error.js","sourceRoot":"","sources":["../../../source/implementation-load-error.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;AAC3E,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC9C,YAAmB,OAAe,EAAE,OAAqB;QACrD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;CACJ;AACD,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACpD,OAAO,KAAK,YAAY,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,KAAK,IAAI,CAAC;AACjF,CAAC"}
@@ -0,0 +1,18 @@
1
+ import type { ImplementationFacts, ImplementationInputContext, ImplementationReference } from './implementation-reference.ts';
2
+ import type { PortableValue } from './portable-value.ts';
3
+ export type ImplementationActivation = {
4
+ readonly run: <Value>(operation: () => Promise<Value>) => Promise<Value>;
5
+ };
6
+ export type ImplementationParticipant = {
7
+ readonly key: string;
8
+ readonly role: 'body' | 'observer' | 'resource-consumer' | 'resource-owner';
9
+ readonly scope: string | null;
10
+ readonly binding: PortableValue;
11
+ readonly reference: ImplementationReference<PortableValue>;
12
+ readonly bind: (namespace: unknown, facts: ImplementationFacts, context: ImplementationInputContext) => ImplementationActivation;
13
+ };
14
+ export declare function readImplementationParticipants(value: unknown): readonly ImplementationParticipant[];
15
+ export type ImplementationCarrier = Readonly<Record<string, unknown>> | ((...parameters: readonly never[]) => unknown);
16
+ export declare function attachImplementationParticipants<Value extends ImplementationCarrier>(value: Value, participants: readonly ImplementationParticipant[]): Value;
17
+ export declare function withImplementationActivations<Value>(activations: readonly ImplementationActivation[], operation: () => Promise<Value>): Promise<Value>;
18
+ //# sourceMappingURL=implementation-participant.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-participant.d.ts","sourceRoot":"","sources":["../../../source/implementation-participant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,wBAAwB,GAAG;IACnC,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;CAC5E,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC,aAAa,CAAC,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,CACX,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,0BAA0B,KAClC,wBAAwB,CAAC;CACjC,CAAC;AAUF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,yBAAyB,EAAE,CAEnG;AAED,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,SAAS,KAAK,EAAE,KAAK,OAAO,CAAC,CAAC;AAEvH,wBAAgB,gCAAgC,CAAC,KAAK,SAAS,qBAAqB,EAChF,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,SAAS,yBAAyB,EAAE,GACnD,KAAK,CAaP;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EACrD,WAAW,EAAE,SAAS,wBAAwB,EAAE,EAChD,SAAS,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAChC,OAAO,CAAC,KAAK,CAAC,CAQhB"}
@@ -0,0 +1,30 @@
1
+ const participantsKey = Symbol.for('@overkill-dev/ImplementationParticipants');
2
+ function hasParticipants(value) {
3
+ return (typeof value === 'object' && value !== null || typeof value === 'function') &&
4
+ Object.hasOwn(value, participantsKey);
5
+ }
6
+ export function readImplementationParticipants(value) {
7
+ return hasParticipants(value) ? value[participantsKey] : [];
8
+ }
9
+ export function attachImplementationParticipants(value, participants) {
10
+ if (participants.length === 0) {
11
+ return value;
12
+ }
13
+ const merged = new Map(readImplementationParticipants(value).map(function entry(participant) {
14
+ return [participant.key, participant];
15
+ }));
16
+ for (const participant of participants) {
17
+ merged.set(participant.key, participant);
18
+ }
19
+ return Object.assign(value, { [participantsKey]: Object.freeze(Array.from(merged.values())) });
20
+ }
21
+ export async function withImplementationActivations(activations, operation) {
22
+ const [first, ...remaining] = activations;
23
+ if (first === undefined) {
24
+ return await operation();
25
+ }
26
+ return await first.run(async function activateRemaining() {
27
+ return await withImplementationActivations(remaining, operation);
28
+ });
29
+ }
30
+ //# sourceMappingURL=implementation-participant.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-participant.js","sourceRoot":"","sources":["../../../source/implementation-participant.ts"],"names":[],"mappings":"AAsBA,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;AAI/E,SAAS,eAAe,CAAC,KAAc;IACnC,OAAO,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;QAC/E,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAAc;IACzD,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChE,CAAC;AAID,MAAM,UAAU,gCAAgC,CAC5C,KAAY,EACZ,YAAkD;IAElD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAClB,8BAA8B,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,WAAW;QAChE,OAAO,CAAE,WAAW,CAAC,GAAG,EAAE,WAAW,CAAE,CAAC;IAC5C,CAAC,CAAC,CACL,CAAC;IACF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAC/C,WAAgD,EAChD,SAA+B;IAE/B,MAAM,CAAE,KAAK,EAAE,GAAG,SAAS,CAAE,GAAG,WAAW,CAAC;IAC5C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,MAAM,SAAS,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,KAAK,CAAC,GAAG,CAAC,KAAK,UAAU,iBAAiB;QACnD,OAAO,MAAM,6BAA6B,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACP,CAAC"}
@@ -0,0 +1,16 @@
1
+ export async function preloadImplementation(load, signal) {
2
+ signal.throwIfAborted();
3
+ const aborted = Promise.withResolvers();
4
+ function abort() {
5
+ aborted.reject(signal.reason);
6
+ }
7
+ signal.addEventListener('abort', abort, { once: true });
8
+ try {
9
+ return await Promise.race([load(), aborted.promise]);
10
+ }
11
+ finally {
12
+ signal.removeEventListener('abort', abort);
13
+ aborted.reject(new Error('Implementation preload completed.'));
14
+ }
15
+ }
16
+ //# sourceMappingURL=implementation-preload.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-preload.js","sourceRoot":"","sources":["../../../source/implementation-preload.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,IAAqD,EACrD,MAAmB;IAEnB,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,EAAS,CAAC;IAC/C,SAAS,KAAK;QACV,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAE,IAAI,EAAE,EAAE,OAAO,CAAC,OAAO,CAAE,CAAC,CAAC;IAC3D,CAAC;YAAS,CAAC;QACP,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC;IACnE,CAAC;AACL,CAAC"}
@@ -0,0 +1,19 @@
1
+ import { type ImplementationFacts, type ImplementationInputContext, type ImplementationReference } from './implementation-reference.ts';
2
+ import { type PortableValue } from './portable-value.ts';
3
+ import type { ImplementationGraph } from './implementation-graph.ts';
4
+ export type PreparedImplementation = {
5
+ readonly facts: ImplementationFacts;
6
+ readonly graph: ImplementationGraph;
7
+ };
8
+ export type ImplementationPreparation<Input extends PortableValue> = {
9
+ readonly reference: ImplementationReference<Input>;
10
+ readonly context: ImplementationInputContext;
11
+ readonly signal: AbortSignal;
12
+ };
13
+ export declare function prepareImplementation<Input extends PortableValue>(request: ImplementationPreparation<Input>): Promise<PreparedImplementation>;
14
+ export type ImplementationAdmission<Input extends PortableValue, Implementation> = ImplementationPreparation<Input> & {
15
+ readonly prepared: PreparedImplementation;
16
+ readonly parseImplementation: (value: unknown) => Implementation;
17
+ };
18
+ export declare function withPreparedImplementation<Input extends PortableValue, Implementation, Result>(request: ImplementationAdmission<Input, Implementation>, use: (implementation: Implementation, input: Input) => Promise<Result>): Promise<Result>;
19
+ //# sourceMappingURL=implementation-preparation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-preparation.d.ts","sourceRoot":"","sources":["../../../source/implementation-preparation.ts"],"names":[],"mappings":"AAGA,OAAO,EAGH,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,MAAM,sBAAsB,GAAG;IACjC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,yBAAyB,CAAC,KAAK,SAAS,aAAa,IAAI;IACjE,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAChC,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,KAAK,SAAS,aAAa,EACnE,OAAO,EAAE,yBAAyB,CAAC,KAAK,CAAC,GAC1C,OAAO,CAAC,sBAAsB,CAAC,CAOjC;AAED,MAAM,MAAM,uBAAuB,CAAC,KAAK,SAAS,aAAa,EAAE,cAAc,IAAI,yBAAyB,CAAC,KAAK,CAAC,GAAG;IAClH,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,cAAc,CAAC;CACpE,CAAC;AAEF,wBAAsB,0BAA0B,CAAC,KAAK,SAAS,aAAa,EAAE,cAAc,EAAE,MAAM,EAChG,OAAO,EAAE,uBAAuB,CAAC,KAAK,EAAE,cAAc,CAAC,EACvD,GAAG,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,GACvE,OAAO,CAAC,MAAM,CAAC,CAwBjB"}
@@ -0,0 +1,37 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { withRunnerInfrastructure } from "./execution-ownership.js";
3
+ import { preloadImplementation } from "./implementation-preload.js";
4
+ import { implementationFacts, readImplementationExport } from "./implementation-reference.js";
5
+ import { snapshotPortableValue } from "./portable-value.js";
6
+ export async function prepareImplementation(request) {
7
+ request.signal.throwIfAborted();
8
+ const facts = implementationFacts(request.reference, request.context);
9
+ const { prepareImplementationGraph } = await import("./implementation-graph.js");
10
+ const graph = await prepareImplementationGraph([facts]);
11
+ request.signal.throwIfAborted();
12
+ return Object.freeze({ facts, graph });
13
+ }
14
+ export async function withPreparedImplementation(request, use) {
15
+ request.signal.throwIfAborted();
16
+ const input = snapshotPortableValue(request.reference.parseInput(request.reference.input, request.context));
17
+ const facts = implementationFacts(request.reference, request.context);
18
+ if (!isDeepStrictEqual(facts, request.prepared.facts) || !isDeepStrictEqual(input, facts.input)) {
19
+ throw new TypeError('Implementation inputs changed; prepare and collect a new run.');
20
+ }
21
+ const { verifyImplementationGraph, withImplementationGraph } = await withRunnerInfrastructure(async function graph() {
22
+ return await import("./implementation-graph.js");
23
+ });
24
+ await verifyImplementationGraph(request.prepared.graph, [facts]);
25
+ request.signal.throwIfAborted();
26
+ return await withImplementationGraph(request.prepared.graph, async function admit(load) {
27
+ const loaded = await withRunnerInfrastructure(async function preload() {
28
+ return await preloadImplementation(async function loadEntry() {
29
+ return await load(facts.module.moduleUrl);
30
+ }, request.signal);
31
+ });
32
+ const implementation = readImplementationExport(loaded.namespace, facts, request.parseImplementation);
33
+ request.signal.throwIfAborted();
34
+ return await use(implementation, input);
35
+ });
36
+ }
37
+ //# sourceMappingURL=implementation-preparation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-preparation.js","sourceRoot":"","sources":["../../../source/implementation-preparation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EACH,mBAAmB,EACnB,wBAAwB,EAI3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAsB,MAAM,qBAAqB,CAAC;AAchF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,OAAyC;IAEzC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,MAAM,EAAE,0BAA0B,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC,CAAE,KAAK,CAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3C,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC5C,OAAuD,EACvD,GAAsE;IAEtE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5G,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9F,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,GAAG,MAAM,wBAAwB,CACzF,KAAK,UAAU,KAAK;QAChB,OAAO,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACrD,CAAC,CACJ,CAAC;IACF,MAAM,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAE,KAAK,CAAE,CAAC,CAAC;IACnE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,OAAO,MAAM,uBAAuB,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,UAAU,KAAK,CAAC,IAAI;QAClF,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,KAAK,UAAU,OAAO;YAChE,OAAO,MAAM,qBAAqB,CAAC,KAAK,UAAU,SAAS;gBACvD,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,MAAM,cAAc,GAAG,wBAAwB,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACtG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAChC,OAAO,MAAM,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC"}
@@ -0,0 +1,39 @@
1
+ import type { Except } from 'type-fest';
2
+ import { z } from 'zod/v4';
3
+ import { type PortableValue } from './portable-value.ts';
4
+ export type ModuleReference = {
5
+ readonly moduleUrl: string;
6
+ readonly exportName: string;
7
+ };
8
+ export type ImplementationRealm = 'browser' | 'host';
9
+ export type ImplementationInputContext = {
10
+ readonly projectRoot: string;
11
+ };
12
+ export type ImplementationReference<Input extends PortableValue> = {
13
+ readonly kind: 'implementation-reference';
14
+ readonly module: ModuleReference;
15
+ readonly realm: ImplementationRealm;
16
+ readonly version: string;
17
+ readonly input: PortableValue;
18
+ readonly parseInput: (input: unknown, context: ImplementationInputContext) => Input;
19
+ readonly dynamicModules: readonly ModuleReference[];
20
+ };
21
+ export type ImplementationExport<Implementation> = {
22
+ readonly version: string;
23
+ readonly implementation: Implementation;
24
+ };
25
+ export type ImplementationFacts = {
26
+ readonly module: ModuleReference;
27
+ readonly realm: ImplementationRealm;
28
+ readonly version: string;
29
+ readonly input: PortableValue;
30
+ readonly dynamicModules: readonly ModuleReference[];
31
+ };
32
+ export declare const moduleReferenceSchema: z.ZodObject<{
33
+ moduleUrl: z.ZodURL;
34
+ exportName: z.ZodString;
35
+ }, z.core.$strict>;
36
+ export declare function defineImplementationReference<Input extends PortableValue>(reference: Except<ImplementationReference<Input>, 'kind'>): ImplementationReference<Input>;
37
+ export declare function implementationFacts<Input extends PortableValue>(reference: ImplementationReference<Input>, context: ImplementationInputContext): ImplementationFacts;
38
+ export declare function readImplementationExport<Implementation>(namespace: unknown, facts: ImplementationFacts, parseImplementation: (input: unknown) => Implementation): Implementation;
39
+ //# sourceMappingURL=implementation-reference.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-reference.d.ts","sourceRoot":"","sources":["../../../source/implementation-reference.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEhF,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,0BAA0B,GAAG;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAAE,CAAC;AAC3E,MAAM,MAAM,uBAAuB,CAAC,KAAK,SAAS,aAAa,IAAI;IAC/D,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,0BAA0B,KAAK,KAAK,CAAC;IACpF,QAAQ,CAAC,cAAc,EAAE,SAAS,eAAe,EAAE,CAAC;CACvD,CAAC;AACF,MAAM,MAAM,oBAAoB,CAAC,cAAc,IAAI;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CAC3C,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,SAAS,eAAe,EAAE,CAAC;CACvD,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;kBAGhC,CAAC;AAWH,wBAAgB,6BAA6B,CAAC,KAAK,SAAS,aAAa,EACrE,SAAS,EAAE,MAAM,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GAC1D,uBAAuB,CAAC,KAAK,CAAC,CAchC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,aAAa,EAC3D,SAAS,EAAE,uBAAuB,CAAC,KAAK,CAAC,EACzC,OAAO,EAAE,0BAA0B,GACpC,mBAAmB,CAWrB;AAED,wBAAgB,wBAAwB,CAAC,cAAc,EACnD,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,mBAAmB,EAC1B,mBAAmB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,cAAc,GACxD,cAAc,CAYhB"}