@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.
- package/.turbo/turbo-lint.log +1 -1
- package/CHANGELOG.md +17 -0
- package/README.md +19 -14
- package/dist/branded.d.ts +1 -1
- package/dist/branded.d.ts.map +1 -1
- package/dist/branded.js +1 -1
- package/dist/branded.js.map +1 -1
- package/dist/context.d.ts +13 -1
- package/dist/context.d.ts.map +1 -1
- package/dist/context.js +19 -3
- package/dist/context.js.map +1 -1
- package/dist/contour.d.ts +81 -0
- package/dist/contour.d.ts.map +1 -0
- package/dist/contour.js +176 -0
- package/dist/contour.js.map +1 -0
- package/dist/cross-schema.d.ts +18 -0
- package/dist/cross-schema.d.ts.map +1 -0
- package/dist/cross-schema.js +29 -0
- package/dist/cross-schema.js.map +1 -0
- package/dist/derive.d.ts +6 -0
- package/dist/derive.d.ts.map +1 -1
- package/dist/derive.js +29 -5
- package/dist/derive.js.map +1 -1
- package/dist/draft.d.ts +28 -0
- package/dist/draft.d.ts.map +1 -0
- package/dist/draft.js +157 -0
- package/dist/draft.js.map +1 -0
- package/dist/errors.d.ts +62 -4
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +44 -1
- package/dist/errors.js.map +1 -1
- package/dist/execute.d.ts +26 -9
- package/dist/execute.d.ts.map +1 -1
- package/dist/execute.js +441 -20
- package/dist/execute.js.map +1 -1
- package/dist/fire.d.ts +43 -0
- package/dist/fire.d.ts.map +1 -0
- package/dist/fire.js +185 -0
- package/dist/fire.js.map +1 -0
- package/dist/index.d.ts +33 -17
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +26 -12
- package/dist/index.js.map +1 -1
- package/dist/internal/cross-batch.d.ts +44 -0
- package/dist/internal/cross-batch.d.ts.map +1 -0
- package/dist/internal/cross-batch.js +58 -0
- package/dist/internal/cross-batch.js.map +1 -0
- package/dist/internal/fork-ctx.d.ts +41 -0
- package/dist/internal/fork-ctx.d.ts.map +1 -0
- package/dist/internal/fork-ctx.js +47 -0
- package/dist/internal/fork-ctx.js.map +1 -0
- package/dist/internal/signal-ref.d.ts +15 -0
- package/dist/internal/signal-ref.d.ts.map +1 -0
- package/dist/internal/signal-ref.js +41 -0
- package/dist/internal/signal-ref.js.map +1 -0
- package/dist/internal/topo-saves.d.ts +53 -0
- package/dist/internal/topo-saves.d.ts.map +1 -0
- package/dist/internal/topo-saves.js +449 -0
- package/dist/internal/topo-saves.js.map +1 -0
- package/dist/internal/topo-snapshots.d.ts +57 -0
- package/dist/internal/topo-snapshots.d.ts.map +1 -0
- package/dist/internal/topo-snapshots.js +372 -0
- package/dist/internal/topo-snapshots.js.map +1 -0
- package/dist/internal/topo-store-read.d.ts +70 -0
- package/dist/internal/topo-store-read.d.ts.map +1 -0
- package/dist/internal/topo-store-read.js +221 -0
- package/dist/internal/topo-store-read.js.map +1 -0
- package/dist/internal/topo-store.d.ts +26 -0
- package/dist/internal/topo-store.d.ts.map +1 -0
- package/dist/internal/topo-store.js +621 -0
- package/dist/internal/topo-store.js.map +1 -0
- package/dist/internal/tracing.d.ts +98 -0
- package/dist/internal/tracing.d.ts.map +1 -0
- package/dist/internal/tracing.js +102 -0
- package/dist/internal/tracing.js.map +1 -0
- package/dist/internal/trails-db.d.ts +16 -0
- package/dist/internal/trails-db.d.ts.map +1 -0
- package/dist/internal/trails-db.js +118 -0
- package/dist/internal/trails-db.js.map +1 -0
- package/dist/internal/zod-wrappers.d.ts +40 -0
- package/dist/internal/zod-wrappers.d.ts.map +1 -0
- package/dist/internal/zod-wrappers.js +59 -0
- package/dist/internal/zod-wrappers.js.map +1 -0
- package/dist/layer.d.ts +22 -5
- package/dist/layer.d.ts.map +1 -1
- package/dist/layer.js +20 -3
- package/dist/layer.js.map +1 -1
- package/dist/path-security.d.ts +1 -1
- package/dist/path-security.d.ts.map +1 -1
- package/dist/path-security.js +1 -1
- package/dist/path-security.js.map +1 -1
- package/dist/resilience.d.ts +1 -1
- package/dist/resilience.d.ts.map +1 -1
- package/dist/resilience.js +3 -3
- package/dist/resilience.js.map +1 -1
- package/dist/resource-config.d.ts +22 -0
- package/dist/resource-config.d.ts.map +1 -0
- package/dist/resource-config.js +210 -0
- package/dist/resource-config.js.map +1 -0
- package/dist/resource.d.ts +74 -0
- package/dist/resource.d.ts.map +1 -0
- package/dist/resource.js +61 -0
- package/dist/resource.js.map +1 -0
- package/dist/run.d.ts +4 -3
- package/dist/run.d.ts.map +1 -1
- package/dist/run.js +5 -4
- package/dist/run.js.map +1 -1
- package/dist/serialization.d.ts.map +1 -1
- package/dist/serialization.js +2 -1
- package/dist/serialization.js.map +1 -1
- package/dist/store/accessor-protocol.d.ts +51 -0
- package/dist/store/accessor-protocol.d.ts.map +1 -0
- package/dist/store/accessor-protocol.js +2 -0
- package/dist/store/accessor-protocol.js.map +1 -0
- package/dist/store/index.d.ts +2 -0
- package/dist/store/index.d.ts.map +1 -0
- package/dist/store/index.js +2 -0
- package/dist/store/index.js.map +1 -0
- package/dist/surface-filter.d.ts +13 -0
- package/dist/surface-filter.d.ts.map +1 -0
- package/dist/surface-filter.js +76 -0
- package/dist/surface-filter.js.map +1 -0
- package/dist/topo-store.d.ts +62 -0
- package/dist/topo-store.d.ts.map +1 -0
- package/dist/topo-store.js +319 -0
- package/dist/topo-store.js.map +1 -0
- package/dist/topo.d.ts +23 -9
- package/dist/topo.d.ts.map +1 -1
- package/dist/topo.js +175 -46
- package/dist/topo.js.map +1 -1
- package/dist/trail.d.ts +86 -19
- package/dist/trail.d.ts.map +1 -1
- package/dist/trail.js +59 -4
- package/dist/trail.js.map +1 -1
- package/dist/trails/derive-trail.d.ts +66 -0
- package/dist/trails/derive-trail.d.ts.map +1 -0
- package/dist/trails/derive-trail.js +378 -0
- package/dist/trails/derive-trail.js.map +1 -0
- package/dist/trails/index.d.ts +5 -0
- package/dist/trails/index.d.ts.map +1 -0
- package/dist/trails/index.js +3 -0
- package/dist/trails/index.js.map +1 -0
- package/dist/trails/ingest.d.ts +24 -0
- package/dist/trails/ingest.d.ts.map +1 -0
- package/dist/trails/ingest.js +63 -0
- package/dist/trails/ingest.js.map +1 -0
- package/dist/transport-error-map.d.ts +106 -0
- package/dist/transport-error-map.d.ts.map +1 -0
- package/dist/transport-error-map.js +24 -0
- package/dist/transport-error-map.js.map +1 -0
- package/dist/type-checks.test-d.d.ts +71 -0
- package/dist/type-checks.test-d.d.ts.map +1 -0
- package/dist/type-checks.test-d.js +12 -0
- package/dist/type-checks.test-d.js.map +1 -0
- package/dist/type-utils.d.ts +11 -2
- package/dist/type-utils.d.ts.map +1 -1
- package/dist/type-utils.js.map +1 -1
- package/dist/types.d.ts +113 -7
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js.map +1 -1
- package/dist/validate-established-topo.d.ts +76 -0
- package/dist/validate-established-topo.d.ts.map +1 -0
- package/dist/validate-established-topo.js +43 -0
- package/dist/validate-established-topo.js.map +1 -0
- package/dist/validate-topo.d.ts.map +1 -1
- package/dist/validate-topo.js +27 -8
- package/dist/validate-topo.js.map +1 -1
- package/dist/workspace.d.ts +1 -1
- package/dist/workspace.d.ts.map +1 -1
- package/dist/workspace.js +1 -1
- package/dist/workspace.js.map +1 -1
- package/package.json +10 -1
- package/src/__tests__/branded.test.ts +5 -5
- package/src/__tests__/context.test.ts +3 -3
- package/src/__tests__/contour.test.ts +263 -0
- package/src/__tests__/derive-trail.test.ts +668 -0
- package/src/__tests__/derive.test.ts +58 -1
- package/src/__tests__/errors.test.ts +118 -0
- package/src/__tests__/execute.test.ts +1179 -141
- package/src/__tests__/fire.test.ts +1056 -0
- package/src/__tests__/fork-ctx.test.ts +83 -0
- package/src/__tests__/ingest.test.ts +191 -0
- package/src/__tests__/{gate.test.ts → layer.test.ts} +21 -21
- package/src/__tests__/path-security.test.ts +7 -7
- package/src/__tests__/resilience.test.ts +8 -8
- package/src/__tests__/resource.test.ts +204 -0
- package/src/__tests__/run.test.ts +13 -13
- package/src/__tests__/service-config.test.ts +28 -32
- package/src/__tests__/surface-filter.test.ts +196 -0
- package/src/__tests__/topo-store-read.test.ts +256 -0
- package/src/__tests__/topo-store.test.ts +869 -0
- package/src/__tests__/topo.test.ts +350 -54
- package/src/__tests__/trail.test.ts +189 -24
- package/src/__tests__/trails-db.test.ts +198 -0
- package/src/__tests__/transport-error-map.test.ts +82 -0
- package/src/__tests__/type-utils.test.ts +29 -1
- package/src/__tests__/validate-topo.test.ts +305 -16
- package/src/__tests__/workspace.test.ts +6 -6
- package/src/__tests__/zod-wrappers.test.ts +62 -0
- package/src/branded.ts +1 -1
- package/src/context.ts +24 -4
- package/src/contour.ts +344 -0
- package/src/cross-schema.ts +36 -0
- package/src/derive.ts +39 -8
- package/src/draft.ts +338 -0
- package/src/errors.ts +62 -18
- package/src/execute.ts +840 -29
- package/src/fire.ts +295 -0
- package/src/index.ts +142 -26
- package/src/internal/cross-batch.ts +77 -0
- package/src/internal/fork-ctx.ts +69 -0
- package/src/internal/signal-ref.ts +87 -0
- package/src/internal/topo-snapshots.ts +517 -0
- package/src/internal/topo-store-read.ts +481 -0
- package/src/internal/topo-store.ts +1192 -0
- package/src/internal/tracing.ts +187 -0
- package/src/internal/trails-db.ts +187 -0
- package/src/internal/zod-wrappers.ts +78 -0
- package/src/layer.ts +50 -0
- package/src/path-security.ts +1 -1
- package/src/resilience.ts +3 -3
- package/src/{provision-config.ts → resource-config.ts} +109 -123
- package/src/resource.ts +155 -0
- package/src/run.ts +5 -4
- package/src/serialization.ts +2 -0
- package/src/store/accessor-protocol.ts +56 -0
- package/src/store/index.ts +4 -0
- package/src/surface-filter.ts +182 -0
- package/src/topo-store.ts +510 -0
- package/src/topo.ts +328 -57
- package/src/trail.ts +199 -31
- package/src/trails/derive-trail.ts +842 -0
- package/src/trails/index.ts +9 -0
- package/src/trails/ingest.ts +146 -0
- package/src/transport-error-map.ts +56 -0
- package/src/type-checks.test-d.ts +106 -0
- package/src/type-utils.ts +17 -2
- package/src/types.ts +148 -11
- package/src/validate-established-topo.ts +63 -0
- package/src/validate-topo.ts +37 -9
- package/src/workspace.ts +1 -1
- package/tsconfig.tests.json +10 -0
- package/tsconfig.tsbuildinfo +1 -1
- package/dist/adapters.d.ts +0 -39
- package/dist/adapters.d.ts.map +0 -1
- package/dist/adapters.js +0 -2
- package/dist/adapters.js.map +0 -1
- package/dist/dispatch.d.ts +0 -27
- package/dist/dispatch.d.ts.map +0 -1
- package/dist/dispatch.js +0 -34
- package/dist/dispatch.js.map +0 -1
- package/dist/event.d.ts +0 -8
- package/dist/event.d.ts.map +0 -1
- package/dist/event.js +0 -7
- package/dist/event.js.map +0 -1
- package/dist/gate.d.ts +0 -17
- package/dist/gate.d.ts.map +0 -1
- package/dist/gate.js +0 -21
- package/dist/gate.js.map +0 -1
- package/dist/health.d.ts +0 -18
- package/dist/health.d.ts.map +0 -1
- package/dist/health.js +0 -5
- package/dist/health.js.map +0 -1
- package/dist/job.d.ts +0 -24
- package/dist/job.d.ts.map +0 -1
- package/dist/job.js +0 -17
- package/dist/job.js.map +0 -1
- package/dist/provision-config.d.ts +0 -22
- package/dist/provision-config.d.ts.map +0 -1
- package/dist/provision-config.js +0 -210
- package/dist/provision-config.js.map +0 -1
- package/dist/provision.d.ts +0 -71
- package/dist/provision.d.ts.map +0 -1
- package/dist/provision.js +0 -56
- package/dist/provision.js.map +0 -1
- package/dist/service-config.d.ts +0 -22
- package/dist/service-config.d.ts.map +0 -1
- package/dist/service-config.js +0 -210
- package/dist/service-config.js.map +0 -1
- package/dist/service.d.ts +0 -71
- package/dist/service.d.ts.map +0 -1
- package/dist/service.js +0 -56
- package/dist/service.js.map +0 -1
- package/src/__tests__/service.test.ts +0 -197
- package/src/event.ts +0 -15
- package/src/gate.ts +0 -44
- package/src/provision.ts +0 -148
package/dist/provision-config.js
DELETED
|
@@ -1,210 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Provision resolution pipeline.
|
|
3
|
-
*
|
|
4
|
-
* Extracted from execute.ts to keep both modules under the 400 LOC ceiling.
|
|
5
|
-
* Handles config validation, singleton caching, concurrent-creation dedup,
|
|
6
|
-
* and the full resolve-or-create flow for declared provisions.
|
|
7
|
-
*/
|
|
8
|
-
import { InternalError, ValidationError } from './errors.js';
|
|
9
|
-
import { Result } from './result.js';
|
|
10
|
-
import { createProvisionLookup } from './provision.js';
|
|
11
|
-
// ---------------------------------------------------------------------------
|
|
12
|
-
// Singleton caches
|
|
13
|
-
// ---------------------------------------------------------------------------
|
|
14
|
-
const singletonProvisions = new WeakMap();
|
|
15
|
-
/** In-flight provision creation promises, keyed by provision x context. */
|
|
16
|
-
const pendingCreations = new WeakMap();
|
|
17
|
-
// ---------------------------------------------------------------------------
|
|
18
|
-
// Context helpers
|
|
19
|
-
// ---------------------------------------------------------------------------
|
|
20
|
-
const toProvisionContext = (ctx, config) => ({
|
|
21
|
-
config,
|
|
22
|
-
cwd: ctx.cwd,
|
|
23
|
-
env: ctx.env,
|
|
24
|
-
workspaceRoot: ctx.workspaceRoot,
|
|
25
|
-
});
|
|
26
|
-
const toProvisionContextKey = (ctx) => JSON.stringify({
|
|
27
|
-
config: ctx.config,
|
|
28
|
-
cwd: ctx.cwd,
|
|
29
|
-
env: Object.entries(ctx.env ?? {}).toSorted(([left], [right]) => left.localeCompare(right)),
|
|
30
|
-
workspaceRoot: ctx.workspaceRoot,
|
|
31
|
-
});
|
|
32
|
-
// ---------------------------------------------------------------------------
|
|
33
|
-
// Config validation
|
|
34
|
-
// ---------------------------------------------------------------------------
|
|
35
|
-
/** Validate and resolve a provision's config from the provided configValues map. */
|
|
36
|
-
const resolveProvisionConfig = (declaredProvision, configValues) => {
|
|
37
|
-
if (declaredProvision.config === undefined) {
|
|
38
|
-
return Result.ok();
|
|
39
|
-
}
|
|
40
|
-
const raw = configValues?.[declaredProvision.id];
|
|
41
|
-
if (raw === undefined) {
|
|
42
|
-
return Result.err(new ValidationError(`Provision "${declaredProvision.id}" declares a config schema but no config was provided`));
|
|
43
|
-
}
|
|
44
|
-
const parsed = declaredProvision.config.safeParse(raw);
|
|
45
|
-
if (!parsed.success) {
|
|
46
|
-
return Result.err(new ValidationError(`Provision "${declaredProvision.id}" config validation failed: ${parsed.error.message}`));
|
|
47
|
-
}
|
|
48
|
-
return Result.ok(parsed.data);
|
|
49
|
-
};
|
|
50
|
-
// ---------------------------------------------------------------------------
|
|
51
|
-
// Override / cache lookups
|
|
52
|
-
// ---------------------------------------------------------------------------
|
|
53
|
-
const hasOwnProvisionOverride = (overrides, id) => overrides !== undefined && Object.hasOwn(overrides, id);
|
|
54
|
-
const getCachedSingletonProvision = (declaredProvision, provisionContext) => {
|
|
55
|
-
const scopedCache = singletonProvisions.get(declaredProvision);
|
|
56
|
-
if (scopedCache === undefined) {
|
|
57
|
-
return { found: false, value: undefined };
|
|
58
|
-
}
|
|
59
|
-
const key = toProvisionContextKey(provisionContext);
|
|
60
|
-
if (!scopedCache.has(key)) {
|
|
61
|
-
return { found: false, value: undefined };
|
|
62
|
-
}
|
|
63
|
-
return {
|
|
64
|
-
found: true,
|
|
65
|
-
value: scopedCache.get(key),
|
|
66
|
-
};
|
|
67
|
-
};
|
|
68
|
-
const getProvidedProvision = (ctx, overrides, declaredProvision, provisionContext) => {
|
|
69
|
-
const { id } = declaredProvision;
|
|
70
|
-
if (hasOwnProvisionOverride(overrides, id)) {
|
|
71
|
-
return Result.ok(overrides[id]);
|
|
72
|
-
}
|
|
73
|
-
if (Object.hasOwn(ctx.extensions ?? {}, id)) {
|
|
74
|
-
return Result.ok(ctx.extensions?.[id]);
|
|
75
|
-
}
|
|
76
|
-
const cached = getCachedSingletonProvision(declaredProvision, provisionContext);
|
|
77
|
-
if (cached.found) {
|
|
78
|
-
return Result.ok(cached.value);
|
|
79
|
-
}
|
|
80
|
-
return undefined;
|
|
81
|
-
};
|
|
82
|
-
const getOverrideOrExtension = (ctx, overrides, declaredProvision) => getProvidedProvision(ctx, overrides, declaredProvision, toProvisionContext(ctx));
|
|
83
|
-
const resolveConfigAwareProvidedProvision = (ctx, declaredProvision, configValues) => {
|
|
84
|
-
const configResult = resolveProvisionConfig(declaredProvision, configValues);
|
|
85
|
-
if (configResult.isErr()) {
|
|
86
|
-
return configResult;
|
|
87
|
-
}
|
|
88
|
-
const provisionContext = toProvisionContext(ctx, configResult.value);
|
|
89
|
-
const provided = getProvidedProvision(ctx, undefined, declaredProvision, provisionContext);
|
|
90
|
-
return provided
|
|
91
|
-
? Result.ok({ kind: 'provided', value: provided.unwrap() })
|
|
92
|
-
: Result.ok({ kind: 'context', provisionContext });
|
|
93
|
-
};
|
|
94
|
-
// ---------------------------------------------------------------------------
|
|
95
|
-
// Instance creation
|
|
96
|
-
// ---------------------------------------------------------------------------
|
|
97
|
-
const toInternalProvisionError = (id, error) => {
|
|
98
|
-
const cause = error instanceof Error ? error : undefined;
|
|
99
|
-
const message = cause?.message ?? String(error);
|
|
100
|
-
return new InternalError(`Provision "${id}" failed to resolve: ${message}`, {
|
|
101
|
-
...(cause ? { cause } : {}),
|
|
102
|
-
context: { provisionId: id },
|
|
103
|
-
});
|
|
104
|
-
};
|
|
105
|
-
const getSingletonProvisionCache = (declaredProvision) => {
|
|
106
|
-
const existing = singletonProvisions.get(declaredProvision);
|
|
107
|
-
if (existing !== undefined) {
|
|
108
|
-
return existing;
|
|
109
|
-
}
|
|
110
|
-
const created = new Map();
|
|
111
|
-
singletonProvisions.set(declaredProvision, created);
|
|
112
|
-
return created;
|
|
113
|
-
};
|
|
114
|
-
const doCreateProvisionInstance = async (declaredProvision, provisionContext) => {
|
|
115
|
-
try {
|
|
116
|
-
const created = await declaredProvision.create(provisionContext);
|
|
117
|
-
if (created.isErr()) {
|
|
118
|
-
return Result.err(created.error);
|
|
119
|
-
}
|
|
120
|
-
const instance = created.unwrap();
|
|
121
|
-
getSingletonProvisionCache(declaredProvision).set(toProvisionContextKey(provisionContext), instance);
|
|
122
|
-
return Result.ok(instance);
|
|
123
|
-
}
|
|
124
|
-
catch (error) {
|
|
125
|
-
return Result.err(toInternalProvisionError(declaredProvision.id, error));
|
|
126
|
-
}
|
|
127
|
-
};
|
|
128
|
-
const trackPendingCreation = (declaredProvision, key, promise) => {
|
|
129
|
-
const pending = pendingCreations.get(declaredProvision);
|
|
130
|
-
if (pending) {
|
|
131
|
-
pending.set(key, promise);
|
|
132
|
-
}
|
|
133
|
-
else {
|
|
134
|
-
pendingCreations.set(declaredProvision, new Map([[key, promise]]));
|
|
135
|
-
}
|
|
136
|
-
};
|
|
137
|
-
/**
|
|
138
|
-
* Deduplicates concurrent creation of the same provision singleton.
|
|
139
|
-
* If a creation is already in flight for this provision x context key,
|
|
140
|
-
* returns the existing promise instead of spawning a second factory call.
|
|
141
|
-
*/
|
|
142
|
-
const createProvisionInstance = async (declaredProvision, provisionContext) => {
|
|
143
|
-
const key = toProvisionContextKey(provisionContext);
|
|
144
|
-
const inflight = pendingCreations.get(declaredProvision)?.get(key);
|
|
145
|
-
if (inflight) {
|
|
146
|
-
return inflight;
|
|
147
|
-
}
|
|
148
|
-
const promise = doCreateProvisionInstance(declaredProvision, provisionContext);
|
|
149
|
-
trackPendingCreation(declaredProvision, key, promise);
|
|
150
|
-
try {
|
|
151
|
-
return await promise;
|
|
152
|
-
}
|
|
153
|
-
finally {
|
|
154
|
-
pendingCreations.get(declaredProvision)?.delete(key);
|
|
155
|
-
}
|
|
156
|
-
};
|
|
157
|
-
/** Validate config and resolve a single declared provision. */
|
|
158
|
-
const resolveDeclaredProvision = async (declaredProvision, ctx, overrides, configValues) => {
|
|
159
|
-
// Check overrides/extensions first — skip config validation entirely when
|
|
160
|
-
// a provision instance is already provided.
|
|
161
|
-
const overrideOrExtension = getOverrideOrExtension(ctx, overrides, declaredProvision);
|
|
162
|
-
if (overrideOrExtension !== undefined) {
|
|
163
|
-
return overrideOrExtension;
|
|
164
|
-
}
|
|
165
|
-
// Resolve config before consulting the singleton cache so config-aware
|
|
166
|
-
// provisions use the same canonical context for cache reads and writes.
|
|
167
|
-
const configAwareProvision = resolveConfigAwareProvidedProvision(ctx, declaredProvision, configValues);
|
|
168
|
-
if (configAwareProvision.isErr()) {
|
|
169
|
-
return configAwareProvision;
|
|
170
|
-
}
|
|
171
|
-
// No provided instance — create via factory.
|
|
172
|
-
const resolved = configAwareProvision.unwrap();
|
|
173
|
-
if (resolved.kind === 'provided') {
|
|
174
|
-
return Result.ok(resolved.value);
|
|
175
|
-
}
|
|
176
|
-
return await createProvisionInstance(declaredProvision, resolved.provisionContext);
|
|
177
|
-
};
|
|
178
|
-
// ---------------------------------------------------------------------------
|
|
179
|
-
// Full trail provision resolution
|
|
180
|
-
// ---------------------------------------------------------------------------
|
|
181
|
-
const withResolvedProvisions = (ctx, resolvedProvisions) => {
|
|
182
|
-
const extensions = { ...ctx.extensions, ...resolvedProvisions };
|
|
183
|
-
const resolvedCtx = { ...ctx, extensions };
|
|
184
|
-
const lookup = createProvisionLookup(() => resolvedCtx);
|
|
185
|
-
resolvedCtx.provision = lookup;
|
|
186
|
-
return resolvedCtx;
|
|
187
|
-
};
|
|
188
|
-
/**
|
|
189
|
-
* Resolve all declared provisions for a trail.
|
|
190
|
-
*
|
|
191
|
-
* Validates per-provision config, checks overrides and caches, and creates
|
|
192
|
-
* new instances as needed. Returns an enriched context with all provision
|
|
193
|
-
* instances injected into extensions.
|
|
194
|
-
*/
|
|
195
|
-
export const resolveProvisions = async (trail, ctx, overrides, configValues) => {
|
|
196
|
-
const { provisions } = trail;
|
|
197
|
-
if (provisions.length === 0) {
|
|
198
|
-
return Result.ok(ctx);
|
|
199
|
-
}
|
|
200
|
-
const resolvedProvisions = {};
|
|
201
|
-
for (const declaredProvision of provisions) {
|
|
202
|
-
const resolved = await resolveDeclaredProvision(declaredProvision, ctx, overrides, configValues);
|
|
203
|
-
if (resolved.isErr()) {
|
|
204
|
-
return resolved;
|
|
205
|
-
}
|
|
206
|
-
resolvedProvisions[declaredProvision.id] = resolved.unwrap();
|
|
207
|
-
}
|
|
208
|
-
return Result.ok(withResolvedProvisions(ctx, resolvedProvisions));
|
|
209
|
-
};
|
|
210
|
-
//# sourceMappingURL=provision-config.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"provision-config.js","sourceRoot":"","sources":["../src/provision-config.ts"],"names":[],"mappings":"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"}
|
package/dist/provision.d.ts
DELETED
|
@@ -1,71 +0,0 @@
|
|
|
1
|
-
import type { Result } from './result.js';
|
|
2
|
-
import type { ProvisionLookup, TrailContext } from './types.js';
|
|
3
|
-
import type { z } from 'zod';
|
|
4
|
-
/**
|
|
5
|
-
* Stable process-scoped fields available when constructing a provision.
|
|
6
|
-
*
|
|
7
|
-
* Provisions are app-level singletons, so they intentionally do not receive
|
|
8
|
-
* the full per-request TrailContext. When a provision declares a `config` schema,
|
|
9
|
-
* the validated config is passed as `svc.config`.
|
|
10
|
-
*/
|
|
11
|
-
export type ProvisionContext<C = unknown> = Pick<TrailContext, 'cwd' | 'env' | 'workspaceRoot'> & {
|
|
12
|
-
readonly config: C;
|
|
13
|
-
};
|
|
14
|
-
/**
|
|
15
|
-
* Everything needed to describe a provision before a factory is introduced.
|
|
16
|
-
*
|
|
17
|
-
* When `config` is a Zod schema, the `create` callback receives
|
|
18
|
-
* `ProvisionContext<C>` with the validated config value.
|
|
19
|
-
*/
|
|
20
|
-
export interface ProvisionSpec<T, C = unknown> {
|
|
21
|
-
/** Create the provision instance from stable process-scoped context. */
|
|
22
|
-
readonly create: (svc: ProvisionContext<C>) => Result<T, Error> | Promise<Result<T, Error>>;
|
|
23
|
-
/** Config schema — when present, config is validated and passed to `create`. */
|
|
24
|
-
readonly config?: z.ZodType<C> | undefined;
|
|
25
|
-
/** Optional cleanup performed when the hosting trailhead shuts down. */
|
|
26
|
-
readonly dispose?: ((provision: T) => void | Promise<void>) | undefined;
|
|
27
|
-
/** Optional operational readiness probe for introspection tooling. */
|
|
28
|
-
readonly health?: ((provision: T) => Result<unknown, Error> | Promise<Result<unknown, Error>>) | undefined;
|
|
29
|
-
/** Optional test factory used by higher-level helpers. */
|
|
30
|
-
readonly mock?: (() => T | Promise<T>) | undefined;
|
|
31
|
-
/** Human-readable description. */
|
|
32
|
-
readonly description?: string | undefined;
|
|
33
|
-
/** Arbitrary meta for tooling and filtering. */
|
|
34
|
-
readonly meta?: Readonly<Record<string, unknown>> | undefined;
|
|
35
|
-
}
|
|
36
|
-
/** A typed provision definition. */
|
|
37
|
-
export interface Provision<T> extends ProvisionSpec<T> {
|
|
38
|
-
readonly kind: 'provision';
|
|
39
|
-
readonly id: string;
|
|
40
|
-
/** Read the resolved provision instance from a trail context. */
|
|
41
|
-
from(ctx: TrailContext): T;
|
|
42
|
-
}
|
|
43
|
-
/**
|
|
44
|
-
* Existential type for heterogeneous provision collections.
|
|
45
|
-
*
|
|
46
|
-
* `Provision<T>` includes function parameters in `dispose`/`health`, so
|
|
47
|
-
* `unknown` is too narrow for mixed provision arrays. `any` is the correct
|
|
48
|
-
* existential here.
|
|
49
|
-
*/
|
|
50
|
-
export type AnyProvision = Provision<any>;
|
|
51
|
-
/** Explicit runtime overrides keyed by provision ID. */
|
|
52
|
-
export type ProvisionOverrideMap = Readonly<Record<string, unknown>>;
|
|
53
|
-
/** Create a `ctx.provision(...)` accessor bound to a concrete context snapshot. */
|
|
54
|
-
export declare const createProvisionLookup: (getContext: () => Pick<TrailContext, "extensions">) => ProvisionLookup;
|
|
55
|
-
/**
|
|
56
|
-
* Create a typed provision definition.
|
|
57
|
-
*
|
|
58
|
-
* The provision object is inert until a later execution branch resolves concrete
|
|
59
|
-
* instances into TrailContext extensions.
|
|
60
|
-
*/
|
|
61
|
-
export declare const provision: <T>(id: string, spec: ProvisionSpec<T>) => Provision<T>;
|
|
62
|
-
/** Narrow unknown values to provision definitions during topo discovery. */
|
|
63
|
-
export declare const isProvision: (value: unknown) => value is AnyProvision;
|
|
64
|
-
/**
|
|
65
|
-
* Return the first duplicate provision ID in a collection, if any.
|
|
66
|
-
*
|
|
67
|
-
* This supports later topo registration without each caller duplicating the
|
|
68
|
-
* same scan logic.
|
|
69
|
-
*/
|
|
70
|
-
export declare const findDuplicateProvisionId: (provisions: readonly Pick<AnyProvision, "id">[]) => string | undefined;
|
|
71
|
-
//# sourceMappingURL=provision.d.ts.map
|
package/dist/provision.d.ts.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAC9C,YAAY,EACZ,KAAK,GAAG,KAAK,GAAG,eAAe,CAChC,GAAG;IACF,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO;IAC3C,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,CACf,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,KACrB,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3C,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IACxE,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EACZ,CAAC,CACC,SAAS,EAAE,CAAC,KACT,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,GAC9D,SAAS,CAAC;IACd,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACnD,kCAAkC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,gDAAgD;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAC/D;AAED,oCAAoC;AACpC,MAAM,WAAW,SAAS,CAAC,CAAC,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,CAAC,CAAC;CAC5B;AAED;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;AAE1C,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAqBrE,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,GAChC,YAAY,MAAM,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,KACjD,eAQoB,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EACzB,IAAI,MAAM,EACV,MAAM,aAAa,CAAC,CAAC,CAAC,KACrB,SAAS,CAAC,CAAC,CASV,CAAC;AAEL,4EAA4E;AAC5E,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,YAMrD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,YAAY,SAAS,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,KAC9C,MAAM,GAAG,SASX,CAAC"}
|
package/dist/provision.js
DELETED
|
@@ -1,56 +0,0 @@
|
|
|
1
|
-
import { NotFoundError } from './errors.js';
|
|
2
|
-
const getProvisionId = (provisionOrId) => typeof provisionOrId === 'string' ? provisionOrId : provisionOrId.id;
|
|
3
|
-
const getProvisionInstance = (ctx, provisionOrId) => {
|
|
4
|
-
const id = getProvisionId(provisionOrId);
|
|
5
|
-
return ctx.extensions?.[id];
|
|
6
|
-
};
|
|
7
|
-
const hasProvisionInstance = (ctx, provisionOrId) => Object.hasOwn(ctx.extensions ?? {}, getProvisionId(provisionOrId));
|
|
8
|
-
/** Create a `ctx.provision(...)` accessor bound to a concrete context snapshot. */
|
|
9
|
-
export const createProvisionLookup = (getContext) => ((provisionOrId) => {
|
|
10
|
-
const id = getProvisionId(provisionOrId);
|
|
11
|
-
const ctx = getContext();
|
|
12
|
-
if (!hasProvisionInstance(ctx, id)) {
|
|
13
|
-
throw new NotFoundError(`Provision "${id}" not found in trail context`);
|
|
14
|
-
}
|
|
15
|
-
return getProvisionInstance(ctx, id);
|
|
16
|
-
});
|
|
17
|
-
/**
|
|
18
|
-
* Create a typed provision definition.
|
|
19
|
-
*
|
|
20
|
-
* The provision object is inert until a later execution branch resolves concrete
|
|
21
|
-
* instances into TrailContext extensions.
|
|
22
|
-
*/
|
|
23
|
-
export const provision = (id, spec) => Object.freeze({
|
|
24
|
-
...spec,
|
|
25
|
-
from(ctx) {
|
|
26
|
-
const lookup = ctx.provision ?? createProvisionLookup(() => ctx);
|
|
27
|
-
return lookup(this);
|
|
28
|
-
},
|
|
29
|
-
id,
|
|
30
|
-
kind: 'provision',
|
|
31
|
-
});
|
|
32
|
-
/** Narrow unknown values to provision definitions during topo discovery. */
|
|
33
|
-
export const isProvision = (value) => {
|
|
34
|
-
if (typeof value !== 'object' || value === null) {
|
|
35
|
-
return false;
|
|
36
|
-
}
|
|
37
|
-
const v = value;
|
|
38
|
-
return v.kind === 'provision' && typeof v.id === 'string';
|
|
39
|
-
};
|
|
40
|
-
/**
|
|
41
|
-
* Return the first duplicate provision ID in a collection, if any.
|
|
42
|
-
*
|
|
43
|
-
* This supports later topo registration without each caller duplicating the
|
|
44
|
-
* same scan logic.
|
|
45
|
-
*/
|
|
46
|
-
export const findDuplicateProvisionId = (provisions) => {
|
|
47
|
-
const seen = new Set();
|
|
48
|
-
for (const candidate of provisions) {
|
|
49
|
-
if (seen.has(candidate.id)) {
|
|
50
|
-
return candidate.id;
|
|
51
|
-
}
|
|
52
|
-
seen.add(candidate.id);
|
|
53
|
-
}
|
|
54
|
-
return undefined;
|
|
55
|
-
};
|
|
56
|
-
//# sourceMappingURL=provision.js.map
|
package/dist/provision.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"provision.js","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAqE5C,MAAM,cAAc,GAAG,CACrB,aAAgD,EACxC,EAAE,CACV,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC;AAEvE,MAAM,oBAAoB,GAAG,CAC3B,GAAqC,EACrC,aAAgD,EAC7C,EAAE;IACL,MAAM,EAAE,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;IACzC,OAAO,GAAG,CAAC,UAAU,EAAE,CAAC,EAAE,CAAM,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAC3B,GAAqC,EACrC,aAAgD,EACvC,EAAE,CACX,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;AAErE,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,UAAkD,EACjC,EAAE,CACnB,CAAC,CAAC,aAAgD,EAAE,EAAE;IACpD,MAAM,EAAE,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,aAAa,CAAC,cAAc,EAAE,8BAA8B,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC,CAAoB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,EAAU,EACV,IAAsB,EACR,EAAE,CAChB,MAAM,CAAC,MAAM,CAAC;IACZ,GAAG,IAAI;IACP,IAAI,CAAC,GAAiB;QACpB,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,IAAI,qBAAqB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,EAAE;IACF,IAAI,EAAE,WAAoB;CAC3B,CAAC,CAAC;AAEL,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAyB,EAAE;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,GAAG,KAAyC,CAAC;IACpD,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC;AAC5D,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,UAA+C,EAC3B,EAAE;IACtB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC,EAAE,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}
|
package/dist/service-config.d.ts
DELETED
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Provision resolution pipeline.
|
|
3
|
-
*
|
|
4
|
-
* Extracted from execute.ts to keep both modules under the 400 LOC ceiling.
|
|
5
|
-
* Handles config validation, singleton caching, concurrent-creation dedup,
|
|
6
|
-
* and the full resolve-or-create flow for declared provisions.
|
|
7
|
-
*/
|
|
8
|
-
import type { ProvisionOverrideMap } from './service.js';
|
|
9
|
-
import type { AnyTrail } from './trail.js';
|
|
10
|
-
import type { TrailContext } from './types.js';
|
|
11
|
-
import { Result } from './result.js';
|
|
12
|
-
type ConfigValues = Readonly<Record<string, Record<string, unknown>>>;
|
|
13
|
-
/**
|
|
14
|
-
* Resolve all declared provisions for a trail.
|
|
15
|
-
*
|
|
16
|
-
* Validates per-provision config, checks overrides and caches, and creates
|
|
17
|
-
* new instances as needed. Returns an enriched context with all provision
|
|
18
|
-
* instances injected into extensions.
|
|
19
|
-
*/
|
|
20
|
-
export declare const resolveProvisions: (trail: AnyTrail, ctx: TrailContext, overrides?: ProvisionOverrideMap, configValues?: ConfigValues) => Promise<Result<TrailContext, Error>>;
|
|
21
|
-
export {};
|
|
22
|
-
//# sourceMappingURL=service-config.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"service-config.d.ts","sourceRoot":"","sources":["../src/service-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAGV,oBAAoB,EACrB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC,KAAK,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AA0TtE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,QAAQ,EACf,KAAK,YAAY,EACjB,YAAY,oBAAoB,EAChC,eAAe,YAAY,KAC1B,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAsBrC,CAAC"}
|
package/dist/service-config.js
DELETED
|
@@ -1,210 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Provision resolution pipeline.
|
|
3
|
-
*
|
|
4
|
-
* Extracted from execute.ts to keep both modules under the 400 LOC ceiling.
|
|
5
|
-
* Handles config validation, singleton caching, concurrent-creation dedup,
|
|
6
|
-
* and the full resolve-or-create flow for declared provisions.
|
|
7
|
-
*/
|
|
8
|
-
import { InternalError, ValidationError } from './errors.js';
|
|
9
|
-
import { Result } from './result.js';
|
|
10
|
-
import { createProvisionLookup } from './service.js';
|
|
11
|
-
// ---------------------------------------------------------------------------
|
|
12
|
-
// Singleton caches
|
|
13
|
-
// ---------------------------------------------------------------------------
|
|
14
|
-
const singletonProvisions = new WeakMap();
|
|
15
|
-
/** In-flight provision creation promises, keyed by provision x context. */
|
|
16
|
-
const pendingCreations = new WeakMap();
|
|
17
|
-
// ---------------------------------------------------------------------------
|
|
18
|
-
// Context helpers
|
|
19
|
-
// ---------------------------------------------------------------------------
|
|
20
|
-
const toProvisionContext = (ctx, config) => ({
|
|
21
|
-
config,
|
|
22
|
-
cwd: ctx.cwd,
|
|
23
|
-
env: ctx.env,
|
|
24
|
-
workspaceRoot: ctx.workspaceRoot,
|
|
25
|
-
});
|
|
26
|
-
const toProvisionContextKey = (ctx) => JSON.stringify({
|
|
27
|
-
config: ctx.config,
|
|
28
|
-
cwd: ctx.cwd,
|
|
29
|
-
env: Object.entries(ctx.env ?? {}).toSorted(([left], [right]) => left.localeCompare(right)),
|
|
30
|
-
workspaceRoot: ctx.workspaceRoot,
|
|
31
|
-
});
|
|
32
|
-
// ---------------------------------------------------------------------------
|
|
33
|
-
// Config validation
|
|
34
|
-
// ---------------------------------------------------------------------------
|
|
35
|
-
/** Validate and resolve a provision's config from the provided configValues map. */
|
|
36
|
-
const resolveProvisionConfig = (declaredProvision, configValues) => {
|
|
37
|
-
if (declaredProvision.config === undefined) {
|
|
38
|
-
return Result.ok();
|
|
39
|
-
}
|
|
40
|
-
const raw = configValues?.[declaredProvision.id];
|
|
41
|
-
if (raw === undefined) {
|
|
42
|
-
return Result.err(new ValidationError(`Provision "${declaredProvision.id}" declares a config schema but no config was provided`));
|
|
43
|
-
}
|
|
44
|
-
const parsed = declaredProvision.config.safeParse(raw);
|
|
45
|
-
if (!parsed.success) {
|
|
46
|
-
return Result.err(new ValidationError(`Provision "${declaredProvision.id}" config validation failed: ${parsed.error.message}`));
|
|
47
|
-
}
|
|
48
|
-
return Result.ok(parsed.data);
|
|
49
|
-
};
|
|
50
|
-
// ---------------------------------------------------------------------------
|
|
51
|
-
// Override / cache lookups
|
|
52
|
-
// ---------------------------------------------------------------------------
|
|
53
|
-
const hasOwnProvisionOverride = (overrides, id) => overrides !== undefined && Object.hasOwn(overrides, id);
|
|
54
|
-
const getCachedSingletonProvision = (declaredProvision, provisionContext) => {
|
|
55
|
-
const scopedCache = singletonProvisions.get(declaredProvision);
|
|
56
|
-
if (scopedCache === undefined) {
|
|
57
|
-
return { found: false, value: undefined };
|
|
58
|
-
}
|
|
59
|
-
const key = toProvisionContextKey(provisionContext);
|
|
60
|
-
if (!scopedCache.has(key)) {
|
|
61
|
-
return { found: false, value: undefined };
|
|
62
|
-
}
|
|
63
|
-
return {
|
|
64
|
-
found: true,
|
|
65
|
-
value: scopedCache.get(key),
|
|
66
|
-
};
|
|
67
|
-
};
|
|
68
|
-
const getProvidedProvision = (ctx, overrides, declaredProvision, provisionContext) => {
|
|
69
|
-
const { id } = declaredProvision;
|
|
70
|
-
if (hasOwnProvisionOverride(overrides, id)) {
|
|
71
|
-
return Result.ok(overrides[id]);
|
|
72
|
-
}
|
|
73
|
-
if (Object.hasOwn(ctx.extensions ?? {}, id)) {
|
|
74
|
-
return Result.ok(ctx.extensions?.[id]);
|
|
75
|
-
}
|
|
76
|
-
const cached = getCachedSingletonProvision(declaredProvision, provisionContext);
|
|
77
|
-
if (cached.found) {
|
|
78
|
-
return Result.ok(cached.value);
|
|
79
|
-
}
|
|
80
|
-
return undefined;
|
|
81
|
-
};
|
|
82
|
-
const getOverrideOrExtension = (ctx, overrides, declaredProvision) => getProvidedProvision(ctx, overrides, declaredProvision, toProvisionContext(ctx));
|
|
83
|
-
const resolveConfigAwareProvidedProvision = (ctx, declaredProvision, configValues) => {
|
|
84
|
-
const configResult = resolveProvisionConfig(declaredProvision, configValues);
|
|
85
|
-
if (configResult.isErr()) {
|
|
86
|
-
return configResult;
|
|
87
|
-
}
|
|
88
|
-
const provisionContext = toProvisionContext(ctx, configResult.value);
|
|
89
|
-
const provided = getProvidedProvision(ctx, undefined, declaredProvision, provisionContext);
|
|
90
|
-
return provided
|
|
91
|
-
? Result.ok({ kind: 'provided', value: provided.unwrap() })
|
|
92
|
-
: Result.ok({ kind: 'context', provisionContext });
|
|
93
|
-
};
|
|
94
|
-
// ---------------------------------------------------------------------------
|
|
95
|
-
// Instance creation
|
|
96
|
-
// ---------------------------------------------------------------------------
|
|
97
|
-
const toInternalProvisionError = (id, error) => {
|
|
98
|
-
const cause = error instanceof Error ? error : undefined;
|
|
99
|
-
const message = cause?.message ?? String(error);
|
|
100
|
-
return new InternalError(`Provision "${id}" failed to resolve: ${message}`, {
|
|
101
|
-
...(cause ? { cause } : {}),
|
|
102
|
-
context: { provisionId: id },
|
|
103
|
-
});
|
|
104
|
-
};
|
|
105
|
-
const getSingletonProvisionCache = (declaredProvision) => {
|
|
106
|
-
const existing = singletonProvisions.get(declaredProvision);
|
|
107
|
-
if (existing !== undefined) {
|
|
108
|
-
return existing;
|
|
109
|
-
}
|
|
110
|
-
const created = new Map();
|
|
111
|
-
singletonProvisions.set(declaredProvision, created);
|
|
112
|
-
return created;
|
|
113
|
-
};
|
|
114
|
-
const doCreateProvisionInstance = async (declaredProvision, provisionContext) => {
|
|
115
|
-
try {
|
|
116
|
-
const created = await declaredProvision.create(provisionContext);
|
|
117
|
-
if (created.isErr()) {
|
|
118
|
-
return Result.err(created.error);
|
|
119
|
-
}
|
|
120
|
-
const instance = created.unwrap();
|
|
121
|
-
getSingletonProvisionCache(declaredProvision).set(toProvisionContextKey(provisionContext), instance);
|
|
122
|
-
return Result.ok(instance);
|
|
123
|
-
}
|
|
124
|
-
catch (error) {
|
|
125
|
-
return Result.err(toInternalProvisionError(declaredProvision.id, error));
|
|
126
|
-
}
|
|
127
|
-
};
|
|
128
|
-
const trackPendingCreation = (declaredProvision, key, promise) => {
|
|
129
|
-
const pending = pendingCreations.get(declaredProvision);
|
|
130
|
-
if (pending) {
|
|
131
|
-
pending.set(key, promise);
|
|
132
|
-
}
|
|
133
|
-
else {
|
|
134
|
-
pendingCreations.set(declaredProvision, new Map([[key, promise]]));
|
|
135
|
-
}
|
|
136
|
-
};
|
|
137
|
-
/**
|
|
138
|
-
* Deduplicates concurrent creation of the same provision singleton.
|
|
139
|
-
* If a creation is already in flight for this provision x context key,
|
|
140
|
-
* returns the existing promise instead of spawning a second factory call.
|
|
141
|
-
*/
|
|
142
|
-
const createProvisionInstance = async (declaredProvision, provisionContext) => {
|
|
143
|
-
const key = toProvisionContextKey(provisionContext);
|
|
144
|
-
const inflight = pendingCreations.get(declaredProvision)?.get(key);
|
|
145
|
-
if (inflight) {
|
|
146
|
-
return inflight;
|
|
147
|
-
}
|
|
148
|
-
const promise = doCreateProvisionInstance(declaredProvision, provisionContext);
|
|
149
|
-
trackPendingCreation(declaredProvision, key, promise);
|
|
150
|
-
try {
|
|
151
|
-
return await promise;
|
|
152
|
-
}
|
|
153
|
-
finally {
|
|
154
|
-
pendingCreations.get(declaredProvision)?.delete(key);
|
|
155
|
-
}
|
|
156
|
-
};
|
|
157
|
-
/** Validate config and resolve a single declared provision. */
|
|
158
|
-
const resolveDeclaredProvision = async (declaredProvision, ctx, overrides, configValues) => {
|
|
159
|
-
// Check overrides/extensions first — skip config validation entirely when
|
|
160
|
-
// a provision instance is already provided.
|
|
161
|
-
const overrideOrExtension = getOverrideOrExtension(ctx, overrides, declaredProvision);
|
|
162
|
-
if (overrideOrExtension !== undefined) {
|
|
163
|
-
return overrideOrExtension;
|
|
164
|
-
}
|
|
165
|
-
// Resolve config before consulting the singleton cache so config-aware
|
|
166
|
-
// provisions use the same canonical context for cache reads and writes.
|
|
167
|
-
const configAwareProvision = resolveConfigAwareProvidedProvision(ctx, declaredProvision, configValues);
|
|
168
|
-
if (configAwareProvision.isErr()) {
|
|
169
|
-
return configAwareProvision;
|
|
170
|
-
}
|
|
171
|
-
// No provided instance — create via factory.
|
|
172
|
-
const resolved = configAwareProvision.unwrap();
|
|
173
|
-
if (resolved.kind === 'provided') {
|
|
174
|
-
return Result.ok(resolved.value);
|
|
175
|
-
}
|
|
176
|
-
return await createProvisionInstance(declaredProvision, resolved.provisionContext);
|
|
177
|
-
};
|
|
178
|
-
// ---------------------------------------------------------------------------
|
|
179
|
-
// Full trail provision resolution
|
|
180
|
-
// ---------------------------------------------------------------------------
|
|
181
|
-
const withResolvedProvisions = (ctx, resolvedProvisions) => {
|
|
182
|
-
const extensions = { ...ctx.extensions, ...resolvedProvisions };
|
|
183
|
-
const resolvedCtx = { ...ctx, extensions };
|
|
184
|
-
const lookup = createProvisionLookup(() => resolvedCtx);
|
|
185
|
-
resolvedCtx.provision = lookup;
|
|
186
|
-
return resolvedCtx;
|
|
187
|
-
};
|
|
188
|
-
/**
|
|
189
|
-
* Resolve all declared provisions for a trail.
|
|
190
|
-
*
|
|
191
|
-
* Validates per-provision config, checks overrides and caches, and creates
|
|
192
|
-
* new instances as needed. Returns an enriched context with all provision
|
|
193
|
-
* instances injected into extensions.
|
|
194
|
-
*/
|
|
195
|
-
export const resolveProvisions = async (trail, ctx, overrides, configValues) => {
|
|
196
|
-
const provisions = trail.provisions;
|
|
197
|
-
if (provisions.length === 0) {
|
|
198
|
-
return Result.ok(ctx);
|
|
199
|
-
}
|
|
200
|
-
const resolvedProvisions = {};
|
|
201
|
-
for (const declaredProvision of provisions) {
|
|
202
|
-
const resolved = await resolveDeclaredProvision(declaredProvision, ctx, overrides, configValues);
|
|
203
|
-
if (resolved.isErr()) {
|
|
204
|
-
return resolved;
|
|
205
|
-
}
|
|
206
|
-
resolvedProvisions[declaredProvision.id] = resolved.unwrap();
|
|
207
|
-
}
|
|
208
|
-
return Result.ok(withResolvedProvisions(ctx, resolvedProvisions));
|
|
209
|
-
};
|
|
210
|
-
//# sourceMappingURL=service-config.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"service-config.js","sourceRoot":"","sources":["../src/service-config.ts"],"names":[],"mappings":"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"}
|