@overkill-dev/resources 0.0.1 → 0.0.2

package/resources/resource-session.js

@@ -0,0 +1,182 @@
+import { callableResourceDefinition, createResourceGraph, resourceEntries } from "./resource-graph.js";
+import { lifecycleFailures, resourceLifecycleError } from "./resource-lifecycle-error.js";
+const directResourceAcquisitionContext = {
+    acquisitionFailureMessage: 'Resource acquisition failed.',
+    fallbackResourceName: 'resource'
+};
+function acquiredDependencyHandles(dependencies, handles) {
+    const context = {};
+    for (const [key, resource] of resourceEntries(dependencies)) {
+        context[key] = handles.get(resource);
+    }
+    return Object.freeze(context);
+}
+function acquireResourceHandle(resource, context) {
+    return callableResourceDefinition(resource).acquire(context);
+}
+function disposeResourceHandle(dispose, handle, context) {
+    return dispose(handle, context);
+}
+async function disposeResource(node, handles, signal) {
+    const handle = handles.get(node.descriptor);
+    const { dispose } = callableResourceDefinition(node.descriptor);
+    if (handle === undefined || dispose === null) {
+        return null;
+    }
+    try {
+        await disposeResourceHandle(dispose, handle, {
+            dependencies: acquiredDependencyHandles(node.descriptor.dependencies, handles),
+            signal
+        });
+        return null;
+    }
+    catch (error) {
+        return { cause: error, phase: 'dispose', resourceName: node.descriptor.name };
+    }
+}
+export async function disposeResources(order, handles, signal) {
+    const failures = [];
+    for (const node of order.toReversed()) {
+        const failure = await disposeResource(node, handles, signal);
+        if (failure !== null) {
+            failures.push(failure);
+        }
+    }
+    return failures;
+}
+async function disposeResourceSession(order, handles, signal) {
+    const failures = await disposeResources(order, handles, signal);
+    if (failures.length > 0) {
+        throw resourceLifecycleError('Resource disposal failed.', failures, failures[0]?.cause);
+    }
+}
+function createResourceAcquisition(signal, acquisitionContext) {
+    const abortController = new AbortController();
+    const acquisitionSignal = AbortSignal.any([signal, abortController.signal]);
+    const acquisitions = new Map();
+    const handles = new Map();
+    const acquisition = {
+        async acquire(graph) {
+            const results = await Promise.allSettled(graph.topLevelEntries.map(async function acquireTopLevel([, resource]) {
+                return await acquisition.resource(resource);
+            }));
+            const failures = lifecycleFailures(results, acquisitionContext.fallbackResourceName);
+            if (failures.length > 0) {
+                return await acquisition.failStartup(graph, failures);
+            }
+            return { handles };
+        },
+        async dependencies(dependencies) {
+            const context = {};
+            await Promise.all(resourceEntries(dependencies).map(async function acquireDependency([key, dependency]) {
+                context[key] = await acquisition.resource(dependency);
+            }));
+            return Object.freeze(context);
+        },
+        async failStartup(graph, failures) {
+            abortController.abort(failures[0]?.cause);
+            const disposalFailures = await disposeResources(graph.order, handles, signal);
+            throw resourceLifecycleError(acquisitionContext.acquisitionFailureMessage, [
+                ...failures,
+                ...disposalFailures
+            ], failures[0]?.cause);
+        },
+        async resource(resource) {
+            const existingAcquisition = acquisitions.get(resource);
+            if (existingAcquisition !== undefined) {
+                return await existingAcquisition;
+            }
+            const resourceAcquisition = acquisition.start(resource);
+            acquisitions.set(resource, resourceAcquisition);
+            return await resourceAcquisition;
+        },
+        async start(resource) {
+            const dependencies = await acquisition.dependencies(resource.dependencies);
+            try {
+                const handle = await acquireResourceHandle(resource, {
+                    dependencies,
+                    signal: acquisitionSignal
+                });
+                handles.set(resource, handle);
+                return handle;
+            }
+            catch (error) {
+                abortController.abort(error);
+                throw resourceLifecycleError(`Resource "${resource.name}" acquisition failed.`, [
+                    { cause: error, phase: 'acquire', resourceName: resource.name }
+                ], error);
+            }
+        }
+    };
+    return acquisition;
+}
+function isResourceContext(context, resources) {
+    for (const key of Object.keys(resources)) {
+        if (!Object.hasOwn(context, key)) {
+            return false;
+        }
+    }
+    return true;
+}
+function resourceContext(resources, handles) {
+    const context = {};
+    for (const [key, resource] of resourceEntries(resources)) {
+        context[key] = handles.get(resource);
+    }
+    const frozenContext = Object.freeze(context);
+    if (isResourceContext(frozenContext, resources)) {
+        return frozenContext;
+    }
+    throw resourceLifecycleError('Resource context is incomplete.', [
+        { cause: resources, phase: 'graph', resourceName: 'resource' }
+    ], resources);
+}
+function internalDisposalSignal() {
+    const controller = new AbortController();
+    return controller.signal;
+}
+export function runtimeAsyncDisposeSymbol() {
+    const value = Reflect.get(Symbol, 'asyncDispose');
+    if (typeof value !== 'symbol') {
+        throw new TypeError('Runtime does not provide Symbol.asyncDispose.');
+    }
+    return value;
+}
+function isResourceSession(session) {
+    return Reflect.has(session, runtimeAsyncDisposeSymbol());
+}
+export async function acquireResourceGraph(request, context) {
+    const graph = createResourceGraph(request.resources);
+    const acquisition = await createResourceAcquisition(request.signal, context).acquire(graph);
+    return {
+        context: resourceContext(request.resources, acquisition.handles),
+        handles: acquisition.handles,
+        order: graph.order
+    };
+}
+export async function startResources(request) {
+    const acquisition = await acquireResourceGraph(request, directResourceAcquisitionContext);
+    let disposal = null;
+    const session = {
+        context: acquisition.context,
+        async disposeOnce(disposalContext) {
+            if (disposal === null) {
+                disposal = disposeResourceSession(acquisition.order, acquisition.handles, disposalContext.signal);
+            }
+            await disposal;
+        }
+    };
+    Object.defineProperty(session, runtimeAsyncDisposeSymbol(), {
+        value: async function disposeResourcesWithInternalSignal() {
+            await session.disposeOnce({ signal: internalDisposalSignal() });
+        }
+    });
+    const frozenSession = Object.freeze(session);
+    if (isResourceSession(frozenSession)) {
+        return frozenSession;
+    }
+    throw resourceLifecycleError('Resource session is incomplete.', [
+        { cause: session, phase: 'graph', resourceName: 'resource' }
+    ], session);
+}
+//# sourceMappingURL=resource-session.js.map

package/resources/resource-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-session.js","sourceRoot":"","sources":["../../../../source/resources/resource-session.ts"],"names":[],"mappings":"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"}

package/resources/resources.d.ts

@@ -0,0 +1,149 @@
+import { defineRuntime as createRuntimeDefinition, isDefinedRuntime as isRuntimeDefinition, type RuntimeDefinition as RuntimeDefinitionDescriptor, type RuntimeDefinitionInput as RuntimeDefinitionDescriptorInput, type RuntimeDimensions as RuntimeDimensionMap, type RuntimeId as RuntimeIdentity } from './runtime-definition.ts';
+import { composeRuntimes as composeRuntimeGraphs, defineRuntimeMatrix as createRuntimeMatrixDefinition, isDefinedRuntimeMatrix as isRuntimeMatrixDefinition, type ComposedRuntimeGraph as ComposedRuntimeGraphDescriptor, type RuntimeGraph as RuntimeGraphDescriptor, type RuntimeGraphLeaf as RuntimeGraphLeafDescriptor, type RuntimeMatrixDefinition as RuntimeMatrixDescriptor, type RuntimeMatrixDefinitionInput as RuntimeMatrixDescriptorInput, type SharedRuntimeMatrixDefinitionInput as SharedRuntimeMatrixDescriptorInput, type RuntimeMatrixVariant as RuntimeMatrixVariantDescriptor } from './runtime-matrix-definition.ts';
+import type { AnyResourceDefinition as AnyResourceDefinitionShape, Awaitable as AwaitableShape, EmptyResourceDependencies as EmptyResourceDependenciesShape, ExecutionRequirement as ExecutionRequirementShape, ResourceDependencies as ResourceDependenciesShape, ResourceProjectionPayload as ResourceProjectionPayloadShape, ResourceScope as ResourceScopeShape, RuntimeResourceMap as RuntimeResourceMapShape, ValueOf } from './resource-definition-shape.ts';
+export type AnyResourceDefinition = AnyResourceDefinitionShape;
+export type Awaitable<Value> = AwaitableShape<Value>;
+export type EmptyResourceDependencies = EmptyResourceDependenciesShape;
+export type ExecutionRequirement = ExecutionRequirementShape;
+export type ResourceDependencies = ResourceDependenciesShape;
+export type ResourceProjectionPayload = ResourceProjectionPayloadShape;
+export type ResourceScope = ResourceScopeShape;
+export type RuntimeResourceMap = RuntimeResourceMapShape;
+export declare const defineRuntime: typeof createRuntimeDefinition;
+export declare const isDefinedRuntime: typeof isRuntimeDefinition;
+export declare const isDefinedRuntimeMatrix: typeof isRuntimeMatrixDefinition;
+export declare const composeRuntimes: typeof composeRuntimeGraphs;
+export type RuntimeDefinition<Name extends string = string, Dimensions extends RuntimeDimensionMap = RuntimeDimensionMap, Resources extends RuntimeResourceMap = RuntimeResourceMap> = RuntimeDefinitionDescriptor<Name, Dimensions, Resources>;
+export type RuntimeDefinitionInput<Name extends string, Dimensions extends RuntimeDimensionMap, Resources extends RuntimeResourceMap> = RuntimeDefinitionDescriptorInput<Name, Dimensions, Resources>;
+export type RuntimeDimensions = RuntimeDimensionMap;
+export type RuntimeGraph = RuntimeGraphDescriptor;
+export type RuntimeGraphLeaf = RuntimeGraphLeafDescriptor;
+export type ComposedRuntimeGraph<Runtimes extends readonly RuntimeGraphLeaf[] = readonly RuntimeGraphLeaf[]> = ComposedRuntimeGraphDescriptor<Runtimes>;
+export type RuntimeId<Name extends string = string, Dimensions extends RuntimeDimensions = RuntimeDimensions> = RuntimeIdentity<Name, Dimensions>;
+export type RuntimeMatrixDefinition<Name extends string = string, Variants extends RuntimeMatrixVariantMap = RuntimeMatrixVariantMap> = RuntimeMatrixDescriptor<Name, Variants>;
+export type RuntimeMatrixDefinitionInput<Name extends string, Variants extends Readonly<Record<string, RuntimeDefinition>>> = RuntimeMatrixDescriptorInput<Name, Variants>;
+export type SharedRuntimeMatrixDefinitionInput<Name extends string, Shared, Variants extends Readonly<Record<string, RuntimeDefinition | ((shared: Shared) => RuntimeDefinition)>>> = SharedRuntimeMatrixDescriptorInput<Name, Shared, Variants>;
+export type RuntimeMatrixVariant<VariantId extends string = string, Runtime extends RuntimeDefinition = RuntimeDefinition> = RuntimeMatrixVariantDescriptor<VariantId, Runtime>;
+export type RuntimeMatrixVariantMap = Readonly<Record<string, RuntimeMatrixVariant>>;
+declare const resourceDefinitionBrand: unique symbol;
+export type ResourceProjectionContext<Dependencies extends ResourceDependencies = EmptyResourceDependencies> = {
+    readonly dependencies: ResourceContext<Dependencies>;
+};
+export type ResourceHandle<Resource extends AnyResourceDefinition> = Resource extends {
+    readonly deserializeHandle?: ((payload: never, context: never) => infer ConsumerHandle) | undefined;
+} ? ConsumerHandle : Awaited<ReturnType<Resource['acquire']>>;
+export type ResourceContext<Resources extends ResourceDependencies> = {
+    readonly [Key in keyof Resources]: ResourceHandle<Resources[Key]>;
+};
+export type ResourceCreationContext<Dependencies extends ResourceDependencies = EmptyResourceDependencies> = {
+    readonly dependencies: ResourceContext<Dependencies>;
+    readonly signal: AbortSignal;
+};
+export type ResourceDisposalContext<Dependencies extends ResourceDependencies = EmptyResourceDependencies> = {
+    readonly dependencies: ResourceContext<Dependencies>;
+    readonly signal: AbortSignal;
+};
+type ResourceDefinitionBaseInput<Name extends string, Handle, Scope extends ResourceScope, Dependencies extends ResourceDependencies = EmptyResourceDependencies> = {
+    readonly acquire: (context: ResourceCreationContext<Dependencies>) => Awaitable<Handle>;
+    readonly dependencies?: Dependencies;
+    readonly dispose: ((handle: Handle, context: ResourceDisposalContext<Dependencies>) => Awaitable<void>) | null;
+    readonly name: Name;
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly scope: Scope;
+};
+type LocalOnlyResourceDefinitionInput<Name extends string, Handle, Scope extends ResourceScope, Dependencies extends ResourceDependencies = EmptyResourceDependencies> = ResourceDefinitionBaseInput<Name, Handle, Scope, Dependencies> & {
+    readonly deserializeHandle?: never;
+    readonly serializeHandle?: never;
+};
+type ProjectedResourceDefinitionInput<Name extends string, OwnerHandle, Projection extends ResourceProjectionPayload, ConsumerHandle, Scope extends 'per-file' | 'per-run' | 'per-suite', Dependencies extends ResourceDependencies = EmptyResourceDependencies> = ResourceDefinitionBaseInput<Name, OwnerHandle, Scope, Dependencies> & {
+    readonly deserializeHandle: (payload: Projection, context: ResourceProjectionContext<Dependencies>) => ConsumerHandle;
+    readonly serializeHandle: (handle: OwnerHandle, context: ResourceProjectionContext<Dependencies>) => Projection;
+};
+export type ResourceDefinitionInput<Name extends string, Handle, Dependencies extends ResourceDependencies = EmptyResourceDependencies, Projection extends ResourceProjectionPayload = ResourceProjectionPayload, ConsumerHandle = Handle> = ValueOf<ResourceDefinitionInputOptions<Name, Handle, Dependencies, Projection, ConsumerHandle>>;
+type ResourceDefinitionInputOptions<Name extends string, Handle, Dependencies extends ResourceDependencies, Projection extends ResourceProjectionPayload, ConsumerHandle> = {
+    readonly local: LocalResourceDefinitionInput<Name, Handle, Dependencies>;
+    readonly projected: ProjectedResourceInput<Name, Handle, Projection, ConsumerHandle, Dependencies>;
+};
+type LocalResourceDefinitionInput<Name extends string, Handle, Dependencies extends ResourceDependencies> = LocalCaseResourceInput<Name, Handle, Dependencies> | LocalFileResourceInput<Name, Handle, Dependencies>;
+type LocalCaseResourceInput<Name extends string, Handle, Dependencies extends ResourceDependencies> = LocalOnlyResourceDefinitionInput<Name, Handle, 'per-case' | 'shared-per-worker', Dependencies>;
+type LocalFileResourceInput<Name extends string, Handle, Dependencies extends ResourceDependencies> = LocalOnlyResourceDefinitionInput<Name, Handle, 'per-file' | 'per-suite', Dependencies>;
+type ProjectedResourceInput<Name extends string, Handle, Projection extends ResourceProjectionPayload, ConsumerHandle, Dependencies extends ResourceDependencies> = ValueOf<ProjectedResourceInputOptions<Name, Handle, Projection, ConsumerHandle, Dependencies>>;
+type ProjectedResourceInputOptions<Name extends string, Handle, Projection extends ResourceProjectionPayload, ConsumerHandle, Dependencies extends ResourceDependencies> = {
+    readonly file: ProjectedFileResourceInput<Name, Handle, Projection, ConsumerHandle, Dependencies>;
+    readonly run: ProjectedRunResourceInput<Name, Handle, Projection, ConsumerHandle, Dependencies>;
+};
+type ProjectedFileResourceInput<Name extends string, Handle, Projection extends ResourceProjectionPayload, ConsumerHandle, Dependencies extends ResourceDependencies> = ProjectedResourceDefinitionInput<Name, Handle, Projection, ConsumerHandle, 'per-file' | 'per-suite', Dependencies>;
+type ProjectedRunResourceInput<Name extends string, Handle, Projection extends ResourceProjectionPayload, ConsumerHandle, Dependencies extends ResourceDependencies> = ProjectedResourceDefinitionInput<Name, Handle, Projection, ConsumerHandle, 'per-run', Dependencies>;
+export type ResourceDefinition<Name extends string = string, OwnerHandle = unknown, Dependencies extends ResourceDependencies = ResourceDependencies, ConsumerHandle = OwnerHandle> = {
+    readonly acquire: (context: ResourceCreationContext<Dependencies>) => Awaitable<OwnerHandle>;
+    readonly dependencies: Dependencies;
+    readonly deserializeHandle?: (payload: ResourceProjectionPayload, context: ResourceProjectionContext<Dependencies>) => ConsumerHandle;
+    readonly dispose: ((handle: OwnerHandle, context: ResourceDisposalContext<Dependencies>) => Awaitable<void>) | null;
+    readonly name: Name;
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly scope: ResourceScope;
+    readonly serializeHandle?: (handle: OwnerHandle, context: ResourceProjectionContext<Dependencies>) => ResourceProjectionPayload;
+    readonly [resourceDefinitionBrand]: true;
+};
+type UnionToIntersection<Value> = (Value extends unknown ? (value: Value) => void : never) extends (value: infer Intersection) => void ? Intersection : never;
+type RuntimeGraphName<Graph extends RuntimeGraph> = ComposedRuntimeNames<Graph> | NamedRuntimeGraphName<Graph>;
+type ComposedRuntimeNames<Graph extends RuntimeGraph> = Graph extends ComposedRuntimeGraph<infer Runtimes> ? RuntimeGraphName<Runtimes[number]> : never;
+type NamedRuntimeGraphName<Graph> = Graph extends {
+    readonly name: infer Name extends string;
+} ? Name : never;
+type RuntimeMatrixRuntime<Matrix extends RuntimeMatrixDefinition> = Matrix['variants'][keyof Matrix['variants']]['runtime'];
+type RuntimeGraphRuntime<Graph extends RuntimeGraphLeaf> = {
+    readonly runtime: Extract<Graph, RuntimeDefinition>;
+    readonly 'runtime-matrix': RuntimeMatrixRuntime<Extract<Graph, RuntimeMatrixDefinition>>;
+}[Graph['kind']];
+type RuntimeGraphResources<Runtime extends RuntimeGraphLeaf> = RuntimeGraphRuntime<Runtime>['resources'];
+export type RuntimeContext<Runtime extends RuntimeGraphLeaf> = {
+    readonly [Key in keyof RuntimeGraphResources<Runtime>]: ResourceHandle<RuntimeGraphResources<Runtime>[Key]>;
+};
+export type RuntimeGraphContext<Graph extends RuntimeGraph> = Graph extends ComposedRuntimeGraph ? RuntimeScopeContext<Graph> : RuntimeContext<Extract<Graph, RuntimeGraphLeaf>>;
+export type RuntimeScopeContext<Runtime extends RuntimeGraph> = Readonly<Runtime extends ComposedRuntimeGraph<infer Runtimes> ? UnionToIntersection<RuntimeScopeContext<Runtimes[number]>> : Record<RuntimeGraphName<Runtime>, RuntimeContext<Extract<Runtime, RuntimeGraphLeaf>>>>;
+type EmptyRuntimeScopes = Pick<Readonly<Record<string, never>>, never>;
+type RuntimeScopeKey<Runtime extends RuntimeGraph> = RuntimeGraphName<Runtime>;
+type RuntimeScopes<Context> = Context extends {
+    readonly runtimes: infer Runtimes extends Readonly<Record<string, unknown>>;
+} ? Runtimes : EmptyRuntimeScopes;
+type RuntimeScopeGuard<Context, Runtime extends RuntimeGraph> = Extract<RuntimeScopeKey<Runtime>, keyof RuntimeScopes<Context>> extends never ? unknown : never;
+type RuntimeScopeBaseContext<Context> = {
+    readonly [Key in keyof Context as Key extends 'runtimes' ? never : Key]: Context[Key];
+};
+type ComposedRuntimeScopes<BaseContext, Runtime extends RuntimeGraph> = {
+    readonly runtimes: RuntimeScopeContext<Runtime> & RuntimeScopes<BaseContext>;
+};
+export type RuntimeContextComposition<BaseContext, Runtime extends RuntimeGraph> = Readonly<ComposedRuntimeScopes<BaseContext, Runtime> & RuntimeScopeBaseContext<BaseContext>>;
+export type TemporaryDirectoryHandle = {
+    readonly path: string;
+};
+export type ResourcesModuleDependencies = {
+    readonly createTemporaryDirectory: (pathPrefix: string) => Awaitable<string>;
+    readonly removeDirectory: (path: string) => Awaitable<void>;
+    readonly temporaryDirectoryPathPrefix: string;
+};
+type CreateTemporaryDirectoryResource = <const Name extends string>(name: Name) => ResourceDefinition<Name, TemporaryDirectoryHandle, EmptyResourceDependencies>;
+export type ResourcesModule = {
+    readonly composeRuntimeContext: typeof composeRuntimeContext;
+    readonly createTemporaryDirectoryResource: CreateTemporaryDirectoryResource;
+    readonly defineResource: typeof defineResource;
+    readonly defineRuntime: typeof defineRuntime;
+    readonly defineRuntimeMatrix: typeof createRuntimeMatrixDefinition;
+    readonly composeRuntimes: typeof composeRuntimeGraphs;
+};
+export declare function defineResource<const Name extends string, Handle, Scope extends Exclude<ResourceScope, 'per-run'>>(definition: LocalOnlyResourceDefinitionInput<Name, Handle, Scope>): ResourceDefinition<Name, Handle, EmptyResourceDependencies>;
+export declare function defineResource<const Name extends string, OwnerHandle, Projection extends ResourceProjectionPayload, ConsumerHandle, Scope extends 'per-file' | 'per-run' | 'per-suite'>(definition: ProjectedResourceDefinitionInput<Name, OwnerHandle, Projection, ConsumerHandle, Scope>): ResourceDefinition<Name, OwnerHandle, EmptyResourceDependencies, ConsumerHandle>;
+export declare function defineResource<const Name extends string, Handle, Scope extends Exclude<ResourceScope, 'per-run'>, const Dependencies extends ResourceDependencies>(definition: LocalOnlyResourceDefinitionInput<Name, Handle, Scope, Dependencies> & {
+    readonly dependencies: Dependencies;
+}): ResourceDefinition<Name, Handle, Dependencies>;
+export declare function defineResource<const Name extends string, OwnerHandle, Projection extends ResourceProjectionPayload, ConsumerHandle, Scope extends 'per-file' | 'per-run' | 'per-suite', const Dependencies extends ResourceDependencies>(definition: ProjectedResourceDefinitionInput<Name, OwnerHandle, Projection, ConsumerHandle, Scope, Dependencies> & {
+    readonly dependencies: Dependencies;
+}): ResourceDefinition<Name, OwnerHandle, Dependencies, ConsumerHandle>;
+declare function composeRuntimeContext<BaseContext extends Readonly<Record<string, unknown>>, Runtime extends RuntimeGraph>(context: BaseContext & RuntimeScopeGuard<BaseContext, Runtime>, runtime: Runtime, resourceHandles: RuntimeGraphContext<Runtime>): RuntimeContextComposition<BaseContext, Runtime>;
+export declare function createResourcesModule(dependencies: ResourcesModuleDependencies): ResourcesModule;
+export declare function isDefinedResource(resource: unknown): resource is AnyResourceDefinition;
+export declare function isDefinedRuntimeGraph(runtime: unknown): runtime is RuntimeGraph;
+export declare function runtimeGraphLeaves(runtime: RuntimeGraph): readonly RuntimeGraphLeaf[];
+export {};
+//# sourceMappingURL=resources.d.ts.map

package/resources/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../../source/resources/resources.ts"],"names":[],"mappings":"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"}

package/resources/resources.js

@@ -0,0 +1,99 @@
+import { defineRuntime as createRuntimeDefinition, isDefinedRuntime as isRuntimeDefinition } from "./runtime-definition.js";
+import { composeRuntimes as composeRuntimeGraphs, defineRuntimeMatrix as createRuntimeMatrixDefinition, isComposedRuntimeGraph, isDefinedRuntimeMatrix as isRuntimeMatrixDefinition, runtimeGraphLeaves as runtimeGraphLeafDescriptors } from "./runtime-matrix-definition.js";
+export const defineRuntime = createRuntimeDefinition;
+export const isDefinedRuntime = isRuntimeDefinition;
+export const isDefinedRuntimeMatrix = isRuntimeMatrixDefinition;
+export const composeRuntimes = composeRuntimeGraphs;
+const resourceDefinitionBrand = Symbol('overkill.resourceDefinition');
+function assertRuntimeContextHandles(runtime, nextRuntimes) {
+    if (!isComposedRuntimeGraph(runtime)) {
+        return;
+    }
+    for (const childRuntime of runtime.runtimes) {
+        if (!Object.hasOwn(nextRuntimes, childRuntime.name)) {
+            throw new TypeError(`Runtime scope "${childRuntime.name}" is missing.`);
+        }
+    }
+}
+function runtimeContextHandles(runtime, resourceHandles) {
+    return isComposedRuntimeGraph(runtime)
+        ? resourceHandles
+        : { [runtime.name]: resourceHandles };
+}
+export function defineResource(definition) {
+    if (definition.dependencies === undefined) {
+        const dependencies = Object.freeze({});
+        return Object.freeze({
+            ...definition,
+            dependencies,
+            [resourceDefinitionBrand]: true
+        });
+    }
+    return Object.freeze({
+        ...definition,
+        dependencies: Object.freeze(definition.dependencies),
+        [resourceDefinitionBrand]: true
+    });
+}
+function createTemporaryDirectoryResource(dependencies, name) {
+    return defineResource({
+        name,
+        scope: 'per-case',
+        requirements: [],
+        async acquire(context) {
+            context.signal.throwIfAborted();
+            return Object.freeze({
+                path: await dependencies.createTemporaryDirectory(dependencies.temporaryDirectoryPathPrefix)
+            });
+        },
+        async dispose(handle) {
+            await dependencies.removeDirectory(handle.path);
+        }
+    });
+}
+function composeRuntimeContext(context, runtime, resourceHandles) {
+    const runtimes = Object.hasOwn(context, 'runtimes') ? Reflect.get(context, 'runtimes') : {};
+    if (typeof runtimes !== 'object' || runtimes === null || Array.isArray(runtimes)) {
+        throw new TypeError('composeRuntimeContext() requires context.runtimes to be an object when present.');
+    }
+    const nextRuntimes = runtimeContextHandles(runtime, resourceHandles);
+    const duplicateRuntimeName = Object.keys(nextRuntimes).find(function runtimeNameExists(runtimeName) {
+        return Object.hasOwn(runtimes, runtimeName);
+    });
+    assertRuntimeContextHandles(runtime, nextRuntimes);
+    if (duplicateRuntimeName !== undefined) {
+        throw new TypeError(`Runtime scope "${duplicateRuntimeName}" already exists.`);
+    }
+    return Object.freeze({
+        ...context,
+        runtimes: Object.freeze({
+            ...runtimes,
+            ...nextRuntimes
+        })
+    });
+}
+export function createResourcesModule(dependencies) {
+    return Object.freeze({
+        composeRuntimeContext,
+        createTemporaryDirectoryResource(name) {
+            return createTemporaryDirectoryResource(dependencies, name);
+        },
+        composeRuntimes,
+        defineResource,
+        defineRuntime,
+        defineRuntimeMatrix: createRuntimeMatrixDefinition
+    });
+}
+export function isDefinedResource(resource) {
+    return typeof resource === 'object' &&
+        resource !== null &&
+        Reflect.get(resource, resourceDefinitionBrand) === true;
+}
+export function isDefinedRuntimeGraph(runtime) {
+    return isDefinedRuntime(runtime) || isDefinedRuntimeMatrix(runtime) || isComposedRuntimeGraph(runtime);
+}
+export function runtimeGraphLeaves(runtime) {
+    const leaves = runtimeGraphLeafDescriptors(runtime);
+    return leaves;
+}
+//# sourceMappingURL=resources.js.map

package/resources/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../../source/resources/resources.ts"],"names":[],"mappings":"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"}

package/resources/runtime-definition.d.ts

@@ -0,0 +1,23 @@
+import type { ExecutionRequirement, RuntimeResourceMap } from './resource-definition-shape.ts';
+declare const runtimeDefinitionBrand: unique symbol;
+export type RuntimeDimensions = Readonly<Record<string, string>>;
+export type RuntimeId<Name extends string = string, Dimensions extends RuntimeDimensions = RuntimeDimensions> = {
+    readonly name: Name;
+    readonly dimensions: Dimensions;
+    readonly variantId: string | null;
+};
+export type RuntimeDefinitionInput<Name extends string, Dimensions extends RuntimeDimensions, Resources extends RuntimeResourceMap> = {
+    readonly dimensions: Dimensions;
+    readonly name: Name;
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly resources: Resources;
+};
+export type RuntimeDefinition<Name extends string = string, Dimensions extends RuntimeDimensions = RuntimeDimensions, Resources extends RuntimeResourceMap = RuntimeResourceMap> = RuntimeDefinitionInput<Name, Dimensions, Resources> & {
+    readonly id: RuntimeId<Name, Dimensions>;
+    readonly kind: 'runtime';
+    readonly [runtimeDefinitionBrand]: true;
+};
+export declare function defineRuntime<const Name extends string, const Dimensions extends RuntimeDimensions, const Resources extends RuntimeResourceMap>(definition: RuntimeDefinitionInput<Name, Dimensions, Resources>): RuntimeDefinition<Name, Dimensions, Resources>;
+export declare function isDefinedRuntime(runtime: unknown): runtime is RuntimeDefinition;
+export {};
+//# sourceMappingURL=runtime-definition.d.ts.map

package/resources/runtime-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-definition.d.ts","sourceRoot":"","sources":["../../../../source/resources/runtime-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAE/F,QAAA,MAAM,sBAAsB,EAAE,OAAO,MAA6C,CAAC;AAEnF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjE,MAAM,MAAM,SAAS,CACjB,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,UAAU,SAAS,iBAAiB,GAAG,iBAAiB,IACxD;IACA,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAC9B,IAAI,SAAS,MAAM,EACnB,UAAU,SAAS,iBAAiB,EACpC,SAAS,SAAS,kBAAkB,IACpC;IACA,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,iBAAiB,CACzB,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,UAAU,SAAS,iBAAiB,GAAG,iBAAiB,EACxD,SAAS,SAAS,kBAAkB,GAAG,kBAAkB,IACzD,sBAAsB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,GAAG;IACtD,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAC;CAC3C,CAAC;AAEF,wBAAgB,aAAa,CACzB,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,UAAU,SAAS,iBAAiB,EAC1C,KAAK,CAAC,SAAS,SAAS,kBAAkB,EAE1C,UAAU,EAAE,sBAAsB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,GAChE,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,CAWhD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,iBAAiB,CAI/E"}

package/resources/runtime-definition.js

@@ -0,0 +1,19 @@
+const runtimeDefinitionBrand = Symbol('overkill.runtimeDefinition');
+export function defineRuntime(definition) {
+    return Object.freeze({
+        ...definition,
+        id: Object.freeze({
+            name: definition.name,
+            dimensions: definition.dimensions,
+            variantId: null
+        }),
+        kind: 'runtime',
+        [runtimeDefinitionBrand]: true
+    });
+}
+export function isDefinedRuntime(runtime) {
+    return typeof runtime === 'object' &&
+        runtime !== null &&
+        Reflect.get(runtime, runtimeDefinitionBrand) === true;
+}
+//# sourceMappingURL=runtime-definition.js.map

package/resources/runtime-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-definition.js","sourceRoot":"","sources":["../../../../source/resources/runtime-definition.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAkB,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAkCnF,MAAM,UAAU,aAAa,CAKzB,UAA+D;IAE/D,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,GAAG,UAAU;QACb,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC;YACd,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,SAAS,EAAE,IAAI;SAClB,CAAC;QACF,IAAI,EAAE,SAAS;QACf,CAAC,sBAAsB,CAAC,EAAE,IAAa;KAC1C,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC7C,OAAO,OAAO,OAAO,KAAK,QAAQ;QAC9B,OAAO,KAAK,IAAI;QAChB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,sBAAsB,CAAC,KAAK,IAAI,CAAC;AAC9D,CAAC"}

package/resources/runtime-lifecycle.d.ts

@@ -0,0 +1,14 @@
+import { type RuntimeContext, type RuntimeDefinition } from './resources.ts';
+export type StartRuntimeRequest<Runtime extends RuntimeDefinition> = {
+    readonly runtime: Runtime;
+    readonly signal: AbortSignal;
+};
+export type RuntimeSessionDisposalContext = {
+    readonly signal: AbortSignal;
+};
+export type RuntimeSession<Runtime extends RuntimeDefinition> = AsyncDisposable & {
+    readonly context: RuntimeContext<Runtime>;
+    readonly disposeOnce: (context: RuntimeSessionDisposalContext) => Promise<void>;
+};
+export declare function startRuntime<Runtime extends RuntimeDefinition>(request: StartRuntimeRequest<Runtime>): Promise<RuntimeSession<Runtime>>;
+//# sourceMappingURL=runtime-lifecycle.d.ts.map

package/resources/runtime-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-lifecycle.d.ts","sourceRoot":"","sources":["../../../../source/resources/runtime-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAEzB,MAAM,gBAAgB,CAAC;AAoBxB,MAAM,MAAM,mBAAmB,CAAC,OAAO,SAAS,iBAAiB,IAAI;IACjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,OAAO,SAAS,iBAAiB,IAAI,eAAe,GAAG;IAC9E,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF,CAAC;AAqGF,wBAAsB,YAAY,CAAC,OAAO,SAAS,iBAAiB,EAChE,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CASlC"}