@overkill-dev/resources 0.0.1 → 0.0.3

package/resources/resource-graph.js

@@ -0,0 +1,151 @@
+import { isDefinedResource } from "./resources.js";
+import { resourceLifecycleError } from "./resource-lifecycle-error.js";
+const perRunScopeRank = 0;
+const perFileScopeRank = 1;
+const perSuiteScopeRank = 2;
+const sharedPerWorkerScopeRank = 3;
+const perCaseScopeRank = 4;
+export function resourceEntries(resources) {
+    return Object.entries(resources);
+}
+function scopeDescription(scope) {
+    return scope === 'per-case'
+        ? 'per-case scope'
+        : `${scope} scope, which direct execution wrappers do not support yet`;
+}
+function scopeRank(scope) {
+    if (scope === 'per-run') {
+        return perRunScopeRank;
+    }
+    if (scope === 'per-file') {
+        return perFileScopeRank;
+    }
+    if (scope === 'per-suite') {
+        return perSuiteScopeRank;
+    }
+    if (scope === 'shared-per-worker') {
+        return sharedPerWorkerScopeRank;
+    }
+    return perCaseScopeRank;
+}
+function dependencyScopeAllowed(resource, dependency) {
+    const resourceScope = resource.scope;
+    const dependencyScope = dependency.scope;
+    if (dependencyScope === 'shared-per-worker') {
+        return resource.scope === 'shared-per-worker' || resource.scope === 'per-case';
+    }
+    if (resourceScope === 'shared-per-worker') {
+        return dependency.scope === 'per-run' || dependency.scope === 'shared-per-worker';
+    }
+    return scopeRank(dependencyScope) <= scopeRank(resourceScope);
+}
+function hasCallableResourceCallbacks(resource) {
+    return isDefinedResource(resource) && typeof resource.acquire === 'function';
+}
+export function callableResourceDefinition(resource) {
+    if (hasCallableResourceCallbacks(resource)) {
+        return resource;
+    }
+    throw resourceLifecycleError('Resource descriptor is invalid.', [
+        { cause: resource, phase: 'graph', resourceName: 'resource' }
+    ], resource);
+}
+function assertUniqueResourceName(descriptorsByName, resource) {
+    const descriptorForName = descriptorsByName.get(resource.name);
+    if (descriptorForName !== undefined && descriptorForName !== resource) {
+        throw resourceLifecycleError(`Resource name "${resource.name}" is used by multiple descriptors.`, [
+            { cause: resource, phase: 'graph', resourceName: resource.name }
+        ], resource);
+    }
+}
+function assertResourceAcyclic(traversal, resource, path) {
+    if (traversal.has(resource)) {
+        throw resourceLifecycleError(`Resource dependency cycle detected: ${path.join(' -> ')}.`, [
+            { cause: resource, phase: 'graph', resourceName: resource.name }
+        ], resource);
+    }
+}
+function createResourceGraphBuilder() {
+    const descriptorsByName = new Map();
+    const nodesByDescriptor = new Map();
+    const order = [];
+    const traversal = new Set();
+    const builder = {
+        assertAcyclic(resource, path) {
+            assertResourceAcyclic(traversal, resource, path);
+        },
+        assertUniqueName(resource) {
+            assertUniqueResourceName(descriptorsByName, resource);
+            descriptorsByName.set(resource.name, resource);
+        },
+        build(resources) {
+            const topLevelEntries = resourceEntries(resources);
+            for (const [, resource] of topLevelEntries) {
+                builder.visit(resource, [resource.name]);
+            }
+            return { order, topLevelEntries };
+        },
+        record(resource, path) {
+            traversal.add(resource);
+            const dependencies = resourceEntries(resource.dependencies).map(function visitDependency([, dependency]) {
+                return builder.visit(dependency, [...path, dependency.name]);
+            });
+            const node = { dependencies, descriptor: resource };
+            traversal.delete(resource);
+            nodesByDescriptor.set(resource, node);
+            order.push(node);
+            return node;
+        },
+        visit(resource, path) {
+            const callableResource = callableResourceDefinition(resource);
+            const existingNode = nodesByDescriptor.get(callableResource);
+            builder.assertUniqueName(callableResource);
+            builder.assertAcyclic(callableResource, path);
+            if (existingNode !== undefined) {
+                return existingNode;
+            }
+            return builder.record(callableResource, path);
+        }
+    };
+    return builder;
+}
+export function createResourceGraph(resources) {
+    return createResourceGraphBuilder().build(resources);
+}
+export function assertPerCaseResourceGraph(resources) {
+    const graph = createResourceGraph(resources);
+    const nonPerCaseResource = graph.order.find(function hasBroaderScope(node) {
+        return node.descriptor.scope !== 'per-case';
+    });
+    if (nonPerCaseResource === undefined) {
+        return;
+    }
+    throw resourceLifecycleError(`Resource "${nonPerCaseResource.descriptor.name}" uses ${scopeDescription(nonPerCaseResource.descriptor.scope)}.`, [
+        {
+            cause: nonPerCaseResource.descriptor,
+            phase: 'graph',
+            resourceName: nonPerCaseResource.descriptor.name
+        }
+    ], nonPerCaseResource.descriptor);
+}
+export function assertResourceDependencyScopes(resources) {
+    const graph = createResourceGraph(resources);
+    for (const node of graph.order) {
+        for (const dependency of node.dependencies) {
+            if (!dependencyScopeAllowed(node.descriptor, dependency.descriptor)) {
+                throw resourceLifecycleError([
+                    `Resource "${node.descriptor.name}" uses ${node.descriptor.scope} scope and cannot depend on`,
+                    `resource "${dependency.descriptor.name}" with ${dependency.descriptor.scope} scope.`
+                ]
+                    .join(' '), [
+                    {
+                        cause: dependency.descriptor,
+                        phase: 'graph',
+                        resourceName: node.descriptor.name
+                    }
+                ], dependency.descriptor);
+            }
+        }
+    }
+}
+//# sourceMappingURL=resource-graph.js.map

package/resources/resource-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-graph.js","sourceRoot":"","sources":["../../../../source/resources/resource-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,iBAAiB,EAKpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AA4BvE,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,wBAAwB,GAAG,CAAC,CAAC;AACnC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B,MAAM,UAAU,eAAe,CAAC,SAA+B;IAC3D,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAoB;IAC1C,OAAO,KAAK,KAAK,UAAU;QACvB,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,GAAG,KAAK,4DAA4D,CAAC;AAC/E,CAAC;AAED,SAAS,SAAS,CAAC,KAAoB;IACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,eAAe,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACvB,OAAO,gBAAgB,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QACxB,OAAO,iBAAiB,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,KAAK,mBAAmB,EAAE,CAAC;QAChC,OAAO,wBAAwB,CAAC;IACpC,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC5B,CAAC;AAED,SAAS,sBAAsB,CAAC,QAA+B,EAAE,UAAiC;IAC9F,MAAM,aAAa,GAAkB,QAAQ,CAAC,KAAK,CAAC;IACpD,MAAM,eAAe,GAAkB,UAAU,CAAC,KAAK,CAAC;IAExD,IAAI,eAAe,KAAK,mBAAmB,EAAE,CAAC;QAC1C,OAAO,QAAQ,CAAC,KAAK,KAAK,mBAAmB,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU,CAAC;IACnF,CAAC;IAED,IAAI,aAAa,KAAK,mBAAmB,EAAE,CAAC;QACxC,OAAO,UAAU,CAAC,KAAK,KAAK,SAAS,IAAI,UAAU,CAAC,KAAK,KAAK,mBAAmB,CAAC;IACtF,CAAC;IAED,OAAO,SAAS,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC,aAAa,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,4BAA4B,CAAC,QAA+B;IACjE,OAAO,iBAAiB,CAAC,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAA+B;IACtE,IAAI,4BAA4B,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,MAAM,sBAAsB,CAAC,iCAAiC,EAAE;QAC5D,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE;KAChE,EAAE,QAAQ,CAAC,CAAC;AACjB,CAAC;AAED,SAAS,wBAAwB,CAC7B,iBAA6D,EAC7D,QAA+B;IAE/B,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE/D,IAAI,iBAAiB,KAAK,SAAS,IAAI,iBAAiB,KAAK,QAAQ,EAAE,CAAC;QACpE,MAAM,sBAAsB,CAAC,kBAAkB,QAAQ,CAAC,IAAI,oCAAoC,EAAE;YAC9F,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE;SACnE,EAAE,QAAQ,CAAC,CAAC;IACjB,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAC1B,SAA6C,EAC7C,QAA+B,EAC/B,IAAuB;IAEvB,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,sBAAsB,CAAC,uCAAuC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACtF,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE;SACnE,EAAE,QAAQ,CAAC,CAAC;IACjB,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B;IAC/B,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAiC,CAAC;IACnE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAuC,CAAC;IACzE,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnD,MAAM,OAAO,GAA4B;QACrC,aAAa,CAAC,QAAQ,EAAE,IAAI;YACxB,qBAAqB,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,gBAAgB,CAAC,QAAQ;YACrB,wBAAwB,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;YACtD,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnD,CAAC;QACD,KAAK,CAAC,SAAS;YACX,MAAM,eAAe,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;YAEnD,KAAK,MAAM,CAAE,AAAD,EAAG,QAAQ,CAAE,IAAI,eAAe,EAAE,CAAC;gBAC3C,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAE,QAAQ,CAAC,IAAI,CAAE,CAAC,CAAC;YAC/C,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QACtC,CAAC;QACD,MAAM,CAAC,QAAQ,EAAE,IAAI;YACjB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAExB,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,SAAS,eAAe,CAAC,CAAE,AAAD,EAAG,UAAU,CAAE;gBACrG,OAAO,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,CAAE,GAAG,IAAI,EAAE,UAAU,CAAC,IAAI,CAAE,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;YAEpD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3B,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEjB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,KAAK,CAAC,QAAQ,EAAE,IAAI;YAChB,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;YAC9D,MAAM,YAAY,GAAG,iBAAiB,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAE7D,OAAO,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;YAC3C,OAAO,CAAC,aAAa,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;YAE9C,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO,YAAY,CAAC;YACxB,CAAC;YAED,OAAO,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;KACJ,CAAC;IAEF,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAA+B;IAC/D,OAAO,0BAA0B,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,SAA+B;IACtE,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,kBAAkB,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,eAAe,CAAC,IAAI;QACrE,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,UAAU,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO;IACX,CAAC;IAED,MAAM,sBAAsB,CACxB,aAAa,kBAAkB,CAAC,UAAU,CAAC,IAAI,UAC3C,gBAAgB,CAAC,kBAAkB,CAAC,UAAU,CAAC,KAAK,CACxD,GAAG,EACH;QACI;YACI,KAAK,EAAE,kBAAkB,CAAC,UAAU;YACpC,KAAK,EAAE,OAAO;YACd,YAAY,EAAE,kBAAkB,CAAC,UAAU,CAAC,IAAI;SACnD;KACJ,EACD,kBAAkB,CAAC,UAAU,CAChC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,SAA+B;IAC1E,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACzC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClE,MAAM,sBAAsB,CACxB;oBACI,aAAa,IAAI,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,KAAK,6BAA6B;oBAC7F,aAAa,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,UAAU,CAAC,UAAU,CAAC,KAAK,SAAS;iBACxF;qBACI,IAAI,CAAC,GAAG,CAAC,EACd;oBACI;wBACI,KAAK,EAAE,UAAU,CAAC,UAAU;wBAC5B,KAAK,EAAE,OAAO;wBACd,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;qBACrC;iBACJ,EACD,UAAU,CAAC,UAAU,CACxB,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC"}

package/resources/resource-lifecycle-error.d.ts

@@ -0,0 +1,19 @@
+export type ResourceLifecyclePhase = 'acquire' | 'dispose' | 'graph';
+export type ResourceLifecycleFailure = {
+    readonly cause: unknown;
+    readonly phase: ResourceLifecyclePhase;
+    readonly resourceName: string;
+};
+type ResourceLifecycleErrorOptions = {
+    readonly cause: unknown;
+    readonly failures: readonly ResourceLifecycleFailure[];
+};
+export declare class ResourceLifecycleError extends Error {
+    private readonly lifecycleFailures;
+    constructor(message: string, options: ResourceLifecycleErrorOptions);
+    failures(): readonly ResourceLifecycleFailure[];
+}
+export declare function resourceLifecycleError(message: string, failures: readonly ResourceLifecycleFailure[], cause: unknown): ResourceLifecycleError;
+export declare function lifecycleFailures(results: readonly PromiseSettledResult<unknown>[], fallbackResourceName: string): readonly ResourceLifecycleFailure[];
+export {};
+//# sourceMappingURL=resource-lifecycle-error.d.ts.map

package/resources/resource-lifecycle-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-lifecycle-error.d.ts","sourceRoot":"","sources":["../../../../source/resources/resource-lifecycle-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,wBAAwB,GAAG;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,KAAK,6BAA6B,GAAG;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC1D,CAAC;AAEF,qBAAa,sBAAuB,SAAQ,KAAK;IAC7C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsC;gBAGpE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,6BAA6B;IAOnC,QAAQ,IAAI,SAAS,wBAAwB,EAAE;CAGzD;AAED,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,wBAAwB,EAAE,EAC7C,KAAK,EAAE,OAAO,GACf,sBAAsB,CAExB;AAUD,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,SAAS,oBAAoB,CAAC,OAAO,CAAC,EAAE,EACjD,oBAAoB,EAAE,MAAM,GAC7B,SAAS,wBAAwB,EAAE,CAYrC"}

package/resources/resource-lifecycle-error.js

@@ -0,0 +1,32 @@
+export class ResourceLifecycleError extends Error {
+    lifecycleFailures;
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ResourceLifecycleError';
+        this.lifecycleFailures = options.failures;
+    }
+    failures() {
+        return this.lifecycleFailures;
+    }
+}
+export function resourceLifecycleError(message, failures, cause) {
+    return new ResourceLifecycleError(message, { cause, failures });
+}
+function lifecycleFailuresFrom(reason, fallbackResourceName) {
+    if (reason instanceof ResourceLifecycleError) {
+        return reason.failures();
+    }
+    return [{ cause: reason, phase: 'acquire', resourceName: fallbackResourceName }];
+}
+export function lifecycleFailures(results, fallbackResourceName) {
+    const failures = new Set();
+    for (const result of results) {
+        if (result.status === 'rejected') {
+            for (const failure of lifecycleFailuresFrom(result.reason, fallbackResourceName)) {
+                failures.add(failure);
+            }
+        }
+    }
+    return Array.from(failures);
+}
+//# sourceMappingURL=resource-lifecycle-error.js.map

package/resources/resource-lifecycle-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-lifecycle-error.js","sourceRoot":"","sources":["../../../../source/resources/resource-lifecycle-error.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC5B,iBAAiB,CAAsC;IAExE,YACI,OAAe,EACf,OAAsC;QAEtC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC9C,CAAC;IAEM,QAAQ;QACX,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAClC,CAAC;CACJ;AAED,MAAM,UAAU,sBAAsB,CAClC,OAAe,EACf,QAA6C,EAC7C,KAAc;IAEd,OAAO,IAAI,sBAAsB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAe,EAAE,oBAA4B;IACxE,IAAI,MAAM,YAAY,sBAAsB,EAAE,CAAC;QAC3C,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,CAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAE,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC7B,OAAiD,EACjD,oBAA4B;IAE5B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAErD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,KAAK,MAAM,OAAO,IAAI,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAAE,CAAC;gBAC/E,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1B,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/resources/resource-session.d.ts

@@ -0,0 +1,28 @@
+import type { AnyResourceDefinition, ResourceContext, ResourceDependencies } from './resources.ts';
+import { type ResourceNode } from './resource-graph.ts';
+import { type ResourceLifecycleFailure } from './resource-lifecycle-error.ts';
+type ResourceAcquisitionContext = {
+    readonly acquisitionFailureMessage: string;
+    readonly fallbackResourceName: string;
+};
+export type StartResourcesRequest<Resources extends ResourceDependencies> = {
+    readonly resources: Resources;
+    readonly signal: AbortSignal;
+};
+export type ResourceSessionDisposalContext = {
+    readonly signal: AbortSignal;
+};
+export type ResourceSession<Resources extends ResourceDependencies> = AsyncDisposable & {
+    readonly context: ResourceContext<Resources>;
+    readonly disposeOnce: (context: ResourceSessionDisposalContext) => Promise<void>;
+};
+export declare function disposeResources(order: readonly ResourceNode[], handles: ReadonlyMap<AnyResourceDefinition, unknown>, signal: AbortSignal): Promise<readonly ResourceLifecycleFailure[]>;
+export declare function runtimeAsyncDisposeSymbol(): symbol;
+export declare function acquireResourceGraph<Resources extends ResourceDependencies>(request: StartResourcesRequest<Resources>, context: ResourceAcquisitionContext): Promise<{
+    readonly context: ResourceContext<Resources>;
+    readonly handles: ReadonlyMap<AnyResourceDefinition, unknown>;
+    readonly order: readonly ResourceNode[];
+}>;
+export declare function startResources<Resources extends ResourceDependencies>(request: StartResourcesRequest<Resources>): Promise<ResourceSession<Resources>>;
+export {};
+//# sourceMappingURL=resource-session.d.ts.map

package/resources/resource-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-session.d.ts","sourceRoot":"","sources":["../../../../source/resources/resource-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,qBAAqB,EAErB,eAAe,EAEf,oBAAoB,EAEvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAMH,KAAK,YAAY,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGH,KAAK,wBAAwB,EAChC,MAAM,+BAA+B,CAAC;AASvC,KAAK,0BAA0B,GAAG;IAC9B,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACzC,CAAC;AAiBF,MAAM,MAAM,qBAAqB,CAAC,SAAS,SAAS,oBAAoB,IAAI;IACxE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IACzC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,SAAS,SAAS,oBAAoB,IAAI,eAAe,GAAG;IACpF,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,8BAA8B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpF,CAAC;AAsDF,wBAAsB,gBAAgB,CAClC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,EAAE,WAAW,CAAC,qBAAqB,EAAE,OAAO,CAAC,EACpD,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,wBAAwB,EAAE,CAAC,CAY9C;AAuID,wBAAgB,yBAAyB,IAAI,MAAM,CAQlD;AAQD,wBAAsB,oBAAoB,CAAC,SAAS,SAAS,oBAAoB,EAC7E,OAAO,EAAE,qBAAqB,CAAC,SAAS,CAAC,EACzC,OAAO,EAAE,0BAA0B,GACpC,OAAO,CAAC;IACP,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC9D,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C,CAAC,CASD;AAED,wBAAsB,cAAc,CAAC,SAAS,SAAS,oBAAoB,EACvE,OAAO,EAAE,qBAAqB,CAAC,SAAS,CAAC,GAC1C,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CA4BrC"}

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