@overkill-dev/resources 0.0.1 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Overkill contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,7 +1,33 @@
 {
-  "name": "@overkill-dev/resources",
-  "version": "0.0.1",
-  "description": "Placeholder claiming the npm package name \"@overkill-dev/resources\" so a trusted publisher can be configured. See https://github.com/npm/cli/issues/8544.",
-  "license": "MIT",
-  "deprecated": "Placeholder published as a workaround so a Trusted Publisher could be configured. See https://github.com/npm/cli/issues/8544."
-}
+    "author": "Christian Rackerseder <git@echooff.de>",
+    "bugs": {
+        "url": "https://github.com/enormora/overkill/issues"
+    },
+    "description": "Typed Overkill resource and runtime descriptors.",
+    "engines": {
+        "node": "^26.9.0"
+    },
+    "exports": {
+        ".": {
+            "import": "./packages/resources/resources.entry-point.js",
+            "types": "./packages/resources/resources.entry-point.d.ts"
+        }
+    },
+    "homepage": "https://github.com/enormora/overkill#readme",
+    "keywords": [
+        "tdd",
+        "test",
+        "tests"
+    ],
+    "license": "MIT",
+    "name": "@overkill-dev/resources",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/enormora/overkill.git"
+    },
+    "sideEffects": [
+        "./packages/resources/resources.entry-point.js"
+    ],
+    "type": "module",
+    "version": "0.0.2"
+}

package/packages/resources/resources.entry-point.d.ts

@@ -0,0 +1,18 @@
+import { type ResourcesModule } from '../../resources/resources.ts';
+export declare const composeRuntimeContext: ResourcesModule['composeRuntimeContext'];
+export declare const composeRuntimes: ResourcesModule['composeRuntimes'];
+export declare const createTemporaryDirectoryResource: ResourcesModule['createTemporaryDirectoryResource'];
+export declare const defineResource: ResourcesModule['defineResource'];
+export declare const defineRuntime: ResourcesModule['defineRuntime'];
+export declare const defineRuntimeMatrix: ResourcesModule['defineRuntimeMatrix'];
+export { isDefinedResource, isDefinedRuntime, isDefinedRuntimeGraph, isDefinedRuntimeMatrix, runtimeGraphLeaves } from '../../resources/resources.ts';
+export { assertPerCaseResourceGraph, assertResourceDependencyScopes } from '../../resources/resource-graph.ts';
+export { startResources } from '../../resources/resource-session.ts';
+export { ResourceLifecycleError } from '../../resources/resource-lifecycle-error.ts';
+export { startRuntime } from '../../resources/runtime-lifecycle.ts';
+export type { AnyResourceDefinition, ComposedRuntimeGraph, ExecutionRequirement, ResourceContext, ResourceCreationContext, ResourceDependencies, ResourceDefinition, ResourceDefinitionInput, ResourceDisposalContext, ResourceHandle, ResourceProjectionContext, ResourceProjectionPayload, ResourceScope, RuntimeContext, RuntimeContextComposition, RuntimeDefinition, RuntimeDefinitionInput, RuntimeDimensions, RuntimeGraph, RuntimeGraphLeaf, RuntimeGraphContext, RuntimeId, RuntimeMatrixDefinition, RuntimeMatrixDefinitionInput, RuntimeMatrixVariant, RuntimeMatrixVariantMap, RuntimeResourceMap, RuntimeScopeContext, SharedRuntimeMatrixDefinitionInput, TemporaryDirectoryHandle } from '../../resources/resources.ts';
+export type { RuntimeDefinition as Runtime, RuntimeResourceMap as ResourceMap } from '../../resources/resources.ts';
+export type { ResourceLifecycleFailure, ResourceLifecyclePhase } from '../../resources/resource-lifecycle-error.ts';
+export type { ResourceSession, ResourceSessionDisposalContext, StartResourcesRequest } from '../../resources/resource-session.ts';
+export type { RuntimeSession, RuntimeSessionDisposalContext, StartRuntimeRequest } from '../../resources/runtime-lifecycle.ts';
+//# sourceMappingURL=resources.entry-point.d.ts.map

package/packages/resources/resources.entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/resources/resources.entry-point.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAY3F,eAAO,MAAM,qBAAqB,EAAE,eAAe,CAAC,uBAAuB,CAAyC,CAAC;AACrH,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,iBAAiB,CAAmC,CAAC;AACnG,eAAO,MAAM,gCAAgC,EAAE,eAAe,CAAC,kCAAkC,CAC7C,CAAC;AACrD,eAAO,MAAM,cAAc,EAAE,eAAe,CAAC,gBAAgB,CAAkC,CAAC;AAChG,eAAO,MAAM,aAAa,EAAE,eAAe,CAAC,eAAe,CAAiC,CAAC;AAC7F,eAAO,MAAM,mBAAmB,EAAE,eAAe,CAAC,qBAAqB,CAAuC,CAAC;AAE/G,OAAO,EACH,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACH,0BAA0B,EAC1B,8BAA8B,EACjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACH,cAAc,EACjB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACH,sBAAsB,EACzB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACH,YAAY,EACf,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACR,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,EACT,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,kCAAkC,EAClC,wBAAwB,EAC3B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACR,iBAAiB,IAAI,OAAO,EAC5B,kBAAkB,IAAI,WAAW,EACpC,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACR,wBAAwB,EACxB,sBAAsB,EACzB,MAAM,6CAA6C,CAAC;AACrD,YAAY,EACR,eAAe,EACf,8BAA8B,EAC9B,qBAAqB,EACxB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACR,cAAc,EACd,6BAA6B,EAC7B,mBAAmB,EACtB,MAAM,sCAAsC,CAAC"}

package/packages/resources/resources.entry-point.js

@@ -0,0 +1,25 @@
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createResourcesModule } from "../../resources/resources.js";
+const resourcesModule = createResourcesModule({
+    temporaryDirectoryPathPrefix: join(tmpdir(), 'overkill-temporary-directory-'),
+    async createTemporaryDirectory(pathPrefix) {
+        return await mkdtemp(pathPrefix);
+    },
+    async removeDirectory(path) {
+        await rm(path, { force: true, recursive: true });
+    }
+});
+export const composeRuntimeContext = resourcesModule.composeRuntimeContext;
+export const composeRuntimes = resourcesModule.composeRuntimes;
+export const createTemporaryDirectoryResource = resourcesModule.createTemporaryDirectoryResource;
+export const defineResource = resourcesModule.defineResource;
+export const defineRuntime = resourcesModule.defineRuntime;
+export const defineRuntimeMatrix = resourcesModule.defineRuntimeMatrix;
+export { isDefinedResource, isDefinedRuntime, isDefinedRuntimeGraph, isDefinedRuntimeMatrix, runtimeGraphLeaves } from "../../resources/resources.js";
+export { assertPerCaseResourceGraph, assertResourceDependencyScopes } from "../../resources/resource-graph.js";
+export { startResources } from "../../resources/resource-session.js";
+export { ResourceLifecycleError } from "../../resources/resource-lifecycle-error.js";
+export { startRuntime } from "../../resources/runtime-lifecycle.js";
+//# sourceMappingURL=resources.entry-point.js.map

package/packages/resources/resources.entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.entry-point.js","sourceRoot":"","sources":["../../../../../source/packages/resources/resources.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAwB,MAAM,8BAA8B,CAAC;AAE3F,MAAM,eAAe,GAAG,qBAAqB,CAAC;IAC1C,4BAA4B,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,+BAA+B,CAAC;IAC7E,KAAK,CAAC,wBAAwB,CAAC,UAAU;QACrC,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,KAAK,CAAC,eAAe,CAAC,IAAI;QACtB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAA6C,eAAe,CAAC,qBAAqB,CAAC;AACrH,MAAM,CAAC,MAAM,eAAe,GAAuC,eAAe,CAAC,eAAe,CAAC;AACnG,MAAM,CAAC,MAAM,gCAAgC,GACzC,eAAe,CAAC,gCAAgC,CAAC;AACrD,MAAM,CAAC,MAAM,cAAc,GAAsC,eAAe,CAAC,cAAc,CAAC;AAChG,MAAM,CAAC,MAAM,aAAa,GAAqC,eAAe,CAAC,aAAa,CAAC;AAC7F,MAAM,CAAC,MAAM,mBAAmB,GAA2C,eAAe,CAAC,mBAAmB,CAAC;AAE/G,OAAO,EACH,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACH,0BAA0B,EAC1B,8BAA8B,EACjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACH,cAAc,EACjB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACH,sBAAsB,EACzB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACH,YAAY,EACf,MAAM,sCAAsC,CAAC"}

package/readme.md

@@ -1,7 +1,129 @@
-# @overkill-dev/resources
+# `@overkill-dev/resources`
 
-This version is a placeholder published only to claim the npm name `@overkill-dev/resources` so a Trusted Publisher
-can subsequently be configured for it. It contains no real package content and is published already
-deprecated.
+Typed resource and runtime lifecycle composition for Overkill.
 
-Workaround context: https://github.com/npm/cli/issues/8544
+This package defines resources as values and can start an explicit runtime
+session from them. A resource declares its stable name, lifecycle scope,
+execution requirements, dependencies, acquisition callback, and disposal
+callback.
+
+```ts
+import {
+    composeRuntimeContext,
+    composeRuntimes,
+    createTemporaryDirectoryResource,
+    defineResource,
+    defineRuntime,
+    startResources,
+    startRuntime,
+    type ResourceContext,
+    type RuntimeContext
+} from '@overkill-dev/resources';
+
+const database = defineResource({
+    name: 'database',
+    scope: 'per-case',
+    requirements: [ { kind: 'exclusive-resource', name: 'database' } ],
+    dependencies: {},
+    async acquire(context) {
+        context.signal.throwIfAborted();
+
+        return await openDatabase();
+    },
+    async dispose(database, _context) {
+        await database.close();
+    }
+});
+
+const server = defineResource({
+    name: 'server',
+    scope: 'per-case',
+    requirements: [],
+    dependencies: { database },
+    async acquire(context) {
+        return await startServer(context.dependencies.database);
+    },
+    async dispose(server, context) {
+        await server.stop(context.dependencies.database);
+    }
+});
+
+const scratch = createTemporaryDirectoryResource('scratch');
+const sharedDatabase = defineResource({
+    name: 'shared-database',
+    scope: 'per-run',
+    requirements: [ { kind: 'single-worker' } ],
+    async acquire(context) {
+        context.signal.throwIfAborted();
+
+        return await openDatabase();
+    },
+    deserializeHandle(payload) {
+        return { url: payload.url };
+    },
+    async dispose(database) {
+        await database.close();
+    },
+    serializeHandle(database) {
+        return { url: database.url };
+    }
+});
+const runtime = defineRuntime({
+    name: 'api',
+    dimensions: {},
+    resources: { database, server, scratch },
+    requirements: [ { kind: 'startup-budget-milliseconds', minimumMilliseconds: 1000 } ]
+});
+
+type ApiContext = RuntimeContext<typeof runtime>;
+type ScratchContext = ResourceContext<{ readonly scratch: typeof scratch; }>;
+
+await using session = await startRuntime({ runtime, signal });
+
+const scopeWithRuntime = composeRuntimeContext(testScope, runtime, session.context);
+scopeWithRuntime.runtimes.api.database;
+
+await using resources = await startResources({ resources: { scratch }, signal });
+resources.context.scratch.path;
+```
+
+`RuntimeContext` uses the keys from the runtime's `resources` object. Resource
+`name` remains the stable identity used by reporters, artifacts, and future
+scheduling work.
+
+`composeRuntimeContext(...)` exposes acquired handles under
+`scope.runtimes.<runtimeName>`, such as `scope.runtimes.api`.
+`composeRuntimes(...)` combines leaf runtimes and runtime matrices into one
+graph while exposing each child under its own public runtime name.
+
+Dependency context uses the keys from the resource's `dependencies` object.
+Omitting `dependencies` is accepted for compatibility and produces
+`dependencies: {}` on the returned descriptor.
+
+`createTemporaryDirectoryResource(name)` returns a per-case resource descriptor
+whose handle is `{ readonly path: string }`. Each acquisition creates a unique
+directory with an Overkill prefix. Disposal removes that directory recursively.
+
+`startRuntime(...)` acquires dependencies before dependents, shares one handle
+per descriptor inside the session, and disposes acquired resources once in
+reverse dependency order. Independent ready resources may acquire concurrently.
+
+`startResources(...)` starts a direct resource session without wrapping the
+handles in a runtime name. It uses the keys from the provided resource map and
+the same acquisition, sharing, and disposal behavior as `startRuntime(...)`.
+
+The package-level session API starts one explicit session and therefore shares
+one handle per descriptor inside that session. Runner-managed wrappers in
+`@overkill-dev/test/resources` interpret `scope` as `per-run`, `per-file`,
+`per-suite`, `per-case`, or `shared-per-worker` lifetime boundaries.
+
+`per-run` resources must define `serializeHandle(...)` and
+`deserializeHandle(...)` so runner-owned resources can be projected into
+consumer execution contexts. `per-file` and `per-suite` resources may also
+define projection hooks when their owner handle is not the same value that
+test code should consume. `per-case` and `shared-per-worker` resources are
+local to their execution owner and do not use projection hooks.
+
+Execution requirements describe placement pressure for the runner:
+`serial`, `single-worker`, `exclusive-resource`, `capacity-weight`,
+`affinity-key`, `fault-domain`, and `startup-budget-milliseconds`.

package/resources/resource-definition-shape.d.ts

@@ -0,0 +1,53 @@
+export type Awaitable<Value> = Promise<Value> | Value;
+export type ValueOf<Values> = Values[keyof Values];
+type ExclusiveResource = {
+    readonly kind: 'exclusive-resource';
+    readonly name: string;
+};
+type SerialExecution = {
+    readonly kind: 'serial';
+};
+type SingleWorkerExecution = {
+    readonly kind: 'single-worker';
+};
+type StartupBudget = {
+    readonly kind: 'startup-budget-milliseconds';
+    readonly minimumMilliseconds: number;
+};
+type CapacityWeight = {
+    readonly kind: 'capacity-weight';
+    readonly weight: number;
+};
+type AffinityKey = {
+    readonly key: string;
+    readonly kind: 'affinity-key';
+};
+type FaultDomain = {
+    readonly key: string;
+    readonly kind: 'fault-domain';
+};
+type PlacementRequirement = AffinityKey | CapacityWeight | ExclusiveResource | FaultDomain;
+type SchedulingRequirement = SerialExecution | SingleWorkerExecution | StartupBudget;
+export type ExecutionRequirement = PlacementRequirement | SchedulingRequirement;
+export type ResourceScope = 'per-case' | 'per-file' | 'per-run' | 'per-suite' | 'shared-per-worker';
+export type AnyResourceDefinition = {
+    readonly acquire: (context: never) => Awaitable<unknown>;
+    readonly dependencies: ResourceDependencies;
+    readonly deserializeHandle?: (payload: never, context: never) => unknown;
+    readonly dispose: ((handle: never, context: never) => Awaitable<void>) | null;
+    readonly name: string;
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly scope: ResourceScope;
+    readonly serializeHandle?: (handle: never, context: never) => ResourceProjectionPayload;
+};
+export type RuntimeResourceMap = Readonly<Record<string, AnyResourceDefinition>>;
+export type EmptyResourceDependencies = Readonly<Record<PropertyKey, never>>;
+export type ResourceDependencies = Readonly<Record<string, AnyResourceDefinition>>;
+type ResourceProjectionObject = {
+    readonly [key: string]: ResourceProjectionPayload;
+};
+type ResourceProjectionScalar = boolean | number | string | null;
+type ResourceProjectionCollection = ResourceProjectionObject | readonly ResourceProjectionPayload[];
+export type ResourceProjectionPayload = ResourceProjectionCollection | ResourceProjectionScalar;
+export {};
+//# sourceMappingURL=resource-definition-shape.d.ts.map

package/resources/resource-definition-shape.d.ts.map

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

package/resources/resource-graph.d.ts

@@ -0,0 +1,23 @@
+import { type AnyResourceDefinition, type Awaitable, type ResourceCreationContext, type ResourceDependencies, type ResourceDisposalContext } from './resources.ts';
+export type ResourceEntry = readonly [string, AnyResourceDefinition];
+export type ResourceNode = {
+    readonly dependencies: readonly ResourceNode[];
+    readonly descriptor: AnyResourceDefinition;
+};
+export type ResourceGraph = {
+    readonly order: readonly ResourceNode[];
+    readonly topLevelEntries: readonly ResourceEntry[];
+};
+type DependencyDisposalContext = ResourceDisposalContext<ResourceDependencies>;
+export type ResourceDisposeCallback = (handle: unknown, context: DependencyDisposalContext) => Awaitable<void>;
+export type CallableResourceDefinition = AnyResourceDefinition & {
+    readonly acquire: (context: ResourceCreationContext<ResourceDependencies>) => Awaitable<unknown>;
+    readonly dispose: ResourceDisposeCallback | null;
+};
+export declare function resourceEntries(resources: ResourceDependencies): readonly ResourceEntry[];
+export declare function callableResourceDefinition(resource: AnyResourceDefinition): CallableResourceDefinition;
+export declare function createResourceGraph(resources: ResourceDependencies): ResourceGraph;
+export declare function assertPerCaseResourceGraph(resources: ResourceDependencies): void;
+export declare function assertResourceDependencyScopes(resources: ResourceDependencies): void;
+export {};
+//# sourceMappingURL=resource-graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource-graph.d.ts","sourceRoot":"","sources":["../../../../source/resources/resource-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EAEd,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAE/B,MAAM,gBAAgB,CAAC;AAaxB,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AACrE,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,CAAC,YAAY,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;CAC9C,CAAC;AACF,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;CACtD,CAAC;AACF,KAAK,yBAAyB,GAAG,uBAAuB,CAAC,oBAAoB,CAAC,CAAC;AAC/E,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,yBAAyB,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC;AAC/G,MAAM,MAAM,0BAA0B,GAAG,qBAAqB,GAAG;IAC7D,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,CAAC,oBAAoB,CAAC,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC;IACjG,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACpD,CAAC;AAQF,wBAAgB,eAAe,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,aAAa,EAAE,CAEzF;AA+CD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,0BAA0B,CAQtG;AAiFD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,oBAAoB,GAAG,aAAa,CAElF;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAuBhF;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAwBpF"}

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":"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"}

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"}