@overkill-dev/resources 0.0.1 → 0.0.3

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,36 @@
 {
-  "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",
+    "peerDependencies": {
+        "@overkill-dev/simulation": "0.0.2"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/enormora/overkill.git"
+    },
+    "sideEffects": [
+        "./packages/resources/resources.entry-point.js"
+    ],
+    "type": "module",
+    "version": "0.0.3"
+}

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

@@ -0,0 +1,22 @@
+import { type ResourcesModule } from '../../resources/resources.ts';
+export { defineLocalServiceResource } from '../../resources/local-service-resource.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 { createSimulatedHttpServerResource } from '../../resources/simulated-http-server-resource.ts';
+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 { LocalServiceAddress, LocalServiceCreationContext, LocalServiceResourceDefinitionInput } from '../../resources/local-service-resource.ts';
+export type { SimulatedHttpServerResource, SimulatedHttpServerResourceOptions } from '../../resources/simulated-http-server-resource.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;AAE3F,OAAO,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAYvF,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,iCAAiC,EACpC,MAAM,mDAAmD,CAAC;AAC3D,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,mBAAmB,EACnB,2BAA2B,EAC3B,mCAAmC,EACtC,MAAM,2CAA2C,CAAC;AACnD,YAAY,EACR,2BAA2B,EAC3B,kCAAkC,EACrC,MAAM,mDAAmD,CAAC;AAC3D,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,27 @@
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createResourcesModule } from "../../resources/resources.js";
+export { defineLocalServiceResource } from "../../resources/local-service-resource.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 { createSimulatedHttpServerResource } from "../../resources/simulated-http-server-resource.js";
+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,OAAO,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAEvF,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,iCAAiC,EACpC,MAAM,mDAAmD,CAAC;AAC3D,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,141 @@
-# @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.
+
+`defineLocalServiceResource(...)` wraps `defineResource(...)` for owned local
+services. Callers declare scope, requirements, startup, and disposal. Startup
+receives an address request with default `host: '127.0.0.1'` and `port: 0`.
+Credentials, connection strings, and protocol-specific data stay in the typed
+service handle. Projected scopes use the same serialize and deserialize rules
+as ordinary resources.
+
+`createSimulatedHttpServerResource({ simulation })` starts a simulated HTTP
+server from `@overkill-dev/simulation` as a per-case resource. The acquired
+handle exposes `baseUrl` for the `default` scenario and `scenarioUrl(...)` for
+URL-selected scenarios.
+
+`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/local-service-resource.d.ts

@@ -0,0 +1,55 @@
+import { type Awaitable, type EmptyResourceDependencies, type ExecutionRequirement, type ResourceContext, type ResourceDefinition, type ResourceDependencies, type ResourceDisposalContext, type ResourceProjectionContext, type ResourceProjectionPayload, type ResourceScope } from './resources.ts';
+import type { ValueOf } from './resource-definition-shape.ts';
+export type LocalServiceAddress = {
+    readonly host: string;
+    readonly port: number;
+};
+export type LocalServiceCreationContext<Dependencies extends ResourceDependencies = EmptyResourceDependencies> = {
+    readonly address: LocalServiceAddress;
+    readonly dependencies: ResourceContext<Dependencies>;
+    readonly signal: AbortSignal;
+};
+type ProjectedLocalServiceScope = 'per-file' | 'per-run' | 'per-suite';
+type ProjectedBase<Name extends string, OwnerHandle, Projection extends ResourceProjectionPayload, ConsumerHandle, Scope extends ProjectedLocalServiceScope, Dependencies extends ResourceDependencies> = ProjectedLocalServiceResourceDefinitionInput<Name, OwnerHandle, Projection, ConsumerHandle, Scope, Dependencies>;
+type ProjectedServiceWithDependencies<Name extends string, OwnerHandle, Projection extends ResourceProjectionPayload, ConsumerHandle, Scope extends ProjectedLocalServiceScope, Dependencies extends ResourceDependencies> = {
+    readonly dependencies: Dependencies;
+    readonly deserializeHandle: ProjectedBase<Name, OwnerHandle, Projection, ConsumerHandle, Scope, Dependencies>['deserializeHandle'];
+    readonly dispose: ProjectedBase<Name, OwnerHandle, Projection, ConsumerHandle, Scope, Dependencies>['dispose'];
+    readonly host?: string;
+    readonly name: Name;
+    readonly port?: number;
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly scope: Scope;
+    readonly serializeHandle: ProjectedBase<Name, OwnerHandle, Projection, ConsumerHandle, Scope, Dependencies>['serializeHandle'];
+    readonly start: ProjectedBase<Name, OwnerHandle, Projection, ConsumerHandle, Scope, Dependencies>['start'];
+};
+type LocalServiceResourceDefinitionBaseInput<Name extends string, Handle, Scope extends ResourceScope, Dependencies extends ResourceDependencies = EmptyResourceDependencies> = {
+    readonly dependencies?: Dependencies;
+    readonly dispose: (handle: Handle, context: ResourceDisposalContext<Dependencies>) => Awaitable<void>;
+    readonly host?: string;
+    readonly name: Name;
+    readonly port?: number;
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly scope: Scope;
+    readonly start: (context: LocalServiceCreationContext<Dependencies>) => Awaitable<Handle>;
+};
+type LocalOnlyLocalServiceResourceDefinitionInput<Name extends string, Handle, Scope extends ResourceScope, Dependencies extends ResourceDependencies = EmptyResourceDependencies> = LocalServiceResourceDefinitionBaseInput<Name, Handle, Scope, Dependencies> & {
+    readonly deserializeHandle?: never;
+    readonly serializeHandle?: never;
+};
+type ProjectedLocalServiceResourceDefinitionInput<Name extends string, OwnerHandle, Projection extends ResourceProjectionPayload, ConsumerHandle, Scope extends ProjectedLocalServiceScope, Dependencies extends ResourceDependencies = EmptyResourceDependencies> = LocalServiceResourceDefinitionBaseInput<Name, OwnerHandle, Scope, Dependencies> & {
+    readonly deserializeHandle: (payload: Projection, context: ResourceProjectionContext<Dependencies>) => ConsumerHandle;
+    readonly serializeHandle: (handle: OwnerHandle, context: ResourceProjectionContext<Dependencies>) => Projection;
+};
+export type LocalServiceResourceDefinitionInput<Name extends string, Handle, Dependencies extends ResourceDependencies = EmptyResourceDependencies, Projection extends ResourceProjectionPayload = ResourceProjectionPayload, ConsumerHandle = Handle> = ValueOf<{
+    readonly local: LocalOnlyLocalServiceResourceDefinitionInput<Name, Handle, Exclude<ResourceScope, 'per-run'>, Dependencies>;
+    readonly projected: ProjectedLocalServiceResourceDefinitionInput<Name, Handle, Projection, ConsumerHandle, ProjectedLocalServiceScope, Dependencies>;
+}>;
+export declare function defineLocalServiceResource<const Name extends string, Handle, Scope extends Exclude<ResourceScope, 'per-run'>>(definition: LocalOnlyLocalServiceResourceDefinitionInput<Name, Handle, Scope>): ResourceDefinition<Name, Handle, EmptyResourceDependencies>;
+export declare function defineLocalServiceResource<const Name extends string, OwnerHandle, Projection extends ResourceProjectionPayload, ConsumerHandle, Scope extends ProjectedLocalServiceScope>(definition: ProjectedLocalServiceResourceDefinitionInput<Name, OwnerHandle, Projection, ConsumerHandle, Scope>): ResourceDefinition<Name, OwnerHandle, EmptyResourceDependencies, ConsumerHandle>;
+export declare function defineLocalServiceResource<const Name extends string, Handle, Scope extends Exclude<ResourceScope, 'per-run'>, const Dependencies extends ResourceDependencies>(definition: LocalOnlyLocalServiceResourceDefinitionInput<Name, Handle, Scope, Dependencies> & {
+    readonly dependencies: Dependencies;
+}): ResourceDefinition<Name, Handle, Dependencies>;
+export declare function defineLocalServiceResource<const Name extends string, OwnerHandle, Projection extends ResourceProjectionPayload, ConsumerHandle, Scope extends ProjectedLocalServiceScope, const Dependencies extends ResourceDependencies>(definition: ProjectedServiceWithDependencies<Name, OwnerHandle, Projection, ConsumerHandle, Scope, Dependencies>): ResourceDefinition<Name, OwnerHandle, Dependencies, ConsumerHandle>;
+export {};
+//# sourceMappingURL=local-service-resource.d.ts.map

package/resources/local-service-resource.d.ts.map

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

package/resources/local-service-resource.js

@@ -0,0 +1,66 @@
+import { defineResource } from "./resources.js";
+function localServiceAddress(host, port) {
+    return Object.freeze({
+        host: host ?? '127.0.0.1',
+        port: port ?? 0
+    });
+}
+function localServiceAcquire(definition, address) {
+    return async function startLocalService(context) {
+        return definition.start(Object.freeze({
+            ...context,
+            address
+        }));
+    };
+}
+function hasDependencies(definition) {
+    return definition.dependencies !== undefined;
+}
+function isProjectedLocalService(definition) {
+    return Object.hasOwn(definition, 'serializeHandle') && Object.hasOwn(definition, 'deserializeHandle');
+}
+export function defineLocalServiceResource(definition) {
+    const address = localServiceAddress(definition.host, definition.port);
+    const acquire = localServiceAcquire(definition, address);
+    if (isProjectedLocalService(definition)) {
+        if (hasDependencies(definition)) {
+            return defineResource({
+                name: definition.name,
+                scope: definition.scope,
+                requirements: definition.requirements,
+                acquire,
+                dispose: definition.dispose,
+                dependencies: definition.dependencies,
+                serializeHandle: definition.serializeHandle,
+                deserializeHandle: definition.deserializeHandle
+            });
+        }
+        return defineResource({
+            name: definition.name,
+            scope: definition.scope,
+            requirements: definition.requirements,
+            acquire,
+            dispose: definition.dispose,
+            serializeHandle: definition.serializeHandle,
+            deserializeHandle: definition.deserializeHandle
+        });
+    }
+    if (hasDependencies(definition)) {
+        return defineResource({
+            name: definition.name,
+            scope: definition.scope,
+            requirements: definition.requirements,
+            acquire,
+            dispose: definition.dispose,
+            dependencies: definition.dependencies
+        });
+    }
+    return defineResource({
+        name: definition.name,
+        scope: definition.scope,
+        requirements: definition.requirements,
+        acquire,
+        dispose: definition.dispose
+    });
+}
+//# sourceMappingURL=local-service-resource.js.map

package/resources/local-service-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-service-resource.js","sourceRoot":"","sources":["../../../../source/resources/local-service-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EAYjB,MAAM,gBAAgB,CAAC;AAyIxB,SAAS,mBAAmB,CAAC,IAAwB,EAAE,IAAwB;IAC3E,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,IAAI,IAAI,WAAW;QACzB,IAAI,EAAE,IAAI,IAAI,CAAC;KAClB,CAAC,CAAC;AACP,CAAC;AAED,SAAS,mBAAmB,CAOxB,UAA4G,EAC5G,OAA4B;IAE5B,OAAO,KAAK,UAAU,iBAAiB,CAAC,OAAO;QAC3C,OAAO,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YAClC,GAAG,OAAO;YACV,OAAO;SACV,CAAC,CAAC,CAAC;IACR,CAAC,CAAC;AACN,CAAC;AAED,SAAS,eAAe,CACpB,UAA0D;IAE1D,OAAO,UAAU,CAAC,YAAY,KAAK,SAAS,CAAC;AACjD,CAAC;AAED,SAAS,uBAAuB,CAO5B,UAA4G;IAS5G,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;AAC1G,CAAC;AA6CD,MAAM,UAAU,0BAA0B,CAOtC,UAA4G;IAE5G,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEzD,IAAI,uBAAuB,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,cAAc,CAAC;gBAClB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,YAAY,EAAE,UAAU,CAAC,YAAY;gBACrC,OAAO;gBACP,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,YAAY,EAAE,UAAU,CAAC,YAAY;gBACrC,eAAe,EAAE,UAAU,CAAC,eAAe;gBAC3C,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;aAClD,CAAC,CAAC;QACP,CAAC;QAED,OAAO,cAAc,CAAC;YAClB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,OAAO;YACP,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,eAAe,EAAE,UAAU,CAAC,eAAe;YAC3C,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;SAClD,CAAC,CAAC;IACP,CAAC;IAED,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,cAAc,CAAC;YAClB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,OAAO;YACP,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,YAAY,EAAE,UAAU,CAAC,YAAY;SACxC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,cAAc,CAAC;QAClB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,OAAO;QACP,OAAO,EAAE,UAAU,CAAC,OAAO;KAC9B,CAAC,CAAC;AACP,CAAC"}

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